1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894 |
- /**
- ******************************************************************************
- * @file stm32f4xx_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 #####
- ==============================================================================
- [..]
- (#) Program 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
- (#) 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(), HAL_LTDC_SetAddress.
- (#) Variant functions with “_NoReload” post fix 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 can 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 a LTDC Layer.
- (+) __HAL_LTDC_LAYER_DISABLE: Disable a LTDC Layer.
- (+) __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.
-
- [..]
- (@) You can refer to the LTDC HAL driver header file for more useful macros
-
- @endverbatim
- ******************************************************************************
- * @attention
- *
- * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- * 1. Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- * 2. Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- * 3. Neither the name of STMicroelectronics nor the names of its contributors
- * may be used to endorse or promote products derived from this software
- * without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
- * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
- * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
- * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- ******************************************************************************
- */
- /* Includes ------------------------------------------------------------------*/
- #include "stm32f4xx_hal.h"
- /** @addtogroup STM32F4xx_HAL_Driver
- * @{
- */
- /** @defgroup LTDC LTDC
- * @brief LTDC HAL module driver
- * @{
- */
- #ifdef HAL_LTDC_MODULE_ENABLED
- #if defined(STM32F429xx) || defined(STM32F439xx) || defined(STM32F469xx) || defined(STM32F479xx)
- /* 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 = 0U, tmp1 = 0U;
- /* 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(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);
- }
-
- /* 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)
- {
- /* DeInit the low level hardware */
- HAL_LTDC_MspDeInit(hltdc);
- /* 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
- */
- }
- /**
- * @}
- */
-
- /** @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) != RESET) && ((itsources & LTDC_IER_TERRIE) != RESET))
- {
- /* 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 */
- HAL_LTDC_ErrorCallback(hltdc);
- }
- /* FIFO underrun Interrupt management ***************************************/
- if(((isrflags & LTDC_ISR_FUIF) != RESET) && ((itsources & LTDC_IER_FUIE) != RESET))
- {
- /* 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 */
- HAL_LTDC_ErrorCallback(hltdc);
- }
- /* Line Interrupt management ************************************************/
- if(((isrflags & LTDC_ISR_LIF) != RESET) && ((itsources & LTDC_IER_LIE) != RESET))
- {
- /* 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 */
- HAL_LTDC_LineEventCallback(hltdc);
- }
- /* Register reload Interrupt management ***************************************/
- if(((isrflags & LTDC_ISR_RRIF) != RESET) && ((itsources & LTDC_IER_RRIE) != RESET))
- {
- /* 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);
-
- /* Register reload interrupt Callback */
- HAL_LTDC_ReloadEventCallback(hltdc);
- }
- }
- /**
- * @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 = 0U;
- uint32_t counter = 0U;
- uint32_t pcounter = 0U;
- /* 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)(*pCLUT) & 0xFFU) | ((uint32_t)(*pCLUT) & 0xFF00U) | ((uint32_t)(*pCLUT) & 0xFF0000U));
- }
- else
- {
- tmp = ((counter << 24U) | ((uint32_t)(*pCLUT) & 0xFFU) | ((uint32_t)(*pCLUT) & 0xFF00U) | ((uint32_t)(*pCLUT) & 0xFF0000U));
- }
- pcounter = (uint32_t)pCLUT + sizeof(*pCLUT);
- pCLUT = (uint32_t *)pcounter;
- /* 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 = 0U;
- uint32_t pitchUpdate = 0U;
- uint32_t pixelFormat = 0U;
- /* 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);
- /* Do not set the Immediate Reload */
- /* 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);
- /* Do not set the Immediate Reload */
- /* 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);
- /* Do not set the Immediate Reload */
- /* 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);
- /* Do not set the Immediate Reload */
- /* 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);
- /* Do not set the Immediate Reload */
- /* 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);
- /* Do not set the Immediate Reload */
- /* 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 = 0U;
- uint32_t pitchUpdate = 0U;
- uint32_t pixelFormat = 0U;
-
- /* 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;
-
- /* Do not set the Immediate Reload */
-
- /* 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;
- /* Do not set the Immediate Reload */
- /* 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;
- /* Do not set the Immediate Reload */
- /* 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;
- /* Do not set the Immediate Reload */
- /* 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;
- /* Do not set the Immediate Reload */
- /* 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;
- /* Do not set the Immediate Reload */
- /* 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 = 0U;
- uint32_t tmp1 = 0U;
- uint32_t tmp2 = 0U;
- /* 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) + 3U));
- /* 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 /* STM32F429xx || STM32F439xx || STM32F469xx || STM32F479xx */
- #endif /* HAL_LTDC_MODULE_ENABLED */
- /**
- * @}
- */
- /**
- * @}
- */
- /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|