更改

←上一编辑

Orange Pi Zero 2W

添加21,205字节, 2023年9月27日 (三) 16:38

→‎40pin的I2C测试方法

[[File:~~media/image3~~zero2w-img3.png|800px]]

</div>

[[File:~~media/image4~~zero2w-img4.png|800px]]

</div>

== Orange Pi Zero 2w的接口详情图 ==

[[File:~~media/image5~~zero2w-img5.png|800px]]

== Orange Pi Zero 2w 24pin扩展板的接口详情图 ==

[[File:~~media/image6~~zero2w-img6.png|800px]]

[[File:~~media/image7~~zero2w-img7.png|800px]]

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

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

[[File:~~media/image8~~zero2w-img8.png]]

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

|-

|

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

[[File:~~media/image9~~zero2w-img9.png|200px]][[File:~~media/image10~~zero2w-img10.png|200px]][[File:~~media/image11~~zero2w-img11.png|200px]][[File:~~media/image12~~zero2w-img12.png|200px]]

'''目前反馈在Orange Pi Zero 2w上启动有问题的部分TF卡'''

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

</li>

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

[[File:~~media/image13~~zero2w-img13.png]]</li>

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

[[File:~~media/image14~~zero2w-img14.~~jpeg~~png]]

</div></ol>

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

[[File:~~media/image15~~zero2w-img15.~~jpeg~~png|400px]] [[File:~~media/image16~~zero2w-img16.~~jpeg~~png|400px]]

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

|-

|

<big>'''开发板上的两个Type-C接口都可以用来供电。'''</big>

[[File:~~media/image17~~zero2w-img17.png|center]]

|}

</li>

<li>24pin扩展板

[[File:~~media/image18~~zero2w-img18.png]]</li>

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

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

[[File:~~media/image19~~zero2w-img19.png]]

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

|-

<li>网线，用于将开发板连接到因特网</li>

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

[[File:~~media/image20~~zero2w-img20.png]]</li>

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

[[File:~~media/image21~~zero2w-img21.png]] [[File:~~media/image22~~zero2w-img22.png]]</li>

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

[[File:~~media/image23~~zero2w-img23.png]]

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

|-

</li>

<li>Type-C转USB线，用于接USB设备

[[File:~~media/image24~~zero2w-img24.png]]</li>

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

[[File:~~media/image25~~zero2w-img25.png|400px]] [[File:~~media/image26~~zero2w-img26.png|400px]]

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

|-

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

[[File:~~media/image27~~zero2w-img27.png]]</li>

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

[[File:~~media/image28~~zero2w-img28.png]]</li>

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

[[File:~~media/image29~~zero2w-img29.png]]</li>

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

|-

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

[[File:~~media/image30~~zero2w-img30.png|center]]

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

[[File:~~media/image31~~zero2w-img31.png|center]]

|}

</ol>

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

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

[[File:~~media/image32~~zero2w-img32.png]]</li></ol>

</li>

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

[[File:~~media/image33~~zero2w-img33.png]]</li>

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

[[File:~~media/image34~~zero2w-img34.png]]</li>

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

[[File:~~media/image35~~zero2w-img35.png]]</li></ol>

[[File:~~media/image36~~zero2w-img36.png]]

</div></li>

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

[[File:~~media/image37~~zero2w-img37.png]]

</ol>

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

[[File:~~media/image38~~zero2w-img38.png]]</li></ol>

</li></ol>

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

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

[[File:~~media/image39~~zero2w-img39.png]]</li></ol>

</li>

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

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

[[File:~~media/image27~~zero2w-img27.png]]</li>

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

[[File:~~media/image40~~zero2w-img40.png]]</li>

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

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

</li>

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

[[File:~~media/image41~~zero2w-img41.png]]</li>

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

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

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

[[File:~~media/image42~~zero2w-img42.png]]</li></ol>

</li>

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

[[File:~~media/image43~~zero2w-img43.png]]</li>

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

[[File:~~media/image44~~zero2w-img44.png]]</li>

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

[[File:~~media/image45~~zero2w-img45.png]]</li></ol>

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

[[File:~~media/image46~~zero2w-img46.png]]</li>

<li>如果没有安装'''Microsoft Visual C++ 2008 Redistrbutable - x86'''

，使用'''PhoenixCard'''格式化TF卡或者烧录Android镜像会提示下面的错误

[[File:~~media/image47~~zero2w-img47.png]]

</div></li>

<li>'''Microsoft Visual C++ 2008 Redistrbutable - x86'''的安装包可以从Orange Pi Zero 2w的[http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-2W.html '''官方工具''']中下载到，也可以去[https://www.microsoft.com/zh-cn/download/details.aspx?id=26368 '''微软官网''']下载

[[File:~~media/image48~~zero2w-img48.png]] [[File:~~media/image49~~zero2w-img49.png]]</li>

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

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

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

[[File:~~media/image50~~zero2w-img50.png]]</li>

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

[[File:~~media/image51~~zero2w-img51.png]]</li>

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

[[File:~~media/image52~~zero2w-img52.png]]</li>

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

[[File:~~media/image53~~zero2w-img53.png]]

</ol>

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

[[File:~~media/image54~~zero2w-img54.png]]

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

|-

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

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

[[File:~~media/image55~~zero2w-img55.png]]</li></ol>

</li>

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

[[File:~~media/image56~~zero2w-img56.png]]

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

|-

|

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

[[File:~~media/image57~~zero2w-img57.png|center]]

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

[[File:~~media/image58~~zero2w-img58.png|center]]

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

[[File:~~media/image59~~zero2w-img59.png|center]]

|}

</li></ol>

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

[[File:~~media/image60~~zero2w-img60.png]]

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

<big>'''开发板上的两个Type-C接口都可以用来供电。'''</big>

[[File:~~media/image17~~zero2w-img17.png|center]]

|}

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

[[File:~~media/image61~~zero2w-img61.png]]</li>

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

[[File:~~media/image62~~zero2w-img62.png]]

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

|-

</li>

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

[[File:~~media/image63~~zero2w-img63.png]]

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

|-

</li>

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

[[File:~~media/image64~~zero2w-img64.png]]</li>

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

[[File:~~media/image65~~zero2w-img65.png]]</li>

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

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

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

[[File:~~media/image66~~zero2w-img66.png]]</li></ol>

</li>

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

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

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

[[File:~~media/image67~~zero2w-img67.png]]</li></ol>

</li>

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

[[File:~~media/image68~~zero2w-img68.png]]</li></ol>

</li>

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

[[File:~~media/image69~~zero2w-img69.png]]</li>

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

[[File:~~media/image70~~zero2w-img70.png]]</li>

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

[[File:~~media/image71~~zero2w-img71.png]]

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

</li>

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

[[File:~~media/image72~~zero2w-img72.png]]</li>

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

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

[[File:~~media/image73~~zero2w-img73.png]]

</ol>

</li></ol>

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

[[File:~~media/image74~~zero2w-img74.png]]</li></ol>

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

[[File:~~media/image75~~zero2w-img75.~~jpeg~~png]]

</div>

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

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

[[File:~~media/image23~~zero2w-img23.png]]</li></ol>

</li></ol>

[[File:~~media/image76~~zero2w-img76.png]]

</div>

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

[[File:~~media/image77~~zero2w-img77.png]]</li>

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

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

[[File:~~media/image78~~zero2w-img78.png]]

</div></li>

[[File:~~media/image79~~zero2w-img79.png]]

</div>

</li>

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

[[File:~~media/image80~~zero2w-img80.png]]

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

|-

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

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

[[File:~~media/image83~~zero2w-img83.png]]</li>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li>

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

</li></ol>

</li>

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

[[File:~~media/image87~~zero2w-img87.png]]</li>

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

</li>

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

[[File:~~media/image88~~zero2w-img88.png]]

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

|-

</li>

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

[[File:~~media/image87~~zero2w-img87.png]]</li>

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

[[File:~~media/image89~~zero2w-img89.png]]</li>

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

[[File:~~media/image90~~zero2w-img90.png]]</li>

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

[[File:~~media/image91~~zero2w-img91.png]]</li>

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

[[File:~~media/image92~~zero2w-img92.png]]</li>

<li>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New size(MiB)'''中的数字来设置rootfs分区的大小

[[File:~~media/image93~~zero2w-img93.png]]</li>

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

[[File:~~media/image94~~zero2w-img94.png]]</li>

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

[[File:~~media/image95~~zero2w-img95.png]]</li>

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

[[File:~~media/image96~~zero2w-img96.png]]</li>

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

[[File:~~media/image97~~zero2w-img97.png]]</li>

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

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

</li>

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

[[File:~~media/image98~~zero2w-img98.png]]</li>

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

[[File:~~media/image99~~zero2w-img99.png]]</li>

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

[[File:~~media/image100~~zero2w-img100.png]]</li>

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

[[File:~~media/image101~~zero2w-img101.png]]</li>

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

[[File:~~media/image102~~zero2w-img102.png]]</li>

<li>然后可以直接拖动下图所示的位置来设置容量的大小，也可以通过设置'''New sieze(MiB)'''中的数字来设置rootfs分区的大小

[[File:~~media/image93~~zero2w-img93.png]]</li>

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

[[File:~~media/image94~~zero2w-img94.png]]</li>

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

[[File:~~media/image95~~zero2w-img95.png]]</li>

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

[[File:~~media/image96~~zero2w-img96.png]]</li>

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

[[File:~~media/image97~~zero2w-img97.png]]</li>

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

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

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

[[File:~~media/image103~~zero2w-img103.png]]</li>

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

[[File:~~media/image104~~zero2w-img104.png]]</li>

<li>扩展板接入开发板的方式如下所示，请注意排线的正反方向，不要插反了

[[File:~~media/image105~~zero2w-img105.~~jpeg~~png]]

</div></li>

<li>扩展板可以扩展的功能有

[[File:~~media/image6~~zero2w-img6.png|800px]]</li>

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

<li>24pin扩展板上有两个LRADC按键，位置如下图所示：

[[File:~~media/image106~~zero2w-img106.png]]</li>

<li>在Linux系统中，KEY1和KEY2默认设置的键值为</li>

<li>开发板主板上是没有有线网络接口的，我们可以通过24pin扩展板来扩展百兆有线网络接口

[[File:~~media/image107~~zero2w-img107.png]]</li>

<li>然后将网线的一端插入扩展板的以太网接口，网线的另一端接入路由器，并确保网络是畅通的</li>

<li>系统启动后会通过'''DHCP'''自动给以太网卡分配IP地址，'''不需要其他任何配置'''</li>

[[File:~~media/image108~~zero2w-img108.png]]

</div></li>

</li>

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

[[File:~~media/image109~~zero2w-img109.png]]</li>

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

[[File:~~media/image110~~zero2w-img110.png]]</li>

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

[[File:~~media/image111~~zero2w-img111.png]]</li>

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

[[File:~~media/image112~~zero2w-img112.png]]</li>

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

[[File:~~media/image113~~zero2w-img113.png]]</li>

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

[[File:~~media/image114~~zero2w-img114.png]]</li>

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

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

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

[[File:~~media/image115~~zero2w-img115.png]]</li>

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

[[File:~~media/image116~~zero2w-img116.png]]</li>

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

[[File:~~media/image117~~zero2w-img117.png]]</li>

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

[[File:~~media/image118~~zero2w-img118.png]]</li>

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

[[File:~~media/image119~~zero2w-img119.png]]

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

</li>

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

[[File:~~media/image120~~zero2w-img120.png]]</li>

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

[[File:~~media/image121~~zero2w-img121.png]]</li>

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

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

|}

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

[[File:~~media/image121~~zero2w-img121.png]][[File:~~media/image122~~zero2w-img122.png]]</li>

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

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

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

[[File:~~media/image121~~zero2w-img121.png]]

[[File:~~media/image123~~zero2w-img123.png]]

</ol>

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

[[File:~~media/image124~~zero2w-img124.png]]

</li></ol>

</li>

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

[[File:~~media/image120~~zero2w-img120.png]]</li>

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

[[File:~~media/image121~~zero2w-img121.png]]</li>

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

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

|}

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

[[File:~~media/image121~~zero2w-img121.png]][[File:~~media/image125~~zero2w-img125.png]]</li>

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

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

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

[[File:~~media/image124~~zero2w-img124.png]]

</li></ol>

</li>

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

[[File:~~media/image126~~zero2w-img126.png]]</li>

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

[[File:~~media/image127~~zero2w-img127.png]]</li>

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

[[File:~~media/image128~~zero2w-img128.png]]</li>

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

[[File:~~media/image129~~zero2w-img129.png]]</li>

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

[[File:~~media/image130~~zero2w-img130.png]]</li>

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

[[File:~~media/image131~~zero2w-img131.png]]</li>

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

[[File:~~media/image132~~zero2w-img132.png]]</li>

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

[[File:~~media/image133~~zero2w-img133.png]]</li>

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

[[File:~~media/image134~~zero2w-img134.png]]</li>

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

[[File:~~media/image135~~zero2w-img135.png]]</li>

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

[[File:~~media/image136~~zero2w-img136.png]]</li>

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

[[File:~~media/image137~~zero2w-img137.png]]</li>

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

[[File:~~media/image138~~zero2w-img138.png]]</li>

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

[[File:~~media/image139~~zero2w-img139.png]]</li>

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

[[File:~~media/image140~~zero2w-img140.png]] [[File:~~media/image141~~zero2w-img141.png]]</li>

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

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

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

[[File:~~media/image142~~zero2w-img142.png]]

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

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

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

[[File:~~media/image143~~zero2w-img143.png]]</li></ol>

</li>

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

<big>'''注意，输入密码的时候，屏幕上是不会显示输入的密码的具体内容的，请不要以为是有什么故障，输入完后直接回车即可。'''</big>

|}

[[File:~~media/image144~~zero2w-img144.png]]</li>

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

[[File:~~media/image145~~zero2w-img145.png]]</li></ol>

[[File:~~media/image14~~zero2w-img14.~~jpeg~~png]]

</div></li>

<li>HDMI转VGA转换器

[[File:~~media/image146~~zero2w-img146.png]]</li>

<li>一根VGA线和一个Mini HDMI公转HDMI母的转接头

[[File:~~media/image147~~zero2w-img147.png]] [[File:~~media/image148~~zero2w-img148.png]]</li>

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

</li>

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

[[File:~~media/image149~~zero2w-img149.png]]

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

|-

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

|}

[[File:~~media/image150~~zero2w-img150.png]]</li></ol>

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

[[File:~~media/image151~~zero2w-img151.png]]</li>

<li>然后选择适配器

[[File:~~media/image152~~zero2w-img152.png]]</li>

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

[[File:~~media/image153~~zero2w-img153.png]]</li>

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

[[File:~~media/image154~~zero2w-img154.png]]</li>

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

[[File:~~media/image155~~zero2w-img155.png]]</li>

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

[[File:~~media/image156~~zero2w-img156.png]]</li>

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

[[File:~~media/image157~~zero2w-img157.png]]</li>

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

[[File:~~media/image158~~zero2w-img158.png]]</li>

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

[[File:~~media/image159~~zero2w-img159.png]]</li>

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

[[File:~~media/image160~~zero2w-img160.png]]</li></ol>

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

</li>

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

[[File:~~media/image161~~zero2w-img161.png]]</li>

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

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

[[File:~~media/image162~~zero2w-img162.~~jpeg~~png]]

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

如下图所示，开发板的主板上只有两个Type-C类型的USB2.0接口，是无法直接接USB Type-A类型的鼠标、键盘等USB设备的。

[[File:~~media/image163~~zero2w-img163.png]]

如果只购买了主板，没有购买24pin扩展板，可以准备一根线下图所示的Type-C转USB线，将其Type-C接口的一端插入主板的Type-C接口中，然后另一端就可以接鼠标键盘等USB设备了，如果觉得一个 USB接口不够用，还可以通过USB Hub来扩展多个USB接口。

[[File:~~media/image24~~zero2w-img24.png]]

如果购买了24pin扩展板，就无需Type-C转USB线，因为24pin扩展板可以扩展出两个USB2.0 接口。

[[File:~~media/image107~~zero2w-img107.png]]

如下图所示，开发板的主板上有两个Type-C类型的接口：USB0和USB1，这两个接口都可以用来给开发板供电，也都可以用来当做USB2.0 HOST接口。USB0和USB1的区别是：USB0除了可以设置为HOST模式外，还可以设置为Device模式，而USB1只有HOST模式。

[[File:~~media/image163~~zero2w-img163.png]]

Orange Pi发布的Linux系统USB0默认设置为Device模式，所以在不需要使用USB0 Device模式时，建议使用USB0来供电，这样USB1就可以直接用来接USB设备。

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

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

[[File:~~media/image164~~zero2w-img164.png]]</li>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li>

<li>重启后USB0就能正常使用鼠标键盘等USB设备了</li></ol>

[[File:~~media/image165~~zero2w-img165.png]]

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

<li>开发板主板上是没有耳机接口的，我们可以通过24pin扩展板来扩展

[[File:~~media/image107~~zero2w-img107.png]]</li>

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

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

[[File:~~media/image166~~zero2w-img166.png]]</li>

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

[[File:~~media/image167~~zero2w-img167.png]]</li>

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

[[File:~~media/image168~~zero2w-img168.png]]</li>

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

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

[[File:~~media/image169~~zero2w-img169.png]]</li>

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

[[File:~~media/image170~~zero2w-img170.png]]

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

<li>开发板主板上是没有红外接收器的，我们可以通过24pin扩展板来扩展

[[File:~~media/image107~~zero2w-img107.png]]</li>

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

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

[[File:~~media/image171~~zero2w-img171.~~jpeg~~png]]

</div></li>

<li>Orange Pi Zero 2w开发板40 Pin接口引脚的顺序请参开发板上的丝印图

[[File:~~media/image172~~zero2w-img172.png]]</li>

<li>开发板40 Pin接口引脚的功能如下表所示</li>

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

[[File:~~media/image173~~zero2w-img173.png|center|800px]]

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

</li>

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

[[File:~~media/image173~~zero2w-img173.png]]</li></ol>

<li>下面以7号引脚——对应GPIO为PI13——对应wPi序号为2——为例演示如何设置GPIO口的高低电平

[[File:~~media/image174~~zero2w-img174.png]]</li>

<li>首先设置GPIO口为输出模式，其中第三个参数需要输入引脚对应的wPi的序号

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

<li>下面以7号引脚——对应GPIO为PI13——对应wPi序号为2——为例演示如何设置GPIO口的上下拉电阻

[[File:~~media/image174~~zero2w-img174.png]]</li>

<li>首先需要设置GPIO口为输入模式，其中第三个参数需要输入引脚对应的wPi的序号

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

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的SPI的dtbo配置</li>

| '''只打开spi1的cs1'''

|}

[[File:~~media/image175~~zero2w-img175.png]]

</ol>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li></ol>

</li></ol>

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中下图中对应的i2c的配置</li>

|}

[[File:~~media/image176~~zero2w-img176.png]]

</ol>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li></ol>

</li></ol>

[[File:~~media/image177~~zero2w-img177.png]]

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

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的串口</li>

|}

[[File:~~media/image178~~zero2w-img178.png]]

</ol>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li></ol>

</li></ol>

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的pwm对应的配置

[[File:~~media/image179~~zero2w-img179.png]]</li>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li></ol>

</li>

<li>重启后就可以开始PWM的测试

[[File:~~media/image180~~zero2w-img180.~~jpeg~~png]]

</div></ol>

<big>'''wiringOP-Python跟wiringOP一样，也是可以通过指定wPi号来确定操作哪一个GPIO引脚，因为wiringOP-Python中没有查看wPi号的命令，所以只能通过wiringOP中的gpio命令来查看板子wPi号与物理引脚的对应关系。'''</big>

[[File:~~media/image173~~zero2w-img173.png|center]]

|}

<li>下面以7号引脚——对应GPIO为PI13 ——对应wPi序号为2——为例演示如何设置GPIO口的高低电平

[[File:~~media/image174~~zero2w-img174.png]]</li>

<li>直接用命令测试的步骤如下所示：

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的SPI的dtbo配置</li>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li></ol>

</li></ol>

</li>

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

[[File:~~media/image81~~zero2w-img81.png]]</li>

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

[[File:~~media/image82~~zero2w-img82.png]]</li>

<li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中下图中对应的i2c的配置</li>

|}

[[File:~~media/image176~~zero2w-img176.png]]

</ol>

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

[[File:~~media/image84~~zero2w-img84.png]]</li>

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

[[File:~~media/image85~~zero2w-img85.png]]</li>

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

[[File:~~media/image86~~zero2w-img86.png]]</li></ol>

</li></ol>

</li>

<li>然后在40pin接头的i2c引脚上接一个i2c设备，这里以DS1307 RTC模块为例

[[File:~~media/image181~~zero2w-img181.png]]</li>

<li>然后使用'''i2cdetect -y x'''命令如果能检测到连接的i2c设备的地址，就说明i2c设备连接正确

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

|}

[[File:~~media/image182~~zero2w-img182.png]]

</li></ol>

# 由下表可知，可用的uart为uart2、uart3、uart4和uart5。请注意uart0默认设置为调试串口，请不要把uart0当成普通串口使用

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

|-

| '''GPIO序号'''

| '''功能'''

| '''引脚'''

|

~~| '''引脚'''~~

~~| '''功能'''~~

~~| '''GPIO'''~~

~~| '''GPIO序号'''~~

|-

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

| '''3.3V'''

| '''1'''

|

~~| '''2'''~~

~~| '''5V'''~~

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

|-

| '''264'''

| '''TWI1-SDA'''

| '''3'''

|

~~| '''4'''~~

~~| '''5V'''~~

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

|-

| '''263'''

| '''TWI1-SCL'''

| '''5'''

|

~~| '''6'''~~

~~| '''GND'''~~

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

|-

| '''269'''

| '''PWM3/UART4_TX'''

| '''7'''

|

~~| '''8'''~~

~~| '''UART0_TX'''~~

~~| '''PH0'''~~

~~| '''224'''~~

|-

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

| '''GND'''

| '''9'''

|

~~| '''10'''~~

~~| '''UART0_RX'''~~

~~| '''PH1'''~~

~~| '''225'''~~

|-

| '''226'''

| '''UART5_TX'''

| '''11'''

|

~~| '''12'''~~

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

~~| '''PI1'''~~

~~| '''257'''~~

|-

| '''227'''

| '''UART5_RX'''

| '''13'''

|

~~| '''14'''~~

~~| '''GND'''~~

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

|-

| '''261'''

| '''TWI0_SCL/UART2_TX'''

| '''15'''

|

~~| '''16'''~~

~~| '''PWM4/UART4_RX'''~~

~~| '''PI14'''~~

~~| '''270'''~~

|-

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

| '''3.3V'''

| '''17'''

|

~~| '''18'''~~

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

~~| '''PH4'''~~

~~| '''228'''~~

|-

| '''231'''

| '''SPI1_MOSI'''

| '''19'''

|

~~| '''20'''~~

~~| '''GND'''~~

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

|-

| '''232'''

| '''SPI1_MISO'''

| '''21'''

|~~| '''22'''| '''TWI0_SDA/UART2_RX'''| '''PI6'''| '''262'''~~|-| '''230'''

| '''PH6'''

| '''SPI1_CLK'''

| '''23'''

|

~~| '''24'''~~

~~| '''SPI1_CS0'''~~

~~| '''PH5'''~~

~~| '''229'''~~

|-

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

| '''GND'''

| '''25'''

|

~~| '''26'''~~

~~| '''SPI1_CS1'''~~

~~| '''PH9'''~~

~~| '''233'''~~

|-

| '''266'''

| '''TWI2-SDA/UART3_RX'''

| '''27'''

|

~~| '''28'''~~

~~| '''TWI2-SCL/UART3_TX'''~~

~~| '''PI9'''~~

~~| '''265'''~~

|-

| '''256'''

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

| '''29'''

|

~~| '''30'''~~

~~| '''GND'''~~

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

|-

| '''271'''

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

| '''31'''

|

~~| '''32'''~~

~~| '''PWM1'''~~

~~| '''PI11'''~~

~~| '''267'''~~

|-

| '''268'''

| '''PWM2'''

| '''33'''

|

~~| '''34'''~~

~~| '''GND'''~~

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

|-

| '''258'''

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

| '''35'''

|

~~| '''36'''~~

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

~~| '''PC12'''~~

~~| '''76'''~~

|-

| '''272'''

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

| '''37'''

|

~~| '''38'''~~

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

~~| '''PI4'''~~

~~| '''260'''~~

|-

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

| '''GND'''

| '''39'''

|

~~| '''40'''~~

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

~~| '''PI3'''~~

~~| '''259'''~~

|}

~~<ol start~~{| class="2wikitable" style="~~list-style-type~~width: ~~decimal~~390px;">~~<li>Linux系统中uart默认都是关闭的，需要手动打开才能使用。打开步骤如下所示：<ol style="list~~margin-~~style-type~~right: ~~lower-alpha~~20px;">~~<li>首先运行下'''orangepi~~text-~~config'''，普通用户记得加'''sudo'''权限orangepi@orangepi~~align:~~~$ '''sudo orangepi-config'''</li><li>然后选择'''System'''[[File:media/image81.png]]</li><li>然后选择'''Hardware'''[[File:media/image82.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的串口</li></ol></li></ol>~~ ~~{| class="wikitable~~center;"

|-

| '''~~40pin中的复用功能~~引脚'''| '''~~对应的dtbo配置~~功能'''| '''GPIO'''| '''GPIO序号'''|-| '''2'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''4'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|

|-

| '''~~40pin - uart2~~8'''| '''~~pi-uart2~~UART0_TX'''| '''PH0'''| '''224'''

|-

| '''~~40pin - uart3~~10'''| '''~~pi-uart3~~UART0_RX'''| '''PH1'''| '''225'''

|-

| '''~~40pin~~ 12'''| style="text- ~~uart4~~align: left;"|| '''PI1'''| '''~~pi-uart4~~257'''

|-

| '''~~40pin - uart5~~14'''| '''~~ph-uart5~~GND'''|} ~~[[File:media/image178.png]]~~ ~~<ol start~~style="5text-align: left;" || style="~~list-style~~text-~~type~~align: ~~lower-alpha~~left;">||-~~<li>然后选择~~| '''16'''~~<Save>~~| '''~~保存<~~PWM4/p>UART4_RX'''~~[[File:media/image84.png]]</li>~~| '''PI14'''~~<li>然后选择~~| '''~~<Back>~~270'''~~[[File:media/image85.png]]</li>~~|-~~<li>然后选择~~| '''~~<Reboot>~~18'''~~重启系统使配置生效[[File~~| style="text-align:~~media/image86.png]]</li></ol>~~left;"|| '''PH4'''| '''228'''<!|-~~- --><ol start~~| '''20'''| '''GND'''| style="3text-align: left;" || style="~~list-style~~text-~~type~~align: ~~decimal~~left;">||-| '''22'''~~<li>进入linux系统后，先确认下~~| '''TWI0_SDA/~~dev~~UART2_RX'''~~下是否存在uart5的设备节点~~| '''~~注意，linux5.4系统为/dev/ttyASx。~~PI6'''~~orangepi@orangepi:~$~~ | '''ls /dev/ttyS*262'''~~/dev/ttySx</li>~~|-~~<li>然后开始测试uart接口，先使用杜邦线短接要测试的uart接口的rx和tx引脚</li>~~| '''24'''~~<li>使用wiringOP中的~~| '''~~gpio~~SPI1_CS0'''~~命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常~~| '''~~注意，gpio serial /dev/ttySx命令中最后的x需要替换为对应的uart设备节点的序号。~~PH5'''~~orangepi@orangepi:~$~~ | '''229'''~~gpio serial /dev/ttySx # linux~~|-~~6.1测试命令~~| '''26'''| '''SPI1_CS1'''| '''PH9'''~~orangepi@orangepi:~$~~ | '''233'''~~gpio serial /dev/ttyASx # linux~~|-~~5.4测试命令~~| '''28'''| '''<TWI2-SCL/p>UART3_TX'''| '''PI9'''| '''265'''~~Out: 0:~~ |-~~> 0Out~~| '''30'''| '''GND'''| style="text-align: ~~1: -&gt~~left; ~~1~~"|~~Out~~| style="text-align: ~~2: -&gt~~left; ~~2~~"|~~Out: 3:~~ |-~~> 3^C</li><li>最后可以运行examples中的~~| '''32'''| '''PWM1'''| '''~~serialTest.py~~PI11'''~~程序来测试下串口的回环功能，如果能看到下面的打印，说明串口回环测试正常~~| '''~~注意，命令中/dev/ttySx或/dev/ttyASx中的x需要替换为对应的uart设备节点的序号。~~267'''~~root@orangepi:~/wiringOP~~|-~~Python#~~ | '''34'''| '''~~cd examples~~GND'''~~root@orangepi~~| style="text-align: left;"|| style="text-align:~~~/wiringOP~~left;"||-~~Python/examples#~~ | '''36'''~~python3 serialTest.py~~ | style="text-~~-device &quot~~align: left;~~/dev/ttySx" # linux6.1使用~~"|| '''PC12'''| '''76'''~~root@orangepi:~/wiringOP~~|-~~Python/examples#~~ | '''38'''~~python3 serialTest.py~~ | style="text-~~-device &quot~~align: left;~~/dev/ttyASx" # linux5.4使用~~"|| '''PI4'''| '''260'''~~Out: 0:~~ |-~~> 0Out: 1~~| '''40'''| style="text-align: ~~-&gt~~left; 1"|| '''PI3'''| '''259'''|}</pdiv><~~p>Out:~~ ol start="2: " style="list-style-~~> 2Out~~type: ~~3: -&gt~~decimal; ~~3</p~~"><pli>~~Out: 4:^C~~~~exit~~Linux系统中uart默认都是关闭的，需要手动打开才能使用。打开步骤如下所示：</p~~></li></ol~~> ~~== 硬件看门狗测试 ==~~ ~~Orange Pi发布的linux系统中预装了watchdog_test程序，可以直接测试。~~ ~~运行watchdog_test程序的方法如下所示：~~ <ol style="list-style-type: lower-alpha;"><li>~~第二个参数10表示看门狗的计数时间，如果这个时间内没有喂狗，系统会重启~~首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限~~</li><li>我们可以通过按下键盘上的任意键（ESC除外）来喂狗，喂狗后，程序会打印一行keep alive表示喂狗成功~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo ~~watchdog_test 10~~orangepi-config'''~~open success~~|}</pli><pli>~~options is 33152,identity is sunxi-wdt~~~~put_usr return,if 0,success:0~~然后选择'''System'''~~The old reset time is~~[[File: 16zero2w-img81.png]]~~return ENOTTY,if -1,success:0~~</pli><pli>~~return ENOTTY,if -1,success:0~~~~put_user return,if 0,success:0~~然后选择'''Hardware'''~~put_usr return,if 0,success~~[[File:0zero2w-img82.png]]~~keep alive~~</pli><~~p>keep alive</p~~li>~~keep alive~~然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的串口</li~~></ol~~>

~~~~style="width:800px;text-align: center;" |-| '''40pin中的复用功能'''| '''对应的dtbo配置'''|-| '''40pin - uart2'''| '''pi-uart2'''|-| '''40pin - uart3'''| '''pi-uart3'''|-| '''40pin - uart4'''| '''pi-uart4'''|-~~== 查看H618芯片的chipid ==~~| '''40pin - uart5'''| '''ph-uart5'''~~查看H618芯片chipid的命令如下所示，每个芯片的chipid都是不同的，所以可以使用chipid来区分多个开发板。~~|}

[[File:zero2w-img178.png]]</ol><ol start="5" style="list-style-type: lower-alpha;"><li>然后选择'''<Save>'''保存[[File:zero2w-img84.png]]</li><li>然后选择'''<Back>'''[[File:zero2w-img85.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:zero2w-img86.png]]</li></ol></li></ol><ol start="3" style="list-style-type: decimal;"><li>进入linux系统后，先确认下'''/dev'''下是否存在uart5的设备节点{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，linux5.4系统为/dev/ttyASx。'''</big>|}{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~cat~~ ls /dev/ttyS*'''/dev/ttySx|}</li><li>然后开始测试uart接口，先使用杜邦线短接要测试的uart接口的rx和tx引脚</~~sys~~li><li>使用wiringOP中的'''gpio'''命令测试串口的回环功能如下所示，如果能看到下面的打印，说明串口通信正常{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，gpio serial /dev/ttySx命令中最后的x需要替换为对应的uart设备节点的序号。'''</~~sunxi_info~~p></~~sys_info~~ big>| ~~grep "chipid&quot~~}{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''gpio serial /dev/ttySx # linux-6.1测试命令'''orangepi@orangepi:~$ '''gpio serial /dev/ttyASx # linux-5.4测试命令'''

~~sunxi_chipid : 338020004c0048080147478824681ed1~~

<~~span id="python相关说明"~~p>Out: 0: -> 0Out: 1: -> 1Out: 2: -> 2Out: 3: -> 3^C</~~span~~p>~~== Python相关说明 ==~~|}</li><~~span id~~li>最后可以运行examples中的'''serialTest.py'''程序来测试下串口的回环功能，如果能看到下面的打印，说明串口回环测试正常{| class="wikitable" style="~~python源码编译安装的方法~~background-color:#ffffdc;width:800px;"|-| <big>'''注意，命令中/~~span~~dev/ttySx或/dev/ttyASx中的x需要替换为对应的uart设备节点的序号。'''</big>|}{| class="wikitable" style=~~= Python源码编译安装的方法 ===~~"width:800px;" |-| root@orangepi:~/wiringOP-Python# '''如果使用的Ubuntu或者Debian系统软件仓库中的Python版本不符合开发的要求，想要使用最新版本的Python，可以使用下面的方法下载Python的源码包来编译安装最新版本的Python。cd examples'''root@orangepi:~/wiringOP-Python/examples# '''python3 serialTest.py --device "/dev/ttySx" # linux6.1使用'''root@orangepi:~/wiringOP-Python/examples# '''~~下面演示的是编译安装Python3~~python3 serialTest.~~9的最新版本，如果要编译安装其他的版本的Python，方法也是一样的（需要下载想要安装的Python对应的源码）。~~py --device "/dev/ttyASx" # linux5.4使用'''

~~<ol style="list-style-type: decimal;">~~

~~<li>首先安装编译Python需要的依赖包~~

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

~~orangepi@orangepi:~$ '''sudo apt-get install -y build-essential zlib1g-dev \'''~~

~~'''libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev \'''~~

~~'''libreadline-dev libffi-dev curl libbz2-dev'''</li>~~

~~<li>然后下载最新版本的Python3.9源码并解压~~

~~orangepi@orangepi:~$ '''wget \'''~~

~~[https://www.python.org/ftp/python/3.9.10/Python-3.9.10.tgz '''https://www.python.org/ftp/python/3.9.10/Python-3.9.10.tgz''']~~

~~orangepi@orangepi:~$ '''tar xvf Python-3.9.10.tgz'''</li>~~

~~<li>然后运行配置命令~~

~~orangepi@orangepi:~$ '''cd Python-3.9.10'''~~

~~orangepi@orangepi:~$ '''./configure --enable-optimizations'''</li>~~

~~<li>然后编译安装Python3.9，编译时间大概需要半个小时左右~~

~~orangepi@orangepi:~$ '''make -j4'''~~

~~orangepi@orangepi:~$ '''sudo make altinstall'''</li>~~

~~<li>安装完后可以使用下面的命令查看下刚安装的Python的版本号~~

~~orangepi@orangepi:~$ '''python3.9 --version'''~~

~~'''Python 3.9.10'''</li>~~

~~<li>然后更新下pip~~

~~orangepi@orangepi:~$ '''/usr/local/bin/python3.9 -m pip install --upgrade pip'''</li></ol>~~

<~~span id="python更换pip源的方法"~~p>Out: 0: -> 0</~~span~~p>~~=== Python更换pip源的方法 ===~~Out: 1: -> 1Out: 2: -> 2Out: 3: -> 3Out: 4:^Cexit|}</li></ol>

'''Linux系统pip默认使用的源为Python官方的源，但是国内访问Python官方的源速度是很慢的，并且经常会由于网络原因导致Python软件包安装失败。所以在使用pip安装Python库时，请记得更换下pip源。'''== 硬件看门狗测试 ==

~~<ol style="list-style-type: decimal;"><li>首先安装下'''python3-pip'''orangepi@orangepi:~$ '''sudo apt-get update'''orangepi@orangepi:~$ '''sudo apt-get install -y python3-pip'''</li><li>Linux下永久更换pip源的方法<ol style="list-style-type: lower-alpha;"><li>先新建'''~/.pip'''目录，然后添加'''pip.conf'''配置文件，并在其中设置pip的源为清华源orangepi@orangepi:~$ '''mkdir -p ~/.pip'''orangepi@orangepi:~$ '''cat <<EOF > ~/.pip/pip.conf''''''[global]''''''timeout = 6000''''''index-url = https://pypi.tuna.tsinghua.edu.cn/simple''''''trusted-host = pypi.tuna.tsinghua.edu.cn''''''EOF'''</li><li>然后使用pip3安装Python库速度就会很快了</li></ol></li><li>Linux下临时更换pip源的方法，其中的'''<packagename>'''需要替换为具体的包名orangepi@orangepi:~$ '''pip3 install <packagename> -i \''''''https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn'''</li></ol>~~Orange Pi发布的linux系统中预装了watchdog_test程序，可以直接测试。

~~== 安装Docker的方法 ==~~运行watchdog_test程序的方法如下所示：

Orange Pi提供的linux镜像已经预装了Docker，只是Docker服务默认没有打开。使用'''enable_docker.sh'''脚本可以使能docker服务，然后就可以开始使用docker命令了，并且在下次启动系统时也会自动启动docker服务。<ol style="list-style-type: lower-alpha;"><li>第二个参数10表示看门狗的计数时间，如果这个时间内没有喂狗，系统会重启</li><li>我们可以通过按下键盘上的任意键（ESC除外）来喂狗，喂狗后，程序会打印一行keep alive表示喂狗成功{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~enable_docker.sh~~sudo watchdog_test 10'''open successoptions is 33152,identity is sunxi-wdtput_usr return,if 0,success:0The old reset time is: 16return ENOTTY,if -1,success:0return ENOTTY,if -1,success:0put_user return,if 0,success:0put_usr return,if 0,success:0keep alivekeep alivekeep alive|}</li></ol>

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

