Ruff JS SDK

更新时间:2018-09-17 14:28:39

本文将以 Ruff 开发板为例进行介绍 Link Develop 设备接入,开始前请确保完成了测试设备创建

前期准备

硬件

  • Ruff 开发套件一套(使用了套件里自带的 KY-016 RGB LED 小灯模块)

  • Wifi 热点:建议使用手机热点,Ruff 开发板通过手机热点与 IoT 云端通信,IoT 设备不会消耗很多流量,请放心使用。

软件

软件版本检查:

node -v
rap -V

请确认高于或者等于以下版本:

image.png | left | 747x189

开发过程

一、新建项目

新建目录,执行:

mkdir ruff-linkdevelop-rgblight
cd ruff-linkdevelop-rgblight
rap init

image.png | left | 747x394

添加 RBG 模块

rap device add KY-016

安装 aliyun-iot-device-sdk :

rap install --save aliyun-iot-device-sdk

aliyun-iot-device-sdk 文档:https://rap.ruff.io/raps/aliyun-iot-device-sdk

二、硬件接线

执行:

rap layout --visual

浏览器访问 http://localhost:<端口号> 查看接线图进行接线,并点击右上角的 Save 按钮保存。

image.png | left | 747x245

image.png | left | 747x548

三、设备端编码

使用编辑器打开项目 src 目录下的 index.js 文件,将代码替换成(注意要将 替换成前一步创建 的设备激活凭证):

'use strict';

var aliyunIot = require('aliyun-iot-device-sdk');

// 设备连接到云端
var device = aliyunIot.device({
  productKey: '<productKey>',
  deviceName: '<deviceName>',
  deviceSecret: '<deviceSecret>'
});

// 连接成功
device.on('connect', function() {
  console.log('connect successfully!');
  // 点亮
  $('#KY-016').setRGB(0xffffff);
  // 上报属性
  device.postProps({
    LightSwitch: 1,
    RGBColor: {
      Red: 255,
      Green: 255,
      Blue: 255
    }
  });
});

// ruff 初始化完毕
$.ready(function(error) {
  if (error) {
    console.log(error);
    return;
  }
  // 监听云端下行消息
  device.serve('property/set', function(params) {
    console.log('receive params:', params);
    var LightSwitch = params.LightSwitch;
    // 开灯
    if (LightSwitch === 1) {
      $('#KY-016').setRGB(0xffffff);
    }
    // 关灯
    if (LightSwitch === 0) {
      $('#KY-016').setRGB(0x000000);
    }
    // 调色
    var RGBColor = params.RGBColor;
    if (RGBColor) {
      var hexArr = [RGBColor.Red, RGBColor.Green, RGBColor.Blue].map(function(
        x
      ) {
        x = parseInt(x).toString(16);
        return x.length === 1 ? '0' + x : x;
      });
      var color = Number('0x' + hexArr.join(''));
      $('#KY-016').setRGB(color);
    }
    // 上报属性
    device.postProps(params);
  });
});

$.end(function() {
  console.log('disconnect');
  // 断开连接
  device.end();
});

五、运行和调试

将 Ruff 开发板上电开机,约 60 秒后将电脑连接到 SSID 为 Ruff+SN序列号(打印在 Ruff 开发板的标签上)的热点。

image.png | left | 230x213.72307692307692

首先通过执行 rap wifi 命令给 Ruff 开发版本配网,建议直接使用手机热点的 SSID 和密码,本案例中 IoT 开发板和云端的上下行通信只需要很小的流量,请放心使用

image.png | left | 690x202

在手机热点程序中可以看到 Ruff 开发板已经连接到热点:

image.png | left | 632x904

执行 rap log 启动日志查看程序:

image.png | left | 550x102

看到 Connection established 说明日志程序启动成功了。

新开一个终端,进入项目目录,执行 rap deploy -s 部署和运行代码:

image.png | left | 560x349.2134831460674

将电脑切换回路由器 Wifib比较稳定比较稳定。

点击设备列表里的设备“调试”链接,进入设备调试。

在页面下方的调试功能里选择“RGB调色(RGBColor)”,方法选为“设置”。

将下方 JSON 编辑器的内容替换成:

{"RGBColor":{"Red":255,"Blue":255,"Green":0}}

image.png | left | 747x274

然后点击“发送指令”按钮,我们发现,Ruff 上的 RGB 小灯模块的颜色变成了紫色,说明数据下发成功。

image.png | left | 747x560

同时在实时日志查看工具中,我们发现了设备也成功将新的 RGB 色值上报到云端,说明数据上行成功。

results matching ""

    No results matching ""