EIO404 - Estación base Bluetooth IFM - Manual de uso y guía de instrucciones gratis

MANUAL DE USUARIO EIO404 IFM

Manual de instrucciones

Estación base Bluetooth® Mesh IoT

EIO404

Firmware: 1.55

Índice de contenidos

1 Advertencia preliminar 5

1.1 Información legal.... 5
1.2 Símbolos utilizados.... 5
1.3 Advertencias.... 5

2 Indicaciones de seguridad. 7

2.1 Ciberseguridad 7
2.2 Símbolo de seguridad en el equipo.... 8

3 Uso previsto 9

3.1 Uso indebido previsible.... 9
3.2 Topología de la red Bluetooth Mesh 9

4 Función.... 11

4.1 Señalización visual 11
4.2 Puerto Ethernet.... 11
4.3 Bluetooth LE 11
4.4 Bluetooth Mesh.... 11
4.5 ifm IoT Core 11

5 Montaje....12

5.1 Visión de conjunto.... 12
5.2 Opciones de montaje 12

5.2.1 Montaje sin accesorios 12
5.2.2 Montaje con escuadra de montaje E80335 12
5.2.3 Montaje con placa de montaje E80336 13
5.2.4 Montaje con varillas de montaje E80337.... 13

5.3 Montaje del equipo 13

6 Conexión eléctrica.... 14

6.1 Visión de conjunto.... 14
6.2 Indicaciones sobre el cableado.... 14
6.3 Suministro de tensión 14
6.4 Puerto Ethernet....15

7 Elementos de manejo e indicación ..... 16

7.1 Visión de conjunto.... 16
7.2 LED de estado 16

8 Parametrización 17

8.1 Indicaciones sobre la parametrización ..... 17

8.1.1 Parametrización a través de la interfaz Bluetooth 17
8.1.2 Parametrización a través de la interfaz Ethernet.... 17
8.1.3 ▶ Instalar ifm moneo|blue.... 18
8.1.4 Instalar ifm moneo|configure.... 18
8.1.5 Contrasena Bluetooth 18

8.2 ifm moneo|blue 20

8.2.1 Establecer conexión con el equipo 20

8.2.1.1 Aprovisionar adaptadores Bluetooth Mesh IO-Link 20
8.2.1.2 Eliminar adaptadores Bluetooth Mesh IO-Link de la red 21

8.2.2 Leer información de identificación.... 22

8.2.3 Configurar los ajustes IP 22
8.2.4 Configurar el nombre de la red Bluetooth Mesh 22
8.2.5 Configurar el nombre de la estación Bluetooth 22
8.2.6 ▶ Configurar la conexión MQTT 22
8.2.7 ▶ Configurar el canal de comandos MQTT.... 23
8.2.8 Actualización del firmware.... 23

8.2.8.1 Actualizar el firmware de los adaptadores conectados 24

8.3 API REST de ifm IoT Core 25

8.3.1 ifm IoT Core: información general 25
8.3.1.1 Acceso al ifm IoT Core 25
8.3.2 Primeros pasos.... 27
8.3.3 Funciones generales.... 28

8.3.3.1 Ejemplo: modificar el valor del parámetro ..... 28
8.3.3.2 Ejemplo: lectura simultánea de varios valores de parámetros.... 29
8.3.3.3 Ejemplo: enviar un subárbol 29
8.3.3.4 Ejemplo: buscar el IoT Core 30

8.3.4 Ethernet: configurar los ajustes IP.... 31

8.3.5 Ethernet: configurar la protección por contraseña.... 31

8.3.5.1 Ejemplo: establecer una contraseña para Ethernet.... 32
8.3.5.2 Ejemplo: petición con autenticación 32
8.3.5.3 Ejemplo: eliminar la contraseña para Ethernet 33

8.3.6 Bluetooth: introducir un nombre para la estación 34

8.3.7 Bluetooth: configurar la protección por contraseña 34

8.3.7.1 Ejemplo: cambiar la contraseña de Bluetooth 34

8.3.8 Gestionar la red Bluetooth Mesh 35

8.3.8.1 Ejemplo: buscar adaptadores Mesh disponibles 35
8.3.8.2 Ejemplo: registrar un adaptador Mesh en la red Mesh 36
8.3.8.3 Ejemplo: sustituir el adaptador Mesh 36
8.3.8.4 Ejemplo: quitar un adaptador Mesh de la red Mesh 37

8.3.9 Gestionar adaptadores Bluetooth Mesh IO-Link 37

8.3.10 Configurar temporizadores 38

8.3.10.1 Ejemplo: establecer un intervalo de recuento 38
8.3.10.2 Ejemplo: iniciar contador.... 38
8.3.10.3 Ejemplo: detener contador 39

8.3.11 Utilizar notificaciones 39

8.3.11.1 Notificaciones basadas en eventos.... 40
8.3.11.2 Notificaciones basadas en el tiempo.... 40
8.3.11.3 Ejemplo: generar una notificación basada en el tiempo 40
8.3.11.4 Ejemplo: generar una notificación basada en eventos 41
8.3.11.5 Ejemplo: mostrar notificaciones activas. 42
8.3.11.6 Ejemplo: modificar una notificación.... 42
8.3.11.7 Ejemplo: eliminar una notificación.... 43

8.3.12 Utilizar MQTT 43

8.3.12.1 Configurar la conexión MQTT 44
8.3.12.2 Configurar el canal de comandos MQTT....45
8.3.12.3 Ejemplo: configurar y activar el canal de comandos MQTT....46
8.3.12.4 Ejemplo: publicar la temperatura del equipo en el broker MQTT....47

8.3.13 Restablecer, reiniciar y localizar el equipo 48
8.3.14 Lectura y escritura de información del equipo 48
8.3.15 Lectura de información de estado y diagnóstico 49

8.4 ifm moneo|configure 50

8.4.1 Establecer conexión con el equipo 50

8.4.1.1 Aprovisionar adaptadores Bluetooth Mesh IO-Link 50
8.4.1.2 Eliminar adaptadores Bluetooth Mesh IO-Link de la red Mesh 51

8.4.2 Información: leer información de identificación ..... 52
8.4.3 IoT: configurar los ajustes IP 52
8.4.4 IoT: configurar la protección por contraseña 53

8.4.4.1 Establecer una contraseña para Ethernet 53
8.4.4.2 Restablecer la contraseña para Ethernet 53

8.4.5 Bluetooth LE: establecer un nombre para la estación 54

8.4.6 Bluetooth LE: configurar la protección por contraseña 54

8.4.6.1 Cambiar la contraseña de Bluetooth 54

8.4.7 Bluetooth Mesh: administrar la red 55
8.4.8 MQTT: configurar la conexión MQTT 55
8.4.8.1 Controlar la conexión MQTT 56

8.4.9 MQTT: configurar el canal de comandos.... 56

8.4.9.1 Controlar el canal de comandos MQTT....57

8.4.10 Timer: configurar temporizadores 57

8.4.10.1 Iniciar temporizador.... 58
8.4.10.2 Detener temporizador 58

8.4.11 Firmware: restablecer, reiniciar o localizar el equipo....58

8.5 IoT Core Visualizer 59

8.5.1 Inicio del IoT Core Visualizer.... 59
8.5.2 Gestión de notificaciones 59

8.5.2.1 Creación de nuevas notificaciones 59
8.5.2.2 Eliminación de notificaciones 60

8.5.3 Acceso al árbol IoT Core....61

8.5.3.1 Búsqueda de elementos del IoT Core 61
8.5.3.2 Acceso a elementos del IoT Core 62

8.5.4 Actualización del firmware....63

9 Solución de errores....65

10 Mantenimiento, reparación y eliminación 66

10.1 Actualización del firmware.... 66

11 Anexo 67

11.1 ifm IoT Core 67

11.1.1 Perfiles 67
11.1.2 Tipos....68
11.1.3 Servicios....69

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

1 Advertencia preliminar

Manual, datos técnicos, homologaciones y más información a través del código QR en el equipo / en el embalaje o en documentation.ifm.com.

1.1 Información legal

© Todos los derechos reservados por ifm electronic gmbh. La reproducción y la utilización de este manual, de manera completa o parcial, solo está permitida con la autorización de ifm electronic gmbh.

• Bluetooth® es una marca registrada de Bluetooth SIG Inc.
• Apple ^® , el logotipo de Apple, iPhone y iPod Touch son marcas comerciales de Apple Inc. registradas en Estados Unidos y otros países. La App Store es una marca de servicios de Apple Inc.
• El sistema operativo iOS es una marca registrada de Apple Inc.
• Google® es una marca registrada de Google LLC.
• El sistema operativo Android® es una marca registrada de Google LLC.
• Android, Google Play y el logotipo de Google Play son marcas comerciales de Google Inc.

1.2 Símbolos utilizados

√ Requisito
Operación requerida
Reacción, resultado

[...] Referencia a teclas, botones o indicadores

→ Referencia cruzada

Nota importante

El incumplimiento de estas indicaciones puede acarrear funcionamientos erróneos o averías

Información

Indicaciones complementarias

1.3 Advertencias

Las advertencias alertan de posibles daños personales y materiales. Esto permite una manipulación segura del producto. Las advertencias se clasifican de la siguiente manera:

ADVERTENCIA

Advertencia de daños personales graves

▷ Es posible que se produzcan lesiones graves o mortales si no se tiene en cuenta la advertencia.

PRECAUCIÓN

Advertencia de daños personales de leves a moderados

▷ Es posible que se produzcan lesiones de leves a moderadas si no se tiene en cuenta la advertencia.

ATENCIÓN

Advertencia de daños materiales

▷ Es posible que se produzcan daños materiales si no se tiene en cuenta la advertencia.

2 Indicaciones de seguridad

- El equipo descrito está integrado como subcomponente en un sistema.

• La seguridad de este sistema es responsabilidad del instalador.

• El instalador del sistema está obligado a realizar una evaluación de riesgos, así como a crear y adjuntar una documentación de acuerdo con los requisitos legales y normativos para el operador y el usuario del sistema. Esta debe contener toda la información e indicaciones de seguridad necesarias para el operador, el usuario y, dado el caso, el personal de mantenimiento autorizado por el instalador del sistema.

• Léase este documento antes de la puesta en marcha del producto y consérvese durante el tiempo que se siga utilizando.

• El producto debe ser apto para las aplicaciones y condiciones ambientales correspondientes sin ningún tipo de restricción.
• Utilizar el producto solamente para el fin previsto (→ Uso previsto).
• El incumplimiento de las indicaciones de utilización o de los datos técnicos puede provocar daños personales y/o materiales.
• El fabricante no asume ninguna responsabilidad ni garantía derivada de manipulaciones en el producto o de un uso incorrecto por parte del operario.
• El montaje, la conexión eléctrica, la puesta en marcha, la programación, la configuración, el manejo y el mantenimiento del producto solo pueden ser llevados a cabo por personal cualificado autorizado y formado para la actividad correspondiente.
• Proteger de forma segura los equipos y cables contra daños.
• Sustituir los equipos dañados, ya que, de lo contrario, la seguridad y los datos técnicos se verán afectados.

2.1 Ciberseguridad

Instalación

El equipo es apto para el funcionamiento en un entorno seguro según la norma IEC 62443-1-1.

▶ Realizar una evaluación de riesgos de la instalación según la norma IEC 62443-1-1.
El equipo está diseñado para ser utilizado con cortafuegos.
▶ Adoptar medidas para garantizar la seguridad física.
El equipo no dispone de protección propia contra accesos no autorizados.
▶ Utilizar el equipo exclusivamente en redes de confianza.

Ejemplos de redes de confianza (según la norma IEC 62443-3-1, parte 5):

- Redes internas de la empresa (Local Area Networks - LANs)

- Redes administradas y protegidas por el departamento informático

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

• Redes para el control y la supervisión de procesos industriales
• Los sistemas de control industrial están aislados de otras redes

- Conexión punto a punto entre el equipo y el siguiente interlocutor de comunicación

Interfaz Bluetooth LE

La interfaz Bluetooth LE utiliza el procedimiento de emparejamiento JustWorks para establecer una comunicación criptográficamente segura entre el equipo e ifm moneo|blue.

▶ Establecer una conexión entre el equipo e ifm moneo|blue exclusivamente en un entorno seguro.

La interfaz Bluetooth LE del equipo está protegida con una contraseña. Al iniciar sesión por primera vez en el equipo, el usuario debe cambiar la contraseña configurada de fábrica.

▶ Cambiar la contraseña exclusivamente en un entorno seguro.
▶ Elegir una contraseña segura de acuerdo con la política de la empresa.

Interfaz Bluetooth Mesh

La comunicación Bluetooth Mesh entre los participantes de la red está protegida criptográficamente tras el aprovisionamiento correcto de los equipos en la red Bluetooth Mesh.

▶ Provisionar los equipos para la red Bluetooth Mesh exclusivamente en un entorno seguro.

Funcionamiento

