版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

将 HDMI 信号源输出分辨率调整为 1080P@60Hz 后重新测试


Sv translation
languageen

Test File Download

uart file download uart
test.wav download :test.wav
UartAssist.exe download:UartAssist.exe

Basic Equipment Information

1. Basic Equipment Information

ItemDetails
Device ModelEDGE-RK3588 Development Board
Hardware VersionV1.2A
System VersionDebian 11 Xfce
Firmware Versionrk3588_edge_v12_debian_xfce_rk7_v1.2 (Neutral Version)
Kernel VersionLinux 5.10

2. Core Hardware Configuration

ItemConfiguration Details
CPU8-core heterogeneous architecture: 4×Cortex-A76 (High-performance Core) + 4×Cortex-A55 (Energy-efficient Core), max main frequency up to 2.4GHz
GPUMali-G610 MP4 Graphics Processor
 Supported standards: OpenGL ES 1.1/2.0/3.2, OpenCL 2.2, Vulkan 1.2
DDR MemoryLPDDR4X, optional capacity: 4GB/8GB/16GB
NPU AI Computing Power6.0 TOPS, supports INT4/INT8/FP16 computing precision
Onboard StorageSupports eMMC 5.1 / SDIO 3.0 interface
 Optional capacity: 16GB/32GB/64GB/128GB

3. Power Supply Parameters

ItemSpecification
DC Power RequirementInput: 12V 2A DC
 Interface: 5.5mm × 2.0mm DC barrel port
 ⚠️ Note: Voltage lower than 12V may cause boot failure
Extended Power SupplyReserved POE power interface, supports external POE module power supply (separate configuration required)

I. Basic Power Supply Test

1. Power Interface Function Verification

  • Verify the compatibility, electrical performance and safety of the device power interface to ensure compliance with power supply parameter requirements.。

2. Test Environment and Tool Adaptability

Tools / EnvironmentSpecifications
DC Power Adapter12V 2A DC (Compatible with 5.5mm×2.0mm interface)
MultimeterSupports voltage and current measurement
POE Module (Optional)Matches reserved POE interface of the device
DUTTarget product (with power interface)

3. Basic Test Procedure Specifications

1. DC Power Interface Compatibility Test

  • Test Steps:

    1.Confirm the DC power adapter is 12V 2A DC with 5.5mm×2.0mm interface size.

    2.Connect the adapter to the device power interface, then check if the device powers on normally.

  • Judgment Standard:

    The power plug can be smoothly inserted and pulled out, and the device starts up normally without any abnormality. 

2. Input Voltage Lower Limit Verification

  • Test Steps:

    1.Adjust the adjustable DC power supply to 11.5V (lower than 12V) and connect it to the device.

    2.Observe whether the device fails to boot or other abnormal conditions occur.

     
  • Judgment Standard:

    The device cannot start normally when the voltage is lower than 12V, which is consistent with the notes of power supply parameters.

3. POE Interface Extended Power Supply Test (Optional) 

  • Test Steps:

    1.Connect the POE module to the reserved POE interface of the device.

    2.Power on the POE module and observe the operating state of the device.

     
  • Judgment Standard:

          The device can be stably powered by the POE module and operates normally.

2.Wired Communication Interface Test 

1.RS232 Serial Port Test

 RS232 corresponding device node: ttyS3 (V1.2 version) / ttyS4 (V1.4 version)

 Test Preparation:

1.Confirm the serial port node

代码块
languageshell
titlebash
# Method 1: List all serial ports
ls -la /dev/ttyS*

# Method 2: Determine by hardware version
# Check board version label or run:
cat /proc/device-tree/model
# If output contains V1.4, use /dev/ttyS4
# If output contains V1.2, use /dev/ttyS3

2.Two-minute Loopback Test

代码块
languageshell
titlebash
# Step 1: Hardware Short Connection (Required)
# Short TX (Pin 2) and RX (Pin 3) of the RS232 interface using a jumper wire

# Step 2: Prepare Test Tool
# Upload the UART test program to the device (if transferring from Windows)
adb push C:\Users\Administrator\Desktop\uart ./

# Step 3: Grant Permissions
chmod 777 ./uart

# Step 4: Execute Test
# Terminal 1: Receive data
cat /dev/ttyS3

# Terminal 2: Send data
./uart /dev/ttyS3
# Enter test text and check the reception result in Terminal 1

Output Example

代码块
languageshell
titlebash
# Terminal 2 Program Output Example:
# fcntl=0
# isatty success!
# fd-open=3
# set done!
# please input:         # Waiting for user input (e.g. 45 3A F7 98)

# Terminal 1 receives the data input from Terminal 2 (e.g. 45 3A F7 98)


2. RS485 Serial Port Test 


  1. Test Purpose
     Verify the bidirectional data communication function of the RS485 serial port (mapped to system device /dev/ttyS0) of the RK3588 device with the UART Assist tool on the computer side, ensuring the availability of the serial port hardware, driver and communication link.
  2. Test Environment

Device / ToolConfiguration Information
RK3588 DeviceSystem: Embedded Linux (e.g. Armbian)
 RS485 Serial Port: /dev/ttyS0 (Baud Rate 115200, 8N1)
PCTool: UART Assist (Serial Debug Assistant)
 Hardware: USB to RS485 Module (e.g. CH340+MAX485)
ConnectionRS485 Wiring: Connect RS485_A of RK3588 to Module A, RS485_B to Module B, Common Ground (GND)

3. Hardware Wiring 

  1. Connect RK3588 RS485 pins to the USB-to-RS485 module:
    • RK3588 RS485_A → Module A
    • RK3588 RS485_B → Module B
    • RK3588 GND → Module GND (Common ground is required to avoid signal interference)
  2. Connect the USB-to-RS485 module to the computer's USB port and install the corresponding driver (e.g. CH340 driver).

4. Test Steps

4.1 PC-side UART Assist Configuration 

  1. Open the UART Assist tool and select the serial port corresponding to the USB-to-RS485 adapter (e.g. COM3);
  2. Configure parameters: Baud rate 115200, Data bits 8, Parity none, Stop bits 1, Flow control none;
  3. Click "Open Serial Port" to confirm a successful connection.

4.2 Unidirectional Transceiver Test (PC → RK3588)

  1. Start serial port reception on the RK3588 side:
代码块
languageshell
titlebash
# Step 1: Prepare Test Tool
# Upload the UART test program to the device (if transferring from Windows)
adb push C:\Users\Administrator\Desktop\uart ./

# Step 2: Grant Permissions
chmod 777 ./uart

# Step 3: Execute Test
# Terminal 1: Receive data
cat /dev/ttyS0

# Terminal 2: Run the command tool to configure correct serial port parameters
./uart /dev/ttyS0

      2.Enter test data (e.g. "RK3588 RS485 Test") in UART Assist on the PC side, and click "Send" (as shown in the figure below);

      3.Observe RK3588 Terminal 1 (as shown in the figure below). If the received test data is displayed, the unidirectional receiving function is normal.

4.3 Unidirectional Transceiver Test (RK3588 → PC)

  1.  Keep UART Assist on the PC side in the "Open" state;
  2. Send test data on the RK3588 side:
代码块
languageshell
titlebash
# Step 1: Prepare Test Tool
# Upload the UART test program to the device (if transferring from Windows)
adb push C:\Users\Administrator\Desktop\uart ./

# Step 2: Grant Permissions
chmod 777 ./uart

