欢迎使用 USB 电压调节器！一款专为智能家居与自动化场景设计的USB电压调节设备，集PWM调压、远程控制与定时任务于一身，让您通过网页即可精准调节任何USB设备的输出电压。
¶ 🚀 快速开始
开箱即用，3步完成配置，立即体验智能USB电压调节。
- [首次上电与配网] - 连接
usb-volt-reg-revwe1-xxxxxx并配置网络 - [访问Web界面] - 通过
设备IP访问控制页 - [创建第一个定时任务] - 设置您的自动化场景
¶ 💰 服务与交付
¶ 服务模式
| 模式 | 功能 | 费用 |
|---|---|---|
| 本地Web控制 | 局域网内网页控制、定时任务 | 免费 |
| 远程控制服务 | 外网远程访问（需联网） | 30天免费试用，后续5元/月 |
| HA接入 | 接入自建Home Assistant平台 | 免费 |
性能提示：远程控制服务与Home Assistant接入因性能限制需二选一，请根据您的使用场景选择。
¶ 发货信息
- 发货周期：下单后3-7天内发货（节假日顺延）
- 物流方式：默认普通快递 | 顺丰加急：需补8元运费
- 现货情况：部分型号有现货，支持当天发货
¶ ⭐ 核心功能亮点
¶ 🔌 远程网页控制
- 本地Web控制：通过浏览器访问设备IP进入控制页面
- 外网远程控制（可选服务）：随时随地管理设备状态
- Home Assistant集成：无缝接入智能家居生态
- HTTP API：一套标准，多端通用，解耦服务，加速开发。
¶ ⏰ 多功能定时器
- 普通定时：设定固定开关时间，每日自动执行
- 循环定时：设置"开X分钟，关Y分钟"的循环模式
- 倒计时：延时开启或关闭，支持正向/反向计时
- 点动模式：单次触发，周期结束后自动状态翻转
¶ 📋 详细规格
¶ 【连接与控制】
- 网络连接：Wi-Fi IEEE 802.11 b/g/n
- 控制方式：
- 本地Web网页（主要方式）：访问设备IP地址打开控制页面
- Home Assistant：可接入HA平台
- 硬件按键：短按循环
开和关切换，长按10秒重置
¶ 【电源与性能】
- 输入电压：最低 DC 5V 3A
- 输出范围：DC 0~28V 最高 2A
¶ 🎯 定时功能
| 定时模式 | 应用场景 | 配置示例 |
|---|---|---|
| 倒计时 | 为风扇设置延时关闭 | 设置2小时，选中"倒转"选项 |
| 普通定时 | 自动管理桌面香薰机 | 工作日9:00开启，18:00关闭 |
| 循环定时 | 控制鱼缸供氧泵 | 开启10分钟，关闭50分钟 |
| 点动开关 | 走廊灯延时关闭 | 设置5秒周期，实现状态改变后5秒后自动翻转状态 |
¶ 🆚 产品优势
¶ 为什么选择我们？
- 功能全面：远程控制 + 多种定时 + 快充支持
- 数据本地化：Web控制模式数据存储在本地，响应迅速，隐私安全
- 灵活集成：独立使用或接入Home Assistant生态系统
- 即买即用：现货或预售，BS架构，无需二次开发
- 性价比高：一体化解決方案，无需额外组件
¶ 📖 操作指南
参考 IOT设备操作指南
¶ 🖥️ Web界面菜单含义
¶ 🧪 参考示例
¶ ⏱️ 倒计时 2分钟（120秒）后关闭USB开关
¶ ⏱️ 倒计时 5分钟（300秒）后开启USB开关
¶ 🕒 常规定时 22时15分开启USB开关，6时5分关闭USB开关
¶ 🔄 循环定时 开启USB开关持续19小时30分钟（70200秒）后关闭USB开关持续6小时15分钟（22500秒），反复循环
¶ ⚡ 点动定时 USB开关每次开启后，7分钟（420秒）后自动关闭
¶ ⚡ 点动定时 USB开关每次关闭后，7分钟（420秒）后自动开启
同上设置，激活点动前先开启USB开关即可
¶ 🔠 串口指令
| 命令 | 功能描述 | 参数要求 | 示例 |
|---|---|---|---|
0:X |
关闭输出 | X=0~100 | 0:1 |
1:X |
打开输出并设置输出 | 输出调节，X=0~100 | 1:100 |
¶ 🌐 HTTP API
¶ 获取设备状态和事件更新
-
端点：
GET /events -
返回：
text/event-stream -
请求示例:
GET /events HTTP/1.1 Accept: text/event-stream -
成功响应:
retry: 30000 id: 769359 event: ping data: {"title":"USB3 Switch VER.C","comment":"","ota":false,"log":false,"lang":"en"} event: state data: {"id":"sensor-signal","name":"Signal","icon":"mdi:signal","entity_category":2,"value":-65,"state":"-65 dBm","sorting_weight":50,"sorting_group":"System","uom":"dBm"} event: state data: {"id":"sensor-supply_voltage","name":"Supply Voltage","icon":"mdi:sine-wave","entity_category":0,"value":5.04,"state":"5.04 V","sorting_weight":50,"sorting_group":"System","uom":"V"} event: state data: {"id":"sensor-supply_current","name":"Supply Current","icon":"mdi:current-dc","entity_category":0,"value":0,"state":"0.000 A","sorting_weight":50,"sorting_group":"System","uom":"A"} event: state data: {"id":"sensor-supply_power","name":"Supply Power","icon":"mdi:meter-electric-outline","entity_category":0,"value":0,"state":"0.00 W","sorting_weight":50,"sorting_group":"System","uom":"W"} event: state data: {"id":"sensor-countdown_remain","name":"Countdown Remain","icon":"mdi:timer-sand","entity_category":0,"value":0,"state":"0.0","sorting_weight":50,"sorting_group":"Countdown: toggle switch after reaching the specified duration"} event: state data: {"id":"sensor-jogging_remain","name":"Jogging Remain","icon":"mdi:timer-sand","entity_category":0,"value":10192,"state":"10192.0","sorting_weight":50,"sorting_group":"Jogging: toggle after a period of time following the switch action"} event: state data: {"id":"sensor-open_remain","name":"Open Remain","icon":"mdi:timer-sand","entity_category":0,"value":120,"state":"120.0","sorting_weight":50,"sorting_group":"Cycle: trun on or turn off switch at the specified duration"} event: state data: {"id":"sensor-shut_remain","name":"Shut Remain","icon":"mdi:timer-sand","entity_category":0,"value":14400,"state":"14400.0","sorting_weight":50,"sorting_group":"Cycle: trun on or turn off switch at the specified duration"} ......
¶ 开关或选项操作
功能：打开或启用开关/选项
-
端点：
POST /switch/{switch_id}/turn_on -
路由：
switch_id 对应开关/选项 开关/选项中文释义 usb_switch USB Switch USB 开关 activate_countdown Activate Countdown 启用倒计时 converse Converse 翻转倒计时动作 activate_regular Activate Regular 启用常规定时 activate_cycle Activate Cycle 启用循环/周期定时 activate_jogging Activate Jogging 启用点动定时 -
请求示例:
POST /switch/activate_countdown/turn_on HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
功能：关闭或禁用开关/选项
-
端点：
POST /switch/{switch_id}/turn_off -
路由：
switch_id 对应开关/选项 开关/选项中文释义 usb_switch USB Switch USB 开关 activate_countdown Activate Countdown 启用倒计时 converse Converse 翻转倒计时动作 activate_regular Activate Regular 启用常规定时 activate_cycle Activate Cycle 启用循环/周期定时 activate_jogging Activate Jogging 启用点动定时 -
请求示例:
POST /switch/activate_countdown/turn_off HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
¶ 时间参数设置
-
端点：
POST /time/{time_id}/set -
路由：
time_id 对应设置选项 设置选项中文释义 duration Duration 倒计时时长设置 open_time Open Time 常规定时开启时间 shut_time Shut Time 常规定时关闭时间 open_duration Open Duration 循环/周期定时开启时长 shut_duration Open Remain 循环/周期定时关闭时长 period Period 点动定时翻转等待时长 -
参数：
名称 类型 必填 说明 示例 value string 是 时间/时长设置，使用HH:MM格式 01:30，23:18 -
请求示例:
POST /time/duration/set?value=01:00 HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
¶ 下拉选项设置
-
端点：
POST /select/{select_id}/set -
路由：
select_id 对应设置选项 设置选项中文释义 baudrate Baudrate 串口波特率 -
参数：
名称 类型 必填 说明 示例 option string 是 选择的选项 9600，115200 -
请求示例:
POST /select/baudrate/set?option=115200 HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
¶ 滑动条设置
-
端点：
POST /number/{number_id}/set -
路由：
number_id 对应设置选项 设置选项中文释义 regulator Regulator 输出电压调节 -
参数：
名称 类型 必填 说明 示例 option string 是 选择的选项 60 -
请求示例:
POST /number/regulator/set?value=60 HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
¶ ❓ 常见问题
-
Q：外网服务和HA接入为什么不能同时使用？
A： 这是出于性能考虑的设计选择，硬件性能有限。 -
Q：试用期满后不续费还能用吗？
A： 可以继续使用本地网络内的基础功能，但外网远程控制服务将暂停。