background image

Matchstiq-Z1 Getting Started Guide

ANGRYVIPER Team

| ocpi.assets

| /home/user/ocpi_projects/assets

| True

|

----------------------------------------------------------------------------------------

3.2

Vendor Software Setup

The platform that is expected to be used is the Epiq Solutions Matchstiq-Z1 (

e.g.

matchstiq_z1). This

OpenCPI-enabled platform provides the capability of deploying hardware and software workers while using Xilinx’s
13.3 distribution of Linux.

The synthesizers and cross-compilers required to build HDL and RCC Workers for this platform are installed by
following the instructions found in the

OpenCPI FPGA Vendor Tools Installation Guide

. This document assumes

that the user has installed the appropriate versions of Vivado and the Xilinx SDK.

3.3

Building OpenCPI projects:

core

and

assets

The

core

and

assets

projects must be built

in a specific order

for this platform. This section outlines how to build

the relevant projects and provides the commands to do so.

For this document, the projects should be built as follows:

1. Build

core

for the

xilinx13_3

RCC Platform and the

matchstiq_z1

HDL Platform (approx 30 min)

2. Build

assets

for the

xilinx13_3

RCC Platform and the

matchstiq_z1

HDL Platform, but omit assemblies

(approx 45 min)

3. Build the

testbias

assembly from the

assets

project. This will be used later in this guide. (approx 10 min)

$ cd /home/<user>/ocpi_projects/
$ ocpidev build -d core --rcc-platform xilinx13_3 --hdl-platform matchstiq_z1
$ ocpidev build -d assets --rcc-platform xilinx13_3 --hdl-platform matchstiq_z1 --no-assemblies
$ ocpidev build -d assets hdl assembly testbias --hdl-platform matchstiq_z1

Note: replace “

<user>

” with your username in the commands above.

Each of these build commands can also be performed via the ANGRYVIPER IDE as follows:

To perform this operation within the IDE:

1. Open the ANGRYVIPER Perspective

2. Select the asset from OpenCPI Project View

3. Import to ANGRYVIPER Operations Panel using “

>

” button

4. Select the RCC and/or HDL platforms for the build (use

Ctrl

for multiple selection)

5. Click “Build”

See the ANGRYVIPER Team’s Getting Started Guide for additional information concerning the use of

ocpidev

and the ANGRYVIPER IDE to build OpenCPI assets.

3.4

Hardware Setup

Epiq Solutions Matchstiq-Z1 SDR Kit

It is expected that this SDR kit includes a power supply, two SMA/SMB adapters, micro-USB to USB cable,
micro-SD card installed internally (expected).

A micro-USB connector on the back of the Matchstiq-Z1 provides access to the serial connection. To expose
this micro-USB connector, the two screws in the back plate must be removed. Historically, this connector’s
attachment to the PCB has been extremely fragile,

so be careful when inserting/removing the mating

cable

.

6

Summary of Contents for Matchstiq-Z1

Page 1: ...OpenCPI Matchstiq Z1 Getting Started Guide Version 1 5 1 ...

Page 2: ...evision History Revision Description of Change Date v1 1 Initial Release 3 2017 v1 2 Updated for OpenCPI Release 1 2 8 2017 v1 3 Updated for OpenCPI Release 1 3 2 2018 v1 4 Update descriptions and paths 9 2018 v1 5 Update for OpenCPI Release 1 5 4 2019 2 ...

Page 3: ...k Mode 9 4 5 SD Card Source 9 4 6 No changes required for SDHOME partition 9 5 Script Setup 10 5 1 Setting up the Network and Standalone Mode scripts 10 5 1 1 Network Mode 10 5 1 2 Standalone Mode 10 5 2 Setup system time reference 11 5 3 rsync provided binary 11 6 Hardware Setup 12 6 1 Establish a Serial Connection 12 6 2 Update U boot Variables 12 7 Development Host Setup Network Mode ONLY 14 7 ...

Page 4: ...ding of the Linux command line or shell environment The reference s in Table 1 can be used as an overview of OpenCPI and may prove useful Title Link Acronyms and Definitions Acronyms_and_Definitions pdf Getting Started Getting_Started pdf Installation Guide RPM_Installation_Guide pdf Table 1 References 4 ...

