Matchstiq-Z1 Getting Started Guide
ANGRYVIPER Team
4
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. A feature of this SDR is that when an SD card is installed in the front panel SD
slot, the SDR will automatically choose to operate from this SD card rather than the internal SD card. Therefore,
a user can easily switch the SDR between operating in the Epiq Solutions or OpenCPI environment.
The Matchstiq-Z1’s factory SD card has a non-default formatting and content, which
must
be maintained for
proper operation. This guide assumes that the internal (factory) SD card is being use for OpenCPI and will be
reinstalled in the front panel SD card slot. If the user desires the use of a new SD card, the user must ensure that
it is initially imaged from the factory provided SD card, as there is a unique partition containing required content
from the OEM.
4.1
Make a backup image of factory SD card (assumes Linux host)
This section provides the steps for creating an SD card backup image. Access the internal SD card slot by removing
the screws from the front and back plates, then slide the board assembly out of the enclosure. Flip the SD card slot
open and lift the card out. Insert the SD card into a USB reader and install into a host machine.
1. Determine the device file name for the SD card by executing dmesg command below. It will 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
formatting a new SD card is to begin by imaging the new card using the backup image of the factory SD card,
removing factory default files and directory and copying OpenCPI content to SD card.
1. Format an SD card for OpenCPI, (restore to its original factory default captured in the previous section), run
the command
$ dd of=DEVICENAME if=backup.image
2. To prepare for OpenCPI provided content to be placed onto the SD card, remove all factory files and directories
from the ATLAS partition.
4.3
Copy embedded OS files to SD card, “ATLAS” partition
WARNING: The user must ensure that the contents of the SD, match the version of the OpenCPI release that the
artifacts were built against.
Copy the following files/directories into the “ATLAS” partition:
$ cp /opt/opencpi/cdk/matchstiq_z1/sdcard-xilinx13_3/iveia-atlas-i-z7e.dtb /run/media/<user>/ATLAS/
$ cp /opt/opencpi/cdk/matchstiq_z1/sdcard-xilinx13_3/u-boot.bin /run/media/<user>/ATLAS/
$ cp /opt/opencpi/cdk/matchstiq_z1/sdcard-xilinx13_3/uImage /run/media/<user>/ATLAS/
$ cp /opt/opencpi/cdk/matchstiq_z1/sdcard-xilinx13_3/uramdisk.image.gz /run/media/<user>/ATLAS/
Any files/directories copied to the “ATLAS” partition will appear at /mnt/card on the Matchstiq-Z1.
The need to copy the
/opt/opencpi/cdk/matchstiq_z1/opencpi
onto the SD card is dependent on the desired
operating mode (Standalone vs Network) and is discussed in the following sections.
8
