智能插座

来自Jack's Lab
2015年7月30日 (四) 16:17Comcat (讨论 | 贡献)的版本

跳转到： 导航, 搜索

目录

1 概述

UUID: 字符串，19个字符，唯一编号，对应一个插座

KEY: 字符串，8个字符，注意保护，用于生成每次通信的 Token

MAC: 6字节，12个字符，MAC地址


云端入口： 

http://cos.icamgo.com:998



2 创建设备

API: 

 /v2/node

参数： 

 {"type":"P1"}

type:P1 对应智能插座


示例： 

$ cat create-plug 
POST /v2/node HTTP/1.1
Accept: */ *
Content-Length: 13
Content-Type: text/html
Connection: close

{"type":"P1"}
#---------------------------------------------------
$ cat create-plug | nc cos.icamgo.com 998
HTTP/1.0 200 OK
Date: Thu, 30 Jul 2015 01:43:39 GMT
Server: HTTP::Server::PSGI
Content-Type: text/html; charset=utf-8
X-Catalyst: 5.90075
Content-Length: 61

{"id":1106,"uuid":"88F6D02F5246F1EE0YL","pubkey":"1H8BKJ30"}



3 APP 与云通信

3.1 注册验证

APP 第一次运行提示用户注册，输入 email 和 password，调用：


API： 

 /v2/node

参数： 

{"email": "EMAIL", "password": "PASSWORD"}

返回 uuid (整个平台的唯一识别码): 

{"uuid": "xxxxxxxxxxxxxxxxxx"}


例子： 

$ cat user-signup
POST /v2/node HTTP/1.1
Accept: */ *
Content-Length: 52
Content-Type: text/html
Connection: close

{"email":"comcat@icamgo.com","password":"12341234"}
#---------------------------------------------------
$ cat user-signup | nc cos.icamgo.com 998
HTTP/1.0 200 OK
Date: Sun, 26 Apr 2015 02:42:26 GMT
Content-Type: text/html; charset=utf-8
X-Catalyst: 5.90075
Content-Length: 32

{"uuid":"comcat@icamgo.com00"}


用户 nodid 的生成算法：用户 email 地址作为 nodid，19位，不够补0，多了截掉。如：jiankemeng@gmail.com，nodid 为：jiankemeng@gmail.co

注册成功后，APP 加密 email 和 password 并存入本地，下次启动APP，首先检查本地，如有缓存，直接进入 APP，无需再输入 email 和 password



3.2 Token 生成

用户注册无需 Token，但后面的激活、控制等操作，就需要在 HTTP 的 header 里加入 Token 了

3.2.1 PHP 实现 

define("UUID", "comcat@icamgo.com00");     # 用户用 email 注册后，生成的 nodid
define("PKEY", "12341234");                 # 用户密码

function gen_token()
{
    static $ts = 0;
    $tmp = time();
    if ($tmp > $ts) {
        $ts = $tmp;
    } else {
        $ts += 1;
    }

    $iv = '12345678';
    $ctx = sprintf("%s%08X", UUID, $ts);

    $td = mcrypt_module_open(MCRYPT_BLOWFISH,'','cbc','');

    mcrypt_generic_init($td, PKEY, $iv);
    $encrypted = mcrypt_generic($td, $ctx);
    mcrypt_generic_deinit($td);

    $token = unpack("H*", $encrypted);
    return $token[1];
}
用法示例： 
    $token = gen_token();
    $con = curl_init('http://cos.icamgo.com:998/v2/node/activate');
    $body = '{"uuid":' . $uuid . '"}';
    $header = array(
        "Accept: */ *",
        "nodid: " . NODID,
        "token: " . $token,
        "Content-Type: text/html",
        "Content-Length: " . strlen($body),
        "Connection: close"
    );
    curl_setopt($con, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($con, CURLOPT_HTTPHEADER, $header);
    curl_setopt($con, CURLOPT_POST, 1);
    curl_setopt($con, CURLOPT_POSTFIELDS, $body);
    curl_setopt($con, CURLOPT_TIMEOUT, 6);

    $ret = curl_exec($con);



3.3 激活

用户关联（添加）插座，视为激活插座

一个用户可能有多个插座，把插座的 UUID 生成为条形码或者二维码，添加插座时，建议实现为：直接在 APP 里扫码添加。

APP 扫描二维码后，解析出 UUID ，作为调用如下 cloud api 的参数


API： 

 /v2/node/activate

参数： 

 {"uuid":"xxxxxxxxxxxxxxxxxxx"}


例子： 

POST /v2/node/activate HTTP/1.1
Accept: */ *
nodid: comcat@icamgo.com00
token: EE9B1A53F2F2EAF355DF9B772F7DBC3849896A38A7A081D480FF504E5AFDD54F
Content-Length: 30
Content-Type: text/html
Connection: close

{"uuid":"88F6D02F5246F1EE0YL"}
#---------------------------------------------------
$ cat user-activate-dev | nc cos.icamgo.com 998
HTTP/1.0 200 OK
Date: Thu, 30 Jul 2015 05:52:24 GMT
Server: HTTP::Server::PSGI
Content-Type: text/html; charset=utf-8
X-Catalyst: 5.90075
Content-Length: 25

User add device success!



3.4 用户的所有插座

APP 获取当前用户名下的所有插座的 UUID （设备唯一串号）：

API： 

 /v2/node/downnodes

参数： 

 无


例子: 

$ cat user-dev-list 
GET /v2/node/downnodes HTTP/1.1
Accept: */ *
nodid: comcat@icamgo.com00
token: EE9B1A53F2F2EAF355DF9B772F7DBC3849896A38A7A081D480FF504E5AFDD54F
Content-Length: 0
Content-Type: text/html
Connection: close

#---------------------------------------------------
$ cat user-dev-list | nc cos.icamgo.com 999
HTTP/1.0 200 OK
Date: Thu, 30 Jul 2015 06:04:35 GMT
Server: HTTP::Server::PSGI
Content-Type: text/html; charset=utf-8
X-Catalyst: 5.90075
Content-Length: 24

["88F6D02F5246F1EE0YL"]



3.5 控制

API: 

 /v2/node/state


例子：

APP 改变插座状态： 
$ cat user-ctrl-dev 
POST /v2/node/state HTTP/1.1
Accept: */ *
nodid: comcat@icamgo.com00
token: EE9B1A53F2F2EAF355DF9B772F7DBC3849896A38A7A081D480FF504E5AFDD54F
Content-Length: 42
Content-Type: text/html
Connection: close
 
{"uuid":"88F6D02F5246F1EE0YL","value":55}
#---------------------------------------------------
$ cat user-ctrl-dev | nc cos.icamgo.com 998
HTTP/1.0 200 OK
Date: Thu, 30 Jul 2015 06:11:21 GMT
Server: HTTP::Server::PSGI
Content-Type: text/html; charset=utf-8
X-Catalyst: 5.90075
Content-Length: 16

Pushed success!


APP 获取插座状态： 
$ cat user-check-dev 
GET /v2/node/state HTTP/1.1
Accept: */ *
nodid: comcat@icamgo.com00
token: EE9B1A53F2F2EAF355DF9B772F7DBC3849896A38A7A081D480FF504E5AFDD54F
Content-Length: 30
Content-Type: text/html
Connection: close

{"uuid":"88F6D02F5246F1EE0YL"}
#---------------------------------------------------
$ cat user-check-dev | nc cos.icamgo.com 998
HTTP/1.0 200 OK
Date: Thu, 30 Jul 2015 06:16:51 GMT
Server: HTTP::Server::PSGI
Content-Type: text/html; charset=utf-8
X-Catalyst: 5.90075
Content-Length: 47

{"timestamp":"2015-07-30T14:11:21","value":55}



3.6 计划任务

API: 

 /v2/node/task

参数： 

{"uuid":"xxxxxxxxxxxx","timer":"xxxxxxxx"}



4 模块与云通信

4.1 概述

模块固件从 flash 中读出 UUID 和 KEY，UUID + 当前时间戳用 KEY 加密(AES) 运算后生成的串作为 Token

云端验证 UUID 和 Token



4.2 检查

1. Polling 方案

API: 

 /v2/node/state


模块 1s GET 一次，取回的数据为一个 JSON 结构，解析得到 value (on/off, 55/99)，与本地状态不一致，就改变自己的状态、

APP 通过写 (POST) 这个值，来完成远程控制

APP 也需要定时 (2s ?) GET 一下，以防其他用户改变该值导致插座状态改变而与另一个用户APP状态不一致


2. TCP 长链接方案



4.3 心跳 

 /v2/node/beacon



5 微信公众号

5.1 扫描配置WiFi

用户手机和插座在同一无线路由下，直接使用微信 airkiss 为插座配置上无线路由的SSID和密码



5.2 注册验证

用户扫一扫带参二维码即完成注册且关联插座的过程



5.3 控制

微信菜单“控制”，系统自动呈现出当前用户关联的控制端设备（一个动态HTML页面），插座自动呈现为带当前状态的切换按钮



5.4 计划任务

微信菜单“控制”，系统自动呈现出当前用户关联的控制端设备（一个动态HTML页面），点插座，进入设置计划任务界面（定时设置）

Task.jpg



5.5 用户管理

第一个扫二维码的是主帐号（管理员），后面扫的是普通用户

Users.jpg



6 批量制造

批量制造工具，批量生成 UUID, KEY, MAC 

$ ./nodid -t p1 -k -m -n 100 > P1000100
$ head -n 3 P1000100
DFA4E18D228D5771FKA     SGP8M5R2        18FE343A2480
206758F4D4042DC2AZP     OQUBTVFX        18FE3443A6E7
10C1D47FB8390A5DB5K     RGCB962D        18FE3481DF4E


通过专用接口批量导入云端： 

$ ./push_nodes -i P1000100 -o P1000100.pushed -t P1 -q
Re-type key:
Manufacture Smart Plug (P1) OK!


UUID, KEY, MAC 同时需要写入插座 WiFi 模块的 Flash 中，用以完成和云端的接口认证















来自“http://wiki.jackslab.org/index.php?title=%E6%99%BA%E8%83%BD%E6%8F%92%E5%BA%A7&oldid=4401”
个人工具
名字空间

变换
操作
导航
工具箱