更改

←上一编辑

Orange Pi Zero 3

添加24,004字节, 2023年7月19日 (三) 10:04

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

|-

| WIFI+蓝牙

| • ~~AW859A芯片、支持IEEE~~ 5622芯片、支持IEEE 802.11 a/b/g/n/ac、BT5.0

|-

| 视频输出

[[File:~~media/image3~~zero3-img3-1.png~~|390x329px~~]]

[[File:~~media/image4~~zero3-img4-1.png~~|494x292px~~]]

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

[[File:~~media/image5~~zero3-img5-1.png|~~576x782px~~800px]]

[[File:~~media/image6~~zero3-img6.png|~~575x227px~~800px]]

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

<li>TF卡，最小8GB容量的'''class10'''级或以上的高速闪迪卡

[[File:~~media/image7~~zero3-img7.png~~|124x96px~~]]

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

|-

|

<big>'''使用其他品牌的TF卡（非闪迪的TF卡），如下图所示（包含但不仅限这些卡），已经有朋友反馈系统启动过程中会出现问题，比如系统启动到一半卡住不动，或者reboot命令无法正常使用，最后都是换了闪迪牌的TF卡后才解决的。所以如果您使用的是非闪迪牌的TF卡发现系统启动或者使用过程有问题，请更换闪迪牌的TF卡后再测试。'''</big>

[[File:~~media/image8~~zero3-img8-1.png|~~103x85px~~180px]][[File:~~media/image9~~zero3-img9-1.png|~~112x85px~~195px]][[File:~~media/image10~~zero3-img10-1.png|~~114x85px~~198px]][[File:~~media/image11~~zero3-img11-1.png|~~86x109px~~190px]]<pstyle="text-align: center;">'''目前反馈在Orange Pi Zero 3上启动有问题的部分TF卡'''

<big>'''另外，在其他型号的开发板上能正常使用的TF卡并不能保证在Orange Pi Zero 3上也一定能正常启动，这点请特别注意。'''</big>

|}

</li>

<li>TF卡读卡器，用于读写TF卡

[[File:~~media/image12~~zero3-img12.png~~|139x96px~~]]</li>

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

[[File:~~media/image13~~zero3-img13.~~jpeg|209x209px|IMG_6109(20211221-181051)~~png]]

</div>

|

<big>'''注意，请不要使用下图所示的这种比较宽的Micro HDMI转接头，由于开发板的Micro HDMI接口和Type-C电源接口之间的间距比较小，可能会导致两者无法同时插入到开发板。'''</big>

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

|}

~~[[File:media/image14.png|151x120px]]~~</li>

<li>电源，如果有5V/2A或5V/3A的电源头那就只需要准备一根下面左边图片所示的USB转Type C接口的数据线，另外也可以使用类似下面右边图片所示的线和电源头一体的5V/2A或者5V/3A的高品质USB Typc C接口电源适配器。

[[File:~~media/image15~~zero3-img15.~~jpeg~~png|~~172x172px|IMG_4194(20201104-125502)~~600px]] [[File:~~media/image16~~zero3-img16.~~jpeg~~png|~~173x173px|IMG_6179(20220116-151727)~~600px]]</li>

<li>13pin扩展板

<li>扩展板实物如下所示

[[File:~~media/image17~~zero3-img17.png~~|285x166px~~]]</li>

<li>扩展板插入开发板的方式如下所示，切记不要插反了

[[File:~~media/image18~~zero3-img18.png~~|246x162px~~]]</li>

<li>Orange Pi Zero 3开发板上的13pin排针可以接上扩展板来扩展开发板上没有的功能，扩展板可以使用的功能有

<li>Orange Pi Zero 3开发板13pin排针的原理图如下所示

[[File:~~media/image19~~zero3-img19.png~~|264x142px~~]]</li></ol>

</ol>

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

<li>红外遥控器，主要用于控制安卓TV系统

[[File:~~media/image20~~zero3-img20.png~~|209x196px~~]]

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

|-

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

<li>AV视频线，如果希望通过AV接口而不是HDMI接口来显示视频，那么就需要通过AV视频线将开发板连接到电视

[[File:~~media/image21~~zero3-img21.png~~|200x177px~~]]</li>

<li>散热片，如果担心开发板的温度过高，可以加个散热片，散热片贴在H618芯片上即可

[[File:~~media/image22~~zero3-img22.png~~|171x140px~~]] [[File:~~media/image23~~zero3-img23-1.png~~|151x147px~~]]</li>

<li>5V的散热风扇，如下图所示，开发板的26pin和13pin接口上都有5V和GND引脚可以接散热风扇，26pin和13pin排针的间距为'''2.54mm'''，散热风扇的电源接口参照这个规格去购买即可。

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

<big>'''注意，开发板插上电源后5V引脚就可以直接使用，无需其他设置，另外5V引脚输出的电压是无法通过软件调节和关闭的。'''</big>

|}

[[File:~~media/image24~~zero3-img24-1.png~~|212x226px~~]]</li>

<li>配套外壳'''（待添加图片）'''</li>

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

[[File:~~media/image25~~zero3-img25.png~~|176x145px~~]] [[File:~~media/image26~~zero3-img26.png~~|305x110px~~]]

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

|-

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

[[File:~~media/image27~~zero3-img27.png~~|456x219px~~]]</li>

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

[[File:~~media/image28~~zero3-img28.png~~|468x173px~~]]</li>

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

[[File:~~media/image29~~zero3-img29.png~~|335x211px~~]]

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

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

[[File:~~media/image30~~zero3-img30.png|~~206x162px~~center]]

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

[[File:~~media/image31~~zero3-img31.png|~~114x37px~~center]]

|}

</li></ol>

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

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

[[File:~~media/image32~~zero3-img32.png~~|501x281px~~]]</li></ol>

</li>

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

[[File:~~media/image33~~zero3-img33.png~~|506x317px~~]]</li>

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

[[File:~~media/image34~~zero3-img34.png~~|519x325px~~]]</li>

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

[[File:~~media/image35~~zero3-img35.png~~|523x324px~~]]</li></ol>

[[File:~~media/image36~~zero3-img36.png~~|209x228px|选区_199~~]]

</div></li>

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

[[File:~~media/image37~~zero3-img37.png~~|304x147px~~]]

</ol>

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

[[File:~~media/image38~~zero3-img38.png~~|186x149px~~]]</li></ol>

</li></ol>

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

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

[[File:~~media/image39~~zero3-img39.png~~|297x206px~~]]</li></ol>

</li>

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

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

[[File:~~media/image27~~zero3-img27.png~~|489x235px~~]]</li>

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

[[File:~~media/image40~~zero3-img40.png~~|485x184px~~]]</li>

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

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

</li>

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

[[File:~~media/image41~~zero3-img41.png~~|423x251px~~]]</li>

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

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

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

[[File:~~media/image42~~zero3-img42.png~~|431x278px~~]]</li></ol>

</li>

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

[[File:~~media/image43~~zero3-img43.png~~|576x247px~~]]</li></ol>

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

[[File:~~media/image44~~zero3-img44.png~~|576x252px~~]]</li>

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

[[File:~~media/image45~~zero3-img45.png~~|576x340px~~]]</li></ol>

|-

|

<big>'''~~开发板的Android镜像只能在Windows平台下使用PhoenixCard软件烧录到TF卡中，PhoenixCard软件的版本必须为PhonixCard~~开发板的Android镜像只能在Windows平台下使用PhoenixCard软件烧录到TF卡中，PhoenixCard软件的版本必须为PhonixCard-4.2.8。8。'''

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

<li>首先请确保Windows系统已经安装了'''Microsoft Visual C++ 2008 Redistrbutable - x86'''

[[File:~~media/image46~~zero3-img46.png~~|449x293px~~]]</li>

<li>如果没有安装'''Microsoft Visual C++ 2008 Redistrbutable - x86'''，使用'''PhoenixCard'''格式化TF卡或者烧录Android镜像会提示下面的错误

