02 · 信号梳理
DrivingCtrl域(MiCarPropertyIds.java第 907-1499 行)共 363 个常量(约 140 propId + 220 枚举值),是项目最大信号域。另有BattleCtrl(1504-1556 行)赛道模式子域。值来源:mi.car.config.{Driving,Body,Energy,Warning,Peripheral,CommonParams}(外部 SDK 桩)。
一、25 个子域分组(代表信号)
① 车辆基础/配置/状态
VEHICLE_TYPE / MARKET_CONFIG / PROPULSION_TYPE_CONFIG(动力类型) / POWER_MODE(ACC) / GEAR(P 挡判定,30 次) / CAR_MODE / PEDAL_BRAKE_APPLIED
② 主驾驶模式(核心,STEERING_MODE 90 次所在)
| 信号 | 含义 |
|---|---|
STEERING_MODE = Driving.DRIVE_MODE | 驾驶模式总开关(⚠️命名陷阱) |
STEERING_MODE_STATUS = DRIVE_MODE_STATUS | 模式状态(IN_PROCESS/FINISHED) |
DRIVE_MODE_EXIT | 退出模式 |
DRIVING_MODE_AVAILABLE_FLAG | 舒适/运动/M1/M2/湿滑/运动+ 可用 bit |
SPORT_EXCEPTION | 主模式不可用原因(11 种) |
PREFERENCE_LAST_MODE_EXCEPT_PRO_MODE | 进场景模式前的主模式 |
DriveMode 枚举:ECO/COMFORT/STANDARD/SPORT/SPORT_PLUS/CUSTOM_1/CUSTOM_2/CUSTOM_3/WET_MODE/BATTLE/ECO_PLUS/OFF_ROAD_MODE/ANT_MTNSICK_MODE/MOUNTAIN
③ 能源模式(增程车)
ENERGY_MODE/ENERGY_MODE_STATUS/ELECTRIC_FORCED_STATUS(强制纯电)/CHARGING_FORCED_STATUS(强制发电)
④ 直线竞速/弹射/尾气/救援
DRAG_RACING_MODE_SWITCH/DRAG_RACE_MODE_SETTING_TIMER(倒计时)/DRAG_RACING_MODE_UNAVL_REASON(20 种,最多)/DRAG_RACE_MODE_LOADING_STATE(LOADING/FINISHED)/LAUNCH_PERF_MODE/LAUNCH_MODE_CONFIG(CCP199)/FUEL_MODE_STATUS(双怠速尾气)/TRAILER_MODE_*(救援)
⑤ 越野/涉水/湿滑/蟹行
TERRAIN_MODE/TERRAIN_MODE_STATUS(共用 OFF_ROAD_SUB_MODE_STATUS)/TERRAIN_MODE_AVAILABLE/WET_MODE_INHIBIT_REASON/WADING_MODE_REASON_IN_*(10 bit)/CRAB_ROW_REASON_*(6 种)
越野 5/6 地形:OFF/AUTO/SNOW/MUD/SAND/WADE
⑥ 能量回收
BRAKING_MODE=Energy.REGENERATION_MODE(⚠️命名陷阱)/ENERGY_REGENERATION_LEVEL/ENERGY_REGENERATION_BAN_REASON/REGENERATION_LEVEL_MODE1/M2_STATUS/SPECIAL_MODE_*_ENERGY_REGENERATION_STRENGTH/MODE(7 套)
⑦ 悬架高度(5 档 + 反馈)
SUSPENSION_HEIGHT + SUSPENSION_HEIGHT_LOW/MEDIUM_LOW/MEDIUM/MEDIUM_HIGH/HIGH(5 档) + SUSPENSION_HEIGHT_UNAVAILABLE(bit) + *_EXCEPTION(5 个) + SUSPENSION_HEIGHT_FOR_CUSTOM_DRIVE_MODE_M1/M2 + AUTO_LEVELING_ADJUSTMENT_SWITCH_STATUS(智能高度,地理围栏)
⑧ 悬架阻尼
SUSPENSION_DAMP_M1/M2 + SUSPENSION_DAMP_FEEDBACK_*(各模式) + SUSPENSION_DAMP_COMFORT/NORMAL/SPORT/ECONOMIC
⑨ ARS 电动尾翼
ARS/ARS_POSITION/ARS_ADJUST_EXCEPTION/ARS_TAIL_HEIGHT_M1/M2/各模式/ARS_SET_BUTTON(硬按键)/ARS_MAX/MIN_ACCELERATE_TIME
⑩ ARD 尾部扩散器
ARD_SWITCH_STATUS/ARD_SWITCH_UNAVAILABLE_REASON
⑪ EPB/卡钳
EPB/APB_BCS/BCP_RELEASE_EXCEPTION/APB_BCS/BCP_LOCK_EXCEPTION/KEY_FOR_RELEASE_EPB
⑫ MIA 空气动力
MIA_AUTO_MODE/MIA_WORK_STATE
⑬ ESC/换胎/千斤顶
ESC(OFF/ON/LEVEL_2)/PREFERENCE_ESC_EXCEPTION/JACK_MODE
⑭ 加速特性(11 套,每模式一个)
ACCELERATION_STRENGTH_M1/M2/COMFORT/ECONOMIC/STANDARD/SPORT/SPORT_PLUS/WET/ECO_PLUS/OFF_ROAD/MOTION_SICKNESS
⑮ 前后扭矩分配(四驱核心,20+ 常量)
详见第三节。
⑯ EPS 转向手感(13 套)
EPS_STRENGTH_M1/M2/各模式 + EPS_STRENGTH_KUNLUN(昆仑独立) + STEERING_ASSISTANCE_INDEPENDENT_CONTROL_SET(LeMans 独立) + 档位 LIGHT(1)/MEDIUM_LIGHT(2)/MEDIUM(3)/MEDIUM_STRONG(4)/STRONG(5)
⑰ VDC/TCS/eLSD 车辆动力学
M1/M2/各模式_VDC_PARAMETER(11 套,值 0-4)/M1/M2/各模式_TCS_PARAMETER(12 套,值 0-7)/M1/M2_ELSD_PARAMETER(NEUTER=1/STABLE=0)
⑱ 自定义模式辅助
PREFERENCE_SPECIAL_MODE1/2_RESET/TYPE_OF_SPECIAL_MODE_1/2(DEFAULT_1_ECO/DEFAULT_2_NEW_DRIVER)
⑲ 便利进出/离车位置
EASY_IN_OUT_MODE/OUT_POSITION_AVAILABLE/SET_STATE/SET/RESULT/POPUP_KEEP/EASY_ENTRY
⑳ 洗车模式
WASH_MODE_STATUS/TRIGGER/ENTRY_PERMISSION/BAN_ENTER_REASON/EXIT_PERMISSION
㉑ 拖挂模式(最复杂)
TOW_BAR_TYPE_CONFIG(NONE/FULL_ELECTRIC)/TOW_MODE_STATUS_TO_DCD/TOW_MODE_DCD_DISABLE_REASON(5 bit)/TOW_BAR_DCD_DISABLE_REASON/TOW_BAR_LAST_COMMAND_FAIL_REASON/TOW_MODE_SET_OPEN/CLOSE/ELECTRIC_TOW_BAR_SET_OPEN/CLOSE/STATUS
㉒ 蠕行/模拟换挡
CREEP_SPEED_STATUS(STATIC/NORMAL)/ESHIFT_MODE_STATUS/ESHIFT_MODE_INHIBIT_REASON
㉓ 运动声浪 AUDIO_ESE
AUDIO_ESE_STATE(OFF/INTERNAL/OUTSIDE/BOTH)/AUDIO_ESE_MODE(3 风格)/AUDIO_M1/M2_ESE_STATE/MODE(走 AudioSettings 非 CarProperty)
㉔ HDC/手套箱/除锈/坡道
HDC_FUNCTION_SWITCH/HDC_CTRL_STS/HDC_AVL/GLOVE_BOX/RUST_REMOVE/RAMP_ASSIST
㉕ 制动踏板感/防侧倾/弹射狂暴/ETC/电动踏板
BRAKE_CURVE_SWITCH(COMFORT/SPORT)/ANTI_ROLL_M1/M2/EXTREME_PERF_MODE(狂暴)/ETC_*(8 个)/ELECTRIC_PEDAL_*(4 个)
二、STEERING_MODE 90 次引用的真相(一个 propId 三重职责)
- 主模式 Tab 状态:
SteeringModePreferenceController注册它读当前模式 - 5 场景模式共用写入:ECO_PLUS/WET_MODE/OFF_ROAD_MODE/ANT_MTNSICK_MODE 都写
STEERING_MODE(靠不同 value 区分),退出写DRIVE_MODE_EXIT - UI 选中态映射:
getRealModePropertyValue()把场景模式映射回主模式(COMFORT/ECO/STANDARD/SPORT/CUSTOM/SPORT_PLUS)
三、BATTLE_MODE 前后扭矩分配机制(四驱 SU7 Ultra)
按驾驶模式分维度:2 类型(RATIO 比例 + MODE 控制模式) × 9 模式(ECONOMIC/STANDARD/WET/ECO/OFF_ROAD/MOTION_SICKNESS/M1/M2/BATTLE) + 3 枚举 ≈ 21 常量。
- RATIO:实际前后扭矩数值(如 50:50)
- MODE:
AUTOMATIC(自动) /MANUAL(半手动) /MANUAL_2(全手动补偿) _M1/_M2:个性化 1/2 独立存储槽- UI:
TractionRatioModeParamPreferenceController(自动/手动 Tab) +TractionRatioParamPreferenceController(比例 Slider,前|后) +TractionRatioManualCompensationParamPreferenceController(补偿 Switch)
四、不可用原因矩阵(模式互斥 + 系统状态)
每种模式都有 INHIBIT_REASON/BAN_REASON/UNAVL_REASON,构成模式互斥矩阵:
| 信号 | 模式 | 不可用原因数 | 代表原因 |
|---|---|---|---|
DRAG_RACING_MODE_UNAVL_REASON | 直线竞速 | 20(最多) | 系统错误/低电量/充电/ECO/BATTLE/OFFROAD/WET/代客/ADAS/极致性能/弹射+/账号无效/网络未授权/考试未通过/安全驾驶/未静止/地理围栏/晕车 |
OFF_ROAD_MODE_INHIBIT_RSN | 越野 | 13 | ADAS/赛道/直线竞速/经济/极致性能/代客/弹射+/悬架故障/车速过高/涉水/湿滑 |
WET_MODE_INHIBIT_REASON | 湿滑 | 11 | 同上系列 |
SPORT_EXCEPTION | 主模式 | 11 | 代客/ADAS/极致性能/弹射+/经济/湿滑/赛道/越野/直线竞速/晕车/涉水 |
EXTREME_ECO_INHIBIT_REASON | 超级省电 | 8 | ADAS/晕车/赛道/直线竞速/极致性能/弹射+/越野/湿滑 |
ENERGY_REGENERATION_BAN_REASON | 能量回收 | 7 | ADAS/晕车/赛道/HDC/遥控挪车/湿滑 |
MOTION_SICKNESS_MODE_INHIBIT_RSN | 防晕车 | 8 | 赛道/直线竞速/经济/极致性能/弹射+/越野/湿滑 |
TOW_MODE_DCD_DISABLE_REASON | 拖挂 | 5 bit | 未P档/智驾/稳定性/驾驶模式/电气 |
WADING_MODE_AVAILABLE | 涉水 | 10 bit | 非静止/电量不足/系统故障/车门开/智驾/HDC/湿滑/越野/代客/天窗开 |
CRAB_ROW_MODE_AVAILABL | 蟹行 | 6 | 静止&方向盘/系统故障/智驾/拖车/大师模式 |
PREFERENCE_ESC_EXCEPTION | ESC 脱困 | 6 | ESC故障/赛道激活/试驾/ADAS/车速过高 |
判定逻辑:isAvailable = modeAvailable && !isProcessing && isPropertyAvailable(inhibitReason) && getInt(inhibitReason)==NO_INHIBIT
五、BattleCtrl 赛道模式子域(1504-1556 行)
独立的赛道模式信号集(Battle 相关),与 DrivingCtrl 的 BATTLE_MODE 信号互补。包含赛道模式专属参数。
六、关键枚举速查(35+ 枚举类,节选)
| 枚举 | 值 |
|---|---|
DriveMode | ECO/COMFORT/STANDARD/SPORT/SPORT_PLUS/CUSTOM_1-3/WET_MODE/BATTLE/ECO_PLUS/OFF_ROAD_MODE/ANT_MTNSICK_MODE |
DragRacingModeSwitch | ACTIVE/NOT_ACTIVE |
BattleModeFrontRearTractionTorqueMode | AUTOMATIC/MANUAL/MANUAL_2 |
AutoManual | AUTOMATIC/MANUAL |
OffRoadSubModeStatus | OFF/AUTO/SNOW/MUD/SAND/WADE |
RegenerationLevelStatus | SOFT/MODERATE/STANDARD/ADVANCED |
EscOnOff | OFF/ON/LEVEL_2 |
TowModeStatusToDcd | CLOSED/CLOSING/OPEN/OPENING |
TowBarTypeConfig | NONE_TOW_BAR/FULL_ELECTRIC_TOW_BAR |
WadingModeStatus | OFF/IN_PROGRESS/ON_WADING/ON_WADING_FLOADING |
SteeringAssistanceParametersStatus | LIGHT/STANDARD/HEAVY |
LaunchPerfMode | NOT_ACTIVE |
SubTypeOfSpecialMode | DEFAULT_1_ECO/DEFAULT_2_NEW_DRIVER |
七、引用频次排行(grep 实测)
| 次 | 信号 |
|---|---|
| 90 | STEERING_MODE(驾驶模式总开关,三重职责) |
| 32 | STEERING_MODE_STATUS |
| 15 | TYPE_OF_SPECIAL_MODE_ / ENERGY_REGENERATION_BAN_REASON |
| 14 | WET_MODE_INHIBIT_REASON |
| 13 | SUSPENSION_HEIGHT_MEDIUM / DRAG_RACING_MODE_SWITCH |
| 9 | SUSPENSION_HEIGHT / OFF_ROAD_MODE_INHIBIT_RSN / MOTION_SICKNESS_MODE_INHIBIT_RSN / HDC_AVL |
| 8 | DRIVE_MODE_EXIT / DRAG_RACE_MODE_LOADING_STATE / BATTLE_MODE_*_TORQUE_MODE_*(3 个) / ACCELERATION_STRENGTH_M |