Difference between revisions of "Installation"

From SerialICE
Jump to: navigation, search
(Created page with "= Building SerialICE = $ cd SerialICE $ make menuconfig $ make You can now flash the 64KB serialice.rom onto your mainboard's ROM chip (you must pad or "multiply" it t...")
 
 
Line 1: Line 1:
 
= Building SerialICE =
 
= 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
 
   $ cd SerialICE
Line 5: Line 7:
 
   $ make
 
   $ make
  
You can now flash the 64KB serialice.rom onto your mainboard's ROM chip (you must pad or "multiply" it to your ROM chip's size before):
+
You can now flash the serialice.rom image. You can execute flashrom on the target machine like this:
 +
 
 +
  $ flashrom -p internal -w serialice.rom
  
  $ cat serialice.rom serialice.rom serialice.rom serialice.rom > serialice_256kb.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.  
  $ flashrom -w serialice_256kb.rom
 
  
Before you continue, please check with a terminal program of your choice (eg [http://alioth.debian.org/projects/minicom minicom], [http://code.google.com/p/picocom/ picocom]) that you are seeing a SerialICE shell prompt:
+
Next check with a terminal program of your choice (eg [http://alioth.debian.org/projects/minicom minicom], [http://code.google.com/p/picocom/ 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 2009)
+
   SerialICE v1.5 (Nov 20 2012)
 
   >  
 
   >  
 
   CTRL-A Z for help |115200 8N1 | NOR | Minicom 2.3    | VT102 |      Offline   
 
   CTRL-A Z for help |115200 8N1 | NOR | Minicom 2.3    | VT102 |      Offline   
Line 21: Line 24:
 
   $ sh build.sh
 
   $ sh build.sh
  
You are now ready to start using SerialICE. [[Getting Started]] provides an intro to using SerialICE, [[Debugging]] provides some information about using gdb with SerialICE targets, and [[Scripting]] describes the scripting abilities of SerialICE.
+
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.

Latest revision as of 11:58, 9 March 2013

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.