本章根据示例的产品和功能详细介绍如何在LinkPlatform平台上做设备接入的配置。

1 .1创建产品

产品指的是具有相同功能或特征的一类设备的集合,产品下的设备将自动继承其所属产品的名称、型号、功能(属性、服务、事件)等信息。设备接入平台且双方可以正常通讯理解的前提,需要在平台上创建与之对应的产品以及约定好产品的功能。

在LinkPlatform上创建产品前首先要清楚自己的设备属于以下4类中的哪一种:

产品 说明
自定义协议的直连设备 这类设备可能有两种情况:(1)由于该类设备硬件资源紧缺,不能很好的支持Alink协议的JSON;(2)属于存量设备,不想修改设备原先的协议。

对于这类设备平台允许设备将数据直接上报到平台后,在平台侧开发协议转换脚本,否则平台无法解析处理。

对于这类设备除了本身设备有一定的开发工作量,也需要在平台上开发协议转换的JavaScript脚本。

产品创建时选择如下配置:



Alink协议的直连设备 设备和平台之间的交互可以传输Alink协议数据,省去在平台开发解析脚本的麻烦。

产品创建时选择如下配置:



网 关 网关能够帮助非直连设备(相对网关我们称为子设备)接入平台,网关和子设备会建立拓扑关系。

一般网关的处理能力还是可以的,而且协议较复杂不建议直接上传到云端处理,因此建议产品创建时采用Alink协议通讯,配置如下:



不能直连的子设备 该类设备不能直接和平台直接通讯,需要依赖网关做协议转换后上云。

一般子设备的协议会经过网关解析处理,网关和云端通讯一般用Alink协议,因此产品创建时也采用Alink协议,配置如下:



(1)新增产品

点击控制台进入产品页面,开始创建一款新产品。





(2)填写产品信息

说明:节点类型和数据格式根据实际产品情况选择。为了让开发者了解这四种产品形态在平台上开发的区别,本文档会将示例的产品分别定义出来,下一章我们将会使用不同的产品来演示如何接入。如下所示:

  • 采用Alink协议的直连方式


  • 采用自定义协议的直连方式


  • 采用网关+子设备的方式接入

    首先,需要定义网关产品:



    其次,需要定义子设备的产品:



(3)产品信息说明

  • 所属分类

    选择自己产品对应的品类,系统将为您自动推荐该品类的标准功能定义,您可以点击“查看功能定义”进行查看。若列表中没有您所需的品类可以钉钉联系我们添加或可以点击“提交品类合作申请”,对您的新类型设备进行功能描述,您将有机会成为该品类的标准定义者。

    我们示例要开发的设备是属于环境监测类别,因此选择环境监测设备。

    说明 :所属分类一定要根据实际产品选择,如果选项中不支持则需要联系我们在后台新增,否则会影响产品发布后上架云市场后的归类和售卖。
  • 产品名称
  • 产品型号(可选)

    硬件产品的型号,型号在该项目下需确保唯一;

  • 节点类型

    设备-是指这一是一款单品产品;网关-支持子设备管理的网关型产品;

  • 通讯方式

    设备入网的主要通讯方式,如果设备有多种入网方式,选择最主要的一种方式即可。

  • 数据格式
    数据格式 说明
    Alink 是物联网平台为开发者提供的设备与云端的数据交换格式协议,采用JSON格式进行表述。
    透传/自定义 如果设备已经有自定义的协议,可以选择该格式,通过在云端配置数据解析脚本,将透传/自定义格式的数据转换为Alink JSON进行解析。
  • 产品描述(可选)

    填写产品的介绍、说明。

(4)产品详情

产品创建完成后,系统将自动颁发产品的唯一标识,ProductKey,您可以在产品的详情页面查看到该信息。产品的基本信息包括您在创建产品时填写的信息,同时也包含系统为该产品颁发的全局唯一标识(ProductKey)和加密密钥(ProductSecret)。产品详情页面提供产品的功能定义、测试设备开发、在线调试、数据解析(选择非Alink协议出现)和扩展信息管理等功能。



1.2 产品功能定义

物联网将物理世界的万物接入网络并通过整合各类服务实现智能化,“物”(Things)作为整个网络中的基础节点和商业触手,既是环境信息的采集者,也是智能服务的提供者和承载者。因此,我们首先需要对物联网中的“物”能做什么,能提供什么样的服务进行描述,这就需要开发者从产品层面进行功能建模,定义物的“属性”(Property)、“服务”(Service)和“事件”(Event)。通过功能建模将各类设备统一抽象为云端的资源,并对外暴露相应的接口,以满足不同场景下不同系统的调用和快速集成。

物模型是对设备是什么,能做什么的描述,包括设备身份标识、连接状态、描述信息,以及设备的属性、服务、事件,后三者构成了设备的功能定义。Link Develop通过定义一种物的描述语言来描述物模型,称之为 TSL(即 Thing Specification Language)。

Linkplatfom中已经按照不同的领域和行业分类,定义了标准品类的物模型,创建产品时系统已根据您选择的“所属分类”自动创建了该产品的标准功能,您可以直接使用并开始设备的固件开发工作,也可以根据实际需要添加自定义的功能。功能定义完成后,平台将自动生成JSON格式的TSL(通过下图的“查看JSON“连接可以获取),您可以结合 Alink 协议组装上报设备的数据。



