更改

←上一编辑

Orange Pi 3B

添加2,878字节, 2023年8月23日 (三) 20:09

→‎Orange Pi 3B的接口详情图

== 什么是 Orange Pi 3B ==

Orange Pi 3B采用了瑞芯微RK3566四核64位Cortex-A55处理器，采用的22nm工艺，主频最高可达1.8GHz，集成ARM Mali-G52 ~~GPU，内嵌高性能2D图像加速模块，内置1 Tops算力的AI加速器NPU，可选2GB、4GB或者8GB内存，具有高达4K显示处理能力。~~GPU，内嵌高性能2D图像加速模块，内置0.8Tops算力的AI加速器NPU，可选2GB、4GB或者8GB内存，具有高达4K显示处理能力。

Orange Pi 3B引出了相当丰富的接口，包括HDMI输出、M.2 PCIe2.0x1、千兆网口、USB2.0、USB3.0接口和40pin扩展排针等。可广泛适用于高端平板、边缘计算、人工智能、云计算、AR/VR、智能安防、智能家居等领域，覆盖 AIoT各个行业。

Orange Pi ~~3B支持Android 11、Debian11、Ubuntu20~~3B支持Android11、Ubuntu22.~~04和Ubuntu22~~04、Ubuntu20.~~04等操作系统。~~04、Debian11、Debian12、开源鸿蒙4.0 Beta1、Orange Pi OS（Arch）、基于开源鸿蒙的Orange Pi OS（OH）等操作系统。

== Orange Pi 3B的用途 ==

== Orange Pi ~~3B的硬件特性~~ 3B的硬件规格 ==

