Skip to content

Commit 46f028d

Browse files
author
meihao
committed
docs: improve T153 getting started and board tests
1 parent 8e0f6f6 commit 46f028d

27 files changed

Lines changed: 2091 additions & 193 deletions

‎docs/T153MX/00-StartHere.md‎

Lines changed: 161 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,161 @@
1+
---
2+
sidebar_position: 2
3+
sidebar_label: 从这里开始
4+
title: OmniGate-T153 开发指南
5+
description: 面向首次接触嵌入式 Linux 的用户，从开箱、烧录、联网到应用开发的 T153MX 学习入口。
6+
hide_title: true
7+
---
8+
9+
<div
10+
className="hero shadow--md"
11+
style={{
12+
borderRadius: '20px',
13+
padding: '3.2rem 2rem',
14+
marginBottom: '2rem',
15+
color: '#ffffff',
16+
background: 'linear-gradient(135deg, #12372a 0%, #1f7a55 58%, #46a578 100%)'
17+
}}>
18+
<div className="container" style={{textAlign: 'center'}}>
19+
<p style={{fontSize: '0.95rem', letterSpacing: '0.16em', marginBottom: '0.8rem'}}>DONGSHANPI · INDUSTRIAL LINUX</p>
20+
<h1 className="hero__title" style={{color: '#ffffff', fontSize: 'clamp(2rem, 5vw, 3.6rem)'}}>OmniGate-T153 开发指南</h1>
21+
<p className="hero__subtitle" style={{maxWidth: '760px', margin: '1rem auto 1.8rem'}}>从第一次上电，到接口验证、系统编译和应用开发，一套可以跟着终端一步步完成的实战文档。</p>
22+
<div>
23+
<a className="button button--secondary button--lg margin-right--sm" href="./part1/QuickStart">10 分钟快速启动</a>
24+
<a className="button button--outline button--secondary button--lg" href="./part3/DevelopmentEnvironmentSetup">开始编译固件</a>
25+
</div>
26+
</div>
27+
</div>
28+
29+
这套文档同时面向第一次接触开发板的用户和需要修改 Tina SDK、驱动、设备树的开发者。每篇实操
30+
都会说明命令在哪台设备执行、正常输出是什么、怎样算成功以及失败后先检查哪里。你不需要从头
31+
读完所有手册，只需选择当前目标。
32+
33+
:::tip 第一次使用，先完成最小闭环
34+
35+
连接串口 → 启动系统 → 连接 ADB → 测试网络 → 编译并运行 HelloWorld。完成这五步后，再测试
36+
CAN、RS485、4G 或修改内核。这样遇到问题时更容易判断是硬件、系统还是应用层造成的。
37+
38+
:::
39+
40+
## 先选一个目标
41+
42+
<div className="row">
43+
<div className="col col--4 margin-bottom--lg">
44+
<div className="card shadow--lw" style={{height: '100%'}}>
45+
<div className="card__header"><h3>第一次使用</h3></div>
46+
<div className="card__body"><p>接串口、上电、进入 Shell，并完成 ADB 与网络检查。</p></div>
47+
<div className="card__footer"><a className="button button--primary button--block" href="./part1/QuickStart">从上电开始</a></div>
48+
</div>
49+
</div>
50+
<div className="col col--4 margin-bottom--lg">
51+
<div className="card shadow--lw" style={{height: '100%'}}>
52+
<div className="card__header"><h3>体验板载接口</h3></div>
53+
<div className="card__body"><p>验证双网口、Wi-Fi、CAN、RS485、USB、TF、声音、LED 和 4G。</p></div>
54+
<div className="card__footer"><a className="button button--primary button--block" href="./part2/Ethernet">开始硬件体检</a></div>
55+
</div>
56+
</div>
57+
<div className="col col--4 margin-bottom--lg">
58+
<div className="card shadow--lw" style={{height: '100%'}}>
59+
<div className="card__header"><h3>定制系统</h3></div>
60+
<div className="card__body"><p>在 Ubuntu 24.04 上配置 SDK、完整编译、打包并核对固件。</p></div>
61+
<div className="card__footer"><a className="button button--primary button--block" href="./part3/DevelopmentEnvironmentSetup">进入 SDK 开发</a></div>
62+
</div>
63+
</div>
64+
</div>
65+
66+
| 我现在想做什么 | 从哪里开始 | 完成标志 |
67+
| --- | --- | --- |
68+
| 第一次给开发板上电 | [启动开发板](./part1/01-QuickStart.md) | 串口进入 Linux Shell，ADB 能识别设备 |
69+
| 烧录默认固件或自己编译的固件 | [更新系统固件](./part1/02-FlashSystem.md) | 新固件启动，版本和构建时间符合预期 |
70+
| 测试板载接口 | [板载功能体验](./part2/01-Ethernet.md) | 对应接口完成一次收发或读写闭环 |
71+
| 编译完整系统 | [SDK 环境搭建与固件编译](./part3/01-DevelopmentEnvironmentSetup.md) | 生成可烧录的 `.img` 镜像 |
72+
| 编写 Linux 程序 | [HelloWorld 快速入门](./part4/01-HelloWorld.md) | Arm 程序上传并在板端运行 |
73+
| 开发 E907 / AMP | [OmniGate AMP Shell](./part5/05-OmniGateAMPShell.md) | A7 与 E907 可以通过 RPMsg 通信 |
74+
| 查询底层 HAL 接口 | [HAL V2 总览](./03-HALV2/00-Overview.md) | 找到对应外设的接口和示例 |
75+
76+
## 新手推荐路线
77+
78+
```mermaid
79+
flowchart LR
80+
A[认识接口] --> B[串口启动]
81+
B --> C[ADB 登录]
82+
C --> D[网口或 Wi-Fi 联网]
83+
D --> E[板载功能测试]
84+
E --> F[HelloWorld]
85+
F --> G{需要改系统吗?}
86+
G -- 否 --> H[Linux / Qt 应用开发]
87+
G -- 是 --> I[SDK 编译与系统配置]
88+
```
89+
90+
建议顺序如下：
91+
92+
1. 阅读[单板介绍](./01-BoardIntroduction.md)，只需先认识电源、UART0、OTG 和要测试的接口。
93+
2. 按[启动开发板](./part1/01-QuickStart.md)进入 Shell，并学会区分 **Ubuntu 主机**和**开发板**。
94+
3. 按[双网口测试](./part2/01-Ethernet.md)或[Wi-Fi 与蓝牙](./part2/02-WiFiBluetooth.md)联网。
95+
4. 根据项目选择 CAN、RS485、USB/TF、声音/LED 或 4G 页面，不必全部测试。
96+
5. 按[HelloWorld](./part4/01-HelloWorld.md)完成交叉编译闭环。
97+
6. 只有需要修改驱动、设备树或根文件系统时，再进入[Tina-SDK 开发](./part3/01-DevelopmentEnvironmentSetup.md)。
98+
99+
## 文档中的命令在哪里执行
100+
101+
这是新手最容易混淆的地方。每组命令前都会标明执行位置：
102+
103+
| 标记 | 指什么 | 常见命令 |
104+
| --- | --- | --- |
105+
| **Ubuntu 主机** | 用来下载、编译和烧录的 x86_64 电脑 | `git`、`adb`、`./build.sh` |
106+
| **SDK 根目录** | 同时含 `build.sh`、`device/`、`kernel/` 的目录 | `source build/envsetup.sh` |
107+
| **开发板 Linux Shell** | 通过 UART0 或 `adb shell` 进入的 Arm 系统 | `ip`、`dmesg`、`mmcli` |
108+
109+
:::warning 不要把提示符也复制进去
110+
111+
文档代码块通常只放命令本身。终端中看到的 `ubuntu@host:~$`、`root@board:~#` 或单独的 `#`
112+
是提示符，不属于命令。
113+
114+
:::
115+
116+
## 当前固件的默认行为
117+
118+
基于当前 OmniGate overlay 构建的固件，启动后会自动完成以下工作：
119+
120+
| 功能 | 默认行为 | 服务脚本 |
121+
| --- | --- | --- |
122+
| 双网口 | `eth0`、`eth1` 自动置为 UP；插线后请求 DHCP，拔线后清理地址 | `S40network` |
123+
| CAN | `can0`、`can1` 以 1 Mbps、`restart-ms 100` 启动 | `S42can` |
124+
| Wi-Fi / Bluetooth | 加载 AIC8800D80 驱动，拉起 `wlan0` 和 `hci0` | `S45aic8800-bluetooth` |
125+
| 声音 | 配置板载 Codec 和扬声器输出通路 | `S35audio` |
126+
| 三个状态灯 | 默认以 250 ms 间隔运行流水灯 | `S47ledctl` |
127+
| TF 卡 | 插卡自动挂载到 `/mnt/sdcard/mmcblk1p1`，拔卡自动卸载 | `S21tfcard-hotplug` + udev |
128+
| 4G 管理 | 启动 ModemManager；未安装模块时显示找不到 Modem 属正常现象 | `S44modem-manager` |
129+
| ADB | 启动 USB Gadget ADB | `S50adb_start` |
130+
131+
如果你的结果与上表不同，先确认烧录的是应用了最新 OmniGate overlay 的固件，再查看对应章节。
132+
133+
## 遇到问题时先保存这些信息
134+
135+
在 **开发板 Linux Shell**执行：
136+
137+
```bash
138+
uname -a
139+
cat /proc/cmdline
140+
ip -br link
141+
cat /proc/partitions
142+
dmesg | tail -n 120
143+
```
144+
145+
在 **Ubuntu 主机**执行：
146+
147+
```bash
148+
adb devices
149+
lsusb
150+
```
151+
152+
反馈问题时同时提供：板卡批次、固件文件名与 SHA-256、接线照片、完整操作步骤和上述输出。
153+
只提供一句**不能用**或最后一行报错，通常无法区分供电、接线、驱动和应用配置问题。
154+
155+
## 参考资料与实操教程的区别
156+
157+
- `快速启动`、`板载功能体验`和`应用开发`是可以照着执行的实操教程。
158+
- `系统软件`、`Buildroot`、`系统配置`、`USB/OTA/AMP`和`HAL V2`保留了大量原厂参考内容，
159+
适合遇到具体问题时按目录查询，不建议新手顺序通读。
160+
- 不同硬件批次或选配模块可能存在差异。涉及电压、引脚、天线和供电时，以当前批次原理图、
161+
BOM 和模块规格书为准。

