产品和设备在同一个项目内是共享的,在不同项目之间是隔离的。本文档介绍项目下的设备列表、设备新增、设备基本信息编辑、设备详情查看、删除设备等功能的使用方法。

背景信息

为了IoT Studio项目中的应用具有访问产品/设备的权限,需将物联网平台的设备管理中的产品关联到项目中,或直接在项目下创建产品和设备。在项目下创建的产品和设备,将直接显示在物联网平台的设备管理模块中。

查看项目设备列表

  1. 物联网平台控制台左侧导航栏,单击IoT Studio > 开发服务
  2. 在项目列表中,定位到目标项目,单击项目右侧操作栏的进入
  3. 在项目页面,单击左侧导航栏的设备管理 > 设备
    • 设备列表上方会显示设备汇总信息:当前指定产品设备总数、已激活设备总数、在线设备总数。
    • 如果您尚未创建或关联任何设备,您可以首先创建设备。
    • 如果您已创建了设备或关联物联网平台控制台设备管理中产品时已关联了产品中的设备,设备管理 > 设备列表页将以列表形式显示设备信息,包括设备的名称、设备所属产品、节点类型、激活状态、最后上线时间和可操作功能项。
    设备列表
    任务 操作步骤
    查看具体产品下设备信息 在页面左上方选择某个产品。
    说明 设备列表页默认显示该项目下所有产品下的设备信息,或指定显示某产品下的所有设备信息。
    搜索设备 输入设备名称搜索具体设备,支持模糊搜索。
    查看具体设备信息 单击对应设备的查看按钮。详细内容请参见查看具体设备信息
    解除绑定某个设备 单击对应设备的解除绑定按钮。详细内容请参见解除设备与项目的关联
    删除某个设备 单击对应设备的删除按钮。 详细内容请参见删除设备
    说明 设备删除后,该设备证书信息将失效,该设备在物联网平台上的数据记录随之删除。

批量新增设备

  1. 设备管理 > 设备页面,单击新增设备
  2. 新增设备的对话框中设置设备信息(见下表)。
    新增设备
    参数 描述
    产品 选择产品。新增设备将继承该产品的功能和特性。
    说明 若该产品关联了其他平台,请确保您的账户下有足够的激活码用于创建设备。
    添加方式 选择设备名称的添加方式。
    • 自动生成:无需为设备指定名称。填写设备数量后,系统将为每个设备自动生成由字母、数字随机组合成的DeviceName。
    • 批量上传:需要为所有设备指定名称。单击下载.csv模板下载表格模板,在模板中填写设备名称,然后将填好的表格上传至控制台。
      说明 填写模板时,请注意:
      • 设备名称长度为4-32个字符,可包含英文字母、数字和特殊字符,包括连接号(-)、下划线(_)、at符号(@)、点号(.)和英文冒号(:)。
      • 设备名称在产品维度具有唯一性。列表中的设备名称不可重复,且不可与该产品下已有设备的名称重复。
      • 一个文件中最多可包含1,000个名称。
      • 文件大小不超过2 MB。
  3. 单击提交
    若批量上传的设备名称列表中有不合法的名称,将出现错误提示。请单击下载不合法列表,查看不合法的设备名称。根据设备名称规范,修改设备名称,再重新上传文件。
  4. 设备创建成功后,单击下载激活凭证,下载本批次设备的设备证书,用于在产线上统一烧录。
    说明 如果创建产品时,选择认证方式为X.509证书,批量创建设备成功后,返回的X.509证书下载URL(CertUrl)有效期为30日,请及时下载。

    下载包中,包含成功生成的X.509证书和密钥,以及证书生成失败的设备列表txt文件。如果没有失败的设备,则没有txt文件。

    批量创建设备成功。可在设备管理页的批次管理页签下,查看该批次设备信息和下载设备证书。
    • 单击详情,查看对应批次设备的详细信息。
    • 单击下载Excel,下载该批次设备的证书。

    设备创建完成后,设备状态显示未激活。请参见Link Kit SDK文档开发设备端SDK,激活设备。

    说明 对于使用X.509证书进行安全认证的设备,如果需要使用一型一密认证和子设备通过网关接入物联网平台功能,需同时在设备端烧录X.509证书和ProductSecret或DeviceSecret;如果不使用这些功能,则只需在设备端烧录X.509证书。

    有关设备创建的更多详细内容,请参见批量创建设备

关联设备至项目

如果您已经在物联网平台的设备管理模块中创建设备,单击关联物联网平台设备,将物联网平台中的设备导入项目,以方便项目中开发的应用访问产品中设备。

  1. 设备管理 > 设备页面,单击关联物联网平台设备
  2. 关联设备对话框的设备列表中,勾选待关联的设备。
    设备库列表包含了物联网平台的所有设备,您可通过选择指定产品或输入DeviceName/备注名称,定位关联目标设备。
    说明
    • 只有已关联到该项目中的产品下的设备才能与该项目关联。
    • 未关联产品的设备会以灰色显示,不可选。
    • 已关联的设备,会以灰色钩显示,不可选。
    关联设备
  3. 单击确定
    您可在该项目的设备管理 > 设备页的设备列表中查看到关联的设备。

查看具体设备信息

在设备列表中,单击目标设备右侧操作栏的查看,进入设备详情页。

设备详情
任务 操作步骤
激活设备 “未激活”状态表明设备未接入阿里云物联网平台。您可以参见下载设备端SDK进行设备开发,将设备激活。
查看设备信息 查看设备基本信息,包括设备证书信息、固件信息扩展信息、标签信息等内容。
查看设备数据
  • 运行状态页签下,查看设备上报的当前属性值,属性记录数据和期望属性值。
  • 事件管理页签下,查看设备上报的事件记录。
  • 服务调用页签下,查看设备服务调用记录。
查看设备日志 设备行为、上行消息、下行消息、物模型数据和QoS=1的设备消息内容,可以在日志服务页签下查看。日志具体说明,请参见日志服务文档

编辑产品信息

在产品详情页面的设备信息 > 备注名称模块,单击编辑,在编辑设备备注名称对话框中修改设备备注名称。

在产品详情页面的设备信息 > 标签信息模块,单击立即添加(未添加过标签)或右侧的编辑(已有标签)。在添加标签对话框设置地理位置标签和设备标签信息。

添加标签
注意 编辑设备信息仅面向开发中的设备,如果该设备已发布,设备的所有信息将冻结,您将无法再做修改。

解除设备与项目的关联

单击目标设备右侧操作栏的解除绑定,解除项目与该产品的关联。

说明 目前,项目内的产品解除与设备解除是独立关系,互不影响。
解除绑定

删除设备

单击目标设备右侧操作栏的删除,直接删除物联网平台的设备数据。

注意
  • 删除后物联网平台上的数据也将删除。如果其他项目使用了该设备,已发布的应用会出现数据错误,请谨慎操作。。
  • 设备删除后将不可再恢复,请谨慎操作。
删除设备