Diff: targets/TARGET_NUVOTON/TARGET_NANO100/device/StdDriver/nano100_i2c.h

Revision:

174:b96e65c34a4d

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/targets/TARGET_NUVOTON/TARGET_NANO100/device/StdDriver/nano100_i2c.h	Mon Oct 02 15:33:19 2017 +0100
@@ -0,0 +1,181 @@
+/****************************************************************************//**
+ * @file     i2c.h
+ * @version  V1.00
+ * $Revision: 5 $
+ * $Date: 15/06/05 5:06p $
+ * @brief    Nano100 series I2C driver header file
+ *
+ * @note
+ * Copyright (C) 2014 Nuvoton Technology Corp. All rights reserved.
+*****************************************************************************/
+#ifndef __I2C_H__
+#define __I2C_H__
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+
+/** @addtogroup NANO100_Device_Driver NANO100 Device Driver
+  @{
+*/
+
+/** @addtogroup NANO100_I2C_Driver I2C Driver
+  @{
+*/
+
+/** @addtogroup NANO100_I2C_EXPORTED_CONSTANTS I2C Exported Constants
+  @{
+*/
+
+#define I2C_STA 0x08    /*!< I2C START bit value */
+#define I2C_STO 0x04    /*!< I2C STOP bit value*/
+#define I2C_SI  0x10    /*!< I2C SI bit value */
+#define I2C_AA  0x02    /*!< I2C ACK bit value */
+
+#define I2C_GCMODE_ENABLE   1    /*!< Enable I2C GC Mode */
+#define I2C_GCMODE_DISABLE  0    /*!< Disable I2C GC Mode */
+
+/*@}*/ /* end of group NANO100_I2C_EXPORTED_CONSTANTS */
+
+
+/** @addtogroup NANO100_I2C_EXPORTED_FUNCTIONS I2C Exported Functions
+  @{
+*/
+
+/**
+  * @brief This macro sets the I2C control register at one time.
+  * @param[in] i2c is the base address of I2C module.
+  * @param[in] u8Ctrl is the register value of I2C control register.
+  * @return none
+  * \hideinitializer
+  */
+#define I2C_SET_CONTROL_REG(i2c, u8Ctrl) ( (i2c)->CON = ((i2c)->CON & ~0x1e) | u8Ctrl )
+
+/**
+  * @brief This macro only set START bit to the control register of I2C module.
+  * @param[in] i2c is the base address of I2C module.
+  * @return none
+  * \hideinitializer
+  */
+#define I2C_START(i2c) ( (i2c)->CON = ((i2c)->CON & ~I2C_CON_I2C_STS_Msk) | I2C_CON_START_Msk )
+
+/**
+  * @brief This macro only set STOP bit to the control register of I2C module.
+  * @param[in] i2c is the base address of I2C module.
+  * @return none
+  * \hideinitializer
+  */
+static __INLINE void I2C_STOP(I2C_T *i2c)
+{
+    i2c->CON |= (I2C_CON_I2C_STS_Msk | I2C_CON_STOP_Msk);
+    while(i2c->CON & I2C_CON_STOP_Msk);
+}
+
+/**
+  * @brief This macro will return when I2C module is ready.
+  * @param[in] i2c is the base address of I2C module.
+  * @return none
+  * \hideinitializer
+  */
+static __INLINE void I2C_WAIT_READY(I2C_T *i2c)
+{
+    while(!(i2c->INTSTS & I2C_INTSTS_INTSTS_Msk));
+    i2c->INTSTS |= I2C_INTSTS_INTSTS_Msk;
+}
+
+/**
+  * @brief This macro returns the data stored in data register of I2C module.
+  * @param[in] i2c is the base address of I2C module.
+  * @return Data.
+  * \hideinitializer
+  */
+#define I2C_GET_DATA(i2c) ( (i2c)->DATA )
+
+/**
+  * @brief This macro writes the data to data register of I2C module.
+  * @param[in] i2c is the base address of I2C module.
+  * @param[in] u8Data is the data which will be write to data register of I2C module.
+  * @return none
+  * \hideinitializer
+  */
+#define I2C_SET_DATA(i2c, u8Data) ( (i2c)->DATA = u8Data )
+
+/**
+  * @brief This macro returns the status of I2C module.
+  * @param[in] i2c is the base address of I2C module.
+  * @return Status.
+  * \hideinitializer
+  */
+#define I2C_GET_STATUS(i2c) ( (i2c)->STATUS )
+
+/**
+  * @brief This macro returns timeout flag.
+  * @param[in] i2c is the base address of I2C module.
+  * @return Status.
+  * @retval 0 Flag is not set.
+  * @retval 1 Flag is set.
+  * \hideinitializer
+  */
+#define I2C_GET_TIMEOUT_FLAG(i2c) ( ((i2c)->INTSTS & I2C_INTSTS_TIF_Msk) == I2C_INTSTS_TIF_Msk ? 1:0  )
+
+/**
+  * @brief This macro clears timeout flag.
+  * @param[in] i2c is the base address of I2C module.
+  * @return none
+  * \hideinitializer
+  */
+#define I2C_CLEAR_TIMEOUT_FLAG(i2c) ( (i2c)->INTSTS |= I2C_INTSTS_TIF_Msk )
+
+/**
+  * @brief This macro returns wakeup flag.
+  * @param[in] i2c is the base address of I2C module.
+  * @return Status.
+  * @retval 0 Flag is not set.
+  * @retval 1 Flag is set.
+  * \hideinitializer
+  */
+#define I2C_GET_WAKEUP_FLAG(i2c) ( ((i2c)->WKUPSTS & I2C_WKUPSTS_WKUPIF_Msk) == I2C_WKUPSTS_WKUPIF_Msk ? 1:0  )
+
+/**
+  * @brief This macro clears wakeup flag.
+  * @param[in] i2c is the base address of I2C module.
+  * @return none
+  * \hideinitializer
+  */
+#define I2C_CLEAR_WAKEUP_FLAG(i2c) ( (i2c)->WKUPSTS |= I2C_WKUPSTS_WKUPIF_Msk )
+
+uint32_t I2C_Open(I2C_T *i2c, uint32_t u32BusClock);
+void I2C_Close(I2C_T *i2c);
+void I2C_ClearTimeoutFlag(I2C_T *i2c);
+void I2C_Trigger(I2C_T *i2c, uint8_t u8Start, uint8_t u8Stop, uint8_t u8Si, uint8_t u8Ack);
+void I2C_DisableInt(I2C_T *i2c);
+void I2C_EnableInt(I2C_T *i2c);
+uint32_t I2C_GetBusClockFreq(I2C_T *i2c);
+uint32_t I2C_SetBusClockFreq(I2C_T *i2c, uint32_t u32BusClock);
+uint32_t I2C_GetIntFlag(I2C_T *i2c);
+void I2C_ClearIntFlag(I2C_T *i2c);
+uint32_t I2C_GetStatus(I2C_T *i2c);
+uint32_t I2C_GetData(I2C_T *i2c);
+void I2C_SetData(I2C_T *i2c, uint8_t u8Data);
+void I2C_SetSlaveAddr(I2C_T *i2c, uint8_t u8SlaveNo, uint8_t u8SlaveAddr, uint8_t u8GCMode);
+void I2C_SetSlaveAddrMask(I2C_T *i2c, uint8_t u8SlaveNo, uint8_t u8SlaveAddrMask);
+void I2C_EnableTimeout(I2C_T *i2c, uint8_t u8LongTimeout);
+void I2C_DisableTimeout(I2C_T *i2c);
+void I2C_EnableWakeup(I2C_T *i2c);
+void I2C_DisableWakeup(I2C_T *i2c);
+
+/*@}*/ /* end of group NANO100_I2C_EXPORTED_FUNCTIONS */
+
+/*@}*/ /* end of group NANO100_I2C_Driver */
+
+/*@}*/ /* end of group NANO100_Device_Driver */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif //__I2C_H__
+
+/*** (C) COPYRIGHT 2014 Nuvoton Technology Corp. ***/