smbae/ADM
1
0
Fork 0
mirror of https://github.com/Dev-KATECH/ADM.git synced 2026-05-17 01:43:59 +09:00
Code Issues Actions Packages Projects Releases Wiki Activity
hotfix
ADM/GW/generate/include/Mcal.h
S2-CHICKEN 77297108b6 VCU C code first commit
2024-08-08 10:00:15 +09:00

618 lines
24 KiB
C
Raw Permalink Blame History

/*==================================================================================================
* Project : RTD AUTOSAR 4.4
* Platform : CORTEXM
* Peripheral : S32K3XX
* Dependencies : none
*
* Autosar Version : 4.4.0
* Autosar Revision : ASR_REL_4_4_REV_0000
* Autosar Conf.Variant :
* SW Version : 0.9.0
* Build Version : S32K3_RTD_0_9_0_P02_D2107_ASR_REL_4_4_REV_0000_20210716
*
* (c) Copyright 2020 - 2021 NXP Semiconductors
* All Rights Reserved.
*
* NXP Confidential. This software is owned or controlled by NXP and may only be
* used strictly in accordance with the applicable license terms. By expressly
* accepting such terms or by downloading, installing, activating and/or otherwise
* using the software, you are agreeing that you have read, and that you agree to
* comply with and are bound by, such license terms. If you do not agree to be
* bound by the applicable license terms, then you may not retain, install,
* activate or otherwise use the software.
==================================================================================================*/
/**
* @file Mcal.h
* @implements Mcal.h_Artifact
* @version 0.9.0
*
* @brief AUTOSAR Base - SWS Compiler abstraction specific for MCAL.
* @details The file Mcal.h provides MCAL specific macros used for compiler abstraction.
*
*
* @addtogroup BASE_COMPONENT
* @{
*/
#ifndef MCAL_H
#define MCAL_H
#ifdef __cplusplus
extern "C"{
#endif
/*==================================================================================================
* INCLUDE FILES
* 1) system and project includes
* 2) needed interfaces from external units
* 3) internal and external interfaces from this unit
==================================================================================================*/
/*
* @file Mcal.h
* @brief Include compiler abstraction
*/
#include "Compiler.h"
/*
* @file Mcal.h
* @brief Include standard types
*/
#include "StandardTypes.h"
#include "Soc_Ips.h"
#include "Reg_eSys.h"
#include "OsIf_Internal.h"
/*==================================================================================================
* SOURCE FILE VERSION INFORMATION
==================================================================================================*/
#define MCAL_VENDOR_ID 43
/** @violates @ref Mcal_h_REF_2 unused macro. */
#define MCAL_MODULE_ID 0
#define MCAL_AR_RELEASE_MAJOR_VERSION 4
#define MCAL_AR_RELEASE_MINOR_VERSION 4
#define MCAL_AR_RELEASE_REVISION_VERSION 0
#define MCAL_SW_MAJOR_VERSION 0
#define MCAL_SW_MINOR_VERSION 9
#define MCAL_SW_PATCH_VERSION 0
/*==================================================================================================
* FILE VERSION CHECKS
==================================================================================================*/
#ifndef DISABLE_MCAL_INTERMODULE_ASR_CHECK
/* Check if source file and Compiler.h header file are of the same Autosar version */
#if ((MCAL_AR_RELEASE_MAJOR_VERSION != COMPILER_AR_RELEASE_MAJOR_VERSION) || \
(MCAL_AR_RELEASE_MINOR_VERSION != COMPILER_AR_RELEASE_MINOR_VERSION))
#error "AutoSar Version Numbers of Mcal.h and Compiler.h are different"
#endif
#endif
#ifndef DISABLE_MCAL_INTERMODULE_ASR_CHECK
/* Check if source file and StandardTypes.h header file are of the same Autosar version */
#if ((MCAL_AR_RELEASE_MAJOR_VERSION != STD_AR_RELEASE_MAJOR_VERSION) || \
(MCAL_AR_RELEASE_MINOR_VERSION != STD_AR_RELEASE_MINOR_VERSION))
#error "AutoSar Version Numbers of Mcal.h and StandardTypes.h are different"
#endif
#endif
#ifndef DISABLE_MCAL_INTERMODULE_ASR_CHECK
/* Check if source file and StandardTypes.h header file are of the same Autosar version */
#if ((MCAL_AR_RELEASE_MAJOR_VERSION != REG_ESYS_AR_RELEASE_MAJOR_VERSION) || \
(MCAL_AR_RELEASE_MINOR_VERSION != REG_ESYS_AR_RELEASE_MINOR_VERSION))
#error "AutoSar Version Numbers of Mcal.h and Reg_eSys.h are different"
#endif
#endif
/* Check if source file and Soc_Ips.h header file have same versions */
#if (MCAL_VENDOR_ID != SOC_IPS_VENDOR_ID)
#error "Soc_Ips.h and Mcal.h have different vendor IDs"
#endif
/* Check if source file and Soc_Ips.h header file are of the same Autosar version */
#if ((MCAL_AR_RELEASE_MAJOR_VERSION != SOC_IPS_AR_RELEASE_MAJOR_VERSION) || \
(MCAL_AR_RELEASE_MINOR_VERSION != SOC_IPS_AR_RELEASE_MINOR_VERSION))
#error "AutoSar Version Numbers of Mcal.h and Soc_Ips.h are different"
#endif
#if ((MCAL_SW_MAJOR_VERSION != SOC_IPS_SW_MAJOR_VERSION) || \
(MCAL_SW_MINOR_VERSION != SOC_IPS_SW_MINOR_VERSION) || \
(MCAL_SW_PATCH_VERSION != SOC_IPS_SW_PATCH_VERSION))
#error "Software Version Numbers of Soc_Ips.h and Mcal.h are different"
#endif
/*==================================================================================================
* CONSTANTS
==================================================================================================*/
/*==================================================================================================
* DEFINES AND MACROS
==================================================================================================*/
/**************************************** Green Hills *********************************************/
#ifdef _GREENHILLS_C_S32K3XX_
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD __asm
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD(" wfi"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_START(sec_name, align)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define VAR_ALIGN(v, size) __attribute__(( aligned(size) )) v;
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_STOP()
/**
* @brief Compiler abstraction for the packed qualifier
*/
#define PACKED __packed
/**
* @brief Compiler abstraction for MCAL Fault Injection tests
*/
#ifdef MCAL_ENABLE_FAULT_INJECTION
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_PUT_IN_QUOTES(x) #x
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label) ASM_KEYWORD(MCAL_PUT_IN_QUOTES(label::))
#else
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label)
#endif
#endif /* #ifdef _GREENHILLS_C_S32K3XX_ */
/**************************************** Wind River Diab *****************************************/
#ifdef _DIABDATA_C_S32K3XX_
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD __asm volatile
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD(" wfi"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_START(sec_name, align)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define VAR_ALIGN(v, size) __attribute__(( aligned(size) )) v;
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_STOP()
/**
* @brief Compiler abstraction for the packed qualifier
*/
#define PACKED __attribute__((packed))
/**
* @brief Compiler abstraction for MCAL Fault Injection tests
*/
#ifdef MCAL_ENABLE_FAULT_INJECTION
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_PUT_IN_QUOTES(x) #x
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label) ASM_KEYWORD(MCAL_PUT_IN_QUOTES(label:))
#else
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label)
#endif
#endif /* #ifdef _DIABDATA_C_S32K3XX_ */
/*************************************** CodeWarrior **********************************************/
#ifdef _CODEWARRIOR_C_S32K3XX_
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD asm
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD (" opword 0x7C00007C"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_START(sec_name, align)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define VAR_ALIGN(v, size) v __attribute__(( aligned(size) ));
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_STOP()
/**
* @brief Compiler abstraction for the packed qualifier
*/
#define PACKED __packed
#endif /* #ifdef _CODEWARRIOR_C_S32K3XX_ */
/*************************************** Cosmic ***************************************************/
#ifdef _COSMIC_C_S32K3XX_
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD _asm
/**
* @brief Compiler abstraction for the asm keyword.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ASM_PUBLIC_LABEL(label) _asm("\txdef\t" #label "\n" #label ":")
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD (" dc.l 0x7C00007C"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
#define ALIGNED_VARS_START(sec_name, align) \#pragma section [sec_name ## align]
/**
* @brief Compiler abstraction for the data alignment
*/
#define VAR_ALIGN(v, size) v;
/**
* @brief Compiler abstraction for the data alignment
*/
#define ALIGNED_VARS_STOP() \#pragma section []
#endif /* #ifdef _COSMIC_C_S32K3XX_ */
/*************************************** HighTec **********************************************/
#ifdef _HITECH_C_S32K3XX_
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD __asm
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD(" wait"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_START(sec_name, align)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define VAR_ALIGN(v, size) __attribute__(( aligned(size) )) v;
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_STOP()
#endif /* #ifdef _HITECH_C_S32K3XX_ */
/**************************************** Linaro *********************************************/
#ifdef _LINARO_C_S32K3XX_
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD __asm
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD(" wfi"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_START(sec_name, align)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define VAR_ALIGN(v, size) __attribute__(( aligned(size) )) v;
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_STOP()
/**
* @brief Compiler abstraction for the packed qualifier
*/
#define PACKED __attribute__((__packed__))
/**
* @brief Compiler abstraction for MCAL Fault Injection tests
*/
#ifdef MCAL_ENABLE_FAULT_INJECTION
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_PUT_IN_QUOTES(x) #x
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label) ASM_KEYWORD(MCAL_PUT_IN_QUOTES(label:))
#else
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label)
#endif
#endif /* #ifdef _LINARO_C_S32K3XX_ */
/**************************************** DS5 *********************************************/
#ifdef _ARM_DS5_C_S32K3XX_
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD __asm
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD(" wfi"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_START(sec_name, align)
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define VAR_ALIGN(v, size) __align(size) v;
/**
* @brief Compiler abstraction for the data alignment
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define ALIGNED_VARS_STOP()
/**
* @brief Compiler abstraction for the packed qualifier
*/
#define PACKED __packed
/**
* @brief Compiler abstraction for MCAL Fault Injection tests
*/
#ifdef MCAL_ENABLE_FAULT_INJECTION
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_PUT_IN_QUOTES(x) #x
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label) ASM_KEYWORD(MCAL_PUT_IN_QUOTES(label:))
#else
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label)
#endif
#endif /* #ifdef _ARM_DS5_C_S32K3XX_ */
/**************************************** IAR *********************************************/
#ifdef _IAR_C_S32K3XX_
/**
* @brief Compiler abstraction for the "Put in Quotes".
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_PUT_IN_QUOTES(x) #x
/**
* @brief Compiler abstraction for the "Double Put in Quotes" - Used by VAL_ALIGN.
*/
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_PUT_IN_QUOTES1(x) MCAL_PUT_IN_QUOTES(x)
/**
* @brief Compiler abstraction for the asm keyword.
*/
#define ASM_KEYWORD __asm
/**
* @brief Compiler abstraction for the intrinsic wait instruction.
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define EXECUTE_WAIT() \
do \
{ \
OsIf_ResumeAllInterrupts(); \
ASM_KEYWORD(" wfi"); \
OsIf_SuspendAllInterrupts(); \
} while (0)
/**
* @brief Compiler abstraction for the data alignment
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define ALIGNED_VARS_START(sec_name, align)
/**
* @brief Compiler abstraction for the data alignment
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define VAR_ALIGN(v, size) _Pragma(MCAL_PUT_IN_QUOTES1(data_alignment=size)) \
v;
/**
* @brief Compiler abstraction for the data alignment
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define ALIGNED_VARS_STOP()
/**
* @brief Compiler abstraction for the packed qualifier
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define PACKED __packed
/**
* @brief Compiler abstraction for MCAL Fault Injection tests
*/
#ifdef MCAL_ENABLE_FAULT_INJECTION
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label) ASM_KEYWORD(MCAL_PUT_IN_QUOTES(label:))
#else
/** @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro. */
#define MCAL_FAULT_INJECTION_POINT(label)
#endif
#endif /* #ifdef _IAR_C_S32K3XX_ */
/* check that the compiler used is supported (otherwise some defines might not exist) */
#ifndef _GREENHILLS_C_S32K3XX_
#ifndef _DIABDATA_C_S32K3XX_
#ifndef _CODEWARRIOR_C_S32K3XX_
#ifndef _COSMIC_C_S32K3XX_
#ifndef _HITECH_C_S32K3XX_
#ifndef _LINARO_C_S32K3XX_
#ifndef _ARM_DS5_C_S32K3XX_
#ifndef _IAR_C_S32K3XX_
#error "Unsupported compiler. Compiler abstraction needs to be updated to use this compiler."
#endif
#endif
#endif
#endif
#endif
#endif
#endif
#endif
#if (MCAL_PLATFORM_ARM == MCAL_ARM_AARCH64)
/**
* @brief Data Synchronization Barrier (DSB) completes when all instructions before this instruction complete
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define MCAL_DATA_SYNC_BARRIER() ASM_KEYWORD("dsb sy":::"memory")
/**
* @brief flushes the pipeline in the processor, so that all instructions following the ISB are fetched from cache or memory, after the ISB has been completed.
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define MCAL_INSTRUCTION_SYNC_BARRIER() ASM_KEYWORD("isb":::"memory")
#else
/**
* @brief Data Synchronization Barrier (DSB) completes when all instructions before this instruction complete
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define MCAL_DATA_SYNC_BARRIER() ASM_KEYWORD(" DSB")
/**
* @brief flushes the pipeline in the processor, so that all instructions following the ISB are fetched from cache or memory, after the ISB has been completed.
*/
/*
* @violates @ref Mcal_h_REF_1 A function should be used in preference to a function-like macro.
*/
#define MCAL_INSTRUCTION_SYNC_BARRIER() ASM_KEYWORD(" ISB")
#endif
/*==================================================================================================
* ENUMS
==================================================================================================*/
/*==================================================================================================
* STRUCTURES AND OTHER TYPEDEFS
==================================================================================================*/
/**
* @brief Typedef for DEM error management implemented by MCAL drivers
*/
typedef struct
{
uint32 state; /**< enabling/disabling the DEM error: Active=STD_ON/ Inactive=STD_OFF */
uint32 id ; /**< ID of DEM error (0 if STD_OFF)*/
}Mcal_DemErrorType;
/*==================================================================================================
* GLOBAL VARIABLE DECLARATIONS
==================================================================================================*/
/*==================================================================================================
* FUNCTION PROTOTYPES
==================================================================================================*/
#ifdef __cplusplus
}
#endif
#endif /* #ifndef MCAL_H */
/** @} */
Reference in New Issue View Git Blame Copy Permalink