更改

Orange Pi Zero 2W

删除5,789字节, 2023年9月20日 (三) 11:21

无编辑摘要

| 重量

| 12.5g

|-

~~| [[File:media/image1.%20png]]{width=“0.255 55555555555554in” h eight=“0.27638888 88888889in”}range Pi™ 是深圳市迅龙软件有限公司的注册商标~~

|

|}

[[File:media/image3.png~~|576x152px|_MG_2033~~]]

</div>

[[File:media/image4.png~~|576x159px|_MG_2035~~]]

</div>

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

[[File:media/image5.png~~|576x622px~~]]

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

[[File:media/image6.png~~|562x723px~~]]

[[File:media/image7.png~~|575x305px~~]]

'''四个定位孔的直径都是3.0mm。'''

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

[[File:media/image8.png~~|124x96px~~]]

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

[[File:media/image9.png~~|103x85px~~]][[File:media/image10.png~~|112x85px~~]][[File:media/image11.png~~|114x85px~~]][[File:media/image12.png~~|86x109px~~]]

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

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

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

[[File:media/image13.png~~|139x96px~~]]</li>

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

[[File:media/image14.jpeg~~|136x133px|IMG_256~~]]

</div>

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

[[File:media/image15.jpeg~~|172x172px|IMG_4194(20201104-125502)~~]] [[File:media/image16.jpeg~~|173x173px|IMG_6179(20220116-151727)~~]]

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

[[File:media/image17.png~~|242x121px~~]]</li>

<li>24pin扩展板

[[File:media/image18.png~~|211x110px~~]]</li>

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

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

[[File:media/image19.png~~|193x181px~~]]

'''注意，空调的遥控或者电视机的遥控是无法控制Orange Pi开发板的，默认只有Orange Pi提供的遥控才可以。'''</li>

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

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

[[File:media/image20.png~~|200x177px~~]]</li>

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

[[File:media/image21.png~~|162x133px~~]] [[File:media/image22.png~~|287x143px~~]]</li>

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

[[File:media/image23.png~~|263x142px~~]]

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

'''40pin接口上的排针默认是不焊接的，需要自己焊接上去才能使用。'''</li>

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

[[File:media/image24.png~~|193x127px~~]]</li>

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

[[File:media/image25.png~~|138x113px~~]] [[File:media/image26.png~~|305x110px~~]]

'''注意，开发板使用的TTL电平是3.3v的，除了上图所示的USB转TTL模块外，其他类似的3.3v的USB转TTL模块一般也都是可以的。'''</li>

<li>安装有Ubuntu和Windows操作系统的X64电脑</li></ol>

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

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

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

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

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

[[File:media/image29.png~~|335x211px~~]]</li></ol>

'''打开balenaEtcher时如果提示下面的错误：'''

[[File:media/image30.png~~|206x162px~~]]

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

[[File:media/image31.png~~|114x37px~~]]

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

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

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

</li>

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

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

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

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

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

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

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

</div></li>

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

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

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

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

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

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

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

</li>

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

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

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

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

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

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

test@test:~$ '''7z x orangepizero2w_1.0.0_ubuntu_focal_desktop_linux6.1.31.7z'''

orangepizero2w_1.0.0_ubuntu_focal_desktop_linux6.1.31.img: '''成功'''</li>

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

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

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

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

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

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

</li>

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

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

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

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

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

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

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

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

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

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

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

</div></li>

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

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

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

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

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

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

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

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

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

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

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

[[File:media/image53.png~~|575x137px~~]]

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

[[File:media/image54.png~~|575x316px~~]]

'''如果格式化有问题，请尝试拔插下TF卡后再测试，如果重新拔插TF卡后还是有问题，可以重启下Window电脑或者换一台电脑再试下。'''</li>

<li>然后开始将Android镜像写入TF卡

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

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

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

</li>

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

[[File:media/image56.png~~|575x354px~~]]

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

[[File:media/image57.png~~|193x45px~~]]

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

[[File:media/image58.png~~|368x131px~~]]

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

[[File:media/image59.png~~|391x220px~~]]</li></ol>

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

[[File:media/image60.png~~|284x124px~~]]

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

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

[[File:media/image17.png~~|242x121px~~]]

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

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

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

[[File:media/image62.png~~|345x156px~~]]

'''注意：40pin接口上的排针默认是不焊接的，需要自己焊接上去才能使用。'''</li>

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

</li>

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

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

'''串口的TX和RX是需要交叉连接的，如果不想仔细区分TX和RX的顺序，可以把串口的TX和RX先随便接上，如果测试串口没有输出再交换下TX和RX的顺序，这样就总有一种顺序是对的。'''</li></ol>

test@test:~$ '''sudo putty'''</li>

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

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

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

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

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

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

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

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

</li>

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

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

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

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

</li>

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

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

