| /** |
| ****************************************************************************** |
| * @file stm32h7xx_hal_ltdc.c |
| * @author MCD Application Team |
| * @brief LTDC HAL module driver. |
| * This file provides firmware functions to manage the following |
| * functionalities of the LTDC peripheral: |
| * + Initialization and de-initialization functions |
| * + IO operation functions |
| * + Peripheral Control functions |
| * + Peripheral State and Errors functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### How to use this driver ##### |
| ============================================================================== |
| [..] |
| The LTDC HAL driver can be used as follows: |
| |
| (#) Declare a LTDC_HandleTypeDef handle structure, for example: LTDC_HandleTypeDef hltdc; |
| |
| (#) Initialize the LTDC low level resources by implementing the HAL_LTDC_MspInit() API: |
| (##) Enable the LTDC interface clock |
| (##) NVIC configuration if you need to use interrupt process |
| (+++) Configure the LTDC interrupt priority |
| (+++) Enable the NVIC LTDC IRQ Channel |
| |
| (#) Initialize the required configuration through the following parameters: |
| the LTDC timing, the horizontal and vertical polarity, the pixel clock polarity, |
| Data Enable polarity and the LTDC background color value using HAL_LTDC_Init() function |
| |
| *** Configuration *** |
| ========================= |
| [..] |
| (#) Program the required configuration through the following parameters: |
| the pixel format, the blending factors, input alpha value, the window size |
| and the image size using HAL_LTDC_ConfigLayer() function for foreground |
| or/and background layer. |
| |
| (#) Optionally, configure and enable the CLUT using HAL_LTDC_ConfigCLUT() and |
| HAL_LTDC_EnableCLUT functions. |
| |
| (#) Optionally, enable the Dither using HAL_LTDC_EnableDither(). |
| |
| (#) Optionally, configure and enable the Color keying using HAL_LTDC_ConfigColorKeying() |
| and HAL_LTDC_EnableColorKeying functions. |
| |
| (#) Optionally, configure LineInterrupt using HAL_LTDC_ProgramLineEvent() |
| function |
| |
| (#) If needed, reconfigure and change the pixel format value, the alpha value |
| value, the window size, the window position and the layer start address |
| for foreground or/and background layer using respectively the following |
| functions: HAL_LTDC_SetPixelFormat(), HAL_LTDC_SetAlpha(), HAL_LTDC_SetWindowSize(), |
| HAL_LTDC_SetWindowPosition() and HAL_LTDC_SetAddress(). |
| |
| (#) Variant functions with _NoReload suffix allows to set the LTDC configuration/settings without immediate reload. |
| This is useful in case when the program requires to modify serval LTDC settings (on one or both layers) |
| then applying(reload) these settings in one shot by calling the function HAL_LTDC_Reload(). |
| |
| After calling the _NoReload functions to set different color/format/layer settings, |
| the program shall call the function HAL_LTDC_Reload() to apply(reload) these settings. |
| Function HAL_LTDC_Reload() can be called with the parameter ReloadType set to LTDC_RELOAD_IMMEDIATE if |
| an immediate reload is required. |
| Function HAL_LTDC_Reload() can be called with the parameter ReloadType set to LTDC_RELOAD_VERTICAL_BLANKING if |
| the reload should be done in the next vertical blanking period, |
| this option allows to avoid display flicker by applying the new settings during the vertical blanking period. |
| |
| |
| (#) To control LTDC state you can use the following function: HAL_LTDC_GetState() |
| |
| *** LTDC HAL driver macros list *** |
| ============================================= |
| [..] |
| Below the list of most used macros in LTDC HAL driver. |
| |
| (+) __HAL_LTDC_ENABLE: Enable the LTDC. |
| (+) __HAL_LTDC_DISABLE: Disable the LTDC. |
| (+) __HAL_LTDC_LAYER_ENABLE: Enable an LTDC Layer. |
| (+) __HAL_LTDC_LAYER_DISABLE: Disable an LTDC Layer. |
| (+) __HAL_LTDC_RELOAD_IMMEDIATE_CONFIG: Reload Layer Configuration. |
| (+) __HAL_LTDC_GET_FLAG: Get the LTDC pending flags. |
| (+) __HAL_LTDC_CLEAR_FLAG: Clear the LTDC pending flags. |
| (+) __HAL_LTDC_ENABLE_IT: Enable the specified LTDC interrupts. |
| (+) __HAL_LTDC_DISABLE_IT: Disable the specified LTDC interrupts. |
| (+) __HAL_LTDC_GET_IT_SOURCE: Check whether the specified LTDC interrupt has occurred or not. |
| |
| [..] |
| (@) You can refer to the LTDC HAL driver header file for more useful macros |
| |
| |
| *** Callback registration *** |
| ============================================= |
| [..] |
| The compilation define USE_HAL_LTDC_REGISTER_CALLBACKS when set to 1 |
| allows the user to configure dynamically the driver callbacks. |
| Use function HAL_LTDC_RegisterCallback() to register a callback. |
| |
| [..] |
| Function HAL_LTDC_RegisterCallback() allows to register following callbacks: |
| (+) LineEventCallback : LTDC Line Event Callback. |
| (+) ReloadEventCallback : LTDC Reload Event Callback. |
| (+) ErrorCallback : LTDC Error Callback |
| (+) MspInitCallback : LTDC MspInit. |
| (+) MspDeInitCallback : LTDC MspDeInit. |
| [..] |
| This function takes as parameters the HAL peripheral handle, the callback ID |
| and a pointer to the user callback function. |
| |
| [..] |
| Use function HAL_LTDC_UnRegisterCallback() to reset a callback to the default |
| weak function. |
| HAL_LTDC_UnRegisterCallback() takes as parameters the HAL peripheral handle |
| and the callback ID. |
| [..] |
| This function allows to reset following callbacks: |
| (+) LineEventCallback : LTDC Line Event Callback |
| (+) ReloadEventCallback : LTDC Reload Event Callback |
| (+) ErrorCallback : LTDC Error Callback |
| (+) MspInitCallback : LTDC MspInit |
| (+) MspDeInitCallback : LTDC MspDeInit. |
| |
| [..] |
| By default, after the HAL_LTDC_Init and when the state is HAL_LTDC_STATE_RESET |
| all callbacks are set to the corresponding weak functions: |
| examples HAL_LTDC_LineEventCallback(), HAL_LTDC_ErrorCallback(). |
| Exception done for MspInit and MspDeInit functions that are |
| reset to the legacy weak (surcharged) functions in the HAL_LTDC_Init() and HAL_LTDC_DeInit() |
| only when these callbacks are null (not registered beforehand). |
| If not, MspInit or MspDeInit are not null, the HAL_LTDC_Init() and HAL_LTDC_DeInit() |
| keep and use the user MspInit/MspDeInit callbacks (registered beforehand). |
| |
| [..] |
| Callbacks can be registered/unregistered in HAL_LTDC_STATE_READY state only. |
| Exception done MspInit/MspDeInit that can be registered/unregistered |
| in HAL_LTDC_STATE_READY or HAL_LTDC_STATE_RESET state, |
| thus registered (user) MspInit/DeInit callbacks can be used during the Init/DeInit. |
| In that case first register the MspInit/MspDeInit user callbacks |
| using HAL_LTDC_RegisterCallback() before calling HAL_LTDC_DeInit() |
| or HAL_LTDC_Init() function. |
| |
| [..] |
| When the compilation define USE_HAL_LTDC_REGISTER_CALLBACKS is set to 0 or |
| not defined, the callback registration feature is not available and all callbacks |
| are set to the corresponding weak functions. |
| |
| @endverbatim |
| ****************************************************************************** |
| * @attention |
| * |
| * <h2><center>© Copyright (c) 2017 STMicroelectronics. |
| * All rights reserved.</center></h2> |
| * |
| * This software component is licensed by ST under BSD 3-Clause license, |
| * the "License"; You may not use this file except in compliance with the |
| * License. You may obtain a copy of the License at: |
| * opensource.org/licenses/BSD-3-Clause |
| * |
| ****************************************************************************** |
| */ |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32h7xx_hal.h" |
| |
| /** @addtogroup STM32H7xx_HAL_Driver |
| * @{ |
| */ |
| |
| #ifdef HAL_LTDC_MODULE_ENABLED |
| |
| #if defined (LTDC) |
| |
| /** @defgroup LTDC LTDC |
| * @brief LTDC HAL module driver |
| * @{ |
| */ |
| |
| |
| /* Private typedef -----------------------------------------------------------*/ |
| /* Private define ------------------------------------------------------------*/ |
| /* Private macro -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /* Private function prototypes -----------------------------------------------*/ |
| static void LTDC_SetConfig(LTDC_HandleTypeDef *hltdc, LTDC_LayerCfgTypeDef *pLayerCfg, uint32_t LayerIdx); |
| /* Private functions ---------------------------------------------------------*/ |
| |
| /** @defgroup LTDC_Exported_Functions LTDC Exported Functions |
| * @{ |
| */ |
| |
| /** @defgroup LTDC_Exported_Functions_Group1 Initialization and Configuration functions |
| * @brief Initialization and Configuration functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Initialization and Configuration functions ##### |
| =============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Initialize and configure the LTDC |
| (+) De-initialize the LTDC |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Initialize the LTDC according to the specified parameters in the LTDC_InitTypeDef. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_Init(LTDC_HandleTypeDef *hltdc) |
| { |
| uint32_t tmp, tmp1; |
| |
| /* Check the LTDC peripheral state */ |
| if (hltdc == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Check function parameters */ |
| assert_param(IS_LTDC_ALL_INSTANCE(hltdc->Instance)); |
| assert_param(IS_LTDC_HSYNC(hltdc->Init.HorizontalSync)); |
| assert_param(IS_LTDC_VSYNC(hltdc->Init.VerticalSync)); |
| assert_param(IS_LTDC_AHBP(hltdc->Init.AccumulatedHBP)); |
| assert_param(IS_LTDC_AVBP(hltdc->Init.AccumulatedVBP)); |
| assert_param(IS_LTDC_AAH(hltdc->Init.AccumulatedActiveH)); |
| assert_param(IS_LTDC_AAW(hltdc->Init.AccumulatedActiveW)); |
| assert_param(IS_LTDC_TOTALH(hltdc->Init.TotalHeigh)); |
| assert_param(IS_LTDC_TOTALW(hltdc->Init.TotalWidth)); |
| assert_param(IS_LTDC_HSPOL(hltdc->Init.HSPolarity)); |
| assert_param(IS_LTDC_VSPOL(hltdc->Init.VSPolarity)); |
| assert_param(IS_LTDC_DEPOL(hltdc->Init.DEPolarity)); |
| assert_param(IS_LTDC_PCPOL(hltdc->Init.PCPolarity)); |
| |
| #if (USE_HAL_LTDC_REGISTER_CALLBACKS == 1) |
| if (hltdc->State == HAL_LTDC_STATE_RESET) |
| { |
| /* Allocate lock resource and initialize it */ |
| hltdc->Lock = HAL_UNLOCKED; |
| |
| /* Reset the LTDC callback to the legacy weak callbacks */ |
| hltdc->LineEventCallback = HAL_LTDC_LineEventCallback; /* Legacy weak LineEventCallback */ |
| hltdc->ReloadEventCallback = HAL_LTDC_ReloadEventCallback; /* Legacy weak ReloadEventCallback */ |
| hltdc->ErrorCallback = HAL_LTDC_ErrorCallback; /* Legacy weak ErrorCallback */ |
| |
| if (hltdc->MspInitCallback == NULL) |
| { |
| hltdc->MspInitCallback = HAL_LTDC_MspInit; |
| } |
| /* Init the low level hardware */ |
| hltdc->MspInitCallback(hltdc); |
| } |
| #else |
| if (hltdc->State == HAL_LTDC_STATE_RESET) |
| { |
| /* Allocate lock resource and initialize it */ |
| hltdc->Lock = HAL_UNLOCKED; |
| /* Init the low level hardware */ |
| HAL_LTDC_MspInit(hltdc); |
| } |
| #endif /* USE_HAL_LTDC_REGISTER_CALLBACKS */ |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Configure the HS, VS, DE and PC polarity */ |
| hltdc->Instance->GCR &= ~(LTDC_GCR_HSPOL | LTDC_GCR_VSPOL | LTDC_GCR_DEPOL | LTDC_GCR_PCPOL); |
| hltdc->Instance->GCR |= (uint32_t)(hltdc->Init.HSPolarity | hltdc->Init.VSPolarity | \ |
| hltdc->Init.DEPolarity | hltdc->Init.PCPolarity); |
| |
| /* Set Synchronization size */ |
| hltdc->Instance->SSCR &= ~(LTDC_SSCR_VSH | LTDC_SSCR_HSW); |
| tmp = (hltdc->Init.HorizontalSync << 16U); |
| hltdc->Instance->SSCR |= (tmp | hltdc->Init.VerticalSync); |
| |
| /* Set Accumulated Back porch */ |
| hltdc->Instance->BPCR &= ~(LTDC_BPCR_AVBP | LTDC_BPCR_AHBP); |
| tmp = (hltdc->Init.AccumulatedHBP << 16U); |
| hltdc->Instance->BPCR |= (tmp | hltdc->Init.AccumulatedVBP); |
| |
| /* Set Accumulated Active Width */ |
| hltdc->Instance->AWCR &= ~(LTDC_AWCR_AAH | LTDC_AWCR_AAW); |
| tmp = (hltdc->Init.AccumulatedActiveW << 16U); |
| hltdc->Instance->AWCR |= (tmp | hltdc->Init.AccumulatedActiveH); |
| |
| /* Set Total Width */ |
| hltdc->Instance->TWCR &= ~(LTDC_TWCR_TOTALH | LTDC_TWCR_TOTALW); |
| tmp = (hltdc->Init.TotalWidth << 16U); |
| hltdc->Instance->TWCR |= (tmp | hltdc->Init.TotalHeigh); |
| |
| /* Set the background color value */ |
| tmp = ((uint32_t)(hltdc->Init.Backcolor.Green) << 8U); |
| tmp1 = ((uint32_t)(hltdc->Init.Backcolor.Red) << 16U); |
| hltdc->Instance->BCCR &= ~(LTDC_BCCR_BCBLUE | LTDC_BCCR_BCGREEN | LTDC_BCCR_BCRED); |
| hltdc->Instance->BCCR |= (tmp1 | tmp | hltdc->Init.Backcolor.Blue); |
| |
| /* Enable the Transfer Error and FIFO underrun interrupts */ |
| __HAL_LTDC_ENABLE_IT(hltdc, LTDC_IT_TE | LTDC_IT_FU); |
| |
| /* Enable LTDC by setting LTDCEN bit */ |
| __HAL_LTDC_ENABLE(hltdc); |
| |
| /* Initialize the error code */ |
| hltdc->ErrorCode = HAL_LTDC_ERROR_NONE; |
| |
| /* Initialize the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief De-initialize the LTDC peripheral. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval None |
| */ |
| |
| HAL_StatusTypeDef HAL_LTDC_DeInit(LTDC_HandleTypeDef *hltdc) |
| { |
| #if (USE_HAL_LTDC_REGISTER_CALLBACKS == 1) |
| if (hltdc->MspDeInitCallback == NULL) |
| { |
| hltdc->MspDeInitCallback = HAL_LTDC_MspDeInit; |
| } |
| /* DeInit the low level hardware */ |
| hltdc->MspDeInitCallback(hltdc); |
| #else |
| /* DeInit the low level hardware */ |
| HAL_LTDC_MspDeInit(hltdc); |
| #endif /* USE_HAL_LTDC_REGISTER_CALLBACKS */ |
| |
| /* Initialize the error code */ |
| hltdc->ErrorCode = HAL_LTDC_ERROR_NONE; |
| |
| /* Initialize the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_RESET; |
| |
| /* Release Lock */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Initialize the LTDC MSP. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval None |
| */ |
| __weak void HAL_LTDC_MspInit(LTDC_HandleTypeDef *hltdc) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hltdc); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_LTDC_MspInit could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @brief De-initialize the LTDC MSP. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval None |
| */ |
| __weak void HAL_LTDC_MspDeInit(LTDC_HandleTypeDef *hltdc) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hltdc); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_LTDC_MspDeInit could be implemented in the user file |
| */ |
| } |
| |
| #if (USE_HAL_LTDC_REGISTER_CALLBACKS == 1) |
| /** |
| * @brief Register a User LTDC Callback |
| * To be used instead of the weak predefined callback |
| * @param hltdc ltdc handle |
| * @param CallbackID ID of the callback to be registered |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_LTDC_LINE_EVENT_CB_ID Line Event Callback ID |
| * @arg @ref HAL_LTDC_RELOAD_EVENT_CB_ID Reload Event Callback ID |
| * @arg @ref HAL_LTDC_ERROR_CB_ID Error Callback ID |
| * @arg @ref HAL_LTDC_MSPINIT_CB_ID MspInit callback ID |
| * @arg @ref HAL_LTDC_MSPDEINIT_CB_ID MspDeInit callback ID |
| * @param pCallback pointer to the Callback function |
| * @retval status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_RegisterCallback(LTDC_HandleTypeDef *hltdc, HAL_LTDC_CallbackIDTypeDef CallbackID, pLTDC_CallbackTypeDef pCallback) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if (pCallback == NULL) |
| { |
| /* Update the error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_INVALID_CALLBACK; |
| |
| return HAL_ERROR; |
| } |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| if (hltdc->State == HAL_LTDC_STATE_READY) |
| { |
| switch (CallbackID) |
| { |
| case HAL_LTDC_LINE_EVENT_CB_ID : |
| hltdc->LineEventCallback = pCallback; |
| break; |
| |
| case HAL_LTDC_RELOAD_EVENT_CB_ID : |
| hltdc->ReloadEventCallback = pCallback; |
| break; |
| |
| case HAL_LTDC_ERROR_CB_ID : |
| hltdc->ErrorCallback = pCallback; |
| break; |
| |
| case HAL_LTDC_MSPINIT_CB_ID : |
| hltdc->MspInitCallback = pCallback; |
| break; |
| |
| case HAL_LTDC_MSPDEINIT_CB_ID : |
| hltdc->MspDeInitCallback = pCallback; |
| break; |
| |
| default : |
| /* Update the error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_INVALID_CALLBACK; |
| /* Return error status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if (hltdc->State == HAL_LTDC_STATE_RESET) |
| { |
| switch (CallbackID) |
| { |
| case HAL_LTDC_MSPINIT_CB_ID : |
| hltdc->MspInitCallback = pCallback; |
| break; |
| |
| case HAL_LTDC_MSPDEINIT_CB_ID : |
| hltdc->MspDeInitCallback = pCallback; |
| break; |
| |
| default : |
| /* Update the error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_INVALID_CALLBACK; |
| /* Return error status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* Update the error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_INVALID_CALLBACK; |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| |
| /* Release Lock */ |
| __HAL_UNLOCK(hltdc); |
| |
| return status; |
| } |
| |
| /** |
| * @brief Unregister an LTDC Callback |
| * LTDC callabck is redirected to the weak predefined callback |
| * @param hltdc ltdc handle |
| * @param CallbackID ID of the callback to be unregistered |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_LTDC_LINE_EVENT_CB_ID Line Event Callback ID |
| * @arg @ref HAL_LTDC_RELOAD_EVENT_CB_ID Reload Event Callback ID |
| * @arg @ref HAL_LTDC_ERROR_CB_ID Error Callback ID |
| * @arg @ref HAL_LTDC_MSPINIT_CB_ID MspInit callback ID |
| * @arg @ref HAL_LTDC_MSPDEINIT_CB_ID MspDeInit callback ID |
| * @retval status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_UnRegisterCallback(LTDC_HandleTypeDef *hltdc, HAL_LTDC_CallbackIDTypeDef CallbackID) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| if (hltdc->State == HAL_LTDC_STATE_READY) |
| { |
| switch (CallbackID) |
| { |
| case HAL_LTDC_LINE_EVENT_CB_ID : |
| hltdc->LineEventCallback = HAL_LTDC_LineEventCallback; /* Legacy weak LineEventCallback */ |
| break; |
| |
| case HAL_LTDC_RELOAD_EVENT_CB_ID : |
| hltdc->ReloadEventCallback = HAL_LTDC_ReloadEventCallback; /* Legacy weak ReloadEventCallback */ |
| break; |
| |
| case HAL_LTDC_ERROR_CB_ID : |
| hltdc->ErrorCallback = HAL_LTDC_ErrorCallback; /* Legacy weak ErrorCallback */ |
| break; |
| |
| case HAL_LTDC_MSPINIT_CB_ID : |
| hltdc->MspInitCallback = HAL_LTDC_MspInit; /* Legcay weak MspInit Callback */ |
| break; |
| |
| case HAL_LTDC_MSPDEINIT_CB_ID : |
| hltdc->MspDeInitCallback = HAL_LTDC_MspDeInit; /* Legcay weak MspDeInit Callback */ |
| break; |
| |
| default : |
| /* Update the error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_INVALID_CALLBACK; |
| /* Return error status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if (hltdc->State == HAL_LTDC_STATE_RESET) |
| { |
| switch (CallbackID) |
| { |
| case HAL_LTDC_MSPINIT_CB_ID : |
| hltdc->MspInitCallback = HAL_LTDC_MspInit; /* Legcay weak MspInit Callback */ |
| break; |
| |
| case HAL_LTDC_MSPDEINIT_CB_ID : |
| hltdc->MspDeInitCallback = HAL_LTDC_MspDeInit; /* Legcay weak MspDeInit Callback */ |
| break; |
| |
| default : |
| /* Update the error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_INVALID_CALLBACK; |
| /* Return error status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* Update the error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_INVALID_CALLBACK; |
| /* Return error status */ |
| status = HAL_ERROR; |
| } |
| |
| /* Release Lock */ |
| __HAL_UNLOCK(hltdc); |
| |
| return status; |
| } |
| #endif /* USE_HAL_LTDC_REGISTER_CALLBACKS */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup LTDC_Exported_Functions_Group2 IO operation functions |
| * @brief IO operation functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### IO operation functions ##### |
| =============================================================================== |
| [..] This section provides function allowing to: |
| (+) Handle LTDC interrupt request |
| |
| @endverbatim |
| * @{ |
| */ |
| /** |
| * @brief Handle LTDC interrupt request. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval HAL status |
| */ |
| void HAL_LTDC_IRQHandler(LTDC_HandleTypeDef *hltdc) |
| { |
| uint32_t isrflags = READ_REG(hltdc->Instance->ISR); |
| uint32_t itsources = READ_REG(hltdc->Instance->IER); |
| |
| /* Transfer Error Interrupt management ***************************************/ |
| if (((isrflags & LTDC_ISR_TERRIF) != 0U) && ((itsources & LTDC_IER_TERRIE) != 0U)) |
| { |
| /* Disable the transfer Error interrupt */ |
| __HAL_LTDC_DISABLE_IT(hltdc, LTDC_IT_TE); |
| |
| /* Clear the transfer error flag */ |
| __HAL_LTDC_CLEAR_FLAG(hltdc, LTDC_FLAG_TE); |
| |
| /* Update error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_TE; |
| |
| /* Change LTDC state */ |
| hltdc->State = HAL_LTDC_STATE_ERROR; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| /* Transfer error Callback */ |
| #if (USE_HAL_LTDC_REGISTER_CALLBACKS == 1) |
| /*Call registered error callback*/ |
| hltdc->ErrorCallback(hltdc); |
| #else |
| /* Call legacy error callback*/ |
| HAL_LTDC_ErrorCallback(hltdc); |
| #endif /* USE_HAL_LTDC_REGISTER_CALLBACKS */ |
| } |
| |
| /* FIFO underrun Interrupt management ***************************************/ |
| if (((isrflags & LTDC_ISR_FUIF) != 0U) && ((itsources & LTDC_IER_FUIE) != 0U)) |
| { |
| /* Disable the FIFO underrun interrupt */ |
| __HAL_LTDC_DISABLE_IT(hltdc, LTDC_IT_FU); |
| |
| /* Clear the FIFO underrun flag */ |
| __HAL_LTDC_CLEAR_FLAG(hltdc, LTDC_FLAG_FU); |
| |
| /* Update error code */ |
| hltdc->ErrorCode |= HAL_LTDC_ERROR_FU; |
| |
| /* Change LTDC state */ |
| hltdc->State = HAL_LTDC_STATE_ERROR; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| /* Transfer error Callback */ |
| #if (USE_HAL_LTDC_REGISTER_CALLBACKS == 1) |
| /*Call registered error callback*/ |
| hltdc->ErrorCallback(hltdc); |
| #else |
| /* Call legacy error callback*/ |
| HAL_LTDC_ErrorCallback(hltdc); |
| #endif /* USE_HAL_LTDC_REGISTER_CALLBACKS */ |
| } |
| |
| /* Line Interrupt management ************************************************/ |
| if (((isrflags & LTDC_ISR_LIF) != 0U) && ((itsources & LTDC_IER_LIE) != 0U)) |
| { |
| /* Disable the Line interrupt */ |
| __HAL_LTDC_DISABLE_IT(hltdc, LTDC_IT_LI); |
| |
| /* Clear the Line interrupt flag */ |
| __HAL_LTDC_CLEAR_FLAG(hltdc, LTDC_FLAG_LI); |
| |
| /* Change LTDC state */ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| /* Line interrupt Callback */ |
| #if (USE_HAL_LTDC_REGISTER_CALLBACKS == 1) |
| /*Call registered Line Event callback */ |
| hltdc->LineEventCallback(hltdc); |
| #else |
| /*Call Legacy Line Event callback */ |
| HAL_LTDC_LineEventCallback(hltdc); |
| #endif /* USE_HAL_LTDC_REGISTER_CALLBACKS */ |
| } |
| |
| /* Register reload Interrupt management ***************************************/ |
| if (((isrflags & LTDC_ISR_RRIF) != 0U) && ((itsources & LTDC_IER_RRIE) != 0U)) |
| { |
| /* Disable the register reload interrupt */ |
| __HAL_LTDC_DISABLE_IT(hltdc, LTDC_IT_RR); |
| |
| /* Clear the register reload flag */ |
| __HAL_LTDC_CLEAR_FLAG(hltdc, LTDC_FLAG_RR); |
| |
| /* Change LTDC state */ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| /* Reload interrupt Callback */ |
| #if (USE_HAL_LTDC_REGISTER_CALLBACKS == 1) |
| /*Call registered reload Event callback */ |
| hltdc->ReloadEventCallback(hltdc); |
| #else |
| /*Call Legacy Reload Event callback */ |
| HAL_LTDC_ReloadEventCallback(hltdc); |
| #endif /* USE_HAL_LTDC_REGISTER_CALLBACKS */ |
| } |
| } |
| |
| /** |
| * @brief Error LTDC callback. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval None |
| */ |
| __weak void HAL_LTDC_ErrorCallback(LTDC_HandleTypeDef *hltdc) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hltdc); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_LTDC_ErrorCallback could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @brief Line Event callback. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval None |
| */ |
| __weak void HAL_LTDC_LineEventCallback(LTDC_HandleTypeDef *hltdc) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hltdc); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_LTDC_LineEventCallback could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @brief Reload Event callback. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval None |
| */ |
| __weak void HAL_LTDC_ReloadEventCallback(LTDC_HandleTypeDef *hltdc) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hltdc); |
| |
| /* NOTE : This function should not be modified, when the callback is needed, |
| the HAL_LTDC_ReloadEvenCallback could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup LTDC_Exported_Functions_Group3 Peripheral Control functions |
| * @brief Peripheral Control functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Peripheral Control functions ##### |
| =============================================================================== |
| [..] This section provides functions allowing to: |
| (+) Configure the LTDC foreground or/and background parameters. |
| (+) Set the active layer. |
| (+) Configure the color keying. |
| (+) Configure the C-LUT. |
| (+) Enable / Disable the color keying. |
| (+) Enable / Disable the C-LUT. |
| (+) Update the layer position. |
| (+) Update the layer size. |
| (+) Update pixel format on the fly. |
| (+) Update transparency on the fly. |
| (+) Update address on the fly. |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Configure the LTDC Layer according to the specified |
| * parameters in the LTDC_InitTypeDef and create the associated handle. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param pLayerCfg pointer to a LTDC_LayerCfgTypeDef structure that contains |
| * the configuration information for the Layer. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_ConfigLayer(LTDC_HandleTypeDef *hltdc, LTDC_LayerCfgTypeDef *pLayerCfg, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| assert_param(IS_LTDC_HCONFIGST(pLayerCfg->WindowX0)); |
| assert_param(IS_LTDC_HCONFIGSP(pLayerCfg->WindowX1)); |
| assert_param(IS_LTDC_VCONFIGST(pLayerCfg->WindowY0)); |
| assert_param(IS_LTDC_VCONFIGSP(pLayerCfg->WindowY1)); |
| assert_param(IS_LTDC_PIXEL_FORMAT(pLayerCfg->PixelFormat)); |
| assert_param(IS_LTDC_ALPHA(pLayerCfg->Alpha)); |
| assert_param(IS_LTDC_ALPHA(pLayerCfg->Alpha0)); |
| assert_param(IS_LTDC_BLENDING_FACTOR1(pLayerCfg->BlendingFactor1)); |
| assert_param(IS_LTDC_BLENDING_FACTOR2(pLayerCfg->BlendingFactor2)); |
| assert_param(IS_LTDC_CFBLL(pLayerCfg->ImageWidth)); |
| assert_param(IS_LTDC_CFBLNBR(pLayerCfg->ImageHeight)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Copy new layer configuration into handle structure */ |
| hltdc->LayerCfg[LayerIdx] = *pLayerCfg; |
| |
| /* Configure the LTDC Layer */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Initialize the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Configure the color keying. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param RGBValue the color key value |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_ConfigColorKeying(LTDC_HandleTypeDef *hltdc, uint32_t RGBValue, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Configure the default color values */ |
| LTDC_LAYER(hltdc, LayerIdx)->CKCR &= ~(LTDC_LxCKCR_CKBLUE | LTDC_LxCKCR_CKGREEN | LTDC_LxCKCR_CKRED); |
| LTDC_LAYER(hltdc, LayerIdx)->CKCR = RGBValue; |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Load the color lookup table. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param pCLUT pointer to the color lookup table address. |
| * @param CLUTSize the color lookup table size. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_ConfigCLUT(LTDC_HandleTypeDef *hltdc, uint32_t *pCLUT, uint32_t CLUTSize, uint32_t LayerIdx) |
| { |
| uint32_t tmp; |
| uint32_t counter; |
| uint32_t *pcolorlut = pCLUT; |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| for (counter = 0U; (counter < CLUTSize); counter++) |
| { |
| if (hltdc->LayerCfg[LayerIdx].PixelFormat == LTDC_PIXEL_FORMAT_AL44) |
| { |
| tmp = (((counter + (16U*counter)) << 24U) | ((uint32_t)(*pcolorlut) & 0xFFU) | ((uint32_t)(*pcolorlut) & 0xFF00U) | ((uint32_t)(*pcolorlut) & 0xFF0000U)); |
| } |
| else |
| { |
| tmp = ((counter << 24U) | ((uint32_t)(*pcolorlut) & 0xFFU) | ((uint32_t)(*pcolorlut) & 0xFF00U) | ((uint32_t)(*pcolorlut) & 0xFF0000U)); |
| } |
| |
| pcolorlut++; |
| |
| /* Specifies the C-LUT address and RGB value */ |
| LTDC_LAYER(hltdc, LayerIdx)->CLUTWR = tmp; |
| } |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Enable the color keying. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_EnableColorKeying(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Enable LTDC color keying by setting COLKEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR |= (uint32_t)LTDC_LxCR_COLKEN; |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Disable the color keying. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_DisableColorKeying(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Disable LTDC color keying by setting COLKEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR &= ~(uint32_t)LTDC_LxCR_COLKEN; |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Enable the color lookup table. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_EnableCLUT(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Enable LTDC color lookup table by setting CLUTEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR |= (uint32_t)LTDC_LxCR_CLUTEN; |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Disable the color lookup table. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_DisableCLUT(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Disable LTDC color lookup table by setting CLUTEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR &= ~(uint32_t)LTDC_LxCR_CLUTEN; |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Enable Dither. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval HAL status |
| */ |
| |
| HAL_StatusTypeDef HAL_LTDC_EnableDither(LTDC_HandleTypeDef *hltdc) |
| { |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Enable Dither by setting DTEN bit */ |
| LTDC->GCR |= (uint32_t)LTDC_GCR_DEN; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Disable Dither. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval HAL status |
| */ |
| |
| HAL_StatusTypeDef HAL_LTDC_DisableDither(LTDC_HandleTypeDef *hltdc) |
| { |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Disable Dither by setting DTEN bit */ |
| LTDC->GCR &= ~(uint32_t)LTDC_GCR_DEN; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Set the LTDC window size. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param XSize LTDC Pixel per line |
| * @param YSize LTDC Line number |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetWindowSize(LTDC_HandleTypeDef *hltdc, uint32_t XSize, uint32_t YSize, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters (Layers parameters)*/ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| assert_param(IS_LTDC_CFBLL(XSize)); |
| assert_param(IS_LTDC_CFBLNBR(YSize)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* update horizontal stop */ |
| pLayerCfg->WindowX1 = XSize + pLayerCfg->WindowX0; |
| |
| /* update vertical stop */ |
| pLayerCfg->WindowY1 = YSize + pLayerCfg->WindowY0; |
| |
| /* Reconfigures the color frame buffer pitch in byte */ |
| pLayerCfg->ImageWidth = XSize; |
| |
| /* Reconfigures the frame buffer line number */ |
| pLayerCfg->ImageHeight = YSize; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Set the LTDC window position. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param X0 LTDC window X offset |
| * @param Y0 LTDC window Y offset |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetWindowPosition(LTDC_HandleTypeDef *hltdc, uint32_t X0, uint32_t Y0, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| assert_param(IS_LTDC_CFBLL(X0)); |
| assert_param(IS_LTDC_CFBLNBR(Y0)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* update horizontal start/stop */ |
| pLayerCfg->WindowX0 = X0; |
| pLayerCfg->WindowX1 = X0 + pLayerCfg->ImageWidth; |
| |
| /* update vertical start/stop */ |
| pLayerCfg->WindowY0 = Y0; |
| pLayerCfg->WindowY1 = Y0 + pLayerCfg->ImageHeight; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Reconfigure the pixel format. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param Pixelformat new pixel format value. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1). |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetPixelFormat(LTDC_HandleTypeDef *hltdc, uint32_t Pixelformat, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_PIXEL_FORMAT(Pixelformat)); |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* Reconfigure the pixel format */ |
| pLayerCfg->PixelFormat = Pixelformat; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Reconfigure the layer alpha value. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param Alpha new alpha value. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetAlpha(LTDC_HandleTypeDef *hltdc, uint32_t Alpha, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_ALPHA(Alpha)); |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* Reconfigure the Alpha value */ |
| pLayerCfg->Alpha = Alpha; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| /** |
| * @brief Reconfigure the frame buffer Address. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param Address new address value. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1). |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetAddress(LTDC_HandleTypeDef *hltdc, uint32_t Address, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* Reconfigure the Address */ |
| pLayerCfg->FBStartAdress = Address; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Set the Immediate Reload type */ |
| hltdc->Instance->SRCR = LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Function used to reconfigure the pitch for specific cases where the attached LayerIdx buffer have a width that is |
| * larger than the one intended to be displayed on screen. Example of a buffer 800x480 attached to layer for which we |
| * want to read and display on screen only a portion 320x240 taken in the center of the buffer. The pitch in pixels |
| * will be in that case 800 pixels and not 320 pixels as initially configured by previous call to HAL_LTDC_ConfigLayer(). |
| * @note This function should be called only after a previous call to HAL_LTDC_ConfigLayer() to modify the default pitch |
| * configured by HAL_LTDC_ConfigLayer() when required (refer to example described just above). |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LinePitchInPixels New line pitch in pixels to configure for LTDC layer 'LayerIdx'. |
| * @param LayerIdx LTDC layer index concerned by the modification of line pitch. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetPitch(LTDC_HandleTypeDef *hltdc, uint32_t LinePitchInPixels, uint32_t LayerIdx) |
| { |
| uint32_t tmp; |
| uint32_t pitchUpdate; |
| uint32_t pixelFormat; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* get LayerIdx used pixel format */ |
| pixelFormat = hltdc->LayerCfg[LayerIdx].PixelFormat; |
| |
| if (pixelFormat == LTDC_PIXEL_FORMAT_ARGB8888) |
| { |
| tmp = 4U; |
| } |
| else if (pixelFormat == LTDC_PIXEL_FORMAT_RGB888) |
| { |
| tmp = 3U; |
| } |
| else if ((pixelFormat == LTDC_PIXEL_FORMAT_ARGB4444) || \ |
| (pixelFormat == LTDC_PIXEL_FORMAT_RGB565) || \ |
| (pixelFormat == LTDC_PIXEL_FORMAT_ARGB1555) || \ |
| (pixelFormat == LTDC_PIXEL_FORMAT_AL88)) |
| { |
| tmp = 2U; |
| } |
| else |
| { |
| tmp = 1U; |
| } |
| |
| pitchUpdate = ((LinePitchInPixels * tmp) << 16U); |
| |
| /* Clear previously set standard pitch */ |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLR &= ~LTDC_LxCFBLR_CFBP; |
| |
| /* Set the Reload type as immediate update of LTDC pitch configured above */ |
| LTDC->SRCR |= LTDC_SRCR_IMR; |
| |
| /* Set new line pitch value */ |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLR |= pitchUpdate; |
| |
| /* Set the Reload type as immediate update of LTDC pitch configured above */ |
| LTDC->SRCR |= LTDC_SRCR_IMR; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Define the position of the line interrupt. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param Line Line Interrupt Position. |
| * @note User application may resort to HAL_LTDC_LineEventCallback() at line interrupt generation. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_ProgramLineEvent(LTDC_HandleTypeDef *hltdc, uint32_t Line) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LIPOS(Line)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Disable the Line interrupt */ |
| __HAL_LTDC_DISABLE_IT(hltdc, LTDC_IT_LI); |
| |
| /* Set the Line Interrupt position */ |
| LTDC->LIPCR = (uint32_t)Line; |
| |
| /* Enable the Line interrupt */ |
| __HAL_LTDC_ENABLE_IT(hltdc, LTDC_IT_LI); |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Reload LTDC Layers configuration. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param ReloadType This parameter can be one of the following values : |
| * LTDC_RELOAD_IMMEDIATE : Immediate Reload |
| * LTDC_RELOAD_VERTICAL_BLANKING : Reload in the next Vertical Blanking |
| * @note User application may resort to HAL_LTDC_ReloadEventCallback() at reload interrupt generation. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_Reload(LTDC_HandleTypeDef *hltdc, uint32_t ReloadType) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_RELOAD(ReloadType)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Enable the Reload interrupt */ |
| __HAL_LTDC_ENABLE_IT(hltdc, LTDC_IT_RR); |
| |
| /* Apply Reload type */ |
| hltdc->Instance->SRCR = ReloadType; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Configure the LTDC Layer according to the specified without reloading |
| * parameters in the LTDC_InitTypeDef and create the associated handle. |
| * Variant of the function HAL_LTDC_ConfigLayer without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param pLayerCfg pointer to a LTDC_LayerCfgTypeDef structure that contains |
| * the configuration information for the Layer. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_ConfigLayer_NoReload(LTDC_HandleTypeDef *hltdc, LTDC_LayerCfgTypeDef *pLayerCfg, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| assert_param(IS_LTDC_HCONFIGST(pLayerCfg->WindowX0)); |
| assert_param(IS_LTDC_HCONFIGSP(pLayerCfg->WindowX1)); |
| assert_param(IS_LTDC_VCONFIGST(pLayerCfg->WindowY0)); |
| assert_param(IS_LTDC_VCONFIGSP(pLayerCfg->WindowY1)); |
| assert_param(IS_LTDC_PIXEL_FORMAT(pLayerCfg->PixelFormat)); |
| assert_param(IS_LTDC_ALPHA(pLayerCfg->Alpha)); |
| assert_param(IS_LTDC_ALPHA(pLayerCfg->Alpha0)); |
| assert_param(IS_LTDC_BLENDING_FACTOR1(pLayerCfg->BlendingFactor1)); |
| assert_param(IS_LTDC_BLENDING_FACTOR2(pLayerCfg->BlendingFactor2)); |
| assert_param(IS_LTDC_CFBLL(pLayerCfg->ImageWidth)); |
| assert_param(IS_LTDC_CFBLNBR(pLayerCfg->ImageHeight)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Copy new layer configuration into handle structure */ |
| hltdc->LayerCfg[LayerIdx] = *pLayerCfg; |
| |
| /* Configure the LTDC Layer */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Initialize the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Set the LTDC window size without reloading. |
| * Variant of the function HAL_LTDC_SetWindowSize without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param XSize LTDC Pixel per line |
| * @param YSize LTDC Line number |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetWindowSize_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t XSize, uint32_t YSize, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters (Layers parameters)*/ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| assert_param(IS_LTDC_CFBLL(XSize)); |
| assert_param(IS_LTDC_CFBLNBR(YSize)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* update horizontal stop */ |
| pLayerCfg->WindowX1 = XSize + pLayerCfg->WindowX0; |
| |
| /* update vertical stop */ |
| pLayerCfg->WindowY1 = YSize + pLayerCfg->WindowY0; |
| |
| /* Reconfigures the color frame buffer pitch in byte */ |
| pLayerCfg->ImageWidth = XSize; |
| |
| /* Reconfigures the frame buffer line number */ |
| pLayerCfg->ImageHeight = YSize; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Set the LTDC window position without reloading. |
| * Variant of the function HAL_LTDC_SetWindowPosition without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param X0 LTDC window X offset |
| * @param Y0 LTDC window Y offset |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetWindowPosition_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t X0, uint32_t Y0, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| assert_param(IS_LTDC_CFBLL(X0)); |
| assert_param(IS_LTDC_CFBLNBR(Y0)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* update horizontal start/stop */ |
| pLayerCfg->WindowX0 = X0; |
| pLayerCfg->WindowX1 = X0 + pLayerCfg->ImageWidth; |
| |
| /* update vertical start/stop */ |
| pLayerCfg->WindowY0 = Y0; |
| pLayerCfg->WindowY1 = Y0 + pLayerCfg->ImageHeight; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Reconfigure the pixel format without reloading. |
| * Variant of the function HAL_LTDC_SetPixelFormat without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDfef structure that contains |
| * the configuration information for the LTDC. |
| * @param Pixelformat new pixel format value. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1). |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetPixelFormat_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t Pixelformat, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_PIXEL_FORMAT(Pixelformat)); |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* Reconfigure the pixel format */ |
| pLayerCfg->PixelFormat = Pixelformat; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Reconfigure the layer alpha value without reloading. |
| * Variant of the function HAL_LTDC_SetAlpha without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param Alpha new alpha value. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetAlpha_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t Alpha, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_ALPHA(Alpha)); |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* Reconfigure the Alpha value */ |
| pLayerCfg->Alpha = Alpha; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Reconfigure the frame buffer Address without reloading. |
| * Variant of the function HAL_LTDC_SetAddress without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param Address new address value. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1). |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetAddress_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t Address, uint32_t LayerIdx) |
| { |
| LTDC_LayerCfgTypeDef *pLayerCfg; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Get layer configuration from handle structure */ |
| pLayerCfg = &hltdc->LayerCfg[LayerIdx]; |
| |
| /* Reconfigure the Address */ |
| pLayerCfg->FBStartAdress = Address; |
| |
| /* Set LTDC parameters */ |
| LTDC_SetConfig(hltdc, pLayerCfg, LayerIdx); |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Function used to reconfigure the pitch for specific cases where the attached LayerIdx buffer have a width that is |
| * larger than the one intended to be displayed on screen. Example of a buffer 800x480 attached to layer for which we |
| * want to read and display on screen only a portion 320x240 taken in the center of the buffer. The pitch in pixels |
| * will be in that case 800 pixels and not 320 pixels as initially configured by previous call to HAL_LTDC_ConfigLayer(). |
| * @note This function should be called only after a previous call to HAL_LTDC_ConfigLayer() to modify the default pitch |
| * configured by HAL_LTDC_ConfigLayer() when required (refer to example described just above). |
| * Variant of the function HAL_LTDC_SetPitch without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LinePitchInPixels New line pitch in pixels to configure for LTDC layer 'LayerIdx'. |
| * @param LayerIdx LTDC layer index concerned by the modification of line pitch. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_SetPitch_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LinePitchInPixels, uint32_t LayerIdx) |
| { |
| uint32_t tmp; |
| uint32_t pitchUpdate; |
| uint32_t pixelFormat; |
| |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* get LayerIdx used pixel format */ |
| pixelFormat = hltdc->LayerCfg[LayerIdx].PixelFormat; |
| |
| if (pixelFormat == LTDC_PIXEL_FORMAT_ARGB8888) |
| { |
| tmp = 4U; |
| } |
| else if (pixelFormat == LTDC_PIXEL_FORMAT_RGB888) |
| { |
| tmp = 3U; |
| } |
| else if ((pixelFormat == LTDC_PIXEL_FORMAT_ARGB4444) || \ |
| (pixelFormat == LTDC_PIXEL_FORMAT_RGB565) || \ |
| (pixelFormat == LTDC_PIXEL_FORMAT_ARGB1555) || \ |
| (pixelFormat == LTDC_PIXEL_FORMAT_AL88)) |
| { |
| tmp = 2U; |
| } |
| else |
| { |
| tmp = 1U; |
| } |
| |
| pitchUpdate = ((LinePitchInPixels * tmp) << 16U); |
| |
| /* Clear previously set standard pitch */ |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLR &= ~LTDC_LxCFBLR_CFBP; |
| |
| /* Set new line pitch value */ |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLR |= pitchUpdate; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| |
| /** |
| * @brief Configure the color keying without reloading. |
| * Variant of the function HAL_LTDC_ConfigColorKeying without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param RGBValue the color key value |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_ConfigColorKeying_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t RGBValue, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Configure the default color values */ |
| LTDC_LAYER(hltdc, LayerIdx)->CKCR &= ~(LTDC_LxCKCR_CKBLUE | LTDC_LxCKCR_CKGREEN | LTDC_LxCKCR_CKRED); |
| LTDC_LAYER(hltdc, LayerIdx)->CKCR = RGBValue; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Enable the color keying without reloading. |
| * Variant of the function HAL_LTDC_EnableColorKeying without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_EnableColorKeying_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Enable LTDC color keying by setting COLKEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR |= (uint32_t)LTDC_LxCR_COLKEN; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Disable the color keying without reloading. |
| * Variant of the function HAL_LTDC_DisableColorKeying without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_DisableColorKeying_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Disable LTDC color keying by setting COLKEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR &= ~(uint32_t)LTDC_LxCR_COLKEN; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Enable the color lookup table without reloading. |
| * Variant of the function HAL_LTDC_EnableCLUT without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_EnableCLUT_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Disable LTDC color lookup table by setting CLUTEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR |= (uint32_t)LTDC_LxCR_CLUTEN; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Disable the color lookup table without reloading. |
| * Variant of the function HAL_LTDC_DisableCLUT without immediate reload. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: |
| * LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_LTDC_DisableCLUT_NoReload(LTDC_HandleTypeDef *hltdc, uint32_t LayerIdx) |
| { |
| /* Check the parameters */ |
| assert_param(IS_LTDC_LAYER(LayerIdx)); |
| |
| /* Process locked */ |
| __HAL_LOCK(hltdc); |
| |
| /* Change LTDC peripheral state */ |
| hltdc->State = HAL_LTDC_STATE_BUSY; |
| |
| /* Disable LTDC color lookup table by setting CLUTEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR &= ~(uint32_t)LTDC_LxCR_CLUTEN; |
| |
| /* Change the LTDC state*/ |
| hltdc->State = HAL_LTDC_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hltdc); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup LTDC_Exported_Functions_Group4 Peripheral State and Errors functions |
| * @brief Peripheral State and Errors functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Peripheral State and Errors functions ##### |
| =============================================================================== |
| [..] |
| This subsection provides functions allowing to |
| (+) Check the LTDC handle state. |
| (+) Get the LTDC handle error code. |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Return the LTDC handle state. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval HAL state |
| */ |
| HAL_LTDC_StateTypeDef HAL_LTDC_GetState(LTDC_HandleTypeDef *hltdc) |
| { |
| return hltdc->State; |
| } |
| |
| /** |
| * @brief Return the LTDC handle error code. |
| * @param hltdc pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @retval LTDC Error Code |
| */ |
| uint32_t HAL_LTDC_GetError(LTDC_HandleTypeDef *hltdc) |
| { |
| return hltdc->ErrorCode; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup LTDC_Private_Functions LTDC Private Functions |
| * @{ |
| */ |
| |
| /** |
| * @brief Configure the LTDC peripheral |
| * @param hltdc Pointer to a LTDC_HandleTypeDef structure that contains |
| * the configuration information for the LTDC. |
| * @param pLayerCfg Pointer LTDC Layer Configuration structure |
| * @param LayerIdx LTDC Layer index. |
| * This parameter can be one of the following values: LTDC_LAYER_1 (0) or LTDC_LAYER_2 (1) |
| * @retval None |
| */ |
| static void LTDC_SetConfig(LTDC_HandleTypeDef *hltdc, LTDC_LayerCfgTypeDef *pLayerCfg, uint32_t LayerIdx) |
| { |
| uint32_t tmp; |
| uint32_t tmp1; |
| uint32_t tmp2; |
| |
| /* Configure the horizontal start and stop position */ |
| tmp = ((pLayerCfg->WindowX1 + ((hltdc->Instance->BPCR & LTDC_BPCR_AHBP) >> 16U)) << 16U); |
| LTDC_LAYER(hltdc, LayerIdx)->WHPCR &= ~(LTDC_LxWHPCR_WHSTPOS | LTDC_LxWHPCR_WHSPPOS); |
| LTDC_LAYER(hltdc, LayerIdx)->WHPCR = ((pLayerCfg->WindowX0 + ((hltdc->Instance->BPCR & LTDC_BPCR_AHBP) >> 16U) + 1U) | tmp); |
| |
| /* Configure the vertical start and stop position */ |
| tmp = ((pLayerCfg->WindowY1 + (hltdc->Instance->BPCR & LTDC_BPCR_AVBP)) << 16U); |
| LTDC_LAYER(hltdc, LayerIdx)->WVPCR &= ~(LTDC_LxWVPCR_WVSTPOS | LTDC_LxWVPCR_WVSPPOS); |
| LTDC_LAYER(hltdc, LayerIdx)->WVPCR = ((pLayerCfg->WindowY0 + (hltdc->Instance->BPCR & LTDC_BPCR_AVBP) + 1U) | tmp); |
| |
| /* Specifies the pixel format */ |
| LTDC_LAYER(hltdc, LayerIdx)->PFCR &= ~(LTDC_LxPFCR_PF); |
| LTDC_LAYER(hltdc, LayerIdx)->PFCR = (pLayerCfg->PixelFormat); |
| |
| /* Configure the default color values */ |
| tmp = ((uint32_t)(pLayerCfg->Backcolor.Green) << 8U); |
| tmp1 = ((uint32_t)(pLayerCfg->Backcolor.Red) << 16U); |
| tmp2 = (pLayerCfg->Alpha0 << 24U); |
| LTDC_LAYER(hltdc, LayerIdx)->DCCR &= ~(LTDC_LxDCCR_DCBLUE | LTDC_LxDCCR_DCGREEN | LTDC_LxDCCR_DCRED | LTDC_LxDCCR_DCALPHA); |
| LTDC_LAYER(hltdc, LayerIdx)->DCCR = (pLayerCfg->Backcolor.Blue | tmp | tmp1 | tmp2); |
| |
| /* Specifies the constant alpha value */ |
| LTDC_LAYER(hltdc, LayerIdx)->CACR &= ~(LTDC_LxCACR_CONSTA); |
| LTDC_LAYER(hltdc, LayerIdx)->CACR = (pLayerCfg->Alpha); |
| |
| /* Specifies the blending factors */ |
| LTDC_LAYER(hltdc, LayerIdx)->BFCR &= ~(LTDC_LxBFCR_BF2 | LTDC_LxBFCR_BF1); |
| LTDC_LAYER(hltdc, LayerIdx)->BFCR = (pLayerCfg->BlendingFactor1 | pLayerCfg->BlendingFactor2); |
| |
| /* Configure the color frame buffer start address */ |
| LTDC_LAYER(hltdc, LayerIdx)->CFBAR &= ~(LTDC_LxCFBAR_CFBADD); |
| LTDC_LAYER(hltdc, LayerIdx)->CFBAR = (pLayerCfg->FBStartAdress); |
| |
| if (pLayerCfg->PixelFormat == LTDC_PIXEL_FORMAT_ARGB8888) |
| { |
| tmp = 4U; |
| } |
| else if (pLayerCfg->PixelFormat == LTDC_PIXEL_FORMAT_RGB888) |
| { |
| tmp = 3U; |
| } |
| else if ((pLayerCfg->PixelFormat == LTDC_PIXEL_FORMAT_ARGB4444) || \ |
| (pLayerCfg->PixelFormat == LTDC_PIXEL_FORMAT_RGB565) || \ |
| (pLayerCfg->PixelFormat == LTDC_PIXEL_FORMAT_ARGB1555) || \ |
| (pLayerCfg->PixelFormat == LTDC_PIXEL_FORMAT_AL88)) |
| { |
| tmp = 2U; |
| } |
| else |
| { |
| tmp = 1U; |
| } |
| |
| /* Configure the color frame buffer pitch in byte */ |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLR &= ~(LTDC_LxCFBLR_CFBLL | LTDC_LxCFBLR_CFBP); |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLR = (((pLayerCfg->ImageWidth * tmp) << 16U) | (((pLayerCfg->WindowX1 - pLayerCfg->WindowX0) * tmp) + 7U)); |
| /* Configure the frame buffer line number */ |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLNR &= ~(LTDC_LxCFBLNR_CFBLNBR); |
| LTDC_LAYER(hltdc, LayerIdx)->CFBLNR = (pLayerCfg->ImageHeight); |
| |
| /* Enable LTDC_Layer by setting LEN bit */ |
| LTDC_LAYER(hltdc, LayerIdx)->CR |= (uint32_t)LTDC_LxCR_LEN; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* LTDC */ |
| |
| #endif /* HAL_LTDC_MODULE_ENABLED */ |
| |
| /** |
| * @} |
| */ |
| |
| /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |