Keyboard freeze fix for os 650-656: Difference between revisions

From OLPC
Jump to navigation Jump to search
(No theme)
m (Reverted edits by 188.233.93.86 (Talk) to last revision by Quozl)
Line 1: Line 1:
As noted in '''<trac>10597</trac>''', [[XO]]s running builds os650, os653 and os656 will encounter a touchpad and keyboard freeze as of January 2011, unless their [[firmware]] was updated.
What a great web log. I spend hours on the net reading blogs, about tons of various subjects. I have to first of all give praise to whoever created your theme and second of all to you for writing what i can only describe as an fabulous article. I honestly believe there is a skill to writing articles that only very few posses and honestly you got it. The combining of demonstrative and upper-class content is by all odds super rare with the astronomic amount of blogs on the cyberspace.

Here we give a quick fix that will restore the keyboard and touchpad to normal. It updates the XO firmware to the oldest version that doesn't have the problem; [[OLPC_Firmware_q2d14|Q2D14]].

Also, it is strongly recommended to [[#Long-term fix: upgrade operating system|upgrade to the latest release of the OLPC OS]], which will fix other security and stability issues.

= Quick fix =
You will need:
* A [[USB drive]] (memory stick) of at least 16 MB capacity,
* A computer other than the XO, which is connected to the Internet,
* External power for the XO (a wall outlet and the XO AC adapter), and
* 10 minutes.

== 1. Prepare USB drive ==

Using the computer that is connected to the internet, prepare the USB drive using the instructions below. There is a subsection for each popular operating system. Choose one.

=== a. Microsoft Windows ===
* insert the USB drive,
* create a folder ''boot'' on the USB drive,
* download http://dev.laptop.org/pub/firmware/q2d14/bootfw.zip to the ''boot'' folder on the USB drive,
* eject the USB drive, and
* go to the [[#2. Upgrade Firmware|Upgrade Firmware]] section on this page.

=== b. Mac OS X ===

* 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 [http://dev.laptop.org/pub/firmware/q2d14/bootfw.zip this link], 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,
* eject the USB drive, and
* go to the [[#2. Upgrade Firmware|Upgrade Firmware]] section on this page.

=== c. Linux - GNOME and Firefox ===

* insert the USB drive,
* create a ''boot'' folder on the USB drive,
* click on [http://dev.laptop.org/pub/firmware/q2d14/bootfw.zip this link], 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 [[#2. Upgrade Firmware|Upgrade Firmware]] section on this page.

=== d. Linux - Terminal ===

cd /media/DRIVE
mkdir boot
cd boot
wget http://dev.laptop.org/pub/firmware/q2d14/bootfw.zip
umount /media/DRIVE

* go to the [[#2. Upgrade Firmware|Upgrade Firmware]] section just below

== 2. Upgrade Firmware ==
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, and
* turn on the XO.

Do not interfere at this point, but watch. The upgrade process will begin, with several messages displayed, then the XO will automatically restart. Wait for the XO to restart, then:

* turn off the XO,
* remove the power cord,
* remove the battery,
* '''wait a few seconds (with all power disconnected),'''
* remove the USB drive,
* insert the battery,
* plug the power cord back in, and
* start the XO.

You should test that the XO now works normally.

== 3. Troubleshooting ==

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

* try again with the X game key held down when you turn on the XO, (affects XOs with developer key installed or security disabled),
* check that the USB drive meets these conditions:
** it has a boot folder,
** there is a file ''bootfw.zip'' in the boot folder, and
** the partition type of the USB drive is "DOS MBR" rather than "GPT".
* 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 Q2D14,

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

Removing the battery and disconnecting the power allows the embedded controller to reset. We found this was necessary, but we don't yet understand why it is required.

= Long-term fix: upgrade operating system =

This is not part of the quick fix.

After applying the above fix, unless you have a good reason to be using os650-656 (for instance, compatibility with a group of other machines with the same build), a system upgrade is strongly recommended. The latest releases are faster and offer many security and stability fixes.

The [[Release notes/10.1.3|10.1.3 Release]] is solid, and was released in January 2011. You can upgrade to it now -- follow [[Release notes/10.1.3#XO-1|the installation instructions]], and be sure to reconnect the external power source and battery while installing so that a firmware upgrade will complete.

Backup any pictures, music, and other data-containing journal entries or files on your XO-1, onto network, USB or SD media, before upgrading. You will lose all data on the XO during the installation process of 10.1.x. Our update process which retains data is not available for the long jump from os650-656 to 10.1.x.

Revision as of 00:56, 1 June 2011

As noted in <trac>10597</trac>, XOs running builds os650, os653 and os656 will encounter a touchpad and keyboard freeze as of January 2011, unless their firmware was updated.

Here we give a quick fix that will restore the keyboard and touchpad to normal. It updates the XO firmware to the oldest version that doesn't have the problem; Q2D14.

Also, it is strongly recommended to upgrade to the latest release of the OLPC OS, which will fix other security and stability issues.

Quick fix

You will need:

  • A USB drive (memory stick) of at least 16 MB capacity,
  • A computer other than the XO, which is connected to the Internet,
  • External power for the XO (a wall outlet and the XO AC adapter), and
  • 10 minutes.

1. Prepare USB drive

Using the computer that is connected to the internet, prepare the USB drive using the instructions below. There is a subsection for each popular operating system. Choose one.

a. Microsoft Windows

b. Mac OS X

  • 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 this link, 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,
  • eject the USB drive, and
  • go to the Upgrade Firmware section on this page.

c. Linux - GNOME and Firefox

  • insert the USB drive,
  • create a boot folder on the USB drive,
  • click on this link, 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 Firmware section on this page.

d. Linux - Terminal

cd /media/DRIVE
mkdir boot
cd boot
wget http://dev.laptop.org/pub/firmware/q2d14/bootfw.zip
umount /media/DRIVE

2. Upgrade Firmware

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, and
  • turn on the XO.

Do not interfere at this point, but watch. The upgrade process will begin, with several messages displayed, then the XO will automatically restart. Wait for the XO to restart, then:

  • turn off the XO,
  • remove the power cord,
  • remove the battery,
  • wait a few seconds (with all power disconnected),
  • remove the USB drive,
  • insert the battery,
  • plug the power cord back in, and
  • start the XO.

You should test that the XO now works normally.

3. Troubleshooting

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

  • try again with the X game key held down when you turn on the XO, (affects XOs with developer key installed or security disabled),
  • check that the USB drive meets these conditions:
    • it has a boot folder,
    • there is a file bootfw.zip in the boot folder, and
    • the partition type of the USB drive is "DOS MBR" rather than "GPT".
  • 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 Q2D14,

4. 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.

Removing the battery and disconnecting the power allows the embedded controller to reset. We found this was necessary, but we don't yet understand why it is required.

Long-term fix: upgrade operating system

This is not part of the quick fix.

After applying the above fix, unless you have a good reason to be using os650-656 (for instance, compatibility with a group of other machines with the same build), a system upgrade is strongly recommended. The latest releases are faster and offer many security and stability fixes.

The 10.1.3 Release is solid, and was released in January 2011. You can upgrade to it now -- follow the installation instructions, and be sure to reconnect the external power source and battery while installing so that a firmware upgrade will complete.

Backup any pictures, music, and other data-containing journal entries or files on your XO-1, onto network, USB or SD media, before upgrading. You will lose all data on the XO during the installation process of 10.1.x. Our update process which retains data is not available for the long jump from os650-656 to 10.1.x.