dfu-convert.py 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141
  1. #!/usr/bin/env python2
  2. # Written by Antonio Galea - 2010/11/18
  3. # Distributed under Gnu LGPL 3.0
  4. # see http://www.gnu.org/licenses/lgpl-3.0.txt
  5. import sys,struct,zlib,os
  6. from optparse import OptionParser
  7. from intelhex import IntelHex
  8. DEFAULT_DEVICE="0x0483:0xdf11"
  9. def named(tuple,names):
  10. return dict(zip(names.split(),tuple))
  11. def consume(fmt,data,names):
  12. n = struct.calcsize(fmt)
  13. return named(struct.unpack(fmt,data[:n]),names),data[n:]
  14. def cstring(string):
  15. return string.split('\0',1)[0]
  16. def compute_crc(data):
  17. return 0xFFFFFFFF & -zlib.crc32(data) -1
  18. def parse(file,dump_images=False):
  19. print 'File: "%s"' % file
  20. data = open(file,'rb').read()
  21. crc = compute_crc(data[:-4])
  22. prefix, data = consume('<5sBIB',data,'signature version size targets')
  23. print '%(signature)s v%(version)d, image size: %(size)d, targets: %(targets)d' % prefix
  24. for t in range(prefix['targets']):
  25. tprefix, data = consume('<6sBI255s2I',data,'signature altsetting named name size elements')
  26. tprefix['num'] = t
  27. if tprefix['named']:
  28. tprefix['name'] = cstring(tprefix['name'])
  29. else:
  30. tprefix['name'] = ''
  31. print '%(signature)s %(num)d, alt setting: %(altsetting)s, name: "%(name)s", size: %(size)d, elements: %(elements)d' % tprefix
  32. tsize = tprefix['size']
  33. target, data = data[:tsize], data[tsize:]
  34. for e in range(tprefix['elements']):
  35. eprefix, target = consume('<2I',target,'address size')
  36. eprefix['num'] = e
  37. print ' %(num)d, address: 0x%(address)08x, size: %(size)d' % eprefix
  38. esize = eprefix['size']
  39. image, target = target[:esize], target[esize:]
  40. if dump_images:
  41. out = '%s.target%d.image%d.bin' % (file,t,e)
  42. open(out,'wb').write(image)
  43. print ' DUMPED IMAGE TO "%s"' % out
  44. if len(target):
  45. print "target %d: PARSE ERROR" % t
  46. suffix = named(struct.unpack('<4H3sBI',data[:16]),'device product vendor dfu ufd len crc')
  47. print 'usb: %(vendor)04x:%(product)04x, device: 0x%(device)04x, dfu: 0x%(dfu)04x, %(ufd)s, %(len)d, 0x%(crc)08x' % suffix
  48. if crc != suffix['crc']:
  49. print "CRC ERROR: computed crc32 is 0x%08x" % crc
  50. data = data[16:]
  51. if data:
  52. print "PARSE ERROR"
  53. def build(file,targets,device=DEFAULT_DEVICE):
  54. data = ''
  55. for t,target in enumerate(targets):
  56. tdata = ''
  57. for image in target:
  58. tdata += struct.pack('<2I',image['address'],len(image['data']))+image['data']
  59. tdata = struct.pack('<6sBI255s2I','Target',0,1,'ST...',len(tdata),len(target)) + tdata
  60. data += tdata
  61. data = struct.pack('<5sBIB','DfuSe',1,len(data)+11,len(targets)) + data
  62. v,d=map(lambda x: int(x,0) & 0xFFFF, device.split(':',1))
  63. data += struct.pack('<4H3sB',0,d,v,0x011a,'UFD',16)
  64. crc = compute_crc(data)
  65. data += struct.pack('<I',crc)
  66. open(file,'wb').write(data)
  67. if __name__=="__main__":
  68. usage = """
  69. %prog [-d|--dump] infile.dfu
  70. %prog {-b|--build} address:file.bin [-b address:file.bin ...] [{-D|--device}=vendor:device] outfile.dfu
  71. %prog {-i|--ihex} file.hex [-i file.hex ...] [{-D|--device}=vendor:device] outfile.dfu"""
  72. parser = OptionParser(usage=usage)
  73. parser.add_option("-b", "--build", action="append", dest="binfiles",
  74. help="build a DFU file from given BINFILES", metavar="BINFILES")
  75. parser.add_option("-i", "--ihex", action="append", dest="hexfiles",
  76. help="build a DFU file from given HEXFILES", metavar="HEXFILES")
  77. parser.add_option("-D", "--device", action="store", dest="device",
  78. help="build for DEVICE, defaults to %s" % DEFAULT_DEVICE, metavar="DEVICE")
  79. parser.add_option("-d", "--dump", action="store_true", dest="dump_images",
  80. default=False, help="dump contained images to current directory")
  81. (options, args) = parser.parse_args()
  82. if (options.binfiles or options.hexfiles) and len(args)==1:
  83. target = []
  84. if options.binfiles:
  85. for arg in options.binfiles:
  86. try:
  87. address,binfile = arg.split(':',1)
  88. except ValueError:
  89. print "Address:file couple '%s' invalid." % arg
  90. sys.exit(1)
  91. try:
  92. address = int(address,0) & 0xFFFFFFFF
  93. except ValueError:
  94. print "Address %s invalid." % address
  95. sys.exit(1)
  96. if not os.path.isfile(binfile):
  97. print "Unreadable file '%s'." % binfile
  98. sys.exit(1)
  99. target.append({ 'address': address, 'data': open(binfile,'rb').read() })
  100. if options.hexfiles:
  101. for hex in options.hexfiles:
  102. ih = IntelHex(hex)
  103. address = ih.minaddr()
  104. data = ih.tobinstr()
  105. try:
  106. address = address & 0xFFFFFFFF
  107. except ValueError:
  108. print "Address %s invalid." % address
  109. sys.exit(1)
  110. target.append({ 'address': address, 'data': data })
  111. outfile = args[0]
  112. device = DEFAULT_DEVICE
  113. if options.device:
  114. device=options.device
  115. try:
  116. v,d=map(lambda x: int(x,0) & 0xFFFF, device.split(':',1))
  117. except:
  118. print "Invalid device '%s'." % device
  119. sys.exit(1)
  120. build(outfile,[target],device)
  121. elif len(args)==1:
  122. infile = args[0]
  123. if not os.path.isfile(infile):
  124. print "Unreadable file '%s'." % infile
  125. sys.exit(1)
  126. parse(infile, dump_images=options.dump_images)
  127. else:
  128. parser.print_help()
  129. sys.exit(1)