智能插座
目录 |
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: jiankemeng@gmail.co token: 8412F7A4870744127266E7C289EB5A3E36A94D391C9DBC1367B72ABC2F099551 Content-Length: 0 Content-Type: text/html Connection: close #--------------------------------------------------- $ cat user-dev-list | nc cos.icamgo.com 999 HTTP/1.0 200 OK Date: Sun, 26 Apr 2015 17:09:33 GMT Server: HTTP::Server::PSGI Content-Type: text/html; charset=utf-8 X-Catalyst: 5.90075 Content-Length: 46 ["E1D0275ED8FC0ACAMWI","77499F93A32683076NQ"]
3.5 控制
API:
/v2/node/state
例子:
- APP 改变插座状态:
$ cat user-ctrl-dev # HTTP 请求体 POST /v2/node/state HTTP/1.1 Accept: */ * nodid: jiankemeng@gmail.co token: 8412F7A4870744127266E7C289EB5A3ED64D5AD7DB2DE2561FC32BFB84C549CD Content-Length: 42 Content-Type: text/html Connection: close {"uuid":"E1D0275ED8FC0ACAMWI","value":55} $ cat user-ctrl-dev | nc cos.icamgo.com 998 HTTP/1.0 200 OK Date: Sun, 26 Apr 2015 11:44:07 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-state-uuid # HTTP 请求体 GET /v2/node/state HTTP/1.1 Accept: */ * nodid: jiankemeng@gmail.co token: 8412F7A4870744127266E7C289EB5A3ED64D5AD7DB2DE256C7E8E6647EE26A81 Content-Length: 31 Content-Type: text/html Connection: close {"uuid":"E1D0275ED8FC0ACAMWI"} $ cat user-check-dev-state-uuid | nc cos.icamgo.com 998 HTTP/1.0 200 OK Date: Sun, 26 Apr 2015 11:47:17 GMT Server: HTTP::Server::PSGI Content-Type: text/html; charset=utf-8 X-Catalyst: 5.90075 Content-Length: 47 {"timestamp":"2015-04-26T19:44:07","value":55}
3.6 计划任务
/v2/node/task
{"uuid":"xxxxxxxxxxxx","timer":"xxxxxxxx"}
4 模块与云通信
4.1 概述
模块固件从 flash 中读出 UUID 和 KEY,UUID + 当前时间戳用 KEY 加密(AES) 运算后生成的串作为 Token
云端验证 UUID 和 Token
4.2 检查
- 1. Polling 方案
/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页面),点插座,进入设置计划任务界面(定时设置)
5.5 用户管理
第一个扫二维码的是主帐号(管理员),后面扫的是普通用户
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 中,用以完成和云端的接口认证