02 · 信号梳理
LightCtrl 域定义在 MiCarPropertyIds.java 第 21-122 行，共 45 个信号常量。本章穷尽列出。
一、45 个 LightCtrl 信号全表
外部灯（控制信号）
| 信号 | 值来源 | 含义 |
|---|
HEADLIGHT | Light.EXTERIOR_LIGHT_MODE | 外灯模式总控（OFF/位置灯/近光/AUTO） |
BEAM / HEADLIGHTS_AUTO / POSITION_LAMP | Light.EXTERIOR_LIGHT_MODE | HEADLIGHT 的语义别名（未直接引用） |
A2_POSITION_LAMP | Light.A2_POSITION_LAMP_SETTING | A2 位置灯（白天十字灯） |
FOG | Light.REAR_FOG_LIGHT_STATE | 后雾灯 |
LIGHTS_REAR_FOG | VehiclePropertyIds.FOG_LIGHTS_SWITCH | 标准 VHAL 雾灯开关 |
HEADLIGHT_DELAY | Light.FOLLOW_ME_HOME_STATE | 大灯延时（伴我回家） |
HEADLIGHT_HEIGHT | Light.EXTERIOR_LIGHT_HEIGHT | 大灯高度 |
ADAPT_HIGH_BEAM_SWITCH | Light.ADAPT_HIGH_BEAM_SWITCH | 自适应远光（IHC） |
BEAM_AUTOADJUST | Light.MOOD_LIGHT_MODE | ⚠️命名误导，值=氛围灯模式，未用 |
FRONT_POSITION_LAMP_CONFIG | Light.FRONT_POSITION_LAMP_CONFIG | 前位置灯配置字（控制 A2 灯显隐） |
EXTERIOR_LIGHT_FUNCTION_SET_NOT_AVAILABLE_REASON | 同名 | 外灯不可用原因（CAN 0x6140211b） |
Property_ID_ExtrLi_Sts | VehiclePropertyIds.HIGH_BEAM_LIGHTS_SWITCH | 外灯状态接收类 |
阅读灯 / 按键背光
| 信号 | 值来源 | 含义 |
|---|
READING_LEAM | Light.READING_LIGHT_STATE | 阅读灯（⚠️LEAM 应为 LAMP） |
ATMOSPHERE_LEAM | Light.MOOD_LIGHT_MODE | 别名，未用 |
KEY_BG_LEVEL | Light.BACK_LIGHT_LEVEL | 按键背光亮度 |
迎宾灯
| 信号 | 值来源 | 含义 |
|---|
WELCOME_LIGHT | Light.WELCOME_LIGHT_STATE | 迎宾灯效（OFF/简/雅/炫，外灯组） |
WELCOME_LIGHT_SWITCH | Light.WELCOME_LIGHT_SWITCH | 上下车迎宾联动（氛围灯组） |
氛围灯（核心，详见 03 专题）
| 信号 | 值来源 | 含义 |
|---|
MOOD_LIGHT_TRIGGER | 同名 | 总开关 OFF/ON/AUTO |
MOOD_LIGHT_MODE_SETTINGS | 同名 | 模式 常亮/呼吸/音乐 |
MOOD_LIGHT_BRIGHTNESS | 同名 | 亮度 1-100 |
MOOD_LIGHT_BREATH_STATE | 同名 | 呼吸 慢/快 |
MOOD_LIGHT_RHYTHM_TYPE | 同名 | 律动 跟随自定义/跟随封面 |
AMBIENT_LIGHT_THEME_MODE_STATUS | 同名 | 颜色模式 单/双/自定义（仅 26A） |
MOOD_LIGHT_THEME_SETTINGS | 同名 | 单色主题 1-5+自定义 |
AMBIENT_LIGHT_BICOLOUR_THEME_STATUS | 同名 | 双色主题 1-5 |
ATMOSPHERE_COLOR | Light.MOOD_LIGHT_COLOR | 自定义色（上层/单层） |
ATMOSPHERE_COLOR_LOWER | Light.AMBIENT_LIGHT_RGB_LAYER2_STATUS | 自定义色（下层） |
ATMOSPHERE_COLOR_SYNCHRONIZATION_SET | 同名 | 上下层同步 |
AMBIENT_LIGHT_DIMMING_DOWN_SWITCH | Light.AMBIENT_LIGHT_DIMMING_DOWN_STATUS | 夜间减弱 |
FOOT_LIGHT_TAB | Light.FOOT_LIGHT_SWITCH_MODE_STATUS | 照脚灯 |
MOOD_LIGHT_TEMPERATURE_ADJUST_STATUS | 同名 | 空调温度联动（未用） |
MUSIC_RHYTHM_STATE | Light.RHYTHM_FLAG | 音乐律动真实状态（右栏预览用） |
ATMOSPHERE_COLOR_IN_RHYTHM | Light.MUSIC_ALBUM_COLOR | 律动时专辑封面色（右栏预览用） |
仪表 Warning 状态信号（右栏车模专用）
| 信号 | 值来源 | 含义 |
|---|
POSITION_BEAM_STATUS | Warning.POSITION_LIGHT | 仪表位置灯 |
LOW_BEAM_STATUS | Warning.LOW_BEAM | 仪表近光 |
HIGH_BEAM_STATUS | Warning.HIGH_BEAM | 仪表远光 |
FOG_BEAM_STATUS | Warning.REAR_FOG_LIGHT | 仪表雾灯 |
转向灯
| 信号 | 值来源 | 含义 |
|---|
LIGHT_AUTO_CANCEL_TURN | Driving.AUTO_TURN_LIGHT_SWITCH_STATUS | 自动取消转向灯（⚠️在 Driving 域） |
LIGHT_AUTO_CANCEL_TURN_UNAVL_RSN | Driving.AUTO_TURN_LIGHT_SWITCH_UNAVL_RSN | 不可用原因 |
其他（灯光秀/盲区，未用）
LIGHT_SHOW_STATUS / LIGHT_SHOW_ENABLE_STATUS / LIGHT_SHOW_NOT_AVL_REASON / BLIND_SPOT_DETECTION_CONFIG
二、信号引用频次排行（grep 实测）
| 次数 | 信号 | 主要使用 Controller |
|---|
| 27 | MOOD_LIGHT_TRIGGER | 几乎所有氛围灯 Controller（可见性依赖） |
| 12 | ATMOSPHERE_COLOR | ColorPick / DoubleColorPick / DisplayTheme |
| 11 | MOOD_LIGHT_THEME_SETTINGS | ColorPick / DisplayTheme / SingleColor |
| 8 | MOOD_LIGHT_MODE_SETTINGS | VisibleHelper / AtmosphereMode / Brightness / Base |
| 5 | HEADLIGHT | ExteriorLights / PropertysMap |
| 5 | AMBIENT_LIGHT_THEME_MODE_STATUS | DoubleColorPick / ColorModeTab |
| 4 | ATMOSPHERE_COLOR_SYNCHRONIZATION_SET | DoubleColorPick |
| 4 | ATMOSPHERE_COLOR_LOWER | DoubleColorPick |
| 3 | MOOD_LIGHT_RHYTHM_TYPE | MusicRhythm / VisibleHelper |
| 2 | MOOD_LIGHT_BREATH_STATE / FRONT_POSITION_LAMP_CONFIG / EXTERIOR_LIGHT_FUNCTION_SET_NOT_AVAILABLE_REASON / AMBIENT_LIGHT_BICOLOUR_THEME_STATUS | 各自 Controller |
三、Controller → 信号完整映射
| Controller | 下行控制（getPropertyIdSet） | 上行监听（getObservedPropertyIdSet 附加） |
|---|
| ExteriorLightsTabLay | HEADLIGHT | FRONT_POSITION_LAMP_CONFIG, EXTERIOR_LIGHT_FUNCTION_SET_NOT_AVAILABLE_REASON |
| HeadLightsDelay | HEADLIGHT_DELAY | — |
| HeadLightsHeight | HEADLIGHT_HEIGHT | — |
| HighBeamAutoAdjust | ADAPT_HIGH_BEAM_SWITCH | — |
| KeyBgLightLevel | KEY_BG_LEVEL | — |
| ReadingLamp | READING_LEAM | — |
| WelcomeLightTab | WELCOME_LIGHT | — |
| AtmosphereLightTab（总开关） | MOOD_LIGHT_TRIGGER | — (SubDependPropertyId=TRIGGER) |
| AtmosphereMode | MOOD_LIGHT_MODE_SETTINGS | MOOD_LIGHT_TRIGGER |
| AtmosphereColorMode | AMBIENT_LIGHT_THEME_MODE_STATUS | MOOD_LIGHT_TRIGGER |
| AtmosphereBrightness | MOOD_LIGHT_BRIGHTNESS | MOOD_LIGHT_TRIGGER, MOOD_LIGHT_MODE_SETTINGS |
| LightBreathState | MOOD_LIGHT_BREATH_STATE | MOOD_LIGHT_TRIGGER |
| MusicRhythm | MOOD_LIGHT_RHYTHM_TYPE | MOOD_LIGHT_TRIGGER |
| DisplayAtmosphereTheme（非26A） | MOOD_LIGHT_THEME_SETTINGS | MOOD_LIGHT_TRIGGER |
| SingleColorTab（26A） | MOOD_LIGHT_THEME_SETTINGS | MOOD_LIGHT_TRIGGER |
| DoubleColorTab（26A） | AMBIENT_LIGHT_BICOLOUR_THEME_STATUS | MOOD_LIGHT_TRIGGER |
| ColorPick（非26A） | ATMOSPHERE_COLOR | MOOD_LIGHT_THEME_SETTINGS, MOOD_LIGHT_TRIGGER |
| DoubleColorPick（26A） | ATMOSPHERE_COLOR, ATMOSPHERE_COLOR_LOWER, _SYNC | AMBIENT_LIGHT_THEME_MODE_STATUS, MOOD_LIGHT_TRIGGER |
| WelcomeLightSwitch | WELCOME_LIGHT_SWITCH | MOOD_LIGHT_TRIGGER |
| AmbientLightDimmingDown | AMBIENT_LIGHT_DIMMING_DOWN_SWITCH | — |
| FootLight | FOOT_LIGHT_TAB | — |
| FogLightButton | FOG | — |
| KunLunWelcomeLight | WELCOME_LIGHT | — |
| PositionA2LAMP | A2_POSITION_LAMP | — |
| LightAutoCancelTurn | LIGHT_AUTO_CANCEL_TURN | LIGHT_AUTO_CANCEL_TURN_UNAVL_RSN |
四、控制信号 vs 状态信号（关键区分）
LightsVehiclePropertysMap 明确区分两组：
- 控制信号
sExteriorLightPropertyIds = {HEADLIGHT, FOG} —— 用户下发用
- 状态信号
sExteriorLightStatusPropertyIds = {POSITION/LOW/HIGH/FOG_BEAM_STATUS}（全 Warning 域）—— 右栏车模显示用
为什么状态用 Warning 域？（源码原注释）：
实际灯泡信号按物理位置区分（一颗坏了状态就变了），而设置页只需表达「该功能开/关」的逻辑状态，所以用仪表 Warning 域的聚合信号——不会被单个灯泡故障影响。
五、信号枚举值（mi.car.config.Light）
| 枚举类 | 常量 |
|---|
ExteriorLightMode | OFF / POSITION_LAMP / BEAM / AUTO（HEADLIGHT；高度档位也复用） |
FollowMeHomeState | OFF / FIFTEEN / THIRTY / SIXTY（HEADLIGHT_DELAY） |
ReadingLightState | OFF / ON / AUTO（READING_LEAM） |
WelcomeLightState | OFF / BRIEF / GRACE / CRAZY（WELCOME_LIGHT） |
AdaptHighBeamSwitch | OFF / AUTO |
MoodLightTrigger | OFF / ON / AUTO |
ModeSettings | DEFAULT / STATIC_LIGHTING / BREATH / MUSIC |
MoodLightBreathState | DEFAULT / SLOW_BREATH / FAST_BREATH |
RhythmType | FOLLOW_CUSTOM / FOLLOW_ALBUM_COVER |
AmbientLightThemeModeStatus | DEFAULT / SINGLE_COLOR / BICOLOR / CUSTOM（仅 26A） |
ThemeSettings | THEME1-5 / CUSTOM（单色）；THEME1-5（双色，无 CUSTOM） |
FootLightSwitchModeStatus | AUTO_LIGHTING / AMB_LIGHTING |
ExteriorLightFunctionSetNotAvailableReason | AVAILABLE / OFF_POPUP_NOT_IN_PARK_DAY… / OFF_NOT_AVAILABLE_NOT_IN_PARK_NIGHT… / _ADAS_LEVEL2 / _ADAS_LEVEL3 |
SwitchWithDefault | ON / OFF（同步、夜间减弱） |
MOOD_LIGHT_BRIGHTNESS | 整数 1-100 |
MOOD_LIGHT_COLOR / RGB_LAYER2 | 颜色索引 1-255（代码 val-1 转 0-254 下标） |
六、本模块未引用的 LightCtrl 信号（预留/他用）
BEAM, HEADLIGHTS_AUTO, POSITION_LAMP, BEAM_AUTOADJUST, ATMOSPHERE_LEAM, LIGHTS_REAR_FOG, Property_ID_ExtrLi_Sts, MOOD_LIGHT_TEMPERATURE_ADJUST_STATUS, LIGHT_SHOW_*(3 个), MUSIC_RHYTHM_STATE(右栏用), ATMOSPHERE_COLOR_IN_RHYTHM(右栏用), BLIND_SPOT_DETECTION_CONFIG。