• Home
• Function/Function Block Reference
• PLCnext Controller Function Blocks
• Profinet
• ADDRESS_TO_ID

ADDRESS_TO_ID

Type	Function block
Description	The function block is used to convert the information on an Application Relation (AR) defined in the Profinet address structure ADDR into a unique ID. The block is executed by REQ = TRUE. The Profinet address ADDR addresses a Profinet AR. It is a structure with defined arrangement of the individual elements of the structure. If an error occurs during execution of the function block, ERROR is set to TRUE. The STATUS output indicates the error code.
Notes	Valid output parameters will be first available when the ID output is unequal to 0. This also applies for changed input parameters. The process can last possibly several program cycles. Function blocks of this type have to be instantiated. The instance name of the function block has to be declared in the 'Variables' table of the POU where the FB is going to be used. The instance name must be unique within the POU. The maximum allowed number of these function block instances activated at the same time is limited by the maximum number of ARs for the controller.
Parameters	Input REQ Data type: BOOL Description: With REQ = TRUE the function block is executed and the outputs will then be updated. After successful execution of the function block, REQ must be set to FALSE to execute the function block again. The outputs will be reset by a falling edge at REQ. Input/Output ADDR Data type: ANY Description: Profinet address structure. Parameter Data type Description SYSTEM BYTE Type of the IO subsystem (2 for Profinet IO, the value 1 is not allowed) VERSION BYTE Version of the data structure (Version 1 = 1) D STRUCT Profinet IO device identification      STATIONNAME STRING(255) Station name      INSTANCE WORD Instance ID      DEVICE WORD Device identification      VENDOR WORD Vendor ID 1 END_STRUCT 1 API DWORD Identification of the application profile (0 = no profile) SLOT WORD Slot SUBSLOT WORD Subslot Outputs DONE Data type: BOOL Description: Indicates whether the function block has been successfully executed. TRUE: Function block was executed without errors. The new value is available at the ID output. FALSE: An error occurred during execution of the function block. The STATUS output indicates the error code. BUSY Data type: BOOL Description: Indicates whether the function block is currently executed. The output remains TRUE as long as the function block is executed. ERROR Data type: BOOL Description: Indicates whether an error occurred when executing the function block. FALSE: No error occurred. TRUE: Error occurred. The STATUS output indicates the error code. STATUS Data type: DWORD Description: Internal status of the function block. Only valid for ERROR = TRUE. See below for a description of the possible error codes. ID Data type: DWORD Description: Unique ID used for addressing, calculated from the defined address structure ADDR. Only valid for DONE = TRUE.
Error codes	Error codes at the STATUS output Error code (hex) Meaning 0x0000 No error occurred. 0xF001 Too many instances used. 0xF002 Error during initialization of the function block. 0xF003 Invalid ID. 0xF004 Invalid HANDLE/ID. 0xF005 Resources conflict. 0xF006 A function block internal task could not be generated. 0xF007 Too many instances used. 0xF008 Invalid type of a parameter. 0xF009 Invalid parameter value. 0xF00A Unallowed parameter. 0xF00B Invalid length specified. 0xF00C ID could not be created (too many IDs). 0xF00D No entry found that matches the specified ID. 0xF00F No further entries found. 0xF010 Entry in use. 0xF011 Alarm acknowledgement could not be done. 0xF012 Error reading the AR parameters (1st time). 0xF013 Negative acknowledgement received for the execution of a Profinet service. 0xF014 Invalid length for parameter LEN/MLEN or/and data record in RECORD input/output too short. 0xF015 The service used to read the data record from the RECORD input/output could not be run. 0xF016 The service used to write the data record from the RECORD input/output could not be run. 0xF017 Service acknowledgement not received. 0xF018 Invalid INDEX used to access the data record in the RECORD input/output of the Profinet IO device, for example, INDEX greater than 0x7FFF. 0xF019 Unknown command code. 0xF01A Error when starting the Application Relation (AR). 0xF01B Error when stopping the Application Relation (AR). 0xF01C Notification of stopped Application Relation (AR) failed. 0xF01D Setting the "Drive BF" flag failed. 0xF01E Error reading the AR parameters (2nd time).