页面树结构
转至元数据结尾
转至元数据起始

总概

  • 云智易硬件SDK提供各种不同CPU架构的C库,方便快捷将各种硬件设备快速安全地接入到云智易物联平台;
  • 提供常用模组的例程示例,加快开发者开发周期;
  • 提供透传固件,开发者可不用开发设备接入云平台的固件,便可将设备简单快速联网;
  • 支持强大的数据端点,可将设备的运行状态、参数和报警信息映射到平台,方便设备的管理和监控,并能快捷将报警内容通过邮件、短信或应用推送给用户;
  • 提供完善的硬件通讯协议,很好地支持各种产品的功能实现。

1.硬件SDK开发

1.1硬件SDK说明

主要功能特点:

  • 本地设备自动探测和扫描联网;
  • 内置云端连接服务,无需额外对接开发;
  • 支持内、外网网络自动检测和切换;
  • 提供云端固件升级和远程配置、诊断和管理服务;
  • 支持设备安全认证和数据加密机制;
  • 支持微信Air Kiss、SmartLink和easylink一键配置;
  • 支持ARM、x86、x64以及MIPS等不同处理器架构;
  • 可移植性强,使用操作简单快捷。

1.2硬件SDK接入流程

  • 首先在平台http://admin.xlink.cn上注册一个账号,并创建一个产品,这时可获得产品PID和产品KEY;
  • 在平台上所创建的产品上的“设备管理”页面上添加接入设备的MAC地址;
  • 然后转到接入设备开发,先选择对应模组SDK,定义修改数据类型;
  • 初始化TCP并连接上云智易TCP服务器,将函数xlink_send_cb()里面的数据通过外网发送出去,接收到外网数据后调用xlink_receive_data()往SDK放入数据;
  • 初始化UDP,将函数xlink_send_cb()里面的数据通过外网发送出去,接收到外网数据后调用xlink_receive_data()往SDK放入数据;
  • 实现xlink_write_flash_cb、xlink_read_flash_cb、xlink_send_cb、xlink_receive_cb、xlink_get_datapoint_cb、xlink_set_datapoint_cb和xlink_event_cb函数;
  • 调用“xlink_sdk_init()”初始化(当连接上外网TCP时调用xlink_sdk_connect_cloud()启动外网通讯,如果断开即调用xlink_sdk_disconnect_cloud()停止);
  • 循环执行“xlink_sdk_process()”;
  • 如果使用外网,需等待“EVENT_TYPE_ONLINE”事件触发后才能向服务器发送数据;
  • 设备连接平台成功后,便可收发数据,如果需要使用到数据端点,请参考“数据端点文档”;
  • 需要停止时,调用“xlink_sdk_uninit()”停止SDK;
  • 如需要重置SDK时,调用xlink_sdk_reset();
  • 如需要发送数据时,调用xlink_update_datapoint();
  • 如需要请求数据时,调用xlink_request_event()。

2.数据端点使用说明

数据端点有强大的功能,主要功能:

     可映射设备运行状态到平台,可通过数据端点设置设备参数或控制设备,设备可通过数据端点将需要存储的数据存储到服务器,设备也可将需要报警的信息通过数据端点推送到用户手上。

主要流程如下图:

数据端点的数据格式、支持的数据类型以及对应接口的使用请参考数据端点使用文档。

3.开发者指南

您可以通过以下链接下载相关平台的Device SDK包,并了解详细的使用说明。

4.资源地址

V5

资源名称

链接地址

版本号

发布时间

更新说明

文档链接

Device SDK V5Device SDK下载及更新说明V5.02018-4-20初始版本设备端SDK开发指南

V6

资源名称

链接地址

版本号

发布时间

更新说明

文档链接

Device SDK V6Device V6 SDK下载及更新说明V6.0
初始版本设备端V6 SDK开发指南



  • 无标签