树莓派JavaScript物联网开发指南：从Node.js环境搭建到GPIO硬件控制

在树莓派上使用JavaScript：从环境搭建到GPIO控制

树莓派作为一款广受欢迎的单板计算机，凭借其小巧的体积和丰富的GPIO引脚，成为了嵌入式开发与物联网项目的首选平台。JavaScript凭借其异步非阻塞的特性以及庞大的生态系统，同样能够在树莓派上大放异彩。本文将详细介绍如何在树莓派上搭建JavaScript运行环境，并通过Node.js操作GPIO引脚，实现硬件控制。

硬件与软件准备

在开始之前，需要准备好以下硬件和软件环境：

• 树莓派主板（本文以树莓派4B为例，其他型号操作类似）
• Micro SD卡（已安装Raspberry Pi OS）
• LED灯、电阻（330Ω）、杜邦线、面包板
• SSH客户端或显示器键盘（用于登录树莓派）

安装Node.js运行环境

树莓派默认系统中不包含Node.js，需要通过包管理器或源码编译的方式安装。推荐使用NodeSource的二进制分发版，安装过程快速且稳定。

# 更新系统包索引
sudo apt update
sudo apt upgrade -y

# 下载并执行NodeSource安装脚本（安装Node.js 18.x LTS版本）
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

# 安装Node.js
sudo apt install -y nodejs

# 验证安装
node --version   # 输出类似 v18.20.0
npm --version    # 输出类似 10.7.0

安装完成后，Node.js和npm（Node包管理器）就已经准备就绪，可以开始编写控制硬件的JavaScript代码了。

GPIO控制库的选择与安装

在树莓派上操作GPIO引脚，最常用的JavaScript库是onoff。它提供了简洁的API来读写GPIO引脚的电平状态，并支持事件监听。另一个备选库是pigpio，它提供了更丰富的PWM和中断功能。本文以onoff为例进行讲解。

# 在项目目录中初始化npm项目
mkdir raspberry-pi-js
cd raspberry-pi-js
npm init -y

# 安装onoff库
npm install onoff

实战案例：控制LED灯闪烁

这是一个经典的入门示例，通过GPIO 17引脚（物理引脚11）连接LED，使用JavaScript控制LED以1秒的间隔交替亮灭。代码中调用Gpio构造函数创建输出引脚，并通过writeSync()方法设置电平，配合setInterval实现周期切换。

const { Gpio } = require('onoff');

// 使用GPIO 17引脚（物理引脚11）作为输出
const led = new Gpio(17, 'out');

let state = 0;  // 0表示低电平（LED灭），1表示高电平（LED亮）

// 每500毫秒切换一次LED状态
const interval = setInterval(() => {
  state = state === 0 ? 1 : 0;
  led.writeSync(state);
  console.log(`LED状态: ${state === 1 ? '亮' : '灭'}`);
}, 500);

// 10秒后停止闪烁并清理GPIO资源
setTimeout(() => {
  clearInterval(interval);
  led.writeSync(0);   // 关闭LED
  led.unexport();     // 释放GPIO引脚
  console.log('LED闪烁结束，GPIO已释放');
}, 10000);

运行上述代码需要root权限，因为GPIO操作涉及系统层级的设备访问。使用sudo执行脚本即可看到LED按预期闪烁。

sudo node led-blink.js

读取按键输入：检测外部触发信号

除了控制输出，读取外部输入信号也是常见的需求。下面的代码演示了如何将GPIO 18引脚配置为输入模式，并监听其电平变化。当按键按下时（引脚与GND导通，电平从高变低），控制台输出提示信息。

const { Gpio } = require('onoff');

// 使用GPIO 18引脚（物理引脚12）作为输入，并启用内部上拉电阻
const button = new Gpio(18, 'in', 'both', { pullUpDown: Gpio.PUD_UP });

console.log('请按下连接到GPIO 18的按键...');

// 监听电平变化事件
button.watch((err, value) => {
  if (err) {
    console.error('监听错误:', err);
    return;
  }
  // value为0表示按键按下（低电平），1表示松开（高电平）
  if (value === 0) {
    console.log('按键按下了！');
  } else {
    console.log('按键松开了！');
  }
});

// 程序退出时清理资源
process.on('SIGINT', () => {
  button.unexport();
  console.log('GPIO已释放，程序退出');
  process.exit();
});

运行此脚本时，同样需要使用sudo提升权限。当检测到按键动作后，程序会持续监听，直到用户按下Ctrl+C终止进程。

实战进阶：使用pigpio实现PWM调光

如果需要更精细的模拟控制，比如调节LED的亮度，可以使用pigpio库中的PWM功能。该库通过树莓派的硬件PWM模块实现高精度的脉宽调制，无需占用CPU资源。

# 在项目中安装pigpio库
npm install pigpio

const { Gpio } = require('pigpio');

// 使用GPIO 17引脚作为PWM输出，频率设置为1000Hz
const led = new Gpio(17, { mode: Gpio.OUTPUT });

let dutyCycle = 0;
let step = 5;  // 每次增加5个占空比单位

// 每隔20毫秒调整一次占空比，实现呼吸灯效果
const interval = setInterval(() => {
  dutyCycle += step;
  if (dutyCycle >= 255) {
    dutyCycle = 255;
    step = -5;   // 到达最大值后开始减小
  } else if (dutyCycle <= 0) {
    dutyCycle = 0;
    step = 5;    // 到达最小值后开始增大
  }
  led.pwmWrite(dutyCycle);  // 设置PWM占空比（0-255）
}, 20);

// 15秒后停止呼吸灯效果
setTimeout(() => {
  clearInterval(interval);
  led.pwmWrite(0);
  led.digitalWrite(0);
  console.log('呼吸灯结束');
  process.exit();
}, 15000);

PWM调光让LED呈现出呼吸般的渐变效果，这是纯数字电平切换无法实现的。运行代码时依然需要sudo权限。

读取DHT11温湿度传感器数据

传感器数据的读取是物联网项目中的核心环节。下面演示如何使用node-dht-sensor库读取DHT11温湿度传感器的数据。该库需要bcmlib支持，安装前需确保系统已安装相关依赖。

# 安装node-dht-sensor库
npm install node-dht-sensor

const sensor = require('node-dht-sensor');

// 初始化DHT11传感器，连接到GPIO 4引脚（物理引脚7）
const sensorType = 11;   // DHT11
const gpioPin = 4;

// 读取传感器数据
sensor.read(sensorType, gpioPin, (err, temperature, humidity) => {
  if (err) {
    console.error('传感器读取失败:', err);
    return;
  }
  console.log(`温度: ${temperature.toFixed(1)}°C`);
  console.log(`湿度: ${humidity.toFixed(1)}%`);
});

// 每5秒读取一次数据
setInterval(() => {
  sensor.read(sensorType, gpioPin, (err, temperature, humidity) => {
    if (!err) {
      console.log(`[${new Date().toLocaleTimeString()}] 温度: ${temperature.toFixed(1)}°C, 湿度: ${humidity.toFixed(1)}%`);
    }
  });
}, 5000);

DHT11的读取时序要求较高，JavaScript的事件循环机制能够很好地满足这种周期性数据采集的需求。该库在树莓派上运行稳定，适合环境监测类项目。

总结

在树莓派上使用JavaScript进行硬件开发，主要依赖Node.js的异步特性和丰富的npm生态。通过onoff、pigpio、node-dht-sensor等库，可以轻松实现数字输入输出、PWM模拟控制、传感器数据采集等常见功能。这种方式既保留了JavaScript的开发效率，又赋予了前端开发者操控硬件的能力，是物联网原型开发和小型自动化项目的理想选择。

树莓派JavaScriptNode.jsGPIO控制物联网开发