EIO404 - Estação base Bluetooth IFM - Manual de utilização gratuito

MANUAL DE UTILIZADOR EIO404 IFM

Manual de operação

Estação base Bluetooth® mesh IoT

EIO404

Firmware: 1.55

Índice

1 Nota prévia 5

1.1 Informações jurídicas 5
1.2 Símbolos utilizados.... 5
1.3 Advertência 5

2 Instruções de segurança.... 6

2.1 Segurança cibernética 6
2.2 Símbolos de segurança no dispositivo 7

3 Utilização 8

3.1 Uso indevido previsível 8
3.2 Topologia da rede Bluetooth mesh 8

4 Função 10

4.1 Sinalização óptica 10
4.2 Interface Ethernet 10
4.3 Bluetooth LE 10
4.4 Bluetooth mesh.... 10
4.5 ifm IoT Core 10

5 Montagem.... 11

5.1 Visão geral 11
5.2 Opções de montagem.... 11

5.2.1 Montagem sem acessórios.... 11
5.2.2 Montagem com o elemento angular de montagem E80335 11
5.2.3 Montagem com o suporte montagem E80336.... 12
5.2.4 Montagem com barras de montagem E80337....12

5.3 Montagem do dispositivo 12

6 Conexão elétrica.... 13

6.1 Visão geral 13
6.2 Informações sobre o cabeamento.... 13
6.3 Tensão de alimentação.... 13
6.4 Porta Ethernet.... 14

7 Elementos de exibição e de operação 15

7.1 Visão geral 15
7.2 LED de estado 15

8 Parametrização.... 16

8.1 Informações sobre a parametrização ..... 16

8.1.1 Parametrização por meio da interface Ethernet 16
8.1.2 Parametrização via interface Ethernet.... 16
8.1.3 Instalação do ifm moneo|blue 17
8.1.4 Instalação do ifm moneo|configure 17
8.1.5 Senha Bluetooth 17

8.2 ifm moneo|blue 19

8.2.1 Criação de conexão com o dispositivo 19

8.2.1.1 Provisionamento do adaptador Bluetooth mesh IO-Link 19
8.2.1.2 Remoção de adaptadores Bluetooth mesh IO-Link da rede 20

8.2.2 Leitura das informações de identificação 21

8.2.3 Configuração das definições de IP 21
8.2.4 Definição do nome da rede Bluetooth mesh 21
8.2.5 Definição do nome da estação 21
8.2.6 Configuração da conexão MQTT 21
8.2.7 ▶ Configurar o canal de comando MQTT 22
8.2.8 Atualização do firmware 22

8.2.8.1 Atualização do firmware dos adaptadores conectados 23

8.3 ifm IoT Core REST API 24

8.3.1 ifm IoT Core: Informações gerais 24
8.3.1.1 Acesso ao ifm IoT Core.... 24
8.3.2 Primeiros passos 26
8.3.3 Funções gerais 27

8.3.3.1 Exemplo: Alterar o valor do parâmetro 27
8.3.3.2 Exemplo: Ler vários valores de parâmetros simultaneamente ..... 28
8.3.3.3 Exemplo: Exportar subárvore 28
8.3.3.4 Exemplo: Pesquisar o IoT Core. 29

8.3.4 Ethernet: Configurar os ajustes IP.... 30

8.3.5 Ethernet: configuração protegida por senha 30

8.3.5.1 Exemplo: Definir senha Ethernet.... 31
8.3.5.2 Exemplo: Solicitar com autenticação.... 31
8.3.5.3 Exemplo: excluir a senha de Ethernet.... 32

8.3.6 Bluetooth: Configurar nome da estação 33

8.3.7 Bluetooth: configuração protegida por senha 33

8.3.7.1 Exemplo: alteração da senha do Bluetooth.... 33

8.3.8 Gerenciar rede Bluetooth Mesh 34

8.3.8.1 Exemplo: Procurar por adaptadores Mesh disponíveis ..... 34
8.3.8.2 Exemplo: Registrar o adaptador Mesh na rede Mesh 35
8.3.8.3 Exemplo: Substituir adaptador Mesh.... 35
8.3.8.4 Exemplo: Desconectar adaptador Mesh da rede Mesh 36

8.3.9 Gerenciar adaptador Bluetooth mesh IO-Link 36

8.3.10 Configurar temporizadores 37

8.3.10.1 Exemplo: Definir intervalo de contagem 37
8.3.10.2 Exemplo: Iniciar contador 37
8.3.10.3 Exemplo: Parar contador.... 38

8.3.11 Utilização de notificações 38

8.3.11.1 Notificações acionadas por eventos 39
8.3.11.2 Notificações programadas.... 39
8.3.11.3 Exemplo: Criar notificação programada 39
8.3.11.4 Exemplo: Criar notificação acionada por eventos 40
8.3.11.5 Exemplo: Mostrar mensagens ativas 41
8.3.11.6 Exemplo: Alterar notificação 41
8.3.11.7 Exemplo: Eliminar notificação 42

8.3.12 Uso de MQTT 42

8.3.12.1 Configuração da conexão MQTT 43
8.3.12.2 Configurar o canal de comando MQTT 44
8.3.12.3 Exemplo: Configurar e ativar o canal de comando MQTT....44
8.3.12.4 Exemplo: Publicar a temperatura do dispositivo no broker MQTT....46

8.3.13 Redefinir, reiniciar e localizar o dispositivo 47
8.3.14 Ler e escrever informações do dispositivo 47
8.3.15 Leitura das informações de estado e diagnóstico 48

8.4 ifm moneo|configure 49

8.4.1 Criação de conexão com o dispositivo 49

8.4.1.1 Provisionamento do adaptador Bluetooth mesh IO-Link 49
8.4.1.2 Remoção de adaptadores Bluetooth mesh IO-Link da rede mesh.....50

8.4.2 Informação: Leitura das informações de identificação.... 51
8.4.3 IoT: Configuração das definições de IP.... 51
8.4.4 IoT: configuração protegida por senha 52

8.4.4.1 Definir senha Ethernet 52
8.4.4.2 Redefinição da senha da Ethernet 52

8.4.5 Bluetooth LE: definição do nome da estação 53

8.4.6 Bluetooth LE: configuração protegida por senha.... 53

8.4.6.1 Alteração da senha do Bluetooth 53
8.4.7 Bluetooth mesh: gerenciamento de rede.... 54
8.4.8 MQTT: Configuração da conexão MQTT 54

8.4.8.1 Controle da conexão MQTT 54

8.4.9 MQTT: configuração do canal de comando.... 55

8.4.9.1 Configuração do canal de comando MQTT....56

8.4.10 Temporizador: configuração de temporizadores 56

8.4.10.1 Iniciar o temporizador 56
8.4.10.2 Parar o temporizador 57

8.4.11 Firmware: redefinir, reiniciar ou localizar o dispositivo.... 57

8.5 IoT Core Visualizer 58

8.5.1 Iniciar o IoT Core Visualizer 58
8.5.2 Gerenciar notificações 58

8.5.2.1 Criar notificações 58
8.5.2.2 Excluir notificações 59

8.5.3 Acesso à árvore IoT Core 60

8.5.3.1 Pesquisa de elementos do IoT Core 60
8.5.3.2 Acesso a elementos do IoT Core 61

8.5.4 Atualização do firmware 62

9 Eliminação de erros 64

10 Manutenção, conservação e descarte.... 65

10.1 Atualização do firmware 65

11 Anexo 66

11.1 ifm IoT Core 66

11.1.1 Perfil 66
11.1.2 Tipos....67
11.1.3 Serviços 68

11.1.3.1 Serviço: create_backup.... 68
11.1.3.2 Serviço: factoryreset 68
11.1.3.3 Serviço: get_credit 68
11.1.3.4 Serviço: getblobdata 68
11.1.3.5 Serviço: getdata 69
11.1.3.6 Serviço: getdatamulti.... 69
11.1.3.7 Serviço: getidentity 69
11.1.3.8 Serviço: getsubscriberlist 70
11.1.3.9 Serviço: gettree....70
11.1.3.10 Serviço: install.... 71
11.1.3.11 Serviço: install_backup 71
11.1.3.12 Serviço: querytree....71
11.1.3.13 Serviço: reboot 72
11.1.3.14 Serviço: register 72
11.1.3.15 Serviço: replace 72
11.1.3.16 Serviço: reset 72
11.1.3.17 Serviço: resetpassword.... 72
11.1.3.18 Serviço: reset_credits 73
11.1.3.19 Serviço: scan 73
11.1.3.20 Serviço: setblock....73
11.1.3.21 Serviço: setdata 73
11.1.3.22 Serviço: setdatamulti....74
11.1.3.23 Serviço: signal.... 74
11.1.3.24 Serviço: start....74
11.1.3.25 Serviço: start_stream_set 74
11.1.3.26 Serviço: stop 74
11.1.3.27 Serviço: stream_set 74
11.1.3.28 Serviço: subscribe....75
11.1.3.29 Serviço: unregister 75
11.1.3.30 Serviço: unsubscribe....76

1 Nota prévia

Instrução, dados técnicos, homologações e mais informações disponíveis através do código QR no dispositivo/na embalagem ou pelo link documentation.ifm.com.

1.1 Informações jurídicas

© ifm electronic gmbh reserva-se todos os direitos. A reprodução e o uso deste manual, mesmo parcialmente, é permitida somente com a autorização da empresa ifm electronic gmbh.

• Bluetooth® é uma marca registrada da Bluetooth SIG Inc.
• Apple , o logotipo da Apple, iPhone e iPod touch são marcas da Apple Inc. que estão registradas nos EUA e em outros países. App Store é uma marca de serviço da Apple Inc.
• O sistema operacional iOS® é uma marca registrada da Apple Inc.
• Google® é uma marca registrada da Google LLC.
• O Sistema operacional Android® é uma marca registrada da Google LLC.
• Android, Google Play e o logotipo do Google Play são marcas registradas da Google Inc.

1.2 Símbolos utilizados

√ Condição

▶ Instrução de procedimento

Reação, resultado

[...] Designação de teclas, botões ou exibições

→ Referência cruzada

Informação importante

Falhas de funcionamento ou interferências possíveis em caso de inobservância

Informação

Informação complementar

1.3 Advertência

As advertências alertam sobre possíveis danos pessoais e materiais. Isso permite o manuseio seguro do produto. As advertências são classificadas da seguinte forma:

ADVERTÊNCIA

Advertência sobre o perigo de lesões graves

▷ A não observância da advertência pode levar a risco de morte ou lesões graves.

CUIDADO

Advertência sobre danos pessoais leves a moderados

▷ A não observância da advertência pode levar a risco de lesões leves a moderadas.

ATENÇÃO

Advertência sobre danos materiais

▷ A não observância da advertência pode levar a danos materiais.

2 Instruções de segurança

- O dispositivo descrito é instalado como subcomponente em um sistema.

• A segurança deste sistema é de responsabilidade do fabricante.

• O fabricante do sistema é obrigado a realizar uma avaliação de risco e a elaborar uma documentação conforme os requisitos legais e regulamentares para fornecer ao operador e ao usuário do sistema. Esta deve conter todas as informações e instruções de segurança necessárias para o operador, os usuários e, caso necessário, a equipe de serviço autorizada pelo fabricante do sistema.

• Este documento deve ser lido antes do início das atividades e deve ser conservado durante toda a vida útil do produto.

• O produto deve ser completamente compatível com as aplicações e com as condições ambientes.
• Utilize o produto somente de forma adequada (→ Utilização adequada).
• O desrespeito às instruções de operação ou às especificações técnicas pode causar danos materiais e/ou pessoais.
• O fabricante não assume nenhuma responsabilidade ou garantia pelas intervenções feitas no produto ou pela utilização incorreta realizada pelo usuário.
• A instalação, a conexão elétrica, o manuseio, a programação, a configuração, a operação e a manutenção do produto só podem ser realizadas por funcionários qualificados e autorizados.
• Proteja os dispositivos e cabos eficazmente contra danos.
• Substitua os dispositivos danificados, caso contrário, os dados técnicos e a segurança serão prejudicados.

2.1 Segurança cibernética

Instalação

O dispositivo é adequado para a operação em ambiente seguro de acordo com a norma IEC 62443-1-1.

▶ Realize uma avaliação de risco da instalação de acordo com a norma IEC 62443-1-1.
O dispositivo foi projetado para a operação atrás de um firewall.
▶ Tome medidas para garantir a segurança física.
O dispositivo não tem autoproteção contra acesso não autorizado.
▶ Opere o dispositivo somente em redes confiáveis.

Exemplos de redes confiáveis (de acordo com IEC 62443-3-1, parte 5):

- Redes internas da empresa (Local Area Networks - LANs)

- Redes gerenciadas e protegidas pelo departamento de TI

- Sistemas de controle industrial (Industrial Control Systems - ICS)

• Redes para controle e monitoramento de processos industriais
• Os sistemas de controle industrial (ICS) são isolados de outras redes

- Conexão ponto a ponto entre o dispositivo e o próximo integrante da comunicação

interface Bluetooth LE

A interface Bluetooth LE usa o procedimento de emparelhamento (paring) JustWorkspara estabelecer uma comunicação criptograficamente segura entre o dispositivo e o ifm moneo|blue.
▶ Estabeleça uma conexão entre o dispositivo e o ifm moneo|blue somente em um ambiente seguro.

A interface Bluetooth LE do dispositivo está protegida por senha. Ao fazer o login no dispositivo pela primeira vez, o usuário deve alterar a senha definida de fábrica.

▶ Altere a senha somente em um ambiente seguro.
▶ Escolha uma senha segura de acordo com a política empresarial.

Interface Bluetooth mesh

A comunicação Bluetooth mesh entre os integrantes da rede é protegida por criptografia após o provisionamento bem-sucedido dos dispositivos na rede Bluetooth mesh.

▶ Provisione os dispositivos somente em um ambiente seguro para a rede Bluetooth mesh.

Funcionamento

▶ Observe as funções de segurança descritas na documentação do dispositivo e as recomendações para a sua utilização.

Manutenção

▶ Salve a configuração e os dados do sistema de acordo com os processos de gestão de mudanças da empresa.
▶ Verifique regularmente se há atualizações de software disponíveis para o dispositivo.

Garanta a integridade e a autenticidade da atualização do software adotando as seguintes medidas organizacionais:

▶ Faça o download do novo arquivo de firmware em um laptop / computador seguro.
▶ Calcule o valor de hash SHA-256 para o arquivo de firmware que foi descarregado, www.ifm.com/cnt/product-security.
▶ Verifique se o valor de hash calculado corresponde ao valor de hash SHA-256 fornecido no site da ifm.
▶ Instale o arquivo de firmware no dispositivo por meio de uma conexão segura, por exemplo, conexão ponto a ponto.

Retirada de operação

▶ Assegure que nenhuma informação sensível caia nas mãos de pessoas não autorizadas.
▶ Sempre redefina as configurações da instalação para as configurações de fábrica antes de desativar o dispositivo.

2.2 Símbolos de segurança no dispositivo

Símbolos de segurança no dispositivo:

▶ Observe o manual de operação para garantir o funcionamento seguro do dispositivo.

3 Utilização

O dispositivo pode ser utilizado:

• Como um nó organizacional central para configurar e gerenciar uma rede Bluetooth mesh com adaptadores Bluetooth mesh IO-Link como integrantes
• Para parametrizar os adaptadores Bluetooth mesh IO-Link conectados e, opcionalmente, os dispositivos IO-Link conectados.
• Como um gateway entre o nível superior de IIoT e os adaptadores Bluetooth mesh IO-Link conectados para a transmissão de dados de processo, bem como informações de status e diagnóstico dos dispositivos IO-Link conectados

Utilização autorizada:

• Em ambientes internos
• Utilize o dispositivo somente dentro dos limites dos dados técnicos: → Dados técnicos.

Informações importantes sobre a homologação: Folha de instruções do dispositivo e documentation.ifm.com

3.1 Uso indevido previsível

O dispositivo não é adequado para ambientes com requisitos especiais de estabilidade mecânica (por exemplo: impacto/vibração).

O dispositivo não é adequado para o uso em aplicações críticas. Os dados não são transmitidos em tempo real.

3.2 Topologia da rede Bluetooth mesh

Topologia recomendada:

Fig. 1: Posicionamento do EIO404 no centro da rede Bluetooth mesh

▶ Posicione a estação base Bluetooth mesh IoT no centro da rede Bluetooth mesh o máximo possível.
▷ A carga da rede diminui.
▷ A estabilidade da comunicação aumenta em comparação com o posicionamento da estação base na periferia da rede Bluetooth mesh.

Topologia não recomendada:

Fig. 2: Posicionamento do EIO404 na periferia da rede Bluetooth mesh

O posicionamento da estação base Bluetooth mesh IoT na periferia da rede Bluetooth mesh significa que todos os dados devem ser transmitidos por meio de um ou poucos adaptadores Bluetooth mesh IO-Link. No caso desses adaptadores, isso leva a uma alta utilização e pode ter um impacto negativo na estabilidade e na latência de toda a rede Bluetooth mesh.

▶ Evite posicionar a estação base Bluetooth mesh IoT na periferia da rede Bluetooth mesh.
▶ Se o posicionamento central não for possível, coloque adaptadores Bluetooth mesh IO-Link adicionais como nós de retransmissão na rede Bluetooth mesh.

4 Função

4.1 Sinalização óptica

O dispositivo tem um LED de estado para exibir informações de condição, advertências e estados de erro.

4.2 Interface Ethernet

Este dispositivo é equipado com uma interface Ethernet:

• parametrização do dispositivo
- Parametrização da topologia da rede Bluetooth mesh
- Comunicação Ethernet para o nível de TI (monitoramento)

4.3 Bluetooth LE

O dispositivo suporta comunicação via Bluetooth Low Energy (LE). As seguintes funções podem ser executadas via Bluetooth LE:

• Parametrização da estação base
- Parametrização da rede Bluetooth mesh
• Parametrização da interface Ethernet
• Parametrização da conexão MQTT

- Parametrização dos adaptadores Bluetooth mesh IO-Link conectados, incluindo os dispositivos IO-Link conectados

4.4 Bluetooth mesh

O dispositivo suporta o protocolo Bluetooth mesh.

Juntamente com os adaptadores Bluetooth mesh IO-Link EIO344, o dispositivo pode criar e gerenciar uma rede Bluetooth mesh. Após a configuração da rede Bluetooth mesh, o dispositivo estabelece automaticamente a conexão com o adaptador Bluetooth mesh IO-Link (EIO344).

▷ A estação base Bluetooth mesh IoT pode conectar até 50 adaptadores Bluetooth mesh IO-Link.

O dispositivo oferece as seguintes funções em uma rede Bluetooth mesh:

• Parametrização do adaptador
- Parametrização do dispositivo IO-Link conectado
• Monitoramento dos dados do processo (intervalo: 1 s ... 24 h)

Informações detalhadas sobre o adaptador Bluetooth mesh IO-Link EIO344:

documentation.ifm.com

4.5 ifm IoT Core

O dispositivo tem o ifm IoT Core. O ifm IoT Core representa a funcionalidade do dispositivo. A funcionalidade consiste em um conjunto de dados, serviços e eventos. Os elementos do ifm IoT Core são organizados em um objeto JSON em uma estrutura de árvore hierárquica. O ifm IoT Core disponibiliza esses elementos para sistemas externos através de interfaces padrão (por exemplo, HTTP). Isso permite que o usuário e outros dispositivos acessem os dados (parâmetros, dados de processo), eventos (events) e funções (serviços) do dispositivo.

5 Montagem

5.1 Visão geral

1: Furos roscados
2: Fonte de alimentação e conexões Ethernet

As conexões para a fonte de alimentação e Ethernet podem ser giradas em 270°.

5.2 Opções de montagem

Acessórios opcionais estão disponíveis para a montagem: documentation.ifm.com

Os parafusos necessários para a montagem não estão incluídos no fornecimento do dispositivo.

5.2.1 Montagem sem acessórios

O dispositivo pode ser montado sem os acessórios de montagem.

▶ Use uma superfície de montagem plana para a montagem.
▶ Use os 4 furos roscados na parte posterior do dispositivo para a montagem, Visão geral (→ ☐ 11).

5.2.2 Montagem com o elemento angular de montagem E80335

O elemento angular de montagem destina-se à montagem lateral do dispositivo.

5.2.3 Montagem com o suporte montagem E80336

O suporte montagem serve para montar o dispositivo em um cilindro de fixação.

5.2.4 Montagem com barras de montagem E80337

Fixe o dispositivo com parafusos de fixação no local de montagem.

5.3 Montagem do dispositivo

▶ Antes de iniciar a montagem, certifique-se de que os dispositivos não estejam conectados à rede elétrica.

▶ Monte o dispositivo com a opção desejada.
▶ Use apenas parafusos M4 para fixar o invólucro. Torque máximo: 0,8 Nm.

6 Conexão elétrica

O dispositivo deve ser instalado somente por um técnico eletricista qualificado.

Siga as normas nacionais e internacionais para a montagem de instalações eletrotécnicas.

Alimentação de tensão conforme SELV, PELV.

▶ Desconecte a tensão da instalação.

6.1 Visão geral

1: Porta Ethernet
2: Tensão de alimentação

6.2 Informações sobre o cabeamento

As conexões de rosca no dispositivo estão em conformidade com o padrão M12. Para garantir a conformidade com o grau de proteção especificado, só podem ser usados cabos que estejam em conformidade com esse padrão. O fabricante do sistema é responsável pelo grau de proteção dos cabos de confecção própria.

▶ Utilize conectores com contatos banhados a ouro.
▶ Coloque o conector verticalmente durante a montagem para que a porca de aperto não danifique a rosca.
▶ Antes de conectar o conector, verifique se há um anel de vedação não danificado no conector fêmea.
▶ Observe a codificação dos conectores durante a montagem.
▶ Instale um alívio de tração adequado em todos os cabos de saída após no máximo 200 mm.

Para a área de aplicação:

▶ Use somente cabos certificados UL da categoria CYJV 2/7/8 com dados técnicos adequados para conectar o dispositivo.

6.3 Tensão de alimentação

O dispositivo é conectado à fonte de alimentação por meio da porta.

CUIDADO

A porta não tem proteção contra sobrecorrente.

▷ Risco de incêndio
▶ Proteja os circuitos elétricos.

Atribuição da conexão:

1: L+
2: n.c.
3: L-
4: n.c.
5: n.c.

▶ Conecte a porta à fonte de alimentação.

▶ Utilize um conector M12 para a conexão.

▶ Aperte a porca de aperto com 0,6 a 1,5 Nm.

6.4 Porta Ethernet

O dispositivo é conectado à fonte de alimentação através da porta.

- Comprimento máximo do cabo: 20 m

O dispositivo não deve ser alimentado por meio da porta M12.

Atribuição da conexão:

1: TX+
2: RX+
3: TX-
4: RX-
5: n.c.

▶ Conecte a porta à rede de TI diretamente ou por meio de um elemento de acoplamento de rede (por exemplo, switch).
▶ Utilize um conector M12 para a conexão (grau de proteção mínimo: IP 67).
▶ Aperte a porca de aperto com 0,6 a 1,5 Nm.

7 Elementos de exibição e de operação

7.1 Visão geral

1: LED de estado

7.2 LED de estado

LED	Descrição	Cor	Estado	Tipo	Descrição
Estado	-	-	Desativado	Erro	Tensão muito baixa
	Indicação de operação	Verde	Ativado	Operação normal	O dispositivo está funcionando corretamente
			Pisca (pisca duas vezes)	Advertência	Identificação óptica
			Pisca (200 ms ativado, 800 ms desativado)	Observação	Update do firmware AVISO! Aguarde até a conclusão da atualização.
	Indicação de falha	Vermelho	Ativado	Substituição de dispositivo	Erro de hardware
			Pisca (1 Hz)	Erro	Temperatura da placa fora da faixa de tolerância
			Pisca (1 Hz)	Observação	Sem conexão Ethernet
			Pisca (1 Hz)	Advertência	Sem conexão Bluetooth mesh
	Status do Bluetooth	Azul	Ativado	Observação	Bluetooth ativado
			Pisca (pisca duas vezes por uma única vez)	Observação	Implantação de mesh bem-sucedida (após a mensagem de ID do dispositivo)

8 Parametrização

Este dispositivo pode ser configurado através de 2 interfaces. Você pode ler informações ou fazer configurações via Ethernet ou Bluetooth. Informações e configurações específicas estão disponíveis para cada interface.

1. Para Ethernet, conecte o conector M12 com um cabo Ethernet M12 (→ Acessório) a uma rede.
2. Use um aplicativo para estabelecer uma conexão Bluetooth.

Informações sobre software de parametrização adequado em io-link.ifm

8.1 Informações sobre a parametrização

8.1.1 Parametrização por meio da interface Ethernet

Para parametrizar a estação base Bluetooth mesh IoT através da interface Bluetooth:

▶ Conecte o dispositivo com a tensão de alimentação.
▶ Instale o ifm moneo|blue, Instalação do ifm moneo|blue (→ 17).

8.1.2 Parametrização via interface Ethernet

Opções disponíveis para configurar o dispositivo por meio da interface Ethernet:

• ifm IoT-Core REST API: ifm IoT Core REST API (→ 24)
• ifm moneo|configure: ifm moneo|configure (→ 49)
• ifm IoT-Core Visualizer: IoT Core Visualizer (→ 58)

Para parametrizar a estação base Bluetooth mesh IoT através da interface Ethernet:

▶ Conecte o dispositivo ao computador/laptop por meio da porta Ethernet.
▶ Conecte o dispositivo com a tensão de alimentação.
▶ Opcional: instale o ifm moneo|configure, Instalação do ifm moneo|configure (→ 17).

8.1.3 Instalação do ifm moneo|blue

A Ifm electronic fornece o aplicativo ifm moneo|blue para acessar o dispositivo por meio da interface Bluetooth. O aplicativo está disponível na Apple APP Store e na Google Play Store.

Para instalar o ifm moneo|blue:

▶ Escaneie o código QR usando o dispositivo móvel.
▷ A página do aplicativo na App Store ou na Google PlayStore se abre.
▶ Instale o ifm moneo|blue.
▷ O ifm moneo|blue está instalado no dispositivo móvel.

8.1.4 Instalação do ifm moneo|configure

Informações sobre o ifm moneo|configure: ifm.com/cnt/moneo

▶ Faça o download do ifm moneo|configure.
▶ Inicie o laptop/computador.
▶ Faça login com direitos de administrador.
▶ Instale e licencie o ifm moneo|configurar (→ Manual de instalação do ifm moneo).
▷ O ifm moneo|configure está instalado.

8.1.5 Senha Bluetooth

O acesso ao dispositivo via Bluetooth LE está protegido por uma senha. Não é possível desativar a proteção por senha.

A senha do Bluetooth definida de fábrica consiste nos últimos 6 dígitos do número de série do dispositivo (por exemplo, 100000138488).

O número de série está impresso na embalagem e no dispositivo.

Fig. 3: Imagem do número de série: no dispositivo (esquerda) e na embalagem (direita)

Ao acessar o dispositivo com o ifm moneo|blue pela primeira vez, o usuário é solicitado a ativar a função de senha definida de fábrica.

▶ Escolha uma senha segura de acordo com a política empresarial.

A senha do Bluetooth não influencia o acesso ao dispositivo pelo ifm moneo e pela interface IoT Core.

8.2 ifm moneo|blue

8.2.1 Criação de conexão com o dispositivo

▶ Ao entrar em operação pela primeira vez, altere a senha (→ Senha Bluetooth ☐ 17) definida de fábrica da interface Bluetooth.

Pré-requisitos:

√ O Bluetooth está ativado no dispositivo móvel.
Se o moneo|blue estiver instalado no dispositivo móvel, Instalação do ifm moneo|blue (→ 17).
√ O dispositivo está próximo ao dispositivo móvel (distância: máx. 15 m).
√ O dispositivo está conectado e pronto para a operação.

▶ Inicie o ifm moneo|blue.

▶ Clique em [Scan for Devices].
▷ O ifm moneo|blue procura por dispositivos disponíveis nas imediações.
▷ O ifm moneo|blue reconhece todos os dispositivos disponíveis.
▶ Seleccione a estação base Bluetooth mesh IoT e emparelhe-a com o dispositivo móvel.
▷ A visão geral é exibida.
▷ A visão geral mostra os dispositivos da rede Bluetooth mesh.
▶ Clique no ícone da estação base Bluetooth mesh IoT.
▷ Aparece o editor para os valores dos parâmetros do dispositivo.
▷ O dispositivo pode ser configurado.

8.2.1.1 Provisionamento do adaptador Bluetooth mesh IO-Link

Para adicionar um adaptador Bluetooth mesh IO-Link a uma rede Bluetooth mesh, o adaptador deve ser provisionado na estação base Bluetooth mesh IoT.

Pré-requisitos:

Se o moneo|blue estiver instalado no dispositivo móvel, Instalação do ifm moneo|blue (→ 17).

√ O Bluetooth está ativado no dispositivo móvel.
√ ▷ A estação base Bluetooth mesh IoT EIO404 foi iniciada e está pronta para a operação.
√ ▷ O adaptador Bluetooth mesh IO-Link EIO344 foi iniciado e está pronto para a operação.
√ O dispositivo está próximo ao dispositivo móvel (distância: máx. 15 m).
√ O ifm moneo|blue foi iniciado.
▶ Emparelhe a estação base Bluetooth mesh IoT com o dispositivo móvel, Criação de conexão com o dispositivo (→ 19).

▶ No cabeçalho: Clique em +.

▷ A estação base Bluetooth mesh IoT procura por adaptadores disponíveis nas imediações.
▷ Todos os adaptadores disponíveis são exibidos.

▶ Seleccione o adaptador Bluetooth mesh IO-Link.

▷ Clique em [Provision].

A estação base Bluetooth mesh IoT integra o adaptador à rede Bluetooth mesh.
▷ O ifm moneo|blue tem acesso ao adaptador Bluetooth mesh IO-Link.
▷ Se estiver conectado: o ifm moneo|blue tem acesso ao dispositivo IO-Link conectado.

Após o provisionamento, a estação base Bluetooth mesh IoT estabelece de forma independente a conexão com todos os adaptadores Bluetooth mesh IO-Link provisionados. A conexão é estabelecida diretamente ou por meio de outros adaptadores Bluetooth mesh IO-Link.

▷ Os adaptadores Bluetooth mesh IO-Link enviam os dados do processo para a estação base Bluetooth mesh IoT ciclicamente em um intervalo definido. Os dados do processo podem ser lidos e usados para o monitoramento do sistema.

8.2.1.2 Remoção de adaptadores Bluetooth mesh IO-Link da rede

Para remover um adaptador Bluetooth mesh IO-Link da rede Bluetooth mesh:

▶ Reinicie o adaptador Bluetooth mesh IO-Link (Back-to-Box), → Manual de operação EIO344.
▷ O adaptador Bluetooth mesh IO-Link é excluído da rede Bluetooth mesh.
▷ O crédito usado para o provisionamento é liberado.

8.2.2 Leitura das informações de identificação

Informações disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Número de série]	Número de série	Por exemplo: 000022503648	ro 1
[Versão de firmware]	Versão de firmware	Por exemplo: V1.42	ro 1
[Revisão do carregador de inicialização]	Versão do carregador de inicialização	Por exemplo: V0.07	ro 1
[Revisão EEPROM]	Versão do EEPROM	Por exemplo: V0.03	ro 1
[Endereço MAC]	Endereço MAC do Bluetooth	Por exemplo: B4-E3-F9-C7-54-43	ro 1
[Revisão do hardware]	Versão de hardware	Por exemplo: AA	ro 1
[Fabricante]	Fabricante	ifm electronic gmbh	ro 1
[Nome do produto]	Número do produto	EIO404	ro 1

¹ apenas leitura

8.2.3 Configuração das definições de IP

Para configurar as definições da porta Ethernet:

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Endereço de IP]	Endereço IP da interface Ethernet	Por exemplo: 192.168.0.100	rw 1
[Máscara da sub-rede]	Máscara de sub-rede da rede Ethernet	Por exemplo: 255.255.255.0	rw 1
[Gateway padrão]	Endereço IP da rede gateway	Por exemplo: 192.168.0.1	rw 1
[DHCP]	Ativar/desativar o cliente DHCP do dispositivo	IP estático: As configurações de IP são definidas pelo usuário (padrão)DHCP: As configurações de IP são definidas pelo servidor DHCP na rede	rw 1

¹ leitura e escrita

8.2.4 Definição do nome da rede Bluetooth mesh

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Nome da rede mesh]	Nome da rede Bluetooth mesh (32 caracteres no máx.)	Por exemplo: Plant2 Hall3	rw 1

1 leitura e escrita

8.2.5 Definição do nome da estação

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Nome do Bluetooth LE]	Nome do dispositivo na rede Bluetooth LE (22 caracteres no máx.)	Por exemplo: BaseStation	r w 1

1 leitura e escrita

8.2.6 Configuração da conexão MQTT

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Versão do MQTT]	Versão do MQTT	Por exemplo: 3.1.1	ro 1
[Keep-Alive]	Tempo máximo entre 2 pacotes consecutivos do protocolo MQTT (valor em segundos)	0: 0 s...10: 10 s...60: 60 s	rw 2

¹ apenas leitura

² leitura e escrita

8.2.7 Configurar o canal de comando MQTT

Certifique-se de que o broker MQTT está acessível e a porta escolhida do broker MQTT está aberta para a transmissão de dados.

Os curingas "+" e "#" nos nomes dos tópicos não são suportados.

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[IP do broker]	Endereço de IP do MQTT broker	Por exemplo: 3.69.1.9	r w 1
[Porta do broker]	Endereço da porta do MQTT broker	Por exemplo: 1883	r w 1
[Tópico]	Nome do tópico de comando MQTT	Por exemplo: reqTopic	r w 1
[Tópico de resposta]	Nome do tópico de resposta MQTT	Por exemplo: resp Topic	r w 1
[Nome de usuário]	Nome de usuário	Por exemplo: user1	r w 1

1 leitura e escrita

8.2.8 Atualização do firmware

O ifm moneo|blue oferece a opção de atualizar o firmware da estação base Bluetooth mesh IoT.

Novo firmware disponível na página de informações detalhadas sobre o dispositivo: documentation.ifm.com
A atualização do firmware não deve ser interrompida.

▶ Não reinicie o dispositivo durante a atualização.

▶ Espere até que a atualização esteja concluída.

Pré-requisitos:

√ O arquivo de firmware da estação base Bluetooth mesh IoT é armazenado no sistema de arquivos do dispositivo móvel.
√ O ifm moneo|blue foi iniciado.

▶ Estabeleça uma conexão com a estação base Bluetooth mesh IoT.
▶ Acesse a visualização de editor da estação base Bluetooth mesh IoT.
▶ No cabeçalho: Clique em ↑.

▷ Aparece uma janela de diálogo.

▶ Seleccione a opção [Update Base station].
▶ Na área [Select update file]: Clique em [Browse].
▶ Seleccione o novo arquivo de firmware.
▷ A página de menu mostra o arquivo de firmware selecionado.
▶ Clique em [Importar].

▷ O firmware é transmitido para o dispositivo.
▷ É exibida uma mensagem para instalar o novo firmware e reiniciar o dispositivo.

▶ Clique em [OK] para confirmar a mensagem.

▷ O firmware da estação base Bluetooth mesh IoT é atualizada.
▷ O dispositivo é reiniciado.

▷ O novo firmware é instalado na estação base Bluetooth mesh IoT.

8.2.8.1 Atualização do firmware dos adaptadores conectados

O ifm moneo|blue oferece a opção de atualizar o firmware dos adaptadores Bluetooth mesh IO-Link conectados via estação base Bluetooth mesh IoT.

Novo firmware disponível na página de informações detalhadas sobre o dispositivo: documentation.ifm.com

Para obter informações sobre como atualizar o firmware de um único adaptador Bluetooth mesh IO-Link: Manual de operação EIO344

A atualização do firmware não deve ser interrompida.

▶ Não reinicie o dispositivo durante a atualização.
▶ Espere até que a atualização esteja concluída.

Pré-requisitos:

√ O arquivo de firmware dos adaptadores Bluetooth mesh IO-Link é armazenado no sistema de arquivos do dispositivo móvel.
√ O ifm moneo|blue foi iniciado.

▶ Estabeleça uma conexão com a estação base Bluetooth mesh IoT.
▶ Acesse a visualização de editor da estação base Bluetooth mesh IoT.
▶ No cabeçalho: Clique em ↑.

▷ Aparece uma janela de diálogo.

▶ Seleccione a opção [Update all connected mesh adapters].
▶ Na área [Select update file]: Clique em [Browse].
▶ Seleccione o novo arquivo de firmware.

▷ A página de menu mostra o arquivo de firmware selecionado.

▶ Clique em [Importar].

▷ O arquivo de firmware é transmitido para a estação base Bluetooth mesh IoT.
▷ É exibida uma mensagem informando que há um novo firmware disponível para os adaptadores conectados.

▶ Clique em [Update].

▷ O novo firmware é transferido para todos os adaptadores Bluetooth mesh IO-Link conectados.
▷ Firmware será atualizado.
▷ Todos os adaptadores são reiniciados.

▷ O novo firmware é instalado em todas as estações base Bluetooth mesh IO-Link.

8.3 ifm IoT Core REST API

8.3.1 ifm IoT Core: Informações gerais

O dispositivo tem o ifm IoT Core. O ifm IoT Core representa a funcionalidade do dispositivo. A funcionalidade consiste em um conjunto de dados, serviços e eventos. Os elementos do ifm IoT Core são organizados em um objeto JSON em uma estrutura de árvore hierárquica. O ifm IoT Core disponibiliza esses elementos para sistemas externos através de interfaces padrão (por exemplo, HTTP). Isso permite que o usuário e outros dispositivos acessem os dados (parâmetros, dados de processo), eventos (events) e funções (serviços) do dispositivo.

8.3.1.1 Acesso ao ifm IoT Core

O acesso a um elemento do ifm IoT Core é feito através de seu endereço (por exemplo, root/port1/pin2). O endereço é composto pelo caminho que leva ao elemento (root/port1) e pelo identificador do elemento (pin2).

▷ O usuário pode acessar o ifm IoT Core através de solicitações HTTP. Os seguintes métodos são suportados.

Método GET

Acesso: leitura

Sintaxe da solicitação (request):

http://ip/data_point/service 

Parâmetro	Descrição
ip	Endereço IP da interface IoT
data_point	Ponto de dados ao qual se deseja acessar
service	Serviço

Sintaxe da resposta (response):

{
    "cid": id,
    "data": {"value":"resp_data"},
    "adr": "data_point/service",
    "code": diag_code
} 

Campo	Parâmetro	Descrição
cid	id	ID de correlação para relacionar a solicitação e a resposta
data	resp_data	Valor do ponto de dados; dependendo do tipo de dados do ponto de dados
adr	data_point	Ponto de dados ao qual foi acessado
	service	Serviço pelo qual o ponto de dados foi acessado
code	diag_code	Código de diagnóstico

Exemplo: Solicitação GET

- Solicitação (via navegador):

http://192.168.0.79/deviceinfo/productname/getdata 

- Resposta:

{
    "cid": -1,
    "data": {"value":"EI0404"},
    "adr": "/deviceinfo/productname/getdata",
    "code": 200
} 

Método POST

Acesso: lesend, schreibend

Sintaxe da solicitação (request):

{
    "code": "code_id",
    "cid": id,
    "adr": "data_point/service",
    "data": {req_data},
    "auth": {"user": "usr_id", "passwd": "password"}
} 

Campo	Parâmetro	Descrição
code	code_id	Classe de serviçorequest: Solicitaçãotransaction: Transaçãovevent: Evento
cid	id	ID de correlação para relacionar, em pares, a solicitaçãoe a resposta; de livre escolha pelo usuário
adr	data_point	Ponto de dados ao qual se deseja acessar
	service	Serviço pelo qual o ponto de dados deve ser acessado
data 1	req_data	Dados enviados ao ifm IoT Core (por exemplo, novos valores); sintaxe depende do serviço
auth 2	usr_id	Nome de usuário (codificado em Base64); Predefinido: administrator
	password	Senha (codificada em Base64)

1 opcional; necessário apenas para serviços que enviam dados ao ifm IoT Core (por exemplo, setdata)
2 opcional; necessário apenas quando o modo de segurança está ativado

Sintaxe da resposta (response):

{
    "cid": id,
    "data": {resp_data},
    "adr": "data_point/service",
    "code": diag_code
} 

Campo	Parâmetro	Descrição
cid	id	ID de correlação para relacionar a solicitação e a resposta (→ request)
data1	resp_data	Valores retornados pelo ifm IoT Core; sintaxe depende do serviço
adr	data_point	Ponto de dados ao qual foi acessado
	service	Serviço pelo qual o ponto de dados foi acessado
code	diag_code	Código de diagnóstico

1 opcional; disponível apenas para serviços que recebem dados do ifm IoT Core (por exemplo, getdata)

Exemplo: Solicitação POST

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/deviceinfo/devicename/getdata"
} 

Resposta (response):

{
    "cid": 1,
    "data": {
    "value": "New Base"
    },
    "adr": "/deviceinfo/devicename/getdata",
    "code": 200
} 

Códigos de diagnóstico

Código	Texto	Descrição
200	OK	Solicitação processada com sucesso
400	Bad request	Solicitação inválida
403	Forbidden	Solicitação proibida
404	Element not found:	O endereço especificado não existe
408	Request Timeout	Tempo limite excedido ao aguardar a resposta à solicitação
404	Element not found:	O serviço solicitado não existe.
413	Request payload too large	A carga útil é muito grande
414	Request-URL too long	URL da solicitação é muito longo
416	Request Range Not Satisfiable	O intervalo solicitado não está dentro dos limites permitidos
422	Invalid payload. Invalid:	Os dados enviados / carga útil são inválidos
423	The service is busy	O serviço está bloqueado, desativado ou ocupado
424	Failed dependency:	A execução do serviço atualmente não é permitida (verifique as dependências)
429	Too many requests	Número de solicitações muito elevado
500	Internal Server Error	Falha interna
501	Not implemented	Não implementado
502	Remote service failed with code:	Solicitação ao dispositivo remoto falhou com mensagem de erro
503	Service Unavailable	Serviço indisponível
507	Insufficient storage	Memória do dispositivo insuficiente
550	Service execution failed	Falha na execução do serviço
901	Already exists	O elemento ou link para o elemento já existe no mesmo local na árvore IoT Core

8.3.2 Primeiros passos

O ifm IoT Core contém elementos que se destinam apenas ao uso interno da ifm. Estes elementos não são exibidos na consulta ao serviço gettree. Os elementos são protegidos contra o acesso não autorizado.

Para exibir a estrutura de árvore completa do IoT Core do dispositivo, envie a seguinte solicitação POST ao ifm IoT Core:

{
    "code":"request",
    "cid":-1,
    "adr":"/gettree"
} 

O ifm IoT Core retorna a estrutura de árvore completa como um objeto JSON estruturado.

▶ Na estrutura de árvore do objeto JSON, identifique todas as subestruturas e os pontos de dados contidos nelas.
▶ Identifique os serviços aplicáveis para acessar subestruturas e pontos de dados contidos nelas.

8.3.3 Funções gerais

O dispositivo é do tipo device (→ Tipos ☐ 67). Os seguintes serviços podem ser aplicados ao nó raiz da árvore de dispositivos:

Serviço	Descrição
../gettree	Exportar a árvore completa ou subárvore da descrição do dispositivo (JSON)
../getidentity	Ler informações de identificação do dispositivo
../getdatamulti	Ler vários elementos sequencialmente
../getelementinfo	Ler informações detalhadas de um elemento
../getsubscriberlist	Exportar uma lista de todas as inscrições de notificação ativas
../querytree	Pesquisar elementos específicos na descrição do dispositivo

Nos elementos do tipo data, dependendo das permissões de acesso definidas, os seguintes serviços podem ser aplicados:

Serviço	Descrição
../getdata	Ler o valor do elemento
../setdata	Escrever o valor do elemento

8.3.3.1 Exemplo: Alterar o valor do parâmetro

Tarefa: O parâmetro device name do dispositivo deve ser definido com o valor "New Base Station".

Solução Use o serviço setdata para escrever o novo valor do elemento deviceinfo/devicename.

Solicitação (request):

{
    "code": "request",
    "cid": 4711,
    "adr": "/deviceinfo/devicename/setdata",
    "data": {
    "newvalue": "New Base Station",
    }
} 

Resposta (response):

{
    "cid":4711,
    "adr":"/deviceinfo/devicename/setdata",
    "code":200
} 

8.3.3.2 Exemplo: Ler vários valores de parâmetros simultaneamente

Tarefa: As seguintes informações atuais do dispositivo devem ser lidas: Temperatura, Número de série

Solução Leia os valores atuais dos parâmetros com o serviço getdatamulti (Ponto de dados Temperatura: /processdatabasestation/temperature/cpu; Ponto de dados Número de série: /deviceinfo/serialnumber).

Solicitação (request):

{
    "code":"request",
    "cid":4711,
    "adr":"/getdatamulti",
    "data":{
    "datatosend":[
    "/processdatabasestation/temperature/cpu",
    "/deviceinfo/serialnumber"
    ]
    }
} 

Resposta (response):

{
    "cid":4711,
    "data":{
    "processdatabasestation/temperature/cpu":{
    "code":200,
    "data":32
    },
    "deviceinfo/serialnumber":{
    "code":200,
    "data":"000174210147"
    }
},
"adr":"getdatamulti",
"code":200
} 

8.3.3.3 Exemplo: Exportar subárvore

Tarefa: Exportar todos os subelementos diretos do nó meshnetwork.

Solução Use o serviço gettree para exportar a subárvore desejada (nó raiz: meshnetwork, subníveis a exibir: 1)

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/gettree",
    "data": {
    "adr": "/meshnetwork/",
    "level": 1
    }
} 

Resposta (response):

{
    "cid": 1,
    "data": {
    "identifier": "meshnetwork",
    "type": "structure",
    "subs": [
    {
    "identifier": "provisioning",
    "type": "structure",
    "profiles": [
    "wirelessprovisioning"
    ]
    },
    {
    "identifier": "mesh_adapter[1]",
    "type": "subdevice",
    "profiles": []
    },
    {
    "identifier": "adapter_update",
    "type": "structure",
    "profiles": [
    "software",
    "software/uploadablesoftware"
    ]
    }
    ]
},
"adr": "/gettree",
"code": 200
} 

8.3.3.4 Exemplo: Pesquisar o IoT Core

Tarefa: Todos os elementos com o perfil datarequired devem ser listados.

Solução Use o serviço querytree para pesquisar o parâmetro datarequired (profile) no IoT Core do dispositivo.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/querytree",
    "data": {
    "profile": "datarequired"
    }
} 

Resposta (response):

{
    "cid": 1,
    "data": {
    "adrList":[
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/ipaddress",
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/subnetmask",
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/dhcp",
    "00-02-01-42-DC-9D/iotsetup/ethernet/network/ipdefaultgateway"
    ]
},
"adr": "/querytree",
"code": 200
} 

8.3.4 Ethernet: Configurar os ajustes IP.

Subestrutura: iotsetup/ethernet/network

▶ Os pontos de dados da subestrutura network só podem ser alterados em blocos usando o serviço setblock!

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../dhcp	Método de configuração para configurações IP da interface	0: IP estático: endereço estático (default)1: DHCP: Endereço atribuído por DHCP (Dynamic Host Configuration Protocol)	rw1
../ipaddress	Endereço IP da interface	por exemplo: 192.168.0.79 (predefinido)	rw12
../subnetmask	Máscara de sub-rede do segmento de rede	por exemplo: 255.255.255.0 (default)	rw12
../ipdefaultgateway	Endereço IP da rede gateway	por exemplo: 192.168.0.100 (predefinido)	rw12
../macaddress	Endereço MAC da interface	Por exemplo: 00-02-01-42-DC-9D	ro3

¹ leitura e escrita
² apenas modificável se o DHCP estiver desativado
³ apenas leitura

Serviços aplicáveis:

Nome	Descrição
../setblock	Escrever todos os pontos de dados da subestrutura em blocos

8.3.5 Ethernet: configuração protegida por senha

A proteção por senha protege o dispositivo contra o acesso não autorizado por meio da interface Ethernet.

Após definir a senha, o usuário deverá incluir o campo "auth" nos pedidos POST, com um nome de usuário válido ("user") e a senha ("passwd") para a autenticação.

O nome de usuário é administrator. O nome de usuário é fixo e não pode ser alterado.

O nome de usuário e a senha são representados como strings em Base64: Exemplo: Solicitar com autenticação (→ ☐ 31)

No modo de proteção por senha ativado, os seguintes pedidos podem ser executados mesmo sem autenticação:

- getidentity

• deviceinfo/vendor/getdata
• deviceinfo/productcode/getdata

Subestrutura: iotsetup/ethernet/security

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../password	Definir senha para autenticação (string codificada em Base64)Comprimento mínimo: 6 Comprimento máximo: 32	Por exemplo: ZXRoX3 Bhc3N3b3Jk	wo 1

1 apenas escrita

Conjunto de caracteres válido para a senha antes da codificação em Base64: UTF-8 sem caracteres de controle

Serviços aplicáveis:

Nome	Descrição
../resetpassword	excluir a senha de Ethernet

8.3.5.1 Exemplo: Definir senha Ethernet

Tarefa: A conexão Ethernet deve ser protegida por uma senha (senha: eth_password)

Solução: usar o serviço setdata para escrever a senha eth_password (codificada em Base64: ZXRoX3
Bhc3N3b3Jk) no ponto de dados iotsetup/ethernet/security/password.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/password/setdata",
    "data": {
    "newvalue": "ZXRoX3
Bhc3N3b3Jk"
    }
} 

Resposta (response):

{
    "code": "request",
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/password/setdata",
    "code": 200
} 

A interface Ethernet está protegida por senha. O serviço getidentity (→ Serviço: getidentity ☐ 69) mostra que a senha está configurada.

8.3.5.2 Exemplo: Solicitar com autenticação

Tarefa: Ler a temperatura do dispositivo. A senha está definida (senha: eth_password).

Solução: usar o serviço getdata para ler o ponto de dados processdatabasestation/temperature/cpu. O nome de usuário e a senha são fornecidos como strings codificadas em Base64:

- Nome de usuário:

- administrator: YWRtaW5pc3RyYXRvcg==
- Senha:
- eth_password: ZXRoX3
Bhc3N3b3Jk 

Solicitação (request):

{
    "code": "request",
    "cid": -1,
    "adr": "/processdatabasestation/temperature/cpu/getdata",
    "auth": {
    "user": "YWRtaW5pc3RyYXRvcg==",
    "passwd": "ZXRoX3
Bhc3N3b3Jk"
    }
} 

Resposta (response):

{
    "cid": -1,
    "adr": "/processdatabasestation/temperature/cpu/getdata",
    "data": {
    "value": 37
    },
    "code": 200
} 

8.3.5.3 Exemplo: excluir a senha de Ethernet

Tarefa: o acesso ao dispositivo através da interface Ethernet está protegido por uma senha (senha: eth_password). A senha deve ser excluída.

Solução: utilize o serviço resetpassword para escrever na subestrutura iotesetup/ethernet/security. O nome de usuário e a senha são fornecidos como strings codificadas em Base64.

- Nome de usuário:
  - administrator: YWRtaW5pc3RyYXRvcg==
- Senha:
  - eth_password: ZXRoX3
Bhc3N3b3Jk 

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/resetpassword",
    "auth": {
    "user": "YWRtaW5pc3RyYXRvcg==",
    "passwd": "ZXRoX3
Bhc3N3b3Jk"
    }
} 

Resposta (response):

{
    "cid": 1,
    "adr": "/iotsetup/ethernet/security/resetpassword",
    "code": 200
} 

8.3.6 Bluetooth: Configurar nome da estação

Subestrutura: iotsetup/bluetooth_le

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../bluetooth_name	Nome da estação do dispositivo (string com no máximo 22 caracteres)	Por exemplo: eio404_base	rw 1

1 leitura e escrita

8.3.7 Bluetooth: configuração protegida por senha

▶ Observe as informações sobre os requisitos para a senha do Bluetooth: Senha Bluetooth (→ ☐ 17)

Subestrutura: iotsetup/bluetooth_le/security

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../security/password	Definir senha para autenticação na interface Bluetooth LE (string codificada em Base64)Comprimento mínimo: 6 Comprimento máximo: 32AVISO! A senha não afeta a funcionalidade mesh.	Por exemplo: YmxIX3 Bhc3N3b3Jk	wo 1
../security/password_state	Status atual da senha do Bluetooth	0: Default Password – senha definida de fábrica (últimos 6 dígitos do número de série)1: User specific password - Senha específica do usuário	ro 2

1 apenas escrita
² apenas leitura

Conjunto de caracteres válido para a senha antes da codificação em Base64: UTF-8 sem caracteres de controle

Serviços aplicáveis:

Nome	Descrição
../resetpassword	Redefinir a senha para configurações de fábrica

8.3.7.1 Exemplo: alteração da senha do Bluetooth

Tarefa: a senha do Bluetooth deve ser definida com o valor ble_password.

Solução: usar o serviço setdata para escrever a senha ble_password (codificada em Base64: Ymx1X3
Bhc3N3b3Jk) no ponto de dados /iotsetup/bluetooth_le/security/password.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "iotsetup/bluetooth_le/security/password/setdata",
    "data": {
    "newvalue": "Ymx1X3
Bhc3N3b3Jk"
    }
} 

Resposta (response):

{
    "cid":1,
    "adr":"iotsetup/bluetooth_le/security/password/setdata",
    "code":200
} 

8.3.8 Gerenciar rede Bluetooth Mesh

Subestrutura: meshnetwork/provisioning

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../max_nodes	Número máximo de nós	50	ro 1
../current_nodes	Número atual de nós na rede Mesh	0...50	ro 1
../valid_credits_count	Número atual de créditos Bluetooth Mesh utilizados	0...65535	ro 1

¹ apenas leitura

Serviços aplicáveis:

Nome	Descrição
../scan	Escanear o ambiente do dispositivo em busca de nós disponíveis
../register	Registrar um nó na rede Mesh
../unregister	Desconectar um nó da rede Mesh
../replace	Substituir um nó na rede Mesh
../get_credit	Solicitar crédito da rede Mesh para adicionar um nó à rede
../reset_credits	Redefinir créditos atualmente solicitados

8.3.8.1 Exemplo: Procurar por adaptadores Mesh disponíveis

Tarefa: Procurar por adaptadores Bluetooth Mesh disponíveis no ambiente do dispositivo.

Solução: Executar o serviço scan na subestrutura meshnetwork/provisioning.

Solicitação (request):

{
    "code": "request",
    "cid": 4711,
    "adr": "/meshnetwork/provisioning/scan"
} 

Resposta (response):

{
    "cid":4711,
    "data":[{
    "id": "XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX",
    "name": "EIO344 ifm SN: 123456789011",
    "info": [
    {
    "key": "MAC Address",
    "value": "aa-bb-cc-dd-ee-ff"
    },
    {
    "key": "Signal Strength",
    "value": 77
    }
    ]
}],
"adr":"/meshnetwork/provisioning/scan",
"code":200
} 

A estação base encontrou um adaptador Bluetooth Mesh com a UUID (campo "id") e um nome (campo "name"). O adaptador Mesh tem um endereço MAC e uma intensidade de sinal de 77%.

8.3.8.2 Exemplo: Registrar o adaptador Mesh na rede Mesh

Tarefa: Usar os dados identificados durante o escaneamento da rede para registrar o adaptador Mesh na rede Bluetooth Mesh.

Solução: Executar o serviço register na subestrutura meshnetwork/provisioning. A UUID do adaptador Mesh deve ser fornecida.

Solicitação (request):

{
    "code":10,
    "cid": 4711,
    "adr":"/meshnetwork/provisioning/register",
    "data":{
    "id":"XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX"
    }
} 

Resposta (response):

{
    "code":200,
    "cid":4711,
    "adr":"/meshnetwork/provisioning/register",
    "data":{
    "adr":"/meshnetwork/mesh_adapter[1]"
    }
} 

Após o registro bem-sucedido do adaptador Bluetooth Mesh, sua árvore IoT Core é conectada à árvore IoT Core da estação base Bluetooth Mesh (subestrutura meshnetwork/mesh_adapter[x] (x: 1...50)).

8.3.8.3 Exemplo: Substituir adaptador Mesh

Tarefa: Substituir o adaptador Mesh registrado na rede Bluetooth Mesh com a UUID "XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX" pelo adaptador Mesh com a UUID "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY".

Solução: Executar o serviço replace na subestrutura meshnetwork/provisioning. As UUIDs de ambos os adaptadores Mesh devem ser fornecidas.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/meshnetwork/provisioning/replace",
    "data": {
    "old_id": "XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX",
    "new_id": "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY"
    }
} 

Resposta (response):

{
    "cid": 1,
    "adr": "/meshnetwork/provisioning/replace",
    "code": 200
} 

8.3.8.4 Exemplo: Desconectar adaptador Mesh da rede Mesh

Tarefa: Desconectar o adaptador Bluetooth Mesh com a UUID "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY" da rede Mesh.

Solução: Executar o serviço unregister na subestrutura meshnetwork/provisioning. A UUID do adaptador Mesh deve ser fornecida.

Solicitação (request):

Solicitação (request):

{
    "code": "request",
    "cid": 4711,
    "adr": "/meshnetwork/provisioning/unregister",
    "data": {
    "id": "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY"
    }
} 

Resposta (response):

{
    "cid":4711,
    "adr": "/meshnetwork/provisioning/unregister",
    "code":200
} 

A subestrutura do adaptador Mesh (mesh_adapter[x] (x: 1...50)) é removida da árvore IoT Core da estação base Mesh.

8.3.9 Gerenciar adaptador Bluetooth mesh IO-Link

Para cada adaptador Bluetooth Mesh IO-Link conectado à rede é criada uma subestrutura mesh_adapter[x] (x:1...50) sob meshnetwork. A subestrutura contém o IoT Core do adaptador Bluetooth Mesh IO-Link com estruturas e pontos de dados específicos do dispositivo.

Descrição do IoT Core dos adaptadores Bluetooth Mesh IO-Link: → Manual de operação do EIO344

O acesso ao IoT Core do adaptador Bluetooth Mesh IO-Link só é possível através da estação base Bluetooth Mesh IoT. Para isso, o adaptador deve estar conectado à rede Bluetooth Mesh.

8.3.10 Configurar temporizadores

O dispositivo tem 2 temporizadores. Os temporizadores podem ser usados para a transmissão programada de notificações (→ Utilização de notificações ☐ 38).

Subestrutura: timer[1] | timer[2]

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../counter	Valor do contador	0...4294967295	ro 1
../interval	Intervalo de contagem (valor em ms)	1000: 1000 ms86400000: 86400000 ms	rw 2
../interval/unit	Unidade do intervalo de contagem	ms: milissegundos	ro 1
../status	Status do contador	0: stopped: contador parado1: running: contador em execução	ro 1

¹ apenas leitura
² leitura e escrita

Serviços aplicáveis:

Nome	Descrição
../status/start	Iniciar contador
../status/stop	Parar contador

8.3.10.1 Exemplo: Definir intervalo de contagem

▷ O intervalo de contagem do temporizador 2 deve ser definido como 2,5 s.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/timer[2]/interval/setdata",
    "data": {
    "newvalue": 2500
    }
} 

Resposta (response):

{
    "cid": 1,
    "adr": "/timer[2]/interval/setdata",
    "code": 200
} 

8.3.10.2 Exemplo: Iniciar contador

O contador do temporizador 2 está configurado e deve ser iniciado.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/timer[2]/status/start"
} 

Resposta (response):

{
    "cid": 1,
    "adr": "/timer[2]/status/start",
    "code": 200
} 

8.3.10.3 Exemplo: Parar contador

O contador do temporizador 2 está em execução e deve ser parado.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/timer[2]/status/stop"
} 

Resposta (response):

{
    "cid": 1,
    "adr": "/timer[2]/status/stop",
    "code": 200
} 

8.3.11 Utilização de notificações

O dispositivo suporta o envio de notificações. Uma notificação pode conter os valores atuais de um ou vários dados de processo.

Tipos de notificações disponíveis:

• Notificações acionadas por eventos (→ 39)
• Notificações programadas (→ 39)

As notificações são enviadas para um endereço de destino específico. O endereço de destino consiste nos elementos protocolo de transmissão, endereço IP, porta e tópico (por exemplo: http://192.168.100.254:80/myTopic)

Protocolos de transmissão suportados:

• http
• mqtt

É possível configurar a duração da atividade de uma notificação.

O usuário pode usar o serviço getsubscriberlist para visualizar todas as notificações ativas.

8.3.11.1 Notificações acionadas por eventos

Todos os elementos do ifm IoT Core com um subelemento do tipo event podem ser usados como gatilhos para notificações acionadas por eventos.

Nome	Descrição
../datachanged	Nó para exibir alterações de valor do nó de dados superior
../eventcollection	Nó para exibir alterações de valor de vários nós de dados do IoT Core
../treechanged	Nó para exibir alterações de estrutura no IoT Core

Serviços aplicáveis:

Nome	Descrição
../subscribe	Registrar notificações
../unsubscribe	Cancelar registro de notificações

8.3.11.2 Notificações programadas

O ifm IoT Core oferece 2 temporizadores que podem ser usados como gatilhos para notificações programadas.

Nome	Descrição
../timer[1]/counter/datachanged	Contador do temporizador 1
../timer[2]/counter/datachanged	Contador do temporizador 2

É possível configurar o intervalo dos temporizadores. Cada pulso de contagem aciona uma notificação.

Serviços aplicáveis:

Nome	Descrição
../subscribe	Registrar notificações
../unsubscribe	Cancelar registro de notificações

8.3.11.3 Exemplo: Criar notificação programada

Tarefa: Os valores dos seguintes parâmetros devem ser enviados a cada 10 segundos para o tópico myData em um computador de rede com o endereço IP 192.168.0.4:

• Dados de entrada IO-Link do sensor para o adaptador Bluetooth Mesh IO-Link 1
• Temperatura operacional da estação base Bluetooth Mesh IoT

Solução: A solução consiste em 3 etapas:

▶ Configurar o intervalo de contagem do temporizador 1 (10 s = 10000)
- Solicitação (request):

{
    "code":"request",
    "cid":4712,
    "adr":"/timer[1]/interval/setdata",
    "data":{
    "newvalue":10000
    }
} 

▶ Iniciar o temporizador 1
- Solicitação (request):

{
    "code": "request",
    "cid": 4712,
    "adr": "/timer[1]/counter/start",
} 

▶ Ativar notificações

- Solicitação (request):

{
    "code": "request",
    "cid": 4711,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "http://192.168.0.4:80/myData",
    "datatosend": [
    "/meshnetwork/mesh_adapter[1]/iolinkmaster/port[1]/iolinkdevice/pdin",
    "/processdatabasestation/temperature/cpu"
    ]
    }
} 

A notificação é transmitida no formato JSON. A notificação tem a seguinte estrutura:

{
    "code": "event",
    "cid": 4711,
    "adr": "",
    "data": {
    "eventno": "6317",
    "srcurl": "/timer[1]/counter/datachanged",
    "payload": {
    "/timer[1]/counter": {
    "code": 200,
    "data": 1
    },
    "/processdatabasestation/temperature/cpu": {
    "code": 200,
    "data": 39
    },
    "/meshnetwork/mesh_adapter[1]/iolinkmaster/port[1]/iolinkdevice/pdin": {
    "code": 200,
    "data": "03B0"
    }
    }
    }
} 

8.3.11.4 Exemplo: Criar notificação acionada por eventos

Tarefa: Quando ocorrerem alterações na rede Bluetooth Mesh, uma mensagem com o número de adaptadores Mesh conectados deve ser enviada para um servidor (endereço IP do servidor: 192.168.82.100, porta: 80, tópico: myData).

Solução:

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/treechanged/subscribe",
    "data": {
    "callback": "http://192.168.82.100:80/myData"
    "datatosend": [
    "/meshnetwork/provisioning/current_nodes"
    ]
    }
} 

Resposta (response):

{
    "cid": 1,
    "adr": "/treechanged/subscribe",
    "code": 200
} 

8.3.11.5 Exemplo: Mostrar mensagens ativas

Tarefa: Todas as notificações ativas devem ser exibidas.

Solução: Usar o serviço getsubscriberlist para ler todas as notificações ativas.

Solicitação (request):

{
    "code": "request",
    "cid": 4711,
    "adr": "/getsubscriberlist"
} 

Resposta (response):

{
    "cid": 4711,
    "data": [
    {
    "adr": "00-02-01-0B-AA-06/timer[1]/counter/datachanged",
    "datatosend": [
    "00-02-01-0b-aa-06/mesh_adapter[1]/iolinkmaster/port[1]/iolinkdevice/pdin",
    "00-02-01-0b-aa-06/processdatabasestation/temperature"
    ],
    "cid": 4711,
    "callbackurl": "http://192.168.0.4:80/myData",
    }
    ],
    "adr":"getsubscriberlist",
    "code": 200
} 

8.3.11.6 Exemplo: Alterar notificação

Tarefa: A inscrição existente deve ser alterada. A tensão operacional deve ser transmitida em lugar da temperatura da estação base Bluetooth.

Solução: Sobrescrever a inscrição existente. Para isso, os valores dos parâmetros "cid" e "callback" na solicitação devem ser os mesmos da inscrição existente.

Solicitação (request):

{
    "code": "request",
    "cid": 4712,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "http://192.168.0.4:80/myData",
    "datatosend": [
    "/meshnetwork/mesh_adapter[1]/iolinkmaster/port[2]/iolinkdevice/pdin",
    "/processdatabasestation/voltage/input"
    ]
    }
} 

Resposta (response):

{
    "cid":4712,
    "adr":"/timer[1]/counter/datachanged/subscribe",
    "code":200
} 

8.3.11.7 Exemplo: Eliminar notificação

Tarefa: A notificação existente deve ser excluída.

Solução: Usar o serviço unsubscribe para excluir a notificação. Para isso, o valor do parâmetro "callback" na solicitação deve ser o mesmo da notificação existente.

Solicitação (request):

{
    "code": "request",
    "cid": 4712,
    "adr": "/timer[1]/counter/datachanged/unsubscribe",
    "data": {
    "callback": "http://192.168.0.4:80/myData"
    }
} 

8.3.12 Uso de MQTT

O ifm IoT Core suporta o protocolo MQTT. O MQTT permite que um cliente se comunique com o ifm IoT Core por meio de um broker para solicitar e receber dados. O ifm IoT Core pode publicar mensagens em um broker MQTT (publish).

Para habilitar a comunicação MQTT, o usuário deve configurar o canal de comando MQTT. A configuração inclui as seguintes etapas:

▶ Verificar a acessibilidade do broker MQTT.
▶ Verificar se a porta desejada do broker MQTT está aberta.
▶ Ativar o canal de comando MQTT.
▶ Configurar o canal de comando MQTT.
▶ Configurar a conexão MQTT.

▷ A conexão MQTT está configurada e ativada.

Após a configuração do canal de comando MQTT e da conexão MQTT, os dados podem ser publicados no broker MQTT (publish). A publicação de dados no broker MQTT é realizada através do serviço subscribe.

8.3.12.1 Configuração da conexão MQTT

O seguinte diagrama de status mostra a influência dos serviços start, stop e reset no status atual de uma conexão MQTT:

Após uma inicialização bem-sucedida no status init, a conexão automaticamente muda para o status running.

A conexão automaticamente entra no status error se pelo menos um dos seguintes eventos ocorrer:

- Nenhum broker MQTT disponível

Subestrutura: connections/mqttconnection

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../type	Tipo de conexão (MQTT)	mqtt: Conexão MQTT	ro 1
../status	Status da conexão MQTT	init: Status init – Inicializaçãostopped: Status stopped – Conexão suspensarunning: Status running – Conexão em execuçãoerror: Status error - Status de erro	ro 1
../status/preset	Predefinição do status da conexão MQTT	running: Status running (predefinido)	ro 1
../MQTTSetup	Subestrutura para configurações gerais do MQTT
../MQTTSetup/QoS	Qualidade de Serviço (QoS) da conexão MQTT	0: QoS Nível 0 - PUBLISH (sem confirmação) (default)1: QoS Nível 1 - PUBLISH > PUBREC (confirmação simples)2: QoS Nível 2 - PUBLISH > PUBREL > PUBCOMP (confirmação dupla)	rw 2
../MQTTSetup/version	Versão MQTT	Por exemplo: 3.1.1	ro 1
../MQTTSetup/KeepAlive	KeepAlive: Tempo máximo entre 2 pacotes consecutivos do protocolo MQTT (valor em segundos)	0: desativada...10: 10 s (default)...60: 60 s	rw 2

¹ apenas leitura
² leitura e escrita

Serviços aplicáveis:

Nome	Descrição
../status/start	Ativar MQTT.
../status/stop	Desativar MQTT.
../status/reset	Redefinir MQTT.

8.3.12.2 Configurar o canal de comando MQTT

▷ O canal de comando MQTT permite enviar e receber notificações (→ Utilização de notificações ☐ 38) do ifm IoT Core.

Certifique-se de que o broker MQTT está acessível e a porta escolhida do broker MQTT está aberta para a transmissão de dados.

Os curingas "+" e "#" nos nomes dos tópicos não são suportados.

Subestrutura: connections/mqttconnection/mqttcmdchannel

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../type	Tipo do canal de comando	• mqtt: Canal de comando MQTT (default)	ro 1
../status	Status do canal de comando	• init: Status init• stopped: Status stopped• running: Status running (predefinido)• error: Status error	ro 1
../status/preset	Status de canal predefinido	• running: Status running (predefinido)	ro 1
../mqtt CmdChannel Setup	Subestrutura das configurações do canal de comando	--
../mqtt CmdChannel Setup/brokerIP	Endereço de IP do MQTT broker	Por exemplo: 3.69.1.9	rw 2
../mqtt CmdChannel Setup/broker Port	Endereço da porta do MQTT broker	Por exemplo: 1883	rw 2
../mqtt CmdChannel Setup/cmdTopic	Nome do tópico de comando MQTT	Por exemplo: reqTopic	rw 2
../mqtt CmdChannel Setup/default ReplyTopic	Nome do tópico de resposta MQTT padrão	Por exemplo: resp Topic	rw 2
../mqttcmdchannelsetup/user	Nome de usuário	Por exemplo: user1	rw 2
../mqttcmdchannelsetup/password	Senha (não codificada em Base64)	Por exemplo: passwort123	rw 2

¹ apenas leitura
² leitura e escrita

Serviços aplicáveis:

Nome	Descrição
../status/start	Iniciar canal MQTT
../status/stop	Parar canal MQTT
../status/reset	Redefinir canal MQTT

8.3.12.3 Exemplo: Configurar e ativar o canal de comando MQTT

Tarefa: ▷ O canal de comando MQTT para um broker MQTT deve ser configurado (endereço IP: 192.168.82.100, porta: 1883, tópico de comando: reqTopic, tópico de resposta padrão: resp
Topic). A conexão MQTT deve ser configurada para o nível 2 de QoS.

Solução: A solução consiste nas seguintes etapas:

▶ Verificar se o broker MQTT está acessível e a porta desejada está liberada.
▶ Ativar o canal de comando.

Solicitação (request):

{
    "code": "request",
    "cid": 1,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/status/start"
} 

▶ Configurar o endereço IP do broker MQTT.

Solicitação (request):

{
    "code": "request",
    "cid": 2,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/brokerIP/setdata",
    "data": {
    "newvalue": "192.168.82.100"
    }
} 

▶ Configurar a porta do broker MQTT.

Solicitação (request):

{
    "code": "request",
    "cid": 3,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/broker
Port/setdata",
    "data": {
    "newvalue": 1883
    }
} 

▶ Configurar o nome do tópico.

Solicitação (request):

{
    "code": "request",
    "cid": 4,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/cmdTopic/setdata",
    "data": {
    "newvalue": "reqTopic"
    }
} 

▶ Configurar o nome do tópico de resposta padrão.

Solicitação (request):

{
    "code": "request",
    "cid": 5,
    "adr": "/connections/mqtt
Connection/mqtt
CmdChannel/mqtt
CmdChannel
Setup/default
ReplyTopic/setdata",
    "data": {
    "newvalue": "resp
Topic"
    }
} 

▶ Configurar o nível de QoS.

Solicitação (request):

{
    "code": "request",
    "cid": 6,
    "adr": "connections/mqtt
Connection/MQTTSetup/QoS/setdata",
    "data": {
    "newvalue": 2
    }
} 

8.3.12.4 Exemplo: Publicar a temperatura do dispositivo no broker MQTT

Tarefa: A temperatura do dispositivo deve ser publicada no broker MQTT a cada 10 segundos (broker MQTT: 192.168.82.100, porta: 1883, tópico: devtemp).

Solução:

Pré-requisitos:

√ ▷ A conexão MQTT está configurada.
√ ▷ A canal de comando MQTT está configurado.
√ O intervalo do temporizador 1 está configurado para 10 segundos.
√ O temporizador 1 está ativo.
▶ Publicar o valor do processo no broker MQTT com o serviço subscribe.

Solicitação (request) – broker MQTT não requer senha:

{
    "code": "request",
    "cid": 4711,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "mqtt://192.168.82.100:1883/devtemp",
    "datatosend": [
    "processdatabasestation/temperature/cpu"
    ]
    }
} 

Solicitação (request) – broker MQTT requer senha (login: user1, senha: passwort123):

{
    "code": "request",
    "cid": 4711,
    "adr": "/timer[1]/counter/datachanged/subscribe",
    "data": {
    "callback": "mqtt://user1:password123@192.168.82.100:1883/devtemp",
    "datatosend": ["processdatabasestation/temperature/cpu"]
    }
} 

Resposta (response):

{
    "cid":4711,
    "adr":"/timer[1]/counter/datachanged/subscribe",
    "code":200
} 

A notificação é enviada no formato JSON e tem a seguinte estrutura:

{
    "code": "event",
    "cid": 4711,
    "adr": "",
    "data": {
    "eventno": "6317",
    "srcurl": "/timer[1]/counter/datachanged",
    "payload": {
    "/timer[1]/counter": {"code": 200, "data": 1},
    "/processdatabasestation/temperature/cpu": {"code": 200, "data": 39}
    }
    }
} 

8.3.13 Redefinir, reiniciar e localizar o dispositivo

Subestrutura: firmware

Serviços aplicáveis:

Nome	Descrição
../factoryreset	Restaurar configurações de fábrica do dispositivo
../reboot	Reinicie o dispositivo
../signal	Ativar o piscar do LED de status

8.3.14 Ler e escrever informações do dispositivo

Subestrutura: deviceinfo

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../serialnumber	Número de série	Por exemplo: 000194610104	ro 1
../swrevision	Versão de firmware	Por exemplo: V1.36	ro 1
../bootloaderrevision	Versão do carregador de inicialização	Por exemplo: V0.06	ro 1
../productinstanceuri	Nome do nó raiz na árvore IoT Core	Por exemplo: B4-E3-F9-C7-54-43	ro 1
../eepromversion	Versão do EEPROM	Por exemplo: V0.02	ro 1
../btmacaddress	Endereço MAC do Bluetooth	Por exemplo: B4-E3-F9-C7-54-43	ro 1
../hwrevision	Versão de hardware	Por exemplo: AA	ro 1
../producttext	Nome do produto	Bluetooth Mesh IoT Basestation	ro 1
../vendor	Fabricante	ifm electronic gmbh	ro 1
../productname	Nome do produto	EIO404	ro 1
../productcode	Código do produto	EIO404	ro 1
../devicename	Nome do dispositivo específico de usuário	Por exemplo: mesh_base	rw 2

¹ apenas leitura
² leitura e escrita

8.3.15 Leitura das informações de estado e diagnóstico

Subestrutura: processdatabasestation

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
../temperature/cpu	Temperatura da CPU do dispositivo (valor em °C)	-40: -40°C...85: 85°C	ro 1
../voltage/input	Tensão de entrada do dispositivo (valor em mV)	0: 0 mV...40000: 40000 mV	ro 1
../operatingstate	Status operacional do dispositivo	0: Dispositivo OK1: Bluetooth Mesh nenhum dispositivo provisionado2: Link Ethernet não conectado3: Temperatura da eletrônica fora da faixa4: Bluetooth LE conectado5: Instalação da atualização do firmware6: Erro de hardware7: Subtensão	ro 1

¹ apenas leitura

8.4 ifm moneo|configure

8.4.1 Criação de conexão com o dispositivo

▶ Ao entrar em operação pela primeira vez, altere a senha definida de fábrica para a interface Bluetooth, Bluetooth LE: configuração protegida por senha (→ 53).

▶ Defina também a senha da interface Ethernet, IoT: configuração protegida por senha (→ ☐ 52).

Pré-requisitos:

√ O dispositivo está conectado à rede de TI através da porta Ethernet.
√ Se o moneo|configure estiver instalado e licenciado a partir do computador/laptop, Instalação do ifm moneo|configure (→ 17).
▶ Inicie o ifm moneo|configure.
▶ Busque na rede por dispositivos disponíveis (tipo de dispositivo: Generic IoT-Core device, endereço de IP: 192.168.0.79).

▷ O ifm moneo|configure reconhece o dispositivo.

▶ Na coluna [Ações]: clique em 📄.
▷ Aparece o editor para os valores dos parâmetros do dispositivo.

8.4.1.1 Provisionamento do adaptador Bluetooth mesh IO-Link

Para adicionar um adaptador Bluetooth mesh IO-Link a uma rede Bluetooth mesh, o adaptador deve ser provisionado na estação base Bluetooth mesh IoT.

Pré-requisitos:

√ O ifm moneo|configure foi iniciado.
√ O dispositivo foi encontrado pelo escaneamento de rede.

▶ Na coluna [Ações]: Clique em 🎥.

▷ Aparece uma janela de diálogo.

A estação base Bluetooth mesh IoT procura nas imediações por adaptadores Bluetooth mesh IO-Link disponíveis.
▷ Os dispositivos disponíveis são mostrados na lista.

▶ Selezione o adaptador Bluetooth mesh IO-Link.
▶ Clique em [CONECTAR].
Os adaptadores Bluetooth mesh IO-Link selecionado serão provisionados.
▷ Os dispositivos provisionados são integrantes da rede Bluetooth mesh.
▷ Na visão geral, os adaptadores provisionados aparecem como nós inferiores da estação base Bluetooth mesh IoT.

Após o provisionamento, a estação base Bluetooth mesh IoT estabelece de forma independente a conexão com todos os adaptadores Bluetooth mesh IO-Link provisionados. A conexão é estabelecida diretamente ou por meio de outros adaptadores Bluetooth mesh IO-Link.

Os adaptadores Bluetooth mesh IO-Link enviam os dados do processo para a estação base Bluetooth mesh IoT cíclicamente em um intervalo definido. Os dados do processo podem ser lidos e usados para o monitoramento do sistema.

8.4.1.2 Remoção de adaptadores Bluetooth mesh IO-Link da rede mesh

Pré-requisitos:

√ O ifm moneo|configure foi iniciado.
√ O dispositivo foi detectado pelo escaneamento de rede.
√ O adaptador Bluetooth mesh IO-Link faz parte da rede Bluetooth mesh.

▶ Na coluna [Ações]: clique em 📋.
▷ Aparece uma nota sobre as consequências da remoção.
▶ Clique em [OK] para confirmar a mensagem.
O adaptador Bluetooth mesh IO-Link é excluído da rede Bluetooth mesh.
▷ O crédito usado para o provisionamento é liberado.

8.4.2 Informação: Leitura das informações de identificação

Informações disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Serial number]	Número de série	Por exemplo: 000022503648	ro 1
[SW-Revision]	Versão de firmware	Por exemplo: V1.42	ro 1
[Bootloader revision]	Versão do carregador de inicialização	Por exemplo: V0.07	ro 1
[EEPROM revision]	Versão do EEPROM	Por exemplo: V0.03	ro 1
[Bluetooth MAC address]	Endereço MAC do Bluetooth	Por exemplo: B4-E3-F9-C7-54-43	ro 1
[HW-Revision]	Versão de hardware	Por exemplo: AA	ro 1
[Product text]	Nome do produto	Bluetooth Mesh IoT Basestation	ro 1
[Vendor]	Fabricante	ifm electronic gmbh	ro 1
[Product code]	Número do produto	EIO404	ro 1

¹ apenas leitura

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Seleccione o menu [Informação].
▷ A página de menu mostra as informações do dispositivo.

8.4.3 IoT: Configuração das definições de IP

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[IP address]	Endereço IP da interface Ethernet	Por exemplo: 192.168.0.100	rw 1
[Subnet mask]	Máscara de sub-rede da rede Ethernet	Por exemplo: 255.255.255.0	rw 1
[Default gateway IP address]	Endereço IP da rede gateway	Por exemplo: 192.168.0.1	rw 1
[DHCP]	Ativar/desativar o cliente DHCP do dispositivo	IP estático: As configurações de IP são definidas pelo usuário (padrão)DHCP: As configurações de IP são definidas pelo servidor DHCP na rede	rw 1
[MAC address]	Endereço MAC da interface	Por exemplo: 00-02-01-42-DC-B0	ro 2

¹ leitura e escrita
² apenas leitura

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [IoT].
▷ A página do menu mostra as configurações atuais da interface Ethernet.
▶ Ajuste os parâmetros.
▶ Escreva no dispositivo os valores que foram alterados.
▷ As novas configurações de IP da interface Ethernet estão ativadas.

8.4.4 IoT: configuração protegida por senha

A proteção por senha protege o dispositivo contra o acesso não autorizado por meio da interface Ethernet.

Depois de definir a senha, o usuário deve se autenticar com o nome de usuário e a senha ao acessar o dispositivo por meio da interface Ethernet.

O nome de usuário é administrator. O nome de usuário é fixo e não pode ser alterado.

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Security password]	Senha para acesso protegido à interface Ethernet (comprimento permitido: 6-32 caracteres)		wo 1

¹ apenas escrita

8.4.4.1 Definir senha Ethernet

Para definir a senha da interface Ethernet:

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [IoT].
▷ A página do menu mostra as configurações atuais.
▶ Insira a senha desejada.
▶ Escreva no dispositivo os valores que foram alterados.
▷ A proteção por senha está ativada.
▷ A partir da próxima vez em que acessar o dispositivo, o usuário deverá fazer o login com o nome de usuário e a senha escolhida.

8.4.4.2 Redefinição da senha da Ethernet

A redefinição da senha desativa a proteção contra o acesso não autorizado à interface Ethernet do dispositivo.

Para redefinir a senha da interface Ethernet:

Pré-requisitos:

√ A visualização [Configurar dispositivos] é aberta.

√ O editor para os valores dos parâmetros do dispositivo está aberto.
√ O modo de segurança da interface Ethernet está ativado.

▶ Selezione o menu [IoT].

▷ A página do menu mostra as configurações atuais.

▶ Clique em [Reset password].

▷ A senha será excluída.

▷ A proteção por senha será desativada.

O usuário pode acessar o dispositivo por meio da interface Ethernet sem inserir um nome de usuário e uma senha.

8.4.5 Bluetooth LE: definição do nome da estação

Pontos de dados disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Bluetooth LE name]	Nome do dispositivo na rede Bluetooth LE (22 caracteres no máx.)	Por exemplo: coletor de temperatura	rw 1

1 leitura e escrita

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [Bluetooth LE].
▷ A página do menu mostra as configurações atuais.
▶ Insira o nome da estação.
▶ Escreva no dispositivo os valores que foram alterados.
▷ O nome do dispositivo na rede Bluetooth LE está definido.

8.4.6 Bluetooth LE: configuração protegida por senha

Observe as informações sobre os requisitos para a senha do Bluetooth: Senha Bluetooth (→ ☐ 17)

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Security password]	Definição da senha para autenticação na interface Bluetooth LEComprimento mínimo: 6 Comprimento máximo: 32AVISO! A senha não afeta a funcionalidade mesh.		rw 1

1 leitura e escrita

8.4.6.1 Alteração da senha do Bluetooth

Para alterar a senha da interface Bluetooth LE:

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [Bluetooth LE].
▷ A página do menu mostra as configurações atuais.
▶ Insira a senha desejada.

▶ Escreva no dispositivo os valores que foram alterados.
▷ A nova senha está ativa.

8.4.7 Bluetooth mesh: gerenciamento de rede

Para obter informações sobre os adaptadores mesh ativos na rede mesh:

Informações disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Max Mesh Nodes]	Número máximo de nós	0...50	ro 1
[Current Mesh Nodes]	Número atual de nós na rede mesh	0...50	ro 1
[Taken Mesh Credits]	Número atual de créditos usados para o provisionamento		ro 1

¹ apenas leitura

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [Bluetooth Mesh].
▷ A página do menu mostra informações sobre a rede mesh.

8.4.8 MQTT: Configuração da conexão MQTT

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[MQTT Version]	Versão do MQTT	Por exemplo: 3.1.1	ro 1
[Quality of Service]	Qualidade de Serviço (QoS) da conexão MQTT	QoS 0: QoS Nível 0 - PUBLISH (sem confirmação) (default)QoS 1: QoS Nível 1 - PUBLISH > PUBREC (confirmação simples)QoS 2: QoS Nível 2 - PUBLISH > PUBREL > PUBCOMP (confirmação dupla)	rw 2
[Keep Alive]	Tempo máximo entre 2 pacotes consecutivos do protocolo MQTT (valor em segundos)	0: 0 s...10: 10 s...60: 60 s	rw 2

1 apenas leitura

² leitura e escrita

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Acesse o menu [MQTT].
▷ A página de menu mostra a configuração atual da conexão MQTT.
▶ Ajuste os parâmetros.
▶ Escreva no dispositivo os valores que foram alterados.
▷ A conexão MQTT está configurada.

8.4.8.1 Controle da conexão MQTT

O seguinte diagrama de status mostra a influência dos serviços start, stop e reset no status atual de uma conexão MQTT:

Após uma inicialização bem-sucedida no status init, a conexão automaticamente muda para o status running.

A conexão automaticamente entra no status error se pelo menos um dos seguintes eventos ocorrer:

- Nenhum broker MQTT disponível

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
√ A conexão MQTT está configurada.
▶ Acesse o menu [MQTT].

Para ativar a conexão MQTT:

▶ Clique em [Start].
▷ A conexão MQTT será ativada.

Para desativar a conexão MQTT:

▶ Clique em [Stop].
▷ A conexão MQTT será desativada.

Para redefinir a conexão MQTT:

▶ Clique em [Reset].
▷ A conexão MQTT será redefinida.

8.4.9 MQTT: configuração do canal de comando

Certifique-se de que o broker MQTT está acessível e a porta escolhida do broker MQTT está aberta para a transmissão de dados.

Os curingas "+" e "#" nos nomes dos tópicos não são suportados.

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Broker IP]	Endereço de IP do MQTT broker	Por exemplo: 3.69.1.9	rw 1
[Broker Port]	Endereço da porta do MQTT broker	Por exemplo: 1883	rw 1
[Topic]	Nome do tópico MQTT	Por exemplo: reqTopic	rw 1
[Reply Topic]	Tópico de resposta padrão	Por exemplo: resp Topic	rw 1
[Username]	Nome de usuário	Por exemplo: user1	rw 1
[Password]	Senha (não codificada em Base64)	Por exemplo: passport123	wo 2

¹ leitura e escrita

² apenas escrita

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Acesse o menu [MQTT] > [MQTT Command Channel].
▷ A página de menu mostra a configuração atual do canal de comando MQTT.
▶ Ajuste os parâmetros.
▶ Escreva no dispositivo os valores que foram alterados.
A canal de comando MQTT está configurado.

8.4.9.1 Configuração do canal de comando MQTT

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
√ A canal de comando MQTT está configurado.
▶ Acesse o menu [MQTT] > [MQTT Command Channel].

Para ativar o canal de comando MQTT:

▶ Clique em [Start].
▷ O canal de comando MQTT será ativado.

Para desativar o canal de comando MQTT:

▶ Clique em [Stop].
O canal de comando MQTT será desativado.

Para redefinir o canal de comando MQTT:

▶ Clique em [Reset].
▷ O comando de canal MQTT será redefinido.

8.4.10 Temporizador: configuração de temporizadores

O dispositivo tem 2 temporizadores. Os temporizadores podem ser usados para a transmissão programada de notificações.

Parâmetros disponíveis:

Nome	Descrição	Faixa de valores	Acesso
[Interval]	Intervalo de contagem (valor em ms)	1000: 1000 ms...86400000: 86400000 ms	rw 1

1 leitura e escrita

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [Timer 1] / [Timer 2].
▷ A página do menu mostra as configurações atuais.
▶ Insira o intervalo de contagem.
▶ Escreva no dispositivo os valores que foram alterados.
O intervalo de contagem do contador selecionado está definido.

8.4.10.1 Iniciar o temporizador

Os temporizadores [Timer 1] e [Timer 2] podem ser iniciados separadamente.

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
√ O intervalo de contagem está definido.
▶ Selezione o menu [Timer 1] / [Timer 2].
▷ A página do menu mostra as configurações atuais.
▶ Clique em [Start].
▷ O temporizador selecionado começa em 0.
▷ Quando o intervalo de contagem definido expira, o temporizador gera um sinal.

8.4.10.2 Parar o temporizador

Os temporizadores [Timer 1] e [Timer 2] podem ser parados separadamente.

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [Timer 1] / [Timer 2].
▷ A página do menu mostra as configurações atuais.
▶ Clique em [Stop].
▷ O temporizador é interrompido.

8.4.11 Firmware: redefinir, reiniciar ou localizar o dispositivo

Pré-requisitos:

√ O editor para os valores dos parâmetros do dispositivo está aberto.
▶ Selezione o menu [Firmware].
▷ A página do menu mostra as opções disponíveis.

Para localizar o dispositivo:

▶ Clique em [Signal].
▷ Os LEDs do dispositivo piscam.

Para redefinir o dispositivo:

▶ Clique em [Factory Reset].
▷ O dispositivo é redefinido para as configurações de fábrica.

Para reiniciar o dispositivo:

▶ Clique em [Reboot].
▷ O dispositivo é reiniciado.

8.5 IoT Core Visualizer

O IoT Core Visualizer oferece uma interface gráfica para acessar as funções do IoT Core da ifm.

8.5.1 Iniciar o IoT Core Visualizer

Para iniciar o IoT Core Visualizer:

Pré-requisitos:

√ O dispositivo está conectado corretamente, Parametrização via interface Ethernet (→ 16).
√ A interface Ethernet está configurada.
▶ Inicie o navegador da web.
▶ Acesse o seguinte URL: http:// (nas configurações de fábrica http://192.168.0.79).
▷ O navegador da web exibirá a página inicial do IoT Core Visualizer.

O menu de navegação oferece acesso às seguintes funções:

• [Notification]: Gerenciar notificações (→ 58)
• [Elements]: Acesso à árvore IoT Core (→ 60)
• [Update]: Atualização do firmware

8.5.2 Gerenciar notificações

A página de menu [Notification] oferece acesso à função de notificação do IoT Core.

Observe as informações sobre notificações: Utilização de notificações (→ 38)

Pré-requisitos:

√ O IoT Core Visualizer está ativo.
▶ Selezione o menu [Notification].
▷ É exibida a página de menu para gerenciamento de notificações.
▷ A tabela mostra todas as notificações ativas.

8.5.2.1 Criar notificações

A criação de notificações é realizada com o auxílio de um assistente.

Para notificações programadas usando o temporizador 1 ou o temporizador 2, o usuário deve configurar o intervalo do respectivo temporizador.

Pré-requisitos:

√ O IoT Core Visualizer está ativo.

√ O menu [Notification] está ativo.
▶ Clique em + na extremidade direita da tabela.
▷ É exibido o assistente para a criação de notificações.

▶ Escolha os parâmetros de notificação desejados passo a passo usando o assistente.
▷ A tabela mostra a notificação criada.

8.5.2.2 Excluir notificações

Pré-requisitos:

√ O IoT Core Visualizer está ativo.
√ O menu [Notification] está ativo.
√ Pelo menos uma notificação foi criada.
▶ Na linha da notificação, clique em [Unsubscribe] na coluna ×.
▷ A notificação selecionada é excluída.

8.5.3 Acesso à árvore IoT Core

A página de menu [Elements] oferece acesso à árvore IoT Core do dispositivo.

Pré-requisitos:

√ O IoT Core Visualizer está ativo.
▶ Selezione o menu [Elements].
▷ É exibida a página de menu para acessar os elementos da árvore IoT Core.
▷ A visualização mostra a estrutura da árvore IoT Core do dispositivo.

8.5.3.1 Pesquisa de elementos do IoT Core

A página de menu [Elements] permite pesquisar elementos com propriedades específicas na árvore IoT Core e exibir os resultados.

Você pode pesquisar pelos seguintes critérios:

• [identifier]: Nome do elemento
• [profile]: Perfil do elemento
• [type]: Tipo do elemento

Pré-requisitos:

√ O IoT Core Visualizer está ativo.
√ O menu [Elements] está ativo.

▶ Escolha os critérios de pesquisa desejados nas listas [identifier], [profile] e [type].
▶ Auf [Search for Elements] klicken.
▷ O IoT Core Visualizer procura elementos na descrição do dispositivo com os critérios de pesquisa selecionados.
▷ A lista de resultados mostra todos os elementos encontrados.

8.5.3.2 Acesso a elementos do IoT Core

O usuário pode acessar os elementos do IoT Core com os serviços suportados pelo dispositivo.

▶ Para obter mais informações sobre as funções do ifm IoT Core, consulte: ifm IoT Core REST API (→ 24)

Pré-requisitos:

√ O IoT Core Visualizer está ativo.
√ O menu [Elements] está ativo.
▶ Opcional: Pesquisa de elementos do IoT Core (→ ☐ 60)
▶ Navegue até o elemento.
▶ Clique no ícone de seta próximo ao serviço.

▷ Aparece uma janela de diálogo.

▶ Opcional: Para gravação de dados, insira os valores necessários no campo.
▶ Clique em [Request] para executar o serviço.
▷ O serviço será executado no dispositivo.

OU

▶ Clique em [Cancel] para cancelar o processo.
▷ O serviço não é executado.

8.5.4 Atualização do firmware

A página de menu [Update] oferece a opção de atualizar o firmware da estação base Bluetooth Mesh IoT e dos adaptadores Bluetooth mesh IO-Link provisionados.

Novo firmware disponível na página de informações detalhadas sobre o dispositivo: documentation.ifm.com

Para obter informações sobre como atualizar o firmware de um único adaptador Bluetooth mesh IO-Link: Manual de operação EIO344

A atualização do firmware não deve ser interrompida.

▶ Não reinicie o dispositivo durante a atualização.
▶ Espere até que a atualização esteja concluída.

Pré-requisitos:

√ O IoT Core Visualizer está ativo.
√ Novo firmware foi baixado: documentation.ifm.com
▶ Selezione o menu [Update].

▷ A página de menu mostra informações sobre a versão atual do firmware da estação base Bluetooth mesh IoT (área [Base_update]).
▷ A página de menu mostra informações sobre a versão atual do firmware dos adaptadores Bluetooth mesh IO-Link provisionados na estação base (área [Adapter_update]).

00-02-01-30-1A-00 - online						Visualizer v2.25.257
Notification	Elements	Update
Base_update
00-02-01-30-1A-00/firmware/base_update			Container
Version:	V1.54	G	Chunk size:	1024	G
Type:	firmware	G	Max size:	2621440	G
Load software file	choose software package		Size:	0	G
Update
Adapter_update
00-02-01-30-1A-00/meshnetwork/adapter_update			Container
Version:	unknown	G	Chunk size:	1024	G
Type:	firmware	G	Max size:	2621440	G
Load software file	choose software package		Size:	0	G
Update

Para atualizar o firmware da estação base Bluetooth mesh IoT:

▶ Mude para a área da estação base Bluetooth mesh IoT.
▶ Clique em [Load software file] e selecione o novo arquivo de firmware (*.bin).
▶ Clique em [Atualização] para iniciar o processo de atualização.

▷ O firmware da estação base Bluetooth mesh IoT é atualizada.
▷ O progresso d processo de atualização será exibido.

▷ Após a atualização bem-sucedida: O dispositivo é reiniciado automaticamente.

Para atualizar o firmware de todos os adaptadores Bluetooth mesh IO-Link provisionados e conectados:

▶ Mude para a área do adaptador Bluetooth mesh IO-Link.
▶ Clique em [Load software file] e selecione o novo arquivo de firmware (*.bin).

▶ Clique em [Atualização] para iniciar o processo de atualização.

▷ O firmware de todos os adaptadores Bluetooth mesh IO-Link provisionados e conectados será atualizado.
▷ O progresso d processo de atualização será exibido.

▷ Após a atualização bem-sucedida: os dispositivos são reiniciados automaticamente.

9 Eliminação de erros

Erros, advertências e mensagens de status são exibidos pelo LED de estado: Elementos de exibição e de operação (→ 15)

No caso de um erro (LED de status pisca em vermelho), o status do dispositivo fornece informações de diagnóstico detalhadas.

Imagem de erro	Causa de erro	Solução
O dispositivo está conectado à fonte de alimentação, o LED de estado está desligado	Tensão de alimentação muito baixa	▸ Verifique a fonte de alimentação
O dispositivo está conectado à fonte de alimentação, o LED de estado acende em vermelho	Erro de hardware, o dispositivo está com defeito	▸ Substitua o dispositivo
O LED de estado pisca em vermelho, status do dispositivo: [Over temperature] ou [Under temperature]	Temperatura da placa fora da faixa de tolerância	▸ Verifique a temperatura ambiente
O LED de estado pisca em vermelho, status do dispositivo: [Bluetooth Mesh no device provisioned]	Sem conexão com a rede Bluetooth mesh	▸ Verifique as distâncias entre os adaptadores Bluetooth mesh IO-Link
O LED de estado pisca em vermelho, status do dispositivo: [Ethernet link not connected]	Sem conexão de Ethernet	▸ Verifique a fiação de Ethernet

O ifm moneo fornece informações adicionais de estado e diagnóstico no modo online: → Ajuda online do ifm moneo

10 Manutenção, conservação e descarte

O dispositivo não necessita de manutenção.