▶ Observar las funciones de seguridad descritas en la documentación del equipo y las recomendaciones para su uso.

Mantenimiento

▶ Guardar la configuración y los datos del sistema según los procesos de gestión de cambios de la empresa.
▶ Comprobar periódicamente si hay actualizaciones de software disponibles para el equipo.

Garantizar la integridad y autenticidad de la actualización del software mediante las siguientes medidas organizativas:

▶ Descargar el nuevo archivo de firmware en un ordenador portátil o PC seguro.
▶ Calcular el valor hash SHA-256 del archivo de firmware descargado, disponible en www.ifm.com/cnt/product-security.
▶ Comprobar si el valor hash calculado coincide con el valor SHA-256 proporcionado en la página web de ifm.
▶ Instalar el archivo de firmware en el equipo mediante una conexión segura, por ejemplo, una conexión punto a punto.

Puesta fuera de servicio

▶ Asegurarse de que ninguna información sensible pueda caer en manos no autorizadas.
▶ Antes de poner fuera de servicio el equipo, restablecer siempre la configuración del sistema a los ajustes de fábrica.

2.2 Símbolo de seguridad en el equipo

Símbolo de seguridad en el equipo:

▶ Para un funcionamiento seguro del equipo, observar el manual de instrucciones.

3 Uso previsto

El equipo se puede utilizar:

• Como nodo organizativo central para establecer y gestionar una red Bluetooth Mesh con adaptadores Bluetooth Mesh IO-Link como participantes
• Para parametrizar los adaptadores Bluetooth Mesh IO-Link conectados y, opcionalmente, los equipos IO-Link conectados.
• Como pasarela entre el nivel IIoT superior y los adaptadores Bluetooth Mesh IO-Link conectados para la transmisión de datos de proceso, así como de información de estado y diagnóstico de los equipos IO-Link conectados

Uso autorizado:

• En interiores
• Emplear el equipo exclusivamente dentro de los límites definidos en los datos técnicos: → Datos técnicos.

Información importante sobre la homologación: hoja de instrucciones del equipo y documentation.ifm.com

3.1 Uso indebido previsible

El equipo no es adecuado para entornos con requisitos especiales de estabilidad mecánica (p. ej. choques/vibraciones).

El equipo no es adecuado para su uso en aplicaciones críticas. Los datos no se transmiten en tiempo real.

3.2 Topología de la red Bluetooth Mesh

Topología recomendada:

Fig. 1: Colocación del EIO404 en el centro de la red Bluetooth Mesh

▶ Colocar la estación base Bluetooth Mesh IoT en el centro de la red Bluetooth Mesh siempre que sea posible.
▷ Se reduce la utilización de la red.
▷ La estabilidad de la comunicación aumenta en comparación con la colocación de la estación base en el borde de la red Bluetooth Mesh.

Topología no recomendada:

Fig. 2: Colocación del EIO404 en el borde de la red Bluetooth Mesh

Colocar la estación base Bluetooth Mesh IoT en el borde de la red Bluetooth Mesh significa que todos los datos se deben transmitir a través de uno o unos pocos adaptadores Bluetooth Mesh IO-Link. Esto da lugar a una elevada utilización de estos adaptadores y puede repercutir negativamente en la estabilidad y latencia de toda la red Bluetooth Mesh.

▶ Evitar colocar la estación base Bluetooth Mesh IoT en el borde de la red Bluetooth Mesh.
▶ Si no es posible el posicionamiento central, colocar adaptadores Bluetooth Mesh IO-Link adicionales como nodos de retransmisión en la red Bluetooth Mesh.

4 Función

4.1 Señalización visual

El equipo dispone de un LED de estado para indicar información de estado, avisos y estados de error.

4.2 Puerto Ethernet

Este equipo está provisto de una interfaz Ethernet:

• Parametrización del equipo
• Parametrización de la red Bluetooth Mesh
• Comunicación Ethernet hasta el nivel de IT (monitorización)

4.3 Bluetooth LE

El equipo admite la comunicación mediante Bluetooth Low Energy (LE). Las siguientes funciones se pueden ejecutar a través de Bluetooth LE:

• Parametrización de la estación base
• Parametrización de la red Bluetooth Mesh
• Parametrización de la interfaz Ethernet
• Parametrización de la conexión MQTT
• Parametrización de los adaptadores Bluetooth Mesh IO-Link conectados, incluidos los equipos IO-Link conectados

4.4 Bluetooth Mesh

El equipo es compatible con el protocolo Bluetooth Mesh.

Junto con los adaptadores Bluetooth Mesh IO-Link EIO344, el equipo puede crear y gestionar una red Bluetooth Mesh. Una vez configurada la red Bluetooth Mesh, el equipo establece automáticamente la conexión con el adaptador Bluetooth Mesh IO-Link (EIO344).

Es posible la conexión de hasta 50 adaptadores Bluetooth Mesh IO-Link a la estación base Bluetooth Mesh IoT.

El equipo ofrece las siguientes funciones en una red Bluetooth Mesh:

• Parametrización del adaptador
• Parametrización del equipo IO-Link conectado
  • Monitorización de los datos de proceso (intervalo: 1 s ... 24 h)

Información detallada sobre el adaptador Bluetooth Mesh IO-Link EIO344:

documentation.ifm.com

4.5 ifm IoT Core

En este equipo viene incorporado el ifm IoT Core. El ifm IoT Core representa la funcionalidad del equipo. Esta funcionalidad consiste en un conjunto de datos, servicios y eventos. Los elementos del ifm IoT Core están estructurados como un objeto JSON en forma de árbol jerárquico. El ifm IoT Core pone a disposición del mundo exterior estos elementos a través de interfaces estándar (por ejemplo, HTTP). Esto permite al usuario y a otros equipos acceder a los datos (parámetros, datos de proceso), eventos y funciones (servicios) del equipo.

5 Montaje

5.1 Visión de conjunto

1: Taladros roscados
2: Conexiones para alimentación y Ethernet

Las conexiones para la fuente de alimentación y Ethernet pueden girarse 270°.

5.2 Opciones de montaje

Para el montaje están disponibles accesorios opcionales: documentation.ifm.com

Los tornillos necesarios para el montaje no están incluidos en el volumen de suministro del equipo.

5.2.1 Montaje sin accesorios

El equipo se puede montar sin accesorios.

▶ Utilizar una superficie plana para el montaje.
▶ Utilizar los 4 taladros roscados de la parte posterior del equipo para el montaje, Visión de conjunto (→ ☐ 12).

5.2.2 Montaje con escuadra de montaje E80335

La escuadra de montaje se ha previsto para la instalación lateral del equipo.

5.2.3 Montaje con placa de montaje E80336

La placa de montaje se utiliza para la instalación del equipo en un cilindro de fijación.

5.2.4 Montaje con varillas de montaje E80337

Fijar el equipo con tornillos de fijación en el lugar de montaje.

5.3 Montaje del equipo

▶ Desconectar la tensión de alimentación antes de comenzar con el montaje.

▶ Montar el equipo según la opción deseada.
▶ Utilizar únicamente tornillos M4 para fijar la carcasa. Par de apriete máx.: 0,8 Nm.

6 Conexión eléctrica

El equipo solo puede ser instalado por técnicos electricistas.

Observar las normativas nacionales e internacionales para el establecimiento de instalaciones electrotécnicas.

Suministro de tensión según MBTS y MBTP.

▶ Desconectar la tensión de alimentación.

6.1 Visión de conjunto

1: Puerto Ethernet
2: Suministro de tensión

6.2 Indicaciones sobre el cableado

Las conexiones roscadas del equipo cumplen la norma para conectores M12. Para cumplir con el grado de protección especificado, únicamente se pueden utilizar cables que cumplan esta norma. En el caso de cables de fabricación propia, el fabricante del sistema será el responsable del grado de protección.

▶ Usar conectores con contactos dorados.
▶ Durante el montaje, colocar conectores en vertical para que la tuerca no dañe la rosca.
▶ Antes de conectar el conector, comprobar si la junta tórica de la toma está intacta.
▶ Tener en cuenta la codificación de los conectores durante el montaje.
▶ Equipar todos los cables salientes con un dispositivo apropiado de descarga de tracción tras un máximo de 200 mm.

Para el ámbito de aplicación cULus:

▶ Utilizar solo cables con certificación UL de la categoría CYJV 2/7/8 con datos técnicos adecuados para conectar el equipo.

6.3 Suministro de tensión

El equipo se conecta a la fuente de alimentación a través del puerto.

PRECAUCIÓN

El puerto no dispone de protección contra sobrecorriente.

▷ Peligro de incendio
▶ Proteger los circuitos.

Conexionado:

▶ Conectar el puerto a la fuente de alimentación.
▶ Utilizar un conector M12 para la conexión.
▶ Apretar la tuerca de unión con 0,6...1,5 Nm.

6.4 Puerto Ethernet

El equipo se conecta a la red de IT a través del puerto.

- Longitud máxima del cable: 20 m

El equipo no debe recibir alimentación externa a través del puerto M12.

Conexionado:

▶ Conectar el puerto a la red de IT directamente o a través de un elemento de acoplamiento de red (por ejemplo, un switch).
▶ Utilizar un conector M12 para la conexión (grado de protección mínimo: IP 67).
▶ Apretar la tuerca de unión con 0,6...1,5 Nm.

7 Elementos de manejo e indicación

7.1 Visión de conjunto

1: LED de estado

7.2 LED de estado

LED	Descripción	Color	Estado	Tipo	Descripción
Estado	-	-	Desactivado	Error	Tensión demasiado baja
	Indicación de funciona-miento	Verde	Activado	Funciona-miento nor-mal	El equipo funciona correctamente
			Parpadea (doble parpadeo)	Aviso	Identificación óptica
			Parpadea (200 ms encendido, 800 ms apagado)	Indicación	Actualización del firmware¡NOTA! Esperar a que finalice el proceso de actualización.
	Indicación de fallo	Rojo	Activado	Sustitución del equipo	Error de hardware
			Parpadea (1 Hz)	Error	Temperatura de la placa de circuito fuera del rango de tolerancia
			Parpadea (1 Hz)	Indicación	Sin conexión Ethernet
			Parpadea (1 Hz)	Aviso	Sin conexión Bluetooth Mesh
	Estado de Bluetooth	Azul	Activado	Indicación	Bluetooth activado
			Parpadea (doble parpadeo, una vez)	Indicación	Establecimiento correcto de Mesh (tras mensaje de ID de equipo)

8 Parametrización

Este equipo se puede parametrizar a través de dos interfaces. Mediante Ethernet o Bluetooth se puede leer información o realizar ajustes. Es posible la asignación de información y ajustes a cada interfaz.

1. En el caso de Ethernet, el conector M12 se conecta a una red mediante un cable Ethernet M12 → (Accesorios).
2. La conexión con una aplicación se establece vía Bluetooth.

Información sobre el software de parametrización adecuado en io-link.ifm

8.1 Indicaciones sobre la parametrización

8.1.1 Parametrización a través de la interfaz Bluetooth

Para parametrizar la estación base Bluetooth Mesh IoT a través de la interfaz Bluetooth:

▶ Conectar el equipo a la fuente de alimentación.
▶ Instalar ifm moneo|blue, Instalar ifm moneo|blue ( → ☐ 18).

8.1.2 Parametrización a través de la interfaz Ethernet

Opciones disponibles para configurar el equipo a través de la interfaz Ethernet:

• ifm IoT Core REST API: API REST de ifm IoT Core (→ 25)
• ifm moneo|configure: ifm moneo|configure (→ 50)
• ifm IoT Core Visualizer: IoT Core Visualizer (→ 59)

Para parametrizar la estación base Bluetooth Mesh IoT a través de la interfaz Ethernet:

▶ Conectar el equipo al PC/portátil a través del puerto Ethernet.
▶ Conectar el equipo a la fuente de alimentación.
▶ Opcional: instalar ifm moneo|configure, Instalar ifm moneo|configure (→ □ 18).

8.1.3 Instalar ifm moneo|blue

ifm electronic proporciona la aplicación ifm moneo|blue para acceder al equipo a través de la interfaz Bluetooth. La aplicación está disponible en Apple App Store y Google Play Store.

Para instalar ifm moneo|blue:

▶ Escanear el código QR con el dispositivo móvil.
▷ Se abre la página de la aplicación en App Store o Google Play Store.
▶ Instalar ifm moneo|blue.
▷ ifm moneo|blue está instalado en el dispositivo móvil.

8.1.4 Instalar ifm moneo|configure

Información sobre ifm moneo|configure: ifm.com/cnt/moneo

▶ Descargar ifm moneo|configure.
▶ Iniciar el portátil/PC.
▶ Iniciar sesión con derechos de administrador.
▶ Instalar y obtener la licencia de ifm moneo|configure (→ Instrucciones de instalación de ifm moneo).
▷ ifm moneo|configure está instalado.

8.1.5 Contraseña Bluetooth

