智能硬件开发文档

Yumiot入门开辟教程

一、前期预备：

1.1 一个WiFi模块、一台电脑、一部手机（电脑也可以模仿手机）。

1.2 一款可以毗连外网的WiFi模块，即可以做办事器利用，也可以做客户端利用，市道上的绝大大都WiFi模块都可以适用。

1.3 会对WiFi有一个根基的开辟根本，例如C说话。按照分歧WiFi模块的开辟分歧，所用的开辟说话也分歧。

二、装备开辟流程

第一步：注册成为开辟者

第二步：挑选并注册装备id

第三步：开辟WiFi模块

2.1 设置WiFi模块毗连手事器

2.2 设置WiFi模块毗连手机端

2.3 按照yumiot交互法则，停止控制法式编写。

三、注册成为开辟者

3.1 进入http://yumiot.com官网，点击注册，挑选开辟者注册

3.2 按照提醒填写信息。

3.3 检察你的邮箱收件箱，点击激活链接完成注册

3.4 进入yumiot官网，点击登录——>开辟者，成功登录后点击左侧小我材料，检察开辟者ID

在装备治理—>装备注册界面，选摘要开辟的装备范例，以及装备数目，然后点击装备注册，完成新装备注册。（留意：每开辟一款新的装备都需要生产一个装备ID）

留意：自界说中文称号用于在用户手机端以及PC端显现，英文称号用于开辟者法式编写中利用。

例：下图中的自界说功用区，用户手机端将显现 智能灯 装备，具有两种状态，别离为开和关。

法式示例：

开灯：led=on

关灯：led=off

3.6 在全数装备、已开辟装备、未开辟装备中检察你的装备情况。其中，装备序列号是开辟者每次注册的装备的功用和状态号，用于分歧序列的版本控制。

四、常用语法说明

4.1 完整装备号（ID）、开辟者ID、装备范例、装备ID

例：1234561d000001

前6位是开辟者ID，7-8位是装备范例、9-14位是装备ID。完整装备号=开辟者ID+装备范例+装备ID。

如上例中，123456是开辟者ID，1d是装备范例、000001是装备ID，1234561d00001是完整装备号。

4.2 通讯交互语法

4.2.1 向办事器请求装备ID

yum{开辟者ID装备范例}$

yum{}是通讯标识，每次与办事器请求都需要利用这类格式。

\n是发送竣事符，每次通讯都需要利用。

例：yum{1234561d}$

4.2.2 办事器返回装备ID

格式：yumid{完整装备号}

例：yumid{1234561d000001}

留意：获得到装备ID后需要在WiFi模块中对(完整装备号)停止存储

4.2.3 向办事器发送控制号令

格式：yum{完整装备号}[功用1](状态1)

[ ]标识符中的是装备功用，在每个装备中最少需要有一个，不能为空。

( )标识符是装备状态，在每个功用中最少有一个状态，可以值为null，暗示该装备不履行任何状态。

例：有一款LED灯装备，有个开关功用，该功用有两种状态，别离是开on、关off。

开灯控制号令写法：yum{12345618000001}[LED](on)$

关灯控制号令写法：yum{12345618000001}[LED](off)$

4.2.4 办事器返回状态

格式：yum{完整装备号}[功用](状态)……

例：yum{12345618000001}[LED](on)

12345618000001该装备，要履行LED功用改变状态为on。

此号令就是点亮一个LED灯

4.2.5 接罢手机端毗连路由器号令

格式：yumssid：路由器账号

yumpass：路由器密码

例：yumssid：YUMIOT

yumpass：12345678

控制WiFi模块毗连名为YUMIOT的路由器，毗连密码是12345678

4.2.6 向手机端发送毗连状态

格式：yumget{session.状态}

session别离有两种状态

状态1：session.ok 暗示成功毗连路由器；

状态2：session.error 暗示毗连路由器失利。

例：yumget{seeion.ok}

4.2.7 向手机端返回完整装备号

格式：yum{装备ID}

例：yum{12345612000001}

4.2.8 手机端返回状态码

返回格式：yumget{seeion.状态}

session别离有两种状态

状态1：session.ok 暗示操纵成功；

状态2：session.error 暗示操纵失利。

例：yum{session.ok}

五、设置WiFi模块

5.1 配购置事器毗连

设置WiFi毗连yumiot远程办事器http://yumiot.com:8088(激烈倡议)大概利用47.95.228.49:8088（不保举利用）。

5.1.1 测试办事器毗连：

语法：yumtest{开辟者id装备范例}$

yumtest只是测试能否与办事器一般通讯，不能间接做一般装备开辟利用。

例如：开辟者id是：123456，预备开辟一款智能开关装备其装备范例是1d。装备范例可以在开辟者小我中心—>装备治理中检察。

将WiFi毗连到yumiot办事器 http://yumiot.com:8088

发送：yumtest{1234561d}$

这时WiFi模块将收到 yumid{1234561d000000}，其中yumid{}是信息头，12356是开辟者id，1d是装备范例，000000是测试装备id。

5.1.2 正式办事器毗连：

语法：yum{开辟者id装备范例}$

例如：开辟者id是：123456，预备开辟一款智能开关装备其装备范例是1d。装备范例可以在开辟者小我中心—>装备治理中检察。

将WiFi毗连到yumiot办事器 http://yumiot.com:8088

发送：yum{1234561d}$

这时WiFi模块将收到yumid{1234561d000001}，其中yumid{}是信息头，12356是开辟者id，1d是装备范例，000001是装备id。

5.1.3 保存装备ID

5.2 设置WiFi模块毗连手机端

开辟步调：手机毗连WiFi模块，并向WiFi模块发送路由器账号密码，WiFi模块接收路由器账号密码并毗连远程办事器。

5.2.1 手机毗连WiFi模块，并向WiFi模块发送路由器账号和密码WiFi模块将收到两个消息：

yumssid：路由器账号

yumpass：路由器密码

这时，WiFi模块将利用接收到的路由器账号和密码毗连路由器。成功毗连后向手机端发送毗连成功消息，否则发送毗连毛病消息。

发送消息格式：yumget{session.状态}

session别离有两种状态

状态1：session.ok 暗示成功毗连路由器；

状态2：session.error 暗示毗连路由器失利。

例：yumget{seeion.ok}

5.2.2 WiFi模块毗连路由器成功，停止yumiot办事器毗连。

具体毗连实例，参考第四章第1节配购置事器毗连。 办事器毗连成功后，将收到完整的装备ID号。

5.2.3 向手机端发送完整装备号。

发送格式：yum{装备ID}

例：yum{12345612000001}

手机端会返回一个状态码， 返回格式：yumget{seeion.状态}

session别离有两种状态

状态1：session.ok 暗示操纵成功；

状态2：session.error 暗示操纵失利。

例：yumget{session.ok}

5.3 按照yumiot交互法则，停止控制法式编写。完整实例流程

5.3.1 接罢手机端毗连路由器号令。

接收：yumssid:路由器账号

接收：yumpass:路由器密码

5.3.2 WiFi模块毗连路由器，并向手机端返回状态码

发送：yumget{session.ok}

5.3.3 保存路由器账号和密码，并毗连yumiot办事器

发送：yum{1234561d}$

5.3.4 保存完整装备号，并向手机端发送完整装备号。

接收：yumid{1234561d000001}

发送：yum{12345612000001}

接收：yumget{ session.ok }