La Información de Conexión
- Host: Estación China: sensecap-openstream.seeed.cn Estación Global: sensecap-openstream.seeed.cc
- Puerto: 1883 para MQTT, o 8083 para MQTT sobre WebSocket
- ClientID: org-<ID de Organización>-<ID Aleatorio>, reemplaza <ID de Organización> con el que obtuviste del Portal SenseCAP, y reemplaza <ID Aleatorio> con números y letras minúsculas generados aleatoriamente.
- Nombre de usuario: org-<ID de Organización>, reemplaza <ID de Organización> con el que obtuviste del panel de control (consulta el inicio rápido).
- Contraseña: Obtén las claves de API de acceso en tu Portal SenseCAP "seguridad /Clave de Acceso API" (consulta el inicio rápido).
Modelo de Publicación y Suscripción
La API OpenStream de SenseCAP implementa el "Modelo de Publicación y Suscripción", como lo hace el protocolo MQTT. Puedes conectar tu servidor a la API OpenStream de SenseCAP a través de MQTT o MQTT sobre WebSocket para comunicarte con el protocolo estándar pub-sub.Puedes "suscribirte" para recibir mensajes. "suscribirse" es la forma más común de monitorear continuamente los datos de telemetría de los dispositivos.
Tema del Mensaje
Recibir Datos de Telemedición del Dispositivo
Formato del Tema: /device_sensor_data/<OrgID>/<DeviceEUI>/<Channel>/<Reserved>/<MeasurementID>| Campo | Descripción |
|---|---|
| OrgID | Tu "ID de Organización", puedes encontrar esto en el Portal SenseCAP. Posees un ID de Organización único, y todos los temas lo necesitarán. |
| DeviceEUI | Identificación única del dispositivo |
| Channel | Un socket físico en el dispositivo para que se conecte un sensor |
| Reserved | Reservado |
| MeasurementID | Por favor consulta "Lista de IDs de Medición" en esta documentación |
Nota: "+" significa que no hay condición de filtrado para este campo, coincidiendo con todas las configuraciones posibles. Entonces, "/+/+/+/+" significa escuchar todos los "<DeviceEUI>", "<Channel>", "<SensorEUI>", "<MeasurementID>"
El tema puede especificar condiciones de filtrado para implementar la escucha en dispositivos, canales y tipos de medición especificados. Por ejemplo, puedes escuchar solo el Dispositivo cuyo ID de dispositivo es "2F000000000000", entonces puedes reemplazar el campo <DeviceEUI> con 2F000000000000.El "2F000000000000" en este ejemplo debe ser un dispositivo que ya hayas vinculado a tu cuenta. Y siempre debes recordar reemplazar <OrgID> con tu propio "ID de Organización".
Cuerpo del Mensaje
{
"value": "437",
"timestamp": "1544151922137"
}
Estos son datos de medición de sensor subidos por un dispositivo, que se ajustan al formato JSON y pueden ser analizados por un analizador JSON. En general, para la mayoría de los requisitos funcionales, un cuerpo necesita ser usado en conjunto con algunos campos en el tema.
| Campo | Descripción |
|---|---|
| value | Valor de Medición del Sensor |
| timestamp | La marca de tiempo de recolección de los datos, unidad milisegundo |
Recibir Datos de Estado del Dispositivo
Formato del Tema: /device_status_event/<OrgID>/<DeviceEUI>/<Reserved>/<StatusID>| Campo | Descripción |
|---|---|
| OrgID | Tu "ID de Organización", puedes encontrar esto en el Portal SenseCAP. Posees un ID de Organización único, y todos los temas lo necesitarán. |
| DeviceEUI | Identificación única del dispositivo |
| Reserved | Reservado |
| StatusID | Por favor consulta "Lista de IDs de Estado del Dispositivo" en esta documentación |
Suscríbete al StatusID requerido según la lista de IDs de estado del dispositivo para evitar suscribirte a IDs inesperados
Cuerpo del Mensaje
{
"value": "437",
"timestamp": "1544151922137"
}
| Campo | Descripción |
|---|---|
| value | Valor de Estado del Sensor |
| timestamp | La marca de tiempo de recolección de los datos, unidad milisegundo |