FAQ

Unknown pin chip name 'probe'

Check if there is a file BDsensor.py 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

Error:Probe triggered prior to movement

Increase the sample_retract_dist to 5mm

homing_retract_dist:5 in section[stepper_z]

mcu 'mcu': Unknown command: I2CBD or mcu 'mcu': Unknown command: I2CBDr

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.

Report Error while G28: Unknown value 'probe' in enumeration 'pin'

Don't use aliases for the board pins #57

Report : Probe triggered prior to movement while doing Z_tilt,No trigger on z after full movement

You can try to increase the horizontal_move_z in the section [z_tilt], that will move the z higher before probing. #213

Error:'Endstop z still triggered after retract' or the distance value always 0.

• Please calibrate BDsensor when using it for the first time
• Try to decrease the value position_endstop in section BDsensor, E.g. 0.6

The nozzle cashes to the bed while homing

• Make sure the BDsensor has been calibrated again after install.
• The BDsensor is used as the default homing sensor, do not homing with other endstop.

Error:No data or corrupt data from BDsensor

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

The sensor needs to recalibrate after each homing sequence ?

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

Error: Macro G28 called recursively

Need to add homing_cmd:G990028 into the section [BDsensor] , #211

More Troubleshooting

you can find/search more troubleshooting from other users here https://github.com/markniu/Bed_Distance_sensor/issues So 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.