acetaffy/AMI
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add CAN1 100 ms heartbeat with verified firmware and updated protocol PDF

Browse Source
This commit is contained in:
shenlefengnai-rgb
2026-10-04 19:00:32 +08:00
parent 1e7b2e7f96
commit dba8aa5ea9
21 changed files with 1398 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/AMI_CAN_DBC说明.md
+31 -5
View File
@@ -1,6 +1,6 @@
# AMI CAN DBC 说明
版本：`AMI-2.4-2026-10-03`。由 [AMI.dbc](../AMI.dbc) 自动生成，12 条报文、49 个信号。
版本：`AMI-2.5-2026-10-04`。由 [AMI.dbc](../AMI.dbc) 自动生成，13 条报文、53 个信号。
## 使用范围
@@ -11,16 +11,32 @@ CAN1 为 500 kbit/s，CAN2 为 250 kbit/s，均为 Classic CAN、87.5% 采样点
| CAN1 | 500 kbit/s | PA11 / PA12 | [AMI.dbc](../AMI.dbc) |
| CAN2 | 250 kbit/s | PB0 / PB1 | [AMI_CAN2_250k.dbc](../AMI_CAN2_250k.dbc) |
DBC 的 `Baudrate` / `AMIPort` 分别标注所属总线。每份 DBC 均含 12 条报文、49 个信号；同一份报文表适用于两路。CAN 工具必须按接入端口设置速率，导入 DBC 不一定自动改硬件速率。实际接法：SDC 500 kbit/s 接 CAN1，BMS 250 kbit/s 接 CAN2。
DBC 的 `Baudrate` / `AMIPort` 分别标注所属总线。CAN1 DBC 含 13 条报文、53 个信号；CAN2 DBC 含 12 条报文、49 个信号；仅 CAN1 包含 0x301 心跳，其余报文布局相同。CAN 工具必须按接入端口设置速率，导入 DBC 不一定自动改硬件速率。实际接法：SDC 500 kbit/s 接 CAN1，BMS 250 kbit/s 接 CAN2。
FDCAN 时钟 64 MHz，时钟分频为 1；NominalPrescaler 为 CAN1=8、CAN2=16，两路均使用 Sync=1、TimeSeg1=13、TimeSeg2=2、SJW=1。速率 = 64 MHz / Prescaler / (1+13+2)；采样点 = (1+13)/16 = 87.5%。
本 DBC 包含 AMI 唯一发送的 `0x300` 任务请求，以及 AMI 当前识别的 SDC / BMS 和自定义显示输入。SDC `0x6A3` DAC 控制、`0x6A5` ASSI 控制、BMS 其他电芯/故障字段不属于此接口子集。`0x182` 新增扭矩千分、电机温度和电机控制器 MCU 温度的仪表显示输入；发送者负责转换实际电机控制器协议。`0x183` 为新增 VCU 状态反馈，需 VCU 按此自定义接口发送；未定义标定后的车速或 AMI 周期心跳。旧 `0x180 / 0x181 / 0x280` 输入已停用。
本 DBC 包含 AMI 发送的 `0x300` 任务请求和 `0x301` 周期心跳，以及 AMI 当前识别的 SDC / BMS 和自定义显示输入。SDC `0x6A3` DAC 控制、`0x6A5` ASSI 控制、BMS 其他电芯/故障字段不属于此接口子集。`0x182` 新增扭矩千分、电机温度和电机控制器 MCU 温度的仪表显示输入；发送者负责转换实际电机控制器协议。`0x183` 为新增 VCU 状态反馈，需 VCU 按此自定义接口发送；未定义标定后的车速。旧 `0x180 / 0x181 / 0x280` 输入已停用。
SDC 字段依据 `SDC_ACQ_DAC.dbc` VERSION 1.1，保持其信号名、位布局、缩放和单位；仅将输入接收节点设为 AMI。BMS 字段依据 [BmsMonitor-CANTest](https://git.acetaffy.ltd/acetaffy/BmsMonitor-CANTest) 提交 `e65c95203d1689df05343775982d7e85bd782646` 的 `BmsProtocolParser.cs`。
DBC 为 ASCII 编码，注释和枚举使用英文，便于导入 CAN 工具；本文为 UTF-8 中文。物理值 = 原始值 × Factor + Offset；`0x182` 的三个数值为有符号 int16，其他数值按表定义。下表范围为接口允许范围，不表示车辆正常工作范围。
## AMI 周期心跳 0x301
2026-10-04 新增：标准 ID `0x301`、Classic CAN 数据帧、DLC 8。仅 CAN1（500 kbit/s）每 **100 ms** 尝试发送，CAN2 不发送心跳，不依赖接收活动或屏幕连接。首帧在启动约 100 ms 后发送。
| 字节 | 含义 |
| --- | --- |
| 0 | 协议版本，固定 1 |
| 1 | 保留，固定 0 |
| 2..3 | uint16 小端心跳序号，首帧 0，每个调度周期加 1，65535 后回到 0 |
| 4..7 | uint32 小端 `HAL_GetTick()` 运行时间，单位 ms，自然回绕 |
例如运行 100 ms 的首帧：`01 00 00 00 64 00 00 00`。任务请求先处理，心跳仅在发送 FIFO 至少有两个空位时入队，为任务保留一个空位；忙或入队失败时跳过本周期，不在软件中积压或补发。硬件自动重传仍启用，已入硬件 FIFO 的帧可能延迟到总线恢复后发出。100 ms 为主循环调度周期，实际总线时刻受仲裁/错误重传影响。序号按调度递增，因此丢帧时可以跳号。
仅表示 AMI 主循环运行，不表示屏幕、VCU 或车辆状态正常。2026-10-04 已烧录并全量回读一致；CAN1 抓取 121 帧，间隔 99.952～100.180 ms，序号连续，详见 [心跳测试报告](AMI心跳测试报告.md)。CAN2 未接线抓帧。
## 报文总览
| CAN ID | 类型 | DLC | 报文名 | 方向和作用 | 周期 / 触发 |
@@ -28,6 +44,7 @@ DBC 为 ASCII 编码，注释和枚举使用英文，便于导入 CAN 工具；
| `0x182` | 标准 | 8 | `AMI_DrivetrainDisplay` | VCU / 测试器 -> AMI：扭矩千分、电机温度、MCU 温度 | 100 ms |
| `0x183` | 标准 | 8 | `AMI_VCUStatus` | VCU -> AMI：实际当前任务、锁定状态、EBS 状态 | 100 ms |
| `0x300` | 标准 | 8 | `AMI_TaskRequest` | AMI -> VCU：用户确认后的任务选择请求 | 确认任务触发 |
| `0x301` | 标准 | 8 | `AMI_Heartbeat` | AMI -> VCU（仅 CAN1）：版本、序号、运行时间 | 100 ms |
| `0x6A0` | 标准 | 8 | `SDC_Heartbeat` | SDC -> AMI：板标识、版本、序号、上电时间 | 100 ms |
| `0x6A1` | 标准 | 2 | `SDC_ADC_InputVoltage` | SDC -> AMI：低压电池电压，精确 DLC=2 | 500 ms |
| `0x6A2` | 标准 | 8 | `SDC_InputFrequencies` | SDC -> AMI：PA0 / PA2 / PA6 / PB14 原始频率 | 20 ms |
@@ -40,7 +57,7 @@ DBC 为 ASCII 编码，注释和枚举使用英文，便于导入 CAN 工具；
扩展帧在 DBC 的 `BO_` 十进制 ID 中设置 bit31：`0x186040F3 -> 2556444915`，`0x186140F3 -> 2556510451`。CAN 工具中使用实际 29 位仲裁 ID 并选择扩展帧；bit31 不是总线上发送的仲裁 ID。
`GenMsgCycleTime` 填写已确认的 SDC 周期 100 / 500 / 20 ms，以及自定义 `0x182` 的约定周期 100 ms。其余帧未填写周期，默认 0 表示未指定，不据此推断 BMS 周期。
`GenMsgCycleTime` 填写已确认的 SDC 周期 100 / 500 / 20 ms，以及 `0x182`、`0x183` 和 `0x301` 的约定周期 100 ms。其余帧未填写周期，默认 0 表示未指定，不据此推断 BMS 周期。
## 信号布局
@@ -88,6 +105,15 @@ Start 为 DBC 起始位，位号从 0 开始。Intel `@1` 从最低有效位起
`Protocol_Version`：1 = Version_1；`Task_ID`：1 = Skidpad，2 = Acceleration，3 = Autocross，4 = Inspection_Test，5 = EBS_Test，6 = Manual_Driving；`Request_Source`：1 = AMI_HMI。
### 0x301 - AMI_Heartbeat
| 信号 | Start | 位数 | 字节序 | Factor | Offset | 单位 | 编码范围 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `Protocol_Version` | 0 | 8 | Intel | 1 | 0 | - | 1..1 |
| `Reserved` | 8 | 8 | Intel | 1 | 0 | - | 0（固定） |
| `Heartbeat_Sequence` | 16 | 16 | Intel | 1 | 0 | - | 0..65535 |
| `MCU_Uptime` | 32 | 32 | Intel | 1 | 0 | ms | 0..4.29497e+09 |
### 0x6A0 - SDC_Heartbeat
| 信号 | Start | 位数 | 字节序 | Factor | Offset | 单位 | 编码范围 |
@@ -296,7 +322,7 @@ python scripts/export_dbc_docs.py --check
python scripts/verify_dbc.py --sdc-dbc ../SDC_ACQ_DAC/SDC_ACQ_DAC.dbc
```
校验覆盖严格 DBC 解析（长度、信号越界与重叠）、12 个 ID 与固件宏对应、标准/扩展格式、49 个信号、发送/接收节点、SDC / 自定义帧周期、已知报文解码、六个任务号与计数边界编码、大端偏置电流、无效温度枚举、全负温度和截短 DLC。已安装并验证 cantools 44.1.0，接口参考 [cantools 官方文档](https://cantools.readthedocs.io/en/latest/)。
校验覆盖严格 DBC 解析（长度、信号越界与重叠）、13 个 ID 与固件宏对应、标准/扩展格式、53 个信号、发送/接收节点、SDC / 自定义帧周期、已知报文解码、六个任务号与计数边界编码、大端偏置电流、无效温度枚举、全负温度和截短 DLC。已安装并验证 cantools 44.1.0，接口参考 [cantools 官方文档](https://cantools.readthedocs.io/en/latest/)。
上述是静态及软件编解码验证，另校验两份 DBC 的速率、相同信号布局及源码 / CubeMX 位时序一致。v2.2 的烧录回读、新帧 CAN2 测试及串口显示核验状态见 [显示 CAN 测试报告](AMI自定义显示CAN测试报告.md)。v2.1 已完成烧录、完整 Flash 回读比对、CAN1 500K 与 CAN2 250K 到官方 HMI 调试器的实物测试，详见 [双 CAN 测试报告](CAN1_CAN2_v2.1测试报告.md)。之前 v2.0 的 CAN 盒 -> 实物 AMI CAN1 / MCU -> USART2 -> COM4 -> 官方 HMI 调试器的实际更新和六个任务回传见 [联调报告](SDC_BMS联调报告.md)。物理串口屏、真实 SDC/BMS 节点、两路同时接入和车辆执行动作尚未实测；文档生成和 DBC 解析不替代这些测试。