docs: add T153MX OmniGate and development manuals

Author: codebug8

.gitattributes

@@ -0,0 +1 @@
+*.pdf binary

docs/T153MX/01-BoardIntroduction.md

@@ -1,36 +1,134 @@
 ---
 sidebar_position: 1
+sidebar_label: 单板介绍
+description: DshanPi OmniGate-T153 工业边缘网关开发板的组成、硬件资源与软件支持状态。
 ---
 
-# mCore-T153MX硬件
+# DshanPi OmniGate-T153 单板介绍
 
-* 此开发板的任何问题都可以在我们的论坛交流讨论 https://forums.100ask.net/c/aw/t113s3/19
+OmniGate-T153 是一款基于全志 T153MX 的工业边缘网关开发板，由 **mCore-T153MX 核心板**和 **OmniGate 扩展底板**组成，面向双 4G 联网、多网口接入、工业总线控制和人机界面等应用。
 
-## 硬件简述
+![OmniGate-T153 正面与主要特性](./images/DshanPI-OminiGate-3.png)
 
-![image-20260306174932409](./images/image-20260306174932409.png)
+:::info 资料来源
 
+本文依据 [T153MX-Tina5SDK_OmniGate 板级仓库](https://github.com/dshanpi/T153MX-Tina5SDK_OmniGate)中的硬件图片、板级配置和调试记录整理。不同批次或选配型号的内存、eMMC、4G 模块与无线模块可能不同，量产设计请以对应批次的原理图、BOM 和模块规格书为准。
 
+:::
 
-### T153MX芯片
-- 概述
+## 产品组成
 
-T153 是一款面向自动化应用的四核架构解决方案，例如可编程逻辑控制器 (PLC)、人机界面 (HMI) 等。
+### mCore-T153MX 核心板
 
-- 卓越的计算能力
+mCore-T153MX 将处理器、内存、eMMC 和电源等核心器件集中在约 31.9 mm × 31.9 mm 的邮票孔模块上。核心板采用 140 Pin、0.8 mm 间距的单面布局，便于直接焊接到底板。
 
-T153 配备四核 Arm Cortex-A7 处理器、单核 RISC-V E907 处理器，并支持 DDR3/DDR3L/DDR4 内存，可提供强大的计算性能和快速响应，是高要求自动化任务的理想之选。
+![mCore-T153MX 核心板](./images/mCore-T153MX-1.png)
 
-- 智能自动化控制
+| 项目 | 配置 |
+| --- | --- |
+| 主处理器 | 全志 T153MX |
+| Linux CPU | 4× Arm Cortex-A7 |
+| 实时/异构核心 | 1× RISC-V E907 |
+| 内存 | DDR4 4 GB |
+| 存储 | eMMC 64 GB |
+| 外形 | 31.9 mm × 31.9 mm |
+| 引出方式 | 140 Pin 邮票孔，0.8 mm 间距 |
 
-该处理器具有三个千兆以太网接口、两个 CAN FD 接口以及 8/16/32 位本地总线，支持高吞吐量网络，满足复杂数据驱动型应用的需求。其集成的图像信号处理器和显示引擎可提供清晰的实时视觉反馈，用于管理复杂的制造流程。
+T153MX 面向 PLC、HMI 和工业自动化等场景。芯片集成多路以太网、CAN FD、TWI、PWM 和 GPADC 等资源，并可通过 E907 处理实时或异构任务。
 
-- 丰富的扩展选项
+### OmniGate 扩展底板
 
-T153 提供广泛的外设支持，包括 24 通道 GPADC、6 个 TWI 和 30 通道 PWM。这些接口为各种应用提供了灵活性，从而实现了自动化系统的轻松集成和可扩展性。
+OmniGate 扩展底板为核心板提供双 4G、双千兆以太网、工业总线、显示、摄像头、USB 和无线连接等接口。
 
-![image-20260306175019874](./images/image-20260306175019874.png)
+![OmniGate-T153 正面](./images/DshanPI-OminiGate-1.png)
 
-## 配套模块
+![OmniGate-T153 背面双 4G 模块位](./images/DshanPI-OminiGate-2.png)
 
+## 主要硬件资源
 
+| 类别 | 板载资源 |
+| --- | --- |
+| 蜂窝网络 | 2× 4G 模块位、2× SIM 卡槽 |
+| 有线网络 | 2× 千兆以太网 RJ45 |
+| 无线连接 | Wi-Fi 6、Bluetooth 5 |
+| 工业总线 | 2× CAN FD、2× RS485 |
+| 显示 | MIPI DSI、RGB LCD 扩展接口 |
+| 摄像头 | MIPI CSI 扩展接口 |
+| 存储扩展 | TF Card |
+| USB | USB Type-C、USB 3.0 Type-A |
+| 调试与交互 | 调试串口、按键、状态指示灯 |
+
+:::caution 4G 模块为选配器件
+
+装配模块前应确认接口尺寸、供电能力、SIM 卡方向、天线连接和运营商频段支持。
+
+:::
+
+## 软件支持状态
+
+板级仓库不是完整的 Tina SDK，而是 OmniGate 板级开发产生的覆盖式差异包。当前配置基于 Tina Linux 5.0、Linux 5.10 和 `t153_omnigate_mmc-buildroot` 方案。
+
+| 功能 | 当前状态 | 说明 |
+| --- | --- | --- |
+| 双千兆以太网 | 已配置 | `gmac0`、`gmac1` 及对应 PHY 已在设备树启用 |
+| CAN FD | 已配置 | `can0`、`can1` 已配置 |
+| Wi-Fi / Bluetooth | 已实板验证 | AIC8800D80，SDIO + UART |
+| Bluetooth PCM | 已实板验证 | I2S0 使用 PB5～PB8 |
+| eMMC / TF Card | 已配置 | 当前构建目标为 eMMC Buildroot 方案 |
+| MIPI DSI 4-Lane | 调试中 | 背光、初始化和 DRM 已工作，仍存在水平条纹 |
+| 双 4G | 硬件支持 | 需根据实际 4G 模块补充拨号和运营商配置 |
+
+“已配置”表示板级配置中已经启用相关控制器，不代表所有外接设备、线材和应用场景均完成验证。
+
+## 获取板级适配仓库
+
+```bash
+git clone https://github.com/dshanpi/T153MX-Tina5SDK_OmniGate.git
+```
+
+仓库采用 overlay 结构，主要内容如下：
+
+```text
+T153MX-Tina5SDK_OmniGate/
+├── docs/       单板说明与专题调试记录
+├── images/     核心板和扩展底板图片
+├── overlay/    按 Tina SDK 根目录组织的差异文件
+├── meta/       差异、删除和状态记录
+└── scripts/    应用 overlay 和执行删除的脚本
+```
+
+## 应用板级配置
+
+假设 Tina SDK 位于 `/path/to/TinaSDK`，执行：
+
+```bash
+/path/to/T153MX-Tina5SDK_OmniGate/scripts/apply_overlay.sh /path/to/TinaSDK
+```
+
+该脚本只会将 `overlay/` 中的文件覆盖到 SDK 对应路径，不会自动执行删除操作。需要清理旧固件时，应先人工检查 `meta/delete_list.txt`，确认无误后再运行仓库提供的删除脚本。
+
+## 编译与打包
+
+在已经应用 overlay 的 Tina SDK 根目录执行：
+
+```bash
+source build/envsetup.sh
+lunch t153_omnigate_mmc-buildroot
+make
+pack
+```
+
+当前镜像输出名称：
+
+```text
+out/t153_linux_omnigate_uart0.img
+```
+
+烧录和串口调试前请确认目标设备、USB 连接和镜像路径，避免误写其他存储设备。
+
+## 调试资料
+
+- [OmniGate 板级仓库](https://github.com/dshanpi/T153MX-Tina5SDK_OmniGate)
+- [WLAN、Bluetooth 与 PCM 调试记录](https://github.com/dshanpi/T153MX-Tina5SDK_OmniGate/blob/main/docs/wlan-bluetooth-bringup.md)
+- [MIPI DSI 4-Lane 屏调试记录](https://github.com/dshanpi/T153MX-Tina5SDK_OmniGate/blob/main/docs/mipi-dsi-debug-record.md)
+- [Bluetooth 音响交付变更说明](https://github.com/dshanpi/T153MX-Tina5SDK_OmniGate/blob/main/docs/bluetooth-speaker-change-set.md)

docs/T153MX/02-DevelopmentGuides/00-Overview.md

@@ -0,0 +1,32 @@
+---
+sidebar_position: 1
+sidebar_label: 概览
+description: 开发指南内容索引。
+---
+
+# 开发指南
+
+本分类中的正文均从原始 PDF 文本层转换，保留 PDF 目录层级、段落顺序、代码换行和插图。转换过程不对技术内容进行概括或改写。
+
+## 系统与构建
+
+| 主题 | 内容 |
+| --- | --- |
+| [系统软件](./01-system-software-guide.md) | SDK、构建系统、内核、文件系统与应用开发 |
+| [Buildroot](./02-buildroot-guide.md) | 目录结构、环境配置、构建、包管理与应用开发 |
+| [系统配置](./03-configuration-guide.md) | menuconfig、sysconfig、设备树、分区表与环境变量 |
+
+## 外设与应用
+
+| 主题 | 内容 |
+| --- | --- |
+| [USB](./04-usb-guide.md) | 设备树、内核配置、Gadget、Host、OTG 与调试 |
+| [Qt](./05-qt-guide.md) | Qt 5 配置、编译、显示后端、示例运行与常见问题 |
+
+## 升级与多系统
+
+| 主题 | 内容 |
+| --- | --- |
+| [OTA](./06-ota-guide.md) | SWUpdate、Recovery、A/B、差分升级、签名、压缩与调试 |
+| [同构 AMP 多系统](./07-homogeneous-amp-guide.md) | 从系统构建、引导、内存规划、通信与调试 |
+| [异构通信框架](./08-heterogeneous-communication-guide.md) | Remoteproc、RPMsg、共享内存与异构系统调试 |