/** ****************************************************************************** * @file py32f0xx_ll_i2c.h * @author MCU Application Team * @brief Header file of I2C LL module. ****************************************************************************** * @attention * *

© Copyright (c) Puya Semiconductor Co. * All rights reserved.

* *

© Copyright (c) 2016 STMicroelectronics. * All rights reserved.

* * 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 * ****************************************************************************** */ /* Define to prevent recursive inclusion -------------------------------------*/ #ifndef __PY32F0xx_LL_I2C_H #define __PY32F0xx_LL_I2C_H #ifdef __cplusplus extern "C" { #endif /* Includes ------------------------------------------------------------------*/ #include "py32f0xx.h" /** @addtogroup PY32F0xx_LL_Driver * @{ */ #if defined (I2C1) || defined (I2C2) /** @defgroup I2C_LL I2C * @{ */ /* Private types -------------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* Private constants ---------------------------------------------------------*/ /** @defgroup I2C_LL_Private_Constants I2C Private Constants * @{ */ /* Defines used to perform compute and check in the macros */ #define LL_I2C_MAX_SPEED_STANDARD 100000U #define LL_I2C_MAX_SPEED_FAST 400000U /** * @} */ /* Private macros ------------------------------------------------------------*/ #if defined(USE_FULL_LL_DRIVER) /** @defgroup I2C_LL_Private_Macros I2C Private Macros * @{ */ /** * @} */ #endif /*USE_FULL_LL_DRIVER*/ /* Exported types ------------------------------------------------------------*/ #if defined(USE_FULL_LL_DRIVER) /** @defgroup I2C_LL_ES_INIT I2C Exported Init structure * @{ */ typedef struct { uint32_t ClockSpeed; /*!< Specifies the clock frequency. This parameter must be set to a value lower than 400kHz (in Hz) This feature can be modified afterwards using unitary function @ref LL_I2C_SetClockPeriod() or @ref LL_I2C_SetDutyCycle() or @ref LL_I2C_SetClockSpeedMode() or @ref LL_I2C_ConfigSpeed(). */ uint32_t DutyCycle; /*!< Specifies the I2C fast mode duty cycle. This parameter can be a value of @ref I2C_LL_EC_DUTYCYCLE This feature can be modified afterwards using unitary function @ref LL_I2C_SetDutyCycle(). */ uint32_t OwnAddress1; /*!< Specifies the device own address 1. This parameter must be a value between Min_Data = 0x00 and Max_Data = 0x3FF This feature can be modified afterwards using unitary function @ref LL_I2C_SetOwnAddress1(). */ uint32_t TypeAcknowledge; /*!< Specifies the ACKnowledge or Non ACKnowledge condition after the address receive match code or next received byte. This parameter can be a value of @ref I2C_LL_EC_I2C_ACKNOWLEDGE This feature can be modified afterwards using unitary function @ref LL_I2C_AcknowledgeNextData(). */ } LL_I2C_InitTypeDef; /** * @} */ #endif /*USE_FULL_LL_DRIVER*/ /* Exported constants --------------------------------------------------------*/ /** @defgroup I2C_LL_Exported_Constants I2C Exported Constants * @{ */ /** @defgroup I2C_LL_EC_GET_FLAG Get Flags Defines * @brief Flags defines which can be used with LL_I2C_ReadReg function * @{ */ #define LL_I2C_SR1_SB I2C_SR1_SB /*!< Start Bit (master mode) */ #define LL_I2C_SR1_ADDR I2C_SR1_ADDR /*!< Address sent (master mode) or Address matched flag (slave mode) */ #define LL_I2C_SR1_BTF I2C_SR1_BTF /*!< Byte Transfer Finished flag */ #define LL_I2C_SR1_STOPF I2C_SR1_STOPF /*!< Stop detection flag (slave mode) */ #define LL_I2C_SR1_RXNE I2C_SR1_RXNE /*!< Data register not empty (receivers) */ #define LL_I2C_SR1_TXE I2C_SR1_TXE /*!< Data register empty (transmitters) */ #define LL_I2C_SR1_BERR I2C_SR1_BERR /*!< Bus error */ #define LL_I2C_SR1_ARLO I2C_SR1_ARLO /*!< Arbitration lost */ #define LL_I2C_SR1_AF I2C_SR1_AF /*!< Acknowledge failure flag */ #define LL_I2C_SR1_OVR I2C_SR1_OVR /*!< Overrun/Underrun */ #define LL_I2C_SR1_PECERR I2C_SR1_PECERR /*!< PEC Error in reception (SMBus mode) */ #define LL_I2C_SR2_MSL I2C_SR2_MSL /*!< Master/Slave flag */ #define LL_I2C_SR2_BUSY I2C_SR2_BUSY /*!< Bus busy flag */ #define LL_I2C_SR2_TRA I2C_SR2_TRA /*!< Transmitter/receiver direction */ #define LL_I2C_SR2_GENCALL I2C_SR2_GENCALL /*!< General call address (Slave mode) */ /** * @} */ /** @defgroup I2C_LL_EC_IT IT Defines * @brief IT defines which can be used with LL_I2C_ReadReg and LL_I2C_WriteReg functions * @{ */ #define LL_I2C_CR2_ITEVTEN I2C_CR2_ITEVTEN /*!< Events interrupts enable */ #define LL_I2C_CR2_ITBUFEN I2C_CR2_ITBUFEN /*!< Buffer interrupts enable */ #define LL_I2C_CR2_ITERREN I2C_CR2_ITERREN /*!< Error interrupts enable */ /** * @} */ /** @defgroup I2C_LL_EC_DUTYCYCLE Fast Mode Duty Cycle * @{ */ #define LL_I2C_DUTYCYCLE_2 0x00000000U /*!< I2C fast mode Tlow/Thigh = 2 */ #define LL_I2C_DUTYCYCLE_16_9 I2C_CCR_DUTY /*!< I2C fast mode Tlow/Thigh = 16/9 */ /** * @} */ /** @defgroup I2C_LL_EC_CLOCK_SPEED_MODE Master Clock Speed Mode * @{ */ #define LL_I2C_CLOCK_SPEED_STANDARD_MODE 0x00000000U /*!< Master clock speed range is standard mode */ #define LL_I2C_CLOCK_SPEED_FAST_MODE I2C_CCR_FS /*!< Master clock speed range is fast mode */ /** * @} */ /** @defgroup I2C_LL_EC_I2C_ACKNOWLEDGE Acknowledge Generation * @{ */ #define LL_I2C_ACK I2C_CR1_ACK /*!< ACK is sent after current received byte. */ #define LL_I2C_NACK 0x00000000U /*!< NACK is sent after current received byte.*/ /** * @} */ /** @defgroup I2C_LL_EC_DIRECTION Read Write Direction * @{ */ #define LL_I2C_DIRECTION_WRITE I2C_SR2_TRA /*!< Bus is in write transfer */ #define LL_I2C_DIRECTION_READ 0x00000000U /*!< Bus is in read transfer */ /** * @} */ /** * @} */ /* Exported macro ------------------------------------------------------------*/ /** @defgroup I2C_LL_Exported_Macros I2C Exported Macros * @{ */ /** @defgroup I2C_LL_EM_WRITE_READ Common Write and read registers Macros * @{ */ /** * @brief Write a value in I2C register * @param __INSTANCE__ I2C Instance * @param __REG__ Register to be written * @param __VALUE__ Value to be written in the register * @retval None */ #define LL_I2C_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__)) /** * @brief Read a value in I2C register * @param __INSTANCE__ I2C Instance * @param __REG__ Register to be read * @retval Register value */ #define LL_I2C_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__) /** * @} */ /** @defgroup I2C_LL_EM_Exported_Macros_Helper Exported_Macros_Helper * @{ */ /** * @brief Convert Peripheral Clock Frequency in MHz. * @param __PCLK__ This parameter must be a value of peripheral clock (in Hz). * @retval Value of peripheral clock (in MHz) */ #define __LL_I2C_FREQ_HZ_TO_MHZ(__PCLK__) (uint32_t)((__PCLK__)/1000000U) /** * @brief Convert Peripheral Clock Frequency in Hz. * @param __PCLK__ This parameter must be a value of peripheral clock (in MHz). * @retval Value of peripheral clock (in Hz) */ #define __LL_I2C_FREQ_MHZ_TO_HZ(__PCLK__) (uint32_t)((__PCLK__)*1000000U) /** * @brief Compute I2C Clock rising time. * @param __FREQRANGE__ This parameter must be a value of peripheral clock (in MHz). * @param __SPEED__ This parameter must be a value lower than 400kHz (in Hz). * @retval Value between Min_Data=0x02 and Max_Data=0x3F */ #define __LL_I2C_RISE_TIME(__FREQRANGE__, __SPEED__) (uint32_t)(((__SPEED__) <= LL_I2C_MAX_SPEED_STANDARD) ? ((__FREQRANGE__) + 1U) : ((((__FREQRANGE__) * 300U) / 1000U) + 1U)) /** * @brief Compute Speed clock range to a Clock Control Register (I2C_CCR_CCR) value. * @param __PCLK__ This parameter must be a value of peripheral clock (in Hz). * @param __SPEED__ This parameter must be a value lower than 400kHz (in Hz). * @param __DUTYCYCLE__ This parameter can be one of the following values: * @arg @ref LL_I2C_DUTYCYCLE_2 * @arg @ref LL_I2C_DUTYCYCLE_16_9 * @retval Value between Min_Data=0x004 and Max_Data=0xFFF, except in FAST DUTY mode where Min_Data=0x001. */ #define __LL_I2C_SPEED_TO_CCR(__PCLK__, __SPEED__, __DUTYCYCLE__) (uint32_t)(((__SPEED__) <= LL_I2C_MAX_SPEED_STANDARD)? \ (__LL_I2C_SPEED_STANDARD_TO_CCR((__PCLK__), (__SPEED__))) : \ (__LL_I2C_SPEED_FAST_TO_CCR((__PCLK__), (__SPEED__), (__DUTYCYCLE__)))) /** * @brief Compute Speed Standard clock range to a Clock Control Register (I2C_CCR_CCR) value. * @param __PCLK__ This parameter must be a value of peripheral clock (in Hz). * @param __SPEED__ This parameter must be a value lower than 100kHz (in Hz). * @retval Value between Min_Data=0x004 and Max_Data=0xFFF. */ #define __LL_I2C_SPEED_STANDARD_TO_CCR(__PCLK__, __SPEED__) (uint32_t)(((((__PCLK__)/((__SPEED__) << 1U)) & I2C_CCR_CCR) < 4U)? 4U:((__PCLK__) / ((__SPEED__) << 1U))) /** * @brief Compute Speed Fast clock range to a Clock Control Register (I2C_CCR_CCR) value. * @param __PCLK__ This parameter must be a value of peripheral clock (in Hz). * @param __SPEED__ This parameter must be a value between Min_Data=100Khz and Max_Data=400Khz (in Hz). * @param __DUTYCYCLE__ This parameter can be one of the following values: * @arg @ref LL_I2C_DUTYCYCLE_2 * @arg @ref LL_I2C_DUTYCYCLE_16_9 * @retval Value between Min_Data=0x001 and Max_Data=0xFFF */ #define __LL_I2C_SPEED_FAST_TO_CCR(__PCLK__, __SPEED__, __DUTYCYCLE__) (uint32_t)(((__DUTYCYCLE__) == LL_I2C_DUTYCYCLE_2)? \ (((((__PCLK__) / ((__SPEED__) * 3U)) & I2C_CCR_CCR) == 0U)? 1U:((__PCLK__) / ((__SPEED__) * 3U))) : \ (((((__PCLK__) / ((__SPEED__) * 25U)) & I2C_CCR_CCR) == 0U)? 1U:((__PCLK__) / ((__SPEED__) * 25U)))) /** * @} */ /** * @} */ /* Exported functions --------------------------------------------------------*/ /** @defgroup I2C_LL_Exported_Functions I2C Exported Functions * @{ */ /** @defgroup I2C_LL_EF_Configuration Configuration * @{ */ /** * @brief Enable I2C peripheral (PE = 1). * @rmtoll CR1 PE LL_I2C_Enable * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_Enable(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR1, I2C_CR1_PE); } /** * @brief Disable I2C peripheral (PE = 0). * @rmtoll CR1 PE LL_I2C_Disable * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_Disable(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR1, I2C_CR1_PE); } /** * @brief Check if the I2C peripheral is enabled or disabled. * @rmtoll CR1 PE LL_I2C_IsEnabled * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabled(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR1, I2C_CR1_PE) == (I2C_CR1_PE)); } #if (defined(DMA1) || defined(DMA)) /** * @brief Enable DMA transmission requests. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 DMAEN LL_I2C_EnableDMAReq_TX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableDMAReq_TX(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_DMAEN); } /** * @brief Disable DMA transmission requests. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 DMAEN LL_I2C_DisableDMAReq_TX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableDMAReq_TX(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_DMAEN); } /** * @brief Check if DMA transmission requests are enabled or disabled. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 DMAEN LL_I2C_IsEnabledDMAReq_TX * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledDMAReq_TX(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_DMAEN) == (I2C_CR2_DMAEN)); } /** * @brief Enable DMA reception requests. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 DMAEN LL_I2C_EnableDMAReq_RX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableDMAReq_RX(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_DMAEN); } /** * @brief Disable DMA reception requests. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 DMAEN LL_I2C_DisableDMAReq_RX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableDMAReq_RX(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_DMAEN); } /** * @brief Check if DMA reception requests are enabled or disabled. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 DMAEN LL_I2C_IsEnabledDMAReq_RX * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledDMAReq_RX(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_DMAEN) == (I2C_CR2_DMAEN)); } /** * @brief Get the data register address used for DMA transfer. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll DR DR LL_I2C_DMA_GetRegAddr * @param I2Cx I2C Instance. * @retval Address of data register */ __STATIC_INLINE uint32_t LL_I2C_DMA_GetRegAddr(I2C_TypeDef *I2Cx) { return (uint32_t) & (I2Cx->DR); } #endif /* DMA1 or DMA */ /** * @brief Enable Clock stretching. * @note This bit can only be programmed when the I2C is disabled (PE = 0). * @rmtoll CR1 NOSTRETCH LL_I2C_EnableClockStretching * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableClockStretching(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR1, I2C_CR1_NOSTRETCH); } /** * @brief Disable Clock stretching. * @note This bit can only be programmed when the I2C is disabled (PE = 0). * @rmtoll CR1 NOSTRETCH LL_I2C_DisableClockStretching * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableClockStretching(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR1, I2C_CR1_NOSTRETCH); } /** * @brief Check if Clock stretching is enabled or disabled. * @rmtoll CR1 NOSTRETCH LL_I2C_IsEnabledClockStretching * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledClockStretching(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR1, I2C_CR1_NOSTRETCH) != (I2C_CR1_NOSTRETCH)); } /** * @brief Enable General Call. * @note When enabled the Address 0x00 is ACKed. * @rmtoll CR1 ENGC LL_I2C_EnableGeneralCall * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableGeneralCall(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR1, I2C_CR1_ENGC); } /** * @brief Disable General Call. * @note When disabled the Address 0x00 is NACKed. * @rmtoll CR1 ENGC LL_I2C_DisableGeneralCall * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableGeneralCall(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR1, I2C_CR1_ENGC); } /** * @brief Check if General Call is enabled or disabled. * @rmtoll CR1 ENGC LL_I2C_IsEnabledGeneralCall * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledGeneralCall(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR1, I2C_CR1_ENGC) == (I2C_CR1_ENGC)); } /** * @brief Set the Own Address1. * @param I2Cx I2C Instance. * @param OwnAddress1 This parameter must be a value between Min_Data=0 and Max_Data=0x3FF. * @param OwnAddrSize This parameter is not used, can pass 0. * @retval None */ __STATIC_INLINE void LL_I2C_SetOwnAddress1(I2C_TypeDef *I2Cx, uint32_t OwnAddress1, uint32_t OwnAddrSize) { (void)OwnAddrSize; MODIFY_REG(I2Cx->OAR1, I2C_OAR1_ADD1_7, OwnAddress1); } /** * @brief Configure the Peripheral clock frequency. * @rmtoll CR2 FREQ LL_I2C_SetPeriphClock * @param I2Cx I2C Instance. * @param PeriphClock Peripheral Clock (in Hz) * @retval None */ __STATIC_INLINE void LL_I2C_SetPeriphClock(I2C_TypeDef *I2Cx, uint32_t PeriphClock) { MODIFY_REG(I2Cx->CR2, I2C_CR2_FREQ, __LL_I2C_FREQ_HZ_TO_MHZ(PeriphClock)); } /** * @brief Get the Peripheral clock frequency. * @rmtoll CR2 FREQ LL_I2C_GetPeriphClock * @param I2Cx I2C Instance. * @retval Value of Peripheral Clock (in Hz) */ __STATIC_INLINE uint32_t LL_I2C_GetPeriphClock(I2C_TypeDef *I2Cx) { return (uint32_t)(__LL_I2C_FREQ_MHZ_TO_HZ(READ_BIT(I2Cx->CR2, I2C_CR2_FREQ))); } /** * @brief Configure the Duty cycle (Fast mode only). * @rmtoll CCR DUTY LL_I2C_SetDutyCycle * @param I2Cx I2C Instance. * @param DutyCycle This parameter can be one of the following values: * @arg @ref LL_I2C_DUTYCYCLE_2 * @arg @ref LL_I2C_DUTYCYCLE_16_9 * @retval None */ __STATIC_INLINE void LL_I2C_SetDutyCycle(I2C_TypeDef *I2Cx, uint32_t DutyCycle) { MODIFY_REG(I2Cx->CCR, I2C_CCR_DUTY, DutyCycle); } /** * @brief Get the Duty cycle (Fast mode only). * @rmtoll CCR DUTY LL_I2C_GetDutyCycle * @param I2Cx I2C Instance. * @retval Returned value can be one of the following values: * @arg @ref LL_I2C_DUTYCYCLE_2 * @arg @ref LL_I2C_DUTYCYCLE_16_9 */ __STATIC_INLINE uint32_t LL_I2C_GetDutyCycle(I2C_TypeDef *I2Cx) { return (uint32_t)(READ_BIT(I2Cx->CCR, I2C_CCR_DUTY)); } /** * @brief Configure the I2C master clock speed mode. * @rmtoll CCR FS LL_I2C_SetClockSpeedMode * @param I2Cx I2C Instance. * @param ClockSpeedMode This parameter can be one of the following values: * @arg @ref LL_I2C_CLOCK_SPEED_STANDARD_MODE * @arg @ref LL_I2C_CLOCK_SPEED_FAST_MODE * @retval None */ __STATIC_INLINE void LL_I2C_SetClockSpeedMode(I2C_TypeDef *I2Cx, uint32_t ClockSpeedMode) { MODIFY_REG(I2Cx->CCR, I2C_CCR_FS, ClockSpeedMode); } /** * @brief Get the the I2C master speed mode. * @rmtoll CCR FS LL_I2C_GetClockSpeedMode * @param I2Cx I2C Instance. * @retval Returned value can be one of the following values: * @arg @ref LL_I2C_CLOCK_SPEED_STANDARD_MODE * @arg @ref LL_I2C_CLOCK_SPEED_FAST_MODE */ __STATIC_INLINE uint32_t LL_I2C_GetClockSpeedMode(I2C_TypeDef *I2Cx) { return (uint32_t)(READ_BIT(I2Cx->CCR, I2C_CCR_FS)); } /** * @brief Configure the SCL, SDA rising time. * @note This bit can only be programmed when the I2C is disabled (PE = 0). * @rmtoll TRISE TRISE LL_I2C_SetRiseTime * @param I2Cx I2C Instance. * @param RiseTime This parameter must be a value between Min_Data=0x02 and Max_Data=0x3F. * @retval None */ __STATIC_INLINE void LL_I2C_SetRiseTime(I2C_TypeDef *I2Cx, uint32_t RiseTime) { MODIFY_REG(I2Cx->TRISE, I2C_TRISE_TRISE, RiseTime); } /** * @brief Get the SCL, SDA rising time. * @rmtoll TRISE TRISE LL_I2C_GetRiseTime * @param I2Cx I2C Instance. * @retval Value between Min_Data=0x02 and Max_Data=0x3F */ __STATIC_INLINE uint32_t LL_I2C_GetRiseTime(I2C_TypeDef *I2Cx) { return (uint32_t)(READ_BIT(I2Cx->TRISE, I2C_TRISE_TRISE)); } /** * @brief Configure the SCL high and low period. * @note This bit can only be programmed when the I2C is disabled (PE = 0). * @rmtoll CCR CCR LL_I2C_SetClockPeriod * @param I2Cx I2C Instance. * @param ClockPeriod This parameter must be a value between Min_Data=0x004 and Max_Data=0xFFF, except in FAST DUTY mode where Min_Data=0x001. * @retval None */ __STATIC_INLINE void LL_I2C_SetClockPeriod(I2C_TypeDef *I2Cx, uint32_t ClockPeriod) { MODIFY_REG(I2Cx->CCR, I2C_CCR_CCR, ClockPeriod); } /** * @brief Get the SCL high and low period. * @rmtoll CCR CCR LL_I2C_GetClockPeriod * @param I2Cx I2C Instance. * @retval Value between Min_Data=0x004 and Max_Data=0xFFF, except in FAST DUTY mode where Min_Data=0x001. */ __STATIC_INLINE uint32_t LL_I2C_GetClockPeriod(I2C_TypeDef *I2Cx) { return (uint32_t)(READ_BIT(I2Cx->CCR, I2C_CCR_CCR)); } /** * @brief Configure the SCL speed. * @note This bit can only be programmed when the I2C is disabled (PE = 0). * @rmtoll CR2 FREQ LL_I2C_ConfigSpeed\n * TRISE TRISE LL_I2C_ConfigSpeed\n * CCR FS LL_I2C_ConfigSpeed\n * CCR DUTY LL_I2C_ConfigSpeed\n * CCR CCR LL_I2C_ConfigSpeed * @param I2Cx I2C Instance. * @param PeriphClock Peripheral Clock (in Hz) * @param ClockSpeed This parameter must be a value lower than 400kHz (in Hz). * @param DutyCycle This parameter can be one of the following values: * @arg @ref LL_I2C_DUTYCYCLE_2 * @arg @ref LL_I2C_DUTYCYCLE_16_9 * @retval None */ __STATIC_INLINE void LL_I2C_ConfigSpeed(I2C_TypeDef *I2Cx, uint32_t PeriphClock, uint32_t ClockSpeed, uint32_t DutyCycle) { register uint32_t freqrange = 0x0U; register uint32_t clockconfig = 0x0U; /* Compute frequency range */ freqrange = __LL_I2C_FREQ_HZ_TO_MHZ(PeriphClock); /* Configure I2Cx: Frequency range register */ MODIFY_REG(I2Cx->CR2, I2C_CR2_FREQ, freqrange); /* Configure I2Cx: Rise Time register */ MODIFY_REG(I2Cx->TRISE, I2C_TRISE_TRISE, __LL_I2C_RISE_TIME(freqrange, ClockSpeed)); /* Configure Speed mode, Duty Cycle and Clock control register value */ if (ClockSpeed > LL_I2C_MAX_SPEED_STANDARD) { /* Set Speed mode at fast and duty cycle for Clock Speed request in fast clock range */ clockconfig = LL_I2C_CLOCK_SPEED_FAST_MODE | \ __LL_I2C_SPEED_FAST_TO_CCR(PeriphClock, ClockSpeed, DutyCycle) | \ DutyCycle; } else { /* Set Speed mode at standard for Clock Speed request in standard clock range */ clockconfig = LL_I2C_CLOCK_SPEED_STANDARD_MODE | \ __LL_I2C_SPEED_STANDARD_TO_CCR(PeriphClock, ClockSpeed); } /* Configure I2Cx: Clock control register */ MODIFY_REG(I2Cx->CCR, (I2C_CCR_FS | I2C_CCR_DUTY | I2C_CCR_CCR), clockconfig); } /** * @} */ /** @defgroup I2C_LL_EF_IT_Management IT_Management * @{ */ /** * @brief Enable TXE interrupt. * @rmtoll CR2 ITEVTEN LL_I2C_EnableIT_TX\n * CR2 ITBUFEN LL_I2C_EnableIT_TX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableIT_TX(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN); } /** * @brief Disable TXE interrupt. * @rmtoll CR2 ITEVTEN LL_I2C_DisableIT_TX\n * CR2 ITBUFEN LL_I2C_DisableIT_TX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableIT_TX(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN); } /** * @brief Check if the TXE Interrupt is enabled or disabled. * @rmtoll CR2 ITEVTEN LL_I2C_IsEnabledIT_TX\n * CR2 ITBUFEN LL_I2C_IsEnabledIT_TX * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledIT_TX(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN) == (I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN)); } /** * @brief Enable RXNE interrupt. * @rmtoll CR2 ITEVTEN LL_I2C_EnableIT_RX\n * CR2 ITBUFEN LL_I2C_EnableIT_RX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableIT_RX(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN); } /** * @brief Disable RXNE interrupt. * @rmtoll CR2 ITEVTEN LL_I2C_DisableIT_RX\n * CR2 ITBUFEN LL_I2C_DisableIT_RX * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableIT_RX(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN); } /** * @brief Check if the RXNE Interrupt is enabled or disabled. * @rmtoll CR2 ITEVTEN LL_I2C_IsEnabledIT_RX\n * CR2 ITBUFEN LL_I2C_IsEnabledIT_RX * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledIT_RX(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN) == (I2C_CR2_ITEVTEN | I2C_CR2_ITBUFEN)); } /** * @brief Enable Events interrupts. * @note Any of these events will generate interrupt : * Start Bit (SB) * Address sent, Address matched (ADDR) * Stop detection (STOPF) * Byte transfer finished (BTF) * * @note Any of these events will generate interrupt if Buffer interrupts are enabled too(using unitary function @ref LL_I2C_EnableIT_BUF()) : * Receive buffer not empty (RXNE) * Transmit buffer empty (TXE) * @rmtoll CR2 ITEVTEN LL_I2C_EnableIT_EVT * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableIT_EVT(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN); } /** * @brief Disable Events interrupts. * @note Any of these events will generate interrupt : * Start Bit (SB) * Address sent, Address matched (ADDR) * Stop detection (STOPF) * Byte transfer finished (BTF) * Receive buffer not empty (RXNE) * Transmit buffer empty (TXE) * @rmtoll CR2 ITEVTEN LL_I2C_DisableIT_EVT * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableIT_EVT(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN); } /** * @brief Check if Events interrupts are enabled or disabled. * @rmtoll CR2 ITEVTEN LL_I2C_IsEnabledIT_EVT * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledIT_EVT(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_ITEVTEN) == (I2C_CR2_ITEVTEN)); } /** * @brief Enable Buffer interrupts. * @note Any of these Buffer events will generate interrupt if Events interrupts are enabled too(using unitary function @ref LL_I2C_EnableIT_EVT()) : * Receive buffer not empty (RXNE) * Transmit buffer empty (TXE) * @rmtoll CR2 ITBUFEN LL_I2C_EnableIT_BUF * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableIT_BUF(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_ITBUFEN); } /** * @brief Disable Buffer interrupts. * @note Any of these Buffer events will generate interrupt : * Receive buffer not empty (RXNE) * Transmit buffer empty (TXE) * @rmtoll CR2 ITBUFEN LL_I2C_DisableIT_BUF * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableIT_BUF(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_ITBUFEN); } /** * @brief Check if Buffer interrupts are enabled or disabled. * @rmtoll CR2 ITBUFEN LL_I2C_IsEnabledIT_BUF * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledIT_BUF(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_ITBUFEN) == (I2C_CR2_ITBUFEN)); } /** * @brief Enable Error interrupts. * @note Macro @ref IS_SMBUS_ALL_INSTANCE(I2Cx) can be used to check whether or not * SMBus feature is supported by the I2Cx Instance. * @note Any of these errors will generate interrupt : * Bus Error detection (BERR) * Arbitration Loss (ARLO) * Acknowledge Failure(AF) * Overrun/Underrun (OVR) * @rmtoll CR2 ITERREN LL_I2C_EnableIT_ERR * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableIT_ERR(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_ITERREN); } /** * @brief Disable Error interrupts. * @note Macro @ref IS_SMBUS_ALL_INSTANCE(I2Cx) can be used to check whether or not * SMBus feature is supported by the I2Cx Instance. * @note Any of these errors will generate interrupt : * Bus Error detection (BERR) * Arbitration Loss (ARLO) * Acknowledge Failure(AF) * Overrun/Underrun (OVR) * SMBus Timeout detection (TIMEOUT) * SMBus PEC error detection (PECERR) * SMBus Alert pin event detection (SMBALERT) * @rmtoll CR2 ITERREN LL_I2C_DisableIT_ERR * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableIT_ERR(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_ITERREN); } /** * @brief Check if Error interrupts are enabled or disabled. * @rmtoll CR2 ITERREN LL_I2C_IsEnabledIT_ERR * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledIT_ERR(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_ITERREN) == (I2C_CR2_ITERREN)); } /** * @} */ /** @defgroup I2C_LL_EF_FLAG_management FLAG_management * @{ */ /** * @brief Indicate the status of Transmit data register empty flag. * @note RESET: When next data is written in Transmit data register. * SET: When Transmit data register is empty. * @rmtoll SR1 TXE LL_I2C_IsActiveFlag_TXE * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_TXE(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_TXE) == (I2C_SR1_TXE)); } /** * @brief Indicate the status of Byte Transfer Finished flag. * RESET: When Data byte transfer not done. * SET: When Data byte transfer succeeded. * @rmtoll SR1 BTF LL_I2C_IsActiveFlag_BTF * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_BTF(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_BTF) == (I2C_SR1_BTF)); } /** * @brief Indicate the status of Receive data register not empty flag. * @note RESET: When Receive data register is read. * SET: When the received data is copied in Receive data register. * @rmtoll SR1 RXNE LL_I2C_IsActiveFlag_RXNE * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_RXNE(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_RXNE) == (I2C_SR1_RXNE)); } /** * @brief Indicate the status of Start Bit (master mode). * @note RESET: When No Start condition. * SET: When Start condition is generated. * @rmtoll SR1 SB LL_I2C_IsActiveFlag_SB * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_SB(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_SB) == (I2C_SR1_SB)); } /** * @brief Indicate the status of Address sent (master mode) or Address matched flag (slave mode). * @note RESET: Clear default value. * SET: When the address is fully sent (master mode) or when the received slave address matched with one of the enabled slave address (slave mode). * @rmtoll SR1 ADDR LL_I2C_IsActiveFlag_ADDR * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_ADDR(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_ADDR) == (I2C_SR1_ADDR)); } /** * @brief Indicate the status of Acknowledge failure flag. * @note RESET: No acknowledge failure. * SET: When an acknowledge failure is received after a byte transmission. * @rmtoll SR1 AF LL_I2C_IsActiveFlag_AF * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_AF(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_AF) == (I2C_SR1_AF)); } /** * @brief Indicate the status of Stop detection flag (slave mode). * @note RESET: Clear default value. * SET: When a Stop condition is detected. * @rmtoll SR1 STOPF LL_I2C_IsActiveFlag_STOP * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_STOP(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_STOPF) == (I2C_SR1_STOPF)); } /** * @brief Indicate the status of Bus error flag. * @note RESET: Clear default value. * SET: When a misplaced Start or Stop condition is detected. * @rmtoll SR1 BERR LL_I2C_IsActiveFlag_BERR * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_BERR(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_BERR) == (I2C_SR1_BERR)); } /** * @brief Indicate the status of Arbitration lost flag. * @note RESET: Clear default value. * SET: When arbitration lost. * @rmtoll SR1 ARLO LL_I2C_IsActiveFlag_ARLO * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_ARLO(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_ARLO) == (I2C_SR1_ARLO)); } /** * @brief Indicate the status of Overrun/Underrun flag. * @note RESET: Clear default value. * SET: When an overrun/underrun error occurs (Clock Stretching Disabled). * @rmtoll SR1 OVR LL_I2C_IsActiveFlag_OVR * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_OVR(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_OVR) == (I2C_SR1_OVR)); } /** * @brief Indicate the status of SMBus PEC error flag in reception. * @note Macro @ref IS_SMBUS_ALL_INSTANCE(I2Cx) can be used to check whether or not * SMBus feature is supported by the I2Cx Instance. * @rmtoll SR1 PECERR LL_I2C_IsActiveSMBusFlag_PECERR * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveSMBusFlag_PECERR(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR1, I2C_SR1_PECERR) == (I2C_SR1_PECERR)); } /** * @brief Indicate the status of Bus Busy flag. * @note RESET: Clear default value. * SET: When a Start condition is detected. * @rmtoll SR2 BUSY LL_I2C_IsActiveFlag_BUSY * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_BUSY(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR2, I2C_SR2_BUSY) == (I2C_SR2_BUSY)); } /** * @brief Indicate the status of General call address reception (Slave mode). * @note RESET: No Generall call address * SET: General call address received. * @note This status is cleared by hardware after a STOP condition or repeated START condition. * @rmtoll SR2 GENCALL LL_I2C_IsActiveFlag_GENCALL * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_GENCALL(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR2, I2C_SR2_GENCALL) == (I2C_SR2_GENCALL)); } /** * @brief Indicate the status of Master/Slave flag. * @note RESET: Slave Mode. * SET: Master Mode. * @rmtoll SR2 MSL LL_I2C_IsActiveFlag_MSL * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsActiveFlag_MSL(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->SR2, I2C_SR2_MSL) == (I2C_SR2_MSL)); } /** * @brief Clear Address Matched flag. * @note Clearing this flag is done by a read access to the I2Cx_SR1 * register followed by a read access to the I2Cx_SR2 register. * @rmtoll SR1 ADDR LL_I2C_ClearFlag_ADDR * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_ClearFlag_ADDR(I2C_TypeDef *I2Cx) { __IO uint32_t tmpreg; tmpreg = I2Cx->SR1; (void) tmpreg; tmpreg = I2Cx->SR2; (void) tmpreg; } /** * @brief Clear Acknowledge failure flag. * @rmtoll SR1 AF LL_I2C_ClearFlag_AF * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_ClearFlag_AF(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->SR1, I2C_SR1_AF); } /** * @brief Clear Stop detection flag. * @note Clearing this flag is done by a read access to the I2Cx_SR1 * register followed by a write access to I2Cx_CR1 register. * @rmtoll SR1 STOPF LL_I2C_ClearFlag_STOP\n * CR1 PE LL_I2C_ClearFlag_STOP * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_ClearFlag_STOP(I2C_TypeDef *I2Cx) { __IO uint32_t tmpreg; tmpreg = I2Cx->SR1; (void) tmpreg; SET_BIT(I2Cx->CR1, I2C_CR1_PE); } /** * @brief Clear Bus error flag. * @rmtoll SR1 BERR LL_I2C_ClearFlag_BERR * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_ClearFlag_BERR(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->SR1, I2C_SR1_BERR); } /** * @brief Clear Arbitration lost flag. * @rmtoll SR1 ARLO LL_I2C_ClearFlag_ARLO * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_ClearFlag_ARLO(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->SR1, I2C_SR1_ARLO); } /** * @brief Clear Overrun/Underrun flag. * @rmtoll SR1 OVR LL_I2C_ClearFlag_OVR * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_ClearFlag_OVR(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->SR1, I2C_SR1_OVR); } /** * @brief Clear SMBus PEC error flag. * @rmtoll SR1 PECERR LL_I2C_ClearSMBusFlag_PECERR * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_ClearSMBusFlag_PECERR(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->SR1, I2C_SR1_PECERR); } /** * @} */ /** @defgroup I2C_LL_EF_Data_Management Data_Management * @{ */ /** * @brief Enable Reset of I2C peripheral. * @rmtoll CR1 SWRST LL_I2C_EnableReset * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableReset(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR1, I2C_CR1_SWRST); } /** * @brief Disable Reset of I2C peripheral. * @rmtoll CR1 SWRST LL_I2C_DisableReset * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableReset(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR1, I2C_CR1_SWRST); } /** * @brief Check if the I2C peripheral is under reset state or not. * @rmtoll CR1 SWRST LL_I2C_IsResetEnabled * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsResetEnabled(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR1, I2C_CR1_SWRST) == (I2C_CR1_SWRST)); } /** * @brief Prepare the generation of a ACKnowledge or Non ACKnowledge condition after the address receive match code or next received byte. * @note Usage in Slave or Master mode. * @rmtoll CR1 ACK LL_I2C_AcknowledgeNextData * @param I2Cx I2C Instance. * @param TypeAcknowledge This parameter can be one of the following values: * @arg @ref LL_I2C_ACK * @arg @ref LL_I2C_NACK * @retval None */ __STATIC_INLINE void LL_I2C_AcknowledgeNextData(I2C_TypeDef *I2Cx, uint32_t TypeAcknowledge) { MODIFY_REG(I2Cx->CR1, I2C_CR1_ACK, TypeAcknowledge); } /** * @brief Generate a START or RESTART condition * @note The START bit can be set even if bus is BUSY or I2C is in slave mode. * This action has no effect when RELOAD is set. * @rmtoll CR1 START LL_I2C_GenerateStartCondition * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_GenerateStartCondition(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR1, I2C_CR1_START); } /** * @brief Generate a STOP condition after the current byte transfer (master mode). * @rmtoll CR1 STOP LL_I2C_GenerateStopCondition * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_GenerateStopCondition(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR1, I2C_CR1_STOP); } /** * @brief Enable bit POS (master/host mode). * @note In that case, the ACK bit controls the (N)ACK of the next byte received or the PEC bit indicates that the next byte in shift register is a PEC. * @rmtoll CR1 POS LL_I2C_EnableBitPOS * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableBitPOS(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR1, I2C_CR1_POS); } /** * @brief Disable bit POS (master/host mode). * @note In that case, the ACK bit controls the (N)ACK of the current byte received or the PEC bit indicates that the current byte in shift register is a PEC. * @rmtoll CR1 POS LL_I2C_DisableBitPOS * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableBitPOS(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR1, I2C_CR1_POS); } /** * @brief Check if bit POS is enabled or disabled. * @rmtoll CR1 POS LL_I2C_IsEnabledBitPOS * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledBitPOS(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR1, I2C_CR1_POS) == (I2C_CR1_POS)); } /** * @brief Indicate the value of transfer direction. * @note RESET: Bus is in read transfer (peripheral point of view). * SET: Bus is in write transfer (peripheral point of view). * @rmtoll SR2 TRA LL_I2C_GetTransferDirection * @param I2Cx I2C Instance. * @retval Returned value can be one of the following values: * @arg @ref LL_I2C_DIRECTION_WRITE * @arg @ref LL_I2C_DIRECTION_READ */ __STATIC_INLINE uint32_t LL_I2C_GetTransferDirection(I2C_TypeDef *I2Cx) { return (uint32_t)(READ_BIT(I2Cx->SR2, I2C_SR2_TRA)); } #if (defined(DMA1) || defined(DMA)) /** * @brief Enable DMA last transfer. * @note This action mean that next DMA EOT is the last transfer. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 LAST LL_I2C_EnableLastDMA * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_EnableLastDMA(I2C_TypeDef *I2Cx) { SET_BIT(I2Cx->CR2, I2C_CR2_LAST); } /** * @brief Disable DMA last transfer. * @note This action mean that next DMA EOT is not the last transfer. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 LAST LL_I2C_DisableLastDMA * @param I2Cx I2C Instance. * @retval None */ __STATIC_INLINE void LL_I2C_DisableLastDMA(I2C_TypeDef *I2Cx) { CLEAR_BIT(I2Cx->CR2, I2C_CR2_LAST); } /** * @brief Check if DMA last transfer is enabled or disabled. * @note Depending on devices and packages, DMA may not be available. * Refer to device datasheet for DMA availability. * @rmtoll CR2 LAST LL_I2C_IsEnabledLastDMA * @param I2Cx I2C Instance. * @retval State of bit (1 or 0). */ __STATIC_INLINE uint32_t LL_I2C_IsEnabledLastDMA(I2C_TypeDef *I2Cx) { return (READ_BIT(I2Cx->CR2, I2C_CR2_LAST) == (I2C_CR2_LAST)); } #endif /* DMA1 or DMA */ /** * @brief Read Receive Data register. * @rmtoll DR DR LL_I2C_ReceiveData8 * @param I2Cx I2C Instance. * @retval Value between Min_Data=0x0 and Max_Data=0xFF */ __STATIC_INLINE uint8_t LL_I2C_ReceiveData8(I2C_TypeDef *I2Cx) { return (uint8_t)(READ_BIT(I2Cx->DR, I2C_DR_DR)); } /** * @brief Write in Transmit Data Register . * @rmtoll DR DR LL_I2C_TransmitData8 * @param I2Cx I2C Instance. * @param Data Value between Min_Data=0x0 and Max_Data=0xFF * @retval None */ __STATIC_INLINE void LL_I2C_TransmitData8(I2C_TypeDef *I2Cx, uint8_t Data) { MODIFY_REG(I2Cx->DR, I2C_DR_DR, Data); } /** * @} */ #if defined(USE_FULL_LL_DRIVER) /** @defgroup I2C_LL_EF_Init Initialization and de-initialization functions * @{ */ uint32_t LL_I2C_Init(I2C_TypeDef *I2Cx, LL_I2C_InitTypeDef *I2C_InitStruct); uint32_t LL_I2C_DeInit(I2C_TypeDef *I2Cx); void LL_I2C_StructInit(LL_I2C_InitTypeDef *I2C_InitStruct); /** * @} */ #endif /* USE_FULL_LL_DRIVER */ /** * @} */ /** * @} */ #endif /* I2C1 || I2C2 */ /** * @} */ #ifdef __cplusplus } #endif #endif /* __PY32F0xx_LL_I2C_H */ /************************ (C) COPYRIGHT Puya *****END OF FILE****/