1 Orange Pi 5 Plus的基本特性
2 开发板使用介绍
3 Ubuntu/Debian Server和Xfce桌面系统使用说明
4 Ubuntu22.04 Gnome Wayland桌面系统使用说明
5 Orange Pi OS Arch系统使用说明
6 Linux SDK——orangepi-build使用说明
7 Linux开发手册
- 7.1 在开发板的linux系统中单独编译内核源码的方法
8 OpenWRT系统使用说明
9 OpenWRT源码的编译方法
- 9.1 下载OpenWRT源码
- 9.2 编译OpenWRT源码
10 Android 12系统的使用说明
11 Android 12源码的编译方法
- 11.1 下载Android 12的源码
- 11.2 编译Android 12的源码
12 Orange Pi OS Droid 系统的使用说明
- 12.1 OPi OS Droid系统的功能适配情况
- 12.2 HDMI In的测试方法
13 附录
- 13.1 用户手册更新历史
- 13.2 镜像更新历史

Orange Pi 5 Plus的基本特性

什么是 Orange Pi 5 Plus

Orange Pi 5 Plus采用了瑞芯微RK3588新一代八核64位ARM处理器，具体为四核A76和四核A55，采用的三星8nm LP制程工艺，大核主频最高可达2.4GHz，集成ARM Mali-G610 MP4 GPU，内嵌高性能3D和2D图像加速模块，内置高达6 Tops算力的AI加速器NPU，可选4GB、8GB、16GB或者32GB内存，具有高达8K显示处理能力。

Orange Pi 5 Plus引出了相当丰富的接口，包括2个HDMI输出、1个HDMI输入、USB-C/DP接口、M.2 M-key PCIe3.0x4、M.2 E-key PCIe2.0x1、2个2.5G网口、eMMC扩展接口、USB2.0、USB3.0接口、红外、耳机、板载MIC、喇叭、RTC和40pin扩展排针等。可广泛适用于高端平板、边缘计算、人工智能、云计算、AR/VR、智能安防、智能家居等领域，覆盖 AIoT各个行业。

Orange Pi 5 Plus支持Orange Pi 官方研发的操作系统Orange Pi OS，同时，支持Android 12.1、OpenWRT、Debian11、Debian12、Ubuntu20.04和Ubuntu22.04等操作系统。

Orange Pi 5 Plus的用途

我们可以用它实现：

一台Linux桌面计算机
一台Linux网络服务器
Android平板
Android游戏机等

当然还有其他更多的功能，依托强大的生态系统以及各式各样的扩展配件，Orange Pi可以帮助用户轻松实现从创意到原型再到批量生产的交付，是创客、梦想家、业余爱好者的理想创意平台。

Orange Pi 5 Plus的硬件规格

Orange Pi 5 PLUS硬件规格
主控芯片	Rockchip RK3588(8nm LP制程）
CPU	• 8核64位处理器 • 4个Cortex-A76和4个Cortex-A55及独立的NEON协处理器 • Cortex-A76主频最高2.4GHz，Cortex-A55主频最高1.8GHz
GPU	• 集成ARM Mali-G610 • 内置 3D GPU • 兼容OpenGL ES1.1/2.0/3.2、OpenCL 2.2和Vulkan 1.2
NPU	内嵌的NPU支持INT4/INT8/INT16/FP16，算力高达6 Tops
PMU	RK806-1
RAM	4GB/8GB/16GB/32GB可选
存储	• QSPI Nor FLASH: 16MB/32MB • MicroSD卡插槽 • eMMC插座，可外接eMMC模块 • 用于NVMe SSD (PCIe 3.0 x4) 的M.2 2280插槽
USB	• 2 x USB3.0 • 2 x USB2.0 • 1 x Type-C
视频	• 2 x HDMI 2.1 输出，高达8K@60FPS • 1 x Type-C（DP 1.4A）输出，高达4K@60FPS • 1 x HDMI输入，高达4K@60FPS • 1 x MIPI DSI 4 Lane输出，高达4K@60FPS
TP接口	1 x 6Pin FPC插座
摄像头	1 x MIPI CSI 4 Lane
音频	• 1 x 3.5mm耳机孔音频输入/输出 • 1 x 板载MIC输入 • 2 x HDMI输出 • 1 x HDMI输入 • 1 x DP输出 • 1 x扬声器输出（2pin，1.25mm规格）
以太网	2 x PCIe 2.5G 以太网口（RTL8125BG )
40pin扩展口	用于扩展UART、I2C、SPI、CAN、PWM、GPIO接口
PCIe M.2 M-KEY	PCIe 3.0 x 4 lanes，用于接2280的NVMe SSD固态硬盘
PCIe M.2 E-KEY	包含PCIe 2.0 x 1/PCM/UART/USB2.0接口，支持2230的Wi-Fi6/BT模块
按键	1个MaskROM键，1个RECOVERY键，1个开关机键
供电	支持Type-C供电，5V@4A
红外接收器	1个红外接收器
LED	RGB LED三色指示灯
风扇接口	2pin，1.25mm规格，用于接5V风扇，支持PWM控制开关和转速
RTC电池接口	2pin，1.25mm规格，用于给RTC模块供电
调试	3pin调试串口（UART)
支持的操作系统	Orangepi OS(Droid)、Orangepi OS(Arch)、Orangepi OS(OH)、Ubuntu20.04、Ubuntu22.04、Debian11、Debian12、OpenWRT和Android12等
外观规格介绍
产品尺寸	100mm*75mm
重量	86.5g

Orange Pi 5 Plus的顶层视图和底层视图

（顶层视图）

（底层视图）

Orange Pi 5 Plus的接口详情图

开发板使用介绍

准备需要的配件

TF卡，最小16GB容量（推荐32GB或以上）的class10级或以上的高速闪迪卡
TF卡读卡器，用于将镜像烧录到TF卡中
HDMI接口的显示器
HDMI转HDMI连接线，用于将开发板连接到HDMI显示器或者电视进行显示

注意，如果想接4K或者8K显示器，请确保HDMI线支持4K或者8K视频显示。
Type-C转HDMI线，通过Type-C接口将开发板连接到HDMI显示器或者电视进行显示
Type-C转USB转接头，用于通过Type-C接口连接USB存储设备或者鼠标键盘等USB设备（开发板上有2个USB3.0 HOST接口和2个USB2.0 HOST接口，此配件一般用不到）
10.1寸MIPI屏幕，用于显示开发板的系统界面（此屏幕和OPi5/OPi5B通用）

电源适配器，Orange Pi 5 Plus建议使用5V/4A的Type-C电源供电

开发板上有两个长得一样的Type-C接口，其中网口旁边竖着的那个才是电源接口，另外那个Type-C接口是没有供电功能的，请别接错了。开发板的Type-C电源接口不支持PD协商功能，只支持固定的5V电压输入。

USB接口的鼠标和键盘，只要是标准USB接口的鼠标和键盘都可以，鼠标和键盘可以用来控制Orange Pi开发板
USB摄像头
5V的散热风扇。如下图所示，开发板上有用于接散热风扇的接口，接口规格为2pin 1.25mm间距

开发板上的风扇可以通过PWM来调节转速和开关。
网线，用于将开发板连接到因特网
Type-C接口的数据线，用于烧录镜像、使用ADB等功能
红外遥控器

注意，空调遥控或者电视机的遥控是无法控制Orange Pi开发板的，Orange Pi提供的操作系统默认只能保证Orange Pi提供的遥控器才可以使用。
1300万MIPI接口的OV13850摄像头（和OPi5/OPi5B通用）
1300万MIPI接口的OV13855摄像头（和OPi5/OPi5B通用）
M.2 M-KEY 2280规格的NVMe SSD固态硬盘，PCIe接口的规格为PCIe3.0x4
eMMC扩展模块（待添加实物图片）

开发板上插入eMMC模块的位置如下图所示：
RTC电池，接口为2pin，1.25mm间距

开发板上接RTC电池接口的位置如下图所示：
喇叭，接口为2pin，1.25mm间距

开发板上接喇叭的接口位置如下图所示：
配套外壳（待添加图片和组装方法）
3.3V的USB转TTL模块和杜邦线，使用串口调试功能时，需要USB转TTL模块和杜邦线来连接开发板和电脑
安装有Ubuntu和Windows操作系统的个人电脑

1 Ubuntu22.04 PC
可选，用于编译Linux源码

2 Windows PC
用于烧录Android和Linux镜像

下载开发板的镜像和相关的资料

中文版资料的下载网址为为：

http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-5-plus.html
英文版资料的下载网址为：

http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-5-plus.html
资料主要包含

a. 用户手册和原理图：保存在百度云盘和谷歌网盘上

b. 官方工具：主要包括开发板使用过程中需要用到的软件

c. Android源码：保存在百度云盘和谷歌网盘上

d. Linux源码：保存在Github上

e. OpenWRT源码：保存在Github上

f. Android镜像：保存在百度云盘和谷歌网盘上

g. Ubuntu镜像：保存在百度云盘和谷歌网盘上

h. Debian镜像：保存在百度云盘和谷歌网盘上

i. Orange Pi OS镜像：保存在百度云盘和谷歌网盘上

j. OpenWRT镜像: 保存在百度云盘和谷歌网盘上

基于Windows PC将Linux镜像烧录到TF卡的方法

注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian、Ubuntu、OpenWRT或者OPi OS Arch这样的Linux发行版镜像。

使用balenaEtcher烧录Linux镜像的方法

首先准备一张16GB或更大容量的TF卡，TF卡的传输速度必须为class10级或class10级以上，建议使用闪迪等品牌的TF卡
然后使用读卡器把TF卡插入电脑

从Orange Pi的资料下载页面下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”.img”结尾的文件就是操作系统的镜像文件，大小一般在2GB以上。

注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面两种类型的镜像，请下载”TF卡、eMMC和NVME SSD启动镜像”文件夹中的镜像文件。

然后下载Linux镜像的烧录软件——balenaEtcher，下载地址为：

 https://www.balena.io/etcher/

进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方
然后可以选择下载balenaEtcher的Portable版本的软件，Portable版本无需安装，双击打开就可以使用
如果下载的是需要安装版本的balenaEtcher，请先安装再使用。如果下载的Portable版本balenaEtcher，直接双击打开即可，打开后的balenaEtcher界面如下图所示：

打开balenaEtcher时如果提示下面的错误：

请选择balenaEtcher后点击右键，然后选择以管理员身份运行。

使用balenaEtcher烧录Linux镜像的具体步骤如下所示
1. 首先选择要烧录的Linux镜像文件的路径
2. 然后选择TF卡的盘符
3. 最后点击Flash就会开始烧录Linux镜像到TF卡中
balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中
Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验
成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了

使用RKDevTool烧录Linux镜像到TF卡中的方法

首先需要准备一根品质良好的Type-C接口的数据线
还需要准备一张16GB或更大容量的TF卡，TF卡的传输速度必须为class10级或class10级以上，建议使用闪迪等品牌的TF卡
然后将TF卡插入开发板的卡槽中
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和MiniLoader以及烧录工具RKDevTool_Release_v3.15.zip
1. 在Orange Pi的资料下载页面首先选择官方工具，然后进入下面的文件夹中
2. 然后下载下面的所有文件
  
  注意，“MiniLoader-烧录Linux镜像才需要用到的东西”文件夹下文简称为MiniLoader文件夹。

然后从Orange Pi的资料下载页面下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”.img”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上

注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面两种类型的镜像，请下载”TF卡、eMMC和NVME SSD启动镜像”文件夹中的镜像文件。

然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到RKDevTool打开即可
打开RKDevTool烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”
然后开始烧录Linux镜像到TF卡中
1. 首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
2. 确保开发板没有连接Type-C电源
3. 然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
4. 然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了。Type-C电源接口的位置如下所示：
5. 如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示“发现一个MASKROM设备”
6. 然后将鼠标光标放在下面的这片区域中
7. 然后点击鼠标右键会弹出下图所示的选择界面
8. 然后选择导入配置选项
9. 然后选择前面下载的MiniLoader文件夹中的rk3588_linux_tfcard.cfg配置文件，再点击打开
10. 然后点击确定
11. 然后点击下图所示的位置
12. 再选择前面下载的MiniLoader文件夹中MiniLoaderAll.bin，再点击打开
13. 然后点击下图所示的位置
14. 然后选择想要烧录的linux镜像的路径，再点击打开
  
  在烧录镜像前，建议将要烧录的linux镜像重命名为orangepi.img或者其它比较短的名字，这样在烧录镜像的时候就能看到烧录进度的百分比数值。
15. 然后请勾选上强制按地址写选项
16. 再点击执行按钮就会开始烧录linux镜像到开发板的tf卡中
17. linux镜像烧录完后的显示log如下图所示
18. 烧录完linux镜像到tf卡中后，linux系统会自动启动。

使用Win32Diskimager烧录Linux镜像的方法

首先准备一张16GB或更大容量的TF卡，TF卡的传输速度必须为class10级或class10级以上，建议使用闪迪等品牌的TF卡
然后使用读卡器把TF卡插入电脑
接着格式化TF卡
1. 可以使用SD Card Formatter这个软件格式化TF卡，其下载地址为
2. 下载完后直接解压安装即可，然后打开软件
3. 如果电脑只插入了TF卡，则”Select card”一栏中会显示TF卡的盘符，如果电脑插入了多个USB存储设备，可以通过下拉框选择TF卡对应的盘符
4. 然后点击”Format”，格式化前会弹出一个警告框，选择”是(Y)”后就会开始格式化
5. 格式化完TF卡后会弹出下图所示的信息，点击确定即可

从Orange Pi的资料下载页面下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”.img”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上

注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面两种类型的镜像，请下载”TF卡、eMMC和NVME SSD启动镜像”文件夹中的镜像文件。

使用Win32Diskimager烧录Linux镜像到TF卡

Win32Diskimager的下载页面为

http://sourceforge.net/projects/win32diskimager/files/Archive/

下载完后直接安装即可，Win32Diskimager界面如下所示
1. 首先选择镜像文件的路径
2. 然后确认下TF卡的盘符和”设备”一栏中显示的一致
3. 最后点击”写入”即可开始烧录
镜像写入完成后，点击”退出”按钮退出即可，然后就可以拔出TF卡插到开发板中启动

基于Ubuntu PC将Linux镜像烧录到TF卡的方法

注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian、Ubuntu、OpenWRT或者OPi OS Arch这样的Linux发行版镜像，Ubuntu PC指的是安装了Ubuntu系统的个人电脑。

首先准备一张16GB或更大容量的TF卡，TF卡的传输速度必须为class10级或class10级以上，建议使用闪迪等品牌的TF卡
然后使用读卡器把TF卡插入电脑
下载balenaEtcher软件，下载地址为

https://www.balena.io/etcher/

进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方
然后选择下载Linux版本的软件即可

从Orange Pi的资料下载页面下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”.img”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上

注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面两种类型的镜像，请下载”TF卡、eMMC和NVME SSD启动镜像”文件夹中的镜像文件。

7z结尾的压缩包的解压命令如下所示：

test@test:~$ 7z x orangepi5plus_1.0.0_debian_bullseye_desktop_xfce_linux5.10.110.7z test@test:~$ ls orangepi5plus_1.0.0_debian_bullseye_desktop_xfce_linux5.10.110.* orangepi5plus_1.0.0_debian_bullseye_desktop_xfce_linux5.10.110.7z orangepi5plus_1.0.0_debian_bullseye_desktop_xfce_linux5.10.110.sha #校验和文件 orangepi5plus_1.0.0_debian_bullseye_desktop_xfce_linux5.10.110.img #镜像文件

如果下载的是OpenWRT镜像，压缩包是以gz结尾的，解压命令如下所示：

test@test:~$ gunzip openwrt-aarch64-opi5plus-23.05-linux-5.10.110-ext4.img.gz test@test:~$ ls openwrt-aarch64-opi5plus-23.05-linux-5.10.110-ext4.img openwrt-aarch64-opi5plus-23.05-linux-5.10.110-ext4.img #镜像文件

解压镜像后可以先用sha256sum -c *.sha命令计算下校验和是否正确，如果提示成功说明下载的镜像没有错，可以放心的烧录到TF卡，如果提示校验和不匹配说明下载的镜像有问题，请尝试重新下载

