AN177-基于I2C总线的libMPSSE用户指南

引言

多协议同步串行引擎(MPSSE)在FTDI的多款芯片中通用的硬件模组，它可以与诸如I2C设备，SPI设备或JTAG设备的任一同步串行设备通讯。当下，FT2232D，FT2232H，FT4232H和FT232H等芯片已经集成了MPSSE模块，这些芯片通过USB接口与Host进行通讯。PC端或嵌入式系统的应用可以使用D2XX USB驱动与这些芯片的MPSSE进行通讯。

libMPSSE库文件提供了一组用户友好的API，使得用户无需理解MPSSE和它的命令的情况下，编辑应用与I2C,SPI或JTAG设备进行通讯。

从上图可以看出，libMPSSE有3组不同的API：I2C, SPI 和JTAG。本文仅仅描述I2C部分。

系统概述

如上图所示，正如烧录BIOS芯片或者烧录STM32，CPLD一样，PC/HOST相当于笔记本，运行着软件开发或烧录软件，中间是烧录器(此处是芯片)，末端是Flash芯片(无论表面上看是MCU，CPLD，FPGA抑或是DSP，那么本质上都是对其内部的Flash芯片进行编程).

应用编程接口(API)

libMPSSE-I2C API大致可以分为两部分，第一部分由五个控制API组成，第二部分由两个数据转移API构成。所有API的返回值为一个FT_STATUS变量(FT_STATUS在D2XX驱动中定义是一致的)。

I2C函数

FT_STATUS I2C_GetNumChannels(uint32 *numChannels)
该函数获取连接到主机系统的I2C通道数量。不同芯片的端口数量也是不同的。

参数：
output: *numChannels //连接到主机系统的通道数量

返回值：
返回FT_STATUS类型的状态代码

注：
FTDI的USB-To-Legacy桥芯片可能有多个通道，但是并不是这些通道都可以被配置为I2C Master。该函数返回的不是芯片真正的通道数，而是可以配置为I2C Master的通道数。

比如，FT2232D(一个MPSSE端口)，FT232H(一个MPSSE端口)，FT2232H(两个MPSSE端口)和FT4232H(两个MPSSE端口)连接到PC，那么，调用I2C_GetNumChannels，numChannels返回值为6.

warning：
该函数不能同时被多个应用或多个线程调用。