在使用树莓派的 GPIO 操作时，许多开发者常常面临一个挑战：编写、维护和调度自定义脚本。这不仅增加了开发难度，还可能导致不必要的错误。为了解决这个问题，raspberry-pi-server 应运而生。raspberry-pi-server 是专门为树莓派设计的服务器组件，可以通过 RESTful 服务控制树莓派的 GPIO 引脚。这一项目的主要目标是消除不必要的「自己造轮子」，用户只需部署一个简单的服务，便可通过 HTTP 请求与树莓派交互。无论用户熟悉哪种技术栈，都可以轻松与 Raspberry Pi 进行互动。这为开发者提供了高度的灵活性，能够使用自己喜欢的客户端技术。

特性

– 简化操作：通过 RESTful API 进行操作，无需再编写和维护 Python 脚本，节省了大量时间和精力。
– 远程控制：可以通过任何支持 HTTP 的设备或平台访问 Pi 的 GPIO，实现远程控制。
– 灵活扩展：支持多种编程语言和框架，方便集成到各种应用场景中。
– 安全性：服务器提供了安全机制，保护你的 Raspberry Pi 免受未经授权的访问。

快速入门

要在 Raspberry Pi 上运行 raspberry-pi-server，只需几个简单的步骤。

Docker 安装

使用 Docker 运行时，您可以在 Raspberry Pi 上输入以下命令：

docker run --privileged -d --restart=unless-stopped -p 80:5000 ghcr.io/rustygreen/raspberry-pi-server:main

Docker Compose 安装

如果您更喜欢使用 Docker Compose，可以创建一个 docker-compose.yml 文件，内容如下：

version: "2"
services:
pi-server:
image:ghcr.io/rustygreen/raspberry-pi-server:main
restart:unless-stopped
privileged:true
ports:
-8081:5000

然后运行以下命令来启动服务：

docker-compose up

不使用 Docker

如果您不想使用 Docker，请参考官方文档中提供的 “Run without Docker” 部分。

使用示例

一旦服务器成功运行，您便可以通过 RESTful API 与 Raspberry Pi 的 GPIO 引脚进行交互。以下是一些基本的使用示例：

1、检索引脚状态：

GET http://YOUR_PI/pins

这个请求将返回一个引脚列表及其当前状态。

2、控制引脚：
通过 POST 请求，您可以设置特定引脚的输出状态。例如，要将引脚 17 设置为高电平，可以发送以下请求：

POST http://YOUR_PI/pins/17
Content-Type: application/json

{
  "state": "high"
}

3、读取引脚输入：
如果您希望读取输入引脚的状态，可以发送 GET 请求至特定引脚：

GET http://YOUR_PI/pins/17/state

这个请求会返回引脚的当前状态（高或低）。

应用场景

raspberry-pi-server 适用于多种应用场景，尤其在物联网项目和自动化系统中表现尤为出色。以下是一些典型的应用：
– 居家自动化：用户可以通过该服务轻松控制家居设备，如灯光、温控器等。
– 教育用途：在教育环境中，教师可以使用 raspberry-pi-server 向学生展示 GPIO 控制的基本概念，无需反复调整脚本代码。
– 快速原型开发：开发者可以快速构建和测试原型，而无需深入了解底层代码实现。

相信你已经掌握了该项目的基本概念和安装方法。让我们开始使用 raspberry-pi-server，构建你的下一款精彩项目吧！

项目地址：https://github.com/rustygreen/raspberry-pi-server