test@test:~$ sha256sum -c *.sha

orangepi5plus_1.0.0_debian_bullseye_desktop_xfce_linux5.10.110.img: OK

如果下载的是OpenWRT镜像，要对压缩包进行校验，不要解压后再校验

test@test:~$ sha256sum -c openwrt-aarch64-opi5plus-23.04-linux-5.10.110-ext4.img.gz.sha

openwrt-aarch64-opi5plus-23.04-linux-5.10.110-ext4.img.gz: OK
然后在Ubuntu PC的图形界面双击balenaEtcher-1.14.3-x64.AppImage即可打开balenaEtcher（无需安装），balenaEtcher打开后的界面显示如下图所示
使用balenaEtcher烧录Linux镜像的具体步骤如下所示
1. 首先选择要烧录的Linux镜像文件的路径
2. 然后选择TF卡的盘符
3. 最后点击Flash就会开始烧录Linux镜像到TF卡中
balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中

Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验
成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了

烧录Linux镜像到eMMC中的方法

使用RKDevTool烧录Linux镜像到eMMC中的方法

注意，下面所有的操作都是在Windows电脑中进行的。

注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian、Ubuntu、OpenWRT或者OPi OS Arch这样的Linux发行版镜像。

开发板预留了eMMC模块的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC接口的位置如下所示：
还需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和MiniLoader以及烧录工具RKDevTool_Release_v3.15.zip
1. 在Orange Pi的资料下载页面首先选择官方工具，然后进入下面的文件夹中
2. 然后下载下面的所有文件
  
  注意，“MiniLoader-烧录Linux镜像才需要用到的东西”文件夹下文简称为MiniLoader文件夹。

然后从Orange Pi的资料下载页面下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”.img”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上

注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面两种类型的镜像，请下载”TF卡、eMMC和NVME SSD启动镜像”文件夹中的镜像文件。

然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到 RKDevTool打开即可
打开RKDevTool 烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”

然后开始烧录Linux镜像到eMMC中

首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
确保开发板没有插入TF卡，没有连接电源
然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了
如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
然后将鼠标光标放在下面的这片区域中
然后点击鼠标右键会弹出下图所示的选择界面
然后选择导入配置选项
然后选择前面下载的MiniLoader文件夹中的rk3588_linux_emmc.cfg配置文件，再点击打开
然后点击确定
然后点击下图所示的位置
再选择前面下载的MiniLoader文件夹中MiniLoaderAll.bin，再点击打开
然后点击下图所示的位置
然后选择想要烧录的linux镜像的路径，再点击打开

在烧录镜像前，建议将要烧录的linux镜像重命名为orangepi.img或者其它比较短的名字，这样在烧录镜像的时候就能看到烧录进度的百分比数值。
然后请勾选上强制按地址写选项
再点击执行按钮就会开始烧录linux镜像到开发板的eMMC中
linux镜像烧录完后的显示log如下图所示
烧录完linux镜像到eMMC中后，linux系统会自动启动。

注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPIFlash后再启动试下。清空SPIFlash的方法请参考使用RKDevTool清空SPIFlash的方法小节的内容。

使用dd命令烧录Linux镜像到eMMC中的方法

注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian、Ubuntu、OpenWRT或者OPi OS Arch这样的Linux发行版镜像。

开发板预留了eMMC模块的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：
使用dd命令烧录linux镜像到eMMC中需要借助TF卡来完成，所以首先需要将linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入linux系统。烧录Linux镜像到TF卡的方法请见基于Windows PC将Linux镜像烧录到TF卡的方法和基于Ubuntu PC将Linux镜像烧录到TF卡的方法两小节的说明。
使用TF卡启动linux系统后，我们首先将解压后的linux镜像文件（从官网下载的Debian、Ubuntu镜像或者OPi Arch镜像）上传到TF卡中。上传linux镜像文件到开发板中的方法请参考上传文件到开发板Linux系统中的方法小节的说明。

上传完镜像到开发板的linux系统中后，我们再在开发板linux系统的命令行中进入镜像文件的存放路径，比如，我将开发板的linux镜像存放在/home/orangepi/Desktop目录下了，然后进入/home/orangepi/Desktop目录就能看到上传的镜像文件了。

orangepi@orangepi:~$ cd /home/orangepi/Desktop orangepi@orangepi:~/Desktop$ ls Orangepi5plus_x.x.x_debian_bullseye_desktop_xfce_linux5.10.110.img

怎么进入开发板linux系统的命令行？使用串口登录终端的方法请参考调试串口的使用方法一小节的说明。使用ssh远程登录linux系统请参考SSH远程登录开发板一小节的说明。如果接了HDMI、LCD等显示屏幕，可以在桌面中打开一个命令行终端。

接下来，我们先使用下面的命令确认下eMMC的设备节点

orangepi@orangepi:~/Desktop$ ls /dev/mmcblk*boot0 | cut -c1-12

/dev/mmcblk1
然后我们可以使用dd命令清空下eMMC，注意of=参数后面请填入上面命令输出的结果

orangepi@orangepi:~/Desktop$ sudo dd bs=1M if=/dev/zero of=/dev/mmcblk1 count=1000 status=progress

orangepi@orangepi:~/Desktop$ sudo sync

然后就可以使用dd命令烧录开发板的linux镜像到eMMC中

下面的命令中 if= > 参数后面是要填写linux镜像存放的完整路径+Linux镜像的名字（比如/home/orangepi/Desktop/Linux镜像的名字）。因为上面我们已经进入linux镜像的路径下了，所以只需要填写Linux镜像的名字的即可。
下面命令中的linux镜像名请不要照抄，要替换为实际的镜像名（因为镜像的版本号可能会更新）。

sudo dd bs=1M if=Orangepi5plus_x.x.x_debian_bullseye_desktop_xfce_linux5.10.110.img of=/dev/mmcblk1 status=progress

sudo sync

注意，如果上传的是 .7z或者.xz 结尾linux镜像压缩文件，使用dd命令烧录前请记得先解压。 dd命令的所有参数的详细说明和更多用法可以在linux系统中执行man dd命令来查看。

当成功烧录开发板的linux镜像到eMMC后，此时就可以使用poweroff命令关机了。然后请拔出TF卡，再短按电源按键开机，此时就会启动eMMC中的linux系统了。

烧录Linux镜像到SPIFlash+NVMe SSD中的方法

注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian、Ubuntu、OpenWRT或者OPi OS Arch这样的Linux发行版镜像。

注意，下面所有的操作都是在Windows电脑中进行的。

使用dd命令烧录的方法

首先需要准备一个M-Key 2280规格的NVMe SSD固态硬盘，开发板M.2插槽PCIe接口的规格为PCIe3.0x4。
然后把NVMe SSD插入下图所示的开发板的M.2 PCIe接口，并固定好
SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置
烧录linux镜像到SPIFlash+NVMe SSD中需要借助TF卡来完成，所以首先需要将linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入linux系统。烧录Linux镜像到TF卡的方法请见基于Windows PC将Linux镜像烧录到TF卡的方法和基于Ubuntu PC将Linux镜像烧录到TF卡的方法两小节的说明。
使用TF卡启动linux系统后，我们首先烧录u-boot镜像到SPI Flash中
1. 先运行下nand-sata-install，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo nand-sata-install
2. 然后选择7 Install/Update ther bootloader on SPI Flash
1. 然后选择<Yes>
1. 然后请耐心等待烧录完成，烧录完成后显示如下所示（左下角会显示一个Done）：

然后将linux镜像文件（从官网下载的Debian、Ubuntu或者OpenWRT镜像）上传到TF卡中。上传linux镜像文件到开发板中的方法请参考上传文件到开发板Linux系统中的方法小节的说明。

注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面两种类型的镜像，请下载”TF卡、eMMC和NVME SSD启动镜像”文件夹中的镜像文件。

上传完镜像到开发板的linux系统中后，我们再在开发板linux系统的命令行中进入镜像文件的存放路径，比如，我将开发板的linux镜像存放在/home/orangepi/Desktop目录下了，然后进入/home/orangepi/Desktop目录就能看到上传的镜像文件了。

orangepi@orangepi:~$ cd /home/orangepi/Desktop orangepi@orangepi:~/Desktop$ ls orangepi5plus_x.x.x_debian_bullseye_desktop_xfce_linux5.10.110.img

怎么进入开发板linux系统的命令行？使用串口登录终端的方法请参考调试串口的使用方法一小节的说明。使用ssh远程登录linux系统请参考SSH远程登录开发板一小节的说明。如果接了HDMI、LCD等显示屏幕，可以在桌面中打开一个命令行终端。

接下来，我们先确认下NVMe SSD已经被开发板的linux正常识别了。如果NVMe SSD正常识别了的话，使用sudo fdisk -l命令就能看到nvme相关的信息

orangepi@orangepi:~/Desktop$ sudo fdisk -l | grep "nvme0n1"

Disk /dev/nvme0n1: 1.86 TiB, 2048408248320 bytes, 4000797360 sectors

使用lspci命令可以看到一个NVMe相关的PCI设备

orangepi@orangepi:~$ lspci

0000:00:00.0 PCI bridge: Rockchip Electronics Co., Ltd Device 3588 (rev 01)

0000:01:00.0 Non-Volatile memory controller: SK hynix BC501 NVMe Solid State Drive

.…
然后我们可以使用dd命令清空下NVMe SSD（可选）

orangepi@orangepi5plus:~/Desktop$ sudo dd bs=1M if=/dev/zero of=/dev/nvme0n1 count=2000 status=progress

orangepi@orangepi5plus:~/Desktop$ sudo sync

然后就可以使用dd命令烧录开发板的linux镜像到NVMe SSD中

下面的命令中 if= > 参数后面是要填写linux镜像存放的完整路径+Linux镜像的名字（比如/home/orangepi/Desktop/Linux镜像的名字）。因为上面我们已经进入linux镜像的路径下了，所以只需要填写Linux镜像的名字的即可。

下面命令中的linux镜像名请不要照抄，要替换为实际的镜像名（因为镜像的版本号可能会更新）。

sudo dd bs=1M if=orangepi5plus_x.x.x_debian_bullseye_desktop_xfce_linux5.10.110.img of=/dev/nvme0n1 status=progress sudo sync

注意，如果上传的是 .7z或者.xz 或者.gz结尾linux镜像压缩文件，使用dd命令烧录前请记得先解压。 dd命令的所有参数的详细说明和更多用法可以在linux系统中执行man dd命令来查看。

当成功烧录开发板的linux镜像到NVMe SSD后，此时就可以使用poweroff命令关机了。然后请拔出TF卡，再短按电源按键开机，此时就会启动SPIFlash+NVMe SSD中的linux系统了。

使用balenaEtcher软件烧录的方法

OPi OS Arch系统和OpenWRT系统请不要使用这种方法。

首先需要准备一个M-Key 2280规格的NVMe SSD固态硬盘，开发板M.2插槽PCIe接口的规格为PCIe3.0x4。
然后把NVMe SSD插入下图所示的开发板的M.2 PCIe接口，并固定好
SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置
烧录linux镜像到SPIFlash+NVMe SSD中需要借助TF卡来完成，所以首先需要将linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入linux系统。烧录Linux镜像到TF卡的方法请见基于Windows PC将Linux镜像烧录到TF卡的方法和基于Ubuntu PC将Linux镜像烧录到TF卡的方法两小节的说明。
启动进入TF卡中的linux系统后，请先确认下NVMe SSD已经被开发板的linux系统正常识别了。如果NVMe SSD正常识别了的话，使用sudo fdisk -l命令就能看到nvme相关的信息

orangepi@orangepi:~/Desktop$ sudo fdisk -l | grep "nvme0n1"

Disk /dev/nvme0n1: 1.86 TiB, 2048408248320 bytes, 4000797360 sectors

使用lspci命令可以看到一个NVMe相关的PCI设备

orangepi@orangepi:~$ lspci

0000:00:00.0 PCI bridge: Rockchip Electronics Co., Ltd Device 3588 (rev 01)

0000:01:00.0 Non-Volatile memory controller: SK hynix BC501 NVMe Solid State Drive

.…
linux镜像中已经预装了balenaEtcher，打开方法如下所示：

如果没有预装，balenaEtcher arm64版本的下载安装方法请参考下载安装arm64版本balenaEtcher的方法小节的说明。

balenaEtcher打开后的界面如下所示：

使用balenaEtcher烧录u-boot到开发板SPI Flash中的方法如下所示：
1. 首先点击Flash from file
1. 然后进入/usr/lib/linux-u-boot-legacy-orangepi5plus_1.x.x_arm64目录，再选择rkspi_loader.img，再点击Open打开
1. 打开rkspi_loader.img后的界面如下所示：
2. 然后点击Select target
1. 然后点击Show 2 hidden打开更多存储设备的选项
1. 然后选择SPI Flash的设备名/dev/mtdblock0,然后点击Select
1. 然后点击Flash
1. 然后点击Yes, I’m sure
1. 然后输入开发板linux系统的密码orangepi，就会开始烧录u-boot镜像到SPI Flash中
1. 烧录过程的显示如下所示：
1. 烧录完成后的显示如下所示：

烧录TF卡中的linux系统到NVMe SSD中的方法（此方法相当于将TF卡中的系统克隆到NVMe SSD）
1. 首先点击Clone drive
1. 然后选择TF卡的设备名/dev/mmcblk1
1. 打开TF卡后的界面如下所示：
1. 然后点击Select target
1. 然后点击Show 2 hidden打开更多存储设备的选项
1. 然后选择NVMe SSD的设备名/dev/nvme0n1,然后点击Select
1. 然后点击Flash
1. 然后点击Yes, I’m sure
1. 然后输入开发板linux系统的密码orangepi，就会开始烧录linux镜像到SSD中
1. 烧录过程的显示如下所示：
1. 烧录完成后的显示如下所示：
1. 然后需要扩容下NVMe SSD中rootfs分区的容量，步骤如下所示：
  1. a) 首先打开GParted，如果系统没有预装Gparted，请使用apt命令安装下
  1. b) 然后输入linux系统的密码orangepi，再点击Authenticate
  1. c) 然后点击Fix
  2. d) 然后选择NVMe SSD
  1. e) 选择NVMe SSD后的显示界面如下所所示：
  1. f) 然后选择/dev/nvme0n1p2分区，再击点击右键，再选择Resize/Move
  1. g) 然后在下图所示的位置将容量拖动到最大
  2. h) 然后点击Resize/Move
  3. i) 然后点击下图位置绿色的 √
  4. j) 再点击Apply
  5. k) 然后点击Close关闭即可
1. 此时就可以使用sudo poweroff命令关机了。然后请拔出TF卡，再短按电源按键开机，此时就会启动SPIFlash+NVMe SSD中的linux系统了。

第9步是克隆TF卡中的系统到NMVe SSD中，我们还可以直接烧录linux镜像文件到NVMe SSD中，这里大概说下步骤：
1. 上传linux镜像文件到开发板的linux系统中
2. 然后使用balenaEtcher烧录即可
3. 使用这种方法烧录镜像后无需手动扩容，第一次启动会自动扩容。

使用RKDevTool烧录的方法

首先需要准备一个M-Key 2280规格的NVMe SSD固态硬盘，开发板M.2插槽PCIe接口的规格为PCIe3.0x4。
然后把NVMe SSD插入下图所示的开发板的M.2 PCIe接口，并固定好
SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置
然后需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和MiniLoader以及烧录工具RKDevTool_Release_v3.15.zip
1. 在Orange Pi的资料下载页面首先选择官方工具，然后进入下面的文件夹中
2. 然后下载下面的所有文件
  
  注意，“MiniLoader-烧录Linux镜像才需要用到的东西”文件夹下文简称为MiniLoader文件夹。

然后从Orange Pi的资料下载页面下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”.img”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上

注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面两种类型的镜像，请下载”TF卡、eMMC和NVME SSD启动镜像”文件夹中的镜像文件。

