Installation

Building SerialICE

Take note of the size of the flash chip you will use for SerialICE and set that correctly while in menuconfig.

$ cd SerialICE
$ make menuconfig
$ make

You can now flash the serialice.rom image. You can execute flashrom on the target machine like this:

$ flashrom -p internal -w serialice.rom

You can also use external programmer devices. In either case, keep a copy of the original mainboard bios image, preferably use a different chip for SerialICE purposes. After programming the flash, do a cold reboot of the target machine.

Next check with a terminal program of your choice (eg minicom or picocom) that you are seeing a SerialICE shell prompt. If you do not get a prompt, see Make SerialICE work on new hardware.

SerialICE v1.5 (Nov 20 2012)
>
CTRL-A Z for help |115200 8N1 | NOR | Minicom 2.3    | VT102 |      Offline

Building QEMU

You need to build a patched QEMU from source, and you will need Lua newer than 5.2. To build Qemu you can run the build script that was added by the SerialICE patch:

$ sh build.sh

You are now ready to start using SerialICE. Getting Started provides an intro to using SerialICE, while Log file explains the output format. Advanced topics like Debugging have information about using gdb with SerialICE targets, and Scripting describes the basics of writing filters to match the hardware.