查看“Orange Pi Zero 3”的源代码

<span id="orange-pi-zero-3的基本特性"></span>
= '''Orange Pi Zero 3的基本特性''' =

<span id="什么是-orange-pi-zero-3"></span>
== 什么是 Orange Pi Zero 3 ==

香橙派是一款开源的单板卡片电脑，新一代的arm64开发板，它可以运行Android TV 12、Ubuntu和Debian 等操作系统。香橙派开发板（Orange Pi Zero 3）使用全志H618系统级芯片，同时拥有 1GB 或 1.5GB 或 2GB 或 4GB LPDDR4 内存。

<span id="orange-pi-zero-3的用途"></span>

== Orange Pi Zero 3的用途 ==

我们可以用它实现：

* 一台小型的Linux桌面计算机
* 一台小型的Linux网络服务器
* 安装Klipper上位机控制3D打印机
* Android TV电视盒子

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''当然还有其他更多的功能，依托强大的生态系统以及各式各样的扩展配件，Orange Pi可以帮助用户轻松实现从创意到原型再到批量生产的交付，是创客、梦想家、业余爱好者的理想创意平台。'''</big>
|}

<span id="orange-pi-zero-3是为谁设计的"></span>

== Orange Pi Zero 3是为谁设计的 ==

Orange Pi 开发板不仅仅是一款消费品，同时也是给任何想用技术来进行创作创新的人设计的。它是一款简单、有趣、实用的工具，你可以用它去打造你身边的世界。

<span id="orange-pi-zero-3的硬件特性"></span>
== Orange Pi Zero 3的硬件特性 ==

{| class="wikitable" style="width:800px;"
|-
|colspan=2|<div style="text-align:center"><big>'''硬件特性介绍'''</big></div>
|-
| CPU
| 全志H618四核64位1.5GHz高性能Cortex-A53处理器
|-
| GPU
| Mali G31 MP2

Supports OpenGL ES 1.0/2.0/3.2、OpenCL 2.0

|-
| 内存
| 1GB/1.5GB/2GB/4GB LPDDR4 (与GPU共享）
|-
| 板载存储
| TF卡插槽、16MB SPI Flash
|-
| 以太网
| 支持10/100M/1000M以太网
|-
| WIFI+蓝牙
| • 5622芯片、支持IEEE 802.11 a/b/g/n/ac、BT5.0
|-
| 视频输出
| • Micro HDMI 2.0a

• TV CVBS output, 支持PAL/NTSC（通过13pin扩展板）

|-
| 音频输出
| • Micro HDMI输出

• 3.5mm音频口（通过13pin扩展板）

|-
| 电源
| USB Type C接口输入
|-
| USB 2.0 端口
| 3个USB 2.0 HOST（其中两个通过13pin扩展板）
|-
| 26pin接头
| 带有I2Cx1、SPIx1、UARTx1以及多个GPIO口
|-
| 13pin接头
| 带有USB 2.0 HOSTx2、TV-OUT、LINE OUT、IR-RX、以及3个GPIO口
|-
| 调试串口
| UART-TX、UART-RX以及GND
|-
| LED灯
| 电源指示灯和状态指示灯
|-
| 红外接收
| 支持红外遥控器（通过13pin扩展板）
|-
| 支持的操作系统
| Android12 TV、Ubuntu、Debian等
|-
|colspan=2|<div style="text-align:center"><big>'''外观规格介绍'''</big></div>
|-
| 产品尺寸
| 85mm×56mm
|-
| 重量
| 30g
|}

<span id="orange-pi-zero-3的顶层视图和底层视图"></span>

== Orange Pi Zero 3的顶层视图和底层视图 ==

<big>'''顶层视图：'''</big><br>

[[File:zero3-img3-1.png]]

<big>'''底层视图：'''</big><br>

[[File:zero3-img4-1.png]]

<span id="orange-pi-zero-3的接口详情图"></span>

== Orange Pi Zero 3的接口详情图 ==

[[File:zero3-img5-1.png|800px]]

[[File:zero3-img6.png|800px]]

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''四个定位孔的直径都是3.0mm。'''</big>
|}

= '''开发板使用介绍''' =

== 准备需要的配件 ==

<ol style="list-style-type: decimal;">
<li><p>TF卡，最小8GB容量的'''class10'''级或以上的高速闪迪卡</p>
<p>[[File:zero3-img7.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''使用其他品牌的TF卡（非闪迪的TF卡），如下图所示（包含但不仅限这些卡），已经有朋友反馈系统启动过程中会出现问题，比如系统启动到一半卡住不动，或者reboot命令无法正常使用，最后都是换了闪迪牌的TF卡后才解决的。所以如果您使用的是非闪迪牌的TF卡发现系统启动或者使用过程有问题，请更换闪迪牌的TF卡后再测试。'''</p></big>
<p>[[File:zero3-img8-1.png|180px]][[File:zero3-img9-1.png|195px]][[File:zero3-img10-1.png|198px]][[File:zero3-img11-1.png|190px]]</p>
<p style="text-align: center;">'''目前反馈在Orange Pi Zero 3上启动有问题的部分TF卡'''</p>
<big><p>'''另外，在其他型号的开发板上能正常使用的TF卡并不能保证在Orange Pi Zero 3上也一定能正常启动，这点请特别注意。'''</p></big>
|}
</li>
<li><p>TF卡读卡器，用于读写TF卡</p>
<p>[[File:zero3-img12.png]]</p></li>
<li><p>Micro HDMI转HDMI连接线，用于将开发板连接到HDMI显示器或者电视进行显示</p>
<div class="figure">

[[File:zero3-img13.png]]

</div>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，请不要使用下图所示的这种比较宽的Micro HDMI转接头，由于开发板的Micro HDMI接口和Type-C电源接口之间的间距比较小，可能会导致两者无法同时插入到开发板。'''</p></big>
<p>[[File:zero3-img14.png|center]]</p>
|}
</li>
<li><p>电源，如果有5V/2A或5V/3A的电源头那就只需要准备一根下面左边图片所示的USB转Type C接口的数据线，另外也可以使用类似下面右边图片所示的线和电源头一体的5V/2A或者5V/3A的高品质USB Typc C接口电源适配器。</p>
<p>[[File:zero3-img15.png|600px]] [[File:zero3-img16.png|600px]]</p></li>
<li><p>13pin扩展板</p>
<ol style="list-style-type: lower-alpha;">
<li><p>扩展板实物如下所示</p>
<p>[[File:zero3-img17.png]]</p></li>
<li><p>扩展板插入开发板的方式如下所示，切记不要插反了</p>
<p>[[File:zero3-img18.png]]</p></li>
<li><p>Orange Pi Zero 3开发板上的13pin排针可以接上扩展板来扩展开发板上没有的功能，扩展板可以使用的功能有</p>

{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;width:40px;"| 1
| style="text-align: left;width:200px;"| 麦克风（Mic）
| style="text-align: left;"| '''<span style="color:#FF0000">不支持，不支持，不支持！！！</span><br />
<br />
'''13pin扩展板是一个通用型号的扩展板，适用于Orange Pi多款开发板，但是Orange Pi Zero3的13pin接口是没有Mic功能的，所以13pin扩展板上虽然有Mic，但是在Orange Pi Zero 3上是不能用的，13pin扩展板在Orange Pi Zero 3上主要用来扩展除Mic以外的其他功能。
|-
| style="text-align: left;"| 2
| style="text-align: left;"| 模拟音视频输出接口
| style="text-align: left;"| 支持，可用于接耳机播放音乐，或者通过AV线接电视输出模拟音视频信号（'''仅安卓系统'''）。
|-
| style="text-align: left;"| 3
| style="text-align: left;"| USB 2.0 Host x 2
| style="text-align: left;"| 支持，用于接USB键盘、鼠标以及USB存储设备。
|-
| style="text-align: left;"| 4
| style="text-align: left;"| 红外接收功能
| style="text-align: left;"| 支持，通过红外遥控可以控制Android系统。
|}
</li></ol>
<ol start="4" style="list-style-type: lower-alpha;">
<li><p>Orange Pi Zero 3开发板13pin排针的原理图如下所示</p>
<p>[[File:zero3-img19.png]]</p></li></ol>
</ol>
<!-- -->
<ol start="6" style="list-style-type: decimal;">
<li><p>USB接口的鼠标和键盘，只要是标准USB接口的鼠标和键盘都可以，鼠标和键盘可以用来控制Orange Pi开发板</p></li>
<li><p>红外遥控器，主要用于控制安卓TV系统</p>
<p>[[File:zero3-img20.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，空调的遥控或者电视机的遥控是无法控制Orange Pi开发板的，默认只有Orange Pi提供的遥控才可以。'''</p></big>
|}
</li>
<li><p>百兆或者千兆网线，用于将开发板连接到因特网</p></li>
<li><p>AV视频线，如果希望通过AV接口而不是HDMI接口来显示视频，那么就需要通过AV视频线将开发板连接到电视</p>
<p>[[File:zero3-img21.png]]</p></li>
<li><p>散热片，如果担心开发板的温度过高，可以加个散热片，散热片贴在H618芯片上即可</p>
<p>[[File:zero3-img22.png]] [[File:zero3-img23-1.png]]</p></li>
<li><p>5V的散热风扇，如下图所示，开发板的26pin和13pin接口上都有5V和GND引脚可以接散热风扇，26pin和13pin排针的间距为'''2.54mm'''，散热风扇的电源接口参照这个规格去购买即可。</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，开发板插上电源后5V引脚就可以直接使用，无需其他设置，另外5V引脚输出的电压是无法通过软件调节和关闭的。'''</p></big>
|}
<p>[[File:zero3-img24-1.png]]</p></li>
<li><p>配套外壳'''（待添加图片）'''</p></li>
<li><p>USB转TTL模块和杜邦线，使用串口调试功能时，需要USB转TTL模块和杜邦线来连接开发板和电脑</p>
<p>[[File:zero3-img25.png]] [[File:zero3-img26.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，开发板使用的TTL电平是3.3v的，除了上图所示的USB转TTL模块外，其他类似的3.3v的USB转TTL模块一般也都是可以的。'''</p></big>
|}
</li>
<li><p>安装有Ubuntu和Windows操作系统的X64电脑</p>

{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| 1
| style="text-align: left;"| Ubuntu22.04 PC
| style="text-align: left;"| 可选，用于编译Android和Linux源码
|-
| style="text-align: left;"| 2
| style="text-align: left;"| Windows PC
| style="text-align: left;"| 用于烧录Android和Linux镜像
|}
</li></ol>

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

# 中文版资料的下载网址为
::{| class="wikitable" style="width:800px;" 
|-
| 
'''http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html'''
|}

<ol start="2" style="list-style-type: decimal;">
<li><p>英文版资料的下载网址为</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html'''</p>
|}
</li>
<li><p>资料主要包含</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''Android源码'''：保存在百度云盘和谷歌网盘上</p></li>
<li><p>'''Linux源码'''：保存在Github上</p></li>
<li><p>'''Android镜像'''：保存在百度云盘和谷歌网盘上</p></li>
<li><p>'''Ubuntu镜像'''：保存在百度云盘和谷歌网盘上</p></li>
<li><p>'''Debian镜像'''：保存在百度云盘和谷歌网盘上</p></li>
<li><p>'''用户手册和原理图：'''芯片相关的数据手册也会放在这里</p></li>
<li><p>'''官方工具：'''主要包括开发板使用过程中需要用到的软件</p></li></ol>
</li></ol>

<span id="基于windows-pc将linux镜像烧写到tf卡的方法"></span>

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian或者Ubuntu这样的Linux发行版镜像。'''</big>
|}

<span id="使用balenaetcher烧录linux镜像的方法"></span>
=== 使用balenaEtcher烧录Linux镜像的方法 ===

# 首先准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为'''class10'''级或'''class10'''级以上，建议使用闪迪等品牌的TF卡
# 然后使用读卡器把TF卡插入电脑
# 从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在1GB以上
# 然后下载Linux镜像的烧录软件——'''balenaEtcher'''，下载地址为
::{| class="wikitable" style="width:800px;" 
|-
| 
[https://www.balena.io/etcher/ '''https://www.balena.io/etcher/''']
|}

<ol start="5" style="list-style-type: decimal;">
<li><p>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方</p>
<p>[[File:zero3-img27.png]]</p></li>
<li><p>然后可以选择下载balenaEtcher的Portable版本的软件，Portable版本无需安装，双击打开就可以使用</p>
<p>[[File:zero3-img28.png]]</p></li>
<li><p>如果下载的是需要安装版本的balenaEtcher，请先安装再使用。如果下载的Portable版本balenaEtcher，直接双击打开即可，打开后的balenaEtcher界面如下图所示</p>
<p>[[File:zero3-img29.png]]</p>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''打开balenaEtcher时如果提示下面的错误：'''</big>

[[File:zero3-img30.png|center]]

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

[[File:zero3-img31.png|center]]
|}
</li></ol>
<ol start="8" style="list-style-type: decimal;">
<li><p>使用balenaEtcher烧录Linux镜像的具体步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先选择要烧录的Linux镜像文件的路径</p></li>
<li><p>然后选择TF卡的盘符</p></li>
<li><p>最后点击Flash就会开始烧录Linux镜像到TF卡中</p>
<p>[[File:zero3-img32.png]]</p></li></ol>
</li>
<li><p>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中</p>
<p>[[File:zero3-img33.png]]</p></li>
<li><p>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验</p>
<p>[[File:zero3-img34.png]]</p></li>
<li><p>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了</p>
<p>[[File:zero3-img35.png]]</p></li></ol>

<span id="使用win32diskimager烧录linux镜像的方法"></span>

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

<ol style="list-style-type: decimal;">
<li><p>首先准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为'''class10'''级或'''class10'''级以上，建议使用闪迪等品牌的TF卡</p></li>
<li><p>然后使用读卡器把TF卡插入电脑</p></li>
<li><p>接着格式化TF卡</p>
<ol style="list-style-type: lower-alpha;">
<li>可以使用'''SD Card Formatter'''这个软件格式化TF卡，其下载地址为</li>
{| class="wikitable" style="width:800px;" 
|-
| 
[https://www.sdcard.org/downloads/formatter/eula_windows/SDCardFormatterv5_WinEN.zip '''https://www.sdcard.org/downloads/formatter/eula_windows/SDCardFormatterv5_WinEN.zip''']
|}
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>下载完后直接解压安装即可，然后打开软件</p></li>
<li><p>如果电脑只插入了TF卡，则”'''Select card'''”一栏中会显示TF卡的盘符，如果电脑插入了多个USB存储设备，可以通过下拉框选择TF卡对应的盘符</p>
<div class="figure">

[[File:zero3-img36.png]]

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

[[File:zero3-img37.png]]
</ol>
<ol start="5" style="list-style-type: lower-alpha;">
<li><p>格式化完TF卡后会弹出下图所示的信息，点击确定即可</p>
<p>[[File:zero3-img38.png]]</p></li></ol>
</li></ol>
<!-- -->
<ol start="4" style="list-style-type: decimal;">
<li><p>从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在1GB以上</p></li>
<li><p>使用'''Win32Diskimager'''烧录Linux镜像到TF卡</p>
<ol style="list-style-type: lower-alpha;">
<li>Win32Diskimager的下载页面为</li>
{| class="wikitable" style="width:800px;" 
|-
| 
[http://sourceforge.net/projects/win32diskimager/files/Archive/ '''http://sourceforge.net/projects/win32diskimager/files/Archive/''']
|}
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>下载完后直接安装即可，Win32Diskimager界面如下所示</p>
<ol style="list-style-type: none;">
<li><p>a) 首先选择镜像文件的路径</p></li>
<li><p>b) 然后确认下TF卡的盘符和”'''设备'''”一栏中显示的一致</p></li>
<li><p>c) 最后点击”'''写入'''”即可开始烧录</p>
<p>[[File:zero3-img39.png]]</p></li></ol>
</li>
<li><p>镜像写入完成后，点击”'''退出'''”按钮退出即可，然后就可以拔出TF卡插到开发板中启动</p></li></ol>
</li></ol>
<span id="基于ubuntu-pc将linux镜像烧写到tf卡的方法"></span>

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，这里说的Linux镜像具体指的是从Orange Pi资料下载页面下载的Debian或者Ubuntu这样的Linux发行版镜像，Ubuntu PC指的是安装了Ubuntu系统的个人电脑。'''</big>
|}

# 首先准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为'''class10'''级或'''class10'''级以上，建议使用闪迪等品牌的TF卡
# 然后使用读卡器把TF卡插入电脑
# 下载balenaEtcher软件，下载地址为
::{| class="wikitable" style="width:800px;" 
|-
| 
[https://www.balena.io/etcher/ '''https://www.balena.io/etcher/''']
|}

<ol start="4" style="list-style-type: decimal;">
<li><p>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方</p>
<p>[[File:zero3-img27.png]]</p></li>
<li><p>然后选择下载Linux版本的软件即可</p>
<p>[[File:zero3-img40.png]]</p></li>
<li><p>从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在1GB以上。7z结尾的压缩包的解压命令如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''7z x orangepizero3_1.0.0_ubuntu_focal_desktop_linux6.1.31.7z'''</p>
<p>test@test:~$ '''ls orangepizero3_1.0.0_ubuntu_focal_desktop_linux6.1.31.*'''</p>
<p>orangepizero3_1.0.0_ubuntu_focal_desktop_linux6.1.31.7z </p>
<p>'''orangepizero3_1.0.0_ubuntu_focal_desktop_linux6.1.31.sha''' #校验和文件</p>
<p>'''orangepizero3_1.0.0_ubuntu_focal_desktop_linux6.1.31.img''' #镜像文件</p>
|}
</li>
<li><p>解压镜像后可以先用'''sha256sum -c *.sha'''命令计算下校验和是否正确，如果提示'''成功'''说明下载的镜像没有错，可以放心的烧录到TF卡，如果提示'''校验和不匹配'''说明下载的镜像有问题，请尝试重新下载</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sha256sum -c *.sha'''</p>
<p>orangepizero3_1.0.0_ubuntu_focal_desktop_linux6.1.31.img: '''成功'''</p>
|}
</li>
<li><p>然后在Ubuntu PC的图形界面双击'''balenaEtcher-1.14.3-x64.AppImage'''即可打开balenaEtcher（'''无需安装'''），balenaEtcher打开后的界面显示如下图所示</p>
<p>[[File:zero3-img41.png]]</p></li>
<li><p>使用balenaEtcher烧录Linux镜像的具体步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先选择要烧录的Linux镜像文件的路径</p></li>
<li><p>然后选择TF卡的盘符</p></li>
<li><p>最后点击Flash就会开始烧录Linux镜像到TF卡中</p>
<p>[[File:zero3-img42.png]]</p></li></ol>
</li>
<li><p>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中</p>
<p>[[File:zero3-img43.png]]</p></li></ol>

<!-- -->
<ol start="11" style="list-style-type: decimal;">
<li><p>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验</p>
<p>[[File:zero3-img44.png]]</p></li>
<li><p>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了</p>
<p>[[File:zero3-img45.png]]</p></li></ol>

<span id="烧写android镜像到tf卡的方法"></span>

== 烧写Android镜像到TF卡的方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''开发板的Android镜像只能在Windows平台下使用<span style="color:#FF0000">PhoenixCard</span>软件烧录到TF卡中，PhoenixCard软件的版本必须为<span style="color:#FF0000">PhonixCard-4.2.8</span>。'''

'''请不要用烧录Linux镜像的软件，如Win32Diskimager或者balenaEtcher来烧录安卓镜像。'''

'''另外PhoenixCard这款软件没有Linux和Mac平台的版本，所以在Linux和Mac平台下是无法烧录安卓镜像到TF卡中的。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先请确保Windows系统已经安装了'''Microsoft Visual C++ 2008 Redistrbutable - x86'''</p>
<p>[[File:zero3-img46.png]]</p></li>
<li><p>如果没有安装'''Microsoft Visual C++ 2008 Redistrbutable - x86'''，使用'''PhoenixCard'''格式化TF卡或者烧录Android镜像会提示下面的错误</p>
<div class="figure">

[[File:zero3-img47.png]]

</div></li>
<li><p>'''Microsoft Visual C++ 2008 Redistrbutable - x86'''的安装包可以从Orange Pi Zero 3的[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''官方工具''']中下载到，也可以去[https://www.microsoft.com/zh-cn/download/details.aspx?id=26368 '''微软官网''']下载</p>
<p>[[File:zero3-img48.png]] [[File:zero3-img49.png]]</p></li>
<li><p>然后准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为'''class10'''级或'''class10'''级以上，建议使用闪迪等品牌的TF卡</p></li>
<li><p>然后使用读卡器把TF卡插入电脑</p></li>
<li><p>从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']下载Android镜像和PhoenixCard烧写工具，请确保PhonenixCrad工具的版本为'''<span style="color:#FF0000">PhonixCard-4.2.8，请不要用低于4.2.8版本的PhonixCard软件来烧录Android镜像，</span>'''低于这个版本的PhonixCard工具烧写的Android镜像可能会有问题</p>
<p>[[File:zero3-img50.png]]</p></li>
<li><p>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”'''.img'''” 结尾的文件就是Android镜像文件，大小在1GB以上。如果不知道怎么解压Android镜像的压缩包，可以安装一个[https://yasuo.360.cn/ '''360压缩软件''']来解压镜像。</p>
<p>[[File:zero3-img51.png]]</p></li>
<li><p>然后使用解压软件解压'''PhonixCard4.2.8.zip'''，此软件无需安装，在解压后的文件夹中找到PhoenixCard打开即可</p>
<p>[[File:zero3-img52.png]]</p></li>
<li><p>打开PhoenixCard后，如果TF卡识别正常，会在中间的列表中显示TF卡的盘符和容量，'''<span style="color:#FF0000">请务必确认显示的盘符和你想烧录的TF卡的盘符是一致的</span>'''，如果没有显示可以尝试拔插下TF卡，或者点击PhoenixCard中的”'''刷新盘符'''”按钮</p></li>

[[File:zero3-img53-1.png]]
</ol>
<ol start="10" style="list-style-type: decimal;">
<li><p>确认完盘符后，先格式化TF卡，点击PhoenixCard中”'''恢复卡'''”按钮即可（如果”'''恢复卡'''”按钮为灰色的无法按下，可以先点击下”'''刷新盘符'''”按钮）</p>
<p>[[File:zero3-img54-1.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''如果格式化有问题，请尝试拔插下TF卡后再测试，如果重新拔插TF卡后还是有问题，可以重启下Window电脑或者换一台电脑再试下。'''</p></big>
|}
</li>
<li><p>然后开始将Android镜像写入TF卡</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先在”'''固件'''”一栏中选择Android镜像的路径</p></li>
<li><p>在”'''制作卡的种类'''”中选择”'''启动卡'''”</p></li>
<li><p>然后点击”'''烧卡'''”按钮就会开始烧录</p>
<p>[[File:zero3-img55-1.png]]</p></li></ol>
</li>
<li><p>烧录完后PhoenixCard的显示如下图所示，此时点击”'''关闭'''”按钮即可退出PhoenixCard，然后就可以把TF卡从电脑中拔出来插到开发板中启动了</p>
<p>[[File:zero3-img56-1.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''烧录完Android系统后在Windows中TF卡只能看到一个128 MB的分区，显示的分区如下图所示（有些电脑可能会弹出二十几个磁盘分区，但也只能打开128 MB的那个分区），请注意，这是正常的，请不要以为TF卡烧坏了。之所以这样，是因为安卓系统总共有二十几个分区，但大部分分区在Windows系统中是无法正常识别的。此时，请放心的拔下TF卡然后插入开发板中启动即可。'''</p></big>
<p>[[File:zero3-img57.png|center]]</p>
<big><p>'''安卓系统启动后，使用下面的命令可以看到TF卡中的这二十几个分区：'''</p></big>
<p>[[File:zero3-img58.png|center]]</p>
<big><p>'''使用df -h命令可以看到16GB的TF卡烧录完安卓系统后大概还有11 GB的空间可以用使用（二十几个分区并不会都挂载到安卓系统中，重点关注这些能看到的分区即可）。'''</p></big>
<p>[[File:zero3-img59.png|center]]</p>
|}
</li></ol>

<span id="板载spi-flash中的微型linux系统使用说明"></span>

== 板载SPI Flash中的微型linux系统使用说明 ==

开发板上有一个16MB大小的SPI Flash，其所在位置如下图所示：

[[File:zero3-img60-1.png]]

SPI Flash中默认烧录有一个微型的linux系统，此系统主要用于证明开发板是能正常启动的。当拿到开发板后，不用烧录系统到TF卡中，只需要给开发板接上Type-C电源就能启动SPI Flash中的微型linux系统。此系统的主要功能有：

<ol style="list-style-type: lower-alpha;">
<li><p>u-boot启动阶段会点亮红色的led灯，进入内核后，会关闭红色的led灯并设置绿色的led灯闪烁；</p></li>
<li><p>如果开发板接了HDMI屏幕，系统启动完成后，在HDMI屏幕中能看到微型linux系统的命令行界面；</p></li>
<li><p>如果开发板接了USB键盘，在命令行中能运行一些简单的linux命令，如ls，cd等。</p></li></ol>
<p>由于SPI Flash中微型的linux系统功能有限，所以如果想正常使用开发板的所有功能，请烧录linux镜像或者安卓镜像烧录到TF卡中，然后再使用。</p>

== 启动香橙派开发板 ==

# 将烧录好镜像的TF卡插入香橙派开发板的TF卡插槽中
# 开发板有Micro HDMI接口，可以通过Micro HDMI转HDMI连接线把开发板连接到电视或者HDMI显示器
# 如果购买了13pin的扩展板，可以将13pin的扩展板插到开发板的13pin接口中
# 接上USB鼠标和键盘，用于控制香橙派开发板
# 开发板有以太网口，可以插入网线用来上网
# 连接一个5V/2A（5V/3A的也可以）的USB Type C接口的'''高品质'''的电源适配

::{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''<span style="color:#FF0000">切记不要插入电压输出大于5V的电源适配器，会烧坏开发板。</span>'''

'''<span style="color:#FF0000">系统上电启动过程中很多不稳定的现象基本都是供电有问题导致的，所以一个靠谱的电源适配器很重要。如果启动过程中发现有不断重启的现象，请更换下电源或者Type C数据线再试下。</span>'''</big>
|}

<ol start="7" style="list-style-type: decimal;">
<li><p>然后打开电源适配器的开关，如果一切正常，此时HDMI显示器就能看到系统的启动画面了</p></li>
<li><p>如果想通过调试串口查看系统的输出信息，请使用串口线将开发板连接到电脑，串口的连接方法请参看[[Orange Pi Zero 3#调试串口的使用方法|'''调试串口的使用方法''']]一节</p></li></ol>

== 调试串口的使用方法 ==

=== 调试串口的连接说明 ===

<ol style="list-style-type: decimal;">
<li><p>首先需要准备一个'''3.3v'''的USB转TTL模块，然后将USB转TTL模块的USB接口一端插入到电脑的USB接口中</p>
<p>[[File:zero3-img61.png]]</p></li>
<li><p>开发板的调试串口GND、TX和RX引脚的对应关系如下图所示</p>
<p>[[File:zero3-img62-1.png]]</p></li>
<li><p>USB转TTL模块GND、TX和RX引脚需要通过杜邦线连接到开发板的调试串口上</p>
<ol style="list-style-type: lower-alpha;">
<li><p>USB转TTL模块的GND接到开发板的GND上</p></li>
<li><p>USB转TTL模块的'''<span style="color:#FF0000">RX接到开发板的TX上</span>'''</p></li>
<li><p>USB转TTL模块的'''<span style="color:#FF0000">TX接到开发板的RX上</span>'''</p></li></ol>
</li>
<li><p>USB转TTL模块连接电脑和Orange Pi开发板的示意图如下所示</p>
<p>[[File:zero3-img63.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''串口的TX和RX是需要交叉连接的，如果不想仔细区分TX和RX的顺序，可以把串口的TX和RX先随便接上，如果测试串口没有输出再交换下TX和RX的顺序，这样就总有一种顺序是对的。'''</p></big>
|}
</li></ol>

<span id="ubuntu平台调试串口的使用方法"></span>

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''Linux下可以使用的串口调试软件有很多，如putty、minicom等，下面演示下putty的使用方法。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先将USB转TTL模块插入Ubuntu电脑的USB接口，如果USB转TTL模块连接识别正常，在Ubuntu PC的'''/dev'''下就可以看到对应的设备节点名，记住这个节点名，后面设置串口软件时会用到</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''ls /dev/ttyUSB*'''</p>
<p>'''/dev/ttyUSB0'''</p>
|}
</li>
<li><p>然后使用下面的命令在Ubuntu PC上安装下putty</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt update'''</p>
<p>test@test:~$ '''sudo apt install -y putty'''</p>
|}
</li>
<li><p>然后运行putty，'''<span style="color:#FF0000">记得加sudo权限</span>'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo putty'''</p>
|}
</li>
<li><p>执行putty命令后会弹出下面的界面</p>
<p>[[File:zero3-img64.png]]</p></li>
<li><p>首先选择串口的设置界面</p>
<p>[[File:zero3-img65.png]]</p></li>
<li><p>然后设置串口的参数</p>
<ol style="list-style-type: lower-alpha;">
<li><p>设置'''Serial line to connect to'''为'''/dev/ttyUSB0'''（修改为对应的节点名，一般为'''/dev/ttyUSB0'''）</p></li>
<li><p>设置'''Speed(baud)'''为'''115200'''（串口的波特率）</p></li>
<li><p>设置'''Flow control'''为'''None'''</p>
<p>[[File:zero3-img66.png]]</p></li></ol>
</li>
<li><p>在串口的设置界面设置完后，再回到Session界面</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先选择'''Connection type'''为'''Serial'''</p></li>
<li><p>然后点击'''Open'''按钮连接串口</p>
<p>[[File:zero3-img67.png]]</p></li></ol>
</li>
<li><p>然后启动开发板，就能从打开的串口终端中看到系统输出的Log信息了</p>
<p>[[File:zero3-img68.png]]</p></li></ol>

<span id="windows平台调试串口的使用方法"></span>

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''Windows下可以使用的串口调试软件有很多，如SecureCRT、MobaXterm等，下面演示MobaXterm的使用方法，这款软件有免费版本，无需购买序列号即可使用。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>下载MobaXterm</p>
<ol style="list-style-type: lower-alpha;">
<li><p>下载MobaXterm网址如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[https://mobaxterm.mobatek.net/ '''https://mobaxterm.mobatek.net/''']</p>
|}
</li>
<li><p>进入MobaXterm下载网页后点击'''GET XOBATERM NOW!'''</p>
<p>[[File:zero3-img69.png]]</p></li>
<li><p>然后选择下载Home版本</p>
<p>[[File:zero3-img70.png]]</p></li>
<li><p>然后选择Portable便携式版本，下载完后无需安装，直接打开就可以使用</p>
<div class="figure">

[[File:zero3-img71.png]]

</div></li></ol>
</li>
<li><p>下载完后使用解压缩软件解压下载的压缩包，即可得到MobaXterm的可执软件，然后双击打开</p>
<p>[[File:zero3-img72.png]]</p></li>
<li><p>打开软件后，设置串口连接的步骤如下</p>
<ol style="list-style-type: lower-alpha;">
<li><p>打开会话的设置界面</p></li>
<li><p>选择串口类型</p></li>
<li><p>选择串口的端口号（根据实际的情况选择对应的端口号），如果看不到端口号，请使用[http://weishi.360.cn/qudongdashi/ '''360驱动大师''']扫描安装USB转TTL串口芯片的驱动</p></li>
<li><p>选择串口的波特率为'''115200'''</p></li>
<li><p>最后点击”'''OK'''”按钮完成设置</p></li>

[[File:zero3-img73.png|1400px]]</ol>
</li></ol>
<ol start="4" style="list-style-type: decimal;">
<li><p>点击”'''OK'''”按钮后会进入下面的界面，此时启动开发板就能看到串口的输出信息了</p>
<p>[[File:zero3-img74.png|1400px]]</p></li></ol>

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''我们推荐的开发板的供电方式是使用5V/2A或者5V/3A的Type C接口的电源线插到开发板的Type C电源接口来供电的。如果需要使用26pin或者13pin接口中的5V引脚来给开发板供电，请确保使用的电源线能满足开发板的供电需求。如果有使用不稳定的情况，请换回Type C电源供电。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先需要准备一根下图所示的电源线</p>
<div class="figure">

[[File:zero3-img75.png]]

</div>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''上图所示的电源线在淘宝可以买到，请自行搜索购买。'''</p></big>
|}
</li>
<li><p>使用26pin或者13pin接口中的5V引脚来给开发板供电，电源线的接法如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>上图所示的电源线USB A口需要插到5V/2A或者5V/3A的电源适配器接头上（'''不建议插到电脑的USB接口来供电，如果开发板接的外设过多，使用会不稳定'''）</p></li>
<li><p>红色的杜邦线需要插到开发板26pin或者13pin接口的5V引脚上</p></li>
<li><p>黑色的杜邦线需要插到26pin或者13pin接口的GND引脚上</p></li>
<li><p>26pin和13pin接口5V引脚和GND引脚在开发板中的位置如下图所示，'''<span style="color:#FF0000">切记不要接反了</span>'''</p>
<p>[[File:zero3-img24-1.png]]</p></li></ol>
</li></ol>

<span id="使用开发板13pin接口扩展usb接口的方法"></span>

== 使用开发板13pin接口扩展USB接口的方法 ==

<ol style="list-style-type: decimal;">
<li><p>如果有购买Orange Pi的13pin扩展板，将扩展板插入开发板的13pin接口中，就可以扩展2个USB接口</p>
<p>[[File:zero3-img18.png]]</p></li>
<li><p>如果没有13pin扩展板，可以使用4pin 2.54mm杜邦转USB2.0母头的线来扩展USB接口，具体方法如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先需要准备一根4pin 2.54mm杜邦转USB2.0母头的线（这种线在淘宝可以买到，请自行搜索购买），如下图所示：</p>
<p>[[File:zero3-img76.png]] [[File:zero3-img77.png]]</p></li>
<li><p>13pin接口的原理图如下所示</p>
<p>[[File:zero3-img19.png]] [[File:zero3-img78.png]]</p></li>
<li><p>USB2的接线如下所示</p>
<p>[[File:zero3-img79.png]]</p></li>
<li><p>USB3的接线如下所示</p>
<p>[[File:zero3-img80.png]]</p></li>
<li><p>如果需要在13pin接口上同时接两个USB设备，会发现13pin接口上的5V和GND引脚不够用，此时其中一个USB设备可以使用26pin接口中的5V和GND引脚，位置如下图所示：</p>
<p>[[File:zero3-img24-1.png]]</p></li></ol>
</li></ol>

<span id="debianubuntu-server和xfce桌面系统使用说明"></span>

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

== 已支持的linux镜像类型和内核版本 ==

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''Linux镜像类型'''
| style="text-align: left;"| '''内核版本'''
| style="text-align: left;"| '''服务器版'''
| style="text-align: left;"| '''桌面版'''
|-
| style="text-align: left;"| '''Ubuntu 20.04 - Focal'''
| style="text-align: left;"| '''Linux5.4'''
| style="text-align: left;"| '''支持'''
| style="text-align: left;"| '''支持'''
|-
| style="text-align: left;"| '''Ubuntu 22.04 - <span style="color:#FF0000">Jammy</span>'''
| style="text-align: left;"| '''Linux5.4'''
| style="text-align: left;"| '''支持'''
| style="text-align: left;"| '''支持'''
|-
| style="text-align: left;"| '''Debian 11 - Bullseye'''
| style="text-align: left;"| '''Linux5.4'''
| style="text-align: left;"| '''支持'''
| style="text-align: left;"| '''支持'''
|-
| style="text-align: left;"| '''Ubuntu 22.04 - Jammy'''
| style="text-align: left;"| '''Linux6.1'''
| style="text-align: left;"| '''支持'''
| style="text-align: left;"| '''支持'''
|-
| style="text-align: left;"| '''Debian 11 - Bullseye'''
| style="text-align: left;"| '''Linux6.1'''
| style="text-align: left;"| '''支持'''
| style="text-align: left;"| '''支持'''
|-
| style="text-align: left;"| '''Debian 12 - Bookworm'''
| style="text-align: left;"| '''Linux6.1'''
| style="text-align: left;"| '''支持'''
| style="text-align: left;"| '''支持'''
|}

在[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']进入对应开发板的下载页面后可以看到下面的下载选项，在下文的描述中，'''Ubuntu镜像和Debian镜像一般统称为Linux镜像'''。

<div class="figure">

[[File:zero3-img81.png]]

</div>
Linux镜像的命名规则为：

{| class="wikitable" style="width:800px;" 
|-
| 
'''开发板型号_版本号_Linux发行版类型_发行版代号_服务器或桌面_内核版本'''
|}

<ol style="list-style-type: lower-alpha;">
<li><p>'''开发板的型号'''：都是'''orangepizero3'''。不同开发板的型号名一般都是不同的，烧录镜像前，请确保所选择镜像的这个型号名和开发板是匹配的。</p></li>
<li><p>'''版本号'''：如'''1.x.x'''，这个版本号会随着镜像功能的更新而递增，另外开发板Linux镜像的版本号最后一个数字都是偶数。</p></li>
<li><p>'''Linux发行版的类型'''：目前支持'''Ubuntu'''和'''Debian。'''由于Ubuntu源自Debian，所以两个系统在使用上来说总体区别不大。但部分软件的默认配置和命令的使用上还是有些许区别的，另外Ubuntu和Debian都各自有维护所支持的软件仓库，在支持的可安装的软件包上也是有些许差异的。这些需要亲自去使用体验才会有比较深刻的认识。有关更多的细节，可以参考下Ubuntu和Debian官方提供的文档。</p></li>
<li><p>'''发行版代号'''：用来区分Ubuntu或者Debian这样具体的Linux发行版的不同版本。其中'''focal'''和'''jammy'''都是Ubuntu发行版，focal表示Ubuntu20.04，jammy表示Ubuntu22.04，不同版本的最大的区别是新版本的Ubuntu系统维护的软件仓库的中的软件很多都比旧版本的Ubuntu系统中的要新，比如Python和GCC编译工具链等。'''bullseye'''是Debian的具体版本代号，'''bullseye'''表示Debian11，'''bookworm'''表示Debian12。</p></li>
<li><p>'''服务器或桌面'''：用来表示系统是否带桌面环境，如果为'''server'''就表示系统没有安装桌面环境，镜像占用的存储空间和资源比较小，主要使用命令行来操作控制系统。如果为'''desktop_xfce'''就表示系统默认安装有XFCE桌面环境，镜像占用的存储空间和资源比较大，可以接显示器和鼠标键盘通过界面来操作系统。当然desktop版本的系统也可以像server版本的系统一样通过命令行来操作。</p></li>
<li><p>'''内核版本'''：用来表示linux内核的版本号，目前支持'''linux5.4'''和'''linux6.1'''。</p></li></ol>

== linux内核驱动适配情况 ==

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''功能'''
| style="text-align: left;"| '''Linux5.4'''
| style="text-align: left;"| '''Linux6.1'''
|-
| style="text-align: left;"| '''HDMI视频'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''HDMI音频'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''USB2.0 x 3'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''TF卡启动'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''千兆网卡'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''红外接收'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''WIFI'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''蓝牙'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''耳机音频'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''USB摄像头'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''LED灯'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''26pin GPIO'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''26pin I2C'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''26pin SPI1'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''26pin UART'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''PWM'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''温度传感器'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''硬件看门狗'''
| style="text-align: left;"| '''OK'''
| style="text-align: left;"| '''OK'''
|-
| style="text-align: left;"| '''Mali GPU'''
| style="text-align: left;"| '''<span style="color:#FF0000">NO</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">NO</span>'''
|-
| style="text-align: left;"| '''视频编解码'''
| style="text-align: left;"| '''<span style="color:#FF0000">NO</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">NO</span>'''
|-
| style="text-align: left;"| '''TV-OUT'''
| style="text-align: left;"| '''<span style="color:#FF0000">NO</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">NO</span>'''
|}

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

<ol style="list-style-type: decimal;">
<li><p>本手册中所有需要在Linux系统中输入的命令都会使用下面的方框框起来</p>
{| class="wikitable" style="width:800px;height: 40px" 
|-
| 

|}
<p>如下所示，黄色方框里内容表示需要特别注意的内容，这里面的命令除外。</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;height: 40px" 
|-
| 

|}
</li>
<li><p>命令前面的提示符类型说明</p>
<ol style="list-style-type: lower-alpha;">
<li><p>命令前面提示符指的是下面方框内红色部分的内容，这部分内容不是linux命令的一部分，所以在linux系统中输入命令时，请不要把红色字体部分的内容也输入进去。</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''<span style="color:#FF0000">orangepi@orangepi:~$</span> sudo apt update'''</p>
<p>'''<span style="color:#FF0000">root@orangepi:~#</span>''' '''vim /boot/boot.cmd'''</p>
<p>'''<span style="color:#FF0000">test@test:~$</span> ssh [mailto:root@192.168.1.36 root@192.168.1.]xxx'''</p>
<p>'''<span style="color:#FF0000">root@test:~#</span> ls'''</p>
|}
</li>
<li><p>'''<span style="color:#FF0000">root@orangepi:~$</span>''' 提示符表示这个命令是在'''开发板的linux系统'''中输入的， 提示符最后的 '''<span style="color:#FF0000">$</span>''' 表示系统当前用户为普通用户，当执行特权命令时，需要加上'''sudo'''</p></li>
<li><p>'''<span style="color:#FF0000">root@orangepi:~#</span>''' 提示符表示这个命令是在'''开发板的linux系统'''中输入的， 提示符最后的 '''<span style="color:#FF0000">#</span>''' 表示系统当前用户为root用户，可以执行任何想要执行的命令</p></li>
<li><p>'''<span style="color:#FF0000">test@test:~$</span>''' 提示符表示这个命令是在Ubuntu PC或者Ubuntu虚拟机中输入的，而不是开发板的linux系统中。提示符最后的 '''<span style="color:#FF0000">$</span>''' 表示系统当前用户为普通用户，当执行特权命令时，需要加上'''sudo'''</p></li>
<li><p>'''<span style="color:#FF0000">root@test:~#</span>''' 提示符表示这个命令是在Ubuntu PC或者Ubuntu虚拟机中输入的，而不是开发板的linux系统中。提示符最后的 '''<span style="color:#FF0000">#</span>''' 表示系统当前用户为root用户，可以执行任何想要执行的命令</p></li></ol>
</li>
<li><p>哪些是需要输入的命令？</p>
<ol style="list-style-type: lower-alpha;">
<li><p>如下所示，'''黑色加粗部分'''是需要输入的命令，命令下面的是输出的内容（有些命令有输出，有些可能没有输出），这部分内容是不需要输入的</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''cat /boot/orangepiEnv.txt'''</p>
<p>'''<span style="color:#FF0000">verbosity=7</span>'''</p>
<p>bootlogo=false</p>
<p>'''<span style="color:#FF0000">console=serial</span>'''</p>
|}
</li>
<li><p>如下所示，有些命令一行写不下会放到下一行，只要黑色加粗的部分就都是需要输入的命令。当这些命令输入到一行的时候，每行最后的”'''\'''”是需要去掉的，这个不是命令的一部分。另外命令的不同部分都是有空格的，请别漏了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''echo \'''</p>
<p>'''&quot;deb [arch=$(dpkg --print-architecture) \'''</p>
<p>'''signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \'''</p>
<p>'''https://download.docker.com/linux/debian \'''</p>
<p>'''$(lsb_release -cs) stable&quot; | sudo tee /etc/apt/sources.list.d/docker.list &gt; /dev/null'''</p>
|}
</li></ol>
</li></ol>

== linux系统登录说明 ==

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

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''账号'''
| style="text-align: left;"| '''密码'''
|-
| style="text-align: left;"| '''root'''
| style="text-align: left;"| '''orangepi'''
|-
| style="text-align: left;"| '''orangepi'''
| style="text-align: left;"| '''orangepi'''
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，输入密码的时候，<span style="color:#FF0000">屏幕上是不会显示输入的密码的具体内容的</span>，请不要以为是有什么故障，输入完后直接回车即可。'''</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''当输入密码提示错误，或者ssh连接有问题，请注意，只要使用的是Orange Pi提供的Linux镜像，<span style="color:#FF0000">就请不要怀疑上面的密码不对</span>，而是要找其它的原因。'''</big>
|}

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

<ol style="list-style-type: decimal;">
<li><p>linux系统默认就是自动登录终端的，默认登录的用户名是'''orangepi'''</p>
<p>[[File:zero3-img82.png]]</p></li>
<li><p>使用下面的命令可以设置root用户自动登录终端</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo auto_login_cli.sh root'''</p>
|}
</li>
<li><p>使用下面的命令可以禁止自动登录终端</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo auto_login_cli.sh -d'''</p>
|}
</li>
<li><p>使用下面的命令可以再次设置orangepi用户自动登录终端</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo auto_login_cli.sh orangepi'''</p>
|}
</li></ol>

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

<ol style="list-style-type: decimal;">
<li><p>桌面版系统启动后会自动登录进入桌面，无需输入密码</p>
<div class="figure">

[[File:zero3-img83.png]]

</div></li>
<li><p>运行下面的命令可以禁止桌面版系统自动登录桌面</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo disable_desktop_autologin.sh'''</p>
|}
</li>
<li><p>然后重启系统就会出现登录对话框，此时需要输入'''密码'''才能进入系统</p>

<div class="figure">

[[File:zero3-img84.png]]

</div>
</li></ol>
<span id="linux桌面版系统root用户自动登录的设置方法"></span>

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

<ol style="list-style-type: decimal;">
<li><p>执行下面的命令可以设置桌面版系统使用root用户自动登录</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo desktop_login.sh root'''</p>
|}
</li>
<li><p>然后重启系统，就会自动使用root用户登录桌面了</p>
<p>[[File:zero3-img85.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，如果使用root用户登录桌面系统，是无法使用右上角的pulseaudio来管理音频设备的。'''</p>
<p>'''另外请注意这并不是一个bug，因为pulseaudio本来就不允许在root用户下运行。'''</p></big>
|}
</li>
<li><p>执行下面的命令可以再次设置桌面版系统使用orangepi用户自动登录</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo desktop_login.sh orangepi'''</p>
|}
</li></ol>

<span id="linux桌面版系统禁用桌面的方法"></span>

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

<ol style="list-style-type: decimal;">
<li><p>首先在命令行中输入下面的命令，'''<span style="color:#FF0000">请记得加sudo权限</span>'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo systemctl disable lightdm.service'''</p>
|}
</li>
<li><p>然后重启Linux系统就会发现不会显示桌面了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo reboot'''</p>
|}
</li>
<li><p>重新打开桌面的命令如下所示，'''<span style="color:#FF0000">请记得加sudo权限</span>'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo systemctl start lightdm.service'''</p>
<p>orangepi@orangepi:~$ '''sudo systemctl enable lightdm.service'''</p>
|}
</li></ol>

<span id="板载led灯测试说明"></span>

== 板载LED灯测试说明 ==

# 开发板上有两个LED灯，一个绿灯，一个红灯，系统启动时LED灯默认显示情况如下所示：

::{| class="wikitable" style="width:800px;" 
|-
|
| style="text-align: left;"| '''绿灯'''
| style="text-align: left;"| '''红灯'''
|-
| '''u-boot启动阶段'''
| style="text-align: left;"| '''灭'''
| style="text-align: left;"| '''亮'''
|-
| '''内核启动到进入系统'''
| style="text-align: left;"| '''闪烁'''
| style="text-align: left;"| '''灭'''
|-
| '''GPIO口'''
| style="text-align: left;"| '''PC13'''
| style="text-align: left;"| '''PC12'''
|}

::{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''开发板上的两个LED灯都是通过软件来控制的。'''

'''当拿到开发板后，您可能会发现开发板上就算没有插入烧录有系统的TF卡，给开发板接上电源后，这两个LED灯也会亮，这是因为开发板上的16MB SPI Flash出厂默认会烧录一个微型的linux系统，此系统在u-boot启动阶段会点亮红灯，进入内核后会关闭红灯，设置绿灯闪烁。'''

'''如果SPI Flash中的linux系统被清空了，那么不插入烧录有系统的TF卡，接通电源后，开发板上的两个LED灯就不会亮了。'''</big>
|}

<ol start="2" style="list-style-type: decimal;">
<li><p>设置绿灯亮灭和闪烁的方法如下所示：</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的操作请在root用户下进行。'''</p></big>
|}
<ol style="list-style-type: lower-alpha;">
<li><p>首先进入绿灯的设置目录</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''cd /sys/class/leds/green_led'''</p>
|}
</li>
<li><p>设置绿灯停止闪烁的命令如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:/sys/class/leds/green_led# '''echo none &gt; trigger'''</p>
|}
</li>
<li><p>设置绿灯常亮的命令如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:/sys/class/leds/green_led# '''echo default-on &gt; trigger'''</p>
|}
</li>
<li><p>设置绿灯闪烁的命令如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:/sys/class/leds/green_led# '''echo heartbeat &gt; trigger'''</p>
|}
</li></ol>
</li>
<li><p>设置红灯亮灭和闪烁的方法如下所示：</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的操作请在root用户下进行。'''</p></big>
|}
<ol style="list-style-type: lower-alpha;">
<li><p>首先进入红灯的设置目录</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''cd /sys/class/leds/red_led'''</p>
|}
</li>
<li><p>设置红灯常亮的命令如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:/sys/class/leds/red_led# '''echo default-on &gt; trigger'''</p>
|}
</li>
<li><p>设置红灯闪烁的命令如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:/sys/class/leds/red_led# '''echo heartbeat &gt; trigger'''</p>
|}
</li>
<li><p>设置红灯停止闪烁的命令如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:/sys/class/leds/red_led# '''echo none &gt; trigger'''</p>
|}
</li></ol>
</li>
<li><p>如果开机后不需要LED灯闪烁，可以使用下面的方法来关闭绿灯闪烁</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''disable-leds'''</p>
<p>[[File:zero3-img88.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li>
<li><p>重启后完全进入系统就可以看到开发板上的两个LED灯都不会亮了</p></li></ol>
</li></ol>

<span id="tf卡中linux系统rootfs分区容量操作说明"></span>

== TF卡中linux系统rootfs分区容量操作说明 ==

<span id="第一次启动会自动扩容tf卡中rootfs分区的容量"></span>
=== 第一次启动会自动扩容TF卡中rootfs分区的容量 ===

<ol style="list-style-type: decimal;">
<li><p>将开发板的Linux镜像烧录到TF卡中后，可以在'''<span style="color:#FF0000">Ubuntu电脑</span>'''中查看下TF卡容量的使用情况，步骤如下所示：</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，这一步不操作是不影响开发板的Linux系统自动扩容的。这里只是想说明TF卡烧录完Linux镜像后，怎么查看TF卡容量的方法。'''</p></big>
|}
<ol style="list-style-type: lower-alpha;">
<li><p>首先在Ubuntu电脑中安装下gparted这个软件</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt install -y gparted'''</p>
|}
</li>
<li><p>然后打开gparted</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo gparted'''</p>
|}
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况</p>
<p>[[File:zero3-img92.png]]</p></li>
<li><p>上图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配</p></li></ol>
</li>
<li><p>然后可以将烧录好Linux系统的TF卡插入开发板中启动，TF卡第一次启动linux系统时会通过'''orangepi-resize-filesystem.service'''这个systemd服务来调用'''orangepi-resize-filesystem'''脚本自动进行rootfs分区的扩容，所以'''<span style="color:#FF0000">无需再手动扩容</span>'''</p></li>
<li><p>登录系统后可以通过'''df -h'''命令来查看rootfs的大小，如果和TF卡的实际容量一致，说明自动扩容运行正确</p>

{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''df -h'''</p>
<span style="margin-right: 80px;">Filesystem </span><span style="margin-right: 50px;">Size </span><span style="margin-right: 30px;">Used </span><span style="margin-right: 30px;">Avail</span><span style="margin-right: 50px;">Use% Mounted on</span><br>
<span style="margin-right: 110px;">udev</span><span style="margin-right: 60px;">430M</span><span style="margin-right: 50px;">0</span><span style="margin-right: 70px;">430M </span><span style="margin-right: 90px;">0% /dev</span><br>
<span style="margin-right: 100px;">tmpfs </span><span style="margin-right: 50px;">100M </span><span style="margin-right: 30px;">5.6M </span><span style="margin-right: 70px;">95M </span><span style="margin-right: 90px;">6% /run</span><br>
<span style="margin-right: 25px;color:#FF0000">'''/dev/mmcblk0p1'''</span><span style="margin-right: 50px;color:#FF0000">'''15G'''</span><span style="margin-right: 35px;color:#FF0000">'''915M'''</span><span style="margin-right: 80px;color:#FF0000">'''14G'''</span><span style="margin-right: 90px;color:#FF0000">'''7% /'''</span><br>
<span style="margin-right: 100px;">tmpfs </span><span style="margin-right: 60px;">500M </span><span style="margin-right: 50px;">0</span><span style="margin-right: 50px;">500M </span><span style="margin-right: 90px;">0% /dev/shm</span><br>
|}
</li></ol>

<ol start="4" style="list-style-type: decimal;">
<li><p>第一次启动完Linux系统后，我们还可以将TF卡从开发板中取下来重新插入'''<span style="color:#FF0000">Ubuntu电脑</span>'''，然后再次使用gparted查看下TF卡的情况，如下图所示，rootfs分区（/dev/sdc1）的容量已经扩展到了14.69GiB了</p>
<p>[[File:zero3-img93.png]]</p>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''需要注意的是，linux系统只有一个ext4格式的分区，没有使用单独的BOOT分区来存放内核镜像等文件，所以也就不存在BOOT分区扩容的问题。'''</big>
|}
</li></ol>
<span id="禁止自动扩容tf卡中rootfs分区容量的方法"></span>

=== 禁止自动扩容TF卡中rootfs分区容量的方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先在'''<span style="color:#FF0000">Ubuntu电脑</span>'''（Windows不行）中将开发板的linux镜像烧录到TF卡中，'''<span style="color:#FF0000">然后重新拔插下TF卡</span>'''</p></li>
<li><p>然后Ubuntu电脑一般会自动挂载TF卡的分区，如果自动挂载正常，使用ls命令可以看到下面的输出</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''ls /media/test/opi_root/'''</p>
<p>bin &nbsp;&nbsp; boot &nbsp;&nbsp; dev &nbsp;&nbsp; etc &nbsp;&nbsp; home &nbsp;&nbsp; lib &nbsp;&nbsp; lost+found &nbsp;&nbsp; media &nbsp;&nbsp; mnt &nbsp;&nbsp; opt &nbsp;&nbsp; proc &nbsp;&nbsp; root &nbsp;&nbsp; run <br> sbin &nbsp;&nbsp; selinux &nbsp;&nbsp; srv &nbsp;&nbsp; sys &nbsp;&nbsp; tmp &nbsp;&nbsp; usr &nbsp;&nbsp; var</p>
|}
</li>
<li><p>然后在Ubuntu电脑中将当前用户切换成root用户</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo -i'''</p>
<p>[sudo] test 的密码：</p>
<p>root@test:~'''<span style="color:#FF0000">#</span>'''</p>
|}
</li>
<li><p>然后进入TF卡中的linux系统的root目录下新建一个名为'''.no_rootfs_resize'''的文件</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@test:~# '''cd /media/test/opi_root/'''</p>
<p>root@test:/media/test/opi_root/# '''cd root'''</p>
<p>root@test:/media/test/opi_root/root# '''touch .no_rootfs_resize'''</p>
<p>root@test:/media/test/opi_root/root# '''ls .no_rootfs*'''</p>
<p>'''.no_rootfs_resize'''</p>
|}
</li>
<li><p>然后就可以卸载TF卡，再拔出TF卡插到开发板中启动，linux系统启动时，当检测到'''/root'''目录下有'''.no_rootfs_resize'''这个文件就不会再自动扩容rootfs了</p></li>
<li><p>禁止rootfs自动扩容后进入Linux系统可以看到rootfs分区的总容量只有4GB（这里测试的是桌面版本的镜像），远小于TF卡的实际容量，说明禁止rootfs自动扩容成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''df -h'''</p>
<span style="margin-right: 80px;">Filesystem </span><span style="margin-right: 50px;">Size </span><span style="margin-right: 30px;">Used </span><span style="margin-right: 30px;">Avail</span><span style="margin-right: 50px;">Use% Mounted on</span><br>
<span style="margin-right: 110px;">udev</span><span style="margin-right: 60px;">925M </span><span style="margin-right: 50px;">0</span><span style="margin-right: 70px;">925M </span><span style="margin-right: 90px;">0% /dev</span><br>
<span style="margin-right: 100px;">tmpfs </span><span style="margin-right: 50px;">199M </span><span style="margin-right: 30px;">3.2M </span><span style="margin-right: 70px;">196M </span><span style="margin-right: 90px;">2% /run</span><br>
<span style="margin-right: 25px;color:#FF0000">'''/dev/mmcblk0p1'''</span><span style="margin-right: 50px;color:#FF0000">'''4.0G '''</span><span style="margin-right: 35px;color:#FF0000">'''3.2G '''</span><span style="margin-right: 80px;color:#FF0000">'''686M '''</span><span style="margin-right: 90px;color:#FF0000">'''83% /'''</span><br>
|}
</li>
<li><p>如果需要重新扩容TF卡中rootfs分区的容量，只需要执行下面的命令，然后重新启动开发板的Linux系统即可</p>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，请在<span style="color:#FF0000">root</span>用户下执行下面的命令。'''</big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~# '''rm /root/.no_rootfs_resize'''

root@orangepi:~# '''systemctl enable orangepi-resize-filesystem.service'''

root@orangepi:~# '''sudo reboot'''
|}

重启后再次进入开发板的Linux系统就可以看到rootfs分区已经扩展为TF卡的实际容量了

{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~$ '''df -h'''</p>
<span style="margin-right: 80px;">Filesystem </span><span style="margin-right: 50px;">Size </span><span style="margin-right: 30px;">Used </span><span style="margin-right: 30px;">Avail</span><span style="margin-right: 50px;">Use% Mounted on</span><br>
<span style="margin-right: 110px;">udev</span><span style="margin-right: 60px;">925M </span><span style="margin-right: 50px;">0</span><span style="margin-right: 70px;">925M </span><span style="margin-right: 90px;">0% /dev</span><br>
<span style="margin-right: 100px;">tmpfs </span><span style="margin-right: 50px;">199M </span><span style="margin-right: 30px;">3.2M </span><span style="margin-right: 70px;">196M </span><span style="margin-right: 90px;">2% /run</span><br>
<span style="margin-right: 25px;color:#FF0000">'''/dev/mmcblk0p1'''</span><span style="margin-right: 50px;color:#FF0000">'''15G'''</span><span style="margin-right: 35px;color:#FF0000">'''3.2G '''</span><span style="margin-right: 80px;color:#FF0000">'''12G '''</span><span style="margin-right: 90px;color:#FF0000">'''23% /'''</span><br>
|}
</li></ol>
<span id="手动扩容tf卡中rootfs分区容量的方法"></span>

=== 手动扩容TF卡中rootfs分区容量的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''如果TF卡的总容量很大，比如为128GB，不想Linux系统rootfs分区使用TF卡所有的容量，只想分配一部分容量，比如16GB，给Linux系统使用，然后TF卡的剩余容量就可以用作其他用途。那么可以使用此小节介绍的内容来手动扩容TF中rootfs分区的容量。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先在'''<span style="color:#FF0000">Ubuntu电脑</span>'''（Windows不行）中将开发板的linux镜像烧录到TF卡中，'''<span style="color:#FF0000">然后重新拔插下TF卡</span>'''</p></li>
<li><p>然后Ubuntu电脑一般会自动挂载TF卡的分区，如果自动挂载正常，使用'''ls'''命令可以看到下面的输出</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''ls /media/test/opi_root/'''</p>
<p>bin &nbsp;&nbsp; boot &nbsp;&nbsp; dev &nbsp;&nbsp; etc &nbsp;&nbsp; home &nbsp;&nbsp; lib &nbsp;&nbsp; lost+found &nbsp;&nbsp; media &nbsp;&nbsp; mnt &nbsp;&nbsp; opt &nbsp;&nbsp; proc &nbsp;&nbsp; root &nbsp;&nbsp; run <br> sbin &nbsp;&nbsp; selinux &nbsp;&nbsp; srv &nbsp;&nbsp; sys &nbsp;&nbsp; tmp &nbsp;&nbsp; usr &nbsp;&nbsp; var</p>
|}
</li>
<li><p>然后在Ubuntu电脑中将当前用户切换成root用户</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo -i'''</p>
<p>[sudo] test 的密码：</p>
<p>root@test:~'''<span style="color:#FF0000">#</span>'''</p>
|}
</li>
<li><p>然后进入TF卡中的linux系统的root目录下新建一个名为'''.no_rootfs_resize'''的文件</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@test:~# '''cd /media/test/opi_root/'''</p>
<p>root@test:/media/test/opi_root/# '''cd root'''</p>
<p>root@test:/media/test/opi_root/root# '''touch .no_rootfs_resize'''</p>
<p>root@test:/media/test/opi_root/root# '''ls .no_rootfs*'''</p>
<p>'''.no_rootfs_resize'''</p>
|}
</li></ol>

<!-- -->
<ol start="5" style="list-style-type: decimal;">
<li><p>然后在Ubuntu电脑中安装下gparted这个软件</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt install -y gparted'''</p>
|}
</li>
<li><p>然后打开gparted</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo gparted'''</p>
|}
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况。下图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配</p>
<p>[[File:zero3-img92.png]]</p></li>
<li><p>然后选中rootfs分区（/dev/sdc1）</p>
<p>[[File:zero3-img94.png]]</p></li>
<li><p>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区</p>
<p>[[File:zero3-img95.png]]</p></li>
<li><p>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始扩容rootfs分区的大小</p>
<p>[[File:zero3-img96.png]]</p></li>
<li><p>'''Resize/Move'''选项打开后会弹出下面的设置界面</p>
<p>[[File:zero3-img97.png]]</p></li>
<li><p>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New size(MiB)'''中的数字来设置rootfs分区的大小</p>
<p>[[File:zero3-img98.png]]</p></li>
<li><p>设置好容量后，再点击右下角的'''Resize/Move'''即可</p>
<p>[[File:zero3-img99.png]]</p></li>
<li><p>最后确认无误后，再点击下图所示的'''绿色 <span style="color:green">√</span>'''</p>
<p>[[File:zero3-img100.png]]</p></li>
<li><p>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量</p>
<p>[[File:zero3-img101.png]]</p></li>
<li><p>扩容完成后点击'''Close'''关闭即可</p>
<p>[[File:zero3-img102.png]]</p></li>
<li><p>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明手动扩容成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~# '''df -h'''</p>
<span style="margin-right: 80px;">Filesystem </span><span style="margin-right: 50px;">Size </span><span style="margin-right: 30px;">Used </span><span style="margin-right: 30px;">Avail</span><span style="margin-right: 50px;">Use% Mounted on</span><br>
<span style="margin-right: 110px;">udev</span><span style="margin-right: 60px;">925M </span><span style="margin-right: 50px;">0</span><span style="margin-right: 70px;">925M </span><span style="margin-right: 90px;">0% /dev</span><br>
<span style="margin-right: 100px;">tmpfs </span><span style="margin-right: 50px;">199M </span><span style="margin-right: 30px;">3.2M </span><span style="margin-right: 70px;">196M </span><span style="margin-right: 90px;">2% /run</span><br>
<span style="margin-right: 25px;color:#FF0000">'''/dev/mmcblk0p1'''</span><span style="margin-right: 50px;color:#FF0000">'''7.7G '''</span><span style="margin-right: 35px;color:#FF0000">'''3.2G '''</span><span style="margin-right: 80px;color:#FF0000">'''4.4G '''</span><span style="margin-right: 90px;color:#FF0000">'''42% /'''</span><br>
|}
</li></ol>

<span id="缩小tf卡中rootfs分区容量的方法"></span>

=== 缩小TF卡中rootfs分区容量的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''在TF卡的Linux系统中配置好应用程序或者其他的开发环境后，如果想备份下TF卡中的Linux系统，可以使用此小节的方法先缩小下rootfs分区的大小，然后再开始备份。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先在'''<span style="color:#FF0000">Ubuntu电脑</span>'''（Windows不行）中插入想要操作的TF卡</p></li>
<li><p>然后在Ubuntu电脑中安装下gparted这个软件</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt install -y gparted'''</p>
|}
</li>
<li><p>然后打开gparted</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo gparted'''</p>
|}
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况</p>
<p>[[File:zero3-img103.png]]</p></li>
<li><p>然后选中rootfs分区（/dev/sdc1）</p>
<p>[[File:zero3-img104.png]]</p></li>
<li><p>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区</p>
<p>[[File:zero3-img105.png]]</p></li>
<li><p>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始设置rootfs分区的大小</p>
<p>[[File:zero3-img106.png]]</p></li>
<li><p>'''Resize/Move'''选项打开后会弹出下面的设置界面</p>
<p>[[File:zero3-img107.png]]</p></li>
<li><p>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New size(MiB)'''中的数字来设置rootfs分区的大小</p>
<p>[[File:zero3-img98.png]]</p></li></ol>

<!-- -->
<ol start="18" style="list-style-type: decimal;">
<li><p>设置好容量后，再点击右下角的'''Resize/Move'''即可</p>
<p>[[File:zero3-img99.png]]</p></li>
<li><p>最后确认无误后，再点击下图所示的'''绿色 <span style="color:green">√</span>'''</p>
<p>[[File:zero3-img100.png]]</p></li>
<li><p>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量</p>
<p>[[File:zero3-img101.png]]</p></li>
<li><p>扩容完成后点击'''Close'''关闭即可</p>
<p>[[File:zero3-img102.png]]</p></li>
<li><p>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明缩小容量成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~# '''df -h'''</p>
<span style="margin-right: 80px;">Filesystem </span><span style="margin-right: 50px;">Size </span><span style="margin-right: 30px;">Used </span><span style="margin-right: 30px;">Avail</span><span style="margin-right: 50px;">Use% Mounted on</span><br>
<span style="margin-right: 110px;">udev</span><span style="margin-right: 60px;">925M </span><span style="margin-right: 50px;">0</span><span style="margin-right: 70px;">925M </span><span style="margin-right: 90px;">0% /dev</span><br>
<span style="margin-right: 100px;">tmpfs </span><span style="margin-right: 50px;">199M </span><span style="margin-right: 30px;">3.2M </span><span style="margin-right: 70px;">196M </span><span style="margin-right: 90px;">2% /run</span><br>
<span style="margin-right: 25px;color:#FF0000">'''/dev/mmcblk0p1'''</span><span style="margin-right: 50px;color:#FF0000">'''7.7G '''</span><span style="margin-right: 35px;color:#FF0000">'''3.2G '''</span><span style="margin-right: 80px;color:#FF0000">'''4.4G '''</span><span style="margin-right: 90px;color:#FF0000">'''42% /'''</span><br>
|}
</li></ol>

== 网络连接测试 ==

=== 以太网口测试 ===

<ol style="list-style-type: decimal;">
<li><p>首先将网线的一端插入开发板的以太网接口，网线的另一端接入路由器，并确保网络是畅通的</p></li>
<li><p>系统启动后会通过'''DHCP'''自动给以太网卡分配IP地址，'''<span style="color:#FF0000">不需要其他任何配置</span>'''</p></li>
<li><p>在开发板的Linux系统中查看IP地址的命令如下所示：</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''下面的命令请不要照抄，比如debian12中的网络节点名为end0，下面的命令就需要修改为ip a s end0。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ip a s eth0'''</p>
<p>3: eth0: &lt;BROADCAST,MULTICAST,UP,LOWER_UP&gt; mtu 1500 qdisc pfifo_fast state UP group default qlen 1000</p>
:<p>link/ether 5e:ac:14:a5:93:b3 brd ff:ff:ff:ff:ff:ff</p>
:<p>inet '''<span style="color:#FF0000">192.168.1.16</span>'''/24 brd 192.168.1.255 scope global dynamic noprefixroute eth0</p>
::<p>valid_lft 259174sec preferred_lft 259174sec</p>
:<p>inet6 240e:3b7:3240:c3a0:e269:8305:dc08:135e/64 scope global dynamic noprefixroute</p>
::<p>valid_lft 259176sec preferred_lft 172776sec</p>
:<p>inet6 fe80::957d:bbbd:4928:3604/64 scope link noprefixroute</p>
::<p>valid_lft forever preferred_lft forever</p>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''开发板启动后查看IP地址有三种方法：'''

# '''接HDMI显示器，然后登录系统使用ip a s eth0命令查看IP地址'''
# '''在调试串口终端输入ip a s eth0命令来查看IP地址'''
# '''如果没有调试串口，也没有HDMI显示器，还可以通过路由器的管理界面来查看开发板网口的IP地址。不过这种方法经常有人会无法正常看到开发板的IP地址。如果看不到，调试方法如下所示：'''

<!-- -->
<ol style="list-style-type: upper-alpha;">
<li><p>'''首先检查Linux系统是否已经正常启动，如果开发板的绿灯闪烁了，一般是正常启动了，如果只亮红灯，或者红灯绿灯都没亮，说明系统都没正常启动；'''</p></li>
<li><p>'''检查网线有没有插紧，或者换根网线试下；'''</p></li>
<li><p>'''换个路由器试下（路由器的问题有遇到过很多，比如路由器无法正常分配IP地址，或者已正常分配IP地址但在路由器中看不到）；'''</p></li>
<li><p>'''如果没有路由器可换就只能连接HDMI显示器或者使用调试串口来查看IP地址。'''</p></li></ol>
<p>'''另外需要注意的是开发板DHCP自动分配IP地址是不需要任何设置的。'''</p></big>
|}
</li></ol>
<!-- -->
<ol start="4" style="list-style-type: decimal;">
<li><p>测试网络连通性的命令如下，'''ping'''命令可以通过'''Ctrl+C'''快捷键来中断运行</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''下面的命令请不要照抄，比如debian12中的网络节点名为end0，下面的命令就需要修改为ping www.baidu.com -I end0。（这里是大写的字母I，不是小写的字母L）'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ping www.baidu.com -I eth0'''</p>
<p>PING www.a.shifen.com (14.215.177.38) from 192.168.1.12 eth0: 56(84) bytes of data.</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=1 ttl=56 time=6.74 ms</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=2 ttl=56 time=6.80 ms</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=3 ttl=56 time=6.26 ms</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=4 ttl=56 time=7.27 ms</p>
<p>^C</p>
<p>--- www.a.shifen.com ping statistics ---</p>
<p>4 packets transmitted, 4 received, 0% packet loss, time 3002ms</p>
<p>rtt min/avg/max/mdev = 6.260/6.770/7.275/0.373 ms</p>
|}
</li></ol>

<span id="wifi连接测试"></span>

=== WIFI连接测试 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''请不要通过修改/etc/network/interfaces配置文件的方式来连接WIFI，通过这种方式连接WIFI网络使用会有问题。'''</big>
|}

<span id="服务器版镜像通过命令连接wifi"></span>
==== 服务器版镜像通过命令连接WIFI ====

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''当开发板没有连接以太网，没有连接HDMI显示器，只连接了串口时，推荐使用此小节演示的命令来连接WIFI网络。因为nmtui在某些串口软件（如minicom）中只能显示字符，无法正常显示图形界面。当然，如果开发板连接了以太网或者HDMI显示屏，也可以使用此小节演示的命令来连接WIFI网络的。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>先登录linux系统，有下面三种方式</p>
<ol style="list-style-type: lower-alpha;">
<li>如果开发板连接了网线，可以通过[[Orange Pi Zero 3#Ubuntu下SSH远程登录开发板|'''ssh远程登录linux系统''']]</li></ol>

<!-- -->
<ol style="list-style-type: lower-alpha;" start="2">
<li><p>如果开发板连接好了调试串口，可以使用串口终端登录linux系统</p></li>
<li><p>如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统</p></li></ol>
</li></ol>

<!-- -->
<ol start="2" style="list-style-type: decimal;">
<li><p>首先使用'''nmcli dev wifi'''命令扫描周围的WIFI热点</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''nmcli dev wifi'''</p>
|}
<div class="figure">

[[File:zero3-img108.png]]

</div></li>
<li><p>然后使用'''nmcli''' 命令连接扫描到的WIFI热点，其中：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''wifi_name'''需要换成想连接的WIFI热点的名字</p></li>
<li><p>'''wifi_passwd'''需要换成想连接的WIFI热点的密码</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo nmcli dev wifi connect <span style="color:#FF0000">wifi_name</span> password <span style="color:#FF0000">wifi_passwd</span>'''</p>
<p>Device 'wlan0' successfully activated with 'cf937f88-ca1e-4411-bb50-61f402eef293'.</p>
|}
</li></ol>
</li>
<li><p>通过'''ip addr show wlan0'''命令可以查看wifi的IP地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ip a s wlan0'''</p>
<p>11: wlan0: &lt;BROADCAST,MULTICAST,UP,LOWER_UP&gt; mtu 1500 qdisc pfifo_fast state UP group default qlen 1000</p>
:<p>link/ether 23:8c:d6:ae:76:bb brd ff:ff:ff:ff:ff:ff</p>
:<p>inet '''<span style="color:#FF0000">192.168.1.11</span>'''/24 brd 192.168.1.255 scope global dynamic noprefixroute wlan0</p>
::<p>valid_lft 259192sec preferred_lft 259192sec</p>
:<p>inet6 240e:3b7:3240:c3a0:c401:a445:5002:ccdd/64 scope global dynamic noprefixroute</p>
::<p>valid_lft 259192sec preferred_lft 172792sec</p>
:<p>inet6 fe80::42f1:6019:a80e:4c31/64 scope link noprefixroute</p>
::<p>valid_lft forever preferred_lft forever</p>
|}
</li>
<li><p>使用'''ping'''命令可以测试wifi网络的连通性，'''ping'''命令可以通过'''Ctrl+C'''快捷键来中断运行</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0 &nbsp;&nbsp;&nbsp;（这里是大写的字母I，不是小写的字母L）'''</p> 
<p>PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data.</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=2 ttl=52 time=41.3 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=3 ttl=52 time=44.9 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=4 ttl=52 time=45.6 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=5 ttl=52 time=48.8 ms</p>
<p>^C</p>
<p>--- www.orangepi.org ping statistics ---</p>
<p>5 packets transmitted, 5 received, 0% packet loss, time 4006ms</p>
<p>rtt min/avg/max/mdev = 41.321/44.864/48.834/2.484 ms</p>
|}
</li></ol>

<span id="服务器版镜像通过图形化方式连接wifi"></span>

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

<ol style="list-style-type: decimal;">
<li><p>先登录linux系统，有下面三种方式</p>
<ol style="list-style-type: lower-alpha;">
<li><p>如果开发板连接了网线，可以通过[[Orange Pi Zero 3#Ubuntu下SSH远程登录开发板|'''ssh远程登录linux系统''']]</p></li>
<li><p>如果开发板连接好了调试串口，可以使用串口终端登录linux系统（串口软件请使用MobaXterm，使用minicom无法显示图形界面）</p></li>
<li><p>如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统</p></li></ol>
</li>
<li><p>然后在命令行中输入nmtui命令打开wifi连接的界面</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo nmtui'''</p>
|}
</li>
<li><p>输入nmtui命令打开的界面如下所示</p>
<p>[[File:zero3-img109.png]]</p></li>
<li><p>选择'''Activate a connect'''后回车</p>
<p>[[File:zero3-img110.png]]</p></li>
<li><p>然后就能看到所有搜索到的WIFI热点</p>
<p>[[File:zero3-img111.png]]</p></li>
<li><p>选择想要连接的WIFI热点后再使用Tab键将光标定位到'''Activate'''后回车</p>
<p>[[File:zero3-img112.png]]</p></li>
<li><p>然后会弹出输入密码的对话框，在'''Pssword'''内输入对应的密码然后回车就会开始连接WIFI</p>
<p>[[File:zero3-img113.png]]</p></li>
<li><p>WIFI连接成功后会在已连接的WIFI名称前显示一个”*”</p>
<p>[[File:zero3-img114.png]]</p></li>
<li><p>通过'''ip a s wlan0'''命令可以查看wifi的IP地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ip a s wlan0'''</p>
<p>11: wlan0: &lt;BROADCAST,MULTICAST,UP,LOWER_UP&gt; mtu 1500 qdisc pfifo_fast state UP group default qlen 1000</p>
:<p>link/ether 24:8c:d3:aa:76:bb brd ff:ff:ff:ff:ff:ff</p>
:<p>inet '''192.168.1.11'''/24 brd 192.168.1.255 scope global dynamic noprefixroute wlan0</p>
::<p>valid_lft 259069sec preferred_lft 259069sec</p>
:<p>inet6 240e:3b7:3240:c4a0:c401:a445:5002:ccdd/64 scope global dynamic noprefixroute</p>
::<p>valid_lft 259071sec preferred_lft 172671sec</p>
:<p>inet6 fe80::42f1:6019:a80e:4c31/64 scope link noprefixroute</p>
::<p>valid_lft forever preferred_lft forever</p>
|}
</li>
<li><p>使用'''ping'''命令可以测试wifi网络的连通性，'''ping'''命令可以通过'''Ctrl+C'''快捷键来中断运行</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0 &nbsp;&nbsp;&nbsp;（这里是大写的字母I，不是小写的字母L）'''</p>
<p>PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data.</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=2 ttl=52 time=41.3 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=3 ttl=52 time=44.9 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=4 ttl=52 time=45.6 ms</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=5 ttl=52 time=48.8 ms</p>
<p>^C</p>
<p>--- www.orangepi.org ping statistics ---</p>
<p>5 packets transmitted, 5 received, 0% packet loss, time 4006ms</p>
<p>rtt min/avg/max/mdev = 41.321/44.864/48.834/2.484 ms</p>
|}
</li></ol>

==== 桌面版镜像的测试方法 ====

<ol style="list-style-type: decimal;">
<li><p>点击桌面右上角的网络配置图标（测试WIFI时请不要连接网线）</p>
<p>[[File:zero3-img115.png]]</p></li>
<li><p>在弹出的下拉框中点击'''More networks'''可以看到所有扫描到的WIFI热点，然后选择想要连接的WIFI热点</p>
<p>[[File:zero3-img116.png]]</p></li>
<li><p>然后输入WIFI热点的密码，再点击'''Connect'''就会开始连接WIFI</p>
<p>[[File:zero3-img117.png]]</p></li>
<li><p>连接好WIFI后，可以打开浏览器查看是否能上网，浏览器的入口如下图所示</p>
<p>[[File:zero3-img118.png]]</p></li>
<li><p>打开浏览器后如果能打开其他网页说明WIFI连接正常</p>
<div class="figure">

[[File:zero3-img119.png]]

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

<span id="通过create_ap创建wifi热点的方法"></span>

=== 通过create_ap创建WIFI热点的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''create_ap是一个帮助快速创建Linux上的WIFI热点的脚本，并且支持bridge和NAT模式，能够自动结合hostapd, dnsmasq和iptables完成WIFI热点的设置，避免了用户进行复杂的配置，github地址如下：'''

[https://github.com/oblique/create_ap '''https://github.com/oblique/create_ap''']</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''OPi发布的Linux镜像已经预装了create_ap脚本，可以通过create_ap命令来创建WIFI热点，create_ap的基本命令格式如下所示：'''

'''create_ap [options] &lt;wifi-interface&gt; [&lt;interface-with-internet&gt;] [&lt;access-point-name&gt; [&lt;passphrase&gt;]]'''

'''* options：可以通过该参数指定加密方式、WIFI热点的频段、频宽模式、网络共享方式等，具体可以通过create_ap -h获取到有哪些option'''

'''* wifi-interface：无线网卡的名称'''

'''* interface-with-internet：可以联网的网卡名称，一般是eth0'''

'''* access-point-name：热点名称'''

'''* passphrase：热点的密码'''</big>
|}

<span id="create_ap以nat模式创建wifi热点的方法"></span>
==== create_ap以NAT模式创建WIFI热点的方法 ====

<ol style="list-style-type: decimal;">
<li><p>输入下面的命令以NAT模式创建名称为'''orangepi'''、密码为'''orangepi'''的WIFI热点</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo create_ap -m nat wlan0 eth0 orangepi orangepi --no-virt'''
|}
</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li><p>如果有下面的信息输出，说明WIFI热点创建成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo create_ap -m nat wlan0 eth0 orangepi orangepi --no-virt'''</p>
<p>Config dir: /tmp/create_ap.wlan0.conf.TQkJtsz1</p>
<p>PID: 26139</p>
<p>Network Manager found, set wlan0 as unmanaged device... DONE</p>
<p>Sharing Internet using method: nat</p>
<p>hostapd command-line interface: hostapd_cli -p /tmp/create_ap.wlan0.conf.TQkJtsz1/hostapd_ctrl</p>
<p>wlan0: interface state UNINITIALIZED-&gt;ENABLED</p>
<p>wlan0: AP-ENABLED</p>
<p>wlan0: STA ce:bd:9a:dd:a5:86 IEEE 802.11: associated</p>
<p>wlan0: AP-STA-CONNECTED ce:bd:9a:dd:a5:86</p>
<p>wlan0: STA ce:bd:9a:dd:a5:86 RADIUS: starting accounting session D4FBF7E5C604F169</p>
<p>wlan0: STA ce:bd:9a:dd:a5:86 WPA: pairwise key handshake completed (RSN)</p>
<p>wlan0: EAPOL-4WAY-HS-COMPLETED ce:bd:9a:dd:a5:86</p>
|}
</li>
<li><p>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击 '''orangepi'''连接热点，密码就是上面设置的'''orangepi'''</p>
<p>[[File:zero3-img120.png]]</p></li>
<li><p>连接成功后的显示如下图所示</p>
<p>[[File:zero3-img121.png]]</p></li>
<li><p>在NAT模式下，连接到开发板热点的无线设备是向开发板的DHCP服务请求IP地址的，所以会有两个不同的网段，如这里开发板的IP是192.168.1.X</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo ifconfig eth0'''</p>
<p>eth0: flags=4163&lt;UP,BROADCAST,RUNNING,MULTICAST&gt; mtu 1500</p>
::<p>inet '''<span style="color:#FF0000">192.168.1.150</span>''' netmask 255.255.255.0 broadcast 192.168.1.255</p>
::<p>inet6 fe80::938f:8776:5783:afa2 prefixlen 64 scopeid 0x20&lt;link&gt;</p>
::<p>ether 4a:a0:c8:25:42:82 txqueuelen 1000 (Ethernet)</p>
::<p>RX packets 25370 bytes 2709590 (2.7 MB)</p>
::<p>RX errors 0 dropped 50 overruns 0 frame 0</p>
::<p>TX packets 3798 bytes 1519493 (1.5 MB)</p>
::<p>TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0</p>
::<p>device interrupt 83</p>
|}
<p>而开发板的DHCP服务默认会给接入热点的设备分配'''192.168.12.0/24'''的IP地址，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址是'''192.168.12.X'''。</p>
<p>[[File:zero3-img121.png]]</p>
<p>[[File:zero3-img122-1.png]]</p></li>
<li><p>如果想要为接入的设备指定不同的网段，可以通过-g参数指定，如通过-g参数指定接入点AP的网段为192.168.2.1</p>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo create_ap -m nat wlan0 eth0 orangepi orangepi -g 192.168.2.1 --no-virt'''
|}

此时通过手机连接到热点后，点击已经连接的WIFI热点'''orangepi'''，然后可以看到手机的IP地址是'''192.168.2.X'''。

[[File:zero3-img121.png]]

[[File:zero3-img123.png]]
</li></ol>
<ol start="7" style="list-style-type: decimal;">
<li><p>在不指定'''--freq-band'''参数的情况下，默认创建的热点是2.4G频段的，如果想要创建5G频段的热点可以通过'''--freq-band 5'''参数指定，具体命令如下</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo create_ap -m nat wlan0 eth0 orangepi orangepi --freq-band 5 --no-virt'''
|}
</li></ol>
<ol start="8" style="list-style-type: decimal;">
<li><p>如果需要隐藏SSID，可以指定'''--hidden'''参数，具体命令如下</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo create_ap -m nat wlan0 eth0 orangepi orangepi --hidden --no-virt'''
|}

此时手机是搜索不到WIFI热点的，需要手动指定WIFI热点名称，并输入密码来连接WIFI热点

[[File:zero3-img124.png]]
</li></ol>
<span id="create_ap以bridge模式创建wifi热点的方法"></span>

==== create_ap以bridge模式创建WIFI热点的方法 ====

<ol style="list-style-type: decimal;">
<li><p>输入下面的命令以bridge模式创建名称为'''orangepi'''、密码为'''orangepi'''的WIFI热点</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo create_ap -m bridge wlan0 eth0 orangepi orangepi --no-virt'''
|}
</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li><p>如果有下面的信息输出，说明WIFI热点创建成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo create_ap -m bridge wlan0 eth0 orangepi orangepi --no-virt'''</p>
<p>Config dir: /tmp/create_ap.wlan0.conf.zAcFlYTx</p>
<p>PID: 27707</p>
<p>Network Manager found, set wlan0 as unmanaged device... DONE</p>
<p>Sharing Internet using method: bridge</p>
<p>Create a bridge interface... br0 created.</p>
<p>hostapd command-line interface: hostapd_cli -p /tmp/create_ap.wlan0.conf.zAcFlYTx/hostapd_ctrl</p>
<p>wlan0: interface state UNINITIALIZED-&gt;ENABLED</p>
<p>wlan0: AP-ENABLED</p>
<p>wlan0: STA ce:bd:9a:dd:a5:86 IEEE 802.11: associated</p>
<p>wlan0: AP-STA-CONNECTED ce:bd:9a:dd:a5:86</p>
<p>wlan0: STA ce:bd:9a:dd:a5:86 RADIUS: starting accounting session 937BF40E51897A7B</p>
<p>wlan0: STA ce:bd:9a:dd:a5:86 WPA: pairwise key handshake completed (RSN)</p>
<p>wlan0: EAPOL-4WAY-HS-COMPLETED ce:bd:9a:dd:a5:86</p>
|}
</li>
<li><p>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击'''orangepi'''连接热点，密码就是上面设置的'''orangepi'''</p>
<p>[[File:zero3-img120.png]]</p></li>
<li><p>连接成功后的显示如下图所示</p>
<p>[[File:zero3-img121.png]]</p></li>
<li><p>在bridge模式下，连接到开发板热点的无线设备也是向主路由（开发板连接的路由器）的DHCP服务请求IP地址的，如这里开发板的IP是'''192.168.1.X'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo ifconfig eth0'''</p>
<p>eth0: flags=4163&lt;UP,BROADCAST,RUNNING,MULTICAST&gt; mtu 1500</p>
::<p>inet '''<span style="color:#FF0000">192.168.1.150</span>''' netmask 255.255.255.0 broadcast 192.168.1.255</p>
::<p>inet6 fe80::938f:8776:5783:afa2 prefixlen 64 scopeid 0x20&lt;link&gt;</p>
::<p>ether 4a:a0:c8:25:42:82 txqueuelen 1000 (Ethernet)</p>
::<p>RX packets 25370 bytes 2709590 (2.7 MB)</p>
::<p>RX errors 0 dropped 50 overruns 0 frame 0</p>
::<p>TX packets 3798 bytes 1519493 (1.5 MB)</p>
::<p>TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0</p>
::<p>device interrupt 83</p>
|}
<p>而接入WIFI热点的设备的IP也是由主路由分配的，所以连接WIFI热点的手机和开发板处于相同的网段，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址也是'''192.168.1.X'''。</p>
<p>[[File:zero3-img121.png]]</p>
<p>[[File:zero3-img125.png]]</p></li>
<li><p>在不指定'''--freq-band'''参数的情况下，默认创建的热点是2.4G频段的，如果想要创建5G频段的热点可以通过'''--freq-band 5'''参数指定，具体命令如下</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo create_ap -m bridge wlan0 eth0 orangepi orangepi --freq-band 5 --no-virt'''
|}
</li></ol>
<ol start="7" style="list-style-type: decimal;">
<li><p>如果需要隐藏SSID，可以指定'''--hidden'''参数，具体命令如下</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo create_ap -m bridge wlan0 eth0 orangepi orangepi --hidden --no-virt'''
|}

此时手机是搜索不到WIFI热点的，需要手动指定WIFI热点名称，并输入密码来连接WIFI热点

[[File:zero3-img124.png]]
</li></ol>
<span id="设置静态ip地址的方法"></span>

=== 设置静态IP地址的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''请不要通过修改/etc/network/interfaces配置文件的方式来设置静态IP地址。'''</big>
|}

<span id="使用nmtui命令来设置静态ip地址"></span>
==== 使用nmtui命令来设置静态IP地址 ====

<ol style="list-style-type: decimal;">
<li><p>首先运行'''nmtui'''命令</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo nmtui'''</p>
|}
</li>
<li><p>然后选择'''Edit a connection'''并按下回车键</p>
<p>[[File:zero3-img126.png]]</p></li>
<li><p>然后选择需要设置静态IP地址的网络接口，比如设置'''Ethernet'''接口的静态IP地址选择'''Wired connection 1'''就可以了</p>
<p>[[File:zero3-img127.png]]</p></li>
<li><p>然后通过'''Tab'''键选择'''Edit'''并按下回车键</p>
<p>[[File:zero3-img128.png]]</p></li>
<li><p>然后通过Tab键将光标移动到下图所示的'''&lt;Automatic&gt;'''位置进行IPv4的配置</p>
<p>[[File:zero3-img129.png]]</p></li>
<li><p>然后回车，通过上下方向键选择'''Manual'''，然后回车确定</p>
<p>[[File:zero3-img130.png]]</p></li>
<li><p>选择完后的显示如下图所示</p>
<p>[[File:zero3-img131.png]]</p></li>
<li><p>然后通过Tab键将光标移动到'''&lt;Show&gt;'''</p>
<p>[[File:zero3-img132.png]]</p></li>
<li><p>然后回车，回车后会弹出下面的设置界面</p>
<p>[[File:zero3-img133.png]]</p></li>
<li><p>然后就可以在下图所示的位置设置IP地址(Addresses)、网关(Gateway)和DNS服务器的地址（里面还有很多其他设置选项，请自行探索），'''<span style="color:#FF0000">请根据自己的具体需求来设置，下图中设置的值只是一个示例</span>'''</p>
<p>[[File:zero3-img134-1.png]]</p></li>
<li><p>设置完后将光标移动到右下角的'''&lt;OK&gt;'''，然后回车确认</p>
<p>[[File:zero3-img135.png]]</p></li>
<li><p>然后点击'''&lt;Back&gt;'''回退到上一级选择界面</p>
<p>[[File:zero3-img136.png]]</p></li>
<li><p>然后选择'''Activate a connection'''，再将光标移动到'''&lt;OK&gt;'''，最后点击回车</p>
<p>[[File:zero3-img137.png]]</p></li>
<li><p>然后选择需要设置的网络接口，比如'''Wired connection 1'''，然后将光标移动到'''&lt;Deactivate&gt;'''，再按下回车键禁用'''Wired connection 1'''</p>
<p>[[File:zero3-img138.png]]</p></li>
<li><p>然后请不要移动光标，再按下回车键重新使能'''Wired connection 1'''，这样前面设置的静态IP地址就会生效了</p>
<p>[[File:zero3-img139.png]]</p></li>
<li><p>然后通过'''&lt;Back&gt;'''和'''Quit'''按钮就可以退出nmtui</p>
<p>[[File:zero3-img140.png]] [[File:zero3-img141.png]]</p></li>
<li><p>然后通过'''ip a s eth0'''就能看到网口的IP地址已经变成前面设置的静态IP地址了</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ip a s eth0'''</p>
<p>3: eth0: &lt;BROADCAST,MULTICAST,UP,LOWER_UP&gt; mtu 1500 qdisc pfifo_fast state UP group default qlen 1000</p>
:<p>link/ether 5e:ac:14:a5:92:b3 brd ff:ff:ff:ff:ff:ff</p>
:<p>inet '''<span style="color:#FF0000">192.168.1.177</span>'''/24 brd 192.168.1.255 scope global noprefixroute eth0</p>
::<p>valid_lft forever preferred_lft forever</p>
:<p>inet6 241e:3b8:3240:c3a0:e269:8305:dc08:135e/64 scope global dynamic noprefixroute</p>
::<p>valid_lft 259149sec preferred_lft 172749sec</p>
:<p>inet6 fe80::957d:bbbe:4928:3604/64 scope link noprefixroute</p>
::<p>valid_lft forever preferred_lft forever</p>
|}
</li>
<li><p>然后就可以测试网络的连通性来检查IP地址是否配置OK了，'''ping'''命令可以通过'''Ctrl+C'''快捷键来中断运行</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ping 192.168.1.177 -I eth0'''</p>
<p>PING 192.168.1.47 (192.168.1.47) from 192.168.1.188 eth0: 56(84) bytes of data.</p>
<p>64 bytes from 192.168.1.47: icmp_seq=1 ttl=64 time=0.233 ms</p>
<p>64 bytes from 192.168.1.47: icmp_seq=2 ttl=64 time=0.263 ms</p>
<p>64 bytes from 192.168.1.47: icmp_seq=3 ttl=64 time=0.273 ms</p>
<p>64 bytes from 192.168.1.47: icmp_seq=4 ttl=64 time=0.269 ms</p>
<p>64 bytes from 192.168.1.47: icmp_seq=5 ttl=64 time=0.275 ms</p>
<p>^C</p>
<p>--- 192.168.1.47 ping statistics ---</p>
<p>5 packets transmitted, 5 received, 0% packet loss, time 4042ms</p>
<p>rtt min/avg/max/mdev = 0.233/0.262/0.275/0.015 ms</p>
|}
</li></ol>

<span id="使用nmcli命令来设置静态ip地址"></span>

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

<ol style="list-style-type: decimal;">
<li><p>如果要设置网口的静态IP地址，请先将网线插入开发板，'''如果需要设置WIFI的静态IP地址，请先连接好WIFI'''，然后再开始设置静态IP地址</p></li>
<li><p>然后通过'''nmcli con show'''命令可以查看网络设备的名字，如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''orangepi'''为WIFI网络接口的名字（名字不一定相同）</p></li>
<li><p>'''Wired connection 1'''为以太网接口的名字</p>
{| class="wikitable" style="width:800px;"
|-
|
orangepi@orangepi:~$ '''nmcli con show'''<br>
<span style="margin-right: 180px;">NAME</span><span style="margin-right: 260px;">UUID </span><span style="margin-right: 45px;">TYPE </span><span style="margin-right: 50px;">DEVICE</span><br>
<span style="margin-right: 125px;">'''orangepi'''</span><span style="margin-right: 70px;">cfc4f922-ae48-46f1-84e1-2f19e9ec5e2a</span><span style="margin-right: 50px;">wifi </span><span style="margin-right: 50px;">wlan0</span><br>
<span style="margin-right: 50px;">'''Wired connection 1'''</span><span style="margin-right: 50px;">9db058b7-7701-37b8-9411-efc2ae8bfa30</span><span style="margin-right: 30px;">ethernet </span><span style="margin-right: 50px;">eth0</span><br>
|}
</li></ol>
</li>
<li><p>然后输入下面的命令，其中</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''&quot;Wired connection 1&quot;''' 表示设置以太网口的静态IP地址，如果需要设置WIFI的静态IP地址，请修改为WIFI网络接口对应的名字（通过'''nmcli con show'''命令可以获取到）</p></li>
<li><p>'''ipv4.addresses'''后面是要设置的静态IP地址，可以修改为自己想要设置的值</p></li>
<li><p>'''ipv4.gateway''' 表示网关的地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo nmcli con mod &quot;Wired connection 1&quot; \</p>
<p>ipv4.addresses &quot;192.168.1.110&quot; \'''</p>
<p>'''ipv4.gateway &quot;192.168.1.1&quot; \'''</p>
<p>'''ipv4.dns &quot;8.8.8.8&quot; \'''</p>
<p>'''ipv4.method &quot;manual&quot;'''</p>
|}
</li></ol>
</li>
<li><p>然后重启linux系统</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo reboot'''</p>
|}
</li>
<li><p>然后重新进入linux系统使用'''ip addr show eth0'''命令就可以看到IP地址已经设置为想要的值了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ip addr show eth0'''</p>
<p>3: eth0: &lt;BROADCAST,MULTICAST,UP,LOWER_UP&gt; mtu 1500 qdisc pfifo_fast state UP group default qlen 1000</p>
:<p>link/ether 5e:ae:14:a5:91:b3 brd ff:ff:ff:ff:ff:ff</p>
:<p>inet '''<span style="color:#FF0000">192.168.1.110</span>'''/32 brd 192.168.1.110 scope global noprefixroute eth0</p>
::<p>valid_lft forever preferred_lft forever</p>
:<p>inet6 240e:3b7:3240:c3a0:97de:1d01:b290:fe3a/64 scope global dynamic noprefixroute</p>
::<p>valid_lft 259183sec preferred_lft 172783sec</p>
:<p>inet6 fe80::3312:861a:a589:d3c/64 scope link noprefixroute</p>
::<p>valid_lft forever preferred_lft forever</p>
|}
</li></ol>

<span id="设置linux系统第一次启动自动连接网络的方法"></span>

=== 设置Linux系统第一次启动自动连接网络的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''开发板有以太网口，如果想通过以太网口来远程登录开发板的Linux系统，只需要给以太网口插上能正常上网的网线，在启动完Linux系统后会自动通过DHCP给以太网口分配一个IP地址，然后我们通过HDMI屏幕、串口或者查看路由器后台的方式就可以获取以太网口的IP地址，然后就能远程登录Linux系统。'''

'''开发板也有无线WIFI，如果想通过WIFI来远程登录开发板的Linux系统，则需要通过以太网口的IP地址ssh远程登录Linux系统后通过命令来连接WIFI，或者在HDMI屏幕或串口中通过命令来连接WIFI。'''

'''但如果HDMI屏幕和串口模块都没有，虽然有网线，但无法通过路由器后台查看到开发板的IP地址。或者HDMI屏幕、串口模块和网线都没有，只有WIFI可以连接，则可以使用此小节介绍的方法来自动连接WIFI并且还能设置WIFI的静态IP地址或者自动设置以太网口的静态IP地址。'''</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''要使用此小节的方法，首先需要准备一台Linux系统的机器。比如一台安装有Ubuntu系统的电脑或者虚拟机。'''

'''为什么需要Linux系统的机器，因为TF卡中烧录的开发板Linux系统的根文件系统是ext4格式的，Linux系统的机器可以正常的挂载它，然后对其中的配置文件进行修改。'''</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''如果想要在Windows系统中来修改，可以使用Paragon ExtFS for Windows这款软件，由于此软件需要付费，而目前又没有比较好用的类似的免费软件，这里就不具体演示了。'''

'''另外如果尝试Paragon ExtFS for Windows这款软件使用有问题请自行解决，我们不答疑。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先烧录想使用的开发板的Linux镜像到TF卡中，然后使用读卡器，将烧录好开发板Linux镜像的TF卡插入安装有Linux系统的机器中（比如安装有Ubuntu系统的电脑，下面都以Ubuntu电脑为例来演示）</p></li>
<li><p>当TF卡插入Ubuntu电脑后，Ubuntu电脑一般会自动挂载TF卡中的Linux根文件系统的分区，由下面的命令可以知道，'''/media/test/opi_root'''即为TF卡中的Linux根文件系统挂载的路径</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''df -h | grep &quot;media&quot;'''</p>
<p>/dev/sdd1 &nbsp;&nbsp; 1.4G &nbsp;&nbsp; 1.2G &nbsp;&nbsp; 167M &nbsp;&nbsp; 88% '''<span style="color:#FF0000">/media/test/opi_root</span>'''</p>
<p>test@test:~$ '''ls /media/test/opi_root'''</p>
<p>bin &nbsp;&nbsp; boot &nbsp;&nbsp; dev &nbsp;&nbsp; etc &nbsp;&nbsp; home &nbsp;&nbsp; lib &nbsp;&nbsp; lost+found &nbsp;&nbsp; media &nbsp;&nbsp; mnt &nbsp;&nbsp; opt &nbsp;&nbsp; proc &nbsp;&nbsp; root &nbsp;&nbsp; run <br> sbin &nbsp;&nbsp; selinux &nbsp;&nbsp; srv &nbsp;&nbsp; sys &nbsp;&nbsp; tmp &nbsp;&nbsp; usr &nbsp;&nbsp; var</p>
|}
</li>
<li><p>然后进入TF卡中烧录的Linux系统的'''/boot'''目录中</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''cd /media/test/opi_root/boot/'''</p>
|}
</li>
<li><p>然后将其中的'''orangepi_first_run.txt.template'''复制为'''orangepi_first_run.txt'''，通过orangepi_first_run.txt配置文件可以设置开发板Linux系统第一次启动时自动连接某个WIFI热点，也可以设置WIFI或者以太网口的静态IP地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:/media/test/opi_root/boot$ '''sudo cp orangepi_first_run.txt.template orangepi_first_run.txt'''</p>
|}
</li>
<li><p>通过下面的命令可以打开orangepi_first_run.txt文件，然后就可以查看修改其中的内容</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:/media/test/opi_root/boot$ '''sudo vim orangepi_first_run.txt'''</p>
|}
</li>
<li><p>orangepi_first_run.txt文件中的变量使用说明</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''FR_general_delete_this_file_after_completion'''变量用来设置第一次启动完后是否删除orangepi_first_run.txt这个文件，默认为1，也就是删除，如果设置为0，第一次启动后会将orangepi_first_run.txt重命名为orangepi_first_run.txt.old，一般保持默认值即可</p></li>
<li><p>'''FR_net_change_defaults'''变量用于设置是否改变默认网络设置，这个必须要设置为1，否则所有的网络设置都不会生效</p></li>
<li><p>'''FR_net_ethernet_enabled'''变量用来控制是否使能以太网口的配置，如果需要设置以太网口的静态IP地址，请设置为1</p></li>
<li><p>'''FR_net_wifi_enabled'''变量用来控制是否使能WIFI的配置，如果需要设置开发板自动连接WIFI热点，则必须将其设置为1，另外请注意，如果此变量设置为1，则以太网口的设置就会失效。也就是说WIFI和以太网口不能同时设置（为什么，因为没必要...）</p></li>
<li><p>'''FR_net_wifi_ssid'''变量用于设置想要连接的WIFI热点的名字</p></li>
<li><p>'''FR_net_wifi_key'''变量用于设置想要连接的WIFI热点的密码</p></li>
<li><p>'''FR_net_use_static'''变量用于设置是否需要设置WIFI或者以太网口的静态IP地址</p></li>
<li><p>'''FR_net_static_ip'''变量用于设置静态IP的地址，请根据自己的实际情况设置</p></li>
<li><p>'''FR_net_static_gateway'''变量用于设置网关，请根据自己的实际情况设置</p></li></ol>
</li>
<li><p>下面演示几个具体的设置示例：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>比如想要开发板的Linux系统第一次启动后自动连接WIFI热点，可以这样设置：</p>
<ol style="list-style-type: none;">
<li><p>a) 设置'''FR_net_change_defaults'''为'''1'''</p></li>
<li><p>b) 设置'''FR_net_wifi_enabled'''为'''1'''</p></li>
<li><p>c) 设置'''FR_net_wifi_ssid'''为想要连接的WIFI热点的名字</p></li>
<li><p>d) 设置'''FR_net_wifi_key'''为想要连接的WIFI热点的密码</p></li></ol>
</li>
<li><p>比如想要开发板的Linux系统第一次启动后自动连接WIFI热点，并且设置WIFI的IP地址为特定的静态IP地址（这样当Linux系统启动后，可以直接使用设置的静态IP地址ssh远程登录开发板，无需通过路由器后台来查看开发板的IP地址），可以这样设置：</p>
<ol style="list-style-type: none;">
<li><p>a) 设置'''FR_net_change_defaults'''为'''1'''</p></li>
<li><p>b) 设置'''FR_net_wifi_enabled'''为'''1'''</p></li>
<li><p>c) 设置'''FR_net_wifi_ssid'''为想要连接的WIFI热点的名字</p></li>
<li><p>d) 设置'''FR_net_wifi_key'''为想要连接的WIFI热点的密码</p></li>
<li><p>e) 设置'''FR_net_use_static'''为'''1'''</p></li>
<li><p>f) 设置'''FR_net_static_ip'''为想要的IP地址</p></li>
<li><p>g) 设置'''FR_net_static_gateway'''为对应的网关地址</p></li></ol>
</li>
<li><p>比如想要开发板的Linux系统第一次启动后自动设置以太网口的IP地址为想要的静态IP地址，可以这样设置：</p>
<ol style="list-style-type: none;">
<li><p>a) 设置'''FR_net_change_defaults'''为'''1'''</p></li>
<li><p>b) 设置'''FR_net_ethernet_enabled'''为'''1'''</p></li>
<li><p>c) 设置'''FR_net_use_static'''为'''1'''</p></li>
<li><p>d) 设置'''FR_net_static_ip'''为想要的IP地址</p></li>
<li><p>e) 设置'''FR_net_static_gateway'''为对应的网关地址</p></li></ol>
</li></ol>
</li>
<li><p>修改完orangepi_first_run.txt文件后，就可以退出TF卡中开发板Linux系统的/boot目录，再卸载TF卡，然后就可以将TF卡插入开发板中启动了</p></li>
<li><p>如果没有设置静态IP地址，则还是需要通过路由器后台来查看IP地址，如果设置了静态IP地址，则可以在电脑上ping下设置的静态IP地址，如果能ping说明系统已经正常启动，并且网络也已设置正确，然后就可以使用设置的IP地址ssh远程登录开发板的Linux系统了</p>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''开发板的Linux系统第一次启动完后，orangepi_first_run.txt会被删除或者重命名为orangepi_first_run.txt.old，此时就算重新设置orangepi_first_run.txt配置文件，然后重新启动开发板的Linux系统，orangepi_first_run.txt中的配置也不会再次生效，因为此配置只在烧录完Linux系统后第一次启动才会有作用，这点请特别注意。'''</big>
|}
</li></ol>
<span id="ssh远程登录开发板"></span>

== SSH远程登录开发板 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''Linux系统默认都开启了ssh远程登录，并且允许root用户登录系统。ssh登录前首先需要确保以太网或者wifi网络已连接，然后使用ip addr命令或者通过查看路由器的方式获取开发板的IP地址。'''</big>
|}

<span id="ubuntu下ssh远程登录开发板"></span>
=== Ubuntu下SSH远程登录开发板 ===

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

::{| class="wikitable" style="width:800px;" 
|-
| 
test@test:~$ '''ssh [mailto:root@192.168.1.36 orangepi@192.168.1.]xxx''' (需要替换为开发板的IP地址)

orangepi@192.168.1.xx's password: （在这里输入密码，默认密码为orangepi）
|}

::{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，输入密码的时候，<span style="color:#FF0000">屏幕上是不会显示输入的密码的具体内容的</span>，请不要以为是有什么故障，输入完后直接回车即可。'''

'''如果提示拒绝连接，只要使用的是Orange Pi提供的镜像，<span style="color:#FF0000">就请不要怀疑orangepi这个密码是不是不对</span>，而是要找其他原因。'''</big>
|}

<ol start="3" style="list-style-type: decimal;">
<li><p>成功登录系统后的显示如下图所示</p>
<p>[[File:zero3-img142.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''如果ssh无法正常登陆linux系统，首先请检查下开发板的IP地址是否能ping通，如果ping通没问题的话，可以通过串口或者HDMI显示器登录linux系统然后在开发板上输入下面的命令后再尝试是否能连接：'''</p>


root@orangepi:~# '''reset_ssh.sh'''


'''如果还不行，请重烧系统试下。'''</big>
|}
</li></ol>
<span id="windows下ssh远程登录开发板"></span>

=== Windows下SSH远程登录开发板 ===

<ol style="list-style-type: decimal;">
<li><p>首先获取开发板的IP地址</p></li>
<li><p>在windows下可以使用MobaXterm远程登录开发板，首先新建一个ssh会话</p>
<ol style="list-style-type: lower-alpha;">
<li><p>打开'''Session'''</p></li>
<li><p>然后在'''Session Setting'''中选择'''SSH'''</p></li>
<li><p>然后在'''Remote host'''中输入开发板的IP地址</p></li>
<li><p>然后在'''Specify username'''中输入linux系统的用户名'''root'''或'''orangepi'''</p></li>
<li><p>最后点击'''OK'''即可</p>
<p>[[File:zero3-img143.png]]</p></li></ol>
</li>
<li><p>然后会提示输入密码，默认root和orangepi用户的密码都为orangepi</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，输入密码的时候，<span style="color:#FF0000">屏幕上是不会显示输入的密码的具体内容的</span>，请不要以为是有什么故障，输入完后直接回车即可。'''</p></big>
|}
<p>[[File:zero3-img144.png]]</p></li>
<li><p>成功登录系统后的显示如下图所示</p>
<p>[[File:zero3-img145.png]]</p></li></ol>

<span id="hdmi测试"></span>

== HDMI测试 ==

<span id="hdmi显示测试"></span>
=== HDMI显示测试 ===

<ol style="list-style-type: decimal;">
<li><p>使用Micro HDMI转HDMI线连接Orange Pi开发板和HDMI显示器</p>
<div class="figure">

[[File:zero3-img13.png]]

</div></li>
<li><p>启动linux系统后如果HDMI显示器有图像输出说明HDMI接口使用正常</p>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，很多笔记本电脑虽然带有HDMI接口，但是笔记本的HDMI接口一般只有输出功能，并没有HDMI in的功能，也就是说并不能将其他设备的HDMI输出显示到笔记本的屏幕上。'''

'''当想把开发板的HDMI接到笔记本电脑HDMI接口时，请先确认清楚您的笔记本是支持HDMI in的功能。'''</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''当HDMI没有显示的时候，请先检查下HDMI线有没有插紧，确认接线没问题后，可以换一个不同的屏幕试下有没有显示。'''</big>
|}
</li></ol>
<span id="hdmi转vga显示测试"></span>

=== HDMI转VGA显示测试 ===

<ol style="list-style-type: decimal;">
<li><p>首先需要准备下面的配件</p>
<ol style="list-style-type: lower-alpha;">
<li><p>HDMI转VGA转换器</p>
<p>[[File:zero3-img146.png]]</p></li>
<li><p>一根VGA线和一根Micro HDMI公转HDMI母转接线</p>
<p>[[File:zero3-img147.png|400px]] [[File:zero3-img148.png|400px]]</p></li>
<li><p>一个支持VGA接口的显示器或者电视</p></li></ol>
</li>
<li><p>HDMI转VGA显示测试如下所示</p>
<p>[[File:zero3-img149.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''使用HDMI转VGA显示时，开发板以及开发板的Linux系统是不需要做任何设置的，只需要开发板Micro HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</p></big>
|}
</li></ol>

<span id="linux5.4系统hdmi分辨率设置的方法"></span>

=== Linux5.4系统HDMI分辨率设置的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意： 此方法只适用于linux5.4内核的系统。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>在linux系统的'''/boot/orangepiEnv.txt'''中有个disp_mode变量，可以通过它来设置HDMI输出的分辨率，linux系统默认设置的分辨率为1080p60</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''</p>
<p>verbosity=1</p>
<p>console=both</p>
<p>disp_mode='''<span style="color:#FF0000">1080p60</span>'''</p>
<p>fb0_width=1920</p>
<p>fb0_height=1080</p>
|}
</li>
<li><p>disp_mode变量支持设置的值如下表所示</p></li>

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''disp_mode支持的值'''
| style="text-align: left;"| '''HDMI分辨率'''
| style="text-align: left;"| '''HDMI刷新率'''
|-
| style="text-align: left;"| '''480i'''
| style="text-align: left;"| '''720x480'''
| style="text-align: left;"| '''60'''
|-
| style="text-align: left;"| '''576i'''
| style="text-align: left;"| '''720x480'''
| style="text-align: left;"| '''50'''
|-
| style="text-align: left;"| '''480p'''
| style="text-align: left;"| '''720x480'''
| style="text-align: left;"| '''60'''
|-
| style="text-align: left;"| '''576p'''
| style="text-align: left;"| '''720x576'''
| style="text-align: left;"| '''60'''
|-
| style="text-align: left;"| '''720p50'''
| style="text-align: left;"| '''1280x720'''
| style="text-align: left;"| '''50'''
|-
| style="text-align: left;"| '''720p60'''
| style="text-align: left;"| '''1280x720'''
| style="text-align: left;"| '''60'''
|-
| style="text-align: left;"| '''1080i50'''
| style="text-align: left;"| '''1920x1080'''
| style="text-align: left;"| '''50'''
|-
| style="text-align: left;"| '''1080i60'''
| style="text-align: left;"| '''1920x1080'''
| style="text-align: left;"| '''60'''
|-
| style="text-align: left;"| '''1080p24'''
| style="text-align: left;"| '''1920x1080'''
| style="text-align: left;"| '''24'''
|-
| style="text-align: left;"| '''1080p50'''
| style="text-align: left;"| '''1920x1080'''
| style="text-align: left;"| '''50'''
|-
| style="text-align: left;"| '''1080p60'''
| style="text-align: left;"| '''1920x1080'''
| style="text-align: left;"| '''60'''
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意：Linux系统目前不支持4K分辨率。'''</big>
|}
</ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>将disp_mode变量的值修改为想要输出的分辨率，然后重启系统，HDMI就会输出所设置的分辨率了</p></li>
<li><p>查看HDMI输出分辨率的方法如下所示，如果显示的分辨率和设置的分辨率一样，说明开发板这端的设置正确</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo cat /sys/class/disp/disp/attr/sys'''</p>
|}
<p>[[File:zero3-img150.png]]</p></li></ol>

