mirror of
				https://github.com/IcedRooibos/py32f0-template.git
				synced 2025-10-31 01:42:04 -07:00 
			
		
		
		
	
		
			
				
	
	
		
			7204 lines
		
	
	
		
			236 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			7204 lines
		
	
	
		
			236 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /**
 | |
|   ******************************************************************************
 | |
|   * @file    py32f0xx_hal_i2c.c
 | |
|   * @author  MCU Application Team
 | |
|   * @brief   I2C HAL module driver.
 | |
|   *          This file provides firmware functions to manage the following
 | |
|   *          functionalities of the Inter Integrated Circuit (I2C) peripheral:
 | |
|   *           + Initialization and de-initialization functions
 | |
|   *           + IO operation functions
 | |
|   *           + Peripheral State, Mode and Error functions
 | |
|   *
 | |
|   @verbatim
 | |
|   ==============================================================================
 | |
|                         ##### How to use this driver #####
 | |
|   ==============================================================================
 | |
|   [..]
 | |
|     The I2C HAL driver can be used as follows:
 | |
| 
 | |
|     (#) Declare a I2C_HandleTypeDef handle structure, for example:
 | |
|         I2C_HandleTypeDef  hi2c;
 | |
| 
 | |
|     (#)Initialize the I2C low level resources by implementing the @ref HAL_I2C_MspInit() API:
 | |
|         (##) Enable the I2Cx interface clock
 | |
|         (##) I2C pins configuration
 | |
|             (+++) Enable the clock for the I2C GPIOs
 | |
|             (+++) Configure I2C pins as alternate function open-drain
 | |
|         (##) NVIC configuration if you need to use interrupt process
 | |
|             (+++) Configure the I2Cx interrupt priority
 | |
|             (+++) Enable the NVIC I2C IRQ Channel
 | |
|         (##) DMA Configuration if you need to use DMA process
 | |
|             (+++) Declare a DMA_HandleTypeDef handle structure for the transmit or receive channel
 | |
|             (+++) Enable the DMAx interface clock using
 | |
|             (+++) Configure the DMA handle parameters
 | |
|             (+++) Configure the DMA Tx or Rx channel
 | |
|             (+++) Associate the initialized DMA handle to the hi2c DMA Tx or Rx handle
 | |
|             (+++) Configure the priority and enable the NVIC for the transfer complete interrupt on
 | |
|                   the DMA Tx or Rx channel
 | |
| 
 | |
|     (#) Configure the Communication Speed, Duty cycle, Addressing mode, Own Address1,
 | |
|         Dual Addressing mode, Own Address2, General call and Nostretch mode in the hi2c Init structure.
 | |
| 
 | |
|     (#) Initialize the I2C registers by calling the @ref HAL_I2C_Init(), configures also the low level Hardware
 | |
|         (GPIO, CLOCK, NVIC...etc) by calling the customized @ref HAL_I2C_MspInit() API.
 | |
| 
 | |
|     (#) To check if target device is ready for communication, use the function @ref HAL_I2C_IsDeviceReady()
 | |
| 
 | |
|     (#) For I2C IO and IO MEM operations, three operation modes are available within this driver :
 | |
| 
 | |
|     *** Polling mode IO operation ***
 | |
|     =================================
 | |
|     [..]
 | |
|       (+) Transmit in master mode an amount of data in blocking mode using @ref HAL_I2C_Master_Transmit()
 | |
|       (+) Receive in master mode an amount of data in blocking mode using @ref HAL_I2C_Master_Receive()
 | |
|       (+) Transmit in slave mode an amount of data in blocking mode using @ref HAL_I2C_Slave_Transmit()
 | |
|       (+) Receive in slave mode an amount of data in blocking mode using @ref HAL_I2C_Slave_Receive()
 | |
| 
 | |
|     *** Polling mode IO MEM operation ***
 | |
|     =====================================
 | |
|     [..]
 | |
|       (+) Write an amount of data in blocking mode to a specific memory address using @ref HAL_I2C_Mem_Write()
 | |
|       (+) Read an amount of data in blocking mode from a specific memory address using @ref HAL_I2C_Mem_Read()
 | |
| 
 | |
| 
 | |
|     *** Interrupt mode IO operation ***
 | |
|     ===================================
 | |
|     [..]
 | |
|       (+) Transmit in master mode an amount of data in non-blocking mode using @ref HAL_I2C_Master_Transmit_IT()
 | |
|       (+) At transmission end of transfer, @ref HAL_I2C_MasterTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MasterTxCpltCallback()
 | |
|       (+) Receive in master mode an amount of data in non-blocking mode using @ref HAL_I2C_Master_Receive_IT()
 | |
|       (+) At reception end of transfer, @ref HAL_I2C_MasterRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MasterRxCpltCallback()
 | |
|       (+) Transmit in slave mode an amount of data in non-blocking mode using @ref HAL_I2C_Slave_Transmit_IT()
 | |
|       (+) At transmission end of transfer, @ref HAL_I2C_SlaveTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_SlaveTxCpltCallback()
 | |
|       (+) Receive in slave mode an amount of data in non-blocking mode using @ref HAL_I2C_Slave_Receive_IT()
 | |
|       (+) At reception end of transfer, @ref HAL_I2C_SlaveRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_SlaveRxCpltCallback()
 | |
|       (+) In case of transfer Error, @ref HAL_I2C_ErrorCallback() function is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_ErrorCallback()
 | |
|       (+) Abort a master I2C process communication with Interrupt using @ref HAL_I2C_Master_Abort_IT()
 | |
|       (+) End of abort process, @ref HAL_I2C_AbortCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_AbortCpltCallback()
 | |
| 
 | |
|     *** Interrupt mode or DMA mode IO sequential operation ***
 | |
|     ==========================================================
 | |
|     [..]
 | |
|       (@) These interfaces allow to manage a sequential transfer with a repeated start condition
 | |
|           when a direction change during transfer
 | |
|     [..]
 | |
|       (+) A specific option field manage the different steps of a sequential transfer
 | |
|       (+) Option field values are defined through @ref I2C_XferOptions_definition and are listed below:
 | |
|       (++) I2C_FIRST_AND_LAST_FRAME: No sequential usage, functionnal is same as associated interfaces in no sequential mode
 | |
|       (++) I2C_FIRST_FRAME: Sequential usage, this option allow to manage a sequence with start condition, address
 | |
|                             and data to transfer without a final stop condition
 | |
|       (++) I2C_FIRST_AND_NEXT_FRAME: Sequential usage (Master only), this option allow to manage a sequence with start condition, address
 | |
|                             and data to transfer without a final stop condition, an then permit a call the same master sequential interface
 | |
|                             several times (like @ref HAL_I2C_Master_Seq_Transmit_IT() then @ref HAL_I2C_Master_Seq_Transmit_IT()
 | |
|                             or @ref HAL_I2C_Master_Seq_Transmit_DMA() then @ref HAL_I2C_Master_Seq_Transmit_DMA())
 | |
|       (++) I2C_NEXT_FRAME: Sequential usage, this option allow to manage a sequence with a restart condition, address
 | |
|                             and with new data to transfer if the direction change or manage only the new data to transfer
 | |
|                             if no direction change and without a final stop condition in both cases
 | |
|       (++) I2C_LAST_FRAME: Sequential usage, this option allow to manage a sequance with a restart condition, address
 | |
|                             and with new data to transfer if the direction change or manage only the new data to transfer
 | |
|                             if no direction change and with a final stop condition in both cases
 | |
|       (++) I2C_LAST_FRAME_NO_STOP: Sequential usage (Master only), this option allow to manage a restart condition after several call of the same master sequential
 | |
|                             interface several times (link with option I2C_FIRST_AND_NEXT_FRAME).
 | |
|                             Usage can, transfer several bytes one by one using HAL_I2C_Master_Seq_Transmit_IT(option I2C_FIRST_AND_NEXT_FRAME then I2C_NEXT_FRAME)
 | |
|                               or HAL_I2C_Master_Seq_Receive_IT(option I2C_FIRST_AND_NEXT_FRAME then I2C_NEXT_FRAME)
 | |
|                               or HAL_I2C_Master_Seq_Transmit_DMA(option I2C_FIRST_AND_NEXT_FRAME then I2C_NEXT_FRAME)
 | |
|                               or HAL_I2C_Master_Seq_Receive_DMA(option I2C_FIRST_AND_NEXT_FRAME then I2C_NEXT_FRAME).
 | |
|                             Then usage of this option I2C_LAST_FRAME_NO_STOP at the last Transmit or Receive sequence permit to call the oposite interface Receive or Transmit
 | |
|                               without stopping the communication and so generate a restart condition.
 | |
|       (++) I2C_OTHER_FRAME: Sequential usage (Master only), this option allow to manage a restart condition after each call of the same master sequential
 | |
|                             interface.
 | |
|                             Usage can, transfer several bytes one by one with a restart with slave address between each bytes using HAL_I2C_Master_Seq_Transmit_IT(option I2C_FIRST_FRAME then I2C_OTHER_FRAME)
 | |
|                               or HAL_I2C_Master_Seq_Receive_IT(option I2C_FIRST_FRAME then I2C_OTHER_FRAME)
 | |
|                               or HAL_I2C_Master_Seq_Transmit_DMA(option I2C_FIRST_FRAME then I2C_OTHER_FRAME)
 | |
|                               or HAL_I2C_Master_Seq_Receive_DMA(option I2C_FIRST_FRAME then I2C_OTHER_FRAME).
 | |
|                             Then usage of this option I2C_OTHER_AND_LAST_FRAME at the last frame to help automatic generation of STOP condition.
 | |
| 
 | |
|       (+) Differents sequential I2C interfaces are listed below:
 | |
|       (++) Sequential transmit in master I2C mode an amount of data in non-blocking mode using @ref HAL_I2C_Master_Seq_Transmit_IT()
 | |
|             or using @ref HAL_I2C_Master_Seq_Transmit_DMA()
 | |
|       (+++) At transmission end of current frame transfer, @ref HAL_I2C_MasterTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MasterTxCpltCallback()
 | |
|       (++) Sequential receive in master I2C mode an amount of data in non-blocking mode using @ref HAL_I2C_Master_Seq_Receive_IT()
 | |
|             or using @ref HAL_I2C_Master_Seq_Receive_DMA()
 | |
|       (+++) At reception end of current frame transfer, @ref HAL_I2C_MasterRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MasterRxCpltCallback()
 | |
|       (++) Abort a master IT or DMA I2C process communication with Interrupt using @ref HAL_I2C_Master_Abort_IT()
 | |
|       (+++) End of abort process, @ref HAL_I2C_AbortCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_AbortCpltCallback()
 | |
|       (++) Enable/disable the Address listen mode in slave I2C mode using @ref HAL_I2C_EnableListen_IT() @ref HAL_I2C_DisableListen_IT()
 | |
|       (+++) When address slave I2C match, @ref HAL_I2C_AddrCallback() is executed and user can
 | |
|            add his own code to check the Address Match Code and the transmission direction request by master (Write/Read).
 | |
|       (+++) At Listen mode end @ref HAL_I2C_ListenCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_ListenCpltCallback()
 | |
|       (++) Sequential transmit in slave I2C mode an amount of data in non-blocking mode using @ref HAL_I2C_Slave_Seq_Transmit_IT()
 | |
|             or using @ref HAL_I2C_Slave_Seq_Transmit_DMA()
 | |
|       (+++) At transmission end of current frame transfer, @ref HAL_I2C_SlaveTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_SlaveTxCpltCallback()
 | |
|       (++) Sequential receive in slave I2C mode an amount of data in non-blocking mode using @ref HAL_I2C_Slave_Seq_Receive_IT()
 | |
|             or using @ref HAL_I2C_Slave_Seq_Receive_DMA()
 | |
|       (+++) At reception end of current frame transfer, @ref HAL_I2C_SlaveRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_SlaveRxCpltCallback()
 | |
|       (++) In case of transfer Error, @ref HAL_I2C_ErrorCallback() function is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_ErrorCallback()
 | |
| 
 | |
|     *** Interrupt mode IO MEM operation ***
 | |
|     =======================================
 | |
|     [..]
 | |
|       (+) Write an amount of data in non-blocking mode with Interrupt to a specific memory address using
 | |
|           @ref HAL_I2C_Mem_Write_IT()
 | |
|       (+) At Memory end of write transfer, @ref HAL_I2C_MemTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MemTxCpltCallback()
 | |
|       (+) Read an amount of data in non-blocking mode with Interrupt from a specific memory address using
 | |
|           @ref HAL_I2C_Mem_Read_IT()
 | |
|       (+) At Memory end of read transfer, @ref HAL_I2C_MemRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MemRxCpltCallback()
 | |
|       (+) In case of transfer Error, @ref HAL_I2C_ErrorCallback() function is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_ErrorCallback()
 | |
| 
 | |
|     *** DMA mode IO operation ***
 | |
|     ==============================
 | |
|     [..]
 | |
|       (+) Transmit in master mode an amount of data in non-blocking mode (DMA) using
 | |
|           @ref HAL_I2C_Master_Transmit_DMA()
 | |
|       (+) At transmission end of transfer, @ref HAL_I2C_MasterTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MasterTxCpltCallback()
 | |
|       (+) Receive in master mode an amount of data in non-blocking mode (DMA) using
 | |
|           @ref HAL_I2C_Master_Receive_DMA()
 | |
|       (+) At reception end of transfer, @ref HAL_I2C_MasterRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MasterRxCpltCallback()
 | |
|       (+) Transmit in slave mode an amount of data in non-blocking mode (DMA) using
 | |
|           @ref HAL_I2C_Slave_Transmit_DMA()
 | |
|       (+) At transmission end of transfer, @ref HAL_I2C_SlaveTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_SlaveTxCpltCallback()
 | |
|       (+) Receive in slave mode an amount of data in non-blocking mode (DMA) using
 | |
|           @ref HAL_I2C_Slave_Receive_DMA()
 | |
|       (+) At reception end of transfer, @ref HAL_I2C_SlaveRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_SlaveRxCpltCallback()
 | |
|       (+) In case of transfer Error, @ref HAL_I2C_ErrorCallback() function is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_ErrorCallback()
 | |
|       (+) Abort a master I2C process communication with Interrupt using @ref HAL_I2C_Master_Abort_IT()
 | |
|       (+) End of abort process, @ref HAL_I2C_AbortCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_AbortCpltCallback()
 | |
| 
 | |
|     *** DMA mode IO MEM operation ***
 | |
|     =================================
 | |
|     [..]
 | |
|       (+) Write an amount of data in non-blocking mode with DMA to a specific memory address using
 | |
|           @ref HAL_I2C_Mem_Write_DMA()
 | |
|       (+) At Memory end of write transfer, @ref HAL_I2C_MemTxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MemTxCpltCallback()
 | |
|       (+) Read an amount of data in non-blocking mode with DMA from a specific memory address using
 | |
|           @ref HAL_I2C_Mem_Read_DMA()
 | |
|       (+) At Memory end of read transfer, @ref HAL_I2C_MemRxCpltCallback() is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_MemRxCpltCallback()
 | |
|       (+) In case of transfer Error, @ref HAL_I2C_ErrorCallback() function is executed and user can
 | |
|            add his own code by customization of function pointer @ref HAL_I2C_ErrorCallback()
 | |
| 
 | |
| 
 | |
|      *** I2C HAL driver macros list ***
 | |
|      ==================================
 | |
|      [..]
 | |
|        Below the list of most used macros in I2C HAL driver.
 | |
| 
 | |
|       (+) @ref __HAL_I2C_ENABLE:     Enable the I2C peripheral
 | |
|       (+) @ref __HAL_I2C_DISABLE:    Disable the I2C peripheral
 | |
|       (+) @ref __HAL_I2C_GET_FLAG:   Checks whether the specified I2C flag is set or not
 | |
|       (+) @ref __HAL_I2C_CLEAR_FLAG: Clear the specified I2C pending flag
 | |
|       (+) @ref __HAL_I2C_ENABLE_IT:  Enable the specified I2C interrupt
 | |
|       (+) @ref __HAL_I2C_DISABLE_IT: Disable the specified I2C interrupt
 | |
| 
 | |
|      *** Callback registration ***
 | |
|      =============================================
 | |
|     [..]
 | |
|      The compilation flag USE_HAL_I2C_REGISTER_CALLBACKS when set to 1
 | |
|      allows the user to configure dynamically the driver callbacks.
 | |
|      Use Functions @ref HAL_I2C_RegisterCallback() or @ref HAL_I2C_RegisterAddrCallback()
 | |
|      to register an interrupt callback.
 | |
|     [..]
 | |
|      Function @ref HAL_I2C_RegisterCallback() allows to register following callbacks:
 | |
|        (+) MasterTxCpltCallback : callback for Master transmission end of transfer.
 | |
|        (+) MasterRxCpltCallback : callback for Master reception end of transfer.
 | |
|        (+) SlaveTxCpltCallback  : callback for Slave transmission end of transfer.
 | |
|        (+) SlaveRxCpltCallback  : callback for Slave reception end of transfer.
 | |
|        (+) ListenCpltCallback   : callback for end of listen mode.
 | |
|        (+) MemTxCpltCallback    : callback for Memory transmission end of transfer.
 | |
|        (+) MemRxCpltCallback    : callback for Memory reception end of transfer.
 | |
|        (+) ErrorCallback        : callback for error detection.
 | |
|        (+) AbortCpltCallback    : callback for abort completion process.
 | |
|        (+) MspInitCallback      : callback for Msp Init.
 | |
|        (+) MspDeInitCallback    : callback for Msp DeInit.
 | |
|      This function takes as parameters the HAL peripheral handle, the Callback ID
 | |
|      and a pointer to the user callback function.
 | |
|     [..]
 | |
|      For specific callback AddrCallback use dedicated register callbacks : @ref HAL_I2C_RegisterAddrCallback().
 | |
|     [..]
 | |
|      Use function @ref HAL_I2C_UnRegisterCallback to reset a callback to the default
 | |
|      weak function.
 | |
|      @ref HAL_I2C_UnRegisterCallback takes as parameters the HAL peripheral handle,
 | |
|      and the Callback ID.
 | |
|      This function allows to reset following callbacks:
 | |
|        (+) MasterTxCpltCallback : callback for Master transmission end of transfer.
 | |
|        (+) MasterRxCpltCallback : callback for Master reception end of transfer.
 | |
|        (+) SlaveTxCpltCallback  : callback for Slave transmission end of transfer.
 | |
|        (+) SlaveRxCpltCallback  : callback for Slave reception end of transfer.
 | |
|        (+) ListenCpltCallback   : callback for end of listen mode.
 | |
|        (+) MemTxCpltCallback    : callback for Memory transmission end of transfer.
 | |
|        (+) MemRxCpltCallback    : callback for Memory reception end of transfer.
 | |
|        (+) ErrorCallback        : callback for error detection.
 | |
|        (+) AbortCpltCallback    : callback for abort completion process.
 | |
|        (+) MspInitCallback      : callback for Msp Init.
 | |
|        (+) MspDeInitCallback    : callback for Msp DeInit.
 | |
|     [..]
 | |
|      For callback AddrCallback use dedicated register callbacks : @ref HAL_I2C_UnRegisterAddrCallback().
 | |
|     [..]
 | |
|      By default, after the @ref HAL_I2C_Init() and when the state is @ref HAL_I2C_STATE_RESET
 | |
|      all callbacks are set to the corresponding weak functions:
 | |
|      examples @ref HAL_I2C_MasterTxCpltCallback(), @ref HAL_I2C_MasterRxCpltCallback().
 | |
|      Exception done for MspInit and MspDeInit functions that are
 | |
|      reset to the legacy weak functions in the @ref HAL_I2C_Init()/ @ref HAL_I2C_DeInit() only when
 | |
|      these callbacks are null (not registered beforehand).
 | |
|      If MspInit or MspDeInit are not null, the @ref HAL_I2C_Init()/ @ref HAL_I2C_DeInit()
 | |
|      keep and use the user MspInit/MspDeInit callbacks (registered beforehand) whatever the state.
 | |
|     [..]
 | |
|      Callbacks can be registered/unregistered in @ref HAL_I2C_STATE_READY state only.
 | |
|      Exception done MspInit/MspDeInit functions that can be registered/unregistered
 | |
|      in @ref HAL_I2C_STATE_READY or @ref HAL_I2C_STATE_RESET state,
 | |
|      thus registered (user) MspInit/DeInit callbacks can be used during the Init/DeInit.
 | |
|      Then, the user first registers the MspInit/MspDeInit user callbacks
 | |
|      using @ref HAL_I2C_RegisterCallback() before calling @ref HAL_I2C_DeInit()
 | |
|      or @ref HAL_I2C_Init() function.
 | |
|     [..]
 | |
|      When the compilation flag USE_HAL_I2C_REGISTER_CALLBACKS is set to 0 or
 | |
|      not defined, the callback registration feature is not available and all callbacks
 | |
|      are set to the corresponding weak functions.
 | |
| 
 | |
| 
 | |
|      *** I2C Workarounds linked to Silicon Limitation ***
 | |
|      ====================================================
 | |
|      [..]
 | |
|        Below the list of all silicon limitations implemented for HAL on PY32F0xx product.
 | |
|        (@) See ErrataSheet to know full silicon limitation list of your product.
 | |
| 
 | |
|        (+) Workarounds Implemented inside I2C HAL Driver
 | |
|           (++) Wrong data read into data register (Polling and Interrupt mode)
 | |
|           (++) Start cannot be generated after a misplaced Stop
 | |
|           (++) Some software events must be managed before the current byte is being transferred:
 | |
|                Workaround: Use DMA in general, except when the Master is receiving a single byte.
 | |
|                For Interupt mode, I2C should have the highest priority in the application.
 | |
|           (++) Mismatch on the "Setup time for a repeated Start condition" timing parameter:
 | |
|                Workaround: Reduce the frequency down to 88 kHz or use the I2C Fast-mode if
 | |
|                supported by the slave.
 | |
|           (++) Data valid time (tVD;DAT) violated without the OVR flag being set:
 | |
|                Workaround: If the slave device allows it, use the clock stretching mechanism
 | |
|                by programming NoStretchMode = I2C_NOSTRETCH_DISABLE in @ref HAL_I2C_Init.
 | |
| 
 | |
|      [..]
 | |
|        (@) You can refer to the I2C HAL driver header file for more useful macros
 | |
| 
 | |
|   @endverbatim
 | |
| 
 | |
|   ******************************************************************************
 | |
|   * @attention
 | |
|   *
 | |
|   * <h2><center>© Copyright (c) Puya Semiconductor Co.
 | |
|   * All rights reserved.</center></h2>
 | |
|   *
 | |
|   * <h2><center>© Copyright (c) 2016 STMicroelectronics.
 | |
|   * All rights reserved.</center></h2>
 | |
|   *
 | |
|   * This software component is licensed by ST under BSD 3-Clause license,
 | |
|   * the "License"; You may not use this file except in compliance with the
 | |
|   * License. You may obtain a copy of the License at:
 | |
|   *                        opensource.org/licenses/BSD-3-Clause
 | |
|   *
 | |
|   ******************************************************************************
 | |
|   */
 | |
