Meross LAN 项目使用教程

Meross LAN 项目使用教程

meross_lan Home Assistant integration for Meross devices 项目地址: https://gitcode.com/gh_mirrors/me/meross_lan

1. 项目目录结构及介绍

Meross LAN 项目是一个用于控制 Meross 设备的 Home Assistant 集成项目。项目的目录结构如下：

meross_lan/
├── .devcontainer/
├── .github/
├── .vscode/
├── custom_components/
│   └── meross_lan/
├── emulator/
│   └── emulator_traces/
├── scripts/
├── tests/
├── .gitattributes
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── hacs.json
├── pyproject.toml
├── requirements_dev.txt
├── requirements_test.txt
└── setup.cfg

• .devcontainer/: 容器开发环境配置文件。
• .github/: GitHub 工作流和自动化脚本。
• .vscode/: Visual Studio Code 项目配置文件。
• custom_components/meross_lan/: Meross LAN 集成的自定义组件代码。
• emulator/: 模拟器相关文件。
• emulator_traces/: 模拟器跟踪文件。
• scripts/: 脚本文件。
• tests/: 测试代码。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件列表。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 项目许可证信息。
• README.md: 项目说明文件。
• hacs.json: HACS（Home Assistant Community Store）集成配置。
• pyproject.toml: Python 项目配置文件。
• requirements_dev.txt: 开发环境依赖。
• requirements_test.txt: 测试环境依赖。
• setup.cfg: 设置配置文件。

2. 项目的启动文件介绍

项目的启动主要是通过 Home Assistant 的集成功能来完成的。用户需要在 Home Assistant 的前端进入 HACS 插件市场，搜索并安装 "Meross LAN" 集成。安装后，Home Assistant 会自动加载 custom_components/meross_lan/ 目录下的组件代码。

启动文件主要包括：

• custom_components/meross_lan/init.py: 初始化文件，用于声明集成和加载必要的组件。
• custom_components/meross_lan/config_flow.py: 配置流程文件，用于处理用户输入的配置信息。

3. 项目的配置文件介绍

项目的配置主要通过 Home Assistant 的配置界面进行，也可以手动修改配置文件。配置文件主要包括：

• configuration.yaml: Home Assistant 的主配置文件，可以在这里添加 Meross LAN 的配置信息。
• custom_components/meross_lan//*.yaml**: Meross LAN 组件的配置文件，用于定义设备发现、设备配置等。

配置文件示例：

# configuration.yaml
meross_lan:
  devices:
    - host: 192.168.1.100
      device_key: 'your_device_key_here'
      protocol: auto
      polling: 30
      disable_multiple_requests: false

在这里，用户需要提供设备的 IP 地址（或主机名）、设备密钥，并可以配置通信协议、轮询周期和其他选项。

meross_lan Home Assistant integration for Meross devices 项目地址: https://gitcode.com/gh_mirrors/me/meross_lan