当前位置：首页 > news >正文

pi-gpio实战项目：如何用Node.js控制树莓派继电器模块

news 2026/7/26 10:28:44

pi-gpio实战项目：如何用Node.js控制树莓派继电器模块

【免费下载链接】pi-gpioA simple node.js-based GPIO helper for the Raspberry Pi项目地址: https://gitcode.com/gh_mirrors/pi/pi-gpio

pi-gpio是一个基于Node.js的简单库，专为树莓派（Debian Wheezy）设计，用于简化GPIO（通用输入输出）接口的访问。通过这个强大的工具，即使是新手也能轻松实现对树莓派硬件的控制，比如本文将重点介绍的继电器模块控制。

为什么选择pi-gpio控制继电器？

继电器是树莓派项目中常用的硬件组件，它可以帮助我们用低电压信号（如树莓派GPIO引脚输出的3.3V信号）控制高电压设备（如灯泡、电机、家电等）。而pi-gpio库则提供了以下优势：

简单易用：API设计直观，类似Node.js内置的fs模块
硬件兼容性广：支持原始树莓派（A和B）、B型修订版2、A+和B+型号
抽象化硬件细节：无需了解复杂的Broadcom芯片引脚映射，直接使用物理引脚编号

准备工作：安装与环境配置

1. 安装依赖工具

首先需要安装gpio-admin来安全访问GPIO引脚，避免直接使用root权限带来的风险：

git clone git://github.com/quick2wire/quick2wire-gpio-admin.git cd quick2wire-gpio-admin make sudo make install sudo adduser $USER gpio

⚠️ 安装完成后需要注销并重新登录，使权限生效

2. 安装pi-gpio库

使用npm安装pi-gpio到你的项目中：

npm install pi-gpio

3. 硬件连接指南

将继电器模块连接到树莓派时，请遵循以下步骤：

将继电器模块的VCC连接到树莓派的5V引脚（物理引脚2）
将继电器模块的GND连接到树莓派的GND引脚（物理引脚6）
将继电器模块的信号输入引脚连接到树莓派的GPIO引脚（推荐使用物理引脚16，如本文示例）

核心功能：pi-gpio API详解

打开引脚（.open()）

使指定引脚可用，需要指定引脚号和方向（输入/输出）：

var gpio = require("pi-gpio"); // 打开引脚16作为输出 gpio.open(16, "output", function(err) { if (err) throw err; // 引脚已准备好使用 });

写入值（.write()）

向输出引脚写入值（0或1），控制继电器的开关状态：

// 设置引脚16为高电平（1）- 继电器吸合 gpio.write(16, 1, function(err) { if (err) throw err; console.log("继电器已打开"); }); // 设置引脚16为低电平（0）- 继电器释放 gpio.write(16, 0, function(err) { if (err) throw err; console.log("继电器已关闭"); });

关闭引脚（.close()）

使用完毕后关闭引脚，释放资源：

gpio.close(16, function(err) { if (err) throw err; console.log("引脚已关闭"); });

完整实例：控制继电器开关

下面是一个完整的Node.js脚本，实现控制继电器开关的功能：

var gpio = require("pi-gpio"); // 定义继电器连接的物理引脚 const RELAY_PIN = 16; // 打开引脚 gpio.open(RELAY_PIN, "output", function(err) { if (err) { console.error("无法打开引脚:", err); return; } console.log("引脚已打开，开始控制继电器..."); // 打开继电器（高电平） gpio.write(RELAY_PIN, 1, function(err) { if (err) { console.error("无法打开继电器:", err); return gpio.close(RELAY_PIN); } console.log("继电器已打开，5秒后关闭..."); // 5秒后关闭继电器 setTimeout(function() { gpio.write(RELAY_PIN, 0, function(err) { if (err) { console.error("无法关闭继电器:", err); return gpio.close(RELAY_PIN); } console.log("继电器已关闭"); // 关闭引脚 gpio.close(RELAY_PIN, function(err) { if (err) console.error("关闭引脚时出错:", err); else console.log("操作完成"); }); }); }, 5000); }); });