(1)标准功能

在产品的详情页面,默认显示“功能定义”标签页,系统已经自动为您创建了该类型产品必选的标准功能,您可以点击“编辑”对标准功能的相关参数进行修改,或者点击“”新增查看该类设备的可选功能。

必选功能是产品所属品类的最小功能集合,代表了该品类设备必不可少的功能,您可以根据需要进行相应的调整和编辑,例如一款环境监测盒子,具有“温度”、“湿度”等必备功能,必选功能不可删除。

可选功能是产品所属品类的推荐功能集合,即每个厂商对于相同类型的设备的功能存在差异,系统将为您自动推荐适合该品类设备的相关功能,例如部分环境监测盒子,具有“地理位置”的可选功能,您可以直接选择—编辑—完成创建,可 那个可以删除。

本示例选择的温湿度检测品类有如下必选功能,具备了我们示例需要开发的温度、湿度的基本功能。



说明 接入CityLink平台的设备都必须要在产品功能定义时添加地理位置属性,添加方法如下图:


(2)自定义功能

如果标准功能无法满足您的需求,您也可以根据实际需要,添加自定义功能。点击列表上方的“新增”按钮,在弹窗中创建产品的自定义功能,支持分别创建属性、服务和事件。



按照示例要求的功能需要实现:(1)上报周期可配置 (2)温度过高触发告警发送云端,告警阈值可远程配置。因此我们按照平台的物模型要求做如下定义:

  • 定义属性TempOvertopThreshold,表示温度过高的告警阈值


  • 定义事件TempOvertopEvent,表示温度过高的告警事件

    事件的输出参数(表示设备发送给平台)定义温度参数,表示上报事件时会把当前温度一起上报到平台。



  • 定义服务SetPostIntervalService,表示设置设备的上报间隔

    服务的输入参数(表示平台下发给设备)定义上报周期,表示要设置给设备的参数.



定义完成后效果如下所示:



至此,平台的功能定义已经完成



1.3 新增测试设备

为了方便您在开发阶段进行设备的开发调试,需要您可以在“设备”页面,点击“新增设备”按钮,添加一个设备并进行相应的在线调试。填写DeviceName,输入框为空将由系统为您自动颁发全局唯一的DeviceName。

说明 :请注意,如果您添加的是一个LoRaWan设备,则DeviceName是必填,且需确保是一个有效的DevEUI才可添加成功。


  • 生成设备证书


    点击确认后,平台就会生成设备的证书(包括了ProductKey、DeviceName、DeviceSecret,也称为三元组)。

  • 设备状态




1.4 设备开发

在设备开发阶段,LinkDevelop为您提供了设备端SDK,以及测试设备的注册和调试能力。您可以下载设备端的SDK,在此基础上,将在平台预注册设备的激活凭证( 设备证书:ProductKey、DeviceName和DeviceSecret)烧录或配置到设备中,根据产品的功能定义完成设备本身的业务逻辑开发,并将设备联网,接入平台进行调试。

设备开发的方式多种多样,我们统一在下一章节中详细介绍。

1.5 协议解析脚本的开发(可选)

主要针对采用透传/自定义格式上报数据的设备,您如果使用了Alink协议可以忽略本节,可以直接参考 Alink 协议(3.2.3)完成设备端的开发和接入,无需编辑协议解析脚本。LinkDevelop为开发者提供了用于数据解析的在线脚本编辑器,方便您进行在线的编辑和模拟调试。



文本的示例对非Alink的接入方式简单定义了如下私有协议,并会在下一章的设备开发中按照此协议进行开发。

  • 自定义的协议说明


    根据示例产品的功能,我们定义payload含义如下所示:



1.6 在线调试

LinkPlatform为开发者提供了便捷的在线调试工具,您在开发过程中,可以选择测试设备,对设备的功能进行调试,包括查看设备上报的数据、设置某条属性的值、调用设备服务、获取设备事件等。调试过程中,您可以通过实时日志查看到调试的结果



1.7 产品发布

发布产品意味着这款产品完成了开发,已经准备好可以进入到量产和规模化部署的阶段。

  • 在产品页面点击发布按钮


  • 发布确认


  • 发布完成


1.8 产品分发

LinkPlatform开发完成的产品可以分发到特定项目的CityLink(VPC)平台,然后在CityLink上基于该产品重新申请设备证书烧录到设备,就可以连接(如果是IP方式接入还需要修改MQTT服务器的IP地址)到CityLink平台。

目前我们有一个CityLink的测试环境,开发完成的产品可以分发到该环境进行测试(实际项目也是类似的操作),具体操作流程如下:

  • LinkPlatform开发的产品需要进入发布状态,参考3.1.6章节
  • 点击平台分发按钮
    说明 :需要实名认证过的企业开发者才会出现平台分发功能,在进行分发前需要您将账号提供给我们在后台配置分发的权限即可。


  • 选择“演示VPC环境”同步


    如果“操作”栏显示为已同步,说明您开发的产品已经分发到了CityLink测试环境,可以联系我们为设备颁发设备证书进行调试了。