Stepan Snigirev / BSP_DISCO_F469NI

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Embed: (wiki syntax)

« Back to documentation index

STM32469I Discovery LCD Exported Functions
Functions

STM32469I Discovery LCD Exported Functions
[STM32469I Discovery LCD]

Functions

uint8_t BSP_LCD_Init (void)
 Initializes the DSI LCD.
uint8_t BSP_LCD_InitEx (LCD_OrientationTypeDef orientation)
 Initializes the DSI LCD.
void BSP_LCD_Reset (void)
 BSP LCD Reset Hw reset the LCD DSI activating its XRES signal (active low for some time) and desactivating it later.
uint32_t BSP_LCD_GetXSize (void)
 Gets the LCD X size.
uint32_t BSP_LCD_GetYSize (void)
 Gets the LCD Y size.
void BSP_LCD_SetXSize (uint32_t imageWidthPixels)
 Set the LCD X size.
void BSP_LCD_SetYSize (uint32_t imageHeightPixels)
 Set the LCD Y size.
void BSP_LCD_LayerDefaultInit (uint16_t LayerIndex, uint32_t FB_Address)
 Initializes the LCD layers.
void BSP_LCD_SelectLayer (uint32_t LayerIndex)
 Selects the LCD Layer.
void BSP_LCD_SetLayerVisible (uint32_t LayerIndex, FunctionalState State)
 Sets an LCD Layer visible.
void BSP_LCD_SetTransparency (uint32_t LayerIndex, uint8_t Transparency)
 Configures the transparency.
void BSP_LCD_SetLayerAddress (uint32_t LayerIndex, uint32_t Address)
 Sets an LCD layer frame buffer address.
void BSP_LCD_SetLayerWindow (uint16_t LayerIndex, uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height)
 Sets display window.
void BSP_LCD_SetColorKeying (uint32_t LayerIndex, uint32_t RGBValue)
 Configures and sets the color keying.
void BSP_LCD_ResetColorKeying (uint32_t LayerIndex)
 Disables the color keying.
void BSP_LCD_SetTextColor (uint32_t Color)
 Sets the LCD text color.
uint32_t BSP_LCD_GetTextColor (void)
 Gets the LCD text color.
void BSP_LCD_SetBackColor (uint32_t Color)
 Sets the LCD background color.
uint32_t BSP_LCD_GetBackColor (void)
 Gets the LCD background color.
void BSP_LCD_SetFont (sFONT *fonts)
 Sets the LCD text font.
sFONT * BSP_LCD_GetFont (void)
 Gets the LCD text font.
uint32_t BSP_LCD_ReadPixel (uint16_t Xpos, uint16_t Ypos)
 Reads an LCD pixel.
void BSP_LCD_Clear (uint32_t Color)
 Clears the whole currently active layer of LTDC.
void BSP_LCD_ClearStringLine (uint32_t Line)
 Clears the selected line in currently active layer.
void BSP_LCD_DisplayChar (uint16_t Xpos, uint16_t Ypos, uint8_t Ascii)
 Displays one character in currently active layer.
void BSP_LCD_DisplayStringAt (uint16_t Xpos, uint16_t Ypos, uint8_t *Text, Text_AlignModeTypdef Mode)
 Displays characters in currently active layer.
void BSP_LCD_DisplayStringAtLine (uint16_t Line, uint8_t *ptr)
 Displays a maximum of 60 characters on the LCD.
void BSP_LCD_DrawHLine (uint16_t Xpos, uint16_t Ypos, uint16_t Length)
 Draws an horizontal line in currently active layer.
void BSP_LCD_DrawVLine (uint16_t Xpos, uint16_t Ypos, uint16_t Length)
 Draws a vertical line in currently active layer.
void BSP_LCD_DrawLine (uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2)
 Draws an uni-line (between two points) in currently active layer.
void BSP_LCD_DrawRect (uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height)
 Draws a rectangle in currently active layer.
void BSP_LCD_DrawCircle (uint16_t Xpos, uint16_t Ypos, uint16_t Radius)
 Draws a circle in currently active layer.
void BSP_LCD_DrawPolygon (pPoint Points, uint16_t PointCount)
 Draws an poly-line (between many points) in currently active layer.
void BSP_LCD_DrawEllipse (int Xpos, int Ypos, int XRadius, int YRadius)
 Draws an ellipse on LCD in currently active layer.
void BSP_LCD_DrawBitmap (uint32_t Xpos, uint32_t Ypos, uint8_t *pbmp)
 Draws a bitmap picture loaded in the internal Flash (32 bpp) in currently active layer.
