查看“0021 MPSAI EN”的源代码

== '''Keywords''' ==
Raspberry Pi 5, PCIe, Driver installation, Operation demonstration, 2230, 2242, 2280, NVMe SSD, SSD X1, AI, HAILO 8L, Camera, OV5647, Image Recognition, Optional auxiliary power supply

== '''I. Introduction''' ==

== '''II. Hardware Resources''' ==
1. Designed for the Raspberry Pi 5, it uses a 16-pin FPC to connect to the Raspberry Pi 5's PCIe interface.

2. The MPSTPU expansion board adds two PCIe interfaces via a PCIe Switch.

3. One PCIe extension M.2 E key interface, 2242 size, used for connecting the AI module HAilo8，with the official Raspberry Pi OS loading the driver.

4. One PCIe expanded M.2 M key slot, for connecting NVMe SSD (PCIe X1, Gen2 mode only). Supports 2230/2242/2280 size SSDs (defaulting to welded mounting posts for 2280 size). It does not support SSDs that use NGFF and SATA protocols.

5. The SSD can be used for data storage and system booting. When booting from the SSD, the Raspberry Pi official firmware needs to be version 2024.5.13 or later.

6. The 40-pin GPIO section adopts an unobstructed design on the top. It can be connected via DuPont cable, without affecting the use of the Raspberry Pi 5's own GPIO pins.

7. Gold immersion PCB process, lead-free production, certified by UL, compliant with ROHS standards, and has a fire rating of 94V-0.

8. It uses four M2.5 mounting holes that align with the Raspberry Pi 5 mounting holes.

9. It is compatible with an optional aluminum alloy enclosure.

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

== '''III. System flashing and setting''' ==

=== 3.1 Overview ===
This document uses the Raspberry Pi OS, Ubuntu system and OpenWrt system for testing.

The version of the Raspberry Pi OS is: 2024-07-04-raspios-bookworm-arm64.img.xz

You can download the Raspberry Pi OS in:

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

The version of the Ubuntu system is: ubuntu-24.04-preinstalled-desktop-arm64+raspi.img.xz

You can download the Ubuntu system in:

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

The version of the OpenWrt system is: openwrt-bcm27xx-bcm2712-rpi-5-squashfs-sysupgrade-linux-6.1.100-20240805.img.gz

=== 3.2 System flashed onto the SD (TF) card ===
[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#3.2 Boot from TF card|Click here to read the instructions for System flashing]]

=== 3.3 系统烧写在SSD硬盘上 ===
[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#3.3 Boot from SSD|Click here to read the instructions for System flashing]]

== '''IV. AI (HAILO 8L) usage Demonstration on the Raspberry Pi OS''' ==

=== 4.1 Overview ===
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 Run <code>sudo rpi-eeprom-update</code>to check the Raspberry Pi firmware and ensure that the firmware date is after December 6, 2023:

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

As shown in the above figure, the firmware date is June 5, 2024.

4.2.3 Run <code>sudo raspi-config</code> ,select the corresponding options in sequence according to the following diagram:

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

After making your selection and exiting, the system will automatically restart. If it does not restart automatically, please manually execute <code>sudo reboot</code> to restart the system.

=== 4.3 Install the depends required for the AI module ===
Run <code>sudo apt install hailo-all</code>, install the depends required for the AI module:

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

After completing this, execute <code>sudo reboot</code> to restart the system and apply these settings.

Run <code>hailortcli fw-control identify</code>, If the following output appears, it indicates that the depends for HAILO 8L have been successfully installed:

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

Finally, execute <code>rpicam-hello -t 10s</code> to turn on the camera and bring up the preview window, ensuring that the camera is functioning normally.

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

=== 4.4 Image recognition and detection ===
Run:

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

Clone the library of rpicam-apps:

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

After cloning is completed, you can begin image recognition and detection:

<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>You should downloading a large amount of data from the internet out of China to use the testing of this development board, so users can contact our company after buying this development board to obtain a pre-configured Raspberry Pi OS image.</big>'''

== '''V. Using SSD in the Raspberry Pi OS''' ==
For basic operations on the SSD, we can refer to the following link:

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#4.1 Use the SSD for storage expansion|Use the SSD for storage expansion (Raspberry Pi OS)]]

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#VI. Perform partitioning and other operations on the SSD|Perform partitioning and other operations on the SSD]]

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#cite ref-1|Adjust the peripheral boot order]]

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#7.2 Test the SSD speed in PCIe Gen2 mode|Install the SSD speed testing software hdparm]]

For how to test the SSD, we can refer to the following link:

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

== '''VI. Using SSD in the Ubuntu system''' ==
For basic operations on the SSD, we can refer to the following link, apart from the SSD being used for storage expansion, which operates slightly differently under Raspberry Pi OS, the rest is basically the same.

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#5.1 Use the SSD for storage expansion|Use the SSD for storage expansion(Ubuntu system)]]

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#VI. Perform partitioning and other operations on the SSD|Perform partitioning and other operations on the SSD]]

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#cite ref-1|Adjust the peripheral boot order]]

[[0005 MPS2242 2280 2280P(Single SSD Expansion Board)#7.2 Test the SSD speed in PCIe Gen2 mode|Install the SSD speed testing software hdparm]]

For how to test the SSD, we can refer to the following link:

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

== '''VII. Using SSD in the OpenWrt system''' ==
For how to use the SSD in the OpenWrt system, we can refer to the following link:

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

{{Contact_Us_icon}}