Aplicações de demonstração do Bluetooth Low Energy - FreeRTOS

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Aplicações de demonstração do Bluetooth Low Energy

Importante

Essa demonstração está hospedada no repositório Amazon-FreeRTOS, que está preterido. Recomendamos começar aqui ao criar um novo projeto. Se você já tem um projeto FreeRTOS existente baseado no repositório Amazon-FreeRTOS que está preterido, consulte o Guia de migração do repositório Github do Amazon FreeRTOS.

Visão geral

A Bluetooth Low Energy do FreeRTOS inclui três aplicações de demonstração:

  • Demonstração do MQTT por Bluetooth Low Energy

    Este aplicação demonstra como usar o MQTT pelo serviço Bluetooth Low Energy.

  • Demonstração do Provisionamento de Wi-Fi

    Esta aplicação demonstra como usar o serviço de provisionamento de Wi-Fi Bluetooth Low Energy.

  • Demonstração do Servidor de atributos genéricos

    Esta aplicação demonstra como usar as APIs do middleware Bluetooth Low Energy do FreeRTOS para criar um servidor GATT simples.

nota

Para configurar e executar as demonstrações do FreeRTOS, siga as etapas em Conceitos básicos do FreeRTOS.

Pré-requisitos

Para acompanhar essas demonstrações, você precisa de um microcontrolador com recursos do Bluetooth Low Energy. Você também precisa do SDK do iOS para dispositivos Bluetooth do FreeRTOS ou do SDK do Android para dispositivos Bluetooth do FreeRTOS.

Configure o AWS IoT Amazon Cognito para Freertos Bluetooth Low Energy

Para conectar seus AWS IoT dispositivos ao MQTT, você precisa configurar o Amazon AWS IoT Cognito.

Para configurar AWS IoT
  1. Configure uma AWS conta em https://aws.amazon.com/.

  2. Abra o console AWS IoT e, no painel de navegação, escolha Manage (Gerenciar) e depois Things (Coisas).

  3. Escolha Create (Criar) e Create a single thing (Criar uma única coisa).

  4. Insira um nome para o dispositivo e escolha Next (Próximo).

  5. Se você estiver conectando seu microcontrolador à nuvem por meio de um dispositivo móvel, escolha Create thing without certificate (Criar coisa sem certificado). Como os SDKs móveis usam o Amazon Cognito para a autenticação de dispositivos, não é necessário criar um certificado de dispositivo para demonstrações que usam Bluetooth Low Energy.

    Se você estiver conectando seu microcontrolador à nuvem diretamente por Wi-Fi, escolha Create certificate (Criar certificado), Activate (Ativar) e faça download do certificado da coisa, da chave pública e da chave privada.

  6. Escolha a coisa que você acabou de criar na lista de coisas registradas e escolha Interact (Interagir) na página da coisa. Anote o endpoint da API AWS IoT REST.

Para obter mais informações sobre a configuração, consulte Introdução ao AWS IoT.

Como criar um grupo de usuários do Amazon Cognito
  1. Abra o console do Amazon Cognito e escolha Gerenciar grupos de usuários.

  2. Selecione Criar um grupo de usuários.

  3. Atribua um nome ao grupo de usuários e escolha Review defaults (Revisar padrões).

  4. No painel de navegação, escolha App clients (Clientes de aplicação) e Add an app client (Adicionar um cliente de aplicação).

  5. Insira um nome para o cliente de aplicação e escolha Create app client (Criar cliente de aplicação).

  6. No painel de navegação, escolha Review (Revisar) e, depois, Create pool (Criar grupo).

    Anote o ID do grupo que aparecer na página General Settings (Configurações gerais) do grupo de usuários.

  7. No painel de navegação, escolha App clients (Clientes de aplicação) e Show details (Mostrar detalhes). Anote o ID e o segredo do cliente de aplicação.

Como criar um banco de identidades do Amazon Cognito
  1. Abra o console do Amazon Cognito e escolha Gerenciar bancos de identidades.

  2. Insira um nome para o grupo de identidades.

  3. Expanda Authentication providers (Provedores de autenticação), escolha a guia Cognito e insira os IDs do grupo de usuários e do cliente de aplicação.

  4. Selecione Criar grupo.

  5. Expanda View Details (Exibir detalhes) e anote os dois nomes de função do IAM. Escolha Permitir e crie os perfis do IAM para identidades autenticadas e não autenticadas acessarem ao Amazon Cognito.

  6. Escolha Edit identity pool (Editar grupo de identidades). Anote o ID do grupo de identidades. Ele deve ter o formato us-west-2:12345678-1234-1234-1234-123456789012.

Para obter mais informações sobre os conceitos básicos do Amazon Cognito, consulte Conceitos básicos do Amazon Cognito.

Como criar e anexar uma política do IAM à identidade autenticada
  1. Abra o console do IAM e, no painel de navegação, escolha Perfis.

  2. Encontre e escolha a função da sua identidade autenticada, escolha Attach policies (Anexar políticas) e, em seguida, escolha Add inline policy (Adicionar política em linha).

  3. Escolha a guia JSON e cole o JSON a seguir:

    { "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "iot:AttachPolicy", "iot:AttachPrincipalPolicy", "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive", "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow" ], "Resource":[ "*" ] } ] }
  4. Escolha Review policy (Revisar política), insira um nome para a política e escolha Create policy (Criar política).

Mantenha suas informações AWS IoT e do Amazon Cognito em mãos. Você precisa do endpoint e dos IDs para autenticar seu aplicativo móvel na AWS nuvem.

Configuração do ambiente do FreeRTOS para Bluetooth Low Energy

Para configurar o ambiente, é necessário fazer download do FreeRTOS com a Biblioteca de Bluetooth Low Energy no microcontrolador, além de fazer download do SDK móvel e configurá-lo para dispositivos Bluetooth do FreeRTOS em seu dispositivo móvel.

Como configurar o ambiente do microcontrolador com o Bluetooth Low Energy do FreeRTOS
  1. Baixe ou clone FreeRTOS de. GitHub Consulte o arquivo README.md para obter instruções.

  2. Configure o FreeRTOS no seu microcontrolador.

    Para obter informações sobre os conceitos básicos do FreeRTOS em um microcontrolador qualificado para o FreeRTOS, consulte o guia da sua placa em Conceitos básicos do FreeRTOS.

    nota

    Você pode executar as demonstrações em todo microcontrolador habilitado para o Bluetooth Low Energy com o FreeRTOS e as bibliotecas Bluetooth Low Energy do FreeRTOS obtidas por portabilidade. Atualmente, o projeto de demonstração MQTT por Bluetooth Low Energy do FreeRTOS foi totalmente migrado para os seguintes dispositivos habilitados para Bluetooth Low Energy:

Componentes comuns

As aplicações de demonstração do FreeRTOS têm dois componentes comuns:

  • Gerenciador de rede

  • aplicação de demonstração do SDK móvel de Bluetooth Low Energy

Gerenciador de rede

O Gerenciador de rede gerencia a conexão de rede do microcontrolador. Ele está localizado no diretório do FreeRTOS, em demos/network_manager/aws_iot_network_manager.c. Se o gerenciador de rede está habilitado para Wi-Fi e Bluetooth Low Energy, as demonstrações começam com Bluetooth Low Energy por padrão. Se a conexão Bluetooth Low Energy for interrompida e sua placa for habilitada para Wi-Fi, o Gerenciador de rede alternará para uma conexão Wi-Fi disponível para evitar que a rede seja desconectada.

Para habilitar um tipo de conexão de rede com o Gerenciador de rede, adicione o tipo de conexão de rede ao parâmetro configENABLED_NETWORKS em vendors/vendor/boards/board/aws_demos/config_files/aws_iot_network_config.h (em que vendor é o nome do fornecedor e board é o nome da placa que está sendo usada para executar as demonstrações).

Por exemplo, se você estiver com Bluetooth Low Energy e rede Wi-Fi ativadas, a linha que começa com #define configENABLED_NETWORKS em aws_iot_network_config.h mostrará:

#define configENABLED_NETWORKS ( AWSIOT_NETWORK_TYPE_BLE | AWSIOT_NETWORK_TYPE_WIFI )

Para obter uma lista dos tipos de conexão de rede compatíveis no momento, consulte as linhas que começam com #define AWSIOT_NETWORK_TYPE em aws_iot_network.h.

aplicação de demonstração do SDK móvel de Bluetooth Low Energy do FreeRTOS

O aplicativo de demonstração do FreeRTOS Bluetooth Low Energy Mobile SDK está localizado GitHub no SDK do Android para dispositivos Bluetooth do FreeRTOS, abaixo, e no SDK do iOS para dispositivos Bluetooth amazon-freertos-ble-android-sdk/app do FreeRTOS, abaixo. amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo Neste exemplo, usamos capturas de tela da versão para iOS da aplicação móvel de demonstração.

nota

Se você estiver usando um dispositivo iOS, precisará do Xcode para criar a aplicação móvel de demonstração. Se você estiver usando um dispositivo Android, poderá usar o Android Studio para criar a aplicação móvel de demonstração.

Para configurar a aplicação de demonstração do SDK para iOS

Ao definir variáveis de configuração, use o formato dos valores de espaços reservados fornecidos nos arquivos de configuração.

  1. Confirme se o SDK do iOS para dispositivos Bluetooth do FreeRTOS está instalado.

  2. Emita o comando a seguir de amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/:

    $ pod install
  3. Abra o projeto amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo.xcworkspace com Xcode e altere a conta do desenvolvedor assinante para a sua conta.

  4. Crie uma AWS IoT política na sua região (caso ainda não tenha feito isso).

    nota

    Essa política é diferente da política do IAM criada para a identidade autenticada do Amazon Cognito.

    1. Abra o console de AWS IoT.

    2. No painel de navegação, escolha Secure (Seguro), Policies (Políticas) e Create (Criar). Insira um nome para identificar a política. Na seção Add statements (Adicionar instruções), escolha Advanced mode (Modo avançado). Copie e cole o seguinte JSON na janela do editor de política. Substitua aws-region e aws-account por sua região e ID da conta. AWS

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iot:Connect", "Resource":"arn:aws:iot:region:account-id:*" }, { "Effect": "Allow", "Action": "iot:Publish", "Resource": "arn:aws:iot:region:account-id:*" }, { "Effect": "Allow", "Action": "iot:Subscribe", "Resource": "arn:aws:iot:region:account-id:*" }, { "Effect": "Allow", "Action": "iot:Receive", "Resource": "arn:aws:iot:region:account-id:*" } ] }
    3. Escolha Criar.

  5. Abra amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Amazon/AmazonConstants.swift e redefina as variáveis a seguir:

    • region: Sua AWS região.

    • iotPolicyName: O nome AWS IoT da sua apólice.

    • mqttCustomTopic: o tópico MQTT no qual você deseja publicar.

  6. Abra o amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Support/awsconfiguration.json.

    Em CognitoIdentity, redefina as variáveis a seguir:

    • PoolId: ID de banco de identidades do Amazon Cognito.

    • Region: Sua AWS região.

    Em CognitoUserPool, redefina as variáveis a seguir:

    • PoolId: ID de grupo de usuários do Amazon Cognito.

    • AppClientId: o ID do cliente da aplicação.

    • AppClientSecret: o segredo do cliente da aplicação.

    • Region: Sua AWS região.

Para configurar a aplicação de demonstração do SDK para Android

Ao definir variáveis de configuração, use o formato dos valores de espaços reservados fornecidos nos arquivos de configuração.

  1. Confirme se o SDK do Android para dispositivos Bluetooth do FreeRTOS está instalado.

  2. Crie uma AWS IoT política na sua região (caso ainda não tenha feito isso).

    nota

    Essa política é diferente da política do IAM criada para a identidade autenticada do Amazon Cognito.

    1. Abra o console de AWS IoT.

    2. No painel de navegação, escolha Secure (Seguro), Policies (Políticas) e Create (Criar). Insira um nome para identificar a política. Na seção Add statements (Adicionar instruções), escolha Advanced mode (Modo avançado). Copie e cole o seguinte JSON na janela do editor de política. Substitua aws-region e aws-account por sua região e ID da conta. AWS

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iot:Connect", "Resource":"arn:aws:iot:region:account-id:*" }, { "Effect": "Allow", "Action": "iot:Publish", "Resource": "arn:aws:iot:region:account-id:*" }, { "Effect": "Allow", "Action": "iot:Subscribe", "Resource": "arn:aws:iot:region:account-id:*" }, { "Effect": "Allow", "Action": "iot:Receive", "Resource": "arn:aws:iot:region:account-id:*" } ] }
    3. Escolha Criar.

  3. Abra https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/java/software/amazon/freertos/demo/ DemoConstants .java e redefina as seguintes variáveis:

    • AWS_IOT_POLICY_NAME: O nome AWS IoT da sua apólice.

    • AWS_IOT_REGION: Sua AWS região.

  4. Abra https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/res/raw/awsconfiguration.json.

    Em CognitoIdentity, redefina as variáveis a seguir:

    • PoolId: ID de banco de identidades do Amazon Cognito.

    • Region: Sua AWS região.

    Em CognitoUserPool, redefina as variáveis a seguir:

    • PoolId: ID de grupo de usuários do Amazon Cognito.

    • AppClientId: o ID do cliente da aplicação.

    • AppClientSecret: o segredo do cliente da aplicação.

    • Region: Sua AWS região.

Para descobrir e estabelecer conexões seguras com seu microcontrolador por Bluetooth Low Energy
  1. Para emparelhar seu microcontrolador e dispositivo móvel com segurança (etapa 6), você precisa de um emulador de terminal serial com recursos de entrada e saída (como). TeraTerm Configure o terminal para conectar-se à sua placa por uma conexão serial de acordo com as instruções em Instalação de um emulador de terminal.

  2. Execute o projeto de demonstração de Bluetooth Low Energy no seu microcontrolador.

  3. Execute a aplicação de demonstração do SDK móvel de Bluetooth Low Energy em seu dispositivo móvel.

    Para iniciar a aplicação de demonstração no Android para SDK a partir da linha de comando, execute o seguinte comando:

    $ ./gradlew installDebug
  4. Confirme se o microcontrolador aparece em Devices (Dispositivos) na aplicação de demonstração do SDK móvel de Bluetooth Low Energy.

    Página de gerenciamento de dispositivos mostrando um dispositivo ESP32 com seu identificador exclusivo.
    nota

    Todos os dispositivos com o FreeRTOS e o serviço de informações de dispositivos (freertos/.../device_information) que estiverem no intervalo aparecerão na lista.

  5. Escolha seu microcontrolador na lista de dispositivos. A aplicação estabelece uma conexão com a placa, e uma linha verde é exibida ao lado do dispositivo conectado.

    ID do dispositivo ESP32 exibida.

    Você pode se desconectar do microcontrolador arrastando a linha para a esquerda.

    Página de dispositivos mostrando uma ID de dispositivo ESP32 e outra ID de dispositivo.
  6. Se solicitado, emparelhe seu microcontrolador e dispositivo móvel.

    Placa do FreeRTOS

    Saída do console mostrando a desconexão do dispositivo BLE, a desconexão do serviço MQTT, o início do anúncio, a conexão BLE com o dispositivo remoto e uma solicitação para comparação numérica.

    Dispositivo móvel

    Caixa de diálogo de solicitação de emparelhamento Bluetooth para o dispositivo “ESP32" mostrando o código “465520" para confirmar em “ESP32".

    Se o código para comparação numérica é o mesmo em ambos os dispositivos, pareie-os.

nota

A aplicação de demonstração do SDK móvel de Bluetooth Low Energy usa o Amazon Cognito para autenticação do usuário. Verifique se você configurou um usuário e banco de identidades do Amazon Cognito e se anexou as políticas do IAM às identidades autenticadas.

MQTT por Bluetooth Low Energy

Na demonstração do MQTT via Bluetooth Low Energy, seu microcontrolador publica mensagens AWS na nuvem por meio de um proxy MQTT.

Para inscrever-se em um tópico de demonstração do MQTT
  1. Faça login no AWS IoT console.

  2. No painel de navegação, escolha Teste e, em seguida, escolha cliente de teste MQTT para abrir o cliente MQTT.

  3. Em Tópico de inscrição, insira thing-name/example/topic1 e selecione Inscreva-se no tópico.

Se você usa Bluetooth Low Energy para emparelhar o microcontrolador com seu dispositivo móvel, as mensagens MQTT são roteadas por meio da aplicação de demonstração do SDK móvel de Bluetooth Low Energy em seu dispositivo móvel.

Como habilitar a demonstração por Bluetooth Low Energy
  1. Abra vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h e defina CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED.

  2. Abra demos/include/aws_clientcredential.h e configure clientcredentialMQTT_BROKER_ENDPOINT com o endpoint do AWS IoT broker. Configure clientcredentialIOT_THING_NAME com o nome da coisa para o dispositivo microcontrolador de BLE. O endpoint do AWS IoT broker pode ser obtido no AWS IoT console escolhendo Configurações no painel de navegação esquerdo ou por meio da CLI executando o comando:. aws iot describe-endpoint --endpoint-type=iot:Data-ATS

    nota

    O endpoint do AWS IoT broker e o nome da coisa devem estar na mesma região em que a identidade cognito e o grupo de usuários estão configurados.

Para executar a demonstração
  1. Compile e execute o projeto de demonstração no seu microcontrolador.

  2. Verifique se você pareou a placa e o dispositivo móvel usando o aplicação de demonstração do SDK móvel de Bluetooth Low Energy do FreeRTOS.

  3. Na lista Devices (Dispositivos) na aplicação móvel de demonstração, escolha seu microcontrolador e, depois, escolha MQTT Proxy (Proxy MQTT) para abrir as configurações do proxy MQTT.

    Lista de três IDs de dispositivos ESP32, com as opções MQTT Proxy, Network Config e Custom GATT MQTT abaixo.
  4. Depois de habilitar o proxy MQTT, as mensagens MQTT são exibidas no tópico thing-name/example/topic1 e os dados são impressos no terminal UART.

Provisionamento de Wi-Fi

O provisionamento de Wi-Fi é um serviço de Bluetooth Low Energy do FreeRTOS que permite enviar com segurança as credenciais de rede Wi-Fi de um dispositivo móvel para um microcontrolador por Bluetooth Low Energy. O código-fonte para o serviço de provisionamento de Wi-Fi pode ser encontrado em freertos/.../wifi_provisioning.

nota

Atualmente, a demonstração do Wi-Fi Provisioning é compatível com o Espressif ESP32- C. DevKit

Para habilitar a demonstração
  1. Habilite o serviço de provisionamento de Wi-Fi. Abra vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h e defina #define IOT_BLE_ENABLE_WIFI_PROVISIONING como 1 (em que vendor é o nome do fornecedor e board é o nome da placa que está sendo usada para executar as demonstrações).

    nota

    O serviço de provisionamento de Wi-Fi é desabilitado por padrão.

  2. Configure o Gerenciador de rede para ativar tanto Bluetooth Low Energy quanto Wi-Fi.

Para executar a demonstração
  1. Compile e execute o projeto de demonstração no seu microcontrolador.

  2. Verifique se você pareou o microcontrolador e o dispositivo móvel usando o aplicação de demonstração do SDK móvel de Bluetooth Low Energy do FreeRTOS.

  3. Na lista Devices (Dispositivos) na aplicação móvel de demonstração, escolha seu microcontrolador e, depois, escolha Network Config (Configuração de rede) para abrir as configurações de rede.

    Lista de três IDs de dispositivos ESP32, com as opções MQTT Proxy, Network Config e Custom GATT MQTT abaixo.
  4. Depois que você escolher Network Config (Configuração de rede) para sua placa, o microcontrolador enviará uma lista de redes nas proximidades para o dispositivo móvel. As redes Wi-Fi disponíveis aparecem em uma lista em Scanned Networks (Redes verificadas).

    Interface de gerenciamento de dispositivos ESP32 que não mostra redes salvas, duas redes wi-fi abertas digitalizadas, uma com segurança WPA2 e RSSI de -29, a outra com segurança aberta e RSSI de -50.

    Na lista Scanned Networks (Redes verificadas), escolha a rede e digite o SSID e a senha, se necessário.

    Caixa de diálogo de entrada de senha da rede Wi-Fi com campo de senha vazio, botões Cancelar e Salvar.

    O microcontrolador conecta-se à rede e a salva. A rede é exibida nas Saved Networks (Redes salvas).

    Interface de rede mostrando WiFi redes salvas e digitalizadas, uma protegida por WPA2 e outra aberta, com indicadores de intensidade do sinal.

Você pode salvar várias redes na aplicação móvel de demonstração. Quando você reinicia a aplicação e a demonstração, o microcontrolador se conecta à primeira rede salva disponível, começando pela parte superior da lista de Saved Networks (Redes salvas).

Para alterar a ordem de prioridade das redes ou excluir redes, na página Network Configuration (Configuração de rede), escolha Editing Mode (Modo de edição). Para alterar a ordem de prioridade das redes, escolha o lado direito da rede que você deseja priorizar novamente e arraste-a para cima ou para baixo. Para excluir uma rede, escolha o botão vermelho no lado esquerdo da rede que você deseja excluir.

Tela de configurações de rede Wi-Fi mostrando redes salvas, opções de edição para excluir ou alterar a prioridade e redes digitalizadas.

Servidor de atributos genéricos

Neste exemplo, uma aplicação do servidor de demonstração de recursos genéricos (GATT) no seu microcontrolador envia um valor de contador simples para o aplicação de demonstração do SDK móvel de Bluetooth Low Energy do FreeRTOS.

Usando os SDKs móveis de Bluetooth Low Energy, você pode criar seu próprio cliente GATT para um dispositivo móvel que se conecta ao servidor GATT no seu microcontrolador e é executado em paralelo com a aplicação móvel de demonstração.

Para habilitar a demonstração
  1. Ative a demonstração Bluetooth Low Energy GATT. Em vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h (em que vendor é o nome do fornecedor e board é o nome da placa que está sendo usada para executar as demonstrações), adicione #define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 ) à lista de instruções de definição.

    nota

    A demonstração Bluetooth Low Energy GATT é desabilitada por padrão.

  2. Abra freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h, comente #define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED e defina CONFIG_BLE_GATT_SERVER_DEMO_ENABLED.

Para executar a demonstração
  1. Compile e execute o projeto de demonstração no seu microcontrolador.

  2. Verifique se você pareou a placa e o dispositivo móvel usando o aplicação de demonstração do SDK móvel de Bluetooth Low Energy do FreeRTOS.

  3. Na lista Devices (Dispositivos) na aplicação, escolha sua placa e, depois, escolha MQTT Proxy (Proxy MQTT) para abrir as opções do proxy MQTT.

    Lista de três IDs de dispositivos ESP32, com as opções MQTT Proxy, Network Config e Custom GATT MQTT abaixo.
  4. Retorne à lista Devices (Dispositivos), escolha sua placa e, depois, escolha Custom GATT MQTT (MQTT GATT personalizado) para abrir as opções de serviço de GATT personalizado.

  5. Escolha Start Counter (Iniciar contador) para começar a publicar dados no tópico MQTT your-thing-name/example/topic.

    Depois de habilitar o proxy MQTT, o Hello World e as mensagens incrementais do contador aparecem no tópico your-thing-name/example/topic.