mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_STM/TARGET_STM32F1/device/stm32f1xx_hal_cec.c@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
Parent:
187:0387e8f68319 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32f1xx_hal_cec.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @brief CEC HAL module driver.
<> 144:ef7eb2e8f9f7 6 * This file provides firmware functions to manage the following
<> 144:ef7eb2e8f9f7 7 * functionalities of the High Definition Multimedia Interface
<> 144:ef7eb2e8f9f7 8 * Consumer Electronics Control Peripheral (CEC).
AnnaBridge 165:e614a9f1c9e2 9 * + Initialization and de-initialization function
AnnaBridge 165:e614a9f1c9e2 10 * + IO operation function
AnnaBridge 165:e614a9f1c9e2 11 * + Peripheral Control function
AnnaBridge 165:e614a9f1c9e2 12 *
AnnaBridge 165:e614a9f1c9e2 13 *
AnnaBridge 165:e614a9f1c9e2 14 @verbatim
AnnaBridge 165:e614a9f1c9e2 15 ===============================================================================
<> 144:ef7eb2e8f9f7 16 ##### How to use this driver #####
AnnaBridge 165:e614a9f1c9e2 17 ===============================================================================
AnnaBridge 165:e614a9f1c9e2 18 [..]
AnnaBridge 165:e614a9f1c9e2 19 The CEC HAL driver can be used as follow:
AnnaBridge 165:e614a9f1c9e2 20
<> 144:ef7eb2e8f9f7 21 (#) Declare a CEC_HandleTypeDef handle structure.
<> 144:ef7eb2e8f9f7 22 (#) Initialize the CEC low level resources by implementing the HAL_CEC_MspInit ()API:
<> 144:ef7eb2e8f9f7 23 (##) Enable the CEC interface clock.
AnnaBridge 165:e614a9f1c9e2 24 (##) CEC pins configuration:
AnnaBridge 165:e614a9f1c9e2 25 (+++) Enable the clock for the CEC GPIOs.
AnnaBridge 165:e614a9f1c9e2 26 (+++) Configure these CEC pins as alternate function pull-up.
<> 144:ef7eb2e8f9f7 27 (##) NVIC configuration if you need to use interrupt process (HAL_CEC_Transmit_IT()
<> 144:ef7eb2e8f9f7 28 and HAL_CEC_Receive_IT() APIs):
AnnaBridge 165:e614a9f1c9e2 29 (+++) Configure the CEC interrupt priority.
AnnaBridge 165:e614a9f1c9e2 30 (+++) Enable the NVIC CEC IRQ handle.
AnnaBridge 165:e614a9f1c9e2 31 (+++) The specific CEC interrupts (Transmission complete interrupt,
AnnaBridge 165:e614a9f1c9e2 32 RXNE interrupt and Error Interrupts) will be managed using the macros
AnnaBridge 165:e614a9f1c9e2 33 __HAL_CEC_ENABLE_IT() and __HAL_CEC_DISABLE_IT() inside the transmit
AnnaBridge 165:e614a9f1c9e2 34 and receive process.
<> 144:ef7eb2e8f9f7 35
<> 144:ef7eb2e8f9f7 36 (#) Program the Bit Timing Error Mode and the Bit Period Error Mode in the hcec Init structure.
<> 144:ef7eb2e8f9f7 37
<> 144:ef7eb2e8f9f7 38 (#) Initialize the CEC registers by calling the HAL_CEC_Init() API.
AnnaBridge 165:e614a9f1c9e2 39
AnnaBridge 165:e614a9f1c9e2 40 [..]
AnnaBridge 165:e614a9f1c9e2 41 (@) This API (HAL_CEC_Init()) configures also the low level Hardware (GPIO, CLOCK, CORTEX...etc)
AnnaBridge 165:e614a9f1c9e2 42 by calling the customed HAL_CEC_MspInit() API.
<> 144:ef7eb2e8f9f7 43
<> 144:ef7eb2e8f9f7 44 @endverbatim
<> 144:ef7eb2e8f9f7 45 ******************************************************************************
<> 144:ef7eb2e8f9f7 46 * @attention
<> 144:ef7eb2e8f9f7 47 *
<> 144:ef7eb2e8f9f7 48 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 49 *
<> 144:ef7eb2e8f9f7 50 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 51 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 52 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 53 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 54 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 55 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 56 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 57 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 58 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 59 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 60 *
<> 144:ef7eb2e8f9f7 61 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 62 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 63 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 64 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 65 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 66 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 67 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 68 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 69 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 70 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 71 *
<> 144:ef7eb2e8f9f7 72 ******************************************************************************
<> 144:ef7eb2e8f9f7 73 */
<> 144:ef7eb2e8f9f7 74
<> 144:ef7eb2e8f9f7 75 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 76 #include "stm32f1xx_hal.h"
<> 144:ef7eb2e8f9f7 77
<> 144:ef7eb2e8f9f7 78 #ifdef HAL_CEC_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 79
<> 144:ef7eb2e8f9f7 80 #if defined(STM32F100xB) || defined(STM32F100xE)
<> 144:ef7eb2e8f9f7 81
<> 144:ef7eb2e8f9f7 82 /** @addtogroup STM32F1xx_HAL_Driver
<> 144:ef7eb2e8f9f7 83 * @{
<> 144:ef7eb2e8f9f7 84 */
<> 144:ef7eb2e8f9f7 85
<> 144:ef7eb2e8f9f7 86 /** @defgroup CEC CEC
<> 144:ef7eb2e8f9f7 87 * @brief HAL CEC module driver
<> 144:ef7eb2e8f9f7 88 * @{
<> 144:ef7eb2e8f9f7 89 */
AnnaBridge 165:e614a9f1c9e2 90
<> 144:ef7eb2e8f9f7 91 /* Private typedef -----------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 92 /* Private define ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 93 /** @defgroup CEC_Private_Constants CEC Private Constants
<> 144:ef7eb2e8f9f7 94 * @{
<> 144:ef7eb2e8f9f7 95 */
<> 144:ef7eb2e8f9f7 96 #define CEC_CFGR_FIELDS (CEC_CFGR_BTEM | CEC_CFGR_BPEM )
<> 144:ef7eb2e8f9f7 97 #define CEC_FLAG_TRANSMIT_MASK (CEC_FLAG_TSOM|CEC_FLAG_TEOM|CEC_FLAG_TBTRF)
<> 144:ef7eb2e8f9f7 98 #define CEC_FLAG_RECEIVE_MASK (CEC_FLAG_RSOM|CEC_FLAG_REOM|CEC_FLAG_RBTF)
<> 144:ef7eb2e8f9f7 99 #define CEC_ESR_ALL_ERROR (CEC_ESR_BTE|CEC_ESR_BPE|CEC_ESR_RBTFE|CEC_ESR_SBE|CEC_ESR_ACKE|CEC_ESR_LINE|CEC_ESR_TBTFE)
<> 144:ef7eb2e8f9f7 100 #define CEC_RXXFERSIZE_INITIALIZE 0xFFFF /*!< Value used to initialise the RxXferSize of the handle */
<> 144:ef7eb2e8f9f7 101 /**
AnnaBridge 165:e614a9f1c9e2 102 * @}
AnnaBridge 165:e614a9f1c9e2 103 */
<> 144:ef7eb2e8f9f7 104
<> 144:ef7eb2e8f9f7 105 /* Private macro -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 106 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 107 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 108 /** @defgroup CEC_Private_Functions CEC Private Functions
<> 144:ef7eb2e8f9f7 109 * @{
<> 144:ef7eb2e8f9f7 110 */
<> 144:ef7eb2e8f9f7 111 static HAL_StatusTypeDef CEC_Transmit_IT(CEC_HandleTypeDef *hcec);
<> 144:ef7eb2e8f9f7 112 static HAL_StatusTypeDef CEC_Receive_IT(CEC_HandleTypeDef *hcec);
<> 144:ef7eb2e8f9f7 113 /**
AnnaBridge 165:e614a9f1c9e2 114 * @}
AnnaBridge 165:e614a9f1c9e2 115 */
AnnaBridge 165:e614a9f1c9e2 116
<> 144:ef7eb2e8f9f7 117 /* Exported functions ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 118
<> 144:ef7eb2e8f9f7 119 /** @defgroup CEC_Exported_Functions CEC Exported Functions
<> 144:ef7eb2e8f9f7 120 * @{
<> 144:ef7eb2e8f9f7 121 */
<> 144:ef7eb2e8f9f7 122
<> 144:ef7eb2e8f9f7 123 /** @defgroup CEC_Exported_Functions_Group1 Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 124 * @brief Initialization and Configuration functions
<> 144:ef7eb2e8f9f7 125 *
AnnaBridge 165:e614a9f1c9e2 126 @verbatim
<> 144:ef7eb2e8f9f7 127 ===============================================================================
<> 144:ef7eb2e8f9f7 128 ##### Initialization and Configuration functions #####
<> 144:ef7eb2e8f9f7 129 ===============================================================================
<> 144:ef7eb2e8f9f7 130 [..]
<> 144:ef7eb2e8f9f7 131 This subsection provides a set of functions allowing to initialize the CEC
<> 144:ef7eb2e8f9f7 132 (+) The following parameters need to be configured:
<> 144:ef7eb2e8f9f7 133 (++) TimingErrorFree
<> 144:ef7eb2e8f9f7 134 (++) PeriodErrorFree
<> 144:ef7eb2e8f9f7 135 (++) InitiatorAddress
<> 144:ef7eb2e8f9f7 136
<> 144:ef7eb2e8f9f7 137 @endverbatim
<> 144:ef7eb2e8f9f7 138 * @{
<> 144:ef7eb2e8f9f7 139 */
<> 144:ef7eb2e8f9f7 140
<> 144:ef7eb2e8f9f7 141 /**
<> 144:ef7eb2e8f9f7 142 * @brief Initializes the CEC mode according to the specified
<> 144:ef7eb2e8f9f7 143 * parameters in the CEC_InitTypeDef and creates the associated handle .
<> 144:ef7eb2e8f9f7 144 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 145 * @retval HAL status
<> 144:ef7eb2e8f9f7 146 */
<> 144:ef7eb2e8f9f7 147 HAL_StatusTypeDef HAL_CEC_Init(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 148 {
<> 144:ef7eb2e8f9f7 149 /* Check the CEC handle allocation */
AnnaBridge 165:e614a9f1c9e2 150 if((hcec == NULL) ||(hcec->Init.RxBuffer == NULL))
<> 144:ef7eb2e8f9f7 151 {
<> 144:ef7eb2e8f9f7 152 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 153 }
<> 144:ef7eb2e8f9f7 154
<> 144:ef7eb2e8f9f7 155 /* Check the parameters */
<> 144:ef7eb2e8f9f7 156 assert_param(IS_CEC_ALL_INSTANCE(hcec->Instance));
<> 144:ef7eb2e8f9f7 157 assert_param(IS_CEC_BIT_TIMING_ERROR_MODE(hcec->Init.TimingErrorFree));
<> 144:ef7eb2e8f9f7 158 assert_param(IS_CEC_BIT_PERIOD_ERROR_MODE(hcec->Init.PeriodErrorFree));
AnnaBridge 165:e614a9f1c9e2 159 assert_param(IS_CEC_ADDRESS(hcec->Init.OwnAddress));
<> 144:ef7eb2e8f9f7 160
AnnaBridge 165:e614a9f1c9e2 161 if(hcec->gState == HAL_CEC_STATE_RESET)
<> 144:ef7eb2e8f9f7 162 {
<> 144:ef7eb2e8f9f7 163 /* Allocate lock resource and initialize it */
<> 144:ef7eb2e8f9f7 164 hcec->Lock = HAL_UNLOCKED;
<> 144:ef7eb2e8f9f7 165 /* Init the low level hardware : GPIO, CLOCK */
<> 144:ef7eb2e8f9f7 166 HAL_CEC_MspInit(hcec);
<> 144:ef7eb2e8f9f7 167 }
AnnaBridge 165:e614a9f1c9e2 168 hcec->gState = HAL_CEC_STATE_BUSY;
<> 144:ef7eb2e8f9f7 169
<> 144:ef7eb2e8f9f7 170 /* Disable the Peripheral */
<> 144:ef7eb2e8f9f7 171 __HAL_CEC_DISABLE(hcec);
<> 144:ef7eb2e8f9f7 172
<> 144:ef7eb2e8f9f7 173 /* Write to CEC Control Register */
AnnaBridge 165:e614a9f1c9e2 174 MODIFY_REG(hcec->Instance->CFGR, CEC_CFGR_FIELDS, hcec->Init.TimingErrorFree | hcec->Init.PeriodErrorFree);
<> 144:ef7eb2e8f9f7 175
<> 144:ef7eb2e8f9f7 176 /* Write to CEC Own Address Register */
AnnaBridge 165:e614a9f1c9e2 177 MODIFY_REG(hcec->Instance->OAR, CEC_OAR_OA, hcec->Init.OwnAddress);
<> 144:ef7eb2e8f9f7 178
<> 144:ef7eb2e8f9f7 179 /* Configure the prescaler to generate the required 50 microseconds time base.*/
AnnaBridge 165:e614a9f1c9e2 180 MODIFY_REG(hcec->Instance->PRES, CEC_PRES_PRES, 50U * (HAL_RCC_GetPCLK1Freq()/1000000U) - 1U);
<> 144:ef7eb2e8f9f7 181
AnnaBridge 165:e614a9f1c9e2 182 /* Enable the following CEC Interrupt */
AnnaBridge 165:e614a9f1c9e2 183 __HAL_CEC_ENABLE_IT(hcec, CEC_IT_IE);
AnnaBridge 165:e614a9f1c9e2 184
AnnaBridge 165:e614a9f1c9e2 185 /* Enable the CEC Peripheral */
<> 144:ef7eb2e8f9f7 186 __HAL_CEC_ENABLE(hcec);
AnnaBridge 165:e614a9f1c9e2 187
AnnaBridge 165:e614a9f1c9e2 188 hcec->ErrorCode = HAL_CEC_ERROR_NONE;
AnnaBridge 165:e614a9f1c9e2 189 hcec->gState = HAL_CEC_STATE_READY;
AnnaBridge 165:e614a9f1c9e2 190 hcec->RxState = HAL_CEC_STATE_READY;
<> 144:ef7eb2e8f9f7 191
<> 144:ef7eb2e8f9f7 192 return HAL_OK;
<> 144:ef7eb2e8f9f7 193 }
<> 144:ef7eb2e8f9f7 194
<> 144:ef7eb2e8f9f7 195 /**
<> 144:ef7eb2e8f9f7 196 * @brief DeInitializes the CEC peripheral
<> 144:ef7eb2e8f9f7 197 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 198 * @retval HAL status
<> 144:ef7eb2e8f9f7 199 */
<> 144:ef7eb2e8f9f7 200 HAL_StatusTypeDef HAL_CEC_DeInit(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 201 {
<> 144:ef7eb2e8f9f7 202 /* Check the CEC handle allocation */
<> 144:ef7eb2e8f9f7 203 if(hcec == NULL)
<> 144:ef7eb2e8f9f7 204 {
<> 144:ef7eb2e8f9f7 205 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 206 }
<> 144:ef7eb2e8f9f7 207
<> 144:ef7eb2e8f9f7 208 /* Check the parameters */
<> 144:ef7eb2e8f9f7 209 assert_param(IS_CEC_ALL_INSTANCE(hcec->Instance));
<> 144:ef7eb2e8f9f7 210
AnnaBridge 165:e614a9f1c9e2 211 hcec->gState = HAL_CEC_STATE_BUSY;
AnnaBridge 165:e614a9f1c9e2 212
<> 144:ef7eb2e8f9f7 213 /* DeInit the low level hardware */
<> 144:ef7eb2e8f9f7 214 HAL_CEC_MspDeInit(hcec);
<> 144:ef7eb2e8f9f7 215
AnnaBridge 165:e614a9f1c9e2 216 __HAL_RCC_CEC_FORCE_RESET();
AnnaBridge 165:e614a9f1c9e2 217 __HAL_RCC_CEC_RELEASE_RESET();
AnnaBridge 165:e614a9f1c9e2 218
<> 144:ef7eb2e8f9f7 219 hcec->ErrorCode = HAL_CEC_ERROR_NONE;
AnnaBridge 165:e614a9f1c9e2 220 hcec->gState = HAL_CEC_STATE_RESET;
AnnaBridge 165:e614a9f1c9e2 221 hcec->RxState = HAL_CEC_STATE_RESET;
<> 144:ef7eb2e8f9f7 222
<> 144:ef7eb2e8f9f7 223 /* Process Unlock */
<> 144:ef7eb2e8f9f7 224 __HAL_UNLOCK(hcec);
<> 144:ef7eb2e8f9f7 225
<> 144:ef7eb2e8f9f7 226 return HAL_OK;
<> 144:ef7eb2e8f9f7 227 }
<> 144:ef7eb2e8f9f7 228
<> 144:ef7eb2e8f9f7 229 /**
AnnaBridge 165:e614a9f1c9e2 230 * @brief Initializes the Own Address of the CEC device
AnnaBridge 165:e614a9f1c9e2 231 * @param hcec: CEC handle
AnnaBridge 165:e614a9f1c9e2 232 * @param CEC_OwnAddress: The CEC own address.
AnnaBridge 165:e614a9f1c9e2 233 * @retval HAL status
AnnaBridge 165:e614a9f1c9e2 234 */
AnnaBridge 165:e614a9f1c9e2 235 HAL_StatusTypeDef HAL_CEC_SetDeviceAddress(CEC_HandleTypeDef *hcec, uint16_t CEC_OwnAddress)
AnnaBridge 165:e614a9f1c9e2 236 {
AnnaBridge 165:e614a9f1c9e2 237 /* Check the parameters */
AnnaBridge 165:e614a9f1c9e2 238 assert_param(IS_CEC_OWN_ADDRESS(CEC_OwnAddress));
AnnaBridge 165:e614a9f1c9e2 239
AnnaBridge 165:e614a9f1c9e2 240 if ((hcec->gState == HAL_CEC_STATE_READY) && (hcec->RxState == HAL_CEC_STATE_READY))
AnnaBridge 165:e614a9f1c9e2 241 {
AnnaBridge 165:e614a9f1c9e2 242 /* Process Locked */
AnnaBridge 165:e614a9f1c9e2 243 __HAL_LOCK(hcec);
AnnaBridge 165:e614a9f1c9e2 244
AnnaBridge 165:e614a9f1c9e2 245 hcec->gState = HAL_CEC_STATE_BUSY;
AnnaBridge 165:e614a9f1c9e2 246
AnnaBridge 165:e614a9f1c9e2 247 /* Disable the Peripheral */
AnnaBridge 165:e614a9f1c9e2 248 __HAL_CEC_DISABLE(hcec);
AnnaBridge 165:e614a9f1c9e2 249
AnnaBridge 165:e614a9f1c9e2 250 if(CEC_OwnAddress != CEC_OWN_ADDRESS_NONE)
AnnaBridge 165:e614a9f1c9e2 251 {
AnnaBridge 165:e614a9f1c9e2 252 MODIFY_REG(hcec->Instance->OAR, CEC_OAR_OA, hcec->Init.OwnAddress);
AnnaBridge 165:e614a9f1c9e2 253 }
AnnaBridge 165:e614a9f1c9e2 254 else
AnnaBridge 165:e614a9f1c9e2 255 {
AnnaBridge 165:e614a9f1c9e2 256 CLEAR_BIT(hcec->Instance->OAR, CEC_OAR_OA);
AnnaBridge 165:e614a9f1c9e2 257 }
AnnaBridge 165:e614a9f1c9e2 258
AnnaBridge 165:e614a9f1c9e2 259 hcec->gState = HAL_CEC_STATE_READY;
AnnaBridge 165:e614a9f1c9e2 260 hcec->ErrorCode = HAL_CEC_ERROR_NONE;
AnnaBridge 165:e614a9f1c9e2 261
AnnaBridge 165:e614a9f1c9e2 262 /* Process Unlocked */
AnnaBridge 165:e614a9f1c9e2 263 __HAL_UNLOCK(hcec);
AnnaBridge 165:e614a9f1c9e2 264
AnnaBridge 165:e614a9f1c9e2 265 /* Enable the Peripheral */
AnnaBridge 165:e614a9f1c9e2 266 __HAL_CEC_ENABLE(hcec);
AnnaBridge 165:e614a9f1c9e2 267
AnnaBridge 165:e614a9f1c9e2 268 return HAL_OK;
AnnaBridge 165:e614a9f1c9e2 269 }
AnnaBridge 165:e614a9f1c9e2 270 else
AnnaBridge 165:e614a9f1c9e2 271 {
AnnaBridge 165:e614a9f1c9e2 272 return HAL_BUSY;
AnnaBridge 165:e614a9f1c9e2 273 }
AnnaBridge 165:e614a9f1c9e2 274 }
AnnaBridge 165:e614a9f1c9e2 275
AnnaBridge 165:e614a9f1c9e2 276 /**
<> 144:ef7eb2e8f9f7 277 * @brief CEC MSP Init
<> 144:ef7eb2e8f9f7 278 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 279 * @retval None
<> 144:ef7eb2e8f9f7 280 */
<> 144:ef7eb2e8f9f7 281 __weak void HAL_CEC_MspInit(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 282 {
<> 144:ef7eb2e8f9f7 283 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 284 UNUSED(hcec);
<> 144:ef7eb2e8f9f7 285 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 286 the HAL_CEC_MspInit can be implemented in the user file
<> 144:ef7eb2e8f9f7 287 */
<> 144:ef7eb2e8f9f7 288 }
<> 144:ef7eb2e8f9f7 289
<> 144:ef7eb2e8f9f7 290 /**
<> 144:ef7eb2e8f9f7 291 * @brief CEC MSP DeInit
<> 144:ef7eb2e8f9f7 292 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 293 * @retval None
<> 144:ef7eb2e8f9f7 294 */
<> 144:ef7eb2e8f9f7 295 __weak void HAL_CEC_MspDeInit(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 296 {
<> 144:ef7eb2e8f9f7 297 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 298 UNUSED(hcec);
<> 144:ef7eb2e8f9f7 299 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 300 the HAL_CEC_MspDeInit can be implemented in the user file
<> 144:ef7eb2e8f9f7 301 */
<> 144:ef7eb2e8f9f7 302 }
<> 144:ef7eb2e8f9f7 303
<> 144:ef7eb2e8f9f7 304 /**
<> 144:ef7eb2e8f9f7 305 * @}
<> 144:ef7eb2e8f9f7 306 */
<> 144:ef7eb2e8f9f7 307
<> 144:ef7eb2e8f9f7 308 /** @defgroup CEC_Exported_Functions_Group2 Input and Output operation functions
<> 144:ef7eb2e8f9f7 309 * @brief CEC Transmit/Receive functions
<> 144:ef7eb2e8f9f7 310 *
<> 144:ef7eb2e8f9f7 311 @verbatim
<> 144:ef7eb2e8f9f7 312 ===============================================================================
<> 144:ef7eb2e8f9f7 313 ##### IO operation functions #####
<> 144:ef7eb2e8f9f7 314 ===============================================================================
<> 144:ef7eb2e8f9f7 315 [..]
<> 144:ef7eb2e8f9f7 316 This subsection provides a set of functions allowing to manage the CEC data transfers.
AnnaBridge 165:e614a9f1c9e2 317
AnnaBridge 165:e614a9f1c9e2 318 (#) The CEC handle must contain the initiator (TX side) and the destination (RX side)
AnnaBridge 165:e614a9f1c9e2 319 logical addresses (4-bit long addresses, 0xF for broadcast messages destination)
AnnaBridge 165:e614a9f1c9e2 320
AnnaBridge 165:e614a9f1c9e2 321 (#) The communication is performed using Interrupts.
<> 144:ef7eb2e8f9f7 322 These API's return the HAL status.
<> 144:ef7eb2e8f9f7 323 The end of the data processing will be indicated through the
<> 144:ef7eb2e8f9f7 324 dedicated CEC IRQ when using Interrupt mode.
<> 144:ef7eb2e8f9f7 325 The HAL_CEC_TxCpltCallback(), HAL_CEC_RxCpltCallback() user callbacks
AnnaBridge 165:e614a9f1c9e2 326 will be executed respectively at the end of the transmit or Receive process
AnnaBridge 165:e614a9f1c9e2 327 The HAL_CEC_ErrorCallback() user callback will be executed when a communication
<> 144:ef7eb2e8f9f7 328 error is detected
AnnaBridge 165:e614a9f1c9e2 329
AnnaBridge 165:e614a9f1c9e2 330 (#) API's with Interrupt are :
AnnaBridge 165:e614a9f1c9e2 331 (+) HAL_CEC_Transmit_IT()
AnnaBridge 165:e614a9f1c9e2 332 (+) HAL_CEC_IRQHandler()
AnnaBridge 165:e614a9f1c9e2 333
AnnaBridge 165:e614a9f1c9e2 334 (#) A set of User Callbacks are provided:
AnnaBridge 165:e614a9f1c9e2 335 (+) HAL_CEC_TxCpltCallback()
AnnaBridge 165:e614a9f1c9e2 336 (+) HAL_CEC_RxCpltCallback()
AnnaBridge 165:e614a9f1c9e2 337 (+) HAL_CEC_ErrorCallback()
<> 144:ef7eb2e8f9f7 338
<> 144:ef7eb2e8f9f7 339 @endverbatim
<> 144:ef7eb2e8f9f7 340 * @{
<> 144:ef7eb2e8f9f7 341 */
<> 144:ef7eb2e8f9f7 342
<> 144:ef7eb2e8f9f7 343 /**
<> 144:ef7eb2e8f9f7 344 * @brief Send data in interrupt mode
<> 144:ef7eb2e8f9f7 345 * @param hcec: CEC handle
AnnaBridge 165:e614a9f1c9e2 346 * @param InitiatorAddress: Initiator address
<> 144:ef7eb2e8f9f7 347 * @param DestinationAddress: destination logical address
<> 144:ef7eb2e8f9f7 348 * @param pData: pointer to input byte data buffer
<> 144:ef7eb2e8f9f7 349 * @param Size: amount of data to be sent in bytes (without counting the header).
<> 144:ef7eb2e8f9f7 350 * 0 means only the header is sent (ping operation).
<> 144:ef7eb2e8f9f7 351 * Maximum TX size is 15 bytes (1 opcode and up to 14 operands).
<> 144:ef7eb2e8f9f7 352 * @retval HAL status
<> 144:ef7eb2e8f9f7 353 */
AnnaBridge 165:e614a9f1c9e2 354 HAL_StatusTypeDef HAL_CEC_Transmit_IT(CEC_HandleTypeDef *hcec, uint8_t InitiatorAddress,uint8_t DestinationAddress, uint8_t *pData, uint32_t Size)
<> 144:ef7eb2e8f9f7 355 {
AnnaBridge 165:e614a9f1c9e2 356 /* if the IP isn't already busy and if there is no previous transmission
AnnaBridge 165:e614a9f1c9e2 357 already pending due to arbitration lost */
AnnaBridge 165:e614a9f1c9e2 358 if(hcec->gState == HAL_CEC_STATE_READY)
AnnaBridge 165:e614a9f1c9e2 359 {
AnnaBridge 165:e614a9f1c9e2 360 if((pData == NULL ) && (Size > 0U))
<> 144:ef7eb2e8f9f7 361 {
<> 144:ef7eb2e8f9f7 362 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 363 }
<> 144:ef7eb2e8f9f7 364
<> 144:ef7eb2e8f9f7 365 assert_param(IS_CEC_ADDRESS(DestinationAddress));
AnnaBridge 165:e614a9f1c9e2 366 assert_param(IS_CEC_ADDRESS(InitiatorAddress));
AnnaBridge 165:e614a9f1c9e2 367 assert_param(IS_CEC_MSGSIZE(Size));
<> 144:ef7eb2e8f9f7 368
<> 144:ef7eb2e8f9f7 369 /* Process Locked */
<> 144:ef7eb2e8f9f7 370 __HAL_LOCK(hcec);
<> 144:ef7eb2e8f9f7 371 hcec->pTxBuffPtr = pData;
AnnaBridge 165:e614a9f1c9e2 372 hcec->gState = HAL_CEC_STATE_BUSY_TX;
<> 144:ef7eb2e8f9f7 373 hcec->ErrorCode = HAL_CEC_ERROR_NONE;
AnnaBridge 165:e614a9f1c9e2 374
<> 144:ef7eb2e8f9f7 375 /* initialize the number of bytes to send,
<> 144:ef7eb2e8f9f7 376 * 0 means only one header is sent (ping operation) */
<> 144:ef7eb2e8f9f7 377 hcec->TxXferCount = Size;
<> 144:ef7eb2e8f9f7 378
<> 144:ef7eb2e8f9f7 379 /* send header block */
AnnaBridge 165:e614a9f1c9e2 380 hcec->Instance->TXD = (uint8_t)((uint32_t)InitiatorAddress << CEC_INITIATOR_LSB_POS) | DestinationAddress;
<> 144:ef7eb2e8f9f7 381
<> 144:ef7eb2e8f9f7 382 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 383 __HAL_UNLOCK(hcec);
<> 144:ef7eb2e8f9f7 384
<> 144:ef7eb2e8f9f7 385 /* case no data to be sent, sender is only pinging the system */
<> 144:ef7eb2e8f9f7 386 if (Size != 0)
<> 144:ef7eb2e8f9f7 387 {
<> 144:ef7eb2e8f9f7 388 /* Set TX Start of Message (TXSOM) bit */
<> 144:ef7eb2e8f9f7 389 MODIFY_REG(hcec->Instance->CSR, CEC_FLAG_TRANSMIT_MASK, CEC_FLAG_TSOM);
<> 144:ef7eb2e8f9f7 390 }
<> 144:ef7eb2e8f9f7 391 else
<> 144:ef7eb2e8f9f7 392 {
<> 144:ef7eb2e8f9f7 393 /* Send a ping command */
<> 144:ef7eb2e8f9f7 394 MODIFY_REG(hcec->Instance->CSR, CEC_FLAG_TRANSMIT_MASK, CEC_FLAG_TEOM|CEC_FLAG_TSOM);
<> 144:ef7eb2e8f9f7 395 }
<> 144:ef7eb2e8f9f7 396 return HAL_OK;
AnnaBridge 165:e614a9f1c9e2 397
<> 144:ef7eb2e8f9f7 398 }
<> 144:ef7eb2e8f9f7 399 else
<> 144:ef7eb2e8f9f7 400 {
<> 144:ef7eb2e8f9f7 401 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 402 }
<> 144:ef7eb2e8f9f7 403 }
<> 144:ef7eb2e8f9f7 404
<> 144:ef7eb2e8f9f7 405 /**
<> 144:ef7eb2e8f9f7 406 * @brief Get size of the received frame.
<> 144:ef7eb2e8f9f7 407 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 408 * @retval Frame size
<> 144:ef7eb2e8f9f7 409 */
AnnaBridge 165:e614a9f1c9e2 410 uint32_t HAL_CEC_GetLastReceivedFrameSize(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 411 {
<> 144:ef7eb2e8f9f7 412 return hcec->RxXferSize;
<> 144:ef7eb2e8f9f7 413 }
AnnaBridge 165:e614a9f1c9e2 414
AnnaBridge 165:e614a9f1c9e2 415 /**
AnnaBridge 165:e614a9f1c9e2 416 * @brief Change Rx Buffer.
AnnaBridge 165:e614a9f1c9e2 417 * @param hcec: CEC handle
AnnaBridge 165:e614a9f1c9e2 418 * @param Rxbuffer: Rx Buffer
AnnaBridge 165:e614a9f1c9e2 419 * @note This function can be called only inside the HAL_CEC_RxCpltCallback()
AnnaBridge 165:e614a9f1c9e2 420 * @retval Frame size
AnnaBridge 165:e614a9f1c9e2 421 */
AnnaBridge 165:e614a9f1c9e2 422 void HAL_CEC_ChangeRxBuffer(CEC_HandleTypeDef *hcec, uint8_t* Rxbuffer)
AnnaBridge 165:e614a9f1c9e2 423 {
AnnaBridge 165:e614a9f1c9e2 424 hcec->Init.RxBuffer = Rxbuffer;
AnnaBridge 165:e614a9f1c9e2 425 }
<> 144:ef7eb2e8f9f7 426
<> 144:ef7eb2e8f9f7 427 /**
<> 144:ef7eb2e8f9f7 428 * @brief This function handles CEC interrupt requests.
<> 144:ef7eb2e8f9f7 429 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 430 * @retval None
<> 144:ef7eb2e8f9f7 431 */
<> 144:ef7eb2e8f9f7 432 void HAL_CEC_IRQHandler(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 433 {
<> 144:ef7eb2e8f9f7 434 /* Save error status register for further error handling purposes */
<> 144:ef7eb2e8f9f7 435 hcec->ErrorCode = READ_BIT(hcec->Instance->ESR, CEC_ESR_ALL_ERROR);
<> 144:ef7eb2e8f9f7 436
<> 144:ef7eb2e8f9f7 437 /* Transmit error */
AnnaBridge 165:e614a9f1c9e2 438 if(__HAL_CEC_GET_FLAG(hcec, CEC_FLAG_TERR) != RESET)
<> 144:ef7eb2e8f9f7 439 {
<> 144:ef7eb2e8f9f7 440 /* Acknowledgement of the error */
<> 144:ef7eb2e8f9f7 441 __HAL_CEC_CLEAR_FLAG(hcec, CEC_FLAG_TERR);
<> 144:ef7eb2e8f9f7 442
AnnaBridge 165:e614a9f1c9e2 443 hcec->gState = HAL_CEC_STATE_READY;
<> 144:ef7eb2e8f9f7 444 }
<> 144:ef7eb2e8f9f7 445
<> 144:ef7eb2e8f9f7 446 /* Receive error */
AnnaBridge 165:e614a9f1c9e2 447 if(__HAL_CEC_GET_FLAG(hcec, CEC_FLAG_RERR) != RESET)
<> 144:ef7eb2e8f9f7 448 {
<> 144:ef7eb2e8f9f7 449 /* Acknowledgement of the error */
<> 144:ef7eb2e8f9f7 450 __HAL_CEC_CLEAR_FLAG(hcec, CEC_FLAG_RERR);
AnnaBridge 165:e614a9f1c9e2 451 hcec->Init.RxBuffer-=hcec->RxXferSize;
AnnaBridge 165:e614a9f1c9e2 452 hcec->RxXferSize = 0U;
AnnaBridge 165:e614a9f1c9e2 453 hcec->RxState = HAL_CEC_STATE_READY;
AnnaBridge 165:e614a9f1c9e2 454 }
<> 144:ef7eb2e8f9f7 455
AnnaBridge 165:e614a9f1c9e2 456 if((hcec->ErrorCode & CEC_ESR_ALL_ERROR) != 0U)
<> 144:ef7eb2e8f9f7 457 {
AnnaBridge 165:e614a9f1c9e2 458 /* Error Call Back */
<> 144:ef7eb2e8f9f7 459 HAL_CEC_ErrorCallback(hcec);
<> 144:ef7eb2e8f9f7 460 }
<> 144:ef7eb2e8f9f7 461
<> 144:ef7eb2e8f9f7 462 /* Transmit byte request or block transfer finished */
AnnaBridge 165:e614a9f1c9e2 463 if(__HAL_CEC_GET_FLAG(hcec, CEC_FLAG_TBTRF) != RESET)
<> 144:ef7eb2e8f9f7 464 {
<> 144:ef7eb2e8f9f7 465 CEC_Transmit_IT(hcec);
AnnaBridge 165:e614a9f1c9e2 466 }
<> 144:ef7eb2e8f9f7 467
<> 144:ef7eb2e8f9f7 468 /* Receive byte or block transfer finished */
AnnaBridge 165:e614a9f1c9e2 469 if(__HAL_CEC_GET_FLAG(hcec, CEC_FLAG_RBTF) != RESET)
<> 144:ef7eb2e8f9f7 470 {
AnnaBridge 165:e614a9f1c9e2 471 if(hcec->RxXferSize == 0U)
AnnaBridge 165:e614a9f1c9e2 472 {
AnnaBridge 165:e614a9f1c9e2 473 /* reception is starting */
AnnaBridge 165:e614a9f1c9e2 474 hcec->RxState = HAL_CEC_STATE_BUSY_RX;
AnnaBridge 165:e614a9f1c9e2 475 }
<> 144:ef7eb2e8f9f7 476 CEC_Receive_IT(hcec);
<> 144:ef7eb2e8f9f7 477 }
<> 144:ef7eb2e8f9f7 478 }
<> 144:ef7eb2e8f9f7 479
<> 144:ef7eb2e8f9f7 480
<> 144:ef7eb2e8f9f7 481 /**
<> 144:ef7eb2e8f9f7 482 * @brief Tx Transfer completed callback
<> 144:ef7eb2e8f9f7 483 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 484 * @retval None
<> 144:ef7eb2e8f9f7 485 */
<> 144:ef7eb2e8f9f7 486 __weak void HAL_CEC_TxCpltCallback(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 487 {
<> 144:ef7eb2e8f9f7 488 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 489 UNUSED(hcec);
<> 144:ef7eb2e8f9f7 490 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 491 the HAL_CEC_TxCpltCallback can be implemented in the user file
<> 144:ef7eb2e8f9f7 492 */
<> 144:ef7eb2e8f9f7 493 }
<> 144:ef7eb2e8f9f7 494
<> 144:ef7eb2e8f9f7 495 /**
<> 144:ef7eb2e8f9f7 496 * @brief Rx Transfer completed callback
<> 144:ef7eb2e8f9f7 497 * @param hcec: CEC handle
AnnaBridge 165:e614a9f1c9e2 498 * @param RxFrameSize: Size of frame
<> 144:ef7eb2e8f9f7 499 * @retval None
<> 144:ef7eb2e8f9f7 500 */
AnnaBridge 165:e614a9f1c9e2 501 __weak void HAL_CEC_RxCpltCallback(CEC_HandleTypeDef *hcec, uint32_t RxFrameSize)
<> 144:ef7eb2e8f9f7 502 {
<> 144:ef7eb2e8f9f7 503 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 504 UNUSED(hcec);
AnnaBridge 165:e614a9f1c9e2 505 UNUSED(RxFrameSize);
<> 144:ef7eb2e8f9f7 506 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 507 the HAL_CEC_RxCpltCallback can be implemented in the user file
<> 144:ef7eb2e8f9f7 508 */
<> 144:ef7eb2e8f9f7 509 }
<> 144:ef7eb2e8f9f7 510
<> 144:ef7eb2e8f9f7 511 /**
<> 144:ef7eb2e8f9f7 512 * @brief CEC error callbacks
<> 144:ef7eb2e8f9f7 513 * @param hcec: CEC handle
<> 144:ef7eb2e8f9f7 514 * @retval None
<> 144:ef7eb2e8f9f7 515 */
<> 144:ef7eb2e8f9f7 516 __weak void HAL_CEC_ErrorCallback(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 517 {
<> 144:ef7eb2e8f9f7 518 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 519 UNUSED(hcec);
<> 144:ef7eb2e8f9f7 520 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 521 the HAL_CEC_ErrorCallback can be implemented in the user file
<> 144:ef7eb2e8f9f7 522 */
<> 144:ef7eb2e8f9f7 523 }
<> 144:ef7eb2e8f9f7 524 /**
<> 144:ef7eb2e8f9f7 525 * @}
<> 144:ef7eb2e8f9f7 526 */
<> 144:ef7eb2e8f9f7 527
<> 144:ef7eb2e8f9f7 528 /** @defgroup CEC_Exported_Functions_Group3 Peripheral Control functions
<> 144:ef7eb2e8f9f7 529 * @brief CEC control functions
<> 144:ef7eb2e8f9f7 530 *
<> 144:ef7eb2e8f9f7 531 @verbatim
<> 144:ef7eb2e8f9f7 532 ===============================================================================
AnnaBridge 165:e614a9f1c9e2 533 ##### Peripheral Control function #####
<> 144:ef7eb2e8f9f7 534 ===============================================================================
<> 144:ef7eb2e8f9f7 535 [..]
<> 144:ef7eb2e8f9f7 536 This subsection provides a set of functions allowing to control the CEC.
<> 144:ef7eb2e8f9f7 537 (+) HAL_CEC_GetState() API can be helpful to check in run-time the state of the CEC peripheral.
AnnaBridge 165:e614a9f1c9e2 538 (+) HAL_CEC_GetError() API can be helpful to check in run-time the error of the CEC peripheral.
<> 144:ef7eb2e8f9f7 539 @endverbatim
<> 144:ef7eb2e8f9f7 540 * @{
<> 144:ef7eb2e8f9f7 541 */
<> 144:ef7eb2e8f9f7 542 /**
<> 144:ef7eb2e8f9f7 543 * @brief return the CEC state
AnnaBridge 165:e614a9f1c9e2 544 * @param hcec: pointer to a CEC_HandleTypeDef structure that contains
AnnaBridge 165:e614a9f1c9e2 545 * the configuration information for the specified CEC module.
<> 144:ef7eb2e8f9f7 546 * @retval HAL state
<> 144:ef7eb2e8f9f7 547 */
<> 144:ef7eb2e8f9f7 548 HAL_CEC_StateTypeDef HAL_CEC_GetState(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 549 {
AnnaBridge 165:e614a9f1c9e2 550 uint32_t temp1= 0x00U, temp2 = 0x00U;
AnnaBridge 165:e614a9f1c9e2 551 temp1 = hcec->gState;
AnnaBridge 165:e614a9f1c9e2 552 temp2 = hcec->RxState;
AnnaBridge 165:e614a9f1c9e2 553
AnnaBridge 165:e614a9f1c9e2 554 return (HAL_CEC_StateTypeDef)(temp1 | temp2);
<> 144:ef7eb2e8f9f7 555 }
<> 144:ef7eb2e8f9f7 556
<> 144:ef7eb2e8f9f7 557 /**
<> 144:ef7eb2e8f9f7 558 * @brief Return the CEC error code
<> 144:ef7eb2e8f9f7 559 * @param hcec : pointer to a CEC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 560 * the configuration information for the specified CEC.
<> 144:ef7eb2e8f9f7 561 * @retval CEC Error Code
<> 144:ef7eb2e8f9f7 562 */
<> 144:ef7eb2e8f9f7 563 uint32_t HAL_CEC_GetError(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 564 {
<> 144:ef7eb2e8f9f7 565 return hcec->ErrorCode;
<> 144:ef7eb2e8f9f7 566 }
<> 144:ef7eb2e8f9f7 567
<> 144:ef7eb2e8f9f7 568 /**
<> 144:ef7eb2e8f9f7 569 * @}
<> 144:ef7eb2e8f9f7 570 */
<> 144:ef7eb2e8f9f7 571
<> 144:ef7eb2e8f9f7 572 /**
<> 144:ef7eb2e8f9f7 573 * @}
<> 144:ef7eb2e8f9f7 574 */
<> 144:ef7eb2e8f9f7 575
<> 144:ef7eb2e8f9f7 576 /** @addtogroup CEC_Private_Functions
<> 144:ef7eb2e8f9f7 577 * @{
<> 144:ef7eb2e8f9f7 578 */
<> 144:ef7eb2e8f9f7 579
<> 144:ef7eb2e8f9f7 580 /**
<> 144:ef7eb2e8f9f7 581 * @brief Send data in interrupt mode
<> 144:ef7eb2e8f9f7 582 * @param hcec: CEC handle.
<> 144:ef7eb2e8f9f7 583 * Function called under interruption only, once
<> 144:ef7eb2e8f9f7 584 * interruptions have been enabled by HAL_CEC_Transmit_IT()
<> 144:ef7eb2e8f9f7 585 * @retval HAL status
<> 144:ef7eb2e8f9f7 586 */
<> 144:ef7eb2e8f9f7 587 static HAL_StatusTypeDef CEC_Transmit_IT(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 588 {
<> 144:ef7eb2e8f9f7 589 /* if the IP is already busy or if there is a previous transmission
<> 144:ef7eb2e8f9f7 590 already pending due to arbitration loss */
AnnaBridge 165:e614a9f1c9e2 591 if((hcec->gState == HAL_CEC_STATE_BUSY_TX) || (__HAL_CEC_GET_TRANSMISSION_START_FLAG(hcec) != RESET))
<> 144:ef7eb2e8f9f7 592 {
<> 144:ef7eb2e8f9f7 593 /* if all data have been sent */
AnnaBridge 165:e614a9f1c9e2 594 if(hcec->TxXferCount == 0U)
<> 144:ef7eb2e8f9f7 595 {
<> 144:ef7eb2e8f9f7 596 /* Acknowledge successful completion by writing 0x00 */
AnnaBridge 165:e614a9f1c9e2 597 MODIFY_REG(hcec->Instance->CSR, CEC_FLAG_TRANSMIT_MASK, 0x00U);
<> 144:ef7eb2e8f9f7 598
AnnaBridge 165:e614a9f1c9e2 599 hcec->gState = HAL_CEC_STATE_READY;
<> 144:ef7eb2e8f9f7 600
<> 144:ef7eb2e8f9f7 601 HAL_CEC_TxCpltCallback(hcec);
<> 144:ef7eb2e8f9f7 602
<> 144:ef7eb2e8f9f7 603 return HAL_OK;
<> 144:ef7eb2e8f9f7 604 }
<> 144:ef7eb2e8f9f7 605 else
<> 144:ef7eb2e8f9f7 606 {
<> 144:ef7eb2e8f9f7 607 /* Reduce the number of bytes to transfer by one */
<> 144:ef7eb2e8f9f7 608 hcec->TxXferCount--;
<> 144:ef7eb2e8f9f7 609
<> 144:ef7eb2e8f9f7 610 /* Write data to TX buffer*/
<> 144:ef7eb2e8f9f7 611 hcec->Instance->TXD = *hcec->pTxBuffPtr++;
<> 144:ef7eb2e8f9f7 612
<> 144:ef7eb2e8f9f7 613 /* If this is the last byte of the ongoing transmission */
AnnaBridge 165:e614a9f1c9e2 614 if(hcec->TxXferCount == 0U)
<> 144:ef7eb2e8f9f7 615 {
<> 144:ef7eb2e8f9f7 616 /* Acknowledge byte request and signal end of message */
<> 144:ef7eb2e8f9f7 617 MODIFY_REG(hcec->Instance->CSR, CEC_FLAG_TRANSMIT_MASK, CEC_FLAG_TEOM);
<> 144:ef7eb2e8f9f7 618 }
<> 144:ef7eb2e8f9f7 619 else
<> 144:ef7eb2e8f9f7 620 {
<> 144:ef7eb2e8f9f7 621 /* Acknowledge byte request by writing 0x00 */
AnnaBridge 165:e614a9f1c9e2 622 MODIFY_REG(hcec->Instance->CSR, CEC_FLAG_TRANSMIT_MASK, 0x00U);
<> 144:ef7eb2e8f9f7 623 }
<> 144:ef7eb2e8f9f7 624
<> 144:ef7eb2e8f9f7 625 return HAL_OK;
<> 144:ef7eb2e8f9f7 626 }
<> 144:ef7eb2e8f9f7 627 }
<> 144:ef7eb2e8f9f7 628 else
<> 144:ef7eb2e8f9f7 629 {
<> 144:ef7eb2e8f9f7 630 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 631 }
<> 144:ef7eb2e8f9f7 632 }
<> 144:ef7eb2e8f9f7 633
<> 144:ef7eb2e8f9f7 634 /**
<> 144:ef7eb2e8f9f7 635 * @brief Receive data in interrupt mode.
<> 144:ef7eb2e8f9f7 636 * @param hcec: CEC handle.
<> 144:ef7eb2e8f9f7 637 * Function called under interruption only, once
<> 144:ef7eb2e8f9f7 638 * interruptions have been enabled by HAL_CEC_Receive_IT()
<> 144:ef7eb2e8f9f7 639 * @retval HAL status
<> 144:ef7eb2e8f9f7 640 */
<> 144:ef7eb2e8f9f7 641 static HAL_StatusTypeDef CEC_Receive_IT(CEC_HandleTypeDef *hcec)
<> 144:ef7eb2e8f9f7 642 {
<> 144:ef7eb2e8f9f7 643 static uint32_t temp;
AnnaBridge 165:e614a9f1c9e2 644
AnnaBridge 165:e614a9f1c9e2 645 if(hcec->RxState == HAL_CEC_STATE_BUSY_RX)
<> 144:ef7eb2e8f9f7 646 {
<> 144:ef7eb2e8f9f7 647 temp = hcec->Instance->CSR;
<> 144:ef7eb2e8f9f7 648
<> 144:ef7eb2e8f9f7 649 /* Store received data */
AnnaBridge 165:e614a9f1c9e2 650 hcec->RxXferSize++;
AnnaBridge 165:e614a9f1c9e2 651 *hcec->Init.RxBuffer++ = hcec->Instance->RXD;
<> 144:ef7eb2e8f9f7 652
<> 144:ef7eb2e8f9f7 653 /* Acknowledge received byte by writing 0x00 */
AnnaBridge 165:e614a9f1c9e2 654 MODIFY_REG(hcec->Instance->CSR, CEC_FLAG_RECEIVE_MASK, 0x00U);
<> 144:ef7eb2e8f9f7 655
<> 144:ef7eb2e8f9f7 656 /* If the End Of Message is reached */
<> 144:ef7eb2e8f9f7 657 if(HAL_IS_BIT_SET(temp, CEC_FLAG_REOM))
<> 144:ef7eb2e8f9f7 658 {
AnnaBridge 165:e614a9f1c9e2 659 /* Interrupts are not disabled due to transmission still ongoing */
AnnaBridge 165:e614a9f1c9e2 660 hcec->RxState = HAL_CEC_STATE_READY;
AnnaBridge 165:e614a9f1c9e2 661
AnnaBridge 165:e614a9f1c9e2 662 HAL_CEC_RxCpltCallback(hcec, hcec->RxXferSize);
AnnaBridge 165:e614a9f1c9e2 663
<> 144:ef7eb2e8f9f7 664 return HAL_OK;
AnnaBridge 165:e614a9f1c9e2 665 }
<> 144:ef7eb2e8f9f7 666 else
<> 144:ef7eb2e8f9f7 667 {
<> 144:ef7eb2e8f9f7 668 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 669 }
<> 144:ef7eb2e8f9f7 670 }
<> 144:ef7eb2e8f9f7 671 else
<> 144:ef7eb2e8f9f7 672 {
<> 144:ef7eb2e8f9f7 673 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 674 }
<> 144:ef7eb2e8f9f7 675 }
<> 144:ef7eb2e8f9f7 676
<> 144:ef7eb2e8f9f7 677 /**
<> 144:ef7eb2e8f9f7 678 * @}
<> 144:ef7eb2e8f9f7 679 */
<> 144:ef7eb2e8f9f7 680
<> 144:ef7eb2e8f9f7 681 /**
<> 144:ef7eb2e8f9f7 682 * @}
<> 144:ef7eb2e8f9f7 683 */
<> 144:ef7eb2e8f9f7 684
<> 144:ef7eb2e8f9f7 685 #endif /* defined(STM32F100xB) || defined(STM32F100xE) */
<> 144:ef7eb2e8f9f7 686
<> 144:ef7eb2e8f9f7 687 #endif /* HAL_CEC_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 688 /**
<> 144:ef7eb2e8f9f7 689 * @}
<> 144:ef7eb2e8f9f7 690 */
<> 144:ef7eb2e8f9f7 691
<> 144:ef7eb2e8f9f7 692 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/