前言

Ruff 是一个支持 JavaScript 开发应用的物联网操作系统，让物联网应用开发更简单高效。

Ruff 开发套件 是一个旨在帮助开发者快速学习使用 Ruff 的工具，并且通过 Ruff 开发套件可以快速建立产品原型。

本教程是针对 Ruff 开发套件 的使用教程，从10个外设配件起的应用开发再到驱动开发以及板卡开发，我们将从头开始一步步教大家如何使用 Ruff 开发套件。

现在就拿起手边的 Ruff 开发套件 开始学习如何开发物联网应用吧！

Ruff 开发准备

在学习之前，你需要：

完成 Ruff 开发板的网络设置、硬件连线，可以在起步走了解。
Ruff 应用开发步骤和模型，可以到这里。

Tips: 我们会对产品的硬件和软件做些改动和升级，这样可能会产生软硬件使用和本教程在某些细节上不符，请以最新软件和您购买的开发套件实际配置为准。

第一课 SOS 求救灯

我们的 Ruff 之旅从这节课正式开启！

谁将登场：
- 板载 LED 灯
- 大按键模块
你将学会：
- 按键输入控制 Ruff 的输出
- Ruff 中的延时函数
- 板载 LED 灯的使用

介绍

SOS 求救灯应用中：

按下按钮
板载 LED 灯发出 三短光三长光三短光 的 SOS 摩斯电码求救信号。

想了解摩斯电码,可以到这里。

元件

Ruff 开发板 ×1
大按键模块 ×1

外设添加

向项目中添加名为“button”的大按键模块，model 选择 CK002，驱动版本选择最新版。

代码

在编写代码之前需要完成 Ruff 开发板的设置连接、硬件连线。如果有疑问大家可以在这里了解。
想了解 Ruff 应用开发步骤和模型，可以到这里。

闪烁

首先我们解决：如何使板载 LED 灯闪烁。

检测板载 LED 灯当前是否点亮，
- 如果点亮，关闭 LED 灯；
- 如果关闭，点亮 LED 灯；

可以在这里进一步学习板载 LED 知识。

具体的闪烁实例代码如下：

//Led灯闪烁函数
function Blink() {
    if (!$('#led-r').isOn()) {
        $('#led-r').turnOn();
    }
    else {
        $('#led-r').turnOff();
    }
}

延时函数

在 LED 能够闪烁之后，我们再来尝试控制 LED 灯长短闪烁。

长短闪烁的区别在于，每次由亮变暗和由暗变亮的延时时间长度，即调用 Blink 函数的延时时间长度。
- 这里我们使用 setTimeout 函数实现延时，setTimeout 函数语法如下：
  - setTimeout (回调函数, 延时时间)
- setTimeout() 方法用于在指定的毫秒数后调用函数或计算表达式，setTimeout() 只执行表达式一次；

想了解更多有关 setTimeout 函数的内容，可以到这里。

发出摩斯电码

再来，我们解决如何发出摩斯电码 “S” 和 “O” 信号。

在摩斯电码表中，每一个英文字母由点和线的不同组合表示，我们可以通过 LED 的闪烁“拼写”出每个字母，通短闪烁和长闪烁表示点和线，比如：
- 字母 “S” 在摩斯码中用三个点表示，这里我们用三次短闪烁代替；
- 字母 “O” 在摩斯码中用三条线表示，这里我们用三次长闪烁代替；
- LED 灯的闪烁通过控制灯交替亮灭实现。
长短闪烁表示 “S” 和 “O” 字母实例代码如下：

//三个快闪烁来表示字母“S”
function performS() {
    $('#led-r').turnOn();//设置led模块亮
    setTimeout(Blink, 1000);//1000ms后led灭
    setTimeout(Blink, 2000);//2000ms后led亮
    setTimeout(Blink, 3000);//3000ms后led灭
    setTimeout(Blink, 4000);//4000ms后led亮
}
//三个慢闪烁来表示字母“O”
function performO() {
    $('#led-r').turnOn();
    setTimeout(Blink, 2000);
    setTimeout(Blink, 4000);
    setTimeout(Blink, 6000);
    setTimeout(Blink, 8000);
}

按键检测

有了发出摩斯电码的函数，接下来，我们可以使用 大按键 作为“开关”，控制 Ruff 发出摩斯电码。

大按键模块有两种事件，分别是 push 按下事件和 release 放开事件。
Ruff一直检测按键模块的 push 和 release 事件，一旦检测到信号，执行相对应的“行为”函数。
- 在这个应用中，需要向 push 行为函数中添加发出摩斯电码“S”和“O”的函数，并设置正确长度的延时函数：
  - 0s时，先执行发摩斯电码 ”S“ 函数;
  - 5s时，灭灯；
  - 6s时，执行发摩斯电码 ”O“ 函数;
  - 16s时，灭灯；
  - 17s时，执行送摩斯电码 ”S“ 函数；
  - 22s时，灭灯；

前往Ruff-大按键模块，可以进一步学习大按键模块的知识。

利用大按键控制发出 S.O.S 信号的具体实现如下：

//在‘button’按下时运行函数
$('#button').on('push', function () {
    performS(); 
    setTimeout(function () { $('#led-r').turnOff(); }, 5000);
    setTimeout(performO, 6000);
    setTimeout(function () { $('#led-r').turnOff(); }, 16000);
    setTimeout(performS, 17000);
    setTimeout(function () { $('#led-r').turnOff(); }, 22000);
});

最后，

将大按键控制函数放到 $.ready 事件下；
摩斯电码发出函数和闪烁函数放在后面。

大功告成！

快去自己动手实现吧！

完整代码

'use strict';

//Led灯闪烁函数
function Blink() {
    if (!$('#led-r').isOn()) {
        $('#led-r').turnOn();
    }
    else {
        $('#led-r').turnOff();
    }
}

//三个快闪烁来表示字母“S”
function performS() {
    $('#led-r').turnOn();//设置led模块亮
    setTimeout(Blink, 1000);//1000ms后led灭
    setTimeout(Blink, 2000);//2000ms后led亮
    setTimeout(Blink, 3000);//3000ms后led灭
    setTimeout(Blink, 4000);//4000ms后led亮
}

//三个快闪烁来表示字母“O”
function performO() {
    $('#led-r').turnOn();//设置led模块亮
    setTimeout(Blink, 2000);
    setTimeout(Blink, 4000);
    setTimeout(Blink, 6000);
    setTimeout(Blink, 8000);
}

$.ready(function (error) {
    if (error) {
        console.log(error);
        return;
    }

    //在‘button’按下时运行函数
    $('#button').on('push', function () {
        performS();
        setTimeout(function(){$('#led-r').turnOff();}, 5000);
        setTimeout(performO, 6000);
        setTimeout(function(){$('#led-r').turnOff();}, 16000);
        setTimeout(performS, 17000);
        setTimeout(function(){$('#led-r').turnOff();}, 22000);
    });
});

课后练习

按键抢答器

使用三个按键模块和两个板载LED灯。

如果按键 A 按下，板载蓝灯（led-b）亮；
按键 B 按下，板载红灯（led-r）亮；
按键 C 用于重置抢答器，C 键按下，两灯都灭；
按键 A 或 B 按下后，直到按下按键 C 重置抢答器，即使另一按键按下，两LED 灯也不会有变化。

Let's Ruff On !

[ Ruff 开发套件 ] Lesson 1 - SOS 求救灯

前言