查看“0021 MPSAI EN”的源代码

== '''关键词''' ==
树莓派5、PCIe、驱动安装、操作演示、2230、2242、2280、NVMe SSD、固态硬盘 X1、AI、HAILO 8L、摄像头、OV5647、图像检测、图像识别

== '''一、简介''' ==

== '''二、硬件资源''' ==
1. 基于树莓派5设计，采用16Pin FPC和树莓派5的PCle接口连接；

2. 扩展板通过PCIe Switch进行一扩二；

3. 一路PCIe扩展M.2 M-key接口，2242尺寸，用于接AI模块 HAilo8，树莓派官方OS加载驱动；

4. 一路PCIe扩展M.2 M-key接口，接NVMe SSD（PCIe X1，仅支持Gen2模式），支持2230/2242/2280尺寸（默认焊接2280铜柱）,不支持SATA和NGFF SSD硬盘；

5. SSD可用于存储数据和系统启动；从SSD启动时，需树莓派官方固件是2024.5.13以后的版本；

6. 40Pin GPIO部分采用开窗设计，可通过杜邦线连接，不影响树莓派5自身GPIO引脚使用；

7. PCB板沉金工艺，无铅生产，且通过UL认证，符合ROHS标准，防火等级94V-0；

8. 采用4个M2.5固定孔，和树莓派5定位孔吻合;

9. 可选配铝合金外壳。

http://www.mcuzone.com/wiki/0021_MPSAI/0021_MPSAI_01.jpg

== '''三、系统烧写及设置''' ==

=== 3.1 概述 ===
本文档采用树莓派OS、Ubuntu系统和OpenWrt系统进行测试。

1) 树莓派OS的版本为2024-07-04-raspios-bookworm-arm64.img.xz，树莓派OS下载地址：

https://www.raspberrypi.com/software/operating-systems/#raspberry-pi-os-64-bit

2) Ubuntu系统的版本为ubuntu-24.04-preinstalled-desktop-arm64+raspi.img.xz，Ubuntu OS下载地址：

https://ubuntu.com/download/raspberry-pi

3) OpenWrt系统版本：

openwrt-bcm27xx-bcm2712-rpi-5-squashfs-sysupgrade-linux-6.1.100-20240805.img.gz

