Skip to the content
4 layers50 × 70 mmFOC2, the printed circuit board in 3D

这是一个基于 STM32G473RC 的实验性三相 PMSM/BLDC 电机控制平台。仓库包含驱动板设计,以及使用 Rust 2024 + Embassy 实现的电流控制型磁场定向控制(FOC)固件。

Size
50 × 70 mm
Copper layers
4
Thickness
1.6 mm
Parts
124
Nets
111
Pads
453
Tracks, vias
712, 666
Pours
470
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
31 Aug 2026
Updated
29 Oct 2026

Overview

FOC2 is an open-source printed circuit board by IpinZhu, from the IpinZhu/foc-esc repository on GitHub, published under the MIT licence. It is a 4-layer board of 50 × 70 mm with 124 parts on 111 nets, routed with 712 tracks and 666 vias.

It is built around the INA240A2PW, UCC27211D and SY8303AIC, with the TPS61170DRV, ME6211C33M5G-N and MBR0540 among its other parts. Its parts include 45 capacitors, 41 resistors, 12 ICs, 6 transistors and 3 diodes. It belongs with the STM32 boards of this library.

Main components

7

README

README.md

STM32G473 三相 FOC 驱动器

这是一个基于 STM32G473RC 的实验性三相 PMSM/BLDC 电机控制平台。仓库包含驱动板设计,以及使用 Rust 2024 + Embassy 实现的电流控制型磁场定向控制(FOC)固件。

安全提示: 这是一个大电流电力电子原型。固件和 PCB 尚未完成生产级电气鉴定或验证。在使用合适的实验设备和限流措施检查栅极波形、死区时间、电流采样极性、ADC 时序、故障响应、绝缘/间距和热性能之前,不要连接电机或电池。

当前实现

当前固件位于 software/firmware,目标芯片为 STM32G473RC:

  • TIM1 中心对齐互补 PWM,输出引脚为 PA8/PA9/PA10 和 PB13/PB14/PB15。
  • 配置的 PWM 频率:100 kHz。
  • 配置的死区时间:在 170 MHz 定时器时钟下为 200 ns。
  • 占空比范围:5%–95%。
  • 通过 INA240A2 放大器和 0.5 mΩ 分流电阻进行三相电流反馈。
  • 由定时器触发 ADC,对相电流、VBUS 和 TMP235 温度传感器进行采样。
  • 支持电流 FOC、速度 FOC、开环控制、启动电流偏置校准、SVPWM、遥测和软件故障处理。
  • 带版本和 CRC 的双槽 Flash 参数持久化:上电自动加载,UART param ... 命令和 CAN 参数帧可读取、设置、保存或恢复出厂参数。
  • 电机参数自整定(Auto-Tune):autotune start 执行 Rs/L/磁链辨识、电流环 PI 计算与阶跃验证、基于转子传感器的开环同步校验和观测器参数配置,结果保存为带 CRC 的电机参数档案,重启后自动应用。观测器/PLL 阶段目前仅生成与校验参数,尚未实现无感角度估算、HFI 或无感闭环接管。
  • 编译期选择转子传感器:
    • sensor-encoder(默认):TIM3 正交编码器,连接 PB4/PB5。
    • sensor-hall:TIM3 Hall 输入捕获,连接 PC6/PC7/PC8。
  • USART3 ASCII 调试命令,连接 PB10/PB11。
  • FDCAN1 classic CAN 控制和遥测,连接 PA11/PA12。

当前固件采用纯软件保护。本轮没有启用 COMP→DAC→TIM1-BRK 硬件过流链。软件保护包括电流阈值/去抖、相电流残差、母线欠压/过压、模型温度和传感器温度、堵转、传感器有效性以及控制超时处理。软件保护不能替代经过验证的硬件关断路径。

系统概览

text
                    +-----------------------------+
  编码器 / Hall --->|                             |--> TIM1 互补 PWM
  相电流 ---------->|       STM32G473RC           |       (100 kHz, 200 ns)
  VBUS / TMP235 --->|       Rust + Embassy        |--> UCC27211 x3
  UART ------------>|       FOC 控制器            |--> 070N10NS 级三相桥
  FDCAN ----------->|                             |<-- INA240A2 x3 + 分流电阻
                    +-----------------------------+

