PWM与无源蜂鸣器控制边界
2026-10-04开发候选，待集中测试/构建；未部署到现场。软件命令成功不等于蜂鸣器发声、负载动作或物理关断。
| 目标 | HIGH / LOW | toggle | blink | breathe |
|---|---|---|---|---|
| 原生 PWM | 最大占空比/0 | 支持 | 支持 | 支持 |
| 原生 AO | 配置最大/最小 | 支持 | 不支持 | 支持 |
| 数字输出 passive=true | 半占空比/0；8位时127/0 | 支持 | 支持 | 不支持 |
| DAC | 使用DAC值控制 | 不支持 | 不支持 | 不支持 |
AO模式的0%可能代表最小4mA或非零占空比，不能称为断电。无源蜂鸣器的原始PWM数值仍是占空比，HIGH保留半占空比语义；普通PWM类型的HIGH保持满占空比语义。选择类型、频率和接线必须与实际硬件一致。
这些动作共用规则/MQTT/HTTP/屏幕的普通来源占用。HTTP身份来自认证会话；客户端不能自报actor。手动默认占用30秒，竞争者被拒绝，只有符合条件的目标级review可确认接管，不会自动重试。屏幕通过原保存布局身份执行绑定规则。专用温控/RESET/OE输出不能被普通命令覆盖。
CALL_PERIPHERAL支持文本toggle及JSON动作值{"action":"blink","value":"250"}；省略blink值默认500ms。命名脚本支持PERIPH <id> TOGGLE及PERIPH <id> BLINK <毫秒>，脚本间隔0保留500ms默认，严格限制0～65535。HTTP用toggle=true或action=toggle；blink用action=blink&intervalMs=250，HTTP必须明确有效间隔1～65535。不可混入breathe的periodMs。不能用这些入口给AO启动blink或给passive启动breathe。
toggle依据最后成功提交的逻辑电平翻转，不测量引脚波形。未知状态拒绝翻转；应先核对现场再明确请求所需绝对输出。SDK失败、串口来源过期、计时器无法停止及HTTP503均不会自动重发命令。
stop、手动占用过期和来源退休只停止后续波形写入，保持最后输出；需要静音/归零时应在权限允许且接线安全的前提下明确发LOW/相应值，再确认实际反馈。停止失败保留owner与错误，不能强行清掉记录或冒称已关闭。旧版本无标签计时器需要确认重启/迁移，不能直接视为可接管。
真实设备、声响、PWM频率/波形、AO校准及长稳均尚未验收。历史示例的物理结果和旧固件行为不能直接移作本候选通过证据。