Cloud Of Smart Home
目录 |
1 概述
专为智能家居而生的物联云
服务于各类爱好智能家居的中小厂商、宅男宅女,他们爱动手、爱思考、对隐私和家居安全敏感
- 家居环境:
- Living Room
- Basement
- Bathroom
- Bedroom
- Den
- Dining Room
- Downstairs
- Entryway
- Family Room
- Hallway
- Kids Room
- Kitchen
- Master Bedroom
- Office
- Upstairs
1.1 HOME
远期规划
一个 Home 下可有多个设备 (device) 和多个家庭成员 (member)
Home 用一行描述,当前状态用一个 JSON 结构,包含所有member,controller,sensor 的状态,写在 stat 域里
家里新加的传感器、控制器、成员,可在APP里直接选择用 Home 的 UUID push 数据和状态,在参数里,写上name,type,数据等,云端首先遍历下级node列表,识别是否已有同名的设备,没有则为其创建新 node,并加到 node 列表里
家只关心,成员、控制器和传感器的状态,因此都写在 stat 域里即可。各下级node更新状态时要记得更新其在上级node之stat 域中的数据值
name, type, up_nodes, down_nodes, state, uuid, meta:{} meta: { mac:"aa:bb:cc:dd", ip:"123.11.1.1", activate:1, }
1.2 Device
设备是传感器 (sensor) 和 控制器 (controller) 统称。客厅大灯是一个设备,当然他只是一个控制器,因其主要响应用户的控制行为。客厅的温湿度检测也是一个设备,实际他是一个传感器,因其主要负责收集数据。贴于门窗上的门磁也是一个传感器设备。
传感器的值、控制器的状态都写在 state 域里,方便设备 check 以实现远程控制。每次push 的数据或状态则写在 datapoints 表里,带时间戳,方便呈现和日志检查
同时带有多个感应和多个控制的设备,也用一行描述,当前状态用一个 JSON 结构,写在 state 域里
设备新加的传感器、控制器,可在APP里直接选择用 Device 的 UUID push 数据和状态,在参数里,写上name,type,数据等,云端首先遍历下级node列表,识别是否已有同名的设备,没有则为其创建新 node,并加到 node 列表里
name, type, up_nodes, down_nodes, state, uuid, auth:{}, meta:{}, trigger:{} meta: { product: "camgo", activate: 1, rom: { version:"1.0.2", latest_version: "1.0.5", url: "/v2/roms/camgo.1.0.5.bin" }, mac: "XXXXXXXXXXXX" } auth:{"pubkey":"XOIO1234", "algo":"xx", "seed":"12345" } trigger: { wexin:{root:wx_user1, users:[wx_user1, wx_user2...]}, "166745":{msg:"家里大门开了", wexin:{root:wx_user1, users:[wx_user1, wx_user2...]}}, "139225":{msg:"客厅阳台门开了", weixin:{root:wx_user1, users:[wx_user2, wx_user3...]}} } state: { value: 55 }
1.3 Member
远期规划
对于一个家庭成员追踪设备,则各人智能手机为感知端(用户可选择是否定时上传 GPS/GSM 数据),加一些虚拟控制器,比如 weibo 推发器
stat 描述有 member 的坐标、体重、心率、运动量等等数据。如新买一血氧的设备,想要关联到 member,可用member的 UUID 生成 Token 来 push 数据,在参数里,写上name,type,数据等。云端会首先向 datapoints 记录一条记录,然后取 member 行(位于 Node 表)的 stat,解析后,将新数据域加入。
微信可以抽象为控制器;微博也可以抽象为控制器
手表/手环的消息提醒,振动提醒等也可以抽象为控制器
name, type, up_nodes, down_nodes, state, meta:{email, password, weixin, weibo, mobile, imsi}, uuid, pub_key state:{ coords:{lat:123, lng:234}, cell:{mcc: 460, mnc: 0, lac: 123, cid: 456} }
1.4 Trigger
每次 push 一个 state,云端检查一下相关的触发器,条件满足则执行相应的动作
注意:作为一个安全的云的必要设计,改控制器状态由家庭设备或家庭成员的手机完成,加密过后的数据,云端无法解读,因为加密在家庭设备端用私钥完成,云端无法解密,也就无法更改控制器状态
一个 Trigger 描述为:
trigger: { "default":{msg:"默认消息", wexin:{root:wx_user1, users:[wx_user1, wx_user2...]}, alarm: 1}, "166745":{msg:"家里大门开了"}, "139225":{msg:"私房们开了", weixin:{root:wx_user2, users:[wx_user3]}, alarm: 1}, }
trigger: { "fun":{cond:"x>1 && y>3", action:[{weixin:{}},{controller:""}]} }
2 框架
首先在 Web UI 下创建 Home,生成密钥对(界面自动生成一对,也可本机开源工具生成,然后将公钥填入Web UI,此为社交需求,可授权云端解密给家庭信任的用户,也可不上传公钥,这样云端永远无法知道家庭的状态)
云端只存储家庭成员加密过的控制器状态、传感器值(可加密可不加密)和家庭成员定义的任务事件(触发器,外网相关,比如发微博,发微信,发邮件,发短信等。改控制器状态由家庭设备或家庭成员手机完成),加密过后的数据,云端无法解读,因为加密在家庭设备端完成,云端无法解密,也就无法更改控制器状态
家庭私钥只有用户自己保存,私钥不在公开的网络上传输,云端也不存储。没有私钥就不能产生加密的状态值,控制器也就无法改变状态
控制器设备只要每 1s 去取一下云端的控制器状态值,回来解密,检查是否需要响应家庭成员的要求
---
设备、感知端、控制端 之间的关系为松耦合,即:一个设备可以只有一个感知端(只作数据呈现),或者只有一个控制端(只接受控制指令);一个感知端可用于多个设备,一个控制端也可为多个设备所用
简单如一个体重称,可作为只有一个传感器的设备
一个家庭灯光设备,可以有多个环境光强传感器,声控传感器(亦可作为其他设备的输入,比如窗帘控制设备),甚至手势传感器,控制器则对应各房间灯的开关
3 Open API
3.1 Activate
激活就是告诉云端:生产的设备已经联网并能正常工作了
- CamGo 的设计:(X1)
- 方案一:
每个设备都有一个唯一的串号 SN,写在二维码里
扫描二维码,APP会获取 SN,APP自动生成一个密钥对,用私钥将 时间戳和SN 加密后,作为调用 Activate API 的一个参数,另一个参数是生成的公钥 x-key
- 方案二 (实际使用方案):
设备的串号 SN、KEY 和 MAC 写在 eeprom 里
update state 时,用 SN + KEY 生成动态 token,云端检查 token 验证合法身份
用户关注公众号绑定看门狗后(扫描二维码或手工关注后绑定),视为激活,此过程可从 weixin agent 调用 Activate 接口
{"weixin":"userid"} 云端收到后,首先解析设备node_row 的meta->activated域,为1视为激活,再解析 trigger 域, 有 weixin->root 则视为激活过,此时添加的 weixin 用户,置于 weixin->user 列表里
---
- mini 的设计是这样:(M1)
- 方案一:
启动 APP,APP自动断开原WiFi的连接,搜索 miniCamGo 的AP,自动连接(内置密码),最好能做到将用户手机里存的AP直接配置给mini
配好后,APP自动生成一个密钥对,发给 mini,mini 收到后,保存,向用户返回 SN,APP用此生成一个微信二维码,供用户向家人分享
APP 断开和 mini 的连接,用私钥将时间戳和SN 加密后,作为调用 Activate API 的一个参数 Token,另一个参数是生成的公钥 x-key
- 方案二:
用户启动 APP,APP自动断开原WiFi的连接,搜索 miniCamGo 的AP,自动连接(内置密码,可以设计为无密码),将 AP 的 SSID 和密码配给 miniCamgo
miniCamgo 能通过 wifi 第一次访问激活接口,就视为激活
{"activate":1}
---
首次调用activate接口的,拥有设备的最高权限,用户设置一个分享码(不设系统默认生成)
随后扫描的,需输入分享码,才能拥有这个设备的使用权(APP 如检测到其和拥有者使用相同的 AP 热点,可不用输入分享码)
激活时以路由的MAC地址为关键字,创建HOME且与SN关联;以用户手机的imsi为关键字,创建USER且与SN关联
/v2/node/activate
# cat post-activate1 POST /v2/node/activate HTTP/1.1 Accept: */ * nodid: BFEB5E8E2BD9A795222 token: 15F7E14203AD318B0AB05514A6BD5B072830A076267C66E2X Content-Length: 19 Content-Type: text/html Connection: close {"weixin":"comcat"} # cat post-activate2 POST /v2/node/activate HTTP/1.1 Accept: */ * nodid: BFEB5E8E2BD9A795222 token: 15F7E14203AD318B0AB05514A6BD5B072830A076267C66E2X Content-Length: 17 Content-Type: text/html Connection: close {"weixin":"gaga"} # cat post-activate3 POST /v2/node/activate HTTP/1.1 Accept: */ * nodid: BFEB5E8E2BD9A795222 token: 15F7E14203AD318B0AB05514A6BD5B072830A076267C66E2X Content-Length: 14 Content-Type: text/html Connection: close {"activate":1} # cat get-activate GET /v2/node/activate HTTP/1.1 Accept: */ * nodid: BFEB5E8E2BD9A795222 token: 15F7E14203AD318B0AB05514A6BD5B072830A076267C66E2X Content-Length: 0 Content-Type: text/html Connection: close # cat post-deactivate POST /v2/node/activate HTTP/1.1 Accept: */ * nodid: BFEB5E8E2BD9A795222 token: 15F7E14203AD318B0AB05514A6BD5B072830A076267C66E2X Content-Length: 14 Content-Type: text/html Connection: close {"activate":0}
3.2 Node State
/v2/node/state
Input:
{"value":123} {"value":{"x": 12, "y": 12, "z": 12, "k": 22, "l": 33}, "deliver_to_device": 0} {"coords":{"lat":123, "lng":234}, "cell":{"mcc": 460, "mnc": 0, "lac": 123, "cid": 456}} {"living_room":{"timestamp":"", "illuminance":10, "temperature":20, "humidity": 18}}
# cat get-state GET /v2/node/state HTTP/1.1 Accept: */ * x-key: daxuexeprs nodid: BFEB5E8E2BD9A795222 token: 15F7E14203AD318B0AB05514A6BD5B072830A076267C66E2X Content-Length: 0 Content-Type: text/html Connection: close # cat post-msg POST /v2/node/state HTTP/1.1 Accept: */ * x-key: daxuexeprs nodid: BFEB5E8E2BD9A795222 token: 15F7E14203AD318B0AB05514A6BD5B072830A076267C66E2X Content-Length: 16 Content-Type: text/html Connection: close {"value":139225}
3.3 Node Beacon
/v2/node/beacon
3.4 Node Trigger
/v2/node/trigger
add new trigger: {"value":12356,"msg":"door opened"} {"value":12356,"msg":"door opened","weixin":"comcat"} update trigger: {"value":12356,"msg":"doorxx opened","weixin":"gaga"} {"value":12356,"weixin":"gaoxiaoduo"} user update trigger: {"alarm":{"all":1,"unknown":0}} {"alarm":{"all":1}} {"alarm":{"unknown":0}}
3.5 Node CMD
/v2/node/cmd
meta: { "cmd":{"开庭院灯":{"state":{"value":1} } } meta: { "cmd":{"拉警报":{"state":{"ch2":1} } } } meta: { "cmd":{"升晾衣架":{"state":{"value":"231080FD020043E2", "meta":"0,4,425,64"} } } } meta: { "cmd":{"vo":{"ctrl":17 } } }
POST:
{ "cmd":"关庭院灯", "action":{"state":{"ch1":0}} } { "nodid":"XXXXXXXXXX", "cmd":"关庭院灯", "action":{"state":{"ch1":0}} }
写入 meta 域,仅仅是个结构描述,不改变设备云端状态。用户在微信文本输入或者语音输入对应的命令字时,命令关键字匹配,进而取得 "cmd":{} 结构中对应的元数据,解析后,写入相应的位置 state/meta->ctrl
GET:
返回整个 { "cmd":{"开庭院灯":{"state":{"value":3} } } } JSON 结构,用户设置时,选择性呈现给用户,这个域默认不可编辑(可开启编辑),可特定生成
3.6 ROM Update
/v2/node/rom/version /v2/node/rom/update?version=xxx
3.7 Manufacture
/v2/nodes
{"type":"device", "state":"{}", "uuid":"", "auth":{"pubkey":"XOIO1234", "algo":"xx", "seed":"12345" }, "meta":"", "trig":"{}"}
4 具体产品
5 数据结构
5.1 Action Sets
id, timestamp, action, processed action: { msg: 客厅阳台门开了, weixin: [u1, u2, u3 ...] }
5.2 Node
HOME, Device, Member 统一编号,皆可抽象为 Node (节点)
每个 Node 都有唯一的 UUID,用来与云端交互
每个 Node 带有 id, name, type, stat, up_node, down_node, uuid, ext1, ext2
Home 类型 为 0x10
Member 类型为 0x20
Sensor 类型为 0x40
Controller 类型为 0x80
Device 类型为 0xC0
6 性能测试
6.1 http_load
官网:http://www.acme.com/software/http_load/
$ http_load -rate 5 -seconds 10 http://t.tt 49 fetches, 2 max parallel, 289884 bytes, in 10.0148 seconds 5916 mean bytes/connection 4.89274 fetches/sec, 28945.5 bytes/sec msecs/connect: 28.8932 mean, 44.243 max, 24.488 min msecs/first-response: 63.5362 mean, 81.624 max, 57.803 min HTTP response codes: code 200 -- 49
6.2 ab
- ab - Apache HTTP server benchmarking tool
$ sudo apt-get install apache2-utils $ ab -c50 -n3000 -H "nodid: BFEB5E8E2BD" -H "token: 15F7E14203AD318B0AB05514" http://icamgo.com:998/v2/node/state Server Software: HTTP::Server::PSGI Server Hostname: icamgo.com Server Port: 998 Document Path: /v2/node/state Document Length: 53 bytes Concurrency Level: 50 Time taken for tests: 29.820 seconds Complete requests: 3000 Failed requests: 0 Write errors: 0 Total transferred: 654000 bytes HTML transferred: 159000 bytes Requests per second: 100.60 [#/sec] (mean) Time per request: 497.000 [ms] (mean) Time per request: 9.940 [ms] (mean, across all concurrent requests) Transfer rate: 21.42 [Kbytes/sec] received Connection Times (ms) min mean[+/-sd] median max Connect: 4 210 112.3 255 405 Processing: 20 284 39.8 288 418 Waiting: 20 283 39.6 287 418 Total: 80 493 116.3 524 749 Percentage of the requests served within a certain time (ms) 50% 524 66% 556 75% 576 80% 588 90% 625 95% 651 98% 678 99% 702 100% 749 (longest request) $ ab -c50 -n3000 -p deactivate -H "nodid: BFEB5E8E2BD" -H "token: 15F7E14203AD318B0AB05514" http://icamgo.com:998/v2/node/activate Benchmarking icamgo.com (be patient) ...... Finished 3000 requests Server Software: HTTP::Server::PSGI Server Hostname: icamgo.com Server Port: 998 Document Path: /v2/node/activate Document Length: 18 bytes Concurrency Level: 50 Time taken for tests: 31.158 seconds Complete requests: 3000 Failed requests: 0 Write errors: 0 Total transferred: 549000 bytes Total POSTed: 738000 HTML transferred: 54000 bytes Requests per second: 96.28 [#/sec] (mean) Time per request: 519.304 [ms] (mean) Time per request: 10.386 [ms] (mean, across all concurrent requests) Transfer rate: 17.21 [Kbytes/sec] received 23.13 kb/s sent 40.34 kb/s total Connection Times (ms) min mean[+/-sd] median max Connect: 4 188 121.3 253 406 Processing: 26 327 72.9 299 457 Waiting: 25 327 72.9 298 456 Total: 109 516 72.2 523 733 Percentage of the requests served within a certain time (ms) 50% 523 66% 552 75% 568 80% 578 90% 600 95% 623 98% 655 99% 680 100% 733 (longest request)
7 Reference
- 趋势:
- RESTful的CoAP协议: http://segmentfault.com/a/1190000002511350
- CoAP Spec: http://coap.technology/spec.html https://tools.ietf.org/html/rfc7252#section-3
- 一步步搭建物联网系统: http://ebook.designiot.cn/#restful的coap协议
- CoAP 已有实现: http://coap.technology/impls.html
- http://covertness.me/2015/07/26/%E7%89%A9%E8%81%94%E7%BD%91%E7%9A%84RESTful%E5%8D%8F%E8%AE%AE%E2%80%94%E2%80%94CoAP/
- CoAP 协议及开源实现: http://blog.csdn.net/tulun/article/details/8869241
- CoAP 格式详解: http://network.chinabyte.com/333/13351333.shtml
- 物联网协议Thread http://ju.outofmemory.cn/entry/110572
- 参考:
- https://electricimp.com
- https://www.particle.io
- https://www.aylanetworks.com/platform/platform-components
- http://www.sense-iot.com/api-reference/triggers/
- http://www.blynk.cc/
- 基础:
- Comparison of Erlang Web Frameworks: https://github.com/ChicagoBoss/ChicagoBoss/wiki/Comparison-of-Erlang-Web-Frameworks
- Catalyst quickstart: http://blogs.perl.org/users/j0e/
- ResetSet: https://metacpan.org/pod/DBIx::Class::ResultSet
- web 压力测试工具:http://blog.jobbole.com/22294/
- 部署:
- FastCGI、ModPerl、PHP、普通CGI、SSI性能实测对比 http://www.20cn.net/ns/wz/soft/data/20040225014342.htm
- perl + fastcgi + nginx搭建 http://www.ttlsa.com/nginx/perl-fastcgi-nginx/