1、迪文云平台构成
迪文云平台由首页数据概览、产品管理、产品分析、运营管理、账号管理五个主模块组成,见图1-1:
图1-1迪文云平台首页展示图
2、接入迪文云步骤
2.1 确认硬件已安装WiFi-10模块
图2-1 WiFi-10模块安装
2.2 设备通过WiFi上网
2.2.1 方法一:APP一键配网
一键配网功能需配合迪文云APP完成。
(APP下载地址http://www.pgyer.com/dwin)
1)首先,需要手机连接WiFi(同时也是设备将接入的WiFi);
2)在屏幕点击“启动一键配网”按键;
图2-2 设备端操作示例
3)前往APP点击“添加设备”,然后在弹出页面上选择“一键配网”。点击“开始配置”输入WiFi密码,点击“下一步”进入配网状态,等待WiFi模块自动完成配网。设备端的配网状态可通过图标指示。
图2-3 APP一键配网操作
2.2.2 方法二:设备端配网
在屏幕上输入待连接的WiFi名称和对应密码来完成网络配置,实现连网。输入网络名称和密码后,需点击“启动配网”按键以启动配网流程。配网状态可通过图标指示。
图2-4 设备端操作界面示例
2.3 注册迪文云平台账号
用户在迪文云平台 http://merchant.dwinhmi.com.cn/ 中通过手机号即可注册账号。
2.4 添加产品
用户注册成功,等待审核通过后,可在迪文云平台中添加产品。
点击左侧“产品管理”,点击页面右侧“添加新产品”建立新产品,填写产品信息后,保存,就完成了一个新产品的新建。
在此页面点击此产品后能重新编辑产品名称、产品编号、终端平台、屏幕尺寸和绑定状态等信息。
如图2-5:
图2-5 产品管理页面
2.5 通过云平台进行设备调试
联网的设备会自动连接到迪文云平台。该设备在迪文云平台→运营管理→设备列表中显示。
图2-6设备列表展示设备信息
设备在开发过程中,通过迪文云平台-运营管理-设备列表-调试-内存映射调试接口中显示设备的内存地址内容(16进制)。如图2-7,2-8所示。
图2-7 设备列表选择调试页面
图2-8 内存映射调试页面展示
使用APP操作设备时,发送的指令也会在迪文云平台的内存映射调试接口中显示该设备的内存地址变化信息。
3、迪文云与第三方服务器对接
第三方服务器可以通过平台提供的http接口获取相关设备信息,与设备进行指令交互。平台提供的接口相关信息可以在产品的第三方接口中查看。
3.1API调用接口
系统对外提供统一的API接口,用户服务器在调用接口时按照相关接口协议进行调用。
图3-1系统对外提供接口地址展示
3.2Token授权信息
系统目前使用Token认证,用户在调用接口时必须携带Token信息,用于授权。
Token信息是绑定在产品下的,即每款产品有一个Token信息。Token支持用户自定义(Md5格式),如果用户想在多款产品中使用同一个Token,将这几款产品的Token设置为同一个即可。
图3-2用户密钥
3.3 IP白名单
用户服务器的IP地址必须设置在IP白名单中,不在IP白名单中的请求将被拦截。
图3-3第三方用户服务器IP地址
3.4 回调地址
回调地址为用户提供给平台的的通知接口,平台将设备上报的指令以http协议形式回调给用户服务器,通知用户设备状态的改变。
该回调地址由商户提供,具体回调信息格式参考相关协议文档。
图3-4第三方服务器调用平台接口使用的回调地址