然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到 RKDevTool打开即可
打开RKDevTool 烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”
然后开始烧录Linux镜像到SSD中
1. 首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
2. 确保开发板没有连接电源，并且没有插入TF卡或者eMMC模块
3. 然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
4. 然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了。Type-C电源接口的位置如下所示：
5. 如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
6. 然后将鼠标光标放在下面的这片区域中
7. 然后点击鼠标右键会弹出下图所示的选择界面
8. 然后选择导入配置选项
9. 然后进入前面下载的MiniLoader文件夹中，再进入pcie_loader文件夹中，然后选择rk3588_linux_pcie.cfg配置文件，再点击打开
10. 然后点击确定
11. 然后点击下图所示的位置
12. 再选择前面下载的MiniLoader文件夹中MiniLoaderAll.bin，再点击打开
13. 然后点击下图所示的位置
14. 然后进入前面下载的MiniLoader文件夹中，然后选择rkspi_loader.img，再点击打开
15. 然后点击下图所示的位置
16. 然后选择想要烧录的linux镜像的路径，再点击打开
  
  在烧录镜像前，建议将要烧录的linux镜像重命名为orangepi.img或者其它比较短的名字，这样在烧录镜像的时候就能看到烧录进度的百分比数值。
17. 然后请勾选上强制按地址写选项
18. 再点击执行按钮就会开始烧录u-boot+linux镜像到SPIFlash+SSD中
19. linux镜像烧录完后的显示log如下图所示
20. 镜像烧录完后会自动启动SPIFlash+PCIe SSD中的linux系统，如果没有正常启动，请重新上电试下。

烧录OpenWRT镜像到SPI FLASH中的方法

此小节介绍的方法是烧录整个OpenWRT镜像到spi flash中，不需要nvme ssd。也就是说，u-boot、内核和rootfs都是存放在spi flash中的。由于开发板上的spi flash只有16MB，所以此系统基本无法安装多少软件，目前只能实现一些基础功能。

使用dd命令烧录的方法

烧录OpenWRT镜像到SPIFlash中需要借助TF卡来完成，所以首先需要将支持TF卡启动的OpenWRT镜像烧录到TF卡上，然后使用TF卡启动开发板进入OpenWRT系统。烧录OpenWRT镜像到TF卡的方法请见基于Windows PC将Linux镜像烧写到TF卡的方法和基于Ubuntu PC将Linux镜像烧写到TF卡的方法两小节的说明。
然后从Orange Pi的资料下载页面下载能够从SPIFlash启动的OpenWRT镜像。打开下载链接后可以看到下面两种类型的OpenWRT镜像，请选择SPIFlash启动镜像文件夹中的镜像进行下载
然后把从官网下载的镜像上传到TF卡中。
然后再执行下面的命令即可将OpenWRT镜像烧写到SPIFlash中。注意if=后面需要指定镜像存放的实际路径

root@OpenWrt:~# dd if=openwrt-rockchip-armv8-xunlong_orangepi-5-plus-spi-squashfs-sysupgrade.bin of=/dev/mtdblock0

然后就可以使用poweroff命令关机了。然后请拔出TF卡，再短按电源按键开机，此时就会启动SPIFlash中的OpenWRT系统了

使用 RKDevTool 烧录的方法

SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置
然后需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和MiniLoader以及烧录工具RKDevTool_Release_v2.96.zip，请确保下载的RKDevTool工具的的版本为v2.96
1. 在Orange Pi的资料下载页面首先选择官方工具，然后进入下面的文件夹中
2. 然后下载下面的所有文件
  
  注意，“MiniLoader-烧录Linux镜像才需要用到的东西”文件夹下文简称为MiniLoader文件夹。
然后从Orange Pi的资料下载页面下载能够从SPIFlash启动的OpenWRT镜像，受限于SPIFlash的容量，镜像是小于16MB的。打开下载链接后可以看到下面两种类型的OpenWRT镜像，请选择SPIFlash启动镜像文件夹中的镜像
然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v2.96.zip，此软件无需安装，在解压后的文件夹中找到 RKDevTool打开即可
打开RKDevTool 烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”
然后开始烧录OpenWRT镜像到SPI FLASH中
1. 首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
2. 确保开发板没有连接电源，并且没有插入TF卡和eMMC模块
3. 然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
4. 然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了
5. 如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
6. 然后将鼠标光标放在下面的这片区域中
7. 然后点击鼠标右键会弹出下图所示的选择界面
8. 然后选择导入配置选项
9. 然后选择前面下载的MiniLoader文件夹中的rk3588_linux_spiflash.cfg配置文件，再点击打开
10. 然后点击确定
11. 然后点击下图所示的位置
12. 再选择前面下载的MiniLoader文件夹中MiniLoaderAll.bin，再点击打开
13. 然后点击下图所示的位置
14. 再选择想要烧录的OpenWRT镜像的路径，再点击打开
  
  在烧录镜像前，建议将要烧录的OpenWRT镜像重命名为orangepi.img或者其它比较短的名字，这样在烧录镜像的时候就能看到烧录进度的百分比数值。
15. 然后请确保强制按地址写选项已勾上
16. 再点击执行按钮就会开始烧录OpenWRT镜像到SPIFlash中
17. OpenWRT镜像烧录完后的显示log如下图所示
18. OpenWRT镜像烧录完后会自动启动，如果没有正常启动，请重新上电试下。

烧录Android镜像到TF卡中的方法

首先准备一张16GB或更大容量的TF卡，TF卡的传输速度必须为class10或以上，建议使用闪迪等品牌的TF卡
然后使用读卡器把TF卡插入电脑
然后从Orange Pi的资料下载页面下载SDDiskTool烧写工具，请确保SDDiskTool工具的版本为最新的v1.72
然后从Orange Pi的资料下载页面下载Android12的镜像
1. 打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择TF卡和eMMC启动镜像文件夹中的镜像进行下载
2. 进入TF卡和eMMC启动镜像文件夹后可以看到下面三个镜像，它们的区别是：
  1. 第一个镜像专门用于HDMI显示的，支持8K显示，如果不使用LCD屏幕，请下载不带lcd的镜像
  2. 如果要使用lcd屏幕，请选择带lcd的镜像
  3. 带box的镜像是专用于电视盒子的镜像
然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Android镜像文件，大小在1GB以上
然后使用解压软件解压SDDiskTool_v1.72.zip，此软件无需安装，在解压后的文件夹中找到SD_Firmware_Tool.exe打开即可
打开SDDiskTool后，如果TF卡识别正常，会在”选择可移动磁盘设备”一栏中显示插入的磁盘设备，请务必确认显示的磁盘设备和你想烧录的TF卡的盘符是一致的，如果没有显示可以尝试拔插下TF卡
确认完盘符后，可以先格式化下TF卡，点击SDDiskTool中的恢复磁盘按钮即可，也可使用前面提到的SD Card Formatter进行TF卡的格式化
然后开始将Android镜像写入TF卡
1. 首先在”选择功能模式”中勾选”SD启动”
2. 然后在”选择升级固件”一栏中选择Android镜像的路径
3. 最后点击”开始创建”按钮就会开始烧录Android镜像到TF卡中
烧录完后即可退出SDDiskTool软件，然后就可以把TF卡从电脑中拔出来插到开发板中启动了

烧录Android镜像烧录到eMMC中的方法

注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPIFlash后再启动试下。清空SPIFlash的方法请参考使用RKDevTool清空SPIFlash的方法小节的内容。

通过Type-C线将Android 镜像烧录到eMMC中的方法

注意，下面所有的操作都是在Windows电脑中进行的。

开发板预留了eMMC的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：
还需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和烧录工具RKDevTool_Release_v3.15.zip
然后从Orange Pi的资料下载页面下载Android的镜像。
1. 打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择TF卡和eMMC启动镜像文件夹中的镜像进行下载
2. 进入TF卡和eMMC启动镜像文件夹后可以看到下面三个镜像，它们的区别是：
  1. 第一个镜像专门用于HDMI显示的，支持8K显示，如果不使用LCD屏幕，请下载不带lcd的镜像
  2. 如果要使用lcd屏幕，请选择带lcd的镜像
  3. 带box的镜像是专用于电视盒子的镜像
然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Android镜像文件，大小在1GB以上
然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到 RKDevTool打开即可
打开RKDevTool 烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”
然后开始烧录Android镜像到eMMC中
1. 首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
2. 然后确保开发板没有插入TF卡，没有连接电源
3. 然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
4. 然后给开发板接上Type-C接口的电源，并上电
5. 如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
6. 然后点击烧录工具的”升级固件”一栏
7. 接着点击”固件”按钮选择需要烧录的Android镜像的路径
8. 最后点击”升级”按钮就会开始烧录，烧录过程中的log如下图所示。烧录完成后Android系统会自动启动。

通过TF卡将Android 12镜像烧录到eMMC中的方法

注意，下面所有的操作都是在Windows电脑中进行的。

开发板预留了eMMC的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：
还需要准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为class10或以上，建议使用闪迪等品牌的TF卡
然后使用读卡器把TF卡插入电脑
然后从Orange Pi的资料下载页面下载SDDiskTool烧写工具，请确保SDDiskTool工具的版本为最新的v1.72
然后从Orange Pi的资料下载页面下载Android的镜像
1. 打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择TF卡和eMMC启动镜像文件夹中的镜像进行下载
2. 进入TF卡和eMMC启动镜像文件夹后可以看到下面三个镜像，它们的区别是：
  1. 第一个镜像专门用于HDMI显示的，支持8K显示，如果不使用LCD屏幕，请下载不带lcd的镜像
  2. 如果要使用lcd屏幕，请选择带lcd的镜像
  3. 带box的镜像是专用于电视盒子的镜像
然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Android镜像文件，大小在1GB以上
然后使用解压软件解压SDDiskTool_v1.72.zip，此软件无需安装，在解压后的文件夹中找到SD_Firmware_Tool.exe打开即可
打开SDDiskTool后，如果TF卡识别正常，会在”选择可移动磁盘设备”一栏中显示插入的磁盘设备，请务必确认显示的磁盘设备和你想烧录的TF卡的盘符是一致的，如果没有显示可以尝试拔插下TF卡
确认完盘符后，可以先格式化下TF卡，点击SDDiskTool中的恢复磁盘按钮即可，也可使用前面提到的SD Card Formatter进行TF卡的格式化
然后开始将Android镜像写入TF卡
1. 首先在“选择可移动磁盘设备”下面确认显示的盘符为TF卡对应的盘符
2. 然后在”选择功能模式”中选择“固件升级”
3. 然后在”选择升级固件”一栏中选择Android固件的路径
4. 最后点击”开始创建”按钮就会开始烧录
烧录完成后的显示如下图所示，然后就可以退出SDDiskTool
然后把TF卡从电脑中拔出来插到开发板中，开发板上电启动后就会自动开始将TF卡中的Android镜像烧录到开发板的eMMC中
如果开发板连接了HDMI显示器，还可以从HDMI显示器中看到烧录Android镜像到eMMC中的进度条
当HDMI显示器显示如下信息时，说明烧录Android镜像到eMMC中已完成，此时就可以拔出TF卡，然后eMMC中的安卓系统就会开始启动。

烧录Android镜像到SPIFlash+NVMe SSD中的方法

注意，下面所有的操作都是在Windows电脑中进行的。

首先需要准备一个M-Key 2280规格的NVMe SSD固态硬盘，开发板M.2插槽PCIe接口的规格为PCIe3.0x4。
然后把NVMe SSD插入开发板的M.2 PCIe接口，并固定好
SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置
还需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和烧录工具RKDevTool_Release_v3.15.zip
然后从Orange Pi的资料下载页面下载Android12的镜像
1. 打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择SPIFlash-NVME > SSD启动镜像文件夹中的镜像进行下载
2. 进入SPIFlash-NVME > SSD启动镜像文件夹后可以看到下面三个镜像，它们的区别是：
  1. 第一个镜像专门用于HDMI显示的，支持8K显示，如果不使用LCD屏幕，请下载不带lcd的镜像
  2. 如果要使用lcd屏幕，请选择带lcd的镜像
  3. 带box的镜像是专用于电视盒子的镜像
然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到 RKDevTool打开即可
打开RKDevTool 烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”
然后开始烧录Android镜像到SPIFlash+NVMe SSD中
1. 首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
2. 确保开发板没有插入TF和eMMC模块，没有连接电源
3. 然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
4. 然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了
5. 如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
6. 然后点击烧录工具的”升级固件”一栏
7. 接着点击”固件”按钮选择需要烧录的Android镜像
8. 最后点击”升级”按钮就会开始烧录，烧录的过程如下图所示，可以看到，首先会烧录固件到SPIFlash中，然后烧录固件到PCIE中。烧录完成后Android系统会自动启动。

烧录Orange Pi OS (Droid)镜像到TF卡中的方法

注意，下面所有的操作都是在Windows电脑中进行的。

首先准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为class10或以上，建议使用闪迪等品牌的TF卡
然后使用读卡器把TF卡插入电脑
然后从Orange Pi的资料下载页面下载SDDiskTool烧写工具，请确保SDDiskTool工具的版本为最新的v1.72
然后从Orange Pi的资料下载页面下载Orange Pi OS (Droid)的镜像,打开Orange Pi OS (Droid)镜像的下载链接后可以看到下面两种类型的镜像，请选择下面的镜像
然后使用解压软件解压下载的Orange Pi OS (Droid)镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Orange Pi OS (Droid)镜像文件，大小在1GB以上
然后使用解压软件解压SDDiskTool_v1.72.zip，此软件无需安装，在解压后的文件夹中找到SD_Firmware_Tool.exe打开即可
打开SDDiskTool后，如果TF卡识别正常，会在”选择可移动磁盘设备”一栏中显示插入的磁盘设备，请务必确认显示的磁盘设备和你想烧录的TF卡的盘符是一致的，如果没有显示可以尝试拔插下TF卡
确认完盘符后，可以先格式化下TF卡，点击SDDiskTool中的恢复磁盘按钮即可，也可使用前面提到的SD Card Formatter进行TF卡的格式化
然后开始将Orange Pi OS (Droid)镜像写入TF卡
1. 首先在”选择功能模式”中勾选”SD启动”
2. 然后在”选择升级固件”一栏中选择Orange Pi OS (Droid)镜像的路径
3. 最后点击”开始创建”按钮就会开始烧录Orange Pi OS (Droid)镜像到TF卡中
烧录完后即可退出SDDiskTool软件，然后就可以把TF卡从电脑中拔出来插到开发板中启动了

烧录Orange Pi OS (Droid)镜像到eMMC中的方法

注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPIFlash后再启动试下。清空SPIFlash的方法请参考使用RKDevTool清空SPIFlash的方法小节的内容。

通过Type-C线将Orange Pi OS (Droid) 镜像烧录到eMMC

注意，下面所有的操作都是在Windows电脑中进行的。

开发板预留了eMMC的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：
还需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和烧录工具RKDevTool_Release_v3.15.zip
然后从Orange Pi的资料下载页面下载Orange Pi OS (Droid)的镜像
然后使用解压软件解压下载的Orange Pi OS (Droid)镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Orange Pi OS (Droid)镜像文件，大小在1GB以上
然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到RKDevTool打开即可
打开RKDevTool烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”
然后开始烧录Orange Pi OS (Droid)镜像到eMMC中
1. 首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
2. 确保开发板没有插入TF卡，没有连接电源
3. 然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
4. 然后给开发板接上Type-C接口的电源，并上电
5. 如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
6. 然后点击烧录工具的”升级固件”一栏
7. 接着点击”固件”按钮选择需要烧录的Orange Pi OS > (Droid)镜像的路径
8. 最后点击”升级”按钮就会开始烧录，烧录过程中的log如下图所示。烧录完成后Orange > Pi OS (Droid)系统会自动启动。

通过TF卡将Orange Pi OS (Droid)镜像烧录到eMMC

注意，下面所有的操作都是在Windows电脑中进行的。

