OrangePi Zero 3安装Klipper

本文最后更新于：2025年8月23日 下午

刷入官方Debian系统

优选Linux6.1内核版本的镜像，支持CAN网络，Linux5.4内核版本不支持CAN网络！

可以使用以下命令检查系统内核是否支持CAN网络：[1]

1
sudo modprobe can && echo "您的内核支持CAN" || echo "您的内核不支持CAN"

使用balenaEtcher软件将Debian官方镜像刷入TF卡。

连接WIFI

  1. 图形模式

    打开nmtui界面：

    1
    sudo nmtui

    使用键盘⌨方向键选择Activate a connection，然后选择需要连接的WIFI名，输入WIFI密码后等待连接成功即可。

  2. 命令行模式

    扫描WIFI：

    1
    nmcli dev wifi

    连接WIFI：

    1
    sudo nmcli dev wifi connect wifi_name password wifi_passwd

    wifi_name: WIFI名称
    wifi_passwd: WIFI密码

连接成功后，查看WIFI的IP地址：

1
ip addr show wlan0

安装所需软件

1
sudo apt install git python3 python3-pip -y

更换软件源

  1. apt源：
    橘子🍊官方已将apt源换成华为的镜像源，所以无需再操作。

  2. pip3源：

    本文章示例更换pip3为阿里云的源：

    1
    2
    3
    pip3 config set global.index-url https://mirrors.aliyun.com/pypi/simple

    pip3 config set install.trusted-host mirrors.aliyun.com

    查看pip源的配置信息：

    1
    pip3 config list

    以下列出国内pip3源地址，可按需替换：
    阿里云：http://mirrors.aliyun.com/pypi/simple/
    清华大学：https://pypi.tuna.tsinghua.edu.cn/simple/
    中国科技大学：https://pypi.mirrors.ustc.edu.cn/simple/

设置网络代理

由于国内网络环境复杂，为了防止后续操作出现异常情况，需要进行网络代理避免下载失败导致安装不成功或者环境配置异常。

在与OrangePi Zero 3同一局域网下，使用一台Windows电脑运行Clash Verge，并配置好代理，在设置中开启局域网连接功能，并查看当前电脑的IP和端口（需替换后续命令中的ip和port部分）。

  1. 临时网络代理

    1
    2
    3
    export http_proxy=http://ip:port

    export https_proxy=http://ip:port

    临时代理只在本次会话中有效，如果系统重启就会失效。

  2. 永久网络代理

    1
    sudo nano /etc/environment
    1
    2
    3
    export http_proxy="ip:port"
    export https_proxy="ip:port"
    export no_proxy="localhost,127.0.0.1,::1"
    1
    sudo reboot

    为所有用户启用网络代理，并且不会因系统重启而失效。

使用KIAUH脚本安装Klipper

克隆KIAUH官方仓库并运行脚本：

1
2
3
4
5
cd ~

git clone https://github.com/dw-0/kiauh.git

./kiauh/kiauh.sh

安装组件：Klipper、Moonraker、Web

运行脚本可能会出现以下界面，询问是否体验KIAUH v6测试版，测试版包含了一些新功能；我们使用稳定版操作，输入2回车。

KIAUH脚本主界面：

安装核心必备组件：Klipper、Moonraker，而网页界面：Mainsail / Fluidd 任选其一安装即可：

给OrangePi Zero 3刷入Klipper固件

  1. 启用Klipper MCU相关服务[2]

    1
    2
    3
    4
    5
    cd ~/klipper/

    sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/

    sudo systemctl enable klipper-mcu.service

  2. 配置Klipper

    1
    make menuconfig

    按照图片中进行配置

  3. 编译Klipper固件并刷入上位机

    1
    2
    3
    4
    5
    sudo service klipper stop

    make flash

    sudo service klipper start

  4. 重启上位机后查看本地串口

    1
    ls /tmp

    此时可能会没有本地串口：klipper_host_mcu，如下图：

    查看是否有本地串口

  5. 查看klipper-mcu的运行状态

    1
    systemctl status klipper-mcu.service

    查看Klipper MCU状态，显示有报错！

    我遇到的情况是使用以下命令进行修复的，仅供参考：[3] [4]

    1
    2
    sudo sysctl -w kernel.sched_rt_runtime_us=-1
    echo "kernel.sched_rt_runtime_us = -1" | sudo tee /etc/sysctl.d/10-disable-rt-group-limit.conf

    修改内核参数后执行重启

  6. 重启上位机后再次查看本地串口

    已成功启动Linux MCU本地串口，可以到网页端进行配置引脚进行使用

