EFM32 Wonder Gecko Software Documentation  efm32wg-doc-5.1.2

Detailed Description

EBI External Bus Interface (EBI) Peripheral API.

This module contains functions to control the EBI peripheral of Silicon Labs 32-bit MCUs and SoCs. The EBI is used for accessing external parallel devices. The devices appear as part of the internal memory map of the MCU.

Data Structures

struct  EBI_Init_TypeDef
 
struct  EBI_TFTInit_TypeDef
 

Macros

#define EBI_BANK0   (uint32_t)(1 << 1)
 
#define EBI_BANK1   (uint32_t)(1 << 2)
 
#define EBI_BANK2   (uint32_t)(1 << 3)
 
#define EBI_BANK3   (uint32_t)(1 << 4)
 
#define EBI_CS0   (uint32_t)(1 << 1)
 
#define EBI_CS1   (uint32_t)(1 << 2)
 
#define EBI_CS2   (uint32_t)(1 << 3)
 
#define EBI_CS3   (uint32_t)(1 << 4)
 
#define EBI_INIT_DEFAULT
 
#define EBI_TFTINIT_DEFAULT
 

Enumerations

enum  EBI_AHigh_TypeDef {
  ebiAHighA0 = EBI_ROUTE_APEN_A0,
  ebiAHighA5 = EBI_ROUTE_APEN_A5,
  ebiAHighA6 = EBI_ROUTE_APEN_A6,
  ebiAHighA7 = EBI_ROUTE_APEN_A7,
  ebiAHighA8 = EBI_ROUTE_APEN_A8,
  ebiAHighA9 = EBI_ROUTE_APEN_A9,
  ebiAHighA10 = EBI_ROUTE_APEN_A10,
  ebiAHighA11 = EBI_ROUTE_APEN_A11,
  ebiAHighA12 = EBI_ROUTE_APEN_A12,
  ebiAHighA13 = EBI_ROUTE_APEN_A13,
  ebiAHighA14 = EBI_ROUTE_APEN_A14,
  ebiAHighA15 = EBI_ROUTE_APEN_A15,
  ebiAHighA16 = EBI_ROUTE_APEN_A16,
  ebiAHighA17 = EBI_ROUTE_APEN_A17,
  ebiAHighA18 = EBI_ROUTE_APEN_A18,
  ebiAHighA19 = EBI_ROUTE_APEN_A19,
  ebiAHighA20 = EBI_ROUTE_APEN_A20,
  ebiAHighA21 = EBI_ROUTE_APEN_A21,
  ebiAHighA22 = EBI_ROUTE_APEN_A22,
  ebiAHighA23 = EBI_ROUTE_APEN_A23,
  ebiAHighA24 = EBI_ROUTE_APEN_A24,
  ebiAHighA25 = EBI_ROUTE_APEN_A25,
  ebiAHighA26 = EBI_ROUTE_APEN_A26,
  ebiAHighA27 = EBI_ROUTE_APEN_A27,
  ebiAHighA28 = EBI_ROUTE_APEN_A28
}
 
enum  EBI_ALow_TypeDef {
  ebiALowA0 = EBI_ROUTE_ALB_A0,
  ebiALowA8 = EBI_ROUTE_ALB_A8,
  ebiALowA16 = EBI_ROUTE_ALB_A16,
  ebiALowA24 = EBI_ROUTE_ALB_A24
}
 
enum  EBI_Line_TypeDef {
  ebiLineARDY,
  ebiLineALE,
  ebiLineWE,
  ebiLineRE,
  ebiLineCS,
  ebiLineBL,
  ebiLineTFTVSync,
  ebiLineTFTHSync,
  ebiLineTFTDataEn,
  ebiLineTFTDClk,
  ebiLineTFTCS
}
 
enum  EBI_Location_TypeDef {
  ebiLocation0 = EBI_ROUTE_LOCATION_LOC0,
  ebiLocation1 = EBI_ROUTE_LOCATION_LOC1,
  ebiLocation2 = EBI_ROUTE_LOCATION_LOC2
}
 
enum  EBI_Mode_TypeDef {
  ebiModeD8A8 = EBI_CTRL_MODE_D8A8,
  ebiModeD16A16ALE = EBI_CTRL_MODE_D16A16ALE,
  ebiModeD8A24ALE = EBI_CTRL_MODE_D8A24ALE,
  ebiModeD16 = EBI_CTRL_MODE_D16
}
 
enum  EBI_Polarity_TypeDef {
  ebiActiveLow = 0,
  ebiActiveHigh = 1
}
 
enum  EBI_TFTBank_TypeDef {
  ebiTFTBank0 = EBI_TFTCTRL_BANKSEL_BANK0,
  ebiTFTBank1 = EBI_TFTCTRL_BANKSEL_BANK1,
  ebiTFTBank2 = EBI_TFTCTRL_BANKSEL_BANK2,
  ebiTFTBank3 = EBI_TFTCTRL_BANKSEL_BANK3
}
 
enum  EBI_TFTColorSrc_TypeDef {
  ebiTFTColorSrcMem = EBI_TFTCTRL_COLOR1SRC_MEM,
  ebiTFTColorSrcPixel1 = EBI_TFTCTRL_COLOR1SRC_PIXEL1
}
 
enum  EBI_TFTDDMode_TypeDef {
  ebiTFTDDModeDisabled = EBI_TFTCTRL_DD_DISABLED,
  ebiTFTDDModeInternal = EBI_TFTCTRL_DD_INTERNAL,
  ebiTFTDDModeExternal = EBI_TFTCTRL_DD_EXTERNAL
}
 
enum  EBI_TFTFrameBufTrigger_TypeDef {
  ebiTFTFrameBufTriggerVSync = EBI_TFTCTRL_FBCTRIG_VSYNC,
  ebiTFTFrameBufTriggerHSync = EBI_TFTCTRL_FBCTRIG_HSYNC
}
 
enum  EBI_TFTInterleave_TypeDef {
  ebiTFTInterleaveUnlimited = EBI_TFTCTRL_INTERLEAVE_UNLIMITED,
  ebiTFTInterleaveOnePerDClk = EBI_TFTCTRL_INTERLEAVE_ONEPERDCLK,
  ebiTFTInterleavePorch = EBI_TFTCTRL_INTERLEAVE_PORCH
}
 
