QuecPython · dustin007442 · Aug 4, 2026 · Aug 4, 2026 · Aug 4, 2026 · Aug 4, 2026
diff --git a/datasheet/QuecPython_Yttrium 开发板介绍 - QuecPython.pdf b/datasheet/QuecPython_Yttrium 开发板介绍 - QuecPython.pdf
diff --git a/datasheet/Quectel_QuecPython_Yttrium开发板_产品规格书_V1.0.1_Preliminary_20260401-.pdf b/datasheet/Quectel_QuecPython_Yttrium开发板_产品规格书_V1.0.1_Preliminary_20260401-.pdf
diff --git a/datasheet/README.md b/datasheet/README.md
@@ -1,5 +1,46 @@
 # 相关资料归集
 
-> 1、开发板规格书、原理图、丝印图
+Yttrium 开发板相关设计资料和规格文档。
+
+## 文件清单
+
+### 原理图与 PCB
+
+| 文件 | 说明 | 页数 |
+|---|---|---|
+| `EG800Z_LCD_SCH_V1.1_20250326.pdf` | 原理图：EG800Z 模块 + LCD + 外设电路 | 7 页 |
+| `EG800Z_LCD_PCB_V1.1_20250326.pdf` | PCB 丝印图：Top 层 + Bottom 层 | 2 页 |
+
+> 密码：`quectel`
 >
-> 2、相关元器件datasheet
+> 原理图分页：Sheet 1 封面 / Sheet 2 EG800Z 模块引脚 / Sheet 3 电源 / Sheet 4 USB + RS485 / Sheet 5 LCD + Camera + 音频 / Sheet 6 以太网 + CAN + Flash / Sheet 7 按键 + LED + 蜂鸣器
+
+### 产品文档
+
+| 文件 | 说明 | 页数 |
+|---|---|---|
+| `QuecPython_Yttrium 开发板介绍.pdf` | QuecPython 官方开发板介绍：接口布局、开关说明、基础参数 | 9 页 |
+| `Yttrium开发板_产品规格书_V1.0.1.pdf` | 产品规格书：详细接口表、电气参数、尺寸重量、认证信息 | 22 页 |
+
+## 关键信息速查
+
+### 拨码开关
+
+| 开关 | 功能 |
+|---|---|
+| S0301 | 供电方式选择：DC 5V / USB Type-C |
+| S0401 | 主 UART 连接：USB UART / RS485 |
+| S0601 | SPI0 连接：NET（以太网）/ FLASH |
+| S0705 | 蜂鸣器复用：1-3 导通 → GPIO2 控制蜂鸣器 |
+
+### 接口连接器
+
+| 编号 | 类型 | 信号 |
+|---|---|---|
+| J0501 | 16-pin FPC | LCD（SPI + 触摸 I2C） |
+| J0503 | 6-pin FPC | Camera |
+| J0601 | RJ45 | 以太网 |
+| J0602 | 3-pin 端子 | CAN |
+| J0403 | 3-pin 端子 | RS485 |
+| J0702 | 8-pin 排针 | 预留：MAIN_TXD/RXD、LCD、CTP_INT、GND、ADC |
+| J0703 | 8-pin 排针 | 预留：QSPI、LCD 信号 |
diff --git a/docs/01_introduction/README.md b/docs/01_introduction/README.md
@@ -144,7 +144,7 @@ Yttrium 开发板基于 **Quectel EG800Z QuecOpen** 模组（EC718 系列），
 | 固件包 | `firmware/` |
 | 烧录工具 | `tools/FlashTools_V4.1.19_2509010.zip` |
 | 串口工具 | `tools/sscom5.13.1.zip` |
-| Demo 代码 | `src/yttrium.py` |
+| Demo 代码 | `src/_main.py` + 各功能模块 `.py` |
 | 图标资源 | `icons/`、`images/` |
 | 烧录教程 | [02_firmwareFlashing](../02_firmwareFlashing/README.md) |
 | 运行教程 | [03_runDemo](../03_runDemo/README.md) |
diff --git a/docs/03_runDemo/README.md b/docs/03_runDemo/README.md
@@ -9,7 +9,7 @@
 | 开发板 | 已烧录 QuecPython 固件（参考 [02_firmwareFlashing](../02_firmwareFlashing/README.md)） |
 | PC 工具 | QPYCOM（QuecPython 串口交互工具） |
 | 硬件连接 | 开发板通过 USB 线连接至 PC |
-| 代码文件 | `src/yttrium.py` + `icons/` + `images/` |
+| 代码文件 | `src/` 下所有 `.py` 文件 + `icons/` + `images/` |
 
 ## QPYCOM 连接设备
 
@@ -65,21 +65,48 @@ hello world
 
 ```
 U:/
-├── yttrium.py       # 主应用
+├── _main.py         # 入口文件（PAGE_MAP + MainScreen + YttriumApp）
+├── app_base.py      # AppPage 基类
+├── led.py           # LED 控制
+├── clock.py         # 时钟
+├── adc.py           # ADC 仪表盘
+├── calc.py          # 计算器
+├── comm_hub.py      # 通信协议 Hub
+├── uart.py          # UART 终端
+├── can.py           # CAN 终端
+├── at.py            # AT 终端
+├── rs485.py         # RS485 终端
+├── game_hub.py      # 游戏 Hub
+├── snake.py         # 贪吃蛇
+├── game_2048.py     # 2048
+├── tetris.py        # 俄罗斯方块
+├── qr_shop.py       # 饮品选购
+├── audio.py         # 录音播放
+├── usb_browser.py   # U 盘浏览器
+├── phone.py         # 电话拨号
+├── eth_hub.py       # 以太网 Hub
+├── eth_info.py      # 网络信息
+├── ping.py          # Ping 工具
+├── tcp.py           # TCP 客户端
+├── buzzer.py        # 蜂鸣器
+├── weather.py       # 天气
+├── keyboard.py      # 虚拟键盘
+├── camera.py        # 摄像头
+├── scan.py          # 扫码
 ├── icons/           # 图标资源（48×48 PNG，~50 个）
 └── images/          # 商品图片（100×70，8 张）
 ```
 
 ## 启动 Demo