Page 5: ...i assets Projects containing framework essential compo nents workers platforms etc opencpi devel x86_64 rpm Additional header files and scripts for developing new assets as HDL and or RCC opencpi sw platform xilinx13_3 noarch rpm Additional files necessary to build the framework targeting specific RCC software platforms inde pendent of the final deployed hardware opencpi hw platform matchstiq_z1 x...

Page 6: ...roject This will be used later in this guide approx 10 min cd home user ocpi_projects ocpidev build d core rcc platform xilinx13_3 hdl platform matchstiq_z1 ocpidev build d assets rcc platform xilinx13_3 hdl platform matchstiq_z1 no assemblies ocpidev build d assets hdl assembly testbias hdl platform matchstiq_z1 Note replace user with your username in the commands above Each of these build comman...

Page 7: ...PI in Network mode On the front panel of the Matchstiq Z1 there are three labeled SMB 50 Ohm connectors RX receive TX transmit and GPS From the factory the Matchstiq Z1 is provided with two SMB to SMA adapters Due to the RF performance to the transceiver device any RF COAX cables should be rated up to at least 3GHz Figure 2 Connected Front Panel Access to a network which supports DHCP Network Mode...

Page 8: ...ill likely be something like dev sdb or dev mmcblk0 dmesg tail n 15 2 Run the following dd command to make a backup image where DEVICENAME was determined above This step should take 15 minutes depending on the card size dd if DEVICENAME of backup image 4 2 Format the SD card for OpenCPI The Matchstiq Z1 SDR requires an SD card with a specific partition and content The recommend method for formatti...

Page 9: ...ard then copy the relevant bitstreams artifacts into the artifacts directory and application XMLs into the applications directory For this getting started guide only one bitstream is required to be copied onto the SD cards where as the required artifacts and application XML where copied to the SD along with the entire opencpi directory cp rL opt opencpi cdk matchstiq_z1 sdcard xilinx13_3 opencpi r...

Page 10: ...ollowing lines which are necessary for mounting core and assets project mkdir p mnt ocpi_core mount t nfs o udp nolock soft intr 1 home user ocpi_projects core mnt ocpi_core mkdir p mnt ocpi_assets mount t nfs o udp nolock soft intr 1 home user ocpi_projects assets mnt ocpi_assets 2 Edit home user ocpi_projects core and home user ocpi_projects assets to reflect the paths to the core and assets pro...

Page 11: ...at radio start up Use the date command to manually set the Linux system time See man date on the host PC for more information 5 3 rsync provided binary An ARM compiled version of rsync is provided in the included SD card image for xilinx13_3 This tool allows the use of standalone mode while shortening the required developer time to synchronize the artifacts being developed For command line usage s...

Page 12: ...e the following command to connect to the serial port screen dev matchstiq_z1_0 115200 6 2 Update U boot Variables 1 Remove power from the Matchstiq Z1 unit 2 Insert the SD card into the front panel SD card slot 3 Connect a terminal to the rear micro USB connector of the Matchstiq Z1 with a baud rate of 115200 per the previous section screen dev matchstiq_z1_0 115200 can be used to connect to the ...

Page 13: ..._reset 1 fatload mmc iv_mmc loadaddr xloadfile xload loadaddr filesize axi_reset 0 ocpiboot setenv bootargs console ttyPS0 115200n8 mem 240M root dev ram rw earlyprintk setenv fdt_high ffffffff setenv initrd_high 0x1000000 fatload mmc iv_mmc dtbaddr dtbfile fatload mmc iv_mmc loadaddr bootfile fatload mmc iv_mmc 0x2000000 uramdisk image gz bootm loadaddr 0x2000000 dtbaddr sdboot run mmcxload run d...

Page 14: ...ortfs av From the host restart the services that have modified for the changes to take effect sudo service nfs start 7 1 2 CentOS 7 From the host install the necessary tools using yum sudo yum install nfs utils 1 From the host allow NFS past SELinux2 sudo setsebool P nfs_export_all_rw 1 sudo setsebool P use_nfs_home_dirs 1 From the host allow NFS past the firewall sudo firewall cmd permanent zone ...

