Avnet Reach Further Ultra96-V2 User manual

Page 1
Copyright © 2019 Avnet, Inc. AVNET, “Reach Further,” and the Avnet logo are registered
trademarks of Avnet, Inc. All other brands are the property of their respective owners.
LIT# Ultra96-V2-GSG-v1-0
Ultra96-V2 Getting Started Guide
Version 1.0

Page 2
Document Control
Document Version: 1.0
Document Date: 25 Jun 2019
Prior Version History
Version Date Comment
1.0 25 Jun 2019 Initial Ultra96-V2 Getting Started Guide (30 May 2019 image)

Page 3
Contents
1 Getting Started with Ultra96-V2 ............................................................................ 5
2 What’s Inside the Box? ......................................................................................... 6
2.1 Optional add-on items: ............................................................................................................. 6
3 What’s on the Web?.............................................................................................. 7
3.1 Official Documentation: ............................................................................................................ 7
3.2 Tutorials and Reference Designs: ............................................................................................ 7
3.3 Trainings and Videos: ............................................................................................................... 7
4 Ultra96-V2 Key Features ...................................................................................... 8
5 Ultra96-V2 Basic Setup and Operation ............................................................... 10
6 Example Design .................................................................................................. 11
7 Hardware Setup .................................................................................................. 11
8 Power Up and Connect to Wi-Fi ......................................................................... 14
9 Ultra96-V2 GPIO LEDs Example Project ............................................................ 18
10 Example Projects ................................................................................................ 20
11 Custom Content Tutorial ..................................................................................... 21
12 Using Ultra96-V2 Tutorial .................................................................................... 22
13 Access Ultra96-V2 Linux Terminal over SSH ..................................................... 23
14 Power Off ............................................................................................................ 26
15 Getting Help and Support ................................................................................... 27
15.1 Avnet Support ......................................................................................................................... 27
15.2 Xilinx Support ......................................................................................................................... 28
16 Installing and Licensing Xilinx Software .............................................................. 29
16.1 Install Vivado Design Suite, Design Edition ........................................................................... 29
17 Certification Disclaimer ....................................................................................... 33
18 Safety Warnings ................................................................................................. 33
19 RF Certification ................................................................................................... 33

Page 4
Figures
Figure 1 – Ultra96-V2 .................................................................................................. 5
Figure 2 – Ultra96-V2 Block Diagram .......................................................................... 9
Figure 3 – Ultra96-V2 Topology ................................................................................ 10
Figure 4 – Ultra96-V2 SW3 Boot Mode Switch Location ........................................... 11
Figure 5 – Ultra96-V2 with JTAG/UART Pod ............................................................ 12
Figure 6 – JTAG/UART Pod Alignment ..................................................................... 12
Figure 7 – Ultra96-V2 Booted .................................................................................... 14
Figure 8 – Successful Wi-Fi Connection on Ultra96-V2 ............................................ 16
Figure 9 – Find the IP Address .................................................................................. 16
Figure 10 – Connected to Ultra96-V2 Webserver ..................................................... 17
Figure 11 – Ultra96-V2 GPIO LEDs .......................................................................... 18
Figure 12 – Ultra96-V2 User LEDs ............................................................................ 18
Figure 13 – Mapping from Web Page to Actual LED ................................................. 19
Figure 14 – Example Projects Under Construction ................................................... 20
Figure 15 – Ultra96-V2 Tutorials/Guides ................................................................... 21
Figure 16 – TeraTerm New Connection .................................................................... 23
Figure 17 – SSH Terminal Settings ........................................................................... 24
Figure 18 – Click Continue ........................................................................................ 24
Figure 19 – SSH Authentication ................................................................................ 25
Figure 20 – Ultra96-V2 Terminal ............................................................................... 25
Figure 21 – Power Down Initiated Through Short Press of SW4 ............................... 26
Figure 22 – Voucher Confirmation ............................................................................ 30
Figure 23 – Generate Node-Locked .......................................................................... 30
Figure 24 – Select Host Information .......................................................................... 31

Page 5
1 Getting Started with Ultra96-V2
The Avnet Ultra96-V2 enables hardware and software developers to explore the capabilities of
the Zynq® UltraScale+™ MPSoC. Designers can create or evaluate designs for both the Zynq
Processor Subsystem (PS) and the Programmable Logic (PL) fabric.
Figure 1 – Ultra96-V2
This Getting Started Guide will outline the steps to setup the Ultra96-V2 hardware. It documents
the procedure to run a Linux design running on the Quad-core ARM Cortex-A53 MPCore
Processing System (PS).

Page 6
2 What’s Inside the Box?
 Ultra96-V2 development board
 16GB microSD card with SD adapter and jewel case
 Voucher for SDSoC license from Xilinx
 Quick Start Instruction card