~~orangepi@orangepi:~$ '''docker run hello-world'''~~== 查看H618芯片的chipid ==

~~Unable to find image 'hello-world:latest' locally~~查看H618芯片chipid的命令如下所示，每个芯片的chipid都是不同的，所以可以使用chipid来区分多个开发板。

~~latest~~{| class="wikitable" style="width: ~~Pulling from library~~800px;" |-| orangepi@orangepi:~$ '''cat /sys/class/~~hello-world~~sunxi_info/sys_info | grep "chipid"'''

~~256ab8fe8778~~sunxi_chipid : ~~Pull complete~~338020004c0048080147478824681ed1|}

~~Digest: sha256:7f0a9f93b4aa3022c3a4c147a449ef11e0941a1fd0bf4a8e6c9408b2600777c5~~

~~Status: Downloaded newer image for hello-world:latest~~== Python相关说明 ==

~~'''Hello from Docker!'''~~=== Python源码编译安装的方法 ===

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

'''下面演示的是编译安装Python3.~~….'''~~ ~~使用docker命令时，如果提示'''permission denied'''，请将当前用户加入到docker用户组，这样不需要sudo就能运行docker命令了。~~ ~~orangepi@orangepi:~$ ''~~9的最新版本，如果要编译安装其他的版本的Python，方法也是一样的（需要下载想要安装的Python对应的源码）。'~~sudo usermod -aG docker $USER~~''' ~~'''注意：需要退出重新登录系统才能生效，重启系统也可以。'''~~ ~~~~</~~span~~big>~~== Home Assistant的安装方法 ==~~ ~~'''注意，这里只会提供在Ubuntu或者Debian系统中安装Home Assistant的方法，Home Assistant详细的使用方法请参考官方文档或者相应的书籍。'''~~ ~~=== 通过docker安装 ===~~|}

<li>~~首先请安装好docker，并确保docker能正常运行。docker的安装步骤请参考[[\l|'''安装Docker的方法''']]一节的说明。~~首先安装编译Python需要的依赖包</p~~></li~~>~~<li>然后可以搜索下Home Assistant的docker镜像orangepi@orangepi:~$ '''docker search homeassistant'''</li><li>然后使用下面的命令下载Home Assistant的docker镜像到本地，镜像大小大概有1GB多，下载时间会比较长，请耐心等待下载完成orangepi@orangepi:~$ '''docker pull homeassistant/home-assistant'''Using default tag: latestlatest: Pulling from homeassistant/home-assistantbe307f383ecc: Downloading5fbc4c07ac88: Download complete'''...... (省略部分输出)'''3cc6a1510c9f: Pull complete7a4e4d5b979f: Pull completeDigest: sha256:81d381f5008c082a37da97d8b08dd8b358dae7ecf49e62ce3ef1eeaefc4381bbStatus: Downloaded newer image for homeassistant/home-assistant:latestdocker.io/homeassistant/home-assistant:latest</li><li>然后可以使用下面的命令查看下刚下载的Home Assistant的docker镜像orangepi@orangepi:~$ '''docker images homeassistant/home-assistant'''REPOSITORY TAG IMAGE ID CREATED SIZEhomeassistant/home-assistant latest bfa0ab9e1cf5 2 months ago '''1.17GB'''</li><li>此时就可以运行Home Assistant的docker容器了orangepi@orangepi:~$ '''docker run -d \''''''--name homeassistant \''''''--privileged \''''''--restart~~{| class=~~unless-stopped \''''''-e TZ=Asia/Shanghai \''''''-v /home/orangepi/home-assistant:/config \''''''--network=host \''''''homeassistant/home-assistant:latest'''</li><li>然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面~~'''Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''~~[[File:media/image183.png]]</li><li>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''[[File:media/image184.png]]</li><li>然后按照界面提示根据自己的喜好设置，再点击下一步[[File:media/image185.png]]</li><li>然后点击下一步[[File:media/image186.png]]</li><li>然后点击完成[[File:media/image187.png]]</li><li>Home Assistant最终显示的主界面如下图所示[[File:media/image188.png]]</li><li>停止Home Assistant容器的方法<ol~~ "wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>查看docker容器的命令如下所示orangepi@orangepi:~$ '''docker ps~~ |-~~a'''</li><li>停止Home Assistant容器的命令如下所示orangepi@orangepi:~$ '''docker stop homeassistant'''</li><li>删除Home Assistant容器的命令如下所示orangepi@orangepi:~$ '''docker rm homeassistant'''</li></ol></li></ol>~~ ~~=== 通过python安装 ===~~ ~~'''安装前请先更换下pip的源为国内源，加快Python包的安装速度，配置方法见[[\l~~|~~Python更换pip源的方法]]一节的说明。'''~~ ~~<ol style="list-style-type: decimal;"><li>首先安装依赖包~~

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

orangepi@orangepi:~$ '''sudo apt-get install -y ~~python3 python3~~build-essential zlib1g-dev ~~python3-venv~~ \''''''~~python3~~libncurses5-~~pip libffi~~dev libgdbm-dev ~~libssl~~libnss3-dev ~~libjpeg~~libssl-dev ~~zlib1g~~libsqlite3-dev ~~autoconf build-essential~~ \''''''~~libopenjp2~~libreadline-~~7 libtiff5 libturbojpeg0~~dev libffi-dev curl libbz2-dev ~~tzdata~~'''|}<p/li>~~'''如果是debian12请使用下面的命令：'''~~</pli>~~orangepi@orangepi:~$ '''sudo apt-get update'''~~然后下载最新版本的Python3.9源码并解压{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo apt-get install -y python3 python3-dev python3-venv~~ wget \'''~~'''python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \'''<~~[https://www.python.org/ftp/python/3.9.10/p>~~'''libopenjp2~~Python-~~7 libturbojpeg0-dev tzdata~~3.9.10.tgz '''<https:/~~p><~~/~~li><li>然后需要编译安装Python3~~www.python.~~9，方法请参考[[\l|'''Python源码编译安装的方法''']]一节<~~org/ftp/python/p>~~'''Debian Bullseye默认的Python版本就是Python3~~3.9.~~9，所以无需编译安装。'''<~~10/p>~~'''Ubuntu Jammy默认的Python版本就是Python3~~Python-3.9.10.~~10，所以也无需编译安装。~~tgz''']orangepi@orangepi:~$ '''~~Debian Bookworm默认的Python版本就是Python3~~tar xvf Python-3.9.10.~~11，所以也无需编译安装。~~tgz'''|}</li><li>~~然后创建Python虚拟环境~~然后运行配置命令~~'''Debian Bookworm中是python3.11，请记得替换对应的命令。'''~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo mkdir /srv/homeassistant~~cd Python-3.9.10'''orangepi@orangepi:~$ '''~~sudo chown orangepi:orangepi~~ ./~~srv/homeassistant~~configure --enable-optimizations'''|}</li><li>~~orangepi@orangepi:~$ '''cd /srv/homeassistant'''~~然后编译安装Python3.9，编译时间大概需要半个小时左右{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3.9~~ make -~~m venv .~~j4'''orangepi@orangepi:~$ '''~~source bin/activate~~sudo make altinstall'''~~(homeassistant) orangepi@orangepi:/srv/homeassistant$~~|}</li><li>~~然后安装需要的Python包~~安装完后可以使用下面的命令查看下刚安装的Python的版本号{| class="wikitable" style="width:800px;" |-| ~~(homeassistant)~~ orangepi@orangepi:~~/srv/homeassistant~~~$ '''python3 .9 -~~m pip install wheel~~-version'''~~</li><li>然后就可以安装Home Assistant Core~~~~(homeassistant) orangepi@orangepi:/srv/homeassistant$~~ '''~~pip3 install homeassistant~~Python 3.9.10'''|}</li><li>~~然后输入下面的命令就可以运行Home Assistant Core~~然后更新下pip{| class="wikitable" style="width:800px;" |-| ~~(homeassistant)~~ orangepi@orangepi:~~/srv/homeassistant~~~$ '''~~hass~~/usr/local/bin/python3.9 -m pip install --upgrade pip'''|}</li>~~<li>然后在浏览器中输入【'''开发板的IP地址:8123'''】就能看到Home Assistant的界面~~</pol>'''第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。'''<~~p>[[File:media/image189.png]]</li~~span id="python更换pip源的方法"></olspan>

~~~~== ~~OpenCV的安装方法~~ Python更换pip源的方法 ===

~~'''Linux系统pip默认使用的源为Python官方的源，但是国内访问Python官方的源速度是很慢的，并且经常会由于网络原因导致Python软件包安装失败。所以在使用pip安装Python库时，请记得更换下pip源。'''</~~span~~big>~~=== 使用apt来安装OpenCV ===|}

<li>~~安装命令如下所示~~首先安装下'''python3-pip'''{| class="wikitable" style="width:800px;" |-|

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

orangepi@orangepi:~$ '''sudo apt-get install -y ~~libopencv-dev~~ python3-~~opencv~~pip'''|}</li><li>~~然后使用下面的命令打印OpenCV的版本号输出正常，说明OpenCV安装成功~~Linux下永久更换pip源的方法

<li>~~Ubuntu22~~先新建'''~/.pip'''目录，然后添加'''pip.~~04中OpenCV的版本如下所示：~~conf'''配置文件，并在其中设置pip的源为清华源{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3~~ mkdir -~~c "import cv2; print(cv2~~p ~/.~~__version__)"~~pip'''orangepi@orangepi:~$ '''4cat <<EOF > ~/.5pip/pip.4conf'''</p~~></li~~>~~<li>~~~~Ubuntu20.04中OpenCV的版本如下所示：~~'''[global]'''~~orangepi@orangepi:~$~~ '''~~python3 -c "import cv2; print(cv2.__version__)"~~timeout = 6000''''''4index-url = https://pypi.tuna.tsinghua.2edu.0cn/simple'''</p~~></li~~>~~<li>~~~~Debian11中OpenCV的版本如下所示：~~'''trusted-host = pypi.tuna.tsinghua.edu.cn'''~~orangepi@orangepi:~$~~ '''~~python3 -c "import cv2; print(cv2.__version__)"~~EOF'''|}</li><li>~~'''4.5.1'''~~然后使用pip3安装Python库速度就会很快了</li></ol></li><li>~~Debian12中OpenCV的版本如下所示：~~Linux下临时更换pip源的方法，其中的'''<packagename>'''需要替换为具体的包名{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3 -c~~ pip3 install &~~quot~~lt;~~import cv2; print(cv2.__version__)~~packagename&~~quot~~gt;-i \''''''4https://pypi.6tuna.0tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn'''~~</li></ol>~~|}</li></ol> ~~== 设置中文环境以及安装中文输入法 ==~~

~~'''注意，安装中文输入法前请确保开发板使用的Linux系统为桌面版系统。'''~~

~~=== Debian 系统的安装方法~~ =安装Docker的方法 ==

~~<ol style="list-style-type: decimal;"><li>首先设置默认~~Orange Pi提供的linux镜像已经预装了Docker，只是Docker服务默认没有打开。使用'''~~locale'''为中文<ol style="list-style-type: lower-alpha;"><li>输入下面的命令可以开始配置'''locale'''orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''</li>~~<li>然后在弹出的界面中选择'''zh_CN.UTF-8 > UTF-8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''<OK>'''，然后回车即可）~~[[File:media/image190.png]]</li><li>然后设置默认'''locale'''为'''zh_CN.UTF-8'''[[File:media/image191.png]]</li><li>退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''Generating locales (this might take a while)...en_US.UTF-8... donezh_CN.UTF-8... doneGeneration complete.</li></ol></li><li>然后打开'''Input Method'''[[File:media/image192.png]]</li><li>然后选择'''OK'''[[File:media/image193.png]]</li><li>然后选择'''Yes'''[[File:media/image194.png]]</li><li>然后选择'''fcitx'''[[File:media/image195.png]]</li><li>然后选择'''OK'''[[File:media/image196.png]]</li><li>'''然后重启Linux系统才能使配置生效'''</li><li>然后打开'''Fcitx configuration'''[[File:media/image197.png]]</li><li>然后点击下图所示位置的'''+'''号[[File:media/image198.png]]</li><li>然后搜索'''Google Pinyin'''再点击'''OK'''[[File:media/image199.png]]</li><li>然后将'''Google Pinyin'''放到最前面[[File:media/image200.png]][[File:media/image201.png]]</li><li>然后打开'''Geany'''这个编辑器测试下中文输入法[[File:media/image202.png]]</li><li>中文输入法测试如下所示[[File:media/image203.png]]</li><li>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</li><li>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CN.UTF-8'''orangepi@orangepi:~$ '''sudo vim /etc/default/locale'''# File generated by update-localeLC_MESSAGES='''zh_CN~~enable_docker.~~UTF-8~~sh'''~~LANG='''zh_CN.UTF-8'''LANGUAGE='''zh_CN.UTF-8'''</li><li>然后'''重启系统'''就能看到系统显示为中文了[[File:media/image204.png]]</li></ol>~~脚本可以使能docker服务，然后就可以开始使用docker命令了，并且在下次启动系统时也会自动启动docker服务。

~~~~sh'''~~=== Ubuntu 20.04系统的安装方法 ===~~|}

~~<ol style="list-style-type: decimal;"><li>首先打开~~可以使用下面的命令测试下docker，如果能运行'''~~Language Support'''[[File:media/image205.png]]</li><li>然后找到'''汉语（中国）'''选项[[File:media/image206.png]]</li><li>然后请使用鼠标左键选中'''汉语（中国）~~hello-world'''~~并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：[[File:media/image207.png]]</li></ol>~~说明docker能正常使用了。

{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~注意，这一步不是很好拖动的，请耐心多试几次。~~docker run hello-world''' Unable to find image 'hello-world:latest' locally

~~<ol start="4" style="list-style-type~~latest: ~~decimal;"><li>然后选择'''Apply System~~Pulling from library/hello-~~Wide'''将中文设置应用到整个系统[[File:media/image208.png]]</li><li>然后设置'''Keyboard input method system'''为'''fcitx'''[[File:media/image209.png]]</li><li>'''然后重启Linux系统使配置生效'''</li><li>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文[[File:media/image210.png]]</li><li>然后可以看到桌面都显示为中文了[[File:media/image211.png]]</li><li>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示[[File:media/image212.png]]</li><li>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了[[File:media/image213.png]]</li></ol>~~world

~~=== Ubuntu 22.04系统的安装方法 ===~~256ab8fe8778: Pull complete

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

~~'''注意，这一步不是很好拖动的，请耐心多试几次。'''~~Status: Downloaded newer image for hello-world:latest

~~<ol start="4" style="list-style-type: decimal;">~~

~~<li>然后选择'''Apply System-Wide'''将中文设置应用到整个系统~~

~~[[File:media/image216.png]]</li>~~

~~<li>'''然后重启Linux系统使配置生效'''</li>~~

~~<li>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文~~

~~[[File:media/image210.png]]</li>~~

~~<li>然后可以看到桌面都显示为中文了~~

~~[[File:media/image211.png]]</li>~~

~~<li>然后打开Fcitx5配置程序~~

~~[[File:media/image217.png]]</li>~~

~~<li>然后选择使用拼音输入法~~

~~[[File:media/image218.png]]</li>~~

~~<li>选择后的界面如下所示，再点击确定即可~~

~~[[File:media/image219.png]]</li>~~

~~<li>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示~~

~~[[File:media/image212.png]]</li>~~

~~<li>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了~~

~~[[File:media/image220.png]]</li></ol>~~

'''Hello from Docker!~~== 远程登录Linux系统桌面的方法 ==~~'''

'''This message shows that your installation appears to be working correctly.~~=== 使用NoMachine远程登录 ===~~'''

'''请确保开发板安装的Ubuntu或者Debian系统为桌面版本的系统。另外NoMachine也提供了详细的使用文档，强烈建议通读此文档来熟悉NoMachine的使用，文档链接如下所示：.….'''|}

使用docker命令时，如果提示'''~~https://knowledgebase.nomachine.com/DT10R00166~~permission denied'''，请将当前用户加入到docker用户组，这样不需要sudo就能运行docker命令了。

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

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''~~操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。~~注意：需要退出重新登录系统才能生效，重启系统也可以。'''</big>|}

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

~~'''注意，这个下载链接可能会变，请认准Armv8/Arm64版本的deb包。'''~~== Home Assistant的安装方法 ==

~~[https://www.nomachine.com/download/download&id~~{| class=~~112&s~~"wikitable" style=~~ARM~~ "background-color:#ffffdc;width:800px;" |-| <big>'''~~https://downloads.nomachine.com/download/?id=118&distro=ARM~~注意，这里只会提供在Ubuntu或者Debian系统中安装Home Assistant的方法，Home Assistant详细的使用方法请参考官方文档或者相应的书籍。''']</big>|}

~~[[File:media/image221.png]]~~ ~~<ol start~~=~~"2" style~~=~~"list-style-type: lower-alpha;"><li>另外在'''官方工具'''中也可以下载到'''NoMachine'''的安装包[[File:media/image222.png]]先进入'''远程登录软件-NoMachine'''文件夹[[File:media/image223.png]]然后下载arm64版本的deb安装包[[File:media/image224.png]]</li><li>然后将下载的'''nomachine_x.x.x_x_arm64.deb'''上传到开发板的Linux系统中</li><li>然后使用下面的命令在开发板的Linux系统中安装'''NoMachine'''orangepi@orangepi:~$ '''sudo dpkg -i nomachine_x.x.x_x_arm64_arm64.deb'''</li></ol>~~ ~~<ol start~~=~~"2" style~~通过docker安装 =~~"list-style-type: decimal;"><li>然后下载NoMachine软件Windows版本的安装包，下载地址如下所示</li></ol>~~ ~~'''注意，这个下载链接可能会变。'''~~ ~~'''https://downloads.nomachine.com/download/?id~~=~~9'''~~ ~~[[File:media/image225.png]]~~ ~~<ol start~~=~~"3" style="list-style-type: decimal;"><li>然后在Windows中安装NoMachine，'''安装完后请重启下电脑'''</li><li>然后在Window中打开'''NoMachine'''[[File:media/image226.png]]</li>~~<li>NoMachine启动后会自动扫描局域网内其他安装有NoMachine的设备，进入NoMachine的主界面后就可以看到开发板已经在可连接的设备列表里了，然后点击下图红色方框所示的位置即可开始登录开发板的Linux系统桌面~~[[File:media/image227.png]]</li><li>然后点击'''OK'''[[File:media/image228.png]]</li><li>然后在下图对应的位置输入开发板Linux系统的用户名和密码，再点击'''OK'''开始登陆[[File:media/image229.png]]</li><li>然后在接下来的界面中都点击OK</li><li>最后就能看到开发板Linux系统的桌面了[[File:media/image230.png]]</li></ol>~~ ~~=== 使用VNC远程登录 ===~~ ~~'''操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''~~ ~~'''Ubuntu20.04测试VNC很多问题，请不要使用这种方法。'''~~

<li>~~首先运行~~首先请安装好docker，并确保docker能正常运行。docker的安装步骤请参考[[Orange Pi Zero 2W#安装Docker的方法|'''~~set_vnc.sh~~安装Docker的方法'''~~脚本设置下vnc，~~]]一节的说明。</li><li>然后可以搜索下Home Assistant的docker镜像{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~记得加sudo权限~~docker search homeassistant'''|}</li><li>然后使用下面的命令下载Home Assistant的docker镜像到本地，镜像大小大概有1GB多，下载时间会比较长，请耐心等待下载完成{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo set_vnc~~docker pull homeassistant/home-assistant'''Using default tag: latestlatest: Pulling from homeassistant/home-assistantbe307f383ecc: Downloading5fbc4c07ac88: Download complete'''....sh.. (省略部分输出)'''~~You will require a password to access your desktops~~3cc6a1510c9f: Pull complete7a4e4d5b979f: Pull completeDigest: sha256:81d381f5008c082a37da97d8b08dd8b358dae7ecf49e62ce3ef1eeaefc4381bbStatus: Downloaded newer image for homeassistant/home-assistant:latestdocker.io/homeassistant/home-assistant:latest|}</li><li>然后可以使用下面的命令查看下刚下载的Home Assistant的docker镜像{| class="wikitable" style="width:800px;" |-| ~~Password~~orangepi@orangepi: ~$ '''~~#在这里设置vnc的密码，8位字符~~docker images homeassistant/home-assistant'''~~Verify:~~ REPOSITORY                                    TAG       IMAGE       ID       CREATED       SIZEhomeassistant/home-assistant       latest       bfa0ab9e1cf5       2 months ago       '''1.17GB'''|}</li><li>~~Would you like to enter a view~~此时就可以运行Home Assistant的docker容器了{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''docker run -~~only password (y~~d \'''</~~n)?~~ p>:'''n--name homeassistant \''':~~xauth: file /root/.Xauthority does not exist~~'''--privileged \''':~~New~~ 'X' ~~desktop is orangepi:1~~'--restart=unless-stopped \''':~~Creating default startup script~~ '''-e TZ=Asia/~~root/.vnc/xstartup~~Shanghai \''':~~Starting applications specified in~~ '''-v /home/~~root~~orangepi/~~.vnc~~home-assistant:/~~xstartup~~config \''':~~Log file is~~ '''--network=host \'''</~~root~~p>:'''homeassistant/~~.vnc/orangepi~~home-assistant:~~1.log~~latest'''|}</li><li>~~Killing Xtightvnc process ID 3047~~然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>~~New~~ 'X' ~~desktop is orangepi:1~~'Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''</big>|}~~Starting applications specified in~~ [[File:zero2w-img183.png]]</~~root~~p></~~.vnc/xstartup~~li><li>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''~~Log file is~~ [[File:zero2w-img184.png]]</~~root~~p></~~.vnc~~li><li>然后按照界面提示根据自己的喜好设置，再点击下一步</~~orangepi~~p>[[File:1zero2w-img185.~~log~~png]]</li><li>~~使用MobaXterm软件连接开发板linux系统桌面的步骤如下所示：~~然后点击下一步<~~ol style="list-style-type~~p>[[File: ~~lower~~zero2w-~~alpha;"~~img186.png]]</li><li>~~首先点击Session，然后选择VNC，再填写开发板的IP地址和端口，最后点击OK确认~~然后点击完成[[File:zero2w-img187.png]]</lip></olli></li>Home Assistant最终显示的主界面如下图所示</olp> [[File:~~media/image231~~zero2w-img188.png]]</li><li>停止Home Assistant容器的方法<ol ~~start="2"~~ style="list-style-type: lower-alpha;"><li>~~然后输入前面设置的VNC的密码~~查看docker容器的命令如下所示{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media~~~$ '''docker ps -a'''</~~image232.png]]~~p>|}</li><li>停止Home Assistant容器的命令如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''docker stop homeassistant'''|}</li><li>~~登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了~~删除Home Assistant容器的命令如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''docker rm homeassistant'''|}</li></ol></li></ol>

~~[[File:media/image233.png]]~~=== 通过python安装 ===

~~'''安装前请先更换下pip的源为国内源，加快Python包的安装速度，配置方法见[[Orange Pi Zero 2W#Python更换pip源的方法|Python更换pip源的方法]]一节的说明。'''</~~span~~big>~~== QT的安装方法 ==|}

<li>~~使用下面的脚本可以安装QT5和QT Creator~~首先安装依赖包{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~install_qt.sh'''</li><li>安装完后会自动打印QT的版本号<ol style="list-style-type: lower~~sudo apt-~~alpha;"><li>Ubuntu20.04自带的qt版本为'''5.12.8~~get update'''orangepi@orangepi:~$ '''~~install_qt.sh~~sudo apt-get install -y python3 python3-dev python3-venv \'''~~......QMake version 3.1Using Qt version~~ '''~~5.12.8~~python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential \''' ~~in /usr/lib/aarch64-linux-gnu~~</p~~></li~~>~~<li>~~~~Ubuntu22.04自带的QT版本为~~'''~~5.15.3~~libopenjp2-7 libtiff5 libturbojpeg0-dev tzdata'''~~orangepi@orangepi~~|}{| class="wikitable" style="background-color:#ffffdc;width:~~~$ '''install_qt.sh'''~~800px;" |-~~......~~| <~~p>QMake version 3.1</p~~big>~~Using Qt version~~ '''~~5.15.3~~如果是debian12请使用下面的命令：''' ~~in /usr/lib/aarch64-linux-gnu~~</libig>~~<li>~~~~Debian11自带的QT版本为~~orangepi@orangepi:~$ '''~~5.15.2~~sudo apt-get update'''orangepi@orangepi:~$ '''~~install_qt.sh~~sudo apt-get install -y python3 python3-dev python3-venv \'''~~......QMake version 3.1Using Qt version~~ '''~~5.15.2''' in /usr/lib/aarch64~~python3-pip libffi-dev libssl-dev libjpeg-dev zlib1g-~~linux~~dev autoconf build-~~gnu</li><li>Debian12自带的QT版本为'''5.15.8~~essential \'''~~orangepi@orangepi:~$~~ '''~~install_qt.sh~~libopenjp2-7 libturbojpeg0-dev tzdata'''~~......QMake version 3.1Using Qt version '''5.15.8''' in /usr/lib/aarch64-linux-gnu</li></ol>~~|}

</li>

<li>~~然后在'''Applications'''中就可以看到QT Creator的启动图标~~然后需要编译安装Python3.9，方法请参考[[~~File:media/image234.png]]也可以使用下面的命令打开QT Creatororangepi@orangepi:~$~~ Orange Pi Zero 2W#Python相关说明|'''~~qtcreator~~Python源码编译安装的方法'''~~</li><li>QT Creator打开后的界面如下所示[[File:media/image235.png~~]]一节</p~~></li~~>~~<li>QT Creator的版本如下所示<ol~~ {| class="wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~lower-alpha~~800px;">|-| <libig>~~QT Creator在~~'''~~Ubuntu20~~Debian Bullseye默认的Python版本就是Python3.049，所以无需编译安装。'''~~中的默认版本如下所示~~~~[[File:media/image236.png]]</li><li>QT Creator在~~'''~~Ubuntu22~~Ubuntu Jammy默认的Python版本就是Python3.0410，所以也无需编译安装。'''~~中的默认版本如下所示~~~~[[File:media/image237.png]]</li><li>QT Creator在~~'''~~Debian11~~Debian Bookworm默认的Python版本就是Python3.11，所以也无需编译安装。'''~~中的默认版本如下所示[[File:media/image238.png]]~~</libig>~~<li>QT Creator在'''Debian12'''中的默认版本如下所示[[File:media/image239.png]]</li></ol>~~|}

</li>

<li>~~然后设置下QT~~然后创建Python虚拟环境~~<ol~~ {| class="wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~lower-alpha~~800px;">|-| <libig>~~首先打开''~~'~~Help~~''~~'->'''About Plugins..~~Debian Bookworm中是python3.11，请记得替换对应的命令。'''<p/big>~~[[File~~|}{| class="wikitable" style="width:~~media/image240.png]]</li>~~800px;" |-| ~~<li>~~~~然后去掉~~orangepi@orangepi:~$ '''~~ClangCodeModel~~sudo mkdir /srv/homeassistant'''~~的那个勾~~~~[[File~~orangepi@orangepi:~$ '''sudo chown orangepi:~~media~~orangepi /srv/~~image241.png]]~~homeassistant'''</p~~></li~~>~~<li>~~orangepi@orangepi:~$ '''~~设置完后需要重启下QT Creator~~cd /srv/homeassistant'''~~</li><li>然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC~~orangepi@orangepi:~$ '''~~Debian12请跳过这步。~~python3.9 -m venv .'''~~[[File~~orangepi@orangepi:~~media~~~$ '''source bin/~~image242.png]]~~activate'''~~[[File~~(homeassistant) orangepi@orangepi:~~media~~/~~image243.png]]~~srv/homeassistant$~~</li></ol>~~|}</li><li>~~然后就可以打开一个示例代码~~然后安装需要的Python包{| class="wikitable" style="width:800px;" |-| ~~[[File~~(homeassistant) orangepi@orangepi:~~media~~/~~image244.png]]~~srv/homeassistant$ '''python3 -m pip install wheel'''|}</li><li>~~点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明~~然后就可以安装Home Assistant Core{| class="wikitable" style="width:800px;" |-| ~~[[File~~(homeassistant) orangepi@orangepi:~~media~~/~~image245.png]]<~~srv/~~li><li>然后点击下~~homeassistant$ '''~~Configure Project~~pip3 install homeassistant'''~~[[File:media/image246.png]]~~|}</li><li>~~然后点击左下角的绿色三角形编译运行下示例代码~~然后输入下面的命令就可以运行Home Assistant Core~~[[File~~{| class="wikitable" style="width:~~media/image247.png]]</li>~~800px;" |-~~<li>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行~~| ~~[[File~~(homeassistant) orangepi@orangepi:~~media~~/~~image248.png]]~~srv/homeassistant$ '''hass'''|}</li><li>~~参考资料[https://wiki.qt.io/Install_Qt_5_on_Ubuntu~~ 然后在浏览器中输入【'''~~https~~开发板的IP地址:~~//wiki.qt.io/Install_Qt_5_on_Ubuntu~~8123''']】就能看到Home Assistant的界面{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>~~[https://download.qt.io/archive/qtcreator~~ '''~~https://download.qt.io/archive/qtcreator~~第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。''']</big>|}[~~https~~[File:~~//download~~zero2w-img189.~~qt.io/archive/qt '''https://download.qt.io/archive/qt'''~~png]]</li></ol>

~~== ROS安装方法 ==~~

~~=== Ubuntu20.04安装ROS 1 Noetic的方法~~ =OpenCV的安装方法 ==

~~# ROS 1当前活跃的版本如下所示，推荐版本为'''Noetic Ninjemys'''~~=== 使用apt来安装OpenCV ===

~~[[File~~<ol style="list-style-type:~~media~~decimal;"><li>安装命令如下所示</~~image249.png]]~~p>{| class="wikitable" style="width:800px;" ~~[[File:media/image250.png]]~~|-| ~~[http~~orangepi@orangepi:~~//docs.ros.org/~~ ~$ '''~~http://docs.ros.org~~sudo apt-get update''']orangepi@orangepi:~$ '''~~https://wiki.ros.org/Distributions~~sudo apt-get install -y libopencv-dev python3-opencv'''|}</li><li>然后使用下面的命令打印OpenCV的版本号输出正常，说明OpenCV安装成功<ol ~~start="2"~~ style="list-style-type: ~~decimal~~lower-alpha;"><li>~~ROS 1~~ Ubuntu22.04中OpenCV的版本如下所示：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~Noetic Ninjemys~~python3 -c "import cv2; print(cv2.__version__)"'''~~官方安装文档链接如下所示：~~~~[http://wiki.ros.org/noetic/Installation/Ubuntu~~ '''~~http://wiki~~4.~~ros~~5.~~org/noetic/Installation/Ubuntu~~4''']|}</li><li>~~ROS~~ Ubuntu20.04中OpenCV的版本如下所示：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~Noetic Ninjemys~~python3 -c "import cv2; print(cv2.__version__)"'''~~官方安装文档中Ubuntu推荐使用Ubuntu20.04，所以请确保开发板使用的系统为~~'''~~Ubuntu20~~4.2.~~04桌面版系统~~0'''|}</li><li>Debian11中OpenCV的版本如下所示：{| class="wikitable" style="width:800px;" |-| ~~[http~~orangepi@orangepi:~~//wiki.ros.org/noetic/Installation~~ ~$ '''~~http://wiki~~python3 -c "import cv2; print(cv2.~~ros.org/noetic/Installation~~__version__)"''']~~[[File:media/image251~~'''4.5.~~png]]~~1'''|}</li><li>~~然后使用下面的脚本安装ros1~~Debian12中OpenCV的版本如下所示：{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~install_ros~~python3 -c "import cv2; print(cv2.~~sh ros1~~__version__)"''''''4.6.0'''</lip>|}</li>~~使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件~~</pol></li></ol>

~~'''注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。'''~~== 设置中文环境以及安装中文输入法 ==

{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''install_ros.sh脚本会尝试修改/etc/hosts并自动运行下面的命令。但是这种方法无法保证每次都能正常访问github，如果install_ros.sh安装完ros1后有提示下面的错误，请自己想其它办法让开发板的linux系统能正常访问github，然后再手动运行下面的命令。注意，安装中文输入法前请确保开发板使用的Linux系统为桌面版系统。'''</big>|}

~~'''https://raw.githubusercontent.com/ros/rosdistro/master/rosdep~~</~~osx-homebrew.yaml'''~~span>=== Debian 系统的安装方法 ===

<ol style="list-style-type: decimal;"><li>首先设置默认'''locale'''为中文<ol style="list-style-type: lower-alpha;"><li>输入下面的命令可以开始配置'''locale'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''|}</li><li>然后在弹出的界面中选择'''zh_CN.UTF-8 > UTF-8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''<OK>'''~~Hit https~~，然后回车即可）[[File:zero2w-img190.png]]</~~raw~~li><li>然后设置默认'''locale'''为'''zh_CN.~~githubusercontent~~UTF-8'''[[File:zero2w-img191.~~com~~png]]</~~ros~~li><li>退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''Generating locales (this might take a while)...en_US.UTF-8... donezh_CN.UTF-8... doneGeneration complete.|}</li></ol></li><li>然后打开'''Input Method'''[[File:zero2w-img192.png]]</li><li>然后选择'''OK'''[[File:zero2w-img193.png]]</li><li>然后选择'''Yes'''[[File:zero2w-img194.png]]</li><li>然后选择'''fcitx'''</~~rosdistro~~p>[[File:zero2w-img195.png]]</~~master~~p></~~rosdep~~li><li>然后选择'''OK'''</~~base~~p>[[File:zero2w-img196.~~yaml~~png]]</li><li>'''然后重启Linux系统才能使配置生效'''</li><li>然后打开'''Fcitx configuration'''[[File:zero2w-img197.png]]</li><li>然后点击下图所示位置的'''~~ERROR~~+'''号[[File: ~~error loading sources list~~zero2w-img198.png]]</li><li>然后搜索'''Google Pinyin'''再点击'''OK'''[[File:zero2w-img199.png]]</li><li>然后将'''Google Pinyin'''放到最前面[[File:zero2w-img200.png]][[File:zero2w-img201.png]]</li><li>然后打开'''~~The read operation timed out~~Geany'''这个编辑器测试下中文输入法[[File:zero2w-img202.png]]</li>~~orangepi@orangepi~~<li>中文输入法测试如下所示[[File:~$ zero2w-img203.png]]</li><li>通过'''Ctrl+Space'''~~source~~ 快捷键可以切换中英文输入法</~~opt~~p></li><li>如果需要整个系统都显示为中文，可以将'''/~~ros~~etc/~~noetic~~default/~~setup~~locale'''中的变量都设置为'''zh_CN.~~bash~~UTF-8'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''sudo ~~rosdep init~~vim /etc/default/locale'''# File generated by update-locale~~Wrote~~ LC_MESSAGES='''zh_CN.UTF-8</~~etc~~span>'''</~~ros~~p>LANG='''zh_CN.UTF-8</~~rosdep~~span>'''</~~sources~~p>LANGUAGE='''zh_CN.~~list.d~~UTF-8'''</~~20-default.list~~p>|}</li>~~Recommended~~<li>然后'''重启系统'''就能看到系统显示为中文了[[File:zero2w-img204.png]]</li></ol>

~~rosdep update~~

~~orangepi@orangepi:~$ '''rosdep update'''~~=== Ubuntu 20.04系统的安装方法 ===

~~reading in sources~~ <ol style="list ~~data from~~ -style-type: decimal;"><li>首先打开'''Language Support'''</~~etc~~p>[[File:zero2w-img205.png]]</~~ros~~p></~~rosdep~~li><li>然后找到'''汉语（中国）'''选项</~~sources~~p>[[File:zero2w-img206.png]]</li><li>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：[[File:zero2w-img207.png]]</li>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，这一步不是很好拖动的，请耐心多试几次。'''</big>|}</ol><ol start="4" style="list-style-type: decimal;"><li>然后选择'''Apply System-Wide'''将中文设置应用到整个系统[[File:zero2w-img208.png]]</li><li>然后设置'''Keyboard input method system'''为'''fcitx'''[[File:zero2w-img209.png]]</li><li>'''然后重启Linux系统使配置生效'''</li><li>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文[[File:zero2w-img210.png]]</li><li>然后可以看到桌面都显示为中文了[[File:zero2w-img211.png]]</li><li>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示[[File:zero2w-img212.dpng]]</li><li>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了[[File:zero2w-img213.png]]</li></ol>

~~Hit https://raw~~</~~master/rosdep/osx-homebrew.yaml~~span>

~~Hit https://raw~~=== Ubuntu 22.~~githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml~~04系统的安装方法 ===

~~Hit https~~<ol style="list-style-type:decimal;"><li>首先打开'''Language Support'''[[File:zero2w-img205.png]]</li><li>然后找到'''汉语（中国）'''选项[[File:zero2w-img214.png]]</li><li>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：</~~raw~~p>[[File:zero2w-img215.~~githubusercontent~~png]]</li>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意，这一步不是很好拖动的，请耐心多试几次。'''</big>|}</ol><ol start="4" style="list-style-type: decimal;"><li>然后选择'''Apply System-Wide'''将中文设置应用到整个系统[[File:zero2w-img216.~~com~~png]]</li><li>'''然后重启Linux系统使配置生效'''</~~ros~~p></~~rosdistro~~li><li>重新进入系统后，在下面的界面请选择'''不要再次询问我'''，然后请根据自己的喜好决定标准文件夹是否也要更新为中文</~~master~~p>[[File:zero2w-img210.png]]</~~rosdep~~p></~~python~~li><li>然后可以看到桌面都显示为中文了[[File:zero2w-img211.~~yaml~~png]]</li><li>然后打开Fcitx5配置程序[[File:zero2w-img217.png]]</li><li>然后选择使用拼音输入法[[File:zero2w-img218.png]]</li><li>选择后的界面如下所示，再点击确定即可[[File:zero2w-img219.png]]</li><li>然后我们可以打开'''Geany'''测试下中文输入法，打开方式如下图所示[[File:zero2w-img212.png]]</li><li>打开'''Geany'''后，默认还是英文输入法，我们可以通过'''Ctrl+Space'''快捷键来切换成中文输入法，然后就能输入中文了[[File:zero2w-img220.png]]</li></ol>

~~Hit https:~~</~~/raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml~~span>

~~Hit https://raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.yaml~~== 远程登录Linux系统桌面的方法 ==

~~Query rosdistro index https:~~</~~/raw.githubusercontent.com/ros/rosdistro/master/index-v4.yaml~~span>=== 使用NoMachine远程登录 ===

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

~~Skip end~~'''https://knowledgebase.nomachine.com/DT10R00166'''</big>|}{| class="wikitable" style="background-ofcolor:#ffffdc;width:800px;" |-| <big>'''NoMachine支持Windows、Mac、Linux、iOS和安卓平台，所以我们可以在多种设备上通过NoMachine来远程登录控制Orange Pi开发板。下面演示下在Windows中通过NoMachine来远程登录Orange Pi开发板的Linux系统桌面。其他平台的安装方法请参考下NoMachine的官方文档。'''</big>|}{| class="wikitable" style="background-~~life distro &quot~~color:#ffffdc;~~bouncy&quot~~width:800px;" |-| <big>'''操作前请先确保Windwos电脑和开发板在同一局域网内，并且能正常ssh登录开发板的Ubuntu或者Debian系统。'''</big>|}

~~Skip end~~<ol style="list-ofstyle-~~life distro~~ type: decimal;"><li>首先下载NoMachine软件Linux '''arm64''' deb版本的安装包，然后安装到开发板的Linux系统中<ol style="list-style-type: lower-alpha;"><li>由于H618是ARMv8架构的SOC，我们使用的系统为Ubuntu或者Debian，所以这里需要下载'''NoMachine &~~quot~~gt; for ARM ARMv8 DEB'''安装包，下载链接如下所示：</li>{| class="wikitable" style="background-color:#ffffdc;~~crystal~~width:800px;" |-| <big>'''注意，这个下载链接可能会变，请认准Armv8/Arm64版本的deb包。'''</big>|}{| class="wikitable" style="width:800px;" |-| [https://www.nomachine.com/download/download&~~quot~~id=112&s=ARM '''https://downloads.nomachine.com/download/?id=118&distro=ARM''']|}

~~Skip end~~[[File:zero2w-ofimg221.png]]</ol><ol start="2" style="list-~~life distro &quot~~style-type: lower-alpha;~~dashing&quot~~"><li>另外在'''官方工具'''中也可以下载到'''NoMachine'''的安装包[[File:zero2w-img222.png]]先进入'''远程登录软件-NoMachine'''文件夹[[File:zero2w-img223.png]]然后下载arm64版本的deb安装包[[File:zero2w-img224.png]]</li><li>然后将下载的'''nomachine_x.x.x_x_arm64.deb'''上传到开发板的Linux系统中</li><li>然后使用下面的命令在开发板的Linux系统中安装'''NoMachine'''{| class="wikitable" style="width:800px;" |-| ~~Skip end~~orangepi@orangepi:~$ '''sudo dpkg -ofi nomachine_x.x.x_x_arm64_arm64.deb'''|}</li></ol></li></ol><ol start="2" style="list-~~life distro "eloquent&quot~~style-type: decimal;"><li>然后下载NoMachine软件Windows版本的安装包，下载地址如下所示</li>~~Add distro &quot~~{| class="wikitable" style="background-color:#ffffdc;~~foxy&quot~~width:800px;" |-| ~~Add distro "galactic&quot~~<big>'''注意，这个下载链接可能会变。'''</big>|}{| class="wikitable" style="width:800px;" |-| '''https://downloads.nomachine.com/download/?id=9'''|}

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

~~Add distro "humble"~~

~~Skip end-of-life distro "hydro"~~=== 使用VNC远程登录 ===

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

~~Skip end-of-life distro "jade"~~'''Ubuntu20.04测试VNC很多问题，请不要使用这种方法。'''</big>|}

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

~~Skip end-of-life distro "lunar"~~

~~Add distro~~ Password: &~~quot~~nbsp;~~melodic~~&~~quot~~nbsp;     '''#在这里设置vnc的密码，8位字符'''Verify:        '''#在这里设置vnc的密码，8位字符'''Would you like to enter a view-only password (y/n)? '''n'''xauth: file /root/.Xauthority does not exist

~~Add distro "noetic"~~

~~Add distro "rolling"~~New 'X' desktop is orangepi:1

~~updated cache in /home/orangepi/.ros/rosdep/sources.cache~~

~~<ol start="6" style="list-style-type: decimal;"><li>~~~~然后在'''桌面'''中打开一个命令行终端窗口，再使用'''test_ros~~Creating default startup script /root/.~~sh'''脚本可以启动一个小海龟的例程来测试下ROS是否能正常使用~~vnc/xstartup~~orangepi@orangepi:~$ '''test_ros.sh'''<~~Starting applications specified in /~~p><~~root/~~li><li>运行完'''test_ros~~.~~sh'''脚本后，会弹出下图所示的一个小海龟~~vnc/xstartup~~[[File:media~~Log file is /root/~~image252~~.~~png]]<~~vnc/~~p></li><li>然后请保持刚才打开终端窗口在最上面~~orangepi:1.log</p~~></li></ol~~>

~~[[File:media/image253.png]]~~

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

~~~~

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

~~<ol style="list-style-type: decimal;"><li>~~~~ROS 2当前活跃的版本如下所示，推荐版本为'''Galactic Geochelone'~~New 'X'~~[[File:media/image255.png]][[File:media/image256.png]][http://docs.ros.org/ '''http://docs.ros.org''']'''http://docs.ros.org/en/galactic/Releases.html'''</li><li>ROS 2 '''Galactic Geochelone'''官方安装文档链接如下所示：'''docs.ros.org/en/galactic/Installation.html''''''http://docs.ros.org/en/galactic/Installation/Ubuntu-Install-Debians.html'''</li>~~<li>ROS 2 '''Galactic Geochelone'''官方安装文档中Ubuntu Linux推荐使用Ubuntu20.04，所以请确保开发板使用的系统为'''Ubuntu20.04桌面版系统'''。安装ROS 2有几种方法，下面演示下通过'''Debian packages'''的方式来安装ROS 2 '''Galactic Geochelone'''</li>~~<li>使用'''install_ros.sh'''脚本可以安装ros2orangepi@orangepi:~$ '''install_ros.sh ros2'''</li><li>'''install_ros.sh'''脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成usage: ros2 [-h] Call `ros2 <command> -h` for more detailed usage. ...ros2~~ desktop is ~~an extensible command-line tool for ROS 2.optional arguments:-h, --help show this help message and exitCommands:action Various action related sub-commandsbag Various rosbag related sub-commandscomponent Various component related sub-commandsdaemon Various daemon related sub-commandsdoctor Check ROS setup and other potential issuesinterface Show information about ROS interfaceslaunch Run a launch filelifecycle Various lifecycle related sub-commandsmulticast Various multicast related sub-commandsnode Various node related sub-commandsparam Various param related sub-commandspkg Various package related sub-commandsrun Run a package specific executablesecurity Various security related sub-commandsservice Various service related sub-commandstopic Various topic related sub-commandswtf Use `wtf` as alias to `doctor`Call `ros2 <command> -h` for more detailed usage.</li><li>然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行orangepi@~~orangepi~~:~$ '''test_ros.sh'''[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'[INFO] [1671174101.235661048] [listener]: I heard: [Hello World~~: 1~~][INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2][INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</li><li>运行下面的命令可以打开rviz2orangepi@orangepi:~$ '''source /opt/ros/galactic/setup.bash'''orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''[[File:media/image257.png]]</li><li>ROS的使用方法请参考下ROS 2的文档~~~~[http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.org/en/galactic/Tutorials.html''']</li></ol>~~

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

~~<ol style="list-style~~[[File:zero2w-~~type: decimal;"><li>使用'''install_ros~~img231.~~sh'''脚本可以安装ros2~~png]]~~orangepi@orangepi:~$ '''install_ros.sh ros2'''~~</~~p></li~~ol><~~li>'''install_ros.sh'''脚本安装完ros2后会自动运行下'''ros2 -h'''命令，如果能看到下面的打印，说明ros2安装完成usage: ros2 [-h] Call `ros2 <command> -h` for more detailed usage. ...ros2 is an extensible command-line tool for ROS~~ ol start="2~~.optional arguments:~~" style="list-h, style-~~-help show this help message and exitCommands~~type:~~action Various action related sub-commandsbag Various rosbag related sub-commandscomponent Various component related sub-commandsdaemon Various daemon related sub~~lower-~~commandsdoctor Check ROS setup and other potential issuesinterface Show information about ROS interfaceslaunch Run a launch filelifecycle Various lifecycle related sub-commandsmulticast Various multicast related sub-commandsnode Various node related sub-commandsparam Various param related sub-commandspkg Various package related sub-commandsrun Run a package specific executablesecurity Various security related sub-commandsservice Various service related sub-commandstopic Various topic related sub-commandswtf Use `wtf` as alias to `doctor`Call `ros2 &lt~~alpha;~~command> -h` for more detailed usage.</li~~"><li>~~然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行orangepi@orangepi:~$ '''test_ros.sh'''[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1][INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2][INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]</li><li>运行下面的命令可以打开rviz2orangepi@orangepi:~$ '''source /opt/ros/humble/setup.bash'''orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''~~然后输入前面设置的VNC的密码[[File:~~media/image258~~zero2w-img232.png]]</li><li>~~参考文档'''http://docs.ros.org/en/humble/index.html'''[http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html''']~~登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了</li~~></ol~~>

[[File:zero2w-img233.png]]</ol></li></ol>

~~'''Linux6.1内核的Debian11系统编译内核模块时会报GCC的错误。所以如果要编译内核模块请使用Debian12或者Ubuntu22.04。'''~~== QT的安装方法 ==

<li>~~OPi发布的Linux镜像默认自带了内核头文件的deb包，存放的位置为'''/opt/'''~~使用下面的脚本可以安装QT5和QT Creator~~orangepi@orangepi:~$ '''ls /opt/linux-headers*'''/opt/linux-headers-xxx-sun50iw9_x.x.x_arm64.deb</li><li>使用下面的命令可以安装内核头文件的deb包orangepi@orangepi:~$ '''sudo dpkg -i /opt/linux-headers*.deb'''</li><li>安装完后在'''/usr/src'''下就能看到内核头文件所在的文件夹orangepi@orangepi:~$ '''ls /usr/src'''linux-headers-x.x.x</li><li>然后可以编译下Linux镜像中自带的hello内核模块的源码，hello模块的源码在'''/usr/src/hello'''中，进入此目录后，然后使用make命令编译即可。orangepi@orangepi:~$ '''cd /usr/src/hello/'''orangepi@orangepi:/usr/src/hello$ '''sudo make'''make -C /lib/modules/5.4.125/build M=/usr/src/hello modulesmake[1]: Entering directory '/usr/src/linux-headers-5.4.125'CC [M] /usr/src/hello/hello.oBuilding modules, stage 2.MODPOST 1 modulesCC [M] /usr/src/hello/hello.mod.oLD [M] /usr/src/hello/hello.komake[1]: Leaving directory '/usr/src/linux-headers-5.4.125'</li><li>编译完后会生成'''hello.ko'''内核模块orangepi@orangepi:/usr/src/hello$ '''ls *.ko'''hello.ko</li><li>使用'''insmod'''命令可以将'''hello.ko'''内核模块插入内核中orangepi@orangepi:/usr/src/hello$ '''sudo insmod hello.ko'''</li><li>然后使用'''demsg'''命令可以查看下'''hello.ko'''内核模块的输出，如果能看到下面的输出说明'''hello.ko'''内核模块加载正确orangepi@orangepi:/usr/src/hello$ '''dmesg | grep "Hello"'''[ 2871.893988] '''Hello Orange Pi -- init'''</li><li>使用'''rmmod'''命令可以卸载'''hello.ko'''内核模块orangepi@orangepi:/usr/src/hello$ '''sudo rmmod hello'''orangepi@orangepi:/usr/src/hello$ '''dmesg~~ {| ~~grep "Hello"'''[ 2871.893988] Hello Orange Pi -- init[ 3173.800892] '''Hello Orange Pi -- exit'''</li></ol>~~ ~~== Linux系统支持的部分编程语言测试 ==~~ ~~=== Debian Bullseye系统 ===~~ ~~<ol~~ style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>Debian Bullseye默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list~~|-~~style-type: lower-alpha;"><li>gcc的版本如下所示~~| orangepi@orangepi:~$ '''~~gcc --version'''gcc (Debian 10.2.1-6) 10.2.1 20210110Copyright (C) 2020 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE~~install_qt.~~</li><li>编写C语言的'''hello_world.c~~sh'''程序~~orangepi@orangepi:~$ '''vim hello_world.c'''#include <stdio.h>int main(void){printf("Hello World!\n");return 0;~~|}~~</li><li>然后编译运行'''hello_world.c'''orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''orangepi@orangepi:~$ '''./hello_world'''Hello World!</li></ol>~~

</li>

<li>~~Debian Bullseye默认安装有Python3~~安装完后会自动打印QT的版本号

<li>~~Python具体版本如下所示~~Ubuntu20.04自带的qt版本为'''5.12.8'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3~~install_qt.sh'''......QMake version 3.1Using Qt version '''~~Python 3~~5.912.28''' ~~(default, Feb 28 2021, 17:03:44)~~in /usr/lib/aarch64-linux-gnu|}</li><li>~~[GCC 10~~Ubuntu22.04自带的QT版本为'''5.15.23'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''install_qt.~~1 20210110] on linux~~sh'''~~Type "help", "copyright", "credits" or "license" for more information~~......~~>>>~~QMake version 3.1Using Qt version '''~~使用Ctrl+D快捷键可退出python的交互模式。~~5.15.3'''in /usr/lib/aarch64-linux-gnu|}</li><li>~~编写Python语言的~~Debian11自带的QT版本为'''~~hello_world~~5.py15.2'''程序{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~vim hello_world~~install_qt.pysh'''~~print(~~......QMake version 3.1Using Qt version ''~~Hello World!~~')5.15.2''' in /usr/lib/aarch64-linux-gnu|}</li><li>运行Debian12自带的QT版本为'''~~hello_world~~5.py15.8'''~~的结果如下所示~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~python3 hello_world~~install_qt.pysh'''~~Hello World!~~......QMake version 3.1Using Qt version '''5.15.8''' in /usr/lib/aarch64-linux-gnu</li>|}</ol></li><li>然后在'''Applications'''中就可以看到QT Creator的启动图标[[File:zero2w-img234.png]]也可以使用下面的命令打开QT Creator{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''qtcreator'''|}

</li>

<li>~~Debian Bullseye默认没有安装Java的编译工具和运行环境~~QT Creator打开后的界面如下所示[[File:zero2w-img235.png]]</li><li>QT Creator的版本如下所示

<li>~~可以使用下面的命令安装openjdk，Debian > Bullseye中最新版本为openjdk-17orangepi@orangepi:~$~~ QT Creator在'''~~sudo apt install -y openjdk-17-jdk~~Ubuntu20.04'''中的默认版本如下所示</p~~></li~~>~~<li>~~~~安装完后可以查看下Java的版本orangepi@orangepi~~[[File:~~~$ '''java~~ zero2w-~~-version'''</li><li>编写Java版本的'''hello_world~~img236.~~java'''orangepi@orangepi:~$ '''vim hello_world.java'''public class hello_world{public static void main(String[~~png]] ~~args){System.out.println("Hello World!");}}~~</li><li>~~然后编译运行~~QT Creator在'''~~hello_world~~Ubuntu22.~~java~~04'''中的默认版本如下所示~~orangepi@orangepi~~[[File:~~~$ '''javac hello_world.java'''orangepi@orangepi:~$ '''java hello_world'''Hello World!</li></ol></li></ol>~~ ~~=== Debian Bookworm系统 ===~~ ~~<ol style="list-style-type: decimal;"><li>Debian Bookworm默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type: lower-alpha;"><li>gcc的版本如下所示orangepi@orangepi:~$ '''gcc --version'''gcc (Debian 12.2.0-14) 12.2.0Copyright (C) 2022 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE~~img237.png]]</li><li>~~编写C语言的~~QT Creator在'''~~hello_world.c~~Debian11'''程序中的默认版本如下所示~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero2w-img238.~~c'''#include <stdio.h>int main(void){printf("Hello World!\n");return 0;}~~png]]</li><li>~~然后编译运行~~QT Creator在'''~~hello_world.c~~Debian12'''中的默认版本如下所示~~orangepi@orangepi~~[[File:~~~$ '''gcc~~ zero2w-~~o hello_world hello_world~~img239.~~c'''orangepi@orangepi:~$ '''./hello_world'''Hello World!~~png]]</li></ol>

</li>

<li>~~Debian Bookworm默认安装有Python3~~然后设置下QT

<li>~~Python具体版本如下所示orangepi@orangepi:~$~~ 首先打开'''Help'''~~python3~~->'''About Plugins...'''~~Python 3.11.2 (main, Mar 13 2023, 12:18~~[[File:~~29) [GCC 12~~zero2w-img240.~~2.0~~png]] ~~on linux~~<p/li>~~Type "help", "copyright", "credits" or "license" for more information.~~</pli>~~>>>~~然后去掉'''ClangCodeModel'''的那个勾~~'''使用Ctrl+D快捷键可退出python的交互模式。'''~~[[File:zero2w-img241.png]]</li><li>~~编写Python语言的'''hello_world.py~~'''程序</pspan style="color:#FF0000">设置完后需要重启下QT Creator<p/span>~~orangepi@orangepi:~$ '''vim hello_world.py~~'''</li><pli>~~print('Hello World!')~~然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC</lip>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <libig>运行'''~~hello_world.py~~Debian12请跳过这步。'''~~的结果如下所示~~</big>|}~~orangepi@orangepi~~[[File:~~~$ '''python3 hello_world~~zero2w-img242.~~py'''~~png]]~~Hello World!~~[[File:zero2w-img243.png]]</li></ol>

</li>

<li>~~Debian Bookworm默认没有安装Java的编译工具和运行环境~~然后就可以打开一个示例代码~~<ol style="list-style-type: lower-alpha;"><li>~~~~可以使用下面的命令安装openjdk，Debian > Bookworm中最新版本为openjdk-17orangepi@orangepi~~[[File:~~~$ '''sudo apt install~~ zero2w-~~y openjdk-17-jdk'''~~img244.png]]</li><li>~~安装完后可以查看下Java的版本~~点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明~~orangepi@orangepi~~[[File:~~~$ '''java~~ zero2w-~~-version'''~~img245.png]]</li><li>~~编写Java版本的~~然后点击下'''~~hello_world.java~~Configure Project'''~~orangepi@orangepi~~[[File:~~~$ '''vim hello_world~~zero2w-img246.~~java'''~~png]]<p/li>~~public class hello_world~~</pli>{然后点击左下角的绿色三角形编译运行下示例代码~~public static void main(String~~[[File:zero2w-img247.png]] ~~args)~~</li><li>{等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行~~System~~[[File:zero2w-img248.~~out.println("Hello World!");~~png]]~~}~~</pli><pli>}参考资料</lip>~~<li>~~{| class="wikitable" style="width:800px;" |-| ~~然后编译运行~~[https://wiki.qt.io/Install_Qt_5_on_Ubuntu '''~~hello_world~~https://wiki.qt.~~java~~io/Install_Qt_5_on_Ubuntu''']~~orangepi@orangepi~~[https:~$ //download.qt.io/archive/qtcreator '''~~javac hello_world~~https://download.~~java~~qt.io/archive/qtcreator''']~~orangepi@orangepi~~[https:~$ //download.qt.io/archive/qt '''~~java hello_world~~https://download.qt.io/archive/qt''']~~Hello World!</li></ol>~~|}

</li></ol>

== ROS安装方法 == === ~~Ubuntu Focal系统~~ Ubuntu20.04安装ROS 1 Noetic的方法 ===

~~<ol style="list-style-type: decimal;"><li>Ubuntu Focal默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type: lower-alpha;"><li>gcc的版本如下所示orangepi@orangepi:~$ '''gcc --version'''gcc (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.0Copyright (C) 2019 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</li><li>编写C语言的'''hello_world.c'''程序orangepi@orangepi:~$ '''vim hello_world.c'''~~#~~include <stdio.h>int main(void){printf("Hello World!\n");return 0;}</li><li>然后编译运行'''hello_world.c'''orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''orangepi@orangepi:~$ '''./hello_world'''Hello World!</li></ol></li><li>Ubuntu Focal默认安装有Python3<ol style="list-style-type: lower-alpha;"><li>Python3具体版本如下所示orangepi@orangepi:~$ '''python3'''Python 3.8.10 (default, Nov 14 2022, 12:59:47)[GCC 9.4.0] on linuxType "help", "copyright", "credits" or "license" for more information.>>>'''使用Ctrl+D快捷键可退出python的交互模式。'''</li><li>编写Python语言的'''hello_world.py'''程序orangepi@orangepi:~$ '''vim hello_world.py'''print('Hello World!')</li><li>运行'''hello_world.py'''的结果如下所示orangepi@orangepi:~$ '''python3 hello_world.py'''Hello World!</li></ol></li><li>Ubuntu Focal默认没有安装Java的编译工具和运行环境<ol style="list-style-type: lower-alpha;"><li>可以使用下面的命令安装openjdk-17orangepi@orangepi:~$ '''sudo apt install -y openjdk-17-jdk'''</li><li>安装完后可以查看下Java的版本orangepi@orangepi:~$ '''java --version'''openjdk 17.0.2 2022-01-18OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.04)OpenJDK 64-Bit Server VM (build 17.0.2+8-Ubuntu-120.04, mixed mode, sharing)</li><li>编写Java版本的'''hello_world.java'''orangepi@orangepi:~$ '''vim hello_world.java'''public class hello_world{public static void main(String[] args){System.out.println("Hello World!");}}</li><li>然后编译运行'''hello_world.java'''orangepi@orangepi:~$ '''javac hello_world.java'''orangepi@orangepi:~$~~ ROS 1当前活跃的版本如下所示，推荐版本为'''~~java hello_world~~Noetic Ninjemys'''~~Hello World!</li></ol></li></ol>~~

~~=== Ubuntu Jammy系统 ===~~img249.png]]

~~<ol style="list-style-type~~: ~~decimal;"><li>Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type~~: ~~lower-alpha;"><li>gcc的版本如下所示orangepi@orangepi~~[[File:~~~$ '''gcc --version'''gcc (Ubuntu 11.3.0~~zero2w-~~1ubuntu1~22.04.1) '''11.3.0'''Copyright (C) 2021 Free Software Foundation, Inc~~img250.~~This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</li><li>编写C语言的'''hello_world.c'''程序orangepi@orangepi:~$ '''vim hello_world.c'''#include <stdio.h>int main(void){printf("Hello World!\n");return 0;}</li><li>然后编译运行'''hello_world.c'''orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''orangepi@orangepi:~$ '''./hello_world'''Hello World!</li></ol></li><li>Ubuntu Jammy默认安装有Python3<ol style="list-style-type: lower-alpha;"><li>Python3具体版本如下所示orangepi@orangepi:~$ '''python3'''Python 3.10.6 (main, May 29 2023, 11:10:38) [GCC 11.3.0~~png] ~~on linuxType "help", "copyright", "credits" or "license" for more information.>>>'''使用Ctrl+D快捷键可退出python的交互模式。'''</li><li>编写Python语言的'''hello_world.py'''程序orangepi@orangepi:~$ '''vim hello_world.py'''print('Hello World!')</li><li>运行'''hello_world.py'''的结果如下所示orangepi@orangepi:~$ '''python3 hello_world.py'''Hello World!</li></ol></li><li>Ubuntu Jammy默认没有安装Java的编译工具和运行环境<ol style="list-style-type: lower-alpha;"><li>可以使用下面的命令安装openjdk-18orangepi@orangepi:~$ '''sudo apt install -y openjdk-18-jdk'''</li><li>安装完后可以查看下Java的版本orangepi@orangepi:~$ '''java --version'''openjdk 18.0.2-ea 2022-07-19OpenJDK Runtime Environment (build 18.0.2-ea+9-Ubuntu-222.04)OpenJDK 64-Bit Server VM (build 18.0.2-ea+9-Ubuntu-222.04, mixed mode, sharing)</li><li>编写Java版本的'''hello_world.java'''orangepi@orangepi:~$ '''vim hello_world.java'''public class hello_world{public static void main(String[~~] ~~args){System.out.println("Hello World!");}}</li><li>然后编译运行'''hello_world.java'''orangepi@orangepi:~$ '''javac hello_world.java'''orangepi@orangepi:~$ '''java hello_world'''Hello World!</li></ol></li></ol>~~

~~<style="width:800px;" |-| [http://~~span>== 上传文件到开发板Linux系统中的方法 ==docs.ros.org/ '''http://docs.ros.org''']

~~<~~'''https:/~~span>~~/wiki.ros.org/Distributions'''~~=== 在Ubuntu PC中上传文件到开发板Linux系统中的方法 ===~~|}

~~==== 使用scp命令上传文件的方法 ====~~ <ol start="2" style="list-style-type: decimal;"><li>~~使用scp命令可以在Ubuntu PC中上传文件到开发板的Linux系统中，具体命令如下所示~~ROS 1 '''Noetic Ninjemys'''官方安装文档链接如下所示：~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>~~|-| [http://wiki.ros.org/noetic/Installation/Ubuntu '''~~file_path：~~http://wiki.ros.org/noetic/Installation/Ubuntu'''~~需要替换为要上传文件的路径~~]|}</li><li>ROS '''Noetic Ninjemys'~~orangepi：~~''官方安装文档中Ubuntu推荐使用Ubuntu20.04，所以请确保开发板使用的系统为'~~为开发板linux系统的用户名，也可以替换成其它的，比如root~~''Ubuntu20.04桌面版系统</pspan>'''</lip>~~<li>~~{| class="wikitable" style="width:800px;" |-| [http://wiki.ros.org/noetic/Installation '''~~192~~http://wiki.~~168~~ros.~~xx.xx:~~org/noetic/Installation''' ~~为开发板的IP地址，请根据实际情况进行修改~~]|}[[File:zero2w-img251.png]]</li><li>~~'''/home/orangepi:''' > 开发板linux系统中的路径，也可以修改为其它的路径~~然后使用下面的脚本安装ros1{| class="wikitable" style="width:800px;" |-| ~~test~~orangepi@~~test~~orangepi:~$ '''~~scp file_path orangepi@192.168.xx~~install_ros.~~xx:/home/orangepi/~~sh ros1'''~~</li></ol>~~|}

</li>

<li>~~如果要上传文件夹，需要加上-r参数~~使用ROS工具前，首先需要初始化下rosdep，然后编译源码时就能快速的安装一些系统依赖和一些ROS中的核心组件<p/li>~~test@test~~{| class="wikitable" style="background-color:~~~$ '''scp~~ #ffffdc;width:800px;" |-~~r dir_path orangepi@192.168.xx.xx:/home/orangepi/~~| <big>'''</pspan style="color:#FF0000">注意，运行下面的命令需要确保开发板能正常访问github，否则会由于网络问题而报错。</~~li><li>scp还有更多的用法，请使用下面的命令查看man手册</li></ol~~span>'''

~~test@test:~$ '''man scp'''~~

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

~~<ol style="list-style-type: decimal;">~~

~~<li>首先在Ubuntu PC中安装filezilla~~

~~test@test:~$ '''sudo apt install -y filezilla'''</li>~~

~~<li>然后使用下面的命令打开filezilla~~

~~test@test:~$ '''filezilla'''</li>~~

~~<li>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的~~

~~<div class="figure">~~

~~[[File~~'''https:~~media~~/~~image259~~/raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.~~png]]~~yaml'''

<'''Hit https:/~~div><~~/~~li><li>连接开发板的方法如下图所示<~~raw.githubusercontent.com/~~p><~~ros/~~li><~~rosdistro/~~ol>~~master/rosdep/base.yaml'''

'''<~~div class~~span style="~~figure~~color:#FF0000">ERROR: error loading sources list:'''

~~[[File~~:~~media~~:'''The read operation timed out'''</big>|}{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''source /opt/ros/noetic/~~image260~~setup.~~png]]~~bash'''

~~</div><ol start="5" style="list-style-type~~orangepi@orangepi: ~~decimal;"><li>然后选择~~~$ '''~~保存密码~~sudo rosdep init'''~~，再点击'''确定'''[[File:media/image261.png]]</li><li>然后选择'''总是信任该主机'''，再点击'''确定'''</li></ol>~~

~~<div class="figure">~~Wrote /etc/ros/rosdep/sources.list.d/20-default.list

~~[[File~~Recommended:~~media/image262.png]]~~please run

~~</div>~~

~~<ol start="7" style="list-style-type: decimal;">~~

~~<li>连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了</li></ol>~~

~~<div class="figure">~~::rosdep update

~~[[File~~orangepi@orangepi:~~media/image263.png]]~~~$ '''rosdep update'''

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

~~<div class="figure">~~Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml

~~[[File~~Hit https:~~media~~/~~image264~~/raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.~~png]]~~yaml

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

~~<~~Hit https:/~~span>~~/raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml ~~=== 在Windows PC中上传文件到开发板Linux系统中的方法 ===~~Hit https://raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.yaml

~~==== 使用filezilla上传文件的方法 ====~~v4.yaml

~~# 首先下载filezilla软件Windows版本的安装文件，下载链接如下所示~~Skip end-of-life distro "ardent"

~~[https://filezilla~~Skip end-~~project.org/download.php?type=client '''https://filezilla~~of-~~project.org/download.php?type=client''']~~life distro "bouncy"

~~[[File:media/image265.png]]~~Skip end-of-life distro "crystal"

~~[[File:media/image266.png]]~~Skip end-of-life distro "dashing"

~~<ol start="2" style="list~~Skip end-~~style~~of-~~type: decimal~~life distro "eloquent"">~~<li>下载的安装包如下所示，然后双击直接安装即可'''FileZilla_Server_1.5.1_win64-setup.exe'''</li></ol>~~

~~安装过程中，下面的安装界面请选择'''Decline'''，然后再选择'''Next~~Add distro &gtquot;foxy"~~'''~~

~~<div class="figure">~~Add distro "galactic"

~~[[File:media/image267.png]]~~Skip end-of-life distro "groovy"

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

~~<div class="figure">~~Skip end-of-life distro "hydro"

~~[[File:media/image268.png]]~~Skip end-of-life distro "indigo"

~~</div><ol start="4" style="list~~Skip end-~~style~~of-~~type: decimal~~life distro "jade"">~~<li>连接开发板的方法如下图所示：</li></ol>~~

~~<div class="figure">~~Skip end-of-life distro "kinetic"

~~[[File:media/image269.png]]~~Skip end-of-life distro "lunar"

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

~~<div class="figure">~~Add distro "noetic"

~~[[File:media/image270.png]]~~Add distro "rolling"

updated cache in /home/orangepi/.ros/rosdep/sources.cache|}</~~div~~ol>

<li>~~然后选择~~然后在'''桌面'''中打开一个命令行终端窗口，再使用'''test_ros.sh'''脚本可以启动一个小海龟的例程来测试下ROS是否能正常使用{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~总是信任该主机~~test_ros.sh'''~~，再点击~~|}</li><li>运行完'''确定test_ros.sh'''脚本后，会弹出下图所示的一个小海龟[[File:zero2w-img252.png]]</li><li>然后请保持刚才打开终端窗口在最上面</olli>

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

~~[[File:media~~</~~image271.png]]~~span>

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

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

~~[[File:media/image272.png]]~~

<~~/div~~p>~~<ol start="8" style="list~~ros2 is an extensible command-~~style-type: decimal;">~~<li>然后在filezilla软件的右边选择要上传到开发板中的路径，再在filezilla软件的左边选中Windows PC中要上传的文件，再点击鼠标右键，再点击上传选项就会开始上传文件到开发板中了</li>line tool for ROS 2.</olp>

~~<div class="figure">~~

~~[[File~~optional arguments:~~media~~</~~image273.png]]~~p>:-h, --help show this help message and exit

~~</div>~~

~~<ol start="9" style="list-style-type: decimal;">~~

~~<li>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</li>~~

~~<li>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</li></ol>~~

~~== 开关机logo使用说明 ==~~ <~~ol style="list-style-type~~p>Commands: ~~decimal;"~~:<lip>action Various action related sub-commands~~开关机logo默认只在桌面版的系统中才会显示~~:bag Various rosbag related sub-commands</lip>~~<li>~~:~~在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''false'''可以关闭开关机logo~~component Various component related sub-commands:~~orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''~~daemon Various daemon related sub-commands:~~verbosity=1~~doctor Check ROS setup and other potential issues:~~'''bootlogo=false'''~~interface Show information about ROS interfaces:launch Run a launch file</lip>~~<li>~~:~~在'''/boot/orangepiEnv.txt'''中设置'''bootlogo'''变量为'''true'''可以开启开关机logo~~lifecycle Various lifecycle related sub-commands:~~orangepi@orangepi:~$ '''sudo vim /boot/orangepiEnv.txt'''~~multicast Various multicast related sub-commands:~~verbosity=1~~node Various node related sub-commands:~~'''bootlogo=true'''~~param Various param related sub-commands:pkg Various package related sub-commands</lip>~~<li>~~:~~开机logo图片在linux系统中的位置为~~run Run a package specific executable:~~'''/usr/share/plymouth/themes/orangepi/watermark.png'''~~security Various security related sub-commands</p~~></li~~>~~<li>~~:~~替换开机logo图片后需要运行下命令才能生效~~service Various service related sub-commands:~~orangepi@orangepi:~$ '''sudo update-initramfs~~ topic Various topic related sub-~~u'''~~commands:<~~/li~~p>wtf Use `wtf` as alias to `doctor`</olp>

~~~~

~~== Linux5.4打开开关机按键的方法 ==~~

~~开发板主板上没有开关机按键，我们可以通过24pin扩展板来扩展。开关机按键在扩展板上的位置如下所示：~~:Call `ros2 <command> -h` for more detailed usage.|}</li><li>然后可以使用 '''test_ros.sh'''脚本测试下ROS 2是否安装成功，如果能看到下面的打印，说明ROS 2能正常运行{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''test_ros.sh'''[INFO] [1671174101.200091527] [talker]: Publishing: 'Hello World: 1'[INFO] [1671174101.235661048] [listener]: I heard: [Hello World: 1][INFO] [1671174102.199572327] [talker]: Publishing: 'Hello World: 2'[INFO] [1671174102.204196299] [listener]: I heard: [Hello World: 2][INFO] [1671174103.199580322] [talker]: Publishing: 'Hello World: 3'[INFO] [1671174103.204019965] [listener]: I heard: [Hello World: 3]|}</li><li>运行下面的命令可以打开rviz2{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''source /opt/ros/galactic/setup.bash'''orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''[[File:~~media/image274~~zero2w-img257.png]]|}</li><li>ROS的使用方法请参考下ROS 2的文档{| class="wikitable" style="width:800px;" ~~Linux6~~|-| [http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.~~1镜像开关机按键默认是打开的，但Linux5~~org/en/galactic/Tutorials.~~4内核镜像的开关机按键默认是关闭的，需要手动打开才能正常使用。步骤如下所示：~~html''']|}</li></ol>

<~~ol style~~span id="~~list~~ubuntu22.04安装ros-~~style~~2-~~type: decimal;~~humble的方法">~~<li>首先运行下'''orangepi-config'''，普通用户记得加'''sudo'''权限orangepi@orangepi:~$ '''sudo orangepi-config'''</li><li>然后选择'''System'''[[File:media/image81.png]]</li><li>然后选择'''Hardware'''[[File:media/image82.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的SPI的dtbo配置[[File:media/image275.png]]</li><li>然后选择'''<Save>'''保存[[File:media/image84.png]]</li><li>然后选择'''<Back>'''[[File:media/image85.png]]</li><li>然后选择'''<Reboot>'''重启系统使配置生效[[File:media/image86.png]]</li~~></olspan>

== ~~关机和重启开发板的方法~~ = Ubuntu22.04安装ROS 2 Humble的方法 ===

<li>~~在Linux系统运行的过程中，如果直接拔掉电源断电，可能会导致文件系统丢失某些数据，建议断电前先使用~~使用'''~~poweroff~~install_ros.sh'''~~命令关闭开发板的Linux系统，然后再拔掉电源~~脚本可以安装ros2{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~sudo poweroff~~install_ros.sh ros2'''~~'''注意，关闭开发板后需要重新拔插电源才能开机。'''~~|}</li><li>~~除了使用poweroff命令关机外，还可以使用扩展板上的开关机按键来关机[[File:media/image274.png]]~~'''~~注意，Linux5~~install_ros.~~4需要手动打开开关机按键的配置才能使用。打开方法请参考[[\l|Linux5.4打开开关机按键的方法]]。~~sh'''~~</li><li>使用~~脚本安装完ros2后会自动运行下'''~~reboot~~ros2 -h'''~~命令即可重启开发板中的Linux系统~~命令，如果能看到下面的打印，说明ros2安装完成{| class="wikitable" style="width:800px;" |-| ~~orangepi@orangepi~~usage:~~~$ '''sudo''' '''reboot'''~~ros2 [-h] Call `ros2 <command> -h` for more detailed usage. ...</p~~></li></ol~~>

~~~~

~~= '''Linux SDK——orangepi~~ros2 is an extensible command-~~build使用说明''' =~~line tool for ROS 2.

~~== 编译系统需求 ==~~

~~Linux SDK，即'''orangepi~~optional arguments::-~~build'''，只支持在安装有'''Ubuntu 22.04'''的X64电脑上运行，所以下载orangepi~~h, -build前，请首先确保自己电脑已安装的Ubuntu版本是Ubuntu 22.04。查看电脑已安装的Ubuntu版本的命令如下所示，如果Release字段显示的不是'''22.04'''，说明当前使用的Ubuntu版本不符合要求，请更换系统后再进行下面的操作。-help show this help message and exit

~~test@test:~$ '''lsb_release -a'''~~

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

~~Distributor ID: Ubuntu~~

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

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

~~[https~~{| class="wikitable" style="background-color:#ffffdc;width:~~//repo.huaweicloud.com/ubuntu~~800px;" |-~~releases/21.04/ubuntu-21.04-desktop-amd64.iso~~ | <big>'''~~https~~Linux6.041</~~ubuntu-22~~span>内核的Debian11系统编译内核模块时会报GCC的错误。所以如果要编译内核模块请使用Debian12或者Ubuntu22.~~04-desktop-amd64.iso~~04。''']</big>|}

在电脑中或者虚拟机中安装完Ubuntu 22.04后，请先设置Ubuntu 22.04的软件源为清华源（或者其它你觉得速度快的国内源），不然后面安装软件的时候很容易由于网络原因而出错。替换清华源的步骤如下所示： <ol style="list-style-type: ~~lower-alpha~~decimal;"><li>~~替换清华源的方法参考这个网页的说明即可。~~<~~/li></ol~~p> ~~[https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/~~ OPi发布的Linux镜像默认自带了内核头文件的deb包，存放的位置为'''~~https://mirrors.tuna.tsinghua.edu.cn/help~~/~~ubuntu~~opt/'''] ~~<ol start~~{| class="2wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>注意Ubuntu版本需要切换到22.04。~~|-~~[[File:media/image276.png]]</li>~~| ~~<li>~~~~需要替换的'''/etc/apt/sources.list'''文件的内容为：test~~orangepi@~~test~~orangepi:~$ '''~~sudo mv~~ ls /~~etc~~opt/~~apt/sources.list cat /etc/apt/sources.list.bak~~linux-headers*'''~~test@test:~$ '''sudo vim~~ /~~etc~~opt/~~apt/sources.list'''# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse# deb~~linux-~~src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy~~headers-~~updates main restricted universe multiverse# deb~~xxx-~~src https://mirrors.tuna~~sun50iw9_x.~~tsinghua~~x.~~edu~~x_arm64.~~cn/ubuntu/ jammy-updates main restricted universe multiverse~~deb ~~https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse~~~~# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse~~|}<~~p>deb https:~~/~~/mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse</p~~li><~~p># deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse</p~~li>~~# 预发布软件源，不建议启用~~使用下面的命令可以安装内核头文件的deb包~~# deb https~~{| class="wikitable" style="width:~~//mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse~~800px;" ~~# deb~~|-~~src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse</li><li>替换完后需要更新下包信息，并确保没有报错。~~| ~~test~~orangepi@~~test~~orangepi:~$ '''sudo ~~apt~~dpkg -i /opt/linux-~~get update~~headers*.deb'''|}</li><li>安装完后在'''~~另外，由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。~~/usr/src'''下就能看到内核头文件所在的文件夹~~</li></ol>~~ ~~== 获取linux sdk的源码 ==~~ ~~=== 从github下载orangepi-build ===~~ linux sdk指的是orangepi-build这套代码，orangepi-build是基于armbian build编译系统修改而来的，使用orangepi-build可以编译出多个版本的linux镜像。使用下面的命令可以下载orangepi-build的代码： ~~test@test:~$ '''sudo apt-get update'''~~ ~~test@test:~$ '''sudo apt-get install -y git'''~~ ~~test@test:~$ '''git clone https://github.com/orangepi-xunlong/orangepi-build.git -b next'''~~ ~~'''注意，使用H618 Soc的开发板是需要下载orangepi-build的next分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。'''~~ ~~[[File:media/image277.png]]~~ '''通过git clone命令下载orangepi-build的代码是不需要输入github账号的用户名和密码的（下载本手册中的其他代码也是一样的），如果如输入git clone命令后Ubuntu PC提示需要输入github账号的用户名和密码，一般都是git clone后面的orangepi-build仓库的地址输入错误了，请仔细检查命令拼写是否有错误，而不是以为我们这里忘了提供github账号的用户名和密码。''' ~~H618系列开发板当前使用的u-boot和linux内核版本如下所示：~~ {| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''分支ls /usr/src'''linux-headers-x.x.x| }</li><li>然后可以编译下Linux镜像中自带的hello内核模块的源码，hello模块的源码在'''~~u-boot版本~~/usr/src/hello'''中，进入此目录后，然后使用make命令编译即可。{| ~~'''linux内核版本'''~~class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~current~~cd /usr/src/hello/'''| orangepi@orangepi:/usr/src/hello$ '''sudo make'''make -C /lib/modules/5.4.125/build M=/usr/src/hello modulesmake[1]: Entering directory 'u/usr/src/linux-~~boot v2018~~headers-5.054.125':CC [M] /usr/src/hello/hello.o:Building modules, stage 2.:MODPOST 1 modules:CC [M] /usr/src/hello/hello.mod.o:LD [M] /usr/src/hello/hello.komake[1]: Leaving directory '/usr/src/linux-headers-5.4.125'| }</li><li>编译完后会生成'''~~linux5~~hello.4ko'''内核模块{| class="wikitable" style="width:800px;"

|-

| ~~'''next'''~~| orangepi@orangepi:/usr/src/hello$ '''~~u-boot v2021~~ls *.07ko'''~~| '''linux6~~hello.~~1'''~~ko

|}

</li>

<li>使用'''insmod'''命令可以将'''hello.ko'''内核模块插入内核中

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

|-

|

orangepi@orangepi:/usr/src/hello$ '''sudo insmod hello.ko'''

|}

</li>

<li>然后使用'''demsg'''命令可以查看下'''hello.ko'''内核模块的输出，如果能看到下面的输出说明'''hello.ko'''内核模块加载正确

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

|-

|

orangepi@orangepi:/usr/src/hello$ '''dmesg | grep "Hello"'''

[ 2871.893988] '''Hello Orange Pi -- init'''

|}

</li>

<li>使用'''rmmod'''命令可以卸载'''hello.ko'''内核模块

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

|-

|

orangepi@orangepi:/usr/src/hello$ '''sudo rmmod hello'''

orangepi@orangepi:/usr/src/hello$ '''dmesg | grep "Hello"'''

[ 2871.893988] Hello Orange Pi -- init

[ 3173.800892] '''Hello Orange Pi -- exit'''

|}

</li></ol>

~~'''这里所说的分支和orangepi-build源代码的分支不是同一个东西，请不要搞混了。此分支主要是用来区分不同内核源码版本的。'''~~ ~~'''目前全志提供的linux5.4 bsp内核我们定义为current分支。最新的linux6.1 LTS内核定义为next分支。'''~~ ~~orangepi-build下载完后会包含下面的文件和文件夹：~~ <~~ol style~~span id="~~list-style-type: lower-alpha;~~linux系统支持的部分编程语言测试">~~<li>'''build.sh''': 编译启动脚本</li><li>'''external''': > 包含编译镜像需要用的配置文件、特定的脚本以及部分程序的源码等</li><li>'''LICENSE''': GPL 2许可证文件</li><li>'''README.md''': orangepi-build说明文件</li><li>'''scripts''': 编译linux镜像的通用脚本test@test:~/orangepi-build$ '''ls''''''build.sh external LICENSE README.md scripts'''~~'''如果是从github下载的orangepi-build的代码，下载完后你可能会发现orangepi-build中并没有包含u-boot和linux内核的源码，也没有编译u-boot和linux内核需要用到交叉编译工具链，这是正常的，因为这些东西都存放在其它单独的github仓库或者某些服务器上了（下文会详述其地址）。orangepi-build在脚本和配置文件中会指定u-boot、linux内核和交叉编译工具链的地址，运行orangepi-build时，当其发现本地没有这些东西，会自动去相应的地方下载的。'''</li></olspan>

==~~= 下载交叉编译工具链 =~~Linux系统支持的部分编程语言测试 ==

~~orangepi~~=== Debian Bullseye系统 ===

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

~~[[File:media/image278.png]]~~

int main(void){</~~div~~p>~~交叉编译工具链在中国境内的镜像网址为清华大学的开源软件镜像站：~~::printf("Hello World!\n");

~~[https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/ '''https://mirrors.tuna.tsinghua.edu.cn/armbian-releases/_toolchain/''']~~

~~'''toolchains'''下载完后会包含多个版本的交叉编译工具链：~~ ~~test@test~~:~~~/orangepi-build$ '''ls toolchains/'''~~ ~~gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu gcc-linaro-4.9.4-2017.01-x86_64_aarch64-linux-gnu gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabi~~ ~~gcc-arm-11.2-2022.02-x86_64-arm-none-linux-gnueabihf gcc-linaro-4.9.4-2017.01-x86_64_arm-linux-gnueabi gcc-linaro-aarch64-none-elf-4.8-2013.11_linux~~ ~~gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu gcc-linaro-5.5.0-2017.10-x86_64_arm-linux-gnueabihf gcc-linaro-arm-linux-gnueabihf-4.8-2014.04_linux~~ ~~gcc-arm-9.2-2019.12-x86_64-arm-none-linux-gnueabihf gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu gcc-linaro-arm-none-eabi-4.8-2014.04_linux~~ ~~编译H618 Linux内核源码使用的交叉编译工具链为：~~ ~~<ol style="list-style-type~~: ~~lower-alpha;"><li>~~~~linux5.4'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''</li><li>linux6.1'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''编译H618 u-boot源码使用的交叉编译工具链为：</li></ol>~~ ~~<ol style="list-style-type: lower-alpha;"><li>v2018.05'''gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabi'''</li><li>v2021.07'''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''</li></ol>~~ ~~=== orangepi-build完整目录结构说明 ===~~ ~~<ol style="list-style-type: decimal;"><li>orangepi-build仓库下载完后并不包含linux内核、u-boot的源码以及交叉编译工具链，linux内核和u-boot的源码存放在独立的git仓库中<ol style="list-style-type: lower-alpha;"><li>linux内核源码存放的git仓库如下，注意切换linux-orangepi仓库的分支为<ol style="list-style-type: lower-alpha~~return 0;">~~<li>Linux5.4https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-5.4-sun50iw9'''~~</p~~></li~~>~~<li>~~~~Linux6.1~~}~~https://github.com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-6.1-sun50iw9'''</li></ol>~~|}

</li>

<li>~~u-boot源码存放的git仓库如下，注意切换u-boot-orangepi仓库的分支为~~然后编译运行'''hello_world.c'''~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>~~|-| ~~v2018~~orangepi@orangepi:~$ '''gcc -o hello_world hello_world.05c'''~~https://github.com/~~orangepi~~-xunlong/u-boot-~~@orangepi~~/tree/~~:~$ '''~~v2018~~.~~05-h618~~/hello_world'''</p~~></li~~>~~<li>~~~~v2021.07~~Hello World!~~</li></ol>~~|}

</li></ol>

</li~~></ol>~~ ~~https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2021.07-sunxi'''~~ ~~<ol start="2" style="list-style-type: decimal;"~~><li>~~orangepi-build第一次运行的时候会去下载交叉编译工具链、u-boot和linux内核源码，成功编译完一次linux镜像后在orangepi-build中可以看到的文件和文件夹有~~Debian Bullseye默认安装有Python3

<li>~~'''build.sh''': 编译启动脚本~~Python具体版本如下所示~~</li><li>~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~external~~python3'''~~: > 包含编译镜像需要用的配置文件、特定功能的脚本以及部分程序的源码，编译镜像过程中缓存的rootfs压缩包也存放在external中~~</p~~></li~~>~~<li>~~'''~~kernel~~Python 3.9.2'''(default, Feb 28 2021, 17:03: ~~存放linux内核的源码~~44)</p~~></li~~><lip>[GCC 10.2.1 20210110] on linux~~'''LICENSE''': GPL 2许可证文件~~Type "help", "copyright", "credits" or "license" for more information.</lip><lip>>>>~~'''README.md'''~~|}{| class="wikitable" style="background-color:#ffffdc;width: ~~orangepi~~800px;" |-~~build说明文件</li>~~| <libig>'''~~output~~使用Ctrl+D快捷键可退出python的交互模式。'''~~: > 存放编译生成的u-boot、linux等deb包、编译日志以及编译生成的镜像等文件~~</big>|}</li><li>编写Python语言的'''~~scripts~~hello_world.py'''~~: 编译linux镜像的通用脚本~~程序~~</li><li>~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~toolchains~~vim hello_world.py'''~~: 存放交叉编译工具链~~</p~~></li~~>~~<li>~~print('Hello World!'~~'u-boot''': 存放u-boot的源码~~)|}</li><li>运行'''~~userpatches~~hello_world.py'''~~: 存放编译脚本需要用到的配置文件~~的结果如下所示{| class="wikitable" style="width:800px;" |-| ~~test~~orangepi@~~test~~orangepi:~~~/orangepi-build~~$ '''lspython3 hello_world.py'''~~'''build.sh external kernel LICENSE output README.md scripts toolchains u-boot userpatches'''~~Hello World!~~</li></ol>~~|}

</li></ol>

~~== 编译u-boot ==~~

~~<ol style="list-style-type: decimal;">~~

~~<li>运行build.sh脚本，记得加sudo权限~~

~~test@test:~/orangepi-build$ '''sudo ./build.sh'''</li>~~

~~<li>选择'''U-boot package'''，然后回车~~

~~<div class="figure">~~

~~[[File:media/image279.png]]~~

~~</div></li>~~

~~<li>接着选择开发板的型号~~

~~[[File:media/image280.png]]</li>~~

~~<li>然后选择u-boot的分支类型~~

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>current分支会编译linux5.4镜像需要使用的u-boot v2018.05版本的代码</li>~~

~~<li>next分支会编译linux6.1镜像需要使用的u-boot v2021.07版本的代码~~

~~[[File:media/image281.png]]</li></ol>~~

</li>

<li>~~如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择~~Debian Bullseye默认没有安装Java的编译工具和运行环境

<li>~~如果购买的开发板为1.5GB内存大小的，请选择第一项~~可以使用下面的命令安装openjdk，Debian Bullseye中最新版本为openjdk-17~~</li><li>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项~~{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media/image282.png]]~~~$ '''sudo apt install -y openjdk-17-jdk'''~~</li></ol>~~|}

</li>

<li>~~然后就会开始编译u-boot，编译next分支时提示的部分信息说明如下所示：~~安装完后可以查看下Java的版本~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>u~~|-~~boot源码的版本[ o.k. ] Compiling u-boot [ '''v2021.07''' ]</li>~~| ~~<li>~~~~交叉编译工具链的版本[ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 11''' ]</li><li>编译生成的u-boot deb包的路径[ o.k. ] Target directory [ '''~~orangepi~~-build/output/debs/u-boot''' ]</li><li>编译生成的u-boot deb包的包名[ o.k. ] File name [~~ @orangepi:~$ '''~~linux~~java -u-~~boot-next-orangepizero2w_x.x.x_arm64.deb~~version''' ]</p~~></li~~>~~<li>编译使用的时间[ o.k. ] Runtime [ '''1 min''' ]</li><li>重复编译u-boot的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译u-boot[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero2w BRANCH=next BUILD_OPT=u-boot''' ]</li></ol>~~|}

</li>

<li>~~查看编译生成的u-boot deb包test@test:~/orangepi-build$~~ 编写Java版本的'''~~ls output/debs/u-boot/~~hello_world.java'''{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~linux-u-boot-next-orangepizero2w_x.x~~vim hello_world.~~x_arm64.deb~~java'''</p~~></li~~>~~<li>~~orangepi-bulid编译系统编译u-boot源码时首先会将u-boot的源码和github服务器的u-boot源码进行同步，所以如果想修改u-boot的源码，首先需要关闭源码的下载更新功能（'''需要完整编译过一次u-boot后才能关闭这个功能，否则会提示找不到u-boot的源码'''），否则所作的修改都会被还原，方法如下：public class hello_world~~设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”~~{:~~test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''~~public static void main(String[] args):~~......~~{::~~IGNORE_UPDATES=~~System.out.println("~~'''yes'''~~Hello World!");:~~......~~}</p~~></li~~>~~<li>~~~~调试u-boot代码时，可以使用下面的方法来更新linux镜像中的u-boot进行测试~~}|}<~~ol style="list-style-type: lower-alpha;"~~/li><li>~~首先将编译好的u-boot的deb包上传到开发板的linux系统中test@test:~/orangepi-build$~~ 然后编译运行'''~~cd output/debs/u-boot~~hello_world.java'''~~test@test~~{| class="wikitable" style="width:~~~/orangepi_build/output/debs/u-boot$ '''scp \'''~~800px;" ~~'''linux-u-boot-next~~|-~~orangepizero2w_x.x.x_arm64.deb [mailto:root@192.168.1.xxx:/root root@192.168.1.xxx:/root]'''</li><li>再安装刚才上传的新的u-boot的deb包~~| orangepi@orangepi:~$ '''~~sudo dpkg -i''' '''linux-u-boot-next-orangepizero2w_x.x.x_arm64~~javac hello_world.~~deb~~java'''~~</li><li>然后运行 nand-sata-install脚本~~orangepi@orangepi:~$ '''~~sudo nand-sata-install'''</li><li>然后选择'''5 Install/Update the bootloader on SD/eMMC~~java hello_world'''~~[[File:media/image283.png]]~~Hello World!</p~~></li~~>~~<li>按下回车键后首先会弹出一个Warning~~|}~~[[File:media/image284.png]]</li><li>再按下回车键就会开始更新u-boot，更新完后会显示下面的信息[[File:media/image285.png]]</li><li>然后就可以重启开发板来测试u-boot的修改是否生效了~~</li></ol>

</li></ol>

=== Debian Bookworm系统 = ~~编译linux内核~~ ==

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

~~[[File:media/image286.png]]~~

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

~~~~

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>如果不需要修改内核的配置选项，在运行build.sh脚本时，传入'''KERNEL_CONFIGURE=no'''就可临时屏蔽弹出内核的配置界面了~~

~~test@test:~/orangepi-build$ '''sudo ./build.sh KERNEL_CONFIGURE=no'''</li>~~

~~<li>也可以设置orangepi-build/userpatches/config-default.conf配置文件中的'''KERNEL_CONFIGURE=no'''，这样可以永久禁用这个功能</li>~~

<li>编译内核的时候如果提示下面的错误，这是由于Ubuntu > PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu > PC的终端调到最大，然后重新运行build.sh脚本

~~[[File:media/image289.png]]</li></ol>~~

~~<ol start="7" style="list-style-type~~: ~~decimal;"><li>~~~~编译next分支内核源码时提示的部分信息说明如下：<ol style="list-style-type: lower-alpha~~return 0;">~~<li>linux内核源码的版本[ o.k. ] Compiling current kernel [ '''6.1.31''' ]~~</p~~></li~~>~~<li>~~~~使用的交叉编译工具链的版本~~}~~[ o.k. ] Compiler version [ '''aarch64-linux-gnu-gcc 11''' ]</li><li>内核默认使用的配置文件以及它存放的路径如下所示[ o.k. ] Using kernel config file [ '''orangepi-build/external/config/kernel/linux-6.1-sun50iw9-next.config''' ]</li><li>编译生成的内核相关的deb包的路径[ o.k. ] Target directory [ '''output/debs/''' ]</li><li>编译生成的内核镜像deb包的包名[ o.k. ] File name [ '''linux-image-next-sun50iw9_x.x.x_arm64.deb''' ]</li><li>编译使用的时间[ o.k. ] Runtime [ '''10 min''' ]</li><li>最后会显示重复编译上一次选择的内核的编译命令，使用下面的命令无需通过图形界面选择，可以直接开始编译内核源码[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero2w BRANCH=next BUILD_OPT=kernel KERNEL_CONFIGURE=no''' ]</li></ol>~~|}

</li>

<li>~~查看编译生成的内核相关的deb包~~然后编译运行'''hello_world.c'''~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>'''linux~~|-~~dtb-next-sun50iw9_x.x.x_arm64.deb'''包含有内核使用的dtb文件</li><li>'''linux-headers-next-sun50iw9_x.x.x_arm64.deb'''包含内核头文件</li>~~| ~~<li>~~orangepi@orangepi:~$ '''~~linux-image~~gcc -~~next-sun50iw9_x~~o hello_world hello_world.~~x.x_arm64.deb~~c'''~~包含内核镜像和内核模块~~~~test~~orangepi@~~test~~orangepi:~~~/orangepi-build~~$ '''~~ls output/debs~~./linux-*hello_world'''~~output/debs/linux-dtb-next-sun50iw9_x.x.x_arm64.deb~~Hello World!~~output/debs/linux-headers-next-sun50iw9_x.x.x_arm64.deb~~|}~~output/debs/linux-image-next-sun50iw9_x.x.x_arm64.deb~~</li></ol>

</li>

<li>orangepi-bulid编译系统编译linux内核源码时首先会将linux内核源码和github服务器的linux内核源码进行同步，所以如果想修改linux内核的源码，首先需要关闭源码的更新功能（'''需要完整编译过一次linux内核源码后才能关闭这个功能，否则会提示找不到linux内核的源码'''），否则所作的修改都会被还原，方法如下：~~设置'''userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”test@test:~/orangepi-build$ '''vim userpatches/config-default.conf'''IGNORE_UPDATES="'''yes'''"</li><li>如果对内核做了修改，可以使用下面的方法来更新开发板linux系统的内核和内核模块~~Debian Bookworm默认安装有Python3

<li>~~将编译好的linux内核的deb包上传到开发板的linux系统中~~Python具体版本如下所示~~test@test~~{| class="wikitable" style="width:~~~/orangepi~~800px;" |-~~build$ '''cd output/debs'''~~| ~~test~~orangepi@~~test~~orangepi:~~~/orangepi-build/output/debs~~$ '''~~scp \~~python3'''~~'''linux-image-next-sun50iw9_x.x~~Python 3.~~x_arm64~~11.~~deb root@192.168.1.xxx~~2 (main, Mar 13 2023, 12:~~/root'''</li><li>再安装刚才上传的新的linux内核的deb包orangepi@orangepi~~18:~~~$ '''sudo dpkg -i linux-image-next-sun50iw9_x~~29) [GCC 12.x2.~~x_arm64.deb'''~~0] on linux</p~~></li~~>~~<li>~~~~然后重启开发板，再查看内核相关的修改是否已生效~~Type "help", "copyright", "credits" or "license" for more information.~~orangepi@orangepi:~$ '''sudo''' '''reboot'''~~>>></p~~></li></ol></li></ol~~>|}{| class=~~= 编译rootfs ==~~ ~~<ol~~ "wikitable" style="~~list~~background-~~style-type~~color:#ffffdc;width: ~~decimal~~800px;">~~<li>运行build.sh脚本，记得加sudo权限~~|-~~test@test:~/orangepi-build$ '''sudo ./build.sh'''</li>~~| <libig>选择'''~~Rootfs and all deb packages~~使用Ctrl+D快捷键可退出python的交互模式。'''~~，然后回车</li></ol>~~ ~~<div class="figure">~~ ~~[[File:media/image290.png]]~~ ~~</div><ol start="3" style="list-style-type: decimal;"><li>接着选择开发板的型号~~<~~p>[[File:media~~/~~image280.png]]</li><li><~~p>~~然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别~~</pbig>~~<ol style="list-style-type: lower-alpha;"><li>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</li><li>next分支可以看到debian11、debian12、ubuntu22.04三个选项[[File:media/image281.png]]</li></ol>~~|}

</li>

<li>~~然后选择rootfs的类型[[File:media/image291~~编写Python语言的'''hello_world.~~png]]~~py'''程序</p~~></li~~>~~<li>然后选择镜像的类型<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>~~|-| orangepi@orangepi:~$ '''~~Image with console interface > (server)~~vim hello_world.py'''~~表示服务器版的镜像，体积比较小~~</p~~></li~~>~~<li>~~print('Hello World!'~~'Image with desktop environment'''表示带桌面的镜像，体积比较大~~)~~<div class="figure">~~ ~~[[File:media/image292.png]]~~ ~~</div></li></ol>~~|}

</li>

<li>~~如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（~~运行'''~~没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了~~hello_world.py'''）的结果如下所示~~<div~~ {| class="~~figure~~wikitable"> ~~[[File:media/image293.png]]~~ ~~</div></li><li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面[[File:media/image294.png]][[File:media/image295.png]]然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。[[File:media/image296.png]]</li><li>然后就会开始编译rootfs，编译时提示的部分信息说明如下<ol~~ style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>rootfs的类型~~|-| ~~[ o.k. ] local not found [ Creating new rootfs cache for~~ orangepi@orangepi:~$ '''~~bullseye~~python3 hello_world.py''' ]</p~~></li~~>~~<li>~~~~编译生成的rootfs压缩包的存放路径~~Hello World!~~[ o.k. ] Target directory [ '''orangepi-build/external/cache/rootfs''' ]</li><li>编译生成的rootfs压缩包的名字~~|}~~[ o.k. ] File name [ '''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4''' ]~~</li></ol>

</li>

<li>~~查看编译生成的rootfs压缩包~~Debian Bookworm默认没有安装Java的编译工具和运行环境