void BSP_LCD_FillRect (uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height)
 Draws a full rectangle in currently active layer.
void BSP_LCD_FillCircle (uint16_t Xpos, uint16_t Ypos, uint16_t Radius)
 Draws a full circle in currently active layer.
void BSP_LCD_FillPolygon (pPoint Points, uint16_t PointCount)
 Draws a full poly-line (between many points) in currently active layer.
void BSP_LCD_FillEllipse (int Xpos, int Ypos, int XRadius, int YRadius)
 Draws a full ellipse in currently active layer.
void BSP_LCD_DisplayOn (void)
 Switch back on the display if was switched off by previous call of BSP_LCD_DisplayOff().
void BSP_LCD_DisplayOff (void)
 Switch Off the display.
void DSI_IO_WriteCmd (uint32_t NbrParams, uint8_t *pParams)
 DCS or Generic short/long write command.
__weak void BSP_LCD_DMA2D_IRQHandler (void)
 Handles DMA2D interrupt request.
__weak void BSP_LCD_DSI_IRQHandler (void)
 Handles DSI interrupt request.
__weak void BSP_LCD_LTDC_IRQHandler (void)
 Handles LTDC interrupt request.
__weak void BSP_LCD_MspDeInit (void)
 De-Initializes the BSP LCD Msp Application can surcharge if needed this function implementation.
__weak void BSP_LCD_MspInit (void)
 Initialize the BSP LCD Msp.
__weak void BSP_LCD_LTDC_ER_IRQHandler (void)
 This function handles LTDC Error interrupt Handler.
void BSP_LCD_DrawPixel (uint16_t Xpos, uint16_t Ypos, uint32_t RGB_Code)
 Draws a pixel on LCD.
static void DrawChar (uint16_t Xpos, uint16_t Ypos, const uint8_t *c)
 Draws a character on LCD.
static void FillTriangle (uint16_t x1, uint16_t x2, uint16_t x3, uint16_t y1, uint16_t y2, uint16_t y3)
 Fills a triangle (between 3 points).
static void LL_FillBuffer (uint32_t LayerIndex, void *pDst, uint32_t xSize, uint32_t ySize, uint32_t OffLine, uint32_t ColorIndex)
 Fills a buffer.
static void LL_ConvertLineToARGB8888 (void *pSrc, void *pDst, uint32_t xSize, uint32_t ColorMode)
 Converts a line to an ARGB8888 pixel format.

Function Documentation

void BSP_LCD_Clear ( uint32_t  Color )

Clears the whole currently active layer of LTDC.

Parameters:
Color,:Color of the background

Definition at line 695 of file stm32469i_discovery_lcd.c.

void BSP_LCD_ClearStringLine ( uint32_t  Line )

Clears the selected line in currently active layer.

Parameters:
Line,:Line to be cleared

Definition at line 705 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DisplayChar ( uint16_t  Xpos,
uint16_t  Ypos,
uint8_t  Ascii 
)

Displays one character in currently active layer.

Parameters:
Xpos,:Start column address
Ypos,:Line where to display the character shape.
Ascii,:Character ascii code This parameter must be a number between Min_Data = 0x20 and Max_Data = 0x7E

Definition at line 724 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DisplayOff ( void   )

Switch Off the display.

Enter DSI ULPM mode if was allowed and configured in Dsi Configuration.

Definition at line 1281 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DisplayOn ( void   )

Switch back on the display if was switched off by previous call of BSP_LCD_DisplayOff().

Exit DSI ULPM mode if was allowed and configured in Dsi Configuration.

Definition at line 1266 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DisplayStringAt ( uint16_t  Xpos,
uint16_t  Ypos,
uint8_t *  Text,
Text_AlignModeTypdef  Mode 
)

Displays characters in currently active layer.

Parameters:
Xpos,:X position (in pixel)
Ypos,:Y position (in pixel)
Text,:Pointer to string to display on LCD
Mode,:Display mode This parameter can be one of the following values:

  • CENTER_MODE
  • RIGHT_MODE
  • LEFT_MODE

Definition at line 741 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DisplayStringAtLine ( uint16_t  Line,
uint8_t *  ptr 
)

Displays a maximum of 60 characters on the LCD.

Parameters:
Line,:Line where to display the character shape
ptr,:Pointer to string to display on LCD

Definition at line 803 of file stm32469i_discovery_lcd.c.

__weak void BSP_LCD_DMA2D_IRQHandler ( void   )

Handles DMA2D interrupt request.

Note:
: Can be surcharged by application code implementation of the function.

Definition at line 1318 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawBitmap ( uint32_t  Xpos,
uint32_t  Ypos,
uint8_t *  pbmp 
)

Draws a bitmap picture loaded in the internal Flash (32 bpp) in currently active layer.

Parameters:
Xpos,:Bmp X position in the LCD
Ypos,:Bmp Y position in the LCD
pbmp,:Pointer to Bmp picture address in the internal Flash

Definition at line 1045 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawCircle ( uint16_t  Xpos,
uint16_t  Ypos,
uint16_t  Radius 
)

Draws a circle in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
Radius,:Circle radius

Definition at line 940 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawEllipse ( int  Xpos,
int  Ypos,
int  XRadius,
int  YRadius 
)

Draws an ellipse on LCD in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
XRadius,:Ellipse X radius
YRadius,:Ellipse Y radius

Definition at line 1013 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawHLine ( uint16_t  Xpos,
uint16_t  Ypos,
uint16_t  Length 
)

Draws an horizontal line in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
Length,:Line length

Definition at line 814 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawLine ( uint16_t  x1,
uint16_t  y1,
uint16_t  x2,
uint16_t  y2 
)

Draws an uni-line (between two points) in currently active layer.

Parameters:
x1,:Point 1 X position
y1,:Point 1 Y position
x2,:Point 2 X position
y2,:Point 2 Y position

Definition at line 849 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawPixel ( uint16_t  Xpos,
uint16_t  Ypos,
uint32_t  RGB_Code 
)

Draws a pixel on LCD.

Parameters:
Xpos,:X position
Ypos,:Y position
RGB_Code,:Pixel color in ARGB mode (8-8-8-8)

Definition at line 1425 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawPolygon ( pPoint  Points,
uint16_t  PointCount 
)

Draws an poly-line (between many points) in currently active layer.

Parameters:
Points,:Pointer to the points array
PointCount,:Number of points

Definition at line 986 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawRect ( uint16_t  Xpos,
uint16_t  Ypos,
uint16_t  Width,
uint16_t  Height 
)

Draws a rectangle in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
Width,:Rectangle width
Height,:Rectangle height

Definition at line 923 of file stm32469i_discovery_lcd.c.

void BSP_LCD_DrawVLine ( uint16_t  Xpos,
uint16_t  Ypos,
uint16_t  Length 
)

Draws a vertical line in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
Length,:Line length

Definition at line 831 of file stm32469i_discovery_lcd.c.

__weak void BSP_LCD_DSI_IRQHandler ( void   )

Handles DSI interrupt request.

Note:
: Can be surcharged by application code implementation of the function.

Definition at line 1327 of file stm32469i_discovery_lcd.c.

void BSP_LCD_FillCircle ( uint16_t  Xpos,
uint16_t  Ypos,
uint16_t  Radius 
)

Draws a full circle in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
Radius,:Circle radius

Definition at line 1122 of file stm32469i_discovery_lcd.c.

void BSP_LCD_FillEllipse ( int  Xpos,
int  Ypos,
int  XRadius,
int  YRadius 
)

Draws a full ellipse in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
XRadius,:Ellipse X radius
YRadius,:Ellipse Y radius

Definition at line 1236 of file stm32469i_discovery_lcd.c.

void BSP_LCD_FillPolygon ( pPoint  Points,
uint16_t  PointCount 
)

Draws a full poly-line (between many points) in currently active layer.

Parameters:
Points,:Pointer to the points array
PointCount,:Number of points

Definition at line 1169 of file stm32469i_discovery_lcd.c.

void BSP_LCD_FillRect ( uint16_t  Xpos,
uint16_t  Ypos,
uint16_t  Width,
uint16_t  Height 
)

Draws a full rectangle in currently active layer.

Parameters:
Xpos,:X position
Ypos,:Y position
Width,:Rectangle width
Height,:Rectangle height

Definition at line 1102 of file stm32469i_discovery_lcd.c.

uint32_t BSP_LCD_GetBackColor ( void   )

Gets the LCD background color.

Return values:
Usedbackground color

Definition at line 632 of file stm32469i_discovery_lcd.c.

sFONT* BSP_LCD_GetFont ( void   )

Gets the LCD text font.

Return values:
Usedlayer font

Definition at line 650 of file stm32469i_discovery_lcd.c.

uint32_t BSP_LCD_GetTextColor ( void   )

Gets the LCD text color.

