物联网应用开发(IoT Studio)的项目详情页面提供了查看设备列表及其详情、新增设备、编辑设备基本信息、删除设备等功能。

前提条件

已完成创建产品。详细内容请参见产品

背景信息

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

查看项目设备列表

  1. 登录物联网应用开发控制台,在左侧导航栏单击IoT Studio > 项目管理
  2. 在普通项目列表中,找到目标项目,单击项目卡片。
    您也可单击全局资源项目,进入该项目详情页面。
  3. 在项目页面,单击左侧导航栏的设备
    • 设备列表上方会显示设备汇总信息:当前指定产品设备总数、已激活设备总数、在线设备总数。
    • 如果您尚未创建或关联任何设备,可首先创建或关联设备。
    • 如果您已创建设备或关联物联网平台控制台设备管理中产品时已关联了产品中的设备,设备列表页签将以列表形式显示设备相关信息。支持如下任务。
      任务 操作步骤
      查看具体产品下设备信息 在页面左上方选择某个产品。
      说明 设备列表页默认显示该项目下所有产品下的设备信息,或指定显示某产品下的所有设备信息。
      搜索设备 输入设备名称搜索具体设备,支持模糊搜索。
      说明 全局资源项目还支持根据备注名称和设备标签查询设备。
      查看设备具体信息 单击对应设备的查看按钮。详细说明请参见管理设备
      解除绑定某个设备 单击对应设备的解除绑定按钮。
      说明
      • 目前,项目内的产品解除与设备解除是独立关系,互不影响。
      • 全局资源项目不支持与设备解除关联的功能。
      删除设备
      • 删除单个设备

        单击对应设备的删除按钮。

      • 批量删除设备

        选中多个设备,单击设备列表下方的批量删除

      注意
      • 删除后物联网平台上的数据也将删除。如果其他项目使用了该设备,已发布的应用会出现数据错误,请谨慎操作。
      • 设备删除后将不可再恢复,请谨慎操作。
      禁用或启用设备 全局资源项目支持该功能。
      • 禁用:禁止设备接入物联网平台。
        说明 设备被禁用后,物联网平台中,与该设备关联的信息依然保留。但是,该设备将不能接入物联网平台,您将无法执行与该设备有关的操作。
      • 启用:重新启用已被禁用设备,允许设备重新接入物联网平台。

      选中多个设备,单击设备列表下方的禁用启用

    说明 全局资源项目设备页面支持添加设备,不再支持手动关联物联网平台的设备。

单个添加设备

全局资源项目中支持单个添加设备,具体操作如下。

  1. 设备页面,单击添加设备
  2. 添加设备对话框中,输入设备信息,单击确认
    物联网平台设备

    设备创建成功后,将自动弹出查看设备证书对话框。您可以查看、复制设备证书信息。

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

    有关设备创建的更多详细说明,请参见单个创建设备

批量新增设备

  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 SDK文档开发设备端SDK,激活设备。

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

关联设备至普通项目

如果您已在物联网平台的设备管理中创建设备,可将该设备导入普通项目,以方便普通项目中开发的应用访问产品中设备。

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

编辑设备信息

在设备详情页面的设备信息 > 备注名称标签信息模块,单击编辑,可修改、添加设备的备注名称或标签信息。

注意 编辑设备信息功能仅面向开发中的设备,如果该设备已发布,设备的所有信息将冻结,不再支持修改。