<li>~~'''bullseye-xfce~~可以使用下面的命令安装openjdk，Debian Bookworm中最新版本为openjdk-~~arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4'''是rootfs的压缩包，名字各字段的含义为~~17~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>'''bullseye'''表示rootfs的linux发行版的类型</li>~~|-~~<li>'''xfce'''表示rootfs为桌面版的类型，如果为'''cli'''则表示服务器版类型</li>~~| ~~<li>~~orangepi@orangepi:~$ '''~~arm64~~sudo apt install -y openjdk-17-jdk'''~~表示rootfs的架构类型~~</p~~></li~~><li>'''25250ec7002de9e81a41de169f1f89721'''是由rootfs安装的所有软件包的包名生成的MD5哈希值，只要没有修改rootfs安装的软件包的列表，那么这个值就不会变，编译脚本会通过这个MD5哈希值来判断是否需要重新编译rootfs</li></ol>|}

</li>

<li>安装完后可以查看下Java的版本{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~bullseye~~java -~~xfce~~-~~arm64.5250ec7002de9e81a41de169f1f89721.tar~~version'''|}</li><li>编写Java版本的'''hello_world.~~lz4.list~~java'''~~列出了rootfs安装的所有软件包的包名~~{| class="wikitable" style="width:800px;" |-| ~~test~~orangepi@~~test~~orangepi:~~~/orangepi-build~~$ '''~~ls external/cache/rootfs/~~vim hello_world.java'''~~bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4~~public class hello_world{:~~bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.current~~public static void main(String[] args):{::~~bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar~~System.~~lz4~~out.~~list~~println("Hello World!");:}</lip>}</olp>|}

</li>

<li>~~如果需要的rootfs在~~然后编译运行'''~~external~~hello_world.java'''</~~cache/rootfs~~p>{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~下已经存在，那么再次编译rootfs就会直接跳过编译过程，不会重新开始编译，编译镜像的时候也会去~~javac hello_world.java'''~~external~~</~~cache/rootfs~~p>orangepi@orangepi:~$ '''java hello_world'''~~下查找是否已经有缓存可用的rootfs，如果有就直接使用，这样可以节省大量的下载编译时间~~Hello World!|}</li></ol></li></ol>

== ~~编译linux镜像~~ = Ubuntu Focal系统 ===

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

<~~div class="figure"~~p>int main(void){:printf("Hello World!\n");

~~[[File:media/image297.png]]~~

:return 0;</~~div~~p><~~ol start~~p>}|}</li><li>然后编译运行'''hello_world.c'''{| class="3wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">|-| <lip>orangepi@orangepi:~$ '''gcc -o hello_world hello_world.c'''~~然后选择开发板的型号~~orangepi@orangepi:~$ '''./hello_world'''~~[[File:media~~Hello World!|}</~~image280.png]]~~li></pol></li><li>~~然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别~~Ubuntu Focal默认安装有Python3

<li>~~current分支可以看到debian11、ubuntu20~~Python3具体版本如下所示{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''python3'''Python 3.8.10 (default, Nov 14 2022, 12:59:47)[GCC 9.~~04、ubuntu22~~4.0] on linuxType "help", "copyright", "credits" or "license" for more information.~~04三个选项~~>>>|}{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''使用Ctrl+D快捷键可退出python的交互模式。'''</big>|}</li><li>~~next分支可以看到debian11、debian12、ubuntu22~~编写Python语言的'''hello_world.~~04三个选项~~py'''程序{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media/image281~~~$ '''vim hello_world.~~png]]~~py'''<~~/li~~p>print('Hello World!')</olp>|}

</li>

<li>~~如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择~~运行'''hello_world.py'''的结果如下所示~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>~~|-| ~~如果购买的开发板为1~~orangepi@orangepi:~$ '''python3 hello_world.~~5GB内存大小的，请选择第一项~~py'''</p~~></li~~>~~<li>~~~~如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项~~Hello World!~~[[File:media/image282.png]]~~|}</li></ol>

</li>

<li>~~然后选择rootfs的类型[[File:media/image291.png]]</li><li>然后选择镜像的类型~~Ubuntu Focal默认没有安装Java的编译工具和运行环境

<li>~~'''Image with console interface > (server)'''表示服务器版的镜像，体积比较小~~可以使用下面的命令安装openjdk-17~~</li><li>~~{| class="wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~Image with desktop environment~~sudo apt install -y openjdk-17-jdk'''~~表示带桌面的镜像，体积比较大~~~~<div class="figure">~~ ~~[[File:media/image292.png]]~~ ~~</div></li></ol>~~|}

</li>

<li>如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（'''没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了'''）安装完后可以查看下Java的版本~~<div~~ {| class="~~figure~~wikitable" style="> ~~[[File~~width:~~media/image293.png]]~~800px;" |-~~</div></li>~~| ~~<li>~~~~如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面~~orangepi@orangepi:~$ '''java --version'''~~[[File:media/image294~~openjdk 17.0.~~png]]~~2 2022-01-18~~[[File:media/image295~~OpenJDK Runtime Environment (build 17.0.2+8-Ubuntu-120.~~png]]~~04)~~然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。~~OpenJDK 64-Bit Server VM (build 17.0.2+8-Ubuntu-120.04, mixed mode, sharing)~~[[File:media/image296.png]]~~|}</li><li>~~然后就会开始编译linux镜像，编译的大致流程如下~~编写Java版本的'''hello_world.java'''~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>初始化Ubuntu PC的编译环境，安装编译过程需要的软件包</li><li>下载u~~|-~~boot和linux内核的源码（如果已经缓存，则只更新代码）</li><li>编译u-boot源码，生成u-boot的deb包</li><li>编译linux源码，生成linux相关的deb包</li>~~| ~~<li>~~~~制作linux firmware的deb包~~orangepi@orangepi:~$ '''vim hello_world.java'''</p~~></li~~>~~<li>~~~~制作orangepi-config工具的deb包~~public class hello_world</p~~></li~~>~~<li>~~~~制作板级支持的deb包~~{</p~~></li~~>~~<li>~~:~~如果是编译desktop版镜像，还会制作desktop相关的deb包~~public static void main(String[] args)</p~~></li~~>~~<li>~~:~~检查rootfs是否已经缓存，如果没有缓存，则重新制作rootfs，如果已经缓存，则直接解压使用~~{</p~~></li~~>~~<li>~~::~~安装前面生成的deb包到rootfs中~~System.out.println("Hello World!");</p~~></li~~>~~<li>~~:~~对不同的开发板和不同类型镜像做一些特定的设置，如预装额外的软件包，修改系统配置等~~}</p~~></li~~>~~<li>~~~~然后制作镜像文件，并格式化分区，默认类型为ext4~~}</p~~></li~~>~~<li>再将配置好的rootfs拷贝到镜像的分区中</li><li>然后更新initramfs</li><li>最后将u-boot的bin文件通过dd命令写入到镜像中</li></ol>~~|}

</li>

<li>~~编译完镜像后会提示下面的信息~~然后编译运行'''hello_world.java'''~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>~~|-| ~~编译生成的镜像的存放路径~~orangepi@orangepi:~$ '''javac hello_world.java'''~~[ o.k. ] Done building [~~ orangepi@orangepi:~$ '''~~output/images/orangepizero2w_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop/orangepizero2w_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop.img~~java hello_world''' ]</p~~></li~~>~~<li>~~~~编译使用的时间~~Hello World!|}</li></ol>

</li></ol>

~~'''[ o.k. ] Runtime [ 19 min ]'''~~

~~<ol start~~=~~"3" style~~=~~"list-style-type: lower-alpha;"><li>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD~~=~~orangepizero2w BRANCH~~Ubuntu Jammy系统 =~~next BUILD_OPT~~=~~image RELEASE~~=~~bullseye BUILD_MINIMAL=no BUILD_DESKTOP=no KERNEL_CONFIGURE=yes''' ]</li></ol>~~

<~~span id~~ol style="~~orange~~list-pistyle-ostype: decimal;"><li>Ubuntu Jammy默认安装有gcc编译工具链，可以直接在开发板的Linux系统中编译C语言的程序<ol style="list-style-type: lower-~~arch系统的使用说明~~alpha;"><li>gcc的版本如下所示{| class="wikitable" style="width:800px;"|-| orangepi@orangepi:~$ '''gcc --version'''gcc (Ubuntu 11.3.0-1ubuntu1~22.04.1) '''11.3.0'''</~~span~~p>Copyright (C) 2021 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.|}</li><li>编写C语言的'''hello_world.c'''程序{| class= "wikitable" style="width:800px;" |-| orangepi@orangepi:~$ '''~~Orange Pi OS Arch系统的使用说明~~vim hello_world.c''' =#include <stdio.h> int main(void){:printf("Hello World!\n");

~~~~

~~== Orange Pi OS Arch系统功能适配情况 ==~~

:return 0;}|}</li><li>然后编译运行'''hello_world.c'''{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~主板功能~~gcc -o hello_world hello_world.c'''| orangepi@orangepi:~$ '''~~OPi OS Arch~~./hello_world'''Hello World!|}</li></ol></li><li>Ubuntu Jammy默认安装有Python3<ol style="list-style-type: lower-alpha;"><li>Python3具体版本如下所示{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~HDMI视频~~python3'''Python 3.10.6 (main, May 29 2023, 11:10:38) [GCC 11.3.0] on linuxType "help", "copyright", "credits" or "license" for more information.>>>|}{| ~~'''OK'''~~class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

| <big>'''~~HDMI音频~~使用Ctrl+D快捷键可退出python的交互模式。'''</big>| }</li><li>编写Python语言的'''OKhello_world.py'''程序{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~Type-C USB2~~vim hello_world.~~0 x 2~~py'''print('Hello World!')| }</li><li>运行'''OKhello_world.py'''的结果如下所示{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~TF卡启动~~python3 hello_world.py'''Hello World!| ~~'''OK'''~~}</li></ol></li><li>Ubuntu Jammy默认没有安装Java的编译工具和运行环境<ol style="list-style-type: lower-alpha;"><li>可以使用下面的命令安装openjdk-18{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~WIFI~~sudo apt install -y openjdk-18-jdk'''|}</li><li>安装完后可以查看下Java的版本{| ~~'''OK'''~~class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''蓝牙java --version'''openjdk 18.0.2-ea 2022-07-19OpenJDK Runtime Environment (build 18.0.2-ea+9-Ubuntu-222.04)OpenJDK 64-Bit Server VM (build 18.0.2-ea+9-Ubuntu-222.04, mixed mode, sharing)| }</li><li>编写Java版本的'''OKhello_world.java'''{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~LED灯~~vim hello_world.java'''public class hello_world{:public static void main(String[] args):{::System.out.println("Hello World!");:}}| }</li><li>然后编译运行'''OKhello_world.java'''{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~40pin GPIO~~javac hello_world.java'''| orangepi@orangepi:~$ '''OKjava hello_world'''Hello World!|}</li></ol></li></ol> == 上传文件到开发板Linux系统中的方法 == === 在Ubuntu PC中上传文件到开发板Linux系统中的方法 === ==== 使用scp命令上传文件的方法 ==== ~~| '''40pin I2C'''~~<ol style="list-style-type: decimal;">~~| '''OK'''~~<li>使用scp命令可以在Ubuntu PC中上传文件到开发板的Linux系统中，具体命令如下所示|<ol style="list-style-type: lower-alpha;">| <li>'''~~40pin SPI~~file_path：'''需要替换为要上传文件的路径</li>| <li>'''OKorangepi：'''为开发板linux系统的用户名，也可以替换成其它的，比如root</li>|-| <li>'''~~40pin UART~~192.168.xx.xx:'''为开发板的IP地址，请根据实际情况进行修改</li>| <li>'''OK/home/orangepi:'''开发板linux系统中的路径，也可以修改为其它的路径{| class="wikitable" style="width:800px;"

|-

| test@test:~$ '''~~40pin PWM~~scp file_path orangepi@192.168.xx.xx:/home/orangepi/'''|}</li></ol></li><li>如果要上传文件夹，需要加上-r参数{| ~~'''OK'''~~class="wikitable" style="width:800px;"

|-

| test@test:~$ '''~~温度传感器~~scp -r dir_path orangepi@192.168.xx.xx:/home/orangepi/'''|}</li><li>scp还有更多的用法，请使用下面的命令查看man手册</li>{| ~~'''OK'''~~class="wikitable" style="width:800px;"

|-

| test@test:~$ '''~~硬件看门狗~~man scp'''| ~~'''OK'''~~}</ol> ==== 使用filezilla上传文件的方法 ==== <ol style="list-style-type: decimal;"><li>首先在Ubuntu PC中安装filezilla{| class="wikitable" style="width:800px;"

|-

| test@test:~$ '''~~Mali GPU~~sudo apt install -y filezilla'''|}</li><li>然后使用下面的命令打开filezilla{| ~~'''NO'''~~class="wikitable" style="width:800px;"

|-

| ~~'''视频编解码'''~~| test@test:~$ '''NOfilezilla'''

|}

</li>

<li>filezilla打开后的界面如下所示，此时右边远程站点下面显示的是空的

[[File:zero2w-img259.png]]

~~{| class="wikitable"~~</div></li>|-~~| '''24pin扩展板功能'''| '''OPi OS Arch'''~~|-~~| '''百兆网口'''| '''OK'''~~|-~~| '''百兆网口灯'''| '''OK'''~~|-~~| '''USB2.0 HOST x 2'''| '''OK'''~~|-~~| '''红外接收'''| '''OK'''~~|-~~| '''耳机音频播放'''| '''OK'''~~|-~~| '''开关机按键'''| '''OK'''~~|-~~| '''LRADC自定义按键 x 2'''| '''OK'''~~|-~~| '''TV-OUT'''| '''NO'''~~|}<li>连接开发板的方法如下图所示</li>

<~~span id~~div class="~~orange-pi-os-arch系统用户向导使用说明~~figure">~~== Orange Pi OS Arch系统用户向导使用说明 ==~~

首先请注意，OPi OS Arch系统是没有设置默认的orangepi用户和密码的，所以烧录完系统启动后是无法直接通过串口和ssh远程登录的（root用户也不行）。这一点和Ubuntu、Debian系统是有区别的。[[File:zero2w-img260.png]]

OPi OS Arch系统第一次启动时需要接上HDMI显示器，然后通过用户向导来初始化系统设置（其中包括新建用户名和设置密码）。用户向导的设置步骤如下所示：</div></ol><ol start="5" style="list-style-type: decimal;"><li>然后选择'''保存密码'''，再点击'''确定'''[[File:zero2w-img261.png]]</li><li>然后选择'''总是信任该主机'''，再点击'''确定'''</li>

~~<ol style="list-style-type: lower-alpha;">~~

~~<li>烧录完系统第一次启动进入桌面后会看到下图所示的用户向导程序~~

[[File:~~media/image298~~zero2w-img262.png]]

</div></liol><liol start="7" style="list-style-type: decimal;"><pli>~~首先需要选择想要语言~~连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了</pli>~~<div class="figure">~~ ~~[[File:media/image299.png]]~~

~~</div></li>~~

~~<li>在选择完语言后，用户向导会立即切换为对应的语言界面，如中文显示如下所示~~

[[File:~~media/image300~~zero2w-img263.png]]

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

~~[[File:media/image301.png]]~~

~~</div></li>~~

~~<li>然后选择键盘型号~~

[[File:~~media/image302~~zero2w-img264.png]]

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

~~[[File:media~~</~~image303.png]]~~span>

~~</div></li><li>然后确保选择没问题后，再点击'''安装'''按钮<div class~~=~~"figure">~~== 在Windows PC中上传文件到开发板Linux系统中的方法 ===

==== 使用filezilla上传文件的方法 ==== # 首先下载filezilla软件Windows版本的安装文件，下载链接如下所示 ::{| class="wikitable" style="width:800px;" |-| [https://filezilla-project.org/download.php?type=client '''https://filezilla-project.org/download.php?type=client''']|} ::[[File:~~media/image304~~zero2w-img265.png]] ::[[File:zero2w-img266.png]] <ol start="2" style="list-style-type: decimal;"><li>下载的安装包如下所示，然后双击直接安装即可{| class="wikitable" style="width:800px;" |-| '''FileZilla_Server_1.5.1_win64-setup.exe'''|} 安装过程中，下面的安装界面请选择'''Decline'''，然后再选择'''Next>'''

~~</div></li>~~

~~<li>然后等待安装完成~~

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

~~</div></li>~~

~~<li>安装完成需要点击'''完成'''按钮重启系统~~

[[File:~~media/image306~~zero2w-img268.png]] </div></ol><ol start="4" style="list-style-type: decimal;"><li>连接开发板的方法如下图所示：</li>

~~</div></li>~~

~~<li>重启后会自动启动Orange Pi Hello程序，此时需要去掉右下角'''开机时启动'''的勾选状态，不然每次启动都需要手动关闭Orange Pi Hello程序~~

[[File:~~media/image307~~zero2w-img269.png]]

</div><p/ol>~~此时就可以使用刚才新建的用户名和密码通过串口或者ssh登录OPi OS系统了。~~</pol start="5" style="list-style-type: decimal;"></li>然后选择'''保存密码'''，再点击'''确定'''</olli>

<~~span id~~div class="~~设置dt-overlays的方法~~figure">~~== 设置DT overlays的方法 ==~~

~~开发板40pin中的I2C/SPI/UART/PWM等复用功能默认在内核的dts中都是关闭的，需要手动打开对应的DT overlays才能使用。~~[[File:zero2w-img270.png]]

~~在OPi OS Arch系统中打开DT overlays的方法如下所示：~~</div></ol><ol start="6" style="list-style-type: decimal;"><li>然后选择'''总是信任该主机'''，再点击'''确定'''</li>

<~~ol style~~div class="~~list-style-type: decimal;~~figure">~~<li>首先打开'''/boot/extlinux/extlinux.conf'''配置文件[orangepi@orangepi-pc ~]$ '''sudo vim /boot/extlinux/extlinux.conf'''</li><li>然后在'''/boot/extlinux/extlinux.conf'''中通过添加'''FDTOVERLAYS /dtbs/allwinner/overlay/xxx.dtbo'''来打开对应的配置</li></ol~~>

~~'''注意FDTOVERLAYS /dtbs/allwinner/overlay/xxx~~[[File:zero2w-img271.~~dtbo中的xxx.dtbo需要替换为具体的dtbo配置，请不要照抄。'''~~png]]

~~[orangepi@orangepi-pc ~]$ '''sudo vim~~ </~~boot~~div></~~extlinux~~ol><ol start="7" style="list-style-type: decimal;"><li>连接成功后在filezilla软件的右边就可以看到开发板linux文件系统的目录结构了</~~extlinux.conf'''~~li>

~~LABEL Orange Pi~~<div class="figure">

~~KERNEL /Image~~[[File:zero2w-img272.png]]

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

~~'''FDTOVERLAYS /dtbs/allwinner/overlay/xxx.dtbo''' #需要添加的配置~~<div class="figure">

~~<ol start="3" style="list~~[[File:zero2w-~~style-type: decimal;"><li>xxx~~img273.~~dtbo在OPi OS Arch镜像中的存放路径如下所示，请注意，此路径下面不是所有的dtbo都可以使用的。'''/boot/dtbs/allwinner/overlay/'''</li><li>开发板可以使用的DT overlays配置如下所示</li></ol>~~png]]

~~{| class~~</div></ol><ol start="9" style="~~wikitable~~list-style-type: decimal;">|<li>上传完成后就可以去开发板linux系统中的对应路径中查看上传的文件了</li><li>上传文件夹的方法和上传文件的方法是一样的，这里就不再赘述了</li></ol> == 开关机logo使用说明 == <ol style="list-style-type: decimal;">| <li>开关机logo默认只在桌面版的系统中才会显示</li><li>在'''/boot/orangepiEnv.txt'''中设置'''~~开发板上的功能~~bootlogo'''| 变量为'''~~对应的DT overlays配置~~false'''可以关闭开关机logo{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~40pin - i2c0~~sudo vim /boot/orangepiEnv.txt'''verbosity=1'''bootlogo=false'''| }</li><li>在'''~~sun50i-h616-pi-i2c0~~/boot/orangepiEnv.~~dtbo~~txt'''中设置'''bootlogo'''变量为'''true'''可以开启开关机logo{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~40pin - i2c1~~sudo vim /boot/orangepiEnv.txt'''verbosity=1| '''~~sun50i-h616-pi-i2c1.dtbo~~bootlogo=true'''|}</li><li>开机logo图片在linux系统中的位置为{| class="wikitable" style="width:800px;"

|-

| '''~~40pin - i2c2~~/usr/share/plymouth/themes/orangepi/watermark.png'''| ~~'''sun50i-h616-pi-i2c2.dtbo'''~~}</li><li>替换开机logo图片后需要运行下命令才能生效{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~40pin~~ sudo update- ~~uart2~~initramfs -u'''| }</li></ol> == Linux5.4打开开关机按键的方法 == 开发板主板上没有开关机按键，我们可以通过24pin扩展板来扩展。开关机按键在扩展板上的位置如下所示： [[File:zero2w-img274.png]] Linux6.1镜像开关机按键默认是打开的，但Linux5.4内核镜像的开关机按键默认是关闭的，需要手动打开才能正常使用。步骤如下所示： <ol style="list-style-type: decimal;"><li>首先运行下'''~~sun50i~~orangepi-~~h616-pi-uart2.dtbo~~config'''，普通用户记得加'''sudo'''权限{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~40pin~~ sudo orangepi- ~~uart3~~config'''| }</li><li>然后选择'''~~sun50i~~System'''[[File:zero2w-~~h616~~img81.png]]</li><li>然后选择'''Hardware'''[[File:zero2w-piimg82.png]]</li><li>然后使用键盘的方向键定位到下图所示的位置，再使用'''空格'''选中想要打开的SPI的dtbo配置[[File:zero2w-~~uart3~~img275.~~dtbo~~png]]</li><li>然后选择'''<Save>'''保存|[[File:zero2w-img84.png]]</li>| <li>然后选择'''<Back>'''~~40pin~~ [[File:zero2w- ~~uart4~~img85.png]]</li><li>然后选择'''| <Reboot>'''~~sun50i~~重启系统使配置生效[[File:zero2w-~~h616~~img86.png]]</li></ol> == 关机和重启开发板的方法 == <ol style="list-pistyle-~~uart4.dtbo~~type: decimal;"><li>在Linux系统运行的过程中，如果直接拔掉电源断电，可能会导致文件系统丢失某些数据，建议断电前先使用'''poweroff'''命令关闭开发板的Linux系统，然后再拔掉电源{| class="wikitable" style="width:800px;"

|-

| orangepi@orangepi:~$ '''~~40pin - uart5~~sudo poweroff'''|}{| ~~'''sun50i-h616-ph~~class="wikitable" style="background-~~uart5.dtbo'''~~color:#ffffdc;width:800px;"

|-

| <big>'''~~40pin - pwm1~~注意，关闭开发板后需要重新拔插电源才能开机。'''</big>| ~~'''sun50i~~}</li><li>除了使用poweroff命令关机外，还可以使用扩展板上的开关机按键来关机[[File:zero2w-~~h616-pi~~img274.png]]{| class="wikitable" style="background-~~pwm1.dtbo'''~~color:#ffffdc;width:800px;"

|-

| <big>'''~~40pin - pwm2~~注意，Linux5.4需要手动打开开关机按键的配置才能使用。打开方法请参考[[Orange Pi Zero 2W#Linux5.4打开开关机按键的方法|Linux5.4打开开关机按键的方法]]。'''</big>| }</li><li>使用'''~~sun50i-h616-pi-pwm2.dtbo~~reboot'''命令即可重启开发板中的Linux系统{| class="wikitable" style="width:800px;"

|-

|}

</li></ol>

<~~ol start~~span id="~~5" style="list~~linux-~~style~~sdkorangepi-~~type: decimal;~~build使用说明"><li/span>~~如果需要同时打开多个配置，直接在~~ = '''~~FDTOVERLAYS~~Linux SDK——orangepi-build使用说明'''~~后面将多个配置的路径加上即可，比如同时打开i2c1和uart5的配置如下所示~~= == 编译系统需求 == ~~[orangepi@~~Linux SDK，即'''orangepi-~~pc ~]$~~ build'''~~sudo vim /boot/extlinux/extlinux.conf~~，只支持在安装有'''<~~/p>~~<pspan style="color:#FF0000">~~LABEL Orange PiKERNEL /ImageFDT /dtbs/allwinner/sun50i-h616-orangepi-zero2w~~Ubuntu 22.~~dtb~~04<pspan>'''~~FDTOVERLAYS /dtbs/allwinner/overlay/sun50i~~的X64电脑上运行，所以下载orangepi-~~h616-pi-i2c1~~build前，请首先确保自己电脑已安装的Ubuntu版本是Ubuntu 22.~~dtbo /dtbs/allwinner/overlay/sun50i-h616-ph-uart5.dtbo~~04。查看电脑已安装的Ubuntu版本的命令如下所示，如果Release字段显示的不是'''</pspan style="color:#FF0000">22.04</lispan>'''，说明当前使用的Ubuntu版本不符合要求，请更换系统后再进行下面的操作。 ~~<li>设置好后需要重启系统才能让配置生效~~{| class="wikitable" style="width:800px;" |-| ~~[orangepi~~test@~~orangepi-pc~~ test:~]$ '''~~sudo reboot~~lsb_release -a'''~~</li></ol>~~

~~== 安装软件的方法 ==~~No LSB modules are available.

使用pacman包管理工具可以安装OPi OS中没有的软件，比如安装vim编辑器的命令如下所示，如果想安装其他软件，只需要把vim替换想要安装的软件的包名即可。Distributor ID: Ubuntu

~~[orangepi@orangepi-pc ~]$ '''sudo pacman -Syy vim'''~~Description: Ubuntu 22.04 LTS

Release: '''22.04'''

= Codename: '''~~Android 12 TV系统使用说明~~jammy''' =|}

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

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

|-

| ~~Android版本| 内核版本~~|[https://repo.huaweicloud.com/ubuntu-releases/21.04/ubuntu-21.04-desktop-| amd64.iso '''~~Android 12 TV版'''| '''linux5~~https://mirrors.tuna.tsinghua.edu.cn/ubuntu-releases/22.04/ubuntu-22.04-desktop-amd64.4iso''']

|}

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

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

|-

| [https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/ '''~~主板功能~~https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/''']| }</ol><ol start="2" style="list-style-type: lower-alpha;"><li>注意Ubuntu版本需要切换到22.04。[[File:zero2w-img276.png]]</li><li>需要替换的'''~~Android12 TV~~/etc/apt/sources.list'''文件的内容为：{| class="wikitable" style="width:800px;"

|-

| test@test:~$ '''~~HDMI视频~~sudo mv /etc/apt/sources.list cat /etc/apt/sources.list.bak'''| test@test:~$ '''OKsudo vim /etc/apt/sources.list'''# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse # 预发布软件源，不建议启用# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse|# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse| ~~'''HDMI音频'''~~}</li><li>替换完后需要更新下包信息，并确保没有报错。{| ~~'''OK'''~~class="wikitable" style="width:800px;"

|-

| test@test:~$ '''~~Type~~sudo apt-~~C USB2.0 x 2~~get update'''| }</li><li>'''OK另外，由于内核和U-boot等源码都是存放在GitHub上的，所以编译镜像的时候请确保电脑能正常从GitHub下载代码，这点是非常重要的。'''</li></ol> == 获取linux sdk的源码 == === 从github下载orangepi-build === linux sdk指的是orangepi-build这套代码，orangepi-build是基于armbian build编译系统修改而来的，使用orangepi-build可以编译出多个版本的linux镜像。使用下面的命令可以下载orangepi-build的代码： {| class="wikitable" style="width:800px;"

|-

| test@test:~$ '''~~TF卡启动~~sudo apt-get update'''| test@test:~$ '''sudo apt-get install -y git''' test@test:~$ '''OKgit clone https://github.com/orangepi-xunlong/orangepi-build.git -b next'''|}{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

| <big>'''~~WIFI~~注意，使用H618 Soc的开发板是需要下载orangepi-build的next分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。''' [[File:zero2w-img277.png|center| ~~'''OK'''~~795px]]</big>|}{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

| <big>'''蓝牙通过git clone命令下载orangepi-build的代码是不需要输入github账号的用户名和密码的（下载本手册中的其他代码也是一样的），如果如输入git clone命令后Ubuntu PC提示需要输入github账号的用户名和密码，一般都是git clone后面的orangepi-build仓库的地址输入错误了，请仔细检查命令拼写是否有错误，而不是以为我们这里忘了提供github账号的用户名和密码。'''</big>|} H618系列开发板当前使用的u-boot和linux内核版本如下所示： {| ~~'''OK'''~~class="wikitable" style="width:800px;text-align: center;"

|-

| '''~~USB摄像头~~分支'''| '''OKu-boot版本'''| '''linux内核版本'''

|-

| '''~~LED灯~~current'''| '''OKu-boot v2018.05'''| '''linux5.4'''

|-

| '''~~40pin GPIO~~next'''| '''OKu-boot v2021.07'''| '''linux6.1'''|} {| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

| <big>'''~~40pin I2C~~这里所说的分支和orangepi-build源代码的分支不是同一个东西，请不要搞混了。此分支主要是用来区分不同内核源码版本的。''' '''目前全志提供的linux5.4 bsp内核我们定义为current分支。最新的linux6.1 LTS内核定义为next分支。'''</big>| } orangepi-build下载完后会包含下面的文件和文件夹： <ol style="list-style-type: lower-alpha;"><li>'''build.sh''': 编译启动脚本</li><li>'''external''': 包含编译镜像需要用的配置文件、特定的脚本以及部分程序的源码等</li><li>'''LICENSE''': GPL 2许可证文件</li><li>'''README.md''OK': orangepi-build说明文件</li><li>'''scripts''': 编译linux镜像的通用脚本{| class="wikitable" style="width:800px;"

|-

| test@test:~/orangepi-build$ '''~~40pin SPI1~~ls'''| '''OKbuild.sh external LICENSE README.md scripts'''|}{| class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

|}

</li></ol>

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

~~{| class="wikitable"~~|orangepi-| build第一次运行的时候会自动下载交叉编译工具链放在'''~~24pin扩展板功能~~toolchains'''| 文件夹中，每次运行orangepi-build的build.sh脚本后，都会检查'''~~Android12 TV~~toolchains'''中的交叉编译工具链是否都存在，如果不存在则会重新开始下载，如果存在则直接使用，不会重复下载。 <div class="figure"> |[[File:zero2w-img278.png]] </div>交叉编译工具链在中国境内的镜像网址为清华大学的开源软件镜像站：~~| '''百兆网口'''~~{| ~~'''OK'''~~class="wikitable" style="width:800px;"

|-

| ~~'''百兆网口灯'''| '''OK'''~~|[https://mirrors.tuna.tsinghua.edu.cn/armbian-| releases/_toolchain/ '''~~USB2~~https://mirrors.~~0 HOST x 2'''| '''OK'''~~|-~~| '''红外接收'''| '''OK'''~~|-~~| '''耳机音频播放'''| '''OK'''~~|-~~| '''开关机按键'''| '''OK'''~~|-~~| '''LRADC自定义按键 x 2'''| '''OK，默认设置为音量加减按键'''~~|tuna.tsinghua.edu.cn/armbian-~~| '''TV-OUT'''| '''OK~~releases/_toolchain/''']

|}

~~== 板载LED灯显示说明 ==~~'''toolchains'''下载完后会包含多个版本的交叉编译工具链：

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

|-

|| test@test:~/orangepi-build$ '''绿灯ls toolchains/'''~~| '''红灯'''~~|gcc-arm-11.2-2022.02-~~| '''u~~x86_64-aarch64-none-~~boot启动阶段'''| '''灭'''| '''亮'''~~|linux-~~| '''内核启动到进入系统'''| '''亮'''| '''亮'''~~|}gnu

~~== Android返回上一级界面的方法 ==~~gcc-linaro-4.9.4-2017.01-x86_64_aarch64-linux-gnu

我们一般都是使用鼠标和键盘来控制开发板的安卓系统，当进入某些界面，需要返回上一级界面或者桌面时，只能通过'''鼠标右键'''来返回，键盘是无法返回的。gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabi

如果有购买开发板配套的红外遥控（其他遥控不行）和24pin扩展板，将24pin扩展板接入开发板后，还可以通过遥控中的返回键来返回上一级菜单，返回键的位置如下图所示：gcc-arm-11.2-2022.02-x86_64-arm-none-linux-gnueabihf

~~[[File:media/image308~~gcc-linaro-4.~~png]]~~9.4-2017.01-x86_64_arm-linux-gnueabi

~~== ADB的使用方法 ==~~gcc-linaro-aarch64-none-elf-4.8-2013.11_linux

~~=== 使用网络连接adb调试 ===~~gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu

'''使用网络adb无需USB Typc C接口的数据线来连接电脑和开发板，而是通过网络来通信，所以首先请确保开发板的有线或者无线网络已经连接好了，然后获取开发板的IP地址，后面要用到。'''gcc-linaro-5.5.0-2017.10-x86_64_arm-linux-gnueabihf

~~<ol style="list~~gcc-~~style~~linaro-~~type: decimal;"><li>确保Android系统的'''service.adb~~arm-linux-gnueabihf-4.~~tcp.port'''设置为5555端口号apollo~~8-~~p2:/ # '''getprop | grep "adb.tcp"'''[service.adb.tcp.port]: [5555]</li><li>如果'''service.adb.tcp~~2014.~~port'''没有设置，可以在串口中使用下面的命令设置网络adb的端口号</li></ol>~~04_linux

~~apollo~~gcc-~~p2:/ # '''setprop service~~arm-9.~~adb~~2-2019.~~tcp.port 5555''' apollo~~12-x86_64-arm-none-linux-~~p2:/ # '''stop adbd'''~~gnueabihf

~~apollo~~gcc-~~p2:/ # '''start adbd'''~~linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu

~~<ol start="3" style="list~~gcc-~~style~~linaro-~~type: decimal;"><li>在Ubuntu PC上安装adb工具test@test:~$ '''sudo apt~~arm-~~get update'''test@test:~$ '''sudo apt~~none-~~get install~~ eabi-~~y adb'''</li><li>然后在Ubuntu PC上连接网络adbtest@test:~$ '''adb connect 192~~4.~~168.1.xxx:5555''' '''(需要修改为开发板的IP地址)'''* daemon not running; starting now at tcp:5037* daemon started successfullyconnected to 192.168.1.xxx:5555test@test:~$ '''adb devices'''List of devices attached192.168.1~~8-2014.~~xxx:5555 device</li>~~04_linux~~<li>然后在Ubuntu PC上通过adb shell就可以登录android系统</li></ol>~~|}

~~test@test:~$ '''adb shell'''~~编译H618 Linux内核源码使用的交叉编译工具链为：

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

<ol style="list-style-type: lower-alpha;"><li>v2018.05{| class="wikitable" style= ~~使用数据线连接adb调试 =~~"width:800px;" |-| '''gcc-linaro-7.4.1-2019.02-x86_64_arm-linux-gnueabi'''|}</li><li>v2021.07{| class="wikitable" style="width:800px;" |-| '''gcc-arm-11.2-2022.02-x86_64-aarch64-none-linux-gnu'''|}</li></ol>

~~<ol style~~=~~"list-style-type: decimal;">~~<li>准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的USB0接口中（USB0的位置请见下面右边图片的说明）。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板。~~[[File:media/image15.jpeg]] [[File:media/image309.png]]</li><li>在Ubuntu PC上安装adb工具test@test:~$ '''sudo apt-get update'''test@test:~$ '''sudo apt-get install -y adb'''</li><li>查看识别到ADB设备test@test:~$ '''adb devices'''List of devices attached4c00146473c28651dd0 device</li><li>然后在Ubuntu PC上通过adb shell就可以登录android系统</li></ol>~~ ~~test@test:~$ '''adb shell'''~~ ~~apollo-p2:/ $~~ ~~~~=orangepi-build完整目录结构说明 = ~~查看设置HDMI显示分辨率的方法~~ ==

<li>~~首先进入~~orangepi-build仓库下载完后并不包含linux内核、u-boot的源码以及交叉编译工具链，linux内核和u-boot的源码存放在独立的git仓库中<ol style="list-style-type: lower-alpha;"><li>linux内核源码存放的git仓库如下，注意切换linux-orangepi仓库的分支为<ol style="list-style-type: none;"><li>a) Linux5.4{| class="wikitable" style="width:800px;" |-| https://github.com/orangepi-xunlong/linux-orangepi/tree/'''~~Settings~~orange-pi-5.4-sun50iw9'''|}</li><li>b) Linux6.1{| class="wikitable" style="width:800px;" |-| ~~[[File~~https:~~media~~/~~image310~~/github.~~png]]~~com/orangepi-xunlong/linux-orangepi/tree/'''orange-pi-6.1-sun50iw9'''|}</li></ol></li><li>u-boot源码存放的git仓库如下，注意切换u-boot-orangepi仓库的分支为<ol style="list-style-type: none;"><li>~~然后选择~~a) v2018.05{| class="wikitable" style="width:800px;" |-| https://github.com/orangepi-xunlong/u-boot-orangepi/tree/'''~~Device Preferences~~v2018.05-h618'''|}</li><li>~~[[File~~b) v2021.07</li>{| class="wikitable" style="width:800px;" |-| https:~~media~~/~~image311~~/github.com/orangepi-xunlong/u-boot-orangepi/tree/'''v2021.~~png]]~~07-sunxi'''|}</ol></li></ol></li></ol><ol start="2" style="list-style-type: decimal;"><li>orangepi-build第一次运行的时候会去下载交叉编译工具链、u-boot和linux内核源码，成功编译完一次linux镜像后在orangepi-build中可以看到的文件和文件夹有</lip><ol style="list-style-type: lower-alpha;"><li>~~然后选择~~'''~~Display & Sound~~build.sh''': 编译启动脚本</li><li>~~[[File~~'''external''':~~media/image312.png]]~~包含编译镜像需要用的配置文件、特定功能的脚本以及部分程序的源码，编译镜像过程中缓存的rootfs压缩包也存放在external中</li><li>~~然后选择~~'''~~Advanced display settings~~kernel''': 存放linux内核的源码</li><li>~~[[File~~'''LICENSE''':~~media~~GPL 2许可证文件</~~image313~~li><li>'''README.~~png]]~~md''': orangepi-build说明文件</li><li>~~然后选择~~'''~~HDMI~~ output ~~mode~~''': 存放编译生成的u-boot、linux等deb包、编译日志以及编译生成的镜像等文件</li><li>~~[[File~~'''scripts''':~~media/image314.png]]~~编译linux镜像的通用脚本</li><li>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。'''toolchains''': 存放交叉编译工具链</li><li>~~[[File~~'''u-boot''':~~media/image315.png]]~~存放u-boot的源码</li><li>~~开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项~~'''userpatches''': 存放编译脚本需要用到的配置文件{| class="wikitable" style="width:800px;" |-| ~~[[File~~test@test:~~media~~~/~~image316~~orangepi-build$ '''ls''''''build.sh      external      kernel      LICENSE      output      README.~~png]]~~md      scripts      toolchains      u-boot      userpatches'''|}</li></ol></li></ol>

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

<li>~~首先需要准备下面的配件~~运行build.sh脚本，记得加sudo权限~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>HDMI转VGA转换器~~|-~~[[File:media/image146.png]]</li><li>一根VGA线和一个Mini HDMI公转HDMI母的转接头~~| ~~[[File~~test@test:~~media~~~/~~image147~~orangepi-build$ '''sudo .~~png]] [[File:media~~/~~image148~~build.~~png]]~~sh'''</p~~></li~~>~~<li>一个支持VGA接口的显示器或者电视</li></ol>~~|}

</li>

<li>~~HDMI转VGA显示测试如下所示[[File:media/image317.png]]~~选择'''使用HDMI转VGA显示时，开发板以及开发板的Android系统是不需要做任何设置的，只需要开发板Mini HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</li></ol> ~~== WI-FI的连接方法 ==~~ ~~<ol style="list-style-type: decimal;"><li>首先选择'''Settings'''[[File:media/image310.png]]</li><li>然后选择'''Network & Internet'''[[File:media/image318.png]]</li><li>然后打开WI~~U-~~FI[[File:media/image319.png]]</li><li>打开WI-FI后在''~~boot package'~~Available networks~~''~~'下面就可以看到搜索到的信号[[File:media/image320.png]]</li><li>选择想连接的WI-FI后会弹出下图所示的密码输入界面~~，然后回车

[[File:~~media/image321~~zero2w-img279.png]]

</div></li>

<li>~~然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了~~接着选择开发板的型号[[File:~~media/image322~~zero2w-img280.png]]</li><li>WI然后选择u-~~FI连接成功后的显示如下图所示~~boot的分支类型~~[[File:media/image323.png]]</li></ol>~~ ~~== WI-FI hotspot的使用方法 ==~~ <ol style="list-style-type: ~~decimal~~lower-alpha;"><li>~~首先请确保以太网口已连接网线，并且能正常上网~~current分支会编译linux5.4镜像需要使用的u-boot v2018.05版本的代码</li><li>~~然后选择'''Settings'''~~next分支会编译linux6.1镜像需要使用的u-boot v2021.07版本的代码[[File:~~media/image310~~zero2w-img281.png]]</li></ol></li><li>~~然后选择'''Network & Internet'''~~如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择<ol style="list-style-type: lower-alpha;"><li>~~[[File:media/image318~~如果购买的开发板为1.~~png]]~~5GB内存大小的，请选择第一项</li><li>~~然后选择'''WIFI hotspot'''~~如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项[[File:~~media/image324~~zero2w-img282.png]]</li></ol></li><li>然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）然后就会开始编译u-boot，编译next分支时提示的部分信息说明如下所示：<~~p>[[File~~ol style="list-style-type:~~media/image325.png]]</li~~lower-alpha;"><li>~~此时可以拿出你的手机，如果一切正常，在手机搜索到的WI~~u-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password'''下面可以看到boot源码的版本{| class="wikitable" style="width:800px;" |-| [o.k. ] Compiling u-boot [~~File:media/image326~~'''v2021.~~png]~~07''' ]|}</li><li>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot'''能正常使用交叉编译工具链的版本{| class="wikitable" style="width:800px;" |-| [~~[File:media/image327~~o.k.~~png~~]Compiler version [ '''aarch64-linux-gnu-gcc 11''' ]|}</li><~~/ol~~li> <~~span id="查看以太网口ip地址的方法"~~p>编译生成的u-boot deb包的路径</~~span~~p>{| class=~~= 查看以太网口IP地址的方法 ==~~ ~~<ol~~ "wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>开发板主板上是没有有线网络接口的，我们可以通过24pin扩展板来扩展百兆以太网~~|-| [o.k. ] Target directory [~~File:media~~'''orangepi-build/output/debs/~~image107.png]~~u-boot''' ]|}</li><li>~~然后请确保扩展板的网口连接到了路由器或者交换机~~编译生成的u-boot deb包的包名~~</li><li>~~{| class="wikitable" style="width:800px;" |-| ~~然后打开~~[ o.k. ] File name [ '''~~Settings~~linux-u-boot-next-orangepizero2w_x.x.x_arm64.deb''']~~[[File:media/image328.png]]~~|}</li><li>~~然后选择'''Network & Internet'''~~编译使用的时间{| class="wikitable" style="width:800px;" |-| [~~[File:media/image329~~o.k.~~png~~]Runtime [ '''1 min''' ]|}</li><li>~~然后在下图所示的位置就能看到开发板有线网口的IP地址了~~重复编译u-boot的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译u-boot{| class="wikitable" style="width:800px;" |-| [o.k. ] Repeat Build Options [~~File:media~~'''sudo ./~~image330~~build.~~png]~~sh BOARD=orangepizero2w BRANCH=next BUILD_OPT=u-boot''' ]|}</li></ol></li><li>查看编译生成的u-boot deb包{| class=~~= 蓝牙的连接方法 ==~~ ~~<ol~~ "wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>~~|-| ~~首先选择~~test@test:~/orangepi-build$ '''~~Settings~~ls output/debs/u-boot/'''~~[[File:media/image310~~'''linux-u-boot-next-orangepizero2w_x.x.x_arm64.~~png]]~~deb'''|}</li><li>~~然后选择~~orangepi-bulid编译系统编译u-boot源码时首先会将u-boot的源码和github服务器的u-boot源码进行同步，所以如果想修改u-boot的源码，首先需要关闭源码的下载更新功能（'''~~Bluetooth~~需要完整编译过一次u-boot后才能关闭这个功能，否则会提示找不到u-boot的源码'''），否则所作的修改都会被还原，方法如下：~~[[File:media~~设置'''userpatches/~~image331~~config-default.~~png]]~~conf'''中的IGNORE_UPDATES变量为”yes”~~</li><li>~~{| class="wikitable" style="width:800px;" |-| ~~然后打开~~test@test:~/orangepi-build$ '''~~Bluetooth Enable~~vim userpatches/config-default.conf'''~~[[File:media/image332~~.~~png]]~~.....</p~~></li~~>~~<li>~~~~然后点击~~IGNORE_UPDATES="'''~~Pair new device~~yes'''~~开始扫描周围的蓝牙设备~~"~~[[File:media/image333~~.~~png]]~~.....|}</li><li>~~搜索到的蓝牙设备会在'''Available devices'''下面显示出来~~调试u-boot代码时，可以使用下面的方法来更新linux镜像中的u-boot进行测试<pol style="list-style-type: lower-alpha;"><li>~~[[File:media/image334.png]]~~首先将编译好的u-boot的deb包上传到开发板的linux系统中</lip>~~<li>~~{| class="wikitable" style="width:800px;" |-| ~~然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择~~test@test:~/orangepi-build$ '''~~Pair~~cd output/debs/u-boot'''选项~~[[File~~test@test:~~media~~~/orangepi_build/~~image335.png]]<~~output/~~p><~~debs/~~li><li>这里测试的是开发板和~~u-boot$ '''~~安卓手机~~scp \'''~~蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程~~'''linux-u-boot-next-orangepizero2w_x.x.x_arm64.deb [~~[File~~mailto:root@192.168.1.xxx:~~media~~/~~image336~~root root@192.168.1.~~png]~~xxx:/root]'''|}</li><li>~~配对完成后，再打开'''Paired devices'''下面就可以看到已配对的蓝牙设备~~再安装刚才上传的新的u-boot的deb包{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media/image337~~~$ '''sudo dpkg -i''' '''linux-u-boot-next-orangepizero2w_x.x.x_arm64.~~png]]~~deb'''|}</li><li>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了然后运行 nand-sata-install脚本{| class="wikitable" style="width:800px;" |-| ~~[[File~~orangepi@orangepi:~~media/image338.png]]~~~$ '''sudo nand-sata-install'''|}</li><li>~~开发板Android系统蓝牙接收到的图片可以打开~~然后选择'''~~Received files~~5 Install/Update the bootloader on SD/eMMC'''~~中查看~~[[File:~~media/image339~~zero2w-img283.png]]</li~~></ol>~~ ~~== USB0设置为HOST模式的方法 ==~~ 如下图所示，开发板的主板上有两个Type-C类型的接口：USB0和USB1，这两个接口都可以用来给开发板供电，也都可以用来当做USB2.0 HOST接口。USB0和USB1的区别是：USB0除了可以设置为HOST模式外，还可以设置为Device模式，而USB1只有HOST模式。 ~~[[File:media/image163.png]]~~ Orange Pi发布的Android12 TV系统USB0默认设置为Device模式，所以在不需要使用USB0 Device模式时（ADB功能需要确保USB0为Device模式），建议使用USB0来供电，这样USB1就可以直接用来接USB设备。 ~~如果想使用USB0来接USB设备，需要把USB0设置为HOST模式，方法如下所示：~~ ~~<ol style="list-style-type: lower-alpha;"~~><li>~~运行下面的命令可以将USB0设置为HOST模式：~~按下回车键后首先会弹出一个Warning~~apollo-p2~~[[File:~~/ # '''cat /sys/devices/platform/soc@3000000/soc@3000000\:usbc0@0/usb_host'''host_chose finished!apollo~~zero2w-~~p2:/ #~~img284.png]]</li><li>~~运行下面的命令可以切回Device模式~~再按下回车键就会开始更新u-boot，更新完后会显示下面的信息~~apollo-p2~~[[File:~~/ # '''cat /sys/devices/platform/soc@3000000/soc@3000000\:usbc0@0/usb_device'''device_chose finished!apollo~~zero2w-~~p2:/ #~~img285.png]]</li><li>~~查看USB0当前模式的命令为~~然后就可以重启开发板来测试u-boot的修改是否生效了<p/li>~~apollo-p2:/ # '''cat /sys/devices/platform/soc@3000000/soc@3000000\:usbc0@0/otg_role'''~~</pol>~~usb_host~~</li></ol>

~~~~=~~= USB摄像头使用方法~~ 编译linux内核 ==

<li>~~首先在开发板的USB接口中插入USB（UVC协议）摄像头</li><li>USB摄像头如果识别正常，在/dev下会生成相应的video设备节点console:/ #~~ 运行'''~~ls /dev/video0~~build.sh'''脚本，记得加sudo权限~~/dev/video0</li><li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l~~{|~~'''ADB的使用方法''']]一小节的说明</li><li>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP[[File:media/image340.png]][[File:media/image341.png]]</li><li>然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装test@test:~$ '''adb install usbcamera.apk'''</li><li>安装完后在Android的桌面可以看到USB摄像头的启动图标[[File:media/image342.png]]</li><li>然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了</li></ol>~~ ~~== Android系统ROOT说明 ==~~ ~~'''<span~~ class="~~mark~~wikitable"~~>Orange Pi发布的Android系统已经ROOT，可以使用下面的方法来测试。'''~~ ~~<ol~~ style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''[[File:media/image340.png]][[File:media/image343.png]]</li>~~|-~~<li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l~~|~~'''ADB的使用方法''']]一小节的说明</li><li>然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装~~test@test:~/orangepi-build$ '''~~adb install rootcheck~~sudo .~~apk'''</li><li>安装完后在Android的桌面可以看到ROOT测试工具的启动图标[[File:media/image344.png]]</li><li>第一次打开'''ROOT测试工具'''后的显示界面如下图所示[[File:media~~/~~image345~~build.~~png]]</li><li>然后就可以点击~~sh'''~~CHECK NOW'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限[[File:media/image346.png]]~~</p~~></li></ol>~~ ~~</span~~>~~== 使用MiracastReceiver将手机屏幕投屏到开发板的方法 ==~~ ~~<ol style="list-style-type: decimal;"><li>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[\l~~|~~'''WI-FI的连接方法''']]一小节的说明</li>~~}~~<li>然后打开开发板安卓系统中的'''MiracastReceiver'''应用[[File:media/image347.png]]~~</li><li>选择'''~~MiracastReceiver~~Kernel package'''~~打开后的界面如下所示~~，然后回车

[[File:~~media/image348~~zero2w-img286.png]]

</div></li>

<li>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个[[File:~~media/image349~~zero2w-img287.png]]</li><li>~~等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可~~接着选择开发板的型号[[File:~~media/image350~~zero2w-img280.png]]</li><li>~~然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可~~然后选择内核源码的分支类型<ol style="list-style-type: lower-alpha;"><li>current分支会编译linux5.4内核源码</li><li>next分支会编译linux6.1内核源码[[File:~~media/image351~~zero2w-img281.png]]</li></ol></li><li>~~然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了~~如果第3)步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码。[[File:~~media/image352~~zero2w-img288.png]]</li~~></ol~~>

~~== 通过按键或红外遥控开关机的方法 ==~~ 我们可以通过开关机按键或者红外遥控来关闭或开启开发板的安卓系统。但是需要注意的是，开发板主板上是没有开关机按键和红外接收器的，需要通过24pin扩展板来扩展。 ~~[[File:media/image107.png]]~~ ~~24pin扩展板上的开关机按键所在位置如下图所示：~~ ~~[[File:media/image274.png]]~~ ~~红外遥控电源按键所在位置如下所示：~~ ~~[[File:media/image353.png]]~~ ~~关机时，我们需要长按开关机按键或者红外遥控上的电源按键，然后安卓系统会弹出下图所示的确认对话框，然后选择'''OK'''就会关闭安卓系统了。~~ ~~[[File:media/image354.png]]~~ ~~关机后，再次长按开关机按键或者红外遥控上的电源按键就会开机了。~~ <~~span id~~ol style="~~pin~~list-接口style-~~gpiouartspi~~type: lower-测试alpha;"><~~/span~~li>~~== 40pin 接口 GPIO、UART、SPI 测试 ==~~ 如果不需要修改内核的配置选项，在运行build.sh脚本时，传入'''~~注意：40pin接口上的排针默认是不焊接的，需要自己焊接上去才能使用。~~KERNEL_CONFIGURE=no''' ~~~~就可临时屏蔽弹出内核的配置界面了</~~span~~p>{| class=~~== 40pin的GPIO口测试方法 ===~~ ~~<ol~~ "wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>首先在桌面中打开wiringOP APP~~|-| ~~[[File~~test@test:~~media~~~/~~image355~~orangepi-build$ '''sudo ./build.~~png]]~~sh KERNEL_CONFIGURE=no'''|}</li><li>~~然后点击~~也可以设置orangepi-build/userpatches/config-default.conf配置文件中的'''~~GPIO_TEST~~KERNEL_CONFIGURE=no'''~~按钮打开GPIO测试界面[[File:media/image356.png]]~~，这样可以永久禁用这个功能</li><li>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮和40pin引脚是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平会设置为低电平；当点击'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息；当点击'''BLINK ALL GPIO'''按钮时，会让所有的GPIO口循环输出高低电平，使用这个功能可以用来测试40pin中所有的GPIO口。编译内核的时候如果提示下面的错误，这是由于Ubuntu PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu PC的终端调到最大，然后重新运行build.sh脚本[[File:~~media/image357~~zero2w-img289.png]]</li><li/ol>~~然后点击'''GPIO READALL'''按钮，输出信息如下图所示：~~</pol><~~div class~~ol start="~~figure~~7" style="> ~~[[File~~list-style-type:~~media/image358.png]]~~ ~~</div></li~~decimal;"><li>开发板40pin中总共有28个GPIO口可以使用，下面以12号引脚——对应GPIO为PI01——对应wPi序号为6——为例演示如何设置GPIO口的高低电平。首先点击12号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，12号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功。编译next分支内核源码时提示的部分信息说明如下：<~~p>[[File~~ol style="list-style-type:~~media/image359.png]]</li~~lower-alpha;"><li>~~然后点击'''GPIO READALL'''按钮，可以看到当前的12号引脚模式为'''OUT'''，引脚电平为高电平~~linux内核源码的版本{| class="wikitable" style="width:800px;" |-| [~~[File:media/image360~~o.k.~~png~~]~~]</li><li>再次点击下图的~~Compiling current kernel [ '''~~CheckBox~~6.1.31'''~~按钮取消勾选状态，12号引脚就会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功~~]~~[[File:media/image361.png]]~~|}</li><li>~~然后点击'''GPIO READALL'''按钮，可以看到当前的12号引脚模式为OUT，引脚电平为低电平[[File:media/image362.png]]~~使用的交叉编译工具链的版本</p~~></li></ol>~~ ~~</span~~>~~=== 40pin的UART测试方法 ===~~ ~~# 由下表可知，Android12 TV系统默认可用的uart有uart2和uart5。请注意uart0默认设置为调试串口，请不要把uart0当成普通串口使用。~~ {| class="wikitable" style="width:800px;"

|-

| ~~'''GPIO序号'''~~| [ o.k. ] Compiler version [ '''~~GPIO~~aarch64-linux-gnu-gcc 11''']| ~~'''功能'''~~}~~| '''引脚'''~~</li>|<li>内核默认使用的配置文件以及它存放的路径如下所示{| ~~'''引脚'''| '''功能'''| '''GPIO'''| '''GPIO序号'''~~class="wikitable" style="width:800px;"

|-

~~| style="text-align: left;"~~|~~| style="text-align: left;"|~~| [ o.k. ] Using kernel config file [ '''3orangepi-build/external/config/kernel/linux-6.~~3V'''| '''~~1-sun50iw9-next.config''']|}~~| '''2'''~~</li>~~| '''5V'''~~<li>编译生成的内核相关的deb包的路径{| ~~style~~class="~~text-align: left;~~wikitable"|| style="~~text-align~~width: ~~left~~800px;"|

|-

| ~~'''264'''| '''PI8'''| '''TWI1-SDA'''~~| [ o.k. ] Target directory [ '''3output/debs/''']|}~~| '''4'''~~</li>~~| '''5V'''~~<li>编译生成的内核镜像deb包的包名{| ~~style~~class="~~text-align: left;~~wikitable"|| style="~~text-align~~width: ~~left~~800px;"|

|-

| ~~'''263'''~~| [ o.k. ] File name [ '''~~PI7'''| '''TWI1~~linux-image-next-~~SCL'''| '''5~~sun50iw9_x.x.x_arm64.deb''']|}~~| '''6'''~~</li>~~| '''GND'''~~<li>编译使用的时间{| ~~style~~class="~~text-align: left;~~wikitable"|| style="~~text-align~~width: ~~left~~800px;"|

|-

| ~~'''269'''~~| [ o.k. ] Runtime [ '''~~PI13~~10 min''']| ~~'''PWM3'''~~}~~| '''7'''~~</li>|<li>最后会显示重复编译上一次选择的内核的编译命令，使用下面的命令无需通过图形界面选择，可以直接开始编译内核源码{| ~~'''8'''| '''UART0_TX'''| '''PH0'''| '''224'''~~class="wikitable" style="width:800px;"

|-

| ~~style~~[ o.k. ] Repeat Build Options [ '''sudo ./build.sh BOARD=orangepizero2w BRANCH=next BUILD_OPT=kernel KERNEL_CONFIGURE=~~"text-align: left;"~~no''' ]|}| </li></ol></li><li>查看编译生成的内核相关的deb包<ol style="~~text~~list-~~align~~style-type: ~~left~~lower-alpha;"|>| <li>'''~~GND~~linux-dtb-next-sun50iw9_x.x.x_arm64.deb'''包含有内核使用的dtb文件</li>| <li>'''~~9'''~~|~~| '''10~~linux-headers-next-sun50iw9_x.x.x_arm64.deb'''包含内核头文件</li>| <li>'''~~UART0_RX~~linux-image-next-sun50iw9_x.x.x_arm64.deb'''包含内核镜像和内核模块{| ~~'''PH1'''| '''225'''~~class="wikitable" style="width:800px;"

|-

| test@test:~/orangepi-build$ '''~~226~~ls output/debs/linux-*'''output/debs/linux-dtb-next-sun50iw9_x.x.x_arm64.deboutput/debs/linux-headers-next-sun50iw9_x.x.x_arm64.deboutput/debs/linux-image-next-sun50iw9_x.x.x_arm64.deb| }</li></ol></li><li>orangepi-bulid编译系统编译linux内核源码时首先会将linux内核源码和github服务器的linux内核源码进行同步，所以如果想修改linux内核的源码，首先需要关闭源码的更新功能（'''~~PH2~~需要完整编译过一次linux内核源码后才能关闭这个功能，否则会提示找不到linux内核的源码'''），否则所作的修改都会被还原，方法如下：| 设置'''~~UART5_TX~~userpatches/config-default.conf'''中的IGNORE_UPDATES变量为”yes”{| class="wikitable" style="width:800px;" |-| test@test:~/orangepi-build$ '''11vim userpatches/config-default.conf'''|| IGNORE_UPDATES="'''12yes'''"| }</li><li>如果对内核做了修改，可以使用下面的方法来更新开发板linux系统的内核和内核模块<ol style="~~text~~list-style-~~align~~type: ~~left~~lower-alpha;"|>~~| '''PI1'''~~<li>将编译好的linux内核的deb包上传到开发板的linux系统中{| ~~'''257'''~~class="wikitable" style="width:800px;"

|-

| ~~'''227'''~~| test@test:~/orangepi-build$ '''~~PH3~~cd output/debs'''| test@test:~/orangepi-build/output/debs$ '''~~UART5_RX~~scp \'''| '''13linux-image-next-sun50iw9_x.x.x_arm64.deb root@192.168.1.xxx:/root'''|}~~| '''14'''~~</li>~~| '''GND'''~~<li>再安装刚才上传的新的linux内核的deb包{| ~~style~~class="~~text-align: left;~~wikitable"|| style="~~text-align~~width: ~~left~~800px;"|

|-

| ~~'''261'''~~| orangepi@orangepi:~$ '''~~PI5~~sudo dpkg -i linux-image-next-sun50iw9_x.x.x_arm64.deb'''| ~~'''UART2_TX'''~~}~~| '''15'''~~</li>|<li>然后重启开发板，再查看内核相关的修改是否已生效{| ~~'''16'''| '''PWM4'''| '''PI14'''| '''270'''~~class="wikitable" style="width:800px;"

|-

~~| style="text-align: left;"~~|~~| style="text-align~~orangepi@orangepi: ~~left;"|~~| ~$ '''~~3.3V~~sudo'''| '''17reboot'''|}</li></ol></li></ol> == 编译rootfs ==~~| '''18'''~~| <ol style="~~text~~list-style-~~align~~type: ~~left~~decimal;"|>~~| '''PH4'''~~<li>运行build.sh脚本，记得加sudo权限{| ~~'''228'''~~class="wikitable" style="width:800px;"

|-

| test@test:~/orangepi-build$ '''~~231~~sudo ./build.sh'''| }</li><li>选择'''~~PH7~~Rootfs and all deb packages'''，然后回车</li> <div class="figure"> [[File:zero2w-img290.png]] </div></ol><ol start="3" style="list-style-type: decimal;"><li>接着选择开发板的型号[[File:zero2w-img280.png]]</li><li>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别<ol style="list-style-type: lower-alpha;"><li>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</li><li>next分支可以看到debian11、debian12、ubuntu22.04三个选项[[File:zero2w-img281.png]]</li></ol></li><li>然后选择rootfs的类型[[File:zero2w-img291.png]]</li><li>然后选择镜像的类型<ol style="list-style-type: lower-alpha;">| <li>'''~~SPI1_MOSI~~Image with console interface (server)'''表示服务器版的镜像，体积比较小</li>| <li>'''19Image with desktop environment'''表示带桌面的镜像，体积比较大<div class="figure"> [[File:zero2w-img292.png]] </div></li></ol>|</li>| <li>如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（'''20没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了'''）<div class="figure"> [[File:zero2w-img293.png]] </div></li><li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面[[File:zero2w-img294.png]][[File:zero2w-img295.png]]~~| '''GND'''~~然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。[[File:zero2w-img296.png]]</li><li>然后就会开始编译rootfs，编译时提示的部分信息说明如下| <ol style="~~text~~list-style-~~align~~type: ~~left~~lower-alpha;"|><li>rootfs的类型{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"|

|-

| ~~'''232'''~~| [ o.k. ] local not found [ Creating new rootfs cache for '''~~PH8~~bullseye''']| ~~'''SPI1_MISO'''~~}~~| '''21'''~~</li>|<li>编译生成的rootfs压缩包的存放路径{| ~~'''22'''| '''UART2_RX'''| '''PI6'''| '''262'''~~class="wikitable" style="width:800px;"

|-

| ~~'''230'''~~| [ o.k. ] Target directory [ '''~~PH6~~orangepi-build/external/cache/rootfs''']| ~~'''SPI1_CLK'''~~}~~| '''23'''~~</li>|<li>编译生成的rootfs压缩包的名字{| ~~'''24'''| '''SPI1_CS0'''| '''PH5'''| '''229'''~~class="wikitable" style="width:800px;"

|-

| [ o.k. ] File name [ '''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4''' ]|}</li></ol></li><li>查看编译生成的rootfs压缩包<ol style="~~text~~list-style-~~align~~type: ~~left~~lower-alpha;"|><li>'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4'''是rootfs的压缩包，名字各字段的含义为| <ol style="~~text~~list-style-~~align~~type: ~~left~~none;"|>| <li>a) '''~~GND~~bullseye'''表示rootfs的linux发行版的类型</li>| <li>b) '''25xfce'''|| 表示rootfs为桌面版的类型，如果为'''26cli'''则表示服务器版类型</li>| <li>c) '''~~SPI1_CS1~~arm64'''表示rootfs的架构类型</li>| <li>d) '''~~PH9~~25250ec7002de9e81a41de169f1f89721'''是由rootfs安装的所有软件包的包名生成的MD5哈希值，只要没有修改rootfs安装的软件包的列表，那么这个值就不会变，编译脚本会通过这个MD5哈希值来判断是否需要重新编译rootfs</li></ol>| </li><li>'''~~233~~bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list'''列出了rootfs安装的所有软件包的包名{| class="wikitable" style="width:800px;"

|-

| test@test:~/orangepi-build$ '''~~266~~ls external/cache/rootfs/'''bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4bullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.currentbullseye-xfce-arm64.5250ec7002de9e81a41de169f1f89721.tar.lz4.list| }</li></ol></li><li>如果需要的rootfs在'''~~PI10~~external/cache/rootfs'''| 下已经存在，那么再次编译rootfs就会直接跳过编译过程，不会重新开始编译，编译镜像的时候也会去'''~~TWI2-SDA~~external/cache/rootfs'''下查找是否已经有缓存可用的rootfs，如果有就直接使用，这样可以节省大量的下载编译时间</li></ol>~~| '''27'''~~|== 编译linux镜像 ==~~| '''28'''| '''TWI2~~<ol style="list-style-~~SCL'''~~type: decimal;">| <li>运行'''~~PI9~~build.sh'''脚本，记得加sudo权限{| ~~'''265'''~~class="wikitable" style="width:800px;"

|-

| test@test:~/orangepi-build$ '''~~256~~sudo ./build.sh'''| }</li><li>选择'''~~PI0~~Full OS image for flashing'''，然后回车</li>~~| style~~<div class="~~text-align: left;~~figure"|>~~| '''29'''~~|[[File:zero2w-img297.png]]~~| '''30'''| '''GND'''~~</div></ol>~~| style~~<ol start="~~text-align: left;~~3"|| style="~~text~~list-style-~~align~~type: ~~left~~decimal;"|><li>然后选择开发板的型号|[[File:zero2w-img280.png]]</li>~~| '''271'''| '''PI15'''~~<li>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别| <ol style="~~text~~list-style-~~align~~type: ~~left~~lower-alpha;"|>~~| '''31'''~~<li>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</li>|<li>next分支可以看到debian11、debian12、ubuntu22.04三个选项~~| '''32'''| '''PWM1'''| '''PI11'''| '''267'''~~|[[File:zero2w-img281.png]]</li></ol>~~| '''268'''| '''PI12'''| '''PWM2'''| '''33'''~~</li>|<li>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择~~| '''34'''| '''GND'''~~| <ol style="~~text~~list-~~align: left;"|~~| style~~="text~~-~~align~~type: ~~left~~lower-alpha;"||->~~| '''258'''~~<li>如果购买的开发板为1.5GB内存大小的，请选择第一项</li>~~| '''PI2'''~~<li>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项~~| style="text~~[[File:zero2w-~~align: left;"|| '''35'''~~img282.png]]</li></ol>|</li>~~| '''36'''~~<li>然后选择rootfs的类型~~| style="text-align~~[[File: ~~left;"|| '''PC12'''| '''76'''~~|zero2w-img291.png]]</li>~~| '''272'''~~<li>然后选择镜像的类型~~| '''PI16'''~~| <ol style="~~text~~list-~~align~~style-type: ~~left~~lower-alpha;"|>| <li>'''37Image with console interface (server)'''表示服务器版的镜像，体积比较小</li>|| <li>'''38Image with desktop environment'''表示带桌面的镜像，体积比较大~~| style~~<div class="~~text-align: left;~~figure"|>~~| '''PI4'''| '''260'''~~|-~~| style="text-align~~[[File: ~~left;"|| style="text~~zero2w-~~align: left;"|~~img292.png]]~~| '''GND'''| '''39'''~~</div></li></ol>|</li>| <li>如果是编译服务器版的镜像，还可以选择编译Standard版本或者Minimal版本，Minimal版本预装的软件会比Standard版本少很多（'''40没特殊需求请不要选择Minimal版本，因为很多东西默认没有预装，部分功能可能用不了'''）~~| style~~<div class="~~text-align: left;~~figure"|~~| '''PI3'''| '''259'''~~|}>

~~<ol start="2" style="list-style-type: decimal;"><li>uart2对应的设备节点为'''/dev/ttyAS2'''，uart5对应的设备节点为'''/dev/ttyAS5'''apollo-p2:/ # ls /dev/ttyAS*/dev/ttyAS0 /dev/ttyAS1 '''/dev/ttyAS2 /dev/ttyAS5'''</li><li>首先在桌面中打开wiringOP APP~~[[File:~~media/image355.png]]</li><li>然后点击'''UART_TEST'''按钮打开UART测试界面[[File:media/image363~~zero2w-img293.png]]~~</li><li>wiringOP的串口测试界面如下图所示</li></ol>~~

