Linux工控机屏幕亮度控制方法— 从踩坑到DDC协议

Linux工控机屏幕亮度控制方法 — 从踩坑到DDC协议背景由于项目需要业主要求我们把工控设备的屏幕亮度做到可控在非运营时段把屏幕亮度调到最低达到节能效果。我们的环境操作系统: Fedora 23, MATE 桌面, 32位比较老的系统显示器接口: VGA目标: 在非运营时段降低屏幕亮度以节能最终实测效果屏幕最低亮度比最高亮度功率降低了约60%节能效果非常可观。看起来简单的一个需求实际做起来踩了不少坑。方案踩坑记录方案1写 sysfs 节点无效sudotee/sys/class/backlight/acpi_video0/brightness100这是网上最常见的方案但测试下来完全没有任何作用。原因是这个节点依赖于内核的背光驱动acpi_video或intel_backlight而我们的 VGA 外接显示器不在内核背光驱动的管理范围内所以这个路径根本不存在或者写入无效。方案2xbacklight无效xbacklight-set50xbacklight底层走的也是内核的 backlight 子系统和方案1本质一样对 VGA 外接显示器同样无效。方案3xrandr 软件调光看似有效但节能效果微乎其微xrandr--outputDP1--brightness0.7这个方案确实可以让屏幕看起来变暗但实际测试中发现把亮度降到最低屏幕的功率变化微乎其微。仔细了解原理后恍然大悟xrandr的 brightness 参数本质是软件修改显卡输出的色彩矩阵白话说就是相当于给画面盖了一层暗色滤镜但不影响屏幕的物理背光灯亮度而背光灯才是耗电的根源。总结前三个方案全部失败。方案1和方案2对VGA外接显示器无效方案3看似有效但只是软件层面的假暗无法降低实际功耗。方案4DDC/CI 协议控制最终方案最终找到的可行方案是通过DDC/CI 协议直接控制显示器。DDC 调节亮度可以直接影响屏幕的物理背光灯亮度真正实现降低功耗。DDC/CI 协议介绍什么是 DDC/CI在讲具体操作前先搞清楚三个相关概念协议/标准全称作用DDCDisplay Data Channel主机和显示器之间的通信通道物理上复用在 VGA/HDMI 线缆的特定针脚里本质是一条 I2C 总线EDIDExtended Display Identification Data显示器存在自身 EEPROM 里的只读数据128字节记录了显示器的型号、分辨率、色彩能力等信息系统开机时自动读取VCPVirtual Control Panel把显示器 OSD 菜单里的每个参数都编了号通过 DDC/CI 协议读写。比如0x10就是亮度0x12是对比度通俗地理解DDC→ 通信线路通讯协议EDID→ 显示器的身份证只读系统自动用VCP→ 显示器的遥控器按键编号你用来调参数的使用 ddcutil 工具控制安装 ddcutilFedora 23 的仓库里可能没有ddcutil需要手动编译安装# 安装依赖sudodnfinstallgccmakei2c-tools i2c-tools-devel libdrm-devel# 下载源码选择较老的兼容版本wgethttps://www.ddcutil.com/tarballs/ddcutil-0.9.9.tar.gztar-xzfddcutil-0.9.9.tar.gzcdddcutil-0.9.9 ./configuremakesudomakeinstall加载 i2c 内核模块DDC 协议依赖i2c-dev模块这一步是关键操作系统默认没有加载# 加载模块sudomodprobe i2c-dev# 设置开机自动加载echoi2c-dev|sudotee/etc/modules-load.d/i2c.conf检测显示器# 检查 i2c 设备ls/dev/i2c-*# 正常情况下会看到以下输出/dev/i2c-0 /dev/i2c-1 /dev/i2c-2 /dev/i2c-3 /dev/i2c-4 /dev/i2c-5 /dev/i2c-6# 检测 ddcutil 能否识别显示器sudoddcutil detect正常情况下检测到支持 DDC 的显示器Display 1 I2C bus: /dev/i2c-3 EDID synopsis: Mfg id: ELO Model: ELO ET2002L Serial number: Manufacture year: 2019 EDID version: 1.3 VCP version: 2.2如果没有检测到显示器或i2c-dev未启用No displays found如果找到显示器但不支持 DDC 协议Invalid display I2C bus: /dev/i2c-4 EDID synopsis: Mfg id: TCH Model: VGA Serial number: Manufacture year: 2021 EDID version: 1.3 DDC communication failed读取和设置亮度DDC/CI 中亮度对应的 VCP 特性码是0x10# 读取当前亮度sudoddcutil getvcp 0x10# 设置亮度0~100sudoddcutil setvcp 0x1050# 设为 50%sudoddcutil setvcp 0x100# 设为最低关闭背光指定特定显示器如果有多台 DDC 设备可以通过以下方式指定# 方式一通过 display 编号最简单--display后面跟的数字对应ddcutil detect 结果的Display后面的数字sudoddcutil--display1getvcp 0x10sudoddcutil--display2setvcp 0x1070# 方式二通过 i2c 总线编号注意总线地址可能会变化--bus后面跟的数字对应ddcutil detect 结果的I2C bus字段后的/dev/i2c-x中的xsudoddcutil--bus3getvcp 0x10# 方式三通过序列号最稳定不受插拔顺序影响--sn后面的内容对应ddcutil detect 结果的Serial number字段sudoddcutil--snABC123456setvcp 0x1070推荐: 生产环境脚本中用--sn序列号方式因为 i2c 总线编号和 display 编号可能在重启或重新插拔后发生变化。同时控制所有显示器ddcutil本身不支持广播可以用脚本实现foriin$(ddcutil detect|grepDisplay|awk{print $2});dosudoddcutil--display$isetvcp 0x1070done通过编程实现 DDC/CI 控制如果不希望依赖ddcutil工具可以直接通过 C 语言操作/dev/i2c-*设备文件实现。DDC/CI 本质上就是通过 i2c 总线发送特定格式的数据包。协议基础参数值说明DDC/CI 显示器 i2c 地址0x37固定地址写地址0x6E0x37 1读地址0x6F0x37 1 | 1亮度 VCP 码0x10BrightnessC 语言实现#includestdio.h#includestdlib.h#includestring.h#includefcntl.h#includeunistd.h#includesys/ioctl.h#includelinux/i2c-dev.h#defineDDC_ADDR0x37#defineVCP_BRIGHTNESS0x10staticunsignedcharcalc_checksum(unsignedchardest,unsignedchar*buf,intlen){unsignedcharcsdest;for(inti0;ilen;i)cs^buf[i];returncs;}intopen_i2c(constchar*bus){intfdopen(bus,O_RDWR);if(fd0){perror(open);return-1;}if(ioctl(fd,I2C_SLAVE,DDC_ADDR)0){perror(ioctl);close(fd);return-1;}returnfd;}intddc_get_vcp(intfd,unsignedcharvcp_code,unsignedshort*cur_val,unsignedshort*max_val){unsignedcharreq[5];req[0]0x51;req[1]0x80|0x02;req[2]0x01;req[3]vcp_code;req[4]calc_checksum(0x6E,req,4);for(intretry0;retry5;retry){if(write(fd,req,5)!5){perror(write);return-1;}usleep(200000);unsignedcharresp[20];memset(resp,0,sizeof(resp));intnread(fd,resp,20);if(n0){usleep(200000);continue;}// 响应格式: [0]0x6e [1]0x88 [2]0x02 [3]0x00 [4]vcp// [5]type [6]maxH [7]maxL [8]curH [9]curL [10]csif(resp[0]0x6eresp[1]0x80){printf(Null response, retry...\n);usleep(300000);continue;}if(n10resp[0]0x6eresp[2]0x02resp[4]vcp_code){if(max_val)*max_val(resp[6]8)|resp[7];if(cur_val)*cur_val(resp[8]8)|resp[9];return0;}usleep(200000);}return-1;}intddc_set_vcp(intfd,unsignedcharvcp_code,unsignedshortvalue){unsignedcharreq[7];req[0]0x51;req[1]0x80|0x04;req[2]0x03;req[3]vcp_code;req[4](value8)0xFF;req[5]value0xFF;req[6]calc_checksum(0x6E,req,6);if(write(fd,req,7)!7){perror(write);return-1;}usleep(200000);return0;}intmain(intargc,char*argv[]){if(argc3){fprintf(stderr,Usage: %s i2c-bus brightness 0-100\n,argv[0]);return1;}intbrightnessatoi(argv[2]);if(brightness0||brightness100){fprintf(stderr,Brightness must be 0-100\n);return1;}intfdopen_i2c(argv[1]);if(fd0)return1;unsignedshortcur0,max0;if(ddc_get_vcp(fd,VCP_BRIGHTNESS,cur,max)!0){fprintf(stderr,Failed to read brightness\n);close(fd);return1;}printf(Current: %d, Max: %d\n,cur,max);unsignedshorttarget(unsignedshort)(brightness*max/100);printf(Setting brightness to %d (%d%%)\n,target,brightness);if(ddc_set_vcp(fd,VCP_BRIGHTNESS,target)!0){fprintf(stderr,Failed to set brightness\n);close(fd);return1;}usleep(300000);if(ddc_get_vcp(fd,VCP_BRIGHTNESS,cur,max)0){printf(Verified: brightness %d\n,cur);}close(fd);return0;}编译运行gcc-oddc_brightness ddc_brightness.csudo./ddc_brightness /dev/i2c-380期望输出Current: 1, Max: 100 Setting brightness to 80 (80%) Verified: brightness 80VCP 功能码速查表除了亮度DDC/CI 还支持很多显示器参数控制。以下是常用的 VCP 功能码图像质量功能功能码值范围说明亮度0x100-100Brightness对比度0x120-100Contrast锐度0x870-100Sharpness黑电平0x920-100Black Level色温预设0x14可选值1sRGB,2Native,56500K,89300K 等颜色调节功能功能码值范围说明红色增益0x160-100Red Gain绿色增益0x180-100Green Gain蓝色增益0x1A0-100Blue Gain色调0x900-100Hue饱和度0x8A0-100Saturation输入与电源功能功能码值说明输入信号源0x601VGA, 3DVI, 15DP, 17HDMIInput Source电源模式0xD61On, 2Standby, 4OffPower Mode音频功能功能码值范围说明音量0x620-100Audio Volume静音0x8D1开/2关Audio Mute查看你的显示器实际支持项不同显示器支持的 VCP 码不同建议先查看实际支持列表# 查看显示器声明支持的功能列表sudoddcutil capabilities# 扫描所有已知功能码的当前值sudoddcutil getvcp scan注意事项VGA 接口的 DDC 支持VGA 线通过第 9/12/15 针脚传输 I2C 信号大多数现代显示器支持但部分老显示器可能不响应 DDC/CI 命令i2c-dev 模块必须先加载i2c-dev内核模块否则无法操作权限操作/dev/i2c-*设备需要 root 权限兼容性Fedora 23 已停止维护内核版本较老建议安装ddcutil的较低版本如 0.9.9以保证兼容性验证实际支持操作前先运行ddcutil capabilities确认显示器支持哪些 VCP 功能码避免操作不支持的码导致无响应眼见为实DDC亮度最高实测功率 13.5WDDC亮度最低实测功率5.58W