Skip to main content

Renesas (NEC) 78K0 disassembler

Project description

Overview

k0dasm is a disassembler for NEC 78K0 binaries that generates output compatible with the as78k0 assembler. It can be used to disassemble firmware for many 8-bit NEC 78K0 microcontrollers. Note that NEC has several microcontroller families with similar names, such as 78K0S, that use different instruction sets. These are not supported.

k0dasm was developed to disassemble the firmware of the Volkswagen Premium V car radios made by Delco. These radios use the undocumented NEC µPD78F0831Y microcontroller, which is similar to the µPD78F0833Y. A companion program, k0emu, is a 78K0 emulator developed for the same project.

Features

  • Identical Reassembly. The assembly language output of k0dasm will assemble to a bit-for-bit exact copy of the original binary using as78k0. This has been tested using several real firmware binaries.
  • Code / Data Separation. Starting from the vectors at the bottom of memory, k0dasm uses recursive traversal disassembly to separate code from data. This automates much of the disassembly process but indirect jumps (br ax) will still need to be resolved manually.
  • Symbol Generation. k0dasm tries not to write hardcoded addresses in the output when possible. It will automatically add symbols for hardware registers and vectors, other memory locations used, and will add labels for branches and subroutines.

Installation

k0dasm is written in Python and requires Python 3.4 or later. Packages are available on the Python Package Index (PyPI). You can download them from there or you can use pip to automatically install or upgrade k0dasm:

$ pip install -U k0dasm

Usage

k0dasm accepts a plain binary file as input:

$ k0dasm input.bin > output.asm

The file is assumed to be a ROM image that should be aligned to the bottom of memory. For example, if a 32K file is given, k0dasm will assume the image should be located at 0x0000-0x7FFF. After loading the image, the disassembler reads the vectors and starts tracing instructions from their targets.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for k0dasm, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size k0dasm-1.0.0-py2.py3-none-any.whl (27.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size k0dasm-1.0.0.tar.gz (27.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page