109 lines
3.6 KiB
Python
109 lines
3.6 KiB
Python
#!/usr/bin/python3
|
|
|
|
# Copyright (c) 2015 Andrew Fernandes <andrew@fernandes.org>
|
|
# All rights reserved.
|
|
#
|
|
# Redistribution and use in source and binary forms,
|
|
# with or without modification, are permitted provided
|
|
# that the following conditions are met:
|
|
#
|
|
# * Redistributions of source code must retain
|
|
# the above copyright notice, this list of conditions
|
|
# and the following disclaimer.
|
|
# * Redistributions in binary form must reproduce
|
|
# the above copyright notice, this list of conditions
|
|
# and the following disclaimer in the documentation
|
|
# and/or other materials provided with the distribution.
|
|
# * Neither the name of the author nor the names
|
|
# of its contributors may be used to endorse
|
|
# or promote products derived from this software
|
|
# without specific prior written permission.
|
|
#
|
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
|
|
# BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
# AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
# IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
|
|
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
|
|
# OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
|
|
# OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
"""Summarize the information in a hex file by printing the execution
|
|
start address (if any), and the address ranges covered by the
|
|
data (if any), in YAML format.
|
|
"""
|
|
|
|
VERSION = '2.2'
|
|
|
|
USAGE = '''hexinfo: summarize a hex file's contents.
|
|
Usage:
|
|
python hexinfo.py [options] FILE [ FILE ... ]
|
|
|
|
Options:
|
|
-h, --help this help message.
|
|
-v, --version version info.
|
|
'''
|
|
|
|
import sys
|
|
|
|
INDENT = ' '
|
|
INLIST = '- '
|
|
|
|
def summarize_yaml(fname):
|
|
print("{:s}file: '{:s}'".format(INLIST, fname))
|
|
from intelhex import IntelHex
|
|
ih = IntelHex(fname)
|
|
if ih.start_addr:
|
|
keys = sorted(ih.start_addr.keys())
|
|
if keys == ['CS','IP']:
|
|
entry = ih.start_addr['CS'] * 65536 + ih.start_addr['IP']
|
|
elif keys == ['EIP']:
|
|
entry = ih.start_addr['EIP']
|
|
else:
|
|
raise RuntimeError("unknown 'IntelHex.start_addr' found")
|
|
print("{:s}entry: 0x{:08X}".format(INDENT, entry))
|
|
segments = ih.segments()
|
|
if segments:
|
|
print("{:s}data:".format(INDENT))
|
|
for s in segments:
|
|
print("{:s}{:s}{{ first: 0x{:08X}, last: 0x{:08X}, length: 0x{:08X} }}".format(INDENT, INLIST, s[0], s[1]-1, s[1]-s[0]))
|
|
print("")
|
|
|
|
def main(argv=None):
|
|
import getopt
|
|
|
|
if argv is None:
|
|
argv = sys.argv[1:]
|
|
try:
|
|
opts, args = getopt.gnu_getopt(argv, 'hv', ['help', 'version'])
|
|
|
|
for o,a in opts:
|
|
if o in ('-h', '--help'):
|
|
print(USAGE)
|
|
return 0
|
|
elif o in ('-v', '--version'):
|
|
print(VERSION)
|
|
return 0
|
|
|
|
except getopt.GetoptError:
|
|
e = sys.exc_info()[1] # current exception
|
|
sys.stderr.write(str(e)+"\n")
|
|
sys.stderr.write(USAGE+"\n")
|
|
return 1
|
|
|
|
if len(args) < 1:
|
|
sys.stderr.write("ERROR: You should specify one or more files to summarize.\n")
|
|
sys.stderr.write(USAGE+"\n")
|
|
return 1
|
|
|
|
for fname in args:
|
|
summarize_yaml(fname)
|
|
|
|
if __name__ == '__main__':
|
|
sys.exit(main())
|