Meet npm Pro: unlimited public & private packages + package-based permissions.Learn more »

rpi-sensor

0.4.1 • Public • Published

rpi-sensor

树莓派传感器合集

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

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


GPIO引脚图


安装方式

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

Install

npm i rpi-sensor

DownloadsWeekly Downloads

2

Version

0.4.1

License

none

Unpacked Size

83.2 kB

Total Files

19

Last publish

Collaborators

  • avatar