@0x5e/homebridge-tuya-平台

叉口版为Tuya Homebridge官方插件,以修复bug和添加新设备支持为主.

⚠️2024.1.14的最新情况: 感谢大家关注这个项目。 越来越多的"出问题装置",通过制造有错误的定义(反倒了0%-100%的状态,错误的范围,错误的单位,.). 一个接一个地支持他们 真的很贵 我以后不会支持他们 请自己解决 PR仍然是受欢迎的,而bug将会被聚焦. 再次感谢:)

特征

• 优化并改进了代码,以提高可读性和可维护性.
• 加强稳定性.
• 减少重复代码 .
• API 错误减少 .
• 新附属类别的开发费用较低.
• 支持图亚·斯克内斯(Tap-to-Run).
• 包括能够覆盖设备配置,从而能够支持"非标准"的DP.
• 支持超过60+设备类别,包括大多数光,开关,传感器,相机,锁,IR遥控等.

支持的 Tuya 设备

见 支援 DEVICES.md

更改日志

见 变动情况

安装

使用此插件之前, 请确定是否卸载 homebridge-tuya-platform 首先,这两个插件不能同时运行。 然而,配置文件是相容的,所以不需要删除.

家用桥网络用户

转到插件页面, 查找 @0x5e/homebridge-tuya-platform 并安装它.

家桥命令行用户

在终端中运行以下命令 :

npm install @0x5e/homebridge-tuya-platform

配置

有两类项目: Custom 财务报告和审定财务报表 Smart Home。 。 。 . 他们之间的区别是:

• 这个 Custom 项目从项目资产中提取设备.
• 这个 Smart Home 项目从Tuya应用程序中的用户家提取设备.

如果你是个人用户,不确定选择哪一个,请使用 Smart Home 项目.

在配置之前,您必须前往 Tuya IoT 平台数字 :

• 创建一个云开发项目,并选择您的应用账户所在的数据中心 。 见 OEM App账户和数据中心之间的绘图
• 转到 Project Page > 翻译: Devices Panel > 翻译: Link Tuya App Account,链接您的应用账户.
• 转到 Project Page > 翻译: Service API > 翻译: Go to Authorize,并订阅下列API(可免费试用):
  • 授权托肯管理
  • 设备状态通知
  • IoT 核心
  • IOT 视频活流(用于相机)
  • 工业项目客户服务处 Custom 项目)
  • IR 控制中心开放服务(用于IR设备)
  • 智能家庭场景链接(用于场景)
  • 智能锁定打开服务( 用于锁定设备)
• 请记住每六个月将API试验期延长一次 Tuya IoT平台 > Cloud > Cloud 服务 > IoT Core (第一次订阅只给你一个月).

“海关”项目

