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