TMX Access™ 服务平台 2.6 用户指南

1 序言

本指南主要目的是使用户全面了解 TMX Access™ 服务平台。文中 “平台” 均代指 TMX Access™ 服务平台。

2 概述

平台通过其设计和部署中的模块化方式以实现物联网解决方案。平台包括以下主要组件:物联网网关(IOTGW),设备管理平台(DMP)。每个组件还可以根据服务需求进行独立部署:

  • IOTGW 处理设备通信并解释协议和数据。
  • DMP 处理设备和会话管理,数据收集,存储和上报。

根据用户的需求,每个部署可以具有各种组件和功能。通过这些组件,平台提供以下功能:

  • 证书管理
  • 型号管理
  • 设备管理
  • 命令中心
  • 数据上报
  • 设备事件
  • API 访问

3 浏览器兼容性

3.1 支持的浏览器

平台目前仅支持 Chrome 和 Firefox。

4 支持的设备

4.1 设备型号

物联网网关负责通过 TCP 或 TLS 进行设备通信。每个独特型号的设备的通信支持和应用不同的协议。物联网网关目前支持以下 ThingsMatrix 许可设备:

平台版本 设备型号 设备描述
1.x TMA01 物流追踪器 (2G,LTE)
TMA11 用于TMA01的可拆卸传感器集线器
TMX06 追踪器 (2G)
TMX07 追踪器 (LTE Cat-M)
TMM01 认证的第三方设备
2.x TMX08 追踪采集器 (Cat-M)
TMF01 广和通物联网模块 (NL668,MT910,等等)
TMY01 追踪器 (2G,Cat-M)
TMY02 追踪器 (2G,Cat-M,NB)
TMX09 追踪器 (2G)
TMY07 追踪器 (2G,Cat-M,NB)
TMY09 追踪器 (2G,Cat-M,NB)
TMY03 追踪器 (2G,Cat-M,NB)
TMY05 追踪器 (2G,Cat-M,NB)
TMX01 追踪器 (2G LTE Cat-M)
TMX02 追踪器 (2G LTE Cat-M)
TMX03 追踪器 (2G)
TMX04 追踪器 (2G LTE Cat-M)
TMX05 追踪器 (2G)
Custom MQTT 协议的第三方设备

5 服务启动

请确保您已经注册了 TMX 账户并且也已订阅 TMX Access™ 服务。请参阅 控制台 2.6 用户指南 以获取进一步信息。

6 主页

用户成功登录后,将进入 TMX Access™ 的 主页。您可以在此处查看描述物联网活动的数据报表,如下所示:

image-20210325193006215

  • 设备信息统计

    所有已导入设备的状态和型号分布饼状图。

  • 活跃设备趋势

    最近 7/30/90 天内的活跃设备趋势图。

  • 设备事件统计

    最近 30 天内触发的事件数量(包括事件代号和告警代号)。

  • 下发命令统计

    所有已创建命令的状态和型号分布饼状图。

  • 数据 Top 10

    在一段时间内(今天,昨天或最近 7 天)上报数据的前十个值(正序或倒序)。

  • 数据上报统计

    在一段时间内(今天或最近 7/30/90 天)上报数据的数量。

7 证书管理

证书管理可用于统一管理各个网络组件所需的 TLS 证书,平台支持的证书文件格式为 PEM。您可以配置证书以及服务器信任库,用于设备与平台之间建立安全链接。请点击 此处 下载您的服务器证书。

image-20210325193051073

7.1 添加新 CA 证书

进入 CA Certificates 选项页,点击 + Add Certificate 按钮,添加 CA 证书 窗口将会弹出。

image-20210325193828021

将鼠标悬浮在 Information 图标上会显示字段项描述。

image-20210326143545575

  • 关于 “注册码” 字段:您可以复制该字段值以生成验证证书。

  • 关于 “CA 证书” 字段:您可以上传一个私有的 CA 证书。

  • 关于 “验证证书” 字段:您可以上传一个使用 CA 证书对应的私钥创建的验证证书,用来证明您拥有该 CA 证书。

    • 验证证书文件仅支持 .pem 格式。

    • 下面以使用 OpenSSL 为例,介绍创建验证证书的操作步骤:

      1. 生成私钥验证证书的密钥对。

        生成密钥对的命令如下:

        openssl genrsa -out verificationCert.key 2048
        
      2. 使用上方的 “注册码” 字段值创建 CSR(证书请求文件)。

        创建 CSR 的命令如下:

         openssl req -new -key verificationCert.key -out verificationCert.csr
        

        复制上方的 “注册码” 字段值,并粘贴赋值给下方 Common Name 字段。

        ……
        Common Name (e.g. server FQDN or YOUR name) []: yourRegistrationCode****
        ……
        
      3. 使用由 CA 证书私钥签名的 CSR 创建验证证书。

        创建验证证书的命令如下:

        openssl x509 -req -in verificationCert.csr -CA yourCA.cer -CAkey yourPrivateKey.key -CAcreateserial -out verificationCert.crt -days 300 -sha512
        

7.2 查看 CA 证书

您可以通过明确 CA 证书名称与描述、或选择 CA 证书状态以筛选 CA 根证书。

image-20210325193334211

7.3 下载 CA 证书

选择一个特定的 CA 证书,点击 Download 按钮以下载 CA 根证书。

image-20210325193416737

7.4 删除 CA 证书

选择一个特定的 CA 证书,点击 Delete 按钮以删除 CA 根证书。请注意:已被设备证书关联的 CA 证书无法被删除。

image-20210325193442770

7.5 添加新设备证书

进入 Device Certificates 选项页,点击 + Add Certificate 按钮,添加设备证书 窗口将会弹出。

image-20210325193722727

将鼠标悬浮在 Information 图标上会显示字段项描述。填写完表单后,点击 Add 按钮以添加新设备证书。

image-20210325194053225

  • 关于 “设备证书” 字段:您可以上传一个设备证书。
  • 关于 “CA 证书” 字段:您可以选择一个已有的 CA 证书进行关联。

7.6 查看设备证书

您可以通过明确设备证书名称、设备证书序列号、所关联的 CA 证书以及设备证书描述,或选择设备证书状态以筛选设备证书。

image-20210325194209702

7.7 下载设备证书

选择一个特定的设备证书,点击 Download 按钮以下载设备证书。

image-20210325194232932

7.8 删除设备证书

选择一个特定的设备证书,点击 Delete 按钮以删除设备证书。请注意:仅当未被任何设备组或设备应用时,设备证书可被删除。

image-20210325194302021

8 型号管理

型号是指一系列包含相同功能、相似配置并可以执行相同命令的设备产品。在您购买缺省型号设备后,ThingsMatrix 会将这些设备对应的缺省型号预置在 型号管理 中。您还可以通过 控制台 或联系 ThingsMatrix 销售团队购买更多想要的缺省型号设备。请参阅 控制台 2.6 用户指南 以获取进一步信息。同时,平台提供自定义型号以支持对 MQTT 协议设备的创建和定制。

image-20210325194536259

TMX08 这个缺省型号为例,在下拉框选择该型号。

image-20210325194612455

中间部分会展示该型号的基础信息。

image-20210325194657419

  • 数据字段管理

    每个私有协议的型号都有它自己的数据字段,用于存储和展示遥测数据。最初它仅包含无法删除的系统字段,而自定义型号没有系统字段。您可以根据需求扩展字段。请注意:扩展字段的数据仅在数据流中进行配置和计算后才会生成。 请参阅 TMX Insight™ 服务平台 2.6 用户指南9.3 配置数据流组件 以获取进一步信息。

    image-20210325194843082

  • Topic 管理(仅限 MQTT 协议的自定义型号)

若要连接平台,MQTT 设备需要提供它的客户端 ID 作为它的序列号,并且配置好代理服务器的网址,例如,“<公司名>.gw.thingsmatrix.io”。每一个自定义型号都有用于 MQTT 设备和平台进行通信的若干个 topic。设备使用 topic 上报数据以及接收配置和命令。一些预先配置的 topic 如下所示:

image-20210325195543613

设备可以通过发布数据到 ReportEvent 的 topic 以向平台上报数据。同时,设备可以通过从ConfigCommand 的 topic 订阅数据以从平台接收数据。

  • 数据上报

    • 模式: ${model_id}/${sn}/report
    • 示例: M001234/801046012345678/report
    • 数据标签: 数据上报

    设备根据配置上报实时数据。假设设备会上报温度的实时数据,为了平台能接收和存储它的温度数据,您需要先在平台添加扩展字段,例如,temperature 作为字段的标识符。请参阅 8.4 添加新扩展数据字段 以获取有关添加扩展字段的进一步信息。温度字段创建后,MQTT 设备上报的如下数据会被记录在 报告列表

    {
        "temperature": 27.5
    }
    
    • 设备事件

      • 模式: ${model_id}/${sn}/event
      • 示例: M001234/801046012345678/event
      • 数据标签:

      为了从上报数据中将事件相关数据分离出来,我们推荐使用 Event 的 topic。假设设备会上报门状态的事件相关数据,当门被开启,门状态从 0 转为 1;当门被关闭,门状态从 1 转为 0。为了平台能接收门状态数据,您需要先在平台添加扩展字段,例如,door_status 作为字段的标识符。请参阅 8.4 添加新扩展数据字段 以获取有关添加扩展字段的进一步信息。为了触发一个事件,您需要先添加数据流,配置 topic 筛选然后创建一个事件操作。请参阅 TMX Insight™ 服务平台 2.6 用户指南9.3 配置数据流组件 以获取进一步信息。 当门被开启,MQTT 设备上报的如下数据会被发布到 Event 的 topic,然后平台会触发一个开门事件并记录在 事件列表

      {
          "door_status": 1
      }
      
  • 设备组管理

    设备组是一个逻辑组件,其中包括一组相同型号的设备。您可以管理设备的某些共同属性。仪表盘 部分用于显示在 TMX Insight™ - 仪表盘 中已配置并在 设置 中已启用仪表盘的关于该设备组的所有图表。请参阅 14 设置TMX Insight™ 服务平台 2.6 用户指南8 仪表盘 以获取进一步信息。

    image-20210325200405141

  • 配置模板管理

    每一个设备型号都有其唯一的配置文件,该文件用于定义该型号下设备的基本设置,固件版本和规则集。在设备注册和鉴权期间,配置文件将传递到物联网网关并下载到设备上。缺省情况下,一个设备组可能具有空的配置模板,这意味着该设备组的设备将应用其缺省配置。 请注意:若设备被移动到了一个没有关联配置模板的设备组,平台会给设备下发缺省配置。 而应用配置模板后,设备将会应用新的配置:更改模板后,平台主动下发新配置给在线设备并应用;离线设备下次连接平台时下发新配置并应用。请参阅 ThingsMatrix 设备手册参数表 以获取进一步信息。

    image-20210325200600497

8.1 添加新自定义型号

您可以添加新自定义型号以应用 MQTT 设备。点击右上角 + Add Model 按钮,添加型号 窗口会弹出。

image-20210325200639103

填写表单以添加新自定义型号。请注意:您还可以上传一张小于 500 KB 的设备图片。

image-20210325200746638

8.2 修改自定义型号

选择一个自定义型号,然后点击 Edit 按钮,修改型号 窗口会弹出。

image-20210325201008131

修改后,点击 Save 按钮以保存所有改动。

image-20210325201136226

8.3 删除自定义型号

选择一个自定义型号,然后点击 Delete 按钮以删除自定义型号。请注意:您必须先清空该型号下的所有设备。

image-20210325201154861

8.4 添加新扩展数据字段

选择其中一个型号,然后进入 Schema 选项页,以 SampleModel01 为例。点击左侧 + Add Schema 按钮,右侧会展示用以添加扩展数据字段的新空白表单。

image-20210325201249593

将鼠标悬浮在 Information 图标上会显示字段项描述。填写这个表单并点击右侧 Add 按钮以添加新扩展字段。请注意:如有需要,可定制自定义单位。

image-20210325201330281

关于 “配置” 字段:

  • 可存储

    • 如果勾选,平台将会存储数据字段数据值并在 报告列表 中展示。
    • 如果去勾选,数据将会进行透传,即平台将不会存储数据字段数据值,同时也不会在 报告列表 中进行展示。
  • 启用

    • 如果勾选,平台将会展示该数据字段并且可通过 API 访问。
    • 如果去勾选,平台将不会展示该数据字段,同时无法通过 API 访问。

如果用户需要一个布尔类型的数据字段,可通过设置其布尔值描述增加可读性。

image-20210325201445273

保存数据字段后,它将在 设备管理 中型号为 SampleModel01 的“上一次报告”选项页的 “最新获取报告”中进行展示,如下所示:

image-20210325201736181

*请注意:只有在 *TMX Insight™ ** 的 数据流管理 功能中配置并计算了扩展数据字段的数据后,才会生成这些数据。 如果需要多个扩展数据字段,可根据之前的说明添加更多的扩展数据字段。

8.5 查看数据字段

我们提供多种操作帮助用户查看数据字段。

  • 搜索

    您可以输入标识符或标题以搜索一个特定的数据字段。

    image-20210325201908413

  • 排序

    您可以通过拖拽 Drag 按钮以对数据字段进行排序,它将同样对 设备 - 上一次报告设备 - 报告列表 以及 报告列表 中的数据字段顺序生效。

    image-20210325202119643

8.6 修改数据字段

点击您想要修改的特定数据字段卡片,修改后,点击 Save 按钮以保存改动。请注意:“标识符” 以及 “类型” 无法被修改。

image-20210325202155486

8.7 启用数据字段

被启用数据字段的数据将会在平台进行展示,同时也可以通过 API 进行访问。点击您想要修改的特定数据字段卡片,勾选 Enable 复选框然后点击 Save 按钮,被禁用的数据字段将被启用。进行该操作后,Eye 图标将亮起。

image-20210325202215577

8.8 禁用数据字段

被禁用数据字段的数据将不在平台进行展示,并且也无法通过 API 进行访问。导出的报告文件也会排除相关数据。点击您想要修改的特定数据字段卡片,取消勾选 Enable 复选框然后点击 Save 按钮,被启用的数据字段将被禁用。进行该操作后,Eye 图标将熄灭。

image-20210325202227545

8.9 开始存储数据字段

可存储数据字段的数据将被您允许在平台上进行存储。点击您想要修改的特定数据字段卡片,勾选 Storable 复选框然后点击 Save 按钮,不可存储的数据字段将变为可存储。进行该操作后,Storage 图标将亮起。

image-20210325202242350

8.10 停止存储数据字段

不可存储数据字段的数据将不会在平台上进行存储。点击您想要修改的特定数据字段卡片,取消勾选 Storable 复选框然后点击 Save 按钮,可存储的数据字段将变为不可存储。进行该操作后,Storage 图标将熄灭。

image-20210325202309329

8.11 删除扩展数据字段

点击您想要删除的特定数据字段卡片,点击 Delete 按钮以删除扩展数据字段。请注意:系统数据字段无法被删除。对于扩展数据字段,如果它们处于正在使用中,例如该数据字段已在 TMX Insight™ 服务中进行了配置,也可被删除,同时它会在 TMX Insight™ 被标记为“非法”的数据字段。

image-20210325202457625

8.12 添加新自定义 topic

选择其中一个 MQTT 协议型号并进入 Topic 管理 选项页,以 SampleModel 为例。点击左侧 + Add Topic 按钮,右侧会展示用以添加自定义 topic 的新空白表单。将鼠标悬浮在 Information 图标上会显示字段项描述。填写这个表单并点击右侧 Add 按钮以添加新自定义 topic。请注意:当且仅当设备发布数据到数据标签为报告的 topic 时,报告 中才可查看到该数据。对于数据标签为 的 topic,平台不会存储设备发布的数据。

image-20210325203202462

8.13 修改自定义 topic

点击您想要修改的特定 topic 卡片,修改后,点击 Save 按钮以保存改动。请注意:系统 topic 无法被修改。一旦修改被确认,所有被设备发布到之前 topic 的数据将可能丢失。请务必将设备发布的 topic 切换到合法的 topic 。

image-20210325203255884

8.14 删除自定义 topic

点击您想要删除的特定 topic 卡片,点击 Delete 按钮以删除自定义 topic 。请注意:系统 topic 无法被删除。对于自定义 topic ,处于正在使用中的 topic 可以被删除,但所有被设备发布到这些 topic 的数据将可能丢失。请务必将设备发布的 topic 切换到合法的 topic 。

image-20210325203313552