▶ Em caso erros de funcionamento, entre em contato com a ifm.
▶ Não abra o invólucro, já que dentro do dispositivo não existem componentes que requerem a manutenção por parte do usuário. A reparação do equipamento só pode ser realizada pelo fabricante.
▶ Limpeza do dispositivo com um pano seco.
▶ Descartar o equipamento de acordo com as normais ambientais nacionais vigentes.

10.1 Atualização do firmware

O firmware do dispositivo pode ser atualizado por meio das seguintes opções:

• ifm moneo|blue: Atualização do firmware (→ 22)
• IoT-Core Visualizer: Atualização do firmware (→ 62)

11 Anexo

11.1 ifm IoT Core

11.1.1 Perfil

Perfil	Descrição
blob	Binary Large Object
comm Channel	Canal de comunicação
comm Interface	Interface de comunicação
connections	Conexões
const_value	Constante
datarequired	Dados necessários
deviceinfo	Informações de identificação
devicereset	Firmware redefinível
devicestatus	Condição do dispositivo
eventcollection	Coleta de eventos
mqtt CmdChannel Setup	Configurações do canal de comando MQTT
mqtt Setup	Configurações de MQTT
network	Rede
parameter	Parâmetro
processdata	Dados de processo
runcontrol	Estrutura de controle
securityconfig_base	Configurações de segurança
software	Software
software/uploadablesoftware	Software atualizável
subdatablock	Dados que podem ser modificados apenas em blocos
timer	Cronômetro
wirelessprovisioning	Estrutura de gerenciamento de redes sem fio

11.1.2 Tipos

Tipo	Descrição
data	Ponto de dados
device	Nó raiz que representa um dispositivo
event	Evento que pode ser acionado pelo firmware e envia notificações
service	Serviço acessível a partir da rede
structure	Elemento de estrutura (por exemplo, uma pasta no sistema de arquivos)

11.1.3 Serviços

11.1.3.1 Serviço: create_backup

Nome: create_backup

Descrição: O serviço cria uma cópia de segurança da configuração atual do dispositivo.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.2 Serviço: factoryreset

Nome: factoryreset

Descrição: O serviço restaura os parâmetros do dispositivo para as configurações de fábrica.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.3 Serviço: get_credit

Nome: get_credit

Descrição: O serviço lê um crédito disponível na rede Bluetooth.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
netkey	obrigatório	Cadeia (string)	Senha da rede
iv_key	obrigatório	INT	Índice
appkey	obrigatório	Cadeia (string)	Chave de aplicação
address	obrigatório	INT	Endereço
expiry_time	obrigatório	INT	Tempo limite (valor em segundos)

11.1.3.4 Serviço: getblobdata

Nome: getblobdata

Descrição: O serviço lê um Binary Large Object (blob).

Solicitação (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
Pos	obrigatório	NUMBER	Posição do byte
length	obrigatório	NUMBER	Tamanho do objeto (em bytes)

Resposta (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
data	obrigatório	Cadeia (string)	Dados a serem decodificados (codificados em Base64)
crc	opcional	HEX STRING	CRC dos dados após a decodificação
md5	opcional	HEX STRING	Soma de verificação MD5 dos dados após a decodificação

11.1.3.5 Serviço: getdata

Nome: getdata

Descrição: O serviço lê o valor de um ponto de dados e o retorna.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
value	obrigatório	Cadeia (string)	Valor do ponto de dados

11.1.3.6 Serviço: getdatamulti

Nome: getdatamulti

Descrição: O serviço lê sequencialmente os valores de vários pontos de dados e os retorna. Para cada ponto de dados, o valor e um código de diagnóstico são retornados.

Solicitação (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
datatosend	obrigatório	ARRAY OF STRINGS	Lista de pontos de dados a serem consultados; Os pontos de dados devem ser compatíveis com o serviço getdata ("datatosend": ["url1", "url2", ..., "urlx"])

Resposta (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
url	obrigatório	Cadeia (string)	Ponto de dados que foi consultado
code	obrigatório	Interno	Código de diagnóstico da consulta
data	obrigatório	Cadeia (string)	Valor do ponto de dados

11.1.3.7 Serviço: getidentity

Nome: getidentity

Descrição: O serviço chama informações sobre a identidade do dispositivo.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
iot		device	Descrição do dispositivo como um objeto JSON
iot.name	obrigatório	Cadeia (string)	Tipo do elemento
iot.uid	opcional	STRING
iot.version	obrigatório	STRING
iot.catalogue	opcional	ARRAY OF OBJECTS
iot.deviceclass	opcional	ARRAY OF STRING	Classe do dispositivo
iot.serverlistdevice	opcionalopcional	ARRAY OF OBJECTS	Número do produto
device.serialnumber	opcional		Número de série
device.hwrevision	opcional		Versão de hardware
device.swrevision	opcional		Versão do software
device.custom	opcional

O parâmetro security.isPasswd
Set indica o status da senha da conexão utilizada para chamar o serviço.

Exemplo 1:

√ Senha definida para a conexão Bluetooth.
▶ Solicitar getidentity através de um navegador da web.
▷ security.isPasswd
Set = false

Exemplo 2:

√ A senha da conexão Ethernet está definida.
▶ Solicitar getidentity através de um navegador da web.
▷ security.isPasswd
Set = true

11.1.3.8 Serviço: getsubscriberlist

Nome: getsubscriberlist

Descrição: O serviço fornece uma lista de todas as inscrições ativas.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
adr	obrigatório	STRING	Gatilho para notificação
datatosend	obrigatório	ARRAY OF STRINGS	Lista de URLs dos elementos de dados; URLs são separadas por vírgulas
cid	obrigatório	STRING	ID da notificação ativa
callbackurl	obrigatório	STRING	Endereço de destino para as notificações
duration	obrigatório	STRING	Duração da atividade

11.1.3.9 Serviço: gettree

Nome: gettree

Descrição: O serviço lê a descrição do dispositivo e a retorna como um objeto JSON. A saída pode ser limitada a uma subárvore da descrição do dispositivo.

Solicitação (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
adr	opcional	STRING	Nó raiz da subárvore
level	opcional	STRING	Nível máximo até o qual a subárvore será exibida• sem indicação: todos os níveis são exibidos• 0: não exibir subelementos ("subs")• 1: exibir subelementos• 2: subelementos até o 2o nível exibidos• 3: subelementos até o 3o nível exibidos...• 20: subelementos até o 20o nível exibidos

Resposta (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
identifier	obrigatório	STRING	Identificador do nó raiz
type	obrigatório	STRING	Tipo do elemento
format	opcional	Objeto JSON	Formato do conteúdo de dados
uid	opcional	STRING
profiles	opcional	matriz JSON
subs	obrigatório	matriz JSON	Subelementos
hash	opcional	STRING

11.1.3.10 Serviço: install

Nome: install

Descrição: O serviço instala o software armazenado em uma área da memória do dispositivo.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.11 Serviço: install_backup

Nome: install_backup

Descrição: O serviço restaura uma cópia de segurança armazenada em uma área da memória do dispositivo.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.12 Serviço: querytree

Nome: querytree

Descrição: O serviço pesquisa os critérios profile, type e identifier em uma árvore de dispositivos e retorna uma lista de URLs dos elementos encontrados. Pelo menos um dos critérios de pesquisa deve ser especificado. O serviço só pode ser executado no nó raiz do dispositivo.

Solicitação (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
profile	opcional	STRING	Perfil do elemento pesquisado
type	opcional	STRING	Tipo do elemento pesquisado
identifier	opcional	STRING	Nome do elemento pesquisado

Resposta (campo "data"): Nenhuma

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
urllist	obrigatório	ARRAY	Matriz de URLs dos elementos encontrados; URLs separadas por vírgulas

11.1.3.13 Serviço: reboot

Nome: reboot

Descrição: O serviço reinicia o dispositivo.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.14 Serviço: register

Nome: register

Descrição: O serviço registra um dispositivo suportado na rede.

Solicitação (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
id	obrigatório	STRING	Identificador do dispositivo a ser registrado na rede

Resposta (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
adr	opcional	STRING	Caminho do dispositivo na estrutura da rede

11.1.3.15 Serviço: replace

Nome: replace

Descrição: O serviço remove um dispositivo da rede e registra um dispositivo idêntico na rede.

Solicitação (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
old_id	obrigatório	STRING	Identificador do dispositivo a ser substituído
new_id	obrigatório	STRING	Identificador do dispositivo a ser registrado

Resposta (campo "data"): Nenhuma

11.1.3.16 Serviço: reset

Nome: reset

Descrição: O serviço redefine uma conexão para o estado de inicialização.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.17 Serviço: resetpassword

Nome: resetpassword

Descrição: O serviço desativa o modo de segurança e redefine a senha.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.18 Serviço: reset_credits

Nome: reset_credits

Descrição: O serviço redefine todos os créditos solicitados pelos adaptadores Bluetooth registrados na rede Mesh.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.19 Serviço: scan

Nome: scan

Descrição: O serviço procura dispositivos suportados nas proximidades. Os dispositivos encontrados e suas propriedades são retornados.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
id	obrigatório	STRING	Identificador do dispositivo
name	obrigatório	STRING	Nome do dispositivo
info	opcional	ARRAY	Propriedades do dispositivo• Obrigatório: Signal Strength

11.1.3.20 Serviço: setblock

Nome: setblock

Descrição: O serviço define os valores de vários pontos de dados de uma estrutura de uma só vez.

Solicitação (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
datatoset	obrigatório	ARRAY OF OBJECTS	Lista de pontos de dados e seus novos valores; Os pontos de dados devem ser compatíveis com o serviço setdata
consistent	opcional	BOOL	Retorno dentro de um período de tempo específico

Resposta (campo "data"): Nenhuma

11.1.3.21 Serviço: setdata

Nome: setdata

Descrição: O serviço define o valor de um ponto de dados.

Solicitação (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
newvalue	obrigatório	STRING	Novo valor do ponto de dados
duration	opcional	STRING	Duração de armazenamento do valor• lifetime: Valor é armazenado com IoT Core; O valor permanece válido mesmo após a reinicialização do dispositivo• uptime: O valor é armazenado até o próximo reboot do dispositivo

Resposta (campo "data"): Nenhuma

11.1.3.22 Serviço: setdatamulti

Nome: setdatamulti

Descrição: O serviço escreve sequencialmente os valores de vários pontos de dados. O valor de destino deve ser fornecido para cada ponto de dados.

Solicitação (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
datatosend	obrigatório	ARRAY OF STRINGS	Lista de pontos de dados e seus valores correspondentes (codificados) a serem escritos; Os pontos de dados devem ser compatíveis com o serviço setdata ("datatosend":["url1":"value1","url2":value2",..., "urlx":"valuex"])

Resposta (campo "data"): Nenhuma

11.1.3.23 Serviço: signal

Nome: signal

Descrição: O serviço aciona o piscar dos LEDs de status do dispositivo.

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.24 Serviço: start

Nome: start

Descrição: O serviço inicia uma função (por exemplo, conexão, temporizador).

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.25 Serviço: start_stream_set

Nome: start_stream_set

Descrição: O serviço inicia a transmissão sequencial de vários fragmentos de dados.

Solicitação (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
size	obrigatório	STRING	Tamanho total dos dados a serem transmitidos (número de bytes)

Resposta (campo "data"): Nenhuma

11.1.3.26 Serviço: stop

Nome: stop

Descrição: O serviço interrompe uma função (por exemplo, conexão, temporizador).

Solicitação (campo "data"): Nenhuma

Resposta (campo "data"): Nenhuma

11.1.3.27 Serviço: stream_set

Nome: stream_set

Descrição: O serviço transmite um segmento de dados.

Solicitação (campo "data"):

Parâmetros	Campo obrigatório	Tipo de dado	Descrição
value	obrigatório	BIN (BASE64)	Segmento dos dados binários (codificado em Base64)

Resposta (campo "data"): Nenhuma

11.1.3.28 Serviço: subscribe

Nome: subscribe

Descrição: O serviço ativa a notificação.

Solicitação (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
callback	obrigatório	STRING	Endereço de destino para as notificações; Formato de URL:JSON: http://ipaddress:port/pathJSON: ws://pathMQTT: mqtt://ipaddress:port/path
datatosend	obrigatório	ARRAY OF STRINGS	Lista de URLs dos elementos de dados; URLs são separadas por vírgulas; Os elementos devem ser compatíveis com o serviço getdata
duration	opcional	STRING	Validade da notificaçãolifetime: O registro permanece ativo mesmo após o reboot do dispositivouptime: O registro é válido até o próximo reboot do dispositivoonce: enviar apenas uma notificação; o usuário deve cancelar a inscrição diretamente

Resposta (campo "data"): Nenhuma

Formato da notificação: JSON

{
    "code": "event",
    "cid": 4711,
    "adr": "",
    "data": {
    "eventno": "EventNo",
    "srcurl": "SrcURL",
    "payload": {
    "eventurl": {"code": Event
Status, "data": Event
Data},
    "datapointurl_1": {"code": DataStatus_1, "data": DataValue_1},
    "datapointurl_2": {"code": DataStatus_2, "data": DataValue_2}, ...
    }
    }
} 

11.1.3.29 Serviço: unregister

Nome: unregister

Descrição: O serviço remove um dispositivo de uma rede.

Solicitação (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
id	optional1	STRING	Identificador do dispositivo a ser removido da rede
adr	optional1	STRING	Caminho do dispositivo na estrutura da rede

1 pelo menos um dos dois parâmetros deve ser fornecido

Resposta (campo "data"): Nenhuma

11.1.3.30 Serviço: unsubscribe

Nome: unsubscribe

Descrição: O serviço exclui uma notificação ativa. Os valores fornecidos para cid e callback devem ser iguais aos utilizados no registro da notificação (subscribe). Se "DELETE" for passado como valor de retorno no callback, todas as inscrições ativas serão excluídas.

Solicitação (campo "data"):

Parâmetro	Campo obrigatório	Tipo de dado	Descrição
callback	obrigatório	STRING	Endereço de destino para as notificações; Formatos de URL:JSON: http://ipaddress:port/pathJSON: ws://pathJSON: mqtt://ipadress:port/topicDELETE: todas as notificações ativas serão excluídas

Resposta (campo "data"): Nenhuma