#!/usr/bin/env python
+"""
+This file realize a simple programmer, which communicates with our "pkernel"
+firmware.
+"""
import sys, time
-from SerialPort_linux import *
+from SerialPort_linux import SerialPort, SerialPortException
-# serial device to communicate with
-DEVICE="/dev/ttyUSB0"
# baudrate used for initialization
-INIT_BAUDRATE=9600
-# baudrate used for communication after init
-REAL_BAUDRATE=38400
+INIT_BAUDRATE = 9600
+# baudrate used for communication with the internal bootloader after init
+BOOTLOADER_BAUDRATE = 38400
+# baudrate used for communication with the pkernel program that does the
+# flashing eventually
+KERNEL_BAUDRATE = 115200
+# constant for output
+SPLIT = 30
# contains the last received checksum from a READ, WRITE or CHECKSUM command
-last_checksum = 0
-
-def sendByte(byte):
- time.sleep(0.001) # just to get sure, wait 1ms
- tty.write(chr(byte))
+lastchecksum = 0
-def sendWord(word):
- sendByte(word & 0xFF)
- sendByte((word >> 8) & 0xFF)
+class FlashSequence(object):
+ def __init__(self, address, data):
+ self.address = address
+ self.data = data
-def sendDWord(dword):
- sendByte(dword & 0xFF)
- sendByte((dword >> 8) & 0xFF)
- sendByte((dword >> 16) & 0xFF)
- sendByte((dword >> 24) & 0xFF)
+def sendbyte(byte):
+ """
+ send a byte to the TTY-device
+ """
+ tty.write(chr(byte))
-def recvByte():
+def sendword(word):
+ """
+ send a word to the TTY-device
+ """
+ sendbyte(word & 0xFF)
+ sendbyte((word >> 8) & 0xFF)
+
+def senddword(dword):
+ """
+ send a dword to the TTY-device
+ """
+ sendbyte(dword & 0xFF)
+ sendbyte((dword >> 8) & 0xFF)
+ sendbyte((dword >> 16) & 0xFF)
+ sendbyte((dword >> 24) & 0xFF)
+
+def recvbyte():
+ """
+ receive a byte from the TTY-device
+ """
return ord(tty.read())
-def recvChecksum():
- global last_checksum
- last_checksum = recvByte()
- last_checksum |= (recvByte() << 8)
-
-def cmdREAD(address, size):
+def recvchecksum():
+ """
+ receive checksum from the bootROM firmware
+ """
+ global lastchecksum
+ lastchecksum = recvbyte()
+ lastchecksum |= (recvbyte() << 8)
+
+def bootromread(address, size):
+ """
+ send a READ-command to the bootROM-firmware
+ """
# send READ command
- sendByte(0x01)
- if (recvByte() != 0xF1):
+ sendbyte(0x01)
+ if (recvbyte() != 0xF1):
raise Exception
- sendByte(0x02)
- if (recvByte() != 0x82):
+ sendbyte(0x02)
+ if (recvbyte() != 0x82):
raise Exception
# tell desired address and size
- sendDWord(address)
- sendWord(size)
+ senddword(address)
+ sendword(size)
# get binary stream of data
data = []
- for i in range(0, size):
- data.append(recvByte())
+ for _ in range(0, size):
+ data.append(recvbyte())
# get checksum
- recvChecksum()
+ recvchecksum()
return data
-def cmdWRITE(address, size, data):
+def bootromwrite(address, size, data):
+ """
+ send a WRITE-command to the bootROM-firmware
+ """
# send WRITE command
- sendByte(0x01)
- if (recvByte() != 0xF1):
+ sendbyte(0x01)
+ if (recvbyte() != 0xF1):
raise Exception
- sendByte(0x03)
- if (recvByte() != 0x83):
+ sendbyte(0x03)
+ if (recvbyte() != 0x83):
raise Exception
# tell desired address and size
- sendDWord(address)
- sendWord(size)
+ senddword(address)
+ sendword(size)
# write binary stream of data
for i in range(0, size):
- sendByte(data[i])
+ sendbyte(data[i])
# get checksum
- recvChecksum()
+ recvchecksum()
-# TODO: test this function!
-def cmdCALL(address):
+def bootromcall(address):
+ """
+ send a CALL-command to the bootROM-firmware
+ """
# send CALL command
- sendByte(0x01)
- if (recvByte() != 0xF1):
+ sendbyte(0x01)
+ if (recvbyte() != 0xF1):
raise Exception
- sendByte(0x04)
- if (recvByte() != 0x84):
+ sendbyte(0x04)
+ if (recvbyte() != 0x84):
raise Exception
# tell desired address
- sendDWord(address)
+ senddword(address)
# wait for return parameter - not needed here!
- #return recvByte()
+ #return recvbyte()
# TODO: test this function!
-def cmdCHECKSUM():
+def bootromchecksum():
+ """
+ send a CHECKSUM-command to the bootROM-firmware
+ """
# call CHECKSUM command
- sendByte(0x01)
- if (recvByte() != 0xF1):
+ sendbyte(0x01)
+ if (recvbyte() != 0xF1):
raise Exception
- sendByte(0x05)
- if (recvByte() != 0x84):
+ sendbyte(0x05)
+ if (recvbyte() != 0x84):
raise Exception
# get checksum
- recvChecksum()
+ recvchecksum()
-def cmdBAUDRATE(baudrate):
+def bootrombaudrate(baudrate):
+ """
+ send a BAUDRAME-command to the bootROM-firmware
+ """
# send BAUDRATE command
- sendByte(0x01)
- if (recvByte() != 0xF1):
+ sendbyte(0x01)
+ if (recvbyte() != 0xF1):
raise Exception
- sendByte(0x06)
- if (recvByte() != 0x86):
+ sendbyte(0x06)
+ if (recvbyte() != 0x86):
raise Exception
# send desired baudrate
- sendDWord(baudrate)
+ senddword(baudrate)
+
+def pkernchiperase():
+ """
+ send a CHIPERASE-command to the pkernel-firmware
+ """
+ sendbyte(0x15)
+ if (recvbyte() != 0x45):
+ raise Exception
+ # wait till completion...
+ if (recvbyte() != 0x23):
+ raise Exception
+def pkernerase(address, size):
+ """
+ send a ERASE-command to the pkernel-firmware
+ """
+ sendbyte(0x12)
+ if (recvbyte() != 0x11):
+ raise Exception
+ senddword(address)
+ sendword(size)
+ if (recvbyte() != 0x18):
+ raise Exception
-class FlashSequence(object):
- def __init__(self, address, data):
- self.address = address
- self.data = data
+def pkernwrite(address, size, data):
+ """
+ send a WRITE-command to the pkernel-firmware
+ """
+ # send WRITE command
+ sendbyte(0x13)
+ if (recvbyte() != 0x37):
+ raise Exception
+ # tell desired address and size
+ senddword(address)
+ sendword(size)
+
+ # write binary stream of data
+ for i in range(0, size):
+ sendbyte(data[i])
-def readMHXFile(filename): # desired mhx filename
- fp = open(filename, "r")
+ if (recvbyte() != 0x28):
+ raise Exception
+
+def readmhxfile(filename): # desired mhx filename
+ """
+ proceeds a MHX-File
+ """
+ filep = open(filename, "r")
retval = [] # returns a list of FlashSequence objects
linecount = 0
- for line in fp:
+ for line in filep:
linecount += 1
# get rid of newline characters
line = line.strip()
- # we're only interested in S2 (data sequence with 3 address bytes) records by now
+ # we're only interested in S2 (data sequence with 3 address bytes)
+ # records by now
if line[0:2] == "S2":
byte_count = int(line[2:4], 16)
# just to get sure, check if byte count field is valid
# add flash sequence to our list
retval.append(FlashSequence(address, data))
- fp.close()
+ filep.close()
return retval
-
-# check command line arguments
-if len(sys.argv) != 2:
- print "Usage: " + sys.argv[0] + " [mhx-file]"
- sys.exit(1)
-
-# read in data from mhx-file before starting
-try:
- flashseqs = readMHXFile(sys.argv[1])
-except IOError as error:
- print sys.argv[0] + ": Error - couldn't open file " + error.filename + "!"
- sys.exit(1)
-
-print "The following flash sequences have been read in:"
-for seq in flashseqs:
- print hex(seq.address) + ":", seq.data
-
-print "Initializing serial port..."
-tty = SerialPort(DEVICE, 100, INIT_BAUDRATE)
-
-print "Please press RESET on your 1337 board..."
-
-while 1:
- tty.write('V')
- tty.flush()
- try:
- if tty.read() == 'F':
- break
- except SerialPortException:
- # timeout happened, who cares ;-)
- pass
-
-print "OK, trying to set baudrate..."
-# set baudrate
-cmdBAUDRATE(REAL_BAUDRATE)
-tty = SerialPort(DEVICE, 100, REAL_BAUDRATE)
-
-# let the fun begin!
-for seq in flashseqs:
- if(seq.address <= 0x40000):
- addr = seq.address
- else:
- continue
- print "RAMing", len(seq.data), "bytes at address", hex(addr)
- cmdWRITE(addr, len(seq.data), seq.data)
- tty.flush()
-
-cmdCALL(0x30000);
-sys.exit(0)
-
-
-# some tests here.......
-"""
-# execute (existing) program in ram
-cmdCALL(0x00033ffc)
-sys.exit(0)
-"""
-
-# read something from the IRAM
-#print cmdREAD(0x00030000, 32)
-
-#data = []
-#for i in range(0, 32):
-# data.append(i)
-#cmdWRITE(0x00030000, 32, data)
-
-
-"""
-# write something to the begin of the IRAM
-data_wr = []
-checksum = 0
-for i in range(0, 0x400):
- value = i%256
- data_wr.append(value)
- checksum = (checksum + value) % (2**16)
-
-print "Calculated checksum:", checksum
-print "Writing", data_wr, "to the IRAM..."
-cmdWRITE(0x00030000, len(data_wr), data_wr)
-print "Received Checksum:", last_checksum
-print
-
-print "Reading from the IRAM again..."
-data_re = cmdREAD(0x00030000, len(data_wr))
-print "Received data:", data_re, "Checksum:", last_checksum
-"""
-
-"""
-# see whats in the iram at the moment
-data_wr = []
-print "Reading from the IRAM..."
-data_re = cmdREAD(0x00030000, 0x10000-4)
-print "Received data:", data_re, "Checksum:", last_checksum
-"""
-
-"""
-# see whats in the dram at the moment
-data_wr = []
-print "Reading from the DRAM..."
-data_re = cmdREAD(0x0002C000, 0x10000-0xC000-4)
-print "Received data:", data_re, "Checksum:", last_checksum
-"""
-
-"""
-# blank the iram
-data_wr = []
-for i in range(0, 0x10000-4):
- value = 0
- data_wr.append(value)
-
-print "Writing", data_wr, "to the IRAM..."
-cmdWRITE(0x00030000, len(data_wr), data_wr)
-print "Received Checksum:", last_checksum
-print
-"""
-
-"""
-# blank the dram
-data_wr = []
-for i in range(0, 0x10000-0xC000-4):
- value = 0
- data_wr.append(value)
-
-print "Writing", data_wr, "to the DRAM..."
-cmdWRITE(0x0002C000, len(data_wr), data_wr)
-print "Received Checksum:", last_checksum
-print
-"""
-
-"""
-# write some data in the iram and try to execute it
-data_wr =[
- 0x9B,0x00,
- 0x0D,0x4e,
- 0xcf,0xf1,
- 0x16,0x01,
- 0x9b,0x05,
- 0x04,0xc7,
- 0xc1,0x06,
- 0x16,0x56,
- 0xe0,0xfb, #branch
- 0x9f,0xa0,0x9f,0xa0,0x9f,0xa0, #nop
- 0x9f,0xa0,0x9f,0xa0,0x9f,0xa0,
- 0x9f,0xa0,0x9f,0xa0,0x9f,0xa0,
- 0x9f,0xa0,0x9f,0xa0,0x9f,0xa0,
- 0x9f,0xa0,0x9f,0xa0,0x9f,0xa0,
- 0x9f,0xa0,0x9f,0xa0,0x9f,0xa0,
- 0x9f,0xa0,0x9f,0xa0,0x9f,0xa0]
-print "Writing", data_wr, "to the IRAM..."
-cmdWRITE(0x00030000, len(data_wr), data_wr)
-print "Received Checksum:", last_checksum
-print
-cmdCALL(0x00030000)
-"""
+def usage(execf):
+ """
+ print usage of frprog
+ """
+ print "Usage: " + execf + " <target mhx-file> [-d DEVICE]"
+
+def main(argv=None):
+ """
+ main function of frprog
+ """
+ # check command line arguments
+ if argv is None:
+ argv = sys.argv
+
+ if len(argv) == 2 and (argv[1] == "-v" or argv[1] == "--version"):
+ print "Version: %VERSION%"
+ return 0
+
+ if len(argv) != 2 and len(argv) != 4:
+ usage(argv[0])
+ return 1
+
+ # standard serial device to communicate with
+ device = "/dev/ttyUSB0"
+
+ # overrule standard device if provided with -d
+ if len(argv) == 4:
+ if argv[2] == "-d":
+ device = argv[3]
+ else:
+ usage(argv[0])
+ return 1
+
+ # read in data from mhx-files before starting
+ try:
+ try:
+ bootloaderseqs = readmhxfile("pkernel/pkernel.mhx")
+ except IOError as _:
+ bootloaderseqs = readmhxfile("%PREFIX%/share/frprog/pkernel.mhx")
+ pkernelseqs = readmhxfile(argv[1])
+ except IOError as error:
+ print argv[0] + ": Error - couldn't open file " + error.filename + "!"
+ return 1
+
+ print "Initializing serial port..."
+ global tty
+ tty = SerialPort(device, 100, INIT_BAUDRATE)
+
+ print "Please press RESET on your board..."
+
+ while True:
+ tty.write('V')
+ tty.flush()
+ try:
+ if tty.read() == 'F':
+ break
+ except SerialPortException:
+ # timeout happened, who cares ;-)
+ pass
+
+ # save time at this point for evaluating the duration at the end
+ starttime = time.time()
+
+ print "OK, trying to set baudrate..."
+ # set baudrate
+ try:
+ bootrombaudrate(BOOTLOADER_BAUDRATE)
+ except SerialPortException:
+ print "timeout exception: try again ->"
+ bootrombaudrate(BOOTLOADER_BAUDRATE)
+ # just to get sure that the bootloader is really running in new baudrate mode!
+ time.sleep(0.1)
+ del tty
+ tty = SerialPort(device, 100, BOOTLOADER_BAUDRATE)
+
+ sdots = SPLIT
+ print "Transfering pkernel program to IRAM",
+ # let the fun begin!
+ for seq in bootloaderseqs:
+ if(seq.address <= 0x40000):
+ addr = seq.address
+ else:
+ continue
+ #print "RAMing", len(seq.data), "bytes at address", hex(addr)
+ bootromwrite(addr, len(seq.data), seq.data)
+ tty.flush()
+
+ sdots = sdots - 1
+ if sdots == 0:
+ sys.stdout.write(".")
+ sys.stdout.flush()
+ sdots = SPLIT
+ print
+
+ # execute our pkernel finally and set pkernel conform baudrate
+ bootromcall(0x30000)
+ time.sleep(0.1) # just to get sure that the pkernel is really running!
+ del tty
+ tty = SerialPort(device, None, KERNEL_BAUDRATE)
+
+ print "Performing ChipErase..."
+ pkernchiperase()
+
+ sdots = SPLIT
+ print "Flashing",
+ for seq in pkernelseqs:
+ # skip seqs only consisting of 0xffs
+ seqset = list(set(seq.data))
+ if len(seqset) == 1 and seqset[0] == 0xff:
+ continue
+ #print "Flashing", len(seq.data), "bytes at address", hex(seq.address)
+ pkernwrite(seq.address, len(seq.data), seq.data)
+ tty.flush()
+
+ sdots = sdots - 1
+ if sdots == 0:
+ sys.stdout.write(".")
+ sys.stdout.flush()
+ sdots = SPLIT
+ print
+
+ duration = time.time() - starttime
+ print "Procedure complete, took", round(duration, 2), "seconds."
+
+ sendbyte(0x97) # exit and restart
+ print "Program was started. Have fun!"
+
+
+if __name__ == '__main__':
+ sys.exit(main())