固件将高速控制路径与通信路径分离。ADC 帧唤醒电机控制任务;UART 和 CAN 任务通过有界的 Embassy 同步原语交换命令和遥测数据。

上位机的真实设备连接使用 v2 PC 桥接、加密 ESP-NOW 链路和电机端 UART 桥接;连接后需要设备身份握手、控制权申请和心跳。浏览器及桌面模拟器用于界面与会话测试,不是包含真实机械动力学的无感控制仿真。当前没有整机板级联调通过的验证记录。

仓库结构

路径用途
software/firmwareRust/Embassy STM32G473RC 固件
software/foc-simRust 主机仿真 M1:有感 FOC 与独立 PMSM 电气/机械模型
software/host-appVue + Tauri 上位机;监控、参数管理、控制、自整定入口与录制导出
software/esp32-pc-bridge原生 ESP-IDF / ESP32-C3 串口与 ESP-NOW 桥接;替代旧 PlatformIO 工程
software/foc-wire固件与上位机共享的 no_std v2 帧协议、CRC 与控制权租约
hardware/foc-drive/FOC2.kicad_pro主驱动板 KiCad 工程
hardware/foc-drive/FOC2.kicad_sch主驱动板原理图
hardware/foc-drive/FOC2.kicad_pcb主驱动板 PCB 布局
hardware/foc-expansion/foc-ex.kicad_pro扩展板 KiCad 工程
hardware/foc-expansion/foc-ex.kicad_sch扩展板原理图
hardware/foc-expansion/foc-ex.kicad_pcb扩展板 PCB 布局
foc/foc.iocSTM32G473 CubeMX 参考配置;不是运行时固件的唯一依据

生成的生产文件、编辑器状态、备份文件和固件二进制文件不属于设计源文件。

构建和测试

以下命令均从 software/firmware 目录执行。由于固件的默认 Cargo 目标是 thumbv7em-none-eabihf,主机测试必须显式指定主机目标。

主机测试和 lint

bash
cargo fmt -- --check
cargo test --target x86_64-pc-windows-msvc
cargo clippy --target x86_64-pc-windows-msvc --test fault_protection --test fault_recovery_and_diagnostics -- -D warnings

故障诊断集成测试位于 software/firmware/tests/,会使用主机仿真的 ADC 帧和转子采样,不会驱动真实 PWM 或功率级。

Encoder 固件

bash
cargo build --bin foc-firmware

Hall 固件

bash
cargo build --release --bin foc-firmware \
  --no-default-features --features sensor-hall

固件 .cargo/config.toml 配置了 thumbv7em-none-eabihf、link.x、defmt.x 以及针对 STM32G473RC 的 probe-rs 烧录运行器。烧录需要正确连接且获得授权的调试探针;本文档不会执行烧录操作。

软件仿真计划

无感 FOC 软件仿真实施方案 定义了独立 Rust 电机模型、现有固件闭环接入、非理想因素、旁路观测器及无感接管的阶段和验收标准。主机仿真 M1 已实现有感物理闭环基线和使用实际转子动力学的自整定参数验证,M2–M5 尚未实施;当前上位机模拟器和自整定流程测试不代表完整的无感物理仿真。

硬件概要

主驱动设计基于以下器件和目标:

  • STM32G473RC,170 MHz Cortex-M4F 电机控制 MCU。
  • 三个 UCC27211 半桥栅极驱动器。
  • 六个 100 V 级 N 沟道 MOSFET 位置,组成三相桥。
  • 三个 INA240A2 双向电流采样放大器。
  • 三个 0.5 mΩ、带 Kelvin 引线的分流电阻。
  • 面向 2S–6S 电池的母线设计目标,约 5.5–25.2 V。
  • VBUS 分压采样和 TMP235 模拟温度传感器。
  • USART3、FDCAN1、SWD、编码器、Hall 和扩展接口。

器件额定值、热限制、自举电路尺寸、开关损耗和电流能力在实际装配电路板完成测量前都只是工程目标。详细计算和待解决问题见开发机上的本地设计说明;该文件有意不纳入共享仓库。

验证状态和限制

软件构建和主机测试覆盖了当前实现,但不能证明功率级运行安全。在加电连接电机之前:

  1. 检查已装配电路板,确认器件安装、极性、间距、接地和 Kelvin 电流路径正确。
  2. 在功率级未上电时,检查全部六路 PWM 波形、互补极性、空闲行为、MOE 关断和实测死区时间。
  3. 使用低电压限流电源,验证 ADC 偏置、电流极性/比例、VBUS 比例、温度换算、转子方向和电角度零点对齐。
  4. 通过受控故障注入逐项执行软件保护测试。
  5. 根据 10 µs PWM 周期测量控制环最坏执行时间。
  6. 在逐步增加负载的过程中测量栅极驱动器、MOSFET、分流电阻和电路板温度。
  7. 在目标物理接线下确认 UART 和 CAN 行为。

因此,100 kHz 只是配置的运行目标,并不代表已证明装配后的硬件可以长期连续运行在该频率。如果时序、开关损耗、EMI、自举刷新或热测试结果不可接受,应降低集中配置中的 PWM 频率并重新进行全部验证。

许可证和贡献状态

固件 crate 声明采用 MIT OR Apache-2.0 许可证,仓库根目录的 LICENSE 为 MIT 许可证。本项目目前仍处于积极的工程开发阶段;在将改动视为可发布版本之前,应结合硬件设计进行审查,并在目标电路板上完成验证。

Parts

124
QtyValueFootprintReferences
1822Resistor_SMD:R_0603_1608MetricR1, R2, R10, R11, R17, R18, R29, R30, R31, R32, R33, R34, R35, R36, R37, R38 +2
16100nFCapacitor_SMD:C_0603_1608MetricC3, C4, C5, C6, C7, C12, C13, C14, C15, C19, C20, C29, C31, C35, C44, C45
154.7uFCapacitor_SMD:C_0603_1608MetricC1, C2, C8, C9, C10, C11, C16, C17, C18, C24, C27, C33, C34, C40, C42
810kResistor_SMD:R_0603_1608MetricR3, R4, R13, R14, R22, R23, R27, R41
6100nfCapacitor_SMD:C_0603_1608MetricC36, C37, C38, C39, C41, C43
6Q_NMOS_SGDPackage_SON:VSONP-8-1EP_5x6_P1.27mmQ1, Q2, Q3, Q4, Q5, Q6
522uFCapacitor_SMD:C_1210_3225MetricC21, C22, C23, C25, C26
4100KResistor_SMD:R_0603_1608MetricR16, R21, R25, R39
4MountingHole_PadMountingHole:MountingHole_3.2mm_M3_ISO7380_PadH1, H2, H3, H4
30.0005Resistor_SMD:R_2512_6332MetricR7, R15, R24
310KResistor_SMD:R_0603_1608MetricR20, R28, R40
3INA240A2PWPackage_SO:TSSOP-8_4.4x3mm_P0.65mmU1, U2, U6
3UCC27211DPackage_SO:SOIC-8_3.9x4.9mm_P1.27mmU3, U4, U5
210nFCapacitor_SMD:C_0603_1608MetricC30, C32
260RResistor_SMD:R_0603_1608MetricR8, R9
110uHInductor_SMD:L_Chilisin_BMRA00040420L2
113.7KResistor_SMD:R_0603_1608MetricR26
14.7uHInductor_SMD:L_Chilisin_BMRA00040420L3
14.99KResistor_SMD:R_0603_1608MetricR12
147nFCapacitor_SMD:C_0603_1608MetricC28
171.5KResistor_SMD:R_0603_1608MetricR19
1AMountingHole:MountingHole_3.2mm_M3_ISO7380_PadH7
1ACM2012-900-2PUser:ACM2012-900-2P-T001L1
1ASCOCrystal:Crystal_SMD_2016-4Pin_2.0x1.6mmY1
1BMountingHole:MountingHole_3.2mm_M3_ISO7380_PadH8
1CMountingHole:MountingHole_3.2mm_M3_ISO7380_PadH9
1Conn_02x12_Odd_EvenConnector_PinHeader_2.54mm:PinHeader_2x12_P2.54mm_VerticalJ1
1IN+MountingHole:MountingHole_3.2mm_M3_ISO7380_PadH5
1IN-MountingHole:MountingHole_3.2mm_M3_ISO7380_PadH6
1LEDLED_SMD:LED_0603_1608MetricD3
1LOGOLOGOG***
1MBR0540Diode_SMD:D_SOD-123D2
1ME6211C33M5Package_TO_SOT_SMD:SOT-23-5U7
1SM712Package_TO_SOT_SMD:SOT-23D1
1STM32G473RCTxPackage_QFP:LQFP-64_10x10mm_P0.5mmU12
1SY8303Package_TO_SOT_SMD:TSOT-23-8U10
1TCAN1044A-Q1Package_SON:HVSON-8-1EP_3x3mm_P0.65mm_EP1.6x2.4mmU8
1TMP235A2DBZRPackage_TO_SOT_SMD:SOT-23U11
1TPS61170Package_SON:WSON-6-1EP_2x2mm_P0.65mm_EP1x1.6mm_ThermalViasU9

