EtherCAT Programming Guide EtherCAT Master Configuration
March, 2017 5-15
5
5.12 _ECAT_Autoconfig_Save_NodeID_Alias
Syntax
U16 PASCAL _ECAT_Autoconfig_Save_NodeID_Alias (U16 CardNo)
Purpose
This is for saving the user-defined station alias to the module memory block. After executing this
API, EtherCAT communication will be disconnected automatically and reboot of all slave devices
is required.
Note:
1. This API is only applicable to Delta R1-EC series remote modules.
2. Please use API “_ECAT_Autoconfig_Set_NodeID_Alias” (section 5.10), to configure all of the
user-defined alias and save them to the devices. After then, users can get the new configuration by API
“_ECAT_Autoconfig_Get_NodeID_Alias” (section 5.11).
3. This API can only be executed after the EtherCAT Master has been started
( “_ECAT_Master_Open” in section 6.1) and before EtherCAT communication is initialized
( “_ECAT_Master_Initial” in section 6.2).
Parameter
Name Data type Property Description
CardNo U16 Number Card No.
Example
U16 Status;
U16 CardNo=0,NodeID=1;
U16 MapNodeID = 2;
U16 Cardnum=0;
Status = _ECAT_Master_Open (&Cardnum);
if (Cardnum>0)
{
Status = _ECAT_Master_Get_CardSeq (0, &CardNo);
// Reset EtherCAT communication
Status = _ECAT_Master_Reset(CardNo);
// Specified first node of slave device as station 2
Status = _ECAT_Autoconfig_Set_NodeID_Alias (CardNo, NodeID, MapNodeID);
// Save user-defined alias to all of the connected device, and then EtherCAT
communication will stop automatically.
Status = _ECAT_Autoconfig_Save_NodeID_Alias (CardNo);
// ………….waiting for reboot all of the device manually………….
bool module_reboot = false;
While(!module_reboot)
{
}