{| class="wikitable" style="width:800px;text-align: center;"

|-

|colspan=2|

<div style="text-align:center"><big>'''~~硬件特性介绍~~硬件规格参数'''</big></div>|-| 主控芯片| Rockchip RK3566

|-

| style="width: 200px" | CPU

|

~~• Rockchip RK3566 (22nm 制程）~~ ~~• 4核64位处理器~~ ~~• 主频最高1~~四核 64 位 Cortex-A55 处理器，22nm 先进工艺，主频最高 1.8GHz

|-

| GPU

|

• ~~集成ARM~~ ARM Mali-G522EE图形处理器 • 支持OpenGL ES 1.1/2.0/3.2，OpenCL 2.0，Vulkan 1.1

• ~~OpenGL ES1.1/2.0/3.2、OpenCL 2.0 和 Vulkan 1.1~~内嵌高性能2D加速硬件

|-

| NPU

|

• ~~内置1Tops算力的AI加速器NPU~~集成 RKNN NPU AI 加速器，0.8Tops@INT8 性能 • 支持 C affe/TensorFlow/TFLite/ONNX/PyTorch/Keras/Darknet 架构模型一键转换

|-

| ~~视频输出~~VPU

|

• ~~HDMI 2~~4K@60fps H.~~0，最大支持4K @60Hz~~265/H.264/VP9 视频解码

• ~~1* MIPI DSI TX 2Lane~~1080P@100fps H.265 视频编码

• ~~1*eDP1~~1080P@60fpsH.~~3，最高支持2560x1600@60fps输出~~264 视频编码

|-

| 内存PMU

|

~~2GB/4GB/8GB可选~~Rockchip RK809-5

|-

| ~~摄像头~~内存

|

~~• 1* MIPI CSI 2Lane（spilt mode）~~2GB/4GB/8GB （LPDDR4/4x）

|-

| ~~PMU~~存储

|

~~RK809-5~~|-~~| 板载存储~~• 支持eMMC模块:16GB/32GB/64GB/128GB| • SPI Flash: 16MB ~~Nor FLASH~~/32MB

• ~~MicroSD (TF) Card插槽~~M.2 M-KEY插槽：SATA3 或者 PCIe2.0 NVME SSD

• ~~PCIe2.0x1 M.2 M-KEY (SSD) 插槽~~TF卡槽

|-

| ~~以太网~~Wi-Fi+蓝牙

|

~~10/100/1000Mbps以太网 (YT8531C )~~Wi-Fi 5+BT 5.0，BLE（20U5622）

|-

| 音频以太网收发器| 10/100/1000Mbps以太网（板载PHY芯片：YT8531C）|-| 显示

|

• 31x HDMI TX 2.~~5mm 耳机孔音频输入/输出~~0，最大支持4K@60FPS

• ~~HDMI输出~~1xMIPI DSI 2 Lane • eDP1.3

|-

| ~~PCIe M.2 M-KEY~~摄像头

|

~~• 支持SSD~~1xMIPI CSI 2 Lane摄像头接口

|-

| ~~USB接口~~USB

|

~~1 * USB3~~• 1xUSB 2.~~0接口~~0 支持Device或HOST模式

• 1xUSB 3 * USB2.~~0接口~~0 HOST

• 2xUSB 2.0 HOST

|-

| 音频

|

3.5mm耳机孔音频输入/输出

|-

| ~~40pin扩展排针~~按键

|

~~用于扩展UART、PWM、I2C、SPI和GPIO接口~~1x MaskROM键，1xRESET键，1 xPOWER键

|-

| ~~调试串口~~FAN

|

~~3pin调试串口~~2Pin 1.25mm规格的5V风扇接口

|-

| ~~LED灯~~RTC

|

~~电源指示灯、状态指示灯、PCIe指示灯~~2Pin 1.25mm规格的备用电池接口

|-

| 按键40Pin

|

~~1 * MaskROM键，1 * RECOVERY，1 * 电源按键~~40Pin功能扩展接口，支持以下接口类型: GPIO、UART、I2C、SPI、PWM

|-

| 供电电源

|

Type-~~C接口供电 5V/3A或者5V4A；~~C 5V3A

|-

| 支持的操作系统

|

~~Android 11、Debian11、Ubuntu20~~Android11、Ubuntu22 .~~04和Ubuntu22~~04、Ubuntu20.~~04等操作系统~~04、Debian11、Debian12、开源鸿蒙4.0 Beta1、Orange Pi OS（Arch）、基于开源鸿蒙的Orange Pi OS（OH）等操作系统。

|-

|colspan=2|<div style="text-align:center"><big>'''外观规格介绍'''</big></div>

|-

| ~~产品尺寸~~PCB尺寸|85mm*x 56mm*x 17mm

|-

| 重量

[[File:~~media/image3~~pi3b-img3-1.~~jpeg~~png|~~447x348px|_MG_1982(1)~~800px]]

</div>

[[File:~~media/image4~~pi3b-img4-1.~~jpeg~~png|~~438x331px|_MG_1986(1)~~800px]]

</div>

[[File:~~media/image5~~pi3b-img5.~~jpeg~~png|~~576x752px|06e73d88e8e969cc17f52f732f5f82b2~~800px]]

</div>

[[File:~~media/image6~~pi3b-img6-1.png|~~575x277px~~800px]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''~~四个定位孔的直径都是3~~四个定位孔的直径都是2.~~0mm，M~~7mm，M.2 ~~PICE设备固定孔直径为3~~PICE设备固定孔直径为2.~~5mm。~~9mm。'''</big>

|}

<li>TF卡，最小16GB容量（推荐32GB或以上）的'''class10'''级或以上的高速闪迪卡

[[File:~~media/image7~~pi3b-img7.png~~|124x96px~~]]</li>

<li>TF卡读卡器，用于将镜像烧录到TF卡中

[[File:~~media/image8~~pi3b-img8.png~~|139x106px~~]]</li>

<li>HDMI接口的显示器

[[File:~~media/image9~~pi3b-img9.png~~|256x195px~~]]</li>

<li>HDMI转HDMI连接线，用于将开发板连接到HDMI显示器或者电视进行显示

[[File:~~media/image10~~pi3b-img10.png~~|199x129px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

</li>

<li>电源适配器，Orange Pi 3B建议使用5V/3A或者5V/4A的Type-C电源供电

[[File:~~media/image11~~pi3b-img11.png~~|188x133px~~]]</li>

<li>USB接口的鼠标和键盘，只要是标准USB接口的鼠标和键盘都可以，鼠标和键盘可以用来控制Orange Pi开发板

[[File:~~media/image12~~pi3b-img12.png~~|206x170px~~]]</li>

<li>USB摄像头

[[File:~~media/image13~~pi3b-img13.png~~|255x148px~~]]</li>

<li>5V的散热风扇。如下图所示，开发板上有用于接散热风扇的接口，接口规格为'''2pin 1.25mm间距'''

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<big>'''开发板上的风扇可以通过PWM来调节转速和开关。'''</big>

|}

[[File:~~media/image14~~pi3b-img14-1.png~~|353x231px~~]]</li>

<li>百兆或者千兆网线，用于将开发板连接到因特网

[[File:~~media/image15~~pi3b-img15.png~~|143x112px~~]]</li>

<li>USB2.0公对公数据线，用于烧录镜像到eMMC、NVMe SSD等功能

[[File:~~media/image16~~pi3b-img16.png~~|158x155px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>'''3.3V'''的USB转TTL模块和杜邦线，使用串口调试功能时，需要USB转TTL模块和杜邦线来连接开发板和电脑

[[File:~~media/image17~~pi3b-img17.png|~~217x89px|G7U7JZX(V`L$`A6864]38$P~~300px]] [[File:~~media/image18~~pi3b-img18.png|~~305x110px~~500px]]</li>

<li>安装有Ubuntu和Windows操作系统的个人电脑

|}

::[[File:~~media/image19~~pi3b-img19-1.png~~|576x455px~~]]

'''http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html'''

|}

[[File:~~media/image20~~pi3b-img20-1.png~~|575x481px~~]]</li>

<li>资料主要包含

<li>'''Debian镜像'''：保存在百度云盘和谷歌网盘上</li>

<li>'''Orange Pi OS镜像'''：保存在百度云盘和谷歌网盘上</li>

<li>'''~~OpenWRT镜像~~OpenHarmony镜像'''：保存在百度云盘和谷歌网盘上</li></ol>

</li></ol>

<li>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方

[[File:~~media/image21~~pi3b-img21.png~~|359x172px~~]]</li>

<li>然后可以选择下载balenaEtcher的Portable版本的软件，Portable版本无需安装，双击打开就可以使用

[[File:~~media/image22~~pi3b-img22.png~~|382x141px~~]]</li>

<li>如果下载的是需要安装版本的balenaEtcher，请先安装再使用。如果下载的Portable版本balenaEtcher，直接双击打开即可，打开后的balenaEtcher界面如下图所示：

[[File:~~media/image23~~pi3b-img23.png~~|369x233px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<big>'''打开balenaEtcher时如果提示下面的错误：'''</big>

[[File:~~media/image24~~pi3b-img24.png~~|209x164px~~|center]]

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

[[File:~~media/image25~~pi3b-img25.png~~|273x37px~~|center]]

|}

</li></ol>

<li>然后选择TF卡的盘符</li>

<li>最后点击Flash就会开始烧录Linux镜像到TF卡中

[[File:~~media/image26~~pi3b-img26.png~~|423x237px~~]]</li></ol>

</li>

<li>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中

[[File:~~media/image27~~pi3b-img27.png~~|428x268px~~]]</li>

<li>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验

[[File:~~media/image28~~pi3b-img28.png~~|427x267px~~]]</li>

<li>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了

[[File:~~media/image29~~pi3b-img29.png~~|430x266px~~]]</li></ol>

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

[[File:~~media/image16~~pi3b-img16.png~~|146x143px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>还需要准备一张16GB或更大容量的TF卡，TF卡的传输速度必须为'''class10'''级或'''class10'''级以上，建议使用闪迪等品牌的TF卡</li>

<li>然后从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']下载瑞芯微驱动'''DriverAssitant_v5.12.zip'''和'''MiniLoader'''以及烧录工具'''RKDevTool_Release_v3.15.zip'''

<li>在[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']首先选择'''官方工具'''，然后进入下面的文件夹中

[[File:~~media/image30~~pi3b-img30.png~~|267x56px~~]]</li>

<li>然后下载下面的所有文件

[[File:~~media/image31~~pi3b-img31.png~~|246x97px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<li>然后从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上</li>

<li>然后用解压软件解压'''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe'''可执行文件并打开即可

[[File:~~media/image32~~pi3b-img32.png~~|464x136px~~]]</li>

<li>打开'''DriverInstall.exe'''后安装瑞芯微驱动的步骤如下所示

<li>点击”'''驱动安装'''”按钮

[[File:~~media/image33~~pi3b-img33.png~~|245x129px~~]]</li>

<li>等待一段时间后，会弹出窗口提示”'''安装驱动成功'''”，然后点击”'''确定'''”按钮即可

[[File:~~media/image34~~pi3b-img34.png~~|254x132px~~]]</li></ol>

</li>

<li>然后解压'''RKDevTool_Release_v3.15.zip'''，此软件无需安装，在解压后的文件夹中找到'''RKDevTool'''打开即可

[[File:~~media/image35~~pi3b-img35.png~~|448x132px~~]]</li>

<li>打开'''RKDevTool''' 烧录工具后，因为电脑此时还没有通过USB2.0公对公数据线连接上开发板，所以左下角会提示”'''没有发现设备'''”

[[File:~~media/image36~~pi3b-img36.png~~|402x189px~~]]</li>

<li>然后开始烧录Linux镜像到TF卡中

<li>首先通过USB2.0公对公数据线连接好开发板与Windows电脑，开发板USB2.0烧录口的位置如下图所示

[[File:~~media/image37~~pi3b-img37.png~~|271x117px~~]]</li>

<li>确保TF卡插槽没有插入TF卡</li>

<li>然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：

[[File:~~media/image38~~pi3b-img38-1.png~~|289x100px~~]]</li>

<li>然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了

[[File:~~media/image39~~pi3b-img39-1.png~~|305x94px~~]]</li>

<li>如果前面的步骤顺利，此时开发板会进入'''MASKROM'''模式，在烧录工具的界面上会提示”'''发现一个MASKROM设备'''”

[[File:~~media/image40~~pi3b-img40.png~~|454x213px~~]]</li>

<li>此时请在TF卡插槽中插入TF卡</li>

<li>然后将鼠标光标放在下面的这片区域中

[[File:~~media/image41~~pi3b-img41.png~~|452x212px~~]]</li>

<li>然后点击鼠标右键会弹出下图所示的选择界面

[[File:~~media/image42~~pi3b-img42.png~~|453x213px~~]]</li>

<li>然后选择'''导入配置'''选项

[[File:~~media/image43~~pi3b-img43.png~~|458x215px~~]]</li><li>然后选择前面下载的'''MiniLoader'''文件夹中的'''~~rk3588_linux_tfcard~~rk356x_linux_tfcard.cfg'''配置文件，再点击'''打开'''[[File:~~media/image44~~pi3b-img44-2.png~~|457x215px~~]]</li>

<li>然后点击'''确定'''

[[File:~~media/image45~~pi3b-img45.png~~|483x227px~~]]</li>

<li>然后点击下图所示的位置

[[File:~~media/image46~~pi3b-img46.png~~|486x228px~~]]</li><li>再选择前面下载的'''MiniLoader'''文件夹中'''~~rk3566_MiniLoaderAll~~MiniLoaderAll.bin'''，再点击'''打开'''

[[File:~~media/image47~~pi3b-img47-1.png~~|494x232px|[78~~Z7UFB@US@8P$QL%OM6~~]]

</div></li>

<li>然后点击下图所示的位置

[[File:~~media/image48~~pi3b-img48.png~~|493x232px~~]]</li><li>~~然后选择想要烧录的linux镜像的路径，再点击~~然后选择想要烧录的Linux镜像的路径，再点击'''打开'''

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''~~在烧录镜像前，建议将要烧录的linux镜像重命名为orangepi~~在烧录镜像前，建议将要烧录的Linux镜像重命名为orangepi.img或者其它比较短的名字，这样在烧录镜像的时候就能看到烧录进度的百分比数值。'''</big>

|}

[[File:~~media/image49~~pi3b-img49.png~~|499x234px~~]]</li>

<li>然后请勾选上'''强制按地址写'''选项

[[File:~~media/image50~~pi3b-img50.png~~|497x234px~~]]</li><li>~~再点击执行按钮就会开始烧录linux镜像到开发板的tf卡中~~再点击执行按钮就会开始烧录Linux镜像到开发板的tf卡中[[File:~~media/image51~~pi3b-img51.png~~|497x233px~~]]</li><li>~~linux镜像烧录完后的显示log如下图所示~~Linux镜像烧录完后的显示log如下图所示

[[File:~~media/image52~~pi3b-img52.png~~|492x231px|%O4~FPPAT$0RH{3S~CGJ@@Q(1)~~]]

</div></li>

<li>~~烧录完linux镜像到tf卡中后，linux系统会自动启动。~~烧录完Linux镜像到tf卡中后，Linux系统会自动启动。</li></ol>

</li></ol>

=== 使用Win32Diskimager烧录Linux镜像的方法 ===

[[File:~~media/image53~~pi3b-img53.png~~|209x228px|选区_199~~]]

</div></li>

<li>然后点击”'''Format'''”，格式化前会弹出一个警告框，选择”'''是(Y)'''”后就会开始格式化</li>

[[File:~~media/image54~~pi3b-img54.png~~|304x147px~~]]

</ol>

<li>格式化完TF卡后会弹出下图所示的信息，点击确定即可

[[File:~~media/image55~~pi3b-img55.png~~|186x149px~~]]</li></ol>

</li></ol>

<li>b) 然后确认下TF卡的盘符和”'''设备'''”一栏中显示的一致</li>

<li>c) 最后点击”'''写入'''”即可开始烧录

[[File:~~media/image56~~pi3b-img56.png~~|297x206px~~]]</li></ol>

</li>

<li>镜像写入完成后，点击”'''退出'''”按钮退出即可，然后就可以拔出TF卡插到开发板中启动</li></ol>

<li>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方

[[File:~~media/image21~~pi3b-img21.png~~|434x208px~~]]</li>

<li>然后选择下载Linux版本的软件即可

[[File:~~media/image57~~pi3b-img57.png~~|430x163px~~]]</li>

<li>从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上

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

</li>

<li>然后在Ubuntu PC的图形界面双击'''balenaEtcher-1.5.109-x64.AppImage'''即可打开balenaEtcher（'''无需安装'''），balenaEtcher打开后的界面显示如下图所示

[[File:~~media/image58~~pi3b-img58.png~~|423x251px~~]]</li>

<li>使用balenaEtcher烧录Linux镜像的具体步骤如下所示

<li>然后选择TF卡的盘符</li>

<li>最后点击Flash就会开始烧录Linux镜像到TF卡中

[[File:~~media/image59~~pi3b-img59.png~~|431x278px~~]]</li></ol>

</li>

<li>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中

[[File:~~media/image60~~pi3b-img60.png~~|429x184px~~]]</li></ol>

<li>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验

[[File:~~media/image61~~pi3b-img61.png~~|436x190px~~]]</li>

<li>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了

[[File:~~media/image62~~pi3b-img62.png~~|435x257px~~]]</li></ol>

<li>开发板预留了eMMC模块的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：

[[File:~~media/image63~~pi3b-img63.png|~~115x84px~~400px]] [[File:~~media/image64~~pi3b-img64.png|~~120x87px~~400px]][[File:~~media/image65~~pi3b-img65.png|~~277x129px~~800px]]</li>

<li>还需要准备一根品质良好的USB2.0公对公数据线

[[File:~~media/image16~~pi3b-img16.png~~|141x138px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>在[http://www.orangepi.cn/html/serviceAndSupport/index.html '''Orange Pi的资料下载页面''']首先选择官方工具，然后进入下面的文件夹中

[[File:~~media/image30~~pi3b-img30.png~~|366x77px~~]]</li>

<li>然后下载下面的所有文件

[[File:~~media/image31~~pi3b-img31.png~~|315x125px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<li>然后从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上</li>

<li>然后用解压软件解压'''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe'''可执行文件并打开即可

[[File:~~media/image32~~pi3b-img32.png~~|496x146px~~]]</li>

<li>打开'''DriverInstall.exe'''后安装瑞芯微驱动的步骤如下所示

<li>点击”'''驱动安装'''”按钮

[[File:~~media/image33~~pi3b-img33.png~~|284x149px~~]]</li>

<li>等待一段时间后，会弹出窗口提示”'''安装驱动成功'''”，然后点击'''“确定”'''按钮即可

[[File:~~media/image34~~pi3b-img34.png~~|296x154px~~]]</li></ol>

</li>

<li>然后解压'''RKDevTool_Release_v3.15.zip'''，此软件无需安装，在解压后的文件夹中找到 '''RKDevTool'''打开即可

[[File:~~media/image35~~pi3b-img35.png~~|484x143px~~]]</li>

<li>打开'''RKDevTool''' 烧录工具后，因为电脑此时还没有通过USB2.0公对公数据线连接上开发板，所以左下角会提示”'''没有发现设备'''”

[[File:~~media/image36~~pi3b-img36.png~~|442x208px~~]]</li>

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

<li>首先通过USB2.0公对公数据线连接好开发板与Windows电脑，开发板USB2.0烧录口的位置如下图所示

[[File:~~media/image37~~pi3b-img37.png~~|275x118px~~]]</li>

<li>确保开发板没有插入TF卡，没有连接电源</li>

<li>然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：

[[File:~~media/image38~~pi3b-img38-1.png~~|289x100px~~]]</li>

<li>然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了

[[File:~~media/image39~~pi3b-img39-1.png~~|305x94px~~]]</li>

<li>如果前面的步骤顺利，此时开发板会进入'''MASKROM'''模式，在烧录工具的界面上会提示”'''发现一个MASKROM设备'''”

[[File:~~media/image40~~pi3b-img40.png~~|457x215px~~]]</li>

<li>然后将鼠标光标放在下面的这片区域中

[[File:~~media/image41~~pi3b-img41.png~~|458x215px~~]]</li>

<li>然后点击鼠标右键会弹出下图所示的选择界面

[[File:~~media/image42~~pi3b-img42.png~~|460x216px~~]]</li>

<li>然后选择'''导入配置'''选项

[[File:~~media/image43~~pi3b-img43.png~~|458x215px~~]]</li><li>然后选择前面下载的'''MiniLoader'''文件夹中的'''~~rk3588_linux_emmc~~rk356x_linux_emmc.cfg'''配置文件，再点击'''打开'''[[File:~~media/image66~~pi3b-img66-1.png~~|466x219px~~]]</li>

<li>然后点击'''确定'''

[[File:~~media/image67~~pi3b-img67.png~~|468x220px~~]]</li>

<li>然后点击下图所示的位置

[[File:~~media/image68~~pi3b-img68.png~~|462x217px~~]]</li><li>再选择前面下载的'''MiniLoader'''文件夹中'''~~rk3566_MiniLoaderAll~~MiniLoaderAll.bin'''，再点击'''打开'''

[[File:~~media/image69~~pi3b-img69-1.png~~|459x216px|SIS5H0S2@F5M2D(6ANZEUPG~~]]

</div></li>

<li>然后点击下图所示的位置

[[File:~~media/image70~~pi3b-img70.png~~|459x216px~~]]</li><li>~~然后选择想要烧录的linux镜像的路径，再点击~~然后选择想要烧录的Linux镜像的路径，再点击'''打开'''

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''~~在烧录镜像前，建议将要烧录的linux镜像重命名为orangepi~~在烧录镜像前，建议将要烧录的Linux镜像重命名为orangepi.img或者其它比较短的名字，这样在烧录镜像的时候就能看到烧录进度的百分比数值。'''</big>

|}

[[File:~~media/image49~~pi3b-img49.png~~|499x234px~~]]</li>

<li>然后请勾选上'''强制按地址写'''选项

[[File:~~media/image71~~pi3b-img71.png~~|501x235px~~]]</li><li>~~再点击执行按钮就会开始烧录linux镜像到开发板的eMMC中~~再点击执行按钮就会开始烧录Linux镜像到开发板的eMMC中[[File:~~media/image72~~pi3b-img72.png~~|502x236px~~]]</li><li>~~linux镜像烧录完后的显示log如下图所示~~Linux镜像烧录完后的显示log如下图所示[[File:~~media/image73~~pi3b-img73.png~~|500x235px~~]]</li><li>~~烧录完linux镜像到eMMC中后，linux系统会自动启动。~~烧录完Linux镜像到eMMC中后，Linux系统会自动启动。

{| class="wikitable" style="width:800px;background-color:#ffffdc;"

|-

|

<big>'''~~注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPIFlash后再启动试下。清空SPIFlash的方法请参考~~注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPI Flash后再启动试下。清空SPI Flash的方法请参考[[Orange Pi 3B#使用RKDevTool清空SPIFlash的方法|使用RKDevTool清空SPIFlash的方法]]小节的内容。'''</big>

|}

</li></ol>

|-

|

<big>'''~~注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian、Ubuntu、OpenWRT或者OPi~~ 注意，这里说的Linux镜像具体指的是从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html Orange Pi资料下载页面]下载的Debian、Ubuntu或者OPi OS Arch这样的Linux发行版镜像。'''</big>

|}

<li>开发板预留了eMMC模块的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：

[[File:~~media/image63~~pi3b-img63.png|~~115x84px~~400px]] [[File:~~media/image64~~pi3b-img64.png|~~120x87px~~400px]][[File:~~media/image65~~pi3b-img65.png|~~286x133px~~800px]]</li><li>使用dd命令烧录linux镜像到eMMC中需要借助TF卡来完成，所以首先需要将linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入linux系统。烧录Linux镜像到TF卡的方法请见使用dd命令烧录Linux镜像到eMMC中需要借助TF卡来完成，所以首先需要将Linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入Linux系统。烧录Linux镜像到TF卡的方法请见[[Orange Pi 3B#基于Windows PC将Linux镜像烧写到TF卡的方法|'''基于Windows PC将Linux镜像烧录到TF卡的方法''']]和[[Orange Pi 3B#基于Ubuntu PC将Linux镜像烧写到TF卡的方法|'''基于Ubuntu PC将Linux镜像烧录到TF卡的方法''']]两小节的说明。</li><li>使用TF卡启动linux系统后，我们首先将解压后的linux镜像文件（从官网下载的Debian、Ubuntu镜像或者OPi Arch镜像）上传到TF卡中。上传linux镜像文件到开发板中的方法请参考使用TF卡启动Linux系统后，我们首先将解压后的Linux镜像文件（从官网下载的Debian、Ubuntu镜像或者OPi Arch镜像）上传到TF卡中。上传Linux镜像文件到开发板中的方法请参考[[Orange Pi 3B#上传文件到开发板Linux系统中的方法|'''上传文件到开发板Linux系统中的方法''']]小节的说明。</li><li>~~上传完镜像到开发板的linux系统中后，我们再在开发板linux系统的命令行中进入镜像文件的存放路径，比如，我将开发板的linux镜像存放在~~上传完镜像到开发板的Linux系统中后，我们再在开发板Linux系统的命令行中进入镜像文件的存放路径，比如，我将开发板的Linux镜像存放在'''/home/orangepi/Desktop'''目录下了，然后进入'''/home/orangepi/Desktop'''目录就能看到上传的镜像文件了。

{| class="wikitable" style="width:800px;"

|-

|

<big>'''~~怎么进入开发板linux系统的命令行？~~怎么进入开发板Linux系统的命令行？'''

'''1. 使用串口登录终端的方法请参考[[Orange Pi 3B#调试串口的使用方法|调试串口的使用方法]]一小节的说明。'''

'''2. ~~使用ssh远程登录linux系统请参考~~使用ssh远程登录Linux系统请参考[[Orange Pi 3B#SSH远程登录开发板|SSH远程登录开发板]]一小节的说明。'''

'''3. 如果接了HDMI、LCD等显示屏幕，可以在桌面中打开一个命令行终端。'''</big>

|}

</li>

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

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

{| class="wikitable" style="width:800px;"

|-

|

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

|}

</li></ol>

</li>

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''~~注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPIFlash后再启动试下。清空SPIFlash的方法请参考~~注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPI Flash后再启动试下。清空SPI Flash的方法请参考[[Orange Pi 3B#使用RKDevTool清空SPIFlash的方法|使用RKDevTool清空SPIFlash的方法]]小节的内容。'''</big>

|}

</li></ol>

|-

|

<big>'''~~注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian、Ubuntu这样的Linux发行版镜像。~~注意，这里说的Linux镜像具体指的是从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html Orange Pi资料下载页面]下载的Debian、Ubuntu这样的Linux发行版镜像。'''</big>

|}

<li>M.2 2230规格的SSD如下所示

[[File:~~media/image74~~pi3b-img74.png~~|157x128px~~]]</li>

<li>M.2 2242规格的SSD如下所示

[[File:~~media/image75~~pi3b-img75.png~~|174x105px~~]]</li></ol>

</li>

<li>然后把NVMe SSD插入开发板的M.2 PCIe接口，并固定好

[[File:~~media/image76~~pi3b-img76.png~~|283x63px~~]]</li>

<li>SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置

[[File:~~media/image77~~pi3b-img77-1.png~~|266x211px~~]]</li>

<li>然后需要准备一根品质良好的USB2.0公对公数据线

[[File:~~media/image16~~pi3b-img16.png~~|141x138px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>在[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html Orange Pi的资料下载页面]首先选择'''官方工具'''，然后进入下面的文件夹中

[[File:~~media/image30~~pi3b-img30.png~~|294x61px~~]]</li>

<li>然后下载下面的所有文件

[[File:~~media/image31~~pi3b-img31.png~~|244x97px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

</li>

<li>然后从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在2GB以上

~~{| class="wikitable" style="background-color:#ffffdc;width:800px;"~~

|-

|

<big>'''注意，如果下载的是OpenWRT镜像，在OpenWRT镜像的下载链接中会看到下面三种类型的镜像，请选择”TF卡启动镜像”文件夹中的镜像文件。'''</big>

~~[[File:media/image78.png|223x82px|center]]~~

|}

</li>

<li>然后用解压软件解压'''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe'''可执行文件并打开即可

[[File:~~media/image32~~pi3b-img32.png~~|446x131px~~]]</li>

<li>打开'''DriverInstall.exe'''后安装瑞芯微驱动的步骤如下所示

<li>点击”'''驱动安装'''”按钮

[[File:~~media/image33~~pi3b-img33.png~~|253x133px~~]]</li>

<li>等待一段时间后，会弹出窗口提示”'''安装驱动成功'''”，然后点击'''“确定”'''按钮即可

[[File:~~media/image34~~pi3b-img34.png~~|269x140px~~]]</li></ol>

</li>

<li>然后解压'''RKDevTool_Release_v3.15.zip'''，此软件无需安装，在解压后的文件夹中找到 '''RKDevTool'''打开即可

[[File:~~media/image35~~pi3b-img35.png~~|402x119px~~]]</li>

<li>打开'''RKDevTool''' 烧录工具后，因为电脑此时还没有通过USB2.0公对公数据线连接上开发板，所以左下角会提示”'''没有发现设备'''”

[[File:~~media/image36~~pi3b-img36.png~~|402x189px~~]]</li>

<li>然后开始烧录Linux镜像到SSD中

<li>首先通过USB2.0公对公数据线连接好开发板与Windows电脑，开发板USB2.0烧录接口的位置如下图所示

[[File:~~media/image37~~pi3b-img37.png~~|275x118px~~]]</li>

<li>确保开发板没有连接电源和插入TF卡以及eMMC</li>

<li>然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：

[[File:~~media/image38~~pi3b-img38-1.png~~|289x100px~~]]</li>

<li>然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了

[[File:~~media/image39~~pi3b-img39-1.png~~|305x94px~~]]</li>

<li>如果前面的步骤顺利，此时开发板会进入'''MASKROM'''模式，在烧录工具的界面上会提示”'''发现一个MASKROM设备'''”

[[File:~~media/image40~~pi3b-img40.png~~|457x215px~~]]</li>

<li>然后将鼠标光标放在下面的这片区域中

[[File:~~media/image41~~pi3b-img41.png~~|459x216px~~]]</li>

<li>然后点击鼠标右键会弹出下图所示的选择界面

[[File:~~media/image42~~pi3b-img42.png~~|453x213px~~]]</li>

<li>然后选择'''导入配置'''选项

[[File:~~media/image43~~pi3b-img43.png~~|458x215px~~]]</li>

<li>然后进入前面下载的'''MiniLoader'''文件夹中，然后选择'''rk3588_linux_pcie.cfg'''配置文件，再点击'''打开'''

[[File:~~media/image79~~pi3b-img79.png~~|462x217px~~]]</li>

<li>然后点击'''确定'''

[[File:~~media/image80~~pi3b-img80.png~~|468x220px~~]]</li>

<li>然后点击下图所示的位置

[[File:~~media/image81~~pi3b-img81.png~~|475x223px~~]]</li>

<li>再选择前面下载的'''MiniLoader'''文件夹中'''rk3566_MiniLoaderAll.bin'''，再点击'''打开'''

[[File:~~media/image69~~pi3b-img69.png~~|459x216px|SIS5H0S2@F5M2D(6ANZEUPG~~]]

</div></li>

<li>然后点击下图所示的位置

[[File:~~media/image82~~pi3b-img82.png~~|486x228px~~]]</li>

<li>然后进入前面下载的'''MiniLoader'''文件夹中，再选择'''rk3566_rkspi_loader.img'''，再点击'''打开'''

[[File:~~media/image83~~pi3b-img83.png~~|488x228px|GGU}ZN)TL%P[INB(M%MNJV7~~]]

</div></li>

<li>然后点击下图所示的位置

[[File:~~media/image84~~pi3b-img84.png~~|493x231px~~]]</li><li>~~然后选择想要烧录的linux镜像的路径，再点击~~然后选择想要烧录的Linux镜像的路径，再点击'''打开'''

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''~~在烧录镜像前，建议将要烧录的linux镜像重命名为orangepi~~在烧录镜像前，建议将要烧录的Linux镜像重命名为orangepi.img或者其它比较短的名字，这样在烧录镜像的时候就能看到烧录进度的百分比数值。'''</big>

|}

[[File:~~media/image49~~pi3b-img49.png~~|499x234px~~]]</li>

<li>然后请勾选上'''强制按地址写'''选项

[[File:~~media/image85~~pi3b-img85.png~~|498x234px~~]]</li><li>~~再点击执行按钮就会开始烧录linux镜像到SSD中~~再点击执行按钮就会开始烧录Linux镜像到SSD中[[File:~~media/image86~~pi3b-img86.png~~|500x235px~~]]</li><li>~~linux镜像烧录完后的显示log如下图所示~~Linux镜像烧录完后的显示log如下图所示[[File:~~media/image87~~pi3b-img87.png~~|504x240px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''~~如果烧录有问题，请先清空下SPIFlash然后再烧录试下。清空SPIFlash的方法请参考下~~如果烧录有问题，请先清空下SPI Flash然后再烧录试下。清空SPI Flash的方法请参考下[[Orange Pi 3B#使用RKDevTool清空SPIFlash的方法|使用RKDevTool清空SPIFlash的方法]]一小节的说明。'''</big>

|}

</li>

<li>镜像烧录完后会自动启动SPIFlash+PCIe ~~SSD中的linux系统，如果没有正常启动，请重新上电试下。~~SSD中的Linux系统，如果没有正常启动，请重新上电试下。</li></ol>

</li></ol>

<li>M.2 2230规格的SSD如下所示

[[File:~~media/image74~~pi3b-img74.png~~|158x129px~~]]</li>

<li>M.2 2242规格的SSD如下所示

[[File:~~media/image75~~pi3b-img75.png~~|192x116px~~]]</li></ol>

</li></ol>

<li>然后把NVMe SSD插入开发板的M.2 PCIe接口，并固定好

[[File:~~media/image76~~pi3b-img76.png~~|283x63px~~]]</li>

<li>SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置

[[File:~~media/image77~~pi3b-img77-1.png~~|261x198px~~]]</li><li>~~烧录linux镜像到SPIFlash~~烧录Linux镜像到SPIFlash+NVMe ~~SSD中需要借助TF卡来完成，所以首先需要将linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入linux系统。烧录Linux镜像到TF卡的方法请见~~SSD中需要借助TF卡来完成，所以首先需要将Linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入Linux系统。烧录Linux镜像到TF卡的方法请见[[Orange Pi 3B#基于Windows PC将Linux镜像烧写到TF卡的方法|'''基于Windows PC将Linux镜像烧写到TF卡的方法''']]和[[Orange Pi 3B#基于Ubuntu PC将Linux镜像烧写到TF卡的方法|'''基于Ubuntu PC将Linux镜像烧写到TF卡的方法''']]两小节的说明。</li><li>~~使用TF卡启动linux系统后，我们首先烧录u~~使用TF卡启动Linux系统后，我们首先烧录u-boot镜像到SPI Flash中

<li>先运行下'''nand-sata-install'''，'''普通用户记得加sudo权限'''

[[File:~~media/image88~~pi3b-img88.png~~|355x174px|IMG_256~~]]

</div></ol>

[[File:~~media/image89~~pi3b-img89.png~~|356x179px|IMG_256~~]]

</div>

[[File:~~media/image90~~pi3b-img90.png~~|358x161px|IMG_256~~]]

</div>

</li></ol>

<li>~~然后将linux镜像文件（从官网下载的Debian或者Ubuntu镜像）上传到TF卡中。上传linux镜像文件到开发板中的方法请参考~~然后将Linux镜像文件（从官网下载的Debian或者Ubuntu镜像）上传到TF卡中。上传Linux镜像文件到开发板中的方法请参考[[Orange Pi 3B#上传文件到开发板Linux系统中的方法|'''上传文件到开发板Linux系统中的方法''']]小节的说明。</li><li>~~上传完镜像到开发板的linux系统中后，我们再在开发板linux系统的命令行中进入镜像文件的存放路径，比如，我将开发板的linux镜像存放在~~上传完镜像到开发板的Linux系统中后，我们再在开发板Linux系统的命令行中进入镜像文件的存放路径，比如，我将开发板的Linux镜像存放在'''/home/orangepi/Desktop'''目录下了，然后进入'''/home/orangepi/Desktop'''目录就能看到上传的镜像文件了。

{| class="wikitable" style="width:800px;"

|-

|

<big>'''~~怎么进入开发板linux系统的命令行？~~怎么进入开发板Linux系统的命令行？'''

<li>'''使用串口登录终端的方法请参考[[Orange Pi 3B#调试串口的使用方法|调试串口的使用方法]]一小节的说明。'''</li>

<li>'''~~使用ssh远程登录linux系统请参考~~使用ssh远程登录Linux系统请参考[[Orange Pi 3B#SSH远程登录开发板|SSH远程登录开发板]]一小节的说明。'''</li>

<li>'''如果接了HDMI、LCD等显示屏幕，可以在桌面中打开一个命令行终端。'''

</li></ol></big>

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

{| class="wikitable" style="width:800px;"

|-

|}

</li>

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

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

{| class="wikitable" style="width:800px;"

|-

|

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

|}

</li></ol>

</li>

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

<li>启动NVMe SSD中的系统后，使用'''df -h'''命令可以看到实际的硬盘容量

<li>M.2 2230规格的SSD如下所示

[[File:~~media/image74~~pi3b-img74.png~~|189x153px~~]]</li>

<li>M.2 2242规格的SSD如下所示

[[File:~~media/image75~~pi3b-img75.png~~|238x144px~~]]</li></ol>

</li>

<li>然后把NVMe SSD插入开发板的M.2 PCIe接口，并固定好

[[File:~~media/image76~~pi3b-img76.png~~|283x63px~~]]</li>

<li>SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置

[[File:~~media/image77~~pi3b-img77-1.png~~|261x198px~~]]</li><li>~~烧录linux镜像到SPIFlash~~烧录Linux镜像到SPIFlash+NVMe ~~SSD中需要借助TF卡来完成，所以首先需要将linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入linux系统。烧录Linux镜像到TF卡的方法请见~~SSD中需要借助TF卡来完成，所以首先需要将Linux镜像烧录到TF卡上，然后使用TF卡启动开发板进入Linux系统。烧录Linux镜像到TF卡的方法请见[[Orange Pi 3B#基于Windows PC将Linux镜像烧写到TF卡的方法|'''基于Windows PC将Linux镜像烧写到TF卡的方法''']]和[[Orange Pi 3B#基于Ubuntu PC将Linux镜像烧写到TF卡的方法|'''基于Ubuntu PC将Linux镜像烧写到TF卡的方法''']]两小节的说明。</li><li>~~启动进入TF卡中的linux系统后，请先确认下NVMe SSD已经被开发板的linux正常识别了。如果NVMe~~ 启动进入TF卡中的Linux系统后，请先确认下NVMe SSD已经被开发板的Linux正常识别了。如果NVMe SSD正常识别了的话，使用'''sudo fdisk -l'''命令就能看到'''nvme'''相关的信息

{| class="wikitable" style="width:800px;"

|-

|}

</li>

<li>~~linux镜像中已经预装了balenaEtcher，打开方法如下所示：~~Linux镜像中已经预装了balenaEtcher，打开方法如下所示：

[[File:~~media/image91~~pi3b-img91.png~~|506x249px|IMG_256~~]]

</div>

[[File:~~media/image92~~pi3b-img92.png~~|406x207px|IMG_256~~]]

</div></li></ol>

[[File:~~media/image93~~pi3b-img93.png~~|406x205px|IMG_256~~]]

</div></ol>

[[File:~~media/image94~~pi3b-img94.png~~|563x110px|IMG_256~~]]

</div></ol>

<li>打开'''rkspi_loader.img'''后的界面如下所示：

[[File:~~media/image95~~pi3b-img95.png~~|379x181px~~]]</li>

<li>然后点击'''Select target'''</li>

[[File:~~media/image96~~pi3b-img96.png~~|379x171px|IMG_256~~]]

</div></ol>

[[File:~~media/image97~~pi3b-img97.png~~|385x155px|IMG_256~~]]

</div></ol>

[[File:~~media/image98~~pi3b-img98.png~~|389x264px|IMG_256~~]]

</div></ol>

[[File:~~media/image99~~pi3b-img99.png~~|394x268px|IMG_256~~]]

</div></ol>

[[File:~~media/image100~~pi3b-img100.png~~|396x269px|IMG_256~~]]

</div></ol>

<li>~~然后输入开发板linux系统的密码~~然后输入开发板Linux系统的密码'''orangepi'''，就会开始烧录u-boot镜像到SPI Flash中</li>

[[File:~~media/image101~~pi3b-img101.png~~|393x269px|IMG_256~~]]

</div></ol>

[[File:~~media/image102~~pi3b-img102.png~~|397x272px|IMG_256~~]]

</div></ol>

[[File:~~media/image103~~pi3b-img103.png~~|395x225px|IMG_256~~]]

</div></ol>

</li></ol>

<li>~~烧录TF卡中的linux系统到NVMe~~ 烧录TF卡中的Linux系统到NVMe SSD中的方法（此方法相当于将TF卡中的系统克隆到NVMe SSD）

<li>首先点击'''Clone drive'''</li>

[[File:~~media/image104~~pi3b-img104.png~~|386x204px|IMG_256~~]]

</div></ol>

[[File:~~media/image105~~pi3b-img105.png~~|379x256px|IMG_256~~]]

</div></ol>

[[File:~~media/image106~~pi3b-img106.png~~|381x191px|IMG_256~~]]

</div></ol>

[[File:~~media/image96~~pi3b-img96.png~~|379x171px|IMG_256~~]]

</div></ol>

[[File:~~media/image97~~pi3b-img97.png~~|385x155px|IMG_256~~]]

</div></ol>

<li>然后选择NVMe SSD的设备名'''/dev/nvme0n1''',然后点击'''Select'''</li>

[[File:~~media/image107~~pi3b-img107.png~~|386x264px~~]]

</ol>

[[File:~~media/image108~~pi3b-img108.png~~|389x264px|IMG_256~~]]

</div></ol>

[[File:~~media/image109~~pi3b-img109.png~~|392x268px|IMG_256~~]]

</div></ol>

<li>~~然后输入开发板linux系统的密码orangepi，就会开始烧录linux镜像到SSD中~~然后输入开发板Linux系统的密码orangepi，就会开始烧录Linux镜像到SSD中</li>

[[File:~~media/image110~~pi3b-img110.png~~|390x267px|IMG_256~~]]

</div></ol>

<li>烧录过程的显示如下所示：</li>

[[File:~~media/image111~~pi3b-img111.png~~|393x212px~~]]

[[File:~~media/image112~~pi3b-img112.png~~|395x205px|IMG_256~~]]

</div></ol>

<li>烧录完成后的显示如下所示：</li>

[[File:~~media/image113~~pi3b-img113.png~~|398x227px~~]]

</ol>

[[File:~~media/image114~~pi3b-img114.png~~|576x215px|IMG_256~~]]

</div></li></ol>

<li>b) ~~然后输入linux系统的密码orangepi，再点击~~然后输入Linux系统的密码orangepi，再点击'''Authenticate'''</li>

[[File:~~media/image115~~pi3b-img115.png~~|356x173px~~]]

</ol>

<li>c) 然后点击'''Fix'''

[[File:~~media/image116~~pi3b-img116.png~~|355x261px~~]]</li>

<li>d) 然后选择NVMe SSD</li>

[[File:~~media/image117~~pi3b-img117.png~~|452x187px|IMG_256~~]]

</div></ol>

[[File:~~media/image118~~pi3b-img118.png~~|451x187px|IMG_256~~]]

</div></ol>

[[File:~~media/image119~~pi3b-img119.png~~|448x345px|IMG_256~~]]

</div></ol>

<li>g) 然后在下图所示的位置将容量拖动到最大

[[File:~~media/image120~~pi3b-img120.png~~|339x210px~~]]</li>

<li>h) 然后点击'''Resize/Move'''

[[File:~~media/image121~~pi3b-img121.png~~|339x212px~~]]</li>

<li>i) 然后点击下图位置绿色的'''√'''

[[File:~~media/image122~~pi3b-img122.png~~|425x166px~~]]</li>

<li>j) 再点击'''Apply'''

[[File:~~media/image123~~pi3b-img123.png~~|378x276px~~]]</li>

<li>k) 然后点击'''Close'''关闭即可

[[File:~~media/image124~~pi3b-img124.png~~|383x234px~~]]</li></ol>

</li></ol>

<li>此时就可以使用'''sudo poweroff'''命令关机了。然后请拔出TF卡，再短按电源按键开机，此时就会启动SPIFlash+NVMe ~~SSD中的linux系统了。~~SSD中的Linux系统了。</li></ol>

</li></ol>

<li>第 '''9''' 步是克隆TF卡中的系统到NMVe ~~SSD中，我们还可以直接烧录linux镜像文件到NVMe~~ SSD中，我们还可以直接烧录Linux镜像文件到NVMe SSD中，这里大概说下步骤：

<li>~~上传linux镜像文件到开发板的linux系统中~~上传Linux镜像文件到开发板的Linux系统中</li>

<li>然后使用balenaEtcher烧录即可

[[File:~~media/image125~~pi3b-img125.png~~|463x291px~~]]</li>

<li>'''使用这种方法烧录镜像后无需手动扩容，第一次启动会自动扩容。'''</li></ol>

</li></ol>

[[File:~~media/image16~~pi3b-img16.png~~|141x138px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>然后从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']下载瑞芯微驱动'''DriverAssitant_v5.12.zip'''和烧录工具'''RKDevTool_Release_v3.15.zip'''<ol style="list-style-type: lower-alpha;"><li>在[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']首先选择'''官方工具'''，然后进入下面的文件夹中[[File:pi3b-img126-2.png]]</li><li>然后下载下面的所有文件[[File:pi3b-img127-2.png]]</li></li></ol>

<li>然后从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''Orange Pi的资料下载页面''']下载Android的镜像。

<li>打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择'''TF卡和eMMC启动镜像'''文件夹中的镜像进行下载

[[File:~~media/image126~~pi3b-img126.png~~|224x82px~~]]</li>

<li>进入'''TF卡和eMMC启动镜像'''文件夹后可以看到下面两个镜像，它们的区别是：

<li>a) 第一个镜像专门用于HDMI显示的，支持4K显示，如果不使用LCD屏幕，请下载不带lcd的镜像</li>

<li>b) 如果要使用lcd屏幕，请选择带lcd的镜像

[[File:~~media/image127~~pi3b-img127.png~~|264x58px~~]]</li></ol>

</li></ol>

</li>

<li>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Android镜像文件，大小在1GB以上</li>

<li>然后用解压软件解压'''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe'''可执行文件并打开即可

[[File:~~media/image32~~pi3b-img32.png~~|575x169px~~]]</li>

<li>打开'''DriverInstall.exe'''后安装瑞芯微驱动的步骤如下所示

<li>点击”'''驱动安装'''”按钮

[[File:~~media/image33~~pi3b-img33.png~~|300x157px~~]]</li>

<li>等待一段时间后，会弹出窗口提示”'''安装驱动成功'''”，然后点击'''“确定”'''按钮即可

[[File:~~media/image34~~pi3b-img34.png~~|315x164px~~]]</li></ol>

</li>

<li>然后解压'''RKDevTool_Release_v3.15.zip'''，此软件无需安装，在解压后的文件夹中找到 '''RKDevTool'''打开即可

[[File:~~media/image35~~pi3b-img35.png~~|454x134px~~]]</li>

<li>打开'''RKDevTool''' 烧录工具后，因为电脑此时还没有通过USB2.0公对公数据线连接上开发板，所以左下角会提示”'''没有发现设备'''”

[[File:~~media/image36~~pi3b-img36.png~~|442x208px~~]]</li>

<li>然后开始烧录Android镜像到TF卡中

<li>首先通过USB2.0公对公数据线连接好开发板与Windows电脑，开发板USB2.0烧录接口的位置如下图所示

[[File:~~media/image37~~pi3b-img37.png~~|275x118px~~]]</li>

<li>然后确保开发板没有插入TF卡，没有连接电源</li>

<li>然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：

[[File:~~media/image38~~pi3b-img38-1.png~~|289x100px~~]]</li>

<li>然后给开发板接上Type-C接口的电源，并上电

[[File:~~media/image39~~pi3b-img39-1.png~~|305x94px~~]]</li>

<li>如果前面的步骤顺利，此时开发板会进入'''MASKROM'''模式，在烧录工具的界面上会提示”'''发现一个MASKROM设备'''”

[[File:~~media/image40~~pi3b-img40.png~~|457x215px~~]]</li>

<li>然后再插入TF卡到开发板</li>

<li>然后请选择'''高级功能'''

[[File:~~media/image128~~pi3b-img128.png~~|458x138px~~]]</li>

<li>然后点击下图所示的位置

[[File:~~media/image129~~pi3b-img129.png~~|459x216px~~]]</li>

<li>再选择前面下载的'''MiniLoader'''文件夹中的'''rk3566_MiniLoaderAll.bin'''，再点击打开

[[File:~~media/image69~~pi3b-img69.png~~|459x216px|SIS5H0S2@F5M2D(6ANZEUPG~~]]

</div></li>

<li>然后点击'''下载'''

[[File:~~media/image130~~pi3b-img130.png~~|472x222px~~]]</li>

<li>下载完'''rk3566_MiniLoaderAll.bin'''后的显示如下图所示

[[File:~~media/image131~~pi3b-img131.png~~|474x227px~~]]</li>

<li>然后选择存储设备为'''SD'''，再点击'''切换存储'''

[[File:~~media/image132~~pi3b-img132.~~jpeg|477x222px|D~T2CO%X~K2@ELR98)BVP~2~~png]]

</div></li>

[[File:~~media/image133~~pi3b-img133.~~jpeg|474x223px|QFVLTK~19N32OK2UGH{D{AK~~png]]

</div></li>

<li>然后点击烧录工具的”'''升级固件'''”一栏

[[File:~~media/image134~~pi3b-img134.png~~|477x224px~~]]</li>

<li>接着点击”'''固件'''”按钮选择需要烧录的Android镜像的路径

[[File:~~media/image135~~pi3b-img135.png~~|444x209px~~]]</li>

<li>最后点击”'''升级'''”按钮就会开始烧录，烧录过程中的log如下图所示。烧录完成后Android系统会自动启动。</li>

[[File:~~media/image136~~pi3b-img136.png~~|455x214px|GO~ZSPN`B]JCQM`@_9UU8[R~~]]

</div></ol>

<li>打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择'''TF卡和eMMC启动镜像'''文件夹中的镜像进行下载

[[File:~~media/image126~~pi3b-img126.png~~|224x82px~~]]</li></ol>

<li>a) 不带lcd的镜像是专门用于HDMI显示的，支持4K显示，如果不使用LCD屏幕，请下载不带lcd的镜像</li>

<li>b) 如果要使用LCD屏幕，请选择带lcd的镜像

[[File:~~media/image127~~pi3b-img127.png~~|281x62px~~]]</li></ol>

</li></ol>

</li>

<li>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Android镜像文件，大小在1GB以上</li>

<li>然后使用解压软件解压'''SDDiskTool_v1.72.zip'''，此软件无需安装，在解压后的文件夹中找到'''SD_Firmware_Tool.exe'''打开即可

[[File:~~media/image137~~pi3b-img137.png~~|415x99px~~]]</li>

<li>打开'''SDDiskTool'''后，如果TF卡识别正常，会在”'''选择可移动磁盘设备'''”一栏中显示插入的磁盘设备，'''请务必确认显示的磁盘设备和你想烧录的TF卡的盘符是一致的'''，如果没有显示可以尝试拔插下TF卡

[[File:~~media/image138~~pi3b-img138.png~~|267x228px~~]]</li>

<li>确认完盘符后，可以先格式化下TF卡，点击'''SDDiskTool'''中的'''恢复磁盘'''按钮即可，也可使用前面提到的'''SD Card Formatter'''进行TF卡的格式化

[[File:~~media/image139~~pi3b-img139.png~~|264x226px~~]]</li>

<li>然后开始将Android镜像写入TF卡

<li>然后在”'''选择升级固件'''”一栏中选择Android镜像的路径</li>

<li>最后点击”'''开始创建'''”按钮就会开始烧录Android镜像到TF卡中

[[File:~~media/image140~~pi3b-img140.png~~|286x242px~~]]</li></ol>

</li>

<li>烧录完后即可退出SDDiskTool软件，然后就可以把TF卡从电脑中拔出来插到开发板中启动了

[[File:~~media/image141~~pi3b-img141.png~~|288x244px~~]]</li></ol>

|-

|

<big>'''~~注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPIFlash后再启动试下。清空SPIFlash的方法请参考~~注意，烧录镜像到eMMC中后如果测试发现启动不了，请清空下SPI Flash后再启动试下。清空SPI Flash的方法请参考[[Orange Pi 3B#使用RKDevTool清空SPIFlash的方法|使用RKDevTool清空SPIFlash的方法]]小节的内容。'''</big>

|}

<li>开发板预留了eMMC的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。

eMMC模块和插入开发板的方法如下所示：

[[File:~~media/image63~~pi3b-img63.png|~~115x84px~~300px]] [[File:~~media/image64~~pi3b-img64.png|~~120x87px~~300px]][[File:~~media/image65~~pi3b-img65.png|~~286x133px~~600px]]</li>

<li>还需要准备一根品质良好的USB2.0公对公数据线

[[File:~~media/image16~~pi3b-img16.png~~|141x138px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择'''TF卡和eMMC启动镜像'''文件夹中的镜像进行下载

[[File:~~media/image126~~pi3b-img126.png~~|224x82px~~]]</li>

<li>进入'''TF卡和eMMC启动镜像'''文件夹后可以看到下面两个镜像，它们的区别是：

<li>a) 第一个镜像专门用于HDMI显示的，支持4K显示，如果不使用LCD屏幕，请下载不带lcd的镜像</li>

<li>b) 如果要使用lcd屏幕，请选择带lcd的镜像

[[File:~~media/image127~~pi3b-img127.png~~|264x58px~~]]</li></ol>

</li></ol>

</li>

<li>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Android镜像文件，大小在1GB以上</li>

<li>然后用解压软件解压'''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe'''可执行文件并打开即可

[[File:~~media/image32~~pi3b-img32.png~~|575x169px~~]]</li>

<li>打开'''DriverInstall.exe'''后安装瑞芯微驱动的步骤如下所示

<li>点击”'''驱动安装'''”按钮

[[File:~~media/image33~~pi3b-img33.png~~|300x157px~~]]</li>

<li>等待一段时间后，会弹出窗口提示”'''安装驱动成功'''”，然后点击'''“确定”'''按钮即可

[[File:~~media/image34~~pi3b-img34.png~~|315x164px~~]]</li></ol>

</li>

<li>然后解压'''RKDevTool_Release_v3.15.zip'''，此软件无需安装，在解压后的文件夹中找到 '''RKDevTool'''打开即可

[[File:~~media/image35~~pi3b-img35.png~~|454x134px~~]]</li>

<li>打开'''RKDevTool''' 烧录工具后，因为电脑此时还没有通过USB2.0公对公数据线连接上开发板，所以左下角会提示”'''没有发现设备'''”

[[File:~~media/image36~~pi3b-img36.png~~|442x208px~~]]</li>

<li>然后开始烧录Android镜像到eMMC中

<li>首先通过USB2.0公对公数据线连接好开发板与Windows电脑，开发板USB2.0烧录接口的位置如下图所示

[[File:~~media/image37~~pi3b-img37.png~~|275x118px~~]]</li>

<li>然后确保开发板没有插入TF卡，没有连接电源</li>

<li>然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：

[[File:~~media/image38~~pi3b-img38.png~~|289x100px~~]]</li>

<li>然后给开发板接上Type-C接口的电源，并上电

[[File:~~media/image39~~pi3b-img39.png~~|305x94px~~]]</li>

<li>如果前面的步骤顺利，此时开发板会进入'''MASKROM'''模式，在烧录工具的界面上会提示”'''发现一个MASKROM设备'''”

[[File:~~media/image40~~pi3b-img40.png~~|457x215px~~]]</li></ol>

<li>然后请选择'''高级功能'''

[[File:~~media/image128~~pi3b-img128.png~~|458x138px~~]]</li>

<li>然后点击下图所示的位置

[[File:~~media/image129~~pi3b-img129.png~~|459x216px~~]]</li>

<li>再选择前面下载的'''MiniLoader'''文件夹中的'''rk3566_MiniLoaderAll.bin'''，再点击打开

[[File:~~media/image69~~pi3b-img69.png~~|459x216px|SIS5H0S2@F5M2D(6ANZEUPG~~]]

</div></li>

<li>然后点击'''下载'''

[[File:~~media/image130~~pi3b-img130.png~~|472x222px~~]]</li>

<li>下载完'''MiniLoaderAll.bin'''后的显示如下图所示

[[File:~~media/image142~~pi3b-img142.png~~|474x223px~~]]</li>

<li>然后选择存储设备为'''EMMC，'''再点击'''切换存储'''

[[File:~~media/image143~~pi3b-img143.png~~|468x225px~~]]</li>

<li>切换成功的显示如下图所示

[[File:~~media/image144~~pi3b-img144.png~~|472x227px~~]]</li></ol>

<li>然后点击烧录工具的”'''升级固件'''”一栏

[[File:~~media/image134~~pi3b-img134.png~~|442x208px~~]]</li>

<li>接着点击”'''固件'''”按钮选择需要烧录的Android镜像的路径

[[File:~~media/image135~~pi3b-img135.png~~|444x209px~~]]</li>

<li>最后点击”'''升级'''”按钮就会开始烧录，烧录过程中的log如下图所示。烧录完成后Android系统会自动启动。

[[File:~~media/image136~~pi3b-img136.png~~|455x214px|GO~ZSPN`B]JCQM`@_9UU8[R~~]]

</div></li></ol>

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<li>开发板预留了eMMC的扩展接口，烧录系统到eMMC前，首先需要购买一个与开发板eMMC接口相匹配的eMMC模块。然后将eMMC模块安装到开发板上。eMMC模块和插入开发板的方法如下所示：

[[File:~~media/image63~~pi3b-img63.png|~~115x84px~~300px]] [[File:~~media/image64~~pi3b-img64.png|~~120x87px~~300px]][[File:~~media/image65~~pi3b-img65.png|~~286x133px~~600px]]</li>

<li>还需要准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为'''class10'''或以上，建议使用闪迪等品牌的TF卡</li>

<li>然后使用读卡器把TF卡插入电脑</li>

<li>打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择'''TF卡和eMMC启动镜像'''文件夹中的镜像进行下载

[[File:~~media/image126~~pi3b-img126.png~~|224x82px~~]]</li><li>进入'''TF卡和eMMC启动镜像'''~~文件夹后可以看到下面三个镜像，它们的区别是：~~文件夹后可以看到下面两个镜像，它们的区别是：

<li>a) 第一个镜像专门用于HDMI显示的，支持4K显示，如果不使用LCD屏幕，请下载不带lcd的镜像</li>

<li>b) 如果要使用lcd屏幕，请选择带lcd的镜像

[[File:~~media/image127~~pi3b-img127.png~~|283x62px~~]]</li></ol>

</li></ol>

</li>

<li>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”.img” 结尾的文件就是Android镜像文件，大小在1GB以上</li>

<li>然后使用解压软件解压'''SDDiskTool_v1.72.zip'''，此软件无需安装，在解压后的文件夹中找到'''SD_Firmware_Tool.exe'''打开即可

[[File:~~media/image137~~pi3b-img137.png~~|429x103px~~]]</li>

<li>打开'''SDDiskTool'''后，如果TF卡识别正常，会在”'''选择可移动磁盘设备'''”一栏中显示插入的磁盘设备，'''请务必确认显示的磁盘设备和你想烧录的TF卡的盘符是一致的'''，如果没有显示可以尝试拔插下TF卡

[[File:~~media/image138~~pi3b-img138.png~~|267x228px~~]]</li>

<li>确认完盘符后，可以先格式化下TF卡，点击'''SDDiskTool'''中的'''恢复磁盘'''按钮即可，也可使用前面提到的'''SD Card Formatter'''进行TF卡的格式化

[[File:~~media/image139~~pi3b-img139.png~~|247x212px~~]]</li>

<li>然后开始将Android镜像写入TF卡

<li>然后在”'''选择升级固件'''”一栏中选择Android固件的路径</li>

<li>最后点击”'''开始创建'''”按钮就会开始烧录

[[File:~~media/image145~~pi3b-img145.png~~|290x246px~~]]</li></ol>

</li>

<li>烧录完成后的显示如下图所示，然后就可以退出SDDiskTool

[[File:~~media/image146~~pi3b-img146.png~~|285x243px~~]]</li>

<li>然后把TF卡从电脑中拔出来插到开发板中，开发板上电启动后就会自动开始将TF卡中的Android镜像烧录到开发板的eMMC中</li>

<li>如果开发板连接了HDMI显示器，还可以从HDMI显示器中看到烧录Android镜像到eMMC中的进度条

[[File:~~media/image147~~pi3b-img147.png~~|430x247px~~]]</li>

<li>当HDMI显示器显示如下信息时，说明烧录Android镜像到eMMC中已完成，此时就可以拔出TF卡，然后eMMC中的安卓系统就会开始启动。

[[File:~~media/image148~~pi3b-img148.png~~|576x389px~~]]</li></ol>

<li>M.2 2230规格的SSD如下所示

[[File:~~media/image74~~pi3b-img74.png~~|147x120px~~]]</li>

<li>M.2 2242规格的SSD如下所示

[[File:~~media/image75~~pi3b-img75.png~~|216x131px~~]]</li></ol>

</li>

<li>然后把NVMe SSD插入开发板的M.2 PCIe接口，并固定好

[[File:~~media/image76~~pi3b-img76.png~~|283x63px~~]]</li>

<li>SPI Flash在开发板上的位置如下图所示，开始烧录前无需其他设置

[[File:~~media/image77~~pi3b-img77-1.png~~|266x211px~~]]</li>

<li>还需要准备一根品质良好的USB2.0公对公数据线

[[File:~~media/image16~~pi3b-img16.png~~|141x138px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>打开安卓镜像的下载链接后可以看到下面两种类型的安卓镜像，请选择'''SPIFlash-NVME SSD启动镜像'''文件夹中的镜像进行下载

[[File:~~media/image149~~pi3b-img149.png~~|195x65px~~]]</li>

<li>进入'''SPIFlash-NVME SSD启动镜像'''文件夹后可以看到下面两个镜像，它们的区别是：

<li>a) 不带lcd的镜像是专门用于HDMI显示的，支持4K显示，如果不使用LCD屏幕，请下载不带lcd的镜像</li>

<li>b) 如果要使用LCD屏幕，请选择带lcd的镜像

[[File:~~media/image150~~pi3b-img150.png~~|305x58px~~]]</li></ol>

</li></ol>

</li>

<li>然后用解压软件解压'''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe'''可执行文件并打开即可

[[File:~~media/image32~~pi3b-img32.png~~|407x120px~~]]</li>

<li>打开'''DriverInstall.exe'''后安装瑞芯微驱动的步骤如下所示

<li>点击”'''驱动安装'''”按钮

[[File:~~media/image33~~pi3b-img33.png~~|286x150px~~]]</li>

<li>等待一段时间后，会弹出窗口提示”'''安装驱动成功'''”，然后点击'''“确定”'''按钮即可

[[File:~~media/image34~~pi3b-img34.png~~|296x154px~~]]</li></ol>

</li>

<li>然后解压'''RKDevTool_Release_v3.15.zip'''，此软件无需安装，在解压后的文件夹中找到 '''RKDevTool'''打开即可

[[File:~~media/image35~~pi3b-img35.png~~|413x122px~~]]</li>

<li>打开'''RKDevTool''' 烧录工具后，因为电脑此时还没有通过USB2.0公对公数据线连接上开发板，所以左下角会提示”'''没有发现设备'''”

[[File:~~media/image36~~pi3b-img36.png~~|402x189px~~]]</li>

<li>然后开始烧录Android镜像到SPIFlash+NVMe SSD中

<li>首先通过USB2.0公对公数据线连接好开发板与Windows电脑，开发板USB2.0烧录口的位置如下图所示

[[File:~~media/image37~~pi3b-img37.png~~|275x118px~~]]</li>

<li>确保开发板没有插入TF卡，没有连接电源</li>

<li>然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：

[[File:~~media/image38~~pi3b-img38-1.png~~|289x100px~~]]</li>

<li>然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了

[[File:~~media/image39~~pi3b-img39-1.png~~|305x94px~~]]</li>

<li>如果前面的步骤顺利，此时开发板会进入'''MASKROM'''模式，在烧录工具的界面上会提示”'''发现一个MASKROM设备'''”

[[File:~~media/image40~~pi3b-img40.png~~|443x208px~~]]</li>

<li>然后点击烧录工具的”'''升级固件'''”一栏

[[File:~~media/image134~~pi3b-img134.png~~|442x208px~~]]</li>

<li>接着点击”'''固件'''”按钮选择需要烧录的Android镜像

[[File:~~media/image135~~pi3b-img135.png~~|444x209px~~]]</li>

<li>最后点击”'''升级'''”按钮就会开始烧录，烧录的过程如下图所示，可以看到，首先会烧录固件到SPIFlash中，然后烧录固件到PCIE中。烧录完成后Android系统会自动启动。

[[File:~~media/image151~~pi3b-img151.png~~|453x212px~~]]</li></ol>

</li></ol>

<li>SPI Flash在开发板上的位置如下图所示

[[File:~~media/image77~~pi3b-img77-1.png~~|263x193px~~]]</li>

<li>首先需要准备一根品质良好的USB2.0公对公数据线

[[File:~~media/image16~~pi3b-img16.png~~|141x138px|D6BB9058-CDC3-42d7-A7FC-FBF630D886B7~~]]

</div></li>

<li>在[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html Orange Pi的资料下载页面]首先选择'''官方工具'''，然后进入下面的文件夹中

[[File:~~media/image30~~pi3b-img30.png~~|366x77px~~]]</li>

<li>然后下载下面的所有文件

[[File:~~media/image31~~pi3b-img31.png~~|315x125px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

</li>

<li>然后用解压软件解压'''DriverAssitant_v5.12.zip'''，再在解压后的文件夹中找到'''DriverInstall.exe'''可执行文件并打开即可

[[File:~~media/image32~~pi3b-img32.png~~|472x139px~~]]</li>

<li>打开'''DriverInstall.exe'''后安装瑞芯微驱动的步骤如下所示

<li>点击”'''驱动安装'''”按钮

[[File:~~media/image33~~pi3b-img33.png~~|276x145px~~]]</li>

<li>等待一段时间后，会弹出窗口提示”'''安装驱动成功'''”，然后点击'''“确定”'''按钮即可

[[File:~~media/image34~~pi3b-img34.png~~|292x151px~~]]</li></ol>

</li>

<li>然后解压'''RKDevTool_Release_v3.15.zip'''，此软件无需安装，在解压后的文件夹中找到 '''RKDevTool'''打开即可

[[File:~~media/image35~~pi3b-img35.png~~|467x138px~~]]</li>

<li>打开'''RKDevTool''' 烧录工具后，因为电脑此时还没有通过USB2.0公对公数据线连接上开发板，所以左下角会提示”'''没有发现设备'''”

[[File:~~media/image36~~pi3b-img36.png~~|402x189px~~]]</li>

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

<li>首先通过USB2.0公对公数据线连接好开发板与Windows电脑，开发板USB2.0烧录口的位置如下图所示

[[File:~~media/image37~~pi3b-img37.png~~|275x118px~~]]</li>

<li>确保开发板没有插入TF卡，没有连接电源</li>

<li>然后按住开发板的MaskROM按键不放，MaskROM按键在开发板的位置如下图所示：

[[File:~~media/image38~~pi3b-img38-1.png~~|289x100px~~]]</li>

<li>然后给开发板接上Type-C接口的电源，并上电，然后就可以松开MaskROM按键了

[[File:~~media/image39~~pi3b-img39-1.png~~|305x94px~~]]</li>

<li>如果前面的步骤顺利，此时开发板会进入'''MASKROM'''模式，在烧录工具的界面上会提示”'''发现一个MASKROM设备'''”

[[File:~~media/image40~~pi3b-img40.png~~|457x215px~~]]</li>

<li>然后请选择'''高级功能'''

[[File:~~media/image128~~pi3b-img128.png~~|458x138px~~]]</li>

<li>然后点击下图所示的位置

[[File:~~media/image129~~pi3b-img129.png~~|459x216px~~]]</li>

<li>再选择前面下载的'''MiniLoader'''文件夹中的'''rk3566_MiniLoaderAll.bin'''，再点击打开

[[File:~~media/image69~~pi3b-img69.png~~|459x216px|SIS5H0S2@F5M2D(6ANZEUPG~~]]

</div></li>

<li>然后点击'''下载'''

[[File:~~media/image130~~pi3b-img130.png~~|472x222px~~]]</li>

<li>下载完'''rk3566_MiniLoaderAll.bin'''后的显示如下图所示

[[File:~~media/image142~~pi3b-img142.png~~|474x223px~~]]</li>

<li>然后选择存储设备为'''SPINOR'''

[[File:~~media/image152~~pi3b-img152.png~~|467x220px~~]]</li>

<li>然后点击'''切换存储'''

[[File:~~media/image153~~pi3b-img153.png~~|464x218px~~]]</li>

<li>然后点击'''擦除所有'''就会开始擦除SPIFlash了

[[File:~~media/image154~~pi3b-img154.png~~|467x220px~~]]</li>

<li>擦除SPIFlash后的显示log如下图所示

[[File:~~media/image155~~pi3b-img155.png~~|460x216px~~]]</li></ol>

</li></ol>

# 将烧录好镜像的TF卡插入香橙派开发板的TF卡插槽中。如果SPIFlash+NVMe SSD已经烧录好镜像了，那么就不需要插入TF卡了，只需确保NVMe SSD正常插入到开发板中即可。

# 开发板有HDMI接口，可以通过HDMI转HDMI连接线把开发板连接到电视或者HDMI显示器。如果有购买LCD屏幕，也可以使用LCD屏幕来显示开发板的系统界面。如果有Type-C转HDMI的线，也可以通过Type-C接口来显示开发板的系统界面。开发板有HDMI接口，可以通过HDMI转HDMI连接线把开发板连接到电视或者HDMI显示器。如果有购买LCD屏幕，也可以使用LCD屏幕来显示开发板的系统界面。

# 接上USB鼠标和键盘，用于控制香橙派开发板。

# 开发板有以太网口，可以插入网线用来上网。

# 连接一个5V/~~3A或者5V/4A的USB~~ 3A的USB Type-~~C接口的'''高品质'''的电源适配。~~C接口的高品质的电源适配。

::{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|}

::[[File:~~media/image156~~pi3b-img156.png~~|569x114px~~]]

<li>开发板的调试串口GND、RXD和TXD引脚的对应关系如下图所示

[[File:~~media/image157~~pi3b-img157.png~~|428x110px~~]]</li>

<li>USB转TTL模块GND、TXD和RXD引脚需要通过杜邦线连接到开发板的调试串口上

[[File:~~media/image158~~pi3b-img158.~~jpeg|524x189px|QQ图片20210204145010~~png]]

</div>

</li>

<li>执行putty命令后会弹出下面的界面

[[File:~~media/image159~~pi3b-img159.png~~|367x321px~~]]</li>

<li>首先选择串口的设置界面

[[File:~~media/image160~~pi3b-img160.png~~|359x352px~~]]</li>

<li>然后设置串口的参数

<li>设置Speed(baud)为'''1500000'''（串口的波特率）</li>

<li>设置Flow control为None

[[File:~~media/image161~~pi3b-img161.png~~|316x312px~~]]</li></ol>

</li>

<li>在串口的设置界面设置完后，再回到Session界面

<li>首先选择Connection type为Serial</li>

<li>然后点击Open按钮连接串口

[[File:~~media/image162~~pi3b-img162.png~~|345x340px~~]]</li></ol>

</li>

<li>启动开发板后，就能从打开的串口终端中看到系统输出的Log信息了

[[File:~~media/image163~~pi3b-img163.png~~|468x340px~~]]</li></ol>

</li>

<li>进入MobaXterm下载网页后点击'''GET XOBATERM NOW!'''

[[File:~~media/image164~~pi3b-img164.png~~|576x334px~~]]</li>

<li>然后选择下载Home版本

[[File:~~media/image165~~pi3b-img165.png~~|353x231px~~]]</li>

<li>然后选择Portable便携式版本，下载完后无需安装，直接打开就可以使用

[[File:~~media/image166~~pi3b-img166.png~~|575x259px~~]]</li></ol>

</li>

<li>下载完后使用解压缩软件解压下载的压缩包，即可得到MobaXterm的可执软件，然后双击打开

[[File:~~media/image167~~pi3b-img167.png~~|576x81px~~]]</li>

<li>打开软件后，设置串口连接的步骤如下

<li>最后点击”'''OK'''”按钮完成设置</li>

[[File:~~media/image168~~pi3b-img168.png~~|575x438px~~]]

</ol>

</li></ol>

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

[[File:~~media/image169~~pi3b-img169.png~~|575x291px~~]]</li></ol>

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

|-

|

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

|}

[[File:~~media/image170~~pi3b-img170.~~jpeg|216x154px|4ff86e49b6624616f9498fe44c366f29~~png]]

</div>

<li>使用40pin接口中的5V引脚来给开发板供电，电源线的接法如下所示

<li>上图所示的电源线USB A口需要插到5V/~~3A或者5V4A的电源适配器接头上（~~3A的电源适配器接头上（'''请不要插到电脑的USB接口来供电'''）</li>

<li>红色的杜邦线需要插到开发板40pin的5V引脚上</li>

<li>黑色的杜邦线需要插到40pin接口的GND引脚上</li>

<li>40pin接口5V引脚和GND引脚在开发板中的位置如下图所示，'''切记不要接反了'''

[[File:~~media/image171~~pi3b-img171.png~~|366x71px~~]]</li></ol>

</li></ol>

|-

|

<big>'''~~本章内容是基于linux服务器版本的镜像和xfce桌面版本镜像编写的。~~本章内容是基于Linux服务器版本的镜像和xfce桌面版本镜像编写的。'''</big>

|}

|-

| '''Ubuntu 22.04 - Jammy'''

| '''Linux5.10'''

| '''支持'''

|-

| '''Debian12 - Bookworm'''

| '''Linux5.10'''

| '''支持'''

|}

== ~~linux系统适配情况~~ Linux系统适配情况 ==

{| class="wikitable" style="width:800px;text-align:center;"

| '''功能'''

| '''Debian11'''

| '''Debian12'''

| '''Ubuntu20.04'''

| '''Ubuntu22.04'''

|-

| '''USB2.0x3'''

| '''OK'''

|-

| '''USB3.0x1'''

| '''OK'''

|-

| '''M.2 NVMe SSD启动'''

| '''OK'''

|-

| '''WIFI'''

| '''OK'''

|-

| '''蓝牙'''

| '''OK'''

|-

| '''GPIO（40pin）'''

| '''OK'''

|-

| '''UART（40pin）'''

| '''OK'''

|-

| '''SPI（40pin）'''

| '''OK'''

|-

| '''I2C（40pin）'''

| '''OK'''

|-

| '''PWM（40pin）'''

| '''OK'''

|-

| '''PWM风扇接口'''

| '''OK'''

|-

| '''3pin调试串口'''

| '''OK'''

|-

| '''EMMC'''

| '''OK'''

|-

| '''TF卡启动'''

| '''OK'''

|-

| '''HDMI 视频'''

| '''OK'''

|-

| '''HDMI 音频'''

| '''OK'''

|-

| '''Camera'''

| '''OKNO'''| '''OKNO'''| '''OKNO'''| '''NO'''

|-

| '''LCD'''

| '''OK'''

|-

| '''eDP显示'''

| '''OK'''

|-

| '''千兆网口'''

| '''OK'''

|-

| '''网口状态灯'''

| '''OK'''

|-

| '''耳机播放'''

| '''OK'''

|-

| '''耳机录音'''

| '''OK'''

|-

| '''LED灯'''

| '''OK'''

|-

| '''RTC'''

| '''OK'''

|-

| '''GPU'''

| '''OK'''

|-

| '''NPU'''

| '''OK'''

|-

| '''VPU'''

| '''OK'''

|-

| '''看门狗测试'''

| '''OK'''

|-

| '''Chromium硬解视频'''

| '''OK'''

|}

== ~~本手册linux命令格式说明~~ 本手册Linux命令格式说明 ==

<li>命令前面的提示符类型说明

<li>命令前面提示符指的是下面方框内红色部分的内容，这部分内容不是linux命令的一部分，所以在linux系统中输入命令时，请不要把红色字体部分的内容也输入进去。命令前面提示符指的是下面方框内红色部分的内容，这部分内容不是Linux命令的一部分，所以在Linux系统中输入命令时，请不要把红色字体部分的内容也输入进去。

{| class="wikitable" style="width:800px;"

|-

|}

</li>

<li>'''root@orangepi:~$''' 提示符表示这个命令是在'''~~开发板的linux系统~~开发板的Linux系统'''中输入的，提示符最后的 '''$''' 表示系统当前用户为普通用户，当执行特权命令时，需要加上'''sudo'''</li><li>'''root@orangepi:~#''' 提示符表示这个命令是在'''~~开发板的linux系统~~开发板的Linux系统'''中输入的，提示符最后的 '''#''' 表示系统当前用户为root用户，可以执行任何想要执行的命令</li><li>'''test@test:~$''' 提示符表示这个命令是在Ubuntu ~~PC或者Ubuntu虚拟机中输入的，而不是开发板的linux系统中。提示符最后的~~ PC或者Ubuntu虚拟机中输入的，而不是开发板的Linux系统中。提示符最后的 '''$''' 表示系统当前用户为普通用户，当执行特权命令时，需要加上'''sudo'''</li><li>'''root@test:~#''' 提示符表示这个命令是在Ubuntu ~~PC或者Ubuntu虚拟机中输入的，而不是开发板的linux系统中。提示符最后的~~ PC或者Ubuntu虚拟机中输入的，而不是开发板的Linux系统中。提示符最后的 '''#''' 表示系统当前用户为root用户，可以执行任何想要执行的命令</li></ol>

</li>

<li>哪些是需要输入的命令？

</li></ol>

== ~~linux系统登录说明~~ Linux系统登录说明 ==

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

{| class="wikitable" style="width:800px;text-align:center;"

|}

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

<li>~~linux系统默认就是自动登录终端的，默认登录的用户名是~~Linux系统默认就是自动登录终端的，默认登录的用户名是'''orangepi'''[[File:~~media/image172~~pi3b-img172.png~~|351x198px~~]]</li>

<li>使用下面的命令可以设置root用户自动登录终端

{| class="wikitable" style="width:800px;"

</li></ol>

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

[[File:~~media/image173~~pi3b-img173.png~~|576x324px|1~~]]

</div></li>

[[File:~~media/image174~~pi3b-img174.png~~|569x320px|IMG_256~~]]

</div></li></ol>

</li>

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

[[File:~~media/image175~~pi3b-img175.png~~|448x187px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<li>开发板上有三个LED灯，一个绿灯，一个红灯，一个PCIe指示灯，所在位置如下图所示：

[[File:~~media/image176~~pi3b-img176-1.png~~|425x126px~~]]</li>

<li>'''只要开发板打开了电源，红色的LED灯就会常亮，这是由硬件控制的，软件无法关闭。'''</li>

<li>绿色的LED灯在内核启动后会一直闪烁，这是由软件控制的。</li>

|-

|

root@orangepi:~# '''cd /sys/class/leds/~~status~~status_led'''

|}

</li>

|-

|

root@orangepi:/sys/class/leds/~~work~~status_led# '''echo none > trigger'''

|}

</li>

|-

|

root@orangepi:/sys/class/leds/~~work~~status_led# '''echo default-on > trigger'''

|}

</li>

|-

|

root@orangepi:/sys/class/leds/~~work~~status_led# '''echo heartbeat > trigger'''

|}

</li></ol>

<li>~~先登录linux系统，有下面三种方式~~先登录Linux系统，有下面三种方式

<li>如果开发板连接了网线，可以通过[[Orange Pi 3B#SSH远程登录开发板|'''~~ssh远程登录linux系统~~ssh远程登录Linux系统''']]</li></ol>

<li>~~如果开发板连接好了调试串口，可以使用串口终端登录linux系统~~如果开发板连接好了调试串口，可以使用串口终端登录Linux系统</li><li>~~如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统~~如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到Linux系统</li></ol>

</li></ol>

[[File:~~media/image177~~pi3b-img177.png~~|575x250px|选区_011~~]]

</div></li>

|-

|

orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0'''        '''（-I是大写的I不是小写的L）'''

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

<li>~~先登录linux系统，有下面三种方式~~先登录Linux系统，有下面三种方式

<li>如果开发板连接了网线，可以通过[[Orange Pi 3B#SSH远程登录开发板|'''~~ssh远程登录linux系统~~ssh远程登录Linux系统''']]</li><li>~~如果开发板连接好了调试串口，可以使用串口终端登录linux系统（串口软件请使用MobaXterm，使用minicom无法显示图形界面）~~如果开发板连接好了调试串口，可以使用串口终端登录Linux系统（串口软件请使用MobaXterm，使用minicom无法显示图形界面）</li><li>~~如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统~~如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到Linux系统</li></ol>

</li>

<li>然后在命令行中输入nmtui命令打开wifi连接的界面

</li>

<li>输入nmtui命令打开的界面如下所示

[[File:~~media/image178~~pi3b-img178.png~~|345x215px~~]]</li>

<li>选择'''Activate a connect'''后回车

[[File:~~media/image179~~pi3b-img179.png~~|349x216px~~]]</li>

<li>然后就能看到所有搜索到的WIFI热点

[[File:~~media/image180~~pi3b-img180.png~~|360x229px~~]]</li>

<li>选择想要连接的WIFI热点后再使用Tab键将光标定位到'''Activate'''后回车

[[File:~~media/image181~~pi3b-img181.png~~|366x230px~~]]</li>

<li>然后会弹出输入密码的对话框，在'''Password'''内输入对应的密码然后回车就会开始连接WIFI

[[File:~~media/image182~~pi3b-img182.png~~|352x225px~~]]</li>

<li>WIFI连接成功后会在已连接的WIFI名称前显示一个”*”

[[File:~~media/image183~~pi3b-img183.png~~|349x223px~~]]</li>

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

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0'''        '''（-I是大写的I不是小写的L）'''

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

<li>点击桌面右上角的网络配置图标（测试WIFI时请不要连接网线）

[[File:~~media/image184~~pi3b-img184.png~~|377x166px~~]]</li>

<li>在弹出的下拉框中点击'''More networks'''可以看到所有扫描到的WIFI热点，然后选择想要连接的WIFI热点

[[File:~~media/image185~~pi3b-img185.png~~|576x353px~~]]</li>

<li>然后输入WIFI热点的密码，再点击'''Connect'''就会开始连接WIFI

[[File:~~media/image186~~pi3b-img186.png~~|320x163px~~]]</li>

<li>连接好WIFI后，可以打开浏览器查看是否能上网，浏览器的入口如下图所示

[[File:~~media/image187~~pi3b-img187.png~~|576x308px~~]]</li>

<li>打开浏览器后如果能打开其他网页说明WIFI连接正常

[[File:~~media/image188~~pi3b-img188-1.png~~|576x273px|5~~]]

</div></li></ol>

</li>

<li>然后选择'''Edit a connection'''并按下回车键

[[File:~~media/image189~~pi3b-img189.png~~|227x247px~~]]</li>

<li>然后选择需要设置静态IP地址的网络接口，比如设置'''Ethernet'''接口的静态IP地址选择'''Wired connection 1'''就可以了

[[File:~~media/image190~~pi3b-img190.png~~|310x149px~~]]</li>

<li>然后通过'''Tab'''键选择'''Edit'''并按下回车键

[[File:~~media/image191~~pi3b-img191.png~~|316x144px~~]]</li>

<li>然后通过Tab键将光标移动到下图所示的'''<Automatic>'''位置进行IPv4的配置

[[File:~~media/image192~~pi3b-img192.png~~|575x240px~~]]</li>

<li>然后回车，通过上下方向键选择'''Manual'''，然后回车确定

[[File:~~media/image193~~pi3b-img193.png~~|576x237px~~]]</li>

<li>选择完后的显示如下图所示

[[File:~~media/image194~~pi3b-img194.png~~|575x240px~~]]</li>

<li>然后通过Tab键将光标移动到'''<Show>'''

[[File:~~media/image195~~pi3b-img195.png~~|576x241px~~]]</li>

<li>然后回车，回车后会弹出下面的设置界面

[[File:~~media/image196~~pi3b-img196.png~~|575x450px~~]]</li>

<li>然后就可以在下图所示的位置设置IP地址(Addresses)、网关(Gateway)和DNS服务器的地址（里面还有很多其他设置选项，请自行探索），'''请根据自己的具体需求来设置，下图中设置的值只是一个示例'''

[[File:~~media/image197~~pi3b-img197.png~~|576x233px~~]]</li>

<li>设置完后将光标移动到右下角的'''<OK>'''，然后回车确认

[[File:~~media/image198~~pi3b-img198.png~~|576x116px~~]]</li>

<li>然后点击'''<Back>'''回退到上一级选择界面

[[File:~~media/image199~~pi3b-img199.png~~|330x325px~~]]</li>

<li>然后选择'''Activate a connection'''，再将光标移动到'''<OK>'''，最后点击回车

[[File:~~media/image200~~pi3b-img200.png~~|331x248px~~]]</li>

<li>然后选择需要设置的网络接口，比如'''Wired connection 1'''，然后将光标移动到'''<Deactivate>'''，再按下回车键禁用'''Wired connection 1'''

[[File:~~media/image201~~pi3b-img201.png~~|576x224px~~]]</li>

<li>然后请不要移动光标，再按下回车键重新使能'''Wired connection 1'''，这样前面设置的静态IP地址就会生效了

[[File:~~media/image202~~pi3b-img202.png~~|576x224px~~]]</li>

<li>然后通过'''<Back>'''和'''Quit'''按钮就可以退出nmtui

[[File:~~media/image203~~pi3b-img203.png~~|300x253px~~]] [[File:~~media/image204~~pi3b-img204.png~~|227x252px~~]]</li>

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

{| class="wikitable" style="width:800px;"

<li>然后输入下面的命令，其中

<li>'''"Wired connection 1"''' ~~>~~ 表示设置以太网口的静态IP地址，如果需要设置WIFI的静态IP地址，请修改为WIFI网络接口对应的名字（通过'''nmcli ~~>~~ con show'''命令可以获取到）</li>

<li>'''ipv4.addresses'''后面是要设置的静态IP地址，可以修改为自己想要设置的值</li>

<li>'''ipv4.gateway''' 表示网关的地址

</li></ol>

</li>

<li>~~然后重启linux系统~~然后重启Linux系统

{| class="wikitable" style="width:800px;"

|-

|}

</li>

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

{| class="wikitable" style="width:800px;"

|-

# 获取开发板的IP地址

# ~~然后就可以通过ssh命令远程登录linux系统~~然后就可以通过ssh命令远程登录Linux系统

::{| class="wikitable" style="width:800px;"

[[File:~~media/image205~~pi3b-img205.png~~|405x207px|L467QDF65C(YR79U]TH[TND~~]]

</div>

|-

|

<big>'''如果ssh无法正常登陆linux系统，首先请检查下开发板的IP地址是否能ping通，如果ping通没问题的话，可以通过串口或者HDMI显示器登录linux系统然后在开发板上输入下面的命令后再尝试是否能连接：如果ssh无法正常登陆Linux系统，首先请检查下开发板的IP地址是否能ping通，如果ping通没问题的话，可以通过串口或者HDMI显示器登录Linux系统然后在开发板上输入下面的命令后再尝试是否能连接：'''

<li>然后在'''Session Setting'''中选择'''SSH'''</li>

<li>然后在'''Remote host'''中输入开发板的IP地址</li>

<li>然后在'''Specify username'''~~中输入linux系统的用户名~~中输入Linux系统的用户名'''root'''或'''orangepi'''</li>

<li>最后点击'''OK'''即可

[[File:~~media/image206~~pi3b-img206.png~~|576x292px~~]]</li></ol>

</li>

<li>然后会提示输入密码，默认root和orangepi用户的密码都为orangepi

[[File:~~media/image207~~pi3b-img207.png~~|578x150px|IMG_256~~]]

</div></li></ol>

<li>成功登录系统后的显示如下图所示</li>

[[File:~~media/image208~~pi3b-img208.png~~|576x334px~~]]

</ol>

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

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

<li>'''file_path：'''需要替换为要上传文件的路径</li>

<li>'''orangepi：'''~~为开发板linux系统的用户名，也可以替换成其它的，比如root~~为开发板Linux系统的用户名，也可以替换成其它的，比如root</li>

<li>'''192.168.xx.xx:''' 为开发板的IP地址，请根据实际情况进行修改</li>

<li>'''/home/orangepi:''' ~~开发板linux系统中的路径，也可以修改为其它的路径~~开发板Linux系统中的路径，也可以修改为其它的路径

{| class="wikitable" style="width:800px;"

|-

[[File:~~media/image209~~pi3b-img209.png~~|576x453px|截图 2022-12-03 19-04-40~~]]

</div></li>

[[File:~~media/image210~~pi3b-img210.png~~|577x128px|IMG_256~~]]

</div></ol>

<li>然后选择'''保存密码'''，再点击'''确定'''

[[File:~~media/image211~~pi3b-img211.png~~|249x181px~~]]</li>

<li>然后选择'''总是信任该主机'''，再点击'''确定'''</li>

[[File:~~media/image212~~pi3b-img212.png~~|278x150px|IMG_256~~]]

</div></ol>

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

[[File:~~media/image213~~pi3b-img213.png~~|533x330px|IMG_256~~]]

</div></ol>

[[File:~~media/image214~~pi3b-img214.png~~|529x414px|IMG_256~~]]

</div></ol>

<li>~~上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了~~上传完成后就可以去开发板Linux系统中的对应路径中查看上传的文件了</li>

<li>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</li></ol>

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

|}

::[[File:~~media/image215~~pi3b-img215.png~~|472x171px|IMG_256~~]]

::[[File:~~media/image216~~pi3b-img216.png~~|384x276px~~]]

[[File:~~media/image217~~pi3b-img217.png~~|319x251px|IMG_256~~]]

</div>

[[File:~~media/image218~~pi3b-img218.png~~|451x357px|IMG_256~~]]

</div></ol>

[[File:~~media/image219~~pi3b-img219.png~~|522x108px|IMG_256~~]]

</div></ol>

[[File:~~media/image220~~pi3b-img220.png~~|207x146px|IMG_256~~]]

</div></ol>

[[File:~~media/image221~~pi3b-img221.png~~|221x109px|IMG_256~~]]

</div></ol>

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

[[File:~~media/image222~~pi3b-img222.png~~|537x397px|IMG_256~~]]

</div></ol>

[[File:~~media/image223~~pi3b-img223.png~~|535x394px|IMG_256~~]]

</div></ol>

<li>~~上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了~~上传完成后就可以去开发板Linux系统中的对应路径中查看上传的文件了</li>

<li>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</li></ol>

<li>使用HDMI转HDMI线连接Orange Pi开发板和HDMI显示器

[[File:~~media/image10~~pi3b-img10.png~~|199x129px~~]]</li><li>~~启动linux系统后如果HDMI显示器有图像输出说明HDMI接口使用正常~~启动Linux系统后如果HDMI显示器有图像输出说明HDMI接口使用正常</li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<li>HDMI转VGA转换器

[[File:~~media/image224~~pi3b-img224.png~~|155x104px~~]]</li>

<li>一根VGA线

[[File:~~media/image225~~pi3b-img225.png~~|148x133px~~]]</li>

<li>一个支持VGA接口的显示器或者电视</li></ol>

</li>

<li>HDMI转VGA显示测试如下所示

[[File:~~media/image226~~pi3b-img226.png~~|576x339px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<li>首先在'''Settings'''中打开'''Display'''

[[File:~~media/image227~~pi3b-img227.png~~|576x370px~~]]</li>

<li>然后就能看到系统当前的分辨率

[[File:~~media/image228~~pi3b-img228.png~~|382x254px~~]]</li>

<li>点击Resolution（分辨率）的下拉框，就可以看到显示器当前支持的所有分辨率

[[File:~~media/image229~~pi3b-img229.png~~|415x274px~~]]</li>

<li>然后选择想要设置的分辨率，再点击Apply

[[File:~~media/image230~~pi3b-img230.png~~|415x277px~~]]</li>

<li>等新的分辨率设置完后再选择'''Keep the configuration'''即可

[[File:~~media/image231~~pi3b-img231.png~~|447x243px~~]]</li></ol>

== 蓝牙使用方法 ==

<li>点击桌面右上角的蓝牙图标

[[File:~~media/image232~~pi3b-img232.png~~|330x128px~~]]</li>

<li>然后选择适配器

[[File:~~media/image233~~pi3b-img233.png~~|375x165px~~]]</li>

<li>如果有提示下面的界面，请选择'''Yes'''

[[File:~~media/image234~~pi3b-img234.png~~|248x85px~~]]</li>

<li>然后在蓝牙的适配器设置界面中设置'''Visibility Setting'''为'''Always visible'''，然后关闭即可

[[File:~~media/image235~~pi3b-img235.png~~|243x229px~~]]</li>

<li>然后打开蓝牙设备的配置界面

[[File:~~media/image236~~pi3b-img236.png~~|438x179px~~]]</li>

<li>点击'''Search'''即可开始扫描周围的蓝牙设备

[[File:~~media/image237~~pi3b-img237.png~~|322x217px~~]]</li></ol>

<li>然后选择想要连接的蓝牙设备，再点击鼠标右键就会弹出对此蓝牙设备的操作界面，选择'''Pair'''即可开始配对，这里演示的是和Android手机配对

[[File:~~media/image238~~pi3b-img238.png~~|338x263px~~]]</li>

<li>配对时，桌面的右上角会弹出配对确认框，选择'''Confirm'''确认即可，此时手机上也同样需要进行确认

[[File:~~media/image239~~pi3b-img239.png~~|417x152px~~]]</li>

<li>和手机配对完后，可以选择已配对的蓝牙设备，然后右键选择'''Send a File'''即可开始给手机发送一张图片

[[File:~~media/image240~~pi3b-img240.png~~|439x259px~~]]</li>

<li>发送图片的界面如下所示

[[File:~~media/image241~~pi3b-img241.png~~|437x253px~~]]</li></ol>

== USB接口测试 ==

支持2.4G WIFI+BT4.0

| [[File:~~media/image2%2042~~pi3b-img242.png]]

|-

| 2

支持2.4G +5G WIFI

| [[File:~~media/image2%2043~~pi3b-img243.png]]

|-

| 3

| <div class="figure">

[[File:~~media/image24%204~~pi3b-img244.~~jpeg|tb_imag e_share_1670833201 123~~png]]

</div>

<li>首先将RTL8723BU无线网卡模块插入开发板的USB接口中</li>

<li>~~然后linux系统会自动加载RTL8723BU蓝牙和WIFI相关的内核模块，通过lsmod命令可以看到下面内核模块已自动加载~~然后Linux系统会自动加载RTL8723BU蓝牙和WIFI相关的内核模块，通过lsmod命令可以看到下面内核模块已自动加载

{| class="wikitable" style="width:800px;"

|-

</li>

<li>在桌面中也可以看到出现了蓝牙图标，此时蓝牙还未打开，所以会显示一个红色的'''x'''

[[File:~~media/image245~~pi3b-img245.png~~|576x157px~~]]</li>

<li>点击'''Turn Bluetooth On'''可以打开蓝牙

[[File:~~media/image246~~pi3b-img246.png~~|576x262px~~]]</li>

<li>打开蓝牙后的显示如下所示

[[File:~~media/image247~~pi3b-img247.png~~|576x164px~~]]</li>

<li>蓝牙的测试方法请参看[[Orange Pi 3B#蓝牙使用方法|'''蓝牙使用方法''']]一节，这里不再赘述</li></ol>

<li>首先将RTL8811无线网卡模块插入开发板的USB接口中</li>

<li>~~然后linux系统会自动加载RTL8811~~ 然后Linux系统会自动加载RTL8811 WIFI相关的内核模块，通过lsmod命令可以看到下面内核模块已自动加载

{| class="wikitable" style="width:800px;"

|-

</li></ol>

<li>~~linux系统会自动加载rtl8821cu蓝牙和wifi相关的内核模块，通过lsmod命令可以看到下面内核模块已自动加载~~Linux系统会自动加载rtl8821cu蓝牙和wifi相关的内核模块，通过lsmod命令可以看到下面内核模块已自动加载

{| class="wikitable" style="width:800px;"

|-

</li>

<li>在桌面中也可以看到出现了蓝牙图标，此时蓝牙还未打开，所以会显示一个红色的'''x'''

[[File:~~media/image245~~pi3b-img245.png~~|576x157px~~]]</li>

<li>点击'''Turn Bluetooth On'''可以打开蓝牙

[[File:~~media/image246~~pi3b-img246.png~~|576x262px~~]]</li>

<li>打开蓝牙后的显示如下所示

[[File:~~media/image247~~pi3b-img247.png~~|576x164px~~]]</li>

<li>蓝牙的测试方法请参看[[Orange Pi 3B#蓝牙使用方法|'''蓝牙使用方法''']]一节，这里不再赘述</li></ol>

<li>首先需要准备一个下图所示的或者类似的支持UVC协议的USB摄像头，然后将USB摄像头插入到Orange Pi开发板的USB接口中

[[File:~~media/image13~~pi3b-img13.png~~|259x150px~~]]</li>

<li>通过v4l2-ctl命令可以看到USB摄像头的设备节点信息为/dev/video0

{| class="wikitable" style="width:800px;"

</li>

<li>在桌面系统中可以使用Cheese直接打开USB摄像头，Cheese打开方法如下图所示：

[[File:~~media/image248~~pi3b-img248.png~~|474x302px~~]]

Cheese打开USB摄像头后的界面如下图所示：

[[File:~~media/image249~~pi3b-img249.png~~|473x277px~~]]</li>

<li>使用fswebcam测试USB摄像头的方法

<li>b) --no-banner用于去除照片的水印</li>

<li>c) -r 选项用于指定照片的分辨率</li>

<li>d) -S ~~选项用设置于跳过前面的帧数~~选项用于设置跳过前面的帧数</li>

<li>e) ./image.jpg 用于设置生成的照片的名字和路径

{| class="wikitable" style="width:800px;"

</li></ol>

</li>

<li>~~在服务器版的linux系统中，拍完照后可以使用scp命令将拍好的图片传到Ubuntu~~ 在服务器版的Linux系统中，拍完照后可以使用scp命令将拍好的图片传到Ubuntu PC上镜像观看

{| class="wikitable" style="width:800px;"

|-

|}

</li>

<li>~~在桌面版的linux系统中，可以通过HDMI显示器直接查看拍摄的图片~~在桌面版的Linux系统中，可以通过HDMI显示器直接查看拍摄的图片</li></ol>

</li></ol>

<li>首先打开文件管理器

[[File:~~media/image250~~pi3b-img250.png~~|357x176px~~]]</li>

<li>然后找到下面这个文件（如果系统中没有这个音频文件，可以自己上传一个音频文件到系统中）

[[File:~~media/image251~~pi3b-img251.png~~|283x225px~~]]</li>

<li>然后选中audio.wav文件，右键选择使用vlc打开就可以开始播放

[[File:~~media/image252~~pi3b-img252.png~~|288x234px~~]]</li>

<li>切换HDMI播放和耳机播放等不同音频设备的方法

<li>首先打开音量控制界面

[[File:~~media/image253~~pi3b-img253.png~~|308x169px~~]]</li>

<li>播放音频的时候，在'''Playback'''中会显示播放软件可以使用的音频设备选项，如下图所示，在这里可以设置需要播放到哪个音频设备

[[File:~~media/image254~~pi3b-img254.png~~|576x282px~~]]</li></ol>

</li></ol>

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

[[File:~~media/image255~~pi3b-img255-1.png~~|395x112px~~]]</li><li>然后可以通过'''aplay -l'''~~命令可以查看下linux系统支持的声卡设备，从下面的输出可知，~~命令可以查看下Linux系统支持的声卡设备，从下面的输出可知，'''card 0'''为rk809的声卡设备，也就是耳机的声卡设备

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''aplay -l'''        '''（-I是大写的I不是小写的L）'''

**** List of PLAYBACK Hardware Devices ****

'''card 0: rockchiprk809 [rockchip-rk809], device 0: dailink-multicodecs rk817-hifi-0 [dailink-multicodecs rk817-hifi-0]'''

<li>Orange Pi 3B开发板40 pin接口引脚的顺序请参考下图

[[File:~~media/image256~~pi3b-img256.png~~|400x124px~~]]</li>

<li>Orange Pi 3B开发板40 pin接口引脚的功能如下表所示

<li>下面是40pin完整的引脚图

[[File:~~media/image257~~pi3b-img257-1.png~~|575x160px~~]]</li>

<li>下面的表格是上面完整表格左半边部分的图，能看得清楚点

[[File:~~media/image258~~pi3b-img258-1.png~~|478x267px~~]]</li>

<li>下面的表格是上面完整表格右半边部分的图，能看得清楚点

[[File:~~media/image259~~pi3b-img259-1.png~~|479x266px~~]]</li></ol>

</li>

<li>40pin接口中总共有'''28'''个GPIO口，所有GPIO口的电压都是'''3.3v'''</li></ol>

|-

|

<big>'''注意，Orange ~~Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。~~Pi发布的Linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。'''

'''编译好的wiringOP的deb包在orangepi-build中的存放路径为：'''

[[File:~~media/image260~~pi3b-img260-1.png|750px|center]]

</div>

[[File:~~media/image260~~pi3b-img260-1.png~~|575x355px|66AC(IBG%N8L@Y7(1BZPS`N~~]]

</div></li></ol>

|-

|

<big>'''Orange ~~Pi发布的linux系统中有预装一个blink_all_gpio程序，这个程序会设置40pin中的所有28个GPIO口不停的切换高低电平。~~Pi发布的Linux系统中有预装一个blink_all_gpio程序，这个程序会设置40pin中的所有28个GPIO口不停的切换高低电平。'''

<li>开发板40pin中总共有'''28'''~~个GPIO口可以使用，下面以7号引脚——对应GPIO为GPIO4_A4~~ 个GPIO口可以使用，下面以7号引脚——对应GPIO为GPIO4_C3 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平[[File:~~media/image261~~pi3b-img261-1.png~~|576x120px~~]]</li>

<li>首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号

{| class="wikitable" style="width:800px;"

|}

使用gpio readall可以看到7号引脚的值(V)变为了0

[[File:~~media/image262~~pi3b-img262-1.png~~|576x120px~~]]</li>

<li>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功

{| class="wikitable" style="width:800px;"

|}

使用gpio readall可以看到7号引脚的值(V)变为了1

[[File:~~media/image263~~pi3b-img263-1.png~~|576x118px~~]]</li>

<li>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可</li></ol>

<big>'''注意，Orange Pi 3B下面4个GPIO引脚因为外部有3.3V上拉，所以设置下拉是无效的，其它的引脚可以正常设置上下拉电阻功能'''</big>

[[File:~~media/image264~~pi3b-img264-1.png|750px|center]]

|}

<li>下面以11号引脚——对应GPIO为GPIO3_C6 ——对应wPi序号为5——为例演示如何设置GPIO口的上下拉电阻

[[File:~~media/image265~~pi3b-img265-1.png~~|576x147px~~]]</li>

<li>首先需要设置GPIO口为输入模式，其中第三个参数需要输入引脚对应的wPi的序号

{| class="wikitable" style="width:800px;"

<li>由40pin接口的原理图可知，Orange Pi 3B可用的spi为spi3

[[File:~~media/image266~~pi3b-img266-1.png~~|577x193px~~]]~~{| class="wikitable" style="background-color:#ffffdc;width:800px;"~~ |-| ~~<big>'''在linux系统中，40pin中的spi3默认是关闭的，需要手动打开才能使用。'''~~ ~~'''在/boot/orangepiEnv.txt中加入下面红色字体部分的配置，然后重启Linux系统就可以打开spi3。'''~~ ~~orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt''''''overlays=spi3-m0-cs0-spidev'''</big>~~|}

</li>

<li>~~先查看下linux系统中是否存在~~在linux系统中，40 pin中的SPI默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''~~spidev3.0~~orangepi-config'''~~的设备节点，如果存在，说明SPI3已经设置好了，可以直接使用~~，普通用户记得加'''sudo'''权限

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~ls /dev/spidev3.0~~sudo orangepi-config'''~~/dev/spidev3.0~~

|}

</li>

<li>然后选择'''System'''[[File:pi3b-1.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-2.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的SPI的配置[[File:pi3b-3.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-4.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-5.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-6.png]]</li></ol></li><li>重启后进入系统先查看下Linux系统中是否存在'''spidev3.0'''的设备节点，如果存在，说明SPI3已经设置好了，可以直接使用{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''ls /dev/spidev3.0'''/dev/spidev3.0|}</li><li>先不短接SPI3的mosi和miso两个引脚，运行spidev_test的输出结果如下所示，可以看到TX和RX的数据不一致{| class="wikitable" style="width:800px;" |-

|

orangepi@orangepi:~$ '''sudo spidev_test -v -D /dev/spidev3.0'''

</li>

<li>然后短接SPI3的mosi（40pin接口中的第19号引脚）和miso（40pin接口中的第21号引脚）两个引脚再运行spidev_test的输出如下，可以看到发送和接收的数据一样

[[File:~~media/image267~~pi3b-img267.png~~|577x83px~~]]

{| class="wikitable" style="width:800px;"

|-

<li>由下表可知，Orange Pi 3B可用的i2c为i2c2、i2c3和i2c4共三组 i2c总线

[[File:~~media/image268~~pi3b-img268-1.png~~|576x160px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<big>'''从上表中可以看到，i2c4_m0和spi3_m0是引脚复用的，两者不能同时打开，i2c3_m0和uart3_m0也是引脚复用的，两者不能同时打开'''</big>

|}

</li><li>在linux系统中，40 pin中的I2C总线默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限{| class="wikitable" style="~~background-color:#ffffdc;~~width:800px;"

|-

|

~~<big>'''在linux系统中，40pin中的i2c默认都是关闭的，需要手动打开才能使用。'''~~ '''在/boot/orangepiEnv.txt中加入下面红色字体部分的配置，然后重启Linux系统就可以同时打开i2c2、i2c3和i2c4，如果只需要打开一个，那么就填写一个即可。''' orangepi@orangepi:~$ '''sudo ~~vim /boot/orangepiEnv.txt''''''overlays=i2c2-m1 i2c3-m0 i2c4~~orangepi-~~m0~~config'''</p~~></big~~>

|}

</li>

<li>~~启动linux系统后，先确认下~~然后选择'''System'''[[File:pi3b-1-1.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-2-1.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的I2C的配置[[File:pi3b-3-1.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-4-1.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-5-1.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-6-1.png]]</li></ol></li><li>启动Linux系统后，先确认下/dev下存在i2c的设备节点

{| class="wikitable" style="width:800px;"

|-

[[File:~~media/image269~~pi3b-img269.png~~|476x179px|UN}~]Q}T_70O%Z%RNO8R@YE~~]]

</div></ol>

<li>由下表可知，Orange Pi 3B可用的uart为uart3、uart7和uart9共三组uart总线

[[File:~~media/image270~~pi3b-img270-1.png~~|575x160px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''从上表中可以看到，i2c3_m0和uart3_m0是引脚复用的，两者不能同时打开'''</big>

|}

~~{| class="wikitable" style="background-color:#ffffdc;width:800px;"~~

|-

|

~~<big>'''在linux系统中，40pin中的uart默认都是关闭的，需要手动打开才能使用。'''~~

'''在/boot/orangepiEnv.txt中加入下面红色字体部分的配置，然后重启Linux系统就可以同时打开uart3、uart7、和uart9，如果只需要打开一个，那么就填写一个即可。'''

~~orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''~~

~~'''overlays=uart3-m0 uart7-m2 uart9-m2'''</big>~~

|}

</li>

<li>~~进入linux系统后，先确认下~~在linux系统中，40 pin中的UART默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：</~~dev下是否存在对应uart的设备节点~~p><ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''sudo orangepi-config'''|}</li><li>然后选择'''System'''[[File:pi3b-1-2.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-2-2.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的UART的配置[[File:pi3b-3-2.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-4-2.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-5-2.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-6-2.png]]</li></ol></li><li>进入Linux系统后，先确认下/dev下是否存在对应uart的设备节点{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~# '''ls /dev/ttyS*'''/dev/ttyS1 '''/dev'''/'''ttyS3 /dev/ttyS7 /dev/ttyS9'''

|}

</li>

| 对应27号引脚

| 对应15号引脚

| ~~对应7号引脚~~对应22号引脚

|}

[[File:~~media/image271~~pi3b-img271-1.png~~|545x134px~~]]

</ol>

<li>由下表可知，Orange Pi ~~3B可用的pwm11~~3B可用的pwm11和pwm15共两路pwm[[File:~~media/image272~~pi3b-img272-1.png~~|575x160px~~]]</li><li>在linux系统中，40 pin中的PWM默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限{| class="wikitable" style="~~background-color:#ffffdc;~~width:800px;"

|-

|

~~<big>'''在linux系统中，40pin中的pwm默认都是关闭的，需要手动打开才能使用。'''~~ ~~'''在/boot/orangepiEnv.txt中加入下面红色字体部分的配置，然后重启Linux系统就可以打开pwm11。'''~~ orangepi@orangepi:~$ '''sudo ~~vim /boot/orangepiEnv.txt''''''overlays=pwm11~~orangepi-~~m1~~config'''</p~~></big~~>

|}

</li>

<li>然后选择'''System'''[[File:pi3b-1-3.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-2-3.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的PWM的配置[[File:pi3b-3-3.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-4-3.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-5-3.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-6-3.png]]</li></ol></li><li>当打开一个pwm后，在'''/sys/class/pwm/'''~~中就会多出一个pwmchipX（X为具体的的数字）~~中就会多出一个pwmchipX（X为具体的的数字），比如打开pwm11后，查看/sys/class/pwm/下的pwmchipX会由一个变成了两个

{| class="wikitable" style="width:800px;"

|-

|}

</li>

<li>上面哪个pwmchip对应pwm11呢，我们先查看下 '''ls /sys/class/pwm/ -l'''命令的输出，如下所示：~~</li><li>pwm11寄存器的基地址为fe6f0030，再看 '''ls /sys/class/pwm/ -l'''命令的输出，可以看到pwmchip1中链接到了fe6f0030.pwm，所以pwm11对应pwmchip为pwmchip1~~

[[File:~~media/image273~~pi3b-img273.png~~|576x46px|RCUS$_~VYM{4ZS]_L}DNZQR~~]]

</div></li><li>然后由下表可知，pwm11寄存器的基地址为fe6f0030，再看 '''ls /sys/class/pwm/ -l'''命令的输出，可以看到pwmchip1中链接到了fe6f0030.pwm，所以pwm11对应pwmchip为pwmchip1</li>

<li>然后使用下面的命令可以让pwm11输出一个50Hz的方波（请先切换到root用户，再执行下面的命令）</li>

|}

[[File:~~media/image274~~pi3b-img274.png~~|575x346px~~]]<li>上面演示的pwm11的测试方法，其他pwm测试方法都是类似的。</li>

</ol>

[[File:~~media/image260~~pi3b-img260-1.png|center]]

</div>

<li>下面以7号引脚——对应GPIO为GPIO4_A4 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平

[[File:~~media/image261~~pi3b-img261.png~~|576x120px~~]]</li>

<li>直接用命令测试的步骤如下所示：

<li>由40pin接口的原理图可知，Orange Pi 3B可用的spi为spi3

[[File:~~media/image266~~pi3b-img266-1.png~~|577x193px~~]]</li><li>在linux系统中，40 pin中的SPI默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限{| class="wikitable" style="~~background-color:#ffffdc;~~width:800px;"

|-

|

~~<big>'''在linux系统中，40pin中的spi3默认是关闭的，需要手动打开才能使用。'''~~ ~~'''在/boot/orangepiEnv.txt中加入下面红色字体部分的配置，然后重启Linux系统就可以打开spi4。'''~~ orangepi@orangepi:~$ '''sudo ~~vim /boot/orangepiEnv.txt''''''overlays=spi3-m0-cs0~~orangepi-~~spidev~~config'''</p~~></big~~>

|}

</li>

<li>~~先查看下linux系统中是否存在~~然后选择'''System'''[[File:pi3b-1-4.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-2-4.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的SPI的配置[[File:pi3b-3-4.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-4-4.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-5-4.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-6-4.png]]</li></ol></li><li>先查看下Linux系统中是否存在'''spidev3.0'''的设备节点，如果存在，说明SPI3已经设置好了，可以直接使用{| class="wikitable" style="width:800px;"

|-

|

<li>由下表可知，Orange Pi 3B可用的i2c为i2c2、i2c3和i2c4共三组 i2c总线

[[File:~~media/image268~~pi3b-img268-1.png~~|576x160px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<big>'''从上表中可以看到，i2c4_m0和spi3_m0是引脚复用的，两者不能同时打开，i2c3_m0和uart3_m0也是引脚复用的，两者不能同时打开'''</big>

|}

</li><li>在linux系统中，40 pin中的I2C总线默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限{| class="wikitable" style="~~background-color:#ffffdc;~~width:800px;"

|-

|

~~<big>'''在linux系统中，40pin中的i2c默认都是关闭的，需要手动打开才能使用。'''~~ '''在/boot/orangepiEnv.txt中加入下面红色字体部分的配置，然后重启Linux系统就可以同时打开i2c2、i2c3和i2c4，如果只需要打开一个，那么就填写一个即可。''' orangepi@orangepi:~$ '''sudo ~~vim /boot/orangepiEnv.txt''''''overlays=i2c2-m1 i2c3-m0 i2c4~~orangepi-~~m0~~config'''</p~~></big~~>

|}

</li>

<li>~~启动linux系统后，先确认下~~然后选择'''System'''[[File:pi3b-1-5.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-2-5.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的I2C的配置[[File:pi3b-3-5.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-4-5.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-5-5.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-6-5.png]]</li></ol></li><li>启动Linux系统后，先确认下/dev下存在i2c的设备节点

{| class="wikitable" style="width:800px;"

|-

|}

[[File:~~media/image275~~pi3b-img275.png~~|180x153px~~]]

</ol>

[[File:~~media/image276~~pi3b-img276.png~~|464x174px|V@(61L~0})Q`8VLBCAYEP[2~~]]

</div></li>

<li>由下表可知，Orange Pi 3B可用的uart为uart3、uart7和uart9共三组uart总线

[[File:~~media/image270~~pi3b-img270-1.png~~|575x160px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<big>'''从上表中可以看到，i2c3_m0和uart3_m0是引脚复用的，两者不能同时打开'''</big>

|}

</li><li>在linux系统中，40 pin中的UART默认都是关闭的，需要手动打开才能使用。详细步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限{| class="wikitable" style="~~background-color:#ffffdc;~~width:800px;"

|-

|

~~<big>'''在linux系统中，40pin中的uart默认都是关闭的，需要手动打开才能使用。'''~~ '''在/boot/orangepiEnv.txt中加入下面红色字体部分的配置，然后重启Linux系统就可以同时打开uart3、uart7、和uart9，如果只需要打开一个，那么就填写一个即可。''' orangepi@orangepi:~$ '''sudo ~~vim /boot/orangepiEnv.txt''''''overlays=uart3-m0 uart7-m2 uart9~~orangepi-~~m2~~config'''</p~~></big~~>

|}

</li>

<li>~~进入linux系统后，先确认下~~然后选择'''System'''[[File:pi3b-1-6.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-2-6.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用空格选中想要打开的UART的配置[[File:pi3b-3-6.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-4-6.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-5-6.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-6-6.png]]</li></ol></li><li>进入Linux系统后，先确认下/dev下是否存在对应uart的设备节点

{| class="wikitable" style="width:800px;"

|-

| 对应27号引脚

| 对应15号引脚

| ~~对应7号引脚~~对应22号引脚

|}

</ol>

== 硬件看门狗测试 ==

Orange ~~Pi发布的linux系统中预装了watchdog_test程序，可以直接测试。~~Pi发布的Linux系统中预装了watchdog_test程序，可以直接测试。

运行watchdog_test程序的方法如下所示：

[[File:~~media/image277~~pi3b-img277.png~~|527x211px|IMG_256~~]]

</div></ol>

[[File:~~media/image91~~pi3b-img91.png~~|507x249px|IMG_256~~]]

</div></li>

[[File:~~media/image278~~pi3b-img278.png~~|429x263px|IMG_256~~]]

</div></ol>

</li>

<li>然后选中AppImage版本balenaEtcher，再点击鼠标右键，再点击Execute就可以打开balenaEtcher了

[[File:~~media/image279~~pi3b-img279.png~~|145x118px~~]]</li></ol>

</li></ol>

<li>首先需要扩展下'''/tmp'''空间的大小，设置完后需要'''~~重启下开发板的linux系统~~重启下开发板的Linux系统'''，命令如下所示：

{| class="wikitable" style="width:800px;"

|-

|}

</li>

<li>~~然后在linux系统中输入下面的命令就可以开始宝塔的安装~~然后在Linux系统中输入下面的命令就可以开始宝塔的安装

{| class="wikitable" style="width:800px;"

|-

</li>

<li>然后要做的就是耐心等待，当看到终端输出下面的打印信息时，说明宝塔已经安装完成，整个安装过程大约耗时34分钟，根据网络速度的不同可能会有一些差别

[[File:~~media/image280~~pi3b-img280.png~~|576x233px~~]]</li>

<li>此时在浏览器中输入上面显示的'''面板地址'''就可以打开宝塔Linux面板的登录界面，然后在对应的位置输入上图显示的'''username'''和'''password'''就可以登录进宝塔

[[File:~~media/image281~~pi3b-img281.png~~|575x281px~~]]</li>

<li>成功登录宝塔后的会弹出下面的欢迎界面，首先请将中间的用户须知阅读完拖到最下面，然后就可以选择”我已同意并阅读《用户协议》“，接着点击”进入面板”就可以进入宝塔了

[[File:~~media/image282~~pi3b-img282.png~~|575x317px~~]]</li>

<li>进入宝塔后首先会提示需要绑定宝塔官网的账号，如果没有账号可以去宝塔的官网（'''https://www.bt.cn'''）注册一个

[[File:~~media/image283~~pi3b-img283.png~~|576x300px~~]]</li>

<li>最终显示的界面如下图所示，可以很直观的看到开发板Linux系统的一些状态信息，比如负载状态、CPU的使用率、内存使用率和存储空间的使用情况等

[[File:~~media/image284~~pi3b-img284.png~~|575x306px~~]]</li>

<li>宝塔的更多功能可以参考下面资料自行探索

{| class="wikitable" style="width:800px;"

|}

</li>

<li>然后在弹出的界面中选择'''zh_CN.UTF-8 ~~>~~ UTF-8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''<OK>'''，然后回车即可）[[File:~~media/image285~~pi3b-img285.png~~|575x296px~~]]</li>

<li>然后设置默认'''locale'''为'''zh_CN.UTF-8'''

[[File:~~media/image286~~pi3b-img286.png~~|575x160px~~]]</li>

<li>退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示

{| class="wikitable" style="width:800px;"

</li>

<li>然后打开'''Input Method'''

[[File:~~media/image287~~pi3b-img287.png~~|575x361px~~]]</li>

<li>然后选择'''OK'''

[[File:~~media/image288~~pi3b-img288.png~~|295x212px~~]]</li>

<li>然后选择'''Yes'''

[[File:~~media/image289~~pi3b-img289.png~~|303x192px~~]]</li>

<li>然后选择'''fcitx'''

[[File:~~media/image290~~pi3b-img290.png~~|307x220px~~]]</li>

<li>然后选择'''OK'''

[[File:~~media/image291~~pi3b-img291.png~~|305x216px~~]]</li>

<li>'''然后重启Linux系统才能使配置生效'''</li>

<li>然后打开'''Fcitx configuration'''

[[File:~~media/image292~~pi3b-img292.png~~|575x376px~~]]</li>

<li>然后点击下图所示位置的'''+'''号

[[File:~~media/image293~~pi3b-img293.png~~|280x187px~~]]</li>

<li>然后搜索'''Google Pinyin'''再点击'''OK'''

[[File:~~media/image294~~pi3b-img294.png~~|291x196px~~]]</li>

<li>然后将'''Google Pinyin'''放到最前面

[[File:~~media/image295~~pi3b-img295.png~~|299x202px~~]][[File:~~media/image296~~pi3b-img296.png~~|300x202px~~]]</li>

<li>然后打开'''Geany'''这个编辑器测试下中文输入法

[[File:~~media/image297~~pi3b-img297.png~~|349x212px~~]]</li>

<li>中文输入法测试如下所示

[[File:~~media/image298~~pi3b-img298.png~~|575x325px~~]]</li>

<li>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</li>

<li>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CN.UTF-8'''

</li>

<li>然后'''重启系统'''就能看到系统显示为中文了

[[File:~~media/image299~~pi3b-img299.png~~|576x356px~~]]</li></ol>

<li>首先打开'''Language Support'''

[[File:~~media/image300~~pi3b-img300.png~~|575x351px~~]]</li>

<li>然后找到'''汉语（中国）'''选项

[[File:~~media/image301~~pi3b-img301.png~~|318x311px~~]]</li>

<li>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：

[[File:~~media/image302~~pi3b-img302.png~~|324x320px~~]]</li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

<li>然后选择'''Apply System-Wide'''将中文设置应用到整个系统

[[File:~~media/image303~~pi3b-img303.png~~|321x316px~~]]</li>

<li>然后设置'''Keyboard input method system'''为'''fcitx'''

[[File:~~media/image304~~pi3b-img304.png~~|327x320px~~]]</li>

<li>'''然后重启Linux系统使配置生效'''</li>

<li>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文

[[File:~~media/image305~~pi3b-img305.png~~|303x247px~~]]</li>

<li>然后可以看到桌面都显示为中文了

[[File:~~media/image306~~pi3b-img306.png~~|575x383px~~]]</li>

<li>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示

[[File:~~media/image307~~pi3b-img307.png~~|576x292px~~]]</li>

<li>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了

[[File:~~media/image308~~pi3b-img308.png~~|575x308px~~]]</li></ol>

<li>首先打开'''Language Support'''

[[File:~~media/image300~~pi3b-img300.png~~|575x351px~~]]</li>

<li>然后找到'''汉语（中国）'''选项

[[File:~~media/image309~~pi3b-img309.png~~|335x326px~~]]</li>

<li>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：

[[File:~~media/image310~~pi3b-img310.png~~|337x331px~~]]</li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<li>然后选择'''Apply System-Wide'''将中文设置应用到整个系统

[[File:~~media/image311~~pi3b-img311.png~~|336x330px~~]]</li>

<li>'''然后重启Linux系统使配置生效'''</li>

<li>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文

[[File:~~media/image305~~pi3b-img305.png~~|303x247px~~]]</li>

<li>然后可以看到桌面都显示为中文了

[[File:~~media/image306~~pi3b-img306.png~~|575x383px~~]]</li>

<li>然后打开Fcitx5配置程序

[[File:~~media/image312~~pi3b-img312.png~~|575x349px~~]]</li>

<li>然后选择使用拼音输入法

[[File:~~media/image313~~pi3b-img313.png~~|366x289px~~]]</li>

<li>选择后的界面如下所示，再点击确定即可

[[File:~~media/image314~~pi3b-img314.png~~|366x290px~~]]</li>

<li>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示

[[File:~~media/image307~~pi3b-img307.png~~|576x292px~~]]</li>

<li>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了

[[File:~~media/image315~~pi3b-img315.png~~|576x408px~~]]</li></ol>

|-

|

'''https://downloads.nomachine.com/download/?id=~~118~~116&~~amp;~~distro=ARM'''

|}

[[File:~~media/image316~~pi3b-img316.png~~|575x227px~~]]

</ol>

<li>另外在'''官方工具'''中也可以下载到'''NoMachine'''的安装包

[[File:~~media/image317~~pi3b-img317.png~~|86x106px~~]]

先进入'''远程登录软件-NoMachine'''文件夹

[[File:~~media/image318~~pi3b-img318.png~~|256x46px~~]]

然后下载arm64版本的deb安装包

[[File:~~media/image319~~pi3b-img319.png~~|180x109px~~]]</li>

<li>然后将下载的'''nomachine_x.x.x_x_arm64.deb'''上传到开发板的Linux系统中</li>

<li>然后使用下面的命令在开发板的Linux系统中安装'''NoMachine'''

|-

|

'''https://downloads.nomachine.com/download/?id=98'''

|}

[[File:~~media/image320~~pi3b-img320.png~~|575x163px~~]]

</ol>

<li>然后在Windows中安装NoMachine，'''安装完后请重启下电脑'''</li>

<li>然后在Window中打开'''NoMachine'''

[[File:~~media/image321~~pi3b-img321.png~~|76x66px~~]]</li>

<li>NoMachine启动后会自动扫描局域网内其他安装有NoMachine的设备，进入NoMachine的主界面后就可以看到开发板已经在可连接的设备列表里了，然后点击下图红色方框所示的位置即可开始登录开发板的Linux系统桌面

[[File:~~media/image322~~pi3b-img322.png~~|321x92px~~]]</li>

<li>然后点击'''OK'''

[[File:~~media/image323~~pi3b-img323.png~~|402x275px~~]]</li>

<li>然后在下图对应的位置输入开发板Linux系统的用户名和密码，再点击'''OK'''开始登陆

[[File:~~media/image324~~pi3b-img324.png~~|406x274px~~]]</li>

<li>然后在接下来的界面中都点击OK</li>

<li>最后就能看到开发板Linux系统的桌面了

[[File:~~media/image325~~pi3b-img325.png~~|411x246px~~]]</li></ol>

|-

|

<big>'''~~操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。~~操作前请先确保Windows电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''

'''Ubuntu20.04测试VNC很多问题，请不要使用这种方法。'''</big>

<li>首先点击Session，然后选择VNC，再填写开发板的IP地址和端口，最后点击OK确认</li>

[[File:~~media/image326~~pi3b-img326.png~~|576x410px~~]]

</ol>

<li>然后输入前面设置的VNC的密码

[[File:~~media/image327~~pi3b-img327.png~~|274x131px~~]]</li><li>~~登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了~~登录成功后的界面显示如下图所示，然后就可以远程操作开发板Linux系统的桌面了[[File:~~media/image328~~pi3b-img328.png~~|405x293px~~]]</li></ol>

</li></ol>

=== ~~Ubuntu Focal系统~~ Debian Bookworm系统 ===

<li>~~Ubuntu Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序~~Debian Bookworm默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序

<li>gcc的版本如下所示

|-

|

~~~~orangepi@orangepi:~$ '''gcc --version'''~~~~gcc (~~Ubuntu 9~~Debian 12.42.0-~~1ubuntu1~20.04.1~~14) 912.42.0~~~~Copyright (C) ~~2019~~ 2022 Free Software Foundation, Inc.~~~~This is free software; see the source for copying conditions. There is NO~~~~warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.~~~~

|}

</li>

</li></ol>

</li>

<li>~~Ubuntu Focal默认安装有Python3~~Debian Bookworm默认安装有Python3

<li>~~Python3具体版本如下所示~~Python具体版本如下所示

{| class="wikitable" style="width:800px;"

|-

|

~~~~orangepi@orangepi:~$ '''python3'''~~~~Python 3.811.10 2 (~~default~~main, ~~Nov 14 2022~~Mar 13 2023, 12:5918:4729)~~~~[GCC 912.42.0] on linux~~~~Type ~~"~~"help~~"~~", ~~"~~"copyright~~"~~", ~~"~~"credits~~"~~ " or ~~"~~"license~~"~~ " for more information.~~</p~~ >>>|}{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <pbig>~~>>>~~'''使用Ctrl+D快捷键可退出python的交互模式。'''</pbig>

|}

</li>

</li></ol>

</li>

<li>~~Ubuntu Focal默认没有安装Java的编译工具和运行环境~~Debian Bookworm默认没有安装Java的编译工具和运行环境

<li>~~可以使用下面的命令安装openjdk~~可以使用下面的命令安装openjdk，Debian Bookworm中最新版本为openjdk-17

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''java --version'''

~~openjdk 17.0.2 2022-01-18~~

~~OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.04)~~

~~OpenJDK 64-Bit Server VM (build 17.0.2+8-Ubuntu-120.04, mixed mode, sharing)~~

|}

</li>

</li></ol>

~~~~

=== Ubuntu ~~Jammy系统~~ Focal系统 ===

<ol ~~start="1"~~ style="list-style-type: decimal;"><li>Ubuntu ~~Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序~~Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序

<li>gcc的版本如下所示

|

orangepi@orangepi:~$ '''gcc --version'''

gcc (Ubuntu 119.24.0-~~19ubuntu1~~1ubuntu1~20.04.1) ~~'''11~~9.24.0~~'''~~Copyright (C) ~~2021~~ 2019 Free Software Foundation, Inc.

This is free software; see the source for copying conditions. There is NO

warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

</li></ol>

</li>

<li>Ubuntu ~~Jammy默认安装有Python3~~Focal默认安装有Python3

<li>Python3具体版本如下所示

|

orangepi@orangepi:~$ '''python3'''

Python ~~'''~~3.8.10~~.4'''~~ (~~main~~default, ~~Apr 2~~ Nov 14 2022, 0912:0459:1947) [GCC 119.24.0] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>>

</li></ol>

</li>

<li>Ubuntu ~~Jammy默认没有安装Java的编译工具和运行环境~~Focal默认没有安装Java的编译工具和运行环境

<li>可以使用下面的命令安装openjdk-1817

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''sudo apt install -y openjdk-1817-jdk'''

|}

</li>

|

orangepi@orangepi:~$ '''java --version'''

openjdk ~~18-ea~~ 17.0.2 2022-0301-2218OpenJDK Runtime Environment (build ~~18-ea~~17.0.2+368-Ubuntu-1120.04)OpenJDK 64-Bit Server VM (build ~~18-ea~~17.0.2+368-Ubuntu-1120.04, mixed mode, sharing)

|}

</li>

</li></ol>

== ~~QT的安装方法~~ = Ubuntu Jammy系统 ===

<ol start="1" style="list-style-type: decimal;"><li>~~使用下面的脚本可以安装QT5和QT Creator~~Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type: lower-alpha;"><li>gcc的版本如下所示

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~install_qt~~gcc --version'''gcc (Ubuntu 11.2.0-19ubuntu1) '''11.2.sh0'''Copyright (C) 2021 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

|}

</li>

<li>~~安装完后会自动打印QT的版本号<ol style="list-style-type: lower-alpha;"><li>Ubuntu20.04自带的qt版本为~~编写C语言的'''~~5.12~~hello_world.8c'''程序

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~install_qt~~vim hello_world.shc'''#include <stdio.~~.....~~h> ~~QMake version 3.1~~int main(void)~~Using Qt version '''~~{<~~span style="color~~/p>:~~#FF0000"~~~~5.12.8~~printf("Hello World!\n");</~~span~~p> :~~''' in~~ return 0;</~~usr/lib/aarch64-linux-gnu~~p>}

|}

</li>

<li>~~Ubuntu22.04自带的QT版本为~~然后编译运行'''~~5.15~~hello_world.3c'''

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~install_qt~~gcc -o hello_world hello_world.shc'''orangepi@orangepi:~$ '''.~~.....<~~/p>~~QMake version 3.1~~hello_world'''~~Using Qt version '''5.15.3''' in /usr/lib/aarch64-linux-gnu~~Hello World!

|}

</li></ol>

</li>

<li>~~Debian11自带的QT版本为~~Ubuntu Jammy默认安装有Python3<ol style="list-style-type: lower-alpha;"><li>Python3具体版本如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''5python3'''Python '''3.1510.4''' (main, Apr 22022, 09:04:19) [GCC 11.2.0] on linuxType "help", "copyright", "credits" or "license" for more information.>>>|}</li><li>编写Python语言的'''hello_world.py'''程序

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~install_qt~~vim hello_world.shpy'''~~......QMake version 3.1Using Qt version '''5.15.2~~print('Hello World!'~~' in /usr/lib/aarch64-linux-gnu~~)

|}

</li>

<li>~~Debian12自带的QT版本为~~运行'''5hello_world.~~15.8~~py'''的结果如下所示

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~install_qt~~python3 hello_world.shpy'''~~......QMake version 3.1Using Qt version '''5.15.8''' in /usr/lib/aarch64-linux-gnu~~Hello World!

|}

</li></ol>

</li>

<li>~~然后在'''Applications'''中就可以看到QT Creator的启动图标~~Ubuntu Jammy默认没有安装Java的编译工具和运行环境<pol style="list-style-type: lower-alpha;">~~[[File:media/image329.png|576x270px]]~~</pli>~~也可以使用下面的命令打开QT Creator~~可以使用下面的命令安装openjdk-18

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~qtcreator~~sudo apt install -y openjdk-18-jdk'''

|}

</li><li>安装完后可以查看下Java的版本{| class="wikitable" style="~~background-color:#ffffdc;~~width:800px;"

|-

|

~~<big>~~orangepi@orangepi:~$ '''~~在QT和QT应用的启动过程中，如果提示下面的错误，请直接忽略，此错误对应用的运行不会有影响。~~java --version''' ~~'''libGL error: failed to create dri screen''''''libGL error: failed to load driver: rockchip'''~~openjdk 18-ea 2022-03-22~~'''libGL error: failed to create dri screen'''~~OpenJDK Runtime Environment (build 18-ea+36-Ubuntu-1)~~'''libGL error: failed to load driver: rockchip'''~~OpenJDK 64-Bit Server VM (build 18-ea+36-Ubuntu-1, mixed mode, sharing)</p~~></big~~>

|}

</li>

<li>~~QT Creator打开后的界面如下所示[[File:media/image330.png|418x222px]]</li><li>QT Creator的版本如下所示<ol style="list-style-type: lower-alpha;"><li>QT Creator在'''Ubuntu20.04'''中的默认版本如下所示[[File:media/image331.png|419x224px]]</li><li>QT Creator在'''Ubuntu22.04'''中的默认版本如下所示[[File:media/image332.png|443x237px]]</li><li>QT Creator在''~~编写Java版本的'~~Debian11~~''~~'中的默认版本如下所示[[File:media/image333~~hello_world.~~png|444x238px]]</li><li>QT Creator在'~~java''~~Debian12~~'~~''中的默认版本如下所示[[File:media/image334.png|449x277px]]</li></ol></li><li>然后设置下QT<ol style="list-style-type: lower-alpha;"><li>首先打开'''Help'''->'''About Plugins...'''[[File:media/image335.png|573x164px]]</li><li>然后去掉'''ClangCodeModel'''的那个勾[[File:media/image336.png|408x254px]]</li><li>'''设置完后需要重启下QT Creator'''</li><li>然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC~~{| class="wikitable" style="~~background-color:#ffffdc;~~width:800px;" |-

|

~~<big>~~orangepi@orangepi:~$ '''~~Debian12请跳过这步。~~vim hello_world.java'''public class hello_world{:public static void main(String[] args):{::System.out.println("Hello World!");:}}</~~big~~p>

|}

~~[[File:media/image337.png|576x315px]]~~

~~[[File:media/image338.png|575x307px]]</li></ol>~~

</li>

<li>~~然后就可以打开一个示例代码[[File:media/image339.png|575x312px]]</li><li>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明[[File:media/image340.png|576x218px]]</li><li>然后点击下~~然后编译运行'''~~Configure Project~~hello_world.java'''~~[[File:media/image341.png|575x304px]]</li><li>然后点击左下角的绿色三角形编译运行下示例代码[[File:media/image342.png|575x312px]]</li><li>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行[[File:media/image343.png|576x308px]]</li><li>参考资料~~

{| class="wikitable" style="width:800px;"

|-

|

~~[https~~orangepi@orangepi:~~//wiki.qt.io/Install_Qt_5_on_Ubuntu~~ ~$ '''~~https://wiki~~javac hello_world.~~qt.io/Install_Qt_5_on_Ubuntu~~java''']~~[https~~orangepi@orangepi:~~//download.qt.io/archive/qtcreator~~ ~$ '''~~https://download.qt.io/archive/qtcreator~~java hello_world''']~~[https://download.qt.io/archive/qt '''https://download.qt.io/archive/qt''']~~Hello World!

|}

</li></ol>

== ~~ROS安装方法~~ QT的安装方法 ==

<~~span id~~ol style="~~ubuntu20.04安装ros~~list-1style-~~noetic的方法~~type: decimal;"><li>使用下面的脚本可以安装QT5和QT Creator</~~span~~p>~~=== Ubuntu20.04安装ROS 1 Noetic的方法 ===~~ ~~# ROS 1当前活跃的版本如下所示，推荐版本为'''Noetic Ninjemys'''~~ ~~::[[File:media/image344.png|345x235px]]~~ ~~::[[File:media/image345.png|576x210px]]~~ ::{| class="wikitable" style="width:800px;"

|-

|

~~[http~~orangepi@orangepi:~$ '''install_qt.sh'''|}</li><li>安装完后会自动打印QT的版本号</~~docs~~p><ol style="list-style-type: lower-alpha;"><li>Ubuntu20.04自带的qt版本为'''5.~~ros~~12.~~org~~8'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~http://docs.ros~~install_qt.~~org~~sh''']......QMake version 3.1Using Qt version '''~~https~~5.~~ros~~12.~~org~~8</~~Distributions~~span>'''in /usr/lib/aarch64-linux-gnu

|}

<~~ol start="2" style="list-style-type: decimal;"~~/li><li>~~ROS 1~~ Ubuntu22.04自带的QT版本为'''~~Noetic Ninjemys~~5.15.3'''~~官方安装文档链接如下所示：~~

{| class="wikitable" style="width:800px;"

|-

|

~~[http~~orangepi@orangepi:~$ '''install_qt.sh'''</~~/wiki~~p>.....~~ros~~.~~org~~</~~noetic~~p>QMake version 3.1</~~Installation/Ubuntu~~ p>Using Qt version '''~~http~~5.~~ros~~15.~~org/noetic~~3</~~Installation/Ubuntu~~span>''']in /usr/lib/aarch64-linux-gnu

|}

</li>

<li>~~ROS~~ Debian11自带的QT版本为'''~~Noetic Ninjemys'''官方安装文档中Ubuntu推荐使用Ubuntu20~~5.~~04，所以请确保开发板使用的系统为'''Ubuntu20~~15.~~04桌面版系统~~2'''

{| class="wikitable" style="width:800px;"

|-

|

~~[http~~orangepi@orangepi:~$ '''install_qt.sh'''</~~/wiki~~p>.....~~ros~~.~~org~~</~~noetic~~p>QMake version 3.1</~~Installation~~ p>Using Qt version '''~~http~~5.~~ros~~15.~~org~~2</~~noetic/Installation~~span>''']in /usr/lib/aarch64-linux-gnu

|}

~~[[File:media/image346.png|312x176px]]~~</li><li>~~然后使用下面的脚本安装ros1~~Debian12自带的QT版本为'''5.15.8'''

{| class="wikitable" style="width:800px;"

|-

|

orangepi@~~orangepi3b~~orangepi:~$ '''~~install_ros~~install_qt.sh ~~ros1~~'''......QMake version 3.1Using Qt version '''5.15.8''' in /usr/lib/aarch64-linux-gnu

|}

</li></ol>

</li>

<li>~~使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件~~然后在'''Applications'''中就可以看到QT Creator的启动图标[[File:pi3b-img329.png]]也可以使用下面的命令打开QT Creator</lip>{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''qtcreator'''|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''在QT和QT应用的启动过程中，如果提示下面的错误，请直接忽略，此错误对应用的运行不会有影响。'''~~注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。~~</~~span~~p>~~'''~~

'''libGL error: failed to create dri screen'''~~install_ros.sh脚本会尝试修改~~</~~etc~~p>'''libGL error: failed to load driver: rockchip'''</hosts并自动运行下面的命令。但是这种方法无法保证每次都能正常访问github，如果install_ros.sh安装完ros1后有提示下面的错误，请自己想其它办法让开发板的linux系统能正常访问github，然后再手动运行下面的命令。p>'''libGL error: failed to create dri screen''' '''~~https~~libGL error:failed to load driver: rockchip'''</~~raw.githubusercontent.com~~big>|}</~~ros~~li><li>QT Creator打开后的界面如下所示</~~rosdistro~~p>[[File:pi3b-img330.png]]</~~master~~p></~~rosdep~~li><li>QT Creator的版本如下所示</~~osx~~p><ol style="list-style-type: lower-~~homebrew~~alpha;"><li>QT Creator在'''Ubuntu20.~~yaml~~04'''中的默认版本如下所示[[File:pi3b-img331.png]]</li><li>QT Creator在'''~~Hit https~~Ubuntu22.04'''中的默认版本如下所示[[File:pi3b-img332.png]]</li><li>QT Creator在'''Debian11'''中的默认版本如下所示</~~raw~~p>[[File:pi3b-img333.~~githubusercontent~~png]]</li><li>QT Creator在'''Debian12'''中的默认版本如下所示[[File:pi3b-img334.~~com~~png]]</~~ros~~p></~~rosdistro~~li></~~master~~ol></~~rosdep~~li><li>然后设置下QT</~~base~~p><ol style="list-style-type: lower-alpha;"><li>首先打开'''Help'''->'''About Plugins...~~yaml~~'''[[File:pi3b-img335.png]]</li><li>然后去掉'''ClangCodeModel'''的那个勾[[File:pi3b-img336.png]]</li><li>'''~~ERROR: error loading sources list:~~设置完后需要重启下QT Creator'''</li><li>然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC~~::'''<span~~ {| class="wikitable" style="background-color:#~~FF0000~~ffffdc;width:800px;"|-| <big>~~The read operation timed out~~<~~/span~~p>'''Debian12请跳过这步。'''</big>

|}

[[File:pi3b-img337.png]][[File:pi3b-img338.png]]</li></ol></li><li>然后就可以打开一个示例代码[[File:pi3b-img339.png]]</li><li>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明[[File:pi3b-img340.png]]</li><li>然后点击下'''Configure Project'''[[File:pi3b-img341.png]]</li><li>然后点击左下角的绿色三角形编译运行下示例代码[[File:pi3b-img342.png]]</li><li>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行[[File:pi3b-img343.png]]</li><li>参考资料

{| class="wikitable" style="width:800px;"

|-

|

~~orangepi@orangepi~~[https:~$ //wiki.qt.io/Install_Qt_5_on_Ubuntu '''~~source~~ https:/~~opt~~/~~ros~~wiki.qt.io/Install_Qt_5_on_Ubuntu'''][https:/~~noetic~~/~~setup~~download.qt.~~bash~~io/archive/qtcreator '''https://download.qt.io/archive/qtcreator'''][https://download.qt.io/archive/qt '''https://download.qt.io/archive/qt''']|}</li></ol>

~~orangepi@orangepi:~$ '''sudo rosdep init'''~~

~~Wrote /etc/ros/rosdep/sources.list.d/20-default.list~~== ROS安装方法 ==

~~Recommended: please run~~=== Ubuntu20.04安装ROS 1 Noetic的方法 ===

# ROS 1当前活跃的版本如下所示，推荐版本为'''Noetic Ninjemys'''

::~~rosdep update~~[[File:pi3b-img344.png]]

~~orangepi@orangepi~~:~~~$ '''rosdep update'''~~:[[File:pi3b-img345.png]]

~~reading in sources list data from~~ ::{| class="wikitable" style="width:800px;" |-| [http:/~~etc~~/docs.ros.org/ '''http:/~~rosdep~~/~~sources~~docs.~~list~~ros.dorg''']

~~Hit~~ '''https://~~raw~~wiki.~~githubusercontent~~ros.~~com/ros~~org/~~rosdistro/master/rosdep/osx-homebrew.yaml~~Distributions'''|}

~~Hit https~~<ol start="2" style="list-style-type: decimal;"><li>ROS 1 '''Noetic Ninjemys'''官方安装文档链接如下所示：{| class="wikitable" style="width:800px;" |-| [http://~~raw~~wiki.~~githubusercontent~~ros.~~com~~org/noetic/Installation/Ubuntu '''http://wiki.ros.org/~~rosdistro~~noetic/~~master~~Installation/~~rosdep~~Ubuntu''']</~~base~~p>|}</li><li>ROS '''Noetic Ninjemys'''官方安装文档中Ubuntu推荐使用Ubuntu20.04，所以请确保开发板使用的系统为'''Ubuntu20.~~yaml~~04桌面版系统'''{| class="wikitable" style="width:800px;" |-| ~~Hit https~~[http://~~raw~~wiki.~~githubusercontent~~ros.~~com~~org/noetic/Installation '''http://wiki.ros.org/noetic/Installation''']</~~rosdistro~~p>|}[[File:pi3b-img346.png]]</~~master~~p></~~rosdep~~li><li>然后使用下面的脚本安装ros1</~~python~~p>{| class="wikitable" style="width:800px;" |-| orangepi@orangepi3b:~$ '''install_ros.~~yaml~~sh ros1'''|}</li><li>使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件</li>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。'''

~~Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml~~

~~Hit https://raw.githubusercontent~~'''install_ros.~~com/ros/rosdistro/master~~sh脚本会尝试修改/~~releases~~etc/~~fuerte~~hosts并自动运行下面的命令。但是这种方法无法保证每次都能正常访问github，如果install_ros.~~yaml~~sh安装完ros1后有提示下面的错误，请自己想其它办法让开发板的Linux系统能正常访问github，然后再手动运行下面的命令。'''

~~Query rosdistro index https://raw.githubusercontent.com/ros/rosdistro/master/index-v4.yaml~~

~~Skip end~~'''https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-~~of-life distro "ardent"~~homebrew.yaml'''

~~Skip end-of-life distro "bouncy"~~'''Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml'''

~~Skip end-of-life distro "crystal"~~'''ERROR: error loading sources list:'''

::'''The read operation timed out'''</big>|} {| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''source /opt/ros/noetic/setup.bash''' orangepi@orangepi:~$ '''sudo rosdep init''' Wrote /etc/ros/rosdep/sources.list.d/20-default.list Recommended: please run ::rosdep update orangepi@orangepi:~$ '''rosdep update''' reading in sources list data from /etc/ros/rosdep/sources.list.d Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/python.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml Hit https://raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.yaml Query rosdistro index https://raw.githubusercontent.com/ros/rosdistro/master/index-v4.yaml Skip end-of-life distro "ardent" Skip end-of-life distro "bouncy" Skip end-of-life distro "crystal" Skip end-of-life distro "dashing"

Skip end-of-life distro "eloquent"

</li>

<li>运行完'''test_ros.sh'''脚本后，会弹出下图所示的一个小海龟

[[File:~~media/image347~~pi3b-img347.png~~|576x276px~~]]</li>

<li>然后请保持刚才打开终端窗口在最上面</li>

[[File:~~media/image348~~pi3b-img348.png~~|576x275px~~]]

</ol>

<li>此时按下键盘上的方向按键就可以控制小海龟上下左右移动了

[[File:~~media/image349~~pi3b-img349.png~~|575x296px~~]]</li></ol>

<li>ROS 2当前活跃的版本如下所示，推荐版本为'''Galactic Geochelone'''

[[File:~~media/image350~~pi3b-img350.png~~|576x271px~~]][[File:~~media/image351~~pi3b-img351.png~~|575x265px~~]]

{| class="wikitable" style="width:800px;"

|-

[[File:~~media/image352~~pi3b-img352.png~~|576x324px|1~~]]

</div></li>

[[File:~~media/image353~~pi3b-img353.png~~|576x324px|1~~]]

</div></li>

|

<big>'''如果自己复制的代码这里编译如果有问题，请去[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html 官方工具]中下载源码然后上传到开发板的Linux系统中测试。'''</big>

[[File:~~media/image354~~pi3b-img354.png|center]]

|}

{| class="wikitable" style="width:800px;"

<li>树莓派5寸MIPI LCD显示屏+触摸屏

[[File:~~media/image355~~pi3b-img355.png~~|306x219px~~]]</li>

<li>15pin MIPI排线

[[File:~~media/image356~~pi3b-img356.png~~|276x111px~~]]</li></ol>

</li>

<li>然后将15pin MIPI排线按照下图所示的方式连接到树莓派5寸屏幕上（注意绝缘面的朝向）

[[File:~~media/image357~~pi3b-img357.png~~|294x160px~~]]</li>

<li>最后连接到Orange Pi 3B开发板的LCD接口上

[[File:~~media/image358~~pi3b-img358.png~~|333x199px~~]]</li></ol>

=== 打开树莓派5寸屏幕配置的方法 ===

<li>~~linux镜像默认是没有打开树莓派5寸屏幕的配置的，如果需要使用树莓派5寸屏幕，需要手动打开才行。~~Linux镜像默认是没有打开树莓派5寸屏幕的配置的，如果需要使用树莓派5寸屏幕，需要手动打开才行。</li>

<li>打开mipi lcd配置的步骤如下所示：

</li>

<li>然后选择'''System'''

[[File:~~media/image359~~pi3b-img359-1.png~~|575x272px~~]]</li>

<li>然后选择'''Hardware'''

[[File:~~media/image360~~pi3b-img360.png~~|576x266px~~]]</li>

<li>然后使用键盘的方向键定位到raspi-7inch-touchscreen，再使用'''空格'''选中

[[File:~~media/image361~~pi3b-img361.png~~|408x310px~~]]</li>

<li>然后选择'''<Save>'''保存

[[File:~~media/image362~~pi3b-img362.png~~|404x133px~~]]</li>

<li>然后选择'''<Back>'''

[[File:~~media/image363~~pi3b-img363.png~~|397x151px~~]]</li>

<li>然后选择'''<Reboot>'''重启系统使配置生效

[[File:~~media/image364~~pi3b-img364.png~~|331x154px~~]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

orangepi@orangepi:~$ '''cat /boot/orangepiEnv.txt | grep ~~“raspi”~~"raspi"'''

'''overlays=raspi-7inch-touchscreen #示例配置'''</big>

|}

<li>启动后可以看到lcd屏幕的显示如下所示：</li>

[[File:~~media/image365~~pi3b-img365.png~~|381x262px~~]]

</ol>

<li>在'''/boot/orangepiEnv.txt'''中加入'''extraargs=fbcon=rotate:要旋转的方向'''~~这行配置就可以设置服务器版本的linux系统显示的方向，其中~~这行配置就可以设置服务器版本的Linux系统显示的方向，其中'''fbcon=rotate:'''后面的数字可以设置为：

<li>0: 正常屏（默认为横屏）</li>

</li></ol>

</li>

<li>然后'''重启'''~~linux系统就能看到lcd屏幕显示的方向已经旋转了~~Linux系统就能看到lcd屏幕显示的方向已经旋转了</li></ol>

=== 桌面版镜像旋转显示和触摸方向的方法 ===

<li>~~首先在linux系统中打开~~首先在Linux系统中打开'''Display'''设置[[File:~~media/image366~~pi3b-img366.png~~|298x206px~~]]</li>

<li>然后在'''Rotation'''中选择想要旋转的方向

<li>'''Inverted''': 上下翻转，相当于旋转180度</li>

<li>'''Right''': 向右旋转90度

[[File:~~media/image367~~pi3b-img367.png~~|286x180px~~]]</li></ol>

</li>

<li>然后点击'''Apply'''

[[File:~~media/image368~~pi3b-img368.png~~|330x207px~~]]</li>

<li>然后选择'''Keep this configuration'''

[[File:~~media/image369~~pi3b-img369.png~~|374x210px~~]]</li>

<li>此时屏幕显示就已旋转完成，然后关闭掉'''Display'''程序即可</li>

<li>上面的步骤只会选择显示方向，并不会旋转触摸的方向，使用'''set_lcd_rotate.sh'''脚本可以旋转下触摸的方向，此脚本设置完后会自动重启，然后就可以测试触摸是否已经能正常使用了

</li></ol>

== ~~开关机logo使用说明~~ eDP屏幕的使用方法 ===== eDP屏幕的组装方法 ===<ol style="list-style-type: decimal;"><li>目前仅适配了一款15.6寸的eDP屏幕，包含的配件如下：</li><ol style="list-style-type: lower-alpha;"><li>0.5间距30pin单头同向排线[[File:pi3b-11.png]]</li><li>15.6寸 eDP显示屏，分辨率为1920x1080。[[File:pi3b-12-1.png]]</li></ol><li>将30pin单头同向排线的FPC端连接到开发板的eDP接口，另一端连接到屏幕的eDP接口</li>[[File:pi3b-13-1.png]]</ol>

=== 打开eDP屏幕配置的方法 ===

<li>~~开关机logo默认只在桌面版的系统中才会显示~~Linux镜像默认是没有打开eDP屏幕的配置的，如果需要使用eDP屏幕，需要手动打开才行。</li><li>~~在'''~~打开eDP屏配置的步骤如下所示：</~~boot/orangepiEnv.txt'''中设置~~p><ol style="list-style-type: lower-alpha;"><li>首先运行下'''~~bootlogo~~orangepi-config'''~~变量为~~，普通用户记得加'''~~false~~sudo'''~~可以关闭开关机logo~~权限

{| class="wikitable" style="width:800px;"

|-

|

orangepi@orangepi:~$ '''~~vim /boot/orangepiEnv.txt'''verbosity=1'''bootlogo=false~~sudo orangepi-config'''

|}

</li>

<li>然后选择'''System'''[[File:pi3b-14.png]]</li><li>然后选择'''Hardware'''[[File:pi3b-15.png]]</li><li>然后使用键盘的方向键定位到edp，再使用空格选中[[File:pi3b-16.png]]</li><li>然后选择'''<Save>'''保存[[File:pi3b-17.png]]</li><li>然后选择'''<Back>'''[[File:pi3b-18.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:pi3b-19.png]]{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''上面的设置最终会在/boot/orangepiEnv.txt中加入overlays=edp这句配置。设置完后可以先检查下。如果不存在这句配置，那么设置就是有问题。''' '''如果觉得使用orangepi-config比较麻烦，也可以使用vim编辑器打开/boot/orangepiEnv.txt，然后加入overlays=edp 这句配置也是可以。''' orangepi@orangepi:~$ '''cat /boot/orangepiEnv.txt | grep "edp"''''''overlays=edp #示例配置'''</big>|}</li></ol></li><li>启动后可以看到eDP屏幕的显示如下所示：</li>[[File:pi3b-20.png]]</ol> == 开关机logo使用说明 == <ol style="list-style-type: decimal;"><li>开关机logo默认只在桌面版的系统中才会显示</li><li>在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''false'''可以关闭开关机logo{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''vim /boot/orangepiEnv.txt'''verbosity=1'''bootlogo=false'''|}</li><li>在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''true'''可以开启开关机logo

{| class="wikitable" style="width:800px;"

|-

|}

</li>

<li>~~开机logo图片在linux系统中的位置为~~开机logo图片在Linux系统中的位置为

{| class="wikitable" style="width:800px;"

|-

== ZFS文件系统的使用方法 ==

=== 安装ZFS的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|

<big>'''~~最新版本的Ubuntu20.04、Ubuntu22.04、Debian11和Debian12桌面版系统~~安装zfs前，请先确保使用的Linux镜像为最新版本。另外，如果系统中已经安装了zfs，就无需重复安装了。'''</~~span~~big>~~中已经预装了zfs，直接使用即可。'''~~|}

安装zfs前首先需要安装内核头文件，安装内核头文件的方法请参考[[Orange Pi 3B#安装内核头文件的方法|'''~~在Ubuntu20.04、Ubuntu22.04桌面版系统中预装的zfs版本是2.1.6。~~安装内核头文件的方法''']]小节的说明。

~~'''在Debian11和Debian12桌面版系统中预装的zfs版本是2~~在Ubuntu20.04、Ubuntu22.04和Debian11系统中，zfs是无法通过apt直接安装的，这是因为默认的apt源中zfs版本低于2.1.6，存在和rk Linux5.10内核不兼容的问题，这个问题在zfs的2.1.~~11。'''~~6及以后的版本中得到了修复。

为了解决这个问题，我们提供了能正常安装的zfs的deb包，可以从开发板的[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''~~系统启动后，首先请确认下zfs的内核模块有没有被加载，如果使用lsmod命令可以看到zfs相关的内容，就说明系统已经预装了zfs。~~官方工具''']中下载到。打开'''官方工具'''，然后进入'''Ubuntu和Debian系统使用的zfs相关的deb包'''文件夹后，可以看到Ubuntu20.04、Ubuntu22.04和Debian11三种类型的deb包，请下载需要的版本。

~~orangepi@orangepi~~[[File:~~~$ '''lsmod | grep "zfs"'''</big>~~pi3b-img370.png]]

~~zfs                     2801664     0~~下载完对应版本的zfs deb包后，请将它们上传到开发板的Linux系统中。上传方法请参考[[Orange Pi 3B#上传文件到开发板Linux系统中的方法|'''上传文件到开发板Linux系统中的方法''']]小节的说明。

~~zunicode             327680     1   zfs~~上传完成后，再在开发板Linux系统的命令行中使用'''cd'''命令进入deb包的目录，然后使用下面的命令就可以安装zfs的deb包。

~~zzstd &nbsp~~{| class="wikitable" style="width:800px;~~                471040     1   zfs~~" |-| orangepi@orangepi:~$ '''sudo apt install ./*.deb'''|}

~~zlua                    139264     1   zfs~~安装完成后，使用下面的命令可以看到zfs相关的内核模块：

~~zcommon             69632     1   zfs~~ ~~znvpair                 61440     2   zfs,zcommon~~ ~~zavl                      16384     1   zfs~~ ~~icp                     221184     1   zfs~~ spl                       77824     6   zfs,icp,zzstd,znvpair,zcommon,zavl|} ~~=== 安装ZFS的方法 ===~~ ~~{| class="wikitable" style="background-color:#ffffdc;width:800px;"~~ |-| ~~<big>'''安装zfs前，请先确保使用的linux镜像为最新版本。另外，如果系统中已经安装了zfs，就无需重复安装了。'''</big>~~|} ~~安装zfs前首先需要安装内核头文件，安装内核头文件的方法请参考[[Orange Pi 3B#安装内核头文件的方法|'''安装内核头文件的方法''']]小节的说明。~~ 在Ubuntu20.04、Ubuntu22.04和Debian11系统中，zfs是无法通过apt直接安装的，这是因为默认的apt源中zfs版本低于2.1.6，存在和rk linux5.10内核不兼容的问题，这个问题在zfs的2.1.6及以后的版本中得到了修复。为了解决这个问题，我们提供了能正常安装的zfs的deb包，可以从开发板的[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-3B.html '''官方工具''']中下载到。打开'''官方工具'''，然后进入'''Ubuntu和Debian系统使用的zfs相关的deb包'''文件夹后，可以看到Ubuntu20.04、Ubuntu22.04和Debian11三种类型的deb包，请下载需要的版本。 ~~[[File:media/image370.png|232x136px]]~~ 下载完对应版本的zfs deb包后，请将它们上传到开发板的Linux系统中。上传方法请参考[[Orange Pi 3B#上传文件到开发板Linux系统中的方法|'''上传文件到开发板Linux系统中的方法''']]小节的说明。 ~~上传完成后，再在开发板linux系统的命令行中使用'''cd'''命令进入deb包的目录，然后使用下面的命令就可以安装zfs的deb包。~~ ~~{| class="wikitable" style="width:800px;"~~ |-| ~~orangepi@orangepi:~$ '''sudo apt install ./*.deb'''~~|} ~~安装完成后，使用下面的命令可以看到zfs相关的内核模块：~~ {| class="wikitable" style="width:800px;" |-

|

orangepi@orangepi:~$ '''ls /lib/modules/5.10.160-rockchip-rk356x/updates/dkms/'''

|}

~~然后重启下linux系统就能看到zfs内核模块会自动加载了：~~然后重启下Linux系统就能看到zfs内核模块会自动加载了：

{| class="wikitable" style="width:800px;"

<li>首先我们可以通过'''lsblk'''命令查看下开发板所有的存储设备，当前开发板接了一个NVMe SSD以及一个U盘，输出如下所示：

[[File:~~media/image371~~pi3b-img371.png~~|379x227px~~]]</li>

<li>然后输入下面的命令可以创建一个ZFS池，包含NVMe SSD和U盘两个存储设备

{| class="wikitable" style="width:800px;"

</li>

<li>然后使用'''zpool list'''命令可以看到系统已经创建了一个名为'''pool1'''的ZFS池，并且ZFS池pool1的大小是NVME SSD的大小加上U盘的大小

[[File:~~media/image372~~pi3b-img372.png~~|576x37px~~]]</li>

<li>然后执行'''df -h'''可以看到'''pool1'''被挂载到了'''/pool1'''目录

{| class="wikitable" style="width:800px;"

<li>然后用'''zpool list'''命令可以看到实际只占用了1.01G，因为这1001个文件都是重复的，说明数据去重功能有效。

[[File:~~media/image373~~pi3b-img373.png~~|576x36px~~]]</li></ol>

<li>然后通过'''ls -lh'''命令可以看到的文件大小以及在ZFS池中占用的空间都是'''27M'''

[[File:~~media/image374~~pi3b-img374.png~~|576x90px~~]]</li>

<li>然后我们在ZFS池pool1中启用压缩功能

{| class="wikitable" style="width:800px;"

<li>这时可以看到'''text.tar'''文件大小还是27M，但是在ZFS池中只占用9.47M的空间，说明文件被压缩了</li>

[[File:~~media/image375~~pi3b-img375.png~~|576x79px~~]]

</ol>

</li>

<li>另外开发板配有开关机按键，还可以'''短按'''开发板上的开关机按键来关机。

[[File:~~media/image376~~pi3b-img376-1.png~~|294x80px~~]]</li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<big>'''注意，Linux桌面版系统按下开关机按键后会弹出下图所示的确认框，需要点击Shut Down选项后才会关机。'''</big>

[[File:~~media/image377~~pi3b-img377.png|center]]

|}

</ol>

<li>关机后短按开发板上的开关机按键即可开机。

[[File:~~media/image376~~pi3b-img376-1.png~~|294x80px~~]]</li><li>~~重启linux系统的命令为~~重启Linux系统的命令为

{| class="wikitable" style="width:800px;"

|-

~~=== 使用开发板的Ubuntu22.04系统编译 ===~~

~~<ol style="list-style-type: decimal;">~~

<li>Linux SDK，即'''orangepi-build'''，支持在开发板的'''Ubuntu 22.04'''的上运行（其它系统没有测试过），所以下载orangepi-build前，请首先确保开发板已安装的Ubuntu版本是Ubuntu 22.04。查看开发板已安装的Ubuntu版本的命令如下所示，如果Release字段显示的不是'''22.04'''，说明当前使用的Ubuntu版本不符合要求，请更换系统后再进行下面的操作。

~~{| class="wikitable" style="width:800px;"~~

|-

|

~~orangepi@orangepi:~$ '''lsb_release -a'''~~

~~No LSB modules are available.~~

~~Distributor ID: Ubuntu~~

~~Description: Ubuntu 22.04.1 LTS~~

~~Release: '''22.04'''~~

~~Codename: jammy~~

|}

~~</li>~~

<li>'''由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保开发板能正常从GitHub下载代码，这点是非常重要的。'''</li></ol>

~~~~

=== 使用x64的Ubuntu22.04电脑编译 ===

<li>注意Ubuntu版本需要切换到22.04

[[File:~~media/image378~~pi3b-img378.png~~|576x241px~~]]</li>

<li>需要替换的'''/etc/apt/sources.list'''文件的内容为

{| class="wikitable" style="width:800px;"

<li>'''另外，由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。'''</li></ol>

</li></ol>

== ~~获取linux~~ 获取Linux sdk的源码 ==

=== 从github下载orangepi-build ===

# ~~linux~~ Linux sdk其实指的就是orangepi-build这套代码，orangepi-build是基于armbian build编译系统修改而来的，使用orangepi-~~build可以编译出多个版本的linux镜像。首先下载orangepi~~build可以编译出多个版本的Linux镜像。首先下载orangepi-build的代码，命令如下所示：

::{| class="wikitable" style="width:800px;"

<big>'''注意，Orange Pi 3B开发板是需要下载orangepi-build的next分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。'''</big>

[[File:~~media/image379~~pi3b-img379.png|780px|center]]

|}

::{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<li>开发板当前使用的u-~~boot和linux内核版本如下所示~~boot和Linux内核版本如下所示</li>

{| class="wikitable" style="width:800px;text-align:center;"

| '''分支'''

| '''u-boot版本'''

| '''~~linux内核版本~~Linux内核版本'''

|-

| '''legacy'''

| '''u-boot 2017.09'''

| '''~~linux5~~Linux5.10'''

|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;"

<big>'''这里所说的分支和orangepi-build源代码的分支不是同一个东西，请不要搞混了。此分支主要是用来区分不同内核源码版本的。'''

'''~~目前RK提供的linux5~~目前RK提供的Linux5.10 bsp内核我们定义为legacy分支。如果以后支持主线内核了，就会添加一个current分支。'''</big>

|}

</ol>

|-

|

<big>'''如果是从github下载的orangepi-build的代码，下载完后你可能会发现orangepi-build中并没有包含u-~~boot和linux内核的源码，也没有编译u~~boot和Linux内核的源码，也没有编译u-~~boot和linux内核需要用到交叉编译工具链，这是正常的，因为这些东西都存放在其它单独的github仓库或者某些服务器上了（下文会详述其地址）。orangepi~~boot和Linux内核需要用到交叉编译工具链，这是正常的，因为这些东西都存放在其它单独的github仓库或者某些服务器上了（下文会详述其地址）。orangepi-build在脚本和配置文件中会指定u-~~boot、linux内核和交叉编译工具链的地址，运行orangepi~~boot、Linux内核和交叉编译工具链的地址，运行orangepi-build时，当其发现本地没有这些东西，会自动去相应的地方下载的。'''</big>

|}

</li></ol>

=== 下载交叉编译工具链 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''只有在x64的电脑中使用orangepi-build编译镜像才会下载交叉编译工具链。在开发板的Ubuntu22.~~04中编译开发板的linux镜像是不会下载交叉编译工具链的，此时orangepi~~04中编译开发板的Linux镜像是不会下载交叉编译工具链的，此时orangepi-build/toolchains会是一个空文件夹。'''</big>|}

<li>orangepi-build第一次运行的时候会自动下载交叉编译工具链放在'''toolchains'''文件夹中，每次运行orangepi-build的build.sh脚本后，都会检查'''toolchains'''中的交叉编译工具链是否都存在，如果不存在则会重新开始下载，如果存在则直接使用，不会重复下载。

[[File:~~media/image380~~pi3b-img380.png~~|575x278px|选区_396~~]]

</div></li>

<li>交叉编译工具链在中国境内的镜像网址为清华大学的开源软件镜像站

{| class="wikitable" style="width:800px;" |-| [https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/ '''https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/''']|}</li>

<li>'''toolchains'''下载完后会包含多个版本的交叉编译工具链，开发板只会使用其中的两个

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''ls toolchains/'''

gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu

gcc-linaro-aarch64-none-elf-4.8-2013.11_linux

gcc-linaro-arm-linux-gnueabihf-4.8-2014.04_linux

gcc-linaro-arm-none-eabi-4.8-2014.04_linux|}</li><li>~~编译linux内核源码使用的交叉编译工具链为~~编译Linux内核源码使用的交叉编译工具链为

<li>linux5.10

{| class="wikitable" style="width:800px;" |-| '''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''|}</li></ol>

</li>

<li>编译u-boot源码使用的交叉编译工具链为

<li>v2017.09

{| class="wikitable" style="width:800px;" |-| '''gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu'''|}</li></ol>

</li></ol>

<li>orangepi-~~build仓库下载完后并不包含linux内核、u~~build仓库下载完后并不包含Linux内核、u-~~boot的源码以及交叉编译工具链，linux内核和u~~boot的源码以及交叉编译工具链，Linux内核和u-boot的源码存放在独立的git仓库中

<li>~~linux内核源码存放的git仓库如下所示：~~Linux内核源码存放的git仓库如下所示：{| class="wikitable" style="width:800px;" |-| '''https://github.com/orangepi-xunlong/linux-orangepi/tree/orange-pi-5.10-rk35xx'''|}</li>

<li>u-boot源码存放的git仓库如下所示：

{| class="wikitable" style="width:800px;" |-| '''https://github.com/orangepi-xunlong/u-boot-orangepi/tree/v2017.09-rk3588'''|}</li></ol>

</li>

<li>orangepi-build第一次运行的时候会去下载交叉编译工具链、u-~~boot和linux内核源码，成功编译完一次linux镜像后在orangepi~~boot和Linux内核源码，成功编译完一次Linux镜像后在orangepi-build中可以看到的文件和文件夹有

<li>'''build.sh''': 编译启动脚本</li>

<li>'''external''': ~~>~~ 包含编译镜像需要用的配置文件、特定功能的脚本以及部分程序的源码，编译镜像过程中缓存的rootfs压缩包也存放在external中</li><li>'''kernel''': ~~> 存放linux内核的源码，里面名为~~存放Linux内核的源码，里面名为'''orange-pi-5.10-rk35xx'''的文件夹存放的就是RK3588/RK3588S/RK3566系列开发板legacy分支的内核源码，内核源码的文件夹的名字请不要手动修改，如果修改了，编译系统运行时会重新下载内核源码</li>

<li>'''LICENSE''': GPL 2许可证文件</li>

<li>'''README.md''': orangepi-build说明文件</li>

<li>'''output''': ~~>~~ 存放编译生成的u-~~boot、linux等deb包、编译日志以及编译生成的镜像等文件~~boot、Linux等deb包、编译日志以及编译生成的镜像等文件</li><li>'''scripts''': ~~编译linux镜像的通用脚本~~编译Linux镜像的通用脚本</li>

<li>'''toolchains''': 存放交叉编译工具链</li>

<li>'''u-boot''': ~~>~~ 存放u-boot的源码，里面名为'''v2017.09-rk3588'''的文件夹存放的就是RK3588/RK3588S/RK3566系列开发板legacy分支的u-boot源码，u-boot源码的文件夹的名字请不要手动修改，如果修改了，编译系统运行时会重新下载u-boot源码</li>

<li>'''userpatches''': 存放编译脚本需要用到的配置文件

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''ls'''

'''build.sh     external     kernel     LICENSE     output     README.md     scripts     toolchains     u-boot     userpatches'''|}</li></ol>

</li></ol>

<li>运行build.sh脚本，记得加sudo权限

{| class="wikitable" style="width:800px;" |-| test@test:~/orangepi-build$ '''sudo ./build.sh'''|}</li>

<li>选择'''U-boot package'''，然后回车

[[File:~~media/image381~~pi3b-img381.png~~|576x132px|选区_238~~]]

</div></li>

[[File:~~media/image382~~pi3b-img382.png~~|576x197px|}4$_5F06}}0R4GU8]OVO}4E~~]]

</div></li>

<li>u-boot源码的版本

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Compiling u-boot [ '''v2017.09''' ]|}</li>

<li>交叉编译工具链的版本

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 7.4.1''' ]|}</li><li>编译生成的u-boot deb包的路径{| class="wikitable" style="width:800px;" |-| [ o.k. ] Target directory [ '''orangepi-build/output/debs/u-boot''' ]|}</li><li>编译生成的u-boot deb包的包名{| class="wikitable" style="width:800px;" |-| [ o.k. ] File name [ '''linux-u-boot-legacy-orangepi3b_1.0.0_arm64.deb''' ]|}</li>

<li>编译使用的时间

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Runtime [ '''1 min''' ]|}</li>

<li>重复编译u-boot的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译u-boot

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepi3b BRANCH=legacy BUILD_OPT=u-boot KERNEL_CONFIGURE=no''' ]|}</li></ol>

</li>

<li>查看编译生成的u-boot deb包

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''ls output/debs/u-boot/'''

linux-u-boot-legacy-orangepi3b_1.0.0_arm64.deb|}</li>

<li>生成的u-boot的deb包包含的文件如下所示

<li>使用下面的命令可以解压deb包

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''cd output/debs/u-boot'''

test@test:~/orangepi_build/output/debs/u-boot$ $ '''dpkg -x''' \

'''linux-u-boot-legacy-orangepi3b_1.0.0_arm64.deb . (注意命令最后有个”.”)'''

test@test:~/orangepi_build/output/debs/u-boot$ '''ls'''

linux-u-boot-legacy-orangepi3b_1.0.0_arm64.deb '''usr'''|}</li>

<li>解压后的文件如下所示

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build/output/debs/u-boot$ '''tree usr'''

usr

└── lib

:├── linux-u-boot-legacy-orangepi3b_1.0.0_arm64:│ ├── idbloader.img:│ ├── rkspi_loader.img:│ └── u-boot.itb:└── u-boot::├── LICENSE::├── orangepi-3b-rk3566_defconfig::└── platform_install.sh 3 directories, 6 files|}</li></ol>

</li>

<li>orangepi-bulid编译系统编译u-boot源码时首先会将u-boot的源码和github服务器的u-boot源码进行同步，所以如果想修改u-boot的源码，首先需要关闭源码的下载更新功能（'''需要完整编译过一次u-boot后才能关闭这个功能，否则会提示找不到u-boot的源码，如果是从百度云盘下载的源码压缩包，则没有这个问题，因为u-boot的源码都已缓存好了'''），否则所作的修改都会被还原，方法如下：

设置userpatches/config-default.conf中的IGNORE_UPDATES变量为”yes”

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''

IGNORE_UPDATES="'''yes'''"|}</li><li>调试u-~~boot代码时，可以使用下面的方法来更新linux镜像中的u~~boot代码时，可以使用下面的方法来更新Linux镜像中的u-boot进行测试

<li>将编译好的u-~~boot的deb包上传到开发板的linux系统中~~boot的deb包上传到开发板的Linux系统中{| class="wikitable" style="width:800px;" |-|

test@test:~/orangepi-build$ '''cd output/debs/u-boot'''

test@test:~/orangepi_build/output/debs/u-boot$ '''scp \'''

'''linux-u-boot-legacy-orangepi3b_1.0.0_arm64.deb ~~[mailto:root@192.168.1.xxx:/root~~ root@192.168.1.xxx:/root]'''|}</li>

<li>然后登录到开发板，卸载已安装的u-boot的deb包

{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''apt purge -y linux-u-boot-orangepi3b-legacy'''|}</li>

<li>再安装刚才上传的新的u-boot的deb包

{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''dpkg -i''' '''linux-u-boot-legacy-orangepi3b_1.0.0_arm64.deb'''|}</li>

<li>然后运行 nand-sata-install脚本

{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''nand-sata-install'''|}</li>

<li>然后选择'''5 Install/Update the bootloader on SD/eMM'''来更新TF卡中的u-boot或者'''7 Install/Update the bootloader on SPI Flash'''来更新SPI Flash中的u-boot

[[File:~~media/image383~~pi3b-img383.png~~|312x152px~~]]</li><li>~~按下回车键后首先会弹出一个Warring~~按下回车键后首先会弹出一个Warning[[File:~~media/image384~~pi3b-img384.png~~|309x168px~~]]</li>

<li>再按下回车键就会开始更新u-boot，更新完后会显示下面的信息

[[File:~~media/image385~~pi3b-img385.png~~|244x137px~~]]</li>

<li>然后就可以重启开发板来测试u-boot的修改是否生效了</li></ol>

</li>

<li>u-boot 2017.09源码中，开发板使用的defconfig配置文件为

{| class="wikitable" style="width:800px;" |-| [https://github.com/orangepi-xunlong/u-boot-orangepi/blob/v2017.09-rk3588/configs/orangepi_5_defconfig '''orangepi-build/u-boot/v2017.09-rk3588/configs/orangepi-3b-rk3566_defconfig''']|}</li><li>u-boot 2017.09源码中，开发板使用dts文件为</li>{| class="wikitable" style="width:800px;" |-| [https://github.com/orangepi-xunlong/u-boot-orangepi/blob/v2017.09-rk3588/arch/arm/dts/rk3588s-orangepi-5.dts '''orangepi-build/u-boot/v2017.09-rk3588/arch/arm/dts/rk3566-orangepi-3b.dts''']|}</ol>

</li></ol>

~~[https://github.com/orangepi-xunlong/u-boot-orangepi/blob/v2017.09-rk3588/arch/arm/dts/rk3588s-orangepi-5.dts '''orangepi-build/u-boot/v2017.09-rk3588/arch/arm/dts/rk3566-orangepi-3b.dts''']~~ =~~= 编译linux内核~~ 编译Linux内核 ==

<li>运行build.sh脚本，记得加sudo权限

{| class="wikitable" style="width:800px;" |-| test@test:~/orangepi-build$ '''sudo ./build.sh'''|}</li>

<li>选择'''Kernel package'''，然后回车

[[File:~~media/image386~~pi3b-img386.png~~|575x116px|选区_240~~]]

</div></li>

[[File:~~media/image382~~pi3b-img382.png~~|576x197px|}4$_5F06}}0R4GU8]OVO}4E~~]]

</div></li>

<li>然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个

[[File:~~media/image387~~pi3b-img387.png~~|576x87px~~]]</li>

<li>如果第4) 步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码

[[File:~~media/image388~~pi3b-img388.png~~|575x400px~~]]</p~~></li></ol~~>

<li>如果不需要修改内核的配置选项，在运行build.sh脚本时，传入'''KERNEL_CONFIGURE=no'''就可临时屏蔽弹出内核的配置界面了

{| class="wikitable" style="width:800px;" |-| test@test:~/orangepi-build$ '''sudo ./build.sh KERNEL_CONFIGURE=no'''|}</li>

<li>也可以设置'''orangepi-build/userpatches/config-default.conf'''配置文件中的'''KERNEL_CONFIGURE=no'''，这样可以永久禁用这个功能</li>

<li>编译内核的时候如果提示下面的错误，这是由于Ubuntu ~~>~~ PC的终端界面太小，导致'''make ~~>~~ menuconfig'''的界面无法显示，请把Ubuntu ~~>~~ PC的终端调到最大，然后重新运行build.sh脚本[[File:~~media/image389~~pi3b-img389.png~~|574x234px~~]]</li></ol></li></ol>

<li>编译内核源码时提示的部分信息说明如下

<li>~~linux内核源码的版本~~Linux内核源码的版本{| class="wikitable" style="width:800px;" |-| [ o.k. ] Compiling current kernel [ '''5.10.160''' ]|}</li>

<li>使用的交叉编译工具链的版本

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Compiler version [ '''aarch64-none-linux-gnu-gcc 11.2.1''' ]|}</li>

<li>内核默认使用的配置文件以及它存放的路径

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Using kernel config file [ '''config/kernel/linux-rockchip-rk356x-legacy.config''' ]|}</li>

<li>编译生成的内核相关的deb包的路径

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Target directory [ '''orangepi-build/output/debs/''' ]|}</li>

<li>编译生成的内核镜像deb包的包名

{| class="wikitable" style="width:800px;" |-| [ o.k. ] File name [ '''linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb''' ]|}</li>

<li>编译使用的时间

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Runtime [ '''5 min''' ]|}</li>

<li>最后会显示重复编译上一次选择的内核的编译命令，使用下面的命令无需通过图形界面选择，可以直接开始编译内核源码

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepi3b BRANCH=legacy BUILD_OPT=kernel KERNEL_CONFIGURE=no''' ]|}</li></ol>

</li>

<li>查看编译生成的内核相关的deb包

<li>'''linux-headers-legacy-rockchip-rk356x_1.0.0_arm64.deb'''包含内核头文件</li>

<li>'''linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb'''包含内核镜像和内核模块

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''ls output/debs/linux-*'''

output/debs/linux-dtb-legacy-rockchip-rk356x_1.0.0_arm64.deb output/debs/linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deboutput/debs/linux-headers-legacy-rockchip-rk356x_1.0.0_arm64.deb|}</li></ol>

</li>

<li>生成的linux-image的deb包包含的文件如下所示

<li>使用下面的命令可以解压deb包</li>{| class="wikitable" style="width:800px;" |-| test@test:~/orangepi-build$ '''cd output/debs'''</p~~></li></ol></li></ol~~>

test@test:~/orangepi_build/output/debs$ '''mkdir test'''

'''boot etc lib''' linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb '''usr'''

|}

</ol>

<li>解压后的文件如下所示

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build/output/debs/test$ '''tree -L 2'''

.

├── linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb

└── usr

:├── lib:└── share|}</li></ol></li></ol>

<li>orangepi-bulid编译系统编译linux内核源码时首先会将linux内核源码和github服务器的linux内核源码进行同步，所以如果想修改linux内核的源码，首先需要关闭源码的更新功能（bulid编译系统编译Linux内核源码时首先会将Linux内核源码和github服务器的Linux内核源码进行同步，所以如果想修改Linux内核的源码，首先需要关闭源码的更新功能（'''需要完整编译过一次linux内核源码后才能关闭这个功能，否则会提示找不到linux内核的源码，如果是从百度云盘下载的源码压缩包，则没有这个问题，因为linux的源码都已缓存好了需要完整编译过一次Linux内核源码后才能关闭这个功能，否则会提示找不到Linux内核的源码，如果是从百度云盘下载的源码压缩包，则没有这个问题，因为Linux的源码都已缓存好了'''），否则所作的修改都会被还原，方法如下：

设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''

IGNORE_UPDATES="'''yes'''"|}</li><li>~~如果对内核做了修改，可以使用下面的方法来更新开发板linux系统的内核和内核模块~~如果对内核做了修改，可以使用下面的方法来更新开发板Linux系统的内核和内核模块

<li>~~将编译好的linux内核的deb包上传到开发板的linux系统中~~将编译好的Linux内核的deb包上传到开发板的Linux系统中{| class="wikitable" style="width:800px;" |-|

test@test:~/orangepi-build$ '''cd output/debs'''

test@test:~/orangepi-build/output/debs$ '''scp \'''

'''linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb root@192.168.1.xxx:/root'''</p~~></li~~>~~<li>然后登录到开发板，卸载已安装的linux内核的deb包root@orangepi:~# '''apt purge -y linux-image-legacy-rockchip-rk356x'''</li><li>再安装刚才上传的新的linux内核的deb包root@orangepi:~# '''dpkg -i linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb'''</li><li>然后重启开发板，再查看内核相关的修改是否已生效root@orangepi:~# '''reboot'''</li></ol>~~|}

</li>

<li>然后登录到开发板，卸载已安装的Linux内核的deb包{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''apt purge -y linux-image-legacy-rockchip-rk356x'''|}</li><li>再安装刚才上传的新的Linux内核的deb包{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''dpkg -i linux-image-legacy-rockchip-rk356x_1.0.0_arm64.deb'''|}</li><li>然后重启开发板，再查看内核相关的修改是否已生效{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''reboot'''|}</li></ol></li><li>其它有用的信息

<li>内核配置文件存放位置如下所示，请不要到内核源码中去找开发板所使用的内核配置文件</li>

~~<li>~~{| class="wikitable" style="width:800px;" |-| [https://github.com/orangepi-xunlong/orangepi-build/blob/next/external/config/kernel/linux-rockchip-rk3588-legacy.config '''orangepi-build/external/config/kernel/linux-rockchip-rk356x-legacy.config''']|}<li>开发板使用的dts文件所在的位置为</li>{| class="wikitable" style="width:800px;" |-| [https://github.com/orangepi-xunlong/linux-orangepi/blob/orange-pi-5.10-rk3588/arch/arm64/boot/dts/rockchip/rk3588s-orangepi-5.dts '''orangepi-build/kernel/orange-pi-5.10-rk35xx/arch/arm64/boot/dts/rockchip/rk3566-orangepi-3b.dts''']|}</ol>

</li></ol>

[https://github.com/orangepi-xunlong/linux-orangepi/blob/orange-pi-5.10-rk3588/arch/arm64/boot/dts/rockchip/rk3588s-orangepi-5.dts '''orangepi-build/kernel/orange-pi-5.10-rk35xx/arch/arm64/boot/dts/rockchip/rk3566-orangepi-3b.dts''']

== 编译rootfs ==

<li>运行build.sh脚本，记得加sudo权限

{| class="wikitable" style="width:800px;" |-| test@test:~/orangepi-build$ '''sudo ./build.sh'''|}</li><li>选择'''Rootfs and all deb packages'''，然后回车</li~~></ol~~>

[[File:~~media/image390~~pi3b-img390.png~~|576x119px|选区_241~~]]

</div></ol>

<li>接着选择开发板的型号

[[File:~~media/image382~~pi3b-img382.png~~|576x197px|}4$_5F06}}0R4GU8]OVO}4E~~]]

</div></li>

<li>然后选择rootfs的类型

[[File:~~media/image391~~pi3b-img391.png~~|575x86px~~]]</li>

<li>然后选择镜像的类型

<li>'''Image with console interface ~~>~~ (server)'''表示服务器版的镜像，体积比较小</li>

<li>'''Image with desktop environment'''表示带桌面的镜像，体积比较大

[[File:~~media/image392~~pi3b-img392.png~~|576x75px|选区_245~~]]

</div></li></ol>

[[File:~~media/image393~~pi3b-img393.png~~|576x78px|选区_397~~]]

</div></li>

[[File:~~media/image394~~pi3b-img394.png~~|575x99px|Selection_001~~]]

</div>

[[File:~~media/image395~~pi3b-img395.png~~|576x74px~~]]

然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。

[[File:~~media/image396~~pi3b-img396.png~~|575x264px~~]]</li>

<li>然后就会开始编译rootfs，编译时提示的部分信息说明如下所示

<li>rootfs的类型

{| class="wikitable" style="width:800px;" |-| [ o.k. ] local not found [ Creating new rootfs cache for '''jammy''']|}</li>

<li>编译生成的rootfs压缩包的存放路径

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Target directory [ '''external/cache/rootfs''' ]|}</li>

<li>编译生成的rootfs压缩包的名字

{| class="wikitable" style="width:800px;" |-| [ o.k. ] File name [ '''jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4''' ]|}</li>

<li>编译使用的时间

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Runtime [ '''13 min''' ]|}</li></ol></li><li>查看编译生成的rootfs压缩包

<li>'''jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4'''是rootfs的压缩包，名字各字段的含义为

<ol style="list-style-type: ~~lower-alpha~~none;"><li>a) '''jammy'''~~表示rootfs的linux发行版的类型~~表示rootfs的Linux发行版的类型</li><li>b) '''xfce'''表示rootfs为桌面版的类型，如果为'''cli'''则表示服务器版类型</li><li>c) '''arm64'''表示rootfs的架构类型</li><li>d) '''f930ff6ebbac1a72108a2e100762b18f'''是由rootfs安装的所有软件包的包名生成的MD5哈希值，只要没有修改rootfs安装的软件包的列表，那么这个值就不会变，编译脚本会通过这个MD5哈希值来判断是否需要重新编译rootfs</li></ol>

</li>

<li>'''jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4.list'''列出了rootfs安装的所有软件包的包名

{| class="wikitable" style="width:800px;"

|-

|

test@test:~/orangepi-build$ '''ls external/cache/rootfs/'''

'''jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4'''

jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4.current

jammy-xfce-arm64.f930ff6ebbac1a72108a2e100762b18f.tar.lz4.list|}</li></ol>

</li>

<li>如果需要的rootfs在'''external/cache/rootfs'''下已经存在，那么再次编译rootfs就会直接跳过编译过程，不会重新开始编译，编译镜像的时候也会去'''external/cache/rootfs'''下查找是否已经有缓存可用的rootfs，如果有就直接使用，这样可以节省大量的下载编译时间。</li></ol>

== ~~编译linux镜像~~ 编译Linux镜像 ==

<li>运行build.sh脚本，记得加sudo权限

{| class="wikitable" style="width:800px;" |-| test@test:~/orangepi-build$ '''sudo ./build.sh'''|}</li><li>选择'''Full OS image for flashing'''，然后回车</li~~></ol~~>

[[File:~~media/image397~~pi3b-img397.png~~|576x128px|选区_242~~]]

</div></ol>

<li>然后选择开发板的型号

[[File:~~media/image382~~pi3b-img382.png~~|576x197px|}4$_5F06}}0R4GU8]OVO}4E~~]]

