ByteTools STAPL Player

ByteTools STAPL Player is a command line utility which is built on top of Catapult JTAG Library ( btjfsm.dll / ). STAPL Player is used to execute JAM standard STAPL files using Catapult JTAG probes ( both USB and Ethernet versions). It is available for both 32bit and 64 bit Microsoft Windows and Linux platform.

The following snapshot is taken from the Windows platform.

C:\Program Files\ByteTools\STAPLPlayer>staplplayer.exe

ByteTools STAPL Player  - Version
Copyright (C) 2005-2011 ByteTools Inc.,

Usage:  staplplayer [options] <filename>

Available options:
  -h          : show help message
  -v          : show verbose messages
  -a<action>  : specify action name (Jam STAPL)
  -d<var=val> : initialize variable to specified value (Jam 1.1)
  -d<proc=1>  : enable optional procedure (Jam STAPL)
  -d<proc=0>  : disable recommended procedure (Jam STAPL)
  -J<debug-level>  : debug level between 0 and 8
  -n          : Run in native mode
  -l          : Log all transactions in Catapult Library
  -i<ip addr> : Open a Catapult Ethernet device with a specific IP address
  -s<serno>   : Open a Catapult USB device with serial number
  -r          : don't reset JTAG TAP after use

In order to use Catapult EJ probes, -i<ip address> should be given. But for USB probes, -s<serial number of the probe> should be given.

For example, to run the idcode.jam file on a Catapult EJ proble, user has to provide the following option.

C:\Program Files\ByteTools\STAPLPlayer>staplplayer.exe -i192.168.1.4 -aread_idcode idcode.jam

Note that there is no space between -i and the IP address of the device.

Software Revision

v0.3.0.22 (Released on 1st May 2011)

  • Unnecessary printfs are cleaned in dependent libraries
  • Fix is done to allow white space in HEX and BINARY strings


The Windows installer is a simple installation wizard. But for Linux, it is a tarball. Once the tarball is uncompressed in a specific directory, the path should be exported via LD_LIBRARY_PATH.

Eg. If the installed directory is /home/fred/staplplayer, use the following command to export the path.

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/fred/staplplayer

If the path is not exported, the following error can be occured.

./staplplayer : error while loading shared libraries :  cannot open shared object file:No such file or directory

Personal Tools