Obsolete:Upgrade VIP

Builds

• 406.14 was shipped from Quanta with B3 units and has a sound related bug -- tamtam sound doesn't work. You need to upgrade these to 406.15 minimum. This build should only be used for extending trials, where they have a bunch of B2 units that can't run newer builds very well. This build has no collaboration capability.

• 542 was shipped from Quanta on B4 and C machines. This build also has a problem with sound. It is required to upgrade to 542.3 (sound works), or 542.4 for non-US/English laptops (sound works for everything but tamtam, so this build removes tamtam from base). This build was used for demonstrating collaboration and can be used on newer B2 machines (B2-2); but it is slow and the camera is not great.

• 623 is going to be shipped on mass production units. This build shows good collaboration, journal, neighborhood view, etc. It is good for all laptops from B3 and later. Do not bother to upgrade B2 units to this release as it is way too slow; and the camera is unusable.

Follow the steps below to upgrade to the appropriate release.

Upgrade B4 units to Build 623

1. First ensure you have a power adapter plugged into the laptop.
2. Insert the 623 USB stick into the laptop while it is powered off; and power on holding the Square key.
3. If you are upgrading from a 600+ laptop, you don't have to do anything else. It will reboot itself in the middle.
4. If you are upgrading from a 406 laptop, you need to power on the second time while holding the Square key button.
5. While booting up look for the 'Openfirmware CL1 Q2D03' message. When it is finished booting, hit Alt+Ctl+Mesh keys together; check that the version number is 623.
6. If you need to add VIP data go to the next section.
7. If you are finished and ready to ship, type 'root', and 'shutdown -h now'
8. Note: Some upgrades will put 'backup'files on the USB stick and after 6 or 7 backups they will not be able to upgrade until you remove the 'Backup' directory from the USB.

To Add VIP info

1. Power up the laptop, choose nickname and color. Wait for the journal to completely load.
2. Insert the VIP USB stick
3. Hit Alt+Ctl+Mesh keys together.
4. Type 'root'
5. Type 'cd /media/VIP616/'
6. Type 'sh extras.sh'
7. When this finishes; type 'cd /home/olpc'
8. Use Alt+Ctl+home to go back to sugar, open the journal and unmount the USB from the icon there. When the USB successfully unmounts, then remove it.
9. Use sugar 'reboot' to go onto the test section.

Test:

1. Start 'Browse'.
2. Click on media, then media again on the left hand side. Click on the 'Sesame Street' link.
3. It will open up in the clipboard; when finished loading, click 'open'; and make sure it plays.
4. Close Watch&Listen.
5. Go back to the browser; click on books, and then books again.
6. Click on the Quaran; open it from the clipboard when it has finished loading.
7. Close the book.
8. Open the Turtle Art activity; close it.
9. In the mesh view, click on the triangle labeled "MediaLab 802.11".
10. Wait until the circle outline is blinking; then you should see other XOs.
11. From the browser, click on google search and search on 'cats' (or anything you want); make sure you get a good page.
12. Go to the Home view, hover over the XO; click on shutdown.

Upgrade B4 units to Build 542.3

1. Insert the 542.3 USB stick into the laptop while it is powered off.
2. Power on the laptop, holding down the gamepad X and Square key until it says 'release the key'.
3. Let it finish the upgrade.
4. Boot the laptop one more time with the USB stick still connected, this time with the X and Check key pressed.
5. When it is finished booting, hit Alt+Ctl+Mesh keys together; check that the version number is 542.1.
6. If you need to add VIP data go to the next section.
7. If you are finished and ready to ship, type 'root', and 'shutdown -h now'
8. When it finishes powering all the way off; remove the battery and power adapter and ship it.

To Add VIP info

1. Power up the laptop, choose nickname and color. Wait for the journal to completely load.
2. Insert the VIP USB stick
3. Hit Alt+Ctl+Mesh keys together.
4. Type 'root'
5. Type 'sh /media/VIP542_3/extras.sh
6. When this finishes; type 'cd /home/olpc'
7. type 'umount /media/VIP542_3/'.
8. if umount says device is busy; use Alt+Ctl+home to open the journal and unmount the USB from the icon there.
9. type 'reboot' to restart the laptop.
10. remove USB stick right when the power goes off before it starts to boot again.

Test:

1. Check that 'Turtle Art' and 'Watch & Listen' show up in the task bar.
2. Start 'Watch & Listen'.
3. Open File, browse in olpc/Library to find 'SeasameStreet' file.
4. Open it and make sure it plays.
5. Use esc, and activity tab to close it (try Alt+c if all else).
6. Open the Turtle Art activity; close it.
7. Open the Browse activity.
8. You should see the OLPC newsletter.
9. Click on the word 'extras'.
10. Click on map
11. Click on Browse and then use the back browser button to return.
12. Click on mesh demo.
13. Close the browser.
14. In the mesh view, click on the triangle labeled "MediaLab 802.11".
15. Wait until the triangle outline is blinking; then you should see other XOs.
16. Go to the Home view, hover over the XO; click on shutdown.

Upgrade to 406.15 Build

1. Boot up laptop with 406.15 stick installed.
2. At the OK prompt type 'flash u:\boot\q2c18.rom'
3. When finished; remove the adapter and the battery for a few seconds and then replace; and boot again while holding the 'X' game key. Hit escape when it is counting down 3 seconds.
4. Check that the OpenFirmware version is now Q2C18.
5. At the OK prompt type: 'copy-nand u:\boot\n40615.img'
6. You will get some messages about skipping bad blocks.
7. When finished remove the USB stick; shut off the laptop.
8. Power up the laptop one more time to make sure it boots into sugar.
9. Hit CTL-ALT-Mesh, to see that version 406.15 is the version.
10. Type 'shutdown -h now' to shut down.

Change Language

1. boot up laptop and ctl-alt-mesh
2. log in as root
3. nano /etc/sysconfig/i18n
4. change LANG to appropriate value, 'en_US.UTF-8' for english; 'es_AR.UTF-8' will give you spanish for Argentina.
5. ctl-x, and 'yes' to save
6. type 'cat /etc/sysconfig/i18n' to check.
7. shutdown or reboot (from sugar)

For Builds over 623

1. open the Terminal activity
2. nano /home/olpc/.i18n
3. change LANG to appropriate value, 'en_US.UTF-8' for english; 'es_AR.UTF-8' will give you spanish for Argentina.
4. ctl-x, and 'yes' to save
5. type 'cat /home/olpc/.i18n' to check.
6. reboot (from sugar)

See also Localization, XO_l10n and Olpc-utils

Change Laptop name/color

If you want to remove the name and color chosen, then, before you shutdown:

1. Alt+Ctl+Mesh
2. Login as root
3. cd /home/olpc/.sugar/default
4. rm config
5. rm owner.*
6. power off (to shut down)

If you want to change just the name:

1. Alt+Ctl+Mesh
2. Login as root
3. type 'nano /home/olpc/.sugar/default/config'
4. change the name in this file; then hit Ctl+X to exit and type 'yes' to save
5. to test this, use Ctl+Alt+Erase for a quick reboot
6. hover over the XO and see that it has the new name.
7. power off

Brightstar Upgrade

1. Ensure you have both a power adapter and a battery plugged into the laptop.
2. Insert the USB stick into the laptop while it is powered off.
3. Press the Power button and then immediately hold all four game key buttons.
4. When it says 'release the game keys', release all buttons.
5. The laptop will give an indication of block by block writing to the NAND and should take a few minutes to complete.
6. It will reboot when it is complete.
7. Next, it will upgrade the open firmware.
8. Then, it will reboot again.
9. After a little while, it will boot up to a screen which says "Name."
   • If, instead of this, you see
     1. an XO with a disk, blinking usb key, followed by a blinking wireless symbol (the wireless one will come up after the usb key is done blinking)
     2. an XO with a question mark on it, and at the top of the page it says, "activation lease not found"
     • This laptop has not been pre-activated, so SET IT ASIDE
10. Hold down Alt, Ctrl, and 'mesh' (the third button along the top row that is a black circle with 8 small white dots).
11. Hit return to get the login prompt. Type 'root', and hit return.
12. Check the version by reading the label just above the login: OLPC Build 648 (match that against expected build number).
13. Type 'poweroff' to shut down the laptop, package it for shipping.

In house pre-activation and Upgrade

1. Ensure you have both a power adapter and a battery plugged into the laptop.
2. Insert the 'dk' (developer key) USB stick into the laptop.
3. Power up and hit ESC when it starts to count down (before booting into sugar)
4. Type 'add-tag ak'
5. Hit return
6. You may have to wait for a reboot; Hit ESC and then type the same thing again (it will tell you in red if you need to do this)
7. When it reboots again, hit esc and then remove the 'dk' USB stick.
8. Power off
9. Insert the 'bl' (BUILD 647) USB stick.
10. Press the Power button and then immediately press all four game key buttons.
11. When it says 'release the game keys', release all buttons.
12. The laptop will first upgrade the firmware; then reboot and start the block by block writing to the NAND and should take a few minutes to complete.
13. It will reboot when it is complete -- try to remove the USB key while it is in power off stage.
14. When it is finished booting you should see the nickname start page.

For Test units:

1. Add the nickname and choose a color (default is good)
2. Hit enter to boot all the way into sugar.
3. Hold down Alt, Ctrl, and 'mesh' (the third button along the top row that is a black circle with 8 small white dots).
4. Hit return to get the login prompt. Type 'root', and hit return.
5. Check the version by reading the label just above the login: OLPC Build 647 (match that against expected build number).
6. Type 'poweroff' to shut down the laptop, package it.