在上一章《我的第一个物联网应用 2》中，我们完成了 Ruff SDK 的安装，开发环境已经准备就绪，这一章我们的目标是：
- 新建一个 Ruff 项目，熟悉项目结构
- 以继电器为例学会添加连接外设，并控制外设
下面有请这一期的主角入场。
- Ruff 开发板：
继电器
继电器的作用
为了方便理解后面的内容，这里先简单科普一下继电器的工作原理，如果你已经知道继电器的作用可以跳过这段内容。 什么是继电器？继电器是一种通过某种信号变化来自动控制电路开关的电子设备。 上图是最简单的继电器模型图，输出电路有三个端口:常闭、常开和公共端，默认情况下常闭端和公共端是连通的，控制端根据输入的电信号能控制摆动条向下或向上摆，从而控制公共端和常闭端或者常开端连通。例如下图就是一个基于电磁信号来实现的继电器: 大家回忆一下中学物理课中的电磁感应原理，当线圈通电后，线圈环绕的铁芯会产生磁力，在磁力的吸引作用下铁片和常闭端断开、和常开端联通；当线圈断电，铁芯磁力消失，铁片在弹簧拉力的作用下和常闭端联通。 如果我们用开发板控制继电器来控制风扇，那么电路连接情况可以如下图：
创建项目
思路理清楚了，下面我们终于可以写代码了，开干吧！创建一个目录：MyLotApp。进入项目目录。执行命令：rap init
{
"name": "MyLotApp",
"version": "0.1.0",
"description": "My first Lot App",
"author": "dalimao",
"main": "src/index.js",
"ruff": {
"boards": {
"ruff-mbd-v1": "^4.2.0",
"*": "*"
},
"dependencies": {}
}
}
'use strict';
$.ready(function (error) {
if (error) {
console.log(error);
return;
}
$('#led-r').turnOn();
});
$.end(function () {
$('#led-r').turnOff();
});
启动开发版
用 USB 连接线给 Ruff 开发板 ，开发板随即启动。开发版启动后会启动一个名字以 Ruff 开头的 WI-FI 热点，例如 Ruff0021332 。让开发机（你的电脑）连上这个 WI-FI 热点，然后就可以把代码部署到开发板上了。部署程序
打开终端，进入工程目录，输入命令：rap deploy -s
添加继电器
关掉开发板电源，WIFI 切回正常使用的 WIFI。先来熟悉下 rap device add 这个命令，这个命令是用来添加外设的， 后面的参数是逻辑上的设备 ID，你可以自行定义，只要保证和其他设备 ID 不重复就行了。 rap device add relay
控制继电器
现在我们可以写程序来控制继电器了，怎么控制？这里我们要学会去Ruff 官网查看每个设备驱动提供的 API 和用法。到 Ruff 的软件仓库： https://rap.ruff.io/搜索： 你可以直接搜索 Module ID，你也可以搜索设备名称。搜索之后结果页面会出现模块的信息：
进入驱动页面可以看到设备模块对应的驱动的用法：
通过 ID，索引设备对象，这里的 ID 就是我们添加设备的时候自己定义的ID，我们定义的 ID 是"relay"，所以我们可以这样来打开继电器（使公共端和常开端连通）：
$('#relay').turnOn(function () {
// 打开继电器成功的回调函数
console.log('turn on');
});
'use strict';
$.ready(function (error) {
if (error) {
console.log(error);
return;
}
$('#relay').turnOn(function () {
// 打开继电器成功的回调函数
console.log('turn on');
});
});
$.end(function () {
$('#relay').turnOff(function () {
// 关闭继电器成功的回调函数
console.log('turn off');
});
});
