- SPI3 与 串口3 串口5(SPI3的三个引脚)。串口3 与 RS485-3 只能保留一个
- 方案1: U3和U5(舍弃掉SPI3和RS485-3)
方案2: SPI3和RS485-3(U3和U5)
- IIC1和串口4,引脚复用:选择串口4
- USB-HID
- QSPI-Flash
- Cortex‑M7 内核相关
- 分支预测
- MPU 内存保护单元
- Cache 缓存
- 看门狗、DWT 驱动
- 多种电机驱动开发(DJI DM)
- 舵机、BMI088、及国产陀螺仪驱动
-
串口协议裁判系统、遥控器、云台、功率控制、发射机构、超电、底盘控制等等
- 没测试改后的BSP层,但应该99%没问题
- device层中的代码很久没测了,需要测试
- app层仍旧在规划,各种test还没写,以及具体的代码应该实现什么,还在规划
- protocol_uart还是很难绷,目前没有代码在用,框架没问题,但是实际没有在用的
- menu太敷衍了,需要移植一个好看的ui出来,我实现的这个非常敷衍而且简单,包括触发使用的方式和处理
- SPI和IIC的回调问题,目前使用的都是阻塞。但是这种通讯模式好像阻塞最适合,因为需要建立连接和等待,例如CS拉高拉低、IIC的处理。
root
│ │.clang-format 代码格式化设置 可以按照自己风格改
│ │.clangd clangd 语言服务器配置
│ │.gitignore git 忽略文件
│ │CMakeLists.txt 主构建脚本
│ │CMakePresets.json CMake 预设配置
│ │DM_MC02.ioc STM32CubeMX 工程文件
│ │README.md 本文件
│ │startup_stm32h723xx.s 启动文件
│ │STM32H723XG_FLASH.ld 链接脚本
│ |---
├─.vscode |`tasks`是终端执行的任务
| |如果想使用烧录和调试功能,需要工程名字和文件夹名字一样才可以(elf/hex文件名字和主文件夹名字相同)
├─build |---
│ └─Debug |编译出来的临时文件
├─cmake |---
│ └─stm32cubemx |STM32的库以及cmake链接方式
├─Core |---
│ ├─Inc |STM32的HAL层头文件
│ └─Src |STM32的HAL层源文件
├─docs |文档与图片
│ ├─编码规范.md
│ ├─分层规划图.png
│ └─CtrBoard-H7管脚标注图.pdf
├─Drivers |STM32的Driver层文件
├─Flash |个人写的烧录相关 工程名字和文件夹名字一样才可以烧录 写好了DAP和JLink 以及win和linux的烧录脚本 ozone
├─Middlewares |官方生成的中间件库,FreeRTOS,USB
├─tinyusb-0.20.0 |TinyUSB库
└─User |---
├─CMakeLists.txt |User库一键导入配置
├─Bsp |板载支持驱动
│ ├─bsp_buzzer.cpp / hpp
│ ├─bsp_can.cpp / hpp
│ ├─bsp_cfg.cpp / hpp
│ ├─bsp_gpio.hpp
│ ├─bsp_key.cpp / hpp
│ ├─bsp_uart.cpp / hpp
│ ├─bsp_usb.cpp / hpp
│ └─tusb_config.h
├─Device |设备层
│ ├─device_cfg.cpp / hpp
│ ├─device_emmv5.cpp / hpp
│ ├─dm_imu.cpp / hpp
│ ├─emm_frame.hpp
│ ├─JC2804.cpp / hpp
│ ├─Lcd.cpp / hpp
│ └─LcdFont.hpp
├─Module |模块层( 多个设备组合 )
│ └─menu.cpp / hpp
├─Protocol |协议层
│ ├─data_pack.cpp / hpp
│ ├─protocol_cfg.cpp / hpp
│ └─protocol_uart.cpp / hpp
├─Service |服务层( 状态码 / 类型工具 )
│ ├─status.hpp
│ └─uart_type_list.hpp
├─Algorithm |算法层
│ ├─pid.cpp
│ └─pid.hpp
└─App |应用层 / c cpp混编接口层
├─api_main.cpp / h
├─app_task.hpp
├─app_test.hpp
├─task/ |业务任务(除默认任务外)
│ └─task_menu.cpp
└─test/ |测试任务
└─msg_task.cpp
我认为:ST官方生成的属于BSP的一部分 以及 Service的一部分
freertos的硬件支持、usb的硬件支持,外设封装好的支持等等,本质上都在硬件抽象(hal)。但是板载支持包(bsp)不仅要硬件抽象,是要完全不考虑硬件,只需要简易的使用代码就可以操控整个板子的外设,不需要考虑板子上的任意情况。这是bsp要做的,也是最麻烦的。
其他的device等等很好理解,只需要在写好的bsp层的基础上,对要做处理的设备进行处理即可
本工程已经配置好 CMake Presets、VS Code Tasks 和 Cortex-Debug。以下 Linux 链路于 2026-09-01 在本仓库和实机 STM32H723 上验证通过:
| 能力 | 状态 | 已验证的链路 |
|---|---|---|
| 编译 | 已实测 | CMake 3.22 + Ninja 1.10 + Arm GNU Toolchain 15.3,成功生成 build/Debug/DM_MC02.elf |
| 烧写 | 已实测 | CMSIS-DAPv2 + OpenOCD,经 SWD 完成 program、verify 和 reset,校验结果为 Verified OK |
| 调试 | 已实测 | OpenOCD GDB Server + arm-none-eabi-gdb,成功识别 Cortex-M7、连接目标、复位暂停并读取寄存器 |
| J-Link | 配置存在,当前未实测 | 烧写脚本使用 OpenOCD 的 jlink 适配器;当前没有 J-Link 探针,不能据此声称实机链路可用 |
| Windows 脚本 | 配置存在,当前未实测 | Flash/*.bat 未在 Windows 环境验证 |
cmake、ninja、arm-none-eabi-gcc和arm-none-eabi-gdb在PATH中。- CMSIS-DAP 链路需要
openocd,并将探针通过 SWD 接到目标板。 - VS Code 图形化调试需要 Cortex-Debug;代码索引建议安装 clangd,任务按钮为可选插件。
- J-Link 烧写需要 OpenOCD 包含
jlink/libjaylink 适配器;Ozone 或 J-Link GDB Server 调试仍需安装 SEGGER J-Link Software。 - 当前脚本和
.vscode/launch.json用工作区目录名寻找 ELF,因此工作区目录名、CMake 工程名和输出文件名应保持为DM_MC02。若重命名工程,需要同步修改这些配置。
首次配置并编译:
cmake --preset Debug
cmake --build --preset Debug后续仅编译:
cmake --build build/Debug使用 CMSIS-DAP 烧写(脚本会分别烧写内部 HEX 和外置 USB XIP BIN,并执行校验和复位):
./Flash/OpenOCD_flash.sh使用 J-Link 探针烧写(经 OpenOCD jlink 适配器,当前环境未连接 J-Link 探针):
./Flash/JLink_flash.shTerminal: Run Task中可运行Configure、Build、Clean_Rebuild、Clean以及 Linux/Windows 的 OpenOCD、J-Link 烧写任务;默认构建任务Build可用Ctrl+Shift+B运行。- 在“运行和调试”中选择
cmsis-dap-debug,即可通过 OpenOCD 启动 Cortex-Debug,会装载build/Debug/DM_MC02.elf并运行至main。 jlink-debug配置已经存在,但需安装 SEGGER J-Link 软件后再使用,当前环境未实测。- Cortex-Debug 可查看变量、寄存器、内存和基本的 FreeRTOS 运行信息;外设寄存器描述文件位于
Flash/STM32H723.svd。 Flash/linux.jdebug是 Ozone 工程示例,其中含创建者机器的绝对路径、探针序列号和 Ozone 版本信息,换机器后必须在 Ozone 中重新选择 ELF 与探针,不能直接视为通用配置。
相关配置文件:.vscode/tasks.json、.vscode/launch.json、Flash/daplink.cfg 和 Flash/README.md。
2026-09-01 已使用 C620(绿色双闪,ID 为 2)和 M3508 完成实机验证:CAN 波特率为 1 Mbps,控制帧标准 ID 为 0x200,ID2 的电流指令放在 DATA[2:3](高字节在前),反馈帧标准 ID 为 0x202。本次成功连接使用同面线;控制板和电调均需正确供电,CANH/CANL 线序及终端电阻应按硬件说明检查。
低电流短时测试已移至 User/App/test/motor/dji_motor_test.cpp:启动 2 秒后向 ID2 发送原始电流值 512(约 0.625 A),持续 1 秒后恢复为零。测试由 User/App/app_test.hpp 中的 APP_TEST_DJI_MOTOR_ENABLED 控制;默认值为 0,因此正常烧写或复位不会驱动电机。启用测试前必须将电机架空或可靠固定。
基于 DjiMotor/DjiMotorBus 新框架的实测结果为:测试任务通过,收到并成功分发 0x202 反馈 20330 帧、忽略 0 帧,峰值转速 3532 rpm,CAN 发送错误计数、接收错误计数和 Bus-Off 均为 0;测试结束后内部 0x200 帧四个输出槽位均为零。可在 Live Watch 中查看 dji_motor_task_* 和 dji_motor_test_* 诊断量。
若 can1_statu 从 Status::OK 变为持续 Status::FULL,应先检查错误计数和 Bus-Off;本次故障由 CAN 连接线序不正确导致,自动重发最终占满发送 FIFO,而不是任务未执行或软件发送缓冲区本身太小。
严格在每一个.c .cpp中写接口转接文档,每个不能调用的东西都进行接口转接。
写接口转接文档,发现在嵌入式中,只需要给main.c进行转接,使用api_main来当作提取出来的main即可。这样写的中断回调 初始化 while循环都没啥问题,FreeRTOS也是这样,只需要extern "C" 就可以了
HAL库也早就写好了cpp调用c的extern "C"内容
作为c调用cpp的转接cpp文件的就写api_xxxx.cpp和api_xxx.h 作为区分 用**h**
正常cpp文件为:xxx_yyyy.cpp 和 xxx_yyyy.hpp 作为区分 用**hpp**
xxx为 app bsp alg
为了更方便的添加.c .cpp文件 在User文件夹内添加了一个子文件夹的CMakeLists.txt,这些可以实现一键导入User的库
现在只需要在主CMakeLists.txt的最后一行添加:
##### User #####
add_subdirectory(User)
# Add stm32cubemx to User_lib
target_link_libraries(User_lib PRIVATE stm32cubemx)
# Add TinyUSB include to Userlib
target_include_directories(User_lib PUBLIC
${TINYUSB_DIR}/src
)
# Add User_lib to main
target_link_libraries(${CMAKE_PROJECT_NAME}
User_lib
)
# 结尾部分
target_link_options(${CMAKE_PROJECT_NAME} PRIVATE -u _printf_float)
##### User #####关于tinyusb,在user后面添加此内容
### Add TinyUSB sources ###
set(TINYUSB_DIR ${CMAKE_CURRENT_SOURCE_DIR}/tinyusb-0.20.0)
include(${TINYUSB_DIR}/src/CMakeLists.txt)
tinyusb_target_add(${CMAKE_PROJECT_NAME})
target_sources(${CMAKE_PROJECT_NAME} PRIVATE
${TINYUSB_DIR}/src/portable/synopsys/dwc2/dcd_dwc2.c
${TINYUSB_DIR}/src/portable/synopsys/dwc2/dwc2_common.c
)
# Add TinyUSB include to main
target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE
${TINYUSB_DIR}/src
)
# Add project symbols (macros) <= tinyusb
target_compile_definitions(${CMAKE_PROJECT_NAME} PRIVATE
# Add user defined symbols
CFG_TUSB_MCU=OPT_MCU_STM32H7
CFG_TUSB_OS=OPT_OS_FREERTOS
)
### Add TinyUSB sources ###以及在最后一行,添加此内容,增加了对浮点数打印的支持
target_link_options(${CMAKE_PROJECT_NAME} PRIVATE -u _printf_float)为了DMA传输,把需要用到DMA的东西的存储,换到了DTCM之外
__attribute__((section(".dma_buffer"))) 使用这一个缀修饰修改ld文件的内容如下,中文注释之间为添加内容,多余的内容是定位用的
.fini_array (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */
{
. = ALIGN(4);
PROVIDE_HIDDEN (__fini_array_start = .);
KEEP (*(SORT(.fini_array.*)))
KEEP (*(.fini_array*))
PROVIDE_HIDDEN (__fini_array_end = .);
. = ALIGN(4);
} >FLASH
/* === 用户为dma传输配置的内存地址 === */
.dma_buffer (NOLOAD) :
{
. = ALIGN(32);
_sdma_buffer = .;
*(.dma_buffer)
*(.dma_buffer*)
. = ALIGN(32);
_edma_buffer = .;
} >RAM_D1
/* === 用户dma相关配置结束 === */
/* used by the startup to initialize data */
_sidata = LOADADDR(.data);
/* Initialized data sections goes into RAM, load LMA copy after code */
.data :
{
. = ALIGN(4);
_sdata = .; /* create a global symbol at data start */
*(.data) /* .data sections */
*(.data*) /* .data* sections */
*(.RamFunc) /* .RamFunc sections */
*(.RamFunc*) /* .RamFunc* sections */
. = ALIGN(4);
} >DTCMRAM AT> FLASH使用: 在include头文件后面添加
// IWYU pragma: keep
可以规避 Included header XXX.h is not used directly (fixes available) 这个错误
- 初始化
- 先声明
DmMotor<电机型号> 电机名称(can_item, esc_id, master_id, mode); - 然后调用
.init()
- 先声明
- 数据只读接口
.data()获取电机的运动学数据,以弧度值为单位.feedback()达妙电机的原始反馈数据.online().isOnline()电机在线情况检查.lvbo_data()观测器获得的运动学数据,以弧度值为单位。默认无观测器配置.drive_state()查询电机错误码.enable_state()查询电机使能状态.status()查询最近一次的电机状态
- 功能接口
.set_mit_target(position, velocity, kp, kd, torque)设置MIT模式下的控制目标.set_position_velocity_target(position, velocity_limit)设置位置-速度模式下的控制目标.set_velocity_target(velocity)设置速度模式下的控制目标.set_position_torque_target(position, velocity_limit, current_limit_ratio)设置力位混控模式下的控制目标.enable()使能电机.disable()失能电机.clear_error()清除电机错误位.save_current_position_as_zero()以当前位置保存为位置零点
电机对象持有电机发送管理对象_tx_endpoint
