设备接入

  • 如果您只是设备使用者,可直接从设备管理开始。
  • 如果您是设备厂商,请参考以下步骤在平台接入您的设备。

1. 设备接入总流程


     注册绿洲账号 --> 注册成为开发者  --> 注册设备型号  --> 设备接入

2. 注册成为开发者

    用户登陆物联网平台主页,点击立即注册,使用手机号码注册绿洲平台用户。

    登陆物联网平台主页,点击主页右上角“产品地图”->“开发者中心”,跳转到“绿洲开发者平台” 点击“账户管理”,进行开发者申请,可以注册为企业开发者和个人开发者:

    企业开发者申请需提交绿洲后台审核,适合终端用户使用绿洲平台传送终端数据、解析业务、使用应用等平台现有功能。
    个人开发者申请不需要审核,申请完成后即可进行终端定制等操作,个人开发者下终端或网关型号信息仅自己可见,适合终端开发者自行调试。
    私有云版本只能注册企业开发者。

3. 终端型号定制

3.1 厂商型号模板标识申请

    申请厂商型号模板标识(即厂商Topic),作为平台中的厂商身份信息标识,定制厂商终端型号时某类型型号绑定在某个模板标识上。

3.2 设备型号注册

  • 填写终端型号基本信息,注册终端型号。
  • 平台当前支持LoRa, NBIoT, MQTT, RFID, ZigBee等接入协议终端接入。同时平台在不断扩充接入协议,如果您的设备不在上述协议,请与管理员取得联系。
  • 在注册型号时需选择终端的接入方式,并声明终端的标识类型,如LoRa终端标识为DEVEUI。
  • 同时为终端型号选择行业分类,分类信息与平台应用相关。
  • 终端数据格式包括H3C归一化报文格式、H3C JSON数据格式以及自定义数据报文格式。H3C归一化报文格式及H3C JSON为H3C定义的一套完备的协议报文格式,可通过终端修改报文格式、内嵌H3C模组或内嵌SDK实现;同时平台支持自定义数据报文格式,通过配置消息模板方式来定义自定义报文格式。

3.3 功能信息配置

  • 为终端型号绑定功能信息,终端型号的功能信息即终端具有的某种能力。
  • 功能配置分为属性能力配置和指令能力配置,属性能力为终端支持上报数据,如温湿度终端可上报当前温度、湿度值,指令能力在终端支持下行控制时配置,如为开关终端设置开关状态。

3.4 消息模板配置

  • 为终端型号配置消息模板,根据终端报文格式对终端上行数据报文、下行指令控制报文以及响应报文格式进行配置。为型号配置了上行数据消息模板,平台可实现将上报的数据报文根据消息模板解析成JSON数据发送至平台内部或外部应用。配置了下行控制消息模板,平台可接收JSON格式指令,根据消息模板转换成终端报文完成指令下发及指令响应结果解析。
  • 地址域为消息模板的唯一标识对应报文中的标识位。标记为属性字段为报文中需要解析的有实际意义的字段。不标记字段为不需要解释的字段。标记为命令执行字段为响应报文中的响应状态码。
  • 如下表格中终端R718上行下行报文举例,根据报文格式配置消息模板如图所示。

    • 终端报文格式(上行):
    R718 0x1D 0x01 Battery (1Byte, unit: 0.1v) ContactSwitchOnOff (1Byte 0:off 1:on) Reserved (6Byres, fixed 0x00)
    • 终端报文格式(下行):
ConfigReportReq R718F 0x01 0x1D MinTime (2Byte, unit: s) MaxTime (2Byte unit: s) BatteryChange (1Byres, unit: 0.1v) 
  • 上述报文的消息模板配置如下:

  • 上行消息定义如下:

  • 下行消息定义如下:

  • 可对设备型号进行高级配置,厂商用户上传自定义编解码插件,此时平台使用用户自定义的插件对设备上下行报文进行处理,实现对复杂报文的解析与拼接。

3. 网关型号定制

  • 平台当前支持MQTT/LoRa等协议网关接入,并支持MQTT接入协议的第三方网关接入,在“网关定制”也面进行网关型号相关参数配置注册网关型号。
  • 在注册型号时需选择网关的接入方式,并声明网关的标识类型(如MAC、IMEI等)。
  • 数据格式包括H3C JSON数据格式以及自定义数据报文格式。H3C JSON为H3C定义的一套完备的协议报文格式,可通过修改设备的报文格式或内嵌SDK实现;同时平台支持自定义数据报文格式,通过配置消息模板方式来定义自定义报文格式。
  • 设备认证包括认证类型与认证级别。认证级别又分为型号级和设备级,认证级别到型号,型号设备共用认证信息,而设备级认证则为具体设备分配认证信息。
  • 认证类型包括证书认证和用户名密码认证。选择对应的认证类型,云端会生成用户名、密码以及证书等认证信息,该信息用于设备端与云端建立MQTT连接。设备厂商需将平台生成的认证连接信息烧录进设备中,设备通过平台认证后方能接入平台。
  • 完成上述操作,下一步在平台接入您的设备试试吧。
© H3C IoT all right reserved,powered by Gitbook更新时间: 2021-11-24 17:53:45

results matching ""

    No results matching ""