Device Communication

Set up IO Link Port

There are several ways to configure an IO-Link port. The simplest way is to use the AUTOCOM mode. In this mode the Master accepts all Devices and sets its internal parameters according to the Device's requirements. Start up in AUTOCOM mode is done as follows:

IOLM_SPortConfig suPortCfg;
 
// Prepare struct
IOL_Port_vMemSet(&suPortCfg, 0, sizeof(IOLM_SPortConfig));
 
// Set desired target mode
suPortCfg.eTargetMode = IOL_eTargetMode_AUTOCOM;
 
// Send the configured struct to the System Management layer
IOLM_API_SM_eSetPortConfig(0, &suPortCfg);

Another way is to set up a specific Device by Vendor and Device ID. During the startup procedure it is checked if the correct Device is connected or if the Device is compatible. If this check fails, it is indicated by the port mode IOL_ePortMode_COMP_FAULT

IOLM_SPortConfig suPortCfg;
 
// Prepare port configuration struct
IOL_Port_vMemSet(&suPortCfg, 0, sizeof(IOLM_SPortConfig));
 
// Set desired target mode and inspection level
suPortCfg.eTargetMode = IOL_eTargetMode_CFGCOM;
suPortCfg.eInspectionLevel = IOL_eInspectionLevel_TYPE_COMP;
 
// Set specific Vendor and Deviec ID
suPortCfg.au8ConfiguredVendorID[0] = 0x12;
suPortCfg.au8ConfiguredVendorID[1] = 0x34;
suPortCfg.au8ConfiguredDeviceID[0] = 0x12;
suPortCfg.au8ConfiguredDeviceID[1] = 0x34;
suPortCfg.au8ConfiguredDeviceID[2] = 0x54;
 
// Send the configured struct to the System Management layer
IOLM_API_SM_eSetPortConfig(0, &suPortCfg);

The most complex way is to check if the Serial Number is also correct. This is also the safest way to check, whether the connected Device is the exact one which is expected on the specific port. If the check fails, it is indicated by the port mode IOL_ePortMode_SERNUM_FAULT

IOLM_SPortConfig suPortCfg;
char au8Serial[] = "SER12345"
 
// Prepare port configuration struct
IOL_Port_vMemSet(&suPortCfg, 0, sizeof(IOLM_SPortConfig));
 
// Set desired target mode and inspection level
suPortCfg.eTargetMode = IOL_eTargetMode_CFGCOM;
suPortCfg.eInspectionLevel = IOL_eInspectionLevel_IDENTICAL;
 
// Set specific Vendor and Deviec ID
suPortCfg.au8ConfiguredVendorID[0] = 0x12;
suPortCfg.au8ConfiguredVendorID[1] = 0x34;
suPortCfg.au8ConfiguredDeviceID[0] = 0x12;
suPortCfg.au8ConfiguredDeviceID[1] = 0x34;
suPortCfg.au8ConfiguredDeviceID[2] = 0x54;
 
// Set specific Serial Number
IOL_Port_vMemCpy(suPortCfg.au8ConfiguredSerialNumber, au8Serial, sizeof(au8Serial));
suPortCfg.u8ConfiguredSerialNumberLen = sizeof(au8Serial);
 
// Send the configured struct to the System Management layer
IOLM_API_SM_eSetPortConfig(0, &suPortCfg);

Stop Communication / Disable Port

The communication can be stopped by setting the port to the inactive state:

IOLM_SPortConfig suPortCfg;
 
// Prepare port configuration struct
IOL_Port_vMemSet(&suPortCfg, 0, sizeof(IOLM_SPortConfig));
 
// Set desired target mode
suPortCfg.eTargetMode = IOL_eTargetMode_INACTIVE;
 
// Send the configured struct to the System Management layer
IOLM_API_SM_eSetPortConfig(0, &suPortCfg);

Standard Input and Output (SIO) Mode

The Port is set to SIO mode by the following command:

IOLM_SPortConfig suPortCfg;
INT8U u8State;
 
// Prepare port configuration struct
IOL_Port_vMemSet(&suPortCfg, 0, sizeof(IOLM_SPortConfig));
 
// Set desired target mode
suPortCfg.eTargetMode = IOL_eTargetMode_DI;     // For intput mode (IOL_eTargetMode_DO for output mode)
 
// Send the configured struct to the System Management layer
IOLM_API_SM_eSetPortConfig(0, &suPortCfg);

Process Data

After each establishment of a communication relation, the Process Data is marked invalid. The application layer has to set the data valid again by IOLM_API_AL_eControlReq.

This can be done via the IOL_ePortMode_SM_OPERATE event in the function IOLM_Port_SM_vPortMode.