NormallyClosed 的安装和配置教程

#NormallyClosed 的安装和配置教程

项目基础介绍

NormallyClosed 是一个开源项目，它允许用户使用 Raspberry Pi 控制车库门的开关。该项目通过 GPIO 接口连接到继电器，并通过 Web 界面来操作这些继电器。主要编程语言是 Rust，它因其安全性和性能而适用于此类嵌入式系统项目。

项目使用的关键技术和框架

该项目使用的关键技术包括：

• Rust：一种系统级编程语言，专注于安全、速度和并发。
• GPIO：用于控制 Raspberry Pi 上的硬件接口。
• Web 框架：项目内部集成了一个简单的 Web 服务器，用于提供用户界面和接收用户指令。

准备工作

在开始安装之前，请确保您已经具备以下条件：

• 一台 Raspberry Pi（推荐使用 Pi Zero W 或更高版本）。
• 相应的电源线和 microSD 卡。
• 一个带有至少一个继电器的 HAT，例如 BC Robotics Relay HAT 或 Pimoroni Automation HAT。
• 网络连接，以便下载必要的软件包。
• Rust 编程环境的安装。

安装步骤

1. 设置 Raspberry Pi

首先，您需要设置您的 Raspberry Pi：

• 下载最新的 Raspberry Pi OS。
• 使用 Raspberry Pi Imager 将操作系统烧录到 microSD 卡。
• 将 microSD 卡插入 Raspberry Pi 并启动。
• 连接到网络。

2. 安装 Rust

在 Raspberry Pi 上安装 Rust：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

按照屏幕上的指示完成安装。

3. 克隆项目仓库

在 Raspberry Pi 上打开终端，然后克隆项目仓库：

git clone https://github.com/JakeWharton/NormallyClosed.git
cd NormallyClosed

4. 编译项目

使用 Cargo 编译项目：

cargo build --release

5. 配置项目

复制 config.example.toml 为 config.toml 并根据您的设置进行编辑：

cp config.example.toml config.toml

在 config.toml 文件中，设置您的 Wi-Fi 网络信息以及任何其他必要的配置。

6. 运行项目

编译完成后，运行项目：

cargo run --release

或者如果您已经编译好了二进制文件，可以直接运行它：

./target/release/normally-closed config.toml

7. 访问 Web 界面

在浏览器中输入 Raspberry Pi 的 IP 地址，您应该能够看到 NormallyClosed 的 Web 界面。通过界面上的按钮，您可以控制车库门的开关。

确保按照项目说明正确连接继电器和车库门电机，以保证安全和正确操作。