# damiao

**Repository Path**: kit-miao/damiao

## Basic Information

- **Project Name**: damiao
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DAMIAO 达妙科技

中文 | [EN](./README.en.md) | GitHub 英文仓：`dmBots/dmBot`

`damiao` 是达妙公开资料的中文主仓，也是中文完整资料主源。  
首页集中提供仓库定位、主要入口、下载方式、双仓差异和常见说明。

## 仓库定位

- 中文主仓：中文完整资料、中文入口、历史兼容和较完整的说明以这里为准。
- README 负责直接展示入口；分类 README 负责按任务分流；子目录 README 负责目录入口。
- 安装、编译、烧录、平台差异、运行步骤继续放在目录内的 `USAGE.md`、`SETUP.md`、`WORKFLOW.md`、`FLASHING.md`、`BUILD.md`、`PLATFORM.md`、`UPDATE.md` 和 `FIRMWARE-NOTES.md`。

## 首次访问建议

### 客户 / 开发者

- 型号资料请参见 [1.关节电机](1.关节电机/README.md)。
- 控制例程请参见 [5.控制例程](5.控制例程/README.md)。
- 控制板、IMU 和 Orin 载板资料请参见 [6.控制板](6.控制板/README.md)。
- USB2CANFD、上位机、固件和 SDK 资料请参见 [8.工具和上位机](8.工具和上位机/README.md)。
- Canopen 手册、EDS、固件和字典工具请参见 [B.Canopen](B.Canopen/README.md)。

### 从 GitHub 进入的用户

- GitHub `dmBot` 提供英文入口和高频公开路径，不替代中文完整资料主源。
- 如需确认双仓覆盖范围，请参见 [docs/repository/mirror-scope.md](docs/repository/mirror-scope.md)。
- 如需处理旧 GitHub 中文路径书签，请参见 [docs/repository/path-mapping.md](docs/repository/path-mapping.md)。

### 维护者 / 贡献者

- 仓库级改动、README 规范、同步门禁和文档放置规则：看 [CONTRIBUTING.md](CONTRIBUTING.md)。
- 双仓覆盖边界：看 [docs/repository/mirror-scope.md](docs/repository/mirror-scope.md)。
- 中英路径对照与旧书签：看 [docs/repository/path-mapping.md](docs/repository/path-mapping.md)。

## 高频入口

- [1.关节电机](1.关节电机/README.md) - 按型号查阅说明书、图纸、模型和曲线
- [5.控制例程](5.控制例程/README.md) - 按语言、平台和运行环境选择例程
- [6.控制板](6.控制板/README.md) - 控制板、IMU 和 Orin 载板入口
- [8.工具和上位机](8.工具和上位机/README.md) - USB2CANFD、上位机、固件切换和 SDK
- [9.使用手册](9.使用手册/README.md) - 客户常用手册、调试说明和帮助文档
- [B.Canopen](B.Canopen/README.md) - Canopen 公开资料入口

## 仓库地图

| 路径 | 内容 | 建议先看 |
| --- | --- | --- |
| `0.固件` | 固件包、版本说明和升级相关资料 | [`0.固件/固件/README.md`](0.固件/固件/README.md) |
| `1.关节电机` | 关节电机型号资料 | [`1.关节电机/README.md`](1.关节电机/README.md) |
| `2.中空电机` | 中空电机资料 | `2.中空电机/` 下对应目录 |
| `3.轮毂电机` | 轮毂电机资料 | `3.轮毂电机/` 下对应目录 |
| `4.分立系列` | 分立系列资料 | `4.分立系列/` 下对应目录 |
| `5.控制例程` | C++、Python、ROS1、STM32 等控制例程 | [`5.控制例程/README.md`](5.控制例程/README.md) |
| `6.控制板` | 控制板、IMU、Orin 载板、spine | [`6.控制板/README.md`](6.控制板/README.md) |
| `7.电机驱动板` | 驱动板型号入口 | [`7.电机驱动板/README.md`](7.电机驱动板/README.md) |
| `8.工具和上位机` | USB2CANFD、上位机、固件、SDK 和驱动工具 | [`8.工具和上位机/README.md`](8.工具和上位机/README.md) |
| `9.使用手册` | 客户手册、调试说明、协议资料 | [`9.使用手册/README.md`](9.使用手册/README.md) |
| `10.直驱电机` | 直驱电机资料 | `10.直驱电机/` 下对应目录 |
| `11.谐波电机` | 谐波电机资料 | `11.谐波电机/` 下对应目录 |
| `A.达妙开源系列` | 按现有结构维护 | 对应子目录 README |
| `B.Canopen` | Canopen 公开资料入口 | [`B.Canopen/README.md`](B.Canopen/README.md) |

## 下载与同步

```bash
git clone https://gitee.com/kit-miao/damiao.git
cd damiao
git submodule update --init --recursive --remote
```

- 只需要某个子树时，可先在本页确定大类，再进入对应目录阅读该目录的 README 和流程文档。
- 从 GitHub 英文仓返回时，请以这里的中文完整资料为准。

## GitHub / Gitee 差异简述

- `damiao` 是中文完整资料主源；`dmBot` 是英文入口仓和高频英文入口。
- 双仓保持入口语义一致，但覆盖深度允许不同，尤其是低频资料、历史资料和部分中文正文。
- `orin-board` 保持现有目录和说明方式。
- `A.达妙开源系列` 按现有结构维护。

## 常见问题

- GitHub 为什么比 Gitee 资料少？  
  GitHub 主要提供英文入口和高频公开路径；详情请参见 [docs/repository/mirror-scope.md](docs/repository/mirror-scope.md)。
- 旧 GitHub 中文路径书签失效怎么办？  
  请参见 [docs/repository/path-mapping.md](docs/repository/path-mapping.md)。
- README 和 `USAGE.md` / `SETUP.md` / `WORKFLOW.md` 有什么区别？  
  README 用于目录导航；流程文档提供具体步骤。
- 看到 `TBD` 或 `Translation pending` 是什么意思？  
  表示该语言版本或该分支资料尚未补齐，不应视为完整说明。

## 支持与安全

- 客户帮助中心和售后支持：请按当前官方支持渠道获取
- [电机固件总仓](https://gitee.com/kit-miao/motor-firmware)
- [SECURITY.md](SECURITY.md)

## 维护与贡献

- [CONTRIBUTING.md](CONTRIBUTING.md) - README 规则、文档放置矩阵、同步门禁
- [docs/repository/mirror-scope.md](docs/repository/mirror-scope.md) - 双仓覆盖边界和跨仓继续阅读说明
- [docs/repository/path-mapping.md](docs/repository/path-mapping.md) - 路径对照和旧书签兼容说明
- 修改 README 时，请不要将安装、编译、烧录和平台差异正文移回根 README；相关内容继续保留在目录内流程文档。