</div></li><li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面[[File:~~media~~zero2w-img294.png]]</~~image364~~p>[[File:zero2w-img295.png]]然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。[[File:zero2w-img296.png]]</li><li>然后就会开始编译linux镜像，编译的大致流程如下<ol ~~start="6"~~ style="list-style-type: ~~decimal~~lower-alpha;"><li>~~然后在选择框中选择'''~~初始化Ubuntu PC的编译环境，安装编译过程需要的软件包</li><li>下载u-boot和linux内核的源码（如果已经缓存，则只更新代码）</li><li>编译u-boot源码，生成u-boot的deb包</li><li>编译linux源码，生成linux相关的deb包</li><li>制作linux firmware的deb包</li><li>制作orangepi-config工具的deb包</li><li>制作板级支持的deb包</li><li>如果是编译desktop版镜像，还会制作desktop相关的deb包</li><li>检查rootfs是否已经缓存，如果没有缓存，则重新制作rootfs，如果已经缓存，则直接解压使用</li><li>安装前面生成的deb包到rootfs中</li><li>对不同的开发板和不同类型镜像做一些特定的设置，如预装额外的软件包，修改系统配置等</~~dev~~p></~~ttyAS2'''或者'''~~li><li>然后制作镜像文件，并格式化分区，默认类型为ext4</~~dev~~p></~~ttyAS5'''节点~~li><li>再将配置好的rootfs拷贝到镜像的分区中</li><li>然后更新initramfs~~[[File:media~~</~~image365.png]]~~li><li>最后将u-boot的bin文件通过dd命令写入到镜像中</li></ol></li><li>~~再在编辑框中输入想要设置的波特率，然后点击~~编译完镜像后会提示下面的信息<ol style="list-style-type: lower-alpha;"><li>编译生成的镜像的存放路径{| class="wikitable" style="width:800px;" |-| [ o.k. ] Done building [ '''~~OPEN~~output/images/orangepizero2w_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop/orangepizero2w_x.x.x_debian_bullseye_linux6.1.xx_xfce_desktop.img'''~~按钮打开uart节点，打开成功后，~~]|}</li><li>编译使用的时间</li>{| class="wikitable" style="width:800px;" |-| '''~~OPEN~~[ o.k. ] Runtime [ 19 min ]'''~~按钮变为不可选中状态，~~|}</ol><ol start="3" style="list-style-type: lower-alpha;"><li>重复编译镜像的命令，使用下面的命令无需通过图形界面选择，可以直接开始编译镜像{| class="wikitable" style="width:800px;" |-| [ o.k. ] Repeat Build Options [ '''~~CLOSE~~sudo ./build.sh BOARD=orangepizero2w BRANCH=next BUILD_OPT=image RELEASE=bullseye BUILD_MINIMAL=no BUILD_DESKTOP=no KERNEL_CONFIGURE=yes'''~~按钮和'''SEND'''按钮变为可选中状态~~]|}</li></ol></li></ol>

~~[[File:media~~</~~image366.png]]~~span>

~~<ol start~~=~~"8" style="list-style-type: decimal;"><li>然后使用杜邦线短接uart的rx和tx引脚</li><li>然后可以在下面的发送编辑框中输入一段字符，点击~~'''~~SEND~~Orange Pi OS Arch系统的使用说明'''~~按钮开始发送</li></ol>~~=

~~[[File:media~~</~~image367.png]]~~span>== Orange Pi OS Arch系统功能适配情况 ==

~~<ol start~~{| class="10wikitable" style="~~list-style~~width:800px;text-~~type~~align: ~~decimal~~center;">~~<li>如果一切正常，接收框内会显示已接收到的字符串</li></ol>~~|- ~~[[File:media/image368.png]]~~ ~~~~| '''主板功能'''~~=== 40pin的SPI测试方法 ===~~ ~~# 由下表可知，40pin接口可用的spi为spi1，有两个片选引脚cs0和cs1~~ {| ~~class="wikitable"~~'''OPi OS Arch'''

|-

| '''~~GPIO序号~~HDMI视频'''| '''~~GPIO'''| '''功能'''| '''引脚'''~~|~~| '''引脚'''| '''功能'''| '''GPIO'''| '''GPIO序号~~OK'''

|-

| ~~style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''1''~~'|| '''2HDMI音频'''| '''5VOK'''~~| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~264'''| '''PI8'''| '''TWI1~~Type-~~SDA'''| '''3~~C USB2.0 x 2'''|| '''4OK'''~~| '''5V'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~263~~TF卡启动'''| '''~~PI7~~OK'''~~| '''TWI1-SCL'''| '''5'''~~|~~| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~269~~WIFI'''| '''~~PI13'''| '''PWM3'''| '''7'''~~|~~| '''8'''| '''UART0_TX'''| '''PH0'''| '''224~~OK'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''9'''~~|~~| '''10'''| '''UART0_RX'''~~| '''~~PH1~~蓝牙'''| '''~~225~~OK'''

|-

| '''~~226~~LED灯'''| '''~~PH2'''| '''UART5_TX'''| '''11'''~~|~~| '''12'''| style="text-align: left;"|| '''PI1'''| '''257~~OK'''

|-

| '''~~227~~40pin GPIO'''| '''~~PH3~~OK'''| ~~'''UART5_RX'''~~-| '''1340pin I2C'''|~~| '~~''14'OK''| '~~''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~261~~40pin SPI'''| '''~~PI5'''| '''UART2_TX'''| '''15'''~~|~~| '''16'''| '''PWM4'''| '''PI14'''| '''270~~OK'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''17'''~~|~~| '''18'''| style="text-align: left;"|~~| '''~~PH4~~40pin UART'''| '''~~228~~OK'''

|-

| '''~~231~~40pin PWM'''| '''~~PH7~~OK'''~~| '''SPI1_MOSI'''| '''19'''~~|~~| '''20'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~232~~温度传感器'''| '''~~PH8'''| '''SPI1_MISO'''| '''21'''~~|~~| '''22'''| '''UART2_RX'''| '''PI6'''| '''262~~OK'''

|-

| '''~~230~~硬件看门狗'''| '''~~PH6~~OK'''| ~~'''SPI1_CLK'''| '''23'''~~|~~| '''24'''| '''SPI1_CS0'''~~-| '''~~PH5~~Mali GPU'''| '''~~229~~NO'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|~~| '''~~GND~~视频编解码'''| '''~~25'''~~|~~| '''26~~NO'''| ~~'''SPI1_CS1'''~~}~~| '''PH9'''~~{| ~~'''233'''~~class="wikitable" style="width:800px;text-align: center;"

|-

| ~~'''266'''| '''PI10'''| '''TWI2-SDA'''| '''27'''~~|~~| '''28'''| '''TWI2-SCL'''~~style="width:450px;" | '''~~PI9~~24pin扩展板功能'''| '''~~265~~OPi OS Arch'''

|-

| '''~~256~~百兆网口'''| '''~~PI0~~OK'''~~| style="text-align: left;"|| '''29'''~~|~~| '''30'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~271~~百兆网口灯'''| '''~~PI15'''| style="text-align: left;"|| '''31'''~~|~~| '''32'''| '''PWM1'''| '''PI11'''| '''267~~OK'''

|-

|-

| '''~~258'''| '''PI2'''| style="text~~TV-~~align: left;"|| '''35~~OUT'''|~~| '''36~~'''| NO'''

|}

<~~ol start~~span id="~~2" style="list~~orange-pi-~~style~~os-~~type: decimal;~~arch系统用户向导使用说明"><~~li>SPI1 CS0对应的设备节点为'''~~/~~dev/spidev1.0'''，SPI1 CS1对应的设备节点为'''/dev/spidev1.1'''</li></ol~~span>== Orange Pi OS Arch系统用户向导使用说明 ==

~~apollo-p2:/ # '''ls /dev/spidev1.*'''~~首先请注意，OPi OS Arch系统是没有设置默认的orangepi用户和密码的，所以烧录完系统启动后是无法直接通过串口和ssh远程登录的（root用户也不行）。这一点和Ubuntu、Debian系统是有区别的。

~~'''/dev/spidev1.0 /dev/spidev1.1'''~~OPi OS Arch系统第一次启动时需要接上HDMI显示器，然后通过用户向导来初始化系统设置（其中包括新建用户名和设置密码）。用户向导的设置步骤如下所示：

<ol ~~start="3"~~ style="list-style-type: ~~decimal~~lower-alpha;"><li>~~这里演示下通过'''w25qxx'''模块来测试SPI1接口，首先在SPI1接口接入w25qxx模块~~烧录完系统第一次启动进入桌面后会看到下图所示的用户向导程序</lip><~~/ol~~div class="figure">

'''如果没有w25qxx模块也没关系，因为开发板上有一个SPIFlash接在了SPI0上，在安卓中SPI0的配置默认也打开了，所以我们也可以直接使用板载的SPIFlash测试。'''[[File:zero2w-img298.png]]

~~<ol start="4" style="list-style-type: decimal;"><li>然后在桌面中打开wiringOP APP~~~~[[File:media/image355.png]]</p~~div></li><li>~~然后点击'''SPI_TEST'''按钮打开SPI的测试界面~~首先需要选择想要语言<~~p>[[File:media/image369.png]]</li>~~<li>然后在左上角选择spi的设备节点，如果直接测试板载的SPIFlash，那么保持默认的'''/dev/spidev0.0'''即可，如果在40pin的spi1 cs0上接了'''w25qxx'''模块，那么就请选择'''/dev/spidev1.0'''，如果在40pin的spi1 cs1上接了'''w25qxx'''模块，那么就请选择'''/dev/spidev1.1'''~~[[File:media/image370.png]]</li><li>然后点击'''OPEN'''按钮初始化SPI</li></ol~~div class="figure">

[[File:~~media/image371~~zero2w-img299.png]]

<~~ol start="8" style="list-style-type: decimal;"><li>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮[[File:media~~/~~image372.png]]</p~~div></li><li>~~最后APP会显示读取到的板载SPI Flash的ID信息~~在选择完语言后，用户向导会立即切换为对应的语言界面，如中文显示如下所示<~~/li></ol~~div class="figure">

[[File:~~media/image373~~zero2w-img300.png]]

<~~ol start="10" style="list-style-type: decimal;"~~/div></li><li>~~如果是读取接在40pin SPI1上的w25qxx模块，和板载SPI Flash的ID信息也是类似的~~然后选择区域</lip><~~/ol~~div class="figure">

~~=== 40pin的I2C测试方法 ===~~[[File:zero2w-img301.png]]

~~# 由下表可知，Android12 TV系统默认打开了i2c1和i2c2~~</div></li><li>然后选择键盘型号<div class="figure"> [[File:zero2w-img302.png]] </div></li><li>然后新建用户名和设置密码<div class="figure"> [[File:zero2w-img303.png]] </div></li><li>然后确保选择没问题后，再点击'''安装'''按钮<div class="figure"> [[File:zero2w-img304.png]] </div></li><li>然后等待安装完成<div class="figure">

[[File:zero2w-img305.png]] </div></li><li>安装完成需要点击'''完成'''按钮重启系统<div class="figure"> [[File:zero2w-img306.png]] </div></li><li>重启后会自动启动Orange Pi Hello程序，此时需要去掉右下角'''开机时启动'''的勾选状态，不然每次启动都需要手动关闭Orange Pi Hello程序<div class="figure"> [[File:zero2w-img307.png]] </div>此时就可以使用刚才新建的用户名和密码通过串口或者ssh登录OPi OS系统了。</li></ol> == 设置DT overlays的方法 == 开发板40pin中的I2C/SPI/UART/PWM等复用功能默认在内核的dts中都是关闭的，需要手动打开对应的DT overlays才能使用。在OPi OS Arch系统中打开DT overlays的方法如下所示： <ol style="list-style-type: decimal;"><li>首先打开'''/boot/extlinux/extlinux.conf'''配置文件{| class="wikitable" style="width:800px;"

|-

| ~~'''GPIO序号'''~~| test@test:~$ '''~~GPIO~~sudo putty'''| ~~'''功能'''~~}| [orangepi@orangepi-pc ~]$ '''引脚sudo vim /boot/extlinux/extlinux.conf'''</li>|| <li>然后在'''引脚/boot/extlinux/extlinux.conf'''| 中通过添加'''功能FDTOVERLAYS /dtbs/allwinner/overlay/xxx.dtbo'''来打开对应的配置</li>~~| '''GPIO'''~~{| ~~'''GPIO序号'''~~class="wikitable" style="background-color:#ffffdc;width:800px;"

|-

| ~~style~~<big>'''注意FDTOVERLAYS /dtbs/allwinner/overlay/xxx.dtbo中的xxx.dtbo需要替换为具体的dtbo配置，请不要照抄。'''</big>|}{| class="~~text-align: left;~~wikitable"|| style="~~text-align~~width: ~~left~~800px;"|-| [orangepi@orangepi-pc ~]$ '''3sudo vim /boot/extlinux/extlinux.3Vconf'''~~| '''1'''~~|LABEL Orange Pi KERNEL /Image FDT /dtbs/allwinner/sun50i-h616-orangepi-zero2w.dtb | '''2FDTOVERLAYS /dtbs/allwinner/overlay/xxx.dtbo'''#需要添加的配置| ~~'''5V'''~~}</ol>| <ol start="3" style="~~text~~list-style-~~align~~type: ~~left~~decimal;"|><li>xxx.dtbo在OPi OS Arch镜像中的存放路径如下所示，请注意，此路径下面不是所有的dtbo都可以使用的。{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"|

|-

| ~~'''264'''~~| '''~~PI8~~/boot/dtbs/allwinner/overlay/'''| ~~'''TWI1-SDA'''~~}~~| '''3'''~~</li>|<li>开发板可以使用的DT overlays配置如下所示</li>~~| '''4'''| '''5V'''~~{| ~~style~~class="~~text-align: left;~~wikitable"|| style="width:800px;text-align: ~~left~~center;"|

|-

| '''~~263~~开发板上的功能'''| '''~~PI7~~对应的DT overlays配置'''~~| '''TWI1-SCL'''| '''5'''~~|~~| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~269~~40pin - i2c0'''| '''~~PI13'''| '''PWM3'''| '''7'''~~|~~| '''8'''| '''UART0_TX'''| '''PH0'''| '''224~~sun50i-h616-pi-i2c0.dtbo'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|~~| '''~~GND~~40pin - i2c1'''| '''9sun50i-h616-pi-i2c1.dtbo'''|-| '''1040pin - i2c2'''| '''~~UART0_RX'''| '''PH1'''| '''225~~sun50i-h616-pi-i2c2.dtbo'''

|-

| '''~~226~~40pin - uart2'''| '''~~PH2'''| '''UART5_TX'''| '''11'''~~|~~| '''12'''| style="text~~sun50i-h616-pi-~~align: left;"|| '''PI1'''| '''257~~uart2.dtbo'''

|-

| '''~~227~~40pin - uart3'''| '''~~PH3'''| '''UART5_RX'''| '''13'''~~|~~| '''14''~~sun50i-h616-pi-uart3.dtbo'| ''~~'GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~261~~40pin - uart4'''| '''~~PI5'''| '''UART2_TX'''| '''15'''~~|~~| '''16'''| '''PWM4'''| '''PI14'''| '''270~~sun50i-h616-pi-uart4.dtbo'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|~~| '''~~3.3V~~40pin - uart5'''| '''~~17'''~~|~~| '''18'''| style="text~~sun50i-h616-ph-~~align: left;"|| '''PH4'''| '''228~~uart5.dtbo'''

|-

| '''~~231~~40pin - pwm1'''| '''~~PH7'''| '''SPI1_MOSI'''| '''19'''~~|~~| '''20''~~sun50i-h616-pi-pwm1.dtbo'| ''~~'GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~232~~40pin - pwm2'''| '''~~PH8'''| '''SPI1_MISO'''| '''21'''~~|~~| '''22'''| '''UART2_RX'''| '''PI6'''| '''262~~sun50i-h616-pi-pwm2.dtbo'''

|-

| '''~~230~~40pin - pwm3'''| '''~~PH6'''| '''SPI1_CLK'''| '''23'''~~|~~| '''24'''| '''SPI1_CS0'''| '''PH5'''| '''229~~sun50i-h616-pi-pwm3.dtbo'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|~~| '''~~GND~~40pin - pwm4'''| '''~~25'''~~|~~| '''26'''| '''SPI1_CS1'''| '''PH9'''| '''233~~sun50i-h616-pi-pwm4.dtbo'''

|-

| '''~~266~~40pin - spi1 cs0'''| '''~~PI10'''| '''TWI2~~sun50i-h616-spi1-~~SDA'''| '''27'''~~|~~| '''28'''| '''TWI2~~cs0-~~SCL'''| '''PI9'''| '''265~~spidev.dtbo'''

|-

| '''~~256~~40pin - spi1 cs1'''| '''~~PI0'''| style="text~~sun50i-h616-spi1-cs1-~~align: left;"|| '''29'~~spidev.dtbo''|| '~~''30'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~271~~40pin - spi1 cs0 cs1'''| '''~~PI15'''| style="text~~sun50i-h616-spi1-cs0-cs1-~~align: left;"|| '''31'''~~|~~| '''32'''| '''PWM1'''| '''PI11'''| '''267~~spidev.dtbo'''

|-

| '''~~268~~设置USB0为Host模式'''| '''~~PI12'''| ''~~sun50i-h616-usb0-host.dtbo'~~PWM2~~'''~~| '''33'''~~|~~| '''34'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~258~~关闭绿色的LED灯'''| '''~~PI2'''| style="text~~sun50i-h616-zero2w-~~align: left;"|| '''35'''~~|~~| '''36'''| style="text~~disable-~~align: left;"|| '''PC12'''| '''76~~led.dtbo'''

|-

| '''~~272~~关闭UART0调试串口的方法'''| '''~~PI16~~sun50i-h616-disable-uart0.dtbo'''| }</ol><ol start="5" style="~~text~~list-~~align~~style-type: ~~left~~decimal;"|>| <li>如果需要同时打开多个配置，直接在'''~~37'''~~|~~| '''38~~FDTOVERLAYS'''后面将多个配置的路径加上即可，比如同时打开i2c1和uart5的配置如下所示{| class="wikitable" style="~~text-align~~width: ~~left~~800px;"|~~| '''PI4'''| '''260'''~~

|-

|}

</li>

<li>设置好后需要重启系统才能让配置生效

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

|-

|

[orangepi@orangepi-pc ~]$ '''sudo reboot'''

|}

</li></ol>

~~<ol start~~=~~"2" style~~=~~"list-style-type: decimal;"><li>i2c1对应的设备节点为'''/dev/i2c-1'''，i2c2对应的设备节点为'''/dev/i2c-2'''apollo-p2:/ # '''ls /dev/i2c-*''''''/dev/i2c-1 /dev/i2c-2''' /dev/i2c-5</li><li>首先在桌面中打开wiringOP APP[[File:media/image355.png]]</li><li>然后点击'''I2C_TEST'''按钮打开i2c的测试界面[[File:media/image374.png]]</li><li>wiringOP的i2c测试界面如下图所示</li></ol>~~安装软件的方法 ==

~~[[File:media/image375.png]]~~使用pacman包管理工具可以安装OPi OS中没有的软件，比如安装vim编辑器的命令如下所示，如果想安装其他软件，只需要把vim替换想要安装的软件的包名即可。

