Nokia IP530 - Remote Access Server User manual

Install Coreboot on a Nokia IP530 HOWTO
How can I install Coreboot on a Nokia IP530 system.
Marc Bertens <[email protected]
Version 1.0, June 2010

Install Coreboot on a Nokia IP530 HOWTO.
Index
1 DISCLAIMER 3
2 COPYRIGHT AND LICENSE 3
3 DISCLAIMER 3
4 INTRODUCTION 4
4.1 ASSUMPTIONS ............................................................................................................................................ 4
4.2 PROBLEMS ................................................................................................................................................. 4
5 PROCEDURE 5
5.1 THE FIRST STEP. ......................................................................................................................................... 5
5.2 BOOTING THE NOKIA IP530 WITH FREEBSD. ............................................................................................... 6
5.3 READING THE ORIGINAL FLASH-ROM. .......................................................................................................... 6
5.4 TESTING THE WRITING THE FLASH-ROM. ....................................................................................................... 6
5.5 UPDATE THE FLASH-ROM. ........................................................................................................................... 7
5.6 REBOOTING THE SYSTEM. ............................................................................................................................ 7
6 REFERENCES AND RESOURCES 8
7 TAIL 9
Page 2 of 9

Install Coreboot on a Nokia IP530 HOWTO.
1 Disclaimer
The following document is offered in good faith as comprising only safe programming
and procedures. No responsibility is accepted by the author for any loss or damage
caused in any way to any person or equipment, as a direct or indirect consequence of
following these instructions.
2 Copyright and License
Copyright (c) 2010 Marc Bertens.
Permission is granted to copy, distribute and/or modify this document under the terms of
the GNU Free Documentation License, Version 2 or any later version published by the
Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and with no
Back-Cover Texts.
3 Disclaimer
I AM NOT RESPONSIBLE FOR ANY DAMAGES INCURRED DUE TO
ACTIONS TAKEN BASED ON THIS DOCUMENT The final responsibility lays
with the user of the system, no the writer of this document. This document is distributed
in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more details.
This document is meant as an introduction/guide to how a Nokia IP530 can be flashed, i
did it with what's all in here. I am not, nor do I pretend to be, a Nokia IP530 (for its
original BIOS that is) expert. ;-) I am just some guy who has implemented coreboot on
the IP530 and likes computers more than most people.
Please, I am writing these to help people get acquainted with this subject, and I am not
ready to stake my life on the accuracy of what is in here.
Page 3 of 9

Install Coreboot on a Nokia IP530 HOWTO.
4 Introduction
The most recent version of this document can always be found at <
I'd also like to thank all the developers OF www.flashrom.org and www.coreboot.org.
Please note that this writer is dyslexic. And so forgive me any mistakes.
This HOWTO will go over the basics of how the flash rom of a Nokia IP530 can be
flashed. This HOWTO describes the procedure for replacing the original bios with the
open source BIOS Coreboot.
If you find differences in your packages, please email me and I'll update this HOWTO.
4.1 Assumptions
In this document are the following assumptions made;
1. You have knowledge of OS's like FreeBSD and Linux.
2. You have knowledge of software packages svn, gnu compilers, linkers, libraries
and other development tools.
3. The Coreboot image should at least contain SeaBios and optionally sgabios from
Google.com. This is VGA emulation bios that put the output to the serial port.
4.2 Problems
In the case that you get an error while running Flashrom you need to contact the
#flashrom on IRC and ask the questions there. You need the log of lspci -xxxvvv >
lspci.log [enter], superiotool > superior.log [enter], getpir [enter] this
creates a file pirq_routing.c. These files should be placed on to www.pastebin.com and
the resulting link should be pasted to the IRC room. Or you can send a email to flashrom
mailing list, see www.flashrom.org/Mailinglist. Include the files in your mail.
This is for all the following steps. Be aware that you do not switch of the IP530 while in
an error state. When you do so you render the system useless. And then you need and
flash rom adaptor to recover from this.
Page 4 of 9

Install Coreboot on a Nokia IP530 HOWTO.
5 Procedure
5.1 The first step.
When you have obtained the executable for Flashrom (www.flashrom.org) and a
Coreboot BIOS image (www.coreboot.org) with SeaBios (www.seabios.org) you can
directly start with this procedure. The original Nokia IP530 BIOS will only boot a
FreeBSD disk, on flash or real disk. When using a Flash I suggest use a 1Gb Compact
Flash card in an adaptor in a donor PC, otherwise use a normal HDD in the donor PC.
Setup with a FreeBSD live CD image on the disk.
Adjust the following;
•Set the kernel parameters so that the console output is routed to the first serial port
with speed 9600 NONE 1 stopbit.
•Set the serial port(2), speed 9600 NONE 1 stopbit in the configuration to accept a
terminal session.
•Optionally install ssh.
•Copy the Flashrom executable and the Coreboot rom image to the disk. For
example to the /bios directory.
•When running Linux compiled executables on a FreeBSD system you need the
following additional steps;
ocopy the following libraries from the Linux system to the FreeBSD
system. Place them in the appropriate directory.
libpci3.so
libftdi1.so
•Copy the following tools from the Linux system (only required when running into
problems, but that can not predicted). These files can be placed into the /usr/bin or /
bios directory.
olspci
osuperiotool (part of Coreboot)
ogetpir (part of Coreboot)
•Load the kernel module for running Linux images on the FreeBSD system
Page 5 of 9

