1、目录12第十二章 云端服务接口通信实验212.1 360iot Cloud云平台简介212.1.1360iot Cloud 云平台简介212.1.2360iot Cloud 特点312.1.3360iot Cloud 云平台功能312.1.4 预备知识412.2 360iot Cloud 云端平台API手册512.2.1用户注册512.2.2用户登陆612.2.3用户信息查询（JSON）812.2.4用户信息查询（HTML）1012.2.5用户节点设备列表（JSON）1212.2.6用户节点设备列表（HTML）1412.2.7节点设备绑定/更新1512.2.8节点设备删除1712.2.9心跳发
2、送（设备端）（HTML）1812.2.10心跳检测（App端）（HTML）1912.2.11节点设备通道数据读取（JSON）2012.2.12节点设备通道数据读取（HTML）2112.2.13节点设备通道数据发送2312.3 360iot Cloud云服务搭建实验教程2512.3.1云端安装2512.3.2 基本配置3012.3.3 Memcahe 安装3512.3.4 访问云端web页面3712.3.5云端使用教程3812.4 MYSQL数据库4512.4.1 MySQL介绍4512.4.2 MySQL的特点与作用4512.4.3 连接MYSQL4612.4.4 基本操作命令4612.4.5
3、 数据库使用4712.5 云端后台服务程序框架教程5112.5.1 PHP简介5112.5.2 thinkPHP框架简介5212.5.3 实验部分5812.6 360iot产品级云端服务接口通信实验6212.6.1 平台概述6212.6.2 平台使用快速指南6412.6.3 平台API文档71第十二章 云端服务接口通信实验12.1360iot Cloud云平台简介12.1.1360iot Cloud 云平台简介360IOT CLOUD云平台是开放接口的通用物联网云平台，集成了当前最先进的国际云计算技术、智能传感技术、物联网通信技术和移动互联技术等，对云计算、大数据及信息管理、数据中心进行整合，
4、提供各种传感器数据的接入、存储和应用服务。用户可通过云平台直接进行设备物联网化，教师和学生可以在360IOT CLOUD云平台上进行物联网工程实践、云计算教学实验演示、云计算基础研究和应用研究等科研活动，可使学生在实训中掌握M2M接入、移动互联APP编程等关键技术，培养学生进行扩展性和创新性开放，满足了高校培养物联网人才的需求。360IOT CLOUD云平台拓扑结构如下图所示：基于360IOT CLOUD云平台，设备通过WiFi直接接入云端，实现数据的实时传输与记录；通过手机等设备实现创意无限的远程物联网应用；通过手机APP，在世界的任何地方都可以实现实时观测数据并远程直接控制设备；通过云端，
5、可以看到历史数据曲线等。12.1.2360iot Cloud 特点 平台支持数值型、图像型、GPS型等多种数据的接入。 平台提供完备的API文档和代码示例，实现传感器数据的集中管理和远程监控。 平台独有设计的高并发接入服务器和云存储方案。 平台可以同时完成海量的传感器数据接入和存储任务，确保数据安全保存在互联网上。 先进的鉴权系统和安全机制，确保数据共享范围。 平台融合各种传感器，用户可设定模式与策略实现订制化的物联网应用。12.1.3360iot Cloud 云平台功能360IOT CLOUD云平台提供的功能主要包括：账户管理、设备管理、设备模板管理、设备数据管理、数据类型管理和子系统管理等
6、。360IOT CLOUD云平台除提供以上功能外，还提供电子地图、二维码登陆和开放平台接口等功能。 在线电子地图 二维码登陆 平台接口（Open API）12.1.4 预备知识了解云端前端开发需要HTML+CSS+JavaScript相关知识了解接口开发需要PHP+Mysql的相关知识12.2 360iot Cloud 云端平台API手册本节列出一套完整的操作可以执行与操作360iot CloudAPI。包括产品，设备，钥匙，触发器，数据流和数据。每个资源都有特定的属性。 注意：如果不指定格式/媒体类型 JSON或XML 与 TONYLABS IOT API进行交互时，默认的格式接受/返回JS
7、ON。12.2.1用户注册用户注册时，App 开发者需要注意密码需要通过 MD5 或 SHA 先将密码加密后，再发送，性别（Gender）字段为字符串类型，可接受如 Male|Female 或 男|女，亦可 0|1 区分，生日日期格式为 YYYY-mm-ddParametersMethodPUTBase URLhttp:/121.40.153.169API Endpoint/api/user/register.jsonHeadersPUT http:/121.40.153.169/api/user/register.jsonversion:1.0.0,username:,email:,pass
8、wd:MD5(),phone:,idcard:,gender:Male|Female,birthday:YYYY-mm-ddReturn JSON“status”:”20012.2.2用户登陆ParametersMethodPOSTBase URLhttp:/121.40.153.169API Endpoint/api/user/login.jsonHeadersPOST http:/121.40.153.169/api/user/login.json123456version:1.0.0,username:,email:,passwd:Return JSONuid:47,username:U
9、SERNAME,password:PASSWRD,email:EMAIL,email_verified:0,uuid:null,role:citizen,city:null,country:null,website:null,idcard:IDCARD_NUMBER,gender:MALE,phone:PHONE_NUMBER,birthday:1999-08-14,last_login_time:null,last_login_ip:null,login_count:0,lock:0,cTime:2014-10-24 10:58:58,mTime:null12.2.3用户信息查询（JSON）
10、ParametersMethodGETBase URLhttp:/121.40.153.169API Endpoint/api/user/UID_HERE.jsonHeadersGEThttp:/121.40.153.169/api/user/UID_HERE.json123456version:1.0.0,username:,email:,passwd:Return JSONuid:47,username:USERNAME,password:PASSWRD,email:EMAIL,email_verified:0,uuid:null,role:citizen,city:null,countr
11、y:null,website:null,idcard:IDCARD_NUMBER,gender:MALE,phone:PHONE_NUMBER,birthday:1999-08-14,last_login_time:null,last_login_ip:null,login_count:0,lock:0,cTime:2014-10-24 10:58:58,mTime:null12.2.4用户信息查询（HTML）ParametersMethodGETBase URLhttp:/121.40.153.169API Endpoint/api/user_loginHeadersGEThttp:/121
12、.40.153.169/api/user_login?version=1.0.0&username=xxx&email=xxx&passwd=md5(xxx)NO BODYReturn JSONuid:47,username:USERNAME,password:PASSWRD,email:EMAIL,email_verified:0,uuid:null,role:citizen,city:null,country:null,website:null,idcard:IDCARD_NUMBER,gender:MALE,phone:PHONE_NUMBER,birthday:1999-08-14,l
13、ast_login_time:null,last_login_ip:null,login_count:0,lock:0,cTime:2014-10-24 10:58:58,mTime:null12.2.5用户节点设备列表（JSON）ParametersMethodGETBase URLhttp:/121.40.153.169API Endpoint/api/node/UID_HERE.jsonHeadersGET http:/121.40.153.169/api/node/UID_HERE.json123456version:1.0.0,username:,email:,passwd:Retu
14、rn JSONuid:5,user_device_name:My Living Room Power Jack,user_device_mac:843A4B0DAA20,user_device_lock:1,device_id:12,device_machine_name:5_channels_jack,device_description:Manufactory Warning Message for User,uid:5,user_device_name:My Bedroom Power Jack,user_device_mac:843A4B0DAA11,user_device_lock:
15、0,device_id:12,device_machine_name:5_channels_jack,device_description:Manufactory Warning Message for User12.2.6用户节点设备列表（HTML）ParametersMethodGETBase URLhttp:/121.40.153.169API Endpoint/api/node_listHeadersGEThttp:/121.40.153.169/api/node_list?username=xxx&email=xxx&passwd=md5(xxx)1NO BODYReturn JSO
16、Nuid:5,user_device_name:My Living Room Power Jack,user_device_mac:843A4B0DAA20,user_device_lock:1,device_id:12,device_machine_name:5_channels_jack,device_description:Manufactory Warning Message for User,uid:5,user_device_name:My Bedroom Power Jack,user_device_mac:843A4B0DAA11,user_device_lock:0,devi
17、ce_id:12,device_machine_name:5_channels_jack,device_description:Manufactory Warning Message for User12.2.7节点设备绑定/更新当用户完成注册并登录后，用户通过手机 App 与智能设备通过 SmartConfig 配对，配对成功后，智能设备把该设备的 UUID、 machine_name 和 MAC 地址传回 App, 并通过该节点设备绑定/更新API登记。已登记绑定的设备，如需更新用户自定义设备名称，或锁定该设备，仍使用此方法更新，程序将自动判断。ParametersMethodPOSTBa
18、se URLhttp:/121.40.153.169API Endpoint/api/node/MAC_ADDRESS_HERE.jsonHeadersPOST http:/121.40.153.169/api/node/MAC_ADDRESS_HERE.json12345678version:1.0.0,uid:USER_ID_FROM_USER_LOGIN_STEP,uuid:MANUFACTORY_OR_DEVELOPER_UUID,machine_name:MACHINE_NAME_FROM_MCU,name:USER_DEFINED_DEVICE_NAME,lock:1|0Retur
19、n JSON1234status: 200,msg:Node updated.1234status: 200,msg:Node bound.12.2.8节点设备删除用户通过App删除节点设备，App 只需要将用户设备中的 UUID、MAC 地址和当前用户ID 通过 DELETE 请求即可。ParametersMethodDELETEBase URLhttp:/121.40.153.169API Endpoint/api/node/MAC_ADDRESS_HERE.jsonHeadersDELETE http:/121.40.153.169/api/channel/MAC_ADDRESS_HER
20、E.json12345version :1.0.0,username :xxxx,passwd :md5(xxxxxx)Return JSON“status”:”20012.2.9心跳发送（设备端）（HTML）ParametersMethodPUTBase URLhttp:/121.40.153.169API Endpoint/api/node_heartbeatHeadersPUThttp:/121.40.153.169/api/node_heartbeat?version=1.0.0&mac=xxxxxxxx1version:1.0.0, mac:AABBCCDDEEFFReturn JS
21、ON12.2.10心跳检测（App端）（HTML）ParametersMethodGETBase URLhttp:/121.40.153.169API Endpoint/api/node_heartbeatHeadersGEThttp:/121.40.153.169/api/node_heartbeat?version=1.0.0&mac=xxxxxxxxNo bodyReturn JSON123status:20012.2.11节点设备通道数据读取（JSON）ParametersMethodGETBase URLhttp:/121.40.153.169API Endpoint/api/cha
22、nnel/MAC_ADDRESS_HERE.jsonHeadersGET http:/121.40.153.169/api/channel/MAC_ADDRESS_HERE.json12345version:1.0.0,uuid:xxx-xxxx-xxxxx-xxxxxx,device_alt:1415196715 (Optional)Return JSONdevice_machine_name:xx_xxx_xx,device_description:xxxxxxxx,device_alt:1415196715,channel:channel1:channel_value:100,chann
23、el_alt:1414206622,channel2:channel_value:200,channel_alt:1414206622,12.2.12节点设备通道数据读取（HTML）ParametersMethodGETBase URLhttp:/121.40.153.169API Endpoint/api/channel_dataHeadersGEThttp:/121.40.153.169/api/channel_data?version=1.0.0&mac=xxxxxxxx&uuid=xxxx-xxxx-xxx-xxxx&device_alt=1415196715(Optional)1NO
24、 BODYReturn JSONdevice_machine_name:xxx_xxx_xx,device_description:xxxxxxxxxx,device_alt:1415196715,channel:channel1:channel_value:100,channel_alt:1414206622,channel2:channel_value:200,channel_alt:1414206622,12.2.13节点设备通道数据发送ParametersMethodPUTBase URLhttp:/121.40.153.169API Endpoint/api/channel/MAC_
25、ADDRESS_HERE.jsonHeadersPUT http:/121.40.153.169/api/channel/MAC_ADDRESS_HERE.jsonversion :1.0.0,uuid :xxx-xxxx-xxx-xxxx-xxx,datastreams : channel :channel1,value :1,channel :channel2,value :2 12.3360iot Cloud云服务搭建实验教程12.3.1云端安装12.3.1.1环境安装说明安装Wampserver2.4整合软件包，软件包包含ApacheWebServer2.4.4 + PHP5.4.16
26、 + MySQL5.4.12运行环境，需要注意的是如果你的计算机中原先安装着Apache或者PHP解释器或者MySQL数据库的话，在安装WampServer之前最好先将它们卸载。因为程序安装完成之后要打开相应的端口，如果之前安装的这些程序没有卸载掉，端口仍然占用，会使本程序打开端口失败。且程序安装之前最好在命令提示符中输入 “netstat aon” 输入引号内的命令，不包含引号，netstat与减号之间有一空格，回车后查看Local Address一列有没有0.0.0.0:80的记录。如果有，记录下对应的PID，然后执行命令“tskill PID” 例如PID是2840，就输入 tskill
27、 2840。12.3.1.2、安装步骤步骤一：软件包括32位版本（X86）和64位版本（X64），根据当前安装的操作系统版本进行选择，如windows相片选择安装“Wampserver2.4-x86.exe”,出现下面的界面，其中显示了集成的软件版本步骤二：点击“Next”进入下面的窗口步骤三：继续“Next”得到下面窗口，可以改变安装目录，这里我选择了默认路径。步骤四：点击“Next”开始安装，安装接近尾声时会提示让你选择默认的浏览器，如果你不确定，点“打开”就可以了（“explorer.exe”）,如下图：步骤五：后续会让你输入一些PHP的邮件参数信息，这些保留默认的内容就可以了。一路点N
28、ext就可以完成基本的安装步骤了。这时就能在桌面上能看到程序的图标了，并且在任务栏的系统托盘中能找到WampServer的标志，左键单击图标出现下面窗口：安装过程中出现如下情况：先卸载Wampserver，安装Microsoft Visual C+ 2010 SP1 Redistributable Package，双击安装vcredist_x86.exe。完成后重新安装Wampserver2.4即可。安装完成后打开浏览器输入http:/localhost,显示如下画面说明环境安装完成12.3.2基本配置1、语言调整右键单击其右下角图标，出现下面窗体，软件默认为英文，根据个人习惯可调整为简体中文
29、面板。2、配置WampServer的www目录WampServer安装完成之后，默认的www目录在程序安装所在文件夹的www子文件夹下，如果需要修改这个目录可以点击右下角图标，打开httpd.conf配置文件，如下图查找到DocumentRoot c:/wamp/www项，修改双引号中的内容为要修改的目录即可，这里我默认这个目录。3、 wamp默认本机IP访问，其它局域网访问配置httpd.conf，找到如下位置Allow from 允许的访问地址改为Allow from all（允许所有）如下图4、 配置URL模式为REWRITE模式httpd.conf配置文件中加载了mod_rewrite
30、.so模块，如下图AllowOverride None 将None改为 All，如下图5、复制iot目录下的所有文件到www目录下，如下图6、导入数据库，点击左下角图标选择phpmyadmin，打开数据库管理页面，默认用户名root密码为空，如下图执行导入，选择导入的数据库为www目录下的iot.sql文件，字符集选择utf-8，如下图12.3.3 Memcahe 安装Memcache 是一个高性能的分布式内存对象缓存系统，用于动态Web应用以减轻数据库负载。它通过在内存中缓存数据和对象来减少读取数据库的次数，从而提高动态、数据库驱动网站的速度。1. memcached安装文件libgcc_s
31、_sjlj-1.dll memcached.exe pthreadGC2.dll php_memcache.dll mingwm10.dll2. 安装步骤（注意要在管理员权限下安装）将memcache.exe，libgcc_s_sjili-1.dll,pthreadGC2.dll放到php安装目录将php_memcache.dll 拷贝到 php安装目录下的ext文件夹下,在php.ini文件最后面加上下面这句extension=php_memcache.dll可在C:WindowsSystem32目录下找到cmd.exe，右键以管理员权限执行，命令行下进入你的php目录，执行memcache
32、d -d install，安装成功无提示，若提示说安装失败或你已安装，则表示你没有在管理员权限下执行cmd.exe启动memcache,进入到php安装目录，执行memcached.exe -d start，开启memcache服务重启apache，之后就可以在php下使用memcached3. memcached常用命令memcached的基本命令(安装、卸载、启动、配置相关)：-p 监听的端口-l 连接的IP地址, 默认是本机-d start 启动memcached服务-d restart 重起memcached服务-d stop|shutdown 关闭正在运行的memcached服务-d
33、 install 安装memcached服务-d uninstall 卸载memcached服务-u 以的身份运行 (仅在以root运行的时候有效)-m 最大内存使用，单位MB。默认64MB-M 内存耗尽时返回错误，而不是删除项-c 最大同时连接数，默认是1024-f 块大小增长因子，默认是1.25-n 最小分配空间，key+value+flags默认是48 -h 显示帮助例如启动memcached -d start需要的memcached 的内存大于64m,应当这样启动memcached m 256m d start12.3.4访问云端web页面打开浏览器输入http:/localhost/
34、（建议使用Google Chrome浏览器）进入用户登录页面，显示如下图12.3.5云端使用教程12.3.5.1注册塔普云开发者在使用塔普云服务前，你需要通过http:/121.40.153.169 注册一个开发者账号。请完整填写你的注册信息。12.3.5.2创建第一个新设备打开设备列表，选择添加新设备，按提示填写设备信息红色框框是云端自动生成的串号，需要配合设备端的程序使用，作为设备端访问云端唯一标识。12.3.5.3编辑数据通道创建完设备后，在设备列表中可以看到新创建的设备点击红色框位置打开设备，页面右侧为设备信息，可以编辑修改设备页面右侧为通道编辑界面，可以创建新通道填写完通道相关属性后
35、，点击保存按钮保存后红色框中显示了，刚创建的通道列表，点击通道名称可以打开通道页面通过手机端，绑定设备后，通道状态呈现在通道页面中。（如何绑定设备详见API文档）页面中可以可以查看设备图表12.3.5.4用户信息查看在用户管理中选择用户列表，点击查看，可以查看到用户信息和注册的设备信息12.3.5.5资源下载使用手机扫描二维码，可以安装手机端演示app（仅限安卓手机）12.3.5.6帮助有任何问题或需要技术支持，欢迎随时与我们取得联系。电 话：021-54291156Email：support12.4 MYSQL数据库12.4.1 MySQL介绍 MySQL是一个精巧的SQL数据库管理系统，虽
36、然它不是开放源代码的产品，但在某些情况下你可以自由使用。由于它的强大功能、灵活性、丰富的应用编程接口（API）以及精巧的系统结构，受到了广大自由软件爱好者甚至是商业软件用户的青睐，特别是与Apache和PHP/PERL结合，为建立基于数据库的动态网站提供了强大动力。 12.4.2 MySQL的特点与作用MySQL是一个真正的多用户、多线程SQL数据库服务器。SQL（结构化查询语言）是世界上最流行的和标准化的数据库语言。MySQL是以一个客户机/服务器结构的实现，它由一个服务器守护程序mysqld和很多不同的客户程序和库组成。 SQL是一种标准化的语言，它使得存储、更新和存取信息更容易。例如，你
37、能用SQL语言为一个网站检索产品信息及存储顾客信息，同时MySQL也足够快和灵活以允许你存储记录文件和图像。 MySQL数据库的主要功能只在组织和管理很庞大或复杂的信息和基于WEB的库存查询请求不仅仅为客户提供信息，而且还可以为您自己使用数据库可以提供如下功能: 减少记录编档的时间 减小记录检索时间 灵活的查找序列 灵活的输出格式 多个用户同时访问记录 12.4.3连接MYSQL格式：mysql -h主机地址 -u用户名 p用户密码连接到本机上的MYSQL。首先在打开DOS窗口，然后进入目录 mysql/bin，再键入命令mysql -uroot -p，回车后提示你输密码，如果刚安装好MYSQ
38、L，超级用户root是没有密码的，故直接回车即可进入到MYSQL中了，MYSQL的提示符是：mysql12.4.4 基本操作命令 创建数据库mysql create database 数据库名称 创建表mysql create table 表名 (列的名字（id）类型（int（4）primary key(定义主键) auto_increment（描述 自增），）； 查看所有数据库mysql show databases ; 使用某个数据库mysql use 数据库名称； 查看所使用数据库下所有的表mysql show tables; 显示表的属性结构mysql desc 表名； 选择表中数据的
39、显示mysql select * from 表名 where id=?and name=？ or name=?;mysql select id,name from 表名order by 某一列的名称 desc(降序，asc为升序) 删除表中的数据mysql delete from table where id=？or name=? (and name=?); 删除表mysql drop table; 删除数据库mysql drop database;12.4.5 数据库使用数据文件位于网站根目录iot数据库结构如下：|tlabs_user 用户信息表（含终端用户和厂商用户）|tlabs_channel 厂商通道表|tlabs_value 终端用户通道数据表