# Step 3: Execute Test
# Send data
./uart /dev/ttyS0
# Enter test text (as shown in the figure below)

     

3.Observe UART Assist on the PC side (as shown in the figure below). If the received test data is displayed, the unidirectional transceiver function is normal.

3. USB Interface Test 

1.Device Connection Status Identification 
Use the following commands to confirm whether the device is connected to the system and obtain device node information:

代码块
languageshell
titlebash
# View all block devices and identify the USB device node (e.g. /dev/sda1)
lsblk
# View detailed USB device information, including controller and device ID
lsusb

Result Description: In the output of lsusb, ID 1d6b:0002 stands for USB 2.0 controller, and ID 1d6b:0003 stands for USB 3.0 controller. The corresponding USB version can be judged by the bus where the device is mounted.

2.USB Version Compatibility Test
 Accurately confirm USB version via device speed parameters. USB2.0 corresponds to High-Speed (480Mbps), USB3.0 corresponds to Super-Speed (5000Mbps). Operations are as follows:

1.Check device speed file

代码块
languageshell
titlebash
# Traverse all USB devices and output their transfer speed
for device in $(ls /sys/bus/usb/devices/); do
    if [ -f "/sys/bus/usb/devices/$device/speed" ]; then
        speed=$(cat /sys/bus/usb/devices/$device/speed)
        echo "Device: $device, Speed: $speed Mbps"
    fi
done

 2.Verify through detailed information

代码块
languageshell
titlebash
# View detailed parameters of specified USB device, filter Speed field
lsusb -v | grep -E "Speed|Device"

 Result description: In the output, Speed: 480Mbit/s corresponds to USB2.0, and Speed: 5000Mbit/s corresponds to USB3.0.

3. Transmission Performance Test

 Transmission speed is the core difference between USB2.0 and USB3.0. The theoretical speed of USB2.0 is 480Mbps, while that of USB3.0 is 5Gbps. Two commonly used test methods are provided below, applicable to USB storage devices and network USB devices respectively.

1. Simple Test: dd Command

 The dd command can quickly test read and write speeds for preliminary verification. Mount the USB device first before testing.
 
1.1 Mount the USB device:

代码块
languageshell
titlebash
# Assume the USB device node is /dev/sda1 confirmed by lsblk, create mount point and mount
mkdir -p /mnt/usb
mount /dev/sda1 /mnt/usb

 1.2 Test sequential write speed:

代码块
languageshell
titlebash
# Write 1GB zero data to the USB device, bypass cache to ensure real results
dd if=/dev/zero of=/mnt/usb/testfile bs=1M count=1024 conv=sync oflag=direct

 1.3.Test sequential read speed:

代码块
languageshell
titlebash
# Read the test file from the USB device and discard it to test the read speed
dd if=/mnt/usb/testfile of=/dev/null bs=1M iflag=direct

 1.4.Clean up temporary files after testing:

代码块
languageshell
titlebash
rm /mnt/usb/testfile

Result Description: After the command is executed, the transfer time and speed will be displayed.

  • The actual write speed of USB 2.0 is usually 10 - 30 MB/s.
  • The actual write speed of USB 3.0 is usually 50 - 150 MB/s (affected by the performance of the device itself).

2. Professional Test: fio Tool

The fio tool supports complex IO scenario testing with more comprehensive results, suitable for in-depth performance evaluation.

2.1 Install fio:


代码块
languageshell
titlebash
# Ubuntu/Debian
sudo apt install fio -y

 2.2.Code block for fio test commands

代码块
languageshell
titlebash
# Sequential write test
fio -filename=/temp/testfile -direct=1 -ioengine=psync -iodepth 128 -rw=write -bs=1M -size=3G -numjobs=4 -runtime=30 -group_reporting -name=iopstest -time_based=1

# Sequential read test
fio -filename=/temp/testfile -direct=1 -ioengine=psync -iodepth 128 -rw=read -bs=1M -size=3G -numjobs=4 -runtime=30 -group_reporting -name=iopstest -time_based=1

# Random write test
fio -filename=/temp/testfile -direct=1 -ioengine=psync -iodepth 128 -rw=randwrite -bs=1M -size=3G -numjobs=4 -runtime=30 -group_reporting -name=iopstest -time_based=1

# Random read test
fio -filename=/temp/testfile -direct=1 -ioengine=psync -iodepth 128 -rw=randread -bs=1M -size=3G -numjobs=4 -runtime=30 -group_reporting -name=iopstest -time_based=1

# Mixed random read/write test (default read/write ratio 50:50)
fio -filename=/temp/testfile -direct=1 -ioengine=psync -iodepth 128 -rw=randrw -bs=1M -size=3G -numjobs=4 -runtime=30 -group_reporting -name=iopstest -time_based=1

4. Type-C Interface Test

1. ADB Function Test

1.1 Basic ADB Connection Test

Test Purpose: Verify that the Type-C interface can establish ADB connection normally and the device can be recognized by PC.
Test Steps:

  1. Connect the device under test and PC with a Type-C data cable.
  2. Enable Developer options USB debugging on the device.
  3. Run adb devices on PC to check if the device is detected.
  4. Run adb shell to verify access to the device command line.

Expected Results:

  1. adb devices displays the device serial number with the status shown as device.
  2. Successfully enter the device shell without connection timeout or permission denial.

1.2 Core ADB Command Execution Test

Test Purpose: Verify that core ADB commands work properly over the Type-C link.
Test Steps:

  1. File transmission:
     Run adb push test_file /data/ to send files to the device.
     Run adb pull /data/test_file ./ to download files to PC.
  2. Device control:
     Run adb reboot to restart the device, then execute adb devices again after reboot.
  3. Log capture:
     Run adb logcat -d > adb_log.txt to capture system logs.

Expected Results:

  1. File transmission completes successfully, and the downloaded file has the same size as the original.
  2. ADB connection recovers automatically after reboot.
  3. The log file is not empty and contains valid running logs.

1.3 Type-C Plug & Play and Stability Test

Test Purpose: Verify the stability of ADB connection during Type-C cable plugging, unplugging and shaking.
Test Steps:

  1. Single plug operation: Plug and unplug the data cable 10 times, and run adb devices after each operation.
  2. Continuous plug operation: Rapidly plug and unplug 20 times with an interval of 1–2 seconds.
  3. Shake test: Keep the cable connected and shake it gently, then observe the connection status.

Expected Results:

  1. The device is recognized normally after each operation with no offline status.
  2. ADB connection remains stable during shaking with no I/O errors.

1.4 High-load Stability Test for Type-C Connection

Test Purpose: Verify the stability of Type-C ADB function under high load.
Test Steps:

  1. Large file transmission: Push a 1GB file to the device while running adb logcat.
  2. Concurrent commands: Run adb push, adb shell top and adb logcat simultaneously.
  3. Long-duration connection: Maintain ADB connection for 24 hours and run adb devices every hour.

Expected Results:

  1. ADB connection stays active during large file transmission, and log capture works normally.
  2. No crash or timeout occurs when running multiple commands; CPU usage ≤ 80%.
  3. The connection status remains device within 24 hours with no disconnection.

2. Type-C to USB Hub Test

2.1 Device Recognition and Compatibility Test

Prerequisites:

  1. The development board is powered on and the system boots up completely.
  2. The Type-C to USB Hub is connected properly.

Operation Steps:

  1. Insert the Type-C end into the Type-C port of the development board.
  2. Connect USB devices (USB flash drive, mouse, keyboard) to the USB ports of the Hub one by one.
  3. Run lsusb to view the device list.
  4. Check system logs with dmesg | grep usb.

