Overview

The MCUXpresso SDK provides a driver for the MECC module of MCUXpresso SDK devices.

The MECC64 module supports Single Error Correction and Double Error Detection(SECDED) ECC function to provide reliability for 4 banks On-Chip RAM(OCRAM) access.

This example code shows how to correct single error and detect multiple error using the MECC driver.

Refer to the driver examples codes located at <SDK_ROOT>/boards/<BOARD>/driver_examples/mecc

Data Structures
struct	mecc_config_t
	MECC user configuration. More...

struct	mecc_single_error_info_t
	MECC ocram single error information, including single error address, ECC code, error data and error bit position. More...

struct	mecc_multi_error_info_t
	MECC ocram multiple error information, including multiple error address, ECC code, error data. More...

Enumerations
enum	{ kStatus_MECC_BankMiss = MAKE_STATUS(kStatusGroup_MECC, 0) }
	Error codes for the MECC driver. More...

enum	{ kMECC_SingleError0InterruptEnable, kMECC_SingleError1InterruptEnable, kMECC_SingleError2InterruptEnable, kMECC_SingleError3InterruptEnable, kMECC_MultiError0InterruptEnable, kMECC_MultiError1InterruptEnable, kMECC_MultiError2InterruptEnable, kMECC_MultiError3InterruptEnable, kMECC_StrobeError0InterruptEnable, kMECC_StrobeError1InterruptEnable, kMECC_StrobeError2InterruptEnable, kMECC_StrobeError3InterruptEnable, kMECC_AccessError0InterruptEnable, kMECC_AccessError1InterruptEnable, kMECC_AccessError2InterruptEnable, kMECC_AccessError3InterruptEnable, kMECC_AllInterruptsEnable = 0xFFFF }
	MECC interrupt configuration structure, default settings all disabled. More...

enum	{ kMECC_SingleError0InterruptStatusEnable, kMECC_SingleError1InterruptStatusEnable, kMECC_SingleError2InterruptStatusEnable, kMECC_SingleError3InterruptStatusEnable, kMECC_MultiError0InterruptStatusEnable, kMECC_MultiError1InterruptStatusEnable, kMECC_MultiError2InterruptStatusEnable, kMECC_MultiError3InterruptStatusEnable, kMECC_StrobeError0InterruptStatusEnable, kMECC_StrobeError1InterruptStatusEnable, kMECC_StrobeError2InterruptStatusEnable, kMECC_StrobeError3InterruptStatusEnable, kMECC_AccessError0InterruptStatusEnable, kMECC_AccessError1InterruptStatusEnable, kMECC_AccessError2InterruptStatusEnable, kMECC_AccessError3InterruptStatusEnable, kMECC_AllInterruptsStatusEnable = 0xFFFF }
	MECC interrupt status configuration structure, default settings all disabled. More...

enum	{ kMECC_SingleError0InterruptFlag, kMECC_SingleError1InterruptFlag, kMECC_SingleError2InterruptFlag, kMECC_SingleError3InterruptFlag, kMECC_MultiError0InterruptFlag, kMECC_MultiError1InterruptFlag, kMECC_MultiError2InterruptFlag, kMECC_MultiError3InterruptFlag, kMECC_StrobeError0InterruptFlag, kMECC_StrobeError1InterruptFlag, kMECC_StrobeError2InterruptFlag, kMECC_StrobeError3InterruptFlag, kMECC_AccessError0InterruptFlag = MECC_ERR_STATUS_ADDR_ERR0_MASK, kMECC_AccessError1InterruptFlag = MECC_ERR_STATUS_ADDR_ERR1_MASK, kMECC_AccessError2InterruptFlag = MECC_ERR_STATUS_ADDR_ERR2_MASK, kMECC_AccessError3InterruptFlag = MECC_ERR_STATUS_ADDR_ERR3_MASK, kMECC_AllInterruptsFlag = 0xFFFF }
	MECC status flags. More...

