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

AR_STATISTIC_SINGLE

Type	Function block
Description	The function block provides the AR (Application Relation) statistic for a specific Profinet device. The Profinet device for which the AR statistic is to be read is specified at the STAT_NAME input. The output of the statistic values for the Profinet device specified at the STAT_NAME input is triggered with a rising edge at the REQ input.
Notes	The stack internal counter for lost frames cannot be reset. This counter stops as soon as it has reached its maximum value after the last connection establishment. Due to this, also the counter that counts the number of lost frames over the total running time of the device stops, even if the counter has been reset before. The counting can be continued only after a new connection establishment of the device. The REQ and RESET inputs within one function block cannot be set to TRUE simultaneously. These signals are locked against each other. If the REQ input of AR_STATISTIC_SINGLE function blocks is permanently set to TRUE, it is not guaranteed that changed values are indicated at the CHANGED_VALUE outputs of the AR_STATISTIC_ITERATE function blocks. 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.
Parameters	Inputs REQ Data type: BOOL Description: With REQ = TRUE the function block starts outputting the AR statistics for the Profinet device specified at the STAT_NAME input. The value of the STAT_NAME input is applied with every rising edge at the REQ input. The statistic values are permanently output. STAT_NAME Data type: STRING Description: Station name of the device for which the statistic values are to be output. The value is applied with every rising edge at the REQ input. Outputs DONE Data type: BOOL Description: Set to TRUE as soon as the function block operates error-free and the station name specified at the STAT_NAME input is available; otherwise FALSE. BUSY Data type: BOOL Description: If REQ is set to TRUE, the BUSY output indicates whether the function block is currently being executed and waits for the execution of the firmware service (Remote Service Call (RSC) service). TRUE: Function block is currently being executed and waits for a response of the firmware. FALSE: Function block has been executed. The result is indicated at the DONE and ERROR outputs. ERROR Data type: BOOL Description: FALSE: No error occurred when executing the function block. TRUE: Error occurred when executing the function block. The error code is indicated at the STATUS output. STATUS Data type: DWORD Description: In the event of an error (ERROR = TRUE), the error code is output. See below for a description of the error codes. MISSED_FRAMES_TOTAL Data type: UDINT Description: Number of all lost frames of a device since the controller was last started or since the last reset of the counters. MISSED_FRAMES_ACTUAL Data type: UDINT Description: Number of all lost frames of a device since the last connection establishment. Note The MISSED_FRAMES_ACTUAL value cannot be reset. CONNECTION_COUNT Data type: UDINT Description: Number of connection establishments to a device since the controller was last started or since the last reset of the counters.
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).