橘子官方提供了2个不同Linux内核（5.4 / 6.1）的系统，分配的gpio管线不一致，可以按照如下操作查看当前系统的管线配置：

先安装工具：

1
sudo apt-get install gpiod

检查当前系统GPIO管线分配情况：

1
sudo gpiodetect

以下附上5.4与6.1内核的管线分配截图，对比会发现他们的gpiochip号互为相反：

5.4内核的GPIO管线分配情况

6.1内核的GPIO管线分配情况

可以使用以下命令检查所有GPIO分配情况：

1
sudo gpioinfo

安装orangepi wiringOP工具可以查看各香橙派开发板引出GPIO分配情况：

1
2
3
4
5
6
7
git clone https://github.com/orangepi-xunlong/wiringOP.git

cd wiringOP

sudo ./build clean

sudo ./build

使用sudo gpio readall命令查看OrangePi Zero3开发板引出的GPIO信息：

OrangePi Zero3 PIN引脚功能分配图

以下分别附上香橙派Zero3的13 PIN & 26 PIN 接口的引脚功能分配图：

13 PIN引脚功能分配图

26 PIN引脚功能分配图

编写OrangePi配置文件

此配置文件可搭配我给OrangePi Zero3画的Hub板进行使用，其中pin脚的gpiochip号需要配置为上述内核中实际查询的，否则会报错：MCU 'host' error during config: Unable to open out GPIO chip line，仅供参考：

如果需要使用硬件接口：UART接口、IIC接口、SPI接口，需要在sudo orangepi-config中开启相应接口并重启系统后才可实现对应功能，点击对应接口查看官方文档操作即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
# This file contains an example configuration with RPi as secondary mcu

# See docs/Config_Reference.md for a description of parameters.

# The rpi microcontroller is used as secondary.
# Typically, both the X and Y axes
# are connected to the main micro-controller. The rpi microcontroller is used
# on non time-critical functions such as enclosure sensors, additional fan or
# light sources

# See More :
# https://www.klipper3d.org/RPi_microcontroller.html
# http://www.orangepi.cn/orangepiwiki/index.php/Orange_Pi_Zero_3

[mcu host]
serial: /tmp/klipper_host_mcu

#[temperature_sensor SOC_Temp]
#sensor_type: temperature_host
#min_temp: 0
#max_temp: 80

[virtual_sdcard]
path: /home/orangepi/printer_data/gcodes
on_error_gcode: CANCEL_PRINT

#####################################################################
#   Orange Pi Cooling Fan
#####################################################################

[temperature_fan orange_pi_soc_fan]
pin: host:gpiochip1/gpio75
#max_power:
#shutdown_speed: 1.0
#cycle_time:
#hardware_pwm:
#kick_start_time:
#off_below:
#tachometer_pin:
#tachometer_ppr:
#tachometer_poll_interval:
#enable_pin:
#   See the "fan" section for a description of the above parameters.
sensor_type: temperature_host
#sensor_pin:
control: watermark
#max_delta:
min_temp: 0
max_temp: 80
#   See the "extruder" section for a description of the above parameters.
#pid_Kp:
#pid_Ki:
#pid_Kd:
#   The proportional (pid_Kp), integral (pid_Ki), and derivative
#   (pid_Kd) settings for the PID feedback control system. Klipper
#   evaluates the PID settings with the following general formula:
#     fan_pwm = max_power - (Kp*e + Ki*integral(e) - Kd*derivative(e)) / 255
#   Where "e" is "target_temperature - measured_temperature" and
#   "fan_pwm" is the requested fan rate with 0.0 being full off and
#   1.0 being full on. The pid_Kp, pid_Ki, and pid_Kd parameters must
#   be provided when the PID control algorithm is enabled.
#pid_deriv_time: 2.0
#   A time value (in seconds) over which temperature measurements will
#   be smoothed when using the PID control algorithm. This may reduce
#   the impact of measurement noise. The default is 2 seconds.
target_temp: 40
#   A temperature (in Celsius) that will be the target temperature.
#   The default is 40 degrees.
#max_speed: 1.0
#   The fan speed (expressed as a value from 0.0 to 1.0) that the fan
#   will be set to when the sensor temperature exceeds the set value.
#   The default is 1.0.
#min_speed: 0.3
#   The minimum fan speed (expressed as a value from 0.0 to 1.0) that
#   the fan will be set to for PID temperature fans.
#   The default is 0.3.
#gcode_id:
#   If set, the temperature will be reported in M105 queries using the
#   given id. The default is to not report the temperature via M105.

#####################################################################
# Electrical Warehouse Cooling Fan
#####################################################################

