开发者中心

1. 入门概述

本章主要介绍了新大陆物联网云新手接入流程,通过一步步详细图文并举,来帮助您快速理解云平台的接入原理,即使您现在还没有开发任何设备,也可以快速上手。

2. 接入流程

2.1.帐号注册

在使用云平台前,您需要先注册一个账号,点击右上角“新用户注册”(分“学校用户注册”、“企业用户注册”及“个人注册”),如下图所示: 学校用户注册
点击新用户注册后,页面跳转至学校用户注册窗口,如下:

填写用户注册信息,手机号、密码、选择学校、验证码都不可为空,若为老师身份则勾选“我是老师”,是学生身份则不必勾选。填写完整后,点击“确定”,显示如下:

注册成功后,自动跳转到"开发者中心"的主界面.
企业用户注册
点击新用户注册后,页面跳转至学校用户注册窗口,选择企业用户注册窗口如下:
填写用户注册信息,手机号、密码、公司名称、选择公司所在城市及验证码都不可为空,填写完整后,点击“确定”,显示如下:
注册成功后,跳转到显示"账号信息已提交审核"等字样页面,需等管理员审核身份才可登录云平台。 个人注册
点击新用户注册后,页面跳转至学校用户注册窗口,选择个人注册窗口如下: 填写用户注册信息,手机号、密码及验证码都不可为空,填写完整后,点击“确定”,显示如下: 注册成功后,自动跳转到"开发者中心"的主界面.

2.2.创建项目

通过以上注册后你将进入到 开发者中心->项目管理 主界面,接下来为了顺利完成整个流程的开发,您首先需要创建属于您自己的项目; 在项目管理页面,点击“新建项目”按钮,弹出创建项目子页面
项目名称:可自行定义一个比较好记的名称
行业类别:选择该项目是偏向于物联网的哪个行业
联网方案:你的设备准备接入云平台的网络环境
输入以上等信息,然后点击"下一步",当点击下一步时将成功创建项目,同时为了方便,平台会跳转到“创建设备”的子页面,让你顺带把设备也创建了,详见下节创建设备

2.3.创建设备

上节的“创建项目”点下一步后会跳转到“创建设备”的子页面,如图:
设备名称:输入一个好记的名称
通讯协议:平台提供三种方式供设备接入,TCP即理解为常规的Socket编程; MQTT即IBM开发的一个即时通讯协议,基于TCP/IP使用发布/订阅消息模式,具小型传输、开销小及消息发布质量等特点; HTTP即使用模拟API请求方式,不需要建立所谓的“设备连接”,就可以直接进行数据上传平台了,这是因为在发送的HTTP报文中,会留出相应字段来指明数据需要上传到平台的哪一个设备下。 以上具体详细请跳转至:设备接入章节
设备标识: 平台支持新大陆设备也同时支持任何第三方设备接入,设备标识在全局内唯一,按以下情况查找或定义:
a)“新大陆网关”等设备(网关 →【参数设置】→【系统参数】中的序列号);
b)“新大陆农业网关”等设备对应(浏览器输入网关IP → 登录网关 → 设置页面->【设备状态】中的设备编号);
c)“新大陆家居网关”等设备对应(新大陆家居平板 → 登录 → 主界面 → 界面左上角的一行序列号);
d)“其它的MCU或SOC等设备”,可自行输入一个唯一的标识用于与平台连接;
输入以上等必填信息后点击“确定添加设备”,便完成该项目下的一个设备的添加。 当然你还可以通过几下方式进入创建设备页面,在项目列表页面,点击某个项目的标题连接进入项目概况页面,再点击顶部“设备管理”菜单

2.3.1.定义传感器

这里所描述的传感器是一种通称,可以是真实的传感器件、执行器件、摄像头、RFID、LED以上传感器某项功能的虚拟属性(如RGB灯:可以定义开关、调红、调绿、调蓝四个功能传感器数据)等。 传感器被设备所采集、传输到云平台进行数据存储、处理。 添加传感器的统一入口为 某个项目->设备列表页->点击设备标题连接(或右侧传感器管理图标)->传感器管理页面,如图: 单击“马上创建一个传感器”或表格右上角“新增”图标,弹出添加传感器浮动窗口,可以添加多种类型的传感器,也可以以传感器功能属性来定义,当然弹出窗口的表单选项也有可能不同:
不过表单大致包含如下选项(其中家居网关类型弹出的是搜索传感器的模式)

