Check if the file BDsensor.py
is in the ~/klipper/klippy/extras/
and BD_sensor.c
in the ~/klipper/klippy/src/
, if not please install again by running
~/Bed_Distance_sensor/klipper/install_BDsensor.sh
Increase the sample_retract_dist to 5mm
homing_retract_dist:5 in section[stepper_z]
That means the code of BD_sensor.c does not build into the firmware,or does not flash succees.
~/Bed_Distance_sensor/klipper/install_BDsensor.sh
cd ~/klipper/
make menuconfig
./make_with_bdsensor.sh
make flash
Make sure there is Compiling out/src/BD_sensor.o on the SSH while run make_with_bdsensor.sh
and note make flash
is the command to flash the firmware into the mcu, this command is different for different board.
Unknown value 'probe' in enumeration 'pin'
Don’t use aliases for the board pins #57
Probe triggered prior to movement
while doing Z_tilt
,No trigger on z after full movement
In most of time I met this problem is not the probe triggered even with switch probe,
The actual reason is that Linux is not real-time, and random CPU consumption in Linux causes klipper’s internal threads to be out of sync.
the solution is to increase the relative z hop distance, like z_hop
or horizontal_move_z
or homing_retract_dist
can delay the klipper to check if the probe triggered.
position_endstop
in section BDsensor, E.g. 0.6z_hop
or horizontal_move_z
or homing_retract_dist
can delay the klipper to check if the probe triggered.one possible reason is the cable that we can’t measure the cable by the normal multimeter, but it can work well with the GPIO on the RaspberryPi.
#111
There is a new update(2025.2) of the BDsensor.py that can detect the z_offset changed(temperature changed or others) >=0.05mm, then it will auto calibrate the sensor again after each G28, else it will not recalibrate.
See this blog
Need to add homing_cmd:G990028
into the section [BDsensor] , #211
It’s not an error and will not affect your printing, this happens on the second time z homing, you can try to the increase second_homing_speed a little in the section [stepper_z], for example from 3 to 4
you can find/search more troubleshooting from other users here https://github.com/markniu/Bed_Distance_sensor/issues
The issues opened or closed there are not mean the real issues, instead I think it’s a very helpful place for other users to find and fix their problems.