Page 15: ...XX XX XX XX MM rw sync no_root_squash crossmnt fsid 33 host core project location XX XX XX XX MM rw sync no_root_squash crossmnt fsid 34 host assets project location XX XX XX XX MM rw sync no_root_squash crossmnt fsid 35 host assets_ts project location XX XX XX XX MM rw sync no_root_squash crossmnt fsid 36 Restart the services that have modified for the changes to take effect sudo systemctl enable...

Page 16: ...PetaLinux login to the system using root for user name and password Figure 3 Successful Boot to PetaLinux 6 Setup the OpenCPI environment on remote system Each time the SDR is booted the OpenCPI environment must be setup By sourcing the mynetsetup sh script the remote system s environment is configured for OpenCPI and NFS directories are mounted for Network mode 3 The user must provide the network...

Page 17: ...de ANGRYVIPER Team Figure 4 Successful Network Mode Setup Note If the output includes Attempting to set the time from time server Alarm clock ntp was unable to set time using servers in ntp conf For more information see Section 5 2 17 ...

Page 18: ...erial terminal application to establish a serial connection for example screen dev matchstiq_z1_0 115200 5 After a successful boot to PetaLinux login to the system using root for user name and password Figure 5 Successful Boot 6 WARNING Applications including XML only ones fail if there is not an IP address assigned to the platform even when in standalone mode When the Ethernet port is not connect...

Page 19: ...l setup of the platform will look as follows Figure 6 Successful Standalone Mode Setup Note If the output includes Attempting to set the time from time server Alarm clock ntp was unable to set time using servers in ntp conf For more information see Section 5 2 19 ...

Page 20: ...nx13_3 Actual deployment is Instance 0 file_read spec ocpi core file_read on rcc container 1 rcc0 using file_read in mnt ocpi_core artifacts ocpi core file_read rcc 0 xilinx13_3 so dated Tue Apr 9 11 34 43 2019 Instance 1 bias spec ocpi core bias on hdl container 0 PL 0 using bias_vhdl a bias_vhdl in mnt ocpi_assets applications rx_app artifacts ocpi assets testbias_matchstiq_z1_base hdl 0 matchst...

Page 21: ...rty 34 file_write ocpi_debug false parameter Property 35 file_write ocpi_endian little parameter Application started running Waiting up to 1 seconds for application to finish Application is now considered finished after waiting 1 seconds Dump of all final property values Property 3 file_read messageSize 16 Property 6 file_read bytesRead 1776 Property 7 file_read messagesWritten 111 Property 9 file...

Page 22: ...am Run the following command to view the input It should look like Figure 7 hexdump test input less Figure 7 Expected Input Run the following command to view the output It should look like Figure 8 hexdump test output less Figure 8 Expected Output 22 ...

Page 23: ...card are mounted at mnt card opencpi xilinx13_3 artifacts After running mysetup sh navigate to mnt card opencpi applications and ensure the OCPI_LIBRARY_PATH variable is configure as shown below cd mnt card opencpi applications export OCPI_LIBRARY_PATH OCPI_LIBRARY_PATH mnt card opencpi xilinx13_3 artifacts Run the application using the following command ocpirun v t 1 d m bias hdl bias xml The out...

Page 24: ... Run the following command to view the input It should look like Figure 10 hexdump test input less Figure 10 Expected Input Run the following command to view the output It should look like Figure 11 hexdump test output less Figure 11 Expected Output 24 ...

Page 25: ...raints and perform the following steps 1 Modify the target part in assets hdl platforms matchstiq_z1 matchstiq_z1 mk to use the ISE alias HdlPart_matchstiq_z1 xc7z020_ise_alias 1 clg484 2 Export the ISE constraints files found in assets hdl platforms matchstiq_z1 ise_constraints by modifying ExportFiles variable in assets hdl platforms matchstiq_z1 Makefile ExportFiles ise_constraints matchstiq_z1...

Reviews: