IoT Platform:Tópicos

Categorias de tópicos

As categorias de tópicos são definidas com base nos produtos. Cada categoria representa um conjunto de tópicos para diferentes dispositivos dentro do mesmo produto. É possível definir várias categorias de tópicos para um produto. Uma categoria de tópicos aplica-se a todos os dispositivos de um produto.

Os itens a seguir descrevem como usar uma categoria de tópicos:

• Defina recursos para uma categoria de tópicos.

  Uma categoria de tópicos é composta por vários campos. Separe os campos com barras (/). Exemplo: /${productKey}/${deviceName}/user/update.

  Os campos ${productKey} e ${deviceName} são fixos. Os campos de sufixo e prefixo identificam mensagens com finalidades distintas.

  • ${productKey}: o ProductKey do produto.

    Substitua a variável pelo ProductKey real.

  • ${deviceName}: o DeviceName do dispositivo.

    Em uma categoria de tópicos, ${deviceName} é uma variável que representa todos os dispositivos do produto. Não substitua essa variável por um DeviceName real.

• Defina permissões em uma categoria de tópicos.

  • Publish: Os dispositivos de um produto podem publicar mensagens nos tópicos de uma categoria.

  • Subscribe: Os dispositivos de um produto podem assinar os tópicos de uma categoria para receber mensagens.

  • Publish and Subscribe: Os dispositivos podem publicar mensagens e recebê-las dos tópicos correspondentes.

Definir um tópico

A expressão ${productKey}/${deviceName} em uma categoria de tópicos especifica um dispositivo único. O tópico do dispositivo é gerado após a substituição das duas variáveis pelos valores reais.

Os tópicos seguem o mesmo formato das categorias de tópicos. A diferença é que a variável ${deviceName} da categoria é substituída por um DeviceName real no tópico.

Os exemplos a seguir mostram os tópicos dos dispositivos device1 e device2 no produto a19mzPZ***:

• /a19mzPZ****/device1/user/update

• /a19mzPZ****/device2/user/update

Os recursos e as permissões de uma categoria de tópicos são mapeados para tópicos específicos. Os itens a seguir descrevem como usar um tópico:

• Use tópicos para a comunicação de mensagens.

  Importante

  Ao depurar o envio e recebimento de mensagens, certifique-se de que os tópicos especificados possuem as permissões necessárias.

• Restrinja o uso de tópicos a dispositivos específicos.

  Por exemplo, o tópico /a19mzPZ****/device1/user/update pertence ao dispositivo chamado Device 1. Somente o Device 1 pode publicar mensagens ou recebê-las do tópico assinado. Outros dispositivos não podem usar esse tópico.

• Gerencie o envio de mensagens de um dispositivo.

  Para visualizar o status de um dispositivo, execute as seguintes etapas: Faça login no console do IoT Platform e desative o dispositivo na página Devices. Também é possível chamar a operação DisableThing no servidor para desativar o dispositivo. Caso não queira desativá-lo, gerencie as mensagens enviadas a ele.

Gerar tópicos

A figura a seguir ilustra como os tópicos são gerados.

1. Faça login no console do IoT Platform e crie um produto. Para mais informações, consulte Criar um produto.

   Após criar um produto, o IoT Platform predefine categorias de tópicos para ele, incluindo Topics for Basic Communications, Topics for TSL Communications e Custom Topics.

   Na página Product Details, clique em Topic Categories para visualizar as categorias de tópicos. Para mais informações, consulte Classificar tópicos. Na aba Topic Categories, clique em Topic Category. Em seguida, clique em Edit Topic Category, configure os parâmetros e clique em OK para criar uma categoria de tópicos personalizada para o produto. Para mais informações, consulte Usar tópicos personalizados para comunicação.

2. Adicione um dispositivo a um produto. Para mais informações, consulte Adicionar um dispositivo.

   Após adicionar um dispositivo, todas as categorias de tópicos do produto são mapeadas automaticamente para ele, gerando tópicos específicos. Os recursos e as permissões da categoria também são aplicados aos tópicos gerados. Não crie tópicos individualmente para cada dispositivo.

   Importante

   • Os tópicos aparecem na aba Topic List da página Device Details somente após você configurar o dispositivo e conectá-lo ao IoT Platform. Use um dos métodos abaixo para assinar um tópico no qual o dispositivo tenha permissão de Subscribe e visualizá-lo na aba Topic List.

     • Usar simulação de dispositivo: Quando o dispositivo fica online, o IoT Platform assina automaticamente os tópicos de comunicação básica e os tópicos de comunicação da Thing Specification Language (TSL) que possuem permissão de assinatura. Você também pode assinar tópicos personalizados usando o recurso Upstream Debug dos tópicos personalizados na página de Simulação de Dispositivo.

     • Usar MQTT.fx para simular o dispositivo e conectá-lo ao IoT Platform: Após o dispositivo ficar online, use o recurso Subscribe para assinar tópicos.

     • Desenvolva com o Link SDK para conectar o dispositivo ao IoT Platform, ative-o e assine os tópicos. Para mais informações, consulte a Etapa 3.

     • SubscribeTopic: Após conectar um dispositivo configurado ou simulado ao IoT Platform e ele ficar online conforme esperado, chame esta operação para assinar um tópico para o dispositivo.

   • Ao depurar o envio e recebimento de mensagens, verifique se os tópicos especificados possuem as permissões necessárias.

     Na aba Topic Categories da página Product Details, visualize o parâmetro Allowed Operations de cada tópico.

3. Configure o dispositivo e conecte-o ao IoT Platform.

   Para que um dispositivo se comunique com o IoT Platform e use seus diversos recursos, ele deve assinar os tópicos relacionados. Além disso, defina a lógica de publicação de mensagens nos tópicos que possuem permissão de publicação. Para mais informações sobre como configurar um dispositivo, consulte a documentação do Link SDK.

   • O dispositivo pode enviar o comando SUB para assinar tópicos específicos e obter mensagens do IoT Platform. Para mais informações sobre como configurar um dispositivo, consulte a documentação do Link SDK.

     As versões 3,1, 3,2 e 4.x do Link SDK para C fornecidas pelo IoT Platform suportam assinatura automática de tópicos. Para mais informações sobre os tópicos suportados, consulte Tópicos com assinatura automática.

     Importante

     Um dispositivo pode assinar um tópico de sistema predefinido no IoT Platform, como /sys/${productKey}/${deviceName}/thing/service/property/set. No entanto, não é possível usar a expressão /sys/${productKey}/${deviceName}/# para assinar tópicos de sistema cujos nomes começam com /sys/${productKey}/${deviceName}.

   • O dispositivo pode enviar uma mensagem ao IoT Platform publicando o comando PUB em um tópico com permissão de publicação. Para mais informações sobre como configurar o dispositivo, consulte a documentação do Link SDK.

   Verifique o dispositivo e conecte-o ao IoT Platform. Para mais informações, consulte Verificar dispositivos.

   Depois que um dispositivo envia um comando SUB para assinar um tópico, siga estas etapas para visualizá-lo: Faça login no console do IoT Platform, escolha Devices > Devices, localize o dispositivo e clique em View na coluna Actions. Na página Device Details, clique em Topic List. Na aba exibida, todos os tópicos assinados aparecem na seção Subscribed Topics.

   Nota

   O dispositivo pode enviar o comando UNSUB para cancelar a assinatura de tópicos específicos. Assim, esses tópicos são removidos da seção Subscribed Topics.

Usar tópicos para comunicação

A figura a seguir mostra o processo de comunicação após a conexão de um dispositivo ao IoT Platform.

Classificar tópicos

Os tópicos dividem-se em tópicos de comunicação básica, tópicos de comunicação TSL e tópicos personalizados. A tabela a seguir descreve os tipos de tópicos.

Limites

A quantidade de tópicos em uma categoria de tópicos de um produto corresponde ao número de dispositivos adicionados a esse produto. Para mais informações, consulte Limites.