[[File:~~media/image47~~zero3-img47.png~~|522x395px|NUQB$Q%(){1CV6M6WK4N`5J~~]]

</div></li>

<li>'''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 '''微软官网''']下载

[[File:~~media/image48~~zero3-img48.png~~|240x93px~~]] [[File:~~media/image49~~zero3-img49.png~~|200x95px~~]]</li>

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

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

<li>从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']下载Android镜像和PhoenixCard烧写工具，请确保PhonenixCrad工具的版本为'''PhonixCard-4.2.8，请不要用低于4.2.8版本的PhonixCard软件来烧录Android镜像，'''低于这个版本的PhonixCard工具烧写的Android镜像可能会有问题

[[File:~~media/image50~~zero3-img50.png~~|575x169px~~]]</li>

<li>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”'''.img'''” 结尾的文件就是Android镜像文件，大小在1GB以上。如果不知道怎么解压Android镜像的压缩包，可以安装一个[https://yasuo.360.cn/ '''360压缩软件''']来解压镜像。

[[File:~~media/image51~~zero3-img51.png~~|438x158px~~]]</li>

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

[[File:~~media/image52~~zero3-img52.png~~|576x113px~~]]</li>

<li>打开PhoenixCard后，如果TF卡识别正常，会在中间的列表中显示TF卡的盘符和容量，'''请务必确认显示的盘符和你想烧录的TF卡的盘符是一致的'''，如果没有显示可以尝试拔插下TF卡，或者点击PhoenixCard中的”'''刷新盘符'''”按钮</li>

[[File:~~media/image53~~zero3-img53-1.png~~|575x137px~~]]

</ol>

<li>确认完盘符后，先格式化TF卡，点击PhoenixCard中”'''恢复卡'''”按钮即可（如果”'''恢复卡'''”按钮为灰色的无法按下，可以先点击下”'''刷新盘符'''”按钮）

[[File:~~media/image54~~zero3-img54-1.png~~|575x316px~~]]

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

|-

<li>在”'''制作卡的种类'''”中选择”'''启动卡'''”</li>

<li>然后点击”'''烧卡'''”按钮就会开始烧录

[[File:~~media/image55~~zero3-img55-1.png~~|576x402px~~]]</li></ol>

</li>

<li>烧录完后PhoenixCard的显示如下图所示，此时点击”'''关闭'''”按钮即可退出PhoenixCard，然后就可以把TF卡从电脑中拔出来插到开发板中启动了

[[File:~~media/image56~~zero3-img56-1.png~~|575x354px~~]]

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

|-

|

<big>'''烧录完Android系统后在Windows中TF卡只能看到一个128 MB的分区，显示的分区如下图所示（有些电脑可能会弹出二十几个磁盘分区，但也只能打开128 MB的那个分区），请注意，这是正常的，请不要以为TF卡烧坏了。之所以这样，是因为安卓系统总共有二十几个分区，但大部分分区在Windows系统中是无法正常识别的。此时，请放心的拔下TF卡然后插入开发板中启动即可。'''</big>

[[File:~~media/image57~~zero3-img57.png|~~193x45px~~center]]

<big>'''安卓系统启动后，使用下面的命令可以看到TF卡中的这二十几个分区：'''</big>

[[File:~~media/image58~~zero3-img58.png|~~368x131px~~center]]

<big>'''使用df -h命令可以看到16GB的TF卡烧录完安卓系统后大概还有11 GB的空间可以用使用（二十几个分区并不会都挂载到安卓系统中，重点关注这些能看到的分区即可）。'''</big>

[[File:~~media/image59~~zero3-img59.png|~~391x220px~~center]]

|}

</li></ol>

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

[[File:~~media/image60~~zero3-img60-1.png~~|285x185px~~]]

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

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

[[File:~~media/image61~~zero3-img61.png~~|575x245px~~]]</li>

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

[[File:~~media/image62~~zero3-img62-1.png~~|328x185px~~]]</li>

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

</li>

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

[[File:~~media/image63~~zero3-img63.png~~|576x208px~~]]

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

|-

</li>

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

[[File:~~media/image64~~zero3-img64.png~~|332x290px~~]]</li>

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

[[File:~~media/image65~~zero3-img65.png~~|337x297px~~]]</li>

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

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

<li>设置'''Flow control'''为'''None'''

[[File:~~media/image66~~zero3-img66.png~~|398x352px~~]]</li></ol>

</li>

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

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

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

[[File:~~media/image67~~zero3-img67.png~~|375x332px~~]]</li></ol>

</li>

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

[[File:~~media/image68~~zero3-img68.png~~|376x249px~~]]</li></ol>

</li>

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

[[File:~~media/image69~~zero3-img69.png~~|382x233px~~]]</li>

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

[[File:~~media/image70~~zero3-img70.png~~|353x231px~~]]</li>

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

[[File:~~media/image71~~zero3-img71.png~~|322x175px|选区_232~~]]

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

</li>

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

[[File:~~media/image72~~zero3-img72.png~~|576x83px~~]]</li>

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

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

[[File:~~media/image73~~zero3-img73.png|~~575x291px~~1400px]]</ol>

</li></ol>

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

[[File:~~media/image74~~zero3-img74.png|~~575x291px~~1400px]]</li></ol>

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

[[File:~~media/image75~~zero3-img75.~~jpeg|216x154px|4ff86e49b6624616f9498fe44c366f29~~png]]

</div>

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

<li>上图所示的电源线USB ~~>~~ A口需要插到5V/2A或者5V/3A的电源适配器接头上（'''不建议插到电脑的USB接口来供电，如果开发板接的外设过多，使用会不稳定'''）</li>

<li>红色的杜邦线需要插到开发板26pin或者13pin接口的5V引脚上</li>

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

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

[[File:~~media/image24~~zero3-img24-1.png~~|163x174px~~]]</li></ol>

</li></ol>

<li>如果有购买Orange Pi的13pin扩展板，将扩展板插入开发板的13pin接口中，就可以扩展2个USB接口

[[File:~~media/image18~~zero3-img18.png~~|246x162px~~]]</li>

<li>如果没有13pin扩展板，可以使用4pin 2.54mm杜邦转USB2.0母头的线来扩展USB接口，具体方法如下所示：

<li>首先需要准备一根4pin 2.54mm杜邦转USB2.0母头的线（这种线在淘宝可以买到，请自行搜索购买），如下图所示：

[[File:~~media/image76~~zero3-img76.png~~|208x162px~~]] [[File:~~media/image77~~zero3-img77.png~~|237x165px~~]]</li>

<li>13pin接口的原理图如下所示

[[File:~~media/image19~~zero3-img19.png~~|265x142px~~]] [[File:~~media/image78~~zero3-img78.png~~|245x133px~~]]</li>

<li>USB2的接线如下所示

[[File:~~media/image79~~zero3-img79.png~~|256x189px~~]]</li>

<li>USB3的接线如下所示

[[File:~~media/image80~~zero3-img80.png~~|255x195px~~]]</li>

<li>如果需要在13pin接口上同时接两个USB设备，会发现13pin接口上的5V和GND引脚不够用，此时其中一个USB设备可以使用26pin接口中的5V和GND引脚，位置如下图所示：

[[File:~~media/image24~~zero3-img24-1.png~~|243x260px~~]]</li></ol>

</li></ol>

| style="text-align: left;"| '''支持'''

|-

| style="text-align: left;"| '''Ubuntu 22.04 - ~~Focal~~Jammy'''

| style="text-align: left;"| '''Linux5.4'''

| style="text-align: left;"| '''支持'''

[[File:~~media/image81~~zero3-img81.png~~|236x108px|659B0DE6-F15C-4005-A5F9-DFF881EE647B~~]]

</div>

<li>linux系统默认就是自动登录终端的，默认登录的用户名是'''orangepi'''

[[File:~~media/image82~~zero3-img82.png~~|475x240px~~]]</li>

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

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

[[File:~~media/image83~~zero3-img83.png~~|576x324px|1~~]]

</div></li>

[[File:~~media/image84~~zero3-img84.png~~|569x320px|IMG_256~~]]

</div>

</li>

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

[[File:~~media/image85~~zero3-img85.png~~|294x123px~~]]

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

|-

</li>

<li>然后选择'''System'''

[[File:~~media/image86~~zero3-img86.png~~|398x194px~~]]</li>

<li>然后选择'''Hardware'''

[[File:~~media/image87~~zero3-img87.png~~|393x202px~~]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''disable-leds'''

[[File:~~media/image88~~zero3-img88.png~~|397x35px~~]]</li>

<li>然后选择'''<Save>'''保存

[[File:~~media/image89~~zero3-img89.png~~|397x92px~~]]</li>

<li>然后选择'''<Back>'''

[[File:~~media/image90~~zero3-img90.png~~|395x91px~~]]</li>

<li>然后选择'''<Reboot>'''重启系统使配置生效

[[File:~~media/image91~~zero3-img91.png~~|374x187px~~]]</li>

<li>重启后完全进入系统就可以看到开发板上的两个LED灯都不会亮了</li></ol>

</li></ol>

</li>

<li>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况

[[File:~~media/image92~~zero3-img92.png~~|575x210px~~]]</li>

<li>上图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配</li></ol>

</li>

<li>第一次启动完Linux系统后，我们还可以将TF卡从开发板中取下来重新插入'''Ubuntu电脑'''，然后再次使用gparted查看下TF卡的情况，如下图所示，rootfs分区（/dev/sdc1）的容量已经扩展到了14.69GiB了

[[File:~~media/image93~~zero3-img93.png~~|575x211px~~]]

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

</li>

<li>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况。下图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配

[[File:~~media/image92~~zero3-img92.png~~|575x210px~~]]</li>

<li>然后选中rootfs分区（/dev/sdc1）

[[File:~~media/image94~~zero3-img94.png~~|575x211px~~]]</li>

<li>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区

[[File:~~media/image95~~zero3-img95.png~~|436x298px~~]]</li>

<li>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始扩容rootfs分区的大小

[[File:~~media/image96~~zero3-img96.png~~|444x302px~~]]</li>

<li>'''Resize/Move'''选项打开后会弹出下面的设置界面

[[File:~~media/image97~~zero3-img97.png~~|315x193px~~]]</li><li>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New ~~sieze~~size(MiB)'''中的数字来设置rootfs分区的大小[[File:~~media/image98~~zero3-img98.png~~|320x191px~~]]</li>

<li>设置好容量后，再点击右下角的'''Resize/Move'''即可

[[File:~~media/image99~~zero3-img99.png~~|327x196px~~]]</li>

<li>最后确认无误后，再点击下图所示的'''绿色 √'''

[[File:~~media/image100~~zero3-img100.png~~|392x270px~~]]</li>

<li>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量

[[File:~~media/image101~~zero3-img101.png~~|399x116px~~]]</li>

<li>扩容完成后点击'''Close'''关闭即可

[[File:~~media/image102~~zero3-img102.png~~|399x172px~~]]</li>

<li>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明手动扩容成功

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

</li>

<li>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况

[[File:~~media/image103~~zero3-img103.png~~|575x217px~~]]</li>

<li>然后选中rootfs分区（/dev/sdc1）

[[File:~~media/image104~~zero3-img104.png~~|575x217px~~]]</li>

<li>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区

[[File:~~media/image105~~zero3-img105.png~~|400x274px~~]]</li>

<li>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始设置rootfs分区的大小

[[File:~~media/image106~~zero3-img106.png~~|399x273px~~]]</li>

<li>'''Resize/Move'''选项打开后会弹出下面的设置界面

[[File:~~media/image107~~zero3-img107.png~~|315x188px~~]]</li><li>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New ~~sieze~~size(MiB)'''中的数字来设置rootfs分区的大小[[File:~~media/image98~~zero3-img98.png~~|318x190px~~]]</li></ol>

<li>设置好容量后，再点击右下角的'''Resize/Move'''即可

[[File:~~media/image99~~zero3-img99.png~~|327x196px~~]]</li>

<li>最后确认无误后，再点击下图所示的'''绿色 √'''

[[File:~~media/image100~~zero3-img100.png~~|392x270px~~]]</li>

<li>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量

[[File:~~media/image101~~zero3-img101.png~~|365x106px~~]]</li>

<li>扩容完成后点击'''Close'''关闭即可

[[File:~~media/image102~~zero3-img102.png~~|379x164px~~]]</li>

<li>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明缩小容量成功

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

|-

|

<big>'''下面的命令请不要照抄，比如debian12中的网络节点名为end0，下面的命令就需要修改为ping www.baidu.com -I ~~end0。~~end0。（这里是大写的字母I，不是小写的字母L）'''</big>

|}

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

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

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

[[File:~~media/image108~~zero3-img108.png~~|575x250px|选区_011~~]]

</div></li>

|-

|

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

PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data.

64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms

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

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

<li>如果开发板连接好了调试串口，可以使用串口终端登录linux系统（串口软件请使用MobaXterm，使用minicom无法显示图形界面）</li>

<li>如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统</li></ol>

</li>

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

[[File:~~media/image109~~zero3-img109.png~~|345x215px~~]]</li>

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

[[File:~~media/image110~~zero3-img110.png~~|349x216px~~]]</li>

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

[[File:~~media/image111~~zero3-img111.png~~|360x229px~~]]</li>

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

[[File:~~media/image112~~zero3-img112.png~~|366x230px~~]]</li>

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

[[File:~~media/image113~~zero3-img113.png~~|352x225px~~]]</li>

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

[[File:~~media/image114~~zero3-img114.png~~|349x223px~~]]</li>

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

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

|-

|

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

PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data.

64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms

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

[[File:~~media/image115~~zero3-img115.png~~|275x121px~~]]</li>

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

[[File:~~media/image116~~zero3-img116.png~~|576x353px~~]]</li>

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

[[File:~~media/image117~~zero3-img117.png~~|288x147px~~]]</li>

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

[[File:~~media/image118~~zero3-img118.png~~|465x249px~~]]</li>

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

[[File:~~media/image119~~zero3-img119.png~~|576x273px|5~~]]

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

</li>

<li>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击 '''orangepi'''连接热点，密码就是上面设置的'''orangepi'''

[[File:~~media/image120~~zero3-img120.png~~|230x183px~~]]</li>

<li>连接成功后的显示如下图所示

[[File:~~media/image121~~zero3-img121.png~~|233x111px~~]]</li>

<li>在NAT模式下，连接到开发板热点的无线设备是向开发板的DHCP服务请求IP地址的，所以会有两个不同的网段，如这里开发板的IP是192.168.1.X

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

|}

而开发板的DHCP服务默认会给接入热点的设备分配'''192.168.12.0/24'''的IP地址，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址是'''192.168.12.X'''。

[[File:~~media/image121~~zero3-img121.png~~|271x129px~~]][[File:~~media/image122~~zero3-img122-1.png~~|274x155px~~]]</li>

<li>如果想要为接入的设备指定不同的网段，可以通过-g参数指定，如通过-g参数指定接入点AP的网段为192.168.2.1

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

[[File:~~media/image121~~zero3-img121.png~~|286x137px~~]]

[[File:~~media/image123~~zero3-img123.png~~|302x174px~~]]

</li></ol>

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

[[File:~~media/image124~~zero3-img124.png~~|237x198px~~]]

</li></ol>

</li>

<li>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击'''orangepi'''连接热点，密码就是上面设置的'''orangepi'''

[[File:~~media/image120~~zero3-img120.png~~|265x211px~~]]</li>

<li>连接成功后的显示如下图所示

[[File:~~media/image121~~zero3-img121.png~~|273x130px~~]]</li>

<li>在bridge模式下，连接到开发板热点的无线设备也是向主路由（开发板连接的路由器）的DHCP服务请求IP地址的，如这里开发板的IP是'''192.168.1.X'''

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

|}

而接入WIFI热点的设备的IP也是由主路由分配的，所以连接WIFI热点的手机和开发板处于相同的网段，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址也是'''192.168.1.X'''。

[[File:~~media/image121~~zero3-img121.png~~|284x136px~~]][[File:~~media/image125~~zero3-img125.png~~|282x159px~~]]</li>

<li>在不指定'''--freq-band'''参数的情况下，默认创建的热点是2.4G频段的，如果想要创建5G频段的热点可以通过'''--freq-band 5'''参数指定，具体命令如下

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

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

[[File:~~media/image124~~zero3-img124.png~~|228x191px~~]]

</li></ol>

</li>

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

[[File:~~media/image126~~zero3-img126.png~~|227x247px~~]]</li>

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

[[File:~~media/image127~~zero3-img127.png~~|310x149px~~]]</li>

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

[[File:~~media/image128~~zero3-img128.png~~|316x144px~~]]</li>

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

[[File:~~media/image129~~zero3-img129.png~~|575x240px~~]]</li>

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

[[File:~~media/image130~~zero3-img130.png~~|576x237px~~]]</li>

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

[[File:~~media/image131~~zero3-img131.png~~|575x240px~~]]</li>

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

[[File:~~media/image132~~zero3-img132.png~~|576x241px~~]]</li>

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

[[File:~~media/image133~~zero3-img133.png~~|575x450px~~]]</li>

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

[[File:~~media/image134~~zero3-img134-1.png~~|576x233px~~]]</li>

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

[[File:~~media/image135~~zero3-img135.png~~|576x116px~~]]</li>

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

[[File:~~media/image136~~zero3-img136.png~~|330x325px~~]]</li>

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

[[File:~~media/image137~~zero3-img137.png~~|331x248px~~]]</li>

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

[[File:~~media/image138~~zero3-img138.png~~|576x224px~~]]</li>

<li>然后请不要移动光标，再按下回车键重新使能'''Wired connection 1'''，这样前面设置的静态IP地址就会生效了

[[File:~~media/image139~~zero3-img139.png~~|576x224px~~]]</li>

<li>然后通过'''<Back>'''和'''Quit'''按钮就可以退出nmtui

[[File:~~media/image140~~zero3-img140.png~~|300x253px~~]] [[File:~~media/image141~~zero3-img141.png~~|227x252px~~]]</li>

<li>然后通过'''ip a s eth0'''就能看到网口的IP地址已经变成前面设置的静态IP地址了

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

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

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

[[File:~~media/image142~~zero3-img142.png~~|575x273px~~]]

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

|-

<li>然后在'''Session Setting'''中选择'''SSH'''</li>

<li>然后在'''Remote host'''中输入开发板的IP地址</li>

<li>然后在'''Specify ~~>~~ username'''中输入linux系统的用户名'''root'''或'''orangepi'''</li>

<li>最后点击'''OK'''即可

[[File:~~media/image143~~zero3-img143.png~~|576x292px~~]]</li></ol>

</li>

<li>然后会提示输入密码，默认root和orangepi用户的密码都为orangepi

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

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

[[File:~~media/image145~~zero3-img145.png~~|559x388px~~]]</li></ol>

[[File:~~media/image13~~zero3-img13.~~jpeg|151x151px|IMG_6109(20211221-181051)~~png]]

</div></li>

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

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

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

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

~~~~

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

<li>HDMI转VGA转换器

[[File:~~media/image146~~zero3-img146.png~~|155x104px~~]]</li>

<li>一根VGA线和一根Micro HDMI公转HDMI母转接线

[[File:~~media/image147~~zero3-img147.png|~~148x133px~~400px]] [[File:~~media/image148~~zero3-img148.~~jpeg~~png|~~157x139px|IMG_6140(20220104-134930)~~400px]]</li>

<li>一个支持VGA接口的显示器或者电视</li></ol>

</li>

<li>HDMI转VGA显示测试如下所示

[[File:~~media/image149~~zero3-img149.png~~|574x336px~~]]{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''使用HDMI转VGA显示时，开发板以及开发板的Linux系统是不需要做任何设置的，只需要开发板Micro HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</big>|}</li></ol>

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

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

<li>在linux系统的'''/boot/orangepiEnv.txt'''中有个disp_mode变量，可以通过它来设置HDMI输出的分辨率，linux系统默认设置的分辨率为1080p60

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

|-

|

orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''

verbosity=1

console=both

disp_mode='''1080p60'''

fb0_width=1920

fb0_height=1080|}</li><li>disp_mode变量支持设置的值如下表所示</li~~></ol~~>

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

|-

| style="text-align: left;"| '''disp_mode支持的值'''

|}

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意：Linux系统目前不支持4K分辨率。'''</big>|}</ol>

<li>将disp_mode变量的值修改为想要输出的分辨率，然后重启系统，HDMI就会输出所设置的分辨率了</li>

<li>查看HDMI输出分辨率的方法如下所示，如果显示的分辨率和设置的分辨率一样，说明开发板这端的设置正确

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

|-

|

orangepi@orangepi:~$ '''sudo cat /sys/class/disp/disp/attr/sys'''

|}[[File:~~media/image150~~zero3-img150.png~~|575x84px~~]]</li></ol>

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

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

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

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

|-

|

orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''

disp_mode=1080p60

'''fb0_width=1920'''

'''fb0_height=1080'''|}

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

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

|-

| style="text-align: left;"| '''HDMI分辨率'''

=== Framebuffer光标设置 ===

<li>Framebuffer使用的softcursor，设置光标闪烁或者不闪烁的方法如下所示

{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''echo 1 > /sys/class/graphics/fbcon/cursor_blink #光标闪烁'''root@orangepi:~# '''echo 0 > /sys/class/graphics/fbcon/cursor_blink #光标不闪烁'''|}</li>

<li>如果需要隐藏光标，可以在'''/boot/orangepiEnv.txt'''的'''extraargs'''变量（'''extraargs'''的值会赋值给'''bootargs'''环境变量最终传递给内核）中加入'''vt.global_cursor_default=0'''（如果'''vt.global_cursor_default=1'''则是显示光标），然后重启系统就能看到光标已经消失

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

|-

|

orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''

verbosity=1

fb0_width=1920

fb0_height=1080

'''extraargs=vt.global_cursor_default=0'''|}</li></ol>

== 蓝牙使用方法 ==

<li>点击桌面右上角的蓝牙图标

[[File:~~media/image151~~zero3-img151.png~~|314x122px~~]]</li>

<li>然后选择适配器

[[File:~~media/image152~~zero3-img152.png~~|318x140px~~]]</li>

<li>如果有提示下面的界面，请选择'''Yes'''

[[File:~~media/image153~~zero3-img153.png~~|248x85px~~]]</li>

<li>然后在蓝牙的适配器设置界面中设置'''Visibility Setting'''为'''Always visible'''，然后关闭即可

[[File:~~media/image154~~zero3-img154.png~~|196x183px~~]]</li>

<li>然后打开蓝牙设备的配置界面

[[File:~~media/image155~~zero3-img155.png~~|438x179px~~]]</li>

<li>点击'''Search'''即可开始扫描周围的蓝牙设备

[[File:~~media/image156~~zero3-img156.png~~|311x210px~~]]</li>

<li>然后选择想要连接的蓝牙设备，再点击鼠标右键就会弹出对此蓝牙设备的操作界面，选择'''Pair'''即可开始配对，这里演示的是和Android手机配对

[[File:~~media/image157~~zero3-img157.png~~|311x242px~~]]</li>

<li>配对时，桌面的右上角会弹出配对确认框，选择'''Confirm'''确认即可，此时手机上也同样需要进行确认

[[File:~~media/image158~~zero3-img158.png~~|411x150px~~]]</li>

<li>和手机配对完后，可以选择已配对的蓝牙设备，然后右键选择'''Send a File'''即可开始给手机发送一张图片

[[File:~~media/image159~~zero3-img159.png~~|405x239px~~]]</li>

<li>发送图片的界面如下所示

[[File:~~media/image160~~zero3-img160.png~~|399x231px~~]]</li></ol>

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

<li>进入系统后首先可以通过'''hciconfig'''命令来查看是否存在蓝牙的设备节点，如果存在，说明蓝牙初始化正常

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

|-

|

orangepi@orangepi:~$ '''sudo apt update && sudo apt install -y bluez'''

orangepi@orangepi:~$ '''hciconfig -a'''

hci0: Type: Primary Bus: UART

:BD Address: 3E:61:3D:19:0E:52 ACL MTU: 1021:8 SCO MTU: 240:3:UP RUNNING:RX bytes:925 acl:0 sco:0 events:72 errors:0:TX bytes:5498 acl:0 sco:0 commands:72 errors:0:Features: 0xbf 0xff 0x8d 0xfe 0xdb 0x3d 0x7b 0xc7:Packet type: DM1 DM3 DM5 DH1 DH3 DH5 HV1 HV2 HV3:Link policy: RSWITCH SNIFF:Link mode: SLAVE ACCEPT:Name: 'orangepi':Class: 0x3c0000:Service Classes: Rendering, Capturing, Object Transfer, Audio:Device Class: Miscellaneous,:HCI Version: 5.0 (0x9) Revision: 0x400:LMP Version: 5.0 (0x9) Subversion: 0x400:Manufacturer: Spreadtrum Communications Shanghai Ltd (492)|}</li>

<li>使用'''bluetoothctl'''扫描蓝牙设备

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

|-

|

orangepi@orangepi:~$ '''sudo bluetoothctl'''

[NEW] Controller 10:11:12:13:14:15 orangepizero3 [default]

Discovery stopped

[CHG] Controller 10:11:12:13:14:15 Discovering: no

[CHG] Device DC:72:9B:4C:F4:CF RSSI is nil|}</li>

<li>扫描到想配对的设备后就可以进行配对了，配对需要使用设备的MAC地址

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

|-

|

[bluetooth]# '''pair DC:72:9B:4C:F4:CF''' '''#使用扫描到的蓝牙设备的MAC地址进行配对'''

Attempting to pair with DC:72:9B:4C:F4:CF

'''Pairing successful #提示配对成功'''

[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: no

[CHG] Device DC:72:9B:4C:F4:CF Connected: no|}</li>

<li>配对成功后，手机蓝牙界面的显示如下所示

[[File:~~media/image161~~zero3-img161.png~~|189x167px~~]]</li>

<li>连接蓝牙设备需要安装 '''pulseaudio-module-bluetooth'''软件包，然后再启动'''pulseaudio''' 服务

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

|-

|

orangepi@orangepi:~$ '''sudo apt update'''

orangepi@orangepi:~$ '''sudo''' '''apt -y install pulseaudio-module-bluetooth'''

orangepi@orangepi:~$ '''pulseaudio --start'''|}</li>

<li>连接蓝牙设备的方法

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

|-

|

orangepi@orangepi:~$ '''sudo bluetoothctl'''

Agent registered

[bluetooth]# '''paired-devices          #查看已配对的蓝牙设备的MAC地址'''

Device DC:72:9B:4C:F4:CF orangepi

[bluetooth]# '''connect DC:72:9B:4C:F4:CF          #使用MAC地址连接蓝牙设备'''

Attempting to connect to DC:72:9B:4C:F4:CF

[CHG] Device DC:72:9B:4C:F4:CF Connected: yes

[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: yes

[CHG] Controller 10:11:12:13:14:15 Discoverable: no

'''[orangepi]#          #出现这个提示符说明连接成功'''|}</li>

<li>连接完蓝牙设备后，Android手机的蓝牙配置界面就可以看到'''已连接用于通话和媒体的音频'''的提示

[[File:~~media/image162~~zero3-img162.~~jpeg|223x232px|Screenshot_20201205_142413~~png]]

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

== USB接口测试 ==

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

# 执行下面的命令如果能看到sdX的输出说明U盘识别成功

::{| class="wikitable" style="width:800px;"|-|orangepi@orangepi:~$ '''cat /proc/partitions | grep "sd*"''' major minor #blocksname 8030044160 '''sda''' 8130043119 '''sda1''' |}

~~major minor #blocks name~~ ~~8 0 30044160 '''sda'''~~ ~~8 1 30043119 '''sda1'''~~ <ol start="3" style="list-style-type: decimal;"><li>使用mount命令可以将U盘挂载到'''/mnt'''中，然后就能查看U盘中的文件了</li~~></ol~~>

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

|-

|

orangepi@orangepi:~$ '''sudo mount /dev/sda1 /mnt/'''

test.txt

|}</ol>

<li>挂载完后通过'''df -h'''命令就能查看U盘的容量使用情况和挂载点</li~~></ol~~>

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

|-

|

orangepi@orangepi:~$ '''df -h | grep "sd"'''

/dev/sda1     29G    208K    29G    1% /mnt|}</ol>

~~~~

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

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

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

|-

| style="text-align: left;"| 序号

<li>首先将USB网卡插入开发板的USB接口中，然后在USB网卡中插入网线，确保网线能正常上网，如果通过'''dmesg'''命令可以看到下面的log信息，说明USB网卡识别正常

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

|-

|

orangepi@orangepi:~$ '''dmesg | tail'''

[ 121.985016] usb 3-1: USB disconnect, device number 2

[ 127.763031] IPv6: ADDRCONF(NETDEV_UP): enx00e04c362017: link is not ready

[ 129.892465] r8152 3-1:1.0 enx00e04c362017: carrier on

[ 129.892583] IPv6: ADDRCONF(NETDEV_CHANGE): enx00e04c362017: link becomes ready|}</li>

<li>然后通过ifconfig命令可以看到USB网卡的设备节点，以及自动分配的IP地址

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

|-

|

orangepi@orangepi:~$ '''sudo ifconfig'''

'''enx00e04c362017''': flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500

::inet '''192.168.1.177''' netmask 255.255.255.0 broadcast 192.168.1.255::inet6 fe80::681f:d293:4bc5:e9fd prefixlen 64 scopeid 0x20<link>::ether 00:e0:4c:36:20:17 txqueuelen 1000 (Ethernet)::RX packets 1849 bytes 134590 (134.5 KB)::RX errors 0 dropped 125 overruns 0 frame 0::TX packets 33 bytes 2834 (2.8 KB)::TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0|}</li>

<li>测试网络连通性的命令如下

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

|-

|

orangepi@orangepi:~$ '''ping www.baidu.com -I enx00e04c362017'''

PING www.a.shifen.com (14.215.177.38) from 192.168.1.12 eth0: 56(84) bytes of data.

--- www.a.shifen.com ping statistics ---

4 packets transmitted, 4 received, 0% packet loss, time 3002ms

rtt min/avg/max/mdev = 6.260/6.770/7.275/0.373 ms|}</li></ol>

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

<li>首先将USB摄像头插入到Orange Pi开发板的USB接口中</li>

<li>然后通过lsmod命令可以看到内核自动加载了下面的模块

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

|-

|

orangepi@orangepi:~$ '''lsmod'''

<pspan style="margin-right: 100px;">Module Size Used by</pspan> <pspan style="margin-right: 100px;">~~'''~~uvcvideo 106496 0~~'''~~</pspan> |}</li>

<li>通过v4l2-ctl命令可以看到USB摄像头的设备节点信息为/dev/video0

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

|-

|

orangepi@orangepi:~$ '''sudo apt update'''

orangepi@orangepi:~$ '''sudo''' '''apt install -y v4l-utils'''

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

USB 2.0 Camera (usb-sunxi-ehci-1):

:/dev/video0|}{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意v4l2中的l是小写字母l，不是数字1。''''''另外video的序号不一定都是video0，请以实际看到的为准。'''</big>|}</li>

<li>使用fswebcam测试USB摄像头

<li>安装fswebcam

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

|-

|

orangepi@orangepi:~$ '''sudo''' '''apt update'''

orangepi@orangepi:~$ '''sudo apt-get install -y fswebcam'''|}</li>

<li>安装完fswebcam后可以使用下面的命令来拍照

<ol style="list-style-type: ~~lower-alpha~~none;"><li>a) -d 选项用于指定USB摄像头的设备节点</li><li>b) --no-banner用于去除照片的水印</li><li>c) -r 选项用于指定照片的分辨率</li><li>d) -S 选项用设置于跳过前面的帧数</li><li>e) ./image.jpg 用于设置生成的照片的名字和路径{| class="wikitable" style="width:800px;" |-|

orangepi@orangepi:~$ '''sudo''' '''fswebcam -d /dev/video0 \'''

'''--no-banner -r 1280x720 -S 5 ./image.jpg'''|}</li></ol>

</li>

<li>在服务器版的linux系统中，拍完照后可以使用scp命令将拍好的图片传到Ubuntu > PC上镜像观看

{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''scp image.jpg [mailto:test@192.168.1.55:/home/test test@192.168.1.55:/home/test] （根据实际情况修改IP地址和路径）'''|}</li>

<li>在桌面版的linux系统中，可以通过HDMI显示器直接查看拍摄的图片</li></ol>

</li>

<li>下载mjpg-streamer

<ol style="list-style-type: ~~lower-alpha~~none;"><li>a) Github的下载地址：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''git clone https://github.com/jacksonliam/mjpg-streamer'''|}</li><li>b) Gitee的镜像下载地址为：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''git clone https://gitee.com/leeboby/mjpg-streamer'''|}</li></ol>

</li>

<li>安装依赖的软件包

<ol style="list-style-type: ~~lower-alpha~~none;"><li>a) Ubuntu系统{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo apt-get install -y cmake libjpeg8-dev'''|}</li><li>b) Debian系统{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo apt-get install -y cmake libjpeg62-turbo-dev'''|}</li></ol>

</li>

<li>编译安装mjpg-streamer

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

|-

|

orangepi@orangepi:~$ '''cd mjpg-streamer/mjpg-streamer-experimental'''

orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''make -j4'''

orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''sudo make install'''|}</li>

<li>然后输入下面的命令启动mjpg_streamer

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，video的序号不一定都是video0，请以实际看到的为准。'''</big>|}{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''export LD_LIBRARY_PATH=.'''orangepi@orangepi:~/mjpg-streamer/mjpg-streamer-experimental$ '''sudo ./mjpg_streamer -i "./input_uvc.so -d \''''''/dev/video0 -u -f 30" -o "./output_http.so -w ./www"'''|}</li>

<li>然后在和开发板同一局域网的Ubuntu PC或者Windows > PC或者手机的浏览器中输入【'''开发板的IP地址:8080'''】就能看到摄像头输出的视频了

[[File:~~media/image163~~zero3-img163.png~~|575x279px|选区_021~~]]

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

[[File:~~media/image164~~zero3-img164.~~jpeg|126x125px|IMG_256~~png]]

</div></li>

<li>通过'''aplay -l'''命令可以查看linux系统支持的声卡设备

<li>linux5.4系统的输出如下所示，其中'''card 0: ~~>~~ audiocodec'''就是耳机播放需要的声卡设备{| class="wikitable" style="width:800px;" |-|

root@orangepi:~# '''aplay -l'''

**** List of PLAYBACK Hardware Devices ****

'''card 0: audiocodec [audiocodec], device 0: SUNXI-CODEC sun50iw9-codec-0 []'''

:'''Subdevices: 1/1''':'''Subdevice #0: subdevice #0'''|}</li>

<li>linux6.1系统的输出如下所示，其中'''audiocodec'''就是耳机播放需要的声卡设备

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

|-

|

root@orangepi:~# '''aplay -l'''

**** List of PLAYBACK Hardware Devices ****

'''card 0: audiocodec [audiocodec], device 0: CDC PCM Codec-0 [CDC PCM Codec-0]'''

:'''Subdevices: 1/1''':'''Subdevice #0: subdevice #0'''|}</li></ol>

</li>

<li>然后使用'''aplay'''命令播放音频，耳机就能听到声音了

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

|-

|

root@orangepi:~# '''aplay -D hw:0,0 /usr/share/sounds/alsa/audio.wav'''

Playing WAVE 'audio.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo~~</li></ol>~~|}

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

~~~~

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

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

<li>HDMI音频播放无需其他设置，直接使用'''aplay'''命令播放即可

{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''aplay -D hw:2,0 /usr/share/sounds/alsa/audio.wav'''|}</li></ol>

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

<li>首先打开文件管理器

[[File:~~media/image165~~zero3-img165.png~~|257x126px~~]]</li>

<li>然后找到下面这个文件（如果系统中没有这个音频文件，可以自己上传一个音频文件到系统中）

[[File:~~media/image166~~zero3-img166.png~~|238x189px~~]]</li>

<li>然后选中audio.wav文件，右键选择使用vlc打开就可以开始播放

[[File:~~media/image167~~zero3-img167.png~~|241x195px~~]]</li>

<li>切换HDMI播放和耳机播放等不同音频设备的方法

<li>首先打开音量控制界面

[[File:~~media/image168~~zero3-img168.png~~|294x161px~~]]</li>

<li>播放音频的时候，在'''Playback'''中会显示播放软件可以使用的音频设备选项，如下图所示，在这里可以设置需要播放到哪个音频设备

[[File:~~media/image169~~zero3-img169.png~~|576x324px|4~~]]

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

[[File:~~media/image164~~zero3-img164.~~jpeg|164x163px|IMG_256~~png]]

</div></li>

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

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

|-

|

orangepi@orangepi:~$ '''sudo''' '''apt update'''

orangepi@orangepi:~$ '''sudo''' '''apt-get install -y ir-keytable'''

|}</li></ol>

<li>然后执行ir-keytable可以查看红外设备的信息

<li>linux5.4系统输出如下所示</li~~></ol></li></ol~~>

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

|-

|

orangepi@orangepi:~$ '''ir-keytable'''

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

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

:lirc device: /dev/lirc0

:Supported protocols: lirc nec

:Enabled protocols: lirc nec

:Name: sunxi_ir_recv

:bus: 25, vendor/product: 0001:0001, version: 0x0100 ~~Repeat delay = 500 ms, repeat period = 125 ms~~

:Repeat delay = 500 ms, repeat period = 125 ms

|}

</ol>

<li>linux6.1系统的输出如下所示

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

Found /sys/class/rc/rc0/ with:

:Name: sunxi-ir:Driver: sunxi-ir:Default keymap: rc-empty:Input device: /dev/input/event5:LIRC device: /dev/lirc0:Attached BPF protocols: Operation not permitted:Supported kernel protocols: lirc rc-5 rc-5-sz jvc sony nec sanyo mce_kbd rc-6 sharp xmp imon rc-mm:Enabled kernel protocols: lirc:bus: 25, vendor/product: 0001:0001, version: 0x0100:Repeat delay = 500 ms, repeat period = 125 ms|}</li></ol></li></ol>

<li>测试红外接收功能前需要准备一个Orange Pi专用的红外遥控器，'''其他遥控器不支持'''

[[File:~~media/image170~~zero3-img170.~~jpeg|140x131px|IMG_256~~png]]

</div></li>

<li>然后在终端中输入'''ir-keytable -t'''命令，再使用红外遥控器对着Orange Pi开发板的红外接收头按下按键就能在终端中看到接收到的按键编码了

<li>linux5.4系统输出如下所示</li~~></ol></li></ol~~>

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

|-

|

orangepi@orangepi:~$ '''sudo ir-keytable -t'''

1598339152.914715: event type EV_MSC(0x04): scancode = 0xfb0410

|}</ol>

<li>linux6.1系统输出如下所示

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

|-

|

orangepi@orangepi:~$ '''sudo ir-keytable -c -p NEC -t'''

Old keytable cleared

202.063219: lirc protocol(nec): scancode = 0x45c

202.063249: event type EV_MSC(0x04): scancode = 0x45c

202.063249: event type EV_SYN(0x00).|}</li></ol></li></ol>

== 温度传感器 ==

=== linux5.4系统查看温度的方法 ===

# H618总共有4个温度传感器，查看温度的命令如下所示：

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

<li>sensor0：CPU的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值</li~~></ol~~>

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

|-

|

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

'''57734'''

|}</ol>

<li>sensor1：DDR的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值

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

|-

|

orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone1/type'''

'''ddr'''_thermal_zone

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

'''57410'''|}</li>

<li>sensor2：GPU的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值

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

|-

|

orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone2/type'''

'''gpu'''_thermal_zone

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

'''59273'''|}</li>

<li>sensor3：VE的温度传感器，第一条命令用于查看温度传感器的类型，第二条命令用于查看温度传感器的数值

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

|-

|

orangepi@orangepi:~$ '''cat /sys/class/thermal/thermal_zone3/type'''

'''ve'''_thermal_zone

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

'''58949'''|}</li></ol>

~~<ol start~~=~~"2" style~~=~~"list-style-type: decimal;"><li>Linux6~~= linux6.~~1内核的系统还可以使用'''sensors'''命令查看系统当前温度</li></ol>~~1系统查看温度的方法 ===

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

|-

|

orangepi@orangepi:~$ '''sensors'''

Adapter: Virtual device

temp1:      +'''47.4°C'''    (crit = +110.0°C)

gpu_thermal-virtual-0

Adapter: Virtual device

temp1:      +'''48.7°C'''    (crit = +110.0°C)

ddr_thermal-virtual-0

Adapter: Virtual device

temp1:      +'''47.8°C'''    (crit = +110.0°C)

ve_thermal-virtual-0

Adapter: Virtual device

temp1:      +'''47.2°C'''    (crit = +110.0°C)|}

~~~~

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

<li>开发板13 pin扩展板接口引脚的顺序请参考下图

[[File:~~media/image78~~zero3-img78.png~~|245x133px~~]]</li>

<li>开发板13pin接口的原理图如下所示

[[File:~~media/image19~~zero3-img19.png~~|359x193px~~]]</li>

<li>开发板13 pin扩展板接口引脚的功能说明如下

<li>13pin引脚接扩展板时，可以额外提供

<ol style="list-style-type: ~~lower-alpha~~none;"><li>a) 2个USB 2.0 Host</li><li>b) 耳机左右声道音频输出</li><li>c) TV-OUT视频输出</li><li>d) 红外接收功能</li><li>e) 接了扩展板后13pin接口的10、11和12号引脚就无法使用了</li><li>'''f) 另外需要注意13pin扩展板上的MIC在Orange Pi Zero ~~3上是无法使用的~~3上是无法使用的'''</li></ol>

</li>

<li>13pin引脚不接扩展板时，10、11、12和13号引脚可当作普通GPIO口来使用</li~~></ol></li></ol~~>

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

|-

| style="text-align: left;"| '''GPIO序号'''

| style="text-align: left;"| '''9'''

|-

| style="text-align: left;"| '''65'''| style="text-align: left;"| '''PC1'''| style="text-align: left;"| '''10'''

|-

| style="text-align: left;"| '''272'''| style="text-align: left;"| '''PI16'''| style="text-align: left;"| '''11'''

|-

| style="text-align: left;"| '''262'''| style="text-align: left;"| '''PI6'''| style="text-align: left;"| '''12'''

|-

|}

</ol>

</li></ol>

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

<li>Orange Pi Zero 3开发板26 pin接口引脚的顺序请参开发板上的丝印图

[[File:~~media/image171~~zero3-img171-1.png~~|389x125px~~]]</li><li>开发板26 pin接口引脚的功能如下表所示</li~~></ol~~>

<div style="display: flex;">{| class="wikitable" style="width:300px;margin-right: 20px"

|-

| style="text-align: left;"| '''GPIO序号'''

| style="text-align: left;"| '''功能'''

| style="text-align: left;"| '''引脚'''

|

~~| style="text-align: left;"| '''引脚'''~~

~~| style="text-align: left;"| '''功能'''~~

~~| style="text-align: left;"| '''GPIO'''~~

~~| style="text-align: left;"| '''GPIO序号'''~~

|-

| style="text-align: left;"|

| style="text-align: left;"| '''3.3V'''

| style="text-align: left;"| '''1'''

|

~~| style="text-align: left;"| '''2'''~~

~~| style="text-align: left;"| '''5V'''~~

~~| style="text-align: left;"|~~

|-

| style="text-align: left;"| '''229'''

| style="text-align: left;"| '''TWI3-SDA'''

| style="text-align: left;"| '''3'''

|

~~| style="text-align: left;"| '''4'''~~

~~| style="text-align: left;"| '''5V'''~~

~~| style="text-align: left;"|~~

|-

| style="text-align: left;"| '''228'''

| style="text-align: left;"| '''TWI3-SCK'''

| style="text-align: left;"| '''5'''

|

~~| style="text-align: left;"| '''6'''~~

~~| style="text-align: left;"| '''GND'''~~

~~| style="text-align: left;"|~~

|-

| style="text-align: left;"| '''73'''

| style="text-align: left;"| '''PC9'''

| style="text-align: left;"| '''7'''

|

~~| style="text-align: left;"| '''8'''~~

~~| style="text-align: left;"| '''UART5_TX'''~~

~~| style="text-align: left;"| '''PH2'''~~

~~| style="text-align: left;"| '''226'''~~

|-

| style="text-align: left;"|

| style="text-align: left;"| '''GND'''

| style="text-align: left;"| '''9'''

|

~~| style="text-align: left;"| '''10'''~~

~~| style="text-align: left;"| '''UART5_RX'''~~

~~| style="text-align: left;"| '''PH3'''~~

~~| style="text-align: left;"| '''227'''~~

|-

| style="text-align: left;"| '''70'''

| style="text-align: left;"| '''PC6'''

| style="text-align: left;"| '''11'''

|

~~| style="text-align: left;"| '''12'''~~

~~| style="text-align: left;"| '''PC11'''~~

~~| style="text-align: left;"| '''75'''~~

|-

| style="text-align: left;"| '''69'''

| style="text-align: left;"| '''PC5'''

| style="text-align: left;"| '''13'''

|~~| style="text-align: left;"| '''14'''| style="text-align: left;"| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~|-

| style="text-align: left;"| '''72'''

| style="text-align: left;"| '''PC8'''

| style="text-align: left;"| '''15'''

|

~~| style="text-align: left;"| '''16'''~~

~~| style="text-align: left;"| '''PC15'''~~

~~| style="text-align: left;"| '''79'''~~

|-

| style="text-align: left;"|

| style="text-align: left;"| '''3.3V'''

| style="text-align: left;"| '''17'''

|

~~| style="text-align: left;"| '''18'''~~

~~| style="text-align: left;"| '''PC14'''~~

~~| style="text-align: left;"| '''78'''~~

|-

| style="text-align: left;"| '''231'''

| style="text-align: left;"| '''SPI1_MOSI'''

| style="text-align: left;"| '''19'''

|

~~| style="text-align: left;"| '''20'''~~

~~| style="text-align: left;"| '''GND'''~~

~~| style="text-align: left;"|~~

|-

| style="text-align: left;"| '''232'''

| style="text-align: left;"| '''SPI1_MISO'''

| style="text-align: left;"| '''21'''

|

~~| style="text-align: left;"| '''22'''~~

~~| style="text-align: left;"| '''PC7'''~~

~~| style="text-align: left;"| '''71'''~~

|-

| style="text-align: left;"| '''230'''

| style="text-align: left;"| '''SPI1_CLK'''

| style="text-align: left;"| '''23'''

|

~~| 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;"|

| style="text-align: left;"| '''GND'''

| style="text-align: left;"| '''25'''

|

~~| style="text-align: left;"| '''26'''~~

~~| style="text-align: left;"| '''PC10'''~~

~~| style="text-align: left;"| '''74'''~~

|}

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

|-

| style="text-align: left;"| '''引脚'''

| style="text-align: left;"| '''功能'''

| style="text-align: left;"| '''GPIO'''

| style="text-align: left;"| '''GPIO序号'''

|-

| style="text-align: left;"| '''2'''

| style="text-align: left;"| '''5V'''

| style="text-align: left;"|

|-

| style="text-align: left;"| '''4'''

| style="text-align: left;"| '''5V'''

| style="text-align: left;"|

|-

| style="text-align: left;"| '''6'''

| style="text-align: left;"| '''GND'''

| style="text-align: left;"|

|-

| style="text-align: left;"| '''8'''

| style="text-align: left;"| '''UART5_TX'''

| style="text-align: left;"| '''PH2'''

| style="text-align: left;"| '''226'''

|-

| style="text-align: left;"| '''10'''

| style="text-align: left;"| '''UART5_RX'''

| style="text-align: left;"| '''PH3'''

| style="text-align: left;"| '''227'''

|-

| style="text-align: left;"| '''12'''

| style="text-align: left;"| '''PC11'''

| style="text-align: left;"| '''75'''

|-

| style="text-align: left;"| '''14'''

| style="text-align: left;"| '''GND'''

| style="text-align: left;"|

|-

| style="text-align: left;"| '''16'''

| style="text-align: left;"| '''PC15'''

| style="text-align: left;"| '''79'''

|-

| style="text-align: left;"| '''18'''

| style="text-align: left;"| '''PC14'''

| style="text-align: left;"| '''78'''

|-

| style="text-align: left;"| '''20'''

| style="text-align: left;"| '''GND'''

| style="text-align: left;"|

|-

| style="text-align: left;"| '''22'''

| 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;"| '''74'''

|}

</div>

</ol>

<li>26pin接口中总共有'''17'''个GPIO口，所有GPIO口的电压都是'''3.3v'''</li></ol>

~~<ol start="3" style="list-style-type: decimal;"><li>26pin接口中总共有'''17'''个GPIO口，所有GPIO口的电压都是'''3.3v'''</li></ol>~~ ~~~~== 安装wiringOP的方法 == ~~'''注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。'''~~ ~~'''编译好的wiringOP的deb包在orangepi-build中的存放路径为：'''~~ ~~'''orangepi-build/external/cache/debs/arm64/wiringpi_x.xx.deb'''~~ ~~'''进入系统后可以运行下gpio readall命令，如果能看到下面的输出，说明wiringOP已经预装并且能正常使用。'''~~ ~~[[File:media/image172.png|575x365px]]~~ ~~'''wiringOP目前主要适配了设置GPIO口输入输出，设置GPIO口输出高低电平以及设置上下拉电阻的功能，像硬件PWM这样的功能是用不了的。'''~~ ~~<ol style="list-style-type: decimal;"><li>下载wiringOP的代码orangepi@orangepi:~$ '''sudo apt update'''orangepi@orangepi:~$ '''sudo apt install -y git'''orangepi@orangepi:~$ '''git clone https://github.com/orangepi-xunlong/wiringOP.git -b next''''''注意，源码需要下载wiringOP next分支的代码，请别漏了-b next这个参数。''''''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/usr/src/wiringOP。'''</li><li>编译安装wiringOPorangepi@orangepi:~$ '''cd wiringOP'''orangepi@orangepi:~/wiringOP$ '''sudo ./build clean'''orangepi@orangepi:~/wiringOP$ '''sudo ./build'''</li><li>测试gpio readall命令的输出如下<ol style="list-style-type: lower-alpha;"><li>其中1到26号引脚与开发板上的26 Pin引脚是一一对应的</li><li>27号引脚对应开发板上13pin的10号引脚</li><li>29号引脚对应开发板上13pin的11号引脚</li><li>31号引脚对应开发板上13pin的12号引脚</li><li>33号引脚对应开发板上13pin的13号引脚</li><li>'''28、30、32、34号引脚为空，请直接忽略'''[[File:media/image172.png|575x365px]]</li></ol></li></ol>~~ ~~== 26pin接口GPIO、I2C、UART、SPI和PWM测试 ==~~ ~~=== 26pin GPIO口测试 =~~==

~~<ol~~ {| class="wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~decimal~~800px;">~~<li>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的高低电平[[File:media/image173.png~~|~~576x128px]]</li><li>首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号root@orangepi:~/wiringOP# '''gpio mode 2 out'''</li><li>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功root@orangepi:~/wiringOP# '''gpio write 2 0'''~~-~~使用gpio readall可以看到7号引脚的值(V)变为了0[[File:media/image174.png~~|~~575x128px]]</li><li>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功~~<pbig>~~root@orangepi:~/wiringOP#~~ '''~~gpio write 2 1~~注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。'''~~使用gpio readall可以看到7号引脚的值(V)变为了1[[File:media/image175.png|575x130px]]</li><li>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可</li></ol>~~

~~=== 26 pin GPIO口上下拉电阻的设置方法 ===~~build中的存放路径为：'''

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

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

~~<ol style="list-style-type: decimal;"><li>由26pin接口的原理图可知，可用的spi为spi1[[File:media/image176.png|565x209px]]</li><li>Linux系统中spi1默认是关闭的，需要手动打开才能使用。打开步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限orangepi@orangepi:~$ '''sudo orangepi-config'''</li><li>然后选择'''System'''[[File:media/image86.png|398x194px]]</li><li>然后选择'''Hardware'''~~[[File:~~media/image87.png|393x202px]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''spi1~~zero3-~~cs1-spidev'''[[File:media/image177.png|392x57px]]</li><li>然后选择'''<Save>'''保存[[File:media/image89.png|397x92px]]</li><li>然后选择'''<Back>'''[[File:media/image90~~img172.png~~|395x91px]~~]~~</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:media/image91.png|374x187px~~]~~]</li></ol></li><li>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了orangepi@orangepi:~$ '''ls /dev/spidev1*'''/dev/spidev1.1</li><li>先不短接SPI1的mosi和miso两个引脚，运行spidev_test的输出结果如下所示，可以看到TX和RX的数据不一致orangepi@orangepi:~$ '''sudo spidev_test -v -D /dev/spidev1.1'''spi mode: 0x0bits per word: 8max speed: 500000 Hz (500 KHz)TX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.RX | FF FF FF FF FF FF '''FF FF FF FF FF FF''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ............................….</li>~~<li>然后短接SPI1的mosi（26pin接口中的第19号引脚）和miso（26pin接口中的第21号引脚）两个引脚再运行spidev_test的输出如下，可以看到发送和接收的数据一样~~orangepi@orangepi:~$ '''sudo spidev_test -v -D /dev/spidev1.1'''spi mode: 0x0bits per word: 8max speed: 500000 Hz (500 KHz)TX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.RX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</li></ol>~~

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

<li>~~由26pin的原理图可知，可用的i2c为i2c3~~下载wiringOP的代码~~[[File:media/image178.png~~{|~~575x204px]]</li><li>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：<ol~~ class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限orangepi@orangepi:~$ '''sudo orangepi-config'''</li><li>然后选择'''System'''[[File:media/image86.png|390x190px]]</li><li>然后选择'''Hardware'''[[File:media/image87.png~~|~~393x202px]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph~~-~~i2c3'''[[File:media/image179.png~~|~~392x57px]]</li><li>然后选择'''<Save>'''保存[[File:media/image89.png|395x91px]]</li><li>然后选择'''<Back>'''[[File:media/image90.png|395x91px]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:media/image91.png|374x187px]]</li></ol></li><li>启动linux系统后，先确认下/dev下存在i2c3的设备节点~~orangepi@orangepi:~$ '''~~ls /dev/i2c-3''''''/dev/i2c-3~~sudo apt update'''~~</li><li>然后开始测试i2c，首先安装i2c-tools~~orangepi@orangepi:~$ '''sudo aptinstall -~~get update~~y git'''orangepi@orangepi:~$ '''~~sudo apt-get install -y i2c-tools'''<~~git clone https://~~p><~~github.com/~~li><li>然后在26pin接头的i2c3引脚上接一个i2c设备<~~orangepi-xunlong/p>~~'''5V和3~~wiringOP.~~3V引脚请根据具体的i2c设备进行选择，不同的i2c设备需要的电压值可能不同。~~git -b next'''~~</li></ol>~~|}

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

|-

| ~~style="text~~<big>'''注意，源码需要下载wiringOP next分支的代码，请别漏了-~~align: left;"|~~ b next这个参数。''''''~~sda引脚~~如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/usr/src/wiringOP。'''</big>|}</li><li>编译安装wiringOP{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| '''对应26pin中3号引脚'''~~

|-

|}

</li>

<li>测试gpio readall命令的输出如下

<li>其中1到26号引脚与开发板上的26 Pin引脚是一一对应的</li>

<li>27号引脚对应开发板上13pin的10号引脚</li>

<li>29号引脚对应开发板上13pin的11号引脚</li>

<li>31号引脚对应开发板上13pin的12号引脚</li>

<li>33号引脚对应开发板上13pin的13号引脚</li>

<li>'''28、30、32、34号引脚为空，请直接忽略'''

[[File:zero3-img172.png]]</li></ol>

</li></ol>

<~~ol start~~span id="6pin接口gpioi2cuartspi和pwm测试" ~~style="list-style-type: decimal;"><li>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c能正常使用</p~~>~~'''不同的i2c设备地址是不同的，下图0x50地址只是一个示例。请以实际看到的为准。'''~~</pspan>~~<div class="figure">~~ ~~[[File:media/image180.png|383x151px|选区_460]]~~

~~</div></li></ol>~~== 26pin接口GPIO、I2C、UART、SPI和PWM测试 ==

=== ~~26pin的UART测试~~ 26pin GPIO口测试 ===

<li>~~由26pin接口的原理图可知，可用的uart为uart5~~下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的高低电平[[File:~~media/image181~~zero3-img173.png~~|575x203px~~]]</li><li>~~Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：~~首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>首先运行下'''orangepi~~|-~~config'''，普通用户记得加'''sudo'''权限~~| ~~orangepi~~root@orangepi:~~~$ '''sudo orangepi-config'''<~~/~~p></li><li>然后选择'''System~~wiringOP# '''gpio mode <~~/p>[[File~~span style="color:~~media/image86.png|398x194px]]</p~~#FF0000">2</lispan>~~<li>然后选择'''Hardware~~out'''~~[[File:media/image87.png~~|~~393x202px]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-uart5'''[[File:media/image182.png|400x60px]]</li><li>然后选择'''<Save>'''保存[[File:media/image89.png|397x92px]]</li><li>然后选择'''<Back>'''[[File:media/image90.png|395x91px]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:media/image91.png|374x187px]]</li></ol>~~}

</li>

<li>~~进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点'''注意，linux5.4系统为/dev/ttyAS5。'''orangepi@orangepi:~$ '''ls /dev/ttyS5'''/dev/ttyS5</li><li>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx~~然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功~~</li></ol>~~ {| class="wikitable" style="width:800px;"

|-

|root@orangepi:~/wiringOP# '''gpio write 2 0'''|}使用gpio readall可以看到7号引脚的值(V)变为了0[[File:zero3-img174.png]]</li><li>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| uart5~~

|-

|}

使用gpio readall可以看到7号引脚的值(V)变为了1

[[File:zero3-img175.png]]</li>

<li>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可</li></ol>

~~<ol start~~=~~"5" style~~=~~"list-style-type: decimal;"><li>使用wiringOP中的'''gpio'''命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常orangepi@orangepi:~$ '''gpio serial /dev/ttyS5 # linux-6.1测试命令'''orangepi@orangepi:~$ '''gpio serial /dev/ttyAS5 # linux-5.4测试命令'''Out: 0: -> 0Out: 1: -> 1Out: 2: -> 2Out: 3: -> 3^C</li></ol>~~= 26 pin GPIO口上下拉电阻的设置方法 ===

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

~~'''开发板最多可以使用4通道PWM，它们所在引脚的位置如下图所示:'''~~

~~[[File:media/image183.png|388x180px]]~~=== 26pin SPI测试 ===

<li>~~Linux系统中pwm默认是关闭的，需要手动打开才能使用。打开步骤如下所示：~~由26pin接口的原理图可知，可用的spi为spi1[[File:zero3-img176.png]]</li><li>Linux系统中spi1默认是关闭的，需要手动打开才能使用。打开步骤如下所示：

<li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限

{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo orangepi-config'''|}</li>

<li>然后选择'''System'''

[[File:~~media/image86~~zero3-img86.png~~|398x194px~~]]</li>

<li>然后选择'''Hardware'''

[[File:~~media/image87~~zero3-img87.png~~|393x202px~~]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''~~选中pwm对应的配置'''由于PWM1、PWM2和26pin接口中UART5的RX、TX引脚是复用的，所以打开PWM1和PWM2（需要选择ph-pwm12）时请确保没有选择UART5的配置（不要勾选ph-uart5）。'''~~选中'''~~PWM3、PWM4和调试串口中的TX、RX引脚是复用的，所以使用PWM3和PWM4（需要选择ph~~spi1-~~pwm34）时请将UART0的配置关掉（需要选择disable~~cs1-~~uart0），关掉UART0后调试串口就无法使用了。~~spidev'''[[File:~~media/image184~~zero3-img177.png~~|402x156px~~]]</li>

<li>然后选择'''<Save>'''保存

[[File:~~media/image89~~zero3-img89.png~~|397x92px~~]]</li>

<li>然后选择'''<Back>'''

[[File:~~media/image90~~zero3-img90.png~~|395x91px~~]]</li>

<li>然后选择'''<Reboot>'''重启系统使配置生效

[[File:~~media/image91~~zero3-img91.png~~|374x187px~~]]</li></ol></li><li>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''ls /dev/spidev1*'''/dev/spidev1.1|}</li><li>先不短接SPI1的mosi和miso两个引脚，运行spidev_test的输出结果如下所示，可以看到TX和RX的数据不一致{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo spidev_test -v -D /dev/spidev1.1'''spi mode: 0x0bits per word: 8max speed: 500000 Hz (500 KHz)TX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.RX | FF FF FF FF FF FF '''FF FF FF FF FF FF''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ............................….|}

</li>

<li>~~重启后就可以开始PWM的测试~~然后短接SPI1的mosi（26pin接口中的第19号引脚）和miso（26pin接口中的第21号引脚）两个引脚再运行spidev_test的输出如下，可以看到发送和接收的数据一样~~'''下面的命令请在root用户下执行。'''<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>在命令行中输入下面的命令可以让pwm1输出一个50Hz的矩形波~~|-| ~~root~~orangepi@orangepi:~# $ '''~~echo 1 >~~ sudo spidev_test -v -D /~~sys~~dev/~~class/pwm/pwmchip0/export~~spidev1.1'''~~root@orangepi~~spi mode:~~~# '''echo 20000000 >~~ 0x0</~~sys/class/pwm/pwmchip0/pwm1/period'''~~p>bits per word: 8~~root@orangepi~~max speed:~~~# '''echo 1000000 > /sys/class/pwm/pwmchip0/pwm1/duty_cycle'''~~500000 Hz (500 KHz)~~root@orangepi:~#~~ TX | FF FF FF FF FF FF '''~~echo 1 >~~ 40 00 00 00 00 95</~~sys/class/pwm/pwmchip0/pwm1/enable~~span>'''FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p~~></li~~>~~<li>~~~~在命令行中输入下面的命令可以让pwm2输出一个50Hz的方波~~RX | FF FF FF FF FF FF '''</pspan style="color:#FF0000">40 00 00 00 00 95</lispan>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</olp>|}

</li></ol>

~~root@orangepi:~# '''echo 2 >~~ </~~sys/class/pwm/pwmchip0/export'''~~span>

~~root@orangepi:~# '''echo 20000000 > /sys/class/pwm/pwmchip0/pwm2/period'''~~=== 26pin I2C测试 ===

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

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

|-

| style="text-align: left;"| '''sda引脚'''

| style="text-align: left;"| '''对应26pin中3号引脚'''

|-

| style="text-align: left;"| '''sck引脚'''

| style="text-align: left;"| '''对应26pin中5号引脚'''

|-

| style="text-align: left;"| '''5v引脚'''

| style="text-align: left;"| '''对应26pin中2号引脚'''

|-

| style="text-align: left;"| '''3.3v引脚'''

| style="text-align: left;"| '''对应26pin中1号引脚'''

|-

| style="text-align: left;"| '''gnd引脚'''

| style="text-align: left;"| '''对应26pin中6号引脚'''

|}

</li></ol>

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

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

|-

|

<big>'''不同的i2c设备地址是不同的，下图0x50地址只是一个示例。请以实际看到的为准。'''</big>

|}

[[File:~~media/image185~~zero3-img180.~~jpeg|574x344px|69D96433378187B10005CDD2A52881B0~~png]]

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

~~'''wiringOP-Python是wiringOP的Python语言版本的库，用于在Python程序中操作开发板的GPIO、I2C、SPI和UART等硬件资源。'''~~

~~'''另外请注意下面所有的命令都是在root用户下操作的。'''~~ ~~~~==~~= wiringOP-Python的安装方法~~ 26pin的UART测试 ===

<li>~~首先安装依赖包~~由26pin接口的原理图可知，可用的uart为uart5~~root@~~[[File:zero3-img181.png]]</li><li>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先运行下'''orangepi~~:~#~~ -config'''，普通用户记得加'''sudo ~~apt-get update~~'''权限{| class="wikitable" style="width:800px;" |-| ~~root~~orangepi@orangepi:~# $ '''sudo ~~apt-get -y install git swig python3~~orangepi-~~dev python3-setuptools~~config'''|}</li><li>~~然后使用下面的命令下载wiringOP~~然后选择'''System'''[[File:zero3-~~Python的源码~~img86.png]]</li><li>然后选择'''Hardware'''</olp>[[File:zero3-img87.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''~~注意，下面的git clone~~空格'''选中'''ph-uart5'''[[File:zero3-~~recursive命令会自动下载wiringOP的源码，因为wiringOP~~img182.png]]</li><li>然后选择'''<Save>'''保存[[File:zero3-~~Python是依赖wiringOP的。请确保下载过程没有因为网络问题而报错。~~img89.png]]</li><li>然后选择'''<Back>'''[[File:zero3-img90.png]]</li><li>然后选择'''~~如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP~~<Reboot>'''重启系统使配置生效[[File:zero3-~~Python源码，存放位置为：~~img91.png]]</~~usr~~p></~~src~~li></~~wiringOP-Python~~ol></li><li>进入linux系统后，先确认下'''/dev'''。下是否存在uart5的设备节点 ~~root@orangepi~~{| class="wikitable" style="background-color:~# ffffdc;width:800px;" |-| <big>'''~~git clone --recursive https://github~~注意，linux5.~~com~~4系统为/~~orangepi-xunlong~~dev/~~wiringOP-Python -b next~~ttyAS5。'''</big>|}{| class="wikitable" style="width:800px;" |-| ~~root~~orangepi@orangepi:~# $ '''~~cd wiringOP-Python~~ls /dev/ttyS5'''/dev/ttyS5|}</li><li>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx</li>

~~root@orangepi~~{| class="wikitable" style="width:~~~/wiringOP~~500px;"|-|| style="text-~~Python# '''git submodule update~~ align: left;"| uart5|-| tx引脚| style="text-~~init~~ align: left;"| 对应26pin的8号引脚|-| rx引脚| style="text-~~remote'''~~align: left;"| 对应26pin的10号引脚|}</ol><ol start="35" style="list-style-type: decimal;"><li>~~然后使用下面的命令编译wiringOP-Python并将其安装到开发板的Linux系统中root@orangepi:~#~~ 使用wiringOP中的'''~~cd wiringOP-Python~~gpio'''命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常{| class="wikitable" style="width:800px;" |-| ~~root~~orangepi@orangepi:~~~/wiringOP-Python#~~ $ '''~~python3 generate~~gpio serial /dev/ttyS5 # linux-~~bindings.py > bindings~~6.i1测试命令'''~~root~~orangepi@orangepi:~~~/wiringOP-Python#~~ $ '''~~sudo python3 setup.py install'''<~~gpio serial /~~p><~~dev/~~li><li>然后输入下面的命令，如果有帮助信息输出，说明wiringOP~~ttyAS5 # linux-~~Python安装成功，按下'''q~~5.4测试命令'''~~键可以退出帮助信息的界面~~</p~~></li></ol~~>

~~root@orangepi:~/wiringOP-Python# '''python3 -c "import wiringpi; help(wiringpi)"'''~~

~~Help on module wiringpi~~Out:0: -> 0Out: 1: -> 1Out: 2: -> 2Out: 3: -> 3^C|}</li></ol>

~~NAME~~

~~wiringpi~~=== PWM的测试方法 ===

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

~~# This file was automatically generated by SWIG (http~~[[File:~~//www.swig.org)~~zero3-img183.png|center]]|}

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

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

root@orangepi:~# ~~Do not make changes to this file unless you know what you are doing--modify~~'''echo 20000000 > /sys/class/pwm/pwmchip0/pwm2/period'''

root@orangepi:~# ~~the SWIG interface file instead.~~'''echo 1000000 > /sys/class/pwm/pwmchip0/pwm2/duty_cycle'''

~~<ol start="5" style="list-style-type~~root@orangepi: ~~decimal~~~# '''echo 1 >">/sys/class/pwm/pwmchip0/pwm2/enable'''|}~~<li>在python命令行下测试wiringOP-Python是否安装成功的步骤如下所示：~~</pol><ol start="3" style="list-style-type: lower-alpha;"><li>~~首先使用python3命令进入python3的命令行模式~~在命令行中输入下面的命令可以让pwm3输出一个50Hz的方波</li~~></ol></li></ol~~>

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

~~<ol start="2" style="list-style-type~~root@orangepi: ~~lower-alpha~~~# '''echo 20000000 >">~~<li>然后导入wiringpi的python模块<~~/~~li><~~sys/~~ol>~~class/pwm/pwmchip0/pwm3/period'''

~~>>>~~ root@orangepi:~# '''~~import wiringpi~~echo 1000000 >/sys/class/pwm/pwmchip0/pwm3/duty_cycle'''

root@orangepi:~# '''echo 1 > /sys/class/pwm/pwmchip0/pwm3/enable'''|}</ol><ol start="34" style="list-style-type: lower-alpha;"><li>~~最后输入下面的命令可以查看下wiringOP-Python的帮助信息，按下'''q'''键可以退出帮助信息的界面~~在命令行中输入下面的命令可以让pwm4输出一个50Hz的方波</li~~></ol~~>

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

~~Help on module wiringpi~~root@orangepi:~# '''echo 20000000 > /sys/class/pwm/pwmchip0/pwm4/period'''

~~NAME~~root@orangepi:~# '''echo 1000000 > /sys/class/pwm/pwmchip0/pwm4/duty_cycle'''

~~wiringpi~~root@orangepi:~# '''echo 1 > /sys/class/pwm/pwmchip0/pwm4/enable'''|}

~~DESCRIPTION~~<div class="figure">

~~# This file was automatically generated by SWIG (http~~[[File:~~//www.swig.org)~~zero3-img185.png]]

~~# Version 4.0.2~~</div></ol></li></ol>

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

{| class="wikitable" style="background-color:# ~~Do not make changes to this file unless you know what you are doing~~ffffdc;width:800px;" |-| <big>'''wiringOP-~~modify~~Python是wiringOP的Python语言版本的库，用于在Python程序中操作开发板的GPIO、I2C、SPI和UART等硬件资源。'''

~~# the SWIG interface file instead.~~

~~CLASSES~~'''另外请注意下面所有的命令都是在root用户下操作的。'''</big>|}

~~builtins.object~~=== wiringOP-Python的安装方法 ===

~~GPIO~~<ol style="list-style-type: decimal;"><li>首先安装依赖包~~I2C~~{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''sudo apt-get update'''root@orangepi:~# '''sudo apt-get -y install git swig python3-dev python3-setuptools'''|}</li><li>然后使用下面的命令下载wiringOP-Python的源码</li> {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，下面的git clone--recursive命令会自动下载wiringOP的源码，因为wiringOP-Python是依赖wiringOP的。请确保下载过程没有因为网络问题而报错。'''

~~Serial~~

~~nes~~'''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP-Python源码，存放位置为：/usr/src/wiringOP-Python'''。</big>|} {| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''git clone --recursive https://github.com/orangepi-xunlong/wiringOP-Python -b next''' root@orangepi:~# '''cd wiringOP-Python''' root@orangepi:~/wiringOP-Python# '''git submodule update --init --remote'''|}</ol><ol start="3" style="list-style-type: decimal;"><li>然后使用下面的命令编译wiringOP-Python并将其安装到开发板的Linux系统中{| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''cd wiringOP-Python'''root@orangepi:~/wiringOP-Python# '''python3 generate-bindings.py > bindings.i'''root@orangepi:~/wiringOP-Python# '''sudo python3 setup.py install'''|}</li><li>然后输入下面的命令，如果有帮助信息输出，说明wiringOP-Python安装成功，按下'''q'''键可以退出帮助信息的界面</li>

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

~~| GPIO(pinmode=0)~~Help on module wiringpi:

|

~~>>>~~NAME

~~=== 26pin GPIO口测试 ===~~:wiringpi

'''wiringOP-Python跟wiringOP一样，也是可以通过指定wPi号来确定操作哪一个GPIO引脚，因为wiringOP-Python中没有查看wPi号的命令，所以只能通过wiringOP中的gpio命令来查看板子wPi号与物理引脚的对应关系。'''

~~[[File:media/image172.png|575x365px]]~~DESCRIPTION

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

~~=== 26pin SPI测试 ===~~: # Version 4.0.2

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

~~root@orangepi~~:~~~/wiringOP~~# Do not make changes to this file unless you know what you are doing-~~Python/examples# '''python3 spidev_test.py \'''~~-modify

: # the SWIG interface file instead.|}</ol><ol start="5" style="list-style-type: decimal;"><li>在python命令行下测试wiringOP-Python是否安装成功的步骤如下所示：<ol style="list-style-type: lower-alpha;"><li>首先使用python3命令进入python3的命令行模式</li> {| class="wikitable" style="width:800px;" |-| root@orangepi:~# '''python3'''|}</ol><ol start="2" style="list-style-type: lower-alpha;"><li>然后导入wiringpi的python模块</li> {| class="wikitable" style="width:800px;" |-| >>> '''import wiringpi;'''|}</ol><ol start="3" style="list-style-~~channel 1~~ type: lower-alpha;"><li>最后输入下面的命令可以查看下wiringOP-~~port 1~~Python的帮助信息，按下'''q'''键可以退出帮助信息的界面</li> {| class="wikitable" style="width:800px;" |-| >>> '''help(wiringpi)''' Help on module wiringpi: NAME :wiringpi

~~spi mode: 0x0~~

~~max speed: 500000 Hz (500 KHz)~~DESCRIPTION

~~Opening device~~ : # This file was automatically generated by SWIG (http:/~~dev~~/~~spidev1~~www.swig.org).1

~~TX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |~~: # Version 4.0.~~....@.......…|~~2

~~RX | FF FF FF FF FF FF '''FF FF FF FF FF FF''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF |.............….|~~: #

~~<ol start="6" style="list-style~~: # Do not make changes to this file unless you know what you are doing-~~type: decimal;">~~<li>然后使用杜邦线短接SPI1的txd（26pin接口中的第19号引脚）和rxd（26pin接口中的第21号引脚）两个引脚再运行spidev_test.py的输出如下，可以看到发送和接收的数据一样，说明SPI1回环测试正常~~root@orangepi:~/wiringOP~~-~~Python# '''cd examples'''</li></ol>~~modify

~~root@orangepi~~:~~~/wiringOP-Python/examples~~# ~~'''python3 spidev_test~~the SWIG interface file instead.~~py \'''~~

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

~~spi mode: 0x0~~CLASSES

~~max speed~~: ~~500000 Hz (500 KHz)~~builtins.object

~~Opening device /dev/spidev1.1~~::GPIO

~~TX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|~~::I2C

~~RX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|~~::Serial

~~~~0) ~~=== 26pin I2C测试 ===~~:|

~~<ol style="list-style-type: decimal;">~~

~~<li>由26pin的原理图可知，可用的i2c为i2c3~~

~~[[File:media/image178.png|575x204px]]</li>~~

~~<li>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：~~

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限~~

~~orangepi@orangepi:~$ '''sudo orangepi-config'''</li>~~

~~<li>然后选择'''System'''~~

~~[[File:media/image86.png|398x194px]]</li>~~

~~<li>然后选择'''Hardware'''~~

~~[[File:media/image87.png|393x202px]]</li>~~

~~<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-i2c3'''~~

~~[[File:media/image179.png|401x59px]]</li>~~

~~<li>然后选择'''<Save>'''保存~~

~~[[File:media/image89.png|397x92px]]</li>~~

~~<li>然后选择'''<Back>'''~~

~~[[File:media/image90.png|395x91px]]</li>~~

~~<li>然后选择'''<Reboot>'''重启系统使配置生效~~

~~[[File:media/image91.png|374x187px]]</li></ol>~~

~~</li>~~

~~<li>启动linux系统后，先确认下/dev下存在i2c3的设备节点~~

~~orangepi@orangepi:~$ '''ls /dev/i2c-3'''~~

~~'''/dev/i2c-3'''</li>~~

~~<li>然后开始测试i2c，首先安装下i2c-tools~~

~~orangepi@orangepi:~$ '''sudo apt-get update'''~~

~~orangepi@orangepi:~$ '''sudo''' '''apt-get install -y i2c-tools'''</li>~~

~~<li>然后在26pin接头的i2c3引脚上接一个i2c设备，这里以DS1307 RTC模块为例~~

~~[[File:media/image186.png|180x153px]]</li></ol>~~

~~{| class="wikitable"~~|-~~| style="text-align: left~~>~~"| '''RTC模块的引脚'''| style="text-align: left~~>~~"| '''开发板26pin对应的引脚'''~~|-~~| style="text-align: left~~>~~"| '''5V'''| style="text-align: left;"| '''2号引脚'''~~|-~~| style="text-align: left;"| '''GND'''| style="text-align: left;"| '''6号引脚'''~~|-~~| style="text-align: left;"| '''SDA'''| style="text-align: left;"| '''3号引脚'''~~|-~~| style="text-align: left;"| '''SCL'''| style="text-align: left;"| '''5号引脚'''~~

|}

</ol>

</li></ol>

<~~ol start~~span id="~~6" style="list~~pin-~~style~~gpio口测试-~~type: decimal;~~1">~~<li>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c设备连接正确</li~~></olspan>

~~[[File:media/image187.png|388x203px]]~~=== 26pin GPIO口测试 ===

~~<ol start~~{| class="7wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~decimal~~800px;">~~<li>然后可以运行'''examples'''中的'''ds1307.py'''测试程序读取RTC的时间~~|-| <pbig>~~root@orangepi:~/wiringOP-Python# '''cd examples~~'''~~root@orangepi:~/~~wiringOP-~~Python/examples# '''python3 ds1307.py~~ Python跟wiringOP一样，也是可以通过指定wPi号来确定操作哪一个GPIO引脚，因为wiringOP-~~-device \'~~Python中没有查看wPi号的命令，所以只能通过wiringOP中的gpio命令来查看板子wPi号与物理引脚的对应关系。''~~~~'~~''"/dev/i2c-3"'''Thu 2022-06-16 04:35:46Thu 2022-06-16 04:35:47Thu 2022-06-16 04:35:48^Cexit</li>~~</olbig>

~~~~img172.png]]~~=== 26pin的UART测试 ===~~|}

<li>~~由26pin接口的原理图可知，可用的uart为uart5~~下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平[[File:~~media/image181~~zero3-img173.png~~|575x203px~~]]</li><li>~~Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：~~直接用命令测试的步骤如下所示：

<li>~~首先运行下~~首先设置GPIO口为输出模式，其中'''~~orangepi-config'''，普通用户记得加''~~pinMode'~~sudo~~''~~'权限~~函数的第一个参数是引脚对应的wPi的序号，第二个参数是GPIO的模式~~orangepi@orangepi~~{| class="wikitable" style="width:~~~$ '''sudo orangepi~~800px;" |-~~config'''</li><li>然后选择'''System'''[[File:media/image86.png~~|~~398x194px]]</li><li>~~~~然后选择'''Hardware'''[[File~~root@orangepi:~~media~~~/~~image87.png|393x202px]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中~~wiringOP-Python# '''phpython3 -~~uart5~~c "import wiringpi; \'''~~[[File:media/image182.png|400x60px]]</li><li>然后选择~~'''~~&lt~~from wiringpi import GPIO;~~Save&gt~~wiringpi.wiringPiSetup() ;\'''~~保存[[File:media/image89.png|397x92px]]~~</p~~></li~~>~~<li>~~~~然后选择'''<Back>~~'''wiringpi.pinMode(<~~/p>~~<pspan style="color:#FF0000">~~[[File:media/image90~~2, GPIO.~~png|395x91px]]~~OUTPUT</lispan>~~<li>然后选择'''&lt~~) ;~~Reboot~~&gtquot;'''~~重启系统使配置生效~~~~[[File:media/image91.png~~|~~374x187px]]</li></ol>~~}

</li>

<li>~~进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点'''注意，linux5.4系统为/dev/ttyAS5。'''orangepi@orangepi:~$ '''ls /dev/ttyS5'''/dev/ttyS5</li><li>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx~~然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功~~</li></ol>~~ {| class="wikitable" style="width:800px;"

|-

|| root@orangepi:~/wiringOP-Python# '''python3 -c "import wiringpi; \''''''from wiringpi import GPIO; wiringpi.wiringPiSetup() ;\''''''wiringpi.digitalWrite(2, GPIO.LOW)"~~"| '''uart5~~'''|}</li><li>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功{| class="wikitable" style="width:800px;"

|-

| root@orangepi:~/wiringOP-Python# '''python3 -c "import wiringpi; \''''''from wiringpi import GPIO; wiringpi.wiringPiSetup() ;\''~~tx引脚~~''''wiringpi.digitalWrite(2, GPIO.HIGH)"'''| }</li></ol></li><li>在python3的命令行中测试的步骤如下所示：<ol style="~~text~~list-~~align~~style-type: ~~left~~lower-alpha;"><li>首先使用python3命令进入python3的命令行模式{| ~~'''对应26pin中的8号引脚'''~~class="wikitable" style="width:800px;"

|-

| ~~'''rx引脚'''| style="text-align~~root@orangepi: ~~left;"|~~ ~# '''~~对应26pin中的10号引脚~~python3'''

|}

</li><~~ol start~~li>然后导入wiringpi的python模块{| class="5wikitable" style="~~list~~width:800px;" |-| >>> '''import wiringpi'''>>> '''from wiringpi import GPIO'''|}</li><li>然后设置GPIO口为输出模式，其中'''pinMode'''函数的第一个参数是引脚对应的wPi的序号，第二个参数是GPIO的模式{| class="wikitable" style="width:800px;" |-~~type~~| >>> '''wiringpi.wiringPiSetup()'''0>>> '''wiringpi.pinMode(2, GPIO.OUTPUT)'''|}</li><li>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功{| class="wikitable" style="width:800px;"|-| >>> '''wiringpi.digitalWrite(2, GPIO.LOW)'''|}</li><li>~~最后可以运行examples中的~~然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功{| class="wikitable" style="width:800px;" |-| >>> '''~~serialTest~~wiringpi.digitalWrite(2, GPIO.HIGH)'''|}</li></ol></li><li>wiringOP-Python在python代码中设置GPIO高低电平的方法可以参考下examples中的'''blink.py'''测试程序，'''blink.py'''~~程序来测试下串口的回环功能，如果能看到下面的打印，说明串口回环测试正常~~测试程序会设置开发板26 pin中所有的GPIO口的电压不断的高低变化{| class="wikitable" style="width:800px;" |-|

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

root@orangepi:~/wiringOP-Python/examples# '''~~python3 serialTest~~ls blink.py ~~--device "~~'''</~~dev/ttyS5" # linux6~~p>'''blink.~~1使用~~py'''root@orangepi:~/wiringOP-Python/examples# '''# python3 ~~serialTest~~blink.py ~~--device "/dev/ttyAS5" # linux5.4使用~~'''~~Out: 0: -> 0~~|}~~Out: 1: -> 1Out: 2: -> 2Out: 3: -> 3Out: 4:^Cexit~~</li></ol>

~~Orange Pi发布的linux系统中预装了watchdog_test程序，可以直接测试。~~ ~~运行watchdog_test程序的方法如下所示：~~=== 26pin SPI测试 ===

<li>由26pin接口的原理图可知，可用的spi为spi1

[[File:zero3-img176.png]]</li>

<li>Linux系统中spi1默认是关闭的，需要手动打开才能使用。打开步骤如下所示：

<li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限

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

|-

|

orangepi@orangepi:~$ '''sudo orangepi-config'''

|}

</li>

<li>然后选择'''System'''

[[File:zero3-img86.png]]</li>

<li>然后选择'''Hardware'''

[[File:zero3-img87.png]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''spi1-cs1-spidev'''

[[File:zero3-img177.png]]</li>

<li>然后选择'''<Save>'''保存

[[File:zero3-img89.png]]</li>

<li>然后选择'''<Back>'''

[[File:zero3-img90.png]]</li>

<li>然后选择'''<Reboot>'''重启系统使配置生效

[[File:zero3-img91.png]]</li></ol>

</li>

<li>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了

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

|-

|

orangepi@orangepi:~$ '''ls /dev/spidev1*'''

/dev/spidev1.1

|}

</li>

<li>然后可以使用examples中的'''spidev_test.py'''程序测试下SPI的回环功能，'''spidev_test.py'''程序需要指定下面的两个参数：

<li>~~第二个参数10表示看门狗的计数时间，如果这个时间内没有喂狗，系统会重启~~'''--channel'''：指定SPI的通道号</li><li>~~我们可以通过按下键盘上的任意键（ESC除外）来喂狗，喂狗后，程序会打印一行keep alive表示喂狗成功orangepi@orangepi:~$~~ '''~~sudo watchdog_test 10~~--port'''：指定SPI的端口号<p/li>~~open success~~</pol>~~options is 33152,identity is sunxi-wdt~~</pli><pli>~~put_usr return,if 0,success:0~~~~The old reset time is: 16~~先不短接 SPI1 的 mosi 和 miso 两个引脚，运行spidev_test.py的输出结果如下所示，可以看到 TX 和 RX 的数据不一致~~return ENOTTY,if -1,success~~{| class="wikitable" style="width:~~0~~800px;" ~~return ENOTTY,if~~ |-~~1,success:0put_user return,if 0,success:0~~| ~~put_usr return,if 0,success~~root@orangepi:0<~/p>~~keep alivekeep alivekeep alive</li></ol>~~wiringOP-Python# '''cd examples'''

~~<~~root@orangepi:~/~~span>== 查看H618芯片的chipid ==~~wiringOP-Python/examples# '''python3 spidev_test.py \'''

~~查看H618芯片chipid的命令如下所示，每个芯片的chipid都是不同的，所以可以使用chipid来区分多个开发板。~~'''--channel 1 --port 1''' spi mode: 0x0 max speed: 500000 Hz (500 KHz) Opening device /dev/spidev1.1 TX | FF FF FF FF FF FF '''40 00 00 00 00 95''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…| RX | FF FF FF FF FF FF '''FF FF FF FF FF FF''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF |.............….||}</li></ol><ol start="6" style="list-style-type: decimal;"><li>然后使用杜邦线短接SPI1的txd（26pin接口中的第19号引脚）和rxd（26pin接口中的第21号引脚）两个引脚再运行spidev_test.py的输出如下，可以看到发送和接收的数据一样，说明SPI1回环测试正常{| class="wikitable" style="width:800px;" |-| root@orangepi:~/wiringOP-Python# '''cd examples'''

~~orangepi~~root@orangepi:~$ /wiringOP-Python/examples# '''~~cat /sys/class/sunxi_info/sys_info | grep "chipid"~~python3 spidev_test.py \'''

~~sunxi_chipid : 338020004c0048080147478824681ed1~~'''--channel 1 --port 1'''

~~== Python相关说明 ==~~spi mode: 0x0

~~=== Python源码编译安装的方法 ===~~max speed: 500000 Hz (500 KHz)

'''如果使用的Ubuntu或者Debian系统软件仓库中的Python版本不符合开发的要求，想要使用最新版本的Python，可以使用下面的方法下载Python的源码包来编译安装最新版本的Python。'''Opening device /dev/spidev1.1

TX | FF FF FF FF FF FF '''~~下面演示的是编译安装Python3.9的最新版本，如果要编译安装其他的版本的Python，方法也是一样的（需要下载想要安装的Python对应的源码）。~~40 00 00 00 00 95'''FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|

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

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

'''Linux系统pip默认使用的源为Python官方的源，但是国内访问Python官方的源速度是很慢的，并且经常会由于网络原因导致Python软件包安装失败。所以在使用pip安装Python库时，请记得更换下pip源。'''=== 26pin I2C测试 ===

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

orangepi@orangepi:~$ '''sudo apt-get update'''

orangepi@orangepi:~$ '''sudo ~~apt-get install -y python3-pip~~'''~~</li><li>Linux下永久更换pip源的方法<ol style="list-style-type: lower-alpha;"><li>先新建~~'''~~~/.pip'''目录，然后添加'''pip.conf'''配置文件，并在其中设置pip的源为清华源orangepi@orangepi:~$ '''mkdir~~ apt-~~p ~/.pip'''orangepi@orangepi:~$ '''cat <<EOF > ~/.pip/pip.conf''''''[global]''''''timeout = 6000''''''index~~get install -~~url = https://pypi.tuna.tsinghua.edu.cn/simple''''''trusted~~y i2c-~~host = pypi.tuna.tsinghua.edu.cn''''''EOF~~tools'''</p~~></li~~>~~<li>然后使用pip3安装Python库速度就会很快了</li></ol>~~|}

</li>

<li>~~Linux下临时更换pip源的方法，其中的'''<packagename>'''需要替换为具体的包名~~然后在26pin接头的i2c3引脚上接一个i2c设备，这里以DS1307 RTC模块为例~~orangepi@orangepi~~[[File:~~~$ '''pip3 install <packagename>~~ zero3-~~i \''''''https://pypi~~img186.~~tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn'''~~png]]</li~~></ol~~>

~~~~|-| style="text-align: left;"| '''RTC模块的引脚'''| style= ~~安装Docker的方法~~ "text-align: left;"| '''开发板26pin对应的引脚'''|-| style="text-align: left;"| '''5V'''| style="text-align: left;"| '''2号引脚'''|-| style="text-align: left;"| '''GND'''~~Orange Pi提供的linux镜像已经预装了Docker，只是Docker服务默认没有打开。使用~~| style="text-align: left;"| '''~~enable_docker.sh~~6号引脚'''~~脚本可以使能docker服务，然后就可以开始使用docker命令了，并且在下次启动系统时也会自动启动docker服务。~~|-~~orangepi@orangepi~~| style="text-align: left;"| '''SDA'''| style="text-align: left;"| '''3号引脚'''|-| style="text-align: left;"| '''SCL'''| style="text-align: left;"| '''5号引脚'''|}</ol><ol start="6" style="list-style-type:~$ decimal;"><li>然后使用'''~~enable_docker.sh~~i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c设备连接正确</li>

~~可以使用下面的命令测试下docker，如果能运行~~[[File:zero3-img187.png]]</ol><ol start="7" style="list-style-type: decimal;"><li>然后可以运行'''examples'''中的'''ds1307.py'''测试程序读取RTC的时间{| class="wikitable" style="width:800px;" |-| root@orangepi:~/wiringOP-Python# '''cd examples'''root@orangepi:~/wiringOP-Python/examples# '''~~hello~~python3 ds1307.py --~~world~~device \'''~~说明docker能正常使用了。~~'''"/dev/i2c-3"'''Thu 2022-06-16 04:35:46Thu 2022-06-16 04:35:47Thu 2022-06-16 04:35:48^Cexit|}</li></ol>

~~orangepi@orangepi:~$ '''docker run hello~~

~~Unable to find image 'hello-world:latest' locally~~=== 26pin的UART测试 ===

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

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

~~'''This message shows that your installation appears to be working correctly.'''~~

~~'''.….'''~~Out: 0: -> 0Out: 1: -> 1Out: 2: -> 2Out: 3: -> 3Out: 4:^Cexit|}</li></ol>

~~使用docker命令时，如果提示~~== 硬件看门狗测试 == Orange Pi发布的linux系统中预装了watchdog_test程序，可以直接测试。运行watchdog_test程序的方法如下所示： <ol style="list-style-type: lower-alpha;"><li>第二个参数10表示看门狗的计数时间，如果这个时间内没有喂狗，系统会重启</li><li>我们可以通过按下键盘上的任意键（ESC除外）来喂狗，喂狗后，程序会打印一行keep alive表示喂狗成功{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~permission denied~~sudo watchdog_test 10'''~~，请将当前用户加入到docker用户组，这样不需要sudo就能运行docker命令了。~~open successoptions is 33152,identity is sunxi-wdtput_usr return,if 0,success:0The old reset time is: 16return ENOTTY,if -1,success:0return ENOTTY,if -1,success:0put_user return,if 0,success:0put_usr return,if 0,success:0keep alivekeep alivekeep alive|}</li></ol>

~~orangepi@orangepi:~$ '''sudo usermod -aG docker $USER'''~~

~~'''注意：需要退出重新登录系统才能生效，重启系统也可以。'''~~== 查看H618芯片的chipid ==

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

{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~注意，这里只会提供在Ubuntu或者Debian系统中安装Home Assistant的方法，Home Assistant详细的使用方法请参考官方文档或者相应的书籍。~~cat /sys/class/sunxi_info/sys_info | grep "chipid"'''

~~=== 通过docker安装 ===~~sunxi_chipid : 338020004c0048080147478824681ed1|}

<~~ol style~~span id="~~list-style-type: decimal;~~python相关说明">~~<li~~>~~首先请安装好docker，并确保docker能正常运行。docker的安装步骤请参考[[\l|'''安装Docker的方法''']]一节的说明。~~</~~p></li~~span>~~<li>然后可以搜索下Home Assistant的docker镜像orangepi@orangepi:~$ '''docker search homeassistant'''</li><li>然后使用下面的命令下载Home Assistant的docker镜像到本地，镜像大小大概有1GB多，下载时间会比较长，请耐心等待下载完成orangepi@orangepi:~$ '''docker pull homeassistant/home-assistant'''Using default tag: latestlatest: Pulling from homeassistant/home-assistantbe307f383ecc: Downloading5fbc4c07ac88: Download complete'''...... (省略部分输出)'''3cc6a1510c9f: Pull complete7a4e4d5b979f: Pull completeDigest: sha256:81d381f5008c082a37da97d8b08dd8b358dae7ecf49e62ce3ef1eeaefc4381bbStatus: Downloaded newer image for homeassistant/home-assistant:latestdocker.io/homeassistant/home-assistant:latest</li><li>然后可以使用下面的命令查看下刚下载的Home Assistant的docker镜像orangepi@orangepi:~$ '''docker images homeassistant/home-assistant'''REPOSITORY TAG IMAGE ID CREATED SIZEhomeassistant/home-assistant latest bfa0ab9e1cf5 2 months ago '''1.17GB'''</li><li>此时就可以运行Home Assistant的docker容器了orangepi@orangepi:~$ '''docker run -d \''''''--name homeassistant \''''''--privileged \''''''--restart~~=~~unless-stopped \''''''-e TZ~~=~~Asia/Shanghai \''''''-v /home/orangepi/home-assistant:/config \''''''--network~~Python相关说明 ==~~host \''''''homeassistant/home-assistant:latest'''</li><li>然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面~~'''Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''<~~p>[[File:media/image188.png|576x209px]]</li><li>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''[[File:media/image189.png|220x279px]]</li><li>然后按照界面提示根据自己的喜好设置，再点击下一步[[File:media/image190.png|575x297px]]</li><li>然后点击下一步[[File:media/image191.png|576x185px]]</li><li>然后点击完成[[File:media/image192.png|576x117px]]</li><li>Home Assistant最终显示的主界面如下图所示[[File:media/image193.png|574x294px]]</li><li>停止Home Assistant容器的方法<ol style~~span id="~~list-style-type: lower-alpha;~~python源码编译安装的方法">~~<li>查看docker容器的命令如下所示~~</pspan>~~orangepi@orangepi:~$ '''docker ps -a'''</li><li>停止Home Assistant容器的命令如下所示orangepi@orangepi:~$ '''docker stop homeassistant'''</li><li>删除Home Assistant容器的命令如下所示orangepi@orangepi:~$ '''docker rm homeassistant'''</li></ol></li></ol>~~=== Python源码编译安装的方法 ===

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

'''~~安装前请先更换下pip的源为国内源，加快Python包的安装速度，配置方法见[[\l|Python更换pip源的方法]]一节的说明。~~下面演示的是编译安装Python3.9的最新版本，如果要编译安装其他的版本的Python，方法也是一样的（需要下载想要安装的Python对应的源码）。'''</big>|}

<li>~~首先安装依赖包~~首先安装编译Python需要的依赖包{| class="wikitable" style="width:800px;" |-|

orangepi@orangepi:~$ '''sudo apt-get update'''

orangepi@orangepi:~$ '''sudo apt-get install -y ~~python3 python3~~build-essential zlib1g-dev ~~python3-venv~~ \''''''~~python3~~libncurses5-~~pip libffi~~dev libgdbm-dev ~~libssl~~libnss3-dev ~~libjpeg~~libssl-dev ~~zlib1g~~libsqlite3-dev ~~autoconf build-essential~~ \''''''~~libopenjp2~~libreadline-dev libffi-~~7 libtiff5 libturbojpeg0~~dev curl libbz2-dev ~~tzdata~~'''|}<p/li>~~'''如果是debian12请使用下面的命令：'''~~</pli>~~orangepi@orangepi:~$ '''sudo apt-get update'''~~然后下载最新版本的Python3.9源码并解压{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo apt-get install -y python3 python3-dev python3-venv~~ wget \''''''~~python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''<~~https://www.python.org/p>~~'''libopenjp2-7 libturbojpeg0-dev tzdata'''<~~ftp/~~p><~~python/~~li><li>然后需要编译安装Python3~~3.9.~~9，方法请参考[[\l|'''Python源码编译安装的方法''']]一节<~~10/p>~~'''Debian Bullseye默认的Python版本就是Python3~~Python-3.9.10.~~9，所以无需编译安装。~~tgz'''orangepi@orangepi:~$ '''~~Ubuntu Jammy默认的Python版本就是Python3~~tar xvf Python-3.9.10.~~10，所以也无需编译安装。~~tgz'''~~'''Debian Bookworm默认的Python版本就是Python3.11，所以也无需编译安装。'''~~|}</li><li>~~然后创建Python虚拟环境~~然后运行配置命令~~'''Debian Bookworm中是python3.11，请记得替换对应的命令。'''~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo mkdir /srv/homeassistant~~cd Python-3.9.10'''orangepi@orangepi:~$ '''~~sudo chown orangepi:orangepi~~ ./~~srv/homeassistant~~configure --enable-optimizations'''|}</li><li>~~orangepi@orangepi:~$ '''cd /srv/homeassistant'''~~然后编译安装Python3.9，编译时间大概需要半个小时左右{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3.9~~ make -~~m venv .~~j4'''orangepi@orangepi:~$ '''~~source bin/activate~~sudo make altinstall'''~~(homeassistant) orangepi@orangepi:/srv/homeassistant$~~|}</li><li>~~然后安装需要的Python包~~安装完后可以使用下面的命令查看下刚安装的Python的版本号{| class="wikitable" style="width:800px;" |-| ~~(homeassistant)~~ orangepi@orangepi:~~/srv/homeassistant~~~$ '''python3 .9 -~~m pip install wheel~~-version'''</p~~></li~~>~~<li>~~~~然后就可以安装Home Assistant Core(homeassistant) orangepi@orangepi:/srv/homeassistant$~~ '''~~pip3 install homeassistant~~Python 3.9.10'''|}</li><li>~~然后输入下面的命令就可以运行Home Assistant Core~~然后更新下pip{| class="wikitable" style="width:800px;" |-| ~~(homeassistant)~~ orangepi@orangepi:~~/srv/homeassistant~~~$ '''~~hass~~/usr/local/bin/python3.9 -m pip install --upgrade pip'''|}</li>~~<li>然后在浏览器中输入【'''开发板的IP地址:8123'''】就能看到Home Assistant的界面~~</pol>'''第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。'''<~~p>[[File:media/image194.png|576x203px]]</li~~span id="python更换pip源的方法"></olspan>

~~~~== ~~OpenCV的安装方法~~ Python更换pip源的方法 ===

~~'''Linux系统pip默认使用的源为Python官方的源，但是国内访问Python官方的源速度是很慢的，并且经常会由于网络原因导致Python软件包安装失败。所以在使用pip安装Python库时，请记得更换下pip源。'''</~~span~~big>~~=== 使用apt来安装OpenCV ===|}

<li>~~安装命令如下所示~~首先安装下'''python3-pip'''{| class="wikitable" style="width:800px;" |-|

orangepi@orangepi:~$ '''sudo apt-get update'''

orangepi@orangepi:~$ '''sudo apt-get install -y ~~libopencv-dev~~ python3-~~opencv~~pip'''|}</li><li>~~然后使用下面的命令打印OpenCV的版本号输出正常，说明OpenCV安装成功~~Linux下永久更换pip源的方法

<li>~~Ubuntu22~~先新建'''~/.pip'''目录，然后添加'''pip.~~04中OpenCV的版本如下所示：~~conf'''配置文件，并在其中设置pip的源为清华源{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3~~ mkdir -~~c "import cv2; print(cv2~~p ~/.~~__version__)"~~pip'''orangepi@orangepi:~$ '''4cat <<EOF > ~/.5pip/pip.4conf'''</p~~></li~~>~~<li>~~~~Ubuntu20.04中OpenCV的版本如下所示：~~'''[global]'''~~orangepi@orangepi:~$~~ '''~~python3 -c "import cv2; print(cv2.__version__)"~~timeout = 6000''''''4index-url = https://pypi.2tuna.0tsinghua.edu.cn/simple'''</p~~></li~~>~~<li>~~~~Debian11中OpenCV的版本如下所示：~~'''trusted-host = pypi.tuna.tsinghua.edu.cn'''~~orangepi@orangepi:~$~~ '''~~python3 -c "import cv2; print(cv2.__version__)"~~EOF'''|}</li><li>~~'''4.5.1'''~~然后使用pip3安装Python库速度就会很快了</li></ol></li><li>~~Debian12中OpenCV的版本如下所示：~~Linux下临时更换pip源的方法，其中的'''<packagename>'''需要替换为具体的包名{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3 -c~~ pip3 install &~~quot~~lt;~~import cv2; print(cv2.__version__)~~packagename&~~quot~~gt;-i \''''''4https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.6tsinghua.0edu.cn'''~~</li></ol>~~|}

</li></ol>

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

Orange Pi提供的linux镜像已经预装了Docker，只是Docker服务默认没有打开。使用'''~~宝塔Linux面板是提升运维效率的服务器管理软件，支持一键LAMP/LNMP/集群/监控/网站/FTP/数据库/JAVA等100多项服务器管理功能（摘抄自[https://www~~enable_docker.~~bt.cn/ 宝塔官网]）~~sh'''脚本可以使能docker服务，然后就可以开始使用docker命令了，并且在下次启动系统时也会自动启动docker服务。

~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>首先需要扩展下'''/tmp'''空间的大小，设置完后需要'''重启下开发板的linux系统'''，命令如下所示：orangepi@orangepi:~$ '''sudo sed~~ |-~~i 's/nosuid/&,size=2G/' /etc/fstab'''orangepi@orangepi:~$ '''sudo reboot'''</li><li>重启后，可以看到'''/tmp'''空间的大小变为2G了orangepi@orangepi:~$ '''df -h~~ | ~~grep "/tmp"'''tmpfs 2.0G 12K '''2.0G''' 1% /tmp</li><li>然后在linux系统中输入下面的命令就可以开始宝塔的安装~~orangepi@orangepi:~$ '''~~sudo install_bt_panel~~enable_docker.sh'''~~</li><li>然后宝塔安装程序会提醒是否安装'''Bt-Panel'''到'''/www'''文件夹，此时输入'''y'''即可+----------------------------------------------------------------------| Bt-WebPanel FOR CentOS/Ubuntu/Debian+----------------------------------------------------------------------| Copyright © 2015-2099 BT-SOFT(http://www.bt.cn) All rights reserved.+----------------------------------------------------------------------| The WebPanel URL will be http://SERVER_IP:8888 when installed.+----------------------------------------------------------------------Do you want to install Bt-Panel to the /www directory now?(y/n): '''y'''</li>~~<li>然后要做的就是耐心等待，当看到终端输出下面的打印信息时，说明宝塔已经安装完成，整个安装过程大约耗时34分钟，根据网络速度的不同可能会有一些差别~~[[File:media/image195.png|576x233px]]</li>~~<li>此时在浏览器中输入上面显示的'''面板地址'''就可以打开宝塔Linux面板的登录界面，然后在对应的位置输入上图显示的'''username'''和'''password'''就可以登录进宝塔 ~~[[File:media/image196.png~~|~~575x281px]]</li>~~<li>成功登录宝塔后的会弹出下面的欢迎界面，首先请将中间的用户须知阅读完拖到最下面，然后就可以选择”我已同意并阅读《用户协议》“，接着点击”进入面板”就可以进入宝塔了}~~[[File:media/image197.png|575x317px]]</li><li>进入宝塔后首先会提示需要绑定宝塔官网的账号，如果没有账号可以去宝塔的官网（~~可以使用下面的命令测试下docker，如果能运行'''~~https://www.bt.cn'''）注册一个[[File:media/image198.png|576x300px]]</li>~~<li>最终显示的界面如下图所示，可以很直观的看到开发板Linux系统的一些状态信息，比如负载状态、CPU的使用率、内存使用率和存储空间的使用情况等~~[[File:media/image199.png|575x306px]]</li><li>宝塔的更多功能可以参考下面资料自行探索使用手册：[http://docs.bt.cn '''http://docs.bt.cn''']论坛地址：[https://www.bt.cn/bbs '''https://www.bt.cn/bbs''']GitHub链接：'''https://github.com/aaPanel/BaoTa~~hello-world'''~~</li></ol>~~说明docker能正常使用了。

{| class="wikitable" style= ~~face_recognition人脸识别库的安装和测试方法 ==~~"width:800px;" |-| orangepi@orangepi:~$ '''docker run hello-world'''

Unable to find image 'hello-world:latest'~~'注意，此小节的内容都是在桌面版本的Linux系统中测试的，所以请确保开发板使用的系统为桌面版本的系统。'''~~locally

~~'''另外下面的安装测试都是在orangepi用户下进行的，请保持环境一致。'''~~latest: Pulling from library/hello-world

~~'''Debian12目前没有适配。'''~~256ab8fe8778: Pull complete

~~'''face_recognition源码仓库的地址为：'''~~Digest: sha256:7f0a9f93b4aa3022c3a4c147a449ef11e0941a1fd0bf4a8e6c9408b2600777c5

~~[https~~Status:~~//github.com/ageitgey/face_recognition '''https~~Downloaded newer image for hello-world:~~//github.com/ageitgey/face_recognition''']~~latest

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

'''~~https~~Hello from Docker!</~~/github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.md~~span>'''

'''This message shows that your installation appears to be working correctly.'''

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

~~=== 手动安装face_recognition的方法 ===~~使用docker命令时，如果提示'''permission denied'''，请将当前用户加入到docker用户组，这样不需要sudo就能运行docker命令了。

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

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

|-

| ~~style="text-align: left;"|~~ <big>'''~~Ubuntu20.04~~注意：需要退出重新登录系统才能生效，重启系统也可以。'''</big>|} == Home Assistant的安装方法 == {| class="wikitable" style="~~text~~background-~~align~~color: ~~left~~#ffffdc;width:800px;"~~| '''dlib-19.24.0-cp38-cp38-linux_aarch64.whl'''~~

|-

|}

~~<ol start~~=~~"3" style~~=~~"list-style-type: lower-alpha;"><li>然后就可以开始安装dlib，命令如下所示<ol style~~=~~"list-style-type: lower-alpha;"><li>Ubuntu20.04orangepi@orangepi:~$ '''cd python_whl'''orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-19.24.0-cp38-cp38-linux_aarch64.whl'''</li><li>Ubuntu22.04orangepi@orangepi:~$ '''cd python_whl'''orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-19.24.0-cp310-cp310-linux_aarch64.whl'''</li><li>Debian11orangepi@orangepi:~$ '''cd python_whl'''orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-19.24.0-cp39-cp39-linux_aarch64.whl'''</li></ol></li><li>安装完后如果使用下面的命令能正常打印dlib的版本号，就说明dlib安装正确orangepi@orangepi:~/python_whl$ '''python3 -c "import dlib; print(dlib.__version__)"''''''19.24.0'''</li></ol>~~通过docker安装 ===

~~~~<ol ~~start="5"~~ style="list-style-type: decimal;"><li>~~然后安装下'''face_recognition_models-0.~~首先请安装好docker，并确保docker能正常运行。docker的安装步骤请参考[[Orange Pi Zero 3~~.0-py2.py3-none-any.whl~~#安装Docker的方法|'''~~orangepi@orangepi:~/python_whl$ '''python3 -m pip install face_recognition_models-0.3.0-py2.py3-none-any.whl'''</li><li>然后安装'''face_recognition'''orangepi@orangepi:~$ '''python3 -m pip install face_recognition~~安装Docker的方法''']]一节的说明。</li><li>~~然后'''需要重新打开一个终端'''，才能找到并运行'''face_detection'''和'''face_recognition'''这两个命令~~然后可以搜索下Home Assistant的docker镜像~~<ol style~~{| class="~~list-style-type: lower-alpha;~~wikitable">~~<li>face_recognition命令用来在单张图片或一个图片文件夹中识别是谁的脸</li><li>face_detection命令用来在单张图片或一个图片文件夹中定位人脸的位置orangepi@orangepi:~$ '''which face_detection'''/usr/local/bin/face_detectionorangepi@orangepi:~$ '''which face_recognition'''/usr/local/bin/face_recognition</li></ol></li></ol>~~ ~~如果重新打开终端找不到上面的两个命令，请试下手动导入环境变量，然后再测试下。~~ ~~orangepi@orangepi:~$ '''export PATH=/home/orangepi/.local/bin:$PATH'''~~ ~~=== face_recognition的测试方法 ===~~ ~~'''注意，下面的操作都是在桌面中演示的，所以首先请连接好HDMI显示器，或者使用NoMachine/VNC远程登录Linux桌面来测试。'''~~ ~~<ol~~ style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>在'''face_recognition'''的源码中有一些示例代码，我们可以直接用来测试，face_recognition源码的下载地址如下所示：<ol style="list-style-type: lower~~|-~~alpha;"><li>GitHub官方的下载地址~~| orangepi@orangepi:~$ '''~~git clone https://github.com/ageitgey/face_recognition.git~~docker search homeassistant'''~~</li><li>Gitee镜像下载地址~~~~orangepi@orangepi:~$ '''git clone [https://github.com/ageitgey/face_recognition https://gitee.com/leeboby/face_recognition.git]'''</li></ol>~~|}

</li>

<li>~~face_recognition示例代码的路径如下所示~~然后使用下面的命令下载Home Assistant的docker镜像到本地，镜像大小大概有1GB多，下载时间会比较长，请耐心等待下载完成{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~face_recognition~~docker pull homeassistant/~~examples~~home-assistant'''</p~~></li~~>~~<li>~~~~face_recognition的中文说明文档链接如下所示，使用face_recognition前请仔细阅读下~~Using default tag: latest~~[https~~latest:Pulling from homeassistant/~~/github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.md '''https://github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.md''']~~home-assistant</p~~></li~~>~~<li>~~~~'''find_faces_in_picture.py'''用来在图片中定位人脸的位置，测试步骤如下所示~~be307f383ecc: Downloading~~<ol style="list-style-type: lower-alpha;"><li>~~~~在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令~~5fbc4c07ac88: Download complete~~orangepi@orangepi:~$~~ '''~~cd face_recognition/examples~~...... (省略部分输出)'''~~orangepi@orangepi~~3cc6a1510c9f:~~~/face_recognition/examples$ '''python3 find_faces_in_picture.py'''~~Pull complete~~'''I found 1 face(s) in this photograph.'''~~7a4e4d5b979f: Pull complete~~'''A face is located at pixel location Top~~Digest: ~~241, Left~~sha256: ~~419, Bottom: 562, Right: 740'''~~81d381f5008c082a37da97d8b08dd8b358dae7ecf49e62ce3ef1eeaefc4381bb</p~~></li~~>~~<li>~~~~等待一段时间会弹出下面的图片，这就是在测试图片中定位到的人脸~~Status: Downloaded newer image for homeassistant/home-assistant:latest~~[[File:media/image201~~docker.~~png|575x311px]]<~~io/~~p><~~homeassistant/~~li>~~home-assistant:latest</olp>|}

</li>

<li>然后可以使用下面的命令查看下刚下载的Home Assistant的docker镜像{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~find_facial_features_in_picture.py~~docker images homeassistant/home-assistant'''~~用来识别单张图片中人脸的关键点，测试步骤如下所示~~<ol p>REPOSITORY                                    TAG       IMAGE       ID       CREATED       SIZEhomeassistant/home-assistant       latest       bfa0ab9e1cf5       2 months ago       '''1.17GB'''|}</li><li>~~在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令~~此时就可以运行Home Assistant的docker容器了{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~cd face_recognition/examples~~docker run -d \''':~~orangepi@orangepi:~/face_recognition/examples$~~ '''~~python3 find_facial_features_in_picture.py~~--name homeassistant \''':'''--privileged \'''</lip>:<lip>'''--restart=unless-stopped \''':~~等待一段时间会弹出下面的图片，可以看到将人脸轮廓都标注出来了~~'''-e TZ=Asia/Shanghai \''':~~[[File~~'''-v /home/orangepi/home-assistant:~~media~~/~~image202.png|575x302px]]~~config \''':'''--network=host \'''</lip>:'''homeassistant/home-assistant:latest'''</olp>|}

</li>

<li>然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''~~identify_and_draw_boxes_on_faces~~Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''</big>|}[[File:zero3-img188.pypng]]</li><li>然后输入'''姓名、用户名'''和'''密码'~~用来识别人脸并使用方框标注，测试步骤如下所示~~''再点击'''创建账号'''[[File:zero3-img189.png]]</li><li>然后按照界面提示根据自己的喜好设置，再点击下一步[[File:zero3-img190.png]]</li><li>然后点击下一步[[File:zero3-img191.png]]</li><li>然后点击完成[[File:zero3-img192.png]]</li><li>Home Assistant最终显示的主界面如下图所示[[File:zero3-img193.png]]</li><li>停止Home Assistant容器的方法

<li>~~在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令~~查看docker容器的命令如下所示~~orangepi@orangepi~~{| class="wikitable" style="width:~~~$ '''cd face_recognition/examples'''~~800px;" |-| orangepi@orangepi:~~~/face_recognition/examples~~$ '''~~python3 identify_and_draw_boxes_on_faces.py~~docker ps -a'''~~</li><li>等待一段时间会弹出下面的图片，可以看到将图片中的人脸都使用方框标注出来了，并且正确显示了人物的名字~~~~[[File:media/image203.png~~|~~461x250px]]</li></ol>~~}

</li>

<li>'''face_distance.py'''用来在不同精度上比较两个人脸是否属于一个人，首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令就可以看到测试的输出结果停止Home Assistant容器的命令如下所示~~orangepi@orangepi:~$ '''cd face_recognition/examples'''orangepi@orangepi:~/face_recognition/examples$ '''python3 face_distance.py''''''The test image has a distance of 0.35 from known image #0''''''- With a normal cutoff of 0.6, would the test image match the known image? True''''''- With a very strict cutoff of 0.5, would the test image match the known image? True''''''The test image has a distance of 0.82 from known image #1''''''- With a normal cutoff of 0.6, would the test image match the known image? False''''''- With a very strict cutoff of 0.5, would the test image match the known image? False'''</li>~~<li>'''recognize_faces_in_pictures.py'''用来识别未知图片中的人脸是谁。首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令，等待一端时间后就能看到测试结果~~orangepi@orangepi:~$ '''cd face_recognition/examples'''orangepi@orangepi:~/face_recognition/examples$ '''python3 recognize_faces_in_pictures.py''''''Is the unknown face a picture of Biden? False''''''Is the unknown face a picture of Obama? True''''''Is the unknown face a new person that we've never seen before? False'''</li><li>'''facerec_from_webcam_faster.py'''用来识别USB摄像头中的人脸，测试步骤如下所示：<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>首先请将USB摄像头插入开发板的USB接口中，然后通过'''v4l2~~|-~~ctl'''（'''注意v4l2中的l是小写字母l，不是数字1'''）命令查看下USB摄像头的设备节点的序号orangepi@orangepi:~$ '''sudo apt update'''~~| orangepi@orangepi:~$ '''~~sudo apt install -y v4l-utils'''orangepi@orangepi:~$ '''v4l2-ctl --list-devices'''cedrus (platform:cedrus):/dev/video0USB2.0 UVC PC Camera: USB2.0 UV (usb-5311000.usb-1):'''/dev/video1~~docker stop homeassistant'''~~/dev/video2</li>~~<li>然后在桌面中打开一个终端，进入'''face_recognition/examples'''目录后，首先修改下'''facerec_from_webcam_faster.py'''中使用的摄像头的设备序号。比如上面通过'''v4l2-ctl > --list-devices'''命令查看到USB摄像头为'''/dev/video1'''，那就修改'''cv2.VideoCapture(0)'''中的'''0'''为'''1'''~~orangepi@orangepi:~$ '''cd face_recognition/examples'''orangepi@orangepi:~/face_recognition/examples$ '''vim facerec_from_webcam_faster.py''''''video_capture = cv2.VideoCapture(1)'''</li><li>然后执行下面的命令运行'''facerec_from_webcam_faster.py'''orangepi@orangepi:~/face_recognition/examples$ '''python3 facerec_from_webcam_faster.py'''</li><li>等待一段时间会弹出摄像头的显示画面[[File:media/image204.png~~|~~314x245px]]</li>~~<li>此时可以将摄像头对准自己，当摄像头检测到人脸时，会将检测到的人脸使用方框框起来。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</li><li>还可以打开一张奥巴马的图片，然后使用摄像头对准打开的图片，可以看到不仅能将人脸标注出来，还能正确显示检测到的人脸的名字。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''~~[[File:media/image205.png|358x284px]]</li></ol>~~}

</li>

<li>'''web_service_example.py'''是一个非常简单的使用Web服务上传图片运行人脸识别的案例，后端服务器会识别这张图片是不是奥巴马，并把识别结果以json键值对输出，测试步骤如下所示：~~<ol style="list-style-type: lower-alpha;">~~<li>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令（'''如果是使用脚本自动安装的face_recognition，那么就不需要安装flask了'''）~~orangepi@orangepi:~$ '''python3 -m pip install flask'''orangepi@orangepi:~$ '''cd face_recognition/examples'''root@orangepi:~/face_recognition/examples$ '''python3 web_service_example.py'''* Serving Flask app 'web_service_example' (lazy loading)* Environment: productionWARNING: This is a development server. Do not use it in a production deployment.Use a production WSGI server instead.* Debug mode: on* Running on all addresses (0.0.0.0)WARNING: This is a development server. Do not use it in a production deployment.* Running on http://127.0.0.1:5001* Running on http://192.168.1.79:5001 (Press CTRL+C to quit)* Restarting with stat* Debugger is active!* Debugger PIN: 500-161-390</li><li>然后另外打开一个终端，再运行下面的命令就可以返回图片识别的结果（注意，下面的命令执行路径为'''face_recognition/examples'''）orangepi@orangepi:~/face_recognition/examples$ '''curl -XPOST -F \''''''"file=@obama2.jpg" http://127.0.0.1:5001''''''{''''''"face_found_in_image": true,''''''"is_picture_of_obama": true''''''}'''</li>~~<li>我们也可以将'''face_recognition/examples/obama2.jpg'''这张图片拷贝到其他的Linux电脑中，当然也可以自己准备一张名为'''obama2.jpg'''的图片，然后在Linux电脑中可以使用下面的命令远程通过开发板运行的服务来识别人脸（'''注意命令中的IP地址需要替换为开发板的IP地址，file后的文件名需要替换为想要测试的图片的名字'''）~~test@test:~$ '''curl -XPOST -F "file=@obama2.jpg" http://192.168.1.79:5001'''~~删除Home Assistant容器的命令如下所示~~'''~~{~~''''''"face_found_in_image": true,''''''"is_picture_of_obama": true''''''}'''</li><li>使用浏览器测试的方法如下所示：<ol style="list-style-type: lower-alpha;"><li>首先打开浏览器，然后在浏览器的地址栏输入'''开发板的IP地址:5001'''，然后就能看到下面的页面[[File:media/image206.png|575x150px]]</li><li>然后将obama2.jpg复制到桌面orangepi@orangepi:~/face_recognition/examples$ '''cp obama2.jpg /home/orangepi/Desktop/'''</li><li>然后在浏览器中选择刚才复制的图片[[File:media/image207.png|575x217px]]</li><li>然后点击'''Upload'''上传刚才选择的图片进行人脸识别[[File:media/image208.png|575x145px]]</li><li>等待一段时间后就会显示检测的结果[[File:media/image209.png~~|~~314x149px]]</li></ol></li></ol></li><li>'''face_detection'''命令测试示例<ol style~~class="~~list-style-type: lower-alpha;~~wikitable"><li>face_detection命令行工具可以在单张图片或一个图片文件夹中定位人脸位置（输出像素点坐标）。使用'''face_detection > --help'''可以查看下face_detection命令的帮助信息~~orangepi@orangepi:~$ '''face_detection --help'''Usage: face_detection [OPTIONS] IMAGE_TO_CHECKOptions:--cpus INTEGER number of CPU cores to use in parallel. -1 means "use all insystem"--model TEXT Which face detection model to use. Options are "hog" or"cnn".--help Show this message and exit.</li><li>检测单张图片的示例如下所示：orangepi@orangepi:~$ '''cd face_recognition/examples'''orangepi@orangepi:~/face_recognition/examples$ '''face_detection obama2.jpg'''obama2.jpg,302,474,611,164</li><li>使用多核并行检测多张图片的示例如下所示：<ol~~ style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>首先进入'''face_recognition/examples'''文件夹</li><li>然后新建一个test文件夹</li><li>然后将jpg图片都拷贝到test文件夹中</li><li>然后使用所有的cpu并行运行'''face_detection'''来检查test文件夹中的图片，其中'''-~~|-~~cpus > -1'''表示使用所有的cpuorangepi@orangepi:~$ '''cd face_recognition/examples'''~~| orangepi@orangepi:~~~/face_recognition/examples~~$ '''~~mkdir test~~docker rm homeassistant'''~~orangepi@orangepi:~/face_recognition/examples$ '''cp *.jpg test'''orangepi@orangepi:~/face_recognition/examples$ '''face_detection --cpus -1 test'''~~|}~~test/obama-240p.jpg,29,261,101,189test/obama_small.jpg,65,215,169,112test/obama2.jpg,302,474,611,164test/two_people.jpg,62,394,211,244test/two_people.jpg,95,941,244,792test/obama.jpg,136,624,394,366test/obama-480p.jpg,65,507,189,383test/obama-720p.jpg,94,751,273,572test/obama-1080p.jpg,136,1140,394,882test/biden.jpg,233,749,542,439~~</li></ol>

</li></ol>

=== 通过python安装 ===

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

|-

|

<big>'''安装前请先更换下pip的源为国内源，加快Python包的安装速度，配置方法见[[Orange Pi Zero 3#Python更换pip源的方法|'''Python更换pip源的方法''']]一节的说明。'''</big>

|}

<li>首先安装依赖包

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

|-

|

orangepi@orangepi:~$ '''sudo apt-get update'''

orangepi@orangepi:~$ '''sudo apt-get install -y python3 python3-dev python3-venv \'''

'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''

'''libopenjp2-7 libtiff5 libturbojpeg0-dev tzdata'''

|}

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

|-

|

<big>'''如果是debian12请使用下面的命令：'''</big>

orangepi@orangepi:~$ '''sudo apt-get update'''

orangepi@orangepi:~$ '''sudo apt-get install -y python3 python3-dev python3-venv \'''

'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''

'''libopenjp2-7 libturbojpeg0-dev tzdata'''

|}

</li>

<li>然后需要编译安装Python3.9，方法请参考[[Orange Pi Zero 3#Python源码编译安装的方法|'''~~face_recognition~~Python源码编译安装的方法'''~~命令测试示例~~]]一节~~<ol~~ {| class="wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~lower-alpha~~800px;">|-| <libig>'''~~face_recognition'''命令行工具可以在单张图片或者一个图片文件夹中认出是谁的脸。使用'''face_recognition > --help~~Debian Bullseye默认的Python版本就是Python3.9，所以无需编译安装。'''~~可以查看下face_recognition命令的帮助信息~~~~orangepi@orangepi:~$~~ '''~~face_recognition --help~~Ubuntu Jammy默认的Python版本就是Python3.10，所以也无需编译安装。'''~~Usage: face_recognition [OPTIONS] KNOWN_PEOPLE_FOLDER IMAGE_TO_CHECK~~'''Debian Bookworm默认的Python版本就是Python3.11，所以也无需编译安装。'''~~Options:~~</pbig>~~--cpus INTEGER number of CPU cores to use in parallel (can speed~~|}</pli><~~p>up processing lots of images). -1 means "use all in</p~~li>~~system"~~然后创建Python虚拟环境~~~~{| class="wikitable" style="background-~~-tolerance FLOAT Tolerance for face comparisons. Default is 0.6.Lower this if you get multiple matches for the sameperson.~~color:#ffffdc;width:800px;" ~~--show~~|-~~distance BOOLEAN Output face distance. Useful for tweaking tolerancesetting.--help Show this message and exit.</li>~~| <libig>~~首先新建一个已知名字的人脸图片文件夹'''known_people'''，然后复制两张图片到'''known_people'''中，然后将'''obama2.jpg'''复制为~~'''~~unkown~~Debian Bookworm中是python3.~~jpg~~11，请记得替换对应的命令。'''~~，也就是我们要识别的图片~~</big>|}{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~cd face_recognition~~sudo mkdir /srv/~~examples~~homeassistant'''orangepi@orangepi:~~~/face_recognition/examples~~$ '''~~mkdir known_people~~sudo chown orangepi:orangepi /srv/homeassistant'''orangepi@orangepi:~~~/face_recognition/examples~~$ '''~~cp biden.jpg obama.jpg known_people~~cd /srv/homeassistant'''orangepi@orangepi:~~~/face_recognition/examples~~$ '''~~cp obama2~~python3.~~jpg unkown~~9 -m venv .~~jpg~~'''</p~~></li~~>~~<li>~~~~然后就可以使用下面的命令识别下~~orangepi@orangepi:~$ '''~~unkown.jpg~~source bin/activate'''~~图片中人物的名字，可以看到识别到unkown.jpg图片为obama~~(homeassistant) orangepi@orangepi:~/~~face_recognition~~srv/~~examples~~homeassistant$ ~~'''face_recognition known_people \'''~~~~'''unkown.jpg'''~~|}~~unkown.jpg,obama~~</li><li>~~如果我们识别一张不相关的图片，就会显示unknown_person~~然后安装需要的Python包{| class="wikitable" style="width:800px;" |-| ~~root~~(homeassistant) orangepi@orangepi:~/~~face_recognition~~srv/~~examples~~homeassistant$ '''~~face_recognition known_people \~~python3 -m pip install wheel'''~~'''alex-lacamoire.png'''~~|}~~alex-lacamoire.png,unknown_person~~</li><li>~~我们还可以新建一个test文件夹，然后在其中放入多张图片，然后就可以使用所有的CPU来并行识别所有的图片~~然后就可以安装Home Assistant Core{| class="wikitable" style="width:800px;" |-| (homeassistant) orangepi@orangepi:~/~~face_recognition~~srv/~~examples~~homeassistant$ '''~~mkdir test~~pip3 install homeassistant'''|}</li><li>~~orangepi@orangepi:~/face_recognition/examples$ '''cp *.jpg *.png test'''~~然后输入下面的命令就可以运行Home Assistant Core{| class="wikitable" style="width:800px;" |-| (homeassistant) orangepi@orangepi:~/~~face_recognition~~srv/~~examples~~homeassistant$ '''~~face_recognition --cpus -1 \~~hass'''|}</li><li>然后在浏览器中输入【'''~~known_people test~~开发板的IP地址:8123'''】就能看到Home Assistant的界面~~test/obama~~{| class="wikitable" style="background-~~240p.jpg,obama~~color:#ffffdc;width:800px;" ~~test/alex~~|-~~lacamoire.png,unknown_persontest/obama_small.jpg,obama~~| <pbig>~~test/unkown.jpg,obama~~~~test/obama2.jpg,obama~~'''第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。'''~~test/lin-manuel-miranda.png,unknown_person~~</pbig>~~test/two_people.jpg,biden~~|}~~test/two_people.jpg,obamatest/obama~~[[File:zero3-~~720p~~img194.~~jpg,obamatest/obama.jpg,obama~~png]]~~test/obama-480p.jpg,obamatest/biden.jpg,bidentest/obama-1080p.jpg,obama</li></ol>~~</li></ol>

~~'''注意，安装中文输入法前请确保开发板使用的Linux系统为桌面版系统。'''~~== OpenCV的安装方法 ==

=== ~~Debian 系统的安装方法~~ 使用apt来安装OpenCV ===

<li>~~首先设置默认~~安装命令如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~locale~~sudo apt-get update'''~~为中文~~orangepi@orangepi:~$ '''sudo apt-get install -y libopencv-dev python3-opencv'''|}</li><li>然后使用下面的命令打印OpenCV的版本号输出正常，说明OpenCV安装成功

<li>~~输入下面的命令可以开始配置'''locale'''~~Ubuntu22.04中OpenCV的版本如下所示：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo dpkg~~python3 -~~reconfigure locales~~c "import cv2; print(cv2.__version__)"'''</p~~></li~~>~~<li>~~~~然后在弹出的界面中选择~~'''~~zh_CN~~4.5.~~UTF-8 > UTF-8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''<OK>~~4'''~~，然后回车即可）~~|}</li><li>~~[[File:media/image210~~Ubuntu20.~~png|575x296px]]~~04中OpenCV的版本如下所示：~~</li><li>~~{| class="wikitable" style="width:800px;" |-| ~~然后设置默认~~orangepi@orangepi:~$ '''~~locale'''为'''zh_CN~~python3 -c "import cv2; print(cv2.~~UTF-8~~__version__)"'''~~[[File:media/image211~~'''4.2.~~png|575x160px]]~~0'''|}</li><li>~~退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示~~Debian11中OpenCV的版本如下所示：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo dpkg~~python3 -~~reconfigure locales~~c "import cv2; print(cv2.__version__)"'''~~Generating locales (this might take a while).~~'''4.5.1'''~~en_US.UTF-8... donezh_CN.UTF-8... doneGeneration complete.</li></ol>~~|}

</li>

<li>~~然后打开'''Input Method'''~~Debian12中OpenCV的版本如下所示：~~[[File:media/image212.png~~{|~~575x361px]]</li><li>然后选择'''OK'''[[File:media/image213.png|295x212px]]</li><li>然后选择'''Yes'''[[File~~class="wikitable" style="width:~~media/image214.png|303x192px]]</li>~~800px;" ~~<li>然后选择'''fcitx'''[[File:media/image215.png~~|~~307x220px]]</li><li>然后选择'''OK'''[[File:media/image216.png|305x216px]]</li><li>'''然后重启Linux系统才能使配置生效'''</li><li>然后打开'''Fcitx configuration'''~~-~~[[File:media/image217.png~~|~~575x376px]]</li><li>然后点击下图所示位置的'''+'''号[[File:media/image218.png|280x187px]]</li><li>然后搜索'''Google Pinyin'''再点击'''OK'''[[File:media/image219.png|291x196px]]</li><li>然后将'''Google Pinyin'''放到最前面[[File:media/image220.png|299x202px]][[File:media/image221.png|300x202px]]</li><li>然后打开'''Geany'''这个编辑器测试下中文输入法[[File:media/image222.png|349x212px]]</li><li>中文输入法测试如下所示[[File:media/image223.png|575x325px]]</li><li>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</li><li>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CN.UTF-8'''~~orangepi@orangepi:~$ '''~~sudo vim /etc/default/locale'''# File generated by update~~python3 -~~localeLC_MESSAGES='''zh_CN~~c "import cv2; print(cv2.~~UTF-8~~__version__)"'''~~LANG=~~'''~~zh_CN~~4.6.~~UTF-8~~0'''~~LANGUAGE='''zh_CN.UTF-8'''~~|}</~~li>~~<li>~~然后'''重启系统'''就能看到系统显示为中文了~~</pol>~~[[File:media/image224.png|576x356px]]~~</li></ol>

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

~~<ol style~~=~~"list-style-type: decimal;"><li>首先打开'''Language Support'''[[File:media/image225.png|575x351px]]</li><li>然后找到'''汉语（中国）'''选项[[File:media/image226.png|318x311px]]</li><li>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：[[File:media/image227.png|324x320px]]</li></ol>~~= 宝塔Linux面板的安装方法 ==

~~'''注意，这一步不是很好拖动的，请耐心多试几次。'''~~ ~~<ol start~~{| class="4wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~decimal~~800px;">~~<li>然后选择'''Apply System~~|-~~Wide'''将中文设置应用到整个系统[[File:media/image228.png~~|~~321x316px]]</li>~~<~~li><p~~big>~~然后设置~~'''~~Keyboard input method system'''为'''fcitx'''<~~宝塔Linux面板是提升运维效率的服务器管理软件，支持一键LAMP/p>~~[[File:media~~LNMP/~~image229.png|327x320px]]<~~集群/~~p><~~监控/~~li><li>'''然后重启Linux系统使配置生效'''<~~网站/~~p><~~FTP/~~li><li>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文<~~数据库/p>~~~~JAVA等100多项服务器管理功能（摘抄自[~~[File~~https:~~media~~/~~image230~~/www.~~png|303x247px]]</li><li>然后可以看到桌面都显示为中文了[[File:media/image231~~bt.~~png|575x383px]]<~~cn/~~p></li><li>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示[[File:media/image232.png|576x292px~~宝塔官网]~~]</li><li>打开'''Geany~~）'''~~后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了~~</pbig>~~[[File:media/image233.png~~|~~575x308px]]</li></ol>~~ ~~=== Ubuntu 22.04系统的安装方法 ===~~}

<li>~~首先打开~~首先需要扩展下'''~~Language Support~~/tmp'''空间的大小，设置完后需要'''重启下开发板的linux系统'''，命令如下所示：{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''sudo sed -i 's/nosuid/~~image225.png|575x351px]]~~&,size=2G/' /etc/fstab'''orangepi@orangepi:~$ '''sudo reboot'''|}</li><li>~~然后找到~~重启后，可以看到'''~~汉语（中国）~~/tmp'''选项空间的大小变为2G了{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''df -h | grep "/tmp"'''</~~image234~~p>tmpfs 2.0G 12K '''2.~~png~~0G''' 1% /tmp|~~249x242px]]~~}</li><li>然后在linux系统中输入下面的命令就可以开始宝塔的安装{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo install_bt_panel.sh'''|}</li><li>~~然后请使用鼠标左键选中~~然后宝塔安装程序会提醒是否安装'''Bt-Panel'''到'''/www'''文件夹，此时输入'''~~汉语（中国）~~y'''~~并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：~~即可{| class="wikitable" style="width:800px;" |-| +----------------------------------------------------------------------| Bt-WebPanel FOR CentOS/Ubuntu/Debian~~[[File~~+----------------------------------------------------------------------| Copyright © 2015-2099 BT-SOFT(http:~~media~~/~~image235~~/www.bt.cn) All rights reserved.~~png~~+----------------------------------------------------------------------|~~267x262px]]~~The WebPanel URL will be http://SERVER_IP:8888 when installed.<~~/li~~p>+----------------------------------------------------------------------</olp>

~~'''注意，这一步不是很好拖动的，请耐心多试几次。'''~~

<~~ol start="4"~~ p>Do you want to install Bt-Panel to the /www directory now?(y/n): '''y'''|}</li><li>~~然后选择'''Apply System-Wide'''将中文设置应用到整个系统~~然后要做的就是耐心等待，当看到终端输出下面的打印信息时，说明宝塔已经安装完成，整个安装过程大约耗时34分钟，根据网络速度的不同可能会有一些差别[[File:~~media/image236~~zero3-img195.png~~|287x282px~~]]</li><li>此时在浏览器中输入上面显示的'''面板地址''~~然后重启Linux系统使配置生效~~'就可以打开宝塔Linux面板的登录界面，然后在对应的位置输入上图显示的''~~</li><li>重新进入系统后，在下面的界面请选择~~'username'''和'''~~不要再次询问我~~password'''~~，然后请根据自己的喜好决定标准文件夹是否也要更新为中文~~就可以登录进宝塔 ~~~~[[File:~~media/image230~~zero3-img196.png~~|303x247px~~]]</li><li>~~然后可以看到桌面都显示为中文了~~成功登录宝塔后的会弹出下面的欢迎界面，首先请将中间的用户须知阅读完拖到最下面，然后就可以选择”我已同意并阅读《用户协议》“，接着点击”进入面板”就可以进入宝塔了[[File:~~media/image231~~zero3-img197.png|~~575x383px~~1200px]]</li><li>~~然后打开Fcitx5配置程序~~进入宝塔后首先会提示需要绑定宝塔官网的账号，如果没有账号可以去宝塔的官网（'''https://www.bt.cn'''）注册一个[[File:~~media/image237~~zero3-img198.png~~|575x349px~~]]</li><li>~~然后选择使用拼音输入法~~最终显示的界面如下图所示，可以很直观的看到开发板Linux系统的一些状态信息，比如负载状态、CPU的使用率、内存使用率和存储空间的使用情况等[[File:~~media/image238~~zero3-img199.png|~~338x267px~~1200px]]</li><li>~~选择后的界面如下所示，再点击确定即可~~宝塔的更多功能可以参考下面资料自行探索{| class="wikitable" style="width:800px;" |-| 使用手册：[~~[File~~http:~~media~~/~~image239~~/docs.bt.~~png|366x290px]]</li><li>然后我们可以打开~~cn '''~~Geany~~http://docs.bt.cn'''~~测试下中文输入法，打开方式如下图所示~~]论坛地址：[~~[File~~https:~~media~~/~~image232~~/www.~~png|576x292px]]<~~bt.cn/~~li><li>打开~~bbs '''~~Geany~~https://www.bt.cn/bbs'''~~后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了~~]~~[[File~~GitHub链接：'''https:~~media~~/~~image240~~/github.~~png|434x308px]]~~com/aaPanel/BaoTa'''|}</li></ol>

~~~~=~~= 远程登录Linux系统桌面的方法~~ face_recognition人脸识别库的安装和测试方法 ==

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

'''请确保开发板安装的Ubuntu或者Debian系统为桌面版本的系统。另外NoMachine也提供了详细的使用文档，强烈建议通读此文档来熟悉NoMachine的使用，文档链接如下所示：另外下面的安装测试都是在orangepi用户下进行的，请保持环境一致。'''

~~'''https://knowledgebase.nomachine.com/DT10R00166'''~~

'''NoMachine支持Windows、Mac、Linux、iOS和安卓平台，所以我们可以在多种设备上通过NoMachine来远程登录控制Orange Pi开发板。下面演示下在Windows中通过NoMachine来远程登录Orange Pi开发板的Linux系统桌面。其他平台的安装方法请参考下NoMachine的官方文档。Debian12目前没有适配。'''</big>|}

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

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

'''~~注意，这个下载链接可能会变，请认准Armv8/Arm64版本的deb包。~~face_recognition中文版本的说明文档为：'''

['''https://~~www.nomachine~~github.com/~~download~~ageitgey/face_recognition/~~download&id=112&s=ARM '''https:~~blob/master/~~downloads.nomachine~~README_Simplified_Chinese.~~com/download/?id=118&distro=ARM~~md''']</big>|}

~~[[File:media/image241.png|575x227px]]~~=== 使用脚本自动安装face_recognition的方法 ===

<ol ~~start="2"~~ style="list-style-type: ~~lower-alpha~~decimal;"><li>~~另外在~~首先在桌面中打开一个终端，然后下载'''~~官方工具'~~face_recognition_install.sh''~~中也可以下载到~~'~~''NoMachine'''的安装包~~~~[[File~~{| class="wikitable" style="width:~~media/image242.png~~800px;" |-|~~70x86px]]~~~~先进入~~orangepi@orangepi:~/Desktop$ '''~~远程登录软件-NoMachine~~wget \'''~~文件夹~~~~[[File~~'''https:~~media~~/~~image243~~/gitee.com/leeboby/face_recognition_install/raw/master/face_recognition_install.~~png|256x46px]]~~sh'''~~然后下载arm64版本的deb安装包~~|}</pli><pli>~~[[File:media/image244.png|180x109px]]~~然后执行下面的命令开始安装'''face_recognition'''</lip>~~<li>~~{| class="wikitable" style="width:800px;" |-| ~~然后将下载的~~orangepi@orangepi:~/Desktop$ '''~~nomachine_x~~bash face_recognition_install.~~x.x_x_arm64.deb~~sh'''~~上传到开发板的Linux系统中~~|}</li><li>~~然后使用下面的命令在开发板的Linux系统中安装'''NoMachine'''~~face_recognition安装完后会自动下载face_recognition的源码，然后自动运行face_recognition中的一些示例，如果最后能看到桌面上弹出了下面的这些图片就说明face_recognition安装测试成功了~~orangepi@orangepi~~[[File:~~~$ '''sudo dpkg~~ zero3-~~i nomachine_x~~img200.~~x.x_x_arm64_arm64.deb'''~~png]]</li></ol>

~~<ol start~~=~~"2" style~~=~~"list-style-type: decimal;"><li>然后下载NoMachine软件Windows版本的安装包，下载地址如下所示</li></ol>~~ ~~'''注意，这个下载链接可能会变。'''~~ ~~'''https://downloads.nomachine.com/download/?id~~=~~9'''~~ ~~[[File:media/image245.png|575x163px]]~~ ~~<ol start~~手动安装face_recognition的方法 =~~"3" style~~=~~"list-style-type: decimal;"><li>然后在Windows中安装NoMachine，'''安装完后请重启下电脑'''</li><li>然后在Window中打开'''NoMachine'''[[File:media/image246.png|76x66px]]</li>~~<li>NoMachine启动后会自动扫描局域网内其他安装有NoMachine的设备，进入NoMachine的主界面后就可以看到开发板已经在可连接的设备列表里了，然后点击下图红色方框所示的位置即可开始登录开发板的Linux系统桌面~~[[File:media/image247.png|321x92px]]</li><li>然后点击'''OK'''[[File:media/image248.png|318x217px]]</li><li>然后在下图对应的位置输入开发板Linux系统的用户名和密码，再点击'''OK'''开始登陆[[File:media/image249.png|303x204px]]</li><li>然后在接下来的界面中都点击OK</li><li>最后就能看到开发板Linux系统的桌面了[[File:media/image250.png|411x246px]]</li></ol>~~ ~~=== 使用VNC远程登录 ===~~ ~~'''操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''~~ ~~'''Ubuntu20.04测试VNC很多问题，请不要使用这种方法。'''~~

<li>~~首先运行~~首先新建'''~~set_vnc~~~/.shpip'''~~脚本设置下vnc，~~目录，再添加'''~~记得加sudo权限~~pip.conf'''配置文件，并在其中设置pip的镜像源为清华源，需要执行的命令如下所示：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo set_vnc~~mkdir -p ~/.shpip'''~~You will require a password to access your desktops~~orangepi@orangepi:~$ '''cat <<EOF > ~/.pip/pip.conf'''~~Password:~~ '''~~#在这里设置vnc的密码，8位字符~~[global]'''~~Verify:~~ '''~~#在这里设置vnc的密码，8位字符~~timeout = 6000'''~~Would you like to enter a view-only password (y/n)?~~ '''nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple'''~~xauth: file /root/~~'''trusted-host = pypi.tuna.tsinghua.edu.~~Xauthority does not exist~~cn'''~~New~~ 'X' ~~desktop is orangepi:1~~'EOF'''|}</li><li>~~Creating default startup script /root/.vnc/xstartup~~然后安装依赖包{| class="wikitable" style="width:800px;" |-| ~~Starting applications specified in /root/.vnc/xstartup~~orangepi@orangepi:~$ '''sudo apt update'''~~Log file is /root/.vnc/~~orangepi@orangepi:~~1.log~~~$ '''sudo apt install -y python3-pip libopencv-dev \'''~~Killing Xtightvnc process ID 3047~~'''python3-opencv imagemagick python3-scipy python3-setuptools python3-wheel \'''~~New~~ 'X' ~~desktop is orangepi:1~~'python3-dev cmake python3-testresources'''|}</li><li>~~Starting applications specified in /root/.vnc/xstartup~~然后更新下pip3{| class="wikitable" style="width:800px;" |-| ~~Log file is /root/.vnc/~~orangepi@orangepi:~~1.log~~~$ '''python3 -m pip install -U pip setuptools wheel'''|}</li><li>~~使用MobaXterm软件连接开发板linux系统桌面的步骤如下所示：~~安装'''face_recognition'''前首先需要安装下'''dlib'''这个库，由于dlib这个库在开发板上编译安装比较慢，所以我在'''gitee'''上保存了一份编译好的dlib whl文件，下载后直接安装就可以了。dlib whl文件下载地址如下所示：{| class="wikitable" style="width:800px;" |-| '''https://gitee.com/leeboby/python_whl'''|}

<li>~~首先点击Session，然后选择VNC，再填写开发板的IP地址和端口，最后点击OK确认~~首先将python_whl仓库下载到开发板的Linux系统中</lip>{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''git clone --depth=1 https://gitee.com/leeboby/python_whl'''</olp>|}</li><li>在python_whl文件夹中可以看到有多个版本的dlib安装包'''，'''dlib不同版本对应的Linux系统如下所示：</olli>

~~[[File:media/image251.png~~{|~~421x300px]]~~ ~~<ol start~~class="2wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>然后输入前面设置的VNC的密码[[File:media/image252.png~~|~~221x105px]]</li><li>登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了</li></ol>~~-~~[[File:media/image253.png~~|~~405x293px]]~~ ~~== QT的安装方法 ==~~ ~~<ol~~ style="~~list-style~~text-~~type~~align: ~~decimal~~left;">~~<li>使用下面的脚本可以安装QT5和QT Creatororangepi@orangepi:~$~~ | '''~~install_qt~~Ubuntu20.sh04'''~~</li><li>安装完后会自动打印QT的版本号<ol~~ | style="~~list-style~~text-~~type~~align: ~~lower-alpha~~left;">~~<li>Ubuntu20.04自带的qt版本为~~| '''5dlib-19.24.120-cp38-cp38-linux_aarch64.8whl'''~~orangepi@orangepi~~|-| style="text-align:~$ left;"| '''~~install_qt~~Ubuntu22.sh04'''~~......QMake version 3.1Using Qt version~~ | style="text-align: left;"| '''5dlib-19.24.120-cp310-cp310-linux_aarch64.8whl''' ~~in /usr/lib/aarch64~~|-~~linux~~| style="text-~~gnu</li><li>Ubuntu22.04自带的QT版本为~~align: left;"| '''~~5.15.3~~Debian11'''~~orangepi@orangepi~~| style="text-align:~$ left;"| '''~~install_qt~~dlib-19.24.sh0-cp39-cp39-linux_aarch64.whl'''~~......~~|}~~QMake version 3.1~~</pol><~~p>Using Qt version '''5.15.~~ol start="3~~''' in /usr/lib/aarch64~~" style="list-style-~~linux~~type: lower-~~gnu</li~~alpha;"><li>~~Debian11自带的QT版本为'''5.15.2'''~~然后就可以开始安装dlib，命令如下所示<~~p>orangepi@orangepi~~ol style="list-style-type:~~~$ '''install_qt.sh'''</p~~none;"><pli>~~......~~~~QMake version 3~~a) Ubuntu20.104~~Using Qt version '''5.15.2''' in /usr/lib/aarch64~~{| class="wikitable" style="width:800px;" |-~~linux-gnu</li><li>Debian12自带的QT版本为'''5.15.8'''~~| orangepi@orangepi:~$ '''~~install_qt.sh~~cd python_whl'''~~......<~~orangepi@orangepi:~/p>~~QMake version 3.1Using Qt version~~ python_whl$ '''5python3 -m pip install dlib-19.24.150-cp38-cp38-linux_aarch64.8whl''' ~~in /usr/lib/aarch64-linux-gnu~~~~</li></ol>~~|}

</li>

<li>~~然后在'''Applications'''中就可以看到QT Creator的启动图标~~b) Ubuntu22.04~~[[File~~{| class="wikitable" style="width:~~media/image254.png~~800px;" |~~576x270px]]~~-~~也可以使用下面的命令打开QT Creator~~| orangepi@orangepi:~$ '''~~qtcreator~~cd python_whl'''~~</li><li>QT Creator打开后的界面如下所示~~~~[[File~~orangepi@orangepi:~~media~~~/~~image255.png|576x342px]]</li><li>QT Creator的版本如下所示<ol style="list-style-type: lower-alpha;"><li>QT Creator在~~python_whl$ '''~~Ubuntu20~~python3 -m pip install dlib-19.~~04'''中的默认版本如下所示[[File:media/image256~~24.~~png|419x224px]]</li><li>QT Creator在'''Ubuntu22.04'''中的默认版本如下所示[[File:media/image257.png|443x237px]]</li><li>QT Creator在'''Debian11'''中的默认版本如下所示[[File:media/image258~~0-cp310-cp310-linux_aarch64.~~png|444x238px]]</li><li>QT Creator在~~whl'''~~Debian12'''中的默认版本如下所示~~~~[[File:media/image259.png~~|~~449x277px]]</li></ol>~~}

</li>

<li>~~然后设置下QT~~c) Debian11{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''cd python_whl'''orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-19.24.0-cp39-cp39-linux_aarch64.whl'''|}</li></ol></li><li>安装完后如果使用下面的命令能正常打印dlib的版本号，就说明dlib安装正确{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~/python_whl$ '''python3 -c "import dlib; print(dlib.__version__)"''''''19.24.0'''|}</li></ol></li></ol><ol start="5" style="list-style-type: decimal;"><li>然后安装下'''face_recognition_models-0.3.0-py2.py3-none-any.whl'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~/python_whl$ '''python3 -m pip install face_recognition_models-0.3.0-py2.py3-none-any.whl'''|}</li><li>然后安装'''face_recognition'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''python3 -m pip install face_recognition'''|}</li><li>然后'''需要重新打开一个终端'''，才能找到并运行'''face_detection'''和'''face_recognition'''这两个命令

<li>~~首先打开'''Help'''->'''About Plugins...'''[[File:media/image260.png|573x164px]]~~face_recognition命令用来在单张图片或一个图片文件夹中识别是谁的脸</li><li>~~然后去掉'''ClangCodeModel'''的那个勾~~face_detection命令用来在单张图片或一个图片文件夹中定位人脸的位置~~[[File:media/image261.png~~{|~~408x254px]]</li><li>'''设置完后需要重启下QT Creator'''</li><li>然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC'''Debian12请跳过这步。'''[[File~~class="wikitable" style="width:~~media/image262.png|576x315px]]~~800px;" ~~[[File:media/image263.png~~|~~575x307px]]</li></ol>~~-~~</li><li>然后就可以打开一个示例代码[[File:media/image264.png~~|~~575x312px]]</li><li>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明~~~~[[File~~orangepi@orangepi:~~media/image265.png|576x218px]]</li><li>然后点击下~~~$ '''~~Configure Project~~which face_detection'''~~[[File:media/image266.png|575x304px]]</li><li>然后点击左下角的绿色三角形编译运行下示例代码[[File:media/image267.png|575x312px]]</li><li>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行<~~/p>~~[[File:media~~usr/~~image268.png|576x308px]]<~~local/~~p><~~bin/~~li><li>参考资料~~face_detection~~[https~~orangepi@orangepi:~~//wiki.qt.io/Install_Qt_5_on_Ubuntu~~ ~$ '''~~https://wiki.qt.io/Install_Qt_5_on_Ubuntu~~which face_recognition''']~~[https:~~/usr/~~download.qt.io~~local/~~archive~~bin/~~qtcreator '''https://download.qt.io/archive/qtcreator''']~~face_recognition~~[https://download.qt.io/archive/qt '''https://download.qt.io/archive/qt''']~~|}</li></ol>

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

~~</~~span~~ol>~~=== Ubuntu20.04安装ROS 1 Noetic的方法 ===

~~# ROS 1当前活跃的版本如下所示，推荐版本为'''Noetic Ninjemys'''~~=== face_recognition的测试方法 ===

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

~~[[File~~<ol style="list-style-type:~~media~~decimal;"><li>在'''face_recognition'''的源码中有一些示例代码，我们可以直接用来测试，face_recognition源码的下载地址如下所示：</~~image270.png~~p><ol style="list-style-type: lower-alpha;"><li>GitHub官方的下载地址{| class="wikitable" style="width:800px;" |~~576x210px]]~~-| ~~[http~~orangepi@orangepi:~~//docs.ros.org/~~ ~$ '''~~http~~git clone https://~~docs~~github.~~ros~~com/ageitgey/face_recognition.~~org~~git''']|}</li><li>Gitee镜像下载地址{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''git clone [https://~~wiki~~github.~~ros~~com/ageitgey/face_recognition https://gitee.~~org~~com/~~Distributions~~leeboby/face_recognition.git]'''|}</li></ol ~~start~~></li><li>face_recognition示例代码的路径如下所示{| class="2wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>~~|-| ~~ROS 1~~ '''~~Noetic Ninjemys~~face_recognition/examples'''~~官方安装文档链接如下所示：~~|}</li><li>face_recognition的中文说明文档链接如下所示，使用face_recognition前请仔细阅读下{| class="wikitable" style="width:800px;" |-| [~~http~~https://~~wiki~~github.~~ros.org~~com/ageitgey/face_recognition/~~noetic~~blob/~~Installation~~master/~~Ubuntu~~ README_Simplified_Chinese.md '''~~http~~https://~~wiki~~github.~~ros.org~~com/ageitgey/face_recognition/~~noetic~~blob/~~Installation~~master/~~Ubuntu~~README_Simplified_Chinese.md''']|}</li><li>~~ROS~~ '''~~Noetic Ninjemys~~find_faces_in_picture.py'''~~官方安装文档中Ubuntu推荐使用Ubuntu20.04，所以请确保开发板使用的系统为~~用来在图片中定位人脸的位置，测试步骤如下所示<ol style="list-style-type: lower-alpha;"><li>在桌面中打开一个终端，然后进入'''~~Ubuntu20.04桌面版系统~~face_recognition/examples'''目录，再执行下面的命令{| class="wikitable" style="width:800px;" |-| ~~[http~~orangepi@orangepi:~~//wiki.ros.org/noetic/Installation~~ ~$ '''~~http:~~cd face_recognition/~~/wiki.ros.org/noetic/Installation~~examples''']~~[[File~~orangepi@orangepi:~~media~~~/~~image271~~face_recognition/examples$ '''python3 find_faces_in_picture.~~png|312x176px]]~~py'''</p~~></li~~>~~<li>~~~~然后使用下面的脚本安装ros1~~'''I found 1 face(s) in this photograph.'''~~orangepi@orangepi:~$~~ '''~~install_ros.sh ros1~~A face is located at pixel location Top: 241, Left: 419, Bottom: 562, Right: 740'''|}</li><li>~~使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件~~等待一段时间会弹出下面的图片，这就是在测试图片中定位到的人脸[[File:zero3-img201.png]]</li></ol></li><li>'''~~注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。~~find_facial_features_in_picture.py'''用来识别单张图片中人脸的关键点，测试步骤如下所示<ol style="list-style-type: lower-alpha;"><li>在桌面中打开一个终端，然后进入'''~~install_ros.sh脚本会尝试修改~~face_recognition/etc/hosts并自动运行下面的命令。但是这种方法无法保证每次都能正常访问github，如果install_ros.sh安装完ros1后有提示下面的错误，请自己想其它办法让开发板的linux系统能正常访问github，然后再手动运行下面的命令。examples'''目录，再执行下面的命令{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~https:~~cd face_recognition/examples'''</~~raw.githubusercontent.com~~p>orangepi@orangepi:~/~~ros~~face_recognition/~~rosdistro/master/rosdep/osx-homebrew~~examples$ '''python3 find_facial_features_in_picture.~~yaml~~py'''|}~~'''Hit https:~~</li><li>等待一段时间会弹出下面的图片，可以看到将人脸轮廓都标注出来了</~~raw~~p>[[File:zero3-img202.~~githubusercontent.com~~png]]</~~ros~~p></~~rosdistro~~li></~~master~~ol></~~rosdep/base.yaml~~li><li>''' identify_and_draw_boxes_on_faces.py'''~~ERROR: error loading sources~~ 用来识别人脸并使用方框标注，测试步骤如下所示<ol style="list-style-type:~~'''~~lower-alpha;"><li>在桌面中打开一个终端，然后进入'''~~The read operation timed out~~face_recognition/examples'''目录，再执行下面的命令{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~source /opt/ros/noetic~~cd face_recognition/~~setup.bash~~examples''' orangepi@orangepi:~/face_recognition/examples$ '''~~sudo rosdep init~~python3 identify_and_draw_boxes_on_faces.py'''|}~~Wrote~~ </li><li>等待一段时间会弹出下面的图片，可以看到将图片中的人脸都使用方框标注出来了，并且正确显示了人物的名字[[File:zero3-img203.png]]</~~etc~~p></~~ros~~li></~~rosdep~~ol></~~sources~~li><li>'''face_distance.~~list.d~~py'''用来在不同精度上比较两个人脸是否属于一个人，首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令就可以看到测试的输出结果</~~20-default.list~~p> ~~Recommended~~{| class="wikitable" style="width: ~~please run~~800px;" |-~~rosdep update~~| orangepi@orangepi:~$ '''~~rosdep update~~cd face_recognition/examples''' ~~reading in sources list data from~~ </~~etc/ros/rosdep/sources.list.d~~p> ~~Hit https~~orangepi@orangepi:~/face_recognition/~~raw~~examples$ '''python3 face_distance.~~githubusercontent.com~~py'''</~~ros/rosdistro/master/rosdep/osx-homebrew.yaml~~p> ~~Hit https://raw~~'''The test image has a distance of 0.~~githubusercontent.com~~35 from known image #0'''</~~ros/rosdistro/master/rosdep/base.yaml~~p> ~~Hit https://raw~~'''- With a normal cutoff of 0.~~githubusercontent.com~~6, would the test image match the known image? True'''</~~ros/rosdistro/master/rosdep/python.yaml~~p> ~~Hit https://raw~~'''- With a very strict cutoff of 0.~~githubusercontent.com~~5, would the test image match the known image? True'''</~~ros/rosdistro/master/rosdep/ruby.yaml~~ ~~Hit https://raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.yaml~~ ~~Query rosdistro index https://raw.githubusercontent.com/ros/rosdistro/master/index-v4.yaml~~p>

~~Skip end-of-life distro "ardent"~~

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

~~Add distro "galactic"~~

~~Skip end~~USB2.0 UVC PC Camera: USB2.0 UV (usb-of5311000.usb-~~life distro "groovy"~~1): ~~Add distro "humble"~~ ~~Skip end-of-life distro "hydro"~~ ~~Skip end-of-life distro "indigo"~~ ~~Skip end-of-life distro "jade"~~ ~~Skip end-of-life distro "kinetic"~~ ~~Skip end-of-life distro "lunar"~~ ~~Add distro "melodic"~~ ~~Add distro "noetic"~~ ~~Add distro "rolling"~~ ~~updated cache in~~ ::'''/dev/video1</~~home~~span>'''</~~orangepi~~p>::/~~.ros~~dev/~~rosdep~~video2</~~sources.cache~~p>|}<~~ol start="6" style="list-style-type: decimal;"~~/li><li>~~然后在~~然后在桌面中打开一个终端，进入'''face_recognition/examples'''目录后，首先修改下'''facerec_from_webcam_faster.py'''中使用的摄像头的设备序号。比如上面通过'''桌面v4l2-ctl --list-devices'''~~中打开一个命令行终端窗口，再使用~~命令查看到USB摄像头为'''~~test_ros~~/dev/video1'''，那就修改'''cv2.shVideoCapture(0)'''中的'''0'''为'''1'''~~脚本可以启动一个小海龟的例程来测试下ROS是否能正常使用~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~test_ros.sh~~cd face_recognition/examples'''</p~~></li~~>~~<li>~~~~运行完~~orangepi@orangepi:~/face_recognition/examples$ '''~~test_ros~~vim facerec_from_webcam_faster.shpy'''~~脚本后，会弹出下图所示的一个小海龟~~~~[[File~~'''video_capture = cv2.VideoCapture(1</~~image272.png|575x291px]]~~span>)'''|}</li><li>~~然后请保持刚才打开终端窗口在最上面~~然后执行下面的命令运行'''facerec_from_webcam_faster.py'''~~</li></ol>~~ ~~[[File:media/image273.png~~{|~~575x269px]]~~ ~~<ol start~~class="9wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>此时按下键盘上的方向按键就可以控制小海龟上下左右移动了~~|-| ~~[[File~~orangepi@orangepi:~~media~~~/~~image274~~face_recognition/examples$ '''python3 facerec_from_webcam_faster.~~png|575x250px]]~~py'''</p~~></li></ol~~>|}~~~~</~~span>=== Ubuntu20.04安装ROS 2 Galactic的方法 ===~~ ~~<ol style="list-style-type: decimal;"~~li><li>~~ROS 2当前活跃的版本如下所示，推荐版本为'''Galactic Geochelone'''~~等待一段时间会弹出摄像头的显示画面[[File:~~media/image275~~zero3-img204.png~~|576x271px~~]]<~~p>[[File:media~~/~~image276.png|575x265px]]</p~~li><pli>~~[http://docs.ros.org/ '''http://docs.ros.org''']~~此时可以将摄像头对准自己，当摄像头检测到人脸时，会将检测到的人脸使用方框框起来。'''~~http://docs.ros.org/en/galactic/Releases.html~~注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</li><li>~~ROS 2~~ 还可以打开一张奥巴马的图片，然后使用摄像头对准打开的图片，可以看到不仅能将人脸标注出来，还能正确显示检测到的人脸的名字。'''~~Galactic Geochelone~~注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''~~官方安装文档链接如下所示：~~~~'''docs~~[[File:zero3-img205.~~ros.org~~png]]</enp></~~galactic~~li></~~Installation.html'''~~ol></pli><li>'''~~http://docs~~web_service_example.~~ros.org/en/galactic/Installation/Ubuntu-Install-Debians.html~~py'''是一个非常简单的使用Web服务上传图片运行人脸识别的案例，后端服务器会识别这张图片是不是奥巴马，并把识别结果以json键值对输出，测试步骤如下所示：<~~/li~~ol style="list-style-type: lower-alpha;"><li>~~ROS 2~~ 在桌面中打开一个终端，然后进入'''~~Galactic Geochelone~~face_recognition/examples'''~~官方安装文档中Ubuntu Linux推荐使用Ubuntu20.04，所以请确保开发板使用的系统为~~目录，再执行下面的命令（'''~~Ubuntu20.04桌面版系统'''。安装ROS 2有几种方法，下面演示下通过'''Debian packages'''的方式来安装ROS 2 '''Galactic Geochelone~~如果是使用脚本自动安装的face_recognition，那么就不需要安装flask了'''）~~</li><li>~~{| class="wikitable" style="width:800px;" |-| 使用orangepi@orangepi:~$ '''~~install_ros.sh~~python3 -m pip install flask'''~~脚本可以安装ros2~~orangepi@orangepi:~$ '''~~install_ros.sh ros2~~cd face_recognition/examples'''</p~~></li~~>~~<li>~~root@orangepi:~/face_recognition/examples$ '''~~install_ros~~python3 web_service_example.shpy'''~~脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成~~~~usage: ros2 [-h] Call `ros2 <command> -h` for more detailed usage. ...~~* Serving Flask app 'web_service_example' (lazy loading)~~ros2 is an extensible command-line tool for ROS 2.~~* Environment: production~~optional arguments~~WARNING:This is a development server. Do not use it in a production deployment.~~-h, --help show this help message and exit~~Use a production WSGI server instead.~~Commands~~* Debug mode:on~~action Various action related sub-commands~~* Running on all addresses (0.0.0.0)~~bag Various rosbag related sub-commands~~WARNING: This is a development server. Do not use it in a production deployment.~~component Various component related sub-commands~~* Running on http://127.0.0.1:5001~~daemon Various daemon related sub-commands~~* Running on http://192.168.1.79:5001 (Press CTRL+C to quit)~~doctor Check ROS setup and other potential issues~~* Restarting with stat~~interface Show information about ROS interfaces~~* Debugger is active!~~launch Run a launch file~~* Debugger PIN: 500-161-390~~lifecycle Various lifecycle related sub-commands~~|}</pli><pli>~~multicast Various multicast related sub-commands~~~~node Various node related sub-commands~~然后另外打开一个终端，再运行下面的命令就可以返回图片识别的结果（注意，下面的命令执行路径为'''face_recognition/examples'''）~~param Various param related sub~~{| class="wikitable" style="width:800px;" |-~~commands~~| ~~pkg Various package related sub~~orangepi@orangepi:~/face_recognition/examples$ '''curl -~~commands~~XPOST -F \'''~~run Run a package specific executable~~'''"file=@obama2.jpg" http://127.0.0.1:5001'''~~security Various security related sub-commands~~'''{''':~~service Various service related sub-commands~~'''"face_found_in_image": true,''':~~topic Various topic related sub-commands~~'''"is_picture_of_obama": true'''~~wtf Use `wtf` as alias to `doctor`~~'''}'''~~Call `ros2 <command> -h` for more detailed usage.~~|}</li><li>~~然后可以使用~~ 我们也可以将'''~~test_ros~~face_recognition/examples/obama2.jpg'''这张图片拷贝到其他的Linux电脑中，当然也可以自己准备一张名为'''obama2.shjpg'''的图片，然后在Linux电脑中可以使用下面的命令远程通过开发板运行的服务来识别人脸（'~~脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行~~''注意命令中的IP地址需要替换为开发板的IP地址，file后的文件名需要替换为想要测试的图片的名字'''）{| class="wikitable" style="width:800px;" |-| ~~orangepi~~test@~~orangepi~~test:~$ '''~~test_ros~~curl -XPOST -F "file=@obama2.shjpg" http://192.168.1.79:5001'''~~[INFO] [1671174101.200091527] [talker]~~'''{''': ~~Publishing~~'''"face_found_in_image": true,''~~Hello World: 1~~':~~[INFO] [1671174101.235661048] [listener]~~'''"is_picture_of_obama": ~~I heard: [Hello World: 1]~~true'''~~[INFO] [1671174102.199572327] [talker]: Publishing:~~ '~~Hello World: 2~~''}'''|}</li><li>~~[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2]~~使用浏览器测试的方法如下所示：<ol style="list-style-type: none;"><li>~~[INFO] [1671174103.199580322] [talker]: Publishing~~a) 首先打开浏览器，然后在浏览器的地址栏输入'''开发板的IP地址: 5001''~~Hello World: 3~~'，然后就能看到下面的页面[~~INFO]~~ [~~1671174103~~File:zero3-img206.~~204019965] [listener~~png]~~: I heard: [Hello World: 3~~]</li><li>~~运行下面的命令可以打开rviz2~~b) 然后将obama2.jpg复制到桌面{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~/face_recognition/examples$ '''~~source~~ cp obama2.jpg /~~opt~~home/~~ros~~orangepi/~~galactic~~Desktop/~~setup.bash~~'''|}</li><li>~~orangepi@orangepi~~c) 然后在浏览器中选择刚才复制的图片[[File:~$ zero3-img207.png]]</li><li>d) 然后点击'''~~ros2 run rviz2 rviz2~~Upload'''上传刚才选择的图片进行人脸识别[[File:~~media/image277~~zero3-img208.png~~|576x324px~~]]</li><li>~~ROS的使用方法请参考下ROS 2的文档~~e) 等待一段时间后就会显示检测的结果[~~http~~[File:zero3-img209.png]]</~~docs.ros.org~~li></ol></enli></~~galactic~~ol></~~Tutorials.html~~ li><li>'''face_detection'''~~http~~命令测试示例<ol style="list-style-type:lower-alpha;"><li>face_detection命令行工具可以在单张图片或一个图片文件夹中定位人脸位置（输出像素点坐标）。使用'''face_detection --help'''可以查看下face_detection命令的帮助信息</~~/docs.ros.org/en/galactic/Tutorials.html~~p>{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''face_detection --help''']<~~/li~~p>Usage: face_detection [OPTIONS] IMAGE_TO_CHECK</olp>

<~~span id="ubuntu22.04安装ros-2-humble的方法"~~p>Options:</~~span~~p>~~=== Ubuntu22~~:--cpus INTEGER number of CPU cores to use in parallel.~~04安装ROS 2 Humble的方法 ===~~-1 means "use all in system"

~~<ol style="list-style-type: decimal;">~~

~~<li>使用'''install_ros.sh'''脚本可以安装ros2~~

~~orangepi@orangepi:~$ '''install_ros.sh ros2'''</li>~~

~~<li>'''install_ros.sh'''脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成~~

~~usage: ros2 [-h] Call `ros2 <command> -h` for more detailed usage. ...~~

~~ros2 is an extensible command-line tool for ROS 2.~~

~~optional arguments:~~

~~-h, --help show this help message and exit~~

~~Commands:~~

~~action Various action related sub-commands~~

~~bag Various rosbag related sub-commands~~

~~component Various component related sub-commands~~

~~daemon Various daemon related sub-commands~~

~~doctor Check ROS setup and other potential issues~~

~~interface Show information about ROS interfaces~~

~~launch Run a launch file~~

~~lifecycle Various lifecycle related sub-commands~~

~~multicast Various multicast related sub-commands~~

~~node Various node related sub-commands~~

~~param Various param related sub-commands~~

~~pkg Various package related sub-commands~~

~~run Run a package specific executable~~

~~security Various security related sub-commands~~

~~service Various service related sub-commands~~

~~topic Various topic related sub-commands~~

~~wtf Use `wtf` as alias to `doctor`~~

~~Call `ros2 <command> -h` for more detailed usage.</li>~~

~~<li>然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行~~

~~orangepi@orangepi:~$ '''test_ros.sh'''~~

~~[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'~~

~~[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1]~~

~~[INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'~~

~~[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2]~~

~~[INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'~~

~~[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</li>~~

~~<li>运行下面的命令可以打开rviz2~~

~~orangepi@orangepi:~$ '''source /opt/ros/humble/setup.bash'''~~

~~orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''~~

~~[[File:media/image278.png|575x323px]]</li>~~

~~<li>参考文档~~

~~'''http://docs.ros.org/en/humble/index.html'''~~

~~[http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html''']</li></ol>~~

~~== 安装内核头文件的方法 ==~~:--model TEXT Which face detection model to use. Options are "hog" or "cnn".

~~'''Linux6.1内核的Debian11系统编译内核模块时会报GCC的错误。所以如果要编译内核模块请使用Debian12或者Ubuntu22.04。'''~~

:--help Show this message and exit.|}</li><ol li>检测单张图片的示例如下所示：{| class="wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>~~|-| ~~OPi发布的Linux镜像默认自带了内核头文件的deb包，存放的位置为~~orangepi@orangepi:~$ '''cd face_recognition/~~opt/~~examples'''orangepi@orangepi:~/face_recognition/examples$ '''ls /opt/linux-headers*face_detection obama2.jpg'''~~/opt/linux-headers-xxx-sun50iw9_x~~obama2.~~x.x_arm64.deb~~jpg,302,474,611,164|}</li><li>~~使用下面的命令可以安装内核头文件的deb包~~使用多核并行检测多张图片的示例如下所示：<ol style="list-style-type: none;"><li>~~orangepi@orangepi:~$~~ a) 首先进入'''~~sudo dpkg -i /opt~~face_recognition/~~linux-headers*.deb~~examples'''文件夹</li><li>~~安装完后在'''/usr/src'''下就能看到内核头文件所在的文件夹~~b) 然后新建一个test文件夹<p/li>~~orangepi@orangepi:~$ '''ls /usr/src'''~~</pli>~~linux-headers-x.x.x~~c) 然后将jpg图片都拷贝到test文件夹中</li><li>~~然后可以编译下Linux镜像中自带的hello内核模块的源码，hello模块的源码在~~d) 然后使用所有的cpu并行运行'''~~/usr/src/hello~~face_detection'''来检查test文件夹中的图片，其中'''--cpus -1'''~~中，进入此目录后，然后使用make命令编译即可。~~表示使用所有的cpu{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''cd face_recognition/~~usr/src/hello/~~examples'''orangepi@orangepi:~/~~usr/src~~face_recognition/~~hello~~examples$ '''~~sudo make~~mkdir test'''~~make -C~~ orangepi@orangepi:~/~~lib~~face_recognition/~~modules/5~~examples$ '''cp *.~~4.125/build M=/usr/src/hello modules~~jpg test'''~~make[1]~~orangepi@orangepi: ~~Entering directory '~~~/~~usr~~face_recognition/~~src/linux~~examples$ '''face_detection --~~headers~~cpus -~~5.4.125~~1 test'''~~CC [M]~~ test/~~usr~~obama-240p.jpg,29,261,101,189</~~src~~p>test/~~hello/hello~~obama_small.ojpg,65,215,169,112~~Building modules~~test/obama2.jpg, ~~stage 2.~~302,474,611,164~~MODPOST 1 modules~~test/two_people.jpg,62,394,211,244~~CC [M]~~ test/~~usr/src/hello/hello~~two_people.~~mod.o~~jpg,95,941,244,792~~LD [M]~~ test/~~usr/src/hello/hello~~obama.kojpg,136,624,394,366~~make[1]: Leaving directory '~~test/~~usr/src/linux-headers~~obama-5480p.~~4.125'~~jpg,65,507,189,383</p~~></li~~>~~<li>~~~~编译完后会生成'''hello~~test/obama-720p.~~ko'''内核模块~~jpg,94,751,273,572~~orangepi@orangepi:~~test/usr/src/hello$ '''ls *obama-1080p.~~ko'''~~jpg,136,1140,394,882~~hello~~test/biden.kojpg,233,749,542,439|}</li></ol></li><p/ol>~~使用'''insmod'''命令可以将'''hello.ko'''内核模块插入内核中~~</pli><li>~~orangepi@orangepi:/usr/src/hello$~~ '''~~sudo insmod hello.ko~~face_recognition'''命令测试示例<~~/li~~ol style="list-style-type: lower-alpha;"><li>~~然后使用~~'''~~demsg~~face_recognition'''~~命令可以查看下~~命令行工具可以在单张图片或者一个图片文件夹中认出是谁的脸。使用'''~~hello.ko'''内核模块的输出，如果能看到下面的输出说明'''hello.ko~~face_recognition --help'''~~内核模块加载正确~~可以查看下face_recognition命令的帮助信息{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~~/usr/src/hello~~~$ '''~~dmesg | grep "Hello"~~face_recognition --help'''Usage: face_recognition [ ~~2871.893988~~OPTIONS] ~~'''Hello Orange Pi -- init'''~~KNOWN_PEOPLE_FOLDER IMAGE_TO_CHECK</p~~></li~~>~~<li>~~~~使用'''rmmod'''命令可以卸载'''hello.ko'''内核模块~~Options:~~orangepi@orangepi~~:~~/usr/src/hello$ '''sudo rmmod hello'''~~~~orangepi@orangepi:/usr/src/hello$ '''dmesg | grep~~ --cpus INTEGER            number of CPU cores to use in parallel (can speed up processing lots of images). -1 means "~~Hello~~use all in system"~~'''~~ :~~[ 2871.893988] Hello Orange Pi~~ -- ~~init~~tolerance FLOAT          Tolerance for face comparisons. Default is 0.6. Lower this if you get multiple matches for the same person.~~[ 3173.800892] '''Hello Orange Pi -- exit'''</li></ol>~~

:<~~span id="linux系统支持的部分编程语言测试"~~p>--show-distance BOOLEAN    Output face distance. Useful for tweaking tolerance setting.</~~span~~p>~~== Linux系统支持的部分编程语言测试 ==~~

~~~~

~~=== Debian Bullseye系统 ===~~

:<~~ol style="list~~p>-~~style~~-~~type: decimal~~help                 "Show this message and exit.|}</li><li>~~Debian Bullseye默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序~~首先新建一个已知名字的人脸图片文件夹'''known_people'''，然后复制两张图片到'''known_people'''中，然后将'''obama2.jpg'''复制为'''unkown.jpg'''，也就是我们要识别的图片~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>gcc的版本如下所示~~|-| orangepi@orangepi:~$ '''~~gcc --version~~cd face_recognition/examples'''~~gcc (Debian 10.2.1-6) 10.2.1 20210110<~~orangepi@orangepi:~/p>~~Copyright (C) 2020 Free Software Foundation, Inc.<~~face_recognition/p>~~This is free software; see the source for copying conditions. There is NO~~examples$ '''mkdir known_people'''~~warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.<~~orangepi@orangepi:~/~~p><~~face_recognition/~~li><li>编写C语言的~~examples$ '''~~hello_world~~cp biden.jpg obama.cjpg known_people'''程序orangepi@orangepi:~/face_recognition/examples$ '''~~vim hello_world~~cp obama2.jpg unkown.cjpg'''~~#include <stdio.h>int main(void){printf("Hello World!\n");~~|}~~return 0;}~~</li><li>~~然后编译运行~~然后就可以使用下面的命令识别下'''~~hello_world~~unkown.cjpg'''图片中人物的名字，可以看到识别到unkown.jpg图片为obama{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~/face_recognition/examples$ '''~~gcc -o hello_world hello_world.c~~face_recognition known_people \'''~~orangepi@orangepi:~$~~ '''unkown.~~/hello_world~~jpg'''~~Hello World!~~unkown.jpg,obama~~</li></ol>~~|}

</li>

<li>~~Debian Bullseye默认安装有Python3~~如果我们识别一张不相关的图片，就会显示unknown_person~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>Python具体版本如下所示~~|-| ~~orangepi~~root@orangepi:~~~$ '''python3'''<~~/p>~~'''Python 3.9.2''' (default, Feb 28 2021, 17:03:44)[GCC 10.2.1 20210110] on linuxType "help", "copyright", "credits" or "license" for more information.>>><~~face_recognition/p>~~'''使用Ctrl+D快捷键可退出python的交互模式。'''</li><li>编写Python语言的'''hello_world.py'''程序orangepi@orangepi:~~~examples$ '''~~vim hello_world.py''~~face_recognition known_people \'~~print(~~'~~Hello World!~~')</p~~></li~~>~~<li>~~运行'''~~hello_world~~alex-lacamoire.pypng'''~~的结果如下所示~~~~orangepi@orangepi:~$ '''python3 hello_world~~alex-lacamoire.~~py'''~~png,unknown_person~~Hello World!</li></ol>~~|}

</li>

<li>~~Debian Bullseye默认没有安装Java的编译工具和运行环境~~我们还可以新建一个test文件夹，然后在其中放入多张图片，然后就可以使用所有的CPU来并行识别所有的图片~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>可以使用下面的命令安装openjdk，Debian > Bullseye中最新版本为openjdk~~|-~~17~~| orangepi@orangepi:~/face_recognition/examples$ '''~~sudo apt install -y openjdk-17-jdk~~mkdir test'''</p~~></li~~>~~<li>~~~~安装完后可以查看下Java的版本~~orangepi@orangepi:~/face_recognition/examples$ '''cp *.jpg *.png test'''orangepi@orangepi:~/face_recognition/examples$ '''~~java~~ face_recognition --~~version~~cpus -1 \'''</p~~></li~~>~~<li>~~~~编写Java版本的~~'''~~hello_world.java~~known_people test'''~~orangepi@orangepi:~$ '''vim hello_world~~test/obama-240p.~~java'''~~jpg,obama~~public class hello_world~~test/alex-lacamoire.png,unknown_person{test/obama_small.jpg,obama~~public static void main(String[] args)~~test/unkown.jpg,obama{test/obama2.jpg,obama~~System~~test/lin-manuel-miranda.~~out.println("Hello World!");~~png,unknown_person}test/two_people.jpg,biden}test/two_people.jpg,obamatest/obama-720p.jpg,obama</lip>~~<li>~~~~然后编译运行'''hello_world~~test/obama.~~java'''~~jpg,obama~~orangepi@orangepi:~$ '''javac hello_world~~test/obama-480p.~~java'''~~jpg,obama~~orangepi@orangepi:~$ '''java hello_world'''~~test/biden.jpg,biden~~Hello World!~~test/obama-1080p.jpg,obama|}</li></ol>

</li></ol>

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

<li>~~Debian Bookworm默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序~~首先设置默认'''locale'''为中文

<li>~~gcc的版本如下所示~~输入下面的命令可以开始配置'''locale'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~gcc~~ sudo dpkg-~~-version~~reconfigure locales'''~~gcc (Debian 12.2.0-14) 12.2.0Copyright (C) 2022 Free Software Foundation, Inc.~~|}~~This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.~~</li><li>~~编写C语言的~~然后在弹出的界面中选择'''~~hello_world~~zh_CN.~~c'''程序orangepi@orangepi:~$~~ UTF-8 > UTF-8'''~~vim hello_world.c~~（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''~~#include~~ <~~stdio.h~~OK>'''，然后回车即可）~~int main(void)~~[[File:zero3-img210.png|1400px]]~~{~~</pli><pli>~~printf("Hello World!\n");~~~~return 0;~~然后设置默认'''locale'''为'''zh_CN.UTF-8'''}[[File:zero3-img211.png|1400px]]</li><li>~~然后编译运行~~退出界面后就会开始'''~~hello_world.c~~locale'''的设置，命令行显示的输出如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~gcc~~ sudo dpkg-~~o hello_world hello_world.c~~reconfigure locales'''~~orangepi@orangepi~~Generating locales (this might take a while)...:~~~$ '''~~en_US.UTF-8...done</~~hello_world'''~~p>:zh_CN.UTF-8... done~~Hello World!~~Generation complete.|}</li></ol>

</li>

<li>~~Debian Bookworm默认安装有Python3~~然后打开'''Input Method'''<~~ol style="list~~p>[[File:zero3-~~style~~img212.png]]</li><li>然后选择'''OK'''[[File:zero3-~~type~~img213.png]]</li><li>然后选择'''Yes'''[[File: ~~lower~~zero3-~~alpha;"~~img214.png]]</li><li>~~Python具体版本如下所示~~然后选择'''fcitx'''~~orangepi@orangepi~~[[File:~$ zero3-img215.png]]</li><li>然后选择'''~~python3~~OK'''~~Python 3~~[[File:zero3-img216.~~11.2 (main, Mar 13 2023, 12~~png]]</li><li>'''然后重启Linux系统才能使配置生效'''</li><li>然后打开'''Fcitx configuration'''[[File:~~29) [GCC 12~~zero3-img217.~~2.0~~png]] ~~on linux~~</li><li>~~Type "help", "copyright", "credits" or "license" for more information.~~然后点击下图所示位置的'''+'''号~~>>>~~[[File:zero3-img218.png]]</li><li>然后搜索'''Google Pinyin'~~使用Ctrl+D快捷键可退出python的交互模式。~~''再点击'''OK'''[[File:zero3-img219.png]]</li><li>~~编写Python语言的~~然后将'''~~hello_world.py~~Google Pinyin'''程序放到最前面~~orangepi@orangepi~~[[File:zero3-img220.png]][[File:~$ zero3-img221.png]]</li><li>然后打开'''~~vim hello_world.py~~Geany'''这个编辑器测试下中文输入法[[File:zero3-img222.png]]</li><li>中文输入法测试如下所示~~print(~~[[File:zero3-img223.png]]</li><li>通过'~~Hello World!~~')'Ctrl+Space'''快捷键可以切换中英文输入法</li><li>运行如果需要整个系统都显示为中文，可以将'''~~hello_world~~/etc/default/locale'''中的变量都设置为'''zh_CN.pyUTF-8'''~~的结果如下所示~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3 hello_world~~sudo vim /etc/default/locale'''# File generated by update-localeLC_MESSAGES='''zh_CN.pyUTF-8'''~~Hello World!~~LANG='''zh_CN.UTF-8'''LANGUAGE='''zh_CN.UTF-8</lispan>'''</olp>|}

</li>

<li>~~Debian Bookworm默认没有安装Java的编译工具和运行环境<ol style="list-style-type: lower-alpha;"><li>可以使用下面的命令安装openjdk，Debian > Bookworm中最新版本为openjdk-17orangepi@orangepi:~$~~ 然后'''~~sudo apt install -y openjdk-17-jdk~~重启系统'''就能看到系统显示为中文了</p~~></li~~>~~<li>~~~~安装完后可以查看下Java的版本orangepi@orangepi~~[[File:~~~$ '''java~~ zero3-~~-version'''</li><li>编写Java版本的'''hello_world~~img224.~~java'''orangepi@orangepi:~$ '''vim hello_world.java'''public class hello_world{public static void main(String[~~png]] ~~args)~~~~{~~</pli>~~System.out.println("Hello World!");~~</pol>~~}~~<~~p>}</li><li>然后编译运行'''hello_world~~span id="ubuntu-20.~~java'''orangepi@orangepi:~$ '''javac hello_world.java'''orangepi@orangepi:~$ '''java hello_world'''Hello World!</li></ol~~04系统的安装方法"></~~li></ol~~span>

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

<li>~~Ubuntu Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type: lower-alpha;"><li>gcc的版本如下所示orangepi@orangepi:~$~~ 首先打开'''~~gcc --version~~Language Support'''~~gcc (Ubuntu 9.4.0~~[[File:zero3-~~1ubuntu1~20.04.1) 9.4.0Copyright (C) 2019 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE~~img225.png]]</li><li>~~编写C语言的~~然后找到'''~~hello_world.c~~汉语（中国）'''程序选项~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero3-img226.~~c'''#include <stdio.h>int main(void){printf("Hello World!\n");return 0;}~~png]]</li><li>~~然后编译运行~~然后请使用鼠标左键选中'''~~hello_world.c~~汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：~~orangepi@orangepi~~[[File:~~~$ '''gcc~~ zero3-~~o hello_world hello_world~~img227.~~c'''~~png]]</li> {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <pbig>~~orangepi@orangepi:~$~~ '''~~./hello_world~~注意，这一步不是很好拖动的，请耐心多试几次。'''</pbig>~~Hello World!</li>~~|}</ol>~~</li><li>Ubuntu Focal默认安装有Python3</p~~><ol start="4" style="list-style-type: ~~lower-alpha~~decimal;"><li>~~Python3具体版本如下所示orangepi@orangepi:~$~~ 然后选择'''~~python3~~Apply System-Wide'''将中文设置应用到整个系统~~Python 3.8.10 (default, Nov 14 2022, 12~~[[File:~~59:47)[GCC 9~~zero3-img228.~~4.0~~png]] ~~on linux~~~~Type "help", "copyright", "credits" or "license" for more information.~~</pli><pli>~~>>>~~然后设置'''~~使用Ctrl+D快捷键可退出python的交互模式。~~Keyboard input method system'''~~</li><li>编写Python语言的~~为'''~~hello_world.py~~fcitx'''程序~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero3-img229.~~py'''print('Hello World!')~~png]]</li><li>~~运行'''hello_world.py'''的结果如下所示orangepi@orangepi:~$ '''python3 hello_world.py~~'''<~~/p>Hello World!</li></ol></li><li>Ubuntu Focal默认没有安装Java的编译工具和运行环境<ol~~ span style="~~list-style-type~~color: ~~lower-alpha;~~#FF0000">~~<li>可以使用下面的命令安装openjdk-17~~然后重启Linux系统使配置生效</pspan>~~orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdk~~'''</li><li>~~安装完后可以查看下Java的版本orangepi@orangepi:~$~~ 重新进入系统后，在下面的界面请选择'''~~java --version~~不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文~~openjdk 17~~[[File:zero3-img230.~~0.2 2022-01-18~~png]]</li><li>~~OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.04)~~然后可以看到桌面都显示为中文了~~OpenJDK 64~~[[File:zero3-~~Bit Server VM (build 17~~img231.~~0.2+8-Ubuntu-120.04, mixed mode, sharing)~~png]]</li><li>~~编写Java版本的~~然后我们可以打开'''~~hello_world.java~~Geany'''测试下中文输入法，打开方式如下图所示~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero3-img232.~~java'''public class hello_world{public static void main(String[~~png]] ~~args){System.out.println("Hello World!");}}~~</li><li>~~然后编译运行~~打开'''~~hello_world.java~~Geany'''~~orangepi@orangepi:~$~~ 后，默认还是英文输入法，我们可以通过'''~~javac hello_world.java~~Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了~~orangepi@orangepi~~[[File:~~~$ '''java hello_world'''Hello World!~~zero3-img233.png]]</li></ol> <~~/li~~span id="ubuntu-22.04系统的安装方法"></olspan>

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

<li>~~Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type: lower-alpha;"><li>gcc的版本如下所示orangepi@orangepi:~$~~ 首先打开'''~~gcc --version~~Language Support'''~~gcc (Ubuntu 11.3.0~~[[File:zero3-~~1ubuntu1~22.04.1) '''11.3.0'''Copyright (C) 2021 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE~~img225.png]]</li><li>~~编写C语言的~~然后找到'''~~hello_world.c~~汉语（中国）'''程序选项~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero3-img234.~~c'''#include <stdio.h>int main(void){printf("Hello World!\n");return 0;}~~png]]</li><li>~~然后编译运行~~然后请使用鼠标左键选中'''~~hello_world.c~~汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：~~orangepi@orangepi~~[[File:~~~$ '''gcc~~ zero3-~~o hello_world hello_world~~img235.~~c'''~~png]]</li> {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <pbig>~~orangepi@orangepi:~$~~ '''~~./hello_world~~注意，这一步不是很好拖动的，请耐心多试几次。'''</pbig>~~Hello World!</li>~~|}</ol>~~</li><li>Ubuntu Jammy默认安装有Python3</p~~><ol start="4" style="list-style-type: ~~lower-alpha~~decimal;"><li>~~Python3具体版本如下所示orangepi@orangepi:~$~~ 然后选择'''~~python3~~Apply System-Wide'''将中文设置应用到整个系统~~Python 3.10.6 (main, May 29 2023, 11~~[[File:~~10:38) [GCC 11~~zero3-img236.~~3.0~~png]] ~~on linux~~~~Type "help", "copyright", "credits" or "license" for more information.~~</pli><pli>~~>>>~~'''~~使用Ctrl+D快捷键可退出python的交互模式。~~然后重启Linux系统使配置生效'''</li><li>~~编写Python语言的~~重新进入系统后，在下面的界面请选择'''~~hello_world.py~~不要再次询问我'''程序，然后请根据自己的喜好决定标准文件夹是否也要更新为中文~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero3-img230.~~py'''print('Hello World!')~~png]]</li><li>~~运行'''hello_world.py'''的结果如下所示~~然后可以看到桌面都显示为中文了~~orangepi@orangepi~~[[File:~~~$ '''python3 hello_world~~zero3-img231.~~py'''Hello World!~~png]]</li~~></ol></li><li>Ubuntu Jammy默认没有安装Java的编译工具和运行环境<ol style="list-style-type: lower-alpha;"~~><li>~~可以使用下面的命令安装openjdk-18~~然后打开Fcitx5配置程序~~orangepi@orangepi~~[[File:~~~$ '''sudo apt install~~ zero3-~~y openjdk-18-jdk'''~~img237.png]]</li><li>~~安装完后可以查看下Java的版本~~然后选择使用拼音输入法~~orangepi@orangepi~~[[File:~~~$ '''java~~ zero3-~~-version'''~~img238.png]]<p/li>~~openjdk 18.0.2-ea 2022-07-19~~</pli>~~OpenJDK Runtime Environment (build 18.0.2-ea+9-Ubuntu-222.04)~~选择后的界面如下所示，再点击确定即可~~OpenJDK 64~~[[File:zero3-~~Bit Server VM (build 18~~img239.~~0.2-ea+9-Ubuntu-222.04, mixed mode, sharing)~~png]]</li><li>~~编写Java版本的~~然后我们可以打开'''~~hello_world.java~~Geany'''测试下中文输入法，打开方式如下图所示~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero3-img232.~~java'''public class hello_world{public static void main(String[~~png]] ~~args){System.out.println("Hello World!");}}~~</li><li>~~然后编译运行~~打开'''~~hello_world.java~~Geany'''~~orangepi@orangepi:~$~~ 后，默认还是英文输入法，我们可以通过'''~~javac hello_world.java~~Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了~~orangepi@orangepi~~[[File:~~~$ '''java hello_world'''~~zero3-img240.png]]~~Hello World!</li></ol>~~</li></ol>

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

~~=== 在Ubuntu PC中上传文件到开发板Linux系统中的方法~~ =远程登录Linux系统桌面的方法 ==

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

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

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

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

<li>~~首先在Ubuntu PC中安装filezilla~~首先下载NoMachine软件Linux '''</pspan style="color:#FF0000">arm64<p/span>~~test@test:~$ '''sudo apt install -y filezilla~~'''deb版本的安装包，然后安装到开发板的Linux系统中<~~/li~~ol style="list-style-type: lower-alpha;"><li>~~然后使用下面的命令打开filezillatest@test:~$~~ 由于H618是ARMv8架构的SOC，我们使用的系统为Ubuntu或者Debian，所以这里需要下载'''~~filezilla~~NoMachine > for ARM ARMv8 DEB'''~~</li><li>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的<div class="figure">~~安装包，下载链接如下所示：

~~[[File~~{| class="wikitable" style="background-color:#ffffdc;width:~~media~~800px;" |-| <big>'''注意，这个下载链接可能会变，请认准Armv8/Arm64版本的deb包。'''</~~image279.png~~big>|~~576x453px|截图 2022-12-03 19-04-40]]~~}

<{| class="wikitable" style="width:800px;" |-| [https://www.nomachine.com/download/~~div><~~download&id=112&s=ARM '''https:/~~li><li>连接开发板的方法如下图所示<~~/~~p><~~downloads.nomachine.com/~~li><~~download/~~ol>~~?id=118&distro=ARM''']|}

~~<div class="figure">~~ [[File:~~media/image280~~zero3-img241.png~~|577x128px|IMG_256~~]] </~~div~~li></ol><ol start="52" style="list-style-type: ~~decimal~~lower-alpha;"><li>~~然后选择~~另外在'''~~保存密码~~官方工具'''~~，再点击~~中也可以下载到'''NoMachine'''的安装包[[File:zero3-img242.png]]先进入'''确定远程登录软件-NoMachine'''文件夹[[File:~~media~~zero3-img243.png]]</~~image281~~p>然后下载arm64版本的deb安装包[[File:zero3-img244.png~~|249x181px~~]]</li><li>~~然后选择~~然后将下载的'''~~总是信任该主机~~nomachine_x.x.x_x_arm64.deb'''~~，再点击~~上传到开发板的Linux系统中</li><li>然后使用下面的命令在开发板的Linux系统中安装'''确定NoMachine'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo dpkg -i nomachine_x.x.x_x_arm64_arm64.deb'''|}</li></ol></li></ol><ol start="2" style="list-style-type: decimal;"><li>然后下载NoMachine软件Windows版本的安装包，下载地址如下所示</li>

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

~~[[File~~{| class="wikitable" style="width:800px;" |-| '''https:~~media~~/~~image282~~/downloads.~~png|278x150px~~nomachine.com/download/?id=9'''|~~IMG_256]]~~}

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

<~~div class~~span id="~~figure~~使用vnc远程登录">

~~[[File:media/image283.png|533x330px|IMG_256]]~~=== 使用VNC远程登录 ===

~~</div><ol start~~{| class="8wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~decimal~~800px;">|-| <li>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Ubuntu PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了。</li></olbig>'''操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''

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

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

~~</div>~~

~~<ol start="9" style="list-style-type: decimal;">~~

~~<li>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</li>~~

~~<li>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</li></ol>~~

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

~~~~

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

~~# 首先下载filezilla软件Windows版本的安装文件，下载链接如下所示~~New 'X' desktop is orangepi:1

~~[https://filezilla-project.org/download.php?type=client '''https://filezilla-project.org/download.php?type=client'''][[File:media/image285.png|472x171px|IMG_256]]~~

~~[[File~~Creating default startup script /root/.vnc/xstartupStarting applications specified in /root/.vnc/xstartupLog file is /root/.vnc/orangepi:~~media~~1.log</~~image286.png|384x276px]]~~p>

~~<ol start="2" style="list-style-type: decimal;">~~

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

~~'''FileZilla_Server_1.5.1_win64-setup.exe'''</li></ol>~~

~~安装过程中，下面的安装界面请选择'''Decline'''，然后再选择'''Next>'''~~Killing Xtightvnc process ID 3047

~~<div class="figure">~~

~~[[File~~New 'X' desktop is orangepi:~~media~~1</~~image287.png|355x279px|IMG_256]]~~p>

~~</div>~~

~~<ol start="3" style="list-style-type: decimal;">~~

~~<li>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的</li></ol>~~

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

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

[[File:zero3-img253.png]]</~~div>~~<ol ~~start="4" style="list-style-type: decimal;"~~></li>~~连接开发板的方法如下图所示：~~</liol></olspan>

~~<div class~~=~~"figure">~~= QT的安装方法 ==

~~[[File~~<ol style="list-style-type:~~media~~decimal;"><li>使用下面的脚本可以安装QT5和QT Creator</~~image289~~p>{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''install_qt.~~png|522x108px~~sh'''|~~IMG_256]]~~}</li><li>安装完后会自动打印QT的版本号</~~div~~p><ol ~~start="5"~~ style="list-style-type: ~~decimal~~lower-alpha;"><li>~~然后选择~~Ubuntu20.04自带的qt版本为'''~~保存密码~~5.12.8'''~~，再点击~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''确定install_qt.sh'''</lip>......</olp>QMake version 3.1<~~div class~~p>Using Qt version '''5.12.8''' in /usr/lib/aarch64-linux-gnu|}~~[[File:media~~</~~image290~~li><li>Ubuntu22.~~png|207x146px|IMG_256]]~~ 04自带的QT版本为'''5.15.3'''</~~div~~p>~~<ol start~~{| class="6wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">|-| <lip>~~然后选择~~orangepi@orangepi:~$ '''~~总是信任该主机~~install_qt.sh'''~~，再点击~~......QMake version 3.1Using Qt version '''确定5.15.3'''in /usr/lib/aarch64-linux-gnu|}</li><li>Debian11自带的QT版本为'''5.15.2'''</olp> ~~<div~~ {| class="~~figure~~wikitable" style="width:800px;">|-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''install_qt.sh'''</~~image291~~p>.~~png|221x109px|IMG_256]]~~.....QMake version 3.1</~~div~~p><~~ol start~~p>Using Qt version '''5.15.2''' in /usr/lib/aarch64-~~style~~linux-~~type: decimal;"~~gnu|}</li>~~连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了~~</li>Debian12自带的QT版本为'''5.15.8'''</olp> ~~<div~~ {| class="~~figure~~wikitable" style="width:800px;">|-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''install_qt.sh'''</~~image292~~p>.~~png|449x332px|IMG_256]]~~.....QMake version 3.1</~~div~~p><~~ol start="8"~~ p>Using Qt version '''5.15.8''' in /usr/lib/aarch64-linux-gnu<li/p>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Windows PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了|}</li></ol></li><~~div class="figure"~~li>然后在'''Applications'''中就可以看到QT Creator的启动图标 [[File:~~media/image293~~zero3-img254.png~~|461x340px|IMG_256~~]] 也可以使用下面的命令打开QT Creator</~~div~~p>~~<ol start~~{| class="9wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>~~|-| ~~上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了~~orangepi@orangepi:~$ '''qtcreator'''|}</li><li>~~上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了~~QT Creator打开后的界面如下所示[[File:zero3-img255.png]]</li><li>QT Creator的版本如下所示</olp> ~~== 开关机logo使用说明 ==~~ <ol style="list-style-type: ~~decimal~~lower-alpha;"><li>~~开关机logo默认只在桌面版的系统中才会显示~~QT Creator在'''Ubuntu20.04'''中的默认版本如下所示[[File:zero3-img256.png]]</li><li>在QT Creator在'''~~/boot/orangepiEnv~~Ubuntu22.~~txt'''中设置'''bootlogo'~~04''~~变量为~~'~~''false'''可以关闭开关机logo~~中的默认版本如下所示~~orangepi@orangepi~~[[File:~$ zero3-img257.png]]</li><li>QT Creator在'''~~sudo vim /boot/orangepiEnv.txt~~Debian11'''中的默认版本如下所示~~verbosity=1~~[[File:zero3-img258.png]]</li><li>QT Creator在'''~~bootlogo=false~~Debian12'''中的默认版本如下所示[[File:zero3-img259.png]]</li></ol></li><li>~~在'''~~然后设置下QT</~~boot/orangepiEnv.txt~~p><ol style="list-style-type: lower-alpha;"><li>首先打开'''~~中设置~~Help'''~~bootlogo~~->'''~~变量为~~About Plugins...'''~~true'''可以开启开关机logo~~~~orangepi@orangepi~~[[File:~$ zero3-img260.png]]</li><li>然后去掉'''~~sudo vim /boot/orangepiEnv.txt~~ClangCodeModel'''的那个勾~~verbosity=1~~[[File:zero3-img261.png]]</li><li>'''~~bootlogo~~设置完后需要重启下QT Creator'''</li><li>~~开机logo图片在linux系统中的位置为~~然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''Debian12请跳过这步。'''</~~usr~~p></~~share~~big>|}[[File:zero3-img262.png]]</~~plymouth/themes/orangepi/watermark~~p>[[File:zero3-img263.png~~'''~~]]</li></ol></li><li>~~替换开机logo图片后需要运行下命令才能生效~~然后就可以打开一个示例代码~~orangepi@orangepi~~[[File:~~~$ '''sudo update~~zero3-~~initramfs -u'''~~img264.png]]</li><li>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明</olp> ~~== 关机和重启开发板的方法 ==~~ <~~ol style="list~~p>[[File:zero3-~~style-type: decimal;"~~img265.png]]</li><li>~~在Linux系统运行的过程中，如果直接拔掉电源断电，可能会导致文件系统丢失某些数据，建议断电前先使用~~然后点击下'''~~poweroff~~Configure Project'''~~命令关闭开发板的Linux系统，然后再拔掉电源~~~~orangepi@orangepi~~[[File:zero3-img266.png]]</li><li>然后点击左下角的绿色三角形编译运行下示例代码[[File:~~~$ '''sudo poweroff'''~~zero3-img267.png]]</li><li>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行~~'''注意，关闭开发板后需要重新拔插电源才能开机。'''~~[[File:zero3-img268.png]]</li><li>使用参考资料{| class="wikitable" style="width:800px;" |-| [https://wiki.qt.io/Install_Qt_5_on_Ubuntu '''~~reboot~~https://wiki.qt.io/Install_Qt_5_on_Ubuntu'''~~命令即可重启开发板中的Linux系统~~]~~orangepi@orangepi~~[https:~$ //download.qt.io/archive/qtcreator '''~~sudo~~https://download.qt.io/archive/qtcreator''' ][https://download.qt.io/archive/qt '''~~reboot~~https://download.qt.io/archive/qt''']|}</li></ol> ~~~~ ~~= '''Linux SDK——orangepi-build使用说明''' =~~ ~~== 编译系统需求 ==~~

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

~~test@test:~$ '''lsb_release -a'''~~== ROS安装方法 ==

~~No LSB modules are available~~=== Ubuntu20.04安装ROS 1 Noetic的方法 ===

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

~~Description~~: ~~Ubuntu 22~~:[[File:zero3-img269.~~04 LTS~~png]]

~~Release~~: ~~'''22~~:[[File:zero3-img270.~~04'''~~png]]

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

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

<ol start="2" style="list-style-type: decimal;"><li>ROS 1 '''Noetic Ninjemys'''官方安装文档链接如下所示：{| class="wikitable" style="width:800px;" |-| [~~https~~http://~~repo~~wiki.~~huaweicloud~~ros.~~com~~org/noetic/Installation/Ubuntu '''http:/~~ubuntu-releases~~/21wiki.04ros.org/~~ubuntu-21~~noetic/Installation/Ubuntu''']|}</li><li>ROS '''Noetic Ninjemys'''官方安装文档中Ubuntu推荐使用Ubuntu20.~~04-desktop-amd64~~04，所以请确保开发板使用的系统为'''Ubuntu20.~~iso~~ 04桌面版系统'''~~https~~{| class="wikitable" style="width:800px;" |-| [http://~~mirrors~~wiki.~~tuna~~ros.~~tsinghua~~org/noetic/Installation '''http://wiki.~~edu~~ros.cnorg/~~ubuntu-releases~~noetic/~~22.04~~Installation''']</~~ubuntu~~p>|}[[File:zero3-22img271.04png]]</li><li>然后使用下面的脚本安装ros1{| class="wikitable" style="width:800px;" |-~~desktop-amd64~~| orangepi@orangepi:~$ '''install_ros.~~iso~~sh ros1''']|}</li>在电脑中或者虚拟机中安装完Ubuntu 22.04后，请先设置Ubuntu 22.04的软件源为清华源（或者其它你觉得速度快的国内源），不然后面安装软件的时候很容易由于网络原因而出错。替换清华源的步骤如下所示：<li>使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件</li>

~~<ol~~ {| class="wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~lower-alpha~~800px;">|-| <libig>~~替换清华源的方法参考这个网页的说明即可。~~'''<~~/li~~span style="color:#FF0000">注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。</olspan>'''

~~[https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/ '''https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/''']~~

~~<ol start="2" style="list-style-type: lower-alpha;"><li>注意Ubuntu版本需要切换到22.04。[[File:media/image294.png|576x241px]]</li><li>需要替换的~~'''~~/etc/apt/sources~~install_ros.~~list'''文件的内容为：test@test:~$ '''sudo mv~~ sh脚本会尝试修改/etc/~~apt/sources.list cat /etc/apt/sources.list.bak'''test@test:~$ '''sudo vim /etc/apt/sources.list'''# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse# 预发布软件源，不建议启用# deb https://mirrors~~hosts并自动运行下面的命令。但是这种方法无法保证每次都能正常访问github，如果install_ros.~~tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse</li><li>替换完后需要更新下包信息，并确保没有报错。test@test:~$ '''sudo apt-get update''~~sh安装完ros1后有提示下面的错误，请自己想其它办法让开发板的linux系统能正常访问github，然后再手动运行下面的命令。'~~</li><li>~~''~~'另外，由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。'''</li></ol>~~

~~~~

~~== 获取linux sdk的源码 ==~~

~~=== 从github下载orangepi~~'''https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-~~build ===~~homebrew.yaml'''

linux sdk指的是orangepi-build这套代码，orangepi-build是基于armbian build编译系统修改而来的，使用orangepi-build可以编译出多个版本的linux镜像。使用下面的命令可以下载orangepi-build的代码：'''Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml'''

~~test@test:~$~~ '''~~sudo apt-get update~~ERROR: error loading sources list:'''

~~test@test~~:~$ :'''~~sudo apt-get install -y git~~The read operation timed out'''</big>|}

~~test~~{| class="wikitable" style="width:800px;" |-| orangepi@~~test~~orangepi:~$ '''~~git clone https:~~source /opt/~~github.com~~ros/~~orangepi-xunlong~~noetic/~~orangepi-build~~setup.~~git -b next'''~~ ~~'''注意，使用H618 Soc的开发板是需要下载orangepi-build的next分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。~~bash'''

~~[[File~~orangepi@orangepi:~~media/image295.png|576x288px]]~~~$ '''sudo rosdep init'''

~~'''通过git clone命令下载orangepi~~Wrote /etc/ros/rosdep/sources.list.d/20-build的代码是不需要输入github账号的用户名和密码的（下载本手册中的其他代码也是一样的），如果如输入git clone命令后Ubuntu PC提示需要输入github账号的用户名和密码，一般都是git clone后面的orangepi-build仓库的地址输入错误了，请仔细检查命令拼写是否有错误，而不是以为我们这里忘了提供github账号的用户名和密码。'''default.list

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

~~{| class="wikitable"~~

|-

~~| style="text-align: left;"| '''分支'''~~

~~| style="text-align: left;"| '''u-boot版本'''~~

~~| style="text-align: left;"| '''linux内核版本'''~~

|-

~~| style="text-align: left;"| '''current'''~~

~~| style="text-align: left;"| '''u-boot v2018.05'''~~

~~| style="text-align: left;"| '''linux5.4'''~~

|-

~~| style="text-align: left;"| '''next'''~~

~~| style="text-align: left;"| '''u-boot v2021.07'''~~

~~| style="text-align: left;"| '''linux6.1'''~~

|}

~~'''这里所说的分支和orangepi-build源代码的分支不是同一个东西，请不要搞混了。此分支主要是用来区分不同内核源码版本的。'''~~::rosdep update

orangepi@orangepi:~$ '''~~目前全志提供的linux5.4 bsp内核我们定义为current分支。最新的linux6.1 LTS内核定义为next分支。~~rosdep update'''

~~orangepi-build下载完后会包含下面的文件和文件夹：~~reading in sources list data from /etc/ros/rosdep/sources.list.d

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

~~=== 下载交叉编译工具链 ===~~Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml

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

~~<div class="figure">~~Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml

~~[[File~~Hit https:~~media~~/~~image296~~/raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.~~png|575x278px|选区_396]]~~yaml

<Query rosdistro index https:/~~div>交叉编译工具链在中国境内的镜像网址为清华大学的开源软件镜像站：~~/raw.githubusercontent.com/ros/rosdistro/master/index-v4.yaml

~~[https://mirrors.tuna.tsinghua.edu.cn/armbian~~Skip end-~~releases/_toolchain/ '''https://mirrors.tuna.tsinghua.edu.cn/armbian~~of-~~releases/_toolchain/''']~~life distro "ardent"

~~'''toolchains'''下载完后会包含多个版本的交叉编译工具链：~~Skip end-of-life distro "bouncy"

~~test@test:~/orangepi~~Skip end-~~build$ '''ls toolchains/'''~~of-life distro "crystal"

~~gcc~~Skip end-~~arm~~of-~~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~~life distro "dashing"

~~gcc~~Skip end-~~arm~~of-~~11.2-2022.02-x86_64-arm-none-linux-gnueabihf gcc-linaro-4.9.4-2017.01-x86_64_arm-linux-gnueabi gcc-linaro-aarch64-none-elf-4.8-2013.11_linux~~life distro "eloquent"

~~gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu gcc-linaro-5.5.0-2017.10-x86_64_arm-linux-gnueabihf gcc-linaro-arm-linux-gnueabihf-4.8-2014.04_linux~~Add distro "foxy"

~~gcc-arm-9.2-2019.12-x86_64-arm-none-linux-gnueabihf gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu gcc-linaro-arm-none-eabi-4.8-2014.04_linux~~Add distro "galactic"

~~编译H618 Linux内核源码使用的交叉编译工具链为：~~Skip end-of-life distro "groovy"

~~<ol style="list-style-type: lower-alpha~~Add distro "humble"">~~<li>linux5.4'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''</li><li>linux6.1'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''编译H618 u-boot源码使用的交叉编译工具链为：</li></ol>~~

<!Skip end-of- ~~--><ol style="list-style-type: lower-alpha~~life distro "hydro"">~~<li>v2018.05'''gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabi'''</li><li>v2021.07'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''</li></ol>~~

~~=== orangepi~~Skip end-~~build完整目录结构说明 ===~~of-life distro "indigo"

~~<ol style="list~~Skip end-~~style~~of-~~type: decimal~~life distro "">~~<li>orangepi-build仓库下载完后并不包含linux内核、u-boot的源码以及交叉编译工具链，linux内核和u-boot的源码存放在独立的git仓库中<ol style="list-style-type: lower-alpha;"><li>linux内核源码存放的git仓库如下，注意切换linux-orangepi仓库的分支为<ol style="list-style-type: lower-alpha;"><li>Linux5.4https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-5.4-sun50iw9'''</li><li>Linux6.1https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-6.1-sun50iw9'''</li></ol></li><li>u-boot源码存放的git仓库如下，注意切换u-boot-orangepi仓库的分支为<ol style="list-style-type: lower-alpha~~jade"">~~<li>v2018.05https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2018.05-h618'''</li><li>v2021.07</li></ol></li></ol></li></ol>~~

~~https://github.com/orangepi~~Skip end-~~xunlong/u~~of-~~boot-orangepi/tree/'''v2021.07-sunxi'''~~life distro "kinetic"

~~<ol start="2" style="list~~Skip end-~~style~~of-~~type: decimal;">~~<li>orangepi-build第一次运行的时候会去下载交叉编译工具链、u-boot和linux内核源码，成功编译完一次linux镜像后在orangepi-build中可以看到的文件和文件夹有~~<ol style="list-style-type: lower-alpha;"><li>'''build.sh''': 编译启动脚本</li><li>'''external''':~~ life distro &gtquot; ~~包含编译镜像需要用的配置文件、特定功能的脚本以及部分程序的源码，编译镜像过程中缓存的rootfs压缩包也存放在external中</li><li>'''kernel''': 存放linux内核的源码</li><li>'''LICENSE''': GPL 2许可证文件</li><li>'''README.md''': orangepi-build说明文件</li><li>'''output''':~~ lunar&gtquot; ~~存放编译生成的u-boot、linux等deb包、编译日志以及编译生成的镜像等文件</li><li>'''scripts''': 编译linux镜像的通用脚本</li><li>'''toolchains''': 存放交叉编译工具链</li><li>'''u-boot''': 存放u-boot的源码</li><li>'''userpatches''': 存放编译脚本需要用到的配置文件test@test:~/orangepi-build$ '''ls''''''build.sh external kernel LICENSE output README.md scripts toolchains u-boot userpatches'''</li></ol></li></ol>~~

~~== 编译u-boot ==~~Add distro "melodic"

~~<ol style="list-style-type: decimal~~Add distro "noetic"">~~<li>运行build.sh脚本，记得加sudo权限test@test:~/orangepi-build$ '''sudo ./build.sh'''</li><li>选择'''U-boot package'''，然后回车<div class="figure">~~

~~[[File:media/image297.png|576x132px|选区_238]]~~Add distro "rolling"

<updated cache in /home/~~div><~~orangepi/~~li><li>接着选择开发板的型号<~~.ros/p>~~[[File:media~~rosdep/~~image298~~sources.~~png~~cache|~~576x123px]]</li>~~}~~<li>然后选择u-boot的分支类型~~</pol><ol start="6" style="list-style-type: ~~lower-alpha~~decimal;"><li>~~current分支会编译linux5.4镜像需要使用的u-boot v2018~~然后在'''桌面'''中打开一个命令行终端窗口，再使用'''test_ros.~~05版本的代码~~sh'''脚本可以启动一个小海龟的例程来测试下ROS是否能正常使用~~</li><li>next分支会编译linux6.1镜像需要使用的u~~{| class="wikitable" style="width:800px;" |-~~boot v2021.07版本的代码~~| ~~[[File~~orangepi@orangepi:~~media/image299~~~$ '''test_ros.~~png|576x77px]]~~sh'''~~</li></ol>~~|}

</li>

<li>~~然后就会开始编译u-boot，编译next分支时提示的部分信息说明如下所示：<ol style="list-style-type: lower-alpha;"><li>u-boot源码的版本[ o.k. ] Compiling u-boot [~~ 运行完'''~~v2021~~test_ros.07sh''' ~~]</li><li>交叉编译工具链的版本~~脚本后，会弹出下图所示的一个小海龟[ ~~o.k. ] Compiler version~~ [ ~~'''aarch64~~File:zero3-~~linux-gnu-gcc 11''' ]</li><li>编译生成的u-boot deb包的路径[ o.k~~img272. png] ~~Target directory [ '''orangepi-build/output/debs/u-boot'''~~ ]</li><li>~~编译生成的u-boot deb包的包名[ o.k. ] File name [ '''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb''' ]~~然后请保持刚才打开终端窗口在最上面</li>~~<li>编译使用的时间~~[ ~~o.k. ] Runtime~~ [ ~~'''1 min''' ]</li><li>重复编译u-boot的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译u~~File:zero3-~~boot[ o.k~~img273. png] ~~Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=u-boot'''~~ ]~~</li>~~</ol><~~/li><li>查看编译生成的u-boot deb包test@test:~/orangepi-build$ '''ls output/debs/u-boot/''''''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb'''</li>~~<li>orangepi-bulid编译系统编译u-boot源码时首先会将u-boot的源码和github服务器的u-boot源码进行同步，所以如果想修改u-boot的源码，首先需要关闭源码的下载更新功能（'''需要完整编译过一次u-boot后才能关闭这个功能，否则会提示找不到u-boot的源码'''），否则所作的修改都会被还原，方法如下：~~设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''......IGNORE_UPDATES~~ol start=~~"'''yes'''"......</li><li>调试u-boot代码时，可以使用下面的方法来更新linux镜像中的u-boot进行测试<ol~~ "9" style="list-style-type: ~~lower-alpha~~decimal;"><li>~~首先将编译好的u-boot的deb包上传到开发板的linux系统中test@test:~/orangepi-build$ '''cd output/debs/u-boot'''test@test:~/orangepi_build/output/debs/u-boot$ '''scp \''''''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb [mailto:root@192.168.1.xxx:/root root@192.168.1.xxx:/root]'''</li><li>再安装刚才上传的新的u-boot的deb包orangepi@orangepi:~$ '''sudo dpkg -i''' '''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb'''</li><li>然后运行 nand-sata-install脚本orangepi@orangepi:~$ '''sudo nand-sata-install'''</li><li>然后选择'''5 Install/Update the bootloader on SD/eMMC'''[[File:media/image300.png|320x174px]]</li><li>按下回车键后首先会弹出一个Warring~~此时按下键盘上的方向按键就可以控制小海龟上下左右移动了[[File:~~media/image301.png|314x170px]]</li><li>再按下回车键就会开始更新u~~zero3-~~boot，更新完后会显示下面的信息[[File:media/image302~~img274.png~~|292x164px~~]]~~</li><li>然后就可以重启开发板来测试u-boot的修改是否生效了</li></ol>~~</li></ol>

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

~~[[File:media/image303.png|575x116px|选区_240]]~~

<~~/div></li><li>然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个[[File:media/image304.png|576x87px]]</~~p>~~</li><li>接着选择开发板的型号[[File:media/image298.png|576x123px]]</li><li>然后选择内核源码的分支类型<ol style="list~~ros2 is an extensible command-~~style-type: lower-alpha;"><li>current分支会编译linux5.4内核源码</li><li>next分支会编译linux6~~line tool for ROS 2.~~1内核源码~~~~[[File:media/image299.png|576x77px]]</li></ol></li>~~<li>如果第3)步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码。~~[[File:media/image305.png|575x357px]]</li></ol~~>

~~~~

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>如果不需要修改内核的配置选项，在运行build.sh脚本时，传入'''KERNEL_CONFIGURE=no'''就可临时屏蔽弹出内核的配置界面了~~

~~test@test:~/orangepi-build$ '''sudo ./build.sh KERNEL_CONFIGURE=no'''</li>~~

~~<li>也可以设置orangepi-build/userpatches/config-default.conf配置文件中的'''KERNEL_CONFIGURE=no'''，这样可以永久禁用这个功能</li>~~

<li>编译内核的时候如果提示下面的错误，这是由于Ubuntu > PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu > PC的终端调到最大，然后重新运行build.sh脚本

~~[[File:media/image306.png|574x234px]]</li></ol>~~

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

~~== 编译rootfs ==~~

<~~ol style="list~~p>Commands::action Various action related sub-~~style~~commands:bag Various rosbag related sub-~~type~~commands: ~~decimal;"~~component Various component related sub-commands:daemon Various daemon related sub-commands<li/p>:~~运行build.sh脚本，记得加sudo权限~~doctor Check ROS setup and other potential issues:interface Show information about ROS interfaces~~test@test~~:~launch Run a launch file</~~orangepi~~p>:lifecycle Various lifecycle related sub-~~build$ '''sudo .~~commands</~~build.sh'''~~p>:multicast Various multicast related sub-commands:node Various node related sub-commands:param Various param related sub-commands:pkg Various package related sub-commands:run Run a package specific executable</lip>:security Various security related sub-commands<li/p>:~~选择'''Rootfs and all deb packages'''，然后回车~~service Various service related sub-commands:topic Various topic related sub-commands</lip>:wtf Use `wtf` as alias to `doctor`</olp>

~~<div class="figure">~~

~~[[File~~:~~media/image307.png|576x119px|选区_241]]~~ <~~/div~~p>~~<ol start="3" style="list-style-type: decimal~~Call `ros2 <command>">~~<li>接着选择开发板的型号[[File:media/image298.png|576x123px]]</li><li>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别<ol style="list-style-type: lower~~-~~alpha;"><li>current分支可以看到debian11、ubuntu20~~h` for more detailed usage.~~04、ubuntu22.04三个选项~~</p~~></li~~>~~<li>next分支可以看到debian11、debian12、ubuntu22.04三个选项[[File:media/image299.png~~|~~576x77px]]</li></ol>~~}

</li>

<li>~~然后选择rootfs的类型~~然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''test_ros.sh'''[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1][INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2][INFO] [~~File~~1671174103.199580322] [talker]: Publishing: 'Hello World:~~media~~3'</~~image308~~p>[INFO] [1671174103.~~png|576x79px~~204019965][listener]: I heard: [Hello World: 3]|}</li><li>~~然后选择镜像的类型~~运行下面的命令可以打开rviz2~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;"|-| orangepi@orangepi:~$ '''source /opt/ros/galactic/setup.bash'''<li/p>orangepi@orangepi:~$ '''~~Image with console interface > (server)~~ros2 run rviz2 rviz2'''~~表示服务器版的镜像，体积比较小~~|}[[File:zero3-img277.png]]</li><li>ROS的使用方法请参考下ROS 2的文档{| class="wikitable" style="width:800px;" |-| [http://docs.ros.org/en/galactic/Tutorials.html '''~~Image with desktop environment~~http://docs.ros.org/en/galactic/Tutorials.html'''~~表示带桌面的镜像，体积比较大~~]|}</li></ol> <~~div class~~span id="~~figure~~ubuntu22.04安装ros-2-humble的方法">

~~[[File:media/image309~~=== Ubuntu22.~~png|576x75px|选区_245]]~~04安装ROS 2 Humble的方法 ===

<ol style="list-style-type: decimal;"><li>使用'''install_ros.sh'''脚本可以安装ros2</~~div~~p>{| class="wikitable" style="width:800px;" |-| <~~/li~~p>orangepi@orangepi:~$ '''install_ros.sh ros2'''</olp>|}

</li>

<li>~~如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（~~'''~~没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了~~install_ros.sh'''）脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成~~<div~~ {| class="~~figure~~wikitable"style="width:800px;" |-| usage: ros2 [-h] Call `ros2 <command> -h` for more detailed usage. ... ros2 is an extensible command-line tool for ROS 2.

~~[[File~~optional arguments:~~media~~</~~image310.png|576x78px|选区_397]]~~p>:-h, --help show this help message and exit

~~</div></li>~~

~~<li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面~~

~~[[File:media/image311.png|576x76px]]~~

~~[[File:media/image312.png|576x74px]]~~

~~然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。~~

~~[[File:media/image313.png|575x264px]]</li>~~

~~<li>然后就会开始编译rootfs，编译时提示的部分信息说明如下~~

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>rootfs的类型~~

~~[ o.k. ] local not found [ Creating new rootfs cache for '''bullseye''' ]</li>~~

~~<li>编译生成的rootfs压缩包的存放路径~~

~~[ o.k. ] Target directory [ '''orangepi-build/external/cache/rootfs''' ]</li>~~

~~<li>编译生成的rootfs压缩包的名字~~

~~[ o.k. ] File name [ '''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4''' ]</li></ol>~~

~~</li>~~

~~<li>查看编译生成的rootfs压缩包~~

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4'''是rootfs的压缩包，名字各字段的含义为~~

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>'''bullseye'''表示rootfs的linux发行版的类型</li>~~

~~<li>'''xfce'''表示rootfs为桌面版的类型，如果为'''cli'''则表示服务器版类型</li>~~

~~<li>'''arm64'''表示rootfs的架构类型</li>~~

<li>'''25250ec7002de9e81a41de169f1f89721'''是由rootfs安装的所有软件包的包名生成的MD5哈希值，只要没有修改rootfs安装的软件包的列表，那么这个值就不会变，编译脚本会通过这个MD5哈希值来判断是否需要重新编译rootfs</li></ol>

~~</li>~~

~~<li>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list'''列出了rootfs安装的所有软件包的包名~~

~~test@test:~/orangepi-build$ '''ls external/cache/rootfs/'''~~

~~bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4~~

~~bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.current~~

~~bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list</li></ol>~~

~~</li>~~

<li>如果需要的rootfs在'''external/cache/rootfs'''下已经存在，那么再次编译rootfs就会直接跳过编译过程，不会重新开始编译，编译镜像的时候也会去'''external/cache/rootfs'''下查找是否已经有缓存可用的rootfs，如果有就直接使用，这样可以节省大量的下载编译时间</li></ol>

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

~~<ol style="list-style-type: decimal;">~~

~~<li>运行'''build.sh'''脚本，记得加sudo权限~~

~~test@test:~/orangepi-build$ '''sudo ./build.sh'''</li>~~

~~<li>选择'''Full OS image for flashing'''，然后回车</li></ol>~~

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

~~[[File:media/image314.png|576x128px|选区_242]]~~== 安装内核头文件的方法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''Linux6.1内核的Debian11系统编译内核模块时会报GCC的错误。所以如果要编译内核模块请使用Debian12或者Ubuntu22.04。'''</~~div~~big>|} <ol ~~start="3"~~ style="list-style-type: decimal;"><li>~~然后选择开发板的型号~~OPi发布的Linux镜像默认自带了内核头文件的deb包，存放的位置为'''/opt/'''{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''ls /opt/~~image298.png|576x123px]]~~linux-headers*'''</p~~></li~~>~~<li>~~~~然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别<~~/p>~~<ol style="list~~opt/linux-~~style~~headers-~~type: lower~~xxx-~~alpha;"><li>current分支可以看到debian11、ubuntu20~~sun50iw9_x.x.~~04、ubuntu22~~x_arm64.~~04三个选项~~deb|}</li><li>~~next分支可以看到debian11、debian12、ubuntu22.04三个选项~~使用下面的命令可以安装内核头文件的deb包{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''sudo dpkg -i /opt/~~image299~~linux-headers*.~~png|576x77px]]~~deb'''~~</li></ol>~~|}

</li>

<li>~~然后选择rootfs的类型<~~安装完后在'''/p>~~[[File:media~~usr/~~image308.png|576x79px]]~~src'''下就能看到内核头文件所在的文件夹</p~~></li~~>~~<li>然后选择镜像的类型<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>~~|-| orangepi@orangepi:~$ '''~~Image with console interface > (server)~~ls /usr/src'''~~表示服务器版的镜像，体积比较小~~</p~~></li~~>~~<li>~~~~'''Image with desktop environment'''表示带桌面的镜像，体积比较大~~linux-headers-x.x.x~~<div class="figure">~~ ~~[[File:media/image309.png|576x75px~~|~~选区_245]]~~ ~~</div></li></ol>~~}

</li>

<li>~~如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（~~然后可以编译下Linux镜像中自带的hello内核模块的源码，hello模块的源码在'''~~没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了~~/usr/src/hello'''）中，进入此目录后，然后使用make命令编译即可。~~<div~~ {| class="~~figure">~~ ~~[[File:media/image310.png|576x78px|选区_397]]~~ ~~</div></li></ol>~~ ~~<ol start="12~~wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>~~|-| ~~如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面~~orangepi@orangepi:~$ '''cd /usr/src/hello/'''~~[[File~~orangepi@orangepi:~~media~~/~~image311.png|576x76px]]~~usr/src/hello$ '''sudo make'''~~[[File:media~~make -C /lib/modules/~~image312~~5.~~png|576x74px]]<~~4.125/build M=/usr/src/p>~~然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。~~hello modulesmake[~~[File~~1]:~~media/image313.png|575x264px]]<~~Entering directory '/~~p><~~usr/~~li><~~src/~~ol>~~ <!linux-headers- ~~--><ol start="8" style="list-style-type: decimal;"><li>然后就会开始编译linux镜像，编译的大致流程如下~~5.4.125'~~<ol style="list-style-type~~: ~~lower-alpha;"><li>~~~~初始化Ubuntu PC的编译环境，安装编译过程需要的软件包<~~CC [M] /~~p><~~usr/~~li><li>下载u-boot和linux内核的源码（如果已经缓存，则只更新代码）<~~src/~~p><~~hello/~~li><li>编译u-boot源码，生成u-boot的deb包~~hello.o</p~~></li~~>~~<li>~~:~~编译linux源码，生成linux相关的deb包~~Building modules, stage 2.</p~~></li~~>~~<li>~~:~~制作linux firmware的deb包~~MODPOST 1 modules</p~~></li~~>~~<li>~~:~~制作orangepi-config工具的deb包<~~CC [M] /~~p><~~usr/~~li><li>制作板级支持的deb包<~~src/~~p><~~hello/~~li><li>如果是编译desktop版镜像，还会制作desktop相关的deb包~~hello.mod.o</p~~></li~~>~~<li>~~:~~检查rootfs是否已经缓存，如果没有缓存，则重新制作rootfs，如果已经缓存，则直接解压使用<~~LD [M] /~~p><~~usr/~~li><li>安装前面生成的deb包到rootfs中<~~src/~~p><~~hello/~~li><li>对不同的开发板和不同类型镜像做一些特定的设置，如预装额外的软件包，修改系统配置等~~hello.ko</p~~></li~~>~~<li>~~~~然后制作镜像文件，并格式化分区，默认类型为ext4<~~make[1]: Leaving directory '/~~p><~~usr/~~li><li>再将配置好的rootfs拷贝到镜像的分区中<~~src/~~p></li><li>然后更新initramfs~~linux-headers-5.4.125'</p~~></li~~>~~<li>最后将u-boot的bin文件通过dd命令写入到镜像中</li></ol>~~|}

</li>

<li>~~编译完镜像后会提示下面的信息<ol style="list-style-type: lower-alpha;"><li>编译生成的镜像的存放路径[ 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''' ]</li><li>编译使用的时间</li></ol></li></ol>~~ ~~'''[ o.k. ] Runtime [ 19 min ]'~~编译完后会生成'' ~~<ol style="list-style-type: lower-alpha;"><li>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像[ o.k. ] Repeat Build Options [~~ '~~''sudo~~ hello.~~/build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=image RELEASE=bullseye BUILD_MINIMAL=no BUILD_DESKTOP=no KERNEL_CONFIGURE=yes~~ko''' ]内核模块~~</li></ol>~~ ~~~~ ~~= '''Android 12 TV系统使用说明''' =~~ ~~== 已支持的Android版本 ==~~ {| class="wikitable" style="width:800px;"

|-

|}

