Skip to content
Embedded system (ARM versatile AB/PB) emulator written in Java.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


'ememu' is EMbedded system EMUlator written by Java.


  • Java 7 or later

Supported Systems

  • ARM Versatile AB/PB
    • CPU: ARM926EJ-S
      • Supported: ARM, Thumb
      • Not yet: EE, VFP, Jazelle
    • Devices: Timer, UART, NAND
    • Not yet: Ethernet, LCD, eMMC, and so on...
    • OS: Linux 4.1.x, Linux 3.18.x, Linux 3.14.x, Linux 3.12.x
      • 3.12.x: Need to enable CONFIG_EABI if you want to use recently cross-compiler.


You can run the ememu (applet version) on my WEB site.

How to use

Get the Cross-Compiler

Download the cross-compiler for ARM.

For example:

Cross-compile the Linux kernel

Set the default config of ARM Versatile.

$ export ARCH=arm
$ export CROSS_COMPILE=/path/to/cross-compiler/arm-2013.11/bin/arm-none-linux-gnueabi-
$ cd linux
$ make KBUILD_DEFCONFIG=versatile_defconfig defconfig

Change the configs as you need.

$ make menuconfig

And build.

$ make -j4

Linux kernel image file is created on the linux/arch/arm/boot/Image directory.

Cross-compile the Busybox

Set the build configs to build a static binary.

$ export ARCH=arm
$ export CROSS_COMPILE=/path/to/cross-compiler/arm-2013.11/bin/arm-none-linux-gnueabi-
$ cd busybox
$ make menuconfig
Busybox Settings  --->
  Build Options  --->
    [*] Build BusyBox as a static binary (no shared libs)

And build.

$ make -j4

Busybox executable file is created on the busybox/ directory.

Create the InitramFS Image

First, create directories as follows. NOTE: dev/console, dev/null, dev/ttyXX are the device files. To create device files, please see the manual of 'mknod' command.

|-- bin
|   |-- [ -> busybox
|   |-- ] -> busybox
|-- dev
|   |-- console
|   |-- null
|   |-- tty
|-- etc
|-- init
|-- lib
|-- proc
|-- run
|-- sbin
`-- sys

Next, convert and compress these directories to the InitramFS.

$ cd initramfs
$ find . | cpio --format=newc -o > ../initramfs.cpio
$ cat ../initramfs.cpio | gzip  > ../initramfs.gz

Build the Emulator

Build the emulator using Apache Ant.

$ cd ememu
$ ant

JAR file is created on ememu/emu/ant/dist directory.

Run the Emulator

Run the emulator (console version) on the Windows Command Prompt or some of Linux terminal as you like.

$ java -jar emu/ant/dist/armemu.jar linux/arch/arm/boot/Image initramfs.gz
Exception: Reset by 'Init.'.
loadFile: linux/arch/arm/boot/Image
loadFile: 'linux/arch/arm/boot/Image' done, 3912832bytes.
loadFile: initramfs.gz
loadFile: 'initramfs.gz' done, 1113270bytes.

Known BUGS

  • The emulator has crashed when execute the thumb instructions. For example, glibc of Linaro cross compiler includes thumb instructions.


Sorry, not yet...

You can’t perform that action at this time.