Expected Results:

  1. All USB devices are recognized correctly, and corresponding device IDs are shown in the lsusb output.
  2. No recognition failures or error messages related to USB devices in system logs.
  3. The USB flash drive can be mounted and read/written normally; the mouse and keyboard respond properly.

2.2 Data Transfer Speed Test

Prerequisites:

  1. Same as Section 2.1
  2. Prepare a 1GB test file named test.img

Operation Steps:

  1. Connect a USB 3.0 flash drive and mount it to /mnt/usb.
  2. Run the file copy command: 
代码块
dd if=/dev/zero of=/mnt/usb/test.img bs=1M count=1024

3.Record the transmission time and calculate the speed: Speed = 1024MB / Time (seconds)

4.Copy files back to the development board in reverse direction and repeat the test 3 times.

Expected Results:

  1. Transmission speed ≥ 80MB/s (about 640Mbps) under USB 3.0 mode.
  2. Transmission speed ≥ 30MB/s (about 240Mbps) under USB 2.0 mode.
  3. No data loss, transmission interruption or file corruption.

2.3 Power Supply Capability Test

Prerequisites:

  1. Same as Section 2.1
  2. Prepare a 2.5-inch portable hard drive (requiring power supply of 5V/0.5A or above)

Operation Steps:

  1. Connect the portable hard drive to the USB port of the Hub.
  2. Check if the hard drive indicator light is on, and run lsblk to view the device node.
  3. Perform large file read and write operations continuously for 10 minutes.
  4. Check system logs for warnings about insufficient power or device disconnection.

Expected Results:

  1. The portable hard drive starts normally and can be recognized, read and written by the system.
  2. No device disconnection or data corruption during long-duration read and write operations.
  3. No over-current or power supply related errors in system logs.

2.4 Abnormal Scenario Test

  1. Hot-plug test: Plug and unplug USB devices during data transmission to verify system stability.
  2. Low voltage test: Reduce the power supply voltage of the development board to 4.5V and check if USB devices work normally.
  3. Multi-device concurrency test: Connect multiple USB devices simultaneously to verify the load capacity of the Hub.

3. Type-C to HDMI/DP Output Test

3.1 Video Output Function Test

Prerequisites:

  1. The development board is powered on and the system boots up completely.
  2. The Type-C to HDMI/DP adapter is connected properly and the monitor is powered on.

Operation Steps:

  1. Plug the Type-C end into the Type-C port of the development board, and connect the HDMI/DP end to the monitor.
  2. Execute display configuration commands (Linux: xrandr; Android: System Settings).
  3. Switch display output to HDMI and set the resolution to 1080P@60Hz.
  4. Observe the screen and check for screen distortion, black screen or flickering.

Expected Results:

  1. The monitor lights up automatically and displays the desktop or screen of the development board.
  2. Resolution and refresh rate can be configured normally with clear and undistorted images.
  3. No screen distortion, black screen, flickering or lag.

3.2 Audio and Video Synchronization Test

Prerequisites:

  1. Same as Section 3.1
  2. The monitor supports HDMI/DP audio output.

Operation Steps:

  1. Play a 1080P test video with audio tracks.
  2. Observe video fluency and listen to sound from the monitor speaker.
  3. Check audio-video synchronization and verify for noise or audio interruption.

Expected Results:

  1. The video plays smoothly with stable frame rate (≥30fps).
  2. Audio and video are synchronized without lag or stutter.
  3. Sound is clear with no noise, interruption or popping sound.

3.3 Hot-plug Test

Prerequisites:
 Same as Section 3.1
Operation Steps:

  1. Connect the Type-C to HDMI/DP adapter first and confirm normal display.
  2. Unplug the HDMI/DP end and observe system response.
  3. Reconnect the HDMI/DP end and observe system response.
  4. Repeat hot plugging 10 times and record each result.

Expected Results:

  1. After unplugging HDMI/DP, the system automatically switches back to the onboard display or goes black (in line with design requirements).
  2. The monitor restores display automatically after reconnection without manual configuration.
  3. No system crash or driver errors occur during hot plugging.

3.4 Abnormal Scenario Test

  1. Resolution switching test: Switch among 720P/1080P/4K to verify display compatibility.
  2. Long-time playback test: Play videos continuously for 24 hours to verify stability.
  3. Low-resolution output test: Set resolution to 480P to verify downward compatibility.

III. Display and Video Interface Test

1. HDMI/DP Output Test

1. Specification Description:

InterfaceCore SpecificationsKey Limitations
HDMI 2.1Single port, supports 8K@30Hz / 4K@60Hz, HDCP 2.3Requires HDMI 2.1 certified cable, maximum bandwidth 48Gbps
DP 1.4a (4Lane)Single port, supports 4K@60Hz, HDCP 2.3Full 60Hz frame rate available for 4K resolution

2.Resolution Verification (Including 8K/4K)

1.Query display interfaces and resolution list

代码块
languageshell
titlebash
# Graphical Interface (X11) - Intuitively view supported resolutions/refresh rates/HDCP status
xrandr --verbose | grep -E "HDMI|DP|3840|7680|HDCP"

2.Audio Output Test Steps (Command Line Operation)

代码块
languageshell
titlebash
# Step 1: Connect to the device via adb (Ensure debugging mode is enabled on the device)
adb shell

# Step 2: Push the test audio file to the device (Execute on the PC)
adb push C:\Users\Administrator\Desktop\test.wav /test.wav

# Step 3: Check the device audio output list (Confirm the corresponding card number)
aplay -l

# Step 4: HDMI0 Audio Output Test
aplay -D plughw:0,0 /test.wav
# Expected Result: The display device connected via HDMI plays audio

# Step 5: DP1 Audio Output Test
aplay -D plughw:4,0 /test.wav
# Expected Result: The display device connected via DP plays audio

2. HDMI Input Test

1. Test Preparation

  1. Hardware Connection: Connect a valid HDMI signal source (such as a laptop, HDMI camera, set-top box, etc.) to the HDMI IN interface of the development board using a standard HDMI cable.
  2. Signal Source Configuration: Ensure the HDMI signal source is powered on, and the output resolution/frame rate is compatible with the development board's HDMI IN interface (1920×1080@60Hz is recommended to avoid recognition failure caused by non-standard resolutions).
  3. System Login: Log in to the development board system via SSH / Serial Port / Local Terminal. It is recommended to operate with a user with graphics display permissions (e.g., blueberry).

2. HDMI Input Device Node Query and Verification

  1. View the system video device list
代码块
languageshell
titlebash
# Switch to the user with graphical display permissions (to avoid device access failure due to insufficient permissions)
su - blueberry

# List all video-related devices under the /dev directory and confirm the device node corresponding to HDMI IN
ls -la /dev/video*

Query Results:

代码块
languageshell
titlebash
-rw-rw----  1 root video     4 Dec  2 02:18 /dev/video-dec0
-rw-rw----  1 root video     4 Dec  2 02:18 /dev/video-enc0
crw-rw----+ 1 root video 81, 0 Dec  2 02:18 /dev/video0

2.Query device details
代码块
languageshell
titlebash
# Execute command:
cat /sys/class/video4linux/video0/name
# Output result: stream_hdmirx
# Description: stream_hdmirx indicates this is a video stream HDMI receiving device (hdmirx = HDMI Receiver)

Result Analysis:

