As Informações de Conexão
- Host: Estação da China: sensecap-openstream.seeed.cn Estação Global: sensecap-openstream.seeed.cc
- Porta: 1883 para MQTT, ou 8083 para MQTT sobre WebSocket
- ClientID: org-<Organization ID>-<Random ID>, substitua <Orgnization ID> pelo que você obteve no SenseCAP Portal e substitua <Random ID> por números gerados aleatoriamente e letras minúsculas.
- Nome de usuário: org-<Organization ID>, substitua <Organization ID> pelo que você obteve no dashboard (consulte o guia de início rápido).
- Senha: obtenha chaves de acesso à API no seu SenseCAP Portal em “security /API Access Key” (consulte o guia de início rápido).
Modelo de Publicação e Assinatura
SenseCAP OpenStream API implementa o “Modelo de Publicação e Assinatura”, assim como o protocolo MQTT. Você pode conectar seu servidor à SenseCAP OpenStream API por meio de MQTT ou MQTT sobre WebSocket para se comunicar com o protocolo padrão pub-sub.Você pode “assinar” para receber mensagens. “assinar” é a forma mais comum de monitorar continuamente os dados de telemetria dos dispositivos.
Tópico da Mensagem
Receber Dados de Telemensuração do Dispositivo
Formato do tópico: /device_sensor_data/<OrgID>/<DeviceEUI>/<Channel>/<Reserved>/<MeasurementID>| Campo | Descrição |
|---|---|
| OrgID | Seu “Organization ID”, você pode encontrá-lo no SenseCAP Portal. Você possui um Organization ID exclusivo e todos os tópicos precisarão dele. |
| DeviceEUI | Identificação exclusiva do dispositivo |
| Channel | Um conector físico no dispositivo ao qual um sensor é conectado |
| Reserved | Reservado |
| MeasurementID | Consulte “Lista de Measurement IDs” nesta documentação |
Nota: “+” significa que não há condição de filtragem para este campo, correspondendo a todas as configurações possíveis. Portanto, “/+/+/+/+” significa escutar todos os “<DeviceEUI>”, “<Channel>”, “<SensorEUI>”, “<MeasurementID>”
O tópico pode especificar condições de filtragem para implementar a escuta em dispositivos, canais e tipos de medição especificados. Por exemplo, você pode apenas escutar o dispositivo cujo ID de dispositivo é “2F000000000000”, então você pode substituir o campo <DeviceEUI> por 2F000000000000.O “2F000000000000” neste exemplo deve ser um dispositivo que você já vinculou à sua conta. E você deve sempre se lembrar de substituir <OrgID> pelo seu próprio “Organization ID”.
Corpo da Mensagem
{
"value": "437",
"timestamp": "1544151922137"
}
Este é um dado de medição de sensor enviado por um dispositivo, que está em conformidade com o formato JSON e pode ser analisado por um parser JSON. Em geral, para a maioria dos requisitos funcionais, é necessário usar um corpo em conjunto com alguns campos no tópico.
| Campo | Descrição |
|---|---|
| value | Valor de Medição do Sensor |
| timestamp | Timestamp de coleta dos dados, unidade milissegundo |
Receber Dados de Status do Dispositivo
Formato do tópico: /device_status_event/<OrgID>/<DeviceEUI>/<Reserved>/<StatusID>| Campo | Descrição |
|---|---|
| OrgID | Seu “Organization ID”, você pode encontrá-lo no SenseCAP Portal. Você possui um Organization ID exclusivo e todos os tópicos precisarão dele. |
| DeviceEUI | Identificação exclusiva do dispositivo |
| Reserved | Reservado |
| StatusID | Consulte “Lista de Device Status IDs” nesta documentação |
Assine o StatusID necessário de acordo com a lista de IDs de estado do dispositivo para evitar assinar IDs inesperados
Corpo da Mensagem
{
"value": "437",
"timestamp": "1544151922137"
}
| Campo | Descrição |
|---|---|
| value | Valor de Status do Sensor |
| timestamp | Timestamp de coleta dos dados, unidade milissegundo |