Fix Clock: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
This page is on how to fix the real-time clock on a secure laptop.
This page is on how to fix a clock on a write protected machine. (These machines don't boot and give the message "The Clock is not set properly. Invalid system date. Stopping." then they power off.)


=Problem Description=
According to Mitch, there are two different issues with RTC date. (1) Prior to Q2D05, the firmware would turn on the screen, but wouldn't let you boot anything if the RTC date was less than Aug 2007. >= Q2D05 will still display the message saying that the date is wrong, but will process to boot actos. (2) == Q2D06 will not turn on the screen at all if the RTC month field is 0.


Laptops with this problem show two symptoms:
The problem can possibly be circumvented by presenting a "developer key" for this machine, on a USB storage stick, at power-on time. The developer key must match the individual machine (it's derived from the serial number and the UUID of the machine). You can find the serial number in the battery compartment, on a sticker; it looks like "CSN74701E2F". The UUID is trickier to get. Follow the instructions at '''[[Activation and Developer Keys#Getting a Developer Key if the Machine Won't Boot]]'''.
* The power LED turns on, but the screen never turns on (not even the backlight). The microphone LED may flash briefly, but stays off.
* The laptop screen lights up and shows "Invalid System Date" and then powers off. In this case, if you have a developer key, you can reflash with new firmware


According to Mitch Bradley, there are two different issues with RTC date:
If you can't get a developer key for this machine, fixing this requires opening up the laptop and exposing its circuit boards, having a second laptop (XO or otherwise), *plus* having a unique little hardware
board called a "serial to USB converter", and some skill in working with bare computer boards. The following instructions are for repair technicians, not for the public!


# Prior to Q2D05, the firmware would turn on the screen, but wouldn't let you boot anything if the RTC date was less than Aug 2007
# >= Q2D05 will still display the message saying that the date is wrong, but will proceed to boot actos.
# Q2D06 will not turn on the screen at all if the RTC month field is 0.

Early production machines had firmware version Q2D04, Q2D05, and Q2D06, which had a bug that caused the machine not to start if the Real Time Clock chip's date had been reset to 0. This could happen if that chip lost all power, including its backup power from an internal "coin cell" battery.

To make matters worse, some of the early units were manufactured with defective holders for that coin cell battery, so that the battery could became loose or even pop out entirely.

To diagnose the problem, remove the back cover from the laptop (exposing the motherboard). If the coin cell battery is loose (you can easily remove it with your fingers) or out of its holder and the system is an early production unit, this is probably the problem. To be completely sure, you must connect a serial terminal to J1 on the motherboard, via a special low-voltage interface adapter. If the system has this problem, you will see "Page Fault" on the serial console shortly after power up.

The problem can possibly be circumvented by presenting a [[Activation and Developer Keys#Getting a Developer Key if the Machine Won't Boot|"developer key"]] for this machine, on a USB storage stick, at power-on time.

If you can't get a developer key for this machine, fixing this requires opening up the laptop and exposing its circuit boards, having a second laptop (XO or otherwise), *plus* having a unique little hardware board called a "serial to USB converter", and some skill in working with bare computer boards. The following instructions are for repair technicians, not for the public!


==Accessing the Motherboard==
==Accessing the Motherboard==
Line 53: Line 67:
[[image:antenna1a.JPG|thumb|left|Take out 4 screws]] [[image:antenna1b.JPG|thumb|left|Turn over. Pull up and remove the back plate]]
[[image:antenna1a.JPG|thumb|left|Take out 4 screws]] [[image:antenna1b.JPG|thumb|left|Turn over. Pull up and remove the back plate]]
<br style="clear:both" />
<br style="clear:both" />

==Fix the loose battery==

First, you must re-seat the coin cell battery in its holder and secure it so it doesn't come out again. One way to secure it is to put a drop of glue where the battery contacts the holder, away from the metallic contact. The best glue that Mitch has found for this purpose is clear solvent-based household cement. Technically, it is "nitro cellulose" cement. It is also known as "model airplane glue", marketed under various trade names such as "Duco Cement" and "Tarzan's Grip". Loctite "Stik'n Seal" is a consumer adhesive; solvents are toluene and hexane (keep away from children!). It's extremely flammable, as well. Stock number is 01-23782, 1 oz. metal tube. (Alleskleber, in Germany, maybe?) Stronger adhesives like epoxy or cyanoacrylate (super glue) would probably work too, but it might be difficult to remove the battery later without damaging the holder. Don't even think of Gorilla Glue; that's polyurethane, which foams as it cures. RTV silicone would be good, except that the common variety releases acetic acid as it cures, which is corrosive.


==Hook the laptop up to another one through the serial port==
==Hook the laptop up to another one through the serial port==


# Using a [[Serial_adapters|low voltage serial to usb converter]], connect the laptop to your personal laptop
# Connect a serial port to the laptop
# Using a serial to usb converter, connect the laptop to your personal laptop
# Use a program like minicom to access the laptop serially
# Use a program like minicom to access the laptop serially
# The serial port settings should be 115200 baud, 8 data bits, no parity, and 1 stop bit
#* '''How to set up an XO for this'''

#*# Install any build 650 or later
=== How to set up an XO as a serial terminal ===
#*# Boot the laptop, and connect to the internet.
# Install any build 650 or later
#*# Go to the terminal and: yum install minicom
# Boot the laptop, and connect to the internet.
#*# After it is done, type: minicom -s (to set up minicom)
#*# Go to 'Serial port setup' and hit enter.
# Go to the terminal and: yum install minicom
# After it is done, type: minicom -s (to set up minicom)
#*# Press 'a' and change it to /dev/ttyUSB0, and then hit enter twice.
#*# Go to 'Modem and dialing' and hit enter.
# Go to 'Serial port setup' and hit enter.
# Press 'a' and change it to /dev/ttyUSB0, and then hit enter twice.
#*# Clear the contents of both 'Init string' and 'Reset string' (you get to those by hitting 'a' and 'b'
# Go to 'Modem and dialing' and hit enter.
#*# Hit enter to get back to the 'configuration' menu.
# Clear the contents of both 'Init string' and 'Reset string' (you get to those by hitting 'a' and 'b'
#*# Go to 'Save setup as..' and hit enter.
# Hit enter to get back to the 'configuration' menu.
#*# Name the setup as 'USB0' and hit enter.
#*# Go to 'Exit from Minicom' and hit enter.
# Go to 'Save setup as..' and hit enter.
# Name the setup as 'USB0' and hit enter.
#*# Now, all you have to do is type: minicom USB0 (this will open minicom to the settings you want)
# Go to 'Exit from Minicom' and hit enter.
# Now, all you have to do is type: minicom USB0 (this will open minicom to the settings you want)

==Upgrade the Firmware==

# Insert a USB key containing the [[Firmware|latest firwmare version]].
# Connect a serial terminal (115200,8,n,1) and power on the machine. You should see "Page Fault" on the serial terminal (if the laptop has Q2D05 or Q2D06), followed by an "ok" prompt.
# Type the following command line at the ok prompt, substituting the correct .rom filename:
ok probe-pci probe-usb flash u:\q2d14.rom

==Set the clock to the correct date==

''All these commands are typed on the laptop that is connected serially to the one with the bad clock''


==Fix the clock==
(all the commands here are done on the laptop that is connected serially to the one with the bad clock)
# power up the laptop (one with the bad clock), and hit ‘i’ a bunch (on the laptop connected serially) after seeing ‘Forth’ (easy to miss, just re-try)
# power up the laptop (one with the bad clock), and hit ‘i’ a bunch (on the laptop connected serially) after seeing ‘Forth’ (easy to miss, just re-try)
# Then, do the following commands at the ok prompt. (hitting enter after each one)
# Then, do the following commands at the ok prompt. (hitting enter after each one)

Revision as of 13:42, 3 June 2008

This page is on how to fix the real-time clock on a secure laptop.

Problem Description

Laptops with this problem show two symptoms:

  • The power LED turns on, but the screen never turns on (not even the backlight). The microphone LED may flash briefly, but stays off.
  • The laptop screen lights up and shows "Invalid System Date" and then powers off. In this case, if you have a developer key, you can reflash with new firmware

According to Mitch Bradley, there are two different issues with RTC date:

  1. Prior to Q2D05, the firmware would turn on the screen, but wouldn't let you boot anything if the RTC date was less than Aug 2007
  2. >= Q2D05 will still display the message saying that the date is wrong, but will proceed to boot actos.
  3. Q2D06 will not turn on the screen at all if the RTC month field is 0.

Early production machines had firmware version Q2D04, Q2D05, and Q2D06, which had a bug that caused the machine not to start if the Real Time Clock chip's date had been reset to 0. This could happen if that chip lost all power, including its backup power from an internal "coin cell" battery.

To make matters worse, some of the early units were manufactured with defective holders for that coin cell battery, so that the battery could became loose or even pop out entirely.

To diagnose the problem, remove the back cover from the laptop (exposing the motherboard). If the coin cell battery is loose (you can easily remove it with your fingers) or out of its holder and the system is an early production unit, this is probably the problem. To be completely sure, you must connect a serial terminal to J1 on the motherboard, via a special low-voltage interface adapter. If the system has this problem, you will see "Page Fault" on the serial console shortly after power up.

The problem can possibly be circumvented by presenting a "developer key" for this machine, on a USB storage stick, at power-on time.

If you can't get a developer key for this machine, fixing this requires opening up the laptop and exposing its circuit boards, having a second laptop (XO or otherwise), *plus* having a unique little hardware board called a "serial to USB converter", and some skill in working with bare computer boards. The following instructions are for repair technicians, not for the public!

Accessing the Motherboard

Step 1

Open the laptop and flip the screen up. Rotate it a 90 degree angle as shown in the sequence below. Next, remove the screws from the bottom of the screen - there are two on each side (right/left) of the XO, so make sure to get all four.

Flip screen up
Rotate
Unscrew - remember, there are 4.


Step 2

Remove the two green panels from the side of the XO. Slide them upwards and lift them off as shown.

Screen 2a.jpg
Slide up
Lift off


Step 3

Finally, pull off the front panel. It is tabbed, so it can simply be pulled out. Pull the bottom out (where the screws came out), and gently slide the piece downwards and out.

Screen 3a.jpg
Screen 3b.jpg


Step 4

To get the screen out, remove the four screws highlighted.

Unscrew


Step 5

Next, carefully slide the screen out, pulling the bottom out. Do not tug it or let go, as it will still be connected to the motherboard by two cables.

Slide out gently
Screen 4c.jpg
Watch out for cables!


Unhook the cable
Watch out for this little cable, too.
Good to go!


Step 6

Access the motherboard by removing the back plate. Keep the screen out of the way until the replacement is complete.

Take out 4 screws
Turn over. Pull up and remove the back plate


Fix the loose battery

First, you must re-seat the coin cell battery in its holder and secure it so it doesn't come out again. One way to secure it is to put a drop of glue where the battery contacts the holder, away from the metallic contact. The best glue that Mitch has found for this purpose is clear solvent-based household cement. Technically, it is "nitro cellulose" cement. It is also known as "model airplane glue", marketed under various trade names such as "Duco Cement" and "Tarzan's Grip". Loctite "Stik'n Seal" is a consumer adhesive; solvents are toluene and hexane (keep away from children!). It's extremely flammable, as well. Stock number is 01-23782, 1 oz. metal tube. (Alleskleber, in Germany, maybe?) Stronger adhesives like epoxy or cyanoacrylate (super glue) would probably work too, but it might be difficult to remove the battery later without damaging the holder. Don't even think of Gorilla Glue; that's polyurethane, which foams as it cures. RTV silicone would be good, except that the common variety releases acetic acid as it cures, which is corrosive.

Hook the laptop up to another one through the serial port

  1. Using a low voltage serial to usb converter, connect the laptop to your personal laptop
  2. Use a program like minicom to access the laptop serially
  3. The serial port settings should be 115200 baud, 8 data bits, no parity, and 1 stop bit

How to set up an XO as a serial terminal

  1. Install any build 650 or later
  2. Boot the laptop, and connect to the internet.
  3. Go to the terminal and: yum install minicom
  4. After it is done, type: minicom -s (to set up minicom)
  5. Go to 'Serial port setup' and hit enter.
  6. Press 'a' and change it to /dev/ttyUSB0, and then hit enter twice.
  7. Go to 'Modem and dialing' and hit enter.
  8. Clear the contents of both 'Init string' and 'Reset string' (you get to those by hitting 'a' and 'b'
  9. Hit enter to get back to the 'configuration' menu.
  10. Go to 'Save setup as..' and hit enter.
  11. Name the setup as 'USB0' and hit enter.
  12. Go to 'Exit from Minicom' and hit enter.
  13. Now, all you have to do is type: minicom USB0 (this will open minicom to the settings you want)

Upgrade the Firmware

  1. Insert a USB key containing the latest firwmare version.
  2. Connect a serial terminal (115200,8,n,1) and power on the machine. You should see "Page Fault" on the serial terminal (if the laptop has Q2D05 or Q2D06), followed by an "ok" prompt.
  3. Type the following command line at the ok prompt, substituting the correct .rom filename:
 ok probe-pci probe-usb  flash u:\q2d14.rom

Set the clock to the correct date

All these commands are typed on the laptop that is connected serially to the one with the bad clock

  1. power up the laptop (one with the bad clock), and hit ‘i’ a bunch (on the laptop connected serially) after seeing ‘Forth’ (easy to miss, just re-try)
  2. Then, do the following commands at the ok prompt. (hitting enter after each one)
    1. ok debug secure-startup (sets a break point at secure startup)
    2. ok resume (runs and breaks at secure start up)
    3. f (gives a forth 'ok' prompt)
    4. ok clock-node @ iselect
    5. ok decimal
    6. ok sec min hour day month year set-time (sec, min, hour, etc. should be numbers correlating to the current date) (e.g. 00 48 3 13 12 2007 set-time)
  3. power off (the laptop with the bad clock), and try booting.