Home
4 PIC18 Diagnostic Test APIs
4.9 SW_INTERRUPT_FREQUENCY_TEST_01
This module contains functional safety diagnostics API for Interrupt Frequency Test.
4.9.1 Structs
4.9.1.1 diag_interrupt_params_t Struct
This is the interrupt model structure that is used in the DIAG_INTERRUPT_Frequency. For each Interrupt source that is to be monitored for the interrupt frequency test, the structure is updated with the information as described for each and every member of this structure.

Introduction
This document contains API documentation for the diagnostic tests included in the MPLAB® Code Configurator PIC16/18 ISO26262 Diagnostic Library.
1 Software Requirements: PIC16
2 Software Requirements: PIC18
3 PIC16 Diagnostic Test APIs
4 PIC18 Diagnostic Test APIs
- 4.1 SW_CPU_REGISTER_RESET_STATE_CHECK_01.
  This module contains functional safety diagnostics APIs for CPU Registers .
- 4.2 SW_CLOCK_PERIODIC_MONITOR_01
  This module contains APIs to calculate and validate the frequency of the CPU clock using a reference Secondary Oscillator Crystal. The Clock test implements the SW_CLOCK_PERIODIC_MONITOR_01 SW REQ. ID by using time-slot monitoring technique.. It verifies the reliability of the system. clock (i.e., the system clock should be neither too fast nor too slow)
- 4.3 SW_CLOCK_PERIODIC_MONITOR_02
  This module contains APIs to calculate, store and validate the frequency of the CPU clock using a reference line frequency.
- 4.4 SW_CPU_REGISTER_TEST_01
  This module contains functional safety diagnostics APIs for CPU Registers .
- 4.5 SW_EEPROM_MEMORY_CHECKSUM_CRC_TEST_01 - CRC16
  This module contains APIs to calculate, store and validate 16-bit CCITT CRC for a given EEPROM region. .
- 4.6 SW_EEPROM_MEMORY_CHECKSUM_CRC_TEST_01 - CRC32
  This module contains APIs to calculate, store and validate 32-bit CCITT CRC for a given EEPROM region.
- 4.7 SW_FLASH_MEMORY_CHECKSUM_CRC_TEST_01 - CRC16
  This module contains APIs to calculate, store and validate 16-bit CCITT CRC for a given FLASH region .
- 4.8 SW_FLASH_MEMORY_CHECKSUM_CRC_TEST_01 - CRC32
  This module contains APIs to calculate, store and validate 32-bit CCITT CRC for a given FLASH region. .
- 4.9 SW_INTERRUPT_FREQUENCY_TEST_01
  This module contains functional safety diagnostics API for Interrupt Frequency Test.
  - 4.9.1 Structs
    - 4.9.1.1 diag_interrupt_params_t Struct
      This is the interrupt model structure that is used in the DIAG_INTERRUPT_Frequency. For each Interrupt source that is to be monitored for the interrupt frequency test, the structure is updated with the information as described for each and every member of this structure.
  - 4.9.2 Enums
  - 4.9.3 Functions
- 4.10 SW_SRAM_MARCH_TEST_01 - MarchB
  This module contains functional safety diagnostics API for SRAM March-B. .
- 4.11 SW_SRAM_MARCH_TEST_01 - MarchC
  This module contains functional safety diagnostics APIs for SRAM March-C. .
- 4.12 SW_SRAM_MARCH_TEST_01 - MarchC_Minus
  This module contains functional safety diagnostics APIs for SRAM March-C Minus. .
- 4.13 SW_WATCHDOG_SIMPLE_TIMER_STARTUP_TEST_01
  This module contains functional safety diagnostics APIs for WatchDog Timer Test. .
- 4.14 SW_WATCHDOG_WINDOWED_TIMER_STARTUP_TEST_01
  This module contains functional safety diagnostics APIs for WatchDog Timer Test .
- 4.15 File List
  Here is a list of all documented files with brief descriptions
- 4.16 Class List
  Here is a list of all documented files with brief descriptions

4.9.1.1 diag_interrupt_params_t Struct

This is the interrupt model structure that is used in the DIAG_INTERRUPT_Frequency. For each Interrupt source that is to be monitored for the interrupt frequency test, the structure is updated with the information as described for each and every member of this structure.

Members

diag_interrupt_id_t intr_id: This is the unique module Interrupt identifier number, for every interrupt source as listed in diag_config.h
uint16_t intr_counter: This is the counter that gets incremented in the ISR of the respective monitored module for the interrupt occurrence. This holds the number of interrupt occurrences in the current monitor period
uint16_t intr_ref_counter: This is the expected number of interrupts that need to occur for the monitored module within a given monitoring period.
uint16_t intr_counter_tolerance: Limit for deviation in the counter. Every module is expected to provide precise number of interrupts in a given time interval. However, there is a tolerance band within which, the number of interrupts for the module is acceptable. This tolerance band is specified for every module monitored for interrupt frequency.
uint16_t intr_ftti_counter: There are two types of module interrupt behaviours that need to be monitored by the DIAG_InterruptTest; Periodic and Rare. If the interrupts occur once every FTTI tick then, the interrupt would qualify as periodic and if it occurs once every 1000 FTTI ticks, it would qualify as interrupts that need to be monitored rarely. This count gets decremented every time reference ISR is called. When this counter reaches zero, means its time to check the interrupt counter with given tolerance
uint16_t intr_ftti
diag_interrupt_test_status_t Enum intr_test_status: This indicates the status of interrupt monitoring.
diag_interrupt_mon_status_t Enum intr_mon_status: This indicates if interrupt is being monitored or is being ignored for monitoring. In case if there is a failure detected for any interrupt monitoring, diagnostics test will stop monitoring that interrupt anymore by setting this variable to DIAG_INTR_OFF