enum	{ kMECC_OcramBank0 = 0U, kMECC_OcramBank1 = 1U, kMECC_OcramBank2 = 2U, kMECC_OcramBank3 = 3U }
	MECC ocram bank number. More...

enum	{ kMECC_Instance0 = 0U, kMECC_Instance1 = 1U }
	MECC instance. More...

Variables
bool	mecc_config_t::enableMecc
	Enable the MECC function. More...

uint32_t	mecc_config_t::Ocram1StartAddress
	Ocram 1 start address. More...

uint32_t	mecc_config_t::Ocram1EndAddress
	Ocram 1 end address. More...

uint32_t	mecc_config_t::Ocram2StartAddress
	Ocram 2 start address. More...

uint32_t	mecc_config_t::Ocram2EndAddress
	Ocram 2 end address. More...

uint32_t	mecc_single_error_info_t::singleErrorAddress
	Single error address on Ocram bank n.

uint32_t	mecc_single_error_info_t::singleErrorDataLow
	Single error low 32 bits uncorrected read data on Ocram bank n.

uint32_t	mecc_single_error_info_t::singleErrorDataHigh
	Single error high 32 bits uncorrected read data on Ocram bank n.

uint32_t	mecc_single_error_info_t::singleErrorPosLow
	Single error bit postion of low 32 bits read data on Ocram bank n.

uint32_t	mecc_single_error_info_t::singleErrorPosHigh
	Single error bit postion of high 32 bits read data on Ocram bank n.

uint8_t	mecc_single_error_info_t::singleErrorEccCode
	Single error ECC code on Ocram bank n.

uint32_t	mecc_multi_error_info_t::multiErrorAddress
	Multiple error address on Ocram bank n.

uint32_t	mecc_multi_error_info_t::multiErrorDataLow
	Multiple error low 32 bits read data on Ocram bank n.

uint32_t	mecc_multi_error_info_t::multiErrorDataHigh
	Multiple error high 32 bits read data on Ocram bank n.

uint8_t	mecc_multi_error_info_t::multiErrorEccCode
	Multiple error ECC code on Ocram bank n.

Driver version
#define	FSL_MECC_DRIVER_VERSION (MAKE_VERSION(2U, 0U, 1U))
	Driver version 2.0.1. More...

Initialization and deinitialization
void	MECC_Init (MECC_Type base, mecc_config_t config)
	MECC module initialization function. More...

void	MECC_Deinit (MECC_Type *base)
	Deinitializes the MECC. More...

void	MECC_GetDefaultConfig (mecc_config_t *config)
	Sets the MECC configuration structure to default values. More...

Status
static uint32_t	MECC_GetStatusFlags (MECC_Type *base)
	Gets MECC status flags. More...

static void	MECC_ClearStatusFlags (MECC_Type *base, uint32_t mask)
	MECC module clear interrupt status. More...

static void	MECC_EnableInterruptStatus (MECC_Type *base, uint32_t mask)
	MECC module enable interrupt status. More...

static void	MECC_DisableInterruptStatus (MECC_Type *base, uint32_t mask)
	MECC module disable interrupt status. More...

Interrupts
static void	MECC_EnableInterrupts (MECC_Type *base, uint32_t mask)
	MECC module enable interrupt. More...

static void	MECC_DisableInterrupts (MECC_Type *base, uint32_t mask)
	MECC module disable interrupt. More...

functional
status_t	MECC_ErrorInjection (MECC_Type *base, uint32_t lowerrordata, uint32_t higherrordata, uint8_t eccdata, uint8_t banknumber)
	MECC module error injection. More...

status_t	MECC_GetSingleErrorInfo (MECC_Type base, mecc_single_error_info_t info, uint8_t banknumber)
	MECC module get single error information. More...

status_t	MECC_GetMultiErrorInfo (MECC_Type base, mecc_multi_error_info_t info, uint8_t banknumber)
	MECC module get multiple error information. More...

Data Structure Documentation

struct mecc_config_t

Data Fields
bool	enableMecc
	Enable the MECC function. More...

uint32_t	Ocram1StartAddress
	Ocram 1 start address. More...

uint32_t	Ocram1EndAddress
	Ocram 1 end address. More...

uint32_t	Ocram2StartAddress
	Ocram 2 start address. More...

uint32_t	Ocram2EndAddress
	Ocram 2 end address. More...

struct mecc_single_error_info_t

Data Fields
uint32_t	singleErrorAddress
	Single error address on Ocram bank n.

uint32_t	singleErrorDataLow
	Single error low 32 bits uncorrected read data on Ocram bank n.

uint32_t	singleErrorDataHigh
	Single error high 32 bits uncorrected read data on Ocram bank n.

uint32_t	singleErrorPosLow
	Single error bit postion of low 32 bits read data on Ocram bank n.

uint32_t	singleErrorPosHigh
	Single error bit postion of high 32 bits read data on Ocram bank n.

uint8_t	singleErrorEccCode
	Single error ECC code on Ocram bank n.

struct mecc_multi_error_info_t

Data Fields
uint32_t	multiErrorAddress
	Multiple error address on Ocram bank n.

uint32_t	multiErrorDataLow
	Multiple error low 32 bits read data on Ocram bank n.

uint32_t	multiErrorDataHigh
	Multiple error high 32 bits read data on Ocram bank n.

uint8_t	multiErrorEccCode
	Multiple error ECC code on Ocram bank n.

Macro Definition Documentation

#define FSL_MECC_DRIVER_VERSION (MAKE_VERSION(2U, 0U, 1U))

Enumeration Type Documentation

anonymous enum

Enumerator
kStatus_MECC_BankMiss	Ocram bank miss.

anonymous enum

This structure contains the settings for all of the MECC interrupt configurations.

Enumerator
kMECC_SingleError0InterruptEnable	Single Bit Error On Ocram Bank0 interrupt enable.
kMECC_SingleError1InterruptEnable	Single Bit Error On Ocram Bank1 interrupt enable.
kMECC_SingleError2InterruptEnable	Single Bit Error On Ocram Bank2 interrupt enable.
kMECC_SingleError3InterruptEnable	Single Bit Error On Ocram Bank3 interrupt enable.
kMECC_MultiError0InterruptEnable	Multiple Bits Error On Ocram Bank0 interrupt enable.
kMECC_MultiError1InterruptEnable	Multiple Bits Error On Ocram Bank1 interrupt enable.
kMECC_MultiError2InterruptEnable	Multiple Bits Error On Ocram Bank2 interrupt enable.
kMECC_MultiError3InterruptEnable	Multiple Bits Error On Ocram Bank3 interrupt enable.
kMECC_StrobeError0InterruptEnable	AXI Strobe Error On Ocram Bank0 interrupt enable.
kMECC_StrobeError1InterruptEnable	AXI Strobe Error On Ocram Bank1 interrupt enable.
kMECC_StrobeError2InterruptEnable	AXI Strobe Error On Ocram Bank2 interrupt enable.
kMECC_StrobeError3InterruptEnable	AXI Strobe Error On Ocram Bank3 interrupt enable.
kMECC_AccessError0InterruptEnable	Ocram Access Error On Bank0 interrupt enable.
kMECC_AccessError1InterruptEnable	Ocram Access Error On Bank1 interrupt enable.
kMECC_AccessError2InterruptEnable	Ocram Access Error On Bank2 interrupt enable.
kMECC_AccessError3InterruptEnable	Ocram Access Error On Bank3 interrupt enable.
kMECC_AllInterruptsEnable	all interrupts enable

anonymous enum

This structure contains the settings for all of the MECC interrupt status configurations.

