/**
 * TRAPS Generated Driver Header File 
 * 
 * @file      traps.h
 *            
 * @defgroup  trapsdriver Traps Driver
 *            
 * @brief     Traps driver with handler for all types of traps using dsPIC MCUs.           
 *
 * @skipline @version   PLIB Version 1.1.4
 *            
 * @skipline  Device : dsPIC33AK512MPS512
*/

/*
? [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. 
    You are responsible for complying with 3rd party license terms  
    applicable to your use of 3rd party software (including open source  
    software) that may accompany Microchip software. SOFTWARE IS ?AS IS.? 
    NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS 
    SOFTWARE, INCLUDING ANY IMPLIED WARRANTIES OF NON-INFRINGEMENT,  
    MERCHANTABILITY, OR 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 RELATED TO THE SOFTWARE WILL NOT 
    EXCEED AMOUNT OF FEES, IF ANY, YOU PAID DIRECTLY TO MICROCHIP FOR 
    THIS SOFTWARE.
*/

#ifndef TRAPS_H
#define TRAPS_H

// Section: Included Files
#include <stdint.h>

// Section: Data Type Definitions

/**
 @ingroup  trapsdriver
 @enum     TRAPS_ERROR_CODE
 @brief    Defines the TRAPS error codes
*/
enum TRAPS_ERROR_CODE 
{
// Traps
    TRAPS_DMA_BUS_ERR = 0, /**< Bus error trap */
    TRAPS_XRAM_BUS_ERR = 1, /**< Bus error trap */
    TRAPS_YRAM_BUS_ERR = 2, /**< Bus error trap */
    TRAPS_CPU_BUS_ERR = 3, /**< Bus error trap */
    TRAPS_ILLEGALINSTRUCTION = 5, /**< Illegal instruction trap */
    TRAPS_ADDRESS_ERR = 6, /**< Address error trap */
    TRAPS_STACK_ERR = 7, /**< Stack error trap */
    TRAPS_DIV0_ERR = 8, /**< Math error trap */
    TRAPS_SFTAC_ERR = 9, /**< Math error trap */
    TRAPS_COVB_ERR = 10, /**< Math error trap */
    TRAPS_COVA_ERR = 11, /**< Math error trap */
    TRAPS_OVB_ERR = 12, /**< Math error trap */
    TRAPS_OVA_ERR = 13, /**< Math error trap */
    TRAPS_COVT_ERR = 14, /**< Math error trap */
    TRAPS_OVBT_ERR = 15, /**< Math error trap */
    TRAPS_OVAT_ERR = 16, /**< Math error trap */
    TRAPS_DMT_ERR = 17, /**< General error trap */
    TRAPS_WDT_ERR = 18, /**< General error trap */
    TRAPS_XPWBDED_ERR = 19, /**< General error trap */
    TRAPS_YPWBDED_ERR = 20, /**< General error trap */
    TRAPS_GEN_ERR = 21, /**< General error trap */
};

// Section: Driver Interface Function

/**
 * @ingroup    trapsdriver
 * @brief      Stores the trap error code and waits forever.
 *             This is a weak attribute function. The user can 
 *             override and implement the same function without weak attribute.
 * @param[in]  code - trap error code
 * @return     none  
 */
void TRAPS_halt_on_error(uint16_t code);

#endif