~~<ol start~~{| class="6wikitable" style="~~list-style-type~~width: ~~decimal~~800px;">~~<li>然后点击左上角的设备节点选择框选择想要测试的i2c[[File:media/image376.png]]</li>~~|-~~<li>然后在40pin的i2c引脚上接一个i2c设备，这里以ds1307 rtc模块为例~~| ~~~~[~~[File:media/image181.png~~orangepi@orangepi-pc ~]~~]</li><li>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 1'~~$ ''或'~~''i2cdetect~~ sudo pacman -~~y 2'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。apollo-p2:/ # '''i2cdetect -y 1''''''或'''apollo-p2:/ # '''i2cdetect -y 2'''[[File:media/image377.png]]</li><li>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c[[File:media/image378.png]]</li><li>点击~~Syy vim'''~~OPEN'''按钮打开i2c后的显示如下所示[[File:media/image379.png]]</li>~~|}~~<li>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55~~<~~ol style~~span id="~~list-style~~android-~~type: lower~~12-~~alpha;~~tv系统使用说明">~~<li>我们首先设置需要写入的寄存器的地址为0x1c[[File:media/image380.png]]</li><li>然后设置需要写入的值为0x55[[File:media/image381.png]]</li><li>然后点击'''WRITE BYTE'''按钮执行写入的动作[[File:media/image382.png]]</li></ol></li><li>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过[[File:media/image383.png]]</li~~></olspan>

~~=== 40pin的PWM测试 =~~='''Android 12 TV系统使用说明''' =

~~# 由下表可知，可用的pwm为pwm1、pwm2、pwm3和pwm4。~~== 已支持的Android版本 ==

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

|-

| ~~'''GPIO序号'''~~Android版本| ~~'''GPIO'''| '''功能'''| '''引脚'''~~|~~| '''引脚'''| '''功能'''| '''GPIO'''| '''GPIO序号'''~~内核版本

|-

~~| style="text-align: left;"|| style="text-align: left;"|~~| '''~~3.3V~~Android 12 TV版'''| '''1linux5.4'''|}~~| '''2'''| '''5V'''| style~~== Android 12 TV功能适配情况 == {| class="wikitable" style="width:800px;text-align: ~~left~~center;"|-|'''主板功能'''| '''Android12 TV'''

|-

| '''~~264~~HDMI视频'''| '''~~PI8~~OK'''~~| '''TWI1-SDA'''| '''3'''~~|~~| '''4'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~263~~HDMI音频'''| '''~~PI7~~OK'''~~| '''TWI1-SCL'''| '''5'''~~|~~| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~269~~Type-C USB2.0 x 2'''| '''~~PI13'''| '''PWM3'''| '''7'''~~|~~| '''8'''| '''UART0_TX'''| '''PH0'''| '''224~~OK'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''9'''~~|~~| '''10'''| '''UART0_RX'''~~| '''~~PH1~~TF卡启动'''| '''~~225~~OK'''

|-

| '''~~226~~WIFI'''| '''~~PH2~~OK'''| ~~'''UART5_TX'''| '''11'''~~|~~| '''12'''| style="text~~-~~align: left;"|~~| '''~~PI1~~蓝牙'''| '''~~257~~OK'''

|-

| '''~~227~~USB摄像头'''| '''~~PH3~~OK'''~~| '''UART5_RX'''| '''13'''~~|~~| '''14'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~261~~LED灯'''| '''~~PI5'''| '''UART2_TX'''| '''15'''~~|~~| '''16'''| '''PWM4'''| '''PI14'''| '''270~~OK'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''17'''~~|~~| '''18'''| style="text-align: left;"|~~| '''~~PH4~~40pin GPIO'''| '''~~228~~OK'''

|-

| '''~~231~~40pin I2C'''| '''~~PH7~~OK'''~~| '''SPI1_MOSI'''| '''19'''~~|~~| '''20'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~232~~40pin SPI1'''| '''~~PH8'''| '''SPI1_MISO'''| '''21'''~~|~~| '''22'''| '''UART2_RX'''| '''PI6'''| '''262~~OK'''

|-

| '''~~230~~40pin UART'''| '''~~PH6'''| '''SPI1_CLK'''| '''23'''~~|~~| '''24'''| '''SPI1_CS0'''| '''PH5'''| '''229~~OK'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''25'''~~|~~| '''26'''| '''SPI1_CS1'''~~| '''~~PH9~~40pin PWM'''| '''~~233~~OK'''

|-

| '''~~266~~温度传感器'''| '''~~PI10'''| '''TWI2-SDA'''| '''27'''~~|~~| '''28'''| '''TWI2-SCL'''| '''PI9'''| '''265~~OK'''

|-

| '''~~256~~硬件看门狗'''| '''~~PI0~~OK'''~~| style="text-align: left;"|| '''29'''~~|~~| '''30'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"|~~

|-

| '''~~271~~Mali GPU'''| '''~~PI15'''| style="text-align: left;"|| '''31'''~~|~~| '''32'''| '''PWM1'''| '''PI11'''| '''267~~OK'''

|-

| '''~~268~~视频编解码'''| '''~~PI12~~OK'''|} {| class="wikitable" style="width:800px;text-align: center;" |-| '''24pin扩展板功能'''| '''~~PWM2~~Android12 TV'''|-| '''33百兆网口'''|'''OK'''|-| '''34百兆网口灯'''| '''~~GND~~OK'''| ~~style="text~~-~~align: left;"~~| '''USB2.0 HOST x 2'''| '''OK'''|-|'''红外接收'''| '''OK'''| ~~style="text~~-~~align: left;"~~| '''耳机音频播放'''|'''OK'''

|-

| '''~~258~~开关机按键'''| '''~~PI2'''| style="text-align: left;"|| '''35'''~~|~~| '''36'''| style="text-align: left;"|| '''PC12'''| '''76~~OK'''

|-

| '''~~272~~LRADC自定义按键 x 2'''| '''~~PI16'''| style="text-align: left;"|| '''37'''~~|~~| '''38'''| style="text-align: left;"|| '''PI4'''| '''260~~OK，默认设置为音量加减按键'''

|-

~~| style="text-align: left;"|| style="text-align: left;"|~~| '''~~GND'''| '''39'''~~|~~| '''40'''| style="text~~TV-~~align: left;"|| '''PI3~~OUT'''| '''~~259~~OK'''

|}

<~~ol start~~span id="~~2" style="list-style-type: decimal;~~板载led灯显示说明">~~<li>首先点击wiringOP图标打开wiringOP APP~~</pspan>~~[[File:media/image355.png]]</li><li>然后在wiringOP的主界面点击'''PWM_TEST'''按钮进入PWM的测试界面[[File:media/image384.png]]</li><li>PWM测试界面如下所示<div class~~=~~"figure">~~= 板载LED灯显示说明 ==

~~[[File~~{| class="wikitable" style="width:~~media/image385.png]]~~800px;text-align: center;" |-|| '''绿灯'''| '''红灯'''|-| '''u-boot启动阶段'''| '''灭'''| '''亮'''|-| '''内核启动到进入系统'''| '''亮'''| '''亮'''|}

<~~/div></li><li>然后在Channel中设置下想用哪个PWM，默认是PWM1，如果想设置为PWM2，则在Channel中输入2即可，PWM3和PWM4以此类推[[File:media/image386.png]]</li><li>然后可以设置下PWM的周期，默认的配置是'''50000ns'''，转换为PWM频率是'''20KHz'''[[File:media/image387.png]]</li><li>然后点击'''EXPORT'''按钮导出PWM~~<pspan id="android返回上一级界面的方法">~~[[File:media/image388.png]]~~</~~p></li~~span>~~<li>然后拖动下面的进度条，就可以改变PWM的占空比，然后勾选'''Enable'''就可以输出PWM波形了</li></ol>~~== Android返回上一级界面的方法 ==

~~[[File~~我们一般都是使用鼠标和键盘来控制开发板的安卓系统，当进入某些界面，需要返回上一级界面或者桌面时，只能通过'''鼠标右键</~~image389.png]]~~span>'''来返回，键盘是无法返回的。

~~<ol start="9" style="list-style-type: decimal;"><li>然后使用示波器测量开发板40pin中的对应引脚就可以看到下面的波形了</li></ol>~~如果有购买开发板配套的红外遥控（其他遥控不行）和24pin扩展板，将24pin扩展板接入开发板后，还可以通过遥控中的返回键来返回上一级菜单，返回键的位置如下图所示：

[[File:~~media/image390~~zero2w-img308.png]]

== ADB的使用方法 ==

= ~~'''Android 12源码的编译方法'''~~ == 使用网络连接adb调试 ===

~~'''使用网络adb无需USB Typc C接口的数据线来连接电脑和开发板，而是通过网络来通信，所以首先请确保开发板的有线或者无线网络已经连接好了，然后获取开发板的IP地址，后面要用到。'''</~~span~~big>~~== 下载Android 12的源码 ==|}

<li>~~首先从百度或者谷歌网盘下载Android 12源码的分卷压缩包和Orange Pi Zero2w修改的文件的压缩包~~确保Android系统的'''service.adb.tcp.port'''设置为5555端口号~~<ol~~ {| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>百度网盘~~|-| ~~[[File~~apollo-p2:~~media~~/~~image391~~# '''getprop | grep "adb.~~png]]</li><li>谷歌网盘~~tcp"'''[~~[File:media/image392~~service.adb.tcp.~~png~~port]: [5555]~~</li></ol>~~|}

</li>

<li>~~Android 12源码的分卷压缩包下载完后，请先检查下MD5校验和是否正确，如果不正确，请重新下载源码。检查MD5校验和的方法如下所示：test@test:~$~~ 如果'''~~md5sum -c H618-Android12-Src~~service.~~tar~~adb.gztcp.~~md5sum~~port'''没有设置，可以在串口中使用下面的命令设置网络adb的端口号<p/li>~~H618~~{| class="wikitable" style="width:800px;" |-~~Android12~~| apollo-~~Src.tar.gzaa~~p2: / # '''~~OK'''H618-Android12-Src~~setprop service.adb.~~tar~~tcp.~~gzab: '''OK~~port 5555'''~~......</li><li>然后需要将多个压缩文件合并成一个，再解压出安卓源码。命令如下所示：</li></ol>~~

~~test@test~~apollo-p2:~$ / # '''~~cat H618-Android12-Src.tar.gza* > H618-Android12-Src.tar.gz~~stop adbd'''

apollo-p2:/ # '''start adbd'''|}</ol><ol start="3" style="list-style-type: decimal;"><li>在Ubuntu PC上安装adb工具{| class="wikitable" style="width:800px;" |-| test@test:~$ '''~~tar~~ sudo apt-~~xvf H618~~get update'''test@test:~$ '''sudo apt-get install -~~Android12~~y adb'''|}</li><li>然后在Ubuntu PC上连接网络adb{| class="wikitable" style="width:800px;" |-~~Src~~| test@test:~$ '''adb connect 192.168.1.~~tar~~xxx:5555''' '''(需要修改为开发板的IP地址)'''* daemon not running; starting now at tcp:5037* daemon started successfullyconnected to 192.gz168.1.xxx:5555test@test:~$ '''adb devices'''List of devices attached192.168.1.xxx:5555 device|}</li><li>然后在Ubuntu PC上通过adb shell就可以登录android系统</li>{| class="wikitable" style="width:800px;" |-| test@test:~$ '''adb shell'''

~~<ol start="4" style="list~~apollo-~~style-type: decimal;"><li>然后解压Orange Pi Zero2w修改的文件的压缩包test@test~~p2:~~~$ '''tar zxf opizero2w_android12_patches.tar.gz'''test@test:~$ '''ls''''''opizero2w_android12_patches''' opizero2w_android12_patches.tar.gz<~~/~~li>~~#~~<li>然后将Orange Pi Zero2w修改的文件复制到安卓源码中~~|}~~test@test:~$ '''cp -rf opizero2w_android12_patches/* H618-Android12-Src/'''</li>~~</ol>

~~~~== ~~编译Android 12的源码~~ 使用数据线连接adb调试 === '''Android12的编译是在安装有Ubuntu 22.04的x86_64电脑上进行的，其它版本的Ubuntu系统包依赖可能会有一些区别，Ubuntu 22.04 amd64版本的镜像下载地址如下所示：''' ~~[https://repo.huaweicloud.com/ubuntu-releases/22.04/ubuntu-22.04.2-desktop-amd64.iso '''https://repo.huaweicloud.com/ubuntu-releases/22.04/ubuntu-22.04.2-desktop-amd64.iso''']~~ ~~'''编译Android12源码的x86_64电脑硬件配置建议内存为16GB或16GB以上，硬盘空间建议预留200GB或以上，CPU核心数越多越好。'''~~

<li>~~首先安装编译Android12源码需要的软件包~~准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的USB0接口中（USB0的位置请见下面右边图片的说明）。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板。[[File:zero2w-img15.png|400px]] [[File:zero2w-img309.png|400px]]</li><li>在Ubuntu PC上安装adb工具{| class="wikitable" style="width:800px;" |-|

test@test:~$ '''sudo apt-get update'''

test@test:~$ '''sudo apt-get install -y ~~git gnupg flex bison gperf build-essential \~~adb'''|}</li><li>~~'''zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \'''~~查看识别到ADB设备~~''~~{| class="wikitable" style="width:800px;" |-| test@test:~$ '~~lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev ccache \~~''adb devices'''~~'''libgl1-mesa-dev libxml2-utils xsltproc unzip u-boot-tools python-is-python3 \'''<~~List of devices attached4c00146473c28651dd0 device~~'''libssl-dev libncurses5 clang gawk'''~~|}</li><li>~~然后编译'''longan'''文件夹中的代码，里面主要包含u-boot和linux内核~~然后在Ubuntu PC上通过adb shell就可以登录android系统<ol /li>{| class="wikitable" style="~~list-style-type~~width: ~~lower-alpha~~800px;">~~<li>首先运行 '''./build.sh config'''设置编译选项~~|-| ~~~~test@test:~$ '''~~cd H618-Android12-Src/longan~~adb shell'''~~test@test~~apollo-p2:~/~~H618-Android12-Src/longan~~$ ~~'''./build.sh config'''~~|}</pol><pspan id="查看设置hdmi显示分辨率的方法">~~Welcome to mkscript setup progress~~</pspan> == 查看设置HDMI显示分辨率的方法 == <pol style="list-style-type: decimal;">~~All available platform:~~</pli>~~0. android~~首先进入'''Settings'''1[[File:zero2w-img310. ~~linux~~png]]</li><li>~~Choice [android]:~~ 然后选择'''0Device Preferences'''~~All available ic~~[[File:zero2w-img311.png]]<p/li>~~0. h618~~</pli>~~Choice [h618]:~~ 然后选择'''0Display & Sound'''~~All available board~~[[File:zero2w-img312.png]]</li><li>~~0. ft~~然后选择'''Advanced display settings'''1[[File:zero2w-img313. p1png]]</li><li>~~2. p2~~然后选择'''HDMI output mode'''3[[File:zero2w-img314. p7png]]</li><li>~~4. p7l~~然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。5[[File:zero2w-img315. ~~perf1~~png]]</li><~~p>6. perf2</p~~li>~~7. perf3~~开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项8[[File:zero2w-img316. qapng]]<p/li>~~Choice [p2]: '''2'''~~</pol> <pspan id="hdmi转vga显示测试-1">~~All available flash:~~</pspan><=== HDMI转VGA显示测试 === <ol style="list-style-type: decimal;"><li>~~0. default~~首先需要准备下面的配件<ol style="list-style-type: lower-alpha;"><li>~~1. nor~~HDMI转VGA转换器~~Choice~~ [~~default~~[File:zero2w-img146.png]]~~: '''0'''~~</li><li>~~All available kern_ver:~~一根VGA线和一个Mini HDMI公转HDMI母的转接头0[[File:zero2w-img147. ~~linux~~png]] [[File:zero2w-5img148.4png]]</li><li>~~Choice [linux-5.4]: '''0'''All available arch:0. arm1. arm64Choice [arm64]: '''1'''</~~一个支持VGA接口的显示器或者电视</li></ol></li><li>HDMI转VGA显示测试如下所示[[File:zero2w-img317.png]]{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''使用HDMI转VGA显示时，开发板以及开发板的Android系统是不需要做任何设置的，只需要开发板Mini HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</big>|}</li></ol> == WI-FI的连接方法 == <ol style="list-style-type: decimal;"><li>首先选择'''Settings'''[[File:zero2w-img310.png]]</li><li>然后选择'''Network & Internet'''[[File:zero2w-img318.png]]</li><li>然后打开WI-FI[[File:zero2w-img319.png]]</li><li>打开WI-FI后在'''Available networks'''下面就可以看到搜索到的信号[[File:zero2w-img320.png]]</li><li>选择想连接的WI-FI后会弹出下图所示的密码输入界面<div class="figure"> [[File:zero2w-img321.png]] </div></li><li>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了[[File:zero2w-img322.png]]</li><li>WI-FI连接成功后的显示如下图所示[[File:zero2w-img323.png]]</li></ol> == WI-FI hotspot的使用方法 == <ol style="list-style-type: decimal;"><li>首先请确保以太网口已连接网线，并且能正常上网</li><li>然后选择'''Settings'''[[File:zero2w-img310.png]]</li><li>然后选择'''Network & Internet'''[[File:zero2w-img318.png]]</li><li>然后选择'''WIFI hotspot'''[[File:zero2w-img324.png]]</li><li>然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）[[File:zero2w-img325.png]]</li><li>此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password'''下面可以看到[[File:zero2w-img326.png]]</li><li>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot'''能正常使用[[File:zero2w-img327.png]]</li></ol> == 查看以太网口IP地址的方法 == <ol style="list-style-type: decimal;"><li>开发板主板上是没有有线网络接口的，我们可以通过24pin扩展板来扩展百兆以太网[[File:zero2w-img107.png]]</li><li>然后请确保扩展板的网口连接到了路由器或者交换机</li><li>然后打开'''Settings'''[[File:zero2w-img328.png]]</li><li>然后选择'''Network & Internet'''[[File:zero2w-img329.png]]</li><li>然后在下图所示的位置就能看到开发板有线网口的IP地址了[[File:zero2w-img330.png]]</li></ol> == 蓝牙的连接方法 == <ol style="list-style-type: decimal;"><li>首先选择'''Settings'''[[File:zero2w-img310.png]]</li><li>然后选择'''Bluetooth'''[[File:zero2w-img331.png]]</li><li>然后打开'''Bluetooth Enable'''[[File:zero2w-img332.png]]</li><li>然后点击'''Pair new device'''开始扫描周围的蓝牙设备[[File:zero2w-img333.png]]</li><li>搜索到的蓝牙设备会在'''Available devices'''下面显示出来[[File:zero2w-img334.png]]</li><li>然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项[[File:zero2w-img335.png]]</li><li>这里测试的是开发板和'''安卓手机'''蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程[[File:zero2w-img336.png]]</li><li>配对完成后，再打开'''Paired devices'''下面就可以看到已配对的蓝牙设备[[File:zero2w-img337.png]]</li><li>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了[[File:zero2w-img338.png]]</li><li>开发板Android系统蓝牙接收到的图片可以打开'''Received files'''中查看[[File:zero2w-img339.png]]</li></ol> == USB0设置为HOST模式的方法 == 如下图所示，开发板的主板上有两个Type-C类型的接口：USB0和USB1，这两个接口都可以用来给开发板供电，也都可以用来当做USB2.0 HOST接口。USB0和USB1的区别是：USB0除了可以设置为HOST模式外，还可以设置为Device模式，而USB1只有HOST模式。 [[File:zero2w-img163.png]] Orange Pi发布的Android12 TV系统USB0默认设置为Device模式，所以在不需要使用USB0 Device模式时（ADB功能需要确保USB0为Device模式），建议使用USB0来供电，这样USB1就可以直接用来接USB设备。如果想使用USB0来接USB设备，需要把USB0设置为HOST模式，方法如下所示： <ol style="list-style-type: lower-alpha;"><li>运行下面的命令可以将USB0设置为HOST模式：{| class="wikitable" style="width:800px;" |-| apollo-p2:/ # '''cat /sys/devices/platform/soc@3000000/soc@3000000\:usbc0@0/usb_host'''host_chose finished!apollo-p2:/ #|}</li><li>运行下面的命令可以切回Device模式{| class="wikitable" style="width:800px;" |-| apollo-p2:/ # '''cat /sys/devices/platform/soc@3000000/soc@3000000\:usbc0@0/usb_device'''device_chose finished!apollo-p2:/ #|}</li><li>查看USB0当前模式的命令为{| class="wikitable" style="width:800px;" |-| apollo-p2:/ # '''cat /sys/devices/platform/soc@3000000/soc@3000000\:usbc0@0/otg_role'''usb_host|}</li></ol> == USB摄像头使用方法 == <ol style="list-style-type: decimal;"><li>首先在开发板的USB接口中插入USB（UVC协议）摄像头</li><li>USB摄像头如果识别正常，在/dev下会生成相应的video设备节点{| class="wikitable" style="width:800px;" |-| console:/ # '''ls /dev/video0'''/dev/video0|}</li><li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[Orange Pi Zero 2W#ADB的使用方法|'''ADB的使用方法''']]一小节的说明</li><li>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP[[File:zero2w-img340.png]][[File:zero2w-img341.png]]</li><li>然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装{| class="wikitable" style="width:800px;" |-| test@test:~$ '''adb install usbcamera.apk'''|}</li><li>安装完后在Android的桌面可以看到USB摄像头的启动图标[[File:zero2w-img342.png]]</li><li>然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了</li></ol> == Android系统ROOT说明 == {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''Orange Pi发布的Android系统已经ROOT，可以使用下面的方法来测试。'''</big>|} <ol style="list-style-type: decimal;"><li>在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''[[File:zero2w-img340.png]][[File:zero2w-img343.png]]</li><li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[Orange Pi Zero 2W#ADB的使用方法|'''ADB的使用方法''']]一小节的说明</li><li>然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装{| class="wikitable" style="width:800px;" |-| test@test:~$ '''adb install rootcheck.apk'''|}</li><li>安装完后在Android的桌面可以看到ROOT测试工具的启动图标[[File:zero2w-img344.png]]</li><li>第一次打开'''ROOT测试工具'''后的显示界面如下图所示[[File:zero2w-img345.png]]</li><li>然后就可以点击'''CHECK NOW'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限[[File:zero2w-img346.png]]</li></ol> == 使用MiracastReceiver将手机屏幕投屏到开发板的方法 == <ol style="list-style-type: decimal;"><li>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[Orange Pi Zero 2W#WI-FI的连接方法|'''WI-FI的连接方法''']]一小节的说明</li><li>然后打开开发板安卓系统中的'''MiracastReceiver'''应用[[File:zero2w-img347.png]]</li><li>'''MiracastReceiver'''打开后的界面如下所示<div class="figure"> [[File:zero2w-img348.png]] </div></li><li>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能[[File:zero2w-img349.png]]</li><li>等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可[[File:zero2w-img350.png]]</li><li>然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可[[File:zero2w-img351.png]]</li><li>然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了[[File:zero2w-img352.png]]</li></ol> == 通过按键或红外遥控开关机的方法 == 我们可以通过开关机按键或者红外遥控来关闭或开启开发板的安卓系统。但是需要注意的是，开发板主板上是没有开关机按键和红外接收器的，需要通过24pin扩展板来扩展。 [[File:zero2w-img107.png]] 24pin扩展板上的开关机按键所在位置如下图所示： [[File:zero2w-img274.png]] 红外遥控电源按键所在位置如下所示： [[File:zero2w-img353.png]] 关机时，我们需要长按开关机按键或者红外遥控上的电源按键，然后安卓系统会弹出下图所示的确认对话框，然后选择'''OK'''就会关闭安卓系统了。 [[File:zero2w-img354.png]] 关机后，再次长按开关机按键或者红外遥控上的电源按键就会开机了。 == 40pin 接口 GPIO、UART、SPI 测试 == {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''注意：40pin接口上的排针默认是不焊接的，需要自己焊接上去才能使用。'''</big>|} === 40pin的GPIO口测试方法 === <ol style="list-style-type: decimal;"><li>首先在桌面中打开wiringOP APP[[File:zero2w-img355.png]]</li><li>然后点击'''GPIO_TEST'''按钮打开GPIO测试界面[[File:zero2w-img356.png]]</li><li>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮和40pin引脚是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平会设置为低电平；当点击'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息；当点击'''BLINK ALL GPIO'''按钮时，会让所有的GPIO口循环输出高低电平，使用这个功能可以用来测试40pin中所有的GPIO口。[[File:zero2w-img357.png]]</li><li>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：<div class="figure"> [[File:zero2w-img358.png]] </div></li><li>开发板40pin中总共有28个GPIO口可以使用，下面以12号引脚——对应GPIO为PI01——对应wPi序号为6——为例演示如何设置GPIO口的高低电平。首先点击12号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，12号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功。[[File:zero2w-img359.png]]</li><li>然后点击'''GPIO READALL'''按钮，可以看到当前的12号引脚模式为'''OUT'''，引脚电平为高电平[[File:zero2w-img360.png]]</li><li>再次点击下图的'''CheckBox'''按钮取消勾选状态，12号引脚就会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功[[File:zero2w-img361.png]]</li><li>然后点击'''GPIO READALL'''按钮，可以看到当前的12号引脚模式为OUT，引脚电平为低电平[[File:zero2w-img362.png]]</li></ol> === 40pin的UART测试方法 === # 由下表可知，Android12 TV系统默认可用的uart有uart2和uart5。请注意uart0默认设置为调试串口，请不要把uart0当成普通串口使用。 <div style="display: flex;">::{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''GPIO序号'''| '''GPIO'''| '''功能'''| '''引脚'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''1'''|-| '''264'''| '''PI8'''| '''TWI1-SDA'''| '''3'''|-| '''263'''| '''PI7'''| '''TWI1-SCL'''| '''5'''|-| '''269'''| '''PI13'''| '''PWM3'''| '''7'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''9'''|-| '''226'''| '''PH2'''| '''UART5_TX'''| '''11'''|-| '''227'''| '''PH3'''| '''UART5_RX'''| '''13'''|-| '''261'''| '''PI5'''| '''UART2_TX'''| '''15'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''17'''|-| '''231'''| '''PH7'''| '''SPI1_MOSI'''| '''19'''|-| '''232'''| '''PH8'''| '''SPI1_MISO'''| '''21'''|-| '''230'''| '''PH6'''| '''SPI1_CLK'''| '''23'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''25'''|-| '''266'''| '''PI10'''| '''TWI2-SDA'''| '''27'''|-| '''256'''| '''PI0'''| style="text-align: left;"|| '''29'''|-| '''271'''| '''PI15'''| style="text-align: left;"|| '''31'''|-| '''268'''| '''PI12'''| '''PWM2'''| '''33'''|-| '''258'''| '''PI2'''| style="text-align: left;"|| '''35'''|-| '''272'''| '''PI16'''| style="text-align: left;"|| '''37'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''39'''|}{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''引脚'''| '''功能'''| '''GPIO'''| '''GPIO序号'''|-| '''2'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''4'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''8'''| '''UART0_TX'''| '''PH0'''| '''224'''|-| '''10'''| '''UART0_RX'''| '''PH1'''| '''225'''|-| '''12'''| style="text-align: left;"|| '''PI1'''| '''257'''|-| '''14'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''16'''| '''PWM4'''| '''PI14'''| '''270'''|-| '''18'''| style="text-align: left;"|| '''PH4'''| '''228'''|-| '''20'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''22'''| '''UART2_RX'''| '''PI6'''| '''262'''|-| '''24'''| '''SPI1_CS0'''| '''PH5'''| '''229'''|-| '''26'''| '''SPI1_CS1'''| '''PH9'''| '''233'''|-| '''28'''| '''TWI2-SCL'''| '''PI9'''| '''265'''|-| '''30'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''32'''| '''PWM1'''| '''PI11'''| '''267'''|-| '''34'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''36'''| style="text-align: left;"|| '''PC12'''| '''76'''|-| '''38'''| style="text-align: left;"|| '''PI4'''| '''260'''|-| '''40'''| style="text-align: left;"|| '''PI3'''| '''259'''|}</div><ol start="2" style="list-style-type: decimal;"><li>uart2对应的设备节点为'''/dev/ttyAS2'''，uart5对应的设备节点为'''/dev/ttyAS5'''{| class="wikitable" style="width:800px;" |-| apollo-p2:/ # ls /dev/ttyAS*/dev/ttyAS0      /dev/ttyAS1      '''/dev/ttyAS2      /dev/ttyAS5'''|}</li><li>首先在桌面中打开wiringOP APP[[File:zero2w-img355.png]]</li><li>然后点击'''UART_TEST'''按钮打开UART测试界面[[File:zero2w-img363.png]]</li><li>wiringOP的串口测试界面如下图所示</li> [[File:zero2w-img364.png]]</ol><ol start="6" style="list-style-type: decimal;"><li>然后在选择框中选择'''/dev/ttyAS2'''或者'''/dev/ttyAS5'''节点[[File:zero2w-img365.png]]</li><li>再在编辑框中输入想要设置的波特率，然后点击'''OPEN'''按钮打开uart节点，打开成功后，'''OPEN'''按钮变为不可选中状态，'''CLOSE'''按钮和'''SEND'''按钮变为可选中状态</li> [[File:zero2w-img366.png]]</ol><ol start="8" style="list-style-type: decimal;"><li>然后使用杜邦线短接uart的rx和tx引脚</li><li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li> [[File:zero2w-img367.png]]</ol><ol start="10" style="list-style-type: decimal;"><li>如果一切正常，接收框内会显示已接收到的字符串</li> [[File:zero2w-img368.png]]</ol> === 40pin的SPI测试方法 === # 由下表可知，40pin接口可用的spi为spi1，有两个片选引脚cs0和cs1 <div style="display: flex;">::{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''GPIO序号'''| '''GPIO'''| '''功能'''| '''引脚'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''1'''|-| '''264'''| '''PI8'''| '''TWI1-SDA'''| '''3'''|-| '''263'''| '''PI7'''| '''TWI1-SCL'''| '''5'''|-| '''269'''| '''PI13'''| '''PWM3'''| '''7'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''9'''|-| '''226'''| '''PH2'''| '''UART5_TX'''| '''11'''|-| '''227'''| '''PH3'''| '''UART5_RX'''| '''13'''|-| '''261'''| '''PI5'''| '''UART2_TX'''| '''15'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''17'''|-| '''231'''| '''PH7'''| '''SPI1_MOSI'''| '''19'''|-| '''232'''| '''PH8'''| '''SPI1_MISO'''| '''21'''|-| '''230'''| '''PH6'''| '''SPI1_CLK'''| '''23'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''25'''|-| '''266'''| '''PI10'''| '''TWI2-SDA'''| '''27'''|-| '''256'''| '''PI0'''| style="text-align: left;"|| '''29'''|-| '''271'''| '''PI15'''| style="text-align: left;"|| '''31'''|-| '''268'''| '''PI12'''| '''PWM2'''| '''33'''|-| '''258'''| '''PI2'''| style="text-align: left;"|| '''35'''|}{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''引脚'''| '''功能'''| '''GPIO'''| '''GPIO序号'''|-| '''2'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''4'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''8'''| '''UART0_TX'''| '''PH0'''| '''224'''|-| '''10'''| '''UART0_RX'''| '''PH1'''| '''225'''|-| '''12'''| style="text-align: left;"|| '''PI1'''| '''257'''|-| '''14'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''16'''| '''PWM4'''| '''PI14'''| '''270'''|-| '''18'''| style="text-align: left;"|| '''PH4'''| '''228'''|-| '''20'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''22'''| '''UART2_RX'''| '''PI6'''| '''262'''|-| '''24'''| '''SPI1_CS0'''| '''PH5'''| '''229'''|-| '''26'''| '''SPI1_CS1'''| '''PH9'''| '''233'''|-| '''28'''| '''TWI2-SCL'''| '''PI9'''| '''265'''|-| '''30'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''32'''| '''PWM1'''| '''PI11'''| '''267'''|-| '''34'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''36'''| style="text-align: left;"|| '''PC12'''| '''76'''|}</div><ol start="2" style="list-style-type: decimal;"><li>SPI1 CS0对应的设备节点为'''/dev/spidev1.0'''，SPI1 CS1对应的设备节点为'''/dev/spidev1.1'''</li>{| class="wikitable" style="width:800px;" |-| apollo-p2:/ # '''ls /dev/spidev1.*''' '''/dev/spidev1.0 /dev/spidev1.1'''|}</ol><ol start="3" style="list-style-type: decimal;"><li>这里演示下通过'''w25qxx'''模块来测试SPI1接口，首先在SPI1接口接入w25qxx模块</li>{| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''如果没有w25qxx模块也没关系，因为开发板上有一个SPIFlash接在了SPI0上，在安卓中SPI0的配置默认也打开了，所以我们也可以直接使用板载的SPIFlash测试。'''</big>|}</ol><ol start="4" style="list-style-type: decimal;"><li>然后在桌面中打开wiringOP APP[[File:zero2w-img355.png]]</li><li>然后点击'''SPI_TEST'''按钮打开SPI的测试界面[[File:zero2w-img369.png]]</li><li>然后在左上角选择spi的设备节点，如果直接测试板载的SPIFlash，那么保持默认的'''/dev/spidev0.0'''即可，如果在40pin的spi1 cs0上接了'''w25qxx'''模块，那么就请选择'''/dev/spidev1.0'''，如果在40pin的spi1 cs1上接了'''w25qxx'''模块，那么就请选择'''/dev/spidev1.1'''[[File:zero2w-img370.png]]</li><li>然后点击'''OPEN'''按钮初始化SPI</li> [[File:zero2w-img371.png]]</ol><ol start="8" style="list-style-type: decimal;"><li>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮[[File:zero2w-img372.png]]</li><li>最后APP会显示读取到的板载SPI Flash的ID信息</li> [[File:zero2w-img373.png]]</ol><ol start="10" style="list-style-type: decimal;"><li>如果是读取接在40pin SPI1上的w25qxx模块，和板载SPI Flash的ID信息也是类似的</li></ol> === 40pin的I2C测试方法 === # 由下表可知，Android12 TV系统默认打开了i2c1和i2c2 <div style="display: flex;">::{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''GPIO序号'''| '''GPIO'''| '''功能'''| '''引脚'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''1'''|-| '''264'''| '''PI8'''| '''TWI1-SDA'''| '''3'''|-| '''263'''| '''PI7'''| '''TWI1-SCL'''| '''5'''|-| '''269'''| '''PI13'''| '''PWM3'''| '''7'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''9'''|-| '''226'''| '''PH2'''| '''UART5_TX'''| '''11'''|-| '''227'''| '''PH3'''| '''UART5_RX'''| '''13'''|-| '''261'''| '''PI5'''| '''UART2_TX'''| '''15'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''17'''|-| '''231'''| '''PH7'''| '''SPI1_MOSI'''| '''19'''|-| '''232'''| '''PH8'''| '''SPI1_MISO'''| '''21'''|-| '''230'''| '''PH6'''| '''SPI1_CLK'''| '''23'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''25'''|-| '''266'''| '''PI10'''| '''TWI2-SDA'''| '''27'''|-| '''256'''| '''PI0'''| style="text-align: left;"|| '''29'''|-| '''271'''| '''PI15'''| style="text-align: left;"|| '''31'''|-| '''268'''| '''PI12'''| '''PWM2'''| '''33'''|-| '''258'''| '''PI2'''| style="text-align: left;"|| '''35'''|-| '''272'''| '''PI16'''| style="text-align: left;"|| '''37'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''39'''|}{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''引脚'''| '''功能'''| '''GPIO'''| '''GPIO序号'''|-| '''2'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''4'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''8'''| '''UART0_TX'''| '''PH0'''| '''224'''|-| '''10'''| '''UART0_RX'''| '''PH1'''| '''225'''|-| '''12'''| style="text-align: left;"|| '''PI1'''| '''257'''|-| '''14'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''16'''| '''PWM4'''| '''PI14'''| '''270'''|-| '''18'''| style="text-align: left;"|| '''PH4'''| '''228'''|-| '''20'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''22'''| '''UART2_RX'''| '''PI6'''| '''262'''|-| '''24'''| '''SPI1_CS0'''| '''PH5'''| '''229'''|-| '''26'''| '''SPI1_CS1'''| '''PH9'''| '''233'''|-| '''28'''| '''TWI2-SCL'''| '''PI9'''| '''265'''|-| '''30'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''32'''| '''PWM1'''| '''PI11'''| '''267'''|-| '''34'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''36'''| style="text-align: left;"|| '''PC12'''| '''76'''|-| '''38'''| style="text-align: left;"|| '''PI4'''| '''260'''|-| '''40'''| style="text-align: left;"|| '''PI3'''| '''259'''|}</div><ol start="2" style="list-style-type: decimal;"><li>i2c1对应的设备节点为'''/dev/i2c-1'''，i2c2对应的设备节点为'''/dev/i2c-2'''{| class="wikitable" style="width:800px;" |-| apollo-p2:/ # '''ls /dev/i2c-*''''''/dev/i2c-1 /dev/i2c-2''' /dev/i2c-5|}</li><li>首先在桌面中打开wiringOP APP[[File:zero2w-img355.png]]</li><li>然后点击'''I2C_TEST'''按钮打开i2c的测试界面[[File:zero2w-img374.png]]</li><li>wiringOP的i2c测试界面如下图所示</li> [[File:zero2w-img375.png]]</ol><ol start="6" style="list-style-type: decimal;"><li>然后点击左上角的设备节点选择框选择想要测试的i2c[[File:zero2w-img376.png]]</li><li>然后在40pin的i2c引脚上接一个i2c设备，这里以ds1307 rtc模块为例[[File:zero2w-img181.png]]</li><li>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 1'''或'''i2cdetect -y 2'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。{| class="wikitable" style="width:800px;" |-| apollo-p2:/ # '''i2cdetect -y 1''''''或'''apollo-p2:/ # '''i2cdetect -y 2'''|}[[File:zero2w-img377.png]]</li><li>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c[[File:zero2w-img378.png]]</li><li>点击'''OPEN'''按钮打开i2c后的显示如下所示[[File:zero2w-img379.png]]</li><li>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55<ol style="list-style-type: lower-alpha;"><li>我们首先设置需要写入的寄存器的地址为0x1c[[File:zero2w-img380.png]]</li><li>然后设置需要写入的值为0x55[[File:zero2w-img381.png]]</li><li>然后点击'''WRITE BYTE'''按钮执行写入的动作[[File:zero2w-img382.png]]</li></ol></li><li>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过[[File:zero2w-img383.png]]</li></ol> === 40pin的PWM测试 === # 由下表可知，可用的pwm为pwm1、pwm2、pwm3和pwm4。 <div style="display: flex;">::{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''GPIO序号'''| '''GPIO'''| '''功能'''| '''引脚'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''1'''|-| '''264'''| '''PI8'''| '''TWI1-SDA'''| '''3'''|-| '''263'''| '''PI7'''| '''TWI1-SCL'''| '''5'''|-| '''269'''| '''PI13'''| '''PWM3'''| '''7'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''9'''|-| '''226'''| '''PH2'''| '''UART5_TX'''| '''11'''|-| '''227'''| '''PH3'''| '''UART5_RX'''| '''13'''|-| '''261'''| '''PI5'''| '''UART2_TX'''| '''15'''|-| style="text-align: left;"|| style="text-align: left;"|| '''3.3V'''| '''17'''|-| '''231'''| '''PH7'''| '''SPI1_MOSI'''| '''19'''|-| '''232'''| '''PH8'''| '''SPI1_MISO'''| '''21'''|-| '''230'''| '''PH6'''| '''SPI1_CLK'''| '''23'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''25'''|-| '''266'''| '''PI10'''| '''TWI2-SDA'''| '''27'''|-| '''256'''| '''PI0'''| style="text-align: left;"|| '''29'''|-| '''271'''| '''PI15'''| style="text-align: left;"|| '''31'''|-| '''268'''| '''PI12'''| '''PWM2'''| '''33'''|-| '''258'''| '''PI2'''| style="text-align: left;"|| '''35'''|-| '''272'''| '''PI16'''| style="text-align: left;"|| '''37'''|-| style="text-align: left;"|| style="text-align: left;"|| '''GND'''| '''39'''|}{| class="wikitable" style="width:390px;margin-right: 20px;text-align: center;"|-| '''引脚'''| '''功能'''| '''GPIO'''| '''GPIO序号'''|-| '''2'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''4'''| '''5V'''| style="text-align: left;"|| style="text-align: left;"||-| '''6'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''8'''| '''UART0_TX'''| '''PH0'''| '''224'''|-| '''10'''| '''UART0_RX'''| '''PH1'''| '''225'''|-| '''12'''| style="text-align: left;"|| '''PI1'''| '''257'''|-| '''14'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''16'''| '''PWM4'''| '''PI14'''| '''270'''|-| '''18'''| style="text-align: left;"|| '''PH4'''| '''228'''|-| '''20'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''22'''| '''UART2_RX'''| '''PI6'''| '''262'''|-| '''24'''| '''SPI1_CS0'''| '''PH5'''| '''229'''|-| '''26'''| '''SPI1_CS1'''| '''PH9'''| '''233'''|-| '''28'''| '''TWI2-SCL'''| '''PI9'''| '''265'''|-| '''30'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''32'''| '''PWM1'''| '''PI11'''| '''267'''|-| '''34'''| '''GND'''| style="text-align: left;"|| style="text-align: left;"||-| '''36'''| style="text-align: left;"|| '''PC12'''| '''76'''|-| '''38'''| style="text-align: left;"|| '''PI4'''| '''260'''|-| '''40'''| style="text-align: left;"|| '''PI3'''| '''259'''|}</div><ol start="2" style="list-style-type: decimal;"><li>首先点击wiringOP图标打开wiringOP APP[[File:zero2w-img355.png]]</li><li>然后在wiringOP的主界面点击'''PWM_TEST'''按钮进入PWM的测试界面[[File:zero2w-img384.png]]</li><li>PWM测试界面如下所示<div class="figure"> [[File:zero2w-img385.png]] </div></li><li>然后在Channel中设置下想用哪个PWM，默认是PWM1，如果想设置为PWM2，则在Channel中输入2即可，PWM3和PWM4以此类推[[File:zero2w-img386.png]]</li><li>然后可以设置下PWM的周期，默认的配置是'''50000ns'''，转换为PWM频率是'''20KHz'''[[File:zero2w-img387.png]]</li><li>然后点击'''EXPORT'''按钮导出PWM[[File:zero2w-img388.png]]</li><li>然后拖动下面的进度条，就可以改变PWM的占空比，然后勾选'''Enable'''就可以输出PWM波形了</li> [[File:zero2w-img389.png]]</ol><ol start="9" style="list-style-type: decimal;"><li>然后使用示波器测量开发板40pin中的对应引脚就可以看到下面的波形了</li> [[File:zero2w-img390.png]]</ol> = '''Android 12源码的编译方法''' = == 下载Android 12的源码 == <ol style="list-style-type: decimal;"><li>首先从百度或者谷歌网盘下载Android 12源码的分卷压缩包和Orange Pi Zero2w修改的文件的压缩包<ol style="list-style-type: lower-alpha;"><li>百度网盘[[File:zero2w-img391.png]]</li><li>谷歌网盘[[File:zero2w-img392.png]]</li></ol></li><li>Android 12源码的分卷压缩包下载完后，请先检查下MD5校验和是否正确，如果不正确，请重新下载源码。检查MD5校验和的方法如下所示：{| class="wikitable" style="width:800px;" |-| test@test:~$ '''md5sum -c H618-Android12-Src.tar.gz.md5sum'''H618-Android12-Src.tar.gzaa: '''OK'''H618-Android12-Src.tar.gzab: '''OK'''......|}</li><li>然后需要将多个压缩文件合并成一个，再解压出安卓源码。命令如下所示：</li>{| class="wikitable" style="width:800px;" |-| test@test:~$ '''cat H618-Android12-Src.tar.gza* > H618-Android12-Src.tar.gz''' test@test:~$ '''tar -xvf H618-Android12-Src.tar.gz'''|}</ol><ol start="4" style="list-style-type: decimal;"><li>然后解压Orange Pi Zero2w修改的文件的压缩包{| class="wikitable" style="width:800px;" |-| test@test:~$ '''tar zxf opizero2w_android12_patches.tar.gz'''test@test:~$ '''ls''''''opizero2w_android12_patches''' opizero2w_android12_patches.tar.gz|}</li><li>然后将Orange Pi Zero2w修改的文件复制到安卓源码中{| class="wikitable" style="width:800px;" |-| test@test:~$ '''cp -rf opizero2w_android12_patches/* H618-Android12-Src/'''|}</li></ol> == 编译Android 12的源码 == {| class="wikitable" style="background-color:#ffffdc;width:800px;" |-| <big>'''Android12的编译是在安装有Ubuntu 22.04的x86_64电脑上进行的，其它版本的Ubuntu系统包依赖可能会有一些区别，Ubuntu 22.04 amd64版本的镜像下载地址如下所示：''' [https://repo.huaweicloud.com/ubuntu-releases/22.04/ubuntu-22.04.2-desktop-amd64.iso '''https://repo.huaweicloud.com/ubuntu-releases/22.04/ubuntu-22.04.2-desktop-amd64.iso'''] '''编译Android12源码的x86_64电脑硬件配置建议内存为16GB或16GB以上，硬盘空间建议预留200GB或以上，CPU核心数越多越好。'''</big>|} <ol style="list-style-type: decimal;"><li>首先安装编译Android12源码需要的软件包{| class="wikitable" style="width:800px;" |-| test@test:~$ '''sudo apt-get update'''test@test:~$ '''sudo apt-get install -y git gnupg flex bison gperf build-essential \''''''zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \''''''lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev ccache \''''''libgl1-mesa-dev libxml2-utils xsltproc unzip u-boot-tools python-is-python3 \''''''libssl-dev libncurses5 clang gawk'''|}</li><li>然后编译'''longan'''文件夹中的代码，里面主要包含u-boot和linux内核<ol style="list-style-type: lower-alpha;"><li>首先运行 '''./build.sh config'''设置编译选项{| class="wikitable" style="width:800px;" |-| test@test:~$ '''cd H618-Android12-Src/longan'''test@test:~/H618-Android12-Src/longan$ '''./build.sh config''' Welcome to mkscript setup progressAll available platform::0. android:1. linuxChoice [android]: '''0'''All available ic::0. h618Choice [h618]: '''0'''All available board::0. ft:1. p1:2. p2:3. p7:4. p7l:5. perf1:6. perf2:7. perf3:8. qaChoice [p2]: '''2'''All available flash::0. default:1. norChoice [default]: '''0'''All available kern_ver::0. linux-5.4Choice [linux-5.4]: '''0'''All available arch::0. arm:1. arm64Choice [arm64]: '''1''''''......'''*** Default configuration is based on 'sun50iw9p1smp_h618_android_defconfig'## configuration written to .config#make[1]: Leaving directory '/home/test/H618-Android12-Src/longan/out/kernel/build'make: Leaving directory '/home/test/H618-Android12-Src/longan/kernel/linux-5.4'INFO: clean buildserverINFO: prepare_buildserver|}</li><li>然后运行'''./build.sh'''脚本就可以开始编译了{| class="wikitable" style="width:800px;" |-| test@test:~/H618-Android12-Src/longan$ '''./build.sh'''|}</li>

<li>编译完成后会看到下面的输出

{| class="wikitable" style="width:800px;" |-| sun50iw9p1 compile Kernel successfulINFO: Prepare toolchain ...'''......'''INFO: build kernel OK.INFO: build rootfs ...INFO: skip make rootfs for androidINFO: ----------------------------------------INFO: build lichee OK.INFO: ----------------------------------------|}</li></ol></li><li>然后使用下面的命令编译安卓源码并生成最终的安卓镜像{| class="wikitable" style="width:800px;" |-| test@test:~$ '''cd H618-Android12-Src'''test@test:~/H618-Android12-Src$ '''source build/envsetup.sh'''test@test:~/H618-Android12-Src$ '''lunch apollo_p2-userdebug'''test@test:~/H618-Android12-Src$ '''make -j8'''test@test:~/H618-Android12-Src$ '''pack'''|}</li><li>编译生成的安卓镜像存放路径为：{| class="wikitable" style="width:800px;" |-| '''longan/out/h618_android12_p2_uart0.img'''|}</li></ol> = '''附录''' = == 用户手册更新历史 == {| class="wikitable" style="width:800px;text-align: center;" |-| '''版本'''| '''日期'''| '''更新说明'''|-| v1.0| 2023-09-14| 初始版本|} == 镜像更新历史 == {| class="wikitable" style="width:800px;" |-| style="text-align: center;"| '''日期''' | style="text-align: center;"| '''更新说明'''|-| style="text-align: center;"| 2023-09-14| orangepizero2w_1.0.0_debian_bullseye_server_linux5.4.125.7z orangepizero2w_1.0.0_ubuntu_focal_server_linux5.4.125.7z orangepizero2w_1.0.0_ubuntu_focal_desktop_xfce_linux5.4.125.7z orangepizero2w_1.0.0_debian_bullseye_desktop_xfce_linux5.4.125.7z orangepizero2w_1.0.0_ubuntu_jammy_server_linux6.1.31.7z orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.7z orangepizero2w_1.0.0_debian_bullseye_server_linux6.1.31.7z orangepizero2w_1.0.0_ubuntu_jammy_desktop_xfce_linux6.1.31.7z orangepizero2w_1.0.0_debian_bookworm_desktop_xfce_linux6.1.31.7z orangepizero2w_1.0.0_debian_bullseye_desktop_xfce_linux6.1.31.7z OrangePi_Zero2w_Android12_v1.0.tar.gz Opios-arch-aarch64-xfce-opizero2w-23.09-linux6.1.31.img.xz

~~= '''附录''' =~~

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

~~{| class="wikitable"~~

|-

~~| '''版本'''~~

~~| '''日期'''~~

~~| '''更新说明'''~~

|-

~~| v1.0~~

~~| 2023-09-14~~

~~| 初始版本~~

|}

~~== 镜像更新历史 ==~~

~~{| class="wikitable"~~

|-

~~| '''日期'''~~

~~| '''更新说明'''~~

|-

~~| 2023-09-14~~

|

~~orangepizero2w_1.0.0_debian_bullseye_server_linux5.4.125.7z~~

~~orangepizero2w_1.0.0_ubuntu_focal_server_linux5.4.125.7z~~

~~orangepizero2w_1.0.0_ubuntu_focal_desktop_xfce_linux5.4.125.7z~~

~~orangepizero2w_1.0.0_debian_bullseye_desktop_xfce_linux5.4.125.7z~~

~~orangepizero2w_1.0.0_ubuntu_jammy_server_linux6.1.31.7z~~

~~orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.7z~~

~~orangepizero2w_1.0.0_debian_bullseye_server_linux6.1.31.7z~~

~~orangepizero2w_1.0.0_ubuntu_jammy_desktop_xfce_linux6.1.31.7z~~

~~orangepizero2w_1.0.0_debian_bookworm_desktop_xfce_linux6.1.31.7z~~

~~orangepizero2w_1.0.0_debian_bullseye_desktop_xfce_linux6.1.31.7z~~

~~OrangePi_Zero2w_Android12_v1.0.tar.gz~~

~~Opios-arch-aarch64-xfce-opizero2w-23.09-linux6.1.31.img.xz~~

* 初始版本

|}

Admin

行政员、管理员

8,460

个编辑

更改

Orange Pi Zero 2W

导航菜单

个人工具

名字空间

变种

视图

更多

搜索

导航

产品

常见问题

镜像资源

支持

工具