wIoT - 轻松物联
Contents
基于NodeJS搭建的物联网系统,配合D1 MINI单片机,帮助你灰常快速实现物联~
[scode type=”green”]正式开发文档见这里[/scode]
wIoT for NodeJS
适用于NodeJS的wIoT服务器控制组件,轻松物联
先觉条件
- 拥有烧录好wIoT固件的D1 MINI单片机
- 一台或多台无线WiFi路由器2.4G/5G
- 局域网内拥有一台装有NodeJS的服务器或电脑 (NodeJS装法非常简单, 请自行Google或百度)
- 配置好npm
快速开始
单片机接入
- 使用MicroUSB, 5V, 或3V pin脚给单片机供电
- 用一根导线连接D0脚与3V3脚,持续一秒以上拔出,以重置单片机
- 用手机或电脑搜索它的WiFi热点,名称格式
wiot-xx:xx:xx:xx:xx:xx
- 连接上此热点,密码为
1234567890
- 用浏览器打开网址
http://192.168.0.1
,记录网页中的MAC地址,这将用于识别此单片机 - 配置你无线路由器的ssid(即wifi名称,注意不能有非ASCII字符,比如汉字)和密码
- 配置完成后热点将自动断开,单片机将连接到你的无线路由器
依赖安装
在你的项目文件夹下打开命令行,输入以下指令安装wiot:
1 | npm install wiot |
使用方法
在你的项目文件夹中新建一个app.js文件,输入以下内容:
1 | var wiot = require('wiot'); //引入wiot依赖包 |
开始执行
在项目文件夹中打开命令行,输入以下指令:
1 | node app.js |
预期结果
如果一切顺利,你现在应该会发现你的板载led在闪烁了
社区支持
也许你会觉得上述代码难以理解,这是正常的,由于delay功能在JS中难以实现。但是不用担心,这些问题将会由社区中的其它开发者帮你解决。
wIoT在实现基本的单片机控制同时,也提供了丰富的扩展功能。更神奇的是,任何人都可以在wIoT中编写自己的扩展并与全世界共享它们。在这里我们可以使用wIoT官方提供的led扩展轻松实现上例功能!
1 | var wiot = require('wiot'); //引入wiot依赖包 |
进阶设置
wiot.client
参数说明
名称 | 默认值 | 描述 |
---|---|---|
MAC | “” | 单片机的MAC地址 |
pin | {D1: 0, D2: 0, D3: 0, D4: 0, D5: 0, D6: 0, D7: 0, D8: 0} | pin脚的模式, 0为INPUT, 1为OUTPUT, 2为INPUT_PULLUP |
hint | true | 是否显示状态提示 |
debug | false | 是否开启debug模式 |
ip | “default” | 指定单片机IP, 请在长时间搜索不到IP时尝试此选项 |
port | 8848 | Client的TCP Socket通信端口,默认8848 |
ip_range | “192.168.0” | IP搜索字段,请在长时间搜索不到IP时尝试此选项 |
localIP | “127.0.0.1” | 本机IP |
OnlyHTTP | false | 是否仅使用HTTP模式连接单片机 |
errDelayTime | 2000 | 遇到网络错误时重试间隔时间(毫秒) |
okDelayTime | 30 | 收到网络请求后延时等待时间(毫秒) |
resetDelayTime | 4500 | 向单片机发送重置指令后多久不再发送新消息(毫秒) |
noTryMaxTime | 15000 | 经过此时间单片机仍未响应则重新发送消息(毫秒) |
IntervalTime | 2000 | 监听行为心跳间隔 |
MaxToReScanTime | 180000 | 经过此事件单片机无响应则从新扫描IP地址(毫秒) |
MinResearchTime | 5000 | 搜索IP经过一此轮询后间隔时间(毫秒) |
IpScanTimeout | 1 | IP扫描时的Ping检测超时时间(秒) |
pingTimeout | 2 | 心跳Ping检测的超时时间(秒) |
MaxTraceBackTimes | 8 | 判断连接状态所向前追溯的历史心跳个数 |
例如:
1 | var MyMCU = new wiot.client({ |
方法列表
.write(pin: wiot.pin/number, state: iot.state/number)
: 向指定pin口输出状态指令,状态可以是wiot.HIGH/wiot.LOW或PWM调制(0-255数字)wiot.read(pin: wiot.pin/number)
: 读取指定pin口状态,数字pin返回wiot.HIGH/wiot.LOW,模拟pin返回0-1024数值
事件绑定
.on(event, handler)
client事件列表
begin
开始于单片机正常交互disConnected
与单片机断开连接reConnected
与单片机恢复连接
1 | var MCU = new wiot.client({"MAC": "xx:xx:xx:xx:xx:xx"}); |
.pinOn(pin, event, handler)
pin事件列表
on
pin口电位从低到高off
pin口电位从高到低change
pin口电位变化
1 | var MCU = new wiot.client({"MAC": "xx:xx:xx:xx:xx:xx"}); |
API
wiot.begin()
: 单片机准备完成后开始执行
1 | MCU0 = new wiot.client({MAC: "xx:xx:xx:xx:xx:xx", pin: {D4: wiot.OUTPUT}}); |
wiot.loop()
: 循环执行的指令,适合于条件控制语句
1 | MCU0 = new wiot.client({MAC: "xx:xx:xx:xx:xx:xx", pin: {D4: wiot.OUTPUT}}); |
注册表
wiot.register.set(status1, status2, function)
: 向注册表中添加一条规则, status可以是值或函数,当status1==status2时会触发function。
注册表的设计是为了方便协调各扩展模块的使用,详见下文扩展模块。wiot.register.set(status, function)
: 你也可以传入两个函数,其中status的返回值是bool型,变为true时触发function
1 | var myLED = wiot.led(MyMCU, wiot.D4); |
传感器扩展模块
LED
wiot.led(MCU, pin)
: 声明一个led模块wiot.led.getStatus()
: 获取led状态wiot.led.set(status, time = 0, isSmooth = false)
: 设置led状态,起始状态,中间状态,最终状态,周期wiot.led.breath(period)
: 设置一个呼吸灯wiot.led.clear()
: 重置led
1 | MCU0 = new wiot.client({MAC: "xx:xx:xx:xx:xx:xx", pin: {D4: wiot.OUTPUT}}); |
PIR 红外人体传感器
wiot.pir(MCU, pin)
: 声明一个PIR模块wiot.pir.getStatus()
: 获取PIR状态,返回值wiot.HIGH(有人),wiot.LOW(无人)
事件触发器
wiot.pir.on(event, handler)
事件列表
detected
探测到人undetected
人体移动出探测范围change
状态改变,包括有人到无人和无人到有人
1 | MCU0 = new wiot.client({MAC: "xx:xx:xx:xx:xx:xx"}); |
IR 红外循迹/障碍传感器
wiot.ir(MCU, pin)
: 声明一个IR模块,pin可以是模拟或数字端口wiot.ir.getStatus()
: 获取IR状态,返回值wiot.HIGH(有障碍),wiot.LOW(无障碍),或者0-1024数值(限模拟端口)
事件触发器
wiot.ir.on(event, handler)
事件列表
detected
探测到障碍undetected
障碍消失change
状态改变
1 | MCU0 = new wiot.client({MAC: "xx:xx:xx:xx:xx:xx"}); |
lightSensor 光敏传感器
wiot.lightSensor(MCU, pin)
: 声明一个lightSensor模块, pin可以是模拟或数字端口wiot.lightSensor.getStatus()
: 获取lightSensor状态,返回值wiot.HIGH(有光),wiot.LOW(无光),或者0-1024数值(限模拟端口)
事件触发器
wiot.light.on(event, handler)
事件列表
light
由暗到明dark
由明到暗change
状态改变
1 | MCU0 = new wiot.client({MAC: "xx:xx:xx:xx:xx:xx"}); |
网络扩展模块
mail 邮件模块
使用本模块向指定邮箱发送邮件。自豪地引用Yimian API构建!
wiot.mail(to, from = "wIoT")
: 声明一个mail模块,参数收件地址,发件人名称wiot.mail.send(subject, body)
: 发送邮件,需传入主题,邮件内容
1 | var mail = wiot.mail("i@iotcat.me", "wIoT Test"); |
guguji 咕咕机模块
使用本模块向指定咕咕机发送消息。咕咕机是一款便携式私人打印机,详见官网。使用本模块需要在官网提前申请好自己的开发者ak, 详见这里。自豪地引用Yimian API构建!
wiot.guguji(ak, userID, memobirdID)
: 声明一个guguji模块,参数: 开发者ak, 用户id, 咕咕机idwiot.guguji.send(msg)
: 发送消息,需传入待发送的消息
1 | var gugu = wiot.guguji("9e55121803474371bfa25d20e554b31f", "832598", "b3ee06a8bd9b49e1"); |