Rawhide-XO: Difference between revisions

From OLPC
Jump to navigation Jump to search
(all of the useful content form this page has been moved F11 on XO-11)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
#REDIRECT [[F11 for XO-1]]
{{TOCright}}
This is a page for notes and test results for the http://dev.laptop.org/~cjb/rawhide-xo/ development builds.

== What is it? ==
A "spin" of [[Fedora]] rawhide (the development version of Fedora 11 Linux) incorporating recent [[Linux]] software packages, the [[Sugar]] desktop UI ''and'' a more conventional Gnome desktop.

As such it is sort of a replacement for the cutting-edge [[joyride]] [[OS images]] that OLPC used to produce. See [[Future releases]] for the change in plans.
As such builds are very raw and often ''may not work at all''.

=== Build contents ===
Each nightly Fedora Rawhide build e-mails a list of its packages and sends it to [https://www.redhat.com/archives/fedora-devel-list/ fedora-devel-list].

Rawhide-XO is an adaptation of the nightly Fedora Rawhide. It uses kickstart files (see <tt>.ks</tt> files, see http://dev.laptop.org/git/projects/fedora-xo/tree/) to customize the build for the different images it provides.

== Resources ==
* [http://dev.laptop.org/~cjb/rawhide-xo/ preliminary images]
* [http://dev.laptop.org/git/projects/fedora-xo/ sources]
* [https://www.redhat.com/archives/fedora-olpc-list/ mailing list]
* [irc://irc.freenode.net#fedora-olpc IRC]

== Installation ==
The images page http://dev.laptop.org/~cjb/rawhide-xo/ has installation instructions.

=== USB/SD image installation ===
The <tt>.bootable.gz</tt> image writes a partition table as well as the contents of a 2GiB partition to your USB or SD card.
It does this regardless of the actual size or previous partitioning of the memory card.

Note the card must be 2 Gibibytes, which is substantially bigger than 2,000,000,000 bytes;
many 2GB cards only store 1.91 x 1024 x 1024 bytes.

You can instead use the [http://fedorahosted.org/liveusb-creator/ Fedora LiveUSB Creator] to create a live USB or SD from one of the <tt>.iso</tt> files.

== Basic user guide ==
On first boot at the login screen, you can choose either Gnome or Sugar from the drop-down list at the bottom. You want to login as "liveuser", or wait for automatic login.

=== Sugar ===
If you start the Gnome desktop (the default), you need to exit to switch to Sugar.
(Sugar commands like <tt>sugar</tt> are available to you in Gnome, but running them under another desktop manager is '''not''' recommended.)

To return to the "first boot" login screen from Gnome, in Terminal, run [[su -l]] then run as [[root]]:
init 3
log in as liveuser, then run as root
init 5
it will stop GNOME and restart gdm


In the Sugar desktop, to set the keyboard to match the XO-1's keyboard, start [[Terminal Activity]] and enter
setxkbmap -model olpc
The AltGr key will now work to insert the special characters on some of the keycaps.

See [[Keyboard shortcuts]] for keys in Sugar (e.g. Alt+Shift+F brings up the Frame)
and http://en.flossmanuals.net/Sugar for general Sugar instructions.

=== Accessing NAND Flash ===
If you boot rawhide-XO off USB or SD, the XO-1's internal 1GB of NAND flash storage is left unmounted. But this storage is available as the <tt>mtd0</tt> device. To make this accessible at the path <tt>/mnt/''my_nand''</tt> you could as [[root]] enter the command
mkdir /mnt/my_nand && mount -t jffs2 mtd0 /mnt/my_nand

== Differences from OLPC images ==
''Many of these are probably shared with "Sugar on a Stick" SoaS-2 images, and should be on a common page.''

* the default user is liveuser, not olpc
* liveuser can't use [[sudo]] to run commands as [[root]] (but can run [[su -l]] to become root).
* many olpc commands missing, such as olpc-netstatus
* different file system
** /efi instead of /ofw
** /home/liveuser instead of /home/olpc

== Known issues ==
* On the XO-1, you must hold down the checkmark <nowiki>'</nowiki>'''√'''<nowiki>'</nowiki> gamepad key at boot, otherwise boot will hang with the XO guy on white.
* Keyboard map alert.
* Can't choose Gnome or Sugar after desktop login
* You can't choose an English or American OLPC keyboard in the keyboard chooser on the "first boot" login screen.
* No power management until you install [[Ohm]]
* The stock Fedora kernel does not play sound, hence (probably) why totem crashes. [https://www.redhat.com/archives/fedora-olpc-list/2009-March/msg00136.html how to replace with the OLPC kernel]

See [https://bugzilla.redhat.com/showdependencytree.cgi?id=461806&hide_resolved=1 Fedora on XO tracker bug dependency tree].

Also see [[{{TALKPAGENAME}}]] for user reports, and [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Getting_Involved/Testing Sugar Labs testing reports] for the similar SoaS-2 images.

=== Kernel differences ===
The OLPC OS Images contained a customized kernel; its differences with the stock Fedora 11 kernel include:
* open firmware interface (arch/x86/kernel/ofw.[ch])
* geode GPIO driver (used by DCON and suspend/resume)
* dcon driver (drivers/video/olpc_dcon.[ch])
* suspend/resume code (arch/x86/kernel/olpc_pm.*)
* parts of the HGPK touchpad: drivers/input/mouse/olpc.c
* working sound drivers

== Reporting bugs ==
* You should file bugs with the Sugar desktop and activities in the [http://dev.sugarlabs.org/ Sugar Labs bug tracker]. You can check with the sugar-devel list before or after.
* Bugs with the Fedora "rawhide" distribution and its behavior on the XO-1 should be filed in the [https://bugzilla.redhat.com Red Hat Bugzilla. You can check with the Fedora-OLPC list before or after.
:* product "Fedora", version "Rawhide", pick relevant component.
:* After creating your bug, edit it to add '''461806''' in the "Blocks" field to link it to the [https://bugzilla.redhat.com/show_bug.cgi?id=461806 FedoraOnXO tracker bug].
: ''Note: the product "Fedora OLPC" is discontinued. Any bugs filed against this deceased product should be filed against Fedora if they are still valid.''

== See also ==
* [http://sugarlabs.org/go/Sugar_on_a_Stick Sugar on a Stick]. "SoaS 2" are similar development builds based on Fedora 11 ("Rawhide").

[[Category:Linux distributions]]
[[Category:Builds]]

Latest revision as of 15:46, 5 October 2009

Redirect to: