Skip to content
cubot-refactor-code-planPublic

About

No description, website, or topics provided.

Resources

Stars

5 stars

Watchers

1 watching

Forks

Repository files navigation

CUBOT Code Rebuild:

引脚冲突(工程中使用的方案)

  1. SPI3 与 串口3 串口5(SPI3的三个引脚)。串口3 与 RS485-3 只能保留一个
  • 方案1: U3和U5(舍弃掉SPI3和RS485-3)
  • 方案2: SPI3和RS485-3(U3和U5)
  1. IIC1和串口4,引脚复用:选择串口4

todo

  • 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层的基础上,对要做处理的设备进行处理即可

alt text

如何开发

编译、烧写和调试

本工程已经配置好 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。若重命名工程,需要同步修改这些配置。

命令行使用(Linux)

首次配置并编译:

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.sh

VS Code 使用

  • Terminal: 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。

CAN1 驱动 C620/M3508 实机验证

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,而不是任务未执行或软件发送缓冲区本身太小。

因为底层驱动涉及cpp,解决方法:

严格在每一个.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

修改的文件

CMakeList

为了更方便的添加.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)

.ld文件

为了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

让clangd 不报头文件未使用的错误(间接使用 clangd识别不出来)

使用: 在include头文件后面添加

// IWYU pragma: keep

可以规避 Included header XXX.h is not used directly (fixes available) 这个错误

技术细节

Algorithm 算法

Bsp 驱动

Device 设备

DM_Motor 达妙电机驱动

使用接口
  • 初始化
    • 先声明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

实现细节

Module 模块

Protocol 协议

Service 服务

motor_tx_manager

online_check

About

No description, website, or topics provided.

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages