查看“2001 RPi CM4 Ultra EN”的源代码

[[2001 RPi CM4 Ultra|切换语言为中文]]

== '''Keywords''' ==
Raspberry, CM4 Core board, 2.5G Ethernet, NVME SSD, WiFi6, 5G, RPiOS, eMMC, OpenWrt, Video Capture

== '''I. Introduction''' ==
The CM4_Ultra expansion board is an expansion board designed based on the Raspberry Pi CM4 core board. It expands the single PCIe interface of the CM4 into four PCIe interfaces using a switch chip. The CM4_Ultra expansion board features one PCIe M.2 M-KEY interface for connecting an NVMe SSD, one PCIe 2.5G Ethernet port, one PCIe M.2 A-KEY interface for connecting WiFi 6, and one PCIe expansion for USB 3.0. Additionally, one of the USB 3.0 ports is connected to an M.2 B-KEY interface for external 5G expansion. The expansion board supports all versions of the Raspberry Pi CM4 core board. The expansion board is ideally suited for a variety of applications requiring high-speed data acquisition, processing, and communication, such as WiFi 6 testing terminals, remote image and video capture systems, live streaming, vehicle infotainment systems, TBOX-like vehicle data access devices, integrated media players, facial recognition, soft routers, gateways, remote image transmission, edge computing, and more.

== '''II. Hardware Spec''' ==
{| class="wikitable"
|+
|Power Supply
|1*DC input, wide voltage range of 7-24V, DC5.5-2.1 connector.
1*USB-C 5V3A port, supports PD charger; two power sources cannot be used simultaneously.
|-
|Nerwork
|1*native Gigabit Ethernet port.
1*PCIe 2.5G Ethernet port (RTL8125 chip).

1*PCIe M.2 A-KEY interface for expanding WiFi 6.

1*USB 3.0 M.2 B-KEY interface for connecting 5G, with a Nano SIM card slot and onboard 4 SMA antenna connectors.
|-
|Storage
|1*PCIe M.2 M-KEY slot, supporting 2280-sized NVMe SSD, does not support SATA/GNFF drives.
1*TF card slot, used for booting the system with the lite version of the Raspberry Pi CM4 core board; if using the CM4 core board with eMMC, this TF card slot will be unavailable.
|-
|USB Ports
|2*USB 3.0-A host ports.
1*USB 2.0 port, 1.25mm-4P.

1*USB OTG port (USB-A), also the programming port for the eMMC core board.
|-
|Display
|1*standard HDMI port supporting 4K resolution.
1*DSI1 (22PIN, 0.5mm, flip-down connection).
|-
|Camera
|2*CSI1(22PIN, 0.5mm, flip-down connection).
|-
|Others
|2*fan power supplies, 2.54mm-2P, 5V and 3.3V.
1*boot jumper, 2.54mm-2P, for flashing the eMMC core board.

40PIN GPIO, 2.54mm 20*2, fully compatible with the GPIO pins of Raspberry Pi 4B.
|-
|Size
|111*135mm, immersion gold process, lead-free production, PCB board certified by UL and ROHS, flame retardant rating 94V-0.
Optional aluminum alloy case with 4 fixing holes for easy equipment installation, case size: 114*154*31mm.
|}
:::

The pin definitions for the 40-pin connector, from left to right:
{| class="wikitable"
|5V
|5V
|GND
|G14
|G15
|G18
|GND
|G23
|G24
|GND
|G25
|G08
|G07
|IDSC
|GND
|G12
|GND
|G16
|G20
|G21
|-
|3V3
|G02
|G03
|G04
|GND
|G17
|G27
|G22
|3V3
|G10
|G09
|G11
|GND
|IDSD
|G05
|G06
|G13
|G19
|G26
|GND
|}
http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_114.jpg

== '''III. System flashing''' ==
Raspberry Pi OS: 2024-07-04-raspios-bookworm-arm64.img.xz

You can download it in:

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

=== 3.1 Boot from TF card ===
If the Raspberry Pi CM4 core board does not have eMMC, the system will boot from the TF card.