enum  EBI_TFTMaskBlend_TypeDef {
  ebiTFTMBDisabled = EBI_TFTCTRL_MASKBLEND_DISABLED,
  ebiTFTMBIMask = EBI_TFTCTRL_MASKBLEND_IMASK,
  ebiTFTMBIAlpha = EBI_TFTCTRL_MASKBLEND_IALPHA,
  ebiTFTMBIMaskAlpha = EBI_TFTCTRL_MASKBLEND_IMASKIALPHA,
  ebiTFTMBEMask = EBI_TFTCTRL_MASKBLEND_EMASK,
  ebiTFTMBEAlpha = EBI_TFTCTRL_MASKBLEND_EALPHA,
  ebiTFTMBEMaskAlpha = EBI_TFTCTRL_MASKBLEND_EMASKEALPHA
}
 
enum  EBI_TFTWidth_TypeDef {
  ebiTFTWidthByte = EBI_TFTCTRL_WIDTH_BYTE,
  ebiTFTWidthHalfWord = EBI_TFTCTRL_WIDTH_HALFWORD
}
 

Functions

void EBI_AddressTimingSet (int setupCycles, int holdCycles)
 Configure timing values of address latch bus accesses. More...
 
void EBI_AltMapEnable (bool enable)
 Configure Alternate Address Map support Enables or disables 256MB address range for all banks. More...
 
uint32_t EBI_BankAddress (uint32_t bank)
 Return base address of EBI bank. More...
 
void EBI_BankAddressTimingConfig (uint32_t banks, bool halfALE)
 Configure address operation parameters for selected bank. More...
 
void EBI_BankAddressTimingSet (uint32_t banks, int setupCycles, int holdCycles)
 Configure timing values of address latch bus accesses. More...
 
void EBI_BankByteLaneEnable (uint32_t banks, bool enable)
 Configure Byte Lane Enable for select banks timing support. More...
 
void EBI_BankEnable (uint32_t banks, bool enable)
 Enable or disable EBI Bank. More...
 
void EBI_BankPolaritySet (uint32_t banks, EBI_Line_TypeDef line, EBI_Polarity_TypeDef polarity)
 Configure EBI pin polarity for selected bank(s) for devices with individual timing support. More...
 
void EBI_BankReadTimingConfig (uint32_t banks, bool pageMode, bool prefetch, bool halfRE)
 Configure read operation parameters for selected bank. More...
 
void EBI_BankReadTimingSet (uint32_t banks, int setupCycles, int strobeCycles, int holdCycles)
 Configure timing values of read bus accesses. More...
 
void EBI_BankWriteTimingConfig (uint32_t banks, bool writeBufDisable, bool halfWE)
 Configure write operation parameters for selected bank. More...
 
void EBI_BankWriteTimingSet (uint32_t banks, int setupCycles, int strobeCycles, int holdCycles)
 Configure timing values of write bus accesses. More...
 
void EBI_ChipSelectEnable (uint32_t cs, bool enable)
 Enable or disable EBI Chip Select. More...
 
void EBI_Disable (void)
 Disable External Bus Interface.
 
void EBI_Init (const EBI_Init_TypeDef *ebiInit)
 Configure and enable External Bus Interface. More...
 
__STATIC_INLINE void EBI_IntClear (uint32_t flags)
 Clear one or more pending EBI interrupts. More...
 
__STATIC_INLINE void EBI_IntDisable (uint32_t flags)
 Disable one or more EBI interrupts. More...
 
__STATIC_INLINE void EBI_IntEnable (uint32_t flags)
 Enable one or more EBI interrupts. More...
 
__STATIC_INLINE uint32_t EBI_IntGet (void)
 Get pending EBI interrupt flags. More...
 
__STATIC_INLINE uint32_t EBI_IntGetEnabled (void)
 Get enabled and pending EBI interrupt flags. Useful for handling more interrupt sources in the same interrupt handler. More...
 
__STATIC_INLINE void EBI_IntSet (uint32_t flags)
 Set one or more pending EBI interrupts. More...
 
void EBI_PolaritySet (EBI_Line_TypeDef line, EBI_Polarity_TypeDef polarity)
 Configure EBI pin polarity. More...
 
void EBI_ReadTimingSet (int setupCycles, int strobeCycles, int holdCycles)
 Configure timing values of read bus accesses. More...
 
__STATIC_INLINE void EBI_StartNandEccGen (void)
 Start ECC generator on NAND flash transfers.
 
__STATIC_INLINE uint32_t EBI_StopNandEccGen (void)
 Stop NAND flash ECC generator and return generated ECC. More...
 
__STATIC_INLINE void EBI_TFTAlphaBlendSet (uint8_t alpha)
 Set TFT Alpha Blending Factor. More...
 
__STATIC_INLINE void EBI_TFTEnable (EBI_TFTDDMode_TypeDef mode)
 Enable or disable TFT Direct Drive. More...
 
__STATIC_INLINE void EBI_TFTFBTriggerSet (EBI_TFTFrameBufTrigger_TypeDef sync)
 Set Frame Buffer Trigger. More...
 
__STATIC_INLINE void EBI_TFTFrameBaseSet (uint32_t address)
 Configure frame buffer pointer. More...
 
__STATIC_INLINE uint32_t EBI_TFTHCount (void)
 Get current horizontal position counter. More...
 
void EBI_TFTHPorchSet (int front, int back, int pulseWidth)
 Configure and initialize Horizontal Porch Settings. More...
 
__STATIC_INLINE void EBI_TFTHStrideSet (uint32_t nbytes)
 Set horizontal TFT stride value in number of bytes. More...
 
void EBI_TFTInit (const EBI_TFTInit_TypeDef *ebiTFTInit)
 Configure and initialize TFT Direct Drive. More...
 
__STATIC_INLINE void EBI_TFTMaskBlendMode (EBI_TFTMaskBlend_TypeDef maskBlend)
 Masking and Blending Mode Set. More...
 
__STATIC_INLINE void EBI_TFTMaskSet (uint32_t mask)
 Set TFT mask value Data accesses that matches this value are suppressed. More...
 
