https://github.com/logic/sh2dis

An SH2-compatible (Renesas SuperH) disassembler.
https://github.com/logic/sh2dis

disassembler python python2 python3 sh2 sh7052 sh7055 superh

Last synced: 2 months ago
JSON representation

An SH2-compatible (Renesas SuperH) disassembler.

• Host: GitHub
• URL: https://github.com/logic/sh2dis
• Owner: logic
• Created: 2011-04-07T00:23:37.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-04-11T18:51:11.000Z (9 months ago)
• Last Synced: 2024-10-23T02:55:28.181Z (2 months ago)
• Topics: disassembler, python, python2, python3, sh2, sh7052, sh7055, superh
• Language: Python
• Homepage: http://code.logic.net/sh2dis/
• Size: 222 KB
• Stars: 23
• Watchers: 7
• Forks: 4
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: COPYING3

Awesome Lists containing this project

README

        
sh2dis, an SH2-compatible (Renesas SuperH) disassembler.

Copyright (C) 2010-2017, Edward S. Marshall

This program is free software: you can redistribute it and/or modify it under

the terms of the GNU General Public License as published by the Free Software

Foundation, either version 3 of the License, or (at your option) any later

version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY

WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A

PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with

this program, in the file "COPYING3". If not, see http://www.gnu.org/licenses/

---

That's the licensing stuff out of the way.

sh2dis is a very rudimentary automated disassembly tool for SH2 processors

written in Python. The internal representation and produced output are inspired

somewhat by IDA Pro, a general-purpose multi-platform code analysis tool.

It can currently do relatively broad automated disassembly by tracking register

assignments loosely and following branches where it can reasonably discern a

destination. It doesn't catch everything yet, and likely never will; the end

goal is not a full-on SH2 simulator.

The example command line tool, `sh2dis`, is capable of distinguishing between

SH7052 and SH7055 ROM formats, and will perform an automated disassembly around

the vector interupt table, labelling any known vectors and registers.  This

example application may not work well with applications other than ROMs taken

from a Mitsubishi Lancer Evolution ECU, as that is the only platform I have

direct access to.

The easiest way to get started with sh2dis is to install it from PyPi. At

a command line, assuming you have a working Python environment already set

up, just run:

    pip install sh2dis

From there, running `sh2dis --help` should be a good place to start.

This software likely contains bugs. If you find one, please open an

[issue](https://github.com/logic/sh2dis/issues/new).

Thanks for looking!

-Ed