1. Manuals
  2. Brands
  3. Epiq Solutions Manuals
  4. Network Hardware
  5. Matchstiq-Z1
  6. Getting started

Epiq Solutions Matchstiq-Z1 Getting Started

Version 1.5
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
OpenCPI
Matchstiq-Z1 Getting Started Guide
Version 1.5
1

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Matchstiq-Z1 and is the answer not in the manual?

Questions and answers

Related Manuals for Epiq Solutions Matchstiq-Z1

Summary of Contents for Epiq Solutions Matchstiq-Z1

  • Page 1 OpenCPI Matchstiq-Z1 Getting Started Guide Version 1.5...
  • Page 2 Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team Revision 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...

  • Page 3: Table Of Contents

    10.2 Standalone Mode ..........23 Appendices A Intermittent Errors B Using ISE instead of Vivado with the Matchstiq-Z1 C Driver Notes...

  • Page 4: References

    Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team References This document assumes a basic understanding 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...

  • Page 5: Overview

    ANGRYVIPER Team Overview This document provides steps for configuring a factory provided Epiq Solutions Matchstiq-Z1 SDR with the OpenCPI run-time environment for executing applications, configuring a development system to build OpenCPI bitstreams targeting the matchstiq_z1 platform, and examples of executing applications on the OpenCPI configured Matchstiq- Z1.

  • Page 6: Vendor Software Setup

    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.
  • Page 7 OpenCPI 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.

  • Page 8: Sd Card Setup

    SD Card Setup The Matchstiq-Z1 SDR is equipped with two SD card slots: one internal and one accessible via the front panel. It is expected that the SDRs are shipped from Epiq Solutions with an SD card installed in the internal slot that is loaded with their embedded environment.

  • Page 9: Copy Files To Sd Card For Desired Mode(S)

    Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team Copy files to SD card for desired Mode(s) As previously discussed, Standalone and Network modes offer trade-offs for configuring the run-time environment of the platform. The following sections provide instructions for copying specific files/directories to the SD card in support of these modes.

  • Page 10: Script Setup

    There are two type of setups or modes for running applications on any embedded radio: Network and Standalone. In Network mode, a development system hosts the OpenCPI tree as an NFS server to the Matchstiq-Z1 which is an NFS client. This configuration provides quick and dynamic access to all of OpenCPI, and presumably any applications, components and bitstreams.

  • Page 11: Setup System Time Reference

    Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team Setup system time reference If Linux system time is not required to be accurate, this step may be skipped. For either Network or Standalone mode, the following settings that are passed by my[net]setup.sh to the zynq_[net_]setup.sh scripts may require modification:...

  • Page 12: Hardware Setup

    • per the previous section, “screen /dev/matchstiq_z1_0 115200” can be used to connect to the serial port. 4. Apply power to the Matchstiq-Z1 with the terminal still connected and stop the boot process by hitting any key to enter the U-Boot terminal.
  • Page 13 Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team dtbfile=iveia-atlas-i-z7e.dtb iv_io=205-00034-00-A0,,Atlas-II_GF_Carrier iv_io_default=205-00034-00-A0,,Atlas-II_GF_Carrier iv_io_ord=00034 iv_mb=205-00049-00-B1,A2WT9,Atlas-I-Z7e iv_mb_ord=00049 iv_mmc=0 loadaddr=0x03000000 mmcdtload=fatload mmc ${iv_mmc} ${dtbaddr} ${dtbfile};fdt addr ${dtbaddr};fdt set /chosen bootargs "${bootargs}";fdt ivclean ${iv_mb_ord} mmcxload=axi_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;...

  • Page 14: Development Host Setup - Network Mode Only

    Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team Development Host Setup - Network Mode ONLY Network Mounting Mode The NFS server needs to be enabled on the host in order to run the SDR in Network Mode. The following sections are directions on how to do this for both CentOS 6 and CentOS 7 host operating systems.
  • Page 15 Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team % sudo vi /etc/exports.d/user_ocpi.exports /opt/opencpi XX.XX.XX.XX/MM(rw,sync,no_root_squash,crossmnt) <host core project location> XX.XX.XX.XX/MM(rw,sync,no_root_squash,crossmnt) <host assets project location> XX.XX.XX.XX/MM(rw,sync,no_root_squash,crossmnt) <host assets_ts project location> XX.XX.XX.XX/MM(rw,sync,no_root_squash,crossmnt) If the file system that you are mounting is XFS, then each mount needs to have a unique fsid defined. Instead, use: % sudo vi /etc/exports.d/user_ocpi.exports...

  • Page 16: Configuring The Run-Time Environment On The Platform

    1. Ensure the USB to Ethernet adapter is plugged into the micro-USB port of the front panel and connected to a network configured for DHCP. 2. Ensure a micro-USB to USB cable is connected between the Matchstiq-Z1’s serial port and development host. 3. Apply power to the Matchstiq-Z1 4.
  • Page 17 Matchstiq-Z1 Getting Started Guide 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...

  • Page 18: Standalone Mode

    1. Ensure the USB to Ethernet adapter (as needed) is plugged into the micro-USB port of the front panel and connected to a network configured for DHCP. 2. Ensure a micro-USB to USB cable is connected between the Matchstiq-Z1’s serial port and development host. 3. Apply power to the Matchstiq-Z1 4.
  • Page 19 Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team A successful 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...

  • Page 20: Build An Application

    Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team Build an Application The setup of the platform can be verified by running an application that uses both RCC and HDL workers. A simple application that requires two RCC and one HDL worker is located in assets/applications/bias.xml, but only the RCC artifacts are provided with the installation of RPMs, and are availble on the SD card (Standard Mode) or mounted CDK directory (Network Mode).
  • Page 21 Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team Property 20: bias.test64 = "0" Property 29: file_write.fileName = "test.output" (cached) Property 30: file_write.messagesInFile = "false" (cached) Property 31: file_write.bytesWritten = "0" Property 32: file_write.messagesWritten = "0" Property 33: file_write.stopOnEOF = "true" (cached) Property 34: file_write.ocpi_debug = "false" (parameter) Property 35: file_write.ocpi_endian = "little"...
  • Page 22 Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team 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...

  • Page 23: Standalone Mode

    Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team 10.2 Standalone Mode The default setup script sets the OCPI_LIBRARY_PATH variable to include the all of the artifacts that are required to execute the application. Specifically, all three of the artifacts that are located on the SD card are mounted at /mnt/card/opencpi/xilinx13_3/artifacts.
  • Page 24 Matchstiq-Z1 Getting Started Guide ANGRYVIPER Team 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...

  • Page 25: Appendices

    Using ISE instead of Vivado with the Matchstiq-Z1 It is recommended that you use the default toolset (Xilinx Vivado) to build Matchstiq-Z1 bitstreams with OpenCPI. However, if you wish to use ISE instead, reference the README file in assets/hdl/platforms/matchstiq_z1/ ise_constraints/, and perform the following steps: 1.

Table of Contents