

Kicad project
make motor drive fast and stable
- Size
- 31.5 × 19.5 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 3
- Nets
- 59
- Pads
- 119
- Tracks, vias
- 3, 0
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 10 Sep 2026
- Updated
- 15 Oct 2026
Overview
Kicad project is an open-source printed circuit board by masterHZS, from the masterHZS/Motor-Driver repository on GitHub. It is a 2-layer board of 31.5 × 19.5 mm with 3 parts on 59 nets, routed with 3 tracks and 0 vias.
It is built around the DSPIC33EV128GM106-E/PT. Its parts include 2 resistors and 1 IC. It belongs with the PIC boards of this library.
Main components
1README
README.md电机驱动项目 — 总索引
HC32F005 单板三相无刷电机驱动
当前主线:
上位机 HostSoftware
-> USB-TTL / DAPLink 虚拟串口
-> F005_Slave(Modbus-RTU 从站,地址 1)
-> 20 kHz PWM 三相功率级
-> 2216-730KV 三相无刷电机工作方法见 工作流程.txt。每个顶层目录均有本地 00_索引.md。
🤖 AI / 自动化代理首次进入请先读
00_AI/START_HERE.md(入口与硬禁令); 机器可读清单在00_AI/manifest.json,根目录AGENTS.md是自动加载的入口钩子。
1. 顶层顺序与标签
| 顺序 | 目录 | 标签 | 内容 |
|---|---|---|---|
| 00 | 00_AI/ | AI 入口、现状快照 | ★ AI 首读:入口说明、项目地图、当前状态、权威文件速查、构建命令、踩坑与硬约束 |
| 01 | 01_PCB/ | 主设计、已冻结、审核 | V3.1 原理图、网表、BOM、生成器、审核报告 |
| 02 | 02_固件/ | 主固件、通信、台架 | F005 从机、F072 桥/旧控制器参考 |
| 03 | 03_上位机/ | 主软件、Modbus 主站 | Qt 6 + QML 源码与 Release |
| 04 | 04_工作区/ | 调试、波形、审核、工具 | 波形、日志、Gerber 审核、ISP 工具 |
| 05 | 05_采购清单/ | 采购、执行记录 | 采购申请单 |
| 06 | 06_参考资料/ | 唯一资料库 | 芯片知识库、开源参考、EasyEDA、历史会话 |
| 99 | 99_归档/ | 历史、待评估删除 | 旧固件和旧版图备份 |
标签含义:
[主]:当前维护和交付入口。[冻结]:已作为当前硬件依据,不随意修改。[参考]:用于查阅或对照,不进入主构建。[调试]:实测数据和过程记录。[历史]:只作追溯,可能清理。[可重建]:构建产物、缓存或派生产物。
2. 推荐查看顺序
00_AI/START_HERE.md→00_AI/02_当前状态.md(AI 与首次接触者入口)01_PCB/00_索引.md01_PCB/说明.md01_PCB/Motor-project/V3.1_升级说明.md01_PCB/Motor-project/V3.0_设计规格与计算书.md01_PCB/Motor-project/motor-driver-V3.1.*01_PCB/Motor-analysis/HC32F005_引脚分配.md02_固件/00_索引.md02_固件/F005_COMMS.md02_固件/F072_MotorCtrl/README.md03_上位机/00_索引.md与03_上位机/HostSoftware/README.md04_工作区/00_索引.md06_参考资料/00_索引.md
⚠️ 路径提示:旧文档里写的
01_PCB/01_工程/= 现在的01_PCB/Motor-project/,01_PCB/03_审核/= 现在的01_PCB/Motor-analysis/(2026-10 改名,历史记录未逐一改写)。
3. 当前主链路
硬件
- 当前版本:V3.1(原理图冻结、PCB 已打样;板上 F005 已拆除,改外接 F072 直驱)
- 母线:12.0–16.8 V,4S(有效窗口 13.5–16.8 V)
- 主控:HC32F005C6PA(板上位号 U5,当前空位)
- 栅驱动:FD6288T
- 当前控制器:外接 HC32F072JATA →
TP12–TP17(见02_固件/F072_MotorCtrl/)
F005 从机
- 默认构建:
02_固件/F005_Slave/build_comms.ps1 - 默认输出:
02_固件/F005_Slave/build_comms/comms.hex - 通信:UART0,
9600-8N1,Modbus-RTU 地址 1 - 控制:
0x0002油门 0~100 - 实际占空比:默认限幅到 25%
- 开环电换相范围:默认 10~120 Hz
- 非零油门隐式启动,零油门停止
- 烧录恢复:
flash_under_reset.ps1
上位机
- 源码:
03_上位机/HostSoftware/ - 发布版:
03_上位机/release/HostSoftware/ - 功能码:
0x03读寄存器、0x06写单寄存器 - 状态轮询:
0x0000~0x0009
4. 目录维护规则
- 顶层目录保持两位数字前缀,按开发顺序排列。
- 每个顶层目录使用
00_索引.md说明标签、内容、顺序和清理规则。 - 源码工程不按外观随意改名;优先通过索引分类,防止硬编码路径失效。
- 数据手册和芯片结论只写入
06_参考资料/芯片知识库/。 - 第三方完整工程只写入
06_参考资料/开源参考工程/。 - 构建产物、
__pycache__、.pyc、临时日志可重建或可删除。 - 历史版本进入
99_归档/,不要与当前版本混放。 - 同内容文件不再保存多份实体副本。
00_AI/是 AI 入口与现状快照,只写「指针 + 状态」,不复制权威数据;状态变化后同步更新。
5. 2026-09-30 整理结果
- F005 主目录收敛为:
build_comms + cmsis + core + ldscripts + port + third_party + user。 - 删除另一套精简 DDL,只保留官方完整 DDL。
- 删除历史
build_*、探针源码、旧 release、便携 Python、测试临时文件。 - 删除根
$null、02_固件/%SystemDrive%、旧锁文件和可重建缓存。 asac-esc从固件主目录移到06_参考资料/开源参考工程/。- 重复 HC32F005 手册合并到
06_参考资料/芯片知识库/_datasheet/。 - 所有顶层目录增加
00_索引.md,统一标签和推荐查看顺序。
6. 当前状态
| 项目 | 状态 |
|---|---|
| PCB V3.1 | 已冻结并打样,实板调试中(详见 01_PCB/说明.md) |
| 板上 F005 | 已拆除(UART 固件释放 P27 后 SWD 无法恢复,板上无 nRESET 可用) |
| 当前主链路 | HostSoftware → DAPLink 串口 → 外接 F072_MotorCtrl (-Direct) → V3.1 功率级 |
| F005 直连 Modbus 从站 | 已实现并成功构建(005 拆板前验证通过,保留参考) |
上位机油门写 0x0002 | 已接通 F072 直接油门控制 |
| 电机带载验证 | 尚未完成,必须限流并从低油门开始 |
| 开环版带电机 | ⛔ 已明令禁止(2026-10-08 剧烈震动事故),必须用 BEMF 闭环 |
| BEMF 闭环 | F072_MotorCtrl -BEMF,ADC 通道映射已验证,待整机联调 |
Parts
3| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | DSPIC33EV128GM106-E/PT | Package_DFN_QFN:QFN-56-1EP_8x8mm_P0.5mm_EP4.5x5.2mm_ThermalVias_TopTented | U1 |
| 1 | R | Resistor_SMD:R_0603_1608Metric | R1 |
| 1 | R_Small_US | Resistor_SMD:R_0805_2012Metric | R2 |
Questions
How big is the Kicad project PCB?
It measures 31.5 × 19.5 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Kicad project use?
3 parts, built around the DSPIC33EV128GM106-E/PT. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Kicad project KiCad files?
From the masterHZS/Motor-Driver repository on GitHub, at the commit this page was made from: the board is 01_PCB/DRV控制板/tools/vendor/example/kicad/kicad-project/kicad-project.kicad_pcb and its schematic 01_PCB/DRV控制板/tools/vendor/example/kicad/kicad-project/kicad-project.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Kicad project design in my own project?
Its repository states no licence, so its author keeps all rights: ask masterHZS before reusing the design.
Similar boards
- 2 layers40 × 30 mm

- 2 layers51.9 × 16 mm

Passive2-rpi non standard adapter
hzeller/rpi-rgb-led-matrix
Controlling up to three chains of 64x64, 32x32, 16x32 or similar RGB LED displays using Raspberry Pi GPIO
3 parts4.4kGPL-2.0 - 2 layers16.3 × 16.3 mm

- 2 layers

Sub
atopile/atopile
Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️
3 parts4kMIT - 2 layers85 × 30 mm

- 2 layers124.5 × 33.7 mm

- 2 layers10.5 × 83 mm

- 2 layers21.2 × 51.3 mm

Pico reset
hackclub/sprig
🍃 Learn to code by making games in a JavaScript web-based game editor.
3 parts1.1kMIT