</li><~~span id="android-12-tv功能适配情况"~~li>使用'''insmod'''命令可以将'''hello.ko'''内核模块插入内核中</~~span~~p>~~== Android 12 TV功能适配情况 ==~~ {| class="wikitable" style="width:800px;"

|-

| ~~style="text-align~~orangepi@orangepi: ~~left;"~~/usr/src/hello$ '''sudo insmod hello.ko'''| 功能}</li><li>然后使用'''demsg'''命令可以查看下'''hello.ko'''内核模块的输出，如果能看到下面的输出说明'''hello.ko'''内核模块加载正确{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| Android12~~

|-

| ~~style="text-align~~orangepi@orangepi: ~~left~~/usr/src/hello$ '''dmesg | grep ""Hello"'''[ 2871.893988] '''Hello Orange Pi -- init'''| ~~HDMI视频~~}</li><li>使用'''rmmod'''命令可以卸载'''hello.ko'''内核模块{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| orangepi@orangepi:/usr/src/hello$ '''sudo rmmod hello'''orangepi@orangepi:/usr/src/hello$ '''dmesg | grep "Hello"'''[ 2871.893988] Hello Orange Pi -- init[ 3173.800892] '''Hello Orange Pi -- exit'''|}</li></ol> == Linux系统支持的部分编程语言测试 == === Debian Bullseye系统 === <ol style="~~text~~list-~~align~~style-type: ~~left~~decimal;"~~| HDMI音频~~><li>Debian Bullseye默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序| <ol style="~~text~~list-style-~~align~~type: ~~left~~lower-alpha;"><li>gcc的版本如下所示{| OKclass="wikitable" style="width:800px;"

|-

| ~~style="text~~orangepi@orangepi:~$ '''gcc --version'''gcc (Debian 10.2.1-~~align: left~~6) 10.2.1 20210110Copyright (C) 2020 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty;"not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.| ~~USB2~~}</li><li>编写C语言的'''hello_world.~~0 x 3~~c'''程序{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| ~~style="text-align~~orangepi@orangepi:~$ '''vim hello_world.c'''#include <stdio.h> int main(void){:printf("Hello World!\n"); : ~~left~~return 0;"}| ~~TF卡启动~~}</li><li>然后编译运行'''hello_world.c'''{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''orangepi@orangepi:~$ '''./hello_world'''Hello World!|}</li></ol></li><li>Debian Bullseye默认安装有Python3<ol style="~~text~~list-style-~~align~~type: ~~left~~lower-alpha;"~~| 网卡~~><li>Python具体版本如下所示{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| ~~style="text-align~~orangepi@orangepi:~$ '''python3''''''Python 3.9.2''' (default, Feb 28 2021, 17:03: ~~left~~44)[GCC 10.2.1 20210110] on linuxType "help"", "copyright", "credits" or "license" for more information.>>>| 红外}{| class="wikitable" style="~~text~~background-~~align~~color: ~~left~~#ffffdc;width:800px;"~~| OK~~

|-

| ~~style="text-align: left;"~~<big>'''使用Ctrl+D快捷键可退出python的交互模式。'''</big>| ~~WIFI~~}~~| style="text-align: left;"| OK~~</li>|-<li>编写Python语言的'''hello_world.py'''程序{| ~~style~~class="~~text-align: left;~~wikitable"~~| WIFI hotsport~~| style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| ~~style="text-align~~orangepi@orangepi: ~~left;"~~~$ '''vim hello_world.py'''print('Hello World!')| 蓝牙}</li><li>运行'''hello_world.py'''的结果如下所示{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| orangepi@orangepi:~$ '''python3 hello_world.py'''Hello World!|}</li></ol></li><li>Debian Bullseye默认没有安装Java的编译工具和运行环境<ol style="~~text~~list-style-~~align~~type: ~~left~~lower-alpha;"~~| BLE蓝牙~~><li>可以使用下面的命令安装openjdk，Debian Bullseye中最新版本为openjdk-17{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| ~~style="text~~orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-~~align: left;"~~jdk'''| ~~耳机音频~~}</li><li>安装完后可以查看下Java的版本{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| ~~style="text~~orangepi@orangepi:~$ '''java --~~align: left;"~~version'''| ~~TV-OUT~~}</li><li>编写Java版本的'''hello_world.java'''{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

| ~~style="text-align~~orangepi@orangepi:~$ '''vim hello_world.java'''public class hello_world{:public static void main(String[] args):{:: ~~left~~System.out.println("Hello World!");":}}| ~~USB摄像头~~}</li><li>然后编译运行'''hello_world.java'''{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| OK~~

|-

|}

</li></ol>

~~~~== ~~板载LED灯显示说明~~ Debian Bookworm系统 ===

<ol style="list-style-type: decimal;"><li>Debian Bookworm默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type: lower-alpha;"><li>gcc的版本如下所示{| class="wikitable" style="width:800px;"

|-

|~~| style="text~~orangepi@orangepi:~$ '''gcc --version'''gcc (Debian 12.2.0-~~align: left~~14) 12.2.0Copyright (C) 2022 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty;"not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.| }</li><li>编写C语言的'''绿灯hello_world.c'''程序{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"~~| '''红灯'''~~

|-

| ~~'''u-boot启动阶段'''| style="text-align: left;"| '''灭'''| style="text-align~~orangepi@orangepi: ~~left;"| '''亮'~~~$ ''|-| '~~''内核启动到进入系统~~vim hello_world.c'''~~| style="text-align: left~~#include <~~"| '''亮'''| style="text-align: left~~stdio.h>~~"| '''灭'''~~|}

~~~~

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

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

~~~~

~~== ADB的使用方法 ==~~

~~=== 使用网络连接adb调试 ===~~ '''使用网络adb无需USB Typc C接口的数据线来连接电脑和开发板，而是通过网络来通信，所以首先请确保开发板的有线或者无线网络已经连接好了，然后获取开发板的IP地址，后面要用到。''' ~~<ol style="list-style-type~~: ~~decimal;"><li>~~~~确保Android系统的'''service.adb.tcp.port'''设置为5555端口号~~return 0;~~apollo-p2:/ # '''getprop | grep "adb.tcp"'''~~}~~[service.adb.tcp.port]: [5555]~~|}</li><li>如果然后编译运行'''~~service.adb~~hello_world.~~tcp.port~~c'''~~没有设置，可以在串口中使用下面的命令设置网络adb的端口号~~</p~~></li></ol~~> ~~apollo-p2:/ # '''setprop service.adb.tcp.port 5555''' apollo-p2:/ # '''stop adbd'''~~ ~~apollo-p2:/ # '''start adbd'''~~ ~~<ol start~~{| class="3wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>在Ubuntu PC上安装adb工具~~|-~~test@test:~$ '''sudo apt-get update'''~~| ~~test~~orangepi@~~test~~orangepi:~$ '''~~sudo apt~~gcc -~~get install -y adb~~o hello_world hello_world.c'''~~</li><li>然后在Ubuntu PC上连接网络adb~~~~test~~orangepi@~~test~~orangepi:~$ '''~~adb connect 192~~.~~168.1.xxx:5555''' '''(需要修改为开发板的IP地址)~~/hello_world'''* daemon not running; starting now at tcp:5037Hello World!~~* daemon started successfully~~|}~~connected to 192.168.1.xxx:5555~~</pli>~~test@test:~$ '''adb devices'''~~~~List of devices attached</p~~ol>~~192.168.1.xxx:5555 device~~</li><li>~~然后在Ubuntu PC上通过adb shell就可以登录android系统~~Debian Bookworm默认安装有Python3~~</li></ol>~~ ~~test@test:~$ '''adb shell'''~~ ~~apollo-p2:/ #~~ ~~=== 使用数据线连接adb调试 ===~~ <ol style="list-style-type: ~~decimal~~lower-alpha;"><li>准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的电源接口中。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板Python具体版本如下所示~~<div~~ {| class="~~figure~~wikitable" style="width:800px;"> ~~[[File:media/image15.jpeg~~|~~172x172px|IMG_4194(20201104~~-~~125502)]]~~ ~~</div></li><li>在Ubuntu PC上安装adb工具~~| ~~test~~orangepi@~~test~~orangepi:~$ '''~~sudo apt-get update~~python3'''~~test@test~~Python 3.11.2 (main, Mar 13 2023, 12:~~~$ '''sudo apt-get install -y adb'''</li><li>查看识别到ADB设备test@test~~18:~~~$ '''adb devices'''List of devices attached4c00146473c28651dd0 device</li><li>然后在Ubuntu PC上通过adb shell就可以登录android系统</li></ol>~~ ~~test@test:~$ '''adb shell'''~~ ~~apollo-p2:/ $~~ ~~== 查看设置HDMI显示分辨率的方法 ==~~ ~~<ol style="list-style-type: decimal;"><li>首先进入'''Settings'''~~29) [~~[File:media/image316~~GCC 12.~~png|234x83px]]</li><li>然后选择'''Device Preferences'''[[File:media/image317~~2.~~png|415x170px]~~0]on linux</p~~></li~~>~~<li>~~~~然后选择'''Display~~ Type "help", "copyright", "credits" or "license&~~amp~~quot; ~~Sound'''[[File:media/image318~~for more information.~~png|420x133px]]~~</p~~></li~~>~~<li>~~~~然后选择'''Advanced display settings'''~~>>>~~[[File:media/image319.png~~|~~423x96px]]</li>~~}~~<li>然后选择'''HDMI outpu mode'''[[File:media/image320.png~~{|~~423x101px]]</li>~~<li>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。~~[[File:media/image321.png|429x136px]]</li><li>开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项[[File:media/image322.png|429x242px]]</li></ol>~~ ~~== HDMI转VGA显示测试 ==~~ ~~<ol~~ style="~~list~~background-~~style-type~~color: ~~decimal~~#ffffdc;">~~<li>首先需要准备下面的配件<ol style="list-style-type~~width: ~~lower-alpha~~800px;">~~<li>HDMI转VGA转换器~~|-~~[[File:media/image146.png~~|~~155x104px]]</li>~~<libig>~~一根VGA线和一根Micro HDMI公转HDMI母转接线~~'''使用Ctrl+D快捷键可退出python的交互模式。'''<~~p>[[File:media~~/~~image147.png|148x133px]] [[File:media/image148.jpeg|157x139px|IMG_6140(20220104-134930)]]</li~~big>~~<li>一个支持VGA接口的显示器或者电视</li></ol>~~|}

</li>

<li>~~HDMI转VGA显示测试如下所示~~编写Python语言的'''hello_world.py'''程序{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''vim hello_world.py'''print('Hello World!')</~~image323~~p>|}</li><li>运行'''hello_world.~~png|576x330px]]~~py'''的结果如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''使用HDMI转VGA显示时，开发板以及开发板的Android系统是不需要做任何设置的，只需要开发板Micro HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。python3 hello_world.py'''Hello World!|}</li></ol></li><~~span id~~li>Debian Bookworm默认没有安装Java的编译工具和运行环境<ol style="wilist-style-type: lower-alpha;"><li>可以使用下面的命令安装openjdk，Debian Bookworm中最新版本为openjdk-~~fi的连接方法~~17{| class="wikitable" style="width:800px;"|-| orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdk'''|}</li><li>安装完后可以查看下Java的版本{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''java --version'''|}</li><li>编写Java版本的'''hello_world.java'''</~~span~~p>{| class="wikitable" style= WI"width:800px;" |-~~FI的连接方法~~ | orangepi@orangepi:~$ '''vim hello_world.java'''public class hello_world{:public static void main(String[] args):{::System.out.println("Hello World!");:}}|}</li><li>然后编译运行'''hello_world.java'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''javac hello_world.java'''orangepi@orangepi:~$ '''java hello_world'''Hello World!|}</li></ol></li></ol>

<~~ol style~~span id="~~list~~ubuntu-~~style-type: decimal;~~focal系统">~~<li>首先选择'''Settings'''[[File:media/image316.png|234x83px]]~~</~~p></li><li>然后选择'''Network & Internet'''[[File:media/image324.png|373x103px]]</li><li>然后打开WI-FI[[File:media/image325.png|381x50px]]</li><li>打开WI-FI后在'''Available networks'''下面就可以看到搜索到的信号[[File:media/image326.png|381x187px]]</li><li>选择想连接的WI-FI后会弹出下图所示的密码输入界面<div class="figure"~~span>

~~[[File:media/image327.png|386x180px|Screenshot_20220104-164114]]~~ ~~</div></li><li>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了[[File:media/image328.png|388x160px]]</li><li>WI-FI连接成功后的显示如下图所示[[File:media/image329.png|402x141px]]</li></ol>~~ ~~~~== ~~WI-FI hotspot的使用方法~~ Ubuntu Focal系统 ===

<li>~~首先请确保以太网口已连接网线，并且能正常上网~~Ubuntu Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<~~/li~~ol style="list-style-type: lower-alpha;"><li>~~然后选择'''Settings'''~~gcc的版本如下所示~~[[File~~{| class="wikitable" style="width:~~media/image316.png~~800px;" |-|~~234x83px]]</li><li>~~~~然后选择~~orangepi@orangepi:~$ '''~~Network & Internet~~gcc --version'''~~[[File:media/image324~~gcc (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.~~png|373x103px]]~~0</p~~></li~~>~~<li>~~~~然后选择'''WIFI hotspot'''~~Copyright (C) 2019 Free Software Foundation, Inc.~~[[File:media/image330~~This is free software; see the source for copying conditions.~~png|378x104px]]~~There is NO</p~~></li~~>~~<li>~~然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.~~[[File:media/image331.png~~|~~402x174px]]~~}</li><li>~~此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图~~编写C语言的'''~~Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password~~hello_world.c'''~~下面可以看到~~程序~~[[File~~{| class="wikitable" style="width:~~media/image332.png~~800px;" |-|~~269x191px]]</li><li>~~连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的orangepi@orangepi:~$ '''~~WI-FI Hotspot~~vim hello_world.c'''~~能正常使用~~~~[[File:media/image333~~#include <stdio.~~png|269x125px]]~~h></p~~></li></ol~~>

~~~~

~~== 查看以太网口IP地址的方法 ==~~

~~<ol style="list-style-type: decimal;"><li>~~~~首先请确保开发板的千兆网口连接到了路由器或者交换机~~int main(void)</p~~></li~~>~~<li>~~~~然后打开'''Settings'''~~{~~[[File~~:~~media/image334.png|431x161px]]</li><li>~~~~然后选择'''Network~~ printf(&~~amp~~quot;Hello World!\n"); ~~Internet'''[[File:media/image335.png|576x186px]]</li><li>然后在下图所示的位置就能看到开发板有线网口的IP地址了~~~~[[File:media/image336.png|576x200px]]</li></ol~~>

~~== 蓝牙的连接方法 ==~~

~~<ol style="list-style-type~~: ~~decimal;"><li>~~~~首先选择'''Settings'''~~return 0;~~[[File:media/image316.png|234x83px]]~~}|}</li><li>~~然后选择~~然后编译运行'''~~Bluetooth~~hello_world.c'''~~[[File~~{| class="wikitable" style="width:~~media/image337.png~~800px;" |-|~~377x111px]]</li><li>~~~~然后打开~~orangepi@orangepi:~$ '''~~Bluetooth Enable~~gcc -o hello_world hello_world.c'''~~[[File~~orangepi@orangepi:~~media/image338.png|384x180px]]</li><li>然后点击~~~$ '''~~Pair new device~~./hello_world'''~~开始扫描周围的蓝牙设备~~~~[[File:media/image339.png|389x129px]]~~Hello World!|}</~~li>~~<li>~~搜索到的蓝牙设备会在'''Available devices'''下面显示出来~~</pol>~~[[File:media/image340.png|407x181px]]~~</li><li>~~然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项~~Ubuntu Focal默认安装有Python3<~~p>[[File~~ol style="list-style-type:~~media/image341.png|420x115px]]</li~~lower-alpha;"><li>~~这里测试的是开发板和'''安卓手机'''蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程~~Python3具体版本如下所示~~[[File~~{| class="wikitable" style="width:~~media/image342.png~~800px;" |-|~~178x200px]]</li><li>~~~~配对完成后，再打开~~orangepi@orangepi:~$ '''~~Paired devices~~python3'''~~下面就可以看到已配对的蓝牙设备~~~~[[File~~Python 3.8.10 (default, Nov 14 2022, 12:59:~~media/image343.png|430x136px]]</li>~~<li>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了47)[~~[File:media/image344~~GCC 9.4.~~png|433x113px]~~0]on linux</p~~></li~~>~~<li>~~~~开发板Android系统蓝牙接收到的图片可以打开'''Received files'''中查看~~Type "help", "copyright", "credits" or "license" for more information.~~[[File:media/image345.png|432x209px]]~~>>></p~~></li></ol~~>|}~~== USB摄像头使用方法 ==~~ ~~<ol~~ style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~decimal~~800px;">~~<li>首先在开发板的USB接口中插入USB（UVC协议）摄像头</li>~~|-| <~~li><p~~big>~~USB摄像头如果识别正常，在/dev下会生成相应的video设备节点~~~~console:/ #~~ '''~~ls /dev/video0~~使用Ctrl+D快捷键可退出python的交互模式。'''~~/dev/video0~~</pbig>|}</li><li>~~然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l|~~编写Python语言的'''~~ADB的使用方法~~hello_world.py'''~~]]一小节的说明~~程序~~</li><li>~~{| class="wikitable" style="width:800px;" |-| ~~在开发板资料下载页面的~~orangepi@orangepi:~$ '''~~官方工具~~vim hello_world.py'''~~中下载USB摄像头测试APP~~~~[[File:media/image346.png|576x172px]]~~print('Hello World!')~~[[File:media/image347.png~~|~~575x145px]]~~}</li><li>~~然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装~~运行'''hello_world.py'''的结果如下所示{| class="wikitable" style="width:800px;" |-| ~~test~~orangepi@~~test~~orangepi:~$ '''~~adb install usbcamera~~python3 hello_world.~~apk~~py'''</p~~></li~~>~~<li>~~~~安装完后在Android的桌面可以看到USB摄像头的启动图标~~Hello World!|}<p/li>~~[[File:media/image348.png|576x132px]]~~</pol></li><li>~~然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了~~Ubuntu Focal默认没有安装Java的编译工具和运行环境~~</li></ol>~~ ~~== Android系统ROOT说明 ==~~ ~~'''Orange Pi发布的Android系统已经ROOT，可以使用下面的方法来测试。'''~~ <ol style="list-style-type: ~~decimal~~lower-alpha;"><li>~~在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''~~可以使用下面的命令安装openjdk-17~~[[File~~{| class="wikitable" style="width:~~media/image346.png~~800px;" |~~576x172px]]~~-~~[[File:media/image349.png~~|~~575x124px]]</li><li>~~~~然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l|~~orangepi@orangepi:~$ '''~~ADB的使用方法~~sudo apt install -y openjdk-17-jdk'''~~]]一小节的说明~~|}</li><li>~~然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装~~安装完后可以查看下Java的版本{| class="wikitable" style="width:800px;" |-| ~~test~~orangepi@~~test~~orangepi:~$ '''~~adb install rootcheck.apk~~java --version'''</p~~></li~~>~~<li>~~~~安装完后在Android的桌面可以看到ROOT测试工具的启动图标~~openjdk 17.0.2 2022-01-18~~[[File:media/image350~~OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.~~png|575x119px]]~~04)</p~~></li~~>~~<li>~~~~第一次打开'''ROOT测试工具'''后的显示界面如下图所示~~OpenJDK 64-Bit Server VM (build 17.0.2+8-Ubuntu-120.04, mixed mode, sharing)~~[[File:media/image351.png~~|~~575x162px]]~~}</li><li>~~然后就可以点击~~编写Java版本的'''~~CHECK NOW~~hello_world.java'''~~开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限~~~~[[File:media/image352.png~~{|~~575x161px]]</li></ol>~~ ~~== 使用MiracastReceiver将手机屏幕投屏到开发板的方法 ==~~ ~~<ol~~ style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[\l~~|~~'''WI~~-~~FI的连接方法''']]一小节的说明</li><li>~~| ~~然后打开开发板安卓系统中的~~orangepi@orangepi:~$ '''~~MiracastReceiver~~vim hello_world.java'''应用~~[[File:media/image353.png|576x124px]]~~public class hello_world</p~~></li~~>~~<li>~~~~'''MiracastReceiver'''打开后的界面如下所示~~{:<~~div class="figure"~~p> [public static void main(String[~~File:media/image354.png|420x236px|Screenshot_20230625-193535]~~] args)</~~div></li~~p>~~<li>~~:然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能{::~~[[File:media/image355~~System.out.~~png|167x266px]]~~println("Hello World!");</p~~></li~~>~~<li>~~:~~等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可~~}~~[[File:media/image356.png|146x308px]]~~}|}</li><li>~~然后在开发板的~~然后编译运行'''~~MiracastReceiver~~hello_world.java'''~~应用界面会弹出下图所示的选择框，这里我们选择~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~Accept~~javac hello_world.java'''即可~~[[File~~orangepi@orangepi:~~media/image357.png|468x265px]]~~~$ '''java hello_world'''</p~~></li~~>~~<li>~~~~然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了~~Hello World!|}<p/li>~~[[File:media/image358.png|576x352px]]~~</pol></li></ol>

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

~~~~==~~= 26pin的GPIO口测试方法~~ Ubuntu Jammy系统 ===

<li>~~首先在桌面中打开wiringOP APP~~Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<~~p>[[File~~ol style="list-style-type:~~media/image359.png|576x133px]]</li~~lower-alpha;"><li>~~然后点击'''GPIO_TEST'''按钮打开GPIO测试界面~~gcc的版本如下所示~~[[File~~{| class="wikitable" style="width:~~media/image360.png~~800px;" |-|~~413x77px]]</li><li>~~~~GPIO测试界面如下图所示，左边的两排~~orangepi@orangepi:~$ '''~~CheckBox~~gcc --version'''按钮跟26pin引脚（'''左下角的PC1/PI16/PI6/PH10是13pin引脚中的GPIO口'''）是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平设置为低电平；当点击右边的'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息。~~[[File:media/image361~~gcc (Ubuntu 11.~~png|425x236px]]</li><li>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：<div class="figure">~~ ~~[[File:media/image362~~3.~~png|444x249px|Screenshot_20230609~~0-~~155643]]~~ ~~</div></li>~~<li>开发板26pin中总共有17个GPIO口可以使用（'''如果加上13pin中的4个GPIO口，那么总共就是有21个'''），下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平。首先点击7号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，7号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为1ubuntu1~22.04.1) '''11.3.3v0'''~~，说明设置高电平成功~~~~[[File:media/image363~~Copyright (C) 2021 Free Software Foundation, Inc.~~png|432x210px]]~~</p~~></li~~>~~<li>~~~~然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为'''OUT'''，引脚电平为高电平~~This is free software; see the source for copying conditions. There is NO~~[[File:media/image364~~warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.~~png|430x207px]]~~|}</li><li>~~再次点击下图的~~编写C语言的'''~~CheckBox~~hello_world.c'''~~按钮取消勾选状态，7号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功~~程序~~[[File~~{| class="wikitable" style="width:~~media/image365.png~~800px;" |-|~~434x212px]]</li><li>~~~~然后点击~~orangepi@orangepi:~$ '''~~GPIO READALL~~vim hello_world.c'''~~按钮，可以看到当前的7号引脚模式为OUT，引脚电平为低电平~~~~[[File:media/image366~~#include <stdio.~~png|438x217px]]~~h></p~~></li></ol~~>

~~~~

~~=== 26pin的UART测试方法 ===~~

~~<ol style="list-style-type: decimal;"><li>Android中默认打开了'''UART5'''，对应的设备节点为'''/dev/ttyAS5'''apollo-p2:/ # '''ls /dev/ttyAS5'''/dev/ttyAS5</li><li>~~~~首先在桌面中打开wiringOP APP~~int main(void)~~[[File:media/image359.png|576x133px]]~~{</p~~></li~~>~~<li>然后点击'''UART_TEST'''按钮打开UART测试界面[[File~~:~~media/image367.png|505x94px]]~~~~</li><li>wiringOP的串口测试界面如下图所示~~printf("Hello World!\n");</p~~></li></ol~~>

~~[[File:media/image368.png|511x133px]]~~

~~<ol start="5" style="list-style-type~~: ~~decimal;"><li>~~~~然后在选择框中选择'''/dev/ttyAS5'''节点~~return 0;~~[[File:media/image369.png|499x269px]]~~}|}</li><li>~~再在编辑框中输入想要设置的波特率，然后点击~~然后编译运行'''~~OPEN'''按钮打开'''/dev/ttyAS5'''节点，打开成功后，'''OPEN'~~hello_world.c''~~按钮变为不可选中状态，~~'~~''CLOSE'''按钮和'''SEND'''按钮变为可选中状态~~</p~~></li></ol~~> ~~[[File:media/image370.png~~{|~~334x107px]]~~ ~~<ol start~~class="7wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>然后使用杜邦线短接uart5的rx和tx引脚</li></ol>~~ ~~{| class="wikitable~~"

|-

|}

</li></ol>

</li>

<li>Ubuntu Jammy默认安装有Python3

<li>Python3具体版本如下所示

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

|-

|

orangepi@orangepi:~$ '''python3'''

Python 3.10.6 (main, May 29 2023, 11:10:38) [GCC 11.3.0] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>>

|}

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

|-

|

<big>'''使用Ctrl+D快捷键可退出python的交互模式。'''</big>

|}

</li>

<li>编写Python语言的'''hello_world.py'''程序

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

|-

|

orangepi@orangepi:~$ '''vim hello_world.py'''

print('Hello World!')

|}

</li>

<li>运行'''hello_world.py'''的结果如下所示

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

|-

|

orangepi@orangepi:~$ '''python3 hello_world.py'''

Hello World!

|}

</li></ol>

</li>

<li>Ubuntu Jammy默认没有安装Java的编译工具和运行环境

<li>可以使用下面的命令安装openjdk-18

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

|-

|

orangepi@orangepi:~$ '''sudo apt install -y openjdk-18-jdk'''

|}

</li>

<li>安装完后可以查看下Java的版本

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

|-

|

orangepi@orangepi:~$ '''java --version'''

openjdk 18.0.2-ea 2022-07-19

OpenJDK Runtime Environment (build 18.0.2-ea+9-Ubuntu-222.04)

OpenJDK 64-Bit Server VM (build 18.0.2-ea+9-Ubuntu-222.04, mixed mode, sharing)

|}

</li>

<li>编写Java版本的'''hello_world.java'''

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

|-

|

orangepi@orangepi:~$ '''vim hello_world.java'''

public class hello_world

{

:public static void main(String[] args)

:{

::System.out.println("Hello World!");

:}

}

|}

</li>

<li>然后编译运行'''hello_world.java'''

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

|-

|

orangepi@orangepi:~$ '''javac hello_world.java'''

orangepi@orangepi:~$ '''java hello_world'''

Hello World!

|}

</li></ol>

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

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

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

<li>使用scp命令可以在Ubuntu PC中上传文件到开发板的Linux系统中，具体命令如下所示

<li>'''file_path：'''需要替换为要上传文件的路径</li>

<li>'''orangepi：'''为开发板linux系统的用户名，也可以替换成其它的，比如root</li>

<li>'''192.168.xx.xx:''' 为开发板的IP地址，请根据实际情况进行修改</li>

<li>'''/home/orangepi:''' 开发板linux系统中的路径，也可以修改为其它的路径

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

|-

|

test@test:~$ '''scp file_path orangepi@192.168.xx.xx:/home/orangepi/'''

|}

</li></ol>

</li>

<li>如果要上传文件夹，需要加上-r参数

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

|-

|

test@test:~$ '''scp -r dir_path orangepi@192.168.xx.xx:/home/orangepi/'''

|}

</li>

<li>scp还有更多的用法，请使用下面的命令查看man手册

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

|-

|

test@test:~$ '''man scp'''

|}

</li></ol>

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

<li>首先在Ubuntu PC中安装filezilla

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

|-

|

test@test:~$ '''sudo apt install -y filezilla'''

|}

</li>

<li>然后使用下面的命令打开filezilla

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

|-

|

test@test:~$ '''filezilla'''

|}

</li>

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

[[File:zero3-img279.png]]

</div></li>

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

[[File:zero3-img280.png]]

</div>

</li></ol>

<li>然后选择'''保存密码'''，再点击'''确定'''

[[File:zero3-img281.png]]</li>

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

[[File:zero3-img282.png]]

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

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

[[File:zero3-img283.png]]

</div></ol>

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

[[File:zero3-img284.png]]

</div></ol>

<li>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</li>

<li>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</li></ol>

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

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

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

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

|-

|

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

|}

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

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

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

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

|-

|

'''FileZilla_Server_1.5.1_win64-setup.exe'''

|}

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

[[File:zero3-img287.png]]

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

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

[[File:zero3-img288.png]]

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

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

[[File:zero3-img289.png]]

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

<li>然后选择'''保存密码'''，再点击'''确定'''

[[File:zero3-img290.png]]

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

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

[[File:zero3-img291.png]]

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

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

[[File:zero3-img292.png]]

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

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

[[File:zero3-img293.png]]

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

<li>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</li>

<li>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</li></ol>

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

<li>开关机logo默认只在桌面版的系统中才会显示</li>

<li>在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''false'''可以关闭开关机logo

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

|-

|

orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''

verbosity=1

'''bootlogo=false'''

|}

</li>

<li>在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''true'''可以开启开关机logo

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

|-

|

orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''

verbosity=1

'''bootlogo=true'''

|}

</li>

<li>开机logo图片在linux系统中的位置为

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

|-

|

'''/usr/share/plymouth/themes/orangepi/watermark.png'''

|}

</li>

<li>替换开机logo图片后需要运行下命令才能生效

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

|-

|

orangepi@orangepi:~$ '''sudo update-initramfs -u'''

|}

</li></ol>

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

<li>在Linux系统运行的过程中，如果直接拔掉电源断电，可能会导致文件系统丢失某些数据，建议断电前先使用'''poweroff'''命令关闭开发板的Linux系统，然后再拔掉电源

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

|-

|

orangepi@orangepi:~$ '''sudo poweroff'''

|}

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

|-

|

<big>'''注意，关闭开发板后需要重新拔插电源才能开机。'''</big>

|}

</li>

<li>使用'''reboot'''命令即可重启开发板中的Linux系统

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

|-

|

orangepi@orangepi:~$ '''sudo''' '''reboot'''

|}

</li></ol>

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

== 编译系统需求 ==

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

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

|-

|

test@test:~$ '''lsb_release -a'''

No LSB modules are available.

Distributor ID: Ubuntu

Description: Ubuntu 22.04 LTS

Release: '''22.04'''

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 '''amd64'''版本的安装镜像下载地址为：

{| 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的软件源为清华源（或者其它你觉得速度快的国内源），不然后面安装软件的时候很容易由于网络原因而出错。替换清华源的步骤如下所示：

<li>替换清华源的方法参考这个网页的说明即可。

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

|-

|

[https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/ '''https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/''']

|}

</li></ol>

<li>注意Ubuntu版本需要切换到22.04。

[[File:zero3-img294.png]]</li>

<li>需要替换的'''/etc/apt/sources.list'''文件的内容为：

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

|-

|

test@test:~$ '''sudo mv /etc/apt/sources.list cat /etc/apt/sources.list.bak'''

test@test:~$ '''sudo vim /etc/apt/sources.list'''

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释

deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse

# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse

deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse

# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse

deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse

# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse

deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse

# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse

# 预发布软件源，不建议启用

# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse

# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse

|}

</li>

<li>替换完后需要更新下包信息，并确保没有报错。

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

|-

|

test@test:~$ '''sudo apt-get update'''

|}

</li>

<li>'''另外，由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。'''</li></ol>

== 获取linux sdk的源码 ==

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

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

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

|-

|

test@test:~$ '''sudo apt-get update'''

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

test@test:~$ '''git clone https://github.com/orangepi-xunlong/orangepi-build.git -b next'''

|}

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

|-

|

<big>'''注意，使用H618 Soc的开发板是需要下载orangepi-build的next分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。'''</big>

[[File:zero3-img295.png]]

|}

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

|-

|

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

|}

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

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

|-

| style="text-align: left;"| '''分支'''

| style="text-align: left;"| '''u-boot版本'''

| style="text-align: left;"| '''linux内核版本'''

|-

| style="text-align: left;"| '''current'''

| style="text-align: left;"| '''u-boot v2018.05'''

| style="text-align: left;"| '''linux5.4'''

|-

| style="text-align: left;"| '''next'''

| style="text-align: left;"| '''u-boot v2021.07'''

| style="text-align: left;"| '''linux6.1'''

|}

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

|-

|

<big>'''这里所说的分支和orangepi-build源代码的分支不是同一个东西，请不要搞混了。此分支主要是用来区分不同内核源码版本的。'''

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

|}

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

<li>'''build.sh''': 编译启动脚本</li>

<li>'''external''': 包含编译镜像需要用的配置文件、特定的脚本以及部分程序的源码等</li>

<li>'''LICENSE''': GPL 2许可证文件</li>

<li>'''README.md''': orangepi-build说明文件</li>

<li>'''scripts''': 编译linux镜像的通用脚本

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

|-

|

test@test:~/orangepi-build$ '''ls'''

'''build.sh    external    LICENSE    README.md    scripts'''

|}

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

|-

|

<big>'''如果是从github下载的orangepi-build的代码，下载完后你可能会发现orangepi-build中并没有包含u-boot和linux内核的源码，也没有编译u-boot和linux内核需要用到交叉编译工具链，这是正常的，因为这些东西都存放在其它单独的github仓库或者某些服务器上了（下文会详述其地址）。orangepi-build在脚本和配置文件中会指定u-boot、linux内核和交叉编译工具链的地址，运行orangepi-build时，当其发现本地没有这些东西，会自动去相应的地方下载的。'''</big>

|}

