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 缩写基本原则

  1. 全大写:所有缩写必须使用大写字母。比如 ECU,不能写成 ecu 或 Ecu。
  2. 无空格:缩写内部不能有空格或下划线。比如 WSS,不能写成 W_S_S。
  3. 唯一性:同一个缩写不能代表两个不同的术语。比如,ABS 只能代表防抱死系统,不能同时代表“绝对位置传感器”。
  4. 可读性:缩写要能“望文生义”。比如,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),并注明“包含增压、保压、减压三种类型”。所以,缩写一定要在文档开头就定义清楚,并且全员达成一致。

另外,我建议在文档的附录里,放一个“术语索引表”。按字母顺序排列,每个术语后面标注首次出现的章节。这样,读者在阅读过程中遇到不懂的术语,可以快速定位到定义。

嗯,这一章就到这里。术语表看似枯燥,但它是文档的“地基”。地基不稳,上面盖的楼再漂亮也没用。下一章,咱们聊聊具体的软件架构分层。