首页
/ NormallyClosed 的安装和配置教程

NormallyClosed 的安装和配置教程

2025-05-21 05:29:16作者:蔡怀权

#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.tomlconfig.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 界面。通过界面上的按钮,您可以控制车库门的开关。

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

登录后查看全文
热门项目推荐