miio完全指南：如何发现和连接局域网中的小米智能设备
【免费下载链接】miioControl Mi Home devices, such as Mi Robot Vacuums, Mi Air Purifiers, Mi Smart Home Gateway (Aqara) and more项目地址: https://gitcode.com/gh_mirrors/mi/miio
miio是一款功能强大的工具，能够帮助用户轻松发现和连接局域网中的小米智能设备，如小米扫地机器人、空气净化器、智能网关等，让你轻松掌控家中智能设备。
一、准备工作：安装miio工具
要开始使用miio发现和连接小米智能设备，首先需要安装miio工具。你可以通过以下步骤进行安装：
- 确保你的系统已经安装了Node.js和npm。
- 打开终端，执行以下命令克隆仓库：
git clone https://gitcode.com/gh_mirrors/mi/miio - 进入项目目录：
cd miio - 安装依赖：
npm install - 全局安装miio：
npm install -g .
安装完成后，你就可以使用miio命令来操作小米智能设备了。
二、发现设备：使用miio discover命令
miio提供了简单易用的设备发现功能，通过miio discover命令可以快速扫描局域网中的小米智能设备。
2.1 基本发现命令
在终端中输入以下命令，miio将开始扫描局域网中的小米智能设备：
miio discover
执行该命令后，miio会列出发现的设备信息，包括设备ID、IP地址、设备型号等。
2.2 显示调试信息
如果你想获取更详细的设备发现过程信息，可以使用调试模式。在终端中输入以下命令：
DEBUG=miio*,thing* miio discover
此命令会显示设备发现过程中的调试信息，有助于你了解设备的连接状态和通信细节。
2.3 同步存储设备令牌
当你首次发现设备时，可能需要获取设备的令牌才能进行连接。使用miio discover --sync命令可以同步存储所有发现设备的令牌，方便后续连接设备：
miio discover --sync
执行该命令后，miio会将发现设备的令牌存储起来，省去了手动输入令牌的麻烦。
三、连接设备：使用miio device命令
发现设备后，你可以使用miio提供的命令来连接设备并进行控制。
3.1 基本连接方式
使用以下命令可以连接到指定的设备，需要提供设备的IP地址或ID：
miio device [ip或id]
例如，要连接IP地址为192.168.1.100的设备，可以输入：
miio device 192.168.1.100
3.2 连接到网关子设备
对于小米智能网关（Aqara）及其子设备，miio也提供了支持。相关的设备代码位于lib/devices/gateway/目录下，你可以通过相应的命令来连接和控制网关子设备。
四、常见问题解决
4.1 设备未被发现
如果执行miio discover命令后没有发现设备，可以尝试以下解决方法：
- 确保设备已通电并连接到局域网。
- 检查设备是否处于待连接状态。
- 重启设备和路由器后再次尝试发现。
4.2 连接设备失败
如果连接设备失败，可能是由于以下原因：
- 设备令牌不正确或未存储，可使用
miio discover --sync命令重新同步令牌。 - 设备IP地址发生变化，可重新执行
miio discover命令获取新的IP地址。 - 设备与电脑不在同一个局域网内，确保它们处于同一网络环境。
通过以上步骤，你可以轻松使用miio工具发现和连接局域网中的小米智能设备，享受智能生活带来的便利。如果你想了解更多关于miio的高级功能，可以查阅docs/advanced-api.md文档。
【免费下载链接】miioControl Mi Home devices, such as Mi Robot Vacuums, Mi Air Purifiers, Mi Smart Home Gateway (Aqara) and more项目地址: https://gitcode.com/gh_mirrors/mi/miio
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
