rpi-sensor

树莓派传感器合集

注意：只能适合40PIN的树莓派,其余类型，需要自己手动修改lib/comm.js下的GPIO_MAPPING

API中声明传感器实例对象的所有no参数，全部使用GPIO的物理引脚编号（即按顺序数编号），非BCM编号、Pin编号，这样可以方便没有对应图的情况使用

---

---

安装方式

1、安装BCM2835(如果没有安装过)

$ wget https://raw.githubusercontent.com/zhou090221liang/rpi-sensor/master/Resource/bcm2835-1.58.tar.gz
$ tar -zxvf bcm2835-1.58.tar.gz
$ cd bcm2835-1.58
$ ./configure
$ make
$ sudo make check
$ sudo make install

2、安装依赖

$ sudo apt-get update
$ sudo apt-get install pigpio
$ sudo apt-get install ttf-wqy-zenhei
$ sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev

3、安装该模块

$ npm i rpi-sensor

4、重新编译各个支持你硬件及Node版本的固件

$ chmod +x node_modules/node-dht-sensor/check-lib.sh 
$ npm rebuild

---

已经实现的功能列表

1、DHT11/DHT22温湿度传感器 >= v0.1.0
    可以检测当前温度与湿度
2、触摸按键模块传感器 >= v0.2.0
    可以实时监控触摸按钮的按下与松开，并可以实现按钮的长按，短按
3、触摸按键模块传感器2 >= v0.3.0
    可以实时监控触摸按钮的长按，短按、双击
4、SSD1306显示屏 >= v0.4.0

---

Node版本支持

>=6.x

---

API

首先，需要声明对象

const sensor = require('rpi-sensor');

DHT11/DHT22 温湿度传感器

创建一个DHT11或DHT22传感器

new sensor.DHT11(no);
new sensor.DHT22(no);

示例：

const dht11 = new sensor.DHT11(7);

从传感器读取当前的温湿度数值

dht11.read();

该方法无需参数，返回值为JSON

参数名称	参数类型	参数说明
humidity	number	当前湿度百分比
temperature	number	当前温度（摄氏度°C）
isValid	bool	传感器返回的校验值和温湿度值是否匹配
errors	number	错误，目前返回0

返回值示例：

{
    humidity: 32, 
    temperature: 31, 
    isValid: true, 
    errors: 0 
}

触摸按键-目前测试通过的是TTP223，其余设备请自己测试

创建一个触摸按键传感器

new sensor.TOUCH_KEY(no [,setting]);

参数setting为一个JSON格式的配置项

参数名称	参数类型	参数说明
TYPE	enum	设备类型,可以有多个方式: UNLOCK_HIGHT:点动高电平输出（默认） LOCK_HIGHT:自锁高电平输出 UNLOCK_LOW:点动低电平输出 LOCK_LOW:自锁低电平输出
LONG_TOUCH_TIME	number	当持续按下长达500毫秒（默认值）后松开，设备默认为长按

示例：

const touchkey = new sensor.TOUCH_KEY(12, {
    TYPE: sensor.TOUCH_KEY_TYPE.UNLOCK_HIGHT,
    LONG_TOUCH_TIME: 300
});

监听按钮按下、松开状态

TOUCH_KEY.key.on('touch',callback)

以事件监听的方式，获取按钮按下、松开状态，callback返回一个JSON

参数名称	参数类型	参数说明
touch	bool	true代表按下状态；false代表松开状态
long	bool	当touch为松开状态时，该字段标示是否为长按后松开
time	number	当touch为松开状态时，该字段表示从按下到松开后的毫秒数

返回值示例：

{ 
    touch: false, 
    long: false, 
    time: 265 
}

触摸按键2-目前测试通过的是TTP223,稳定性一般,其余设备请自己测试

创建一个触摸按键传感器

new sensor.TOUCH_KEY2(no [,setting]);

参数setting为一个JSON格式的配置项

参数名称	参数类型	参数说明
TYPE	enum	设备类型,可以有2个方式: UNLOCK_HIGHT:点动高电平输出（默认） UNLOCK_LOW:点动低电平输出
LONG_TOUCH_TIME	number	当持续按下长达500毫秒（默认值）后松开，设备默认为长按
DOUBLE_TOUCH_TIME	number	当2次连续触摸时间少于200毫秒(默认值)，设备默认为双击

示例：

const touchkey = new sensor.TOUCH_KEY2(12, {
    TYPE: sensor.TOUCH_KEY_TYPE.UNLOCK_HIGHT,
    LONG_TOUCH_TIME: 500,
    DOUBLE_TOUCH_TIME: 200
});

监听按钮按下、松开状态

TOUCH_KEY.key.on('touch',callback)

以事件监听的方式，获取按钮按下、松开状态，callback返回一个JSON

参数名称	参数类型	参数说明
double	bool	true代表双击
long	bool	true代表长按

注意：double和long同时为false时，代表正常的短按

返回值示例：

{ 
    double: false, 
    long: false
}

SSD1306显示屏

创建一个SSD1306显示器传感器

new sensor.SSD1306(i2cNumber, address, width, height);

参数名称	参数类型	参数说明
i2cNumber	number	I2C总线编号，默认1
address	number	I2C总线地址，默认0x3C
width	number	显示屏宽像素，默认128
height	number	显示屏高像素，默认64

示例：

const ssd1306 = new sensor.SSD1306(1, 0x3C, 128, 64);

打开显示器（自发光显示器不会亮，必须有输出后才能亮起）

ssd1306.oled.turnOnDisplay();

关闭显示器

ssd1306.oled.turnOffDisplay();

清除显示器所有像素点

ssd1306.oled.clearDisplay();

在屏幕上显示文字（只能支持大小写英文、英文标点符号）

ssd1306.oled.setCursor(x, y);
ssd1306.oled.writeString(font, size,text,color,wrapping);

参数名称	参数类型	参数说明
x	number	需要输出文字的起始位置，x坐标值
y	number	需要输出文字的起始位置，y坐标值
font	object	请固定传ssd1306.font
size	number	文字大小缩放倍率
text	string	需要显示的文字
color	number	文字的颜色，对于单色显示器，请固定传1
wrapping	bool	是否自动换行(基于单词、空格)

在屏幕上显示汉字

//参数为Array数组,每个元素代表1行，汉字一行最多显示6个，最多3行
ssd1306.oled.writeChinese(text)

参数名称	参数类型	参数说明
text	string	需要输出文字

在屏幕上显示任意字符并自动换行滚动显示

ssd1306.oled.writeText(text [,scrollInterval])

参数名称	参数类型	参数说明
text	string	需要输出字符
scrollInterval	number	滚动间隔，默认1500毫秒

更多API，请参考I2C标准 https://www.npmjs.com/package/oled-i2c-bus