Skip to content

README.md

Latest commit

 

History

History
52 lines (37 loc) · 1.83 KB

README.md

File metadata and controls

52 lines (37 loc) · 1.83 KB
Raw

Embedded-Electronic-Control-Standard

AgroTech 协会公共 MCU SDK

Standard 只维护可跨项目复用的 infra / domain / device 项目自行维护 app / service / service/assemble / platform 与机械安装配置

快速入口

入口 用途
设备 SDK 电机 遥控 IMU RGB 舵机
SDK 接入 项目如何引用和组装
架构边界 分层 PortOps 单位与项目边界
模块状态 判断模块成熟度
当前计划 当前剩余工作
协作指南 Issue Branch PR 与合并流程

引用方式

成员项目通过 submodule 固定负责人确认过的 Tag 或 commit

git submodule add https://github.com/AgroTech-SCAU/Embedded-Electronic-Control-Standard.git external/Embedded-Electronic-Control-Standard
cd external/Embedded-Electronic-Control-Standard
git fetch --tags
git switch --detach <tag-or-commit>

克隆成员项目后执行

git submodule update --init --recursive

使用规则

  • 不复制 SDK 到成员项目维护第二份实现
  • platform 提供 CAN UART SPI GPIO 时基和临界区等底层能力
  • service/assemble 负责 PortOps 配置 实例存储和真实硬件绑定
  • device 不直接依赖 HAL FSP CubeMX 项目头或具体外设句柄
  • position 使用 rad velocity 使用 rad/s 长度使用 m torque 只表示 N·m
  • CAN ID 电机方向 零位 机械补偿和比赛业务留在项目侧
  • 涉及执行机构必须有 stop timeout fault 和人工恢复路径

验证与发布

validation/ 只保存最小集成工程和复现入口，不复制正式 SDK

模块成熟度以 module-status 为准

正式 Release 由项目负责人在代码 文档和必要真机结果确认后创建