</li></ol>

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

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

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

</div>

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

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

|-

|

[https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/ '''https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/''']

|}

'''toolchains'''下载完后会包含多个版本的交叉编译工具链：

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

|-

|

test@test:~/orangepi-build$ '''ls toolchains/'''

gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu

gcc-linaro-4.9.4-2017.01-x86_64_aarch64-linux-gnu

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

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

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

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

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

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

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

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

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

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

|}

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

<li>linux5.4

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

|-

|

'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''

|}

</li>

<li>linux6.1

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

|-

|

'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''

|}

</li></ol>

编译H618 u-boot源码使用的交叉编译工具链为：

<li>v2018.05

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

|-

|

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

|}

</li>

<li>v2021.07

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

|-

|

'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''

|}

</li></ol>

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

<li>orangepi-build仓库下载完后并不包含linux内核、u-boot的源码以及交叉编译工具链，linux内核和u-boot的源码存放在独立的git仓库中

<li>linux内核源码存放的git仓库如下，注意切换linux-orangepi仓库的分支为

<li>a) Linux5.4

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

|-

|

https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-5.4-sun50iw9'''

|}

</li>

<li>b) Linux6.1

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

|-

|

https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-6.1-sun50iw9'''

|}

</li></ol>

</li>

<li>u-boot源码存放的git仓库如下，注意切换u-boot-orangepi仓库的分支为

