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

AR_STATISTIC_ITERATE

Type	Function block
Description	The function block provides the AR (Application Relation) statistics for all devices. It indicates whether changed statistic values are available and successively outputs the values for every single device. The output of the statistic values is triggered with a rising edge at the REQ input. Setting the RESET input to TRUE while the REQ input is false at the same time, resets all total counters of the Profinet statistics.
Notes	The statistic values in the Profinet stack are read every 1 second. This means also the extended statistics are updated every 1 second. The outputs MISSED_FRAMES_GLOBAL and CHANGED_VALUE are "live"outputs. They do not have to be triggered separately with a rising edge at the REQ input. The values are updated every 1 second (see item above). Both values are global values that apply to all devices. 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 must not be set to TRUE at the same time. If both inputs are set simultaneously, the functionality of the FB is not guaranteed. A reset of the Profinet statistics with RESET = TRUE is only executed when the REQ input is FALSE at the same time. 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. 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 successively the devices and their AR statistics which have been changed. Note The REQ and RESET inputs must not be set to TRUE at the same time. If both inputs are set simultaneously, the functionality of the FB is not guaranteed. RESET Data type: BOOL Description: With RESET = TRUE and REQ = FALSE at the same time all total counters of the Profinet statistics are reset. For every single device the MISSED_FRAMES_GLOBAL, MISSED_FRAMES_TOTAL and CONECTION_COUNT values are reset. Note The RESET and REQ inputs must not be set to TRUE at the same time. If both inputs are set simultaneously, the functionality of the FB is not guaranteed. Note The MISSED_FRAMES_ACTUAL value is not reset. Outputs MISSED_FRAMES_GLOBAL Data type: UDINT Description: Indicates the total number of lost frames for all devices. The value is a "live" value, i.e., the value is indicated regardless of whether the function block is executed with a rising edge at the REQ input. CHANGED_VALUE Data type: BOOL Description: Indicates whether modified statistic values are available. The value is a "live" value, i.e., the value is indicated regardless of whether the function block is executed with a rising edge at the REQ input. The output is set to TRUE if the number of lost frames has changed for any device and this change has not yet been output by a function block. DONE Data type: BOOL Description: Set to TRUE as soon as the function block operates error-free and there are valid values available at the outputs; 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. STAT_NAME Data type: STRING Description: Returns the station name of the currently indicated device. 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).