Home
4 PIC18 Diagnostic Test APIs
4.15 File List
Here is a list of all documented files with brief descriptions
4.15.25 diag_intr_freq.h File Reference
This file contains API prototypes for Interrupt frequency test.

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.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.15.1 diag_clock_sosc_freq.c File Reference
    This file contains the APIs to perform the Clock Test using a secondary oscillator crystal as reference.
  - 4.15.2 diag_clock_sosc_freq.h File Reference
    This file contains all the variable definitions and the prototypes for the APIs used in performing the Clock Test using a secondary oscillator crystal as reference.
  - 4.15.3 diag_clockline_freq.c File Reference
    This file contains the APIs to perform the Clock Line frequency test.
  - 4.15.4 diag_clockline_freq.h File Reference
    This file contains all the variable defintions and the prototypes for the APIs used in performing the Clock Line frequency test.
  - 4.15.5 diag_config.h File Reference
  - 4.15.6 diag_cpu_registers.c File Reference
    This file contains APIs to test CPU Registers.
  - 4.15.7 diag_cpu_registers.h File Reference
    This file contains prototypes for APIs to test CPU Registers.
  - 4.15.8 diag_cpu_registers_reset_state_check.c File Reference
    This file contains API to diagnose CPU register reset state.
  - 4.15.9 diag_cpu_registers_reset_state_check.h File Reference
    This file contains prototypes for APIs to diagnose CPU register reset state.
  - 4.15.10 diag_crc16_lookup_table.h File Reference
    This file contains Look-up table for 16-bit CCITT CRC algorithm.
  - 4.15.11 diag_crc32_lookup_table.h File Reference
    This file contains Look-up table for 32-bit CRC algorithm.
  - 4.15.12 diag_eeprom_crc16.h File Reference
    This file contains prototypes for APIs to calculate, store and validate 16-bit CCITT CRC for a given EEPROM region.
  - 4.15.13 diag_eeprom_crc16_direct.c File Reference
    This file contains APIs to test EEPROM using CRC16 CCITT Direct Computation algorithm.
  - 4.15.14 diag_eeprom_crc16_lookup.c File Reference
    This file contains APIs to test EEPROM using CRC16 CCITT Look-up Table algorithm.
  - 4.15.15 diag_eeprom_crc32.h File Reference
    This file contains prototypes for APIs to calculate, store and validate 32-bit CRC for a given EEPROM region.
  - 4.15.16 diag_eeprom_crc32_direct.c File Reference
    This file contains APIs to test EEPROM using CRC32 Direct Computation algorithm.
  - 4.15.17 diag_eeprom_crc32_lookup.c File Reference
    This file contains APIs to test EEPROM using CRC32 Look-up Table algorithm.
  - 4.15.18 diag_flash_crc16.h File Reference
    This file contains prototypes for APIs to calculate, store and validate 16-bit CCITT CRC for a given FLASH region.
  - 4.15.19 diag_flash_crc16_direct.c File Reference
    This file contains APIs to test FLASH using CRC16 CCITT Direct Computation algorithm.
  - 4.15.20 diag_flash_crc16_lookup.c File Reference
    This file contains APIs to test FLASH using CRC16 CCITT Look-up Table algorithm.
  - 4.15.21 diag_flash_crc32.h File Reference
    This file contains prototypes for APIs to calculate, store and validate 32-bit CRC for a given FLASH region.
  - 4.15.22 diag_flash_crc32_direct.c File Reference
    This file contains APIs to test FLASH using CRC32 Direct Computation algorithm.
  - 4.15.23 diag_flash_crc32_lookup.c File Reference
    This file contains APIs to test FLASH using CRC32 Look-up Table algorithm.
  - 4.15.24 diag_intr_freq.c File Reference
    This file contains the API to perform Interrupt Frequency test.
  - 4.15.25 diag_intr_freq.h File Reference
    This file contains API prototypes for Interrupt frequency test.
  - 4.15.26 diag_memory_types.h File Reference
    This file contains common type definitions for EEPROM and FLASH module.
  - 4.15.27 diag_sram_march_types.h File Reference
    This file contains common macros and return types for SRAM diagnostics module.
  - 4.15.28 diag_sram_marchb.c File Reference
    This file contains the API to test SRAM using March B algorithm.
  - 4.15.29 diag_sram_marchb.h File Reference
    This file contains API prototypes for SRAM March-B test.
  - 4.15.30 diag_sram_marchc.c File Reference
    This file contains APIs to test SRAM using March C algorithm.
  - 4.15.31 diag_sram_marchc.h File Reference
    This file contains API prototypes for SRAM March-C test.
  - 4.15.32 diag_sram_marchc_minus.c File Reference
    This file contains APIs to test SRAM using March C- algorithm.
  - 4.15.33 diag_sram_marchc_minus.h File Reference
    This file contains API prototypes for SRAM March-C Minus test.
  - 4.15.34 diag_wdt_simple_timer.c File Reference
    This file contains APIs to test WDT in Simple-Timer Mode using Indirect Time-Slot Monitoring method.
  - 4.15.35 diag_wdt_simple_timer.h File Reference
    This file contains API prototypes for Indirect Time-Slot Monitoring based WDT Test (Simple-Timer Mode)
  - 4.15.36 diag_wdt_windowed_timer.c File Reference
    This file contains APIs to test WDT in Windowed-Timer Mode using Indirect Time-Slot Monitoring method.
  - 4.15.37 diag_wdt_windowed_timer.h File Reference
    This file contains API prototypes for Indirect Time-Slot Monitoring based WDT Test (Windowed-Timer Mode)
- 4.16 Class List
  Here is a list of all documented files with brief descriptions

4.15.25 diag_intr_freq.h File Reference

This file contains API prototypes for Interrupt frequency test.

Includes

xc.h
stdint.h
stdbool.h
../../diag_common/config/diag_config.h

Enums

This enumeration 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.

This enumeration holds the status of interrupt monitoring.

diag_interrupt_mon_status_t
DIAG_INTR_ON: 0 - Interrupt is registered and being monitored
DIAG_INTR_OFF: 1 - Interrupt is registered but not being monitored

diag_interrupt_test_status_t
DIAG_INTR_PASS: 0 - Interrupt test is passed
DIAG_INTR_FAIL: 1 - Interrupt test is failed
DIAG_INTR_INVALID: 2 - Interrupt test is invalid

Functions

Table 4-51. boolDIAG_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

Table 4-52. voidDIAG_INTERRUPT_Initialize (void)

Parameters


	void

Returns


void	None

Table 4-53. voidDIAG_INTERRUPT_UpdateInterruptCounter (diag_interrupt_id_t interruptModule)

Parameters


[in] id	- ID for the interrupt to be updated

Returns


void	None

Table 4-54. diag_interrupt_test_status_tDIAG_INTERRUPT_GetResult (diag_interrupt_id_t id)

Parameters


id	diag_interrupt_id_t

Returns


diag_interrupt_test_status_t	DIAG_INTR_PASS - Success, DIAG_INTR_FAIL - Failure, DIAG_INTR_INVALID - Indeterminate

Table 4-55. boolDIAG_INTERRUPT_Unregister (diag_interrupt_id_t id)

Parameters


[in] id	diag_interrupt_id_t - ID for the interrupt to be unregistered

Returns


bool	bool