8.15 添加新设备组

选择其中一个型号并进入 设备组管理 选项页,以 TMX08 为例。然后点击左侧 + Add Group 按钮,右侧会展示用以添加设备组的新空白表单。

image-20210325203432240

填写表单,然后点击 Save 按钮以创建新设备组。

  • 关于 “配置模板” 字段:您可以为新设备组分配特定的配置。请参阅 ThingsMatrix 设备手册参数表 以获取进一步信息。

    image-20210325203523837

  • 关于 “证书” 字段:出于安全目的,您可以选择所需的认证证书。(仅适用于应用 MQTT 协议的特定型号)请参阅 7 证书 以获取进一步信息。

    image-20210325203610475

8.16 编辑设备组

点击您想要修改的特定设备组卡片,修改后,点击 Save 按钮以保存改动。

image-20210325203743756

8.17 删除设备组

点击您想要删除的特定设备组卡片,点击 Delete 按钮以删除该设备组。请注意:在删除一个设备组前,您需要先清空该设备组关联的设备。

image-20210325203759793

8.18 添加新配置模板

选择其中一个型号并进入 配置模板管理 选项页,点击 + 按钮,Add Config Template 窗口会弹出。

image-20210325204009165

  • 缺省型号

    每个设备型号都有自己的配置参数设置。关于参数配置的更多信息,请参阅 ThingsMatrix 设备手册参数表 以获取进一步信息。

    以设备型号 TMY07 为例,其配置包括以下类别:“Working Mode Option”,“Periodic Mode Settings”,“Storage Mode Settings”,“Motion Static Mode Settings”,“Schedule Mode Settings”,“Master Server Settings” 和 “Firmware” 。在每个参数类别中,将鼠标悬停在其中一个参数上,将显示参数说明。每个参数都有缺省值,用户可以根据需求修改该值。可添加描述增加可读性。配置完成后,点击 Add 按钮以创建新配置模板。

    image-20210325204119670

  • 自定义型号

    您可以上传一个 JSON 格式的配置文件以添加新模板。输入名称和必要的描述,然后点击 Save 按钮以创建新配置模板。

    image-20210325204237105

8.19 修改配置模板

选择一个特定的配置模板,点击 Edit 按钮,Edit Config Template 窗口会弹出。

image-20210325204526929

  • 缺省型号

    修改参数值后,点击 Submit 按钮以应用新改动。如果模板已经关联到设备组,一旦配置发生改动,平台将主动下发新配置给相关设备组的在线设备并应用;离线设备下次连接平台时下发新配置并应用。该改动将应用于相关设备组中的所有主设备。

    image-20210325204401266

  • 自定义型号

    您可以上传一个 JSON 格式的配置文件以修改模板。点击 Submit 按钮以创建新配置模板。

    image-20210325204458098

8.20 复制配置模板

选择一个特定的配置模板,点击 Copy 按钮,Copy Config Template 窗口会弹出。

  • 缺省型号

    新的配置模板和您选择的配置模板是完全一致的。为这个配置输入新的名称和描述,然后点击 Copy 按钮以创建一个新的模板。您也可以在创建新模板的过程中对其中一些配置参数设置进行改动。

    image-20210325204545692

    image-20210325204618402

  • 自定义型号

    新的配置模板和您选择的配置模板是完全一致的。为这个配置输入新的名称和描述,然后点击 Copy 按钮以创建一个新的模板。您也可以通过上传一个新的 JSON 格式的配置文件以创建新模板。

    image-20210325204641617

8.21 删除配置模板

选择一个特定的配置模板,点击 Delete 按钮以删除模板。请注意:仅当未被任何设备组应用时,配置模板可被删除。

  • 缺省型号 image-20210325204924140

  • 自定义型号 image-20210325204853213

9 设备管理