Device NodeDevice TypeFunction DescriptionPermissions / Device Numbers
/dev/video0Character device (starts with c)HDMI input video capture device (core)Read/writable by root/video group; major number 81, minor number 0
/dev/video-dec0Regular fileSystem video decoding deviceRead/writable by root/video group
/dev/video-enc0Regular fileSystem video encoding deviceRead/writable by root/video group

3.Query device driver information:
代码块
languageshell
titlebash
readlink -f /sys/class/video4linux/video0/device/driver

Output: /sys/bus/platform/drivers/rk_hdmirx
Description: The device uses the official Rockchip rk_hdmirx driver, which is the core driver for HDMI input function on Rockchip platforms. The driver is loaded normally.

3. HDMI Input Video Stream Playback Test

1.Execute video playback command:


代码块
languageshell
titlebash
# Switch to the user with graphical display permissions
su - blueberry

# Configure display environment variable (specify main screen output), play HDMI input video stream via GStreamer
gst-launch-1.0 v4l2src device=/dev/video0 ! videoconvert ! autovideosink


2. Execution Result Verification

代码块
languageshell
titlebash
Setting pipeline to PAUSED ...       # Pipeline status: Pausing
Using mplane plugin for capture      # Capture plugin: Using mplane (multi-planar) mode
Pipeline is live and does not need PREROLL ...  # Pipeline status: Active, no preroll required
Pipeline is PREROLLED ...            # Pipeline status: Preroll completed (data ready)
Setting pipeline to PLAYING ...      # Pipeline status: Playing
New clock: GstSystemClock            # Clock initialization: Synchronized with system clock

Output Interpretation

Each log line corresponds to the startup status of the GStreamer pipeline. The absence of error messages indicates:

  • The video capture plugin (mplane) is loaded successfully.
  • The pipeline completes initialization, activation and preroll, and video stream transmission works properly.
  • The clock synchronization component (GstSystemClock) runs normally and provides time reference for the video stream.

Display Performance

A playback window pops up on the monitor connected to the development board, showing real-time images from the HDMI signal source (such as laptop desktop or camera view). The test is passed if there is no screen distortion, stuttering or black screen.

4.Troubleshooting Guide

异常现象可能原因排查方法
终端提示 “No such device”/dev/video0 节点不存在

1.检查 HDMI IN 驱动是否加载:lsmod grep rk_hdmirx

2.若无输出,重新加载驱动:sudo modprobe rk_hdmirx`
3.重新插拔 HDMI 线,确保接口接触良好

显示屏无播放窗口DISPLAY 环境变量配置错误执行 echo $DISPLAY 确认值为 :0.0,或切换到本地终端执行命令
画面卡顿 / 花屏信号源分辨率不兼容
Abnormal PhenomenonPossible CauseTroubleshooting Methods
Terminal prompts "No such device"The node /dev/video0 does not exist

1. Check if the HDMI IN driver is loaded: lsmod grep rk_hdmirx

2. Reload the driver if no output is returned: sudo modprobe rk_hdmirx`
3. Reconnect the HDMI cable to ensure good contact

No playback window on the displayIncorrect configuration of the DISPLAY environment variableRun echo $DISPLAY to confirm the value is :0.0, or execute commands in the local terminal
Stuttering / distorted imageIncompatible resolution of the signal sourceAdjust the output resolution of the HDMI signal source to 1080P@60Hz and test again


3. Video Hard Decoding Performance Test

1. Test Environment (MPP Video Hard Decoding Device)

Based on the hard decoding tool information of the Rockchip MPP (Media Process Platform) framework:

ItemDetails
Tool Nameppvidedec
Tool Version1.14.4
Dependency Library Path/usr/lib/aarch64-linux-gnu/gstreamer-1.0/libgstrockchipmpp.so
Supported Encoding FormatsHEVC/H.265, AVC/H.264, VP8, VP9
Decoding TypeHardware-accelerated decoding
Maximum Decoding CapabilitySupports 8K 10-bit video decoding and 8K 60Hz video output
Test Steps:2.测试步骤:
2.1.准备测试视频: Prepare test videos:
代码块
languageshell
titlebash
#1.本地测试视频路径:
 Local test video path:C:\Users\Administrator\Desktop\test_video\4K_60fps.mp4

# 2.通过 ADB 将视频推送至开发板:#2. Push the video to the development board via ADB:
adb push "C:\Users\Administrator\Desktop\boot\4K_60fps.mp4" /tmp/


