8,460
个编辑
更改
→缩小TF卡中rootfs分区容量的方法
|-
| WIFI+蓝牙
| • AW859A芯片、支持IEEE 5622芯片、支持IEEE 802.11 a/b/g/n/ac、BT5.0
|-
| 视频输出
<big>'''顶层视图：'''</big><br>
[[File:media/image3zero3-img3-1.png|390x329px]]
<big>'''底层视图：'''</big><br>
[[File:media/image4zero3-img4-1.png|494x292px]]
<span id="orange-pi-zero-3的接口详情图"></span>
== Orange Pi Zero 3的接口详情图 ==
[[File:media/image5zero3-img5-1.png|576x782px800px]]
[[File:media/image6zero3-img6.png|575x227px800px]]
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<ol style="list-style-type: decimal;">
<li><p>TF卡，最小8GB容量的'''class10'''级或以上的高速闪迪卡</p>
<p>[[File:media/image7zero3-img7.png|124x96px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>'''使用其他品牌的TF卡（非闪迪的TF卡），如下图所示（包含但不仅限这些卡），已经有朋友反馈系统启动过程中会出现问题，比如系统启动到一半卡住不动，或者reboot命令无法正常使用，最后都是换了闪迪牌的TF卡后才解决的。所以如果您使用的是非闪迪牌的TF卡发现系统启动或者使用过程有问题，请更换闪迪牌的TF卡后再测试。'''</p></big>
<p>[[File:media/image8zero3-img8-1.png|103x85px180px]][[File:media/image9zero3-img9-1.png|112x85px195px]][[File:media/image10zero3-img10-1.png|114x85px198px]][[File:media/image11zero3-img11-1.png|86x109px190px]]</p><pstyle="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:media/image12zero3-img12.png|139x96px]]</p></li>
<li><p>Micro HDMI转HDMI连接线，用于将开发板连接到HDMI显示器或者电视进行显示</p>
<div class="figure">
[[File:media/image13zero3-img13.jpeg|209x209px|IMG_6109(20211221-181051)png]]
</div>
|
<big><p>'''注意，请不要使用下图所示的这种比较宽的Micro HDMI转接头，由于开发板的Micro HDMI接口和Type-C电源接口之间的间距比较小，可能会导致两者无法同时插入到开发板。'''</p></big>
<p>[[File:zero3-img14.png|center]]</p>
|}
<li><p>电源，如果有5V/2A或5V/3A的电源头那就只需要准备一根下面左边图片所示的USB转Type C接口的数据线，另外也可以使用类似下面右边图片所示的线和电源头一体的5V/2A或者5V/3A的高品质USB Typc C接口电源适配器。</p>
<p>[[File:media/image15zero3-img15.jpegpng|172x172px|IMG_4194(20201104-125502)600px]] [[File:media/image16zero3-img16.jpegpng|173x173px|IMG_6179(20220116-151727)600px]]</p></li>
<li><p>13pin扩展板</p>
<ol style="list-style-type: lower-alpha;">
<li><p>扩展板实物如下所示</p>
<p>[[File:media/image17zero3-img17.png|285x166px]]</p></li>
<li><p>扩展板插入开发板的方式如下所示，切记不要插反了</p>
<p>[[File:media/image18zero3-img18.png|246x162px]]</p></li>
<li><p>Orange Pi Zero 3开发板上的13pin排针可以接上扩展板来扩展开发板上没有的功能，扩展板可以使用的功能有</p>
<ol start="4" style="list-style-type: lower-alpha;">
<li><p>Orange Pi Zero 3开发板13pin排针的原理图如下所示</p>
<p>[[File:media/image19zero3-img19.png|264x142px]]</p></li></ol>
</ol>
<!-- -->
<li><p>USB接口的鼠标和键盘，只要是标准USB接口的鼠标和键盘都可以，鼠标和键盘可以用来控制Orange Pi开发板</p></li>
<li><p>红外遥控器，主要用于控制安卓TV系统</p>
<p>[[File:media/image20zero3-img20.png|209x196px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<li><p>百兆或者千兆网线，用于将开发板连接到因特网</p></li>
<li><p>AV视频线，如果希望通过AV接口而不是HDMI接口来显示视频，那么就需要通过AV视频线将开发板连接到电视</p>
<p>[[File:media/image21zero3-img21.png|200x177px]]</p></li>
<li><p>散热片，如果担心开发板的温度过高，可以加个散热片，散热片贴在H618芯片上即可</p>
<p>[[File:media/image22zero3-img22.png|171x140px]] [[File:media/image23zero3-img23-1.png|151x147px]]</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:media/image24zero3-img24-1.png|212x226px]]</p></li>
<li><p>配套外壳'''（待添加图片）'''</p></li>
<li><p>USB转TTL模块和杜邦线，使用串口调试功能时，需要USB转TTL模块和杜邦线来连接开发板和电脑</p>
<p>[[File:media/image25zero3-img25.png|176x145px]] [[File:media/image26zero3-img26.png|305x110px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<ol start="5" style="list-style-type: decimal;">
<li><p>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方</p>
<p>[[File:media/image27zero3-img27.png|456x219px]]</p></li>
<li><p>然后可以选择下载balenaEtcher的Portable版本的软件，Portable版本无需安装，双击打开就可以使用</p>
<p>[[File:media/image28zero3-img28.png|468x173px]]</p></li>
<li><p>如果下载的是需要安装版本的balenaEtcher，请先安装再使用。如果下载的Portable版本balenaEtcher，直接双击打开即可，打开后的balenaEtcher界面如下图所示</p>
<p>[[File:media/image29zero3-img29.png|335x211px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<big>'''打开balenaEtcher时如果提示下面的错误：'''</big>
[[File:media/image30zero3-img30.png|206x162pxcenter]]
<big>'''请选择balenaEtcher后点击右键，然后选择以管理员身份运行。'''</big>
[[File:media/image31zero3-img31.png|114x37pxcenter]]
|}
</li></ol>
<li><p>然后选择TF卡的盘符</p></li>
<li><p>最后点击Flash就会开始烧录Linux镜像到TF卡中</p>
<p>[[File:media/image32zero3-img32.png|501x281px]]</p></li></ol>
</li>
<li><p>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中</p>
<p>[[File:media/image33zero3-img33.png|506x317px]]</p></li>
<li><p>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验</p>
<p>[[File:media/image34zero3-img34.png|519x325px]]</p></li>
<li><p>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了</p>
<p>[[File:media/image35zero3-img35.png|523x324px]]</p></li></ol>
<span id="使用win32diskimager烧录linux镜像的方法"></span>
<div class="figure">
[[File:media/image36zero3-img36.png|209x228px|选区_199]]
</div></li>
<li><p>然后点击”'''Format'''”，格式化前会弹出一个警告框，选择”'''是(Y)'''”后就会开始格式化</p></li>
[[File:media/image37zero3-img37.png|304x147px]]
</ol>
<ol start="5" style="list-style-type: lower-alpha;">
<li><p>格式化完TF卡后会弹出下图所示的信息，点击确定即可</p>
<p>[[File:media/image38zero3-img38.png|186x149px]]</p></li></ol>
</li></ol>
<!-- -->
<li><p>b) 然后确认下TF卡的盘符和”'''设备'''”一栏中显示的一致</p></li>
<li><p>c) 最后点击”'''写入'''”即可开始烧录</p>
<p>[[File:media/image39zero3-img39.png|297x206px]]</p></li></ol>
</li>
<li><p>镜像写入完成后，点击”'''退出'''”按钮退出即可，然后就可以拔出TF卡插到开发板中启动</p></li></ol>
<ol start="4" style="list-style-type: decimal;">
<li><p>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方</p>
<p>[[File:media/image27zero3-img27.png|489x235px]]</p></li>
<li><p>然后选择下载Linux版本的软件即可</p>
<p>[[File:media/image40zero3-img40.png|485x184px]]</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;"
</li>
<li><p>然后在Ubuntu PC的图形界面双击'''balenaEtcher-1.14.3-x64.AppImage'''即可打开balenaEtcher（'''无需安装'''），balenaEtcher打开后的界面显示如下图所示</p>
<p>[[File:media/image41zero3-img41.png|423x251px]]</p></li>
<li><p>使用balenaEtcher烧录Linux镜像的具体步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>然后选择TF卡的盘符</p></li>
<li><p>最后点击Flash就会开始烧录Linux镜像到TF卡中</p>
<p>[[File:media/image42zero3-img42.png|431x278px]]</p></li></ol>
</li>
<li><p>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中</p>
<p>[[File:media/image43zero3-img43.png|576x247px]]</p></li></ol>
<!-- -->
<ol start="11" style="list-style-type: decimal;">
<li><p>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验</p>
<p>[[File:media/image44zero3-img44.png|576x252px]]</p></li>
<li><p>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了</p>
<p>[[File:media/image45zero3-img45.png|576x340px]]</p></li></ol>
<span id="烧写android镜像到tf卡的方法"></span>
|-
|
<big>'''开发板的Android镜像只能在Windows平台下使用PhoenixCard软件烧录到TF卡中，PhoenixCard软件的版本必须为PhonixCard开发板的Android镜像只能在Windows平台下使用<span style="color:#FF0000">PhoenixCard</span>软件烧录到TF卡中，PhoenixCard软件的版本必须为<span style="color:#FF0000">PhonixCard-4.2.8。8</span>。'''
'''请不要用烧录Linux镜像的软件，如Win32Diskimager或者balenaEtcher来烧录安卓镜像。'''
<ol style="list-style-type: decimal;">
<li><p>首先请确保Windows系统已经安装了'''Microsoft Visual C++ 2008 Redistrbutable - x86'''</p>
<p>[[File:media/image46zero3-img46.png|449x293px]]</p></li>
<li><p>如果没有安装'''Microsoft Visual C++ 2008 Redistrbutable - x86'''，使用'''PhoenixCard'''格式化TF卡或者烧录Android镜像会提示下面的错误</p>
<div class="figure">
[[File:media/image47zero3-img47.png|522x395px|NUQB$Q%(){1CV6M6WK4N`5J]]
</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:media/image48zero3-img48.png|240x93px]] [[File:media/image49zero3-img49.png|200x95px]]</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:media/image50zero3-img50.png|575x169px]]</p></li>
<li><p>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”'''.img'''” 结尾的文件就是Android镜像文件，大小在1GB以上。如果不知道怎么解压Android镜像的压缩包，可以安装一个[https://yasuo.360.cn/ '''360压缩软件''']来解压镜像。</p>
<p>[[File:media/image51zero3-img51.png|438x158px]]</p></li>
<li><p>然后使用解压软件解压'''PhonixCard4.2.8.zip'''，此软件无需安装，在解压后的文件夹中找到PhoenixCard打开即可</p>
<p>[[File:media/image52zero3-img52.png|576x113px]]</p></li>
<li><p>打开PhoenixCard后，如果TF卡识别正常，会在中间的列表中显示TF卡的盘符和容量，'''<span style="color:#FF0000">请务必确认显示的盘符和你想烧录的TF卡的盘符是一致的</span>'''，如果没有显示可以尝试拔插下TF卡，或者点击PhoenixCard中的”'''刷新盘符'''”按钮</p></li>
[[File:media/image53zero3-img53-1.png|575x137px]]
</ol>
<ol start="10" style="list-style-type: decimal;">
<li><p>确认完盘符后，先格式化TF卡，点击PhoenixCard中”'''恢复卡'''”按钮即可（如果”'''恢复卡'''”按钮为灰色的无法按下，可以先点击下”'''刷新盘符'''”按钮）</p>
<p>[[File:media/image54zero3-img54-1.png|575x316px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<li><p>在”'''制作卡的种类'''”中选择”'''启动卡'''”</p></li>
<li><p>然后点击”'''烧卡'''”按钮就会开始烧录</p>
<p>[[File:media/image55zero3-img55-1.png|576x402px]]</p></li></ol>
</li>
<li><p>烧录完后PhoenixCard的显示如下图所示，此时点击”'''关闭'''”按钮即可退出PhoenixCard，然后就可以把TF卡从电脑中拔出来插到开发板中启动了</p>
<p>[[File:media/image56zero3-img56-1.png|575x354px]]</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:media/image57zero3-img57.png|193x45pxcenter]]</p>
<big><p>'''安卓系统启动后，使用下面的命令可以看到TF卡中的这二十几个分区：'''</p></big>
<p>[[File:media/image58zero3-img58.png|368x131pxcenter]]</p>
<big><p>'''使用df -h命令可以看到16GB的TF卡烧录完安卓系统后大概还有11 GB的空间可以用使用（二十几个分区并不会都挂载到安卓系统中，重点关注这些能看到的分区即可）。'''</p></big>
<p>[[File:media/image59zero3-img59.png|391x220pxcenter]]</p>
|}
</li></ol>
开发板上有一个16MB大小的SPI Flash，其所在位置如下图所示：
[[File:media/image60zero3-img60-1.png|285x185px]]
SPI Flash中默认烧录有一个微型的linux系统，此系统主要用于证明开发板是能正常启动的。当拿到开发板后，不用烧录系统到TF卡中，只需要给开发板接上Type-C电源就能启动SPI Flash中的微型linux系统。此系统的主要功能有：
<ol style="list-style-type: decimal;">
<li><p>首先需要准备一个'''3.3v'''的USB转TTL模块，然后将USB转TTL模块的USB接口一端插入到电脑的USB接口中</p>
<p>[[File:media/image61zero3-img61.png|575x245px]]</p></li>
<li><p>开发板的调试串口GND、TX和RX引脚的对应关系如下图所示</p>
<p>[[File:media/image62zero3-img62-1.png|328x185px]]</p></li>
<li><p>USB转TTL模块GND、TX和RX引脚需要通过杜邦线连接到开发板的调试串口上</p>
<ol style="list-style-type: lower-alpha;">
</li>
<li><p>USB转TTL模块连接电脑和Orange Pi开发板的示意图如下所示</p>
<p>[[File:media/image63zero3-img63.png|576x208px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
</li>
<li><p>执行putty命令后会弹出下面的界面</p>
<p>[[File:media/image64zero3-img64.png|332x290px]]</p></li>
<li><p>首先选择串口的设置界面</p>
<p>[[File:media/image65zero3-img65.png|337x297px]]</p></li>
<li><p>然后设置串口的参数</p>
<ol style="list-style-type: lower-alpha;">
<li><p>设置'''Speed(baud)'''为'''115200'''（串口的波特率）</p></li>
<li><p>设置'''Flow control'''为'''None'''</p>
<p>[[File:media/image66zero3-img66.png|398x352px]]</p></li></ol>
</li>
<li><p>在串口的设置界面设置完后，再回到Session界面</p>
<li><p>首先选择'''Connection type'''为'''Serial'''</p></li>
<li><p>然后点击'''Open'''按钮连接串口</p>
<p>[[File:media/image67zero3-img67.png|375x332px]]</p></li></ol>
</li>
<li><p>然后启动开发板，就能从打开的串口终端中看到系统输出的Log信息了</p>
<p>[[File:media/image68zero3-img68.png|376x249px]]</p></li></ol>
<span id="windows平台调试串口的使用方法"></span>
</li>
<li><p>进入MobaXterm下载网页后点击'''GET XOBATERM NOW!'''</p>
<p>[[File:media/image69zero3-img69.png|382x233px]]</p></li>
<li><p>然后选择下载Home版本</p>
<p>[[File:media/image70zero3-img70.png|353x231px]]</p></li>
<li><p>然后选择Portable便携式版本，下载完后无需安装，直接打开就可以使用</p>
<div class="figure">
[[File:media/image71zero3-img71.png|322x175px|选区_232]]
</div></li></ol>
</li>
<li><p>下载完后使用解压缩软件解压下载的压缩包，即可得到MobaXterm的可执软件，然后双击打开</p>
<p>[[File:media/image72zero3-img72.png|576x83px]]</p></li>
<li><p>打开软件后，设置串口连接的步骤如下</p>
<ol style="list-style-type: lower-alpha;">
<li><p>最后点击”'''OK'''”按钮完成设置</p></li>
[[File:media/image73zero3-img73.png|575x291px1400px]]</ol>
</li></ol>
<ol start="4" style="list-style-type: decimal;">
<li><p>点击”'''OK'''”按钮后会进入下面的界面，此时启动开发板就能看到串口的输出信息了</p>
<p>[[File:media/image74zero3-img74.png|575x291px1400px]]</p></li></ol>
== 使用开发板26pin或13pin接口中的5v引脚供电说明 ==
<div class="figure">
[[File:media/image75zero3-img75.jpeg|216x154px|4ff86e49b6624616f9498fe44c366f29png]]
</div>
<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:media/image24zero3-img24-1.png|163x174px]]</p></li></ol>
</li></ol>
<ol style="list-style-type: decimal;">
<li><p>如果有购买Orange Pi的13pin扩展板，将扩展板插入开发板的13pin接口中，就可以扩展2个USB接口</p>
<p>[[File:media/image18zero3-img18.png|246x162px]]</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:media/image76zero3-img76.png|208x162px]] [[File:media/image77zero3-img77.png|237x165px]]</p></li>
<li><p>13pin接口的原理图如下所示</p>
<p>[[File:media/image19zero3-img19.png|265x142px]] [[File:media/image78zero3-img78.png|245x133px]]</p></li>
<li><p>USB2的接线如下所示</p>
<p>[[File:media/image79zero3-img79.png|256x189px]]</p></li>
<li><p>USB3的接线如下所示</p>
<p>[[File:media/image80zero3-img80.png|255x195px]]</p></li>
<li><p>如果需要在13pin接口上同时接两个USB设备，会发现13pin接口上的5V和GND引脚不够用，此时其中一个USB设备可以使用26pin接口中的5V和GND引脚，位置如下图所示：</p>
<p>[[File:media/image24zero3-img24-1.png|243x260px]]</p></li></ol>
</li></ol>
| style="text-align: left;"| '''支持'''
|-
| style="text-align: left;"| '''Ubuntu 22.04 - Focal<span style="color:#FF0000">Jammy</span>'''
| style="text-align: left;"| '''Linux5.4'''
| style="text-align: left;"| '''支持'''
<div class="figure">
[[File:media/image81zero3-img81.png|236x108px|659B0DE6-F15C-4005-A5F9-DFF881EE647B]]
</div>
<ol style="list-style-type: decimal;">
<li><p>linux系统默认就是自动登录终端的，默认登录的用户名是'''orangepi'''</p>
<p>[[File:media/image82zero3-img82.png|475x240px]]</p></li>
<li><p>使用下面的命令可以设置root用户自动登录终端</p>
{| class="wikitable" style="width:800px;"
<div class="figure">
[[File:media/image83zero3-img83.png|576x324px|1]]
</div></li>
<div class="figure">
[[File:media/image84zero3-img84.png|569x320px|IMG_256]]
</div>
</li>
<li><p>然后重启系统，就会自动使用root用户登录桌面了</p>
<p>[[File:media/image85zero3-img85.png|294x123px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''disable-leds'''</p>
<p>[[File:media/image88zero3-img88.png|397x35px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li>
<li><p>重启后完全进入系统就可以看到开发板上的两个LED灯都不会亮了</p></li></ol>
</li></ol>
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况</p>
<p>[[File:media/image92zero3-img92.png|575x210px]]</p></li>
<li><p>上图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配</p></li></ol>
</li>
<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:media/image93zero3-img93.png|575x211px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况。下图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配</p>
<p>[[File:media/image92zero3-img92.png|575x210px]]</p></li>
<li><p>然后选中rootfs分区（/dev/sdc1）</p>
<p>[[File:media/image94zero3-img94.png|575x211px]]</p></li>
<li><p>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区</p>
<p>[[File:media/image95zero3-img95.png|436x298px]]</p></li>
<li><p>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始扩容rootfs分区的大小</p>
<p>[[File:media/image96zero3-img96.png|444x302px]]</p></li>
<li><p>'''Resize/Move'''选项打开后会弹出下面的设置界面</p>
<p>[[File:media/image97zero3-img97.png|315x193px]]</p></li><li><p>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New siezesize(MiB)'''中的数字来设置rootfs分区的大小</p><p>[[File:media/image98zero3-img98.png|320x191px]]</p></li>
<li><p>设置好容量后，再点击右下角的'''Resize/Move'''即可</p>
<p>[[File:media/image99zero3-img99.png|327x196px]]</p></li>
<li><p>最后确认无误后，再点击下图所示的'''绿色 <span style="color:green">√</span>'''</p>
<p>[[File:media/image100zero3-img100.png|392x270px]]</p></li>
<li><p>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量</p>
<p>[[File:media/image101zero3-img101.png|399x116px]]</p></li>
<li><p>扩容完成后点击'''Close'''关闭即可</p>
<p>[[File:media/image102zero3-img102.png|399x172px]]</p></li>
<li><p>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明手动扩容成功</p>
{| class="wikitable" style="width:800px;"
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况</p>
<p>[[File:media/image103zero3-img103.png|575x217px]]</p></li>
<li><p>然后选中rootfs分区（/dev/sdc1）</p>
<p>[[File:media/image104zero3-img104.png|575x217px]]</p></li>
<li><p>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区</p>
<p>[[File:media/image105zero3-img105.png|400x274px]]</p></li>
<li><p>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始设置rootfs分区的大小</p>
<p>[[File:media/image106zero3-img106.png|399x273px]]</p></li>
<li><p>'''Resize/Move'''选项打开后会弹出下面的设置界面</p>
<p>[[File:media/image107zero3-img107.png|315x188px]]</p></li><li><p>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New siezesize(MiB)'''中的数字来设置rootfs分区的大小</p><p>[[File:media/image98zero3-img98.png|318x190px]]</p></li></ol>
<!-- -->
<ol start="18" style="list-style-type: decimal;">
<li><p>设置好容量后，再点击右下角的'''Resize/Move'''即可</p>
<p>[[File:media/image99zero3-img99.png|327x196px]]</p></li>
<li><p>最后确认无误后，再点击下图所示的'''绿色 <span style="color:green">√</span>'''</p>
<p>[[File:media/image100zero3-img100.png|392x270px]]</p></li>
<li><p>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量</p>
<p>[[File:media/image101zero3-img101.png|365x106px]]</p></li>
<li><p>扩容完成后点击'''Close'''关闭即可</p>
<p>[[File:media/image102zero3-img102.png|379x164px]]</p></li>
<li><p>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明缩小容量成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<big><p>'''下面的命令请不要照抄，比如debian12中的网络节点名为end0，下面的命令就需要修改为ping www.baidu.com -I end0。end0。（这里是大写的字母I，不是小写的字母L）'''</p></big>
|}
{| class="wikitable" style="width:800px;"
<li><p>先登录linux系统，有下面三种方式</p>
<ol style="list-style-type: lower-alpha;">
<li>如果开发板连接了网线，可以通过[[Orange Pi Zero 3#Ubuntu下SSH远程登录开发板|'''ssh远程登录linux系统''']]</li></ol>
<!-- -->
<div class="figure">
[[File:media/image108zero3-img108.png|575x250px|选区_011]]
</div></li>
|-
|
<p>orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0 （这里是大写的字母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>
<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命令打开的界面如下所示</p>
<p>[[File:media/image109zero3-img109.png|345x215px]]</p></li>
<li><p>选择'''Activate a connect'''后回车</p>
<p>[[File:media/image110zero3-img110.png|349x216px]]</p></li>
<li><p>然后就能看到所有搜索到的WIFI热点</p>
<p>[[File:media/image111zero3-img111.png|360x229px]]</p></li>
<li><p>选择想要连接的WIFI热点后再使用Tab键将光标定位到'''Activate'''后回车</p>
<p>[[File:media/image112zero3-img112.png|366x230px]]</p></li>
<li><p>然后会弹出输入密码的对话框，在'''Pssword'''内输入对应的密码然后回车就会开始连接WIFI</p>
<p>[[File:media/image113zero3-img113.png|352x225px]]</p></li>
<li><p>WIFI连接成功后会在已连接的WIFI名称前显示一个”*”</p>
<p>[[File:media/image114zero3-img114.png|349x223px]]</p></li>
<li><p>通过'''ip a s wlan0'''命令可以查看wifi的IP地址</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0 （这里是大写的字母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>
<ol style="list-style-type: decimal;">
<li><p>点击桌面右上角的网络配置图标（测试WIFI时请不要连接网线）</p>
<p>[[File:media/image115zero3-img115.png|275x121px]]</p></li>
<li><p>在弹出的下拉框中点击'''More networks'''可以看到所有扫描到的WIFI热点，然后选择想要连接的WIFI热点</p>
<p>[[File:media/image116zero3-img116.png|576x353px]]</p></li>
<li><p>然后输入WIFI热点的密码，再点击'''Connect'''就会开始连接WIFI</p>
<p>[[File:media/image117zero3-img117.png|288x147px]]</p></li>
<li><p>连接好WIFI后，可以打开浏览器查看是否能上网，浏览器的入口如下图所示</p>
<p>[[File:media/image118zero3-img118.png|465x249px]]</p></li>
<li><p>打开浏览器后如果能打开其他网页说明WIFI连接正常</p>
<div class="figure">
[[File:media/image119zero3-img119.png|576x273px|5]]
</div></li></ol>
</li>
<li><p>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击 '''orangepi'''连接热点，密码就是上面设置的'''orangepi'''</p>
<p>[[File:media/image120zero3-img120.png|230x183px]]</p></li>
<li><p>连接成功后的显示如下图所示</p>
<p>[[File:media/image121zero3-img121.png|233x111px]]</p></li>
<li><p>在NAT模式下，连接到开发板热点的无线设备是向开发板的DHCP服务请求IP地址的，所以会有两个不同的网段，如这里开发板的IP是192.168.1.X</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|}
<p>而开发板的DHCP服务默认会给接入热点的设备分配'''192.168.12.0/24'''的IP地址，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址是'''192.168.12.X'''。</p>
<p>[[File:media/image121zero3-img121.png|271x129px]]</p><p>[[File:media/image122zero3-img122-1.png|274x155px]]</p></li>
<li><p>如果想要为接入的设备指定不同的网段，可以通过-g参数指定，如通过-g参数指定接入点AP的网段为192.168.2.1</p>
此时通过手机连接到热点后，点击已经连接的WIFI热点'''orangepi'''，然后可以看到手机的IP地址是'''192.168.2.X'''。
[[File:media/image121zero3-img121.png|286x137px]]
[[File:media/image123zero3-img123.png|302x174px]]
</li></ol>
<ol start="7" style="list-style-type: decimal;">
此时手机是搜索不到WIFI热点的，需要手动指定WIFI热点名称，并输入密码来连接WIFI热点
[[File:media/image124zero3-img124.png|237x198px]]
</li></ol>
<span id="create_ap以bridge模式创建wifi热点的方法"></span>
</li>
<li><p>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击'''orangepi'''连接热点，密码就是上面设置的'''orangepi'''</p>
<p>[[File:media/image120zero3-img120.png|265x211px]]</p></li>
<li><p>连接成功后的显示如下图所示</p>
<p>[[File:media/image121zero3-img121.png|273x130px]]</p></li>
<li><p>在bridge模式下，连接到开发板热点的无线设备也是向主路由（开发板连接的路由器）的DHCP服务请求IP地址的，如这里开发板的IP是'''192.168.1.X'''</p>
{| class="wikitable" style="width:800px;"
|}
<p>而接入WIFI热点的设备的IP也是由主路由分配的，所以连接WIFI热点的手机和开发板处于相同的网段，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址也是'''192.168.1.X'''。</p>
<p>[[File:media/image121zero3-img121.png|284x136px]]</p><p>[[File:media/image125zero3-img125.png|282x159px]]</p></li>
<li><p>在不指定'''--freq-band'''参数的情况下，默认创建的热点是2.4G频段的，如果想要创建5G频段的热点可以通过'''--freq-band 5'''参数指定，具体命令如下</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
此时手机是搜索不到WIFI热点的，需要手动指定WIFI热点名称，并输入密码来连接WIFI热点
[[File:media/image124zero3-img124.png|228x191px]]
</li></ol>
<span id="设置静态ip地址的方法"></span>
</li>
<li><p>然后选择'''Edit a connection'''并按下回车键</p>
<p>[[File:media/image126zero3-img126.png|227x247px]]</p></li>
<li><p>然后选择需要设置静态IP地址的网络接口，比如设置'''Ethernet'''接口的静态IP地址选择'''Wired connection 1'''就可以了</p>
<p>[[File:media/image127zero3-img127.png|310x149px]]</p></li>
<li><p>然后通过'''Tab'''键选择'''Edit'''并按下回车键</p>
<p>[[File:media/image128zero3-img128.png|316x144px]]</p></li>
<li><p>然后通过Tab键将光标移动到下图所示的'''<Automatic>'''位置进行IPv4的配置</p>
<p>[[File:media/image129zero3-img129.png|575x240px]]</p></li>
<li><p>然后回车，通过上下方向键选择'''Manual'''，然后回车确定</p>
<p>[[File:media/image130zero3-img130.png|576x237px]]</p></li>
<li><p>选择完后的显示如下图所示</p>
<p>[[File:media/image131zero3-img131.png|575x240px]]</p></li>
<li><p>然后通过Tab键将光标移动到'''<Show>'''</p>
<p>[[File:media/image132zero3-img132.png|576x241px]]</p></li>
<li><p>然后回车，回车后会弹出下面的设置界面</p>
<p>[[File:media/image133zero3-img133.png|575x450px]]</p></li>
<li><p>然后就可以在下图所示的位置设置IP地址(Addresses)、网关(Gateway)和DNS服务器的地址（里面还有很多其他设置选项，请自行探索），'''<span style="color:#FF0000">请根据自己的具体需求来设置，下图中设置的值只是一个示例</span>'''</p>
<p>[[File:media/image134zero3-img134-1.png|576x233px]]</p></li>
<li><p>设置完后将光标移动到右下角的'''<OK>'''，然后回车确认</p>
<p>[[File:media/image135zero3-img135.png|576x116px]]</p></li>
<li><p>然后点击'''<Back>'''回退到上一级选择界面</p>
<p>[[File:media/image136zero3-img136.png|330x325px]]</p></li>
<li><p>然后选择'''Activate a connection'''，再将光标移动到'''<OK>'''，最后点击回车</p>
<p>[[File:media/image137zero3-img137.png|331x248px]]</p></li>
<li><p>然后选择需要设置的网络接口，比如'''Wired connection 1'''，然后将光标移动到'''<Deactivate>'''，再按下回车键禁用'''Wired connection 1'''</p>
<p>[[File:media/image138zero3-img138.png|576x224px]]</p></li>
<li><p>然后请不要移动光标，再按下回车键重新使能'''Wired connection 1'''，这样前面设置的静态IP地址就会生效了</p>
<p>[[File:media/image139zero3-img139.png|576x224px]]</p></li>
<li><p>然后通过'''<Back>'''和'''Quit'''按钮就可以退出nmtui</p>
<p>[[File:media/image140zero3-img140.png|300x253px]] [[File:media/image141zero3-img141.png|227x252px]]</p></li>
<li><p>然后通过'''ip a s eth0'''就能看到网口的IP地址已经变成前面设置的静态IP地址了</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<span id="使用nmcli命令来设置静态ip地址"></span>
==== 使用nmcli命令来设置静态IP地址 ====
<ol start="3" style="list-style-type: decimal;">
<li><p>成功登录系统后的显示如下图所示</p>
<p>[[File:media/image142zero3-img142.png|575x273px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<li><p>然后在'''Specify username'''中输入linux系统的用户名'''root'''或'''orangepi'''</p></li>
<li><p>最后点击'''OK'''即可</p>
<p>[[File:media/image143zero3-img143.png|576x292px]]</p></li></ol>
</li>
<li><p>然后会提示输入密码，默认root和orangepi用户的密码都为orangepi</p>
<big><p>'''注意，输入密码的时候，<span style="color:#FF0000">屏幕上是不会显示输入的密码的具体内容的</span>，请不要以为是有什么故障，输入完后直接回车即可。'''</p></big>
|}
<p>[[File:media/image144zero3-img144.png|575x157px]]</p></li>
<li><p>成功登录系统后的显示如下图所示</p>
<p>[[File:media/image145zero3-img145.png|559x388px]]</p></li></ol>
<span id="hdmi测试"></span>
<div class="figure">
[[File:media/image13zero3-img13.jpeg|151x151px|IMG_6109(20211221-181051)png]]
</div></li>
<ol style="list-style-type: lower-alpha;">
<li><p>HDMI转VGA转换器</p>
<p>[[File:media/image146zero3-img146.png|155x104px]]</p></li>
<li><p>一根VGA线和一根Micro HDMI公转HDMI母转接线</p>
<p>[[File:media/image147zero3-img147.png|148x133px400px]] [[File:media/image148zero3-img148.jpegpng|157x139px|IMG_6140(20220104-134930)400px]]</p></li>
<li><p>一个支持VGA接口的显示器或者电视</p></li></ol>
</li>
<li><p>HDMI转VGA显示测试如下所示</p>
<p>[[File:media/image149zero3-img149.png|574x336px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<p>orangepi@orangepi:~$ '''sudo cat /sys/class/disp/disp/attr/sys'''</p>
|}
<p>[[File:media/image150zero3-img150.png|575x84px]]</p></li></ol>
<span id="linux5.4系统framebuffer宽度和高度的修改方法"></span>
<ol style="list-style-type: decimal;">
<li><p>点击桌面右上角的蓝牙图标</p>
<p>[[File:media/image151zero3-img151.png|314x122px]]</p></li>
<li><p>然后选择适配器</p>
<p>[[File:media/image152zero3-img152.png|318x140px]]</p></li>
<li><p>如果有提示下面的界面，请选择'''Yes'''</p>
<p>[[File:media/image153zero3-img153.png|248x85px]]</p></li>
<li><p>然后在蓝牙的适配器设置界面中设置'''Visibility Setting'''为'''Always visible'''，然后关闭即可</p>
<p>[[File:media/image154zero3-img154.png|196x183px]]</p></li>
<li><p>然后打开蓝牙设备的配置界面</p>
<p>[[File:media/image155zero3-img155.png|438x179px]]</p></li>
<li><p>点击'''Search'''即可开始扫描周围的蓝牙设备</p>
<p>[[File:media/image156zero3-img156.png|311x210px]]</p></li>
<li><p>然后选择想要连接的蓝牙设备，再点击鼠标右键就会弹出对此蓝牙设备的操作界面，选择'''Pair'''即可开始配对，这里演示的是和Android手机配对</p>
<p>[[File:media/image157zero3-img157.png|311x242px]]</p></li>
<li><p>配对时，桌面的右上角会弹出配对确认框，选择'''Confirm'''确认即可，此时手机上也同样需要进行确认</p>
<p>[[File:media/image158zero3-img158.png|411x150px]]</p></li>
<li><p>和手机配对完后，可以选择已配对的蓝牙设备，然后右键选择'''Send a File'''即可开始给手机发送一张图片</p>
<p>[[File:media/image159zero3-img159.png|405x239px]]</p></li>
<li><p>发送图片的界面如下所示</p>
<p>[[File:media/image160zero3-img160.png|399x231px]]</p></li></ol>
=== 服务器版镜像的使用方法 ===
</li>
<li><p>配对成功后，手机蓝牙界面的显示如下所示</p>
<p>[[File:media/image161zero3-img161.png|189x167px]]</p></li>
<li><p>连接蓝牙设备需要安装 '''pulseaudio-module-bluetooth'''软件包，然后再启动'''pulseaudio''' 服务</p>
{| class="wikitable" style="width:800px;"
<p>orangepi@orangepi:~$ '''sudo bluetoothctl'''</p>
<p>Agent registered</p>
<p>[bluetooth]# '''paired-devices #查看已配对的蓝牙设备的MAC地址'''</p>
<p>Device DC:72:9B:4C:F4:CF orangepi</p>
<p>[bluetooth]# '''connect DC:72:9B:4C:F4:CF #使用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>[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]# #出现这个提示符说明连接成功'''</p>
|}
</li>
<div class="figure">
[[File:media/image162zero3-img162.jpeg|223x232px|Screenshot_20201205_142413png]]
</div></li></ol>
<div class="figure">
[[File:media/image163zero3-img163.png|575x279px|选区_021]]
</div></li></ol>
<div class="figure">
[[File:media/image164zero3-img164.jpeg|126x125px|IMG_256png]]
</div></li>
<ol style="list-style-type: decimal;">
<li><p>首先打开文件管理器</p>
<p>[[File:media/image165zero3-img165.png|257x126px]]</p></li>
<li><p>然后找到下面这个文件（如果系统中没有这个音频文件，可以自己上传一个音频文件到系统中）</p>
<p>[[File:media/image166zero3-img166.png|238x189px]]</p></li>
<li><p>然后选中audio.wav文件，右键选择使用vlc打开就可以开始播放</p>
<p>[[File:media/image167zero3-img167.png|241x195px]]</p></li>
<li><p>切换HDMI播放和耳机播放等不同音频设备的方法</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先打开音量控制界面</p>
<p>[[File:media/image168zero3-img168.png|294x161px]]</p></li>
<li><p>播放音频的时候，在'''Playback'''中会显示播放软件可以使用的音频设备选项，如下图所示，在这里可以设置需要播放到哪个音频设备</p>
<div class="figure">
[[File:media/image169zero3-img169.png|576x324px|4]]
</div></li></ol>
<div class="figure">
[[File:media/image164zero3-img164.jpeg|164x163px|IMG_256png]]
</div></li>
<div class="figure">
[[File:media/image170zero3-img170.jpeg|140x131px|IMG_256png]]
</div></li>
== 温度传感器 ==
=== linux5.4系统查看温度的方法 ===
# H618总共有4个温度传感器，查看温度的命令如下所示：
</li></ol>
{| class="wikitable" style="width:800px;"
temp1: +'''<span style="color:#FF0000">47.2°C</span>''' (crit = +110.0°C)
|}
<span id="pin扩展板接口引脚说明"></span>
<ol style="list-style-type: decimal;">
<li><p>开发板13 pin扩展板接口引脚的顺序请参考下图</p>
<p>[[File:media/image78zero3-img78.png|245x133px]]</p></li>
<li><p>开发板13pin接口的原理图如下所示</p>
<p>[[File:media/image19zero3-img19.png|359x193px]]</p></li>
<li><p>开发板13 pin扩展板接口引脚的功能说明如下</p>
<ol style="list-style-type: lower-alpha;">
<ol style="list-style-type: decimal;">
<li><p>Orange Pi Zero 3开发板26 pin接口引脚的顺序请参开发板上的丝印图</p>
<p>[[File:media/image171zero3-img171-1.png|389x125px]]</p></li>
<li><p>开发板26 pin接口引脚的功能如下表所示</p></li>
<div style="display: flex;">{| class="wikitable" style="width:800px300px;margin-right: 20px"
|-
| style="text-align: left;"| '''GPIO序号'''
| 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;"| '''TWI3-SDA'''
| style="text-align: left;"| '''3'''
|-
| style="text-align: left;"| '''228'''
| 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;"| '''7'''
|-
| 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;"| '''11'''
|-
| style="text-align: left;"| '''69'''
| style="text-align: left;"| '''PC5'''
| style="text-align: left;"| '''13'''
|-
| style="text-align: left;"| '''72'''
| style="text-align: left;"| '''PC8'''
| style="text-align: left;"| '''15'''
|-
| 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;"| '''SPI1_MISO'''
| style="text-align: left;"| '''21'''
|-
| style="text-align: left;"| '''230'''
| style="text-align: left;"| '''SPI1_CLK'''
| style="text-align: left;"| '''23'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''25'''
|}
|-
| <big>style="text-align: left;"| '''注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。4''' | style="text-align: left;"| '''编译好的wiringOP的deb包在orangepi-build中的存放路径为：5V'''| style="text-align: left;"|'''<span | style="colortext-align:blueleft;">orangepi||-build/external/cache/debs/arm64/wiringpi_x.xx.deb</span>| style="text-align: left;"| '''6''' | style="text-align: left;"| '''进入系统后可以运行下gpio readall命令，如果能看到下面的输出，说明wiringOP已经预装并且能正常使用。GND'''| style="text-align: left;"|[[File| style="text-align:media/image172.pngleft;"|575x365px]]|-| style="text-align: left;"| '''wiringOP目前主要适配了设置GPIO口输入输出，设置GPIO口输出高低电平以及设置上下拉电阻的功能，像硬件PWM这样的功能是用不了的。8'''</big>|} <ol style="list-styletext-typealign: decimalleft;">| '''UART5_TX'''<li><p>下载wiringOP的代码</p>{| classstyle="wikitabletext-align: left;" | '''PH2'''| style="widthtext-align:800pxleft;" | '''226'''
|-
| <p>orangepi@orangepistyle="text-align:~$ left;"| '''sudo apt update10'''</p><p>orangepi@orangepi| style="text-align:~$ left;"| '''sudo apt install -y gitUART5_RX'''</p><p>orangepi@orangepi| style="text-align:~$ left;"| '''git clone https://github.com/orangepi-xunlong/wiringOP.git -b nextPH3'''</p>|} {| class="wikitable" style="backgroundtext-coloralign:#ffffdc;width:800pxleft;" | '''227'''
|-
| <big><p>style="text-align: left;"| '''注意，源码需要下载wiringOP next分支的代码，请别漏了-b next这个参数。12'''</p><p>| style="text-align: left;"| '''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/usr/src/wiringOP。PC11'''</p></big>|}</li><li><p>编译安装wiringOP</p>{| classstyle="wikitabletext-align: left;" | '''PC11'''| style="widthtext-align:800pxleft;" | '''75'''
|-
| <p>orangepi@orangepistyle="text-align:~$ left;"| '''cd wiringOP14'''</p><p>orangepi@orangepi| style="text-align:~/wiringOP$ left;"| '''sudo ./build cleanGND'''</p><p>orangepi@orangepi| style="text-align:~/wiringOP$ '''sudo ./build'''</p>left;"||}</li><li><p>测试gpio readall命令的输出如下</p><ol style="list-styletext-typealign: lower-alphaleft;">|<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="colortext-align:#FF0000left;">28、30、32、34号引脚为空，请直接忽略</span>| '''16'''</p><p>[[File:media/image172.png|575x365px]]</p></li></ol></li></ol> <span id="pin接口gpioi2cuartspi和pwm测试"></span> == 26pin接口GPIO、I2C、UART、SPI和PWM测试 == <span idstyle="pintext-gpio口测试align: left;"></span>| '''PC15'''=== 26pin GPIO口测试 === <ol | style="listtext-style-typealign: decimalleft;"><li><p>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的高低电平</p><p>[[File:media/image173.png|576x128px]]</p></li><li><p>首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号</p>'''PC15'''{| class="wikitable" style="widthtext-align:800pxleft;" | '''79'''
|-
| <p>root@orangepistyle="text-align:~/wiringOP# left;"| '''18'''gpio mode <span | style="colortext-align:#FF0000left;">2</span> out| '''PC14'''</p>|}</li><li><p>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>{| classstyle="wikitabletext-align: left;" | '''PC14'''| style="widthtext-align:800pxleft;" | '''78'''
|-
| <p>root@orangepistyle="text-align:~/wiringOP# left;"| '''gpio write 2 <span 20'''| style="colortext-align:#FF0000left;">0</span>| '''GND'''</p>|}<p>使用gpio readall可以看到7号引脚的值(V)变为了0</p><p>[[Filestyle="text-align:media/image174.pngleft;"|575x128px]]</p></li><li><p>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功</p>{| class="wikitable" style="widthtext-align:800pxleft;" |
|-
| 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><p/ol>root@orangepi<ol start="3" style="list-style-type:~/wiringOP# decimal;"><li>26pin接口中总共有'''17'''个GPIO口，所有GPIO口的电压都是'''gpio write 2 <span style="color:#FF0000">13.3v</span>'''</pli></ol>|}<pspan id="安装wiringop的方法">使用gpio readall可以看到7号引脚的值(V)变为了1</pspan><p>[[File== 安装wiringOP的方法 == {| class="wikitable" style="background-color:#ffffdc;width:media/image175.png800px;" |-|575x130px]]</p></libig>'''注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。''' '''编译好的wiringOP的deb包在orangepi-build中的存放路径为：''' '''<lispan style="color:blue"><p>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可<orangepi-build/external/cache/debs/p><arm64/li>wiringpi_x.xx.deb</olspan>''' '''进入系统后可以运行下gpio readall命令，如果能看到下面的输出，说明wiringOP已经预装并且能正常使用。'''
<ol style="list-style-type: decimal;">
<li><p>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的上下拉电阻</p><p>[[File:media/image173.png|576x128px]]</p></li><li><p>首先需要设置GPIO口为输入模式，其中第三个参数需要输入引脚对应的wPi的序号下载wiringOP的代码</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>rootorangepi@orangepi:~$ '''sudo apt update'''</wiringOP# p><p>orangepi@orangepi:~$ '''sudo apt install -y git'''gpio mode <span style="color:#FF0000"/p>2<p>orangepi@orangepi:~$ '''git clone https:/span> in/github.com/orangepi-xunlong/wiringOP.git -b next'''</p>
|}
|-
|
<big><p>root@orangepi:~/wiringOP# '''gpio mode 注意，源码需要下载wiringOP next分支的代码，请别漏了-b next这个参数。'''<span style="color:#FF0000"/p>2<p>'''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/span> upusr/src/wiringOP。'''</p></big>
|}
</li>
<li><p>然后输入下面的命令读取GPIO口的电平，如果电平为1，说明上拉模式设置成功编译安装wiringOP</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>rootorangepi@orangepi:~/$ '''cd wiringOP# '''gpio read <span style="color:#FF0000"/p>2<p>orangepi@orangepi:~/wiringOP$ '''sudo ./span>build clean'''</p><p>orangepi@orangepi:~/wiringOP$ '''1sudo ./build'''</p>
|}
</li>
<li><p>然后执行下面的命令可以设置GPIO口为下拉模式测试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> downout'''</p>
|}
</li>
<li><p>然后输入下面的命令读取GPIO口的电平，如果电平为0，说明下拉模式设置成功然后设置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 read write 2 <span style="color:#FF0000">21</span>'''</p><p>'''0'''</p>
|}
<p>使用gpio readall可以看到7号引脚的值(V)变为了1</p><p>[[File:zero3-img175.png]]</p></li><li><p>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可</p></li></ol>
<span id="pin-spi测试gpio口上下拉电阻的设置方法"></span>
=== 26pin SPI测试 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:media/image176zero3-img176.png|565x209px]]</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;"
|-
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''spi1-cs1-spidev'''</p>
<p>[[File:media/image177zero3-img177.png|392x57px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了</p>
<ol style="list-style-type: decimal;">
<li><p>由26pin的原理图可知，可用的i2c为i2c3</p>
<p>[[File:media/image178zero3-img178.png|575x204px]]</p></li>
<li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|390x190px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-i2c3'''</p>
<p>[[File:media/image179zero3-img179.png|392x57px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|395x91px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>启动linux系统后，先确认下/dev下存在i2c3的设备节点</p>
<div class="figure">
[[File:media/image180zero3-img180.png|383x151px|选区_460]]
</div></li></ol>
<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的uart为uart5</p>
<p>[[File:media/image181zero3-img181.png|575x203px]]</p></li>
<li><p>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-uart5'''</p>
<p>[[File:media/image182zero3-img182.png|400x60px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点</p>
<big>'''开发板最多可以使用4通道PWM，它们所在引脚的位置如下图所示:'''</big>
[[File:media/image183zero3-img183.png|388x180pxcenter]]
|}
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中pwm对应的配置</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<p>'''PWM3、PWM4和调试串口中的TX、RX引脚是复用的，所以使用PWM3和PWM4（需要选择ph-pwm34）时请将UART0的配置关掉（需要选择disable-uart0），关掉UART0后调试串口就无法使用了。'''</p></big>
|}
<p>[[File:media/image184zero3-img184.png|402x156px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>重启后就可以开始PWM的测试</p>
|}
<ol style="list-style-type: lower-alpha;">
<li><p>在命令行中输入下面的命令可以让pwm1输出一个50Hz的矩形波在命令行中输入下面的命令可以让pwm1输出一个50Hz的方波</p>
{| class="wikitable" style="width:800px;"
|-
</ol>
<ol start="3" style="list-style-type: lower-alpha;">
<li>在命令行中输入下面的命令可以让pwm3输出一个50Hz的矩形波在命令行中输入下面的命令可以让pwm3输出一个50Hz的方波</li>
{| class="wikitable" style="width:800px;"
<div class="figure">
[[File:media/image185zero3-img185.jpeg|574x344px|69D96433378187B10005CDD2A52881B0png]]
</div>
<big>'''wiringOP-Python跟wiringOP一样，也是可以通过指定wPi号来确定操作哪一个GPIO引脚，因为wiringOP-Python中没有查看wPi号的命令，所以只能通过wiringOP中的gpio命令来查看板子wPi号与物理引脚的对应关系。'''</big>
[[File:media/image172zero3-img172.png|575x365px]]
|}
<ol style="list-style-type: decimal;">
<li><p>下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平</p>
<p>[[File:media/image173zero3-img173.png|576x128px]]</p></li>
<li><p>直接用命令测试的步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的spi为spi1</p>
<p>[[File:media/image176zero3-img176.png|565x209px]]</p></li>
<li><p>Linux系统中spi1默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''spi1-cs1-spidev'''</p>
<p>[[File:media/image177zero3-img177.png|392x57px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了</p>
<ol style="list-style-type: decimal;">
<li><p>由26pin的原理图可知，可用的i2c为i2c3</p>
<p>[[File:media/image178zero3-img178.png|575x204px]]</p></li>
<li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-i2c3'''</p>
<p>[[File:media/image179zero3-img179.png|401x59px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>启动linux系统后，先确认下/dev下存在i2c3的设备节点</p>
</li>
<li><p>然后在26pin接头的i2c3引脚上接一个i2c设备，这里以DS1307 RTC模块为例</p>
<p>[[File:media/image186zero3-img186.png|180x153px]]</p></li>
{| class="wikitable" style="width:800px;"
<li>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c设备连接正确</li>
[[File:media/image187zero3-img187.png|388x203px]]
</ol>
<ol start="7" style="list-style-type: decimal;">
<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的uart为uart5</p>
<p>[[File:media/image181zero3-img181.png|575x203px]]</p></li>
<li><p>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-uart5'''</p>
<p>[[File:media/image182zero3-img182.png|400x60px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点</p>
<big><p>'''Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''</p></big>
|}
<p>[[File:media/image188zero3-img188.png|576x209px]]</p></li>
<li><p>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''</p>
<p>[[File:media/image189zero3-img189.png|220x279px]]</p></li>
<li><p>然后按照界面提示根据自己的喜好设置，再点击下一步</p>
<p>[[File:media/image190zero3-img190.png|575x297px]]</p></li>
<li><p>然后点击下一步</p>
<p>[[File:media/image191zero3-img191.png|576x185px]]</p></li>
<li><p>然后点击完成</p>
<p>[[File:media/image192zero3-img192.png|576x117px]]</p></li>
<li><p>Home Assistant最终显示的主界面如下图所示</p>
<p>[[File:media/image193zero3-img193.png|574x294px]]</p></li>
<li><p>停止Home Assistant容器的方法</p>
<ol style="list-style-type: lower-alpha;">
<big><p>'''第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。'''</p></big>
|}
<p>[[File:media/image194zero3-img194.png|576x203px]]</p></li></ol>
<span id="opencv的安装方法"></span>
</li>
<li><p>然后要做的就是耐心等待，当看到终端输出下面的打印信息时，说明宝塔已经安装完成，整个安装过程大约耗时34分钟，根据网络速度的不同可能会有一些差别</p>
<p>[[File:media/image195zero3-img195.png|576x233px]]</p></li>
<li><p>此时在浏览器中输入上面显示的'''面板地址'''就可以打开宝塔Linux面板的登录界面，然后在对应的位置输入上图显示的'''username'''和'''password'''就可以登录进宝塔<br />
[[File:media/image196zero3-img196.png|575x281px]]</p></li>
<li><p>成功登录宝塔后的会弹出下面的欢迎界面，首先请将中间的用户须知阅读完拖到最下面，然后就可以选择”我已同意并阅读《用户协议》“，接着点击”进入面板”就可以进入宝塔了</p>
<p>[[File:media/image197zero3-img197.png|575x317px1200px]]</p></li>
<li><p>进入宝塔后首先会提示需要绑定宝塔官网的账号，如果没有账号可以去宝塔的官网（'''https://www.bt.cn'''）注册一个</p>
<p>[[File:media/image198zero3-img198.png|576x300px]]</p></li>
<li><p>最终显示的界面如下图所示，可以很直观的看到开发板Linux系统的一些状态信息，比如负载状态、CPU的使用率、内存使用率和存储空间的使用情况等</p>
<p>[[File:media/image199zero3-img199.png|575x306px1200px]]</p></li>
<li><p>宝塔的更多功能可以参考下面资料自行探索</p>
{| class="wikitable" style="width:800px;"
</li>
<li><p>face_recognition安装完后会自动下载face_recognition的源码，然后自动运行face_recognition中的一些示例，如果最后能看到桌面上弹出了下面的这些图片就说明face_recognition安装测试成功了</p>
<p>[[File:media/image200zero3-img200.png|576x324px]]</p></li></ol>
=== 手动安装face_recognition的方法 ===
<ol start="3" style="list-style-type: lower-alpha;">
<li><p>然后就可以开始安装dlib，命令如下所示</p>
<ol style="list-style-type: lower-alphanone;"><li><p>a) Ubuntu20.04</p>
{| class="wikitable" style="width:800px;"
|-
|}
</li>
<li><p>b) Ubuntu22.04</p>
{| class="wikitable" style="width:800px;"
|-
|}
</li>
<li><p>c) Debian11</p>
{| class="wikitable" style="width:800px;"
|-
</li>
<li><p>等待一段时间会弹出下面的图片，这就是在测试图片中定位到的人脸</p>
<p>[[File:media/image201zero3-img201.png|575x311px]]</p></li></ol>
</li>
<li><p>'''find_facial_features_in_picture.py'''用来识别单张图片中人脸的关键点，测试步骤如下所示</p>
</li>
<li><p>等待一段时间会弹出下面的图片，可以看到将人脸轮廓都标注出来了</p>
<p>[[File:media/image202zero3-img202.png|575x302px]]</p></li></ol>
</li>
<li><p>'''identify_and_draw_boxes_on_faces.py'''用来识别人脸并使用方框标注，测试步骤如下所示</p>
</li>
<li><p>等待一段时间会弹出下面的图片，可以看到将图片中的人脸都使用方框标注出来了，并且正确显示了人物的名字</p>
<p>[[File:media/image203zero3-img203.png|461x250px]]</p></li></ol>
</li>
<li><p>'''face_distance.py'''用来在不同精度上比较两个人脸是否属于一个人，首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令就可以看到测试的输出结果</p>
</li>
<li><p>等待一段时间会弹出摄像头的显示画面</p>
<p>[[File:media/image204zero3-img204.png|314x245px]]</p></li>
<li><p>此时可以将摄像头对准自己，当摄像头检测到人脸时，会将检测到的人脸使用方框框起来。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</p></li>
<li><p>还可以打开一张奥巴马的图片，然后使用摄像头对准打开的图片，可以看到不仅能将人脸标注出来，还能正确显示检测到的人脸的名字。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</p>
<p>[[File:media/image205zero3-img205.png|358x284px]]</p></li></ol>
</li>
<li><p>'''web_service_example.py'''是一个非常简单的使用Web服务上传图片运行人脸识别的案例，后端服务器会识别这张图片是不是奥巴马，并把识别结果以json键值对输出，测试步骤如下所示：</p>
</li>
<li><p>使用浏览器测试的方法如下所示：</p>
<ol style="list-style-type: lower-alphanone;"><li><p>a) 首先打开浏览器，然后在浏览器的地址栏输入'''开发板的IP地址:5001'''，然后就能看到下面的页面</p><p>[[File:media/image206zero3-img206.png|575x150px]]</p></li><li><p>b) 然后将obama2.jpg复制到桌面</p>
{| class="wikitable" style="width:800px;"
|-
|}
</li>
<li><p>c) 然后在浏览器中选择刚才复制的图片</p><p>[[File:media/image207zero3-img207.png|575x217px]]</p></li><li><p>d) 然后点击'''Upload'''上传刚才选择的图片进行人脸识别</p><p>[[File:media/image208zero3-img208.png|575x145px]]</p></li><li><p>e) 等待一段时间后就会显示检测的结果</p><p>[[File:media/image209zero3-img209.png|314x149px]]</p></li></ol>
</li></ol>
</li>
</li>
<li><p>使用多核并行检测多张图片的示例如下所示：</p>
<ol style="list-style-type: lower-alphanone;"><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;"
|-
</li>
<li><p>然后在弹出的界面中选择'''zh_CN.UTF-8 > UTF-8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''<OK>'''，然后回车即可）</p>
<p>[[File:media/image210zero3-img210.png|575x296px1400px]]</p></li>
<li><p>然后设置默认'''locale'''为'''zh_CN.UTF-8'''</p>
<p>[[File:media/image211zero3-img211.png|575x160px1400px]]</p></li>
<li><p>退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示</p>
{| class="wikitable" style="width:800px;"
</li>
<li><p>然后打开'''Input Method'''</p>
<p>[[File:media/image212zero3-img212.png|575x361px]]</p></li>
<li><p>然后选择'''OK'''</p>
<p>[[File:media/image213zero3-img213.png|295x212px]]</p></li>
<li><p>然后选择'''Yes'''</p>
<p>[[File:media/image214zero3-img214.png|303x192px]]</p></li>
<li><p>然后选择'''fcitx'''</p>
<p>[[File:media/image215zero3-img215.png|307x220px]]</p></li>
<li><p>然后选择'''OK'''</p>
<p>[[File:media/image216zero3-img216.png|305x216px]]</p></li>
<li><p>'''<span style="color:#FF0000">然后重启Linux系统才能使配置生效</span>'''</p></li>
<li><p>然后打开'''Fcitx configuration'''</p>
<p>[[File:media/image217zero3-img217.png|575x376px]]</p></li>
<li><p>然后点击下图所示位置的'''+'''号</p>
<p>[[File:media/image218zero3-img218.png|280x187px]]</p></li>
<li><p>然后搜索'''Google Pinyin'''再点击'''OK'''</p>
<p>[[File:media/image219zero3-img219.png|291x196px]]</p></li>
<li><p>然后将'''Google Pinyin'''放到最前面</p>
<p>[[File:media/image220zero3-img220.png|299x202px]]</p><p>[[File:media/image221zero3-img221.png|300x202px]]</p></li>
<li><p>然后打开'''Geany'''这个编辑器测试下中文输入法</p>
<p>[[File:media/image222zero3-img222.png|349x212px]]</p></li>
<li><p>中文输入法测试如下所示</p>
<p>[[File:media/image223zero3-img223.png|575x325px]]</p></li>
<li><p>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</p></li>
<li><p>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CN.UTF-8'''</p>
</li>
<li><p>然后'''重启系统'''就能看到系统显示为中文了</p>
<p>[[File:media/image224zero3-img224.png|576x356px]]</p></li></ol>
<span id="ubuntu-20.04系统的安装方法"></span>
<ol style="list-style-type: decimal;">
<li><p>首先打开'''Language Support'''</p>
<p>[[File:media/image225zero3-img225.png|575x351px]]</p></li>
<li><p>然后找到'''汉语（中国）'''选项</p>
<p>[[File:media/image226zero3-img226.png|318x311px]]</p></li>
<li><p>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</p>
<p>[[File:media/image227zero3-img227.png|324x320px]]</p></li>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<ol start="4" style="list-style-type: decimal;">
<li><p>然后选择'''Apply System-Wide'''将中文设置应用到整个系统</p>
<p>[[File:media/image228zero3-img228.png|321x316px]]</p></li>
<li><p>然后设置'''Keyboard input method system'''为'''fcitx'''</p>
<p>[[File:media/image229zero3-img229.png|327x320px]]</p></li><li><p>'''<span style="color:#FF0000">然后重启Linux系统使配置生效</span>'''</p></li>
<li><p>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</p>
<p>[[File:media/image230zero3-img230.png|303x247px]]</p></li>
<li><p>然后可以看到桌面都显示为中文了</p>
<p>[[File:media/image231zero3-img231.png|575x383px]]</p></li>
<li><p>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示</p>
<p>[[File:media/image232zero3-img232.png|576x292px]]</p></li>
<li><p>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了</p>
<p>[[File:media/image233zero3-img233.png|575x308px]]</p></li></ol>
<span id="ubuntu-22.04系统的安装方法"></span>
<ol style="list-style-type: decimal;">
<li><p>首先打开'''Language Support'''</p>
<p>[[File:media/image225zero3-img225.png|575x351px]]</p></li>
<li><p>然后找到'''汉语（中国）'''选项</p>
<p>[[File:media/image234zero3-img234.png|249x242px]]</p></li>
<li><p>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</p>
<p>[[File:media/image235zero3-img235.png|267x262px]]</p></li></ol> '''注意，这一步不是很好拖动的，请耐心多试几次。'''
{| 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:media/image236zero3-img236.png|287x282px]]</p></li><li><p>'''<span style="color:#FF0000">然后重启Linux系统使配置生效</span>'''</p></li>
<li><p>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</p>
<p>[[File:media/image230zero3-img230.png|303x247px]]</p></li>
<li><p>然后可以看到桌面都显示为中文了</p>
<p>[[File:media/image231zero3-img231.png|575x383px]]</p></li>
<li><p>然后打开Fcitx5配置程序</p>
<p>[[File:media/image237zero3-img237.png|575x349px]]</p></li>
<li><p>然后选择使用拼音输入法</p>
<p>[[File:media/image238zero3-img238.png|338x267px]]</p></li>
<li><p>选择后的界面如下所示，再点击确定即可</p>
<p>[[File:media/image239zero3-img239.png|366x290px]]</p></li>
<li><p>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示</p>
<p>[[File:media/image232zero3-img232.png|576x292px]]</p></li>
<li><p>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了</p>
<p>[[File:media/image240zero3-img240.png|434x308px]]</p></li></ol>
<span id="远程登录linux系统桌面的方法"></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 > for ARM ARMv8 DEB'''安装包，下载链接如下所示：</li></ol></li></ol>
{| 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&distro=ARM''']
|}
[[File:media/image241zero3-img241.png|575x227px]]</li></ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>另外在'''官方工具'''中也可以下载到'''NoMachine'''的安装包</p>
<p>[[File:media/image242zero3-img242.png|70x86px]]</p>
<p>先进入'''远程登录软件-NoMachine'''文件夹</p>
<p>[[File:media/image243zero3-img243.png|256x46px]]</p>
<p>然后下载arm64版本的deb安装包</p>
<p>[[File:media/image244zero3-img244.png|180x109px]]</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></ol>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，这个下载链接可能会变。'''</big>|}
{| class="wikitable" style="width:800px;"
|-
|
'''https://downloads.nomachine.com/download/?id=9'''
|}
[[File:media/image245zero3-img245.png|575x163px]]</ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后在Windows中安装NoMachine，'''安装完后请重启下电脑'''</p></li>
<li><p>然后在Window中打开'''NoMachine'''</p>
<p>[[File:media/image246zero3-img246.png|76x66px]]</p></li>
<li><p>NoMachine启动后会自动扫描局域网内其他安装有NoMachine的设备，进入NoMachine的主界面后就可以看到开发板已经在可连接的设备列表里了，然后点击下图红色方框所示的位置即可开始登录开发板的Linux系统桌面</p>
<p>[[File:media/image247zero3-img247.png|321x92px]]</p></li>
<li><p>然后点击'''OK'''</p>
<p>[[File:media/image248zero3-img248.png|318x217px]]</p></li>
<li><p>然后在下图对应的位置输入开发板Linux系统的用户名和密码，再点击'''OK'''开始登陆</p>
<p>[[File:media/image249zero3-img249.png|303x204px]]</p></li>
<li><p>然后在接下来的界面中都点击OK</p></li>
<li><p>最后就能看到开发板Linux系统的桌面了</p>
<p>[[File:media/image250zero3-img250.png|411x246px]]</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></ol></li></ol> [[File:media/image251.png|421x300px]]
[[File:zero3-img251.png]]
</ol>
<ol start="2" style="list-style-type: lower-alpha;">
<li><p>然后输入前面设置的VNC的密码</p>
<p>[[File:media/image252zero3-img252.png|221x105px]]</p></li><li><p>登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了</p></li></ol>
[[File:media/image253zero3-img253.png|405x293px]]</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:media/image254zero3-img254.png|576x270px]]</p>
<p>也可以使用下面的命令打开QT Creator</p>
{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''qtcreator'''</p>|}</li><li><p>QT Creator打开后的界面如下所示</p><p>[[File:media/image255zero3-img255.png|576x342px]]</p></li>
<li><p>QT Creator的版本如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>QT Creator在'''Ubuntu20.04'''中的默认版本如下所示</p>
<p>[[File:media/image256zero3-img256.png|419x224px]]</p></li>
<li><p>QT Creator在'''Ubuntu22.04'''中的默认版本如下所示</p>
<p>[[File:media/image257zero3-img257.png|443x237px]]</p></li>
<li><p>QT Creator在'''Debian11'''中的默认版本如下所示</p>
<p>[[File:media/image258zero3-img258.png|444x238px]]</p></li>
<li><p>QT Creator在'''Debian12'''中的默认版本如下所示</p>
<p>[[File:media/image259zero3-img259.png|449x277px]]</p></li></ol>
</li>
<li><p>然后设置下QT</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先打开'''Help'''->'''About Plugins...'''</p>
<p>[[File:media/image260zero3-img260.png|573x164px]]</p></li>
<li><p>然后去掉'''ClangCodeModel'''的那个勾</p>
<p>[[File:media/image261zero3-img261.png|408x254px]]</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:media/image262zero3-img262.png|576x315px]]</p><p>[[File:media/image263zero3-img263.png|575x307px]]</p></li></ol>
</li>
<li><p>然后就可以打开一个示例代码</p>
<p>[[File:media/image264zero3-img264.png|575x312px]]</p></li>
<li><p>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明</p>
<p>[[File:media/image265zero3-img265.png|576x218px]]</p></li>
<li><p>然后点击下'''Configure Project'''</p>
<p>[[File:media/image266zero3-img266.png|575x304px]]</p></li>
<li><p>然后点击左下角的绿色三角形编译运行下示例代码</p>
<p>[[File:media/image267zero3-img267.png|575x312px]]</p></li>
<li><p>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行</p>
<p>[[File:media/image268zero3-img268.png|576x308px]]</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安装方法 ==
# ROS 1当前活跃的版本如下所示，推荐版本为'''Noetic Ninjemys'''
::[[File:media/image269zero3-img269.png|345x235px]]
::[[File:media/image270zero3-img270.png|576x210px]]
::{| 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:media/image271zero3-img271.png|312x176px]]</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，否则会由于网络问题而报错。</olspan>'''
'''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'''
Recommended: please run
::rosdep update
orangepi@orangepi:~$ '''rosdep update'''
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:media/image272zero3-img272.png|575x291px]]</p></li><li><p>然后请保持刚才打开终端窗口在最上面</p></li></ol> [[File:media/image273.png|575x269px]]
[[File:zero3-img273.png]]
</ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>此时按下键盘上的方向按键就可以控制小海龟上下左右移动了</p>
<p>[[File:media/image274zero3-img274.png|575x250px]]</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:media/image275zero3-img275.png|576x271px]]</p><p>[[File:media/image276zero3-img276.png|575x265px]]</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 <command> -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 <command> -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] [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:media/image277zero3-img277.png|576x324px]]</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 <command> -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 <command> -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] [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:media/image278zero3-img278.png|575x323px]]</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内核的Debian11系统编译内核模块时会报GCC的错误。所以如果要编译内核模块请使用Debian12或者Ubuntu221</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 "Hello"'''</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 "Hello"'''</p>
<p>[ 2871.893988] Hello Orange Pi -- init</p>
<p>[ 3173.800892] '''Hello Orange Pi -- exit'''</p>|}</li></ol>
<span id="linux系统支持的部分编程语言测试"></span>
== Linux系统支持的部分编程语言测试 ==
<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 <stdio.h></p>
<p>int main(void)</p>
<p>{</p>
:<p>printf("Hello World!\n");</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>Type "help", "copyright", "credits" or "license" for more information.</p>
<p>>>></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("Hello World!");</p>:<p>}</p>
<p>}</p>
<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: 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 <stdio.h></p>
<p>int main(void)</p>
<p>{</p>
:<p>printf("Hello World!\n");</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 "help", "copyright", "credits" or "license" for more information.</p>
<p>>>></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("Hello World!");</p>:<p>}</p>
<p>}</p>
<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: 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 <stdio.h></p>
<p>int main(void)</p>
<p>{</p>
:<p>printf("Hello World!\n");</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>Type "help", "copyright", "credits" or "license" for more information.</p>
<p>>>></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("Hello World!");</p>:<p>}</p>
<p>}</p>
<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: 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 <stdio.h></p>
<p>int main(void)</p>
<p>{</p>
:<p>printf("Hello World!\n");</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 "help", "copyright", "credits" or "license" for more information.</p>
<p>>>></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("Hello World!");</p>:<p>}</p>
<p>}</p>
<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系统中的方法 ==
<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></li></ol>{| 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:media/image279zero3-img279.png|576x453px|截图 2022-12-03 19-04-40]]
</div></li>
<li><p>连接开发板的方法如下图所示</p></li></ol>
<div class="figure">
[[File:media/image280zero3-img280.png|577x128px|IMG_256]]
</div>
</li></ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>然后选择'''保存密码'''，再点击'''确定'''</p>
<p>[[File:media/image281zero3-img281.png|249x181px]]</p></li><li><p>然后选择'''总是信任该主机'''，再点击'''确定'''</p></li></ol>
<div class="figure">
[[File:media/image282zero3-img282.png|278x150px|IMG_256]]
</div></li></ol>
<ol start="7" style="list-style-type: decimal;">
<li>连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了</li></ol>
<div class="figure">
[[File:media/image283zero3-img283.png|533x330px|IMG_256]]
</div></ol>
<ol start="8" style="list-style-type: decimal;">
<li>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Ubuntu PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了。</li></ol>
<div class="figure">
[[File:media/image284zero3-img284.png|529x414px|IMG_256]]
</div></ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</p></li>
<span id="在windows-pc中上传文件到开发板linux系统中的方法"></span>
=== 在Windows PC中上传文件到开发板Linux系统中的方法 ===
# 首先下载filezilla软件Windows版本的安装文件，下载链接如下所示
::{| class="wikitable" style="width:800px;" |-| [https://filezilla-project.org/download.php?type=client '''https://filezilla-project.org/download.php?type=client''']|}::[[File:media/image285zero3-img285.png|472x171px|IMG_256]]
::[[File:media/image286zero3-img286.png|384x276px]]
<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></li></ol>|}
安装过程中，下面的安装界面请选择'''Decline'''，然后再选择'''Next>'''
<div class="figure">
[[File:media/image287zero3-img287.png|355x279px|IMG_256]]
</div></li></ol>
<ol start="3" style="list-style-type: decimal;">
<li>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的</li></ol>
<div class="figure">
[[File:media/image288zero3-img288.png|451x357px|IMG_256]]
</div></li></ol>
<ol start="4" style="list-style-type: decimal;">
<li>连接开发板的方法如下图所示：</li></ol>
<div class="figure">
[[File:media/image289zero3-img289.png|522x108px|IMG_256]]
</div></li></ol>
<ol start="5" style="list-style-type: decimal;">
<li>然后选择'''保存密码'''，再点击'''确定'''</li></ol>
<div class="figure">
[[File:media/image290zero3-img290.png|207x146px|IMG_256]]
</div></li></ol>
<ol start="6" style="list-style-type: decimal;">
<li>然后选择'''总是信任该主机'''，再点击'''确定'''</li></ol>
<div class="figure">
[[File:media/image291zero3-img291.png|221x109px|IMG_256]]
</div></li></ol>
<ol start="7" style="list-style-type: decimal;">
<li>连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了</li></ol>
<div class="figure">
[[File:media/image292zero3-img292.png|449x332px|IMG_256]]
</div></li></ol>
<ol start="8" style="list-style-type: decimal;">
<li>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Windows PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了</li></ol>
<div class="figure">
[[File:media/image293zero3-img293.png|461x340px|IMG_256]]
</div></li></ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</p></li>
<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'''，只支持在安装有'''<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'''
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>替换清华源的方法参考这个网页的说明即可。</li></ol>
{| 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:media/image294zero3-img294.png|576x241px]]</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>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的源码 ==
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的next分支源码的，上面的git build的<span style="color:#FF0000">next</span>分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。'''</big>
[[File:media/image295zero3-img295.png|576x288px]]|}
{| 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;"| '''分支'''
|}
{| 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 external LICENSE README.md 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>
=== 下载交叉编译工具链 ===
<div class="figure">
[[File:media/image296zero3-img296.png|575x278px|选区_3961400px]]
</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-911.2-20192022.1202-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
<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: lower-alpha;">
<li><p>linux内核源码存放的git仓库如下，注意切换linux-orangepi仓库的分支为</p>
<ol style="list-style-type: lower-alphanone;"><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: lower-alphanone;"><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 external kernel LICENSE output README.md scripts toolchains u-boot userpatches'''</p>|}</li></ol>
</li></ol>
<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:media/image297zero3-img297.png|576x132px|选区_238]]
</div></li>
<li><p>接着选择开发板的型号</p>
<p>[[File:media/image298zero3-img298.png|576x123px]]</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:mediazero3-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内存大小的，请选择第二项</image299p><p>[[File:zero3-img299-1.png|576x77px1000px]]</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="'''<span style="color:#FF0000">yes</span>'''"</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 [mailto:root@192.168.1.xxx:/root 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:media/image300zero3-img300.png|320x174px]]</p></li><li><p>按下回车键后首先会弹出一个Warring按下回车键后首先会弹出一个'''Warning'''</p><p>[[File:media/image301zero3-img301.png|314x170px]]</p></li>
<li><p>再按下回车键就会开始更新u-boot，更新完后会显示下面的信息</p>
<p>[[File:media/image302zero3-img302.png|292x164px]]</p></li>
<li><p>然后就可以重启开发板来测试u-boot的修改是否生效了</p></li></ol>
</li></ol>
<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:media/image303zero3-img303.png|575x116px|选区_240]]
</div></li>
<li><p>然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个</p>
<p>[[File:media/image304zero3-img304.png|576x87px]]</p></li>
<li><p>接着选择开发板的型号</p>
<p>[[File:media/image298zero3-img298.png|576x123px]]</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:media/image299zero3-img299.png|576x77px]]</p></li></ol>
</li>
<li><p>如果第3)步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码。</p>
<p>[[File:media/image305zero3-img305.png|575x357px]]</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 > PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu > PC的终端调到最大，然后重新运行build.sh脚本</p>
<p>[[File:media/image306zero3-img306.png|574x234px]]</p></li></ol>
<!-- -->
<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>
<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="'''<span style="color:#FF0000">yes</span>'''"</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>
<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></ol>
<div class="figure">
[[File:media/image307zero3-img307.png|576x119px|选区_241]]
</div></ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>接着选择开发板的型号</p>
<p>[[File:media/image298zero3-img298.png|576x123px]]</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:media/image299zero3-img299.png|576x77px]]</p></li></ol>
</li>
<li><p>然后选择rootfs的类型</p>
<p>[[File:media/image308zero3-img308.png|576x79px]]</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:media/image309zero3-img309.png|576x75px|选区_245]]
</div></li></ol>
<div class="figure">
[[File:media/image310zero3-img310.png|576x78px|选区_397]]
</div></li>
<li><p>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面</p>
<p>[[File:media/image311zero3-img311.png|576x76px]]</p><p>[[File:media/image312zero3-img312.png|576x74px]]</p>
<p>然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。</p>
<p>[[File:media/image313zero3-img313.png|575x264px]]</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: lower-alphanone;"><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>
<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></ol>
<div class="figure">
[[File:media/image314zero3-img314.png|576x128px|选区_242]]
</div></ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后选择开发板的型号</p>
<p>[[File:media/image298zero3-img298.png|576x123px]]</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:mediazero3-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内存大小的，请选择第二项</image299p><p>[[File:zero3-img299-1.png|576x77px]]</p></li></ol>
</li>
<li><p>然后选择rootfs的类型</p>
<p>[[File:media/image308zero3-img308.png|576x79px]]</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:media/image309zero3-img309.png|576x75px|选区_245]]
</div></li></ol>
<div class="figure">
[[File:media/image310zero3-img310.png|576x78px|选区_397]]
</div></li></ol>
<!-- -->
<ol start="128" style="list-style-type: decimal;">
<li><p>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面</p>
<p>[[File:media/image311zero3-img311.png|576x76px]]</p><p>[[File:media/image312zero3-img312.png|576x74px]]</p>
<p>然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。</p>
<p>[[File:media/image313zero3-img313.png|575x264px]]</p></li></ol>
<!-- -->
<ol start="89" style="list-style-type: decimal;">
<li><p>然后就会开始编译linux镜像，编译的大致流程如下</p>
<ol style="list-style-type: lower-alpha;">
<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></ol></li></ol>{| 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版本 ==
{| class="wikitable" style="width:600px;"
|-
| style="text-align: left;"| Android版本
<span id="android-12-tv功能适配情况"></span>
== Android 12 TV功能适配情况 ==
{| class="wikitable" style="width:600px;"
|-
| style="text-align: left;"| 功能
<span id="板载led灯显示说明"></span>
== 板载LED灯显示说明 ==
{| class="wikitable" style="width:600px;"
|-
|
<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:media/image315zero3-img315.png|231x199px]]</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 "adb.tcp"'''</p>
<p>[service.adb.tcp.port]: [5555]</p>|}</li><li><p>如果'''service.adb.tcp.port'''没有设置，可以在串口中使用下面的命令设置网络adb的端口号</p>< {| class="wikitable" style="width:800px;" |-| apollo-p2:/li></ol># '''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></li></ol>
{| class="wikitable" style="width:800px;"
|-
|
test@test:~$ '''adb shell'''
apollo-p2:/ #
|}
</li></ol>
=== 使用数据线连接adb调试 ===
<div class="figure">
[[File:media/image15zero3-img15.jpeg|172x172px|IMG_4194(20201104-125502)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></li></ol>
{| 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:media/image316zero3-img316.png|234x83px]]</p></li>
<li><p>然后选择'''Device Preferences'''</p>
<p>[[File:media/image317zero3-img317.png|415x170px]]</p></li>
<li><p>然后选择'''Display & Sound'''</p>
<p>[[File:media/image318zero3-img318.png|420x133px]]</p></li>
<li><p>然后选择'''Advanced display settings'''</p>
<p>[[File:media/image319zero3-img319.png|423x96px]]</p></li><li><p>然后选择'''HDMI outpu output mode'''</p><p>[[File:media/image320zero3-img320.png|423x101px]]</p></li>
<li><p>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。</p>
<p>[[File:media/image321zero3-img321.png|429x136px]]</p></li>
<li><p>开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项</p>
<p>[[File:media/image322zero3-img322.png|429x242px]]</p></li></ol>
<span id="hdmi转vga显示测试-1"></span>
== HDMI转VGA显示测试 ==
<ol style="list-style-type: lower-alpha;">
<li><p>HDMI转VGA转换器</p>
<p>[[File:media/image146zero3-img146.png|155x104px]]</p></li>
<li><p>一根VGA线和一根Micro HDMI公转HDMI母转接线</p>
<p>[[File:media/image147zero3-img147.png|148x133px]] [[File:media/image148zero3-img148.jpeg|157x139px|IMG_6140(20220104-134930)png]]</p></li>
<li><p>一个支持VGA接口的显示器或者电视</p></li></ol>
</li>
<li><p>HDMI转VGA显示测试如下所示</p>
<p>[[File:media/image323zero3-img323.png|576x330px]]</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:media/image316zero3-img316.png|234x83px]]</p></li>
<li><p>然后选择'''Network & Internet'''</p>
<p>[[File:media/image324zero3-img324.png|373x103px]]</p></li>
<li><p>然后打开WI-FI</p>
<p>[[File:media/image325zero3-img325.png|381x50px]]</p></li>
<li><p>打开WI-FI后在'''Available networks'''下面就可以看到搜索到的信号</p>
<p>[[File:media/image326zero3-img326.png|381x187px]]</p></li>
<li><p>选择想连接的WI-FI后会弹出下图所示的密码输入界面</p>
<div class="figure">
[[File:media/image327zero3-img327.png|386x180px|Screenshot_20220104-164114]]
</div></li>
<li><p>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了</p>
<p>[[File:media/image328zero3-img328.png|388x160px]]</p></li>
<li><p>WI-FI连接成功后的显示如下图所示</p>
<p>[[File:media/image329zero3-img329.png|402x141px]]</p></li></ol>
<span id="wi-fi-hotspot的使用方法"></span>
<li><p>首先请确保以太网口已连接网线，并且能正常上网</p></li>
<li><p>然后选择'''Settings'''</p>
<p>[[File:media/image316zero3-img316.png|234x83px]]</p></li>
<li><p>然后选择'''Network & Internet'''</p>
<p>[[File:media/image324zero3-img324.png|373x103px]]</p></li>
<li><p>然后选择'''WIFI hotspot'''</p>
<p>[[File:media/image330zero3-img330.png|378x104px]]</p></li>
<li><p>然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）</p>
<p>[[File:media/image331zero3-img331.png|402x174px]]</p></li>
<li><p>此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password'''下面可以看到</p>
<p>[[File:media/image332zero3-img332.png|269x191px]]</p></li>
<li><p>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot'''能正常使用</p>
<p>[[File:media/image333zero3-img333.png|269x125px]]</p></li></ol>
<span id="查看以太网口ip地址的方法"></span>
<li><p>首先请确保开发板的千兆网口连接到了路由器或者交换机</p></li>
<li><p>然后打开'''Settings'''</p>
<p>[[File:media/image334zero3-img334.png|431x161px]]</p></li>
<li><p>然后选择'''Network & Internet'''</p>
<p>[[File:media/image335zero3-img335.png|576x186px]]</p></li>
<li><p>然后在下图所示的位置就能看到开发板有线网口的IP地址了</p>
<p>[[File:media/image336zero3-img336.png|576x200px]]</p></li></ol>
== 蓝牙的连接方法 ==
<ol style="list-style-type: decimal;">
<li><p>首先选择'''Settings'''</p>
<p>[[File:media/image316zero3-img316.png|234x83px]]</p></li>
<li><p>然后选择'''Bluetooth'''</p>
<p>[[File:media/image337zero3-img337.png|377x111px]]</p></li>
<li><p>然后打开'''Bluetooth Enable'''</p>
<p>[[File:media/image338zero3-img338.png|384x180px]]</p></li>
<li><p>然后点击'''Pair new device'''开始扫描周围的蓝牙设备</p>
<p>[[File:media/image339zero3-img339.png|389x129px]]</p></li>
<li><p>搜索到的蓝牙设备会在'''Available devices'''下面显示出来</p>
<p>[[File:media/image340zero3-img340.png|407x181px]]</p></li>
<li><p>然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项</p>
<p>[[File:media/image341zero3-img341.png|420x115px]]</p></li><li><p>这里测试的是开发板和'''<span style="color:#FF0000">安卓手机</span>'''蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程</p><p>[[File:media/image342zero3-img342.png|178x200px]]</p></li>
<li><p>配对完成后，再打开'''Paired devices'''下面就可以看到已配对的蓝牙设备</p>
<p>[[File:media/image343zero3-img343.png|430x136px]]</p></li>
<li><p>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了</p>
<p>[[File:media/image344zero3-img344.png|433x113px]]</p></li>
<li><p>开发板Android系统蓝牙接收到的图片可以打开'''Received files'''中查看</p>
<p>[[File:media/image345zero3-img345.png|432x209px]]</p></li></ol>
<span id="usb摄像头使用方法"></span>
== USB摄像头使用方法 ==
<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的使用方法请参考[[\lOrange Pi Zero 3#ADB的使用方法|'''ADB的使用方法''']]一小节的说明</p></li>
<li><p>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP</p>
<p>[[File:media/image346zero3-img346.png|576x172px]]</p><p>[[File:media/image347zero3-img347.png|575x145px]]</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:media/image348zero3-img348.png|576x132px]]</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:media/image346zero3-img346.png|576x172px]]</p><p>[[File:media/image349zero3-img349.png|575x124px]]</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:media/image350zero3-img350.png|575x119px]]</p></li>
<li><p>第一次打开'''ROOT测试工具'''后的显示界面如下图所示</p>
<p>[[File:media/image351zero3-img351.png|575x162px]]</p></li>
<li><p>然后就可以点击'''CHECK NOW'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限</p>
<p>[[File:media/image352zero3-img352.png|575x161px]]</p></li></ol>
<span id="使用miracastreceiver将手机屏幕投屏到开发板的方法"></span>
== 使用MiracastReceiver将手机屏幕投屏到开发板的方法 ==
<ol style="list-style-type: decimal;">
<li><p>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[\lOrange Pi Zero 3#WI-FI的连接方法|'''WI-FI的连接方法''']]一小节的说明</p></li>
<li><p>然后打开开发板安卓系统中的'''MiracastReceiver'''应用</p>
<p>[[File:media/image353zero3-img353.png|576x124px]]</p></li>
<li><p>'''MiracastReceiver'''打开后的界面如下所示</p>
<div class="figure">
[[File:media/image354zero3-img354.png|420x236px|Screenshot_20230625-193535]]
</div></li>
<li><p>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能</p>
<p>[[File:media/image355zero3-img355.png|167x266px]]</p></li>
<li><p>等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可</p>
<p>[[File:media/image356zero3-img356.png|146x308px]]</p></li>
<li><p>然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可</p>
<p>[[File:media/image357zero3-img357.png|468x265px]]</p></li>
<li><p>然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了</p>
<p>[[File:media/image358zero3-img358-1.png|576x352px]]</p></li></ol>
<span id="pin-接口-gpiouartspi-测试"></span>
== 26pin 接口 GPIO、UART、SPI 测试 ==
<ol style="list-style-type: decimal;">
<li><p>首先在桌面中打开wiringOP APP</p>
<p>[[File:media/image359zero3-img359.png|576x133px]]</p></li>
<li><p>然后点击'''GPIO_TEST'''按钮打开GPIO测试界面</p>
<p>[[File:media/image360zero3-img360.png|413x77px]]</p></li>
<li><p>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮跟26pin引脚（'''左下角的PC1/PI16/PI6/PH10是13pin引脚中的GPIO口'''）是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平设置为低电平；当点击右边的'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息。</p>
<p>[[File:media/image361zero3-img361.png|425x236px]]</p></li>
<li><p>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：</p>
<div class="figure">
[[File:media/image362zero3-img362.png|444x249px|Screenshot_20230609-155643]]
</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:media/image363zero3-img363.png|432x210px]]</p></li>
<li><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为'''OUT'''，引脚电平为高电平</p>
<p>[[File:media/image364zero3-img364.png|430x207px]]</p></li>
<li><p>再次点击下图的'''CheckBox'''按钮取消勾选状态，7号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功</p>
<p>[[File:media/image365zero3-img365.png|434x212px]]</p></li>
<li><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为OUT，引脚电平为低电平</p>
<p>[[File:media/image366zero3-img366.png|438x217px]]</p></li></ol>
<span id="pin的uart测试方法"></span>
<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:media/image359zero3-img359.png|576x133px]]</p></li>
<li><p>然后点击'''UART_TEST'''按钮打开UART测试界面</p>
<p>[[File:media/image367zero3-img367.png|505x94px]]</p></li><li><p>wiringOP的串口测试界面如下图所示</p></li></ol> [[File:media/image368.png|511x133px]]
[[File:zero3-img368.png]]
</ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>然后在选择框中选择'''/dev/ttyAS5'''节点</p>
<p>[[File:media/image369zero3-img369.png|499x269px]]</p></li><li><p>再在编辑框中输入想要设置的波特率，然后点击'''OPEN'''按钮打开'''/dev/ttyAS5'''节点，打开成功后，'''OPEN'''按钮变为不可选中状态，'''CLOSE'''按钮和'''SEND'''按钮变为可选中状态</p></li></ol> [[File:media/image370.png|334x107px]]
[[File:zero3-img370.png]]
</ol>
<ol start="7" style="list-style-type: decimal;">
<li>然后使用杜邦线短接uart5的rx和tx引脚</li></ol>
{| class="wikitable" style="width:600px;"
|-
|
| style="text-align: left;"| 对应26pin的10号引脚
|}
</ol>
<ol start="8" style="list-style-type: decimal;">
<li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li></ol> [[File:media/image371.png|376x189px]]
[[File:zero3-img371.png]]
</ol>
<ol start="9" style="list-style-type: decimal;">
<li>如果一切正常，接收框内会显示已接收到的字符串</li></ol>
[[File:media/image372zero3-img372.png|382x196px]]</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:media/image359zero3-img359.png|576x133px]]</p></li><li><p>这里演示下通过'''w25q64'''模块来测试SPI1接口，首先在SPI1接口接入w25q64模块</p></li></ol> '''<span class="mark">如果没有</span>w25q64模块也没关系，因为开发板上有一个SPIFlash接在了SPI0上，在安卓中SPI0的配置默认也打开了，所以我们也可以直接使用板载的SPIFlash测试。'''
{| 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:media/image373zero3-img373.png|518x96px]]</p></li>
<li><p>然后在左上角选择spi的设备节点，如果直接测试板载的SPIFlash，那么保持默认的'''/dev/spidev0.0'''即可，如果在26pin的spi1上接了'''w25q64'''模块，那么就请选择'''/dev/spidev1.1'''</p>
<p>[[File:media/image374zero3-img374.png|296x135px]]</p></li><li><p>然后点击'''OPEN'''按钮初始化SPI</p></li></ol> [[File:media/image375.png|295x168px]]
[[File:zero3-img375.png]]
</ol>
<ol start="7" style="list-style-type: decimal;">
<li><p>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮</p>
<p>[[File:media/image376zero3-img376.png|294x169px]]</p></li><li><p>最后APP会显示读取到的板载SPI Flash的ID信息</p></li></ol> [[File:media/image377.png|299x217px]]
[[File:zero3-img377-1.png]]
</ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>如果是读取接在26pin SPI1上的w25q64模块，那么读取到的ID信息如下图所示</p>
<p>[[File:media/image378zero3-img378.png|302x201px]]</p></li>
<li><p>w25q64模块的MANUFACTURER ID为EFh，Device ID为4017h，跟上面读取到的值是对应的（h代表是16进制）</p>
<p>[[File:media/image379zero3-img379.png|336x113px]]</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:media/image359zero3-img359.png|576x133px]]</p></li>
<li><p>然后点击'''I2C_TEST'''按钮打开i2c的测试界面</p>
<p>[[File:media/image380zero3-img380.png|506x110px]]</p></li><li><p>wiringOP的i2c测试界面如下图所示，可以看到默认使用的i2c为'''/dev/i2c-3'''，所以我们无需重新选择了</p></li></ol> [[File:media/image381.png|353x159px]]
[[File:zero3-img381.png]]
</ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>然后在26pin的i2c3引脚上接一个i2c设备，这里以ds1307 rtc模块为例</p>
<p>[[File:media/image186zero3-img186.png|121x103px]]</p></li></ol>
{| class="wikitable" style="width:600px;"
|-
| style="text-align: left;"| '''RTC模块的引脚'''
| 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:media/image382zero3-img382.png|424x186px]]</p></li>
<li><p>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c3</p>
<p>[[File:media/image383zero3-img383.png|354x177px]]</p></li>
<li><p>点击'''OPEN'''按钮打开i2c3后的显示如下所示：</p>
<p>[[File:media/image384zero3-img384.png|355x171px]]</p></li>
<li><p>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55</p>
<ol style="list-style-type: lower-alpha;">
<li><p>我们首先设置需要写入的寄存器的地址为0x1c</p>
<p>[[File:media/image385zero3-img385.png|322x152px]]</p></li>
<li><p>然后设置需要写入的值为0x55</p>
<p>[[File:media/image386zero3-img386.png|315x177px]]</p></li>
<li><p>然后点击'''WRITE BYTE'''按钮执行写入的动作</p>
<p>[[File:media/image387zero3-img387.png|314x173px]]</p></li></ol>
</li>
<li><p>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过</p>
<p>[[File:media/image388zero3-img388.png|316x170px]]</p></li></ol>
= '''附录''' =
== 用户手册更新历史 ==
{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| '''版本'''
|-
| style="text-align: left;"| v1.0
| style="text-align: left;"| 2023-07-0510
| style="text-align: left;"| 初始版本
|}
== 镜像更新历史 ==
{| class="wikitable" style="width:800px;"
|-
| * *'''日期**'''
| '''更新说明'''
|-
| 202 32023-07-0510
| 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_jammy_server_linux6.1.31.7z
Orangepizero3_1.0.0_debian_bullseye_server_linux6.1.31.7z
OrangePi_Zero3_Android12_v1.0.tar.gz
* 初始版本
|}