开发板预留了eMMC的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：
还需要准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为class10或以上，建议使用闪迪等品牌的TF卡
然后使用读卡器把TF卡插入电脑
然后从Orange Pi的资料下载页面下载SDDiskTool烧写工具，请确保SDDiskTool工具的版本为最新的v1.72
然后从Orange Pi的资料下载页面下载Orange Pi OS (Droid)的镜像
然后使用解压软件解压下载的Orange Pi OS (Droid)镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Orange Pi OS (Droid)镜像文件，大小在1GB以上
然后使用解压软件解压SDDiskTool_v1.72.zip，此软件无需安装，在解压后的文件夹中找到SD_Firmware_Tool.exe打开即可
打开SDDiskTool后，如果TF卡识别正常，会在”选择可移动磁盘设备”一栏中显示插入的磁盘设备，请务必确认显示的磁盘设备和你想烧录的TF卡的盘符是一致的，如果没有显示可以尝试拔插下TF卡
确认完盘符后，可以先格式化下TF卡，点击SDDiskTool中的恢复磁盘按钮即可，也可使用前面提到的SD Card Formatter进行TF卡的格式化
然后开始将Orange Pi OS (Droid)镜像写入TF卡
1. 首先在“选择可移动磁盘设备”下面确认显示的盘符为TF卡对应的盘符
2. 然后在”选择功能模式”中选择“固件升级”
3. 然后在”选择升级固件”一栏中选择Orange Pi OS (Droid)固件的路径
4. 最后点击”开始创建”按钮就会开始烧录
烧录完成后的显示如下图所示，然后就可以退出SDDiskTool
然后把TF卡从电脑中拔出来插到开发板中，开发板上电启动后就会自动开始将TF卡中的Orange Pi OS (Droid)镜像烧录到开发板的eMMC中
如果开发板连接了HDMI显示器，还可以从HDMI显示器中看到烧录Orange Pi OS (Droid)镜像到eMMC中的进度条
当HDMI显示器显示如下信息时，说明烧录Orange Pi OS (Droid)镜像到eMMC中已完成，此时就可以拔出TF卡，然后eMMC中的Orange Pi OS (Droid)系统就会开始启动。

烧录Orange Pi OS (Droid)镜像到SPIFlash+NVMe SSD中

注意，下面所有的操作都是在Windows电脑中进行的。

首先需要准备一个2280规格的NVMe SSD固态硬盘，开发板M.2插槽PCIe接口的规格为PCIe3.0x4。
然后把NVMe SSD插入开发板的M.2 PCIe接口，并固定好
SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置
还需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip，烧录工具RKDevTool_Release_v3.15.zip
然后下载Orange Pi OS (Droid)的镜像，打开Orange Pi OS (Droid)镜像的下载链接后可以看到下面两种类型的镜像，请选择带spi-nvme的镜像进行下载
然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到RKDevTool打开即可
打开RKDevTool烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”
然后开始烧录Android镜像到SPIFlash+NVMe SSD中
1. 首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
2. 确保开发板没有插入TF和eMMC模块，没有连接电源
3. 然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
4. 然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了
5. 如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
6. 然后点击烧录工具的”升级固件”一栏
7. 接着点击”固件”按钮选择需要烧录的Orange Pi OS (Droid)镜像
8. 最后点击”升级”按钮就会开始烧录，烧录的过程如下图所示，可以看到，首先会烧录固件到SPIFlash中，然后烧录固件到PCIE中。烧录完成后Orange Pi OS (Droid)系统会自动启动。

使用RKDevTool清空SPIFlash的方法

SPI Flash在开发板上的位置如下图所示
首先需要准备一根品质良好的Type-C接口的数据线
然后从Orange Pi的资料下载页面下载瑞芯微驱动DriverAssitant_v5.12.zip和MiniLoader以及烧录工具RKDevTool_Release_v3.15.zip
1. 在Orange Pi的资料下载页面首先选择官方工具，然后进入下面的文件夹中
2. 然后下载下面的所有文件
  
  注意，“MiniLoader-烧录Linux镜像才需要用到的东西”文件夹下文简称为MiniLoader文件夹。
然后用解压软件解压DriverAssitant_v5.12.zip，再在解压后的文件夹中找到DriverInstall.exe可执行文件并打开即可
打开DriverInstall.exe后安装瑞芯微驱动的步骤如下所示
1. 点击”驱动安装”按钮
2. 等待一段时间后，会弹出窗口提示”安装驱动成功”，然后点击“确定”按钮即可
然后解压RKDevTool_Release_v3.15.zip，此软件无需安装，在解压后的文件夹中找到 RKDevTool打开即可
打开RKDevTool 烧录工具后，因为电脑此时还没有通过Type-C线连接上开发板，所以左下角会提示”没有发现设备”

然后就可以开始清空SPI FLASH中的内容

首先通过Type-C数据线连接好开发板与Windows电脑，开发板Type-C接口的位置如下图所示
确保开发板没有连接电源
然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：
然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了
如果前面的步骤顺利，此时开发板会进入MASKROM模式，在烧录工具的界面上会提示”发现一个MASKROM设备”
然后请选择高级功能
然后点击下图所示的位置
再选择前面下载的MiniLoader文件夹中的MiniLoaderAll.bin，再点击打开
然后点击下载
下载完MiniLoaderAll.bin后的显示如下图所示
然后选择存储设备为SPINOR
然后点击切换存储
然后点击擦除所有就会开始擦除SPIFlash了
擦除SPIFlash后的显示log如下图所示

启动香橙派开发板

将烧录好镜像的TF卡或eMMC模块插入香橙派开发板的TF卡插槽中。如果SPIFlash+NVMe SSD已经烧录好镜像了，那么就不需要插入TF卡或eMMC模块了，只需确保NVMe SSD正常插入到开发板中即可。
开发板有HDMI接口，可以通过HDMI转HDMI连接线把开发板连接到电视或者HDMI显示器。如果有购买LCD屏幕，也可以使用LCD屏幕来显示开发板的系统界面。如果有Type-C转HDMI的线，也可以通过Type-C接口来显示开发板的系统界面。
接上USB鼠标和键盘，用于控制香橙派开发板。
开发板有以太网口，可以插入网线用来上网。
连接一个5V/4A的USB Type-C接口的高品质的电源适配。

切记不要插入电压输出大于5V的电源适配器，会烧坏开发板。系统上电启动过程中很多不稳定的现象基本都是供电有问题导致的，所以一个靠谱的电源适配器很重要。如果启动过程中发现有不断重启的现象，请更换下电源或者Type-C数据线再试下。 Type-C电源接口是不支持PD协商的。另外请不要接到电脑的USB接口来给开发板供电。

开发板上有两个长得一样的Type-C接口，其中网口旁边竖着的那个才是电源接口，另外那个Type-C接口是没有供电功能的，请别接错了。

然后打开电源适配器的开关，如果一切正常，此时HDMI显示器或者LCD屏幕就能看到系统的启动画面了。
如果想通过调试串口查看系统的输出信息，请使用串口线将开发板连接到电脑，串口的连接方法请参看调试串口的使用方法一节。

调试串口的使用方法

调试串口的连接说明

首先需要准备一个3.3V的USB转TTL模块，然后将USB转TTL模块的USB接口一端插入到电脑的USB接口中。

为了更好的兼容性，推荐使用CH340 USB转TTL模块，请不要使用CP2102、PL2303类型的USB转TTL模块。购买USB转TTL模块前，请确认模块支持1500000速率的波特率。

开发板的调试串口GND、RXD和TXD引脚的对应关系如下图所示：
USB转TTL模块GND、TXD和RXD引脚需要通过杜邦线连接到开发板的调试串口上
1. USB转TTL模块的GND接到开发板的GND上
2. USB转TTL模块的RX接到开发板的TX上
3. USB转TTL模块的TX接到开发板的RX上

USB转TTL模块连接电脑和Orange Pi开发板的示意图如下所示

串口的TX和RX是需要交叉连接的，如果不想仔细区分TX和RX的顺序，可以把串口的TX和RX先随便接上，如果测试没有输出再交换下TX和RX的顺序，这样就总有一种顺序是对的。

Ubuntu平台调试串口的使用方法

Linux下可以使用的串口调试软件有很多，如putty、minicom等，下面演示下putty的使用方法。

首先将USB转TTL模块插入Ubuntu电脑的USB接口，如果USB转TTL模块连接识别正常，在Ubuntu PC的/dev下就可以看到对应的设备节点名，记住这个节点名，后面设置串口软件时会用到。

test@test:~$ ls /dev/ttyUSB*

/dev/ttyUSB0
然后使用下面的命令在Ubuntu PC上安装下putty

test@test:~$ sudo apt-get update

test@test:~$ sudo apt-get install -y putty
然后运行putty，记得加sudo权限

test@test:~$ sudo putty
执行putty命令后会弹出下面的界面
首先选择串口的设置界面
然后设置串口的参数
1. 设置Serial line to connect to为/dev/ttyUSB0（修改为对应的节点名，一般为/dev/ttyUSB0）
2. 设置Speed(baud)为1500000（串口的波特率）
3. 设置Flow control为None
在串口的设置界面设置完后，再回到Session界面
1. 首先选择Connection type为Serial
2. 然后点击Open按钮连接串口
启动开发板后，就能从打开的串口终端中看到系统输出的Log信息了

Windows平台调试串口的使用方法

Windows下可以使用的串口调试软件有很多，如SecureCRT、MobaXterm等，下面演示MobaXterm的使用方法，这款软件有免费版本，无需购买序列号即可使用。

下载MobaXterm
1. 下载MobaXterm网址如下
```
https://mobaxterm.mobatek.net
```
2. 进入MobaXterm下载网页后点击GET XOBATERM NOW!
3. 然后选择下载Home版本
4. 然后选择Portable便携式版本，下载完后无需安装，直接打开就可以使用
下载完后使用解压缩软件解压下载的压缩包，即可得到MobaXterm的可执软件，然后双击打开
打开软件后，设置串口连接的步骤如下
1. 打开会话的设置界面
2. 选择串口类型
3. 选择串口的端口号（根据实际的情况选择对应的端口号），如果看不到端口号，请使用360驱动大师扫描安装USB转TTL串口芯片的驱动
4. 选择串口的波特率为1500000
5. 最后点击”OK”按钮完成设置

点击“OK”按钮后会进入下面的界面，此时启动开发板就能看到串口的输出信息了

使用开发板40pin接口中的5v引脚供电说明

我们推荐的开发板的供电方式是使用5V/4A或者5V/5A的Type C接口的电源线插到开发板的Type-C电源接口来供电的。如果需要使用40pin接口中的5V引脚来给开发板供电，请确保使用的电源线和电源适配器能满足开发板的供电需求。如果有使用不稳定的情况，请换回Type-C电源供电。

首先需要准备一根下图所示的电源线

上图所示的电源线在淘宝可以买到，请自行搜索购买。
使用40pin接口中的5V引脚来给开发板供电，电源线的接法如下所示
1. 上图所示的电源线USB A口需要插到5V/4A或者5V/5A的电源适配器接头上（请不要插到电脑的USB接口来供电，一般的手机充电头也不行，因为开发板没有PD功能，一般的手机充电头只能输出最低的5V/2A）
2. 红色的杜邦线需要插到开发板40pin的5V引脚上
3. 黑色的杜邦线需要插到40pin接口的GND引脚上
4. 40pin接口5V引脚和GND引脚在开发板中的位置如下图所示，切记不要接反了

Ubuntu/Debian Server和Xfce桌面系统使用说明

本章内容是基于Ubuntu/Debian的服务器版本镜像和xfce桌面版本镜像编写的。如果使用的是Ubuntu22.04 Gnome镜像，请先查看Ubuntu22.04 Gnome Wayland桌面系统使用说明一章的说明。 Ubuntu22.04 Gnome Wayland桌面系统使用说明一章中不存在的内容，可以参考此章的说明，但是有些细节是会有差异的，这点请特别注意下。如果使用的是OPi OS Arch镜像，请查看Orange Pi OS Arch系统使用说明一章的内容。

已支持的Ubuntu/Debian镜像类型和内核版本

Linux镜像类型	内核版本	服务器版	桌面版
Debian 11 - Bullseye	Linux5.10	支持	支持
Debian 12 - Bookworm	Linux5.10	支持	支持
Ubuntu 20.04 - Focal	Linux5.10	支持	支持
Ubuntu 22.04 - Jammy	Linux5.10	支持	支持

linux系统适配情况

功能	Debian11	Debian12	Ubuntu20.04	Ubuntu22.04
HDMI TX1视频	OK	OK	OK	OK
HDMI TX1音频	OK	OK	OK	OK
HDMI TX2视频	OK	OK	OK	OK
HDMI TX2音频	OK	OK	OK	OK
HDMI RX视频	OK	OK	OK	OK
HDMI RX音频	OK	OK	OK	OK
USB2.0X2	OK	OK	OK	OK
USB3.0X2	OK	OK	OK	OK
2.5G PCIe网口X2	OK	OK	OK	OK
2.5G PCIe网口灯	OK	OK	OK	OK
调试串口	OK	OK	OK	OK
RTC芯片	OK	OK	OK	OK
FAN风扇接口	OK	OK	OK	OK
eMMC扩展接口	OK	OK	OK	OK
AP6275P-WIFI	OK	OK	OK	OK
AP6275P-BT	OK	OK	OK	OK
AX200-WIFI	OK	OK	OK	OK
AX200-BT	OK	OK	OK	OK
AX210-WIFI	OK	OK	OK	OK
AX210-BT	OK	OK	OK	OK
RTL8852BE-WIFI	OK	OK	OK	OK
RTL8852BE-BT	OK	OK	OK	OK
MaskROM按键	OK	OK	OK	OK
Type-C转USB3.0	OK	OK	OK	OK
Type-C ADB功能	OK	OK	OK	OK
Type-C DP视频	OK	OK	OK	OK
Type-C DP音频	OK	OK	OK	OK
开关机按键	OK	OK	OK	OK
红外功能	OK	OK	OK	OK
三色LED灯	OK	OK	OK	OK
板载MIC	OK	OK	OK	OK
耳机播放	OK	OK	OK	OK
耳机录音	OK	OK	OK	OK
SPK喇叭	OK	OK	OK	OK
40PIN GPIO	OK	OK	OK	OK
40PIN I2C	OK	OK	OK	OK
40PIN SPI	OK	OK	OK	OK
40PIN UART	OK	OK	OK	OK
40PIN CAN	OK	OK	OK	OK
40PIN PWM	OK	OK	OK	OK
TF卡启动	OK	OK	OK	OK
SPI+NVME启动	OK	OK	OK	OK
OV13850摄像头	OK	OK	OK	OK
OV13855摄像头	OK	OK	OK	OK
GPU	OK	OK	OK	OK
VPU	OK	OK	OK	OK
NPU	OK	OK	OK	OK
REBOOT命令重启	OK	OK	OK	OK
Poweroff命令关机	OK	OK	OK	OK
MIPI LCD显示	OK	OK	OK	OK
MIPI LCD触摸	OK	OK	OK	OK
Chromium硬解视频	OK	OK	OK	OK

本手册linux命令格式说明

本手册中所有需要在Linux系统中输入的命令都会使用下面的方框框起来

如下所示，黄色方框里内容表示需要特别注意的内容，这里面的命令除外。
命令前面的提示符类型说明
1. 命令前面提示符指的是下面方框内红色部分的内容，这部分内容不是linux命令的一部分，所以在linux系统中输入命令时，请不要把红色字体部分的内容也输入进去。
  
  orangepi@orangepi:~$ sudo apt update
  
  root@orangepi:~# vim /boot/boot.cmd
  
  test@test:~$ ssh root@192.168.1.xxx
  
  root@test:~# ls
2. root@orangepi:~$ 提示符表示这个命令是在开发板的linux系统中输入的，提示符最后的 $ 表示系统当前用户为普通用户，当执行特权命令时，需要加上sudo
3. root@orangepi:~# 提示符表示这个命令是在开发板的linux系统中输入的，提示符最后的 # 表示系统当前用户为root用户，可以执行任何想要执行的命令
4. test@test:~$ 提示符表示这个命令是在Ubuntu PC或者Ubuntu虚拟机中输入的，而不是开发板的linux系统中。提示符最后的 $ 表示系统当前用户为普通用户，当执行特权命令时，需要加上sudo
5. root@test:~# 提示符表示这个命令是在Ubuntu PC或者Ubuntu虚拟机中输入的，而不是开发板的linux系统中。提示符最后的 # 表示系统当前用户为root用户，可以执行任何想要执行的命令

哪些是需要输入的命令？

