The Method UpdateConfiguration takes all configuration data as input and updates the configuration of the port. The Method execution ensures that a client provides all configuration data at the same time in a consistent way and thus the server can deploy the configuration in one operation. If the configuration is not valid, the server returns a corresponding Status. As defined in the SMI (see IO-Link Addendum) depending on the configuration some arguments are treated as “don’t care”. For example, when the PortMode is IOL_AUTOSTART, the DeviceID, VendorID and ValidationAndBackup are ignored. The server shall not check those arguments and accept configurations with all possible values.
Signature
UpdateConfiguration (
(
[in]Duration CycleTime,
[in]Byte ValidationAndBackup,
[in]Byte PortMode,
[in]Byte Pin2Configuration,
[in]Boolean UseIODD,
[in]UInt32 DeviceID,
[in]UInt16 VendorID,
[out]Int32 Status
);
Argument |
Description |
CycleTime |
Maps to CycleTime Variable defined in Table 38. |
ValidationAndBackup |
Maps to ValidationAndBackup Variable defined in Table 38. Only the numeric values defined for the Variable are allowed. |
PortMode |
Maps to PortMode Variable defined in Table 38. Only the numeric values defined for the Variable are allowed. |
Pin2Configuration |
Maps to Pin2Configuration Variable defined in Table 38. Only the numeric values defined for the Variable are allowed. |
UseIODD |
Maps to UseIODD Variable defined in Table 38. |
DeviceID |
Maps to DeviceID Variable defined in Table 38. |
VendorID |
Maps to VendorID Variable defined in Table 38. |
Status |
Returns the status of the operation. 0: OK, operation successful -1: Operation already running -2: Operation cannot be executed -3: Invalid configuration |