El acceso al equipo a través de Bluetooth LE está protegido con una contraseña. ▷ La protección por contraseña no se puede desactivar.

La contraseña de Bluetooth configurada de fábrica consta de los 6 últimos dígitos del número de serie del equipo (p. ej. 100000138488).

El número de serie está impreso en el embalaje y en el equipo.

Fig. 3: Indicación del número de serie: en el equipo (izquierda) y en el embalaje (derecha)

La primera vez que se accede al equipo con ifm moneo|blue, se pide al usuario que cambie la contraseña configurada de fábrica.

▶ Elegir una contraseña segura de acuerdo con la política de la empresa.

La contraseña Bluetooth no influye en el acceso al equipo a través de ifm moneo y la interfaz IoT Core.

8.2 ifm moneo|blue

8.2.1 Establecer conexión con el equipo

▶ Durante la primera puesta en marcha, cambiar la contraseña (→ Contraseña Bluetooth 18) configurada de fábrica de la interfaz Bluetooth.

Requisitos:

√ Bluetooth está activado en el dispositivo móvil.
√ ifm moneo|blue está instalado en el dispositivo móvil, Instalar ifm moneo|blue (→ 18).
√ El equipo está situado cerca del dispositivo móvil (distancia: máx. 15 m).
√ El equipo está conectado y listo para funcionar.

▶ Iniciar ifm moneo|blue.

▶ Hacer clic en [Scan for Devices].

▷ ifm moneo|blue busca equipos disponibles en los alrededores.
▷ ifm moneo|blue detecta todos los equipos disponibles.

▶ Seleccionar la estación base Bluetooth Mesh IoT y emparejarla con el dispositivo móvil.

▷ Aparece la vista general.
▷ La vista general muestra los equipos de la red Bluetooth Mesh.

▶ Hacer clic en el icono de la estación base Bluetooth Mesh IoT.

▷ Aparece el editor de valores de parámetros del equipo.

▷ El equipo se puede configurar.

8.2.1.1 Aprovisionar adaptadores Bluetooth Mesh IO-Link

Para añadir un adaptador Bluetooth Mesh IO-Link a una red Bluetooth Mesh, el adaptador se debe aprovisionar en la estación base Bluetooth Mesh IoT.

Requisitos:

√ ifm moneo|blue está instalado en el dispositivo móvil, Instalar ifm moneo|blue (→ 18).

√ Bluetooth está activado en el dispositivo móvil.
√ ▷ La estación base Bluetooth Mesh IoT EIO404 se ha iniciado y está lista para funcionar.
√ ▷ El adaptador Bluetooth Mesh IO-Link EIO344 se ha iniciado y está listo para funcionar.
√ El equipo está situado cerca del dispositivo móvil (distancia: máx. 15 m).
√ ifm moneo|blue se ha iniciado.
▶ Emparejar la estación base Bluetooth Mesh IoT con el dispositivo móvil, Establecer conexión con el equipo (→ 20).

▶ En la línea de encabezado: hacer clic en +.

▷ La estación base Bluetooth Mesh IoT busca adaptadores disponibles en los alrededores.
▷ Se muestran todos los adaptadores disponibles.

▶ Seleccionar el adaptador Bluetooth Mesh IO-Link.

▷ Hacer clic en [Provision].

▷ La estación base Bluetooth Mesh IoT integra el adaptador en la red Bluetooth Mesh.
▷ ifm moneo|blue tiene acceso al adaptador Bluetooth Mesh IO-Link.
▷ Si está conectado: ifm moneo|blue tiene acceso al equipo IO-Link conectado.

Tras el aprovisionamiento, la estación base Bluetooth Mesh IoT establece automáticamente la conexión con todos los adaptadores Bluetooth Mesh IO-Link aprovisionados. La conexión se establece directamente o a través de otros adaptadores Bluetooth Mesh IO-Link.

Los adaptadores Bluetooth Mesh IO-Link envían los datos de proceso cíclicamente a la estación base Bluetooth Mesh IoT en un intervalo definido. Los datos de proceso se pueden leer y utilizar para la supervisión del sistema.

8.2.1.2 Eliminar adaptadores Bluetooth Mesh IO-Link de la red

Para eliminar un adaptador Bluetooth Mesh IO-Link de la red Bluetooth Mesh:

▶ Restablecer el adaptador Bluetooth Mesh IO-Link (Back-to-Box), → Manual de instrucciones EIO344.
▷ El adaptador Bluetooth Mesh IO-Link se elimina de la red Bluetooth Mesh.
▷ El crédito utilizado para el aprovisionamiento vuelve a estar disponible.

8.2.2 Leer información de identificación

Información disponible:

Nombre	Descripción	Rango de valores	Acceso
[Serial number]	Número de serie	p. ej. 000022503648	ro 1
[Firmware Version]	Versión de firmware	p. ej. V1.42	ro 1
[Bootloader revision]	Versión del cargador de arranque	p. ej. V0.07	ro 1
[EEPROM revision]	Versión EEPROM	p. ej. V0.03	ro 1
[Mac-Address]	Dirección MAC Bluetooth	p. ej. B4-E3-F9-C7-54-43	ro 1
[Hardware Revision]	Versión de hardware	p. ej. AA	ro 1
[Vendor]	Fabricante	ifm electronic gmbh	ro 1
[Product Name]	N.° de artículo	EIO404	ro 1

1 solamente lectura

8.2.3 Configurar los ajustes IP

Para configurar los ajustes IP del puerto Ethernet:

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[IP address]	Dirección IP de la interfaz Ethernet	p. ej. 192.168.0.100	rw1
[Subnet Mask]	Máscara de subred de la red Ethernet	p. ej. 255.255.255.0	rw1
[Default Gateway]	Dirección IP de la puerta de enlace de la red	p. ej. 192.168.0.1	rw1
[DHCP]	Activar / desactivar el cliente DHCP del equipo	IP estática: la configuración IP la establece el usuario (por defecto)DHCP: la configuración IP la establece el servidor DHCP de la red	rw1

¹ lectura y escritura

8.2.4 Configurar el nombre de la red Bluetooth Mesh

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Mesh Network Name]	Nombre de la red Bluetooth Mesh (máx. 32 caracteres)	p. ej. Plant2 Hall3	rw 1

¹ lectura y escritura

8.2.5 Configurar el nombre de la estación Bluetooth

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Bluetooth LE name]	Nombre del equipo en la red Bluetooth LE (máx. 22 caracteres)	p. ej. BaseStation	r w 1

¹ lectura y escritura

8.2.6 Configurar la conexión MQTT

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[MQTT Version]	Versión MQTT	p. ej. 3.1.1	ro 1
[Keep Alive]	Tiempo máx. entre 2 paquetes consecutivos del protocolo MQTT (valor en s)	0: 0 s...10: 10 s...60: 60 s	rw 2

1 solamente lectura

² lectura y escritura

8.2.7 Configurar el canal de comandos MQTT

Asegúrese de que se puede acceder al broker MQTT y de que el puerto seleccionado del broker MQTT está habilitado para la transmisión de datos.

No se admiten los comodines "+" y "#" en los nombres de los topics.

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Broker IP]	Dirección IP del broker MQTT	p. ej. 3.69.1.9	rw 1
[Broker Port]	Número de puerto del broker MQTT	p. ej. 1883	rw 1
[Topic]	Denominación del topic del comando MQTT	p. ej. reqTopic	rw 1
[Reply Topic]	Denominación del topic de respuesta MQTT	p. ej. resp Topic	rw 1
[Username]	Nombre de usuario	p. ej. user1	rw 1

¹ lectura y escritura

8.2.8 Actualización del firmware

ifm moneo|blue ofrece la posibilidad de actualizar el firmware de la estación base Bluetooth Mesh IoT.

Nuevo firmware disponible en la página específica del equipo: documentation.ifm.com

La actualización del firmware no se debe interrumpir.

▶ No reiniciar el equipo durante el proceso de actualización.
▶ Esperar hasta que se complete la actualización.

Requisitos:

√ El archivo de firmware de la estación base Bluetooth Mesh IoT se guarda en el sistema de archivos del dispositivo móvil.
√ ifm moneo|blue se ha iniciado.

▶ Establecer una conexión con la estación base Bluetooth Mesh IoT.
▶ Abrir la vista de editor de la estación base Bluetooth Mesh IoT.
▶ En la línea de encabezado: hacer clic en ↑.

▷ Aparece un cuadro de diálogo.

▶ Seleccionar la opción [Update Base station].
▶ En el apartado [Select update file]: hacer clic en [Browse].
▶ Seleccionar un nuevo archivo de firmware.
▷ La página de menú muestra el archivo de firmware seleccionado.

▶ Hacer clic en [Import].

▷ El archivo de firmware se transfiere al equipo.
▷ Aparece un mensaje para instalar el nuevo firmware y reiniciar el equipo.

▶ Hacer clic en [OK] para confirmar el mensaje.

▷ El firmware de la estación base Bluetooth Mesh IoT se actualiza.
▷ El equipo se reinicia.

▷ El nuevo firmware está instalado en la estación base Bluetooth Mesh IoT.

8.2.8.1 Actualizar el firmware de los adaptadores conectados

ifm moneo|blue ofrece la posibilidad de actualizar el firmware de los adaptadores Bluetooth Mesh IO-Link conectados a través de la estación base Bluetooth Mesh IoT.

Nuevo firmware disponible en la página específica del equipo: documentation.ifm.com

Para obtener información sobre la actualización del firmware de un único adaptador Bluetooth Mesh IO-Link: Manual de instrucciones EIO344

La actualización del firmware no se debe interrumpir.

▶ No reiniciar el equipo durante el proceso de actualización.
▶ Esperar hasta que se complete la actualización.

Requisitos:

√ El archivo de firmware del adaptador Bluetooth Mesh IO-Link se guarda en el sistema de archivos del dispositivo móvil.
√ ifm moneo|blue se ha iniciado.
▶ Establecer una conexión con la estación base Bluetooth Mesh IoT.
▶ Abrir la vista de editor de la estación base Bluetooth Mesh IoT.
▶ En la línea de encabezado: hacer clic en ↑.

▷ Aparece un cuadro de diálogo.

▶ Seleccionar la opción [Update all connected mesh adapters].

▶ En el apartado [Select update file]: hacer clic en [Browse].

▶ Seleccionar un nuevo archivo de firmware.

▷ La página de menú muestra el archivo de firmware seleccionado.

▶ Hacer clic en [Importar].

▷ El archivo de firmware se transfiere a la estación base Bluetooth Mesh IoT.
▷ Aparece un mensaje que indica que está disponible un nuevo firmware para los adaptadores conectados.

▶ Hacer clic en [Update].

▷ El nuevo firmware se transfiere a todos los adaptadores Bluetooth Mesh IO-Link conectados.
▷ El firmware se actualiza.
▷ Todos los adaptadores se reinician.

▷ El nuevo firmware está instalado en todos los adaptadores Bluetooth Mesh IO-Link conectados.

8.3 API REST de ifm IoT Core

8.3.1 ifm IoT Core: información general

En este equipo viene incorporado el ifm IoT Core. El ifm IoT Core representa la funcionalidad del equipo. Esta funcionalidad consiste en un conjunto de datos, servicios y eventos. Los elementos del ifm IoT Core están estructurados como un objeto JSON en forma de árbol jerárquico. El ifm IoT Core pone estos elementos a disposición del mundo exterior a través de interfaces estándar (por ejemplo, HTTP). Esto permite al usuario y a otros equipos acceder a los datos (parámetros, datos de proceso), eventos y funciones (servicios) del equipo.

8.3.1.1 Acceso al ifm IoT Core

A un elemento del ifm IoT Core se accede a través de su dirección (por ejemplo, root/port1/pin2). La dirección se compone de la ruta al elemento (root/port1) y del identificador del elemento (pin2).

▷ El usuario puede acceder al ifm IoT Core realizando peticiones HTTP. Se admiten los siguientes métodos.

Método GET

Acceso: lectura

Sintaxis de la petición (Request):

http://ip/data_point/service 

Parámetro	Descripción
ip	Dirección IP de la interfaz IoT
data_point	Punto de datos al que se debe acceder
service	Servicio

Sintaxis de la respuesta (Response):

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

Campo	Parámetro	Descripción
cid	id	ID de correlación para la asignación de petición y respuesta
data	resp_data	Valor del punto de datos; en función del tipo de datos del punto de datos
adr	data_point	Punto de datos al que se ha accedido
	service	Servicio con el que se accedió al punto de datos
code	diag_code	Código de diagnóstico

Ejemplo: petición GET

- Petición (a través del navegador):

http://192.168.0.79/deviceinfo/productname/getdata 

- Respuesta:

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

Método POST

Acceso: lectura, escritura

Sintaxis de la petición (Request):

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

Campo	Parámetro	Descripción
code	code_id	clase de serviciorequest: peticióntransaction: transacciónevent: evento
cid	id	ID de correlación para la asignación por pares de petición y devolución; identificador de libre elección por el usuario
adr	data_point	Punto de datos al que se debe acceder
	service	Servicio con el que se debe acceder al punto de datos
