Flutter插件pigation的介绍与使用

Flutter插件pigation的介绍与使用

PiGation介绍

PiGation 是一个用于在 Raspberry Pi 上运行灌溉系统的 Web 服务器和前端。

PiGation 可以让你配置花坛和灯具，并将这些功能与 Raspberry Pi 上的一般 IO 引脚关联起来。

PiGation 是用 Dart 编写的，安装非常简单。

首先，在你的 Raspberry Pi 上安装 Dart。

一旦 Dart 安装完成，你就可以安装 PiGation。

注意： 你可以在任何 Linux 系统上运行一个测试系统，因为 PiGation 带有一个 IO 模拟器，该模拟器在非 Raspberry Pi 系统上仅会记录任何 IO 引脚更改。

dart pub global activate pigation
dart pub global activate dcli_sdk
sudo env PATH="$PATH" dcli install

根据 dcli 的说明将 ~/.dcli/bin 目录添加到你的路径中。

现在编译 PiGation。

dcli compile --package pigation

现在运行 PiGation 安装程序。这将会把 PiGation 安装到 /opt/pigation。

作为安装的一部分，你需要决定是否使用 HTTP 或 HTTPS 来访问 PiGation。如果你想使用 HTTPS，则你的 PI 必须暴露在互联网上（使用 NAT），并且端口 80 和 443 必须开放。

如果你不明白如何配置 NAT，那么只需选择 HTTP 即可。

sudo env PATH="$PATH" pig

访问

PiGation 服务器包含嵌入式前端。

要访问 PiGation 前端，请从浏览器导航到你的 RiPI 的 IP 地址或完全限定域名。

http://mypi

如果你启用了 HTTPS，则：

https://mypi

Flutter插件pigation开始使用

首先，你需要将 GPIO 引脚连接到灌溉装置，你需要一个继电器设备来提供足够的功率来触发阀门。

硬件配置完成后，你需要定义端点和花坛。

一个端点会在 Pi 上为 GPIO 引脚创建一个命名映射。 一旦你定义了端点，你就可以进入并配置你的花坛。之后，你就可以开始给花园浇水了。

HTTPS

如果你选择了 HTTPS，服务器将在启动时尝试获取 Let’s Encrypt 证书，并且还会自动续订证书。

为了使用 HTTPS，必须满足以下要求：

• 端口 80 和 443 必须对公共互联网开放。这通常需要在家庭路由器上配置 NAT。

• 在安装 PiGation 时，你应该选择一个 ‘Staging’ 证书，直到成功获得证书。

• 一旦你获得了 Staging 证书，你可以通过运行 sudo pig 并切换到 Live 证书来切换到 Live 证书。

部署

pig 安装程序会将其自身安装到 /opt/pigation。

它还会安装一个 cron 作业，以便在你的 RiPi 重新启动时重启 PiGation 服务器。

发布

PiGation 使用 pub_release 发布到 pub.dev。

从 pig_server 根目录运行：

dart pub global activate pub_release
pub_release

配置

/opt/pigation/config/config.yaml 文件用于配置服务器。

安装过程中会基于你在安装期间的回答创建 config.yaml 文件。 如果需要修改配置，最好运行 sudo pig，因为该命令会使用新配置重启 PiGation 服务器。

开发

你需要为开发环境准备一个单独的 config.yaml 文件。

以下是你的 开发 环境的一个示例：

password: XXXXXXXXXXX
path_to_static_content: /home/bsutton/git/pigation/pig_app/build/web
path_to_lets_encrypt_live: /opt/pigation/letsencrypt/live
fqdn: <your local ip>
domain_email: bsutton@onepub.dev
https_port: 10443  # 使用大于 1024 的端口
http_port: 1080
production: false
binding_address: 0.0.0.0
logger_path: console

开发中的证书

在你的开发环境中，你可能会被 NAT 隐藏。 为了测试证书的获取和续订，你需要将端口 443 和 80 从你的本地路由器转发到你的开发机器。

你需要一个具有真实域名和指向你路由器的公共 IP 的 A 记录的 DNS 服务器。

在 Linux 上，你需要让服务器使用高于 1024 的端口（如果你不是 root 用户，只能监听低于 1024 的端口 - 不推荐用于开发）。

建议：

• 80 -> 8080
• 443 -> 8443

你需要更改 config/config.yaml 中的端口设置以匹配你选择的端口号。

你应该一般情况下使用 Staging 证书进行测试，直到你确信你的配置和 NAT 已经正确设置。

本地运行服务

要调试 pig 服务器，你可以在你最喜欢的 IDE 中简单地启动 bin/pig.dart --server。

在 Pi 上构建

dart pub global activate dcli_sdk
sudo env PATH="$PATH" dcli install
git clone https://github.com/bsutton/pig_server.git
dcli compile bin/pig.dart
sudo env PATH="$PATH" pig

发布到 pub.dev

PiGation 服务器旨在发布到 pub.dev 以简化安装。

我们使用 pub_release 来实现这一点。

dart pub global activate pub_release
pub_release