Using the Achronix STAPL Player
Connecting to Specific Pods by Name (-p option)
Bitporter User Guide
PAGE 29
In this example, pod 12345 is connected via USB, and is currently not in use. Pod 12346 is visible
via Ethernet, but is already in use by a host at IP address 192.168.1.123. Pod 12347 is also visible
via Ethernet, currently has no owner, and is thus available for use. Pod 12348 is not listed, which
means it must also be connected via USB, but it is in use. (USB probes in use are not listed.)
In this case, the user can run acx_stapl_player to connect to either usb12345, net12347, via the
-p
command-line option.
Connecting to Specific Pods by Name (-p option)
When multiple pods are visible to the acx_stapl_player, the user must specify which pod the
acx_stapl_player should use to communicate with a device. The desired pod is specified with
the
-p
command-line option, where the user specifies a podname or a list of potential podnames
to be used. To determine which pods are currently available for use, the
-q
option is used.
Once a pod name or list of pod names is known, they can be specified on the command-line as
a comma-separated list immediately following the
-p
on the command-line. When multiple
pod names are listed, acx_stapl_player attempts to connect to them in the specified order and
uses the first available specified pod. The player reports which pod is being used.
For example, to read the JTAG IDCODE of the Achronix device connected to the first available
pod via pods 12348, 12345, and 12347, in that order, use the following command:
acx_stapl_player -pusb12348,usb12345,net12347 -aREAD_IDCODE quickstart.jam
The command returns:
Achronix STAPL Player (acx_stapl_player) -- Version 1.5
(c) Copyright 2007, 2008 Achronix Semiconductor Corp. All rights
reserved.
contains elements of Jam STAPL Player Version 2.5 (20040526)
Copyright (C) 1997-2004 Altera Corporation
Attempting to auto-discover Bitporter pods (USB pods and Ethernet pods on
this subnet)...
...found 3 pods.
|==========|=================|
| Pod | (Ethernet only) |
| Name | Owner's IP addr |
|==========|=================|
| usb12345 | <not tracked> |
| net12346 | 192.168.1.123
|
| net12347 | <available>
|
|==========|=================|
Attempting to connect to user-specified pod(s):
WARNING: User-specified pod "usb12348" not found/not connected.
Successfully opened Bitporter pod usb12345.
Entering ISP programming mode...
Reading Device ID code...
IDCODEVALID=1
IDCODE=00100000 00000000 00010110 01000001
Exiting ISP programming mode...
Exit code = 0... Success
The STAPL Player attempts to connect to the pods in the order listed, then plays the specified
Action using the first successful connection. Unsuccessful connection attempts are reported as
WARNINGS.