8,460
个编辑
更改
→缩小TF卡中rootfs分区容量的方法
|-
| WIFI+蓝牙
| • AW859A芯片、支持IEEE 5622芯片、支持IEEE 802.11 a/b/g/n/ac、BT5.0
|-
| 视频输出
<big>'''顶层视图：'''</big><br>
[[File:media/image3zero3-img3-1.png|390x329px]]
<big>'''底层视图：'''</big><br>
[[File:media/image4zero3-img4-1.png|494x292px]]
<span id="orange-pi-zero-3的接口详情图"></span>
== Orange Pi Zero 3的接口详情图 ==
[[File:media/image5zero3-img5-1.png|576x782px800px]]
[[File:media/image6zero3-img6.png|575x227px800px]]
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<ol style="list-style-type: decimal;">
<li><p>TF卡，最小8GB容量的'''class10'''级或以上的高速闪迪卡</p>
<p>[[File:media/image7zero3-img7.png|124x96px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>'''使用其他品牌的TF卡（非闪迪的TF卡），如下图所示（包含但不仅限这些卡），已经有朋友反馈系统启动过程中会出现问题，比如系统启动到一半卡住不动，或者reboot命令无法正常使用，最后都是换了闪迪牌的TF卡后才解决的。所以如果您使用的是非闪迪牌的TF卡发现系统启动或者使用过程有问题，请更换闪迪牌的TF卡后再测试。'''</p></big>
<p>[[File:media/image8zero3-img8-1.png|103x85px180px]][[File:media/image9zero3-img9-1.png|112x85px195px]][[File:media/image10zero3-img10-1.png|114x85px198px]][[File:media/image11zero3-img11-1.png|86x109px190px]]</p><pstyle="text-align: center;">'''目前反馈在Orange Pi Zero 3上启动有问题的部分TF卡'''</p>
<big><p>'''另外，在其他型号的开发板上能正常使用的TF卡并不能保证在Orange Pi Zero 3上也一定能正常启动，这点请特别注意。'''</p></big>
|}
</li>
<li><p>TF卡读卡器，用于读写TF卡</p>
<p>[[File:media/image12zero3-img12.png|139x96px]]</p></li>
<li><p>Micro HDMI转HDMI连接线，用于将开发板连接到HDMI显示器或者电视进行显示</p>
<div class="figure">
[[File:media/image13zero3-img13.jpeg|209x209px|IMG_6109(20211221-181051)png]]
</div>
|
<big><p>'''注意，请不要使用下图所示的这种比较宽的Micro HDMI转接头，由于开发板的Micro HDMI接口和Type-C电源接口之间的间距比较小，可能会导致两者无法同时插入到开发板。'''</p></big>
<p>[[File:zero3-img14.png|center]]</p>
|}
<li><p>电源，如果有5V/2A或5V/3A的电源头那就只需要准备一根下面左边图片所示的USB转Type C接口的数据线，另外也可以使用类似下面右边图片所示的线和电源头一体的5V/2A或者5V/3A的高品质USB Typc C接口电源适配器。</p>
<p>[[File:media/image15zero3-img15.jpegpng|172x172px|IMG_4194(20201104-125502)600px]] [[File:media/image16zero3-img16.jpegpng|173x173px|IMG_6179(20220116-151727)600px]]</p></li>
<li><p>13pin扩展板</p>
<ol style="list-style-type: lower-alpha;">
<li><p>扩展板实物如下所示</p>
<p>[[File:media/image17zero3-img17.png|285x166px]]</p></li>
<li><p>扩展板插入开发板的方式如下所示，切记不要插反了</p>
<p>[[File:media/image18zero3-img18.png|246x162px]]</p></li>
<li><p>Orange Pi Zero 3开发板上的13pin排针可以接上扩展板来扩展开发板上没有的功能，扩展板可以使用的功能有</p>
<ol start="4" style="list-style-type: lower-alpha;">
<li><p>Orange Pi Zero 3开发板13pin排针的原理图如下所示</p>
<p>[[File:media/image19zero3-img19.png|264x142px]]</p></li></ol>
</ol>
<!-- -->
<li><p>USB接口的鼠标和键盘，只要是标准USB接口的鼠标和键盘都可以，鼠标和键盘可以用来控制Orange Pi开发板</p></li>
<li><p>红外遥控器，主要用于控制安卓TV系统</p>
<p>[[File:media/image20zero3-img20.png|209x196px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<li><p>百兆或者千兆网线，用于将开发板连接到因特网</p></li>
<li><p>AV视频线，如果希望通过AV接口而不是HDMI接口来显示视频，那么就需要通过AV视频线将开发板连接到电视</p>
<p>[[File:media/image21zero3-img21.png|200x177px]]</p></li>
<li><p>散热片，如果担心开发板的温度过高，可以加个散热片，散热片贴在H618芯片上即可</p>
<p>[[File:media/image22zero3-img22.png|171x140px]] [[File:media/image23zero3-img23-1.png|151x147px]]</p></li>
<li><p>5V的散热风扇，如下图所示，开发板的26pin和13pin接口上都有5V和GND引脚可以接散热风扇，26pin和13pin排针的间距为'''2.54mm'''，散热风扇的电源接口参照这个规格去购买即可。</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<big><p>'''注意，开发板插上电源后5V引脚就可以直接使用，无需其他设置，另外5V引脚输出的电压是无法通过软件调节和关闭的。'''</p></big>
|}
<p>[[File:media/image24zero3-img24-1.png|212x226px]]</p></li>
<li><p>配套外壳'''（待添加图片）'''</p></li>
<li><p>USB转TTL模块和杜邦线，使用串口调试功能时，需要USB转TTL模块和杜邦线来连接开发板和电脑</p>
<p>[[File:media/image25zero3-img25.png|176x145px]] [[File:media/image26zero3-img26.png|305x110px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<ol start="5" style="list-style-type: decimal;">
<li><p>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方</p>
<p>[[File:media/image27zero3-img27.png|456x219px]]</p></li>
<li><p>然后可以选择下载balenaEtcher的Portable版本的软件，Portable版本无需安装，双击打开就可以使用</p>
<p>[[File:media/image28zero3-img28.png|468x173px]]</p></li>
<li><p>如果下载的是需要安装版本的balenaEtcher，请先安装再使用。如果下载的Portable版本balenaEtcher，直接双击打开即可，打开后的balenaEtcher界面如下图所示</p>
<p>[[File:media/image29zero3-img29.png|335x211px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<big>'''打开balenaEtcher时如果提示下面的错误：'''</big>
[[File:media/image30zero3-img30.png|206x162pxcenter]]
<big>'''请选择balenaEtcher后点击右键，然后选择以管理员身份运行。'''</big>
[[File:media/image31zero3-img31.png|114x37pxcenter]]
|}
</li></ol>
<li><p>然后选择TF卡的盘符</p></li>
<li><p>最后点击Flash就会开始烧录Linux镜像到TF卡中</p>
<p>[[File:media/image32zero3-img32.png|501x281px]]</p></li></ol>
</li>
<li><p>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中</p>
<p>[[File:media/image33zero3-img33.png|506x317px]]</p></li>
<li><p>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验</p>
<p>[[File:media/image34zero3-img34.png|519x325px]]</p></li>
<li><p>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了</p>
<p>[[File:media/image35zero3-img35.png|523x324px]]</p></li></ol>
<span id="使用win32diskimager烧录linux镜像的方法"></span>
<div class="figure">
[[File:media/image36zero3-img36.png|209x228px|选区_199]]
</div></li>
<li><p>然后点击”'''Format'''”，格式化前会弹出一个警告框，选择”'''是(Y)'''”后就会开始格式化</p></li>
[[File:media/image37zero3-img37.png|304x147px]]
</ol>
<ol start="5" style="list-style-type: lower-alpha;">
<li><p>格式化完TF卡后会弹出下图所示的信息，点击确定即可</p>
<p>[[File:media/image38zero3-img38.png|186x149px]]</p></li></ol>
</li></ol>
<!-- -->
<li><p>b) 然后确认下TF卡的盘符和”'''设备'''”一栏中显示的一致</p></li>
<li><p>c) 最后点击”'''写入'''”即可开始烧录</p>
<p>[[File:media/image39zero3-img39.png|297x206px]]</p></li></ol>
</li>
<li><p>镜像写入完成后，点击”'''退出'''”按钮退出即可，然后就可以拔出TF卡插到开发板中启动</p></li></ol>
<ol start="4" style="list-style-type: decimal;">
<li><p>进入balenaEtcher下载页面后，点击绿色的下载按钮会跳到软件下载的地方</p>
<p>[[File:media/image27zero3-img27.png|489x235px]]</p></li>
<li><p>然后选择下载Linux版本的软件即可</p>
<p>[[File:media/image40zero3-img40.png|485x184px]]</p></li>
<li><p>从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']下载想要烧录的Linux操作系统镜像文件压缩包，然后使用解压软件解压，解压后的文件中，以”'''.img'''”结尾的文件就是操作系统的镜像文件，大小一般都在1GB以上。7z结尾的压缩包的解压命令如下所示：</p>
{| class="wikitable" style="width:800px;"
</li>
<li><p>然后在Ubuntu PC的图形界面双击'''balenaEtcher-1.14.3-x64.AppImage'''即可打开balenaEtcher（'''无需安装'''），balenaEtcher打开后的界面显示如下图所示</p>
<p>[[File:media/image41zero3-img41.png|423x251px]]</p></li>
<li><p>使用balenaEtcher烧录Linux镜像的具体步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>然后选择TF卡的盘符</p></li>
<li><p>最后点击Flash就会开始烧录Linux镜像到TF卡中</p>
<p>[[File:media/image42zero3-img42.png|431x278px]]</p></li></ol>
</li>
<li><p>balenaEtcher烧录Linux镜像的过程显示的界面如下图所示，另外进度条显示紫色表示正在烧录Linux镜像到TF卡中</p>
<p>[[File:media/image43zero3-img43.png|576x247px]]</p></li></ol>
<!-- -->
<ol start="11" style="list-style-type: decimal;">
<li><p>Linux镜像烧录完后，balenaEtcher默认还会对烧录到TF卡中的镜像进行校验，确保烧录过程没有出问题。如下图所示，显示绿色的进度条就表示镜像已经烧录完成，balenaEtcher正在对烧录完成的镜像进行校验</p>
<p>[[File:media/image44zero3-img44.png|576x252px]]</p></li>
<li><p>成功烧录完成后balenaEtcher的显示界面如下图所示，如果显示绿色的指示图标说明镜像烧录成功，此时就可以退出balenaEtcher，然后拔出TF卡插入到开发板的TF卡槽中使用了</p>
<p>[[File:media/image45zero3-img45.png|576x340px]]</p></li></ol>
<span id="烧写android镜像到tf卡的方法"></span>
|-
|
<big>'''开发板的Android镜像只能在Windows平台下使用PhoenixCard软件烧录到TF卡中，PhoenixCard软件的版本必须为PhonixCard开发板的Android镜像只能在Windows平台下使用<span style="color:#FF0000">PhoenixCard</span>软件烧录到TF卡中，PhoenixCard软件的版本必须为<span style="color:#FF0000">PhonixCard-4.2.8。8</span>。'''
'''请不要用烧录Linux镜像的软件，如Win32Diskimager或者balenaEtcher来烧录安卓镜像。'''
<ol style="list-style-type: decimal;">
<li><p>首先请确保Windows系统已经安装了'''Microsoft Visual C++ 2008 Redistrbutable - x86'''</p>
<p>[[File:media/image46zero3-img46.png|449x293px]]</p></li>
<li><p>如果没有安装'''Microsoft Visual C++ 2008 Redistrbutable - x86'''，使用'''PhoenixCard'''格式化TF卡或者烧录Android镜像会提示下面的错误</p>
<div class="figure">
[[File:media/image47zero3-img47.png|522x395px|NUQB$Q%(){1CV6M6WK4N`5J]]
</div></li>
<li><p>'''Microsoft Visual C++ 2008 Redistrbutable - x86'''的安装包可以从Orange Pi Zero 3的[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''官方工具''']中下载到，也可以去[https://www.microsoft.com/zh-cn/download/details.aspx?id=26368 '''微软官网''']下载</p>
<p>[[File:media/image48zero3-img48.png|240x93px]] [[File:media/image49zero3-img49.png|200x95px]]</p></li>
<li><p>然后准备一张8GB或更大容量的TF卡，TF卡的传输速度必须为'''class10'''级或'''class10'''级以上，建议使用闪迪等品牌的TF卡</p></li>
<li><p>然后使用读卡器把TF卡插入电脑</p></li>
<li><p>从[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-3.html '''Orange Pi的资料下载页面''']下载Android镜像和PhoenixCard烧写工具，请确保PhonenixCrad工具的版本为'''<span style="color:#FF0000">PhonixCard-4.2.8，请不要用低于4.2.8版本的PhonixCard软件来烧录Android镜像，</span>'''低于这个版本的PhonixCard工具烧写的Android镜像可能会有问题</p>
<p>[[File:media/image50zero3-img50.png|575x169px]]</p></li>
<li><p>然后使用解压软件解压下载的Android镜像的压缩包，解压后的文件中，以”'''.img'''” 结尾的文件就是Android镜像文件，大小在1GB以上。如果不知道怎么解压Android镜像的压缩包，可以安装一个[https://yasuo.360.cn/ '''360压缩软件''']来解压镜像。</p>
<p>[[File:media/image51zero3-img51.png|438x158px]]</p></li>
<li><p>然后使用解压软件解压'''PhonixCard4.2.8.zip'''，此软件无需安装，在解压后的文件夹中找到PhoenixCard打开即可</p>
<p>[[File:media/image52zero3-img52.png|576x113px]]</p></li>
<li><p>打开PhoenixCard后，如果TF卡识别正常，会在中间的列表中显示TF卡的盘符和容量，'''<span style="color:#FF0000">请务必确认显示的盘符和你想烧录的TF卡的盘符是一致的</span>'''，如果没有显示可以尝试拔插下TF卡，或者点击PhoenixCard中的”'''刷新盘符'''”按钮</p></li>
[[File:media/image53zero3-img53-1.png|575x137px]]
</ol>
<ol start="10" style="list-style-type: decimal;">
<li><p>确认完盘符后，先格式化TF卡，点击PhoenixCard中”'''恢复卡'''”按钮即可（如果”'''恢复卡'''”按钮为灰色的无法按下，可以先点击下”'''刷新盘符'''”按钮）</p>
<p>[[File:media/image54zero3-img54-1.png|575x316px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<li><p>在”'''制作卡的种类'''”中选择”'''启动卡'''”</p></li>
<li><p>然后点击”'''烧卡'''”按钮就会开始烧录</p>
<p>[[File:media/image55zero3-img55-1.png|576x402px]]</p></li></ol>
</li>
<li><p>烧录完后PhoenixCard的显示如下图所示，此时点击”'''关闭'''”按钮即可退出PhoenixCard，然后就可以把TF卡从电脑中拔出来插到开发板中启动了</p>
<p>[[File:media/image56zero3-img56-1.png|575x354px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>'''烧录完Android系统后在Windows中TF卡只能看到一个128 MB的分区，显示的分区如下图所示（有些电脑可能会弹出二十几个磁盘分区，但也只能打开128 MB的那个分区），请注意，这是正常的，请不要以为TF卡烧坏了。之所以这样，是因为安卓系统总共有二十几个分区，但大部分分区在Windows系统中是无法正常识别的。此时，请放心的拔下TF卡然后插入开发板中启动即可。'''</p></big>
<p>[[File:media/image57zero3-img57.png|193x45pxcenter]]</p>
<big><p>'''安卓系统启动后，使用下面的命令可以看到TF卡中的这二十几个分区：'''</p></big>
<p>[[File:media/image58zero3-img58.png|368x131pxcenter]]</p>
<big><p>'''使用df -h命令可以看到16GB的TF卡烧录完安卓系统后大概还有11 GB的空间可以用使用（二十几个分区并不会都挂载到安卓系统中，重点关注这些能看到的分区即可）。'''</p></big>
<p>[[File:media/image59zero3-img59.png|391x220pxcenter]]</p>
|}
</li></ol>
开发板上有一个16MB大小的SPI Flash，其所在位置如下图所示：
[[File:media/image60zero3-img60-1.png|285x185px]]
SPI Flash中默认烧录有一个微型的linux系统，此系统主要用于证明开发板是能正常启动的。当拿到开发板后，不用烧录系统到TF卡中，只需要给开发板接上Type-C电源就能启动SPI Flash中的微型linux系统。此系统的主要功能有：
<ol style="list-style-type: decimal;">
<li><p>首先需要准备一个'''3.3v'''的USB转TTL模块，然后将USB转TTL模块的USB接口一端插入到电脑的USB接口中</p>
<p>[[File:media/image61zero3-img61.png|575x245px]]</p></li>
<li><p>开发板的调试串口GND、TX和RX引脚的对应关系如下图所示</p>
<p>[[File:media/image62zero3-img62-1.png|328x185px]]</p></li>
<li><p>USB转TTL模块GND、TX和RX引脚需要通过杜邦线连接到开发板的调试串口上</p>
<ol style="list-style-type: lower-alpha;">
</li>
<li><p>USB转TTL模块连接电脑和Orange Pi开发板的示意图如下所示</p>
<p>[[File:media/image63zero3-img63.png|576x208px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
</li>
<li><p>执行putty命令后会弹出下面的界面</p>
<p>[[File:media/image64zero3-img64.png|332x290px]]</p></li>
<li><p>首先选择串口的设置界面</p>
<p>[[File:media/image65zero3-img65.png|337x297px]]</p></li>
<li><p>然后设置串口的参数</p>
<ol style="list-style-type: lower-alpha;">
<li><p>设置'''Speed(baud)'''为'''115200'''（串口的波特率）</p></li>
<li><p>设置'''Flow control'''为'''None'''</p>
<p>[[File:media/image66zero3-img66.png|398x352px]]</p></li></ol>
</li>
<li><p>在串口的设置界面设置完后，再回到Session界面</p>
<li><p>首先选择'''Connection type'''为'''Serial'''</p></li>
<li><p>然后点击'''Open'''按钮连接串口</p>
<p>[[File:media/image67zero3-img67.png|375x332px]]</p></li></ol>
</li>
<li><p>然后启动开发板，就能从打开的串口终端中看到系统输出的Log信息了</p>
<p>[[File:media/image68zero3-img68.png|376x249px]]</p></li></ol>
<span id="windows平台调试串口的使用方法"></span>
</li>
<li><p>进入MobaXterm下载网页后点击'''GET XOBATERM NOW!'''</p>
<p>[[File:media/image69zero3-img69.png|382x233px]]</p></li>
<li><p>然后选择下载Home版本</p>
<p>[[File:media/image70zero3-img70.png|353x231px]]</p></li>
<li><p>然后选择Portable便携式版本，下载完后无需安装，直接打开就可以使用</p>
<div class="figure">
[[File:media/image71zero3-img71.png|322x175px|选区_232]]
</div></li></ol>
</li>
<li><p>下载完后使用解压缩软件解压下载的压缩包，即可得到MobaXterm的可执软件，然后双击打开</p>
<p>[[File:media/image72zero3-img72.png|576x83px]]</p></li>
<li><p>打开软件后，设置串口连接的步骤如下</p>
<ol style="list-style-type: lower-alpha;">
<li><p>最后点击”'''OK'''”按钮完成设置</p></li>
[[File:media/image73zero3-img73.png|575x291px1400px]]</ol>
</li></ol>
<ol start="4" style="list-style-type: decimal;">
<li><p>点击”'''OK'''”按钮后会进入下面的界面，此时启动开发板就能看到串口的输出信息了</p>
<p>[[File:media/image74zero3-img74.png|575x291px1400px]]</p></li></ol>
== 使用开发板26pin或13pin接口中的5v引脚供电说明 ==
<div class="figure">
[[File:media/image75zero3-img75.jpeg|216x154px|4ff86e49b6624616f9498fe44c366f29png]]
</div>
<li><p>使用26pin或者13pin接口中的5V引脚来给开发板供电，电源线的接法如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>上图所示的电源线USB > A口需要插到5V/2A或者5V/3A的电源适配器接头上（'''不建议插到电脑的USB接口来供电，如果开发板接的外设过多，使用会不稳定'''）</p></li>
<li><p>红色的杜邦线需要插到开发板26pin或者13pin接口的5V引脚上</p></li>
<li><p>黑色的杜邦线需要插到26pin或者13pin接口的GND引脚上</p></li>
<li><p>26pin和13pin接口5V引脚和GND引脚在开发板中的位置如下图所示，'''<span style="color:#FF0000">切记不要接反了</span>'''</p>
<p>[[File:media/image24zero3-img24-1.png|163x174px]]</p></li></ol>
</li></ol>
<ol style="list-style-type: decimal;">
<li><p>如果有购买Orange Pi的13pin扩展板，将扩展板插入开发板的13pin接口中，就可以扩展2个USB接口</p>
<p>[[File:media/image18zero3-img18.png|246x162px]]</p></li>
<li><p>如果没有13pin扩展板，可以使用4pin 2.54mm杜邦转USB2.0母头的线来扩展USB接口，具体方法如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先需要准备一根4pin 2.54mm杜邦转USB2.0母头的线（这种线在淘宝可以买到，请自行搜索购买），如下图所示：</p>
<p>[[File:media/image76zero3-img76.png|208x162px]] [[File:media/image77zero3-img77.png|237x165px]]</p></li>
<li><p>13pin接口的原理图如下所示</p>
<p>[[File:media/image19zero3-img19.png|265x142px]] [[File:media/image78zero3-img78.png|245x133px]]</p></li>
<li><p>USB2的接线如下所示</p>
<p>[[File:media/image79zero3-img79.png|256x189px]]</p></li>
<li><p>USB3的接线如下所示</p>
<p>[[File:media/image80zero3-img80.png|255x195px]]</p></li>
<li><p>如果需要在13pin接口上同时接两个USB设备，会发现13pin接口上的5V和GND引脚不够用，此时其中一个USB设备可以使用26pin接口中的5V和GND引脚，位置如下图所示：</p>
<p>[[File:media/image24zero3-img24-1.png|243x260px]]</p></li></ol>
</li></ol>
| style="text-align: left;"| '''支持'''
|-
| style="text-align: left;"| '''Ubuntu 22.04 - Focal<span style="color:#FF0000">Jammy</span>'''
| style="text-align: left;"| '''Linux5.4'''
| style="text-align: left;"| '''支持'''
<div class="figure">
[[File:media/image81zero3-img81.png|236x108px|659B0DE6-F15C-4005-A5F9-DFF881EE647B]]
</div>
<ol style="list-style-type: decimal;">
<li><p>linux系统默认就是自动登录终端的，默认登录的用户名是'''orangepi'''</p>
<p>[[File:media/image82zero3-img82.png|475x240px]]</p></li>
<li><p>使用下面的命令可以设置root用户自动登录终端</p>
{| class="wikitable" style="width:800px;"
<div class="figure">
[[File:media/image83zero3-img83.png|576x324px|1]]
</div></li>
<div class="figure">
[[File:media/image84zero3-img84.png|569x320px|IMG_256]]
</div>
</li>
<li><p>然后重启系统，就会自动使用root用户登录桌面了</p>
<p>[[File:media/image85zero3-img85.png|294x123px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li>
<li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''disable-leds'''</p>
<p>[[File:media/image88zero3-img88.png|397x35px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li>
<li><p>重启后完全进入系统就可以看到开发板上的两个LED灯都不会亮了</p></li></ol>
</li></ol>
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况</p>
<p>[[File:media/image92zero3-img92.png|575x210px]]</p></li>
<li><p>上图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配</p></li></ol>
</li>
<ol start="4" style="list-style-type: decimal;">
<li><p>第一次启动完Linux系统后，我们还可以将TF卡从开发板中取下来重新插入'''<span style="color:#FF0000">Ubuntu电脑</span>'''，然后再次使用gparted查看下TF卡的情况，如下图所示，rootfs分区（/dev/sdc1）的容量已经扩展到了14.69GiB了</p>
<p>[[File:media/image93zero3-img93.png|575x211px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况。下图显示的是烧录完Linux桌面版系统后TF卡的情况，可以看到，虽然TF卡的总容量是16GB的（在GParted中显示为14.84GiB），但是rootfs分区（/dev/sdc1）实际只分配了4.05GiB，还剩下10.79GiB未分配</p>
<p>[[File:media/image92zero3-img92.png|575x210px]]</p></li>
<li><p>然后选中rootfs分区（/dev/sdc1）</p>
<p>[[File:media/image94zero3-img94.png|575x211px]]</p></li>
<li><p>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区</p>
<p>[[File:media/image95zero3-img95.png|436x298px]]</p></li>
<li><p>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始扩容rootfs分区的大小</p>
<p>[[File:media/image96zero3-img96.png|444x302px]]</p></li>
<li><p>'''Resize/Move'''选项打开后会弹出下面的设置界面</p>
<p>[[File:media/image97zero3-img97.png|315x193px]]</p></li><li><p>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New siezesize(MiB)'''中的数字来设置rootfs分区的大小</p><p>[[File:media/image98zero3-img98.png|320x191px]]</p></li>
<li><p>设置好容量后，再点击右下角的'''Resize/Move'''即可</p>
<p>[[File:media/image99zero3-img99.png|327x196px]]</p></li>
<li><p>最后确认无误后，再点击下图所示的'''绿色 <span style="color:green">√</span>'''</p>
<p>[[File:media/image100zero3-img100.png|392x270px]]</p></li>
<li><p>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量</p>
<p>[[File:media/image101zero3-img101.png|399x116px]]</p></li>
<li><p>扩容完成后点击'''Close'''关闭即可</p>
<p>[[File:media/image102zero3-img102.png|399x172px]]</p></li>
<li><p>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明手动扩容成功</p>
{| class="wikitable" style="width:800px;"
</li>
<li><p>打开gparted后在右上角可以选择TF卡，然后就可以看到TF卡容量的使用情况</p>
<p>[[File:media/image103zero3-img103.png|575x217px]]</p></li>
<li><p>然后选中rootfs分区（/dev/sdc1）</p>
<p>[[File:media/image104zero3-img104.png|575x217px]]</p></li>
<li><p>再点击鼠标右键就可以看到下图所示的操作选项，如果TF卡已经挂载了，首先需要Umount掉TF卡的rootfs分区</p>
<p>[[File:media/image105zero3-img105.png|400x274px]]</p></li>
<li><p>然后再次选中rootfs分区，再点击鼠标右键，然后选择'''Resize/Move'''开始设置rootfs分区的大小</p>
<p>[[File:media/image106zero3-img106.png|399x273px]]</p></li>
<li><p>'''Resize/Move'''选项打开后会弹出下面的设置界面</p>
<p>[[File:media/image107zero3-img107.png|315x188px]]</p></li><li><p>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New siezesize(MiB)'''中的数字来设置rootfs分区的大小</p><p>[[File:media/image98zero3-img98.png|318x190px]]</p></li></ol>
<!-- -->
<ol start="18" style="list-style-type: decimal;">
<li><p>设置好容量后，再点击右下角的'''Resize/Move'''即可</p>
<p>[[File:media/image99zero3-img99.png|327x196px]]</p></li>
<li><p>最后确认无误后，再点击下图所示的'''绿色 <span style="color:green">√</span>'''</p>
<p>[[File:media/image100zero3-img100.png|392x270px]]</p></li>
<li><p>然后选择'''Apply'''，就会正式开始扩容rootfs分区的容量</p>
<p>[[File:media/image101zero3-img101.png|365x106px]]</p></li>
<li><p>扩容完成后点击'''Close'''关闭即可</p>
<p>[[File:media/image102zero3-img102.png|379x164px]]</p></li>
<li><p>然后就可以把TF卡拔下来，再插到开发板中启动，进入开发板的Linux系统中后如果使用'''df -h'''命令可以看到rootfs分区的大小和前面设置的大小一致的话就说明缩小容量成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<big><p>'''下面的命令请不要照抄，比如debian12中的网络节点名为end0，下面的命令就需要修改为ping www.baidu.com -I end0。end0。（这里是大写的字母I，不是小写的字母L）'''</p></big>
|}
{| class="wikitable" style="width:800px;"
<li><p>先登录linux系统，有下面三种方式</p>
<ol style="list-style-type: lower-alpha;">
<li>如果开发板连接了网线，可以通过[[Orange Pi Zero 3#Ubuntu下SSH远程登录开发板|'''ssh远程登录linux系统''']]</li></ol>
<!-- -->
<div class="figure">
[[File:media/image108zero3-img108.png|575x250px|选区_011]]
</div></li>
|-
|
<p>orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0 （这里是大写的字母I，不是小写的字母L）'''</p>
<p>PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data.</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms</p>
<li><p>先登录linux系统，有下面三种方式</p>
<ol style="list-style-type: lower-alpha;">
<li><p>如果开发板连接了网线，可以通过[[Orange Pi Zero 3#Ubuntu下SSH远程登录开发板|'''ssh远程登录linux系统''']]</p></li>
<li><p>如果开发板连接好了调试串口，可以使用串口终端登录linux系统（串口软件请使用MobaXterm，使用minicom无法显示图形界面）</p></li>
<li><p>如果连接了开发板到HDMI显示器，可以通过HDMI显示的终端登录到linux系统</p></li></ol>
</li>
<li><p>输入nmtui命令打开的界面如下所示</p>
<p>[[File:media/image109zero3-img109.png|345x215px]]</p></li>
<li><p>选择'''Activate a connect'''后回车</p>
<p>[[File:media/image110zero3-img110.png|349x216px]]</p></li>
<li><p>然后就能看到所有搜索到的WIFI热点</p>
<p>[[File:media/image111zero3-img111.png|360x229px]]</p></li>
<li><p>选择想要连接的WIFI热点后再使用Tab键将光标定位到'''Activate'''后回车</p>
<p>[[File:media/image112zero3-img112.png|366x230px]]</p></li>
<li><p>然后会弹出输入密码的对话框，在'''Pssword'''内输入对应的密码然后回车就会开始连接WIFI</p>
<p>[[File:media/image113zero3-img113.png|352x225px]]</p></li>
<li><p>WIFI连接成功后会在已连接的WIFI名称前显示一个”*”</p>
<p>[[File:media/image114zero3-img114.png|349x223px]]</p></li>
<li><p>通过'''ip a s wlan0'''命令可以查看wifi的IP地址</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''ping www.orangepi.org -I wlan0 （这里是大写的字母I，不是小写的字母L）'''</p>
<p>PING www.orangepi.org (182.92.236.130) from 192.168.1.49 wlan0: 56(84) bytes of data.</p>
<p>64 bytes from 182.92.236.130 (182.92.236.130): icmp_seq=1 ttl=52 time=43.5 ms</p>
<ol style="list-style-type: decimal;">
<li><p>点击桌面右上角的网络配置图标（测试WIFI时请不要连接网线）</p>
<p>[[File:media/image115zero3-img115.png|275x121px]]</p></li>
<li><p>在弹出的下拉框中点击'''More networks'''可以看到所有扫描到的WIFI热点，然后选择想要连接的WIFI热点</p>
<p>[[File:media/image116zero3-img116.png|576x353px]]</p></li>
<li><p>然后输入WIFI热点的密码，再点击'''Connect'''就会开始连接WIFI</p>
<p>[[File:media/image117zero3-img117.png|288x147px]]</p></li>
<li><p>连接好WIFI后，可以打开浏览器查看是否能上网，浏览器的入口如下图所示</p>
<p>[[File:media/image118zero3-img118.png|465x249px]]</p></li>
<li><p>打开浏览器后如果能打开其他网页说明WIFI连接正常</p>
<div class="figure">
[[File:media/image119zero3-img119.png|576x273px|5]]
</div></li></ol>
</li>
<li><p>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击 '''orangepi'''连接热点，密码就是上面设置的'''orangepi'''</p>
<p>[[File:media/image120zero3-img120.png|230x183px]]</p></li>
<li><p>连接成功后的显示如下图所示</p>
<p>[[File:media/image121zero3-img121.png|233x111px]]</p></li>
<li><p>在NAT模式下，连接到开发板热点的无线设备是向开发板的DHCP服务请求IP地址的，所以会有两个不同的网段，如这里开发板的IP是192.168.1.X</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|}
<p>而开发板的DHCP服务默认会给接入热点的设备分配'''192.168.12.0/24'''的IP地址，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址是'''192.168.12.X'''。</p>
<p>[[File:media/image121zero3-img121.png|271x129px]]</p><p>[[File:media/image122zero3-img122-1.png|274x155px]]</p></li>
<li><p>如果想要为接入的设备指定不同的网段，可以通过-g参数指定，如通过-g参数指定接入点AP的网段为192.168.2.1</p>
此时通过手机连接到热点后，点击已经连接的WIFI热点'''orangepi'''，然后可以看到手机的IP地址是'''192.168.2.X'''。
[[File:media/image121zero3-img121.png|286x137px]]
[[File:media/image123zero3-img123.png|302x174px]]
</li></ol>
<ol start="7" style="list-style-type: decimal;">
此时手机是搜索不到WIFI热点的，需要手动指定WIFI热点名称，并输入密码来连接WIFI热点
[[File:media/image124zero3-img124.png|237x198px]]
</li></ol>
<span id="create_ap以bridge模式创建wifi热点的方法"></span>
</li>
<li><p>此时拿出手机，在搜索到的WIFI列表中就能找到开发板创建的名为'''orangepi'''的WIFI热点，然后可以点击'''orangepi'''连接热点，密码就是上面设置的'''orangepi'''</p>
<p>[[File:media/image120zero3-img120.png|265x211px]]</p></li>
<li><p>连接成功后的显示如下图所示</p>
<p>[[File:media/image121zero3-img121.png|273x130px]]</p></li>
<li><p>在bridge模式下，连接到开发板热点的无线设备也是向主路由（开发板连接的路由器）的DHCP服务请求IP地址的，如这里开发板的IP是'''192.168.1.X'''</p>
{| class="wikitable" style="width:800px;"
|}
<p>而接入WIFI热点的设备的IP也是由主路由分配的，所以连接WIFI热点的手机和开发板处于相同的网段，这时点击已经连接的WIFI热点'''orangepi'''，然后就可以看到手机的IP地址也是'''192.168.1.X'''。</p>
<p>[[File:media/image121zero3-img121.png|284x136px]]</p><p>[[File:media/image125zero3-img125.png|282x159px]]</p></li>
<li><p>在不指定'''--freq-band'''参数的情况下，默认创建的热点是2.4G频段的，如果想要创建5G频段的热点可以通过'''--freq-band 5'''参数指定，具体命令如下</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
此时手机是搜索不到WIFI热点的，需要手动指定WIFI热点名称，并输入密码来连接WIFI热点
[[File:media/image124zero3-img124.png|228x191px]]
</li></ol>
<span id="设置静态ip地址的方法"></span>
</li>
<li><p>然后选择'''Edit a connection'''并按下回车键</p>
<p>[[File:media/image126zero3-img126.png|227x247px]]</p></li>
<li><p>然后选择需要设置静态IP地址的网络接口，比如设置'''Ethernet'''接口的静态IP地址选择'''Wired connection 1'''就可以了</p>
<p>[[File:media/image127zero3-img127.png|310x149px]]</p></li>
<li><p>然后通过'''Tab'''键选择'''Edit'''并按下回车键</p>
<p>[[File:media/image128zero3-img128.png|316x144px]]</p></li>
<li><p>然后通过Tab键将光标移动到下图所示的'''<Automatic>'''位置进行IPv4的配置</p>
<p>[[File:media/image129zero3-img129.png|575x240px]]</p></li>
<li><p>然后回车，通过上下方向键选择'''Manual'''，然后回车确定</p>
<p>[[File:media/image130zero3-img130.png|576x237px]]</p></li>
<li><p>选择完后的显示如下图所示</p>
<p>[[File:media/image131zero3-img131.png|575x240px]]</p></li>
<li><p>然后通过Tab键将光标移动到'''<Show>'''</p>
<p>[[File:media/image132zero3-img132.png|576x241px]]</p></li>
<li><p>然后回车，回车后会弹出下面的设置界面</p>
<p>[[File:media/image133zero3-img133.png|575x450px]]</p></li>
<li><p>然后就可以在下图所示的位置设置IP地址(Addresses)、网关(Gateway)和DNS服务器的地址（里面还有很多其他设置选项，请自行探索），'''<span style="color:#FF0000">请根据自己的具体需求来设置，下图中设置的值只是一个示例</span>'''</p>
<p>[[File:media/image134zero3-img134-1.png|576x233px]]</p></li>
<li><p>设置完后将光标移动到右下角的'''<OK>'''，然后回车确认</p>
<p>[[File:media/image135zero3-img135.png|576x116px]]</p></li>
<li><p>然后点击'''<Back>'''回退到上一级选择界面</p>
<p>[[File:media/image136zero3-img136.png|330x325px]]</p></li>
<li><p>然后选择'''Activate a connection'''，再将光标移动到'''<OK>'''，最后点击回车</p>
<p>[[File:media/image137zero3-img137.png|331x248px]]</p></li>
<li><p>然后选择需要设置的网络接口，比如'''Wired connection 1'''，然后将光标移动到'''<Deactivate>'''，再按下回车键禁用'''Wired connection 1'''</p>
<p>[[File:media/image138zero3-img138.png|576x224px]]</p></li>
<li><p>然后请不要移动光标，再按下回车键重新使能'''Wired connection 1'''，这样前面设置的静态IP地址就会生效了</p>
<p>[[File:media/image139zero3-img139.png|576x224px]]</p></li>
<li><p>然后通过'''<Back>'''和'''Quit'''按钮就可以退出nmtui</p>
<p>[[File:media/image140zero3-img140.png|300x253px]] [[File:media/image141zero3-img141.png|227x252px]]</p></li>
<li><p>然后通过'''ip a s eth0'''就能看到网口的IP地址已经变成前面设置的静态IP地址了</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
<span id="使用nmcli命令来设置静态ip地址"></span>
==== 使用nmcli命令来设置静态IP地址 ====
<ol start="3" style="list-style-type: decimal;">
<li><p>成功登录系统后的显示如下图所示</p>
<p>[[File:media/image142zero3-img142.png|575x273px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<li><p>然后在'''Specify username'''中输入linux系统的用户名'''root'''或'''orangepi'''</p></li>
<li><p>最后点击'''OK'''即可</p>
<p>[[File:media/image143zero3-img143.png|576x292px]]</p></li></ol>
</li>
<li><p>然后会提示输入密码，默认root和orangepi用户的密码都为orangepi</p>
<big><p>'''注意，输入密码的时候，<span style="color:#FF0000">屏幕上是不会显示输入的密码的具体内容的</span>，请不要以为是有什么故障，输入完后直接回车即可。'''</p></big>
|}
<p>[[File:media/image144zero3-img144.png|575x157px]]</p></li>
<li><p>成功登录系统后的显示如下图所示</p>
<p>[[File:media/image145zero3-img145.png|559x388px]]</p></li></ol>
<span id="hdmi测试"></span>
<div class="figure">
[[File:media/image13zero3-img13.jpeg|151x151px|IMG_6109(20211221-181051)png]]
</div></li>
<ol style="list-style-type: lower-alpha;">
<li><p>HDMI转VGA转换器</p>
<p>[[File:media/image146zero3-img146.png|155x104px]]</p></li>
<li><p>一根VGA线和一根Micro HDMI公转HDMI母转接线</p>
<p>[[File:media/image147zero3-img147.png|148x133px400px]] [[File:media/image148zero3-img148.jpegpng|157x139px|IMG_6140(20220104-134930)400px]]</p></li>
<li><p>一个支持VGA接口的显示器或者电视</p></li></ol>
</li>
<li><p>HDMI转VGA显示测试如下所示</p>
<p>[[File:media/image149zero3-img149.png|574x336px]]</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
<p>orangepi@orangepi:~$ '''sudo cat /sys/class/disp/disp/attr/sys'''</p>
|}
<p>[[File:media/image150zero3-img150.png|575x84px]]</p></li></ol>
<span id="linux5.4系统framebuffer宽度和高度的修改方法"></span>
<ol style="list-style-type: decimal;">
<li><p>点击桌面右上角的蓝牙图标</p>
<p>[[File:media/image151zero3-img151.png|314x122px]]</p></li>
<li><p>然后选择适配器</p>
<p>[[File:media/image152zero3-img152.png|318x140px]]</p></li>
<li><p>如果有提示下面的界面，请选择'''Yes'''</p>
<p>[[File:media/image153zero3-img153.png|248x85px]]</p></li>
<li><p>然后在蓝牙的适配器设置界面中设置'''Visibility Setting'''为'''Always visible'''，然后关闭即可</p>
<p>[[File:media/image154zero3-img154.png|196x183px]]</p></li>
<li><p>然后打开蓝牙设备的配置界面</p>
<p>[[File:media/image155zero3-img155.png|438x179px]]</p></li>
<li><p>点击'''Search'''即可开始扫描周围的蓝牙设备</p>
<p>[[File:media/image156zero3-img156.png|311x210px]]</p></li>
<li><p>然后选择想要连接的蓝牙设备，再点击鼠标右键就会弹出对此蓝牙设备的操作界面，选择'''Pair'''即可开始配对，这里演示的是和Android手机配对</p>
<p>[[File:media/image157zero3-img157.png|311x242px]]</p></li>
<li><p>配对时，桌面的右上角会弹出配对确认框，选择'''Confirm'''确认即可，此时手机上也同样需要进行确认</p>
<p>[[File:media/image158zero3-img158.png|411x150px]]</p></li>
<li><p>和手机配对完后，可以选择已配对的蓝牙设备，然后右键选择'''Send a File'''即可开始给手机发送一张图片</p>
<p>[[File:media/image159zero3-img159.png|405x239px]]</p></li>
<li><p>发送图片的界面如下所示</p>
<p>[[File:media/image160zero3-img160.png|399x231px]]</p></li></ol>
=== 服务器版镜像的使用方法 ===
</li>
<li><p>配对成功后，手机蓝牙界面的显示如下所示</p>
<p>[[File:media/image161zero3-img161.png|189x167px]]</p></li>
<li><p>连接蓝牙设备需要安装 '''pulseaudio-module-bluetooth'''软件包，然后再启动'''pulseaudio''' 服务</p>
{| class="wikitable" style="width:800px;"
<p>orangepi@orangepi:~$ '''sudo bluetoothctl'''</p>
<p>Agent registered</p>
<p>[bluetooth]# '''paired-devices #查看已配对的蓝牙设备的MAC地址'''</p>
<p>Device DC:72:9B:4C:F4:CF orangepi</p>
<p>[bluetooth]# '''connect DC:72:9B:4C:F4:CF #使用MAC地址连接蓝牙设备'''</p>
<p>Attempting to connect to DC:72:9B:4C:F4:CF</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF Connected: yes</p>
<p>[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: yes</p>
<p>[CHG] Controller 10:11:12:13:14:15 Discoverable: no</p>
<p>'''[orangepi]# #出现这个提示符说明连接成功'''</p>
|}
</li>
<div class="figure">
[[File:media/image162zero3-img162.jpeg|223x232px|Screenshot_20201205_142413png]]
</div></li></ol>
<div class="figure">
[[File:media/image163zero3-img163.png|575x279px|选区_021]]
</div></li></ol>
<div class="figure">
[[File:media/image164zero3-img164.jpeg|126x125px|IMG_256png]]
</div></li>
<ol style="list-style-type: decimal;">
<li><p>首先打开文件管理器</p>
<p>[[File:media/image165zero3-img165.png|257x126px]]</p></li>
<li><p>然后找到下面这个文件（如果系统中没有这个音频文件，可以自己上传一个音频文件到系统中）</p>
<p>[[File:media/image166zero3-img166.png|238x189px]]</p></li>
<li><p>然后选中audio.wav文件，右键选择使用vlc打开就可以开始播放</p>
<p>[[File:media/image167zero3-img167.png|241x195px]]</p></li>
<li><p>切换HDMI播放和耳机播放等不同音频设备的方法</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先打开音量控制界面</p>
<p>[[File:media/image168zero3-img168.png|294x161px]]</p></li>
<li><p>播放音频的时候，在'''Playback'''中会显示播放软件可以使用的音频设备选项，如下图所示，在这里可以设置需要播放到哪个音频设备</p>
<div class="figure">
[[File:media/image169zero3-img169.png|576x324px|4]]
</div></li></ol>
<div class="figure">
[[File:media/image164zero3-img164.jpeg|164x163px|IMG_256png]]
</div></li>
<div class="figure">
[[File:media/image170zero3-img170.jpeg|140x131px|IMG_256png]]
</div></li>
== 温度传感器 ==
=== linux5.4系统查看温度的方法 ===
# H618总共有4个温度传感器，查看温度的命令如下所示：
</li></ol>
{| class="wikitable" style="width:800px;"
temp1: +'''<span style="color:#FF0000">47.2°C</span>''' (crit = +110.0°C)
|}
<span id="pin扩展板接口引脚说明"></span>
<ol style="list-style-type: decimal;">
<li><p>开发板13 pin扩展板接口引脚的顺序请参考下图</p>
<p>[[File:media/image78zero3-img78.png|245x133px]]</p></li>
<li><p>开发板13pin接口的原理图如下所示</p>
<p>[[File:media/image19zero3-img19.png|359x193px]]</p></li>
<li><p>开发板13 pin扩展板接口引脚的功能说明如下</p>
<ol style="list-style-type: lower-alpha;">
<ol style="list-style-type: decimal;">
<li><p>Orange Pi Zero 3开发板26 pin接口引脚的顺序请参开发板上的丝印图</p>
<p>[[File:media/image171zero3-img171-1.png|389x125px]]</p></li>
<li><p>开发板26 pin接口引脚的功能如下表所示</p></li>
<div style="display: flex;">{| class="wikitable" style="width:800px300px;margin-right: 20px"
|-
| style="text-align: left;"| '''GPIO序号'''
| style="text-align: left;"| '''功能'''
| style="text-align: left;"| '''引脚'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''3.3V'''
| style="text-align: left;"| '''1'''
|-
| style="text-align: left;"| '''229'''
| style="text-align: left;"| '''TWI3-SDA'''
| style="text-align: left;"| '''3'''
|-
| style="text-align: left;"| '''228'''
| style="text-align: left;"| '''TWI3-SCK'''
| style="text-align: left;"| '''5'''
|-
| style="text-align: left;"| '''73'''
| style="text-align: left;"| '''PC9'''
| style="text-align: left;"| '''7'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''9'''
|-
| style="text-align: left;"| '''70'''
| style="text-align: left;"| '''PC6'''
| style="text-align: left;"| '''11'''
|-
| style="text-align: left;"| '''69'''
| style="text-align: left;"| '''PC5'''
| style="text-align: left;"| '''13'''
|-
| style="text-align: left;"| '''72'''
| style="text-align: left;"| '''PC8'''
| style="text-align: left;"| '''15'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''3.3V'''
| style="text-align: left;"| '''17'''
| style="text-align: left;"| '''PH7'''
| style="text-align: left;"| '''SPI1_MOSI'''
| style="text-align: left;"| '''19'''
|-
| style="text-align: left;"| '''232'''
| style="text-align: left;"| '''SPI1_MISO'''
| style="text-align: left;"| '''21'''
|-
| style="text-align: left;"| '''230'''
| style="text-align: left;"| '''SPI1_CLK'''
| style="text-align: left;"| '''23'''
|-
| style="text-align: left;"|
| style="text-align: left;"| '''GND'''
| style="text-align: left;"| '''25'''
|}
|-
| <big>style="text-align: left;"| '''注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。引脚''' '''编译好的wiringOP的deb包在orangepi-build中的存放路径为：''' '''<span | style="colortext-align:blueleft;">orangepi-build/external/cache/debs/arm64/wiringpi_x.xx.deb</span>''' | '''进入系统后可以运行下gpio readall命令，如果能看到下面的输出，说明wiringOP已经预装并且能正常使用。功能''' [[File| style="text-align:media/image172.pngleft;"|575x365px]] '''wiringOP目前主要适配了设置GPIO口输入输出，设置GPIO口输出高低电平以及设置上下拉电阻的功能，像硬件PWM这样的功能是用不了的。GPIO'''</big>|} <ol style="list-styletext-typealign: decimalleft;"><li><p>下载wiringOP的代码</p>{| class="wikitable" style="width:800px;" '''GPIO序号'''
|-
| <p>orangepi@orangepistyle="text-align:~$ left;"| '''sudo apt update2'''</p><p>orangepi@orangepi:~$ '''sudo apt install | style="text-y git'''</p><p>orangepi@orangepialign:~$ left;"| '''git clone https://github.com/orangepi-xunlong/wiringOP.git -b next5V'''</p>|} {| classstyle="wikitabletext-align: left;" || style="backgroundtext-color:#ffffdc;widthalign:800pxleft;" |
|-
| <big><p>style="text-align: left;"| '''注意，源码需要下载wiringOP next分支的代码，请别漏了-b next这个参数。4'''</p><p>| style="text-align: left;"| '''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/usr/src/wiringOP。5V'''</p></big>|}</li><li><p>编译安装wiringOP</p>{| classstyle="wikitabletext-align: left;" || style="widthtext-align:800pxleft;" |
|-
| <p>orangepi@orangepistyle="text-align:~$ left;"| '''cd wiringOP6'''</p><p>orangepi@orangepi:~/wiringOP$ '''sudo ./build clean'''</p><p>orangepi@orangepi:~/wiringOP$ '''sudo ./build'''</p>|}</li><li><p>测试gpio readall命令的输出如下</p><ol style="listtext-style-typealign: lower-alphaleft;"><li><p>其中1到26号引脚与开发板上的26 Pin引脚是一一对应的</p></li><li><p>27号引脚对应开发板上13pin的10号引脚</p></li><li><p>29号引脚对应开发板上13pin的11号引脚</p></li><li><p>31号引脚对应开发板上13pin的12号引脚</p></li><li><p>33号引脚对应开发板上13pin的13号引脚</p></li><li><p>| '''<span style="color:#FF0000">28、30、32、34号引脚为空，请直接忽略</span>GND'''</p><p>[[File:media/image172.png|575x365px]]</p></li></ol></li></ol> <span id="pin接口gpioi2cuartspi和pwm测试"></span> == 26pin接口GPIO、I2C、UART、SPI和PWM测试 == <span id="pin-gpio口测试"></span>=== 26pin GPIO口测试 === <ol style="list-styletext-typealign: decimalleft;"><li><p>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的高低电平</p><p>[[File:media/image173.png|576x128px]]</p></li><li><p>首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号</p>{| class="wikitable" style="widthtext-align:800pxleft;" |
|-
| <p>root@orangepistyle="text-align:~/wiringOP# left;"| '''8'''gpio mode <span | style="colortext-align:#FF0000left;">2</span> out| '''UART5_TX'''</p>|}</li><li><p>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>{| classstyle="wikitabletext-align: left;" | '''PH2'''| style="widthtext-align:800pxleft;" | '''226'''
|-
| <p>root@orangepistyle="text-align:~/wiringOP# left;"| '''gpio write 2 <span 10'''| style="colortext-align:#FF0000left;">0</span>| '''UART5_RX'''</p>|}<p>使用gpio readall可以看到7号引脚的值(V)变为了0</p><p>[[Filestyle="text-align:media/image174.pngleft;"|575x128px]]</p></li><li><p>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功</p>'''PH3'''{| class="wikitable" style="widthtext-align:800pxleft;" | '''227'''
|-
| <p>root@orangepi:~/wiringOP# '''gpio write 2 <span style="colortext-align:#FF0000left;">1</span>| '''12'''</p>|}<p>使用gpio readall可以看到7号引脚的值(V)变为了1</p><p>[[File:media/image175.png|575x130px]]</p></li><li><p>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可</p></li></ol> <span idstyle="pintext-gpio口上下拉电阻的设置方法align: left;"></span>| '''PC11''' === 26 pin GPIO口上下拉电阻的设置方法 === <ol | style="listtext-style-typealign: decimalleft;"><li><p>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的上下拉电阻</p><p>[[File:media/image173.png|576x128px]]</p></li><li><p>首先需要设置GPIO口为输入模式，其中第三个参数需要输入引脚对应的wPi的序号</p>'''PC11'''{| class="wikitable" style="widthtext-align:800pxleft;" | '''75'''
|-
| <p>root@orangepistyle="text-align:~/wiringOP# left;"| '''14'''gpio mode <span | style="colortext-align:#FF0000left;">2</span> in| '''GND'''</p>|}</li><li><p>设置为输入模式后，执行下面的命令可以设置GPIO口为上拉模式</p>{| classstyle="wikitabletext-align: left;" || style="widthtext-align:800pxleft;" |
|-
| <p>root@orangepistyle="text-align:~/wiringOP# left;"| '''16'''gpio mode <span | style="colortext-align:#FF0000left;">2</span> up| '''PC15'''</p>|}</li><li><p>然后输入下面的命令读取GPIO口的电平，如果电平为1，说明上拉模式设置成功</p>{| classstyle="wikitabletext-align: left;" | '''PC15'''| style="widthtext-align:800pxleft;" | '''79'''
|-
| style="text-align: left;"| '''18'''<p>root@orangepi| style="text-align:~/wiringOP# left;"| '''gpio read <span PC14'''| style="colortext-align:#FF0000left;">2</span>| '''PC14'''</p><p>| style="text-align: left;"| '''178'''</p>|}-</li>| style="text-align: left;"| '''20'''<li><p>然后执行下面的命令可以设置GPIO口为下拉模式</p>| style="text-align: left;"| '''GND'''{| classstyle="wikitabletext-align: left;"|| style="text-align: left;"||-| style=" text-align: left;"| '''22'''| style="widthtext-align:800pxleft;" | '''PC7'''| style="text-align: left;"| '''PC7'''| style="text-align: left;"| '''71'''
|-
| <p>root@orangepistyle="text-align:~/wiringOP# left;"| '''24'''gpio mode <span | style="colortext-align:#FF0000left;">2</span> down| '''SPI1_CS'''</p>|}</li><li><p>然后输入下面的命令读取GPIO口的电平，如果电平为0，说明下拉模式设置成功</p>{| classstyle="wikitabletext-align: left;" | '''PH9'''| style="widthtext-align:800pxleft;" | '''233'''
|-
| style="text-align: left;"| '''26'''<p>root@orangepi| style="text-align:~/wiringOP# left;"| '''PC10''gpio read <span '| style="colortext-align:#FF0000left;">2</span>| '''PC10'''</p><p>| style="text-align: left;"| '''074'''</p>
|}
</div></ol><ol start="3" style="list-style-type: decimal;"><li>26pin接口中总共有'''17'''个GPIO口，所有GPIO口的电压都是'''<span style="color:#FF0000">3.3v</span>'''</li></ol>
<span id="pin-spi测试安装wiringop的方法"></span>
=== 26pin SPI测试 =安装wiringOP的方法 ==
|-
|
<pbig>'''注意，Orange Pi发布的linux镜像中已经预装了wiringOP，除非wiringOP的代码有更新，否则无需重新下载编译安装，直接使用即可。''' '''编译好的wiringOP的deb包在orangepi-build中的存放路径为：''' '''<span style="color:blue">orangepi@orangepi-build/external/cache/debs/arm64/wiringpi_x.xx.deb</span>''' '''进入系统后可以运行下gpio readall命令，如果能看到下面的输出，说明wiringOP已经预装并且能正常使用。''' [[File:~$ zero3-img172.png]] '''sudo orangepi-configwiringOP目前主要适配了设置GPIO口输入输出，设置GPIO口输出高低电平以及设置上下拉电阻的功能，像硬件PWM这样的功能是用不了的。'''</pbig>
|}
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''ls sudo apt update'''</dev/spidev1*p><p>orangepi@orangepi:~$ '''sudo apt install -y git'''</p><p>orangepi@orangepi:~$ '''git clone https:/dev/spidev1github.1com/orangepi-xunlong/wiringOP.git -b next'''</p>
|}
|-
|
<big><p>orangepi@orangepi:~$ '''sudo spidev_test -v 注意，源码需要下载wiringOP next分支的代码，请别漏了-D /dev/spidev1.1b next这个参数。'''</p><p>spi mode: 0x0</p><p>bits per word: 8</p><p>max speed: 500000 Hz (500 KHz)</p><p>TX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95<如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP源码，存放位置为：/usr/src/span>wiringOP。''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p><p>RX | FF FF FF FF FF FF '''<span style="color:#FF0000">FF FF FF FF FF FF</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ............................….</pbig>
|}
</li>
<li><p>然后短接SPI1的mosi（26pin接口中的第19号引脚）和miso（26pin接口中的第21号引脚）两个引脚再运行spidev_test的输出如下，可以看到发送和接收的数据一样编译安装wiringOP</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo spidev_test -v -D /dev/spidev1.1cd wiringOP'''</p><p>spi mode: 0x0</p><p>bits per wordorangepi@orangepi: 8<~/p><p>max speed: 500000 Hz (500 KHz)</p><p>TX | FF FF FF FF FF FF wiringOP$ '''<span style="color:#FF0000">40 00 00 00 00 95<sudo ./span>build clean''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p><p>RX | FF FF FF FF FF FF orangepi@orangepi:~/wiringOP$ '''<span style="color:#FF0000">40 00 00 00 00 95<sudo ./span>build''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p>
|}
</li><li><p>测试gpio readall命令的输出如下</p><ol style="list-style-type: lower-alpha;"><li><p>其中1到26号引脚与开发板上的26 Pin引脚是一一对应的</p></li><li><p>27号引脚对应开发板上13pin的10号引脚</p></li><li><p>29号引脚对应开发板上13pin的11号引脚</p></li><li><p>31号引脚对应开发板上13pin的12号引脚</p></li><li><p>33号引脚对应开发板上13pin的13号引脚</p></li><li><p>'''<span style="color:#FF0000">28、30、32、34号引脚为空，请直接忽略</span>'''</p><p>[[File:zero3-img172.png]]</p></li></ol></li></ol> <span id="pin-i2c测试pin接口gpioi2cuartspi和pwm测试"></span> == 26pin接口GPIO、I2C、UART、SPI和PWM测试 ==
<span id="pin-gpio口测试"></span>=== 26pin I2C测试 GPIO口测试 ===
<ol style="list-style-type: decimal;">
<li><p>由26pin的原理图可知，可用的i2c为i2c3下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的高低电平</p><p>[[File:media/image178zero3-img173.png|575x204px]]</p></li><li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p><ol style="list-style-type: lower-alpha;"><li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~$ /wiringOP# '''sudo orangepi-configgpio mode <span style="color:#FF0000">2</span> out'''</p>
|}
</li>
<li><p>然后选择'''System'''</p><p>[[File:media/image86.png|390x190px]]</p></li><li><p>然后选择'''Hardware'''</p><p>[[File:media/image87.png|393x202px]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-i2c3'''</p><p>[[File:media/image179.png|392x57px]]</p></li><li><p>然后选择'''<Save>'''保存</p><p>[[File:media/image89.png|395x91px]]</p></li><li><p>然后选择'''<Back>'''</p><p>[[File:media/image90.png|395x91px]]</p></li><li><p>然后选择'''<Reboot>'''重启系统使配置生效</p><p>[[File:media/image91.png|374x187px]]</p></li></ol></li><li><p>启动linux系统后，先确认下/dev下存在i2c3的设备节点然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~$ '''ls /dev/i2c-3wiringOP# '''gpio write 2 </pspan style="color:#FF0000">0<p/span>'''/dev/i2c-3'''</p>
|}
<p>使用gpio readall可以看到7号引脚的值(V)变为了0</p><p>[[File:zero3-img174.png]]</p></li><li><p>然后开始测试i2c，首先安装i2c-tools然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~$ '''sudo apt-get update'''</p><p>orangepi@orangepi:~$ '''sudo apt-get install -y i2c-toolswiringOP# '''gpio write 2 </p>|}</li><li><p>然后在26pin接头的i2c3引脚上接一个i2c设备</p>{| class="wikitable" span style="background-color:#ffffdc;width:800px;FF0000" |-| <big>1<p/span>'''5V和3.3V引脚请根据具体的i2c设备进行选择，不同的i2c设备需要的电压值可能不同。'''</p></big>
|}
<p>使用gpio readall可以看到7号引脚的值(V)变为了1</p>
<p>[[File:zero3-img175.png]]</p></li>
<li><p>其他引脚的设置方法类似，只需修改wPi的序号为引脚对应的序号即可</p></li></ol>
<span id="pin-gpio口上下拉电阻的设置方法"></span>
=== 26 pin GPIO口上下拉电阻的设置方法 === <ol style="list-style-type: decimal;"><li><p>下面以7号引脚——对应GPIO为PC9——对应wPi序号为2——为例演示如何设置GPIO口的上下拉电阻</p><p>[[File:zero3-img173.png]]</p></li><li><p>首先需要设置GPIO口为输入模式，其中第三个参数需要输入引脚对应的wPi的序号</p>{| class="wikitable" style="width:800px;"
|-
| <p>root@orangepi:~/wiringOP# '''gpio mode <span style="text-aligncolor: left;#FF0000"| '''sda引脚>2</span> in'''</p>|}</li><li><p>设置为输入模式后，执行下面的命令可以设置GPIO口为上拉模式</p>{| class="wikitable" style="text-alignwidth: left800px;"| '''对应26pin中3号引脚'''
|-
| <p>root@orangepi:~/wiringOP# '''gpio mode <span style="text-aligncolor: left;#FF0000"| '''sck引脚>2</span> up'''</p>|}</li><li><p>然后输入下面的命令读取GPIO口的电平，如果电平为1，说明上拉模式设置成功</p>{| class="wikitable" style="text-alignwidth: left800px;"| '''对应26pin中5号引脚'''
|-
| <p>root@orangepi:~/wiringOP# '''gpio read <span style="text-aligncolor: left;#FF0000"| >2</span>'''</p><p>'''5v引脚1'''</p>| }</li><li><p>然后执行下面的命令可以设置GPIO口为下拉模式</p>{| class="wikitable" style="text-alignwidth: left800px;"| '''对应26pin中2号引脚'''
|-
| style="text-align: left;"| '''3.3v引脚'''| style="text-align<p>root@orangepi: left;"| ''~/wiringOP# '对应26pin中1号引脚'''|-| gpio mode <span style="text-aligncolor: left;#FF0000"| '''gnd引脚'''| style="text-align: left;"| '''对应26pin中6号引脚>2</span> down'''</p>
|}
</li></ol><ol start="6" style="list-style-type: decimal;"><li><p>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c能正常使用然后输入下面的命令读取GPIO口的电平，如果电平为0，说明下拉模式设置成功</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
|}
<div class="figure"/li></ol>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''phspi1-uart5cs1-spidev'''</p><p>[[File:media/image182zero3-img177.png|400x60px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>进入linux系统后，先确认下然后查看下linux系统中是否存在'''/devspidev1.1'''下是否存在uart5的设备节点的设备节点，如果存在，说明SPI1的配置已经生效了</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
|}
</li>
<li><p>先不短接SPI1的mosi和miso两个引脚，运行spidev_test的输出结果如下所示，可以看到TX和RX的数据不一致</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''ls sudo spidev_test -v -D /dev/ttyS5spidev1.1'''</p><p>spi mode: 0x0</p><p>bits per word: 8</devp><p>max speed: 500000 Hz (500 KHz)</p><p>TX | FF FF FF FF FF FF '''<span style="color:#FF0000">40 00 00 00 00 95</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p><p>RX | FF FF FF FF FF FF '''<span style="color:#FF0000">FF FF FF FF FF FF</ttyS5span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ............................….</p>
|}
</li>
<li><p>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx</p></li> {| class="wikitable" style="width:500px;"|-|| style="text-align: left;"| uart5|-| tx引脚| style="text-align: left;"| 对应26pin的8号引脚|-| rx引脚| style="text-align: left;"| 对应26pin的10号引脚|}</ol><ol start="5" style="list-style-type: decimal;"><li><p>使用wiringOP中的'''gpio'''命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常然后短接SPI1的mosi（26pin接口中的第19号引脚）和miso（26pin接口中的第21号引脚）两个引脚再运行spidev_test的输出如下，可以看到发送和接收的数据一样</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''gpio serial sudo spidev_test -v -D /dev/ttyS5 # linux-6spidev1.1测试命令1'''</p><p>orangepi@orangepispi mode: 0x0</p><p>bits per word: 8</p><p>max speed:~$ 500000 Hz (500 KHz)</p><p>TX | FF FF FF FF FF FF '''gpio serial <span style="color:#FF0000">40 00 00 00 00 95</devspan>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</ttyAS5 p><p>RX | FF FF FF FF FF FF '''<span style="color:# linux-5.4测试命令FF0000">40 00 00 00 00 95</span>'''FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D | ......@.…▒..................▒.</p>|}</li></ol>
<span id="pin-i2c测试"></span>
<ol style="list-style-type: decimal;">
<li><p>Linux系统中pwm默认是关闭的，需要手动打开才能使用。打开步骤如下所示：由26pin的原理图可知，可用的i2c为i2c3</p><p>[[File:zero3-img178.png]]</p></li><li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
</li>
<li><p>然后选择'''System'''</p>
<p>[[File:media/image86zero3-img86.png|398x194px]]</p></li>
<li><p>然后选择'''Hardware'''</p>
<p>[[File:media/image87zero3-img87.png|393x202px]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中pwm对应的配置</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''由于PWM1、PWM2和26pin接口中UART5的RX、TX引脚是复用的，所以打开PWM1和PWM2（需要选择ph-pwm12）时请确保没有选择UART5的配置（不要勾选ph-uart5）。选中'''</p><p>'''PWM3、PWM4和调试串口中的TX、RX引脚是复用的，所以使用PWM3和PWM4（需要选择phph-pwm34）时请将UART0的配置关掉（需要选择disable-uart0），关掉UART0后调试串口就无法使用了。i2c3'''</p></big>|}<p>[[File:media/image184zero3-img179.png|402x156px]]</p></li>
<li><p>然后选择'''<Save>'''保存</p>
<p>[[File:media/image89zero3-img89.png|397x92px]]</p></li>
<li><p>然后选择'''<Back>'''</p>
<p>[[File:media/image90zero3-img90.png|395x91px]]</p></li>
<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>
<p>[[File:media/image91zero3-img91.png|374x187px]]</p></li></ol>
</li>
<li><p>重启后就可以开始PWM的测试启动linux系统后，先确认下/dev下存在i2c3的设备节点</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
|}
<ol style="list-style-type: lower-alpha;"/li><li><p>在命令行中输入下面的命令可以让pwm1输出一个50Hz的矩形波然后开始测试i2c，首先安装i2c-tools</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~# '''echo 1 > /sys/class/pwm/pwmchip0/export'''</p><p>root@orangepi:~# $ '''echo 20000000 > /sys/class/pwm/pwmchip0/pwm1/periodsudo apt-get update'''</p><p>root@orangepi:~# '''echo 1000000 > /sys/class/pwm/pwmchip0/pwm1/duty_cycle'''</p><p>root@orangepi:~# $ '''echo 1 > /sys/class/pwm/pwmchip0/pwm1/enablesudo apt-get install -y i2c-tools'''</p>
|}
</li>
<li><p>在命令行中输入下面的命令可以让pwm2输出一个50Hz的方波然后在26pin接头的i2c3引脚上接一个i2c设备</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''5V和3.3V引脚请根据具体的i2c设备进行选择，不同的i2c设备需要的电压值可能不同。'''</p></libig>|}
{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| '''sda引脚'''root@orangepi| style="text-align:~# left;"| '''对应26pin中3号引脚'echo 2 >''|-| style="text-align: left; /sys/class/pwm/pwmchip0/export"| '''sck引脚'''| style="text-align: left;"| '''对应26pin中5号引脚'''|-root@orangepi| style="text-align:~# left;"| '''5v引脚''echo 20000000 >'| style="text-align: left; /sys/class/pwm/pwmchip0/pwm2/period"| '''对应26pin中2号引脚'''|-root@orangepi| style="text-align:~# left;"| '''echo 1000000 >3.3v引脚'''| style="text-align: left; /sys/class/pwm/pwmchip0/pwm2/duty_cycle"| '''对应26pin中1号引脚'''|-root@orangepi| style="text-align:~# left;"| '''echo 1 >gnd引脚'''| style="text-align: left; /sys/class/pwm/pwmchip0/pwm2/enable"| '''对应26pin中6号引脚'''
|}
</li></ol><ol start="36" style="list-style-type: lower-alphadecimal;"><li>在命令行中输入下面的命令可以让pwm3输出一个50Hz的矩形波<p>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c能正常使用</lip> {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的uart为uart5</p>
<p>[[File:zero3-img181.png]]</p></li>
<li><p>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;"
|-
|
|}
</li><div class="figure"li><p>然后选择'''System'''</p><p>[[File:zero3-img86.png]]</p></li><li><p>然后选择'''Hardware'''</p><p>[[File:media/image185zero3-img87.jpeg|574x344px|69D96433378187B10005CDD2A52881B0png]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-uart5'''</p><p>[[File:zero3-img182.png]]</divp></li><li><p>然后选择'''<Save>'''保存</olp><p>[[File:zero3-img89.png]]</p></li><li><p>然后选择'''<Back>'''</olp><span id="wiringopp>[[File:zero3-python的安装使用方法"img90.png]]</p></spanli><li><p>然后选择'''<Reboot>'''重启系统使配置生效</p>== wiringOP<p>[[File:zero3-Python的安装使用方法 ==img91.png]]</p></li></ol></li><li><p>进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点</p>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>'''wiringOP-Python是wiringOP的Python语言版本的库，用于在Python程序中操作开发板的GPIO、I2C、SPI和UART等硬件资源。''' 注意，linux5.4系统为/dev/ttyAS5。'''另外请注意下面所有的命令都是在<span style="color:#FF0000">root</spanp>用户下操作的。'''</big>
|}
{| class="wikitable" style="width:800px;"
|-
|
<p>rootorangepi@orangepi:~# $ '''sudo apt-get updatels /dev/ttyS5'''</p><p>root@orangepi:~# '''sudo apt-get -y install git swig python3-/dev python3-setuptools'''/ttyS5</p>
|}
</li>
<li><p>然后使用下面的命令下载wiringOP-Python的源码然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx</p></li>
{| class="wikitable" style="backgroundwidth:500px;"|-color|| style="text-align:#ffffdcleft;width"| uart5|-| tx引脚| style="text-align:800pxleft;" | 对应26pin的8号引脚
|-
| rx引脚<big>'''注意，下面的git clone--recursive命令会自动下载wiringOP的源码，因为wiringOP-Python是依赖wiringOP的。请确保下载过程没有因为网络问题而报错。''' '''如果从GitHub下载代码有问题，可以直接使用Linux镜像中自带的wiringOP-Python源码，存放位置为：/usr/src/wiringOP-Python'''。</big>|} {| class="wikitable" style="widthtext-align:800pxleft;" |-| 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'''对应26pin的10号引脚
|}
</ol>
<ol start="35" style="list-style-type: decimal;"><li><p>然后使用下面的命令编译wiringOP-Python并将其安装到开发板的Linux系统中使用wiringOP中的'''gpio'''命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>rootorangepi@orangepi:~# '$ ''cd wiringOP-Python'''<gpio serial /p><p>root@orangepi:~dev/wiringOP-PythonttyS5 # '''python3 generatelinux-bindings6.py > bindings.i1测试命令'''</p><p>rootorangepi@orangepi:~/wiringOP-Python# $ '''sudo python3 setup.py install'''<gpio serial /p>|}<dev/li><li><p>然后输入下面的命令，如果有帮助信息输出，说明wiringOPttyAS5 # linux-Python安装成功，按下'''q5.4测试命令'''键可以退出帮助信息的界面</p></li>
<span id="pwm的测试方法"></span>
{| class="wikitable" style="background-color:wiringpi#ffffdc;width:800px;" |-| <big>'''开发板最多可以使用4通道PWM，它们所在引脚的位置如下图所示:'''</big>
|}
<ol style="list-style-type: decimal;">
<li><p>Linux系统中pwm默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo orangepi-config'''</p>|}</li><li><p>然后选择'''System'''</p><p>[[File:zero3-img86.png]]</p></li><li><p>然后选择'''Hardware'''</p><p>[[File:zero3-img87.png]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中pwm对应的配置</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''由于PWM1、PWM2和26pin接口中UART5的RX、TX引脚是复用的，所以打开PWM1和PWM2（需要选择ph-pwm12）时请确保没有选择UART5的配置（不要勾选ph-uart5）。'''</p><p>'''PWM3、PWM4和调试串口中的TX、RX引脚是复用的，所以使用PWM3和PWM4（需要选择ph-pwm34）时请将UART0的配置关掉（需要选择disable-uart0），关掉UART0后调试串口就无法使用了。'''</p></big>|}<p>[[File:zero3-img184.png]]</p></li><li><p>然后选择'''<Save>'''保存</p><p>[[File:zero3-img89.png]]</p></li><li><p>然后选择'''<Back>'''</p><p>[[File:zero3-img90.png]]</p></li><li><p>然后选择'''<Reboot>'''重启系统使配置生效</p><p>[[File:zero3-img91.png]]</p></li></ol></li><li><p>重启后就可以开始PWM的测试</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''下面的命令请在root用户下执行。'''</p></big>|}<ol style="list-style-type: lower-alpha;"><li><p>在命令行中输入下面的命令可以让pwm1输出一个50Hz的方波</p>{| class="wikitable" style="width:800px;" |-| <p>root@orangepi:~# '''echo 1 > /sys/class/pwm/pwmchip0/export'''</p><p>root@orangepi:~# '''echo 20000000 > /sys/class/pwm/pwmchip0/pwm1/period'''</p><p>root@orangepi:~# '''echo 1000000 > /sys/class/pwm/pwmchip0/pwm1/duty_cycle'''</p><p>root@orangepi:~# '''python3echo 1 > /sys/class/pwm/pwmchip0/pwm1/enable'''</p>
|}
</olli><ol start="2" style="list-style-type: lower-alpha;"li><p>在命令行中输入下面的命令可以让pwm2输出一个50Hz的方波<li/p>然后导入wiringpi的python模块</li>
{| class="wikitable" style="width:800px;"
|-
|
root@orangepi:~# '''echo 2 >/sys/class/pwm/pwmchip0/export''' root@orangepi:~# '''echo 20000000 >/sys/class/pwm/pwmchip0/pwm2/period''' root@orangepi:~# '''echo 1000000 > /sys/class/pwm/pwmchip0/pwm2/duty_cycle''' root@orangepi:~# 'import wiringpi''echo 1 >/sys/class/pwm/pwmchip0/pwm2/enable'''
|}
</ol>
<ol start="3" style="list-style-type: lower-alpha;">
<li>最后输入下面的命令可以查看下wiringOP-Python的帮助信息，按下'''q'''键可以退出帮助信息的界面在命令行中输入下面的命令可以让pwm3输出一个50Hz的方波</li>
{| class="wikitable" style="width:800px;"
|-
|
root@orangepi:~# '''echo 3 >>> '''help(wiringpi)/sys/class/pwm/pwmchip0/export'''
root@orangepi:~# '''echo 1000000 > /sys/class/pwm/pwmchip0/pwm3/duty_cycle'''
{| class="wikitable" style="width:wiringpi800px;" |-| root@orangepi:~# '''echo 4 > /sys/class/pwm/pwmchip0/export'''
root@orangepi:~# '''echo 20000000 > /sys/class/pwm/pwmchip0/pwm4/period'''
root@orangepi: ~# This file was automatically generated by SWIG (http:'''echo 1 > /sys/class/pwm/pwmchip0/pwm4/www.swig.org).enable'''|}
[[File: #zero3-img185.png]]
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big>'''wiringOP-Python是wiringOP的Python语言版本的库，用于在Python程序中操作开发板的GPIO、I2C、SPI和UART等硬件资源。'''
'''另外请注意下面所有的命令都是在<span style="color:builtins.object#FF0000">root</span>用户下操作的。'''</big>|}
<ol style="list-style-type:decimal;"><li><p>首先安装依赖包</p>{| class="wikitable" style="width:I2C800px;" |-| <p>root@orangepi:~# '''sudo apt-get update'''</p><p>root@orangepi:~# '''sudo apt-get -y install git swig python3-dev python3-setuptools'''</p>|}</li><li><p>然后使用下面的命令下载wiringOP-Python的源码</p></li>
{| class="wikitable" style="background-color:#ffffdc;width:Serial800px;" |-| <big>'''注意，下面的git clone--recursive命令会自动下载wiringOP的源码，因为wiringOP-Python是依赖wiringOP的。请确保下载过程没有因为网络问题而报错。'''
|}
|-
|
|}
</liol><ol start="3" style="list-style-type: decimal;"><li><p>然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功然后使用下面的命令编译wiringOP-Python并将其安装到开发板的Linux系统中</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~/wiringOP-Python# '''python3 cd wiringOP-c "import wiringpi; \Python'''</p><p>root@orangepi:~/wiringOP-Python# '''from wiringpi import GPIOpython3 generate-bindings.py > wiringpibindings.wiringPiSetup() ;\i'''</p><p>root@orangepi:~/wiringOP-Python# '''wiringpisudo python3 setup.digitalWrite(2, <span style="color:#FF0000">GPIO.LOW</span>)"py install'''</p>
|}
</li>
<li><p>然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功然后输入下面的命令，如果有帮助信息输出，说明wiringOP-Python安装成功，按下'''q'''键可以退出帮助信息的界面</p></li>
{| class="wikitable" style="width:800px;"
|-
|
<ol style="list-style-type: lower-alpha;">
<li><p>首先使用python3命令进入python3的命令行模式</pli>
{| class="wikitable" style="width:800px;"
|-
|
|}
</liol><liol start="2" style="list-style-type: lower-alpha;"><pli>然后导入wiringpi的python模块</pli>
{| class="wikitable" style="width:800px;"
|-
|
|}
</liol><liol start="3" style="list-style-type: lower-alpha;"><pli>然后设置GPIO口为输出模式，其中最后输入下面的命令可以查看下wiringOP-Python的帮助信息，按下'''pinModeq'''函数的第一个参数是引脚对应的wPi的序号，第二个参数是GPIO的模式键可以退出帮助信息的界面</pli>
{| class="wikitable" style="width:800px;"
|-
|
|}
</ol>
</li></ol>
|}
<ol style="list-style-type: decimal;">
<li><p>由26pin的原理图可知，可用的i2c为i2c3下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平</p><p>[[File:media/image178zero3-img173.png|575x204px]]</p></li><li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：直接用命令测试的步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先运行下首先设置GPIO口为输出模式，其中'''orangepi-configpinMode'''，普通用户记得加'''sudo'''权限函数的第一个参数是引脚对应的wPi的序号，第二个参数是GPIO的模式</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~$ /wiringOP-Python# '''sudo orangepipython3 -configc "import wiringpi; \'''</p><p>'''from wiringpi import GPIO; wiringpi.wiringPiSetup() ; \'''</p><p>'''wiringpi.pinMode(<span style="color:#FF0000">2, GPIO.OUTPUT</span>) ; "'''</p>
|}
</li>
<li><p>然后选择'''System'''</p><p>[[File:media/image86.png|398x194px]]</p></li><li><p>然后选择'''Hardware'''</p><p>[[File:media/image87.png|393x202px]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-i2c3'''</p><p>[[File:media/image179.png|401x59px]]</p></li><li><p>然后选择'''<Save>'''保存</p><p>[[File:media/image89.png|397x92px]]</p></li><li><p>然后选择'''<Back>'''</p><p>[[File:media/image90.png|395x91px]]</p></li><li><p>然后选择'''<Reboot>'''重启系统使配置生效</p><p>[[File:media/image91.png|374x187px]]</p></li></ol></li><li><p>启动linux系统后，先确认下/dev下存在i2c3的设备节点然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~$ /wiringOP-Python# '''ls /dev/i2cpython3 -3c "import wiringpi; \'''</p><p>'''from wiringpi import GPIO; wiringpi.wiringPiSetup() ;\'''</devp><p>'''wiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.LOW</i2c-3span>)"'''</p>
|}
</li>
<li><p>然后开始测试i2c，首先安装下i2c-tools然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.3v，说明设置高电平成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~$ /wiringOP-Python# '''sudo aptpython3 -get updatec "import wiringpi; \'''</p><p>orangepi@orangepi:~$ '''sudofrom wiringpi import GPIO; wiringpi.wiringPiSetup() ;\''' </p><p>'''apt-get install -y i2c-toolswiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.HIGH</span>)"'''</p>
|}
</li></ol>
</li>
<li><p>然后在26pin接头的i2c3引脚上接一个i2c设备，这里以DS1307 RTC模块为例在python3的命令行中测试的步骤如下所示：</p><pol style="list-style-type: lower-alpha;"><li>[[File:media/image186.png|180x153px]]</p>首先使用python3命令进入python3的命令行模式</lip>
{| class="wikitable" style="width:800px;"
|-
| style="text-align<p>root@orangepi: left;"| ~# '''RTC模块的引脚python3'''</p>| }</li><li><p>然后导入wiringpi的python模块</p>{| class="wikitable" style="text-alignwidth: left800px;"| '''开发板26pin对应的引脚'''
|-
| style="text-align: left;"| '''5V'''| style="text-align: left<p>>"| '''2号引脚'''|-| style="text-align: left;"| '''GND'''| style="text-align: left>"| '''6号引脚'''|-| style="text-align: left>"| '''SDAimport wiringpi'''</p>| style="text-align: left<p>>"| '''3号引脚'''|-| style="text-align: left>"| '''SCL'''| style="text-align: left>"| '''5号引脚from wiringpi import GPIO'''</p>
|}
{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~/wiringOP-Python# >>> '''cd exampleswiringpi.wiringPiSetup()'''</p><p>root@orangepi:~/wiringOP-Python/examples# '''python3 ds1307.py --device \'''0</p><p>'''"gt;>/dev/i2c-3"gt;'''wiringpi.pinMode(</p><p>Thu 2022-06-16 04span style="color:35:46</p#FF0000"><p>Thu 2022-06-16 04:35:472, GPIO.OUTPUT</pspan><p>Thu 2022-06-16 04:35:48</p><p>^C</p><p>exit)'''</p>
|}
</li></ol> <span id="pin的uart测试-1"></span> === 26pin的UART测试 === <ol style="list-style-type: decimal;"><li><p>由26pin接口的原理图可知，可用的uart为uart5</p><p>[[File:media/image181.png|575x203px]]</p></li><li><p>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p><ol style="list-style-type: lower-alpha;"><li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限然后设置GPIO口输出低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为0v，说明设置低电平成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ >>> '''sudo orangepi-configwiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.LOW</span>)'''</p>
|}
</li>
<li><p>然后选择'''System'''</p><p>[[File:media/image86.png|398x194px]]</p></li><li><p>然后选择'''Hardware'''</p><p>[[File:media/image87.png|393x202px]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-uart5'''</p><p>[[File:media/image182然后设置GPIO口输出高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为3.png|400x60px]]3v，说明设置高电平成功</p></li><li><p>然后选择'''<Save>'''保存</p><p>[[File:media/image89.png|397x92px]]</p></li><li><p>然后选择'''<Back>'''</p><p>[[File:media/image90.png|395x91px]]</p></li><li><p>然后选择'''<Reboot>'''重启系统使配置生效</p><p>[[File:media/image91.png|374x187px]]</p></li></ol></li><li><p>进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''注意，linux5.4系统为/dev/ttyAS5。'''</p></big>|}
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ >>> '''ls wiringpi.digitalWrite(2, <span style="color:#FF0000">GPIO.HIGH</dev/ttyS5span>)'''</p><p>/dev/ttyS5</p>
|}
</li></ol>
</li>
<li><p>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx</p></li> {| class="wikitable" style="width:800px;" |wiringOP-|| style="text-align: left;"| Python在python代码中设置GPIO高低电平的方法可以参考下examples中的'''uart5blink.py'''|-| '''tx引脚'''| style="text-align: left;"| '''对应26pin中的8号引脚'''|-| '''rx引脚'''| style="text-align: left;"| '''对应26pin中的10号引脚'''|}</ol><ol start="5" style="list-style-type: decimal;"><li><p>最后可以运行examples中的测试程序，'''serialTestblink.py'''程序来测试下串口的回环功能，如果能看到下面的打印，说明串口回环测试正常测试程序会设置开发板26 pin中所有的GPIO口的电压不断的高低变化</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~/wiringOP-Python# '''cd examples'''</p>
<p>root@orangepi:~/wiringOP-Python/examples# '''python3 serialTestls blink.py --device "'''</dev/ttyS5" # linux6p><p>'''blink.1使用py'''</p><p>root@orangepi:~/wiringOP-Python/examples# '''# python3 serialTestblink.py --device "/dev/ttyAS5" # linux5.4使用'''</p> <p>Out: 0: -> 0</p><p>Out: 1: -> 1</p><p>Out: 2: -> 2</p><p>Out: 3: -> 3</p><p>Out: 4:^C</p><p>exit</p>
|}
</li></ol>
<span id== 硬件看门狗测试 =="pin-spi测试-1"></span>
<ol style="list-style-type: decimal;">
<li><p>由26pin接口的原理图可知，可用的spi为spi1</p>
<p>[[File:zero3-img176.png]]</p></li>
<li><p>Linux系统中spi1默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>第二个参数10表示看门狗的计数时间，如果这个时间内没有喂狗，系统会重启</p></li><li><p>我们可以通过按下键盘上的任意键（ESC除外）来喂狗，喂狗后，程序会打印一行keep alive表示喂狗成功首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo watchdog_test 10orangepi-config'''</p><p>open success</p><p>options is 33152,identity is sunxi-wdt</p><p>put_usr return,if 0,success:0</p><p>The old reset time is: 16</p><p>return ENOTTY,if -1,success:0</p><p>return ENOTTY,if -1,success:0</p><p>put_user return,if 0,success:0</p><p>put_usr return,if 0,success:0</p><p>keep alive</p><p>keep alive</p><p>keep alive</p>
|}
</li><li><p>然后选择'''System'''</p><p>[[File:zero3-img86.png]]</p></li><li><p>然后选择'''Hardware'''</p><p>[[File:zero3-img87.png]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''spi1-cs1-spidev'''</p><p>[[File:zero3-img177.png]]</p></li><li><p>然后选择'''<Save>'''保存</olp><p>[[File:zero3-img89.png]]</p></li><span id="查看h618芯片的chipid"li><p>然后选择'''<Back>'''</spanp><p>[[File:zero3-img90.png]]</p></li>== 查看H618芯片的chipid ==<li><p>然后选择'''<Reboot>'''重启系统使配置生效</p><p>[[File:zero3-img91.png]]</p></li></ol>查看H618芯片chipid的命令如下所示，每个芯片的chipid都是不同的，所以可以使用chipid来区分多个开发板。</li><li><p>然后查看下linux系统中是否存在'''spidev1.1'''的设备节点，如果存在，说明SPI1的配置已经生效了</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cat ls /sysdev/class/sunxi_info/sys_info | grep "chipid"spidev1*'''</p> sunxi_chipid : 338020004c0048080147478824681ed1<p>/dev/spidev1.1</p>
|}
</li>
<li><p>然后可以使用examples中的'''spidev_test.py'''程序测试下SPI的回环功能，'''spidev_test.py'''程序需要指定下面的两个参数：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''--channel'''：指定SPI的通道号</p></li>
<li><p>'''--port'''：指定SPI的端口号</p></li></ol>
</li>
<li><p>先不短接 SPI1 的 mosi 和 miso 两个引脚，运行spidev_test.py的输出结果如下所示，可以看到 TX 和 RX 的数据不一致</p>
{| class="wikitable" style="width:800px;"
|-
|
root@orangepi:~/wiringOP-Python# '''cd examples'''
spi mode: 0x0 max speed: 500000 Hz (500 KHz) Opening device /dev/spidev1.1 TX | FF FF FF FF FF FF '''<span idstyle="python源码编译安装的方法color:#FF0000">40 00 00 00 00 95</span>=== Python源码编译安装的方法 ===''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|
RX | FF FF FF FF FF FF '''<span style="color:#FF0000">FF FF FF FF FF FF</span>''' FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF |.............….||}</li></ol><ol start="6" style="list-style-type: decimal;"><li><p>然后使用杜邦线短接SPI1的txd（26pin接口中的第19号引脚）和rxd（26pin接口中的第21号引脚）两个引脚再运行spidev_test.py的输出如下，可以看到发送和接收的数据一样，说明SPI1回环测试正常</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
RX | FF FF FF FF FF FF '''下面演示的是编译安装Python3.9的最新版本，如果要编译安装其他的版本的Python，方法也是一样的（需要下载想要安装的Python对应的源码）。<span style="color:#FF0000">40 00 00 00 00 95</span>'''</big>FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0 0D |......@.......…|
|}
</li></ol>
<span id="pin-i2c测试-1"></span>
=== 26pin I2C测试 ===
<ol style="list-style-type: decimal;">
<li><p>首先安装编译Python需要的依赖包由26pin的原理图可知，可用的i2c为i2c3</p><p>[[File:zero3-img178.png]]</p></li><li><p>Linux系统中i2c3默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p><ol style="list-style-type: lower-alpha;"><li><p>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p><p>orangepi@orangepi:~$ '''sudo apt-get install -y build-essential zlib1g-dev \'''</p><p>'''libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev \'''</p><p>'''libreadline-dev libffi-dev curl libbz2-devconfig'''</p>
|}
</li>
<li><p>然后下载最新版本的Python3.9源码并解压然后选择'''System'''</p>{| class="wikitable" style="width<p>[[File:800px;" |zero3-img86.png]]</p></li>| <li><p>orangepi@orangepi:~$ 然后选择'''wget \Hardware'''</p><p>[[File:zero3-img87.png]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'https''ph-i2c3'''</p><p>[[File://wwwzero3-img179.python.orgpng]]</ftpp></pythonli><li><p>然后选择'''<Save>'''保存</3p><p>[[File:zero3-img89.9.10png]]</p></Python-3.9.10.tgzli><li><p>然后选择'''<Back>'''</p><p>orangepi@orangepi[[File:~$ zero3-img90.png]]</p></li><li><p>然后选择'''tar xvf Python-3.9.10.tgz<Reboot>'''重启系统使配置生效</p>|}<p>[[File:zero3-img91.png]]</p></li></ol>
</li>
<li><p>然后运行配置命令启动linux系统后，先确认下/dev下存在i2c3的设备节点</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd Pythonls /dev/i2c-3.9.10'''</p><p>orangepi@orangepi:~$ '''./configure dev/i2c--enable-optimizations3'''</p>
|}
</li>
<li><p>然后编译安装Python3.9，编译时间大概需要半个小时左右然后开始测试i2c，首先安装下i2c-tools</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''make sudo apt-j4get update'''</p><p>orangepi@orangepi:~$ '''sudo make altinstall''' '''apt-get install -y i2c-tools'''</p>
|}
</li>
<li><p>安装完后可以使用下面的命令查看下刚安装的Python的版本号然后在26pin接头的i2c3引脚上接一个i2c设备，这里以DS1307 RTC模块为例</p><p>[[File:zero3-img186.png]]</p></li>
{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| '''RTC模块的引脚'''| style="text-align: left;"| '''开发板26pin对应的引脚'''|-| style="text-align: left;"| '''5V'''| style="text-align: left;"| '''2号引脚'''|-| style="text-align: left;"| '''GND'''| style="text-align: left;"| '''6号引脚'''|-| style="text-align: left;"| '''SDA'''<p>orangepi@orangepi| style="text-align:~$ left;"| '''3号引脚''python3.9 '|-| style="text-versionalign: left;"| '''SCL'''</p><p>| style="text-align: left;"| '''Python 3.9.105号引脚'''</p>
|}
</ol><ol start="6" style="list-style-type: decimal;"><li>然后使用'''i2cdetect -y 3'''命令如果能检测到连接的i2c设备的地址，就说明i2c设备连接正确</li> [[File:zero3-img187.png]]</ol><ol start="7" style="list-style-type: decimal;"><li><p>然后更新下pip然后可以运行'''examples'''中的'''ds1307.py'''测试程序读取RTC的时间</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~$ /wiringOP-Python# '''cd examples'''</usrp><p>root@orangepi:~/local/binwiringOP-Python/examples# '''python3ds1307.9 py -m pip install -device \'''</p><p>'''"/dev/i2c-upgrade pip3"'''</p>|}<p>Thu 2022-06-16 04:35:46</p><p>Thu 2022-06-16 04:35:47</p><p>Thu 2022-06-16 04:35:48</p><p>^C</lip><p>exit</olp>|}<span id="python更换pip源的方法"/li></spanol>
<span id=== Python更换pip源的方法 ==="pin的uart测试-1"></span>
<ol style="list-style-type: decimal;">
<li><p>首先安装下由26pin接口的原理图可知，可用的uart为uart5</p><p>[[File:zero3-img181.png]]</p></li><li><p>Linux系统中uart5默认是关闭的，需要手动打开才能使用。打开步骤如下所示：</p><ol style="list-style-type: lower-alpha;"><li><p>首先运行下'''python3orangepi-pipconfig'''，普通用户记得加'''sudo'''权限</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p><p>orangepi@orangepi:~$ '''sudo apt-get install -y python3-pipconfig'''</p>
|}
</li>
<li><p>Linux下永久更换pip源的方法然后选择'''System'''</p><ol style="listp>[[File:zero3-img86.png]]</p></li><li><p>然后选择'''Hardware'''</p><p>[[File:zero3-styleimg87.png]]</p></li><li><p>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中'''ph-typeuart5'''</p><p>[[File: lowerzero3-alphaimg182.png]]</p></li><li><p>然后选择'''<"Save>'''保存</p><p>[[File:zero3-img89.png]]</p></li><li><p>先新建然后选择'''<Back>'''~</p><p>[[File:zero3-img90.pippng]]</p></li><li><p>然后选择'''目录，然后添加<Reboot>'''pip重启系统使配置生效</p><p>[[File:zero3-img91.confpng]]</p></li></ol></li><li><p>进入linux系统后，先确认下'''/dev'''配置文件，并在其中设置pip的源为清华源下是否存在uart5的设备节点</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''mkdir -p ~/.pip'''</p><p>orangepi@orangepi:~$ '''cat <<EOF > ~/.pip/pip.conf'''</p><p>'''[global]'''</p><p>'''timeout = 6000'''</pbig><p>'''index-url = https://pypi注意，linux5.tuna.tsinghua.edu.cn4系统为/simple'''<dev/p><p>'''trusted-host = pypi.tuna.tsinghua.edu.cnttyAS5。'''</p><p>'''EOF'''</pbig>
|}
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''pip3 install <packagename> -i \ls /dev/ttyS5'''</p><p>'''https:/dev/pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn'''ttyS5</p>
|}
</li></olli> <span id="安装docker的方法"p>然后开始测试uart5接口，先使用杜邦线短接要测试的uart5接口的rx和tx</spanp></li> == 安装Docker的方法 == Orange Pi提供的linux镜像已经预装了Docker，只是Docker服务默认没有打开。使用'''enable_docker.sh'''脚本可以使能docker服务，然后就可以开始使用docker命令了，并且在下次启动系统时也会自动启动docker服务。
{| class="wikitable" style="width:800px;"
|-
| orangepi@orangepi| style="text-align:~$ left;"| '''enable_docker.shuart5'''|-| '''tx引脚'''| style="text-align: left;"| '''对应26pin中的8号引脚'''|-| '''rx引脚'''| style="text-align: left;"| '''对应26pin中的10号引脚'''
|}
</ol>可以使用下面的命令测试下docker，如果能运行<ol start="5" style="list-style-type: decimal;"><li><p>最后可以运行examples中的'''hello-worldserialTest.py'''说明docker能正常使用了。程序来测试下串口的回环功能，如果能看到下面的打印，说明串口回环测试正常</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>root@orangepi:~/wiringOP-Python# '''cd examples'''</p><p>root@orangepi:~$ /wiringOP-Python/examples# '''docker run hellopython3 serialTest.py --device "/dev/ttyS5" # linux6.1使用'''</p><p>root@orangepi:~/wiringOP-Python/examples# '''python3 serialTest.py --worlddevice "/dev/ttyAS5" # linux5.4使用'''</p>
<ol style="list-style-type: lower-alpha;">
<li><p>第二个参数10表示看门狗的计数时间，如果这个时间内没有喂狗，系统会重启</p></li>
<li><p>我们可以通过按下键盘上的任意键（ESC除外）来喂狗，喂狗后，程序会打印一行keep alive表示喂狗成功</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo usermod -aG docker $USERwatchdog_test 10'''</p><p>open success</p><p>options is 33152,identity is sunxi-wdt</p><p>put_usr return,if 0,success:0</p><p>The old reset time is: 16</p><p>return ENOTTY,if -1,success:0</p><p>return ENOTTY,if -1,success:0</p><p>put_user return,if 0,success:0</p><p>put_usr return,if 0,success:0</p><p>keep alive</p><p>keep alive</p><p>keep alive</p>
|}
</li></ol>
<span id="查看h618芯片的chipid"></span>
== 查看H618芯片的chipid ==
查看H618芯片chipid的命令如下所示，每个芯片的chipid都是不同的，所以可以使用chipid来区分多个开发板。 {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
|}
<span id="home-assistant的安装方法python相关说明"></span> == Python相关说明 ==
<span id="python源码编译安装的方法"></span>=== Python源码编译安装的方法 = Home Assistant的安装方法 ==
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big>'''注意，这里只会提供在Ubuntu或者Debian系统中安装Home Assistant的方法，Home Assistant详细的使用方法请参考官方文档或者相应的书籍。如果使用的Ubuntu或者Debian系统软件仓库中的Python版本不符合开发的要求，想要使用最新版本的Python，可以使用下面的方法下载Python的源码包来编译安装最新版本的Python。''' '''下面演示的是编译安装Python3.9的最新版本，如果要编译安装其他的版本的Python，方法也是一样的（需要下载想要安装的Python对应的源码）。'''</big>
|}
<ol style="list-style-type: decimal;">
<li><p>首先请安装好docker，并确保docker能正常运行。docker的安装步骤请参考[[Orange Pi Zero 3#安装Docker的方法|'''安装Docker的方法''']]一节的说明。</p></li><li><p>然后可以搜索下Home Assistant的docker镜像首先安装编译Python需要的依赖包</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''docker search homeassistantsudo apt-get update'''</p><p>orangepi@orangepi:~$ '''sudo apt-get install -y build-essential zlib1g-dev \'''</p><p>'''libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev \'''</p><p>'''libreadline-dev libffi-dev curl libbz2-dev'''</p>
|}
</li>
<li><p>然后使用下面的命令下载Home Assistant的docker镜像到本地，镜像大小大概有1GB多，下载时间会比较长，请耐心等待下载完成然后下载最新版本的Python3.9源码并解压</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''docker pull homeassistant/home-assistantwget \'''</p><p>Using default tag'''https: latest</p><p>latest: Pulling from homeassistant/home-assistant<www.python.org/p><p>be307f383ecc: Downloading<ftp/p><p>5fbc4c07ac88: Download complete<python/p><p>'''.3.9.10/Python-3.9.10. (省略部分输出)tgz'''</p><p>3cc6a1510c9forangepi@orangepi: Pull complete</p><p>7a4e4d5b979f: Pull complete</p><p>Digest: sha256:81d381f5008c082a37da97d8b08dd8b358dae7ecf49e62ce3ef1eeaefc4381bb</p><p>Status: Downloaded newer image for homeassistant/home~$ '''tar xvf Python-assistant:latest</p><p>docker3.9.10.io/homeassistant/home-assistant:latesttgz'''</p>
|}
</li>
<li><p>然后可以使用下面的命令查看下刚下载的Home Assistant的docker镜像然后运行配置命令</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''docker images homeassistant/homecd Python-assistant3.9.10'''</p><p>REPOSITORY TAG IMAGE ID CREATED SIZE</p><p>homeassistant/home-assistant latest bfa0ab9e1cf5 2 months ago orangepi@orangepi:~$ '''<span style="color:#FF0000">1.17GB</span>configure --enable-optimizations'''</p>
|}
</li>
<li><p>此时就可以运行Home Assistant的docker容器了然后编译安装Python3.9，编译时间大概需要半个小时左右</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''docker run make -d \j4'''</p>:<p>'''--name homeassistant \'''</p>:<p>'''--privileged \'''</p>:<p>'''--restart=unless-stopped \'''</p>:<p>'''-e TZ=Asia/Shanghai \'''</p>:<p>'''-v /home/orangepi/home-assistant:/config \'''</p>:<p>'''--network=host \'''</p>@orangepi:<p>~$ '''homeassistant/home-assistant:latestsudo make altinstall'''</p>
|}
</li>
<li><p>然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''</p></big>|}<p>[[File:media/image188.png|576x209px]]</p></li><li><p>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''</p><p>[[File:media/image189.png|220x279px]]</p></li><li><p>然后按照界面提示根据自己的喜好设置，再点击下一步</p><p>[[File:media/image190.png|575x297px]]</p></li><li><p>然后点击下一步</p><p>[[File:media/image191.png|576x185px]]</p></li><li><p>然后点击完成</p><p>[[File:media/image192.png|576x117px]]</p></li><li><p>Home Assistant最终显示的主界面如下图所示</p><p>[[File:media/image193.png|574x294px]]</p></li><li><p>停止Home Assistant容器的方法</p><ol style="list-style-type: lower-alpha;"><li><p>查看docker容器的命令如下所示安装完后可以使用下面的命令查看下刚安装的Python的版本号</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''docker ps python3.9 -a-version'''</p><p>'''Python 3.9.10'''</p>
|}
</li>
<li><p>停止Home Assistant容器的命令如下所示然后更新下pip</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''docker stop homeassistant/usr/local/bin/python3.9 -m pip install --upgrade pip'''</p>
|}
</li><li><p>删除Home Assistant容器的命令如下所示</pol>{| class="wikitable" style<span id="width:800px;python更换pip源的方法" |-| <p>orangepi@orangepi:~$ '''docker rm homeassistant'''</p>|}</li></ol></li></olspan>
=== 通过python安装 Python更换pip源的方法 ===
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big>'''安装前请先更换下pip的源为国内源，加快Python包的安装速度，配置方法见[[Orange Pi Zero 3#Python更换pip源的方法|'''Python更换pip源的方法''']]一节的说明。Linux系统pip默认使用的源为Python官方的源，但是国内访问Python官方的源速度是很慢的，并且经常会由于网络原因导致Python软件包安装失败。所以在使用pip安装Python库时，请记得更换下pip源。'''</big>
|}
<ol style="list-style-type: decimal;">
<li><p>首先安装依赖包首先安装下'''python3-pip'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p>
<p>orangepi@orangepi:~$ '''sudo apt-get install -y python3 python3-dev python3-venv \'''</p><p>'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''</p><p>'''libopenjp2-7 libtiff5 libturbojpeg0-dev tzdata'''</p>
|}
</li><li><p>Linux下永久更换pip源的方法</p><ol style="list-style-type: lower-alpha;"><li><p>先新建'''~/.pip'''目录，然后添加'''pip.conf'''配置文件，并在其中设置pip的源为清华源</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
|}
</li>
<li><p>然后需要编译安装Python3.9，方法请参考[[Orange Pi Zero 3#Python源码编译安装的方法|'''Python源码编译安装的方法''']]一节然后使用pip3安装Python库速度就会很快了</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''Debian Bullseye默认的Python版本就是Python3.9，所以无需编译安装。'''</p><p>'''Ubuntu Jammy默认的Python版本就是Python3.10，所以也无需编译安装。'''</p><p>'''Debian Bookworm默认的Python版本就是Python3.11，所以也无需编译安装。'''</pli></bigol>|}
</li>
<li><p>然后创建Python虚拟环境Linux下临时更换pip源的方法，其中的'''<packagename>'''需要替换为具体的包名</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''pip3 install <packagename> -i \'''</p><p>'''Debian Bookworm中是python3https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.11，请记得替换对应的命令。cn'''</p></big>
|}
</li></ol>
<span id="安装docker的方法"></span>
== 安装Docker的方法 ==
Orange Pi提供的linux镜像已经预装了Docker，只是Docker服务默认没有打开。使用'''enable_docker.sh'''脚本可以使能docker服务，然后就可以开始使用docker命令了，并且在下次启动系统时也会自动启动docker服务。
{| class="wikitable" style="width:800px;"
|-
|
|}
{| class="wikitable" style="width:800px;"
|-
|
|}
{| class="wikitable" style="width:800px;"
|-
|
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>'''第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。注意：需要退出重新登录系统才能生效，重启系统也可以。'''</p></big>
|}
<span id="opencv的安装方法home-assistant的安装方法"></span> == Home Assistant的安装方法 ==
{| class="wikitable" style= OpenCV的安装方法 =="background-color:#ffffdc;width:800px;" |-| <big>'''注意，这里只会提供在Ubuntu或者Debian系统中安装Home Assistant的方法，Home Assistant详细的使用方法请参考官方文档或者相应的书籍。'''</big>|}
<ol style="list-style-type: decimal;">
<li><p>安装命令如下所示首先请安装好docker，并确保docker能正常运行。docker的安装步骤请参考[[Orange Pi Zero 3#安装Docker的方法|'''安装Docker的方法''']]一节的说明。</p></li><li><p>然后可以搜索下Home Assistant的docker镜像</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p><p>orangepi@orangepi:~$ '''sudo apt-get install -y libopencv-dev python3-opencvdocker search homeassistant'''</p>
|}
</li>
<li><p>然后使用下面的命令打印OpenCV的版本号输出正常，说明OpenCV安装成功</p><ol style="list-style-type: lower-alpha;"><li><p>Ubuntu22.04中OpenCV的版本如下所示：然后使用下面的命令下载Home Assistant的docker镜像到本地，镜像大小大概有1GB多，下载时间会比较长，请耐心等待下载完成</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3 docker pull homeassistant/home-c "import cv2; print(cv2.__version__)"assistant'''</p><p>Using default tag: latest</p><p>latest: Pulling from homeassistant/home-assistant</p><p>be307f383ecc: Downloading</p><p>5fbc4c07ac88: Download complete</p><p>'''4.5.4.... (省略部分输出)'''</p><p>3cc6a1510c9f: Pull complete</p><p>7a4e4d5b979f: Pull complete</p><p>Digest: sha256:81d381f5008c082a37da97d8b08dd8b358dae7ecf49e62ce3ef1eeaefc4381bb</p><p>Status: Downloaded newer image for homeassistant/home-assistant:latest</p><p>docker.io/homeassistant/home-assistant:latest</p>
|}
</li>
<li><p>Ubuntu20.04中OpenCV的版本如下所示：然后可以使用下面的命令查看下刚下载的Home Assistant的docker镜像</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3 docker images homeassistant/home-c assistant'''</p><p>REPOSITORY "nbsp;import cv2 TAG IMAGE ID CREATED print(cv2.__version__)"nbsp;'''SIZE</p><p>homeassistant/home-assistant latest bfa0ab9e1cf5 2 months ago '''4<span style="color:#FF0000">1.2.017GB</span>'''</p>
|}
</li>
<li><p>Debian11中OpenCV的版本如下所示：此时就可以运行Home Assistant的docker容器了</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3 docker run -c "import cv2; print(cv2.__version__)"d \'''</p>:<p>'''4.5.1--name homeassistant \'''</p>:<p>'''--privileged \'''</p>:<p>'''--restart=unless-stopped \'''</p>:<p>'''-e TZ=Asia/Shanghai \'''</p>:<p>'''-v /home/orangepi/home-assistant:/config \'''</p>:<p>'''--network=host \'''</p>:<p>'''homeassistant/home-assistant:latest'''</p>
|}
</li>
<li><p>Debian12中OpenCV的版本如下所示：然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>orangepi@orangepi:~$ '''python3 -c "import cv2; print(cv2.__version__)"Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''</p><p>'''4.6.0'''</pbig>
|}
<p>[[File:zero3-img188.png]]</p></li><li><p>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''</p><p>[[File:zero3-img189.png]]</p></li><li><p>然后按照界面提示根据自己的喜好设置，再点击下一步</olp><p>[[File:zero3-img190.png]]</p></li><li><p>然后点击下一步</olp><p>[[File:zero3-img191.png]]</p></li><li><p>然后点击完成</p><p>[[File:zero3-img192.png]]</p></li><span id="宝塔linux面板的安装方法"li><p>Home Assistant最终显示的主界面如下图所示</p><p>[[File:zero3-img193.png]]</p></spanli><li><p>停止Home Assistant容器的方法</p><ol style== 宝塔Linux面板的安装方法 =="list-style-type: lower-alpha;"><li><p>查看docker容器的命令如下所示</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''宝塔Linux面板是提升运维效率的服务器管理软件，支持一键LAMP/LNMP/集群/监控/网站/FTP/数据库/JAVA等100多项服务器管理功能（摘抄自[https://www.bt.cn/ 宝塔官网]）docker ps -a'''</bigp>
|}
<ol style="list-style-type: decimal;"/li><li><p>首先需要扩展下'''/tmp'''空间的大小，设置完后需要'''<span style="color:#FF0000">重启下开发板的linux系统</span>'''，命令如下所示：停止Home Assistant容器的命令如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo sed -i 's/nosuid/&,size=2G/' /etc/fstab'''</p><p>orangepi@orangepi:~$ '''sudo rebootdocker stop homeassistant'''</p>
|}
</li>
<li><p>重启后，可以看到'''/tmp'''空间的大小变为2G了删除Home Assistant容器的命令如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''df -h | grep "/tmp"docker rm homeassistant'''</p><p>tmpfs 2.0G 12K '''<span style="color:#FF0000">2.0G</span>''' 1% /tmp</p>
|}
</li></ol></li><p>然后在linux系统中输入下面的命令就可以开始宝塔的安装</pol> === 通过python安装 === {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<pbig>orangepi@orangepi:~$ '''sudo install_bt_panel.sh安装前请先更换下pip的源为国内源，加快Python包的安装速度，配置方法见[[Orange Pi Zero 3#Python更换pip源的方法|'''Python更换pip源的方法''']]一节的说明。'''</pbig>
|}
</liol style="list-style-type: decimal;"><li><p>然后宝塔安装程序会提醒是否安装'''Bt-Panel'''到'''/www'''文件夹，此时输入'''y'''即可首先安装依赖包</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>+---------------------------------------------------------------------orangepi@orangepi:~$ '''sudo apt-get update'''</p><p>| Btorangepi@orangepi:~$ '''sudo apt-get install -y python3 python3-dev python3-WebPanel FOR CentOS/Ubuntu/Debianvenv \'''</p><p>+----------------------------------------------------------------'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''</p><p>| Copyright © 2015'''libopenjp2-2099 BT7 libtiff5 libturbojpeg0-SOFT(http://www.bt.cn) All rights reserved.dev tzdata'''</p><p>+--------------------------------------------------------------------|}{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| </pbig><p>| The WebPanel URL will be http://SERVER_IP:8888 when installed.'''如果是debian12请使用下面的命令：'''</p><p>+----------------------------------------------------------------------</pbig>
<p>orangepi@orangepi:~$ '''sudo apt-get update'''</p><p>Do you want to orangepi@orangepi:~$ '''sudo apt-get install Bt-Panel to the /www directory now?(ypython3 python3-dev python3-venv \'''</n): p><p>'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''<span style="color:#FF0000"/p>y</spanp>'''libopenjp2-7 libturbojpeg0-dev tzdata'''</p>
|}
</li>
<li><p>然后要做的就是耐心等待，当看到终端输出下面的打印信息时，说明宝塔已经安装完成，整个安装过程大约耗时34分钟，根据网络速度的不同可能会有一些差别</p><p>[[File:media/image195然后需要编译安装Python3.png|576x233px]]</p></li><li><p>此时在浏览器中输入上面显示的'''面板地址'''就可以打开宝塔Linux面板的登录界面，然后在对应的位置输入上图显示的'''username'''和'''password'''就可以登录进宝塔<br />9，方法请参考[[File:media/image196.pngOrange Pi Zero 3#Python源码编译安装的方法|575x281px]]</p></li><li><p>成功登录宝塔后的会弹出下面的欢迎界面，首先请将中间的用户须知阅读完拖到最下面，然后就可以选择”我已同意并阅读《用户协议》“，接着点击”进入面板”就可以进入宝塔了</p><p>[[File:media/image197.png|575x317px]]</p></li><li><p>进入宝塔后首先会提示需要绑定宝塔官网的账号，如果没有账号可以去宝塔的官网（'''https://www.bt.cnPython源码编译安装的方法'''）注册一个</p><p>[[File:media/image198.png|576x300px]]</p></li><li><p>最终显示的界面如下图所示，可以很直观的看到开发板Linux系统的一些状态信息，比如负载状态、CPU的使用率、内存使用率和存储空间的使用情况等</p><p>[[File:media/image199.png|575x306px]]</p></li><li><p>宝塔的更多功能可以参考下面资料自行探索一节</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>使用手册：[http://docs.bt.cn '''http://docsDebian Bullseye默认的Python版本就是Python3.bt.cn9，所以无需编译安装。''']</p><p>论坛地址：[https://www.bt.cn/bbs '''https://www.btUbuntu Jammy默认的Python版本就是Python3.cn/bbs10，所以也无需编译安装。''']</p><p>GitHub链接：'''https://githubDebian Bookworm默认的Python版本就是Python3.com/aaPanel/BaoTa11，所以也无需编译安装。'''</p></big>
|}
</li><li><p>然后创建Python虚拟环境</olp> == face_recognition人脸识别库的安装和测试方法 ==
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big>'''注意，此小节的内容都是在<span style="color:#FF0000"p>桌面版本</span>的Linux系统中测试的，所以请确保开发板使用的系统为桌面版本的系统。''' Debian Bookworm中是python3.11，请记得替换对应的命令。'''另外下面的安装测试都是在<span style="color:#FF0000">orangepi</spanp>用户下进行的，请保持环境一致。''' '''Debian12目前没有适配。'''</big>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''face_recognition源码仓库的地址为：sudo mkdir /srv/homeassistant'''</p> <p>orangepi@orangepi:~$ '''httpssudo chown orangepi:orangepi /srv/github.com/ageitgey/face_recognitionhomeassistant'''</p> <p>orangepi@orangepi:~$ '''face_recognition中文版本的说明文档为：''' '''https:cd /srv/github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.mdhomeassistant'''</big>|} === 使用脚本自动安装face_recognition的方法 === <ol style="list-style-type: decimal;"p><li><p>首先在桌面中打开一个终端，然后下载orangepi@orangepi:~$ '''face_recognition_installpython3.9 -m venv .sh'''</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~/Desktop$ '''wget \source bin/activate'''</p><p>'''https(homeassistant) orangepi@orangepi:/srv/gitee.com/leeboby/face_recognition_install/raw/master/face_recognition_install.sh'''homeassistant$</p>
|}
</li>
<li><p>然后执行下面的命令开始安装'''face_recognition'''然后安装需要的Python包</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>(homeassistant) orangepi@orangepi:~/Desktopsrv/homeassistant$ '''bash face_recognition_install.shpython3 -m pip install wheel'''</p>
|}
</li>
<li><p>face_recognition安装完后会自动下载face_recognition的源码，然后自动运行face_recognition中的一些示例，如果最后能看到桌面上弹出了下面的这些图片就说明face_recognition安装测试成功了</p><p>[[File:media/image200.png|576x324px]]</p></li></ol> === 手动安装face_recognition的方法 === <ol style="list-style-type: decimal;"><li><p>首先新建'''~/.pip'''目录，再添加'''pip.conf'''配置文件，并在其中设置pip的镜像源为清华源，需要执行的命令如下所示：然后就可以安装Home Assistant Core</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>(homeassistant) orangepi@orangepi:~$ '''mkdir -p ~/.pip'''<srv/p><p>orangepi@orangepi:~homeassistant$ '''cat <<EOF > ~/.pip/pip.conf'''</p><p>'''[global]'''</p><p>'''timeout = 6000'''</p><p>'''index-url = https://pypi.tuna.tsinghua.edu.cn/simple'''</p><p>'''trusted-host = pypi.tuna.tsinghua.edu.cn'''</p><p>'''EOFpip3 install homeassistant'''</p>
|}
</li>
<li><p>然后安装依赖包然后输入下面的命令就可以运行Home Assistant Core</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>(homeassistant) orangepi@orangepi:~$ '''sudo apt update'''</p><p>orangepi@orangepi:~srv/homeassistant$ '''sudo apt install -y python3-pip libopencv-dev \'''</p><p>'''python3-opencv imagemagick python3-scipy python3-setuptools python3-wheel \'''</p><p>'''python3-dev cmake python3-testresourceshass'''</p>
|}
</li>
<li><p>然后更新下pip3然后在浏览器中输入【'''开发板的IP地址:8123'''】就能看到Home Assistant的界面</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>orangepi@orangepi:~$ '''python3 -m pip install -U pip setuptools wheel第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。'''</p></big>
|}
<p>[[File:zero3-img194.png]]</p></li></ol> <span id="opencv的安装方法"></span> == OpenCV的安装方法 == <span id="使用apt来安装opencv"></span>=== 使用apt来安装OpenCV === <ol style="list-style-type: decimal;"><li><p>安装'''face_recognition'''前首先需要安装下'''dlib'''这个库，由于dlib这个库在开发板上编译安装比较慢，所以我在'''gitee'''上保存了一份编译好的dlib whl文件，下载后直接安装就可以了。dlib whl文件下载地址如下所示：安装命令如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt-get update'''https</p><p>orangepi@orangepi://gitee.com/leeboby/python_whl~$ '''sudo apt-get install -y libopencv-dev python3-opencv'''</p>
|}
</li>
<li><p>然后使用下面的命令打印OpenCV的版本号输出正常，说明OpenCV安装成功</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先将python_whl仓库下载到开发板的Linux系统中Ubuntu22.04中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''git clone python3 --depth=1 https:c "import cv2; print(cv2.__version__)"'''<//giteep><p>'''4.5.com/leeboby/python_whl4'''</p>
|}
</li>
<li><p>在python_whl文件夹中可以看到有多个版本的dlib安装包'''，'''dlib不同版本对应的Linux系统如下所示：</p></li> {| class="wikitable" style="width:800px;" |-| style="text-align: left;"| '''Ubuntu20.04'''| style="text-align: left;"| '''dlib-19.24.0-cp38-cp38-linux_aarch64.whl'''|-| style="text-align: left;"| '''Ubuntu22.04'''| style="text-align: left;"| '''dlib-19.24.0-cp310-cp310-linux_aarch64.whl'''|-| style="text-align: left;"| '''Debian11'''| style="text-align: left;"| '''dlib-19.24.0-cp39-cp39-linux_aarch64.whl'''|}</ol><ol start="3" style="list-style-type: lower-alpha;"><li><p>然后就可以开始安装dlib，命令如下所示</p><ol style="list-style-type: lower-alpha;"><li><p>Ubuntu20.0404中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd python_whlpython3 -c "import cv2; print(cv2.__version__)"'''</p><p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-194.242.0-cp38-cp38-linux_aarch64.whl'''</p>
|}
</li>
<li><p>Ubuntu22.04Debian11中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd python_whlpython3 -c "import cv2; print(cv2.__version__)"'''</p><p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-194.24.0-cp310-cp310-linux_aarch645.whl1'''</p>
|}
</li>
<li><p>Debian11Debian12中OpenCV的版本如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd python_whlpython3 -c "import cv2; print(cv2.__version__)"'''</p><p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install dlib-194.246.0-cp39-cp39-linux_aarch64.whl'''</p>
|}
</li></ol>
</li><li/ol> <pspan id="宝塔linux面板的安装方法">安装完后如果使用下面的命令能正常打印dlib的版本号，就说明dlib安装正确</pspan> == 宝塔Linux面板的安装方法 == {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<pbig>orangepi@orangepi:~/python_whl$ '''python3 -c "import dlib; print(dlib.__version__)"'''<宝塔Linux面板是提升运维效率的服务器管理软件，支持一键LAMP/LNMP/集群/监控/网站/FTP/数据库/JAVA等100多项服务器管理功能（摘抄自[https://p><p>'''19www.24bt.0cn/ 宝塔官网]）'''</pbig>
|}
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo sed -i 's/nosuid/&,size=2G/' /etc/fstab'''</python_whlp><p>orangepi@orangepi:~$ '''python3 -m pip install face_recognition_models-0.3.0-py2.py3-none-any.whlsudo reboot'''</p>
|}
</li>
<li><p>然后安装重启后，可以看到'''face_recognition/tmp'''空间的大小变为2G了</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3 df -m pip install face_recognitionh | grep "/tmp"'''</p><p>tmpfs 2.0G 12K '''<span style="color:#FF0000">2.0G</span>''' 1% /tmp</p>
|}
</li>
<li><p>然后'''<span style="color:#FF0000">需要重新打开一个终端</span>'''，才能找到并运行'''face_detection'''和'''face_recognition'''这两个命令</p><ol style="list-style-type: lower-alpha;"><li><p>face_recognition命令用来在单张图片或一个图片文件夹中识别是谁的脸</p></li><li><p>face_detection命令用来在单张图片或一个图片文件夹中定位人脸的位置然后在linux系统中输入下面的命令就可以开始宝塔的安装</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''which face_detectionsudo install_bt_panel.sh'''</p><p>/usr/local/bin/face_detection</p><p>orangepi@orangepi:~$ '''which face_recognition'''</p><p>/usr/local/bin/face_recognition</p>
|}
</li><li><p>然后宝塔安装程序会提醒是否安装'''Bt-Panel'''到'''/olwww'''文件夹，此时输入'''y'''即可</p> 如果重新打开终端找不到上面的两个命令，请试下手动导入环境变量，然后再测试下。
{| class="wikitable" style="width:800px;"
|-
|
<p>Do you want to install Bt-Panel to the /www directory now?(y/n): '''<span style="color:#FF0000">y</span>'''</p>|}</li><li><p>然后要做的就是耐心等待，当看到终端输出下面的打印信息时，说明宝塔已经安装完成，整个安装过程大约耗时34分钟，根据网络速度的不同可能会有一些差别</p><p>[[File:zero3-img195.png]]</p></li><li><p>此时在浏览器中输入上面显示的'''面板地址'''就可以打开宝塔Linux面板的登录界面，然后在对应的位置输入上图显示的'''username'''和'''password'''就可以登录进宝塔<br />[[File:zero3-img196.png]]</p></li><li><p>成功登录宝塔后的会弹出下面的欢迎界面，首先请将中间的用户须知阅读完拖到最下面，然后就可以选择”我已同意并阅读《用户协议》“，接着点击”进入面板”就可以进入宝塔了</p><p>[[File:zero3-img197.png|1200px]]</p></li><li><p>进入宝塔后首先会提示需要绑定宝塔官网的账号，如果没有账号可以去宝塔的官网（'''https://www.bt.cn'''）注册一个</p><p>[[File:zero3-img198.png]]</p></li><li><p>最终显示的界面如下图所示，可以很直观的看到开发板Linux系统的一些状态信息，比如负载状态、CPU的使用率、内存使用率和存储空间的使用情况等</p><p>[[File:zero3-img199.png|1200px]]</p></li><li><p>宝塔的更多功能可以参考下面资料自行探索</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>使用手册：[http://docs.bt.cn '''http://docs.bt.cn''']</p><p>论坛地址：[https://www.bt.cn/bbs ''注意，下面的操作都是在桌面中演示的，所以首先请连接好HDMI显示器，或者使用NoMachine'https://www.bt.cn/bbs''']</p><p>GitHub链接：'''https://github.com/aaPanel/VNC远程登录Linux桌面来测试。BaoTa'''</bigp>
|}
</li></ol>
== face_recognition人脸识别库的安装和测试方法 ==
|-
|
<pbig>orangepi@orangepi'''注意，此小节的内容都是在<span style="color:~$ #FF0000">桌面版本</span>的Linux系统中测试的，所以请确保开发板使用的系统为桌面版本的系统。'''git clone https '''另外下面的安装测试都是在<span style="color:#FF0000">orangepi<//github.com/ageitgey/face_recognition.gitspan>用户下进行的，请保持环境一致。''' '''Debian12目前没有适配。'''</pbig>
|}
|-
|
<pbig>orangepi@orangepi:~$ '''git clone [face_recognition源码仓库的地址为：''' '''https://github.com/ageitgey/face_recognition ''' '''face_recognition中文版本的说明文档为：''' '''https://giteegithub.com/leebobyageitgey/face_recognition/blob/master/README_Simplified_Chinese.git]md'''</pbig>
|}
=== 使用脚本自动安装face_recognition的方法 === </li></ol></listyle="list-style-type: decimal;"><li><p>face_recognition示例代码的路径如下所示首先在桌面中打开一个终端，然后下载'''face_recognition_install.sh'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/Desktop$ '''wget \'''</p><p>'''face_recognitionhttps://gitee.com/leeboby/face_recognition_install/raw/master/examplesface_recognition_install.sh'''</p>
|}
</li>
<li><p>face_recognition的中文说明文档链接如下所示，使用face_recognition前请仔细阅读下然后执行下面的命令开始安装'''face_recognition'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>[httpsorangepi@orangepi:~//github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinese.md Desktop$ '''https://github.com/ageitgey/face_recognition/blob/master/README_Simplified_Chinesebash face_recognition_install.mdsh''']</p>
|}
</li>
<li><p>'''find_faces_in_pictureface_recognition安装完后会自动下载face_recognition的源码，然后自动运行face_recognition中的一些示例，如果最后能看到桌面上弹出了下面的这些图片就说明face_recognition安装测试成功了</p><p>[[File:zero3-img200.py'''用来在图片中定位人脸的位置，测试步骤如下所示png]]</p></li></ol> === 手动安装face_recognition的方法 === <ol style="list-style-type: lower-alphadecimal;"><li><p>在桌面中打开一个终端，然后进入首先新建'''face_recognition~/examples.pip'''目录，再添加'''pip.conf'''目录，再执行下面的命令配置文件，并在其中设置pip的镜像源为清华源，需要执行的命令如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognitionmkdir -p ~/examples.pip'''</p><p>orangepi@orangepi:~$ '''cat <<EOF > ~/.pip/pip.conf'''</p><p>'''[global]'''</face_recognitionp><p>'''timeout = 6000'''</examples$ p><p>'''python3 find_faces_in_pictureindex-url = https://pypi.tuna.tsinghua.edu.pycn/simple'''</p><p>'''I found 1 face(s) in this photographtrusted-host = pypi.tuna.tsinghua.edu.cn'''</p><p>'''A face is located at pixel location Top: 241, Left: 419, Bottom: 562, Right: 740EOF'''</p>
|}
</li>
<li><p>等待一段时间会弹出下面的图片，这就是在测试图片中定位到的人脸</p><p>[[File:media/image201.png|575x311px]]</p></li></ol></li><li><p>'''find_facial_features_in_picture.py'''用来识别单张图片中人脸的关键点，测试步骤如下所示</p><ol style="list-style-type: lower-alpha;"><li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令然后安装依赖包</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognition/examplessudo apt update'''</p><p>orangepi@orangepi:~$ '''sudo apt install -y python3-pip libopencv-dev \'''</face_recognitionp><p>'''python3-opencv imagemagick python3-scipy python3-setuptools python3-wheel \'''</examples$ p><p>'''python3 find_facial_features_in_picture.py-dev cmake python3-testresources'''</p>
|}
</li>
<li><p>等待一段时间会弹出下面的图片，可以看到将人脸轮廓都标注出来了</p><p>[[File:media/image202.png|575x302px]]</p></li></ol></li><li><p>'''identify_and_draw_boxes_on_faces.py'''用来识别人脸并使用方框标注，测试步骤如下所示</p><ol style="list-style-type: lower-alpha;"><li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令然后更新下pip3</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''python3 identify_and_draw_boxes_on_faces.py-m pip install -U pip setuptools wheel'''</p>
|}
</li>
<li><p>等待一段时间会弹出下面的图片，可以看到将图片中的人脸都使用方框标注出来了，并且正确显示了人物的名字</p><p>[[File:media/image203.png|461x250px]]</p></li></ol></li><li><p>安装'''face_distance.pyface_recognition'''前首先需要安装下'''dlib'''用来在不同精度上比较两个人脸是否属于一个人，首先打开一个终端，然后进入这个库，由于dlib这个库在开发板上编译安装比较慢，所以我在'''face_recognition/examplesgitee'''目录，再执行下面的命令就可以看到测试的输出结果上保存了一份编译好的dlib whl文件，下载后直接安装就可以了。dlib whl文件下载地址如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognitionhttps:/examples'''</p><p>orangepi@orangepi:~gitee.com/face_recognitionleeboby/examples$ '''python3 face_distance.pypython_whl'''</p>|}<pol style="list-style-type: lower-alpha;">'''The test image has a distance of 0.35 from known image #0'''</pli><p>'''- With a normal cutoff of 0.6, would the test image match the known image? True'''首先将python_whl仓库下载到开发板的Linux系统中</p><p>'''{| class="wikitable" style="width:800px;" |- With a very strict cutoff of 0.5, would the test image match the known image? True'''</p> | <p>orangepi@orangepi:~$ '''The test image has a distance of 0.82 from known image #git clone --depth=1'''<https://p><p>'''- With a normal cutoff of 0gitee.6, would the test image match the known image? False'''<com/leeboby/p><p>'''- With a very strict cutoff of 0.5, would the test image match the known image? Falsepython_whl'''</p>
|}
</li>
<li><p>在python_whl文件夹中可以看到有多个版本的dlib安装包'''recognize_faces_in_pictures.py，'''用来识别未知图片中的人脸是谁。首先打开一个终端，然后进入'''face_recognitiondlib不同版本对应的Linux系统如下所示：</examples'''目录，再执行下面的命令，等待一端时间后就能看到测试结果p></pli>
{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| '''Ubuntu20.04'''<p>orangepi@orangepi| style="text-align:~$ left;"| '''cd face_recognition/examplesdlib-19.24.0-cp38-cp38-linux_aarch64.whl'''</p><p>orangepi@orangepi|-| style="text-align:~/face_recognition/examples$ left;"| '''python3 recognize_faces_in_picturesUbuntu22.py04'''</p><p>| style="text-align: left;"| '''Is the unknown face a picture of Biden? Falsedlib-19.24.0-cp310-cp310-linux_aarch64.whl'''</p><p>|-| style="text-align: left;"| '''Is the unknown face a picture of Obama? TrueDebian11'''</p><p>| style="text-align: left;"| '''Is the unknown face a new person that we've never seen before? Falsedlib-19.24.0-cp39-cp39-linux_aarch64.whl'''</p>
|}
</li><li><p>'''facerec_from_webcam_faster.py'''用来识别USB摄像头中的人脸，测试步骤如下所示：</pol><ol start="3" style="list-style-type: lower-alpha;"><li><p>首先请将USB摄像头插入开发板的USB接口中，然后通过'''v4l2-ctl'''（'''然后就可以开始安装dlib，命令如下所示</p><span ol style="colorlist-style-type:#FF0000none;">注意v4l2中的l是小写字母l，不是数字1</spanli><p>'''）命令查看下USB摄像头的设备节点的序号a) Ubuntu20.04</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt updatecd python_whl'''</p><p>orangepi@orangepi:~$ '''sudo apt install -y v4l-utils'''</p><p>orangepi@orangepi:~python_whl$ '''v4l2python3 -ctl --listm pip install dlib-devices'''</p><p>cedrus (platform:cedrus):</p>::<p>/dev/video0</p> <p>USB219.0 UVC PC Camera: USB224.0 UV (usb-5311000cp38-cp38-linux_aarch64.usb-1):</p>::<p>'''<span style="color:#FF0000">/dev/video1</span>whl'''</p>::<p>/dev/video2</p>
|}
</li>
<li><p>然后在桌面中打开一个终端，进入'''face_recognition/examples'''目录后，首先修改下'''facerec_from_webcam_fasterb) Ubuntu22.py'''中使用的摄像头的设备序号。比如上面通过'''v4l2-ctl --list-devices'''命令查看到USB摄像头为'''/dev/video1'''，那就修改'''cv2.VideoCapture(0)'''中的'''0'''为'''<span style="color:#FF0000">1</span>'''04</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognition/examplespython_whl'''</p><p>orangepi@orangepi:~/face_recognition/examplespython_whl$ '''vim facerec_from_webcam_fasterpython3 -m pip install dlib-19.24.py'''</p><p>'''video_capture = cv20-cp310-cp310-linux_aarch64.VideoCapture(<span style="color:#FF0000">1</span>)whl'''</p>
|}
</li>
<li><p>然后执行下面的命令运行'''facerec_from_webcam_faster.py'''c) Debian11</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd python_whl'''</face_recognitionp><p>orangepi@orangepi:~/examplespython_whl$ '''python3 facerec_from_webcam_faster-m pip install dlib-19.24.0-cp39-cp39-linux_aarch64.pywhl'''</p>
|}
</li></ol>
</li>
<li><p>等待一段时间会弹出摄像头的显示画面</p><p>[[File:media/image204.png|314x245px]]</p></li><li><p>此时可以将摄像头对准自己，当摄像头检测到人脸时，会将检测到的人脸使用方框框起来。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</p></li><li><p>还可以打开一张奥巴马的图片，然后使用摄像头对准打开的图片，可以看到不仅能将人脸标注出来，还能正确显示检测到的人脸的名字。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</p><p>[[File:media/image205.png|358x284px]]</p></li></ol></li><li><p>'''web_service_example.py'''是一个非常简单的使用Web服务上传图片运行人脸识别的案例，后端服务器会识别这张图片是不是奥巴马，并把识别结果以json键值对输出，测试步骤如下所示：</p><ol style="list-style-type: lower-alpha;"><li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令（'''<span style="color:#FF0000">如果是使用脚本自动安装的face_recognition，那么就不需要安装flask了</span>'''）安装完后如果使用下面的命令能正常打印dlib的版本号，就说明dlib安装正确</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/python_whl$ '''python3 -m pip install flaskc "import dlib; print(dlib.__version__)"'''</p><p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p><p>root@orangepi:~/face_recognition/examples$ '''python3 web_service_example19.24.py0'''</p><p>* Serving Flask app 'web_service_example' (lazy loading)</p><p>* Environment: production</p><p>WARNING: This is a development server. Do not use it in a production deployment.</p><p>Use a production WSGI server instead.</p><p>* Debug mode: on</p><p>* Running on all addresses (0.0.0.0)</p><p>WARNING: This is a development server. Do not use it in a production deployment.</p><p>* Running on http://127.0.0.1:5001</p><p>* Running on http://192.168.1.79:5001 (Press CTRL+C to quit)</p><p>* Restarting with stat</p><p>* Debugger is active!</p><p>* Debugger PIN: 500-161-390</p>
|}
</li></ol></li></ol><!-- --><ol start="5" style="list-style-type: decimal;"><li><p>然后另外打开一个终端，再运行下面的命令就可以返回图片识别的结果（注意，下面的命令执行路径为然后安装下'''face_recognition/examplesface_recognition_models-0.3.0-py2.py3-none-any.whl'''）</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/face_recognition/examplespython_whl$ '''curl python3 -XPOST m pip install face_recognition_models-F \'''</p><p>'''"file=@obama20.jpg" http://1273.0-py2.0py3-none-any.1:5001'''</p><p>'''{'''</p>:<p>'''"face_found_in_image": true,'''</p>:<p>'''"is_picture_of_obama": true'''</p><p>'''}whl'''</p>
|}
</li>
<li><p>我们也可以将然后安装'''face_recognition/examples/obama2.jpg'''这张图片拷贝到其他的Linux电脑中，当然也可以自己准备一张名为'''obama2.jpg'''的图片，然后在Linux电脑中可以使用下面的命令远程通过开发板运行的服务来识别人脸（'''注意命令中的IP地址需要替换为开发板的IP地址，file后的文件名需要替换为想要测试的图片的名字'''）</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>testorangepi@testorangepi:~$ '''curl python3 -XPOST -F "file=@obama2.jpg" http://192.168.1.79:5001'''</p><p>'''{'''</p>:<p>'''"face_found_in_image": true,'''</p>:<p>'''"is_picture_of_obama": true'''</p><p>'''}m pip install face_recognition'''</p>
|}
</li>
<li><p>使用浏览器测试的方法如下所示：然后'''<span style="color:#FF0000">需要重新打开一个终端</span>'''，才能找到并运行'''face_detection'''和'''face_recognition'''这两个命令</p>
<ol style="list-style-type: lower-alpha;">
<li><p>首先打开浏览器，然后在浏览器的地址栏输入'''开发板的IP地址:5001'''，然后就能看到下面的页面</p><p>[[File:media/image206.png|575x150px]]face_recognition命令用来在单张图片或一个图片文件夹中识别是谁的脸</p></li><li><p>然后将obama2.jpg复制到桌面face_detection命令用来在单张图片或一个图片文件夹中定位人脸的位置</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/face_recognition/examples$ '''cp obama2.jpg which face_detection'''</homep><p>/orangepiusr/local/bin/Desktopface_detection</p><p>orangepi@orangepi:~$ '''which face_recognition'''</p><p>/usr/local/bin/face_recognition</p>
|}
</li></ol>
{| class="wikitable" style="width:800px;"
|-
|
=== face_recognition的测试方法 ===
<ol style="list-style-type: decimal;">:<li><p>在'''face_recognition'''的源码中有一些示例代码，我们可以直接用来测试，face_recognition源码的下载地址如下所示：</p><ol style="list-style-model TEXT Which face detection model to use. Options are "type: lower-alpha;hog" or "cnn"."><li><p>GitHub官方的下载地址</p>{| class="wikitable" style="width:800px;" |-| :<p>--help Show this message and exitorangepi@orangepi:~$ '''git clone https://github.com/ageitgey/face_recognition.git'''</p>
|}
</li>
<li><p>检测单张图片的示例如下所示：Gitee镜像下载地址</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd git clone [https://github.com/ageitgey/face_recognitionhttps:/examples'''</p><p>orangepi@orangepi:~gitee.com/leeboby/face_recognition/examples$ '''face_detection obama2.jpggit]'''</p><p>obama2.jpg,302,474,611,164</p>
|}
</li></ol>
</li>
<li><p>使用多核并行检测多张图片的示例如下所示：</p><ol style="list-style-type: lower-alpha;"><li><p>首先进入'''face_recognition/examples'''文件夹</p></li><li><p>然后新建一个test文件夹</p></li><li><p>然后将jpg图片都拷贝到test文件夹中</p></li><li><p>然后使用所有的cpu并行运行'''face_detection'''来检查test文件夹中的图片，其中'''--cpus -1'''表示使用所有的cpuface_recognition示例代码的路径如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>|}<p/li>orangepi@orangepi:~/face_recognition/examples$ '''mkdir test'''</pli><p>orangepi@orangepi:~/face_recognition/examples$ '''cp *.jpg test'''face_recognition的中文说明文档链接如下所示，使用face_recognition前请仔细阅读下</p><p>orangepi@orangepi{| class="wikitable" style="width:~/face_recognition/examples$ '''face_detection -800px;" |-cpus -1 test'''</p><p>test/obama-240p.jpg,29,261,101,189</p>| <p>test/obama_small.jpg,65,215,169,112<[https:/p><p>test/obama2github.jpg,302,474,611,164<com/p><p>testageitgey/two_people.jpg,62,394,211,244<face_recognition/p><p>testblob/two_people.jpg,95,941,244,792<master/p><p>test/obamaREADME_Simplified_Chinese.jpg,136,624,394,366<md '''https:/p><p>test/obama-480pgithub.jpg,65,507,189,383<com/p><p>testageitgey/obama-720p.jpg,94,751,273,572</p><p>testface_recognition/obama-1080p.jpg,136,1140,394,882<blob/p><p>testmaster/bidenREADME_Simplified_Chinese.jpg,233,749,542,439md''']</p>
|}
</li>
<li><p>'''face_recognitionfind_faces_in_picture.py'''命令测试示例用来在图片中定位人脸的位置，测试步骤如下所示</p>
<ol style="list-style-type: lower-alpha;">
<li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''命令行工具可以在单张图片或者一个图片文件夹中认出是谁的脸。使用'''face_recognition --help'''可以查看下face_recognition命令的帮助信息目录，再执行下面的命令</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognition --help/examples'''</p><p>Usageorangepi@orangepi: ~/face_recognition [OPTIONS] KNOWN_PEOPLE_FOLDER IMAGE_TO_CHECK</p><p>Options:examples$ '''python3 find_faces_in_picture.py'''</p>:<p>--cpus INTEGER number of CPU cores to use in parallel '''I found 1 face(can speed up processing lots of imagess)in this photograph. -1 means "use all in system"'''</p> :<p>--tolerance FLOAT Tolerance for '''A face comparisons. Default is 0.6. Lower this if you get multiple matches for the same person.</p> located at pixel location Top: 241, Left: 419, Bottom:<p>--show-distance BOOLEAN Output face distance. Useful for tweaking tolerance setting.</p> 562, Right:<p>--help Show this message and exit.740'''</p>
|}
</li>
<li><p>首先新建一个已知名字的人脸图片文件夹'''known_people'''，然后复制两张图片到'''known_people等待一段时间会弹出下面的图片，这就是在测试图片中定位到的人脸</p><p>[[File:zero3-img201.png]]</p></li></ol></li><li><p>'''中，然后将'''obama2find_facial_features_in_picture.jpgpy'''复制为用来识别单张图片中人脸的关键点，测试步骤如下所示</p><ol style="list-style-type: lower-alpha;"><li><p>在桌面中打开一个终端，然后进入'''unkown.jpgface_recognition/examples'''，也就是我们要识别的图片目录，再执行下面的命令</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p>
<p>orangepi@orangepi:~/face_recognition/examples$ '''mkdir known_people'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''cp bidenpython3 find_facial_features_in_picture.jpg obama.jpg known_people'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''cp obama2.jpg unkown.jpgpy'''</p>
|}
</li>
<li><p>然后就可以使用下面的命令识别下等待一段时间会弹出下面的图片，可以看到将人脸轮廓都标注出来了</p><p>[[File:zero3-img202.png]]</p></li></ol></li><li><p>'''unkownidentify_and_draw_boxes_on_faces.jpgpy'''用来识别人脸并使用方框标注，测试步骤如下所示</p><ol style="list-style-type: lower-alpha;"><li><p>在桌面中打开一个终端，然后进入'''face_recognition/examples'''图片中人物的名字，可以看到识别到unkown.jpg图片为obama目录，再执行下面的命令</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/face_recognition/examples$ '''cd face_recognition known_people \/examples'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''unkownpython3 identify_and_draw_boxes_on_faces.jpgpy'''</p><p>unkown.jpg,obama</p>
|}
</li>
<li><p>如果我们识别一张不相关的图片，就会显示unknown_person等待一段时间会弹出下面的图片，可以看到将图片中的人脸都使用方框标注出来了，并且正确显示了人物的名字</p><p>[[File:zero3-img203.png]]</p></li></ol></li><li><p>'''face_distance.py'''用来在不同精度上比较两个人脸是否属于一个人，首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令就可以看到测试的输出结果</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>rootorangepi@orangepi:~$ '''cd face_recognition/examples'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''face_recognition known_people \python3 face_distance.py'''</p><p>'''The test image has a distance of 0.35 from known image #0'''</p><p>'''- With a normal cutoff of 0.6, would the test image match the known image? True'''</p><p>'''- With a very strict cutoff of 0.5, would the test image match the known image? True'''</p> <p>'''The test image has a distance of 0.82 from known image #1'''</p><p>'''alex-lacamoireWith a normal cutoff of 0.png6, would the test image match the known image? False'''</p><p>alex'''-lacamoireWith a very strict cutoff of 0.png5,unknown_personwould the test image match the known image? False'''</p>
|}
</li>
<li><p>我们还可以新建一个test文件夹，然后在其中放入多张图片，然后就可以使用所有的CPU来并行识别所有的图片'''recognize_faces_in_pictures.py'''用来识别未知图片中的人脸是谁。首先打开一个终端，然后进入'''face_recognition/examples'''目录，再执行下面的命令，等待一端时间后就能看到测试结果</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/face_recognition/examples$ '''mkdir testcd face_recognition/examples'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''cp *python3 recognize_faces_in_pictures.jpg *.png testpy'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''face_recognition --cpus -1 \Is the unknown face a picture of Biden? False'''</p><p>'''known_people testIs the unknown face a picture of Obama? True'''</p><p>test/obama-240p.jpg,obama</p><p>test/alex-lacamoire.png,unknown_person</p><p>test/obama_small.jpg,obama</p><p>test/unkown.jpg,obama</p><p>test/obama2.jpg,obama</p><p>test/lin-manuel-miranda.png,unknown_person</p><p>test/two_people.jpg,biden</p><p>test/two_people.jpg,obama</p><p>test/obama-720p.jpg,obama</p><p>test/obama.jpg,obama</p><p>test/obama-480p.jpg,obama</p><p>test/biden.jpg,biden</p><p>test/obama-1080p.jpg,obama'''Is the unknown face a new person that we've never seen before? False'''</p>
|}
</li><li><p>'''facerec_from_webcam_faster.py'''用来识别USB摄像头中的人脸，测试步骤如下所示：</p><olstyle="list-style-type: lower-alpha;"><li><p>首先请将USB摄像头插入开发板的USB接口中，然后通过'''v4l2-ctl'''（'''<span style="color:#FF0000">注意v4l2中的l是小写字母l，不是数字1</lispan>'''）命令查看下USB摄像头的设备节点的序号</olp> == 设置中文环境以及安装中文输入法 == {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''注意，安装中文输入法前请确保开发板使用的Linux系统为桌面版系统。sudo apt update'''</bigp>|}<p>orangepi@orangepi:~$ '''sudo apt install -y v4l-utils'''</p><p>orangepi@orangepi:~$ '''v4l2-ctl --list-devices'''</p><p>cedrus (platform:cedrus):</p>::<p>/dev/video0</p>
<ol style="listp>USB2.0 UVC PC Camera: USB2.0 UV (usb-style5311000.usb-type1): decimal;"</p><li>::<p>首先设置默认'''locale'''为中文</p><ol span style="list-style-typecolor: lower-alpha;#FF0000">/dev/video1<li><p/span>输入下面的命令可以开始配置'''locale'''</p>{| class="wikitable" style="width:800px;" |-| :<p>orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''/dev/video2</p>
|}
</li>
<li><p>然后在弹出的界面中选择然后在桌面中打开一个终端，进入'''zh_CNface_recognition/examples'''目录后，首先修改下'''facerec_from_webcam_faster.UTFpy'''中使用的摄像头的设备序号。比如上面通过'''v4l2-ctl --8 > UTFlist-8devices'''命令查看到USB摄像头为'（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到''/dev/video1'<OK>''，那就修改'，然后回车即可）</p><p>[[File:media/image210''cv2.png|575x296px]]</p></li><li><p>然后设置默认VideoCapture(0)'''locale中的'''为0'''zh_CN.UTF-8为'''</p><p>[[Filespan style="color:media/image211.png|575x160px]]</p#FF0000">1</li><li><pspan>退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo dpkg-reconfigure localescd face_recognition/examples'''</p><p>Generating locales (this might take a while)..orangepi@orangepi:~/face_recognition/examples$ '''vim facerec_from_webcam_faster.py'''</p>:<p>en_US'''video_capture = cv2.UTF-8... doneVideoCapture(</p>span style="color:<p#FF0000">zh_CN.UTF-8... done1</pspan><p>Generation complete.)'''</p>
|}
</li>
<li><p>然后打开然后执行下面的命令运行'''Input Method'''</p><p>[[File:media/image212.png|575x361px]]</p></li><li><p>然后选择'''OK'''</p><p>[[File:media/image213.png|295x212px]]</p></li><li><p>然后选择'''Yes'''</p><p>[[File:media/image214.png|303x192px]]</p></li><li><p>然后选择'''fcitx'''</p><p>[[File:media/image215.png|307x220px]]</p></li><li><p>然后选择'''OK'''</p><p>[[File:media/image216.png|305x216px]]</p></li><li><p>'''<span style="color:#FF0000">然后重启Linux系统才能使配置生效</span>'''</p></li><li><p>然后打开'''Fcitx configuration'''</p><p>[[File:media/image217.png|575x376px]]</p></li><li><p>然后点击下图所示位置的'''+'''号</p><p>[[File:media/image218.png|280x187px]]</p></li><li><p>然后搜索'''Google Pinyin'''再点击'''OK'''</p><p>[[File:media/image219.png|291x196px]]</p></li><li><p>然后将'''Google Pinyin'''放到最前面</p><p>[[File:media/image220.png|299x202px]]</p><p>[[File:media/image221.png|300x202px]]</p></li><li><p>然后打开'''Geany'''这个编辑器测试下中文输入法</p><p>[[File:media/image222.png|349x212px]]</p></li><li><p>中文输入法测试如下所示</p><p>[[File:media/image223.png|575x325px]]</p></li><li><p>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</p></li><li><p>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CNfacerec_from_webcam_faster.UTF-8py'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo vim /etcface_recognition/default/locale'''</p><p># File generated by update-locale</p><p>LC_MESSAGES='''<span style="color:#FF0000">zh_CN.UTF-8</span>'''</p><p>LANG=examples$ '''<span style="color:#FF0000">zh_CNpython3 facerec_from_webcam_faster.UTF-8</span>'''</p><p>LANGUAGE='''<span style="color:#FF0000">zh_CN.UTF-8</span>py'''</p>
|}
</li>
<li><p>然后'''重启系统'''就能看到系统显示为中文了等待一段时间会弹出摄像头的显示画面</p><p>[[File:media/image224zero3-img204.png|576x356px]]</p></li></olli> <span id="ubuntu-20.04系统的安装方法"p>此时可以将摄像头对准自己，当摄像头检测到人脸时，会将检测到的人脸使用方框框起来。'''注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</spanp> === Ubuntu 20.04系统的安装方法 === <ol style="list-style-type: decimal;"/li><li><p>首先打开还可以打开一张奥巴马的图片，然后使用摄像头对准打开的图片，可以看到不仅能将人脸标注出来，还能正确显示检测到的人脸的名字。'''Language Support注意，检测人脸时，摄像头显示的画面会比较卡顿，请不要移动过快'''</p><p>[[File:media/image225zero3-img205.png|575x351px]]</p></li></ol></li><li><p>然后找到'''汉语（中国）web_service_example.py'''选项是一个非常简单的使用Web服务上传图片运行人脸识别的案例，后端服务器会识别这张图片是不是奥巴马，并把识别结果以json键值对输出，测试步骤如下所示：</p><p>[[Fileol style="list-style-type:media/image226.png|318x311px]]</p></lilower-alpha;"><li><p>然后请使用鼠标左键选中在桌面中打开一个终端，然后进入'''face_recognition/examples'''汉语（中国）目录，再执行下面的命令（'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</pspan style="color:#FF0000">如果是使用脚本自动安装的face_recognition，那么就不需要安装flask了<p/span>[[File:media/image227.png|324x320px]]'''）</p></li> {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''注意，这一步不是很好拖动的，请耐心多试几次。python3 -m pip install flask'''</bigp><p>orangepi@orangepi:~$ '''cd face_recognition/examples'''</p><p>root@orangepi:~/face_recognition/examples$ '''python3 web_service_example.py'''</p><p>* Serving Flask app 'web_service_example' (lazy loading)</p><p>* Environment: production</p><p>WARNING: This is a development server. Do not use it in a production deployment.</p><p>Use a production WSGI server instead.</p><p>* Debug mode: on</p><p>* Running on all addresses (0.0.0.0)</p><p>WARNING: This is a development server. Do not use it in a production deployment.</p><p>* Running on http://127.0.0.1:5001</p><p>* Running on http://192.168.1.79:5001 (Press CTRL+C to quit)</p><p>* Restarting with stat</p><p>* Debugger is active!</p><p>* Debugger PIN: 500-161-390</p>
|}
</olli><ol startli><p>然后另外打开一个终端，再运行下面的命令就可以返回图片识别的结果（注意，下面的命令执行路径为'''face_recognition/examples'''）</p>{| class="4wikitable" style="listwidth:800px;" |-| <p>orangepi@orangepi:~/face_recognition/examples$ '''curl -styleXPOST -typeF \'''</p><p>'''"file=@obama2.jpg" http://127.0.0.1: decimal;"5001'''</p><lip>'''{'''</p>:<p>然后选择'''Apply System-Wide"face_found_in_image": true,'''将中文设置应用到整个系统</p>:<p>[[File'''"is_picture_of_obama":mediatrue'''</image228.png|321x316px]]p><p>'''}'''</p>|}</li><li><p>然后设置我们也可以将'''Keyboard input method systemface_recognition/examples/obama2.jpg'''这张图片拷贝到其他的Linux电脑中，当然也可以自己准备一张名为'''obama2.jpg'''为的图片，然后在Linux电脑中可以使用下面的命令远程通过开发板运行的服务来识别人脸（'''fcitx注意命令中的IP地址需要替换为开发板的IP地址，file后的文件名需要替换为想要测试的图片的名字'''）</p>{| class="wikitable" style="width:800px;" |-| <p>[[Filetest@test:~$ '''curl -XPOST -F "file=@obama2.jpg" http:media/image229/192.168.1.png|327x320px]]79:5001'''</p><p>'''{'''</lip>:<lip>'''"face_found_in_image": true,'''</p>:<p>'''"is_picture_of_obama": true'''<span style="color:#FF0000"/p>然后重启Linux系统使配置生效</spanp>'''}'''</p>|}</li><li><p>重新进入系统后，在下面的界面请选择使用浏览器测试的方法如下所示：</p><ol style="list-style-type: none;"><li><p>a) 首先打开浏览器，然后在浏览器的地址栏输入'''不要再次询问我开发板的IP地址:5001'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文，然后就能看到下面的页面</p><p>[[File:media/image230zero3-img206.png|303x247px]]</p></li><li><p>然后可以看到桌面都显示为中文了b) 然后将obama2.jpg复制到桌面</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~/face_recognition/examples$ '''cp obama2.jpg /home/orangepi/Desktop/'''</p>|}</li><li><p>c) 然后在浏览器中选择刚才复制的图片</p><p>[[File:media/image231zero3-img207.png|575x383px]]</p></li><li><p>然后我们可以打开d) 然后点击'''GeanyUpload'''测试下中文输入法，打开方式如下图所示上传刚才选择的图片进行人脸识别</p><p>[[File:mediazero3-img208.png]]</p></li><li><p>e) 等待一段时间后就会显示检测的结果</image232p><p>[[File:zero3-img209.png|576x292px]]</p></li></ol></li></ol></li><li><p>打开'''Geanyface_detection'''后，默认还是英文输入法，我们可以通过命令测试示例</p><ol style="list-style-type: lower-alpha;"><li><p>face_detection命令行工具可以在单张图片或一个图片文件夹中定位人脸位置（输出像素点坐标）。使用'''Ctrl+Spaceface_detection --help'''快捷键来切换成中文输入法，然后就能输入中文了可以查看下face_detection命令的帮助信息</p>{| class="wikitable" style="width:800px;" |-| <p>[[Fileorangepi@orangepi:media~$ '''face_detection --help'''</image233.png|575x308px]p><p>Usage: face_detection [OPTIONS]IMAGE_TO_CHECK</p> <p>Options:</lip>:<p>--cpus INTEGER number of CPU cores to use in parallel. -1 means "use all in system"</olp>
:<p>--help Show this message and exit.</p>|}</li><li><p>检测单张图片的示例如下所示：</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''注意，这一步不是很好拖动的，请耐心多试几次。cd face_recognition/examples'''</bigp><p>orangepi@orangepi:~/face_recognition/examples$ '''face_detection obama2.jpg'''</p><p>obama2.jpg,302,474,611,164</p>
|}
</ol><ol start="4" style="list-style-type: decimal;"li><li><p>然后选择'''Apply System-Wide'''将中文设置应用到整个系统使用多核并行检测多张图片的示例如下所示：</p><p>[[File:media/image236.png|287x282px]]</p></li><li><p>'''<span ol style="colorlist-style-type:#FF0000none;">然后重启Linux系统使配置生效</span>'''</p></li><li><p>重新进入系统后，在下面的界面请选择a) 首先进入'''不要再次询问我face_recognition/examples'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</p><p>[[File:media/image230.png|303x247px]]文件夹</p></li><li><p>然后可以看到桌面都显示为中文了</p><p>[[File:media/image231.png|575x383px]]b) 然后新建一个test文件夹</p></li><li><p>然后打开Fcitx5配置程序</p><p>[[File:media/image237.png|575x349px]]c) 然后将jpg图片都拷贝到test文件夹中</p></li><li><p>然后选择使用拼音输入法</p><p>[[File:media/image238.png|338x267px]]</p></li><li><p>选择后的界面如下所示，再点击确定即可</p><p>[[File:media/image239.png|366x290px]]</p></li><li><p>然后我们可以打开d) 然后使用所有的cpu并行运行'''Geanyface_detection'''测试下中文输入法，打开方式如下图所示</p><p>[[File:media/image232.png|576x292px]]</p></li><li><p>打开来检查test文件夹中的图片，其中'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space--cpus -1'''快捷键来切换成中文输入法，然后就能输入中文了表示使用所有的cpu</p><p>[[File:media/image240.png|434x308px]]</p></li></ol> <span id="远程登录linux系统桌面的方法"></span> == 远程登录Linux系统桌面的方法 == <span id="使用nomachine远程登录"></span>=== 使用NoMachine远程登录 === {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''请确保开发板安装的Ubuntu或者Debian系统为桌面版本的系统。另外NoMachine也提供了详细的使用文档，强烈建议通读此文档来熟悉NoMachine的使用，文档链接如下所示：cd face_recognition/examples'''</p> <p>orangepi@orangepi:~/face_recognition/examples$ '''mkdir test'''https</p><p>orangepi@orangepi:~/face_recognition/knowledgebaseexamples$ '''cp *.nomachine.comjpg test'''</p><p>orangepi@orangepi:~/face_recognition/DT10R00166examples$ '''face_detection --cpus -1 test'''</p><p>test/obama-240p.jpg,29,261,101,189</p><p>test/obama_small.jpg,65,215,169,112</p><p>test/obama2.jpg,302,474,611,164</p><p>test/two_people.jpg,62,394,211,244</p><p>test/two_people.jpg,95,941,244,792</p><p>test/obama.jpg,136,624,394,366</p><p>test/obama-480p.jpg,65,507,189,383</p><p>test/obama-720p.jpg,94,751,273,572</p><p>test/obama-1080p.jpg,136,1140,394,882</p><p>test/biden.jpg,233,749,542,439</bigp>
|}
</li></ol></li></ol></li><li><p>'''face_recognition'''命令测试示例</p><ol style="list-style-type: lower-alpha;"><li><p>'''face_recognition'''命令行工具可以在单张图片或者一个图片文件夹中认出是谁的脸。使用'''face_recognition --help'''可以查看下face_recognition命令的帮助信息</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''NoMachine支持Windows、Mac、Linux、iOS和安卓平台，所以我们可以在多种设备上通过NoMachine来远程登录控制Orange Pi开发板。下面演示下在Windows中通过NoMachine来远程登录Orange Pi开发板的Linux系统桌面。其他平台的安装方法请参考下NoMachine的官方文档。face_recognition --help'''</bigp><p>Usage: face_recognition [OPTIONS] KNOWN_PEOPLE_FOLDER IMAGE_TO_CHECK</p><p>Options:</p>:<p>--cpus INTEGER number of CPU cores to use in parallel (can speed up processing lots of images). -1 means "use all in system"</p>|}
:<p>--help Show this message and exit.</p>|}</li><li><p>首先新建一个已知名字的人脸图片文件夹'''known_people'''，然后复制两张图片到'''known_people'''中，然后将'''obama2.jpg'''复制为'''unkown.jpg'''，也就是我们要识别的图片</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~$ '''注意，这个下载链接可能会变，请认准Armv8cd face_recognition/Arm64版本的deb包。examples'''</bigp><p>orangepi@orangepi:~/face_recognition/examples$ '''mkdir known_people'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''cp biden.jpg obama.jpg known_people'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''cp obama2.jpg unkown.jpg'''</p>
|}
</li><li><p>然后就可以使用下面的命令识别下'''unkown.jpg'''图片中人物的名字，可以看到识别到unkown.jpg图片为obama</p>
{| class="wikitable" style="width:800px;"
|-
|
|}
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepiroot@orangepi:~/face_recognition/examples$ '''sudo dpkg face_recognition known_people \'''</p><p>'''alex-i nomachine_xlacamoire.x.x_x_arm64_arm64.debpng'''</p><p>alex-lacamoire.png,unknown_person</p>
|}
</li></ol></li></olp><!-- --><ol start="2" style="list-style-type: decimal;"><li>然后下载NoMachine软件Windows版本的安装包，下载地址如下所示我们还可以新建一个test文件夹，然后在其中放入多张图片，然后就可以使用所有的CPU来并行识别所有的图片</lip> {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<bigp>orangepi@orangepi:~/face_recognition/examples$ '''mkdir test'''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''cp *.jpg *.png test'注意，这个下载链接可能会变。''</p><p>orangepi@orangepi:~/face_recognition/examples$ '''face_recognition --cpus -1 \'''</p><p>'''known_people test'''</p><p>test/obama-240p.jpg,obama</p><p>test/alex-lacamoire.png,unknown_person</p><p>test/obama_small.jpg,obama</p><p>test/unkown.jpg,obama</p><p>test/obama2.jpg,obama</p><p>test/lin-manuel-miranda.png,unknown_person</p><p>test/two_people.jpg,biden</p><p>test/two_people.jpg,obama</p><p>test/obama-720p.jpg,obama</p><p>test/obama.jpg,obama</p><p>test/obama-480p.jpg,obama</p><p>test/biden.jpg,biden</p><p>test/obama-1080p.jpg,obama</bigp>
|}
</li></ol>
</li></ol>
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big>'''操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。注意，安装中文输入法前请确保开发板使用的Linux系统为桌面版系统。'''</big>|}
<ol style="list-style-type: decimal;">
<li><p>首先运行首先设置默认'''set_vnc.shlocale'''脚本设置下vnc，为中文</p><ol style="list-style-type: lower-alpha;"><li><p>输入下面的命令可以开始配置'''记得加sudo权限locale'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo set_vnc.sh'''</p><p>You will require a password to access your desktops.</p> <p>Password: '''<span style="color:#FF0000">#在这里设置vnc的密码，8位字符</span>'''</p><p>Verify: '''<span style="color:#FF0000">#在这里设置vnc的密码，8位字符</span>'''</p><p>Would you like to enter a viewdpkg-only password (y/n)? '''<span style="color:#FF0000">n</span>'''</p><p>xauth: file /root/.Xauthority does not exist</p> <p>New 'Xreconfigure locales' desktop is orangepi:1</p> <p>Creating default startup script /root/.vnc/xstartup</p><p>Starting applications specified in /root/.vnc/xstartup</p><p>Log file is /root/.vnc/orangepi:1.log</p> <p>Killing Xtightvnc process ID 3047</p> <p>New 'X' desktop is orangepi:1</p> <p>Starting applications specified in /root/.vnc/xstartup</p><p>Log file is /root/.vnc/orangepi:1.log</p>|}
</li>
<li><p>使用MobaXterm软件连接开发板linux系统桌面的步骤如下所示：</p><ol style="list然后在弹出的界面中选择'''zh_CN.UTF-style8 > UTF-type: lower-alpha8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''<"><li>首先点击Session，然后选择VNC，再填写开发板的IP地址和端口，最后点击OK确认</li> [[File:media/image251.png|421x300px]]</ol><ol start="2" style="list-style-type: lower-alphaOK>"><li><p>然后输入前面设置的VNC的密码'''，然后回车即可）</p><p>[[File:media/image252zero3-img210.png|221x105px1400px]]</p></li><li><p>登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了然后设置默认'''locale'''为'''zh_CN.UTF-8'''</p></lip> [[File:media/image253zero3-img211.png|405x293px1400px]]</olp></li></ol><span id="qt的安装方法"></span> == QT的安装方法 == <ol style="list-style-type: decimal;"><li><p>使用下面的脚本可以安装QT5和QT Creator退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''install_qt.shsudo dpkg-reconfigure locales'''</p><p>Generating locales (this might take a while)...</p>:<p>en_US.UTF-8... done</p>:<p>zh_CN.UTF-8... done</p><p>Generation complete.</p>
|}
</li></ol>
</li>
<li><p>安装完后会自动打印QT的版本号然后打开'''Input Method'''</p><p>[[File:zero3-img212.png]]</p></li><li><p>然后选择'''OK'''</p><p>[[File:zero3-img213.png]]</p></li><li><p>然后选择'''Yes'''</p><p>[[File:zero3-img214.png]]</p></li><li><p>然后选择'''fcitx'''</p><ol p>[[File:zero3-img215.png]]</p></li><li><p>然后选择'''OK'''</p><p>[[File:zero3-img216.png]]</p></li><li><p>'''<span style="listcolor:#FF0000">然后重启Linux系统才能使配置生效</span>'''</p></li><li><p>然后打开'''Fcitx configuration'''</p><p>[[File:zero3-styleimg217.png]]</p></li><li><p>然后点击下图所示位置的'''+'''号</p><p>[[File:zero3-typeimg218.png]]</p></li><li><p>然后搜索'''Google Pinyin'''再点击'''OK'''</p><p>[[File: lowerzero3-alpha;"img219.png]]</p></li><li><p>Ubuntu20然后将'''Google Pinyin'''放到最前面</p><p>[[File:zero3-img220.04自带的qt版本为png]]</p><p>[[File:zero3-img221.png]]</p></li><li><p>然后打开'''Geany'''5这个编辑器测试下中文输入法</p><p>[[File:zero3-img222.12png]]</p></li><li><p>中文输入法测试如下所示</p><p>[[File:zero3-img223.png]]</p></li><li><p>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</p></li><li><p>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CN.UTF-8'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''install_qt.shsudo vim /etc/default/locale'''</p><p>......# File generated by update-locale</p><p>QMake version 3LC_MESSAGES='''<span style="color:#FF0000">zh_CN.1UTF-8</span>'''</p><p>Using Qt version LANG='''<span style="color:#FF0000">5.12zh_CN.UTF-8</span>''' in </usrp><p>LANGUAGE='''<span style="color:#FF0000">zh_CN.UTF-8</lib/aarch64-linux-gnuspan>'''</p>
|}
</li>
<li><p>Ubuntu22然后'''重启系统'''就能看到系统显示为中文了</p><p>[[File:zero3-img224.png]]</p></li></ol> <span id="ubuntu-20.04自带的QT版本为04系统的安装方法"></span> === Ubuntu 20.04系统的安装方法 === <ol style="list-style-type: decimal;"><li><p>首先打开'''5Language Support'''</p><p>[[File:zero3-img225.15png]]</p></li><li><p>然后找到'''汉语（中国）'''选项</p><p>[[File:zero3-img226.3png]]</p></li><li><p>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</p><p>[[File:zero3-img227.png]]</p></li> {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<pbig>orangepi@orangepi:~$ '''install_qt.sh注意，这一步不是很好拖动的，请耐心多试几次。'''</p><p>......</p><p>QMake version 3.1</p><p>Using Qt version '''<span style="color:#FF0000">5.15.3</span>''' in /usr/lib/aarch64-linux-gnu</pbig>
|}
</ol><ol start="4" style="list-style-type: decimal;"><li><p>然后选择'''Apply System-Wide'''将中文设置应用到整个系统</p><p>[[File:zero3-img228.png]]</p></li><li><p>Debian11自带的QT版本为然后设置'''Keyboard input method system'''为'5.15.2''fcitx'''</p>{| class="wikitable" <p>[[File:zero3-img229.png]]</p></li><li><p>'''<span style="widthcolor:800px;#FF0000" >然后重启Linux系统使配置生效</span>'''</p></li>|-| <li><p>orangepi@orangepi:~$ 重新进入系统后，在下面的界面请选择'''install_qt.sh不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</p><p>[[File:zero3-img230.png]]</p></li><li><p>然后可以看到桌面都显示为中文了</p><p>[[File:zero3-img231.....png]]</p></li><li><p>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示</p><p>QMake version 3[[File:zero3-img232.1png]]</p></li><li><p>Using Qt version 打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了</p><p>[[File:zero3-img233.png]]</p></li></ol> <span id="ubuntu-22.04系统的安装方法"></span > === Ubuntu 22.04系统的安装方法 === <ol style="colorlist-style-type:#FF0000decimal;">5<li><p>首先打开'''Language Support'''</p><p>[[File:zero3-img225.15.2png]]</p></spanli><li><p>然后找到''' in 汉语（中国）'''选项</usr/lib/aarch64p><p>[[File:zero3-linux-gnuimg234.png]]</p>|}</li><li><p>Debian12自带的QT版本为然后请使用鼠标左键选中'''5.15.8汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</p><p>[[File:zero3-img235.png]]</p></li> {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<pbig>orangepi@orangepi:~$ '''install_qt.sh注意，这一步不是很好拖动的，请耐心多试几次。'''</p><p>......</p><p>QMake version 3.1</p><p>Using Qt version '''<span style="color:#FF0000">5.15.8</span>''' in /usr/lib/aarch64-linux-gnu</pbig>
|}
</ol><ol start="4" style="list-style-type: decimal;"><li><p>然后选择'''Apply System-Wide'''将中文设置应用到整个系统</olp><p>[[File:zero3-img236.png]]</p></li><li><p>'''<span style="color:#FF0000">然后重启Linux系统使配置生效</span>'''</p></li><li><p>然后在重新进入系统后，在下面的界面请选择'''Applications不要再次询问我'''中就可以看到QT Creator的启动图标，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</p><p>[[File:mediazero3-img230.png]]</image254p></li><li><p>然后可以看到桌面都显示为中文了</p><p>[[File:zero3-img231.png]]</p></li><li><p>然后打开Fcitx5配置程序</p><p>[[File:zero3-img237.png]]</p></li><li><p>然后选择使用拼音输入法</p><p>[[File:zero3-img238.png]]</p></li><li><p>选择后的界面如下所示，再点击确定即可</p><p>[[File:zero3-img239.png]]</p></li><li><p>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示</p><p>[[File:zero3-img232.png|576x270px]]</p></li><li><p>也可以使用下面的命令打开QT Creator打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了</p><p>[[File:zero3-img240.png]]</p></li></ol> <span id="远程登录linux系统桌面的方法"></span> == 远程登录Linux系统桌面的方法 == <span id="使用nomachine远程登录"></span>=== 使用NoMachine远程登录 === {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<pbig>orangepi@orangepi:~$ '''qtcreator请确保开发板安装的Ubuntu或者Debian系统为桌面版本的系统。另外NoMachine也提供了详细的使用文档，强烈建议通读此文档来熟悉NoMachine的使用，文档链接如下所示：''' '''https://knowledgebase.nomachine.com/DT10R00166'''</pbig>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<big><p>'''Debian12请跳过这步。NoMachine支持Windows、Mac、Linux、iOS和安卓平台，所以我们可以在多种设备上通过NoMachine来远程登录控制Orange Pi开发板。下面演示下在Windows中通过NoMachine来远程登录Orange Pi开发板的Linux系统桌面。其他平台的安装方法请参考下NoMachine的官方文档。'''</p></big>
|}
|-
|
<pbig>[https://wiki.qt.io/Install_Qt_5_on_Ubuntu '''https://wiki.qt.io/Install_Qt_5_on_Ubuntu''']</p><p>[https://download.qt.io/archive/qtcreator '''https://download.qt.io/archive/qtcreator''']</p><p>[https://download.qt.io/archive/qt '''https://download.qt.io/archive/qt操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。''']</pbig>
|}
<ol style="list-style-type: decimal;"><li><p>首先下载NoMachine软件Linux '''<span idstyle="ros安装方法color:#FF0000">arm64</span>''' deb版本的安装包，然后安装到开发板的Linux系统中</p><ol style="list-style-type: lower-alpha;"><li>由于H618是ARMv8架构的SOC，我们使用的系统为Ubuntu或者Debian，所以这里需要下载'''NoMachine > for ARM ARMv8 DEB'''安装包，下载链接如下所示：
|-
|
|}
{| class="wikitable" style="width:800px;"
|-
|
|}
[[File:zero3-img241.png]]</li></ol><ol start="2" style="list-style-type: lower-alpha;"><li><p>ROS 另外在'''官方工具'''中也可以下载到''Noetic Ninjemys'NoMachine''官方安装文档中Ubuntu推荐使用Ubuntu20'的安装包</p><p>[[File:zero3-img242.04，所以请确保开发板使用的系统为png]]</p><p>先进入'''远程登录软件-NoMachine'''文件夹</p><p>[[File:zero3-img243.png]]</p><p>然后下载arm64版本的deb安装包<span style="color/p><p>[[File:#FF0000"zero3-img244.png]]</p></li><li><p>Ubuntu20然后将下载的'''nomachine_x.x.x_x_arm64.04桌面版系统deb'''上传到开发板的Linux系统中</p></spanli><li><p>然后使用下面的命令在开发板的Linux系统中安装'''NoMachine'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>[httporangepi@orangepi://wiki.ros.org/noetic/Installation ~$ '''http://wikisudo dpkg -i nomachine_x.x.rosx_x_arm64_arm64.org/noetic/Installationdeb''']</p>
|}
<p/li>[[File:media</image271.png|312x176px]]ol></pli></liol><!-- --><liol start="2" style="list-style-type: decimal;"><pli>然后使用下面的脚本安装ros1然后下载NoMachine软件Windows版本的安装包，下载地址如下所示</pli> {| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<pbig>orangepi@orangepi:~$ '''install_ros.sh ros1注意，这个下载链接可能会变。'''</pbig>
|}
{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
[[File:zero3-img245.png]]
</ol>
<ol start="3" style="list-style-type: decimal;">
<li><p>然后在Windows中安装NoMachine，'''安装完后请重启下电脑'''</p></li>
<li><p>然后在Window中打开'''NoMachine'''</p>
<p>[[File:zero3-img246.png]]</p></li>
<li><p>NoMachine启动后会自动扫描局域网内其他安装有NoMachine的设备，进入NoMachine的主界面后就可以看到开发板已经在可连接的设备列表里了，然后点击下图红色方框所示的位置即可开始登录开发板的Linux系统桌面</p>
<p>[[File:zero3-img247.png]]</p></li>
<li><p>然后点击'''OK'''</p>
<p>[[File:zero3-img248.png]]</p></li>
<li><p>然后在下图对应的位置输入开发板Linux系统的用户名和密码，再点击'''OK'''开始登陆</p>
<p>[[File:zero3-img249.png]]</p></li>
<li><p>然后在接下来的界面中都点击OK</p></li>
<li><p>最后就能看到开发板Linux系统的桌面了</p>
<p>[[File:zero3-img250.png]]</p></li></ol>
=== 使用VNC远程登录 ===
{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''
|}
<ol style="list-style-type: decimal;">
<li><p>首先运行'''set_vnc.sh'''脚本设置下vnc，'''记得加sudo权限'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''source /opt/ros/noetic/setupsudo set_vnc.bashsh'''</p><p>You will require a password to access your desktops.</p>
<p>New 'X' desktop is orangepi:1</p>
|}
</olli><li><p>安装完后会自动打印QT的版本号</p><ol start="6" style="list-style-type: decimallower-alpha;"><li><p>然后在Ubuntu20.04自带的qt版本为'''桌面'''中打开一个命令行终端窗口，再使用'''test_ros5.12.sh8'''脚本可以启动一个小海龟的例程来测试下ROS是否能正常使用</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''test_rosinstall_qt.sh'''</p><p>......</p><p>QMake version 3.1</p><p>Using Qt version '''<span style="color:#FF0000">5.12.8</span>''' in /usr/lib/aarch64-linux-gnu</p>
|}
</li>
<li><p>运行完'''test_rosUbuntu22.sh04自带的QT版本为'''脚本后，会弹出下图所示的一个小海龟</p><p>[[File:media/image272.png|575x291px]]</p></li><li><p>然后请保持刚才打开终端窗口在最上面</p></li> [[File:media/image2735.png|575x269px]]</ol><ol start="9" style="list-style-type: decimal;"><li><p>此时按下键盘上的方向按键就可以控制小海龟上下左右移动了</p><p>[[File:media/image27415.png|575x250px]]</p></li></ol> <span id="ubuntu20.04安装ros-2-galactic的方法"></span> === Ubuntu20.04安装ROS 2 Galactic的方法 === <ol style="list-style-type: decimal;"><li><p>ROS 2当前活跃的版本如下所示，推荐版本为3'''Galactic Geochelone'''</p><p>[[File:media/image275.png|576x271px]]</p><p>[[File:media/image276.png|575x265px]]</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>[httporangepi@orangepi://docs~$ '''install_qt.ros.org/ sh'''http:</p><p>......</docsp><p>QMake version 3.ros.org''']1</p><p>Using Qt version '''http<span style="color://docs#FF0000">5.ros15.org3</en/galactic/Releases.htmlspan>'''in /usr/lib/aarch64-linux-gnu</p>
|}
</li>
<li><p>ROS 2 Debian11自带的QT版本为'''Galactic Geochelone5.15.2'''官方安装文档链接如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''docsinstall_qt.sh'''</p><p>.....ros.org</en/galactic/Installationp><p>QMake version 3.html'''1</p><p>Using Qt version '''http<span style="color://docs#FF0000">5.ros15.org2</enspan>''' in /galacticusr/Installationlib/Ubuntuaarch64-Installlinux-Debians.html'''gnu</p>
|}
</li>
<li><p>ROS 2 Debian12自带的QT版本为'''Galactic Geochelone'''官方安装文档中Ubuntu Linux推荐使用Ubuntu205.04，所以请确保开发板使用的系统为'''<span style="color:#FF0000">Ubuntu20.04桌面版系统</span>'''。安装ROS 2有几种方法，下面演示下通过'''Debian packages'''的方式来安装ROS 2 '''Galactic Geochelone'''</p></li><li><p>使用'''install_ros15.sh8'''脚本可以安装ros2</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''install_rosinstall_qt.sh ros2'''</p><p>......</p><p>QMake version 3.1</p><p>Using Qt version '''<span style="color:#FF0000">5.15.8</span>''' in /usr/lib/aarch64-linux-gnu</p>
|}
</li></ol>
</li>
<li><p>然后在'''install_ros.sh'''脚本安装完ros2后会自动运行下Applications'''ros2 中就可以看到QT Creator的启动图标</p><p>[[File:zero3-h'''命令，如果能看到下面的打印，说明ros2安装完成img254.png]]</p><p>也可以使用下面的命令打开QT Creator</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>usageorangepi@orangepi: ros2 [-h] Call `ros2 <command> -h` for more detailed usage. ...</p> <p>ros2 is an extensible command-line tool for ROS 2.</p> <p>optional arguments:</p>:<p>-h, --help show this help message and exit</p> <p>Commands:</p>:<p>action Various action related sub-commands</p>:<p>bag Various rosbag related sub-commands</p>:<p>component Various component related sub-commands</p>:<p>daemon Various daemon related sub-commands</p>:<p>doctor Check ROS setup and other potential issues</p>:<p>interface Show information about ROS interfaces</p>:<p>launch Run a launch file</p>:<p>lifecycle Various lifecycle related sub-commands</p>:<p>multicast Various multicast related sub-commands</p>:<p>node Various node related sub-commands</p>:<p>param Various param related sub-commands</p>:<p>pkg Various package related sub-commands</p>:<p>run Run a package specific executable</p>:<p>security Various security related sub-commands</p>:<p>service Various service related sub-commands</p>:<p>topic Various topic related sub-commands</p>:<p>wtf Use `wtf` as alias to `doctor`</p> :<p>Call `ros2 <command> -h` for more detailed usage.~$ '''qtcreator'''</p>
|}
</li>
<li><p>然后可以使用 QT Creator打开后的界面如下所示</p><p>[[File:zero3-img255.png]]</p></li><li><p>QT Creator的版本如下所示</p><ol style="list-style-type: lower-alpha;"><li><p>QT Creator在'''test_rosUbuntu20.sh04'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行中的默认版本如下所示</p><p>[[File:zero3-img256.png]]</p></li><li><p>QT Creator在'''Ubuntu22.04'''中的默认版本如下所示</p><p>[[File:zero3-img257.png]]</p></li><li><p>QT Creator在'''Debian11'''中的默认版本如下所示</p><p>[[File:zero3-img258.png]]</p></li><li><p>QT Creator在'''Debian12'''中的默认版本如下所示</p><p>[[File:zero3-img259.png]]</p></li></ol></li><li><p>然后设置下QT</p><ol style="list-style-type: lower-alpha;"><li><p>首先打开'''Help'''->'''About Plugins...'''</p><p>[[File:zero3-img260.png]]</p></li><li><p>然后去掉'''ClangCodeModel'''的那个勾</p><p>[[File:zero3-img261.png]]</p></li><li><p>'''<span style="color:#FF0000">设置完后需要重启下QT Creator</span>'''</p></li><li><p>然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''test_ros.sh'''</pbig><p>[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'</p><p>[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1]</p><p>[INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2Debian12请跳过这步。'</p><p>[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2]</p><p>[INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'</p><p>[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</pbig>
|}
<p>[[File:zero3-img262.png]]</p>
<p>[[File:zero3-img263.png]]</p></li></ol>
</li>
<li><p>运行下面的命令可以打开rviz2然后就可以打开一个示例代码</p><p>[[File:zero3-img264.png]]</p></li><li><p>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明</p><p>[[File:zero3-img265.png]]</p></li><li><p>然后点击下'''Configure Project'''</p><p>[[File:zero3-img266.png]]</p></li><li><p>然后点击左下角的绿色三角形编译运行下示例代码</p><p>[[File:zero3-img267.png]]</p></li><li><p>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行</p><p>[[File:zero3-img268.png]]</p></li><li><p>参考资料</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi[https:~$ //wiki.qt.io/Install_Qt_5_on_Ubuntu '''source https:/opt/ros/galacticwiki.qt.io/setup.bashInstall_Qt_5_on_Ubuntu''']</p><p>orangepi@orangepi[https:~$ //download.qt.io/archive/qtcreator '''ros2 run rviz2 rviz2'''<https:/p>|}<p>[[File:media/image277download.qt.png|576x324px]]<io/p><archive/li><li><p>ROS的使用方法请参考下ROS 2的文档qtcreator''']</p>{| class="wikitable" style="width:800px;" |-| <p>[httphttps://docsdownload.rosqt.orgio/enarchive/galactic/Tutorials.html qt '''httphttps://docsdownload.rosqt.orgio/enarchive/galactic/Tutorials.htmlqt''']</p>
|}
</li></ol>
<span id="ubuntu22ros安装方法"></span> == ROS安装方法 == <span id="ubuntu20.04安装ros-21-humble的方法noetic的方法"></span>=== Ubuntu20.04安装ROS 1 Noetic的方法 ===
::[[File:zero3-img269.png]] ::[[File:zero3-img270.png]] ::{| class="wikitable" style="width:800px;" |-| [http://docs.ros.org/ '''http://docs.ros.org'''] '''https://wiki.ros.org/Distributions'''|} <ol start="2" style="list-style-type: decimal;"><li><p>使用ROS 1 '''install_ros.shNoetic Ninjemys'''脚本可以安装ros2官方安装文档链接如下所示：</p>{| class="wikitable" style="width:800px;" |-
|
<p>orangepi@orangepi[http:~$ //wiki.ros.org/noetic/Installation/Ubuntu '''install_roshttp://wiki.ros.sh ros2org/noetic/Installation/Ubuntu''']</p>
|}
</li>
<li><p>ROS '''install_rosNoetic Ninjemys'''官方安装文档中Ubuntu推荐使用Ubuntu20.sh04，所以请确保开发板使用的系统为'''脚本安装完ros2后会自动运行下<span style="color:#FF0000">Ubuntu20.04桌面版系统</span>'''ros2 </p>{| class="wikitable" style="width:800px;" |-h| <p>[http://wiki.ros.org/noetic/Installation '''命令，如果能看到下面的打印，说明ros2安装完成http://wiki.ros.org/noetic/Installation''']</p>|}<p>[[File:zero3-img271.png]]</p></li><li><p>然后使用下面的脚本安装ros1</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>usageorangepi@orangepi: ros2 [~$ '''install_ros.sh ros1'''</p>|}</li><li><p>使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件</p></li> {| class="wikitable" style="background-h] Call `ros2 <color:#ffffdc;command>width:800px; " |-h` for more detailed usage. ...| <big>'''<span style="color:#FF0000">注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。</pspan>''' '''install_ros.sh脚本会尝试修改/etc/hosts并自动运行下面的命令。但是这种方法无法保证每次都能正常访问github，如果install_ros.sh安装完ros1后有提示下面的错误，请自己想其它办法让开发板的linux系统能正常访问github，然后再手动运行下面的命令。'''
'''Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml'''
'''<pspan style="color:#FF0000">optional argumentsERROR:</p>error loading sources list:<p>-h, --help show this help message and exit</pspan>'''
::'''<span style="color:#FF0000">The read operation timed out</span>'''</big>
|}
Wrote /etc/ros/rosdep/sources.list.d/20-default.list
Recommended:<p>Call `ros2 <command> -h` for more detailed usage.</p>|}</li><li><p>然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''test_ros.sh'''</p><p>[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'</p><p>[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1]</p><p>[INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'</p><p>[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2]</p><p>[INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'</p><p>[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</p>|}</li><li><p>运行下面的命令可以打开rviz2</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''source /opt/ros/humble/setup.bash'''</p><p>orangepi@orangepi:~$ '''ros2 please run rviz2 rviz2'''</p>|}<p>[[File:media/image278.png|575x323px]]</p></li><li><p>参考文档</p>{| class="wikitable" style="width:800px;" |-| <p>'''http://docs.ros.org/en/humble/index.html'''</p><p>[http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html''']</p>|}</li></ol>
|}
</liol><ol start="6" style="list-style-type: decimal;"><li><p>编译完后会生成然后在'''桌面'''中打开一个命令行终端窗口，再使用'''hellotest_ros.kosh'''内核模块脚本可以启动一个小海龟的例程来测试下ROS是否能正常使用</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:/usr/src/hello~$ '''ls *test_ros.kosh'''</p><p>hello.ko</p>
|}
</li>
<li><p>使用运行完'''insmodtest_ros.sh'''命令可以将脚本后，会弹出下图所示的一个小海龟</p><p>[[File:zero3-img272.png]]</p></li><li><p>然后请保持刚才打开终端窗口在最上面</p></li> [[File:zero3-img273.png]]</ol><ol start="9" style="list-style-type: decimal;"><li><p>此时按下键盘上的方向按键就可以控制小海龟上下左右移动了</p><p>[[File:zero3-img274.png]]</p></li></ol> <span id="ubuntu20.04安装ros-2-galactic的方法"></span> === Ubuntu20.04安装ROS 2 Galactic的方法 === <ol style="list-style-type: decimal;"><li><p>ROS 2当前活跃的版本如下所示，推荐版本为'''hello.koGalactic Geochelone'''内核模块插入内核中</p><p>[[File:zero3-img275.png]]</p><p>[[File:zero3-img276.png]]</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi[http:/usr/srcdocs.ros.org/ '''http://docs.ros.org''']</hello$ p><p>'''sudo insmod hellohttp://docs.ros.org/en/galactic/Releases.kohtml'''</p>
|}
</li>
<li><p>然后使用ROS 2 '''demsgGalactic Geochelone'''命令可以查看下'''hello.ko'''内核模块的输出，如果能看到下面的输出说明'''hello.ko'''内核模块加载正确官方安装文档链接如下所示：</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:'''docs.ros.org/usren/srcgalactic/hello$ '''dmesg | grep "Hello"Installation.html'''</p><p>[ 2871.893988] '''Hello Orange Pi http://docs.ros.org/en/galactic/Installation/Ubuntu-Install- initDebians.html'''</p>
|}
</li>
<li><p>使用ROS 2 '''Galactic Geochelone'''官方安装文档中Ubuntu Linux推荐使用Ubuntu20.04，所以请确保开发板使用的系统为'''<span style="color:#FF0000">Ubuntu20.04桌面版系统</span>'''。安装ROS 2有几种方法，下面演示下通过'''Debian packages'''的方式来安装ROS 2 '''rmmodGalactic Geochelone'''命令可以卸载</p></li><li><p>使用'''helloinstall_ros.kosh'''内核模块脚本可以安装ros2</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:/usr/src/hello$ '''sudo rmmod hello'''</p><p>orangepi@orangepi:/usr/src/hello~$ '''dmesg | grep "Hello"'''</p><p>[ 2871install_ros.893988] Hello Orange Pi -- init</p><p>[ 3173.800892] '''Hello Orange Pi -- exit'''</p>|}</li></ol> <span id="linux系统支持的部分编程语言测试"></span> == Linux系统支持的部分编程语言测试 == <span id="debian-bullseye系统"></span>=== Debian Bullseye系统 === <ol style="list-style-type: decimal;"><li><p>Debian Bullseye默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p><ol style="list-style-type: lower-alpha;"><li><p>gcc的版本如下所示</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ ''sh ros2'gcc --version'''</p><p>gcc (Debian 10.2.1-6) 10.2.1 20210110</p><p>Copyright (C) 2020 Free Software Foundation, Inc.</p><p>This is free software; see the source for copying conditions. There is NO</p><p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
|}
</li>
<li><p>编写C语言的'''hello_worldinstall_ros.csh'''程序脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepiusage:~$ '''vim hello_worldros2 [-h] Call `ros2 <command> -h` for more detailed usage. ...c'''</p> <p>#include <stdioros2 is an extensible command-line tool for ROS 2.h></p>
<p>int main(void)</p><p>{optional arguments:</p>:<p>printf("Hello World!\n");-h, --help show this help message and exit</p>
<p>Commands:</p>:<p>action Various action related sub-commands</p>:<p>bag Various rosbag related sub-commands</p>:<p>component Various component related sub-commands</p>:<p>daemon Various daemon related sub-commands</p>:<p>doctor Check ROS setup and other potential issues</p>:<p>interface Show information about ROS interfaces</p>:<p>launch Run a launch file</p>:<p>return 0;lifecycle Various lifecycle related sub-commands</p>:<p>multicast Various multicast related sub-commands</p>:<p>node Various node related sub-commands</p>:<p>param Various param related sub-commands</p>:<p>pkg Various package related sub-commands</p>:<p>run Run a package specific executable</p>:<p>security Various security related sub-commands</p>:<p>service Various service related sub-commands</p>:<p>topic Various topic related sub-commands</p>:<p>wtf Use `wtf` as alias to `doctor`</p> :<p>}Call `ros2 <command> -h` for more detailed usage.</p>|}
</li>
<li><p>然后编译运行然后可以使用 '''hello_worldtest_ros.csh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''gcc -o hello_world hello_worldtest_ros.csh'''</p><p>orangepi@orangepi[INFO] [1671174101.200091527] [talker]: Publishing:~$ 'Hello World: 1'</p><p>[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1]</p><p>[INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'</p><p>[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2]</hello_world'p><p>[INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'</p><p>[INFO] [1671174103.204019965] [listener]: I heard: [Hello World!: 3]</p>
|}
</li>
<li><p>Debian Bullseye默认安装有Python3</p><ol style="list-style-type: lower-alpha;"><li><p>Python具体版本如下所示运行下面的命令可以打开rviz2</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3source /opt/ros/galactic/setup.bash'''</p><p>orangepi@orangepi:~$ '''Python 3.9.2ros2 run rviz2 rviz2''' (default, Feb 28 2021, 17:03:44)</p><p>[GCC 10.2.1 20210110] on linux</p><p>Type "help", "copyright", "credits" or "license" for more information.</p><p>>>></p>
|}
<p>[[File:zero3-img277.png]]</p></li><li><p>ROS的使用方法请参考下ROS 2的文档</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
|}
</li></ol> <span id="ubuntu22.04安装ros-2-humble的方法"></span> === Ubuntu22.04安装ROS 2 Humble的方法 === <ol style="list-style-type: decimal;"><li><p>编写Python语言的使用'''hello_worldinstall_ros.pysh'''程序脚本可以安装ros2</p>{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''vim hello_worldinstall_ros.pysh ros2'''</p><p>print('Hello World!')</p>
|}
</li>
<li><p>运行'''hello_worldinstall_ros.pysh'''的结果如下所示脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepiusage:~$ '''python3 hello_worldros2 [-h] Call `ros2 <command> -h` for more detailed usage.py'''...</p> <p>ros2 is an extensible command-line tool for ROS 2.</p> <p>optional arguments:</p>:<p>-h, --help show this help message and exit</p> <p>Commands:</p>:<p>action Various action related sub-commands</p>:<p>bag Various rosbag related sub-commands</p>:<p>component Various component related sub-commands</p>:<p>daemon Various daemon related sub-commands</p>:<p>doctor Check ROS setup and other potential issues</p>:<p>interface Show information about ROS interfaces</p>:<p>launch Run a launch file</p>:<p>lifecycle Various lifecycle related sub-commands</p>:<p>Hello World!multicast Various multicast related sub-commands</p>:<p>node Various node related sub-commands</p>:<p>param Various param related sub-commands</p>:<p>pkg Various package related sub-commands</p>:<p>run Run a package specific executable</p>:<p>security Various security related sub-commands</p>:<p>service Various service related sub-commands</p>:<p>topic Various topic related sub-commands</p>:<p>wtf Use `wtf` as alias to `doctor`</p> :<p>Call `ros2 <command> -h` for more detailed usage.</p>
|}
</li>
<li><p>Debian Bullseye默认没有安装Java的编译工具和运行环境</p><ol style="list-style-type: lower-alpha;"><li><p>可以使用下面的命令安装openjdk，Debian Bullseye中最新版本为openjdk-17然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdktest_ros.sh'''</p>|}<p>[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'</lip><lip>[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1]</p><p>安装完后可以查看下Java的版本[INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'</p>{| class="wikitable" style="width<p>[INFO] [1671174102.204196299] [listener]: I heard: [Hello World:800px;" |-| 2]</p><p>orangepi@orangepi[INFO] [1671174103.199580322] [talker]: Publishing:~$ '''java --version''Hello World: 3'</p><p>[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</p>
|}
</li>
<li><p>编写Java版本的'''hello_world.java'''运行下面的命令可以打开rviz2</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''vim hello_worldsource /opt/ros/humble/setup.javabash'''</p><p>public class hello_world</p><p>{</p>:<p>public static void main(String[] args)</p>orangepi@orangepi:<p>{</p>::<p>System.out.println("Hello World!");</p>:<p>}</p><p>}~$ '''ros2 run rviz2 rviz2'''</p>
|}
<p>[[File:zero3-img278.png]]</p></li><li><p>然后编译运行'''hello_world.java'''参考文档</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''javac hello_worldhttp://docs.ros.org/en/humble/index.javahtml'''</p><p>orangepi@orangepi[http:~$ //docs.ros.org/en/galactic/Tutorials.html '''java hello_worldhttp://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html'''</p><p>Hello World!]</p>
|}
</li></ol>
{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''<span style= Debian Bookworm系统 ==="color:#FF0000">Linux6.1</span>内核的Debian11系统编译内核模块时会报GCC的错误。所以如果要编译内核模块请使用Debian12或者Ubuntu22.04。'''</big>|}
<ol style="list-style-type: decimal;">
<li><p>Debian Bookworm默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<OPi发布的Linux镜像默认自带了内核头文件的deb包，存放的位置为'''/p><ol style="list-style-type: lower-alpha;"><li><p>gcc的版本如下所示opt/'''</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''gcc ls /opt/linux--versionheaders*'''</p><p>gcc (Debian 12.2.0/opt/linux-headers-xxx-14) 12sun50iw9_x.2x.0</p><p>Copyright (C) 2022 Free Software Foundation, Inc.</p><p>This is free software; see the source for copying conditions. There is NO</p><p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSEx_arm64.deb</p>
|}
</li>
<li><p>编写C语言的'''hello_world.c'''程序使用下面的命令可以安装内核头文件的deb包</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''vim hello_worldsudo dpkg -i /opt/linux-headers*.cdeb'''</p><p>#include <stdio.h></p> <p>int main(void)</p><p>{</p>:<p>printf("Hello World!\n");</p> :<p>return 0;</p><p>}</p>
|}
</li>
<li><p>然后编译运行安装完后在'''hello_world.c/usr/src'''下就能看到内核头文件所在的文件夹</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''<ls /p><p>orangepi@orangepi:~$ '''.usr/hello_worldsrc'''</p><p>Hello World!linux-headers-x.x.x</p>
|}
</li>
<li><p>Debian Bookworm默认安装有Python3<然后可以编译下Linux镜像中自带的hello内核模块的源码，hello模块的源码在'''/p><ol style="list-style-type: lower-alpha;"><li><p>Python具体版本如下所示usr/src/hello'''中，进入此目录后，然后使用make命令编译即可。</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3cd /usr/src/hello/'''</p><p>orangepi@orangepi:/usr/src/hello$ '''sudo make'''</p><p>Python 3make -C /lib/modules/5.114.2 (main, Mar 13 2023, 12125/build M=/usr/src/hello modules</p><p>make[1]:18Entering directory '/usr/src/linux-headers-5.4.125'</p>:29) <p>CC [GCC 12M] /usr/src/hello/hello.o</p>:<p>Building modules, stage 2.0</p>:<p>MODPOST 1 modules</p>:<p>CC [M] on linux/usr/src/hello/hello.mod.o</p>:<p>Type "help", "copyright", "credits" or "license" for more informationLD [M] /usr/src/hello/hello.ko</p><p>>>>make[1]: Leaving directory '/usr/src/linux-headers-5.4.125'</p>
|}
</li><li><p>编译完后会生成'''hello.ko'''内核模块</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;"
|-
|
|}
</li>
<li><p>编写Python语言的使用'''hello_worldinsmod'''命令可以将'''hello.pyko'''程序内核模块插入内核中</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/usr/src/hello$ '''vim hello_worldsudo insmod hello.py'ko''</p><p>print('Hello World!')</p>
|}
</li>
<li><p>运行然后使用'''hello_worlddemsg'''命令可以查看下'''hello.ko'''内核模块的输出，如果能看到下面的输出说明'''hello.pyko'''的结果如下所示内核模块加载正确</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/usr/src/hello$ '''python3 hello_world.pydmesg | grep "Hello"'''</p><p>[ 2871.893988] '''Hello World!Orange Pi -- init'''</p>
|}
</li>
<li><p>Debian Bookworm默认没有安装Java的编译工具和运行环境</p><ol style="list-style-type: lower-alpha;"><li><p>可以使用下面的命令安装openjdk，Debian Bookworm中最新版本为openjdk-17使用'''rmmod'''命令可以卸载'''hello.ko'''内核模块</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~/usr/src/hello$ '''sudo apt install -y openjdk-17-jdkrmmod hello'''</p>|}</li><li><p>安装完后可以查看下Java的版本</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''java --version'''</p>|}<usr/li><li><p>编写Java版本的'''hello_world.java'''<src/p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~hello$ '''vim hello_world.java'''</p><p>public class hello_world</p><p>{</p>:<p>public static void main(String[] args)</p>:<p>{</p>::<p>System.out.println(dmesg | grep "Hello World!");</p>:<p>}</p><p>}</p>|}</li><li><p>然后编译运行'''hello_world.java'''</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''javac hello_world[ 2871.java'''893988] Hello Orange Pi -- init</p><p>orangepi@orangepi:~$ [ 3173.800892] '''java hello_worldHello Orange Pi -- exit'''</p><p>Hello World!</p>
|}
</li></ol>
<span id="ubuntu-focal系统linux系统支持的部分编程语言测试"></span> == Linux系统支持的部分编程语言测试 ==
<span id="debian-bullseye系统"></span>== Ubuntu Focal系统 = Debian Bullseye系统 ===
<ol style="list-style-type: decimal;">
<li><p>Ubuntu Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序Debian Bullseye默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p>
<ol style="list-style-type: lower-alpha;">
<li><p>gcc的版本如下所示</p>
|
<p>orangepi@orangepi:~$ '''gcc --version'''</p>
<p>gcc (Ubuntu 9Debian 10.42.01-1ubuntu1~206) 10.042.1) 9.4.020210110</p><p>Copyright (C) 2019 2020 Free Software Foundation, Inc.</p>
<p>This is free software; see the source for copying conditions. There is NO</p>
<p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
</li></ol>
</li>
<li><p>Ubuntu Focal默认安装有Python3Debian Bullseye默认安装有Python3</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Python3具体版本如下所示Python具体版本如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3'''</p>
<p>'''Python 3.89.10 2''' (default, Nov 14 2022Feb 28 2021, 1217:5903:4744)</p><p>[GCC 910.42.01 20210110] on linux</p>
<p>Type "help", "copyright", "credits" or "license" for more information.</p>
<p>>>></p>
</li></ol>
</li>
<li><p>Ubuntu Focal默认没有安装Java的编译工具和运行环境Debian Bullseye默认没有安装Java的编译工具和运行环境</p>
<ol style="list-style-type: lower-alpha;">
<li><p>可以使用下面的命令安装openjdk可以使用下面的命令安装openjdk，Debian Bullseye中最新版本为openjdk-17</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''java --version'''</p>
|}
</li>
</li></ol>
<span id="ubuntudebian-jammy系统bookworm系统"></span>
=== Ubuntu Jammy系统 Debian Bookworm系统 ===
<ol style="list-style-type: decimal;">
<li><p>Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序Debian Bookworm默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p>
<ol style="list-style-type: lower-alpha;">
<li><p>gcc的版本如下所示</p>
|
<p>orangepi@orangepi:~$ '''gcc --version'''</p>
<p>gcc (Ubuntu 11Debian 12.32.0-1ubuntu1~22.04.114) '''1112.32.0'''</p><p>Copyright (C) 2021 2022 Free Software Foundation, Inc.</p>
<p>This is free software; see the source for copying conditions. There is NO</p>
<p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
</li></ol>
</li>
<li><p>Ubuntu Jammy默认安装有Python3Debian Bookworm默认安装有Python3</p>
<ol style="list-style-type: lower-alpha;">
<li><p>Python3具体版本如下所示Python具体版本如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''python3'''</p>
<p>Python 3.1011.6 2 (main, May 29 Mar 13 2023, 1112:1018:3829) [GCC 1112.32.0] on linux</p>
<p>Type "help", "copyright", "credits" or "license" for more information.</p>
<p>>>></p>
</li></ol>
</li>
<li><p>Ubuntu Jammy默认没有安装Java的编译工具和运行环境Debian Bookworm默认没有安装Java的编译工具和运行环境</p>
<ol style="list-style-type: lower-alpha;">
<li><p>可以使用下面的命令安装openjdk可以使用下面的命令安装openjdk，Debian Bookworm中最新版本为openjdk-1817</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>orangepi@orangepi:~$ '''sudo apt install -y openjdk-1817-jdk'''</p>
|}
</li>
|
<p>orangepi@orangepi:~$ '''java --version'''</p>
|}
</li>
</li></ol>
<span id="上传文件到开发板linux系统中的方法ubuntu-focal系统"></span>
== 上传文件到开发板Linux系统中的方法 == <span id="在ubuntu-pc中上传文件到开发板linux系统中的方法"></span>=== 在Ubuntu PC中上传文件到开发板Linux系统中的方法 === ==== 使用scp命令上传文件的方法 =Ubuntu Focal系统 ===
<ol style="list-style-type: decimal;">
<li><p>使用scp命令可以在Ubuntu PC中上传文件到开发板的Linux系统中，具体命令如下所示Ubuntu Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p>
<ol style="list-style-type: lower-alpha;">
<li><p>'''file_path：'''需要替换为要上传文件的路径</p></li><li><p>'''orangepi：'''为开发板linux系统的用户名，也可以替换成其它的，比如root</p></li><li><p>'''192.168.xx.xx:''' 为开发板的IP地址，请根据实际情况进行修改</p></li><li><p>'''/home/orangepi:''' 开发板linux系统中的路径，也可以修改为其它的路径gcc的版本如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>testorangepi@testorangepi:~$ '''scp file_path orangepi@192gcc --version'''</p><p>gcc (Ubuntu 9.4.0-1ubuntu1~20.04.1681) 9.xx4.xx:0</homep><p>Copyright (C) 2019 Free Software Foundation, Inc.</orangepip><p>This is free software; see the source for copying conditions. There is NO</'''p><p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
|}
</li>
<li><p>如果要上传文件夹，需要加上-r参数编写C语言的'''hello_world.c'''程序</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>testorangepi@testorangepi:~$ '''scp vim hello_world.c'''<span style="color:/p><p>#FF0000"include <stdio.h></p> <p>int main(void)</p><p>-r{</spanp> dir_path orangepi@192.168.xx.xx:<p>printf("Hello World!\n");</homep> :<p>return 0;</orangepi/'''p><p>}</p>
|}
</li>
<li><p>scp还有更多的用法，请使用下面的命令查看man手册然后编译运行'''hello_world.c'''</p>
{| class="wikitable" style="width:800px;"
|-
|
|}
</li></ol>
</li>==== 使用filezilla上传文件的方法 ====<li><p>Ubuntu Focal默认安装有Python3</p><ol style="list-style-type: decimallower-alpha;"><li><p>首先在Ubuntu PC中安装filezillaPython3具体版本如下所示</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>testorangepi@testorangepi:~$ '''sudo apt install python3'''</p><p>Python 3.8.10 (default, Nov 14 2022, 12:59:47)</p><p>[GCC 9.4.0] on linux</p><p>Type "help", "copyright", "credits" or "license" for more information.</p><p>>>></p>|}{| class="wikitable" style="background-y filezillacolor:#ffffdc;width:800px;" |-| <big><p>'''使用Ctrl+D快捷键可退出python的交互模式。'''</p></big>
|}
</li>
<li><p>然后使用下面的命令打开filezilla编写Python语言的'''hello_world.py'''程序</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>testorangepi@testorangepi:~$ '''filezillavim hello_world.py'''</p><p>print('Hello World!')</p>
|}
</li>
<li><p>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的运行'''hello_world.py'''的结果如下所示</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''python3 hello_world.py'''</p><p>Hello World!</p>|}</li></ol></li><li><p>Ubuntu Focal默认没有安装Java的编译工具和运行环境</p><ol style="list-style-type: lower-alpha;"><li><p>可以使用下面的命令安装openjdk-17</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdk'''</p>|}</li><li><p>安装完后可以查看下Java的版本</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''java --version'''</p><p>openjdk 17.0.2 2022-01-18</p><p>OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.04)</p><p>OpenJDK 64-Bit Server VM (build 17.0.2+8-Ubuntu-120.04, mixed mode, sharing)</p>|}</li><div li><p>编写Java版本的'''hello_world.java'''</p>{| class="figurewikitable"style="width:800px;" |-| <p>orangepi@orangepi:~$ '''vim hello_world.java'''</p><p>public class hello_world</p><p>{</p>:<p>public static void main(String[] args)</p>:<p>{</p>::<p>System.out.println("Hello World!");</p>:<p>}</p><p>}</p>|}</li><li><p>然后编译运行'''hello_world.java'''</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''javac hello_world.java'''</p><p>orangepi@orangepi:~$ '''java hello_world'''</p><p>Hello World!</p>|}</li></ol></li></ol>
<div ol style="list-style-type: decimal;"><li><p>Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序</p><ol style="list-style-type: lower-alpha;"><li><p>gcc的版本如下所示</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''gcc --version'''</p><p>gcc (Ubuntu 11.3.0-1ubuntu1~22.04.1) '''11.3.0'''</p><p>Copyright (C) 2021 Free Software Foundation, Inc.</p><p>This is free software; see the source for copying conditions. There is NO</p><p>warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>|}</li><li><p>编写C语言的'''hello_world.c'''程序</p>{| class="figurewikitable" style="width:800px;"|-| <p>orangepi@orangepi:~$ '''vim hello_world.c'''</p><p>#include <stdio.h></p>
<div classspan id="figure在ubuntu-pc中上传文件到开发板linux系统中的方法"></span>=== 在Ubuntu PC中上传文件到开发板Linux系统中的方法 ===
<ol style="list-style-type: decimal;"><li><p>使用scp命令可以在Ubuntu PC中上传文件到开发板的Linux系统中，具体命令如下所示</divp><ol start="5" style="list-style-type: decimallower-alpha;"><li><p>'''file_path：'''需要替换为要上传文件的路径</p></li><li><p>'''orangepi：'''为开发板linux系统的用户名，也可以替换成其它的，比如root</p></li><li><p>'''192.168.xx.xx:''' 为开发板的IP地址，请根据实际情况进行修改</p></li><li><p>'''/home/orangepi:''' 开发板linux系统中的路径，也可以修改为其它的路径</p>{| class="wikitable" style="width:800px;"|-| <p>test@test:~$ '''scp file_path orangepi@192.168.xx.xx:/home/orangepi/'''</p>|}</li></ol></li><li>然后选择<p>如果要上传文件夹，需要加上-r参数</p>{| class="wikitable" style="width:800px;" |-| <p>test@test:~$ '''保存密码scp <span style="color:#FF0000">-r</span> dir_path orangepi@192.168.xx.xx:/home/orangepi/'''，再点击</p>|}</li><li><p>scp还有更多的用法，请使用下面的命令查看man手册</p>{| class="wikitable" style="width:800px;" |-| test@test:~$ '''确定man scp'''|}</li></ol> ==== 使用filezilla上传文件的方法 ====
<ol style="list-style-type: decimal;">
<li><p>首先在Ubuntu PC中安装filezilla</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>test@test:~$ '''sudo apt install -y filezilla'''</p>
|}
</li>
<li><p>然后使用下面的命令打开filezilla</p>
{| class="wikitable" style="width:800px;"
|-
|
<p>test@test:~$ '''filezilla'''</p>
|}
</li>
<li><p>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的</p>
<div class="figure">
[[File:media/image290zero3-img279.png|207x146px|IMG_256]]
</div><ol start="6" style="list-style-type: decimal;"/li><li>然后选择'''总是信任该主机'''，再点击'''确定'''</lip>连接开发板的方法如下图所示</olp>
<div class="figure">
[[File:media/image291zero3-img280.png|221x109px|IMG_256]]
</div>
</li></ol>
<ol start="5" style="list-style-type: decimal;">
<li><p>然后选择'''保存密码'''，再点击'''确定'''</p>
<p>[[File:zero3-img281.png]]</p></li>
<li><p>然后选择'''总是信任该主机'''，再点击'''确定'''</p>
<div class="figure">
[[File:zero3-img282.png]]
</div></li></ol>
<ol start="7" style="list-style-type: decimal;">
<li>连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了</li></ol>
<div class="figure">
[[File:media/image292zero3-img283.png|449x332px|IMG_256]]
</div></ol>
<ol start="8" style="list-style-type: decimal;">
<li>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Windows PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Ubuntu PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了。</li></ol>
<div class="figure">
[[File:media/image293zero3-img284.png|461x340px|IMG_256]]
</div></ol>
<ol start="9" style="list-style-type: decimal;">
<li><p>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</p></li>
<li><p>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</p></li></ol>
<span id== 开关机logo使用说明 =="在windows-pc中上传文件到开发板linux系统中的方法"></span>
<span id="使用filezilla上传文件的方法-1"></span>==== 使用filezilla上传文件的方法 == 关机和重启开发板的方法 ==
<ol start="2" style= 编译系统需求 "list-style-type: decimal;"><li><p>下载的安装包如下所示，然后双击直接安装即可</p>{| class="wikitable" style="width:800px;" |-| <p>'''FileZilla_Server_1.5.1_win64-setup.exe'''</p>|}
[https[File://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-desktopzero3-amd64img289.iso'''png]]
<ol stylediv class="list-style-type: lower-alpha;figure"><li>替换清华源的方法参考这个网页的说明即可。</li></ol>
[https[File://mirrorszero3-img290.tuna.tsinghua.edu.cn/help/ubuntu/ '''https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/'''png]]
</div></li></ol><ol start="26" style="list-style-type: lower-alphadecimal;"><li><p>注意Ubuntu版本需要切换到22.04。</p><p>[[File:media/image294.png|576x241px]]</p></li><li><p>需要替换的然后选择'''/etc/apt/sources.list总是信任该主机'''文件的内容为：</p><p>test@test:~$ ，再点击'''sudo mv /etc/apt/sources.list cat /etc/apt/sources.list.bak'''</p><p>test@test:~$ 确定'''sudo vim /etc/apt/sources.list'''</p><p># 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释</p><p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse</p><p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse</p><p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse</p><p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse</p><p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse</p><p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse</p><p>deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse</p><p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse</p><p># 预发布软件源，不建议启用</p><p># deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse</p><p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse</p></li><li><p>替换完后需要更新下包信息，并确保没有报错。</p><p>test@test:~$ '''sudo apt-get update'''</p></li><li><p>'''另外，由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。'''</p></li></ol>
<span iddiv class="获取linux-sdk的源码figure"></span>== 获取linux sdk的源码 ==
[[File:media/image295zero3-img293.png|576x288px]]
<ol style="list-style-type: decimal;"><li><p>开关机logo默认只在桌面版的系统中才会显示</p></li><li><p>在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''false'''可以关闭开关机logo</p>{| class="wikitable" style="width:800px;"
|-
| <p>orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''</p><p>verbosity=1</p><p>'''<span style="text-aligncolor: left;#FF0000">bootlogo=false</span>'''</p>| }</li><li><p>在'''/boot/orangepiEnv.txt'''中设置'''分支bootlogo'''变量为'''true'''可以开启开关机logo</p>{| class="wikitable" style="text-alignwidth: left800px;"|-| <p>orangepi@orangepi:~$ '''u-boot版本sudo vim /boot/orangepiEnv.txt'''</p>| <p>verbosity=1</p><p>'''<span style="text-aligncolor: left;#FF0000"| '''linux内核版本>bootlogo=true</span>'''</p>|}</li><li><p>开机logo图片在linux系统中的位置为</p>{| class="wikitable" style="width:800px;"
|-
| style="text-align: left;"| <p>'''current/usr/share/plymouth/themes/orangepi/watermark.png'''</p>| style}</li><li><p>替换开机logo图片后需要运行下命令才能生效</p>{| class="text-align: left;wikitable"| '''u-boot v2018.05'''| style="text-alignwidth: left800px;"| '''linux5.4'''
|-
| style="text-align: left;"| '''next'''| style="text-align<p>orangepi@orangepi: left;"| ~$ '''usudo update-boot v2021.07'''| style="textinitramfs -align: left;"| '''linux6.1u'''</p>
|}
</li></ol>
<ol style="list-style-type: decimal;"><li><p>在Linux系统运行的过程中，如果直接拔掉电源断电，可能会导致文件系统丢失某些数据，建议断电前先使用'''目前全志提供的linux5.4 bsp内核我们定义为current分支。最新的linux6.1 LTS内核定义为next分支。poweroff'''命令关闭开发板的Linux系统，然后再拔掉电源</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''sudo poweroff'''</p>|}{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''注意，关闭开发板后需要重新拔插电源才能开机。'''</p></big>|}</li><li><p>使用'''reboot'''命令即可重启开发板中的Linux系统</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''sudo''' '''reboot'''</p>|}</li></ol>
Linux SDK，即'''orangepi-build'''，只支持在安装有'''<span style="color:#FF0000">Ubuntu 22.04</span>'''的X64电脑上运行，所以下载orangepi-build前，请首先确保自己电脑已安装的Ubuntu版本是Ubuntu 22.04。查看电脑已安装的Ubuntu版本的命令如下所示，如果Release字段显示的不是'''<span style== 下载交叉编译工具链 ==="color:#FF0000">22.04</span>'''，说明当前使用的Ubuntu版本不符合要求，请更换系统后再进行下面的操作。
Codename: '''toolchainsjammy'''下载完后会包含多个版本的交叉编译工具链：|}
<ol style="list-style-type: lower-alpha;"p># 预发布软件源，不建议启用<li/p><p>linux5# deb https://mirrors.4tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse</p><p>'''gcc# deb-arm-11src https://mirrors.tuna.tsinghua.2-2022edu.02cn/ubuntu/ jammy-x86_64-aarch64-none-linux-gnu'''proposed main restricted universe multiverse</p>|}</li><li><p>linux6.1替换完后需要更新下包信息，并确保没有报错。</p>{| class="wikitable" style="width:800px;" |-| <p>test@test:~$ '''gcc-arm-11.2sudo apt-2022.02-x86_64-aarch64-none-linux-gnuget update'''</p>|}</li><li><p>编译H618 u'''<span style="color:#FF0000">另外，由于内核和U-boot源码使用的交叉编译工具链为：boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。</span>'''</p></li></ol> <span id="获取linux-sdk的源码"></span>
=== orangepi从github下载orangepi-build完整目录结构说明 build ===
test@test:~$ '''git clone https://github.com/orangepi-xunlong/orangepi-build.git <span style== 编译u"color:#FF0000">-boot ==b next</span>'''|}
[[File:media/image297zero3-img295.png|576x132px|选区_238]]|}
<ol style="list-style-type: lower-alpha;">
<li><p>linux内核源码的版本</p><p>[ o.k. ] Compiling current kernel [ '''6build.1.31sh''' ]: 编译启动脚本</p></li><li><p>使用的交叉编译工具链的版本</p><p>[ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 11external''' ]: 包含编译镜像需要用的配置文件、特定的脚本以及部分程序的源码等</p></li><li><p>内核默认使用的配置文件以及它存放的路径如下所示</p><p>[ o.k. ] Using kernel config file [ '''orangepi-build/external/config/kernel/linux-6.1-sun50iw9-next.configLICENSE''' ]: GPL 2许可证文件</p></li><li><p>编译生成的内核相关的deb包的路径</p><p>[ o.k. ] Target directory [ '''output/debs/''' ]</p></li><li><p>编译生成的内核镜像deb包的包名</p><p>[ oREADME.k. ] File name [ md'''linux: orangepi-image-next-sun50iw9_x.x.x_arm64.deb''' ]build说明文件</p></li><li><p>编译使用的时间</p><p>[ o.k. ] Runtime [ '''10 minscripts''' ]</p></li><li><p>最后会显示重复编译上一次选择的内核的编译命令，使用下面的命令无需通过图形界面选择，可以直接开始编译内核源码: 编译linux镜像的通用脚本</p><p>[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD{| class=orangepizero3 BRANCH=next BUILD_OPT=kernel KERNEL_CONFIGURE=no''' ]</p></li></ol></li><li><p>查看编译生成的内核相关的deb包</p><ol "wikitable" style="list-style-typewidth: lower-alpha800px;"><li><p>'''linux-dtb-next-sun50iw9_x.x.x_arm64.deb'''包含有内核使用的dtb文件</p></li><li><p>'''linux|-headers-next-sun50iw9_x.x.x_arm64.deb'''包含内核头文件</p></li><li><p>'''linux-image-next-sun50iw9_x.x.x_arm64.deb'''包含内核镜像和内核模块</p>| <p>test@test:~/orangepi-build$ '''ls output/debs/linux-*'''</p><p>output/debs/linux-dtb-next-sun50iw9_x.x.x_arm64.deb</p><p>output/debs/linux-headers-next-sun50iw9_x.x.x_arm64.deb</p><p>output/debs/linux-image-next-sun50iw9_x.x.x_arm64.deb</p></li></ol></li><li><p>orangepi-bulid编译系统编译linux内核源码时首先会将linux内核源码和github服务器的linux内核源码进行同步，所以如果想修改linux内核的源码，首先需要关闭源码的更新功能（'''需要完整编译过一次linux内核源码后才能关闭这个功能，否则会提示找不到linux内核的源码'''），否则所作的修改都会被还原，方法如下：</p><p>设置'''userpatches/config-defaultbuild.conf'''中的IGNORE_UPDATES变量为”yes”</p><p>test@test:~/orangepi-build$ '''vim userpatches/config-defaultsh external LICENSE README.conf'''</p><p>IGNORE_UPDATES=md "nbsp;scripts'''yes'''"</p></li><li><p>如果对内核做了修改，可以使用下面的方法来更新开发板linux系统的内核和内核模块</p>|}<ol {| class="wikitable" style="listbackground-style-typecolor:#ffffdc;width: lower-alpha800px;"><li><p>将编译好的linux内核的deb包上传到开发板的linux系统中</p>|-<p>test@test:~/orangepi-build$ '''cd output/debs'''</p>| <p>test@test:~/orangepi-build/output/debs$ '''scp \'''</pbig><p>'''linux如果是从github下载的orangepi-imagebuild的代码，下载完后你可能会发现orangepi-nextbuild中并没有包含u-sun50iw9_x.x.x_arm64.deb root@192.168.1.xxx:/root'''</p></li><li><p>再安装刚才上传的新的linux内核的deb包</p><p>orangepi@orangepi:~$ '''sudo dpkg boot和linux内核的源码，也没有编译u-i linuxboot和linux内核需要用到交叉编译工具链，这是正常的，因为这些东西都存放在其它单独的github仓库或者某些服务器上了（下文会详述其地址）。orangepi-imagebuild在脚本和配置文件中会指定u-nextboot、linux内核和交叉编译工具链的地址，运行orangepi-sun50iw9_x.x.x_arm64.debbuild时，当其发现本地没有这些东西，会自动去相应的地方下载的。'''</p></libig><li><p>然后重启开发板，再查看内核相关的修改是否已生效</p><p>orangepi@orangepi:~$ '''sudo''' '''reboot'''</p></li></ol>|}</li></ol>
== 编译rootfs = 下载交叉编译工具链 ===
<div class="figure">
[[File:media/image307zero3-img296.png|576x119px|选区_2411400px]]
</div>
<ol style="list-style-type: lower-alpha;">
<li><p>初始化Ubuntu PC的编译环境，安装编译过程需要的软件包linux5.4</p></li><li><p>下载u{| class="wikitable" style="width:800px;" |-boot和linux内核的源码（如果已经缓存，则只更新代码）</p></li><li>| <p>编译u'''gcc-arm-11.2-2022.02-boot源码，生成ux86_64-boot的deb包</p></li><li><p>编译linux源码，生成linux相关的deb包</p></li><li><p>制作linux firmware的deb包</p></li><li><p>制作orangepiaarch64-none-linux-config工具的deb包</p></li><li><p>制作板级支持的deb包</p></li><li><p>如果是编译desktop版镜像，还会制作desktop相关的deb包</p></li><li><p>检查rootfs是否已经缓存，如果没有缓存，则重新制作rootfs，如果已经缓存，则直接解压使用gnu'''</p></li><li><p>安装前面生成的deb包到rootfs中</p></li><li><p>对不同的开发板和不同类型镜像做一些特定的设置，如预装额外的软件包，修改系统配置等</p></li><li><p>然后制作镜像文件，并格式化分区，默认类型为ext4</p></li><li><p>再将配置好的rootfs拷贝到镜像的分区中</p></li><li><p>然后更新initramfs</p></li><li><p>最后将u-boot的bin文件通过dd命令写入到镜像中</p></li></ol>|}
</li>
<li><p>编译完镜像后会提示下面的信息linux6.1</p><ol {| class="wikitable" style="list-style-typewidth: lower-alpha800px;"><li><p>编译生成的镜像的存放路径</p>|-| <p>[ o.k. ] Done building [ '''output/images/orangepizero3_xgcc-arm-11.x2-2022.x_debian_bullseye_linux6.1.xx_xfce_desktop/orangepizero3_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop.img02-x86_64-aarch64-none-linux-gnu''' ]</p></li><li><p>编译使用的时间</p></li></ol>|}
</li></ol>
<p>编译H618 u-boot源码使用的交叉编译工具链为：</p>
<ol style="list-style-type: lower-alpha;">
<li><p>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像</p><p>[ ov2018.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''' ]05</p></li></ol> <span id="android-12-tv系统使用说明"></span> = '''Android 12 TV系统使用说明''' = <span id="已支持的android版本"></span>== 已支持的Android版本 == {| class="wikitable" style="width:800px;"
|-
| style="text<p>'''gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-align: left;"gnueabi'''</p>| Android版本}</li><li><p>v2021.07</p>{| class="wikitable" style="text-alignwidth: left800px;"| 内核版本
|-
| style="text-align: left;"| <p>'''Android 12 TV版'''| style="textgcc-arm-11.2-align: left;"| '''linux52022.402-x86_64-aarch64-none-linux-gnu'''</p>
|}
</li></ol>
|-
| style="text<p>https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-5.4-align: left;"sun50iw9'''</p>| HDMI视频}</li><li><p>b) Linux6.1</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| <p>https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-6.1-sun50iw9'''</p>|}</li></ol></li><li><p>u-boot源码存放的git仓库如下，注意切换u-boot-orangepi仓库的分支为</p><ol style="textlist-style-aligntype: leftnone;"| HDMI音频><li><p>a) v2018.05</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2018.05-align: left;"h618'''</p>| USB2}</li><li><p>b) v2021.0 x 307</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2021.07-sunxi'''|}</li></ol></li></ol></li></ol><ol start="2" style="textlist-style-aligntype: leftdecimal;"| TF卡启动><li><p>orangepi-build第一次运行的时候会去下载交叉编译工具链、u-boot和linux内核源码，成功编译完一次linux镜像后在orangepi-build中可以看到的文件和文件夹有</p>| <ol style="textlist-alignstyle-type: leftlower-alpha;"><li><p>'''build.sh''': 编译启动脚本</p></li><li><p>'''external''': 包含编译镜像需要用的配置文件、特定功能的脚本以及部分程序的源码，编译镜像过程中缓存的rootfs压缩包也存放在external中</p></li><li><p>'''kernel''': 存放linux内核的源码</p></li><li><p>'''LICENSE''': GPL 2许可证文件</p></li><li><p>'''README.md''': orangepi-build说明文件</p></li><li><p>'''output''': 存放编译生成的u-boot、linux等deb包、编译日志以及编译生成的镜像等文件</p></li><li><p>'''scripts''': 编译linux镜像的通用脚本</p></li><li><p>'''toolchains''': 存放交叉编译工具链</p></li><li><p>'''u-boot''': 存放u-boot的源码</p></li><li><p>'''userpatches''': 存放编译脚本需要用到的配置文件</p>{| OKclass="wikitable" style="width:800px;"
|-
| style="text<p>test@test:~/orangepi-build$ '''ls'''</p><p>'''build.sh external kernel LICENSE output README.md scripts toolchains u-align: leftboot "userpatches'''</p>| 网卡}</li></ol></li></ol>| == 编译u-boot == <ol style="textlist-style-aligntype: leftdecimal;"| OK>|-<li><p>运行build.sh脚本，记得加sudo权限</p>{| styleclass="text-align: left;wikitable"| 红外| style="text-alignwidth: left800px;"| OK
|-
| <p>test@test:~/orangepi-build$ '''sudo ./build.sh'''</p>|}</li><li><p>选择'''U-boot package'''，然后回车</p><div class="figure"> [[File:zero3-img297.png]] </div></li><li><p>接着选择开发板的型号</p><p>[[File:zero3-img298.png]]</p></li><li><p>然后选择u-boot的分支类型</p><ol style="textlist-style-aligntype: leftlower-alpha;"><li><p>current分支会编译linux5.4镜像需要使用的u-boot v2018.05版本的代码</p></li><li><p>next分支会编译linux6.1镜像需要使用的u-boot v2021.07版本的代码</p><p>[[File:zero3-img299.png]]</p></li></ol></li><li><p>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择</p><ol style="list-style-type: lower-alpha;"><li><p>如果购买的开发板为1.5GB内存大小的，请选择第一项</p></li><li><p>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项</p><p>[[File:zero3-img299-1.png| WIFI1000px]]</p></li></ol></li><li><p>然后就会开始编译u-boot，编译next分支时提示的部分信息说明如下所示：</p>| <ol style="textlist-alignstyle-type: leftlower-alpha;"><li><p>u-boot源码的版本</p>{| OKclass="wikitable" style="width:800px;"
|-
| style="text<p>[ o.k. ] Compiling u-align: left;"boot [ '''v2021.07''' ]</p>| WIFI hotsport}</li><li><p>交叉编译工具链的版本</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>[ o.k. ] Compiler version [ '''aarch64-linux-gnu-align: left;"gcc 11''' ]</p>| 蓝牙}</li><li><p>编译生成的u-boot deb包的路径</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>[ o.k. ] Target directory [ '''orangepi-build/output/debs/u-align: left;"boot''' ]</p>| BLE蓝牙}</li><li><p>编译生成的u-boot deb包的包名</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>[ o.k. ] File name [ '''linux-u-boot-next-align: left;"orangepizero3_x.x.x_arm64.deb''' ]</p>| 耳机音频}</li><li><p>编译使用的时间</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>[ o.k. ] Runtime [ '''1 min''' ]</p>|}</li><li><p>重复编译u-align: left;"| TVboot的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译u-OUTboot</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style<p>[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT="textu-align: left;"boot''' ]</p>| USB摄像头}</li></ol></li><li><p>查看编译生成的u-boot deb包</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>test@test:~/orangepi-build$ '''ls output/debs/u-boot/'''</p><p>'''linux-u-boot-next-align: left;"orangepizero3_x.x.x_arm64.deb'''</p>| LED灯}</li><li><p>orangepi-bulid编译系统编译u-boot源码时首先会将u-boot的源码和github服务器的u-boot源码进行同步，所以如果想修改u-boot的源码，首先需要关闭源码的下载更新功能（'''需要完整编译过一次u-boot后才能关闭这个功能，否则会提示找不到u-boot的源码'''），否则所作的修改都会被还原，方法如下：</p><p>设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| <p>test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''</p><p>......</p><p>IGNORE_UPDATES="'''<span style="textcolor:#FF0000">yes</span>'''"</p><p>......</p>|}</li><li><p>调试u-alignboot代码时，可以使用下面的方法来更新linux镜像中的u-boot进行测试</p><ol style="list-style-type: leftlower-alpha;"| 温度传感器><li><p>首先将编译好的u-boot的deb包上传到开发板的linux系统中</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>test@test:~/orangepi-build$ '''cd output/debs/u-boot'''</p><p>test@test:~/orangepi_build/output/debs/u-boot$ '''scp \'''</p><p>'''linux-u-boot-next-alignorangepizero3_x.x.x_arm64.deb root@192.168.1.xxx: left;"/root'''</p>| Mali GPU}</li><li><p>再安装刚才上传的新的u-boot的deb包</p>{| class="wikitable" style="text-alignwidth: left800px;"| OK
|-
| style="text<p>orangepi@orangepi:~$ '''sudo dpkg -i''' '''linux-u-boot-align: left;"| 视频编解码| style="textnext-align: left;"| OKorangepizero3_x.x.x_arm64.deb'''</p>
|}
</li><span id="板载led灯显示说明"li><p>然后运行 nand-sata-install脚本</spanp>== 板载LED灯显示说明 == {| class="wikitable" style="width:800px;"
|-
|| style="text-align: left;"| '''绿灯'''| style="text-align: left;"| '''红灯'''|-| '''u-boot启动阶段'''| style="text-align: left;"| '''灭'''| style="text-align<p>orangepi@orangepi: left;"| '''亮~$ '''|sudo nand-| '''内核启动到进入系统'''| style="textsata-align: left;"| '''亮'''| style="text-align: left;"| '''灭install'''</p>
|}
</li>
<li><p>然后选择'''5 Install/Update the bootloader on SD/eMMC'''</p>
<p>[[File:zero3-img300.png]]</p></li>
<li><p>按下回车键后首先会弹出一个'''Warning'''</p>
<p>[[File:zero3-img301.png]]</p></li>
<li><p>再按下回车键就会开始更新u-boot，更新完后会显示下面的信息</p>
<p>[[File:zero3-img302.png]]</p></li>
<li><p>然后就可以重启开发板来测试u-boot的修改是否生效了</p></li></ol>
</li></ol>
<ol style="list-style-type: decimal;">
<li><p>我们一般都是使用鼠标和键盘来控制开发板的安卓系统，当进入某些界面，需要返回上一级界面或者桌面时，只能通过运行'''鼠标右键build.sh'''来返回，键盘是无法返回的脚本，记得加sudo权限</p></li>{| class="wikitable" style="width:800px;" |-| <lip>test@test:~/orangepi-build$ '''sudo ./build.sh'''</p>如果有购买开发板配套的红外遥控（其他遥控不行）和扩展板，将扩展板插入开发板后，还可以通过遥控中的返回键来返回上一级菜单，返回键的位置如下图所示|}</pli><pli>[[File:media/image315.png|231x199px]]</p>选择'''Kernel package'''，然后回车</lip></oldiv class="figure">
</div></li><li><p>然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个</p><p>[[File:zero3-img304.png]]</p></li><li><p>接着选择开发板的型号</p><p>[[File:zero3-img298.png]]</p></li><li><p>然后选择内核源码的分支类型</p><ol style=== 使用网络连接adb调试 ==="list-style-type: lower-alpha;"><li><p>current分支会编译linux5.4内核源码</p></li><li><p>next分支会编译linux6.1内核源码</p><p>[[File:zero3-img299.png]]</p></li></ol></li><li><p>如果第3)步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码。</p><p>[[File:zero3-img305.png]]</p></li></ol>
<!-- --><ol style="list-style-type: lower-alpha;"><li><p>如果不需要修改内核的配置选项，在运行build.sh脚本时，传入'''使用网络adb无需USB Typc C接口的数据线来连接电脑和开发板，而是通过网络来通信，所以首先请确保开发板的有线或者无线网络已经连接好了，然后获取开发板的IP地址，后面要用到。KERNEL_CONFIGURE=no'''就可临时屏蔽弹出内核的配置界面了</p>{| class="wikitable" style="width:800px;" |-| <p>test@test:~/orangepi-build$ '''sudo ./build.sh KERNEL_CONFIGURE=no'''</p>|}</li><li><p>也可以设置orangepi-build/userpatches/config-default.conf配置文件中的'''KERNEL_CONFIGURE=no'''，这样可以永久禁用这个功能</p></li><li><p>编译内核的时候如果提示下面的错误，这是由于Ubuntu > PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu > PC的终端调到最大，然后重新运行build.sh脚本</p><p>[[File:zero3-img306.png]]</p></li></ol>
<!-- --><ol start="7" style="list-style-type: decimal;"><li><p>确保Android系统的'''service.adb.tcp.port'''设置为5555端口号编译next分支内核源码时提示的部分信息说明如下：</p><p>apollool style="list-style-p2type:/ # '''getprop | grep "lower-alpha;adb.tcp"'''</p><p>[service.adb.tcp.port]: [5555]</p></li"><li><p>如果'''service.adb.tcp.port'''没有设置，可以在串口中使用下面的命令设置网络adb的端口号linux内核源码的版本</p></li></ol> apollo-p2:/ # '''setprop service.adb.tcp.port 5555'''<br />apollo-p2:/ # '''stop adbd''' apollo-p2:/ # '''start adbd''' <ol start{| class="3wikitable" style="list-style-typewidth: decimal800px;"><li><p>在Ubuntu PC上安装adb工具</p>|-| <p>test@test:~$ [ o.k. ] Compiling current kernel [ '''sudo apt-get update6.1.31''']</p><p>test@test:~$ '''sudo apt-get install -y adb'''</p>|}</li><li><p>然后在Ubuntu PC上连接网络adb使用的交叉编译工具链的版本</p><p>test@test{| class="wikitable" style="width:~$ '''adb connect 192.168.1.xxx:5555''' '''(需要修改为开发板的IP地址)'''</p>800px;" <p>* daemon not running; starting now at tcp:5037</p>|-<p>* daemon started successfully</p>| <p>connected to 192[ o.168k.1.xxx:5555</p><p>test@test:~$ ] Compiler version [ '''adb devicesaarch64-linux-gnu-gcc 11''']</p><p>List of devices attached</p>|}<p>192.168.1.xxx:5555 device</p></li><li><p>然后在Ubuntu PC上通过adb shell就可以登录android系统内核默认使用的配置文件以及它存放的路径如下所示</p></li></ol> test@test:~$ '''adb shell''' apollo-p2:/ # {| class=== 使用数据线连接adb调试 === <ol "wikitable" style="list-style-typewidth: decimal800px;"><li><p>准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的电源接口中。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板</p><div class="figure"> [[File:media/image15.jpeg|172x172px|IMG_4194(20201104-125502)]]| </div></li><li><p>在Ubuntu PC上安装adb工具</p><p>test@test:~$ [ o.k. ] Using kernel config file [ '''sudo aptorangepi-get update'''<build/p><p>test@test:~$ '''sudo apt-get install -y adb'''<external/p><config/li><li><p>查看识别到ADB设备<kernel/p><p>test@test:~$ '''adb deviceslinux-6.1-sun50iw9-next.config''']</p><p>List of devices attached</p>|}<p>4c00146473c28651dd0 device</p></li><li><p>然后在Ubuntu PC上通过adb shell就可以登录android系统编译生成的内核相关的deb包的路径</p></li></ol> test@test:~$ '''adb shell''' apollo-p2:/ $ <span id{| class="查看设置hdmi显示分辨率的方法wikitable"></span>== 查看设置HDMI显示分辨率的方法 == <ol style="list-style-typewidth: decimal800px;"><li><p>首先进入'''Settings'''</p>|-| <p>[[File:media/image316o.k.png|234x83px]]</p></li><li><p>然后选择Target directory [ '''Device Preferencesoutput/debs/''']</p><p>[[File:media/image317.png|415x170px]]</p>}</li><li><p>然后选择'''Display & Sound'''编译生成的内核镜像deb包的包名</p><p>[[File{| class="wikitable" style="width:media/image318.png800px;" |420x133px]]</p></li>-<li><p>然后选择'''Advanced display settings'''</p>| <p>[[File:media/image319o.k.png|423x96px]]</p></li><li><p>然后选择File name [ '''HDMI outpu modelinux-image-next-sun50iw9_x.x.x_arm64.deb''']</p><p>[[File:media/image320.png|423x101px]]</p></li><li><p>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。</p>}<p>[[File:media/image321.png|429x136px]]</p></li><li><p>开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项编译使用的时间</p><p>[[File:media/image322.png{|429x242px]]</p></li></ol> <span idclass="hdmi转vga显示测试-1wikitable"></span>== HDMI转VGA显示测试 == <ol style="list-style-typewidth: decimal800px;"><li><p>首先需要准备下面的配件</p><ol style="list-style-type: lower|-alpha;"><li><p>HDMI转VGA转换器</p>| <p>[[File:media/image146o.png|155x104px]]</p></li><li><p>一根VGA线和一根Micro HDMI公转HDMI母转接线</p><p>[[File:media/image147k.png|148x133px]] Runtime [[File:media/image148.jpeg|157x139px|IMG_6140(20220104-134930)]'''10 min''' ]</p></li><li><p>一个支持VGA接口的显示器或者电视</p></li></ol>|}
</li>
<li><p>HDMI转VGA显示测试如下所示最后会显示重复编译上一次选择的内核的编译命令，使用下面的命令无需通过图形界面选择，可以直接开始编译内核源码</p>{| class="wikitable" style="width:800px;" |-| <p>[[File:media/image323o.k.png|576x330px]]</p><p>Repeat Build Options [ '''使用HDMI转VGA显示时，开发板以及开发板的Android系统是不需要做任何设置的，只需要开发板Micro HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。sudo ./build.sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=kernel KERNEL_CONFIGURE=no''']</p>|}</li></ol></li><span id="wi-fi的连接方法"li><p>查看编译生成的内核相关的deb包</spanp>== WI-FI的连接方法 == <ol style="list-style-type: decimallower-alpha;"><li><p>首先选择'''Settingslinux-dtb-next-sun50iw9_x.x.x_arm64.deb'''包含有内核使用的dtb文件</p></li><li><p>[[File:media/image316'''linux-headers-next-sun50iw9_x.x.x_arm64.png|234x83px]]deb'''包含内核头文件</p></li><li><p>然后选择'''Network &linux-image-next-sun50iw9_x.x.x_arm64.deb'''包含内核镜像和内核模块</p>{| class="wikitable" style="width:800px; Internet" |-| <p>test@test:~/orangepi-build$ '''ls output/debs/linux-*'''</p><p>[[File:mediaoutput/debs/linux-dtb-next-sun50iw9_x.x.x_arm64.deb</p><p>output/debs/linux-headers-next-sun50iw9_x.x.x_arm64.deb</p><p>output/debs/image324linux-image-next-sun50iw9_x.pngx.x_arm64.deb</p>|373x103px]]}</li></pol></li><li><p>然后打开WIorangepi-FIbulid编译系统编译linux内核源码时首先会将linux内核源码和github服务器的linux内核源码进行同步，所以如果想修改linux内核的源码，首先需要关闭源码的更新功能（'''需要完整编译过一次linux内核源码后才能关闭这个功能，否则会提示找不到linux内核的源码'''），否则所作的修改都会被还原，方法如下：</p><p>[[File设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”</p>{| class="wikitable" style="width:800px;" |-| <p>test@test:media~/image325orangepi-build$ '''vim userpatches/config-default.pngconf'''</p><p>IGNORE_UPDATES="'''<span style="color:#FF0000">yes</span>'''"</p>|381x50px]]}</li><li><p>如果对内核做了修改，可以使用下面的方法来更新开发板linux系统的内核和内核模块</lip><ol style="list-style-type: lower-alpha;"><li><p>打开WI将编译好的linux内核的deb包上传到开发板的linux系统中</p>{| class="wikitable" style="width:800px;" |-FI后在| <p>test@test:~/orangepi-build$ '''Available networkscd output/debs'''下面就可以看到搜索到的信号</p><p>[[Filetest@test:media~/orangepi-build/output/debs$ '''scp \'''</image326p><p>'''linux-image-next-sun50iw9_x.png|381x187px]]x.x_arm64.deb root@192.168.1.xxx:/root'''</p>|}</li><li><p>选择想连接的WI再安装刚才上传的新的linux内核的deb包</p>{| class="wikitable" style="width:800px;" |-| <p>orangepi@orangepi:~$ '''sudo dpkg -i linux-image-next-FI后会弹出下图所示的密码输入界面sun50iw9_x.x.x_arm64.deb'''</p>|}<div /li><li><p>然后重启开发板，再查看内核相关的修改是否已生效</p>{| class="figurewikitable" style="width:800px;"|-| <p>orangepi@orangepi:~$ '''sudo''' '''reboot'''</p>|}</li></ol></li></ol>
</div></liol style="list-style-type: decimal;"><li><p>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了运行build.sh脚本，记得加sudo权限</p>{| class="wikitable" style="width:800px;" |-| <p>[[Filetest@test:media~/orangepi-build$ '''sudo ./image328build.png|388x160px]]sh'''</p>|}</li><li><p>WI-FI连接成功后的显示如下图所示</p><p>[[File:media/image329.png|402x141px]]选择'''Rootfs and all deb packages'''，然后回车</p></li></ol>
<span iddiv class="wi-fi-hotspot的使用方法figure"></span>== WI-FI hotspot的使用方法 ==
<span id/div></ol><ol start="3" style="查看以太网口ip地址的方法list-style-type: decimal;"><li><p>接着选择开发板的型号</p><p>[[File:zero3-img298.png]]</p></li><li><p>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别</spanp><ol style="list-style-type: lower-alpha;"><li><p>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</p></li><li><p>next分支可以看到debian11、debian12、ubuntu22.04三个选项</p><p>[[File:zero3-img299.png]]</p></li></ol></li><li><p>然后选择rootfs的类型</p><p>[[File:zero3-img308.png]]</p></li><li><p>然后选择镜像的类型</p><ol style= 查看以太网口IP地址的方法 ="list-style-type: lower-alpha;"><li><p>'''Image with console interface (server)'''表示服务器版的镜像，体积比较小</p></li><li><p>'''Image with desktop environment'''表示带桌面的镜像，体积比较大</p><div class="figure">
</div></li></ol></li><li><p>如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（'''没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了'''）</p><div class== 蓝牙的连接方法 =="figure">
<span id/div></li><li><p>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面</p><p>[[File:zero3-img311.png]]</p><p>[[File:zero3-img312.png]]</p><p>然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。</p><p>[[File:zero3-img313.png]]</p></li><li><p>然后就会开始编译rootfs，编译时提示的部分信息说明如下</p><ol style="list-style-type: lower-alpha;"><li><p>rootfs的类型</p>{| class="wikitable" style="width:800px;" |-| <p>[ o.k. ] local not found [ Creating new rootfs cache for '''bullseye''' ]</p>|}</li><li><p>编译生成的rootfs压缩包的存放路径</p>{| class="wikitable" style="width:800px;" |-| <p>[ o.k. ] Target directory [ '''orangepi-build/external/cache/rootfs''' ]</p>|}</li><li><p>编译生成的rootfs压缩包的名字</p>{| class="wikitable" style="width:800px;" |-| <p>[ o.k. ] File name [ '''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4''' ]</p>|}</li></ol></li><li><p>查看编译生成的rootfs压缩包</p><ol style="list-style-type: lower-alpha;"><li><p>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4'''是rootfs的压缩包，名字各字段的含义为</p><ol style="list-style-type: none;"><li><p>a) '''bullseye'''表示rootfs的linux发行版的类型</p></li><li><p>b) '''xfce'''表示rootfs为桌面版的类型，如果为'''cli'''则表示服务器版类型</p></li><li><p>c) '''arm64'''表示rootfs的架构类型</p></li><li><p>d) '''25250ec7002de9e81a41de169f1f89721'''是由rootfs安装的所有软件包的包名生成的MD5哈希值，只要没有修改rootfs安装的软件包的列表，那么这个值就不会变，编译脚本会通过这个MD5哈希值来判断是否需要重新编译rootfs</p></li></ol></li><li><p>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list'''列出了rootfs安装的所有软件包的包名</p>{| class="usb摄像头使用方法wikitable"style="width:800px;" |-| <p>test@test:~/orangepi-build$ '''ls external/cache/rootfs/'''</p><p>bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4</p><p>bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.current</p><p>bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list</spanp>|}</li></ol></li><li><p>如果需要的rootfs在'''external/cache/rootfs'''下已经存在，那么再次编译rootfs就会直接跳过编译过程，不会重新开始编译，编译镜像的时候也会去'''external/cache/rootfs'''下查找是否已经有缓存可用的rootfs，如果有就直接使用，这样可以节省大量的下载编译时间</p></li></ol> == USB摄像头使用方法 编译linux镜像 ==
<ol style="list-style-type: decimal;">
<li><p>首先在开发板的USB接口中插入USB（UVC协议）摄像头</p></li><li><p>USB摄像头如果识别正常，在/dev下会生成相应的video设备节点</p><p>console:/ # 运行'''ls /dev/video0build.sh'''脚本，记得加sudo权限</p><p>/dev/video0</p></li><li><p>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l{|'''ADB的使用方法''']]一小节的说明</p></li><li><p>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP</p>class="wikitable" style="width:800px;" <p>[[File:media/image346.png|576x172px]]</p>-<p>[[File:media/image347.png|575x145px]]</p></li><li><p>然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装</p><p>test@test:~/orangepi-build$ '''adb install usbcamerasudo .apk/build.sh'''</p></li><li><p>安装完后在Android的桌面可以看到USB摄像头的启动图标</p>|}<p>[[File:media/image348.png|576x132px]]</p></li><li><p>然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了选择'''Full OS image for flashing'''，然后回车</p></li></ol>
<span iddiv class="android系统root说明figure"></span>== Android系统ROOT说明 ==
</div></ol ><ol start="3" style="list-style-type: decimal;"><li><p>在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''然后选择开发板的型号</p><p>[[File:media/image346zero3-img298.png|576x172px]]</p></li><li><p>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别</p>[[File<ol style="list-style-type:media/image349lower-alpha;"><li><p>current分支可以看到debian11、ubuntu20.04、ubuntu22.png|575x124px]]04三个选项</p></li><li><p>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考next分支可以看到debian11、debian12、ubuntu22.04三个选项</p><p>[[\l|'''ADB的使用方法'''File:zero3-img299.png]]一小节的说明</p></li></ol></li><li><p>然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择</p><ol style="list-style-type: lower-alpha;"><li><p>test@test:~$ '''adb install rootcheck如果购买的开发板为1.apk'''5GB内存大小的，请选择第一项</p></li><li><p>安装完后在Android的桌面可以看到ROOT测试工具的启动图标如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项</p><p>[[File:media/image350zero3-img299-1.png|575x119px]]</p></li></ol></li><li><p>第一次打开'''ROOT测试工具'''后的显示界面如下图所示然后选择rootfs的类型</p><p>[[File:media/image351zero3-img308.png|575x162px]]</p></li><li><p>然后就可以点击然后选择镜像的类型</p><ol style="list-style-type: lower-alpha;"><li><p>'''CHECK NOWImage with console interface (server)'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限表示服务器版的镜像，体积比较小</p></li><pli>[[File:media/image352.png|575x161px]]</p>'''Image with desktop environment'''表示带桌面的镜像，体积比较大</lip></oldiv class="figure">
<div class="figure">
[[File:media/image354zero3-img310.png|420x236px|Screenshot_20230625-193535]]
</div></li><li><p>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能</p><p>[[File:media/image355.png|167x266px]]</p></li><li><p>等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可</p><p>[[File:media/image356.png|146x308px]]</p></li><li><p>然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可</p><p>[[File:media/image357.png|468x265px]]</p></li><li><p>然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了</p><p>[[File:media/image358.png|576x352px]]</p></li></ol>
<span id!-- --><ol start="pin8" style="list-style-接口type: decimal;"><li><p>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面</p><p>[[File:zero3-gpiouartspiimg311.png]]</p><p>[[File:zero3-测试"img312.png]]</p><p>然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。</spanp>== 26pin 接口 GPIO、UART、SPI 测试 ==<p>[[File:zero3-img313.png]]</p></li></ol>
<span id!-- --><ol start="pin的gpio口测试方法9"style="list-style-type: decimal;"><li><p>然后就会开始编译linux镜像，编译的大致流程如下</spanp>=== 26pin的GPIO口测试方法 === <ol style="list-style-type: decimallower-alpha;"><li><p>首先在桌面中打开wiringOP APP初始化Ubuntu PC的编译环境，安装编译过程需要的软件包</p></li><li><p>下载u-boot和linux内核的源码（如果已经缓存，则只更新代码）</p></li><li><p>编译u-boot源码，生成u-boot的deb包</p></li><li><p>编译linux源码，生成linux相关的deb包</p></li><li><p>[[File:media制作linux firmware的deb包</p></li><li><p>制作orangepi-config工具的deb包</p></li><li><p>制作板级支持的deb包</p></li><li><p>如果是编译desktop版镜像，还会制作desktop相关的deb包</p></li><li><p>检查rootfs是否已经缓存，如果没有缓存，则重新制作rootfs，如果已经缓存，则直接解压使用</p></li><li><p>安装前面生成的deb包到rootfs中</p></li><li><p>对不同的开发板和不同类型镜像做一些特定的设置，如预装额外的软件包，修改系统配置等</p></image359.png|576x133px]]li><li><p>然后制作镜像文件，并格式化分区，默认类型为ext4</p></li><li><p>然后点击'''GPIO_TEST'''按钮打开GPIO测试界面再将配置好的rootfs拷贝到镜像的分区中</p></li><li><p>然后更新initramfs</p>[[File:media</image360.png|413x77px]]li><li><p>最后将u-boot的bin文件通过dd命令写入到镜像中</p></li></ol></li><li><p>编译完镜像后会提示下面的信息</p><ol style="list-style-type: lower-alpha;"><li><p>GPIO测试界面如下图所示，左边的两排编译生成的镜像的存放路径</p>{| class="wikitable" style="width:800px;" |-| <p>[ o.k. ] Done building [ '''CheckBoxoutput/images/orangepizero3_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop/orangepizero3_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop.img'''按钮跟26pin引脚（'''左下角的PC1]</p>|}</PI16li><li><p>编译使用的时间</PI6p></PH10是13pin引脚中的GPIO口li>{| class="wikitable" style="width:800px;" |-| '''）是一一对应的关系。当勾选[ o.k. ] Runtime [ 19 min ]'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平设置为低电平；当点击右边的'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息。|}<li><p>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像</p>{| class="wikitable" style="width:800px;" |-| <p>[o.k. ] Repeat Build Options [File:media'''sudo ./image361build.png|425x236px]sh BOARD=orangepizero3 BRANCH=next BUILD_OPT=image RELEASE=bullseye BUILD_MINIMAL=no BUILD_DESKTOP=no KERNEL_CONFIGURE=yes''' ]</p>|}</li></ol></li><p>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：</pol><div classspan id="figureandroid-12-tv系统使用说明"></span>
</div></li><li><p>开发板26pin中总共有17个GPIO口可以使用（'''如果加上13pin中的4个GPIO口，那么总共就是有21个'''），下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平。首先点击7号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，7号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功</p><p>[[File:media/image363.png|432x210px]]</p></li><lispan id="已支持的android版本"><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为'''OUT'''，引脚电平为高电平</pspan><p>[[File:media/image364.png|430x207px]]</p></li><li><p>再次点击下图的'''CheckBox'''按钮取消勾选状态，7号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功</p><p>[[File:media/image365.png|434x212px]]</p></li><li><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为OUT，引脚电平为低电平</p><p>[[File:media/image366.png|438x217px]]</p></li></ol>== 已支持的Android版本 ==
<ol stylespan id="listandroid-style12-type: decimal;tv功能适配情况"><li><p>Android中默认打开了'''UART5'''，对应的设备节点为'''/dev/ttyAS5'''</p><p>apollo-p2:/ # '''ls /dev/ttyAS5'''</p><p>/dev/ttyAS5</p></li><li><p>首先在桌面中打开wiringOP APP</p><p>[[File:media/image359.png|576x133px]]</p></li><li><p>然后点击'''UART_TEST'''按钮打开UART测试界面</p><p>[[File:media/image367.png|505x94px]]</p></li><li><p>wiringOP的串口测试界面如下图所示</p></li></olspan>
|-
|style="text-align: left;"| 网卡| style="text-align: left;"| uart5OK
|-
| tx引脚style="text-align: left;"| 红外| style="text-align: left;"| 对应26pin的8号引脚OK
|-
| rx引脚style="text-align: left;"| WIFI| style="text-align: left;"| 对应26pin的10号引脚OK|}-| style="text-align: left;"| WIFI hotsport<ol start| style="8text-align: left;" | OK|-| style="listtext-align: left;"| 蓝牙| style="text-typealign: decimalleft;">| OK<li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li></ol>|-| style="text-align: left;"| BLE蓝牙[[File| style="text-align:media/image371.pngleft;"|376x189px]]OK|-<ol start| style="9text-align: left;" | 耳机音频| style="listtext-align: left;"| OK|-| style="text-align: left;"| TV-OUT| style="text-typealign: decimalleft;">| OK<li>如果一切正常，接收框内会显示已接收到的字符串</li></ol>|-| style="text-align: left;"| USB摄像头[[File| style="text-align:media/image372.pngleft;"|382x196px]]OK|-<span id| style="pin的spi测试方法text-align: left;"></span>| LED灯| style="text-align: left;"| OK|-| style="text-align: left;"| 温度传感器| style= 26pin的SPI测试方法 ==="text-align: left;"| OK|-<ol | style="listtext-align: left;"| Mali GPU| style="text-typealign: decimalleft;">| OK|-<li><p>26pin中可以用的SPI为SPI1，对应的设备节点为'''/dev/spidev1.1'''</p>| style="text-align: left;"| 视频编解码<p>[[File| style="text-align:media/image359.pngleft;"|576x133px]]</p></li>OK<li><p>这里演示下通过'''w25q64'''模块来测试SPI1接口，首先在SPI1接口接入w25q64模块</p></li></ol>|}
<ol startspan id="7android返回上一级界面的方法" style="list-style-type: decimal;"><li><p>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮</p><p>[[File:media/image376.png|294x169px]]</p></li><li><p>最后APP会显示读取到的板载SPI Flash的ID信息</p></li></olspan>
<ol start="9" style="list-style-type: decimal;"><li><p>如果是读取接在26pin SPI1上的w25q64模块，那么读取到的ID信息如下图所示我们一般都是使用鼠标和键盘来控制开发板的安卓系统，当进入某些界面，需要返回上一级界面或者桌面时，只能通过'''</pspan style="color:#FF0000">鼠标右键<p/span>[[File:media/image378.png|302x201px]]'''来返回，键盘是无法返回的</p></li><li><p>w25q64模块的MANUFACTURER ID为EFh，Device ID为4017h，跟上面读取到的值是对应的（h代表是16进制）如果有购买开发板配套的红外遥控（其他遥控不行）和扩展板，将扩展板插入开发板后，还可以通过遥控中的返回键来返回上一级菜单，返回键的位置如下图所示</p><p>[[File:media/image379zero3-img315.png|336x113px]]</p></li></ol>
<span id="pin的i2c测试方法adb的使用方法"></span>=== 26pin的I2C测试方法 ===
<ol style="list-style-type: decimal;"><li><p>确保Android系统的'''service.adb.tcp.port'''设置为5555端口号</p>{| class="wikitable" style="width:800px;"
|-
| style="text<p>apollo-alignp2: left/ # '''getprop | grep ""adb.tcp"'''</p><p>[service.adb.tcp.port]: [5555]</p>| }</li><li><p>如果'''RTC模块的引脚service.adb.tcp.port'''没有设置，可以在串口中使用下面的命令设置网络adb的端口号</p> {| class="wikitable" style="text-alignwidth: left800px;"| '''开发板26pin对应的引脚'''
|-
| style="textapollo-p2:/ # '''setprop service.adb.tcp.port 5555''' apollo-p2:/ # '''stop adbd''' apollo-alignp2: left;"| / # '''5Vstart adbd'''| }</li></ol><ol start="3" style="textlist-alignstyle-type: leftdecimal;"><li><p>在Ubuntu PC上安装adb工具</p>{| '''2号引脚'''class="wikitable" style="width:800px;"
|-
| style="text<p>test@test:~$ '''sudo apt-alignget update'''</p><p>test@test: left;"| ~$ '''GNDsudo apt-get install -y adb'''</p>|}</li><li><p>然后在Ubuntu PC上连接网络adb</p>{| class="wikitable" style="text-alignwidth: left800px;"| '''6号引脚'''
|-
| style="text-align<p>test@test: left;"| ~$ '''SDAadb connect 192.168.1.xxx:5555'''| style="text-align: left;"| '''3号引脚(需要修改为开发板的IP地址)'''</p>|-| style="text-align<p>* daemon not running; starting now at tcp: left;"| '''SCL'''5037</p>| style="text-align<p>* daemon started successfully</p><p>connected to 192.168.1.xxx:5555</p> <p>test@test: left;"| ~$ '''5号引脚adb devices'''|}</p><ol start="6" style="list-style-type: decimal;"p>List of devices attached</p><lip>192.168.1.xxx:5555 device</p>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 3'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如下图所示，如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。|}</pli><li><p>apollo-p2:/ # '''i2cdetect -y 3'''然后在Ubuntu PC上通过adb shell就可以登录android系统</p><p>[[File{| class="wikitable" style="width:media/image382.png800px;" |-|424x186px]]</p></li><li><p>然后在wiringOP中设置i2c的地址为0x68，再点击test@test:~$ '''OPENadb shell'''按钮打开i2c3</p><p>[[Fileapollo-p2:media/image383.png#|354x177px]]}</pli></liol> === 使用数据线连接adb调试 === <ol style="list-style-type: decimal;"><li><p>点击'''OPEN'''按钮打开i2c3后的显示如下所示：准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的电源接口中。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板</p><pdiv class="figure"> [[File:media/image384zero3-img15.png|355x171px]] </pdiv></li><li><p>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55在Ubuntu PC上安装adb工具</p><ol {| class="wikitable" style="list-style-typewidth: lower-alpha800px;"><li>|-| <p>我们首先设置需要写入的寄存器的地址为0x1ctest@test:~$ '''sudo apt-get update'''</p><p>[[Filetest@test:media/image385.png|322x152px]]~$ '''sudo apt-get install -y adb'''</p>|}</li><li><p>然后设置需要写入的值为0x55查看识别到ADB设备</p>{| class="wikitable" style="width:800px;" |-| <p>[[File:mediatest@test:~$ '''adb devices'''</image386.png|315x177px]]p></p>List of devices attached</lip><li><p>然后点击'''WRITE BYTE'''按钮执行写入的动作4c00146473c28651dd0 device</p><p>[[File:media/image387.png|314x173px]]</p></li></ol>|}</li><li><p>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过然后在Ubuntu PC上通过adb shell就可以登录android系统</p><p>[[File{| class="wikitable" style="width:media/image388.png800px;" |316x170px]]</p></li></ol>-| = test@test:~$ '''附录adb shell''' apollo-p2:/ $|}</li></ol><span id="查看设置hdmi显示分辨率的方法"></span> == 用户手册更新历史 查看设置HDMI显示分辨率的方法 == <ol style="list-style-type: decimal;"><li><p>首先进入'''Settings'''</p><p>[[File:zero3-img316.png]]</p></li><li><p>然后选择'''Device Preferences'''</p><p>[[File:zero3-img317.png]]</p></li><li><p>然后选择'''Display & Sound'''</p><p>[[File:zero3-img318.png]]</p></li><li><p>然后选择'''Advanced display settings'''</p><p>[[File:zero3-img319.png]]</p></li><li><p>然后选择'''HDMI output mode'''</p><p>[[File:zero3-img320.png]]</p></li><li><p>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。</p><p>[[File:zero3-img321.png]]</p></li><li><p>开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项</p><p>[[File:zero3-img322.png]]</p></li></ol> <span id="hdmi转vga显示测试-1"></span> == HDMI转VGA显示测试 == <ol style="list-style-type: decimal;"><li><p>首先需要准备下面的配件</p><ol style="list-style-type: lower-alpha;"><li><p>HDMI转VGA转换器</p><p>[[File:zero3-img146.png]]</p></li><li><p>一根VGA线和一根Micro HDMI公转HDMI母转接线</p><p>[[File:zero3-img147.png]] [[File:zero3-img148.png]]</p></li><li><p>一个支持VGA接口的显示器或者电视</p></li></ol></li><li><p>HDMI转VGA显示测试如下所示</p><p>[[File:zero3-img323.png]]</p>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big><p>'''使用HDMI转VGA显示时，开发板以及开发板的Android系统是不需要做任何设置的，只需要开发板Micro HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</p></big>|}</li></ol> <span id="wi-fi的连接方法"></span> == WI-FI的连接方法 == <ol style="list-style-type: decimal;"><li><p>首先选择'''Settings'''</p><p>[[File:zero3-img316.png]]</p></li><li><p>然后选择'''Network & Internet'''</p><p>[[File:zero3-img324.png]]</p></li><li><p>然后打开WI-FI</p><p>[[File:zero3-img325.png]]</p></li><li><p>打开WI-FI后在'''Available networks'''下面就可以看到搜索到的信号</p><p>[[File:zero3-img326.png]]</p></li><li><p>选择想连接的WI-FI后会弹出下图所示的密码输入界面</p><div class="figure"> [[File:zero3-img327.png]] </div></li><li><p>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了</p><p>[[File:zero3-img328.png]]</p></li><li><p>WI-FI连接成功后的显示如下图所示</p><p>[[File:zero3-img329.png]]</p></li></ol> <span id="wi-fi-hotspot的使用方法"></span>== WI-FI hotspot的使用方法 == <ol style="list-style-type: decimal;"><li><p>首先请确保以太网口已连接网线，并且能正常上网</p></li><li><p>然后选择'''Settings'''</p><p>[[File:zero3-img316.png]]</p></li><li><p>然后选择'''Network & Internet'''</p><p>[[File:zero3-img324.png]]</p></li><li><p>然后选择'''WIFI hotspot'''</p><p>[[File:zero3-img330.png]]</p></li><li><p>然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）</p><p>[[File:zero3-img331.png]]</p></li><li><p>此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password'''下面可以看到</p><p>[[File:zero3-img332.png]]</p></li><li><p>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot'''能正常使用</p><p>[[File:zero3-img333.png]]</p></li></ol> <span id="查看以太网口ip地址的方法"></span>== 查看以太网口IP地址的方法 == <ol style="list-style-type: decimal;"><li><p>首先请确保开发板的千兆网口连接到了路由器或者交换机</p></li><li><p>然后打开'''Settings'''</p><p>[[File:zero3-img334.png]]</p></li><li><p>然后选择'''Network & Internet'''</p><p>[[File:zero3-img335.png]]</p></li><li><p>然后在下图所示的位置就能看到开发板有线网口的IP地址了</p><p>[[File:zero3-img336.png]]</p></li></ol> == 蓝牙的连接方法 == <ol style="list-style-type: decimal;"><li><p>首先选择'''Settings'''</p><p>[[File:zero3-img316.png]]</p></li><li><p>然后选择'''Bluetooth'''</p><p>[[File:zero3-img337.png]]</p></li><li><p>然后打开'''Bluetooth Enable'''</p><p>[[File:zero3-img338.png]]</p></li><li><p>然后点击'''Pair new device'''开始扫描周围的蓝牙设备</p><p>[[File:zero3-img339.png]]</p></li><li><p>搜索到的蓝牙设备会在'''Available devices'''下面显示出来</p><p>[[File:zero3-img340.png]]</p></li><li><p>然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项</p><p>[[File:zero3-img341.png]]</p></li><li><p>这里测试的是开发板和'''<span style="color:#FF0000">安卓手机</span>'''蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程</p><p>[[File:zero3-img342.png]]</p></li><li><p>配对完成后，再打开'''Paired devices'''下面就可以看到已配对的蓝牙设备</p><p>[[File:zero3-img343.png]]</p></li><li><p>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了</p><p>[[File:zero3-img344.png]]</p></li><li><p>开发板Android系统蓝牙接收到的图片可以打开'''Received files'''中查看</p><p>[[File:zero3-img345.png]]</p></li></ol> <span id="usb摄像头使用方法"></span> == USB摄像头使用方法 == <ol style="list-style-type: decimal;"><li><p>首先在开发板的USB接口中插入USB（UVC协议）摄像头</p></li><li><p>USB摄像头如果识别正常，在/dev下会生成相应的video设备节点</p>{| class="wikitable" style="width:800px;" |-| <p>console:/ # '''ls /dev/video0'''</p><p>/dev/video0</p>|}</li><li><p>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[Orange Pi Zero 3#ADB的使用方法|'''ADB的使用方法''']]一小节的说明</p></li><li><p>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP</p><p>[[File:zero3-img346.png]]</p><p>[[File:zero3-img347.png]]</p></li><li><p>然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装</p>{| class="wikitable" style="width:800px;" |-| <p>test@test:~$ '''adb install usbcamera.apk'''</p>|}</li><li><p>安装完后在Android的桌面可以看到USB摄像头的启动图标</p><p>[[File:zero3-img348.png]]</p></li><li><p>然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了</p></li></ol> <span id="android系统root说明"></span> == Android系统ROOT说明 == {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''<span class="mark">Orange Pi发布的Android系统已经ROOT，可以使用下面的方法来测试。</span>'''</big>|} <ol style="list-style-type: decimal;"><li><p>在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''</p><p>[[File:zero3-img346.png]]</p><p>[[File:zero3-img349.png]]</p></li><li><p>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l|'''ADB的使用方法''']]一小节的说明</p></li><li><p>然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装</p>{| class="wikitable" style="width:800px;" |-| <p>test@test:~$ '''adb install rootcheck.apk'''</p>|}</li><li><p>安装完后在Android的桌面可以看到ROOT测试工具的启动图标</p><p>[[File:zero3-img350.png]]</p></li><li><p>第一次打开'''ROOT测试工具'''后的显示界面如下图所示</p><p>[[File:zero3-img351.png]]</p></li><li><p>然后就可以点击'''CHECK NOW'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限</p><p>[[File:zero3-img352.png]]</p></li></ol> <span id="使用miracastreceiver将手机屏幕投屏到开发板的方法"></span> == 使用MiracastReceiver将手机屏幕投屏到开发板的方法 == <ol style="list-style-type: decimal;"><li><p>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[Orange Pi Zero 3#WI-FI的连接方法|'''WI-FI的连接方法''']]一小节的说明</p></li><li><p>然后打开开发板安卓系统中的'''MiracastReceiver'''应用</p><p>[[File:zero3-img353.png]]</p></li><li><p>'''MiracastReceiver'''打开后的界面如下所示</p><div class="figure"> [[File:zero3-img354.png]] </div></li><li><p>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能</p><p>[[File:zero3-img355.png]]</p></li><li><p>等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可</p><p>[[File:zero3-img356.png]]</p></li><li><p>然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可</p><p>[[File:zero3-img357.png]]</p></li><li><p>然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了</p><p>[[File:zero3-img358-1.png]]</p></li></ol> <span id="pin-接口-gpiouartspi-测试"></span> == 26pin 接口 GPIO、UART、SPI 测试 == <span id="pin的gpio口测试方法"></span>=== 26pin的GPIO口测试方法 === <ol style="list-style-type: decimal;"><li><p>首先在桌面中打开wiringOP APP</p><p>[[File:zero3-img359.png]]</p></li><li><p>然后点击'''GPIO_TEST'''按钮打开GPIO测试界面</p><p>[[File:zero3-img360.png]]</p></li><li><p>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮跟26pin引脚（'''左下角的PC1/PI16/PI6/PH10是13pin引脚中的GPIO口'''）是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平设置为低电平；当点击右边的'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息。</p><p>[[File:zero3-img361.png]]</p></li><li><p>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：</p><div class="figure"> [[File:zero3-img362.png]] </div></li><li><p>开发板26pin中总共有17个GPIO口可以使用（'''如果加上13pin中的4个GPIO口，那么总共就是有21个'''），下面以7号引脚——对应GPIO为PC9 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平。首先点击7号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，7号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功</p><p>[[File:zero3-img363.png]]</p></li><li><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为'''OUT'''，引脚电平为高电平</p><p>[[File:zero3-img364.png]]</p></li><li><p>再次点击下图的'''CheckBox'''按钮取消勾选状态，7号引脚会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功</p><p>[[File:zero3-img365.png]]</p></li><li><p>然后点击'''GPIO READALL'''按钮，可以看到当前的7号引脚模式为OUT，引脚电平为低电平</p><p>[[File:zero3-img366.png]]</p></li></ol> <span id="pin的uart测试方法"></span>=== 26pin的UART测试方法 === <ol style="list-style-type: decimal;"><li><p>Android中默认打开了'''UART5'''，对应的设备节点为'''/dev/ttyAS5'''</p>{| class="wikitable" style="width:800px;" |-| <p>apollo-p2:/ # '''ls /dev/ttyAS5'''</p><p>/dev/ttyAS5</p>|}</li><li><p>首先在桌面中打开wiringOP APP</p><p>[[File:zero3-img359.png]]</p></li><li><p>然后点击'''UART_TEST'''按钮打开UART测试界面</p><p>[[File:zero3-img367.png]]</p></li><li><p>wiringOP的串口测试界面如下图所示</p></li> [[File:zero3-img368.png]]</ol><ol start="5" style="list-style-type: decimal;"><li><p>然后在选择框中选择'''/dev/ttyAS5'''节点</p><p>[[File:zero3-img369.png]]</p></li><li><p>再在编辑框中输入想要设置的波特率，然后点击'''OPEN'''按钮打开'''/dev/ttyAS5'''节点，打开成功后，'''OPEN'''按钮变为不可选中状态，'''CLOSE'''按钮和'''SEND'''按钮变为可选中状态</p></li> [[File:zero3-img370.png]]</ol><ol start="7" style="list-style-type: decimal;"><li>然后使用杜邦线短接uart5的rx和tx引脚</li> {| class="wikitable" style="width:600px;" |-|| style="text-align: left;"| uart5|-| tx引脚| style="text-align: left;"| 对应26pin的8号引脚|-| rx引脚| style="text-align: left;"| 对应26pin的10号引脚|}</ol><ol start="8" style="list-style-type: decimal;"><li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li> [[File:zero3-img371.png]]</ol><ol start="9" style="list-style-type: decimal;"><li>如果一切正常，接收框内会显示已接收到的字符串</li> [[File:zero3-img372.png]]</ol><span id="pin的spi测试方法"></span> === 26pin的SPI测试方法 === <ol style="list-style-type: decimal;"><li><p>26pin中可以用的SPI为SPI1，对应的设备节点为'''/dev/spidev1.1'''</p><p>[[File:zero3-img359.png]]</p></li><li><p>这里演示下通过'''w25q64'''模块来测试SPI1接口，首先在SPI1接口接入w25q64模块</p> {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''如果没有 w25q64 模块也没关系，因为开发板上有一个SPIFlash接在了SPI0上，在安卓中SPI0的配置默认也打开了，所以我们也可以直接使用板载的SPIFlash测试。'''</big>|}</li></ol><ol start="3" style="list-style-type: decimal;"><li><p>然后在桌面中打开wiringOP APP</p></li><li><p>然后点击'''SPI_TEST'''按钮打开SPI的测试界面</p><p>[[File:zero3-img373.png]]</p></li><li><p>然后在左上角选择spi的设备节点，如果直接测试板载的SPIFlash，那么保持默认的'''/dev/spidev0.0'''即可，如果在26pin的spi1上接了'''w25q64'''模块，那么就请选择'''/dev/spidev1.1'''</p><p>[[File:zero3-img374.png]]</p></li><li><p>然后点击'''OPEN'''按钮初始化SPI</p></li> [[File:zero3-img375.png]]</ol><ol start="7" style="list-style-type: decimal;"><li><p>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮</p><p>[[File:zero3-img376.png]]</p></li><li><p>最后APP会显示读取到的板载SPI Flash的ID信息</p></li> [[File:zero3-img377-1.png]]</ol><ol start="9" style="list-style-type: decimal;"><li><p>如果是读取接在26pin SPI1上的w25q64模块，那么读取到的ID信息如下图所示</p><p>[[File:zero3-img378.png]]</p></li><li><p>w25q64模块的MANUFACTURER ID为EFh，Device ID为4017h，跟上面读取到的值是对应的（h代表是16进制）</p><p>[[File:zero3-img379.png]]</p></li></ol> <span id="pin的i2c测试方法"></span> === 26pin的I2C测试方法 === <ol style="list-style-type: decimal;"><li><p>Android中默认打开了26pin中的i2c3，对应的设备节点为'''/dev/i2c-3'''</p>{| class="wikitable" style="width:800px;" |-| <p>apollo-p2:/ # '''ls /dev/i2c-3'''</p><p>/dev/i2c-3</p>|}</li><li><p>首先在桌面中打开wiringOP APP</p><p>[[File:zero3-img359.png]]</p></li><li><p>然后点击'''I2C_TEST'''按钮打开i2c的测试界面</p><p>[[File:zero3-img380.png]]</p></li><li><p>wiringOP的i2c测试界面如下图所示，可以看到默认使用的i2c为'''/dev/i2c-3'''，所以我们无需重新选择了</p></li> [[File:zero3-img381.png]]</ol><ol start="5" style="list-style-type: decimal;"><li><p>然后在26pin的i2c3引脚上接一个i2c设备，这里以ds1307 rtc模块为例</p><p>[[File:zero3-img186.png]]</p></li> {| class="wikitable" style="width:600px;" |-| style="text-align: left;"| '''RTC模块的引脚'''| style="text-align: left;"| '''开发板26pin对应的引脚'''|-| style="text-align: left;"| '''5V'''| style="text-align: left;"| '''2号引脚'''|-| style="text-align: left;"| '''GND'''| style="text-align: left;"| '''6号引脚'''|-| style="text-align: left;"| '''SDA'''| style="text-align: left;"| '''3号引脚'''|-| style="text-align: left;"| '''SCL'''| style="text-align: left;"| '''5号引脚'''|}</ol><ol start="6" style="list-style-type: decimal;"><li><p>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 3'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如下图所示，如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。</p>{| class="wikitable" style="width:800px;" |-| <p>apollo-p2:/ # '''i2cdetect -y 3'''</p>|}<p>[[File:zero3-img382.png]]</p></li><li><p>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c3</p><p>[[File:zero3-img383.png]]</p></li><li><p>点击'''OPEN'''按钮打开i2c3后的显示如下所示：</p><p>[[File:zero3-img384.png]]</p></li><li><p>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55</p><ol style="list-style-type: lower-alpha;"><li><p>我们首先设置需要写入的寄存器的地址为0x1c</p><p>[[File:zero3-img385.png]]</p></li><li><p>然后设置需要写入的值为0x55</p><p>[[File:zero3-img386.png]]</p></li><li><p>然后点击'''WRITE BYTE'''按钮执行写入的动作</p><p>[[File:zero3-img387.png]]</p></li></ol></li><li><p>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过</p><p>[[File:zero3-img388.png]]</p></li></ol> = '''附录''' = == 用户手册更新历史 == {| class="wikitable" style="width:800px;" |-| style="text-align: left;"| '''版本'''| style="text-align: left;"| '''日期'''| style="text-align: left;"| '''更新说明'''|-| style="text-align: left;"| v1.0| style="text-align: left;"| 2023-07-10| style="text-align: left;"| 初始版本|} == 镜像更新历史 == {| class="wikitable" style="width:800px;" |-| '''日期''' | '''更新说明'''|-| 2023-07-10| Orangepizero3_1.0.0_ubuntu_jammy_server_linux5.4.125.7z Orangepizero3_1.0.0_debian_bullseye_server_linux5.4.125.7z Orangepizero3_1.0.0_ubuntu_focal_desktop_xfce_linux5.4.125.7z Orangepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux5.4.125.7z Orangepizero3_1.0.0_debian_bullseye_desktop_xfce_linux5.4.125.7z Orangepizero3_1.0.0_ubuntu_jammy_server_linux6.1.31.7z Orangepizero3_1.0.0_debian_bookworm_server_linux6.1.31.7z Orangepizero3_1.0.0_debian_bullseye_server_linux6.1.31.7z Orangepizero3_1.0.0_ubuntu_jammy_desktop_xfce_linux6.1.31.7z Orangepizero3_1.0.0_debian_bookworm_desktop_xfce_linux6.1.31.7z Orangepizero3_1.0.0_debian_bullseye_desktop_xfce_linux6.1.31.7z OrangePi_Zero3_Android12_v1.0.tar.gz
* 初始版本
|}
