1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
# modbus_write_bits
## Name
modbus_write_bits - write many bits
## Synopsis
```c
int modbus_write_bits(modbus_t *ctx, int addr, int nb, const uint8_t *src);
```
## Description
The *modbus_write_bits()* function shall write the status of the `nb` bits
(coils) from `src` at the address `addr` of the remote device. The
`src` array must contains bytes set to `TRUE` or `FALSE`.
The function uses the Modbus function code 0x0F (force multiple coils).
## Return value
The function shall return the number of written bits if successful. Otherwise it
shall return -1 and set errno.
## Errors
- *EMBMDATA*, writing too many bits.
## See also
- [modbus_read_bits](modbus_read_bits.md)
- [modbus_write_bit](modbus_write_bit.md)
|
