init

PWM_README.md

@@ -0,0 +1,70 @@
+# 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. 旧的定时器配置会自动设置为数字模式