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.3 Functions
4.9.3.2 DIAG_INTERRUPT_Register
For the GUID-C5C2B5D2-5E10-488A-838D-88D4440871A9.html API to monitor the interrupt modules for frequency test, the modules are added to interrupt module structure using this API.

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.2 Enums
  - 4.9.3 Functions
    - 4.9.3.1 DIAG_INTERRUPT_Frequency
      Software Requirement Reference ID : SW_INTERRUPT_FREQUENCY_TEST_01.
    - 4.9.3.2 DIAG_INTERRUPT_Register
      For the GUID-C5C2B5D2-5E10-488A-838D-88D4440871A9.html API to monitor the interrupt modules for frequency test, the modules are added to interrupt module structure using this API.
    - 4.9.3.3 DIAG_INTERRUPT_Initialize
      For the interrupt frequency test, the module interrupts parameters are stored in an internal structure. This API initializes that structure.
    - 4.9.3.4 DIAG_INTERRUPT_UpdateInterruptCounter
      This API is called from the ISR from where the API updates the internally maintained interrupt module structure for the respective interrupt module, identified by the interrupt identifier.
    - 4.9.3.5 DIAG_INTERRUPT_GetResult
      This API is called to get the result of the respective interrupt module.
    - 4.9.3.6 DIAG_INTERRUPT_Unregister
      This API is used to unregister an interrupt being monitored for the interrupt frequency. The interrupt identifier of the module which needs to be removed from being monitored for interrupt frequency, is passed as an argument to the API.
- 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.3.2 DIAG_INTERRUPT_Register

For the DIAG_INTERRUPT_Frequency API to monitor the interrupt modules for frequency test, the modules are added to interrupt module structure using this API.

bool DIAG_INTERRUPT_Register(
    diag_interrupt_id_t id,    uint16_t refCount,    uint16_t tolerance,    uint16_t fttiCount
)

Parameters


[in] id	diag_interrupt_id_t - ID for interrupt to be monitored
[in] refCount	uint16_t - The expected number of interrupts within monitoring period
[in] tolerance	uint16_t - Limit for deviation in the counter
[in] fttiCount	uint16_t - Count which when reaches zero checks the interrupt frequency. If fttiCount is non-zero, that means the interrupt frequency check should be skipped for that instance and intr_counter should not be incremented

Returns


bool	bool