Release notes/8.2.0

NOTE: The contents of this page are not set in stone, and are subject to change! This page is a draft in active flux ... Please leave suggestions on the talk page.

  This page is monitored by the OLPC team.

  For the general public

Steps to Take Before Upgrading to this Release

• If you are in a school or other Deployment, make sure you contact your technical support team before upgrading. Some deployments have special configurations which will need special steps taken before upgrading or may not be able to upgrade at all.

• Determine which release you are on and whether you plan to upgrade over the Internet or via USB stick. Then, choose an upgrade method from the available upgrade options.

• Determine the version of your activities. Decide if you need to re-install or upgrade them and make sure you have access those them. See the list of activities you must upgrade, and go here for instructions on how to reinstall all activities.

New Features in 8.2.0

GUI and Usability Improvements

Home View Redesign

Home View

There are now three distinct view options in the Home zoom level.

• 

  Home Freeform view

• 

  Home Ring view

• 

  Home List view

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.

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

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 Redesign

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.

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 now appears in the bottom edge of the Frame, where its readily available. 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.

Updated Journal

The new software includes an updated Journal as well, which closely resembles the old one, but has a cleaner look and some additional features 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.

Getting more details

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 the below options. More detailed instructions can be found here.

• 

  Sugar Control Panel
  Graphical interface for setting many XO preferences.

• 

  Language
  Allows selection of the default language.

• 

  Power
  Enables power saving modes. See Improved Power Management section below for more details.

• 

  Frame
  Sets the time it takes the Frame to appear when the cursor is on the corner or on the edge (side) of the screen.

• 

  About my XO
  Shows the build number, firmware version and serial number.

• 

  Software Updates
  Checks for latest version of activities and optionally upgrades them

• 

  Date & Time
  Allows setting of the Timezone. Note: this function no longer needs Super User access.

• 

  About Me
  Sets the name and color of your XO icon. These values are seen by other XOs when using collaboration.

• 

  Network
  Allows turning off the wireless radio and identifies a school server for collaboration

• Language
• Power
• Frame
• About My XO
• Software Updates
• Date & Time
• About Me
• Network

• Technical details at <trac>7380</trac>

New Activity Updater

This release introduces an automatic finder/updater for latest Activities. Since we separated the OS from Activities in the builds, it has been difficult for people to get the latest activities after upgrading to a new build. Also, if you upgrade from 656 to the new builds, you would not otherwise get activities at all, so this feature will be important.

After upgrading the build (using olpc-update <build stream-number>); then go into the Sugar Control Panel and click on 'Software Updates'.

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 to the school server that it is registered to at least once per day.

To get back to a previous days backup, from the XO, open browse, click on the Schoolserver button, and choose the day you wish to back up to. All user data will be replaced, so this is meant to be a disaster recovery.

• <trac>7392</trac> Disaster-recovery backup+restore w/ XS
• http://wiki.laptop.org/go/Ds-backup
• http://wiki.laptop.org/go/XS_Blueprints:Datastore_Simple_Backup_and_Restore#Test_plans_and_user_walkthrough

Longer Battery Life

This feature is implemented via the Sugar Control Panel. It is off by default so you must enable it in the Sugar Control Panel, power section to take advantage of it.

The feature offers two options:

• Automatic power management

This mode dims the screen and turns off the CPU when it switches the laptop to power saving mode. Power saving mode comes on automatically when the user does not interact with the touchpad or keyboard for more than a minute and when no activities are heavily using the CPU on the XO. For example, power saving mode would not be turned on if the video camera is recording or showing video on the screen, regardless of whether the user touches the keyboard or not. The laptop will wake up when a key (or the power button) is pressed or the touchpad is used.

• Extreme power management

This mode turns off the wireless radio. Once this mode is turned on the XO wireless network connection will disconnect. This is the most aggressive power saving mode available when combined with Automatic Power Management, and will give the longest battery life.

A third sleep mode is entered when the lid is closed or the power button is pressed momentarily (holding the power button for more than a few seconds will turn off the laptop completely). This mode differs from the automatic mode in that keypresses and touchpad usage will not wake up the laptop -- to leave this mode, open the lid or press the power button again. The "Extreme power management" mode will still control whether the wireless radio remains on or not when suspend is invoked manually.