其它类型的传感器可能还包括通道号或序列号等,针对该字段一般设备有详细的说明,如传感器连接ADAM4017 I/O模块是VIN接口或组网时的序列号等等
填写完成后,点击“确定”,添加成功,点击“确定且继续添加”则可在不关闭本窗口情况下继续添加多个。
注:定义执行器、摄像头等的步骤类似。

2.4.设备接入开发

设备接入开发主要实现开发者实际的终端设备与云平台的连接和数据交互。在您完成以上步骤项目、设备、传感器的创建后,即可根据所创建设备的协议类型(TCP\MQTT\HTTP)选择相应的硬件接入的开发。 一般该开发主要是实现数据采集、设备连接、数据上传、控制等代码工作,接入的方式可以是TCP、MQTT、HTTP等,通信方式可以是常见的3G/4G、WIFI、以太网口等; 在编码的过程中,可以用“设备接入”章节中提供的SDK进行数据封装.
注:采用新大陆的设备已编写好代码,只需配置好连接云平台的IP与端口即可直接接入
详细请跳转至“设备接入”章节

2.5.应用开发

应用开发主要是通过原生的Rsetful API或SDK等方式实现和云平台进行数据对接、数据分析、远程监控等,结合自己的需求,来实现相关产品应用程序的开发,要实现应用开发,可以有几下三种途径:
方式一:《云平台应用设计器》,该工具提供了在线拖控件,一键发布等功能,并提供曲线图、柱状图、蛛网图、位置、开关、表盘、控件等,快速实现WebAPP的开发与浏览,支持兼容PC或移动设备;
方式二:开发者只需在正在开发的应用内调用云平台提供的SDK实现快速开发APP;
方式三:利用平台提供的RESTful API接口编码实现APP开发;
不管采用的是以上哪种方式,应用开发的第一步是首先需要有一个APIKEY,每个用户有且只有一个且有过期时间限制,其作用是设计、浏览应用时的唯一凭证。 在开发者中心->个人中心->ApiKey管理的页面中,点击页面中的"生成"按钮及选择时间期限,然后“确定提交”创建一个apikey
这里将主要讲解方式一的步骤,方式二与方式三请移步至“应用开发”章节的 《调用SDK进行应用开发》《请求RESTful API实现APP开发》

2.5.1.添加应用

进入应用管理页面,点击“新增应用”,跳转到新增应用界面,如下:

填写完成后,点击“确定”,添加成功。

2.5.2.设计应用

应用模块选择是非“自行设计”的,直接点击发布图标,发布后即可浏览;选择“自行设计”的,在每个应用列表右边点击“设计”连接,连接到“应用设计器”工具页面。 设计好后,可以点击右上角的“保存”按钮完成设计区布局的保存,若想立即发布则把右边的“同时发布项目”复选框打钩即可。

2.3.发布/浏览应用

对于在应用设计器中还未发布的应用,也可以在应用列表页点击“发布”按钮,生成应用文件存储到服务器,即可在线浏览

2.6.功能调试

功能调试目前主要包括“API调试工具”及“数据模拟器”
虚拟设备(开发中):可以规定发送数据的范围和发送间隔时间,发送成功后,右边会显示历史发送记录;
API调试工具:用于在应用开发时,对指定API接口进行在线调试,可以输出真实的数据及格式供参考;

3. 名词解释

3.1.projectTag

项目标识码,保留暂无用处

3.2.deviceId

定义:设备ID,当一个设备被创建时,将自动分配一个ID,此deviceId全网唯一,用于与用户的绑定及应用开发获取设备等信息的API接口参数

4.2.1.tag

定义:设备标识,当一个设备被创建时,可以定义成设备的MAC地址或自定义的30位以内的字符串,用于区分其它设备,全网唯一用于设备接入的唯一标识

4.2.2.SecretKey

定义:传输密钥,设备终端如'网关'连接到云平台的证明用于确认用户的身份及权限。

4.2.3.ApiTag

定义:传感器标识名,用于数据上报及API调用的变量名(如:Temperature,AirQuality)

4.3.4.AppTag

定义:应用标识,用于应用的唯一标识码,同时用于浏览应用的关键码