Release notes/623: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(110 intermediate revisions by 16 users not shown)
Line 1: Line 1:
{{outdated}}
{{OLPC}}
{{OLPC}}
{{Latest Releases | firmware = inline | extra = inline }}
{{TOCright}}
{{TOCright}}
=OLPC Trial-3 Software Release Notes=
{{Release Notes}}
This page details a stable software image, '''Ship.1''', formerly known as "Trial-3" that was released on 2007-10-29.
This page details the current stable software image. Important changes are [[#Important Notes|noted below]]. This image is "late beta-test" software; there is much you can now do with the laptop out of the box (See [[542 Demo Notes]]). General – somewhat outdated – instructions on how to use the Sugar interface can be found [[Sugar_Instructions|here]]. Also of note are the [[OLPC_Trial-2_Software_Release_Notes|Trial-2 Release Notes]]. These latter pages detail issues with particular versions of the hardware. The [[Library Release Notes]] page has information about the early stages of our sample content library. Finally, the [[OLPC Human Interface Guidelines]] describe our vision of where we are heading, only partially reflected in our current software.
There have been numerous releases since this, everyone should [[update paths|update to a later release]].

Important changes are [[#Important notes|noted below]]. This image is "late beta-test" software;
using it there is much you can do with the laptop out of the box (See [[542 Demo Notes]] and [[608-demo-notes|608 Demo Notes]]). General – somewhat outdated – instructions on how to use the Sugar interface can be found [[Sugar_Instructions|here]]. Also of note are the [[OLPC_Trial-2_Software_Release_Notes|Trial-2 Release Notes]]. These latter pages detail issues with particular versions of the hardware. The [[Library Release Notes]] page has information about the early stages of our sample content library. Finally, the [[OLPC Human Interface Guidelines]] describe our vision of where we are heading, only partially reflected in this release.


The software is just maturing to the point where we can embark upon later-stage trials for feedback and polish. Please review the [[#Notes]] below and please report any new bugs to our trac system (See http://dev.laptop.org).
The software is just maturing to the point where we can embark upon later-stage trials for feedback and polish. Please review the [[#Notes]] below and please report any new bugs to our trac system (See http://dev.laptop.org).
Line 12: Line 16:
* Presence service
* Presence service
* Easy real-time collaboration in many of our activities including:
* Easy real-time collaboration in many of our activities including:
** Read, Write, Chat, Record, EToys, TamTam Jam, Memorize, Connect4
** Read, Write, Chat, Browse, Record, Etoys, TamTam Jam, Memorize, Connect, Calculate, and Measure
* Mesh networking
* Mesh networking
** Automatic configuration of ad-hoc meshes, allowing collaboration without any infrastructure or Internet access
** Automatic configuration of ad-hoc meshes, allowing collaboration without any infrastructure or Internet access
Line 23: Line 27:


Remaining tasks:
Remaining tasks:
* Bug Fixes for First Deployment
* Bug fixes for first deployment


==Important Notes==
==Important notes==
At this time, '''we do not recommend installing the Trial-3 software on B2 systems''' due to excessive RAM and CPU usage.
At this time, '''we do not recommend installing the Trial-3 software on B2 systems''' due to some driver incompatibilities and excessive RAM and CPU usage.


==Stable builds==

The release notes on this page apply to the stable software release: [http://olpc.download.redhat.com/olpc/streams/development/build623/ '''Build 623'''] (2007-10-29). We recommend that you follow the instructions found on the [[Autoreinstallation image]] page to upgrade to this image. If you are already at build 612 or higher, you can upgrade using the ''olpc-update 6xx'' command from a virtual terminal. (Information regarding the latest development builds – non-stable builds – can be found here: [[Test_Group_Release_Notes]].)
==Stable Builds==
The release notes on this page apply to the latest stable software release: {{Latest Releases/stable}}. We recommend that you follow the instructions found on the [[Autoreinstallation image]] page to upgrade to this image. If you are already at build 612 or higher, you can upgrade using the ''olpc-update 6xx'' command from a virtual terminal. (Information regarding the latest development builds – non-stable builds – can be found here: [[Test_Group_Release_Notes]].)


;{{ticket|1748|USB Update key needed to upgrade systems in the field}}: Note that the [[Autoreinstallation image]] has latent support for preserving the user files on the system in the ''olpc.fth'' file. The USB key must be large enough to hold both the image to be installed and any and all files the user may have created in /home/OLPC.
;{{ticket|1748|USB Update key needed to upgrade systems in the field}}: Note that the [[Autoreinstallation image]] has latent support for preserving the user files on the system in the ''olpc.fth'' file. The USB key must be large enough to hold both the image to be installed and any and all files the user may have created in /home/OLPC.




=Base System Notes=
=Base-system notes=
The system is now based on [http://fedoraproject.org/relnotes.html Fedora Core 7], and [http://dev.laptop.org/git.do?p=olpc-2.6;a=summary OLPC's kernel] is based on [http://lwn.net/Articles/240973/ Linux 2.6.22].
The system is now based on [http://fedoraproject.org/relnotes.html Fedora 7], and [http://dev.laptop.org/git.do?p=olpc-2.6;a=summary OLPC's kernel] is based on [http://lwn.net/Articles/240973/ Linux 2.6.22].


==Suspend/Resume and Power Management==
==Suspend/resume and power management==
;{{ticket|60|Suspend/Resume}}: Note that a number of the bugs in the tracker bug are likely duplicates. Suspend and resume using the power button currently wakes up for various types of wireless LAN traffic.
;{{ticket|60|Suspend/Resume}}: Note that a number of the bugs in the tracker bug are likely duplicates. Suspend and resume using the power button currently wakes up for various types of wireless LAN traffic.
''Placeholder for suspend/resume bugs''


==Other==
==Other==


'''New Features:'''
;{{ticket|2319|Horrible noise in TamTam upon resume}}: Start TamTam. Close lid. Wait 3 seconds. Reopen the lid: Bad noise. Close lid. Noise stops Wait 3 seconds. Reopen the lid: BAD noise. Close lid. Noise stops. etc etc... Nothing short of shutting the system down will cure this noise. Needless to say, we'll fix this as soon as possible. This can also occur with games that may have audio playing; it is not TamTam's fault.


[[608-demo-notes|Demo notes of new features]]
;{{ticket|1905|Field Return: flash corruption - OpenFirmware complaining of 'unknown node type}}: If you see this, please add your serial number information to this trac ticket.


Private invitation:
;Activity sharing: will only work correctly when all XOs that wish to participate are using the same connection method. I.e., all must be either ''only'' link-local, or ''only'' server-connected.
# Start an activity (such as Write);
# From either the Neighborhood (Mesh) view or the Friends view, find someone with whom to share;
# Hover over the XO icon of the invitee and click on 'Invite' (This sends an invitation to participate in your current activity);
# The invitation will appear as an icon in your colors on the taskbar tray of the invitee's laptop;
# This activity is started by clicking on it (in the usual manner of all activities), but it starts up as a shared activity.


Sharing a bookmark in Browse:
;[[Customizing NAND images]]: It is easy to customize a build for your own environment, as outlined here.
# Open the browser;
# Share the activity either by issuing a private invitation as per above or by selecting 'share with neighborhood' from the menu under the Activity tab;
# Go to a URL of interest;
# From the Browse tab, click on the star in the upper right of the toolbar (This will create a bookmark that appears in a tray at the bottom of the activity window on each laptop that is sharing the activity);


'''Open Issues'''
;Python Performance: Python 2.5 has much better heap performance. The Geode LX processor in BTest-3/4 has again greatly increased performance due to its larger cache..


*Network connectivity
;{{ticket|623|Booting time continues to improve}}: We understand where much of the rest of the boot time is currently going, as you can see by checking the bugs referred to in 623. Boot time, however, is not our highest priority; suspend/resume is clearly more important.
** An XO that is acting as an MPP (mesh portal point) cannot participate in local mesh collaboration. (Until there has been more testing for an XO acting as an MPP vis-a-vis mesh collaboration, we have diabled automatic MPP mode. To manually enable this mode, please refer to the instructions [[Test_Config_Notes#Turn_on_MPP_Capability|here]].)
** Some activities share well in link-local; but don't share properly over the internet using the Jabber server. Activities that don't share well across the internet (G1G1) include Record photos and video (audio?), book reader, eToys, large files in Abiword may cause the activity to stop sharing. (This has been fixed in subsequent versions of the sharing/network software.)


* Connect to an Airport Extreme access point with a WEP key.
;{{ticket|217|Battery problems}}: (including {{ticket|217|failure to charge}}, {{ticket|667|overcharge}}, {{ticket|596|incorrect capacity reporting}}, {{ticket|553|battery draining quickly when turned off}}) All known battery charging problems have been resolved. Note that for long term storage, removing the battery pack after a full charge is best practice; this is true for all battery powered devices. A raft of problems with batteries has been fixed by EC firmware patches up through Q2B83. Most, but not all, dead batteries can be recovered in the field with existing BTest-2 systems (See [[Battery Charging]] for more details). {{ticket|1051|LiFe batteries incorrectly flash red light}} was fixed in firmware Q2B87. On BTest-2 systems, average NiMH lifetime in a test of multiple machines (Screen on, backlight fully on, wireless associated, all functional units including GPU on, but processor idle) was tested to be approximately 2h40m, LiFePo batteries were approximately 3h 10m, using BTest-2 systems. Early tests with BTest-4 systems show an idle system lifetime (no suspend) between four and five hours, depending on circumstances and battery type. The LiFePo batteries have significantly higher lifetime. This will improve as our power management improves and remaining unused devices are powered down when not in use.
** You need to follow these steps when you login in the Airport configuration utility:
*# Choose a network security level of 40-bit or 128-bit WEP.
*# Set any password(you may tick the plain text option) and Update.
*# After the update login again and note the HEX password in the summary view.
** On the XO neighborhood view click the access point.
*# In the security popup type $:XXXXX, where XXXXX is the HEX password.
*# Choose the Shared Key option.
** If the AP changes or removes its WEP key, the XO will not realize it directly. You will need to
*# Remove /home/olpc/.sugar/default/nm/networks.cfg
*# Reboot


* Save photos
;[[RestrictedFormats]]: In some jurisdictions, patents on algorithms apply, and royalty payments may be required. Examples include MP3, and MPEG-4. This is a particular nuisance for media players, for which many of the common codecs algorithms are patented. In other jurisdictions, software patents do not apply and there are usually freely available implementations for these algorithms available. Sometimes, as in Adobe Flash, or the Real Helix player there are free (as in beer) implementations available, where those corporations have paid these patent royalties and made usually (binary) versions of codecs available. This has direct consequences as OLPC does not want to burden all machines with what may be unnecessary duplicate patent royalties: OLPC must therefore leave the customization of the distribution for these formats for "in country". For jurisdictions in which such patent laws apply, there are now solutions such as those sold by [http://www.fluendo.com/ Fluendo] to these issues. The Flash format (whether Adobe's Flash 9 or Gnash) illustrates this problem well; even though we can include gnash, as built it does not have support for MP3 or MPEG-4, which should work correctly if Gnash is rebuilt.
** Record has changed a lot, and as a result, old entries cannot be opened on the new build
** Follow these steps to save photos; unfortunately, videos will be lost.
*# Drag photos from record onto the clipboard.
*# Scroll over the clipboard images, and select "add to journal"
* Sharing a Write document works well for text, but if you add too many images (large docs) don't share properly.
::This is fixed in future builds.


* Journal
;{{ticket|1292|JFFS file system pathological use}}: Writing log files (or similar files) one short piece at a time (unbuffered) and then flushing them to stable storage is bad for the flash, as it causes many unnecessary writes to the flash; much better would be to defer such writing until some amount of time has passed, and then flush, so that multiple small writes can be merged into a single write. Do not build applications with such behavior.


* Sugar
;{{ticket|68|Network adapter causes slowdown}}: Fixed in Q2B81 firmware and later. Any network adapter, if configured, (including the built in Marvell wireless) would cause the system to slow as much as 33%.
** The battery indicator on the home sugar page only updates when the power adapter is plugged in or removed. {{ticket|2861}}
** If the network neighborhood mesh view stops showing other laptops or access points, reboot sugar with CTL-ALT-ERASE


;Flash and system installs off SD: You can install the flash and system image off an SD card. Rather than using the "disk:" in the instructions for reflashing, you can install using the name "sd:". The auto updater does not work off of SD, however, at this time.


Transporting photos, audio, and video from Record to USB sticks (Clipboard objects don't work)
;[https://bugs.freedesktop.org/show_bug.cgi?id=10900 fontconfig cache is invalidated too easily on mtime check]: Applications can take a <i>very</i> long time to start, due to a fontconfig caching bug provoked by the time being set incorrectly (which can happen easily if the battery is replaced or the time is set badly). To work around this problem, use the "date" command from a console to set the current time and date.
# Drag media to the clipboard
# The files will be automatically added to the journal (named Audio by {XO_name}, Video by {XO_name}, and Photo by {XO_name}
# Drag these files from the journal to the USB stick, and any other laptop will be able to see and open them.
#*If you add the clipboard objects to the journal, they will not save correctly.
#*These objects will be able to be opened with different activities, but if you transfer them to a USB, you will not see them.
#*Changing the names of the items in the journal will force them to create correct names and file extensions.
#*After changing the name, drag the item from the journal to the USB stick.
#*Now, a non-XO laptop will be able to see and open the items on the USB stick.


==[http://www.x.org X Window System]==


'''IMPORTANT''' (unless we are going to have people install the rpm's to use olpc-update instead of doing the upgrade with a USB stick)
;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=x+window+system&order=priority X Window System open issues]: specific to OLPC are found in trac.
* You must have the laptop plugged in with the AC adapter to upgrade firmware. Otherwise you will get a failure message; and you may need to boot on the backup image (holding down the gamekey O while booting) to try the upgrade again.
* Update to latest firmware before updating to latest image.
** The new firmware (Q2C28 and later) will check that the image is not corrupt before installing it, whereas the old firmware will wipe the nand and then run into trouble trying to install the new image.
** Basically, using the new firmware will keep you safe from possibly losing your data due to a corrupt image.


;Performance optimization: Much performance optimization work is possible, and awaits our time or volunteers to work on. Some work has been done by Jordan Crouse and others and performance is substantially better than initially.


Note that for long term storage, removing the battery pack after a full charge is best practice; this is true for all battery powered devices.
;B1 Touchpads: The BTest-1 touchpad worked particularly badly: much of this is caused by capacitive issues; a mylar sheet increased the capacitance and BTest-2's touchpad now functions pretty well. The writing (stylus) mode of the touchpad is enabled and works correctly in BTest-2, although additional software work is needed. When taking a unit off of power supply onto battery (or vice versa), the touchpad may need recalibration: simultaneously press the four keys in the extreme corners of the keyboard. BTest-4 touchpads seem to be more stable.


;[[RestrictedFormats]]: In some jurisdictions, patents on algorithms apply, and royalty payments may be required. Examples include MP3, and MPEG-4. This is a particular nuisance for media players, for which many of the common codecs algorithms are patented. In other jurisdictions, software patents do not apply and there are usually freely available implementations for these algorithms available. Sometimes, as in Adobe Flash, or the Real Helix player there are free (as in beer) implementations available, where those corporations have paid these patent royalties and made usually (binary) versions of codecs available. This has direct consequences as OLPC does not want to burden all machines with what may be unnecessary duplicate patent royalties: OLPC must therefore leave the customization of the distribution for these formats for "in country". For jurisdictions in which such patent laws apply, there are now solutions such as those sold by [http://www.fluendo.com/ Fluendo] to these issues. The Flash format (whether Adobe's Flash 9 or Gnash) illustrates this problem well; even though we can include gnash, as built it does not have support for MP3 or MPEG-4, which should work correctly if Gnash is rebuilt.
;Tap on the touchpad: It may be possible to implement "tap" on the capacitive touch pad; we'd be interested in hearing opinions whether this is desirable for a child or not.


;[https://bugs.freedesktop.org/show_bug.cgi?id=10900 fontconfig cache is invalidated too easily on mtime check]: Applications can take a <i>very</i> long time to start, due to a fontconfig caching bug provoked by the time being set incorrectly (which can happen easily if the battery is replaced or the time is set badly). To work around this problem, use the "date" command from a console to set the current time and date.
;Keyboard autorepeat:has been "tuned". Most keys do not autorepeat, except for the arrow keys, erase key, space bar, and game pad and buttons by the screen.


==[http://www.x.org X Window System]==
;{{ticket|2617|Camera activity provokes X to screw up colormap on B2's}}: The X Window System Xvideo extension is supported in the X server; note that a slightly different colormap is loaded while video is playing to improve video quality; other colors in use may become slightly strange during this period. Note that there is a miswiring from the Geode to the DCON chip, fixed in BTest-3 and BTest4, that complicates this problem. The LX processor won't have this problem at all; the RGB-YUV conversion is correct on that video unit. '''This is only a problem for B1 and B2 systems.'''

;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=x+window+system&order=priority X Window System open issues]: specific to OLPC are found in trac.


==User Interface: [[Sugar]]==
==User Interface: [[Sugar]]==
Line 86: Line 131:


;Suspend: Momentarily press the power button.
;Suspend: Momentarily press the power button.

;Performance: Sugar performance has improved, particularly on the Geode LX processor found on B3 and later systems. The [[Journal]] is now capturing a log of all activities on the laptop and can be used to search and sort through old work and relaunch activities.


;Screen Capture: Alt-1 does a screen capture and stores the result in the Journal.
;Screen Capture: Alt-1 does a screen capture and stores the result in the Journal.


;USB Keys: USB keys are automatically mounted and their contents are viewable from within the Journal. Files can be dragged from the Journal or Clipboard onto the USB key from within the Journal. (USB file systems are still accessible from console and the developer's console through the standard Linux mechanisms.)
;USB Keys: USB keys are automatically mounted and their contents are viewable from within the Journal. Files can be dragged from the Journal or Clipboard onto the USB key from within the Journal. (USB file systems are still accessible from console and the developer's console through the standard Linux mechanisms.)

;Mime Types: only a single activity can declare they handle a given mime type; the Journal does not yet provide a way to select which activity will be started.


[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=sugar&order=priority Many of the user interface issues] we intend to fix. Among the most notable issues are:
[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=sugar&order=priority Many of the user interface issues] we intend to fix. Among the most notable issues are:
;{{ticket|989|New networking UI needs documentation}}: To choose a network, push the first of the four circular "mesh view" keyboard buttons (or "F1" in an emulator), hover over each triangle until you find the access point you want to associate with, and then click on it. (Note that the access points are color-coded based upon a hash of the AP SSID. Therefore, once you learn the color of your desired access point, you can subsequently find it quickly.) The mesh, rather than being a triangle, is represented by a circular icon. You may be prompted for an access point's password.
;{{ticket|989|New networking UI needs documentation}}: To choose a network, push the first of the four circular "mesh view" keyboard buttons (or "F1" in an emulator), hover over each triangle until you find the access point you want to associate with, and then click on it. (Note that the access points are color-coded based upon a hash of the AP SSID. Therefore, once you learn the color of your desired access point, you can subsequently find it quickly.) You may be prompted for an access point's password.

;Network Autoconfiguration: an XO will now autoconfigure the network. If no Internet access can be found, an ad-hoc mesh will be formed using private networks. If an XO is either associated with a conventional access point or preferably interfaced via a ethernet USB interface, it will automatically become a mesh portal point (MPP), and gateway the mesh network to the Internet. It will also associate with conventional access points using WEP or WPA. If it associates via WEP or WPA, the mesh portal functions cannot work, however.

;{{ticket|2019|WPA support}}: has been implemented in the most recent builds, to allow association with WPA enabled access points. If you have problems, please use the developer's console and execute the command ''touch /etc/NetworkManager/log-supplicant'' and try again. Please attach the resulting log files ''/var/log/messages'' and ''/var/log/wpa_supplicant.log'' to a trac ticket, along with the exact manufacturer and model of the access point.


;Network Autoconfiguration: an XO will now autoconfigure the network. If no school server mesh, or previously connected Infrastructure Access Point can be found, an ad-hoc mesh will be formed using private networks. It will also associate with conventional access points using WEP or WPA. If it associates via WEP or WPA, the mesh portal functions cannot work, however.
;Bulletin board (shared workspace): support is not yet integrated into Sugar in a general way; harbingers of how it will work can be seen in the shared workspace in the Record activity.


;Clipboard interaction (on the Frame): is not fully developed in all activities. Some activities can copy and paste (using Ctrl-C and Ctrl-V) to and from the clipboard and some even support drag and drop to and from the clipboard, but many do not.
;Clipboard interaction (on the Frame): is not fully developed in all activities. Some activities can copy and paste (using Ctrl-C and Ctrl-V) or drag to and from the clipboard, but some do not.


;Groups: are not yet exposed in the interface. Sharing, chat, etc. are only supported at the mesh level (open to everyone on the mesh).
;Groups: are not yet exposed in the interface. Sharing, chat, etc. are [[share with neighborhood|shared with the neighborhood]] (open to everyone connected to the mesh) or by [[invite|invitation]] to individuals (and groups, where the invitations are issued one at a time).


==Presence Service==
==Presence Service==
Line 112: Line 149:
;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=milestone&component=presence-service&order=priority PS open issues]: can be found in trac
;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=milestone&component=presence-service&order=priority PS open issues]: can be found in trac


;Connections: [http://telepathy.freedesktop.org/ Telepathy] connections are supported via the school server - a [http://www.jabber.org/ jabber] [http://www.xmpp.org/ XMPP] server with some particular required [http://www.xmpp.org/extensions/xep-0163.html features] - as well as over the mesh network using [http://www.xmpp.org/extensions/xep-0174.html Link Local XMPP].
;Connections: [http://telepathy.freedesktop.org/ Telepathy] connections are supported via the school server - a [http://www.jabber.org/ jabber] [http://www.xmpp.org/ XMPP] server with some particular required [http://www.xmpp.org/extensions/xep-0163.html features] - as well as over the mesh network using [http://www.xmpp.org/extensions/xep-0174.html Link Local XMPP]. If you have no Internet access, link local is the default and you will see XOs in Neighborhood view who are on the mesh network. If you do have Internet access, link local presence will be switched off and you will only see XOs who are connected to the server.


;Default Server: Build 542 no longer registers automatically with olpc.collabora.co.uk as the server, so [[#Laptop_Registration|registration]] is required before other XOs can be seen via the server.
;Default Server: The default XMPP server is now jabber.laptop.org, so if you have internet connectivity you should see other users from around the globe in Neighborhood view, via this server.


;Server Connections: Activity icons appearing in the mesh should disappear when everybody leaves that (shared) activity. However if the PS fails to announce somebody leaving (for example {{ticket|2616|quitting the jhbuild emulator with alt-Q while in the activity}}), then the {{ticket|1935|icon remains on the mesh view}}.
;Server Connections: Activity icons appearing in the mesh should disappear when everybody leaves that (shared) activity. However if the PS fails to announce somebody leaving (for example {{ticket|2616|quitting the jhbuild emulator with alt-Q while in the activity}}), then the {{ticket|1935|icon remains on the mesh view}}.


==[[Developer Console]]==
;{{ticket|2253|Large data over Tubes}}: On server connections, large messages (such as images) are not broken up into chunks and hence fail, breaking sharing.


The developer console provides a set of tabs in a popup window on top of activities. It is launched by typing <tt>Alt-=</tt>.
;{{ticket|2702|Link Local Connections}}: If you share an activity and are not the last to leave, you cannot rejoin the shared activity. This is being addressed for Trial 3.


* The ''XO Resources'' tab shows basic information about the system, the recent CPU usage and flash usage
=[[Activities]]=
Many activities are under development and they can be [[Activities|found with their status in the wiki]] while the [[Activity Grid]] has the status of all of the activities that have systematic testing.


* The ''Memphis'' tab returns information about executing processes. [http://dev.laptop.org/git.do?p=projects/soc-memphis Memphis])
==[http://wiki.laptop.org/go/Browse Web Browsing]==
;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=web+browser&order=priority Web Browser Open Issues]: can be found in trac.


* The ''Log Viewer'' tab allows exploration of many key system logs.
;{{ticket|542|SSL sites without official certificates fail to load}}


* The ''Terminal'' tab provides a terminal emulator and shell.
;{{ticket|884|Web activity has trouble with Arabic and Urdu fonts}}: This is being fixed upstream and should be in a future OLPC build.


* The ''Presence'' tab provides logs of the presence service in raw form (the mesh view is a graphical interpretation of these logs), to aid in debugging one of our key new services.
The Xulrunner based brower uses the scaling engine from Firefox 1.9. Starting in build 303, this greatly improves browser behavior and font and image sizes more likely to be acceptable. Later builds improve yet further. With our high resolution screen, we have had to go "first" in innovation in web browser technology. Performance work still needs to be done, particularly to speed scaling of images. Google Maps and Google Talk now both work well. Please let us know when you find web sites with clear formatting problems.


==[[Journal]] and Datastore==
Plug-ins should be installed in the directory /usr/lib/mozilla/plugins.
The Journal is a log of all of the activity on the laptop. The Journal uses the underlying [[Sugar_Architecture/API/sugar.datastore|Datastore facility]].


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=datastore&order=priority Datastore issues] are in our trac system.
The current version ship with an free version of Flash, called [http://en.wikipedia.org/wiki/Gnash gnash]; it has improved substantially from Trial-1. [[RestrictedFormats|Adobe's Flash]] plug in works fine, which many may find preferable until gnash matures further. As noted in [[RestrictedFormats]], we cannot distribute gnash with patented codecs, though gnash can be rebuilt to support a wide range of datatypes.


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=journal-activity&order=priority Journal issues] can be found in our trac system.
The web browser does not ship with Java plug-in. [[RestrictedFormats|Sun's Java]] and web browser plug-in work fine.


* The datastore indexes all information on an external device; this issue—{{ticket|2627|Datastore should check versions and recreate indexes automatically}}—has caused some trouble during its development, which we hope to prevent in the future.
The web browser has no tabs, no zoom (yet), no provision for ebook mode (yet).


* Removable media support is now present. When a USB key is inserted, Sugar will now automatically mount the USB stick and put an icon on the bottom of the journal; if you click on the icon, the journal on the USB stick will be shown. You can also unmount the stick using that icon by using the pop-up menu. On an external device, the file name bears some resemblance of the name that may have been given to the journal entry, so you should be able to take a FAT formatted USB stick from an OLPC and mount it on Linux, Windows or MacIntosh to interchange files; on the JFFS2 file system right now it is simply a numeric has, which is arguably unfriendly.
User experience has problems with pop windows, Frame interfering with scrolling.


=[[Activities#Preinstalled Activities|Pre-installed Activities]]=
==[http://wiki.laptop.org/go/Calculate Calculate]==
A number of activities come pre-installed on the laptop. Instructions on loading additional activities is found [[#Additional Activities|here]].


==[[Chat]]==
A simple calculator activity contributed by Mauro Torres et al. of the Tuquito Linux project in Argentina was replaced by a completely unexpected, more functional Calc activity written by Reinier Heeres at Harvard in build 385. Our thanks to both Mauro and Reinier for their efforts.
[[Image:Chat.png]] Activity Version = 24


[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=chat-activity&order=priority Chat open issues] can be found in trac.
==[http://wiki.laptop.org/go/Chat Chat]==
;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=chat-activity&order=priority Chat open issues]: can be found in trac


Chat has been restored to our builds. It now uses the Presence Service, so instead of a global chatroom, if you start Chat from the frame it will create its own room for you. When others join in the Neighbourhood view, the activity shows who has joined or left, and if you join it will display those who are already in the chat room.
Chat has been restored to our builds. It now uses the Presence Service, so instead of a global chatroom, if you start Chat from the frame it will create its own room for you. When others join in the Neighborhood view, the activity shows who has joined or left, and if you join it will display those who are already in the chat room.


* Use either "[[share with neighborhood]]" or "[[invite]]" to advertise your chatroom to other people.
It will convert URL's to clickable links for the web browser, and is a way to browse together until the web browser has shared browsing.


* There is also chat and "push-to-talk" capability built into Etoys.
==[[Developer Console]]==


==[[Browse]]==
The developer console provides a set of tabs in a popup window on top of activities. It is launched by typing <tt>Alt-=</tt>.
[[Image:Web.png]] Activity Version = 59


Our Xulrunner-based browser uses the scaling engine from Firefox 1.9. This greatly improves browser behavior on our high-resolution display. More performance enhancement needs to be done, particularly in regard to the scaling of images. All of the Google Apps now work well. Please let us know (by filing a trac bug report) when you find web sites with formatting problems.
The ''XO Resources'' tab shows basic information about the system, the recent CPU usage and flash usage


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=browse-activity&order=priority Web Browser Open Issues] can be found in trac.
The ''Memphis'' tab returns information about executing processes. [http://dev.laptop.org/git.do?p=projects/soc-memphis Memphis])


* {{ticket|542|SSL sites without official certificates fail to load}}.
The ''Log Viewer'' tab allows exploration of many key system logs.


* {{ticket|3353|Donut loses its center}}. When the browser opened a second instance (by opening a link to a "target") the donut becomes a solid circle and the individual instances of the browser are obscured. This bug has been fixed in later builds.
The ''Terminal'' tab provides a terminal emulator and shell.


* Plug-ins should be installed in the directory /usr/lib/mozilla/plugins.
The ''Presence'' tab provides logs of the presence service in raw form (the mesh view is a graphical interpretation of these logs), to aid in debugging one of our key new services.


* The current version ships with a FOSS version of Flash called [http://en.wikipedia.org/wiki/Gnash Gnash]; it has improved substantially from Trial-1. [[RestrictedFormats|Adobe's Flash]] plug-in can be loaded on the laptop—in some situations it may be preferable to the current version of Gnash. As noted in [[RestrictedFormats]], we cannot distribute Gnash with patented codecs, though Gnash can be rebuilt to support a wide range of datatypes.
==[[Drawing Activity]]==


* There is no Linux support for Shockwave; consequently Shockwave does not work in the browser.
;[https://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=drawing-activity+%28oficina%29&order=priority Paint (Oficina) Issues]: can be found in the trac system.

* The web browser does not ship with Java plug-in. [[RestrictedFormats|Sun's Java]] and web browser plug-in work fine.

* The web browser has no tabs, no zoom (yet), and only partial provision for ebook mode (yet).

* User experience has problems with pop windows.

* Most media objects stored in the Journal can be opened in the browser by "[[resuming from the Journal]]". Please report any problems with resume (by filing a trac bug report).

* {{ticket|4022|browser cannot open files generated by view source}} View source is invoked by typing either CTRL-U or FN-Space (FN-Gear-key). The page source is displayed in the Write activity—where it can be edited—and saved as a Journal entry. The Journal entry cannot be resumed in either Browse or Write (this is a regression that will be fixed in a later build). It can be copied from the Journal to the clipboard (but cannot be dragged into Write—another regression).

* Use either "[[share with neighborhood]]" or "[[invite]]" to advertise your browse session to other people with whom you can share bookmarks.

==[[Write]]==
[[Image:Write.png]] Activity Version = 45

The Write activity is based on [[AbiWord]]. This activity is fully integrated in the [[Sugar]] environment, and provides an efficient, light weight text editor. It has support for reading various documents formats, such as Microsoft Word (.doc, .rtf), OpenDocument (.odt), (X)HTML (.html), and plain text (.txt). The core of this activity might be used for editing text in the wiki as well.

* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=write-activity+%28abiword%29&order=priority Write activity issues] can be found in trac.

* {{ticket|4165|Write must expose UI to allow specifying output format.}} The Write activity has all the internal hooks for saving files out to arbitrary formats, but this feature is not exposed to the user. (You can use CTRL-SHIFT-S to invoke a "save-as" dialog, but it will save the file outside of the Sugar interface.) This will be fixed in later build.

* {{ticket|4108|Write activity doesn't share inserted pictures.}} This is a bug due to the sharing mechanism that is in Build 623. It has been corrected in later builds.

* Use either "[[share with neighborhood]]" or "[[invite]]" to advertise your Write session to other people with whom you can do simultaneous editing.

* Most text document types can be [[resuming from the Journal|resumed]] in the Write activity from the Journal.

* Images can be imported into Write by dragging them from the clipboard or by using an import dialog from the Journal.

* Etoys can also be used to author text and multimedia presentations.

==[[Record]]==

[[Image:Record.png]] Activity Version = 32

The primary record activity has support for still images, video, and audio. (The [[Sugar_EToys|Etoys]] activity also includes support for the camera.) Playback of media (still, video, and audio) captured by Record can be [[resuming from the Journal|resumed]] from Browse or Etoys. Still images captured by Record can be imported into Write through a Journal search dialog or from the clipboard.

* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=camera-activity&order=priority Record open issues] can be found in trac.

* Green LEDs illuminate above the microphone and camera when the Record activity is running.

* The Build 623 version of Record does not utilize the game-pad buttons. In later builds, these buttons can be used as a shutter.

* Record does not work properly in "[[rotate screen]]" mode.

* Record saves video as .ogg, which cannot be directly imported to youtube.com.

* The icons under the Record Tab are ambiguous. These have been redone in latter builds.

* Audio recording saves a still image, but that image is not displayed when [[resuming from the Journal]].

==[[Drawing Activity|Draw]]==

[[Image:Paint.png]] Activity Version = 12


The [[Drawing Activity|application]] is fully written in [[Python]], using only [[GTK]] features. It is being developed at [[LSI|LSI-USP]] in [[OLPC_Brazil|Brazil]].
The [[Drawing Activity|application]] is fully written in [[Python]], using only [[GTK]] features. It is being developed at [[LSI|LSI-USP]] in [[OLPC_Brazil|Brazil]].


* [https://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=drawing-activity+%28oficina%29&order=priority Paint (Oficina) Issues] can be found in the trac system.
==[http://wiki.laptop.org/go/Etoys Etoys]==

* {{ticket|2657|Not able to import image from the Journal into Draw}}. This is fixed in later builds.

* Etoys can also be used for drawing.

==[[TamTam]]==

[[Image:Activity8.png|51px]] [[Image:Tamtamedit-icon.png]] [[Image:Tamtamsynth-icon.png]] Activity Version 41

TamTam is a suite of music activities that span networked "jam sessions" to composition to a synthesizer lab.
The release notes for TamTamJam, TamTamEdit, and SynthLab are available [[TamTam Release Notes|here]].

* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=tamtam-activity&order=priority TamTam open issues] can be found in trac.

==[[Etoys]]==

[[Image:Activity1.png|72px]] Activity Version = 60


The [http://www.squeakland.org/ Etoys] learning environment has been integrated into the Sugar environment, and you are encouraged to visit the Squeakland site. [[Sugar Etoys]] has information specific to [[Etoys]] in our Sugar environment.
The [http://www.squeakland.org/ Etoys] learning environment has been integrated into the Sugar environment, and you are encouraged to visit the Squeakland site. [[Sugar Etoys]] has information specific to [[Etoys]] in our Sugar environment.


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=etoys-activity&order=priority Etoys open issues] can be found in trac.
==[[Journal]] and Datastore==
Note that removable media support is now present. When a USB key is inserted, Sugar will now automatically mount the USB stick and put an icon on the bottom of the journal; if you click on the icon, the journal on the USB stick will be shown. You can also unmount the stick using that icon by using the pop-up menu.


* Most media objects can be [[resuming from the Journal|resumed]] into Etoys from the Journal.
On an external device, the file name bears some resemblance of the name that may have been given to the journal entry, so you should be able to take a FAT formatted USB stick from an OLPC and mount it on Linux, Windows or MacIntosh to interchange files; on the JFFS2 file system right now it is simply a numeric has, which is arguably unfriendly.


* Most media objects can be dragged from the clipboard into Etoys.
The journal uses the underlying [http://wiki.laptop.org/go/Sugar_Architecture/API/sugar.datastore Datastore facility] which is new; its [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=datastore&order=priority issues] are in our trac system. Note that it indexes all information on an
external device; this issue:
;{{ticket|2627|Datastore should check versions and recreate indexes automatically}}: has caused some trouble during its development, which we hope to prevent in the future.


* Etoys has rich-media capabilities: it can be used for painting, writing, presentations, video capture and playback, etc.
;{{ticket|2544|Journal should give a choice of activities to resume an object with}}: Only a single activity can register right now for a given mime-type; it should be possible for multiple activities to handle the same mime-type and the user be asked which to invoke.


* Etoys has numerous modes of network-enable interaction: sharing of objects, sharing of desktops, chat, push-to-talk, etc.
;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&component=journal-activity&order=priority Journal issues]: can be found in our trac system.


==[[Turtle Art]]==
==[http://wiki.laptop.org/go/News_Reader Newsreader]==

[[Image:Turtleart.png|72px]] Activity Version = 4

Turtle Art is a logo-like application that draws colorful art via a turtle and scratch-like visual programming elements that snap together in compilable ways.

* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=turtle-activity&order=priority Turtle Art open issues] can be found in trac.

* Integration with the Journal is not complete.

==[[Pippy]]==

[[Image:Pippy-icon.png|72px]] Activity Activity = 8

* Pippy is a simple Python programming environment.

* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=pippy-activity&order=priority Pippy open issues] can be found in trac.

* Cut and paste is not working in this version of Pippy.

==[[Calculate]]==

[[Image:Calculate.svg|72px]] Activity Version = 12

The calculate activity provides a generic calculator. The interface provides the simplest functions directly and should therefore be easy to use for the youngest children. However, it does support more complicated math and variables.

* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=calculator-activity&order=priority Calculator open issues] can be found in trac.

* When "sharing", Calculate allows the sharing of variables and calculations across the network.

* The calculator does not save its variable data to the Journal.

==[[Measure]]==

[[Image:Measure-icon.png|72px]] Activity Version = 11

The Measure activity is used to measure DC and AC voltages by observing them on a oscilloscope like interface, being able to watch waveforms in frequency domain (spectrum analyzer), logging data at a specified time interval and drawing the graph of logged data.

* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=measure-activity&order=priority Measure open issues] can be found in trac.

* Sharing is not enabled in this version of Measure.

==[[News Reader]]==

[[Image:Newsfeed.png|72px]] Activity Version = 21


Based on [http://penguintv.sourceforge.net/ PenguinTV]. A few RSS feeds of educational interest have been preprogrammed as examples:
Based on [http://penguintv.sourceforge.net/ PenguinTV]. A few RSS feeds of educational interest have been preprogrammed as examples:
Line 202: Line 353:
Other feeds can easily be added/substituted.
Other feeds can easily be added/substituted.


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=news-activity+%28penguintv%29&order=priority News open issues] can be found in trac.
==[[Photograph|Record]]==


==[[Read]]==
The primary record (still- and video-camera) activity is written by Erik Blankinship and Bakhtiar Mikhak. (The [[Sugar_EToys|Etoys]] activity includes support for the camera.)


[[Image:Activity-xbook.svg|72px]] Acitvity Version = 32
The BTest-2 system does not have a LED to indicate if the camera or microphone is enabled. Such a LED is present on BTest-3 and later systems.


Read is opened as a "helper" application to the browser. PDF files are opened in an ebook reader.
Both the Record activity and Etoys can be used for playback; a version of Helix and a gstreamer player (roughly modeled on Totem) are available for Trial-2.


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=read-activity&order=priority Read open issues] can be found in trac.
==[http://wiki.laptop.org/go/Read Read (aka xbook)]==


* Screen rotate works well within the Read activity, but the buttons don't remap to the current orientation.
File viewer through the browser, or as a sugar activity. The PDF format view is brought to you by the poppler library and [http://www.cairographics.org/ Cairo] graphics library.


* Read can be used to share "books".
The xbook application has latent provision for ebook mode, awaiting a couple key bug fixes.


==[[TamTam]]==
==Memorize==


[[Image:Activity7.png|72px]] Activity Version = 18
;The [[TamTam Release Notes]]: are available.


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=memorize&order=priority Memorize open issues] can be found in trac.
==[[Turtle Art]]==


The game memorize is about finding matching pairs. A pair can consist of any multimedia object. At the moment these are images, sounds and text but this could be extended to animations or movie snippets as well. Which pairs do match is up to the creator of the game.
Turtle Art is a logo-like application that draws colorful art via a turtle and scratch-like visual programming elements that snap together in compilable ways.


==Connect==
Integration with the journal is not complete at this time, and users are wise to show children how to save their work.


==[[Helix Media Activity|Watch and Listen]]==
[[Image:Connect4.png|72px]] Activity Version = 15


A version of Connect-4 that supports network play, and is useful [http://dev.laptop.org/git.do?p=projects/connect-activity;a=summary as an example] of how to use Sugar's collaboration facilities.
Videos and DVD's can be played back on the system, including [http://www.helixcommunity.org RealNetwork] formats. A Sugar version of Real's Helix player is available and installed; only Ogg format media is in the base install for the reasons outlined in [RestrictedFormats]. Please see the [[Helix Media Activity]] release notes for further details. A browser plug-in version for media playback is expected soon.


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=connect-activity&order=priority Connect open issues] can be found in trac.
Note that it is likely there will be no icon for this activity in future versions, media playing being started by journal or browser activity.


* Connect requires two players to function - the game cannot be played until you share it and another player joins. At this time there is no support for starting a new game once somebody wins - that will be a future feature.
==[[Write]]==


=Additional Activities=
;[http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=write-activity+%28abiword%29&order=priority Write activity issues]: can be found in trac.


Many activities are under development and they can be [[Activities|found with their status in the wiki]] while the [[Activity Grid]] has the status of all of the activities that have systematic testing.
;{{ticket|2253|Write share function FAIL after insert an image}}: Sharing an image in Write will cause sharing to fail.


Most activities are installed by first downloading a <tt>.xo</tt> file from the web; second, open the activity from the Journal. The activity is installed in <tt>/home/olpc/Activities</tt> and on the Frame.
The Write activity is based on [[AbiWord]]. This activity is fully integrated in the [[Sugar]] environment, and provides an efficient, light weight text editor. It has support for reading various documents formats, such as Microsoft Word (.doc, .rtf), OpenDocument (.odt), (X)HTML (.html), and plain text (.txt). The core of this activity might be used for editing text in the wiki as well.


==[[Helix Media Activity|Watch and Listen]]==
=Games=


[[Image:Watch&listen.png|72px]] Activity Version = 8
==Blockparty==


Videos and DVD's can be played back on the system, including [http://www.helixcommunity.org RealNetwork] formats. A Sugar version of Real's Helix player is available and installed; only Ogg format media is in the base install for the reasons outlined in [[RestrictedFormats]]. Please see the [[Helix Media Activity]] release notes for further details. A browser plug-in version for media playback is expected soon. Watch & Listen is not preinstalled. It can be installed from [[Image:Watch_%26_Listen-8.xo|here]]
A famous, simple game of falling blocks, often known as Tetris. Contributed by [http://en.wikipedia.org/wiki/Vadim_Gerasimov Vadim Gerasimov].

==Connect==


* [http://dev.laptop.org/query?status=new&status=assigned&status=reopened&group=component&component=helix-activity&order=priority Watch and Listen open issues] can be found in trac.
A version of Connect-4. Supports network play, and is useful [http://dev.laptop.org/git.do?p=projects/connect-activity;a=summary as an example] of how to use Sugar's collaboration facilities.


Watch and Listen is opened as a "helper" application to the browser.
Note that Connect requires two players to function - the game cannot be played until you share it and another player joins. At this time there is no support for starting a new game once somebody wins - that will be a Trial 3 feature.


=Temporary placeholders and Missing Pieces=
=Temporary placeholders and Missing Pieces=
Line 260: Line 409:
==Backlight control==
==Backlight control==


The backlight can be controlled using F9 (dimmer) and F10 (brighter); With the backlight completely off, there is no color, and hardware anti-aliasing for the color screen is disabled.
The backlight can be controlled using F9 (dimmer) and F10 (brighter); With the backlight completely off, there is no color; hardware anti-aliasing for the color screen is also disabled (Screen resolution is maximized in this mode).
Likewise, volume is controlled by F11 (quieter) and F12 (louder).
Likewise, volume is controlled by F11 (quieter) and F12 (louder).
[[Image:Brightness-volume.png|thumb|none]]
[[Image:Brightness-volume.png|thumb|none|F9—F12 are assigned to this key (from left to right)]]


=School Server Notes=
=School Server Notes=
Line 268: Line 417:


==Laptop Registration==
==Laptop Registration==
To register with a school server, you execute the command ''olpc-register'' from a command line in the developer console. This establishes the relationship of the laptop with the school server (named "schoolserver" in the local DNS domain). It also establishes a [http://www.jabber.org/ jabber] server used by the presence service of the laptop. This should have a UI by Trial-3.
To register with a school server, you execute the command ''olpc-register'' from a command line in the developer console. This establishes the relationship of the laptop with the school server (named "schoolserver" in the local DNS domain). It also establishes a [http://www.jabber.org/ jabber] server used by the presence service of the laptop. This should have a UI by Update.1.


==Laptop Backup to server==
==Laptop Backup to server==
Line 295: Line 444:


Other software that has been tested on the OLPC systems includes
Other software that has been tested on the OLPC systems includes
[http://www.flash.com Adobe Flash], and Real's RealPlayer® and Sun's Java.
[http://www.flash.com Adobe Flash], and Real's [[Watch & Listen|Helix®]] and Sun's [[Java]].


=Finding the Latest Test Builds=
=Finding the Latest Test Builds=
Line 319: Line 468:
[[Category:Hardware]]
[[Category:Hardware]]
[[Category:Software development]]
[[Category:Software development]]
[[Category:Builds]]

Latest revision as of 07:37, 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.

This page details a stable software image, Ship.1, formerly known as "Trial-3" that was released on 2007-10-29. There have been numerous releases since this, everyone should update to a later release.

Important changes are noted below. This image is "late beta-test" software; using it there is much you can do with the laptop out of the box (See 542 Demo Notes and 608 Demo Notes). General – somewhat outdated – instructions on how to use the Sugar interface can be found here. Also of note are the Trial-2 Release Notes. These latter pages detail issues with particular versions of the hardware. The Library Release Notes page has information about the early stages of our sample content library. Finally, the OLPC Human Interface Guidelines describe our vision of where we are heading, only partially reflected in this release.

The software is just maturing to the point where we can embark upon later-stage trials for feedback and polish. Please review the #Notes below and please report any new bugs to our trac system (See http://dev.laptop.org).

Overview

Most of the first-generation vision for our system is now present and working:

  • The Journal
  • Presence service
  • Easy real-time collaboration in many of our activities including:
    • Read, Write, Chat, Browse, Record, Etoys, TamTam Jam, Memorize, Connect, Calculate, and Measure
  • Mesh networking
    • Automatic configuration of ad-hoc meshes, allowing collaboration without any infrastructure or Internet access
    • Automatic configuration of school server mesh
  • Anti-theft activation on installation
  • Registration with a school server
  • Backup to the school server

The software has been rebased onto Fedora Core 7 and Python 2.5.

Remaining tasks:

  • Bug fixes for first deployment

Important notes

At this time, we do not recommend installing the Trial-3 software on B2 systems due to some driver incompatibilities and excessive RAM and CPU usage.

Stable builds

The release notes on this page apply to the stable software release: Build 623 (2007-10-29). We recommend that you follow the instructions found on the Autoreinstallation image page to upgrade to this image. If you are already at build 612 or higher, you can upgrade using the olpc-update 6xx command from a virtual terminal. (Information regarding the latest development builds – non-stable builds – can be found here: Test_Group_Release_Notes.)

USB Update key needed to upgrade systems in the field#1748
Note that the Autoreinstallation image has latent support for preserving the user files on the system in the olpc.fth file. The USB key must be large enough to hold both the image to be installed and any and all files the user may have created in /home/OLPC.


Base-system notes

The system is now based on Fedora 7, and OLPC's kernel is based on Linux 2.6.22.

Suspend/resume and power management

Suspend/Resume#60
Note that a number of the bugs in the tracker bug are likely duplicates. Suspend and resume using the power button currently wakes up for various types of wireless LAN traffic.

Placeholder for suspend/resume bugs

Other

New Features:

Demo notes of new features

Private invitation:

  1. Start an activity (such as Write);
  2. From either the Neighborhood (Mesh) view or the Friends view, find someone with whom to share;
  3. Hover over the XO icon of the invitee and click on 'Invite' (This sends an invitation to participate in your current activity);
  4. The invitation will appear as an icon in your colors on the taskbar tray of the invitee's laptop;
  5. This activity is started by clicking on it (in the usual manner of all activities), but it starts up as a shared activity.

Sharing a bookmark in Browse:

  1. Open the browser;
  2. Share the activity either by issuing a private invitation as per above or by selecting 'share with neighborhood' from the menu under the Activity tab;
  3. Go to a URL of interest;
  4. From the Browse tab, click on the star in the upper right of the toolbar (This will create a bookmark that appears in a tray at the bottom of the activity window on each laptop that is sharing the activity);

Open Issues

  • Network connectivity
    • An XO that is acting as an MPP (mesh portal point) cannot participate in local mesh collaboration. (Until there has been more testing for an XO acting as an MPP vis-a-vis mesh collaboration, we have diabled automatic MPP mode. To manually enable this mode, please refer to the instructions here.)
    • Some activities share well in link-local; but don't share properly over the internet using the Jabber server. Activities that don't share well across the internet (G1G1) include Record photos and video (audio?), book reader, eToys, large files in Abiword may cause the activity to stop sharing. (This has been fixed in subsequent versions of the sharing/network software.)
  • Connect to an Airport Extreme access point with a WEP key.
    • You need to follow these steps when you login in the Airport configuration utility:
    1. Choose a network security level of 40-bit or 128-bit WEP.
    2. Set any password(you may tick the plain text option) and Update.
    3. After the update login again and note the HEX password in the summary view.
    • On the XO neighborhood view click the access point.
    1. In the security popup type $:XXXXX, where XXXXX is the HEX password.
    2. Choose the Shared Key option.
    • If the AP changes or removes its WEP key, the XO will not realize it directly. You will need to
    1. Remove /home/olpc/.sugar/default/nm/networks.cfg
    2. Reboot
  • Save photos
    • Record has changed a lot, and as a result, old entries cannot be opened on the new build
    • Follow these steps to save photos; unfortunately, videos will be lost.
    1. Drag photos from record onto the clipboard.
    2. Scroll over the clipboard images, and select "add to journal"
  • Sharing a Write document works well for text, but if you add too many images (large docs) don't share properly.
This is fixed in future builds.
  • Journal
  • Sugar
    • The battery indicator on the home sugar page only updates when the power adapter is plugged in or removed. #2861
    • If the network neighborhood mesh view stops showing other laptops or access points, reboot sugar with CTL-ALT-ERASE


Transporting photos, audio, and video from Record to USB sticks (Clipboard objects don't work)

  1. Drag media to the clipboard
  2. The files will be automatically added to the journal (named Audio by {XO_name}, Video by {XO_name}, and Photo by {XO_name}
  3. Drag these files from the journal to the USB stick, and any other laptop will be able to see and open them.
    • If you add the clipboard objects to the journal, they will not save correctly.
    • These objects will be able to be opened with different activities, but if you transfer them to a USB, you will not see them.
    • Changing the names of the items in the journal will force them to create correct names and file extensions.
    • After changing the name, drag the item from the journal to the USB stick.
    • Now, a non-XO laptop will be able to see and open the items on the USB stick.


IMPORTANT (unless we are going to have people install the rpm's to use olpc-update instead of doing the upgrade with a USB stick)

  • You must have the laptop plugged in with the AC adapter to upgrade firmware. Otherwise you will get a failure message; and you may need to boot on the backup image (holding down the gamekey O while booting) to try the upgrade again.
  • Update to latest firmware before updating to latest image.
    • The new firmware (Q2C28 and later) will check that the image is not corrupt before installing it, whereas the old firmware will wipe the nand and then run into trouble trying to install the new image.
    • Basically, using the new firmware will keep you safe from possibly losing your data due to a corrupt image.


Note that for long term storage, removing the battery pack after a full charge is best practice; this is true for all battery powered devices.

RestrictedFormats
In some jurisdictions, patents on algorithms apply, and royalty payments may be required. Examples include MP3, and MPEG-4. This is a particular nuisance for media players, for which many of the common codecs algorithms are patented. In other jurisdictions, software patents do not apply and there are usually freely available implementations for these algorithms available. Sometimes, as in Adobe Flash, or the Real Helix player there are free (as in beer) implementations available, where those corporations have paid these patent royalties and made usually (binary) versions of codecs available. This has direct consequences as OLPC does not want to burden all machines with what may be unnecessary duplicate patent royalties: OLPC must therefore leave the customization of the distribution for these formats for "in country". For jurisdictions in which such patent laws apply, there are now solutions such as those sold by Fluendo to these issues. The Flash format (whether Adobe's Flash 9 or Gnash) illustrates this problem well; even though we can include gnash, as built it does not have support for MP3 or MPEG-4, which should work correctly if Gnash is rebuilt.
fontconfig cache is invalidated too easily on mtime check
Applications can take a very long time to start, due to a fontconfig caching bug provoked by the time being set incorrectly (which can happen easily if the battery is replaced or the time is set badly). To work around this problem, use the "date" command from a console to set the current time and date.

X Window System

X Window System open issues
specific to OLPC are found in trac.

User Interface: Sugar

Shutdown
to shutdown completely, hover over the XO in the home view and click on 'Shutdown'. This is a graceful shutdown, preferred to holding the power button for more than 4 seconds, which summarily resets the machine.
Suspend
Momentarily press the power button.
Screen Capture
Alt-1 does a screen capture and stores the result in the Journal.
USB Keys
USB keys are automatically mounted and their contents are viewable from within the Journal. Files can be dragged from the Journal or Clipboard onto the USB key from within the Journal. (USB file systems are still accessible from console and the developer's console through the standard Linux mechanisms.)

Many of the user interface issues we intend to fix. Among the most notable issues are:

New networking UI needs documentation#989
To choose a network, push the first of the four circular "mesh view" keyboard buttons (or "F1" in an emulator), hover over each triangle until you find the access point you want to associate with, and then click on it. (Note that the access points are color-coded based upon a hash of the AP SSID. Therefore, once you learn the color of your desired access point, you can subsequently find it quickly.) You may be prompted for an access point's password.
Network Autoconfiguration
an XO will now autoconfigure the network. If no school server mesh, or previously connected Infrastructure Access Point can be found, an ad-hoc mesh will be formed using private networks. It will also associate with conventional access points using WEP or WPA. If it associates via WEP or WPA, the mesh portal functions cannot work, however.
Clipboard interaction (on the Frame)
is not fully developed in all activities. Some activities can copy and paste (using Ctrl-C and Ctrl-V) or drag to and from the clipboard, but some do not.
Groups
are not yet exposed in the interface. Sharing, chat, etc. are shared with the neighborhood (open to everyone connected to the mesh) or by invitation to individuals (and groups, where the invitations are issued one at a time).

Presence Service

PS open issues
can be found in trac
Connections
Telepathy connections are supported via the school server - a jabber XMPP server with some particular required features - as well as over the mesh network using Link Local XMPP. If you have no Internet access, link local is the default and you will see XOs in Neighborhood view who are on the mesh network. If you do have Internet access, link local presence will be switched off and you will only see XOs who are connected to the server.
Default Server
The default XMPP server is now jabber.laptop.org, so if you have internet connectivity you should see other users from around the globe in Neighborhood view, via this server.
Server Connections
Activity icons appearing in the mesh should disappear when everybody leaves that (shared) activity. However if the PS fails to announce somebody leaving (for example quitting the jhbuild emulator with alt-Q while in the activity#2616), then the icon remains on the mesh view#1935.

Developer Console

The developer console provides a set of tabs in a popup window on top of activities. It is launched by typing Alt-=.

  • The XO Resources tab shows basic information about the system, the recent CPU usage and flash usage
  • The Memphis tab returns information about executing processes. Memphis)
  • The Log Viewer tab allows exploration of many key system logs.
  • The Terminal tab provides a terminal emulator and shell.
  • The Presence tab provides logs of the presence service in raw form (the mesh view is a graphical interpretation of these logs), to aid in debugging one of our key new services.

Journal and Datastore

The Journal is a log of all of the activity on the laptop. The Journal uses the underlying Datastore facility.

  • Removable media support is now present. When a USB key is inserted, Sugar will now automatically mount the USB stick and put an icon on the bottom of the journal; if you click on the icon, the journal on the USB stick will be shown. You can also unmount the stick using that icon by using the pop-up menu. On an external device, the file name bears some resemblance of the name that may have been given to the journal entry, so you should be able to take a FAT formatted USB stick from an OLPC and mount it on Linux, Windows or MacIntosh to interchange files; on the JFFS2 file system right now it is simply a numeric has, which is arguably unfriendly.

Pre-installed Activities

A number of activities come pre-installed on the laptop. Instructions on loading additional activities is found here.

Chat

Chat.png Activity Version = 24

Chat open issues can be found in trac.

Chat has been restored to our builds. It now uses the Presence Service, so instead of a global chatroom, if you start Chat from the frame it will create its own room for you. When others join in the Neighborhood view, the activity shows who has joined or left, and if you join it will display those who are already in the chat room.

  • There is also chat and "push-to-talk" capability built into Etoys.

Browse

File:Web.png Activity Version = 59

Our Xulrunner-based browser uses the scaling engine from Firefox 1.9. This greatly improves browser behavior on our high-resolution display. More performance enhancement needs to be done, particularly in regard to the scaling of images. All of the Google Apps now work well. Please let us know (by filing a trac bug report) when you find web sites with formatting problems.

  • Donut loses its center#3353. When the browser opened a second instance (by opening a link to a "target") the donut becomes a solid circle and the individual instances of the browser are obscured. This bug has been fixed in later builds.
  • Plug-ins should be installed in the directory /usr/lib/mozilla/plugins.
  • The current version ships with a FOSS version of Flash called Gnash; it has improved substantially from Trial-1. Adobe's Flash plug-in can be loaded on the laptop—in some situations it may be preferable to the current version of Gnash. As noted in RestrictedFormats, we cannot distribute Gnash with patented codecs, though Gnash can be rebuilt to support a wide range of datatypes.
  • There is no Linux support for Shockwave; consequently Shockwave does not work in the browser.
  • The web browser does not ship with Java plug-in. Sun's Java and web browser plug-in work fine.
  • The web browser has no tabs, no zoom (yet), and only partial provision for ebook mode (yet).
  • User experience has problems with pop windows.
  • Most media objects stored in the Journal can be opened in the browser by "resuming from the Journal". Please report any problems with resume (by filing a trac bug report).
  • browser cannot open files generated by view source#4022 View source is invoked by typing either CTRL-U or FN-Space (FN-Gear-key). The page source is displayed in the Write activity—where it can be edited—and saved as a Journal entry. The Journal entry cannot be resumed in either Browse or Write (this is a regression that will be fixed in a later build). It can be copied from the Journal to the clipboard (but cannot be dragged into Write—another regression).

Write

Write.png Activity Version = 45

The Write activity is based on AbiWord. This activity is fully integrated in the Sugar environment, and provides an efficient, light weight text editor. It has support for reading various documents formats, such as Microsoft Word (.doc, .rtf), OpenDocument (.odt), (X)HTML (.html), and plain text (.txt). The core of this activity might be used for editing text in the wiki as well.

  • Write must expose UI to allow specifying output format.#4165 The Write activity has all the internal hooks for saving files out to arbitrary formats, but this feature is not exposed to the user. (You can use CTRL-SHIFT-S to invoke a "save-as" dialog, but it will save the file outside of the Sugar interface.) This will be fixed in later build.
  • Most text document types can be resumed in the Write activity from the Journal.
  • Images can be imported into Write by dragging them from the clipboard or by using an import dialog from the Journal.
  • Etoys can also be used to author text and multimedia presentations.

Record

Record.png Activity Version = 32

The primary record activity has support for still images, video, and audio. (The Etoys activity also includes support for the camera.) Playback of media (still, video, and audio) captured by Record can be resumed from Browse or Etoys. Still images captured by Record can be imported into Write through a Journal search dialog or from the clipboard.

  • Green LEDs illuminate above the microphone and camera when the Record activity is running.
  • The Build 623 version of Record does not utilize the game-pad buttons. In later builds, these buttons can be used as a shutter.
  • Record saves video as .ogg, which cannot be directly imported to youtube.com.
  • The icons under the Record Tab are ambiguous. These have been redone in latter builds.

Draw

Paint.png Activity Version = 12

The application is fully written in Python, using only GTK features. It is being developed at LSI-USP in Brazil.

  • Etoys can also be used for drawing.

TamTam

Activity8.png Tamtamedit-icon.png Tamtamsynth-icon.png Activity Version 41

TamTam is a suite of music activities that span networked "jam sessions" to composition to a synthesizer lab. The release notes for TamTamJam, TamTamEdit, and SynthLab are available here.

Etoys

Activity1.png Activity Version = 60

The Etoys learning environment has been integrated into the Sugar environment, and you are encouraged to visit the Squeakland site. Sugar Etoys has information specific to Etoys in our Sugar environment.

  • Most media objects can be resumed into Etoys from the Journal.
  • Most media objects can be dragged from the clipboard into Etoys.
  • Etoys has rich-media capabilities: it can be used for painting, writing, presentations, video capture and playback, etc.
  • Etoys has numerous modes of network-enable interaction: sharing of objects, sharing of desktops, chat, push-to-talk, etc.

Turtle Art

Turtleart.png Activity Version = 4

Turtle Art is a logo-like application that draws colorful art via a turtle and scratch-like visual programming elements that snap together in compilable ways.

  • Integration with the Journal is not complete.

Pippy

Pippy-icon.png Activity Activity = 8

  • Pippy is a simple Python programming environment.
  • Cut and paste is not working in this version of Pippy.

Calculate

Calculate.svg Activity Version = 12

The calculate activity provides a generic calculator. The interface provides the simplest functions directly and should therefore be easy to use for the youngest children. However, it does support more complicated math and variables.

  • When "sharing", Calculate allows the sharing of variables and calculations across the network.
  • The calculator does not save its variable data to the Journal.

Measure

Measure-icon.png Activity Version = 11

The Measure activity is used to measure DC and AC voltages by observing them on a oscilloscope like interface, being able to watch waveforms in frequency domain (spectrum analyzer), logging data at a specified time interval and drawing the graph of logged data.

  • Sharing is not enabled in this version of Measure.

News Reader

Newsfeed.png Activity Version = 21

Based on PenguinTV. A few RSS feeds of educational interest have been preprogrammed as examples:

  • Astronomy Picture of the Day
  • BBC News
  • EPOD - Earth Science Picture of the Day
  • Merriam-Webster's Word of the Day
  • Planet OLPC

Other feeds can easily be added/substituted.

Read

Activity-xbook.svg Acitvity Version = 32

Read is opened as a "helper" application to the browser. PDF files are opened in an ebook reader.

  • Screen rotate works well within the Read activity, but the buttons don't remap to the current orientation.
  • Read can be used to share "books".

Memorize

Activity7.png Activity Version = 18

The game memorize is about finding matching pairs. A pair can consist of any multimedia object. At the moment these are images, sounds and text but this could be extended to animations or movie snippets as well. Which pairs do match is up to the creator of the game.

Connect

Connect4.png Activity Version = 15

A version of Connect-4 that supports network play, and is useful as an example of how to use Sugar's collaboration facilities.

  • Connect requires two players to function - the game cannot be played until you share it and another player joins. At this time there is no support for starting a new game once somebody wins - that will be a future feature.

Additional Activities

Many activities are under development and they can be found with their status in the wiki while the Activity Grid has the status of all of the activities that have systematic testing.

Most activities are installed by first downloading a .xo file from the web; second, open the activity from the Journal. The activity is installed in /home/olpc/Activities and on the Frame.

Watch and Listen

File:Watch&listen.png Activity Version = 8

Videos and DVD's can be played back on the system, including RealNetwork formats. A Sugar version of Real's Helix player is available and installed; only Ogg format media is in the base install for the reasons outlined in RestrictedFormats. Please see the Helix Media Activity release notes for further details. A browser plug-in version for media playback is expected soon. Watch & Listen is not preinstalled. It can be installed from File:Watch & Listen-8.xo

Watch and Listen is opened as a "helper" application to the browser.

Temporary placeholders and Missing Pieces

There is no user interface for controlling the audio input and mixing. The workaround right now is to use "alsamixer" in a terminal window. Speaker volume is controllable by the slider. There is currently no visual feedback for changing the volume.

Our plans include a web server and wiki system MikMik, using an WYSIWYG editor based on the write activity (currently Abiword). This has a collaborative write capability we exploit.

Backlight control

The backlight can be controlled using F9 (dimmer) and F10 (brighter); With the backlight completely off, there is no color; hardware anti-aliasing for the color screen is also disabled (Screen resolution is maximized in this mode). Likewise, volume is controlled by F11 (quieter) and F12 (louder).

F9—F12 are assigned to this key (from left to right)

School Server Notes

The school server software is not quite ready.

Laptop Registration

To register with a school server, you execute the command olpc-register from a command line in the developer console. This establishes the relationship of the laptop with the school server (named "schoolserver" in the local DNS domain). It also establishes a jabber server used by the presence service of the laptop. This should have a UI by Update.1.

Laptop Backup to server

In the Journal, there is a Backup tab; you select that tab, and if your laptop is registered, it will backup to the school server.

OLPC Platform

Inventory of "permanent" packages

Inventory of "debug" packages

Inventory of "optional" packages (?)

Development environment

Languages - Logo, javascript, Python

Libraries

Where to find source

Many of the OLPC activities, kernel, and other software are in our git repository.

Internationalization/Localization (see Category:Language support & Category:Languages (international))

Other Multimedia Software

Other software that has been tested on the OLPC systems includes Adobe Flash, and Real's Helix® and Sun's Java.

Finding the Latest Test Builds

Development and stable builds can be downloaded. Boot firmware is kept in this wiki. The latest stable firmware and system image combined into an easy to use package with a script to automate installation of the firmware and base image makes upgrades to the latest stable software extremely easy.

Enabling logging

Activity logging is now turned off by default. To turn on logs:

  1. edit ~/.xinitrc and uncomment the line that imports .sugar.debug (It is the second last line of the file and there are commented instructions over it in the file itself)
  2. in ~/.sugar.debug, add these lines -


export JOURNAL_DEBUG=yes (to enable Journal Logs)

export SHELL_DEBUG=yes (to enable Shell Logs)

export ACTIVITYNAME_DEBUG=yes (to enable activity Logs where ACTIVITYNAME is that given in activity.info file)

export SUGAR_EMULATOR=yes (this shows me logs of all activities without having to enable logging for each activity)