‎docs/T153MX/01-BoardIntroduction.md‎

Lines changed: 85 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,84 @@
22
sidebar_position: 1
33
sidebar_label: 单板介绍
44
description: DshanPi OmniGate-T153 工业边缘网关开发板的组成、硬件资源与软件支持状态。
5+
slug: /T153MX/
6+
hide_title: true
57
---
68

7-
# DshanPi OmniGate-T153 单板介绍
9+
import boardHero from './images/DshanPI-OminiGate-3.png';
10+
11+
<div
12+
className="shadow--md"
13+
style={{
14+
borderRadius: '24px',
15+
padding: 'clamp(1.5rem, 4vw, 3.5rem)',
16+
marginBottom: '2.2rem',
17+
overflow: 'hidden',
18+
color: '#ffffff',
19+
background: 'radial-gradient(circle at 85% 15%, #2463a6 0%, #123e73 35%, #081d38 100%)'
20+
}}>
21+
<div className="row" style={{alignItems: 'center'}}>
22+
<div className="col col--5 margin-bottom--lg">
23+
<div style={{fontSize: '0.82rem', fontWeight: 700, letterSpacing: '0.16em', opacity: 0.78}}>DONGSHANPI · INDUSTRIAL EDGE</div>
24+
<h1 style={{color: '#ffffff', fontSize: 'clamp(2.25rem, 5vw, 4rem)', lineHeight: 1.05, margin: '1rem 0'}}>OmniGate-T153</h1>
25+
<p style={{fontSize: '1.2rem', lineHeight: 1.75, opacity: 0.92}}>四核 Linux 与 E907 实时核心协同，连接双千兆、双 4G 与工业总线，为边缘网关、HMI 和数据采集而生。</p>
26+
<div style={{display: 'flex', flexWrap: 'wrap', gap: '0.55rem', margin: '1.4rem 0'}}>
27+
<span style={{padding: '0.4rem 0.75rem', borderRadius: '999px', background: 'rgba(255,255,255,0.13)'}}>4× Cortex-A7</span>
28+
<span style={{padding: '0.4rem 0.75rem', borderRadius: '999px', background: 'rgba(255,255,255,0.13)'}}>RISC-V E907</span>
29+
<span style={{padding: '0.4rem 0.75rem', borderRadius: '999px', background: 'rgba(255,255,255,0.13)'}}>2× GbE</span>
30+
<span style={{padding: '0.4rem 0.75rem', borderRadius: '999px', background: 'rgba(255,255,255,0.13)'}}>2× 4G</span>
31+
</div>
32+
<a className="button button--secondary button--lg margin-right--sm" href="./part1/QuickStart">开始使用</a>
33+
<a className="button button--outline button--secondary button--lg" href="./part2/Ethernet">体验接口</a>
34+
</div>
35+
<div className="col col--7">
36+
<div style={{padding: '0.7rem', borderRadius: '20px', background: '#ffffff', boxShadow: '0 24px 60px rgba(0,0,0,0.28)'}}>
37+
<img src={boardHero} alt="OmniGate-T153 工业边缘网关" style={{display: 'block', width: '100%', borderRadius: '14px'}} />
38+
</div>
39+
</div>
40+
</div>
41+
</div>
42+
43+
OmniGate-T153 由 **mCore-T153MX 核心板**和 **OmniGate 扩展底板**组成。核心板承载处理器、内存
44+
和 eMMC，底板负责工业接口与扩展连接。模块化结构既方便快速验证，也适合继续开发网关、HMI、
45+
数据采集和边缘控制产品。
46+
47+
## 核心能力
48+
49+
<div className="row">
50+
<div className="col col--3 margin-bottom--lg">
51+
<div className="card shadow--lw" style={{height: '100%', borderTop: '4px solid #1769aa'}}>
52+
<div className="card__body"><h3>异构计算</h3><p>4× Cortex-A7 运行 Linux，E907 承担实时与异构任务。</p></div>
53+
</div>
54+
</div>
55+
<div className="col col--3 margin-bottom--lg">
56+
<div className="card shadow--lw" style={{height: '100%', borderTop: '4px solid #16856b'}}>
57+
<div className="card__body"><h3>灵活存储</h3><p>最大支持 DDR4 4 GB 与 eMMC 64 GB，容量按 SKU 选择。</p></div>
58+
</div>
59+
</div>
60+
<div className="col col--3 margin-bottom--lg">
61+
<div className="card shadow--lw" style={{height: '100%', borderTop: '4px solid #7b61b3'}}>
62+
<div className="card__body"><h3>多路联网</h3><p>双千兆以太网、双 4G 模块位，以及 Wi-Fi 6 和蓝牙 5。</p></div>
63+
</div>
64+
</div>
65+
<div className="col col--3 margin-bottom--lg">
66+
<div className="card shadow--lw" style={{height: '100%', borderTop: '4px solid #d17b28'}}>
67+
<div className="card__body"><h3>工业连接</h3><p>双 CAN FD、双 RS485，并提供显示、触摸与 USB 扩展。</p></div>
68+
</div>
69+
</div>
70+
</div>
71+
72+
:::caution **最大支持**不等于当前板卡实装容量
73+
74+
DDR4 4 GB 和 eMMC 64 GB 是平台支持上限。拿到板卡后应在 Linux 中用 `free -h`、`lsblk` 或
75+
`cat /proc/partitions` 查看实际容量，并以对应 SKU/BOM 为准。
876

