Files
Simba-OmniInfantry/底盘
LSMushui e3d432f3b5 refactor(modules): 按角色重排 modules/ 目录,消除命名不一致
原 modules/ 下目录大小写混用(BMI088/BUZZER/DR16/IST8310/LED/PID 为大写,
attitude/c_comm/filter/gimbal/ins/motor/referee/shoot 为小写),且把第三方
移植代码(QuaternionEKF/kalman_filter)与本工程封装(ins)混在同一目录。

新结构(全部小写,按角色分层,第三方代码单独隔离):

  modules/
    algorithm/   pid.c/h  filter.c/h          通用算法
    imu/         attitude.c/h  ins.c/h        姿态与惯导封装
    imu/qekf/    QuaternionEKF.c/h  kalman_filter.c/h
                                              (移植自 Wang Hongxi INS 例程)
    sensor/      bmi088.c/h  ist8310.c/h      板载传感器驱动
    comms/       dr16.c/h  c_comm.c/h  referee.c/h
    motor/       dji_motor.c/h                电机抽象
    control/     gimbal.c/h  shoot.c/h        整车控制逻辑
                 (底盘为 chassis.c/h)
    dev/         led.c/h  buzzer.c/h          板级指示/发声

共移动 58 个文件(每板 29 个),旧目录全部删除。

工程文件同步(每个工程各 2 个):
- .uvprojx: Modules 分组 16 个 <FilePath> 改为新路径;
  2 个非空 <IncludePath> 元素:15 个旧模块路径收敛为 8 个新目录,
  并顺带删除陈旧项 ../modules/AHRS(目录根本不存在,legacy 时代残留)
  与冗余项 ..\bsp(与 ../Bsp/Inc 重复)
- .uvoptx: 16 个 <PathWithFileName> 同步

关于"为什么不用改源码": Keil 的 include 靠 IncludePath 解析,本工程所有
#include 都是纯文件名形式(无路径限定),所以移动目录只需改工程配置。
另外 .h 完全不登记在工程里(只有 16 个 .c 被登记),故头文件只需移动。

回归验证(无法在此环境编译,用等价判据):
- 两个工程引用的 98 / 95 个 <FilePath> 全部真实存在
- 磁盘上 47 / 45 个 .c 全部仍被工程引用 —— 即没有任何文件掉出编译
- 2 个 IncludePath 元素均含全部 8 个新模块目录,无旧路径残留
- 所有 IncludePath 指向的目录均真实存在
- .uvprojx/.uvoptx XML 良构
- 两棵树结构一致(chassis/gimbal 等板级差异符合预期)

⚠️ 仍需在 Keil 里点一次编译确认(见 README 的构建章节)。
2026-09-12 11:51:41 +08:00
..

Simba-ELCT-FrameWork

Simba-git ELEC

Author language license

简介

Simba自己的C板电控框架!

本项目的计划是基于 DJI C型开发板 的基础上打造一个更适合Simba同学们的代码框架

本框架致力于实现不同类型的机器人的代码通用化,只需要选择底盘云台的类型,修改一下对应物理参数即可实现对机器人的适配

配套套件

上位机,ROS接口待开发

模块支持

详细信息请参考 Simba-ELCT-FrameWork文档

主要模块

  • Robot cmd
    机器人控制模块:
    • 大疆电机
    • 达妙电机
    • 瓴控电机
    • 小米电机
    • 超级电容控制板
    • 板间通信(CAN)
    • PWM 控制舵机
    • PWM 控制气泵
  • Chassis
    底盘模块:
    • 麦轮底盘
    • 全向轮底盘
    • 舵轮底盘
    • 平衡底盘
  • Gimbal
    云台模块:
    • yaw-pitch 直连云台
    • yaw直连-pitch丝杆 云台
    • yaw-pitch 丝杆云台
  • Shoot
    发射机构模块:
    • 摩擦轮+拨弹盘
    • 摩擦轮+弹鼓+推杆
  • Communication
    通信模块:
    • 板间通信(CAN2)
    • 上下位机通信
  • Music
    音乐模块:
    • 开机声
    • 报错音
    • 裁判系统接入提示音
    • 《卡农》
    • 《天空之城》
    • 《恭喜发财》
    • 《好运来》
    • 《See You Again》
    • 《Unity》
    • 《你》

开发工具

本项目使用HAL库编写,通过CubeMX生成项目,使用FreeRTOS

使用VSCode作为代码编辑器,Keil5作为IDE

Keil5编译器使用AC6版本

虽然keil5老,但在嵌入式调试以及环境配置方面是非常简单易上手的。千万不要用keil5来编辑代码!!!

VSCode作为现代化代码编辑器 ,通过各种插件即可实现各种提高效率的开发方式,尤其是Github Copilot

AC6编译器相比古早AC5编译器效率更高,AC5编译空项目就要足足1min47s,非常不中,相比之下AC6只需要6s,遥遥领先

但是CubeMX开启FreeRTOS无法直接使用AC6编译器
强烈建议通过此教程(From COD战队GrassFan Wang)配置好自己的环境

欢迎贡献

如果你发现了本项目中的问题和可优化的点,可用创建issue进行讨论

并且fork本项目后提交pr来贡献你的代码

我们的管理员审核后会将你的代码合并进来

贡献代码时请参照 注意事项 中的贡献代码部分。

编写代码时参考API

开发日志

LOG.md 记录了大家在开发过程中的各种奇思妙想和经验。多翻一翻或许能发现惊喜哦。大家有什么想法也都可以往里面写

API.md 为开发过程中所使用的模块接口标准,若在编写代码时发现代码与标准冲突,基于本标准修改代码

后续计划

具体要做的事情在TODO中

致谢

感谢各个战队的代码开源,所有本框架涉及到的主要的参考资料位于reference.md

附录

本文的详细补充内容写在 附录 中

如发现本项目中的问题,请添加至问题列表并与相关负责人联系,如果有解决方案可以提交pull request

通讯信息

  • 作者 连山木水 微信:18088745066 QQ:1194309310