Details on the software implementation at <trac>7384</trac>

Improved Cursor Control (not confirmed)

It is better but if you still experience problems where the cursor moves unexpectedly, the touchpad may be trying to recalibrate. It cannot recalibrate accurately while you are touching it. So taking your finger off the touchpad for 10 seconds may help solve problems of unexpected cursor movement.

Collaboration Improvements

<trac>7387</trac> Server-based Collaboration Scalability Improvements (Gadget)

This didn't make the feature freeze and is still being developed. Perhaps release 9.1...--morgs 14:03, 17 July 2008 (UTC)

<trac>7389</trac> Collaboration and Presence Bug fixing

There are newer versions of the telepathies in, but we don't have a specific list of fixes yet. Perhaps the changelogs for telepathy-gabble and telepathy-salut will help. --morgs 14:07, 17 July 2008 (UTC)

<trac>7390</trac> Alternate Collaboration Technology (Cerebro)

This is in the build, but isn't integrated so existing activities can't use it. So its main benefit right now is network testing. --morgs 14:07, 17 July 2008 (UTC)

Note -- this feature is not stable. It's API will change. However, you can probably use it to build collaborative activities that are much faster and more reliable than with other mechanisms, so we think it's worth playing with.

New Keyboard Support

TODO: Announce new languages supported, like GNOME does.

All keyboards supported include:

• Spanish, OLPC_Argentina_Keyboard
• Portuguese, OLPC_Brasil_Keyboard
• Amharic, OLPC_Ethiopia_Keyboard
• Arabic, OLPC_Libya_Keyboard
• Thai, OLPC_Thailand_Keyboard
• Urdu, Urdu_Keyboard
• Cyrillic, Cyrillic_Keyboard
• Turkish, OLPC_Turkey_Keyboard
• Nepali, OLPC_Nepal_Keyboard
• Mongolian, OLPC_Mongolian_Keyboard
• Devanagari, Devanagari_Keyboard
• Dari, Dari_Keyboard
• Khmer, Khmer_Keyboard
• Italian, Italian_Keyboard
• French-Canadian, French_Canadian

Activity Related Improvements

Activities start faster than in previous builds.

<trac>7382</trac> Browser Improvements Auto-complete now available!

<trac>6036</trac> Chat enhancement

New OS (Fedora 9)

Improves security over Fedora 7

Master trac ID: <trac>7383</trac>

Improved Flash compatibility

OLPC ships Gnash, an open source flash movie player integrated into the Browse activity. This release includes an automatic update from Gnash-0.8.1 to Gnash-0.8.3.

The newer version of Gnash increases compatibility with many sites. For example, Caillou animation rendering was incorrect in previous releases, but now appears to work correctly.

Upgrading from Previous Releases

Before upgrading, you should know that upgrading is a very strict and a very important process. So you should be sure to read and carefully follow these instructions and be sure to have enough time to do the full process before you begin.

Also, during development and until 8.2.0 becomes a release candidate, you will need a developer key in order to install an 8.2 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.

Here are the steps to upgrade:

1. Plug the XO into AC Power
2. Connect XO to the internet
3. Launch the update command
4. Reinstall the activities
5. Upgrade 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 Wifi Connectivity for instructions. Use Browse activity to test your connection.

Step 3: Launch the update command

Open the Terminal Activity or a console and type the following (press the Enter key after it):

sudo olpc-update build-number 

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

Downloading contents of build build-number
Updating to version hash xxxx
Making clean /versions/updates/...
Trying irsync_pristine update from rsync://updates.laptop.org/build-build-number
- Cleaning tree.
- Fetching contents.
- Performing incremental rsync.
Verifying update.
Installing update in /versions/{pristine,run}/xxxx

This process may take more than thirty minutes. When the process is complete, you need to reboot.

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>

Step 4: Reinstall activities

Starting from build 699, the OS image is separate from the activities. This means that if you are upgrading from a build prior to 700, such as the original G1G1 "Ship.1" software, you will lose all you existing activities! If you are upgrading from any release after build 699 such as "Update.1" or 8.1.1, the build is already separated from the activities and you will not lose your existing activities so you could skip this step and go directly to step 5.

To re-install the activities after upgrading, follow these instructions:

1. Download the G1G1 Activity Pack (from 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.

 /boot
 /bundles
 customization-2

2. Plug the XO into AC power and connect it to the internet.

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

4. Remove the USB flash drive. Connect the XO to AC power, so that it will be able to proceed if it determines that a firmware update is needed. Then power on your XO as per usual.

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 using wget and unzip.
• 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.

Except G1G1 activity pack, some commonly installed activity packs include the:

• Peru activity pack
• Nepal activity pack
• ...more activity packs

(The Nepal activity pack contains some 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.

Step 5: Upgrade activities

Can't use newer activities on older images.

Some activities need upgrade to work correctly on 8.2.0. Following is the activities which need upgrade:

• Browse-91 (and older versions) will fail to download files and install .xo/.xol bundles. Upgrade to Browse-92.
• 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>

The "Software updates" panel in the new graphical Sugar Control Panel in 8.2 offers to install some of these newer versions if you have older versions installed. (Confirmed for Browse, Pippy, and Record.)

Resolved Bugs In This Release

http://dev.laptop.org/report/22

<trac>7532</trac> allow activity bundles install from USB (still awaiting QA confirmation)

5987 flash plays better (e.g. pbskids.org

6014 better but not complete. We recommend closing activities before shutting down.

4208 battery indicator works better

synch with browse section:
5156 google calendar works.

5613 - important for localization (check if its regression)

Notable Open Bugs In This Release

All known open bugs (defects) in this release are 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 or send a note to devel@lists.laptop.org

• <trac>6253</trac> document workaround.
• <trac>6388</trac> don't put USB and SD card at the same time. It must be one or the other.
• <trac>6467</trac> mesh view takes a while to fill in after suspend.
• <trac>6944</trac> icon color off in some edge cases with APs
• <trac>7537</trac> olpc-configure marks all of /home/olpc as read/exec
• <trac>7158</trac> Upgrade from 656 to 703 leaves su unusable when you fallback to 656.
• 7509
• 7511
• 7513 Sharing is limited in time. Cannot share overnight
• 7531
• 7533 clipboard issues are know. Only things tested in smoke test will work.(edit)
• 7622
• 7627
• 7642
• 7649
• 7713
• 7726
• 7733
• 7742 don't double click on activities
• 7754
• 7775
• 7785
• 7426
• 7812 work around is holding down the power button.

7821, 7823, 7824 cancel and OK buttons need explaining

• 7825 Some WPA APs will not work due to this bug. Only the ones we have tested should work properly. They include ...
• 7870 need to use new network reset GUI 7480 to work around this and other network issues
• 7873 and 7874 should be noted unless fixed
• 7877
• 7876 Don't double click on activities to launch them!
• 7888 (note to self, also check sharing page to make sure it says Paint doesn't share)
• 7890

clipboard not consistent (add details and bug ids)

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>4539</trac> Sharing in Etoys only works if the laptops are in the same network (on same mesh channel, or connected to same access point). ?need to test
• <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

Network-related issues

<trac>6448</trac> must use mesh or AP but not both.

There are many open mesh and collaboration bugs. Work is being done in that area in this release but it is not confirmed yet.

After downloading a PDF, you can choose "Show in Journal" or "OK". To open the PDF in the Read activity, choose "Show in Journal" then click on the item in the Journal and it will open in the Read activity.

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. See <trac>7825</trac> for technical diagnosis.

<trac>5501</trac> it takes some time for the link-local presence information to stabilise.

When switching an olpc between (mesh) networks, avahi doesn't get the time to announce it is leaving the network. So other XO's aren't immediately informed that someone has switched networks. This means that in XO's that have switched will stay present in the mesh view for some time.

Tips and Tricks

This is a list of short cuts and tricks for power users of the XO.

These are not all tested and confirmed working in all circumstances so please use with caution.

5571 copy to and from datastore (journal) at CLI

New Keyboard Shortcuts

Some keyboard shortcuts have changed; the list of all keyboard shortcuts is at:
http://wiki.laptop.org/go/Keyboard_Shortcuts/8.2.0

Screen Grab

Alt-1 will capture a screenshot within Sugar; the resulting image will appear in the Journal.

Cursor Fine Tuning

e.g. an explanation of how to tweak cursor interaction at the CLI

Magnifying glass key

Zoom levels.