Manual Firmware Install: Difference between revisions

From OLPC
Jump to navigation Jump to search
Line 5: Line 5:
===Unsecured Machines===
===Unsecured Machines===


(Please note that most developer machines are "unsecured". To unsecure your machine, follow the instructions at [[Activation and Developer Keys]].)
''This section is for unsecured laptops. Most XO-1.5 laptops are unsecured. Most developer XO laptops are unsecured. To unsecure your laptop, follow the instructions at [[Activation and Developer Keys]].''


First download the firmware from http://dev.laptop.org/pub/firmware/{{{version|VERSION_NUM}}}/{{{version|VERSION_NUM}}}.rom.
Download the firmware from http://dev.laptop.org/pub/firmware/{{{version|VERSION_NUM}}}/{{{version|VERSION_NUM}}}.rom and save it to a USB drive or SD card.


Alternatively, download directly to a laptop's internal drive; connect the network, start the [[Terminal Activity]] and type:
You can download on another computer with the above link.

If you are copying the firmware from a ''Windows'' machine,
*Make sure the [[USB drive]] is formatted for FAT and not FAT32 ([http://wiki.laptop.org/go/Talk:OLPC_Firmware_q2e45 Are you sure?]), and
*Don't use a \boot directory.

To download on the XO (into its NAND flash file system), start the [[Terminal Activity]] and as [[root]] type something like


su
cd /versions/boot/current/boot/
cd /versions/boot/current/boot/
wget http://dev.laptop.org/pub/firmware/{{{version|VERSION_NUM}}}/{{{version|VERSION_NUM}}}.rom
wget http://dev.laptop.org/pub/firmware/{{{version|VERSION_NUM}}}/{{{version|VERSION_NUM}}}.rom


Power cycle the laptop and press the[[File:Esc.png]] ''Escape'' key during the startup sound to get to the 'ok' prompt. If you don't get it, try until you do. See [[Ok]] for more detail.
If you want to use a USB drive or SD card to store the firmware before installing, replace the first line above with:


At the 'ok' prompt type one of the following commands:
cd /media/disk
mkdir boot
cd boot


; if the downloaded file is on a USB drive
Copy the {{{version|VERSION_NUM}}}.rom file you downloaded to the XO NAND FLASH filesystem as <tt>/versions/boot/current/boot/{{{version|VERSION_NUM}}}.rom</tt>, or to a USB drive as <tt>/boot/{{{version|VERSION_NUM}}}.rom</tt>.
ok flash u:\{{{version|VERSION_NUM}}}.rom


; if the downloaded file is on an external SD card:
Power cycle the system and press the press [[File:Esc.png]] ''Escape'' key during boot to get to the 'ok' prompt. If you don't get it, try until you do. See [[Ok]] for more detail.
ok flash sd:\boot\{{{version|VERSION_NUM}}}.rom


; if the file is on the NAND FLASH filesystem of an XO-1:
At the 'ok' prompt type one of the following commands

; if the file is on the NAND FLASH filesystem:
ok flash n:\boot\{{{version|VERSION_NUM}}}.rom
ok flash n:\boot\{{{version|VERSION_NUM}}}.rom


; if the file is on the NAND FLASH in the alternate boot filesystem:
; if the file is on the internal SD card of an XO-1.5:
ok flash n:\boot-alt\{{{version|VERSION_NUM}}}.rom
ok flash int:\boot\{{{version|VERSION_NUM}}}.rom

; if the file is on a USB drive:
ok flash u:\boot\{{{version|VERSION_NUM}}}.rom

; if the file is on a USB drive but not in the boot directory:
ok flash u:\{{{version|VERSION_NUM}}}.rom

; if the file is on an SD card:
ok flash sd:\boot\{{{version|VERSION_NUM}}}.rom


(Use the <tt>dir</tt> command if you need help finding the file.)
(Use the <tt>dir</tt> command if you need help finding the file.)

Revision as of 06:47, 13 January 2011

Note: Many firmware pages transclude this page to provide installation instructions, providing a version in place of VERSION_NUM; see e.g. OLPC Firmware q2e15.

Installation

When installing new firmware, you need a well-charged battery and the AC adapter must be plugged in. The firmware update code will not proceed otherwise.

Unsecured Machines

This section is for unsecured laptops. Most XO-1.5 laptops are unsecured. Most developer XO laptops are unsecured. To unsecure your laptop, follow the instructions at Activation and Developer Keys.

Download the firmware from http://dev.laptop.org/pub/firmware/VERSION_NUM/VERSION_NUM.rom and save it to a USB drive or SD card.

Alternatively, download directly to a laptop's internal drive; connect the network, start the Terminal Activity and type:

su
cd /versions/boot/current/boot/
wget http://dev.laptop.org/pub/firmware/VERSION_NUM/VERSION_NUM.rom

Power cycle the laptop and press theEsc.png Escape key during the startup sound to get to the 'ok' prompt. If you don't get it, try until you do. See Ok for more detail.

At the 'ok' prompt type one of the following commands:

if the downloaded file is on a USB drive
 ok flash u:\VERSION_NUM.rom
if the downloaded file is on an external SD card
 ok flash sd:\boot\VERSION_NUM.rom
if the file is on the NAND FLASH filesystem of an XO-1
 ok flash n:\boot\VERSION_NUM.rom 
if the file is on the internal SD card of an XO-1.5
 ok flash int:\boot\VERSION_NUM.rom 

(Use the dir command if you need help finding the file.)

This will only work if the XO has a well-charged battery AND is plugged in. "AC not present" means you need to plug it in.

Secured Machines

Pre-mass-production machines were almost all unsecured. Secure-mode machines can only use flash firmware that has been signed. All mass-production machines had the latest signed firmware at the time of manufacture installed.

Upgrading firmware describes how to upgrade to a newer official (signed) firmware release.

See also

  • Cheat codes for information about how game buttons control startup options.