__STATIC_INLINE void EBI_TFTPixelSet (int pixel, uint32_t color)
 Set TFT Pixel Color 0 or 1. More...
 
void EBI_TFTSizeSet (uint32_t horizontal, uint32_t vertical)
 Configure and initialize TFT size settings. More...
 
void EBI_TFTTimingSet (int dclkPeriod, int start, int setup, int hold)
 Configure TFT Direct Drive Timing Settings. More...
 
__STATIC_INLINE uint32_t EBI_TFTVCount (void)
 Get current vertical position counter. More...
 
void EBI_TFTVPorchSet (int front, int back, int pulseWidth)
 Configure Vertical Porch Settings. More...
 
void EBI_WriteTimingSet (int setupCycles, int strobeCycles, int holdCycles)
 Configure timing values of write bus accesses. More...
 

Macro Definition Documentation

#define EBI_BANK0   (uint32_t)(1 << 1)
*
* ---------               ---------
* |       |  /|       |\  | Ext.  |
* |  EBI  | / --------- \ | Async |
* |       | \ --------- / | Device|
* |       |  \|       |/  |       |
* ---------               ---------
*         Parallel interface
*
* 

EBI address bank 0

Definition at line 75 of file em_ebi.h.

Referenced by BSP_EbiInit(), EBI_BankAddress(), EBI_BankAddressTimingConfig(), EBI_BankAddressTimingSet(), EBI_BankByteLaneEnable(), EBI_BankEnable(), EBI_BankPolaritySet(), EBI_BankReadTimingConfig(), EBI_BankReadTimingSet(), EBI_BankWriteTimingConfig(), EBI_BankWriteTimingSet(), and EBI_Init().

#define EBI_CS0   (uint32_t)(1 << 1)

EBI chip select line 0

Definition at line 80 of file em_ebi.h.

Referenced by EBI_ChipSelectEnable().

#define EBI_CS1   (uint32_t)(1 << 2)

EBI chip select line 1

Definition at line 81 of file em_ebi.h.

Referenced by EBI_ChipSelectEnable().

#define EBI_CS2   (uint32_t)(1 << 3)

EBI chip select line 2

Definition at line 82 of file em_ebi.h.

Referenced by EBI_ChipSelectEnable().

#define EBI_CS3   (uint32_t)(1 << 4)

EBI chip select line 3

Definition at line 83 of file em_ebi.h.

Referenced by EBI_ChipSelectEnable().

#define EBI_INIT_DEFAULT

Default config for EBI init structures

Definition at line 390 of file em_ebi.h.

#define EBI_TFTINIT_DEFAULT
Value:
{ \
ebiTFTBank0, /* Select EBI Bank 0 */ \
ebiTFTWidthHalfWord, /* Select 2-byte increments */ \
ebiTFTColorSrcMem, /* Use memory as source for mask/blending */ \
ebiTFTInterleaveUnlimited, /* Unlimited interleaved accesses */ \
ebiTFTFrameBufTriggerVSync, /* VSYNC as frame buffer update trigger */ \
false, /* Drive DCLK from negative edge of internal clock */ \
ebiTFTMBDisabled, /* No masking and alpha blending enabled */ \
ebiTFTDDModeExternal, /* Drive from external memory */ \
ebiActiveLow, /* CS Active Low polarity */ \
ebiActiveLow, /* DCLK Active Low polarity */ \
ebiActiveLow, /* DATAEN Active Low polarity */ \
ebiActiveLow, /* HSYNC Active Low polarity */ \
ebiActiveLow, /* VSYNC Active Low polarity */ \
320, /* Horizontal size in pixels */ \
1, /* Horizontal Front Porch */ \
29, /* Horizontal Back Porch */ \
2, /* Horizontal Synchronization Pulse Width */ \
240, /* Vertical size in pixels */ \
1, /* Vertical Front Porch */ \
4, /* Vertical Back Porch */ \
2, /* Vertical Synchronization Pulse Width */ \
0x0000, /* Address offset to EBI memory base */ \
5, /* DCLK Period */ \
2, /* DCLK Start */ \
1, /* DCLK Setup cycles */ \
1, /* DCLK Hold cycles */ \
}

Default configuration for EBI TFT init structure

Definition at line 509 of file em_ebi.h.

Enumeration Type Documentation

Adress Pin Enable, high limit - higher limit of pins to enable

Enumerator
ebiAHighA0 

All EBI_A pins are disabled

ebiAHighA5 

All EBI_A[4:ALow] are enabled

ebiAHighA6 

All EBI_A[5:ALow] are enabled

ebiAHighA7 

All EBI_A[6:ALow] are enabled

ebiAHighA8 

All EBI_A[7:ALow] are enabled

ebiAHighA9 

All EBI_A[8:ALow] are enabled

ebiAHighA10 

All EBI_A[9:ALow] are enabled

ebiAHighA11 

All EBI_A[10:ALow] are enabled

ebiAHighA12 

All EBI_A[11:ALow] are enabled

ebiAHighA13 

All EBI_A[12:ALow] are enabled

ebiAHighA14 

All EBI_A[13:ALow] are enabled

ebiAHighA15 

All EBI_A[14:ALow] are enabled

ebiAHighA16 

All EBI_A[15:ALow] are enabled

ebiAHighA17 

All EBI_A[16:ALow] are enabled

ebiAHighA18 

All EBI_A[17:ALow] are enabled

ebiAHighA19 

All EBI_A[18:ALow] are enabled

ebiAHighA20 

All EBI_A[19:ALow] are enabled

ebiAHighA21 

All EBI_A[20:ALow] are enabled

ebiAHighA22 

All EBI_A[21:ALow] are enabled

ebiAHighA23 

All EBI_A[22:ALow] are enabled

ebiAHighA24 

All EBI_A[23:ALow] are enabled

ebiAHighA25 

All EBI_A[24:ALow] are enabled

ebiAHighA26 

All EBI_A[25:ALow] are enabled

ebiAHighA27 

All EBI_A[26:ALow] are enabled

ebiAHighA28 

All EBI_A[27:ALow] are enabled

Definition at line 159 of file em_ebi.h.

Address Pin Enable, lower limit - lower range of pins to enable

Enumerator
ebiALowA0 

Adress lines EBI_A[0] and upwards are enabled by APEN