Enumerator
kMECC_SingleError0InterruptStatusEnable	Single Bit Error On Ocram Bank0 interrupt status enable.
kMECC_SingleError1InterruptStatusEnable	Single Bit Error On Ocram Bank1 interrupt status enable.
kMECC_SingleError2InterruptStatusEnable	Single Bit Error On Ocram Bank2 interrupt status enable.
kMECC_SingleError3InterruptStatusEnable	Single Bit Error On Ocram Bank3 interrupt status enable.
kMECC_MultiError0InterruptStatusEnable	Multiple Bits Error On Ocram Bank0 interrupt status enable.
kMECC_MultiError1InterruptStatusEnable	Multiple Bits Error On Ocram Bank1 interrupt status enable.
kMECC_MultiError2InterruptStatusEnable	Multiple Bits Error On Ocram Bank2 interrupt status enable.
kMECC_MultiError3InterruptStatusEnable	Multiple Bits Error On Ocram Bank3 interrupt status enable.
kMECC_StrobeError0InterruptStatusEnable	AXI Strobe Error On Ocram Bank0 interrupt status enable.
kMECC_StrobeError1InterruptStatusEnable	AXI Strobe Error On Ocram Bank1 interrupt status enable.
kMECC_StrobeError2InterruptStatusEnable	AXI Strobe Error On Ocram Bank2 interrupt status enable.
kMECC_StrobeError3InterruptStatusEnable	AXI Strobe Error On Ocram Bank3 interrupt status enable.
kMECC_AccessError0InterruptStatusEnable	Ocram Access Error On Bank0 interrupt status enable.
kMECC_AccessError1InterruptStatusEnable	Ocram Access Error On Bank1 interrupt status enable.
kMECC_AccessError2InterruptStatusEnable	Ocram Access Error On Bank2 interrupt status enable.
kMECC_AccessError3InterruptStatusEnable	Ocram Access Error On Bank3 interrupt status enable.
kMECC_AllInterruptsStatusEnable	all interrupts enable

anonymous enum

This provides constants for the MECC status flags for use in the MECC functions.

Enumerator
kMECC_SingleError0InterruptFlag	Single Bit Error On Ocram Bank0 interrupt flag.
kMECC_SingleError1InterruptFlag	Single Bit Error On Ocram Bank1 interrupt flag.
kMECC_SingleError2InterruptFlag	Single Bit Error On Ocram Bank2 interrupt flag.
kMECC_SingleError3InterruptFlag	Single Bit Error On Ocram Bank3 interrupt flag.
kMECC_MultiError0InterruptFlag	Multiple Bits Error On Ocram Bank0 interrupt flag.
kMECC_MultiError1InterruptFlag	Multiple Bits Error On Ocram Bank1 interrupt flag.
kMECC_MultiError2InterruptFlag	Multiple Bits Error On Ocram Bank2 interrupt flag.
kMECC_MultiError3InterruptFlag	Multiple Bits Error On Ocram Bank3 interrupt flag.
kMECC_StrobeError0InterruptFlag	AXI Strobe Error On Ocram Bank0 interrupt flag.
kMECC_StrobeError1InterruptFlag	AXI Strobe Error On Ocram Bank1 interrupt flag.
kMECC_StrobeError2InterruptFlag	AXI Strobe Error On Ocram Bank2 interrupt flag.
kMECC_StrobeError3InterruptFlag	AXI Strobe Error On Ocram Bank3 interrupt flag.
kMECC_AccessError0InterruptFlag	Ocram Access Error On Bank0 interrupt flag.
kMECC_AccessError1InterruptFlag	Ocram Access Error On Bank1 interrupt flag.
kMECC_AccessError2InterruptFlag	Ocram Access Error On Bank2 interrupt flag.
kMECC_AccessError3InterruptFlag	Ocram Access Error On Bank3 interrupt flag.
kMECC_AllInterruptsFlag	all interrupts interrupt flag

anonymous enum

Enumerator
kMECC_OcramBank0	ocram bank number 0: ocram_base_address+0x20*i
kMECC_OcramBank1	ocram bank number 1: ocram_base_address+0x20*i+0x8
kMECC_OcramBank2	ocram bank number 2: ocram_base_address+0x20*i+0x10
kMECC_OcramBank3	ocram bank number 3: ocram_base_address+0x20*i+0x18

anonymous enum

