CoraZ7-07S Quickstart

This guide provides quick instructions on how to set up the AD57xx on:

• Cora Z7S on Arduino shield connector

All the products described on this page include ESD (electrostatic discharge) sensitive devices. Electrostatic charges as high as 4000V readily accumulate on the human body or test equipment and can discharge without detection. Although the boards feature ESD protection circuitry, permanent damage may occur on devices subjected to high-energy electrostatic discharges. Therefore, proper ESD precautions are recommended to avoid performance degradation or loss of functionality. This includes removing static charge on external equipment, cables, or antennas before connecting to the device.

Using linux as software

Necessary files

The following files are needed to boot the system:

• BOOT.BIN, built from the HDL project; follow Build an HDL project

• devicetree.dtb, compiled from the device tree source

• uImage, the linux kernel image; follow Build Zynq Linux kernel and devicetree

Note

Pre-built files for this reference design are not yet available. The files must be built manually using the links above. For the HDL project, see AD57XX_ARDZ HDL project build documentation. For general HDL build instructions, see Build an HDL project.

HDL source: /projects/ad57xx_ardz/coraz7s

Copy BOOT.BIN, devicetree.dtb, and uImage to the BOOT partition of the SD card before inserting it.

Required Software

• SD Card 16GB imaged with Kuiper (provides the root filesystem; the HDL bitstream must be built separately as described above)

• A UART terminal (Putty/Tera Term/Minicom, etc.) with baud rate 115200 (8N1)

Required Hardware

• Cora Z7S FPGA board

• EVAL-AD5780ARDZ/ EVAL-AD5781ARDZ/ EVAL-AD5791ARDZ evaluation board

• Voltage reference daughter board (EV-ADR445-REFZ included with evaluation kit)

• Class 10 16GB SD Card

• Micro-USB cable (UART / Power)

• LAN cable (Ethernet)

• DMM or oscilloscope for measuring DAC output voltage

More details as to why you need these can be found at Prerequisites.

Testing

Creating the setup

AD57xx/CoraZ7-07S

Figure 1 AD57xx/CoraZ7-07S hardware setup for linux.

In the following example, we will prepare the evaluation setup by connecting the AD57xx board to the CoraZ7-07S and configuring it to produce a DAC output.

Follow the steps in this order, to avoid damaging the components:

1. Get the Cora Z7S

2. Configure CoraZ7-07S jumpers:

   

   Figure 2 CoraZ7-07S jumper configuration.

   Jumper Location	Description	Shunt Placement
   JP2	Selects how the CoraZ7-07s board boots. We want to boot from the microSD card.	Across Pins 1 & 2
   JP3	Selects how the CoraZ7-07s board is powered. We are powering from the USB port.	Across Pins 3 & 2 (labeled USB)

3. Prepare the SD card:

   1. Validate, Format, and Flash the SD Card following the Use Kuiper Image guide.

   2. Copy the built BOOT.BIN, devicetree.dtb, and uImage to the BOOT partition of the SD card.

4. Insert the microSD card into the CoraZ7-07S card slot

   

   Figure 3 Insert SD card

   

   Figure 4 SD card connected

5. Plug-in an Ethernet cable from your router/switch to the Ethernet port on the FPGA board

   Info

   If you don’t have a network available and want to stream data directly from the Ethernet port of the CoraZ7-07s to the Ethernet port of your PC, that is still possible, but requires some extra configuration. Please see the [Wiki] Network Configuration page for complete details.

6. Ensure the voltage reference daughter board (EV-ADR445-REFZ or equivalent) is connected to the J1, J4, and J9 connectors on the evaluation board.

7. Using the Arduino pins, plug the EVAL-AD5780ARDZ/ EVAL-AD5781ARDZ/ EVAL-AD5791ARDZ on top of the CoraZ7-07S

8. Connect a DMM or oscilloscope to the VOUT or VOUT_BUFF connector on the evaluation board to measure the DAC output voltage.

9. Connect the UART port of CoraZ7-07S to a PC via Micro-USB cable (DO NOT power on the device yet)

10. Power up the setup by plugging the Micro-USB cable into your PC’s USB port

11. Observe Kernel and serial console output messages on your terminal

Boot messages

The following is what is printed in the serial console, after you have connected to the proper ttyUSB or COM port:

Complete boot log

Useful commands for the serial terminal

The below commands are to be run in the serial terminal connected to the FPGA.

Login Information

user: analog

password: analog

To find out the IP of the FPGA board, run the following command and take the IP specified at “eth0 inet”:

~$

ifconfig

To see the IIO devices detected, run:

~$

iio_info | grep iio:device

Complete iio_info output

Add full iio_info output once available.

To power off the system, run the following command, and wait for the final message to be printed, then power off the FPGA board from the switch as well.

~$

poweroff

To reboot the system, run:

~$

reboot

Important

Even though this is Linux, this is a persistent file system. Care should be taken not to corrupt the file system – please shut down things, don’t just turn off the power switch. Depending on your monitor, the standard power off could be hiding. You can do this from the terminal as well with sudo shutdown -h now or the above-mentioned command for powering off.

Scopy

Important

Make sure to download/update to the latest version of Scopy.

Scopy can be used to control the DAC output voltage through the IIO plugin. Connect to the board via its IP address, then use the DAC channel controls to set the desired output code or voltage.

IIO Oscilloscope

Important

Make sure to download/update to the latest version of IIO Oscilloscope.

1. Once done with the installation or an update of the latest IIO Oscilloscope, open the application. The user needs to supply a URI which will be used in the context creation of the IIO Oscilloscope.

2. Press Refresh to display available IIO Devices and press Connect.

3. After the board is connected and a channel is enabled, hit the play button. Then the data capture window can be seen like in the shown picture.

Using no-OS as software

Necessary files

The following files are needed for the system to boot:

• HDL boot file: system_top.xsa

• no-OS project: No-OS AD5791 driver

Instructions on how to build the boot files from source can be found here:

• No-OS AD5791 driver source. More no-OS build details at No-OS Build Guide.

• AD57XX_ARDZ HDL project. More HDL build details at Build an HDL project.

Required Software

• AMD Xilinx Vivado and Vitis (downloading Vitis from here will include Vivado as well)

• An UART terminal (Putty/Tera Term/Minicom, etc.), Baud rate 115200 (8N1)

Required Hardware

• Cora Z7S FPGA board

• EVAL-AD5780ARDZ/ EVAL-AD5781ARDZ/ EVAL-AD5791ARDZ evaluation board

• Voltage reference daughter board (EV-ADR445-REFZ included with evaluation kit)

• Micro-USB cable (UART / Power / JTAG)

• DMM or oscilloscope for measuring DAC output voltage

More details as to why you need these can be found at Prerequisites.

Testing

Creating the setup

AD57xx/CoraZ7-07S

Figure 5 AD57xx/CoraZ7-07S hardware setup for no-OS.

In the following example, we will prepare the evaluation setup by connecting the EVAL-AD5780ARDZ/ EVAL-AD5781ARDZ/ EVAL-AD5791ARDZ board to the CoraZ7-07S and configuring the board for JTAG boot.

Follow the steps in this order, to avoid damaging the components:

1. Get the Cora Z7S

2. Configure CoraZ7-07S for JTAG boot. Remove jumper JP2 to set JTAG boot mode. JP3 should remain set to USB power (Pins 3 & 2).

   

   Figure 6 CoraZ7-07S jumper configuration for JTAG boot mode.

   Important

   You can keep the JP2 jumper in place, but it is important to make sure no SD card is inserted in the CoraZ7-07S when booting in JTAG mode.

3. Ensure the voltage reference daughter board is connected to the evaluation board.

4. Using the Arduino pins, plug the EVAL-AD5780ARDZ/ EVAL-AD5781ARDZ/ EVAL-AD5791ARDZ on top of the CoraZ7-07S.

5. Connect a DMM or oscilloscope to the VOUT or VOUT_BUFF connector to measure the DAC output.

6. Connect the UART port of CoraZ7-07S to a PC via Micro-USB cable.

7. Power up the setup by plugging the Micro-USB cable into your PC’s USB port.

8. Observe serial console output messages on your terminal.

Console output

The following is what is printed in the serial console, after you have connected to the proper ttyUSB or COM port:

Complete boot log

Note

The DAC configuration output will print in the console showing the register writes and voltage output status. The program will complete once the DAC is configured with the target output value.