7.6.4.2 UpdateConfiguration

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
CycleTimeMaps to CycleTime Variable defined in Table 38.
ValidationAndBackupMaps to ValidationAndBackup Variable defined in Table 38. Only the numeric values defined for the Variable are allowed.
PortModeMaps to PortMode Variable defined in Table 38. Only the numeric values defined for the Variable are allowed.
Pin2ConfigurationMaps to Pin2Configuration Variable defined in Table 38. Only the numeric values defined for the Variable are allowed.
UseIODDMaps to UseIODD Variable defined in Table 38.
DeviceIDMaps to DeviceID Variable defined in Table 38.
VendorIDMaps 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