Lunar 5.0.2 更新解析:DDC 双显示器适配修复、全量 MCCS VCP 支持与亮度对比度合并控制
Lunar 5.0.2 更新解析:DDC 双显示器适配修复、全量 MCCS VCP 支持与亮度对比度合并控制
导读
本文以 ReleaseNotes/5.0.2.md 为主体,结合 Lunar 开源仓库源码,逐条解析该版本的 3 项关键修复与 3 项功能改进:包括两台相同型号显示器同时使用 DDC 时的延迟与错误分配修复、LG UltraFine 在 Sync Mode 下的环境光自适应误报处理、lunar ddc 命令行对全部 MCCS VCP 代码的支持,以及 Clock Mode 的"Use current brightness"按钮与 Configuration 页"Merge brightness and contrast"复选项背后的实现原理。读完本文,你将掌握 Lunar 5.0.2 各变更项的实战意义、相关源码位置,以及如何用 lunar ddc 直接向显示器发送原始 DDC 命令。
版本概览:5.0.2 的修复与改进全景
Lunar 5.0.2 是一个典型的稳定性 + 工具链增强版本,包含三项修复(Fixes)与三项改进(Improvements):
| 类别 | 内容 | 涉及模块 |
|---|---|---|
| 修复 | DDC 用于两台相同型号显示器时的延迟与错误分配 | DDC 显示匹配逻辑 |
| 修复 | 部分显示器获取当前分辨率时崩溃 | 分辨率读取 |
| 修复 | UltraFine 在 Sync Mode 下误报环境光自适应已启用 | 环境光检测(Display.swift) |
| 改进 | lunar ddc 支持全部 MCCS VCP 代码 |
CLI(CLI.swift) |
| 改进 | Clock Mode 新增 Use current brightness 按钮 | 调度视图(Schedule.swift) |
| 改进 | Configuration 页新增 Merge brightness and contrast 复选项 | 设置缓存与多个 UI 视图 |
其中,"Merge brightness and contrast"允许用户回退到旧版行为(亮度、对比度分开控制),是本次改进中对日常使用影响最大的一项。下文逐一展开。
修复一:两台相同显示器同时使用 DDC 时的延迟与错误分配
更新说明:"Fix lag and wrong monitor assignment when DDC was used for two identical monitors"。
当用户同时连接两台型号完全相同(EDID 名称一致)的外部显示器,并通过 DDC 控制时,Lunar 需要通过显示器序列号或唯一标识区分它们,避免把亮度/对比度/输入源设置写到错误的目标显示器上,同时防止匹配过程引入延迟。5.0.2 修复了这一问题,保证多台相同型号显示器各自独立、准确地响应 DDC 命令。
从源码结构看,显示器标识能力由 Display.swift 提供(如 serial、id、name 等属性),而 lunar ddc 的显示过滤逻辑 getFilteredDisplays(见下文)正是以"显示器序列号或名称"为依据定位目标设备,这为区分相同型号显示器提供了基础。
修复二:部分显示器获取当前分辨率时的崩溃
更新说明:"Fix crash when getting current resolution for some displays"。
Lunar 在读取部分显示器当前分辨率时曾发生崩溃,5.0.2 对该读取路径做了防御性修复,避免在分辨率数据异常或查询失败时导致应用崩溃。该问题通常发生在分辨率回调返回异常数据或显示器状态不完整的场景。此修复增强了应用对异常显示数据的容错能力,属于稳定性层面的关键改进。
修复三:UltraFine 在 Sync Mode 下的环境光自适应误报
更新说明:"Fix Sync Mode for Ultrafines that report having ambient light adaptive brightness enabled when in fact they don't"。
问题背景
部分 LG UltraFine 显示器会向系统报告"已启用环境光自适应亮度(True Tone 类特性)",但实际该功能并未生效。这会导致 Lunar 的 Sync Mode(同步模式)错误地认为显示器正由系统管理亮度,从而跳过亮度同步,造成亮度无法跟随其他显示器变化。
源码证据
Lunar 通过 hasAmbientLightAdaptiveBrightness 属性判断显示器是否具备环境光自适应能力,其底层调用系统 API DisplayServicesHasAmbientLightCompensation(id)(见 Display.swift):
@objc dynamic lazy var hasAmbientLightAdaptiveBrightness: Bool =
isAllDisplays ? false : DisplayServicesHasAmbientLightCompensation(id)
而 systemAdaptiveBrightness 用于追踪系统当前是否接管了自适应亮度,并在 Display.swift 中与 adaptive 属性联动:当系统报告具备环境光自适应能力且用户关闭 Lunar 的自动调节时,系统自适应亮度会被重新开启;同时 cachedSystemAdaptiveBrightness 缓存了上一次读取的结果(见 ManualMode.swift 中应用预设恢复时对缓存值的判断)。
针对 UltraFine 的误报,5.0.2 通过识别显示器型号(isUltraFine 判定逻辑位于 Display.swift:edidName.contains(ULTRAFINE_NAME) && canChangeBrightnessDS),结合对系统报告状态与实际生效状态不一致场景的处理,使 Sync Mode 不再被虚假的"环境光自适应已启用"状态阻塞,恢复了对这类显示器的正常亮度同步。
改进一:lunar ddc 支持全部 MCCS VCP 代码
命令入口
lunar ddc 命令定义在 CLI.swift,其定位是"向已连接的显示器发送原始 DDC 命令"(Send raw DDC commands to connected monitors):
lunar ddc <display> <control> [value...]
参数说明:
| 参数 | 含义 | 默认值 |
|---|---|---|
display |
显示器序列号或名称(无空格),用于过滤目标显示器 | 无 |
control |
DDC 控制 ID(VCP 代码),可用十六进制(如 0x10、E1)或常量名(如 BRIGHTNESS、CONTRAST) |
无 |
value... |
要写入的值;传 read 读取当前值,传 readmax 读取最大值 |
无 |
-s / --source-address |
I²C 源地址,十六进制 | 0x51 |
--hex |
将传入的值按十六进制解析 | false |
全量 VCP 代码的底层来源
5.0.2 的核心改进在于 ControlID 枚举扩展到了全部 MCCS VCP 代码。该枚举定义于 DDC.swift,覆盖从 DEGAUSS (0x01) 到厂商特定代码 MANUFACTURER_SPECIFIC_FF (0xFF) 的完整集合,包括:
- 基础控制:
BRIGHTNESS (0x10)、CONTRAST (0x12)、GAMMA (0x72)、DEGAUSS (0x01)、RESET (0x04) - 几何控制:
HORIZONTAL_POSITION_PHASE (0x20)、WIDTH (0x22)、HEIGHT (0x32)、CLOCK_PHASE (0x3E)等 - 颜色控制:
RED_GAIN (0x16)、GREEN_GAIN (0x18)、BLUE_GAIN (0x1A)、COLOR_TEMPERATURE_REQUEST (0x0C)、HUE (0x90)等 - 音频控制:
AUDIO_SPEAKER_VOLUME (0x62)、AUDIO_MUTE (0x8D)、AUDIO_BASS (0x91)、AUDIO_TREBLE (0x8F) - 电源与状态:
POWER_CONTROL (0xE1)、DPMS (0xD6)、MONITOR_STATUS (0xB7)、VCP_VERSION (0xDF) - 输入源:
INPUT_SOURCE (0x60) - 厂商特定区间:
MANUFACTURER_SPECIFIC_E2 (0xE2)至MANUFACTURER_SPECIFIC_FF (0xFF)
此外,输入源(VideoInputSource)枚举还细分了 HDMI、DisplayPort、Thunderbolt 以及 LG 厂商特定输入源(如 lgSpecificHdmi1 = 0x90、lgSpecificDisplayPort1 = 0xD0 等),见 DDC.swift。
典型用法示例
读取某显示器的亮度(当前值):
lunar ddc <display-serial> BRIGHTNESS read
# 等价于十六进制写法
lunar ddc <display-serial> 0x10 read
写入对比度:
lunar ddc <display-serial> CONTRAST 75
读取控制的最大值:
lunar ddc <display-serial> 0x62 readmax
特殊处理逻辑
实现中针对 LG 显示器做了特别适配(CLI.swift):当目标是 INPUT_SOURCE 且写入值是 LG 特定输入源时,自动将源地址从 0x51 切换为 0x50,并将控制 ID 改为厂商特定的 MANUFACTURER_SPECIFIC_F4,以匹配 LG 显示器的实际 DDC 协议:
if control == .INPUT_SOURCE, let input = VideoInputSource(rawValue: value.u16),
input.isLGSpecific, sourceAddr == 0x51 {
localSourceAddr = 0x50
localControl = .MANUFACTURER_SPECIFIC_F4
}
值解析支持十进制与十六进制(--hex 或自动识别),写入失败时会打印 Error 提示,便于排查显示器是否支持该 VCP 控制。
改进二:Clock Mode 新增"Use current brightness"按钮
Clock Mode(时钟模式,按时间/日出日落调度亮度)此前在设置调度参数时需要手动输入亮度与对比度数值;5.0.2 新增了 Use current brightness 按钮,一键将显示器当前的实际亮度值填入调度设置,省去手动换算。
源码实现
按钮定义于 Schedule.xib,其动作方法 useCurrentBrightness() 位于 Schedule.swift:
@objc func useCurrentBrightness() {
guard let display else { return }
if DC.mergeBrightnessContrast {
withoutRemapping { preciseBrightnessContrast = display.softwareAdjustedBrightnessIfAdaptive / 100 }
} else {
withoutRemapping { preciseBrightness = display.softwareAdjustedBrightnessIfAdaptive / 100 }
preciseContrast = display.preciseContrast
}
}
这里有两个值得注意的细节:
- 取的是"软件修正后"的亮度:
softwareAdjustedBrightnessIfAdaptive会考虑系统自适应调节后的实际显示亮度,而非原始设定值,从而保证填入调度的是用户"肉眼看到"的真实亮度。 - 与合并模式联动:当开启"Merge brightness and contrast"时,按钮同时设置合并后的亮度/对比度值(
preciseBrightnessContrast);未开启时则分别写入preciseBrightness与当前对比度preciseContrast。
改进三:Configuration 页的"Merge brightness and contrast"复选项
变更背景
Lunar 5.0.0 起将亮度与对比度滑块合并为一个"亮度/对比度"组合滑块(见 ReleaseNotes/5.0.0.md)。但部分用户习惯旧版"亮度、对比度分开控制"的行为,因此 5.0.2 在 Configuration 页新增 Merge brightness and contrast 复选项,勾选即保持合并行为,取消勾选即恢复亮度、对比度独立控制。
底层设置项
该开关对应设置缓存键 .mergeBrightnessContrast,定义于 DataStore.swift,并配套发布者 mergeBrightnessContrastPublisher(DataStore.swift)实现全局响应式更新。UI 侧设置开关出现在 QuickActionsLayoutView.swift:
SettingsToggle(text: "Merge brightness and contrast", setting: $mergeBrightnessContrast.animation(.fastSpring))
对核心逻辑的影响
该设置贯穿多个核心模块,从源码可以看到其具体影响面:
- 手动模式应用预设(ManualMode.swift):保存/恢复应用预设前的亮度与对比度时,合并模式下只保存
preciseBrightnessContrast一个值,非合并模式下分别保存preciseBrightness与preciseContrast。 - 滑块映射(Display.swift):
preciseContrast通过contrastToSliderValue(contrast, merged:)计算,合并模式下对比度被折算进组合滑块区间。 - DDC 可用性判断(Display.swift):合并模式下
noDDCOrMergedBrightnessContrast逻辑改变,影响无 DDC 显示器上滑块与控件的可用状态。 - 调度视图(Schedule.swift):合并模式下对比度滑块自动隐藏(
hideContrast),避免重复控制。 - 异常/例外视图(AppException.swift):合并模式与手动数值的显隐联动随之切换。
因此,切换该选项后,不仅 Configuration 页 UI 变化,手动模式、调度、快捷操作等所有亮度控制路径都会统一切换到对应行为,实现"全局一致的回退体验"。
小结与验证建议
Lunar 5.0.2 在稳定性和可配置性上做了扎实的补强:三个修复分别针对相同型号多显示器 DDC 分配、分辨率读取崩溃、UltraFine 环境光误报三个实际痛点;三个改进则显著增强了底层 DDC 工具链(全量 VCP 代码)与用户可控性(调度取值按钮、合并开关)。验证本版本改动时,可以:
- 连接两台相同型号显示器,观察 DDC 调节是否准确对应目标设备、无延迟;
- 对 LG UltraFine 显示器切换到 Sync Mode,确认亮度能跟随环境或主显示器变化;
- 在终端运行
lunar ddc <显示器> BRIGHTNESS read与lunar ddc <显示器> CONTRAST 80,验证全量 VCP 命令读写; - 在 Clock Mode 点击 Use current brightness,确认调度亮度自动取当前值;
- 在 Configuration 页切换 Merge brightness and contrast,对比亮度/对比度滑块在合并与分离两种模式下的行为差异。