Skip to main content

安装 BDsensor

将传感器电缆连接到主板或CAN总线工具头板。​

  • 请注意SB2040无法使用BDsensor
  • 请注意SHT36需要将BDsensor的CLK/SCL (Input)接到高压输入口，并且将跳线接上
  • BDsensor的CKL和SDA线可以连接到电路板的任何GPIO引脚。您也可以将BD传感器电缆直接连接到Bltouch端口，例如：
BLtouch    |    BDsensor
5V       -->     5V
GND      -->     GND
S        -->     CLK/SCL    (Input)
GND      -->     GND
Zmin     -->     SDA    (Input/Output)

  • 由于主板连接器中的某些引脚可能没有直接连接到MCU的gpios（例如，它们上可能有滤波电容器或通过MOSFET，二极管或光耦合器隔离，但如果它们通过电阻或电阻上拉/下拉隔离也可以），因此它们不能与BDsensor一起使用。并且固件将报告连接错误。例如

  • 风扇和加热器的连接器通过 MOSFET 隔离，

  • 某些电路板中用于温度热敏电阻和端挡/探头的连接器通常通过滤波电容器连接到 GND，

  1. 如下图所示，将BD传感器安装在靠近热端的位置。 STL of mount, STL_mount_VzBot_Goliath short

将补丁安装到 klipper 固件中​

  • 放弃之前修改的klipper文件并且更新klipper

    cd
    cd ~/klipper
    git checkout .
    git pull

  • 克隆BD传感器的最新代码

    cd && git clone https://github.com/markniu/Bed_Distance_sensor.git

  • 安装

    cd  ~/Bed_Distance_sensor/klipper/
    ./install_BDsensor.sh

  • 编译固件

    cd ~/klipper/
    make menuconfig
    make clean
    make

  • 将固件烧录到BD传感器连接的MCU或CANbus工具头板上

如果您的打印机运行的是Moonraker，请将以下部分添加到moonraker.conf，然后您可以通过网页或klipperscreen单击一下即可更新BDsensor。​

[update_manager BDsensor]
type: git_repo
primary_branch: new
channel: dev
path: ~/Bed_Distance_sensor
origin: https://github.com/markniu/Bed_Distance_sensor.git
install_script: ./klipper/install_BDsensor.sh
is_system_service: False
managed_services: klipper
info_tags:
desc=Bed Distance Sensor

编辑 printer.cfg​

  • 将该部分复制到到您的printer.cfg并编辑[BDsensor] sda_pin scl_pin，也不要忘记禁用其他探针部分，如 BLtouch。您可以连接主板或工具头CAN模块上的BD传感器，

  • 在[BDsensor]中将speed修改为 0.8。这仅适用于 z 倾斜和PROBE_ACCURACY命令.值越小，探测时的精度越高，因为 MCU 在归位时读取主回路中的 BD传感器不像正常的止动器那样实时。 [BDsensor]

  • 将BD传感器在Z轴回原点时作为限位开关需要将[stepper_z] 中的endstop_pin改为endstop_pin: probe:z_virtual_endstop

  • 请确保printer.cfg中有[safe_z_home]

  • 将[bed_mesh]和[z_tilt]或者[quad_gantry_level]中的[quad_gantry_level]值改为1（建议0.7-1.0mm）在klipper的默认值为5mm，否则容易超出传感器范围

  • 喷嘴高度只适合在z_adjust:设置，正数是贴近热床，负数是远离热床，其它调喷嘴高度的设置都会有bug

  • 打开快速扫床需要将no_stop_probe:true前面的#删除

  • 下面是一个配置示例。

    [BDsensor] 
    scl_pin:PC6  # 舵机信号口
    sda_pin:PC3  # 限位信号口
    delay: 20 # 20us per pulse, this value should be >=20 but must be below 50
    z_offset:0 # this `z_offset` must be set to 0. 
    z_adjust:0.0 # z axis adjustment, replace the z_offset function. within -0.3 to 0.3mm
    x_offset: -34
    y_offset: 0
    #no_stop_probe:true # enable this for fast probe, the toolhead will not stop at the probe point.
    position_endstop: 0.8 # the Z axis will stop at this position (mm) while homing z, recommend value is 0.4~1.0
    #speed:0.8 # this speed only works for the z tilt and PROBE_ACCURACY command.

    [stepper_z]
    endstop_pin: probe:z_virtual_endstop 
    #position_endstop: 0.5
    homing_speed: 5
    second_homing_speed: 0.8

    [bed_mesh]
    speed: 200
    horizontal_move_z:1
    algorithm: bicubic

    [quad_gantry_level]
    horizontal_move_z:1

安装后，请通过发送以下gcode命令进行检查​

M102   S-1     # 读取传感器信息
M102   S-2     # 读取一个距离值

检查连接​

  • 通过控制台发送M102 S-1这是返回消息的示例，如果返回返回空白或其他字符串请检查连接和电线顺序

    Send: M102 S-1
    Recv: V1.0 pandapi3d.com

校准​

  • 清洁喷嘴，然后控通过控制台移动Z轴，直到喷嘴刚好接触床板（BDsensor将使用此位置作为零位置，因此不需要z_offset，这就是[BDsensor]部分中值为0的原因）
  • 控制台发送gcode命令M102 S-6，打印机每次将Z轴缓慢向上移动0.1mm，直到达到4mm。请勿在安装传感器之前运行M102 S-6，也不要在校准时关闭打印机电源，否则旧的校准数据将被删除。如果在这种情况下，只需再次校准
  • 之后，您可以检查BD传感器是否已通过M102 S-5成功校准，这将返回存储在BD传感器中的原始校准数据。

注意事项:

  • 归位Z轴速度最好是5

  • 如果M102 S-5返回的第一个原始校准数据大于400，则意味着传感器安装得太高，需要重新安装到更靠近床的位置，则第一个数据的推荐值为100。还要确保第二个数据的值比第一个数据大 10 个以上

    • FAQ: 如果校准数据以1开始，第二个值为9，第三个值为24，这意味着什么？

    • 这意味着在0-0.1毫米之间的分辨率只有9，而0.1-0.2毫米的分辨率是15。因此建议再次校准，让第一个分辨率0-0.1毫米大于10。

  • 请不要忘记在运行G28之后或为这些命令 Z_tilt与 quad_gantry_level调整Z轴高度

  • 必须正确大写和小写部分名称，否则 klipper 将报告Unknown pin chip name 'probe'