Librería Modbus RTU Master para Automatización Industrial
Librería Modbus RTU Master para Automatización Industrial
Librería Modbus RTU Master para Automatización Industrial
Introducción
Usos
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 1/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Modbus es un protocolo de comunicación situado en los niveles 1, 2 y 7 del Modelo OSI, basado en la arquitectura
maestro/esclavo, diseñado en 1979 por Modicon para su gama de PLCs.
2. Es público y gratis
5. Cada uno de los mensajes incluye información redundante que garantiza su integridad en la recepción.
6. Los comandos básicos de Modbus permiten controlar un dispositivo RTU para modificar el valor de cualquiera de
sus registros o solicitar el contenido de los mismos.
Modbus RTU se utiliza en la comunicación en serie y hace uso de una representación compacta y binaria de los datos
para la comunicación del protocolo.
Los mensajes Modbus se dividen por periodos de inactividad, como se puede ver en la siguiente imagen.
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 2/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
El Modbus RTU funciona mediante RS-485, que es una red multipunto de un solo cable, solo el nodo asignado como
maestro puede iniciar un comando. Todos los demás dispositivos son esclavos y responden a solicitudes y comandos.
Un comando Modbus contiene la dirección Modbus del dispositivo al que va dirigido. Sólo el dispositivo al que va
dirigido responderá y actuará sobre el comando, aunque otros dispositivos puedan recibirlo.
Además, es importante decir que todos los comandos Modbus contienen información de suma de comprobación
para que el receptor pueda detectar errores de transmisión.
Pongamos un ejemplo. Imaginemos que tenemos una red serial Modbus, donde hay un maestro y hasta 31 esclavos,
cada uno con una dirección de esclavo única.
El maestro sólo quiere enviar un mensaje al esclavo número 2 solicitando el valor de 6 registros de entrada.
Así, el maestro enviaría un mensaje y todos los esclavos lo recibirían, pero sólo el esclavo número 2 respondería y
actuaría sobre la orden, aunque otros dispositivos podrían recibirla.
Con este ejemplo, vamos a crear un mensaje Modbus RTU a lo largo de este post. Mensaje Modbus por el momento: 02
(dirección del esclavo)
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 3/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
La unidad de datos de aplicación (ADU) de Modbus RTU consta de los elementos mostrados:
Address: We set the slave address for the device to which we want to send the message.
Function Code: The number of the function code. You can see the table of the function codes in the "Modbus function
codes" section.
Data: The message itself. This can vary depending on the function code.
CRC: The number of the cyclic redundancy check. It must be calculated.
De ellos, el código de función y los datos constituyen la unidad de datos de protocolo (PDU)
MODBUS es un protocolo de solicitud/respuesta y ofrece servicios especificados por códigos de función. Los códigos de
función de MODBUS son elementos de las PDU de solicitud/respuesta de MODBUS.
El campo de código de función de una unidad de datos MODBUS se codifica en un byte. Los códigos válidos están en el
rango de 1 a 255 decimales (el rango 128 - 255 está reservado y se utiliza para las respuestas de excepción). Cuando se
envía un mensaje desde un Cliente a un dispositivo Servidor, el campo de código de función indica al servidor qué tipo
de acción debe realizar. El código de función "0" no es válido. Los códigos de subfunción se añaden a algunos códigos
de función para definir múltiples acciones.
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 4/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
En Modbus, los tipos de datos se pueden dividir principalmente en dos tipos: Bobinas y Registros. Las bobinas pueden
entenderse como digitales ya que sólo pueden estar en ON (1) o en OFF (0). Algunas bobinas pueden representar
entradas y otras salidas.
Los registros son de 16 bits ( 2 bytes) sin signo y por lo tanto pueden tener valores de 0 a 65535 (0 a FFFF). Aunque tiene
sus limitaciones como que no puede representar números negativos , números en coma flotante o valores con
representación mayor a 65535. La siguiente tabla resume los tipos de objetos.
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 5/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Este código de función se utiliza para leer de 1 a 2000 estados contiguos de bobinas en un dispositivo remoto.
Las bobinas en el mensaje de respuesta se empaquetan como una bobina por bit del campo de datos. El estado se
indica como 1: ON y 0: OFF. El LSB del primer byte de datos contiene la salida a la que se dirige la consulta. Las demás
bobinas siguen hacia el extremo de orden alto de este byte, y de orden bajo a orden alto en los bytes siguientes.
Request
Response
Solicitud Respuesta
Función 01 Función 01
Este código de función se utiliza para leer de 1 a 2000 estados contiguos de entradas discretas en un dispositivo
remoto.
La PDU de solicitud especifica la dirección de inicio, es decir, la dirección de la primera entrada especificada, y el
número de entradas. En la PDU, las entradas discretas se direccionan empezando por cero. Por lo tanto, las entradas
discretas numeradas de 1 a 16 se direccionan como 0 a 15.
Las entradas discretas en el mensaje de respuesta se empaquetan como una entrada por bit del campo de datos. El
estado se indica como 1= ON; 0= OFF. El LSB del primer byte de datos contiene la entrada dirigida en la consulta. Las
demás entradas siguen hacia el final de orden alto de este byte, y de orden bajo a orden alto en los bytes siguientes.
Request
Response
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 7/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Solicitud Respuesta
Función 02 Función 02
Dirección de 00 Recuento de 03
salida Hi bytes
Este código de función se utiliza para leer el contenido de un bloque contiguo de registros de retención en un
dispositivo remoto. La PDU de solicitud especifica la dirección de registro inicial y el número de registros. En la PDU los
registros se direccionan empezando por cero. Por lo tanto, los registros numerados del 1 al 16 se direccionan como 0-
15.
Los datos del registro en el mensaje de respuesta se empaquetan en dos bytes por registro, con el contenido binario
justificado a la derecha dentro de cada byte. Para cada registro, el primer byte contiene los bits de orden alto y el
segundo contiene los bits de orden bajo.
Request
Response
*N = Cantidad de registros
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 8/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Solicitud Respuesta
Función 03 Función 03
Dirección de 00 Recuento de 06
salida Hi bytes
Este código de función se utiliza para leer de 1 a 125 registros de entrada contiguos en un dispositivo remoto. La PDU
de solicitud especifica la dirección de registro inicial y el número de registros. En la PDU los registros se direccionan
empezando por cero. Por lo tanto, los registros de entrada numerados del 1 al 16 se direccionan como 0-15.
Los datos del registro en el mensaje de respuesta se empaquetan en dos bytes por registro, con el contenido binario
justificado a la derecha dentro de cada byte. Para cada registro, el primer byte contiene los bits de orden alto y el
segundo contiene los bits de orden bajo.
Solicitud
Respuesta
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 9/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Solicitud Respuesta
Función 04 Función 04
Dirección de 00 Recuento de 02
salida Hi bytes
Cantidad de 01
registros de
entrada Lo
Este código de función se utiliza para escribir una única salida en ON u OFF en un dispositivo remoto.
El estado ON/OFF solicitado se especifica mediante una constante en el campo de datos de solicitud. Un valor de FF00
hex. solicita que la salida esté en ON. Un valor de 00 00 solicita que esté en OFF. Todos los demás valores son ilegales y
no afectan a la salida.
La PDU de petición especifica la dirección de la bobina que se va a forzar. Las bobinas se direccionan empezando por el
cero. Por lo tanto, la bobina número 1 se direcciona como 0. El estado ON/OFF solicitado se especifica mediante una
constante en el campo Valor de la bobina. Un valor de 0XFF00 solicita que la bobina esté en ON. Un valor de 0X0000
solicita que la bobina esté apagada. Todos los demás valores son ilegales y no afectan a la bobina.
La respuesta normal es un eco de la petición, que se devuelve después de escribir el estado de la bobina.
Solicitud
Respuesta
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 10/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Solicitud Respuesta
Función 05 Función 05
Este código de función se utiliza para escribir un único registro de retención en un dispositivo remoto.
La PDU de solicitud especifica la dirección del registro que se va a escribir. Los registros se direccionan empezando por
cero. Por lo tanto, el registro número 1 se direcciona como 0.
La respuesta normal es un eco de la solicitud, que se devuelve después de que se haya escrito el contenido del registro.
Solicitud
Respuesta
Código de función 1 byte 0x06
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 11/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Solicitud Respuesta
Función 06 Función 06
Este código de función se utiliza para forzar cada bobina de una secuencia de bobinas a ON u OFF en un dispositivo
remoto. La PDU de solicitud especifica las referencias de las bobinas que deben forzarse. Las bobinas se direccionan
empezando por el cero. Por lo tanto, la bobina número 1 se direcciona como 0.
Los estados ON/OFF solicitados se especifican mediante el contenido del campo de datos de solicitud. Un '1' lógico en
una posición de bit del campo solicita que la salida correspondiente esté en ON. Un '0' lógico solicita que esté en OFF.
La respuesta normal devuelve el código de función, la dirección de inicio y la cantidad de bobinas forzadas.
Solicitud
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 12/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Respuesta
Solicitud Respuesta
Función 0F Función 0F
Recuento de bytes 02
Los valores escritos solicitados se especifican en el campo de datos de solicitud. Los datos se empaquetan en dos bytes
por registro.
La respuesta normal devuelve el código de función, la dirección inicial y la cantidad de registros escritos.
Solicitud
Código de función 1 byte 0x10
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 13/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
*N = Cantidad de registros
Respuesta
Ejemplo de una solicitud para escribir dos registros que comienzan en 2 a 00 0A y 01 02 hex:
Solicitud Respuesta
Función 10 Función 10
Dirección de 00 Dirección de 00
salida Hi salida Hi
Dirección de 01 Dirección de 01
salida Lo salida Lo
Cantidad de 00 Cantidad de 00
registros Hi salidas Hi
Cantidad de 02 Cantidad de 02
registros Lo salidas Lo
Recuento de 04
bytes
Valor de los 00
registros Hi
Valor de los 0A
registros Lo
Valor de los 01
registros Hi
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 14/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Valor de los 02
registros Lo
Ahora que ya sabemos un poco más sobre Modbus RTU y su formato de trama, vamos a terminar nuestro mensaje
Modbus del ejemplo que dimos al principio de esta entrada del post.
Queríamos que el maestro enviara un mensaje al esclavo número 2 solicitando el valor de 6 registros de entrada.
Nuestro mensaje Modbus RTU se ve así en este momento: 0204 (02 (Dirección del esclavo) + 04 (Código de función))
Como nuestro código de función es el número 04: Read Input Register, los datos deben contener: Dirección inicial Hi +
Dirección inicial Lo + Cantidad de Reg. de Entrada Hi + Cantidad de Reg. de Entrada Lo. Lo + CRC.
Por lo tanto, vamos a llenar la solicitud ADU para obtener todo el mensaje:
Solicitud ADU
Código de función 04
Dirección inicial Hi 00
Dirección inicial Lo 00
CRC -
CRC -
Para calcular el CRC, basta con escribir el mensaje Modbus 020400000006 en este sitio web . Selecciona el tipo de
entrada HEX y obtén el número CRC-16 (Modbus).
Como es LSB, lo invertiremos. Si el resultado del CRC es 0x3B70, ahora será: 703B.
020400000006703B
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 15/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
8- Software
Maestro Modbus RTU con Arduino IDE
El módulo maestro Modbus RTU implementa las capacidades del Modbus RTU Master. Vamos a trabajar con la función
modbusrtumaster.h:
RS-485
Maestro
ModbusRTUMaster (RS485);
RS-232
Maestro
ModbusRTUMaster (RS232);
Antes de usarlo, es necesario llamar a la función de inicio en la configuración tanto para la variable serial como para la
variable Modbus. Es una buena práctica establecer la velocidad de transmisión (valor predeterminado: 19200 bps)
también en la variable Modbus para definir los tiempos de espera internos de Modbus.
master.begin ( 9600 );
Las funciones para leer y escribir los valores de los esclavos son:
Donde:
address es la bobina, entrada digital, registro de retención o dirección de registro de entrada. Por lo general, esta
dirección es la bobina, la entrada digital, el registro de retención o el número de registro de entrada menos
1: el
número de registro de retención 40009 tiene la dirección 8 .
quantity es el número de bobinas, digitales, registros de retención o registros de entrada a leer/escribir.
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 16/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
value es el valor dado de la bobina o los registros de retención en una operación de escritura. Dependiendo de la
función, el tipo de datos cambia. Una bobina está representada por un valor bool y un registro de retención está
representado por un valor
uint16_t.
En una función de lectura/escritura múltiple, el argumento de address es la primera dirección. En una función de
escritura múltiple, el argumento values es una matriz de valores para escribir.
Es importante decir que estas funciones no son de bloqueo, por lo que no devuelven el valor leído.
Devuelven true o false dependiendo del estado actual del módulo. Si hay una petición Modbus pendiente,
devuelven false .
// Leer 5 registros de retención de la dirección 0x24 del esclavo con dirección 0x10
} else {
if (respuesta) {
// Procesar respuesta
hasError ();
getErrorCode ();
getSlave ();
getFC ();
isCoilSet (desplazamiento);
isDiscreteInputSet (desplazamiento);
isDiscreteSet (desplazamiento);
getRegister (desplazamiento);
if (respuesta) {
} else {
Fuente
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 17/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
COMPARTIR
NUESTROS BLOGS
ARCHIVAR
Leer siguiente
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 18/19
27/12/21 22:16 ✅ Librería Modbus RTU Master para automatización industrial
Nombre *
Apellido
País
* Afganistán
Teléfono
Email *
¡Cuéntame más!
https://www.industrialshields.com/es_ES/blog/blog-industrial-open-source-1/post/libreria-modbus-rtu-master-para-automatizacion-industrial-200 19/19