Project Icon

meross_lan

灵活控制Meross智能设备的HomeAssistant集成

meross_lan是一个HomeAssistant集成,支持通过HTTP、本地MQTT或Meross云MQTT控制Meross智能设备。它能自动发现设备,支持直接通信或通过Meross云账户配置。该集成兼容多数Meross产品,如开关、灯具、传感器和恒温器等,实现开关控制、调光和能耗监测等功能。此外,它还能在MQTT不可用时自动切换到HTTP通信,保证设备连接稳定性。

hacs GitHub last commit GitHub Workflow Status GitHub

默罗斯LAN

homeassistant 集成允许您以非常灵活的方式控制您的默罗斯设备。尽管它的名称(起初这是一个仅支持本地LAN连接的项目),但它现在支持这些通信层:

  • 直接 HTTP 连接(在 LAN 中)用于任何可访问的设备
  • 本地 MQTT 代理(在 HA 中配置的代理)
  • 默罗斯云 MQTT 代理

这是两个主要的用例:

  • 保持您的设备与官方默罗斯应用程序(和云基础设施)配对,并通过 HTTP 直接与它们进行通信。这将允许您拥有更大的灵活性和更少的配置麻烦,因为您不必设置和配置这些设备的 MQTT 配对。该集成将仅通过 HTTP(或云 MQTT)与设备进行"旁路"通信,并轮询它们以获取状态更新。从 Cloudy (4.0.0) 版本开始,它还能够通过使用"公共"默罗斯 MQTT 代理与默罗斯原有的云账户基础设施进行通信。
  • 将您的设备绑定到您的"专用"MQTT 代理,以完全与默罗斯基础设施断开连接,并仅在本地进行交互(MQTT 绑定的操作步骤在这里:https://github.com/bytespider/Meross/wiki/MQTT 或者更好,您可以使用 @albertogeniola 在 https://github.com/albertogeniola/meross_pair 的[pairer应用程序])。私有MQTT绑定可能会很痛苦(参见此处的讨论

玩得开心! 😎

安装

HACS

在你的 HA 前端中进入 HACS -> 集成,搜索"Meross LAN"并点击"安装" 你需要重新启动 HA 以让它识别新的集成。

手动安装

下载并将 custom_components/meross_lan 目录复制到你的 homeassistant 安装目录的 custom_components 文件夹中。

根据你的 HA 安装类型,你可能需要遵循特定的说明。

这适用于标准的"核心"安装,但应该适用于任何其他版本:请记住设置适当的所有权和访问权限,以便运行你实例的 homeassistant 用户能够读取和执行该集成代码。

重新启动 HA 以使其生效。

设置

安装并重启后,你的默罗斯设备应该能被HA的dhcp集成自动发现,然后就会出现在你的集成面板上,准备进行配置。

ℹ️ 如果设备未自动发现,尝试将它们关闭10秒钟,然后再打开。一条关于新设备被发现的通知应该会出现在通知中。

ℹ️ 要手动添加您的设备或默罗斯云帐户,请转到HA->设置->设备和服务->添加集成->默罗斯LAN 在这里,选择适当的选项并继续操作

根据您的设备配置方式,您应该按照以下步骤进行:

  • 设备已与默罗斯云帐户配对(这是在您使用制造商应用程序购买和配置设备时的常见情况): 在这种情况下,您的设备应该能被dhcp自动发现,或者您可以手动添加它们的配置。配置默罗斯云帐户大大简化了设备的配置,因为这将自动从您的默罗斯帐户下载所有必需的信息。您仍然可以在没有云帐户登录的情况下手动添加设备,但请记住,您需要"设备密钥",这是存储在您默罗斯资料中的一个秘密。
  • 设备被"私有MQTT绑定"到同一个HA MQTT配置的代理: 在这种情况下,设备只有在它们向代理发布新消息时才会自动被发现。您需要输入您在使用设备重绑定配置工具时配置的相同设备密钥来完成配置。

您也可以通过添加新的集成条目并提供主机地址和设备密钥来手动添加设备(需要为每个设备重复此操作)。

当手动配置设备条目时,您将有以下选项:

  • 主机地址: 这在手动添加设备或通过DHCP发现设备时可用:提供IP地址或有效的网络主机名。当您设置IP地址时,请尽量确保它是"稳定的",并且在重新启动之间不会改变,否则集成可能会"丢失"对设备的访问权限。从2.7.0版开始,meross_lan应该能识别任何动态IP变化,所以您不必手动修复这个问题了。
  • 设备密钥: 这用于根据官方默罗斯协议的行为对消息进行签名。如果您之前已经配置过其他设备,这应该已经填入了一个已知的密钥。如果您输入了错误或者空的密钥,系统会询问您是否要手动重试输入一个不同的密钥,或者是否要从您的默罗斯帐户中恢复密钥。如果您的设备仍与默罗斯应用程序配对,这就是从您的云资料中恢复设备密钥的方法,因为它是由默罗斯应用程序管理并保存的。

这些其他选项在设备首次设置完成后可用。要访问它们,只需通过点击meross_lan集成页面上的设备条目上的"配置"来访问集成配置UI,然后再次点击菜单中的"配置"。

  • 协议:该软件能够直接通过 HTTP 与设备通信,也可通过 MQTT 代理。当您通过 IP 地址 (手动或 DHCP 发现) 配置条目时,它通常'倾向于'使用 HTTP 通信,原因很明显,但它仍可以在识别 MQTT 可用的情况下自动切换到 MQTT (通过'感知'MQTT 消息流)。如果您设置为'Auto' (或留空/未配置),您将在两个方向 (HTTP <-> MQTT) 上拥有这种自动'故障转移'切换,始终尝试确保最佳可用传输进行通信。如果您强制指定 (HTTP 或 MQTT),则不会发生自动协议切换,集成将仅使用该协议进行该配置条目的通信 (目前存在一些小例外,某些命令仍会先通过 HTTP 尝试)。
  • 轮询:设置设备的轮询周期 (默认为 30 秒)。通常会轮询设备以更新其状态。有一些优化措施,例如,如果设备通过 MQTT 连接,许多常规状态更新请求都会自动'丢弃',因为集成可以依赖设备的'推送'行为 (如果将协议设置为'Auto',这也适用)。即使在 MQTT 上,某些其他状态信息仍需要轮询 (例如对于带电量计的电源插头,需要轮询电力/能耗读数)。如果设备仅通过 HTTP 可访问,集成将在每个轮询周期执行'完整'状态更新。请注意,某些信息会根据内部 (固定且可能更长) 超时进行轮询,而不受您设置的配置参数影响。
  • 时区:您可以从预设列表中输入您的本地时区,以便您的设备相应设置。每个设备在启动时都会尝试获取实际 (UTC) 时间,但是,特别是如果您将其与 Meross 云服务取消配对,它的时区信息可能为空,因为它不知道自己所在的位置。这可能会导致一些问题,因此为了修复它,最好让它们知道自己的位置。目前集成无法设置设备时间,所以请确保您的设备能够访问 NTP 服务器 (它们会在启动时这样做)。

支持的硬件

大部分软件都是在我拥有的 Meross 设备上开发和测试的,这些设备随时间慢慢增加。我尝试尽可能乐观和通用地进行开发,基于 @albertogeniola@bytespider 的工作,所以它应该可以与大多数现有硬件配合使用,但我只测试了我自己的设备。有一些用户报告确认它可以与其他设备配合使用,完整的'官方'列表如下 (请注意,某些固件版本可能可用,而其他版本可能不可用:这是硬件和软件的'地狱'):

  • 开关

    • MSS110: 智能 WiFi 迷你插头
    • MSS210: 智能 WiFi 插头
    • MSS305: 带电量测量功能的电源插头
    • MSS310: 带电量测量功能的电源插头
    • MSS315: 带电量测量功能的 Matter 电源插头
    • MSS425: 智能 WiFi 电涌保护器 (多插座电源插座)
    • MSS510: 智能 WiFi 单极开关
    • MSS550: 智能 WiFi 2 路开关
    • MSS620: 智能 WiFi 室内/室外插头
    • MSS710: 智能 WiFi DIY 开关
  • 灯具

    • MSL100: 带可调光功能的智能灯泡
    • MSL120: 带可调光功能的智能 RGB 灯泡
    • MSL320: 智能 WiFi 灯带
    • MSL420: 智能环境灯
  • 中心控制器

    • MSH300: 智能 WiFi 中心控制器
  • 传感器

    • MS100: 智能温湿度传感器
    • MS200: 智能门/窗传感器
    • MS400: 智能漏水传感器
    • GS559AH: 智能烟雾探测器
  • 恒温器

  • MTS100: 智能恒温阀

  • MTS150: 智能恒温阀

  • MTS200: 智能WiFi恒温器

  • MTS960: 智能WiFi插座恒温器

  • 遮阳

    • MRS100: 智能WiFi卷帘
    • MSG100: 智能WiFi车库门开启器
    • MSG200: 智能WiFi车库门开启器(3通道)
  • 加湿器

    • MSXH0 [实验]: 智能WiFi加湿器
    • MOD100 [实验]: 智能WiFi精油扩散器
  • 智能婴儿机

  • 空气净化器

    • MAP100 [实验]: 智能WiFi空气净化器
  • @almico - 改进Meross Hub (MSH300)

  • @Gronda74 - 修复问题

  • @GeorgeCaliment - MRS200改进

  • @ikoz - MTS200改进

他们在解决问题或开发出色的改进方面给了我很大的帮助

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

稿定AI

稿定设计 是一个多功能的在线设计和创意平台,提供广泛的设计工具和资源,以满足不同用户的需求。从专业的图形设计师到普通用户,无论是进行图片处理、智能抠图、H5页面制作还是视频剪辑,稿定设计都能提供简单、高效的解决方案。该平台以其用户友好的界面和强大的功能集合,帮助用户轻松实现创意设计。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号