PCD8 8-bit DMA Interface User’s Guide About the Software and Firmware
EDT, Inc. May 2007 4
Software Initialization Files
Software initialization files (having the extension .cfg) are editable text files that run like scripts to
configure EDT boards so that they are ready to perform DMA. The commands in a software
initialization file are defined in a C application named
initpcd. When you invoke initpcd, you specify
which software initialization file to use with the
-f flag.
A typical software initialization file loads an FPGA configuration file into the UI FPGA and sets up
various registers to prepare the board for DMA transfers. Some software initialization files may also
load an FPGA configuration file into an FPGA residing on the mezzanine board.
A variety of software initialization files are included with the EDT software, at least one of which is
customized for each main board or main board / mezzanine board combination — that is, each FPGA
configuration file has a matching software initialization file. Software initialization files are located in
the
pcd_config subdirectory of the EDT top-level distribution directory. The software initialization files
specific to your PCD8 are listed at the beginning of this section. Instructions for their use are provided
in Configuring the PCD8.
Commands defined in
initpcd and typically found in software initialization files allow for specific
FPGA configuration files to be loaded (for example,
bitfile:), write specified hexadecimal values to
specified registers (for example,
command_reg:), enable or disable byte-swapping or short-swapping
to accommodate different operating systems’ requirements for bit ordering (for example,
byteswap:),
or invoke arbitrary commands (for example,
run_command:). For example:
bitfile: ssd16io.bit
command_reg: 0x08
byteswap: 1
run_command: set_ss_vco -F 1000000 2
For complete usage details, enter
initpcd --help.
C source for
initpcd is included so that you can add your own commands, if you wish. You can then
edit your own software initialization file to use your new commands and specify that
initpcd use your
new file when configuring your board. If you would like us to include your new software initialization
commands in subsequent releases of
Sample Applications and Utilities
Along with the driver, the FPGA configuration files, and the software initialization files, the software CD
includes a number of applications and utilities that you can use to initialize and configure the board,
access registers, or test the board. For many of these applications and utiilities, C source is also
provided, so that you can use them as starting points to write your own applications. The most
commonly useful are described below; see the README file for the complete list.
NOTE Software is updated regularly; the latest versions are available on our website at
www.edt.com/software.html. We encourage you to use the latest versions for new installations.
For existing applications, upgrade only if you have a specific reason to do so.
Sample Applications
rd16 Performs simple multichannel ring buffer input.
wr16 Performs simple multichannel ring buffer output.
simple_read Performs DMA input without using ring buffers. Data is therefore subject to
interruptions, depending on system performance.
Komentarze do niniejszej Instrukcji