<li>a) v2018.05

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

|-

|

https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2018.05-h618'''

|}

</li>

<li>b) v2021.07

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

|-

|

https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2021.07-sunxi'''

|}

</li></ol>

<li>orangepi-build第一次运行的时候会去下载交叉编译工具链、u-boot和linux内核源码，成功编译完一次linux镜像后在orangepi-build中可以看到的文件和文件夹有

<li>'''build.sh''': 编译启动脚本</li>

<li>'''external''': 包含编译镜像需要用的配置文件、特定功能的脚本以及部分程序的源码，编译镜像过程中缓存的rootfs压缩包也存放在external中</li>

<li>'''kernel''': 存放linux内核的源码</li>

<li>'''LICENSE''': GPL 2许可证文件</li>

<li>'''README.md''': orangepi-build说明文件</li>

<li>'''output''': 存放编译生成的u-boot、linux等deb包、编译日志以及编译生成的镜像等文件</li>

<li>'''scripts''': 编译linux镜像的通用脚本</li>

<li>'''toolchains''': 存放交叉编译工具链</li>

<li>'''u-boot''': 存放u-boot的源码</li>

<li>'''userpatches''': 存放编译脚本需要用到的配置文件

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

|-

|

test@test:~/orangepi-build$ '''ls'''

'''build.sh    external    kernel    LICENSE    output    README.md    scripts    toolchains    u-boot    userpatches'''

|}

</li></ol>

== 编译u-boot ==

<li>运行build.sh脚本，记得加sudo权限

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

|-

|

test@test:~/orangepi-build$ '''sudo ./build.sh'''

|}

</li>

<li>选择'''U-boot package'''，然后回车

[[File:zero3-img297.png]]

</div></li>

<li>接着选择开发板的型号

[[File:zero3-img298.png]]</li>

<li>然后选择u-boot的分支类型

<li>current分支会编译linux5.4镜像需要使用的u-boot v2018.05版本的代码</li>

<li>next分支会编译linux6.1镜像需要使用的u-boot v2021.07版本的代码

[[File:zero3-img299.png]]</li></ol>

</li>

<li>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择

<li>如果购买的开发板为1.5GB内存大小的，请选择第一项</li>

<li>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项

[[File:zero3-img299-1.png|1000px]]</li></ol>

</li>

<li>然后就会开始编译u-boot，编译next分支时提示的部分信息说明如下所示：

<li>u-boot源码的版本

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

|-

|

[ o.k. ] Compiling u-boot [ '''v2021.07''' ]

|}

</li>

<li>交叉编译工具链的版本

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

|-

|

[ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 11''' ]

|}

</li>

<li>编译生成的u-boot deb包的路径

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

|-

|

[ o.k. ] Target directory [ '''orangepi-build/output/debs/u-boot''' ]

|}

</li>

<li>编译生成的u-boot deb包的包名

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

|-

|

[ o.k. ] File name [ '''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb''' ]

|}

</li>

<li>编译使用的时间

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

|-

|

[ o.k. ] Runtime [ '''1 min''' ]

|}

</li>

<li>重复编译u-boot的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译u-boot

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

|-

|

[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=u-boot''' ]

