Maxim Integrated Analog Essentials Getting Started Guide for Zedboard - Manual (Page 21)

Analog Essentials Getting Started Guide
21
Zedboard Version
Appendix A: Project Notes
1. Pmod port JA, JB, JC and JD each have a dedicated I 2 C port, SPI port UART and octal GPIO. These
communications peripherals are multiplexed to the physical port via an HDL designed multiplexer. (Refer to the
diagram in the Typical System Architecture section.) An example of this can be seen in the maximPMOD.c file at
about the midpoint, as shown in the clip below.
(Note that in Pmod port JE is not driven by the logic within this project.)
2. The functions in maximDeviceSpecificUtilities.c are used to access the major functionality provided by the
Maxim ICs. In general, these functions return an integer value (TRUE/FALSE) that describes whether or not the
function successfully completed. Although it is not required to check this return value, it is good programming
practice to do so.
3. Functions will typically require a peripheral port address. These ports are named as follows:
a. XPAR_IIC_0_BASEADDR
b. XPAR_SPI_0_BASEADDR
c. XPAR_AXI_UARTLITE_0_BASEADDR
4. GPIO calls receive a pointer to a Xilinx XGpio instance
a. XGpio portA;
b. XGpio_Initialize(&portA, XPAR_AXI_GPIO_0_DEVICE_ID);
Since the functions return TRUE/FALSE as a pass/fail indication, when the functions return a value, that value is passed
back to the calling function via a pointer.