ST
This class drives the LCD display (4-inch 800x472 LCD-TFT) present on STM32F769I-DISCO board
Dependents: Datarecorder2 DISCO-F769NI_several_example
Diff: LCD_DISCO_F769NI.h
- Revision:
- 0:fd7c63b20d54
diff -r 000000000000 -r fd7c63b20d54 LCD_DISCO_F769NI.h
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/LCD_DISCO_F769NI.h Fri Feb 10 13:31:58 2017 +0100
@@ -0,0 +1,462 @@
+/* Copyright (c) 2010-2011 mbed.org, MIT License
+*
+* Permission is hereby granted, free of charge, to any person obtaining a copy of this software
+* and associated documentation files (the "Software"), to deal in the Software without
+* restriction, including without limitation the rights to use, copy, modify, merge, publish,
+* distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
+* Software is furnished to do so, subject to the following conditions:
+*
+* The above copyright notice and this permission notice shall be included in all copies or
+* substantial portions of the Software.
+*
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
+* BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+*/
+
+#ifndef __LCD_DISCO_F769NI_H
+#define __LCD_DISCO_F769NI_H
+
+#ifdef TARGET_DISCO_F769NI
+
+#include "mbed.h"
+#include "stm32f769i_discovery_lcd.h"
+
+/*
+ This class drives the LCD display (4-inch 800x472 LCD-TFT) present on STM32F769I-DISCO board.
+
+ Usage:
+
+ #include "mbed.h"
+ #include "LCD_DISCO_F769NI.h"
+
+ LCD_DISCO_F769NI lcd;
+
+ int main()
+ {
+ lcd.DisplayStringAt(0, LINE(1), (uint8_t *)"MBED EXAMPLE", CENTER_MODE);
+ wait(1);
+ lcd.Clear(LCD_COLOR_BLUE);
+ lcd.SetBackColor(LCD_COLOR_BLUE);
+ lcd.SetTextColor(LCD_COLOR_WHITE);
+ lcd.DisplayStringAt(0, LINE(5), (uint8_t *)"DISCOVERY STM32F769NI", CENTER_MODE);
+ while(1)
+ {
+ }
+ }
+*/
+class LCD_DISCO_F769NI
+{
+
+public:
+ //! Constructor
+ LCD_DISCO_F769NI();
+
+ //! Destructor
+ ~LCD_DISCO_F769NI();
+
+ /**
+ * @brief Initializes the DSI LCD.
+ * @param None
+ * @retval LCD state
+ */
+ uint8_t Init(void);
+
+ /**
+ * @brief Initializes the DSI LCD.
+ * The ititialization is done as below:
+ * - DSI PLL ititialization
+ * - DSI ititialization
+ * - LTDC ititialization
+ * - OTM8009A LCD Display IC Driver ititialization
+ * @param None
+ * @retval LCD state
+ */
+ uint8_t InitEx(LCD_OrientationTypeDef orientation);
+
+ /**
+ * @brief Initializes the DSI for HDMI monitor.
+ * The ititialization is done as below:
+ * - DSI PLL ititialization
+ * - DSI ititialization
+ * - LTDC ititialization
+ * - DSI-HDMI ADV7533 adapter device ititialization
+ * @param format : HDMI format could be HDMI_FORMAT_720_480 or HDMI_FORMAT_720_576
+ * @retval LCD state
+ */
+ uint8_t HDMIInitEx(uint8_t format);
+
+ /**
+ * @brief BSP LCD Reset
+ * Hw reset the LCD DSI activating its XRES signal (active low for some time);
+ * and desactivating it later.
+ */
+ void Reset(void);
+
+ /**
+ * @brief Gets the LCD X size.
+ * @retval Used LCD X size
+ */
+ uint32_t GetXSize(void);
+
+ /**
+ * @brief Gets the LCD Y size.
+ * @retval Used LCD Y size
+ */
+ uint32_t GetYSize(void);
+
+ /**
+ * @brief Set the LCD X size.
+ * @param imageWidthPixels : uint32_t image width in pixels unit
+ * @retval None
+ */
+ void SetXSize(uint32_t imageWidthPixels);
+
+ /**
+ * @brief Set the LCD Y size.
+ * @param imageHeightPixels : uint32_t image height in lines unit
+ */
+ void SetYSize(uint32_t imageHeightPixels);
+
+ /**
+ * @brief Initializes the LCD layers.
+ * @param LayerIndex: Layer foreground or background
+ * @param FB_Address: Layer frame buffer
+ * @retval None
+ */
+ void LayerDefaultInit(uint16_t LayerIndex, uint32_t FB_Address);
+
+ /**
+ * @brief Selects the LCD Layer.
+ * @param LayerIndex: Layer foreground or background
+ */
+ void SelectLayer(uint32_t LayerIndex);
+
+ /**
+ * @brief Sets an LCD Layer visible
+ * @param LayerIndex: Visible Layer
+ * @param State: New state of the specified layer
+ * This parameter can be one of the following values:
+ * @arg ENABLE
+ * @arg DISABLE
+ */
+ void SetLayerVisible(uint32_t LayerIndex, FunctionalState State);
+
+ /**
+ * @brief Configures the transparency.
+ * @param LayerIndex: Layer foreground or background.
+ * @param Transparency: Transparency
+ * This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF
+ */
+ void SetTransparency(uint32_t LayerIndex, uint8_t Transparency);
+
+ /**
+ * @brief Sets an LCD layer frame buffer address.
+ * @param LayerIndex: Layer foreground or background
+ * @param Address: New LCD frame buffer value
+ */
+ void SetLayerAddress(uint32_t LayerIndex, uint32_t Address);
+
+ /**
+ * @brief Sets display window.
+ * @param LayerIndex: Layer index
+ * @param Xpos: LCD X position
+ * @param Ypos: LCD Y position
+ * @param Width: LCD window width
+ * @param Height: LCD window height
+ */
+ void SetLayerWindow(uint16_t LayerIndex, uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height);
+
+ /**
+ * @brief Configures and sets the color keying.
+ * @param LayerIndex: Layer foreground or background
+ * @param RGBValue: Color reference
+ */
+ void SetColorKeying(uint32_t LayerIndex, uint32_t RGBValue);
+
+ /**
+ * @brief Disables the color keying.
+ * @param LayerIndex: Layer foreground or background
+ */
+ void ResetColorKeying(uint32_t LayerIndex);
+
+ /**
+ * @brief Sets the LCD text color.
+ * @param Color: Text color code ARGB(8-8-8-8);
+ */
+ void SetTextColor(uint32_t Color);
+
+ /**
+ * @brief Gets the LCD text color.
+ * @retval Used text color.
+ */
+ uint32_t GetTextColor(void);
+
+ /**
+ * @brief Sets the LCD background color.
+ * @param Color: Layer background color code ARGB(8-8-8-8);
+ */
+ void SetBackColor(uint32_t Color);
+
+ /**
+ * @brief Gets the LCD background color.
+ * @retval Used background color
+ */
+ uint32_t GetBackColor(void);
+
+ /**
+ * @brief Sets the LCD text font.
+ * @param fonts: Layer font to be used
+ */
+ void SetFont(sFONT *fonts);
+
+ /**
+ * @brief Gets the LCD text font.
+ * @retval Used layer font
+ */
+ sFONT *GetFont(void);
+
+ /**
+ * @brief Reads an LCD pixel.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @retval RGB pixel color
+ */
+ uint32_t ReadPixel(uint16_t Xpos, uint16_t Ypos);
+
+ /**
+ * @brief Clears the whole currently active layer of LTDC.
+ * @param Color: Color of the background
+ */
+ void Clear(uint32_t Color);
+
+ /**
+ * @brief Clears the selected line in currently active layer.
+ * @param Line: Line to be cleared
+ */
+ void ClearStringLine(uint32_t Line);
+
+ /**
+ * @brief Displays one character in currently active layer.
+ * @param Xpos: Start column address
+ * @param Ypos: Line where to display the character shape.
+ * @param Ascii: Character ascii code
+ * This parameter must be a number between Min_Data = 0x20 and Max_Data = 0x7E
+ */
+ void DisplayChar(uint16_t Xpos, uint16_t Ypos, uint8_t Ascii);
+
+ /**
+ * @brief Displays characters in currently active layer.
+ * @param Xpos: X position (in pixel);
+ * @param Ypos: Y position (in pixel);
+ * @param Text: Pointer to string to display on LCD
+ * @param Mode: Display mode
+ * This parameter can be one of the following values:
+ * @arg CENTER_MODE
+ * @arg RIGHT_MODE
+ * @arg LEFT_MODE
+ */
+ void DisplayStringAt(uint16_t Xpos, uint16_t Ypos, uint8_t *Text, Text_AlignModeTypdef Mode);
+
+ /**
+ * @brief Displays a maximum of 60 characters on the LCD.
+ * @param Line: Line where to display the character shape
+ * @param ptr: Pointer to string to display on LCD
+ */
+ void DisplayStringAtLine(uint16_t Line, uint8_t *ptr);
+
+ /**
+ * @brief Draws an horizontal line in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param Length: Line length
+ */
+ void DrawHLine(uint16_t Xpos, uint16_t Ypos, uint16_t Length);
+
+ /**
+ * @brief Draws a vertical line in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param Length: Line length
+ */
+ void DrawVLine(uint16_t Xpos, uint16_t Ypos, uint16_t Length);
+
+ /**
+ * @brief Draws an uni-line (between two points); in currently active layer.
+ * @param x1: Point 1 X position
+ * @param y1: Point 1 Y position
+ * @param x2: Point 2 X position
+ * @param y2: Point 2 Y position
+ */
+ void DrawLine(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2);
+
+ /**
+ * @brief Draws a rectangle in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param Width: Rectangle width
+ * @param Height: Rectangle height
+ */
+ void DrawRect(uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height);
+
+ /**
+ * @brief Draws a circle in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param Radius: Circle radius
+ */
+ void DrawCircle(uint16_t Xpos, uint16_t Ypos, uint16_t Radius);
+
+ /**
+ * @brief Draws an poly-line (between many points); in currently active layer.
+ * @param Points: Pointer to the points array
+ * @param PointCount: Number of points
+ */
+ void DrawPolygon(pPoint Points, uint16_t PointCount);
+
+ /**
+ * @brief Draws an ellipse on LCD in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param XRadius: Ellipse X radius
+ * @param YRadius: Ellipse Y radius
+ */
+ void DrawEllipse(int Xpos, int Ypos, int XRadius, int YRadius);
+
+ /**
+ * @brief Draws a bitmap picture loaded in the internal Flash (32 bpp); in currently active layer.
+ * @param Xpos: Bmp X position in the LCD
+ * @param Ypos: Bmp Y position in the LCD
+ * @param pbmp: Pointer to Bmp picture address in the internal Flash
+ */
+ void DrawBitmap(uint32_t Xpos, uint32_t Ypos, uint8_t *pbmp);
+
+ /**
+ * @brief Draws a full rectangle in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param Width: Rectangle width
+ * @param Height: Rectangle height
+ */
+ void FillRect(uint16_t Xpos, uint16_t Ypos, uint16_t Width, uint16_t Height);
+
+ /**
+ * @brief Draws a full circle in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param Radius: Circle radius
+ */
+ void FillCircle(uint16_t Xpos, uint16_t Ypos, uint16_t Radius);
+
+ /**
+ * @brief Draws a full poly-line (between many points); in currently active layer.
+ * @param Points: Pointer to the points array
+ * @param PointCount: Number of points
+ */
+ void FillPolygon(pPoint Points, uint16_t PointCount);
+
+ /**
+ * @brief Draws a full ellipse in currently active layer.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param XRadius: Ellipse X radius
+ * @param YRadius: Ellipse Y radius
+ */
+ void FillEllipse(int Xpos, int Ypos, int XRadius, int YRadius);
+
+ /**
+ * @brief Switch back on the display if was switched off by previous call of DisplayOff();.
+ * Exit DSI ULPM mode if was allowed and configured in Dsi Configuration.
+ */
+ void DisplayOn(void);
+
+ /**
+ * @brief Switch Off the display.
+ * Enter DSI ULPM mode if was allowed and configured in Dsi Configuration.
+ */
+ void DisplayOff(void);
+
+ /**
+ * @brief Set the brightness value
+ * @param BrightnessValue: [00: Min (black);, 100 Max]
+ */
+ void SetBrightness(uint8_t BrightnessValue);
+
+ /**
+ * @brief Returns the ID of connected screen by checking the HDMI
+ * (adv7533 component); ID or LCD DSI (via TS ID) ID.
+ * @param None
+ * @retval LCD ID
+ */
+ static uint16_t LCD_IO_GetID(void);
+
+ /**
+ * @brief De-Initializes the BSP LCD Msp
+ * Application can surcharge if needed this function implementation.
+ */
+ __weak void MspDeInit(void);
+
+ /**
+ * @brief Initialize the BSP LCD Msp.
+ * Application can surcharge if needed this function implementation
+ */
+ __weak void MspInit(void);
+
+ /**
+ * @brief Draws a pixel on LCD.
+ * @param Xpos: X position
+ * @param Ypos: Y position
+ * @param RGB_Code: Pixel color in ARGB mode (8-8-8-8);
+ */
+ void DrawPixel(uint16_t Xpos, uint16_t Ypos, uint32_t RGB_Code);
+
+ /**
+ * @brief Draws a character on LCD.
+ * @param Xpos: Line where to display the character shape
+ * @param Ypos: Start column address
+ * @param c: Pointer to the character data
+ */
+ static void DrawChar(uint16_t Xpos, uint16_t Ypos, const uint8_t *c);
+
+ /**
+ * @brief Fills a triangle (between 3 points);.
+ * @param x1: Point 1 X position
+ * @param y1: Point 1 Y position
+ * @param x2: Point 2 X position
+ * @param y2: Point 2 Y position
+ * @param x3: Point 3 X position
+ * @param y3: Point 3 Y position
+ */
+ static void FillTriangle(uint16_t x1, uint16_t x2, uint16_t x3, uint16_t y1, uint16_t y2, uint16_t y3);
+
+ /**
+ * @brief Fills a buffer.
+ * @param LayerIndex: Layer index
+ * @param pDst: Pointer to destination buffer
+ * @param xSize: Buffer width
+ * @param ySize: Buffer height
+ * @param OffLine: Offset
+ * @param ColorIndex: Color index
+ */
+ static void LL_FillBuffer(uint32_t LayerIndex, void *pDst, uint32_t xSize, uint32_t ySize, uint32_t OffLine, uint32_t ColorIndex);
+
+ /**
+ * @brief Converts a line to an ARGB8888 pixel format.
+ * @param pSrc: Pointer to source buffer
+ * @param pDst: Output color
+ * @param xSize: Buffer width
+ * @param ColorMode: Input color mode
+ */
+ static void LL_ConvertLineToARGB8888(void *pSrc, void *pDst, uint32_t xSize, uint32_t ColorMode);
+
+private:
+
+};
+
+#else
+#error "This class must be used with DISCO_F746NG board only."
+#endif // TARGET_DISCO_F746NG
+
+#endif