Configure's a Sealevel I/O module's software selectable Modbus slave ID (Modbus devices only).
- Parameters
-
[in] | handle | Valid handle returned by SM_Open(). |
[in] | slaveID | Desired slave ID of the Modbus compliant Sealevel I/O module. |
- Return values
-
0 | Successful completion. |
-1 | Invalid SeaMAX handle. |
-2 | Connection is not established. Check the provided Connection object state. |
-3 | Error writing to Modbus device. |
-4 | Failed to perform implicit 'Get Module Configuration (0x45) |
This method attempts to set the software selectable address (slave ID) of a Sealevel I/O module, whose side rotary switch is set to the '0' position. By default, setting the side switch to zero will result in a Modbus slave ID address of 247.
The 'Set Software Slave ID' Modbus function requires a security key byte, received by performing a 'Get Module Configuration (0x45)'. If the security key has not previously been explicitly requested , the SetSoftwareAddress() method will automatically perform the 'Get Module Configuration' function prior to executing the 'Set Software Slave ID'
- Note
- If the side rotary switch is not in the zero position, this Modbus function will fail.
Referenced by CSeaMaxW32::Ioctl().