结论:这是一份以起亚 Soul EV(PS)命名的 DBC 数据档案,由两部分组成:一份「整车」文件记录可读的转向角、制动压力与四轮车速(每 20 毫秒更新,单位分别为度、Bar、KPH);一份「DriveKit」文件记录可写的转向角、转向扭矩、油门踏板与制动踏板命令(同样 20 毫秒)。三条硬边界:其一,这不是厂家整网定义,而是研究与自动驾驶平台用的消息集合;其二,文档把底盘控制(雨刮、转向灯、喇叭、大灯、读 VIN)标为 Niro 专用,每条 DriveKit 消息是否适用于 Soul EV「未建立」;其三,所有声明的量程都是 [0|0],不能当作真实范围。
本文整理自该项目的 DBC 说明与其来源说明。来源说明本身就把适用范围、许可与验证状态标得很保守,本文原样保留这些限定。
车辆与适用范围
仓库说明该项目是一个起亚 Soul EV 的 CAN 记录与解码脚本,用于某实验室的自动驾驶平台采集;DBC 覆盖范围被描述为「有限」。来源说明进一步指出:这是记录集合而非出厂整网,本归档也未针对具体年款、配置或固件做过独立核对。
| 项 | 内容 |
|---|---|
| 车型 | 起亚 Soul EV(PS) |
| 年款 / 市场版本 | 源文档未确认(未绑定具体年款、配置或固件) |
| ECU / 改装状态 | 面向自动驾驶平台的数据采集;DriveKit 为可写命令集 |
| 采集跨度 | 源文档未给出;说明称用于 AV 平台数据采集,本归档未核对原始采集 |
| 适用范围 | 仅该 DBC 快照;DriveKit 消息对 Soul EV 的适用性未建立 |
总线与寻址
来源说明没有给出该车的总线速率或 11 位 / 29 位寻址结论,也没有 CAN FD 的说明。文档给出的是消息与信号的名称、方向(读 / 写)与周期,属于应用层与数据层;物理层与链路层细节属源文档未覆盖项,本文不补。
| 项 | 内容 |
|---|---|
| 物理层 | 源文档未给出 |
| 链路层 | 源文档未给出 |
| 寻址 | 源文档未给出 11 位 / 29 位结论 |
| CAN FD | 源文档未提及 |
| 消息周期 | 文档列出的信号多为 20 毫秒周期 |
已解码信号
下表分「整车文件(只读)」与「DriveKit 文件(可写)」两组。所有声明的物理量程均为 [0|0],因此「单位」是文档给出的量纲,不是经验证的范围。表格中凡「Niro only」者不得套到 Soul EV。
| 信号 / 命令 | 来源与方向 | 解码 / 取值 | 证据 |
|---|---|---|---|
| Steering Angle(整车) | Vehicle DBC,只读 | 度,20 毫秒 | 源文档规格表 |
| Brake Pressure(整车) | Vehicle DBC,只读 | Bar,20 毫秒 | 源文档规格表 |
| Individual Wheel Speed(整车) | Vehicle DBC,只读 | KPH,20 毫秒(四个轮速) | 源文档规格表 |
| steering_angle_cmd_flags | DriveKit STEERING_ANGLE_COMMAND,写 | Disable / Enable | 源文档命令表 |
| steering_angle_cmd_angle | 同命令消息 | 度 | 源文档命令表 |
| steering_angle_cmd_max_velocity | 同命令消息 | 度(文档示例用 300) | 源文档命令表与示例 |
| steering_angle_report_flags | DriveKit STEERING_ANGLE_REPORT,读 | Enable / Disable,每 20 毫秒发布 | 源文档报告表 |
| steering_angle_report_errors | 同报告消息 | Angle Missing / Angle Irrational / Module Disabled / Command Rejected | 源文档报告表 |
| steering_enable_magic | DriveKit STEERING_ENABLE | 默认 magic number(用于先使能扭矩控制器) | 源文档示例 |
| Steering Torque | DriveKit,写 | 度,20 毫秒 | 源文档规格表 |
| Throttle Pedal Position | DriveKit,写 | 百分比,20 毫秒 | 源文档规格表 |
| Brake Pedal Position | DriveKit,写 | 百分比,20 毫秒 | 源文档规格表 |
| CHASSIS_CONTROL_COMMAND(Niro only) | DriveKit,写 | 前雨刮(off / intermittent / slow / fast)、后雨刮(off / on)、左右转向灯、喇叭、读 VIN、大灯(off / low / high) | 源文档命令表,标注 Niro 专用 |
读取方法与注意事项
转向角命令三步走。文档给出的顺序是:先发 STEERING_ENABLE(带默认 magic number)使能转向扭矩控制器;再发 STEERING_ANGLE_COMMAND,其中 flags 置 Enable、angle 设目标角、max_velocity 设最大角速度(示例用 300 度/秒);最后应能在总线上看到 STEERING_ANGLE_REPORT 回报 flags 为 Enable、errors 为 None。
命令互斥与越界拒绝。文档明确:转向角命令与转向扭矩命令不能同时使用,二者互斥。示例还演示越界:请求超过车辆能力的角度(9999 度)时回报变为 flags 为 Disable、errors 为 Command Rejected,控制器自我禁用。
底盘控制是 Niro 专用。CHASSIS_CONTROL_COMMAND 可在一条消息里同时设置一个或多个底盘部件(雨刮、转向灯、喇叭、大灯,以及请求 VIN),但文档把这组功能标为 Niro only。是否适用于 Soul EV,来源说明写明「未建立」,因此不能照搬。
写命令有实车风险。DriveKit 文件里转向、油门、制动等都是写入类命令,一旦发送就会作用在真实车辆上。本文只转述文档记录,不构成操作指引。
证据等级与边界
第一层是覆盖范围:来源说明写明整车文件只有 3 条消息、6 个信号,DriveKit 文件有 15 条消息、32 个信号,这是一套研究用的消息集合,不是厂家整网定义。
第二层是数据质量:每个声明的物理范围都是 [0|0],来源说明把它列为需要独立复核的信号准确性问题;DriveKit 说明文件还提到 Niro 专用的底盘控制,因此「每条 DriveKit 消息都适用于 Soul EV」并未成立。
第三层是来源状态:项目自报做了 AV 平台采集,但本归档未将该副本与其采集数据、具体年款 / 配置 / 固件做独立核对;快照中也未发现仓库级许可证,仅作私有离线研究副本保留。据此,本文的信号与方向只能视为「这份 DBC 所声明的范围」,不能外推到其他 Soul EV 或其他起亚车型。
常见问题
这份 DBC 是起亚 Soul EV 的整车出厂网络吗?
不是。来源说明写明整车文件只有 3 条消息、6 个信号,DriveKit 文件有 15 条消息、32 个信号,是一套研究 / AV 平台用的消息集合,而非厂家整网定义。
为什么每个信号的物理范围都写成 [0|0]?
因为源 DBC 就是这么声明的,来源说明也把它列为「信号准确性需要独立复核」的问题。所以 [0|0] 不能当作真实量程,表格里的「度 / Bar / KPH / 百分比」只是文档给出的量纲。
转向角命令和转向扭矩命令能一起发吗?
不能。文档明确二者互斥,不能同时使用。示例演示的顺序是先发使能消息,再发转向角命令,并通过报告消息确认 flags 为 Enable、errors 为 None。
Niro 的底盘控制能不能套到 Soul EV?
未确认。文档把这组底盘控制(雨刮、转向灯、喇叭、大灯、读 VIN)明确标注为 Niro only;来源说明也指出「每条 DriveKit 消息是否适用于 Soul EV 尚未建立」。因此不能照搬到 Soul EV。
转向角报告里会出现哪些错误?
文档列出的四种是:Angle Missing(角度缺失)、Angle Irrational(角度不合理)、Module Disabled(模块禁用)、Command Rejected(命令被拒)。越界请求(如示例中的 9999 度)会得到 Command Rejected,随后控制器自我禁用。
延伸阅读
- 横向目标与执行:从目标角度到实际转角要越过哪些门 —— 与本文转向角命令 / 回报的作用链直接相关。
- 从使能到车轮:执行链上的八道门 —— 帮助理解「使能、命令、回报、越界拒绝」各不保证什么。
- UDS 诊断工具为什么不能随手调 —— 写入类命令作用在真车上,本车同此提醒。
- 车辆协议与 DBC 指纹:怎么判断一台车是不是同一套定义 —— 解释为何同平台文件也要逐车核对。
参考资料
- 项目 01 ——
public-can-dbc-datasets/additional/aroongta-kia-soul-ev/DBC/DBC-README.md(本项目车型档案主来源,取用了整车 / DriveKit 的信号与周期表)。 - 项目 01 ——
public-can-dbc-datasets/additional/aroongta-kia-soul-ev/SOURCE.md(取用了覆盖范围、[0|0]量程与「未建立」等边界说明)。 - 项目 01 ——
public-can-dbc-datasets/additional/aroongta-kia-soul-ev/README.md(取用了 AV 平台采集的项目背景)。
说明:本文整理自第三方开源项目的公开文档,仅代表该文档所记录的单个车辆样本,不代表同型号全系车型。CAN 与诊断操作存在风险,任何实车操作前请自行复核并遵守当地法规。
更新记录
首次发布 2026-10-11 最近核对:2026-10-11
发表回复