我如何用 CircuitPython 和开源工具监控温室

发布时间：2025-11-05 06:36:43 来源：云智核 作者：系统运维

使用微控制器、何用n和传感器、开源Python 以及 MQTT 持续追踪温室的工具温度、湿度以及环境光。监控

CircuitPython 提供了一种和微控制器板进行交互的温室革命性方式。这篇文章介绍了如何使用 CircuitPython 来监测温室的何用n和温度、湿度以及环境光，开源并且使用 CircuitPython MQTT 客户端将结果发布到一个 MQTT 中介broker。工具你可以在若干个程序中订阅 MQTT 队列并进一步处理信息。监控

这个项目使用一个简单的温室 Python 程序来运行 Web 服务器，它发布一个 Prometheus 格式的何用n和采集端点，拉取监控指标到 Prometheus 进行不间断的开源监控。

关于 CircuitPython

CircuitPython 是工具一个由 Adafruit 创建的开源 Python 发行版，用于运行在低成本微控制器开发板上。监控CircuitPython 为与 兼容的温室开发板 的交互提供了简单的开发体验。你可以在连接你的开发板时挂载的 CIRCUITPYTHON 根驱动器上创建一个 code.py 文件来启动你的程序。CircuitPython 还为开发板提供了一个串行连接，包含一个交互式解释器（REPL）会话，你可以使用 Python 代码实时和开发板进行交互。

Adafruit 的亿华云计算网站提供了大量的文档，可以帮助你开始使用 CircuitPython。首先，参考下《欢迎来到 CircuitPython》指南。这份指南能够帮助你开始使用 CircuitPython 在开发板上运行代码以及和 REPL 交互。它还记录了如何安装 Adafruit 的 CircuitPython 库合集和范例，可以用在它出售的许多开发板和传感器上。接下来，阅读《CircuitPython 基础》指南来学习更多关于其功能的信息，里面还有链接指向在特定及兼容的开发板上使用 CircuitPython 的相关信息。最后，就如所有开源软件一样，你可以深入 CircuitPython 的源码，发布议题，以及做出贡献。

微控制器设置

微控制器系统非常简单。要完成这个示例项目，你会需要：

在将微控制器连接到你的电脑之前，服务器托管将传感器连接到微控制器上。

将传感器连接到微控制器上

现在你可以将微控制器用 USB 数据线连接到你的电脑。

MQTT 中介

你可以使用 这份说明 来在树莓派的系统上安装 Mosquitto MQTT 中介 和 Mosquitto 客户端。如果你想把树莓派做为长期服务器使用，在你的网络上给树莓派 4 设置一个静态 IP 地址。Mosquitto 中介运行起来之后，创建一份 用户名/密码文件，设置客户端向中介发布和订阅消息时用的认证信息。

你可以用树莓派上的 Mosquitto 客户端来测试 MQTT 中介。打开两个终端（如果你是无界面运行的话打开两个 SSH 会话）：

在终端一输入：

这条命令会启动一个持续运行的进程，监听发布到 mqtt/test 队列的消息。

在终端二输入：

这条命令会向 mqtt/test 队列发布一条消息，它应该会显示在终端一的输出里。

现在你可以中止终端一运行的 sub 命令了。

Mosquitto 中介允许客户端发布消息到任何队列，甚至没有任何订阅的队列也可以。这些消息会永久丢失，但这不会阻止客户端继续发布消息。

打开第三个终端，订阅下列队列（你的控制器会发布消息到这些队列上）：

给微控制器编码

现在你已经准备好给微控制器编码，发布它的监测指标到树莓派 4 上运行的 MQTT 中介上了。

Adafruit 有 出色的文档，指导你使用 CircuitPython 库合集 的库来将你的微控制器连接到 WiFi 路由器，并发布监测指标到 MQTT 中介上。

安装下列库到 CIRCUITPYTHON/lib 目录，温室监控会用到它们。这些库在 Adafruit 的 CircuitPython 库合集中都有提供：

库装好了之后，将以下代码写入 CIRCUITPYTHON 文件夹的 code.py 文件中：

保存你的代码。然后连接到串行监视器，看程序连接到你的 MQTT 中介。你还可以将树莓派 4 上的终端切换到订阅了它的发布队列的终端来查看输出。

处理监测指标

像 MQTT 这样的发布/订阅工作流给微控制器系统提供了诸多好处。你可以有多个微控制器 + 传感器来回报同一个系统的不同指标或并行回报相同指标的若干读数。你还可以有多个不同进程订阅各个队列，并行地对这些消息进行回应。甚至还可以有多个进程订阅相同的队列，对消息做出不同的动作，比如数值过高时发送通知邮件或将消息发送到另一个 MQTT 队列上去。

另一个选项是让一个微控制器订阅一个外部队列，可以发送信号告诉微控制器做出动作，比如关闭或开始一个新会话。最后，发布/订阅工作流对低功耗微控制器系统更佳（比如那些使用电池或太阳能的系统），因为这些设备可以在更长的延迟周期后批量发布监测指标，并在回报的间隔期间关闭大量消耗电量的 WiFi 广播。

要处理这些监测指标，我创建了一个 Python 客户端，使用 Paho Python MQTT 客户端 订阅监测指标队列。我还使用官方的 Prometheus Python 客户端 创建了一个 Web 服务器，它产生一个符合 Prometheus 标准的采集端点，使用这些监测指标作为面板信息。Prometheus 服务器和 Mosquitto MQTT 中介我都是运行在同一个树莓派 4 上的。

然后我配置 Prometheus 服务器采集端点数据到 localhost:8000。

你可以在 Github 上访问 温室 MQTT 微控制器 这个项目的代码，项目采用 MIT 许可证授权。 

相关文章