2221 lines
70 KiB
C
2221 lines
70 KiB
C
/**
|
|
******************************************************************************
|
|
* @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
|
|
*
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* Copyright (c) 2017 STMicroelectronics.
|
|
* All rights reserved.
|
|
*
|
|
* This software is licensed under terms that can be found in the LICENSE file
|
|
* in the root directory of this software component.
|
|
* If no LICENSE file comes with this software, it is provided AS-IS.
|
|
*
|
|
******************************************************************************
|
|
@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
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* 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 ------------------------------------------------------------*/
|
|
/** @defgroup LTDC_Private_Define LTDC Private Define
|
|
* @{
|
|
*/
|
|
#define LTDC_TIMEOUT_VALUE ((uint32_t)100U) /* 100ms */
|
|
/**
|
|
* @}
|
|
*/
|
|
/* 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;
|
|
uint32_t 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)
|
|
{
|
|
uint32_t tickstart;
|
|
|
|
/* Check the LTDC peripheral state */
|
|
if (hltdc == NULL)
|
|
{
|
|
return HAL_ERROR;
|
|
}
|
|
|
|
/* Check function parameters */
|
|
assert_param(IS_LTDC_ALL_INSTANCE(hltdc->Instance));
|
|
|
|
/* Disable LTDC Layer 1 */
|
|
__HAL_LTDC_LAYER_DISABLE(hltdc, LTDC_LAYER_1);
|
|
|
|
#if defined(LTDC_Layer2_BASE)
|
|
/* Disable LTDC Layer 2 */
|
|
__HAL_LTDC_LAYER_DISABLE(hltdc, LTDC_LAYER_2);
|
|
#endif /* LTDC_Layer2_BASE */
|
|
|
|
/* Reload during vertical blanking period */
|
|
__HAL_LTDC_VERTICAL_BLANKING_RELOAD_CONFIG(hltdc);
|
|
|
|
/* Get tick */
|
|
tickstart = HAL_GetTick();
|
|
|
|
/* Wait for VSYNC Interrupt */
|
|
while (READ_BIT(hltdc->Instance->CDSR, LTDC_CDSR_VSYNCS) == 0U)
|
|
{
|
|
/* Check for the Timeout */
|
|
if ((HAL_GetTick() - tickstart) > LTDC_TIMEOUT_VALUE)
|
|
{
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* Disable LTDC */
|
|
__HAL_LTDC_DISABLE(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 callback 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 */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|