data 1	req_data	Datos enviados al ifm IoT Core (por ejemplo, nuevos valores); sintaxis según el servicio
auth 2	usr_id	Nombre de usuario (codificado en BASE64); por defecto: administrator
	password	Contraseña (codificada en BASE64)

1 opcional; solo es necesario para los servicios que envían datos al ifm IoT Core (por ejemplo, setdata)
2 opcional; solo es necesario si el modo de seguridad está activado

Sintaxis de la respuesta (Response):

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

Campo	Parámetro	Descripción
cid	id	ID de correlación para la asignación de petición y respuesta (→ Request)
data1	resp_data	Valores devueltos por el ifm IoT Core; sintaxis según el servicio
adr	data_point	Punto de datos al que se ha accedido
	service	Servicio con el que se accedió al punto de datos
code	diag_code	Código de diagnóstico

1 opcional; solo disponible para los servicios que reciben datos del ifm IoT Core (por ejemplo, getdata)

Ejemplo: petición POST

Petición (Request):

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

Respuesta (Response):

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

Códigos de diagnóstico

Código	Texto	Descripción
200	OK	Petición procesada con éxito
400	Bad request	Petición no válida
403	Forbidden	Petición prohibida
404	Element not found:	La dirección especificada no existe
408	Request Timeout	Tiempo de espera para la respuesta a la petición
404	Element not found:	El servicio solicitado no existe.
413	Request payload too large	Carga útil de la petición demasiado grande
414	Request-URL too long	URL de la petición demasiado larga
416	Request Range Not Satisfiable	El rango de valores solicitado no está dentro de los límites permitidos
422	Invalid payload. Invalid:	Los datos transferidos/la carga útil no son válidos
423	The service is busy	Actualmente el servicio está bloqueado, desactivado u ocupado
424	Failed dependency:	Ejecución del servicio actualmente no permitida (comprobar dependencias)
429	Too many requests	Demasiadas peticiones
500	Internal Server Error	Fallo interno
501	Not implemented	No implementado
502	Remote service failed with code:	Error en la petición al equipo remoto con un mensaje de error
503	Service Unavailable	Servicio no disponible
507	Insufficient storage	Memoria insuficiente en el equipo
550	Service execution failed	Error en la ejecución del servicio
901	Already exists	El elemento o enlace al elemento ya existe en el mismo punto del árbol IoT Core

8.3.2 Primeros pasos

ifm IoT Core contiene elementos que están destinados exclusivamente al uso interno de ifm. Estos elementos no se muestran en la petición con el servicio gettree. Los elementos están protegidos contra el acceso no autorizado.

Para mostrar la estructura de árbol completa del IoT Core del equipo, enviar la siguiente petición POST al ifm IoT Core:

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

ifm IoT Core devuelve la estructura de árbol completa como un objeto JSON estructurado.

▶ Identificar todas las subestructuras y los puntos de datos contenidos en ellas en la estructura de árbol del objeto JSON.
▶ Identificar los servicios aplicables para acceder a las subestructuras y a los puntos de datos contenidos en ellas.

8.3.3 Funciones generales

El equipo corresponde al tipo device (→ Tipos ☐ 68). Es posible aplicar los siguientes servicios al elemento raíz del árbol de equipos:

Servicio	Descripción
../gettree	Enviar un árbol completo o un subárbol de la descripción del equipo (JSON)
../getidentity	Leer la información de identificación del equipo
../getdatamulti	Leer varios elementos secuencialmente
../getelementinfo	Leer información detallada de un elemento
../getsubscriberlist	Enviar una lista con todas las suscripciones de notificación activas
../querytree	Buscar elementos específicos en la descripción del equipo

Los siguientes servicios se pueden aplicar a elementos del tipo data en función de los derechos de acceso establecidos:

Servicio	Descripción
../getdata	Leer el valor del elemento
../setdata	Escribir el valor del elemento

8.3.3.1 Ejemplo: modificar el valor del parámetro

Tarea: el parámetro devicename del equipo debe contener el valor "New Base Station".

Solución: escribir el nuevo valor del elemento deviceinfo/devicename con el servicio setdata.

Petición (Request):

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

Respuesta (Response):

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

8.3.3.2 Ejemplo: lectura simultánea de varios valores de parámetros

Tarea: se debe leer la siguiente información actualizada sobre el equipo: temperatura, número de serie

Solución: leer los valores actuales de los parámetros con el servicio getdatamulti (punto de datos temperatura: /processdatabasestation/temperature/cpu; punto de datos número de serie: /deviceinfo/serialnumber).

Petición (Request):

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

Respuesta (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 Ejemplo: enviar un subárbol

Tarea: enviar todos los subelementos directos del nodo meshnetwork.

Solución: enviar el subárbol deseado con el servicio gettree (nodo raíz: meshnetwork, subniveles que se deben mostrar: 1)

Petición (Request):

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

Respuesta (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 Ejemplo: buscar el IoT Core

Tarea: en la lista deben figurar todos los elementos con el perfil datarequired.

Solución: buscar el IoT Core del equipo con el parámetro datarequired (profile) utilizando el servicio querytree.

Petición (Request):

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

Respuesta (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 los ajustes IP

Subestructura: iotsetup/ethernet/network

▶ Modificar los puntos de datos de la subestructura network únicamente por bloques con el servicio setblock.

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../dhcp	Método de configuración para los ajustes IP de la interfaz	0: IP estática: dirección estática (por defecto)1: DHCP: dirección por DHCP (Dynamic Host Configuration Protocol)	r w 1
../ipaddress	Dirección IP de la interfaz	p. ej. 192.168.0.79 (por defecto)	r w 1 2
../subnetmask	Máscara de subred del segmento de red	p. ej. 255.255.255.0 (por defecto)	r w 1 2
../ipdefaultgateway	Dirección IP de la pasarela de red	p. ej. 192.168.0.100 (por defecto)	r w 1 2
../macaddress	Dirección MAC de la interfaz	p. ej. 00-02-01-42-DC-9D	r o 3

¹ lectura y escritura

2 solo se puede cambiar si el DHCP está desactivado

³ solamente lectura

Servicios aplicables:

Nombre	Descripción
../setblock	Escribir todos los puntos de datos de la subestructura por bloques

8.3.5 Ethernet: configurar la protección por contraseña

La protección por contraseña protege el equipo contra accesos no autorizados a través de la interfaz Ethernet.

Una vez establecida la contraseña, el usuario debe completar además el campo "auth" con un nombre de usuario ("user") y una contraseña ("passwd") válidos para autenticar la petición POST.

El nombre de usuario es administrator. El nombre de usuario es fijo y no se puede cambiar.

El nombre de usuario y la contraseña se representan como cadenas codificadas en Base64: Ejemplo: petición con autenticación (→ 32)

Con la protección por contraseña activada, las siguientes peticiones también se pueden ejecutar sin autenticación:

• getidentity
  • deviceinfo/vendor/getdata

• deviceinfo/productcode/getdata

Subestructura: iotsetup/ethernet/security

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../password	Establecer una contraseña para la autenticación (cadena codificada en Base64)• Longitud mín.: 6• Longitud máx.: 32	P. ej. ZXRoX3 Bhc3N3b3Jk	wo 1

1 solamente escritura

Conjunto de caracteres válido para la contraseña antes de la codificación en Base64: UTF-8 sin caracteres de control

Servicios aplicables:

Nombre	Descripción
../resetpassword	Eliminar la contraseña para Ethernet

8.3.5.1 Ejemplo: establecer una contraseña para Ethernet

Tarea: la conexión Ethernet se debe proteger con una contraseña (contraseña: eth_password)

Solución: con el servicio setdata, escribir la contraseña eth_password (codificada en Base64: ZXRoX3
Bhc3N3b3Jk) en el punto de datos iotsetup/ethernet/security/password.

Petición (Request):

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

Respuesta (Response):

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

La interfaz Ethernet está protegida por contraseña. El servicio getidentity (→ Servicio: getidentity ☐ 70) muestra que se ha establecido la contraseña.

8.3.5.2 Ejemplo: petición con autenticación

Tarea: se debe leer la temperatura del equipo. Se ha establecido la contraseña (contraseña: eth_password).

Solución: leer el punto de datos processdatabasestation/temperature/cpu con el servicio getdata. El nombre de usuario y la contraseña se envían como cadenas codificadas en Base64:

- Nombre de usuario:

- administrator: YWRtaW5pc3RyYXRvcg==

- Contraseña:

- eth_password: ZXRoX3
Bhc3N3b3Jk 

Petición (Request):

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

Respuesta (Response):

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

8.3.5.3 Ejemplo: eliminar la contraseña para Ethernet

Tarea: el acceso al equipo a través de la interfaz Ethernet está protegido con una contraseña (contraseña: eth_password). Se debe eliminar la contraseña.

Solución: escribir en la subestructura iotesetup/ethernet/security con el servicio resetpassword. El nombre de usuario y la contraseña se envían como cadenas codificadas en Base64.

- Nombre de usuario:

- administrator: YWRtaW5pc3RyYXRvcg== 

- Contraseña:

- eth_password: ZXRoX3
Bhc3N3b3Jk 

Petición (Request):

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

Respuesta (Response):

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

8.3.6 Bluetooth: introducir un nombre para la estación

Subestructura: iotsetup/bluetooth_le

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../bluetooth_name	Nombre de la estación del equipo (ca-dena con un máximo de 22 caracteres)	p. ej. eio404_base	rw 1

¹ lectura y escritura

8.3.7 Bluetooth: configurar la protección por contraseña

▶ Observar las indicaciones sobre la contraseña de Bluetooth: Contrasena Bluetooth (→ 18)

Subestructura: iotsetup/bluetooth_le/security

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../security/password	Establecer una contraseña para la autenticación en la interfaz Bluetooth LE (cadena codificada en Base64)• Longitud mín.: 6• Longitud máx.: 32¡NOTA! La contraseña no interfiere en las funciones Mesh.	p. ej. YmxIX3 Bhc3N3b3Jk	wo 1
../security/password_state	Estado actual de la contraseña de Bluetooth	0: Default Password - Contrasena configurada de fábrica (últimos 6 dígitos del número de serie)1: User specific password - Contrasena específica del usuario	ro 2

1 solamente escritura

² solamente lectura

Conjunto de caracteres válido para la contraseña antes de la codificación en Base64: UTF-8 sin caracteres de control

Servicios aplicables:

Nombre	Descripción
../resetpassword	Restablecer la contraseña a la configuración de fábrica

8.3.7.1 Ejemplo: cambiar la contraseña de Bluetooth

Tarea: la contraseña de Bluetooth debe establecerse en el valor ble_password.

Solución: con el servicio setdata, escribir la contraseña ble_password (codificada en Base64:

Ymx1X3
Bhc3N3b3Jk) en el punto de datos /iotsetup/bluetooth_le/security/password.

Petición (Request):

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

Respuesta (Response):

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

8.3.8 Gestionar la red Bluetooth Mesh

Subestructura: meshnetwork/provisioning

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../max_nodes	Número máx. de nodos	50	ro 1
../current_nodes	Cantidad actual de nodos de la red Mesh	0...50	ro 1
../valid_credits_count	Cantidad actual de créditos Bluetooth Mesh en uso	0...65535	ro 1

1 solamente lectura

Servicios aplicables:

Nombre	Descripción
../scan	Escanear el entorno del equipo en busca de nodos disponibles
../register	Registrar un nodo en la red Mesh
../unregister	Quitar un nodo de la red Mesh
../replace	Sustituir un nodo de la red Mesh
../get_credit	Solicitar un crédito de la red Mesh para poder añadir un nodo a la red
../reset_credits	Restablecer los créditos solicitados actualmente

8.3.8.1 Ejemplo: buscar adaptadores Mesh disponibles

Tarea: se deben buscar los adaptadores Bluetooth Mesh disponibles en las proximidades del equipo.

Solución: ejecutar el servicio scan en la subestructura meshnetwork/provisioning.

Petición (Request):

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

Respuesta (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
} 

La estación base ha encontrado un adaptador Bluetooth Mesh con el UUID (campo "id") y un nombre (campo "name"). El adaptador Mesh tiene una dirección MAC y una intensidad de señal del 77 %.

8.3.8.2 Ejemplo: registrar un adaptador Mesh en la red Mesh

Tarea: el adaptador Mesh se debe registrar en la red Bluetooth Mesh con los datos detectados durante el escaneo de la red.

Solución: ejecutar el servicio register en la subestructura meshnetwork/provisioning. Se debe transferir el UUID del adaptador Mesh.

Petición (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"
    }
} 

Respuesta (Response):

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

Una vez que el adaptador Bluetooth Mesh se ha registrado correctamente, su árbol IoT Core se integra en el árbol IoT Core de la estación base Bluetooth Mesh (subestructura meshnetwork/mesh_adapter[x] (x: 1...50)).

8.3.8.3 Ejemplo: sustituir el adaptador Mesh

Tarea: el adaptador Mesh registrado en la red Bluetooth Mesh con el UUID "XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX-XX" se debe sustituir por el adaptador Mesh con el UUID "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY".

Solución: ejecutar el servicio replace en la subestructura meshnetwork/provisioning. Se debe transferir el UUID de los dos adaptadores Mesh.

Petición (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"
    }
} 

Respuesta (Response):

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

8.3.8.4 Ejemplo: quitar un adaptador Mesh de la red Mesh

Tarea: el adaptador Bluetooth Mesh con el UUID "YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY-YY" se debe quitar de la red Mesh.

Solución: ejecutar el servicio unregister en la subestructura meshnetwork/provisioning. Se debe transferir el UUID del adaptador Mesh.

Petición (Request):

Petición (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"
    }
} 

