NAME

       modbus_rtu_set_rts - set the RTS mode in RTU

SYNOPSIS

       int modbus_rtu_set_rts(modbus_t *ctx, int mode)

DESCRIPTION

       The modbus_rtu_set_rts() function shall set the Request To Send mode to communicate on a
       RS485 serial bus. By default, the mode is set to MODBUS_RTU_RTS_NONE and no signal is
       issued before writing data on the wire.

       To enable the RTS mode, the values MODBUS_RTU_RTS_UP or MODBUS_RTU_RTS_DOWN must be used,
       these modes enable the RTS mode and set the polarity at the same time. When
       MODBUS_RTU_RTS_UP is used, an ioctl call is made with RTS flag enabled then data is
       written on the bus after a delay of 1 ms, then another ioctl call is made with the RTS
       flag disabled and again a delay of 1 ms occurs. The MODBUS_RTU_RTS_DOWN mode applies the
       same procedure but with an inverted RTS flag.

       This function can only be used with a context using a RTU backend.

RETURN VALUE

       The function shall return 0 if successful. Otherwise it shall return -1 and set errno to
       one of the values defined below.

ERRORS

       EINVAL
           The libmodbus backend isn’t RTU or the mode given in argument is invalid.

EXAMPLE

       Enable the RTS mode with positive polarity.

           modbus_t *ctx;
           uint16_t tab_reg[10];

           ctx = modbus_new_rtu("/dev/ttyS0", 115200, 'N', 8, 1);
           modbus_set_slave(ctx, 1);
           modbus_rtu_set_serial_mode(ctx, MODBUS_RTU_RS485);
           modbus_rtu_set_rts(ctx, MODBUS_RTU_RTS_UP);

           if (modbus_connect(ctx) == -1) {
               fprintf(stderr, "Connexion failed: %s\n", modbus_strerror(errno));
               modbus_free(ctx);
               return -1;
           }

           rc = modbus_read_registers(ctx, 0, 7, tab_reg);
           if (rc == -1) {
               fprintf(stderr, "%s\n", modbus_strerror(errno));
               return -1;
           }

           modbus_close(ctx);
           modbus_free(ctx);

SEE ALSO

       modbus_rtu_get_rts(3)

AUTHORS

       The libmodbus documentation was written by Stéphane Raimbault
       <stephane.raimbault@gmail.com>