source: trunk/firmware/Drivers/STM32G0xx_HAL_Driver/Src/stm32g0xx_hal_smbus.c

Last change on this file was 6, checked in by f.jahn, 3 months ago
File size: 95.1 KB
Line 
1/**
2  ******************************************************************************
3  * @file    stm32g0xx_hal_smbus.c
4  * @author  MCD Application Team
5  * @brief   SMBUS HAL module driver.
6  *          This file provides firmware functions to manage the following
7  *          functionalities of the System Management Bus (SMBus) peripheral,
8  *          based on I2C principles of operation :
9  *           + Initialization and de-initialization functions
10  *           + IO operation functions
11  *           + Peripheral State and Errors functions
12  *
13  @verbatim
14  ==============================================================================
15                        ##### How to use this driver #####
16  ==============================================================================
17    [..]
18    The SMBUS HAL driver can be used as follows:
19
20    (#) Declare a SMBUS_HandleTypeDef handle structure, for example:
21        SMBUS_HandleTypeDef  hsmbus;
22
23    (#)Initialize the SMBUS low level resources by implementing the @ref HAL_SMBUS_MspInit() API:
24        (##) Enable the SMBUSx interface clock
25        (##) SMBUS pins configuration
26            (+++) Enable the clock for the SMBUS GPIOs
27            (+++) Configure SMBUS pins as alternate function open-drain
28        (##) NVIC configuration if you need to use interrupt process
29            (+++) Configure the SMBUSx interrupt priority
30            (+++) Enable the NVIC SMBUS IRQ Channel
31
32    (#) Configure the Communication Clock Timing, Bus Timeout, Own Address1, Master Addressing mode,
33        Dual Addressing mode, Own Address2, Own Address2 Mask, General call, Nostretch mode,
34        Peripheral mode and Packet Error Check mode in the hsmbus Init structure.
35
36    (#) Initialize the SMBUS registers by calling the @ref HAL_SMBUS_Init() API:
37        (++) These API's configures also the low level Hardware GPIO, CLOCK, CORTEX...etc)
38             by calling the customized @ref HAL_SMBUS_MspInit(&hsmbus) API.
39
40    (#) To check if target device is ready for communication, use the function @ref HAL_SMBUS_IsDeviceReady()
41
42    (#) For SMBUS IO operations, only one mode of operations is available within this driver
43
44    *** Interrupt mode IO operation ***
45    ===================================
46    [..]
47      (+) Transmit in master/host SMBUS mode an amount of data in non-blocking mode using @ref HAL_SMBUS_Master_Transmit_IT()
48      (++) At transmission end of transfer @ref HAL_SMBUS_MasterTxCpltCallback() is executed and user can
49           add his own code by customization of function pointer @ref HAL_SMBUS_MasterTxCpltCallback()
50      (+) Receive in master/host SMBUS mode an amount of data in non-blocking mode using @ref HAL_SMBUS_Master_Receive_IT()
51      (++) At reception end of transfer @ref HAL_SMBUS_MasterRxCpltCallback() is executed and user can
52           add his own code by customization of function pointer @ref HAL_SMBUS_MasterRxCpltCallback()
53      (+) Abort a master/host SMBUS process communication with Interrupt using @ref HAL_SMBUS_Master_Abort_IT()
54      (++) The associated previous transfer callback is called at the end of abort process
55      (++) mean @ref HAL_SMBUS_MasterTxCpltCallback() in case of previous state was master transmit
56      (++) mean @ref HAL_SMBUS_MasterRxCpltCallback() in case of previous state was master receive
57      (+) Enable/disable the Address listen mode in slave/device or host/slave SMBUS mode
58           using @ref HAL_SMBUS_EnableListen_IT() @ref HAL_SMBUS_DisableListen_IT()
59      (++) When address slave/device SMBUS match, @ref HAL_SMBUS_AddrCallback() is executed and user can
60           add his own code to check the Address Match Code and the transmission direction request by master/host (Write/Read).
61      (++) At Listen mode end @ref HAL_SMBUS_ListenCpltCallback() is executed and user can
62           add his own code by customization of function pointer @ref HAL_SMBUS_ListenCpltCallback()
63      (+) Transmit in slave/device SMBUS mode an amount of data in non-blocking mode using @ref HAL_SMBUS_Slave_Transmit_IT()
64      (++) At transmission end of transfer @ref HAL_SMBUS_SlaveTxCpltCallback() is executed and user can
65           add his own code by customization of function pointer @ref HAL_SMBUS_SlaveTxCpltCallback()
66      (+) Receive in slave/device SMBUS mode an amount of data in non-blocking mode using @ref HAL_SMBUS_Slave_Receive_IT()
67      (++) At reception end of transfer @ref HAL_SMBUS_SlaveRxCpltCallback() is executed and user can
68           add his own code by customization of function pointer @ref HAL_SMBUS_SlaveRxCpltCallback()
69      (+) Enable/Disable the SMBUS alert mode using @ref HAL_SMBUS_EnableAlert_IT() @ref HAL_SMBUS_DisableAlert_IT()
70      (++) When SMBUS Alert is generated @ref HAL_SMBUS_ErrorCallback() is executed and user can
71           add his own code by customization of function pointer @ref HAL_SMBUS_ErrorCallback()
72           to check the Alert Error Code using function @ref HAL_SMBUS_GetError()
73      (+) Get HAL state machine or error values using @ref HAL_SMBUS_GetState() or @ref HAL_SMBUS_GetError()
74      (+) In case of transfer Error, @ref HAL_SMBUS_ErrorCallback() function is executed and user can
75           add his own code by customization of function pointer @ref HAL_SMBUS_ErrorCallback()
76           to check the Error Code using function @ref HAL_SMBUS_GetError()
77
78     *** SMBUS HAL driver macros list ***
79     ==================================
80     [..]
81       Below the list of most used macros in SMBUS HAL driver.
82
83      (+) @ref __HAL_SMBUS_ENABLE:      Enable the SMBUS peripheral
84      (+) @ref __HAL_SMBUS_DISABLE:     Disable the SMBUS peripheral
85      (+) @ref __HAL_SMBUS_GET_FLAG:    Check whether the specified SMBUS flag is set or not
86      (+) @ref __HAL_SMBUS_CLEAR_FLAG:  Clear the specified SMBUS pending flag
87      (+) @ref __HAL_SMBUS_ENABLE_IT:   Enable the specified SMBUS interrupt
88      (+) @ref __HAL_SMBUS_DISABLE_IT:  Disable the specified SMBUS interrupt
89
90     *** Callback registration ***
91     =============================================
92    [..]
93     The compilation flag USE_HAL_SMBUS_REGISTER_CALLBACKS when set to 1
94     allows the user to configure dynamically the driver callbacks.
95     Use Functions @ref HAL_SMBUS_RegisterCallback() or @ref HAL_SMBUS_RegisterAddrCallback()
96     to register an interrupt callback.
97    [..]
98     Function @ref HAL_SMBUS_RegisterCallback() allows to register following callbacks:
99       (+) MasterTxCpltCallback : callback for Master transmission end of transfer.
100       (+) MasterRxCpltCallback : callback for Master reception end of transfer.
101       (+) SlaveTxCpltCallback  : callback for Slave transmission end of transfer.
102       (+) SlaveRxCpltCallback  : callback for Slave reception end of transfer.
103       (+) ListenCpltCallback   : callback for end of listen mode.
104       (+) ErrorCallback        : callback for error detection.
105       (+) MspInitCallback      : callback for Msp Init.
106       (+) MspDeInitCallback    : callback for Msp DeInit.
107     This function takes as parameters the HAL peripheral handle, the Callback ID
108     and a pointer to the user callback function.
109    [..]
110     For specific callback AddrCallback use dedicated register callbacks : @ref HAL_SMBUS_RegisterAddrCallback.
111    [..]
112     Use function @ref HAL_SMBUS_UnRegisterCallback to reset a callback to the default
113     weak function.
114     @ref HAL_SMBUS_UnRegisterCallback takes as parameters the HAL peripheral handle,
115     and the Callback ID.
116     This function allows to reset following callbacks:
117       (+) MasterTxCpltCallback : callback for Master transmission end of transfer.
118       (+) MasterRxCpltCallback : callback for Master reception end of transfer.
119       (+) SlaveTxCpltCallback  : callback for Slave transmission end of transfer.
120       (+) SlaveRxCpltCallback  : callback for Slave reception end of transfer.
121       (+) ListenCpltCallback   : callback for end of listen mode.
122       (+) ErrorCallback        : callback for error detection.
123       (+) MspInitCallback      : callback for Msp Init.
124       (+) MspDeInitCallback    : callback for Msp DeInit.
125    [..]
126     For callback AddrCallback use dedicated register callbacks : @ref HAL_SMBUS_UnRegisterAddrCallback.
127    [..]
128     By default, after the @ref HAL_SMBUS_Init() and when the state is @ref HAL_I2C_STATE_RESET
129     all callbacks are set to the corresponding weak functions:
130     examples @ref HAL_SMBUS_MasterTxCpltCallback(), @ref HAL_SMBUS_MasterRxCpltCallback().
131     Exception done for MspInit and MspDeInit functions that are
132     reset to the legacy weak functions in the @ref HAL_SMBUS_Init()/ @ref HAL_SMBUS_DeInit() only when
133     these callbacks are null (not registered beforehand).
134     If MspInit or MspDeInit are not null, the @ref HAL_SMBUS_Init()/ @ref HAL_SMBUS_DeInit()
135     keep and use the user MspInit/MspDeInit callbacks (registered beforehand) whatever the state.
136    [..]
137     Callbacks can be registered/unregistered in @ref HAL_I2C_STATE_READY state only.
138     Exception done MspInit/MspDeInit functions that can be registered/unregistered
139     in @ref HAL_I2C_STATE_READY or @ref HAL_I2C_STATE_RESET state,
140     thus registered (user) MspInit/DeInit callbacks can be used during the Init/DeInit.
141     Then, the user first registers the MspInit/MspDeInit user callbacks
142     using @ref HAL_SMBUS_RegisterCallback() before calling @ref HAL_SMBUS_DeInit()
143     or @ref HAL_SMBUS_Init() function.
144    [..]
145     When the compilation flag USE_HAL_SMBUS_REGISTER_CALLBACKS is set to 0 or
146     not defined, the callback registration feature is not available and all callbacks
147     are set to the corresponding weak functions.
148
149     [..]
150       (@) You can refer to the SMBUS HAL driver header file for more useful macros
151
152  @endverbatim
153  ******************************************************************************
154  * @attention
155  *
156  * <h2><center>&copy; Copyright (c) 2018 STMicroelectronics.
157  * All rights reserved.</center></h2>
158  *
159  * This software component is licensed by ST under BSD 3-Clause license,
160  * the "License"; You may not use this file except in compliance with the
161  * License. You may obtain a copy of the License at:
162  *                        opensource.org/licenses/BSD-3-Clause
163  *
164  ******************************************************************************
165  */
166
167/* Includes ------------------------------------------------------------------*/
168#include "stm32g0xx_hal.h"
169
170/** @addtogroup STM32G0xx_HAL_Driver
171  * @{
172  */
173
174/** @defgroup SMBUS SMBUS
175  * @brief SMBUS HAL module driver
176  * @{
177  */
178
179#ifdef HAL_SMBUS_MODULE_ENABLED
180
181/* Private typedef -----------------------------------------------------------*/
182/* Private constants ---------------------------------------------------------*/
183/** @defgroup SMBUS_Private_Define SMBUS Private Constants
184  * @{
185  */
186#define TIMING_CLEAR_MASK   (0xF0FFFFFFUL)     /*!< SMBUS TIMING clear register Mask */
187#define HAL_TIMEOUT_ADDR    (10000U)           /*!< 10 s  */
188#define HAL_TIMEOUT_BUSY    (25U)              /*!< 25 ms */
189#define HAL_TIMEOUT_DIR     (25U)              /*!< 25 ms */
190#define HAL_TIMEOUT_RXNE    (25U)              /*!< 25 ms */
191#define HAL_TIMEOUT_STOPF   (25U)              /*!< 25 ms */
192#define HAL_TIMEOUT_TC      (25U)              /*!< 25 ms */
193#define HAL_TIMEOUT_TCR     (25U)              /*!< 25 ms */
194#define HAL_TIMEOUT_TXIS    (25U)              /*!< 25 ms */
195#define MAX_NBYTE_SIZE      255U
196/**
197  * @}
198  */
199
200/* Private macro -------------------------------------------------------------*/
201/* Private variables ---------------------------------------------------------*/
202/* Private function prototypes -----------------------------------------------*/
203/** @addtogroup SMBUS_Private_Functions SMBUS Private Functions
204  * @{
205  */
206static HAL_StatusTypeDef SMBUS_WaitOnFlagUntilTimeout(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t Flag, FlagStatus Status, uint32_t Timeout);
207
208static void SMBUS_Enable_IRQ(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t InterruptRequest);
209static void SMBUS_Disable_IRQ(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t InterruptRequest);
210static HAL_StatusTypeDef SMBUS_Master_ISR(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t StatusFlags);
211static HAL_StatusTypeDef SMBUS_Slave_ISR(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t StatusFlags);
212
213static void SMBUS_ConvertOtherXferOptions(struct __SMBUS_HandleTypeDef *hsmbus);
214
215static void SMBUS_ITErrorHandler(struct __SMBUS_HandleTypeDef *hsmbus);
216
217static void SMBUS_TransferConfig(struct __SMBUS_HandleTypeDef *hsmbus,  uint16_t DevAddress, uint8_t Size, uint32_t Mode, uint32_t Request);
218/**
219  * @}
220  */
221
222/* Exported functions --------------------------------------------------------*/
223
224/** @defgroup SMBUS_Exported_Functions SMBUS Exported Functions
225  * @{
226  */
227
228/** @defgroup SMBUS_Exported_Functions_Group1 Initialization and de-initialization functions
229 *  @brief    Initialization and Configuration functions
230 *
231@verbatim
232 ===============================================================================
233              ##### Initialization and de-initialization functions #####
234 ===============================================================================
235    [..]  This subsection provides a set of functions allowing to initialize and
236          deinitialize the SMBUSx peripheral:
237
238      (+) User must Implement HAL_SMBUS_MspInit() function in which he configures
239          all related peripherals resources (CLOCK, GPIO, IT and NVIC ).
240
241      (+) Call the function HAL_SMBUS_Init() to configure the selected device with
242          the selected configuration:
243        (++) Clock Timing
244        (++) Bus Timeout
245        (++) Analog Filer mode
246        (++) Own Address 1
247        (++) Addressing mode (Master, Slave)
248        (++) Dual Addressing mode
249        (++) Own Address 2
250        (++) Own Address 2 Mask
251        (++) General call mode
252        (++) Nostretch mode
253        (++) Packet Error Check mode
254        (++) Peripheral mode
255
256
257      (+) Call the function HAL_SMBUS_DeInit() to restore the default configuration
258          of the selected SMBUSx peripheral.
259
260      (+) Enable/Disable Analog/Digital filters with HAL_SMBUS_ConfigAnalogFilter() and
261          HAL_SMBUS_ConfigDigitalFilter().
262
263@endverbatim
264  * @{
265  */
266
267/**
268  * @brief  Initialize the SMBUS according to the specified parameters
269  *         in the SMBUS_InitTypeDef and initialize the associated handle.
270  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
271  *                the configuration information for the specified SMBUS.
272  * @retval HAL status
273  */
274HAL_StatusTypeDef HAL_SMBUS_Init(SMBUS_HandleTypeDef *hsmbus)
275{
276  /* Check the SMBUS handle allocation */
277  if (hsmbus == NULL)
278  {
279    return HAL_ERROR;
280  }
281
282  /* Check the parameters */
283  assert_param(IS_SMBUS_ALL_INSTANCE(hsmbus->Instance));
284  assert_param(IS_SMBUS_ANALOG_FILTER(hsmbus->Init.AnalogFilter));
285  assert_param(IS_SMBUS_OWN_ADDRESS1(hsmbus->Init.OwnAddress1));
286  assert_param(IS_SMBUS_ADDRESSING_MODE(hsmbus->Init.AddressingMode));
287  assert_param(IS_SMBUS_DUAL_ADDRESS(hsmbus->Init.DualAddressMode));
288  assert_param(IS_SMBUS_OWN_ADDRESS2(hsmbus->Init.OwnAddress2));
289  assert_param(IS_SMBUS_OWN_ADDRESS2_MASK(hsmbus->Init.OwnAddress2Masks));
290  assert_param(IS_SMBUS_GENERAL_CALL(hsmbus->Init.GeneralCallMode));
291  assert_param(IS_SMBUS_NO_STRETCH(hsmbus->Init.NoStretchMode));
292  assert_param(IS_SMBUS_PEC(hsmbus->Init.PacketErrorCheckMode));
293  assert_param(IS_SMBUS_PERIPHERAL_MODE(hsmbus->Init.PeripheralMode));
294
295  if (hsmbus->State == HAL_SMBUS_STATE_RESET)
296  {
297    /* Allocate lock resource and initialize it */
298    hsmbus->Lock = HAL_UNLOCKED;
299
300#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
301    hsmbus->MasterTxCpltCallback = HAL_SMBUS_MasterTxCpltCallback; /* Legacy weak MasterTxCpltCallback */
302    hsmbus->MasterRxCpltCallback = HAL_SMBUS_MasterRxCpltCallback; /* Legacy weak MasterRxCpltCallback */
303    hsmbus->SlaveTxCpltCallback  = HAL_SMBUS_SlaveTxCpltCallback;  /* Legacy weak SlaveTxCpltCallback  */
304    hsmbus->SlaveRxCpltCallback  = HAL_SMBUS_SlaveRxCpltCallback;  /* Legacy weak SlaveRxCpltCallback  */
305    hsmbus->ListenCpltCallback   = HAL_SMBUS_ListenCpltCallback;   /* Legacy weak ListenCpltCallback   */
306    hsmbus->ErrorCallback        = HAL_SMBUS_ErrorCallback;        /* Legacy weak ErrorCallback        */
307    hsmbus->AddrCallback         = HAL_SMBUS_AddrCallback;         /* Legacy weak AddrCallback         */
308
309    if (hsmbus->MspInitCallback == NULL)
310    {
311      hsmbus->MspInitCallback = HAL_SMBUS_MspInit; /* Legacy weak MspInit  */
312    }
313
314    /* Init the low level hardware : GPIO, CLOCK, CORTEX...etc */
315    hsmbus->MspInitCallback(hsmbus);
316#else
317    /* Init the low level hardware : GPIO, CLOCK, NVIC */
318    HAL_SMBUS_MspInit(hsmbus);
319#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
320  }
321
322  hsmbus->State = HAL_SMBUS_STATE_BUSY;
323
324  /* Disable the selected SMBUS peripheral */
325  __HAL_SMBUS_DISABLE(hsmbus);
326
327  /*---------------------------- SMBUSx TIMINGR Configuration ------------------------*/
328  /* Configure SMBUSx: Frequency range */
329  hsmbus->Instance->TIMINGR = hsmbus->Init.Timing & TIMING_CLEAR_MASK;
330
331  /*---------------------------- SMBUSx TIMEOUTR Configuration ------------------------*/
332  /* Configure SMBUSx: Bus Timeout  */
333  hsmbus->Instance->TIMEOUTR &= ~I2C_TIMEOUTR_TIMOUTEN;
334  hsmbus->Instance->TIMEOUTR &= ~I2C_TIMEOUTR_TEXTEN;
335  hsmbus->Instance->TIMEOUTR = hsmbus->Init.SMBusTimeout;
336
337  /*---------------------------- SMBUSx OAR1 Configuration -----------------------*/
338  /* Configure SMBUSx: Own Address1 and ack own address1 mode */
339  hsmbus->Instance->OAR1 &= ~I2C_OAR1_OA1EN;
340
341  if (hsmbus->Init.OwnAddress1 != 0UL)
342  {
343    if (hsmbus->Init.AddressingMode == SMBUS_ADDRESSINGMODE_7BIT)
344    {
345      hsmbus->Instance->OAR1 = (I2C_OAR1_OA1EN | hsmbus->Init.OwnAddress1);
346    }
347    else /* SMBUS_ADDRESSINGMODE_10BIT */
348    {
349      hsmbus->Instance->OAR1 = (I2C_OAR1_OA1EN | I2C_OAR1_OA1MODE | hsmbus->Init.OwnAddress1);
350    }
351  }
352
353  /*---------------------------- SMBUSx CR2 Configuration ------------------------*/
354  /* Configure SMBUSx: Addressing Master mode */
355  if (hsmbus->Init.AddressingMode == SMBUS_ADDRESSINGMODE_10BIT)
356  {
357    hsmbus->Instance->CR2 = (I2C_CR2_ADD10);
358  }
359  /* Enable the AUTOEND by default, and enable NACK (should be disable only during Slave process) */
360  /* AUTOEND and NACK bit will be manage during Transfer process */
361  hsmbus->Instance->CR2 |= (I2C_CR2_AUTOEND | I2C_CR2_NACK);
362
363  /*---------------------------- SMBUSx OAR2 Configuration -----------------------*/
364  /* Configure SMBUSx: Dual mode and Own Address2 */
365  hsmbus->Instance->OAR2 = (hsmbus->Init.DualAddressMode | hsmbus->Init.OwnAddress2 | (hsmbus->Init.OwnAddress2Masks << 8U));
366
367  /*---------------------------- SMBUSx CR1 Configuration ------------------------*/
368  /* Configure SMBUSx: Generalcall and NoStretch mode */
369  hsmbus->Instance->CR1 = (hsmbus->Init.GeneralCallMode | hsmbus->Init.NoStretchMode | hsmbus->Init.PacketErrorCheckMode | hsmbus->Init.PeripheralMode | hsmbus->Init.AnalogFilter);
370
371  /* Enable Slave Byte Control only in case of Packet Error Check is enabled and SMBUS Peripheral is set in Slave mode */
372  if ((hsmbus->Init.PacketErrorCheckMode == SMBUS_PEC_ENABLE)
373      && ((hsmbus->Init.PeripheralMode == SMBUS_PERIPHERAL_MODE_SMBUS_SLAVE) || (hsmbus->Init.PeripheralMode == SMBUS_PERIPHERAL_MODE_SMBUS_SLAVE_ARP)))
374  {
375    hsmbus->Instance->CR1 |= I2C_CR1_SBC;
376  }
377
378  /* Enable the selected SMBUS peripheral */
379  __HAL_SMBUS_ENABLE(hsmbus);
380
381  hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
382  hsmbus->PreviousState = HAL_SMBUS_STATE_READY;
383  hsmbus->State = HAL_SMBUS_STATE_READY;
384
385  return HAL_OK;
386}
387
388/**
389  * @brief  DeInitialize the SMBUS peripheral.
390  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
391  *                the configuration information for the specified SMBUS.
392  * @retval HAL status
393  */
394HAL_StatusTypeDef HAL_SMBUS_DeInit(SMBUS_HandleTypeDef *hsmbus)
395{
396  /* Check the SMBUS handle allocation */
397  if (hsmbus == NULL)
398  {
399    return HAL_ERROR;
400  }
401
402  /* Check the parameters */
403  assert_param(IS_SMBUS_ALL_INSTANCE(hsmbus->Instance));
404
405  hsmbus->State = HAL_SMBUS_STATE_BUSY;
406
407  /* Disable the SMBUS Peripheral Clock */
408  __HAL_SMBUS_DISABLE(hsmbus);
409
410#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
411  if (hsmbus->MspDeInitCallback == NULL)
412  {
413    hsmbus->MspDeInitCallback = HAL_SMBUS_MspDeInit; /* Legacy weak MspDeInit  */
414  }
415
416  /* DeInit the low level hardware: GPIO, CLOCK, NVIC */
417  hsmbus->MspDeInitCallback(hsmbus);
418#else
419  /* DeInit the low level hardware: GPIO, CLOCK, NVIC */
420  HAL_SMBUS_MspDeInit(hsmbus);
421#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
422
423  hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
424  hsmbus->PreviousState =  HAL_SMBUS_STATE_RESET;
425  hsmbus->State = HAL_SMBUS_STATE_RESET;
426
427  /* Release Lock */
428  __HAL_UNLOCK(hsmbus);
429
430  return HAL_OK;
431}
432
433/**
434  * @brief Initialize the SMBUS MSP.
435  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
436  *                the configuration information for the specified SMBUS.
437  * @retval None
438  */
439__weak void HAL_SMBUS_MspInit(SMBUS_HandleTypeDef *hsmbus)
440{
441  /* Prevent unused argument(s) compilation warning */
442  UNUSED(hsmbus);
443
444  /* NOTE : This function should not be modified, when the callback is needed,
445            the HAL_SMBUS_MspInit could be implemented in the user file
446   */
447}
448
449/**
450  * @brief DeInitialize the SMBUS MSP.
451  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
452  *                the configuration information for the specified SMBUS.
453  * @retval None
454  */
455__weak void HAL_SMBUS_MspDeInit(SMBUS_HandleTypeDef *hsmbus)
456{
457  /* Prevent unused argument(s) compilation warning */
458  UNUSED(hsmbus);
459
460  /* NOTE : This function should not be modified, when the callback is needed,
461            the HAL_SMBUS_MspDeInit could be implemented in the user file
462   */
463}
464
465/**
466  * @brief  Configure Analog noise filter.
467  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
468  *                the configuration information for the specified SMBUS.
469  * @param  AnalogFilter This parameter can be one of the following values:
470  *         @arg @ref SMBUS_ANALOGFILTER_ENABLE
471  *         @arg @ref SMBUS_ANALOGFILTER_DISABLE
472  * @retval HAL status
473  */
474HAL_StatusTypeDef HAL_SMBUS_ConfigAnalogFilter(SMBUS_HandleTypeDef *hsmbus, uint32_t AnalogFilter)
475{
476  /* Check the parameters */
477  assert_param(IS_SMBUS_ALL_INSTANCE(hsmbus->Instance));
478  assert_param(IS_SMBUS_ANALOG_FILTER(AnalogFilter));
479
480  if (hsmbus->State == HAL_SMBUS_STATE_READY)
481  {
482    /* Process Locked */
483    __HAL_LOCK(hsmbus);
484
485    hsmbus->State = HAL_SMBUS_STATE_BUSY;
486
487    /* Disable the selected SMBUS peripheral */
488    __HAL_SMBUS_DISABLE(hsmbus);
489
490    /* Reset ANOFF bit */
491    hsmbus->Instance->CR1 &= ~(I2C_CR1_ANFOFF);
492
493    /* Set analog filter bit*/
494    hsmbus->Instance->CR1 |= AnalogFilter;
495
496    __HAL_SMBUS_ENABLE(hsmbus);
497
498    hsmbus->State = HAL_SMBUS_STATE_READY;
499
500    /* Process Unlocked */
501    __HAL_UNLOCK(hsmbus);
502
503    return HAL_OK;
504  }
505  else
506  {
507    return HAL_BUSY;
508  }
509}
510
511/**
512  * @brief  Configure Digital noise filter.
513  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
514  *                the configuration information for the specified SMBUS.
515  * @param  DigitalFilter Coefficient of digital noise filter between Min_Data=0x00 and Max_Data=0x0F.
516  * @retval HAL status
517  */
518HAL_StatusTypeDef HAL_SMBUS_ConfigDigitalFilter(SMBUS_HandleTypeDef *hsmbus, uint32_t DigitalFilter)
519{
520  uint32_t tmpreg;
521
522  /* Check the parameters */
523  assert_param(IS_SMBUS_ALL_INSTANCE(hsmbus->Instance));
524  assert_param(IS_SMBUS_DIGITAL_FILTER(DigitalFilter));
525
526  if (hsmbus->State == HAL_SMBUS_STATE_READY)
527  {
528    /* Process Locked */
529    __HAL_LOCK(hsmbus);
530
531    hsmbus->State = HAL_SMBUS_STATE_BUSY;
532
533    /* Disable the selected SMBUS peripheral */
534    __HAL_SMBUS_DISABLE(hsmbus);
535
536    /* Get the old register value */
537    tmpreg = hsmbus->Instance->CR1;
538
539    /* Reset I2C DNF bits [11:8] */
540    tmpreg &= ~(I2C_CR1_DNF);
541
542    /* Set I2Cx DNF coefficient */
543    tmpreg |= DigitalFilter << I2C_CR1_DNF_Pos;
544
545    /* Store the new register value */
546    hsmbus->Instance->CR1 = tmpreg;
547
548    __HAL_SMBUS_ENABLE(hsmbus);
549
550    hsmbus->State = HAL_SMBUS_STATE_READY;
551
552    /* Process Unlocked */
553    __HAL_UNLOCK(hsmbus);
554
555    return HAL_OK;
556  }
557  else
558  {
559    return HAL_BUSY;
560  }
561}
562
563#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
564/**
565  * @brief  Register a User SMBUS Callback
566  *         To be used instead of the weak predefined callback
567  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
568  *                the configuration information for the specified SMBUS.
569  * @param  CallbackID ID of the callback to be registered
570  *         This parameter can be one of the following values:
571  *          @arg @ref HAL_SMBUS_MASTER_TX_COMPLETE_CB_ID Master Tx Transfer completed callback ID
572  *          @arg @ref HAL_SMBUS_MASTER_RX_COMPLETE_CB_ID Master Rx Transfer completed callback ID
573  *          @arg @ref HAL_SMBUS_SLAVE_TX_COMPLETE_CB_ID Slave Tx Transfer completed callback ID
574  *          @arg @ref HAL_SMBUS_SLAVE_RX_COMPLETE_CB_ID Slave Rx Transfer completed callback ID
575  *          @arg @ref HAL_SMBUS_LISTEN_COMPLETE_CB_ID Listen Complete callback ID
576  *          @arg @ref HAL_SMBUS_ERROR_CB_ID Error callback ID
577  *          @arg @ref HAL_SMBUS_MSPINIT_CB_ID MspInit callback ID
578  *          @arg @ref HAL_SMBUS_MSPDEINIT_CB_ID MspDeInit callback ID
579  * @param  pCallback pointer to the Callback function
580  * @retval HAL status
581  */
582HAL_StatusTypeDef HAL_SMBUS_RegisterCallback(SMBUS_HandleTypeDef *hsmbus, HAL_SMBUS_CallbackIDTypeDef CallbackID, pSMBUS_CallbackTypeDef pCallback)
583{
584  HAL_StatusTypeDef status = HAL_OK;
585
586  if (pCallback == NULL)
587  {
588    /* Update the error code */
589    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
590
591    return HAL_ERROR;
592  }
593
594  /* Process locked */
595  __HAL_LOCK(hsmbus);
596
597  if (HAL_SMBUS_STATE_READY == hsmbus->State)
598  {
599    switch (CallbackID)
600    {
601      case HAL_SMBUS_MASTER_TX_COMPLETE_CB_ID :
602        hsmbus->MasterTxCpltCallback = pCallback;
603        break;
604
605      case HAL_SMBUS_MASTER_RX_COMPLETE_CB_ID :
606        hsmbus->MasterRxCpltCallback = pCallback;
607        break;
608
609      case HAL_SMBUS_SLAVE_TX_COMPLETE_CB_ID :
610        hsmbus->SlaveTxCpltCallback = pCallback;
611        break;
612
613      case HAL_SMBUS_SLAVE_RX_COMPLETE_CB_ID :
614        hsmbus->SlaveRxCpltCallback = pCallback;
615        break;
616
617      case HAL_SMBUS_LISTEN_COMPLETE_CB_ID :
618        hsmbus->ListenCpltCallback = pCallback;
619        break;
620
621      case HAL_SMBUS_ERROR_CB_ID :
622        hsmbus->ErrorCallback = pCallback;
623        break;
624
625      case HAL_SMBUS_MSPINIT_CB_ID :
626        hsmbus->MspInitCallback = pCallback;
627        break;
628
629      case HAL_SMBUS_MSPDEINIT_CB_ID :
630        hsmbus->MspDeInitCallback = pCallback;
631        break;
632
633      default :
634        /* Update the error code */
635        hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
636
637        /* Return error status */
638        status =  HAL_ERROR;
639        break;
640    }
641  }
642  else if (HAL_SMBUS_STATE_RESET == hsmbus->State)
643  {
644    switch (CallbackID)
645    {
646      case HAL_SMBUS_MSPINIT_CB_ID :
647        hsmbus->MspInitCallback = pCallback;
648        break;
649
650      case HAL_SMBUS_MSPDEINIT_CB_ID :
651        hsmbus->MspDeInitCallback = pCallback;
652        break;
653
654      default :
655        /* Update the error code */
656        hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
657
658        /* Return error status */
659        status =  HAL_ERROR;
660        break;
661    }
662  }
663  else
664  {
665    /* Update the error code */
666    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
667
668    /* Return error status */
669    status =  HAL_ERROR;
670  }
671
672  /* Release Lock */
673  __HAL_UNLOCK(hsmbus);
674  return status;
675}
676
677/**
678  * @brief  Unregister an SMBUS Callback
679  *         SMBUS callback is redirected to the weak predefined callback
680  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
681  *                the configuration information for the specified SMBUS.
682  * @param  CallbackID ID of the callback to be unregistered
683  *         This parameter can be one of the following values:
684  *         This parameter can be one of the following values:
685  *          @arg @ref HAL_SMBUS_MASTER_TX_COMPLETE_CB_ID Master Tx Transfer completed callback ID
686  *          @arg @ref HAL_SMBUS_MASTER_RX_COMPLETE_CB_ID Master Rx Transfer completed callback ID
687  *          @arg @ref HAL_SMBUS_SLAVE_TX_COMPLETE_CB_ID Slave Tx Transfer completed callback ID
688  *          @arg @ref HAL_SMBUS_SLAVE_RX_COMPLETE_CB_ID Slave Rx Transfer completed callback ID
689  *          @arg @ref HAL_SMBUS_LISTEN_COMPLETE_CB_ID Listen Complete callback ID
690  *          @arg @ref HAL_SMBUS_ERROR_CB_ID Error callback ID
691  *          @arg @ref HAL_SMBUS_MSPINIT_CB_ID MspInit callback ID
692  *          @arg @ref HAL_SMBUS_MSPDEINIT_CB_ID MspDeInit callback ID
693  * @retval HAL status
694  */
695HAL_StatusTypeDef HAL_SMBUS_UnRegisterCallback(SMBUS_HandleTypeDef *hsmbus, HAL_SMBUS_CallbackIDTypeDef CallbackID)
696{
697  HAL_StatusTypeDef status = HAL_OK;
698
699  /* Process locked */
700  __HAL_LOCK(hsmbus);
701
702  if (HAL_SMBUS_STATE_READY == hsmbus->State)
703  {
704    switch (CallbackID)
705    {
706      case HAL_SMBUS_MASTER_TX_COMPLETE_CB_ID :
707        hsmbus->MasterTxCpltCallback = HAL_SMBUS_MasterTxCpltCallback; /* Legacy weak MasterTxCpltCallback */
708        break;
709
710      case HAL_SMBUS_MASTER_RX_COMPLETE_CB_ID :
711        hsmbus->MasterRxCpltCallback = HAL_SMBUS_MasterRxCpltCallback; /* Legacy weak MasterRxCpltCallback */
712        break;
713
714      case HAL_SMBUS_SLAVE_TX_COMPLETE_CB_ID :
715        hsmbus->SlaveTxCpltCallback = HAL_SMBUS_SlaveTxCpltCallback;   /* Legacy weak SlaveTxCpltCallback  */
716        break;
717
718      case HAL_SMBUS_SLAVE_RX_COMPLETE_CB_ID :
719        hsmbus->SlaveRxCpltCallback = HAL_SMBUS_SlaveRxCpltCallback;   /* Legacy weak SlaveRxCpltCallback  */
720        break;
721
722      case HAL_SMBUS_LISTEN_COMPLETE_CB_ID :
723        hsmbus->ListenCpltCallback = HAL_SMBUS_ListenCpltCallback;     /* Legacy weak ListenCpltCallback   */
724        break;
725
726      case HAL_SMBUS_ERROR_CB_ID :
727        hsmbus->ErrorCallback = HAL_SMBUS_ErrorCallback;               /* Legacy weak ErrorCallback        */
728        break;
729
730      case HAL_SMBUS_MSPINIT_CB_ID :
731        hsmbus->MspInitCallback = HAL_SMBUS_MspInit;                   /* Legacy weak MspInit              */
732        break;
733
734      case HAL_SMBUS_MSPDEINIT_CB_ID :
735        hsmbus->MspDeInitCallback = HAL_SMBUS_MspDeInit;               /* Legacy weak MspDeInit            */
736        break;
737
738      default :
739        /* Update the error code */
740        hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
741
742        /* Return error status */
743        status =  HAL_ERROR;
744        break;
745    }
746  }
747  else if (HAL_SMBUS_STATE_RESET == hsmbus->State)
748  {
749    switch (CallbackID)
750    {
751      case HAL_SMBUS_MSPINIT_CB_ID :
752        hsmbus->MspInitCallback = HAL_SMBUS_MspInit;                   /* Legacy weak MspInit              */
753        break;
754
755      case HAL_SMBUS_MSPDEINIT_CB_ID :
756        hsmbus->MspDeInitCallback = HAL_SMBUS_MspDeInit;               /* Legacy weak MspDeInit            */
757        break;
758
759      default :
760        /* Update the error code */
761        hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
762
763        /* Return error status */
764        status =  HAL_ERROR;
765        break;
766    }
767  }
768  else
769  {
770    /* Update the error code */
771    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
772
773    /* Return error status */
774    status =  HAL_ERROR;
775  }
776
777  /* Release Lock */
778  __HAL_UNLOCK(hsmbus);
779  return status;
780}
781
782/**
783  * @brief  Register the Slave Address Match SMBUS Callback
784  *         To be used instead of the weak HAL_SMBUS_AddrCallback() predefined callback
785  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
786  *                the configuration information for the specified SMBUS.
787  * @param  pCallback pointer to the Address Match Callback function
788  * @retval HAL status
789  */
790HAL_StatusTypeDef HAL_SMBUS_RegisterAddrCallback(SMBUS_HandleTypeDef *hsmbus, pSMBUS_AddrCallbackTypeDef pCallback)
791{
792  HAL_StatusTypeDef status = HAL_OK;
793
794  if (pCallback == NULL)
795  {
796    /* Update the error code */
797    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
798
799    return HAL_ERROR;
800  }
801  /* Process locked */
802  __HAL_LOCK(hsmbus);
803
804  if (HAL_SMBUS_STATE_READY == hsmbus->State)
805  {
806    hsmbus->AddrCallback = pCallback;
807  }
808  else
809  {
810    /* Update the error code */
811    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
812
813    /* Return error status */
814    status =  HAL_ERROR;
815  }
816
817  /* Release Lock */
818  __HAL_UNLOCK(hsmbus);
819  return status;
820}
821
822/**
823  * @brief  UnRegister the Slave Address Match SMBUS Callback
824  *         Info Ready SMBUS Callback is redirected to the weak HAL_SMBUS_AddrCallback() predefined callback
825  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
826  *                the configuration information for the specified SMBUS.
827  * @retval HAL status
828  */
829HAL_StatusTypeDef HAL_SMBUS_UnRegisterAddrCallback(SMBUS_HandleTypeDef *hsmbus)
830{
831  HAL_StatusTypeDef status = HAL_OK;
832
833  /* Process locked */
834  __HAL_LOCK(hsmbus);
835
836  if (HAL_SMBUS_STATE_READY == hsmbus->State)
837  {
838    hsmbus->AddrCallback = HAL_SMBUS_AddrCallback; /* Legacy weak AddrCallback  */
839  }
840  else
841  {
842    /* Update the error code */
843    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_INVALID_CALLBACK;
844
845    /* Return error status */
846    status =  HAL_ERROR;
847  }
848
849  /* Release Lock */
850  __HAL_UNLOCK(hsmbus);
851  return status;
852}
853
854#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
855
856/**
857  * @}
858  */
859
860/** @defgroup SMBUS_Exported_Functions_Group2 Input and Output operation functions
861 *  @brief   Data transfers functions
862 *
863@verbatim
864 ===============================================================================
865                      ##### IO operation functions #####
866 ===============================================================================
867    [..]
868    This subsection provides a set of functions allowing to manage the SMBUS data
869    transfers.
870
871    (#) Blocking mode function to check if device is ready for usage is :
872        (++) HAL_SMBUS_IsDeviceReady()
873
874    (#) There is only one mode of transfer:
875       (++) Non-Blocking mode : The communication is performed using Interrupts.
876            These functions return the status of the transfer startup.
877            The end of the data processing will be indicated through the
878            dedicated SMBUS IRQ when using Interrupt mode.
879
880    (#) Non-Blocking mode functions with Interrupt are :
881        (++) HAL_SMBUS_Master_Transmit_IT()
882        (++) HAL_SMBUS_Master_Receive_IT()
883        (++) HAL_SMBUS_Slave_Transmit_IT()
884        (++) HAL_SMBUS_Slave_Receive_IT()
885        (++) HAL_SMBUS_EnableListen_IT() or alias HAL_SMBUS_EnableListen_IT()
886        (++) HAL_SMBUS_DisableListen_IT()
887        (++) HAL_SMBUS_EnableAlert_IT()
888        (++) HAL_SMBUS_DisableAlert_IT()
889
890    (#) A set of Transfer Complete Callbacks are provided in non-Blocking mode:
891        (++) HAL_SMBUS_MasterTxCpltCallback()
892        (++) HAL_SMBUS_MasterRxCpltCallback()
893        (++) HAL_SMBUS_SlaveTxCpltCallback()
894        (++) HAL_SMBUS_SlaveRxCpltCallback()
895        (++) HAL_SMBUS_AddrCallback()
896        (++) HAL_SMBUS_ListenCpltCallback()
897        (++) HAL_SMBUS_ErrorCallback()
898
899@endverbatim
900  * @{
901  */
902
903/**
904  * @brief  Transmit in master/host SMBUS mode an amount of data in non-blocking mode with Interrupt.
905  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
906  *                the configuration information for the specified SMBUS.
907  * @param  DevAddress Target device address: The device 7 bits address value
908  *         in datasheet must be shifted to the left before calling the interface
909  * @param  pData Pointer to data buffer
910  * @param  Size Amount of data to be sent
911  * @param  XferOptions Options of Transfer, value of @ref SMBUS_XferOptions_definition
912  * @retval HAL status
913  */
914HAL_StatusTypeDef HAL_SMBUS_Master_Transmit_IT(SMBUS_HandleTypeDef *hsmbus, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
915{
916  uint32_t tmp;
917
918  /* Check the parameters */
919  assert_param(IS_SMBUS_TRANSFER_OPTIONS_REQUEST(XferOptions));
920
921  if (hsmbus->State == HAL_SMBUS_STATE_READY)
922  {
923    /* Process Locked */
924    __HAL_LOCK(hsmbus);
925
926    hsmbus->State = HAL_SMBUS_STATE_MASTER_BUSY_TX;
927    hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
928    /* Prepare transfer parameters */
929    hsmbus->pBuffPtr = pData;
930    hsmbus->XferCount = Size;
931    hsmbus->XferOptions = XferOptions;
932
933    /* In case of Quick command, remove autoend mode */
934    /* Manage the stop generation by software */
935    if (hsmbus->pBuffPtr == NULL)
936    {
937      hsmbus->XferOptions &= ~SMBUS_AUTOEND_MODE;
938    }
939
940    if (Size > MAX_NBYTE_SIZE)
941    {
942      hsmbus->XferSize = MAX_NBYTE_SIZE;
943    }
944    else
945    {
946      hsmbus->XferSize = Size;
947    }
948
949    /* Send Slave Address */
950    /* Set NBYTES to write and reload if size > MAX_NBYTE_SIZE and generate RESTART */
951    if ((hsmbus->XferSize < hsmbus->XferCount) && (hsmbus->XferSize == MAX_NBYTE_SIZE))
952    {
953      SMBUS_TransferConfig(hsmbus, DevAddress, (uint8_t)hsmbus->XferSize, SMBUS_RELOAD_MODE | (hsmbus->XferOptions & SMBUS_SENDPEC_MODE), SMBUS_GENERATE_START_WRITE);
954    }
955    else
956    {
957      /* If transfer direction not change, do not generate Restart Condition */
958      /* Mean Previous state is same as current state */
959
960      /* Store current volatile XferOptions, misra rule */
961      tmp = hsmbus->XferOptions;
962
963      if ((hsmbus->PreviousState == HAL_SMBUS_STATE_MASTER_BUSY_TX) && (IS_SMBUS_TRANSFER_OTHER_OPTIONS_REQUEST(tmp) == 0))
964      {
965        SMBUS_TransferConfig(hsmbus, DevAddress, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_NO_STARTSTOP);
966      }
967      /* Else transfer direction change, so generate Restart with new transfer direction */
968      else
969      {
970        /* Convert OTHER_xxx XferOptions if any */
971        SMBUS_ConvertOtherXferOptions(hsmbus);
972
973        /* Handle Transfer */
974        SMBUS_TransferConfig(hsmbus, DevAddress, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_GENERATE_START_WRITE);
975      }
976
977      /* If PEC mode is enable, size to transmit manage by SW part should be Size-1 byte, corresponding to PEC byte */
978      /* PEC byte is automatically sent by HW block, no need to manage it in Transmit process */
979      if (SMBUS_GET_PEC_MODE(hsmbus) != 0UL)
980      {
981        hsmbus->XferSize--;
982        hsmbus->XferCount--;
983      }
984    }
985
986    /* Process Unlocked */
987    __HAL_UNLOCK(hsmbus);
988
989    /* Note : The SMBUS interrupts must be enabled after unlocking current process
990              to avoid the risk of SMBUS interrupt handle execution before current
991              process unlock */
992    SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_TX);
993
994    return HAL_OK;
995  }
996  else
997  {
998    return HAL_BUSY;
999  }
1000}
1001
1002/**
1003  * @brief  Receive in master/host SMBUS mode an amount of data in non-blocking mode with Interrupt.
1004  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1005  *                the configuration information for the specified SMBUS.
1006  * @param  DevAddress Target device address: The device 7 bits address value
1007  *         in datasheet must be shifted to the left before calling the interface
1008  * @param  pData Pointer to data buffer
1009  * @param  Size Amount of data to be sent
1010  * @param  XferOptions Options of Transfer, value of @ref SMBUS_XferOptions_definition
1011  * @retval HAL status
1012  */
1013HAL_StatusTypeDef HAL_SMBUS_Master_Receive_IT(SMBUS_HandleTypeDef *hsmbus, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
1014{
1015  uint32_t tmp;
1016
1017  /* Check the parameters */
1018  assert_param(IS_SMBUS_TRANSFER_OPTIONS_REQUEST(XferOptions));
1019
1020  if (hsmbus->State == HAL_SMBUS_STATE_READY)
1021  {
1022    /* Process Locked */
1023    __HAL_LOCK(hsmbus);
1024
1025    hsmbus->State = HAL_SMBUS_STATE_MASTER_BUSY_RX;
1026    hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
1027
1028    /* Prepare transfer parameters */
1029    hsmbus->pBuffPtr = pData;
1030    hsmbus->XferCount = Size;
1031    hsmbus->XferOptions = XferOptions;
1032
1033    /* In case of Quick command, remove autoend mode */
1034    /* Manage the stop generation by software */
1035    if (hsmbus->pBuffPtr == NULL)
1036    {
1037      hsmbus->XferOptions &= ~SMBUS_AUTOEND_MODE;
1038    }
1039
1040    if (Size > MAX_NBYTE_SIZE)
1041    {
1042      hsmbus->XferSize = MAX_NBYTE_SIZE;
1043    }
1044    else
1045    {
1046      hsmbus->XferSize = Size;
1047    }
1048
1049    /* Send Slave Address */
1050    /* Set NBYTES to write and reload if size > MAX_NBYTE_SIZE and generate RESTART */
1051    if ((hsmbus->XferSize < hsmbus->XferCount) && (hsmbus->XferSize == MAX_NBYTE_SIZE))
1052    {
1053      SMBUS_TransferConfig(hsmbus, DevAddress, (uint8_t)hsmbus->XferSize, SMBUS_RELOAD_MODE  | (hsmbus->XferOptions & SMBUS_SENDPEC_MODE), SMBUS_GENERATE_START_READ);
1054    }
1055    else
1056    {
1057      /* If transfer direction not change, do not generate Restart Condition */
1058      /* Mean Previous state is same as current state */
1059
1060      /* Store current volatile XferOptions, Misra rule */
1061      tmp = hsmbus->XferOptions;
1062
1063      if ((hsmbus->PreviousState == HAL_SMBUS_STATE_MASTER_BUSY_RX) && (IS_SMBUS_TRANSFER_OTHER_OPTIONS_REQUEST(tmp) == 0))
1064      {
1065        SMBUS_TransferConfig(hsmbus, DevAddress, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_NO_STARTSTOP);
1066      }
1067      /* Else transfer direction change, so generate Restart with new transfer direction */
1068      else
1069      {
1070        /* Convert OTHER_xxx XferOptions if any */
1071        SMBUS_ConvertOtherXferOptions(hsmbus);
1072
1073        /* Handle Transfer */
1074        SMBUS_TransferConfig(hsmbus, DevAddress, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_GENERATE_START_READ);
1075      }
1076    }
1077
1078    /* Process Unlocked */
1079    __HAL_UNLOCK(hsmbus);
1080
1081    /* Note : The SMBUS interrupts must be enabled after unlocking current process
1082              to avoid the risk of SMBUS interrupt handle execution before current
1083              process unlock */
1084    SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_RX);
1085
1086    return HAL_OK;
1087  }
1088  else
1089  {
1090    return HAL_BUSY;
1091  }
1092}
1093
1094/**
1095  * @brief  Abort a master/host SMBUS process communication with Interrupt.
1096  * @note   This abort can be called only if state is ready
1097  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1098  *                the configuration information for the specified SMBUS.
1099  * @param  DevAddress Target device address: The device 7 bits address value
1100  *         in datasheet must be shifted to the left before calling the interface
1101  * @retval HAL status
1102  */
1103HAL_StatusTypeDef HAL_SMBUS_Master_Abort_IT(SMBUS_HandleTypeDef *hsmbus, uint16_t DevAddress)
1104{
1105  if (hsmbus->State == HAL_SMBUS_STATE_READY)
1106  {
1107    /* Process Locked */
1108    __HAL_LOCK(hsmbus);
1109
1110    /* Keep the same state as previous */
1111    /* to perform as well the call of the corresponding end of transfer callback */
1112    if (hsmbus->PreviousState == HAL_SMBUS_STATE_MASTER_BUSY_TX)
1113    {
1114      hsmbus->State = HAL_SMBUS_STATE_MASTER_BUSY_TX;
1115    }
1116    else if (hsmbus->PreviousState == HAL_SMBUS_STATE_MASTER_BUSY_RX)
1117    {
1118      hsmbus->State = HAL_SMBUS_STATE_MASTER_BUSY_RX;
1119    }
1120    else
1121    {
1122      /* Wrong usage of abort function */
1123      /* This function should be used only in case of abort monitored by master device */
1124      return HAL_ERROR;
1125    }
1126    hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
1127
1128    /* Set NBYTES to 1 to generate a dummy read on SMBUS peripheral */
1129    /* Set AUTOEND mode, this will generate a NACK then STOP condition to abort the current transfer */
1130    SMBUS_TransferConfig(hsmbus, DevAddress, 1, SMBUS_AUTOEND_MODE, SMBUS_NO_STARTSTOP);
1131
1132    /* Process Unlocked */
1133    __HAL_UNLOCK(hsmbus);
1134
1135    /* Note : The SMBUS interrupts must be enabled after unlocking current process
1136              to avoid the risk of SMBUS interrupt handle execution before current
1137              process unlock */
1138    if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_TX)
1139    {
1140      SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_TX);
1141    }
1142    else if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_RX)
1143    {
1144      SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_RX);
1145    }
1146    else
1147    {
1148      /* Nothing to do */
1149    }
1150
1151    return HAL_OK;
1152  }
1153  else
1154  {
1155    return HAL_BUSY;
1156  }
1157}
1158
1159/**
1160  * @brief  Transmit in slave/device SMBUS mode an amount of data in non-blocking mode with Interrupt.
1161  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1162  *                the configuration information for the specified SMBUS.
1163  * @param  pData Pointer to data buffer
1164  * @param  Size Amount of data to be sent
1165  * @param  XferOptions Options of Transfer, value of @ref SMBUS_XferOptions_definition
1166  * @retval HAL status
1167  */
1168HAL_StatusTypeDef HAL_SMBUS_Slave_Transmit_IT(SMBUS_HandleTypeDef *hsmbus, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
1169{
1170  /* Check the parameters */
1171  assert_param(IS_SMBUS_TRANSFER_OPTIONS_REQUEST(XferOptions));
1172
1173  if ((hsmbus->State & HAL_SMBUS_STATE_LISTEN) == HAL_SMBUS_STATE_LISTEN)
1174  {
1175    if ((pData == NULL) || (Size == 0UL))
1176    {
1177      hsmbus->ErrorCode = HAL_SMBUS_ERROR_INVALID_PARAM;
1178      return HAL_ERROR;
1179    }
1180
1181    /* Disable Interrupts, to prevent preemption during treatment in case of multicall */
1182    SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_ADDR | SMBUS_IT_TX);
1183
1184    /* Process Locked */
1185    __HAL_LOCK(hsmbus);
1186
1187    hsmbus->State = (HAL_SMBUS_STATE_SLAVE_BUSY_TX | HAL_SMBUS_STATE_LISTEN);
1188    hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
1189
1190    /* Set SBC bit to manage Acknowledge at each bit */
1191    hsmbus->Instance->CR1 |= I2C_CR1_SBC;
1192
1193    /* Enable Address Acknowledge */
1194    hsmbus->Instance->CR2 &= ~I2C_CR2_NACK;
1195
1196    /* Prepare transfer parameters */
1197    hsmbus->pBuffPtr = pData;
1198    hsmbus->XferCount = Size;
1199    hsmbus->XferOptions = XferOptions;
1200
1201    /* Convert OTHER_xxx XferOptions if any */
1202    SMBUS_ConvertOtherXferOptions(hsmbus);
1203
1204    if (Size > MAX_NBYTE_SIZE)
1205    {
1206      hsmbus->XferSize = MAX_NBYTE_SIZE;
1207    }
1208    else
1209    {
1210      hsmbus->XferSize = Size;
1211    }
1212
1213    /* Set NBYTES to write and reload if size > MAX_NBYTE_SIZE and generate RESTART */
1214    if ((hsmbus->XferSize < hsmbus->XferCount) && (hsmbus->XferSize == MAX_NBYTE_SIZE))
1215    {
1216      SMBUS_TransferConfig(hsmbus, 0, (uint8_t)hsmbus->XferSize, SMBUS_RELOAD_MODE | (hsmbus->XferOptions & SMBUS_SENDPEC_MODE), SMBUS_NO_STARTSTOP);
1217    }
1218    else
1219    {
1220      /* Set NBYTE to transmit */
1221      SMBUS_TransferConfig(hsmbus, 0, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_NO_STARTSTOP);
1222
1223      /* If PEC mode is enable, size to transmit should be Size-1 byte, corresponding to PEC byte */
1224      /* PEC byte is automatically sent by HW block, no need to manage it in Transmit process */
1225      if (SMBUS_GET_PEC_MODE(hsmbus) != 0UL)
1226      {
1227        hsmbus->XferSize--;
1228        hsmbus->XferCount--;
1229      }
1230    }
1231
1232    /* Clear ADDR flag after prepare the transfer parameters */
1233    /* This action will generate an acknowledge to the HOST */
1234    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_ADDR);
1235
1236    /* Process Unlocked */
1237    __HAL_UNLOCK(hsmbus);
1238
1239    /* Note : The SMBUS interrupts must be enabled after unlocking current process
1240              to avoid the risk of SMBUS interrupt handle execution before current
1241              process unlock */
1242    /* REnable ADDR interrupt */
1243    SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_TX | SMBUS_IT_ADDR);
1244
1245    return HAL_OK;
1246  }
1247  else
1248  {
1249    return HAL_BUSY;
1250  }
1251}
1252
1253/**
1254  * @brief  Receive in slave/device SMBUS mode an amount of data in non-blocking mode with Interrupt.
1255  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1256  *                the configuration information for the specified SMBUS.
1257  * @param  pData Pointer to data buffer
1258  * @param  Size Amount of data to be sent
1259  * @param  XferOptions Options of Transfer, value of @ref SMBUS_XferOptions_definition
1260  * @retval HAL status
1261  */
1262HAL_StatusTypeDef HAL_SMBUS_Slave_Receive_IT(SMBUS_HandleTypeDef *hsmbus, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
1263{
1264  /* Check the parameters */
1265  assert_param(IS_SMBUS_TRANSFER_OPTIONS_REQUEST(XferOptions));
1266
1267  if ((hsmbus->State & HAL_SMBUS_STATE_LISTEN) == HAL_SMBUS_STATE_LISTEN)
1268  {
1269    if ((pData == NULL) || (Size == 0UL))
1270    {
1271      hsmbus->ErrorCode = HAL_SMBUS_ERROR_INVALID_PARAM;
1272      return HAL_ERROR;
1273    }
1274
1275    /* Disable Interrupts, to prevent preemption during treatment in case of multicall */
1276    SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_ADDR | SMBUS_IT_RX);
1277
1278    /* Process Locked */
1279    __HAL_LOCK(hsmbus);
1280
1281    hsmbus->State = (HAL_SMBUS_STATE_SLAVE_BUSY_RX | HAL_SMBUS_STATE_LISTEN);
1282    hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
1283
1284    /* Set SBC bit to manage Acknowledge at each bit */
1285    hsmbus->Instance->CR1 |= I2C_CR1_SBC;
1286
1287    /* Enable Address Acknowledge */
1288    hsmbus->Instance->CR2 &= ~I2C_CR2_NACK;
1289
1290    /* Prepare transfer parameters */
1291    hsmbus->pBuffPtr = pData;
1292    hsmbus->XferSize = Size;
1293    hsmbus->XferCount = Size;
1294    hsmbus->XferOptions = XferOptions;
1295
1296    /* Convert OTHER_xxx XferOptions if any */
1297    SMBUS_ConvertOtherXferOptions(hsmbus);
1298
1299    /* Set NBYTE to receive */
1300    /* If XferSize equal "1", or XferSize equal "2" with PEC requested (mean 1 data byte + 1 PEC byte */
1301    /* no need to set RELOAD bit mode, a ACK will be automatically generated in that case */
1302    /* else need to set RELOAD bit mode to generate an automatic ACK at each byte Received */
1303    /* This RELOAD bit will be reset for last BYTE to be receive in SMBUS_Slave_ISR */
1304    if (((SMBUS_GET_PEC_MODE(hsmbus) != 0UL) && (hsmbus->XferSize == 2U)) || (hsmbus->XferSize == 1U))
1305    {
1306      SMBUS_TransferConfig(hsmbus, 0, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_NO_STARTSTOP);
1307    }
1308    else
1309    {
1310      SMBUS_TransferConfig(hsmbus, 0, 1, hsmbus->XferOptions | SMBUS_RELOAD_MODE, SMBUS_NO_STARTSTOP);
1311    }
1312
1313    /* Clear ADDR flag after prepare the transfer parameters */
1314    /* This action will generate an acknowledge to the HOST */
1315    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_ADDR);
1316
1317    /* Process Unlocked */
1318    __HAL_UNLOCK(hsmbus);
1319
1320    /* Note : The SMBUS interrupts must be enabled after unlocking current process
1321              to avoid the risk of SMBUS interrupt handle execution before current
1322              process unlock */
1323    /* REnable ADDR interrupt */
1324    SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_RX | SMBUS_IT_ADDR);
1325
1326    return HAL_OK;
1327  }
1328  else
1329  {
1330    return HAL_BUSY;
1331  }
1332}
1333
1334/**
1335  * @brief  Enable the Address listen mode with Interrupt.
1336  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1337  *                the configuration information for the specified SMBUS.
1338  * @retval HAL status
1339  */
1340HAL_StatusTypeDef HAL_SMBUS_EnableListen_IT(SMBUS_HandleTypeDef *hsmbus)
1341{
1342  hsmbus->State = HAL_SMBUS_STATE_LISTEN;
1343
1344  /* Enable the Address Match interrupt */
1345  SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_ADDR);
1346
1347  return HAL_OK;
1348}
1349
1350/**
1351  * @brief  Disable the Address listen mode with Interrupt.
1352  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1353  *                the configuration information for the specified SMBUS.
1354  * @retval HAL status
1355  */
1356HAL_StatusTypeDef HAL_SMBUS_DisableListen_IT(SMBUS_HandleTypeDef *hsmbus)
1357{
1358  /* Disable Address listen mode only if a transfer is not ongoing */
1359  if (hsmbus->State == HAL_SMBUS_STATE_LISTEN)
1360  {
1361    hsmbus->State = HAL_SMBUS_STATE_READY;
1362
1363    /* Disable the Address Match interrupt */
1364    SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_ADDR);
1365
1366    return HAL_OK;
1367  }
1368  else
1369  {
1370    return HAL_BUSY;
1371  }
1372}
1373
1374/**
1375  * @brief  Enable the SMBUS alert mode with Interrupt.
1376  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1377  *                the configuration information for the specified SMBUSx peripheral.
1378  * @retval HAL status
1379  */
1380HAL_StatusTypeDef HAL_SMBUS_EnableAlert_IT(SMBUS_HandleTypeDef *hsmbus)
1381{
1382  /* Enable SMBus alert */
1383  hsmbus->Instance->CR1 |= I2C_CR1_ALERTEN;
1384
1385  /* Clear ALERT flag */
1386  __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_ALERT);
1387
1388  /* Enable Alert Interrupt */
1389  SMBUS_Enable_IRQ(hsmbus, SMBUS_IT_ALERT);
1390
1391  return HAL_OK;
1392}
1393/**
1394  * @brief  Disable the SMBUS alert mode with Interrupt.
1395  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1396  *                the configuration information for the specified SMBUSx peripheral.
1397  * @retval HAL status
1398  */
1399HAL_StatusTypeDef HAL_SMBUS_DisableAlert_IT(SMBUS_HandleTypeDef *hsmbus)
1400{
1401  /* Enable SMBus alert */
1402  hsmbus->Instance->CR1 &= ~I2C_CR1_ALERTEN;
1403
1404  /* Disable Alert Interrupt */
1405  SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_ALERT);
1406
1407  return HAL_OK;
1408}
1409
1410/**
1411  * @brief  Check if target device is ready for communication.
1412  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1413  *                the configuration information for the specified SMBUS.
1414  * @param  DevAddress Target device address: The device 7 bits address value
1415  *         in datasheet must be shifted to the left before calling the interface
1416  * @param  Trials Number of trials
1417  * @param  Timeout Timeout duration
1418  * @retval HAL status
1419  */
1420HAL_StatusTypeDef HAL_SMBUS_IsDeviceReady(SMBUS_HandleTypeDef *hsmbus, uint16_t DevAddress, uint32_t Trials, uint32_t Timeout)
1421{
1422  uint32_t tickstart;
1423
1424  __IO uint32_t SMBUS_Trials = 0UL;
1425
1426  FlagStatus tmp1;
1427  FlagStatus tmp2;
1428
1429  if (hsmbus->State == HAL_SMBUS_STATE_READY)
1430  {
1431    if (__HAL_SMBUS_GET_FLAG(hsmbus, SMBUS_FLAG_BUSY) != RESET)
1432    {
1433      return HAL_BUSY;
1434    }
1435
1436    /* Process Locked */
1437    __HAL_LOCK(hsmbus);
1438
1439    hsmbus->State = HAL_SMBUS_STATE_BUSY;
1440    hsmbus->ErrorCode = HAL_SMBUS_ERROR_NONE;
1441
1442    do
1443    {
1444      /* Generate Start */
1445      hsmbus->Instance->CR2 = SMBUS_GENERATE_START(hsmbus->Init.AddressingMode, DevAddress);
1446
1447      /* No need to Check TC flag, with AUTOEND mode the stop is automatically generated */
1448      /* Wait until STOPF flag is set or a NACK flag is set*/
1449      tickstart = HAL_GetTick();
1450
1451      tmp1 = __HAL_SMBUS_GET_FLAG(hsmbus, SMBUS_FLAG_STOPF);
1452      tmp2 = __HAL_SMBUS_GET_FLAG(hsmbus, SMBUS_FLAG_AF);
1453
1454      while ((tmp1 == RESET) && (tmp2 == RESET))
1455      {
1456        if (Timeout != HAL_MAX_DELAY)
1457        {
1458          if (((HAL_GetTick() - tickstart) > Timeout) || (Timeout == 0UL))
1459          {
1460            /* Device is ready */
1461            hsmbus->State = HAL_SMBUS_STATE_READY;
1462
1463            /* Update SMBUS error code */
1464            hsmbus->ErrorCode |= HAL_SMBUS_ERROR_HALTIMEOUT;
1465
1466            /* Process Unlocked */
1467            __HAL_UNLOCK(hsmbus);
1468            return HAL_ERROR;
1469          }
1470        }
1471
1472        tmp1 = __HAL_SMBUS_GET_FLAG(hsmbus, SMBUS_FLAG_STOPF);
1473        tmp2 = __HAL_SMBUS_GET_FLAG(hsmbus, SMBUS_FLAG_AF);
1474      }
1475
1476      /* Check if the NACKF flag has not been set */
1477      if (__HAL_SMBUS_GET_FLAG(hsmbus, SMBUS_FLAG_AF) == RESET)
1478      {
1479        /* Wait until STOPF flag is reset */
1480        if (SMBUS_WaitOnFlagUntilTimeout(hsmbus, SMBUS_FLAG_STOPF, RESET, Timeout) != HAL_OK)
1481        {
1482          return HAL_ERROR;
1483        }
1484
1485        /* Clear STOP Flag */
1486        __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_STOPF);
1487
1488        /* Device is ready */
1489        hsmbus->State = HAL_SMBUS_STATE_READY;
1490
1491        /* Process Unlocked */
1492        __HAL_UNLOCK(hsmbus);
1493
1494        return HAL_OK;
1495      }
1496      else
1497      {
1498        /* Wait until STOPF flag is reset */
1499        if (SMBUS_WaitOnFlagUntilTimeout(hsmbus, SMBUS_FLAG_STOPF, RESET, Timeout) != HAL_OK)
1500        {
1501          return HAL_ERROR;
1502        }
1503
1504        /* Clear NACK Flag */
1505        __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_AF);
1506
1507        /* Clear STOP Flag, auto generated with autoend*/
1508        __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_STOPF);
1509      }
1510
1511      /* Check if the maximum allowed number of trials has been reached */
1512      if (SMBUS_Trials == Trials)
1513      {
1514        /* Generate Stop */
1515        hsmbus->Instance->CR2 |= I2C_CR2_STOP;
1516
1517        /* Wait until STOPF flag is reset */
1518        if (SMBUS_WaitOnFlagUntilTimeout(hsmbus, SMBUS_FLAG_STOPF, RESET, Timeout) != HAL_OK)
1519        {
1520          return HAL_ERROR;
1521        }
1522
1523        /* Clear STOP Flag */
1524        __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_STOPF);
1525      }
1526
1527      /* Increment Trials */
1528      SMBUS_Trials++;
1529    }
1530    while (SMBUS_Trials < Trials);
1531
1532    hsmbus->State = HAL_SMBUS_STATE_READY;
1533
1534    /* Update SMBUS error code */
1535    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_HALTIMEOUT;
1536
1537    /* Process Unlocked */
1538    __HAL_UNLOCK(hsmbus);
1539
1540    return HAL_ERROR;
1541  }
1542  else
1543  {
1544    return HAL_BUSY;
1545  }
1546}
1547/**
1548  * @}
1549  */
1550
1551/** @defgroup SMBUS_IRQ_Handler_and_Callbacks IRQ Handler and Callbacks
1552 * @{
1553 */
1554
1555/**
1556  * @brief  Handle SMBUS event interrupt request.
1557  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1558  *                the configuration information for the specified SMBUS.
1559  * @retval None
1560  */
1561void HAL_SMBUS_EV_IRQHandler(SMBUS_HandleTypeDef *hsmbus)
1562{
1563  /* Use a local variable to store the current ISR flags */
1564  /* This action will avoid a wrong treatment due to ISR flags change during interrupt handler */
1565  uint32_t tmpisrvalue = READ_REG(hsmbus->Instance->ISR);
1566  uint32_t tmpcr1value = READ_REG(hsmbus->Instance->CR1);
1567
1568  /* SMBUS in mode Transmitter ---------------------------------------------------*/
1569  if ((SMBUS_CHECK_IT_SOURCE(tmpcr1value, (SMBUS_IT_TCI | SMBUS_IT_STOPI | SMBUS_IT_NACKI | SMBUS_IT_TXI)) != RESET) && ((SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_TXIS) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_TCR) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_TC) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_STOPF) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_AF) != RESET)))
1570  {
1571    /* Slave mode selected */
1572    if ((hsmbus->State & HAL_SMBUS_STATE_SLAVE_BUSY_TX) == HAL_SMBUS_STATE_SLAVE_BUSY_TX)
1573    {
1574      (void)SMBUS_Slave_ISR(hsmbus, tmpisrvalue);
1575    }
1576    /* Master mode selected */
1577    else if ((hsmbus->State & HAL_SMBUS_STATE_MASTER_BUSY_TX) == HAL_SMBUS_STATE_MASTER_BUSY_TX)
1578    {
1579      (void)SMBUS_Master_ISR(hsmbus, tmpisrvalue);
1580    }
1581    else
1582    {
1583      /* Nothing to do */
1584    }
1585  }
1586
1587  /* SMBUS in mode Receiver ----------------------------------------------------*/
1588  if ((SMBUS_CHECK_IT_SOURCE(tmpcr1value, (SMBUS_IT_TCI | SMBUS_IT_STOPI | SMBUS_IT_NACKI | SMBUS_IT_RXI)) != RESET) && ((SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_RXNE) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_TCR) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_TC) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_STOPF) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_AF) != RESET)))
1589  {
1590    /* Slave mode selected */
1591    if ((hsmbus->State & HAL_SMBUS_STATE_SLAVE_BUSY_RX) == HAL_SMBUS_STATE_SLAVE_BUSY_RX)
1592    {
1593      (void)SMBUS_Slave_ISR(hsmbus, tmpisrvalue);
1594    }
1595    /* Master mode selected */
1596    else if ((hsmbus->State & HAL_SMBUS_STATE_MASTER_BUSY_RX) == HAL_SMBUS_STATE_MASTER_BUSY_RX)
1597    {
1598      (void)SMBUS_Master_ISR(hsmbus, tmpisrvalue);
1599    }
1600    else
1601    {
1602      /* Nothing to do */
1603    }
1604  }
1605
1606  /* SMBUS in mode Listener Only --------------------------------------------------*/
1607  if (((SMBUS_CHECK_IT_SOURCE(tmpcr1value, SMBUS_IT_ADDRI) != RESET) || (SMBUS_CHECK_IT_SOURCE(tmpcr1value, SMBUS_IT_STOPI) != RESET) || (SMBUS_CHECK_IT_SOURCE(tmpcr1value, SMBUS_IT_NACKI) != RESET)) && ((SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_ADDR) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_STOPF) != RESET) || (SMBUS_CHECK_FLAG(tmpisrvalue, SMBUS_FLAG_AF) != RESET)))
1608  {
1609    if ((hsmbus->State & HAL_SMBUS_STATE_LISTEN) == HAL_SMBUS_STATE_LISTEN)
1610    {
1611      (void)SMBUS_Slave_ISR(hsmbus, tmpisrvalue);
1612    }
1613  }
1614}
1615
1616/**
1617  * @brief  Handle SMBUS error interrupt request.
1618  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1619  *                the configuration information for the specified SMBUS.
1620  * @retval None
1621  */
1622void HAL_SMBUS_ER_IRQHandler(SMBUS_HandleTypeDef *hsmbus)
1623{
1624  SMBUS_ITErrorHandler(hsmbus);
1625}
1626
1627/**
1628  * @brief  Master Tx Transfer completed callback.
1629  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1630  *                the configuration information for the specified SMBUS.
1631  * @retval None
1632  */
1633__weak void HAL_SMBUS_MasterTxCpltCallback(SMBUS_HandleTypeDef *hsmbus)
1634{
1635  /* Prevent unused argument(s) compilation warning */
1636  UNUSED(hsmbus);
1637
1638  /* NOTE : This function should not be modified, when the callback is needed,
1639            the HAL_SMBUS_MasterTxCpltCallback() could be implemented in the user file
1640   */
1641}
1642
1643/**
1644  * @brief  Master Rx Transfer completed callback.
1645  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1646  *                the configuration information for the specified SMBUS.
1647  * @retval None
1648  */
1649__weak void HAL_SMBUS_MasterRxCpltCallback(SMBUS_HandleTypeDef *hsmbus)
1650{
1651  /* Prevent unused argument(s) compilation warning */
1652  UNUSED(hsmbus);
1653
1654  /* NOTE : This function should not be modified, when the callback is needed,
1655            the HAL_SMBUS_MasterRxCpltCallback() could be implemented in the user file
1656   */
1657}
1658
1659/** @brief  Slave Tx Transfer completed callback.
1660  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1661  *                the configuration information for the specified SMBUS.
1662  * @retval None
1663  */
1664__weak void HAL_SMBUS_SlaveTxCpltCallback(SMBUS_HandleTypeDef *hsmbus)
1665{
1666  /* Prevent unused argument(s) compilation warning */
1667  UNUSED(hsmbus);
1668
1669  /* NOTE : This function should not be modified, when the callback is needed,
1670            the HAL_SMBUS_SlaveTxCpltCallback() could be implemented in the user file
1671   */
1672}
1673
1674/**
1675  * @brief  Slave Rx Transfer completed callback.
1676  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1677  *                the configuration information for the specified SMBUS.
1678  * @retval None
1679  */
1680__weak void HAL_SMBUS_SlaveRxCpltCallback(SMBUS_HandleTypeDef *hsmbus)
1681{
1682  /* Prevent unused argument(s) compilation warning */
1683  UNUSED(hsmbus);
1684
1685  /* NOTE : This function should not be modified, when the callback is needed,
1686            the HAL_SMBUS_SlaveRxCpltCallback() could be implemented in the user file
1687   */
1688}
1689
1690/**
1691  * @brief  Slave Address Match callback.
1692  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1693  *                the configuration information for the specified SMBUS.
1694  * @param  TransferDirection Master request Transfer Direction (Write/Read)
1695  * @param  AddrMatchCode Address Match Code
1696  * @retval None
1697  */
1698__weak void HAL_SMBUS_AddrCallback(SMBUS_HandleTypeDef *hsmbus, uint8_t TransferDirection, uint16_t AddrMatchCode)
1699{
1700  /* Prevent unused argument(s) compilation warning */
1701  UNUSED(hsmbus);
1702  UNUSED(TransferDirection);
1703  UNUSED(AddrMatchCode);
1704
1705  /* NOTE : This function should not be modified, when the callback is needed,
1706            the HAL_SMBUS_AddrCallback() could be implemented in the user file
1707   */
1708}
1709
1710/**
1711  * @brief  Listen Complete callback.
1712  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1713  *                the configuration information for the specified SMBUS.
1714  * @retval None
1715  */
1716__weak void HAL_SMBUS_ListenCpltCallback(SMBUS_HandleTypeDef *hsmbus)
1717{
1718  /* Prevent unused argument(s) compilation warning */
1719  UNUSED(hsmbus);
1720
1721  /* NOTE : This function should not be modified, when the callback is needed,
1722            the HAL_SMBUS_ListenCpltCallback() could be implemented in the user file
1723   */
1724}
1725
1726/**
1727  * @brief  SMBUS error callback.
1728  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1729  *                the configuration information for the specified SMBUS.
1730  * @retval None
1731  */
1732__weak void HAL_SMBUS_ErrorCallback(SMBUS_HandleTypeDef *hsmbus)
1733{
1734  /* Prevent unused argument(s) compilation warning */
1735  UNUSED(hsmbus);
1736
1737  /* NOTE : This function should not be modified, when the callback is needed,
1738            the HAL_SMBUS_ErrorCallback() could be implemented in the user file
1739   */
1740}
1741
1742/**
1743  * @}
1744  */
1745
1746/** @defgroup SMBUS_Exported_Functions_Group3 Peripheral State and Errors functions
1747 *  @brief   Peripheral State and Errors functions
1748 *
1749@verbatim
1750 ===============================================================================
1751            ##### Peripheral State and Errors functions #####
1752 ===============================================================================
1753    [..]
1754    This subsection permits to get in run-time the status of the peripheral
1755    and the data flow.
1756
1757@endverbatim
1758  * @{
1759  */
1760
1761/**
1762  * @brief  Return the SMBUS handle state.
1763  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1764  *                the configuration information for the specified SMBUS.
1765  * @retval HAL state
1766  */
1767uint32_t HAL_SMBUS_GetState(SMBUS_HandleTypeDef *hsmbus)
1768{
1769  /* Return SMBUS handle state */
1770  return hsmbus->State;
1771}
1772
1773/**
1774* @brief  Return the SMBUS error code.
1775  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1776  *              the configuration information for the specified SMBUS.
1777* @retval SMBUS Error Code
1778*/
1779uint32_t HAL_SMBUS_GetError(SMBUS_HandleTypeDef *hsmbus)
1780{
1781  return hsmbus->ErrorCode;
1782}
1783
1784/**
1785  * @}
1786  */
1787
1788/**
1789  * @}
1790  */
1791
1792/** @addtogroup SMBUS_Private_Functions SMBUS Private Functions
1793 *  @brief   Data transfers Private functions
1794  * @{
1795  */
1796
1797/**
1798  * @brief  Interrupt Sub-Routine which handle the Interrupt Flags Master Mode.
1799  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
1800  *                the configuration information for the specified SMBUS.
1801  * @param  StatusFlags Value of Interrupt Flags.
1802  * @retval HAL status
1803  */
1804static HAL_StatusTypeDef SMBUS_Master_ISR(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t StatusFlags)
1805{
1806  uint16_t DevAddress;
1807
1808  /* Process Locked */
1809  __HAL_LOCK(hsmbus);
1810
1811  if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_AF) != RESET)
1812  {
1813    /* Clear NACK Flag */
1814    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_AF);
1815
1816    /* Set corresponding Error Code */
1817    /* No need to generate STOP, it is automatically done */
1818    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_ACKF;
1819
1820    /* Process Unlocked */
1821    __HAL_UNLOCK(hsmbus);
1822
1823    /* Call the Error callback to inform upper layer */
1824#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
1825    hsmbus->ErrorCallback(hsmbus);
1826#else
1827    HAL_SMBUS_ErrorCallback(hsmbus);
1828#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
1829  }
1830  else if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_STOPF) != RESET)
1831  {
1832    /* Check and treat errors if errors occurs during STOP process */
1833    SMBUS_ITErrorHandler(hsmbus);
1834
1835    /* Call the corresponding callback to inform upper layer of End of Transfer */
1836    if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_TX)
1837    {
1838      /* Disable Interrupt */
1839      SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_TX);
1840
1841      /* Clear STOP Flag */
1842      __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_STOPF);
1843
1844      /* Clear Configuration Register 2 */
1845      SMBUS_RESET_CR2(hsmbus);
1846
1847      /* Flush remaining data in Fifo register in case of error occurs before TXEmpty */
1848      /* Disable the selected SMBUS peripheral */
1849      __HAL_SMBUS_DISABLE(hsmbus);
1850
1851      hsmbus->PreviousState = HAL_SMBUS_STATE_READY;
1852      hsmbus->State = HAL_SMBUS_STATE_READY;
1853
1854      /* Process Unlocked */
1855      __HAL_UNLOCK(hsmbus);
1856
1857      /* REenable the selected SMBUS peripheral */
1858      __HAL_SMBUS_ENABLE(hsmbus);
1859
1860      /* Call the corresponding callback to inform upper layer of End of Transfer */
1861#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
1862      hsmbus->MasterTxCpltCallback(hsmbus);
1863#else
1864      HAL_SMBUS_MasterTxCpltCallback(hsmbus);
1865#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
1866    }
1867    else if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_RX)
1868    {
1869      /* Store Last receive data if any */
1870      if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_RXNE) != RESET)
1871      {
1872        /* Read data from RXDR */
1873        *hsmbus->pBuffPtr = (uint8_t)(hsmbus->Instance->RXDR);
1874
1875        /* Increment Buffer pointer */
1876        hsmbus->pBuffPtr++;
1877
1878        if ((hsmbus->XferSize > 0U))
1879        {
1880          hsmbus->XferSize--;
1881          hsmbus->XferCount--;
1882        }
1883      }
1884
1885      /* Disable Interrupt */
1886      SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_RX);
1887
1888      /* Clear STOP Flag */
1889      __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_STOPF);
1890
1891      /* Clear Configuration Register 2 */
1892      SMBUS_RESET_CR2(hsmbus);
1893
1894      hsmbus->PreviousState = HAL_SMBUS_STATE_READY;
1895      hsmbus->State = HAL_SMBUS_STATE_READY;
1896
1897      /* Process Unlocked */
1898      __HAL_UNLOCK(hsmbus);
1899
1900      /* Call the corresponding callback to inform upper layer of End of Transfer */
1901#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
1902      hsmbus->MasterRxCpltCallback(hsmbus);
1903#else
1904      HAL_SMBUS_MasterRxCpltCallback(hsmbus);
1905#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
1906    }
1907    else
1908    {
1909      /* Nothing to do */
1910    }
1911  }
1912  else if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_RXNE) != RESET)
1913  {
1914    /* Read data from RXDR */
1915    *hsmbus->pBuffPtr = (uint8_t)(hsmbus->Instance->RXDR);
1916
1917    /* Increment Buffer pointer */
1918    hsmbus->pBuffPtr++;
1919
1920    /* Increment Size counter */
1921    hsmbus->XferSize--;
1922    hsmbus->XferCount--;
1923  }
1924  else if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_TXIS) != RESET)
1925  {
1926    /* Write data to TXDR */
1927    hsmbus->Instance->TXDR = *hsmbus->pBuffPtr;
1928
1929    /* Increment Buffer pointer */
1930    hsmbus->pBuffPtr++;
1931
1932    /* Increment Size counter */
1933    hsmbus->XferSize--;
1934    hsmbus->XferCount--;
1935  }
1936  else if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_TCR) != RESET)
1937  {
1938    if ((hsmbus->XferCount != 0U) && (hsmbus->XferSize == 0U))
1939    {
1940      DevAddress = (uint16_t)(hsmbus->Instance->CR2 & I2C_CR2_SADD);
1941
1942      if (hsmbus->XferCount > MAX_NBYTE_SIZE)
1943      {
1944        SMBUS_TransferConfig(hsmbus, DevAddress, MAX_NBYTE_SIZE, (SMBUS_RELOAD_MODE | (hsmbus->XferOptions & SMBUS_SENDPEC_MODE)), SMBUS_NO_STARTSTOP);
1945        hsmbus->XferSize = MAX_NBYTE_SIZE;
1946      }
1947      else
1948      {
1949        hsmbus->XferSize = hsmbus->XferCount;
1950        SMBUS_TransferConfig(hsmbus, DevAddress, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_NO_STARTSTOP);
1951        /* If PEC mode is enable, size to transmit should be Size-1 byte, corresponding to PEC byte */
1952        /* PEC byte is automatically sent by HW block, no need to manage it in Transmit process */
1953        if (SMBUS_GET_PEC_MODE(hsmbus) != 0UL)
1954        {
1955          hsmbus->XferSize--;
1956          hsmbus->XferCount--;
1957        }
1958      }
1959    }
1960    else if ((hsmbus->XferCount == 0U) && (hsmbus->XferSize == 0U))
1961    {
1962      /* Call TxCpltCallback() if no stop mode is set */
1963      if (SMBUS_GET_STOP_MODE(hsmbus) != SMBUS_AUTOEND_MODE)
1964      {
1965        /* Call the corresponding callback to inform upper layer of End of Transfer */
1966        if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_TX)
1967        {
1968          /* Disable Interrupt */
1969          SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_TX);
1970          hsmbus->PreviousState = hsmbus->State;
1971          hsmbus->State = HAL_SMBUS_STATE_READY;
1972
1973          /* Process Unlocked */
1974          __HAL_UNLOCK(hsmbus);
1975
1976          /* Call the corresponding callback to inform upper layer of End of Transfer */
1977#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
1978          hsmbus->MasterTxCpltCallback(hsmbus);
1979#else
1980          HAL_SMBUS_MasterTxCpltCallback(hsmbus);
1981#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
1982        }
1983        else if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_RX)
1984        {
1985          SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_RX);
1986          hsmbus->PreviousState = hsmbus->State;
1987          hsmbus->State = HAL_SMBUS_STATE_READY;
1988
1989          /* Process Unlocked */
1990          __HAL_UNLOCK(hsmbus);
1991
1992          /* Call the corresponding callback to inform upper layer of End of Transfer */
1993#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
1994          hsmbus->MasterRxCpltCallback(hsmbus);
1995#else
1996          HAL_SMBUS_MasterRxCpltCallback(hsmbus);
1997#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
1998        }
1999        else
2000        {
2001          /* Nothing to do */
2002        }
2003      }
2004    }
2005    else
2006    {
2007      /* Nothing to do */
2008    }
2009  }
2010  else if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_TC) != RESET)
2011  {
2012    if (hsmbus->XferCount == 0U)
2013    {
2014      /* Specific use case for Quick command */
2015      if (hsmbus->pBuffPtr == NULL)
2016      {
2017        /* Generate a Stop command */
2018        hsmbus->Instance->CR2 |= I2C_CR2_STOP;
2019      }
2020      /* Call TxCpltCallback() if no stop mode is set */
2021      else if (SMBUS_GET_STOP_MODE(hsmbus) != SMBUS_AUTOEND_MODE)
2022      {
2023        /* No Generate Stop, to permit restart mode */
2024        /* The stop will be done at the end of transfer, when SMBUS_AUTOEND_MODE enable */
2025
2026        /* Call the corresponding callback to inform upper layer of End of Transfer */
2027        if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_TX)
2028        {
2029          /* Disable Interrupt */
2030          SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_TX);
2031          hsmbus->PreviousState = hsmbus->State;
2032          hsmbus->State = HAL_SMBUS_STATE_READY;
2033
2034          /* Process Unlocked */
2035          __HAL_UNLOCK(hsmbus);
2036
2037          /* Call the corresponding callback to inform upper layer of End of Transfer */
2038#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2039          hsmbus->MasterTxCpltCallback(hsmbus);
2040#else
2041          HAL_SMBUS_MasterTxCpltCallback(hsmbus);
2042#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2043        }
2044        else if (hsmbus->State == HAL_SMBUS_STATE_MASTER_BUSY_RX)
2045        {
2046          SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_RX);
2047          hsmbus->PreviousState = hsmbus->State;
2048          hsmbus->State = HAL_SMBUS_STATE_READY;
2049
2050          /* Process Unlocked */
2051          __HAL_UNLOCK(hsmbus);
2052
2053          /* Call the corresponding callback to inform upper layer of End of Transfer */
2054#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2055          hsmbus->MasterRxCpltCallback(hsmbus);
2056#else
2057          HAL_SMBUS_MasterRxCpltCallback(hsmbus);
2058#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2059        }
2060        else
2061        {
2062          /* Nothing to do */
2063        }
2064      }
2065      else
2066      {
2067        /* Nothing to do */
2068      }
2069    }
2070  }
2071  else
2072  {
2073    /* Nothing to do */
2074  }
2075
2076  /* Process Unlocked */
2077  __HAL_UNLOCK(hsmbus);
2078
2079  return HAL_OK;
2080}
2081/**
2082  * @brief  Interrupt Sub-Routine which handle the Interrupt Flags Slave Mode.
2083  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
2084  *                the configuration information for the specified SMBUS.
2085  * @param  StatusFlags Value of Interrupt Flags.
2086  * @retval HAL status
2087  */
2088static HAL_StatusTypeDef SMBUS_Slave_ISR(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t StatusFlags)
2089{
2090  uint8_t TransferDirection;
2091  uint16_t SlaveAddrCode;
2092
2093  /* Process Locked */
2094  __HAL_LOCK(hsmbus);
2095
2096  if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_AF) != RESET)
2097  {
2098    /* Check that SMBUS transfer finished */
2099    /* if yes, normal usecase, a NACK is sent by the HOST when Transfer is finished */
2100    /* Mean XferCount == 0*/
2101    /* So clear Flag NACKF only */
2102    if (hsmbus->XferCount == 0U)
2103    {
2104      /* Clear NACK Flag */
2105      __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_AF);
2106
2107      /* Process Unlocked */
2108      __HAL_UNLOCK(hsmbus);
2109    }
2110    else
2111    {
2112      /* if no, error usecase, a Non-Acknowledge of last Data is generated by the HOST*/
2113      /* Clear NACK Flag */
2114      __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_AF);
2115
2116      /* Set HAL State to "Idle" State, mean to LISTEN state */
2117      /* So reset Slave Busy state */
2118      hsmbus->PreviousState = hsmbus->State;
2119      hsmbus->State &= ~((uint32_t)HAL_SMBUS_STATE_SLAVE_BUSY_TX);
2120      hsmbus->State &= ~((uint32_t)HAL_SMBUS_STATE_SLAVE_BUSY_RX);
2121
2122      /* Disable RX/TX Interrupts, keep only ADDR Interrupt */
2123      SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_RX | SMBUS_IT_TX);
2124
2125      /* Set ErrorCode corresponding to a Non-Acknowledge */
2126      hsmbus->ErrorCode |= HAL_SMBUS_ERROR_ACKF;
2127
2128      /* Process Unlocked */
2129      __HAL_UNLOCK(hsmbus);
2130
2131      /* Call the Error callback to inform upper layer */
2132#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2133      hsmbus->ErrorCallback(hsmbus);
2134#else
2135      HAL_SMBUS_ErrorCallback(hsmbus);
2136#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2137    }
2138  }
2139  else if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_ADDR) != RESET)
2140  {
2141    TransferDirection = (uint8_t)(SMBUS_GET_DIR(hsmbus));
2142    SlaveAddrCode = (uint16_t)(SMBUS_GET_ADDR_MATCH(hsmbus));
2143
2144    /* Disable ADDR interrupt to prevent multiple ADDRInterrupt*/
2145    /* Other ADDRInterrupt will be treat in next Listen usecase */
2146    __HAL_SMBUS_DISABLE_IT(hsmbus, SMBUS_IT_ADDRI);
2147
2148    /* Process Unlocked */
2149    __HAL_UNLOCK(hsmbus);
2150
2151    /* Call Slave Addr callback */
2152#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2153    hsmbus->AddrCallback(hsmbus, TransferDirection, SlaveAddrCode);
2154#else
2155    HAL_SMBUS_AddrCallback(hsmbus, TransferDirection, SlaveAddrCode);
2156#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2157  }
2158  else if ((SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_RXNE) != RESET) || (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_TCR) != RESET))
2159  {
2160    if ((hsmbus->State & HAL_SMBUS_STATE_SLAVE_BUSY_RX) == HAL_SMBUS_STATE_SLAVE_BUSY_RX)
2161    {
2162      /* Read data from RXDR */
2163      *hsmbus->pBuffPtr = (uint8_t)(hsmbus->Instance->RXDR);
2164
2165      /* Increment Buffer pointer */
2166      hsmbus->pBuffPtr++;
2167
2168      hsmbus->XferSize--;
2169      hsmbus->XferCount--;
2170
2171      if (hsmbus->XferCount == 1U)
2172      {
2173        /* Receive last Byte, can be PEC byte in case of PEC BYTE enabled */
2174        /* or only the last Byte of Transfer */
2175        /* So reset the RELOAD bit mode */
2176        hsmbus->XferOptions &= ~SMBUS_RELOAD_MODE;
2177        SMBUS_TransferConfig(hsmbus, 0, 1, hsmbus->XferOptions, SMBUS_NO_STARTSTOP);
2178      }
2179      else if (hsmbus->XferCount == 0U)
2180      {
2181        /* Last Byte is received, disable Interrupt */
2182        SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_RX);
2183
2184        /* Remove HAL_SMBUS_STATE_SLAVE_BUSY_RX, keep only HAL_SMBUS_STATE_LISTEN */
2185        hsmbus->PreviousState = hsmbus->State;
2186        hsmbus->State &= ~((uint32_t)HAL_SMBUS_STATE_SLAVE_BUSY_RX);
2187
2188        /* Process Unlocked */
2189        __HAL_UNLOCK(hsmbus);
2190
2191        /* Call the corresponding callback to inform upper layer of End of Transfer */
2192#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2193        hsmbus->SlaveRxCpltCallback(hsmbus);
2194#else
2195        HAL_SMBUS_SlaveRxCpltCallback(hsmbus);
2196#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2197      }
2198      else
2199      {
2200        /* Set Reload for next Bytes */
2201        SMBUS_TransferConfig(hsmbus, 0, 1, SMBUS_RELOAD_MODE  | (hsmbus->XferOptions & SMBUS_SENDPEC_MODE), SMBUS_NO_STARTSTOP);
2202
2203        /* Ack last Byte Read */
2204        hsmbus->Instance->CR2 &= ~I2C_CR2_NACK;
2205      }
2206    }
2207    else if ((hsmbus->State & HAL_SMBUS_STATE_SLAVE_BUSY_TX) == HAL_SMBUS_STATE_SLAVE_BUSY_TX)
2208    {
2209      if ((hsmbus->XferCount != 0U) && (hsmbus->XferSize == 0U))
2210      {
2211        if (hsmbus->XferCount > MAX_NBYTE_SIZE)
2212        {
2213          SMBUS_TransferConfig(hsmbus, 0, MAX_NBYTE_SIZE, (SMBUS_RELOAD_MODE | (hsmbus->XferOptions & SMBUS_SENDPEC_MODE)), SMBUS_NO_STARTSTOP);
2214          hsmbus->XferSize = MAX_NBYTE_SIZE;
2215        }
2216        else
2217        {
2218          hsmbus->XferSize = hsmbus->XferCount;
2219          SMBUS_TransferConfig(hsmbus, 0, (uint8_t)hsmbus->XferSize, hsmbus->XferOptions, SMBUS_NO_STARTSTOP);
2220          /* If PEC mode is enable, size to transmit should be Size-1 byte, corresponding to PEC byte */
2221          /* PEC byte is automatically sent by HW block, no need to manage it in Transmit process */
2222          if (SMBUS_GET_PEC_MODE(hsmbus) != 0UL)
2223          {
2224            hsmbus->XferSize--;
2225            hsmbus->XferCount--;
2226          }
2227        }
2228      }
2229    }
2230    else
2231    {
2232      /* Nothing to do */
2233    }
2234  }
2235  else if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_TXIS) != RESET)
2236  {
2237    /* Write data to TXDR only if XferCount not reach "0" */
2238    /* A TXIS flag can be set, during STOP treatment      */
2239    /* Check if all Data have already been sent */
2240    /* If it is the case, this last write in TXDR is not sent, correspond to a dummy TXIS event */
2241    if (hsmbus->XferCount > 0U)
2242    {
2243      /* Write data to TXDR */
2244      hsmbus->Instance->TXDR = *hsmbus->pBuffPtr;
2245
2246      /* Increment Buffer pointer */
2247      hsmbus->pBuffPtr++;
2248
2249      hsmbus->XferCount--;
2250      hsmbus->XferSize--;
2251    }
2252
2253    if (hsmbus->XferCount == 0U)
2254    {
2255      /* Last Byte is Transmitted */
2256      /* Remove HAL_SMBUS_STATE_SLAVE_BUSY_TX, keep only HAL_SMBUS_STATE_LISTEN */
2257      SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_TX);
2258      hsmbus->PreviousState = hsmbus->State;
2259      hsmbus->State &= ~((uint32_t)HAL_SMBUS_STATE_SLAVE_BUSY_TX);
2260
2261      /* Process Unlocked */
2262      __HAL_UNLOCK(hsmbus);
2263
2264      /* Call the corresponding callback to inform upper layer of End of Transfer */
2265#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2266      hsmbus->SlaveTxCpltCallback(hsmbus);
2267#else
2268      HAL_SMBUS_SlaveTxCpltCallback(hsmbus);
2269#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2270    }
2271  }
2272  else
2273  {
2274    /* Nothing to do */
2275  }
2276
2277  /* Check if STOPF is set */
2278  if (SMBUS_CHECK_FLAG(StatusFlags, SMBUS_FLAG_STOPF) != RESET)
2279  {
2280    if ((hsmbus->State & HAL_SMBUS_STATE_LISTEN) == HAL_SMBUS_STATE_LISTEN)
2281    {
2282      /* Store Last receive data if any */
2283      if (__HAL_SMBUS_GET_FLAG(hsmbus, SMBUS_FLAG_RXNE) != RESET)
2284      {
2285        /* Read data from RXDR */
2286        *hsmbus->pBuffPtr = (uint8_t)(hsmbus->Instance->RXDR);
2287
2288        /* Increment Buffer pointer */
2289        hsmbus->pBuffPtr++;
2290
2291        if ((hsmbus->XferSize > 0U))
2292        {
2293          hsmbus->XferSize--;
2294          hsmbus->XferCount--;
2295        }
2296      }
2297
2298      /* Disable RX and TX Interrupts */
2299      SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_RX | SMBUS_IT_TX);
2300
2301      /* Disable ADDR Interrupt */
2302      SMBUS_Disable_IRQ(hsmbus, SMBUS_IT_ADDR);
2303
2304      /* Disable Address Acknowledge */
2305      hsmbus->Instance->CR2 |= I2C_CR2_NACK;
2306
2307      /* Clear Configuration Register 2 */
2308      SMBUS_RESET_CR2(hsmbus);
2309
2310      /* Clear STOP Flag */
2311      __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_STOPF);
2312
2313      /* Clear ADDR flag */
2314      __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_ADDR);
2315
2316      hsmbus->XferOptions = 0;
2317      hsmbus->PreviousState = hsmbus->State;
2318      hsmbus->State = HAL_SMBUS_STATE_READY;
2319
2320      /* Process Unlocked */
2321      __HAL_UNLOCK(hsmbus);
2322
2323      /* Call the Listen Complete callback, to inform upper layer of the end of Listen usecase */
2324#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2325      hsmbus->ListenCpltCallback(hsmbus);
2326#else
2327      HAL_SMBUS_ListenCpltCallback(hsmbus);
2328#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2329    }
2330  }
2331
2332  /* Process Unlocked */
2333  __HAL_UNLOCK(hsmbus);
2334
2335  return HAL_OK;
2336}
2337/**
2338  * @brief  Manage the enabling of Interrupts.
2339  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
2340  *                the configuration information for the specified SMBUS.
2341  * @param  InterruptRequest Value of @ref SMBUS_Interrupt_configuration_definition.
2342  * @retval HAL status
2343  */
2344static void SMBUS_Enable_IRQ(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t InterruptRequest)
2345{
2346  uint32_t tmpisr = 0UL;
2347
2348  if ((InterruptRequest & SMBUS_IT_ALERT) == SMBUS_IT_ALERT)
2349  {
2350    /* Enable ERR interrupt */
2351    tmpisr |= SMBUS_IT_ERRI;
2352  }
2353
2354  if ((InterruptRequest & SMBUS_IT_ADDR) == SMBUS_IT_ADDR)
2355  {
2356    /* Enable ADDR, STOP interrupt */
2357    tmpisr |= SMBUS_IT_ADDRI | SMBUS_IT_STOPI | SMBUS_IT_NACKI | SMBUS_IT_ERRI;
2358  }
2359
2360  if ((InterruptRequest & SMBUS_IT_TX) == SMBUS_IT_TX)
2361  {
2362    /* Enable ERR, TC, STOP, NACK, RXI interrupt */
2363    tmpisr |= SMBUS_IT_ERRI | SMBUS_IT_TCI | SMBUS_IT_STOPI | SMBUS_IT_NACKI | SMBUS_IT_TXI;
2364  }
2365
2366  if ((InterruptRequest & SMBUS_IT_RX) == SMBUS_IT_RX)
2367  {
2368    /* Enable ERR, TC, STOP, NACK, TXI interrupt */
2369    tmpisr |= SMBUS_IT_ERRI | SMBUS_IT_TCI | SMBUS_IT_STOPI | SMBUS_IT_NACKI | SMBUS_IT_RXI;
2370  }
2371
2372  /* Enable interrupts only at the end */
2373  /* to avoid the risk of SMBUS interrupt handle execution before */
2374  /* all interrupts requested done */
2375  __HAL_SMBUS_ENABLE_IT(hsmbus, tmpisr);
2376}
2377/**
2378  * @brief  Manage the disabling of Interrupts.
2379  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
2380  *                the configuration information for the specified SMBUS.
2381  * @param  InterruptRequest Value of @ref SMBUS_Interrupt_configuration_definition.
2382  * @retval HAL status
2383  */
2384static void SMBUS_Disable_IRQ(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t InterruptRequest)
2385{
2386  uint32_t tmpisr = 0UL;
2387  uint32_t tmpstate = hsmbus->State;
2388
2389  if ((tmpstate == HAL_SMBUS_STATE_READY) && ((InterruptRequest & SMBUS_IT_ALERT) == SMBUS_IT_ALERT))
2390  {
2391    /* Disable ERR interrupt */
2392    tmpisr |= SMBUS_IT_ERRI;
2393  }
2394
2395  if ((InterruptRequest & SMBUS_IT_TX) == SMBUS_IT_TX)
2396  {
2397    /* Disable TC, STOP, NACK and TXI interrupt */
2398    tmpisr |= SMBUS_IT_TCI | SMBUS_IT_TXI;
2399
2400    if ((SMBUS_GET_ALERT_ENABLED(hsmbus) == 0UL)
2401        && ((tmpstate & HAL_SMBUS_STATE_LISTEN) != HAL_SMBUS_STATE_LISTEN))
2402    {
2403      /* Disable ERR interrupt */
2404      tmpisr |= SMBUS_IT_ERRI;
2405    }
2406
2407    if ((tmpstate & HAL_SMBUS_STATE_LISTEN) != HAL_SMBUS_STATE_LISTEN)
2408    {
2409      /* Disable STOP and NACK interrupt */
2410      tmpisr |= SMBUS_IT_STOPI | SMBUS_IT_NACKI;
2411    }
2412  }
2413
2414  if ((InterruptRequest & SMBUS_IT_RX) == SMBUS_IT_RX)
2415  {
2416    /* Disable TC, STOP, NACK and RXI interrupt */
2417    tmpisr |= SMBUS_IT_TCI | SMBUS_IT_RXI;
2418
2419    if ((SMBUS_GET_ALERT_ENABLED(hsmbus) == 0UL)
2420        && ((tmpstate & HAL_SMBUS_STATE_LISTEN) != HAL_SMBUS_STATE_LISTEN))
2421    {
2422      /* Disable ERR interrupt */
2423      tmpisr |= SMBUS_IT_ERRI;
2424    }
2425
2426    if ((tmpstate & HAL_SMBUS_STATE_LISTEN) != HAL_SMBUS_STATE_LISTEN)
2427    {
2428      /* Disable STOP and NACK interrupt */
2429      tmpisr |= SMBUS_IT_STOPI | SMBUS_IT_NACKI;
2430    }
2431  }
2432
2433  if ((InterruptRequest & SMBUS_IT_ADDR) == SMBUS_IT_ADDR)
2434  {
2435    /* Disable ADDR, STOP and NACK interrupt */
2436    tmpisr |= SMBUS_IT_ADDRI | SMBUS_IT_STOPI | SMBUS_IT_NACKI;
2437
2438    if (SMBUS_GET_ALERT_ENABLED(hsmbus) == 0UL)
2439    {
2440      /* Disable ERR interrupt */
2441      tmpisr |= SMBUS_IT_ERRI;
2442    }
2443  }
2444
2445  /* Disable interrupts only at the end */
2446  /* to avoid a breaking situation like at "t" time */
2447  /* all disable interrupts request are not done */
2448  __HAL_SMBUS_DISABLE_IT(hsmbus, tmpisr);
2449}
2450
2451/**
2452  * @brief  SMBUS interrupts error handler.
2453  * @param  hsmbus SMBUS handle.
2454  * @retval None
2455  */
2456static void SMBUS_ITErrorHandler(struct __SMBUS_HandleTypeDef *hsmbus)
2457{
2458  uint32_t itflags   = READ_REG(hsmbus->Instance->ISR);
2459  uint32_t itsources = READ_REG(hsmbus->Instance->CR1);
2460  uint32_t tmpstate;
2461  uint32_t tmperror;
2462
2463  /* SMBUS Bus error interrupt occurred ------------------------------------*/
2464  if (((itflags & SMBUS_FLAG_BERR) == SMBUS_FLAG_BERR) && ((itsources & SMBUS_IT_ERRI) == SMBUS_IT_ERRI))
2465  {
2466    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_BERR;
2467
2468    /* Clear BERR flag */
2469    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_BERR);
2470  }
2471
2472  /* SMBUS Over-Run/Under-Run interrupt occurred ----------------------------------------*/
2473  if (((itflags & SMBUS_FLAG_OVR) == SMBUS_FLAG_OVR) && ((itsources & SMBUS_IT_ERRI) == SMBUS_IT_ERRI))
2474  {
2475    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_OVR;
2476
2477    /* Clear OVR flag */
2478    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_OVR);
2479  }
2480
2481  /* SMBUS Arbitration Loss error interrupt occurred ------------------------------------*/
2482  if (((itflags & SMBUS_FLAG_ARLO) == SMBUS_FLAG_ARLO) && ((itsources & SMBUS_IT_ERRI) == SMBUS_IT_ERRI))
2483  {
2484    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_ARLO;
2485
2486    /* Clear ARLO flag */
2487    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_ARLO);
2488  }
2489
2490  /* SMBUS Timeout error interrupt occurred ---------------------------------------------*/
2491  if (((itflags & SMBUS_FLAG_TIMEOUT) == SMBUS_FLAG_TIMEOUT) && ((itsources & SMBUS_IT_ERRI) == SMBUS_IT_ERRI))
2492  {
2493    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_BUSTIMEOUT;
2494
2495    /* Clear TIMEOUT flag */
2496    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_TIMEOUT);
2497  }
2498
2499  /* SMBUS Alert error interrupt occurred -----------------------------------------------*/
2500  if (((itflags & SMBUS_FLAG_ALERT) == SMBUS_FLAG_ALERT) && ((itsources & SMBUS_IT_ERRI) == SMBUS_IT_ERRI))
2501  {
2502    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_ALERT;
2503
2504    /* Clear ALERT flag */
2505    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_ALERT);
2506  }
2507
2508  /* SMBUS Packet Error Check error interrupt occurred ----------------------------------*/
2509  if (((itflags & SMBUS_FLAG_PECERR) == SMBUS_FLAG_PECERR) && ((itsources & SMBUS_IT_ERRI) == SMBUS_IT_ERRI))
2510  {
2511    hsmbus->ErrorCode |= HAL_SMBUS_ERROR_PECERR;
2512
2513    /* Clear PEC error flag */
2514    __HAL_SMBUS_CLEAR_FLAG(hsmbus, SMBUS_FLAG_PECERR);
2515  }
2516
2517  /* Store current volatile hsmbus->State, misra rule */
2518  tmperror = hsmbus->ErrorCode;
2519
2520  /* Call the Error Callback in case of Error detected */
2521  if ((tmperror != HAL_SMBUS_ERROR_NONE) && (tmperror != HAL_SMBUS_ERROR_ACKF))
2522  {
2523    /* Do not Reset the HAL state in case of ALERT error */
2524    if ((tmperror & HAL_SMBUS_ERROR_ALERT) != HAL_SMBUS_ERROR_ALERT)
2525    {
2526      /* Store current volatile hsmbus->State, misra rule */
2527      tmpstate = hsmbus->State;
2528
2529      if (((tmpstate & HAL_SMBUS_STATE_SLAVE_BUSY_TX) == HAL_SMBUS_STATE_SLAVE_BUSY_TX)
2530          || ((tmpstate & HAL_SMBUS_STATE_SLAVE_BUSY_RX) == HAL_SMBUS_STATE_SLAVE_BUSY_RX))
2531      {
2532        /* Reset only HAL_SMBUS_STATE_SLAVE_BUSY_XX */
2533        /* keep HAL_SMBUS_STATE_LISTEN if set */
2534        hsmbus->PreviousState = HAL_SMBUS_STATE_READY;
2535        hsmbus->State = HAL_SMBUS_STATE_LISTEN;
2536      }
2537    }
2538
2539    /* Call the Error callback to inform upper layer */
2540#if (USE_HAL_SMBUS_REGISTER_CALLBACKS == 1)
2541    hsmbus->ErrorCallback(hsmbus);
2542#else
2543    HAL_SMBUS_ErrorCallback(hsmbus);
2544#endif /* USE_HAL_SMBUS_REGISTER_CALLBACKS */
2545  }
2546}
2547
2548/**
2549  * @brief  Handle SMBUS Communication Timeout.
2550  * @param  hsmbus Pointer to a SMBUS_HandleTypeDef structure that contains
2551  *                the configuration information for the specified SMBUS.
2552  * @param  Flag Specifies the SMBUS flag to check.
2553  * @param  Status The new Flag status (SET or RESET).
2554  * @param  Timeout Timeout duration
2555  * @retval HAL status
2556  */
2557static HAL_StatusTypeDef SMBUS_WaitOnFlagUntilTimeout(struct __SMBUS_HandleTypeDef *hsmbus, uint32_t Flag, FlagStatus Status, uint32_t Timeout)
2558{
2559  uint32_t tickstart = HAL_GetTick();
2560
2561  /* Wait until flag is set */
2562  while ((FlagStatus)(__HAL_SMBUS_GET_FLAG(hsmbus, Flag)) == Status)
2563  {
2564    /* Check for the Timeout */
2565    if (Timeout != HAL_MAX_DELAY)
2566    {
2567      if (((HAL_GetTick() - tickstart) > Timeout) || (Timeout == 0UL))
2568      {
2569        hsmbus->PreviousState = hsmbus->State;
2570        hsmbus->State = HAL_SMBUS_STATE_READY;
2571
2572        /* Update SMBUS error code */
2573        hsmbus->ErrorCode |= HAL_SMBUS_ERROR_HALTIMEOUT;
2574
2575        /* Process Unlocked */
2576        __HAL_UNLOCK(hsmbus);
2577
2578        return HAL_ERROR;
2579      }
2580    }
2581  }
2582
2583  return HAL_OK;
2584}
2585
2586/**
2587  * @brief  Handle SMBUSx communication when starting transfer or during transfer (TC or TCR flag are set).
2588  * @param  hsmbus SMBUS handle.
2589  * @param  DevAddress specifies the slave address to be programmed.
2590  * @param  Size specifies the number of bytes to be programmed.
2591  *   This parameter must be a value between 0 and 255.
2592  * @param  Mode New state of the SMBUS START condition generation.
2593  *   This parameter can be one or a combination  of the following values:
2594  *     @arg @ref SMBUS_RELOAD_MODE Enable Reload mode.
2595  *     @arg @ref SMBUS_AUTOEND_MODE Enable Automatic end mode.
2596  *     @arg @ref SMBUS_SOFTEND_MODE Enable Software end mode and Reload mode.
2597  *     @arg @ref SMBUS_SENDPEC_MODE Enable Packet Error Calculation mode.
2598  * @param  Request New state of the SMBUS START condition generation.
2599  *   This parameter can be one of the following values:
2600  *     @arg @ref SMBUS_NO_STARTSTOP Don't Generate stop and start condition.
2601  *     @arg @ref SMBUS_GENERATE_STOP Generate stop condition (Size should be set to 0).
2602  *     @arg @ref SMBUS_GENERATE_START_READ Generate Restart for read request.
2603  *     @arg @ref SMBUS_GENERATE_START_WRITE Generate Restart for write request.
2604  * @retval None
2605  */
2606static void SMBUS_TransferConfig(struct __SMBUS_HandleTypeDef *hsmbus,  uint16_t DevAddress, uint8_t Size, uint32_t Mode, uint32_t Request)
2607{
2608  /* Check the parameters */
2609  assert_param(IS_SMBUS_ALL_INSTANCE(hsmbus->Instance));
2610  assert_param(IS_SMBUS_TRANSFER_MODE(Mode));
2611  assert_param(IS_SMBUS_TRANSFER_REQUEST(Request));
2612
2613  /* update CR2 register */
2614  MODIFY_REG(hsmbus->Instance->CR2, ((I2C_CR2_SADD | I2C_CR2_NBYTES | I2C_CR2_RELOAD | I2C_CR2_AUTOEND | (I2C_CR2_RD_WRN & (uint32_t)(Request >> (31UL - I2C_CR2_RD_WRN_Pos))) | I2C_CR2_START | I2C_CR2_STOP  | I2C_CR2_PECBYTE)), \
2615             (uint32_t)(((uint32_t)DevAddress & I2C_CR2_SADD) | (((uint32_t)Size << I2C_CR2_NBYTES_Pos) & I2C_CR2_NBYTES) | (uint32_t)Mode | (uint32_t)Request));
2616}
2617
2618/**
2619  * @brief  Convert SMBUSx OTHER_xxx XferOptions to functionnal XferOptions.
2620  * @param  hsmbus SMBUS handle.
2621  * @retval None
2622  */
2623static void SMBUS_ConvertOtherXferOptions(struct __SMBUS_HandleTypeDef *hsmbus)
2624{
2625  /* if user set XferOptions to SMBUS_OTHER_FRAME_NO_PEC   */
2626  /* it request implicitly to generate a restart condition */
2627  /* set XferOptions to SMBUS_FIRST_FRAME                  */
2628  if (hsmbus->XferOptions == SMBUS_OTHER_FRAME_NO_PEC)
2629  {
2630    hsmbus->XferOptions = SMBUS_FIRST_FRAME;
2631  }
2632  /* else if user set XferOptions to SMBUS_OTHER_FRAME_WITH_PEC */
2633  /* it request implicitly to generate a restart condition      */
2634  /* set XferOptions to SMBUS_FIRST_FRAME | SMBUS_SENDPEC_MODE  */
2635  else if (hsmbus->XferOptions == SMBUS_OTHER_FRAME_WITH_PEC)
2636  {
2637    hsmbus->XferOptions = SMBUS_FIRST_FRAME | SMBUS_SENDPEC_MODE;
2638  }
2639  /* else if user set XferOptions to SMBUS_OTHER_AND_LAST_FRAME_NO_PEC */
2640  /* it request implicitly to generate a restart condition             */
2641  /* then generate a stop condition at the end of transfer             */
2642  /* set XferOptions to SMBUS_FIRST_AND_LAST_FRAME_NO_PEC              */
2643  else if (hsmbus->XferOptions == SMBUS_OTHER_AND_LAST_FRAME_NO_PEC)
2644  {
2645    hsmbus->XferOptions = SMBUS_FIRST_AND_LAST_FRAME_NO_PEC;
2646  }
2647  /* else if user set XferOptions to SMBUS_OTHER_AND_LAST_FRAME_WITH_PEC */
2648  /* it request implicitly to generate a restart condition               */
2649  /* then generate a stop condition at the end of transfer               */
2650  /* set XferOptions to SMBUS_FIRST_AND_LAST_FRAME_WITH_PEC              */
2651  else if (hsmbus->XferOptions == SMBUS_OTHER_AND_LAST_FRAME_WITH_PEC)
2652  {
2653    hsmbus->XferOptions = SMBUS_FIRST_AND_LAST_FRAME_WITH_PEC;
2654  }
2655  else
2656  {
2657    /* Nothing to do */
2658  }
2659}
2660/**
2661  * @}
2662  */
2663
2664#endif /* HAL_SMBUS_MODULE_ENABLED */
2665/**
2666  * @}
2667  */
2668
2669/**
2670  * @}
2671  */
2672
2673/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Note: See TracBrowser for help on using the repository browser.