stm32h743i_eval_lcd.c File Reference

This file includes the driver for Liquid Crystal Display (LCD) module mounted on STM32H743I-EVAL evaluation board. More...

#include "stm32h743i_eval_lcd.h" #include "../../../Utilities/Fonts/fonts.h"
#include "../../../Utilities/Fonts/font24.c"
#include "../../../Utilities/Fonts/font20.c"
#include "../../../Utilities/Fonts/font16.c"
#include "../../../Utilities/Fonts/font12.c"
#include "../../../Utilities/Fonts/font8.c"

Go to the source code of this file.

Defines
#define	POLY_X(Z)   ((int32_t)((Points + Z)->X))
#define	POLY_Y(Z)   ((int32_t)((Points + Z)->Y))
#define	ABS(X)   ((X) > 0 ? (X) : -(X))
Functions
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.
static void	TIMx_PWM_MspInit (TIM_HandleTypeDef *htim)
	Initializes TIM MSP.
static void	TIMx_PWM_MspDeInit (TIM_HandleTypeDef *htim)
	De-Initializes TIM MSP.
static void	TIMx_PWM_DeInit (TIM_HandleTypeDef *htim)
	De-Initializes TIM in PWM mode.
static void	TIMx_PWM_Init (TIM_HandleTypeDef *htim)
	Initializes TIM in PWM mode.
uint8_t	BSP_LCD_Init (void)
	Initializes the LCD.
uint8_t	BSP_LCD_InitEx (uint32_t PclkConfig)
	Initializes the LCD.
uint8_t	BSP_LCD_DeInit (void)
	DeInitializes the LCD.
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_SetLayerVisible_NoReload (uint32_t LayerIndex, FunctionalState State)
	Sets an LCD Layer visible without reloading.
void	BSP_LCD_SetTransparency (uint32_t LayerIndex, uint8_t Transparency)
	Configures the transparency.
void	BSP_LCD_SetTransparency_NoReload (uint32_t LayerIndex, uint8_t Transparency)
	Configures the transparency without reloading.
void	BSP_LCD_SetLayerAddress (uint32_t LayerIndex, uint32_t Address)
	Sets an LCD layer frame buffer address.
void	BSP_LCD_SetLayerAddress_NoReload (uint32_t LayerIndex, uint32_t Address)
	Sets an LCD layer frame buffer address without reloading.
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_SetLayerWindow_NoReload (uint16_t LayerIndex, uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height)
	Sets display window without reloading.
void	BSP_LCD_SetColorKeying (uint32_t LayerIndex, uint32_t RGBValue)
	Configures and sets the color keying.
void	BSP_LCD_SetColorKeying_NoReload (uint32_t LayerIndex, uint32_t RGBValue)
	Configures and sets the color keying without reloading.
void	BSP_LCD_ResetColorKeying (uint32_t LayerIndex)
	Disables the color keying.
void	BSP_LCD_ResetColorKeying_NoReload (uint32_t LayerIndex)
	Disables the color keying without reloading.
void	BSP_LCD_Relaod (uint32_t ReloadType)
	Disables the color keying without reloading.
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 hole LCD.
void	BSP_LCD_ClearStringLine (uint32_t Line)
	Clears the selected line.
void	BSP_LCD_DisplayChar (uint16_t Xpos, uint16_t Ypos, uint8_t Ascii)
	Displays one character.
void	BSP_LCD_DisplayStringAt (uint16_t Xpos, uint16_t Ypos, uint8_t *Text, Text_AlignModeTypdef Mode)
	Displays characters on the LCD.
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.
void	BSP_LCD_DrawVLine (uint16_t Xpos, uint16_t Ypos, uint16_t Length)
	Draws a vertical line.
void	BSP_LCD_DrawLine (uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2)
	Draws an uni-line (between two points).
void	BSP_LCD_DrawRect (uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height)
	Draws a rectangle.
void	BSP_LCD_DrawCircle (uint16_t Xpos, uint16_t Ypos, uint16_t Radius)
	Draws a circle.
void	BSP_LCD_DrawPolygon (pPoint Points, uint16_t PointCount)
	Draws an poly-line (between many points).