|}

</li></ol>

</li>

<li>查看编译生成的u-boot deb包

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

|-

|

test@test:~/orangepi-build$ '''ls output/debs/u-boot/'''

'''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb'''

|}

</li>

<li>orangepi-bulid编译系统编译u-boot源码时首先会将u-boot的源码和github服务器的u-boot源码进行同步，所以如果想修改u-boot的源码，首先需要关闭源码的下载更新功能（'''需要完整编译过一次u-boot后才能关闭这个功能，否则会提示找不到u-boot的源码'''），否则所作的修改都会被还原，方法如下：

设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”

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

|-

|

test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''

......

IGNORE_UPDATES="'''yes'''"

......

|}

</li>

<li>调试u-boot代码时，可以使用下面的方法来更新linux镜像中的u-boot进行测试

<li>首先将编译好的u-boot的deb包上传到开发板的linux系统中

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

|-

|

test@test:~/orangepi-build$ '''cd output/debs/u-boot'''

test@test:~/orangepi_build/output/debs/u-boot$ '''scp \'''

'''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb root@192.168.1.xxx:/root'''

|}

</li>

<li>再安装刚才上传的新的u-boot的deb包

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

|-

|

orangepi@orangepi:~$ '''sudo dpkg -i''' '''linux-u-boot-next-orangepizero3_x.x.x_arm64.deb'''

|}

</li>

<li>然后运行 nand-sata-install脚本

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

|-

|

orangepi@orangepi:~$ '''sudo nand-sata-install'''

|}

</li>

<li>然后选择'''5 Install/Update the bootloader on SD/eMMC'''

[[File:zero3-img300.png]]</li>

<li>按下回车键后首先会弹出一个'''Warning'''

[[File:zero3-img301.png]]</li>

<li>再按下回车键就会开始更新u-boot，更新完后会显示下面的信息

[[File:zero3-img302.png]]</li>

<li>然后就可以重启开发板来测试u-boot的修改是否生效了</li></ol>

</li></ol>

== 编译linux内核 ==

<li>运行'''build.sh'''脚本，记得加sudo权限

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

|-

|

test@test:~/orangepi-build$ '''sudo ./build.sh'''

|}

</li>

<li>选择'''Kernel package'''，然后回车

[[File:zero3-img303.png]]

</div></li>

<li>然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个

[[File:zero3-img304.png]]</li>

<li>接着选择开发板的型号

[[File:zero3-img298.png]]</li>

<li>然后选择内核源码的分支类型

<li>current分支会编译linux5.4内核源码</li>

<li>next分支会编译linux6.1内核源码

[[File:zero3-img299.png]]</li></ol>

</li>

<li>如果第3)步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码。

[[File:zero3-img305.png]]</li></ol>

<li>如果不需要修改内核的配置选项，在运行build.sh脚本时，传入'''KERNEL_CONFIGURE=no'''就可临时屏蔽弹出内核的配置界面了

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

|-

|

test@test:~/orangepi-build$ '''sudo ./build.sh KERNEL_CONFIGURE=no'''

|}

</li>

<li>也可以设置orangepi-build/userpatches/config-default.conf配置文件中的'''KERNEL_CONFIGURE=no'''，这样可以永久禁用这个功能</li>

<li>编译内核的时候如果提示下面的错误，这是由于Ubuntu > PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu > PC的终端调到最大，然后重新运行build.sh脚本

[[File:zero3-img306.png]]</li></ol>

<li>编译next分支内核源码时提示的部分信息说明如下：

<li>linux内核源码的版本

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

|-

|

[ o.k. ] Compiling current kernel [ '''6.1.31''' ]

|}

</li>

<li>使用的交叉编译工具链的版本

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

|-

|

[ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 11''' ]

|}

</li>

<li>内核默认使用的配置文件以及它存放的路径如下所示

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

|-

|

[ o.k. ] Using kernel config file [ '''orangepi-build/external/config/kernel/linux-6.1-sun50iw9-next.config''' ]

|}

</li>

<li>编译生成的内核相关的deb包的路径

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

|-

|

[ o.k. ] Target directory [ '''output/debs/''' ]

|}

</li>

<li>编译生成的内核镜像deb包的包名

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

|-

|

[ o.k. ] File name [ '''linux-image-next-sun50iw9_x.x.x_arm64.deb''' ]

|}

</li>

<li>编译使用的时间

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

|-

|

[ o.k. ] Runtime [ '''10 min''' ]

|}

</li>

<li>最后会显示重复编译上一次选择的内核的编译命令，使用下面的命令无需通过图形界面选择，可以直接开始编译内核源码

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

|-

|

[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=kernel KERNEL_CONFIGURE=no''' ]

|}

</li></ol>

</li>

<li>查看编译生成的内核相关的deb包

<li>'''linux-dtb-next-sun50iw9_x.x.x_arm64.deb'''包含有内核使用的dtb文件</li>

<li>'''linux-headers-next-sun50iw9_x.x.x_arm64.deb'''包含内核头文件</li>

<li>'''linux-image-next-sun50iw9_x.x.x_arm64.deb'''包含内核镜像和内核模块

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

|-

|

test@test:~/orangepi-build$ '''ls output/debs/linux-*'''

output/debs/linux-dtb-next-sun50iw9_x.x.x_arm64.deb

output/debs/linux-headers-next-sun50iw9_x.x.x_arm64.deb

output/debs/linux-image-next-sun50iw9_x.x.x_arm64.deb

|}

</li></ol>

</li>

<li>orangepi-bulid编译系统编译linux内核源码时首先会将linux内核源码和github服务器的linux内核源码进行同步，所以如果想修改linux内核的源码，首先需要关闭源码的更新功能（'''需要完整编译过一次linux内核源码后才能关闭这个功能，否则会提示找不到linux内核的源码'''），否则所作的修改都会被还原，方法如下：

设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”

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

|-

|

test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''

IGNORE_UPDATES="'''yes'''"

|}

</li>

<li>如果对内核做了修改，可以使用下面的方法来更新开发板linux系统的内核和内核模块

<li>将编译好的linux内核的deb包上传到开发板的linux系统中

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

|-

|

test@test:~/orangepi-build$ '''cd output/debs'''

test@test:~/orangepi-build/output/debs$ '''scp \'''

'''linux-image-next-sun50iw9_x.x.x_arm64.deb root@192.168.1.xxx:/root'''

|}

</li>

<li>再安装刚才上传的新的linux内核的deb包

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

|-

|

orangepi@orangepi:~$ '''sudo dpkg -i linux-image-next-sun50iw9_x.x.x_arm64.deb'''

|}

</li>

<li>然后重启开发板，再查看内核相关的修改是否已生效

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

|-

|

orangepi@orangepi:~$ '''sudo''' '''reboot'''

|}

</li></ol>

== 编译rootfs ==

<li>运行build.sh脚本，记得加sudo权限

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

|-

|

test@test:~/orangepi-build$ '''sudo ./build.sh'''

|}

</li>

<li>选择'''Rootfs and all deb packages'''，然后回车</li>

[[File:zero3-img307.png]]

</div></ol>

<li>接着选择开发板的型号

[[File:zero3-img298.png]]</li>

<li>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别

<li>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</li>

<li>next分支可以看到debian11、debian12、ubuntu22.04三个选项

[[File:zero3-img299.png]]</li></ol>

</li>

<li>然后选择rootfs的类型

[[File:zero3-img308.png]]</li>

<li>然后选择镜像的类型

<li>'''Image with console interface (server)'''表示服务器版的镜像，体积比较小</li>

<li>'''Image with desktop environment'''表示带桌面的镜像，体积比较大

[[File:zero3-img309.png]]

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

</li>

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

[[File:zero3-img310.png]]

</div></li>

<li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面

[[File:zero3-img311.png]]

[[File:zero3-img312.png]]

然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。

[[File:zero3-img313.png]]</li>

<li>然后就会开始编译rootfs，编译时提示的部分信息说明如下

<li>rootfs的类型

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

|-

|

[ o.k. ] local not found [ Creating new rootfs cache for '''bullseye''' ]

|}

</li>

<li>编译生成的rootfs压缩包的存放路径

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

|-

|

[ o.k. ] Target directory [ '''orangepi-build/external/cache/rootfs''' ]

|}

</li>

<li>编译生成的rootfs压缩包的名字

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

|-

|

[ o.k. ] File name [ '''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4''' ]

|}

</li></ol>

</li>

<li>查看编译生成的rootfs压缩包

<li>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4'''是rootfs的压缩包，名字各字段的含义为

<li>a) '''bullseye'''表示rootfs的linux发行版的类型</li>

<li>b) '''xfce'''表示rootfs为桌面版的类型，如果为'''cli'''则表示服务器版类型</li>

<li>c) '''arm64'''表示rootfs的架构类型</li>

<li>d) '''25250ec7002de9e81a41de169f1f89721'''是由rootfs安装的所有软件包的包名生成的MD5哈希值，只要没有修改rootfs安装的软件包的列表，那么这个值就不会变，编译脚本会通过这个MD5哈希值来判断是否需要重新编译rootfs</li></ol>

</li>

<li>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list'''列出了rootfs安装的所有软件包的包名

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

|-

|

test@test:~/orangepi-build$ '''ls external/cache/rootfs/'''

bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4

bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.current

bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list

|}

</li></ol>

</li>

<li>如果需要的rootfs在'''external/cache/rootfs'''下已经存在，那么再次编译rootfs就会直接跳过编译过程，不会重新开始编译，编译镜像的时候也会去'''external/cache/rootfs'''下查找是否已经有缓存可用的rootfs，如果有就直接使用，这样可以节省大量的下载编译时间</li></ol>

== 编译linux镜像 ==

<li>运行'''build.sh'''脚本，记得加sudo权限

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

|-

|

test@test:~/orangepi-build$ '''sudo ./build.sh'''

|}

</li>

<li>选择'''Full OS image for flashing'''，然后回车</li>

[[File:zero3-img314.png]]

</div></ol>

<li>然后选择开发板的型号

[[File:zero3-img298.png]]</li>

<li>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别

<li>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</li>

<li>next分支可以看到debian11、debian12、ubuntu22.04三个选项

[[File:zero3-img299.png]]</li></ol>

</li>

<li>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择

<li>如果购买的开发板为1.5GB内存大小的，请选择第一项</li>

<li>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项

[[File:zero3-img299-1.png]]</li></ol>

</li>

<li>然后选择rootfs的类型

[[File:zero3-img308.png]]</li>

<li>然后选择镜像的类型

<li>'''Image with console interface (server)'''表示服务器版的镜像，体积比较小</li>

<li>'''Image with desktop environment'''表示带桌面的镜像，体积比较大

[[File:zero3-img309.png]]

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

</li>

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

[[File:zero3-img310.png]]

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

<li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面

[[File:zero3-img311.png]]

[[File:zero3-img312.png]]

然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。

[[File:zero3-img313.png]]</li></ol>

<li>然后就会开始编译linux镜像，编译的大致流程如下

<li>初始化Ubuntu PC的编译环境，安装编译过程需要的软件包</li>

<li>下载u-boot和linux内核的源码（如果已经缓存，则只更新代码）</li>

<li>编译u-boot源码，生成u-boot的deb包</li>

<li>编译linux源码，生成linux相关的deb包</li>

<li>制作linux firmware的deb包</li>

<li>制作orangepi-config工具的deb包</li>

<li>制作板级支持的deb包</li>

<li>如果是编译desktop版镜像，还会制作desktop相关的deb包</li>

<li>检查rootfs是否已经缓存，如果没有缓存，则重新制作rootfs，如果已经缓存，则直接解压使用</li>

<li>安装前面生成的deb包到rootfs中</li>

<li>对不同的开发板和不同类型镜像做一些特定的设置，如预装额外的软件包，修改系统配置等</li>

<li>然后制作镜像文件，并格式化分区，默认类型为ext4</li>

<li>再将配置好的rootfs拷贝到镜像的分区中</li>

<li>然后更新initramfs</li>

<li>最后将u-boot的bin文件通过dd命令写入到镜像中</li></ol>

</li>

<li>编译完镜像后会提示下面的信息

<li>编译生成的镜像的存放路径

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

|-

|

[ 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''' ]

|}

</li>

<li>编译使用的时间</li>

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

|-

|

'''[ o.k. ] Runtime [ 19 min ]'''

|}

<li>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像

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

|-

|

[ 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''' ]

|}

</li></ol>

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

== 已支持的Android版本 ==

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

|-

| style="text-align: left;"| Android版本

| style="text-align: left;"| 内核版本

|-

| style="text-align: left;"| '''Android 12 TV版'''

| style="text-align: left;"| '''linux5.4'''

|}

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

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

|-

| style="text-align: left;"| 功能

| style="text-align: left;"| Android12

|-

| style="text-align: left;"| HDMI视频

| style="text-align: left;"| OK

|-

| style="text-align: left;"| HDMI音频

| style="text-align: left;"| OK

|-

| style="text-align: left;"| USB2.0 x 3

| style="text-align: left;"| OK

|-

| style="text-align: left;"| TF卡启动

| style="text-align: left;"| OK

|-

| style="text-align: left;"| 网卡

| style="text-align: left;"| OK

|-

| style="text-align: left;"| 红外

| style="text-align: left;"| OK

|-

| style="text-align: left;"| WIFI

| style="text-align: left;"| OK

|-

| style="text-align: left;"| WIFI hotsport

| style="text-align: left;"| OK

|-

| style="text-align: left;"| 蓝牙

| style="text-align: left;"| OK

|-

| style="text-align: left;"| BLE蓝牙

| style="text-align: left;"| OK

|-

| style="text-align: left;"| 耳机音频

| style="text-align: left;"| OK

|-

| style="text-align: left;"| TV-OUT

| style="text-align: left;"| OK

|-

| style="text-align: left;"| USB摄像头

| style="text-align: left;"| OK

|-

| style="text-align: left;"| LED灯

| style="text-align: left;"| OK

|-

| style="text-align: left;"| 温度传感器

| style="text-align: left;"| OK

|-

| style="text-align: left;"| Mali GPU

| style="text-align: left;"| OK

|-

| style="text-align: left;"| 视频编解码

| style="text-align: left;"| OK

|}

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

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

|-

|

| style="text-align: left;"| '''绿灯'''

| style="text-align: left;"| '''红灯'''

|-

| '''u-boot启动阶段'''

| style="text-align: left;"| '''灭'''

| style="text-align: left;"| '''亮'''

|-

| '''内核启动到进入系统'''

| style="text-align: left;"| '''亮'''

| style="text-align: left;"| '''灭'''

|}

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

<li>我们一般都是使用鼠标和键盘来控制开发板的安卓系统，当进入某些界面，需要返回上一级界面或者桌面时，只能通过'''鼠标右键'''来返回，键盘是无法返回的</li>

<li>如果有购买开发板配套的红外遥控（其他遥控不行）和扩展板，将扩展板插入开发板后，还可以通过遥控中的返回键来返回上一级菜单，返回键的位置如下图所示

[[File:zero3-img315.png]]</li></ol>

== ADB的使用方法 ==

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

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

|-

|

<big>'''使用网络adb无需USB Typc C接口的数据线来连接电脑和开发板，而是通过网络来通信，所以首先请确保开发板的有线或者无线网络已经连接好了，然后获取开发板的IP地址，后面要用到。'''</big>

|}

<li>确保Android系统的'''service.adb.tcp.port'''设置为5555端口号

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

|-

|

apollo-p2:/ # '''getprop | grep "adb.tcp"'''

[service.adb.tcp.port]: [5555]

|}

</li>

<li>如果'''service.adb.tcp.port'''没有设置，可以在串口中使用下面的命令设置网络adb的端口号

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

|-

|

apollo-p2:/ # '''setprop service.adb.tcp.port 5555'''

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

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

|}

</li></ol>

<li>在Ubuntu PC上安装adb工具

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

|-

|

test@test:~$ '''sudo apt-get update'''

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

|}

</li>

<li>然后在Ubuntu PC上连接网络adb

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

|-

|

test@test:~$ '''adb connect 192.168.1.xxx:5555''' '''(需要修改为开发板的IP地址)'''

* daemon not running; starting now at tcp:5037

* daemon started successfully

connected to 192.168.1.xxx:5555

test@test:~$ '''adb devices'''

List of devices attached

192.168.1.xxx:5555 device

|}

</li>

<li>然后在Ubuntu PC上通过adb shell就可以登录android系统

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

|-

|

test@test:~$ '''adb shell'''

apollo-p2:/ #

|}

</li></ol>

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

<li>准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的电源接口中。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板

[[File:zero3-img15.png]]

</div></li>

<li>在Ubuntu PC上安装adb工具

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

|-

|

test@test:~$ '''sudo apt-get update'''

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

|}

</li>

<li>查看识别到ADB设备

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

|-

|

test@test:~$ '''adb devices'''

List of devices attached

4c00146473c28651dd0 device

|}

</li>

<li>然后在Ubuntu PC上通过adb shell就可以登录android系统

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

|-

|

test@test:~$ '''adb shell'''

apollo-p2:/ $

|}

</li></ol>

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

<li>首先进入'''Settings'''

[[File:zero3-img316.png]]</li>

<li>然后选择'''Device Preferences'''

[[File:zero3-img317.png]]</li>

<li>然后选择'''Display & Sound'''

[[File:zero3-img318.png]]</li>

<li>然后选择'''Advanced display settings'''

[[File:zero3-img319.png]]</li>

<li>然后选择'''HDMI output mode'''

[[File:zero3-img320.png]]</li>

<li>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。

[[File:zero3-img321.png]]</li>

<li>开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项

[[File:zero3-img322.png]]</li></ol>

== HDMI转VGA显示测试 ==

<li>首先需要准备下面的配件

<li>HDMI转VGA转换器

[[File:zero3-img146.png]]</li>

<li>一根VGA线和一根Micro HDMI公转HDMI母转接线

[[File:zero3-img147.png]] [[File:zero3-img148.png]]</li>

<li>一个支持VGA接口的显示器或者电视</li></ol>

</li>

<li>HDMI转VGA显示测试如下所示

[[File:zero3-img323.png]]

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

|-

|

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

|}

</li></ol>

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

<li>首先选择'''Settings'''

[[File:zero3-img316.png]]</li>

<li>然后选择'''Network & Internet'''

[[File:zero3-img324.png]]</li>

<li>然后打开WI-FI

[[File:zero3-img325.png]]</li>

<li>打开WI-FI后在'''Available networks'''下面就可以看到搜索到的信号

[[File:zero3-img326.png]]</li>

<li>选择想连接的WI-FI后会弹出下图所示的密码输入界面

[[File:zero3-img327.png]]

</div></li>

<li>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了

[[File:zero3-img328.png]]</li>

<li>WI-FI连接成功后的显示如下图所示

[[File:zero3-img329.png]]</li></ol>

== WI-FI hotspot的使用方法 ==

<li>首先请确保以太网口已连接网线，并且能正常上网</li>

<li>然后选择'''Settings'''

[[File:zero3-img316.png]]</li>

<li>然后选择'''Network & Internet'''

[[File:zero3-img324.png]]</li>

<li>然后选择'''WIFI hotspot'''

[[File:zero3-img330.png]]</li>

<li>然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）

[[File:zero3-img331.png]]</li>

<li>此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password'''下面可以看到

[[File:zero3-img332.png]]</li>

<li>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot'''能正常使用

[[File:zero3-img333.png]]</li></ol>

== 查看以太网口IP地址的方法 ==

<li>首先请确保开发板的千兆网口连接到了路由器或者交换机</li>

<li>然后打开'''Settings'''

[[File:zero3-img334.png]]</li>

<li>然后选择'''Network & Internet'''

[[File:zero3-img335.png]]</li>

<li>然后在下图所示的位置就能看到开发板有线网口的IP地址了

[[File:zero3-img336.png]]</li></ol>

== 蓝牙的连接方法 ==

<li>首先选择'''Settings'''

[[File:zero3-img316.png]]</li>

<li>然后选择'''Bluetooth'''

[[File:zero3-img337.png]]</li>

<li>然后打开'''Bluetooth Enable'''

[[File:zero3-img338.png]]</li>

<li>然后点击'''Pair new device'''开始扫描周围的蓝牙设备

[[File:zero3-img339.png]]</li>

<li>搜索到的蓝牙设备会在'''Available devices'''下面显示出来

[[File:zero3-img340.png]]</li>

<li>然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项

[[File:zero3-img341.png]]</li>

<li>这里测试的是开发板和'''安卓手机'''蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程

[[File:zero3-img342.png]]</li>

<li>配对完成后，再打开'''Paired devices'''下面就可以看到已配对的蓝牙设备

[[File:zero3-img343.png]]</li>

<li>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了

[[File:zero3-img344.png]]</li>

<li>开发板Android系统蓝牙接收到的图片可以打开'''Received files'''中查看

[[File:zero3-img345.png]]</li></ol>

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

<li>首先在开发板的USB接口中插入USB（UVC协议）摄像头</li>

<li>USB摄像头如果识别正常，在/dev下会生成相应的video设备节点

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

|-

|

console:/ # '''ls /dev/video0'''

/dev/video0

|}

</li>

<li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[Orange Pi Zero 3#ADB的使用方法|'''ADB的使用方法''']]一小节的说明</li>

<li>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP

[[File:zero3-img346.png]]

[[File:zero3-img347.png]]</li>

<li>然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装

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

|-

|

test@test:~$ '''adb install usbcamera.apk'''

|}

</li>

<li>安装完后在Android的桌面可以看到USB摄像头的启动图标

[[File:zero3-img348.png]]</li>

<li>然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了</li></ol>

== Android系统ROOT说明 ==

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

|-

|

<big>'''Orange Pi发布的Android系统已经ROOT，可以使用下面的方法来测试。'''</big>

|}

<li>在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''

[[File:zero3-img346.png]]

[[File:zero3-img349.png]]</li>

<li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l|'''ADB的使用方法''']]一小节的说明</li>

<li>然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装

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

|-

|

test@test:~$ '''adb install rootcheck.apk'''

|}

</li>

<li>安装完后在Android的桌面可以看到ROOT测试工具的启动图标

[[File:zero3-img350.png]]</li>

<li>第一次打开'''ROOT测试工具'''后的显示界面如下图所示

[[File:zero3-img351.png]]</li>

<li>然后就可以点击'''CHECK NOW'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限

[[File:zero3-img352.png]]</li></ol>

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

<li>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[Orange Pi Zero 3#WI-FI的连接方法|'''WI-FI的连接方法''']]一小节的说明</li>

<li>然后打开开发板安卓系统中的'''MiracastReceiver'''应用

[[File:zero3-img353.png]]</li>

<li>'''MiracastReceiver'''打开后的界面如下所示

[[File:zero3-img354.png]]

</div></li>

<li>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能

[[File:zero3-img355.png]]</li>

<li>等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可

[[File:zero3-img356.png]]</li>

<li>然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可

[[File:zero3-img357.png]]</li>

<li>然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了

[[File:zero3-img358-1.png]]</li></ol>

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

=== 26pin的GPIO口测试方法 ===

<li>首先在桌面中打开wiringOP APP

[[File:zero3-img359.png]]</li>

<li>然后点击'''GPIO_TEST'''按钮打开GPIO测试界面

[[File:zero3-img360.png]]</li>

<li>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮跟26pin引脚（'''左下角的PC1/PI16/PI6/PH10是13pin引脚中的GPIO口'''）是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平设置为低电平；当点击右边的'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息。

[[File:zero3-img361.png]]</li>

<li>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：

[[File:zero3-img362.png]]

</div></li>

<li>开发板26pin中总共有17个GPIO口可以使用（'''如果加上13pin中的4个GPIO口，那么总共就是有21个'''），下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平。首先点击7号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，7号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功

[[File:zero3-img363.png]]</li>

<li>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为'''OUT'''，引脚电平为高电平

[[File:zero3-img364.png]]</li>

<li>再次点击下图的'''CheckBox'''按钮取消勾选状态，7号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功

[[File:zero3-img365.png]]</li>

<li>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为OUT，引脚电平为低电平

[[File:zero3-img366.png]]</li></ol>

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

<li>Android中默认打开了'''UART5'''，对应的设备节点为'''/dev/ttyAS5'''

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

|-

|

apollo-p2:/ # '''ls /dev/ttyAS5'''

/dev/ttyAS5

|}

</li>

<li>首先在桌面中打开wiringOP APP

[[File:zero3-img359.png]]</li>

<li>然后点击'''UART_TEST'''按钮打开UART测试界面

[[File:zero3-img367.png]]</li>

<li>wiringOP的串口测试界面如下图所示</li>

[[File:zero3-img368.png]]

</ol>

<li>然后在选择框中选择'''/dev/ttyAS5'''节点

[[File:zero3-img369.png]]</li>

<li>再在编辑框中输入想要设置的波特率，然后点击'''OPEN'''按钮打开'''/dev/ttyAS5'''节点，打开成功后，'''OPEN'''按钮变为不可选中状态，'''CLOSE'''按钮和'''SEND'''按钮变为可选中状态</li>

[[File:zero3-img370.png]]

</ol>

<li>然后使用杜邦线短接uart5的rx和tx引脚</li>

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

|-

|

| style="text-align: left;"| uart5

|-

| tx引脚

| style="text-align: left;"| 对应26pin的8号引脚

|-

| rx引脚

| style="text-align: left;"| 对应26pin的10号引脚

|}

</ol>

<li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li>

[[File:zero3-img371.png]]

</ol>

<li>如果一切正常，接收框内会显示已接收到的字符串</li>

[[File:zero3-img372.png]]

</ol>

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

<li>26pin中可以用的SPI为SPI1，对应的设备节点为'''/dev/spidev1.1'''

[[File:zero3-img359.png]]</li>

<li>这里演示下通过'''w25q64'''模块来测试SPI1接口，首先在SPI1接口接入w25q64模块

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

|-

|

<big>'''如果没有 w25q64 模块也没关系，因为开发板上有一个SPIFlash接在了SPI0上，在安卓中SPI0的配置默认也打开了，所以我们也可以直接使用板载的SPIFlash测试。'''</big>

|}

</li></ol>

<li>然后在桌面中打开wiringOP APP</li>

<li>然后点击'''SPI_TEST'''按钮打开SPI的测试界面

[[File:zero3-img373.png]]</li>

<li>然后在左上角选择spi的设备节点，如果直接测试板载的SPIFlash，那么保持默认的'''/dev/spidev0.0'''即可，如果在26pin的spi1上接了'''w25q64'''模块，那么就请选择'''/dev/spidev1.1'''

[[File:zero3-img374.png]]</li>

<li>然后点击'''OPEN'''按钮初始化SPI</li>

[[File:zero3-img375.png]]

</ol>

<li>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮

[[File:zero3-img376.png]]</li>

<li>最后APP会显示读取到的板载SPI Flash的ID信息</li>

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

</ol>

<li>如果是读取接在26pin SPI1上的w25q64模块，那么读取到的ID信息如下图所示

[[File:zero3-img378.png]]</li>

<li>w25q64模块的MANUFACTURER ID为EFh，Device ID为4017h，跟上面读取到的值是对应的（h代表是16进制）

[[File:zero3-img379.png]]</li></ol>

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

<li>Android中默认打开了26pin中的i2c3，对应的设备节点为'''/dev/i2c-3'''

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

|-

|

apollo-p2:/ # '''ls /dev/i2c-3'''

/dev/i2c-3

|}

</li>

<li>首先在桌面中打开wiringOP APP

[[File:zero3-img359.png]]</li>

<li>然后点击'''I2C_TEST'''按钮打开i2c的测试界面

[[File:zero3-img380.png]]</li>

<li>wiringOP的i2c测试界面如下图所示，可以看到默认使用的i2c为'''/dev/i2c-3'''，所以我们无需重新选择了</li>

[[File:zero3-img381.png]]

</ol>

<li>然后在26pin的i2c3引脚上接一个i2c设备，这里以ds1307 rtc模块为例

[[File:zero3-img186.png]]</li>

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

|-

| style="text-align: left;"| '''RTC模块的引脚'''

| style="text-align: left;"| '''开发板26pin对应的引脚'''

|-

| style="text-align: left;"| '''5V'''

| style="text-align: left;"| '''2号引脚'''

|-

| style="text-align: left;"| '''GND'''

| style="text-align: left;"| '''6号引脚'''

|-

| style="text-align: left;"| '''SDA'''

| style="text-align: left;"| '''3号引脚'''

|-

| style="text-align: left;"| '''SCL'''

| style="text-align: left;"| '''5号引脚'''

|}

</ol>

<li>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 3'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如下图所示，如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。

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

|-

|

apollo-p2:/ # '''i2cdetect -y 3'''

|}

[[File:zero3-img382.png]]</li>

<li>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c3

[[File:zero3-img383.png]]</li>

<li>点击'''OPEN'''按钮打开i2c3后的显示如下所示：

[[File:zero3-img384.png]]</li>

<li>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55

<li>我们首先设置需要写入的寄存器的地址为0x1c

[[File:zero3-img385.png]]</li>

<li>然后设置需要写入的值为0x55

[[File:zero3-img386.png]]</li>

<li>然后点击'''WRITE BYTE'''按钮执行写入的动作

[[File:zero3-img387.png]]</li></ol>

</li>

<li>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过

[[File:zero3-img388.png]]</li></ol>

= '''附录''' =

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

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

|-

| style="text-align: left;"| '''版本'''

| style="text-align: left;"| '''日期'''

| style="text-align: left;"| '''更新说明'''

|-

| style="text-align: left;"| v1.0

| style="text-align: left;"| 2023-07-10

| style="text-align: left;"| 初始版本

|}

== 镜像更新历史 ==

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

|-

| '''日期'''

| '''更新说明'''

|-

| 2023-07-10

| Orangepizero3_1.0.0_ubuntu_jammy_server_linux5.4.125.7z

Orangepizero3_1.0.0_debian_bullseye_server_linux5.4.125.7z

Orangepizero3_1.0.0_ubuntu_focal_desktop_xfce_linux5.4.125.7z

Orangepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux5.4.125.7z

Orangepizero3_1.0.0_debian_bullseye_desktop_xfce_linux5.4.125.7z

Orangepizero3_1.0.0_ubuntu_jammy_server_linux6.1.31.7z

Orangepizero3_1.0.0_debian_bookworm_server_linux6.1.31.7z

Orangepizero3_1.0.0_debian_bullseye_server_linux6.1.31.7z

~~<ol start="8" style="list-style-type: decimal;"><li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li></ol>~~Orangepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux6.1.31.7z

~~[[File:media/image371~~Orangepizero3_1.~~png|376x189px]]~~0.0_debian_bookworm_desktop_xfce_linux6.1.31.7z

~~<ol start="9" style="list-style-type: decimal;"><li>如果一切正常，接收框内会显示已接收到的字符串</li></ol>~~Orangepizero3_1.0.0_debian_bullseye_desktop_xfce_linux6.1.31.7z

~~[[File:media/image372.png|382x196px]]~~

~~=== 26pin的SPI测试方法 ===~~ ~~<ol style="list-style-type: decimal;"><li>26pin中可以用的SPI为SPI1，对应的设备节点为'''/dev/spidev1.1'''[[File:media/image359.png|576x133px]]</li><li>这里演示下通过'''w25q64'''模块来测试SPI1接口，首先在SPI1接口接入w25q64模块</li></ol>~~ '''如果没有w25q64模块也没关系，因为开发板上有一个SPIFlash接在了SPI0上，在安卓中SPI0的配置默认也打开了，所以我们也可以直接使用板载的SPIFlash测试。''' ~~<ol start="3" style="list-style-type: decimal;"><li>然后在桌面中打开wiringOP APP</li><li>然后点击'''SPI_TEST'''按钮打开SPI的测试界面[[File:media/image373.png|518x96px]]</li><li>然后在左上角选择spi的设备节点，如果直接测试板载的SPIFlash，那么保持默认的'''/dev/spidev0~~OrangePi_Zero3_Android12_v1.0~~'''即可，如果在26pin的spi1上接了'''w25q64'''模块，那么就请选择'''/dev/spidev1.1'''[[File:media/image374.png|296x135px]]</li><li>然后点击'''OPEN'''按钮初始化SPI</li></ol>~~ ~~[[File:media/image375.png|295x168px]]~~ ~~<ol start="7" style="list-style-type: decimal;"><li>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮[[File:media/image376.png|294x169px]]</li><li>最后APP会显示读取到的板载SPI Flash的ID信息</li></ol>~~ ~~[[File:media/image377.png|299x217px]]~~ ~~<ol start="9" style="list-style-type: decimal;"><li>如果是读取接在26pin SPI1上的w25q64模块，那么读取到的ID信息如下图所示[[File:media/image378.png|302x201px]]</li><li>w25q64模块的MANUFACTURER ID为EFh，Device ID为4017h，跟上面读取到的值是对应的（h代表是16进制）[[File:media/image379.png|336x113px]]</li></ol>~~ ~~=== 26pin的I2C测试方法 ===~~ ~~<ol style="list-style-type: decimal;"><li>Android中默认打开了26pin中的i2c3，对应的设备节点为'''/dev/i2c-3'''apollo-p2:/ # '''ls /dev/i2c-3'''/dev/i2c-3</li><li>首先在桌面中打开wiringOP APP[[File:media/image359.png|576x133px]]</li><li>然后点击'''I2C_TEST'''按钮打开i2c的测试界面[[File:media/image380.png|506x110px]]</li><li>wiringOP的i2c测试界面如下图所示，可以看到默认使用的i2c为'''/dev/i2c-3'''，所以我们无需重新选择了</li></ol>~~ ~~[[File:media/image381.png|353x159px]]~~ ~~<ol start="5" style="list-style-type: decimal;"><li>然后在26pin的i2c3引脚上接一个i2c设备，这里以ds1307 rtc模块为例[[File:media/image186.png|121x103px]]</li></ol>~~ ~~{| class="wikitable"~~|-~~| style="text-align: left;"| '''RTC模块的引脚'''| style="text-align: left;"| '''开发板26pin对应的引脚'''~~|-~~| style="text-align: left;"| '''5V'''| style="text-align: left;"| '''2号引脚'''~~|-~~| style="text-align: left;"| '''GND'''| style="text-align: left;"| '''6号引脚'''~~|-~~| style="text-align: left;"| '''SDA'''| style="text-align: left;"| '''3号引脚'''~~|-~~| style="text-align: left;"| '''SCL'''| style="text-align: left;"| '''5号引脚'''~~|} ~~<ol start="6" style="list-style-type: decimal;">~~<li>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 3'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如下图所示，如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。~~apollo-p2:/ # '''i2cdetect -y 3'''[[File:media/image382~~.~~png|424x186px]]</li><li>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c3[[File:media/image383~~tar.~~png|354x177px]]</li><li>点击'''OPEN'''按钮打开i2c3后的显示如下所示：[[File:media/image384.png|355x171px]]</li><li>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55<ol style="list-style-type: lower-alpha;"><li>我们首先设置需要写入的寄存器的地址为0x1c[[File:media/image385.png|322x152px]]</li><li>然后设置需要写入的值为0x55[[File:media/image386.png|315x177px]]</li><li>然后点击'''WRITE BYTE'''按钮执行写入的动作[[File:media/image387.png|314x173px]]</li></ol></li><li>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过[[File:media/image388.png|316x170px]]</li></ol>~~ ~~= '''附录''' =~~ ~~== 用户手册更新历史 ==~~ ~~{| class="wikitable"~~|-~~| style="text-align: left;"| '''版本'''| style="text-align: left;"| '''日期'''| style="text-align: left;"| '''更新说明'''~~|-~~| style="text-align: left;"| v1.0| style="text-align: left;"| 2023-07-05| style="text-align: left;"| 初始版本~~|} ~~== 镜像更新历史 ==~~gz

~~{| class="wikitable"~~

|-

| * *日期**

~~| '''更新说明'''~~

|-

~~| 202 3-07-05~~

~~| Orangepizero3_1.0.0_ubuntu_jammy_server_linux5.4.125.7z~~

~~Orangepizero3_1.0.0_debian_bullseye_server_linux5.4.125.7z~~

~~Ora ngepizero3_1.0.0_ubuntu_focal_desktop_xfce_linux5.4.125.7z~~

~~Ora ngepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux5.4.125.7z~~

~~Orange pizero3_1.0.0_debian_bullseye_desktop_xfce_linux5.4.125.7z~~

~~Orangepizero3_1.0.0_ubuntu_jammy_server_linux6.1.31.7z~~

~~Orangepizero3_1.0.0_debian_bookworm_server_linux6.1.31.7z~~

~~Orangepizero3_1.0.0_debian_bullseye_server_linux6.1.31.7z~~

~~Or angepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux6.1.31.7z~~

~~Orang epizero3_1.0.0_debian_bookworm_desktop_xfce_linux6.1.31.7z~~

~~Orang epizero3_1.0.0_debian_bullseye_desktop_xfce_linux6.1.31.7z~~

~~OrangePi_Zero3_Android12_v1.0.tar.gz~~

* 初始版本

|}

Admin

行政员、管理员

8,460

个编辑

更改

Orange Pi Zero 3

导航菜单

个人工具

名字空间

变种

视图

更多

搜索

导航

产品

常见问题

镜像资源

支持

工具