@@ -85,17 +86,18 @@ adb push E:\eage\test.mp3 /sdcard/Music #Push audio to the Music directory of th
su #Switch to root user
am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/Music/test.mp3 #Rescan this file in the media library
```
-2. For specific configuration, please navigate sequentially to: `**Android** Desktop -> File Manager -> Play Audio`.
-
-
-
-
-
-
-
-
-
-
+2. For specific configuration, please navigate sequentially to: `**Android** Desktop → File Manager → Play Audio`.
+
+
+
+
+
+
+
+
+
+
+
## Application scenarios
@@ -112,26 +114,28 @@ To view system logs, connect the serial cable to the computer and use a serial t
### Black screen issue
After properly connecting the device and powering it on, if the display shows a **black screen**, it could be due to the following situations:
-1. Power connection issue
+
+1. **Power connection issue:**
Check if the display's power supply interface is properly connected. Confirm that at least one of the four power supply interfaces is correctly connected, ensure the power screw is tightened, and the pogo pin makes good contact with the 40-pin interface.
-2. Connection issue
+2. **Connection issue:**
Check if the MIPI cable is properly inserted and firmly connected. Confirm the cable direction is correct to avoid reverse insertion. Check if the connector has physical damage.
-3. System boot issue
+3. **System boot issue:**
Confirm that the system has booted normally and loaded the display service. Check system logs to confirm whether the display driver is loaded properly.
### Screen artifact issue
After properly connecting the device and powering it on, if the display shows a **screen artifact**, it could be due to the following situations:
-1. Signal interference
+1. **Signal interference:**
Check if the MIPI cable is too long or of poor quality. Confirm there are no strong electromagnetic interference sources around the cable. Try replacing with a high-quality MIPI cable.
-2. Hardware compatibility issue
+2. **Hardware compatibility issue:**
Confirm that the display model used is fully compatible with the **Quectel Pi M1**. Check if the display firmware version is the latest version.
### Touch function abnormality
If the touch function is abnormal, it could be due to the following situation:
-1. Driver issue
+
+1. **Driver issue:**
Confirm that the system has correctly loaded the touchscreen driver. Check if the I2C communication is established properly.
\ No newline at end of file
diff --git a/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/adc.md b/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/adc.md
index e4219b0f101bfa05947f78b7169542e885bceafb..4ee73a6b10265eeaa66450fafdb36f9fd017d7c2 100755
--- a/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/adc.md
+++ b/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/adc.md
@@ -1,6 +1,6 @@
# ADC overview
-The ADC subsystem includes signal multiplexing and a voltage analog-to-digital converter (VADC). It is a multiplexed network that routes internal and external signals to the VADC.
+The ADC subsystem consists of a signal multiplexer and a voltage analog-to-digital converter (VADC). It routes internal and external analog signals to the VADC through a multiplexed architecture and converts them into digital values.
## ADC module hardware architecture
@@ -17,12 +17,12 @@ The module supports the following ADC channels:
## ADC interface location
-The location of the ADC interfaces on the smart single-board computer is shown below:
+The location of the ADC interface on the smart main control board is shown below:
-
ADC location on the smart single-board computer
+
ADC interface location on the smart main control board
@@ -30,13 +30,25 @@ The location of the ADC interfaces on the smart single-board computer is shown b
The ADC nodes are mainly used to read the ADC values at the corresponding input nodes.
-### Usage
+### Usage method
-Test method: use an adjustable DC power supply as the input signal source. Connect the positive terminal of the power supply to the ADC0 or ADC1 pin, and connect the power supply ground (GND) to the development board's GND.
-- **ADC0**: connected to GPIO4, corresponding node `in_voltage_adc_gpio4_input`, supported input voltage range is approximately **0–5.25 V**.
-- **ADC1**: connected to GPIO7, corresponding node `in_voltage_adc_gpio7_input`, supported input voltage range is approximately **0–5.25 V**.
+For testing: use an adjustable DC power supply as the input signal source:
-After setting the DC power output to an arbitrary voltage, you can read the returned ADC value (in μV) using the following commands:
+- Connect the **positive terminal** of the power supply to the **ADC0** or **ADC1** pin.
+- Connect the **power supply ground (GND)** to the **GND** of the smart main control board.
+
+Channel mapping and input characteristics are as follows:
+
+- **ADC0**:
+ - Mapped to GPIO4
+ - Corresponding node: `in_voltage_adc_gpio4_input`
+ - Supported input voltage range: Approximately **0–5.25 V**.
+- **ADC1**:
+ - Mapped to GPIO7
+ - Corresponding node: `in_voltage_adc_gpio7_input`
+ - supported input voltage range: Approximately **0–5.25 V**.
+
+After setting the DC power supply to the desired voltage, the ADC sampling result can be read using the following commands (unit: μV):
```bash
adb shell
@@ -52,7 +64,7 @@ cat in_voltage_adc_gpio7_input
-### Test code
+### Sample test code
The following sample code demonstrates how to read the ADC value in an application. It opens the ADC node file, reads the raw ADC value (in μV), and converts it to an integer for further processing.
diff --git a/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/audio.md b/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/audio.md
index 0ce6f3f449f064bea8e3bde7809d97e66e100084..e2a4273ccf87b3cfb82e87f81ced2a6eec5fcb68 100755
--- a/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/audio.md
+++ b/docs/Quectel-Pi-M1/en/User-Guide/Peripheral-Guide/audio.md
@@ -1,7 +1,13 @@
# Audio function
+This document provides a concise operational guide for the **Linux** audio system. The system adopts a dual audio backend architecture based on **ALSA** and **PulseAudio**, delivering a complete audio solution from the driver layer up to the application layer.
-This document provides a concise guide to operating the **Linux** audio system. We adopt a dual-architecture audio backend with **ALSA** and **PulseAudio**, providing a complete audio solution from bottom level to application layer. In terms of hardware, external microphone input (via external **SH1.0-4P** audio to headset interface) and external speaker output are supported, enabling full-duplex communication for headset playback and microphone input. On the software side, the following audio configuration commands are provided to ensure optimal audio output. Through this document, you will learn how to use basic command-line tools to quickly complete daily operations such as audio device checking, recording and playback, volume control, etc., solving most audio-related issues without delving into complex configurations.
+At the hardware level, the system supports:
+- External microphone input (via external **SH1.0-4P** audio-to-headset interface)
+- External speaker/headset output, enabling full-duplex communication for headset playback and microphone input.
+At the software level, a set of standard audio configuration and control commands is provided to support common operations such as device inspection, audio recording, playback, and volume control.
+
+By following this guide, you can complete most audio-related tasks using basic command-line tools, without the need for complex audio configuration.
## Hardware interface
@@ -16,36 +22,40 @@ This document provides a concise guide to operating the **Linux** audio system.
## View sound card information
-- Enter the following command in the terminal to check the sound card mounting status:
-
+Use the following commands to verify that the audio devices and PCM streams are correctly registered in the system.
+
+- Check the list of detected sound cards:
+
```shell
cat /proc/asound/cards
```
-- Enter the following command in the terminal to view the assigned **pcm** stream list:
+- Check the list of assigned **pcm** streams:
```shell
cat /proc/asound/pcm
```
-- If there is no sound card information and **pcm** stream list, both **ALSA** and **PulseAudio** functions will be unavailable.
+> Note: If no sound card information or PCM streams are present, both **ALSA** and **PulseAudio** will be unavailable.
## Function usage
### Audio recording
-**Linux** needs to modify the configuration **/etc/backend_conf.xml** on the smart single-board computer first, which is configured by default.
+On **Linux**, ensure that the audio backend configuration file **/etc/backend_conf.xml** on the smart single-board computer is correctly configured (this is done by default):
```xml
@@ -53,27 +52,26 @@
**Android桌面的视频播放功能**
-1.使用**adb**工具将视频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
-```SHELL
-adb push "E:\FeiShu\Animal World.mp4" /sdcard/DCIM #将相关视频推送到智能主控板SD卡的DCIM目录下
-
-#进入到智能主控板下
-su #切换到root用户
-am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/DCIM/Animal World.mp4 #重新扫描媒体库的这个文件
-```
-2.具体配置请依次进入：`Android 桌面->文件管理器->视频文件->播放视频`。
-
-
-
-
-
-
-
-
-
-
-
-
+1. 使用**adb**工具将视频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
+ ```SHELL
+ adb push "E:\FeiShu\Animal World.mp4" /sdcard/DCIM #将相关视频推送到智能主控板SD卡的DCIM目录下
+
+ #进入到智能主控板下
+ su #切换到root用户
+ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/DCIM/Animal World.mp4 #重新扫描媒体库的这个文件
+ ```
+
+2. 具体配置请依次进入：`Android 桌面->文件管理器->视频文件->播放视频`。
+
+
+
+
+
+
+
+
+
+
### 音频播放功能
@@ -81,29 +79,28 @@ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/
>**注**：播放音频需要在**Quectel Pi M1**智能主控板上将喇叭连接。
-1.使用**adb**工具将音频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
+1. 使用**adb**工具将音频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
-```SHELL
-adb push E:\eage\test.mp3 /sdcard/Music #将音频推送到智能主控板SD卡的Music目录下
-
-#进入到智能主控板下
-su #切换到root用户
-am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/Music/test.mp3 #重新扫描媒体库的这个文件
-```
-2.具体配置请依次进入：`Android 桌面->文件管理器->播放音频`。
-
-
-
-
-
-
-
-
-
-
-
-
+ ```SHELL
+ adb push E:\eage\test.mp3 /sdcard/Music #将音频推送到智能主控板SD卡的Music目录下
+
+ #进入到智能主控板下
+ su #切换到root用户
+ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/Music/test.mp3 #重新扫描媒体库的这个文件
+ ```
+
+2. 具体配置请依次进入：`Android 桌面->文件管理器->播放音频`。
+
+
+
+
+
+
+
+
+
+
## 进阶功能
@@ -113,21 +110,21 @@ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/
### 热插拔使用方法
-1.在系统运行状态下，直接将**HDMI**屏幕插入智能主控板的**HDMI**接口。
-2.系统会自动检测到**HDMI**设备并启动显示输出。
-3.如需断开**HDMI**屏幕，可直接拔出**HDMI**线缆，系统会自动切换显示输出。
+1. 在系统运行状态下，直接将**HDMI**屏幕插入智能主控板的**HDMI**接口。
+2. 系统会自动检测到**HDMI**设备并启动显示输出。
+3. 如需断开**HDMI**屏幕，可直接拔出**HDMI**线缆，系统会自动切换显示输出。
### 热插拔注意事项
-1.热插拔功能仅支持通过**HDMI**接口连接的显示屏。
-2.使用DP转**HDMI**适配器连接的屏幕可能无法正常支持热插拔。
-3.在插拔过程中请避免频繁操作，建议每次插拔间隔不少于5秒。
+1. 热插拔功能仅支持通过**HDMI**接口连接的显示屏。
+2. 使用DP转**HDMI**适配器连接的屏幕可能无法正常支持热插拔。
+3. 在插拔过程中请避免频繁操作，建议每次插拔间隔不少于5秒。
## 应用场景
- - **媒体娱乐终端**: 使用**Quectel Pi M1**智能主控板作为媒体娱乐终端，可以播放视频、音乐、查看图片等。
- - **工业数据可视化平台**: 使用**Quectel Pi M1**智能主控板作为工业数据可视化平台，可以显示工业数据、监控设备运行情况、进行数据处理等。
- - **智能交互终端**：使用**Quectel Pi M1**智能主控板作为智能交互终端，可以使用于各类的人机交互应用。
+- **媒体娱乐终端**: 使用**Quectel Pi M1**智能主控板作为媒体娱乐终端，可以播放视频、音乐、查看图片等。
+- **工业数据可视化平台**: 使用**Quectel Pi M1**智能主控板作为工业数据可视化平台，可以显示工业数据、监控设备运行情况、进行数据处理等。
+- **智能交互终端**：使用**Quectel Pi M1**智能主控板作为智能交互终端，可以使用于各类的人机交互应用。
## 疑难解答
@@ -138,21 +135,23 @@ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/
### 黑屏问题
在正常连接好设备后，开机后显示**黑屏**，可能是以下的情况：
-1.电源连接问题
+
+1. **电源连接问题：**
检查显示屏的供电接口是否正确连接，确认电源适配器已正确连接并供电。
-2.连接线路问题
+2. **连接线路问题：**
检查**HDMI**线缆是否正确连接并牢固插入，确认**HDMI**线缆方向是否正确，避免插反，检查连接器是否有物理损坏。
-3.系统启动问题
+3. **系统启动问题：**
确认系统已正常启动并加载显示服务，查看系统日志确认显示驱动是否正常加载。
-4.分辨率兼容问题
+4. **分辨率兼容问题：**
检查显示器支持的分辨率是否与系统输出分辨率匹配，必要时手动调整分辨率设置。
### 花屏问题
在正常连接好设备后，开机后显示**花屏**，可能是以下的情况：
-1.信号干扰
+
+1. **信号干扰：**
检查HDMI线缆是否过长或质量不佳，确认线缆周围是否有强电磁干扰源，尝试更换高质量的HDMI线缆。
-2.硬件兼容性问题
+2. **硬件兼容性问题：**
确认使用的显示屏型号与**Quectel Pi M1**完全兼容，检查显示屏固件版本是否为最新版本。
-3.接口接触不良
+3. **接口接触不良：**
检查HDMI接口是否存在松动或氧化现象，重新插拔HDMI线缆确保连接牢固。
diff --git a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/Mipi.md b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/Mipi.md
index 901b867b337be62a8fc7bb45fe61c2a4f3c69cf9..0826739c127e1fa4214061c84b90defdf8d960ef 100644
--- a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/Mipi.md
+++ b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/Mipi.md
@@ -1,6 +1,6 @@
# MIPI
-本文档详细介绍了**Quectel Pi M1**智能主控板的**MIPI—DSI**显示屏使用方法，并以微雪**8-inch DSI**接口**IPS**电容触摸屏为例进行详细说明。
+本文档详细介绍了**Quectel Pi M1**智能主控板的**MIPI—DSI**显示屏使用方法，并以微雪**8-inch DSI**接口**IPS**电容触摸屏为例进行详细说明。
## MIPI屏幕连接
@@ -31,13 +31,15 @@
连接上**MIPI**显示器并且上电开机后，可以直接使用触摸功能。
### 调整音频和显示
-音频具体配置请依次进入：`Android 桌面→ 菜单 → 设置 → 提示音和震动`，即可对音频进行设置。
+音频具体配置请依次进入：`Android 桌面 → 菜单 → 设置 → 提示音和震动`，即可对音频进行设置。
+
-显示具体配置请依次进入：`Android 桌面→ 菜单 → 设置 → 显示 ` 即可对显示进行设置。
+显示具体配置请依次进入：`Android 桌面 → 菜单 → 设置 → 显示 ` 即可对显示进行设置。
+
@@ -49,61 +51,61 @@
**Android桌面的视频播放功能**
-1.使用**adb**工具将视频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
-```SHELL
-adb push "E:\FeiShu\Animal World.mp4" /sdcard/DCIM #将相关视频推送到智能主控板SD卡的DCIM目录下
-
-#进入到智能主控板下
-su #切换到root用户
-am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/DCIM/Animal World.mp4 #重新扫描媒体库的这个文件
-```
-2.具体配置请依次进入：`Android 桌面->文件管理器->视频文件->播放视频`。
-
-
-
-
-
-
-
-
-
-
+1. 使用**adb**工具将视频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
+ ```SHELL
+ adb push "E:\FeiShu\Animal World.mp4" /sdcard/DCIM #将相关视频推送到智能主控板SD卡的DCIM目录下
+
+ #进入到智能主控板下
+ su #切换到root用户
+ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/DCIM/Animal World.mp4 #重新扫描媒体库的这个文件
+ ```
+2. 具体配置请依次进入：`Android 桌面 → 文件管理器 → 视频文件 → 播放视频`。
+
+
+
+
+
+
+
+
+
+
+
### 音频播放功能
**Android桌面的音频播放功能**：
>**注**：播放音频需要在**Quectel Pi M1**智能主控板上将喇叭连接。
-
-
-1.使用**adb**工具将音频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
-
-
-```SHELL
-adb push E:\eage\test.mp3 /sdcard/Music #将音频推送到智能主控板SD卡的Music目录下
-
-#进入到智能主控板下
-su #切换到root用户
-am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/Music/test.mp3 #重新扫描媒体库的这个文件
-```
-2.具体配置请依次进入：`Android 桌面->文件管理器->播放音频`。
-
-
-
-
-
-
-
-
-
-
+
+1. 使用**adb**工具将音频文件推送到智能主控板。**adb**使用方法请参考[快速入门章节](../Getting-Started/getting-started.md)**adb**使用介绍。
+
+ ```SHELL
+ adb push E:\eage\test.mp3 /sdcard/Music #将音频推送到智能主控板SD卡的Music目录下
+
+ #进入到智能主控板下
+ su #切换到root用户
+ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/Music/test.mp3 #重新扫描媒体库的这个文件
+ ```
+2. 具体配置请依次进入：`Android 桌面 → 文件管理器 → 播放音频`。
+
+
+
+
+
+
+
+
+
+
+
## 应用场景
- - **媒体娱乐终端**: 使用**Quectel Pi M1**智能主控板作为媒体娱乐终端，可以播放视频、音乐、查看图片等。
- - **工业数据可视化平台**: 使用**Quectel Pi M1**智能主控板作为工业数据可视化平台，可以显示工业数据、监控设备运行情况、进行数据处理等。
- - **智能交互终端**：使用**Quectel Pi M1**智能主控板作为智能交互终端，可以使用于各类的人机交互应用。
+- **媒体娱乐终端**: 使用**Quectel Pi M1**智能主控板作为媒体娱乐终端，可以播放视频、音乐、查看图片等。
+- **工业数据可视化平台**: 使用**Quectel Pi M1**智能主控板作为工业数据可视化平台，可以显示工业数据、监控设备运行情况、进行数据处理等。
+- **智能交互终端**：使用**Quectel Pi M1**智能主控板作为智能交互终端，可以使用于各类的人机交互应用。
## 疑难解答
@@ -114,24 +116,29 @@ am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/
### 黑屏问题
在正常连接好设备后，开机后显示**黑屏**，可能是以下的情况：
-1.电源连接问题
+1. **电源连接问题：**
检查显示屏的供电接口是否正确连接，确认4个供电接口中至少有一个已正确连接，确保供电螺丝已拧紧，顶针与40-pin接口接触良好。
-2.连接线路问题
+
+2. **连接线路问题：**
检查MIPI排线是否正确插入并牢固连接，确认排线方向是否正确，避免插反，检查连接器是否有物理损坏。
-3.系统启动问题
+
+3. **系统启动问题：**
确认系统已正常启动并加载显示服务，查看系统日志确认显示驱动是否正常加载。
### 花屏问题
在正常连接好设备后，开机后显示**花屏**，可能是以下的情况：
-1.信号干扰
+
+1. **信号干扰：**
检查MIPI排线是否过长或质量不佳，确认排线周围是否有强电磁干扰源，尝试更换高质量的MIPI排线。
-2.硬件兼容性问题
+
+2. **硬件兼容性问题：**
确认使用的显示屏型号与**Quectel Pi M1**完全兼容，检查显示屏固件版本是否为最新版本。
### 触摸功能异常
触摸功能异常，可能是以下情况：
-1.驱动问题
+
+1. **驱动问题：**
确认系统已正确加载触摸屏驱动，检查I2C通信是否正常建立。
diff --git a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/adc.md b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/adc.md
index ae4c47dc3cef76317cdf17ee5d26fc2228f6d4a4..510d00ac934c991fc5bb10a37e2387c3070b3b4c 100644
--- a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/adc.md
+++ b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/adc.md
@@ -1,6 +1,6 @@
# ADC简介
-ADC子系统包括信号复用和电压模数转换器（VADC），是一种将内部和外部信号路由到VADC的多路复用网络。
+ADC 子系统由信号复用器和电压模数转换器（VADC）组成，用于将内部及外部模拟信号通过多路复用方式路由至 VADC，并完成模拟量到数字量的转换。
## ADC模块硬件架构图
@@ -32,11 +32,23 @@ ADC节点主要用来查看该节点输入的ADC数值。
### 使用方法
-测试方法为：使用可调直流电源作为输入信号源，将电源正极连接到ADC0或ADC1引脚，电源GND与智能主控板GND相连。
-- **ADC0**：连接到GPIO4，对应节点`in_voltage_adc_gpio4_input`，支持输入电压范围约**0~5.25 V**。
-- **ADC1**：连接到GPIO7，对应节点`in_voltage_adc_gpio7_input`，支持输入电压范围约**0~5.25 V**。
+测试时使用可调直流电源作为输入信号源：
-将直流电源输出设置为任意电压后，可通过下面命令读取返回的ADC值（单位为μV）：
+- 将电源**正极**连接到**ADC0**或**ADC1**引脚。
+- 电源**GND**与智能主控板**GND**相连。
+
+各通道对应关系及输入特性如下：
+
+ - **ADC0**：
+ - 连接到GPIO4
+ - 节点：`in_voltage_adc_gpio4_input`
+ - 支持输入电压范围：约**0~5.25 V**
+ - **ADC1**：
+ - 连接到GPIO7
+ - 节点：`in_voltage_adc_gpio7_input`
+ - 支持输入电压范围：约**0~5.25 V**
+
+设置直流电源输出为目标电压后，可通过以下命令读取 ADC 采样结果（单位：μV）：
```bash
adb shell
@@ -54,7 +66,7 @@ cat in_voltage_adc_gpio7_input
### 测试代码
-以下示例代码演示了如何在应用程序中读取ADC值。该代码通过打开ADC节点文件，读取ADC原始值（单位为μV），并将其转换为整数进行后续处理。
+以下示例代码演示了在应用程序中读取 ADC 电压值的基本方法。程序通过访问ADC对应的节点文件，读取ADC原始值（单位为 μV），并转换为整数以供后续处理。
点击展开/折叠：ADC读取测试代码（可自行NDK编译）
diff --git a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/audio.md b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/audio.md
index df240a5fce57a373ac6a854ded1667c5f2e6ae80..c5b24d80dab612563dbd11bedc2187b9140dd0c6 100644
--- a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/audio.md
+++ b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/audio.md
@@ -1,6 +1,14 @@
# 音频功能
-本文档提供**Linux**音频系统操作的简明指南，我们采用**ALSA**与**PulseAudio**双架构音频后端，提供从底层到应用层的完整音频解决方案。硬件上，支持外置麦克风输入（外接**SH1.0-4P**音频转耳机接口）、外置扬声器输出，可实现耳机播放与麦克风输入的全双工通信，软件上提供以下音频配置命令，保证音频的完美输出。通过本文档，您将学习如何使用基础命令行工具快速完成音频设备检查、录音播放、音量控制等日常操作，无需深入复杂配置即可解决大多数音频相关问题。
+本文档提供**Linux**音频系统操作的简明指南。系统采用**ALSA + PulseAudio**的双层音频架构，从底层驱动到应用层提供完整的音频解决方案。
+
+硬件层面，系统支持：
+- 外置麦克风输入（外接**SH1.0-4P**音频转耳机接口）
+- 外置扬声器/耳机输出，可实现耳机播放与麦克风输入的全双工通信
+
+软件层面，系统提供一组标准音频配置与调试命令，用于完成设备检查、录音、播放和音量控制等常见操作。
+
+通过本文档，您无需深入复杂配置，即可快速定位并解决大多数音频相关问题。
## 硬件接口
@@ -16,36 +24,41 @@
## 查看声卡信息
-- 在终端中输入下面命令，查看声卡的挂载情况：
+可通过以下命令检查系统声卡与 PCM 设备的加载情况：
+
+- 查看声卡列表：
+
```shell
cat /proc/asound/cards
```
-- 在终端中输入下面命令，查看已分配的**pcm**流列表：
+- 查看已分配的**pcm**流列表：
```shell
cat /proc/asound/pcm
```
-- 如果没有声卡信息和**pcm**流列表，则**ALSA**与**PulseAudio**功能都将会无法使用。
+> 说明：若系统未检测到声卡信息或**PCM 流**，则**ALSA**与**PulseAudio**均无法正常工作。
## 功能使用
### 音频录制
-**Linux**需要先在智能主控板上修改配置 **/etc/backend_conf.xml**, 默认已经配置好。
+在**Linux系统**下，需确认智能主控板音频配置文件 **/etc/backend_conf.xml**已正确配置（系统默认已完成配置）：
```xml
```
-**Android**环境默认已配置好。
+
+在**Android系统**中，上述音频配置已默认生效，无需额外修改。
#### 板载麦克风录制
+##### Linux系统下录制
-在**Linux**系统下进行录制前，需要先停止**PulseAudio**服务：
+进行录制前，需要先停止**PulseAudio**服务：
```shell
systemctl stop pulseaudio
@@ -59,7 +72,7 @@ tinymix 'TX_AIF1_CAP Mixer DEC2' '1'
agmcap /data/testMic3.wav -D 100 -d 101 -c 1 -r 48000 -i "CODEC_DMA-LPAIF_RXTX-TX-3"
```
-在**Android**系统下：
+##### Android系统下录制
```shell
tinymix "TX DEC0 MUX" "SWR_MIC"
@@ -73,14 +86,16 @@ agmcap ./testMic3.wav -D 100 -d 101 -c 1 -r 48000 -i "CODEC_DMA-LPAIF_RXTX-TX-3"
```
-按下**Ctrl + Z**结束录音：
+##### 结束录制
+
+按下“**Ctrl**” + “**Z**”结束录音：
-#### 耳机录制
+#### 耳机麦克风录制
-**Linux**：
+##### Linux系统下录制
```shell
systemctl stop pulseaudio
@@ -96,7 +111,7 @@ tinymix "BCS Channel" "CH10"
agmcap /data/rec2.wav -D 100 -d 101 -c 1 -r 48000 -i "CODEC_DMA-LPAIF_RXTX-TX-3"
```
-**Android**:
+##### Android系统下录制
```shell
tinymix "TX DEC0 MUX" "SWR_MIC"
@@ -121,9 +136,7 @@ agmcap ./rec2.wav -D 100 -d 101 –c 1 -r 48000 -i "CODEC_DMA-LPAIF_RXTX-TX-3"
#### 耳机播放
-若使用**3.5mm**耳机进行播放，请输入以下命令：
-
-**Linux**:
+##### Linux系统下播放（3.5 mm耳机）
```shell
systemctl stop pulseaudio
@@ -142,7 +155,7 @@ tinymix "HPHR_RDAC Switch" "1"
agmplay /data/vvdn_ring.wav -D 100 -d 100 -i CODEC_DMA-LPAIF_RXTX-RX-0 -dkv 0xA2000002
```
-**Android**:
+##### Android系统下播放（3.5 mm耳机）
```shell
adb root
diff --git a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/ethernet.md b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/ethernet.md
index a513d134575d3faffa3eedd1f7a5f5dcbffe0cf7..b24cc2ee525b2521b1d3325429a1972ec9e2cb99 100644
--- a/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/ethernet.md
+++ b/docs/Quectel-Pi-M1/zh/User-Guide/Peripheral-Guide/ethernet.md
@@ -1,6 +1,6 @@
# 以太网
-**Quectel Pi M1**智能主控板自带1个标准`RJ45`接口，支持10/100/1000 Mbps通信速率的以太网。
+**Quectel Pi M1**智能主控板自带1个标准**RJ45**接口，支持10/100/1000 Mbps通信速率的以太网。
> 以太网对网线的要求：仅支持直连网线，不支持交叉网线。
@@ -14,35 +14,35 @@
系统默认开启DHCP自动获取网络配置。
-1.终端输入`ifconfig`命令查看网络的接口地址：
+1. 终端输入`ifconfig`命令查看网络的接口地址：
-```
-ifconfig
-```
+ ```
+ ifconfig
+ ```
-输出示例：`inet addr：`后面的`192.168.90.116`为本机的ip地址。
+ 输出示例：`inet addr：`后面的`192.168.90.116`为本机的ip地址。
-
+ 
-2.终端输入`ip route`命令查看网络路由信息：
+2. 终端输入`ip route`命令查看网络路由信息：
-```
-ip route
-```
+ ```
+ ip route
+ ```
-输出示例：
+ 输出示例：
-
+ 
-3.查看**DNS**服务器地址：
+3. 查看**DNS**服务器地址：
-```
-dumpsys connectivity | grep -o ' DnsAddresses: \[[^]]*\]'
-```
+ ```
+ dumpsys connectivity | grep -o ' DnsAddresses: \[[^]]*\]'
+ ```
-输出示例：
+ 输出示例：
-
+ 
## 测试网络