| 
 | |
| /* Includes ------------------------------------------------------------------*/
 | |
| #include "py32f0xx_hal.h"
 | |
| #include "py32f0xx_hal_i2c.h"
 | |
| /** @addtogroup PY32F0xx_HAL_Driver
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /** @defgroup I2C I2C
 | |
|   * @brief I2C HAL module driver
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| #ifdef HAL_I2C_MODULE_ENABLED
 | |
| 
 | |
| /* Private typedef -----------------------------------------------------------*/
 | |
| /* Private define ------------------------------------------------------------*/
 | |
| /** @addtogroup I2C_Private_Define
 | |
|   * @{
 | |
|   */
 | |
| #define TIMING_CLEAR_MASK   (0xF0FFFFFFU)  /*!< I2C TIMING clear register Mask */
 | |
| #define I2C_TIMEOUT_ADDR    (10000U)       /*!< 10 s  */
 | |
| #define I2C_TIMEOUT_BUSY    (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_DIR     (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_RXNE    (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_STOPF   (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_TC      (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_TCR     (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_TXIS    (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_FLAG    (25U)          /*!< 25 ms */
 | |
| #define I2C_TIMEOUT_BUSY_FLAG     25U         /*!< Timeout 25 ms             */
 | |
| #define I2C_NO_OPTION_FRAME       0xFFFF0000U /*!< XferOptions default value */
 | |
| 
 | |
| /* Private define for @ref PreviousState usage */
 | |
| #define I2C_STATE_MSK             ((uint32_t)((uint32_t)((uint32_t)HAL_I2C_STATE_BUSY_TX | (uint32_t)HAL_I2C_STATE_BUSY_RX) & (uint32_t)(~((uint32_t)HAL_I2C_STATE_READY)))) /*!< Mask State define, keep only RX and TX bits            */
 | |
| #define I2C_STATE_NONE            ((uint32_t)(HAL_I2C_MODE_NONE))                                                        /*!< Default Value                                          */
 | |
| #define I2C_STATE_MASTER_BUSY_TX  ((uint32_t)(((uint32_t)HAL_I2C_STATE_BUSY_TX & I2C_STATE_MSK) | (uint32_t)HAL_I2C_MODE_MASTER))            /*!< Master Busy TX, combinaison of State LSB and Mode enum */
 | |
| #define I2C_STATE_MASTER_BUSY_RX  ((uint32_t)(((uint32_t)HAL_I2C_STATE_BUSY_RX & I2C_STATE_MSK) | (uint32_t)HAL_I2C_MODE_MASTER))            /*!< Master Busy RX, combinaison of State LSB and Mode enum */
 | |
| #define I2C_STATE_SLAVE_BUSY_TX   ((uint32_t)(((uint32_t)HAL_I2C_STATE_BUSY_TX & I2C_STATE_MSK) | (uint32_t)HAL_I2C_MODE_SLAVE))             /*!< Slave Busy TX, combinaison of State LSB and Mode enum  */
 | |
| #define I2C_STATE_SLAVE_BUSY_RX   ((uint32_t)(((uint32_t)HAL_I2C_STATE_BUSY_RX & I2C_STATE_MSK) | (uint32_t)HAL_I2C_MODE_SLAVE))             /*!< Slave Busy RX, combinaison of State LSB and Mode enum  */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /* Private macro -------------------------------------------------------------*/
 | |
| /* Private variables ---------------------------------------------------------*/
 | |
| /* Private function prototypes -----------------------------------------------*/
 | |
| 
 | |
| /** @defgroup I2C_Private_Functions I2C Private Functions
 | |
|   * @{
 | |
|   */
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /* Private functions to handle DMA transfer */
 | |
| static void I2C_DMAXferCplt(DMA_HandleTypeDef *hdma);
 | |
| static void I2C_DMAError(DMA_HandleTypeDef *hdma);
 | |
| static void I2C_DMAAbort(DMA_HandleTypeDef *hdma);
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| static void I2C_ITError(I2C_HandleTypeDef *hi2c);
 | |
| 
 | |
| static HAL_StatusTypeDef I2C_MasterRequestWrite(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_MasterRequestRead(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_RequestMemoryWrite(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_RequestMemoryRead(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint32_t Timeout, uint32_t Tickstart);
 | |
| 
 | |
| /* Private functions to handle flags during polling transfer */
 | |
| static HAL_StatusTypeDef I2C_WaitOnFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Flag, FlagStatus Status, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_WaitOnMasterAddressFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Flag, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_WaitOnTXEFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_WaitOnBTFFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_WaitOnRXNEFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_WaitOnSTOPFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart);
 | |
| static HAL_StatusTypeDef I2C_IsAcknowledgeFailed(I2C_HandleTypeDef *hi2c);
 | |
| 
 | |
| /* Private functions for I2C transfer IRQ handler */
 | |
| static void I2C_MasterTransmit_TXE(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_MasterTransmit_BTF(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_MasterReceive_RXNE(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_MasterReceive_BTF(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_Master_SB(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_Master_ADD10(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_Master_ADDR(I2C_HandleTypeDef *hi2c);
 | |
| 
 | |
| static void I2C_SlaveTransmit_TXE(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_SlaveTransmit_BTF(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_SlaveReceive_RXNE(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_SlaveReceive_BTF(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_Slave_ADDR(I2C_HandleTypeDef *hi2c, uint32_t IT2Flags);
 | |
| static void I2C_Slave_STOPF(I2C_HandleTypeDef *hi2c);
 | |
| static void I2C_Slave_AF(I2C_HandleTypeDef *hi2c);
 | |
| 
 | |
| /* Private function to Convert Specific options */
 | |
| static void I2C_ConvertOtherXferOptions(I2C_HandleTypeDef *hi2c);
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /* Exported functions --------------------------------------------------------*/
 | |
| 
 | |
| /** @defgroup I2C_Exported_Functions I2C Exported Functions
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /** @defgroup I2C_Exported_Functions_Group1 Initialization and de-initialization functions
 | |
|  *  @brief    Initialization and Configuration functions
 | |
|  *
 | |
| @verbatim
 | |
|  ===============================================================================
 | |
|               ##### Initialization and de-initialization functions #####
 | |
|  ===============================================================================
 | |
|     [..]  This subsection provides a set of functions allowing to initialize and
 | |
|           deinitialize the I2Cx peripheral:
 | |
| 
 | |
|       (+) User must Implement HAL_I2C_MspInit() function in which he configures
 | |
|           all related peripherals resources (CLOCK, GPIO, DMA, IT and NVIC).
 | |
| 
 | |
|       (+) Call the function HAL_I2C_Init() to configure the selected device with
 | |
|           the selected configuration:
 | |
|         (++) Communication Speed
 | |
|         (++) Duty cycle
 | |
|         (++) Addressing mode
 | |
|         (++) Own Address 1
 | |
|         (++) Dual Addressing mode
 | |
|         (++) Own Address 2
 | |
|         (++) General call mode
 | |
|         (++) Nostretch mode
 | |
| 
 | |
|       (+) Call the function HAL_I2C_DeInit() to restore the default configuration
 | |
|           of the selected I2Cx peripheral.
 | |
| 
 | |
| @endverbatim
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @brief  Initializes the I2C according to the specified parameters
 | |
|   *         in the I2C_InitTypeDef and initialize the associated handle.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Init(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   uint32_t freqrange;
 | |
|   uint32_t pclk1;
 | |
| 
 | |
|   /* Check the I2C handle allocation */
 | |
|   if (hi2c == NULL)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
 | |
|   assert_param(IS_I2C_CLOCK_SPEED(hi2c->Init.ClockSpeed));
 | |
|   assert_param(IS_I2C_DUTY_CYCLE(hi2c->Init.DutyCycle));
 | |
|   assert_param(IS_I2C_OWN_ADDRESS1(hi2c->Init.OwnAddress1));
 | |
|   assert_param(IS_I2C_GENERAL_CALL(hi2c->Init.GeneralCallMode));
 | |
|   assert_param(IS_I2C_NO_STRETCH(hi2c->Init.NoStretchMode));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_RESET)
 | |
|   {
 | |
|     /* Allocate lock resource and initialize it */
 | |
|     hi2c->Lock = HAL_UNLOCKED;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     /* Init the I2C Callback settings */
 | |
|     hi2c->MasterTxCpltCallback = HAL_I2C_MasterTxCpltCallback; /* Legacy weak MasterTxCpltCallback */
 | |
|     hi2c->MasterRxCpltCallback = HAL_I2C_MasterRxCpltCallback; /* Legacy weak MasterRxCpltCallback */
 | |
|     hi2c->SlaveTxCpltCallback  = HAL_I2C_SlaveTxCpltCallback;  /* Legacy weak SlaveTxCpltCallback  */
 | |
|     hi2c->SlaveRxCpltCallback  = HAL_I2C_SlaveRxCpltCallback;  /* Legacy weak SlaveRxCpltCallback  */
 | |
|     hi2c->ListenCpltCallback   = HAL_I2C_ListenCpltCallback;   /* Legacy weak ListenCpltCallback   */
 | |
|     hi2c->MemTxCpltCallback    = HAL_I2C_MemTxCpltCallback;    /* Legacy weak MemTxCpltCallback    */
 | |
|     hi2c->MemRxCpltCallback    = HAL_I2C_MemRxCpltCallback;    /* Legacy weak MemRxCpltCallback    */
 | |
|     hi2c->ErrorCallback        = HAL_I2C_ErrorCallback;        /* Legacy weak ErrorCallback        */
 | |
|     hi2c->AbortCpltCallback    = HAL_I2C_AbortCpltCallback;    /* Legacy weak AbortCpltCallback    */
 | |
|     hi2c->AddrCallback         = HAL_I2C_AddrCallback;         /* Legacy weak AddrCallback         */
 | |
| 
 | |
|     if (hi2c->MspInitCallback == NULL)
 | |
|     {
 | |
|       hi2c->MspInitCallback = HAL_I2C_MspInit; /* Legacy weak MspInit  */
 | |
|     }
 | |
| 
 | |
|     /* Init the low level hardware : GPIO, CLOCK, NVIC */
 | |
|     hi2c->MspInitCallback(hi2c);
 | |
| #else
 | |
|     /* Init the low level hardware : GPIO, CLOCK, NVIC */
 | |
|     HAL_I2C_MspInit(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
| 
 | |
|   hi2c->State = HAL_I2C_STATE_BUSY;
 | |
| 
 | |
|   /* Disable the selected I2C peripheral */
 | |
|   __HAL_I2C_DISABLE(hi2c);
 | |
| 
 | |
|   /* Get PCLK1 frequency */
 | |
|   pclk1 = HAL_RCC_GetPCLK1Freq();
 | |
| 
 | |
|   /* Check the minimum allowed PCLK1 frequency */
 | |
|   if (I2C_MIN_PCLK_FREQ(pclk1, hi2c->Init.ClockSpeed) == 1U)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Calculate frequency range */
 | |
|   freqrange = I2C_FREQRANGE(pclk1);
 | |
| 
 | |
|   /*---------------------------- I2Cx CR2 Configuration ----------------------*/
 | |
|   /* Configure I2Cx: Frequency range */
 | |
|   MODIFY_REG(hi2c->Instance->CR2, I2C_CR2_FREQ, freqrange);
 | |
| 
 | |
|   /*---------------------------- I2Cx TRISE Configuration --------------------*/
 | |
|   /* Configure I2Cx: Rise Time */
 | |
|   MODIFY_REG(hi2c->Instance->TRISE, I2C_TRISE_TRISE, I2C_RISE_TIME(freqrange, hi2c->Init.ClockSpeed));
 | |
| 
 | |
|   /*---------------------------- I2Cx CCR Configuration ----------------------*/
 | |
|   /* Configure I2Cx: Speed */
 | |
|   MODIFY_REG(hi2c->Instance->CCR, (I2C_CCR_FS | I2C_CCR_DUTY | I2C_CCR_CCR), I2C_SPEED(pclk1, hi2c->Init.ClockSpeed, hi2c->Init.DutyCycle));
 | |
| 
 | |
|   /*---------------------------- I2Cx CR1 Configuration ----------------------*/
 | |
|   /* Configure I2Cx: Generalcall and NoStretch mode */
 | |
|   MODIFY_REG(hi2c->Instance->CR1, (I2C_CR1_ENGC | I2C_CR1_NOSTRETCH), (hi2c->Init.GeneralCallMode | hi2c->Init.NoStretchMode));
 | |
| 
 | |
|   /*---------------------------- I2Cx OAR1 Configuration ---------------------*/
 | |
|   /* Configure I2Cx: Own Address1 and addressing mode */
 | |
|   MODIFY_REG(hi2c->Instance->OAR1, ( I2C_OAR1_ADD1_7 ), (hi2c->Init.OwnAddress1));
 | |
| 
 | |
|   /* Enable the selected I2C peripheral */
 | |
|   __HAL_I2C_ENABLE(hi2c);
 | |
| 
 | |
|   hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
|   hi2c->State = HAL_I2C_STATE_READY;
 | |
|   hi2c->PreviousState = I2C_STATE_NONE;
 | |
|   hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  DeInitialize the I2C peripheral.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_DeInit(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Check the I2C handle allocation */
 | |
|   if (hi2c == NULL)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
 | |
| 
 | |
|   hi2c->State = HAL_I2C_STATE_BUSY;
 | |
| 
 | |
|   /* Disable the I2C Peripheral Clock */
 | |
|   __HAL_I2C_DISABLE(hi2c);
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|   if (hi2c->MspDeInitCallback == NULL)
 | |
|   {
 | |
|     hi2c->MspDeInitCallback = HAL_I2C_MspDeInit; /* Legacy weak MspDeInit  */
 | |
|   }
 | |
| 
 | |
|   /* DeInit the low level hardware: GPIO, CLOCK, NVIC */
 | |
|   hi2c->MspDeInitCallback(hi2c);
 | |
| #else
 | |
|   /* DeInit the low level hardware: GPIO, CLOCK, NVIC */
 | |
|   HAL_I2C_MspDeInit(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
| 
 | |
|   hi2c->ErrorCode     = HAL_I2C_ERROR_NONE;
 | |
|   hi2c->State         = HAL_I2C_STATE_RESET;
 | |
|   hi2c->PreviousState = I2C_STATE_NONE;
 | |
|   hi2c->Mode          = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|   /* Release Lock */
 | |
|   __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Initialize the I2C MSP.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_MspInit could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  DeInitialize the I2C MSP.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_MspDeInit(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_MspDeInit could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
| /**
 | |
|   * @brief  Register a User I2C Callback
 | |
|   *         To be used instead of the weak predefined callback
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  CallbackID ID of the callback to be registered
 | |
|   *         This parameter can be one of the following values:
 | |
|   *          @arg @ref HAL_I2C_MASTER_TX_COMPLETE_CB_ID Master Tx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_MASTER_RX_COMPLETE_CB_ID Master Rx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_SLAVE_TX_COMPLETE_CB_ID Slave Tx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_SLAVE_RX_COMPLETE_CB_ID Slave Rx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_LISTEN_COMPLETE_CB_ID Listen Complete callback ID
 | |
|   *          @arg @ref HAL_I2C_MEM_TX_COMPLETE_CB_ID Memory Tx Transfer callback ID
 | |
|   *          @arg @ref HAL_I2C_MEM_RX_COMPLETE_CB_ID Memory Rx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_ERROR_CB_ID Error callback ID
 | |
|   *          @arg @ref HAL_I2C_ABORT_CB_ID Abort callback ID
 | |
|   *          @arg @ref HAL_I2C_MSPINIT_CB_ID MspInit callback ID
 | |
|   *          @arg @ref HAL_I2C_MSPDEINIT_CB_ID MspDeInit callback ID
 | |
|   * @param  pCallback pointer to the Callback function
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_RegisterCallback(I2C_HandleTypeDef *hi2c, HAL_I2C_CallbackIDTypeDef CallbackID, pI2C_CallbackTypeDef pCallback)
 | |
| {
 | |
|   HAL_StatusTypeDef status = HAL_OK;
 | |
| 
 | |
|   if (pCallback == NULL)
 | |
|   {
 | |
|     /* Update the error code */
 | |
|     hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
|   /* Process locked */
 | |
|   __HAL_LOCK(hi2c);
 | |
| 
 | |
|   if (HAL_I2C_STATE_READY == hi2c->State)
 | |
|   {
 | |
|     switch (CallbackID)
 | |
|     {
 | |
|     case HAL_I2C_MASTER_TX_COMPLETE_CB_ID :
 | |
|       hi2c->MasterTxCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MASTER_RX_COMPLETE_CB_ID :
 | |
|       hi2c->MasterRxCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_SLAVE_TX_COMPLETE_CB_ID :
 | |
|       hi2c->SlaveTxCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_SLAVE_RX_COMPLETE_CB_ID :
 | |
|       hi2c->SlaveRxCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_LISTEN_COMPLETE_CB_ID :
 | |
|       hi2c->ListenCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MEM_TX_COMPLETE_CB_ID :
 | |
|       hi2c->MemTxCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MEM_RX_COMPLETE_CB_ID :
 | |
|       hi2c->MemRxCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_ERROR_CB_ID :
 | |
|       hi2c->ErrorCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_ABORT_CB_ID :
 | |
|       hi2c->AbortCpltCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MSPINIT_CB_ID :
 | |
|       hi2c->MspInitCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MSPDEINIT_CB_ID :
 | |
|       hi2c->MspDeInitCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     default :
 | |
|       /* Update the error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|       /* Return error status */
 | |
|       status =  HAL_ERROR;
 | |
|       break;
 | |
|     }
 | |
|   }
 | |
|   else if (HAL_I2C_STATE_RESET == hi2c->State)
 | |
|   {
 | |
|     switch (CallbackID)
 | |
|     {
 | |
|     case HAL_I2C_MSPINIT_CB_ID :
 | |
|       hi2c->MspInitCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MSPDEINIT_CB_ID :
 | |
|       hi2c->MspDeInitCallback = pCallback;
 | |
|       break;
 | |
| 
 | |
|     default :
 | |
|       /* Update the error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|       /* Return error status */
 | |
|       status =  HAL_ERROR;
 | |
|       break;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Update the error code */
 | |
|     hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|     /* Return error status */
 | |
|     status =  HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Release Lock */
 | |
|   __HAL_UNLOCK(hi2c);
 | |
|   return status;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Unregister an I2C Callback
 | |
|   *         I2C callback is redirected to the weak predefined callback
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  CallbackID ID of the callback to be unregistered
 | |
|   *         This parameter can be one of the following values:
 | |
|   *         This parameter can be one of the following values:
 | |
|   *          @arg @ref HAL_I2C_MASTER_TX_COMPLETE_CB_ID Master Tx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_MASTER_RX_COMPLETE_CB_ID Master Rx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_SLAVE_TX_COMPLETE_CB_ID Slave Tx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_SLAVE_RX_COMPLETE_CB_ID Slave Rx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_LISTEN_COMPLETE_CB_ID Listen Complete callback ID
 | |
|   *          @arg @ref HAL_I2C_MEM_TX_COMPLETE_CB_ID Memory Tx Transfer callback ID
 | |
|   *          @arg @ref HAL_I2C_MEM_RX_COMPLETE_CB_ID Memory Rx Transfer completed callback ID
 | |
|   *          @arg @ref HAL_I2C_ERROR_CB_ID Error callback ID
 | |
|   *          @arg @ref HAL_I2C_ABORT_CB_ID Abort callback ID
 | |
|   *          @arg @ref HAL_I2C_MSPINIT_CB_ID MspInit callback ID
 | |
|   *          @arg @ref HAL_I2C_MSPDEINIT_CB_ID MspDeInit callback ID
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_UnRegisterCallback(I2C_HandleTypeDef *hi2c, HAL_I2C_CallbackIDTypeDef CallbackID)
 | |
| {
 | |
|   HAL_StatusTypeDef status = HAL_OK;
 | |
| 
 | |
|   /* Process locked */
 | |
|   __HAL_LOCK(hi2c);
 | |
| 
 | |
|   if (HAL_I2C_STATE_READY == hi2c->State)
 | |
|   {
 | |
|     switch (CallbackID)
 | |
|     {
 | |
|     case HAL_I2C_MASTER_TX_COMPLETE_CB_ID :
 | |
|       hi2c->MasterTxCpltCallback = HAL_I2C_MasterTxCpltCallback; /* Legacy weak MasterTxCpltCallback */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MASTER_RX_COMPLETE_CB_ID :
 | |
|       hi2c->MasterRxCpltCallback = HAL_I2C_MasterRxCpltCallback; /* Legacy weak MasterRxCpltCallback */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_SLAVE_TX_COMPLETE_CB_ID :
 | |
|       hi2c->SlaveTxCpltCallback = HAL_I2C_SlaveTxCpltCallback;   /* Legacy weak SlaveTxCpltCallback  */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_SLAVE_RX_COMPLETE_CB_ID :
 | |
|       hi2c->SlaveRxCpltCallback = HAL_I2C_SlaveRxCpltCallback;   /* Legacy weak SlaveRxCpltCallback  */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_LISTEN_COMPLETE_CB_ID :
 | |
|       hi2c->ListenCpltCallback = HAL_I2C_ListenCpltCallback;     /* Legacy weak ListenCpltCallback   */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MEM_TX_COMPLETE_CB_ID :
 | |
|       hi2c->MemTxCpltCallback = HAL_I2C_MemTxCpltCallback;       /* Legacy weak MemTxCpltCallback    */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MEM_RX_COMPLETE_CB_ID :
 | |
|       hi2c->MemRxCpltCallback = HAL_I2C_MemRxCpltCallback;       /* Legacy weak MemRxCpltCallback    */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_ERROR_CB_ID :
 | |
|       hi2c->ErrorCallback = HAL_I2C_ErrorCallback;               /* Legacy weak ErrorCallback        */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_ABORT_CB_ID :
 | |
|       hi2c->AbortCpltCallback = HAL_I2C_AbortCpltCallback;       /* Legacy weak AbortCpltCallback    */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MSPINIT_CB_ID :
 | |
|       hi2c->MspInitCallback = HAL_I2C_MspInit;                   /* Legacy weak MspInit              */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MSPDEINIT_CB_ID :
 | |
|       hi2c->MspDeInitCallback = HAL_I2C_MspDeInit;               /* Legacy weak MspDeInit            */
 | |
|       break;
 | |
| 
 | |
|     default :
 | |
|       /* Update the error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|       /* Return error status */
 | |
|       status =  HAL_ERROR;
 | |
|       break;
 | |
|     }
 | |
|   }
 | |
|   else if (HAL_I2C_STATE_RESET == hi2c->State)
 | |
|   {
 | |
|     switch (CallbackID)
 | |
|     {
 | |
|     case HAL_I2C_MSPINIT_CB_ID :
 | |
|       hi2c->MspInitCallback = HAL_I2C_MspInit;                   /* Legacy weak MspInit              */
 | |
|       break;
 | |
| 
 | |
|     case HAL_I2C_MSPDEINIT_CB_ID :
 | |
|       hi2c->MspDeInitCallback = HAL_I2C_MspDeInit;               /* Legacy weak MspDeInit            */
 | |
|       break;
 | |
| 
 | |
|     default :
 | |
|       /* Update the error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|       /* Return error status */
 | |
|       status =  HAL_ERROR;
 | |
|       break;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Update the error code */
 | |
|     hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|     /* Return error status */
 | |
|     status =  HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Release Lock */
 | |
|   __HAL_UNLOCK(hi2c);
 | |
|   return status;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Register the Slave Address Match I2C Callback
 | |
|   *         To be used instead of the weak HAL_I2C_AddrCallback() predefined callback
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  pCallback pointer to the Address Match Callback function
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_RegisterAddrCallback(I2C_HandleTypeDef *hi2c, pI2C_AddrCallbackTypeDef pCallback)
 | |
| {
 | |
|   HAL_StatusTypeDef status = HAL_OK;
 | |
| 
 | |
|   if (pCallback == NULL)
 | |
|   {
 | |
|     /* Update the error code */
 | |
|     hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
|   /* Process locked */
 | |
|   __HAL_LOCK(hi2c);
 | |
| 
 | |
|   if (HAL_I2C_STATE_READY == hi2c->State)
 | |
|   {
 | |
|     hi2c->AddrCallback = pCallback;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Update the error code */
 | |
|     hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|     /* Return error status */
 | |
|     status =  HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Release Lock */
 | |
|   __HAL_UNLOCK(hi2c);
 | |
|   return status;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  UnRegister the Slave Address Match I2C Callback
 | |
|   *         Info Ready I2C Callback is redirected to the weak HAL_I2C_AddrCallback() predefined callback
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_UnRegisterAddrCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   HAL_StatusTypeDef status = HAL_OK;
 | |
| 
 | |
|   /* Process locked */
 | |
|   __HAL_LOCK(hi2c);
 | |
| 
 | |
|   if (HAL_I2C_STATE_READY == hi2c->State)
 | |
|   {
 | |
|     hi2c->AddrCallback = HAL_I2C_AddrCallback; /* Legacy weak AddrCallback  */
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Update the error code */
 | |
|     hi2c->ErrorCode |= HAL_I2C_ERROR_INVALID_CALLBACK;
 | |
| 
 | |
|     /* Return error status */
 | |
|     status =  HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Release Lock */
 | |
|   __HAL_UNLOCK(hi2c);
 | |
|   return status;
 | |
| }
 | |
| 
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup I2C_Exported_Functions_Group2 Input and Output operation functions
 | |
|  *  @brief   Data transfers functions
 | |
|  *
 | |
| @verbatim
 | |
|  ===============================================================================
 | |
|                       ##### IO operation functions #####
 | |
|  ===============================================================================
 | |
|     [..]
 | |
|     This subsection provides a set of functions allowing to manage the I2C data
 | |
|     transfers.
 | |
| 
 | |
|     (#) There are two modes of transfer:
 | |
|        (++) Blocking mode : The communication is performed in the polling mode.
 | |
|             The status of all data processing is returned by the same function
 | |
|             after finishing transfer.
 | |
|        (++) No-Blocking mode : The communication is performed using Interrupts
 | |
|             or DMA. These functions return the status of the transfer startup.
 | |
|             The end of the data processing will be indicated through the
 | |
|             dedicated I2C IRQ when using Interrupt mode or the DMA IRQ when
 | |
|             using DMA mode.
 | |
| 
 | |
|     (#) Blocking mode functions are :
 | |
|         (++) HAL_I2C_Master_Transmit()
 | |
|         (++) HAL_I2C_Master_Receive()
 | |
|         (++) HAL_I2C_Slave_Transmit()
 | |
|         (++) HAL_I2C_Slave_Receive()
 | |
|         (++) HAL_I2C_Mem_Write()
 | |
|         (++) HAL_I2C_Mem_Read()
 | |
|         (++) HAL_I2C_IsDeviceReady()
 | |
| 
 | |
|     (#) No-Blocking mode functions with Interrupt are :
 | |
|         (++) HAL_I2C_Master_Transmit_IT()
 | |
|         (++) HAL_I2C_Master_Receive_IT()
 | |
|         (++) HAL_I2C_Slave_Transmit_IT()
 | |
|         (++) HAL_I2C_Slave_Receive_IT()
 | |
|         (++) HAL_I2C_Mem_Write_IT()
 | |
|         (++) HAL_I2C_Mem_Read_IT()
 | |
|         (++) HAL_I2C_Master_Seq_Transmit_IT()
 | |
|         (++) HAL_I2C_Master_Seq_Receive_IT()
 | |
|         (++) HAL_I2C_Slave_Seq_Transmit_IT()
 | |
|         (++) HAL_I2C_Slave_Seq_Receive_IT()
 | |
|         (++) HAL_I2C_EnableListen_IT()
 | |
|         (++) HAL_I2C_DisableListen_IT()
 | |
|         (++) HAL_I2C_Master_Abort_IT()
 | |
| 
 | |
|     (#) No-Blocking mode functions with DMA are :
 | |
|         (++) HAL_I2C_Master_Transmit_DMA()
 | |
|         (++) HAL_I2C_Master_Receive_DMA()
 | |
|         (++) HAL_I2C_Slave_Transmit_DMA()
 | |
|         (++) HAL_I2C_Slave_Receive_DMA()
 | |
|         (++) HAL_I2C_Mem_Write_DMA()
 | |
|         (++) HAL_I2C_Mem_Read_DMA()
 | |
|         (++) HAL_I2C_Master_Seq_Transmit_DMA()
 | |
|         (++) HAL_I2C_Master_Seq_Receive_DMA()
 | |
|         (++) HAL_I2C_Slave_Seq_Transmit_DMA()
 | |
|         (++) HAL_I2C_Slave_Seq_Receive_DMA()
 | |
| 
 | |
|     (#) A set of Transfer Complete Callbacks are provided in non Blocking mode:
 | |
|         (++) HAL_I2C_MasterTxCpltCallback()
 | |
|         (++) HAL_I2C_MasterRxCpltCallback()
 | |
|         (++) HAL_I2C_SlaveTxCpltCallback()
 | |
|         (++) HAL_I2C_SlaveRxCpltCallback()
 | |
|         (++) HAL_I2C_MemTxCpltCallback()
 | |
|         (++) HAL_I2C_MemRxCpltCallback()
 | |
|         (++) HAL_I2C_AddrCallback()
 | |
|         (++) HAL_I2C_ListenCpltCallback()
 | |
|         (++) HAL_I2C_ErrorCallback()
 | |
|         (++) HAL_I2C_AbortCpltCallback()
 | |
| 
 | |
| @endverbatim
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @brief  Transmits in master mode an amount of data in blocking mode.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_BUSY;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State       = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode        = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode   = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Send Slave Address */
 | |
|     if (I2C_MasterRequestWrite(hi2c, DevAddress, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Clear ADDR flag */
 | |
|     __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|     while (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Wait until TXE flag is set */
 | |
|       if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|       {
 | |
|         if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|         {
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|         }
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
| 
 | |
|       /* Write data to DR */
 | |
|       hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferCount--;
 | |
|       hi2c->XferSize--;
 | |
| 
 | |
|       if ((__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == SET) && (hi2c->XferSize != 0U))
 | |
|       {
 | |
|         /* Write data to DR */
 | |
|         hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|         /* Increment Buffer pointer */
 | |
|         hi2c->pBuffPtr++;
 | |
| 
 | |
|         /* Update counter */
 | |
|         hi2c->XferCount--;
 | |
|         hi2c->XferSize--;
 | |
|       }
 | |
|       /* Wait until BTF flag is set */
 | |
|       if (I2C_WaitOnBTFFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|       {
 | |
|         if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|         {
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|         }
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
| 
 | |
|     /* Generate Stop */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Receives in master mode an amount of data in blocking mode.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_BUSY;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State       = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode        = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode   = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Send Slave Address */
 | |
|     if (I2C_MasterRequestRead(hi2c, DevAddress, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     if (hi2c->XferSize == 0U)
 | |
|     {
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|     }
 | |
|     else if (hi2c->XferSize == 1U)
 | |
|     {
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|       software sequence must complete before the current byte end of transfer */
 | |
|       __disable_irq();
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|       /* Re-enable IRQs */
 | |
|       __enable_irq();
 | |
|     }
 | |
|     else if (hi2c->XferSize == 2U)
 | |
|     {
 | |
|       /* Enable Pos */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|       /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|       software sequence must complete before the current byte end of transfer */
 | |
|       __disable_irq();
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Re-enable IRQs */
 | |
|       __enable_irq();
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|     }
 | |
| 
 | |
|     while (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       if (hi2c->XferSize <= 3U)
 | |
|       {
 | |
|         /* One byte */
 | |
|         if (hi2c->XferSize == 1U)
 | |
|         {
 | |
|           /* Wait until RXNE flag is set */
 | |
|           if (I2C_WaitOnRXNEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|         /* Two bytes */
 | |
|         else if (hi2c->XferSize == 2U)
 | |
|         {
 | |
|           /* Wait until BTF flag is set */
 | |
|           if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BTF, RESET, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|              software sequence must complete before the current byte end of transfer */
 | |
|           __disable_irq();
 | |
| 
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
| 
 | |
|           /* Re-enable IRQs */
 | |
|           __enable_irq();
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|         /* 3 Last bytes */
 | |
|         else
 | |
|         {
 | |
|           /* Wait until BTF flag is set */
 | |
|           if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BTF, RESET, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Disable Acknowledge */
 | |
|           CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|           /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|              software sequence must complete before the current byte end of transfer */
 | |
|           __disable_irq();
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
| 
 | |
|           /* Wait until BTF flag is set */
 | |
|           if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BTF, RESET, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
| 
 | |
|           /* Re-enable IRQs */
 | |
|           __enable_irq();
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Wait until RXNE flag is set */
 | |
|         if (I2C_WaitOnRXNEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
| 
 | |
|         /* Read data from DR */
 | |
|         *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|         /* Increment Buffer pointer */
 | |
|         hi2c->pBuffPtr++;
 | |
| 
 | |
|         /* Update counter */
 | |
|         hi2c->XferSize--;
 | |
|         hi2c->XferCount--;
 | |
| 
 | |
|         if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == SET)
 | |
|         {
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|       }
 | |
|     }
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Transmits in slave mode an amount of data in blocking mode.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Transmit(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State       = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode        = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode   = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Enable Address Acknowledge */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Wait until ADDR flag is set */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, RESET, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Clear ADDR flag */
 | |
|     __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
| 
 | |
| 
 | |
|     while (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Wait until TXE flag is set */
 | |
|       if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|       {
 | |
|         /* Disable Address Acknowledge */
 | |
|         CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
| 
 | |
|       /* Write data to DR */
 | |
|       hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferCount--;
 | |
|       hi2c->XferSize--;
 | |
| 
 | |
|       if ((__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == SET) && (hi2c->XferSize != 0U))
 | |
|       {
 | |
|         /* Write data to DR */
 | |
|         hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|         /* Increment Buffer pointer */
 | |
|         hi2c->pBuffPtr++;
 | |
| 
 | |
|         /* Update counter */
 | |
|         hi2c->XferCount--;
 | |
|         hi2c->XferSize--;
 | |
|       }
 | |
|     }
 | |
| 
 | |
|     /* Wait until AF flag is set */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_AF, RESET, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Clear AF flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
| 
 | |
|     /* Disable Address Acknowledge */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Receive in slave mode an amount of data in blocking mode
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Receive(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == (uint16_t)0))
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State       = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode        = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode   = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Enable Address Acknowledge */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Wait until ADDR flag is set */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, RESET, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Clear ADDR flag */
 | |
|     __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|     while (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Wait until RXNE flag is set */
 | |
|       if (I2C_WaitOnRXNEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|       {
 | |
|         /* Disable Address Acknowledge */
 | |
|         CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
| 
 | |
|       /* Read data from DR */
 | |
|       *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferSize--;
 | |
|       hi2c->XferCount--;
 | |
| 
 | |
|       if ((__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == SET) && (hi2c->XferSize != 0U))
 | |
|       {
 | |
|         /* Read data from DR */
 | |
|         *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|         /* Increment Buffer pointer */
 | |
|         hi2c->pBuffPtr++;
 | |
| 
 | |
|         /* Update counter */
 | |
|         hi2c->XferSize--;
 | |
|         hi2c->XferCount--;
 | |
|       }
 | |
|     }
 | |
| 
 | |
|     /* Wait until STOP flag is set */
 | |
|     if (I2C_WaitOnSTOPFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       /* Disable Address Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Clear STOP flag */
 | |
|     __HAL_I2C_CLEAR_STOPFLAG(hi2c);
 | |
| 
 | |
|     /* Disable Address Acknowledge */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Transmit in master mode an amount of data in non-blocking mode with Interrupt
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   __IO uint32_t count = 0U;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     /* Generate Start */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|               to avoid the risk of I2C interrupt handle execution before current
 | |
|               process unlock */
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Receive in master mode an amount of data in non-blocking mode with Interrupt
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   __IO uint32_t count = 0U;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     /* Enable Acknowledge */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Generate Start */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|     to avoid the risk of I2C interrupt handle execution before current
 | |
|     process unlock */
 | |
| 
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Transmit in slave mode an amount of data in non-blocking mode with Interrupt
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Enable Address Acknowledge */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|               to avoid the risk of I2C interrupt handle execution before current
 | |
|               process unlock */
 | |
| 
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Receive in slave mode an amount of data in non-blocking mode with Interrupt
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Enable Address Acknowledge */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|               to avoid the risk of I2C interrupt handle execution before current
 | |
|               process unlock */
 | |
| 
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /**
 | |
|   * @brief  Transmit in master mode an amount of data in non-blocking mode with DMA
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
|   __IO uint32_t count = 0U;
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     if (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Set the I2C DMA transfer complete callback */
 | |
|       hi2c->hdmatx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|       /* Set the DMA error callback */
 | |
|       hi2c->hdmatx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|       /* Set the unused DMA callbacks to NULL */
 | |
|       hi2c->hdmatx->XferHalfCpltCallback = NULL;
 | |
|       hi2c->hdmatx->XferAbortCallback = NULL;
 | |
| 
 | |
|       /* Enable the DMA channel */
 | |
|       dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmatx, (uint32_t)hi2c->pBuffPtr, (uint32_t)&hi2c->Instance->DR, hi2c->XferSize);
 | |
| 
 | |
|       if (dmaxferstatus == HAL_OK)
 | |
|       {
 | |
|         /* Enable Acknowledge */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|         /* Generate Start */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|         if(I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_SB, RESET,I2C_TIMEOUT_FLAG,tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_TIMEOUT;
 | |
|         }
 | |
|         hi2c->Instance->DR = I2C_7BIT_ADD_WRITE(DevAddress);
 | |
| 
 | |
|         /* Wait until ADDR flag is set */
 | |
|         if (I2C_WaitOnMasterAddressFlagUntilTimeout(hi2c, I2C_FLAG_ADDR,I2C_TIMEOUT_FLAG, tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|         to avoid the risk of I2C interrupt handle execution before current
 | |
|         process unlock */
 | |
| 
 | |
|         /* Enable EVT and ERR interrupt */
 | |
|         __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
| 
 | |
| 
 | |
|         /* Enable DMA Request */
 | |
|         SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Update I2C state */
 | |
|         hi2c->State     = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|         /* Update I2C error code */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Generate Start */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
| 
 | |
|       /* Enable EVT, BUF and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
|     }
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Receive in master mode an amount of data in non-blocking mode with DMA
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   __IO uint32_t count = 0U;
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     if (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Set the I2C DMA transfer complete callback */
 | |
|       hi2c->hdmarx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|       /* Set the DMA error callback */
 | |
|       hi2c->hdmarx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|       /* Set the unused DMA callbacks to NULL */
 | |
|       hi2c->hdmarx->XferHalfCpltCallback = NULL;
 | |
|       hi2c->hdmarx->XferAbortCallback = NULL;
 | |
| 
 | |
|       /* Enable the DMA channel */
 | |
|       dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmarx, (uint32_t)&hi2c->Instance->DR, (uint32_t)hi2c->pBuffPtr, hi2c->XferSize);
 | |
| 
 | |
|       if (dmaxferstatus == HAL_OK)
 | |
|       {
 | |
|         /* Enable Acknowledge */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|         /* Generate Start */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|         to avoid the risk of I2C interrupt handle execution before current
 | |
|         process unlock */
 | |
| 
 | |
|         /* Enable EVT and ERR interrupt */
 | |
|         __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|         /* Enable DMA Request */
 | |
|         SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Update I2C state */
 | |
|         hi2c->State     = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|         /* Update I2C error code */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Generate Start */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
| 
 | |
|       /* Enable EVT, BUF and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
|     }
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Transmit in slave mode an amount of data in non-blocking mode with DMA
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Set the I2C DMA transfer complete callback */
 | |
|     hi2c->hdmatx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|     /* Set the DMA error callback */
 | |
|     hi2c->hdmatx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|     /* Set the unused DMA callbacks to NULL */
 | |
|     hi2c->hdmatx->XferHalfCpltCallback = NULL;
 | |
|     hi2c->hdmatx->XferAbortCallback = NULL;
 | |
| 
 | |
|     /* Enable the DMA channel */
 | |
|     dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmatx, (uint32_t)hi2c->pBuffPtr, (uint32_t)&hi2c->Instance->DR, hi2c->XferSize);
 | |
| 
 | |
|     if (dmaxferstatus == HAL_OK)
 | |
|     {
 | |
|       /* Enable Address Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, RESET, 1000, tickstart) != HAL_OK)
 | |
|       {
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
|       /* Enable EVT and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|       /* Enable DMA Request */
 | |
|       hi2c->Instance->CR2 |= I2C_CR2_DMAEN;
 | |
| 
 | |
|       return HAL_OK;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Update I2C state */
 | |
|       hi2c->State     = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|       /* Update I2C error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Receive in slave mode an amount of data in non-blocking mode with DMA
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Set the I2C DMA transfer complete callback */
 | |
|     hi2c->hdmarx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|     /* Set the DMA error callback */
 | |
|     hi2c->hdmarx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|     /* Set the unused DMA callbacks to NULL */
 | |
|     hi2c->hdmarx->XferHalfCpltCallback = NULL;
 | |
|     hi2c->hdmarx->XferAbortCallback = NULL;
 | |
| 
 | |
|     /* Enable the DMA channel */
 | |
|     dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmarx, (uint32_t)&hi2c->Instance->DR, (uint32_t)hi2c->pBuffPtr, hi2c->XferSize);
 | |
| 
 | |
|     if (dmaxferstatus == HAL_OK)
 | |
|     {
 | |
|       /* Enable Address Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
|       /* Enable EVT and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|       /* Enable DMA Request */
 | |
|       SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|       return HAL_OK;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Update I2C state */
 | |
|       hi2c->State     = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|       /* Update I2C error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| /**
 | |
|   * @brief  Write an amount of data in blocking mode to a specific memory address
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_MEMADD_SIZE(MemAddSize));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_BUSY;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MEM;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Send Slave Address and Memory Address */
 | |
|     if (I2C_RequestMemoryWrite(hi2c, DevAddress, MemAddress, MemAddSize, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     while (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Wait until TXE flag is set */
 | |
|       if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|       {
 | |
|         if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|         {
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|         }
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
| 
 | |
|       /* Write data to DR */
 | |
|       hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferSize--;
 | |
|       hi2c->XferCount--;
 | |
| 
 | |
|       if ((__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == SET) && (hi2c->XferSize != 0U))
 | |
|       {
 | |
|         /* Write data to DR */
 | |
|         hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|         /* Increment Buffer pointer */
 | |
|         hi2c->pBuffPtr++;
 | |
| 
 | |
|         /* Update counter */
 | |
|         hi2c->XferSize--;
 | |
|         hi2c->XferCount--;
 | |
|       }
 | |
|     }
 | |
| 
 | |
|     /* Wait until BTF flag is set */
 | |
|     if (I2C_WaitOnBTFFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|       {
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|       }
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Generate Stop */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Read an amount of data in blocking mode from a specific memory address
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Mem_Read(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_MEMADD_SIZE(MemAddSize));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_BUSY;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MEM;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Send Slave Address and Memory Address */
 | |
|     if (I2C_RequestMemoryRead(hi2c, DevAddress, MemAddress, MemAddSize, Timeout, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     if (hi2c->XferSize == 0U)
 | |
|     {
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|     }
 | |
|     else if (hi2c->XferSize == 1U)
 | |
|     {
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|          software sequence must complete before the current byte end of transfer */
 | |
|       __disable_irq();
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|       /* Re-enable IRQs */
 | |
|       __enable_irq();
 | |
|     }
 | |
|     else if (hi2c->XferSize == 2U)
 | |
|     {
 | |
|       /* Enable Pos */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|       /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|          software sequence must complete before the current byte end of transfer */
 | |
|       __disable_irq();
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Re-enable IRQs */
 | |
|       __enable_irq();
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|     }
 | |
| 
 | |
|     while (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       if (hi2c->XferSize <= 3U)
 | |
|       {
 | |
|         /* One byte */
 | |
|         if (hi2c->XferSize == 1U)
 | |
|         {
 | |
|           /* Wait until RXNE flag is set */
 | |
|           if (I2C_WaitOnRXNEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|         /* Two bytes */
 | |
|         else if (hi2c->XferSize == 2U)
 | |
|         {
 | |
|           /* Wait until BTF flag is set */
 | |
|           if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BTF, RESET, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|              software sequence must complete before the current byte end of transfer */
 | |
|           __disable_irq();
 | |
| 
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
| 
 | |
|           /* Re-enable IRQs */
 | |
|           __enable_irq();
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|         /* 3 Last bytes */
 | |
|         else
 | |
|         {
 | |
|           /* Wait until BTF flag is set */
 | |
|           if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BTF, RESET, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Disable Acknowledge */
 | |
|           CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|           /* Disable all active IRQs around ADDR clearing and STOP programming because the EV6_3
 | |
|              software sequence must complete before the current byte end of transfer */
 | |
|           __disable_irq();
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
| 
 | |
|           /* Wait until BTF flag is set */
 | |
|           if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BTF, RESET, Timeout, tickstart) != HAL_OK)
 | |
|           {
 | |
|             return HAL_ERROR;
 | |
|           }
 | |
| 
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
| 
 | |
|           /* Re-enable IRQs */
 | |
|           __enable_irq();
 | |
| 
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Wait until RXNE flag is set */
 | |
|         if (I2C_WaitOnRXNEFlagUntilTimeout(hi2c, Timeout, tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
| 
 | |
|         /* Read data from DR */
 | |
|         *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|         /* Increment Buffer pointer */
 | |
|         hi2c->pBuffPtr++;
 | |
| 
 | |
|         /* Update counter */
 | |
|         hi2c->XferSize--;
 | |
|         hi2c->XferCount--;
 | |
| 
 | |
|         if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == SET)
 | |
|         {
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
| 
 | |
|           /* Update counter */
 | |
|           hi2c->XferSize--;
 | |
|           hi2c->XferCount--;
 | |
|         }
 | |
|       }
 | |
|     }
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Write an amount of data in non-blocking mode with Interrupt to a specific memory address
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Mem_Write_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   __IO uint32_t count = 0U;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_MEMADD_SIZE(MemAddSize));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MEM;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
|     hi2c->Memaddress  = MemAddress;
 | |
|     hi2c->MemaddSize  = MemAddSize;
 | |
|     hi2c->EventCount  = 0U;
 | |
| 
 | |
|     /* Generate Start */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|     to avoid the risk of I2C interrupt handle execution before current
 | |
|     process unlock */
 | |
| 
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Read an amount of data in non-blocking mode with Interrupt from a specific memory address
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Mem_Read_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   __IO uint32_t count = 0U;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_MEMADD_SIZE(MemAddSize));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MEM;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
|     hi2c->Memaddress  = MemAddress;
 | |
|     hi2c->MemaddSize  = MemAddSize;
 | |
|     hi2c->EventCount  = 0U;
 | |
| 
 | |
|     /* Enable Acknowledge */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Generate Start */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     if (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
| 
 | |
|       /* Enable EVT, BUF and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
|     }
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /**
 | |
|   * @brief  Write an amount of data in non-blocking mode with DMA to a specific memory address
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Mem_Write_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   __IO uint32_t count = 0U;
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_MEMADD_SIZE(MemAddSize));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MEM;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     if (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Set the I2C DMA transfer complete callback */
 | |
|       hi2c->hdmatx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|       /* Set the DMA error callback */
 | |
|       hi2c->hdmatx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|       /* Set the unused DMA callbacks to NULL */
 | |
|       hi2c->hdmatx->XferHalfCpltCallback = NULL;
 | |
|       hi2c->hdmatx->XferAbortCallback = NULL;
 | |
| 
 | |
|       /* Enable the DMA channel */
 | |
|       dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmatx, (uint32_t)hi2c->pBuffPtr, (uint32_t)&hi2c->Instance->DR, hi2c->XferSize);
 | |
| 
 | |
|       if (dmaxferstatus == HAL_OK)
 | |
|       {
 | |
|         /* Send Slave Address and Memory Address */
 | |
|         if (I2C_RequestMemoryWrite(hi2c, DevAddress, MemAddress, MemAddSize, I2C_TIMEOUT_FLAG, tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
| 
 | |
| 
 | |
|         /* Clear ADDR flag */
 | |
|         __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|         to avoid the risk of I2C interrupt handle execution before current
 | |
|         process unlock */
 | |
|         /* Enable ERR interrupt */
 | |
|         __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_ERR);
 | |
| 
 | |
|         /* Enable DMA Request */
 | |
|         SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|         return HAL_OK;
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Update I2C state */
 | |
|         hi2c->State     = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|         /* Update I2C error code */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Update I2C state */
 | |
|       hi2c->State     = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|       /* Update I2C error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_SIZE;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Reads an amount of data in non-blocking mode with DMA from a specific memory address.
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be read
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Mem_Read_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size)
 | |
| {
 | |
|   /* Init tickstart for timeout management*/
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
|   __IO uint32_t count = 0U;
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_MEMADD_SIZE(MemAddSize));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|     do
 | |
|     {
 | |
|       count--;
 | |
|       if (count == 0U)
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MEM;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     if (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Set the I2C DMA transfer complete callback */
 | |
|       hi2c->hdmarx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|       /* Set the DMA error callback */
 | |
|       hi2c->hdmarx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|       /* Set the unused DMA callbacks to NULL */
 | |
|       hi2c->hdmarx->XferHalfCpltCallback = NULL;
 | |
|       hi2c->hdmarx->XferAbortCallback = NULL;
 | |
| 
 | |
|       /* Enable the DMA channel */
 | |
|       dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmarx, (uint32_t)&hi2c->Instance->DR, (uint32_t)hi2c->pBuffPtr, hi2c->XferSize);
 | |
| 
 | |
|       if (dmaxferstatus == HAL_OK)
 | |
|       {
 | |
|         /* Send Slave Address and Memory Address */
 | |
|         if (I2C_RequestMemoryRead(hi2c, DevAddress, MemAddress, MemAddSize, I2C_TIMEOUT_FLAG, tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
| 
 | |
|         if (hi2c->XferSize == 1U)
 | |
|         {
 | |
|           /* Disable Acknowledge */
 | |
|           CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Enable Last DMA bit */
 | |
|           SET_BIT(hi2c->Instance->CR2, I2C_CR2_LAST);
 | |
|         }
 | |
| 
 | |
|         /* Clear ADDR flag */
 | |
|         __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|         to avoid the risk of I2C interrupt handle execution before current
 | |
|         process unlock */
 | |
|         /* Enable ERR interrupt */
 | |
|         __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_ERR);
 | |
| 
 | |
|         /* Enable DMA Request */
 | |
|         hi2c->Instance->CR2 |= I2C_CR2_DMAEN;
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Update I2C state */
 | |
|         hi2c->State     = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|         /* Update I2C error code */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Send Slave Address and Memory Address */
 | |
|       if (I2C_RequestMemoryRead(hi2c, DevAddress, MemAddress, MemAddSize, I2C_TIMEOUT_FLAG, tickstart) != HAL_OK)
 | |
|       {
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
|     }
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| 
 | |
| /**
 | |
|   * @brief  Checks if target device is ready for communication.
 | |
|   * @note   This function is used with Memory devices
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  Trials Number of trials
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_IsDeviceReady(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Trials, uint32_t Timeout)
 | |
| {
 | |
|   /* Get tick */
 | |
|   uint32_t tickstart = HAL_GetTick();
 | |
|   uint32_t I2C_Trials = 1U;
 | |
|   FlagStatus tmp1;
 | |
|   FlagStatus tmp2;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Wait until BUSY flag is reset */
 | |
|     if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart) != HAL_OK)
 | |
|     {
 | |
|       return HAL_BUSY;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_BUSY;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     do
 | |
|     {
 | |
|       /* Generate Start */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|       /* Wait until SB flag is set */
 | |
|       if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_SB, RESET, Timeout, tickstart) != HAL_OK)
 | |
|       {
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
| 
 | |
|       /* Send slave address */
 | |
|       hi2c->Instance->DR = I2C_7BIT_ADD_WRITE(DevAddress);
 | |
| 
 | |
|       /* Wait until ADDR or AF flag are set */
 | |
|       /* Get tick */
 | |
|       tickstart = HAL_GetTick();
 | |
| 
 | |
|       tmp1 = __HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_ADDR);
 | |
|       tmp2 = __HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_AF);
 | |
|       while ((hi2c->State != HAL_I2C_STATE_TIMEOUT) && (tmp1 == RESET) && (tmp2 == RESET))
 | |
|       {
 | |
|         if (((HAL_GetTick() - tickstart) > Timeout) || (Timeout == 0U))
 | |
|         {
 | |
|           hi2c->State = HAL_I2C_STATE_TIMEOUT;
 | |
|         }
 | |
|         tmp1 = __HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_ADDR);
 | |
|         tmp2 = __HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_AF);
 | |
|       }
 | |
| 
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|       /* Check if the ADDR flag has been set */
 | |
|       if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_ADDR) == SET)
 | |
|       {
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|         /* Clear ADDR Flag */
 | |
|         __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|         /* Wait until BUSY flag is reset */
 | |
|         if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
| 
 | |
|         hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_OK;
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|         /* Clear AF Flag */
 | |
|         __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
| 
 | |
|         /* Wait until BUSY flag is reset */
 | |
|         if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_BUSY, SET, I2C_TIMEOUT_BUSY_FLAG, tickstart) != HAL_OK)
 | |
|         {
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
|       }
 | |
| 
 | |
|       /* Increment Trials */
 | |
|       I2C_Trials++;
 | |
|     }
 | |
|     while (I2C_Trials < Trials);
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Sequential transmit in master I2C mode an amount of data in non-blocking mode with Interrupt.
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Seq_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   __IO uint32_t Prev_State = 0x00U;
 | |
|   __IO uint32_t count      = 0x00U;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Check Busy Flag only if FIRST call of Master interface */
 | |
|     if ((XferOptions == I2C_FIRST_AND_LAST_FRAME) || (XferOptions == I2C_FIRST_FRAME))
 | |
|     {
 | |
|       /* Wait until BUSY flag is reset */
 | |
|       count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|       do
 | |
|       {
 | |
|         count--;
 | |
|         if (count == 0U)
 | |
|         {
 | |
|           hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|           hi2c->State               = HAL_I2C_STATE_READY;
 | |
|           hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|           hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|           /* Process Unlocked */
 | |
|           __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
|       }
 | |
|       while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     Prev_State = hi2c->PreviousState;
 | |
| 
 | |
|     /* If transfer direction not change and there is no request to start another frame, do not generate Restart Condition */
 | |
|     /* Mean Previous state is same as current state */
 | |
|     if ((Prev_State != I2C_STATE_MASTER_BUSY_TX) || (IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(XferOptions) == 1))
 | |
|     {
 | |
|       /* Generate Start */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|     }
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|     to avoid the risk of I2C interrupt handle execution before current
 | |
|     process unlock */
 | |
| 
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /**
 | |
|   * @brief  Sequential transmit in master I2C mode an amount of data in non-blocking mode with DMA.
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Seq_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   __IO uint32_t Prev_State = 0x00U;
 | |
|   __IO uint32_t count      = 0x00U;
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Check Busy Flag only if FIRST call of Master interface */
 | |
|     if ((XferOptions == I2C_FIRST_AND_LAST_FRAME) || (XferOptions == I2C_FIRST_FRAME))
 | |
|     {
 | |
|       /* Wait until BUSY flag is reset */
 | |
|       count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|       do
 | |
|       {
 | |
|         count--;
 | |
|         if (count == 0U)
 | |
|         {
 | |
|           hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|           hi2c->State               = HAL_I2C_STATE_READY;
 | |
|           hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|           hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|           /* Process Unlocked */
 | |
|           __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
|       }
 | |
|       while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     Prev_State = hi2c->PreviousState;
 | |
| 
 | |
|     if (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       /* Set the I2C DMA transfer complete callback */
 | |
|       hi2c->hdmatx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|       /* Set the DMA error callback */
 | |
|       hi2c->hdmatx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|       /* Set the unused DMA callbacks to NULL */
 | |
|       hi2c->hdmatx->XferHalfCpltCallback = NULL;
 | |
|       hi2c->hdmatx->XferAbortCallback = NULL;
 | |
| 
 | |
|       /* Enable the DMA channel */
 | |
|       dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmatx, (uint32_t)hi2c->pBuffPtr, (uint32_t)&hi2c->Instance->DR, hi2c->XferSize);
 | |
| 
 | |
|       if (dmaxferstatus == HAL_OK)
 | |
|       {
 | |
|         /* Enable Acknowledge */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|         /* If transfer direction not change and there is no request to start another frame, do not generate Restart Condition */
 | |
|         /* Mean Previous state is same as current state */
 | |
|         if ((Prev_State != I2C_STATE_MASTER_BUSY_TX) || (IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(XferOptions) == 1))
 | |
|         {
 | |
|           /* Generate Start */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|         }
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|         to avoid the risk of I2C interrupt handle execution before current
 | |
|         process unlock */
 | |
| 
 | |
|         /* If XferOptions is not associated to a new frame, mean no start bit is request, enable directly the DMA request */
 | |
|         /* In other cases, DMA request is enabled after Slave address treatment in IRQHandler */
 | |
|         if ((XferOptions == I2C_NEXT_FRAME) || (XferOptions == I2C_LAST_FRAME) || (XferOptions == I2C_LAST_FRAME_NO_STOP))
 | |
|         {
 | |
|           /* Enable DMA Request */
 | |
|           SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
|         }
 | |
| 
 | |
|         /* Enable EVT and ERR interrupt */
 | |
|         __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Update I2C state */
 | |
|         hi2c->State     = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|         /* Update I2C error code */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* If transfer direction not change and there is no request to start another frame, do not generate Restart Condition */
 | |
|       /* Mean Previous state is same as current state */
 | |
|       if ((Prev_State != I2C_STATE_MASTER_BUSY_TX) || (IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(XferOptions) == 1))
 | |
|       {
 | |
|         /* Generate Start */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|       }
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
| 
 | |
|       /* Enable EVT, BUF and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
|     }
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| /**
 | |
|   * @brief  Sequential receive in master I2C mode an amount of data in non-blocking mode with Interrupt
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Seq_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   __IO uint32_t Prev_State = 0x00U;
 | |
|   __IO uint32_t count = 0U;
 | |
|   uint32_t enableIT = (I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Check Busy Flag only if FIRST call of Master interface */
 | |
|     if ((XferOptions == I2C_FIRST_AND_LAST_FRAME) || (XferOptions == I2C_FIRST_FRAME))
 | |
|     {
 | |
|       /* Wait until BUSY flag is reset */
 | |
|       count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|       do
 | |
|       {
 | |
|         count--;
 | |
|         if (count == 0U)
 | |
|         {
 | |
|           hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|           hi2c->State               = HAL_I2C_STATE_READY;
 | |
|           hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|           hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|           /* Process Unlocked */
 | |
|           __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
|       }
 | |
|       while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     Prev_State = hi2c->PreviousState;
 | |
| 
 | |
|     if ((hi2c->XferCount == 2U) && ((XferOptions == I2C_LAST_FRAME) || (XferOptions == I2C_LAST_FRAME_NO_STOP)))
 | |
|     {
 | |
|       if (Prev_State == I2C_STATE_MASTER_BUSY_RX)
 | |
|       {
 | |
|         /* Disable Acknowledge */
 | |
|         CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|         /* Enable Pos */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|         /* Remove Enabling of IT_BUF, mean RXNE treatment, treat the 2 bytes through BTF */
 | |
|         enableIT &= ~I2C_IT_BUF;
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Enable Acknowledge */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|     }
 | |
| 
 | |
|     /* If transfer direction not change and there is no request to start another frame, do not generate Restart Condition */
 | |
|     /* Mean Previous state is same as current state */
 | |
|     if ((Prev_State != I2C_STATE_MASTER_BUSY_RX) || (IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(XferOptions) == 1))
 | |
|     {
 | |
|       /* Generate Start */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|     }
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|     to avoid the risk of I2C interrupt handle execution before current
 | |
|     process unlock */
 | |
| 
 | |
|     /* Enable interrupts */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, enableIT);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /**
 | |
|   * @brief  Sequential receive in master mode an amount of data in non-blocking mode with DMA
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Seq_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   __IO uint32_t Prev_State = 0x00U;
 | |
|   __IO uint32_t count = 0U;
 | |
|   uint32_t enableIT = (I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     /* Check Busy Flag only if FIRST call of Master interface */
 | |
|     if ((XferOptions == I2C_FIRST_AND_LAST_FRAME) || (XferOptions == I2C_FIRST_FRAME))
 | |
|     {
 | |
|       /* Wait until BUSY flag is reset */
 | |
|       count = I2C_TIMEOUT_BUSY_FLAG * (SystemCoreClock / 25U / 1000U);
 | |
|       do
 | |
|       {
 | |
|         count--;
 | |
|         if (count == 0U)
 | |
|         {
 | |
|           hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|           hi2c->State               = HAL_I2C_STATE_READY;
 | |
|           hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|           hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|           /* Process Unlocked */
 | |
|           __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|           return HAL_ERROR;
 | |
|         }
 | |
|       }
 | |
|       while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BUSY) != RESET);
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     /* Clear Last DMA bit */
 | |
|     CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_LAST);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_MASTER;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
|     hi2c->Devaddress  = DevAddress;
 | |
| 
 | |
|     Prev_State = hi2c->PreviousState;
 | |
| 
 | |
|     if (hi2c->XferSize > 0U)
 | |
|     {
 | |
|       if ((hi2c->XferCount == 2U) && ((XferOptions == I2C_LAST_FRAME) || (XferOptions == I2C_LAST_FRAME_NO_STOP)))
 | |
|       {
 | |
|         if (Prev_State == I2C_STATE_MASTER_BUSY_RX)
 | |
|         {
 | |
|           /* Disable Acknowledge */
 | |
|           CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|           /* Enable Pos */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|           /* Enable Last DMA bit */
 | |
|           SET_BIT(hi2c->Instance->CR2, I2C_CR2_LAST);
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Enable Acknowledge */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|         }
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Enable Acknowledge */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|         if ((XferOptions == I2C_LAST_FRAME) || (XferOptions == I2C_OTHER_AND_LAST_FRAME) || (XferOptions == I2C_LAST_FRAME_NO_STOP))
 | |
|         {
 | |
|           /* Enable Last DMA bit */
 | |
|           SET_BIT(hi2c->Instance->CR2, I2C_CR2_LAST);
 | |
|         }
 | |
|       }
 | |
| 
 | |
|       /* Set the I2C DMA transfer complete callback */
 | |
|       hi2c->hdmarx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|       /* Set the DMA error callback */
 | |
|       hi2c->hdmarx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|       /* Set the unused DMA callbacks to NULL */
 | |
|       hi2c->hdmarx->XferHalfCpltCallback = NULL;
 | |
|       hi2c->hdmarx->XferAbortCallback = NULL;
 | |
| 
 | |
|       /* Enable the DMA channel */
 | |
|       dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmarx, (uint32_t)&hi2c->Instance->DR, (uint32_t)hi2c->pBuffPtr, hi2c->XferSize);
 | |
| 
 | |
|       if (dmaxferstatus == HAL_OK)
 | |
|       {
 | |
|         /* If transfer direction not change and there is no request to start another frame, do not generate Restart Condition */
 | |
|         /* Mean Previous state is same as current state */
 | |
|         if ((Prev_State != I2C_STATE_MASTER_BUSY_RX) || (IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(XferOptions) == 1))
 | |
|         {
 | |
|           /* Generate Start */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|           /* Update interrupt for only EVT and ERR */
 | |
|           enableIT = (I2C_IT_EVT | I2C_IT_ERR);
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Update interrupt for only ERR */
 | |
|           enableIT = I2C_IT_ERR;
 | |
|         }
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|         to avoid the risk of I2C interrupt handle execution before current
 | |
|         process unlock */
 | |
| 
 | |
|         /* If XferOptions is not associated to a new frame, mean no start bit is request, enable directly the DMA request */
 | |
|         /* In other cases, DMA request is enabled after Slave address treatment in IRQHandler */
 | |
|         if ((XferOptions == I2C_NEXT_FRAME) || (XferOptions == I2C_LAST_FRAME) || (XferOptions == I2C_LAST_FRAME_NO_STOP))
 | |
|         {
 | |
|           /* Enable DMA Request */
 | |
|           SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
|         }
 | |
| 
 | |
|         /* Enable EVT and ERR interrupt */
 | |
|         __HAL_I2C_ENABLE_IT(hi2c, enableIT);
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Update I2C state */
 | |
|         hi2c->State     = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|         /* Update I2C error code */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* If transfer direction not change and there is no request to start another frame, do not generate Restart Condition */
 | |
|       /* Mean Previous state is same as current state */
 | |
|       if ((Prev_State != I2C_STATE_MASTER_BUSY_RX) || (IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(XferOptions) == 1))
 | |
|       {
 | |
|         /* Generate Start */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|       }
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
| 
 | |
|       /* Enable interrupts */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, enableIT);
 | |
|     }
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| /**
 | |
|   * @brief  Sequential transmit in slave mode an amount of data in non-blocking mode with Interrupt
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Seq_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (((uint32_t)hi2c->State & (uint32_t)HAL_I2C_STATE_LISTEN) == (uint32_t)HAL_I2C_STATE_LISTEN)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX_LISTEN;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
| 
 | |
|     /* Clear ADDR flag */
 | |
|     __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|               to avoid the risk of I2C interrupt handle execution before current
 | |
|               process unlock */
 | |
| 
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /**
 | |
|   * @brief  Sequential transmit in slave mode an amount of data in non-blocking mode with DMA
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Seq_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (((uint32_t)hi2c->State & (uint32_t)HAL_I2C_STATE_LISTEN) == (uint32_t)HAL_I2C_STATE_LISTEN)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Disable Interrupts, to prevent preemption during treatment in case of multicall */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|     /* I2C cannot manage full duplex exchange so disable previous IT enabled if any */
 | |
|     /* and then toggle the HAL slave RX state to TX state */
 | |
|     if (hi2c->State == HAL_I2C_STATE_BUSY_RX_LISTEN)
 | |
|     {
 | |
|       if ((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN)
 | |
|       {
 | |
|         /* Abort DMA Xfer if any */
 | |
|         if (hi2c->hdmarx != NULL)
 | |
|         {
 | |
|           CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|           /* Set the I2C DMA Abort callback :
 | |
|            will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|           hi2c->hdmarx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|           /* Abort DMA RX */
 | |
|           if (HAL_DMA_Abort_IT(hi2c->hdmarx) != HAL_OK)
 | |
|           {
 | |
|             /* Call Directly XferAbortCallback function in case of error */
 | |
|             hi2c->hdmarx->XferAbortCallback(hi2c->hdmarx);
 | |
|           }
 | |
|         }
 | |
|       }
 | |
|     }
 | |
|     else if (hi2c->State == HAL_I2C_STATE_BUSY_TX_LISTEN)
 | |
|     {
 | |
|       if ((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN)
 | |
|       {
 | |
|         CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|         /* Abort DMA Xfer if any */
 | |
|         if (hi2c->hdmatx != NULL)
 | |
|         {
 | |
|           /* Set the I2C DMA Abort callback :
 | |
|            will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|           hi2c->hdmatx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|           /* Abort DMA TX */
 | |
|           if (HAL_DMA_Abort_IT(hi2c->hdmatx) != HAL_OK)
 | |
|           {
 | |
|             /* Call Directly XferAbortCallback function in case of error */
 | |
|             hi2c->hdmatx->XferAbortCallback(hi2c->hdmatx);
 | |
|           }
 | |
|         }
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Nothing to do */
 | |
|     }
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_TX_LISTEN;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
| 
 | |
|     /* Set the I2C DMA transfer complete callback */
 | |
|     hi2c->hdmatx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|     /* Set the DMA error callback */
 | |
|     hi2c->hdmatx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|     /* Set the unused DMA callbacks to NULL */
 | |
|     hi2c->hdmatx->XferHalfCpltCallback = NULL;
 | |
|     hi2c->hdmatx->XferAbortCallback = NULL;
 | |
| 
 | |
|     /* Enable the DMA channel */
 | |
|     dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmatx, (uint32_t)hi2c->pBuffPtr, (uint32_t)&hi2c->Instance->DR, hi2c->XferSize);
 | |
| 
 | |
|     if (dmaxferstatus == HAL_OK)
 | |
|     {
 | |
|       /* Enable Address Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
|       /* Enable EVT and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|       /* Enable DMA Request */
 | |
|       hi2c->Instance->CR2 |= I2C_CR2_DMAEN;
 | |
| 
 | |
|       return HAL_OK;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Update I2C state */
 | |
|       hi2c->State     = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|       /* Update I2C error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| /**
 | |
|   * @brief  Sequential receive in slave mode an amount of data in non-blocking mode with Interrupt
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Seq_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (((uint32_t)hi2c->State & (uint32_t)HAL_I2C_STATE_LISTEN) == (uint32_t)HAL_I2C_STATE_LISTEN)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX_LISTEN;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
| 
 | |
|     /* Clear ADDR flag */
 | |
|     __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|               to avoid the risk of I2C interrupt handle execution before current
 | |
|               process unlock */
 | |
| 
 | |
|     /* Enable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /**
 | |
|   * @brief  Sequential receive in slave mode an amount of data in non-blocking mode with DMA
 | |
|   * @note   This interface allow to manage repeated start condition when a direction change during transfer
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  pData Pointer to data buffer
 | |
|   * @param  Size Amount of data to be sent
 | |
|   * @param  XferOptions Options of Transfer, value of @ref I2C_XferOptions_definition
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Slave_Seq_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
 | |
| {
 | |
|   HAL_StatusTypeDef dmaxferstatus;
 | |
| 
 | |
|   /* Check the parameters */
 | |
|   assert_param(IS_I2C_TRANSFER_OPTIONS_REQUEST(XferOptions));
 | |
| 
 | |
|   if (((uint32_t)hi2c->State & (uint32_t)HAL_I2C_STATE_LISTEN) == (uint32_t)HAL_I2C_STATE_LISTEN)
 | |
|   {
 | |
|     if ((pData == NULL) || (Size == 0U))
 | |
|     {
 | |
|       return  HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     /* Disable Interrupts, to prevent preemption during treatment in case of multicall */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|     /* I2C cannot manage full duplex exchange so disable previous IT enabled if any */
 | |
|     /* and then toggle the HAL slave RX state to TX state */
 | |
|     if (hi2c->State == HAL_I2C_STATE_BUSY_RX_LISTEN)
 | |
|     {
 | |
|       if ((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN)
 | |
|       {
 | |
|         /* Abort DMA Xfer if any */
 | |
|         if (hi2c->hdmarx != NULL)
 | |
|         {
 | |
|           CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|           /* Set the I2C DMA Abort callback :
 | |
|            will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|           hi2c->hdmarx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|           /* Abort DMA RX */
 | |
|           if (HAL_DMA_Abort_IT(hi2c->hdmarx) != HAL_OK)
 | |
|           {
 | |
|             /* Call Directly XferAbortCallback function in case of error */
 | |
|             hi2c->hdmarx->XferAbortCallback(hi2c->hdmarx);
 | |
|           }
 | |
|         }
 | |
|       }
 | |
|     }
 | |
|     else if (hi2c->State == HAL_I2C_STATE_BUSY_TX_LISTEN)
 | |
|     {
 | |
|       if ((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN)
 | |
|       {
 | |
|         CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|         /* Abort DMA Xfer if any */
 | |
|         if (hi2c->hdmatx != NULL)
 | |
|         {
 | |
|           /* Set the I2C DMA Abort callback :
 | |
|            will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|           hi2c->hdmatx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|           /* Abort DMA TX */
 | |
|           if (HAL_DMA_Abort_IT(hi2c->hdmatx) != HAL_OK)
 | |
|           {
 | |
|             /* Call Directly XferAbortCallback function in case of error */
 | |
|             hi2c->hdmatx->XferAbortCallback(hi2c->hdmatx);
 | |
|           }
 | |
|         }
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Nothing to do */
 | |
|     }
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Disable Pos */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|     hi2c->State     = HAL_I2C_STATE_BUSY_RX_LISTEN;
 | |
|     hi2c->Mode      = HAL_I2C_MODE_SLAVE;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Prepare transfer parameters */
 | |
|     hi2c->pBuffPtr    = pData;
 | |
|     hi2c->XferCount   = Size;
 | |
|     hi2c->XferSize    = hi2c->XferCount;
 | |
|     hi2c->XferOptions = XferOptions;
 | |
| 
 | |
|     /* Set the I2C DMA transfer complete callback */
 | |
|     hi2c->hdmarx->XferCpltCallback = I2C_DMAXferCplt;
 | |
| 
 | |
|     /* Set the DMA error callback */
 | |
|     hi2c->hdmarx->XferErrorCallback = I2C_DMAError;
 | |
| 
 | |
|     /* Set the unused DMA callbacks to NULL */
 | |
|     hi2c->hdmarx->XferHalfCpltCallback = NULL;
 | |
|     hi2c->hdmarx->XferAbortCallback = NULL;
 | |
| 
 | |
|     /* Enable the DMA channel */
 | |
|     dmaxferstatus = HAL_DMA_Start_IT(hi2c->hdmarx, (uint32_t)&hi2c->Instance->DR, (uint32_t)hi2c->pBuffPtr, hi2c->XferSize);
 | |
| 
 | |
|     if (dmaxferstatus == HAL_OK)
 | |
|     {
 | |
|       /* Enable Address Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       /* Enable DMA Request */
 | |
|       SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|       /* Note : The I2C interrupts must be enabled after unlocking current process
 | |
|       to avoid the risk of I2C interrupt handle execution before current
 | |
|       process unlock */
 | |
|       /* Enable EVT and ERR interrupt */
 | |
|       __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|       return HAL_OK;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Update I2C state */
 | |
|       hi2c->State     = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode      = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|       /* Update I2C error code */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| /**
 | |
|   * @brief  Enable the Address listen mode with Interrupt.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_EnableListen_IT(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   if (hi2c->State == HAL_I2C_STATE_READY)
 | |
|   {
 | |
|     hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
| 
 | |
|     /* Check if the I2C is already enabled */
 | |
|     if ((hi2c->Instance->CR1 & I2C_CR1_PE) != I2C_CR1_PE)
 | |
|     {
 | |
|       /* Enable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
|     }
 | |
| 
 | |
|     /* Enable Address Acknowledge */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Enable EVT and ERR interrupt */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Disable the Address listen mode with Interrupt.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_DisableListen_IT(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of tmp to prevent undefined behavior of volatile usage */
 | |
|   uint32_t tmp;
 | |
| 
 | |
|   /* Disable Address listen mode only if a transfer is not ongoing */
 | |
|   if (hi2c->State == HAL_I2C_STATE_LISTEN)
 | |
|   {
 | |
|     tmp = (uint32_t)(hi2c->State) & I2C_STATE_MSK;
 | |
|     hi2c->PreviousState = tmp | (uint32_t)(hi2c->Mode);
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Disable Address Acknowledge */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Disable EVT and ERR interrupt */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     return HAL_BUSY;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Abort a master I2C IT or DMA process communication with Interrupt.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for the specified I2C.
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @retval HAL status
 | |
|   */
 | |
| HAL_StatusTypeDef HAL_I2C_Master_Abort_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(DevAddress);
 | |
| 
 | |
|   /* Abort Master transfer during Receive or Transmit process    */
 | |
|   if (hi2c->Mode == HAL_I2C_MODE_MASTER)
 | |
|   {
 | |
|     /* Process Locked */
 | |
|     __HAL_LOCK(hi2c);
 | |
| 
 | |
|     hi2c->PreviousState = I2C_STATE_NONE;
 | |
|     hi2c->State = HAL_I2C_STATE_ABORT;
 | |
| 
 | |
|     /* Disable Acknowledge */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     /* Generate Stop */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|     hi2c->XferCount = 0U;
 | |
| 
 | |
|     /* Disable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
|     I2C_ITError(hi2c);
 | |
| 
 | |
|     return HAL_OK;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Wrong usage of abort function */
 | |
|     /* This function should be used only in case of abort monitored by master device */
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup I2C_IRQ_Handler_and_Callbacks IRQ Handler and Callbacks
 | |
|  * @{
 | |
|  */
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C event interrupt request.
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| void HAL_I2C_EV_IRQHandler(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   uint32_t sr1itflags;
 | |
|   uint32_t sr2itflags               = 0U;
 | |
|   uint32_t itsources                = READ_REG(hi2c->Instance->CR2);
 | |
|   uint32_t CurrentXferOptions       = hi2c->XferOptions;
 | |
|   HAL_I2C_ModeTypeDef CurrentMode   = hi2c->Mode;
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
| 
 | |
|   /* Master or Memory mode selected */
 | |
|   if ((CurrentMode == HAL_I2C_MODE_MASTER) || (CurrentMode == HAL_I2C_MODE_MEM))
 | |
|   {
 | |
|     sr2itflags   = READ_REG(hi2c->Instance->SR2);
 | |
|     sr1itflags   = READ_REG(hi2c->Instance->SR1);
 | |
| 
 | |
|     /* Exit IRQ event until Start Bit detected in case of Other frame requested */
 | |
|     if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_SB) == RESET) && (IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(CurrentXferOptions) == 1U))
 | |
|     {
 | |
|       return;
 | |
|     }
 | |
| 
 | |
|     /* SB Set ----------------------------------------------------------------*/
 | |
|     if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_SB) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|     {
 | |
|       /* Convert OTHER_xxx XferOptions if any */
 | |
|       I2C_ConvertOtherXferOptions(hi2c);
 | |
| 
 | |
|       I2C_Master_SB(hi2c);
 | |
|     }
 | |
|     /* ADD10 Set -------------------------------------------------------------*/
 | |
|     else if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_ADD10) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|     {
 | |
|       I2C_Master_ADD10(hi2c);
 | |
|     }
 | |
|     /* ADDR Set --------------------------------------------------------------*/
 | |
|     else if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_ADDR) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|     {
 | |
|       I2C_Master_ADDR(hi2c);
 | |
|     }
 | |
|     /* I2C in mode Transmitter -----------------------------------------------*/
 | |
|     else if (I2C_CHECK_FLAG(sr2itflags, I2C_FLAG_TRA) != RESET)
 | |
|     {
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|       /* Do not check buffer and BTF flag if a Xfer DMA is on going */
 | |
|       if (READ_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN) != I2C_CR2_DMAEN)
 | |
|       {
 | |
| #endif /* DMA1 or DMA */
 | |
|         /* TXE set and BTF reset -----------------------------------------------*/
 | |
|         if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_TXE) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_BUF) != RESET) && (I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) == RESET))
 | |
|         {
 | |
|           I2C_MasterTransmit_TXE(hi2c);
 | |
|         }
 | |
|         /* BTF set -------------------------------------------------------------*/
 | |
|         else if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|         {
 | |
|           I2C_MasterTransmit_BTF(hi2c);
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Do nothing */
 | |
|         }
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|       }
 | |
| #endif /* DMA1 or DMA */
 | |
|     }
 | |
|     /* I2C in mode Receiver --------------------------------------------------*/
 | |
|     else
 | |
|     {
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|       /* Do not check buffer and BTF flag if a Xfer DMA is on going */
 | |
|       if (READ_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN) != I2C_CR2_DMAEN)
 | |
|       {
 | |
| #endif /* DMA1 or DMA */
 | |
|         /* RXNE set and BTF reset -----------------------------------------------*/
 | |
|         if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_RXNE) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_BUF) != RESET) && (I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) == RESET))
 | |
|         {
 | |
|           I2C_MasterReceive_RXNE(hi2c);
 | |
|         }
 | |
|         /* BTF set -------------------------------------------------------------*/
 | |
|         else if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|         {
 | |
|           I2C_MasterReceive_BTF(hi2c);
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Do nothing */
 | |
|         }
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|       }
 | |
| #endif /* DMA1 or DMA */
 | |
|     }
 | |
|   }
 | |
|   /* Slave mode selected */
 | |
|   else
 | |
|   {
 | |
|     /* If an error is detected, read only SR1 register to prevent */
 | |
|     /* a clear of ADDR flags by reading SR2 after reading SR1 in Error treatment */
 | |
|     if (hi2c->ErrorCode != HAL_I2C_ERROR_NONE)
 | |
|     {
 | |
|       sr1itflags   = READ_REG(hi2c->Instance->SR1);
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       sr2itflags   = READ_REG(hi2c->Instance->SR2);
 | |
|       sr1itflags   = READ_REG(hi2c->Instance->SR1);
 | |
|     }
 | |
| 
 | |
|     /* ADDR set --------------------------------------------------------------*/
 | |
|     if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_ADDR) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|     {
 | |
|       /* Now time to read SR2, this will clear ADDR flag automatically */
 | |
|       if (hi2c->ErrorCode != HAL_I2C_ERROR_NONE)
 | |
|       {
 | |
|         sr2itflags   = READ_REG(hi2c->Instance->SR2);
 | |
|       }
 | |
|       I2C_Slave_ADDR(hi2c, sr2itflags);
 | |
|     }
 | |
|     /* STOPF set --------------------------------------------------------------*/
 | |
|     else if (I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_STOPF) != RESET)
 | |
|     {
 | |
|       I2C_Slave_STOPF(hi2c);
 | |
|     }
 | |
|     /* I2C in mode Transmitter -----------------------------------------------*/
 | |
|     else if ((CurrentState == HAL_I2C_STATE_BUSY_TX) || (CurrentState == HAL_I2C_STATE_BUSY_TX_LISTEN))
 | |
|     {
 | |
|       /* TXE set and BTF reset -----------------------------------------------*/
 | |
|       if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_TXE) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_BUF) != RESET) && (I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) == RESET))
 | |
|       {
 | |
|         I2C_SlaveTransmit_TXE(hi2c);
 | |
|       }
 | |
|       /* BTF set -------------------------------------------------------------*/
 | |
|       else if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|       {
 | |
|         I2C_SlaveTransmit_BTF(hi2c);
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Do nothing */
 | |
|       }
 | |
|     }
 | |
|     /* I2C in mode Receiver --------------------------------------------------*/
 | |
|     else
 | |
|     {
 | |
|       /* RXNE set and BTF reset ----------------------------------------------*/
 | |
|       if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_RXNE) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_BUF) != RESET) && (I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) == RESET))
 | |
|       {
 | |
|         I2C_SlaveReceive_RXNE(hi2c);
 | |
|       }
 | |
|       /* BTF set -------------------------------------------------------------*/
 | |
|       else if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BTF) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_EVT) != RESET))
 | |
|       {
 | |
|         I2C_SlaveReceive_BTF(hi2c);
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Do nothing */
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C error interrupt request.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| void HAL_I2C_ER_IRQHandler(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   HAL_I2C_ModeTypeDef tmp1;
 | |
|   uint32_t tmp2;
 | |
|   HAL_I2C_StateTypeDef tmp3;
 | |
|   uint32_t tmp4;
 | |
|   uint32_t sr1itflags = READ_REG(hi2c->Instance->SR1);
 | |
|   uint32_t itsources  = READ_REG(hi2c->Instance->CR2);
 | |
|   uint32_t error      = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|   /* I2C Bus error interrupt occurred ----------------------------------------*/
 | |
|   if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_BERR) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_ERR) != RESET))
 | |
|   {
 | |
|     error |= HAL_I2C_ERROR_BERR;
 | |
| 
 | |
|     /* Clear BERR flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_BERR);
 | |
| 
 | |
|     /* Workaround: Start cannot be generated after a misplaced Stop */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_SWRST);
 | |
|   }
 | |
| 
 | |
|   /* I2C Arbitration Lost error interrupt occurred ---------------------------*/
 | |
|   if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_ARLO) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_ERR) != RESET))
 | |
|   {
 | |
|     error |= HAL_I2C_ERROR_ARLO;
 | |
| 
 | |
|     /* Clear ARLO flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_ARLO);
 | |
|   }
 | |
| 
 | |
|   /* I2C Acknowledge failure error interrupt occurred ------------------------*/
 | |
|   if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_AF) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_ERR) != RESET))
 | |
|   {
 | |
|     tmp1 = hi2c->Mode;
 | |
|     tmp2 = hi2c->XferCount;
 | |
|     tmp3 = hi2c->State;
 | |
|     tmp4 = hi2c->PreviousState;
 | |
|     if ((tmp1 == HAL_I2C_MODE_SLAVE) && (tmp2 == 0U) && \
 | |
|         ((tmp3 == HAL_I2C_STATE_BUSY_TX) || (tmp3 == HAL_I2C_STATE_BUSY_TX_LISTEN) || \
 | |
|          ((tmp3 == HAL_I2C_STATE_LISTEN) && (tmp4 == I2C_STATE_SLAVE_BUSY_TX))))
 | |
|     {
 | |
|       I2C_Slave_AF(hi2c);
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Clear AF flag */
 | |
|       __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
| 
 | |
|       error |= HAL_I2C_ERROR_AF;
 | |
| 
 | |
|       /* Do not generate a STOP in case of Slave receive non acknowledge during transfer (mean not at the end of transfer) */
 | |
|       if (hi2c->Mode == HAL_I2C_MODE_MASTER)
 | |
|       {
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| 
 | |
|   /* I2C Over-Run/Under-Run interrupt occurred -------------------------------*/
 | |
|   if ((I2C_CHECK_FLAG(sr1itflags, I2C_FLAG_OVR) != RESET) && (I2C_CHECK_IT_SOURCE(itsources, I2C_IT_ERR) != RESET))
 | |
|   {
 | |
|     error |= HAL_I2C_ERROR_OVR;
 | |
|     /* Clear OVR flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_OVR);
 | |
|   }
 | |
| 
 | |
|   /* Call the Error Callback in case of Error detected -----------------------*/
 | |
|   if (error != HAL_I2C_ERROR_NONE)
 | |
|   {
 | |
|     hi2c->ErrorCode |= error;
 | |
|     I2C_ITError(hi2c);
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Master Tx Transfer completed callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_MasterTxCpltCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Master Rx Transfer completed callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_MasterRxCpltCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /** @brief  Slave Tx Transfer completed callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_SlaveTxCpltCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Slave Rx Transfer completed callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_SlaveRxCpltCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Slave Address Match callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  TransferDirection Master request Transfer Direction (Write/Read), value of @ref I2C_XferDirection_definition
 | |
|   * @param  AddrMatchCode Address Match Code
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_AddrCallback(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
|   UNUSED(TransferDirection);
 | |
|   UNUSED(AddrMatchCode);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_AddrCallback() could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Listen Complete callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_ListenCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_ListenCpltCallback() could be implemented in the user file
 | |
|   */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Memory Tx Transfer completed callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_MemTxCpltCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Memory Rx Transfer completed callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_MemRxCpltCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  I2C error callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_ErrorCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  I2C abort callback.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval None
 | |
|   */
 | |
| __weak void HAL_I2C_AbortCpltCallback(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Prevent unused argument(s) compilation warning */
 | |
|   UNUSED(hi2c);
 | |
| 
 | |
|   /* NOTE : This function should not be modified, when the callback is needed,
 | |
|             the HAL_I2C_AbortCpltCallback could be implemented in the user file
 | |
|    */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup I2C_Exported_Functions_Group3 Peripheral State, Mode and Error functions
 | |
|  *  @brief   Peripheral State, Mode and Error functions
 | |
|   *
 | |
| @verbatim
 | |
|  ===============================================================================
 | |
|             ##### Peripheral State, Mode and Error functions #####
 | |
|  ===============================================================================
 | |
|     [..]
 | |
|     This subsection permit to get in run-time the status of the peripheral
 | |
|     and the data flow.
 | |
| 
 | |
| @endverbatim
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @brief  Return the I2C handle state.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval HAL state
 | |
|   */
 | |
| HAL_I2C_StateTypeDef HAL_I2C_GetState(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Return I2C handle state */
 | |
|   return hi2c->State;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Returns the I2C Master, Slave, Memory or no mode.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval HAL mode
 | |
|   */
 | |
| HAL_I2C_ModeTypeDef HAL_I2C_GetMode(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   return hi2c->Mode;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Return the I2C error code.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *              the configuration information for the specified I2C.
 | |
|   * @retval I2C Error Code
 | |
|   */
 | |
| uint32_t HAL_I2C_GetError(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   return hi2c->ErrorCode;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @addtogroup I2C_Private_Functions
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle TXE flag for Master
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_MasterTransmit_TXE(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variables to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
|   HAL_I2C_ModeTypeDef CurrentMode   = hi2c->Mode;
 | |
|   uint32_t CurrentXferOptions       = hi2c->XferOptions;
 | |
| 
 | |
|   if ((hi2c->XferSize == 0U) && (CurrentState == HAL_I2C_STATE_BUSY_TX))
 | |
|   {
 | |
|     /* Call TxCpltCallback() directly if no stop mode is set */
 | |
|     if ((CurrentXferOptions != I2C_FIRST_AND_LAST_FRAME) && (CurrentXferOptions != I2C_LAST_FRAME) && (CurrentXferOptions != I2C_NO_OPTION_FRAME))
 | |
|     {
 | |
|       __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|       hi2c->PreviousState = I2C_STATE_MASTER_BUSY_TX;
 | |
|       hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->MasterTxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_MasterTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|     else /* Generate Stop condition then Call TxCpltCallback() */
 | |
|     {
 | |
|       /* Disable EVT, BUF and ERR interrupt */
 | |
|       __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|       hi2c->PreviousState = I2C_STATE_NONE;
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|       if (hi2c->Mode == HAL_I2C_MODE_MEM)
 | |
|       {
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->MemTxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_MemTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->MasterTxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_MasterTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   else if ((CurrentState == HAL_I2C_STATE_BUSY_TX) || \
 | |
|            ((CurrentMode == HAL_I2C_MODE_MEM) && (CurrentState == HAL_I2C_STATE_BUSY_RX)))
 | |
|   {
 | |
|     if (hi2c->XferCount == 0U)
 | |
|     {
 | |
|       /* Disable BUF interrupt */
 | |
|       __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_BUF);
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       if (hi2c->Mode == HAL_I2C_MODE_MEM)
 | |
|       {
 | |
|         if (hi2c->EventCount == 0U)
 | |
|         {
 | |
|           /* If Memory address size is 8Bit */
 | |
|           if (hi2c->MemaddSize == I2C_MEMADD_SIZE_8BIT)
 | |
|           {
 | |
|             /* Send Memory Address */
 | |
|             hi2c->Instance->DR = I2C_MEM_ADD_LSB(hi2c->Memaddress);
 | |
| 
 | |
|             hi2c->EventCount += 2U;
 | |
|           }
 | |
|           /* If Memory address size is 16Bit */
 | |
|           else
 | |
|           {
 | |
|             /* Send MSB of Memory Address */
 | |
|             hi2c->Instance->DR = I2C_MEM_ADD_MSB(hi2c->Memaddress);
 | |
| 
 | |
|             hi2c->EventCount++;
 | |
|           }
 | |
|         }
 | |
|         else if (hi2c->EventCount == 1U)
 | |
|         {
 | |
|           /* Send LSB of Memory Address */
 | |
|           hi2c->Instance->DR = I2C_MEM_ADD_LSB(hi2c->Memaddress);
 | |
| 
 | |
|           hi2c->EventCount++;
 | |
|         }
 | |
|         else if (hi2c->EventCount == 2U)
 | |
|         {
 | |
|           if (hi2c->State == HAL_I2C_STATE_BUSY_RX)
 | |
|           {
 | |
|             /* Generate Restart */
 | |
|             hi2c->Instance->CR1 |= I2C_CR1_START;
 | |
|           }
 | |
|           else if (hi2c->State == HAL_I2C_STATE_BUSY_TX)
 | |
|           {
 | |
|             /* Write data to DR */
 | |
|             hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|             /* Increment Buffer pointer */
 | |
|             hi2c->pBuffPtr++;
 | |
| 
 | |
|             /* Update counter */
 | |
|             hi2c->XferCount--;
 | |
|           }
 | |
|           else
 | |
|           {
 | |
|             /* Do nothing */
 | |
|           }
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Do nothing */
 | |
|         }
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Write data to DR */
 | |
|         hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|         /* Increment Buffer pointer */
 | |
|         hi2c->pBuffPtr++;
 | |
| 
 | |
|         /* Update counter */
 | |
|         hi2c->XferCount--;
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Do nothing */
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle BTF flag for Master transmitter
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_MasterTransmit_BTF(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variables to prevent undefined behavior of volatile usage */
 | |
|   uint32_t CurrentXferOptions = hi2c->XferOptions;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_BUSY_TX)
 | |
|   {
 | |
|     if (hi2c->XferCount != 0U)
 | |
|     {
 | |
|       /* Write data to DR */
 | |
|       hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferCount--;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Call TxCpltCallback() directly if no stop mode is set */
 | |
|       if ((CurrentXferOptions != I2C_FIRST_AND_LAST_FRAME) && (CurrentXferOptions != I2C_LAST_FRAME) && (CurrentXferOptions != I2C_NO_OPTION_FRAME))
 | |
|       {
 | |
|         __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|         hi2c->PreviousState = I2C_STATE_MASTER_BUSY_TX;
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|         hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->MasterTxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_MasterTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|       else /* Generate Stop condition then Call TxCpltCallback() */
 | |
|       {
 | |
|         /* Disable EVT, BUF and ERR interrupt */
 | |
|         __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|         hi2c->PreviousState = I2C_STATE_NONE;
 | |
|         hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|         if (hi2c->Mode == HAL_I2C_MODE_MEM)
 | |
|         {
 | |
|           hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|           hi2c->MemTxCpltCallback(hi2c);
 | |
| #else
 | |
|           HAL_I2C_MemTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|           hi2c->MasterTxCpltCallback(hi2c);
 | |
| #else
 | |
|           HAL_I2C_MasterTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|         }
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle RXNE flag for Master
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_MasterReceive_RXNE(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   if (hi2c->State == HAL_I2C_STATE_BUSY_RX)
 | |
|   {
 | |
|     uint32_t tmp;
 | |
| 
 | |
|     tmp = hi2c->XferCount;
 | |
|     if (tmp > 3U)
 | |
|     {
 | |
|       /* Read data from DR */
 | |
|       *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferCount--;
 | |
| 
 | |
|       if (hi2c->XferCount == (uint16_t)3)
 | |
|       {
 | |
|         /* Disable BUF interrupt, this help to treat correctly the last 4 bytes
 | |
|         on BTF subroutine */
 | |
|         /* Disable BUF interrupt */
 | |
|         __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_BUF);
 | |
|       }
 | |
|     }
 | |
|     else if ((hi2c->XferOptions != I2C_FIRST_AND_NEXT_FRAME) && ((tmp == 1U) || (tmp == 0U)))
 | |
|     {
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* Disable EVT, BUF and ERR interrupt */
 | |
|       __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|       /* Read data from DR */
 | |
|       *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferCount--;
 | |
| 
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|       if (hi2c->Mode == HAL_I2C_MODE_MEM)
 | |
|       {
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|         hi2c->PreviousState = I2C_STATE_NONE;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->MemRxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_MemRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|         hi2c->PreviousState = I2C_STATE_MASTER_BUSY_RX;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->MasterRxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_MasterRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Do nothing */
 | |
|     }
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle BTF flag for Master receiver
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_MasterReceive_BTF(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variables to prevent undefined behavior of volatile usage */
 | |
|   uint32_t CurrentXferOptions = hi2c->XferOptions;
 | |
| 
 | |
|   if (hi2c->XferCount == 4U)
 | |
|   {
 | |
|     /* Disable BUF interrupt, this help to treat correctly the last 2 bytes
 | |
|        on BTF subroutine if there is a reception delay between N-1 and N byte */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_BUF);
 | |
| 
 | |
|     /* Read data from DR */
 | |
|     *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
|   }
 | |
|   else if (hi2c->XferCount == 3U)
 | |
|   {
 | |
|     /* Disable BUF interrupt, this help to treat correctly the last 2 bytes
 | |
|        on BTF subroutine if there is a reception delay between N-1 and N byte */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_BUF);
 | |
| 
 | |
|     if ((CurrentXferOptions != I2C_NEXT_FRAME) && (CurrentXferOptions != I2C_FIRST_AND_NEXT_FRAME))
 | |
|     {
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|     }
 | |
| 
 | |
|     /* Read data from DR */
 | |
|     *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
|   }
 | |
|   else if (hi2c->XferCount == 2U)
 | |
|   {
 | |
|     /* Prepare next transfer or stop current transfer */
 | |
|     if ((CurrentXferOptions == I2C_FIRST_FRAME) || (CurrentXferOptions == I2C_LAST_FRAME_NO_STOP))
 | |
|     {
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|     }
 | |
|     else if ((CurrentXferOptions == I2C_NEXT_FRAME) || (CurrentXferOptions == I2C_FIRST_AND_NEXT_FRAME))
 | |
|     {
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|     }
 | |
|     else if (CurrentXferOptions != I2C_LAST_FRAME_NO_STOP)
 | |
|     {
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Do nothing */
 | |
|     }
 | |
| 
 | |
|     /* Read data from DR */
 | |
|     *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
| 
 | |
|     /* Read data from DR */
 | |
|     *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
| 
 | |
|     /* Disable EVT and ERR interrupt */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     if (hi2c->Mode == HAL_I2C_MODE_MEM)
 | |
|     {
 | |
|       hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|       hi2c->PreviousState = I2C_STATE_NONE;
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->MemRxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_MemRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|       hi2c->PreviousState = I2C_STATE_MASTER_BUSY_RX;
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->MasterRxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_MasterRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Read data from DR */
 | |
|     *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle SB flag for Master
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_Master_SB(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   if (hi2c->Mode == HAL_I2C_MODE_MEM)
 | |
|   {
 | |
|     if (hi2c->EventCount == 0U)
 | |
|     {
 | |
|       /* Send slave address */
 | |
|       hi2c->Instance->DR = I2C_7BIT_ADD_WRITE(hi2c->Devaddress);
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       hi2c->Instance->DR = I2C_7BIT_ADD_READ(hi2c->Devaddress);
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Send slave 7 Bits address */
 | |
|     if (hi2c->State == HAL_I2C_STATE_BUSY_TX)
 | |
|     {
 | |
|       hi2c->Instance->DR = I2C_7BIT_ADD_WRITE(hi2c->Devaddress);
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       hi2c->Instance->DR = I2C_7BIT_ADD_READ(hi2c->Devaddress);
 | |
|     }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|     if ((hi2c->hdmatx != NULL) || (hi2c->hdmarx != NULL))
 | |
|     {
 | |
|       if ((hi2c->hdmatx->XferCpltCallback != NULL) || (hi2c->hdmarx->XferCpltCallback != NULL))
 | |
|       {
 | |
|         /* Enable DMA Request */
 | |
|         SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
|       }
 | |
|     }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle ADD10 flag for Master
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_Master_ADD10(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Send slave address */
 | |
|   hi2c->Instance->DR = I2C_10BIT_ADDRESS(hi2c->Devaddress);
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|   if ((hi2c->hdmatx != NULL) || (hi2c->hdmarx != NULL))
 | |
|   {
 | |
|     if ((hi2c->hdmatx->XferCpltCallback != NULL) || (hi2c->hdmarx->XferCpltCallback != NULL))
 | |
|     {
 | |
|       /* Enable DMA Request */
 | |
|       SET_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
|     }
 | |
|   }
 | |
| #endif /* DMA1 or DMA */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle ADDR flag for Master
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_Master_ADDR(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variable to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_ModeTypeDef CurrentMode       = hi2c->Mode;
 | |
|   uint32_t CurrentXferOptions           = hi2c->XferOptions;
 | |
|   uint32_t Prev_State                   = hi2c->PreviousState;
 | |
| 
 | |
|   if (hi2c->State == HAL_I2C_STATE_BUSY_RX)
 | |
|   {
 | |
|     if ((hi2c->EventCount == 0U) && (CurrentMode == HAL_I2C_MODE_MEM))
 | |
|     {
 | |
|       /* Clear ADDR flag */
 | |
|       __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       if (hi2c->XferCount == 0U)
 | |
|       {
 | |
|         /* Clear ADDR flag */
 | |
|         __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|       }
 | |
|       else if (hi2c->XferCount == 1U)
 | |
|       {
 | |
|         if (CurrentXferOptions == I2C_NO_OPTION_FRAME)
 | |
|         {
 | |
|           /* Disable Acknowledge */
 | |
|           CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|           if ((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN)
 | |
|           {
 | |
|             /* Disable Acknowledge */
 | |
|             CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|             /* Clear ADDR flag */
 | |
|             __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|           }
 | |
|           else
 | |
|           {
 | |
| #endif /* DMA1 or DMA */
 | |
|             /* Clear ADDR flag */
 | |
|             __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|             /* Generate Stop */
 | |
|             SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|           }
 | |
| #endif /* DMA1 or DMA */
 | |
|         }
 | |
|         /* Prepare next transfer or stop current transfer */
 | |
|         else if ((CurrentXferOptions != I2C_FIRST_AND_LAST_FRAME) && (CurrentXferOptions != I2C_LAST_FRAME) \
 | |
|                  && ((Prev_State != I2C_STATE_MASTER_BUSY_RX) || (CurrentXferOptions == I2C_FIRST_FRAME)))
 | |
|         {
 | |
|           if ((CurrentXferOptions != I2C_NEXT_FRAME) && (CurrentXferOptions != I2C_FIRST_AND_NEXT_FRAME) && (CurrentXferOptions != I2C_LAST_FRAME_NO_STOP))
 | |
|           {
 | |
|             /* Disable Acknowledge */
 | |
|             CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|           }
 | |
|           else
 | |
|           {
 | |
|             /* Enable Acknowledge */
 | |
|             SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|           }
 | |
| 
 | |
|           /* Clear ADDR flag */
 | |
|           __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Disable Acknowledge */
 | |
|           CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|           /* Clear ADDR flag */
 | |
|           __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|           /* Generate Stop */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|         }
 | |
|       }
 | |
|       else if (hi2c->XferCount == 2U)
 | |
|       {
 | |
|         if ((CurrentXferOptions != I2C_NEXT_FRAME) && (CurrentXferOptions != I2C_FIRST_AND_NEXT_FRAME) && (CurrentXferOptions != I2C_LAST_FRAME_NO_STOP))
 | |
|         {
 | |
|           /* Enable Pos */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_POS);
 | |
| 
 | |
|           /* Clear ADDR flag */
 | |
|           __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|           /* Disable Acknowledge */
 | |
|           CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|           /* Enable Acknowledge */
 | |
|           SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|           /* Clear ADDR flag */
 | |
|           __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|         }
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|         if (((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN) && ((CurrentXferOptions == I2C_NO_OPTION_FRAME) || (CurrentXferOptions == I2C_FIRST_FRAME) || (CurrentXferOptions == I2C_FIRST_AND_LAST_FRAME) || (CurrentXferOptions == I2C_LAST_FRAME_NO_STOP) || (CurrentXferOptions == I2C_LAST_FRAME)))
 | |
|         {
 | |
|           /* Enable Last DMA bit */
 | |
|           SET_BIT(hi2c->Instance->CR2, I2C_CR2_LAST);
 | |
|         }
 | |
| #endif /* DMA1 or DMA */
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         /* Enable Acknowledge */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|         if (((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN) && ((CurrentXferOptions == I2C_NO_OPTION_FRAME) || (CurrentXferOptions == I2C_FIRST_FRAME) || (CurrentXferOptions == I2C_FIRST_AND_LAST_FRAME) || (CurrentXferOptions == I2C_LAST_FRAME_NO_STOP) || (CurrentXferOptions == I2C_LAST_FRAME)))
 | |
|         {
 | |
|           /* Enable Last DMA bit */
 | |
|           SET_BIT(hi2c->Instance->CR2, I2C_CR2_LAST);
 | |
|         }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
|         /* Clear ADDR flag */
 | |
|         __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|       }
 | |
| 
 | |
|       /* Reset Event counter  */
 | |
|       hi2c->EventCount = 0U;
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Clear ADDR flag */
 | |
|     __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle TXE flag for Slave
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_SlaveTransmit_TXE(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variables to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
| 
 | |
|   if (hi2c->XferCount != 0U)
 | |
|   {
 | |
|     /* Write data to DR */
 | |
|     hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
| 
 | |
|     if ((hi2c->XferCount == 0U) && (CurrentState == HAL_I2C_STATE_BUSY_TX_LISTEN))
 | |
|     {
 | |
|       /* Last Byte is received, disable Interrupt */
 | |
|       __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_BUF);
 | |
| 
 | |
|       /* Set state at HAL_I2C_STATE_LISTEN */
 | |
|       hi2c->PreviousState = I2C_STATE_SLAVE_BUSY_TX;
 | |
|       hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
| 
 | |
|       /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->SlaveTxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_SlaveTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle BTF flag for Slave transmitter
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_SlaveTransmit_BTF(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   if (hi2c->XferCount != 0U)
 | |
|   {
 | |
|     /* Write data to DR */
 | |
|     hi2c->Instance->DR = *hi2c->pBuffPtr;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle RXNE flag for Slave
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_SlaveReceive_RXNE(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variables to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
| 
 | |
|   if (hi2c->XferCount != 0U)
 | |
|   {
 | |
|     /* Read data from DR */
 | |
|     *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
| 
 | |
|     if ((hi2c->XferCount == 0U) && (CurrentState == HAL_I2C_STATE_BUSY_RX_LISTEN))
 | |
|     {
 | |
|       /* Last Byte is received, disable Interrupt */
 | |
|       __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_BUF);
 | |
| 
 | |
|       /* Set state at HAL_I2C_STATE_LISTEN */
 | |
|       hi2c->PreviousState = I2C_STATE_SLAVE_BUSY_RX;
 | |
|       hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
| 
 | |
|       /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->SlaveRxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_SlaveRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle BTF flag for Slave receiver
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_SlaveReceive_BTF(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   if (hi2c->XferCount != 0U)
 | |
|   {
 | |
|     /* Read data from DR */
 | |
|     *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|     /* Increment Buffer pointer */
 | |
|     hi2c->pBuffPtr++;
 | |
| 
 | |
|     /* Update counter */
 | |
|     hi2c->XferCount--;
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle ADD flag for Slave
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @param  IT2Flags Interrupt2 flags to handle.
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_Slave_ADDR(I2C_HandleTypeDef *hi2c, uint32_t IT2Flags)
 | |
| {
 | |
|   uint8_t TransferDirection = I2C_DIRECTION_RECEIVE;
 | |
|   uint16_t SlaveAddrCode=0;
 | |
| 
 | |
|   if (((uint32_t)hi2c->State & (uint32_t)HAL_I2C_STATE_LISTEN) == (uint32_t)HAL_I2C_STATE_LISTEN)
 | |
|   {
 | |
|     /* Disable BUF interrupt, BUF enabling is manage through slave specific interface */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, (I2C_IT_BUF));
 | |
| 
 | |
|     /* Transfer Direction requested by Master */
 | |
|     if (I2C_CHECK_FLAG(IT2Flags, I2C_FLAG_TRA) == RESET)
 | |
|     {
 | |
|       TransferDirection = I2C_DIRECTION_TRANSMIT;
 | |
|     }
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     /* Call Slave Addr callback */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->AddrCallback(hi2c, TransferDirection, SlaveAddrCode);
 | |
| #else
 | |
|     HAL_I2C_AddrCallback(hi2c, TransferDirection, SlaveAddrCode);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Clear ADDR flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_ADDR);
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Handle STOPF flag for Slave
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_Slave_STOPF(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variable to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
| 
 | |
|   /* Disable EVT, BUF and ERR interrupt */
 | |
|   __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|   /* Clear STOPF flag */
 | |
|   __HAL_I2C_CLEAR_STOPFLAG(hi2c);
 | |
| 
 | |
|   /* Disable Acknowledge */
 | |
|   CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|   /* If a DMA is ongoing, Update handle size context */
 | |
|   if ((hi2c->Instance->CR2 & I2C_CR2_DMAEN) == I2C_CR2_DMAEN)
 | |
|   {
 | |
|     if ((CurrentState == HAL_I2C_STATE_BUSY_RX) || (CurrentState == HAL_I2C_STATE_BUSY_RX_LISTEN))
 | |
|     {
 | |
|       hi2c->XferCount = (uint16_t)(__HAL_DMA_GET_COUNTER(hi2c->hdmarx));
 | |
| 
 | |
|       if (hi2c->XferCount != 0U)
 | |
|       {
 | |
|         /* Set ErrorCode corresponding to a Non-Acknowledge */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_AF;
 | |
|       }
 | |
| 
 | |
|       /* Disable, stop the current DMA */
 | |
|       CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|       /* Abort DMA Xfer if any */
 | |
|       if (HAL_DMA_GetState(hi2c->hdmarx) != HAL_DMA_STATE_READY)
 | |
|       {
 | |
|         /* Set the I2C DMA Abort callback :
 | |
|         will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|         hi2c->hdmarx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|         /* Abort DMA RX */
 | |
|         if (HAL_DMA_Abort_IT(hi2c->hdmarx) != HAL_OK)
 | |
|         {
 | |
|           /* Call Directly XferAbortCallback function in case of error */
 | |
|           hi2c->hdmarx->XferAbortCallback(hi2c->hdmarx);
 | |
|         }
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       hi2c->XferCount = (uint16_t)(__HAL_DMA_GET_COUNTER(hi2c->hdmatx));
 | |
| 
 | |
|       if (hi2c->XferCount != 0U)
 | |
|       {
 | |
|         /* Set ErrorCode corresponding to a Non-Acknowledge */
 | |
|         hi2c->ErrorCode |= HAL_I2C_ERROR_AF;
 | |
|       }
 | |
| 
 | |
|       /* Disable, stop the current DMA */
 | |
|       CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|       /* Abort DMA Xfer if any */
 | |
|       if (HAL_DMA_GetState(hi2c->hdmatx) != HAL_DMA_STATE_READY)
 | |
|       {
 | |
|         /* Set the I2C DMA Abort callback :
 | |
|         will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|         hi2c->hdmatx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|         /* Abort DMA TX */
 | |
|         if (HAL_DMA_Abort_IT(hi2c->hdmatx) != HAL_OK)
 | |
|         {
 | |
|           /* Call Directly XferAbortCallback function in case of error */
 | |
|           hi2c->hdmatx->XferAbortCallback(hi2c->hdmatx);
 | |
|         }
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
|   /* All data are not transferred, so set error code accordingly */
 | |
|   if (hi2c->XferCount != 0U)
 | |
|   {
 | |
|     /* Store Last receive data if any */
 | |
|     if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == SET)
 | |
|     {
 | |
|       /* Read data from DR */
 | |
|       *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferCount--;
 | |
|     }
 | |
| 
 | |
|     /* Store Last receive data if any */
 | |
|     if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_RXNE) == SET)
 | |
|     {
 | |
|       /* Read data from DR */
 | |
|       *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
| 
 | |
|       /* Update counter */
 | |
|       hi2c->XferCount--;
 | |
|     }
 | |
| 
 | |
|     if (hi2c->XferCount != 0U)
 | |
|     {
 | |
|       /* Set ErrorCode corresponding to a Non-Acknowledge */
 | |
|       hi2c->ErrorCode |= HAL_I2C_ERROR_AF;
 | |
|     }
 | |
|   }
 | |
| 
 | |
|   if (hi2c->ErrorCode != HAL_I2C_ERROR_NONE)
 | |
|   {
 | |
|     /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
|     I2C_ITError(hi2c);
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     if (CurrentState == HAL_I2C_STATE_BUSY_RX_LISTEN)
 | |
|     {
 | |
|       /* Set state at HAL_I2C_STATE_LISTEN */
 | |
|       hi2c->PreviousState = I2C_STATE_NONE;
 | |
|       hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
| 
 | |
|       /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->SlaveRxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_SlaveRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
| 
 | |
|     if (hi2c->State == HAL_I2C_STATE_LISTEN)
 | |
|     {
 | |
|       hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
|       hi2c->PreviousState = I2C_STATE_NONE;
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|       /* Call the Listen Complete callback, to inform upper layer of the end of Listen usecase */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->ListenCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_ListenCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       if ((hi2c->PreviousState  == I2C_STATE_SLAVE_BUSY_RX) || (CurrentState == HAL_I2C_STATE_BUSY_RX))
 | |
|       {
 | |
|         hi2c->PreviousState = I2C_STATE_NONE;
 | |
|         hi2c->State = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->SlaveRxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_SlaveRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_Slave_AF(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variables to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
|   uint32_t CurrentXferOptions       = hi2c->XferOptions;
 | |
| 
 | |
|   if (((CurrentXferOptions ==  I2C_FIRST_AND_LAST_FRAME) || (CurrentXferOptions == I2C_LAST_FRAME)) && \
 | |
|       (CurrentState == HAL_I2C_STATE_LISTEN))
 | |
|   {
 | |
|     hi2c->XferOptions = I2C_NO_OPTION_FRAME;
 | |
| 
 | |
|     /* Disable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     /* Clear AF flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
| 
 | |
|     /* Disable Acknowledge */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|     hi2c->PreviousState = I2C_STATE_NONE;
 | |
|     hi2c->State         = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode          = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Call the Listen Complete callback, to inform upper layer of the end of Listen usecase */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->ListenCpltCallback(hi2c);
 | |
| #else
 | |
|     HAL_I2C_ListenCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
|   else if (CurrentState == HAL_I2C_STATE_BUSY_TX)
 | |
|   {
 | |
|     hi2c->XferOptions   = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->PreviousState = I2C_STATE_SLAVE_BUSY_TX;
 | |
|     hi2c->State         = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode          = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Disable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     /* Clear AF flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
| 
 | |
|     /* Disable Acknowledge */
 | |
|     CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->SlaveTxCpltCallback(hi2c);
 | |
| #else
 | |
|     HAL_I2C_SlaveTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Clear AF flag only */
 | |
|     /* State Listen, but XferOptions == FIRST or NEXT */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  I2C interrupts error process
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hi2c I2C handle.
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_ITError(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* Declaration of temporary variable to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
| 
 | |
|   if ((hi2c->Mode == HAL_I2C_MODE_MASTER) && (CurrentState == HAL_I2C_STATE_BUSY_RX))
 | |
|   {
 | |
|     /* Disable Pos bit in I2C CR1 when error occurred in Master/Mem Receive IT Process */
 | |
|     hi2c->Instance->CR1 &= ~I2C_CR1_POS;
 | |
|   }
 | |
| 
 | |
|   if (((uint32_t)CurrentState & (uint32_t)HAL_I2C_STATE_LISTEN) == (uint32_t)HAL_I2C_STATE_LISTEN)
 | |
|   {
 | |
|     /* keep HAL_I2C_STATE_LISTEN */
 | |
|     hi2c->PreviousState = I2C_STATE_NONE;
 | |
|     hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|     /* If state is an abort treatment on going, don't change state */
 | |
|     /* This change will be do later */
 | |
|     if ((READ_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN) != I2C_CR2_DMAEN) && (CurrentState != HAL_I2C_STATE_ABORT))
 | |
| #else
 | |
|     if (CurrentState != HAL_I2C_STATE_ABORT)
 | |
| #endif /* DMA1 or DMA */
 | |
|     {
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
|     }
 | |
|     hi2c->PreviousState = I2C_STATE_NONE;
 | |
|     hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|   }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
|   /* Abort DMA transfer */
 | |
|   if (READ_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN) == I2C_CR2_DMAEN)
 | |
|   {
 | |
|     hi2c->Instance->CR2 &= ~I2C_CR2_DMAEN;
 | |
| 
 | |
|     if (hi2c->hdmatx->State != HAL_DMA_STATE_READY)
 | |
|     {
 | |
|       /* Set the DMA Abort callback :
 | |
|       will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|       hi2c->hdmatx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|       if (HAL_DMA_Abort_IT(hi2c->hdmatx) != HAL_OK)
 | |
|       {
 | |
|         /* Disable I2C peripheral to prevent dummy data in buffer */
 | |
|         __HAL_I2C_DISABLE(hi2c);
 | |
| 
 | |
|         hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|         /* Call Directly XferAbortCallback function in case of error */
 | |
|         hi2c->hdmatx->XferAbortCallback(hi2c->hdmatx);
 | |
|       }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Set the DMA Abort callback :
 | |
|       will lead to call HAL_I2C_ErrorCallback() at end of DMA abort procedure */
 | |
|       hi2c->hdmarx->XferAbortCallback = I2C_DMAAbort;
 | |
| 
 | |
|       if (HAL_DMA_Abort_IT(hi2c->hdmarx) != HAL_OK)
 | |
|       {
 | |
|         /* Store Last receive data if any */
 | |
|         if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_RXNE) == SET)
 | |
|         {
 | |
|           /* Read data from DR */
 | |
|           *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|           /* Increment Buffer pointer */
 | |
|           hi2c->pBuffPtr++;
 | |
|         }
 | |
| 
 | |
|         /* Disable I2C peripheral to prevent dummy data in buffer */
 | |
|         __HAL_I2C_DISABLE(hi2c);
 | |
| 
 | |
|         hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|         /* Call Directly hi2c->hdmarx->XferAbortCallback function in case of error */
 | |
|         hi2c->hdmarx->XferAbortCallback(hi2c->hdmarx);
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   else if (hi2c->State == HAL_I2C_STATE_ABORT)
 | |
| #else
 | |
|   if (hi2c->State == HAL_I2C_STATE_ABORT)
 | |
| #endif /* DMA1 or DMA */
 | |
|   {
 | |
|     hi2c->State = HAL_I2C_STATE_READY;
 | |
|     hi2c->ErrorCode = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Store Last receive data if any */
 | |
|     if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_RXNE) == SET)
 | |
|     {
 | |
|       /* Read data from DR */
 | |
|       *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
|     }
 | |
| 
 | |
|     /* Disable I2C peripheral to prevent dummy data in buffer */
 | |
|     __HAL_I2C_DISABLE(hi2c);
 | |
| 
 | |
|     /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->AbortCpltCallback(hi2c);
 | |
| #else
 | |
|     HAL_I2C_AbortCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Store Last receive data if any */
 | |
|     if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_RXNE) == SET)
 | |
|     {
 | |
|       /* Read data from DR */
 | |
|       *hi2c->pBuffPtr = (uint8_t)hi2c->Instance->DR;
 | |
| 
 | |
|       /* Increment Buffer pointer */
 | |
|       hi2c->pBuffPtr++;
 | |
|     }
 | |
| 
 | |
|     /* Call user error callback */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->ErrorCallback(hi2c);
 | |
| #else
 | |
|     HAL_I2C_ErrorCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
|   /* STOP Flag is not set after a NACK reception */
 | |
|   /* So may inform upper layer that listen phase is stopped */
 | |
|   /* during NACK error treatment */
 | |
|   CurrentState = hi2c->State;
 | |
|   if (((hi2c->ErrorCode & HAL_I2C_ERROR_AF) == HAL_I2C_ERROR_AF) && (CurrentState == HAL_I2C_STATE_LISTEN))
 | |
|   {
 | |
|     /* Disable EVT, BUF and ERR interrupt */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_BUF | I2C_IT_ERR);
 | |
| 
 | |
|     hi2c->XferOptions   = I2C_NO_OPTION_FRAME;
 | |
|     hi2c->PreviousState = I2C_STATE_NONE;
 | |
|     hi2c->State         = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode          = HAL_I2C_MODE_NONE;
 | |
| 
 | |
|     /* Call the Listen Complete callback, to inform upper layer of the end of Listen usecase */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->ListenCpltCallback(hi2c);
 | |
| #else
 | |
|     HAL_I2C_ListenCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_MasterRequestWrite(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   /* Declaration of temporary variable to prevent undefined behavior of volatile usage */
 | |
|   uint32_t CurrentXferOptions = hi2c->XferOptions;
 | |
| 
 | |
|   /* Generate Start condition if first transfer */
 | |
|   if ((CurrentXferOptions == I2C_FIRST_AND_LAST_FRAME) || (CurrentXferOptions == I2C_FIRST_FRAME) || (CurrentXferOptions == I2C_NO_OPTION_FRAME))
 | |
|   {
 | |
|     /* Generate Start */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|   }
 | |
|   else if (hi2c->PreviousState == I2C_STATE_MASTER_BUSY_RX)
 | |
|   {
 | |
|     /* Generate ReStart */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Do nothing */
 | |
|   }
 | |
| 
 | |
|   /* Wait until SB flag is set */
 | |
|   if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_SB, RESET, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Send slave address */
 | |
|   hi2c->Instance->DR = I2C_7BIT_ADD_WRITE(DevAddress);
 | |
| 
 | |
|   /* Wait until ADDR flag is set */
 | |
|   if (I2C_WaitOnMasterAddressFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Master sends target device address for read request.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_MasterRequestRead(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   /* Declaration of temporary variable to prevent undefined behavior of volatile usage */
 | |
|   uint32_t CurrentXferOptions = hi2c->XferOptions;
 | |
| 
 | |
|   /* Enable Acknowledge */
 | |
|   SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|   /* Generate Start condition if first transfer */
 | |
|   if ((CurrentXferOptions == I2C_FIRST_AND_LAST_FRAME) || (CurrentXferOptions == I2C_FIRST_FRAME)  || (CurrentXferOptions == I2C_NO_OPTION_FRAME))
 | |
|   {
 | |
|     /* Generate Start */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|   }
 | |
|   else if (hi2c->PreviousState == I2C_STATE_MASTER_BUSY_TX)
 | |
|   {
 | |
|     /* Generate ReStart */
 | |
|     SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Do nothing */
 | |
|   }
 | |
| 
 | |
|   /* Wait until SB flag is set */
 | |
|   if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_SB, RESET, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
| 
 | |
|   /* Send slave address */
 | |
|   hi2c->Instance->DR = I2C_7BIT_ADD_READ(DevAddress);
 | |
| 
 | |
| 
 | |
| 
 | |
|   /* Wait until ADDR flag is set */
 | |
|   if (I2C_WaitOnMasterAddressFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Master sends target device address followed by internal memory address for write request.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_RequestMemoryWrite(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   /* Generate Start */
 | |
|   SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|   /* Wait until SB flag is set */
 | |
|   if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_SB, RESET, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Send slave address */
 | |
|   hi2c->Instance->DR = I2C_7BIT_ADD_WRITE(DevAddress);
 | |
| 
 | |
|   /* Wait until ADDR flag is set */
 | |
|   if (I2C_WaitOnMasterAddressFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Clear ADDR flag */
 | |
|   __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|   /* Wait until TXE flag is set */
 | |
|   if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|     {
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|     }
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* If Memory address size is 8Bit */
 | |
|   if (MemAddSize == I2C_MEMADD_SIZE_8BIT)
 | |
|   {
 | |
|     /* Send Memory Address */
 | |
|     hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
 | |
|   }
 | |
|   /* If Memory address size is 16Bit */
 | |
|   else
 | |
|   {
 | |
|     /* Send MSB of Memory Address */
 | |
|     hi2c->Instance->DR = I2C_MEM_ADD_MSB(MemAddress);
 | |
| 
 | |
|     /* Wait until TXE flag is set */
 | |
|     if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, Tickstart) != HAL_OK)
 | |
|     {
 | |
|       if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|       {
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|       }
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|     /* Send LSB of Memory Address */
 | |
|     hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
 | |
|     /* Wait until ADDR flag is set */
 | |
|   }
 | |
|   if (I2C_WaitOnMasterAddressFlagUntilTimeout(hi2c, I2C_FLAG_TXE, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Master sends target device address followed by internal memory address for read request.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @param  DevAddress Target device address: The device 7 bits address value
 | |
|   *         in datasheet must be shifted to the left before calling the interface
 | |
|   * @param  MemAddress Internal memory address
 | |
|   * @param  MemAddSize Size of internal memory address
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_RequestMemoryRead(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   /* Enable Acknowledge */
 | |
|   SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|   /* Generate Start */
 | |
|   SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|   /* Wait until SB flag is set */
 | |
|   if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_SB, RESET, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Send slave address */
 | |
|   hi2c->Instance->DR = I2C_7BIT_ADD_WRITE(DevAddress);
 | |
| 
 | |
|   /* Wait until ADDR flag is set */
 | |
|   if (I2C_WaitOnMasterAddressFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Clear ADDR flag */
 | |
|   __HAL_I2C_CLEAR_ADDRFLAG(hi2c);
 | |
| 
 | |
|   /* Wait until TXE flag is set */
 | |
|   if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|     {
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|     }
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* If Memory address size is 8Bit */
 | |
|   if (MemAddSize == I2C_MEMADD_SIZE_8BIT)
 | |
|   {
 | |
|     /* Send Memory Address */
 | |
|     hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
 | |
|   }
 | |
|   /* If Memory address size is 16Bit */
 | |
|   else
 | |
|   {
 | |
|     /* Send MSB of Memory Address */
 | |
|     hi2c->Instance->DR = I2C_MEM_ADD_MSB(MemAddress);
 | |
| 
 | |
|     /* Wait until TXE flag is set */
 | |
|     if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, Tickstart) != HAL_OK)
 | |
|     {
 | |
|       if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|       {
 | |
|         /* Generate Stop */
 | |
|         SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|       }
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Send LSB of Memory Address */
 | |
|     hi2c->Instance->DR = I2C_MEM_ADD_LSB(MemAddress);
 | |
|   }
 | |
| 
 | |
|   /* Wait until TXE flag is set */
 | |
|   if (I2C_WaitOnTXEFlagUntilTimeout(hi2c, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     if (hi2c->ErrorCode == HAL_I2C_ERROR_AF)
 | |
|     {
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|     }
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Generate Restart */
 | |
|   SET_BIT(hi2c->Instance->CR1, I2C_CR1_START);
 | |
| 
 | |
|   /* Wait until SB flag is set */
 | |
|   if (I2C_WaitOnFlagUntilTimeout(hi2c, I2C_FLAG_SB, RESET, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   /* Send slave address */
 | |
|   hi2c->Instance->DR = I2C_7BIT_ADD_READ(DevAddress);
 | |
| 
 | |
|   /* Wait until ADDR flag is set */
 | |
|   if (I2C_WaitOnMasterAddressFlagUntilTimeout(hi2c, I2C_FLAG_ADDR, Timeout, Tickstart) != HAL_OK)
 | |
|   {
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
| 
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| #if (defined(DMA1) || defined(DMA))
 | |
| /**
 | |
|   * @brief  DMA I2C process complete callback.
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hdma DMA handle
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_DMAXferCplt(DMA_HandleTypeDef *hdma)
 | |
| {
 | |
|   I2C_HandleTypeDef *hi2c = (I2C_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent; /* Derogation MISRAC2012-Rule-11.5 */
 | |
| 
 | |
|   /* Declaration of temporary variable to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
|   HAL_I2C_ModeTypeDef CurrentMode   = hi2c->Mode;
 | |
|   uint32_t CurrentXferOptions       = hi2c->XferOptions;
 | |
| 
 | |
|   /* Disable EVT and ERR interrupt */
 | |
|   __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|   /* Clear Complete callback */
 | |
|   hi2c->hdmatx->XferCpltCallback = NULL;
 | |
|   hi2c->hdmarx->XferCpltCallback = NULL;
 | |
| 
 | |
|   if ((((uint32_t)CurrentState & (uint32_t)HAL_I2C_STATE_BUSY_TX) == (uint32_t)HAL_I2C_STATE_BUSY_TX) || ((((uint32_t)CurrentState & (uint32_t)HAL_I2C_STATE_BUSY_RX) == (uint32_t)HAL_I2C_STATE_BUSY_RX) && (CurrentMode == HAL_I2C_MODE_SLAVE)))
 | |
|   {
 | |
|     /* Disable DMA Request */
 | |
|     CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|     hi2c->XferCount = 0U;
 | |
| 
 | |
|     if (CurrentState == HAL_I2C_STATE_BUSY_TX_LISTEN)
 | |
|     {
 | |
|       /* Set state at HAL_I2C_STATE_LISTEN */
 | |
|       hi2c->PreviousState = I2C_STATE_SLAVE_BUSY_TX;
 | |
|       hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
| 
 | |
|       /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->SlaveTxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_SlaveTxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|     else if (CurrentState == HAL_I2C_STATE_BUSY_RX_LISTEN)
 | |
|     {
 | |
|       /* Set state at HAL_I2C_STATE_LISTEN */
 | |
|       hi2c->PreviousState = I2C_STATE_SLAVE_BUSY_RX;
 | |
|       hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
| 
 | |
|       /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->SlaveRxCpltCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_SlaveRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       /* Do nothing */
 | |
|     }
 | |
| 
 | |
|     /* Enable EVT and ERR interrupt to treat end of transfer in IRQ handler */
 | |
|     __HAL_I2C_ENABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
|   }
 | |
|   /* Check current Mode, in case of treatment DMA handler have been preempted by a prior interrupt */
 | |
|   else if (hi2c->Mode != HAL_I2C_MODE_NONE)
 | |
|   {
 | |
|     if (hi2c->XferCount == (uint16_t)1)
 | |
|     {
 | |
|       /* Disable Acknowledge */
 | |
|       CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
|     }
 | |
| 
 | |
|     /* Disable EVT and ERR interrupt */
 | |
|     __HAL_I2C_DISABLE_IT(hi2c, I2C_IT_EVT | I2C_IT_ERR);
 | |
| 
 | |
|     /* Prepare next transfer or stop current transfer */
 | |
|     if ((CurrentXferOptions == I2C_NO_OPTION_FRAME) || (CurrentXferOptions == I2C_FIRST_AND_LAST_FRAME) || (CurrentXferOptions == I2C_OTHER_AND_LAST_FRAME) || (CurrentXferOptions == I2C_LAST_FRAME))
 | |
|     {
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
|     }
 | |
| 
 | |
|     /* Disable Last DMA */
 | |
|     CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_LAST);
 | |
| 
 | |
|     /* Disable DMA Request */
 | |
|     CLEAR_BIT(hi2c->Instance->CR2, I2C_CR2_DMAEN);
 | |
| 
 | |
|     hi2c->XferCount = 0U;
 | |
| 
 | |
|     /* Check if Errors has been detected during transfer */
 | |
|     if (hi2c->ErrorCode != HAL_I2C_ERROR_NONE)
 | |
|     {
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|       hi2c->ErrorCallback(hi2c);
 | |
| #else
 | |
|       HAL_I2C_ErrorCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
| 
 | |
|       if (hi2c->Mode == HAL_I2C_MODE_MEM)
 | |
|       {
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|         hi2c->PreviousState = I2C_STATE_NONE;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->MemRxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_MemRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|       else
 | |
|       {
 | |
|         hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|         hi2c->PreviousState = I2C_STATE_MASTER_BUSY_RX;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|         hi2c->MasterRxCpltCallback(hi2c);
 | |
| #else
 | |
|         HAL_I2C_MasterRxCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Do nothing */
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  DMA I2C communication error callback.
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param  hdma DMA handle
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_DMAError(DMA_HandleTypeDef *hdma)
 | |
| {
 | |
|   I2C_HandleTypeDef *hi2c = (I2C_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent; /* Derogation MISRAC2012-Rule-11.5 */
 | |
| 
 | |
|   /* Clear Complete callback */
 | |
|   hi2c->hdmatx->XferCpltCallback = NULL;
 | |
|   hi2c->hdmarx->XferCpltCallback = NULL;
 | |
| 
 | |
|   /* Disable Acknowledge */
 | |
|   CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|   hi2c->XferCount       = 0U;
 | |
|   hi2c->State           = HAL_I2C_STATE_READY;
 | |
|   hi2c->Mode            = HAL_I2C_MODE_NONE;
 | |
|   hi2c->ErrorCode       |= HAL_I2C_ERROR_DMA;
 | |
| 
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|   hi2c->ErrorCallback(hi2c);
 | |
| #else
 | |
|   HAL_I2C_ErrorCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief DMA I2C communication abort callback
 | |
|   *        (To be called at end of DMA Abort procedure).
 | |
|   * @note   Depending on devices and packages, DMA may not be available.
 | |
|   *         Refer to device datasheet for DMA availability.
 | |
|   * @param hdma DMA handle.
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_DMAAbort(DMA_HandleTypeDef *hdma)
 | |
| {
 | |
|   I2C_HandleTypeDef *hi2c = (I2C_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent; /* Derogation MISRAC2012-Rule-11.5 */
 | |
| 
 | |
|   /* Declaration of temporary variable to prevent undefined behavior of volatile usage */
 | |
|   HAL_I2C_StateTypeDef CurrentState = hi2c->State;
 | |
| 
 | |
|   /* Clear Complete callback */
 | |
|   hi2c->hdmatx->XferCpltCallback = NULL;
 | |
|   hi2c->hdmarx->XferCpltCallback = NULL;
 | |
| 
 | |
|   /* Disable Acknowledge */
 | |
|   CLEAR_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|   hi2c->XferCount = 0U;
 | |
| 
 | |
|   /* Reset XferAbortCallback */
 | |
|   hi2c->hdmatx->XferAbortCallback = NULL;
 | |
|   hi2c->hdmarx->XferAbortCallback = NULL;
 | |
| 
 | |
|   /* Disable I2C peripheral to prevent dummy data in buffer */
 | |
|   __HAL_I2C_DISABLE(hi2c);
 | |
| 
 | |
|   /* Check if come from abort from user */
 | |
|   if (hi2c->State == HAL_I2C_STATE_ABORT)
 | |
|   {
 | |
|     hi2c->State         = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode          = HAL_I2C_MODE_NONE;
 | |
|     hi2c->ErrorCode     = HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|     /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->AbortCpltCallback(hi2c);
 | |
| #else
 | |
|     HAL_I2C_AbortCpltCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     if (((uint32_t)CurrentState & (uint32_t)HAL_I2C_STATE_LISTEN) == (uint32_t)HAL_I2C_STATE_LISTEN)
 | |
|     {
 | |
|       /* Renable I2C peripheral */
 | |
|       __HAL_I2C_ENABLE(hi2c);
 | |
| 
 | |
|       /* Enable Acknowledge */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_ACK);
 | |
| 
 | |
|       /* keep HAL_I2C_STATE_LISTEN */
 | |
|       hi2c->PreviousState = I2C_STATE_NONE;
 | |
|       hi2c->State = HAL_I2C_STATE_LISTEN;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|       hi2c->State = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode = HAL_I2C_MODE_NONE;
 | |
|     }
 | |
| 
 | |
|     /* Call the corresponding callback to inform upper layer of End of Transfer */
 | |
| #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
 | |
|     hi2c->ErrorCallback(hi2c);
 | |
| #else
 | |
|     HAL_I2C_ErrorCallback(hi2c);
 | |
| #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */
 | |
|   }
 | |
| }
 | |
| #endif /* DMA1 or DMA */
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C Communication Timeout.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @param  Flag specifies the I2C flag to check.
 | |
|   * @param  Status The new Flag status (SET or RESET).
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_WaitOnFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Flag, FlagStatus Status, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   /* Wait until flag is set */
 | |
|   while (__HAL_I2C_GET_FLAG(hi2c, Flag) == Status)
 | |
|   {
 | |
|     /* Check for the Timeout */
 | |
|     if (Timeout != HAL_MAX_DELAY)
 | |
|     {
 | |
|       if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0U))
 | |
|       {
 | |
|         hi2c->PreviousState     = I2C_STATE_NONE;
 | |
|         hi2c->State             = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode              = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode         |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C Communication Timeout for Master addressing phase.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *         the configuration information for I2C module
 | |
|   * @param  Flag specifies the I2C flag to check.
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_WaitOnMasterAddressFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Flag, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   while (__HAL_I2C_GET_FLAG(hi2c, Flag) == RESET)
 | |
|   {
 | |
|     if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_AF) == SET)
 | |
|     {
 | |
|       /* Generate Stop */
 | |
|       SET_BIT(hi2c->Instance->CR1, I2C_CR1_STOP);
 | |
| 
 | |
|       /* Clear AF Flag */
 | |
|       __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
| 
 | |
|       hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|       hi2c->State               = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|       hi2c->ErrorCode           |= HAL_I2C_ERROR_AF;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Check for the Timeout */
 | |
|     if (Timeout != HAL_MAX_DELAY)
 | |
|     {
 | |
|       if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0U))
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C Communication Timeout for specific usage of TXE flag.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_WaitOnTXEFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_TXE) == RESET)
 | |
|   {
 | |
|     /* Check if a NACK is detected */
 | |
|     if (I2C_IsAcknowledgeFailed(hi2c) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Check for the Timeout */
 | |
|     if (Timeout != HAL_MAX_DELAY)
 | |
|     {
 | |
|       if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0U))
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C Communication Timeout for specific usage of BTF flag.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_WaitOnBTFFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_BTF) == RESET)
 | |
|   {
 | |
|     /* Check if a NACK is detected */
 | |
|     if (I2C_IsAcknowledgeFailed(hi2c) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Check for the Timeout */
 | |
|     if (Timeout != HAL_MAX_DELAY)
 | |
|     {
 | |
|       if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0U))
 | |
|       {
 | |
|         hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|         hi2c->State               = HAL_I2C_STATE_READY;
 | |
|         hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|         hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|         /* Process Unlocked */
 | |
|         __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|         return HAL_ERROR;
 | |
|       }
 | |
|     }
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C Communication Timeout for specific usage of STOP flag.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_WaitOnSTOPFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
|   while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_STOPF) == RESET)
 | |
|   {
 | |
|     /* Check if a NACK is detected */
 | |
|     if (I2C_IsAcknowledgeFailed(hi2c) != HAL_OK)
 | |
|     {
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Check for the Timeout */
 | |
|     if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0U))
 | |
|     {
 | |
|       hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|       hi2c->State               = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|       hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles I2C Communication Timeout for specific usage of RXNE flag.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @param  Timeout Timeout duration
 | |
|   * @param  Tickstart Tick start value
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_WaitOnRXNEFlagUntilTimeout(I2C_HandleTypeDef *hi2c, uint32_t Timeout, uint32_t Tickstart)
 | |
| {
 | |
| 
 | |
|   while (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_RXNE) == RESET)
 | |
|   {
 | |
|     /* Check if a STOPF is detected */
 | |
|     if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_STOPF) == SET)
 | |
|     {
 | |
|       /* Clear STOP Flag */
 | |
|       __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_STOPF);
 | |
| 
 | |
|       hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|       hi2c->State               = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|       hi2c->ErrorCode           |= HAL_I2C_ERROR_NONE;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
| 
 | |
|     /* Check for the Timeout */
 | |
|     if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0U))
 | |
|     {
 | |
|       hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|       hi2c->State               = HAL_I2C_STATE_READY;
 | |
|       hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|       hi2c->ErrorCode           |= HAL_I2C_ERROR_TIMEOUT;
 | |
| 
 | |
|       /* Process Unlocked */
 | |
|       __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|       return HAL_ERROR;
 | |
|     }
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  This function handles Acknowledge failed detection during an I2C Communication.
 | |
|   * @param  hi2c Pointer to a I2C_HandleTypeDef structure that contains
 | |
|   *                the configuration information for the specified I2C.
 | |
|   * @retval HAL status
 | |
|   */
 | |
| static HAL_StatusTypeDef I2C_IsAcknowledgeFailed(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   if (__HAL_I2C_GET_FLAG(hi2c, I2C_FLAG_AF) == SET)
 | |
|   {
 | |
|     /* Clear NACKF Flag */
 | |
|     __HAL_I2C_CLEAR_FLAG(hi2c, I2C_FLAG_AF);
 | |
| 
 | |
|     hi2c->PreviousState       = I2C_STATE_NONE;
 | |
|     hi2c->State               = HAL_I2C_STATE_READY;
 | |
|     hi2c->Mode                = HAL_I2C_MODE_NONE;
 | |
|     hi2c->ErrorCode           |= HAL_I2C_ERROR_AF;
 | |
| 
 | |
|     /* Process Unlocked */
 | |
|     __HAL_UNLOCK(hi2c);
 | |
| 
 | |
|     return HAL_ERROR;
 | |
|   }
 | |
|   return HAL_OK;
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @brief  Convert I2Cx OTHER_xxx XferOptions to functionnal XferOptions.
 | |
|   * @param  hi2c I2C handle.
 | |
|   * @retval None
 | |
|   */
 | |
| static void I2C_ConvertOtherXferOptions(I2C_HandleTypeDef *hi2c)
 | |
| {
 | |
|   /* if user set XferOptions to I2C_OTHER_FRAME            */
 | |
|   /* it request implicitly to generate a restart condition */
 | |
|   /* set XferOptions to I2C_FIRST_FRAME                    */
 | |
|   if (hi2c->XferOptions == I2C_OTHER_FRAME)
 | |
|   {
 | |
|     hi2c->XferOptions = I2C_FIRST_FRAME;
 | |
|   }
 | |
|   /* else if user set XferOptions to I2C_OTHER_AND_LAST_FRAME */
 | |
|   /* it request implicitly to generate a restart condition    */
 | |
|   /* then generate a stop condition at the end of transfer    */
 | |
|   /* set XferOptions to I2C_FIRST_AND_LAST_FRAME              */
 | |
|   else if (hi2c->XferOptions == I2C_OTHER_AND_LAST_FRAME)
 | |
|   {
 | |
|     hi2c->XferOptions = I2C_FIRST_AND_LAST_FRAME;
 | |
|   }
 | |
|   else
 | |
|   {
 | |
|     /* Nothing to do */
 | |
|   }
 | |
| }
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| #endif /* HAL_I2C_MODULE_ENABLED */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /************************ (C) COPYRIGHT Puya *****END OF FILE****/
 | 