9-
OmniGate-T153 是一款基于全志 T153MX 的工业边缘网关开发板，由 **mCore-T153MX 核心板**和 **OmniGate 扩展底板**组成，面向双 4G 联网、多网口接入、工业总线控制和人机界面等应用。
10-
11-
![OmniGate-T153 正面与主要特性](./images/DshanPI-OminiGate-3.png)
77+
:::
1278

13-
:::info 资料来源
79+
:::info 使用提示
1480

15-
本文依据 [T153MX-Tina5SDK_OmniGate 板级仓库](https://github.com/dshanpi/T153MX-Tina5SDK_OmniGate)中的硬件图片、板级配置和调试记录整理。不同批次或选配型号的内存、eMMC、4G 模块与无线模块可能不同，量产设计请以对应批次的原理图、BOM 和模块规格书为准。
81+
不同批次或选配型号的内存、eMMC、4G 模块和无线模块可能存在差异。选型、接线和量产设计时，
82+
请以当前批次随板提供的原理图、BOM 和模块规格书为准。
1683

1784
:::
1885

@@ -29,8 +96,8 @@ mCore-T153MX 将处理器、内存、eMMC 和电源等核心器件集中在约 3
2996
| 主处理器 | 全志 T153MX |
3097
| Linux CPU | 4× Arm Cortex-A7 |
3198
| 实时/异构核心 | 1× RISC-V E907 |
32-
| 内存 | DDR4 4 GB |
33-
| 存储 | eMMC 64 GB |
99+
| 内存 | 最大支持 DDR4 4 GB；实际容量以具体 SKU/BOM 为准 |
100+
| 存储 | 最大支持 eMMC 64 GB；实际容量以具体 SKU/BOM 为准 |
34101
| 外形 | 31.9 mm × 31.9 mm |
35102
| 引出方式 | 140 Pin 邮票孔，0.8 mm 间距 |
36103

@@ -40,8 +107,6 @@ T153MX 面向 PLC、HMI 和工业自动化等场景。芯片集成多路以太
40107

41108
OmniGate 扩展底板为核心板提供双 4G、双千兆以太网、工业总线、显示、摄像头、USB 和无线连接等接口。
42109

43-
![OmniGate-T153 正面](./images/DshanPI-OminiGate-1.png)
44-
45110
![OmniGate-T153 背面双 4G 模块位](./images/DshanPI-OminiGate-2.png)
46111

47112
### 硬件功能关系示意
@@ -57,7 +122,7 @@ flowchart TB
57122
WIFI[Wi-Fi 6 / Bluetooth 5]
58123
DISP[MIPI DSI / RGB LCD]
59124
CAM[MIPI CSI]
60-
USB[USB Type-C / USB 3.0]
125+
USB[USB OTG / Device<br/>USB 2.0 Host]
61126
DEBUG[UART0 调试串口]
62127
63128
SOC --- DDR
@@ -86,7 +151,7 @@ flowchart TB
86151
| 显示 | MIPI DSI、RGB LCD 扩展接口 |
87152
| 摄像头 | MIPI CSI 扩展接口 |
88153
| 存储扩展 | TF Card |
89-
| USB | USB Type-C、USB 3.0 Type-A |
154+
| USB | USB OTG/Device、USB 2.0 High-Speed Type-A Host |
90155
| 调试与交互 | 调试串口、按键、状态指示灯 |
91156

92157
:::caution 4G 模块为选配器件
@@ -97,27 +162,28 @@ flowchart TB
97162

98163
## 软件支持状态
99164

100-
板级仓库不是完整的 Tina SDK，而是 OmniGate 板级开发产生的覆盖式差异包。当前配置基于 Tina Linux 5.0、Linux 5.10 和 `t153_omnigate_mmc-buildroot` 方案。
165+
当前软件配置基于 Tina Linux 5.0、Linux 5.10 和 `t153_omnigate_mmc-buildroot` 方案。下表用于说明
166+
各功能在当前版本中的支持和验证情况。
101167

102168
| 功能 | 当前状态 | 说明 |
103169
| --- | --- | --- |
104170
| 双千兆以太网 | 已配置 | `gmac0`、`gmac1` 及对应 PHY 已在设备树启用 |
105-
| CAN FD | 驱动已配置，控制器默认关闭 | 内核已启用 CAN/CAN RAW；当前 `board.dts` 中 `can0`、`can1` 为 `disabled` |
171+
| CAN FD | 已配置并实板验证 | `can0`、`can1` 默认以 1 Mbps 启动 |
106172
| Wi-Fi / Bluetooth | 已实板验证 | AIC8800D80，SDIO + UART |
107173
| Bluetooth PCM | 已实板验证 | I2S0 使用 PB5～PB8 |
108174
| eMMC / TF Card | 已配置 | 当前构建目标为 eMMC Buildroot 方案 |
109-
| MIPI DSI 4-Lane | 调试中 | 背光、初始化和 DRM 已工作，仍存在水平条纹 |
110-
| 双 4G | 硬件支持 | 需根据实际 4G 模块补充拨号和运营商配置 |
175+
| MIPI DSI 4-Lane / 触摸 | Linux 下已实板验证 | 1024×768 显示和触摸可用；U-Boot Logo 默认关闭 |
176+
| 双 4G | 驱动与拨号工具已配置 | 当前未安装模块实板验证，需根据模块和运营商设置 APN |
111177
| E907 AMP Shell | 已实板验证 | A7 Linux 通过 remoteproc、MSGBOX 和 RPMsg 连接 E907 FreeRTOS |
112178

113-
“已配置”表示 SDK 中已经包含对应驱动或板级配置，不代表当前镜像已启用控制器，也不代表所有外接设备、线材和应用场景均完成验证。
179+
**已配置**表示 SDK 中已经包含对应驱动或板级配置，不代表当前镜像已启用控制器，也不代表所有外接设备、线材和应用场景均完成验证。
114180

115181
## 接下来做什么
116182

117183
单板介绍只用于认识硬件，不在这里展开 SDK 和烧录操作。第一次使用建议按以下顺序继续：
118184

119-
1. [获取源码、工具与手册](./02-SourceCodeToolDocumentationManual.md)
120-
2. [安装并配置开发环境](./03-ConfigHostEnv.md)
185+
1. [从这里开始](./00-StartHere.md)
186+
2. [获取源码、工具与手册](./02-SourceCodeToolDocumentationManual.md)
121187
3. [连接并启动开发板](./part1/01-QuickStart.md)
122188
4. [更新系统固件](./part1/02-FlashSystem.md)
123189
5. [体验板载功能](./part2/01-Ethernet.md)

0 commit comments

Comments
 (0)