BMS Application Software Signal Naming Rules
1. 适用范围
本规则适用于基于 Simulink/Stateflow 软件进行的BMS（电池管理系统）应用层软件开发项目，以及后续相关的 BMS 软件开发项目。
The rules apply to the BMS application layer software development project based on Simulink/Stateflow software，and follow-up related projects.
2. 命名规则
基于 Simulink/Stateflow 软件进行的 BMS 应用层软件模型，其信号命名，需要符合以下格式：
The Signal name of the BMS application software models based on Simulink/Stateflow software, should be in the following format:
<变量类型><变量维度><模块名>_<信号单位>_<信号含义>
<variable type><variable dimension><module name>_<signal unit>_<signal meaning>
例如：VeSOC_pct_RealSoc，VaINPT_degC_EnvTemp；
For example: VeSOC_pct_RealSoc ，VaINPT_degC_EnvTemp；
整个信号名称，由 AZ、az、0~9 以及 _ (下划线)字符组成，不能用数字、下划线开头，不用下划线结尾，名称中不能有空白，不用 Enter 键键入。
The signal name should be consist of A～Z、a～z、0～9 and underscore , cannot start with a digit or an underscore, cannot end with an underscore, have no blank and carriage returns.
其中，变量类型必须用大写字母表示，具体类型如表 1 所示：
In which, the variable type must be represented in capital letters, and the special type is shown as table 1:
表 1 变量类型列表
Table 1 list of variable type
| 变量类型 Variable Type | 含义 Meaning |
|---|---|
| V | variable 输入输出量 |
| N | non-volatile memory 存储量 |
| L | temporary or local 临时或本地变量 |
| C | calibration 标定量 |
变量维度必须用小写字母表示，常用的模块名缩写如表 2 所示：
Variable dimension must be represented in lowercase letters, and commonly used module names are abbreviated as table 2:
表 2 变量维度列表
Table 2 list of variable dimension
| 变量维度 Variable Dimension | 含义 Meaning |
|---|---|
| e | easier variable 易变量 |
| a | array 数组 |
| t | table 二维表格 |
| x | table-x 二维表格的x方向输入 |
| y | table-y 二维表格的y方向输入 |
模块名必须用大写字母表示，常用的模块名缩写如表 3 所示：
Module name must be represented in capital letters, and commonly used module names are abbreviated as table 3:
表 3 模块名列表
Table 3 list of module names
| 模块名 Module Name | 缩写 abbr | 中文含义 Chinese Meaning |
|---|---|---|
| Data Processing | DTP | 数据处理 |
| Fault Management | FLT | 故障管理 |
| System Wake-up | SWK | 系统唤醒 |
| Battery Status Management | BSM | 电池状态管理 |
| Power Control | PWC | 功率控制 |
| Charge Management | CHM | 充电管理 |
| Discharge Management | DSM | 放电管理 |
| State of Charge | SOC | 电荷状态 |
| State of Power | SOP | 功率状态 |
| State of Health | SOH | 健康状态 |
| State of Energy | SOE | 能量状态 |
| Battery Maintenance | BMT | 电池维护 |
| Thermal Management | THM | 热管理 |
| Cell Balance Control | CBC | 均衡控制 |
| Cell Failure Diagnosis | CFD | 电芯失效诊断 |
| Communication Transmit | CMT | 通信发送 |
| Communication Receive | CMR | 通信接收 |
| NVM Management | NVM | 非易失性存储管理 |
| RTC Management | RTC | 实时时钟管理 |
信号单位根据信号单位英文名称，将各个单词进行缩写，整个名称缩写必须保证信号名简洁清晰，且不重复。常用的信号单位如表 4 所示：
The unit of the signal is to abbreviate each word according to their English unit. The entire abbreviation must ensure that the signal name is concise and clear, and not repeated. Some commonly used signal unit are abbreviated as table 4.
表 4 信号单位列表
Table 4 list of signal unit
| 物理意义 Physical significance | 国际单位 International Unit | 信号单位 Signal Unit |
|---|---|---|
| 时间 Time | s | ms/s/min/h |
| 电压 Voltage | V | mV/V/kV |
| 电流 Current | A | mA/A/kA |
| 温度 Temperature | K | degC |
| 电阻 Resistance | Ohm | mohm/ohm/kohm |
| 功率 Power | W | mW/W/kW |
| 能量 Energy | J | mWh/Wh |
| 容量 Capacity | / | mAh/Ah |
| 百分比 Percentage | / | pct |
| 标志位 Flag | / | flg |
| 布尔标志 boolean | / | b |
| 位状态 bit | / | bit |
| 索引 index | / | idx |
| 计数 count | / | cnt |
| 倍率 ratio | / | r |
信号含义，根据信号英文名称，将各个单词进行缩写，每个单词的首字母必须大写，其它字母小写，整体采用大驼峰命名法，整个名称缩写必须保证信号名简洁清晰，且不重复。部分常用的信号名称缩写如表 5 所示：
The meaning of the signal is to abbreviate each word according to their English name. The first letter of each word must be capitalized, and the other letters must be lowercase. The overall naming adopts a large camel hump form. The entire abbreviation must ensure that the signal name is concise and clear, and not repeated. Some commonly used signal names are abbreviated as table 5.
表 5 信号名称常用缩写列表
Table 5 list of abbreviation of commonly used signal name
| 英文名称 English Name | 缩写 abbr | 英文名称 English Name | 缩写 abbr |
|---|---|---|---|
| Maximum | Max | Difference | Diff |
| Minimum | Min | Input | Inp |
| Average | Avg | Output | Out |
| Cell | Cell | High Voltage | HV |
| Module | Mod | Low Voltage | LV |
| Battery | Batt | Control | Ctrl |
| Relay | Rly | Fast | Fast |
| Voltage | Volt | Slow | Slow |
| Current | Cur | Wireless | Wrls |
| Power | Pwr | Summary | Sum |
| Temperature | Temp | Wake up | Wkp |
| Branch | Brh | Active | Acv |
| Total | Tot | Command | Cmd |
| Positive | Pos | Estimated | Est |
| Negative | Neg | Initial | Init |
| Precharge | Pch | Calculate | Calc |
| Charge | Chg | Sensor | Snsr |
| Discharge | Dsg | Synchronous | Sync |
| Capacity | Cap | Request | Req |
| PowerOn | PwrOn | Read | Rd |
| PowerOff | PwrOff | Write | Wr |
| State | State | Reset | Rst |
| Level | Lvl | Error | Err |
| Number | Num | Fault | Flt |
| Remain | Rem | Filter | Fil |
| History | His | Table | Tbl |
3. 修改记录
该版命名规则（版本号为 V1.0），是在现有项目 BMS 软件模型的命名基础上，经过大家评审并达成一致意见产生的。此版为首次释放，后面根据项目需求，将在版本上进行修改更新，并在表 6 中进行记录。
The Naming Rules (Version 1.0), based on the name of the existing BMS software models, are produced by the review and consensus. The version is the first release, which will be modified and updated according to the requirements of the related projects, and recorded in table 6.
表 6 修改记录表
Table 6 list of change log
| 版本号 Version No. | 修改内容 Modify content | 日期 Date | 修改者 Modifier |
|---|---|---|---|
| V1.0 | First release | 2024.07.20 | tyb |