Awtrix3 LED亮度控制：百分比与PWM值的转换原理

亮度控制的基本原理

在Awtrix3智能像素时钟项目中，LED亮度控制是一个基础但重要的功能。用户界面通常以百分比形式(1-100%)显示亮度设置，但实际硬件驱动层面使用的是PWM(Pulse Width Modulation)信号，其有效范围为0-255。

技术实现细节

当用户在设备菜单中将亮度设置为11%时：

1. 系统将百分比转换为PWM值：11% × 255 ≈ 28
2. 这个28就是实际发送给LED驱动电路的PWM值
3. 通过MQTT接口查询stats时，返回的是原始PWM值而非百分比

为什么1-10%看起来"正常"

对于1-10%的小数值：

• 1% → 2.55 → 取整为3
• 10% → 25.5 → 取整为26

由于数值较小，四舍五入后的结果与百分比数值看起来接近，但这只是巧合。实际上系统始终使用0-255范围的PWM值进行控制。

精度损失问题

在百分比和PWM值相互转换过程中会出现精度损失：

1. 用户设置45% → 45×2.55=114.75 → 取整为115
2. 当转换回百分比时：115/255≈45.1%

这种单向转换设计避免了反复转换导致的累积误差，确保LED驱动获得最精确的控制信号。

开发者建议

对于需要精确亮度控制的开发者：

1. 直接使用0-255范围的API进行控制
2. 如需显示百分比，应在应用层进行转换计算
3. 理解硬件驱动层始终使用PWM值的实现原理

这种设计在LED控制领域很常见，既保持了用户界面的友好性，又确保了硬件控制精度。