2.1 Optional add-on items:
 External 96Boards compliant power supply kit (12V, 4A, International plugs)
o AES-ACC-U96-4APWR
o http://avnet.me/96boardpower4A
 USB-to-JTAG/UART pod for Ultra96-V2
o AES-ACC-U96-JTAG
o http://avnet.me/Ultra96JTAG
 96Boards Click Mezzanine for adding Click boards to the Ultra96-V2
o Mezzanine only -- AES-ACC-U96-ME-MEZ
o Starter kit including 3 Click boards -- AES-ACC-U96-ME-SK
o http://avnet.me/ClickMezzanine
 miniDP-to-HDMI adapter or cable
o Must be an Active adapter or cable
See the Ultra96-V2 Compatible Accessories document and http://avnet.me/Ultra96_Accessories for
other suggestions.

Page 7
3 What’s on the Web?
Ultra96-V2 is a community-oriented kit, with all materials being made available through the
http://avnet.me/ultra96-v2 community website.
3.1 Official Documentation:
 Getting started guide
 Hardware user guide
 Schematics
 Bill of materials
 Mechanical drawing
 3D Model
 Board definition files for Vivado integration available at https://github.com/Avnet/bdf.
 Programmable logic (PL) master user constraints
3.2 Tutorials and Reference Designs:
 TBD
3.3 Trainings and Videos:
 Live and On-Demand Technical Training Courses at http://avnet.me/TTC

Page 8
4 Ultra96-V2 Key Features
 Zynq UltraScale+ MPSoC ZU3EG SBVA484
 Memory
o Micron 2 GB (512M x32) LPDDR4 Memory
o microSD Socket
 Ships with Delkin Utility MLC 16GB card
 Wi-Fi / Bluetooth
 DisplayPort
 1x USB 3.0 Type Micro-B upstream port
 2x USB 3.0 Type A downstream ports
 40-pin Low-speed expansion header
 60-pin High speed expansion header
 Mounted on thermal bracket with fan
Note that there is no on-board, wired Ethernet interface. All communications must be done
via USB, Wi-Fi, JTAG, or expansion interface.

Page 9
Figure 2 – Ultra96-V2 Block Diagram
UART
(4-pin header)

Page 10
5 Ultra96-V2 Basic Setup and Operation
The functionality of the Ultra96-V2 is determined by the application booted from the non-volatile
memory – by default that is the microSD Card. This Getting Started Guide allows system
developers to exercise and demonstrate multiple circuits through PetaLinux, including:
 SSH Terminal Access
 GPIO LEDs
 Wi-Fi
In addition to the items included in the kit, you will also need the following to complete the
exercises in this tutorial.
 Ultra96 USB-to-JTAG/UART Pod (required for terminal access)
o or
 Monitor (requires connection to miniDP port), keyboard, mouse
An Ultra96-V2 image in its expected out-of-box configuration is shown below along with various
topology components highlighted.
Figure 3 – Ultra96-V2 Topology

Page 11
6 Example Design
The Ultra96-V2 example design must first be written to the 16GB microSD Card, which ships
blank.
1. Please download the image and instructions at http://avnet.me/ultra96-v2-oob
2. Complete the process to write the image to your 16GB card.
3. Insert the microSD card into the Ultra96-V2 card cage J2.
7 Hardware Setup
1. A terminal program is required. TeraTerm was used in this example which can be
downloaded from the TeraTerm project on the SourceForge Japan page:
ttssh2.sourceforge.jp Install TeraTerm or another terminal program of your choice.
2. Set the Ultra96-V2 boot mode switch SW3 to SD Card boot mode as shown below with
Switch 1 in the OFF position and Switch 2 in the ON position.
Figure 4 – Ultra96-V2 SW3 Boot Mode Switch Location

Page 12
3. If you will be using a USB-to-JTAG/UART Pod, plug that into J1 and J3 before plugging
in 12V power. Note that some Pods only have a 3-pin and 7-pin receptacles, which is
compatible with the 4-pin and 8-pin headers on Ultra96-V2 (align as seen in Figure 6
below).
Figure 5 – Ultra96-V2 with JTAG/UART Pod
Figure 6 – JTAG/UART Pod Alignment

Page 13
4. Plug in your 12V Barrel Jack power supply into a wall outlet and then connect the barrel
jack to J10 on your Ultra96-V2. Green Vin status LED D17 will light, but the board is not
yet powered on.
Note: DC power supply is not included in the Ultra96-V2 kit but can be purchased
separately.
The Ultra96 USB-to-JTAG/UART Pod ships with pre-programmed firmware that allows the
JTAG interface to be recognized by Xilinx Vivado software. Additionally, most host machines will
also automatically install the driver for the Serial Terminal interface.
5. Plug a microUSB cable between the Pod’s microUSB Port (J1) and a host computer.
6. If the serial terminal drivers do not automatically install, you can manually install the
driver for the FT2232H device. Visit www.ftdichip.com/Drivers/VCP.htm then download
and install the appropriate driver for your operating system.
7. Launch your Serial Terminal with settings of 115200-8-N-1.

Page 14
8 Power Up and Connect to Wi-Fi
1. Press and release the power button (SW4). The Green Power On LED (D2), Red INIT_B
LED (D5) and the Green User LEDs should illuminate. After a few seconds, INIT_B LED
will turn off and the Blue DONE LED (D1) will illuminate. You will immediately see output
to the terminal screen as Linux boots. At ~30 seconds, the Green User LED D7 will blink
in a heartbeat fashion.
2. You can ignore the Bluetooth warnings as shown below. Hit the enter key to get to the
prompt.
Figure 7 – Ultra96-V2 Booted
3. Login using username = “root” and password = “root”
4. You should already be in the home directory /home/root. If not, then enter the following
command:
cd /home/root
5. Now list the contents of that directory.
ls
6. You should observe that there are 4 files present. We will use both the
wpa_supplicant.conf and wifi.sh files to bring up the Wi-Fi.
a) ble.sh
b) bt.sh
c) wifi.sh
d) wpa_supplicant.conf

Page 15
7. Before bringing up the Wi-Fi interface you must first edit the
/home/root/wpa_supplicant.conf file with the correct SSID and security
password for your Wi-Fi access point. You can use the built-in vi editor to do this.
vi wpa_supplicant.conf
a) If you are not familiar with vi, the easiest thing to do is to edit the SSID_here and
password_here fields in the following lines in a text editor, then copy to your
clipboard.
ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
update_config=1
network={
key_mgmt=WPA-PSK
ssid="RCK_MY_WRLD"
psk="AABBCCDDEEFF00112233445566"
}
b) Enter the following commands into vi:
i. 9dd
ii. i
iii. <paste command> -- in TeraTerm it is Alt-V
iv. ESC key
v. :wq
8. Once that is done, run the supplied wifi.sh script to copy the wpa_supplicant.conf file to
/etc, load the kernel modules for the driver, and bring up the Wi-Fi interface:
./wifi.sh
9. If successful, move on to step 13. If it fails due to bad SSID or password, you may see
the following message. Work through the following steps to correct it.
Successfully initialized wpa_supplicant
ctrl_iface exists and seems to be in use - cannot override it
Delete '/var/run/wpa_supplicant/wlan0' manually if it is not used anymore
Failed to initialize control interface '/var/run/wpa_supplicant'.
You may have another wpa_supplicant process already running or the file was
left by an unclean termination of wpa_supplicant in which case you will need
to manually remove this file before starting wpa_supplicant again.
10. Enter this command to remove the reference to wlan0
rm /var/run/wpa_supplicant/wlan0

Page 16
11. Edit /home/root/wpa_supplicant.conf again to correct the mistake
12. Run the wifi.sh script again.
./wifi.sh
13. A successful connection should appear like the following:
Figure 8 – Successful Wi-Fi Connection on Ultra96-V2
14. Use ifconfig to determine the IP address assigned to the board.
ifconfig
Figure 9 – Find the IP Address

Page 17
15. Open a browser using a machine connected to the same network, and then browse to
the IP address of the board. The browser page will show like below.
Figure 10 – Connected to Ultra96-V2 Webserver
Note that this design is still in the process of being updated. The MAC Address is correct, but
the IP Address is not. Also, many of the tutorials are not functional yet. We will release a new
image with updates and corrections in July 2019.

Page 18
9 Ultra96-V2 GPIO LEDs Example Project
1. Next we want to access the Ultra96-V2 GPIO LEDs example project. From the Ultra96-
V2 home page select Ultra96 GPIO LEDs example project
Figure 11 – Ultra96-V2 GPIO LEDs
Be aware that the photo on this page and the LED reference designators is the older Ultra96-
V1. The new Ultra96-V2 LEDs are D3, D4, D6, and D7, shown below:
Figure 12 – Ultra96-V2 User LEDs

Page 19
2. All LEDs will be at an unknown state to begin with. Select the drop down menus and
begin changing the status of the GPIO LEDs. You will notice that the four LEDs (located
in between the two USB connectors J8/J9) update in real time. See the mapping below.
For example, if you change the pull-down for LED2/DS5, then LED D7 which is closest
to USB Connector J8 will be the one to change.
Figure 13 – Mapping from Web Page to Actual LED
3. Scroll to the bottom of the webpage and you will see a definition table for various LED
selection options.

Page 20
10 Example Projects
Unfortunately, the Example Projects besides the GPIO LEDs are still under construction.
Figure 14 – Example Projects Under Construction