480 lines
17 KiB
C
480 lines
17 KiB
C
/**
|
|
**************************************************************************
|
|
* @file at32f435_437_i2c.h
|
|
* @version v2.0.5
|
|
* @date 2022-02-11
|
|
* @brief at32f435_437 i2c header file
|
|
**************************************************************************
|
|
* Copyright notice & Disclaimer
|
|
*
|
|
* The software Board Support Package (BSP) that is made available to
|
|
* download from Artery official website is the copyrighted work of Artery.
|
|
* Artery authorizes customers to use, copy, and distribute the BSP
|
|
* software and its related documentation for the purpose of design and
|
|
* development in conjunction with Artery microcontrollers. Use of the
|
|
* software is governed by this copyright notice and the following disclaimer.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED ON "AS IS" BASIS WITHOUT WARRANTIES,
|
|
* GUARANTEES OR REPRESENTATIONS OF ANY KIND. ARTERY EXPRESSLY DISCLAIMS,
|
|
* TO THE FULLEST EXTENT PERMITTED BY LAW, ALL EXPRESS, IMPLIED OR
|
|
* STATUTORY OR OTHER WARRANTIES, GUARANTEES OR REPRESENTATIONS,
|
|
* INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
|
|
*
|
|
**************************************************************************
|
|
*/
|
|
|
|
/* define to prevent recursive inclusion -------------------------------------*/
|
|
#ifndef __AT32F435_437_I2C_H
|
|
#define __AT32F435_437_I2C_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/* includes ------------------------------------------------------------------*/
|
|
#include "at32f435_437.h"
|
|
|
|
/** @addtogroup AT32F435_437_periph_driver
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup I2C
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief maximum number of single transfers
|
|
*/
|
|
#define MAX_TRANSFER_CNT 255 /*!< maximum number of single transfers */
|
|
|
|
/** @defgroup I2C_interrupts_definition
|
|
* @brief i2c interrupt
|
|
* @{
|
|
*/
|
|
|
|
#define I2C_TD_INT ((uint32_t)0x00000002) /*!< i2c transmit data interrupt */
|
|
#define I2C_RD_INT ((uint32_t)0x00000004) /*!< i2c receive data interrupt */
|
|
#define I2C_ADDR_INT ((uint32_t)0x00000008) /*!< i2c address match interrupt */
|
|
#define I2C_ACKFIAL_INT ((uint32_t)0x00000010) /*!< i2c ack fail interrupt */
|
|
#define I2C_STOP_INT ((uint32_t)0x00000020) /*!< i2c stop detect interrupt */
|
|
#define I2C_TDC_INT ((uint32_t)0x00000040) /*!< i2c transmit data complete interrupt */
|
|
#define I2C_ERR_INT ((uint32_t)0x00000080) /*!< i2c bus error interrupt */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup I2C_flags_definition
|
|
* @brief i2c flag
|
|
* @{
|
|
*/
|
|
|
|
#define I2C_TDBE_FLAG ((uint32_t)0x00000001) /*!< i2c transmit data buffer empty flag */
|
|
#define I2C_TDIS_FLAG ((uint32_t)0x00000002) /*!< i2c send interrupt status */
|
|
#define I2C_RDBF_FLAG ((uint32_t)0x00000004) /*!< i2c receive data buffer full flag */
|
|
#define I2C_ADDRF_FLAG ((uint32_t)0x00000008) /*!< i2c 0~7 bit address match flag */
|
|
#define I2C_ACKFAIL_FLAG ((uint32_t)0x00000010) /*!< i2c acknowledge failure flag */
|
|
#define I2C_STOPF_FLAG ((uint32_t)0x00000020) /*!< i2c stop condition generation complete flag */
|
|
#define I2C_TDC_FLAG ((uint32_t)0x00000040) /*!< i2c transmit data complete flag */
|
|
#define I2C_TCRLD_FLAG ((uint32_t)0x00000080) /*!< i2c transmission is complete, waiting to load data */
|
|
#define I2C_BUSERR_FLAG ((uint32_t)0x00000100) /*!< i2c bus error flag */
|
|
#define I2C_ARLOST_FLAG ((uint32_t)0x00000200) /*!< i2c arbitration lost flag */
|
|
#define I2C_OUF_FLAG ((uint32_t)0x00000400) /*!< i2c overflow or underflow flag */
|
|
#define I2C_PECERR_FLAG ((uint32_t)0x00000800) /*!< i2c pec receive error flag */
|
|
#define I2C_TMOUT_FLAG ((uint32_t)0x00001000) /*!< i2c smbus timeout flag */
|
|
#define I2C_ALERTF_FLAG ((uint32_t)0x00002000) /*!< i2c smbus alert flag */
|
|
#define I2C_BUSYF_FLAG ((uint32_t)0x00008000) /*!< i2c bus busy flag transmission mode */
|
|
#define I2C_SDIR_FLAG ((uint32_t)0x00010000) /*!< i2c slave data transmit direction */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup I2C_exported_types
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief i2c smbus mode set
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_SMBUS_MODE_DEVICE = 0x00, /*!< smbus device mode */
|
|
I2C_SMBUS_MODE_HOST = 0x01 /*!< smbus host mode */
|
|
} i2c_smbus_mode_type;
|
|
|
|
/**
|
|
* @brief i2c address mode
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_ADDRESS_MODE_7BIT = 0x00, /*!< 7bit address mode */
|
|
I2C_ADDRESS_MODE_10BIT = 0x01 /*!< 10bit address mode */
|
|
} i2c_address_mode_type;
|
|
|
|
/**
|
|
* @brief i2c transfer direction
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_DIR_TRANSMIT = 0x00, /*!< master request a write transfer */
|
|
I2C_DIR_RECEIVE = 0x01 /*!< master request a read transfer */
|
|
} i2c_transfer_dir_type;
|
|
|
|
/**
|
|
* @brief i2c dma requests direction
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_DMA_REQUEST_TX = 0x00, /*!< dma transmit request */
|
|
I2C_DMA_REQUEST_RX = 0x01 /*!< dma receive request */
|
|
} i2c_dma_request_type;
|
|
|
|
/**
|
|
* @brief i2c smbus alert pin set
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_SMBUS_ALERT_HIGH = 0x00, /*!< smbus alert pin set high */
|
|
I2C_SMBUS_ALERT_LOW = 0x01 /*!< smbus alert pin set low */
|
|
} i2c_smbus_alert_set_type;
|
|
|
|
/**
|
|
* @brief i2c clock timeout detection mode
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_TIMEOUT_DETCET_LOW = 0x00, /*!< detect low level timeout */
|
|
I2C_TIMEOUT_DETCET_HIGH = 0x01 /*!< detect high level timeout */
|
|
} i2c_timeout_detcet_type;
|
|
|
|
/**
|
|
* @brief i2c own address2 mask
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_ADDR2_NOMASK = 0x00, /*!< compare bit [7:1] */
|
|
I2C_ADDR2_MASK01 = 0x01, /*!< only compare bit [7:2] */
|
|
I2C_ADDR2_MASK02 = 0x02, /*!< only compare bit [7:2] */
|
|
I2C_ADDR2_MASK03 = 0x03, /*!< only compare bit [7:3] */
|
|
I2C_ADDR2_MASK04 = 0x04, /*!< only compare bit [7:4] */
|
|
I2C_ADDR2_MASK05 = 0x05, /*!< only compare bit [7:5] */
|
|
I2C_ADDR2_MASK06 = 0x06, /*!< only compare bit [7:6] */
|
|
I2C_ADDR2_MASK07 = 0x07 /*!< only compare bit [7] */
|
|
} i2c_addr2_mask_type;
|
|
|
|
/**
|
|
* @brief i2c reload end mode
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_AUTO_STOP_MODE = 0x00, /*!< auto generate stop mode */
|
|
I2C_SOFT_STOP_MODE = 0x01, /*!< soft generate stop mode */
|
|
I2C_RELOAD_MODE = 0x02 /*!< reload mode */
|
|
} i2c_reload_stop_mode_type;
|
|
|
|
/**
|
|
* @brief i2c start stop mode
|
|
*/
|
|
typedef enum
|
|
{
|
|
I2C_WITHOUT_START = 0x00, /*!< transfer data without start condition */
|
|
I2C_GEN_START_READ = 0x01, /*!< read data and generate start */
|
|
I2C_GEN_START_WRITE = 0x02 /*!< send data and generate start */
|
|
} i2c_start_stop_mode_type;
|
|
|
|
/**
|
|
* @brief type define i2c register all
|
|
*/
|
|
typedef struct
|
|
{
|
|
/**
|
|
* @brief i2c ctrl1 register, offset:0x00
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t ctrl1;
|
|
struct
|
|
{
|
|
__IO uint32_t i2cen : 1; /* [0] */
|
|
__IO uint32_t tdien : 1; /* [1] */
|
|
__IO uint32_t rdien : 1; /* [2] */
|
|
__IO uint32_t addrien : 1; /* [3] */
|
|
__IO uint32_t ackfailien : 1; /* [4] */
|
|
__IO uint32_t stopien : 1; /* [5] */
|
|
__IO uint32_t tdcien : 1; /* [6] */
|
|
__IO uint32_t errien : 1; /* [7] */
|
|
__IO uint32_t dflt : 4; /* [11:8] */
|
|
__IO uint32_t reserved1 : 2; /* [13:12] */
|
|
__IO uint32_t dmaten : 1; /* [14] */
|
|
__IO uint32_t dmaren : 1; /* [15] */
|
|
__IO uint32_t sctrl : 1; /* [16] */
|
|
__IO uint32_t stretch : 1; /* [17] */
|
|
__IO uint32_t reserved2 : 1; /* [18] */
|
|
__IO uint32_t gcaen : 1; /* [19] */
|
|
__IO uint32_t haddren : 1; /* [20] */
|
|
__IO uint32_t devaddren : 1; /* [21] */
|
|
__IO uint32_t smbalert : 1; /* [22] */
|
|
__IO uint32_t pecen : 1; /* [23] */
|
|
__IO uint32_t reserved3 : 8; /* [31:24] */
|
|
} ctrl1_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c ctrl2 register, offset:0x04
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t ctrl2;
|
|
struct
|
|
{
|
|
__IO uint32_t saddr : 10;/* [9:0] */
|
|
__IO uint32_t dir : 1; /* [10] */
|
|
__IO uint32_t addr10 : 1; /* [11] */
|
|
__IO uint32_t readh10 : 1; /* [12] */
|
|
__IO uint32_t genstart : 1; /* [13] */
|
|
__IO uint32_t genstop : 1; /* [14] */
|
|
__IO uint32_t nacken : 1; /* [15] */
|
|
__IO uint32_t cnt : 8; /* [23:16] */
|
|
__IO uint32_t rlden : 1; /* [24] */
|
|
__IO uint32_t astopen : 1; /* [25] */
|
|
__IO uint32_t pecten : 1; /* [26] */
|
|
__IO uint32_t reserved1 : 5; /* [31:27] */
|
|
} ctrl2_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c oaddr1 register, offset:0x08
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t oaddr1;
|
|
struct
|
|
{
|
|
__IO uint32_t addr1 : 10;/* [9:0] */
|
|
__IO uint32_t addr1mode : 1; /* [10] */
|
|
__IO uint32_t reserved1 : 4; /* [14:11] */
|
|
__IO uint32_t addr1en : 1; /* [15] */
|
|
__IO uint32_t reserved2 : 16;/* [31:16] */
|
|
} oaddr1_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c oaddr2 register, offset:0x0c
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t oaddr2;
|
|
struct
|
|
{
|
|
__IO uint32_t reserved1 : 1; /* [0] */
|
|
__IO uint32_t addr2 : 7; /* [7:1] */
|
|
__IO uint32_t addr2mask : 3; /* [10:8] */
|
|
__IO uint32_t reserved2 : 4; /* [14:11] */
|
|
__IO uint32_t addr2en : 1; /* [15] */
|
|
__IO uint32_t reserved3 : 16;/* [31:16] */
|
|
} oaddr2_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c clkctrl register, offset:0x10
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t clkctrl;
|
|
struct
|
|
{
|
|
__IO uint32_t scll : 8; /* [7:0] */
|
|
__IO uint32_t sclh : 8; /* [15:8] */
|
|
__IO uint32_t sdad : 4; /* [19:16] */
|
|
__IO uint32_t scld : 4; /* [23:20] */
|
|
__IO uint32_t divh : 4; /* [27:24] */
|
|
__IO uint32_t divl : 4; /* [31:28] */
|
|
} clkctrl_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c timeout register, offset:0x14
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t timeout;
|
|
struct
|
|
{
|
|
__IO uint32_t totime : 12;/* [11:0] */
|
|
__IO uint32_t tomode : 1; /* [12] */
|
|
__IO uint32_t reserved1 : 2; /* [14:13] */
|
|
__IO uint32_t toen : 1; /* [15] */
|
|
__IO uint32_t exttime : 12;/* [27:16] */
|
|
__IO uint32_t reserved2 : 3; /* [30:28] */
|
|
__IO uint32_t exten : 1; /* [31] */
|
|
} timeout_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c sts register, offset:0x18
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t sts;
|
|
struct
|
|
{
|
|
__IO uint32_t tdbe : 1; /* [0] */
|
|
__IO uint32_t tdis : 1; /* [1] */
|
|
__IO uint32_t rdbf : 1; /* [2] */
|
|
__IO uint32_t addrf : 1; /* [3] */
|
|
__IO uint32_t ackfail : 1; /* [4] */
|
|
__IO uint32_t stopf : 1; /* [5] */
|
|
__IO uint32_t tdc : 1; /* [6] */
|
|
__IO uint32_t tcrld : 1; /* [7] */
|
|
__IO uint32_t buserr : 1; /* [8] */
|
|
__IO uint32_t arlost : 1; /* [9] */
|
|
__IO uint32_t ouf : 1; /* [10] */
|
|
__IO uint32_t pecerr : 1; /* [11] */
|
|
__IO uint32_t tmout : 1; /* [12] */
|
|
__IO uint32_t alertf : 1; /* [13] */
|
|
__IO uint32_t reserved1 : 1; /* [14] */
|
|
__IO uint32_t busyf : 1; /* [15] */
|
|
__IO uint32_t sdir : 1; /* [16] */
|
|
__IO uint32_t addr : 7; /* [23:17] */
|
|
__IO uint32_t reserved2 : 8; /* [31:24] */
|
|
} sts_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c clr register, offset:0x1c
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t clr;
|
|
struct
|
|
{
|
|
__IO uint32_t reserved1 : 3; /* [2:0] */
|
|
__IO uint32_t addrc : 1; /* [3] */
|
|
__IO uint32_t ackfailc : 1; /* [4] */
|
|
__IO uint32_t stopc : 1; /* [5] */
|
|
__IO uint32_t reserved2 : 2; /* [6:7] */
|
|
__IO uint32_t buserrc : 1; /* [8] */
|
|
__IO uint32_t arlostc : 1; /* [9] */
|
|
__IO uint32_t oufc : 1; /* [10] */
|
|
__IO uint32_t pecerrc : 1; /* [11] */
|
|
__IO uint32_t tmoutc : 1; /* [12] */
|
|
__IO uint32_t alertc : 1; /* [13] */
|
|
__IO uint32_t reserved3 : 18;/* [31:14] */
|
|
} clr_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c pec register, offset:0x20
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t pec;
|
|
struct
|
|
{
|
|
__IO uint32_t pecval : 8; /* [7:0] */
|
|
__IO uint32_t reserved1 : 24;/* [31:8] */
|
|
} pec_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c rxdt register, offset:0x20
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t rxdt;
|
|
struct
|
|
{
|
|
__IO uint32_t dt : 8; /* [7:0] */
|
|
__IO uint32_t reserved1 : 24;/* [31:8] */
|
|
} rxdt_bit;
|
|
};
|
|
|
|
/**
|
|
* @brief i2c txdt register, offset:0x20
|
|
*/
|
|
union
|
|
{
|
|
__IO uint32_t txdt;
|
|
struct
|
|
{
|
|
__IO uint32_t dt : 8; /* [7:0] */
|
|
__IO uint32_t reserved1 : 24;/* [31:8] */
|
|
} txdt_bit;
|
|
};
|
|
|
|
} i2c_type;
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#define I2C1 ((i2c_type *) I2C1_BASE)
|
|
#define I2C2 ((i2c_type *) I2C2_BASE)
|
|
#define I2C3 ((i2c_type *) I2C3_BASE)
|
|
|
|
/** @defgroup I2C_exported_functions
|
|
* @{
|
|
*/
|
|
|
|
void i2c_reset(i2c_type *i2c_x);
|
|
void i2c_init(i2c_type *i2c_x, uint8_t dfilters, uint32_t clk);
|
|
void i2c_own_address1_set(i2c_type *i2c_x, i2c_address_mode_type mode, uint16_t address);
|
|
void i2c_own_address2_set(i2c_type *i2c_x, uint8_t address, i2c_addr2_mask_type mask);
|
|
void i2c_own_address2_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_smbus_enable(i2c_type *i2c_x, i2c_smbus_mode_type mode, confirm_state new_state);
|
|
void i2c_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_clock_stretch_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_ack_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_addr10_mode_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_transfer_addr_set(i2c_type *i2c_x, uint16_t address);
|
|
uint16_t i2c_transfer_addr_get(i2c_type *i2c_x);
|
|
void i2c_transfer_dir_set(i2c_type *i2c_x, i2c_transfer_dir_type i2c_direction);
|
|
i2c_transfer_dir_type i2c_transfer_dir_get(i2c_type *i2c_x);
|
|
uint8_t i2c_matched_addr_get(i2c_type *i2c_x);
|
|
void i2c_auto_stop_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_reload_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_cnt_set(i2c_type *i2c_x, uint8_t cnt);
|
|
void i2c_addr10_header_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_general_call_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_smbus_alert_set(i2c_type *i2c_x, i2c_smbus_alert_set_type level);
|
|
void i2c_slave_data_ctrl_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_pec_calculate_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_pec_transmit_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
uint8_t i2c_pec_value_get(i2c_type *i2c_x);
|
|
void i2c_timeout_set(i2c_type *i2c_x, uint16_t timeout);
|
|
void i2c_timeout_detcet_set(i2c_type *i2c_x, i2c_timeout_detcet_type mode);
|
|
void i2c_timeout_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_ext_timeout_set(i2c_type *i2c_x, uint16_t timeout);
|
|
void i2c_ext_timeout_enable(i2c_type *i2c_x, confirm_state new_state);
|
|
void i2c_interrupt_enable(i2c_type *i2c_x, uint32_t source, confirm_state new_state);
|
|
flag_status i2c_interrupt_get(i2c_type *i2c_x, uint16_t source);
|
|
void i2c_dma_enable(i2c_type *i2c_x, i2c_dma_request_type dma_req, confirm_state new_state);
|
|
void i2c_transmit_set(i2c_type *i2c_x, uint16_t address, uint8_t cnt, i2c_reload_stop_mode_type rld_stop, i2c_start_stop_mode_type start_stop);
|
|
void i2c_start_generate(i2c_type *i2c_x);
|
|
void i2c_stop_generate(i2c_type *i2c_x);
|
|
void i2c_data_send(i2c_type *i2c_x, uint8_t data);
|
|
uint8_t i2c_data_receive(i2c_type *i2c_x);
|
|
flag_status i2c_flag_get(i2c_type *i2c_x, uint32_t flag);
|
|
void i2c_flag_clear(i2c_type *i2c_x, uint32_t flag);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|