松果电子电脑控制 - Home Assistant 远程开关机插件

www1988

【插件发布】超便宜的远程开关机模块集成



大家好，最近在使用松果电子的 WiFi 开机卡，这是一款非常实用的硬件：
- 支持远程开关机，再也不用担心电脑忘记关机了
- 配合todesk、向日葵等远控，使用方便
- 支持定时开关机，可以按计划管理电脑
- 硬件安装简单，即插即用，关键是极其便宜
- 支持多种配网方式，连接稳定

但作为一个 Home Assistant 的重度用户，我更希望能把它集成到我的智能家居系统中：
- 统一在 HA 中控制所有设备
- 可以和其他设备联动（比如回家自动开机、离家自动关机）
- 可以加入更复杂的自动化场景
- 可以通过 HA 的各种界面控制（如 Dashboard、手机 APP）

因此，我开发了这个插件，让松果电子的开机卡可以完美接入 Home Assistant。

功能介绍

- 远程开关机控制
- 强制关机/重启功能
- 实时显示电脑状态
- 自动检测设备在线状态
- 支持多设备管理
- UI界面配置，无需修改配置文件

硬件安装说明

在使用此插件前，需要先正确安装松果电子的 WiFi 开机卡：

1. 硬件安装步骤
1. 找到主板上的 PCIE 插槽（长短都可以）
2. 将开机卡插入 PCIE 接口（注意插入方向）
3. 连接开机线：
   - 找到电脑主板上标注为 POWER SW 的跳线
   - 将原有跳线从主板上拔下插到开机卡上
   - 使用附带的开机线（两头一样）
   - 一头插到开机卡剩余的两根针上
   - 另一头插到主板的 POWER SW 针脚上

2. 配网设置
开机卡支持两种配网方式：
1. Airkiss 配网（推荐）
2. Web 配网（备选）

3. 常见硬件问题
1. 开机卡指示灯不亮
   - 进入 BIOS 设置
   - 找到电源关机选项
   - 将 Erp/Eup 设置为关闭
   - 保存退出

2. 能开机不能关机
   - 检查开机卡蓝色指示灯状态
   - 进入控制面板
   - 电源选项 -> 选择电源按钮功能
   - 将"按电源按钮时"改为"关机"
   - 保存设置

安装方法

HACS 安装（推荐）
1. 在 HACS 中添加自定义存储库：
   - 点击 HACS -> 集成
   - 点击右上角菜单中的自定义存储库
   - 在存储库中填入：`www1988/hass-sgdz-computer`
   - 类别选择：Integration
2. 点击 "下载"
3. 重启 Home Assistant

手动安装
1. 下载最新版本的代码：https://github.com/www1988/hass-sgdz-computer
2. 将 `custom_components/sgdz_computer` 文件夹复制到你的 Home Assistant 配置目录下的 `custom_components` 文件夹中
3. 重启 Home Assistant

配置说明

1. 在 Home Assistant 的集成页面中点击添加集成
2. 搜索 "松果电子电脑控制"
3. 输入你的松果电子账号和密码
4. 从列表中选择要控制的设备
5. 完成配置

使用说明

基本控制
- 开机：点击开关即可开机
- 关机：点击开关即可正常关机

高级功能
插件提供了两个服务：
- `sgdz_computer.force_shutdown`: 强制关机
- `sgdz_computer.force_restart`: 强制重启

这些服务可以在自动化、脚本中调用。

属性说明
设备会显示以下属性：
- 设备状态（开/关）
- 在线状态
- 设备名称
- 账号信息

常见问题

1. 设备显示离线
   - 检查设备是否正常连接网络
   - 确认账号密码是否正确

2. 操作没有响应
   - 检查设备是否在线
   - 查看 Home Assistant 日志获取详细错误信息

调试方法

如果需要查看详细日志，可以在 configuration.yaml 中添加：

logger:
  default: info
  logs:
    custom_components.sgdz_computer: debug

复制代码

源码地址

GitHub: https://github.com/www1988/hass-sgdz-computer

欢迎大家使用和反馈，如果觉得好用请给个星标支持一下！

更新计划

未来计划添加的功能：
1. 更多控制选项（休眠、睡眠等）
2. 状态监控优化
3. 自定义更新间隔
4. 更多自动化支持

如有问题和建议，欢迎在留言或在 GitHub 上提交 Issue。

jole

支持集成，

www1988

jole 发表于 2024-12-14 10:59
支持集成，

感谢，我也是在用，所以写了一个