<span id="linux5.4系统framebuffer宽度和高度的修改方法"></span>

=== Linux5.4系统Framebuffer宽度和高度的修改方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意： 此方法只适用于linux5.4内核的系统。'''</big>
|}

在linux系统的'''/boot/orangepiEnv.txt'''中有fb0_width和fb0_height两个变量，可以通过它们来设置Framebuffer的宽度和高度，linux系统默认设置fb0_width=1920、fb0_height=1080。

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''

verbosity=1

console=both

disp_mode=1080p60

'''<span style="color:#FF0000">fb0_width=1920</span>'''

'''<span style="color:#FF0000">fb0_height=1080</span>'''
|}

fb0_width和fb0_height不同分辨率对应的'''参考值'''如下所示：

{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| '''HDMI分辨率'''
| style="text-align: left;"| '''fb0_width'''
| style="text-align: left;"| '''fb0_height'''
|-
| style="text-align: left;"| '''480p'''
| style="text-align: left;"| '''720'''
| style="text-align: left;"| '''480'''
|-
| style="text-align: left;"| '''576p'''
| style="text-align: left;"| '''720'''
| style="text-align: left;"| '''576'''
|-
| style="text-align: left;"| '''720p'''
| style="text-align: left;"| '''1280'''
| style="text-align: left;"| '''720'''
|-
| style="text-align: left;"| '''1080p'''
| style="text-align: left;"| '''1920'''
| style="text-align: left;"| '''1080'''
|}

在相同的HDMI分辨下，当fb0_width和fb0_height设置的值越大时，屏幕显示的文字就越小，当fb0_width和fb0_height设置的值越小时，屏幕显示的文字就越大。

<span id="framebuffer光标设置"></span>

=== Framebuffer光标设置 ===

<ol style="list-style-type: decimal;">
<li><p>Framebuffer使用的softcursor，设置光标闪烁或者不闪烁的方法如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''echo <span style="color:#FF0000">1</span> &gt; /sys/class/graphics/fbcon/cursor_blink #光标闪烁'''</p>
<p>root@orangepi:~# '''echo <span style="color:#FF0000">0</span> &gt; /sys/class/graphics/fbcon/cursor_blink #光标不闪烁'''</p>
|}
</li>
<li><p>如果需要隐藏光标，可以在'''/boot/orangepiEnv.txt'''的'''extraargs'''变量（'''extraargs'''的值会赋值给'''bootargs'''环境变量最终传递给内核）中加入'''vt.global_cursor_default=0'''（如果'''vt.global_cursor_default=1'''则是显示光标），然后重启系统就能看到光标已经消失</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''</p>
<p>verbosity=1</p>
<p>console=both</p>
<p>disp_mode=1080p60</p>
<p>fb0_width=1920</p>
<p>fb0_height=1080</p>
<p>'''<span style="color:#FF0000">extraargs=vt.global_cursor_default=0</span>'''</p>
|}
</li></ol>

== 蓝牙使用方法 ==

<span id="桌面版镜像的测试方法-1"></span>
=== 桌面版镜像的测试方法 ===

<ol style="list-style-type: decimal;">
<li><p>点击桌面右上角的蓝牙图标</p>
<p>[[File:zero3-img151.png]]</p></li>
<li><p>然后选择适配器</p>
<p>[[File:zero3-img152.png]]</p></li>
<li><p>如果有提示下面的界面，请选择'''Yes'''</p>
<p>[[File:zero3-img153.png]]</p></li>
<li><p>然后在蓝牙的适配器设置界面中设置'''Visibility Setting'''为'''Always visible'''，然后关闭即可</p>
<p>[[File:zero3-img154.png]]</p></li>
<li><p>然后打开蓝牙设备的配置界面</p>
<p>[[File:zero3-img155.png]]</p></li>
<li><p>点击'''Search'''即可开始扫描周围的蓝牙设备</p>
<p>[[File:zero3-img156.png]]</p></li>
<li><p>然后选择想要连接的蓝牙设备，再点击鼠标右键就会弹出对此蓝牙设备的操作界面，选择'''Pair'''即可开始配对，这里演示的是和Android手机配对</p>
<p>[[File:zero3-img157.png]]</p></li>
<li><p>配对时，桌面的右上角会弹出配对确认框，选择'''Confirm'''确认即可，此时手机上也同样需要进行确认</p>
<p>[[File:zero3-img158.png]]</p></li>
<li><p>和手机配对完后，可以选择已配对的蓝牙设备，然后右键选择'''Send a File'''即可开始给手机发送一张图片</p>
<p>[[File:zero3-img159.png]]</p></li>
<li><p>发送图片的界面如下所示</p>
<p>[[File:zero3-img160.png]]</p></li></ol>

=== 服务器版镜像的使用方法 ===

<ol style="list-style-type: decimal;">
<li><p>进入系统后首先可以通过'''hciconfig'''命令来查看是否存在蓝牙的设备节点，如果存在，说明蓝牙初始化正常</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt update &amp;&amp; sudo apt install -y bluez'''</p>
<p>orangepi@orangepi:~$ '''hciconfig -a'''</p>
<p>hci0: Type: Primary Bus: UART</p>
:<p>BD Address: 3E:61:3D:19:0E:52 ACL MTU: 1021:8 SCO MTU: 240:3</p>
:<p>UP RUNNING</p>
:<p>RX bytes:925 acl:0 sco:0 events:72 errors:0</p>
:<p>TX bytes:5498 acl:0 sco:0 commands:72 errors:0</p>
:<p>Features: 0xbf 0xff 0x8d 0xfe 0xdb 0x3d 0x7b 0xc7</p>
:<p>Packet type: DM1 DM3 DM5 DH1 DH3 DH5 HV1 HV2 HV3</p>
:<p>Link policy: RSWITCH SNIFF</p>
:<p>Link mode: SLAVE ACCEPT</p>
:<p>Name: 'orangepi'</p>
:<p>Class: 0x3c0000</p>
:<p>Service Classes: Rendering, Capturing, Object Transfer, Audio</p>
:<p>Device Class: Miscellaneous,</p>
:<p>HCI Version: 5.0 (0x9) Revision: 0x400</p>
:<p>LMP Version: 5.0 (0x9) Subversion: 0x400</p>
:<p>Manufacturer: Spreadtrum Communications Shanghai Ltd (492)</p>
|}
</li>
<li><p>使用'''bluetoothctl'''扫描蓝牙设备</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo bluetoothctl'''</p>
<p>[NEW] Controller 10:11:12:13:14:15 orangepizero3 [default]</p>
<p>Agent registered</p>
<p>[bluetooth]# '''power on #使能控制器'''</p>
<p>Changing power on succeeded</p>
<p>[bluetooth]# '''discoverable on #设置控制器为可被发现的'''</p>
<p>Changing discoverable on succeeded</p>
<p>[CHG] Controller 10:11:12:13:14:15 Discoverable: yes</p>
<p>[bluetooth]# '''pairable on #设置控制器为可配对的'''</p>
<p>Changing pairable on succeeded</p>
<p>[bluetooth]# '''scan on #开始扫描周围的蓝牙设备'''</p>
<p>Discovery started</p>
<p>[CHG] Controller 10:11:12:13:14:15 Discovering: yes</p>
<p>[NEW] Device 76:60:79:29:B9:31 76-60-79-29-B9-31</p>
<p>[NEW] Device 9C:2E:A1:42:71:11 小米手机</p>
<p>'''[NEW] Device DC:72:9B:4C:F4:CF orangepi'''</p>
<p>[bluetooth]# '''scan off #扫描到想连接的蓝牙设备后就可以关闭扫描了，然后记下蓝牙设备的MAC地址，这里测试的蓝牙设备为Android手机，蓝牙的名字为orangepi，对应的MAC地址为DC:72:9B:4C:F4:CF'''</p>
<p>Discovery stopped</p>
<p>[CHG] Controller 10:11:12:13:14:15 Discovering: no</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF RSSI is nil</p>
|}
</li>
<li><p>扫描到想配对的设备后就可以进行配对了，配对需要使用设备的MAC地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[bluetooth]# '''pair DC:72:9B:4C:F4:CF''' '''#使用扫描到的蓝牙设备的MAC地址进行配对'''</p>
<p>Attempting to pair with DC:72:9B:4C:F4:CF</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF Connected: yes</p>
<p>Request confirmation</p>
<p>[leeb1m[agent] Confirm passkey 764475 (yes/no): '''yes''' '''#在这里输入yes，在手机上也需要确认'''</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF Modalias: bluetooth:v010Fp107Ed1436</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF UUIDs: 0000046a-0000-1000-8000-00805f9b34fb</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: yes</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF Paired: yes</p>
<p>'''Pairing successful #提示配对成功'''</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: no</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF Connected: no</p>
|}
</li>
<li><p>配对成功后，手机蓝牙界面的显示如下所示</p>
<p>[[File:zero3-img161.png]]</p></li>
<li><p>连接蓝牙设备需要安装 '''pulseaudio-module-bluetooth'''软件包，然后再启动'''pulseaudio''' 服务</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt update'''</p>
<p>orangepi@orangepi:~$ '''sudo''' '''apt -y install pulseaudio-module-bluetooth'''</p>
<p>orangepi@orangepi:~$ '''pulseaudio --start'''</p>
|}
</li>
<li><p>连接蓝牙设备的方法</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo bluetoothctl'''</p>
<p>Agent registered</p>
<p>[bluetooth]# '''paired-devices &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #查看已配对的蓝牙设备的MAC地址'''</p>
<p>Device DC:72:9B:4C:F4:CF orangepi</p>
<p>[bluetooth]# '''connect DC:72:9B:4C:F4:CF &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #使用MAC地址连接蓝牙设备'''</p>
<p>Attempting to connect to DC:72:9B:4C:F4:CF</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF Connected: yes</p>
<p>Connection successful</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: yes</p>
<p>[CHG] Controller 10:11:12:13:14:15 Discoverable: no</p>
<p>'''[orangepi]# &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #出现这个提示符说明连接成功'''</p>
|}
</li>
<li><p>连接完蓝牙设备后，Android手机的蓝牙配置界面就可以看到'''已连接用于通话和媒体的音频'''的提示</p>
<div class="figure">

[[File:zero3-img162.png]]

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

<span id="usb接口测试"></span>

== USB接口测试 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''USB接口是可以接USB hub来扩展USB接口的数量的。'''</big>
|}

<span id="连接usb鼠标或键盘测试"></span>
=== 连接USB鼠标或键盘测试 ===

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

<span id="连接usb存储设备测试"></span>
=== 连接USB存储设备测试 ===

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

::{| class="wikitable" style="width:800px;"
|-
|
orangepi@orangepi:~$ '''cat /proc/partitions | grep &quot;sd*&quot;'''<br>
<span style="margin-right: 30px;">major </span><span style="margin-right: 40px;">minor </span><span style="margin-right: 30px;">#blocks</span><span style="margin-right: 50px;">name</span><br>
<span style="margin-right: 70px;">8</span><span style="margin-right: 60px;">0</span><span style="margin-right: 50px;">30044160 </span><span style="margin-right: 50px;color:#FF0000">'''sda'''</span><br>
<span style="margin-right: 70px;">8</span><span style="margin-right: 60px;">1</span><span style="margin-right: 50px;">30043119 </span><span style="margin-right: 50px;color:#FF0000">'''sda1'''</span><br>
|}

<ol start="3" style="list-style-type: decimal;">
<li>使用mount命令可以将U盘挂载到'''/mnt'''中，然后就能查看U盘中的文件了</li>

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo mount /dev/sda1 /mnt/'''

orangepi@orangepi:~$ '''ls /mnt/'''

test.txt
|}
</ol>
<ol start="4" style="list-style-type: decimal;">
<li>挂载完后通过'''df -h'''命令就能查看U盘的容量使用情况和挂载点</li>

{| class="wikitable" style="width:800px;" 
|-
|
orangepi@orangepi:~$ '''df -h | grep &quot;sd&quot;'''

/dev/sda1 &nbsp;&nbsp;&nbsp; 29G &nbsp;&nbsp; 208K &nbsp;&nbsp; 29G &nbsp;&nbsp; 1% /mnt
|}
</ol>
<span id="usb以太网卡测试"></span>

=== USB以太网卡测试 ===

# 目前'''测试过'''能用的USB以太网卡如下所示，其中RTL8153 USB千兆网卡插入开发板的USB 2.0 Host接口中测试可以正常使用，但是速率是达不到千兆的，这点请注意

::{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| 序号
| style="text-align: left;"| 型号
|-
| style="text-align: left;"| 1
| style="text-align: left;"| RTL8152B USB百兆网卡
|-
| style="text-align: left;"| 2
| style="text-align: left;"| RTL8153 USB千兆网卡
|}

<ol start="2" style="list-style-type: decimal;">
<li><p>首先将USB网卡插入开发板的USB接口中，然后在USB网卡中插入网线，确保网线能正常上网，如果通过'''dmesg'''命令可以看到下面的log信息，说明USB网卡识别正常</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''dmesg | tail'''</p>
<p>[ 121.985016] usb 3-1: USB disconnect, device number 2</p>
<p>[ 126.873772] sunxi-ehci 5311000.ehci3-controller: ehci_irq: highspeed device connect</p>
<p>[ 127.094054] usb 3-1: new high-speed USB device number 3 using sunxi-ehci</p>
<p>[ 127.357472] usb 3-1: reset high-speed USB device number 3 using sunxi-ehci</p>
<p>[ 127.557960] r8152 3-1:1.0 eth1: v1.08.9</p>
<p>[ 127.602642] r8152 3-1:1.0 enx00e04c362017: renamed from eth1</p>
<p>[ 127.731874] IPv6: ADDRCONF(NETDEV_UP): enx00e04c362017: link is not ready</p>
<p>[ 127.763031] IPv6: ADDRCONF(NETDEV_UP): enx00e04c362017: link is not ready</p>
<p>[ 129.892465] r8152 3-1:1.0 enx00e04c362017: carrier on</p>
<p>[ 129.892583] IPv6: ADDRCONF(NETDEV_CHANGE): enx00e04c362017: link becomes ready</p>
|}
</li>
<li><p>然后通过ifconfig命令可以看到USB网卡的设备节点，以及自动分配的IP地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo ifconfig'''</p>
<p>'''enx00e04c362017''': flags=4163&lt;UP,BROADCAST,RUNNING,MULTICAST&gt; mtu 1500</p>
::<p>inet '''192.168.1.177''' netmask 255.255.255.0 broadcast 192.168.1.255</p>
::<p>inet6 fe80::681f:d293:4bc5:e9fd prefixlen 64 scopeid 0x20&lt;link&gt;</p>
::<p>ether 00:e0:4c:36:20:17 txqueuelen 1000 (Ethernet)</p>
::<p>RX packets 1849 bytes 134590 (134.5 KB)</p>
::<p>RX errors 0 dropped 125 overruns 0 frame 0</p>
::<p>TX packets 33 bytes 2834 (2.8 KB)</p>
::<p>TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0</p>
|}
</li>
<li><p>测试网络连通性的命令如下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ping www.baidu.com -I enx00e04c362017'''</p>
<p>PING www.a.shifen.com (14.215.177.38) from 192.168.1.12 eth0: 56(84) bytes of data.</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=1 ttl=56 time=6.74 ms</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=2 ttl=56 time=6.80 ms</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=3 ttl=56 time=6.26 ms</p>
<p>64 bytes from 14.215.177.38 (14.215.177.38): icmp_seq=4 ttl=56 time=7.27 ms</p>
<p>^C</p>
<p>--- www.a.shifen.com ping statistics ---</p>
<p>4 packets transmitted, 4 received, 0% packet loss, time 3002ms</p>
<p>rtt min/avg/max/mdev = 6.260/6.770/7.275/0.373 ms</p>
|}
</li></ol>

<span id="usb摄像头测试"></span>

=== USB摄像头测试 ===

<ol style="list-style-type: decimal;">
<li><p>首先将USB摄像头插入到Orange Pi开发板的USB接口中</p></li>
<li><p>然后通过lsmod命令可以看到内核自动加载了下面的模块</p>
{| class="wikitable" style="width:800px;" 
|-
|
<p>orangepi@orangepi:~$ '''lsmod'''</p>
<span style="margin-right: 100px;">Module </span><span style="margin-right: 50px;">Size </span><span style="margin-right: 45px;">Used by</span><br>
<span style="margin-right: 100px;">uvcvideo </span><span style="margin-right: 50px;">106496 </span><span style="margin-right: 50px;">0</span><br>
|}
</li>
<li><p>通过v4l2-ctl命令可以看到USB摄像头的设备节点信息为/dev/video0</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt update'''</p>
<p>orangepi@orangepi:~$ '''sudo''' '''apt install -y v4l-utils'''</p>
<p>orangepi@orangepi:~$ '''v4l2-ctl --list-devices'''</p>
<p>USB 2.0 Camera (usb-sunxi-ehci-1):</p>
:<p>/dev/video0</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意v4l2中的l是小写字母l，不是数字1。'''</p>
<p>'''另外video的序号不一定都是video0，请以实际看到的为准。'''</p></big>
|}
</li>
<li><p>使用fswebcam测试USB摄像头</p>
<ol style="list-style-type: lower-alpha;">
<li><p>安装fswebcam</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo''' '''apt update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y fswebcam'''</p>
|}
</li>
<li><p>安装完fswebcam后可以使用下面的命令来拍照</p>
<ol style="list-style-type: none;">
<li><p>a) -d 选项用于指定USB摄像头的设备节点</p></li>
<li><p>b) --no-banner用于去除照片的水印</p></li>
<li><p>c) -r 选项用于指定照片的分辨率</p></li>
<li><p>d) -S 选项用设置于跳过前面的帧数</p></li>
<li><p>e) ./image.jpg 用于设置生成的照片的名字和路径</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo''' '''fswebcam -d /dev/video0 \'''</p>
<p>'''--no-banner -r 1280x720 -S 5 ./image.jpg'''</p>
|}
</li></ol>
</li>
<li><p>在服务器版的linux系统中，拍完照后可以使用scp命令将拍好的图片传到Ubuntu &gt; PC上镜像观看</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''scp image.jpg [mailto:test@192.168.1.55:/home/test test@192.168.1.55:/home/test] （根据实际情况修改IP地址和路径）'''</p>
|}
</li>
<li><p>在桌面版的linux系统中，可以通过HDMI显示器直接查看拍摄的图片</p></li></ol>
</li>
<li><p>使用mjpg-streamer测试USB摄像头</p>
<ol style="list-style-type: lower-alpha;">
<li><p>下载mjpg-streamer</p>
<ol style="list-style-type: none;">
<li><p>a) Github的下载地址：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''git clone https://github.com/jacksonliam/mjpg-streamer'''</p>
|}
</li>
<li><p>b) Gitee的镜像下载地址为：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''git clone https://gitee.com/leeboby/mjpg-streamer'''</p>
|}
</li></ol>
</li>
<li><p>安装依赖的软件包</p>
<ol style="list-style-type: none;">
<li><p>a) Ubuntu系统</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get install -y cmake libjpeg8-dev'''</p>
|}
</li>
<li><p>b) Debian系统</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get install -y cmake libjpeg62-turbo-dev'''</p>
|}
</li></ol>
</li>
<li><p>编译安装mjpg-streamer</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd mjpg-streamer/mjpg-streamer-experimental'''</p>
<p>orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''make -j4'''</p>
<p>orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''sudo make install'''</p>
|}
</li>
<li><p>然后输入下面的命令启动mjpg_streamer</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，video的序号不一定都是video0，请以实际看到的为准。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''export LD_LIBRARY_PATH=.'''</p>
<p>orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''sudo ./mjpg_streamer -i &quot;./input_uvc.so -d \'''</p>
<p>'''/dev/video0 -u -f 30&quot; -o &quot;./output_http.so -w ./www&quot;'''</p>
|}
</li>
<li><p>然后在和开发板同一局域网的Ubuntu PC或者Windows &gt; PC或者手机的浏览器中输入【'''开发板的IP地址:8080'''】就能看到摄像头输出的视频了</p>
<div class="figure">

[[File:zero3-img163.png]]

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

== 音频测试 ==

=== 使用命令行播放音频的方法 ===

==== 耳机接口播放音频测试 ====

<ol style="list-style-type: decimal;">
<li><p>首先需要将13pin扩展板插入到Orange Pi开发板的13pin接口中，然后在音频接口中插入耳机</p>
<div class="figure">

[[File:zero3-img164.png]]

</div></li>
<li><p>通过'''aplay -l'''命令可以查看linux系统支持的声卡设备</p>
<ol style="list-style-type: lower-alpha;">
<li><p>linux5.4系统的输出如下所示，其中'''card 0: audiocodec'''就是耳机播放需要的声卡设备</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''aplay -l'''</p>
<p>**** List of PLAYBACK Hardware Devices ****</p>
<p>'''card 0: audiocodec [audiocodec], device 0: SUNXI-CODEC sun50iw9-codec-0 []'''</p>
:<p>'''Subdevices: 1/1'''</p>
:<p>'''Subdevice #0: subdevice #0'''</p>
|}
</li>
<li><p>linux6.1系统的输出如下所示，其中'''audiocodec'''就是耳机播放需要的声卡设备</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''aplay -l'''</p>
<p>**** List of PLAYBACK Hardware Devices ****</p>
<p>'''card 0: audiocodec [audiocodec], device 0: CDC PCM Codec-0 [CDC PCM Codec-0]'''</p>
:<p>'''Subdevices: 1/1'''</p>
:<p>'''Subdevice #0: subdevice #0'''</p>
|}
</li></ol>
</li>
<li><p>然后使用'''aplay'''命令播放音频，耳机就能听到声音了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''aplay -D hw:0,0 /usr/share/sounds/alsa/audio.wav'''</p>
<p>Playing WAVE 'audio.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo</p>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''如果耳机测试有杂音，请将耳机拔出来一些，不要全部插到底。'''</big>
|}
</li></ol>
<span id="hdmi音频播放测试"></span>

==== HDMI音频播放测试 ====

<ol style="list-style-type: decimal;">
<li><p>首先使用Micro HDMI 转HDMI线将Orange Pi开发板连接到电视机上（其他的HDMI显示器需要确保可以播放音频）</p></li>
<li><p>HDMI音频播放无需其他设置，直接使用'''aplay'''命令播放即可</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''aplay -D hw:2,0 /usr/share/sounds/alsa/audio.wav'''</p>
|}
</li></ol>

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

<ol style="list-style-type: decimal;">
<li><p>首先打开文件管理器</p>
<p>[[File:zero3-img165.png]]</p></li>
<li><p>然后找到下面这个文件（如果系统中没有这个音频文件，可以自己上传一个音频文件到系统中）</p>
<p>[[File:zero3-img166.png]]</p></li>
<li><p>然后选中audio.wav文件，右键选择使用vlc打开就可以开始播放</p>
<p>[[File:zero3-img167.png]]</p></li>
<li><p>切换HDMI播放和耳机播放等不同音频设备的方法</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先打开音量控制界面</p>
<p>[[File:zero3-img168.png]]</p></li>
<li><p>播放音频的时候，在'''Playback'''中会显示播放软件可以使用的音频设备选项，如下图所示，在这里可以设置需要播放到哪个音频设备</p>
<div class="figure">

[[File:zero3-img169.png]]

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

== 红外接收测试 ==

<ol style="list-style-type: decimal;">
<li><p>首先需要将13pin扩展板插入到Orange Pi开发板的13pin接口中，插入扩展板后，开发板才能使用红外接收功能</p>
<div class="figure">

[[File:zero3-img164.png]]

</div></li>
<li><p>安装ir-keytable 红外测试软件</p>

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo''' '''apt update'''

orangepi@orangepi:~$ '''sudo''' '''apt-get install -y ir-keytable'''
|}
</li></ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后执行ir-keytable可以查看红外设备的信息</p>
<ol style="list-style-type: lower-alpha;">
<li>linux5.4系统输出如下所示</li>

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''ir-keytable'''

Found /sys/class/rc/rc0/ (/dev/input/event1) with:

:Driver: sunxi-rc-recv, table: rc_map_sunxi

:lirc device: /dev/lirc0

:Supported protocols: lirc nec

:Enabled protocols: lirc nec

:Name: sunxi_ir_recv

:bus: 25, vendor/product: 0001:0001, version: 0x0100

:Repeat delay = 500 ms, repeat period = 125 ms
|}
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>linux6.1系统的输出如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ir-keytable'''</p>
<p>Found /sys/class/rc/rc0/ with:</p>
:<p>Name: sunxi-ir</p>
:<p>Driver: sunxi-ir</p>
:<p>Default keymap: rc-empty</p>
:<p>Input device: /dev/input/event5</p>
:<p>LIRC device: /dev/lirc0</p>
:<p>Attached BPF protocols: Operation not permitted</p>
:<p>Supported kernel protocols: lirc rc-5 rc-5-sz jvc sony nec sanyo mce_kbd rc-6 sharp xmp imon rc-mm</p>
:<p>Enabled kernel protocols: lirc</p>
:<p>bus: 25, vendor/product: 0001:0001, version: 0x0100</p>
:<p>Repeat delay = 500 ms, repeat period = 125 ms</p>
|}
</li></ol>
</li></ol>
<!-- -->
<ol start="4" style="list-style-type: decimal;">
<li><p>测试红外接收功能前需要准备一个Orange Pi专用的红外遥控器，'''<span style="color:#FF0000">其他遥控器不支持</span>'''</p>
<div class="figure">

[[File:zero3-img170.png]]

</div></li>
<li><p>然后在终端中输入'''ir-keytable -t'''命令，再使用红外遥控器对着Orange Pi开发板的红外接收头按下按键就能在终端中看到接收到的按键编码了</p>
<ol style="list-style-type: lower-alpha;">
<li>linux5.4系统输出如下所示</li>

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo ir-keytable -t'''

Testing events. Please, press CTRL-C to abort.

1598339152.260376: event type EV_MSC(0x04): scancode = 0xfb0413

1598339152.260376: event type EV_SYN(0x00).

1598339152.914715: event type EV_MSC(0x04): scancode = 0xfb0410
|}
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>linux6.1系统输出如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo ir-keytable -c -p NEC -t'''</p>
<p>Old keytable cleared</p>
<p>Protocols changed to nec</p>
<p>Testing events. Please, press CTRL-C to abort.</p>
<p>202.063219: lirc protocol(nec): scancode = 0x45c</p>
<p>202.063249: event type EV_MSC(0x04): scancode = 0x45c</p>
<p>202.063249: event type EV_SYN(0x00).</p>
|}
</li></ol>
</li></ol>

== 温度传感器 ==

=== linux5.4系统查看温度的方法 ===
# H618总共有4个温度传感器，查看温度的命令如下所示：

::{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''显示的温度值需要除以1000，单位才是摄氏度。'''</big>
|}

<ol style="list-style-type: lower-alpha;">
<li>sensor0：CPU的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值</li>

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone0/type'''

'''cpu'''_thermal_zone

orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone0/temp'''

'''57734'''
|}
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>sensor1：DDR的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone1/type'''</p>
<p>'''ddr'''_thermal_zone</p>
<p>orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone1/temp'''</p>
<p>'''57410'''</p>
|}
</li>
<li><p>sensor2：GPU的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone2/type'''</p>
<p>'''gpu'''_thermal_zone</p>
<p>orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone2/temp'''</p>
<p>'''59273'''</p>
|}
</li>
<li><p>sensor3：VE的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone3/type'''</p>
<p>'''ve'''_thermal_zone</p>
<p>orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone3/temp'''</p>
<p>'''58949'''</p>
|}
</li></ol>

=== linux6.1系统查看温度的方法 ===

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sensors'''

cpu_thermal-virtual-0

Adapter: Virtual device

temp1: &nbsp;&nbsp;&nbsp;&nbsp; +'''<span style="color:#FF0000">47.4°C</span>''' &nbsp;&nbsp; (crit = +110.0°C)

gpu_thermal-virtual-0

Adapter: Virtual device

temp1: &nbsp;&nbsp;&nbsp;&nbsp; +'''<span style="color:#FF0000">48.7°C</span>''' &nbsp;&nbsp; (crit = +110.0°C)

ddr_thermal-virtual-0

Adapter: Virtual device

temp1: &nbsp;&nbsp;&nbsp;&nbsp; +'''<span style="color:#FF0000">47.8°C</span>''' &nbsp;&nbsp; (crit = +110.0°C)

ve_thermal-virtual-0

Adapter: Virtual device

temp1: &nbsp;&nbsp;&nbsp;&nbsp; +'''<span style="color:#FF0000">47.2°C</span>''' &nbsp;&nbsp; (crit = +110.0°C)
|}
<span id="pin扩展板接口引脚说明"></span>

== 13 Pin扩展板接口引脚说明 ==

<ol style="list-style-type: decimal;">
<li><p>开发板13 pin扩展板接口引脚的顺序请参考下图</p>
<p>[[File:zero3-img78.png]]</p></li>
<li><p>开发板13pin接口的原理图如下所示</p>
<p>[[File:zero3-img19.png]]</p></li>
<li><p>开发板13 pin扩展板接口引脚的功能说明如下</p>
<ol style="list-style-type: lower-alpha;">
<li><p>13pin引脚接扩展板时，可以额外提供</p>
<ol style="list-style-type: none;">
<li><p>a) 2个USB 2.0 Host</p></li>
<li><p>b) 耳机左右声道音频输出</p></li>
<li><p>c) TV-OUT视频输出</p></li>
<li><p>d) 红外接收功能</p></li>
<li><p>e) 接了扩展板后13pin接口的10、11和12号引脚就无法使用了</p></li>
<li><p>'''f) 另外需要注意13pin扩展板上的MIC在Orange Pi Zero 3上是<span style="color:#FF0000">无法</span>使用的'''</p></li></ol>
</li>
<li><p>13pin引脚不接扩展板时，10、11、12和13号引脚可当作普通GPIO口来使用</p></li>

{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| '''GPIO序号'''
| style="text-align: left;"| '''功能'''
| style="text-align: left;"| '''引脚'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''5V'''
| style="text-align: left;"| '''1'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''2'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''USB2-DM'''
| style="text-align: left;"| '''3'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''USB2-DP'''
| style="text-align: left;"| '''4'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''USB3-DM'''
| style="text-align: left;"| '''5'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''USB3-DP'''
| style="text-align: left;"| '''6'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''LINEOUTR'''
| style="text-align: left;"| '''7'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''LINEOUTL'''
| style="text-align: left;"| '''8'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''TV-OUT'''
| style="text-align: left;"| '''9'''
|-
| style="text-align: left;"| '''<span style="color:#FF0000">65</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">PC1</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">10</span>'''
|-
| style="text-align: left;"| '''<span style="color:#FF0000">272</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">PI16</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">11</span>'''
|-
| style="text-align: left;"| '''<span style="color:#FF0000">262</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">PI6</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">12</span>'''
|-
| style="text-align: left;"| '''<span style="color:#FF0000">234</span>'''
| style="text-align: left;"| '''IR-RX/<span style="color:#FF0000">PH10</span>'''
| style="text-align: left;"| '''<span style="color:#FF0000">13</span>'''
|}
</ol>
</li></ol>

<span id="pin接口引脚说明"></span>

== 26 Pin接口引脚说明 ==

<ol style="list-style-type: decimal;">
<li><p>Orange Pi Zero 3开发板26 pin接口引脚的顺序请参开发板上的丝印图</p>
<p>[[File:zero3-img171-1.png]]</p></li>
<li><p>开发板26 pin接口引脚的功能如下表所示</p></li>

<div style="display: flex;">
{| class="wikitable" style="width:300px;margin-right: 20px"
|-
| style="text-align: left;"| '''GPIO序号'''
| style="text-align: left;"| '''GPIO'''
| style="text-align: left;"| '''功能'''
| style="text-align: left;"| '''引脚'''
|-
| style="text-align: left;"|
| style="text-align: left;"|
| style="text-align: left;"| '''3.3V'''
| style="text-align: left;"| '''1'''
|-
| style="text-align: left;"| '''229'''
| style="text-align: left;"| '''PH5'''
| style="text-align: left;"| '''TWI3-SDA'''
| style="text-align: left;"| '''3'''
|-
| style="text-align: left;"| '''228'''
| style="text-align: left;"| '''PH4'''
| style="text-align: left;"| '''TWI3-SCK'''
| style="text-align: left;"| '''5'''
|-
| style="text-align: left;"| '''73'''
| style="text-align: left;"| '''PC9'''
| style="text-align: left;"| '''PC9'''
| style="text-align: left;"| '''7'''
|-
| style="text-align: left;"|
| style="text-align: left;"|
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''9'''
|-
| style="text-align: left;"| '''70'''
| style="text-align: left;"| '''PC6'''
| style="text-align: left;"| '''PC6'''
| style="text-align: left;"| '''11'''
|-
| style="text-align: left;"| '''69'''
| style="text-align: left;"| '''PC5'''
| style="text-align: left;"| '''PC5'''
| style="text-align: left;"| '''13'''
|-
| style="text-align: left;"| '''72'''
| style="text-align: left;"| '''PC8'''
| style="text-align: left;"| '''PC8'''
| style="text-align: left;"| '''15'''
|-
| style="text-align: left;"|
| style="text-align: left;"|
| style="text-align: left;"| '''3.3V'''
| style="text-align: left;"| '''17'''
|-
| style="text-align: left;"| '''231'''
| style="text-align: left;"| '''PH7'''
| style="text-align: left;"| '''SPI1_MOSI'''
| style="text-align: left;"| '''19'''
|-
| style="text-align: left;"| '''232'''
| style="text-align: left;"| '''PH8'''
| style="text-align: left;"| '''SPI1_MISO'''
| style="text-align: left;"| '''21'''
|-
| style="text-align: left;"| '''230'''
| style="text-align: left;"| '''PH6'''
| style="text-align: left;"| '''SPI1_CLK'''
| style="text-align: left;"| '''23'''
|-
| style="text-align: left;"|
| style="text-align: left;"|
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''25'''
|}
{| class="wikitable" style="width:300px;"
|-
| style="text-align: left;"| '''引脚'''
| style="text-align: left;"| '''功能'''
| style="text-align: left;"| '''GPIO'''
| style="text-align: left;"| '''GPIO序号'''
|-
| style="text-align: left;"| '''2'''
| style="text-align: left;"| '''5V'''
| style="text-align: left;"|
| style="text-align: left;"|
|-
| style="text-align: left;"| '''4'''
| style="text-align: left;"| '''5V'''
| style="text-align: left;"|
| style="text-align: left;"|
|-
| style="text-align: left;"| '''6'''
| style="text-align: left;"| '''GND'''
| style="text-align: left;"|
| style="text-align: left;"|
|-
| style="text-align: left;"| '''8'''
| style="text-align: left;"| '''UART5_TX'''
| style="text-align: left;"| '''PH2'''
| style="text-align: left;"| '''226'''
|-
| style="text-align: left;"| '''10'''
| style="text-align: left;"| '''UART5_RX'''
| style="text-align: left;"| '''PH3'''
| style="text-align: left;"| '''227'''
|-
| style="text-align: left;"| '''12'''
| style="text-align: left;"| '''PC11'''
| style="text-align: left;"| '''PC11'''
| style="text-align: left;"| '''75'''
|-
| style="text-align: left;"| '''14'''
| style="text-align: left;"| '''GND'''
| style="text-align: left;"|
| style="text-align: left;"|
|-
| style="text-align: left;"| '''16'''
| style="text-align: left;"| '''PC15'''
| style="text-align: left;"| '''PC15'''
| style="text-align: left;"| '''79'''
|-
| style="text-align: left;"| '''18'''
| style="text-align: left;"| '''PC14'''
| style="text-align: left;"| '''PC14'''
| style="text-align: left;"| '''78'''
|-
| style="text-align: left;"| '''20'''
| style="text-align: left;"| '''GND'''
| style="text-align: left;"|
| style="text-align: left;"|
|-
| style="text-align: left;"| '''22'''
| style="text-align: left;"| '''PC7'''
| style="text-align: left;"| '''PC7'''
| style="text-align: left;"| '''71'''
|-
| style="text-align: left;"| '''24'''
| style="text-align: left;"| '''SPI1_CS'''
| style="text-align: left;"| '''PH9'''
| style="text-align: left;"| '''233'''
|-
| style="text-align: left;"| '''26'''
| style="text-align: left;"| '''PC10'''
| style="text-align: left;"| '''PC10'''
| style="text-align: left;"| '''74'''
|}
</div>
</ol>
<ol start="3" style="list-style-type: decimal;">
<li>26pin接口中总共有'''17'''个GPIO口，所有GPIO口的电压都是'''<span style="color:#FF0000">3.3v</span>'''</li></ol>

<span id="安装wiringop的方法"></span>

== 安装wiringOP的方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。'''

'''编译好的wiringOP的deb包在orangepi-build中的存放路径为：'''

'''<span style="color:blue">orangepi-build/external/cache/debs/arm64/wiringpi_x.xx.deb</span>'''

'''进入系统后可以运行下gpio readall命令，如果能看到下面的输出，说明wiringOP已经预装并且能正常使用。'''

[[File:zero3-img172.png]]

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

<ol style="list-style-type: decimal;">
<li><p>下载wiringOP的代码</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt install -y git'''</p>
<p>orangepi@orangepi:~$ '''git clone https://github.com/orangepi-xunlong/wiringOP.git -b next'''</p>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，源码需要下载wiringOP next分支的代码，请别漏了-b next这个参数。'''</p>
<p>'''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/usr/src/wiringOP。'''</p></big>
|}
</li>
<li><p>编译安装wiringOP</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd wiringOP'''</p>
<p>orangepi@orangepi:~/wiringOP$ '''sudo ./build clean'''</p>
<p>orangepi@orangepi:~/wiringOP$ '''sudo ./build'''</p>
|}
</li>
<li><p>测试gpio readall命令的输出如下</p>
<ol style="list-style-type: lower-alpha;">
<li><p>其中1到26号引脚与开发板上的26 Pin引脚是一一对应的</p></li>
<li><p>27号引脚对应开发板上13pin的10号引脚</p></li>
<li><p>29号引脚对应开发板上13pin的11号引脚</p></li>
<li><p>31号引脚对应开发板上13pin的12号引脚</p></li>
<li><p>33号引脚对应开发板上13pin的13号引脚</p></li>
<li><p>'''<span style="color:#FF0000">28、30、32、34号引脚为空，请直接忽略</span>'''</p>
<p>[[File:zero3-img172.png]]</p></li></ol>
</li></ol>

<span id="pin接口gpioi2cuartspi和pwm测试"></span>

== 26pin接口GPIO、I2C、UART、SPI和PWM测试 ==

<span id="pin-gpio口测试"></span>
=== 26pin GPIO口测试 ===

<ol style="list-style-type: decimal;">
<li><p>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的高低电平</p>
<p>[[File:zero3-img173.png]]</p></li>
<li><p>首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio mode <span style="color:#FF0000">2</span> out'''</p>
|}
</li>
<li><p>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio write 2 <span style="color:#FF0000">0</span>'''</p>
|}
<p>使用gpio readall可以看到7号引脚的值(V)变为了0</p>
<p>[[File:zero3-img174.png]]</p></li>
<li><p>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio write 2 <span style="color:#FF0000">1</span>'''</p>
|}
<p>使用gpio readall可以看到7号引脚的值(V)变为了1</p>
<p>[[File:zero3-img175.png]]</p></li>
<li><p>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可</p></li></ol>

<span id="pin-gpio口上下拉电阻的设置方法"></span>

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

<ol style="list-style-type: decimal;">
<li><p>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的上下拉电阻</p>
<p>[[File:zero3-img173.png]]</p></li>
<li><p>首先需要设置GPIO口为输入模式，其中第三个参数需要输入引脚对应的wPi的序号</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio mode <span style="color:#FF0000">2</span> in'''</p>
|}
</li>
<li><p>设置为输入模式后，执行下面的命令可以设置GPIO口为上拉模式</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio mode <span style="color:#FF0000">2</span> up'''</p>
|}
</li>
<li><p>然后输入下面的命令读取GPIO口的电平，如果电平为1，说明上拉模式设置成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio read <span style="color:#FF0000">2</span>'''</p>
<p>'''1'''</p>
|}
</li>
<li><p>然后执行下面的命令可以设置GPIO口为下拉模式</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio mode <span style="color:#FF0000">2</span> down'''</p>
|}
</li>
<li><p>然后输入下面的命令读取GPIO口的电平，如果电平为0，说明下拉模式设置成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP# '''gpio read <span style="color:#FF0000">2</span>'''</p>
<p>'''0'''</p>
|}
</li></ol>

<span id="pin-spi测试"></span>

=== 26pin SPI测试 ===

<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的spi为spi1</p>
<p>[[File:zero3-img176.png]]</p></li>
<li><p>Linux系统中spi1默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''spi1-cs1-spidev'''</p>
<p>[[File:zero3-img177.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /dev/spidev1*'''</p>
<p>/dev/spidev1.1</p>
|}
</li>
<li><p>先不短接SPI1的mosi和miso两个引脚，运行spidev_test的输出结果如下所示，可以看到TX和RX的数据不一致</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo spidev_test -v -D /dev/spidev1.1'''</p>
<p>spi mode: 0x0</p>
<p>bits per word: 8</p>
<p>max speed: 500000 Hz (500 KHz)</p>
<p>TX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p>
<p>RX | FF FF FF FF FF FF '''<span style="color:#FF0000">FF FF FF FF FF FF</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ............................….</p>
|}
</li>
<li><p>然后短接SPI1的mosi（26pin接口中的第19号引脚）和miso（26pin接口中的第21号引脚）两个引脚再运行spidev_test的输出如下，可以看到发送和接收的数据一样</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo spidev_test -v -D /dev/spidev1.1'''</p>
<p>spi mode: 0x0</p>
<p>bits per word: 8</p>
<p>max speed: 500000 Hz (500 KHz)</p>
<p>TX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p>
<p>RX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p>
|}
</li></ol>

<span id="pin-i2c测试"></span>

=== 26pin I2C测试 ===

<ol style="list-style-type: decimal;">
<li><p>由26pin的原理图可知，可用的i2c为i2c3</p>
<p>[[File:zero3-img178.png]]</p></li>
<li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-i2c3'''</p>
<p>[[File:zero3-img179.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>启动linux系统后，先确认下/dev下存在i2c3的设备节点</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /dev/i2c-3'''</p>
<p>'''/dev/i2c-3'''</p>
|}
</li>
<li><p>然后开始测试i2c，首先安装i2c-tools</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y i2c-tools'''</p>
|}
</li>
<li><p>然后在26pin接头的i2c3引脚上接一个i2c设备</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''5V和3.3V引脚请根据具体的i2c设备进行选择，不同的i2c设备需要的电压值可能不同。'''</p></big>
|}

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''sda引脚'''
| style="text-align: left;"| '''对应26pin中3号引脚'''
|-
| style="text-align: left;"| '''sck引脚'''
| style="text-align: left;"| '''对应26pin中5号引脚'''
|-
| style="text-align: left;"| '''5v引脚'''
| style="text-align: left;"| '''对应26pin中2号引脚'''
|-
| style="text-align: left;"| '''3.3v引脚'''
| style="text-align: left;"| '''对应26pin中1号引脚'''
|-
| style="text-align: left;"| '''gnd引脚'''
| style="text-align: left;"| '''对应26pin中6号引脚'''
|}
</li></ol>
<ol start="6" style="list-style-type: decimal;">
<li><p>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c能正常使用</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''不同的i2c设备地址是不同的，下图0x50地址只是一个示例。请以实际看到的为准。'''</p></big>
|}
<div class="figure">

[[File:zero3-img180.png]]

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

<span id="pin的uart测试"></span>

=== 26pin的UART测试 ===

<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的uart为uart5</p>
<p>[[File:zero3-img181.png]]</p></li>
<li><p>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-uart5'''</p>
<p>[[File:zero3-img182.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，linux5.4系统为/dev/ttyAS5。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /dev/ttyS5'''</p>
<p>/dev/ttyS5</p>
|}
</li>
<li><p>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx</p></li>

{| class="wikitable" style="width:500px;"
|-
|
| style="text-align: left;"| uart5
|-
| tx引脚
| style="text-align: left;"| 对应26pin的8号引脚
|-
| rx引脚
| style="text-align: left;"| 对应26pin的10号引脚
|}
</ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>使用wiringOP中的'''gpio'''命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gpio serial /dev/ttyS5 # linux-6.1测试命令'''</p>
<p>orangepi@orangepi:~$ '''gpio serial /dev/ttyAS5 # linux-5.4测试命令'''</p>


<p>Out: 0: -&gt; 0</p>
<p>Out: 1: -&gt; 1</p>
<p>Out: 2: -&gt; 2</p>
<p>Out: 3: -&gt; 3^C</p>
|}
</li></ol>

<span id="pwm的测试方法"></span>

=== PWM的测试方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''开发板最多可以使用4通道PWM，它们所在引脚的位置如下图所示:'''</big>

[[File:zero3-img183.png|center]]
|}

<ol style="list-style-type: decimal;">
<li><p>Linux系统中pwm默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中pwm对应的配置</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''由于PWM1、PWM2和26pin接口中UART5的RX、TX引脚是复用的，所以打开PWM1和PWM2（需要选择ph-pwm12）时请确保没有选择UART5的配置（不要勾选ph-uart5）。'''</p>
<p>'''PWM3、PWM4和调试串口中的TX、RX引脚是复用的，所以使用PWM3和PWM4（需要选择ph-pwm34）时请将UART0的配置关掉（需要选择disable-uart0），关掉UART0后调试串口就无法使用了。'''</p></big>
|}
<p>[[File:zero3-img184.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>重启后就可以开始PWM的测试</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''下面的命令请在root用户下执行。'''</p></big>
|}
<ol style="list-style-type: lower-alpha;">
<li><p>在命令行中输入下面的命令可以让pwm1输出一个50Hz的方波</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''echo 1 &gt; /sys/class/pwm/pwmchip0/export'''</p>
<p>root@orangepi:~# '''echo 20000000 &gt; /sys/class/pwm/pwmchip0/pwm1/period'''</p>
<p>root@orangepi:~# '''echo 1000000 &gt; /sys/class/pwm/pwmchip0/pwm1/duty_cycle'''</p>
<p>root@orangepi:~# '''echo 1 &gt; /sys/class/pwm/pwmchip0/pwm1/enable'''</p>
|}
</li>
<li><p>在命令行中输入下面的命令可以让pwm2输出一个50Hz的方波</p></li>

{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~# '''echo 2 &gt; /sys/class/pwm/pwmchip0/export'''

root@orangepi:~# '''echo 20000000 &gt; /sys/class/pwm/pwmchip0/pwm2/period'''

root@orangepi:~# '''echo 1000000 &gt; /sys/class/pwm/pwmchip0/pwm2/duty_cycle'''

root@orangepi:~# '''echo 1 &gt; /sys/class/pwm/pwmchip0/pwm2/enable'''
|}
</ol>
<ol start="3" style="list-style-type: lower-alpha;">
<li>在命令行中输入下面的命令可以让pwm3输出一个50Hz的方波</li>

{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~# '''echo 3 &gt; /sys/class/pwm/pwmchip0/export'''

root@orangepi:~# '''echo 20000000 &gt; /sys/class/pwm/pwmchip0/pwm3/period'''

root@orangepi:~# '''echo 1000000 &gt; /sys/class/pwm/pwmchip0/pwm3/duty_cycle'''

root@orangepi:~# '''echo 1 &gt; /sys/class/pwm/pwmchip0/pwm3/enable'''
|}
</ol>
<ol start="4" style="list-style-type: lower-alpha;">
<li>在命令行中输入下面的命令可以让pwm4输出一个50Hz的方波</li>

{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~# '''echo 4 &gt; /sys/class/pwm/pwmchip0/export'''

root@orangepi:~# '''echo 20000000 &gt; /sys/class/pwm/pwmchip0/pwm4/period'''

root@orangepi:~# '''echo 1000000 &gt; /sys/class/pwm/pwmchip0/pwm4/duty_cycle'''

root@orangepi:~# '''echo 1 &gt; /sys/class/pwm/pwmchip0/pwm4/enable'''
|}

<div class="figure">

[[File:zero3-img185.png]]

</div>
</ol>
</li></ol>
<span id="wiringop-python的安装使用方法"></span>

== wiringOP-Python的安装使用方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''wiringOP-Python是wiringOP的Python语言版本的库，用于在Python程序中操作开发板的GPIO、I2C、SPI和UART等硬件资源。'''


'''另外请注意下面所有的命令都是在<span style="color:#FF0000">root</span>用户下操作的。'''</big>
|}

<span id="wiringop-python的安装方法"></span>
=== wiringOP-Python的安装方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先安装依赖包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''sudo apt-get update'''</p>
<p>root@orangepi:~# '''sudo apt-get -y install git swig python3-dev python3-setuptools'''</p>
|}
</li>
<li><p>然后使用下面的命令下载wiringOP-Python的源码</p></li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，下面的git clone--recursive命令会自动下载wiringOP的源码，因为wiringOP-Python是依赖wiringOP的。请确保下载过程没有因为网络问题而报错。'''


'''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP-Python源码，存放位置为：/usr/src/wiringOP-Python'''。</big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~# '''git clone --recursive https://github.com/orangepi-xunlong/wiringOP-Python -b next'''

root@orangepi:~# '''cd wiringOP-Python'''

root@orangepi:~/wiringOP-Python# '''git submodule update --init --remote'''
|}
</ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后使用下面的命令编译wiringOP-Python并将其安装到开发板的Linux系统中</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''cd wiringOP-Python'''</p>
<p>root@orangepi:~/wiringOP-Python# '''python3 generate-bindings.py &gt; bindings.i'''</p>
<p>root@orangepi:~/wiringOP-Python# '''sudo python3 setup.py install'''</p>
|}
</li>
<li><p>然后输入下面的命令，如果有帮助信息输出，说明wiringOP-Python安装成功，按下'''q'''键可以退出帮助信息的界面</p></li>

{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~/wiringOP-Python# '''python3 -c &quot;import wiringpi; help(wiringpi)&quot;'''

Help on module wiringpi:


NAME

:wiringpi


DESCRIPTION

: # This file was automatically generated by SWIG (http://www.swig.org).

: # Version 4.0.2

: #

: # Do not make changes to this file unless you know what you are doing--modify

: # the SWIG interface file instead.
|}
</ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>在python命令行下测试wiringOP-Python是否安装成功的步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li>首先使用python3命令进入python3的命令行模式</li>

{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~# '''python3'''
|}
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li>然后导入wiringpi的python模块</li>

{| class="wikitable" style="width:800px;" 
|-
| 
&gt;&gt;&gt; '''import wiringpi;'''
|}
</ol>
<ol start="3" style="list-style-type: lower-alpha;">
<li>最后输入下面的命令可以查看下wiringOP-Python的帮助信息，按下'''q'''键可以退出帮助信息的界面</li>

{| class="wikitable" style="width:800px;" 
|-
| 
&gt;&gt;&gt; '''help(wiringpi)'''

Help on module wiringpi:


NAME

:wiringpi


DESCRIPTION

: # This file was automatically generated by SWIG (http://www.swig.org).

: # Version 4.0.2

: #

: # Do not make changes to this file unless you know what you are doing--modify

: # the SWIG interface file instead.


CLASSES

:builtins.object

::GPIO

::I2C

::Serial

::nes


:class GPIO(builtins.object)

:| GPIO(pinmode=0)

:|


&gt;&gt;&gt;
|}
</ol>
</li></ol>

<span id="pin-gpio口测试-1"></span>

=== 26pin GPIO口测试 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''wiringOP-Python跟wiringOP一样，也是可以通过指定wPi号来确定操作哪一个GPIO引脚，因为wiringOP-Python中没有查看wPi号的命令，所以只能通过wiringOP中的gpio命令来查看板子wPi号与物理引脚的对应关系。'''</big>

[[File:zero3-img172.png]]
|}

<ol style="list-style-type: decimal;">
<li><p>下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平</p>
<p>[[File:zero3-img173.png]]</p></li>
<li><p>直接用命令测试的步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先设置GPIO口为输出模式，其中'''pinMode'''函数的第一个参数是引脚对应的wPi的序号，第二个参数是GPIO的模式</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP-Python# '''python3 -c &quot;import wiringpi; \'''</p>
<p>'''from wiringpi import GPIO; wiringpi.wiringPiSetup() ; \'''</p>
<p>'''wiringpi.pinMode(<span style="color:#FF0000">2, GPIO.OUTPUT</span>) ; &quot;'''</p>
|}
</li>
<li><p>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP-Python# '''python3 -c &quot;import wiringpi; \'''</p>
<p>'''from wiringpi import GPIO; wiringpi.wiringPiSetup() ;\'''</p>
<p>'''wiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.LOW</span>)&quot;'''</p>
|}
</li>
<li><p>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP-Python# '''python3 -c &quot;import wiringpi; \'''</p>
<p>'''from wiringpi import GPIO; wiringpi.wiringPiSetup() ;\'''</p>
<p>'''wiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.HIGH</span>)&quot;'''</p>
|}
</li></ol>
</li>
<li><p>在python3的命令行中测试的步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先使用python3命令进入python3的命令行模式</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~# '''python3'''</p>
|}
</li>
<li><p>然后导入wiringpi的python模块</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>&gt;&gt;&gt; '''import wiringpi'''</p>
<p>&gt;&gt;&gt; '''from wiringpi import GPIO'''</p>
|}
</li>
<li><p>然后设置GPIO口为输出模式，其中'''pinMode'''函数的第一个参数是引脚对应的wPi的序号，第二个参数是GPIO的模式</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>&gt;&gt;&gt; '''wiringpi.wiringPiSetup()'''</p>
<p>0</p>
<p>&gt;&gt;&gt; '''wiringpi.pinMode(<span style="color:#FF0000">2, GPIO.OUTPUT</span>)'''</p>
|}
</li>
<li><p>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>&gt;&gt;&gt; '''wiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.LOW</span>)'''</p>
|}
</li>
<li><p>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>&gt;&gt;&gt; '''wiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.HIGH</span>)'''</p>
|}
</li></ol>
</li>
<li><p>wiringOP-Python在python代码中设置GPIO高低电平的方法可以参考下examples中的'''blink.py'''测试程序，'''blink.py'''测试程序会设置开发板26 pin中所有的GPIO口的电压不断的高低变化</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP-Python# '''cd examples'''</p>
<p>root@orangepi:~/wiringOP-Python/examples# '''ls blink.py'''</p>
<p>'''blink.py'''</p>
<p>root@orangepi:~/wiringOP-Python/examples'''# python3 blink.py'''</p>
|}
</li></ol>

<span id="pin-spi测试-1"></span>

=== 26pin SPI测试 ===

<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的spi为spi1</p>
<p>[[File:zero3-img176.png]]</p></li>
<li><p>Linux系统中spi1默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''spi1-cs1-spidev'''</p>
<p>[[File:zero3-img177.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /dev/spidev1*'''</p>
<p>/dev/spidev1.1</p>
|}
</li>
<li><p>然后可以使用examples中的'''spidev_test.py'''程序测试下SPI的回环功能，'''spidev_test.py'''程序需要指定下面的两个参数：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''--channel'''：指定SPI的通道号</p></li>
<li><p>'''--port'''：指定SPI的端口号</p></li></ol>
</li>
<li><p>先不短接 SPI1 的 mosi 和 miso 两个引脚，运行spidev_test.py的输出结果如下所示，可以看到 TX 和 RX 的数据不一致</p>
{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~/wiringOP-Python# '''cd examples'''

root@orangepi:~/wiringOP-Python/examples# '''python3 spidev_test.py \'''

'''--channel 1 --port 1'''

spi mode: 0x0

max speed: 500000 Hz (500 KHz)

Opening device /dev/spidev1.1

TX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|

RX | FF FF FF FF FF FF '''<span style="color:#FF0000">FF FF FF FF FF FF</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF |.............….|
|}
</li></ol>
<ol start="6" style="list-style-type: decimal;">
<li><p>然后使用杜邦线短接SPI1的txd（26pin接口中的第19号引脚）和rxd（26pin接口中的第21号引脚）两个引脚再运行spidev_test.py的输出如下，可以看到发送和接收的数据一样，说明SPI1回环测试正常</p>
{| class="wikitable" style="width:800px;" 
|-
| 
root@orangepi:~/wiringOP-Python# '''cd examples'''

root@orangepi:~/wiringOP-Python/examples# '''python3 spidev_test.py \'''

'''--channel 1 --port 1'''

spi mode: 0x0

max speed: 500000 Hz (500 KHz)

Opening device /dev/spidev1.1

TX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|

RX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|
|}
</li></ol>

<span id="pin-i2c测试-1"></span>

=== 26pin I2C测试 ===

<ol style="list-style-type: decimal;">
<li><p>由26pin的原理图可知，可用的i2c为i2c3</p>
<p>[[File:zero3-img178.png]]</p></li>
<li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-i2c3'''</p>
<p>[[File:zero3-img179.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>启动linux系统后，先确认下/dev下存在i2c3的设备节点</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /dev/i2c-3'''</p>
<p>'''/dev/i2c-3'''</p>
|}
</li>
<li><p>然后开始测试i2c，首先安装下i2c-tools</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo''' '''apt-get install -y i2c-tools'''</p>
|}
</li>
<li><p>然后在26pin接头的i2c3引脚上接一个i2c设备，这里以DS1307 RTC模块为例</p>
<p>[[File:zero3-img186.png]]</p></li>

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''RTC模块的引脚'''
| style="text-align: left;"| '''开发板26pin对应的引脚'''
|-
| style="text-align: left;"| '''5V'''
| style="text-align: left;"| '''2号引脚'''
|-
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''6号引脚'''
|-
| style="text-align: left;"| '''SDA'''
| style="text-align: left;"| '''3号引脚'''
|-
| style="text-align: left;"| '''SCL'''
| style="text-align: left;"| '''5号引脚'''
|}
</ol>
<ol start="6" style="list-style-type: decimal;">
<li>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c设备连接正确</li>

[[File:zero3-img187.png]]
</ol>
<ol start="7" style="list-style-type: decimal;">
<li><p>然后可以运行'''examples'''中的'''ds1307.py'''测试程序读取RTC的时间</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP-Python# '''cd examples'''</p>
<p>root@orangepi:~/wiringOP-Python/examples# '''python3 ds1307.py --device \'''</p>
<p>'''&quot;/dev/i2c-3&quot;'''</p>
<p>Thu 2022-06-16 04:35:46</p>
<p>Thu 2022-06-16 04:35:47</p>
<p>Thu 2022-06-16 04:35:48</p>
<p>^C</p>
<p>exit</p>
|}
</li></ol>

<span id="pin的uart测试-1"></span>

=== 26pin的UART测试 ===

<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的uart为uart5</p>
<p>[[File:zero3-img181.png]]</p></li>
<li><p>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:zero3-img86.png]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:zero3-img87.png]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-uart5'''</p>
<p>[[File:zero3-img182.png]]</p></li>
<li><p>然后选择'''&lt;Save&gt;'''保存</p>
<p>[[File:zero3-img89.png]]</p></li>
<li><p>然后选择'''&lt;Back&gt;'''</p>
<p>[[File:zero3-img90.png]]</p></li>
<li><p>然后选择'''&lt;Reboot&gt;'''重启系统使配置生效</p>
<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，linux5.4系统为/dev/ttyAS5。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /dev/ttyS5'''</p>
<p>/dev/ttyS5</p>
|}
</li>
<li><p>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx</p></li>

{| class="wikitable" style="width:800px;" 
|-
|
| style="text-align: left;"| '''uart5'''
|-
| '''tx引脚'''
| style="text-align: left;"| '''对应26pin中的8号引脚'''
|-
| '''rx引脚'''
| style="text-align: left;"| '''对应26pin中的10号引脚'''
|}
</ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>最后可以运行examples中的'''serialTest.py'''程序来测试下串口的回环功能，如果能看到下面的打印，说明串口回环测试正常</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/wiringOP-Python# '''cd examples'''</p>
<p>root@orangepi:~/wiringOP-Python/examples# '''python3 serialTest.py --device &quot;/dev/ttyS5&quot; # linux6.1使用'''</p>
<p>root@orangepi:~/wiringOP-Python/examples# '''python3 serialTest.py --device &quot;/dev/ttyAS5&quot; # linux5.4使用'''</p>


<p>Out: 0: -&gt; 0</p>
<p>Out: 1: -&gt; 1</p>
<p>Out: 2: -&gt; 2</p>
<p>Out: 3: -&gt; 3</p>
<p>Out: 4:^C</p>
<p>exit</p>
|}
</li></ol>

== 硬件看门狗测试 ==

Orange Pi发布的linux系统中预装了watchdog_test程序，可以直接测试。

运行watchdog_test程序的方法如下所示：

<ol style="list-style-type: lower-alpha;">
<li><p>第二个参数10表示看门狗的计数时间，如果这个时间内没有喂狗，系统会重启</p></li>
<li><p>我们可以通过按下键盘上的任意键（ESC除外）来喂狗，喂狗后，程序会打印一行keep alive表示喂狗成功</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo watchdog_test 10'''</p>
<p>open success</p>
<p>options is 33152,identity is sunxi-wdt</p>
<p>put_usr return,if 0,success:0</p>
<p>The old reset time is: 16</p>
<p>return ENOTTY,if -1,success:0</p>
<p>return ENOTTY,if -1,success:0</p>
<p>put_user return,if 0,success:0</p>
<p>put_usr return,if 0,success:0</p>
<p>keep alive</p>
<p>keep alive</p>
<p>keep alive</p>
|}
</li></ol>

<span id="查看h618芯片的chipid"></span>

== 查看H618芯片的chipid ==

查看H618芯片chipid的命令如下所示，每个芯片的chipid都是不同的，所以可以使用chipid来区分多个开发板。

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''cat /sys/class/sunxi_info/sys_info | grep &quot;chipid&quot;'''

sunxi_chipid : 338020004c0048080147478824681ed1
|}

<span id="python相关说明"></span>

== Python相关说明 ==

<span id="python源码编译安装的方法"></span>
=== Python源码编译安装的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''如果使用的Ubuntu或者Debian系统软件仓库中的Python版本不符合开发的要求，想要使用最新版本的Python，可以使用下面的方法下载Python的源码包来编译安装最新版本的Python。'''

'''下面演示的是编译安装Python3.9的最新版本，如果要编译安装其他的版本的Python，方法也是一样的（需要下载想要安装的Python对应的源码）。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先安装编译Python需要的依赖包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y build-essential zlib1g-dev \'''</p>
<p>'''libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev \'''</p>
<p>'''libreadline-dev libffi-dev curl libbz2-dev'''</p>
|}
</li>
<li><p>然后下载最新版本的Python3.9源码并解压</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''wget \'''</p>
<p>'''https://www.python.org/ftp/python/3.9.10/Python-3.9.10.tgz'''</p>
<p>orangepi@orangepi:~$ '''tar xvf Python-3.9.10.tgz'''</p>
|}
</li>
<li><p>然后运行配置命令</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd Python-3.9.10'''</p>
<p>orangepi@orangepi:~$ '''./configure --enable-optimizations'''</p>
|}
</li>
<li><p>然后编译安装Python3.9，编译时间大概需要半个小时左右</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''make -j4'''</p>
<p>orangepi@orangepi:~$ '''sudo make altinstall'''</p>
|}
</li>
<li><p>安装完后可以使用下面的命令查看下刚安装的Python的版本号</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3.9 --version'''</p>
<p>'''Python 3.9.10'''</p>
|}
</li>
<li><p>然后更新下pip</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''/usr/local/bin/python3.9 -m pip install --upgrade pip'''</p>
|}
</li></ol>

<span id="python更换pip源的方法"></span>

=== Python更换pip源的方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''Linux系统pip默认使用的源为Python官方的源，但是国内访问Python官方的源速度是很慢的，并且经常会由于网络原因导致Python软件包安装失败。所以在使用pip安装Python库时，请记得更换下pip源。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先安装下'''python3-pip'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y python3-pip'''</p>
|}
</li>
<li><p>Linux下永久更换pip源的方法</p>
<ol style="list-style-type: lower-alpha;">
<li><p>先新建'''~/.pip'''目录，然后添加'''pip.conf'''配置文件，并在其中设置pip的源为清华源</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''mkdir -p ~/.pip'''</p>
<p>orangepi@orangepi:~$ '''cat &lt;&lt;EOF &gt; ~/.pip/pip.conf'''</p>
<p>'''[global]'''</p>
<p>'''timeout = 6000'''</p>
<p>'''index-url = https://pypi.tuna.tsinghua.edu.cn/simple'''</p>
<p>'''trusted-host = pypi.tuna.tsinghua.edu.cn'''</p>
<p>'''EOF'''</p>
|}
</li>
<li><p>然后使用pip3安装Python库速度就会很快了</p></li></ol>
</li>
<li><p>Linux下临时更换pip源的方法，其中的'''&lt;packagename&gt;'''需要替换为具体的包名</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''pip3 install &lt;packagename&gt; -i \'''</p>
<p>'''https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn'''</p>
|}
</li></ol>

<span id="安装docker的方法"></span>

== 安装Docker的方法 ==

Orange Pi提供的linux镜像已经预装了Docker，只是Docker服务默认没有打开。使用'''enable_docker.sh'''脚本可以使能docker服务，然后就可以开始使用docker命令了，并且在下次启动系统时也会自动启动docker服务。

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''enable_docker.sh'''
|}

可以使用下面的命令测试下docker，如果能运行'''hello-world'''说明docker能正常使用了。

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''docker run hello-world'''

Unable to find image 'hello-world:latest' locally

latest: Pulling from library/hello-world

256ab8fe8778: Pull complete

Digest: sha256:7f0a9f93b4aa3022c3a4c147a449ef11e0941a1fd0bf4a8e6c9408b2600777c5

Status: Downloaded newer image for hello-world:latest


'''<span style="color:#FF0000">Hello from Docker!</span>'''

'''<span style="color:#FF0000">This message shows that your installation appears to be working correctly.</span>'''

'''.….'''
|}

使用docker命令时，如果提示'''permission denied'''，请将当前用户加入到docker用户组，这样不需要sudo就能运行docker命令了。

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''sudo usermod -aG docker $USER'''
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意：需要退出重新登录系统才能生效，重启系统也可以。'''</big>
|}

<span id="home-assistant的安装方法"></span>

== Home Assistant的安装方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，这里只会提供在Ubuntu或者Debian系统中安装Home Assistant的方法，Home Assistant详细的使用方法请参考官方文档或者相应的书籍。'''</big>
|}

=== 通过docker安装 ===

<ol style="list-style-type: decimal;">
<li><p>首先请安装好docker，并确保docker能正常运行。docker的安装步骤请参考[[Orange Pi Zero 3#安装Docker的方法|'''安装Docker的方法''']]一节的说明。</p></li>
<li><p>然后可以搜索下Home Assistant的docker镜像</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''docker search homeassistant'''</p>
|}
</li>
<li><p>然后使用下面的命令下载Home Assistant的docker镜像到本地，镜像大小大概有1GB多，下载时间会比较长，请耐心等待下载完成</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''docker pull homeassistant/home-assistant'''</p>
<p>Using default tag: latest</p>
<p>latest: Pulling from homeassistant/home-assistant</p>
<p>be307f383ecc: Downloading</p>
<p>5fbc4c07ac88: Download complete</p>
<p>'''...... (省略部分输出)'''</p>
<p>3cc6a1510c9f: Pull complete</p>
<p>7a4e4d5b979f: Pull complete</p>
<p>Digest: sha256:81d381f5008c082a37da97d8b08dd8b358dae7ecf49e62ce3ef1eeaefc4381bb</p>
<p>Status: Downloaded newer image for homeassistant/home-assistant:latest</p>
<p>docker.io/homeassistant/home-assistant:latest</p>
|}
</li>
<li><p>然后可以使用下面的命令查看下刚下载的Home Assistant的docker镜像</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''docker images homeassistant/home-assistant'''</p>
<p>REPOSITORY &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; TAG &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; IMAGE &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ID &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; CREATED &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; SIZE</p>
<p>homeassistant/home-assistant &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; latest &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; bfa0ab9e1cf5 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2 months ago &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; '''<span style="color:#FF0000">1.17GB</span>'''</p>
|}
</li>
<li><p>此时就可以运行Home Assistant的docker容器了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''docker run -d \'''</p>
:<p>'''--name homeassistant \'''</p>
:<p>'''--privileged \'''</p>
:<p>'''--restart=unless-stopped \'''</p>
:<p>'''-e TZ=Asia/Shanghai \'''</p>
:<p>'''-v /home/orangepi/home-assistant:/config \'''</p>
:<p>'''--network=host \'''</p>
:<p>'''homeassistant/home-assistant:latest'''</p>
|}
</li>
<li><p>然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''</p></big>
|}
<p>[[File:zero3-img188.png]]</p></li>
<li><p>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''</p>
<p>[[File:zero3-img189.png]]</p></li>
<li><p>然后按照界面提示根据自己的喜好设置，再点击下一步</p>
<p>[[File:zero3-img190.png]]</p></li>
<li><p>然后点击下一步</p>
<p>[[File:zero3-img191.png]]</p></li>
<li><p>然后点击完成</p>
<p>[[File:zero3-img192.png]]</p></li>
<li><p>Home Assistant最终显示的主界面如下图所示</p>
<p>[[File:zero3-img193.png]]</p></li>
<li><p>停止Home Assistant容器的方法</p>
<ol style="list-style-type: lower-alpha;">
<li><p>查看docker容器的命令如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''docker ps -a'''</p>
|}
</li>
<li><p>停止Home Assistant容器的命令如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''docker stop homeassistant'''</p>
|}
</li>
<li><p>删除Home Assistant容器的命令如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''docker rm homeassistant'''</p>
|}
</li></ol>
</li></ol>

=== 通过python安装 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''安装前请先更换下pip的源为国内源，加快Python包的安装速度，配置方法见[[Orange Pi Zero 3#Python更换pip源的方法|'''Python更换pip源的方法''']]一节的说明。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先安装依赖包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y python3 python3-dev python3-venv \'''</p>
<p>'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''</p>
<p>'''libopenjp2-7 libtiff5 libturbojpeg0-dev tzdata'''</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''如果是debian12请使用下面的命令：'''</p></big>

<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y python3 python3-dev python3-venv \'''</p>
<p>'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''</p>
<p>'''libopenjp2-7 libturbojpeg0-dev tzdata'''</p>
|}
</li>
<li><p>然后需要编译安装Python3.9，方法请参考[[Orange Pi Zero 3#Python源码编译安装的方法|'''Python源码编译安装的方法''']]一节</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''Debian Bullseye默认的Python版本就是Python3.9，所以无需编译安装。'''</p>
<p>'''Ubuntu Jammy默认的Python版本就是Python3.10，所以也无需编译安装。'''</p>
<p>'''Debian Bookworm默认的Python版本就是Python3.11，所以也无需编译安装。'''</p></big>
|}
</li>
<li><p>然后创建Python虚拟环境</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''Debian Bookworm中是python3.11，请记得替换对应的命令。'''</p></big>
|}
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo mkdir /srv/homeassistant'''</p>
<p>orangepi@orangepi:~$ '''sudo chown orangepi:orangepi /srv/homeassistant'''</p>
<p>orangepi@orangepi:~$ '''cd /srv/homeassistant'''</p>
<p>orangepi@orangepi:~$ '''python3.9 -m venv .'''</p>
<p>orangepi@orangepi:~$ '''source bin/activate'''</p>
<p>(homeassistant) orangepi@orangepi:/srv/homeassistant$</p>
|}
</li>
<li><p>然后安装需要的Python包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>(homeassistant) orangepi@orangepi:/srv/homeassistant$ '''python3 -m pip install wheel'''</p>
|}
</li>
<li><p>然后就可以安装Home Assistant Core</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>(homeassistant) orangepi@orangepi:/srv/homeassistant$ '''pip3 install homeassistant'''</p>
|}
</li>
<li><p>然后输入下面的命令就可以运行Home Assistant Core</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>(homeassistant) orangepi@orangepi:/srv/homeassistant$ '''hass'''</p>
|}
</li>
<li><p>然后在浏览器中输入【'''开发板的IP地址:8123'''】就能看到Home Assistant的界面</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。'''</p></big>
|}
<p>[[File:zero3-img194.png]]</p></li></ol>

<span id="opencv的安装方法"></span>

== OpenCV的安装方法 ==

<span id="使用apt来安装opencv"></span>
=== 使用apt来安装OpenCV ===

<ol style="list-style-type: decimal;">
<li><p>安装命令如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y libopencv-dev python3-opencv'''</p>
|}
</li>
<li><p>然后使用下面的命令打印OpenCV的版本号输出正常，说明OpenCV安装成功</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Ubuntu22.04中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 -c &quot;import cv2; print(cv2.__version__)&quot;'''</p>
<p>'''4.5.4'''</p>
|}
</li>
<li><p>Ubuntu20.04中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 -c &quot;import cv2; print(cv2.__version__)&quot;'''</p>
<p>'''4.2.0'''</p>
|}
</li>
<li><p>Debian11中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 -c &quot;import cv2; print(cv2.__version__)&quot;'''</p>
<p>'''4.5.1'''</p>
|}
</li>
<li><p>Debian12中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 -c &quot;import cv2; print(cv2.__version__)&quot;'''</p>
<p>'''4.6.0'''</p>
|}
</li></ol>
</li></ol>

<span id="宝塔linux面板的安装方法"></span>

== 宝塔Linux面板的安装方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''宝塔Linux面板是提升运维效率的服务器管理软件，支持一键LAMP/LNMP/集群/监控/网站/FTP/数据库/JAVA等100多项服务器管理功能（摘抄自[https://www.bt.cn/ 宝塔官网]）'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先需要扩展下'''/tmp'''空间的大小，设置完后需要'''<span style="color:#FF0000">重启下开发板的linux系统</span>'''，命令如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo sed -i 's/nosuid/&amp;,size=2G/' /etc/fstab'''</p>
<p>orangepi@orangepi:~$ '''sudo reboot'''</p>
|}
</li>
<li><p>重启后，可以看到'''/tmp'''空间的大小变为2G了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''df -h | grep &quot;/tmp&quot;'''</p>
<p>tmpfs 2.0G 12K '''<span style="color:#FF0000">2.0G</span>''' 1% /tmp</p>
|}
</li>
<li><p>然后在linux系统中输入下面的命令就可以开始宝塔的安装</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo install_bt_panel.sh'''</p>
|}
</li>
<li><p>然后宝塔安装程序会提醒是否安装'''Bt-Panel'''到'''/www'''文件夹，此时输入'''y'''即可</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>+----------------------------------------------------------------------</p>
<p>| Bt-WebPanel FOR CentOS/Ubuntu/Debian</p>
<p>+----------------------------------------------------------------------</p>
<p>| Copyright © 2015-2099 BT-SOFT(http://www.bt.cn) All rights reserved.</p>
<p>+----------------------------------------------------------------------</p>
<p>| The WebPanel URL will be http://SERVER_IP:8888 when installed.</p>
<p>+----------------------------------------------------------------------</p>


<p>Do you want to install Bt-Panel to the /www directory now?(y/n): '''<span style="color:#FF0000">y</span>'''</p>
|}
</li>
<li><p>然后要做的就是耐心等待，当看到终端输出下面的打印信息时，说明宝塔已经安装完成，整个安装过程大约耗时34分钟，根据网络速度的不同可能会有一些差别</p>
<p>[[File:zero3-img195.png]]</p></li>
<li><p>此时在浏览器中输入上面显示的'''面板地址'''就可以打开宝塔Linux面板的登录界面，然后在对应的位置输入上图显示的'''username'''和'''password'''就可以登录进宝塔<br />
[[File:zero3-img196.png]]</p></li>
<li><p>成功登录宝塔后的会弹出下面的欢迎界面，首先请将中间的用户须知阅读完拖到最下面，然后就可以选择”我已同意并阅读《用户协议》“，接着点击”进入面板”就可以进入宝塔了</p>
<p>[[File:zero3-img197.png|1200px]]</p></li>
<li><p>进入宝塔后首先会提示需要绑定宝塔官网的账号，如果没有账号可以去宝塔的官网（'''https://www.bt.cn'''）注册一个</p>
<p>[[File:zero3-img198.png]]</p></li>
<li><p>最终显示的界面如下图所示，可以很直观的看到开发板Linux系统的一些状态信息，比如负载状态、CPU的使用率、内存使用率和存储空间的使用情况等</p>
<p>[[File:zero3-img199.png|1200px]]</p></li>
<li><p>宝塔的更多功能可以参考下面资料自行探索</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>使用手册：[http://docs.bt.cn '''http://docs.bt.cn''']</p>
<p>论坛地址：[https://www.bt.cn/bbs '''https://www.bt.cn/bbs''']</p>
<p>GitHub链接：'''https://github.com/aaPanel/BaoTa'''</p>
|}
</li></ol>

== face_recognition人脸识别库的安装和测试方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，此小节的内容都是在<span style="color:#FF0000">桌面版本</span>的Linux系统中测试的，所以请确保开发板使用的系统为桌面版本的系统。'''

'''另外下面的安装测试都是在<span style="color:#FF0000">orangepi</span>用户下进行的，请保持环境一致。'''


'''Debian12目前没有适配。'''</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''face_recognition源码仓库的地址为：'''

'''https://github.com/ageitgey/face_recognition'''

'''face_recognition中文版本的说明文档为：'''

'''https://github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.md'''</big>
|}

=== 使用脚本自动安装face_recognition的方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先在桌面中打开一个终端，然后下载'''face_recognition_install.sh'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/Desktop$ '''wget \'''</p>
<p>'''https://gitee.com/leeboby/face_recognition_install/raw/master/face_recognition_install.sh'''</p>
|}
</li>
<li><p>然后执行下面的命令开始安装'''face_recognition'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/Desktop$ '''bash face_recognition_install.sh'''</p>
|}
</li>
<li><p>face_recognition安装完后会自动下载face_recognition的源码，然后自动运行face_recognition中的一些示例，如果最后能看到桌面上弹出了下面的这些图片就说明face_recognition安装测试成功了</p>
<p>[[File:zero3-img200.png]]</p></li></ol>

=== 手动安装face_recognition的方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先新建'''~/.pip'''目录，再添加'''pip.conf'''配置文件，并在其中设置pip的镜像源为清华源，需要执行的命令如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''mkdir -p ~/.pip'''</p>
<p>orangepi@orangepi:~$ '''cat &lt;&lt;EOF &gt; ~/.pip/pip.conf'''</p>
<p>'''[global]'''</p>
<p>'''timeout = 6000'''</p>
<p>'''index-url = https://pypi.tuna.tsinghua.edu.cn/simple'''</p>
<p>'''trusted-host = pypi.tuna.tsinghua.edu.cn'''</p>
<p>'''EOF'''</p>
|}
</li>
<li><p>然后安装依赖包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt install -y python3-pip libopencv-dev \'''</p>
<p>'''python3-opencv imagemagick python3-scipy python3-setuptools python3-wheel \'''</p>
<p>'''python3-dev cmake python3-testresources'''</p>
|}
</li>
<li><p>然后更新下pip3</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 -m pip install -U pip setuptools wheel'''</p>
|}
</li>
<li><p>安装'''face_recognition'''前首先需要安装下'''dlib'''这个库，由于dlib这个库在开发板上编译安装比较慢，所以我在'''gitee'''上保存了一份编译好的dlib whl文件，下载后直接安装就可以了。dlib whl文件下载地址如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''https://gitee.com/leeboby/python_whl'''</p>
|}
<ol style="list-style-type: lower-alpha;">
<li><p>首先将python_whl仓库下载到开发板的Linux系统中</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''git clone --depth=1 https://gitee.com/leeboby/python_whl'''</p>
|}
</li>
<li><p>在python_whl文件夹中可以看到有多个版本的dlib安装包'''，'''dlib不同版本对应的Linux系统如下所示：</p></li>

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''Ubuntu20.04'''
| style="text-align: left;"| '''dlib-19.24.0-cp38-cp38-linux_aarch64.whl'''
|-
| style="text-align: left;"| '''Ubuntu22.04'''
| style="text-align: left;"| '''dlib-19.24.0-cp310-cp310-linux_aarch64.whl'''
|-
| style="text-align: left;"| '''Debian11'''
| style="text-align: left;"| '''dlib-19.24.0-cp39-cp39-linux_aarch64.whl'''
|}
</ol>
<ol start="3" style="list-style-type: lower-alpha;">
<li><p>然后就可以开始安装dlib，命令如下所示</p>
<ol style="list-style-type: none;">
<li><p>a) Ubuntu20.04</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd python_whl'''</p>
<p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-19.24.0-cp38-cp38-linux_aarch64.whl'''</p>
|}
</li>
<li><p>b) Ubuntu22.04</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd python_whl'''</p>
<p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-19.24.0-cp310-cp310-linux_aarch64.whl'''</p>
|}
</li>
<li><p>c) Debian11</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd python_whl'''</p>
<p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-19.24.0-cp39-cp39-linux_aarch64.whl'''</p>
|}
</li></ol>
</li>
<li><p>安装完后如果使用下面的命令能正常打印dlib的版本号，就说明dlib安装正确</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/python_whl$ '''python3 -c &quot;import dlib; print(dlib.__version__)&quot;'''</p>
<p>'''19.24.0'''</p>
|}
</li></ol>
</li></ol>
<!-- -->
<ol start="5" style="list-style-type: decimal;">
<li><p>然后安装下'''face_recognition_models-0.3.0-py2.py3-none-any.whl'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install face_recognition_models-0.3.0-py2.py3-none-any.whl'''</p>
|}
</li>
<li><p>然后安装'''face_recognition'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 -m pip install face_recognition'''</p>
|}
</li>
<li><p>然后'''<span style="color:#FF0000">需要重新打开一个终端</span>'''，才能找到并运行'''face_detection'''和'''face_recognition'''这两个命令</p>
<ol style="list-style-type: lower-alpha;">
<li><p>face_recognition命令用来在单张图片或一个图片文件夹中识别是谁的脸</p></li>
<li><p>face_detection命令用来在单张图片或一个图片文件夹中定位人脸的位置</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''which face_detection'''</p>
<p>/usr/local/bin/face_detection</p>
<p>orangepi@orangepi:~$ '''which face_recognition'''</p>
<p>/usr/local/bin/face_recognition</p>
|}
</li></ol>

如果重新打开终端找不到上面的两个命令，请试下手动导入环境变量，然后再测试下。

{| class="wikitable" style="width:800px;" 
|-
| 
orangepi@orangepi:~$ '''export PATH=/home/orangepi/.local/bin:$PATH'''
|}
</li></ol>

=== face_recognition的测试方法 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，下面的操作都是在桌面中演示的，所以首先请连接好HDMI显示器，或者使用NoMachine/VNC远程登录Linux桌面来测试。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>在'''face_recognition'''的源码中有一些示例代码，我们可以直接用来测试，face_recognition源码的下载地址如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>GitHub官方的下载地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''git clone https://github.com/ageitgey/face_recognition.git'''</p>
|}
</li>
<li><p>Gitee镜像下载地址</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''git clone [https://github.com/ageitgey/face_recognition https://gitee.com/leeboby/face_recognition.git]'''</p>
|}
</li></ol>
</li>
<li><p>face_recognition示例代码的路径如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''face_recognition/examples'''</p>
|}
</li>
<li><p>face_recognition的中文说明文档链接如下所示，使用face_recognition前请仔细阅读下</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[https://github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.md '''https://github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.md''']</p>
|}
</li>
<li><p>'''find_faces_in_picture.py'''用来在图片中定位人脸的位置，测试步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''python3 find_faces_in_picture.py'''</p>
<p>'''I found 1 face(s) in this photograph.'''</p>
<p>'''A face is located at pixel location Top: 241, Left: 419, Bottom: 562, Right: 740'''</p>
|}
</li>
<li><p>等待一段时间会弹出下面的图片，这就是在测试图片中定位到的人脸</p>
<p>[[File:zero3-img201.png]]</p></li></ol>
</li>
<li><p>'''find_facial_features_in_picture.py'''用来识别单张图片中人脸的关键点，测试步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''python3 find_facial_features_in_picture.py'''</p>
|}
</li>
<li><p>等待一段时间会弹出下面的图片，可以看到将人脸轮廓都标注出来了</p>
<p>[[File:zero3-img202.png]]</p></li></ol>
</li>
<li><p>'''identify_and_draw_boxes_on_faces.py'''用来识别人脸并使用方框标注，测试步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''python3 identify_and_draw_boxes_on_faces.py'''</p>
|}
</li>
<li><p>等待一段时间会弹出下面的图片，可以看到将图片中的人脸都使用方框标注出来了，并且正确显示了人物的名字</p>
<p>[[File:zero3-img203.png]]</p></li></ol>
</li>
<li><p>'''face_distance.py'''用来在不同精度上比较两个人脸是否属于一个人，首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令就可以看到测试的输出结果</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''python3 face_distance.py'''</p>
<p>'''The test image has a distance of 0.35 from known image #0'''</p>
<p>'''- With a normal cutoff of 0.6, would the test image match the known image? True'''</p>
<p>'''- With a very strict cutoff of 0.5, would the test image match the known image? True'''</p>


<p>'''The test image has a distance of 0.82 from known image #1'''</p>
<p>'''- With a normal cutoff of 0.6, would the test image match the known image? False'''</p>
<p>'''- With a very strict cutoff of 0.5, would the test image match the known image? False'''</p>
|}
</li>
<li><p>'''recognize_faces_in_pictures.py'''用来识别未知图片中的人脸是谁。首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令，等待一端时间后就能看到测试结果</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''python3 recognize_faces_in_pictures.py'''</p>
<p>'''Is the unknown face a picture of Biden? False'''</p>
<p>'''Is the unknown face a picture of Obama? True'''</p>
<p>'''Is the unknown face a new person that we've never seen before? False'''</p>
|}
</li>
<li><p>'''facerec_from_webcam_faster.py'''用来识别USB摄像头中的人脸，测试步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先请将USB摄像头插入开发板的USB接口中，然后通过'''v4l2-ctl'''（'''<span style="color:#FF0000">注意v4l2中的l是小写字母l，不是数字1</span>'''）命令查看下USB摄像头的设备节点的序号</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt install -y v4l-utils'''</p>
<p>orangepi@orangepi:~$ '''v4l2-ctl --list-devices'''</p>
<p>cedrus (platform:cedrus):</p>
::<p>/dev/video0</p>


<p>USB2.0 UVC PC Camera: USB2.0 UV (usb-5311000.usb-1):</p>
::<p>'''<span style="color:#FF0000">/dev/video1</span>'''</p>
::<p>/dev/video2</p>
|}
</li>
<li><p>然后在桌面中打开一个终端，进入'''face_recognition/examples'''目录后，首先修改下'''facerec_from_webcam_faster.py'''中使用的摄像头的设备序号。比如上面通过'''v4l2-ctl --list-devices'''命令查看到USB摄像头为'''/dev/video1'''，那就修改'''cv2.VideoCapture(0)'''中的'''0'''为'''<span style="color:#FF0000">1</span>'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''vim facerec_from_webcam_faster.py'''</p>
<p>'''video_capture = cv2.VideoCapture(<span style="color:#FF0000">1</span>)'''</p>
|}
</li>
<li><p>然后执行下面的命令运行'''facerec_from_webcam_faster.py'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/face_recognition/examples$ '''python3 facerec_from_webcam_faster.py'''</p>
|}
</li>
<li><p>等待一段时间会弹出摄像头的显示画面</p>
<p>[[File:zero3-img204.png]]</p></li>
<li><p>此时可以将摄像头对准自己，当摄像头检测到人脸时，会将检测到的人脸使用方框框起来。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</p></li>
<li><p>还可以打开一张奥巴马的图片，然后使用摄像头对准打开的图片，可以看到不仅能将人脸标注出来，还能正确显示检测到的人脸的名字。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</p>
<p>[[File:zero3-img205.png]]</p></li></ol>
</li>
<li><p>'''web_service_example.py'''是一个非常简单的使用Web服务上传图片运行人脸识别的案例，后端服务器会识别这张图片是不是奥巴马，并把识别结果以json键值对输出，测试步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令（'''<span style="color:#FF0000">如果是使用脚本自动安装的face_recognition，那么就不需要安装flask了</span>'''）</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 -m pip install flask'''</p>
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>root@orangepi:~/face_recognition/examples$ '''python3 web_service_example.py'''</p>
<p>* Serving Flask app 'web_service_example' (lazy loading)</p>
<p>* Environment: production</p>
<p>WARNING: This is a development server. Do not use it in a production deployment.</p>
<p>Use a production WSGI server instead.</p>
<p>* Debug mode: on</p>
<p>* Running on all addresses (0.0.0.0)</p>
<p>WARNING: This is a development server. Do not use it in a production deployment.</p>
<p>* Running on http://127.0.0.1:5001</p>
<p>* Running on http://192.168.1.79:5001 (Press CTRL+C to quit)</p>
<p>* Restarting with stat</p>
<p>* Debugger is active!</p>
<p>* Debugger PIN: 500-161-390</p>
|}
</li>
<li><p>然后另外打开一个终端，再运行下面的命令就可以返回图片识别的结果（注意，下面的命令执行路径为'''face_recognition/examples'''）</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/face_recognition/examples$ '''curl -XPOST -F \'''</p>
<p>'''&quot;file=@obama2.jpg&quot; http://127.0.0.1:5001'''</p>
<p>'''{'''</p>
:<p>'''&quot;face_found_in_image&quot;: true,'''</p>
:<p>'''&quot;is_picture_of_obama&quot;: true'''</p>
<p>'''}'''</p>
|}
</li>
<li><p>我们也可以将'''face_recognition/examples/obama2.jpg'''这张图片拷贝到其他的Linux电脑中，当然也可以自己准备一张名为'''obama2.jpg'''的图片，然后在Linux电脑中可以使用下面的命令远程通过开发板运行的服务来识别人脸（'''注意命令中的IP地址需要替换为开发板的IP地址，file后的文件名需要替换为想要测试的图片的名字'''）</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''curl -XPOST -F &quot;file=@obama2.jpg&quot; http://192.168.1.79:5001'''</p>
<p>'''{'''</p>
:<p>'''&quot;face_found_in_image&quot;: true,'''</p>
:<p>'''&quot;is_picture_of_obama&quot;: true'''</p>
<p>'''}'''</p>
|}
</li>
<li><p>使用浏览器测试的方法如下所示：</p>
<ol style="list-style-type: none;">
<li><p>a) 首先打开浏览器，然后在浏览器的地址栏输入'''开发板的IP地址:5001'''，然后就能看到下面的页面</p>
<p>[[File:zero3-img206.png]]</p></li>
<li><p>b) 然后将obama2.jpg复制到桌面</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/face_recognition/examples$ '''cp obama2.jpg /home/orangepi/Desktop/'''</p>
|}
</li>
<li><p>c) 然后在浏览器中选择刚才复制的图片</p>
<p>[[File:zero3-img207.png]]</p></li>
<li><p>d) 然后点击'''Upload'''上传刚才选择的图片进行人脸识别</p>
<p>[[File:zero3-img208.png]]</p></li>
<li><p>e) 等待一段时间后就会显示检测的结果</p>
<p>[[File:zero3-img209.png]]</p></li></ol>
</li></ol>
</li>
<li><p>'''face_detection'''命令测试示例</p>
<ol style="list-style-type: lower-alpha;">
<li><p>face_detection命令行工具可以在单张图片或一个图片文件夹中定位人脸位置（输出像素点坐标）。使用'''face_detection --help'''可以查看下face_detection命令的帮助信息</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''face_detection --help'''</p>
<p>Usage: face_detection [OPTIONS] IMAGE_TO_CHECK</p>


<p>Options:</p>
:<p>--cpus INTEGER number of CPU cores to use in parallel. -1 means &quot;use all in system&quot;</p>


:<p>--model TEXT Which face detection model to use. Options are &quot;hog&quot; or &quot;cnn&quot;.</p>


:<p>--help Show this message and exit.</p>
|}
</li>
<li><p>检测单张图片的示例如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''face_detection obama2.jpg'''</p>
<p>obama2.jpg,302,474,611,164</p>
|}
</li>
<li><p>使用多核并行检测多张图片的示例如下所示：</p>
<ol style="list-style-type: none;">
<li><p>a) 首先进入'''face_recognition/examples'''文件夹</p></li>
<li><p>b) 然后新建一个test文件夹</p></li>
<li><p>c) 然后将jpg图片都拷贝到test文件夹中</p></li>
<li><p>d) 然后使用所有的cpu并行运行'''face_detection'''来检查test文件夹中的图片，其中'''--cpus -1'''表示使用所有的cpu</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''mkdir test'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''cp *.jpg test'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''face_detection --cpus -1 test'''</p>
<p>test/obama-240p.jpg,29,261,101,189</p>
<p>test/obama_small.jpg,65,215,169,112</p>
<p>test/obama2.jpg,302,474,611,164</p>
<p>test/two_people.jpg,62,394,211,244</p>
<p>test/two_people.jpg,95,941,244,792</p>
<p>test/obama.jpg,136,624,394,366</p>
<p>test/obama-480p.jpg,65,507,189,383</p>
<p>test/obama-720p.jpg,94,751,273,572</p>
<p>test/obama-1080p.jpg,136,1140,394,882</p>
<p>test/biden.jpg,233,749,542,439</p>
|}
</li></ol>
</li></ol>
</li>
<li><p>'''face_recognition'''命令测试示例</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''face_recognition'''命令行工具可以在单张图片或者一个图片文件夹中认出是谁的脸。使用'''face_recognition --help'''可以查看下face_recognition命令的帮助信息</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''face_recognition --help'''</p>
<p>Usage: face_recognition [OPTIONS] KNOWN_PEOPLE_FOLDER IMAGE_TO_CHECK</p>
<p>Options:</p>
:<p>--cpus INTEGER &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; number of CPU cores to use in parallel (can speed up processing lots of images). -1 means &quot;use all in system&quot;</p>


:<p>--tolerance FLOAT &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Tolerance for face comparisons. Default is 0.6. Lower this if you get multiple matches for the same person.</p>


:<p>--show-distance BOOLEAN &nbsp;&nbsp; Output face distance. Useful for tweaking tolerance setting.</p>


:<p>--help &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Show this message and exit.</p>
|}
</li>
<li><p>首先新建一个已知名字的人脸图片文件夹'''known_people'''，然后复制两张图片到'''known_people'''中，然后将'''obama2.jpg'''复制为'''unkown.jpg'''，也就是我们要识别的图片</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''mkdir known_people'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''cp biden.jpg obama.jpg known_people'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''cp obama2.jpg unkown.jpg'''</p>
|}
</li>
<li><p>然后就可以使用下面的命令识别下'''unkown.jpg'''图片中人物的名字，可以看到识别到unkown.jpg图片为obama</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/face_recognition/examples$ '''face_recognition known_people \'''</p>
<p>'''unkown.jpg'''</p>
<p>unkown.jpg,obama</p>
|}
</li>
<li><p>如果我们识别一张不相关的图片，就会显示unknown_person</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>root@orangepi:~/face_recognition/examples$ '''face_recognition known_people \'''</p>
<p>'''alex-lacamoire.png'''</p>
<p>alex-lacamoire.png,unknown_person</p>
|}
</li>
<li><p>我们还可以新建一个test文件夹，然后在其中放入多张图片，然后就可以使用所有的CPU来并行识别所有的图片</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~/face_recognition/examples$ '''mkdir test'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''cp *.jpg *.png test'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''face_recognition --cpus -1 \'''</p>
<p>'''known_people test'''</p>
<p>test/obama-240p.jpg,obama</p>
<p>test/alex-lacamoire.png,unknown_person</p>
<p>test/obama_small.jpg,obama</p>
<p>test/unkown.jpg,obama</p>
<p>test/obama2.jpg,obama</p>
<p>test/lin-manuel-miranda.png,unknown_person</p>
<p>test/two_people.jpg,biden</p>
<p>test/two_people.jpg,obama</p>
<p>test/obama-720p.jpg,obama</p>
<p>test/obama.jpg,obama</p>
<p>test/obama-480p.jpg,obama</p>
<p>test/biden.jpg,biden</p>
<p>test/obama-1080p.jpg,obama</p>
|}
</li></ol>
</li></ol>

== 设置中文环境以及安装中文输入法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，安装中文输入法前请确保开发板使用的Linux系统为桌面版系统。'''</big>
|}

<span id="debian-系统的安装方法"></span>
=== Debian 系统的安装方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先设置默认'''locale'''为中文</p>
<ol style="list-style-type: lower-alpha;">
<li><p>输入下面的命令可以开始配置'''locale'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''</p>
|}
</li>
<li><p>然后在弹出的界面中选择'''zh_CN.UTF-8 &gt; UTF-8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''&lt;OK&gt;'''，然后回车即可）</p>
<p>[[File:zero3-img210.png|1400px]]</p></li>
<li><p>然后设置默认'''locale'''为'''zh_CN.UTF-8'''</p>
<p>[[File:zero3-img211.png|1400px]]</p></li>
<li><p>退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''</p>
<p>Generating locales (this might take a while)...</p>
:<p>en_US.UTF-8... done</p>
:<p>zh_CN.UTF-8... done</p>
<p>Generation complete.</p>
|}
</li></ol>
</li>
<li><p>然后打开'''Input Method'''</p>
<p>[[File:zero3-img212.png]]</p></li>
<li><p>然后选择'''OK'''</p>
<p>[[File:zero3-img213.png]]</p></li>
<li><p>然后选择'''Yes'''</p>
<p>[[File:zero3-img214.png]]</p></li>
<li><p>然后选择'''fcitx'''</p>
<p>[[File:zero3-img215.png]]</p></li>
<li><p>然后选择'''OK'''</p>
<p>[[File:zero3-img216.png]]</p></li>
<li><p>'''<span style="color:#FF0000">然后重启Linux系统才能使配置生效</span>'''</p></li>
<li><p>然后打开'''Fcitx configuration'''</p>
<p>[[File:zero3-img217.png]]</p></li>
<li><p>然后点击下图所示位置的'''+'''号</p>
<p>[[File:zero3-img218.png]]</p></li>
<li><p>然后搜索'''Google Pinyin'''再点击'''OK'''</p>
<p>[[File:zero3-img219.png]]</p></li>
<li><p>然后将'''Google Pinyin'''放到最前面</p>
<p>[[File:zero3-img220.png]]</p>
<p>[[File:zero3-img221.png]]</p></li>
<li><p>然后打开'''Geany'''这个编辑器测试下中文输入法</p>
<p>[[File:zero3-img222.png]]</p></li>
<li><p>中文输入法测试如下所示</p>
<p>[[File:zero3-img223.png]]</p></li>
<li><p>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</p></li>
<li><p>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CN.UTF-8'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo vim /etc/default/locale'''</p>
<p># File generated by update-locale</p>
<p>LC_MESSAGES='''<span style="color:#FF0000">zh_CN.UTF-8</span>'''</p>
<p>LANG='''<span style="color:#FF0000">zh_CN.UTF-8</span>'''</p>
<p>LANGUAGE='''<span style="color:#FF0000">zh_CN.UTF-8</span>'''</p>
|}
</li>
<li><p>然后'''重启系统'''就能看到系统显示为中文了</p>
<p>[[File:zero3-img224.png]]</p></li></ol>

<span id="ubuntu-20.04系统的安装方法"></span>

=== Ubuntu 20.04系统的安装方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先打开'''Language Support'''</p>
<p>[[File:zero3-img225.png]]</p></li>
<li><p>然后找到'''汉语（中国）'''选项</p>
<p>[[File:zero3-img226.png]]</p></li>
<li><p>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</p>
<p>[[File:zero3-img227.png]]</p></li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，这一步不是很好拖动的，请耐心多试几次。'''</big>
|}
</ol>
<ol start="4" style="list-style-type: decimal;">
<li><p>然后选择'''Apply System-Wide'''将中文设置应用到整个系统</p>
<p>[[File:zero3-img228.png]]</p></li>
<li><p>然后设置'''Keyboard input method system'''为'''fcitx'''</p>
<p>[[File:zero3-img229.png]]</p></li>
<li><p>'''<span style="color:#FF0000">然后重启Linux系统使配置生效</span>'''</p></li>
<li><p>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</p>
<p>[[File:zero3-img230.png]]</p></li>
<li><p>然后可以看到桌面都显示为中文了</p>
<p>[[File:zero3-img231.png]]</p></li>
<li><p>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示</p>
<p>[[File:zero3-img232.png]]</p></li>
<li><p>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了</p>
<p>[[File:zero3-img233.png]]</p></li></ol>

<span id="ubuntu-22.04系统的安装方法"></span>

=== Ubuntu 22.04系统的安装方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先打开'''Language Support'''</p>
<p>[[File:zero3-img225.png]]</p></li>
<li><p>然后找到'''汉语（中国）'''选项</p>
<p>[[File:zero3-img234.png]]</p></li>
<li><p>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</p>
<p>[[File:zero3-img235.png]]</p></li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，这一步不是很好拖动的，请耐心多试几次。'''</big>
|}
</ol>
<ol start="4" style="list-style-type: decimal;">
<li><p>然后选择'''Apply System-Wide'''将中文设置应用到整个系统</p>
<p>[[File:zero3-img236.png]]</p></li>
<li><p>'''<span style="color:#FF0000">然后重启Linux系统使配置生效</span>'''</p></li>
<li><p>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</p>
<p>[[File:zero3-img230.png]]</p></li>
<li><p>然后可以看到桌面都显示为中文了</p>
<p>[[File:zero3-img231.png]]</p></li>
<li><p>然后打开Fcitx5配置程序</p>
<p>[[File:zero3-img237.png]]</p></li>
<li><p>然后选择使用拼音输入法</p>
<p>[[File:zero3-img238.png]]</p></li>
<li><p>选择后的界面如下所示，再点击确定即可</p>
<p>[[File:zero3-img239.png]]</p></li>
<li><p>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示</p>
<p>[[File:zero3-img232.png]]</p></li>
<li><p>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了</p>
<p>[[File:zero3-img240.png]]</p></li></ol>

<span id="远程登录linux系统桌面的方法"></span>

== 远程登录Linux系统桌面的方法 ==

<span id="使用nomachine远程登录"></span>
=== 使用NoMachine远程登录 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''请确保开发板安装的Ubuntu或者Debian系统为桌面版本的系统。另外NoMachine也提供了详细的使用文档，强烈建议通读此文档来熟悉NoMachine的使用，文档链接如下所示：'''

'''https://knowledgebase.nomachine.com/DT10R00166'''</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''NoMachine支持Windows、Mac、Linux、iOS和安卓平台，所以我们可以在多种设备上通过NoMachine来远程登录控制Orange Pi开发板。下面演示下在Windows中通过NoMachine来远程登录Orange Pi开发板的Linux系统桌面。其他平台的安装方法请参考下NoMachine的官方文档。'''</big>
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先下载NoMachine软件Linux '''<span style="color:#FF0000">arm64</span>''' deb版本的安装包，然后安装到开发板的Linux系统中</p>
<ol style="list-style-type: lower-alpha;">
<li>由于H618是ARMv8架构的SOC，我们使用的系统为Ubuntu或者Debian，所以这里需要下载'''NoMachine &gt; for ARM ARMv8 DEB'''安装包，下载链接如下所示：

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，这个下载链接可能会变，请认准Armv8/Arm64版本的deb包。'''</big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
[https://www.nomachine.com/download/download&id=112&s=ARM '''https://downloads.nomachine.com/download/?id=118&amp;distro=ARM''']
|}

[[File:zero3-img241.png]]
</li></ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>另外在'''官方工具'''中也可以下载到'''NoMachine'''的安装包</p>
<p>[[File:zero3-img242.png]]</p>
<p>先进入'''远程登录软件-NoMachine'''文件夹</p>
<p>[[File:zero3-img243.png]]</p>
<p>然后下载arm64版本的deb安装包</p>
<p>[[File:zero3-img244.png]]</p></li>
<li><p>然后将下载的'''nomachine_x.x.x_x_arm64.deb'''上传到开发板的Linux系统中</p></li>
<li><p>然后使用下面的命令在开发板的Linux系统中安装'''NoMachine'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo dpkg -i nomachine_x.x.x_x_arm64_arm64.deb'''</p>
|}
</li></ol>
</li></ol>
<!-- -->
<ol start="2" style="list-style-type: decimal;">
<li>然后下载NoMachine软件Windows版本的安装包，下载地址如下所示</li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，这个下载链接可能会变。'''</big>
|}

{| class="wikitable" style="width:800px;" 
|-
| 
'''https://downloads.nomachine.com/download/?id=9'''
|}

[[File:zero3-img245.png]]
</ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后在Windows中安装NoMachine，'''安装完后请重启下电脑'''</p></li>
<li><p>然后在Window中打开'''NoMachine'''</p>
<p>[[File:zero3-img246.png]]</p></li>
<li><p>NoMachine启动后会自动扫描局域网内其他安装有NoMachine的设备，进入NoMachine的主界面后就可以看到开发板已经在可连接的设备列表里了，然后点击下图红色方框所示的位置即可开始登录开发板的Linux系统桌面</p>
<p>[[File:zero3-img247.png]]</p></li>
<li><p>然后点击'''OK'''</p>
<p>[[File:zero3-img248.png]]</p></li>
<li><p>然后在下图对应的位置输入开发板Linux系统的用户名和密码，再点击'''OK'''开始登陆</p>
<p>[[File:zero3-img249.png]]</p></li>
<li><p>然后在接下来的界面中都点击OK</p></li>
<li><p>最后就能看到开发板Linux系统的桌面了</p>
<p>[[File:zero3-img250.png]]</p></li></ol>

<span id="使用vnc远程登录"></span>

=== 使用VNC远程登录 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''

'''<span style="color:#FF0000">Ubuntu20.04测试VNC很多问题，请不要使用这种方法。</span>'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>首先运行'''set_vnc.sh'''脚本设置下vnc，'''记得加sudo权限'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo set_vnc.sh'''</p>
<p>You will require a password to access your desktops.</p>


<p>Password: '''<span style="color:#FF0000">#在这里设置vnc的密码，8位字符</span>'''</p>
<p>Verify: '''<span style="color:#FF0000">#在这里设置vnc的密码，8位字符</span>'''</p>
<p>Would you like to enter a view-only password (y/n)? '''<span style="color:#FF0000">n</span>'''</p>
<p>xauth: file /root/.Xauthority does not exist</p>


<p>New 'X' desktop is orangepi:1</p>


<p>Creating default startup script /root/.vnc/xstartup</p>
<p>Starting applications specified in /root/.vnc/xstartup</p>
<p>Log file is /root/.vnc/orangepi:1.log</p>


<p>Killing Xtightvnc process ID 3047</p>


<p>New 'X' desktop is orangepi:1</p>


<p>Starting applications specified in /root/.vnc/xstartup</p>
<p>Log file is /root/.vnc/orangepi:1.log</p>
|}
</li>
<li><p>使用MobaXterm软件连接开发板linux系统桌面的步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li>首先点击Session，然后选择VNC，再填写开发板的IP地址和端口，最后点击OK确认</li>

[[File:zero3-img251.png]]
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>然后输入前面设置的VNC的密码</p>
<p>[[File:zero3-img252.png]]</p></li>
<li><p>登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了</p></li>

[[File:zero3-img253.png]]
</ol>
</li></ol>
<span id="qt的安装方法"></span>

== QT的安装方法 ==

