OneNET-Mini开发板实验例程操作手册---v1.0

OneNET-MINI开发板实验例程操作手册目录版本信息...........................................................................................................................................31本文档编写目标...........................................................................................................................42OneNET平台接入流程介绍........................................................................................................42.1接入流程概述....................................................................................................................42.2资源创建示例....................................................................................................................43实验例程操作说明......................................................................................................................143.1ESP8266+EDPLED状态采集及控制实验.....................................................................143.2ESP8266+HTTP上传温湿度数据实验...........................................................................183.3ESP8266+Modbus协议接入和数据上传实验................................................................223.4ESP8266+MQTT协议发布订阅实验.............................................................................264其它实验例程..............................................................................................................................32版本信息日期修订人版本更新内容2016.8.5周家绪、续芳V1.01.初始版本1本文档编写目标本文档是针对OneNETMINI开发板的例程而编写（内容涵盖HTTP，EDP，MQTT，MODBUS四种协议），文档主要阐述每个实验例子的实验原理及实验步骤等。2OneNET平台接入流程介绍2.1接入流程概述OneNET的设备接入过程大致分为注册用户、产品创建、设备接入、新增数据流、上传并查看数据及新增应用等几个步骤。在接入设备之前必须先在OneNET平台（）注册用户账户，注册登录成功后，可以在用户账户下创建产品，目前平台提供有公开协议产品和私有协议产品两种产品类型，在创建一个公开协议产品时，平台提供HTTP，EDP，MQTT，MODBUS四种协议的选择，MINI开发板例程也主要是针对这四种协议进行编写。在产品下创建设备，设备下新增数据流。设备端编写终端接入代码，主要完成数据采集、协议封装、数据上传等工作，终端数据上传成功后，平台在相应数据流下会生成随时间推移的数据点。最后，为了更直观的呈现数据的变化情况，用户可以运用应用孵化器自定义个性化应用并发布。2.2资源创建示例用户注册在接入OneNET之前，需在平台网站注册用户账户，登陆网址：，显示如下界面：图2-1用户注册入口点击注册入口，注册用户账户：图0-2用户注册填写用户名、用户密码、有效邮箱地址等，点击获取验证码，打开邮箱邮件查看验证码，并完成注册。用户账户注册成功后，点击登录入口进行登录：图0-3用户登录新建产品用户登录OneNET平台后，进入OneNET主界面，如下图：图0-4用户登录OneNET平台点击“开发者中心”入口，进入产品列表界面：图0-5公开协议产品列表点击“创建产品”进行新产品的创建，如下图：图0-6产品创建填写产品名称、选择产品行业、产品类别、设备接入方式及设备接入协议等产品信息，完成产品创建。图0-7产品创建成功添加设备为新建产品“test_edp”添加一个设备，打开产品管理页面，如下图所示：图0-8设备管理模块点击页面中的“设备管理”菜单，进入设备管理页面，如下图所示：图0-9设备管理页面点击“立即接入设备”，弹出接入设备对话框，如下图所示：图0-10接入设备输入设备名称和鉴权信息，选择设备的数据保密性，点击“接入设备”完成产品的设备添加，如下图所示：图0-11设备数据流入口为新建的设备添加一条数据流，点击“数据流管理”进入设备的数据展示页面，如下图所示：图0-12添加数据流点击“添加数据流”，弹出添加数据流对话框，如下图所示：图0-13数据流信息输入数据流ID、单位名称及单位符号，点击“添加”完成一条数据流的创建，在一个设备下面可以连续添加多个数据流，如下图，我们添加了sys_time、bin_data两个数据流：图0-14数据流添加成功除了添加数据流操作以外，用户还可以对已有的数据流进行修改、删除操作。添加应用用户可以为设备下的数据流创建相关的应用，发布对用户数据的直观展示页面，目前在OneNET应用孵化器中提供了曲线图、柱状图、表盘、物体位置、图片和开关等应用，用户添加应用进行数据展示的前提是用户数据已经上传至平台。以已有设备和数据流为例，为设备test_edp下的systime数据流（设备上电后的时钟信息）添加一个曲线图的应用。在产品管理页面点击“应用管理”菜单，进入应用管理页面，如下图所示：图0-15应用管理模块点击“创建应用”，进入应用编辑器编辑页面，如下图所示：图0-16新应用创建将想要添加的应用拖进编辑区域，比如：我们选择曲线图。点击选择该应用，在编辑框的右边编辑应用属性设置应用相关的参数，包括和应用相关联的设备、数据流、应用标题、刷新数据间隔、X坐标点数目等，编辑完成后点击“下一步”，进入应用信息完善页面，如下图所示：图0-17应用信息完善补充应用的名称、应用状态、应用描述等相关的应用辅助信息。点击“保存应用”，应用添加完毕，进入该应用的详情页面，如下图所示：图0-18应用详情页除了添加应用操作以外，用户还可以对已有的应用进行修改、删除操作。3实验例程操作说明3.1ESP8266+EDPLED状态采集及控制实验参考资料和说明：（1）MINI开发板硬件原理图V1.0.pdf（2）《设备终端接入协议2-EDP.docx》（3）《ESP8266AT命令手册》（4）开发环境KEILV4.6.0，文件编码采用utf-8（5）使用ST-LINK烧写固件实验原理：通过采集PB6/PB7/PB8/PB9四个LED指示灯的IO控制引脚的电平值，利用EDP协议将采集的数据上传至OneNET平台，通过OneNET平台的“下发命令”功能实现对LED控制（点亮和熄灭）。实验步骤：如果没有EDP设备，请先在OneNET平台创建一个EDP设备，具体步骤参考《2.2资源创建示例》，本例中所用到的设备参数如下：图3-1设备信息1.硬件连接连接uart调试串口，波特率115200，8N1。连接ST-LINK编程器。连接ESP8266WIFI模组。接入电源，烧写程序前先上电。图3-2开发板连接2.打开实验工程，目录：实验代码\OneNET_Mini_Demo_ESP8266_EDP_Led\Project\OneNETdemo.uvproj图3-3打开KEIL工程3.修改代码，主要是修改ESP8266的AP配置和设备相关信息。如下图，在esp8266.h头文件中修改CWJAP宏定义为读者使用的路由器ssid名和密码，#defineCWJAPAT+CWJAP=\your_ssid\,\pwd\\r\n,源代码的ssid为OneNET，密码为12345678。修改设备ID及设备APIKEY信息，在esp8266.h头文件中修改宏定义DEVICEID为读者在平台创建的设备对应的设备ID，修改宏定义APKEY为读者在平台创建的产品对应的apikey。#defineDEVICEID771323//修改成读者在平台创建的设备对应ID#defineAPIKEY0f3FXdmZ7od0iuVYVZBkiJeaJbg=//修改成读者对应的设备APIKEY图3-4修改设备ID及设备APIKEY4.编译整个工程，并下载程序，请保证ST_LINK和电源已正确连接。5.烧写程序完后，重新给开发板上电，建议每次烧写程序后都这样做，让WIFI模块完全掉电。6.程序运行后，打印如下：图3-5程序启动打印信息7.OneNET平台下查看上传的数据。如下图，数据0表示对应的LED指示灯为熄灭状态，数据1表示对应的LED指示灯为点亮状态。图3-6平台数据查看8.打开OneNET平台的设备页面，点击发送命令，弹出下发命令窗口如图所示：输入命令内容“{LED10}”，点击发送命令，观察红色LED指示灯是否熄灭。图3-7平台命令下发程序中对控制命令的内容约定如下表（用户可以自己约定命令内容）：命令内容命令响应命令内容命令响应{LED10}熄灭红色LED{LED11}点亮红色LED{LED20}熄灭绿色LED{LED21}点亮绿色LED{LED30}熄灭黄色LED{LED31}点亮黄色LED{LED40}熄灭蓝色LED{LED41}点亮蓝色LED3.2ESP8266+HTTP上传温湿度数据实验参考资料和说明：（1）MINI开发板硬件原理图V1.0.pdf（2）《设备终端接入协议5-HTTP.docx》（3）《ESP8266AT命令手册》（4）开发环境KEILV4.6.0，文件编码采用utf-8（5）使用ST-LINK烧写固件实验原理：使用MINI开发板的I2C接口采集SHT20温湿度传感器的数据，并通过开发板上ESP8266与HTTP服务器建立TCP连接，利用HTTP协议将采集的数据传输到OneNET平台。实验步骤：如果没有HTTP设备，请先在OneNET平台创建一个HTTP设备，具体步骤参考《2.2资源创建示例》，本例中所用到的设备参数如下：图3-8设备信息1.硬件连接连接uart调试串口，波特率115200，8N1。连接ST-LINK编程器。连接ESP8266WIFI模组。接入电源，烧写程序前先上电。图3-9硬件连接2.打开实验工程，目录：实验代码\OneNET_Mini_Demo_ESP8266_HTTP_HT\Project\OneNETdemo.uvproj3.修改相关参数1)修改设备鉴权参数在main.c文件中，根据自己的设备信息，修改API-KEY和DEV-ID:图3-10修改API-KEY和DEV_ID2)修改WIFI接入点的SSIP与PASSWORD在esp8266.h文件中，根据自己的网络环境，将参数修改为#defineCWJAPAT+CWJAP=\your_ssid