Install Coreboot on a Nokia IP530 HOWTO.
5.2 Booting the Nokia IP530 ith FreeBSD.
Place the CF card or HDD (when installing a HDD removed the CF card (if still present)
from the IP530, you don't need it). Connect a NUL-Modem cable between the IP530 and
a other system where you can run a terminal program (or even a real serial terminal).
When the IP530 starts the original BIOS starts with speed 9600 Bps set the terminal
accordingly. Now turn on the power and the IP530 shows its startup screen on the
terminal console. And that it's booting FreeBSD OS.
5.3 Reading the original flash-rom.
Login to FreeBSD, switch to the /bios directory and execute the following command:
>flashrom -r original-bios.rom [enter]
Now the Flashrom program shows information about its self and shows that the current
flash chip is supported for read, write and verify, and that for EARSE is Flashrom
untested (this is not a problem, because the ERASE is done every programming action).
Then it continues with that's it reading the ROM. A file 'original-bios.rom' is created.
This is only done to have a fallback when something goes wrong with the flashing of the
image.
In case of an error see 4 2 Problems
5.4 Testing the riting the flash-rom.
To test if the flash utility works properly now enter the next command:
>flashrom -w original-bios.rom [enter]
Now the Flashrom program shows information about its self. When a message appears
that the flash could not be written. you have an incorrect version of Flashrom. In this case
no harm done the original BIOS is still in the flash chip.
When it continues with the message Erasing the flash. And continues with programming
the flash. When this steps succeeds you can go on to the update.
In case of an error see 4 2 Problems
Page 6 of 9

Install Coreboot on a Nokia IP530 HOWTO.
5.5 Update the flash-rom.
Now to flash the flash rom with the Coreboot image, use the following command:
>flashrom -w <imagefile> [enter]
Now the Flashrom program shows information about its self and continues with the
message Erasing the flash rom. And continues with programming the chip. Now the new
Coreboot BIOS is in the Nokia. As an extra step you can check it with the following
command
>flashrom -V <imagefile> [enter]
It should tell you that the verify has completed and the images matches.
In case of an error see 4 2 Problems
5.6 Rebooting the system.
Now you can reboot the system by
>reboot [enter]
Or;
>shutdown -h now [enter] and switching the power OFF and ON.
Now the system should just reboot and you should be able the login to FreeBSD again.
When it's booted you can setup a new Linux or other OS on a donor PC. Or when using
sgabios you should be able to use a CD-ROM on the secondary IDE controller with live
CD that supports basic text interface or even serial console. I use an image based on
http://ciffer.net/~svend/tech/livesc/ this is a Debian based image.
Page 7 of 9

Install Coreboot on a Nokia IP530 HOWTO.
6 References and Resources
The following URLs were incredibly useful in writing this HOWTO and generally
getting ACPI up and running.
www.coreboot.org Coreboot (formerly known as LinuxBIOS) is a Free Software
project aimed at replacing the proprietary BIOS (firmware) you
can find in most of today's computers. It performs just a little bit
of hardware initialization and then executes a so-called payload.
www.flashrom.org Flashrom is a utility for identifying, reading, writing, verifying
and erasing flash chips. Flashrom is designed to flash BIOS/EFI/
Coreboot/firmware/option ROM images on main boards,
network/graphics/storage controller cards, and various
programmer devices.
www.seabios.org SeaBIOS is an open source implementation of a 16bit X86 BIOS.
SeaBIOS can run in an emulator or it can run natively on X86
hardware with the use of Coreboot.
http://code.google.com/p/sgabios/
The Google Serial Graphics Adapter BIOS or SGABIOS
provides a means for legacy x86 software to communicate with
an attached serial console as if a video card were attached.
SGABIOS is designed to be inserted into a BIOS as an option
rom to provide over a serial port the display and input
capabilities normally handled by a VGA adapter and a keyboard,
and additionally provide hooks for logging displayed characters
for later collection after an operating system boots. It is designed
to handle all text mode output sent to the legacy video bios int
10h service routine. INT 10h is the most common method for
displaying characters in 16-bit legacy x86 code.
www.google.com All well to known.....
And all sites that i found that gave me every little bit of information to get Coreboot
working on the Nokia IP530.
Page 8 of 9

Install Coreboot on a Nokia IP530 HOWTO.
Tail
Much of the information for this document has been trawled from the various Linux
newsgroups, websites and IRC channels. I am sorry I did not keep a record of everyone
who has indirectly contributed by this route, thank you all very much.
So, to sum up:
Making a Nokia - IP530 work with any OS with Coreboot, SeaBios and sgabios, it’s a
neat trick but it can be done.
That’s all folks…….
Page 9 of 9