jmg
/
stm32lib
1
0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
10 Commits
1 Branch
14 MiB
 
 
 
Tree: fd8ba19d60
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'fd8ba19d60'
${ noResults }
stm32lib/STM32F7xx_HAL_Driver/Inc/stm32f7xx_hal_ltdc.h

663 lines
29 KiB
Raw Blame History 

  1. /**

  2.   ******************************************************************************

  3.   * @file    stm32f7xx_hal_ltdc.h

  4.   * @author  MCD Application Team

  5.   * @version V1.2.2

  6.   * @date    14-April-2017

  7.   * @brief   Header file of LTDC HAL module.

  8.   ******************************************************************************

  9.   * @attention

  10.   *

  11.   * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>

  12.   *

  13.   * Redistribution and use in source and binary forms, with or without modification,

  14.   * are permitted provided that the following conditions are met:

  15.   *   1. Redistributions of source code must retain the above copyright notice,

  16.   *      this list of conditions and the following disclaimer.

  17.   *   2. Redistributions in binary form must reproduce the above copyright notice,

  18.   *      this list of conditions and the following disclaimer in the documentation

  19.   *      and/or other materials provided with the distribution.

  20.   *   3. Neither the name of STMicroelectronics nor the names of its contributors

  21.   *      may be used to endorse or promote products derived from this software

  22.   *      without specific prior written permission.

  23.   *

  24.   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

  25.   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

  26.   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

  27.   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE

  28.   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

  29.   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR

  30.   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER

  31.   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,

  32.   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

  33.   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

  34.   *

  35.   ******************************************************************************

  36.   */

  37. 

  38. /* Define to prevent recursive inclusion -------------------------------------*/

  39. #ifndef __STM32F7xx_HAL_LTDC_H

  40. #define __STM32F7xx_HAL_LTDC_H

  41. 

  42. #ifdef __cplusplus

  43.  extern "C" {

  44. #endif

  45. 

  46. #if defined (STM32F746xx) || defined (STM32F756xx) || defined (STM32F767xx) || defined (STM32F769xx) || defined (STM32F777xx) || defined (STM32F779xx)

  47. 

  48. /* Includes ------------------------------------------------------------------*/

  49. #include "stm32f7xx_hal_def.h"

  50. 

  51. 

  52. /** @addtogroup STM32F7xx_HAL_Driver

  53.   * @{

  54.   */

  55. 

  56. /** @defgroup LTDC LTDC

  57.   * @brief LTDC HAL module driver

  58.   * @{

  59.   */

  60. 

  61. /* Exported types ------------------------------------------------------------*/

  62. /** @defgroup LTDC_Exported_Types LTDC Exported Types

  63.   * @{

  64.   */

  65. #define MAX_LAYER  2

  66. 

  67. /**

  68.   * @brief  LTDC color structure definition

  69.   */

  70. typedef struct

  71. {

  72.   uint8_t Blue;                    /*!< Configures the blue value.

  73.                                         This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */

  74. 

  75.   uint8_t Green;                   /*!< Configures the green value.

  76.                                         This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */

  77. 

  78.   uint8_t Red;                     /*!< Configures the red value.

  79.                                         This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */

  80. 

  81.   uint8_t Reserved;                /*!< Reserved 0xFF */

  82. } LTDC_ColorTypeDef;

  83. 

  84. /**

  85.   * @brief  LTDC Init structure definition

  86.   */

  87. typedef struct

  88. {

  89.   uint32_t            HSPolarity;                /*!< configures the horizontal synchronization polarity.

  90.                                                       This parameter can be one value of @ref LTDC_HS_POLARITY */

  91. 

  92.   uint32_t            VSPolarity;                /*!< configures the vertical synchronization polarity.

  93.                                                       This parameter can be one value of @ref LTDC_VS_POLARITY */

  94. 

  95.   uint32_t            DEPolarity;                /*!< configures the data enable polarity.

  96.                                                       This parameter can be one of value of @ref LTDC_DE_POLARITY */

  97. 

  98.   uint32_t            PCPolarity;                /*!< configures the pixel clock polarity.

  99.                                                       This parameter can be one of value of @ref LTDC_PC_POLARITY */

  100. 

  101.   uint32_t            HorizontalSync;            /*!< configures the number of Horizontal synchronization width.

  102.                                                       This parameter must be a number between Min_Data = 0x000 and Max_Data = 0xFFF. */

  103. 

  104.   uint32_t            VerticalSync;              /*!< configures the number of Vertical synchronization height.

  105.                                                       This parameter must be a number between Min_Data = 0x000 and Max_Data = 0x7FF. */

  106. 

  107.   uint32_t            AccumulatedHBP;            /*!< configures the accumulated horizontal back porch width.

  108.                                                       This parameter must be a number between Min_Data = LTDC_HorizontalSync and Max_Data = 0xFFF. */

  109. 

  110.   uint32_t            AccumulatedVBP;            /*!< configures the accumulated vertical back porch height.

  111.                                                       This parameter must be a number between Min_Data = LTDC_VerticalSync and Max_Data = 0x7FF. */

  112. 

  113.   uint32_t            AccumulatedActiveW;        /*!< configures the accumulated active width.

  114.                                                       This parameter must be a number between Min_Data = LTDC_AccumulatedHBP and Max_Data = 0xFFF. */

  115. 

  116.   uint32_t            AccumulatedActiveH;        /*!< configures the accumulated active height.

  117.                                                       This parameter must be a number between Min_Data = LTDC_AccumulatedVBP and Max_Data = 0x7FF. */

  118. 

  119.   uint32_t            TotalWidth;                /*!< configures the total width.

  120.                                                       This parameter must be a number between Min_Data = LTDC_AccumulatedActiveW and Max_Data = 0xFFF. */

  121. 

  122.   uint32_t            TotalHeigh;                /*!< configures the total height.

  123.                                                       This parameter must be a number between Min_Data = LTDC_AccumulatedActiveH and Max_Data = 0x7FF. */

  124. 

  125.   LTDC_ColorTypeDef   Backcolor;                 /*!< Configures the background color. */

  126. } LTDC_InitTypeDef;

  127. 

  128. /**

  129.   * @brief  LTDC Layer structure definition

  130.   */

  131. typedef struct

  132. {

  133.   uint32_t WindowX0;                   /*!< Configures the Window Horizontal Start Position.

  134.                                             This parameter must be a number between Min_Data = 0x000 and Max_Data = 0xFFF. */

  135. 

  136.   uint32_t WindowX1;                   /*!< Configures the Window Horizontal Stop Position.

  137.                                             This parameter must be a number between Min_Data = 0x000 and Max_Data = 0xFFF. */

  138. 

  139.   uint32_t WindowY0;                   /*!< Configures the Window vertical Start Position.

  140.                                             This parameter must be a number between Min_Data = 0x000 and Max_Data = 0x7FF. */

  141. 

  142.   uint32_t WindowY1;                   /*!< Configures the Window vertical Stop Position.

  143.                                             This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0x7FF. */

  144. 

  145.   uint32_t PixelFormat;                /*!< Specifies the pixel format.

  146.                                             This parameter can be one of value of @ref LTDC_Pixelformat */

  147. 

  148.   uint32_t Alpha;                      /*!< Specifies the constant alpha used for blending.

  149.                                             This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */

  150. 

  151.   uint32_t Alpha0;                     /*!< Configures the default alpha value.

  152.                                             This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */

  153. 

  154.   uint32_t BlendingFactor1;            /*!< Select the blending factor 1.

  155.                                             This parameter can be one of value of @ref LTDC_BlendingFactor1 */

  156. 

  157.   uint32_t BlendingFactor2;            /*!< Select the blending factor 2.

  158.                                             This parameter can be one of value of @ref LTDC_BlendingFactor2 */

  159. 

  160.   uint32_t FBStartAdress;              /*!< Configures the color frame buffer address */

  161. 

  162.   uint32_t ImageWidth;                 /*!< Configures the color frame buffer line length.

  163.                                             This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0x1FFF. */

  164. 

  165.   uint32_t ImageHeight;                /*!< Specifies the number of line in frame buffer.

  166.                                             This parameter must be a number between Min_Data = 0x000 and Max_Data = 0x7FF. */

  167. 

  168.   LTDC_ColorTypeDef   Backcolor;       /*!< Configures the layer background color. */

  169. } LTDC_LayerCfgTypeDef;

  170. 

  171. /**

  172.   * @brief  HAL LTDC State structures definition

  173.   */

  174. typedef enum

  175. {

  176.   HAL_LTDC_STATE_RESET             = 0x00U,    /*!< LTDC not yet initialized or disabled */

  177.   HAL_LTDC_STATE_READY             = 0x01U,    /*!< LTDC initialized and ready for use   */

  178.   HAL_LTDC_STATE_BUSY              = 0x02U,    /*!< LTDC internal process is ongoing     */

  179.   HAL_LTDC_STATE_TIMEOUT           = 0x03U,    /*!< LTDC Timeout state                   */

  180.   HAL_LTDC_STATE_ERROR             = 0x04U     /*!< LTDC state error                     */

  181. }HAL_LTDC_StateTypeDef;

  182. 

  183. /**

  184.   * @brief  LTDC handle Structure definition

  185.   */

  186. typedef struct

  187. {

  188.   LTDC_TypeDef                *Instance;                /*!< LTDC Register base address                */

  189. 

  190.   LTDC_InitTypeDef            Init;                     /*!< LTDC parameters                           */

  191. 

  192.   LTDC_LayerCfgTypeDef        LayerCfg[MAX_LAYER];      /*!< LTDC Layers parameters                    */

  193. 

  194.   HAL_LockTypeDef             Lock;                     /*!< LTDC Lock                                 */

  195. 

  196.   __IO HAL_LTDC_StateTypeDef  State;                    /*!< LTDC state                                */

  197. 

  198.   __IO uint32_t               ErrorCode;                /*!< LTDC Error code                           */

  199. 

  200. } LTDC_HandleTypeDef;

  201. /**

  202.   * @}

  203.   */

  204. 

  205. /* Exported constants --------------------------------------------------------*/

  206. /** @defgroup LTDC_Exported_Constants LTDC Exported Constants

  207.   * @{

  208.   */

  209. 

  210. /** @defgroup LTDC_Error_Code LTDC Error Code

  211.   * @{

  212.   */

  213. #define HAL_LTDC_ERROR_NONE      ((uint32_t)0x00000000U)    /*!< LTDC No error             */

  214. #define HAL_LTDC_ERROR_TE        ((uint32_t)0x00000001U)    /*!< LTDC Transfer error       */

  215. #define HAL_LTDC_ERROR_FU        ((uint32_t)0x00000002U)    /*!< LTDC FIFO Underrun        */

  216. #define HAL_LTDC_ERROR_TIMEOUT   ((uint32_t)0x00000020U)    /*!< LTDC Timeout error        */

  217. /**

  218.   * @}

  219.   */

  220. 

  221. /** @defgroup LTDC_HS_POLARITY LTDC HS POLARITY

  222.   * @{

  223.   */

  224. #define LTDC_HSPOLARITY_AL                ((uint32_t)0x00000000U)                /*!< Horizontal Synchronization is active low. */

  225. #define LTDC_HSPOLARITY_AH                LTDC_GCR_HSPOL                        /*!< Horizontal Synchronization is active high. */

  226. /**

  227.   * @}

  228.   */

  229. 

  230. /** @defgroup LTDC_VS_POLARITY LTDC VS POLARITY

  231.   * @{

  232.   */

  233. #define LTDC_VSPOLARITY_AL                ((uint32_t)0x00000000U)                /*!< Vertical Synchronization is active low. */

  234. #define LTDC_VSPOLARITY_AH                LTDC_GCR_VSPOL                        /*!< Vertical Synchronization is active high. */

  235. /**

  236.   * @}

  237.   */

  238. 

  239. /** @defgroup LTDC_DE_POLARITY LTDC DE POLARITY

  240.   * @{

  241.   */

  242. #define LTDC_DEPOLARITY_AL                ((uint32_t)0x00000000U)                /*!< Data Enable, is active low. */

  243. #define LTDC_DEPOLARITY_AH                LTDC_GCR_DEPOL                        /*!< Data Enable, is active high. */

  244. /**

  245.   * @}

  246.   */

  247. 

  248. /** @defgroup LTDC_PC_POLARITY LTDC PC POLARITY

  249.   * @{

  250.   */

  251. #define LTDC_PCPOLARITY_IPC               ((uint32_t)0x00000000U)                /*!< input pixel clock. */

  252. #define LTDC_PCPOLARITY_IIPC              LTDC_GCR_PCPOL                        /*!< inverted input pixel clock. */

  253. /**

  254.   * @}

  255.   */

  256. 

  257. /** @defgroup LTDC_SYNC LTDC SYNC

  258.   * @{

  259.   */

  260. #define LTDC_HORIZONTALSYNC               (LTDC_SSCR_HSW >> 16)                 /*!< Horizontal synchronization width. */

  261. #define LTDC_VERTICALSYNC                 LTDC_SSCR_VSH                         /*!< Vertical synchronization height. */

  262. /**

  263.   * @}

  264.   */

  265. 

  266. /** @defgroup LTDC_BACK_COLOR LTDC BACK COLOR

  267.   * @{

  268.   */

  269. #define LTDC_COLOR                   ((uint32_t)0x000000FFU)                     /*!< Color mask */

  270. /**

  271.   * @}

  272.   */

  273. 

  274. /** @defgroup LTDC_BlendingFactor1 LTDC Blending Factor1

  275.   * @{

  276.   */

  277. #define LTDC_BLENDING_FACTOR1_CA                       ((uint32_t)0x00000400U)   /*!< Blending factor : Cte Alpha */

  278. #define LTDC_BLENDING_FACTOR1_PAxCA                    ((uint32_t)0x00000600U)   /*!< Blending factor : Cte Alpha x Pixel Alpha*/

  279. /**

  280.   * @}

  281.   */

  282. 

  283. /** @defgroup LTDC_BlendingFactor2 LTDC Blending Factor2

  284.   * @{

  285.   */

  286. #define LTDC_BLENDING_FACTOR2_CA                       ((uint32_t)0x00000005U)   /*!< Blending factor : Cte Alpha */

  287. #define LTDC_BLENDING_FACTOR2_PAxCA                    ((uint32_t)0x00000007U)   /*!< Blending factor : Cte Alpha x Pixel Alpha*/

  288. /**

  289.   * @}

  290.   */

  291. 

  292. /** @defgroup LTDC_Pixelformat LTDC Pixel format

  293.   * @{

  294.   */

  295. #define LTDC_PIXEL_FORMAT_ARGB8888                  ((uint32_t)0x00000000U)      /*!< ARGB8888 LTDC pixel format */

  296. #define LTDC_PIXEL_FORMAT_RGB888                    ((uint32_t)0x00000001U)      /*!< RGB888 LTDC pixel format   */

  297. #define LTDC_PIXEL_FORMAT_RGB565                    ((uint32_t)0x00000002U)      /*!< RGB565 LTDC pixel format   */

  298. #define LTDC_PIXEL_FORMAT_ARGB1555                  ((uint32_t)0x00000003U)      /*!< ARGB1555 LTDC pixel format */

  299. #define LTDC_PIXEL_FORMAT_ARGB4444                  ((uint32_t)0x00000004U)      /*!< ARGB4444 LTDC pixel format */

  300. #define LTDC_PIXEL_FORMAT_L8                        ((uint32_t)0x00000005U)      /*!< L8 LTDC pixel format       */

  301. #define LTDC_PIXEL_FORMAT_AL44                      ((uint32_t)0x00000006U)      /*!< AL44 LTDC pixel format     */

  302. #define LTDC_PIXEL_FORMAT_AL88                      ((uint32_t)0x00000007U)      /*!< AL88 LTDC pixel format     */

  303. /**

  304.   * @}

  305.   */

  306. 

  307. /** @defgroup LTDC_Alpha LTDC Alpha

  308.   * @{

  309.   */

  310. #define LTDC_ALPHA               LTDC_LxCACR_CONSTA                             /*!< LTDC Cte Alpha mask */

  311. /**

  312.   * @}

  313.   */

  314. 

  315. /** @defgroup LTDC_LAYER_Config LTDC LAYER Config

  316.   * @{

  317.   */

  318. #define LTDC_STOPPOSITION                 (LTDC_LxWHPCR_WHSPPOS >> 16)          /*!< LTDC Layer stop position  */

  319. #define LTDC_STARTPOSITION                LTDC_LxWHPCR_WHSTPOS                  /*!< LTDC Layer start position */

  320. 

  321. #define LTDC_COLOR_FRAME_BUFFER           LTDC_LxCFBLR_CFBLL                    /*!< LTDC Layer Line length    */

  322. #define LTDC_LINE_NUMBER                  LTDC_LxCFBLNR_CFBLNBR                 /*!< LTDC Layer Line number    */

  323. /**

  324.   * @}

  325.   */

  326. 

  327. /** @defgroup LTDC_Interrupts LTDC Interrupts

  328.   * @{

  329.   */

  330. #define LTDC_IT_LI                      LTDC_IER_LIE

  331. #define LTDC_IT_FU                      LTDC_IER_FUIE

  332. #define LTDC_IT_TE                      LTDC_IER_TERRIE

  333. #define LTDC_IT_RR                      LTDC_IER_RRIE

  334. /**

  335.   * @}

  336.   */

  337. 

  338. /** @defgroup LTDC_Flag LTDC Flag

  339.   * @{

  340.   */

  341. #define LTDC_FLAG_LI                     LTDC_ISR_LIF

  342. #define LTDC_FLAG_FU                     LTDC_ISR_FUIF

  343. #define LTDC_FLAG_TE                     LTDC_ISR_TERRIF

  344. #define LTDC_FLAG_RR                     LTDC_ISR_RRIF

  345. /**

  346.   * @}

  347.   */

  348. 

  349. /** @defgroup LTDC_Reload_Type LTDC Reload Type

  350.   * @{

  351.   */

  352. #define LTDC_RELOAD_IMMEDIATE            LTDC_SRCR_IMR       /*!< Immediate Reload */

  353. #define LTDC_RELOAD_VERTICAL_BLANKING    LTDC_SRCR_VBR       /*!< Vertical Blanking Reload */

  354. /**

  355.   * @}

  356.   */

  357. 

  358. /**

  359.   * @}

  360.   */

  361. 

  362. /* Exported macro ------------------------------------------------------------*/

  363. /** @defgroup LTDC_Exported_Macros LTDC Exported Macros

  364.   * @{

  365.   */

  366. 

  367. /** @brief Reset LTDC handle state

  368.   * @param  __HANDLE__: specifies the LTDC handle.

  369.   * @retval None

  370.   */

  371. #define __HAL_LTDC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_LTDC_STATE_RESET)

  372. 

  373. /**

  374.   * @brief  Enable the LTDC.

  375.   * @param  __HANDLE__: LTDC handle

  376.   * @retval None.

  377.   */

  378. #define __HAL_LTDC_ENABLE(__HANDLE__)    ((__HANDLE__)->Instance->GCR |= LTDC_GCR_LTDCEN)

  379. 

  380. /**

  381.   * @brief  Disable the LTDC.

  382.   * @param  __HANDLE__: LTDC handle

  383.   * @retval None.

  384.   */

  385. #define __HAL_LTDC_DISABLE(__HANDLE__)   ((__HANDLE__)->Instance->GCR &= ~(LTDC_GCR_LTDCEN))

  386. 

  387. /**

  388.   * @brief  Enable the LTDC Layer.

  389.   * @param  __HANDLE__: LTDC handle

  390.   * @param  __LAYER__: Specify the layer to be enabled

  391.   *                     This parameter can be 0 or 1

  392.   * @retval None.

  393.   */

  394. #define __HAL_LTDC_LAYER_ENABLE(__HANDLE__, __LAYER__)  ((LTDC_LAYER((__HANDLE__), (__LAYER__)))->CR |= (uint32_t)LTDC_LxCR_LEN)

  395. 

  396. /**

  397.   * @brief  Disable the LTDC Layer.

  398.   * @param  __HANDLE__: LTDC handle

  399.   * @param  __LAYER__: Specify the layer to be disabled

  400.   *                     This parameter can be 0 or 1

  401.   * @retval None.

  402.   */

  403. #define __HAL_LTDC_LAYER_DISABLE(__HANDLE__, __LAYER__) ((LTDC_LAYER((__HANDLE__), (__LAYER__)))->CR &= ~(uint32_t)LTDC_LxCR_LEN)

  404. 

  405. /**

  406.   * @brief  Reload  Layer Configuration.

  407.   * @param  __HANDLE__: LTDC handle

  408.   * @retval None.

  409.   */

  410. #define __HAL_LTDC_RELOAD_CONFIG(__HANDLE__)   ((__HANDLE__)->Instance->SRCR |= LTDC_SRCR_IMR)

  411. 

  412. /* Interrupt & Flag management */

  413. /**

  414.   * @brief  Get the LTDC pending flags.

  415.   * @param  __HANDLE__: LTDC handle

  416.   * @param  __FLAG__: Get the specified flag.

  417.   *          This parameter can be any combination of the following values:

  418.   *            @arg LTDC_FLAG_LI: Line Interrupt flag

  419.   *            @arg LTDC_FLAG_FU: FIFO Underrun Interrupt flag

  420.   *            @arg LTDC_FLAG_TE: Transfer Error interrupt flag

  421.   *            @arg LTDC_FLAG_RR: Register Reload Interrupt Flag

  422.   * @retval The state of FLAG (SET or RESET).

  423.   */

  424. #define __HAL_LTDC_GET_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR & (__FLAG__))

  425. 

  426. /**

  427.   * @brief  Clears the LTDC pending flags.

  428.   * @param  __HANDLE__: LTDC handle

  429.   * @param  __FLAG__: specifies the flag to clear.

  430.   *          This parameter can be any combination of the following values:

  431.   *            @arg LTDC_FLAG_LI: Line Interrupt flag

  432.   *            @arg LTDC_FLAG_FU: FIFO Underrun Interrupt flag

  433.   *            @arg LTDC_FLAG_TE: Transfer Error interrupt flag

  434.   *            @arg LTDC_FLAG_RR: Register Reload Interrupt Flag

  435.   * @retval None

  436.   */

  437. #define __HAL_LTDC_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))

  438. 

  439. /**

  440.   * @brief  Enables the specified LTDC interrupts.

  441.   * @param  __HANDLE__: LTDC handle

  442.   * @param __INTERRUPT__: specifies the LTDC interrupt sources to be enabled.

  443.   *          This parameter can be any combination of the following values:

  444.   *            @arg LTDC_IT_LI: Line Interrupt flag

  445.   *            @arg LTDC_IT_FU: FIFO Underrun Interrupt flag

  446.   *            @arg LTDC_IT_TE: Transfer Error interrupt flag

  447.   *            @arg LTDC_IT_RR: Register Reload Interrupt Flag

  448.   * @retval None

  449.   */

  450. #define __HAL_LTDC_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER |= (__INTERRUPT__))

  451. 

  452. /**

  453.   * @brief  Disables the specified LTDC interrupts.

  454.   * @param  __HANDLE__: LTDC handle

  455.   * @param __INTERRUPT__: specifies the LTDC interrupt sources to be disabled.

  456.   *          This parameter can be any combination of the following values:

  457.   *            @arg LTDC_IT_LI: Line Interrupt flag

  458.   *            @arg LTDC_IT_FU: FIFO Underrun Interrupt flag

  459.   *            @arg LTDC_IT_TE: Transfer Error interrupt flag

  460.   *            @arg LTDC_IT_RR: Register Reload Interrupt Flag

  461.   * @retval None

  462.   */

  463. #define __HAL_LTDC_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER &= ~(__INTERRUPT__))

  464. 

  465. /**

  466.   * @brief  Checks whether the specified LTDC interrupt has occurred or not.

  467.   * @param  __HANDLE__: LTDC handle

  468.   * @param  __INTERRUPT__: specifies the LTDC interrupt source to check.

  469.   *          This parameter can be one of the following values:

  470.   *            @arg LTDC_IT_LI: Line Interrupt flag

  471.   *            @arg LTDC_IT_FU: FIFO Underrun Interrupt flag

  472.   *            @arg LTDC_IT_TE: Transfer Error interrupt flag

  473.   *            @arg LTDC_IT_RR: Register Reload Interrupt Flag

  474.   * @retval The state of INTERRUPT (SET or RESET).

  475.   */

  476. #define __HAL_LTDC_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->ISR & (__INTERRUPT__))

  477. /**

  478.   * @}

  479.   */

  480. 

  481. #if defined (STM32F769xx) || defined (STM32F779xx)

  482. /* Include LTDC HAL Extension module */

  483. #include "stm32f7xx_hal_ltdc_ex.h"

  484. #endif /* STM32F769xx) | STM32F779xx */

  485. 

  486. /* Exported functions --------------------------------------------------------*/

  487. /** @addtogroup LTDC_Exported_Functions

  488.   * @{

  489.   */

  490. /** @addtogroup LTDC_Exported_Functions_Group1

  491.   * @{

  492.   */

  493. /* Initialization and de-initialization functions *****************************/

  494. HAL_StatusTypeDef HAL_LTDC_Init(LTDC_HandleTypeDef *hltdc);

  495. HAL_StatusTypeDef HAL_LTDC_DeInit(LTDC_HandleTypeDef *hltdc);

  496. void HAL_LTDC_MspInit(LTDC_HandleTypeDef* hltdc);

  497. void HAL_LTDC_MspDeInit(LTDC_HandleTypeDef* hltdc);

  498. void HAL_LTDC_ErrorCallback(LTDC_HandleTypeDef *hltdc);

  499. void HAL_LTDC_LineEvenCallback(LTDC_HandleTypeDef *hltdc);

  500. void HAL_LTDC_ReloadEventCallback(LTDC_HandleTypeDef *hltdc);

  501. /**

  502.   * @}

  503.   */

  504. 

  505. /** @addtogroup LTDC_Exported_Functions_Group2

  506.   * @{

  507.   */

  508. /* IO operation functions *****************************************************/

  509. void  HAL_LTDC_IRQHandler(LTDC_HandleTypeDef *hltdc);

  510. /**

  511.   * @}

  512.   */

  513. 

  514. /** @addtogroup LTDC_Exported_Functions_Group3

  515.   * @{

  516.   */

  517. /* Peripheral Control functions ***********************************************/

  518. HAL_StatusTypeDef HAL_LTDC_ConfigLayer(LTDC_HandleTypeDef *hltdc, LTDC_LayerCfgTypeDef *pLayerCfg, uint32_t LayerIdx);

  519. HAL_StatusTypeDef HAL_LTDC_SetWindowSize(LTDC_HandleTypeDef *hltdc, uint32_t XSize, uint32_t YSize, uint32_t LayerIdx);

  520. HAL_StatusTypeDef HAL_LTDC_SetWindowPosition(LTDC_HandleTypeDef *hltdc, uint32_t X0, uint32_t Y0, uint32_t LayerIdx);

  521. HAL_StatusTypeDef HAL_LTDC_SetPixelFormat(LTDC_HandleTypeDef *hltdc, uint32_t Pixelformat, uint32_t LayerIdx);

  522. HAL_StatusTypeDef HAL_LTDC_SetAlpha(LTDC_HandleTypeDef *hltdc, uint32_t Alpha, uint32_t LayerIdx);

  523. HAL_StatusTypeDef HAL_LTDC_SetAddress(LTDC_HandleTypeDef *hltdc, uint32_t Address, uint32_t LayerIdx);

  524. HAL_StatusTypeDef HAL_LTDC_SetPitch(LTDC_HandleTypeDef *hltdc, uint32_t LinePitchInPixels, uint32_t LayerIdx);

  525. HAL_StatusTypeDef HAL_LTDC_ConfigColorKeying(LTDC_HandleTypeDef *hltdc, uint32_t RGBValue, uint32_t LayerIdx);

  526. HAL_StatusTypeDef HAL_LTDC_ConfigCLUT(LTDC_HandleTypeDef *hltdc, uint32_t *pCLUT, uint32_t CLUTSize, uint32_t LayerIdx);

  527. HAL_StatusTypeDef HAL_LTDC_EnableColorKeying(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  528. HAL_StatusTypeDef HAL_LTDC_DisableColorKeying(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  529. HAL_StatusTypeDef HAL_LTDC_EnableCLUT(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  530. HAL_StatusTypeDef HAL_LTDC_DisableCLUT(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  531. HAL_StatusTypeDef HAL_LTDC_ProgramLineEvent(LTDC_HandleTypeDef *hltdc, uint32_t Line);

  532. HAL_StatusTypeDef HAL_LTDC_EnableDither(LTDC_HandleTypeDef *hltdc);

  533. HAL_StatusTypeDef HAL_LTDC_DisableDither(LTDC_HandleTypeDef *hltdc);

  534. HAL_StatusTypeDef HAL_LTDC_Reload(LTDC_HandleTypeDef *hltdc, uint32_t ReloadType);

  535. HAL_StatusTypeDef HAL_LTDC_ConfigLayer_NoReload(LTDC_HandleTypeDef *hltdc, LTDC_LayerCfgTypeDef *pLayerCfg, uint32_t LayerIdx);

  536. HAL_StatusTypeDef HAL_LTDC_SetWindowSize_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t XSize, uint32_t YSize, uint32_t LayerIdx);

  537. HAL_StatusTypeDef HAL_LTDC_SetWindowPosition_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t X0, uint32_t Y0, uint32_t LayerIdx);

  538. HAL_StatusTypeDef HAL_LTDC_SetPixelFormat_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t Pixelformat, uint32_t LayerIdx);

  539. HAL_StatusTypeDef HAL_LTDC_SetAlpha_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t Alpha, uint32_t LayerIdx);

  540. HAL_StatusTypeDef HAL_LTDC_SetAddress_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t Address, uint32_t LayerIdx);

  541. HAL_StatusTypeDef HAL_LTDC_SetPitch_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LinePitchInPixels, uint32_t LayerIdx);

  542. HAL_StatusTypeDef HAL_LTDC_ConfigColorKeying_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t RGBValue, uint32_t LayerIdx);

  543. HAL_StatusTypeDef HAL_LTDC_EnableColorKeying_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  544. HAL_StatusTypeDef HAL_LTDC_DisableColorKeying_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  545. HAL_StatusTypeDef HAL_LTDC_EnableCLUT_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  546. HAL_StatusTypeDef HAL_LTDC_DisableCLUT_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx);

  547. 

  548. /**

  549.   * @}

  550.   */

  551. 

  552. /** @addtogroup LTDC_Exported_Functions_Group4

  553.   * @{

  554.   */

  555. /* Peripheral State functions *************************************************/

  556. HAL_LTDC_StateTypeDef HAL_LTDC_GetState(LTDC_HandleTypeDef *hltdc);

  557. uint32_t              HAL_LTDC_GetError(LTDC_HandleTypeDef *hltdc);

  558. /**

  559.   * @}

  560.   */

  561. 

  562. /**

  563.   * @}

  564.   */

  565. /* Private types -------------------------------------------------------------*/

  566. /** @defgroup LTDC_Private_Types LTDC Private Types

  567.   * @{

  568.   */

  569. 

  570. /**

  571.   * @}

  572.   */

  573. 

  574. /* Private variables ---------------------------------------------------------*/

  575. /** @defgroup LTDC_Private_Variables LTDC Private Variables

  576.   * @{

  577.   */

  578. 

  579. /**

  580.   * @}

  581.   */

  582. 

  583. /* Private constants ---------------------------------------------------------*/

  584. /** @defgroup LTDC_Private_Constants LTDC Private Constants

  585.   * @{

  586.   */

  587. 

  588. /**

  589.   * @}

  590.   */

  591. 

  592. /* Private macros ------------------------------------------------------------*/

  593. /** @defgroup LTDC_Private_Macros LTDC Private Macros

  594.   * @{

  595.   */

  596. #define LTDC_LAYER(__HANDLE__, __LAYER__)         ((LTDC_Layer_TypeDef *)((uint32_t)(((uint32_t)((__HANDLE__)->Instance)) + 0x84 + (0x80*(__LAYER__)))))

  597. #define IS_LTDC_LAYER(LAYER)                      ((LAYER) <= MAX_LAYER)

  598. #define IS_LTDC_HSPOL(HSPOL)                      (((HSPOL) == LTDC_HSPOLARITY_AL) || \

  599.                                                    ((HSPOL) == LTDC_HSPOLARITY_AH))

  600. #define IS_LTDC_VSPOL(VSPOL)                      (((VSPOL) == LTDC_VSPOLARITY_AL) || \

  601.                                                    ((VSPOL) == LTDC_VSPOLARITY_AH))

  602. #define IS_LTDC_DEPOL(DEPOL)                      (((DEPOL) ==  LTDC_DEPOLARITY_AL) || \

  603.                                                    ((DEPOL) ==  LTDC_DEPOLARITY_AH))

  604. #define IS_LTDC_PCPOL(PCPOL)                      (((PCPOL) ==  LTDC_PCPOLARITY_IPC) || \

  605.                                                    ((PCPOL) ==  LTDC_PCPOLARITY_IIPC))

  606. #define IS_LTDC_HSYNC(HSYNC)                      ((HSYNC)  <= LTDC_HORIZONTALSYNC)

  607. #define IS_LTDC_VSYNC(VSYNC)                      ((VSYNC)  <= LTDC_VERTICALSYNC)

  608. #define IS_LTDC_AHBP(AHBP)                        ((AHBP)   <= LTDC_HORIZONTALSYNC)

  609. #define IS_LTDC_AVBP(AVBP)                        ((AVBP)   <= LTDC_VERTICALSYNC)

  610. #define IS_LTDC_AAW(AAW)                          ((AAW)    <= LTDC_HORIZONTALSYNC)

  611. #define IS_LTDC_AAH(AAH)                          ((AAH)    <= LTDC_VERTICALSYNC)

  612. #define IS_LTDC_TOTALW(TOTALW)                    ((TOTALW) <= LTDC_HORIZONTALSYNC)

  613. #define IS_LTDC_TOTALH(TOTALH)                    ((TOTALH) <= LTDC_VERTICALSYNC)

  614. #define IS_LTDC_BLUEVALUE(BBLUE)                  ((BBLUE)  <= LTDC_COLOR)

  615. #define IS_LTDC_GREENVALUE(BGREEN)                ((BGREEN) <= LTDC_COLOR)

  616. #define IS_LTDC_REDVALUE(BRED)                    ((BRED)   <= LTDC_COLOR)

  617. #define IS_LTDC_BLENDING_FACTOR1(BlendingFactor1) (((BlendingFactor1) == LTDC_BLENDING_FACTOR1_CA) || \

  618.                                                    ((BlendingFactor1) == LTDC_BLENDING_FACTOR1_PAxCA))

  619. #define IS_LTDC_BLENDING_FACTOR2(BlendingFactor2) (((BlendingFactor2) == LTDC_BLENDING_FACTOR2_CA) || \

  620.                                                    ((BlendingFactor2) == LTDC_BLENDING_FACTOR2_PAxCA))

  621. #define IS_LTDC_PIXEL_FORMAT(Pixelformat)         (((Pixelformat) == LTDC_PIXEL_FORMAT_ARGB8888) || ((Pixelformat) == LTDC_PIXEL_FORMAT_RGB888)   || \

  622.                                                    ((Pixelformat) == LTDC_PIXEL_FORMAT_RGB565)   || ((Pixelformat) == LTDC_PIXEL_FORMAT_ARGB1555) || \

  623.                                                    ((Pixelformat) == LTDC_PIXEL_FORMAT_ARGB4444) || ((Pixelformat) == LTDC_PIXEL_FORMAT_L8)       || \

  624.                                                    ((Pixelformat) == LTDC_PIXEL_FORMAT_AL44)     || ((Pixelformat) == LTDC_PIXEL_FORMAT_AL88))

  625. #define IS_LTDC_ALPHA(ALPHA)                      ((ALPHA) <= LTDC_ALPHA)

  626. #define IS_LTDC_HCONFIGST(HCONFIGST)              ((HCONFIGST) <= LTDC_STARTPOSITION)

  627. #define IS_LTDC_HCONFIGSP(HCONFIGSP)              ((HCONFIGSP) <= LTDC_STOPPOSITION)

  628. #define IS_LTDC_VCONFIGST(VCONFIGST)              ((VCONFIGST) <= LTDC_STARTPOSITION)

  629. #define IS_LTDC_VCONFIGSP(VCONFIGSP)              ((VCONFIGSP) <= LTDC_STOPPOSITION)

  630. #define IS_LTDC_CFBP(CFBP)                        ((CFBP) <= LTDC_COLOR_FRAME_BUFFER)

  631. #define IS_LTDC_CFBLL(CFBLL)                      ((CFBLL) <= LTDC_COLOR_FRAME_BUFFER)

  632. #define IS_LTDC_CFBLNBR(CFBLNBR)                  ((CFBLNBR) <= LTDC_LINE_NUMBER)

  633. #define IS_LTDC_LIPOS(LIPOS)                      ((LIPOS) <= 0x7FF)

  634. #define IS_LTDC_RELAOD(RELOADTYPE)                (((RELOADTYPE) == LTDC_RELOAD_IMMEDIATE) || ((RELOADTYPE) == LTDC_SRCR_VBR))

  635. /**

  636.   * @}

  637.   */

  638. 

  639. /* Private functions ---------------------------------------------------------*/

  640. /** @defgroup LTDC_Private_Functions LTDC Private Functions

  641.   * @{

  642.   */

  643. 

  644. /**

  645.   * @}

  646.   */

  647. 

  648. /**

  649.   * @}

  650.   */

  651. #endif /* STM32F746xx || STM32F756xx || STM32F767xx || STM32F769xx || STM32F777xx || STM32F779xx */

  652. /**

  653.   * @}

  654.   */

  655. 

  656. #ifdef __cplusplus

  657. }

  658. #endif

  659. 

  660. #endif /* __STM32F7xx_HAL_LTDC_H */

  661. 

  662. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/