Error Handler Callbacks Example

Contains API prototypes for Error Handler callback examples. More...

Files
file	error_handler_callbacks_example.c
	Implements APIs for Error Handler Callbacks.
file	error_handler_callbacks_example.h
	Contains API prototypes for Error Handler callback examples.

Functions
void	EH_NonCriticalErrorExampleCallback (errId_t id)
	Placeholder implementation of a NON_CRITICAL Error Handler callback function.
void	EH_NotificationErrorExampleCallback (errId_t id)
	Placeholder implementation of a NOTIFICATION Error Handler callback function.

Detailed Description

Contains API prototypes for Error Handler callback examples.

Copyright

© 2026 Microchip Technology Inc. and its subsidiaries.

Subject to your compliance with these terms, you may use Microchip software and any derivatives exclusively with Microchip products. It is your responsibility to comply with third party license terms applicable to your use of third party software (including open source software) that may accompany Microchip software.

THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY, THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE.

Function Documentation

EH_NonCriticalErrorExampleCallback()

void EH_NonCriticalErrorExampleCallback

(

errId_t

id

)

Placeholder implementation of a NON_CRITICAL Error Handler callback function.

Note

The example implementation is intentionally left empty, as the appropriate handling is highly application specific and would require initialization of peripherals such as USART or a debug print interface before use.

This callback can be called by the Error Handler when a NON_CRITICAL error is reported for application-specific error handling. Possible uses include:

• Adding a debug breakpoint and watching the stored Error ID variable during development
• Sending the Error ID over a communication interface (e.g., USART, SPI, TWI)
• Storing the Error ID to non-volatile memory (e.g., EEPROM) for later analysis
• Triggering application-specific recovery or logging behavior
• Initiating a software reset after the error is handled

Warning

An application-specific error handling callback should be implemented for proper error handling.

Warning

Ensure that any hardware or software resources required by this callback for error recovery or diagnostics are fully initialized before this callback is invoked the first time. Refer to TM_Startup for startup sequencing details.

Parameters

id	Error ID indicating the cause of the NON_CRITICAL error.

EH_NotificationErrorExampleCallback()

void EH_NotificationErrorExampleCallback

(

errId_t

id

)

Placeholder implementation of a NOTIFICATION Error Handler callback function.

Note

The example implementation is intentionally left empty, as the appropriate handling is highly application specific and would require initialization of peripherals such as USART or a debug print interface before use.

This callback can be called by the Error Handler during processing of the notification error log for application-specific handling of NOTIFICATION errors. Possible uses include:

• Adding a debug breakpoint and watching the stored Error ID variable during development
• Sending the Error ID over a communication interface (e.g., USART, SPI, TWI)
• Storing the Error ID to non-volatile memory (e.g., EEPROM) for later analysis
• Triggering application-specific recovery or logging behavior
• Attempting to fix an error and initiating a software reset if unsuccessful

Warning

An application-specific error handling callback should be implemented for proper error handling.

Warning

Ensure that any hardware or software resources required by this callback for error recovery or diagnostics are fully initialized before this callback is invoked the first time. Refer to TM_Startup for startup sequencing details.

Parameters

id	Error ID indicating the cause of the NOTIFICATION error.