Function mbc_mask_write_reg

This function writes the bits of a specified HOLDING REGISTER to a modbus server via a support structure in pass-through mode.

Syntax

i32 mbc_mask_write_reg_s (i32 mbc, stru_modbus stru, i32 bitMsk, i32 bitVal)

mbc

Handle value returned by mbc_init()

stru

Structure of type stru_modbus containing the parameters

bitMsk

Mask of the bits that have to be written.

Note: The mask must have the affected bits in 1 (R3-style, as opposed to what modbus wants instead).

result = (result r_and r_not bitMsk) r_or (bitVal r_and bitMsk)

bitVal

Mask containing the state of the affected bits

Result

Returns:

Value	Meaning
1 [MBC_WAIT]	Command waiting for response
0 [MBC_OK]	Command executed
-1 [MBC_INVAL]	Invalid arguments
-2 [MBC_BUSY]	Resource occupied
-3 [MBC_PERM]	Permission denied
-4 [MBC_CONN]	Connection failed
-5 [MBC_NOBUFS]	Buffer exhausted
-6 [MBC_NOMEM]	Insufficient memory
-7 [MBC_TX_ERR]	Transmission error
-8 [MBC_RX_ERR]	Receive error
-9 [MBC_TIMEOUT]	Blocking command timeout
-10 [MBC_EXC_CODE_1]	Response with exception 1 (function code not supported by server)
-11 [MBC_EXC_CODE_2]	Response with exception 2 (invalid address)
-12 [MBC_EXC_CODE_3]	Response with exception 3 (invalid quantity or value)
-13 [MBC_EXC_CODE_4]	Response with exception 4 (operation failed)
-14 [MBC_WRONG_ANSWER]	Invalid response
-15 [MBC_INVAL_MBC]	Invalid mbc id

Validity

Task

Note

The function is pass-through. As long as it returns MBC_WAIT, it must be continuously called within the task

Please enable JavaScript to view this site.