立即自定义您的 ThingsX 设备状态栏

借助 ThingsX 生成物联网移动应用的强大能力，众多行业头部企业大大缩短了为客户和合作伙伴交付应用的周期，不仅如此，还能根据实际需求进行灵活的自定义配置，并实现应用的快速迭代更新。

今天我们来分享如何自定义 ThingsX 设备状态栏。通过不同的设置，状态栏可以显示设备的在线状态、信号强度、电池电量、告警状态、最近活跃时间等信息，帮助用户快速了解设备的基本运行状态。

在 ThingsX 设备列表页面，状态栏位于设备卡片的底部。

状态栏可以显示设备的以下状态：

• 在线状态文字
• 在线状态图标
• 信号强度图标
• 电池电量图标
• 告警状态图标
• 最近活跃时间

在线状态文字

可以直接设置是否显示在线状态文字，以及设备在线时的文字颜色。当设备离线时，文字显示为灰色。

在线状态图标

可以设置是否显示在线图标，并选择要显示的图标，如下图：

在图标列表中选择在线图标，如下图：

在图标列表中，每个图标的底部显示了图标名称。当我们希望由设备或用户动态改变在线图标时，可以使用在线图标属性，关联一个文字类型的设备属性，将属性值改为希望显示的图标名称。如下图：

例如：某设备支持自动切换 WiFi 或 4G 上网，当设备上线时，向平台上报以下属性，即可改变在线图标。

{    "conn_type": "wifi-1"}

此外，还可以设置在线状态图标在设备在线时的颜色。当设备离线时，图标为灰色。

信号强度图标

可以设置是否显示设备连接网络的信号强度图标，选择要显示的图标系列，并设置关联的信号强度属性，该属性的数据类型需设置为数值类型，取值范围是 0 到 100 的整数。

平台提供了常用的信号强度图标系列，可以直接选择，如下图：

每组图标系列包含了 4 个图标，根据设备的信号强度属性数值，来自动显示对应的图标，对应关系为：

• 图标 1 的信号强度范围：0-24
• 图标 2 的信号强度范围：25-49
• 图标 3 的信号强度范围：50-75
• 图标 4 的信号强度范围：75-100

例如：设备每 5 分钟上报一次当前的信号强度，如下：

{    "signal": 80}

通常，设备从通信模组读取的信号强度并不是从 0 到 100 个数值，而是根据不同模组类型，有多种信号强度指标，例如：

RSSI 全称 Received Signal Strength Indicator，中文名是接收信号强度指示，是最常用的表示 WiFi 信号强度的名称。它反映了无线设备接收到的来自接入点（AP）或其他无线设备的信号功率大小。WiFi 信号强度的 RSSI 值范围大致在 - 100dBm 至 - 20dBm 之间。

• -20dBm 至 - 30dBm：表示信号非常强。
• -30dBm 至 - 60dBm：属于较好的信号强度。
• -60dBm 至 - 80dBm：信号强度一般。
• 低于 - 80dBm：信号很弱。

CSQ 全称 Cell Signal Quality，中文名是小区信号质量，它是蜂窝网络中用来衡量手机或其他移动设备与基站之间信号质量的一个指标。CSQ 综合考虑了信号强度、信号干扰、误码率等多种因素，不仅仅反映信号的强弱，还能在一定程度上体现信号的纯净度和稳定性等整体质量情况。

一般来说，CSQ 的取值范围是 0 - 31，另外还有特殊值 99。

• 0：表示信号质量极差。
• 1 - 7：代表信号质量很差，网络连接可能极不稳定。
• 8 - 15：说明信号质量一般，能够进行基本的通信。
• 16 - 23：表示信号质量较好，设备可以较为稳定地与基站进行通信。
• 24 - 31：意味着信号质量非常好，设备与基站之间的连接稳定。
• 99：通常表示设备无法正确获取信号质量信息，可能是设备故障、网络异常或者处于特殊的测试模式等原因导致。

因此，您可以在 ThingsCloud 的消息规则中，使用属性上报预处理规则，将原始的信号强度转换为 0 到 100 个数值即可。

此外，您还可以开启使用信号图标属性，关联到一个数据类型是文本的设备属性，来动态改变状态栏上的信号强度图标，用于支持多种网络连接方式的设备。如下图：

信号图标属性的值，在图标系列的名称中选择，例如 signal-4，设备可以属性上报中通知平台，例如：

{    "signal_type": "signal-4",    "signal": 76}

电池电量图标

可以设置是否显示电池电量图标，并设置关联的以下属性：

• 电池电量属性：数据类型为数值，取值范围 0 到 100。
• 电池充电属性：数据类型为开关量，表示是否显示为正在充电的样式。

此外，还可以设置是否在电池图标右侧显示电量百分比数值。

电池电量图标会根据电量数值，自动使用以下颜色：

• 绿色：电量为 50 - 100。
• 黄色：电量为 20 - 49。
• 红色：电量为 0 - 19。

告警状态图标

设置是否显示设备的当前告警状态。

设备告警状态的相关规则，请浏览告警规则。

最近活跃时间

设置是否显示设备的最近活跃时间。

如何在 ThingsX 中浏览效果？

在编辑器完成编辑后，记得保存。接下来进入 ThingsX 的设备列表页，便可以看到最新的状态栏效果。

是不是很简单呢？快来试试吧！

物联网设备接入 ThingsCloud ，请参考 设备接入指南。