[[0005 MPS2242 2280 2280P EN#III. System flashing and setting|Click here to the burning method instructions]]

=== 3.2 Boot from eMMC ===
If the Raspberry Pi CM4 core board has onboard eMMC, it can only boot from the eMMC, and the onboard TF card will be ineffective.

First, you need to install the driver package for the Raspberry Pi CM4 core board on your PC. You can download it from the official Raspberry Pi website or from our company's website:

http://www.mcuzone.com/down/Software.asp?ID=10000623

Then, use a jumper cap to short the BOOT pin and the GND pin, and connect the USB 2.0 OTG interface on the expansion board to the computer using a USB Type-A cable (as shown in the figure below):

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_117.jpg

After connecting to the computer, open the Device Manager, and a new USB device will appear. In the image below, the USB device is named "BCM2711 Boot".

http://www.mcuzone.com/wiki/2007_CM4_LoRa_4G/2007_CM4_LoRa_4G_63.jpg

Under the All Programs section of the PC's Start menu, there is an rpiboot under Raspberry Pi.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_66.jpg

Open this software, and the computer will format and partition the eMMC or TF card.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_68.jpg

Wait a moment, and a partition will appear in the file explorer (in this example, the partition is named bootfs, but the actual name may var

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_67.jpg

Next, we can use the balenaEtcher to flash the image to this partition.

Please open the balenaEtcher software, click on the first option "Flash from file," and select the file you want to flash to the eMMC. For the second option, choose the bootfs partition mentioned above, then click "Flash now" to start the flashing process.

http://www.mcuzone.com/wiki/2007_CM4_LoRa_4G/2007_CM4_LoRa_4G_61.jpg

http://www.mcuzone.com/wiki/2007_CM4_LoRa_4G/2007_CM4_LoRa_4G_62.jpg

After the burning process is completed, we need to remove the previously inserted short-circuit cap (otherwise the core board will not start properly), then power it on again to boot the system.

== '''IV. Work with Raspberry Pi OS''' ==

=== 4.1 Ethernet test ===

==== 4.1.1 Ethernet connection ====
Connect the gigabit Ethernet port to the upstream router, and execute <code>ifconfig -a</code> on the terminal, which displays the following:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_136.jpg

eth0 is a native Gigabit network card and has obtained an IP address.

eth1 is an extended 2.5G network card, but since no network cable is plugged in, it has not acquired an IP address.

==== 4.1.2 2.5G Ethernet speed test ====
We plug the Ethernet cable into the 2.5G port, and the system will automatically obtain an IP address. Then, we open the terminal and install the speed-testing tool iperf3.

<code>sudo apt-get install iperf3</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_01.jpg

2.5G Ethernet speed test results: 

2.15Gbps (client mode).

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_02.jpg

1.75Gbps (server mode).

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_03.jpg" width=640></html>

'''''Note: The speed test results of 2.5G networks are affected by network conditions and testing methods. The actual speed may vary, and this test is for reference only.'''''

==== 4.1.3 Gigabit Ethernet speed test ====
We plug the network cable into the native Gigabit Ethernet port, and the system will automatically obtain an IP address. Then, we open the terminal and test using iperf3.

Native Gigabit Ethernet speed test results: 

940Mb/s (client mode).

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_04.jpg

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_05.jpg" width=640></html>

'''''Note: The speed test results of 2.5G networks are affected by network conditions and testing methods. The actual speed may vary, and this test is for reference only.'''''

=== 4.2 SSD test ===

==== 4.2.1 Basic operations of SSD drives ====
NVMe SSDs are for data storage only and cannot be used as a system boot drive.

In Raspberry Pi OS, when you open the File Manager, you can see the partitions of the SSD. The screenshot is shown below:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_06.jpg

To operate the SSD, click the partition icon, enter the system password, and then click "Authenticate". After successful authorization, you can perform operations on the SSD.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_07.jpg

Now, when you return to the desktop, you will see the shortcut icon for the SSD partition.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_08.jpg

You can also enter <code>df</code> in the terminal to see the SSD partition and its mounting information. We can use this SSD as a storage device.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_09.jpg

If you need to perform operations such as partitioning and permanently mounting an SSD, please refer to [[0005 MPS2242 2280 2280P EN#VI. Perform partitioning and other operations on the SSD|this page]].

==== 4.2.2 SSD speed test ====
<!--
为了操作方便，我们通过SSH连接来测速，本文档使用MobaXterm软件，支持文件传输，MobaXterm软件下载地址：

https://mobaxterm.mobatek.net/download-home-edition.html

===== 4.2.2.1 设置SSH =====
在树莓派OS中开启SSH连接，首先从Preferences菜单中打开Raspberry Pi Configuration窗口：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_10.jpg

然后单击Interfaces选项卡，选择SSH行旁边的Enable，再点击OK即可：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_11.jpg

接下来打开MobaXterm软件，新建一个连接，选择SSH，Remote Host填入树莓派OS的IP，Specify username填入登录账号，如下图所示：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_12.jpg

登录完成后，我们在左侧点击SSH Browser，进入SSH浏览器：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_13.jpg

===== 4.2.2.2 2.5G以太网对SSD读写 =====
在SSH浏览器里，我们进入SSD硬盘的挂载文件夹，本文所示例子为：

<code>/media/mcuzone/00009305000DEDEE/</code>

在此文件夹下，将PC上的文件拖入SSH浏览器窗口，以及将SSH浏览器窗口内的文件拖到PC上，测试硬盘的读写速度。

写入速度140Mbps左右：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_14.jpg

读取速度60Mbps左右：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_15.jpg

'''''注意：SSD硬盘读写速度测试受网络环境和硬盘性能影响，速度请以实际为准，本测试仅供参考。'''''

===== 4.2.2.3 千兆网口对SSD读写 =====
-->

===== 4.2.2.1 SSD interface speed test =====
We use the hdparm to test the SSD drive interface speed.

Install the hdparm software:

<code>sudo apt install hdparm</code>

Run the command multiple times to test the SSD speed repeatedly.

<code>sudo hdparm -t /dev/nvme0n1</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_122.jpg

The test result shows that the SSD's interface speed is around 360MB/s.

===== 4.2.2.2 Install the SAMBA file sharing service =====
SAMBA is a software for sharing files between Windows and Linux. We can use it to transfer files between Windows and Raspberry Pi via Ethernet, which allows us to test network speed.

Install SAMBA:

<code>sudo apt install samba</code>

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_22.jpg

Create a new folder under the SSD path for sharing files and modify the folder permissions.

<code>cd /media/mcuzone/writable</code>

<code>sudo mkdir ssdfiles</code>

<code>sudo chmod +777 ssdfiles</code>

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_23.jpg

Modify the SAMBA configuration file to add a shared node.

<code>sudo mousepad /etc/samba/smb.conf</code>

Add the shared node at the end of the file:

<code>[ssd]</code>

<code># Shared folder instruction</code>

<code>comment = ssd</code>

<code># Shared Folder Directory</code>

<code>path = /media/mcuzone/writable/ssdfiles/</code>

<code># Mount path of the shared directory that needs to be mapped</code>

<code>browseable = yes</code>

<code># Resource name publicly visible (content hidden, set to 'Yes')"</code>

<code>writable = yes</code>

<code># Writable</code>

<code>create mask = 0777</code>

<code># New files are created with 777 permissions.</code>

<code>directory mask = 0777</code>

<code># New files are created with 777 permissions.</code>

<code>public = no</code>

<code># Guest access without a password (set to "No" here)</code>

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_24.jpg

'''''Note: If you need to add more mapped folders, please continue adding new shared nodes in the same format, ensuring that the shared folder description and shared folder directory are not duplicated. The local path should be filled in according to the mounted path.'''''

Create a user named mcuzone1; you will be prompted to set a password afterward.

<code>sudo smbpasswd -a mcuzone</code>

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_25.jpg

Restart SAMBA:

<code>sudo systemctl restart smbd</code>

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_26.jpg

Then, map a network drive in Windows, using Windows 11 as an example here.

Open "This PC", then click "Map network drive".

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_27.jpg

Fill in the relevant node information according to the diagram below (the IP is the Raspberry Pi OS IP):

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_28.jpg

Enter the username and password you just set:

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_29.jpg

Then, the shared folder that was set up was opened.

http://www.mcuzone.com/wiki/2005_CM4_NAS/2005_CM4_NAS_32.jpg

'''''Note: Before setting up a shared folder, you must grant permission to the SSD partition in the Raspberry Pi OS. Otherwise, you will encounter a "network name not found" error when configuring the shared folder.'''''

===== 4.2.2.3 SSD R/W testing over a Gigabit Ethernet port =====

Connect the network cable to the Gigabit Ethernet port, then conduct R/W speed tests on the SSD drive via the SAMBA file sharing service.

Write:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_124.jpg

Read:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_125.jpg

===== 4.2.2.4 SSD R/W testing over a 2.5G Ethernet port =====

Connect the network cable to the 2.5G Ethernet port, then conduct R/W speed tests on the SSD drive via the SAMBA file sharing service.

Write:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_126.jpg

Read:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_127.jpg

'''''Note: The speed of the SSD drive test is influenced by various factors such as network conditions, hard drive quality, file storage status, and OS environment. The above test results are for reference only and should not be considered as the final parameters of the actual product. In practical tests, the read speed can reach up to 270MB/s.'''''

=== 4.3 DSI test ===
The official Gen 1 Raspberry Pi LCD screen needs separate power and requires an adapter board and DSI-compatible expansion board.

After connecting, power on the board. Wait for the OS to run, then open the terminal and execute the following commands

<code>sudo nano /boot/firmware/config.txt</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_16.jpg

Add the following statements at the end of the file:

<code>dtoverlay=vc4-kms-dsi-7inch</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_17.jpg

After saving, restart the OS to use the official Raspberry Pi 7-inch touchscreen.

Upon restart, execute the following commands in the terminal in order.

<code>wget <nowiki>http://www.mcuzone.com/wiki/2001_CM4_Ultra/Brightness.zip</nowiki></code>

<code>unzip Brightness.zip</code>

<code>cd Brightness</code>

<code>sudo chmod +x install.sh</code>

<code>./install.sh</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_18.jpg

Then you can open the Brightness window from the Accessories menu to adjust the backlight of the 7-inch screen.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_19.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_20.jpg

=== 4.4 CSI test ===
We tested using the OV5467 camera, connecting it to either the CSI0 or CSI1 interface. After connecting, power on the board, open the terminal, and execute the following commands:

<code>sudo nano /boot/firmware/config.txt</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_16.jpg

Add the following statements at the end of the file:

<code>dtoverlay=ov5647,cam0</code>

<code>dtoverlay=ov5647,cam1</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_21.jpg

In actual use, add the configuration according to your model, save the changes, and then restart the system to enable the OV5647 camera.

After rebooting, execute the following command in the terminal:

<code>ls /dev</code>

You can then see the video0 and video1 devices (inserting one camera displays video0, inserting two cameras displays video0 and video1, regardless of whether they are connected to CSI0 or CSI1).

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_22.jpg

To preview the camera feed, execute <code>libcamera-hello --camera 0</code> or <code>libcamera-hello --camera 1</code> in the terminal (a single connected camera is <code>camera 0</code>, while two cameras are assigned as <code>camera 0</code> and <code>camera 1</code>).

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_23.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_24.jpg

If a photo is required, please execute:

<code>libcamera-jpeg -o test.jpg</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_25.jpg

Save the photo in the <code>/home/mcuzone</code> directory (i.e., the user's home directory). The photo effect is as follows:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_26.jpg

=== 4.5 USB test ===
After the system boots up, we plug the wireless keyboard and mouse into the OTG interface, insert two USB 3.0 SD card readers into the USB 3.0 ports, and enter <code>lsusb</code> to check the USB devices.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_115.jpg

Bus 002 Device 003: USB3.0-A, USB3.0 SD card reader.

Bus 002 Device 004: USB3.0-A, USB3.0 SD card reader.

Bus 003 Device 002: USB2.0-A (OTG) interface, wireless keyboard and mouse.

Verify that all identifications are normal; then run <code>lsusb -t</code> to check the USB ports' operating mode.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_116.jpg

Bus 02: 5000M USB interface (USB 3.0).

Bus 03: 480M USB interface (USB 2.0).

All operating modes are functioning normally.

=== 4.6 5G module test ===
Testing based on the Quectel 5G module RM500U-CN. '''The 5G module is now configured, working plug-and-play with the official Raspberry Pi OS.'''

'''''(If the user has their own 5G module, they need to configure it themselves or integrate the driver, otherwise plug-and-play will not be possible, and this section cannot be referenced.)'''''

==== 4.6.1 5G test ====
In the terminal, execute the command <code>ifconfig -a</code>, and you can see the following network information:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_137.jpg

From the figure above, it can be seen that both the Gigabit Ethernet card and the 5G module have obtained IP addresses, and we have successfully pinged the website.

<html><img src="http://www.mcuzone.com/wiki/0024_MP4GUSB/0024_MP4GUSB_02.jpg" width=640></html>

But if you disconnect the network cable, then pinging the IP succeeds, while pinging the domain name fails, as shown in the figure below:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_119.jpg

Therefore, it is necessary to check whether the OS's nameserver (i.e., the DNS server) is correct. Use the following command to open the resolv.conf file:

<code>sudo nano /etc/resolv.conf</code>

http://www.mcuzone.com/wiki/0007_Zero_4G_Cat1/0007_Zero_4G_Cat1_16.jpg

http://www.mcuzone.com/wiki/0007_Zero_4G_Cat1/0007_Zero_4G_Cat1_17.jpg

Please check if the current nameserver is correct. If not, change it to the SIM card's nameserver (usually its gateway address) or some common nameserver addresses (such as 114.114.114.114, etc.).

However, after a system reboot, the DNS entries in the resolv.conf file will revert to the default addresses. Therefore, if you need to enable 5G internet access automatically on startup, you will also need to modify the permissions of the resolv.conf file. Since /etc/resolv.conf is actually a soft link, you must recreate the resolv.conf file to change its permissions. The method is as follows:

<code>sudo mv /etc/resolv.conf /etc/resolv.conf.link</code>

<code>sudo nano /etc/resolv.conf</code>

This recreates the resolv.conf file. Add the following content to the new file:

<code>nameserver 114.114.114.114</code>

Save and exit, then execute:

<code>sudo chattr +i /etc/resolv.conf</code>

After performing the above steps, the resolv.conf file will remain unchanged even after a system restart.

==== 4.6.2 Modification of Network Priority ====
When both Ethernet and 5G are connected, the default preference is to use the 5G network for internet access.

Execute the <code>route</code> command to view the routing table. Since usb0 is listed first, the internet connection is currently through the 5G module.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_129.jpg

If you want to prioritize the wired network for internet access, you can execute the following command:

<code>sudo ip route del default && sudo route add -net default netmask 0.0.0.0 gw 192.168.8.1</code>

Explanation of these two commands (separated by '&&'):

<code>sudo ip route del default</code>: Remove the default route from the routing table.

<code>sudo route add -net default netmask 0.0.0.0 gw 192.168.8.1</code>: Add the gateway of the wired network as a new default route (ensure to use the actual gateway address).

After the execution is completed, execute the <code>route</code> command to view the routing table. The current default route is the gateway of the wired network (eth0 ranks first):

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_130.jpg

This way, the network will default to using the wired connection. If you need to switch back to defaulting to the 5G network, please execute the following command:

<code>sudo ip route del default && sudo route add -net default netmask 0.0.0.0 gw 192.168.42.1</code>

Or, you can reboot the system.

Note that 192.168.42.1 is the default gateway for the 5G module; please refer to the actual configuration.

'''''Note: After a reboot, the routing table resets. To ensure the network continues to use the wired or wireless connection as the default route post-restart, you'll need to execute <code>sudo ip route del default && sudo route add -net default netmask 0.0.0.0 gw 192.168.8.1</code> again.'''''

==== 4.6.3 5G network speed test ====
We unplugged the network cable, leaving only the 5G network connection, and then entered the [https://www.speedtest.cn/ speed test website] to conduct a speed test.

The results are as follows:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_131.jpg

'''''Note: The 5G module network speed test is affected by 5G signal and testing methods. The actual speed may vary, and this test is for reference only.'''''

==== 4.6.4 AT command operation ====
Connect the 5G module to the expansion board. After the system starts, we enter <code>lsusb</code>, and the display is as follows:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_47.jpg

Note down the ID value of the 5G module: 2c7c 0900。

Download minicom:

<code>sudo apt-get install minicom</code>

http://www.mcuzone.com/wiki/0007_Zero_4G_Cat1/0007_Zero_4G_Cat1_13.jpg

Use the following command to enable the ttyUSB serial port of the 5G module, where the value after echo is the ID value recorded earlier:

<code>sudo modprobe option</code>

<code>sudo sh -c 'echo 2c7c 0900 > /sys/bus/usb-serial/drivers/option1/new_id'</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_48.jpg

After executing the above two commands, execute the following:

<code>sudo minicom -D /dev/ttyUSB2</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_49.jpg

After entering minicom, we input AT commands for testing:

If you need to check the echo, type the command: <code>ate1</code>, then press Enter. Continue typing other commands and press Enter to see the results.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_120.jpg

Common AT commands:

1) Check if the SIM card is detected:

<code>at+cpin?</code>

If '''ready''' is returned, the card is recognized; if '''error''' is returned, check the hardware.

2) Check antenna signal quality:

<code>at+CESQ</code>

3) Check network registration status:

<code>at+cops?</code>

Normally, it should return the network supporter's code: 7, where 7 represents 4G, and where 11 represents 5G.

Note: The above command <code>at+CESQ</code> should not include a question mark, while the other two commands require a question mark.

4) View the SIM card's IMEI code:

<code>at+cgsn</code>

5) Disable radio frequency:

<code>at+cfun=0</code>

Enable radio frequency:

<code>at+cfun=1</code>

The two commands mentioned above can be used in pairs to allow the module to re-register with the network without restarting the 5G module.

6) Switch SIM card

Use SIM1 (silkscreen marking):

<code>AT+QUIMSLOT=1</code>

Use SIM2 (silkscreen marking):

<code>AT+QUIMSLOT=2</code>

When switching slots, if the original slot has a card, Windows will prompt for ejection. Power off the module, move the card to the other slot, and restart. If the target slot already contains a card, it will work directly.

7) The USB port and Ethernet port cannot be used simultaneously, and can be switched via AT commands:

Use USB port:

<code>AT+QMAPWAC=0</code>

Use Ethernet port:

<code>AT+QMAPWAC=1</code>

=== 4.7 WiFi6 test ===
The CM4_Ultra expansion board supports WiFi 6 (AX200) and WiFi 6E (AX210) modules, both of which require driver installation to function. The steps for installing the drivers are as follows:

==== 4.7.1 Install driver ====
First, update the system and header files. Open the terminal and execute <code>sudo apt-get update</code> to update the system:

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_29.jpg" width=660></html>

Then input: <code>sudo apt-get upgrade</code>

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_30.jpg" width=660></html>

Finally, execute <code>sudo apt-get install raspberrypi-kernel-headers</code> to install the header files.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_31.jpg

Download the WiFi driver source code to your local machine:

<code>git clone <nowiki>https://git.kernel.org/pub/scm/linux/kernel/git/iwlwifi/backport-iwlwifi.git</nowiki></code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_32.jpg

After downloading, <code>cd backport-iwlwifi</code> to enter the source directory, then run <code>make defconfig-iwlwifi-public</code> to output the <code>.config</code> file.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_33.jpg

Execute:

<code>sed -i 's/CPTCFG_IWLMVM_VENDOR_CMDS=y/<nowiki>#</nowiki> CPTCFG_IWLMVM_VENDOR_CMDS is not set/' .config</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_34.jpg

Execute <code>make -j4</code>, where <code>-j4</code> indicates compiling with four cores. If the system freezes or gets stuck, you can try compiling with <code>-j1</code> or <code>-j2</code>.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_35.jpg

After compiling, execute <code>sudo make install</code> to install the driver:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_36.jpg

After the installation is complete, you will be prompted to restart. Please do not restart yet.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_45.jpg

==== 4.7.2 Install firmware ====
Different modules have different firmware, and the one we use here is the AX210.

Execute the following commands in the terminal one by one:

<code>cd ..</code>

<code>cd Downloads</code>

<code>wget <nowiki>http://www.mcuzone.com/wiki/2001_CM4_Ultra/iwlwifi-ty-a0-gf-a0-59.zip</nowiki></code>

<code>unzip iwlwifi-ty-a0-gf-a0-59.zip</code>

<code>sudo cp iwlwifi-ty-a0-gf-a0-59.ucode /lib/firmware</code>

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_37.jpg

Then enter `cd /lib/firmware`, followed by `ls /lib/firmware iwl*.*`. If the file `iwlwifi-ty-a0-gf-a0-59.ucode` is listed, it indicates that the firmware has been successfully installed.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_38.jpg

==== 4.7.3 Test WiFi6 module ====
After the firmware installation is complete, restart the system, click the network icon in the upper right corner of the desktop, and then click "Click here to set Wi-Fi country".

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_39.jpg

We select CN:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_40.jpg

Restart the system again, then manually connect to the WiFi in the upper right corner of the desktop and enter the password:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_41.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_42.jpg

Once WiFi is connected successfully, view the network parameters:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_43.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_44.jpg

Executing <code>ifconfig -a</code> in the terminal can also display network parameters (wlan0).

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_46.jpg

== '''V. Work with OpenWrt''' ==
The OpenWrt version we used for testing is: openwrt-bcm27xx-bcm2711-rpi-4-squashfs-sysupgrade-linux-6.1.98-20240723.img.gz. This system already includes the WiFi6 driver and the driver for our company's compatible 5G module.

The CM4_Ultra expansion board can be configured in OpenWrt as a one-in-one-out switch mode, with the native Gigabit port on the expansion board serving as the WAN port (connected to the Internet) and the 2.5G Ethernet port configured as the LAN port for connecting to a PC.

=== 5.1 Login system ===
Connect the native Gigabit port on the expansion board to the PC's Ethernet port. After powering on the system, go to Network & Internet settings in Windows, open the connected network under Ethernet, and check the default gateway IP address. This address is the backend configuration page address of the OpenWrt. As shown in the figure, the tested address in this article is 192.168.198.1:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_53.jpg

Then open a web browser, enter '''192.168.198.1''' to access the OpenWrt system. The default username is '''<code>root</code>''', and the default password is '''<code>password</code>'''.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_54.jpg