• platform - 说吧 所需经费 :必须是"TuyaPlatform".
• options.projectType - 说吧 所需经费 : 必须是"1"
• options.endpoint - 说吧 所需经费 : 端点 URL 从 API 参考 > 终点 页:1.
• options.accessId - 说吧 所需经费 : 从 Tuya IoT 平台 > 云开发。 。 。 .
• options.accessKey - 说吧 所需经费 : 从 Tuya IoT 平台 > 云开发。 。 。 .
• options.debug - 说吧 选项:包括家园桥日志中的调试输出. (默认 : false(中文(简体) )
• options.debugLevel - 说吧 选项: 带有逗号的可选字符串列表 ,。 。 。 . api 代表 HTTP API 日志, mqtt 代表MQTT日志,设备标识代表设备日志. 如果空白, 所有日志都会输出 .

"闪闪发光"项目

• platform - 说吧 所需经费 :必须是"TuyaPlatform".
• options.projectType - 说吧 所需经费 :必须是"2".
• options.accessId - 说吧 所需经费 : 从 Tuya IoT 平台 > 云开发。 。 。 .
• options.accessKey - 说吧 所需经费 : 从 Tuya IoT 平台 > 云开发。 。 。 .
• options.countryCode - 说吧 所需经费 : 您开发商账户所在区域的数值国家代码. 您可以找到国家代码列表 这里。 。 。 .
• options.username - 说吧 所需经费 :移动应用(Tuya或SmartLife)账户的用户名. 不要使用Tuya IoT平台开发者用户名.
• options.password - 说吧 所需经费 :移动应用程序(Tuya或SmartLife)账户密码. MD5也提供有盐的密码,用于加强安全. 不要使用Tuya IoT平台开发者密码.
• options.appSchema - 说吧 所需经费 : app schema:为图亚智能App的"tuyaSmart",或为智能App的"智能生活".
• options.endpoint - 说吧 选项 : 端点 URL 可以从 API 参考 > 终点 表格基于所提供的国家代码。 只有遇到登录问题并需要指定账户位置的终点时,才手工设置此值.
• options.homeWhitelist - 说吧 选项: 用于您想要白名单的家用ID的整数组。 如果提供,则只包括匹配家庭身份证的设备。 您可以在家园桥日志中找到家庭身份证.
• options.debug - 说吧 选项:包括家园桥日志中的调试输出. (默认 : false(中文(简体) )
• options.debugLevel - 说吧 选项: 带有逗号的可选字符串列表 ,。 。 。 . api 代表API和MQTT日志,设备ID代表特定设备日志. 如果空白, 所有日志都会输出 .

高级选项

见 预选

限制

• 别忘了每6个月延长API的试用期. 也许你可以在日历中设置一个提醒.
• 对多个家用桥/家用助理实例不支持使用同一应用程序账户。 请为每个实例使用单独的应用账户 .
• 该插件需要连接到Tuya Cloud的互联网,而不支持LAN协议. 见 90号 更多信息.

财务问题

关于登录问题

对于大多数用户来说,你可以很容易地通过该程序找到您的应用账户的数据中心 文档 并没有任何问题地登录。 然而,对于一些用户来说,他们可能会遇到错误代码,如1106或2406. 如果你遇到这样的错误,那么你的数据中心和文档之间可能存在差异.

为确定数据中心,遵循这些步骤:

1. 打开应用程序并导航到"我 > 设置 > 网络诊断".
2. 开始诊断并选择"上载日志 > 复制日志到剪贴板".
3. 在任何地方粘贴日志并找到以"Region代码:"开头的行:.
4. 寻找以下代码:"AY"代表中国,"AZ"代表美国西部,"欧盟"代表中欧,"IN"代表印度.

然后在插件配置中手动指定终点 .

什么是"标准DP"和"非标准DP"?

“Standard DP”是指Tuya IoT开发平台文档中指定的设备属性或功能 Tuya IoT 开发平台文档 > Cloud Development > 标准指令集。 。 。 .

例如,灯泡应该有标准的DP代码: switch_led 和可选代码 bright_value编号 :bright_value_v2 以光泽发誓, temp_value编号 :temp_value_v2 颜色温度,和 work_mode 用于修改工作模式。 这些代码可参见上述文档.

如果你的灯泡可以在Tuya应用中调整,但不能与插件一起调整,它最有可能有"非标准DP"

此插件能支持“ 非标准 DP ” 吗 ?

对 该设备必须被列入支持列表并完成以下步骤后才能工作: 1

1. 更改 Tuya 平台上的设备控制模式 :

• 转到 "图亚平台云发展 >您的项目 > 设备 > 所有设备 > 按产品查看设备.
• 查找与您设备相关的产品,单击"pencil"图标(Change Control Direction Mode).
• 
• 在"指令表"中,您可以看到云映射,并确定哪些DP代码缺失,需要稍后手动映射.
• 
• 选择“ DP 指令” 并保存 .

2. 覆盖设备计划, 查看 预选。 。 。 .

当地支助

见 90号。 。 。 .

虽然这个插件现在还没有执行tuya本地协议,但将来仍然有可能.

解决问题

如果没有支持您的设备, 请遵循这些步骤来收集信息 .

1. 获取设备信息

Homebridge成功出道后,设备信息列表会被保存到Homebridge的坚持道上. 您可以在家园桥日志中找到文件路径 :

[2022/11/3 18:37:43] [TuyaPlatform] Device list saved at /path/to/TuyaDeviceList.{uid}.json

请确保删除敏感信息, 如 ip, (中文(简体) ), lon, (中文(简体) ), lat, (中文(简体) ), local_key,以及 uid 在提交文件之前.

2. 启用调试模式

在插件配置中添加调试选项, 然后重新启动 Homebridge .

3. 收集日志

启用调试模式后,您现在可以接收 MQTT 日志 。 操作您的设备, 无论是在物理上还是通过 Tuya App , 接收这样的 MQTT 日志 :

[2022/12/8 12:51:59] [TuyaPlatform] [TuyaOpenMQ] onMessage:
topic = cloud/token/in/xxx
protocol = 4
message = {
  "dataId": "xxx",
  "devId": "xxx",
  "productKey": "xxx",
  "status": [
    {
      "1": "double_click",
      "code": "switch1_value",
      "t": "1670475119766",
      "value": "double_click"
    }
  ]
}

如果您在控制设备时无法接收到任何 MQTT 日志,则可能意味着您的设备有"非标准 DP" .

通过提交设备信息JSON和MQTT日志,您可以帮助我们支持新的设备类别.

捐款

请看 https://github.com/homebridge/homebridge-plugin-template#setup-development-environment 页面存档备份,存于互联网档案馆 开发环境.

公关和问题受到欢迎.

谢谢你花时间利用这个项目 如果这能帮助你,就不要犹豫地给它一颗恒星