BSP_DISCO_L4R9I

Dependents:   DISCO_L4R9I-LCD-demo

Embed: (wiki syntax)

« Back to documentation index

Exported Functions

Exported Functions
[STM32L4R9I_DISCOVERY LCD]

Functions

uint8_t BSP_LCD_DeInit (void)
 De-initialize the DSI LCD.
uint32_t BSP_LCD_GetXSize (void)
 Gets the LCD X size.
uint32_t BSP_LCD_GetYSize (void)
 Gets the LCD Y size.
uint8_t BSP_LCD_SelectLayer (uint32_t LayerIndex)
 Selects the LCD Layer.
uint8_t BSP_LCD_SetLayerVisible (uint32_t LayerIndex, FunctionalState State)
 Sets an LCD Layer visible.
uint8_t BSP_LCD_SetTransparency (uint32_t LayerIndex, uint8_t Transparency)
 Configures the transparency.
uint8_t BSP_LCD_SetColorKeying (uint32_t LayerIndex, uint32_t RGBValue)
 Configures and sets the color keying.
uint8_t 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 string on specified line of 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_DrawPixel (uint16_t Xpos, uint16_t Ypos, uint32_t RGB_Code)
 Draws a pixel on LCD.
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 BSP_LCD_Refresh (void)
 Refresh the display.
uint8_t BSP_LCD_IsFrameBufferAvailable (void)
 Check if frame buffer is available.
void BSP_LCD_SetBrightness (uint8_t BrightnessValue)
 Set the brightness value.
__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_LTDC_ER_IRQHandler (void)
 This function handles LTDC Error interrupt Handler.
__weak void BSP_LCD_MspDeInit (void)
 De-Initializes the BSP LCD Msp.
__weak void BSP_LCD_MspInit (void)
 Initialize the BSP LCD Msp.

Function Documentation

void BSP_LCD_Clear ( uint32_t  Color )

Clears the whole currently active layer of LTDC.

Parameters:
Color,:Color of the background (in ARGB8888 format)

Definition at line 845 of file stm32l4r9i_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 856 of file stm32l4r9i_discovery_lcd.c.

uint8_t BSP_LCD_DeInit ( void   )

De-initialize the DSI LCD.

Return values:
LCDstate

Definition at line 566 of file stm32l4r9i_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 875 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_DisplayOff ( void   )

Switch Off the display.

Definition at line 1443 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_DisplayOn ( void   )

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

Definition at line 1430 of file stm32l4r9i_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 891 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_DisplayStringAtLine ( uint16_t  Line,
uint8_t *  ptr 
)

Displays string on specified line of the LCD.

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

Definition at line 953 of file stm32l4r9i_discovery_lcd.c.

__weak void BSP_LCD_DMA2D_IRQHandler ( void   )

Handles DMA2D interrupt request.

Note:
Application can surcharge if needed this function implementation.

Definition at line 1498 of file stm32l4r9i_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 1195 of file stm32l4r9i_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 1090 of file stm32l4r9i_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 1163 of file stm32l4r9i_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 964 of file stm32l4r9i_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 999 of file stm32l4r9i_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 1421 of file stm32l4r9i_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 1136 of file stm32l4r9i_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 1073 of file stm32l4r9i_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 981 of file stm32l4r9i_discovery_lcd.c.

__weak void BSP_LCD_DSI_IRQHandler ( void   )

Handles DSI interrupt request.

Note:
Application can surcharge if needed this function implementation.

Definition at line 1507 of file stm32l4r9i_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 1275 of file stm32l4r9i_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 1389 of file stm32l4r9i_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 1322 of file stm32l4r9i_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 1255 of file stm32l4r9i_discovery_lcd.c.

uint32_t BSP_LCD_GetBackColor ( void   )

Gets the LCD background color.

Return values:
Usedbackground color

Definition at line 800 of file stm32l4r9i_discovery_lcd.c.

sFONT* BSP_LCD_GetFont ( void   )

Gets the LCD text font.

Return values:
Usedlayer font

Definition at line 818 of file stm32l4r9i_discovery_lcd.c.

uint32_t BSP_LCD_GetTextColor ( void   )

Gets the LCD text color.

Return values:
Usedtext color.

Definition at line 782 of file stm32l4r9i_discovery_lcd.c.

uint32_t BSP_LCD_GetXSize ( void   )

Gets the LCD X size.

Return values:
UsedLCD X size

Definition at line 632 of file stm32l4r9i_discovery_lcd.c.

uint32_t BSP_LCD_GetYSize ( void   )

Gets the LCD Y size.

Return values:
UsedLCD Y size

Definition at line 641 of file stm32l4r9i_discovery_lcd.c.

uint8_t BSP_LCD_IsFrameBufferAvailable ( void   )

Check if frame buffer is available.

Return values:
LCD_OKif frame buffer is available else LCD_ERROR (frame buffer busy)

Definition at line 1469 of file stm32l4r9i_discovery_lcd.c.

__weak void BSP_LCD_LTDC_ER_IRQHandler ( void   )

This function handles LTDC Error interrupt Handler.

Note:
Application can surcharge if needed this function implementation.

Definition at line 1526 of file stm32l4r9i_discovery_lcd.c.

__weak void BSP_LCD_LTDC_IRQHandler ( void   )

Handles LTDC interrupt request.

Note:
Application can surcharge if needed this function implementation.

Definition at line 1516 of file stm32l4r9i_discovery_lcd.c.

__weak void BSP_LCD_MspDeInit ( void   )

De-Initializes the BSP LCD Msp.

Note:
Application can surcharge if needed this function implementation.

Definition at line 1535 of file stm32l4r9i_discovery_lcd.c.

__weak void BSP_LCD_MspInit ( void   )

Initialize the BSP LCD Msp.

Note:
Application can surcharge if needed this function implementation.

Definition at line 1581 of file stm32l4r9i_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:
ARGB8888pixel color

Definition at line 829 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_Refresh ( void   )

Refresh the display.

Definition at line 1456 of file stm32l4r9i_discovery_lcd.c.

uint8_t BSP_LCD_ResetColorKeying ( uint32_t  LayerIndex )

Disables the color keying.

Parameters:
LayerIndex,:Layer foreground (1) or background (0)
Note:
: Only backgroung layer can be used.
Return values:
LCDstate

Definition at line 753 of file stm32l4r9i_discovery_lcd.c.

uint8_t BSP_LCD_SelectLayer ( uint32_t  LayerIndex )

Selects the LCD Layer.

Parameters:
LayerIndex,:Layer foreground (1) or background (0)
Note:
: Only backgroung layer can be used.
Return values:
LCDstate

Definition at line 652 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_SetBackColor ( uint32_t  Color )

Sets the LCD background color.

Parameters:
Color,:Layer background color code ARGB8888

Definition at line 791 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_SetBrightness ( uint8_t  BrightnessValue )

Set the brightness value.

Parameters:
BrightnessValue,:[0% Min (black), 100% Max]

Definition at line 1482 of file stm32l4r9i_discovery_lcd.c.

uint8_t BSP_LCD_SetColorKeying ( uint32_t  LayerIndex,
uint32_t  RGBValue 
)

Configures and sets the color keying.

Parameters:
LayerIndex,:Layer foreground (1) or background (0)
RGBValue,:Color reference
Note:
: Only backgroung layer can be used.
Return values:
LCDstate

Definition at line 730 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_SetFont ( sFONT *  fonts )

Sets the LCD text font.

Parameters:
fonts,:Layer font to be used

Definition at line 809 of file stm32l4r9i_discovery_lcd.c.

uint8_t 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
Note:
: Only backgroung layer can be used.
Return values:
LCDstate

Definition at line 677 of file stm32l4r9i_discovery_lcd.c.

void BSP_LCD_SetTextColor ( uint32_t  Color )

Sets the LCD text color.

Parameters:
Color,:Text color code ARGB8888

Definition at line 773 of file stm32l4r9i_discovery_lcd.c.

uint8_t 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
Note:
: Only backgroung layer can be used.
Return values:
LCDstate

Definition at line 708 of file stm32l4r9i_discovery_lcd.c.