=== 5.2 Network interface configuration ===
Open "Network - Interfaces", then click "Add new interface":

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_55.jpg

Set the interface name to "WAN", select "DHCP client" for the interface protocol, choose "eth0" for the interface, and then click the "Submit” button.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_56.jpg

In the firewall settings, choose the WAN port and click "Save". Do not click "Save & Apply".

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_57.jpg

Then click the "Return to Overview" button, and at the interface, click the "Modify" button for the LAN port.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_58.jpg

In the physical settings, change the interface to eth1:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_59.jpg

Then click the "Save & Apply" button, and the network configuration will be completed.

=== 5.3 2.5G Ethernet port test ===
After the network configuration is completed, the native Gigabit Ethernet port becomes the WAN port, and the 2.5G port becomes the LAN port. Switch the Ethernet cable connected to the computer to the 2.5G port, then connect the native Gigabit port to the upstream router.

Access the OpenWrt page, click on "System - TTYD Terminal", after logging in (the default username is '''<code>root</code>''', and the default password is '''<code>password</code>'''), enter <code>ifconfig -a</code> to check the IP address.

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_60.jpg" width=640></html>

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_62.jpg" width=640></html>

Here, eth0 is a 2.5G network card, and eth1 is a Gigabit network card.

You can also check the network port information under "Network - Interfaces".

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_61.jpg