</div></li>

<li>然后选择rootfs的类型

[[File:~~media/image391~~pi3b-img391.png~~|575x86px~~]]</li>

<li>然后选择镜像的类型

[[File:~~media/image392~~pi3b-img392.png~~|576x75px|选区_245~~]]

</div></li></ol>

[[File:~~media/image393~~pi3b-img393.png~~|569x77px|选区_397~~]]

</div></li>

[[File:~~media/image394~~pi3b-img394.png~~|575x99px|Selection_001~~]]

</div>

[[File:~~media/image395~~pi3b-img395.png~~|576x74px~~]]

然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。

[[File:~~media/image396~~pi3b-img396.png~~|575x264px~~]]</li><li>~~然后就会开始编译linux镜像，编译的大致流程如下~~然后就会开始编译Linux镜像，编译的大致流程如下

<li>初始化Ubuntu PC的编译环境，安装编译过程需要的软件包</li>

<li>下载u-~~boot和linux内核的源码（如果已经缓存，则只更新代码）~~boot和Linux内核的源码（如果已经缓存，则只更新代码）</li>

<li>编译u-boot源码，生成u-boot的deb包</li>

<li>~~编译linux源码，生成linux相关的deb包~~编译Linux源码，生成Linux相关的deb包</li><li>~~制作linux~~ 制作Linux firmware的deb包</li>

<li>制作orangepi-config工具的deb包</li>

<li>制作板级支持的deb包</li>

<li>编译生成的镜像的存放路径

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Done building [ '''output/images/Orangepi3b_1.0.0_debian_bullseye_desktop_xfce_linux5.10.160/Orangepi3b_1.0.0_debian_bullseye_desktop_xfce_linux5.10.160.img''' ]|}</li><li>编译使用的时间</li>~~</ol></li></ol>~~{| class="wikitable" style="width:800px;" |-|

'''[ o.k. ] Runtime [ 19 min ]'''

|}</ol ><ol start="3" style="list-style-type: lower-alpha;">

<li>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像

{| class="wikitable" style="width:800px;" |-| [ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepi3b BRANCH=legacy BUILD_OPT=image RELEASE=bullseye BUILD_MINIMAL=no BUILD_DESKTOP=no KERNEL_CONFIGURE=yes''' ]|}</li></ol></li></ol>

== 已支持的Android版本 ==

{| class="wikitable" style="width:800px;text-align:center;"

|-

| style="width:400px;text-align:center;" | '''Android版本'''

| '''内核版本'''

|-

== Android 功能适配情况 ==

{| class="wikitable" style="width:800px;text-align:center;"

|-

| style="width:400px;text-align:center;" | '''功能'''

| '''Android 11'''

|-

| '''eDP显示'''

| '''OK'''

|-

| '''Camera'''

| '''NO'''

|-

| '''千兆网口'''

== WIFI的连接测试方法 ==

# 首先点击进入'''Setting'''

::[[File:~~media/image398~~pi3b-img398.png~~|549x228px~~]]

<li>然后选择'''Network & internet'''</li>~~</ol>~~ ~~[[File:media/image399.png|565x120px]]~~

[[File:pi3b-img399.png]]

</ol>

<li>然后选择'''Wi-Fi'''</li>~~</ol>~~ ~~[[File:media/image400.png|561x99px]]~~

[[File:pi3b-img400.png]]

</ol>

<li>然后打开'''Wi-Fi'''开关</li>~~</ol>~~ ~~[[File:media/image401.png|560x167px]]~~

[[File:pi3b-img401.png]]

</ol>

<li>打开'''Wi-Fi'''后如果一切正常，就可以扫描到附近的Wi-Fi热点了

[[File:~~media/image402~~pi3b-img402.png~~|561x166px~~]]</li>

<li>然后选择想连接的Wi-Fi后会弹出下图所示的密码输入界面

[[File:~~media/image403~~pi3b-img403.png~~|553x237px~~]]</li>

<li>然后使用键盘输入Wi-Fi对应的密码，再使用鼠标点击虚拟键盘中的回车按钮就会开始连接Wi-Fi了

[[File:~~media/image404~~pi3b-img404.png~~|553x232px~~]]</li>

<li>Wi-Fi连接成功后的显示如下图所示：

[[File:~~media/image405~~pi3b-img405.png~~|558x102px~~]]</li></ol>

== Wi-Fi hotspot的使用方法 ==

<li>首先请确保以太网口已连接网线，并且能正常上网</li>

<li>然后选择'''Settings'''

[[File:~~media/image398~~pi3b-img398.png~~|549x228px~~]]</li>

<li>然后选择'''Network & internet'''

[[File:~~media/image399~~pi3b-img399.png~~|565x120px~~]]</li>

<li>然后选择'''Hotspot & tethering'''

[[File:~~media/image406~~pi3b-img406.png~~|549x173px~~]]</li>

<li>然后选择'''Wi-Fi hotspot'''

[[File:~~media/image407~~pi3b-img407.png~~|548x104px~~]]</li><li>然后打开'''Wi-Fi hotspot'''~~，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭~~，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Wi-Fi hotspot'''~~，然后才能修改）~~，然后才能修改）[[File:~~media/image408~~pi3b-img408.png~~|551x158px~~]]</li><li>此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为 AndroidAP_6953'''）的WIFI热点了。然后可以点击'''AndroidAP_6953'''连接热点，密码在上图的'''Hotspot password''' 下面可以看到</li>~~</ol>~~ ~~[[File:media/image409.png|313x238px]]~~

[[File:pi3b-img409.png]]

</ol>

<li>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot''' 能正常使用</li~~></ol~~>

[[File:~~media/image410~~pi3b-img410.png~~|327x165px~~]]</ol>

== 蓝牙的测试方法 ==

<li>首先点击进入'''Setting'''

[[File:~~media/image398~~pi3b-img398.png~~|549x228px~~]]</li>

<li>然后选择'''Connected devices'''

[[File:~~media/image411~~pi3b-img411.png~~|547x115px~~]]</li>

<li>然后点击'''Pair new device'''打开蓝牙并开始扫描周围的蓝牙设备

[[File:~~media/image412~~pi3b-img412.png~~|547x126px~~]]</li>

<li>搜索到的蓝牙设备会在'''Available devices'''下面显示出来

[[File:~~media/image413~~pi3b-img413.png~~|559x279px~~]]</li>

<li>然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项

[[File:~~media/image414~~pi3b-img414.png~~|522x212px~~]]</li>

<li>这里测试的是开发板和安卓手机蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程

[[File:~~media/image415~~pi3b-img415.png~~|236x273px~~]]</li>

<li>配对完成后，可以看到如下图所示的已配对的蓝牙设备

[[File:~~media/image416~~pi3b-img416.png~~|545x178px~~]]</li>

<li>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了

[[File:~~media/image417~~pi3b-img417.png~~|559x238px~~]]</li>

<li>开发板Android系统蓝牙接收到的图片可以在文件管理器中打开'''Download'''目录查看

[[File:~~media/image418~~pi3b-img418.png~~|573x97px~~]]</li></ol>

== 树莓派5寸屏幕的使用方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''请确保使用的镜像为下面的两个版本的镜像：'''

'''OrangePi3B_RK3566_Android11_lcd_v1.x.x.img'''

'''OrangePi3B_RK3566_Android11_spi-nvme_lcd_v1.x.x.img'''</big>|}

<li>首先需要组装好屏幕，请参考[[\lOrange Pi 3B#树莓派5寸屏幕的组装方法|'''树莓派5寸屏幕的组装方法''']]</li>

<li>给板子接通Type-C电源，并上电，系统启动后，就可以看到屏幕显示如下图所示

[[File:~~media/image419~~pi3b-img419.png~~|516x332px~~]]</li></ol>

== eDP屏幕的使用方法 ==

<li>目前仅适配了一款15.6寸的eDP屏幕，包含的配件如下：</li>

<li>0.5间距30pin单头同向排线

[[File:pi3b-26.png]]

</li>

<li>15.6寸 eDP显示屏，分辨率为1920x1080

[[File:pi3b-27.png]]

</li>

</ol>

<li>将30pin单头同向排线的FPC端连接到开发板的eDP接口，另一端连接到屏幕的eDP接口</li>

[[File:pi3b-28.png]]

<li>再给板子接通Type-C电源，并上电，系统启动后，就可以看到屏幕显示如下图所示</li>

[[File:pi3b-29-1.png]]

</ol>

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

<li>首先点击wiringOP图标打开wiringOP APP

[[File:~~media/image420~~pi3b-img420.png~~|576x210px~~]]</li>

<li>wiringOP APP的主界面显示如下图所示，然后点击'''GPIO_TEST'''按钮打开GPIO测试界面

[[File:~~media/image421~~pi3b-img421.png~~|575x148px~~]]</li>

<li>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮跟40pin引脚是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平设置为低电平；当点击右边的'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息；当点击'''BLINK ALL GPIO'''按钮时，程序会控制28个GPIO口不停的切换高低电平

[[File:~~media/image422~~pi3b-img422-1.png~~|576x303px~~]]</li>

<li>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：

[[File:~~media/image423~~pi3b-img423-1.png~~|575x323px~~]]</li><li>开发板40pin中总共有28个GPIO口可以使用，下面以7号引脚——对应GPIO为GPIO4_A4 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平。首先点击7号引脚对应的开发板40pin中总共有28个GPIO口可以使用，下面以11号引脚——对应GPIO为GPIO3_C6 ——对应wPi序号为5——为例演示如何设置GPIO口的高低电平。首先点击7号引脚对应的'''CheckBox'''~~按钮，当按钮为选中状态时，7号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为~~按钮，当按钮为选中状态时，11号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功[[File:~~media/image424~~pi3b-img424-1.png~~|258x349px~~]]</li>

<li>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为'''OUT'''，引脚电平为高电平

[[File:~~media/image425~~pi3b-img425.png~~|574x301px~~]]</li><li>再次点击下图的'''CheckBox'''~~按钮取消勾选状态，7号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为~~按钮取消勾选状态，11号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功[[File:~~media/image426~~pi3b-img426-1.png~~|250x345px~~]]</li>

<li>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为OUT，引脚电平为低电平

[[File:~~media/image427~~pi3b-img427-1.png~~|576x300px~~]]</li></ol>

=== 40pin的UART测试 ===

<li>Android中默认打开了UART7和UART9，在40pin的位置如下图所示，对应的设备节点分别是'''/dev/ttyS7'''和'''/dev/ttyS9'''

[[File:~~media/image271~~pi3b-img271-1.png~~|376x92px~~]]</li>

<li>首先点击wiringOP图标打开wiringOP APP

[[File:~~media/image420~~pi3b-img420.png~~|576x210px~~]]</li>

<li>wiringOP APP的主界面显示如下图所示，然后点击'''UART_TEST'''按钮打开UART测试界面

[[File:~~media/image428~~pi3b-img428.png~~|575x156px~~]]</li><li>APP的串口测试界面如下图所示</li>~~</ol>~~ ~~[[File:media/image429.png|576x324px]]~~

[[File:pi3b-img429.png]]

</ol>

<li>下面以测试'''UART7'''为例，在选择框中选择'''/dev/ttyS7'''节点，在编辑框中输入想要设置的波特率，然后点击'''OPEN'''按钮打开'''/dev/ttyS7'''节点，打开成功后，'''OPEN'''按钮变为不可选中状态，'''CLOSE'''按钮和'''SEND'''按钮变为可选中状态</li>~~</ol>~~ ~~[[File:media/image430.png|574x166px]]~~

[[File:pi3b-img430.png]]

</ol>

<li>然后使用杜邦线短接uart7的RXD和TXD引脚

[[File:~~media/image431~~pi3b-img431.png~~|418x103px~~]]</li><li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li>~~</ol>~~ ~~[[File:media/image432.png|575x161px]]~~

[[File:pi3b-img432.png]]

</ol>

<li>如果一切正常，接收框内会显示已接收到的字符串</li~~></ol~~>

[[File:~~media/image433~~pi3b-img433.png~~|574x164px~~]]</ol>

~~~~

=== 40pin的SPI测试 ===

<li>由 40pin 接口的原理图可知，Orange Pi 3B可用的 spi 为 spi3

[[File:~~media/image266~~pi3b-img266-1.png~~|577x193px~~]]</li>

<li>这里通过w25q64模块来测试SPI接口，首先在SPI3接口接入w25q64设备

[[File:~~media/image434~~pi3b-img434.png~~|373x215px~~]]</li>

<li>然后点击wiringOP图标打开wiringOP APP

[[File:~~media/image420~~pi3b-img420.png~~|576x210px~~]]</li>

<li>wiringOP APP的主界面显示如下图所示，点击SPI_TEST按钮打开SPI的测试界面

[[File:~~media/image435~~pi3b-img435.png~~|574x149px~~]]</li><li>然后点击'''OPEN'''按钮初始化SPI</li>~~</ol>~~ ~~[[File:media/image436.png|576x241px]]~~

[[File:pi3b-img436.png]]

</ol>

<li>然后填充需要发送的字节，比如读取w25q64的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮

[[File:~~media/image437~~pi3b-img437.png~~|572x216px~~]]</li><li>最后APP会显示读取到的ID信息</li>~~</ol>~~ ~~[[File:media/image438.png|575x296px]]~~

[[File:pi3b-img438.png]]

</ol>

<li>w25q64模块的MANUFACTURER ID为EFh，Device ID为4017h，跟上面读取到的值是对应的（h代表是16进制）

[[File:~~media/image439~~pi3b-img439.png~~|374x126px~~]]</li></ol>

=== 40pin的PWM测试 ===

<li>Android默认开启了'''PWM11'''，对应的引脚在40pin的所在位置如下图所示

[[File:~~media/image440~~pi3b-img440-1.png~~|334x107px~~]]</li>

<li>首先点击wiringOP图标打开wiringOP APP

[[File:~~media/image420~~pi3b-img420.png~~|576x210px~~]]</li>

<li>然后在wiringOP的主界面点击'''PWM_TEST'''按钮进入PWM的测试界面

[[File:~~media/image441~~pi3b-img441.png~~|575x150px~~]]</li><li>PWM11对应的基地址是'''fe6f0030'''，PWM15对应的基地址是'''fe700030'''，这里pwmchip0右边显示是'''fdd70020.pwm'''，这时需要点击下拉选项选择其它的pwmchip，直到右边显示'''~~febf0030~~fe6f0030.pwm'''或者'''fe700030.pwm'''为止[[File:~~media/image442~~pi3b-img442.png~~|576x178px~~]]</li>

<li>当下拉选项选择'''pwmchip3'''时，右边对应的就是PWM11对应的基地址'''fe6f0030'''

[[File:~~media/image443~~pi3b-img443.png~~|574x161px~~]]</li>

<li>然后确认PWM的通道，默认是0通道，并确认PWM的周期，默认的配置是'''50000ns'''，转换为PWM频率是'''20KHz'''，可自行修改，点击'''EXPORT'''按钮导出'''PWM11'''

[[File:~~media/image444~~pi3b-img444.png~~|575x160px~~]]</li><li>然后拖动下面的拖动条，就可以改变PWM的占空比，然后勾选Enable就可以输出PWM波形了</li>~~</ol>~~ ~~[[File:media/image445.png|575x167px]]~~

[[File:pi3b-img445.png]]

</ol>

<li>然后使用示波器测量开发板40pin中的第32号引脚就可以看到下面的波形了</li~~></ol~~>

[[File:~~media/image446~~pi3b-img446.png~~|460x276px~~]]</ol>

~~~~

== ADB的使用方法 ==

=== 使用网络连接adb调试 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''使用网络adb无需数据线来连接电脑和开发板，而是通过网络来通信，所以首先请确保开发板的有线或者无线网络已经连接好了，然后获取开发板的IP地址，后面要用到。'''</big>|}

<li>确保Android系统的'''service.adb.tcp.port'''设置为5555端口号

{| class="wikitable" style="width:800px;"

|-

|

console:/ # '''getprop | grep "adb.tcp"'''

[service.adb.tcp.port]: ['''5555''']|}</li><li>如果'''service.adb.tcp.port'''没有设置，可以使用下面的命令设置网络adb的端口号~~</li></ol>~~{| class="wikitable" style="width:800px;" |-|

console:/ # '''setprop service.adb.tcp.port 5555'''

console:/ # '''start adbd'''

|}</li></ol>

<li>在Ubuntu PC上安装adb工具

{| class="wikitable" style="width:800px;"

|-

|

test@test:~$ '''sudo apt update'''

test@test:~$ '''sudo apt install -y adb'''|}</li>

<li>然后在Ubuntu PC上连接网络adb

{| class="wikitable" style="width:800px;"

|-

|

test@test:~$ '''adb connect 192.168.1.xxx''' '''(IP地址需要修改为开发板的IP地址)'''

* daemon not running; starting now at tcp:5037

* daemon started successfully

connected to 192.168.1.xxx:5555

test@test:~$ '''adb devices'''

List of devices attached

192.168.1.xxx:5555 device|}</li><li>然后在Ubuntu PC上通过adb shell就可以登录到android系统~~</li></ol>~~{| class="wikitable" style="width:800px;" |-|

test@test:~$ '''adb shell'''

console:/ #

|}

</li></ol>

= '''附录''' =

== 用户手册更新历史 ==

{| class="wikitable" style="width:800px;text-align:center;"

|-

| '''版本'''

| '''更新说明'''

|-

| v0v1.10| 2023-0708-1917

| 初始版本

|}

== 镜像更新历史 ==

{| class="wikitable" style="width:800px;"

|-

| style="text-align:center;" | '''日期'''| style="text-align:center;" | '''更新说明'''

|-

| style="text-align:center;" | 2023-0708-1917| ~~Orangepi3 b_1~~Orangepi3b_1.0.0_ubuntu_focal_server_linux5.10.160.7z Orangepi3b_1.0.0_ubuntu_jammy_server_linux5.10.160.7z Orangepi3b_1.0.0_debian_bullseye_server_linux5.10.160.7z Orangepi3b_1.0.~~0_debian_bullseye_desktop_xfce_linux5~~0_debian_bookworm_server_linux5.10.160.7z

~~Orange pi3b_1~~Orangepi3b_1.0.0_ubuntu_focal_desktop_xfce_linux5.10.160.7z Orangepi3b_1.0.0_ubuntu_jammy_desktop_xfce_linux5.10.160.7z Orangepi3b_1.0.0_debian_bullseye_desktop_xfce_linux5.10.160.7z Orangepi3b_1.0.0_debian_bookworm_desktop_xfce_linux5.10.160.7z

~~Orange pi3b_1.0.0_ubuntu_focal_desktop_xfce_linux5.10.160.7z~~

OrangePi3B_RK3566_Android11_v1.0.0.tar.gz

OrangePi3B_RK3566_Android11_spi-nvme_v1.0.0.tar.gz

~~O rangePi3B_RK3566_Android11_lcd_spi~~OrangePi3B_RK3566_Android11_lcd_spi-nvme_v1.0.0.tar.gz

* 初始版本

|}

Admin

行政员、管理员

8,460

个编辑

Wiki-Orange Pi β

更改

Orange Pi 3B

Wiki-Orange Pi ^β