--- /dev/null
+#!/usr/bin/python3.0\r
+\r
+# Copyright 2008, SoftPLC Corporation http://softplc.com\r
+# Dick Hollenbeck dick@softplc.com\r
+\r
+# This program is free software; you can redistribute it and/or\r
+# modify it under the terms of the GNU General Public License\r
+# as published by the Free Software Foundation; either version 2\r
+# of the License, or (at your option) any later version.\r
+#\r
+# This program is distributed in the hope that it will be useful,\r
+# but WITHOUT ANY WARRANTY; without even the implied warranty of\r
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\r
+# GNU General Public License for more details.\r
+#\r
+# You should have received a copy of the GNU General Public License\r
+# along with this program; if not, you may find one here:\r
+# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html\r
+# or you may search the http://www.gnu.org website for the version 2 license,\r
+# or you may write to the Free Software Foundation, Inc.,\r
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA\r
+\r
+# Dump an Xilinx XSVF file to stdout\r
+\r
+# This program is written for python 3.0, and it is not easy to change this\r
+# back to 2.x. You may find it easier to use python 3.x even if that means\r
+# building it.\r
+\r
+\r
+import sys\r
+import struct\r
+\r
+\r
+LABEL = "A script to dump an XSVF file to stdout"\r
+\r
+\r
+Xsdrsize = 0\r
+\r
+\r
+(XCOMPLETE,XTDOMASK,XSIR,XSDR,XRUNTEST,hole0,hole1,XREPEAT,XSDRSIZE,XSDRTDO,\r
+ XSETSDRMASKS,XSDRINC,XSDRB,XSDRC,XSDRE,XSDRTDOB,XSDRTDOC,\r
+ XSDRTDOE,XSTATE,XENDIR,XENDDR,XSIR2,XCOMMENT,XWAIT,XWAITSTATE,LCOUNT,LDELAY,LSDR) = range(28)\r
+\r
+\r
+(RESET,IDLE,\r
+ DRSELECT,DRCAPTURE,DRSHIFT,DREXIT1,DRPAUSE,DREXIT2,DRUPDATE,\r
+ IRSELECT,IRCAPTURE,IRSHIFT,IREXIT1,IRPAUSE,IREXIT2,IRUPDATE) = range(16)\r
+\r
+\r
+State = ("RESET","IDLE",\r
+ "DRSELECT","DRCAPTURE","DRSHIFT","DREXIT1","DRPAUSE","DREXIT2","DRUPDATE",\r
+ "IRSELECT","IRCAPTURE","IRSHIFT","IREXIT1","IRPAUSE","IREXIT2","IRUPDATE")\r
+\r
+Setsdrmasks = 0\r
+SetsdrmasksOnesCount = 0\r
+\r
+def ReadSDRMASKS( f, len ):\r
+ global Setsdrmasks, SetsdrmasksOnesCount\r
+ byteCount = (len+7)//8\r
+ Setsdrmasks = f.read( byteCount )\r
+ ls = []\r
+ SetsdrmasksOnesCount = 0\r
+ for b in Setsdrmasks:\r
+ ls.append( "%x" % ((b & 0xf0) >> 4) )\r
+ ls.append( "%x" % ( b & 0x0f ) )\r
+ for i in range(8):\r
+ if b & (1<<i):\r
+ SetsdrmasksOnesCount = SetsdrmasksOnesCount +1\r
+ return ''.join(ls)\r
+\r
+\r
+def bytes2hexString( f, len ):\r
+ byteCount = (len+7)//8\r
+ bytebuf = f.read( byteCount )\r
+ ls = []\r
+ for b in bytebuf:\r
+ ls.append( "%x" % ((b & 0xf0) >> 4) )\r
+ ls.append( "%x" % ( b & 0x0f ) )\r
+ return ''.join(ls)\r
+\r
+\r
+def ReadByte( f ):\r
+ """Read a byte from a file and return it as an int in least significant 8 bits"""\r
+ b = f.read(1)\r
+ if b:\r
+ return 0xff & b[0];\r
+ else:\r
+ return -1\r
+\r
+\r
+def ShowState( state ):\r
+ """return the given state int as a state string"""\r
+ #return "0x%02x" % state # comment this out to get textual state form\r
+ global State\r
+ if 0 <= state <= IRUPDATE:\r
+ return State[state]\r
+ else:\r
+ return "Unknown state 0x%02x" % state\r
+\r
+\r
+def ShowOpcode( op, f ):\r
+ """return the given byte as an opcode string"""\r
+ global Xsdrsize\r
+ if op == XCOMPLETE:\r
+ print("XCOMPLETE")\r
+\r
+ elif op == XTDOMASK:\r
+ buf = bytes2hexString( f, Xsdrsize )\r
+ print("XTDOMASK 0x%s" % buf)\r
+\r
+ elif op == XSIR:\r
+ len = ReadByte( f )\r
+ buf = bytes2hexString( f, len )\r
+ print("XSIR 0x%02X 0x%s" % (len, buf))\r
+\r
+ elif op == XSDR:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ print("XSDR 0x%s" % tdi)\r
+\r
+ elif op == XRUNTEST:\r
+ len = struct.unpack( '>i', f.read(4) )[0]\r
+ print("XRUNTEST 0x%08X" % len)\r
+\r
+ elif op == XREPEAT:\r
+ len = ReadByte( f )\r
+ print("XREPEAT 0x%02X" % len)\r
+\r
+ elif op == XSDRSIZE:\r
+ Xsdrsize = struct.unpack( '>i', f.read(4) )[0]\r
+ #print("XSDRSIZE 0x%08X" % Xsdrsize, file=sys.stderr )\r
+ print("XSDRSIZE 0x%08X %d" % (Xsdrsize, Xsdrsize) )\r
+\r
+ elif op == XSDRTDO:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ tdo = bytes2hexString( f, Xsdrsize )\r
+ print("XSDRTDO 0x%s 0x%s" % (tdi, tdo) )\r
+\r
+ elif op == XSETSDRMASKS:\r
+ addrmask = bytes2hexString( f, Xsdrsize )\r
+ datamask = ReadSDRMASKS( f, Xsdrsize )\r
+ print("XSETSDRMASKS 0x%s 0x%s" % (addrmask, datamask) )\r
+\r
+ elif op == XSDRINC:\r
+ startaddr = bytes2hexString( f, Xsdrsize )\r
+ len = ReadByte(f)\r
+ print("XSDRINC 0x%s 0x%02X" % (startaddr, len), end='' )\r
+ for numTimes in range(len):\r
+ data = bytes2hexString( f, SetsdrmasksOnesCount)\r
+ print(" 0x%s" % data )\r
+ print() # newline\r
+\r
+ elif op == XSDRB:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ print("XSDRB 0x%s" % tdi )\r
+\r
+ elif op == XSDRC:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ print("XSDRC 0x%s" % tdi )\r
+\r
+ elif op == XSDRE:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ print("XSDRE 0x%s" % tdi )\r
+\r
+ elif op == XSDRTDOB:\r
+ tdo = bytes2hexString( f, Xsdrsize )\r
+ print("XSDRTDOB 0x%s" % tdo )\r
+\r
+ elif op == XSDRTDOC:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ tdo = bytes2hexString( f, Xsdrsize )\r
+ print("XSDRTDOC 0x%s 0x%s" % (tdi, tdo) )\r
+\r
+ elif op == XSDRTDOE:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ tdo = bytes2hexString( f, Xsdrsize )\r
+ print("XSDRTDOE 0x%s 0x%s" % (tdi, tdo) )\r
+\r
+ elif op == XSTATE:\r
+ b = ReadByte(f)\r
+ print("XSTATE %s" % ShowState(b))\r
+\r
+ elif op == XENDIR:\r
+ b = ReadByte( f )\r
+ print("XENDIR %s" % ShowState(b))\r
+\r
+ elif op == XENDDR:\r
+ b = ReadByte( f )\r
+ print("XENDDR %s" % ShowState(b))\r
+\r
+ elif op == XSIR2:\r
+ len = struct.unpack( '>H', f.read(2) )[0]\r
+ buf = bytes2hexString( f, len )\r
+ print("XSIR2 0x%04X 0x%s" % (len, buf))\r
+\r
+ elif op == XCOMMENT:\r
+ cmt = []\r
+ while 1:\r
+ b = ReadByte(f)\r
+ if b == 0: # terminating nul\r
+ break;\r
+ cmt.append( chr(b) )\r
+ print("XCOMMENT \"%s\"" % ''.join(cmt) )\r
+\r
+ elif op == XWAIT:\r
+ run_state = ReadByte(f)\r
+ end_state = ReadByte(f)\r
+ useconds = struct.unpack( '>i', f.read(4) )[0]\r
+ print("XWAIT %s %s" % (ShowState(run_state), ShowState(end_state)), useconds)\r
+\r
+ elif op == XWAITSTATE:\r
+ run_state = ReadByte(f)\r
+ end_state = ReadByte(f)\r
+ clocks = struct.unpack( '>i', f.read(4) )[0]\r
+ useconds = struct.unpack( '>i', f.read(4) )[0]\r
+ print("XWAITSTATE %s %s CLOCKS=%d USECS=%d" % (ShowState(run_state), ShowState(end_state), clocks, useconds) )\r
+\r
+ elif op == LCOUNT:\r
+ loop_count = struct.unpack( '>i', f.read(4) )[0]\r
+ print("LCOUNT", loop_count )\r
+\r
+ elif op == LDELAY:\r
+ run_state = ReadByte(f)\r
+ clocks = struct.unpack( '>i', f.read(4) )[0]\r
+ useconds = struct.unpack( '>i', f.read(4) )[0]\r
+ print("LDELAY %s CLOCKS=%d USECS=%d" % (ShowState(run_state), clocks, useconds) )\r
+\r
+ elif op == LSDR:\r
+ tdi = bytes2hexString( f, Xsdrsize )\r
+ tdo = bytes2hexString( f, Xsdrsize )\r
+ print("LSDR 0x%s 0x%s" % (tdi, tdo) )\r
+\r
+ else:\r
+ print("UNKNOWN op 0x%02X %d" % (op, op))\r
+ exit(1)\r
+\r
+\r
+def main():\r
+\r
+ if len( sys.argv ) < 2:\r
+ print("usage %s <xsvf_filename>" % sys.argv[0])\r
+ exit(1)\r
+\r
+ f = open( sys.argv[1], 'rb' )\r
+\r
+ opcode = ReadByte( f )\r
+ while opcode != -1:\r
+ # print the position within the file, then the command\r
+ print( "%d: " % f.tell(), end='' )\r
+ ShowOpcode( opcode, f )\r
+ opcode = ReadByte(f)\r
+\r
+\r
+if __name__ == "__main__":\r
+ main()\r
+\r