Epiq Solutions Matchstiq-Z1 Getting Started Download Page 3

Page: 3 / 25

Matchstiq-Z1 Getting Started Guide

ANGRYVIPER Team

Table of Contents

Installation of provided OpenCPI projects:

core

and

assets

. . . . . . . . . . . . . . . . . . . . . . . .

3.2

Vendor Software Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.3

Building OpenCPI projects:

core

and

assets

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.4

Hardware Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4 SD Card Setup

4.1

Make a backup image of factory SD card (assumes Linux host) . . . . . . . . . . . . . . . . . . . . . .

4.2

Format the SD card for OpenCPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.3

Copy embedded OS files to SD card, “ATLAS” partition . . . . . . . . . . . . . . . . . . . . . . . . . .

4.4

Copy files to SD card for desired Mode(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.4.1

Standalone and Network Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.4.2

Standalone Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.4.3

Network Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.5

SD Card Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.6

No changes required for “SDHOME” partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 Script Setup

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

6.1

Establish a Serial Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

6.2

Update U-boot Variables

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

7 Development Host Setup - Network Mode ONLY

7.1

Network Mounting Mode

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

7.1.1

CentOS 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

7.1.2

CentOS 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

8 Configuring the run-time environment on the platform

8.1

Network Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

8.2

Standalone Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

9 Build an Application

10 Run an Application

10.1 Network Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
10.2 Standalone Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Appendices

A Intermittent Errors

B Using ISE instead of Vivado with the Matchstiq-Z1

C Driver Notes

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...

Search results

Summary of Contents for Matchstiq-Z1

Reviews:

Related manuals for Matchstiq-Z1

Brands by name

Popular brands

Epiq Solutions Matchstiq-Z1, Getting Started

Search results

Summary of Contents for Matchstiq-Z1

Reviews:

Related manuals for Matchstiq-Z1

Brands by name

Popular brands