Respuesta (Response):

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

La subestructura del adaptador Mesh (mesh_adapter[x] (x: 1...50)) se elimina del árbol IoT Core de la estación base Mesh.

8.3.9 Gestionar adaptadores Bluetooth Mesh IO-Link

Para cada adaptador Bluetooth Mesh IO-Link integrado en la red, se crea una subestructura mesh_adapter[x] (x:1...50) en meshnetwork. La subestructura contiene el IoT Core del adaptador Bluetooth Mesh IO-Link con puntos de datos y estructuras específicos del equipo.

Descripción del IoT Core del adaptador Bluetooth Mesh IO-Link: → Manual de instrucciones del EIO344

Solo se puede acceder al IoT Core del adaptador Bluetooth Mesh IO-Link a través de la estación base Bluetooth Mesh IoT. Para ello, el adaptador debe estar integrado en la red Bluetooth Mesh.

8.3.10 Configurar temporizadores

El equipo dispone de 2 temporizadores. Los temporizadores se pueden utilizar para la transferencia basada en el tiempo de las notificaciones (→ Utilizar notificaciones ☐ 39).

Subestructura: timer[1] | timer[2]

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../counter	Valor del contador	0...4294967295	ro 1
../interval	Intervalo de recuento (valor en ms)	1000: 1000 ms86400000: 86400000 ms	rw 2
../interval/unit	Unidad del intervalo de recuento	ms: milisegundos	ro 1
../status	Estado del contador	0: stopped - Contador parado1: running - Contador en marcha	ro 1

1 solamente lectura
² lectura y escritura

Servicios aplicables:

Nombre	Descripción
../status/start	Iniciar contador
../status/stop	Detener contador

8.3.10.1 Ejemplo: establecer un intervalo de recuento

El intervalo de recuento del temporizador 2 se debe ajustar a 2,5 s.

Petición (Request):

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

Respuesta (Response):

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

8.3.10.2 Ejemplo: iniciar contador

El contador del temporizador 2 está configurado y debe iniciarse.

Petición (Request):

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

Respuesta (Response):

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

8.3.10.3 Ejemplo: detener contador

El contador del temporizador 2 está en marcha y debe detenerse.

Petición (Request):

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

Respuesta (Response):

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

8.3.11 Utilizar notificaciones

El equipo admite el envío de notificaciones. Una notificación puede contener los valores actuales de uno o varios datos del proceso.

Tipos de notificación disponibles:

• Notificaciones basadas en eventos (→ 40)
• Notificaciones basadas en el tiempo (→ 40)

Las notificaciones se envían a una determinada dirección de destino. La dirección de destino consta de los elementos protocolo de transmisión, dirección IP, puerto y topic (p. ej: http://192.168.100.254:80/myTopic)

Protocolos de transmisión compatibles:

• http
• mqtt

Se puede establecer la duración de la actividad de una notificación.

El usuario puede consultar todas las notificaciones activas utilizando el servicio getsubscriberlist.

8.3.11.1 Notificaciones basadas en eventos

Todos los elementos del ifm IoT Core con un subelemento del tipo event se pueden utilizar como trigger de notificaciones basadas en eventos.

Nombre	Descripción
../datachanged	Nodo para la visualización de los cambios de valor del nodo de datos padre
../eventcollection	Nodo para la visualización de los cambios de valor de varios nodos de datos del IoT Core
../treechanged	Nodo para la visualización de cambios estructurales en el IoT Core

Servicios aplicables:

Nombre	Descripción
../subscribe	Suscribirse a las notificaciones
../unsubscribe	Darse de baja de las notificaciones

8.3.11.2 Notificaciones basadas en el tiempo

El ifm IoT Core ofrece 2 temporizadores que se pueden utilizar como trigger de las notificaciones basadas en el tiempo.

Nombre	Descripción
../timer[1]/counter/datachanged	Contador del temporizador 1
../timer[2]/counter/datachanged	Contador del temporizador 2

Se puede ajustar el tiempo de los intervalos de los temporizadores. Cada impulso de recuento activa una notificación.

Servicios aplicables:

Nombre	Descripción
../subscribe	Suscribirse a las notificaciones
../unsubscribe	Darse de baja de las notificaciones

8.3.11.3 Ejemplo: generar una notificación basada en el tiempo

Tarea: los valores de los siguientes parámetros se deben enviar cada 10 segundos al topic myData de un ordenador de red con la dirección IP 192.168.0.4:

• Datos de entrada IO-Link del sensor al adaptador Bluetooth Mesh IO-Link 1
• Temperatura de funcionamiento de la estación base Bluetooth Mesh IoT

Solución: la solución se divide en las siguientes 3 fases:

▶ Ajustar el intervalo de recuento del temporizador 1 (10 s = 10000)
- Petición (Request):

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

▶ Iniciar el temporizador 1
- Petición (Request):

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

▶ Activar las notificaciones

- Petición (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"
    ]
    }
} 

La notificación se transmite en formato JSON. La notificación tiene la siguiente estructura:

{
    "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 Ejemplo: generar una notificación basada en eventos

Tarea: si se producen cambios en la red Bluetooth Mesh, se debe enviar un mensaje a un servidor con la cantidad de adaptadores Mesh integrados (dirección IP del servidor: 192.168.82.100, puerto: 80, topic: myData).

Solución:

Petición (Request):

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

Respuesta (Response):

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

8.3.11.5 Ejemplo: mostrar notificaciones activas

Tarea: se deben mostrar todas las notificaciones activas.

Solución: leer todas las notificaciones activas con el servicio getsubscriberlist.

Petición (Request):

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

Respuesta (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 Ejemplo: modificar una notificación

Tarea: la suscripción existente se debe modificar. En lugar de la temperatura de la estación base Bluetooth, se debe transmitir la tensión de alimentación aplicada.

Solución: sobrescribir la suscripción existente. Para ello, los valores de los parámetros "cid" y "callback" de la petición deben ser los mismos que los de la suscripción existente.

Petición (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"
    ]
    }
} 

Respuesta (Response):

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

8.3.11.7 Ejemplo: eliminar una notificación

Tarea: la notificación existente se debe eliminar.

Solución: eliminar la notificación con el servicio unsubscribe. Para ello, el valor del parámetro "callback" de la petición debe ser igual al de la notificación existente.

Petición (Request):

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

8.3.12 Utilizar MQTT

El ifm IoT Core es compatible con el protocolo MQTT. MQTT permite que un cliente se comunique con el ifm IoT Core a través de un broker para solicitar y recibir datos. El ifm IoT Core puede publicar mensajes en un broker MQTT (publish).

Para habilitar la comunicación MQTT, el usuario debe configurar el canal de comandos MQTT. La configuración incluye las siguientes fases:

▶ Comprobar si el broker MQTT es accesible.
▶ Comprobar si el puerto deseado del broker MQTT está abierto.
▶ Activar el canal de comandos MQTT.
▶ Configurar el canal de comandos MQTT.
▶ Configurar la conexión MQTT.

▷ La conexión MQTT está configurada y activada.

Después de configurar el canal de comandos MQTT y la conexión MQTT, los datos se pueden publicar en el broker MQTT (publish). La publicación de los datos en el broker MQTT se realiza a través del servicio subscribe.

8.3.12.1 Configurar la conexión MQTT

El siguiente diagrama de estado muestra la influencia de los servicios start, stop y reset en el estado actual de una conexión MQTT:

Tras una inicialización ejecutada con éxito en el estado init, la conexión pasa automáticamente al estado running.

La conexión asume automáticamente el estado error si se produce al menos uno de los siguientes eventos:

• No se puede acceder a un broker MQTT

Subestructura: connections/mqttconnection

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../type	Tipo de conexión (MQTT)	mqtt: conexión MQTT	ro 1
../status	Estado de la conexión MQTT	init: estado init - Inicializaciónstopped: estado stopped - Conexión interrumpidarunning: estado running - Conexión en cursoerror: estado error - Estado de error	ro 1
../status/preset	Configuración predeterminada del estado de la conexión MQTT	running: estado running (por defecto)	ro 1
../MQTTSetup	Subestructura para la configuración general de MQTT
../MQTTSetup/QoS	Calidad de servicio (QoS) de la conexión MQTT	0: QoS Level 0 - PUBLISH (sin confirmación) (por defecto)1: QoS Level 1 - PUBLISH > PUBREC (confirmación simple)2: QoS Level 2 - PUBLISH > PUBREL > PUBCOMP (doble confirmación)	rw 2
../MQTTSetup/version	Versión MQTT	p. ej. 3.1.1	ro 1
../MQTTSetup/KeepAlive	KeepAlive: tiempo máx. entre 2 paquetes consecutivos del protocolo MQTT (valor en s)	0: desactivado...10: 10 s (por defecto)...60: 60 s	rw 2

1 solamente lectura

² lectura y escritura

Servicios aplicables:

Nombre	Descripción
../status/start	Activar MQTT.
../status/stop	Desactivar MQTT.
../status/reset	Reiniciar MQTT.

8.3.12.2 Configurar el canal de comandos MQTT

▷ El canal de comandos MQTT permite enviar y recibir notificaciones (→ Utilizar notificaciones ☐ 39) del ifm IoT Core.

Asegúrese de que se puede acceder al broker MQTT y de que el puerto seleccionado del broker MQTT está habilitado para la transmisión de datos.

No se admiten los comodines "+" y "#" en los nombres de los topics.

Subestructura: connections/mqttconnection/mqttcmdchannel

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../type	Tipo de canal de comandos	·mqtt: canal de comandos MQTT (por defecto)	ro 1
../status	Estado del canal de comandos	·init: estado init·stopped: estado stopped·running: estado running (por defecto)·error: estado error	ro 1
../status/preset	Estado del canal predeterminado	·running: estado running (por defecto)	ro 1
../mqtt CmdChannel Setup	Subestructura para la configuración del canal de comandos	--
../mqtt CmdChannel Setup/brokerIP	Dirección IP del broker MQTT	p. ej. 3.69.1.9	rw 2
../mqtt CmdChannel Setup/broker-Port	Número de puerto del broker MQTT	p. ej. 1883	rw 2
../mqtt CmdChannel Setup/cmdTopic	Denominación del topic del comando MQTT	p. ej. reqTopic	rw 2
../mqtt CmdChannel Setup/default ReplyTopic	Denominación del topic de respuesta MQTT estándar	p. ej. resp Topic	rw 2
../mqttcmdchannelsetup/user	Nombre de usuario	p. ej. user1	rw 2
../mqttcmdchannelsetup/password	Contraseña (no codificada en Base64)	p. ej. password123	rw 2

1 solamente lectura

² lectura y escritura

Servicios aplicables:

Nombre	Descripción
../status/start	Iniciar canal MQTT
../status/stop	Detener canal MQTT
../status/reset	Reiniciar canal MQTT

8.3.12.3 Ejemplo: configurar y activar el canal de comandos MQTT

Tarea: se debe configurar el canal de comandos MQTT de un broker MQTT (dirección IP:

192.168.82.100, puerto: 1883, topic de comando: reqTopic, topic de respuesta estándar: resp
Topic). La conexión MQTT se debe configurar para el nivel 2 de QoS.

Solución: la solución se divide en las siguientes fases:

▶ Comprobar si es accesible el broker MQTT y si se ha habilitado el puerto deseado.
▶ Activar el canal de comandos.

Petición (Request):

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

▶ Establecer la dirección IP del broker MQTT.

Petición (Request):

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

▶ Establecer el puerto del broker MQTT.

Petición (Request):

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

▶ Establecer el nombre del topic.

Petición (Request):

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

▶ Establecer el nombre del topic de respuesta estándar.

Petición (Request):

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

▶ Establecer el nivel de QoS.

Petición (Request):

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

8.3.12.4 Ejemplo: publicar la temperatura del equipo en el broker MQTT

Tarea: la temperatura del equipo se debe publicar en un broker MQTT cada 10 s (broker MQTT: 192.168.82.100, puerto: 1883, topic: devtemp).

Solución:

Requisitos:

√ ▷ La conexión MQTT está configurada.
√ ▷ El canal de comandos MQTT está configurado.
√ El intervalo del temporizador 1 se ajusta en 10 s.
√ El temporizador 1 se ha puesto en marcha.
▶ Publicar el valor del proceso en el broker MQTT utilizando el servicio subscribe.

Petición (Request) – El broker MQTT no está protegido por contraseña:

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

Petición (Request) – El broker MQTT está protegido por contraseña (nombre de usuario: user1, contraseña: password123):

{
    "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"]
    }
} 

Respuesta (Response):

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

La notificación se envía en formato JSON y tiene la siguiente estructura:

{
    "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 Restablecer, reiniciar y localizar el equipo

Subestructura: firmware

Servicios aplicables:

Nombre	Descripción
../factoryreset	Restablecer la configuración de fábrica del equipo
../reboot	Reiniciar el equipo
../signal	Activar el parpadeo del LED de estado

8.3.14 Lectura y escritura de información del equipo

Subestructura: deviceinfo

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../serialnumber	Número de serie	p. ej. 000194610104	ro 1
../swrevision	Versión de firmware	p. ej. V1.36	ro 1
../bootloaderrevision	Versión del cargador de arranque	p. ej. V0.06	ro 1
../productinstanceuri	Denominación del nodo raíz del árbol IoT Core	p. ej. B4-E3-F9-C7-54-43	ro 1
../eepromversion	Versión EEPROM	p. ej. V0.02	ro 1
../btmacaddress	Dirección MAC Bluetooth	p. ej. B4-E3-F9-C7-54-43	ro 1
../hwrevision	Versión de hardware	p. ej. AA	ro 1
../producttext	Denominación del producto	Bluetooth Mesh IoT Basestation	ro 1
../vendor	Fabricante	ifm electronic gmbh	ro 1
../productname	Nombre del producto	EIO404	ro 1
../productcode	Código del producto	EIO404	ro 1
../devicename	Nombre del equipo especificado por el usuario	p. ej. mesh_base	rw 2

1 solamente lectura
² lectura y escritura

8.3.15 Lectura de información de estado y diagnóstico

Subestructura: processdatabasestation

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
../temperature/cpu	Temperatura de la CPU del equipo (valor en °C)	-40: -40°C...85: 85°C	ro 1
../voltage/input	Tensión de entrada del equipo (valor en mV)	0: 0 mV...40000: 40000 mV	ro 1
../operatingstate	Estado de funcionamiento del equipo	0: Device OK1: Bluetooth Mesh no device provisioned2: Ethernet link not connected3: Electronic temperature out of range4: Bluetooth LE connected5: Firmware update installation6: Hardware Error7: Undervoltage	ro 1

1 solamente lectura

8.4 ifm moneo|configure

8.4.1 Establecer conexión con el equipo

▶ Durante la primera puesta en marcha, cambiar la contraseña configurada de fábrica para la interfaz Bluetooth, Bluetooth LE: configurar la protección por contraseña (→ 54).

▶ Establecer adicionalmente la contraseña para la interfaz Ethernet, IoT: configurar la protección por contraseña (→ ☐ 53).

Requisitos:

√ El equipo está conectado a un PC/portátil con moneo a través de una interfaz Ethernet.
√ ifm moneo|configure está instalado en el PC/portátil y se dispone de su licencia, Instalar ifm moneo|configure (→ 18).
▶ Iniciar ifm moneo|configure.
▶ Buscar equipos disponibles en la red (tipo de equipo: Generic IoT-Core device, dirección IP: 192.168.0.79).

▷ ifm moneo|configure detecta el equipo.

▶ En la columna [Acciones]: hacer clic en 📄.
▷ Aparece el editor de valores de parámetros del equipo.

8.4.1.1 Aprovisionar adaptadores Bluetooth Mesh IO-Link

Para añadir un adaptador Bluetooth Mesh IO-Link a una red Bluetooth Mesh, el adaptador se debe aprovisionar en la estación base Bluetooth Mesh IoT.

Requisitos:

√ ifm moneo|configure se ha iniciado.
√ Se ha encontrado el equipo durante la exploración de la red.

▶ En la columna [Acciones]: hacer clic en 🎥.

▷ Aparece un cuadro de diálogo.

La estación base Bluetooth Mesh IoT busca adaptadores Bluetooth Mesh IO-Link disponibles en los alrededores.
▷ Los equipos disponibles se muestran en la lista.

▶ Seleccionar el adaptador Bluetooth Mesh IO-Link deseado.
▶ Hacer clic en [CONECTAR].
▷ Se aprovisionan los adaptadores Bluetooth Mesh IO-Link seleccionados.
▷ Los equipos aprovisionados son participantes de la red Bluetooth Mesh.
▷ En la vista general, los adaptadores aprovisionados aparecen como subnodos de la estación base Bluetooth Mesh IoT.

Tras el aprovisionamiento, la estación base Bluetooth Mesh IoT establece automáticamente la conexión con todos los adaptadores Bluetooth Mesh IO-Link aprovisionados. La conexión se establece directamente o a través de otros adaptadores Bluetooth Mesh IO-Link.

Los adaptadores Bluetooth Mesh IO-Link envían los datos de proceso cíclicamente a la estación base Bluetooth Mesh IoT en un intervalo definido. Los datos de proceso se pueden leer y utilizar para la supervisión del sistema.

8.4.1.2 Eliminar adaptadores Bluetooth Mesh IO-Link de la red Mesh

Requisitos:

√ ifm moneo|configure se ha iniciado.
√ Se ha detectado el equipo durante la exploración de la red.
√ El adaptador Bluetooth Mesh IO-Link es participante de la red Bluetooth Mesh.

▶ En la columna [Acciones]: hacer clic en 📄.
▷ Aparece un mensaje sobre las consecuencias de la eliminación.
▶ Hacer clic en [OK] para confirmar el mensaje.
El adaptador Bluetooth Mesh IO-Link se elimina de la red Bluetooth Mesh.
▷ El crédito utilizado para el aprovisionamiento vuelve a estar disponible.

8.4.2 Información: leer información de identificación

Información disponible:

Nombre	Descripción	Rango de valores	Acceso
[Serial number]	Número de serie	p. ej. 000022503648	ro 1
[SW-Revision]	Versión de firmware	p. ej. V1.42	ro 1
[Bootloader revision]	Versión del cargador de arranque	p. ej. V0.07	ro 1
[EEPROM revision]	Versión EEPROM	p. ej. V0.03	ro 1
[Bluetooth MAC address]	Dirección MAC Bluetooth	p. ej. B4-E3-F9-C7-54-43	ro 1
[HW-Revision]	Versión de hardware	p. ej. AA	ro 1
[Product text]	Denominación del producto	Bluetooth Mesh IoT Basestation	ro 1
[Vendor]	Fabricante	ifm electronic gmbh	ro 1
[Product code]	N.° de artículo	EIO404	ro 1

1 solamente lectura

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [Info].
▷ La página de menú muestra la información del equipo.

8.4.3 IoT: configurar los ajustes IP

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[IP address]	Dirección IP de la interfaz Ethernet	p. ej. 192.168.0.100	rw 1
[Subnet mask]	Máscara de subred de la red Ethernet	p. ej. 255.255.255.0	rw 1
[Default gateway IP address]	Dirección IP de la puerta de enlace de la red	p. ej. 192.168.0.1	rw 1
[DHCP]	Activar / desactivar el cliente DHCP del equipo	IP estática: la configuración IP la establece el usuario (por defecto)DHCP: la configuración IP la establece el servidor DHCP de la red	r w 1
[MAC address]	Dirección MAC de la interfaz	p. ej. 00-02-01-42-DC-B0	ro 2

¹ lectura y escritura

² solamente lectura

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [IoT].
▷ La página de menú muestra la configuración actual de la interfaz Ethernet.
▶ Configurar los parámetros.
▶ Escribir los valores modificados en el equipo.
▷ La nueva configuración IP de la interfaz Ethernet está activa.

8.4.4 IoT: configurar la protección por contraseña

La protección por contraseña protege el equipo contra accesos no autorizados a través de la interfaz Ethernet.

Después de establecer la contraseña, el usuario debe autenticarse con su nombre de usuario y contraseña al acceder al equipo a través de la interfaz Ethernet.

El nombre de usuario es administrator. El nombre de usuario es fijo y no se puede cambiar.

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Security password]	Contraseña para el acceso protegido a la interfaz Ethernet (longitud permitida: 6-32 caracteres)		wo 1

1 solamente escritura

8.4.4.1 Establecer una contraseña para Ethernet

Para establecer la contraseña de la interfaz Ethernet:

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [IoT].
▷ La página de menú muestra la configuración actual.
▶ Introducir la contraseña deseada.
▶ Escribir los valores modificados en el equipo.
▶ La protección por contraseña está activada.
▷ El usuario deberá iniciar sesión con su nombre de usuario y la contraseña elegida la próxima vez que acceda al equipo.

8.4.4.2 Restablecer la contraseña para Ethernet

Al restablecer la contraseña se desactiva la protección contra el acceso no autorizado a la interfaz Ethernet del equipo.

Para restablecer la contraseña de la interfaz Ethernet:

Requisitos:

√ Se abre la vista [Configurar equipos].
√ El editor de valores de parámetros del equipo está abierto.
√ El modo de seguridad de la interfaz Ethernet está activado.

▶ Seleccionar el menú [IoT].

▷ La página de menú muestra la configuración actual.

▶ Hacer clic en [Reset password].

▷ La contraseña se elimina.

▷ Se desactiva la protección por contraseña.

El usuario puede acceder al equipo a través de la interfaz Ethernet sin necesidad de introducir un nombre de usuario y una contraseña.

8.4.5 Bluetooth LE: establecer un nombre para la estación

Puntos de datos disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Bluetooth LE name]	Nombre del equipo en la red Bluetooth LE (máx. 22 caracteres)	p. ej. colector de temperatura	rw 1

¹ lectura y escritura

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [Bluetooth LE].
▷ La página de menú muestra la configuración actual.
▶ Introducir el nombre de la estación.
▶ Escribir los valores modificados en el equipo.
▷ El nombre del equipo en la red Bluetooth LE está configurado.

8.4.6 Bluetooth LE: configurar la protección por contraseña

Observar las indicaciones sobre la contraseña de Bluetooth: Contrasena Bluetooth (→ 18)

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Security password]	Establecer una contraseña para la auten- ticación en la interfaz Bluetooth LE• Longitud mín.: 6• Longitud máx.: 32¡NOTA! La contraseña no interfiere en las funciones Mesh.		rw 1

¹ lectura y escritura

8.4.6.1 Cambiar la contraseña de Bluetooth

Para cambiar la contraseña de la interfaz Bluetooth LE:

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.

▶ Seleccionar el menú [Bluetooth LE].
▷ La página de menú muestra la configuración actual.
▶ Introducir la contraseña deseada.
▶ Escribir los valores modificados en el equipo.
▷ La nueva contraseña está activa.

8.4.7 Bluetooth Mesh: administrar la red

Para obtener información sobre los adaptadores activos en la red Mesh:

Información disponible:

Nombre	Descripción	Rango de valores	Acceso
[Max Mesh Nodes]	Número máx. de nodos	0...50	ro 1
[Current Mesh Nodes]	Cantidad actual de nodos de la red Mesh	0...50	ro 1
[Taken Mesh Credits]	Número actual de créditos utilizados para el aprovisionamiento		ro 1

1 solamente lectura

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [Bluetooth Mesh].
▷ La página de menú muestra información sobre la red Mesh.

8.4.8 MQTT: configurar la conexión MQTT

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[MQTT Version]	Versión MQTT	p. ej. 3.1.1	ro 1
[Quality of Service]	Calidad de servicio (QoS) de la conexión MQTT	QoS 0: QoS Level 0 - PUBLISH (sin confirmación) (por defecto)QoS 1: QoS Level 1 - PUBLISH > PUBREC (confirmación simple)QoS 2: QoS Level 2 - PUBLISH > PUBREC > PUBREL > PUBCOMP (doble confirmación)	rw 2
[Keep Alive]	Tiempo máx. entre 2 paquetes consecutivos del protocolo MQTT (valor en s)	0: 0 s...10: 10 s...60: 60 s	rw 2

1 solamente lectura
² lectura y escritura

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Acceder al menú [MQTT].
▷ La página de menú muestra la configuración actual de la conexión MQTT.
▶ Configurar los parámetros.
▶ Escribir los valores modificados en el equipo.
▷ La conexión MQTT está configurada.

8.4.8.1 Controlar la conexión MQTT

El siguiente diagrama de estado muestra la influencia de los servicios start, stop y reset en el estado actual de una conexión MQTT:

Tras una inicialización ejecutada con éxito en el estado init, la conexión pasa automáticamente al estado running.

La conexión asume automáticamente el estado error si se produce al menos uno de los siguientes eventos:

• No se puede acceder a un broker MQTT

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.

√ La conexión MQTT está configurada.

▶ Acceder al menú [MQTT].

Para activar la conexión MQTT:

▶ Hacer clic en [Start].

▷ La conexión MQTT se activa.

Para desactivar la conexión MQTT.

▶ Hacer clic en [Stop].

▷ La conexión MQTT se desactiva.

Para restablecer la conexión MQTT:

▶ Hacer clic en [Reset].

▷ La conexión MQTT se restablece.

8.4.9 MQTT: configurar el canal de comandos

Asegúrese de que se puede acceder al broker MQTT y de que el puerto seleccionado del broker MQTT está habilitado para la transmisión de datos.

No se admiten los comodines "+" y "#" en los nombres de los topics.

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Broker IP]	Dirección IP del broker MQTT	p. ej. 3.69.1.9	rw1
[Broker Port]	Número de puerto del broker MQTT	p. ej. 1883	rw1
[Topic]	Denominación del topic MQTT	p. ej. reqTopic	rw1
[Reply Topic]	Topic de respuesta estándar	p. ej. resp Topic	rw1
[Username]	Nombre de usuario	p. ej. user1	rw1
[Password]	Contraseña (no codificada en Base64)	p. ej. passwort123	wo2

¹ lectura y escritura
2 solamente escritura

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Acceder al menú [MQTT] > [MQTT Command Channel].

▷ La página de menú muestra la configuración actual del canal de comandos MQTT.

▶ Configurar los parámetros.
▶ Escribir los valores modificados en el equipo.
▷ El canal de comandos MQTT está configurado.

8.4.9.1 Controlar el canal de comandos MQTT

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
√ ▷ El canal de comandos MQTT está configurado.
▶ Acceder al menú [MQTT] > [MQTT Command Channel].

Para activar el canal de comandos MQTT:

▶ Hacer clic en [Start].
El canal de comandos MQTT se activa.

Para desactivar el canal de comandos MQTT:

▶ Hacer clic en [Stop].
El canal de comandos MQTT se desactiva.

Para restablecer el canal de comandos MQTT:

▶ Hacer clic en [Reset].
El canal de comandos MQTT se restablece.

8.4.10 Timer: configurar temporizadores

El equipo dispone de 2 temporizadores. Los temporizadores se pueden utilizar para la transferencia basada en el tiempo de las notificaciones.

Parámetros disponibles:

Nombre	Descripción	Rango de valores	Acceso
[Interval]	Intervalo del contador (valor en ms)	1000: 1000 ms86400000: 86400000 ms	r w 1

¹ lectura y escritura

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [Timer 1] / [Timer 2].
▷ La página de menú muestra la configuración actual.
▶ Introducir el intervalo del contador.
▶ Escribir los valores modificados en el equipo.
▷ Se establece el intervalo del contador seleccionado.

8.4.10.1 Iniciar temporizador

Los temporizadores [Timer 1] y [Timer 2] se pueden iniciar por separado.

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
√ El intervalo del contador está configurado.
▶ Seleccionar el menú [Timer 1] / [Timer 2].
▷ La página de menú muestra la configuración actual.

▶ Hacer clic en [Start].

▷ El temporizador seleccionado comienza en 0.

▷ Cuando expira el intervalo del contador configurado, el temporizador genera una señal.

8.4.10.2 Detener temporizador

Los temporizadores [Timer 1] y [Timer 2] se pueden detener por separado.

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [Timer 1] / [Timer 2].
▷ La página de menú muestra la configuración actual.
▶ Hacer clic en [Stop].
▷ El temporizador se detiene.

8.4.11 Firmware: restablecer, reiniciar o localizar el equipo

Requisitos:

√ El editor de valores de parámetros del equipo está abierto.
▶ Seleccionar el menú [Firmware].
▷ La página de menú muestra las opciones disponibles.

Para localizar el equipo:

▶ Hacer clic en [Signal].
▷ Los LED del equipo parpadean.

Para restablecer el equipo:

▶ Hacer clic en [Factory Reset].
▷ El equipo se restablece a los valores de fábrica.

Para reiniciar el equipo:

▶ Hacer clic en [Reboot].
▷ El equipo se reinicia.

8.5 IoT Core Visualizer

IoT Core Visualizer ofrece una interfaz gráfica de usuario, a través de la cual puede acceder a las funciones del ifm IoT Core.

8.5.1 Inicio del IoT Core Visualizer

Para iniciar el IoT Core Visualizer:

Requisitos:

√ El equipo está conectado correctamente, Parametrización a través de la interfaz Ethernet (→ 17).
√ La interfaz Ethernet está configurada.
▶ Iniciar el navegador web.
▶ Acceder a la siguiente URL: http:// (en la configuración de fábrica http://192.168.0.79).
▷ El navegador web muestra la página de inicio del IoT Core Visualizer.

A través del menú de navegación es posible acceder a las siguientes funciones:

• [Notification]: Gestión de notificaciones (→ 59)
  • [Elements]: Acceso al árbol IoT Core (→ 61)
  • [Update]: Actualización del firmware

8.5.2 Gestión de notificaciones

A través de la página del menú [Notification] es posible acceder a la función de notificación de IoT Core.

▶ Observar las indicaciones sobre las notificaciones: Utilizar notificaciones (→ 39)

Requisitos:

√ Se ha iniciado IoT Core Visualizer.
▶ Seleccionar el menú [Notification].
▷ Aparecerá la página de menú para gestionar las notificaciones.
▷ La tabla muestra todas las notificaciones activas.

8.5.2.1 Creación de nuevas notificaciones

Las nuevas notificaciones se crean mediante un asistente.

En el caso de las notificaciones basadas en el tiempo usando el temporizador 1 o el temporizador 2, el usuario deberá ajustar el tiempo de intervalo del temporizador correspondiente.

Requisitos:

√ Se ha iniciado IoT Core Visualizer.
√ El menú [Notification] está activo.
▶ Hacer clic en + en la esquina derecha de la tabla.
▷ Aparecerá el asistente para crear notificaciones.

▶ Seleccionar paso a paso los parámetros de notificación deseados mediante este asistente.
▷ La tabla muestra la notificación creada.

8.5.2.2 Eliminación de notificaciones

Requisitos:

√ Se ha iniciado IoT Core Visualizer.
√ El menú [Notification] está activo.
√ Se ha creado al menos una notificación.
▶ Hacer clic en × en la columna [Unsubscribe] de la línea de la notificación.
▷ La notificación seleccionada se elimina.

8.5.3 Acceso al árbol IoT Core

A través de la página de menú [Elements] es posible acceder al árbol IoT Core del equipo.

Requisitos:

√ Se ha iniciado IoT Core Visualizer.
▶ Seleccionar el menú [Elements].
▷ Aparecerá la página de menú para acceder a los elementos del árbol IoT Core.
▷ La vista muestra la estructura del árbol IoT Core del equipo.

8.5.3.1 Búsqueda de elementos del IoT Core

La página de menú [Elements] permite buscar en el árbol del IoT Core elementos con propiedades específicas y mostrar los resultados.

Es posible buscar las siguientes propiedades:

• [identifier]: Nombre del elemento
• [profile]: Perfil del elemento
• [type]: Tipo de elemento

Requisitos:

√ Se ha iniciado IoT Core Visualizer.
√ El menú [Elements] está activo.

▶ Seleccionar los criterios de búsqueda del elemento deseado en las listas de selección [identifier], [profile] y [type].
▶ Hacer clic en [Search for Elements].
▷ IoT Core Visualizer buscará en la descripción del equipo elementos que coincidan con los criterios de búsqueda seleccionados.
▷ La lista de resultados muestra todos los elementos encontrados.

8.5.3.2 Acceso a elementos del IoT Core

El usuario puede acceder a los elementos del IoT Core mediante los servicios admitidos por el equipo.

▶ Se puede obtener más información sobre las funciones del ifm IoT Core en: API REST de ifm IoT Core (→ 25)

Requisitos:

√ Se ha iniciado IoT Core Visualizer.
√ El menú [Elements] está activo.
▶ Opcional: Búsqueda de elementos del IoT Core (→ ☐ 61)
▶ Navegar hasta el elemento.
▶ Hacer clic en el símbolo de la flecha situado junto al servicio.

▷ Aparece un cuadro de diálogo.

▶ Opcional: introducir los valores requeridos en el campo para obtener el permiso de escritura.
▶ Hacer clic en [Request] para ejecutar el servicio.
▷ Se ejecutará el servicio en el equipo.

O bien

▶ Hacer clic en [Cancel] para cancelar la operación.
▷ El servicio no se ejecutará.

8.5.4 Actualización del firmware

La página de menú [Update] ofrece la posibilidad de actualizar el firmware de la estación base Bluetooth Mesh IoT y de los adaptadores Bluetooth Mesh IO-Link aprovisionados.

Nuevo firmware disponible en la página específica del equipo: documentation.ifm.com

Para obtener información sobre la actualización del firmware de un único adaptador Bluetooth Mesh IO-Link: Manual de instrucciones EIO344

La actualización del firmware no se debe interrumpir.

▶ No reiniciar el equipo durante el proceso de actualización.
▶ Esperar hasta que se complete la actualización.

Requisitos:

√ Se ha iniciado IoT Core Visualizer.
√ Se ha descargado el nuevo firmware: documentation.ifm.com
▶ Seleccionar el menú [Update].

