petio/PWM_README.md

PetIO PWM 功能说明

新增功能

PWM 模式支持

• 在手动控制中新增了 PWM 模式开关
• 可以通过滑块调节 PWM 输出强度 (0-100%)
• 在定时器中也支持设置 PWM 模式和强度

使用方法

手动控制 PWM

1. 在"手动控制"标签页中
2. 选择要控制的引脚
3. 勾选"PWM 模式"复选框
4. 使用滑块调节 PWM 强度 (0-100%)
5. 设置持续时间（0表示切换状态）
6. 点击"执行控制"

定时器 PWM

1. 在"定时器管理"标签页中
2. 填写引脚、时间、持续时间等基本信息
3. 勾选"PWM 模式"复选框
4. 使用滑块调节 PWM 强度
5. 设置是否每天重复
6. 点击"添加定时器"

API 变化

手动控制 API

• 端点: POST /api/manual
• 新增参数:
  • isPWM: 布尔值，是否为PWM模式
  • pwmValue: 整数 (0-1023)，PWM强度值

定时器 API

• 端点: POST /api/timers 和 PUT /api/timers/{id}
• 新增参数:
  • isPWM: 布尔值，是否为PWM模式
  • pwmValue: 整数 (0-1023)，PWM强度值

PWM 配置 API

• 端点: GET /api/pwm/config
• 返回 PWM 配置信息:
  • frequency: PWM频率
  • resolution: PWM分辨率
  • maxValue: PWM最大值
  • minValue: PWM最小值
  • defaultValue: PWM默认值

技术细节

PWM 配置

• 频率: 1 KHz
• 分辨率: 10位 (0-1023)
• ESP8266 的 analogWrite() 函数用于PWM输出

数据存储

• PWM 设置会保存到 EEPROM
• 向后兼容旧的定时器配置

显示功能

• 定时器列表会显示PWM模式和强度百分比
• 手动控制页面显示实时PWM强度百分比

注意事项

1. 并非所有引脚都支持PWM输出，请参考ESP8266文档
2. PWM值范围是0-1023，对应0%-100%的输出强度
3. 在数字模式下，PWM值被忽略
4. 旧的定时器配置会自动设置为数字模式