annotate micropython/hexlifyscript.py @ 4:010d229c6d6d default tip

It walks
author Radomir Dopieralski <sheep-devel@sheep.art.pl>
date Tue, 01 Dec 2015 11:47:18 +0100
parents cf1496aa9176
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
1 #!/usr/bin/env python3
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
2
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
3 '''
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
4 Turn a Python script into Intel HEX format to be concatenated at the
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
5 end of the MicroPython firmware.hex. A simple header is added to the
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
6 script.
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
7
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
8 To execute from command line: ./hexlifyscript.py <script.py>
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
9 '''
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
10
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
11 import sys
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
12 import struct
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
13 import binascii
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
14
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
15 SCRIPT_ADDR = 0x3e000 # magic start address in flash of script
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
16
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
17 def hexlify_script(script):
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
18 # add header, pad to multiple of 16 bytes
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
19 data = b'MP' + struct.pack('<H', len(script)) + script
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
20 data = data + bytes(16 - len(data) % 16)
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
21 assert len(data) <= 0x2000
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
22
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
23 # convert to .hex format
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
24 output = []
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
25 addr = SCRIPT_ADDR
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
26 assert(SCRIPT_ADDR >> 16 == 3) # 0x0003 is hard coded in line below
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
27 output.append(':020000040003F7') # extended linear address, 0x0003
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
28 for i in range(0, len(data), 16):
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
29 chunk = data[i:min(i + 16, len(data))]
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
30 chunk = struct.pack('>BHB', len(chunk), addr & 0xffff, 0) + chunk
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
31 checksum = (-(sum(chunk))) & 0xff
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
32 hexline = ':%s%02X' % (str(binascii.hexlify(chunk), 'utf8').upper(), checksum)
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
33 output.append(hexline)
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
34 addr += 16
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
35
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
36 return '\n'.join(output)
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
37
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
38 if __name__ == '__main__':
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
39 # read script from a file and print out the hexlified version
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
40 with open(sys.argv[1], 'rb') as f:
cf1496aa9176 Initial commit
Radomir Dopieralski <sheep-devel@sheep.art.pl>
parents:
diff changeset
41 print(hexlify_script(f.read()))