Return values:
Usedtext color.

Definition at line 614 of file stm32469i_discovery_lcd.c.

uint32_t BSP_LCD_GetXSize ( void   )

Gets the LCD X size.

Return values:
UsedLCD X size

Definition at line 438 of file stm32469i_discovery_lcd.c.

uint32_t BSP_LCD_GetYSize ( void   )

Gets the LCD Y size.

Return values:
UsedLCD Y size

Definition at line 447 of file stm32469i_discovery_lcd.c.

uint8_t BSP_LCD_Init ( void   )

Initializes the DSI LCD.

Return values:
LCDstate

Definition at line 181 of file stm32469i_discovery_lcd.c.

uint8_t BSP_LCD_InitEx ( LCD_OrientationTypeDef  orientation )

Initializes the DSI LCD.

The ititialization is done as below:

  • DSI PLL ititialization
  • DSI ititialization
  • LTDC ititialization
  • OTM8009A LCD Display IC Driver ititialization
    Return values:
    LCDstate

< LcdClk = 27429 kHz

< Vertical start active time in units of lines

< Vertical Back Porch time in units of lines

< Vertical Front Porch time in units of lines

< Vertical Active time in units of lines = imageSize Y in pixels to display

< Horizontal start active time in units of lcdClk

< Horizontal Back Porch time in units of lcdClk

< Horizontal Front Porch time in units of lcdClk

< Horizontal Active time in units of lcdClk = imageSize X in pixels to display

Definition at line 195 of file stm32469i_discovery_lcd.c.

void BSP_LCD_LayerDefaultInit ( uint16_t  LayerIndex,
uint32_t  FB_Address 
)

Initializes the LCD layers.

Parameters:
LayerIndex,:Layer foreground or background
FB_Address,:Layer frame buffer

Definition at line 476 of file stm32469i_discovery_lcd.c.

__weak void BSP_LCD_LTDC_ER_IRQHandler ( void   )

This function handles LTDC Error interrupt Handler.

Note:
: Can be surcharged by application code implementation of the function.

Definition at line 1413 of file stm32469i_discovery_lcd.c.

__weak void BSP_LCD_LTDC_IRQHandler ( void   )

Handles LTDC interrupt request.

Note:
: Can be surcharged by application code implementation of the function.

Definition at line 1337 of file stm32469i_discovery_lcd.c.

__weak void BSP_LCD_MspDeInit ( void   )

De-Initializes the BSP LCD Msp Application can surcharge if needed this function implementation.

Disable IRQ of LTDC IP

Disable IRQ of DMA2D IP

Disable IRQ of DSI IP

Force and let in reset state LTDC, DMA2D and DSI Host + Wrapper IPs

Disable the LTDC, DMA2D and DSI Host and Wrapper clocks

Definition at line 1346 of file stm32469i_discovery_lcd.c.

__weak void BSP_LCD_MspInit ( void   )

Initialize the BSP LCD Msp.

Application can surcharge if needed this function implementation

Enable the LTDC clock

Toggle Sw reset of LTDC IP

Enable the DMA2D clock

Toggle Sw reset of DMA2D IP

Enable DSI Host and wrapper clocks

Soft Reset the DSI Host and wrapper

NVIC configuration for LTDC interrupt that is now enabled

NVIC configuration for DMA2D interrupt that is now enabled

NVIC configuration for DSI interrupt that is now enabled

Definition at line 1372 of file stm32469i_discovery_lcd.c.

uint32_t BSP_LCD_ReadPixel ( uint16_t  Xpos,
uint16_t  Ypos 
)

Reads an LCD pixel.

Parameters:
Xpos,:X position
Ypos,:Y position
Return values:
RGBpixel color

Definition at line 661 of file stm32469i_discovery_lcd.c.

void BSP_LCD_Reset ( void   )

BSP LCD Reset Hw reset the LCD DSI activating its XRES signal (active low for some time) and desactivating it later.

This signal is only cabled on Discovery Rev B and beyond.

Definition at line 401 of file stm32469i_discovery_lcd.c.

void BSP_LCD_ResetColorKeying ( uint32_t  LayerIndex )

Disables the color keying.

Parameters:
LayerIndex,:Layer foreground or background

Definition at line 595 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SelectLayer ( uint32_t  LayerIndex )

Selects the LCD Layer.

Parameters:
LayerIndex,:Layer foreground or background

Definition at line 509 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetBackColor ( uint32_t  Color )

Sets the LCD background color.

Parameters:
Color,:Layer background color code ARGB(8-8-8-8)

Definition at line 623 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetColorKeying ( uint32_t  LayerIndex,
uint32_t  RGBValue 
)

Configures and sets the color keying.

Parameters:
LayerIndex,:Layer foreground or background
RGBValue,:Color reference

Definition at line 584 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetFont ( sFONT *  fonts )

Sets the LCD text font.

Parameters:
fonts,:Layer font to be used

Definition at line 641 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetLayerAddress ( uint32_t  LayerIndex,
uint32_t  Address 
)

Sets an LCD layer frame buffer address.

Parameters:
LayerIndex,:Layer foreground or background
Address,:New LCD frame buffer value

Definition at line 554 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetLayerVisible ( uint32_t  LayerIndex,
FunctionalState  State 
)

Sets an LCD Layer visible.

Parameters:
LayerIndex,:Visible Layer
State,:New state of the specified layer This parameter can be one of the following values:

  • ENABLE
  • DISABLE

Definition at line 522 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetLayerWindow ( uint16_t  LayerIndex,
uint16_t  Xpos,
uint16_t  Ypos,
uint16_t  Width,
uint16_t  Height 
)

Sets display window.

Parameters:
LayerIndex,:Layer index
Xpos,:LCD X position
Ypos,:LCD Y position
Width,:LCD window width
Height,:LCD window height

Definition at line 569 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetTextColor ( uint32_t  Color )

Sets the LCD text color.

Parameters:
Color,:Text color code ARGB(8-8-8-8)

Definition at line 605 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetTransparency ( uint32_t  LayerIndex,
uint8_t  Transparency 
)

Configures the transparency.

Parameters:
LayerIndex,:Layer foreground or background.
Transparency,:Transparency This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF

Definition at line 542 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetXSize ( uint32_t  imageWidthPixels )

Set the LCD X size.

Parameters:
imageWidthPixels: uint32_t image width in pixels unit

Definition at line 456 of file stm32469i_discovery_lcd.c.

void BSP_LCD_SetYSize ( uint32_t  imageHeightPixels )

Set the LCD Y size.

Parameters:
imageHeightPixels: uint32_t image height in lines unit

Definition at line 465 of file stm32469i_discovery_lcd.c.

static void DrawChar ( uint16_t  Xpos,
uint16_t  Ypos,
const uint8_t *  c 
) [static]

Draws a character on LCD.

Parameters:
Xpos,:Line where to display the character shape
Ypos,:Start column address
c,:Pointer to the character data

Definition at line 1438 of file stm32469i_discovery_lcd.c.

void DSI_IO_WriteCmd ( uint32_t  NbrParams,
uint8_t *  pParams 
)

DCS or Generic short/long write command.

Parameters:
NbrParams,:Number of parameters. It indicates the write command mode: If inferior to 2, a long write command is performed else short.
pParams,:Pointer to parameter values table.
Return values:
HALstatus

Definition at line 1299 of file stm32469i_discovery_lcd.c.

static void FillTriangle ( uint16_t  x1,
uint16_t  x2,
uint16_t  x3,
uint16_t  y1,
uint16_t  y2,
uint16_t  y3 
) [static]

Fills a triangle (between 3 points).

Parameters:
x1,:Point 1 X position
y1,:Point 1 Y position
x2,:Point 2 X position
y2,:Point 2 Y position
x3,:Point 3 X position
y3,:Point 3 Y position

Definition at line 1496 of file stm32469i_discovery_lcd.c.

static void LL_ConvertLineToARGB8888 ( void *  pSrc,
void *  pDst,
uint32_t  xSize,
uint32_t  ColorMode 
) [static]

Converts a line to an ARGB8888 pixel format.

Parameters:
pSrc,:Pointer to source buffer
pDst,:Output color
xSize,:Buffer width
ColorMode,:Input color mode

Definition at line 1603 of file stm32469i_discovery_lcd.c.

static void LL_FillBuffer ( uint32_t  LayerIndex,
void *  pDst,
uint32_t  xSize,
uint32_t  ySize,
uint32_t  OffLine,
uint32_t  ColorIndex 
) [static]

Fills a buffer.

Parameters:
LayerIndex,:Layer index
pDst,:Pointer to destination buffer
xSize,:Buffer width
ySize,:Buffer height
OffLine,:Offset
ColorIndex,:Color index

Definition at line 1573 of file stm32469i_discovery_lcd.c.

Generated on Thu Jul 14 2022 14:13:42 by  doxygen 1.7.2