如下所示，黑色加粗部分是需要输入的命令，命令下面的是输出的内容（有些命令有输出，有些可能没有输出），这部分内容是不需要输入的

root@orangepi:~# cat /boot/orangepiEnv.txt

verbosity=7

bootlogo=false

console=serial

如下所示，有些命令一行写不下会放到下一行，只要黑色加粗的部分就都是需要输入的命令。当这些命令输入到一行的时候，每行最后的”\”是需要去掉的，这个不是命令的一部分。另外命令的不同部分都是有空格的，请别漏了

orangepi@orangepi:~$ echo \ "deb [arch=$(dpkg --print-architecture) \ signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \ https://download.docker.com/linux/debian \ $(lsb_release -cs) stable" \| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

linux系统登录说明

linux系统默认登录账号和密码

账号	密码
root	orangepi
orangepi	orangepi

注意，输入密码的时候，屏幕上是不会显示输入的密码的具体内容的，请不要以为是有什么故障，输入完后直接回车即可。

当输入密码提示错误，或者ssh连接有问题，请注意，只要使用的是Orange Pi提供的Linux镜像，就请不要怀疑上面的密码不对，而是要找其它的原因。

设置linux系统终端自动登录的方法

linux系统默认就是自动登录终端的，默认登录的用户名是orangepi
使用下面的命令可以设置root用户自动登录终端

orangepi@orangepi:~$ sudo auto_login_cli.sh root
使用下面的命令可以禁止自动登录终端

orangepi@orangepi:~$ sudo auto_login_cli.sh -d
使用下面的命令可以再次设置orangepi用户自动登录终端

orangepi@orangepi:~$ sudo auto_login_cli.sh orangepi

linux桌面版系统自动登录说明

桌面版系统启动后会自动登录进入桌面，无需输入密码
运行下面的命令可以禁止桌面版系统自动登录桌面

orangepi@orangepi:~$ sudo disable_desktop_autologin.sh
然后重启系统就会出现登录对话框，此时需要输入密码才能进入系统

Linux桌面版系统root用户自动登录的设置方法

执行下面的命令可以设置桌面版系统使用root用户自动登录

orangepi@orangepi:~$ sudo desktop_login.sh root

然后重启系统，就会自动使用root用户登录桌面了

注意，如果使用root用户登录桌面系统，是无法使用右上角的pulseaudio来管理音频设备的。另外请注意这并不是一个bug，因为pulseaudio本来就不允许在root用户下运行。

执行下面的命令可以再次设置桌面版系统使用orangepi用户自动登录

orangepi@orangepi:~$ sudo desktop_login.sh orangepi

Linux桌面版系统禁用桌面的方法

首先在命令行中输入下面的命令，请记得加sudo权限

orangepi@orangepi:~$ sudo systemctl disable lightdm.service
然后重启Linux系统就会发现不会显示桌面了

orangepi@orangepi:~$ sudo reboot
重新打开桌面的步骤如下所示：
1. 首先在命令行中输入下面的命令，请记得加sudo权限
  
  orangepi@orangepi:~$ sudo systemctl start lightdm.service
2. 选择完后显示器就会显示桌面了

板载LED灯测试说明

开发板上有一个红绿蓝三色灯，所在位置如下图所示：
只要开发板打开了电源，红色的LED灯就会常亮，这是由硬件控制的，软件无法关闭。通过红色的LED灯可以确定开发板的电源是否已正常开启。
绿色和蓝色的LED灯在内核启动后会一直闪烁，这是由软件控制的。
使用命令设置绿灯亮灭和闪烁的方法如下所示：

注意，下面的操作请在root用户下进行。
1. 首先进入绿灯的设置目录
  
  root@orangepi:~# cd /sys/class/leds/green_led
2. 设置绿灯停止闪烁的命令如下
  
  root@orangepi:/sys/class/leds/green_led# echo none > trigger
3. 设置绿灯常亮的命令如下
  
  root@orangepi:/sys/class/leds/green_led# echo default-on > trigger
4. 设置绿灯闪烁的命令如下
  
  root@orangepi:/sys/class/leds/green_led# echo heartbeat > trigger
使用命令设置蓝灯亮灭和闪烁的方法如下所示：

注意，下面的操作请在root用户下进行。
1. 首先进入蓝灯的设置目录
  
  root@orangepi:~# cd /sys/class/leds/blue_led
2. 设置蓝灯停止闪烁的命令如下
  
  root@orangepi:/sys/class/leds/blue_led# echo none > trigger
3. 设置蓝灯常亮的命令如下
  
  root@orangepi:/sys/class/leds/blue_led# echo default-on > trigger
4. 设置蓝灯闪烁的命令如下
  
  root@orangepi:/sys/class/leds/blue_led# echo heartbeat > trigger
如果开机后不需要LED灯闪烁，可以使用下面的方法来关闭绿灯和蓝灯
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中opi5plus-disable-leds配置
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效
8. 重启后就可以看到开发板上只有红灯常亮了，绿灯和蓝灯都不会闪烁了

网络连接测试

2.5G以太网口测试

开发板有两个2.5G的以太网接口，两个网口的测试方法是一样的。首先将网线的一端插入开发板的以太网接口，网线的另一端接入路由器，并确保网络是畅通的。
系统启动后会通过DHCP自动给以太网卡分配IP地址，不需要其他任何配置。

在开发板的Linux系统中查看IP地址的命令如下所示：

orangepi@orangepi:~$ ip addr show 1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000 link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 inet 127.0.0.1/8 scope host lo valid_lft forever preferred_lft forever inet6 ::1/128 scope host valid_lft forever preferred_lft forever 2: enP3p49s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000 link/ether 00:e0:4c:68:00:26 brd ff:ff:ff:ff:ff:ff inet 192.168.1.245/24 brd 192.168.1.255 scope global dynamic noprefixroute enP3p49s0 valid_lft 42537sec preferred_lft 42537sec inet6 fe80::9005:95ac:b9c0:2beb/64 scope link noprefixroute valid_lft forever preferred_lft forever 3: enP4p65s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000 link/ether 00:e0:4c:68:00:27 brd ff:ff:ff:ff:ff:ff inet 192.168.1.247/24 brd 192.168.1.255 scope global dynamic noprefixroute enP4p65s0 valid_lft 43179sec preferred_lft 43179sec inet6 fe80::62b5:dc5e:728e:39a3/64 scope link noprefixroute valid_lft forever preferred_lft forever

当使用ifconfig查看IP地址时，如果提示下面的信息，是因为没有加sudo导致的，正确的命令是：sudo ifconfig orangepi@orangepi:~$ ifconfig Command 'ifconfig' is available in the following places * /sbin/ifconfig * /usr/sbin/ifconfig The command could not be located because '/sbin:/usr/sbin' is not included in the PATH environment variable. This is most likely caused by the lack of administrative privileges associated with your user account. ifconfig: command not found

开发板启动后查看IP地址有三种方法：接HDMI显示器，然后登录系统使用ip addr show命令查看IP地址在调试串口终端输入ip addr show命令来查看IP地址如果没有调试串口，也没有HDMI显示器，还可以通过路由器的管理界面来查看开发板网口的IP地址。不过这种方法经常有人会无法正常看到开发板的IP地址。如果看不到，调试方法如下所示：首先检查Linux系统是否已经正常启动，如果开发板的三色灯在闪烁了，一般是正常启动了，如果只亮红灯，说明系统都没正常启动；检查网线有没有插紧，或者换根网线试下；换个路由器试下（路由器的问题有遇到过很多，比如路由器无法正常分配IP地址，或者已正常分配IP地址但在路由器中看不到）；如果没有路由器可换就只能连接HDMI显示器或者使用调试串口来查看IP地址。另外需要注意的是开发板DHCP自动分配IP地址是不需要任何设置的。

测试网络连通性的命令如下，ping命令可以通过Ctrl+C快捷键来中断运行

orangepi@orangepi:~$ ping www.baidu.com -I enP4p65s0 #其中一个网口的测试命令 orangepi@orangepi:~$ ping www.baidu.com -I enP3p49s0 #另一个网口的测试命令 PING www.a.shifen.com (14.119.104.254) from 192.168.1.182 enP3p49s0: 56(84) bytes of data. 64 bytes from 14.119.104.254 (14.119.104.254): icmp_seq=1 ttl=56 time=6.26 ms 64 bytes from 14.119.104.254 (14.119.104.254): icmp_seq=6 ttl=56 time=5.69 ms ^C --- www.a.shifen.com ping statistics --- 6 packets transmitted, 6 received, 0% packet loss, time 5008ms rtt min/avg/max/mdev = 5.671/5.859/6.264/0.202 ms

WIFI连接测试

首先请注意Orange Pi 5 Plus开发板上是没有WIFI模块的，需要外接PCIe网卡或者USB网卡才能使用WIFI功能。外接PCIe网卡的使用说明请参考PCIe WIFI6+蓝牙模块的使用方法一小节。外接USB网卡的使用说明请参考USB无线网卡测试一小节。

请不要通过修改/etc/network/interfaces配置文件的方式来连接WIFI，通过这种方式连接WIFI网络使用会有问题。

服务器版镜像通过命令连接WIFI

当开发板没有连接以太网，没有连接HDMI显示器，只连接了串口时，推荐使用此小节演示的命令来连接WIFI网络。因为nmtui在某些串口软件（如minicom）中只能显示字符，无法正常显示图形界面。当然，如果开发板连接了以太网或者HDMI显示屏，也可以使用此小节演示的命令来连接WIFI网络的。下面演示的命令都是默认WIFI的网络设备节点名为wlan0，但不同的WIFI模块节点名会有不同，请注意替换为实际看到的节点名，不要照抄。

先登录linux系统，有下面三种方式
1. 如果开发板连接了网线，可以通过ssh远程登录linux系统
2. 如果开发板连接好了调试串口，可以使用串口终端登录linux系统
3. 如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统
首先使用nmcli dev wifi命令扫描周围的WIFI热点

orangepi@orangepi:~$ nmcli dev wifi
然后使用nmcli 命令连接扫描到的WIFI热点，其中：
1. wifi_name需要换成想连接的WIFI热点的名字
2. wifi_passwd需要换成想连接的WIFI热点的密码
  
  orangepi@orangepi:~$ nmcli dev wifi connect wifi_name password wifi_passwd
  
  Device 'wlan0' successfully activated with 'cf937f88-ca1e-4411-bb50-61f402eef293'.

通过ip addr show wlan0命令可以查看wifi的IP地址

WIFI的设备节点名不一定都是wlan0，请以实际看到的为准。

orangepi@orangepi:~$ ip addr show wlan0 11: wlan0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000 link/ether 23:8c:d6:ae:76:bb brd ff:ff:ff:ff:ff:ff inet 192.168.1.11/24 brd 192.168.1.255 scope global dynamic noprefixroute wlan0 valid_lft 259192sec preferred_lft 259192sec inet6 240e:3b7:3240:c3a0:c401:a445:5002:ccdd/64 scope global dynamic noprefixroute valid_lft 259192sec preferred_lft 172792sec inet6 fe80::42f1:6019:a80e:4c31/64 scope link noprefixroute valid_lft forever preferred_lft forever

使用ping命令可以测试wifi网络的连通性，ping命令可以通过Ctrl+C快捷键来中断运行

WIFI的设备节点名不一定都是wlan0，请以实际看到的为准。

orangepi@orangepi:~$ ping www.orangepi.org -I wlan0 PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data. 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=2 ttl=52 time=41.3 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=3 ttl=52 time=44.9 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=4 ttl=52 time=45.6 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=5 ttl=52 time=48.8 ms ^C --- www.orangepi.org ping statistics --- 5 packets transmitted, 5 received, 0% packet loss, time 4006ms rtt min/avg/max/mdev = 41.321/44.864/48.834/2.484 ms

服务器版镜像通过图形化方式连接WIFI

先登录linux系统，有下面三种方式
1. 如果开发板连接了网线，可以通过ssh远程登录linux系统
2. 如果开发板连接好了调试串口，可以使用串口终端登录linux系统（串口软件请使用MobaXterm，使用minicom无法显示图形界面）
3. 如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统
然后在命令行中输入nmtui命令打开wifi连接的界面

orangepi@orangepi:~$ nmtui
输入nmtui命令打开的界面如下所示
选择Activate a connect后回车
然后就能看到所有搜索到的WIFI热点
选择想要连接的WIFI热点后再使用Tab键将光标定位到Activate后回车
然后会弹出输入密码的对话框，在Password内输入对应的密码然后回车就会开始连接WIFI
WIFI连接成功后会在已连接的WIFI名称前显示一个”*”

通过ip addr show wlan0命令可以查看wifi的IP地址

WIFI的设备节点名不一定都是wlan0，请以实际看到的为准。

orangepi@orangepi:~$ ip addr show wlan0 11: wlan0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000 link/ether 24:8c:d3:aa:76:bb brd ff:ff:ff:ff:ff:ff inet 192.168.1.11/24 brd 192.168.1.255 scope global dynamic noprefixroute wlan0 valid_lft 259069sec preferred_lft 259069sec inet6 240e:3b7:3240:c4a0:c401:a445:5002:ccdd/64 scope global dynamic noprefixroute valid_lft 259071sec preferred_lft 172671sec inet6 fe80::42f1:6019:a80e:4c31/64 scope link noprefixroute valid_lft forever preferred_lft forever

使用ping命令可以测试wifi网络的连通性，ping命令可以通过Ctrl+C快捷键来中断运行

WIFI的设备节点名不一定都是wlan0，请以实际看到的为准。

orangepi@orangepi:~$ ping www.orangepi.org -I wlan0 PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data. 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=2 ttl=52 time=41.3 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=3 ttl=52 time=44.9 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=4 ttl=52 time=45.6 ms 64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=5 ttl=52 time=48.8 ms ^C --- www.orangepi.org ping statistics --- 5 packets transmitted, 5 received, 0% packet loss, time 4006ms rtt min/avg/max/mdev = 41.321/44.864/48.834/2.484 ms

桌面版镜像的测试方法

点击桌面右上角的网络配置图标（测试WIFI时请不要连接网线）
在弹出的下拉框中点击More networks可以看到所有扫描到的WIFI热点，然后选择想要连接的WIFI热点
然后输入WIFI热点的密码，再点击Connect就会开始连接WIFI
连接好WIFI后，可以打开浏览器查看是否能上网，浏览器的入口如下图所示
打开浏览器后如果能打开其他网页说明WIFI连接正常

设置静态IP地址的方法

请不要通过修改/etc/network/interfaces配置文件的方式来设置静态IP地址。

使用nmtui命令来设置静态IP地址

首先运行nmtui命令

orangepi@orangepi:~$ nmtui
然后选择Edit a connection并按下回车键
然后选择需要设置静态IP地址的网络接口，比如设置Ethernet接口的静态IP地址选择Wired connection 1或者Wired connection 2
然后通过Tab键选择Edit并按下回车键
然后通过Tab键将光标移动到下图所示的<Automatic>位置进行IPv4的配置
然后回车，通过上下方向键选择Manual，然后回车确定
选择完后的显示如下图所示
然后通过Tab键将光标移动到<Show>
然后回车，回车后会弹出下面的设置界面
然后就可以在下图所示的位置设置IP地址(Addresses)、网关(Gateway)和DNS服务器的地址（里面还有很多其他设置选项，请自行探索），请根据自己的具体需求来设置，下图中设置的值只是一个示例
设置完后将光标移动到右下角的<OK>，然后回车确认
然后点击<Back>回退到上一级选择界面
然后选择Activate a connection，再将光标移动到<OK>，最后点击回车
然后选择需要设置的网络接口，比如Wired connection 2，然后将光标移动到<Deactivate>，再按下回车键禁用Wired connection 2
然重新选择并使能Wired connection 2，这样前面设置的静态IP就会生效了
然后通过<Back>和Quit按钮就可以退出nmtui

然后通过ip addr show就能看到网口的IP地址已经变成前面设置的静态IP地址了