-- 直接右键yttrimu.py运行代码
+- 直接右键 `_main.py` 运行代码
 
 ![alt text](image-6.png)
 
 - 或在 QPYCOM 的 REPL 终端中执行：
 
 ```python
 >>> import example
->>> example.exec('/usr/yttrium.py')
+>>> example.exec('/usr/_main.py')
 ```
 
 开发板 LCD 将显示 **YttriumEC718** 主界面——5×3 图标网格，触摸点击进入各功能页面。

diff --git a/docs/03_runDemo/image-2.png b/docs/03_runDemo/image-2.png
diff --git a/docs/03_runDemo/image-4.png b/docs/03_runDemo/image-4.png
diff --git a/docs/03_runDemo/image-5.png b/docs/03_runDemo/image-5.png
diff --git a/docs/03_runDemo/image-6.png b/docs/03_runDemo/image-6.png
diff --git a/docs/04_ledControl/README.md → docs/04_led/README.md b/docs/04_ledControl/README.md → docs/04_led/README.md
@@ -60,7 +60,7 @@ def _on_back(self, e=None):
 
 ## 代码位置
 
-[src/yttrium.py](../../src/yttrium.py) → `class LedPage(AppPage)`（第 121 行起）
+[src/led.py](../../src/led.py) → `class LedPage(AppPage)`
 
 ## 涉及模块
 

diff --git a/docs/05_clock/README.md b/docs/05_clock/README.md
@@ -0,0 +1,53 @@
+# 时钟 + 秒表
+
+本章讲解 Demo 中的时钟与秒表功能，左侧实时时钟，右侧秒表计时。
+
+## 功能概述
+
+- 左半区：绿字大时间 + 日期星期
+- 右半区：秒表（计次/复位/启动/暂停）
+
+## 运行效果
+
+左侧 `HH:MM:SS`（绿色大字）+ 日期星期行，中间竖线分隔，右侧秒表显示 + Lap / Reset / Start / Stop 四个按钮。
+
+## 代码解析
+
+### 时钟更新
+
+```python
+t = utime.localtime()
+self._time_lbl.set_text("{:02d}:{:02d}:{:02d}".format(t[3], t[4], t[5]))
+self._date_lbl.set_text("{:04d}/{:02d}/{:02d} {:s}".format(
+    t[0], t[1], t[2], ("Mon","Tue","Wed","Thu","Fri","Sat","Sun")[t[6]]))
+```
+
+### 秒表驱动
+
+```python
+# lv.timer 每 20ms 累加
+self._elapsed += 20
+m = self._elapsed // 60000
+s = (self._elapsed // 1000) % 60
+ms = (self._elapsed // 10) % 100
+```
+
+### 按钮操作
+
+| 按钮 | 功能 |
+|---|---|
+| Lap | 计次（记录当前时间） |
+| Reset | 复位归零 |
+| Start | 开始 |
+| Stop | 暂停 |
+
+## 代码位置
+
+[src/clock.py](../../src/clock.py) → `class ClockPage(AppPage)`
+
+## 涉及模块
+
+| 模块 | 用途 |
+|---|---|
+| `utime` | 系统时间 |
+| `lvgl` | label、btn、timer |
diff --git a/docs/05_adcVoltmeter/README.md → docs/06_adc/README.md b/docs/05_adcVoltmeter/README.md → docs/06_adc/README.md
@@ -26,13 +26,6 @@
 | 黄色（警告） | 240° ~ 300° | 1.65V ~ 3.3V | `0xFFEB3B` |
 | 红色（危险） | 300° ~ 360° | > 3.3V | `0xFF5252` |
 
-指针角度计算：
-```
-angle = 180° + (voltage / 3.3V) × 180°
-0V → 180°（最左）
-3.3V → 360°（最右）
-```
-
 ## 代码解析
 
 ### 1. 初始化 ADC
@@ -87,8 +80,6 @@ def _on_back(self, e=None):
 
 ## 完整数据流
 
-![数据流](images/adc-flow.png)
-
 1. `lv.timer` 每 300ms 触发 `_adc_tick`
 2. `ADC.read(ADC0)` × 6 次 → 取平均 raw
 3. `raw × scale` → 电压值 V
@@ -110,7 +101,7 @@ ADC0 测试点在板上有引出（参考 `datasheet/` 原理图 Sheet 7）。EG
 
 ## 代码位置
 
-[src/yttrium.py](../../src/yttrium.py) → `class AdcPage(AppPage)`（第 429 行起）
+[src/adc.py](../../src/adc.py) → `class AdcPage(AppPage)`
 
 ## 涉及模块
 

diff --git a/docs/06_communicationHub/README.md b/docs/06_communicationHub/README.md