The 122 most common of 124 parts.

More from IpinZhu/foc-esc

1
  • 2 layers50 × 70 mmFoc ex, the printed circuit board in 3D

    Foc ex

    IpinZhu/foc-esc

    这是一个基于 STM32G473RC 的实验性三相 PMSM/BLDC 电机控制平台。仓库包含驱动板设计,以及使用 Rust 2024 + Embassy 实现的电流控制型磁场定向控制(FOC)固件。

    20 partsMIT

Similar boards

  • 2 layers58.5 × 43.1 mmTorqController, the printed circuit board in 3D

    TorqController

    JoaoWMHentz/Kinematech_Torq

    135 parts
  • 4 layers208 × 129 mmMainboard v2 r1, the printed circuit board in 3D

    Mainboard v2 r1

    Benjamin-girard-1/geophys_acquisition_module

    Modular ESP32-S3 geophysical data-acquisition system with custom hardware, multi-channel ADC, GNSS, IMU, removable analog sensor cards, firmware, and host tools

    287 parts
  • 4 layers190 × 110 mmGeophys mainboard, the printed circuit board in 3D

    Geophys mainboard

    Benjamin-girard-1/magnetometer-node-old

    384 parts
  • 2 layers120 × 100 mmInoovatest Sub, the printed circuit board in 3D

    Inoovatest Sub

    jcchincheong-bb/Verificationator_GP-WS25-26

    Files for Group Project WS2526

    115 parts
  • 4 layers124 × 23 mmOctobot controller, the printed circuit board in 3D

    Octobot controller

    Deivid-Negoita/octobot

    An eight-legged walking robot I built end to end: chassis CAD, a 24-servo ATmega32U4 controller board, the firmware, and a browser IK workbench you can drive it from.

    120 parts1MIT
  • 4 layers40.5 × 40.5 mmHPM5361-RMCS Slave Lite, the printed circuit board in 3D

    HPM5361-RMCS Slave Lite

    Kaiser041224/HPM5361-RMCS_Slave-Lite

    HPM5361-RMCSSlave-Lite 是一个基于 HPM5361IEG1 的嵌入式控制板。以下说明是根据当前 KiCad 工程中的原理图层级、器件选型和 PCB 丝印整理出来的硬件简介;从接口组合来看,这块板更像是一个面向机器人或分布式控制系统的从控/通信节点。

    179 parts1
  • 4 layers100 × 50 mmMW Buck Boost CS, the printed circuit board in 3D

    MW Buck Boost CS

    Lightningyc/MPPT_Buck-Boost

    通信交互: 控制器通过 UART 接口与上位机软件 Vofa+ 通信,支持参数远程设定及实时运行数据(电压/电流)反馈。

    87 parts1MIT
  • 4 layers38 × 38 mmZero star, the printed circuit board in 3D

    Zero star

    Auodit/flyamaster

    STM32F407 Flight Controller with FreeRTOS

    144 partsCC-BY-SA-4.0

Questions

How big is the FOC2 PCB?

It measures 50 × 70 mm and has 4 copper layers, 1.6 mm thick.

What parts does the FOC2 use?

124 parts, built around the INA240A2PW, UCC27211D, SY8303AIC and TPS61170DRV. 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 FOC2 KiCad files?

From the IpinZhu/foc-esc repository on GitHub, at the commit this page was made from: the board is hardware/foc-drive/FOC2.kicad_pcb and its schematic hardware/foc-drive/FOC2.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the FOC2 design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).