Release notes/8.2.0: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(229 intermediate revisions by 43 users not shown)
Line 1: Line 1:
{{Draft}}
{{outdated}}
{{OLPC}}
{{OLPC}}
{{Release Notes}}
{{Release Notes}}
Line 5: Line 5:
{{TOCright}}
{{TOCright}}


''Our apologies, but if you are using Browse in version 10.1.1 on XO-1.5 you may have been directed to this page by [http://dev.laptop.org/ticket/10243 mistake]. If so, please go to the [[Release_notes/10.1.1|10.1.1 release notes]]. The rest of this page relates to version 8.2.0.''
= Before you update to this release=

Before you update to this release, please:
== Before you update to this release==
* If you are in a school or other deployment, make sure you contact your technical support team before updating. Some deployments have special configurations which will need special steps taken before update. Your deployment may not yet support this release.
* If you are in a school or other deployment, make sure you contact your technical support team before updating. Some deployments have special configurations which will need special steps taken before update. Your deployment may not yet support this release.
* Determine which release you are on and whether you plan to update over the Internet or via USB stick. The available [[#Upgrading_from_previous_releases|upgrade options]] are listed below.
* Determine the version of your activities. Decide if you need to re-install or update them and make sure you have access to updated versions if required. See the list of [[#Activity incompatibilities|activities you must update]].


== New features in 8.2.0 ==
Full instructions are are in the [[#Upgrading from previous releases|upgrading from previous releases]] section of this document.


There is a new Help Activity in this release that includes a full manual on the laptop. Look for the icon of a Question Mark.
Read through the list of notable open [[#Notable_Open_Bugs_In_This_Release|bugs]].


= New features in 8.2.0 =
In addition to fixing bugs, we've added lots of new features to our 8.2 release, including
In addition to fixing bugs, we've added lots of new features to our 8.2 release, including
* [[#GUI and usability improvements|GUI and usability improvements]]
* [[Feature_GUI and usability improvements|GUI and usability improvements]]
* [[Automatic software updates]]
* [[#Automated activity updater|Automated Activity Updater]]
* [[#Backup and restore to school server|Backup and restore]] to school server
* [[Feature_Backup and restore to school server|Backup and restore]] to school server
* [[#Longer battery life|Longer battery life]]
* [[Feature_Longer battery life|Longer battery life]]
* [[#Languages and keyboards|New Translations]]
* [[Feature_Keyboards and Languages_8.2|New Keyboards and Languages]]
* An update to [[#Fedora 9|Fedora 9]] for our base system
* [[#Improvements to activities|Improvements to activities]].


The new XO manual for release 8.2.0 is available [http://www.laptop.org/manual/ here.]
== GUI and usability improvements ==
A number of aspects of the Sugar UI have been revamped to improve the user experience.


== Upgrading from previous releases ==
===Home view===
We've made a number of improvements to the home view to make it easier to manage and launch activities.


For technical details and other upgrade options see [[olpc-update]] and [[Clean-install procedure]]. If you run into trouble, see [[Upgrade troubleshooting]], [[Support FAQ]] and [[Support]] to email our tech support volunteers.
There are now three distinct view options:


=== If your XO is connected to the internet ===
<gallery align='right'>
Image:Home Freeform View8.2.png|'''Home Freeform view'''
Image:Home Ring View8.2.png|'''Home Ring view'''
Image:Home List View8.2.png|'''Home List view'''
</gallery>


'''Note that this process may make some of your Activities and the Journal items that depend on them not work - make sure you have backed up any files you want to save!'''
;Freeform
This view shows only favorite activities. The activity icons can be positioned by dragging them around the screen.
;Ring
This view shows only favorite activities. The activities are kept neatly ordered within a ring surrounding the XO.
;List
This view shows every activity currently installed on the laptop, as well as other info about them such as their installation date and version number. The search field allows children to easily locate an activity in the list. Favorite activities can be specified here by starring them.


This process can take more than 30 minutes, much longer if you have a slow internet connection.
;Launching activities

In the new design, the Home view serves as a space for launching new activities. By contrast, the Frame now contains the running activities which used to appear in Home. This change solidifies the zoom levels as places for initiating new objects and interactions. Clicking on an activity icon will launch it, revealing a brand new launching behavior which provides strong and immediate feedback, with the familiar pulsing icon in the center. This feedback discourages children from launching many activities at once. (They can leave the launcher via the zoom buttons/keys to start others, if they wish.)

;Removing activities

[[Image:Removing Activities8.2.0.png|thumb|right|Activities can be individually erased to free up space for new Activity course material]]
By hovering over the activity icon it's possible to take other actions as well. For instance, one may easily add or remove it as a favorite activity, or remove the activity completely, uninstalling it permanently. To prevent accidental deletion, a confirmation step is required when deleting activities.

=== Frame ===
The new frame provides more useful content relevant to the current state of a child's interaction with the laptop. The edges of the frame represent, clockwise from the top: places, people, devices, and objects. Each of these edges provides useful information and interactions, which can be accessed at any time via the frame key or the hot corners.

[[Image:Frame-01.jpeg|thumb|right|The Frame is accessible from anywhere]]

;1. Places
The top edge of the Frame showcases the "places" within the UI a child can navigate to. First and foremost, the zoom level buttons appear here just as they always have. Additionally, the list of currently running activities also appear on the top edge of the frame; the active activity is highlighted. The Journal is always present here as a running activity. Having the active activities in the Frame allows one to easily switch among them with ease, without first returning to Home.
;2. People
The right edge serves as an "active buddy list." People with whom a child is currently collaborating appear on the right edge of the Frame.
;3. Devices
System status is now readily available in the bottom edge of the Frame. The battery level, network status (including the new mesh device, which allows one to switch channels), and speaker all appear here. Their palettes provide more details, and options such as the ability to adjust the volume.
;4. Objects
The left edge of the Frame serves as a multi-item clipboard. Objects such as images and text can be dragged to and from the clipboard and activities, or permanently kept in the child's Journal. The currently selected item (which can be selected with a click) will be pasted when the paste button (or shortcut) is invoked within an activity.

=== Journal ===

The 8.2 release includes an updated Journal as well. The changes are subtle, but the look is cleaner and some additional features have been added to make object management easier.

;'''List view'''

The list view looks a bit different, but hasn't changed too much from how it behaved before. It still contains a list of all of the objects created on the laptop, ordered by date. Resuming an activity is as simple as clicking on the activity icon itself. There are a few enhancements to the Journal list as well:

;In-line renaming
It's now possible to rename entries directly within the list view, by clicking on the title text. A text field will appear to receive changes, which can be confirmed or canceled with enter and esc, respectively.
;Object palettes
The objects represented within the entries (specifically, activity and people icons) now have palettes attached to them. By hovering over their icons, it's possible to find out more information about them, such as the name of the person, and take actions on them, such as copying or deleting an entry. These changes make it possible to do more from the list, without having to constantly enter the detail view.
;Better feedback
The Journal now provides better feedback in edge cases, for instance when there are no search results returned for a query, to prevent confusion.

;'''Details view'''
By clicking on the details button (the little arrow) at the right of an entry, a child can view the details page for the entry. This includes a preview, editable description and tags, and other info about the entry. The toolbar at the top of the screen provides useful actions for launching, copying, or deleting the entry.

=== Graphical sugar control panel ===
Accessible from the pop-up menu of the XO icon in the [[home view]], the control panel currently provides a graphical interface for setting language, power, UI, date and other options. More detailed instructions can be found [[Sugar_Control_Panel#The_graphical_user_interface| here]].

<gallery>
Image:Sugar_Control_Panel.png|'''Sugar Control Panel''' <br> Graphical interface for setting many XO preferences.
Image:Sugar_Control_Panel_Language.png|'''Language''' <br> Allows selection of the default language.
Image:Sugar_Control_Panel_Power.png|'''Power''' <br> Enables power saving modes. See Improved Power Management section below for more details.
Image:Sugar_Control_Panel_Frame.png|'''Frame''' <br> Sets the time it takes the Frame to appear when the cursor is on the corner or on the edge (side) of the screen.
Image:Sugar_Control_Panel_About_my_XO.png|'''About my XO''' <br> Shows the build number, firmware version and serial number.
Image:820_updateproposal.png|'''Software Updates'''<br> Checks for latest version of activities and optionally upgrades them
Image:Sugar_Control_Panel_Date_and_Time.png|'''Date & Time''' <br> Allows setting of the Timezone. Note: this function no longer needs Super User access.
Image:Sugar_Control_Panel_About_Me.png|'''About Me''' <br> Sets the name and color of your XO icon. These values are seen by other XOs when using collaboration.
Image:Sugar Control Panel Network.png|'''Network''' <br> Allows turning off the wireless radio and identifies a school server for collaboration
</gallery>

== Software Updates ==
This release introduces an automatic updater to help you get the latest Activities. Activities are maintained separately from the core operating system. So newer activities may have become available since the software on your XO was installed. The software updater looks for the latest version of activities and offers to update them when new versions are available.

Note: it is especially important to update your Activities after upgrading from build 656 or earlier.

The Software Updater will prompt you to update immediately after you upgrade to release 8.2. You can also open it from the main Sugar Control Panel.

To use the Software Updater you must be connected to a network. The tool will check for existing activities on your XO and then check if there are newer versions available. You can then choose to update to the newer activities by selecting them and choosing 'Install now'.

You can also subscribe to different "Activity Groups" with interesting collections of activities, by clicking on the "Edit Activity Groups" expander in the control panel. The [[activity groups]] page on our wiki lists some interesting activity groups you can try.

A list of available activities is [[activities|here]].

For activity authors and developers, technical details can be found at the [[Software update]] page on our wiki.

== Backup and restore to school server ==
This feature will automatically backup an XO at least once a day to its registered school server. This feature is only relevant for school systems which have implemented the OLPC School Server. It is not available for home users.

To restore a previous backup from the XO, open the Browse activity, click on "Schoolserver", and choose the files which you wish to restore.

You must use XS version 0.4 ([[XS_Release_Notes|XS Release Notes]]) or later to take advantage of this feature.

*[[XS_Blueprints:Datastore_Simple_Backup_and_Restore|Detailed Documentation on Backup and Restore]]

== Longer battery life ==
The XO has several power saving modes.

'''Default Power Management-''' <br>
With no checkboxes selected in the power save control panel the XO will save power in the following ways:<br>

* The XO screen will go blank if you do not touch the keyboard or touchpad for 20 minutes. When this happens, touching the keyboard or touchpad will wake up the display.

* If you close the lid or press the power button briefly then the XO will go in to suspend mode. In suspend mode the CPU stops running programs. The screen goes black. The wireless will continue operating if you are connected in a Mesh but it will shut down if you are connected to an access point. Awaken the machine by pressing the power button again, or by opening the lid.

'''Important note: the following functionality is not a supported feature yet. You may experience unexpected behavior after checking the Automatic Power Management or Extreme Power Management, but you can help us try it out and find issues.'''

'''Automatic Power Management-''' <br>
If you select the Automatic Power Management check box in the Power panel under the Graphical sugar control panel, the XO also saves power in the following ways:<br>

* The screen dims and the XO goes in to "idle suspend mode" if you don't touch the keyboard or touchpad for one minute and the CPU is idle. In "idle suspend mode" the CPU will stop running programs, while leaving the display on (but dimmed).

* In "idle suspend" mode, if you touch the keyboard or touchpad, the XO screen will wake up from dimmed mode and the CPU will restart.

* When the XO enters "idle suspend" mode it powers down all USB ports including any USB to Ethernet connectors. Because not all devices can recover from this automatically, you may need to reconnect those external devices or reboot the XO to enable them again. As an exception to this guideline, USB storage devices ("USB sticks") do work correctly after a suspend and resume (but they should not be removed while the system is suspended).

If the laptop is in "idle suspend" mode when the lid is closed, the display will remain active. To fully suspend the laptop, the lid should be opened, and closed again, or the power button should be pressed before closing the lid.

'''Extreme Power Management-''' <br>
If you select the Extreme Power Management check box in the Power panel under the Graphical sugar control panel, the XO also saves power in the following ways:<br>

* The same functionality as described above when Automatic Power Management is checked. In addition, the wireless radio is shut off including when the XO is connecting via Mesh.

For more detail on the intended design of power saving modes, see: <br>
http://wiki.laptop.org/go/Suspend_and_resume

== Languages and keyboards ==

OLPC relies on volunteers and country experts for keyboard knowledge and for translations of the Sugar user interface and all the Activities that many contributors have provided. Translations are not tested or approved by OLPC. Both translations and Keyboards must tested and approved by the country designated experts or by volunteers.

Thanks to members of the worldwide [https://dev.laptop.org/translate/ OLPC Translation Project], who can be found on the [http://lists.laptop.org/listinfo/localization localization mailing list], the following languages show more than 80% of the Sugar interface has been translated:

* Brazilian Portuguese
* Dutch
* English
* French
* German
* Greek
* Italian
* Japanese
* Kinyarwanda
* Kreyol
* Marathi
* Mongolian
* Nepali
* Portuguese
* Sinhala
* Spanish
* Telugu
* Turkish
* Urdu



The following table lists the locale code for each language and the corresponding control panel entries.

{| {{table}}
| align="center" style="background:#f0f0f0;"|'''Locale'''
| align="center" style="background:#f0f0f0;"|'''Language'''
| align="center" style="background:#f0f0f0;"|'''Control Panel Entry'''
| align="center" style="background:#f0f0f0;"|'''Notes'''
|-
| pt_BR||Brazilian Portuguese||Portuguese (Brasil)||
|-
| en_*||English||English (*)||Locales for multiple regions are supported with a single translation (eg: English (USA), English (Great Britain), etc)
|-
| fr_*||French||French (*)||Locales for multiple regions are supported with a single translation (eg: French (France), French (Belgium), etc)
|-
| de_*||German||German (*)||Locales for multiple regions are supported with a single translation (eg: German (Germany), German (Austria) etc)
|-
| el_*||Greek||Greek (*)||Locales for multiple regions are supported with a single translation (eg: Greek (Greece), Greek (Cyprus), etc)
|-
| it||Italian||Italian (*)||Locales for multiple regions are supported with a single translation (eg: Italian (Italy), Italian (Switzerland), etc)
|-
| ja||Japanese||Japanese (Japan)||
|-
| rw||Kinyarwanda||Kinyarwanda (Rwanda)||
|-
| ht||Kreyol||Kreyol (Haiti)||Locale data not integrated into glibc (https://bugzilla.redhat.com/show_bug.cgi?id=459547)
|-
| mr||Marathi||Marathi (India)||
|-
| mn||Mongolian||Mongolian (Mongolia)||
|-
| ne||Nepali||Nepali (Nepal)||
|-
| pt||Portuguese||Portuguese (Portugal)||
|-
| si||Sinhala||Sinhala (Sri Lanka)||
|-
| es_*||Spanish||Spanish (*)||Locales for multiple regions are supported with a single translation (eg: Spanish (Peru), Spanish (Uruguay) etc)
|-
| te||Telugu||Telugu (India)||
|-
| tr_*||Turkish||Turkish (*)||Locales for multiple regions are supported with a single translation (eg: Turkish (Turkey), Turkish (Cyprus), etc)
|-
| ur||Urdu||Urdu (Pakistan)||
|}



The builds also ship the following languages, with more than 50% user interface coverage.
{| {{table}}
| align="center" style="background:#f0f0f0;"|'''Locale'''
| align="center" style="background:#f0f0f0;"|'''Language'''
| align="center" style="background:#f0f0f0;"|'''Control Panel Entry'''
| align="center" style="background:#f0f0f0;"|'''Notes'''
|-
| ar_*||Arabic||Arabic (*)||Locales for multiple regions are supported with a single translation (eg: Arabic (Egypt), Arabic (Lebanon), etc)
|-
| fa_AF||Daro||Dari (Afghanistan)||
|-
| ps||Pashto||Pashto (Afghanistan)||
|-
|
|}

Languages which are not in the official builds can be installed by means of [http://wiki.laptop.org/go/Localization/LanguagePacks Language Packs]

Apart from the languages mentioned above, a number of languages have more than half of the user interface strings translated. Please note that none of the translations are officially supported by OLPC. If you want to get involved in the volunteer driven translation efforts, visit the [https://dev.laptop.org/translate/ OLPC Translation Project].


Keyboards that were tested by OLPC with country support for this release include:
* English, [[OLPC_English_Keyboard]]
* Spanish, [[OLPC_Spanish_Keyboard]]
* Amharic, [[OLPC_Amharic_Keyboard]]

All keyboards that are currently shipping have been booted up with the 8.2 release, but we have not had confirmation that the following are working properly. This list includes: <br>
* Portuguese, [[OLPC_Portuguese_Keyboard]]
* Arabic, [[OLPC_Arabic_Keyboard]]
* Thai, [[OLPC_Thai_Keyboard]]
* Urdu, [[OLPC_Urdu_Keyboard]]
* Cyrillic, [[OLPC_Russian_Keyboard]]
* Mongolian, [[OLPC_Mongolian_Keyboard]]
* Devanagari, [[OLPC_Devanagari_Keyboard]]
* Dari, [[OLPC_Dari_Keyboard]]
* Khmer, [[OLPC_Khmer_Keyboard]]
* French-Canadian, [[OLPC_French_(ca)(ht)_Keyboard]]

The keyboard layout can be changed by following the process described [[Localization/Changing_Keyboard_Layout|here]].

== Fedora 9 ==
We've upgraded our base system to the [http://docs.fedoraproject.org/release-notes/f9/ Fedora 9] release from our partner, [http://redhat.com Red Hat]. The [http://docs.fedoraproject.org/release-notes/f9/ release notes] for Fedora 9 describe some of the improvements we've inherited, although builds for the XO do not include all the features of Fedora 9 by default.



= Upgrading from previous releases =

Be sure to read and carefully follow these instructions before you begin the upgrade process, and allocate enough time to do the full process before you begin.

'''During pre-release development, you will need a [[developer key]] in order to install an 8.2 [[OS Images|OS image]]. This key should be copied in the /security directory BEFORE the upgrading process.'''

'''Important Note: Please check with your deployment technical contacts before upgrading. Countries using the XO may have custom configurations which may require special actions to be taken before new releases can be installed.'''

The process described below is to upgrade the XO while it is connected to Internet, for other ways to upgrade, see the [[Upgrading_the_XO#Overview_of_Upgrading_Options | Upgrading the XO]].

Here are the steps to upgrade:
# Plug the XO into AC Power
# Connect XO to the internet
# Launch the update command
# Update activities

== Step 1: Plug the XO into AC Power ==
Upgrading could be a long process. For this reason, ensure first that your XO is connected to reliable AC Power. Be sure to have enough time to do the full process (about 1 hour).

== Step 2: Connect XO to the internet ==
During the upgrade process, your XO will download the new release. So you should ensure that the XO is connected to the internet before launching the upgrade. See [http://laptop.org/laptop/start/connecting.shtml Connecting Guide] or [[Wifi Connectivity]] for instructions. Use Browse activity to test your connection.

== Step 3: Launch the update command ==
Open the '''[[Terminal Activity]]''' [[Image:Activity-terminal.svg|35px]] or a console and type the following (press the Enter key after it):

sudo olpc-update ''{{:Friends in testing/current image}}'' <!-- reboot, verbose -->

If the update program successfully connects to the update server, some messages should display similar to this:


# Make sure your XO is plugged in, turned on, and [http://laptop.org/manual/XO_GiveMeTheInternet.html connected to the Internet] (you should be able to load http://laptop.org in the Browse Activity). If your XO is not connected to the internet, you will not be able to use this upgrade method.
# Open the Terminal Activity. [[Image:Activity-terminal.svg]] You can find it by going to the home view (press the 5th symbol from the left, top row), clicking on the little arrow at the bottom right of the screen, and then on the symbol that looks like this one.
# In the Terminal Activity, type <code>su -</code> (lowercase letter 's', lowercase letter 'u', a space, and a hyphen). Press Enter.
# At the <code>"-bash-3.2#"</code> prompt type <code>olpc-update 767</code>. Press Enter.
# You should see text that looks something like this (sometimes, in addition to the text below, you might get a message about irsync_pristine failing, and that "irsync_dirty" is being tried, this is normal):
<pre>
Downloading contents of build ''{{:Friends in testing/current image}}''
Downloading contents of build ''{{:Friends in testing/current image}}''
Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
Line 312: Line 45:
- Cleaning tree.
- Cleaning tree.
- Fetching contents.
- Fetching contents.
- Performing incremental rsync.
- Performing incremental rsync. [Comment: Wait a long time! Could be over an hour depending on your internet connection speed.]
Verifying update.
Verifying update.
Installing update in /versions/{pristine,run}/''xxxx''
Installing update in /versions/{pristine,run}/''xxxx''
</pre>
6. At the end of the upgrade, you will either see the words "Installing update in...." or "Update Succeeded!" on the screen. If you see the words "I don't think you're connected to the internet." see the notes below. <br>
<br>
7. Wait for the prompt <code>"-bash-3.2#"</code> and type <code>reboot</code> then press Enter to restart your XO. You will probably hear the little XO tune 2 times, then it will say erasing and a countdown will appear. Finally it will reboot again, you will hear the tune for a third time. Now you are ready to go to step 8.<br>
<br>
8. After your XO reboots, the last step is to download the new versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install your newest versions of your activities. <br>


Congratulations, you've upgraded!
This process may take more than thirty minutes. When the process is complete, you need to [[reboot]].


'''Note:'''
'''Important Note: On the first reboot after upgrading, the XO will run slowly for about 1 minute. After that it will run normally.''' <trac>7356</trac>
* When upgrading from build 703 or 708 you will not see the Library (links to science, books, etc links on the left side) in the Browse home page. You can re-install the Library as follows:
** Open the Control Panel and go into Software update.
** After it checks for updates, go to <code>"Modify activity groups"</code> and click on the triangle.
** Beside <code>"Group URL"</code> type: <code> http://wiki.laptop.org/go/Activities/G1G1 </code> and click the <code>"Add"</code> button.
** Click <code>"Refresh"</code> and allow the XO to upload the new updates.
** Click on Install selected. Once it completes, reboot.
* If you can browse the Internet (see step 1 above) but the <tt>olpc-update</tt> command returns the error <code>"I don't think you're connected to the internet."</code>, you may need to open TCP port 873 (rsync) on your firewall for the outbound connection.


=== Offline upgrade ===
== Step 4: Update activities ==
[[Image:YamaDone.JPG|thumb|''for new users'' [[USB_upgrade|<br>'''illustrated guide to upgrading using a USB stick<br>''']]]]
You can use another computer that is connected to the internet (a desktop at home, a computer lab, etc.) plus a USB storage device (such as a compatible [[USB_drive#USB_drives_and_firmware|USB flash drive]]) to upgrade your XO.
The way it works is on your non-XO computer you download two files containing the upgrade data, saving them to the USB flash drive; then you insert the USB flash drive into your XO and trigger its upgrade process.
'''Note that this process will COMPLETELY erase ALL files on your XO! Make sure you have backed up any files you want to save!'''


Plug an empty formatted USB flash drive into the computer that is connected to the internet.
After you reboot the first time, sugar should notify you that your activities should be updated. Your activity update process will differ depending on whether or not you have network access.
Then, right-click (Ctrl-click for Mac) on each of the two URLs below and choose "Save Target As" ("Save Link As" for Firefox). Save both files to the USB flash drive. Do not open the files.


* http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/fs.zip (This file contains only instructions for the firmware to update with the following file.)
[[Image:820_firstactivityinstall.png|thumb|G1G1 Activity install]]
* http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/gg-767-4.img (This file contains the Sugar platform with the G1G1 2008 set of Activities.)
[[Image:820 updateproposal.png|thumb|Activities update proposal]]


The first file is about 297 KB, and the second file is quite large (about 450 MB), so they might take a while [15 - 20 min.] to download. When the download is complete, Eject/Remove the USB flash drive, and unplug it. After you have finished this step, there should be two files on the USB flash drive, the <tt>fs.zip file</tt>, and the <tt>.img</tt> file. The MD5 checksum for fs.zip is 1bb452e77b7390e00bdd7fdcc7cbc793 The MD5 checksum for gg-767-4.img is 3f281dda352d32320879728377b32476
=== With the XO connected to the internet ===


Now, follow the steps below to complete your installation:
First, '''connect to the internet''', and then either click the "Check now" icon in the update notification dialog, or, if you've dismissed the dialog, open the sugar control panel and click the "Software update" module.


# Turn off your XO and connect your USB flash drive to it.
You should see a progress bar as your XO looks for the appropriate updated versions of the activities you have installed. When it is done, click "Install selected" to update your activities. You'll see another progress bar, as the activities are updated.
# Make sure your XO is plugged in.
# Hold down all four gamepad keys (on the right side of the screen, above the power button). While still holding the four gamepad keys, push the power button to turn the XO on. Keep holding down the four gamepad keys until the message "Release the game key to continue" appears on the screen.
# Release the gamepad keys. If you see a grid of colored boxes on your screen, congratulations! Your XO is reflashing. It will take about 10 minutes and your XO will automatically reboot when it is done. Your XO may reboot twice, playing the little XO tune.
# After your XO reboots, the last step is to update to the newest versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install the newest versions of your activities. <br>
Congratulations, you've upgraded!
Now, you should be ready to go. Have fun!


(If you chose "Later" on the software update, go to the Sugar Control Panel and select the "Software update" when you are ready to install the updates)
Some activities may not successfully update, either because the new version of the activity is improperly packaged or due to transient network errors. If this is the case, some activities will remain in the "available updates" list after the installation process has completed. If a network error was the cause, you may wish to immediately retry the installation; otherwise, you probably need to wait until the activity author uploads a corrected version of their bundle.

=== Without the XO connected to the internet ===
If you do not have a connection to the internet:

:1. Download the [[G1G1 Activity Pack]] (from [http://wiki.laptop.org/images/6/62/G1G1_Activity_Pack_1.zip here]) and unzip it in the base (root) directory of a BLANK USB flash drive. You should see two directories (boot and bundles), and a file called customization-2 in the base directory. <br>
/boot
/bundles
customization-2
:2. Insert the USB flash drive and [[reboot]] the XO. It will display text on a black screen as the activities are installed, after which it will power off.<br>
:3. Remove the USB flash drive.

'''Notes'''
* The USB flash drive should be formatted with a VFAT file system (FAT16 with long filename support); this is the common format for most USB sticks with capacity up to 2 GB.
** It is important that the USB flash drive have a partition table, and that the VFAT file system be in the first partition. Linux allows you to put a file system directly on the drive itself without a partition table (i.e. "mkfs.vfat /dev/sdi", rather than fdisk and "mkfs.vfat /dev/sdi1"), but then on boot, the XO will panic with an error from mount ("non-zero status code 255").
* You can perform steps 1 and 2 on another computer, or if you are familiar with the Linux command line, on the XO in a [[Terminal Activity|terminal]] using <tt>wget</tt> and <tt>unzip</tt>.
* Commands such as "extract here" in ubuntu / windows will sometimes create a directory with the same name as the zip file, placing the unzipped files within it. If this happens, you will have to move the files to the base directory in order for your XO to see them on boot.
* The "boot" directory will contain two zip files, actos.zip and runos.zip. This is normal; these files SHOULD NOT be unzipped.
* Warning: the USB flash drive should be empty before this operation to contain ONLY the G1G1 Activity Pack files at end.
* If your machine is not a secure XO (its firmware is unlocked), you must boot in secure mode. If you have a developer key on a removable media like an SD card or a USB key, remove the media. If the developer key is on the NAND FLASH or the machine is permanently unlocked, hold the X game key while booting.

In addition to the [[G1G1 activity pack]], some commonly installed alternative activity packs include the:
* [[Peru activity pack]]
* [[Nepal:_Testing%2C_QA%2C_and_Configuration#Nepal_Activity_Pack|Nepal activity pack]]
* [[:Category:Activity Pack|...more activity packs]]

(The Nepal activity pack contains some [[Nepal_Customization_702|additional customizations]] made by [[OLE Nepal]] for their pilot).

To install these packs, use the same process that you just used to install the [[G1G1 activity pack]].



= Resolved Bugs In This Release =
All bugs which have been closed and included in 8.2 are listed here: <br>
http://dev.laptop.org/report/22

A few important ones include:<br>
<trac>5987</trac> Flash (using the open source Gnash implentation plays better (e.g. pbskids.org works better).

<trac>6014</trac> Activities try to save their data when the XO si shut down while an activity is open. This is better but not complete. Users should close their activities before before shutting down the XO.

<trac>4208</trac> Several battery charge level indicator inconsistencies have been resolved.


== Resolved bugs in this release ==
Many bugs were closed in this release. A few important ones include:<br>
<trac>5156</trac> Browse can view Google calendar.
<trac>5156</trac> Browse can view Google calendar.


<trac>5613</trac> The XO name can now accept any characters. This is important for languages which do not use the ASCII characters.
<trac>5613</trac> The XO name can now accept any characters. This is important for languages which do not use the ASCII characters.


<trac>6014</trac> Activities try to save their data when the XO is shut down while an activity is open. This is better but not complete. Users should close their activities before shutting down the XO.
<trac>7391</trac> Search field entries switch home view to list.

<trac>7764</trac> Reset network config and reboot.

<trac>7382</trac> Browser now does autocomplete.

<trac>6036</trac> When leaving and restarting Chat, a line showing time passed since previous Chat's is added. This makes it easier to see which messages are current.

= Notable Open Bugs In This Release =

'''Note: we recommended that you restart your XO at least once every 24 hours. If you leave your XO running for 24 hours continuously it may become unstable.'''

== Limits of collaboration scale and duration ==

== General Issues ==
All known open bugs (defects) in this release are [http://dev.laptop.org/query?status=assigned&status=new&status=reopened&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component&type=defect here]

This is an open bug tracking system so anyone can enter bugs. Therefore, please use caution when interpreting the content of this list. If you have a question about the validity or status of any known bug you can e-mail the owner by leaving a comment in Trac (click on the bug ID to bring it up on Trac). You can send an e-mail to devel@lists.laptop.org.

* <trac>6253</trac> You must close the original activity before opening a file created by it in another activity, when using the Journal. For example, if you take a picture in Record, then go to the Journal and choose open in Paint from the drop down menu, it will open again in Record. The workaround is to close the original activity (e.g. Record in this example) before opening it in a different activity.
* <trac>6388</trac> You cannot access a USB and SD card at the same time. It must be one or the other.
* <trac>7426</trac> Journal disappears after downgrade from 8.2 to 70x.
* <trac>7509</trac> Journal fails to mount specific usb drive
* <trac>7531</trac>shutdown sometimes appears to hang - need ctl-alt-F2 for it to complete
* <trac>7533</trac> clipboard issues are know. Only things tested in smoke test will work.(edit)
* <trac>7622</trac> Control Panel's 'Software update' module does not preserve an Activities Home view favourite state
* <trac>7627</trac> Palette can be partially drawn off screen when using right click for quick display
* <trac>7642</trac> Switching to mesh/neighborhood view should hide control panel.
* <trac>7649</trac> Activities needs to access sugar-toolbox's members directly
* <trac>7713</trac> Inconsistent behavior for activity installation
* <trac>7733</trac> Cannot install Wikipedia-10.xo
* <trac>7742</trac> don't double click on activities
* <trac>7754</trac> Opening more than one instance of Browse blocks both
* <trac>7775</trac> Network icon not refreshed after first connect in neighborhood view (joyride-2230)
* <trac>7785</trac> unreliable ethernet connection
* <trac>7426</trac> Journal in f7 disappears after olpc-update to f9
* <trac>7812</trac> work around is holding down the power button.
* <trac>7825</trac> Some WPA APs will not work due to this bug. Only the ones we have tested should work properly.
* <trac>7870</trac> need to use new network reset GUI 7480 to work around this and other network issues
* <trac>7873</trac> and 7874 should be noted unless fixed
* <trac>7877</trac> Control Panel / Data & Time: Selecting timezone by typing locks up UI
* <trac>7876</trac> Don't double click on activities to launch them!
* <trac>7888</trac> (note to self, also check sharing page to make sure it says Paint doesn't share)
* <trac>7895</trac> Journal fails to display USB devices.
* <trac>7990</trac> sugar-control-panel - blocks frame operation?
* <trac>7993</trac> Journal unmount broken - dataloss n vfat
* <trac>8011</trac> software update does not remedy lost Activities/Analyze.activity* <trac>7922</trac> hang on suspend when USB-ethernet is connected
* <trac>8088</trac> Some kingston usb keys aren't mounted by the initramfs and can't be used to distribute activation leases
* <trac>8099</trac> ext3 formatted usb mounted but not visible in journal
* <trac>8111</trac> ctr-alt-del doesn't work from term
* <trac>8117</trac> LidClose suspend is inhibited by a prior PowerButton resume.
* <trac>8132</trac> New wireless firmware version incorrect with ethtool -i eth0
* <trac>8181</trac> Save to journal now called Keep.
* <trac>8183</trac> No non-English languages in Qemu installs
* <trac>8200</trac> confusing message in journal on some queries
* <trac>8220</trac> Don't show frame when using log viewer
* <trac>8225</trac> reboot every day or so.
* <trac>8254</trac> libX11 & libX11-devel dependency issues
* <trac>8287</trac> Copy-to-clipboard broken in Journal
* <trac>8301</trac> Fast suspend/resume cycle causes a libertas crash
* <trac>8344</trac> occasional error message in log viewer
* <trac>8346</trac> control panel claims you must enter a URL for server
* <trac>8380</trac> text in search causes all things in list view to disappear
* <trac>8423</trac> moving icons in freeform consumes memory
* <trac>8443</trac>
* <trac>8452</trac> If both the screen rotation and the frame key are pressed multiple times sugar crashes.
* <trac>8490</trac> power save sometimes crashes
* <trac>8522</trac> Don't run Record and Chat at the same time. If you do, you may lose the drop down menu on the central XO icon on the Home Screen.
* <trac>8526</trac> Setting power light to maximum brightness can cause it to unexpectedly dim.
* <trac>8533</trac> Extra entries in journal after upgrading from 656
* <trac>8592</trac> connect icon flashes slowing XO. Work around available.
* <trac>8653</trac> Special update procedure when coming from build 650

clipboard not consistent (add details and bug ids)

== Open Power Issues ==
* <trac>6201</trac> eToys can stop working if it is playing a sound when the XO suspends. See more details on when the XO suspends [[Release_Notes/8.2.0#Longer_battery_life|here]].

== Open Collaboration Issues ==
Explain scale and how to turn off the radio. <br>

* <trac>6467</trac> mesh view takes a while to fill in after suspend.
* <trac>7511</trac> Transferring video files between laptops saturates bandwidth and kills running session
* <trac>7513</trac> Sharing is limited in time. Cannot share overnight
* <trac>8437</trac> can't share a recorded video
* <trac>8160</trac> Write activity stops sharing and hides users from neighborhood
* <trac>7893</trac> It takes some time for XOs to appear and disappear when changing mesh.
* <trac>8189</trac> Maximum # of XOs in a mesh is 10
* <trac>8235</trac> meshview loses data on screen rotate.
* <trac>8121</trac> There is a point when launching new activities fills up mem, makes system crawl to a freeze, and only solution is to power down
* <trac>8430</trac> leaving buddy group doesn't always show.
* <trac>8517</trac> Sometimes you cannot save a chat transcript. When you see "keep error" on exiting a chat it means that the log of your chat was nto saved in the journal.

== Open Activity Issues ==
* <trac>6773</trac> TamTamJam: Recorded microphone slots don't playback. ?need to test
* Couldn't add feeds to news reader because clicking "+"/dropdown on the feeds tab didn't do anything. ?need to test
* <trac>6684</trac> <trac>6736</trac> <trac>7017</trac> <trac>6537</trac> <trac>6774</trac> [[Read]] will not reliably share a PDF document.
* <trac>6729</trac> Read doesn't save the PDFs it opens (when sharing)
* <trac>6223</trac> <trac>7166</trac> Read only works well as a PDF viewer. You can start other file formats in Read from the Journal but may have problems.
* <trac>1997</trac> Flashing upon selection in Write activity
* <trac>2008</trac> Rollover should appear at cursor in canvas views
* <trac>2169</trac> Canvas in Write doesn't extend to edges of screen
* <trac>7498</trac> if you have multiple Browse instances open, Browse dialogs appear in the wrong instance window
* <trac>7726</trac> Activities being installed (unziped) hog the CPU, temporarily freezing Sugar
* <trac>8079</trac> browse video playing issue
* <trac>8097</trac> don't alt-esc from browse
* <trac>8112</trac> Chat invite doesn't do anything
* <trac>8113</trac> Acoustic measure doesn't allow 3rd person.
* <trac>8228</trac> no sharing with paint.
* <trac>8279</trac> Mime types not assigned right
* <trac>8356</trac> kuku doesn't work
* <trac>8357</trac> divide by 0 in calculator should say "undefined"
* <trac>8314</trac> browse of big pages crashes
* <trac>8336</trac> mimic not working
* <trac>8021</trac> blogger.com start page raises dramatically X cpu usage
* <trac>7890</trac> Cannot close Paint sessions after attempting to Join
* <trac>8320</trac> no view source w/browse
* <trac>8389</trac> copy and paste from browse to terminal not easy
* <trac>8444</trac> sometimes buddies don't show up
* <trac>8497</trac> Flash wont play from file. Must be embedded in web page.
* <trac>8527</trac> Firefox issue


=== List of activities that must be upgraded to work with 8.2 ===
Some activities need to be upgraded to work correctly on 8.2.0. The following activities must be upgraded. This is not necessarily an exhaustive list. There may be other activities which worked in previous release but need to be upgraded to work with this release.

* Browse-91 (and older versions) will fail to download files and install .xo/.xol bundles. Upgrade to Browse-92 or later. <br>
<trac>8242</trac> browse unneeded error.

* Implode-3 (and older versions) will fail to launch, upgrade to Implode-4.
* Measure 17
* Pippy-21 (and older versions) will fail to launch, upgrade to Pippy-22.
* PlayGo
* Record-54 (and older versions) will fail to take photos and record videos, upgrade to Record-55.
* TamTam bugs <trac>6673</trac>, <trac>7466</trac>
* <trac>7997</trac> re: TuxPaint
* MaMaMedia Creative Center 8047

The [[#Activity updater|"Software update"]] control panel will update some of these if you have internet access.

Test results from Wellington, NZ on build 759<br>
http://lists.laptop.org/pipermail/devel/2008-September/018879.html


<trac>7480</trac> You can reset your network history in the Network control panel in case you need to remove old configurations. However, you will need to re-enter all AP passwords after doing this.
Test results from Gary on build 759 <br>
http://lists.laptop.org/pipermail/sugar/2008-September/008187.html


For a list of all closed bugs in this release click [http://dev.laptop.org/report/22 here]. <br>
== Network-related issues ==


== Notable open bugs in this release ==<nowiki><nowiki>Insert non-formatted text here</nowiki></nowiki>
* <trac>7764</trac> connect to a schoolserver using the 'Register' option in the xo-palette on the home-view. open a terminal activity and use the command line interface of the control panel to reset the registration 'sugar-control-panel -c registration'. After restarting sugar try to connect to the schoolserver again.
* <trac>6944</trac> If you click on a second AP while waiting for the first AP to connect the UI may confuse which is connected.
* <trac>8343</trac> wired ethernet not working well
* <trac>6448</trac> must use mesh or AP but not both.
* <trac>8168</trac> cloaked WPA network appears, then disappears after connection attempt
* <trac>7825</trac> Some WPA access points may not work. We have identified that the XO is incompatible with certain access points running WPA encryption. The workaround is to use another encryption scheme such as WPA2 (RSN) or WEP.
* <trac>5501</trac> it takes some time for the link-local presence information to stabilize.
* <trac>8161</trac> The Check icon next to "Connect" suggests you can connect to mesh/wireless using the check game button


For the best experience and maximum reliability with the XO we recommend the following best practices:
= Tips and Tricks =
'''This is a list of short cuts and tricks for power users of the XO. They are not all tested and confirmed working in all circumstances.'''


'''For all XOs'''
* <trac>5571</trac> copy to and from datastore (journal) at CLI
* If you open too many activities (generally more than 3) at once you may experience slow response. To close activities, use the frame button (upper right), hover over the open activities, and click on close.
* In general, you do not need to double click on anything in the XO interface. It is designed for a single click. For example, double clicking to launch an activity will cause the XO to launch two instances of the activity which may cause one to fail.
* Drag and drop has limited support in this release. It may work in some cases but it does not work consistently everywhere.
* Power save mode is still in development. In this release it is turned off by default in the control panel. If you use it and experience problems, please turn it off.
* If the XO stops collaborating or stops responding, you can reboot it from the home screen (hover over the XO in the center) or hold down the power button for more than 6 seconds.
* Ensure that you have unmounted a USB stick before removing it. Go to the Journal, hover over the USB stick icon and click on 'unmount'. Another method to remove a USB stick and avoid corruption is to power down the laptop before removing the USB stick..


'''For XOs used in school with many XOs present
* Right click in Browse allows some added capabilities.
* Reliable collaboration using the Write activity over mesh or access point networks may not exceed two hours. If there are a lot of XOs or a lot of wireless traffic (e.g. many XOs or many access points) then Write may shut down during collaboration. In this case you may be able to reconnect Write to the collaboration in the Neighborhood view.
* When collaborating over a Mesh (i.e. XO to XO collaboration with no access point or school server) you should limit the number of XOs on any channel to 10. There are three Mesh channels available (1,6 and 11) and each should have a maximum of 10 XOs. More XOs in a channel may cause instability in the collaboration.


* Typing on the keyboard when in home view causes a switch to list view.


* Please see the [[Deployment Support]] pages for information on collaboration and connectivity in schools or areas that are densely populated with XOs.
* Right clicking icons and objects will immediately reveal their secondary palette (<trac>7250</trac>: except on the People, Devices and Clipboard edges of the Frame)


''' Click [[OpenBugs_8.2.0|here]] for a more detailed list of open bugs'''
* Create your own Home View: Tech-savvy users can now create their own activity layouts! See [http://dev.laptop.org/git?p=users/cscott/sugar;a=summary Scott's example layouts].


{{Developers}}
* <trac>7385</trac> keyboard short cut to switch home views


== API Changes ==
* Some keyboard shortcuts have changed; the list of all keyboard shortcuts is at: [[Keyboard Shortcuts/8.2.0]]


Release 8.2.0 incorporates version 0.82.1 of the Sugar UI.
Alt-1 will capture a screenshot within Sugar; the resulting image will
appear in the Journal.


[[API changes]] documents Sugar and system API changes since release 8.1.x.
[[Category:Builds]]

Latest revision as of 07:36, 6 August 2013

The contents of this page are considered outdated and some of the information may be stale. Please use information here with caution, or update it.
  This page is monitored by the OLPC team.
  For the general public

Our apologies, but if you are using Browse in version 10.1.1 on XO-1.5 you may have been directed to this page by mistake. If so, please go to the 10.1.1 release notes. The rest of this page relates to version 8.2.0.

Before you update to this release

  • If you are in a school or other deployment, make sure you contact your technical support team before updating. Some deployments have special configurations which will need special steps taken before update. Your deployment may not yet support this release.

New features in 8.2.0

There is a new Help Activity in this release that includes a full manual on the laptop. Look for the icon of a Question Mark.

In addition to fixing bugs, we've added lots of new features to our 8.2 release, including

The new XO manual for release 8.2.0 is available here.

Upgrading from previous releases

For technical details and other upgrade options see olpc-update and Clean-install procedure. If you run into trouble, see Upgrade troubleshooting, Support FAQ and Support to email our tech support volunteers.

If your XO is connected to the internet

Note that this process may make some of your Activities and the Journal items that depend on them not work - make sure you have backed up any files you want to save!

This process can take more than 30 minutes, much longer if you have a slow internet connection.

  1. Make sure your XO is plugged in, turned on, and connected to the Internet (you should be able to load http://laptop.org in the Browse Activity). If your XO is not connected to the internet, you will not be able to use this upgrade method.
  2. Open the Terminal Activity. Activity-terminal.svg You can find it by going to the home view (press the 5th symbol from the left, top row), clicking on the little arrow at the bottom right of the screen, and then on the symbol that looks like this one.
  3. In the Terminal Activity, type su - (lowercase letter 's', lowercase letter 'u', a space, and a hyphen). Press Enter.
  4. At the "-bash-3.2#" prompt type olpc-update 767. Press Enter.
  5. You should see text that looks something like this (sometimes, in addition to the text below, you might get a message about irsync_pristine failing, and that "irsync_dirty" is being tried, this is normal):
 Downloading contents of build ''{{:Friends in testing/current image}}''
 Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
 Making clean /versions/updates/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 Trying irsync_pristine update from rsync://updates.laptop.org/''build-{{:Friends in testing/current image}}''
 - Cleaning tree.
 - Fetching contents.
 - Performing incremental rsync. [Comment: Wait a long time! Could be over an hour depending on your internet connection speed.]
 Verifying update.
 Installing update in /versions/{pristine,run}/''xxxx''

6. At the end of the upgrade, you will either see the words "Installing update in...." or "Update Succeeded!" on the screen. If you see the words "I don't think you're connected to the internet." see the notes below.

7. Wait for the prompt "-bash-3.2#" and type reboot then press Enter to restart your XO. You will probably hear the little XO tune 2 times, then it will say erasing and a countdown will appear. Finally it will reboot again, you will hear the tune for a third time. Now you are ready to go to step 8.

8. After your XO reboots, the last step is to download the new versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install your newest versions of your activities.

Congratulations, you've upgraded!

Note:

  • When upgrading from build 703 or 708 you will not see the Library (links to science, books, etc links on the left side) in the Browse home page. You can re-install the Library as follows:
    • Open the Control Panel and go into Software update.
    • After it checks for updates, go to "Modify activity groups" and click on the triangle.
    • Beside "Group URL" type: http://wiki.laptop.org/go/Activities/G1G1 and click the "Add" button.
    • Click "Refresh" and allow the XO to upload the new updates.
    • Click on Install selected. Once it completes, reboot.
  • If you can browse the Internet (see step 1 above) but the olpc-update command returns the error "I don't think you're connected to the internet.", you may need to open TCP port 873 (rsync) on your firewall for the outbound connection.

Offline upgrade

for new users
illustrated guide to upgrading using a USB stick

You can use another computer that is connected to the internet (a desktop at home, a computer lab, etc.) plus a USB storage device (such as a compatible USB flash drive) to upgrade your XO. The way it works is on your non-XO computer you download two files containing the upgrade data, saving them to the USB flash drive; then you insert the USB flash drive into your XO and trigger its upgrade process. Note that this process will COMPLETELY erase ALL files on your XO! Make sure you have backed up any files you want to save!

Plug an empty formatted USB flash drive into the computer that is connected to the internet. Then, right-click (Ctrl-click for Mac) on each of the two URLs below and choose "Save Target As" ("Save Link As" for Firefox). Save both files to the USB flash drive. Do not open the files.

The first file is about 297 KB, and the second file is quite large (about 450 MB), so they might take a while [15 - 20 min.] to download. When the download is complete, Eject/Remove the USB flash drive, and unplug it. After you have finished this step, there should be two files on the USB flash drive, the fs.zip file, and the .img file. The MD5 checksum for fs.zip is 1bb452e77b7390e00bdd7fdcc7cbc793 The MD5 checksum for gg-767-4.img is 3f281dda352d32320879728377b32476

Now, follow the steps below to complete your installation:

  1. Turn off your XO and connect your USB flash drive to it.
  2. Make sure your XO is plugged in.
  3. Hold down all four gamepad keys (on the right side of the screen, above the power button). While still holding the four gamepad keys, push the power button to turn the XO on. Keep holding down the four gamepad keys until the message "Release the game key to continue" appears on the screen.
  4. Release the gamepad keys. If you see a grid of colored boxes on your screen, congratulations! Your XO is reflashing. It will take about 10 minutes and your XO will automatically reboot when it is done. Your XO may reboot twice, playing the little XO tune.
  5. After your XO reboots, the last step is to update to the newest versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install the newest versions of your activities.

Congratulations, you've upgraded! Now, you should be ready to go. Have fun!

(If you chose "Later" on the software update, go to the Sugar Control Panel and select the "Software update" when you are ready to install the updates)

Resolved bugs in this release

Many bugs were closed in this release. A few important ones include:
<trac>5156</trac> Browse can view Google calendar.

<trac>5613</trac> The XO name can now accept any characters. This is important for languages which do not use the ASCII characters.

<trac>6014</trac> Activities try to save their data when the XO is shut down while an activity is open. This is better but not complete. Users should close their activities before shutting down the XO.

<trac>7480</trac> You can reset your network history in the Network control panel in case you need to remove old configurations. However, you will need to re-enter all AP passwords after doing this.

For a list of all closed bugs in this release click here.

== Notable open bugs in this release ==<nowiki>Insert non-formatted text here</nowiki>

For the best experience and maximum reliability with the XO we recommend the following best practices:

For all XOs

  • If you open too many activities (generally more than 3) at once you may experience slow response. To close activities, use the frame button (upper right), hover over the open activities, and click on close.
  • In general, you do not need to double click on anything in the XO interface. It is designed for a single click. For example, double clicking to launch an activity will cause the XO to launch two instances of the activity which may cause one to fail.
  • Drag and drop has limited support in this release. It may work in some cases but it does not work consistently everywhere.
  • Power save mode is still in development. In this release it is turned off by default in the control panel. If you use it and experience problems, please turn it off.
  • If the XO stops collaborating or stops responding, you can reboot it from the home screen (hover over the XO in the center) or hold down the power button for more than 6 seconds.
  • Ensure that you have unmounted a USB stick before removing it. Go to the Journal, hover over the USB stick icon and click on 'unmount'. Another method to remove a USB stick and avoid corruption is to power down the laptop before removing the USB stick..

For XOs used in school with many XOs present

  • Reliable collaboration using the Write activity over mesh or access point networks may not exceed two hours. If there are a lot of XOs or a lot of wireless traffic (e.g. many XOs or many access points) then Write may shut down during collaboration. In this case you may be able to reconnect Write to the collaboration in the Neighborhood view.
  • When collaborating over a Mesh (i.e. XO to XO collaboration with no access point or school server) you should limit the number of XOs on any channel to 10. There are three Mesh channels available (1,6 and 11) and each should have a maximum of 10 XOs. More XOs in a channel may cause instability in the collaboration.


  • Please see the Deployment Support pages for information on collaboration and connectivity in schools or areas that are densely populated with XOs.

Click here for a more detailed list of open bugs


  For Developers

API Changes

Release 8.2.0 incorporates version 0.82.1 of the Sugar UI.

API changes documents Sugar and system API changes since release 8.1.x.

Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=Release_notes/8.2.0&oldid=290882"