手把手带你快速上手香橙派AIpro
本文分享自华为云社区《香橙派AIpro快速上手指南》，作者：昇腾CANN。
1 前言
作为业界首款基于昇腾深度研发的AI开发板，Orange Pi AIpro无论在外观上、性能上还是技术服务支持上都非常优秀，其8/20TOPS澎湃算力是目前开发板市场中所具备的最大算力，能覆盖生态开发板者的主流应用场景，让用户实践各种创新场景，并为其提供配套的软硬件。
2 香橙派AIpro硬件准备
香橙派AIpro启动后支持用户通过远程登录模式或者本机显示模式登录开发板推理任务，此处可根据两种模式所需的配件，自行选择其中一种模式准备相关硬件即可。
2.1 远程登录模式
使用RJ45网线连接开发板和PC，启动开发板后，用户在PC通过SSH工具远程登录AIpro开发板。
远程登录模式的配件列表如下：
|
硬件 |
说明 |
示意图 |
|
香橙派AIpro |
开箱后的香橙派AIpro包括主板和电源（包含电源线与电源适配器）。 电源线与电源适配器，出厂为分开状态，需连接使用。 |
|
|
SD卡 |
SD卡用于装载镜像运行开发板。 推荐使用Micro SD卡，容量推荐不小于64GB。 烧录镜像时会格式化SD卡，建议准备一个专门给开发板使用的SD卡。 |
|
|
读卡器 |
需使用支持Micro SD卡的读卡器，用于插入SD卡烧录镜像。读卡器的接口可以根据PC接口配置选择USB或Type-C接口。 |
- |
|
PC（笔记本或台式机） |
用于安装制卡工具、烧录镜像和远程连接开发板。 |
- |
|
连接线： RJ45网线 |
用于PC连接和登录开发板。 用户可以使用RJ45网线（PC需要具备空闲以太网口）连接开发板。 |
RJ45网线：
|
2.2 本机显示模式
使用开发板直连显示器、鼠标、键盘，启动开发板后，用户可直接使用键盘与鼠标在显示的图形化桌面进行操作。
本机显示模式的配件列表如下：
|
硬件 |
说明 |
示意图 |
|
香橙派AIpro |
开箱后的香橙派AIpro包括主板和电源（包含电源线与电源适配器）。 电源线与电源适配器，出厂为分开状态，需连接使用。 |
|
|
SD卡 |
SD卡用于装载镜像运行开发板。 推荐使用Micro SD卡，容量推荐不小于64GB。 烧录镜像时会格式化SD卡，建议准备一个专门给开发板使用的SD卡。 |
|
|
读卡器 |
需使用支持Micro SD卡的读卡器，用于插入SD卡烧录镜像。读卡器的接口可以根据PC接口配置选择USB或Type-C接口。 |
- |
|
PC（笔记本或台式机） |
用于安装制卡工具、烧录镜像和远程连接开发板。 |
- |
|
显示器 |
使用HDMI接口，用于展现开发板镜像中的图形化桌面。 |
- |
|
HDMI连接线 |
双头HDMI线，用于连接显示器。 |
|
|
键盘 |
使用USB接口的键盘，用于图形化桌面的输入操作。 |
|
|
鼠标 |
使用USB接口的鼠标，用于图形化桌面的点击操作。 |
|
|
USB拓展坞（可选） |
如果用户后续需要接入USB接口WiFi，需要再购买一个USB转多口USB扩展坞，鼠标和键盘接入扩展坞，USB接口WiFi接入开发板USB接口。 |
|
3 烧写镜像到SD卡
3.1 下载SD烧录工具及ubuntu镜像
在PC机上，进入香橙派官网，鼠标放置在“服务与下载”菜单，在弹出的菜单中单击“下载”，在下载页面找到“Orange Pi AIpro”，然后单击“Orange Pi AIpro”，进入下载详情页面，分别下载下图中的“官方工具”、“ubuntu镜像”。
官方工具和ubuntu镜像都在百度网盘，分别根据页面提示提取文件，并在以下目录中获取文件后，保存在PC机上：
- 烧录工具balenaEtcher：官方工具>Linux镜像烧录工具-balenaEtcher>Windows_X64版本>balenaEtcher-Setup-1.18.4.exe
- ubuntu镜像：Ubuntu>opiaipro_ubuntu22.04_desktop_aarch64_*.img.xz
3.2 安装烧录工具balenaEtcher
在PC机上，双击balenaEtcher-Setup-1.18.4.exe，按照提示安装即可。
3.3 烧录ubuntu镜像到SD卡中
1、将SD卡插入读卡器，再将读卡器插入PC机。
2、打开烧录工具balenaEtcher，按照工具界面提示，依次“从文件烧录”-》“选择目标磁盘”-》“开始烧录！”
（1）从文件烧录，选择PC机上下载的ubuntu镜像：
（2）选择目标磁盘，选择插到PC机上的SD卡：
（3）开始烧录
4 启动香橙派AIpro系统
对于远程登录、本机显示两种模式，香橙派开发板连线、启动、登录等方式不同，开发者可根据自己准备的配件，选择对应模式的连线、启动、登录方式。
4.1 远程登录模式
1、插入SD卡
将SD卡插入开发板的SD插槽，并确保完全推入插槽底部
2、开发板连线
远程登录模式，通过网线连接，如下图所示：
开发板上电后，LED指示灯绿色常亮，表示启动正常。
3、登录开发板
当开发板通过以太网口和PC连接时，先将PC的IP地址修改为和开发板的IP地址在同一个网段（例如开发板eth1网口为192.168.137.100，PC以太网口为192.168.137.101），再使用SSH工具远程登录开发板。
注意：开发板通过以太网口第一次连接网络时，可以通过HDMI屏幕、串口或查看路由器后台的方式就可以获取以太网口的IP地址，使用该IP地址可远程登录开发板。
（1）修改PC的IP地址，以Windows 10系统为例 。
在PC上打开“开始”，单击“设置”按钮，进入“Windows 设置”界面。
选择“网络和Internet”，单击“更改适配器选项”。
鼠标右键单击“以太网”后鼠标左键单击“属性”进入“以太网 属性”界面（使用以太网口连接时一般为“以太网x”，x为数字，以实际显示的数字为准）。
选择“Internet 协议版本 4（TCP/IPv4）”，单击“属性”。
勾选“使用下面的 IP 地址”选项，填写IP地址（图示以192.168.137.101为例）和子网掩码，默认网关与DNS服务器地址为空，单击“确定”保存。
使用快捷键“Win+R”，在运行窗口输入cmd进入命令行窗口。输入ipconfig命令查询PC网口IP地址是否修改成功。
C:\Users\用户实际信息>ipconfig 以太网适配器 以太网: 连接特定的 DNS 后缀 . . . . . . . : 本地链接 IPv6 地址. . . . . . . . : fe80::ca42:d397:f673:fad4%46 IPv4 地址 . . . . . . . . . . . . : 192.168.137.101 子网掩码 . . . . . . . . . . . . : 255.255.255.0 默认网关. . . . . . . . . . . . . :
（2）使用SSH工具远程登录开发板。
步骤1：获取并安装SSH登录工具
本文以MobaXterm为例，如果用户已部署MobaXterm或其他SSH工具，可不用下载。MobaXterm为第三方工具，下载链接和版本会跟随第三方的发布定期更新，可以在下载页面下载最新版本。
下载MobaXterm后（例如MobaXterm_Personal_22.2.exe ），双击exe程序即可启动MobaXterm。
步骤2：单击MobaXterm界面左上方的“Session”进入界面。
步骤3：单击左上方的“SSH”进入SSH连接配置界面。
步骤4：根据硬件连接方式填写开发板连接PC的接口实际IP地址，勾选“Specify username”选项，填写用户名HwHiAiUser。
步骤5：单击“OK”按钮，首次连接开发板时，SSH工具提示是否信任连接的设备，单击“Accept”。
步骤6：进入远程登录界面后，输入HwHiAiUser用户名登录密码（默认为Mind@123）登录开发板，请修改默认密码，并妥善保管新密码。
4.2 本机显示模式
1、插入SD卡
将SD卡插入开发板的SD插槽，并确保完全推入插槽底部
2、开发板连线
本机显示模式的连线如下：
开发板上电后，LED指示灯绿色常亮，表示启动正常。
3、登录开发板
插上开发板电源后，显示器中的登录界面如下：
输入HwHiAiUser用户名登录密码（默认为Mind@123）登录开发板，进入主界面如下图所示，登录后请修改默认密码，并妥善保管新密码。
在界面下方，单击 
图标，打开终端，如下图所示：
在终端上，可输入Linux命令，例如输入cd命令：
5 运行第一个推理样例：图片分类
1、样例介绍
在终端窗口，执行cd /opt/opi_test/ResnetPicture命令，进入样例目录，该样例是基于PyTorch框架的ResNet50模型，对*.jpg图片分类，并在终端显示该图片的Top5置信度的分类ID、分类名称。
样例代码逻辑如下所示：
（1）数据预处理（解码+缩放），输出YUV420SP格式、224*224分辨率的图片；
（2）色域转换、归一化，输出RGB格式、224*224分辨率的图片；
（3）模型推理，输出该图片所属各分类的置信度；
（4）数据后处理，该图片的Top5置信度的分类ID、分类名称。
2、运行样例
（1）切换到root用户，输入密码，默认密码为Mind@123。
su root
password:
（2）运行样例。
在/opt/opi_test/ResnetPicture样例目录下，执行以下命令运行样例：
cd scripts
bash sample_run.sh
执行成功后，在屏幕上的关键提示信息示例如下，提示信息中的top1-5表示图片置信度的前5种类别、index表示类别标识、value表示该分类的最大置信度，class表示所属类别。
[INFO] top 1: index[162] value[0.905956] class[beagle] [INFO] top 2: index[161] value[0.092549] class[bassetbasset hound] [INFO] top 3: index[166] value[0.000758] class[Walker houndWalker foxhound] [INFO] top 4: index[167] value[0.000559] class[English foxhound] [INFO] top 5: index[163] value[0.000076] class[bloodhound sleuthhound]
6 更多介绍
通过运行第一个样例，我们大致了解了软硬件配合的一个整体流程，接下来若需要详细了解昇腾软件栈的能力、如何基于开发板在昇腾上开发&调优推理应用、如何获取更多的应用样例等，可以参考“香橙派AIpro学习资源一站式导航”一步步学习更多内容