为更好地展示设备信息、地理位置和上报数据,平台提供以下两种视图(默认进入列表视图):

  • 列表视图:请点击 List 按钮以进入列表视图。

    您可以获取详细的设备信息和设备收集的数据。平台提供对上报数据进行的统计,您可以更好的理解数据趋势。所有已添加设备的信息如下所示:

    image-20210326102303825

    从列表中,您可以看到以下设备基础信息:

    • Serial Number:每个设备都具有一个唯一的序列号以用于识别。

    • Alias:设备别名。

    • Model:设备型号名称。

    • PID:设备产品 ID,用以代表包含相同的主要组件的设备。

    • Group:设备所属的设备组名称。

    • Status:设备的不同工作状态如下所示:

      • 当设备刚被 ThingsMatrix 导入但尚未连接到平台时,它将显示为 Inactive
      • 当设备连接到平台时,它将显示为 Online
      • 当设备进入睡眠模式时,它将显示为 Standby
      • 当设备一段时间不工作时(根据您的计时器设置),它将显示为 Offline
      • 当设备被用户禁用时,它将显示为 Disabled
      • 当设备的所属公司发生变化时(当前不属于您的公司),它将显示为 Suspended
      • 当设备处于追踪模式时,它将显示为 Tracking
    • State:平台有 4 种状态以指示设备属性:

      • 第一个图标像个电池,如果亮起,它显示设备最近一次上报的电池剩余电量;如果未亮,则表示平台未收到设备电池的电量数据。
      • 第二个图标像个插头,如果亮起,它表示设备正在接入外部电源;如果未亮,则表示平台未收到设备外部电源的数据。
      • 第三个图标像个手机信号塔或者卫星,用以表示定位功能。如果手机信号塔图标亮起,则表示设备最近一次上报的是 LBS 定位的位置数据;而如果卫星图标亮起,则表示设备最近一次上报的是 GPS 定位的位置数据;如果未亮,则表示平台未收到合法的定位数据。
      • 第四个图标像个警示牌,如果图标亮起,则表示设备最近一次上报的数据触发了告警;如果未亮,则表示设备最近一次上报的数据未触发告警。

      除了基础信息,列表中也有上报的数据,几乎所有的表头是由数据字段决定的。请注意:禁用的数据字段以及数据不会被显示。 当设备报告新的有效的数据到平台,列表中最近一次上报数据会自动刷新,保括在线状态、模式状态和确认启用的数据字段值。如果设备未上报新的数据,对应的最近一次上报数据将维持不变。请参阅 9.8 查看设备详细信息 以获取进一步信息。

  • 地图视图:请点击 Map 按钮以进入地图视图。

    用户可以更清晰地看到设备的地理位置信息,简要的设备信息和最近一次上报数据。所有已连接设备的位置如下所示:

    image-20210325205506210

    为更好地进行搜索和筛选,平台提供以下两种模式(默认进入筛选模式):

    • 筛选模式:请点击 Filter 按钮以进入筛选模式。

      您可以通过选择设备型号名称、设备组名称或设备状态以筛选设备。

      image-20210325205708099

      配置一个数据字段后,对应的数据会在右侧列表中和设备位置点上展示。如果对应的数据尚未生成,它会显示为 “--” 。

      image-20210325205759552

      正如刚才提到的,右侧设备列表会展示可视区域内设备的更详细的信息,包括别名、序列号、型号名称、产品 ID、设备组名称、定位类型、详细地址和对应的设备数据(若已配置数据字段)。请点击设备的序列号以前往设备详情页面查看更多信息。

      image-20210325205824972

      当设备在线时,通过点击 ResetRestart 按钮,您可以快捷地重置或重启一个特定的设备。

      image-20210325205914193

    • 搜索模式:请点击 Magnifier 按钮以进入搜索模式。

      image-20210325205927536

      您可以输入至少 3 位序列号并选择想要的序列号,然后点击 Search 按钮以定位到特定的设备。

      image-20210325210026016

      为更方便地固定地图展示的中心位置,您可以在地图上配置一个目标点,则每次进入地图视图后,地图会以目标点为中心进行展示。在地图上,右键点击想要设置为目标点的位置,然后点击 Targeting Point Setting 按钮,该位置将被配置为目标点。

      image-20210325210102112

      右键点击已存在的目标点以删除它,或右键点击其他位置以重设新的目标点。

      image-20210325210159186

      如果设备上报了新的位置数据,设备统计和地图上对应的位置将自动刷新。

9.1 添加新自定义型号设备

在添加新自定义型号设备之前,您需要先创建一个设备组。有关更多信息,请参阅 8.15 添加新设备组 以获取进一步信息。请注意:仅自定义型号设备可通过此方式进行手动添加。所有已购缺省型号设备会由 ThingsMatrix 自动导入到平台上对应型号的缺省设备组。比如,所有 TMX08 型号的设备会被导入到 TMX08_DG 设备组。

创建自定义型号设备组后,前往 设备管理 ,点击右上方的 + Add Device 按钮,Add Device 窗口会弹出。

image-20210326103127996

填写表单,然后点击 Add 按钮以添加新设备。对于 “SIM ICCID” 字段,您可以选择提供或不提供相应的信息,因为平台会自动收集此类信息。如果 Allow for connection after it has changed 勾选框被勾选,则允许该平台在最初填充 SIM 信息后再做额外更新,例如更换 SIM 卡。否则,在最初填充信息后更换 SIM 卡,平台将拒绝与设备的连接。对于您还可以向设备分配别名、添加标签和自定义属性。

image-20210326103431983

您可以看到新添加的设备。

image-20210326103513234

9.2 导入新自定义型号设备

平台提供设备导入功能。点击 Import 按钮,Import 窗口会弹出。请注意:仅可以导入新的自定义型号设备。每次导入最多5000个设备。

image-20210326103642682

选择 CSV or Excel 格式,然后点击 Download 按钮,对应的设备信息导入模板将请求被下载(如果您已经下载过导入模板,您可以跳过这个步骤)。

image-20210326103753209

下载设备信息导入模板后,您可以填写表单。

这些是模板中的字段:

  • “SerialNumber”,“Group” 和 “Model” 是必填字段:

    • SerialNumber:每个设备具有一个唯一的序列号用于识别。
    • Group:设备所属的设备组名称。设备组必须预先存在系统中,并且和型号有对应关系。否则,请先在系统中新建一个设备组。
    • Model:设备型号名称。
  • 其余的是选填字段:

    • 别名:必须为 1 到 40 位字符,特殊字符仅包括 “_” 和 “-” 。
    • SimICCID:必须为 20 位数字。
    • SimAutoUpdate: “0” 表示非自动更新, “1” 表示自动更新。缺省是自动更新,空白即为缺省。
    • Description:不超过 256 位字符。
    • Tags:必须为 1 到 50 位的字符,包括数字 0 到 9 ,字母 a 到 z 和 A 到 Z ,字符 “-” 、 “.” 、“_”、 “@” 、 “$” 和空格。单个设备的标签数量不能超过20个,并且使用 “,” 分开。
    • Attribute:属性是在表头填写的,例如 “attribute:xx” ,这意味着添加名称为 “xx” 的属性。必须为1到50位字符,包括数字 0 到 9 ,字母 a 到 z 和 A 到 Z ,字符 “-” 、 “.” 、“_”、 “@” 、 “$” 和空格。
  • 示例:

    SerialNumber Alias Group Model Sim ICCID Description Tags Attribute.Address
    861901268000009 tmx07_0009 tmx07_20m TMX07 Device 1 San Antonio, Atlanta 9442 North Capital of Texas Hwy
    801046031113285 tmx08_3285 tmx08_2h TMX08 Device 2 San Antonio, Atlanta 9445 North Capital of Texas Hwy
    801046031097369 tmx08_7369 tmx08_1h TMX08 Device 3 San Antonio, Atlanta 9442 North Capital of Texas Hwy