<ol style="list-style-type: decimal;">
<li><p>使用下面的脚本可以安装QT5和QT Creator</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_qt.sh'''</p>
|}
</li>
<li><p>安装完后会自动打印QT的版本号</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Ubuntu20.04自带的qt版本为'''5.12.8'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_qt.sh'''</p>
<p>......</p>
<p>QMake version 3.1</p>
<p>Using Qt version '''<span style="color:#FF0000">5.12.8</span>''' in /usr/lib/aarch64-linux-gnu</p>
|}
</li>
<li><p>Ubuntu22.04自带的QT版本为'''5.15.3'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_qt.sh'''</p>
<p>......</p>
<p>QMake version 3.1</p>
<p>Using Qt version '''<span style="color:#FF0000">5.15.3</span>''' in /usr/lib/aarch64-linux-gnu</p>
|}
</li>
<li><p>Debian11自带的QT版本为'''5.15.2'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_qt.sh'''</p>
<p>......</p>
<p>QMake version 3.1</p>
<p>Using Qt version '''<span style="color:#FF0000">5.15.2</span>''' in /usr/lib/aarch64-linux-gnu</p>
|}
</li>
<li><p>Debian12自带的QT版本为'''5.15.8'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_qt.sh'''</p>
<p>......</p>
<p>QMake version 3.1</p>
<p>Using Qt version '''<span style="color:#FF0000">5.15.8</span>''' in /usr/lib/aarch64-linux-gnu</p>
|}
</li></ol>
</li>
<li><p>然后在'''Applications'''中就可以看到QT Creator的启动图标</p>
<p>[[File:zero3-img254.png]]</p>
<p>也可以使用下面的命令打开QT Creator</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''qtcreator'''</p>
|}
</li>
<li><p>QT Creator打开后的界面如下所示</p>
<p>[[File:zero3-img255.png]]</p></li>
<li><p>QT Creator的版本如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>QT Creator在'''Ubuntu20.04'''中的默认版本如下所示</p>
<p>[[File:zero3-img256.png]]</p></li>
<li><p>QT Creator在'''Ubuntu22.04'''中的默认版本如下所示</p>
<p>[[File:zero3-img257.png]]</p></li>
<li><p>QT Creator在'''Debian11'''中的默认版本如下所示</p>
<p>[[File:zero3-img258.png]]</p></li>
<li><p>QT Creator在'''Debian12'''中的默认版本如下所示</p>
<p>[[File:zero3-img259.png]]</p></li></ol>
</li>
<li><p>然后设置下QT</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先打开'''Help'''-&gt;'''About Plugins...'''</p>
<p>[[File:zero3-img260.png]]</p></li>
<li><p>然后去掉'''ClangCodeModel'''的那个勾</p>
<p>[[File:zero3-img261.png]]</p></li>
<li><p>'''<span style="color:#FF0000">设置完后需要重启下QT Creator</span>'''</p></li>
<li><p>然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''Debian12请跳过这步。'''</p></big>
|}
<p>[[File:zero3-img262.png]]</p>
<p>[[File:zero3-img263.png]]</p></li></ol>
</li>
<li><p>然后就可以打开一个示例代码</p>
<p>[[File:zero3-img264.png]]</p></li>
<li><p>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明</p>
<p>[[File:zero3-img265.png]]</p></li>
<li><p>然后点击下'''Configure Project'''</p>
<p>[[File:zero3-img266.png]]</p></li>
<li><p>然后点击左下角的绿色三角形编译运行下示例代码</p>
<p>[[File:zero3-img267.png]]</p></li>
<li><p>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行</p>
<p>[[File:zero3-img268.png]]</p></li>
<li><p>参考资料</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[https://wiki.qt.io/Install_Qt_5_on_Ubuntu '''https://wiki.qt.io/Install_Qt_5_on_Ubuntu''']</p>
<p>[https://download.qt.io/archive/qtcreator '''https://download.qt.io/archive/qtcreator''']</p>
<p>[https://download.qt.io/archive/qt '''https://download.qt.io/archive/qt''']</p>
|}
</li></ol>

<span id="ros安装方法"></span>

== ROS安装方法 ==

<span id="ubuntu20.04安装ros-1-noetic的方法"></span>
=== Ubuntu20.04安装ROS 1 Noetic的方法 ===

# ROS 1当前活跃的版本如下所示，推荐版本为'''Noetic Ninjemys'''

::[[File:zero3-img269.png]]

::[[File:zero3-img270.png]]

::{| class="wikitable" style="width:800px;" 
|-
| 
[http://docs.ros.org/ '''http://docs.ros.org''']

'''https://wiki.ros.org/Distributions'''
|}

<ol start="2" style="list-style-type: decimal;">
<li><p>ROS 1 '''Noetic Ninjemys'''官方安装文档链接如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[http://wiki.ros.org/noetic/Installation/Ubuntu '''http://wiki.ros.org/noetic/Installation/Ubuntu''']</p>
|}
</li>
<li><p>ROS '''Noetic Ninjemys'''官方安装文档中Ubuntu推荐使用Ubuntu20.04，所以请确保开发板使用的系统为'''<span style="color:#FF0000">Ubuntu20.04桌面版系统</span>'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[http://wiki.ros.org/noetic/Installation '''http://wiki.ros.org/noetic/Installation''']</p>
|}
<p>[[File:zero3-img271.png]]</p></li>
<li><p>然后使用下面的脚本安装ros1</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_ros.sh ros1'''</p>
|}
</li>
<li><p>使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件</p></li>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''<span style="color:#FF0000">注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。</span>'''


'''install_ros.sh脚本会尝试修改/etc/hosts并自动运行下面的命令。但是这种方法无法保证每次都能正常访问github，如果install_ros.sh安装完ros1后有提示下面的错误，请自己想其它办法让开发板的linux系统能正常访问github，然后再手动运行下面的命令。'''


'''https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml'''

'''Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml'''

'''<span style="color:#FF0000">ERROR: error loading sources list:</span>'''

::'''<span style="color:#FF0000">The read operation timed out</span>'''</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 &quot;ardent&quot;

Skip end-of-life distro &quot;bouncy&quot;

Skip end-of-life distro &quot;crystal&quot;

Skip end-of-life distro &quot;dashing&quot;

Skip end-of-life distro &quot;eloquent&quot;

Add distro &quot;foxy&quot;

Add distro &quot;galactic&quot;

Skip end-of-life distro &quot;groovy&quot;

Add distro &quot;humble&quot;

Skip end-of-life distro &quot;hydro&quot;

Skip end-of-life distro &quot;indigo&quot;

Skip end-of-life distro &quot;jade&quot;

Skip end-of-life distro &quot;kinetic&quot;

Skip end-of-life distro &quot;lunar&quot;

Add distro &quot;melodic&quot;

Add distro &quot;noetic&quot;

Add distro &quot;rolling&quot;

updated cache in /home/orangepi/.ros/rosdep/sources.cache
|}
</ol>
<ol start="6" style="list-style-type: decimal;">
<li><p>然后在'''桌面'''中打开一个命令行终端窗口，再使用'''test_ros.sh'''脚本可以启动一个小海龟的例程来测试下ROS是否能正常使用</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''test_ros.sh'''</p>
|}
</li>
<li><p>运行完'''test_ros.sh'''脚本后，会弹出下图所示的一个小海龟</p>
<p>[[File:zero3-img272.png]]</p></li>
<li><p>然后请保持刚才打开终端窗口在最上面</p></li>

[[File:zero3-img273.png]]
</ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>此时按下键盘上的方向按键就可以控制小海龟上下左右移动了</p>
<p>[[File:zero3-img274.png]]</p></li></ol>

<span id="ubuntu20.04安装ros-2-galactic的方法"></span>

=== Ubuntu20.04安装ROS 2 Galactic的方法 ===

<ol style="list-style-type: decimal;">
<li><p>ROS 2当前活跃的版本如下所示，推荐版本为'''Galactic Geochelone'''</p>
<p>[[File:zero3-img275.png]]</p>
<p>[[File:zero3-img276.png]]</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[http://docs.ros.org/ '''http://docs.ros.org''']</p>
<p>'''http://docs.ros.org/en/galactic/Releases.html'''</p>
|}
</li>
<li><p>ROS 2 '''Galactic Geochelone'''官方安装文档链接如下所示：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''docs.ros.org/en/galactic/Installation.html'''</p>
<p>'''http://docs.ros.org/en/galactic/Installation/Ubuntu-Install-Debians.html'''</p>
|}
</li>
<li><p>ROS 2 '''Galactic Geochelone'''官方安装文档中Ubuntu Linux推荐使用Ubuntu20.04，所以请确保开发板使用的系统为'''<span style="color:#FF0000">Ubuntu20.04桌面版系统</span>'''。安装ROS 2有几种方法，下面演示下通过'''Debian packages'''的方式来安装ROS 2 '''Galactic Geochelone'''</p></li>
<li><p>使用'''install_ros.sh'''脚本可以安装ros2</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_ros.sh ros2'''</p>
|}
</li>
<li><p>'''install_ros.sh'''脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>usage: ros2 [-h] Call `ros2 &lt;command&gt; -h` for more detailed usage. ...</p>


<p>ros2 is an extensible command-line tool for ROS 2.</p>


<p>optional arguments:</p>
:<p>-h, --help show this help message and exit</p>


<p>Commands:</p>
:<p>action Various action related sub-commands</p>
:<p>bag Various rosbag related sub-commands</p>
:<p>component Various component related sub-commands</p>
:<p>daemon Various daemon related sub-commands</p>
:<p>doctor Check ROS setup and other potential issues</p>
:<p>interface Show information about ROS interfaces</p>
:<p>launch Run a launch file</p>
:<p>lifecycle Various lifecycle related sub-commands</p>
:<p>multicast Various multicast related sub-commands</p>
:<p>node Various node related sub-commands</p>
:<p>param Various param related sub-commands</p>
:<p>pkg Various package related sub-commands</p>
:<p>run Run a package specific executable</p>
:<p>security Various security related sub-commands</p>
:<p>service Various service related sub-commands</p>
:<p>topic Various topic related sub-commands</p>
:<p>wtf Use `wtf` as alias to `doctor`</p>


:<p>Call `ros2 &lt;command&gt; -h` for more detailed usage.</p>
|}
</li>
<li><p>然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''test_ros.sh'''</p>
<p>[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'</p>
<p>[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1]</p>
<p>[INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'</p>
<p>[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2]</p>
<p>[INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'</p>
<p>[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</p>
|}
</li>
<li><p>运行下面的命令可以打开rviz2</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''source /opt/ros/galactic/setup.bash'''</p>
<p>orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''</p>
|}
<p>[[File:zero3-img277.png]]</p></li>
<li><p>ROS的使用方法请参考下ROS 2的文档</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.org/en/galactic/Tutorials.html''']</p>
|}
</li></ol>

<span id="ubuntu22.04安装ros-2-humble的方法"></span>

=== Ubuntu22.04安装ROS 2 Humble的方法 ===

<ol style="list-style-type: decimal;">
<li><p>使用'''install_ros.sh'''脚本可以安装ros2</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''install_ros.sh ros2'''</p>
|}
</li>
<li><p>'''install_ros.sh'''脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>usage: ros2 [-h] Call `ros2 &lt;command&gt; -h` for more detailed usage. ...</p>


<p>ros2 is an extensible command-line tool for ROS 2.</p>


<p>optional arguments:</p>
:<p>-h, --help show this help message and exit</p>


<p>Commands:</p>
:<p>action Various action related sub-commands</p>
:<p>bag Various rosbag related sub-commands</p>
:<p>component Various component related sub-commands</p>
:<p>daemon Various daemon related sub-commands</p>
:<p>doctor Check ROS setup and other potential issues</p>
:<p>interface Show information about ROS interfaces</p>
:<p>launch Run a launch file</p>
:<p>lifecycle Various lifecycle related sub-commands</p>
:<p>multicast Various multicast related sub-commands</p>
:<p>node Various node related sub-commands</p>
:<p>param Various param related sub-commands</p>
:<p>pkg Various package related sub-commands</p>
:<p>run Run a package specific executable</p>
:<p>security Various security related sub-commands</p>
:<p>service Various service related sub-commands</p>
:<p>topic Various topic related sub-commands</p>
:<p>wtf Use `wtf` as alias to `doctor`</p>


:<p>Call `ros2 &lt;command&gt; -h` for more detailed usage.</p>
|}
</li>
<li><p>然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''test_ros.sh'''</p>
<p>[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'</p>
<p>[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1]</p>
<p>[INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'</p>
<p>[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2]</p>
<p>[INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'</p>
<p>[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</p>
|}
</li>
<li><p>运行下面的命令可以打开rviz2</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''source /opt/ros/humble/setup.bash'''</p>
<p>orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''</p>
|}
<p>[[File:zero3-img278.png]]</p></li>
<li><p>参考文档</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''http://docs.ros.org/en/humble/index.html'''</p>
<p>[http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html''']</p>
|}
</li></ol>

== 安装内核头文件的方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''<span style="color:#FF0000">Linux6.1</span>内核的Debian11系统编译内核模块时会报GCC的错误。所以如果要编译内核模块请使用Debian12或者Ubuntu22.04。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>OPi发布的Linux镜像默认自带了内核头文件的deb包，存放的位置为'''/opt/'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /opt/linux-headers*'''</p>
<p>/opt/linux-headers-xxx-sun50iw9_x.x.x_arm64.deb</p>
|}
</li>
<li><p>使用下面的命令可以安装内核头文件的deb包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo dpkg -i /opt/linux-headers*.deb'''</p>
|}
</li>
<li><p>安装完后在'''/usr/src'''下就能看到内核头文件所在的文件夹</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''ls /usr/src'''</p>
<p>linux-headers-x.x.x</p>
|}
</li>
<li><p>然后可以编译下Linux镜像中自带的hello内核模块的源码，hello模块的源码在'''/usr/src/hello'''中，进入此目录后，然后使用make命令编译即可。</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''cd /usr/src/hello/'''</p>
<p>orangepi@orangepi:/usr/src/hello$ '''sudo make'''</p>
<p>make -C /lib/modules/5.4.125/build M=/usr/src/hello modules</p>
<p>make[1]: Entering directory '/usr/src/linux-headers-5.4.125'</p>
:<p>CC [M] /usr/src/hello/hello.o</p>
:<p>Building modules, stage 2.</p>
:<p>MODPOST 1 modules</p>
:<p>CC [M] /usr/src/hello/hello.mod.o</p>
:<p>LD [M] /usr/src/hello/hello.ko</p>
<p>make[1]: Leaving directory '/usr/src/linux-headers-5.4.125'</p>
|}
</li>
<li><p>编译完后会生成'''hello.ko'''内核模块</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:/usr/src/hello$ '''ls *.ko'''</p>
<p>hello.ko</p>
|}
</li>
<li><p>使用'''insmod'''命令可以将'''hello.ko'''内核模块插入内核中</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:/usr/src/hello$ '''sudo insmod hello.ko'''</p>
|}
</li>
<li><p>然后使用'''demsg'''命令可以查看下'''hello.ko'''内核模块的输出，如果能看到下面的输出说明'''hello.ko'''内核模块加载正确</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:/usr/src/hello$ '''dmesg | grep &quot;Hello&quot;'''</p>
<p>[ 2871.893988] '''Hello Orange Pi -- init'''</p>
|}
</li>
<li><p>使用'''rmmod'''命令可以卸载'''hello.ko'''内核模块</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:/usr/src/hello$ '''sudo rmmod hello'''</p>
<p>orangepi@orangepi:/usr/src/hello$ '''dmesg | grep &quot;Hello&quot;'''</p>
<p>[ 2871.893988] Hello Orange Pi -- init</p>
<p>[ 3173.800892] '''Hello Orange Pi -- exit'''</p>
|}
</li></ol>

<span id="linux系统支持的部分编程语言测试"></span>

== Linux系统支持的部分编程语言测试 ==

<span id="debian-bullseye系统"></span>
=== Debian Bullseye系统 ===

<ol style="list-style-type: decimal;">
<li><p>Debian Bullseye默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p>
<ol style="list-style-type: lower-alpha;">
<li><p>gcc的版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc --version'''</p>
<p>gcc (Debian 10.2.1-6) 10.2.1 20210110</p>
<p>Copyright (C) 2020 Free Software Foundation, Inc.</p>
<p>This is free software; see the source for copying conditions. There is NO</p>
<p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
|}
</li>
<li><p>编写C语言的'''hello_world.c'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.c'''</p>
<p>#include &lt;stdio.h&gt;</p>


<p>int main(void)</p>
<p>{</p>
:<p>printf(&quot;Hello World!\n&quot;);</p>


:<p>return 0;</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.c'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''</p>
<p>orangepi@orangepi:~$ '''./hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Debian Bullseye默认安装有Python3</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Python具体版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3'''</p>
<p>'''Python 3.9.2''' (default, Feb 28 2021, 17:03:44)</p>
<p>[GCC 10.2.1 20210110] on linux</p>
<p>Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.</p>
<p>&gt;&gt;&gt;</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''使用Ctrl+D快捷键可退出python的交互模式。'''</p></big>
|}
</li>
<li><p>编写Python语言的'''hello_world.py'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.py'''</p>
<p>print('Hello World!')</p>
|}
</li>
<li><p>运行'''hello_world.py'''的结果如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 hello_world.py'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Debian Bullseye默认没有安装Java的编译工具和运行环境</p>
<ol style="list-style-type: lower-alpha;">
<li><p>可以使用下面的命令安装openjdk，Debian Bullseye中最新版本为openjdk-17</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdk'''</p>
|}
</li>
<li><p>安装完后可以查看下Java的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''java --version'''</p>
|}
</li>
<li><p>编写Java版本的'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.java'''</p>
<p>public class hello_world</p>
<p>{</p>
:<p>public static void main(String[] args)</p>
:<p>{</p>
::<p>System.out.println(&quot;Hello World!&quot;);</p>
:<p>}</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''javac hello_world.java'''</p>
<p>orangepi@orangepi:~$ '''java hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li></ol>

<span id="debian-bookworm系统"></span>

=== Debian Bookworm系统 ===

<ol style="list-style-type: decimal;">
<li><p>Debian Bookworm默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p>
<ol style="list-style-type: lower-alpha;">
<li><p>gcc的版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc --version'''</p>
<p>gcc (Debian 12.2.0-14) 12.2.0</p>
<p>Copyright (C) 2022 Free Software Foundation, Inc.</p>
<p>This is free software; see the source for copying conditions. There is NO</p>
<p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
|}
</li>
<li><p>编写C语言的'''hello_world.c'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.c'''</p>
<p>#include &lt;stdio.h&gt;</p>


<p>int main(void)</p>
<p>{</p>
:<p>printf(&quot;Hello World!\n&quot;);</p>


:<p>return 0;</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.c'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''</p>
<p>orangepi@orangepi:~$ '''./hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Debian Bookworm默认安装有Python3</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Python具体版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3'''</p>
<p>Python 3.11.2 (main, Mar 13 2023, 12:18:29) [GCC 12.2.0] on linux</p>
<p>Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.</p>
<p>&gt;&gt;&gt;</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''使用Ctrl+D快捷键可退出python的交互模式。'''</p></big>
|}
</li>
<li><p>编写Python语言的'''hello_world.py'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.py'''</p>
<p>print('Hello World!')</p>
|}
</li>
<li><p>运行'''hello_world.py'''的结果如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 hello_world.py'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Debian Bookworm默认没有安装Java的编译工具和运行环境</p>
<ol style="list-style-type: lower-alpha;">
<li><p>可以使用下面的命令安装openjdk，Debian Bookworm中最新版本为openjdk-17</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdk'''</p>
|}
</li>
<li><p>安装完后可以查看下Java的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''java --version'''</p>
|}
</li>
<li><p>编写Java版本的'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.java'''</p>
<p>public class hello_world</p>
<p>{</p>
:<p>public static void main(String[] args)</p>
:<p>{</p>
::<p>System.out.println(&quot;Hello World!&quot;);</p>
:<p>}</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''javac hello_world.java'''</p>
<p>orangepi@orangepi:~$ '''java hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li></ol>

<span id="ubuntu-focal系统"></span>

=== Ubuntu Focal系统 ===

<ol style="list-style-type: decimal;">
<li><p>Ubuntu Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p>
<ol style="list-style-type: lower-alpha;">
<li><p>gcc的版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc --version'''</p>
<p>gcc (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.0</p>
<p>Copyright (C) 2019 Free Software Foundation, Inc.</p>
<p>This is free software; see the source for copying conditions. There is NO</p>
<p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
|}
</li>
<li><p>编写C语言的'''hello_world.c'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.c'''</p>
<p>#include &lt;stdio.h&gt;</p>


<p>int main(void)</p>
<p>{</p>
:<p>printf(&quot;Hello World!\n&quot;);</p>


:<p>return 0;</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.c'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''</p>
<p>orangepi@orangepi:~$ '''./hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Ubuntu Focal默认安装有Python3</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Python3具体版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3'''</p>
<p>Python 3.8.10 (default, Nov 14 2022, 12:59:47)</p>
<p>[GCC 9.4.0] on linux</p>
<p>Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.</p>
<p>&gt;&gt;&gt;</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''使用Ctrl+D快捷键可退出python的交互模式。'''</p></big>
|}
</li>
<li><p>编写Python语言的'''hello_world.py'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.py'''</p>
<p>print('Hello World!')</p>
|}
</li>
<li><p>运行'''hello_world.py'''的结果如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 hello_world.py'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Ubuntu Focal默认没有安装Java的编译工具和运行环境</p>
<ol style="list-style-type: lower-alpha;">
<li><p>可以使用下面的命令安装openjdk-17</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdk'''</p>
|}
</li>
<li><p>安装完后可以查看下Java的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''java --version'''</p>
<p>openjdk 17.0.2 2022-01-18</p>
<p>OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.04)</p>
<p>OpenJDK 64-Bit Server VM (build 17.0.2+8-Ubuntu-120.04, mixed mode, sharing)</p>
|}
</li>
<li><p>编写Java版本的'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.java'''</p>
<p>public class hello_world</p>
<p>{</p>
:<p>public static void main(String[] args)</p>
:<p>{</p>
::<p>System.out.println(&quot;Hello World!&quot;);</p>
:<p>}</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''javac hello_world.java'''</p>
<p>orangepi@orangepi:~$ '''java hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li></ol>

<span id="ubuntu-jammy系统"></span>

=== Ubuntu Jammy系统 ===

<ol style="list-style-type: decimal;">
<li><p>Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p>
<ol style="list-style-type: lower-alpha;">
<li><p>gcc的版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc --version'''</p>
<p>gcc (Ubuntu 11.3.0-1ubuntu1~22.04.1) '''11.3.0'''</p>
<p>Copyright (C) 2021 Free Software Foundation, Inc.</p>
<p>This is free software; see the source for copying conditions. There is NO</p>
<p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
|}
</li>
<li><p>编写C语言的'''hello_world.c'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.c'''</p>
<p>#include &lt;stdio.h&gt;</p>


<p>int main(void)</p>
<p>{</p>
:<p>printf(&quot;Hello World!\n&quot;);</p>


:<p>return 0;</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.c'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''</p>
<p>orangepi@orangepi:~$ '''./hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Ubuntu Jammy默认安装有Python3</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Python3具体版本如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3'''</p>
<p>Python 3.10.6 (main, May 29 2023, 11:10:38) [GCC 11.3.0] on linux</p>
<p>Type &quot;help&quot;, &quot;copyright&quot;, &quot;credits&quot; or &quot;license&quot; for more information.</p>
<p>&gt;&gt;&gt;</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''使用Ctrl+D快捷键可退出python的交互模式。'''</p></big>
|}
</li>
<li><p>编写Python语言的'''hello_world.py'''程序</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.py'''</p>
<p>print('Hello World!')</p>
|}
</li>
<li><p>运行'''hello_world.py'''的结果如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''python3 hello_world.py'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li>
<li><p>Ubuntu Jammy默认没有安装Java的编译工具和运行环境</p>
<ol style="list-style-type: lower-alpha;">
<li><p>可以使用下面的命令安装openjdk-18</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo apt install -y openjdk-18-jdk'''</p>
|}
</li>
<li><p>安装完后可以查看下Java的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''java --version'''</p>
<p>openjdk 18.0.2-ea 2022-07-19</p>
<p>OpenJDK Runtime Environment (build 18.0.2-ea+9-Ubuntu-222.04)</p>
<p>OpenJDK 64-Bit Server VM (build 18.0.2-ea+9-Ubuntu-222.04, mixed mode, sharing)</p>
|}
</li>
<li><p>编写Java版本的'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''vim hello_world.java'''</p>
<p>public class hello_world</p>
<p>{</p>
:<p>public static void main(String[] args)</p>
:<p>{</p>
::<p>System.out.println(&quot;Hello World!&quot;);</p>
:<p>}</p>
<p>}</p>
|}
</li>
<li><p>然后编译运行'''hello_world.java'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''javac hello_world.java'''</p>
<p>orangepi@orangepi:~$ '''java hello_world'''</p>
<p>Hello World!</p>
|}
</li></ol>
</li></ol>

<span id="上传文件到开发板linux系统中的方法"></span>

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

<span id="在ubuntu-pc中上传文件到开发板linux系统中的方法"></span>
=== 在Ubuntu PC中上传文件到开发板Linux系统中的方法 ===

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

<ol style="list-style-type: decimal;">
<li><p>使用scp命令可以在Ubuntu PC中上传文件到开发板的Linux系统中，具体命令如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''file_path：'''需要替换为要上传文件的路径</p></li>
<li><p>'''orangepi：'''为开发板linux系统的用户名，也可以替换成其它的，比如root</p></li>
<li><p>'''192.168.xx.xx:''' 为开发板的IP地址，请根据实际情况进行修改</p></li>
<li><p>'''/home/orangepi:''' 开发板linux系统中的路径，也可以修改为其它的路径</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''scp file_path orangepi@192.168.xx.xx:/home/orangepi/'''</p>
|}
</li></ol>
</li>
<li><p>如果要上传文件夹，需要加上-r参数</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''scp <span style="color:#FF0000">-r</span> dir_path orangepi@192.168.xx.xx:/home/orangepi/'''</p>
|}
</li>
<li><p>scp还有更多的用法，请使用下面的命令查看man手册</p>
{| class="wikitable" style="width:800px;" 
|-
| 
test@test:~$ '''man scp'''
|}
</li></ol>

==== 使用filezilla上传文件的方法 ====

<ol style="list-style-type: decimal;">
<li><p>首先在Ubuntu PC中安装filezilla</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt install -y filezilla'''</p>
|}
</li>
<li><p>然后使用下面的命令打开filezilla</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''filezilla'''</p>
|}
</li>
<li><p>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的</p>
<div class="figure">

[[File:zero3-img279.png]]

</div></li>
<li><p>连接开发板的方法如下图所示</p>

<div class="figure">

[[File:zero3-img280.png]]

</div>
</li></ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>然后选择'''保存密码'''，再点击'''确定'''</p>
<p>[[File:zero3-img281.png]]</p></li>
<li><p>然后选择'''总是信任该主机'''，再点击'''确定'''</p>

<div class="figure">

[[File:zero3-img282.png]]

</div></li></ol>
<ol start="7" style="list-style-type: decimal;">
<li>连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了</li>

<div class="figure">

[[File:zero3-img283.png]]

</div></ol>
<ol start="8" style="list-style-type: decimal;">
<li>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Ubuntu PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了。</li>

<div class="figure">

[[File:zero3-img284.png]]

</div></ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</p></li>
<li><p>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</p></li></ol>

<span id="在windows-pc中上传文件到开发板linux系统中的方法"></span>

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

<span id="使用filezilla上传文件的方法-1"></span>
==== 使用filezilla上传文件的方法 ====

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

::{| class="wikitable" style="width:800px;" 
|-
| 
[https://filezilla-project.org/download.php?type=client '''https://filezilla-project.org/download.php?type=client''']
|}
::[[File:zero3-img285.png]]

::[[File:zero3-img286.png]]

<ol start="2" style="list-style-type: decimal;">
<li><p>下载的安装包如下所示，然后双击直接安装即可</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''FileZilla_Server_1.5.1_win64-setup.exe'''</p>
|}

安装过程中，下面的安装界面请选择'''Decline'''，然后再选择'''Next&gt;'''

<div class="figure">

[[File:zero3-img287.png]]

</div></li></ol>
<ol start="3" style="list-style-type: decimal;">
<li>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的

<div class="figure">

[[File:zero3-img288.png]]

</div></li></ol>
<ol start="4" style="list-style-type: decimal;">
<li>连接开发板的方法如下图所示：

<div class="figure">

[[File:zero3-img289.png]]

</div></li></ol>
<ol start="5" style="list-style-type: decimal;">
<li>然后选择'''保存密码'''，再点击'''确定'''

<div class="figure">

[[File:zero3-img290.png]]

</div></li></ol>
<ol start="6" style="list-style-type: decimal;">
<li>然后选择'''总是信任该主机'''，再点击'''确定'''

<div class="figure">

[[File:zero3-img291.png]]

</div></li></ol>
<ol start="7" style="list-style-type: decimal;">
<li>连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了

<div class="figure">

[[File:zero3-img292.png]]

</div></li></ol>
<ol start="8" style="list-style-type: decimal;">
<li>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Windows PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了

<div class="figure">

[[File:zero3-img293.png]]

</div></li></ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</p></li>
<li><p>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</p></li></ol>

== 开关机logo使用说明 ==

<ol style="list-style-type: decimal;">
<li><p>开关机logo默认只在桌面版的系统中才会显示</p></li>
<li><p>在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''false'''可以关闭开关机logo</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''</p>
<p>verbosity=1</p>
<p>'''<span style="color:#FF0000">bootlogo=false</span>'''</p>
|}
</li>
<li><p>在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''true'''可以开启开关机logo</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''</p>
<p>verbosity=1</p>
<p>'''<span style="color:#FF0000">bootlogo=true</span>'''</p>
|}
</li>
<li><p>开机logo图片在linux系统中的位置为</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''/usr/share/plymouth/themes/orangepi/watermark.png'''</p>
|}
</li>
<li><p>替换开机logo图片后需要运行下命令才能生效</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo update-initramfs -u'''</p>
|}
</li></ol>

== 关机和重启开发板的方法 ==

<ol style="list-style-type: decimal;">
<li><p>在Linux系统运行的过程中，如果直接拔掉电源断电，可能会导致文件系统丢失某些数据，建议断电前先使用'''poweroff'''命令关闭开发板的Linux系统，然后再拔掉电源</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo poweroff'''</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''注意，关闭开发板后需要重新拔插电源才能开机。'''</p></big>
|}
</li>
<li><p>使用'''reboot'''命令即可重启开发板中的Linux系统</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo''' '''reboot'''</p>
|}
</li></ol>

<span id="linux-sdkorangepi-build使用说明"></span>

= '''Linux SDK——orangepi-build使用说明''' =

== 编译系统需求 ==

Linux SDK，即'''orangepi-build'''，只支持在安装有'''<span style="color:#FF0000">Ubuntu 22.04</span>'''的X64电脑上运行，所以下载orangepi-build前，请首先确保自己电脑已安装的Ubuntu版本是Ubuntu 22.04。查看电脑已安装的Ubuntu版本的命令如下所示，如果Release字段显示的不是'''<span style="color:#FF0000">22.04</span>'''，说明当前使用的Ubuntu版本不符合要求，请更换系统后再进行下面的操作。

{| class="wikitable" style="width:800px;" 
|-
| 
test@test:~$ '''lsb_release -a'''

No LSB modules are available.

Distributor ID: Ubuntu

Description: Ubuntu 22.04 LTS

Release: '''<span style="color:#FF0000">22.04</span>'''

Codename: '''jammy'''
|}

如果电脑安装的是Windows系统，没有安装有Ubuntu 22.04的电脑，可以考虑使用'''VirtualBox'''或者'''VMware'''来在Windows系统中安装一个Ubuntu 22.04虚拟机。但是请注意，不要在WSL虚拟机上编译orangepi-build，因为orangepi-build没有在WSL虚拟机中测试过，所以无法确保能正常在WSL中使用orangepi-build，另外请不要在'''开发板'''的Linux系统中使用orangepi-build。Ubuntu 22.04 '''<span style="color:#FF0000">amd64</span>'''版本的安装镜像下载地址为：

{| class="wikitable" style="width:800px;" 
|-
| 
[https://repo.huaweicloud.com/ubuntu-releases/21.04/ubuntu-21.04-desktop-amd64.iso '''https://mirrors.tuna.tsinghua.edu.cn/ubuntu-releases/22.04/ubuntu-22.04-desktop-amd64.iso''']
|}

在电脑中或者虚拟机中安装完Ubuntu 22.04后，请先设置Ubuntu 22.04的软件源为清华源（或者其它你觉得速度快的国内源），不然后面安装软件的时候很容易由于网络原因而出错。替换清华源的步骤如下所示：

<ol style="list-style-type: lower-alpha;">
<li>替换清华源的方法参考这个网页的说明即可。

{| class="wikitable" style="width:800px;" 
|-
| 
[https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/ '''https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/''']
|}
</li></ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>注意Ubuntu版本需要切换到22.04。</p>
<p>[[File:zero3-img294.png]]</p></li>
<li><p>需要替换的'''/etc/apt/sources.list'''文件的内容为：</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo mv /etc/apt/sources.list cat /etc/apt/sources.list.bak'''</p>
<p>test@test:~$ '''sudo vim /etc/apt/sources.list'''</p>
<p># 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释</p>
<p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse</p>
<p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse</p>
<p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse</p>
<p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse</p>
<p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse</p>
<p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse</p>
<p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse</p>
<p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse</p>


<p># 预发布软件源，不建议启用</p>
<p># deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse</p>
<p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse</p>
|}
</li>
<li><p>替换完后需要更新下包信息，并确保没有报错。</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt-get update'''</p>
|}
</li>
<li><p>'''<span style="color:#FF0000">另外，由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。</span>'''</p></li></ol>

<span id="获取linux-sdk的源码"></span>

== 获取linux sdk的源码 ==

=== 从github下载orangepi-build ===

linux sdk指的是orangepi-build这套代码，orangepi-build是基于armbian build编译系统修改而来的，使用orangepi-build可以编译出多个版本的linux镜像。使用下面的命令可以下载orangepi-build的代码：

{| class="wikitable" style="width:800px;" 
|-
| 
test@test:~$ '''sudo apt-get update'''

test@test:~$ '''sudo apt-get install -y git'''

test@test:~$ '''git clone https://github.com/orangepi-xunlong/orangepi-build.git <span style="color:#FF0000">-b next</span>'''
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''注意，使用H618 Soc的开发板是需要下载orangepi-build的<span style="color:#FF0000">next</span>分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。'''</big>

[[File:zero3-img295.png]]
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''通过git clone命令下载orangepi-build的代码是不需要输入github账号的用户名和密码的（下载本手册中的其他代码也是一样的），如果如输入git clone命令后Ubuntu PC提示需要输入github账号的用户名和密码，一般都是git clone后面的orangepi-build仓库的地址输入错误了，请仔细检查命令拼写是否有错误，而不是以为我们这里忘了提供github账号的用户名和密码。'''</big>
|}

H618系列开发板当前使用的u-boot和linux内核版本如下所示：

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''分支'''
| style="text-align: left;"| '''u-boot版本'''
| style="text-align: left;"| '''linux内核版本'''
|-
| style="text-align: left;"| '''current'''
| style="text-align: left;"| '''u-boot v2018.05'''
| style="text-align: left;"| '''linux5.4'''
|-
| style="text-align: left;"| '''next'''
| style="text-align: left;"| '''u-boot v2021.07'''
| style="text-align: left;"| '''linux6.1'''
|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''这里所说的分支和orangepi-build源代码的分支不是同一个东西，请不要搞混了。此分支主要是用来区分不同内核源码版本的。'''

'''目前全志提供的linux5.4 bsp内核我们定义为current分支。最新的linux6.1 LTS内核定义为next分支。'''</big>
|}

orangepi-build下载完后会包含下面的文件和文件夹：

<ol style="list-style-type: lower-alpha;">
<li><p>'''build.sh''': 编译启动脚本</p></li>
<li><p>'''external''': 包含编译镜像需要用的配置文件、特定的脚本以及部分程序的源码等</p></li>
<li><p>'''LICENSE''': GPL 2许可证文件</p></li>
<li><p>'''README.md''': orangepi-build说明文件</p></li>
<li><p>'''scripts''': 编译linux镜像的通用脚本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''ls'''</p>
<p>'''build.sh &nbsp;&nbsp; external &nbsp;&nbsp; LICENSE &nbsp;&nbsp; README.md &nbsp;&nbsp; scripts'''</p>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''如果是从github下载的orangepi-build的代码，下载完后你可能会发现orangepi-build中并没有包含u-boot和linux内核的源码，也没有编译u-boot和linux内核需要用到交叉编译工具链，这是正常的，因为这些东西都存放在其它单独的github仓库或者某些服务器上了（下文会详述其地址）。orangepi-build在脚本和配置文件中会指定u-boot、linux内核和交叉编译工具链的地址，运行orangepi-build时，当其发现本地没有这些东西，会自动去相应的地方下载的。'''</p></big>
|}
</li></ol>

=== 下载交叉编译工具链 ===

orangepi-build第一次运行的时候会自动下载交叉编译工具链放在'''toolchains'''文件夹中，每次运行orangepi-build的build.sh脚本后，都会检查'''toolchains'''中的交叉编译工具链是否都存在，如果不存在则会重新开始下载，如果存在则直接使用，不会重复下载。

<div class="figure">

[[File:zero3-img296.png|1400px]]

</div>
交叉编译工具链在中国境内的镜像网址为清华大学的开源软件镜像站：

{| class="wikitable" style="width:800px;" 
|-
| 
[https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/ '''https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/''']
|}

'''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-4.9.4-2017.01-x86_64_aarch64-linux-gnu 

gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabi

gcc-arm-11.2-2022.02-x86_64-arm-none-linux-gnueabihf 

gcc-linaro-4.9.4-2017.01-x86_64_arm-linux-gnueabi 

gcc-linaro-aarch64-none-elf-4.8-2013.11_linux

gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu 

gcc-linaro-5.5.0-2017.10-x86_64_arm-linux-gnueabihf 

gcc-linaro-arm-linux-gnueabihf-4.8-2014.04_linux

gcc-arm-9.2-2019.12-x86_64-arm-none-linux-gnueabihf 

gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu 

gcc-linaro-arm-none-eabi-4.8-2014.04_linux
|}

编译H618 Linux内核源码使用的交叉编译工具链为：

<ol style="list-style-type: lower-alpha;">
<li><p>linux5.4</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''</p>
|}
</li>
<li><p>linux6.1</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''</p>
|}
</li></ol>
<p>编译H618 u-boot源码使用的交叉编译工具链为：</p>

<!-- -->
<ol style="list-style-type: lower-alpha;">
<li><p>v2018.05</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabi'''</p>
|}
</li>
<li><p>v2021.07</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''</p>
|}
</li></ol>

=== orangepi-build完整目录结构说明 ===

<ol style="list-style-type: decimal;">
<li><p>orangepi-build仓库下载完后并不包含linux内核、u-boot的源码以及交叉编译工具链，linux内核和u-boot的源码存放在独立的git仓库中</p>
<ol style="list-style-type: lower-alpha;">
<li><p>linux内核源码存放的git仓库如下，注意切换linux-orangepi仓库的分支为</p>
<ol style="list-style-type: none;">
<li><p>a) Linux5.4</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-5.4-sun50iw9'''</p>
|}
</li>
<li><p>b) Linux6.1</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-6.1-sun50iw9'''</p>
|}
</li></ol>
</li>
<li><p>u-boot源码存放的git仓库如下，注意切换u-boot-orangepi仓库的分支为</p>
<ol style="list-style-type: none;">
<li><p>a) v2018.05</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2018.05-h618'''</p>
|}
</li>
<li><p>b) v2021.07</p>
{| class="wikitable" style="width:800px;" 
|-
| 
https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2021.07-sunxi'''
|}
</li></ol>
</li></ol>
</li></ol>
<ol start="2" style="list-style-type: decimal;">
<li><p>orangepi-build第一次运行的时候会去下载交叉编译工具链、u-boot和linux内核源码，成功编译完一次linux镜像后在orangepi-build中可以看到的文件和文件夹有</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''build.sh''': 编译启动脚本</p></li>
<li><p>'''external''': 包含编译镜像需要用的配置文件、特定功能的脚本以及部分程序的源码，编译镜像过程中缓存的rootfs压缩包也存放在external中</p></li>
<li><p>'''kernel''': 存放linux内核的源码</p></li>
<li><p>'''LICENSE''': GPL 2许可证文件</p></li>
<li><p>'''README.md''': orangepi-build说明文件</p></li>
<li><p>'''output''': 存放编译生成的u-boot、linux等deb包、编译日志以及编译生成的镜像等文件</p></li>
<li><p>'''scripts''': 编译linux镜像的通用脚本</p></li>
<li><p>'''toolchains''': 存放交叉编译工具链</p></li>
<li><p>'''u-boot''': 存放u-boot的源码</p></li>
<li><p>'''userpatches''': 存放编译脚本需要用到的配置文件</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''ls'''</p>
<p>'''build.sh &nbsp;&nbsp; external &nbsp;&nbsp; kernel &nbsp;&nbsp; LICENSE &nbsp;&nbsp; output &nbsp;&nbsp; README.md &nbsp;&nbsp; scripts &nbsp;&nbsp; toolchains &nbsp;&nbsp; u-boot &nbsp;&nbsp; userpatches'''</p>
|}
</li></ol>
</li></ol>

== 编译u-boot ==

