欢迎使用 USB 开机棒（WiFi） ！这是一款创新的外网远程/本地控制设备，支持按键唤醒和WOL魔术包唤醒，让您随时随地开启远程设备。
¶ 🚀 快速开始
开箱即用，3步完成配置，立即体验智能USB电源管理。
- [首次上电与配网] - 连接
USB_WOL_K Stick Hotspot并配置网络 - [访问Web界面] - 通过
设备IP访问控制页 - [创建第一个定时任务] - 设置您的自动化场景
¶ 💰 服务与交付
¶ 服务模式
| 模式 | 功能 | 费用 |
|---|---|---|
| 本地Web控制 | 局域网内网页控制、用电情况、定时任务 | 免费 |
| 远程控制服务 | 外网远程访问（需联网） | 30天免费试用，后续5元/月 |
| HA接入 | 接入自建Home Assistant平台 | 免费 |
性能提示：远程控制服务与Home Assistant接入因性能限制需二选一，请根据您的使用场景选择。
¶ 发货信息
- 发货周期：下单后3-7天内发货（节假日顺延）
- 物流方式：默认普通快递 | 顺丰加急：需补8元运费
- 现货情况：部分型号有现货，支持当天发货
¶ ⭐ 核心功能
¶ 唤醒方式
- 按键唤醒：模拟键盘操作，兼容性极佳
- WOL魔术包：支持同时唤醒多达5台设备
- 组合触发：支持同时触发按键和WOL，确保唤醒成功率
¶ 配置管理
- 便捷配网：上电后连接
USB WOL/K HOTSPOT热点，自动弹出配置页面，或手动访问http://192.168.4.1进行配置 - 网页配置：路由器后台查看设备IP地址并访问，即可在网页上配置其他功能
- 外网控制：自主启用或关闭远程访问功能
- Home Assistant：支持作为实体接入HA实用，实现更多可玩性。
- HTTP API：一套标准，多端通用，解耦服务，加速开发。
¶ 定时任务
- 多定时支持：最多支持5个定时任务
- 灵活设置：支持自定义执行时间和周期
¶ 📋 详细规格
¶ 【连接与控制】
- 网络连接：Wi-Fi IEEE 802.11 b/g/n
- 控制方式：
- 本地Web网页（主要方式）：访问设备IP地址打开控制页面
- Home Assistant：可接入HA平台
- 硬件按键：短按执行测试
WOK和WOL，相当于按下两个Test按钮，长按10秒重置设备
¶ 📖 操作指南
参考 IOT设备操作指南
¶ 🖥️ Web界面菜单含义
Home Assistant版本
公网远程管理版本
¶ 🧪 参考示例
- 每天的
1点，3点，5点，7点，13点，按下Ctrl+Alt+Del和发送Wol魔术包
- 局域网wol抓包
¶ 🌐 HTTP API
¶ 获取设备状态和事件更新
-
端点：
GET /events -
返回：
text/event-stream -
请求示例:
GET /events HTTP/1.1 Accept: text/event-stream -
成功响应:
retry: 30000 id: 14792589 event: ping data: {"title":"USB WOL/K Stick","comment":"","ota":false,"log":false,"lang":"en"} event: sorting_group data: {"name":"Wake on keypress (Press the specified key to wake up)","sorting_weight":10} event: sorting_group data: {"name":"System","sorting_weight":-1} event: sorting_group data: {"name":"Wake Timer (Send WOL magic packets or keypress at the specified time; setting to 00:00 will not execute)","sorting_weight":9} event: sorting_group data: {"name":"Wake on lan (Enter the MAC address of the lan host split by :)","sorting_weight":11} event: state data: {"id":"sensor-signal","name":"Signal","icon":"mdi:signal","entity_category":2,"value":-70,"state":"-70 dBm","sorting_weight":50,"sorting_group":"System","uom":"dBm"} event: state data: {"id":"switch-enable","name":"Enable","icon":"mdi:dip-switch","entity_category":0,"value":true,"state":"ON","assumed_state":false,"sorting_weight":50,"sorting_group":"Wake Timer (Send WOL magic packets or keypress at the specified time; setting to 00:00 will not execute)"} event: state data: {"id":"switch-enable_wol","name":"Enable WOL","icon":"mdi:dip-switch","entity_category":0,"value":true,"state":"ON","assumed_state":false,"sorting_weight":50,"sorting_group":"Wake on lan (Enter the MAC address of the lan host split by :)"} event: state data: {"id":"switch-enable_wok","name":"Enable WOK","icon":"mdi:dip-switch","entity_category":0,"value":true,"state":"ON","assumed_state":false,"sorting_weight":50,"sorting_group":"Wake on keypress (Press the specified key to wake up)"} event: state data: {"id":"button-factory_reset","name":"Factory Reset","icon":"mdi:restart-alert","entity_category":1,"sorting_weight":50,"sorting_group":"System"} ......
¶ 开关或选项操作
-
功能：打开或启用开关/选项
-
端点：
POST /switch/{switch_id}/turn_on -
路由：
switch_id 对应开关/选项 开关/选项中文释义 startup Startup 上电立即执行一次 enable Enable 启用倒计时 enable_wok Enable WOK 启用WOK开关 enable_wol Enable WOL 启用WOL开关 -
请求示例:
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 对应开关/选项 开关/选项中文释义 startup Startup 上电立即执行一次 enable Enable 启用倒计时 enable_wok Enable WOK 启用WOK开关 enable_wol Enable WOL 启用WOL开关 -
请求示例:
POST /switch/activate_countdown/turn_off HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
-
¶ 按键按下操作
-
端点：
POST /button/{button_id}/press -
路由：
button_id 对应按键 按键中文释义 factory_reset Factory Reset 设备重置 wok_test WOK Test 按键唤醒测试 wol_test WOL Test 网络唤醒测试 -
请求示例:
POST /button/wok_test/press HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
¶ 时间参数设置
-
端点：
POST /time/{time_id}/set -
路由：
time_id 对应设置选项 设置选项中文释义 wake_time_1 Wake Time 1 唤醒操作时间1 wake_time_1 Wake Time 2 唤醒操作时间2 wake_time_1 Wake Time 3 唤醒操作时间3 wake_time_1 Wake Time 4 唤醒操作时间4 wake_time_1 Wake Time 5 唤醒操作时间5 -
参数：
名称 类型 必填 说明 示例 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 对应设置选项 设置选项中文释义 key_pressed Key Pressed 倒计时时长设置 -
参数：
名称 类型 必填 说明 示例 option string 是 选择的选项 F7，Ctrl+Alt+Del -
请求示例:
POST /select/key_pressed/set?option=F7 HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
¶ 文本参数设置
-
端点：
POST /text/{text_id}/set -
路由：
text_id 对应设置选项 设置选项中文释义 key_custom Key Custom 自定义组合键 mac_addr__1 MAC Addr. 1 待唤醒的主机1网卡MAC地址 mac_addr__2 MAC Addr. 2 待唤醒的主机2网卡MAC地址 mac_addr__3 MAC Addr. 3 待唤醒的主机3网卡MAC地址 mac_addr__4 MAC Addr. 4 待唤醒的主机4网卡MAC地址 mac_addr__5 MAC Addr. 5 待唤醒的主机5网卡MAC地址 -
参数：
名称 类型 必填 说明 示例 value string 是 MAC地址设置，使用‘:’分割 BC:DD:C2:EC:71:96，BC:DD:C2:EC:71:97 -
请求示例:
POST /text/mac_addr__1/set?value=aaa HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded -
成功响应:
HTTP/1.1 200 OK
¶ ❓ 常见问题
-
Q：外网服务和HA接入为什么不能同时使用？
A： 这是出于性能考虑的设计选择，硬件性能有限。 -
Q：试用期满后不续费还能用吗？
A： 可以继续使用本地网络内的基础功能，但外网远程控制服务将暂停。