Next, we will use the iperf3 speed testing software (pre-installed in the system) on the TTYD terminal to conduct speed tests between the device and the PC:

When the expansion board acts as the client:

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_63.jpg" width=640></html>

When the expansion board acts as the server:

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_64.jpg" width=640></html>

'''''Note: Network speed test results are influenced by network conditions and testing methods. Actual speeds may vary, and this test is for reference only.'''''

=== 5.4 SSD test ===
After logging into the admin panel, go to "System > Mount Points" to see the SSD automatically mounted.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_71.jpg

Click on "Network Storage - Network Sharing". Be aware that there may be two "Network Sharing" options; choose the one marked Samba, not Ksmbd!

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_72.jpg

Add a shared directory, with the directory being the mounted drive's address:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_73.jpg

Then click the "Save & Apply" button.

After the setup is complete, enter <code>\\192.168.198.1</code> (the address is that of the extension board; it may vary in practice) in the file explorer, and you will see the shared directory.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_74.jpg

Drag any file to the desktop to test read speed:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_75.jpg

Drag and drop any file onto the SSD to test write speed:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_76.jpg

'''''Note: Test speeds are affected by various factors such as network conditions, hard drive quality, file storage status on the drive, etc. The above test results are for reference only and do not serve as final parameters for the actual product.'''''

If Windows prompts that access is denied when trying to access a shared resource:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_77.jpg

The Windows network policy needs to be modified. Press Windows + R, then type gpedit.msc to launch the Local Group Policy Editor. Go to Computer Configuration → Administrative Templates → Network → Lanman Workstation step by step. In the right content area, you can see the policy setting "Enable insecure guest logons". The status is '"Not configured".

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_78.jpg

Please double-click the policy setting "Enable insecure guest logons", set its status to "Enabled," and click the OK button.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_79.jpg

After setup, I retried and could access it successfully.

<!--=== 5.5 WiFi6模块测试 ===

==== 5.5.1 设置WiFi6 ====
承接5.2章节之后，将WiFi6模块（AX200或AX210）插上扩展板，2.5G网口连电脑，千兆网口不插网线。登录后台后，在“网络 - 无线”中可以看到无线概况：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_84.jpg

点击“扫描”按钮，扫描出附近的无线AP：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_85.jpg

选择一个进行连接，防火墙选“WAN”：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_86.jpg

然后按“提交”，提交后在点击“保存&应用”：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_91.jpg

成功后再回到“无线概况”，就能看到此时无线已经连接成功：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_87.jpg

我们登录TTYD终端，运行<code>ifconfig -a</code>查看网络参数，可以看到无线网卡（wlan0）已经获取了IP地址：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_88.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_89.jpg

利用本扩展板做client，与电脑之间进行测速，结果如下：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_90.jpg

如果需要将扩展板做server，需要在”防火墙 - 常规设置 - 区域“中，将wan的入站数据等改成接受：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_113.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

==== 5.5.2 WiFi6模块作为无线AP ====
AX210可以在2.4G模式下作为无线AP使用，AX200不能作为无线AP使用。本节使用AX210进行测试，实现千兆做WAN，AX210做LAN。

承接上一节，我们现在将千兆网口接上级路由器。然后在“网络 - 无线”里面点击“修改”：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_92.jpg

按照下图修改：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_93.jpg

无线AP名称可以自己定义，我们这里取名“ AX210”:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_94.jpg

点击“保存&应用”，随后点击“网络 - 接口”，删除WWAN：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_95.jpg

再点击LAN的“修改”：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_96.jpg

进入LAN的物理设置（将原先2.5G做LAN改成AX210做LAN），确认设置如下图：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_97.jpg

点击“保存&应用”，然后进入“网络 - 无线”，把这个AP先停用再启用：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_98.jpg

随后我们就能搜索到这个AP了，我们连接该AP，密码就是上一节连的无线AP的密码：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_99.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_101.jpg

上网测速结果如下：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_100.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''-->
=== 5.5 5G模块测试 ===
Insert the 5G module (this document uses the RM500U-CN as an example) and the SIM card, then connect from the computer to the 2.5G port, leaving the native Gigabit port unconnected.

Start the system, click on "System - TTYD Terminal," log in, and enter <code>ifconfig -a</code> to check the network interfaces.

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_102.jpg" width=640></html>

<html><img src="http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_103.jpg" width=640></html>

You can see there is a network interface named usb0, which is the 5G module, but it has no IP address.

Go to "Network → Interfaces", and click "Add new interface":

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_108.jpg

Please configure according to the diagram below to add a new interface, which this document names "5GWAN":

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_109.jpg

Click "Submit", then go to "Firewall Settings" and set the firewall zone to "WAN".

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_110.jpg

Then click "Save & Apply". After it succeeds, return to "Network - Interfaces". At this point, you will see that the 5G module has obtained an IP address, and the PC can access the internet through this 5G module.

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_111.jpg

[https://www.speedtest.cn/ The internet speed test] results on the PC are as follows:

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_112.jpg

'''''Note: Network speed test results are affected by the network environment and testing methods. The actual speed may vary, and this test is for reference only.'''''

== '''VI. Power consumption test information''' ==
{| class="wikitable"
|+'''This power consumption test uses a USB-C port connected to a 5V 3A power supply'''
!
!'''Standby powerconsumption'''
!'''Power usage''' '''during system operation'''
!
!Modules use each other
!'''System powerconsumption'''
|-
|No external devices
|0.756A
|
|
|Transferring files from the computer to the SSD over WiFi6
|1.25A
|-
|Use 5G only
|0.9A
|1.9A (test speed)
|
|Transferring files from the SSD to the computer over WiFi6
|1.72A
|-
|Use SSD only
|0.847A
|
|
|Transferring files from the SSD to the computer over 2.5G
|1.588A
|-
|Use WiFi6 only
|0.83A
|1.15A
|
|Transferring files from the computer to the SSD over 2.5G
|1.668A
|-
|All devices connected
|1.15A
|
|
|Download files from webpages to SSD over 5G
|1.88A
|}

'''''Note: The above data is our company's test data and is for reference only.'''''

{{Contact_Us_icon}}

[http://wiki.mcuzone.com/index.php?title=2001_RPi_CM4_Ultra%E6%89%A9%E5%B1%95%E6%9D%BF T]