Enumerator
kMECC_Instance0	Peripheral MECC1 base.
kMECC_Instance1	Peripheral MECC2 base.

Function Documentation

void MECC_Init	(	MECC_Type *	base,
		mecc_config_t *	config
	)

Parameters

base	MECC base address.
config	pointer to the MECC configuration structure.

void MECC_Deinit ( MECC_Type * base )

Parameters

base	MECC base address.

void MECC_GetDefaultConfig ( mecc_config_t * config )

Parameters

config pointer to the MECC configuration structure.

static uint32_t MECC_GetStatusFlags ( MECC_Type * base )

inlinestatic

Parameters

base	MECC peripheral base address.

Returns: MECC status flags.

static void MECC_ClearStatusFlags	(	MECC_Type *	base,
		uint32_t	mask
	)

inlinestatic

Parameters

base	MECC base address.
mask	status to clear.

static void MECC_EnableInterruptStatus	(	MECC_Type *	base,
		uint32_t	mask
	)

inlinestatic

Parameters

base	MECC base address.
mask	status to enable.

static void MECC_DisableInterruptStatus	(	MECC_Type *	base,
		uint32_t	mask
	)

inlinestatic

Parameters

base	MECC base address.
mask	status to disable.

static void MECC_EnableInterrupts	(	MECC_Type *	base,
		uint32_t	mask
	)

inlinestatic

Parameters

base	MECC base address.
mask	The interrupts to enable.

static void MECC_DisableInterrupts	(	MECC_Type *	base,
		uint32_t	mask
	)

inlinestatic

Parameters

base	MECC base address.
mask	The interrupts to disable.

status_t MECC_ErrorInjection	(	MECC_Type *	base,
		uint32_t	lowerrordata,
		uint32_t	higherrordata,
		uint8_t	eccdata,
		uint8_t	banknumber
	)

Parameters

base	MECC base address.
lowerrordata	low 32 bits data.
higherrordata	high 32 bits data.
eccdata	ecc code.
banknumber	ocram bank number.

Return values

kStatus_Success. Bank0: ocram_base_address+0x20*i Bank1: ocram_base_address+0x20*i+0x8 Bank2: ocram_base_address+0x20*i+0x10 Bank3: ocram_base_address+0x20*i+0x18 i = 0,1,2,3,4.....

status_t MECC_GetSingleErrorInfo	(	MECC_Type *	base,
		mecc_single_error_info_t *	info,
		uint8_t	banknumber
	)

Parameters

base	MECC base address.
info	single error information.
banknumber	ocram bank number.

Return values

kStatus_Success.
kStatus_MECC_BankMiss.	Bank0: ocram_base_address+0x20i Bank1: ocram_base_address+0x20i+0x8 Bank2: ocram_base_address+0x20i+0x10 Bank3: ocram_base_address+0x20i+0x18 i = 0,1,2,3,4.....

status_t MECC_GetMultiErrorInfo	(	MECC_Type *	base,
		mecc_multi_error_info_t *	info,
		uint8_t	banknumber
	)

Parameters

base	MECC base address.
info	multiple error information.
banknumber	ocram bank number.

Return values

kStatus_Success.
kStatus_MECC_BankMiss.	Bank0: ocram_base_address+0x20i Bank1: ocram_base_address+0x20i+0x8 Bank2: ocram_base_address+0x20i+0x10 Bank3: ocram_base_address+0x20i+0x18 i = 0,1,2,3,4.....

Variable Documentation

bool mecc_config_t::enableMecc

uint32_t mecc_config_t::Ocram1StartAddress

uint32_t mecc_config_t::Ocram1EndAddress

uint32_t mecc_config_t::Ocram2StartAddress

uint32_t mecc_config_t::Ocram2EndAddress

Overview

Data Structures

Enumerations

Variables

Driver version

Initialization and deinitialization

Status

Interrupts

functional

Data Structure Documentation

Data Fields

Data Fields

Data Fields

Macro Definition Documentation

Enumeration Type Documentation

Function Documentation

Variable Documentation