Installation

From SerialICE
Jump to navigation Jump to search

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, 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 >= 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.