ebiALowA8 

Adress lines EBI_A[8] and upwards are enabled by APEN

ebiALowA16 

Adress lines EBI_A[16] and upwards are enabled by APEN

ebiALowA24 

Adress lines EBI_A[24] and upwards are enabled by APEN

Definition at line 146 of file em_ebi.h.

EBI Pin Line types

Enumerator
ebiLineARDY 

Address Ready line

ebiLineALE 

Address Latch Enable line

ebiLineWE 

Write Enable line

ebiLineRE 

Read Enable line

ebiLineCS 

Chip Select line

ebiLineBL 

BL line

ebiLineTFTVSync 

TFT VSYNC line

ebiLineTFTHSync 

TFT HSYNC line

ebiLineTFTDataEn 

TFT Data enable line

ebiLineTFTDClk 

TFT DCLK line

ebiLineTFTCS 

TFT Chip select line

Definition at line 114 of file em_ebi.h.

EBI I/O Alternate Pin Location

Enumerator
ebiLocation0 

EBI PIN I/O Location 0

ebiLocation1 

EBI PIN I/O Location 1

ebiLocation2 

EBI PIN I/O Location 2

Definition at line 214 of file em_ebi.h.

EBI Mode of operation

Enumerator
ebiModeD8A8 

8 data bits, 8 address bits

ebiModeD16A16ALE 

16 data bits, 16 address bits, using address latch enable

ebiModeD8A24ALE 

8 data bits, 24 address bits, using address latch enable

ebiModeD16 

Mode D16

Definition at line 90 of file em_ebi.h.

EBI Polarity configuration

Enumerator
ebiActiveLow 

Active Low

ebiActiveHigh 

Active High

Definition at line 105 of file em_ebi.h.

EBI TFT Graphics Bank Select

Enumerator
ebiTFTBank0 

Memory BANK0 contains frame buffer

ebiTFTBank1 

Memory BANK1 contains frame buffer

ebiTFTBank2 

Memory BANK2 contains frame buffer

ebiTFTBank3 

Memory BANK3 contains frame buffer

Definition at line 227 of file em_ebi.h.

Masking and Alpha blending source color

Enumerator
ebiTFTColorSrcMem 

Use memory as source color for masking/alpha blending

ebiTFTColorSrcPixel1 

Use PIXEL1 register as source color for masking/alpha blending

Definition at line 240 of file em_ebi.h.

TFT Direct Drive mode

Enumerator
ebiTFTDDModeDisabled 

Disabled

ebiTFTDDModeInternal 

Direct Drive from internal memory

ebiTFTDDModeExternal 

Direct Drive from external memory

Definition at line 288 of file em_ebi.h.

Control frame base pointer copy

Enumerator
ebiTFTFrameBufTriggerVSync 

Trigger update of frame buffer pointer on vertical sync

ebiTFTFrameBufTriggerHSync 

Trigger update of frame buffer pointer on horizontal sync

Definition at line 260 of file em_ebi.h.

Bus Data Interleave Mode

Enumerator
ebiTFTInterleaveUnlimited 

Unlimited interleaved accesses per EBI_DCLK period. Can cause jitter

ebiTFTInterleaveOnePerDClk 

Allow 1 interleaved access per EBI_DCLK period

ebiTFTInterleavePorch 

Only allow accesses during porch periods

Definition at line 249 of file em_ebi.h.

Control of mask and alpha blending mode

Enumerator
ebiTFTMBDisabled 

Masking and blending are disabled

ebiTFTMBIMask 

Internal masking

ebiTFTMBIAlpha 

Internal alpha blending

ebiTFTMBIMaskAlpha 

Internal masking and alpha blending are enabled

ebiTFTMBEMask 

External masking

ebiTFTMBEAlpha 

External alpha blending

ebiTFTMBEMaskAlpha 

External masking and alpha blending

Definition at line 269 of file em_ebi.h.

TFT Data Increment Width

Enumerator
ebiTFTWidthByte 

Pixel increments are 1 byte at a time

ebiTFTWidthHalfWord 

Pixel increments are 2 bytes (half word)

Definition at line 299 of file em_ebi.h.

Function Documentation

void EBI_AddressTimingSet ( int  setupCycles,
int  holdCycles 
)

Configure timing values of address latch bus accesses.

Parameters
[in]setupCyclesSets the number of cycles the address is held after ALE is asserted
[in]holdCyclesSets the number of cycles the address is driven onto the ADDRDAT bus before ALE is asserted. If set 0, 1 cycle is inserted by HW

Definition at line 547 of file em_ebi.c.

References _EBI_ADDRTIMING_ADDRHOLD_MASK, _EBI_ADDRTIMING_ADDRHOLD_SHIFT, _EBI_ADDRTIMING_ADDRSETUP_MASK, _EBI_ADDRTIMING_ADDRSETUP_SHIFT, and EBI.

Referenced by EBI_Init().

void EBI_AltMapEnable ( bool  enable)

Configure Alternate Address Map support Enables or disables 256MB address range for all banks.

Parameters
[in]enableSet or clear address map extension

Definition at line 1181 of file em_ebi.c.

References _EBI_CTRL_ALTMAP_SHIFT, BUS_RegBitWrite(), and EBI.

uint32_t EBI_BankAddress ( uint32_t  bank)

Return base address of EBI bank.

Parameters
[in]bankBank to return start address for
Returns
Absolute address of bank

Definition at line 330 of file em_ebi.c.

References EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, EBI_BANK3, EBI_CTRL_ALTMAP, and EBI_MEM_BASE.

Referenced by TFT_DirectInit().

void EBI_BankAddressTimingConfig ( uint32_t  banks,
bool  halfALE 
)

Configure address operation parameters for selected bank.

Parameters
[in]banksMask of memory bank(s) to configure write timing for
[in]halfALEEnables or disables half cycle ALE strobe in last strobe cycle

Definition at line 956 of file em_ebi.c.

References _EBI_ADDRTIMING_HALFALE_SHIFT, BUS_RegBitWrite(), EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

Referenced by EBI_Init().

void EBI_BankAddressTimingSet ( uint32_t  banks,
int  setupCycles,
int  holdCycles 
)

Configure timing values of address latch bus accesses.

Parameters
[in]banksMask of memory bank(s) to configure address timing for
[in]setupCyclesSets the number of cycles the address is held after ALE is asserted
[in]holdCyclesSets the number of cycles the address is driven onto the ADDRDAT bus before ALE is asserted. If set 0, 1 cycle is inserted by HW

Definition at line 994 of file em_ebi.c.

References _EBI_ADDRTIMING1_ADDRHOLD_MASK, _EBI_ADDRTIMING1_ADDRSETUP_MASK, _EBI_ADDRTIMING2_ADDRHOLD_MASK, _EBI_ADDRTIMING2_ADDRSETUP_MASK, _EBI_ADDRTIMING3_ADDRHOLD_MASK, _EBI_ADDRTIMING3_ADDRSETUP_MASK, _EBI_ADDRTIMING_ADDRHOLD_MASK, _EBI_ADDRTIMING_ADDRHOLD_SHIFT, _EBI_ADDRTIMING_ADDRSETUP_MASK, _EBI_ADDRTIMING_ADDRSETUP_SHIFT, EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

Referenced by EBI_Init().

void EBI_BankByteLaneEnable ( uint32_t  banks,
bool  enable 
)

Configure Byte Lane Enable for select banks timing support.

Parameters
[in]banksMask of memory bank(s) to configure polarity for
[in]enableFlag

Definition at line 1148 of file em_ebi.c.

References _EBI_CTRL_BL1_SHIFT, _EBI_CTRL_BL2_SHIFT, _EBI_CTRL_BL3_SHIFT, _EBI_CTRL_BL_SHIFT, BUS_RegBitWrite(), EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

void EBI_BankEnable ( uint32_t  banks,
bool  enable 
)

Enable or disable EBI Bank.

Parameters
[in]banksBanks to reconfigure, mask of EBI_BANK<n> flags
[in]enableTrue to enable, false to disable

Definition at line 299 of file em_ebi.c.

References _EBI_CTRL_BANK0EN_SHIFT, _EBI_CTRL_BANK1EN_SHIFT, _EBI_CTRL_BANK2EN_SHIFT, _EBI_CTRL_BANK3EN_SHIFT, BUS_RegBitWrite(), EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

void EBI_BankPolaritySet ( uint32_t  banks,
EBI_Line_TypeDef  line,
EBI_Polarity_TypeDef  polarity 
)

Configure EBI pin polarity for selected bank(s) for devices with individual timing support.

Parameters
[in]banksMask of memory bank(s) to configure polarity for
[in]lineWhich pin/line to configure
[in]polarityActive high, or active low

Definition at line 1054 of file em_ebi.c.

References _EBI_POLARITY_ALEPOL_SHIFT, _EBI_POLARITY_ARDYPOL_SHIFT, _EBI_POLARITY_BLPOL_SHIFT, _EBI_POLARITY_CSPOL_SHIFT, _EBI_POLARITY_REPOL_SHIFT, _EBI_POLARITY_WEPOL_SHIFT, _EBI_TFTPOLARITY_CSPOL_SHIFT, _EBI_TFTPOLARITY_DATAENPOL_SHIFT, _EBI_TFTPOLARITY_DCLKPOL_SHIFT, _EBI_TFTPOLARITY_HSYNCPOL_SHIFT, _EBI_TFTPOLARITY_VSYNCPOL_SHIFT, BUS_RegBitWrite(), EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, EBI_BANK3, ebiLineALE, ebiLineARDY, ebiLineBL, ebiLineCS, ebiLineRE, ebiLineTFTCS, ebiLineTFTDataEn, ebiLineTFTDClk, ebiLineTFTHSync, ebiLineTFTVSync, and ebiLineWE.

Referenced by EBI_Init().

void EBI_BankReadTimingConfig ( uint32_t  banks,
bool  pageMode,
bool  prefetch,
bool  halfRE 
)

Configure read operation parameters for selected bank.

Parameters
[in]banksMask of memory bank(s) to configure write timing for
[in]pageModeEnables or disables half cycle WE strobe in last strobe cycle
[in]prefetchEnables or disables half cycle WE strobe in last strobe cycle
[in]halfREEnables or disables half cycle WE strobe in last strobe cycle

Definition at line 735 of file em_ebi.c.

References _EBI_RDTIMING_HALFRE_SHIFT, _EBI_RDTIMING_PAGEMODE_SHIFT, _EBI_RDTIMING_PREFETCH_SHIFT, BUS_RegBitWrite(), EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

Referenced by EBI_Init().

void EBI_BankReadTimingSet ( uint32_t  banks,
int  setupCycles,
int  strobeCycles,
int  holdCycles 
)

Configure timing values of read bus accesses.

Parameters
[in]banksMask of memory bank(s) to configure timing for
[in]setupCyclesNumber of clock cycles for address setup before REn is asserted
[in]strobeCyclesThe number of cycles the REn is held active. After the specified number of cycles, data is read. If set to 0, 1 cycle is inserted by HW
[in]holdCyclesThe number of cycles CSn is held active after the REn is dessarted

Definition at line 784 of file em_ebi.c.

References _EBI_RDTIMING1_RDHOLD_MASK, _EBI_RDTIMING1_RDSETUP_MASK, _EBI_RDTIMING1_RDSTRB_MASK, _EBI_RDTIMING2_RDHOLD_MASK, _EBI_RDTIMING2_RDSETUP_MASK, _EBI_RDTIMING2_RDSTRB_MASK, _EBI_RDTIMING3_RDHOLD_MASK, _EBI_RDTIMING3_RDSETUP_MASK, _EBI_RDTIMING3_RDSTRB_MASK, _EBI_RDTIMING_RDHOLD_MASK, _EBI_RDTIMING_RDHOLD_SHIFT, _EBI_RDTIMING_RDSETUP_MASK, _EBI_RDTIMING_RDSETUP_SHIFT, _EBI_RDTIMING_RDSTRB_MASK, _EBI_RDTIMING_RDSTRB_SHIFT, EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

Referenced by EBI_Init().

void EBI_BankWriteTimingConfig ( uint32_t  banks,
bool  writeBufDisable,
bool  halfWE 
)

Configure write operation parameters for selected bank.

Parameters
[in]banksMask of memory bank(s) to configure write timing for
[in]writeBufDisableIf true, disable the write buffer
[in]halfWEEnables or disables half cycle WE strobe in last strobe cycle

Definition at line 849 of file em_ebi.c.

References _EBI_WRTIMING_HALFWE_SHIFT, _EBI_WRTIMING_WBUFDIS_SHIFT, BUS_RegBitWrite(), EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

Referenced by EBI_Init().

void EBI_BankWriteTimingSet ( uint32_t  banks,
int  setupCycles,
int  strobeCycles,
int  holdCycles 
)

Configure timing values of write bus accesses.

Parameters
[in]banksMask of memory bank(s) to configure write timing for
[in]setupCyclesNumber of clock cycles for address setup before WEn is asserted
[in]strobeCyclesNumber of cycles WEn is held active. If set to 0, 1 cycle is inserted by HW
[in]holdCyclesNumber of cycles CSn is held active after the WEn is deasserted

Definition at line 894 of file em_ebi.c.

References _EBI_WRTIMING1_WRHOLD_MASK, _EBI_WRTIMING1_WRSETUP_MASK, _EBI_WRTIMING1_WRSTRB_MASK, _EBI_WRTIMING2_WRHOLD_MASK, _EBI_WRTIMING2_WRSETUP_MASK, _EBI_WRTIMING2_WRSTRB_MASK, _EBI_WRTIMING3_WRHOLD_MASK, _EBI_WRTIMING3_WRSETUP_MASK, _EBI_WRTIMING3_WRSTRB_MASK, _EBI_WRTIMING_WRHOLD_MASK, _EBI_WRTIMING_WRHOLD_SHIFT, _EBI_WRTIMING_WRSETUP_MASK, _EBI_WRTIMING_WRSETUP_SHIFT, _EBI_WRTIMING_WRSTRB_MASK, _EBI_WRTIMING_WRSTRB_SHIFT, EBI, EBI_BANK0, EBI_BANK1, EBI_BANK2, and EBI_BANK3.

Referenced by EBI_Init().

void EBI_ChipSelectEnable ( uint32_t  cs,
bool  enable 
)

Enable or disable EBI Chip Select.

Parameters
[in]csChipSelect lines to reconfigure, mask of EBI_CS<n> flags
[in]enableTrue to enable, false to disable

Definition at line 387 of file em_ebi.c.

References _EBI_ROUTE_CS0PEN_SHIFT, _EBI_ROUTE_CS1PEN_SHIFT, _EBI_ROUTE_CS2PEN_SHIFT, _EBI_ROUTE_CS3PEN_SHIFT, BUS_RegBitWrite(), EBI, EBI_CS0, EBI_CS1, EBI_CS2, and EBI_CS3.

Referenced by EBI_Init().

void EBI_Init ( const EBI_Init_TypeDef ebiInit)

Configure and enable External Bus Interface.

Parameters
[in]ebiInitEBI configuration structure
Note
GPIO lines must be configured as PUSH_PULL for correct operation GPIO and EBI clocks must be enabled in the CMU

Definition at line 64 of file em_ebi.c.

References _EBI_CTRL_ARDY1EN_MASK, _EBI_CTRL_ARDY1EN_SHIFT, _EBI_CTRL_ARDY2EN_MASK, _EBI_CTRL_ARDY2EN_SHIFT, _EBI_CTRL_ARDY3EN_MASK, _EBI_CTRL_ARDY3EN_SHIFT, _EBI_CTRL_ARDYEN_MASK, _EBI_CTRL_ARDYEN_SHIFT, _EBI_CTRL_ARDYTO1DIS_MASK, _EBI_CTRL_ARDYTO1DIS_SHIFT, _EBI_CTRL_ARDYTO2DIS_MASK, _EBI_CTRL_ARDYTO2DIS_SHIFT, _EBI_CTRL_ARDYTO3DIS_MASK, _EBI_CTRL_ARDYTO3DIS_SHIFT, _EBI_CTRL_ARDYTODIS_MASK, _EBI_CTRL_ARDYTODIS_SHIFT, _EBI_CTRL_BANK0EN_MASK, _EBI_CTRL_BANK1EN_MASK, _EBI_CTRL_BANK2EN_MASK, _EBI_CTRL_BANK3EN_MASK, _EBI_CTRL_BL1_MASK, _EBI_CTRL_BL1_SHIFT, _EBI_CTRL_BL2_MASK, _EBI_CTRL_BL2_SHIFT, _EBI_CTRL_BL3_MASK, _EBI_CTRL_BL3_SHIFT, _EBI_CTRL_BL_MASK, _EBI_CTRL_BL_SHIFT, _EBI_CTRL_MODE1_MASK, _EBI_CTRL_MODE1_SHIFT, _EBI_CTRL_MODE2_MASK, _EBI_CTRL_MODE2_SHIFT, _EBI_CTRL_MODE3_MASK, _EBI_CTRL_MODE3_SHIFT, _EBI_CTRL_MODE_MASK, _EBI_CTRL_MODE_SHIFT, _EBI_CTRL_NOIDLE1_MASK, _EBI_CTRL_NOIDLE1_SHIFT, _EBI_CTRL_NOIDLE2_MASK, _EBI_CTRL_NOIDLE2_SHIFT, _EBI_CTRL_NOIDLE3_MASK, _EBI_CTRL_NOIDLE3_SHIFT, _EBI_CTRL_NOIDLE_MASK, _EBI_CTRL_NOIDLE_SHIFT, _EBI_ROUTE_ALB_MASK, _EBI_ROUTE_ALEPEN_SHIFT, _EBI_ROUTE_APEN_MASK, _EBI_ROUTE_BLPEN_SHIFT, _EBI_ROUTE_EBIPEN_SHIFT, _EBI_ROUTE_LOCATION_MASK, EBI_Init_TypeDef::addrHalfALE, EBI_Init_TypeDef::addrHoldCycles, EBI_Init_TypeDef::addrSetupCycles, EBI_Init_TypeDef::aHigh, EBI_Init_TypeDef::alePolarity, EBI_Init_TypeDef::aLow, EBI_Init_TypeDef::ardyDisableTimeout, EBI_Init_TypeDef::ardyEnable, EBI_Init_TypeDef::ardyPolarity, EBI_Init_TypeDef::banks, EBI_Init_TypeDef::blEnable, EBI_Init_TypeDef::blPolarity, BUS_RegBitWrite(), EBI_Init_TypeDef::csLines, EBI_Init_TypeDef::csPolarity, EBI, EBI_AddressTimingSet(), EBI_BANK0, EBI_BANK1, EBI_BANK2, EBI_BANK3, EBI_BankAddressTimingConfig(), EBI_BankAddressTimingSet(), EBI_BankPolaritySet(), EBI_BankReadTimingConfig(), EBI_BankReadTimingSet(), EBI_BankWriteTimingConfig(), EBI_BankWriteTimingSet(), EBI_ChipSelectEnable(), EBI_CTRL_BANK0EN, EBI_CTRL_BANK1EN, EBI_CTRL_BANK2EN, EBI_CTRL_BANK3EN, EBI_CTRL_ITS, EBI_PolaritySet(), EBI_ReadTimingSet(), EBI_WriteTimingSet(), ebiLineALE, ebiLineARDY, ebiLineBL, ebiLineCS, ebiLineRE, ebiLineWE, ebiModeD16, ebiModeD16A16ALE, ebiModeD8A24ALE, ebiModeD8A8, EBI_Init_TypeDef::enable, EBI_Init_TypeDef::location, EBI_Init_TypeDef::mode, EBI_Init_TypeDef::noIdle, EBI_Init_TypeDef::readHalfRE, EBI_Init_TypeDef::readHoldCycles, EBI_Init_TypeDef::readPageMode, EBI_Init_TypeDef::readPrefetch, EBI_Init_TypeDef::readSetupCycles, EBI_Init_TypeDef::readStrobeCycles, EBI_Init_TypeDef::rePolarity, EBI_Init_TypeDef::wePolarity, EBI_Init_TypeDef::writeBufferDisable, EBI_Init_TypeDef::writeHalfWE, EBI_Init_TypeDef::writeHoldCycles, EBI_Init_TypeDef::writeSetupCycles, and EBI_Init_TypeDef::writeStrobeCycles.