[temperature_fan left_cooling_fan]
pin: host:gpiochip1/gpio70
#max_power:
#shutdown_speed:
#cycle_time:
#hardware_pwm:
#kick_start_time:
#off_below:
#tachometer_pin:
#tachometer_ppr:
#tachometer_poll_interval:
#enable_pin:
#   See the "fan" section for a description of the above parameters.
sensor_type: temperature_host
#sensor_pin:
control: watermark
#max_delta:
min_temp: 0
max_temp: 80
#   See the "extruder" section for a description of the above parameters.
#pid_Kp:
#pid_Ki:
#pid_Kd:
#   The proportional (pid_Kp), integral (pid_Ki), and derivative
#   (pid_Kd) settings for the PID feedback control system. Klipper
#   evaluates the PID settings with the following general formula:
#     fan_pwm = max_power - (Kp*e + Ki*integral(e) - Kd*derivative(e)) / 255
#   Where "e" is "target_temperature - measured_temperature" and
#   "fan_pwm" is the requested fan rate with 0.0 being full off and
#   1.0 being full on. The pid_Kp, pid_Ki, and pid_Kd parameters must
#   be provided when the PID control algorithm is enabled.
#pid_deriv_time: 2.0
#   A time value (in seconds) over which temperature measurements will
#   be smoothed when using the PID control algorithm. This may reduce
#   the impact of measurement noise. The default is 2 seconds.
target_temp: 40
#   A temperature (in Celsius) that will be the target temperature.
#   The default is 40 degrees.
#max_speed: 1.0
#   The fan speed (expressed as a value from 0.0 to 1.0) that the fan
#   will be set to when the sensor temperature exceeds the set value.
#   The default is 1.0.
#min_speed: 0.3
#   The minimum fan speed (expressed as a value from 0.0 to 1.0) that
#   the fan will be set to for PID temperature fans.
#   The default is 0.3.
#gcode_id:
#   If set, the temperature will be reported in M105 queries using the
#   given id. The default is to not report the temperature via M105.

#[controller_fan cooling_fan_left]
#pin: host:gpiochip1/gpio70
#max_power:
#shutdown_speed:
#cycle_time:
#hardware_pwm:
#kick_start_time:
#off_below:
#tachometer_pin:
#tachometer_ppr:
#tachometer_poll_interval:
#enable_pin:
#   See the "fan" section for a description of the above parameters.
#fan_speed: 1.0
#   The fan speed (expressed as a value from 0.0 to 1.0) that the fan
#   will be set to when a heater or stepper driver is active.
#   The default is 1.0
#idle_timeout:
#   The amount of time (in seconds) after a stepper driver or heater
#   was active and the fan should be kept running. The default
#   is 30 seconds.
#idle_speed:
#   The fan speed (expressed as a value from 0.0 to 1.0) that the fan
#   will be set to when a heater or stepper driver was active and
#   before the idle_timeout is reached. The default is fan_speed.
#heater: heater_bed
#stepper:
#   Name of the config section defining the heater/stepper that this fan
#   is associated with. If a comma separated list of heater/stepper names
#   is provided here, then the fan will be enabled when any of the given
#   heaters/steppers are enabled. The default heater is "extruder", the
#   default stepper is all of them.

[temperature_fan right_cooling_fan]
pin: host:gpiochip1/gpio73
#max_power:
#shutdown_speed:
#cycle_time:
#hardware_pwm:
#kick_start_time:
#off_below:
#tachometer_pin:
#tachometer_ppr:
#tachometer_poll_interval:
#enable_pin:
#   See the "fan" section for a description of the above parameters.
sensor_type: temperature_host
#sensor_pin:
control: watermark
#max_delta:
min_temp: 0
max_temp: 80
#   See the "extruder" section for a description of the above parameters.
#pid_Kp:
#pid_Ki:
#pid_Kd:
#   The proportional (pid_Kp), integral (pid_Ki), and derivative
#   (pid_Kd) settings for the PID feedback control system. Klipper
#   evaluates the PID settings with the following general formula:
#     fan_pwm = max_power - (Kp*e + Ki*integral(e) - Kd*derivative(e)) / 255
#   Where "e" is "target_temperature - measured_temperature" and
#   "fan_pwm" is the requested fan rate with 0.0 being full off and
#   1.0 being full on. The pid_Kp, pid_Ki, and pid_Kd parameters must
#   be provided when the PID control algorithm is enabled.
#pid_deriv_time: 2.0
#   A time value (in seconds) over which temperature measurements will
#   be smoothed when using the PID control algorithm. This may reduce
#   the impact of measurement noise. The default is 2 seconds.
target_temp: 40
#   A temperature (in Celsius) that will be the target temperature.
#   The default is 40 degrees.
#max_speed: 1.0
#   The fan speed (expressed as a value from 0.0 to 1.0) that the fan
#   will be set to when the sensor temperature exceeds the set value.
#   The default is 1.0.
#min_speed: 0.3
#   The minimum fan speed (expressed as a value from 0.0 to 1.0) that
#   the fan will be set to for PID temperature fans.
#   The default is 0.3.
#gcode_id:
#   If set, the temperature will be reported in M105 queries using the
#   given id. The default is to not report the temperature via M105.

#[controller_fan cooling_fan_right]
#pin: host:gpiochip1/gpio73
#max_power:
#shutdown_speed:
#cycle_time:
#hardware_pwm:
#kick_start_time:
#off_below:
#tachometer_pin:
#tachometer_ppr:
#tachometer_poll_interval:
#enable_pin:
#   See the "fan" section for a description of the above parameters.
#fan_speed: 1.0
#   The fan speed (expressed as a value from 0.0 to 1.0) that the fan
#   will be set to when a heater or stepper driver is active.
#   The default is 1.0
#idle_timeout:
#   The amount of time (in seconds) after a stepper driver or heater
#   was active and the fan should be kept running. The default
#   is 30 seconds.
#idle_speed:
#   The fan speed (expressed as a value from 0.0 to 1.0) that the fan
#   will be set to when a heater or stepper driver was active and
#   before the idle_timeout is reached. The default is fan_speed.
#heater: heater_bed
#stepper:
#   Name of the config section defining the heater/stepper that this fan
#   is associated with. If a comma separated list of heater/stepper names
#   is provided here, then the fan will be enabled when any of the given
#   heaters/steppers are enabled. The default heater is "extruder", the
#   default stepper is all of them.

#####################################################################
#   HTU21D sensor
#####################################################################

# See more :
# http://www.orangepi.cn/orangepiwiki/index.php/Orange_Pi_Zero_3#26pin_I2C.E6.B5.8B.E8.AF.95
# https://www.klipper3d.org/Config_Reference.html?h=htu#htu21d-sensor
# https://github.com/Klipper3d/klipper/blob/master/config/sample-macros.cfg
[temperature_sensor electrical_warehouse]
sensor_type: HTU21D
#   Must be "HTU21D" , "SI7013", "SI7020", "SI7021" or "SHT21"
#i2c_address:
#   Default is 64 (0x40).
i2c_mcu: host
i2c_bus: i2c.3
#i2c_software_scl_pin: host:i2c1/gpio228
#i2c_software_sda_pin: host:i2c1/gpio229
#i2c_speed:
#   See the "common I2C settings" section for a description of the
#   above parameters.
#htu21d_hold_master: True
#   If the sensor can hold the I2C buf while reading. If True no other
#   bus communication can be performed while reading is in progress.
#   Default is False.
#htu21d_resolution:
#   The resolution of temperature and humidity reading.
#   Valid values are:
#    'TEMP14_HUM12' -> 14bit for Temp and 12bit for humidity
#    'TEMP13_HUM10' -> 13bit for Temp and 10bit for humidity
#    'TEMP12_HUM08' -> 12bit for Temp and 08bit for humidity
#    'TEMP11_HUM11' -> 11bit for Temp and 11bit for humidity
#   Default is: "TEMP11_HUM11"
htu21d_report_time: 60
#   Interval in seconds between readings. Default is 30

[gcode_macro Electrical_Warehouse_State]
gcode:
    {% set sensor = printer["htu21d electrical_warehouse"] %}
    {action_respond_info(
        "Temperature: %.2f°C\n"
        "Humidity: %.2f%%" % (
            sensor.temperature,
            sensor.humidity))}

#####################################################################
#   Case Lights
#####################################################################
#[output_pin Case_Lights]
#pin: host:gpiochip1/gpio73
#value: 0
#shutdown_value: 0

#[gcode_macro lights_on]
#gcode:
#    SET_PIN PIN=Case_Lights VALUE=1.0

#[gcode_macro lights_off]
#gcode:
#    SET_PIN PIN=Case_Lights VALUE=0.0

特别鸣谢

  1. CAN问题合集 ↩
  2. RPi microcontroller ↩
  3. Can’t start a Linux host mcu on Orangepi zero 3 ↩
  4. Armbian kernel & Klipper host mcu: “Got error -1 in sched_setschedule” ↩
3D打印
#Klipper
OrangePi Zero 3安装Klipper
https://dongxunz.github.io/2024/10/24/3D打印/OrangePi Zero 3安装Klipper/
作者
dongxunz
发布于
2024年10月24日
许可协议