你好我叫，来萌
来萌这段时间发现，用网络上查询的大部分关于“香橙派Zero”开发板的教程已经在2022年的5月份有些许过时。如果缺失了细节或者步骤，都会导致最终无法完美体验Klipper的功能，尤其是想使用mainsail界面的用户，所以需要一个新的教程以满足现今“香橙派Zero”这个设备使用Klipper固件，并且适合初入的新手朋友。
注意：本文有些许需要Github的内容，请解决一下自身的网络环境，或者你自己使用Github的镜像源也可以。
访问是否可以连通该链接，并显示图片即成功：
https://raw.githubusercontent.com/eriroh/Mainsail-x-Voron-Toolhead-Theme/master/screenshot.png更新日志：
22-05-20 发布教程
22-05-23 整体根据思兼@sjqlwy提供的意见,提升教程内容。[修改了第一阶段步骤]
22-05-24 此前放的镜像有错误，已更正。
22-06-06 同步更新了脚本的操作步骤需要准备的材料：
一根MicroUSB线，4G以上的TF卡一张，读卡器一张，网络不佳的同志请自备飞机场并爱国使用（此步骤不会在教程里出现），可以运行桌面级操作系统的计算机一台，一个可以正常使用的键盘和一个可以操控光标的设备并且连上你的计算机。
了解整体流程的步骤：
1，对“香橙派Zero”进行正确的固件刷写。
2，连接并配置你的“香橙派Zero”系统。
3，使用脚本对“香橙派Zero”安装Klipper服务和其他需要的组件。
另外相关的教程：
——如何固定香橙派的IP [点我进入]
——使用香橙派Zero对你的下位机刷写Klipper固件 [点我进入]
——让Klipper支持中文名称的Gcode文件 [点我进入]
——Klipper如何从fluidd迁移到mainsail界面 [点我进入]
需要准备的文件或软件： 香橙派Zero需要的Armbian Bullseye固件（同一文件两种不同下载源）： 注意：后续的教程全部基于该固件进行。 百度盘：https://pan.baidu.com/s/1fHkBQN-8jyrxN2mc260VWw 提取码：LEMG 镜像源：https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/orangepizero/archive/Armbian_22.02.1_Orangepizero_bullseye_current_5.15.25.img.xz 烧录固件软件balenaEtcher（同一文件两种不同下载源）： (绿色)百度盘：https://pan.baidu.com/s/1S0KnaRXs8QR1VEWJ2g4xMw 提取码：LEMG (mac/win/linux)源网站自行下载不同版本：https://www.balena.io/etcher 文章里使用的是Xshell，或者自备与“香橙派Zero”通讯的软件： 百度盘：链接：https://pan.baidu.com/s/1txf7tIag3EdQYID3hcNFUg 提取码：LEMG
准备好这些就可以开始了！
第一步：对“香橙派Zero”进行正确的固件刷写。
这里来萌用的是上面的Armbian Bullseye版本的系统，后续的教程安装都基于该系统固件，如果用的不是该固件不能保证通关。当然你也可以自身调整配置来正确地使用其他的固件。
1，将你的TF卡正确地插入你的读卡器，并且将读卡器插入你的电脑，此处不需要格式化，可以直接进行下一步。
2，打开你下载好的刻录工具“balenaEtcher”(一般来讲双击它就可以打开了，当然你也可以右键它然后左键点击“打开”)
3，点击“Flash from file (从文件刷写)”
4，点击下载好的固件，之后点击打开（这里不需要解压，刻录软件会自行使用）
5，选择正确的设备并刻录镜像到TF卡中
6，点击“Flash（刷写）”
7，确认一下固件刷写是否成功
第二步：连接上并配置你的香橙派Zero
这里教学是无网线的方案，如果你掌握其他并适合你自己的办法可以忽略。
1，将你的TF卡插入香橙派里，用MicroUSB连接香橙派并插入你的电脑。
2，香橙派启动系统之后，电脑会自动安装驱动并连接你的香橙派，提示你连接的COM端口。如果没有弹出，请右键你的计算机进入管理，找到端口，即可得知你的COM端口号。
3，如果你使用的是文章里提供的Xshell，“”绿化”后打开Xshell软件，并且新建一个会话
4，在新建会话框内，协议选中“SERIAL”。
5，点击左侧的“SERIAL”选项卡，然后选中你之前得知的连接香橙派的COM端口，点击“确定”来进行保存设置。
6，让远程软件连接你的香橙派，等待连接。
7，连接成功后，【超过半分钟没反应的话按一下回车】等待香橙派系统让你为根用户名“root”修改密码，请输入你需要的密码，并回车。期间会让你二次确认你需要的密码，再次回车即可。
8，这里选择需要使用的Shell，如果你的香橙派只是拿来跑klipper相关的服务或功能，没有其他需求，又或者你是小白，建议使用“Bash”，输入“1”。
9，之后系统会让你创建一个新用户，此处我们为了后续安装和脚本运行的兼容性，输入“pi”为新建的用户名，接着按下回车。这时会让你创建用户名为“pi”的密码，并且会需要你二次确认密码的内容。(此处可以和用户名为“root”的密码相同)后面让你写一个库的名字，同默认的“pi”即可。
10，之后，系统会询问你是否要连接无线网络，按下“回车”进行确认。
11，按键盘“方向键”，选择我们要连接的WiFi名称，然后按下“回车”，输入密码之后按下“回车”进行连接。
12，按下“方向键→”，然后按“↓”，我们选中Quit之后按下“回车”。
13，稍等片刻之后，这一步会有几率弹出你需要的本地化内容，输入“n”并回车，因为来萌并没有在此使用过中文环境且不推荐，后续内容完全跟着来萌走即可。
【如果输入n之后依然弹出选择本地化界面，之后输入[Skip generating locales]所在的编号名然后回车】
14，接着我们输入下面的命令并回车，因为后续进入配置界面会测试连通性，默认是使用Github来进行连通测试，我们需要修改成访问百度来提高进入配置界面的成功率。
[此处引用了思兼@sjqlwy教程的内容]
sudo sed -i 's/http:\/\/github.com/https:\/\/baidu.com/g' /usr/bin/armbian-config
15，输入“armbian-config”按下“回车”，稍等片刻后进入配置界面，然后记住顶部香橙派的IP。
16，记住你的IP地址后就可以断开COM连接了，后续建议用无线网络通过SSH去连接香橙派来进行运维操作。这个时候在Xshell的左上角点击“断开”的按钮【它可能不是亮的但是可以点击】，之后最好将你的香橙派供电换到你的手机充电头或者其他供电设备上，因为更大的电流可以保证后续稳定安装。接着去点击“文件夹”的按钮，我们接下来使用SSH的方法远程连接你的香橙派。
17，在弹出的窗口里，我们点击“新建”按钮。
18，我们在新打开的窗口选择“SSH”协议，在主机位置接着输入记下的香橙派IP地址，然后点击确定来进行保存。
19，在弹出的安全警告窗口里，我们点击“接受并保存”。
20，此处输入香橙派的根用户名“root”，然后点击“确定”。
21，接着再输入我们之前给root设置的密码，并且点击确定。
22，接着这一步我们先修改debian库的源地址，来方便我们后续更快速的部署。
①，输入命令“sudo nano /etc/apt/sources.list”并回车。
sudo nano /etc/apt/sources.list②，在每一行deb开头的地方加入“#”来注释掉原来的地址。
23，在最后一行我们加入新的源地址，键入或者粘贴进去即可，使用Xshell的可以直接在底部输入框内逐行粘贴并回车，或者直接在SSH区域右键粘贴。
deb https://mirrors.huaweicloud.com/debian/ bullseye main contrib non-free
deb https://mirrors.huaweicloud.com/debian/ bullseye-updates main contrib non-free
deb https://mirrors.huaweicloud.com/debian/ bullseye-backports main contrib non-free
deb https://mirrors.huaweicloud.com/debian-security/ bullseye-security main contrib non-free
这里来萌使用的是“华为云的debian源”作为系统使用的源地址，可以确定使用此源会安装成功。如果无法接受该源，可以自行换成其他的源，但不保证后续安装会成功。
24，键盘按下“Ctrl+O”之后按“回车”保存，接着按下“Ctrl+X”退出编辑。
25，接着我们需要修改Armbian库的源地址。
①我们输入命令“sudo nano /etc/apt/sources.list.d/armbian.list”并回车。
sudo nano /etc/apt/sources.list.d/armbian.list②在原本的库，deb前面输入“#”注释掉原来的Armbian源地址。
③输入我们新加的源地址。
deb http://mirrors.ustc.edu.cn/armbian/ bullseye main bullseye-utils bullseye-desktop
这里来萌使用的是“中科大的Armbian源”作为系统使用的源地址。
26，键盘按下“Ctrl+O”之后按“回车”保存，接着按下“Ctrl+X”退出编辑。
27，我们输入命令“sudo apt update”并回车来更新我们的源地址内容，这一步的速度跟你的网络有一定关系，正常情况在五分钟左右完成，切记在系统释放操作前不要中途中断更新。一定要等到“upgraded”这个单词的出现。
sudo apt update
28，连接无线网或者有线网的情况，请尽可能固定你的设备IP在局域网内，方便维护和后续长时间使用，由于篇幅过长，固定香橙派IP的教程在另一个文章内。[点我进入：香橙派如何固定IP]
如果不需要可以开始进行下一步。
到此为止，我们对香橙派系统的配置告一段落，可以进入下一阶段了。
三，获取脚本并对“香橙派Zero”安装Klipper及其的相关组件。
前情提要：这里来萌不建议使用国内的kiauh脚本源，因为发现国内gitee的脚本源已经许久没更新了，后面来的新同志或者需要重装的同志都会出现或多或少的问题。在国内源更新之前一定要使用Github的源，所以开头让同志们先测一下自身的网络。
1，输入命令“su pi”切换到pi用户，然后输入“cd ~”，接着输入命令获取脚本“git clone https://github.com/th33xitus/kiauh.git”。
su pi
cd ~
git clone https://github.com/th33xitus/kiauh.git
2，接着我们输入命令“./kiauh/kiauh.sh”，稍等一会，进入脚本功能。
（你好，不要漏掉前面的“.”）
./kiauh/kiauh.sh
3，我们输入“1”，来进入安装功能。
4，我们输入“1”先安装Klipper。
5，这里提示我们选择需要给Klipper安装的Python的版本，由于我们需要中文环境来提升后续使用体验，所以在这里我们输入“2”并回车，选择Python3。
6，这里输入你需要安装的klipper服务数量，来萌只需要一个所以在这里输入“1”并回车，之后再次输入回车来确认操作。
7，（如果你没有这一步可以忽略）这里询问你是否需要给klipper服务另取名字，我们直接回车来跳过该步骤。
8，（如果你没有这一步可以忽略）如果询问你，你的用户不在组里，这里请直接按下回车来确认。
9，我们输入“2”来安装Moonraker。
10，（如果你没有这一步可以忽略）输入你想要的Moonraker服务数量，这里来萌输入的是“1”并回车。
11，直接回车来确认安装Moonraker。
12，这里安装完moonraker我们继续输入“3”Mainsail或者“4”Fluidd来选择你想要的界面，这里来萌用的是Mainsail所以输入的是“3”并回车。
13，这里询问你是否要安装摄像头相关的组件，无摄像头的可以不安装。请注意：按下回车的话是否，按下Y并回车的话是确认安装。
14，这里询问你是否要安装基础微码，我们这里输入“Y”并回车来确认安装。
15，到此为止，Klipper及其相关的服务已经安装完成，输入香橙派的IP即可访问你想看到的服务界面了，之后你需要对Klipper进行一些配置文件的创建，对下位机刷入Klipper固件。
（下位机刷入Klipper固件教程 网页链接）
