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 三重职责)

  1. 主模式 Tab 状态SteeringModePreferenceController 注册它读当前模式
  2. 5 场景模式共用写入:ECO_PLUS/WET_MODE/OFF_ROAD_MODE/ANT_MTNSICK_MODE 都写 STEERING_MODE(靠不同 value 区分),退出写 DRIVE_MODE_EXIT
  3. 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)
  • MODEAUTOMATIC(自动) / 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越野13ADAS/赛道/直线竞速/经济/极致性能/代客/弹射+/悬架故障/车速过高/涉水/湿滑
WET_MODE_INHIBIT_REASON湿滑11同上系列
SPORT_EXCEPTION主模式11代客/ADAS/极致性能/弹射+/经济/湿滑/赛道/越野/直线竞速/晕车/涉水
EXTREME_ECO_INHIBIT_REASON超级省电8ADAS/晕车/赛道/直线竞速/极致性能/弹射+/越野/湿滑
ENERGY_REGENERATION_BAN_REASON能量回收7ADAS/晕车/赛道/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_EXCEPTIONESC 脱困6ESC故障/赛道激活/试驾/ADAS/车速过高

判定逻辑isAvailable = modeAvailable && !isProcessing && isPropertyAvailable(inhibitReason) && getInt(inhibitReason)==NO_INHIBIT

五、BattleCtrl 赛道模式子域(1504-1556 行)

独立的赛道模式信号集(Battle 相关),与 DrivingCtrl 的 BATTLE_MODE 信号互补。包含赛道模式专属参数。

六、关键枚举速查(35+ 枚举类,节选)

枚举
DriveModeECO/COMFORT/STANDARD/SPORT/SPORT_PLUS/CUSTOM_1-3/WET_MODE/BATTLE/ECO_PLUS/OFF_ROAD_MODE/ANT_MTNSICK_MODE
DragRacingModeSwitchACTIVE/NOT_ACTIVE
BattleModeFrontRearTractionTorqueModeAUTOMATIC/MANUAL/MANUAL_2
AutoManualAUTOMATIC/MANUAL
OffRoadSubModeStatusOFF/AUTO/SNOW/MUD/SAND/WADE
RegenerationLevelStatusSOFT/MODERATE/STANDARD/ADVANCED
EscOnOffOFF/ON/LEVEL_2
TowModeStatusToDcdCLOSED/CLOSING/OPEN/OPENING
TowBarTypeConfigNONE_TOW_BAR/FULL_ELECTRIC_TOW_BAR
WadingModeStatusOFF/IN_PROGRESS/ON_WADING/ON_WADING_FLOADING
SteeringAssistanceParametersStatusLIGHT/STANDARD/HEAVY
LaunchPerfModeNOT_ACTIVE
SubTypeOfSpecialModeDEFAULT_1_ECO/DEFAULT_2_NEW_DRIVER

七、引用频次排行(grep 实测)

信号
90STEERING_MODE(驾驶模式总开关,三重职责)
32STEERING_MODE_STATUS
15TYPE_OF_SPECIAL_MODE_ / ENERGY_REGENERATION_BAN_REASON
14WET_MODE_INHIBIT_REASON
13SUSPENSION_HEIGHT_MEDIUM / DRAG_RACING_MODE_SWITCH
9SUSPENSION_HEIGHT / OFF_ROAD_MODE_INHIBIT_RSN / MOTION_SICKNESS_MODE_INHIBIT_RSN / HDC_AVL
8DRIVE_MODE_EXIT / DRAG_RACE_MODE_LOADING_STATE / BATTLE_MODE_*_TORQUE_MODE_*(3 个) / ACCELERATION_STRENGTH_M