<ol style="list-style-type: decimal;">
<li><p>运行build.sh脚本，记得加sudo权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''sudo ./build.sh'''</p>
|}
</li>
<li><p>选择'''U-boot package'''，然后回车</p>
<div class="figure">

[[File:zero3-img297.png]]

</div></li>
<li><p>接着选择开发板的型号</p>
<p>[[File:zero3-img298.png]]</p></li>
<li><p>然后选择u-boot的分支类型</p>
<ol style="list-style-type: lower-alpha;">
<li><p>current分支会编译linux5.4镜像需要使用的u-boot v2018.05版本的代码</p></li>
<li><p>next分支会编译linux6.1镜像需要使用的u-boot v2021.07版本的代码</p>
<p>[[File:zero3-img299.png]]</p></li></ol>
</li>
<li><p>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择</p>
<ol style="list-style-type: lower-alpha;">
<li><p>如果购买的开发板为1.5GB内存大小的，请选择第一项</p></li>
<li><p>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项</p>
<p>[[File:zero3-img299-1.png|1000px]]</p></li></ol>
</li>
<li><p>然后就会开始编译u-boot，编译next分支时提示的部分信息说明如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>u-boot源码的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Compiling u-boot [ '''v2021.07''' ]</p>
|}
</li>
<li><p>交叉编译工具链的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 11''' ]</p>
|}
</li>
<li><p>编译生成的u-boot deb包的路径</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Target directory [ '''orangepi-build/output/debs/u-boot''' ]</p>
|}
</li>
<li><p>编译生成的u-boot deb包的包名</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] File name [ '''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb''' ]</p>
|}
</li>
<li><p>编译使用的时间</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Runtime [ '''1 min''' ]</p>
|}
</li>
<li><p>重复编译u-boot的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译u-boot</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=u-boot''' ]</p>
|}
</li></ol>
</li>
<li><p>查看编译生成的u-boot deb包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''ls output/debs/u-boot/'''</p>
<p>'''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb'''</p>
|}
</li>
<li><p>orangepi-bulid编译系统编译u-boot源码时首先会将u-boot的源码和github服务器的u-boot源码进行同步，所以如果想修改u-boot的源码，首先需要关闭源码的下载更新功能（'''需要完整编译过一次u-boot后才能关闭这个功能，否则会提示找不到u-boot的源码'''），否则所作的修改都会被还原，方法如下：</p>
<p>设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''</p>
<p>......</p>
<p>IGNORE_UPDATES=&quot;'''<span style="color:#FF0000">yes</span>'''&quot;</p>
<p>......</p>
|}
</li>
<li><p>调试u-boot代码时，可以使用下面的方法来更新linux镜像中的u-boot进行测试</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先将编译好的u-boot的deb包上传到开发板的linux系统中</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''cd output/debs/u-boot'''</p>
<p>test@test:~/orangepi_build/output/debs/u-boot$ '''scp \'''</p>
<p>'''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb root@192.168.1.xxx:/root'''</p>
|}
</li>
<li><p>再安装刚才上传的新的u-boot的deb包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo dpkg -i''' '''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb'''</p>
|}
</li>
<li><p>然后运行 nand-sata-install脚本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo nand-sata-install'''</p>
|}
</li>
<li><p>然后选择'''5 Install/Update the bootloader on SD/eMMC'''</p>
<p>[[File:zero3-img300.png]]</p></li>
<li><p>按下回车键后首先会弹出一个'''Warning'''</p>
<p>[[File:zero3-img301.png]]</p></li>
<li><p>再按下回车键就会开始更新u-boot，更新完后会显示下面的信息</p>
<p>[[File:zero3-img302.png]]</p></li>
<li><p>然后就可以重启开发板来测试u-boot的修改是否生效了</p></li></ol>
</li></ol>

== 编译linux内核 ==

<ol style="list-style-type: decimal;">
<li><p>运行'''build.sh'''脚本，记得加sudo权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''sudo ./build.sh'''</p>
|}
</li>
<li><p>选择'''Kernel package'''，然后回车</p>
<div class="figure">

[[File:zero3-img303.png]]

</div></li>
<li><p>然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个</p>
<p>[[File:zero3-img304.png]]</p></li>
<li><p>接着选择开发板的型号</p>
<p>[[File:zero3-img298.png]]</p></li>
<li><p>然后选择内核源码的分支类型</p>
<ol style="list-style-type: lower-alpha;">
<li><p>current分支会编译linux5.4内核源码</p></li>
<li><p>next分支会编译linux6.1内核源码</p>
<p>[[File:zero3-img299.png]]</p></li></ol>
</li>
<li><p>如果第3)步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码。</p>
<p>[[File:zero3-img305.png]]</p></li></ol>

<!-- -->
<ol style="list-style-type: lower-alpha;">
<li><p>如果不需要修改内核的配置选项，在运行build.sh脚本时，传入'''KERNEL_CONFIGURE=no'''就可临时屏蔽弹出内核的配置界面了</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''sudo ./build.sh KERNEL_CONFIGURE=no'''</p>
|}
</li>
<li><p>也可以设置orangepi-build/userpatches/config-default.conf配置文件中的'''KERNEL_CONFIGURE=no'''，这样可以永久禁用这个功能</p></li>
<li><p>编译内核的时候如果提示下面的错误，这是由于Ubuntu &gt; PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu &gt; PC的终端调到最大，然后重新运行build.sh脚本</p>
<p>[[File:zero3-img306.png]]</p></li></ol>

<!-- -->
<ol start="7" style="list-style-type: decimal;">
<li><p>编译next分支内核源码时提示的部分信息说明如下：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>linux内核源码的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Compiling current kernel [ '''6.1.31''' ]</p>
|}
</li>
<li><p>使用的交叉编译工具链的版本</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 11''' ]</p>
|}
</li>
<li><p>内核默认使用的配置文件以及它存放的路径如下所示</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Using kernel config file [ '''orangepi-build/external/config/kernel/linux-6.1-sun50iw9-next.config''' ]</p>
|}
</li>
<li><p>编译生成的内核相关的deb包的路径</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Target directory [ '''output/debs/''' ]</p>
|}
</li>
<li><p>编译生成的内核镜像deb包的包名</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] File name [ '''linux-image-next-sun50iw9_x.x.x_arm64.deb''' ]</p>
|}
</li>
<li><p>编译使用的时间</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Runtime [ '''10 min''' ]</p>
|}
</li>
<li><p>最后会显示重复编译上一次选择的内核的编译命令，使用下面的命令无需通过图形界面选择，可以直接开始编译内核源码</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=kernel KERNEL_CONFIGURE=no''' ]</p>
|}
</li></ol>
</li>
<li><p>查看编译生成的内核相关的deb包</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''linux-dtb-next-sun50iw9_x.x.x_arm64.deb'''包含有内核使用的dtb文件</p></li>
<li><p>'''linux-headers-next-sun50iw9_x.x.x_arm64.deb'''包含内核头文件</p></li>
<li><p>'''linux-image-next-sun50iw9_x.x.x_arm64.deb'''包含内核镜像和内核模块</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''ls output/debs/linux-*'''</p>
<p>output/debs/linux-dtb-next-sun50iw9_x.x.x_arm64.deb</p>
<p>output/debs/linux-headers-next-sun50iw9_x.x.x_arm64.deb</p>
<p>output/debs/linux-image-next-sun50iw9_x.x.x_arm64.deb</p>
|}
</li></ol>
</li>
<li><p>orangepi-bulid编译系统编译linux内核源码时首先会将linux内核源码和github服务器的linux内核源码进行同步，所以如果想修改linux内核的源码，首先需要关闭源码的更新功能（'''需要完整编译过一次linux内核源码后才能关闭这个功能，否则会提示找不到linux内核的源码'''），否则所作的修改都会被还原，方法如下：</p>
<p>设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''</p>
<p>IGNORE_UPDATES=&quot;'''<span style="color:#FF0000">yes</span>'''&quot;</p>
|}
</li>
<li><p>如果对内核做了修改，可以使用下面的方法来更新开发板linux系统的内核和内核模块</p>
<ol style="list-style-type: lower-alpha;">
<li><p>将编译好的linux内核的deb包上传到开发板的linux系统中</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''cd output/debs'''</p>
<p>test@test:~/orangepi-build/output/debs$ '''scp \'''</p>
<p>'''linux-image-next-sun50iw9_x.x.x_arm64.deb root@192.168.1.xxx:/root'''</p>
|}
</li>
<li><p>再安装刚才上传的新的linux内核的deb包</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo dpkg -i linux-image-next-sun50iw9_x.x.x_arm64.deb'''</p>
|}
</li>
<li><p>然后重启开发板，再查看内核相关的修改是否已生效</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>orangepi@orangepi:~$ '''sudo''' '''reboot'''</p>
|}
</li></ol>
</li></ol>

== 编译rootfs ==

<ol style="list-style-type: decimal;">
<li><p>运行build.sh脚本，记得加sudo权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''sudo ./build.sh'''</p>
|}
</li>
<li><p>选择'''Rootfs and all deb packages'''，然后回车</p></li>

<div class="figure">

[[File:zero3-img307.png]]

</div></ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>接着选择开发板的型号</p>
<p>[[File:zero3-img298.png]]</p></li>
<li><p>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别</p>
<ol style="list-style-type: lower-alpha;">
<li><p>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</p></li>
<li><p>next分支可以看到debian11、debian12、ubuntu22.04三个选项</p>
<p>[[File:zero3-img299.png]]</p></li></ol>
</li>
<li><p>然后选择rootfs的类型</p>
<p>[[File:zero3-img308.png]]</p></li>
<li><p>然后选择镜像的类型</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''Image with console interface (server)'''表示服务器版的镜像，体积比较小</p></li>
<li><p>'''Image with desktop environment'''表示带桌面的镜像，体积比较大</p>
<div class="figure">

[[File:zero3-img309.png]]

</div></li></ol>
</li>
<li><p>如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（'''没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了'''）</p>
<div class="figure">

[[File:zero3-img310.png]]

</div></li>
<li><p>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面</p>
<p>[[File:zero3-img311.png]]</p>
<p>[[File:zero3-img312.png]]</p>
<p>然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。</p>
<p>[[File:zero3-img313.png]]</p></li>
<li><p>然后就会开始编译rootfs，编译时提示的部分信息说明如下</p>
<ol style="list-style-type: lower-alpha;">
<li><p>rootfs的类型</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] local not found [ Creating new rootfs cache for '''bullseye''' ]</p>
|}
</li>
<li><p>编译生成的rootfs压缩包的存放路径</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Target directory [ '''orangepi-build/external/cache/rootfs''' ]</p>
|}
</li>
<li><p>编译生成的rootfs压缩包的名字</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] File name [ '''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4''' ]</p>
|}
</li></ol>
</li>
<li><p>查看编译生成的rootfs压缩包</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4'''是rootfs的压缩包，名字各字段的含义为</p>
<ol style="list-style-type: none;">
<li><p>a) '''bullseye'''表示rootfs的linux发行版的类型</p></li>
<li><p>b) '''xfce'''表示rootfs为桌面版的类型，如果为'''cli'''则表示服务器版类型</p></li>
<li><p>c) '''arm64'''表示rootfs的架构类型</p></li>
<li><p>d) '''25250ec7002de9e81a41de169f1f89721'''是由rootfs安装的所有软件包的包名生成的MD5哈希值，只要没有修改rootfs安装的软件包的列表，那么这个值就不会变，编译脚本会通过这个MD5哈希值来判断是否需要重新编译rootfs</p></li></ol>
</li>
<li><p>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list'''列出了rootfs安装的所有软件包的包名</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''ls external/cache/rootfs/'''</p>
<p>bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4</p>
<p>bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.current</p>
<p>bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list</p>
|}
</li></ol>
</li>
<li><p>如果需要的rootfs在'''external/cache/rootfs'''下已经存在，那么再次编译rootfs就会直接跳过编译过程，不会重新开始编译，编译镜像的时候也会去'''external/cache/rootfs'''下查找是否已经有缓存可用的rootfs，如果有就直接使用，这样可以节省大量的下载编译时间</p></li></ol>

== 编译linux镜像 ==

<ol style="list-style-type: decimal;">
<li><p>运行'''build.sh'''脚本，记得加sudo权限</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~/orangepi-build$ '''sudo ./build.sh'''</p>
|}
</li>
<li><p>选择'''Full OS image for flashing'''，然后回车</p></li>

<div class="figure">

[[File:zero3-img314.png]]

</div></ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后选择开发板的型号</p>
<p>[[File:zero3-img298.png]]</p></li>
<li><p>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别</p>
<ol style="list-style-type: lower-alpha;">
<li><p>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</p></li>
<li><p>next分支可以看到debian11、debian12、ubuntu22.04三个选项</p>
<p>[[File:zero3-img299.png]]</p></li></ol>
</li>
<li><p>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择</p>
<ol style="list-style-type: lower-alpha;">
<li><p>如果购买的开发板为1.5GB内存大小的，请选择第一项</p></li>
<li><p>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项</p>
<p>[[File:zero3-img299-1.png]]</p></li></ol>
</li>
<li><p>然后选择rootfs的类型</p>
<p>[[File:zero3-img308.png]]</p></li>
<li><p>然后选择镜像的类型</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''Image with console interface (server)'''表示服务器版的镜像，体积比较小</p></li>
<li><p>'''Image with desktop environment'''表示带桌面的镜像，体积比较大</p>
<div class="figure">

[[File:zero3-img309.png]]

</div></li></ol>
</li>
<li><p>如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（'''没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了'''）</p>
<div class="figure">

[[File:zero3-img310.png]]

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

<!-- -->
<ol start="8" style="list-style-type: decimal;">
<li><p>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面</p>
<p>[[File:zero3-img311.png]]</p>
<p>[[File:zero3-img312.png]]</p>
<p>然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。</p>
<p>[[File:zero3-img313.png]]</p></li></ol>

<!-- -->
<ol start="9" style="list-style-type: decimal;">
<li><p>然后就会开始编译linux镜像，编译的大致流程如下</p>
<ol style="list-style-type: lower-alpha;">
<li><p>初始化Ubuntu PC的编译环境，安装编译过程需要的软件包</p></li>
<li><p>下载u-boot和linux内核的源码（如果已经缓存，则只更新代码）</p></li>
<li><p>编译u-boot源码，生成u-boot的deb包</p></li>
<li><p>编译linux源码，生成linux相关的deb包</p></li>
<li><p>制作linux firmware的deb包</p></li>
<li><p>制作orangepi-config工具的deb包</p></li>
<li><p>制作板级支持的deb包</p></li>
<li><p>如果是编译desktop版镜像，还会制作desktop相关的deb包</p></li>
<li><p>检查rootfs是否已经缓存，如果没有缓存，则重新制作rootfs，如果已经缓存，则直接解压使用</p></li>
<li><p>安装前面生成的deb包到rootfs中</p></li>
<li><p>对不同的开发板和不同类型镜像做一些特定的设置，如预装额外的软件包，修改系统配置等</p></li>
<li><p>然后制作镜像文件，并格式化分区，默认类型为ext4</p></li>
<li><p>再将配置好的rootfs拷贝到镜像的分区中</p></li>
<li><p>然后更新initramfs</p></li>
<li><p>最后将u-boot的bin文件通过dd命令写入到镜像中</p></li></ol>
</li>
<li><p>编译完镜像后会提示下面的信息</p>
<ol style="list-style-type: lower-alpha;">
<li><p>编译生成的镜像的存放路径</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Done building [ '''output/images/orangepizero3_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop/orangepizero3_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop.img''' ]</p>
|}
</li>
<li><p>编译使用的时间</p></li>
{| class="wikitable" style="width:800px;" 
|-
| 
'''[ o.k. ] Runtime [ 19 min ]'''
|}
<li><p>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=image RELEASE=bullseye BUILD_MINIMAL=no BUILD_DESKTOP=no KERNEL_CONFIGURE=yes''' ]</p>
|}
</li></ol>
</li></ol>
<span id="android-12-tv系统使用说明"></span>

= '''Android 12 TV系统使用说明''' =

<span id="已支持的android版本"></span>
== 已支持的Android版本 ==

{| class="wikitable" style="width:600px;" 
|-
| style="text-align: left;"| Android版本
| style="text-align: left;"| 内核版本
|-
| style="text-align: left;"| '''Android 12 TV版'''
| style="text-align: left;"| '''linux5.4'''
|}

<span id="android-12-tv功能适配情况"></span>

== Android 12 TV功能适配情况 ==

{| class="wikitable" style="width:600px;" 
|-
| style="text-align: left;"| 功能
| style="text-align: left;"| Android12
|-
| style="text-align: left;"| HDMI视频
| style="text-align: left;"| OK
|-
| style="text-align: left;"| HDMI音频
| style="text-align: left;"| OK
|-
| style="text-align: left;"| USB2.0 x 3
| style="text-align: left;"| OK
|-
| style="text-align: left;"| TF卡启动
| style="text-align: left;"| OK
|-
| style="text-align: left;"| 网卡
| style="text-align: left;"| OK
|-
| style="text-align: left;"| 红外
| style="text-align: left;"| OK
|-
| style="text-align: left;"| WIFI
| style="text-align: left;"| OK
|-
| style="text-align: left;"| WIFI hotsport
| style="text-align: left;"| OK
|-
| style="text-align: left;"| 蓝牙
| style="text-align: left;"| OK
|-
| style="text-align: left;"| BLE蓝牙
| style="text-align: left;"| OK
|-
| style="text-align: left;"| 耳机音频
| style="text-align: left;"| OK
|-
| style="text-align: left;"| TV-OUT
| style="text-align: left;"| OK
|-
| style="text-align: left;"| USB摄像头
| style="text-align: left;"| OK
|-
| style="text-align: left;"| LED灯
| style="text-align: left;"| OK
|-
| style="text-align: left;"| 温度传感器
| style="text-align: left;"| OK
|-
| style="text-align: left;"| Mali GPU
| style="text-align: left;"| OK
|-
| style="text-align: left;"| 视频编解码
| style="text-align: left;"| OK
|}

<span id="板载led灯显示说明"></span>

== 板载LED灯显示说明 ==

{| class="wikitable" style="width:600px;" 
|-
|
| style="text-align: left;"| '''绿灯'''
| style="text-align: left;"| '''红灯'''
|-
| '''u-boot启动阶段'''
| style="text-align: left;"| '''灭'''
| style="text-align: left;"| '''亮'''
|-
| '''内核启动到进入系统'''
| style="text-align: left;"| '''亮'''
| style="text-align: left;"| '''灭'''
|}

<span id="android返回上一级界面的方法"></span>

== Android返回上一级界面的方法 ==

<ol style="list-style-type: decimal;">
<li><p>我们一般都是使用鼠标和键盘来控制开发板的安卓系统，当进入某些界面，需要返回上一级界面或者桌面时，只能通过'''<span style="color:#FF0000">鼠标右键</span>'''来返回，键盘是无法返回的</p></li>
<li><p>如果有购买开发板配套的红外遥控（其他遥控不行）和扩展板，将扩展板插入开发板后，还可以通过遥控中的返回键来返回上一级菜单，返回键的位置如下图所示</p>
<p>[[File:zero3-img315.png]]</p></li></ol>

<span id="adb的使用方法"></span>

== ADB的使用方法 ==

=== 使用网络连接adb调试 ===

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''使用网络adb无需USB Typc C接口的数据线来连接电脑和开发板，而是通过网络来通信，所以首先请确保开发板的有线或者无线网络已经连接好了，然后获取开发板的IP地址，后面要用到。'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>确保Android系统的'''service.adb.tcp.port'''设置为5555端口号</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>apollo-p2:/ # '''getprop | grep &quot;adb.tcp&quot;'''</p>
<p>[service.adb.tcp.port]: [5555]</p>
|}
</li>
<li><p>如果'''service.adb.tcp.port'''没有设置，可以在串口中使用下面的命令设置网络adb的端口号</p>

{| class="wikitable" style="width:800px;" 
|-
| 
apollo-p2:/ # '''setprop service.adb.tcp.port 5555'''

apollo-p2:/ # '''stop adbd'''

apollo-p2:/ # '''start adbd'''
|}
</li></ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>在Ubuntu PC上安装adb工具</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt-get update'''</p>
<p>test@test:~$ '''sudo apt-get install -y adb'''</p>
|}
</li>
<li><p>然后在Ubuntu PC上连接网络adb</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''adb connect 192.168.1.xxx:5555''' '''(需要修改为开发板的IP地址)'''</p>
<p>* daemon not running; starting now at tcp:5037</p>
<p>* daemon started successfully</p>
<p>connected to 192.168.1.xxx:5555</p>


<p>test@test:~$ '''adb devices'''</p>
<p>List of devices attached</p>
<p>192.168.1.xxx:5555 device</p>
|}
</li>
<li><p>然后在Ubuntu PC上通过adb shell就可以登录android系统</p>

{| class="wikitable" style="width:800px;" 
|-
| 
test@test:~$ '''adb shell'''

apollo-p2:/ #
|}
</li></ol>

=== 使用数据线连接adb调试 ===

<ol style="list-style-type: decimal;">
<li><p>准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的电源接口中。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板</p>
<div class="figure">

[[File:zero3-img15.png]]

</div></li>
<li><p>在Ubuntu PC上安装adb工具</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''sudo apt-get update'''</p>
<p>test@test:~$ '''sudo apt-get install -y adb'''</p>
|}
</li>
<li><p>查看识别到ADB设备</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''adb devices'''</p>
<p>List of devices attached</p>
<p>4c00146473c28651dd0 device</p>
|}
</li>
<li><p>然后在Ubuntu PC上通过adb shell就可以登录android系统</p>

{| class="wikitable" style="width:800px;" 
|-
| 
test@test:~$ '''adb shell'''

apollo-p2:/ $
|}
</li></ol>
<span id="查看设置hdmi显示分辨率的方法"></span>

== 查看设置HDMI显示分辨率的方法 ==

<ol style="list-style-type: decimal;">
<li><p>首先进入'''Settings'''</p>
<p>[[File:zero3-img316.png]]</p></li>
<li><p>然后选择'''Device Preferences'''</p>
<p>[[File:zero3-img317.png]]</p></li>
<li><p>然后选择'''Display &amp; Sound'''</p>
<p>[[File:zero3-img318.png]]</p></li>
<li><p>然后选择'''Advanced display settings'''</p>
<p>[[File:zero3-img319.png]]</p></li>
<li><p>然后选择'''HDMI output mode'''</p>
<p>[[File:zero3-img320.png]]</p></li>
<li><p>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。</p>
<p>[[File:zero3-img321.png]]</p></li>
<li><p>开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项</p>
<p>[[File:zero3-img322.png]]</p></li></ol>

<span id="hdmi转vga显示测试-1"></span>

== HDMI转VGA显示测试 ==

<ol style="list-style-type: decimal;">
<li><p>首先需要准备下面的配件</p>
<ol style="list-style-type: lower-alpha;">
<li><p>HDMI转VGA转换器</p>
<p>[[File:zero3-img146.png]]</p></li>
<li><p>一根VGA线和一根Micro HDMI公转HDMI母转接线</p>
<p>[[File:zero3-img147.png]] [[File:zero3-img148.png]]</p></li>
<li><p>一个支持VGA接口的显示器或者电视</p></li></ol>
</li>
<li><p>HDMI转VGA显示测试如下所示</p>
<p>[[File:zero3-img323.png]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big><p>'''使用HDMI转VGA显示时，开发板以及开发板的Android系统是不需要做任何设置的，只需要开发板Micro HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</p></big>
|}
</li></ol>

<span id="wi-fi的连接方法"></span>

== WI-FI的连接方法 ==

<ol style="list-style-type: decimal;">
<li><p>首先选择'''Settings'''</p>
<p>[[File:zero3-img316.png]]</p></li>
<li><p>然后选择'''Network &amp; Internet'''</p>
<p>[[File:zero3-img324.png]]</p></li>
<li><p>然后打开WI-FI</p>
<p>[[File:zero3-img325.png]]</p></li>
<li><p>打开WI-FI后在'''Available networks'''下面就可以看到搜索到的信号</p>
<p>[[File:zero3-img326.png]]</p></li>
<li><p>选择想连接的WI-FI后会弹出下图所示的密码输入界面</p>
<div class="figure">

[[File:zero3-img327.png]]

</div></li>
<li><p>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了</p>
<p>[[File:zero3-img328.png]]</p></li>
<li><p>WI-FI连接成功后的显示如下图所示</p>
<p>[[File:zero3-img329.png]]</p></li></ol>

<span id="wi-fi-hotspot的使用方法"></span>
== WI-FI hotspot的使用方法 ==

<ol style="list-style-type: decimal;">
<li><p>首先请确保以太网口已连接网线，并且能正常上网</p></li>
<li><p>然后选择'''Settings'''</p>
<p>[[File:zero3-img316.png]]</p></li>
<li><p>然后选择'''Network &amp; Internet'''</p>
<p>[[File:zero3-img324.png]]</p></li>
<li><p>然后选择'''WIFI hotspot'''</p>
<p>[[File:zero3-img330.png]]</p></li>
<li><p>然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）</p>
<p>[[File:zero3-img331.png]]</p></li>
<li><p>此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password'''下面可以看到</p>
<p>[[File:zero3-img332.png]]</p></li>
<li><p>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot'''能正常使用</p>
<p>[[File:zero3-img333.png]]</p></li></ol>

<span id="查看以太网口ip地址的方法"></span>
== 查看以太网口IP地址的方法 ==

<ol style="list-style-type: decimal;">
<li><p>首先请确保开发板的千兆网口连接到了路由器或者交换机</p></li>
<li><p>然后打开'''Settings'''</p>
<p>[[File:zero3-img334.png]]</p></li>
<li><p>然后选择'''Network &amp; Internet'''</p>
<p>[[File:zero3-img335.png]]</p></li>
<li><p>然后在下图所示的位置就能看到开发板有线网口的IP地址了</p>
<p>[[File:zero3-img336.png]]</p></li></ol>

== 蓝牙的连接方法 ==

<ol style="list-style-type: decimal;">
<li><p>首先选择'''Settings'''</p>
<p>[[File:zero3-img316.png]]</p></li>
<li><p>然后选择'''Bluetooth'''</p>
<p>[[File:zero3-img337.png]]</p></li>
<li><p>然后打开'''Bluetooth Enable'''</p>
<p>[[File:zero3-img338.png]]</p></li>
<li><p>然后点击'''Pair new device'''开始扫描周围的蓝牙设备</p>
<p>[[File:zero3-img339.png]]</p></li>
<li><p>搜索到的蓝牙设备会在'''Available devices'''下面显示出来</p>
<p>[[File:zero3-img340.png]]</p></li>
<li><p>然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项</p>
<p>[[File:zero3-img341.png]]</p></li>
<li><p>这里测试的是开发板和'''<span style="color:#FF0000">安卓手机</span>'''蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程</p>
<p>[[File:zero3-img342.png]]</p></li>
<li><p>配对完成后，再打开'''Paired devices'''下面就可以看到已配对的蓝牙设备</p>
<p>[[File:zero3-img343.png]]</p></li>
<li><p>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了</p>
<p>[[File:zero3-img344.png]]</p></li>
<li><p>开发板Android系统蓝牙接收到的图片可以打开'''Received files'''中查看</p>
<p>[[File:zero3-img345.png]]</p></li></ol>

<span id="usb摄像头使用方法"></span>

== USB摄像头使用方法 ==

<ol style="list-style-type: decimal;">
<li><p>首先在开发板的USB接口中插入USB（UVC协议）摄像头</p></li>
<li><p>USB摄像头如果识别正常，在/dev下会生成相应的video设备节点</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>console:/ # '''ls /dev/video0'''</p>
<p>/dev/video0</p>
|}
</li>
<li><p>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[Orange Pi Zero 3#ADB的使用方法|'''ADB的使用方法''']]一小节的说明</p></li>
<li><p>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP</p>
<p>[[File:zero3-img346.png]]</p>
<p>[[File:zero3-img347.png]]</p></li>
<li><p>然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''adb install usbcamera.apk'''</p>
|}
</li>
<li><p>安装完后在Android的桌面可以看到USB摄像头的启动图标</p>
<p>[[File:zero3-img348.png]]</p></li>
<li><p>然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了</p></li></ol>

<span id="android系统root说明"></span>

== Android系统ROOT说明 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''<span class="mark">Orange Pi发布的Android系统已经ROOT，可以使用下面的方法来测试。</span>'''</big>
|}

<ol style="list-style-type: decimal;">
<li><p>在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''</p>
<p>[[File:zero3-img346.png]]</p>
<p>[[File:zero3-img349.png]]</p></li>
<li><p>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l|'''ADB的使用方法''']]一小节的说明</p></li>
<li><p>然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>test@test:~$ '''adb install rootcheck.apk'''</p>
|}
</li>
<li><p>安装完后在Android的桌面可以看到ROOT测试工具的启动图标</p>
<p>[[File:zero3-img350.png]]</p></li>
<li><p>第一次打开'''ROOT测试工具'''后的显示界面如下图所示</p>
<p>[[File:zero3-img351.png]]</p></li>
<li><p>然后就可以点击'''CHECK NOW'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限</p>
<p>[[File:zero3-img352.png]]</p></li></ol>

<span id="使用miracastreceiver将手机屏幕投屏到开发板的方法"></span>

== 使用MiracastReceiver将手机屏幕投屏到开发板的方法 ==

<ol style="list-style-type: decimal;">
<li><p>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[Orange Pi Zero 3#WI-FI的连接方法|'''WI-FI的连接方法''']]一小节的说明</p></li>
<li><p>然后打开开发板安卓系统中的'''MiracastReceiver'''应用</p>
<p>[[File:zero3-img353.png]]</p></li>
<li><p>'''MiracastReceiver'''打开后的界面如下所示</p>
<div class="figure">

[[File:zero3-img354.png]]

</div></li>
<li><p>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能</p>
<p>[[File:zero3-img355.png]]</p></li>
<li><p>等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可</p>
<p>[[File:zero3-img356.png]]</p></li>
<li><p>然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可</p>
<p>[[File:zero3-img357.png]]</p></li>
<li><p>然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了</p>
<p>[[File:zero3-img358-1.png]]</p></li></ol>

<span id="pin-接口-gpiouartspi-测试"></span>

== 26pin 接口 GPIO、UART、SPI 测试 ==

<span id="pin的gpio口测试方法"></span>
=== 26pin的GPIO口测试方法 ===

<ol style="list-style-type: decimal;">
<li><p>首先在桌面中打开wiringOP APP</p>
<p>[[File:zero3-img359.png]]</p></li>
<li><p>然后点击'''GPIO_TEST'''按钮打开GPIO测试界面</p>
<p>[[File:zero3-img360.png]]</p></li>
<li><p>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮跟26pin引脚（'''左下角的PC1/PI16/PI6/PH10是13pin引脚中的GPIO口'''）是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平设置为低电平；当点击右边的'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息。</p>
<p>[[File:zero3-img361.png]]</p></li>
<li><p>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：</p>
<div class="figure">

[[File:zero3-img362.png]]

</div></li>
<li><p>开发板26pin中总共有17个GPIO口可以使用（'''如果加上13pin中的4个GPIO口，那么总共就是有21个'''），下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平。首先点击7号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，7号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功</p>
<p>[[File:zero3-img363.png]]</p></li>
<li><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为'''OUT'''，引脚电平为高电平</p>
<p>[[File:zero3-img364.png]]</p></li>
<li><p>再次点击下图的'''CheckBox'''按钮取消勾选状态，7号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功</p>
<p>[[File:zero3-img365.png]]</p></li>
<li><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为OUT，引脚电平为低电平</p>
<p>[[File:zero3-img366.png]]</p></li></ol>

<span id="pin的uart测试方法"></span>
=== 26pin的UART测试方法 ===

<ol style="list-style-type: decimal;">
<li><p>Android中默认打开了'''UART5'''，对应的设备节点为'''/dev/ttyAS5'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>apollo-p2:/ # '''ls /dev/ttyAS5'''</p>
<p>/dev/ttyAS5</p>
|}
</li>
<li><p>首先在桌面中打开wiringOP APP</p>
<p>[[File:zero3-img359.png]]</p></li>
<li><p>然后点击'''UART_TEST'''按钮打开UART测试界面</p>
<p>[[File:zero3-img367.png]]</p></li>
<li><p>wiringOP的串口测试界面如下图所示</p></li>

[[File:zero3-img368.png]]
</ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>然后在选择框中选择'''/dev/ttyAS5'''节点</p>
<p>[[File:zero3-img369.png]]</p></li>
<li><p>再在编辑框中输入想要设置的波特率，然后点击'''OPEN'''按钮打开'''/dev/ttyAS5'''节点，打开成功后，'''OPEN'''按钮变为不可选中状态，'''CLOSE'''按钮和'''SEND'''按钮变为可选中状态</p></li>

[[File:zero3-img370.png]]
</ol>
<ol start="7" style="list-style-type: decimal;">
<li>然后使用杜邦线短接uart5的rx和tx引脚</li>

{| class="wikitable" style="width:600px;" 
|-
|
| style="text-align: left;"| uart5
|-
| tx引脚
| style="text-align: left;"| 对应26pin的8号引脚
|-
| rx引脚
| style="text-align: left;"| 对应26pin的10号引脚
|}
</ol>
<ol start="8" style="list-style-type: decimal;">
<li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li>

[[File:zero3-img371.png]]
</ol>
<ol start="9" style="list-style-type: decimal;">
<li>如果一切正常，接收框内会显示已接收到的字符串</li>

[[File:zero3-img372.png]]
</ol>
<span id="pin的spi测试方法"></span>

=== 26pin的SPI测试方法 ===

<ol style="list-style-type: decimal;">
<li><p>26pin中可以用的SPI为SPI1，对应的设备节点为'''/dev/spidev1.1'''</p>
<p>[[File:zero3-img359.png]]</p></li>
<li><p>这里演示下通过'''w25q64'''模块来测试SPI1接口，首先在SPI1接口接入w25q64模块</p>

{| class="wikitable" style="background-color:#ffffdc;width:800px;" 
|-
| 
<big>'''如果没有 w25q64 模块也没关系，因为开发板上有一个SPIFlash接在了SPI0上，在安卓中SPI0的配置默认也打开了，所以我们也可以直接使用板载的SPIFlash测试。'''</big>
|}
</li></ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后在桌面中打开wiringOP APP</p></li>
<li><p>然后点击'''SPI_TEST'''按钮打开SPI的测试界面</p>
<p>[[File:zero3-img373.png]]</p></li>
<li><p>然后在左上角选择spi的设备节点，如果直接测试板载的SPIFlash，那么保持默认的'''/dev/spidev0.0'''即可，如果在26pin的spi1上接了'''w25q64'''模块，那么就请选择'''/dev/spidev1.1'''</p>
<p>[[File:zero3-img374.png]]</p></li>
<li><p>然后点击'''OPEN'''按钮初始化SPI</p></li>

[[File:zero3-img375.png]]
</ol>
<ol start="7" style="list-style-type: decimal;">
<li><p>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮</p>
<p>[[File:zero3-img376.png]]</p></li>
<li><p>最后APP会显示读取到的板载SPI Flash的ID信息</p></li>

[[File:zero3-img377-1.png]]
</ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>如果是读取接在26pin SPI1上的w25q64模块，那么读取到的ID信息如下图所示</p>
<p>[[File:zero3-img378.png]]</p></li>
<li><p>w25q64模块的MANUFACTURER ID为EFh，Device ID为4017h，跟上面读取到的值是对应的（h代表是16进制）</p>
<p>[[File:zero3-img379.png]]</p></li></ol>

<span id="pin的i2c测试方法"></span>

=== 26pin的I2C测试方法 ===

<ol style="list-style-type: decimal;">
<li><p>Android中默认打开了26pin中的i2c3，对应的设备节点为'''/dev/i2c-3'''</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>apollo-p2:/ # '''ls /dev/i2c-3'''</p>
<p>/dev/i2c-3</p>
|}
</li>
<li><p>首先在桌面中打开wiringOP APP</p>
<p>[[File:zero3-img359.png]]</p></li>
<li><p>然后点击'''I2C_TEST'''按钮打开i2c的测试界面</p>
<p>[[File:zero3-img380.png]]</p></li>
<li><p>wiringOP的i2c测试界面如下图所示，可以看到默认使用的i2c为'''/dev/i2c-3'''，所以我们无需重新选择了</p></li>

[[File:zero3-img381.png]]
</ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>然后在26pin的i2c3引脚上接一个i2c设备，这里以ds1307 rtc模块为例</p>
<p>[[File:zero3-img186.png]]</p></li>

{| class="wikitable" style="width:600px;" 
|-
| style="text-align: left;"| '''RTC模块的引脚'''
| style="text-align: left;"| '''开发板26pin对应的引脚'''
|-
| style="text-align: left;"| '''5V'''
| style="text-align: left;"| '''2号引脚'''
|-
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''6号引脚'''
|-
| style="text-align: left;"| '''SDA'''
| style="text-align: left;"| '''3号引脚'''
|-
| style="text-align: left;"| '''SCL'''
| style="text-align: left;"| '''5号引脚'''
|}
</ol>
<ol start="6" style="list-style-type: decimal;">
<li><p>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 3'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如下图所示，如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。</p>
{| class="wikitable" style="width:800px;" 
|-
| 
<p>apollo-p2:/ # '''i2cdetect -y 3'''</p>
|}
<p>[[File:zero3-img382.png]]</p></li>
<li><p>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c3</p>
<p>[[File:zero3-img383.png]]</p></li>
<li><p>点击'''OPEN'''按钮打开i2c3后的显示如下所示：</p>
<p>[[File:zero3-img384.png]]</p></li>
<li><p>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55</p>
<ol style="list-style-type: lower-alpha;">
<li><p>我们首先设置需要写入的寄存器的地址为0x1c</p>
<p>[[File:zero3-img385.png]]</p></li>
<li><p>然后设置需要写入的值为0x55</p>
<p>[[File:zero3-img386.png]]</p></li>
<li><p>然后点击'''WRITE BYTE'''按钮执行写入的动作</p>
<p>[[File:zero3-img387.png]]</p></li></ol>
</li>
<li><p>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过</p>
<p>[[File:zero3-img388.png]]</p></li></ol>

= '''附录''' =

== 用户手册更新历史 ==

{| class="wikitable" style="width:800px;" 
|-
| style="text-align: left;"| '''版本'''
| style="text-align: left;"| '''日期'''
| style="text-align: left;"| '''更新说明'''
|-
| style="text-align: left;"| v1.0
| style="text-align: left;"| 2023-07-10
| style="text-align: left;"| 初始版本
|}

== 镜像更新历史 ==

{| class="wikitable"  style="width:800px;" 
|-
| '''日期'''

| '''更新说明'''
|-
| 2023-07-10
| Orangepizero3_1.0.0_ubuntu_jammy_server_linux5.4.125.7z

Orangepizero3_1.0.0_debian_bullseye_server_linux5.4.125.7z

Orangepizero3_1.0.0_ubuntu_focal_desktop_xfce_linux5.4.125.7z

Orangepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux5.4.125.7z

Orangepizero3_1.0.0_debian_bullseye_desktop_xfce_linux5.4.125.7z


Orangepizero3_1.0.0_ubuntu_jammy_server_linux6.1.31.7z

Orangepizero3_1.0.0_debian_bookworm_server_linux6.1.31.7z

Orangepizero3_1.0.0_debian_bullseye_server_linux6.1.31.7z

Orangepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux6.1.31.7z

Orangepizero3_1.0.0_debian_bookworm_desktop_xfce_linux6.1.31.7z

Orangepizero3_1.0.0_debian_bullseye_desktop_xfce_linux6.1.31.7z


OrangePi_Zero3_Android12_v1.0.tar.gz


* 初始版本

|}