Upgrading firmware: Difference between revisions

From OLPC
Jump to navigation Jump to search
(remove instructions for updating firmware using internal storage, as it is now far more complex given /versions changes and bootfw file naming change.)
(rework following feedback on talk page)
Line 1: Line 1:
{{OLPC}}{{users}}
{{OLPC}}{{users}}


This page describes how to upgrade only the [[firmware]] on a laptop. You should only need to do this if a problem in the firmware affects you.
How to upgrade only the [[firmware]] on an XO laptop.
__TOC__
__TOC__


== Automatic ==
{| width="100%"
To upgrade your firmware automatically, please [[Upgrading the XO|upgrade the operating system]].
|-
|width="48%" valign="top"|
== Upgrading to a new release ==
If you [[Upgrading the XO|upgrade to a new release]], your firmware will be updated automatically.


However some older firmware may need to be upgraded separately before the latest build can be installed.
However, some older firmware may need to be upgraded manually.
You should only need to do this if a problem in the firmware affects you.


== Manual - Unlocked Laptops ==
The latest stable release is:


We recommend the [[Firmware#Firmware_Releases|latest firmware version]], unless you have a special need for an older version.
{| border="1" cellspacing="0" cellpadding="2" width="100%" class="wikitable"
! version
! release date
|-
| {{Latest_Releases/stable}}
|}


== Manual - Locked Laptops ==
|width="4%"|  
|width="48%" valign="top"|


If your laptop is locked, and you cannot [[collection stick|unlock it]], you must use ''signed'' firmware, see below.
== Which Version? ==


=== Ingredients ===
We recommend the [[Firmware#Firmware_Releases|latest firmware version]], unless you have a specific need for an older version.


*a [[USB drive]] with at least 4 MB free space,
But if your laptop is secured, you must used a ''signed'' firmware version, and these are less common. The latest ''signed'' firmware versions from OLPC OS 13.2.0-13 are:
*an internet connection,
*a charged battery in the XO laptop,
*external power for the XO laptop,
*about ten minutes.

=== Recipe ===

* create a new folder named {{Code|boot}} on your USB drive,
* in the table below, select your XO laptop model and [[download]] the corresponding {{Code|bootfw.zip}} file; these are the latest signed firmware files from OLPC OS 13.2.0-13:
<!--
<!--
for the 13.2.0 official release these were obtained with a shell script
for the 13.2.0 official release these were obtained with a shell script
Line 34: Line 35:
which also generates the table rows
which also generates the table rows
-->
-->

{| border="1" cellspacing="0" cellpadding="2" width="100%" class="wikitable"
{| border="1" cellspacing="0" cellpadding="2" width="100%" class="wikitable"
! model
! model
! version
! version
! release
! build
! date
|-
|-
| XO-1
| XO-1
| [http://dev.laptop.org/pub/firmware/q2f19/bootfw.zip bootfw.zip]
| [http://dev.laptop.org/pub/firmware/q2f19/bootfw.zip q2f19 bootfw.zip]
| 13.2.0
| 13
| 2013-07-13
|-
|-
| XO-1.5
| XO-1.5
| [http://dev.laptop.org/pub/firmware/q3c16/bootfw.zip bootfw.zip]
| [http://dev.laptop.org/pub/firmware/q3c16/bootfw.zip q3c16 bootfw.zip]
| 13.2.0
| 13
| 2013-07-13
|-
|-
| XO-1.75
| XO-1.75
| [http://dev.laptop.org/pub/firmware/q4d34/bootfw.zip bootfw.zip]
| [http://dev.laptop.org/pub/firmware/q4d34/bootfw.zip q4d34 bootfw.zip]
| 13.2.0
| 13
| 2013-07-15
|-
|-
| XO-4
| XO-4
| [http://dev.laptop.org/pub/firmware/q7b37/bootfw.zip bootfw.zip]
| [http://dev.laptop.org/pub/firmware/q7b37/bootfw.zip q7b37 bootfw.zip]
| 13.2.0
| 13
| 2013-07-13
|}
|}
* save the file to your USB drive,
* safely remove the USB drive,
* shutdown and turn off your XO laptop,
* make sure the battery is in place and locked,
* make sure the power cord and adapter are plugged in, the battery indicator must be on,
* insert the USB drive into the XO laptop,
* hold down the {{Code|X}} game key while pressing and releasing the power button,
* wait for the message asking you to release the game keys, and then release the {{Code|X}} game key,
* wait for update messages to be displayed,
* wait for the XO laptop to reboot.


=== Troubleshooting ===
We will refer back to these download links.

|}

== Upgrading using a USB drive ==

This section shows how to upgrade the firmware on a secured laptop using a USB drive. If your laptop is not secured, we recommend you instead follow the instructions for the [[Firmware#Firmware_Releases|latest firmware version]].

=== Summary ===
You will need a [[USB drive]], an Internet connection, a battery and external power for your XO, and 10 minutes. Here is the quick overview:

# Download the <tt>bootfw.zip</tt> file for the [[Firmware#Firmware Releases|firmware version]] you want, and save it into a <tt>boot</tt> folder on your USB drive.
#: The file should be at <tt>/boot/bootfw.zip</tt>
# Make sure your XO is powered off, with battery in, and plugged into a wall outlet. The battery indicator should be on.
# Insert the USB drive into the XO, and hold down the '''X''' gamepad key while powering on the XO.
# Wait 1 minute. Update messages will display on the screen. The XO should automatically restart when finished, or indicate that it is done.

If you need more help, details for each step follow:

=== Details: Prepare USB drive ===

Using the computer that is connected to the internet, download the ''bootfw.zip'' file linked above, and put it in a ''boot'' folder of the USB drive. <br/>
The file path should be
/boot/bootfw.zip

Never done that before, or want to check your steps? See below for each popular operating system.

<small>
==== Using Microsoft Windows ====

[[Image:bootfw-on-xp.png|thumb|right|Windows]]

* insert the USB drive,
* create a folder on the USB drive called ''boot'',
* download the ''bootfw.zip'' file to the ''boot'' folder on the USB drive, (see screenshot for how it should look),
* eject the USB drive, and
* go to the [[#Upgrade|Upgrade]] section on this page.

==== Mac OS X - Safari ====

[[Image:bootfw-mac-os-x-finder.png|thumb|right|Mac OS]]

* insert the USB drive,
* switch tasks to ''Finder'', display the USB drive, notice the name of the USB drive,
* create a folder ''boot'' on the USB drive,
* control-click on the ''bootfw.zip'' download link above, select ''Download Linked File As ...'', and a ''Save As'' dialog will appear,
* change ''Where'' to the name of the USB drive (usually ''Untitled''), then click on the ''boot'' folder, then click on ''Save''. The dialog will go away,
* switch tasks to ''Finder'', display the USB drive, (see screenshot for how it should look),
* eject the USB drive, and
* go to the [[#Upgrade|Upgrade]] section on this page.

==== Linux - GNOME and Firefox ====

* insert the USB drive,
* create a ''boot'' folder on the USB drive,
* click on the ''bootfw.zip'' download link above, and a dialog window will appear asking you what you want done with the download,
* save the download to the USB drive in the ''boot'' folder,
* close the Downloads window,
* eject the USB drive, and
* go to the [[#Upgrade|Upgrade]] section just below.

</small>


=== Details: Upgrading ===
Once you have prepared the USB drive above, you must:

* make sure the XO battery is in place and locked,
* make sure the XO power cord and adapter are plugged in, the battery indicator must be on,
* insert the USB drive into the XO,
* hold down the '''X''' game key, and
* turn on the XO.

Watch for a couple minutes. The upgrade process will begin, with several messages displayed, then the XO will automatically restart, once or twice. Wait for the XO to finish restarting, then:

* remove the USB drive.

Test to confirm that the XO now works normally.

== Troubleshooting ==


If a USB drive seems to be ignored by the XO:
If a USB drive is ignored by the XO:


* check that the USB drive has a folder named {{Code|boot}},
* try again with the X game key held down when you turn on the XO, (only affects XOs with developer key installed or security disabled),
* check that the USB drive meets these conditions:
* check that the {{Code|boot}} folder has a file {{Code|bootfw.zip}},
* check that the USB drive has a partition table type of "DOS MBR" rather than "GPT",
** it has a boot folder,
* try a different USB drive,
** there is a file ''bootfw.zip'' in the boot folder (in other words, don't unzip the file yourself, the XO will do it), and
* try a different USB port,
** the partition type of the USB drive is "DOS MBR" rather than "GPT".
* check that the firmware actually needs upgrading; the USB drive will seem to be ignored if the version on the drive is equal to or earlier than the version on the laptop.
* if you are not sure about the partition type, and all else fails, try using a different USB drive, or
* check the firmware version; the USB drive will be ignored if the firmware version on the XO is equal to or later than what is on the USB drive.


== How it Works ==
== How it Works ==

Revision as of 05:32, 30 August 2013

  This page is monitored by the OLPC team.
  For the general public

How to upgrade only the firmware on an XO laptop.

Automatic

To upgrade your firmware automatically, please upgrade the operating system.

However, some older firmware may need to be upgraded manually. You should only need to do this if a problem in the firmware affects you.

Manual - Unlocked Laptops

We recommend the latest firmware version, unless you have a special need for an older version.

Manual - Locked Laptops

If your laptop is locked, and you cannot unlock it, you must use signed firmware, see below.

Ingredients

  • a USB drive with at least 4 MB free space,
  • an internet connection,
  • a charged battery in the XO laptop,
  • external power for the XO laptop,
  • about ten minutes.

Recipe

  • create a new folder named boot on your USB drive,
  • in the table below, select your XO laptop model and download the corresponding bootfw.zip file; these are the latest signed firmware files from OLPC OS 13.2.0-13:
model version
XO-1 q2f19 bootfw.zip
XO-1.5 q3c16 bootfw.zip
XO-1.75 q4d34 bootfw.zip
XO-4 q7b37 bootfw.zip
  • save the file to your USB drive,
  • safely remove the USB drive,
  • shutdown and turn off your XO laptop,
  • make sure the battery is in place and locked,
  • make sure the power cord and adapter are plugged in, the battery indicator must be on,
  • insert the USB drive into the XO laptop,
  • hold down the X game key while pressing and releasing the power button,
  • wait for the message asking you to release the game keys, and then release the X game key,
  • wait for update messages to be displayed,
  • wait for the XO laptop to reboot.

Troubleshooting

If a USB drive is ignored by the XO:

  • check that the USB drive has a folder named boot,
  • check that the boot folder has a file bootfw.zip,
  • check that the USB drive has a partition table type of "DOS MBR" rather than "GPT",
  • try a different USB drive,
  • try a different USB port,
  • check that the firmware actually needs upgrading; the USB drive will seem to be ignored if the version on the drive is equal to or earlier than the version on the laptop.

How it Works

The firmware on the XO runs when the power is turned on. It plays a startup sound. If the laptop is secured, or if the X game key is held down, it looks for boot/bootfw.zip on all available storage devices; internal storage, SD card, and USB drives. If a bootfw.zip is found, the firmware checks to see if the cryptographic signature of the file matches the OLPC keys, and if the version is later than itself. If both checks pass, the firmware checks for external power and a reasonably charged battery. If these are present, then the firmware updates itself from the file, writing to the internal SPI flash chip. Then it reboots, thus running the new firmware version.

Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=Upgrading_firmware&oldid=292244"