orangepi@orangepi:~$ ip addr show enP4p65s0 3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000 link/ether 5e:ac:14:a5:92:b3 brd ff:ff:ff:ff:ff:ff inet 192.168.1.100/24 brd 192.168.1.255 scope global noprefixroute enP4p65s0 valid_lft forever preferred_lft forever inet6 241e:3b8:3240:c3a0:e269:8305:dc08:135e/64 scope global dynamic noprefixroute valid_lft 259149sec preferred_lft 172749sec inet6 fe80::957d:bbbe:4928:3604/64 scope link noprefixroute valid_lft forever preferred_lft forever

然后就可以测试网络的连通性来检查IP地址是否配置OK了，ping命令可以通过Ctrl+C快捷键来中断运行

orangepi@orangepi:~$ ping 192.168.1.47 -I enP4p65s0 PING 192.168.1.47 (192.168.1.47) from 192.168.1.188 enP4p65s0: 56(84) bytes of data. 64 bytes from 192.168.1.47: icmp_seq=1 ttl=64 time=0.233 ms 64 bytes from 192.168.1.47: icmp_seq=2 ttl=64 time=0.263 ms ^C --- 192.168.1.47 ping statistics --- 5 packets transmitted, 5 received, 0% packet loss, time 4042ms rtt min/avg/max/mdev = 0.233/0.262/0.275/0.015 ms

使用nmcli命令来设置静态IP地址

如果要设置网口的静态IP地址，请先将网线插入开发板，如果需要设置WIFI的静态IP地址，请先连接好WIFI，然后再开始设置静态IP地址

然后通过nmcli con show命令可以查看网络设备的名字，如下所示，Wired connection 1和Wired connection 2为以太网接口的名字

orangepi@orangepi:~$ nmcli con show NAMEUUID TYPE DEVICE Wired connection 1c043c817-1156-3b72-a559-9a8cd642bf70ethernet enP3p49s0 Wired connection 26f74598a-ccc6-358b-be05-87eaf34df930ethernet enP4p65s0

然后输入下面的命令，其中
1. "Wired connection 1" 表示设置以太网口的静态IP地址，如果需要设置其它网口的静态IP地址，请修改为对应网络接口对应的名字（通过nmcli > con show命令可以获取到）
2. ipv4.addresses 后面是要设置的静态IP地址，可以修改为自己想要设置的值
3. ipv4.gateway 表示网关的地址
  
  orangepi@orangepi:~$ nmcli con mod "Wired connection 1" \
  
  ipv4.addresses "192.168.1.110" \
  
  ipv4.gateway "192.168.1.1" \
  
  ipv4.dns "8.8.8.8" \
  
  ipv4.method "manual"
然后重启linux系统

orangepi@orangepi:~$ sudo reboot

然后重新进入linux系统使用ip addr show命令就可以看到IP地址已经设置为想要的值了

orangepi@orangepi:~$ ip addr show 2: enP3p49s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000 link/ether 00:e0:4c:68:00:26 brd ff:ff:ff:ff:ff:ff inet 192.168.1.110/32 scope global noprefixroute enP3p49s0 valid_lft forever preferred_lft forever inet6 fe80::9005:95ac:b9c0:2beb/64 scope link noprefixroute valid_lft forever preferred_lft forever

M.2 E-Key PCIe WIFI6+蓝牙模块的使用方法

首先需要购买一个PCIe WIFI6+蓝牙模块

序号	型号	实物图片	已支持的OS
1	AX200 （PCIE+USB接口)		Debian Ubuntu OpenWRT OPi OS Arch
2	AX210 （PCIE+USB接口)		Debian Ubuntu OpenWRT OPi OS Arch
3	RTL8852BE （PCIE+USB接口)		Debian Ubuntu Android12 OPi OS Arch OPi OS Droid

然后将模块插入开发板的M.2 E-Key接口中并固定好，位置如下图所示：
然后使用lspci命令如果能看到WIFI模块的信息，说明模块接触良好
1. AX200显示如下所示
  
  orangepi@orangepi:~$ lspci | grep "Network"
  
  0002:21:00.0 Network controller: Intel Corporation Wi-Fi 6 AX200 (rev 1a)
2. AX210显示如下所示
  
  orangepi@orangepi:~$ lspci | grep "Network"
  
  0002:21:00.0 Network controller: Intel Corporation Wi-Fi 6 AX210/AX211/AX411 160MHz (rev 1a)
3. RTL8852显示如下所示
  
  orangepi@orangepi:~$ lspci | grep "Network"
  
  0002:21:00.0 Network controller: Intel Corporation Wi-Fi 6 AX200 (rev 1a)
然后使用下面的命令就能看到会多了一个WIFI的设备节点了

[orangepi@orangepi ~]$ ip a
WIFI的连接和测试方法请参看WIFI连接测试一节，这里不再赘述。
蓝牙的测试方法请参看蓝牙使用方法一节，这里不再赘述。

SSH远程登录开发板

Linux系统默认都开启了ssh远程登录，并且允许root用户登录系统。ssh登录前首先需要确保以太网或者wifi网络已连接，然后使用ip addr命令或者通过查看路由器的方式获取开发板的IP地址。

Ubuntu下SSH远程登录开发板

获取开发板的IP地址
然后就可以通过ssh命令远程登录linux系统

test@test:~$ ssh root@192.168.1.xxx (需要替换为开发板的IP地址) root@192.168.1.xx's password: （在这里输入密码，默认密码为orangepi）

注意，输入密码的时候，屏幕上是不会显示输入的密码的具体内容的，请不要以为是有什么故障，输入完后直接回车即可。如果提示拒绝连接，只要使用的是Orange Pi提供的镜像，就请不要怀疑orangepi这个密码是不是不对，而是要找其他原因。

成功登录系统后的显示如下图所示

如果ssh无法正常登陆linux系统，首先请检查下开发板的IP地址是否能ping通，如果ping通没问题的话，可以通过串口或者HDMI显示器登录linux系统然后在开发板上输入下面的命令后再尝试是否能连接： root@orangepi:~# reset_ssh.sh 如果还不行，请重烧系统试下。

Windows下SSH远程登录开发板

首先获取开发板的IP地址
在windows下可以使用MobaXterm远程登录开发板，首先新建一个ssh会话
1. 打开Session
2. 然后在Session Setting中选择SSH
3. 然后在Remote host中输入开发板的IP地址
4. 然后在Specify username中输入linux系统的用户名root或orangepi
5. 最后点击OK即可
然后会提示输入密码，默认root和orangepi用户的密码都为orangepi

注意，输入密码的时候，屏幕上是不会显示输入的密码的具体内容的，请不要以为是有什么故障，输入完后直接回车即可。

成功登录系统后的显示如下图所示

ADB的使用方法

网络adb的使用方法

系统启动后请先确认下adbd已经启动了

orangepi@orangepi:~$ ps -ax | grep "adbd"
808 ?Sl0:00 /usr/bin/adbd
3707 ttyFIQ0S+0:00 grep --color=auto adbd
然后查看下开发板的IP地址，并记下来
然后在Ubuntu PC上安装adb工具

test@test:~$ sudo apt-get update

test@test:~$ sudo apt-get install -y adb
然后使用下面的命令连接网络adb

test@test:~$ adb connect 192.168.1.xx:5555 #IP地址请替换为开发板的IP地址 daemon not running; starting now at tcp:5037 daemon started successfully connected to 192.168.1.xx:5555 test@test:~$ adb devices List of devices attached 192.168.1.xx:5555 device

然后使用下面的命令就可以登录开发板的linux系统

test@test:~$ adb shell root@orangepi5plus:/# <--- 看到这个提示符后说明已成功登录开发板

使用adb上传文件到开发板的命令如下所示

test@test:~$ adb push filename /root

filename: 1 file pushed. 3.7 MB/s (1075091 bytes in 0.277s)
使用adb重启开发板的命令如下所示

test@test:~$ adb reboot

如果您的Windows系统中没有adb工具，可以使用RKDevTool软件（使用RKDevTool烧录Linux镜像到TF卡中的方法一小节有用到这个软件）中的adb程序。在Windows中使用adb的示例如下所示：

使用type-c数据线连接adb

首先准备一根品质良好的Type-C数据线
然后通过Type-C数据线连接好开发板与Ubuntu PC，开发板Type-C接口的位置如下图所示：
然后运行下面的命令将Type-C接口设置为device模式

orangepi@orangepi:~$ sudo set_device.sh

如果linux系统中不存在set_device.sh脚本，请直接使用下面的命令：

orangepi@orangepi:~$ sudo bash -c "echo device > /sys/kernel/debug/usb/fc000000.usb/mode"

orangepi@orangepi:~$ sudo systemctl restart usbdevice
然后请确认下adbd已经启动了

orangepi@orangepi:~$ ps -ax | grep "adbd"
808 ?Sl0:00 /usr/bin/adbd
3707 ttyFIQ0S+0:00 grep --color=auto adbd
然后在Ubuntu PC上安装下adb工具

test@test:~$ sudo apt-get update

test@test:~$ sudo apt-get install -y adb
然后使用下面的命令查看下有没有识别到adb设备

test@test:~$ adb devices List of devices attached e0f9f71bc343c305 device

然后使用下面的命令就可以登录开发板的linux系统

test@test:~$ adb shell root@orangepi5plus:/# <--- 看到这个提示符后说明已成功登录开发板

使用adb上传文件到开发板的命令如下所示

test@test:~$ adb push filename /root filename: 1 file pushed. 3.7 MB/s (1075091 bytes in 0.277s)

如果您的Windows系统中没有adb工具，可以使用RKDevTool软件（使用RKDevTool烧录Linux镜像到TF卡中的方法一小节有用到这个软件）中的adb程序。在Windows中使用adb的示例如下所示：

上传文件到开发板Linux系统中的方法

在Ubuntu PC中上传文件到开发板Linux系统中的方法

使用scp命令上传文件的方法

使用scp命令可以在Ubuntu PC中上传文件到开发板的Linux系统中，具体命令如下所示
1. file_path：需要替换为要上传文件的路径
2. orangepi：为开发板linux系统的用户名，也可以替换成其它的，比如root
3. 192.168.xx.xx: 为开发板的IP地址，请根据实际情况进行修改
4. /home/orangepi: 开发板linux系统中的路径，也可以修改为其它的路径
  
  test@test:~$ scp file_path orangepi@192.168.xx.xx:/home/orangepi/
如果要上传文件夹，需要加上-r参数

test@test:~$ scp -r dir_path orangepi@192.168.xx.xx:/home/orangepi/
scp还有更多的用法，请使用下面的命令查看man手册

test@test:~$ man scp

使用filezilla上传文件的方法

首先在Ubuntu PC中安装filezilla

test@test:~$ sudo apt install -y filezilla
然后使用下面的命令打开filezilla

test@test:~$ filezilla
filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的
连接开发板的方法如下图所示

然后选择保存密码，再点击确定
然后选择总是信任该主机，再点击确定

连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了

然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Ubuntu PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了。

上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了
上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了

在Windows PC中上传文件到开发板Linux系统中的方法

使用filezilla上传文件的方法

首先下载filezilla软件Windows版本的安装文件，下载链接如下所示

https://filezilla-project.org/download.php?type=client

下载的安装包如下所示，然后双击直接安装即可

FileZilla_Server_1.5.1_win64-setup.exe

安装过程中，下面的安装界面请选择Decline，然后再选择Next>

filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的

连接开发板的方法如下图所示：

然后选择保存密码，再点击确定

然后选择总是信任该主机，再点击确定

连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了

然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Windows PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了

上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了
上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了

HDMI测试

HDMI输出测试

开发板有两个HDMI输出接口，所在位置如下图所示：
Linux系统默认配置HDMI_TX1支持8K显示，HDMI_TX2默认只支持4K显示(同一时间只能有1个HDMI_TX接口支持8K显示)。如果想设置HDMI_TX2支持8K显示，请按照如下步骤设置下：
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中hdmi2-8k配置
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效
然后使用HDMI转HDMI线连接Orange Pi开发板和HDMI显示器

注意，如果想接4K或者8K显示器，请确保HDMI线支持4K或者8K视频显示。
启动linux系统后如果HDMI显示器有图像输出说明HDMI接口使用正常

注意，很多笔记本电脑虽然带有HDMI接口，但是笔记本的HDMI接口一般只有输出功能，并没有HDMI in的功能，也就是说并不能将开发板的HDMI输出显示到笔记本的屏幕上。当想把开发板的HDMI接到笔记本电脑HDMI接口时，请先确认清楚您的笔记本是支持HDMI in的功能。当HDMI没有显示的时候，请先检查下HDMI线有没有插紧，确认接线没问题后，可以换一个不同的屏幕试下有没有显示。

HDMI IN的测试方法

开发板HDMI In接口的所在位置如下所示：
首先使用下图所示的HDMI转HDMI线将其它设备的HDMI输出接到开发板的HDMI In接口上
Linux系统HDMI In功能默认是关闭的，打开方法如下所示：
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中hdmirx配置
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效
重启进入系统后再在桌面上打开一个终端，然后运行下test_hdmiin.sh脚本

[orangepi@orangepi ~]$ test_hdmiin.sh
然后就能看到HDMI In的输入画面了（下图中HDMI In显示的是opi5开发板HDMI输出的画面，此时正在播放一个视频）。test_hdmiin.sh脚本默认会将HDMI In输入的音频播放到开发板的HDMI_TX1、HDMI_TX2和ES8388（代表喇叭或者耳机）中去。

HDMI转VGA显示测试

首先需要准备下面的配件
1. HDMI转VGA转换器
2. 一根VGA线
3. 一个支持VGA接口的显示器或者电视

HDMI转VGA显示测试如下所示：

使用HDMI转VGA显示时，开发板以及开发板的Linux系统是不需要做任何设置的，只需要开发板HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。

HDMI分辨率设置方法

首先在Settings中打开Display
然后就能看到系统当前的分辨率
点击Resolution（分辨率）的下拉框，就可以看到显示器当前支持的所有分辨率
然后选择想要设置的分辨率，再点击Apply
等新的分辨率设置完后再选择Keep the configuration即可

蓝牙使用方法

请注意，Orange Pi 5 Plus开发板上是没有蓝牙模块的，需要外接带蓝牙的PCIe网卡或者带蓝牙的USB网卡才能使用蓝牙功能。外接PCIe网卡的使用说明请参考PCIe WIFI6+蓝牙模块的使用方法一小节。外接USB网卡的使用说明请参考USB无线网卡测试一小节。

桌面版镜像的测试方法

点击桌面右上角的蓝牙图标
然后选择适配器
如果有提示下面的界面，请选择Yes
然后在蓝牙的适配器设置界面中设置Visibility Setting为Always visible，然后关闭即可
然后打开蓝牙设备的配置界面
点击Search即可开始扫描周围的蓝牙设备

然后选择想要连接的蓝牙设备，再点击鼠标右键就会弹出对此蓝牙设备的操作界面，选择Pair即可开始配对，这里演示的是和Android手机配对
配对时，桌面的右上角会弹出配对确认框，选择Confirm确认即可，此时手机上也同样需要进行确认
和手机配对完后，可以选择已配对的蓝牙设备，然后右键选择Send a File即可开始给手机发送一张图片
发送图片的界面如下所示

USB接口测试

USB接口是可以接USB hub来扩展USB接口的数量的。

连接USB鼠标或键盘测试

将USB接口的键盘插入Orange Pi开发板的USB接口中
连接Orange Pi开发板到HDMI显示器
如果鼠标或键盘能正常操作系统说明USB接口使用正常（鼠标只有在桌面版的系统中才能使用）

连接USB存储设备测试

首先将U盘或者USB移动硬盘插入Orange Pi开发板的USB接口中
执行下面的命令如果能看到sdX的输出说明U盘识别成功

orangepi@orangepi:~$ *cat /proc/partitions \| grep "sd" major minor #blocksname 8030044160 sda 8130043119 sda1**

使用mount命令可以将U盘挂载到/mnt中，然后就能查看U盘中的文件了

orangepi@orangepi:~$ sudo mount /dev/sda1 /mnt/ orangepi@orangepi:~$ ls /mnt/ test.txt

挂载完后通过df -h命令就能查看U盘的容量使用情况和挂载点

orangepi@orangepi:~$ df -h \| grep "sd" /dev/sda1 29G 208K 29G 1% /mnt

USB无线网卡测试

目前测试过的能用的USB无线网卡如下所示，其他型号的USB无线网卡请自行测试，如果无法使用就需要移植对应的USB无线网卡驱动

序号	型号	实物图片
1	RTL8723BU 支持2.4G WIFI+BT4.0
2	RTL8811 支持2.4G +5G WIFI
3	RTL8821CU 支持2.4G +5G WIFI 支持BT 4.2

RTL8723BU测试

首先将RTL8723BU无线网卡模块插入开发板的USB接口中
然后linux系统会自动加载RTL8723BU蓝牙和WIFI相关的内核模块，通过lsmod命令可以看到下面内核模块已自动加载

orangepi@orangepi:~$ lsmod

Module Size Used by
rfcomm 5734416
rtl8xxxu 1064960
rtk_btusb 614400

通过dmesg命令可以看到RTL8723BU模块的加载信息

orangepi@orangepi:~$ dmesg ...... [ 83.438901] usb 2-1: new high-speed USB device number 2 using ehci-platform [ 83.588375] usb 2-1: New USB device found, idVendor=0bda, idProduct=b720, bcdDevice= 2.00 [ 83.588403] usb 2-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3 [ 83.588422] usb 2-1: Product: 802.11n WLAN Adapter [ 83.588443] usb 2-1: Manufacturer: Realtek [ 83.588460] usb 2-1: SerialNumber: 00e04c000001 [ 83.601974] Bluetooth: hci0: RTL: examining hci_ver=06 hci_rev=000b lmp_ver=06 lmp_subver=8723 [ 83.603894] Bluetooth: hci0: RTL: rom_version status=0 version=1 [ 83.603920] Bluetooth: hci0: RTL: loading rtl_bt/rtl8723b_fw.bin [ 83.610108] Bluetooth: hci0: RTL: loading rtl_bt/rtl8723b_config.bin [ 83.611274] Bluetooth: hci0: RTL: cfg_sz 68, total sz 22564 [ 83.658494] rtk_btusb: Realtek Bluetooth USB driver ver 3.1.6d45ddf.20220519-142432 [ 83.658651] usbcore: registered new interface driver rtk_btusb [ 83.667124] usb 2-1: This Realtek USB WiFi dongle (0x0bda:0xb720) is untested! [ 83.667137] usb 2-1: Please report results to Jes.Sorensen@gmail.com [ 83.890140] usb 2-1: Vendor: Realtek [ 83.890153] usb 2-1: Product: 802.11n WLAN Adapter [ 83.890159] usb 2-1: rtl8723bu_parse_efuse: dumping efuse (0x200 bytes): ...... [ 83.890412] usb 2-1: RTL8723BU rev E (SMIC) 1T1R, TX queues 3, WiFi=1, BT=1, GPS=0, HI PA=0 [ 83.890417] usb 2-1: RTL8723BU MAC: 00:13:ef:f4:58:ae [ 83.890421] usb 2-1: rtl8xxxu: Loading firmware rtlwifi/rtl8723bu_nic.bin [ 83.895289] usb 2-1: Firmware revision 35.0 (signature 0x5301) [ 84.050893] Bluetooth: hci0: RTL: fw version 0x0e2f9f73 [ 84.266905] Bluetooth: RFCOMM TTY layer initialized [ 84.266949] Bluetooth: RFCOMM socket layer initialized [ 84.266999] Bluetooth: RFCOMM ver 1.11 [ 84.884270] usbcore: registered new interface driver rtl8xxxu [ 84.912046] rtl8xxxu 2-1:1.2 wlx0013eff458ae: renamed from wlan0

然后通过sudo ifconfig命令可以看到RTL8723BU WIFI的设备节点，WIFI的连接和测试方法请参看WIFI连接测试一节，这里不再赘述

orangepi@orangepi:~$ sudo ifconfig wlx0013eff458ae wlx0013eff458ae: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500 ether 00:13:ef:f4:58:ae txqueuelen 1000 (Ethernet) RX packets 0 bytes 0 (0.0 B) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 0 bytes 0 (0.0 B) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

然后通过hciconfig命令可以看到USB的蓝牙设备

orangepi@orangepi:~$ sudo apt update && sudo apt install bluez orangepi@orangepi:~$ hciconfig hci0: Type: Primary Bus: USB BD Address: 00:13:EF:F4:58:AE ACL MTU: 820:8 SCO MTU: 255:16 DOWN RX bytes:1252 acl:0 sco:0 events:125 errors:0 TX bytes:23307 acl:0 sco:0 commands:125 errors:0

在桌面中也可以看到出现了蓝牙图标，此时蓝牙还未打开，所以会显示一个红色的x
点击Turn Bluetooth On可以打开蓝牙
打开蓝牙后的显示如下所示
蓝牙的测试方法请参看蓝牙使用方法一节，这里不再赘述

RTL8811测试

首先将RTL8811无线网卡模块插入开发板的USB接口中
然后linux系统会自动加载RTL8811 WIFI相关的内核模块，通过lsmod命令可以看到下面内核模块已自动加载

orangepi@orangepi:~$ lsmod

Module Size Used by
8821cu 1839104 0

通过dmesg命令可以看到RTL8811模块的加载信息

orangepi@orangepi:~$ dmesg [ 118.618194] usb 2-1: new high-speed USB device number 2 using ehci-platform [ 118.767152] usb 2-1: New USB device found, idVendor=0bda, idProduct=c811, bcdDevice= 2.00 [ 118.767181] usb 2-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3 [ 118.767199] usb 2-1: Product: 802.11ac NIC [ 118.767219] usb 2-1: Manufacturer: Realtek [ 118.767235] usb 2-1: SerialNumber: 123456 [ 119.500530] usbcore: registered new interface driver rtl8821cu [ 119.525498] rtl8821cu 2-1:1.0 wlx1cbfced9d260: renamed from wlan0

然后通过sudo ifconfig命令可以看到WIFI的设备节点，WIFI的连接和测试方法请参看WIFI连接测试一节，这里不再赘述

orangepi@orangepi:~$ sudo ifconfig wlx1cbfced9d260 wlx1cbfced9d260: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500 ether 1c:bf:ce:d9:d2:60 txqueuelen 1000 (Ethernet) RX packets 0 bytes 0 (0.0 B) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 0 bytes 0 (0.0 B) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

USB摄像头测试

首先需要准备一个下图所示的或者类似的支持UVC协议的USB摄像头，然后将USB摄像头插入到Orange Pi开发板的USB接口中
通过v4l2-ctl命令可以看到USB摄像头的设备节点信息为/dev/video0

orangepi@orangepi:~$ v4l2-ctl --list-devices

Q8 HD Webcam: Q8 HD Webcam (usb-fc880000.usb-1):

/dev/video0

/dev/video1

/dev/media0

注意v4l2中的l是小写字母l，不是数字1。

另外video的序号不一定都是video0，请以实际看到的为准。
在桌面系统中可以使用Cheese直接打开USB摄像头，Cheese打开方法如下图所示：

Cheese打开USB摄像头后的界面如下图所示：
使用fswebcam测试USB摄像头的方法
1. 安装fswebcam
  
  orangepi@orangepi:~$ sudo apt update
  
  orangepi@orangepi:~$ sudo apt-get install -y fswebcam
2. 安装完fswebcam后可以使用下面的命令来拍照
  1. -d 选项用于指定USB摄像头的设备节点
  2. --no-banner用于去除照片的水印
  3. -r 选项用于指定照片的分辨率
  4. -S 选项用设置于跳过前面的帧数
  5. ./image.jpg 用于设置生成的照片的名字和路径
    
    orangepi@orangepi:~$ sudo fswebcam -d /dev/video0 \
    
    --no-banner -r 1280x720 -S 5 ./image.jpg
3. 在服务器版的linux系统中，拍完照后可以使用scp命令将拍好的图片传到Ubuntu PC上镜像观看
  
  orangepi@orangepi:~$ scp image.jpg test@192.168.1.55:/home/test （根据实际情况修改IP地址和路径）
4. 在桌面版的linux系统中，可以通过HDMI显示器直接查看拍摄的图片

音频测试

在桌面系统中测试音频方法

首先打开文件管理器
然后找到下面这个文件（如果系统中没有这个音频文件，可以自己上传一个音频文件到系统中）
然后选中audio.wav文件，右键选择使用vlc打开就可以开始播放
切换HDMI播放和耳机播放等不同音频设备的方法
1. 首先打开音量控制界面
2. 播放音频的时候，在Playback中会显示播放软件可以使用的音频设备选项，如下图所示，在这里可以设置需要播放到哪个音频设备

使用命令播放音频的方法

耳机接口播放音频测试

首先将耳机插入开发板的耳机孔中

然后可以通过aplay -l命令可以查看下linux系统支持的声卡设备，从下面的输出可知，card 3为es8388的声卡设备，也就是耳机的声卡设备

orangepi@orangepi:~$ aplay -l ** List of PLAYBACK Hardware Devices card 0: rockchipdp0 [rockchip,dp0], device 0: rockchip,dp0 spdif-hifi-0 [rockchip,dp0 spdif-hifi-0] Subdevices: 0/1 Subdevice #0: subdevice #0 card 1: rockchiphdmi0 [rockchip-hdmi0], device 0: rockchip-hdmi0 i2s-hifi-0 [rockchip-hdmi0 i2s-hifi-0] Subdevices: 0/1 Subdevice #0: subdevice #0 card 2: rockchiphdmi1 [rockchip-hdmi1], device 0: rockchip-hdmi1 i2s-hifi-0 [rockchip-hdmi1 i2s-hifi-0] Subdevices: 1/1 Subdevice #0: subdevice #0 card 3: rockchipes8388 [rockchip,es8388], device 0: dailink-multicodecs ES8323.7-0011-0 [dailink-multicodecs ES8323.7-0011-0] Subdevices: 0/1 Subdevice #0: subdevice #0**

然后使用aplay命令播放下系统自带的音频文件，如果耳机能听到声音说明硬件能正常使用

orangepi@orangepi:~$ aplay -D hw:3,0 /usr/share/sounds/alsa/audio.wav

Playing WAVE 'audio.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo

喇叭接口播放音频测试

首先需要准备一个下图所示的喇叭，开发板上喇叭座子的规格为2pin 1.25mm间距
开发板上喇叭接口的位置如下所示，准备好喇叭后，请将其插入到开发板的喇叭接口中
喇叭和耳机使用的同一个声卡，使用喇叭前，请确保耳机接口没有插入耳机（如果插入了耳机，音频会播放到耳机）。然后使用aplay命令播放下系统自带的音频文件，如果喇叭能听到声音说明硬件能正常使用

orangepi@orangepi:~$ aplay -D hw:3,0 /usr/share/sounds/alsa/audio.wav

Playing WAVE 'audio.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo

HDMI音频播放测试

首先使用HDMI 转HDMI线将Orange Pi开发板连接到电视机上（其他的HDMI显示器需要确保可以播放音频）

然后查看下HDMI的声卡序号，从下面的输出可以知道HDMI_TX1的声卡为card 1，HDMI_TX2的声卡为card 2

orangepi@orangepi:~$ aplay -l ** List of PLAYBACK Hardware Devices card 0: rockchipdp0 [rockchip,dp0], device 0: rockchip,dp0 spdif-hifi-0 [rockchip,dp0 spdif-hifi-0] Subdevices: 1/1 Subdevice #0: subdevice #0 card 1: rockchiphdmi0 [rockchip-hdmi0], device 0: rockchip-hdmi0 i2s-hifi-0 [rockchip-hdmi0 i2s-hifi-0] Subdevices: 1/1 Subdevice #0: subdevice #0 card 2: rockchiphdmi1 [rockchip-hdmi1], device 0: rockchip-hdmi1 i2s-hifi-0 [rockchip-hdmi1 i2s-hifi-0] Subdevices: 1/1 Subdevice #0: subdevice #0**

然后使用aplay命令播放下系统自带的音频文件，如果HDMI显示器或者电视能听到声音说明硬件能正常使用
1. 播放音频到HDMI_TX1的命令如下所示：
  
  orangepi@orangepi:~$ aplay -D hw:1,0 /usr/share/sounds/alsa/audio.wav
2. 播放音频到HDMI_TX2的命令如下所示：
  
  orangepi@orangepi:~$ aplay -D hw:2,0 /usr/share/sounds/alsa/audio.wav

使用命令测试录音的方法

开发板上有板载MIC，位置如下所示：

运行test_record.sh main命令会通过板载MIC录制一段音频，然后播放到HDMI_TX1和耳机。

orangepi@orangepi:~$ test_record.sh main Start recording: /tmp/test.wav Recording WAVE '/tmp/test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo Start playing Playing WAVE '/tmp/test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo Playing WAVE '/tmp/test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo

除了板载MIC，我们还可以通过带MIC功能的耳机来录制音频。将带MIC功能的耳机插入开发板后，运行test_record.sh headset命令会通过耳机录制一段音频，然后播放到HDMI_TX1和耳机。

orangepi@orangepi:~$ test_record.sh headset Start recording: /tmp/test.wav Recording WAVE '/tmp/test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo Start playing Playing WAVE '/tmp/test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo Playing WAVE '/tmp/test.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo

温度传感器

查看系统温度传感器的命令为：

orangepi@orangepi:~$ sensors gpu_thermal-virtual-0 Adapter: Virtual device temp1: +47.2°C littlecore_thermal-virtual-0 Adapter: Virtual device temp1: +47.2°C bigcore0_thermal-virtual-0 Adapter: Virtual device temp1: +47.2°C tcpm_source_psy_6_0022-i2c-6-22 Adapter: rk3x-i2c in0: 0.00 V (min = +0.00 V, max = +0.00 V) curr1: 0.00 A (max = +0.00 A) npu_thermal-virtual-0 Adapter: Virtual device temp1: +47.2°C center_thermal-virtual-0 Adapter: Virtual device temp1: +47.2°C bigcore1_thermal-virtual-0 Adapter: Virtual device temp1: +47.2°C soc_thermal-virtual-0 Adapter: Virtual device temp1: +47.2°C (crit = +115.0°C)

40 Pin扩展接口引脚使用说明

Orange Pi 5 Plus开发板40 pin扩展接口引脚的顺序请参考下图：
Orange Pi 5 Plus开发板40 pin接口引脚的功能如下表所示
1. 下面是40 pin完整的引脚图
  
  下面这张是彩图，包含上面表格中的部分内容：
2. 下面的表格是上面完整表格左半边部分的图，能看得清楚点
3. 下面的表格是上面完整表格右半边部分的图，能看得清楚点
  
  上面表格中pwm都标出了对应的寄存器的基地址，在查看/sys/class/pwm/中哪个pwmchip对应40 pin排针中哪个pwm引脚时很有用。
40 pin接口中总共有28个GPIO口，所有GPIO口的电压都是3.3v。

安装wiringOP的方法

注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。编译好的wiringOP的deb包在orangepi-build中的存放路径为： orangepi-build/external/cache/debs/arm64/wiringpi_x.xx.deb 进入系统后可以运行下gpio readall命令，如果能看到下面的输出，说明wiringOP已经预装并且能正常使用。

wiringOP目前主要适配了设置GPIO口输入输出，设置GPIO口输出高低电平以及设置上下拉电阻的功能，像硬件PWM这样的功能是用不了的。

下载wiringOP的代码

orangepi@orangepi:~$ sudo apt update orangepi@orangepi:~$ sudo apt install -y git orangepi@orangepi:~$ git clone https://github.com/orangepi-xunlong/wiringOP.git -b next

注意，Orange Pi 5 Plus需要下载wiringOP next分支的代码，请别漏了-b next这个参数。如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/usr/src/wiringOP

编译安装wiringOP

orangepi@orangepi:~$ cd wiringOP

orangepi@orangepi:~/wiringOP$ sudo ./build clean

orangepi@orangepi:~/wiringOP$ sudo ./build
测试gpio readall命令的输出如下

40 pin接口GPIO、I2C、UART、SPI、CAN和PWM测试

40 pin GPIO口测试

Orange Pi发布的linux系统中有预装一个blink_all_gpio程序，这个程序会设置40 pin中的所有28个GPIO口不停的切换高低电平。运行blink_all_gpio程序后，当用万用表去测量GPIO口的电平时，会发现GPIO引脚会在0和3.3v之间不停的切换。使用这个程序我们可以来测试GPIO口是否能正常工作。运行blink_all_gpio程序的方式如下所示： orangepi@orangepi5plus:~$ sudo blink_all_gpio #记得加sudo权限 [sudo] password for orangepi: #在这里需要输入密码

开发板40 pin中总共有28个GPIO口可以使用，下面以7号引脚——对应GPIO为GPIO1_D6 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平
首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号

root@orangepi:~/wiringOP# gpio mode 2 out
然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功

root@orangepi:~/wiringOP# gpio write 2 0

使用gpio readall可以看到7号引脚的值(V)变为了0
然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功

root@orangepi:~/wiringOP# gpio write 2 1

使用gpio readall可以看到7号引脚的值(V)变为了1
其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可

40 pin GPIO口上下拉电阻的设置方法

下面以7号引脚——对应GPIO为GPIO1_D6 ——对应wPi序号为2——为例演示如何设置GPIO口的上下拉电阻
首先需要设置GPIO口为输入模式，其中第三个参数需要输入引脚对应的wPi的序号

root@orangepi:~/wiringOP# gpio mode 2 in
设置为输入模式后，执行下面的命令可以设置GPIO口为上拉模式

root@orangepi:~/wiringOP# gpio mode 2 up
然后输入下面的命令读取GPIO口的电平，如果电平为1，说明上拉模式设置成功

root@orangepi:~/wiringOP# gpio read 2

1
然后执行下面的命令可以设置GPIO口为下拉模式

root@orangepi:~/wiringOP# gpio mode 2 down
然后输入下面的命令读取GPIO口的电平，如果电平为0，说明下拉模式设置成功

root@orangepi:~/wiringOP# gpio read 2

0

40 pin SPI测试

由下图可知，Orange Pi 5 Plus可用的SPI为SPI0和SPI4
SPI0和SPI4在40pin中对应的引脚如下表所示。SPI4_M1和SPI4_M2同一时间只能使用其中一组，不能同时使用，它们都是同一个SPI4，只是接到不同的引脚上去了而已，请不要以为它们是两组不同的SPI总线。

	S PI0_M2对应40pin	S PI4_M1对应40pin	SP I4_M2对应40pin
MOSI	19号引脚	12号引脚	8号引脚
MISO	21号引脚	31号引脚	10号引脚
CLK	23号引脚	35号引脚	22号引脚
CS0	24号引脚	40号引脚	31号引脚
CS1	26号引脚	38号引脚	无
dtb o配置	spi 0-m2-cs0-spidev spi 0-m2-cs1-spidev spi0-m2 -cs0-cs1-spidev	spi 4-m1-cs0-spidev spi 4-m1-cs1-spidev spi4-m1 -cs0-cs1-spidev	spi4 -m2-cs0-spidev

在linux系统中，40 pin中的SPI默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的SPI的配置
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效
重启后进入系统先查看下linux系统中是否存在spidevx.x的设备节点，如果存在，说明SPI已经设置好了，可以直接使用。

orangepi@orangepi:~$ ls /dev/spidev*

/dev/spidev0.0 /dev/spidev0.1 /dev/spidev4.0 /dev/spidev4.1

上面是打开spi0-m2-cs0-cs1-spidev和spi4-m1-cs0-cs1-spidev后显示的结果。

然后先不短接SPI0或者SPI4的MOSI和MISO两个引脚，运行spidev_test的输出结果如下所示，可以看到TX和RX的数据不一致

orangepi@orangepi:~$ sudo spidev_test -v -D /dev/spidev4.0 或者 orangepi@orangepi:~$ sudo spidev_test -v -D /dev/spidev0.0 spi mode: 0x0 bits per word: 8 max speed: 500000 Hz (500 KHz) TX \| FF FF FF FF FF FF 40 00 00 00 00 95 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D \| ......@.…▒..................▒. RX \| FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF \| ............................….

然后短接SPI0或者SPI4的MOSI和MISO两个引脚再运行spidev_test的输出如下，可以看到发送和接收的数据一样，说明SPI回环测试正常。

orangepi@orangepi:~$ sudo spidev_test -v -D /dev/spidev4.0 或者 orangepi@orangepi:~$ sudo spidev_test -v -D /dev/spidev0.0 spi mode: 0x0 bits per word: 8 max speed: 500000 Hz (500 KHz) TX \| FF FF FF FF FF FF 40 00 00 00 00 95 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D \| ......@.…▒..................▒. RX \| FF FF FF FF FF FF 40 00 00 00 00 95 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D \| ......@.…▒..................▒.

40 pin I2C测试

由下表可知，Orange Pi 5 Plus可用的i2c为i2c2、i2c4、i2c5和i2c8共四组 i2c总线。
4组I2C总线在40pin中对应的引脚如下表所示。I2C2_M0和I2C2_M4同一时间只能使用其中一组，不能同时使用，它们都是同一个I2C2，只是接到不同的引脚上去了而已，请不要以为它们是两组不同的I2C2总线。

I2C总线	SDA对应40pin	SCL对应40pin	dtbo对应配置
I2C2_M0	3号引脚	5号引脚	i2c2-m0
I2C2_M4	10号引脚	8号引脚	i2c2-m4
I2C4_M3	22号引脚	32号引脚	i2c4-m3
I2C5_M3	27号引脚	28号引脚	i2c5-m3
I2C8_M2	29号引脚	7号引脚	i2c8-m2

在linux系统中，40 pin中的I2C总线默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的I2C的配置
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效
启动linux系统后，先确认下/dev下存在需要使用I2C的设备节点

orangepi@orangepi:~$ ls /dev/i2c-*
然后在40 pin接口对应的I2C引脚上接一个I2C设备

然后使用i2cdetect -y命令如果能检测到连接的i2c设备的地址，就说明i2c能正常使用

orangepi@orangepi:~$ sudo i2cdetect -y 2 #i2c2的命令 orangepi@orangepi:~$ sudo i2cdetect -y 4 #i2c4的命令 orangepi@orangepi:~$ sudo i2cdetect -y 5 #i2c5的命令 orangepi@orangepi:~$ sudo i2cdetect -y 8 #i2c8的命令

40 pin的UART测试

由下表可知，Orange Pi 5 Plus可用的uart为uart1、uart3、uart4、uart6、uart7和uart8共6组uart总线
6组UART总线在40pin中对应的引脚如下表所示：

UART总线	RX对应40pin	TX对应40pin	dtbo对应配置
UART1_M1	27号引脚	28号引脚	uart1-m1
UART3_M1	18号引脚	16号引脚	uart3-m1
UART4_M2	19号引脚	23号引脚	uart4-m2
UART6_M1	10号引脚	8号引脚	uart6-m1
UART7_M2	24号引脚	26号引脚	uart7-m2
UART8_M1	40号引脚	35号引脚	uart8-m1

在linux系统中，40 pin中的UART默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的UART的配置
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效
进入linux系统后，先确认下/dev下是否存在对应uart的设备节点

orangepi@orangepi:~$ ls /dev/ttyS*
然后开始测试uart接口，先使用杜邦线短接要测试的uart接口的rx和tx引脚
使用gpio serial命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常（ttySX需要替换为对应uart的节点名，请不要照抄）

orangepi@orangepi:~$ sudo gpio serial /dev/ttySX

[sudo] password for orangepi: #在这里输入密码

Out: 0: -> 0

Out: 1: -> 1

Out: 2: -> 2

Out: 3: -> 3

Out: 4: -> 4

Out: 5: -> 5^C

PWM的测试方法

由下表可知，Orange Pi 5 Plus可用的PWM有pwm0、pwm1、pwm11、pwm12、pwm13和pwm14共六路pwm
PWM在40pin中对应的引脚如下表所示。PWM0_M0和PWM0_M2、PWM1_M0和PWM1_M2、PWM14_M0和PWM14_M2同一时间只能使用其中一个，不能同时使用，它们都是同一个PWM，只是接到不同的引脚上去了而已，请不要以为它们是两个不同的PWM总线。

PWM总线	对应40pin	dtbo对应配置
PWM0_M0	5号引脚	pwm0-m0
PWM0_M2	22号引脚	pwm0-m2
PWM1_M0	3号引脚	pwm1-m0
PWM1_M2	32号引脚	pwm1-m2
PWM11_M0	12号引脚	pwm11-m0
PWM12_M0	14号引脚	pwm12-m0
PWM13_M0	16号引脚	pwm13-m0
PWM14_M0	33号引脚	pwm14-m0
PWM14_M2	7号引脚	pwm14-m0

在linux系统中，40 pin中的PWM默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的PWM的配置
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效
当打开一个pwm后，在/sys/class/pwm/中就会多出一个pwmchipX（X为具体的的数字），比如打开pwm14后，查看/sys/class/pwm/下的pwmchipX会由两个变成了三个

orangepi@orangepi:~$ ls /sys/class/pwm/

pwmchip0 pwmchip1 pwmchip2
上面哪个pwmchip对应pwm14呢，我们先查看下 ls /sys/class/pwm/ -l命令的输出，如下所示：
然后由下表可知，pwm14寄存器的基地址为febf0020，再看 ls /sys/class/pwm/ -l命令的输出，可以看到pwmchip2中链接到了febf0020.pwm，所以pwm14对应pwmchip为pwmchip2
然后使用下面的命令可以让pwm14输出一个50Hz的方波（请先切换到root用户，再执行下面的命令）

root@orangepi:~# echo 0 > /sys/class/pwm/pwmchip2/export root@orangepi:~# echo 20000000 > /sys/class/pwm/pwmchip2/pwm0/period root@orangepi:~# echo 1000000 > /sys/class/pwm/pwmchip2/pwm0/duty_cycle root@orangepi:~# echo 1 > /sys/class/pwm/pwmchip2/pwm0/enable

上面演示的pwm14的测试方法，其他pwm测试方法都是类似的。

CAN的测试方法

打开CAN的方法

由下表可知，Orange Pi 5 Plus可用的CAN总线为CAN0和CAN1共两组CAN总线
在linux系统中，40 pin中的CAN默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：
1. 首先运行下orangepi-config，普通用户记得加sudo权限
  
  orangepi@orangepi:~$ sudo orangepi-config
2. 然后选择System
3. 然后选择Hardware
4. 然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的CAN的配置（OPi > 5 Plus可选can0-m0和cam1-m0）
5. 然后选择<Save>保存
6. 然后选择<Back>
7. 然后选择<Reboot>重启系统使配置生效

进入linux系统后，使用sudo ifconfig -a命令如果能看到CAN的设备节点，就说明CAN已正确打开了

orangepi@orangepi:~$ sudo ifconfig -a can0: flags=128<NOARP> mtu 16 unspec 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 txqueuelen 10 (UNSPEC) RX packets 0 bytes 0 (0.0 B) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 0 bytes 0 (0.0 B) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 device interrupt 94 can1: flags=128<NOARP> mtu 16 unspec 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 txqueuelen 10 (UNSPEC) RX packets 0 bytes 0 (0.0 B) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 0 bytes 0 (0.0 B) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 device interrupt 95

CAN0和CAN1对应的引脚为

	CAN0	CAN1
TX引脚	对应40pin的5号引脚	对应40pin的18号引脚
RX引脚	对应40pin的3号引脚	对应40pin的16号引脚

使用CANalyst-II分析仪测试收发消息

测试使用的CANalyst-II分析仪如下图所示
CANalyst-II分析仪资料下载链接

https://www.zhcxgd.com/3.html
首先要安装USBCANToolSetup这个软件
USBCANToolSetup安装后的快捷方式为
另外还需要安装一下USB驱动程序
CANalyst-II分析仪的USB接口那端需要接到电脑的USB接口中
测试CAN功能还需要准备一个下图所示的CAN收发器，CAN收发器主要功能是将CAN控制器的TTL信号转换成CAN总线的差分信号
1. CAN收发器的3.3V引脚需要接开发板40 pin中的3.3V引脚
2. CAN收发器的GND引脚需要接开发板40 pin中的GND引脚
3. CAN收发器的CAN TX引脚需要接开发板40 pin中CAN总线的TX引脚
4. CAN收发器的CAN RX引脚需要接开发板40 pin中CAN总线的RX引脚
5. CAN收发器的CANL引脚需要接分析仪的H接口
6. CAN收发器的CANL引脚需要接分析仪的L接口
然后可以打开USB-CAN软件
然后点击启动设备
然后点击确定
再设置波特率为1000k bps
成功打开后USB-CAN软件会显示序列号等信息
开发板接收CAN消息测试
1. 首先在开发板的Linux系统中设置下CAN总线的波特率为1000kbps
  
  orangepi@orangepi:~$ sudo ip link set can0 down
  
  orangepi@orangepi:~$ sudo ip link set can0 type can bitrate 1000000
  
  orangepi@orangepi:~$ sudo ip link set can0 up
2. 然后运行candump can0命令准备接收消息
  
  orangepi@orangepi:~$ sudo candump can0
3. 然后在USB-CAN软件中发送一个消息给开发板
4. 如果开发板中可以接收到分析仪发送的消息说明CAN总线能正常使用
  
  orangepi@orangepi5plus:~$ sudo candump can0
  
  can0 001 [8] 01 02 03 04 05 06 07 08
开发板发送CAN消息测试
1. 首先在Linux系统中设置下CAN的波特率为1000kbps
  
  orangepi@orangepi:~$ sudo ip link set can0 down
  
  orangepi@orangepi:~$ sudo ip link set can0 type can bitrate 1000000
  
  orangepi@orangepi:~$ sudo ip link set can0 up
2. 再开发板中执行cansend命令，发送一个消息
  
  orangepi@orangepi:~$ sudo cansend can0 123#1122334455667788
3. 如果USB-CAN软件可以接收到开发板发过来的消息说明通信成功

wiringOP-Python的安装使用方法

wiringOP-Python是wiringOP的Python语言版本的库，用于在Python程序中操作开发板的GPIO、I2C、SPI和UART等硬件资源。另外请注意下面所有的命令都是在root用户下操作的。

wiringOP-Python的安装方法

首先安装依赖包

root@orangepi:~# sudo apt-get update

root@orangepi:~# sudo apt-get -y install git swig python3-dev python3-setuptools
然后使用下面的命令下载wiringOP-Python的源码

注意，下面的git clone--recursive命令会自动下载wiringOP的源码，因为wiringOP-Python是依赖wiringOP的。请确保下载过程没有因为网络问题而报错。如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP-Python源码，存放位置为：/usr/src/wiringOP-Python。

root@orangepi:~# git clone --recursive https://github.com/orangepi-xunlong/wiringOP-Python -b next root@orangepi:~# cd wiringOP-Python root@orangepi:~/wiringOP-Python# git submodule update --init --remote

然后使用下面的命令编译wiringOP-Python并将其安装到开发板的Linux系统中

root@orangepi:~# cd wiringOP-Python
root@orangepi:~/wiringOP-Python# python3 generate-bindings.py > bindings.i
root@orangepi:~/wiringOP-Python# sudo python3 setup.py install
然后输入下面的命令，如果有帮助信息输出，说明wiringOP-Python安装成功，按下q键可以退出帮助信息的界面

root@orangepi:~/wiringOP-Python# python3 -c "import wiringpi; help(wiringpi)" Help on module wiringpi: NAME wiringpi DESCRIPTION # This file was automatically generated by SWIG (http://www.swig.org). # Version 4.0.2 # # Do not make changes to this file unless you know what you are doing--modify # the SWIG interface file instead.

在python命令行下测试wiringOP-Python是否安装成功的步骤如下所示：

首先使用python3命令进入python3的命令行模式

root@orangepi:~# python3

然后导入wiringpi的python模块

>>> import wiringpi;

最后输入下面的命令可以查看下wiringOP-Python的帮助信息，按下q键可以退出帮助信息的界面

>>> help(wiringpi) Help on module wiringpi: NAME wiringpi DESCRIPTION # This file was automatically generated by SWIG (http://www.swig.org). # Version 4.0.2 # # Do not make changes to this file unless you know what you are doing--modify # the SWIG interface file instead. CLASSES builtins.object GPIO I2C Serial nes class GPIO(builtins.object) \| GPIO(pinmode=0) \| >>>