O formato de dados padrão para mensagens de dispositivos no IoT Platform é o Alink JSON. Dispositivos com recursos limitados, especificações reduzidas ou que exigem alto throughput de rede não conseguem usar dados JSON para se comunicar com o IoT Platform. Para resolver esse problema, transmita dados brutos dos dispositivos diretamente para o IoT Platform. A plataforma oferece o recurso de análise de mensagens, que converte dados entre formatos específicos do dispositivo e o formato JSON com base nos scripts enviados.
É possível analisar os seguintes tipos de mensagem:
Mensagens upstream de tópicos personalizados. Quando dispositivos enviam mensagens para a nuvem por meio de tópicos personalizados, os payloads são convertidos para dados JSON.
Mensagens TSL (Thing Specification Language) upstream e downstream. O IoT Platform converte os dados personalizados das mensagens TSL enviadas pelos dispositivos em dados Alink JSON e transforma os dados Alink JSON enviados pela plataforma em dados no formato específico do dispositivo.
Analisar mensagens enviadas para tópicos personalizados
Quando um dispositivo envia uma mensagem usando um tópico personalizado que contém a tag de análise ?_sn=default, o IoT Platform executa o script de análise de mensagens enviado no console do IoT Platform. Esse processo converte o payload da mensagem recebida, originalmente em formato personalizado, em uma estrutura JSON para processamento subsequente.
A figura a seguir ilustra o processo de análise de dados.
A figura abaixo demonstra o fluxo de envio de dados utilizando tópicos personalizados.
Para obter detalhes sobre como escrever um script de análise de dados de tópicos personalizados, consulte os tópicos a seguir:
Analisar mensagens TSL
Se um dispositivo pertencer a um produto cujo parâmetro Data Format estiver definido como Custom, o IoT Platform executará o script de análise de dados enviado durante a comunicação com a nuvem. Isso permite converter dados upstream para o formato padrão Alink JSON e dados downstream para o formato personalizado.
Ao receber uma mensagem em formato personalizado de um dispositivo, a plataforma aciona o script de análise para transformar esses dados no formato Alink JSON antes de processá-los. Antes de enviar qualquer mensagem ao dispositivo, o mesmo script converte o conteúdo do formato Alink JSON para o formato personalizado utilizado pelo equipamento.
A imagem a seguir detalha o fluxo de análise de dados.
O diagrama abaixo apresenta o envio de dados de propriedades ou eventos em modo passthrough (dados upstream).
A figura seguinte exibe o processo de chamada de serviços ou configuração de propriedades do dispositivo (dados downstream).
Consulte os tópicos abaixo para ver exemplos de escrita de scripts de análise de mensagens TSL: