Data OpenStream API快速入门

本指南将向您展示如何订阅设备的消息，以及如何使用Eclipse Mosquitto's CLIS订阅或发布消息，将命令发送到特定的设备中。

准备工作

下载并安装Mosquitto。

获取证书

1、登录SenseCAP云平台：https://sensecap.seeed.cc

2、前往“Organization/Security Credentials”

3、点击“Create access key”会产生一对Access ID和对应的Access Key

4、点击“Organization”，获取“Organization ID”作为<OrgID>。

Organization ID

接收设备消息

下面介绍如何接收您所有设备的消息

1. 打开一个终端窗口并执行以下命令。

Shell

mosquitto_sub \
    -h sensecap-openstream.seeed.cc \
    -t '/device_sensor_data/<OrgID>/+/+/+/+' \
    -u 'org-<OrgID>' \
    -P '<Password>' \
    -I 'org-<OrgID>-quickstart' \
    -v

请将您刚获取到的Organization ID和Access Key将上面<OrgID>的和<Password>替换掉。

2. 启动设备，当设备持续发送消息时，信息的输出格式如下：

/device_sensor_data/<OrgID>/<DeviceEUI>/<Channel>/<SensorEUI>/<MeasurementID>

Shell

/device_sensor_data/521853156991/2CF7F12210400083/1/2CF7F13004700089/4097 {"value":28,"timestamp":1561370207326}
/device_sensor_data/521853156991/2CF7F12210400083/1/2CF7F13004700089/4098 {"value":69,"timestamp":1561370207326}
/device_sensor_data/521853156991/2CF7F12210400070/1/2CF7F13004900025/4100 {"value":377,"timestamp":1561370294690}
/device_sensor_data/521853156991/2CF7F12210400074/1/2CF7F1300490041C/4101 {"value":100420,"timestamp":1561371689904}

显示传感器收集的每个数据，包括设备唯一标识Device EUI，设备通道Device Channel，传感器唯一标识Sensor EUI，测量值IDMeasurement ID，测量值Measurement Value和时间戳timestamp。

订阅特定字段

将设备通道Device EUI，设备通道Device Channel，传感器唯一标识Sensor EUI，测量值ID Measurement Value替换成从上述消息列表中的特定设备的字段，以便从某个设备或某个通道获取数据。

比如订阅温湿度传感器设备ID为2CF7F12210400083，通道为1，传感器ID为2CF7F13004700089，温度物理量ID为4097的值，用Organization ID和Access Key将下面<OrgID>的和<Password>替换掉，在shell中执行命令

Shell

mosquitto_sub \
    -h sensecap-openstream.seeed.cc \
    -t '/device_sensor_data/<OrgID>/2CF7F12210400083/1/2CF7F13004700089/4097' \
    -u 'org-<OrgID>' \
    -P '<Password>' \
    -I 'org-<OrgID>-quickstart' \
    -v

执行命令的结果如下：

Shell

/device_sensor_data/521853156991/2CF7F12210400083/1/2CF7F13004700089/4097 {"value":28,"timestamp":1561373812474}