From 1c61ad9ecee008c526e4a398d1e2a4395355421a Mon Sep 17 00:00:00 2001 From: Xingyu Wang Date: Sun, 20 Jun 2021 15:20:38 +0800 Subject: [PATCH 1/2] PRF @alim0x --- ...ith CircuitPython and open source tools.md | 70 +++++++++---------- 1 file changed, 33 insertions(+), 37 deletions(-) diff --git a/translated/tech/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md b/translated/tech/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md index c5447e39b9..804770742f 100644 --- a/translated/tech/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md +++ b/translated/tech/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md @@ -3,55 +3,53 @@ [#]: author: (Darin London https://opensource.com/users/dmlond) [#]: collector: (lujun9972) [#]: translator: (alim0x) -[#]: reviewer: ( ) +[#]: reviewer: (wxy) [#]: publisher: ( ) [#]: url: ( ) 我如何用 CircuitPython 和开源工具监控温室 ====== -使用微控制器、传感器、Python 以及 MQTT 持续追踪温室的温度、湿度以及环境光。 + +> 使用微控制器、传感器、Python 以及 MQTT 持续追踪温室的温度、湿度以及环境光。 + ![种有西红柿的温室花园][1] -CircuitPython 提供了一种革命性的方式来和微控制器板进行交互。这篇文章介绍了如何使用 CircuitPython 来监测温室的温度、湿度以及环境光，并且使用 CircuitPython MQTT 客户端将结果发布到一个 [MQTT][2] broker。你可以在若干个程序中订阅 MQTT 队列并进一步处理信息。 +CircuitPython 提供了一种和微控制器板进行交互的革命性方式。这篇文章介绍了如何使用 CircuitPython 来监测温室的温度、湿度以及环境光，并且使用 CircuitPython MQTT 客户端将结果发布到一个 [MQTT][2] 中介broker。你可以在若干个程序中订阅 MQTT 队列并进一步处理信息。 -这个项目使用一个简单的 Python 程序来运行 web 服务器，它发布一个 Prometheus 格式的采集端点，拉取监控指标到 [Prometheus][3] 进行不间断的监控。 +这个项目使用一个简单的 Python 程序来运行 Web 服务器，它发布一个 Prometheus 格式的采集端点，拉取监控指标到 [Prometheus][3] 进行不间断的监控。 ### 关于 CircuitPython -[CircuitPython][4] 是一个由 [Adafruit][5] 创建的开源 Python 发行版，用于在低成本微控制器开发板上运行。CircuitPython 在与[兼容的开发板][6]的交互上，提供了一个简单的开发体验。你可以在连接你的开发板时挂载的 `CIRCUITPYTHON` 根驱动器上创建一个 `code.py` 文件来开始你的程序。CircuitPython 还为开发板提供了一个串行连接，包含一个交互式解释器（REPL）会话，你可以使用 Python 代码实时和开发板进行交互。 +[CircuitPython][4] 是一个由 [Adafruit][5] 创建的开源 Python 发行版，用于运行在低成本微控制器开发板上。CircuitPython 为与 [兼容的开发板][6] 的交互提供了简单的开发体验。你可以在连接你的开发板时挂载的 `CIRCUITPYTHON` 根驱动器上创建一个 `code.py` 文件来启动你的程序。CircuitPython 还为开发板提供了一个串行连接，包含一个交互式解释器（REPL）会话，你可以使用 Python 代码实时和开发板进行交互。 -Adafruit 的网站提供了更广泛的文档来帮助你开始使用 CircuitPython。首先，考虑看下这份指南：[欢迎来到 CircuitPython][7]。这份指南能够帮助你开始使用 CircuitPython 在开发板上运行代码以及和 REPL 交互。它还记录了如何安装 Adafruit 的 CircuitPython 库文件包，以及出售的开发板和传感器的一些示例。接下来，阅读 [CircuitPython 基础][8]来学习更多关于它的能力的信息，里面还有链接指向在特定及兼容的开发板上使用 CircuitPython 的相关信息。最后，就如所有开源软件一样，你可以深入 [CircuitPython 的源码][9]，发布 issue，以及做出贡献。 +Adafruit 的网站提供了大量的文档，可以帮助你开始使用 CircuitPython。首先，参考下《[欢迎来到 CircuitPython][7]》指南。这份指南能够帮助你开始使用 CircuitPython 在开发板上运行代码以及和 REPL 交互。它还记录了如何安装 Adafruit 的 CircuitPython 库合集和范例，可以用在它出售的许多开发板和传感器上。接下来，阅读《[CircuitPython 基础][8]》指南来学习更多关于其功能的信息，里面还有链接指向在特定及兼容的开发板上使用 CircuitPython 的相关信息。最后，就如所有开源软件一样，你可以深入 [CircuitPython 的源码][9]，发布议题，以及做出贡献。 ### 微控制器设置 微控制器系统非常简单。要完成这个示例项目，你会需要： - * **Raspberry Pi 4：**你需要一台电脑来给微控制器系统编程，我用的是树莓派 4。 - * **CircuitPython 兼容的微控制器：**我用的是 [Adafruit FeatherS2][10]，带有内置，环境光传感器，Qwiic 线缆输入。 - * **微控制器 WiFi：**FeatherS2 内置了 WiFi。如果你的微控制器没有，你需要给开发板找个 WiFi 扩展板。 - * **传感器：**Feather S2 有个内置的环境光传感器，所以我还需要一个温湿度传感器。有很多不同厂商的产品可以选择，包括 Adafruit、SparkFun、亚马逊。我用的是一个 [Adafruit 传感器][11]，带有 Feather S2 输入兼容的 Qwiic 线缆。尽管多数 SparkFun 传感器可以在 Adafruit 库下工作，但如果你不是从 Adafruit 购买的传感器，你可能还是需要自己去找到它兼容 CircuitPython 的 Python 库。 - * **跳线和线缆：**为了避免使用面包板或焊接，我使用 [Adafruit Qwiic 线缆][12]。SparkFun 销售的包含不同长度的[线缆套装][13]中也有它。 - - + * **树莓派 4**：你需要一台电脑来给微控制器系统编程，我用的是树莓派 4。 + * **CircuitPython 兼容的微控制器**：我用的是 [Adafruit Feather S2][10]，带有内置 WiFi，环境光传感器，Qwiic 线缆输入。 + * **微控制器 WiFi**：Feather S2 内置了 WiFi。如果你的微控制器没有，你需要给开发板找个 WiFi 扩展板。 + * **传感器**：Feather S2 有个内置的环境光传感器，所以我还需要一个温湿度传感器。有很多不同厂商的产品可以选择，包括 Adafruit、SparkFun、亚马逊。我用的是一个 [Adafruit 传感器][11]，带有 Feather S2 输入兼容的 Qwiic 线缆。尽管多数 SparkFun 传感器可以在 Adafruit 库下工作，但如果你不是从 Adafruit 购买的传感器，你可能还是需要自己去找到它兼容 CircuitPython 的 Python 库。 + * **跳线和线缆**：为了避免使用面包板或焊接，我使用 [Adafruit Qwiic 线缆][12]。SparkFun 销售的包含不同长度的[线缆套装][13]中也有它。 在将微控制器连接到你的电脑之前，将传感器连接到微控制器上。 ![将传感器连接到微控制器上][14] -(Darin London, [CC BY-SA 4.0][15]) - 现在你可以将微控制器用 USB 数据线连接到你的电脑。 -### MQTT Broker +### MQTT 中介 -你可以使用[这份说明][16]来在树莓派的系统上安装 [Mosquitto MQTT broker][17] 和 Mosquitto 客户端。如果你想把树莓派做为长期服务器使用，在你的网络上给树莓派 4 设置一个静态 IP 地址。Mosquitto broker 运行起来之后，创建一份[用户名/密码文件][18]，设置客户端向 broker 发布和订阅消息时用的认证信息。 +你可以使用 [这份说明][16] 来在树莓派的系统上安装 [Mosquitto MQTT 中介][17] 和 Mosquitto 客户端。如果你想把树莓派做为长期服务器使用，在你的网络上给树莓派 4 设置一个静态 IP 地址。Mosquitto 中介运行起来之后，创建一份 [用户名/密码文件][18]，设置客户端向中介发布和订阅消息时用的认证信息。 -你可以用树莓派上的 Mosquitto 客户端来测试 MQTT broker。打开两个终端（如果你是无界面运行的话打开两个 SSH 会话）： +你可以用树莓派上的 Mosquitto 客户端来测试 MQTT 中介。打开两个终端（如果你是无界面运行的话打开两个 SSH 会话）： 在终端一输入： ``` -`mosquitto_sub -h localhost -u $user -P $pass -t "mqtt/test"` +mosquitto_sub -h localhost -u $user -P $pass -t "mqtt/test" ``` 这条命令会启动一个持续运行的进程，监听发布到 `mqtt/test` 队列的消息。 @@ -59,14 +57,14 @@ Adafruit 的网站提供了更广泛的文档来帮助你开始使用 CircuitPyt 在终端二输入： ``` -`mosquitto_pub -h localhost -u $user -P $pass -t "mqtt/test" -m hello` +mosquitto_pub -h localhost -u $user -P $pass -t "mqtt/test" -m hello` ``` 这条命令会向 `mqtt/test` 队列发布一条消息，它应该会显示在终端一的输出里。 现在你可以中止终端一运行的 `sub` 命令了。 -Mosquitto broker 允许客户端发布消息到任何队列，甚至没有任何订阅的队列也可以。这些消息会永久丢失，但这不会阻止客户端继续发布消息。 +Mosquitto 中介允许客户端发布消息到任何队列，甚至没有任何订阅的队列也可以。这些消息会永久丢失，但这不会阻止客户端继续发布消息。 打开第三个终端，订阅下列队列（你的控制器会发布消息到这些队列上）： @@ -74,24 +72,22 @@ Mosquitto broker 允许客户端发布消息到任何队列，甚至没有任何 * greenhouse/light * greenhouse/humidity - ### 给微控制器编码 -现在你已经准备好给微控制器编码，发布它的监测指标到树莓派 4 上运行的 MQTT broker 上了。 +现在你已经准备好给微控制器编码，发布它的监测指标到树莓派 4 上运行的 MQTT 中介上了。 -Adafruit 有[出色的文档][19]，指导你使用 [CircuitPython Library Bundle][20] 的库来将你的微控制器连接到 WiFi 路由器，并发布监测指标到 MQTT broker 上。 +Adafruit 有 [出色的文档][19]，指导你使用 [CircuitPython 库合集][20] 的库来将你的微控制器连接到 WiFi 路由器，并发布监测指标到 MQTT 中介上。 -安装下列库到 `CIRCUITPYTHON/lib` 目录，温室监控会用到它们。这些库在 Adafruit 的 CircuitPython Library Bundle 中都有提供： +安装下列库到 `CIRCUITPYTHON/lib` 目录，温室监控会用到它们。这些库在 Adafruit 的 CircuitPython 库合集中都有提供： - * **adafruit_bus_device：**一个带有多个 .mpy 文件的 Python 包文件夹（.mpy 是经过压缩的 Python 文件，用以节省空间） - * **adafruit_requests：**单个 .mpy 文件 - * **adafruit_register：**一个包文件夹 - * **adafruit_minimqtt：**一个包文件夹 - * **adafruit_si7021：**单个 .mpy 文件，用来支持温湿度传感器 + * `adafruit_bus_device`：一个带有多个 .mpy 文件的 Python 包文件夹（.mpy 是经过压缩的 Python 文件，用以节省空间） + * `adafruit_requests`：单个 .mpy 文件 + * `adafruit_register`：一个包文件夹 + * `adafruit_minimqtt`：一个包文件夹 + * `adafruit_si7021`：单个 .mpy 文件，用来支持温湿度传感器 库装好了之后，将以下代码写入 `CIRCUITPYTHON` 文件夹的 `code.py` 文件中： - ``` import time import ssl @@ -177,15 +173,15 @@ while True:         time.sleep(0.5) ``` -保存你的代码。然后连接到串行监视器，看程序连接到你的 MQTT broker。你还可以将树莓派 4 上的终端切换到订阅了它的发布队列的终端来查看输出。 +保存你的代码。然后连接到串行监视器，看程序连接到你的 MQTT 中介。你还可以将树莓派 4 上的终端切换到订阅了它的发布队列的终端来查看输出。 ### 处理监测指标 -像 MQTT 的发布/订阅工作流给微控制器系统提供了诸多好处。你可以有多个微控制器+传感器来回报同一个系统的不同指标或并行回报相同指标的若干读数。你还可以有多个不同进程订阅各个队列，并行地对这些消息进行回应。甚至还可以有多个进程订阅相同的队列，对消息做出不同的动作，比如数值过高时发送通知邮件或将消息发送到另一个 MQTT 队列上去。 +像 MQTT 这样的发布/订阅工作流给微控制器系统提供了诸多好处。你可以有多个微控制器 + 传感器来回报同一个系统的不同指标或并行回报相同指标的若干读数。你还可以有多个不同进程订阅各个队列，并行地对这些消息进行回应。甚至还可以有多个进程订阅相同的队列，对消息做出不同的动作，比如数值过高时发送通知邮件或将消息发送到另一个 MQTT 队列上去。 另一个选项是让一个微控制器订阅一个外部队列，可以发送信号告诉微控制器做出动作，比如关闭或开始一个新会话。最后，发布/订阅工作流对低功耗微控制器系统更佳（比如那些使用电池或太阳能的系统），因为这些设备可以在更长的延迟周期后批量发布监测指标，并在回报的间隔期间关闭大量消耗电量的 WiFi 广播。 -要处理这些监测指标，我创建了一个 Python 客户端，使用 [Paho Python MQTT 客户端][21]订阅监测指标队列。我还使用官方的 [Prometheus Python 客户端][22] 创建了一个 web 服务器，它产生一个符合 Prometheus 标准的采集端点，使用这些监测指标作为面板信息。[Prometheus 服务器][23]和 Mosquitto MQTT broker 我都是运行在同一个树莓派 4 上的。 +要处理这些监测指标，我创建了一个 Python 客户端，使用 [Paho Python MQTT 客户端][21] 订阅监测指标队列。我还使用官方的 [Prometheus Python 客户端][22] 创建了一个 Web 服务器，它产生一个符合 Prometheus 标准的采集端点，使用这些监测指标作为面板信息。[Prometheus 服务器][23]和 Mosquitto MQTT 中介我都是运行在同一个树莓派 4 上的。 ``` from prometheus_client import start_http_server, Gauge @@ -237,9 +233,9 @@ if __name__ == '__main__':         client.loop_forever() ``` -然后我配置 Prometheus 服务器采集端点数据到 localhost:8000。 +然后我配置 Prometheus 服务器采集端点数据到 `localhost:8000`。 -你可以在 Github 上访问 [Greenhouse MQTT Microcontroller][24] 这个项目的代码，项目采用 MIT 许可证授权。 +你可以在 Github 上访问 [温室 MQTT 微控制器][24] 这个项目的代码，项目采用 MIT 许可证授权。 -------------------------------------------------------------------------------- @@ -248,7 +244,7 @@ via: https://opensource.com/article/21/5/monitor-greenhouse-open-source 作者：[Darin London][a] 选题：[lujun9972][b] 译者：[alim0x](https://github.com/alim0x) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 From fb81fcc799afa4a4e54cbc3557ca088fd9eaf3d9 Mon Sep 17 00:00:00 2001 From: Xingyu Wang Date: Sun, 20 Jun 2021 15:21:26 +0800 Subject: [PATCH 2/2] PUB @alim0x https://linux.cn/article-13504-1.html --- ... my greenhouse with CircuitPython and open source tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename {translated/tech => published}/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md (99%) diff --git a/translated/tech/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md b/published/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md similarity index 99% rename from translated/tech/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md rename to published/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md index 804770742f..1248ca1e70 100644 --- a/translated/tech/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md +++ b/published/20210526 How I monitor my greenhouse with CircuitPython and open source tools.md @@ -4,8 +4,8 @@ [#]: collector: (lujun9972) [#]: translator: (alim0x) [#]: reviewer: (wxy) -[#]: publisher: ( ) -[#]: url: ( ) +[#]: publisher: (wxy) +[#]: url: (https://linux.cn/article-13504-1.html) 我如何用 CircuitPython 和开源工具监控温室 ======