4、术语与缩写表:ABS相关术语与缩写规范
好,咱们进入第四章。这一章看着像是个“字典”,但我跟你说,这恰恰是整份文档最容易翻车的地方。
我见过太多项目,因为一个术语没对齐,最后联调时吵得不可开交。你想想看,软件工程师说的“轮速”和硬件工程师理解的“轮速”,有时候根本就不是一个东西。所以,术语表不是摆设,它是团队的“共同语言”。
4.1 ABS核心术语详解
咱们先捋一遍ABS系统里最常碰到的几个术语。我按我的习惯,把它们分成三类:硬件实体、信号量、控制逻辑。
4.1.1 硬件实体类
| 术语 | 英文全称 | 中文解释 | 我的备注 |
|---|---|---|---|
| ECU | Electronic Control Unit | 电子控制单元,ABS的大脑 | 说白了就是一块单片机板子,负责算力和决策 |
| 轮速传感器 | Wheel Speed Sensor | 检测车轮转速的传感器 | 有磁电式和霍尔式两种,我建议在文档里明确区分 |
| 电磁阀 | Solenoid Valve | 控制制动液压力的执行器 | 增压阀、减压阀、保压阀,别搞混了 |
| HCU | Hydraulic Control Unit | 液压控制单元 | 电磁阀和泵都装在里面,是个“黑盒子” |
注意: 我在项目中遇到过,有人把“轮速传感器”简写成“WSS”,但另一个人写成了“WSP”。就这一个字母之差,导致代码里的宏定义对不上,查了半天。所以,缩写必须统一,不能有歧义。
4.1.2 信号与状态类
- 轮速 (Wheel Speed):单位通常是 km/h 或 rpm。我习惯在文档里同时标注物理单位和信号单位,因为ADC采出来的原始值跟实际车速差一个比例系数。
- 参考车速 (Reference Vehicle Speed):ECU根据四个轮速估算出来的车身速度。嗯,这里要注意,它不是直接测出来的,是算出来的。
- 滑移率 (Slip Ratio):这个值决定了车轮是“滚”还是“滑”。公式是 (车速 - 轮速) / 车速。滑移率在15%~20%时,附着力最大。
- 制动压力 (Brake Pressure):制动液的压力,单位 bar。电磁阀就是靠调节这个压力来工作的。
4.1.3 控制逻辑类
- 增压 (Pressure Build):电磁阀打开,制动液进入轮缸,压力上升。
- 保压 (Pressure Hold):电磁阀关闭,压力保持不变。
- 减压 (Pressure Release):电磁阀打开回油路,压力下降。
- ABS激活 (ABS Active):系统检测到车轮有抱死趋势,开始介入控制。
小技巧: 写文档时,我建议把“增压/保压/减压”这三个状态画成一个状态机图。文字描述再详细,也不如一张图来得直观。你想想看,评审的时候,大家对着图讨论,效率高多了。
4.2 缩写规范
这部分是我个人的“血泪史”总结。缩写不规范,同事两行泪。
4.2.1 缩写基本原则
- 全大写:所有缩写必须使用大写字母。比如 ECU,不能写成 ecu 或 Ecu。
- 无空格:缩写内部不能有空格或下划线。比如 WSS,不能写成 W_S_S。
- 唯一性:同一个缩写不能代表两个不同的术语。比如,ABS 只能代表防抱死系统,不能同时代表“绝对位置传感器”。
- 可读性:缩写要能“望文生义”。比如,WSS 比 WS 好,因为 WS 可能被理解为“水位传感器”。
4.2.2 常见缩写示例
| 缩写 | 全称 | 使用场景 |
|---|---|---|
| ECU | Electronic Control Unit | 所有文档、代码、原理图 |
| WSS | Wheel Speed Sensor | 信号处理模块、诊断模块 |
| SV | Solenoid Valve | 执行器控制模块 |
| HCU | Hydraulic Control Unit | 系统架构描述 |
| VREF | Reference Vehicle Speed | 算法模块、状态机 |
| SLIP | Slip Ratio | 控制算法、标定参数 |
重点: 我建议在项目启动时,就由架构师或技术负责人发布一份《项目缩写词典》。所有团队成员必须遵守。我曾经吃过这个亏——项目做到一半,发现代码里同时出现了“ABS_Act”和“ABS_Active”,两个意思一样,但写法不同。最后不得不全局搜索替换,费时费力。
4.2.3 缩写命名规则(进阶)
如果你想让文档更专业,可以引入一些命名规则。比如:
- 前缀表示模块:比如
WSS_开头的都是轮速传感器相关的,SV_开头的都是电磁阀相关的。 - 后缀表示类型:比如
_RAW表示原始值,_FILT表示滤波后的值,_CALC表示计算值。
举个例子:
WSS_FL_RAW // 左前轮速传感器原始值
WSS_FL_FILT // 左前轮速传感器滤波值
VREF_CALC // 计算出的参考车速
SLIP_FL_CALC // 左前轮滑移率计算值
你看,这样命名,任何人一看就知道这个变量是干什么的、从哪里来的。这就是规范的力量。
4.3 避坑指南
我曾经... 在评审一份文档时,发现作者把“电磁阀”缩写成了“DV”。我问他是啥意思,他说是“Dump Valve”(泄压阀)。但团队里其他人习惯用“RV”(Relief Valve)。就这一个术语,大家争论了半小时。最后不得不统一成“SV”(Solenoid Valve),并注明“包含增压、保压、减压三种类型”。所以,缩写一定要在文档开头就定义清楚,并且全员达成一致。
另外,我建议在文档的附录里,放一个“术语索引表”。按字母顺序排列,每个术语后面标注首次出现的章节。这样,读者在阅读过程中遇到不懂的术语,可以快速定位到定义。
嗯,这一章就到这里。术语表看似枯燥,但它是文档的“地基”。地基不稳,上面盖的楼再漂亮也没用。下一章,咱们聊聊具体的软件架构分层。