[https://mobaxterm.mobatek.net/ '''https://mobaxterm.mobatek.net/''']</li>

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

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

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

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

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

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

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

</li>

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

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

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

</li></ol>

[[File:media/image73.png~~|575x291px~~]]

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

[[File:media/image74.png~~|575x291px~~]]</li></ol>

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

[[File:media/image75.jpeg~~|216x154px|4ff86e49b6624616f9498fe44c366f29~~]]

</div>

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

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

[[File:media/image23.png~~|345x187px~~]]</li></ol>

</li></ol>

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

</div>

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

[[File:media/image77.png~~|475x240px~~]]</li>

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

orangepi@orangepi:~$ '''sudo auto_login_cli.sh root'''</li>

[[File:media/image78.png~~|576x324px|1~~]]

</div></li>

[[File:media/image79.png~~|569x320px|IMG_256~~]]

</div>

orangepi@orangepi:~$ '''sudo desktop_login.sh root'''</li>

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

[[File:media/image80.png~~|294x123px~~]]

'''注意，如果使用root用户登录桌面系统，是无法使用右上角的pulseaudio来管理音频设备的。'''

'''另外请注意这并不是一个bug，因为pulseaudio本来就不允许在root用户下运行。'''</li>

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|389x192px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

[[File:media/image83.png~~|397x35px~~]]</li>

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li>

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

</li></ol>

test@test:~$ '''sudo gparted'''</li>

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

[[File:media/image87.png~~|575x210px~~]]</li>

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

</li>

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

[[File:media/image88.png~~|575x211px~~]]</li></ol>

'''需要注意的是，linux系统只有一个ext4格式的分区，没有使用单独的BOOT分区来存放内核镜像等文件，所以也就不存在BOOT分区扩容的问题。'''

test@test:~$ '''sudo gparted'''</li>

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

[[File:media/image87.png~~|575x210px~~]]</li>

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

[[File:media/image89.png~~|575x211px~~]]</li>

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

[[File:media/image90.png~~|436x298px~~]]</li>

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

[[File:media/image91.png~~|444x302px~~]]</li>

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

[[File:media/image92.png~~|315x193px~~]]</li>

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

[[File:media/image93.png~~|320x191px~~]]</li>

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

[[File:media/image94.png~~|327x196px~~]]</li>

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

[[File:media/image95.png~~|392x270px~~]]</li>

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

[[File:media/image96.png~~|399x116px~~]]</li>

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

[[File:media/image97.png~~|399x172px~~]]</li>

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

root@orangepi:~# '''df -h'''

test@test:~$ '''sudo gparted'''</li>

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

[[File:media/image98.png~~|575x217px~~]]</li>

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

[[File:media/image99.png~~|575x217px~~]]</li>

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

[[File:media/image100.png~~|400x274px~~]]</li>

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

[[File:media/image101.png~~|399x273px~~]]</li>

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

[[File:media/image102.png~~|315x188px~~]]</li>

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

[[File:media/image93.png~~|318x190px~~]]</li>

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

[[File:media/image94.png~~|327x196px~~]]</li>

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

[[File:media/image95.png~~|392x270px~~]]</li>

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

[[File:media/image96.png~~|365x106px~~]]</li>

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

[[File:media/image97.png~~|379x164px~~]]</li>

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

root@orangepi:~# '''df -h'''

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

[[File:media/image103.png~~|289x96px~~]]</li>

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

[[File:media/image104.png~~|337x230px~~]]</li>

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

[[File:media/image105.jpeg~~|357x207px|_MG_2148~~]]

</div></li>

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

[[File:media/image6.png~~|332x156px~~]]</li></ol>

{| class="wikitable"

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

[[File:media/image106.png~~|346x182px~~]]</li>

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

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

[[File:media/image107.png~~|338x229px~~]]</li>

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

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

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

</div></li>

orangepi@orangepi:~$ '''sudo nmtui'''</li>

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

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

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

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

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

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

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

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

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

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

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

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

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

orangepi@orangepi:~$ '''ip a s wlan0'''

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

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

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

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

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

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

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

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

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

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

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

wlan0: EAPOL-4WAY-HS-COMPLETED ce:bd:9a:dd:a5:86</li>

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

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

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

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

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

'''注意，下面的命令中，Debian12需要修改eth0为end0。'''

device interrupt 83

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

[[File:media/image121.png~~|271x129px~~]][[File:media/image122.png~~|274x155px~~]]</li>

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

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

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

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

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

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

wlan0: EAPOL-4WAY-HS-COMPLETED ce:bd:9a:dd:a5:86</li>

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

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

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

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

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

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

device interrupt 83

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

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

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

'''注意，下面的命令中，Debian12需要修改eth0为end0。'''</li></ol>

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

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

orangepi@orangepi:~$ '''sudo nmtui'''</li>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

'''注意，下面的命令中，Debian12需要修改eth0为end0。'''

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

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

'''如果ssh无法正常登陆linux系统，首先请检查下开发板的IP地址是否能ping通，如果ping通没问题的话，可以通过串口或者HDMI显示器登录linux系统然后在开发板上输入下面的命令后再尝试是否能连接：'''</li></ol>

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

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

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

</li>

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

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

[[File:media/image144.png~~|575x157px~~]]</li>

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

[[File:media/image145.png~~|450x313px~~]]</li></ol>

[[File:media/image14.jpeg~~|148x132px|IMG_256~~]]

</div></li>

<li>HDMI转VGA转换器

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

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

[[File:media/image147.png~~|145x131px~~]] [[File:media/image148.png~~|225x128px~~]]</li>

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

</li>

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

[[File:media/image149.png~~|574x337px~~]]

'''使用HDMI转VGA显示时，开发板以及开发板的Linux系统是不需要做任何设置的，只需要开发板Mini HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</li></ol>

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

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

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

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

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

<li>然后选择适配器

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[[File:media/image162.jpeg~~|223x232px|Screenshot_20201205_142413~~]]

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

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

[[File:media/image163.png~~|383x190px~~]]

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

[[File:media/image24.png~~|193x127px~~]]

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

[[File:media/image107.png~~|338x229px~~]]

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

[[File:media/image163.png~~|346x171px~~]]

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

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|397x196px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

[[File:media/image164.png~~|400x58px~~]]</li>

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|281x140px~~]]</li>

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

[[File:media/image165.png~~|575x279px|选区_021~~]]

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

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

[[File:media/image107.png~~|338x229px~~]]</li>

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

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

[[File:media/image166.png~~|257x126px~~]]</li>

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

[[File:media/image167.png~~|238x189px~~]]</li>

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

[[File:media/image168.png~~|241x195px~~]]</li>

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

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

[[File:media/image169.png~~|294x161px~~]]</li>

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

[[File:media/image170.png~~|576x324px|4~~]]

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

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

[[File:media/image107.png~~|338x226px~~]]</li>

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

[[File:media/image171.jpeg~~|140x131px|IMG_256~~]]

</div></li>

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

[[File:media/image172.png~~|298x157px~~]]</li>

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

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

[[File:media/image173.png~~|576x405px~~]]

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

orangepi@orangepi:~/wiringOP$ '''sudo ./build'''</li>

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

[[File:media/image173.png~~|576x405px~~]]</li></ol>

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

[[File:media/image174.png~~|575x127px~~]]</li>

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

root@orangepi:~/wiringOP# '''gpio mode 2 out'''</li>

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

[[File:media/image174.png~~|575x127px~~]]</li>

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

root@orangepi:~/wiringOP# '''gpio mode 2 in'''</li>

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|402x199px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

</li></ol>

|}

[[File:media/image175.png~~|397x79px~~]]

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li></ol>

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|394x195px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

</li></ol>

|}

[[File:media/image176.png~~|393x60px~~]]

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

[[File:media/image84.png~~|395x91px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li></ol>

[[File:media/image177.png~~|383x151px|选区_460~~]]

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

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|396x195px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

</li></ol>

|}

[[File:media/image178.png~~|395x216px~~]]

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li></ol>

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|393x194px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

[[File:media/image179.png~~|384x79px~~]]</li>

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li></ol>

</li>

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

[[File:media/image180.jpeg~~|574x344px|69D96433378187B10005CDD2A52881B0~~]]

</div>

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

[[File:media/image173.png~~|576x405px~~]]

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

[[File:media/image174.png~~|575x127px~~]]</li>

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

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|389x192px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

</li></ol>

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li></ol>

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|394x195px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

</li></ol>

|}

[[File:media/image176.png~~|393x60px~~]]

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

[[File:media/image84.png~~|395x91px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li></ol>

orangepi@orangepi:~$ '''sudo''' '''apt-get install -y i2c-tools'''</li>

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

[[File:media/image181.png~~|180x153px~~]]</li>

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

'''注意，i2cdetect -y x命令中的x需要替换为i2c总线对应的设备节点的序号。'''</li></ol>

[[File:media/image182.png~~|388x203px~~]]

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|396x195px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

</li></ol>

|}

[[File:media/image178.png~~|395x216px~~]]

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|374x187px~~]]</li></ol>

<li>然后在浏览器中输入【开发板的IP地址:8123】就能看到Home Assistant的界面

'''Home Assistant容器的启动需要一段时间，如果下面的界面没有正常显示，请等待几秒钟再刷新。如果等待一分钟以上还没有正常显示下面的界面说明Home Assistant安装有问题，此时需要去检查前面的安装设置过程是否有问题了。'''

[[File:media/image183.png~~|576x209px~~]]</li>

<li>然后输入'''姓名、用户名'''和'''密码'''再点击'''创建账号'''

[[File:media/image184.png~~|220x279px~~]]</li>

<li>然后按照界面提示根据自己的喜好设置，再点击下一步

[[File:media/image185.png~~|575x297px~~]]</li>

<li>然后点击下一步

[[File:media/image186.png~~|576x185px~~]]</li>

<li>然后点击完成

[[File:media/image187.png~~|576x117px~~]]</li>

<li>Home Assistant最终显示的主界面如下图所示

[[File:media/image188.png~~|574x294px~~]]</li>

<li>停止Home Assistant容器的方法

<li>然后在浏览器中输入【'''开发板的IP地址:8123'''】就能看到Home Assistant的界面

'''第一次运行hass命令时，会下载安装和缓存一些运行必须的库和依赖包。这个过程可能会花费几分钟的时间。注意，此时在浏览器中是无法看到Home Assistant的界面的，请等待一段时间后再刷新下。'''

[[File:media/image189.png~~|576x203px~~]]</li></ol>

orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''</li>

<li>然后在弹出的界面中选择'''zh_CN.UTF-8 > UTF-8'''（通过键盘上的上下方向按键来上下移动，通过空格键来选择，最后通过Tab键可以将光标移动到'''<OK>'''，然后回车即可）

[[File:media/image190.png~~|575x296px~~]]</li>

<li>然后设置默认'''locale'''为'''zh_CN.UTF-8'''

[[File:media/image191.png~~|575x160px~~]]</li>

<li>退出界面后就会开始'''locale'''的设置，命令行显示的输出如下所示

orangepi@orangepi:~$ '''sudo dpkg-reconfigure locales'''

</li>

<li>然后打开'''Input Method'''

[[File:media/image192.png~~|575x361px~~]]</li>

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

[[File:media/image193.png~~|295x212px~~]]</li>

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

[[File:media/image194.png~~|303x192px~~]]</li>

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

[[File:media/image195.png~~|307x220px~~]]</li>

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

[[File:media/image196.png~~|305x216px~~]]</li>

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

<li>然后打开'''Fcitx configuration'''

[[File:media/image197.png~~|575x376px~~]]</li>

<li>然后点击下图所示位置的'''+'''号

[[File:media/image198.png~~|280x187px~~]]</li>

<li>然后搜索'''Google Pinyin'''再点击'''OK'''

[[File:media/image199.png~~|291x196px~~]]</li>

<li>然后将'''Google Pinyin'''放到最前面

[[File:media/image200.png~~|299x202px~~]][[File:media/image201.png~~|300x202px~~]]</li>

<li>然后打开'''Geany'''这个编辑器测试下中文输入法

[[File:media/image202.png~~|349x212px~~]]</li>

<li>中文输入法测试如下所示

[[File:media/image203.png~~|575x325px~~]]</li>

<li>通过'''Ctrl+Space'''快捷键可以切换中英文输入法</li>

<li>如果需要整个系统都显示为中文，可以将'''/etc/default/locale'''中的变量都设置为'''zh_CN.UTF-8'''

LANGUAGE='''zh_CN.UTF-8'''</li>

<li>然后'''重启系统'''就能看到系统显示为中文了

[[File:media/image204.png~~|576x356px~~]]</li></ol>

<li>首先打开'''Language Support'''

[[File:media/image205.png~~|575x351px~~]]</li>

<li>然后找到'''汉语（中国）'''选项

[[File:media/image206.png~~|318x311px~~]]</li>

<li>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：

[[File:media/image207.png~~|324x320px~~]]</li></ol>

'''注意，这一步不是很好拖动的，请耐心多试几次。'''

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

[[File:media/image208.png~~|321x316px~~]]</li>

<li>然后设置'''Keyboard input method system'''为'''fcitx'''

[[File:media/image209.png~~|327x320px~~]]</li>

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

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

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

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

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

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

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

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

[[File:media/image213.png~~|575x308px~~]]</li></ol>

<li>首先打开'''Language Support'''

[[File:media/image205.png~~|575x351px~~]]</li>

<li>然后找到'''汉语（中国）'''选项

[[File:media/image214.png~~|249x242px~~]]</li>

<li>然后请使用鼠标左键选中'''汉语（中国）'''并按住不动，然后往上将其拖到最开始的位置，拖完后的显示如下图所示：

[[File:media/image215.png~~|267x262px~~]]</li></ol>

'''注意，这一步不是很好拖动的，请耐心多试几次。'''

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[https://www.nomachine.com/download/download&id=112&s=ARM '''https://downloads.nomachine.com/download/?id=118&distro=ARM''']

[[File:media/image221.png~~|575x227px~~]]

<li>另外在'''官方工具'''中也可以下载到'''NoMachine'''的安装包

[[File:media/image222.png~~|70x86px~~]]

先进入'''远程登录软件-NoMachine'''文件夹

[[File:media/image223.png~~|256x46px~~]]

然后下载arm64版本的deb安装包

[[File:media/image224.png~~|180x109px~~]]</li>

<li>然后将下载的'''nomachine_x.x.x_x_arm64.deb'''上传到开发板的Linux系统中</li>

<li>然后使用下面的命令在开发板的Linux系统中安装'''NoMachine'''

'''https://downloads.nomachine.com/download/?id=9'''

[[File:media/image225.png~~|575x163px~~]]

<li>然后在Windows中安装NoMachine，'''安装完后请重启下电脑'''</li>

<li>然后在Window中打开'''NoMachine'''

[[File:media/image226.png~~|76x66px~~]]</li>

<li>NoMachine启动后会自动扫描局域网内其他安装有NoMachine的设备，进入NoMachine的主界面后就可以看到开发板已经在可连接的设备列表里了，然后点击下图红色方框所示的位置即可开始登录开发板的Linux系统桌面

[[File:media/image227.png~~|321x92px~~]]</li>

<li>然后点击'''OK'''

[[File:media/image228.png~~|318x217px~~]]</li>

<li>然后在下图对应的位置输入开发板Linux系统的用户名和密码，再点击'''OK'''开始登陆

[[File:media/image229.png~~|303x204px~~]]</li>

<li>然后在接下来的界面中都点击OK</li>

<li>最后就能看到开发板Linux系统的桌面了

[[File:media/image230.png~~|411x246px~~]]</li></ol>

</li></ol>

[[File:media/image231.png~~|421x300px~~]]

<li>然后输入前面设置的VNC的密码

[[File:media/image232.png~~|221x105px~~]]</li>

<li>登录成功后的界面显示如下图所示，然后就可以远程操作开发板linux系统的桌面了</li></ol>

[[File:media/image233.png~~|405x293px~~]]

</li>

<li>然后在'''Applications'''中就可以看到QT Creator的启动图标

[[File:media/image234.png~~|576x270px~~]]

也可以使用下面的命令打开QT Creator

orangepi@orangepi:~$ '''qtcreator'''</li>

<li>QT Creator打开后的界面如下所示

[[File:media/image235.png~~|576x342px~~]]</li>

<li>QT Creator的版本如下所示

<li>QT Creator在'''Ubuntu20.04'''中的默认版本如下所示

[[File:media/image236.png~~|419x224px~~]]</li>

<li>QT Creator在'''Ubuntu22.04'''中的默认版本如下所示

[[File:media/image237.png~~|443x237px~~]]</li>

<li>QT Creator在'''Debian11'''中的默认版本如下所示

[[File:media/image238.png~~|444x238px~~]]</li>

<li>QT Creator在'''Debian12'''中的默认版本如下所示

[[File:media/image239.png~~|449x277px~~]]</li></ol>

</li>

<li>然后设置下QT

<li>首先打开'''Help'''->'''About Plugins...'''

[[File:media/image240.png~~|573x164px~~]]</li>

<li>然后去掉'''ClangCodeModel'''的那个勾

[[File:media/image241.png~~|408x254px~~]]</li>

<li>'''设置完后需要重启下QT Creator'''</li>

<li>然后确保QT Creator使用的GCC编译器，如果默认为Clang，请修改为GCC

'''Debian12请跳过这步。'''

[[File:media/image242.png~~|576x315px~~]][[File:media/image243.png~~|575x307px~~]]</li></ol>

</li>

<li>然后就可以打开一个示例代码

[[File:media/image244.png~~|575x312px~~]]</li>

<li>点击示例代码后会自动打开对应的说明文档，可以仔细看下其中的使用说明

[[File:media/image245.png~~|576x218px~~]]</li>

<li>然后点击下'''Configure Project'''

[[File:media/image246.png~~|575x304px~~]]</li>

<li>然后点击左下角的绿色三角形编译运行下示例代码

[[File:media/image247.png~~|575x312px~~]]</li>

<li>等待一段时间后，会弹出下图所示的界面，此时就说明QT能正常编译运行

[[File:media/image248.png~~|576x308px~~]]</li>

<li>参考资料

[https://wiki.qt.io/Install_Qt_5_on_Ubuntu '''https://wiki.qt.io/Install_Qt_5_on_Ubuntu''']

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

[[File:media/image249.png~~|345x235px~~]]

[[File:media/image250.png~~|576x210px~~]]

[http://docs.ros.org/ '''http://docs.ros.org''']

<li>ROS '''Noetic Ninjemys'''官方安装文档中Ubuntu推荐使用Ubuntu20.04，所以请确保开发板使用的系统为'''Ubuntu20.04桌面版系统'''

[http://wiki.ros.org/noetic/Installation '''http://wiki.ros.org/noetic/Installation''']

[[File:media/image251.png~~|312x176px~~]]</li>

<li>然后使用下面的脚本安装ros1

orangepi@orangepi:~$ '''install_ros.sh ros1'''</li>

orangepi@orangepi:~$ '''test_ros.sh'''</li>

<li>运行完'''test_ros.sh'''脚本后，会弹出下图所示的一个小海龟

[[File:media/image252.png~~|575x291px~~]]</li>

<li>然后请保持刚才打开终端窗口在最上面</li></ol>

[[File:media/image253.png~~|575x269px~~]]

<li>此时按下键盘上的方向按键就可以控制小海龟上下左右移动了

[[File:media/image254.png~~|575x250px~~]]</li></ol>

<li>ROS 2当前活跃的版本如下所示，推荐版本为'''Galactic Geochelone'''

[[File:media/image255.png~~|576x271px~~]][[File:media/image256.png~~|575x265px~~]]

[http://docs.ros.org/ '''http://docs.ros.org''']

'''http://docs.ros.org/en/galactic/Releases.html'''</li>

orangepi@orangepi:~$ '''source /opt/ros/galactic/setup.bash'''

orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''

[[File:media/image257.png~~|576x324px~~]]</li>

<li>ROS的使用方法请参考下ROS 2的文档

[http://docs.ros.org/en/galactic/Tutorials.html '''http://docs.ros.org/en/galactic/Tutorials.html''']</li></ol>

orangepi@orangepi:~$ '''source /opt/ros/humble/setup.bash'''

orangepi@orangepi:~$ '''ros2 run rviz2 rviz2'''

[[File:media/image258.png~~|575x323px~~]]</li>

<li>参考文档

'''http://docs.ros.org/en/humble/index.html'''

[[File:media/image259.png~~|576x453px|截图 2022-12-03 19-04-40~~]]

</div></li>

[[File:media/image260.png~~|577x128px|IMG_256~~]]

</div>

<li>然后选择'''保存密码'''，再点击'''确定'''

[[File:media/image261.png~~|249x181px~~]]</li>

<li>然后选择'''总是信任该主机'''，再点击'''确定'''</li></ol>

[[File:media/image262.png~~|278x150px|IMG_256~~]]

</div>

[[File:media/image263.png~~|533x330px|IMG_256~~]]

</div>

[[File:media/image264.png~~|529x414px|IMG_256~~]]

</div>

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

[https://filezilla-project.org/download.php?type=client '''https://filezilla-project.org/download.php?type=client'''] [[File:media/image265.png~~|472x171px|IMG_256~~]]

[[File:media/image266.png~~|384x276px~~]]

[[File:media/image267.png~~|355x279px|IMG_256~~]]

</div>

[[File:media/image268.png~~|451x357px|IMG_256~~]]

</div>

[[File:media/image269.png~~|522x108px|IMG_256~~]]

</div>

[[File:media/image270.png~~|207x146px|IMG_256~~]]

</div>

[[File:media/image271.png~~|221x109px|IMG_256~~]]

</div>

[[File:media/image272.png~~|449x332px|IMG_256~~]]

</div>

[[File:media/image273.png~~|461x340px|IMG_256~~]]

</div>

开发板主板上没有开关机按键，我们可以通过24pin扩展板来扩展。开关机按键在扩展板上的位置如下所示：

[[File:media/image274.png~~|190x98px~~]]

Linux6.1镜像开关机按键默认是打开的，但Linux5.4内核镜像的开关机按键默认是关闭的，需要手动打开才能正常使用。步骤如下所示：

orangepi@orangepi:~$ '''sudo orangepi-config'''</li>

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

[[File:media/image81.png~~|402x199px~~]]</li>

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

[[File:media/image82.png~~|393x202px~~]]</li>

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

[[File:media/image275.png~~|399x76px~~]]</li>

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

[[File:media/image84.png~~|397x92px~~]]</li>

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

[[File:media/image85.png~~|395x91px~~]]</li>

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

[[File:media/image86.png~~|298x149px~~]]</li></ol>

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

'''注意，关闭开发板后需要重新拔插电源才能开机。'''</li>

<li>除了使用poweroff命令关机外，还可以使用扩展板上的开关机按键来关机

[[File:media/image274.png~~|190x98px~~]]

'''注意，Linux5.4需要手动打开开关机按键的配置才能使用。打开方法请参考[[\l|Linux5.4打开开关机按键的方法]]。'''</li>

<li>使用'''reboot'''命令即可重启开发板中的Linux系统

<li>注意Ubuntu版本需要切换到22.04。

[[File:media/image276.png~~|576x241px~~]]</li>

<li>需要替换的'''/etc/apt/sources.list'''文件的内容为：

test@test:~$ '''sudo mv /etc/apt/sources.list cat /etc/apt/sources.list.bak'''

'''注意，使用H618 Soc的开发板是需要下载orangepi-build的next分支源码的，上面的git clone命令需要指定orangepi-build源码的分支为next。'''

[[File:media/image277.png~~|576x288px~~]]

'''通过git clone命令下载orangepi-build的代码是不需要输入github账号的用户名和密码的（下载本手册中的其他代码也是一样的），如果如输入git clone命令后Ubuntu PC提示需要输入github账号的用户名和密码，一般都是git clone后面的orangepi-build仓库的地址输入错误了，请仔细检查命令拼写是否有错误，而不是以为我们这里忘了提供github账号的用户名和密码。'''

[[File:media/image278.png~~|575x278px|选区_396~~]]

</div>

[[File:media/image279.png~~|576x132px|选区_238~~]]

</div></li>

<li>接着选择开发板的型号

[[File:media/image280.png~~|576x266px~~]]</li>

<li>然后选择u-boot的分支类型

<li>current分支会编译linux5.4镜像需要使用的u-boot v2018.05版本的代码</li>

<li>next分支会编译linux6.1镜像需要使用的u-boot v2021.07版本的代码

[[File:media/image281.png~~|576x77px~~]]</li></ol>

</li>

<li>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择

<li>如果购买的开发板为1.5GB内存大小的，请选择第一项</li>

<li>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项

[[File:media/image282.png~~|575x72px~~]]</li></ol>

</li>

<li>然后就会开始编译u-boot，编译next分支时提示的部分信息说明如下所示：

orangepi@orangepi:~$ '''sudo nand-sata-install'''</li>

<li>然后选择'''5 Install/Update the bootloader on SD/eMMC'''

[[File:media/image283.png~~|320x174px~~]]</li>

<li>按下回车键后首先会弹出一个Warning

[[File:media/image284.png~~|314x170px~~]]</li>

<li>再按下回车键就会开始更新u-boot，更新完后会显示下面的信息

[[File:media/image285.png~~|292x164px~~]]</li>

<li>然后就可以重启开发板来测试u-boot的修改是否生效了</li></ol>

</li></ol>

[[File:media/image286.png~~|575x116px|选区_240~~]]

</div></li>

<li>然后会提示是否需要显示内核配置界面，如果不需要修改内核配置，则选择第一个即可，如果需要修改内核配置，则选择第二个

[[File:media/image287.png~~|576x87px~~]]</li>

<li>接着选择开发板的型号

[[File:media/image280.png~~|576x266px~~]]</li>

<li>然后选择内核源码的分支类型

<li>current分支会编译linux5.4内核源码</li>

<li>next分支会编译linux6.1内核源码

[[File:media/image281.png~~|576x77px~~]]</li></ol>

</li>

<li>如果第3)步选择了需要显示内核配置菜单（第二个选项），则会弹出通过'''make menuconfig'''打开的内核配置的界面，此时可以直接修改内核的配置，修改完后再保存退出即可，退出后会开始编译内核源码。

[[File:media/image288.png~~|575x357px~~]]</li></ol>

<li>也可以设置orangepi-build/userpatches/config-default.conf配置文件中的'''KERNEL_CONFIGURE=no'''，这样可以永久禁用这个功能</li>

<li>编译内核的时候如果提示下面的错误，这是由于Ubuntu > PC的终端界面太小，导致make menuconfig的界面无法显示，请把Ubuntu > PC的终端调到最大，然后重新运行build.sh脚本

[[File:media/image289.png~~|574x234px~~]]</li></ol>

[[File:media/image290.png~~|576x119px|选区_241~~]]

</div>

<li>接着选择开发板的型号

[[File:media/image280.png~~|576x266px~~]]</li>

<li>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别

<li>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</li>

<li>next分支可以看到debian11、debian12、ubuntu22.04三个选项

[[File:media/image281.png~~|576x77px~~]]</li></ol>

</li>

<li>然后选择rootfs的类型

[[File:media/image291.png~~|576x79px~~]]</li>

<li>然后选择镜像的类型

[[File:media/image292.png~~|576x75px|选区_245~~]]

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

[[File:media/image293.png~~|576x78px|选区_397~~]]

</div></li>

<li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面

[[File:media/image294.png~~|576x76px~~]][[File:media/image295.png~~|576x74px~~]]

然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。

[[File:media/image296.png~~|575x264px~~]]</li>

<li>然后就会开始编译rootfs，编译时提示的部分信息说明如下

[[File:media/image297.png~~|576x128px|选区_242~~]]

</div>

<li>然后选择开发板的型号

[[File:media/image280.png~~|576x266px~~]]</li>

<li>然后选择内核源码的分支类型，不同版本的内核源码维护的rootfs类型有区别

<li>current分支可以看到debian11、ubuntu20.04、ubuntu22.04三个选项</li>

<li>next分支可以看到debian11、debian12、ubuntu22.04三个选项

[[File:media/image281.png~~|576x77px~~]]</li></ol>

</li>

<li>如果选择的next分支还会提示需要选择内存的大小，current分支不需要选择

<li>如果购买的开发板为1.5GB内存大小的，请选择第一项</li>

<li>如果购买的开发板为1GB或2GB或4GB内存大小的，请选择第二项

[[File:media/image282.png~~|575x72px~~]]</li></ol>

</li>

<li>然后选择rootfs的类型

[[File:media/image291.png~~|576x79px~~]]</li>

<li>然后选择镜像的类型

[[File:media/image292.png~~|576x75px|选区_245~~]]

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

[[File:media/image293.png~~|576x78px|选区_397~~]]

</div></li>

<li>如果是编译桌面版本的镜像还需要选择桌面环境的类型，目前只维护XFCE，所以请选择XFCE类型的桌面

[[File:media/image294.png~~|576x76px~~]][[File:media/image295.png~~|576x74px~~]]

然后可以选择需要安装的额外的软件包。这里请按下回车键直接跳过。

[[File:media/image296.png~~|575x264px~~]]</li>

<li>然后就会开始编译linux镜像，编译的大致流程如下

[[File:media/image298.png~~|576x324px|1~~]]

</div></li>

[[File:media/image299.png~~|576x324px|2~~]]

</div></li>

[[File:media/image300.png~~|576x324px|3~~]]

</div></li>

[[File:media/image301.png~~|576x324px|4~~]]

</div></li>

[[File:media/image302.png~~|576x324px|5~~]]

</div></li>

[[File:media/image303.png~~|576x324px|6~~]]

</div></li>

[[File:media/image304.png~~|576x324px|7~~]]

</div></li>

[[File:media/image305.png~~|576x324px|8~~]]

</div></li>

[[File:media/image306.png~~|576x324px|9~~]]

</div></li>

[[File:media/image307.png~~|576x324px|1~~]]

</div>

如果有购买开发板配套的红外遥控（其他遥控不行）和24pin扩展板，将24pin扩展板接入开发板后，还可以通过遥控中的返回键来返回上一级菜单，返回键的位置如下图所示：

[[File:media/image308.png~~|231x185px~~]]

<li>准备一根USB Typc C接口的数据线， USB接口一端插入电脑的USB接口中，USB Type C接口一端插入开发板的USB0接口中（USB0的位置请见下面右边图片的说明）。在这种情况下是由电脑的USB接口给开发板供电，所以请确保电脑的USB接口能提供最够的功率驱动开发板。

[[File:media/image15.jpeg~~|172x172px|IMG_4194(20201104-125502)~~]] [[File:media/image309.png~~|316x169px~~]]</li>

<li>在Ubuntu PC上安装adb工具

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

<li>首先进入'''Settings'''

[[File:media/image310.png~~|234x83px~~]]</li>

<li>然后选择'''Device Preferences'''

[[File:media/image311.png~~|415x170px~~]]</li>

<li>然后选择'''Display & Sound'''

[[File:media/image312.png~~|420x133px~~]]</li>

<li>然后选择'''Advanced display settings'''

[[File:media/image313.png~~|423x96px~~]]</li>

<li>然后选择'''HDMI output mode'''

[[File:media/image314.png~~|423x101px~~]]</li>

<li>然后就能看到显示器支持的分辨率列表了。此时点击对应的选项就会切换到对应的分辨率。请注意，不同显示器支持的分辨率可能是不同的，如果接到电视上，一般会看到比下图更多的分辨率选项。

[[File:media/image315.png~~|429x136px~~]]</li>

<li>开发板的HDMI输出是支持4K显示的，当接到4K电视时就可以看到4K分辨率的选项

[[File:media/image316.png~~|429x242px~~]]</li></ol>

<li>HDMI转VGA转换器

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

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

[[File:media/image147.png~~|145x131px~~]] [[File:media/image148.png~~|219x124px~~]]</li>

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

</li>

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

[[File:media/image317.png~~|575x327px~~]]

'''使用HDMI转VGA显示时，开发板以及开发板的Android系统是不需要做任何设置的，只需要开发板Mini HDMI接口能正常显示就可以了。所以如果测试有问题，请检查HDMI转VGA转换器、VGA线以及显示器是否有问题。'''</li></ol>

<li>首先选择'''Settings'''

[[File:media/image310.png~~|234x83px~~]]</li>

<li>然后选择'''Network & Internet'''

[[File:media/image318.png~~|373x103px~~]]</li>

<li>然后打开WI-FI

[[File:media/image319.png~~|381x50px~~]]</li>

<li>打开WI-FI后在'''Available networks'''下面就可以看到搜索到的信号

[[File:media/image320.png~~|381x187px~~]]</li>

<li>选择想连接的WI-FI后会弹出下图所示的密码输入界面

[[File:media/image321.png~~|386x180px|Screenshot_20220104-164114~~]]

</div></li>

<li>然后使用键盘输入WI-FI对应的密码，再使用'''鼠标'''点击虚拟键盘中的回车按钮就会开始连接WI-FI了

[[File:media/image322.png~~|388x160px~~]]</li>

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

[[File:media/image323.png~~|402x141px~~]]</li></ol>

<li>首先请确保以太网口已连接网线，并且能正常上网</li>

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

[[File:media/image310.png~~|234x83px~~]]</li>

<li>然后选择'''Network & Internet'''

[[File:media/image318.png~~|373x103px~~]]</li>

<li>然后选择'''WIFI hotspot'''

[[File:media/image324.png~~|378x104px~~]]</li>

<li>然后打开'''Hotspot Enable'''，下图中还可以看到生成的热点的名字和密码，记住它们，在连接热点的时候要用到（如果需要修改热点的名字和密码，需要先关闭'''Hotspot Enable'''，然后才能修改）

[[File:media/image325.png~~|402x174px~~]]</li>

<li>此时可以拿出你的手机，如果一切正常，在手机搜索到的WI-FI列表中就能找到上图'''Hotspot name'''下面显示的同名（'''这里为AndroidAP_7132'''）的WIFI热点了。然后可以点击'''AndroidAP_7132'''连接热点，密码在上图的'''Hotspot password'''下面可以看到

[[File:media/image326.png~~|269x191px~~]]</li>

<li>连接成功后显示如下图所示（不同手机界面会有区别，具体界面以你手机显示的为准）。此时就可以在手机上打开一个网页看下能否上网了，如果能正常打开网页，说明开发板的'''WI-FI Hotspot'''能正常使用

[[File:media/image327.png~~|269x125px~~]]</li></ol>

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

[[File:media/image107.png~~|338x229px~~]]</li>

<li>然后请确保扩展板的网口连接到了路由器或者交换机</li>

<li>然后打开'''Settings'''

[[File:media/image328.png~~|431x161px~~]]</li>

<li>然后选择'''Network & Internet'''

[[File:media/image329.png~~|576x186px~~]]</li>

<li>然后在下图所示的位置就能看到开发板有线网口的IP地址了

[[File:media/image330.png~~|576x200px~~]]</li></ol>

== 蓝牙的连接方法 ==

<li>首先选择'''Settings'''

[[File:media/image310.png~~|234x83px~~]]</li>

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

[[File:media/image331.png~~|377x111px~~]]</li>

<li>然后打开'''Bluetooth Enable'''

[[File:media/image332.png~~|384x180px~~]]</li>

<li>然后点击'''Pair new device'''开始扫描周围的蓝牙设备

[[File:media/image333.png~~|389x129px~~]]</li>

<li>搜索到的蓝牙设备会在'''Available devices'''下面显示出来

[[File:media/image334.png~~|407x181px~~]]</li>

<li>然后点击想要连接的蓝牙设备就可以开始配对了，当弹出下面的界面时，请使用鼠标选择'''Pair'''选项

[[File:media/image335.png~~|420x115px~~]]</li>

<li>这里测试的是开发板和'''安卓手机'''蓝牙的配置过程，此时在手机上会弹出下面的确认界面，在手机上也点击配对按钮后就会开始配对过程

[[File:media/image336.png~~|178x200px~~]]</li>

<li>配对完成后，再打开'''Paired devices'''下面就可以看到已配对的蓝牙设备

[[File:media/image337.png~~|430x136px~~]]</li>

<li>此时可以使用手机蓝牙给开发板发送一张图片，发送后，在开发板的安卓系统中可以看到下面的确认界面，然后点击'''Accept'''就可以开始接收手机发过来的图片了

[[File:media/image338.png~~|433x113px~~]]</li>

<li>开发板Android系统蓝牙接收到的图片可以打开'''Received files'''中查看

[[File:media/image339.png~~|432x209px~~]]</li></ol>

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

[[File:media/image163.png~~|346x171px~~]]

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

<li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l|'''ADB的使用方法''']]一小节的说明</li>

<li>在开发板资料下载页面的'''官方工具'''中下载USB摄像头测试APP

[[File:media/image340.png~~|264x122px~~]][[File:media/image341.png~~|575x145px~~]]</li>

<li>然后使用adb命令安装USB摄像头测试APP到Android系统中，当然也可以使用U盘拷贝的方式进行安装

test@test:~$ '''adb install usbcamera.apk'''</li>

<li>安装完后在Android的桌面可以看到USB摄像头的启动图标

[[File:media/image342.png~~|576x132px~~]]</li>

<li>然后双击打开USB摄像头APP就可以看到USB摄像头的输出视频了</li></ol>

<li>在开发板资料下载页面的'''官方工具'''中下载'''rootcheck.apk'''

[[File:media/image340.png~~|264x122px~~]][[File:media/image343.png~~|575x124px~~]]</li>

<li>然后确保Ubuntu PC和开发板的adb连接正常，adb的使用方法请参考[[\l|'''ADB的使用方法''']]一小节的说明</li>

<li>然后使用adb命令安装rootcheck.apk到Android系统中，当然也可以使用U盘拷贝的方式进行安装

test@test:~$ '''adb install rootcheck.apk'''</li>

<li>安装完后在Android的桌面可以看到ROOT测试工具的启动图标

[[File:media/image344.png~~|575x119px~~]]</li>

<li>第一次打开'''ROOT测试工具'''后的显示界面如下图所示

[[File:media/image345.png~~|575x162px~~]]</li>

<li>然后就可以点击'''CHECK NOW'''开始Android系统的ROOT状态的检查，检查完后的显示如下所示，可以看到Android系统已取得ROOT权限

[[File:media/image346.png~~|575x161px~~]]</li></ol>

<li>首先请确保开发板和手机都连接了同一个WIFI热点，开发板连接WIFI的方法请参考[[\l|'''WI-FI的连接方法''']]一小节的说明</li>

<li>然后打开开发板安卓系统中的'''MiracastReceiver'''应用

[[File:media/image347.png~~|416x89px~~]]</li>

<li>'''MiracastReceiver'''打开后的界面如下所示

[[File:media/image348.png~~|576x324px|Screenshot_20230901-095945~~]]

</div></li>

<li>然后在手机设置中找到投屏功能，'''这里以小米12S Pro手机为例'''，其他品牌的手机请自行研究下，如下图所示，点击红色方框位置的按钮即可打开手机的投屏功能

[[File:media/image349.png~~|167x266px~~]]</li>

<li>等待一段时间后在手机上就能看到搜索到的可连接的设备，然后我们选择开发板对应的设备连接即可

[[File:media/image350.png~~|173x362px~~]]</li>

<li>然后在开发板的'''MiracastReceiver'''应用界面会弹出下图所示的选择框，这里我们选择'''Accept'''即可

[[File:media/image351.png~~|468x265px~~]]</li>

<li>然后就能在开发板连接的HDMI屏幕上看到手机屏幕的内容了

[[File:media/image352.png~~|576x352px~~]]</li></ol>

== 通过按键或红外遥控开关机的方法 ==

我们可以通过开关机按键或者红外遥控来关闭或开启开发板的安卓系统。但是需要注意的是，开发板主板上是没有开关机按键和红外接收器的，需要通过24pin扩展板来扩展。

[[File:media/image107.png~~|338x229px~~]]

24pin扩展板上的开关机按键所在位置如下图所示：

[[File:media/image274.png~~|190x98px~~]]

红外遥控电源按键所在位置如下所示：

[[File:media/image353.png~~|191x179px~~]]

关机时，我们需要长按开关机按键或者红外遥控上的电源按键，然后安卓系统会弹出下图所示的确认对话框，然后选择'''OK'''就会关闭安卓系统了。

[[File:media/image354.png~~|547x108px~~]]

关机后，再次长按开关机按键或者红外遥控上的电源按键就会开机了。

<li>首先在桌面中打开wiringOP APP

[[File:media/image355.png~~|571x132px~~]]</li>

<li>然后点击'''GPIO_TEST'''按钮打开GPIO测试界面

[[File:media/image356.png~~|575x136px~~]]</li>

<li>GPIO测试界面如下图所示，左边的两排'''CheckBox'''按钮和40pin引脚是一一对应的关系。当勾选'''CheckBox'''按钮时，对应的GPIO引脚会被设置为'''OUT'''模式，引脚电平设置为高电平；当取消勾选时，GPIO引脚电平会设置为低电平；当点击'''GPIO READALL'''按钮时，可以获取到wPi号、GPIO模式、引脚电平等信息；当点击'''BLINK ALL GPIO'''按钮时，会让所有的GPIO口循环输出高低电平，使用这个功能可以用来测试40pin中所有的GPIO口。

[[File:media/image357.png~~|575x331px~~]]</li>

<li>然后点击'''GPIO READALL'''按钮，输出信息如下图所示：

[[File:media/image358.png~~|576x324px|Screenshot_20230901-103250~~]]

</div></li>

<li>开发板40pin中总共有28个GPIO口可以使用，下面以12号引脚——对应GPIO为PI01——对应wPi序号为6——为例演示如何设置GPIO口的高低电平。首先点击12号引脚对应的'''CheckBox'''按钮，当按钮为选中状态时，12号引脚会设置为高电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''3.3v'''，说明设置高电平成功。

[[File:media/image359.png~~|486x304px~~]]</li>

<li>然后点击'''GPIO READALL'''按钮，可以看到当前的12号引脚模式为'''OUT'''，引脚电平为高电平

[[File:media/image360.png~~|453x289px~~]]</li>

<li>再次点击下图的'''CheckBox'''按钮取消勾选状态，12号引脚就会设置为低电平，设置完后可以使用万用表测量引脚的电压的数值，如果为'''0v'''，说明设置低电平成功

[[File:media/image361.png~~|452x280px~~]]</li>

<li>然后点击'''GPIO READALL'''按钮，可以看到当前的12号引脚模式为OUT，引脚电平为低电平

[[File:media/image362.png~~|417x264px~~]]</li></ol>

/dev/ttyAS0 /dev/ttyAS1 '''/dev/ttyAS2 /dev/ttyAS5'''</li>

<li>首先在桌面中打开wiringOP APP

[[File:media/image355.png~~|576x133px~~]]</li>

<li>然后点击'''UART_TEST'''按钮打开UART测试界面

[[File:media/image363.png~~|576x130px~~]]</li>

<li>wiringOP的串口测试界面如下图所示</li></ol>

[[File:media/image364.png~~|576x150px~~]]

<li>然后在选择框中选择'''/dev/ttyAS2'''或者'''/dev/ttyAS5'''节点

[[File:media/image365.png~~|352x186px~~]]</li>

<li>再在编辑框中输入想要设置的波特率，然后点击'''OPEN'''按钮打开uart节点，打开成功后，'''OPEN'''按钮变为不可选中状态，'''CLOSE'''按钮和'''SEND'''按钮变为可选中状态</li></ol>

[[File:media/image366.png~~|334x107px~~]]

<li>然后可以在下面的发送编辑框中输入一段字符，点击'''SEND'''按钮开始发送</li></ol>

[[File:media/image367.png~~|376x189px~~]]

<li>如果一切正常，接收框内会显示已接收到的字符串</li></ol>

[[File:media/image368.png~~|382x196px~~]]

<li>然后在桌面中打开wiringOP APP

[[File:media/image355.png~~|576x133px~~]]</li>

<li>然后点击'''SPI_TEST'''按钮打开SPI的测试界面

[[File:media/image369.png~~|575x131px~~]]</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~~|296x135px~~]]</li>

<li>然后点击'''OPEN'''按钮初始化SPI</li></ol>

[[File:media/image371.png~~|295x168px~~]]

<li>然后填充需要发送的字节，比如读取板载SPIFlash的ID信息，在data[0]中填入地址0x9f，然后点击'''TRANSFER'''按钮

[[File:media/image372.png~~|294x169px~~]]</li>

<li>最后APP会显示读取到的板载SPI Flash的ID信息</li></ol>

[[File:media/image373.png~~|296x223px~~]]

'''/dev/i2c-1 /dev/i2c-2''' /dev/i2c-5</li>

<li>首先在桌面中打开wiringOP APP

[[File:media/image355.png~~|576x133px~~]]</li>

<li>然后点击'''I2C_TEST'''按钮打开i2c的测试界面

[[File:media/image374.png~~|576x133px~~]]</li>

<li>wiringOP的i2c测试界面如下图所示</li></ol>

[[File:media/image375.png~~|231x164px~~]]

<li>然后点击左上角的设备节点选择框选择想要测试的i2c

[[File:media/image376.png~~|239x186px~~]]</li>

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

[[File:media/image181.png~~|121x103px~~]]</li>

<li>ds1307 rtc模块的i2c地址为0x68，接好线后，我们可以在串口命令行中使用'''i2cdetect -y 1'''或'''i2cdetect -y 2'''命令查看下是否能扫描到ds1307 rtc模块的i2c地址。如果能看到0x68这个地址，说明ds1307 rtc模块接线正确。

apollo-p2:/ # '''i2cdetect -y 1'''

'''或'''

apollo-p2:/ # '''i2cdetect -y 2'''

[[File:media/image377.png~~|361x166px~~]]</li>

<li>然后在wiringOP中设置i2c的地址为0x68，再点击'''OPEN'''按钮打开i2c

[[File:media/image378.png~~|256x159px~~]]</li>

<li>点击'''OPEN'''按钮打开i2c后的显示如下所示

[[File:media/image379.png~~|320x191px~~]]</li>

<li>然后我们测试下往rtc模块的寄存器中写入一个值，比如往0x1c地址写入0x55

<li>我们首先设置需要写入的寄存器的地址为0x1c

[[File:media/image380.png~~|321x194px~~]]</li>

<li>然后设置需要写入的值为0x55

[[File:media/image381.png~~|309x182px~~]]</li>

<li>然后点击'''WRITE BYTE'''按钮执行写入的动作

[[File:media/image382.png~~|304x185px~~]]</li></ol>

</li>

<li>然后点击'''READ BYTE'''按钮读取下0x1c寄存器的值，如果显示为0x55，就说明i2c读写测试通过

[[File:media/image383.png~~|290x181px~~]]</li></ol>

<li>首先点击wiringOP图标打开wiringOP APP

[[File:media/image355.png~~|576x133px~~]]</li>

<li>然后在wiringOP的主界面点击'''PWM_TEST'''按钮进入PWM的测试界面

[[File:media/image384.png~~|575x129px~~]]</li>

<li>PWM测试界面如下所示

[[File:media/image385.png~~|576x159px|Screenshot_20230901-115927~~]]

</div></li>

<li>然后在Channel中设置下想用哪个PWM，默认是PWM1，如果想设置为PWM2，则在Channel中输入2即可，PWM3和PWM4以此类推

[[File:media/image386.png~~|575x177px~~]]</li>

<li>然后可以设置下PWM的周期，默认的配置是'''50000ns'''，转换为PWM频率是'''20KHz'''

[[File:media/image387.png~~|337x155px~~]]</li>

<li>然后点击'''EXPORT'''按钮导出PWM

[[File:media/image388.png~~|336x144px~~]]</li>

<li>然后拖动下面的进度条，就可以改变PWM的占空比，然后勾选'''Enable'''就可以输出PWM波形了</li></ol>

[[File:media/image389.png~~|575x152px~~]]

<li>然后使用示波器测量开发板40pin中的对应引脚就可以看到下面的波形了</li></ol>

[[File:media/image390.png~~|460x276px~~]]

<li>百度网盘

[[File:media/image391.png~~|576x298px~~]]</li>

<li>谷歌网盘

[[File:media/image392.png~~|575x261px~~]]</li></ol>

</li>

<li>Android 12源码的分卷压缩包下载完后，请先检查下MD5校验和是否正确，如果不正确，请重新下载源码。检查MD5校验和的方法如下所示：

Admin

行政员、管理员

8,460

个编辑

Wiki-Orange Pi β

更改

Orange Pi Zero 2W

Wiki-Orange Pi ^β