=== 3.2 系统烧写在SD（TF）卡上 ===
[[0005 MPS2242 2280 2280P（单SSD扩展板）#3.2 从TF卡启动|点击直达烧写方法说明]]。

=== 3.3 系统烧写在SSD硬盘上 ===
[[0005 MPS2242 2280 2280P（单SSD扩展板）#3.3 从SSD硬盘启动|点击直达烧写方法说明]]。

== '''四、树莓派OS下的AI(HAILO 8L)使用演示''' ==

=== 4.1 概述 ===
In various practical applications, the demand for camera image detection and recognition is gradually increasing, and there are many AI-based solutions available on the market. The solution demonstrated in this article involves the OV5647 camera, the MPSAI, and the HAILO 8L AI module paired with the Raspberry Pi 5.

http://www.mcuzone.com/wiki/0021_MPSAI/0021_MPSAI_02.jpg

'''''Note: The operation requires a stable internet connection to the regions out of China (you may need to find your own method). Otherwise, many files may not download or may only partially download, which could ultimately lead to the code failing to run.'''''

=== 4.2 Update system ===

'''''Note: The following operational steps apply whether the system is booted from a TF card or an SSD.'''''

4.2.1 Boot the Raspberry Pi OS and run commands in the terminal:

<code>sudo apt update</code>

<code>sudo apt full-upgrade</code>

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_28.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_29.jpg

4.2.2 执行<code>sudo rpi-eeprom-update</code>，查看树莓派固件，确保树莓派的固件日期在2023年12月6日之后：

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_30.jpg

如上图所示，固件时间是2024年6月5日。

4.2.3 执行<code>sudo raspi-config</code>，根据下图依次选择对应选项：

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_31.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_32.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_33.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_34.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_35.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_36.jpg

选择完之后退出，系统会自动重启，如果没有自动重启，请手动执行 <code>sudo reboot</code> ，重启系统。

=== 4.3 AI模块所需要的依赖安装 ===
执行<code>sudo apt install hailo-all</code>，安装AI模块所需要的依赖安装：

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_37.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_38.jpg

完成后执行 <code>sudo reboot</code> ，重启系统，使这些设置生效。

执行<code>hailortcli fw-control identify</code>，如果出现以下输出则成功安装了HAILO 8L的依赖：

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_39.jpg

最后再执行<code>rpicam-hello -t 10s</code>，打开摄像头并出现预览窗口，确定摄像头正常。

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_40.jpg

=== 4.4 图像识别检测 ===
执行：

<code>git clone --depth 1 <nowiki>https://github.com/raspberrypi/rpicam-apps.git</nowiki> ~/rpicam-apps</code>

克隆rpicam-apps库：

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_41.jpg

克隆完成后，就可以开始进行图像的识别检测：

<code>rpicam-hello -t 0 --post-process-file ~/rpicam-apps/assets/hailo_yolov6_inference.json --lores-width 640 --lores-height 640</code>

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_42.jpg

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_43.jpg

'''<big>鉴于本开发板的测试需要在外网下载大量数据，为了方便用户进行测试，用户在购买本开发板后，可以联系我司获取已经配置完毕的树莓派OS镜像。</big>'''

== '''五、树莓派系统下使用SSD硬盘''' ==
关于对SSD硬盘的基本操作，我们可以参考以下链接：

[[0005 MPS2242 2280 2280P（单SSD扩展板）#4.1 SSD用作存储扩展|SSD用作存储扩展（树莓派OS下）]]

[[0005 MPS2242 2280 2280P（单SSD扩展板）#六、对SSD进行分区等操作|对SSD进行分区等操作]]

[[0005 MPS2242 2280 2280P（单SSD扩展板）#cite ref-1|调整外设启动顺序]]

[[0005 MPS2242 2280 2280P（单SSD扩展板）#7.2 在PCIe Gen2下测试硬盘速度|安装硬盘测速软件hdparm]]

关于如何测试SSD硬盘，我们可以参考以下链接：

[[0008 MPS2.5G（SSD和2.5G以太网）#4.2 SSD硬盘测试|SSD硬盘测试（树莓派OS下）]]

== '''六、Ubuntu系统下使用SSD硬盘''' ==
关于对SSD硬盘的基本操作，我们可以参考以下链接，除了SSD用作存储扩展中与树莓派OS下操作略有不同，其余部分基本相同：

[[0005 MPS2242 2280 2280P（单SSD扩展板）#5.1 SSD用作存储扩展|SSD用作存储扩展（Ubuntu系统下）]]

[[0005 MPS2242 2280 2280P（单SSD扩展板）#六、对SSD进行分区等操作|对SSD进行分区等操作]]

[[0005 MPS2242 2280 2280P（单SSD扩展板）#cite ref-1|调整外设启动顺序]]

[[0005 MPS2242 2280 2280P（单SSD扩展板）#7.2 在PCIe Gen2下测试硬盘速度|安装硬盘测速软件hdparm]]

关于如何测试SSD硬盘，我们可以参考以下链接：

[[0008 MPS2.5G（SSD和2.5G以太网）#5.2 SSD硬盘测试|SSD硬盘测试（Ubuntu系统下）]]

== '''七、OpenWrt系统下使用SSD硬盘''' ==
关于如何在OpenWrt系统下使用SSD硬盘，我们可以参考以下链接：

[[2001 CM4 Ultra（CM4核心板的扩展板）#5.5 SSD硬盘测试|SSD硬盘测试（OpenWrt系统下）]]

{{联系我们_图标}}