分享灵动微MM32 MCU的OS移植与应用--基于AMetal平台I2C接口控制

eMiniBoard板载一颗24C02，我们接下来一起进入I2C实战操作过程，通过MM32 MCU的硬件I2C接口来与24C02进行双向通信。

板级24C02的SCL和SDA分别连在MM32的PB6和PB7上，如下图所示：

图2 MM32与24C02连接图

I2C主机初始化

AMetal 平台提供了MCU的I2C初始化函数，可以直接调用初始化函数。在AMetal 中，由于用户无需关心读/写方向位的控制，因此其地址使用7-bit地址表示。
函数原型为：
am_i2c_handle_t am_mm32l073_i2c1_inst_init (void)

该函数在user_config目录下的am_hwconf_mm32l073_i2c.c文件中定义，在am_mm32l073_inst_init.h中声明。因此使用I2C初始化函数时，需要包含头文件 am_mm32l073_inst_init.h。

初始化I2C，调用该函数时需要定义一个am_i2c_handle_t 类型的变量，用于保存获取的I2C 服务句柄，初始化程序为：
am_i2c_handle_t i2c_handle
i2c_handle = am_mm32l073_i2c1_inst_init()

获取了I2C服务句柄后，还应该有一个描述I2C从设备的结构体，构造I2C设备函数的原型为：void am_i2c_mkdev ( am_i2c_device_t  *p_dev,
am_i2c_handle_t  handle,
uint16_t          dev_addr,
uint16_t          dev_flags)
p_dev 为指向 am_i2c_device_t 的结构体指针
handle 为 I2C 服务句柄
dev_addr 为从机设备地址
dev_flags 为传输过程中的控制标识位，其可用的值已在 am_i2c.h 中宏定义
I2C从机初始化
和MM32 MCU作为主机一样，AMetal平台也提供了作为I2C从机初始化函数， 可以直接调用初始化函数。函数原型为：
am_i2c_slv_handle_t    am_mm32l073_i2c1_slv_inst_init (void)

该函数在user_config目录下的am_hwconf_mm32l073_i2c_slv.c文件中定义，在 am_mm32l073_inst_init.h中声明。因此使用定时器初始化函数时，需要包含头文件 am_mm32l073_inst_init.h。

初始化I2C，调用该函数时需要定义一个am_i2c_slv_device_t 类型的变量， 用于保存获取的I2C从机服务句柄，初始化程序为：
am_i2c_slv_handle_t slv_handle = am_mm32l073_i2c1_slv_inst_init ()
获取了I2C服务句柄后，还应该有一个描述I2C从设备的结构体，构造I2C设备函数的原型为：
void am_i2c_slv_mkdev (am_i2c_slv_device_t    *p_dev,
am_i2c_slv_handle_t   handle,
am_i2c_slv_cb_funcs_t  *p_cb_funs,
uint16_t                dev_addr,
uint16_t                dev_flags,
void                   *p_arg)
p_dev 为指向从机设备描述结构体的指针
handle 是与从设备关联的 I2C 标准服务操作句柄
p_cb_funs 是回调函数的函数指针
dev_addr 为从机设备地址
dev_flags 为从机设备特性
p_arg 指向回调函数参数

表1 ep24cxx 读写函数

各 API 的返回值含义都是相同的：AM_OK 表示成功，负值表示失败，失败原因可根据具体的值查看 am_errno.h 文件中相对应的宏定义。正值的含义由各 API 自行定义，无特殊说明时，表明不会返回正值。
   

2
数据读写
01
写入数据
从指定的地址开始写入一段数据的函数原型为：
int am_ep24cxx_write (am_ep24cxx_handle_t  handle,
int                   start_addr,
uint8_t               *p_buf,
int                   len);

如果返回值为AM_OK，则说明写入成功，反之失败。假定从0x20地址开始，连续写入16字节。

写入数据范例程序：uint8_t data[16] = {0,1,2, 3, 4, 5, 6, 7, 8, 9,10,11,12,13,14,15};
am_ep24cxx_write(fm24c02_handle, 0x20, &data[0],16);

02
读取数据
从指定的起始地址开始读取一段数据的函数原型为：
int am_ep24cxx_read (am_ep24cxx_handle_t handle,
int                  start_addr,
uint8_t              *p_buf,
int                  len);

如果返回值为 AM_OK,则说明读取成功，反之失败。假定从 0x20 地址开始，连续读取数据范例程序为：
uint8_t data[16];
am_ep24cxx_read(fm24c02_handle, 0x20, &data[0],16);

03
应用实例
E2PROM 读写测试， 向存储器写入20个字节数据再读出来，然后校验是否读写正常的范例。
#include "ametal.h"
#include "am_LED.h"
#include "am_delay.h"
#include "am_mm32l073_inst_init.h"
#include "am_ep24cxx.h"
#include "am_hwconf_ep24cxx.h"

int app_test_ep24cxx(am_ep24cxx_handle_t handle)
{
int i;
uint8_t data[20];
for(i=0;i<20;i++) //填充数据
data=i;
am_ep24cxx_write(handle,0,&data[0],20); //从 0 地址开始，连续写入 20 字节数据16 for(i=0;i<20;i++) //清零数据
data=0;
am_ep24cxx_read(handle,0,&data[0],20); //从 0 地址开始，连续读出 20 字节数据19 for(i=0;i<20;i++)
{ //比较数据
IF(data!=i)
return AM_ERROR;
}
return AM_OK;
}

int am_main(void)
{
am_ep24cxx_handle_t fm24c02_handle =am_fm24c02_inst_init();//获取24C02初始化实例句柄
if(app_test_ep24cxx(fm24c02_handle)!=AM_OK)
{
am_led_on(0);
}
while(1)
{
am_led_toggle(0);//翻转 LED
am_mdelay(100);
}
}

app_test_ep24cxx()的参数为实例 handle，与EP24Cxx器件具有依赖关系，因为没办法实现全兼容调用，用户可根据EEPROM信息设置对应的参数。