智能插座

来自Jack's Lab
(版本间的差异)
跳转到: 导航, 搜索
(创建设备)
(用户的所有插座)
第227行: 第227行:
  
 
<source lang=bash>
 
<source lang=bash>
$ cat user-dev-list
+
$ cat user-dev-list  
 
GET /v2/node/downnodes HTTP/1.1
 
GET /v2/node/downnodes HTTP/1.1
 
Accept: */ *
 
Accept: */ *
nodid: jiankemeng@gmail.co
+
nodid: comcat@icamgo.com00
token: 8412F7A4870744127266E7C289EB5A3E36A94D391C9DBC1367B72ABC2F099551
+
token: EE9B1A53F2F2EAF355DF9B772F7DBC3849896A38A7A081D480FF504E5AFDD54F
 
Content-Length: 0
 
Content-Length: 0
 
Content-Type: text/html
 
Content-Type: text/html
 
Connection: close
 
Connection: close
 +
 
#---------------------------------------------------
 
#---------------------------------------------------
 
$ cat user-dev-list | nc cos.icamgo.com 999
 
$ cat user-dev-list | nc cos.icamgo.com 999
 
HTTP/1.0 200 OK
 
HTTP/1.0 200 OK
Date: Sun, 26 Apr 2015 17:09:33 GMT
+
Date: Thu, 30 Jul 2015 06:04:35 GMT
 
Server: HTTP::Server::PSGI
 
Server: HTTP::Server::PSGI
 
Content-Type: text/html; charset=utf-8
 
Content-Type: text/html; charset=utf-8
 
X-Catalyst: 5.90075
 
X-Catalyst: 5.90075
Content-Length: 46
+
Content-Length: 24
  
["E1D0275ED8FC0ACAMWI","77499F93A32683076NQ"]
+
["88F6D02F5246F1EE0YL"]
 
</source>
 
</source>
  

2015年7月30日 (四) 14:05的版本

目录

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   # 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页面),点插座,进入设置计划任务界面(定时设置)

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 中,用以完成和云端的接口认证















个人工具
名字空间

变换
操作
导航
工具箱