Referenced by BSP_EbiInit().

__STATIC_INLINE void EBI_IntClear ( uint32_t  flags)

Clear one or more pending EBI interrupts.

Parameters
[in]flagsPending EBI interrupt source to clear. Use a logical OR combination of valid interrupt flags for the EBI module (EBI_IF_nnn).

Definition at line 717 of file em_ebi.h.

References EBI.

__STATIC_INLINE void EBI_IntDisable ( uint32_t  flags)

Disable one or more EBI interrupts.

Parameters
[in]flagsEBI interrupt sources to disable. Use logical OR combination of valid interrupt flags for the EBI module (EBI_IF_nnn)

Definition at line 745 of file em_ebi.h.

References EBI.

__STATIC_INLINE void EBI_IntEnable ( uint32_t  flags)

Enable one or more EBI interrupts.

Parameters
[in]flagsEBI interrupt sources to enable. Use logical OR combination of valid interrupt flags for the EBI module (EBI_IF_nnn)

Definition at line 759 of file em_ebi.h.

References EBI.

__STATIC_INLINE uint32_t EBI_IntGet ( void  )

Get pending EBI interrupt flags.

Note
The event bits are not cleared by the use of this function
Returns
EBI interrupt sources pending, a logical combination of valid EBI interrupt flags, EBI_IF_nnn

Definition at line 776 of file em_ebi.h.

References EBI.

__STATIC_INLINE uint32_t EBI_IntGetEnabled ( void  )

Get enabled and pending EBI interrupt flags. Useful for handling more interrupt sources in the same interrupt handler.

Note
Interrupt flags are not cleared by the use of this function.
Returns
Pending and enabled EBI interrupt sources The return value is the bitwise AND of
  • the enabled interrupt sources in EBI_IEN and
  • the pending interrupt flags EBI_IF

Definition at line 796 of file em_ebi.h.

References EBI.

__STATIC_INLINE void EBI_IntSet ( uint32_t  flags)

Set one or more pending EBI interrupts.

Parameters
[in]flagsEBI interrupt sources to set to pending. Use a logical OR combination of valid interrupt flags for the EBI module (EBI_IF_nnn).

Definition at line 731 of file em_ebi.h.

References EBI.

void EBI_ReadTimingSet ( int  setupCycles,
int  strobeCycles,
int  holdCycles 
)

Configure timing values of read bus accesses.

Parameters
[in]setupCyclesNumber of clock cycles for address setup before REn is asserted
[in]strobeCyclesThe number of cycles the REn is held active. After the specified number of cycles, data is read. If set to 0, 1 cycle is inserted by HW
[in]holdCyclesThe number of cycles CSn is held active after the REn is dessarted

Definition at line 478 of file em_ebi.c.

References _EBI_RDTIMING_RDHOLD_MASK, _EBI_RDTIMING_RDHOLD_SHIFT, _EBI_RDTIMING_RDSETUP_MASK, _EBI_RDTIMING_RDSETUP_SHIFT, _EBI_RDTIMING_RDSTRB_MASK, _EBI_RDTIMING_RDSTRB_SHIFT, and EBI.

Referenced by EBI_Init().

__STATIC_INLINE uint32_t EBI_StopNandEccGen ( void  )

Stop NAND flash ECC generator and return generated ECC.

Returns
The generated ECC.

Definition at line 822 of file em_ebi.h.

References EBI, and EBI_CMD_ECCSTOP.

Referenced by NANDFLASH_ReadPage(), and NANDFLASH_WritePage().

__STATIC_INLINE void EBI_TFTAlphaBlendSet ( uint8_t  alpha)

Set TFT Alpha Blending Factor.

Parameters
[in]alpha8-bit value indicating blending factor

Definition at line 639 of file em_ebi.h.

References EBI.

__STATIC_INLINE void EBI_TFTEnable ( EBI_TFTDDMode_TypeDef  mode)

Enable or disable TFT Direct Drive.

Parameters
[in]modeDrive from Internal or External memory, or Disable Direct Drive

Definition at line 579 of file em_ebi.h.

References _EBI_TFTCTRL_DD_MASK, and EBI.

__STATIC_INLINE void EBI_TFTFBTriggerSet ( EBI_TFTFrameBufTrigger_TypeDef  sync)

Set Frame Buffer Trigger.

Frame buffer pointer will be updated either on each horizontal line (hsync) or vertical update (vsync).

Parameters
[in]syncTrigger update of frame buffer pointer on vertical or horisontal sync.

Definition at line 688 of file em_ebi.h.

References _EBI_TFTCTRL_FBCTRIG_MASK, and EBI.

__STATIC_INLINE void EBI_TFTFrameBaseSet ( uint32_t  address)

Configure frame buffer pointer.

Parameters
[in]addressFrame pointer address, as offset by EBI base address

Definition at line 592 of file em_ebi.h.

References EBI.

Referenced by EBI_TFTInit().

__STATIC_INLINE uint32_t EBI_TFTHCount ( void  )

Get current horizontal position counter.

Returns
Returns the current horizontal pixel position within a visible line

Definition at line 672 of file em_ebi.h.

References _EBI_TFTSTATUS_HCNT_MASK, _EBI_TFTSTATUS_HCNT_SHIFT, and EBI.

void EBI_TFTHPorchSet ( int  front,
int  back,
int  pulseWidth 
)

Configure and initialize Horizontal Porch Settings.

Parameters
[in]frontHorizontal front porch size in pixels
[in]backHorizontal back porch size in pixels
[in]pulseWidthHorizontal synchronization pulse width. Set to required -1.

Definition at line 653 of file em_ebi.c.

References _EBI_TFTHPORCH_HBPORCH_SHIFT, _EBI_TFTHPORCH_HFPORCH_SHIFT, _EBI_TFTHPORCH_HSYNC_SHIFT, and EBI.

Referenced by EBI_TFTInit().

__STATIC_INLINE void EBI_TFTHStrideSet ( uint32_t  nbytes)

Set horizontal TFT stride value in number of bytes.

Parameters
[in]nbytesNumber of bytes to add to frame buffer pointer after each horizontal line update

Definition at line 701 of file em_ebi.h.

References _EBI_TFTSTRIDE_HSTRIDE_MASK, _EBI_TFTSTRIDE_HSTRIDE_SHIFT, and EBI.

__STATIC_INLINE void EBI_TFTMaskBlendMode ( EBI_TFTMaskBlend_TypeDef  maskBlend)

Masking and Blending Mode Set.

Parameters
[in]maskBlendMasking and alpha blending mode

Definition at line 627 of file em_ebi.h.

References _EBI_TFTCTRL_MASKBLEND_MASK, and EBI.

__STATIC_INLINE void EBI_TFTMaskSet ( uint32_t  mask)

Set TFT mask value Data accesses that matches this value are suppressed.

Parameters
[in]mask

Definition at line 650 of file em_ebi.h.

References EBI.

__STATIC_INLINE void EBI_TFTPixelSet ( int  pixel,
uint32_t  color 
)

Set TFT Pixel Color 0 or 1.

Parameters
[in]pixelWhich pixel instance to set
[in]colorColor of pixel, 16-bit value

Definition at line 606 of file em_ebi.h.

References EBI.

void EBI_TFTSizeSet ( uint32_t  horizontal,
uint32_t  vertical 
)

Configure and initialize TFT size settings.

Parameters
[in]horizontalTFT display horizontal size in pixels
[in]verticalTFT display vertical size in pixels

Definition at line 633 of file em_ebi.c.

References _EBI_TFTSIZE_HSZ_SHIFT, _EBI_TFTSIZE_VSZ_SHIFT, and EBI.

Referenced by EBI_TFTInit().

void EBI_TFTTimingSet ( int  dclkPeriod,
int  start,
int  setup,
int  hold 
)

Configure TFT Direct Drive Timing Settings.

Parameters
[in]dclkPeriodDCLK period in internal cycles
[in]startStarting position of external direct drive, relative to DCLK inactive edge
[in]setupNumber of cycles RGB data is driven before active edge of DCLK
[in]holdNumber of cycles RGB data is held after active edge of DCLK

Definition at line 704 of file em_ebi.c.

References _EBI_TFTTIMING_DCLKPERIOD_SHIFT, _EBI_TFTTIMING_TFTHOLD_SHIFT, _EBI_TFTTIMING_TFTSETUP_SHIFT, _EBI_TFTTIMING_TFTSTART_SHIFT, and EBI.

Referenced by EBI_TFTInit().

__STATIC_INLINE uint32_t EBI_TFTVCount ( void  )

Get current vertical position counter.

Returns
Returns the current line position for the visible part of a frame

Definition at line 661 of file em_ebi.h.

References _EBI_TFTSTATUS_VCNT_MASK, _EBI_TFTSTATUS_VCNT_SHIFT, and EBI.

void EBI_TFTVPorchSet ( int  front,
int  back,
int  pulseWidth 
)

Configure Vertical Porch Settings.

Parameters
[in]frontVertical front porch size in pixels
[in]backVertical back porch size in pixels
[in]pulseWidthVertical synchronization pulse width. Set to required -1.

Definition at line 676 of file em_ebi.c.

References _EBI_TFTVPORCH_VBPORCH_SHIFT, _EBI_TFTVPORCH_VFPORCH_SHIFT, _EBI_TFTVPORCH_VSYNC_SHIFT, and EBI.

Referenced by EBI_TFTInit().

void EBI_WriteTimingSet ( int  setupCycles,
int  strobeCycles,
int  holdCycles 
)

Configure timing values of write bus accesses.

Parameters
[in]setupCyclesNumber of clock cycles for address setup before WEn is asserted
[in]strobeCyclesNumber of cycles WEn is held active. If set to 0, 1 cycle is inserted by HW
[in]holdCyclesNumber of cycles CSn is held active after the WEn is deasserted

Definition at line 514 of file em_ebi.c.

References _EBI_WRTIMING_WRHOLD_MASK, _EBI_WRTIMING_WRHOLD_SHIFT, _EBI_WRTIMING_WRSETUP_MASK, _EBI_WRTIMING_WRSETUP_SHIFT, _EBI_WRTIMING_WRSTRB_MASK, _EBI_WRTIMING_WRSTRB_SHIFT, and EBI.

Referenced by EBI_Init().