123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623 |
- /**
- ******************************************************************************
- * @file stm32f4xx_hal_spdifrx.c
- * @author MCD Application Team
- * @brief This file provides firmware functions to manage the following
- * functionalities of the SPDIFRX audio interface:
- * + Initialization and Configuration
- * + Data transfers functions
- * + DMA transfers management
- * + Interrupts and flags management
- @verbatim
- ===============================================================================
- ##### How to use this driver #####
- ===============================================================================
- [..]
- The SPDIFRX HAL driver can be used as follow:
- (#) Declare SPDIFRX_HandleTypeDef handle structure.
- (#) Initialize the SPDIFRX low level resources by implement the HAL_SPDIFRX_MspInit() API:
- (##) Enable the SPDIFRX interface clock.
- (##) SPDIFRX pins configuration:
- (+++) Enable the clock for the SPDIFRX GPIOs.
- (+++) Configure these SPDIFRX pins as alternate function pull-up.
- (##) NVIC configuration if you need to use interrupt process (HAL_SPDIFRX_ReceiveControlFlow_IT() and HAL_SPDIFRX_ReceiveDataFlow_IT() API's).
- (+++) Configure the SPDIFRX interrupt priority.
- (+++) Enable the NVIC SPDIFRX IRQ handle.
- (##) DMA Configuration if you need to use DMA process (HAL_SPDIFRX_ReceiveDataFlow_DMA() and HAL_SPDIFRX_ReceiveControlFlow_DMA() API's).
- (+++) Declare a DMA handle structure for the reception of the Data Flow channel.
- (+++) Declare a DMA handle structure for the reception of the Control Flow channel.
- (+++) Enable the DMAx interface clock.
- (+++) Configure the declared DMA handle structure CtrlRx/DataRx with the required parameters.
- (+++) Configure the DMA Channel.
- (+++) Associate the initialized DMA handle to the SPDIFRX DMA CtrlRx/DataRx handle.
- (+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the
- DMA CtrlRx/DataRx channel.
- (#) Program the input selection, re-tries number, wait for activity, channel status selection, data format, stereo mode and masking of user bits
- using HAL_SPDIFRX_Init() function.
- -@- The specific SPDIFRX interrupts (RXNE/CSRNE and Error Interrupts) will be managed using the macros
- __SPDIFRX_ENABLE_IT() and __SPDIFRX_DISABLE_IT() inside the receive process.
- -@- Make sure that ck_spdif clock is configured.
- (#) Three operation modes are available within this driver :
- *** Polling mode for reception operation (for debug purpose) ***
- ================================================================
- [..]
- (+) Receive data flow in blocking mode using HAL_SPDIFRX_ReceiveDataFlow()
- (+) Receive control flow of data in blocking mode using HAL_SPDIFRX_ReceiveControlFlow()
- *** Interrupt mode for reception operation ***
- =========================================
- [..]
- (+) Receive an amount of data (Data Flow) in non blocking mode using HAL_SPDIFRX_ReceiveDataFlow_IT()
- (+) Receive an amount of data (Control Flow) in non blocking mode using HAL_SPDIFRX_ReceiveControlFlow_IT()
- (+) At reception end of half transfer HAL_SPDIFRX_RxHalfCpltCallback is executed and user can
- add his own code by customization of function pointer HAL_SPDIFRX_RxHalfCpltCallback
- (+) At reception end of transfer HAL_SPDIFRX_RxCpltCallback is executed and user can
- add his own code by customization of function pointer HAL_SPDIFRX_RxCpltCallback
- (+) In case of transfer Error, HAL_SPDIFRX_ErrorCallback() function is executed and user can
- add his own code by customization of function pointer HAL_SPDIFRX_ErrorCallback
- *** DMA mode for reception operation ***
- ========================================
- [..]
- (+) Receive an amount of data (Data Flow) in non blocking mode (DMA) using HAL_SPDIFRX_ReceiveDataFlow_DMA()
- (+) Receive an amount of data (Control Flow) in non blocking mode (DMA) using HAL_SPDIFRX_ReceiveControlFlow_DMA()
- (+) At reception end of half transfer HAL_SPDIFRX_RxHalfCpltCallback is executed and user can
- add his own code by customization of function pointer HAL_SPDIFRX_RxHalfCpltCallback
- (+) At reception end of transfer HAL_SPDIFRX_RxCpltCallback is executed and user can
- add his own code by customization of function pointer HAL_SPDIFRX_RxCpltCallback
- (+) In case of transfer Error, HAL_SPDIFRX_ErrorCallback() function is executed and user can
- add his own code by customization of function pointer HAL_SPDIFRX_ErrorCallback
- (+) Stop the DMA Transfer using HAL_SPDIFRX_DMAStop()
- *** SPDIFRX HAL driver macros list ***
- =============================================
- [..]
- Below the list of most used macros in SPDIFRX HAL driver.
- (+) __HAL_SPDIFRX_IDLE: Disable the specified SPDIFRX peripheral (IDEL State)
- (+) __HAL_SPDIFRX_SYNC: Enable the synchronization state of the specified SPDIFRX peripheral (SYNC State)
- (+) __HAL_SPDIFRX_RCV: Enable the receive state of the specified SPDIFRX peripheral (RCV State)
- (+) __HAL_SPDIFRX_ENABLE_IT : Enable the specified SPDIFRX interrupts
- (+) __HAL_SPDIFRX_DISABLE_IT : Disable the specified SPDIFRX interrupts
- (+) __HAL_SPDIFRX_GET_FLAG: Check whether the specified SPDIFRX flag is set or not.
- [..]
- (@) You can refer to the SPDIFRX HAL driver header file for more useful macros
- *** Callback registration ***
- =============================================
- The compilation define USE_HAL_SPDIFRX_REGISTER_CALLBACKS when set to 1
- allows the user to configure dynamically the driver callbacks.
- Use HAL_SPDIFRX_RegisterCallback() function to register an interrupt callback.
- The HAL_SPDIFRX_RegisterCallback() function allows to register the following callbacks:
- (+) RxHalfCpltCallback : SPDIFRX Data flow half completed callback.
- (+) RxCpltCallback : SPDIFRX Data flow completed callback.
- (+) CxHalfCpltCallback : SPDIFRX Control flow half completed callback.
- (+) CxCpltCallback : SPDIFRX Control flow completed callback.
- (+) ErrorCallback : SPDIFRX error callback.
- (+) MspInitCallback : SPDIFRX MspInit.
- (+) MspDeInitCallback : SPDIFRX MspDeInit.
- This function takes as parameters the HAL peripheral handle, the Callback ID
- and a pointer to the user callback function.
- Use HAL_SPDIFRX_UnRegisterCallback() function to reset a callback to the default
- weak function.
- The HAL_SPDIFRX_UnRegisterCallback() function takes as parameters the HAL peripheral handle,
- and the Callback ID.
- This function allows to reset the following callbacks:
- (+) RxHalfCpltCallback : SPDIFRX Data flow half completed callback.
- (+) RxCpltCallback : SPDIFRX Data flow completed callback.
- (+) CxHalfCpltCallback : SPDIFRX Control flow half completed callback.
- (+) CxCpltCallback : SPDIFRX Control flow completed callback.
- (+) ErrorCallback : SPDIFRX error callback.
- (+) MspInitCallback : SPDIFRX MspInit.
- (+) MspDeInitCallback : SPDIFRX MspDeInit.
- By default, after the HAL_SPDIFRX_Init() and when the state is HAL_SPDIFRX_STATE_RESET
- all callbacks are set to the corresponding weak functions :
- HAL_SPDIFRX_RxHalfCpltCallback() , HAL_SPDIFRX_RxCpltCallback(), HAL_SPDIFRX_CxHalfCpltCallback(),
- HAL_SPDIFRX_CxCpltCallback() and HAL_SPDIFRX_ErrorCallback()
- Exception done for MspInit and MspDeInit functions that are
- reset to the legacy weak function in the HAL_SPDIFRX_Init()/ HAL_SPDIFRX_DeInit() only when
- these callbacks pointers are NULL (not registered beforehand).
- If not, MspInit or MspDeInit callbacks pointers are not null, the HAL_SPDIFRX_Init() / HAL_SPDIFRX_DeInit()
- keep and use the user MspInit/MspDeInit functions (registered beforehand)
- Callbacks can be registered/unregistered in HAL_SPDIFRX_STATE_READY state only.
- Exception done MspInit/MspDeInit callbacks that can be registered/unregistered
- in HAL_SPDIFRX_STATE_READY or HAL_SPDIFRX_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_SPDIFRX_RegisterCallback() before calling HAL_SPDIFRX_DeInit()
- or HAL_SPDIFRX_Init() function.
- When The compilation define USE_HAL_SPDIFRX_REGISTER_CALLBACKS is set to 0 or
- not defined, the callback registration feature is not available and all callbacks
- are set to the corresponding weak functions.
- @endverbatim
- ******************************************************************************
- * @attention
- *
- * <h2><center>© Copyright (c) 2016 STMicroelectronics.
- * All rights reserved.</center></h2>
- *
- * This software component is licensed by ST under BSD 3-Clause license,
- * the "License"; You may not use this file except in compliance with the
- * License. You may obtain a copy of the License at:
- * opensource.org/licenses/BSD-3-Clause
- *
- ******************************************************************************
- */
- /* Includes ------------------------------------------------------------------*/
- #include "stm32f4xx_hal.h"
- /** @addtogroup STM32F4xx_HAL_Driver
- * @{
- */
- /** @defgroup SPDIFRX SPDIFRX
- * @brief SPDIFRX HAL module driver
- * @{
- */
- #ifdef HAL_SPDIFRX_MODULE_ENABLED
- #if defined (SPDIFRX)
- #if defined(STM32F446xx)
- /* Private typedef -----------------------------------------------------------*/
- /* Private define ------------------------------------------------------------*/
- #define SPDIFRX_TIMEOUT_VALUE 0xFFFFU
- /* Private macro -------------------------------------------------------------*/
- /* Private variables ---------------------------------------------------------*/
- /* Private function prototypes -----------------------------------------------*/
- /** @addtogroup SPDIFRX_Private_Functions
- * @{
- */
- static void SPDIFRX_DMARxCplt(DMA_HandleTypeDef *hdma);
- static void SPDIFRX_DMARxHalfCplt(DMA_HandleTypeDef *hdma);
- static void SPDIFRX_DMACxCplt(DMA_HandleTypeDef *hdma);
- static void SPDIFRX_DMACxHalfCplt(DMA_HandleTypeDef *hdma);
- static void SPDIFRX_DMAError(DMA_HandleTypeDef *hdma);
- static void SPDIFRX_ReceiveControlFlow_IT(SPDIFRX_HandleTypeDef *hspdif);
- static void SPDIFRX_ReceiveDataFlow_IT(SPDIFRX_HandleTypeDef *hspdif);
- static HAL_StatusTypeDef SPDIFRX_WaitOnFlagUntilTimeout(SPDIFRX_HandleTypeDef *hspdif, uint32_t Flag, FlagStatus Status, uint32_t Timeout, uint32_t tickstart);
- /**
- * @}
- */
- /* Exported functions ---------------------------------------------------------*/
- /** @defgroup SPDIFRX_Exported_Functions SPDIFRX Exported Functions
- * @{
- */
- /** @defgroup SPDIFRX_Exported_Functions_Group1 Initialization and de-initialization functions
- * @brief Initialization and Configuration functions
- *
- @verbatim
- ===============================================================================
- ##### Initialization and de-initialization functions #####
- ===============================================================================
- [..] This subsection provides a set of functions allowing to initialize and
- de-initialize the SPDIFRX peripheral:
- (+) User must Implement HAL_SPDIFRX_MspInit() function in which he configures
- all related peripherals resources (CLOCK, GPIO, DMA, IT and NVIC ).
- (+) Call the function HAL_SPDIFRX_Init() to configure the SPDIFRX peripheral with
- the selected configuration:
- (++) Input Selection (IN0, IN1,...)
- (++) Maximum allowed re-tries during synchronization phase
- (++) Wait for activity on SPDIF selected input
- (++) Channel status selection (from channel A or B)
- (++) Data format (LSB, MSB, ...)
- (++) Stereo mode
- (++) User bits masking (PT,C,U,V,...)
- (+) Call the function HAL_SPDIFRX_DeInit() to restore the default configuration
- of the selected SPDIFRXx peripheral.
- @endverbatim
- * @{
- */
- /**
- * @brief Initializes the SPDIFRX according to the specified parameters
- * in the SPDIFRX_InitTypeDef and create the associated handle.
- * @param hspdif SPDIFRX handle
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_Init(SPDIFRX_HandleTypeDef *hspdif)
- {
- uint32_t tmpreg;
- /* Check the SPDIFRX handle allocation */
- if(hspdif == NULL)
- {
- return HAL_ERROR;
- }
- /* Check the SPDIFRX parameters */
- assert_param(IS_STEREO_MODE(hspdif->Init.StereoMode));
- assert_param(IS_SPDIFRX_INPUT_SELECT(hspdif->Init.InputSelection));
- assert_param(IS_SPDIFRX_MAX_RETRIES(hspdif->Init.Retries));
- assert_param(IS_SPDIFRX_WAIT_FOR_ACTIVITY(hspdif->Init.WaitForActivity));
- assert_param(IS_SPDIFRX_CHANNEL(hspdif->Init.ChannelSelection));
- assert_param(IS_SPDIFRX_DATA_FORMAT(hspdif->Init.DataFormat));
- assert_param(IS_PREAMBLE_TYPE_MASK(hspdif->Init.PreambleTypeMask));
- assert_param(IS_CHANNEL_STATUS_MASK(hspdif->Init.ChannelStatusMask));
- assert_param(IS_VALIDITY_MASK(hspdif->Init.ValidityBitMask));
- assert_param(IS_PARITY_ERROR_MASK(hspdif->Init.ParityErrorMask));
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- if(hspdif->State == HAL_SPDIFRX_STATE_RESET)
- {
- /* Allocate lock resource and initialize it */
- hspdif->Lock = HAL_UNLOCKED;
- hspdif->RxHalfCpltCallback = HAL_SPDIFRX_RxHalfCpltCallback; /* Legacy weak RxHalfCpltCallback */
- hspdif->RxCpltCallback = HAL_SPDIFRX_RxCpltCallback; /* Legacy weak RxCpltCallback */
- hspdif->CxHalfCpltCallback = HAL_SPDIFRX_CxHalfCpltCallback; /* Legacy weak CxHalfCpltCallback */
- hspdif->CxCpltCallback = HAL_SPDIFRX_CxCpltCallback; /* Legacy weak CxCpltCallback */
- hspdif->ErrorCallback = HAL_SPDIFRX_ErrorCallback; /* Legacy weak ErrorCallback */
- if(hspdif->MspInitCallback == NULL)
- {
- hspdif->MspInitCallback = HAL_SPDIFRX_MspInit; /* Legacy weak MspInit */
- }
- /* Init the low level hardware */
- hspdif->MspInitCallback(hspdif);
- }
- #else
- if(hspdif->State == HAL_SPDIFRX_STATE_RESET)
- {
- /* Allocate lock resource and initialize it */
- hspdif->Lock = HAL_UNLOCKED;
- /* Init the low level hardware : GPIO, CLOCK, CORTEX...etc */
- HAL_SPDIFRX_MspInit(hspdif);
- }
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- /* SPDIFRX peripheral state is BUSY */
- hspdif->State = HAL_SPDIFRX_STATE_BUSY;
- /* Disable SPDIFRX interface (IDLE State) */
- __HAL_SPDIFRX_IDLE(hspdif);
- /* Reset the old SPDIFRX CR configuration */
- tmpreg = hspdif->Instance->CR;
- tmpreg &= ~(SPDIFRX_CR_RXSTEO | SPDIFRX_CR_DRFMT | SPDIFRX_CR_PMSK |
- SPDIFRX_CR_VMSK | SPDIFRX_CR_CUMSK | SPDIFRX_CR_PTMSK |
- SPDIFRX_CR_CHSEL | SPDIFRX_CR_NBTR | SPDIFRX_CR_WFA |
- SPDIFRX_CR_INSEL);
- /* Sets the new configuration of the SPDIFRX peripheral */
- tmpreg |= (hspdif->Init.StereoMode |
- hspdif->Init.InputSelection |
- hspdif->Init.Retries |
- hspdif->Init.WaitForActivity |
- hspdif->Init.ChannelSelection |
- hspdif->Init.DataFormat |
- hspdif->Init.PreambleTypeMask |
- hspdif->Init.ChannelStatusMask |
- hspdif->Init.ValidityBitMask |
- hspdif->Init.ParityErrorMask
- );
- hspdif->Instance->CR = tmpreg;
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_NONE;
- /* SPDIFRX peripheral state is READY*/
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- return HAL_OK;
- }
- /**
- * @brief DeInitializes the SPDIFRX peripheral
- * @param hspdif SPDIFRX handle
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_DeInit(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Check the SPDIFRX handle allocation */
- if(hspdif == NULL)
- {
- return HAL_ERROR;
- }
- /* Check the parameters */
- assert_param(IS_SPDIFRX_ALL_INSTANCE(hspdif->Instance));
- hspdif->State = HAL_SPDIFRX_STATE_BUSY;
- /* Disable SPDIFRX interface (IDLE state) */
- __HAL_SPDIFRX_IDLE(hspdif);
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- if(hspdif->MspDeInitCallback == NULL)
- {
- hspdif->MspDeInitCallback = HAL_SPDIFRX_MspDeInit; /* Legacy weak MspDeInit */
- }
- /* DeInit the low level hardware */
- hspdif->MspDeInitCallback(hspdif);
- #else
- /* DeInit the low level hardware: GPIO, CLOCK, NVIC... */
- HAL_SPDIFRX_MspDeInit(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_NONE;
- /* SPDIFRX peripheral state is RESET*/
- hspdif->State = HAL_SPDIFRX_STATE_RESET;
- /* Release Lock */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- /**
- * @brief SPDIFRX MSP Init
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- __weak void HAL_SPDIFRX_MspInit(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hspdif);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_SPDIFRX_MspInit could be implemented in the user file
- */
- }
- /**
- * @brief SPDIFRX MSP DeInit
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- __weak void HAL_SPDIFRX_MspDeInit(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hspdif);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_SPDIFRX_MspDeInit could be implemented in the user file
- */
- }
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- /**
- * @brief Register a User SPDIFRX Callback
- * To be used instead of the weak predefined callback
- * @param hspdif SPDIFRX handle
- * @param CallbackID ID of the callback to be registered
- * This parameter can be one of the following values:
- * @arg @ref HAL_SPDIFRX_RX_HALF_CB_ID SPDIFRX Data flow half completed callback ID
- * @arg @ref HAL_SPDIFRX_RX_CPLT_CB_ID SPDIFRX Data flow completed callback ID
- * @arg @ref HAL_SPDIFRX_CX_HALF_CB_ID SPDIFRX Control flow half completed callback ID
- * @arg @ref HAL_SPDIFRX_CX_CPLT_CB_ID SPDIFRX Control flow completed callback ID
- * @arg @ref HAL_SPDIFRX_ERROR_CB_ID SPDIFRX error callback ID
- * @arg @ref HAL_SPDIFRX_MSPINIT_CB_ID MspInit callback ID
- * @arg @ref HAL_SPDIFRX_MSPDEINIT_CB_ID MspDeInit callback ID
- * @param pCallback pointer to the Callback function
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_RegisterCallback(SPDIFRX_HandleTypeDef *hspdif, HAL_SPDIFRX_CallbackIDTypeDef CallbackID, pSPDIFRX_CallbackTypeDef pCallback)
- {
- HAL_StatusTypeDef status = HAL_OK;
- if(pCallback == NULL)
- {
- /* Update the error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_INVALID_CALLBACK;
- return HAL_ERROR;
- }
- /* Process locked */
- __HAL_LOCK(hspdif);
- if(HAL_SPDIFRX_STATE_READY == hspdif->State)
- {
- switch (CallbackID)
- {
- case HAL_SPDIFRX_RX_HALF_CB_ID :
- hspdif->RxHalfCpltCallback = pCallback;
- break;
- case HAL_SPDIFRX_RX_CPLT_CB_ID :
- hspdif->RxCpltCallback = pCallback;
- break;
- case HAL_SPDIFRX_CX_HALF_CB_ID :
- hspdif->CxHalfCpltCallback = pCallback;
- break;
- case HAL_SPDIFRX_CX_CPLT_CB_ID :
- hspdif->CxCpltCallback = pCallback;
- break;
- case HAL_SPDIFRX_ERROR_CB_ID :
- hspdif->ErrorCallback = pCallback;
- break;
- case HAL_SPDIFRX_MSPINIT_CB_ID :
- hspdif->MspInitCallback = pCallback;
- break;
- case HAL_SPDIFRX_MSPDEINIT_CB_ID :
- hspdif->MspDeInitCallback = pCallback;
- break;
- default :
- /* Update the error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else if(HAL_SPDIFRX_STATE_RESET == hspdif->State)
- {
- switch (CallbackID)
- {
- case HAL_SPDIFRX_MSPINIT_CB_ID :
- hspdif->MspInitCallback = pCallback;
- break;
- case HAL_SPDIFRX_MSPDEINIT_CB_ID :
- hspdif->MspDeInitCallback = pCallback;
- break;
- default :
- /* Update the error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else
- {
- /* Update the error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- }
- /* Release Lock */
- __HAL_UNLOCK(hspdif);
- return status;
- }
- /**
- * @brief Unregister a SPDIFRX Callback
- * SPDIFRX callabck is redirected to the weak predefined callback
- * @param hspdif SPDIFRX handle
- * @param CallbackID ID of the callback to be unregistered
- * This parameter can be one of the following values:
- * @arg @ref HAL_SPDIFRX_RX_HALF_CB_ID SPDIFRX Data flow half completed callback ID
- * @arg @ref HAL_SPDIFRX_RX_CPLT_CB_ID SPDIFRX Data flow completed callback ID
- * @arg @ref HAL_SPDIFRX_CX_HALF_CB_ID SPDIFRX Control flow half completed callback ID
- * @arg @ref HAL_SPDIFRX_CX_CPLT_CB_ID SPDIFRX Control flow completed callback ID
- * @arg @ref HAL_SPDIFRX_ERROR_CB_ID SPDIFRX error callback ID
- * @arg @ref HAL_SPDIFRX_MSPINIT_CB_ID MspInit callback ID
- * @arg @ref HAL_SPDIFRX_MSPDEINIT_CB_ID MspDeInit callback ID
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_UnRegisterCallback(SPDIFRX_HandleTypeDef *hspdif, HAL_SPDIFRX_CallbackIDTypeDef CallbackID)
- {
- HAL_StatusTypeDef status = HAL_OK;
- /* Process locked */
- __HAL_LOCK(hspdif);
- if(HAL_SPDIFRX_STATE_READY == hspdif->State)
- {
- switch (CallbackID)
- {
- case HAL_SPDIFRX_RX_HALF_CB_ID :
- hspdif->RxHalfCpltCallback = HAL_SPDIFRX_RxHalfCpltCallback;
- break;
- case HAL_SPDIFRX_RX_CPLT_CB_ID :
- hspdif->RxCpltCallback = HAL_SPDIFRX_RxCpltCallback;
- break;
- case HAL_SPDIFRX_CX_HALF_CB_ID :
- hspdif->CxHalfCpltCallback = HAL_SPDIFRX_CxHalfCpltCallback;
- break;
- case HAL_SPDIFRX_CX_CPLT_CB_ID :
- hspdif->CxCpltCallback = HAL_SPDIFRX_CxCpltCallback;
- break;
- case HAL_SPDIFRX_ERROR_CB_ID :
- hspdif->ErrorCallback = HAL_SPDIFRX_ErrorCallback;
- break;
- default :
- /* Update the error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else if(HAL_SPDIFRX_STATE_RESET == hspdif->State)
- {
- switch (CallbackID)
- {
- case HAL_SPDIFRX_MSPINIT_CB_ID :
- hspdif->MspInitCallback = HAL_SPDIFRX_MspInit; /* Legacy weak MspInit */
- break;
- case HAL_SPDIFRX_MSPDEINIT_CB_ID :
- hspdif->MspDeInitCallback = HAL_SPDIFRX_MspDeInit; /* Legacy weak MspInit */
- break;
- default :
- /* Update the error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else
- {
- /* Update the error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- }
- /* Release Lock */
- __HAL_UNLOCK(hspdif);
- return status;
- }
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- /**
- * @brief Set the SPDIFRX data format according to the specified parameters in the SPDIFRX_InitTypeDef.
- * @param hspdif SPDIFRX handle
- * @param sDataFormat SPDIFRX data format
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_SetDataFormat(SPDIFRX_HandleTypeDef *hspdif, SPDIFRX_SetDataFormatTypeDef sDataFormat)
- {
- uint32_t tmpreg;
- /* Check the SPDIFRX handle allocation */
- if(hspdif == NULL)
- {
- return HAL_ERROR;
- }
- /* Check the SPDIFRX parameters */
- assert_param(IS_STEREO_MODE(sDataFormat.StereoMode));
- assert_param(IS_SPDIFRX_DATA_FORMAT(sDataFormat.DataFormat));
- assert_param(IS_PREAMBLE_TYPE_MASK(sDataFormat.PreambleTypeMask));
- assert_param(IS_CHANNEL_STATUS_MASK(sDataFormat.ChannelStatusMask));
- assert_param(IS_VALIDITY_MASK(sDataFormat.ValidityBitMask));
- assert_param(IS_PARITY_ERROR_MASK(sDataFormat.ParityErrorMask));
- /* Reset the old SPDIFRX CR configuration */
- tmpreg = hspdif->Instance->CR;
- if(((tmpreg & SPDIFRX_STATE_RCV) == SPDIFRX_STATE_RCV) &&
- (((tmpreg & SPDIFRX_CR_DRFMT) != sDataFormat.DataFormat) ||
- ((tmpreg & SPDIFRX_CR_RXSTEO) != sDataFormat.StereoMode)))
- {
- return HAL_ERROR;
- }
- tmpreg &= ~(SPDIFRX_CR_RXSTEO | SPDIFRX_CR_DRFMT | SPDIFRX_CR_PMSK |
- SPDIFRX_CR_VMSK | SPDIFRX_CR_CUMSK | SPDIFRX_CR_PTMSK);
- /* Configure the new data format */
- tmpreg |= (sDataFormat.StereoMode |
- sDataFormat.DataFormat |
- sDataFormat.PreambleTypeMask |
- sDataFormat.ChannelStatusMask |
- sDataFormat.ValidityBitMask |
- sDataFormat.ParityErrorMask);
- hspdif->Instance->CR = tmpreg;
- return HAL_OK;
- }
- /**
- * @}
- */
- /** @defgroup SPDIFRX_Exported_Functions_Group2 IO operation functions
- * @brief Data transfers functions
- *
- @verbatim
- ===============================================================================
- ##### IO operation functions #####
- ===============================================================================
- [..]
- This subsection provides a set of functions allowing to manage the SPDIFRX data
- transfers.
- (#) There is two mode of transfer:
- (++) Blocking mode : The communication is performed in the polling mode.
- The status of all data processing is returned by the same function
- after finishing transfer.
- (++) No-Blocking mode : The communication is performed using Interrupts
- or DMA. These functions return the status of the transfer start-up.
- The end of the data processing will be indicated through the
- dedicated SPDIFRX IRQ when using Interrupt mode or the DMA IRQ when
- using DMA mode.
- (#) Blocking mode functions are :
- (++) HAL_SPDIFRX_ReceiveDataFlow()
- (++) HAL_SPDIFRX_ReceiveControlFlow()
- (+@) Do not use blocking mode to receive both control and data flow at the same time.
- (#) No-Blocking mode functions with Interrupt are :
- (++) HAL_SPDIFRX_ReceiveControlFlow_IT()
- (++) HAL_SPDIFRX_ReceiveDataFlow_IT()
- (#) No-Blocking mode functions with DMA are :
- (++) HAL_SPDIFRX_ReceiveControlFlow_DMA()
- (++) HAL_SPDIFRX_ReceiveDataFlow_DMA()
- (#) A set of Transfer Complete Callbacks are provided in No_Blocking mode:
- (++) HAL_SPDIFRX_RxCpltCallback()
- (++) HAL_SPDIFRX_CxCpltCallback()
- @endverbatim
- * @{
- */
- /**
- * @brief Receives an amount of data (Data Flow) in blocking mode.
- * @param hspdif pointer to SPDIFRX_HandleTypeDef structure that contains
- * the configuration information for SPDIFRX module.
- * @param pData Pointer to data buffer
- * @param Size Amount of data to be received
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_ReceiveDataFlow(SPDIFRX_HandleTypeDef *hspdif, uint32_t *pData, uint16_t Size, uint32_t Timeout)
- {
- uint32_t tickstart;
- uint16_t sizeCounter = Size;
- uint32_t *pTmpBuf = pData;
- if((pData == NULL ) || (Size == 0U))
- {
- return HAL_ERROR;
- }
- if(hspdif->State == HAL_SPDIFRX_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hspdif);
- hspdif->State = HAL_SPDIFRX_STATE_BUSY;
- /* Start synchronisation */
- __HAL_SPDIFRX_SYNC(hspdif);
- /* Get tick */
- tickstart = HAL_GetTick();
- /* Wait until SYNCD flag is set */
- if(SPDIFRX_WaitOnFlagUntilTimeout(hspdif, SPDIFRX_FLAG_SYNCD, RESET, Timeout, tickstart) != HAL_OK)
- {
- return HAL_TIMEOUT;
- }
- /* Start reception */
- __HAL_SPDIFRX_RCV(hspdif);
- /* Receive data flow */
- while(sizeCounter > 0U)
- {
- /* Get tick */
- tickstart = HAL_GetTick();
- /* Wait until RXNE flag is set */
- if(SPDIFRX_WaitOnFlagUntilTimeout(hspdif, SPDIFRX_FLAG_RXNE, RESET, Timeout, tickstart) != HAL_OK)
- {
- return HAL_TIMEOUT;
- }
- (*pTmpBuf) = hspdif->Instance->DR;
- pTmpBuf++;
- sizeCounter--;
- }
- /* SPDIFRX ready */
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- else
- {
- return HAL_BUSY;
- }
- }
- /**
- * @brief Receives an amount of data (Control Flow) in blocking mode.
- * @param hspdif pointer to a SPDIFRX_HandleTypeDef structure that contains
- * the configuration information for SPDIFRX module.
- * @param pData Pointer to data buffer
- * @param Size Amount of data to be received
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_ReceiveControlFlow(SPDIFRX_HandleTypeDef *hspdif, uint32_t *pData, uint16_t Size, uint32_t Timeout)
- {
- uint32_t tickstart;
- uint16_t sizeCounter = Size;
- uint32_t *pTmpBuf = pData;
- if((pData == NULL ) || (Size == 0U))
- {
- return HAL_ERROR;
- }
- if(hspdif->State == HAL_SPDIFRX_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hspdif);
- hspdif->State = HAL_SPDIFRX_STATE_BUSY;
- /* Start synchronization */
- __HAL_SPDIFRX_SYNC(hspdif);
- /* Get tick */
- tickstart = HAL_GetTick();
- /* Wait until SYNCD flag is set */
- if(SPDIFRX_WaitOnFlagUntilTimeout(hspdif, SPDIFRX_FLAG_SYNCD, RESET, Timeout, tickstart) != HAL_OK)
- {
- return HAL_TIMEOUT;
- }
- /* Start reception */
- __HAL_SPDIFRX_RCV(hspdif);
- /* Receive control flow */
- while(sizeCounter > 0U)
- {
- /* Get tick */
- tickstart = HAL_GetTick();
- /* Wait until CSRNE flag is set */
- if(SPDIFRX_WaitOnFlagUntilTimeout(hspdif, SPDIFRX_FLAG_CSRNE, RESET, Timeout, tickstart) != HAL_OK)
- {
- return HAL_TIMEOUT;
- }
- (*pTmpBuf) = hspdif->Instance->CSR;
- pTmpBuf++;
- sizeCounter--;
- }
- /* SPDIFRX ready */
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- else
- {
- return HAL_BUSY;
- }
- }
- /**
- * @brief Receive an amount of data (Data Flow) in non-blocking mode with Interrupt
- * @param hspdif SPDIFRX handle
- * @param pData a 32-bit pointer to the Receive data buffer.
- * @param Size number of data sample to be received .
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_ReceiveDataFlow_IT(SPDIFRX_HandleTypeDef *hspdif, uint32_t *pData, uint16_t Size)
- {
- uint32_t count = SPDIFRX_TIMEOUT_VALUE * (SystemCoreClock / 24U / 1000U);
- const HAL_SPDIFRX_StateTypeDef tempState = hspdif->State;
- if((tempState == HAL_SPDIFRX_STATE_READY) || (tempState == HAL_SPDIFRX_STATE_BUSY_CX))
- {
- if((pData == NULL) || (Size == 0U))
- {
- return HAL_ERROR;
- }
- /* Process Locked */
- __HAL_LOCK(hspdif);
- hspdif->pRxBuffPtr = pData;
- hspdif->RxXferSize = Size;
- hspdif->RxXferCount = Size;
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_NONE;
- /* Check if a receive process is ongoing or not */
- hspdif->State = HAL_SPDIFRX_STATE_BUSY_RX;
- /* Enable the SPDIFRX PE Error Interrupt */
- __HAL_SPDIFRX_ENABLE_IT(hspdif, SPDIFRX_IT_PERRIE);
- /* Enable the SPDIFRX OVR Error Interrupt */
- __HAL_SPDIFRX_ENABLE_IT(hspdif, SPDIFRX_IT_OVRIE);
- /* Enable the SPDIFRX RXNE interrupt */
- __HAL_SPDIFRX_ENABLE_IT(hspdif, SPDIFRX_IT_RXNE);
- if((SPDIFRX->CR & SPDIFRX_CR_SPDIFEN) != SPDIFRX_STATE_RCV)
- {
- /* Start synchronization */
- __HAL_SPDIFRX_SYNC(hspdif);
- /* Wait until SYNCD flag is set */
- do
- {
- if (count == 0U)
- {
- /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_RXNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_CSRNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_PERRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_OVRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SBLKIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SYNCDIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_IFEIE);
- hspdif->State= HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_TIMEOUT;
- }
- count--;
- } while (__HAL_SPDIFRX_GET_FLAG(hspdif, SPDIFRX_FLAG_SYNCD) == RESET);
- /* Start reception */
- __HAL_SPDIFRX_RCV(hspdif);
- }
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- else
- {
- return HAL_BUSY;
- }
- }
- /**
- * @brief Receive an amount of data (Control Flow) with Interrupt
- * @param hspdif SPDIFRX handle
- * @param pData a 32-bit pointer to the Receive data buffer.
- * @param Size number of data sample (Control Flow) to be received
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_ReceiveControlFlow_IT(SPDIFRX_HandleTypeDef *hspdif, uint32_t *pData, uint16_t Size)
- {
- uint32_t count = SPDIFRX_TIMEOUT_VALUE * (SystemCoreClock / 24U / 1000U);
- const HAL_SPDIFRX_StateTypeDef tempState = hspdif->State;
- if((tempState == HAL_SPDIFRX_STATE_READY) || (tempState == HAL_SPDIFRX_STATE_BUSY_RX))
- {
- if((pData == NULL ) || (Size == 0U))
- {
- return HAL_ERROR;
- }
- /* Process Locked */
- __HAL_LOCK(hspdif);
- hspdif->pCsBuffPtr = pData;
- hspdif->CsXferSize = Size;
- hspdif->CsXferCount = Size;
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_NONE;
- /* Check if a receive process is ongoing or not */
- hspdif->State = HAL_SPDIFRX_STATE_BUSY_CX;
- /* Enable the SPDIFRX PE Error Interrupt */
- __HAL_SPDIFRX_ENABLE_IT(hspdif, SPDIFRX_IT_PERRIE);
- /* Enable the SPDIFRX OVR Error Interrupt */
- __HAL_SPDIFRX_ENABLE_IT(hspdif, SPDIFRX_IT_OVRIE);
- /* Enable the SPDIFRX CSRNE interrupt */
- __HAL_SPDIFRX_ENABLE_IT(hspdif, SPDIFRX_IT_CSRNE);
- if((SPDIFRX->CR & SPDIFRX_CR_SPDIFEN) != SPDIFRX_STATE_RCV)
- {
- /* Start synchronization */
- __HAL_SPDIFRX_SYNC(hspdif);
- /* Wait until SYNCD flag is set */
- do
- {
- if (count == 0U)
- {
- /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_RXNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_CSRNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_PERRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_OVRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SBLKIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SYNCDIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_IFEIE);
- hspdif->State= HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_TIMEOUT;
- }
- count--;
- } while (__HAL_SPDIFRX_GET_FLAG(hspdif, SPDIFRX_FLAG_SYNCD) == RESET);
- /* Start reception */
- __HAL_SPDIFRX_RCV(hspdif);
- }
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- else
- {
- return HAL_BUSY;
- }
- }
- /**
- * @brief Receive an amount of data (Data Flow) mode with DMA
- * @param hspdif SPDIFRX handle
- * @param pData a 32-bit pointer to the Receive data buffer.
- * @param Size number of data sample to be received
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_ReceiveDataFlow_DMA(SPDIFRX_HandleTypeDef *hspdif, uint32_t *pData, uint16_t Size)
- {
- uint32_t count = SPDIFRX_TIMEOUT_VALUE * (SystemCoreClock / 24U / 1000U);
- const HAL_SPDIFRX_StateTypeDef tempState = hspdif->State;
- if((pData == NULL) || (Size == 0U))
- {
- return HAL_ERROR;
- }
- if((tempState == HAL_SPDIFRX_STATE_READY) || (tempState == HAL_SPDIFRX_STATE_BUSY_CX))
- {
- /* Process Locked */
- __HAL_LOCK(hspdif);
- hspdif->pRxBuffPtr = pData;
- hspdif->RxXferSize = Size;
- hspdif->RxXferCount = Size;
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_NONE;
- hspdif->State = HAL_SPDIFRX_STATE_BUSY_RX;
- /* Set the SPDIFRX Rx DMA Half transfer complete callback */
- hspdif->hdmaDrRx->XferHalfCpltCallback = SPDIFRX_DMARxHalfCplt;
- /* Set the SPDIFRX Rx DMA transfer complete callback */
- hspdif->hdmaDrRx->XferCpltCallback = SPDIFRX_DMARxCplt;
- /* Set the DMA error callback */
- hspdif->hdmaDrRx->XferErrorCallback = SPDIFRX_DMAError;
- /* Enable the DMA request */
- if(HAL_DMA_Start_IT(hspdif->hdmaDrRx, (uint32_t)&hspdif->Instance->DR, (uint32_t)hspdif->pRxBuffPtr, Size) != HAL_OK)
- {
- /* Set SPDIFRX error */
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_DMA;
- /* Set SPDIFRX state */
- hspdif->State = HAL_SPDIFRX_STATE_ERROR;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_ERROR;
- }
- /* Enable RXDMAEN bit in SPDIFRX CR register for data flow reception*/
- hspdif->Instance->CR |= SPDIFRX_CR_RXDMAEN;
- if((SPDIFRX->CR & SPDIFRX_CR_SPDIFEN) != SPDIFRX_STATE_RCV)
- {
- /* Start synchronization */
- __HAL_SPDIFRX_SYNC(hspdif);
- /* Wait until SYNCD flag is set */
- do
- {
- if (count == 0U)
- {
- /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_RXNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_CSRNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_PERRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_OVRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SBLKIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SYNCDIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_IFEIE);
- hspdif->State= HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_TIMEOUT;
- }
- count--;
- } while (__HAL_SPDIFRX_GET_FLAG(hspdif, SPDIFRX_FLAG_SYNCD) == RESET);
- /* Start reception */
- __HAL_SPDIFRX_RCV(hspdif);
- }
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- else
- {
- return HAL_BUSY;
- }
- }
- /**
- * @brief Receive an amount of data (Control Flow) with DMA
- * @param hspdif SPDIFRX handle
- * @param pData a 32-bit pointer to the Receive data buffer.
- * @param Size number of data (Control Flow) sample to be received
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_SPDIFRX_ReceiveControlFlow_DMA(SPDIFRX_HandleTypeDef *hspdif, uint32_t *pData, uint16_t Size)
- {
- uint32_t count = SPDIFRX_TIMEOUT_VALUE * (SystemCoreClock / 24U / 1000U);
- const HAL_SPDIFRX_StateTypeDef tempState = hspdif->State;
- if((pData == NULL) || (Size == 0U))
- {
- return HAL_ERROR;
- }
- if((tempState == HAL_SPDIFRX_STATE_READY) || (tempState == HAL_SPDIFRX_STATE_BUSY_RX))
- {
- hspdif->pCsBuffPtr = pData;
- hspdif->CsXferSize = Size;
- hspdif->CsXferCount = Size;
- /* Process Locked */
- __HAL_LOCK(hspdif);
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_NONE;
- hspdif->State = HAL_SPDIFRX_STATE_BUSY_CX;
- /* Set the SPDIFRX Rx DMA Half transfer complete callback */
- hspdif->hdmaCsRx->XferHalfCpltCallback = SPDIFRX_DMACxHalfCplt;
- /* Set the SPDIFRX Rx DMA transfer complete callback */
- hspdif->hdmaCsRx->XferCpltCallback = SPDIFRX_DMACxCplt;
- /* Set the DMA error callback */
- hspdif->hdmaCsRx->XferErrorCallback = SPDIFRX_DMAError;
- /* Enable the DMA request */
- if(HAL_DMA_Start_IT(hspdif->hdmaCsRx, (uint32_t)&hspdif->Instance->CSR, (uint32_t)hspdif->pCsBuffPtr, Size) != HAL_OK)
- {
- /* Set SPDIFRX error */
- hspdif->ErrorCode = HAL_SPDIFRX_ERROR_DMA;
- /* Set SPDIFRX state */
- hspdif->State = HAL_SPDIFRX_STATE_ERROR;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_ERROR;
- }
- /* Enable CBDMAEN bit in SPDIFRX CR register for control flow reception*/
- hspdif->Instance->CR |= SPDIFRX_CR_CBDMAEN;
- if((SPDIFRX->CR & SPDIFRX_CR_SPDIFEN) != SPDIFRX_STATE_RCV)
- {
- /* Start synchronization */
- __HAL_SPDIFRX_SYNC(hspdif);
- /* Wait until SYNCD flag is set */
- do
- {
- if (count == 0U)
- {
- /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_RXNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_CSRNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_PERRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_OVRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SBLKIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SYNCDIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_IFEIE);
- hspdif->State= HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_TIMEOUT;
- }
- count--;
- } while (__HAL_SPDIFRX_GET_FLAG(hspdif, SPDIFRX_FLAG_SYNCD) == RESET);
- /* Start reception */
- __HAL_SPDIFRX_RCV(hspdif);
- }
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- else
- {
- return HAL_BUSY;
- }
- }
- /**
- * @brief stop the audio stream receive from the Media.
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- HAL_StatusTypeDef HAL_SPDIFRX_DMAStop(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Process Locked */
- __HAL_LOCK(hspdif);
- /* Disable the SPDIFRX DMA requests */
- hspdif->Instance->CR &= (uint16_t)(~SPDIFRX_CR_RXDMAEN);
- hspdif->Instance->CR &= (uint16_t)(~SPDIFRX_CR_CBDMAEN);
- /* Disable the SPDIFRX DMA channel */
- __HAL_DMA_DISABLE(hspdif->hdmaDrRx);
- __HAL_DMA_DISABLE(hspdif->hdmaCsRx);
- /* Disable SPDIFRX peripheral */
- __HAL_SPDIFRX_IDLE(hspdif);
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_OK;
- }
- /**
- * @brief This function handles SPDIFRX interrupt request.
- * @param hspdif SPDIFRX handle
- * @retval HAL status
- */
- void HAL_SPDIFRX_IRQHandler(SPDIFRX_HandleTypeDef *hspdif)
- {
- uint32_t itFlag = hspdif->Instance->SR;
- uint32_t itSource = hspdif->Instance->IMR;
- /* SPDIFRX in mode Data Flow Reception */
- if(((itFlag & SPDIFRX_FLAG_RXNE) == SPDIFRX_FLAG_RXNE) && ((itSource & SPDIFRX_IT_RXNE) == SPDIFRX_IT_RXNE))
- {
- __HAL_SPDIFRX_CLEAR_IT(hspdif, SPDIFRX_IT_RXNE);
- SPDIFRX_ReceiveDataFlow_IT(hspdif);
- }
- /* SPDIFRX in mode Control Flow Reception */
- if(((itFlag & SPDIFRX_FLAG_CSRNE) == SPDIFRX_FLAG_CSRNE) && ((itSource & SPDIFRX_IT_CSRNE) == SPDIFRX_IT_CSRNE))
- {
- __HAL_SPDIFRX_CLEAR_IT(hspdif, SPDIFRX_IT_CSRNE);
- SPDIFRX_ReceiveControlFlow_IT(hspdif);
- }
- /* SPDIFRX Overrun error interrupt occurred */
- if(((itFlag & SPDIFRX_FLAG_OVR) == SPDIFRX_FLAG_OVR) && ((itSource & SPDIFRX_IT_OVRIE) == SPDIFRX_IT_OVRIE))
- {
- __HAL_SPDIFRX_CLEAR_IT(hspdif, SPDIFRX_IT_OVRIE);
- /* Change the SPDIFRX error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_OVR;
- /* the transfer is not stopped */
- HAL_SPDIFRX_ErrorCallback(hspdif);
- }
- /* SPDIFRX Parity error interrupt occurred */
- if(((itFlag & SPDIFRX_FLAG_PERR) == SPDIFRX_FLAG_PERR) && ((itSource & SPDIFRX_IT_PERRIE) == SPDIFRX_IT_PERRIE))
- {
- __HAL_SPDIFRX_CLEAR_IT(hspdif, SPDIFRX_IT_PERRIE);
- /* Change the SPDIFRX error code */
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_PE;
- /* the transfer is not stopped */
- HAL_SPDIFRX_ErrorCallback(hspdif);
- }
- }
- /**
- * @brief Rx Transfer (Data flow) half completed callbacks
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- __weak void HAL_SPDIFRX_RxHalfCpltCallback(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hspdif);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_SPDIFRX_RxCpltCallback could be implemented in the user file
- */
- }
- /**
- * @brief Rx Transfer (Data flow) completed callbacks
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- __weak void HAL_SPDIFRX_RxCpltCallback(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hspdif);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_SPDIFRX_RxCpltCallback could be implemented in the user file
- */
- }
- /**
- * @brief Rx (Control flow) Transfer half completed callbacks
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- __weak void HAL_SPDIFRX_CxHalfCpltCallback(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hspdif);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_SPDIFRX_RxCpltCallback could be implemented in the user file
- */
- }
- /**
- * @brief Rx Transfer (Control flow) completed callbacks
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- __weak void HAL_SPDIFRX_CxCpltCallback(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hspdif);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_SPDIFRX_RxCpltCallback could be implemented in the user file
- */
- }
- /**
- * @brief SPDIFRX error callbacks
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- __weak void HAL_SPDIFRX_ErrorCallback(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hspdif);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_SPDIFRX_ErrorCallback could be implemented in the user file
- */
- }
- /**
- * @}
- */
- /** @defgroup SPDIFRX_Exported_Functions_Group3 Peripheral State and Errors functions
- * @brief Peripheral State functions
- *
- @verbatim
- ===============================================================================
- ##### Peripheral State and Errors functions #####
- ===============================================================================
- [..]
- This subsection permit to get in run-time the status of the peripheral
- and the data flow.
- @endverbatim
- * @{
- */
- /**
- * @brief Return the SPDIFRX state
- * @param hspdif SPDIFRX handle
- * @retval HAL state
- */
- HAL_SPDIFRX_StateTypeDef HAL_SPDIFRX_GetState(SPDIFRX_HandleTypeDef const * const hspdif)
- {
- return hspdif->State;
- }
- /**
- * @brief Return the SPDIFRX error code
- * @param hspdif SPDIFRX handle
- * @retval SPDIFRX Error Code
- */
- uint32_t HAL_SPDIFRX_GetError(SPDIFRX_HandleTypeDef const * const hspdif)
- {
- return hspdif->ErrorCode;
- }
- /**
- * @}
- */
- /**
- * @brief DMA SPDIFRX receive process (Data flow) complete callback
- * @param hdma DMA handle
- * @retval None
- */
- static void SPDIFRX_DMARxCplt(DMA_HandleTypeDef *hdma)
- {
- SPDIFRX_HandleTypeDef* hspdif = ( SPDIFRX_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
- /* Disable Rx DMA Request */
- if(hdma->Init.Mode != DMA_CIRCULAR)
- {
- hspdif->Instance->CR &= (uint16_t)(~SPDIFRX_CR_RXDMAEN);
- hspdif->RxXferCount = 0;
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- }
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- hspdif->RxCpltCallback(hspdif);
- #else
- HAL_SPDIFRX_RxCpltCallback(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- }
- /**
- * @brief DMA SPDIFRX receive process (Data flow) half complete callback
- * @param hdma DMA handle
- * @retval None
- */
- static void SPDIFRX_DMARxHalfCplt(DMA_HandleTypeDef *hdma)
- {
- SPDIFRX_HandleTypeDef* hspdif = (SPDIFRX_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- hspdif->RxHalfCpltCallback(hspdif);
- #else
- HAL_SPDIFRX_RxHalfCpltCallback(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- }
- /**
- * @brief DMA SPDIFRX receive process (Control flow) complete callback
- * @param hdma DMA handle
- * @retval None
- */
- static void SPDIFRX_DMACxCplt(DMA_HandleTypeDef *hdma)
- {
- SPDIFRX_HandleTypeDef* hspdif = ( SPDIFRX_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
- /* Disable Cb DMA Request */
- hspdif->Instance->CR &= (uint16_t)(~SPDIFRX_CR_CBDMAEN);
- hspdif->CsXferCount = 0;
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- hspdif->CxCpltCallback(hspdif);
- #else
- HAL_SPDIFRX_CxCpltCallback(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- }
- /**
- * @brief DMA SPDIFRX receive process (Control flow) half complete callback
- * @param hdma DMA handle
- * @retval None
- */
- static void SPDIFRX_DMACxHalfCplt(DMA_HandleTypeDef *hdma)
- {
- SPDIFRX_HandleTypeDef* hspdif = (SPDIFRX_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- hspdif->CxHalfCpltCallback(hspdif);
- #else
- HAL_SPDIFRX_CxHalfCpltCallback(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- }
- /**
- * @brief DMA SPDIFRX communication error callback
- * @param hdma DMA handle
- * @retval None
- */
- static void SPDIFRX_DMAError(DMA_HandleTypeDef *hdma)
- {
- SPDIFRX_HandleTypeDef* hspdif = ( SPDIFRX_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
- /* Disable Rx and Cb DMA Request */
- hspdif->Instance->CR &= (uint16_t)(~(SPDIFRX_CR_RXDMAEN | SPDIFRX_CR_CBDMAEN));
- hspdif->RxXferCount = 0;
- hspdif->State= HAL_SPDIFRX_STATE_READY;
- /* Set the error code and execute error callback*/
- hspdif->ErrorCode |= HAL_SPDIFRX_ERROR_DMA;
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- /* The transfer is not stopped */
- hspdif->ErrorCallback(hspdif);
- #else
- /* The transfer is not stopped */
- HAL_SPDIFRX_ErrorCallback(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- }
- /**
- * @brief Receive an amount of data (Data Flow) with Interrupt
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- static void SPDIFRX_ReceiveDataFlow_IT(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Receive data */
- (*hspdif->pRxBuffPtr) = hspdif->Instance->DR;
- hspdif->pRxBuffPtr++;
- hspdif->RxXferCount--;
- if(hspdif->RxXferCount == 0U)
- {
- /* Disable RXNE/PE and OVR interrupts */
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_OVRIE | SPDIFRX_IT_PERRIE | SPDIFRX_IT_RXNE);
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- hspdif->RxCpltCallback(hspdif);
- #else
- HAL_SPDIFRX_RxCpltCallback(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- }
- }
- /**
- * @brief Receive an amount of data (Control Flow) with Interrupt
- * @param hspdif SPDIFRX handle
- * @retval None
- */
- static void SPDIFRX_ReceiveControlFlow_IT(SPDIFRX_HandleTypeDef *hspdif)
- {
- /* Receive data */
- (*hspdif->pCsBuffPtr) = hspdif->Instance->CSR;
- hspdif->pCsBuffPtr++;
- hspdif->CsXferCount--;
- if(hspdif->CsXferCount == 0U)
- {
- /* Disable CSRNE interrupt */
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_CSRNE);
- hspdif->State = HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- #if (USE_HAL_SPDIFRX_REGISTER_CALLBACKS == 1)
- hspdif->CxCpltCallback(hspdif);
- #else
- HAL_SPDIFRX_CxCpltCallback(hspdif);
- #endif /* USE_HAL_SPDIFRX_REGISTER_CALLBACKS */
- }
- }
- /**
- * @brief This function handles SPDIFRX Communication Timeout.
- * @param hspdif SPDIFRX handle
- * @param Flag Flag checked
- * @param Status Value of the flag expected
- * @param Timeout Duration of the timeout
- * @param tickstart Tick start value
- * @retval HAL status
- */
- static HAL_StatusTypeDef SPDIFRX_WaitOnFlagUntilTimeout(SPDIFRX_HandleTypeDef *hspdif, uint32_t Flag, FlagStatus Status, uint32_t Timeout, uint32_t tickstart)
- {
- /* Wait until flag is set */
- while(__HAL_SPDIFRX_GET_FLAG(hspdif, Flag) == Status)
- {
- /* Check for the Timeout */
- if(Timeout != HAL_MAX_DELAY)
- {
- if(((HAL_GetTick() - tickstart ) > Timeout) || (Timeout == 0U))
- {
- /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_RXNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_CSRNE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_PERRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_OVRIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SBLKIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_SYNCDIE);
- __HAL_SPDIFRX_DISABLE_IT(hspdif, SPDIFRX_IT_IFEIE);
- hspdif->State= HAL_SPDIFRX_STATE_READY;
- /* Process Unlocked */
- __HAL_UNLOCK(hspdif);
- return HAL_TIMEOUT;
- }
- }
- }
- return HAL_OK;
- }
- /**
- * @}
- */
- #endif /* STM32F446xx */
- #endif /* SPDIFRX */
- #endif /* HAL_SPDIFRX_MODULE_ENABLED */
- /**
- * @}
- */
- /**
- * @}
- */
- /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|