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_LOCKDoor.LEAVING_AUTO_LOCK离车自动锁车WalkAwayLock
P_GEAR_AUTO_LOCKDoor.PARK_AUTO_UNLOCKP 挡解锁(注释笔误 LOCK)PGearAutoLock
UNLOCK_AUTO_VENTILATIONHvac.UNLOCK_VENT_STATE解锁通风UnlockAutoVentilation
CLOSE_WINDOW_WHEN_LOCKWindow.LOCK_AUTO_CLOSE锁车关窗CloseWindowWhenLock
MIRROR_FOLD_WHEN_LOCKMirrorControl.AUTO_FOLD锁车折叠后视镜(VehicleBody 模块用)
LOCK_BEEPDoor.LOCK_INDICATION锁车鸣笛LockBeep / CustomBeep
CHILDREN_LOCKDoor.CHILD_LOCK_STATE左右童锁(area 区分)VehicleLockToggle
HANDLE_AUTO_RETURNDoor.DOOR_HANDLE_UNLOCK_MOVE_CONFIG_SET门把手自动内翻HandleAutoFold
DOOR_CINCH_ENABLE_STATUS同名车门自动吸合AutoDoorClose
TAIL_WELCOME_MODEBody.ARS_TAIL_WECOME_MODE尾翼迎宾WelcomeWithTailSwing
WELCOME_CARPETLight.WELCOME_CAR_PET_LIGHT_LAMP_SETTING_STATUS迎宾毯灯WelcomeCarpet
WALK_CLOSE_UNLOCK / UNLOCK_BEEP(定义未引用)

二、DoorCtrl 域(17 个)

信号值来源含义Controller
COVER_STATEDoor.STATE盖板状态(回弹 1000ms,脉冲式)ElectricReleaseHeadGate
CENTRAL_LOCKDoor.CENTER_LOCK中控锁(未引用)
CHARGE_PORTDoor.CHARGE_PORT_STATE充电口(含 OPENING/CLOSING 中间态)(未引用)
Parking_DOOR_LOCKDoor.PARK_AUTO_UNLOCKP 挡解锁(同 LockCtrl.P_GEAR)(未引用)
DRIVER_UNLOCK_SETTINGDoor.ONLY_DRIVER_UNLOCK_SETTING解锁模式(整车/仅主驾)VehicleUnlockModeTab
ELECTRIC_TAIL_GATE_HEIGHT + _EXCEPTION同名电尾门高度+不可用原因TailGateHeight
ELECTRIC_HEAD_GATE_HEIGHT + _EXCEPTIONDoor.FRUNK_MAX_OPEN_HEIGHT(+_FAIL_RSN)前备箱高度+不可用原因HeadGateHeight
APPROACHING_UNLOCKDoor.APPROACHING_UNLOCK靠近自动解锁VehicleApproachUnLock
FUEL_LID_STATUS + _UNAVL_REASON同名加油口盖+不可用原因FuelLid
POWER_OPERATED_TAILGATE_CONFIG / INTERIOR_DOOR_HANDLE_TYPE_CONFIG配置字(未直引,间接读)

三、WindowCtrl 域(12 个)

信号值来源含义Controller
REAR_LOCK_STATUSWindow.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_SYNCBody.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_SETUWB 盖板设定(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.GEARP 挡判断(车顶帐篷)
DrivingCtrl.EASY_ENTRY便利进出(含电动侧踏,降悬架用)
CommonParams.Lock.LOCK/UNLOCK童锁值
CommonParams.OnOff.ON/OFF通用开关值

五、引用频次排名

信号说明
12WindowCtrl.DIM_ROOF_TRANSMIT_LEVEL调光天幕分区读写(最高)
4WindowCtrl.SUN_SHADE_ADJ_HMI遮阳帘点动 4 次(Down/Up×左右)
4WindowCtrl.REAR_LOCK_STATUS左右后窗锁
4LockCtrl.LOCK_BEEP锁车鸣笛
4LockCtrl.CHILDREN_LOCK左右后童锁
3DoorCtrl.FUEL_LID_STATUS加油口
2SUN_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/CLOSINGpause(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_REASONSYSFAULT/OVER_HEAT/HI_TEMPERATURE/LOW_TEMPERATURESmartSunRoof
SUN_SHADE_DISABLE_REASONSYS_FLT/NOT_LERND/ANTY_PLAY/POWER_LOW/HIGH/THERMAL_HIGH/ANTI_TRAP_SYSTEM_REVERSERoofSunShadePosition
SUN_SHADE_MANUAL_DISABLE_REASONIDLE/SYSTEM_FAULT/…(同上)校准按钮可用=IDLE
FUEL_LID_UNAVL_REASONCRASH_EVNT/PWR_FLT/VCU_GEAR_FLT/CAR_MOD_FLT/WASH_MOD/MOT_FLT/VOLT_LOW/HIGHFuelLid
ELECTRIC_TAIL_GATE_HEIGHT_EXCEPTIONVEH_IN_TRSNP/POT_NOT_LRN/VEH_MOV/POT_MOV/POT_SYS_FLTTailGateHeight
ELECTRIC_HEAD_GATE_HEIGHT_EXCEPTIONVEH_IN_GST_MOD/FRUNK_NOT_LRN/FRUNK_MOV/VEH_NOT_P/FRUNK_SYS_FLTHeadGateHeight
FRUNK_DCD_DISABLE_REASONGUST_MODE/POSN_UKWN/NOT_P/OVER_HEAT_PTCT/CEN_LOCK_LOCKD/SHOWROOMElectricHeadGate
HOOD_REAR_ADJUST_EXCEPTIONNOT_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_MODEElectricReleaseHeadGate/ElectricTailGate
POWER_OPERATED_DOOR_DISABLE_REASONHIGH_SPEED/ANTI_PLAY/THERMALVehicleDoorToggle
POWER_OPERATED_DOOR_NOT_AVAILABLE_REASONCAR_MODE_INHIBITDoorModeLock
POWER_LIFTING_ROOF_MODULE_AUTO_UP_NOT_AVAILABLE_REASONNO_PARKING_PARK_GEAR/FULL_OPEN/NOT_COMPLETE_STUDY/CAR_MODE_ERROR/SPACE_INSUFFICIENTRoofPreference
POWER_LIFTING_ROOF_MODULE_MANUAL_UP/DOWN_SWITCH_NOT_AVAILABLE_REASONNO_PARKING_PARK_GEAR/FULL_OPEN/CAR_MODE_ERROR 等RoofPreference

八、关键枚举值(26 个,节选)

枚举
DoorStateOPEN/CLOSE/STOP_REQ
PowerOperatedDoorMovingStatusUNKNOWN/CLOSED/STOP_NEXT_OPEN/CLOSING/OPENING/STOP_NEXT_CLOSE/FULL_OPEN
PowerOperatedDoorModeStatusMANUAL/ONLY_CINCH_MODE/AUTO
FrunkDcdStateUNKNOW/CLS/FRK_LTCH_RELS/FRK_CLOSING/FRK_OPENING/FRK_CLOSE_STOP/FRK_OPEN_STOP/FULLOPEN
ElectricTailGateCLOSE/OPEN_ONLY_AREA/CLOSING/OPENING/CLOSE_STOP/OPEN_STOP/FULL_OPEN
FuelLidStatusLOCKD/UNLCKD/DECPRSING
DimRoofTransmitLevelLEVEL1(遮光)/LEVEL5(透明)
SunShadeStsUKNW/FULL_OPEN/OPEN_STOP/CLOSE_STOP/OPENING/CLOSING/FULL_CLS
SunShadeAdjHMIIDLE/FORWARD/REARWARD
SunShadeLearnStatusLEARN/LEARNING
LockIndicationModeLIGHT/LIGHT_AND_HORN/LIGHTS_AND_TUNE
PowerLiftingRoofModuleCurrentStatusFULL_CLOSE/FULL_OPEN/PARTIALLY_OPEN..MANUAL_OPENING/AUTO_OPENING

九、同信号多 area 分区(重要特征)

信号area 分区
CHILDREN_LOCKDOOR_ROW_2_LEFT/RIGHT(左/右后童锁)
REAR_LOCK_STATUSWINDOW_ROW_2_LEFT/RIGHT(左/右后车窗锁)
POWER_OPERATED_DOOR_MOVING_STATUSDOOR_ROW_1_LEFT/RIGHT + DOOR_ROW_2_LEFT/RIGHT(4 门)
DIM_ROOF_TRANSMIT_LEVELMiVehicleAreaBody.TOP/BOTTOM/TOP_REAR/BOTTOM_REAR(前/后双分区)
UWB_TRUNK_SETDOOR_HOOD/DOOR_REAR(前备箱/后备箱)
LOCK_CAR_CLOSE_SUN_SHADE_CONFIGURATION前天窗遮阳帘/后排遮阳帘