REST980: 控制iRobot Roomba扫地机器人的强大REST API

REST980:让Roomba扫地机器人智能化升级的神器

在智能家居的浪潮中,iRobot Roomba系列扫地机器人凭借其出色的清洁能力和便捷性,赢得了众多用户的青睐。然而,对于那些渴望对Roomba进行更深度定制和控制的极客用户来说,官方APP的功能还是显得有些不足。这时,REST980项目的出现无疑是一个福音。

REST980项目简介

REST980是GitHub上一个备受欢迎的开源项目,由开发者koalazak创建。该项目的核心目标是为iRobot Roomba 900系列(包括980/i7/i7+等型号)提供一个功能完善的REST API接口。通过这个接口,用户可以通过简单的HTTP请求来控制Roomba的各项功能,实现远程操作、状态监控、清洁计划制定等高级应用。

REST980的主要特性

1. 本地控制: REST980可以在本地网络中运行,无需依赖云服务,保护用户隐私。

2. 丰富的API: 提供了包括启动清洁、暂停、回充等在内的多种操作接口。

3. 实时状态查询: 可以随时获取Roomba的电池电量、清洁状态等信息。

4. 灵活配置: 支持通过配置文件或环境变量进行个性化设置。

5. Docker支持: 提供官方Docker镜像,方便在NAS等设备上部署。

6. 实时地图功能: 通过访问/map路径,可以查看Roomba清洁的实时地图(实验性功能)。

如何使用REST980

要使用REST980,你需要先获取Roomba的BLID(机器人ID)和密码。这些信息可以通过项目提供的工具获取。然后,按照以下步骤操作:

1. 克隆REST980仓库到本地
2. 安装依赖(npm install)
3. 配置BLID和密码
4. 启动服务(npm start)

服务启动后,你就可以通过HTTP请求来控制Roomba了。例如,要开始清洁,只需发送一个GET请求到http://[服务器IP]:3000/api/local/action/start。

curl http://192.168.1.100:3000/api/local/action/start

REST980的应用场景

REST980为Roomba的智能化应用开辟了无限可能。以下是一些潜在的应用场景:

1. 智能家居集成: 将Roomba纳入HomeAssistant等智能家居系统,实现场景联动。

2. 自定义清洁计划: 根据个人作息,开发更灵活的清洁计划功能。

3. 语音控制: 结合语音助手,实现通过语音命令控制Roomba。

4. 清洁数据分析: 收集并分析Roomba的清洁数据,优化家居清洁策略。

5. 远程监控: 开发手机APP或网页应用,随时查看家中清洁状态。

注意事项

尽管REST980提供了强大的功能,但在使用时也需注意以下几点:

1. 确保了解您的Roomba固件版本,并在配置中正确设置。
2. 使用HTTPS和基本认证来保护API接口安全。
3. 频繁的API调用可能会影响Roomba的电池寿命,请合理使用。

结语

REST980为Roomba爱好者和智能家居发烧友提供了一个强大的工具,让我们能够充分发挥Roomba的潜力。无论是简单的远程控制,还是复杂的智能家居集成,REST980都能满足各种需求。随着项目的不断发展和社区的贡献,我们期待看到更多基于REST980的创新应用,让我们的家居生活变得更加智能和便捷。

如果你也是一位Roomba用户,不妨尝试使用REST980,开启你的智能清洁之旅!

🔗 项目地址: https://github.com/koalazak/rest980