void	BSP_LCD_DrawEllipse (int Xpos, int Ypos, int XRadius, int YRadius)
	Draws an ellipse on LCD.
void	BSP_LCD_DrawPixel (uint16_t Xpos, uint16_t Ypos, uint32_t RGB_Code)
	Draws a pixel on LCD.
void	BSP_LCD_DrawBitmap (uint32_t Xpos, uint32_t Ypos, uint8_t *pbmp)
	Draws a bitmap picture loaded in the internal Flash (32 bpp).
void	BSP_LCD_FillRect (uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height)
	Draws a full rectangle.
void	BSP_LCD_FillCircle (uint16_t Xpos, uint16_t Ypos, uint16_t Radius)
	Draws a full circle.
void	BSP_LCD_FillPolygon (pPoint Points, uint16_t PointCount)
	Draws a full poly-line (between many points).
void	BSP_LCD_FillEllipse (int Xpos, int Ypos, int XRadius, int YRadius)
	Draws a full ellipse.
void	BSP_LCD_DisplayOn (void)
	Enables the display.
void	BSP_LCD_DisplayOff (void)
	Disables the display.
__weak void	BSP_LCD_MspInit (LTDC_HandleTypeDef *hltdc, void *Params)
	Initializes the LTDC MSP.
__weak void	BSP_LCD_MspDeInit (LTDC_HandleTypeDef *hltdc, void *Params)
	DeInitializes BSP_LCD MSP.
__weak void	BSP_LCD_ClockConfig (LTDC_HandleTypeDef *hltdc, void *Params)
	Clock Config.
void	BSP_LCD_SetBrightness (uint8_t BrightnessValue)
	Set the brightness value.
Variables
DMA2D_HandleTypeDef	hdma2d_eval
LTDC_HandleTypeDef	hltdc_eval
static uint32_t	PCLK_profile = LCD_MAX_PCLK
static TIM_HandleTypeDef	LCD_TimHandle
static uint32_t	ActiveLayer = 0
static LCD_DrawPropTypeDef	DrawProp [MAX_LAYER_NUMBER]

---

Detailed Description

This file includes the driver for Liquid Crystal Display (LCD) module mounted on STM32H743I-EVAL evaluation board.

Author:

MCD Application Team

Version:

V1.0.0

Date:

21-April-2017

  How To use this driver:
  -----------------------
   - This driver is used to drive directly an LCD TFT using the LTDC controller.
   - This driver selects dynamically the mounted LCD, AMPIRE 640x480 LCD mounted
     on MB1063 or AMPIRE 480x272 LCD mounted on MB1046 daughter board,
     and uses the adequate timing and setting for the specified LCD using
     device ID of the STMPE811 mounted on MB1046 daughter board.

  Driver description:
  ------------------
  + Initialization steps:
     o Initialize the LCD using the BSP_LCD_Init() function.
     o Apply the Layer configuration using the BSP_LCD_LayerDefaultInit() function.
     o Select the LCD layer to be used using the BSP_LCD_SelectLayer() function.
     o Enable the LCD display using the BSP_LCD_DisplayOn() function.

  + Options
     o Configure and enable the colour keying functionality using the
       BSP_LCD_SetColorKeying() function.
     o Modify in the fly the transparency and/or the frame buffer address
       using the following functions:
       - BSP_LCD_SetTransparency()
       - BSP_LCD_SetLayerAddress()

  + Display on LCD
     o Clear the whole LCD using BSP_LCD_Clear() function or only one specified string
       line using the BSP_LCD_ClearStringLine() function.
     o Display a character on the specified line and column using the BSP_LCD_DisplayChar()
       function or a complete string line using the BSP_LCD_DisplayStringAtLine() function.
     o Display a string line on the specified position (x,y in pixel) and align mode
       using the BSP_LCD_DisplayStringAtLine() function.
     o Draw and fill a basic shapes (dot, line, rectangle, circle, ellipse, .. bitmap)
       on LCD using the available set of functions.
  

Attention:

© COPYRIGHT(c) 2017 STMicroelectronics

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of STMicroelectronics nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Definition in file stm32h743i_eval_lcd.c.