02 · 信号梳理
Lock 信号分两层:①MiCarPropertyIds 的 LockCtrl/DoorCtrl/WindowCtrl 封装 ②大量 Controller 绕过封装直引 mi.car.config.*(特别是 Body.POWER_LIFTING_ROOF、Door.POWER_OPERATED_DOOR)。
一、LockCtrl 域(13 个,逻辑聚合域)
⚠️ LockCtrl 是跨域聚合,13 个信号来自 Door/Hvac/Window/MirrorControl/Body/Light 6 个真实域:
| 信号 | 值来源 | 含义 | Controller |
|---|
WALK_AWAY_LOCK | Door.LEAVING_AUTO_LOCK | 离车自动锁车 | WalkAwayLock |
P_GEAR_AUTO_LOCK | Door.PARK_AUTO_UNLOCK | P 挡解锁(注释笔误 LOCK) | PGearAutoLock |
UNLOCK_AUTO_VENTILATION | Hvac.UNLOCK_VENT_STATE | 解锁通风 | UnlockAutoVentilation |
CLOSE_WINDOW_WHEN_LOCK | Window.LOCK_AUTO_CLOSE | 锁车关窗 | CloseWindowWhenLock |
MIRROR_FOLD_WHEN_LOCK | MirrorControl.AUTO_FOLD | 锁车折叠后视镜 | (VehicleBody 模块用) |
LOCK_BEEP | Door.LOCK_INDICATION | 锁车鸣笛 | LockBeep / CustomBeep |
CHILDREN_LOCK | Door.CHILD_LOCK_STATE | 左右童锁(area 区分) | VehicleLockToggle |
HANDLE_AUTO_RETURN | Door.DOOR_HANDLE_UNLOCK_MOVE_CONFIG_SET | 门把手自动内翻 | HandleAutoFold |
DOOR_CINCH_ENABLE_STATUS | 同名 | 车门自动吸合 | AutoDoorClose |
TAIL_WELCOME_MODE | Body.ARS_TAIL_WECOME_MODE | 尾翼迎宾 | WelcomeWithTailSwing |
WELCOME_CARPET | Light.WELCOME_CAR_PET_LIGHT_LAMP_SETTING_STATUS | 迎宾毯灯 | WelcomeCarpet |
WALK_CLOSE_UNLOCK / UNLOCK_BEEP | — | (定义未引用) | — |
二、DoorCtrl 域(17 个)
| 信号 | 值来源 | 含义 | Controller |
|---|
COVER_STATE | Door.STATE | 盖板状态(回弹 1000ms,脉冲式) | ElectricReleaseHeadGate |
CENTRAL_LOCK | Door.CENTER_LOCK | 中控锁 | (未引用) |
CHARGE_PORT | Door.CHARGE_PORT_STATE | 充电口(含 OPENING/CLOSING 中间态) | (未引用) |
Parking_DOOR_LOCK | Door.PARK_AUTO_UNLOCK | P 挡解锁(同 LockCtrl.P_GEAR) | (未引用) |
DRIVER_UNLOCK_SETTING | Door.ONLY_DRIVER_UNLOCK_SETTING | 解锁模式(整车/仅主驾) | VehicleUnlockModeTab |
ELECTRIC_TAIL_GATE_HEIGHT + _EXCEPTION | 同名 | 电尾门高度+不可用原因 | TailGateHeight |
ELECTRIC_HEAD_GATE_HEIGHT + _EXCEPTION | Door.FRUNK_MAX_OPEN_HEIGHT(+_FAIL_RSN) | 前备箱高度+不可用原因 | HeadGateHeight |
APPROACHING_UNLOCK | Door.APPROACHING_UNLOCK | 靠近自动解锁 | VehicleApproachUnLock |
FUEL_LID_STATUS + _UNAVL_REASON | 同名 | 加油口盖+不可用原因 | FuelLid |
POWER_OPERATED_TAILGATE_CONFIG / INTERIOR_DOOR_HANDLE_TYPE_CONFIG | — | 配置字(未直引,间接读) | — |
三、WindowCtrl 域(12 个)
| 信号 | 值来源 | 含义 | Controller |
|---|
REAR_LOCK_STATUS | Window.REAR_LOCK_STATUS | 后车窗锁(WINDOW_ROW_2_LEFT/RIGHT) | VehicleLockToggle |
DIM_ROOF_TRANSMIT_LEVEL | 同名 | 调光天幕透光度(TOP/BOTTOM/TOP_REAR/BOTTOM_REAR 四区) | SmartSunRoof/RearSunRoof |
DIM_ROOF_SET_UNAVL_REASON | 同名 | 调光天幕不可用原因 | SmartSunRoof |
DIM_ROOF_TRANSMIT_SYNC | Body.MULTIPLE_ZONE_SYNCHRONIZATION_SET | 双分区天幕同步 | SmartSunRoofSync |
DIM_ROOF_TRANSMIT_AUTO_STATE | 同名 | 自动态(触发刷新) | SmartSunroof |
SUN_SHADE_DISABLE_REASON | 同名 | 遮阳帘不可用(slider) | RoofSunShadePosition/Auto |
LOCK_CAR_CLOSE_SUN_SHADE_CONFIGURATION | 同名 | 锁车关遮阳帘(共用,area 区分前后) | RoofSunShadeAuto / RearSunShadeAutoClose |
SUN_SHADE_ADJ_HMI | 同名 | 遮阳帘长按点动(FORWARD/REARWARD/IDLE) | RoofSunShadePosition |
SUN_SHADE_CURRENT_POSN | ⚠️Window.SUNSHADE_TARGET_POSITION | 目标位置(命名陷阱) | RoofSunShadePosition |
SUN_SHADE_LRN_SET | 同名 | 自学习命令(SET/IDLE) | RearSunshadeCalibration |
WINDOW_LOCK(@Deprecated) / SUN_SHADE_LRN_WARN_TI | — | (未引用/废弃) | — |
四、底层直引 mi.car.config.*(绕过封装,穷尽补充)
Door 子域(电动门,未在 Ctrl 封装)
| 信号 | 含义 | Controller |
|---|
Door.POWER_OPERATED_DOOR_MOVING_STATUS | 电动门运动态(UNKNOWN/CLOSED/CLOSING/OPENING/STOP_NEXT_*/FULL_OPEN) | VehicleDoorToggle |
Door.POWER_OPERATED_DOOR_BUTTON_STATUS | 电动门按键命令(ON/OFF/STOP) | VehicleDoorToggle |
Door.POWER_OPERATED_DOOR_DISABLE_REASON | 电动门不可用(HIGH_SPEED/ANTI_PLAY/THERMAL) | VehicleDoorToggle |
Door.POWER_OPERATED_DOOR_MODE_STATUS | 电动门模式(MANUAL/ONLY_CINCH/AUTO) | DoorModeLock |
Door.MAXIMUM_POWER_OPERATED_DOOR_PARAMETER_SET | 车门开启角度(STANDARD/MAXIMUM) | DoorOpenAngle |
Door.FRUNK_DCD_STATE | 前备箱电释放态(7态:UNKNOW/CLS/FRK_LTCH_RELS/FRK_CLOSING/FRK_OPENING/…) | ElectricHeadGate |
Door.FRUNK_DCD_DISABLE_REASON | 前备箱不可用(GUST_MODE/POSN_UKWN/NOT_P/OVER_HEAT_PTCT…) | ElectricHeadGate |
Door.HOOD_REAR_ADJUST_EXCEPTION | 盖板调节异常(13 种:NOT_STATIC/CENTER_LOCK_LOCKED/NOT_LEARN…) | ElectricReleaseHeadGate / ElectricTailGate |
Door.ELECTRIC_TAIL_GATE | 电动尾门(7态:CLOSE/OPEN_ONLY_AREA/CLOSING/OPENING/CLOSE_STOP/OPEN_STOP/FULL_OPEN) | ElectricTailGate |
Door.UWB_TRUNK_SET | UWB 盖板设定(area HOOD/REAR) | HeadGateSwitch / TailGateSwitch |
Door.DOOR_NOT_CLOSED_LOCK_FAILED | 关门失败(CANCEL 取消) | DoorUnLockActivity |
Window 子域(遮阳帘校准/状态)
| 信号 | 含义 |
|---|
Window.SUN_SHADE_STS | 遮阳帘运动态(UKNW/FULL_OPEN/OPEN_STOP/CLOSE_STOP/OPENING/CLOSING/FULL_CLS) |
Window.SUNSHADE_TARGET_POSITION | 目标位置 0-100(即 SUN_SHADE_CURRENT_POSN) |
Window.SUN_SHADE_CURRENT_STOP_POSITION | 当前停止位置 |
Window.SUN_SHADE_LEARN_STATUS | 自学习态(LEARN/LEARNING) |
Window.SUN_SHADE_MANUAL_DISABLE_REASON | 手动按键不可用(IDLE/SYSTEM_FAULT/…) |
Body 子域:POWER_LIFTING_ROOF 升降车顶(18 信号,之前未列出)
| 信号 | 含义 |
|---|
POWER_LIFTING_ROOF_MODULE_CURRENT_STATUS | 当前状态(FULL_CLOSE/FULL_OPEN/PARTIALLY_OPEN..MANUAL_OPENING/AUTO_OPENING) |
POWER_LIFTING_ROOF_MODULE_PERCENT_POSITION | 百分比位置 0-100 |
POWER_LIFTING_ROOF_MODULE_AUTO_UP_NOT_AVAILABLE_REASON | 自动上升不可用(5 因) |
POWER_LIFTING_ROOF_MODULE_MANUAL_UP/DOWN_SWITCH_NOT_AVAILABLE_REASON | 手动上升/下降不可用 |
POWER_LIFTING_ROOF_ADJUST_LIFT_COMMAND | 手动上升命令(MANUAL_LIFT/IDLE) |
POWER_LIFTING_ROOF_ADJUST_FALL_COMMAND | 手动下降命令(MANUAL_FALL/IDLE) |
POWER_LIFTING_ROOF_CONTROL_LIFT_COMMAND / _CONTROL_STOP_COMMAND | 控制上升/停止 |
POWER_LIFTING_ROOF_LACK_SPACE_STOP_REMIND / _SECOND_REMIND | 空间不足停止/二次提醒 |
POWER_LIFTING_ROOF_OPEN_REMIND | 打开提醒 |
POWER_LIFTING_ROOF_MODULE_OPEN_USER_CONFIRM_RESULT / POWER_LIFT_ROOF_USER_SECOND_CONFIRM_RESULT | 二次确认结果 |
POWER_LIFT_ROOF_ADJUST_FLAG | 调节 flag(右栏管理) |
PEOPLE_OUTSIDE_REMIND/_STOP_REMIND | 车外有人提醒 |
SECOND_BED_HAVE_LIVING_REMIND/SECOND_BED_FOLD_OVER_REMIND | 二段床有人/翻折提醒 |
Driving/CommonParams
| 信号 | 用途 |
|---|
DrivingCtrl.GEAR | P 挡判断(车顶帐篷) |
DrivingCtrl.EASY_ENTRY | 便利进出(含电动侧踏,降悬架用) |
CommonParams.Lock.LOCK/UNLOCK | 童锁值 |
CommonParams.OnOff.ON/OFF | 通用开关值 |
五、引用频次排名
| 次 | 信号 | 说明 |
|---|
| 12 | WindowCtrl.DIM_ROOF_TRANSMIT_LEVEL | 调光天幕分区读写(最高) |
| 4 | WindowCtrl.SUN_SHADE_ADJ_HMI | 遮阳帘点动 4 次(Down/Up×左右) |
| 4 | WindowCtrl.REAR_LOCK_STATUS | 左右后窗锁 |
| 4 | LockCtrl.LOCK_BEEP | 锁车鸣笛 |
| 4 | LockCtrl.CHILDREN_LOCK | 左右后童锁 |
| 3 | DoorCtrl.FUEL_LID_STATUS | 加油口 |
| 2 | SUN_SHADE_CURRENT_POSN/LOCK_CAR_CLOSE_SUN_SHADE/DIM_ROOF_TRANSMIT_AUTO_STATE/DIM_ROOF_SET_UNAVL_REASON/DOOR_CINCH_ENABLE_STATUS/GEAR/EASY_ENTRY | 各 2 |
六、中间态信号处理(9 类)
| 子域 | 中间态 | 处理 |
|---|
| 充电口 | FLAG_MOVING|OPENING/CLOSING | 位运算合成(框架级) |
| 电动门 | OPENING/CLOSING | pause(tab) 显示”暂停”,终态再切 |
| 电动尾门 | CLOSING/OPENING | 中间态发 STOP_REQ(暂停) |
| 前备箱电释放 | FRK_CLOSING/FRK_OPENING | 中间态发 STOP_REQ |
| 加油口 | DECPRSING(减压中) | UI 先行转圈,终态走开/关 |
| 遮阳帘 | OPENING/CLOSING | 驱动进度条动画,文案切换 |
| 遮阳帘自学习 | LEARNING | 显示校准进度,LEARN 完成 |
| 调光天幕 | (无显式运动态) | 500ms 延时校验屏蔽中间态 |
| 升降车顶 | AUTO_OPENING | 阻止某些操作,区间按百分比显示 |
七、不可用原因(lazy 拉取,13 个 reason 类)
设计模式:点击 disabled 控件时才 getIntProperty(原因信号),再 when 映射 Toast/Dialog。
| 信号 | 枚举值(节选) | Controller |
|---|
DIM_ROOF_SET_UNAVL_REASON | SYSFAULT/OVER_HEAT/HI_TEMPERATURE/LOW_TEMPERATURE | SmartSunRoof |
SUN_SHADE_DISABLE_REASON | SYS_FLT/NOT_LERND/ANTY_PLAY/POWER_LOW/HIGH/THERMAL_HIGH/ANTI_TRAP_SYSTEM_REVERSE | RoofSunShadePosition |
SUN_SHADE_MANUAL_DISABLE_REASON | IDLE/SYSTEM_FAULT/…(同上) | 校准按钮可用=IDLE |
FUEL_LID_UNAVL_REASON | CRASH_EVNT/PWR_FLT/VCU_GEAR_FLT/CAR_MOD_FLT/WASH_MOD/MOT_FLT/VOLT_LOW/HIGH | FuelLid |
ELECTRIC_TAIL_GATE_HEIGHT_EXCEPTION | VEH_IN_TRSNP/POT_NOT_LRN/VEH_MOV/POT_MOV/POT_SYS_FLT | TailGateHeight |
ELECTRIC_HEAD_GATE_HEIGHT_EXCEPTION | VEH_IN_GST_MOD/FRUNK_NOT_LRN/FRUNK_MOV/VEH_NOT_P/FRUNK_SYS_FLT | HeadGateHeight |
FRUNK_DCD_DISABLE_REASON | GUST_MODE/POSN_UKWN/NOT_P/OVER_HEAT_PTCT/CEN_LOCK_LOCKD/SHOWROOM | ElectricHeadGate |
HOOD_REAR_ADJUST_EXCEPTION | NOT_STATIC/CENTER_LOCK_LOCKED/NOT_LEARN/SPOILER_MOVING/POSITION_UNKNOWN/ANTY_PLAY_PROTD/HIGH_SPEED/NOT_P_GEAR/VOLT_LOW/HIGH/COMMINUCATE_ERR/SYSTEM_FAULT/GUEST_MODE | ElectricReleaseHeadGate/ElectricTailGate |
POWER_OPERATED_DOOR_DISABLE_REASON | HIGH_SPEED/ANTI_PLAY/THERMAL | VehicleDoorToggle |
POWER_OPERATED_DOOR_NOT_AVAILABLE_REASON | CAR_MODE_INHIBIT | DoorModeLock |
POWER_LIFTING_ROOF_MODULE_AUTO_UP_NOT_AVAILABLE_REASON | NO_PARKING_PARK_GEAR/FULL_OPEN/NOT_COMPLETE_STUDY/CAR_MODE_ERROR/SPACE_INSUFFICIENT | RoofPreference |
POWER_LIFTING_ROOF_MODULE_MANUAL_UP/DOWN_SWITCH_NOT_AVAILABLE_REASON | NO_PARKING_PARK_GEAR/FULL_OPEN/CAR_MODE_ERROR 等 | RoofPreference |
八、关键枚举值(26 个,节选)
| 枚举 | 值 |
|---|
DoorState | OPEN/CLOSE/STOP_REQ |
PowerOperatedDoorMovingStatus | UNKNOWN/CLOSED/STOP_NEXT_OPEN/CLOSING/OPENING/STOP_NEXT_CLOSE/FULL_OPEN |
PowerOperatedDoorModeStatus | MANUAL/ONLY_CINCH_MODE/AUTO |
FrunkDcdState | UNKNOW/CLS/FRK_LTCH_RELS/FRK_CLOSING/FRK_OPENING/FRK_CLOSE_STOP/FRK_OPEN_STOP/FULLOPEN |
ElectricTailGate | CLOSE/OPEN_ONLY_AREA/CLOSING/OPENING/CLOSE_STOP/OPEN_STOP/FULL_OPEN |
FuelLidStatus | LOCKD/UNLCKD/DECPRSING |
DimRoofTransmitLevel | LEVEL1(遮光)/LEVEL5(透明) |
SunShadeSts | UKNW/FULL_OPEN/OPEN_STOP/CLOSE_STOP/OPENING/CLOSING/FULL_CLS |
SunShadeAdjHMI | IDLE/FORWARD/REARWARD |
SunShadeLearnStatus | LEARN/LEARNING |
LockIndicationMode | LIGHT/LIGHT_AND_HORN/LIGHTS_AND_TUNE |
PowerLiftingRoofModuleCurrentStatus | FULL_CLOSE/FULL_OPEN/PARTIALLY_OPEN..MANUAL_OPENING/AUTO_OPENING |
九、同信号多 area 分区(重要特征)
| 信号 | area 分区 |
|---|
CHILDREN_LOCK | DOOR_ROW_2_LEFT/RIGHT(左/右后童锁) |
REAR_LOCK_STATUS | WINDOW_ROW_2_LEFT/RIGHT(左/右后车窗锁) |
POWER_OPERATED_DOOR_MOVING_STATUS | DOOR_ROW_1_LEFT/RIGHT + DOOR_ROW_2_LEFT/RIGHT(4 门) |
DIM_ROOF_TRANSMIT_LEVEL | MiVehicleAreaBody.TOP/BOTTOM/TOP_REAR/BOTTOM_REAR(前/后双分区) |
UWB_TRUNK_SET | DOOR_HOOD/DOOR_REAR(前备箱/后备箱) |
LOCK_CAR_CLOSE_SUN_SHADE_CONFIGURATION | 前天窗遮阳帘/后排遮阳帘 |