概述
AMD Xilinx Vitis內部集成了各種外設的例程，為工程師提供了快速上手的代碼。

AMD Xilinx有很多開發板。各種單板的硬件參數不一定完全一致，有時需要根據單板硬件設計、Vivado中的Block Design設計，修改外設例程的參數。

IIC EEPROM例程
本文描述在如何運行IIC EEPROM例程。

硬件設計
運行運行IIC EEPROM例程，如果時Zynq-7000/MPSoC, 要在Block Design設計中使能PS的IIC控制器。如果是傳統FPGA，要在Block Design設計中添加MicaroBlaze和AXI IIC控制器。然后在Vivado中導出XSA文件，給Vitis后續設計使用。

創建Platform
在Vitis中，先使用Vitis創建Platform。具體步驟是，在Vitis的菜單 “File - New ” 中，選擇“Platform Project”， 指定名稱如“ac701_multiboot_hw_platform”， 再選擇對應的XSA文件和 Processor 如 “micraoblaze_0”，再點擊“Finish”。

導入IIC EEPROM例程
1. 打開hw_platform工程。
2. 雙擊“platform.spr”文件。
3. 雙擊“micraoblaze_0”的 “board support package”。
4. 等待Drivers窗口顯示
5. 點擊axi_iic_0行右邊的import examples
6. 選擇"xiic_eeprom_example"
7. 點擊"OK"

之后Vitis會創建一個工程，包含文件xiic_eeprom_example.c。

IIC EEPROM例程更改
下面是在AMD Xilinx AC701 單板運行IIC EEPROM例程所需要的更改。

中斷
IIC EEPROM例程使用了中斷，需要根據AC701 MicroBlaze硬件工程的設計，修改中斷號。

文件xiic_eeprom_example.c中原來使用的中斷號是XPAR_INTC_0_IIC_0_VEC_ID，要改成新的中斷號。

舊的中斷號參數：

#define IIC_INTR_ID XPAR_INTC_0_IIC_0_VEC_ID

在workspace下，能搜索到文件xparameters.h，包含每個設備的中斷號。 定義中斷號的宏的名稱，與Vivado硬件工程的BlockDesign中的IP名稱有關，類似如下字符串：

#define XPAR_MICROBLAZE_0_AXI_INTC_AXI_IIC_0_IIC2INTC_IRPT_INTR 2U

因此，新的中斷號參數設置為：

#define IIC_INTR_ID XPAR_MICROBLAZE_0_AXI_INTC_AXI_IIC_0_IIC2INTC_IRPT_INTR

IIC MUX
為了節省管腳，AMD Xilinx開發板一般使用一個IIC_MUX（IIC Switch）,把一路IIC總線擴展成多路IIC總線。比如AC701使用了PCA9548擴展IIC總線。如果使用了IIC_MUX（IIC Switch）, 要定義宏IIC_MUX_ENABLE，并且設置IIC_MUX_ADDRESS、IIC_EEPROM_CHANNEL。定義IIC_MUX_ENABLE后，就使能了函數MuxInit( )。

IIC_MUX_ADDRESS是IIC_MUX在與MPSoC/MicroBlaze之間連接的IIC總線上的地址，需要根據AC701的硬件設計設置。注意，是7位地址，是8位地址的二分之一。根據原理圖，AC701 PCA9548的IIC地址是0x74。

IIC_MUX分出多個IIC總線（CHANNEL）。EEPROM所在的IIC總線（CHANNEL）需要根據AC701的硬件設計設置，軟件代碼中對應的設置是IIC_EEPROM_CHANNEL。AC701上，EEPROM的IIC總線（CHANNEL）是3，IIC_EEPROM_CHANNEL設置成8。這個參數最后在MuxInit( )中被使用。

/*
* The IIC_MUX_ADDRESS defines the address of the IIC MUX device on the
* IIC bus. Note that since the address is only 7 bits, this constant is the
* address divided by 2.
* The IIC Slaves on the KC705/ZC702/ZC706 boards are connected to an
* IIC MUX.
* IIC_EEPROM_CHANNEL is the Channel number of EEPROM for IIC Mux. On KC705 it
* is 0x08 and ZC702 is 0x04.Please refer the User Guide's of the respective
* boards for further information about the Channel number to use EEPROM.
*/
#define IIC_MUX_ADDRESS 0x74
#define IIC_EEPROM_CHANNEL 0x08

/*
* This define should be uncommented if there is IIC MUX on the board to which
* this EEPROM is connected. The boards that have IIC MUX are KC705/ZC702/ZC706.
*/
#define IIC_MUX_ENABLE

EEPROM_ADDRESS
EEPROM_ADDRESS定義EEPROM在IIC總線上的地址。也請注意，是7位地址，是8位地址的二分之一。根據原理圖，AC701 EEPROM的IIC地址是0x54。

調試技巧
剛測試時，不熟悉運行流程。建議在函數入口處、返回處多加些打印，了解運行流程。

在判斷函數的返回值時，加入下列打印，能快速了解出錯的代碼和原因。

if (Status != XST_SUCCESS) {
xil_printf("Fail at %s : %drn", __func__, __LINE__ );
return XST_FAILURE;
}

添加打印，成功運行情況的的打印如下：

Begin at XIic_SetAddress : 397
XII_ADDR_TO_SEND_TYPE at XIic_SetAddress : 431
Begin at XIic_SetAddress : 398
XII_ADDR_TO_SEND_TYPE at XIic_SetAddress : 432
SUCCESS at MuxInit : 840
Begin at XIic_SetAddress : 398
XII_ADDR_TO_SEND_TYPE at XIic_SetAddress : 432
Success at IicEepromExample : 465
Successfully ran IIC eeprom Example

本文轉載自：博客園

審核編輯：湯梓紅