HAGenie - 天猫精灵一步接入 HomeAssistant

| 分类 代码  | 标签 智能家居 

一、使用方法

天猫精灵后台配置流程,请参考这篇文章的步骤。直说能用的配置:

  • 账户授权连接:https://hagenie.ga:8122/authorize.py
  • Client ID:https:xxx.xxx.xx:8123(注意不要//)
  • Client Secret:password(如果没有密码随便输入即可,关于密码的建议使用姿势参见最后)
  • Access Token URL:https://hagenie.ga:8122/access.py
  • 开发者网关地址:https://hagenie.ga:8122/gate.py
  • 设备管理跳转连接:(空)

以上配置后直接可以把天猫精灵和 HA 驳接起来了,不需要搭建任何服务器。目前支持除 sensor 外的其它设备的打开和关闭,能自动列出设备,基本零配置搞定全部事情。

二、进阶配置

天猫精灵最重要的三个参数:

  1. zone:仅支持特定的区域,如客厅、餐厅等,详细看这里
  2. deviceName:设备名称也只支持特定的,否则可以显示但它听不懂可能不能控制
  3. deviceType:必须从这个文档中候选

在 gate.py 中会尝试自动从 HA 的配置信息中,根据一些规则尝试自动识别。但有时候可能识别不了,可以在 customize.yaml 中为设备设定天猫精灵能认出来的区域和名称:

hagenie_zone: 客厅
hagenie_deviceName: 吸顶灯
hagenie_deviceType: outlet

以上 hagenie_zone 即可以在HA device entity设备中配置,也可以HA group entity下面给组内所有设备配置。

建议:把设备分组,分组名来自这里,设备名从这里选择 ,这样剩下的事情会自动搞定,不用配置。

三、自定义服务器

注意:以上配置理把所有密码发往我的服务器,虽然我肯定谨守不存、不看、不用三不政策(老社区信用口碑网友:),如果简单测试可以这么玩玩,如果要长期用建议自己搭建服务器,所有代码在这里,持续更新完善中:

https://github.com/Yonsm/HAExtra/tree/master/hagenie

  1. 服务器环境:其中三个 py 文件即可以在 apache 的 cgi-bin 下跑;也可以用 hagenie.py 作为服务器运行(需要完整的 server.pem,记住是需要 chain.pem cert.pem privkey.pem 合一,我被天猫精灵SSL检查这个坑了好久——如果看不明白,建议用前面的简单方式吧),hagenie.py可以在树莓派上跑,但响应比较慢会被天猫精灵服务器直接超时放弃,多试几次可能就好了,但控制起来了比较慢也不爽。

  2. Python 需求:以上支持 python2 或 python3,自动适应;如果 HA 是 https 的需要安装 requests,否则自动使用 urllib 或 urllib2。

  3. 实现细节:直接用 python 做了个伪 oauth2,并且把 oauth流程中流转的数据字段充分利用起来,用来传递 HA URL 地址和密码了…玩玩可以的,不要批评我的 “Oh … Alternative User Token Handover…to…”,哈哈

四、最佳姿势

如果你直接使用 hagenie.ga 服务器,推荐的姿势是使用密码(以便自己访问),但在天猫精灵开发者控制台中不要输入正确的密码(这样不会被 hagenie 服务器看到明文密码了),但在 configuration.yaml 中加入以下配置来信任 hagenie.ga 服务器的 IP 地址:

http:
  api_password: *****
  trusted_networks:
    - 127.0.0.1
    - 101.132.66.191
    - 192.168.1.0/24

原帖发布在:https://bbs.hassbian.com/thread-2700-1-1.html


上一篇     下一篇