IoT Platform:Perguntas frequentes sobre modelos TSL

Adicionar recursos do modelo TSL

Adicione e configure as propriedades, os eventos e os serviços de um modelo TSL no produto que contém o dispositivo. Defina um modelo TSL das seguintes formas:

• Chame a API CreateThingModel para adicionar recursos do modelo TSL a um produto específico.

• Adicione recursos do modelo TSL no console do IoT Platform. Para mais informações, consulte Adicionar um único modelo TSL e Adicionar modelos TSL em lote.

Falha na verificação do TSL durante importação em lote

Diferenças nos métodos de relatório de dados

Dados TSL não atualizados com tópico personalizado

Reporte os dados do modelo TSL do dispositivo usando um tópico de comunicação do modelo TSL. Para mais informações, consulte Categorias de tópicos e comunicação.

Recuperar dados do modelo TSL

Recupere dados do modelo TSL do dispositivo das seguintes maneiras:

• Assinatura do lado do servidor: Use o recurso de assinatura do lado do servidor do IoT Platform para assinar mensagens de Device Upstream Notification. O IoT Platform encaminha essas mensagens de todos os dispositivos do produto para o seu servidor com base nas configurações de assinatura. Há suporte para dois métodos de assinatura do lado do servidor:

  • Assinatura do lado do servidor AMQP: Use um SDK AMQP para receber mensagens de dispositivos encaminhadas pelo IoT Platform.

  • Assinatura do lado do servidor do Message Service (MNS): Use o SDK do Simple Message Queue (formerly MNS) para receber mensagens de dispositivos que o IoT Platform encaminha para o Simple Message Queue (formerly MNS).

• Encaminhamento de Dados: Use o recurso de Encaminhamento de Dados do mecanismo de regras para criar regras que encaminhem dados específicos do dispositivo para outros serviços de nuvem, como Simple Message Queue (formerly MNS), ApsaraDB for RDS, Tablestore, Function Compute, Time Series Database (TSDB), Lindorm, DataHub e Message Queue for Apache RocketMQ. Para mais informações, consulte Encaminhamento de Dados (Legado) e Encaminhamento de Dados (Novo).

• APIs da Nuvem:

  API	Descrição
  QueryDevicePropertyStatus	Consulta todos os snapshots de propriedades de um dispositivo especificado.
  QueryDeviceOriginalPropertyStatus	Consulta os snapshots originais de propriedades reportados por um dispositivo especificado. Inclui todas as propriedades, independentemente de terem passado pela verificação do modelo TSL.
  QueryDeviceOriginalPropertyData	Consulta os registros originais de propriedades reportados por um dispositivo especificado. Inclui todas as propriedades, independentemente de terem passado pela verificação do modelo TSL.
  QueryDeviceOriginalEventData	Consulta os registros originais de eventos reportados por um dispositivo especificado. Inclui todos os eventos, independentemente de terem passado pela verificação do modelo TSL.
  QueryDeviceOriginalServiceData	Consulta os registros originais de chamadas de serviço de um dispositivo especificado. Inclui todos os serviços, independentemente de terem passado pela verificação do modelo TSL.
  QueryDeviceDesiredProperty	Consulta os valores desejados das propriedades de um dispositivo especificado.
  QueryDevicePropertyData	Consulta os dados de uma única propriedade para um dispositivo especificado dentro de um intervalo de tempo definido.
  QueryDevicePropertiesData	Consulta os dados de várias propriedades para um dispositivo especificado dentro de um intervalo de tempo definido.
  QueryDeviceEventData	Consulta os registros de eventos de um dispositivo especificado.
  QueryDeviceServiceData	Consulta os registros de chamadas de serviço de um dispositivo especificado.

Dados do modelo TSL ausentes no console

Quando um dispositivo reporta dados do modelo TSL, o IoT Platform verifica esses dados com base no modelo TSL definido e no método de validação de dados configurado. Dados que falham na verificação ou cuja validação é ignorada não aparecem na aba TSL Model Data da página Device Details do dispositivo no console do IoT Platform. Para mais informações, consulte Validar dados do modelo TSL.

Defina o método de validação de dados ao criar um produto. Para mais informações, consulte Criar um produto.

Status dos dados TSL não atualizado após comandos

Para solucionar o problema, investigue os seguintes aspectos:

• Lado do dispositivo: Certifique-se de que o dispositivo esteja conectado corretamente ao IoT Platform. Para informações sobre como conectar um dispositivo, consulte Baixar SDKs de dispositivo.

  Importante

  Um comando bem-sucedido do IoT Platform confirma apenas que a solicitação 'defina' foi enviada da nuvem; isso não garante a execução pelo dispositivo. Para que a propriedade seja considerada definida com sucesso, o dispositivo deve aplicar o novo valor e, em seguida, reportar esse valor de volta à plataforma.

  Use o emulador de dispositivo ou a ferramenta MQTT.fx para simular um dispositivo online e, em seguida, use o recurso de depuração online para testar as capacidades de comunicação do dispositivo. Para mais informações, consulte:

  • Emulador de dispositivo.

  • Usar MQTT.fx para conectar ao IoT Platform.

  • Depuração online.

• Lado da nuvem do IoT Platform:

  • Certifique-se de que a propriedade para a qual você deseja set um valor ou um desired value tenha acesso de leitura/gravação.

  • Garanta que as mensagens do modelo TSL sejam analisadas corretamente.

    Os dados aparecem no estado de execução do modelo TSL somente se as mensagens do modelo TSL forem analisadas corretamente. Para mais informações, consulte Modelos TSL e Analisar mensagens do modelo TSL.

  Faça login no console do IoT Platform. Na instância, acesse a página Maintenance > Device Log > Cloud run log para visualizar logs e verificar se o dispositivo recebeu a mensagem com sucesso. Para mais informações, consulte Cloud run log.

Dados de temperatura ausentes no console

Os dados do modelo TSL não aparecerão se a propriedade do modelo TSL não estiver definida ou se o formato dos dados reportados estiver incorreto.

Siga estas etapas para garantir que os dados sejam exibidos corretamente:

1. Defina uma propriedade do modelo TSL chamada Temperature para o produto que contém o dispositivo. Para mais informações, consulte Adicionar recursos do modelo TSL.

2. O dispositivo deve reportar dados de propriedades usando o tópico de comunicação do modelo TSL e o formato de dados corretos. Para mais informações sobre o desenvolvimento no lado do dispositivo, consulte Conexão do dispositivo.

   • Se você selecionou ICA Standard Data Format (Alink JSON) como formato de dados ao criar o produto, o dispositivo deve usar o tópico /sys/${productKey}/${deviceName}/thing/event/property/post e reportar dados no seguinte formato:

     {
         "id": "123",
         "version": "1.0",
         "sys":{
             "ack":0
         },
         "params": {
             "temperature": {
                 "value": 35,
                 "time": 1524448722000
             }
         },
         "method": "thing.event.property.post"
     }

     Para mais informações sobre os campos, consulte Dispositivo reporta propriedades.

   • Se você selecionou Passthrough/Custom como formato de dados ao criar o produto, configure um script para analisar as mensagens do modelo TSL.

     O dispositivo deve usar o tópico /sys/${productKey}/${deviceName}/thing/model/up_raw para transmitir dados em formato hexadecimal. Para mais informações, consulte Dispositivo reporta propriedades e Analisar mensagens do modelo TSL.

Importar recursos do modelo TSL rapidamente

Sim. O IoT Platform oferece os seguintes métodos para adicionar recursos do modelo TSL em lote:

• Adicionar modelos TSL em lote: No console do IoT Platform, copie recursos do modelo TSL de outro produto em lote ou importe um arquivo TSL.

• CreateThingModel: Use um SDK do lado do servidor para chamar esta API da nuvem e adicione recursos do modelo TSL usando o parâmetro ThingModelJson. Para mais informações sobre o formato de dados ThingModelJson, consulte Formato de dados ThingModelJson.