然后点击 Upload File 按钮以选择文件,点击 Import 按钮以上传文件并导入设备。如果在导入过程中出错,错误详情会在导入日志栏中显示。导入操作将中止,对设备列表不产生影响。

9.3 导出设备

您可以通过点击右上方的 Export 按钮以导出设备。Export 窗口会弹出,然后您可以选择以 ExcelCSV 格式导出设备列表。

image-20210326103959746

9.4 修改设备

选择一个设备,点击 Action 按钮然后再点击 Edit 按钮,Edit Device 窗口会弹出。请注意:处于 “Suspended” 状态的设备无法被修改

image-20210326104124715

完成设备修改后,点击 Submit 按钮以保存对设备的改动。

image-20210326104201663

9.5 批量修改设备信息

平台提供两种方式以批量修改设备信息,如下所示:

  • 通过勾选(适用于不超过 100 台设备的小批次并且仅对设备信息做少量改动):

    要勾选大量设备,需要对页面大小进行配置。然后您就可以在一个页面选择这些特定设备,点击 Action 按钮然后再点击 Edit 按钮,Batch Edit Device Info 窗口会弹出。

    image-20210326104250217

    完成修改后,点击 Submit 按钮以保存对所选设备的改动。请注意:需要勾选 Modify 勾选框以应用对应的改动。

    image-20210326104414546

  • 通过文件(适用于超过 100 台设备的更大批次,或对设备信息做大量改动):

    点击 Batch Edit Device Info 按钮,Batch Edit Device Info 窗口会弹出。 请注意:仅已添加设备可被修改。一次最多批量修改 5000 台设备。

image-20210326105205500

选择 CSV or Excel 格式,然后点击 Download 按钮,对应的设备信息修改模板将请求被下载(如果您已经下载过修改模板,您可以跳过这个步骤)。

image-20210326105226693

下载设备信息修改模板后,您可以填写表单。请参阅 9.2 导入新自定义型号设备 以获取进一步信息。

然后点击 Upload File 按钮以选择文件,点击 Import 按钮以上传文件并批量修改设备信息。如果在修改过程中出错,错误详情会在导入日志栏中显示。修改操作将中止,对设备列表不产生影响。

9.6 删除设备

选择一个设备,点击 Action 按钮然后再点击 Delete 按钮以删除设备。请注意:仅处于 “Disabled”、“Inactive”和 “Suspended” 设备可以被移除。如果您无意间删掉了缺省型号设备,请尽快联系 ThingsMatrix 协助添加到平台。关于自定义型号设备,您可以根据 9.1 添加新自定义型号设备 的说明手动将其添加回来。

image-20210326105623863

9.7 给设备下发命令

选择设备,通过点击 Command 按钮,您可以对设备下发命令,例如启用、禁用、重新启动和重置设备。某些设备型号会支持其他的一些操作,例如快照和追踪,等等。然而,如果一个命令项是灰色的,它表示该设备在当前状态暂时不支持执行此命令。

以下所示列出可以执行的命令:

  • Enable/Disable 按钮可以帮助您根据需求激活和禁用设备(在当前版本,禁用命令暂时是不可用的)。
  • Restart 按钮允许您远程重新启动在线的设备。
  • Reset 按钮可以帮助您重置设备。
  • Snapshot 按钮可用于快照设备,即让设备立即上报一次带传感器数据的实时位置信息。
  • Track 按钮允许您在一段时间内追踪设备。

image-20210326105818886

请注意:您也可以选择多个设备,然后点击 Command 按钮以批量对设备下发命令。

image-20210326105909686

设备详情页面也可以下发命令。点击 Command 按钮并选择一个命令以执行。

image-20210326110114999

目前平台支持以下命令:

  • 禁用设备(在当前版本,禁用命令暂时是不可用的)

    被禁用的设备无法连接平台。点击 Disable 按钮,所选设备将被禁用。

  • 启用设备

    只有被启用的设备才可以连接平台。点击 Enable 按钮,所选设备将被启用。

  • 重新启动设备

    您可以通过单击 Restart 按钮以重新启动在线的设备。

  • 重置设备

    您可重置设备,使它恢复出厂设置。请点击 Reset 按钮以重置设备。

  • 快照设备

    点击 Snapshot 按钮以快照设备。请注意:快照命令不会影响设备的任何工作计时器。

  • 追踪设备

    点击 Track 按钮, Tracking Setting 窗口会弹出。

    填写追踪时间间隔和截止时间,然后点击 OK 按钮以追踪设备。例如,您希望在一小时内追踪设备,并要求设备每10秒报告一次位置信息。

    如果设备仍旧在线,它会将状态从 Online 转为 tracking。将鼠标悬浮到 闹钟 图标上方,会显示追踪配置。

    当追踪设备时,您仍旧可以下发以下命令,比如重启、重置、快照、停止追踪设备。

    请注意:追踪不会影响设备的任何工作计时器,但是会影响设备的工作时间,即延长设备的工作时间。 例如,设置设备为每小时唤醒一次报告数据。假设设备将在15:00:00唤醒,并且在30秒后它将进入睡眠状态。您在15:00:10下发 “Tracking” 命令,将时间间隔设置为10秒,到期时间设置为150秒。然后,追踪操作会立即生效,设备将在接下来的150秒内每10秒报告一次数据。此后,由于设备的工作计时器原因,该设备将终止 “Track” 命令并保持工作20秒——正常情况下,设备每小时应该总共在线30秒。并且后续的报告间隔将与执行 “Track” 命令之前的间隔相同,不会发生变化。

9.8 查看设备详细信息

当您选择其中一个已添加的设备时,页面的下半部分将显示该设备更多的详细信息:

  • 最新数据
  • 统计
  • 数据上报
  • 仪表盘
  • 设备事件
  • 操作日志

image-20210326110416963

点击右侧的 Full Screen 按钮,将进入设备详情页面。

image-20210326110452152

  1. 最新数据 它向所有用户显示设备的基本信息,包括序列号、别名、型号名称、设备组名称、证书名称(仅 MQTT 自定义型号)、描述、SIM 卡标示号、批次、标签和自定义属性。您也可以在 最新上报数据 部分获取设备上报的最新数据,还可以在 位置 部分查看设备的地理位置信息。请注意:最新上报数据 的数据字段顺序可以在 型号管理 进行管理。 如果设备上报了新的数据,此部分的数据将会自动刷新。

    image-20210326110505250

  2. 统计 您可以通过配置时间范围、数据字段标题或统计颗粒度以获得详细的数据上报曲线和数据统计曲线。轨迹 部分记录并展示设备的移动轨迹。通过选择一个想要查询的数据字段标题,例如 “Signal Strength",地图上将展示历史数据。您可以在 所有LBSGPS 之间进行切换以筛选不同定位模式上报的数据。历史数据图表在设备把新的数据上报到平台后将自动刷新。

    image-20210326110551655

  3. 数据上报

    您可以查看设备上报记录。点击 Export 按钮以导出筛选后的上报记录。请注意:数据字段的顺序可以在 型号管理 进行管理。

    image-20210326110649043

  4. 仪表盘

    您可以查看在 TMX Insight™ - 仪表盘 中已配置并在 设置 中已启用仪表盘的该设备的所有图表。请参阅 TMX Insight™ 服务平台用户指南 - 8 仪表盘14 设置 以获取进一步信息。

    image-20210326111019697

  5. 设备事件

    您可以查看设备事件记录。为更好的理解,平台提供以下两种视图(默认进入表格视图):

    • 表格视图:请点击 Table View 按钮以进入表格视图。

      您可以配置时间范围、事件名称(包括事件代号和告警代号)、级别和状态以筛选设备事件记录。

      image-20210326111033267

    • 图表视图:请点击 Chart View 按钮以进入图表视图。

      设备事件记录将会以图表形式进行展示。顶部的滚动条可以帮助您明确时间范围。您也可以配置时间范围、事件名称(包括事件代号和告警代号)、级别和状态以得到一个更具体的事件图表。

      image-20210326111044350

  6. 操作日志

    您可以查看设备的操作记录,即用户或平台对设备的操作日志。您可以配置时间范围、字段名称、描述、操作类型和操作者以筛选操作日志。

    image-20210326111107071

9.9 修改设备列表表头

列表 视图中,点击 Edit Headers 按钮,Edit Headers 窗口会弹出。

image-20210326111121113

您可以选择想要显示或者隐藏的表头。通过点击 Left/Right 按钮以移动字段到 显示表头 部分或 隐藏表头 部分。

image-20210326120015917

您还可以通过点击 Up/Down 按钮以自定义显示表头的顺序。

image-20210326120100091

完成修改后,点击 Submit 按钮使其生效。

10 命令中心

平台为设备命令管理提供了命令中心。您可以看到命令记录,如下所示:

image-20210325210752516

10.1 添加新命令

点击右上方的 + Add Command 按钮, Add Command 窗口会弹出。

image-20210325210826881

若要添加一个新命令,您需要完成三个步骤:

  • 第一步:命令和设备

    请输入命令别名,添加描述并且选择需要执行命令的设备。您可以通过输入至少 1 位设备序列号以搜索设备。您还可以通过型号名称、设备组名称和设备状态筛选出特定的设备。

    image-20210325210826881

    如果需要取消选择一个已选设备,点击设备右上方的 Delete 按钮以将其从已选设备列表移除。

    image-20210325210917791

    通过点击 Clear All 按钮,已选设备列表将被清空。

    image-20210325210937457

    填写完第一步的表单后,点击 Next 按钮以进入第二步。

  • 第二步:配置

    您可以通过已选设备列表确认设备选择是否正确。确认过后,您必须选择已选设备型号均通用支持的命令类型中的其中一个命令,并且仅能选择一种命令。将鼠标悬浮在命令类型右上方的 Information 图标上,会显示命令描述。让我们选择 restart 类命令进行举例,如下所示:

    image-20210325211018736

    在完成选择后,点击 Next 按钮以进入第三步。

  • 第三步:参数和策略

    填写表单,然后点击 Add 按钮以添加新命令。关于执行策略,您可以选择多个状态、信号强度范围和电池条件以决定需要执行该命令的设备。平台支持直接或按计划时间执行命令。关于重试策略,您可以配置超时时长、重试次数和重试间隔。请注意:超时时长的值指的是单个设备执行命令的整个超时时长。换言之,如果命令执行超过超时时长,该命令会被标记为 failed。所有的重试都在超时时长期间内执行。

    image-20210325211110303

10.2 收藏命令

通过点击 Favorite 按钮,特定的命令会被收藏,也就是说,它会显示在命令列表最顶部。您可以通过收藏命令以快速找到它。

image-20210325211226805

10.3 取消收藏命令

通过点击 Cancel Favorite 按钮,特定的命令会被移出收藏列表。

image-20210325211153649

10.4 查看命令

您可以通过输入设备序列号、设备别名或命令别名以查找命令。您也可以通过选择一个特定时间以筛选命令,筛选结果会显示一个命令列表,这个所选的特定时间都在它们的起始时间和结束时间之间。平台还提供了命令状态筛选功能。将 Favorite 图标打勾,筛选结果会显示已收藏的命令列表。

image-20210325211321760

选择一个特定命令,它的详情会在底部部分显示,如下所示:

image-20210325211348702

进入 目标设备 选项页以查看详细的设备命令执行情况。

image-20210325211422912

10.5 复制命令

点击 Copy 按钮,Copy Command 窗口会弹出。按照 10.1 添加新命令 的说明以复制命令,在提交前,您还可以根据需求做些修改以添加符合要求的命令。

image-20210325211458351

10.6 重试命令

选择一个命令,然后点击 Retry 按钮以重试特定命令的执行。

image-20210325211512002

若要重试一个特定设备的命令,您可以选择一个命令,进入 目标设备 选项页,选择想要重试命令的设备然后点击 Retry 按钮。

image-20210325211531663

10.7 取消命令

选择一个命令,然后点击 Cancel 按钮以取消特定命令的执行。

image-20210325211546594

若要取消一个特定设备的命令,您可以选择一个命令,进入 目标设备 选项页,选择想要取消命令的设备然后点击 Cancel 按钮。

image-20210325211600991

10.8 导出命令

选择一个命令,进入 目标设备 选项页,然后点击 Export 按钮以导出特定的命令记录。

image-20210325211622544

Export 窗口会弹出,您可以选择以 ExcelCSV 格式导出命令记录。

11 数据上报

您可以获取详细的数据上报记录。

image-20210325212243554

11.1 查看数据上报记录

TMX08 为例,选择 TMX08 设备型号。

image-20210325212314032

TMX08 设备的所有上报记录将被展示。您可以通过明确设备序列号、选择时间范围和设备组以筛选记录。 请注意:字段的顺序可以在 资产管理 - 设备管理 - 描述 进行管理。

image-20210325212353520

11.2 导出数据上报记录

您可以通过点击右上方的 Export 按钮以导出上报记录。Export 窗口会弹出,然后您可以选择以 ExcelCSV 格式导出报告记录。

image-20210325212407072

12 设备事件

您可以获取详细的设备事件记录。

image-20210325212630851

12.1 查看设备事件记录

所有的设备事件记录将被展示。为更好的理解,平台提供以下两种视图(默认进入表格视图):

  • 表格视图:请点击 Table View 按钮以进入表格视图。

    image-20210325212823567

    您可以配置序列号、时间范围、型号名称、设备组名称、事件名称(包括事件代号和告警代号)、级别和状态以筛选设备事件记录。

    image-20210325212804270

  • 图表视图:请点击 Chart View 按钮以进入图表视图。

    image-20210325212851504

    设备事件记录将会以图表形式进行展示。顶部的滚动条可以帮助您明确时间范围。您也可以配置序列号、时间范围、型号名称、设备组名称、事件名称(包括事件代号和告警代号)、级别和状态以得到一个更具体的事件图表。

    image-20210325212901548

12.2 导出设备事件记录

您可以通过点击右上方的 Export 按钮以导出设备事件记录。Export 窗口会弹出,然后您可以选择以 ExcelCSV 格式导出设备事件记录。

image-20210325212922910

13 API 访问

平台为外部用户和系统提供北向 API 服务。请参阅 TMX Access™ 服务平台 2.6 API 指南 以获取更详细的技术信息。请参阅 控制台 2.6 用户指南 - 10 API 应用程序 以获取有关 API 访问控制的进一步信息。

14 设置

您可以点击 Edit 按钮设置地图显示类型。您还可以启用/禁用仪表盘展示。您可以选择将特定的仪表盘显示在 设备管理型号管理TMX Insight™ - Bucket 部分。然后点击 Save 按钮以保存改动。

image-20210325213525489

image-20210325213359856

通过点击仪表盘名称,您可以直接去到仪表盘详情页。

image-20210325213428899

点击 Restore Default 按钮以返回初始状态。

image-20210325213505087

您可以为公司中的其他用户预先设置通用的公司设置模板。如果有需求,其他用户可以具有自己的个人常规设置。

  • 公司管理员
  1. 个人偏好设置

    image-20210325213708705

  2. 公司缺省设置

    image-20210325213734821

  • 其他用户

    仅可以进行个人偏好设置

    image-20210325214148495

15 操作日志

您可以查看公司成员执行操作的操作日志。

image-20210325214510483

您可以通过选择目标类型、操作类型、操作者以搜索操作日志。您也可以通过配置特定的时间范围和输入目标对象、字段名称或描述以筛选操作日志。

image-20210325214716607

16 通知中心

平台提供通知中心以展示通知和消息,例如,服务升级计划和超频或超限 SMS、URL、Email 的警告。右上角的 Ring 按钮旁若有一个红点,表示通知中心存在数条未读消息。

image-20210325214947134

点击 Ring 按钮,Notification Board 会弹出,它显示所有的通知和消息。您可以通过选择一个想要的通知类型以筛选通知。

image-20210325215005838

点击未读消息以阅读详细内容。请注意:带红点的消息表示未读。

点击 Confirm 按钮以确认接收消息。

image-20210326120700549

Last updated: 2021/5/17 下午3:26:04