2.2.执行硬解码测试(以Perform hardware decoding test (take H.264 格式为例) format as an example)
代码块
languageshell
titlebash
# Use 使用gstgst-launch-1.0调用 MPP 硬解码工具,验证解码功能:0 to invoke the MPP hardware decoding tool and verify the decoding function:
gst-launch-1.0 filesrc location=/tmp/4K_60fps.mp4 ! \
qtdemux ! \
h264parse ! \
mppvideodec ! \
videoconvert ! \
autovideosink


 22.3 .测试验证要点

  • 视频播放状态:需无花屏、绿屏、卡顿等异常现象;
  • 日志信息:终端输出中不得出现decode errorResource not found

    Test Verification Points


     Video playback status: No abnormalities such as screen tearing, green screen, or stuttering shall occur;
     Log information: No errors including decode error, Resource not found, or pipeline doesn't want to preroll

    等报错,需呈现正常启动流程(示例如下);

    shall appear in the terminal output. A normal startup process shall be displayed (example shown below);
     Display effect: After executing the playback command, the display interface shall present a complete and clear video image (no image distortion or color distortion caused by decoding exceptions).
     
    Example of normal log output (description)

    代码块
    language
  • 显示效果:执行播放命令后,显示界面应呈现完整、清晰的视频画面(无解码异常导致的画面畸变、色彩失真)。
  • 日志信息正常输出示例(说明)

    代码块
    languageshell
    titlebash
    Setting pipeline to PAUSED ...
    Pipeline is PREROLLING ...
    Pipeline is PREROLLED ...
    Prerolled, waiting for async message to finish...
    Setting pipeline to PLAYING ...
    New clock: GstSystemClock
    
    #日志逐行说明:
    #Setting pipeline to PAUSED ...:GStreamer 管道进入暂停状态,开始初始化音视频解码组件(如 MPP 硬解码器),无报错代表组件加载初始化无异常;
    #Pipeline is PREROLLING ...:管道进入预滚动阶段,开始读取视频文件并解析码流,为硬解码做数据准备;
    #Pipeline is PREROLLED ...:预滚动完成,视频码流解析成功,RK3566 的 MPP 硬解码单元已获取有效数据;
    #Prerolled, waiting for async message to finish...:预滚动完成后等待异步消息确认,是 GStreamer 适配嵌入式设备的正常等待流程,无异常;
    #Setting pipeline to PLAYING ...:管道切换至播放状态,硬解码开始输出视频帧至显示设备;
    #New clock: GstSystemClock:系统时钟同步完成,音视频时序匹配,无卡顿、音画不同步风险。
    (注:配图为视频正常播放时的界面示例,可直观验证画面无畸变、显示正常)


    (Note: The attached picture is an example of the interface during normal video playback, which can intuitively verify that the picture is free of distortion and displayed normally.)

    Image Added

    3. Open a second terminal to monitor CPU usage

    3.1 Operation Steps

    代码块
    languageshell
    titlebash
    # Step 1: Enter the ADB interactive shell
    adb shell
    
    # Step 2: Execute the top command in the shell (runs normally with TTY environment available)
    

    Image Removed

    3.开启第二个终端进行cpu占用率监控

     3.1操作步骤

    代码块
    languageshell
    titlebash
    # 操作说明:通过ADB远程执行top命令,查看系统资源占用(取前20行关键信息)
    adb shell "top -n1 | head -20"

      3.2系统状态输出示例(终端执行后输出如下,红框为核心监控项)2 Example of system status output (the following content is displayed after terminal execution; core monitoring items are marked in the red box)

    代码块
    languageshell
    titlebash
    #
    top - 06:01:06 up 17:57,  1 user,  load average: 2.10, 2.61, 2.56
    Tasks: 276 total,   2 running, 274 sleeping,   0 stopped,   0 zombie
    %Cpu(s):  3.8 us,  6.0 sy,  0.0 ni, 90.2 id,  0.0 wa,  0.0 hi,  0.0 si,  0.0 st
    MiB Mem :   3899.3 total,     91.5 free,    822.6 used,   2985.2 buff/cache
    MiB Swap:      0.0 total,      0.0 free,      0.0 used.   1694.6 avail Mem
    
        PID USER      PR  NI    VIRT    RES    SHR S  %CPU  %MEM     TIME+ COMMAND
       1981 root      20   0 4747336 266284 215960 R  50.0   6.7 877:37.20 Xorg
       2456 blueber+  20   0 1839264  74872  56884 S  12.5   1.9  60:46.06 xfwm4
       2513 blueber+  20   0  314400  39220  29936 S  12.5   1.0  44:54.98 xfce4-p+
      38043 root      20   0  529528  23188  11316 S  12.5   0.6   0:13.87 gst-lau+
      38263 root      20   0    9048   3400   2712 R   6.2   0.1   0:00.02 top
          1 root      20   0  165012   9932   7220 S   0.0   0.2   5:17.56 systemd
          2 root      20   0       0      0      0 S   0.0   0.0   0:00.45 kthreadd
          3 root       0 -20       0      0      0 I   0.0   0.0   0:00.00 rcu_gp
          4 root       0 -20       0      0      0 I   0.0   0.0   0:00.00 rcu_par+
          8 root       0 -20       0      0      0 I   0.0   0.0   0:00.00 mm_perc+
          9 root      20   0       0      0      0 S   0.0   0.0   0:00.00 rcu_tas+
         10 root      20   0       0      0      0 S   0.0   0.0   0:00.00 rcu_tas+
         11 root      20   0       0      0      0 S   0.0   0.0   0:04.57 ksoftir+

      3.3状态分析

     3.3 Status Analysis

     

    Monitoring ItemResultDescription
    Overall CPU LoadUser
    监控项结果说明CPU 整体负载用户
    3.8% +
    系统
    System 6.0% +
    空闲
    Idle 90.2%
    空闲占比超 90%,CPU 资源冗余充足;当前高占比进程为桌面服务(Xorg、xfwm4),属于系统基础负载内存状态总 3899MB,已用 829MB,可用 2968MB内存剩余充足,无内存不足风险关键进程 CPU 占比桌面服务(Xorg)占 50%,终端(tilda)占 12.5%若此时运行视频播放进程,需重点关注其 % CPU 值(硬解码生效时通常<10%)内存占用已用 829MB,缓存占 2864MB内存缓存占比高,系统数据读写效率有保障

     3.4测试结论:视频功能播放正常,无卡顿、花屏现象;CPU 占用率低(硬解码加速生效),系统资源负载符合预期。

    四、音频接口测试

    本测试针对设备的音频输出接口(含板载 Codec、HDMI),明确各接口的硬件映射关系:

    Idle ratio exceeds 90%, sufficient CPU resource redundancy; current high-ratio processes are desktop services (Xorg, xfwm4), belonging to basic system load
    Memory StatusTotal 3899MB, Used 829MB, Free 2968MBSufficient remaining memory, no risk of insufficient memory
    Key Process CPU RatioDesktop Service (Xorg) 50%, Terminal (tilda) 12.5%When running the video playback process, focus on its % CPU value (usually <10% when hardware decoding takes effect)
    Memory UsageUsed 829MB, Cache 2864MBHigh memory cache ratio ensures efficient system data read/write

    3.4 Test Conclusion: The video plays normally without stuttering or screen tearing. The CPU usage is low (hardware decoding acceleration is effective), and the system resource load meets expectations.

    V. Audio Interface Test



    This test targets the device's audio output interfaces (including onboard Codec and HDMI) to clarify the hardware mapping of each interface.:

    Card No.Device NameHardware InterfaceFunction Description
    0rockchiphdmi0HDMI0Audio output for the first HDMI port
    1rockchipdp0DisplayPort01st DisplayPort port (video output only, no audio support)
    2rockchipdp1DisplayPort12nd DisplayPort port (video output only, no audio support)

    card编号

    设备名称

    硬件接口

    功能说明

    0

    rockchiphdmi0

    HDMI0

    第一个HDMI接口音频输出

    1

    rockchipdp0

    DisplayPort0

    第 1 路 DP 接口(仅支持视频输出,不支持音频

    2

    rockchipdp1

    DisplayPort1

    第 2 路 DP 接口(仅支持视频输出,不支持音频
    4rockchipes8388ES8388 Codec
    板载音频接口(3
    Onboard audio interface (3.5mm 4
    节接口,支持:耳机输出、扬声器输出、MIC 输入)
    -pin jack, supporting headphone output, speaker output and MIC input)

    1.

    测试准备

    Test Preparation

    1.1

    工具

    Tools /

    文件:

    Files

     
    Test audio file:

    测试音频文件:

    test.wav

    (推荐格式:16bit、44.1kHz、立体声)

    调试工具:

  • 电脑端:adb(需配置环境变量)

  • 设备端:aplay(已预装)

    (recommended format: 16bit, 44.1kHz, stereo)
     
    Debugging tools:
     

    • PC side: adb (environment variables required)
    • Device side: aplay (pre‑installed)

    1.2

    件连接:

    Hardware Connection 

    • 测试 HDMI 音频:将 HDMI 线连接至设备的 HDMI 接口与支持音频输出的显示设备(如带音箱的显示器)

    • 测试板载音频:将 3.5mm 耳机插入板载音频接口

    1.音频输出功能验证
    • For HDMI audio test: Connect an HDMI cable between the device’s HDMI port and an audio‑enabled display device (e.g., a monitor with built‑in speakers).
    • For onboard audio test: Plug a 3.5 mm headphone into the onboard audio jack.

    1. Audio Output Function Verification

    1.Audio Output Function Verification

    代码块
    languageshell
    titlebash
    # 步骤1:通过adb连接设备(确保设备已开启调试模式)
    adb shell
    
    # 步骤2:推送测试音频文件到设备(电脑端执行)# Step 1: Connect to the device via ADB (Ensure USB debugging is enabled)
    adb shell
    
    # Step 2: Push test audio file to the device (Run on PC)
    adb push C:\Users\Administrator\Desktop\test.wav /test.wav
    
    # 步骤3:查看设备音频输出列表(确认card编号对应关系) Step 3: List audio output devices (Verify corresponding card numbers)
    aplay -l
    
    # 步骤4:HDMI0音频输出测试 Step 4: HDMI0 audio output test
    aplay -D plughw:0,0 /test.wav
    # Expected result: Audio plays on the display device connected via HDMI
    
    # Step 5: Onboard audio (headphone) output test
    aplay -D plughw:4,0 /test.wav
    # 预期现象:HDMI连接的显示设备播放音频
    
    # 步骤5:板载音频(耳机)输出测试
    aplay -D plughw:4,0 /test.wav
    # 预期现象:3.5mm耳机播放音频
    
    # 步骤6:硬件功能验证(正弦波测试,排除文件本身问题) Expected result: Audio plays through the 3.5mm headphone jack
    
    # Step 6: Hardware function verification (Sine wave test to exclude file issues)
    speaker-test -D hw:4,0 -t sine -f 1000 -c 2 -l 2
    # 预期现象:耳机输出1000Hz双声道正弦蜂鸣声
    

    测试结果记录

     Expected result: 1000Hz dual-channel sine tone is output from headphones
    

    Test Result Recording

    Test ItemOperation CommandExpected Result
    HDMI0 Audio Output

    测试项

    操作命令

    预期结果

    HDMI0 音频输出
    aplay -D plughw:0,0 /test.wav

    显示设备正常播放音频

    板载耳机输出
    Audio plays normally on the display device
    Onboard Headphone Outputaplay -D plughw:4,0 /test.wav

    耳机正常播放音频

    硬件正弦波测试
    Audio plays normally through headphones
    Hardware Sine Wave Testspeaker-test -D hw:4,0 -t sine -f 1000 -c 2 -l 2
    耳机输出蜂鸣声
    Beep sound is output from headphones

    2.

    音频输入功能验证

    Audio Input Function Verification

    1. List all audio capture devices
    代码块
    languageshell
    titlebash
    # Check the system audio device list (focus on "Capture" (input) devices)

    1.列出所有音频采集设备

    代码块
    languageshell
    titlebash
    # 查看系统音频设备列表(重点关注“Capture”(输入)设备)
    arecord -l
    

    2.典型输出示例Typical Output Example

    代码块
    languageshell
    titlebash
    **** List of CAPTURE Hardware Devices ****
    card 3: rockchiphdmiin [rockchip,hdmiin], device 0: rockchip,hdmiin i2s-hifi-0 [rockchip,hdmiin i2s-hifi-0]
      Subdevices: 1/1
      Subdevice #0: subdevice #0
    card 4: rockchipes8388 [rockchip-es8388], device 0: dailink-multicodecs ES8323.3-0010-0 [dailink-multicodecs ES8323.3-0010-0]
      Subdevices: 1/1
      Subdevice #0: subdevice #0
    

    3.结果解析Result Analysis

    设备类型
    Device Type
    关键信息
    Key Information &
    用途
    Purpose
    状态
    Status
    说明
    Description
    card 3: rockchiphdmiin
     device 0
    HDMI-IN
    音频采集卡对应 Rockchip 芯片的 HDMI 输入音频通道
     用于采集 HDMI 信号中的音频流正常识别(Subdevices: 1/1)
    audio capture card

     Corresponds to the HDMI input audio channel of Rockchip chip
     Used to capture audio stream from HDMI signal
    Detected normally (Subdevices: 1/1)
    card 4: rockchipes8388
     device 0
    Onboard audio codec chip
    板载音频编解码芯片
     ES8388/ES8323
    是低功耗音频 Codec
     用于板载麦克风 / 扬声器的音频采集 / 播放正常识别(Subdevices: 1/1)
    is a low-power audio codec
     Supports audio capture and playback for onboard microphone and speaker
    Detected normally (Subdevices: 1/1)

    4.)Recording Test (Real-time Capture + Playback)4.录音测试(实时采集+播放)

    代码块
    languageshell
    titlebash
    # 功能:实时采集音频输入(hwFunction: Real-time audio input capture (hw:4,0)并输出到音频输出(hw0) and playback to audio output (hw:0,0)0)
    # 参数说明:Parameter Description:
    # - arecord端: arecord (capture side):
    #   -D hw:4,0:指定音频输入设备(需根据实际`arecord -l`结果调整)0: Specify audio input device (adjust based on actual 'arecord -l' output)
    #   -r 48000:采样率48000Hz(适配多数音频设备) 48000: Sample rate 48000Hz (compatible with most audio devices)
    #   -c 2:立体声采集(若MIC为单声道,可改为-c 1) 2: Stereo capture (change to -c 1 for mono microphone)
    #   -f s16_le:16位小端音频格式(通用兼容格式)
    #   -t raw:以原始格式传输(避免文件编码开销)le: 16-bit little-endian format (universal compatible format)
    #   -t raw: Transmit in raw format (avoid file encoding overhead)
    # - aplay端:aplay (playback side):
    #   -D hw:0,0:指定音频输出设备(如HDMI/板载扬声器)0: Specify audio output device (e.g. HDMI/onboard speaker)
    #   - 其余参数与arecord保持一致(确保格式匹配) Other parameters match arecord (ensure format consistency)
    # - &:后台运行(避免终端阻塞): Run in background (prevent terminal blocking)
    
    arecord -D hw:4,0 -r 48000 -c 2 -f s16_le -t raw | aplay -D hw:0,0 -r 48000 -c 2 -f s16_le -t raw &
    

    测试操作与结果验证

    1. 执行命令:在终端输入上述命令并回车;
    2. 触发音频输入:对着 MIC 说话 / 播放声音;
    3. 验证效果:从音频输出设备(扬声器 / 耳机)能实时听到采集的声音,无杂音、卡顿、延迟(<200ms)即为测试通过;
    4. 停止测试:执行kill %1(后台任务编号)终止实时采集。

    *注意事项

    • 若执行报错Device or resource busy:先执行killall arecord aplay关闭占用音频设备的进程,再重新测试;
    • 若无声音:检查-D参数的设备编号(通过arecord -l/aplay -l确认正确的输入 / 输出设备);
    • 若杂音较大:将-c 2改为-c 1(单声道),或调整采样率为44100
    • 系统音频输入通道配置:打开系统声音设置,切换到「Input Devices」(输入设备)标签页,在设备对应的「Port」下拉选项中,选择「Internal Microphone」(内置麦克风),确保音频输入通道已正确启用。

    Image Removed

    、存储接口测试

    1.M.2接口测试

    1.硬件信息完整性

    • 接口类型:M.2 Key M PCIe3.0(兼容 B&M Key 扩展卡,支持 PCIe 4x + USB3.0)
    • 硬件安装:将 M.2 SSD 插入开发板 M.2 插槽

    2.基础连接有效性

    1.设备识别验证


    Test Operations and Result Verification

    Execute Command: Enter the above command in the terminal and press Enter.
     Trigger Audio Input: Speak into the MIC or play audio.
     Verify Effect: Real‑time captured sound can be heard from audio output devices (speakers/headphones). The test passes if there is no noise, stuttering or delay (<200 ms).
     Stop Test: Run kill %1 (background task ID) to terminate real‑time capture.

    Notes

    • If Device or resource busy appears: Run killall arecord aplay to release occupied audio devices, then retry the test.
    • No sound output: Verify the device number of the -D parameter via arecord -l and aplay -l.
    • Excessive noise: Change -c 2 to -c 1 for mono mode, or set the sample rate to 44100.
    • System audio input configuration: Open system sound settings and go to the Input Devices tab. Select Internal Microphone from the Port drop-down list of the target device to enable the audio input channel properly.

    Image Added

    1.M.2 Interface Test

    1. Hardware Information Integrity

     Interface Type: PCIE 2.0 ×1 M.2 M‑Key, 5 Gbps
     Hardware Installation: Insert the M.2 SSD into the M.2 slot on the development board.
     

    2. Basic Connection Validity

    1. Device Identification Verification

    代码块
    languageshell
    titlebash
    # 查看系统是否识别到MCheck whether the system recognizes the M.2 SSD.
    lsblk

    预期结果:输出中显示 SSD 对应的磁盘设备(如nvme0n1)。Expected Result: The corresponding disk device of the SSD (e.g., nvme0n1) is displayed in the output.

    2.磁盘信息读取Disk Information Reading

    代码块
    languageshell
    titlebash
    # 查看M.2 SSD的详细信息(如容量、接口协议) Check detailed information of the M.2 SSD (e.g., capacity, interface protocol).
    sudo fdisk -l

    预期结果:显示 SSD 的容量、分区表类型(如 GPT),接口协议为PCIe 3.0 x4

    3.读写性能测试

    Expected Result: Display SSD capacity, partition table type (e.g., GPT), PCIe x4 bus and NVMe storage protocol.
     3. Read‑Write Performance Test

    代码块
    languageshell
    titlebash
    # Install Test 安装测试工具Tools
    sudo apt install hdparm fio
    
    # 测试读取性能Test Read Performance
    sudo hdparm -tT /dev/nvme0n1 # Replace with your actual # 替换为实际SSD设备名
    SSD device name
    # 测试随机读写性能(示例:1GB数据)Test Random Read/Write Performance (Example: 1GB data)
    fio --name=ssd-test --filename=/dev/nvme0n1 --size=1G --rw=randrw --bs=4k --numjobs=4 --iodepth=64 --runtime=30 --time_based
    3

    4.

    结果判定标准
  • 设备识别:lsblk显示 SSD 设备→识别成功;
  • Judgment Criteria

    接口协议:
    • Device detection: The SSD is displayed via lsblk → Detection succeeded.
    • Interface protocol:
    • fdisk -l
    显示
    • shows PCIe 3.0 x4
    →接口匹配;
  • 性能达标:读取速度≥1000MB/s(PCIe3.0 SSD 典型值)→性能正常。
    • → Interface matches.
    • Performance requirement: Read speed ≥ 1000MB/s (typical value for PCIe 3.0 SSD) → Performance normal.


    2. SATA Interface Test

    2.1 Hardware Connection Description

    Connect the hard drive via standard 7-pin SATA 3.0 interface. The SATA power supply supports 5V 2A output.

    2.2 Hard Drive Detection & Health Check

    2.SATA接口测试

    1.硬件连接说明

    通过标准 7Pin SATA3.0 接口连接硬盘,SATA 电源支持 5V 2A 输出

    2.硬盘识别与健康状态检测

    代码块
    languageshell
    titlebash
    # 查看硬盘信息及SMART健康状态 View hard drive information and SMART status
    fdisk -l
    
    #更新软件源(可选,避免安装失败)# Update software sources (optional, to avoid installation failure)
    apt update
    # 若提示权限不足,先提权(已 root 可跳过) Elevate privileges if permission denied (skip if already root)
    # sudo apt update
    
    #安装# Install smartmontools
    apt install -y smartmontools
    
    # 注:Note: /dev/sda为实际识别的SATA设备节点,需根据系统显示调整
     sda is the actual SATA device node, adjust according to system output
    smartctl -a /dev/sda  

    测试结果验证

    1.设备识别状态

    Test Result Verification


    1. Device detection: fdisk -l
     输出中需显示 SATA 硬盘的容量、分区等信息;2.SMART 健康状态smartctl -a 输出中
    1. shall display the capacity and partition information of the SATA hard drive.
    2. SMART health status: The item SMART overall-health self-assessment test result
    项需显示为PASSED(如图中红框标注项)。
    1. in smartctl -a output shall show PASSED.


    VII. Wireless Communication Module Test

    六、无线通信模块测试

    1.

    WIFI测试

    Wi‑Fi Test

    1.

    硬件规格符合性WiFi 型号:AP6275P,支持 WiFi6(IEEE

    Hardware Specification Compliance

    WiFi Model: AP6275P. It supports Wi-Fi 6 (IEEE 802.11a/b/g/n/ac/ax

    MIMO),双发双收。2.基础连接稳定性

    MIMO) with 2T2R (2 Transmit, 2 Receive).
     2. Basic Connection Stability

    1. 启动NetworkManager服务Start the NetworkManager Service

    代码块
    languageshell
    titlebash
    sudo systemctl start NetworkManager

    2.扫描并连接WiFi网络Scan and connect to Wi‑Fi networks

    代码块
    languageshell
    titlebash
    sudo nmcli dev wifi rescan                 # 重新扫描WiFi网络
    sudo nmcli dev wifi list                   # 查看可用WiFi列表(可选)
    sudo nmcli dev wifi connect "WiFi名称" password "WiFi密码" ifname wlan1

    3.网络连通性测试Network Connectivity Test

    代码块
    languageshell
    titlebash
    ping www.baidu.com

    4.示例命令Sample Commands

    代码块
    languageshell
    titlebash
    sudo nmcli dev wifi connect "Hi nova 9 Pro" password "12345678" ifname wlan1

    3. Wi-Fi

    网络

    Network TCP/UDP

    协议性能测试

    Protocol Performance Test

    1. 环境准备:

    两台测试设备(如开发板 + PC),确保处于同一网络(WiFi / 以太网);

    安装 Iperf3

    Environment Preparation:

     
    Two test devices (e.g., development board + PC), ensure they are on the same network (Wi-Fi/Ethernet);
     Install Iperf3

    3.Wi-Fi 网络

    代码块
    languageshell
    titlebash
    # Debian/Ubuntu
    sudo apt install iperf3

    2. 角色定义:

    服务端(Server):接收数据的设备;

    客户端(Client):发送数据的设备。Role Definition Server: Device receiving data
     Client: Device sending data 

    3. TCP 带宽测试(常用)

    步骤 1:启动服务端

    Bandwidth Test (Commonly Used)

    Step 1: Start the server

    代码块
    languageshell
    titlebash
    # 服务端默认监听5201端口 The server listens on port 5201 by default
    iperf3 -s

    步骤 2:客户端发起测试Step 2: Initiate the test from the client

    代码块
    languageshell
    titlebash
    # 测试TCP带宽(持续10秒,默认) Test TCP bandwidth (default duration: 10 seconds)
    iperf3 -c [服务端IPServer IP]

    扩展命令(自定义参数)Extended Commands (Custom Parameters)

    代码块
    languageshell
    titlebash
    # 测试30秒,每2秒输出一次实时数据Test for 30 seconds, output real-time data every 2 seconds
    iperf3 -c [服务端IPServer IP] -t 30 -i 2
    # 测试双向带宽(服务端/客户端互传) 30 -i 2
    
    # Test bidirectional bandwidth (simultaneous upload and download)
    iperf3 -c [服务端IPServer IP] -d

    4. UDP 丢包 Packet Loss / 延迟测试Latency Test

    Step 1: Start the server步骤 1:启动服务端

    代码块
    languageshell
    titlebash
    iperf3 -s

    步骤 2:客户端发起测试Step 2: Initiate test from the client

    代码块
    languageshell
    titlebash
    # 测试UDP(指定带宽100Mbps) Test UDP with specified bandwidth 100Mbps
    iperf3 -c [服务端IPServer IP] -u -b 100M

    5. 结果解读(示例)Result Interpretation (Examples)

    TCP 测试结果Test Result

    代码块
    languageshell
    titlebash
    [  5] local 192.168.1.10 port 5001 connected to 192.168.1.20 port 5201
    [ ID] Interval           Transfer     Bitrate
    [  5]   0.00-10.00  sec  1.10 GBytes   943 Mbits/sec  # Actual bandwidth: 实际带宽:943Mbps943Mbps

    UDP测试结果UDP Test Result

    代码块
    languageshell
    titlebash
    [  5] local 192.168.1.10 port 5001 connected to 192.168.1.20 port 5201
    [ ID] Interval           Transfer     Bitrate         Jitter    Lost/Total Datagrams
    [  5]   0.00-10.00  sec  119 MBytes   100 Mbits/sec  0.035 ms  0/85000 (0%)  # 丢包率:0%

     6.常见场景测试Common‑Scenario Tests

    测试目标
    Test Objective
    命令示例长连接稳定性(1 小时)
    Command Example
    Long connection stability (1 hour)iperf3 -c [IP] -t 3600
    多线程并发测试
    Multi-thread concurrent testiperf3 -c [IP] -P 4
    (4 线程)限制带宽测试
    (4 threads)
    Bandwidth limit testiperf3 -c [IP] -b 500M
    (限制为 500Mbps)
    (limited to 500Mbps)


    2.

    蓝牙连接测试

    Bluetooth Connection Test 

    1.

    硬件说明

    Hardware Description 
    AP6256 is a Wi‑Fi 5 + Bluetooth dual‑mode module launched by AMPAK, supporting Bluetooth 5.2.
     

    2. Enter Bluetooth Command Mode

    默认适配 AP6275P 蓝牙模块(支持蓝牙 5.2)

    2.进入蓝牙命令模式

    代码块
    languageshell
    titlebash
    # 通过adb连接设备 Connect to the device via ADB
    adb shell
    
    # 启动蓝牙控制工具Launch the Bluetooth control utility
    sudo bluetoothctl

    3.扫描并连接蓝牙设备Scan and Connect Bluetooth Devices

    代码块
    languageshell
    titlebash
    scan on # Enable Bluetooth scanning (press Ctrl+C to               # 开启蓝牙扫描(按Ctrl+C停止扫描)stop scanning)
    trust [设备MAC地址]Device MAC Address] # Trust the     # 信任目标设备target device
    pair [设备MAC地址]Device MAC Address] # Pair with the     # 配对目标设备target device
    connect [设备MAC地址]Device MAC Address] # Connect to the target # 连接目标设备device

    4.操作示例Operation Example

    代码块
    languageshell
    titlebash
    titlebash
    # Perform operations on the device with MAC 7C# 扫描后,对MAC为7C:B4:37:11:5B:83的设备执行操作83 after scanning
    trust 7C:B4:37:11:5B:83
    pair 7C:B4:37:11:5B:83
    connect 7C:B4:37:11:5B:83

    5.测试结果判定Test Result Judgment

    After executing the connect command, the terminal outputs 执行connect后,终端输出[CONN] Device 7C:B4:37:11:5B:83 Connected: yes,表示蓝牙连接成功。, indicating successful Bluetooth connection.

    3.

    4G模块测试

    4G Module Test

    验证 4G 模块对应的Verify the startup, auto-start configuration and network connectivity of the quectel.service服务的启动、自启配置及网络连通性。 for the 4G module。

    1.检查初始状态Check Initial Status

    代码块
    languageshell
    titlebash
    # 查看服务当前状态 Check current service status
    systemctl status quectel.service
    
    # 检查开机自启配置 Check auto-start configuration
    systemctl is-enabled quectel.service

    预期结果

    服务未运行,开机自启未设置

    Expected Result
     The service is inactive and auto-start is disabled.

    2. 启动服务Start the Service

    代码块
    languageshell
    titlebash
    # 启动quectel服务Start quectel service
    systemctl start quectel.service
    
    # 验证服务状态Verify service status
    systemctl status quectel.service

    预期结果

    务状态显示为 Expected Result
     The service status shows active (running).

    3.设置开机自启Configure Auto-Start

    代码块
    languageshell
    titlebash
    titlebash
    # Enable service auto-start on boot# 配置服务开机自启
    systemctl enable quectel.service
    
    # 验证自启配置Verify auto-start setting
    systemctl is-enabled quectel.service

    预期结果

    自启配置返回 enabledExpected Result
     The command returns enabled.

    4. 重启验证Reboot Verification

    代码块
    languageshell
    titlebash
    # 重启设备Reboot the device
    reboot
    
    # 重启后检查服务状态 Check service status after reboot
    systemctl status quectel.service

    预期结果

    设备重启后,服务自动运行,状态显示为 

    Expected Result
     The service runs automatically after reboot with status active (running).

    5. 网络连通性测试Network Connectivity Test

    代码块
    languageshell
    titlebash
    # 检查4G模块网络接口(以eth0为例,实际需根据模块接口调整) Check 4G network interface (take eth0 as example, adjust according to actual interface)
    ifconfig -a
    
    # 测试网络连通性(ping公网地址) Test network connectivity by pinging public address
    ping -c 5 8.8.8.8

    预期结果

    4G网络接口正常获取 IP;

    ping 测试成功,返回类似如下结果(无丢包):

    Expected Result

    • The 4G interface obtains a valid IP address normally.
    • Ping test succeeds with no packet loss, sample output as below:
    代码块
    languageshell
    titlebash
    PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
    64 bytes from 8.8.8.8: icmp_seq=1 ttl=109 time=60 ms
    64 bytes from 8.8.8.8: icmp_seq=2 ttl=109 time=60 ms
    64 bytes from 8.8.8.8: icmp_seq=3 ttl=109 time=60 ms
    64 bytes from 8.8.8.8: icmp_seq=4 ttl=109 time=60 ms
    64 bytes from 8.8.8.8: icmp_seq=5 ttl=109 time=60 ms

    4.

    SIM卡功能验证

    SIM Card Function Verification

    1.

    测试准备

    硬件:已完成测试的 4G 模块、插入目标 4G SIM 卡的设备;

    系统:确保quectel.service服务处于

    Test Preparation

    • Hardware: Fully tested 4G module and device with target 4G SIM card inserted.
    • System: Ensure quectel.service is in active (running)
    状态。
    • state.

    2.

    SIM卡网络状态

    SIM Card Network Status

    代码块
    languageshell
    titlebash
    # 步骤1:查看wwan0接口的链路状态(确认接口是否激活)Step 1: Check link status of wwan0 interface
    ip link show wwan0
    
    # 步骤2:查看wwan0的IP地址信息(确认网络是否获取到地址)Step 2: Check IP address of wwan0 interface
    ip addr show wwan0
    
    # 步骤3:测试SIM网络的外部连通性(指定从wwan0接口发起请求) Step 3: Test external network connectivity via wwan0
    ping -c 4 -I wwan0 www.baidu.com

    3.

    结果说明

    Result Description

    步骤 1 输出中,若wwan0状态为
    • Step 1: Status UP,LOWER_UP
    ,表示接口已激活;

    步骤 2 输出中,若wwan0存在inet开头的 IP 地址,说明网络已成功分配地址;

    步骤 3 若返回
    • means the interface is activated.
    • Step 2: An address starting with inet indicates the interface has obtained an IP address successfully.
    • Step 3: Output starting with 64 bytes from xxx.xxx.xxx.xxx
    ,表示 SIM 网络连通正常。
    • means the SIM network works normally.