▷ La página de menú muestra información sobre la versión de firmware actual de la estación base Bluetooth Mesh IoT (apartado [Base_update]).
▷ La página de menú muestra información sobre la versión de firmware actual de los adaptadores Bluetooth Mesh IO-Link aprovisionados en la estación base (apartado [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 actualizar el firmware de la estación base Bluetooth Mesh IoT:

▶ Cambiar al apartado de la estación base Bluetooth Mesh IoT.
▶ Hacer clic en [Load software file] y seleccionar el nuevo archivo de firmware (*.bin).
▶ Hacer clic en [Update] para iniciar el proceso de actualización.

▷ El firmware de la estación base Bluetooth Mesh IoT se actualiza.
▷ Se mostrará el progreso del proceso de actualización.

▷ Tras una actualización correcta: el equipo se reinicia automáticamente.

Para actualizar el firmware de todos los adaptadores Bluetooth Mesh IO-Link aprovisionados y conectados:

▶ Cambiar al apartado de los adaptadores Bluetooth Mesh IO-Link.
▶ Hacer clic en [Load software file] y seleccionar el nuevo archivo de firmware (*.bin).

▶ Hacer clic en [Update] para iniciar el proceso de actualización.

▷ Se actualiza el firmware de todos los adaptadores Bluetooth Mesh IO-Link aprovisionados y conectados.
▷ Se mostrará el progreso del proceso de actualización.

▷ Tras una actualización correcta: los equipos se reinician automáticamente.

9 Solución de errores

Los errores, avisos y mensajes de estado se indican mediante el LED de estado: Elementos de manejo e indicación (→ ☐ 16)

En caso de error (el LED de estado parpadea en rojo), el estado del equipo proporciona información de diagnóstico detallada.

Imagen de error	Causa del error	Solución
El equipo está conectado a la fuente de alimentación, el LED de estado está apagado	Tensión de alimentación demasiado baja	► Comprobar el suministro de tensión
El equipo está conectado a la fuente de alimentación, el LED de estado se enciende en rojo	Error de hardware, el equipo está defectuoso	► Sustituir el equipo
El LED de estado parpadea en rojo, estado del equipo: [Over temperature] o [Under temperature]	Temperatura de la placa de circuito fue-ra del rango de tolerancia	► Comprobar la temperatura ambiente
El LED de estado parpadea en rojo, estado del equipo: [Bluetooth Mesh no device provisioned]	No hay conexión con la red Bluetooth Mesh	► Comprobar las distancias a los adaptadores Bluetooth Mesh IO-Link
El LED de estado parpadea en rojo, estado del equipo: [Ethernet link not connected]	Sin conexión Ethernet	► Comprobar el cableado Ethernet

ifm moneo proporciona información adicional de estado y diagnóstico en modo online: → Ayuda en línea de ifm moneo

10 Mantenimiento, reparación y eliminación

El equipo no requiere mantenimiento.

▶ En caso de fallos de funcionamiento, ponerse en contacto con ifm.
▶ No está permitido abrir la carcasa, ya que dentro del equipo no se encuentran piezas que deban ser sometidas a mantenimiento por parte del usuario. Las reparaciones en el equipo solamente pueden ser efectuadas por el fabricante.
▶ Limpiar el equipo con un paño seco.
▶ Eliminar el equipo según las normas nacionales sobre medio ambiente.

10.1 Actualización del firmware

El firmware del equipo se puede actualizar mediante las siguientes opciones:

• ifm moneo|blue: Actualización del firmware (→ 23)
• IoT Core Visualizer: Actualización del firmware (→ 63)

11 Anexo

11.1 ifm IoT Core

11.1.1 Perfiles

Perfil	Descripción
blob	Binary Large Object
comm Channel	Canal de comunicación
comm Interface	Interfaz de comunicación
connections	Conexiones
const_value	Constante
datarequired	Datos necesarios
deviceinfo	Información de identificación
devicereset	Firmware reseteable
devicestatus	Estado del equipo
eventcollection	Recopilación de eventos
mqtt CmdChannel Setup	Configuración del canal de comandos MQTT
mqtt Setup	Ajustes MQTT
network	Red
parameter	Parámetro
processdata	Datos del proceso
runcontrol	Estructura de control
securityconfig_base	Ajustes de seguridad
software	Software
software/uploadable-software	Software actualizable
subdatablock	Datos que solo se pueden modificar por bloques
timer	Temporizador
wirelessprovisioning	Estructura de gestión de redes inalámbricas

11.1.2 Tipos

Tipo	Descripción
data	Punto de datos
device	Elemento raíz que define un equipo
event	Evento que puede ser activado por el firmware y envía notificaciones
service	Servicio al que se puede acceder desde la red
structure	Elemento estructural (por ejemplo, una carpeta del sistema de archivos)

11.1.3 Servicios

11.1.3.1 Servicio: create_backup

Nombre: create_backup

Descripción: el servicio crea una copia de seguridad de la configuración actual del equipo.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.2 Servicio: factoryreset

Nombre: factoryreset

Descripción: el servicio restablece la configuración de fábrica de los parámetros del equipo.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.3 Servicio: get_credit

Nombre: get_credit

Descripción: el servicio lee un crédito disponible de la red Bluetooth.

Petición (campo "data"): Ninguno

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
netkey	Obligatorio	STRING	Clave de red
iv_key	Obligatorio	INT	Índice
appkey	Obligatorio	STRING	Clave de la aplicación
address	Obligatorio	INT	Dirección
expiry_time	Obligatorio	INT	Tiempo de expiración (valor en s)

11.1.3.4 Servicio: getblobdata

Nombre: getblobdata

Descripción: el servicio lee un objeto binario grande (blob).

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
Pos	Obligatorio	NUMBER	Posición del byte
length	Obligatorio	NUMBER	Tamaño del objeto (cantidad de bytes)

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
data	Obligatorio	STRING	Datos que se deben descodificar (codificación BASE64)
crc	Opcional	HEX STRING	CRC de los datos tras la descodificación
md5	Opcional	HEX STRING	Suma de comprobación MD5 de los datos tras la descodificación

11.1.3.5 Servicio: getdata

Nombre: getdata

Descripción: el servicio lee el valor de un punto de datos y lo emite.

Petición (campo "data"): Ninguno

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
value	Obligatorio	STRING	Valor del punto de datos

11.1.3.6 Servicio: getdatamulti

Nombre: getdatamulti

Descripción: el servicio lee secuencialmente los valores de varios puntos de datos y los emite. Para cada punto de datos, se emiten el valor y un código de diagnóstico.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
datatosend	Obligatorio	ARRAY OF STRINGS	Lista de puntos de datos que se deban consultar; los puntos de datos deben admitir el servicio getdata ("datatosend":["url1","url2",..., "urlx"])

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
url	Obligatorio	STRING	Punto de datos consultado
code	Obligatorio	INT	Código de diagnóstico de la consulta
data	Obligatorio	STRING	Valor del punto de datos

11.1.3.7 Servicio: getidentity

Nombre: getidentity

Descripción: el servicio recupera información sobre la identidad del equipo.

Petición (campo "data"): Ninguno

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
iot		device	Descripción del equipo como objeto JSON
iot.name	Obligatorio	STRING	Tipo de elemento
iot.uid	Opcional	STRING
iot.version	Obligatorio	STRING
iot.catalogue	Opcional	ARRAY OF OBJECTS
iot.deviceclass	Opcional	ARRAY OF STRING	Tipo de equipo
iot.serverlist	Opcional	ARRAY OF OBJECTS
device	Opcional		N.° de artículo
device.serialnumber	Opcional		Número de serie
device.hwrevision	Opcional		Versión de hardware
device.swrevision	Opcional		Versión del software
device.custom	Opcional

El parámetro secuity.isPasswd
Set devuelve el estado de la contraseña de la conexión a través de la cual se accede al servicio.

Ejemplo 1:

√ Se ha establecido la contraseña para la conexión Bluetooth.
▶ Realizar una petición getidentity a través del navegador web.
▷ security.isPasswd
Set = false

Ejemplo 2:

√ Se ha establecido la contraseña para la conexión Ethernet.
▶ Realizar una petición getidentity a través del navegador web.
▷ security.isPasswd
Set = true

11.1.3.8 Servicio: getsubscriberlist

Nombre: getsubscriberlist

Descripción: el servicio proporciona una lista de todas las suscripciones activas.

Petición (campo "data"): Ninguno

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
adr	Obligatorio	STRING	Desencadenante de la notificación
datatosend	Obligatorio	ARRAY OF STRINGS	Lista con URL de los elementos de datos; las URL están separadas por comas
cid	Obligatorio	STRING	ID de la notificación activa
callbackurl	Obligatorio	STRING	Dirección de destino de las notificaciones
duration	Obligatorio	STRING	Duración de la actividad

11.1.3.9 Servicio: gettree

Nombre: gettree

Descripción: el servicio lee la descripción del equipo y la muestra como un objeto JSON. La salida se puede limitar a un subárbol de la descripción del equipo.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
adr	Opcional	STRING	Elemento raíz del subárbol
level	Opcional	STRING	Nivel máximo hasta el que se emite el subárbol Sin especificar: se muestran todos los niveles0: no mostrar ningún subelemento ("subs")1: mostrar subelementos2: mostrar subelementos hasta el nivel 23: mostrar subelementos hasta el nivel 3...20: mostrar subelementos hasta el nivel 20

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
identifier	Obligatorio	STRING	Identificador del elemento raíz
type	Obligatorio	STRING	Tipo de elemento
format	Opcional	Objeto JSON	Formato del contenido de los datos
uid	Opcional	STRING
profiles	Opcional	JSON-Array
subs	Obligatorio	JSON-Array	Subelementos
hash	Opcional	STRING

11.1.3.10 Servicio: install

Nombre: install

Descripción: el servicio instala el software almacenado en un área de la memoria del equipo.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.11 Servicio: install_backup

Nombre: install_backup

Descripción: el servicio restaura una copia de seguridad almacenada en el área de la memoria del equipo.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.12 Servicio: querytree

Nombre: querytree

Descripción: el servicio busca en un árbol de equipos según los criterios profile, type e identifier y genera una lista con las URL de los elementos encontrados. Se debe especificar al menos uno de los criterios de búsqueda. El servicio solo es ejecutable en el nodo raíz del equipo.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
profile	Opcional	STRING	Perfil del elemento buscado
type	Opcional	STRING	Tipo del elemento buscado
identifier	Opcional	STRING	Nombre del elemento buscado

Respuesta (campo "data"): Ninguno

Parámetro	Campo obligatorio	Tipo de datos	Descripción
urllist	Obligatorio	ARRAY	Matriz con las URL de los elementos encontrados; las URL están separadas por comas

11.1.3.13 Servicio: reboot

Nombre: reboot

Descripción: el servicio reinicia el equipo.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.14 Servicio: register

Nombre: register

Descripción: el servicio registra un equipo compatible en la red.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
id	Obligatorio	STRING	Identificador del equipo que se debe registrar en la red

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
adr	Opcional	STRING	Ruta al equipo en la estructura de red

11.1.3.15 Servicio: replace

Nombre: replace

Descripción: el servicio quita un equipo de la red y registra un equipo idéntico en la red.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
old_id	Obligatorio	STRING	Identificador del equipo que se debe sustituir
new_id	Obligatorio	STRING	Identificador del equipo que se debe registrar

Respuesta (campo "data"): Ninguno

11.1.3.16 Servicio: reset

Nombre: reset

Descripción: el servicio restablece el estado de inicialización de una conexión.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.17 Servicio: resetpassword

Nombre: resetpassword

Descripción: el servicio desactiva el modo de seguridad y restablece la contraseña.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.18 Servicio: reset_credits

Nombre: reset_credits

Descripción: el servicio restablece todos los créditos solicitados de los adaptadores Bluetooth registrados en la red Mesh.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.19 Servicio: scan

Nombre: scan

Descripción: el servicio busca en el entorno los equipos compatibles. Se muestran los equipos encontrados y sus propiedades.

Petición (campo "data"): Ninguno

Respuesta (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
id	Obligatorio	STRING	Identificador del equipo
name	Obligatorio	STRING	Nombre del equipo
info	Opcional	ARRAY	Propiedades del equipo• Obligatorio: Signal Strength

11.1.3.20 Servicio: setblock

Nombre: setblock

Descripción: el servicio establece simultáneamente los valores de varios puntos de datos de una estructura.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
datatoset	Obligatorio	ARRAY OF OBJECTS	Lista de puntos de datos y sus nuevos valores; los puntos de datos deben admitir el servicio setdata
consistent	Opcional	BOOL	Respuesta en un tiempo determinado

Respuesta (campo "data"): Ninguno

11.1.3.21 Servicio: setdata

Nombre: setdata

Descripción: el servicio establece el valor de un punto de datos.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
newvalue	Obligatorio	STRING	Nuevo valor del punto de datos
duration	Opcional	STRING	Duración del almacenamiento del valorlifetime: el valor se almacena con IoT Core; el valor sigue siendo válido incluso después de reiniciar el equipouptime: el valor se guarda hasta el siguiente reinicio del equipo

Respuesta (campo "data"): Ninguno

11.1.3.22 Servicio: setdatamulti

Nombre: setdatamulti

Descripción: el servicio escribe secuencialmente los valores de varios puntos de datos. Se debe transferir el valor de referencia para cada punto de datos.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
datatosend	Obligatorio	ARRAY OF STRINGS	Lista de puntos de datos y valores asociados (codificados) que se deben escribir; los puntos de datos deben admitir el servicio setdata ("datatosend":["url1":"value1","url2":value2",..., "urlx":"valuex"])

Respuesta (campo "data"): Ninguno

11.1.3.23 Servicio: signal

Nombre: signal

Descripción: el servicio activa el parpadeo de los LED de estado del equipo.

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.24 Servicio: start

Nombre: start

Descripción: el servicio inicia una función (p. ej., conexión, temporizador).

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.25 Servicio: start_stream_set

Nombre: start_stream_set

Descripción: el servicio inicia la transmisión secuencial de varios fragmentos de datos.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
size	Obligatorio	STRING	Tamaño total de los datos para transmitir (cantidad de bytes)

Respuesta (campo "data"): Ninguno

11.1.3.26 Servicio: stop

Nombre: stop

Descripción: el servicio detiene una función (p. ej., conexión, temporizador).

Petición (campo "data"): Ninguno

Respuesta (campo "data"): Ninguno

11.1.3.27 Servicio: stream_set

Nombre: stream_set

Descripción: el servicio transmite un segmento de datos.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
value	Obligatorio	BIN (BASE64)	Segmento de los datos binarios (codificación BASE64)

Respuesta (campo "data"): Ninguno

11.1.3.28 Servicio: subscribe

Nombre: subscribe

Descripción: el servicio activa la notificación.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
callback	Obligatorio	STRING	Dirección de destino de las notificaciones; formato URL:JSON: http://ipaddress:port/pathJSON: ws://pathMQTT: mqtt://ipaddress:port/path
datatosend	Obligatorio	ARRAY OF STRINGS	Lista con URL de los elementos de datos; las URL están separadas por comas; los elementos deben admitir el servicio getdata
duration	Opcional	STRING	Periodo de validez de la notificaciónlifetime: el registro permanece activo permanentemente, incluso después de reiniciar el equipouptime: el registro está activo hasta el siguiente reinicio del equipoonce: enviar solo una notificación, el usuario debe volver a anular la suscripción directamente

Respuesta (campo "data"): Ninguno

Formato de la notificación: 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 Servicio: unregister

Nombre: unregister

Descripción: el servicio quita un equipo de la red.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
id	Opcional1	STRING	Identificador del equipo que se debe quitar de la red
adr	Opcional1	STRING	Ruta al equipo en la estructura de red

1 se debe transferir al menos uno de los dos parámetros

Respuesta (campo "data"): Ninguno

11.1.3.30 Servicio: unsubscribe

Nombre: unsubscribe

Descripción: el servicio elimina una notificación activa. Los valores transferidos para cid y callback deben ser los mismos que para el registro de la notificación (subscribe). Si se transfiere el valor "DELETE" en callback, se eliminarán todas las suscripciones activas.

Petición (campo "data"):

Parámetro	Campo obligatorio	Tipo de datos	Descripción
callback	Obligatorio	STRING	Dirección de destino de las notificaciones; formatos de URL:JSON: http://ipaddress:port/pathJSON: ws://pathJSON: mqtt://ipadress:port/topicDELETE: se eliminan todas las notificaciones activas

Respuesta (campo "data"): Ninguno