Useful things for the OLPC

andy@stanford-clark.com

A collection of hints, tips, and how-tos that I've found useful during the first few weeks with my OLPC, which I hope will be of use to others...


OLPC daily news
OS and firmware versions
screenshots
jabber server
compiling C on the OLPC
setting time zone and Daylight Saving
keyboard shortcuts
installing new stuff
firmware
install perl
battery life
sensors
speech synthesiser
xoblog
video
mplayer
microscope
wireless
proxy settings for browser
getting wireless working with WEP in a key slot other than 1
screen display
tam tam stuff
USB serial port
ssh daemon
spy camera / motion detector
aeroplane mode
helpful notes from someone else
feh image viewer
turn on right-mouse paste in terminal
to move apps around in the main list or to add new ones
mp3 player
Jim Gettys talk at MIT
Marvin Minsky
Dan Bricklin
active antenna
picture of the OLPC
ad-hoc wireless
tony pearson (IBM) on XO
presentations
remote display
Human Interface Guidelines
instant messaging on the XO
Updating to Version 1


OLPC daily news

http://wiki.laptop.org/go/OLPC:News

OS and firmware versions

ctrl-alt-f1 or f2 to switch to consoleN
read the number after OLPC build...

On more recent builds, use "About this XO" from the mouse-over menu on the XO logo in the centre of the main sugar screen

note if you are upgrading the Operating System, you don't need to separately update the firmware: it gets done at the same time as the OS upgrade.
In fact, on a machine that hasn't been unlocked with a developer key, there are no bootfw.zip files available for the signed firmware image since Q2D18, so it looks like you can't upgrade the firmware independently of the OS.

firmware

sudo cat /ofw/openprom/model
Current version is Q2E18 as of 17-Sep-08

operating system

cat /etc/issue
cat /boot/olpc_build
current version is 767 (8.2.0) as of 14-Oct-08

screenshots

http://olpcnews.com/forum/index.php?topic=767.0

alt + 1

Connect to a jabber server

http://olpcnews.com/forum/index.php?topic=396.0
  1. Go to the terminal window.
  2. sugar-control-panel -g jabber (hint: type sugar-co then hit tab to complete the command)
    will display your current setting.
  3. sugar-control-panel -s jabber server_name
    will connect to a (special for OLPC) Jabber server.
  4. Reboot Sugar with CTRL-ALT-ERASE (CTRL-ALT-BACKSPACE in an emulator session)

port is 5223 note references to xochat.org should be ignored as this server is not avaibable any longer.

compiling C on the OLPC

http://wiki.laptop.org/go/Compiling_C/C%2B%2B_program_for_the_OLPC

setting time zone and Daylight Saving

http://wiki.laptop.org/go/Sugar-Control-Panel
sugar-control-panel -g timezone
list possible zones:
sugar-control-panel -h timezone

su
sugar-control-panel -s timezone Europe/London

date --set "10:06"
^d

Daylight Saving / Summer Time

Note that the OLPC wiki assures us that
You needn't worry about any possible Daylight Saving Time; the OLPC handles this very well with no human intervention.
However, that's not true. The /etc/localtime file that ships with the XO is woefully useless for setting Daylight Saving.

What you have to do is to create a symlink from /etc/localtime to the correct timezone file in /usr/share/zoneinfo

For example, for people living in the UK:

su -l
cd /etc
mv localtime old.localtime

ln -s /usr/share/zoneinfo/GB localtime
^d
Et voila, now the time shows as BST rather than GMT (in the Summer)

BTW, to see what the localtime and zoneinfo files are saying, use zdump:

zdump -v /etc/localtime | grep 2008

keyboard shortcuts

http://wiki.laptop.org/go/Keyboard_Shortcuts

quit activity ctrl-esc

full screen mode alt-enter

tray visibility alt-space

ctrl-alt-erase - restart sugar

installing new stuff

http://wiki.laptop.org/go/Software_components

http://wiki.laptop.org/go/Activities

firmware

http://dev.laptop.org/roadmap

testing suspend resume mode

http://wiki.laptop.org/go/Tests/Suspend_Resume

install perl

su
yum install perl

battery life

battery lasts 3.5 hours

sensors

http://wiki.laptop.org/go/Measure

http://wiki.laptop.org/go/Measure/Projects

http://wiki.laptop.org/go/Peripherals/Sensors

speech synthesiser

http://wiki.laptop.org/go/Speech_synthesis

xoblog

http://xoactivity.blogspot.com/

video

http://olpcnews.com/forum/index.php?topic=1752.0

Try either Ogle (http://www.dtek.chalmers.se/groups/dvd/)
MPlayer (http://www.mplayerhq.hu/design7/news.html)
or VLC (http://www.videolan.org/vlc/download-fedora.html)

http://wiki.laptop.org/go/Measure/Hardware

http://olpcnews.com/forum/index.php?topic=908.0

mplayer

To install:
su
cd /bin
wget http://www.orderedpixels.com/xo/mplayer/mplayer.tar.bz2
tar vxf mplayer.tar.bz2

Setup subtitle support:

mkdir -p ~/.mplayer
ln -s /usr/share/fonts/dejavu-lgc/DejaVuLGCSans.ttf ~/.mplayer/subfont.ttf

To run:

mplayer -fs /media/[medianame]/[filename]
In ebook mode, < rewinds (10 second increments?); > fastforwards; {square} mutes; {tick} pauses; X quits

microscope

http://lists.laptop.org/pipermail/etoys/2006-October/000158.html

http://wiki.squeak.org/squeak/3765

http://wiki.laptop.org/go/Microscope

http://wiki.laptop.org/go/Support_FAQ#What_does_.22Register.22_.28in_Home_view.29_do.3F

wireless

add a hidden SSID
su -l
/sbin/iwconfig eth0 mode managed essid 
/sbin/dhclient eth0
exit

proxy settings for browser

either
/home/olpc/.sugar/default/gecko/user.js
pref("network.proxy.http",  "<set to your proxy server>"); 
pref("network.proxy.http_port",  <set to 8080 or the appropriate port>); 
pref("network.proxy.type",1);
or
pref("network.proxy.autoconfig_url", "<your proxy>");

or in browser - about:config - can't change the values in the current version, so this doesn't work

network.proxy.http       <set to your proxy server>
network.proxy.http_port  <set to 8080 or the appropriate port>
network.proxy.type       <change to 1>

getting wireless working with WEP and a key slot other than 1 (e.g. 4)

su -l
iwconfig eth0 key [4] 10hexdigits
iwconfig eth0 key [4]

screen display

19cm (7.5 inches) LCD display
Colour mode: Resolution 800x600 (133dpi); power consumption 1 watt
Black and white mode: Resolution 1200x900 (200dpi); power consumption 0.2 watt; sunlight readable

tam tam stuff

http://www.olpcnews.com/software/applications/xo_minitamtam_video.html

mini tamtam demo
http://uk.youtube.com/watch?v=31L9qaxOrp0&feature=related

synthlab demo
http://uk.youtube.com/watch?v=Nwqt8NMT-zI

etoys
http://uk.youtube.com/watch?v=T40RG2FqjOc&NR=1

USB serial port

just works - appears as /dev/ttyUSB0
need to
su -l 
chmod go+rw to enable everyone to talk to it
try picocom...
su -l
yum install picocom

picocom -b 9600 /dev/ttyUSB0
to exit - ctrl-a ctrl-q

to run it as user olpc, need to chmod o+w /var/lock so picocom can create the lock file:

su -l 
chmod o+w /var/lock

ssh daemon

is running by default

set olpc user password as root

su -l 
passwd olpc

now you can ssh in ssh -l olpc <OLPC's IP address>

spy camera / motion detector

http://www.olpcnews.com/software/applications/olpc_hack_xo_laptop_spy_camera.html

http://www.earobinson.org/2008/02/09/olpc-spy-cam/

http://wiki.laptop.org/go/MotionDetection

aeroplane mode

sugar-control-panel -s radio off
sugar-control-panel -s radio on 

helpful notes from someone else

http://www.catmoran.com/olpc/

feh image viewer

su
yum install feh
exit
image viewer
feh -F -D 5 --scale-down /media/SD

feh -F -D 3 -r -z -Z --scale-down --hide-pointer <top level directory of images>

-F    full screen
-D 3  3 sec / slide
-r    recurse
-z    randomise
-Z    stretch to fill full screen
to display images from an Axis webcam:
feh -F -R 10 -Z http://<ip address>/axis-cgi/jpg/image.cgi

turn on right-mouse paste in terminal

in /home/olpc/.xsession
xmodmap -e "pointer = 1 3 2"

to move apps around in the main list or to add new ones

edit

/home/olpc/Activities/.defaults

and replace the entries in the order you want them.
So for example, you can move org.laptop.Terminal to the front of the list :)

This takes precedence over the master list at

/usr/share/sugar/data/activities.defaults

to find a list of installed activities

ls ~/.sugar/default

mp3 player

http://wiki.laptop.org/go/Fluendo_mp3_decoder

"buy" the decoder fluendo-mp3-2.i386.tar.bz2 from https://shop.fluendo.com/

bunzip fluendo-mp3-2.i386.tar.bz2
tar xvf fluendo-mp3-2.i386.tar

mkdir ~/.gstreamer-0.10/plugins

cp fluendo-mp3-i386/libgstflump3dec.so .gstreamer-0.10/plugins
check it's OK with
gst-inspect-0.10 flump3dec
to play an mp3...
gst-launch-0.10 playbin uri=file:///path/to/file.mp3

Jim Gettys talk at MIT

rtsp://forum.wgbh.org/forum/3417-2007_04_26_hi.rm

Marvin Minsky

http://wiki.laptop.org/go/Marvin_Minsky

Dan Bricklin

http://danbricklin.com/log/2007_12_05.htm#milestone

active antenna

http://wiki.laptop.org/go/Active_Antenna

picture of the OLPC

http://www.topnews.in/files/OlpcGreenLaptopRCOM222.jpg

I skewed the image so it's "square" again so you can display it on your OLPC, for example using FEH

Here's the XO children image

Display it with

feh -F -Z --hide-pointer XO_children.jpg

ad-hoc wireless

on Ubuntu laptop

sudo /etc/dbus-1/event.d/25NetworkManager stop

sudo ifconfig wlan0 down
sudo iwconfig mode ad-hoc
sudo iwconfig essid 'olpc' (or whatever)
sudo iwconfig channel 4 (or whatever)

sudo ifconfig wlan0 11.0.0.1
sudo ifconfig wlan0 up

run ~/perl/proxy/htty_proxy.pl

on OLPC

su -l
ifconfig eth0 down
iwconfig eth0 mode ad-hoc
iwconfig eth0 essid 'olpc' (or whatever)
iwconfig eth0 channel 4 (or whatever)

ifconfig eth0 11.0.0.2
ifconfig eth0 up

ping 11.0.0.1
then need to set up http proxy on olpc
~/.sugar/default/gecko/user.js

pref("network.proxy.http",  "11.0.0.1"); 
pref("network.proxy.http_port",  8080); 
pref("network.proxy.type",1);

open browser activity

Tony Pearson (IBM) on XO

printing on XO

http://www.ibm.com/developerworks/blogs/page/InsideSystemStorage?tag=OLPC

presentations

http://wiki.laptop.org/go/Presentations

http://www.laptop.org.za/slides/olpc-dev-talk/presentation.html

remote display

http://wiki.laptop.org/go/Remote_display

Human Interface Guidelines

http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines

Instant Messaging on the XO

Pidgin and Finch
http://olpcnews.com/forum/index.php?topic=198.15

People seem to have various problems with this: what you actually have to do, is...

su
wget ftp://fr2.rpmfind.net/linux/fedora/releases/7/Everything/i386/os/Fedora/NetworkManager-glib-0.6.5-2.fc7.i386.rpm
rpm -vi NetworkManager-glib-0.6.5-2.fc7.i386.rpm
rm NetworkManager-glib-0.6.5-2.fc7.i386.rpm
Then
yum install pidgin
To move back and forward between buddy list and chat windows, use alt-tab and ctrl-alt-tab to move between windows.

or... (not tried this)

yum install finch

Kopete
This is a monster download (48meg!), which doesn't really seem in the spirit of OLPC, but hey, it works great!
http://olpcnews.com/forum/index.php?topic=1073.0

Updating to Version 1

http://wiki.laptop.org/go/Olpc-update
su -l
olpc-update 703
Takes about 30 mins or so

http://wiki.laptop.org/go/OLPC_Update.1_Software_Release_Notes

Thomas Overton suggests the Peru Activity pack
http://wiki.laptop.org/go/Peru_activity_pack

need
http://laptop.org/peru-bundles.zip
and
http://laptop.org/signed-customization-2.zip

unzip onto USB stick

reboot with the USB key inserted.

Note: I had some trouble with memory sticks that were not "real" Windows-formatted VFAT format.
Ones that had been formatted to that from Linux failed to mount during the boot sequence

Sticky ctrl key on keyboard

Smugly thinking my OLPC was immune to the sticking-down ctrl key problem, I was shocked when it started doing it recently.
So far, a firm rub with the finger on the top of the keycap has done the trick, but if it returns, here are lots of instructions and comments on how to fix it

http://bc.tech.coop/blog/080327.html1 http://bc.tech.coop/blog/080327.html1

http://olpcnews.com/forum/index.php?topic=1961.0 http://olpcnews.com/forum/index.php?topic=1961.0

http://olpcnews.com/forum/index.php?topic=1906.0 http://olpcnews.com/forum/index.php?topic=1906.0

http://olpcnews.com/forum/index.php?topic=696.0 http://olpcnews.com/forum/index.php?topic=696.0

http://wiki.laptop.org/go/Stuck_keys http://wiki.laptop.org/go/Stuck_keys  

 

 

 


comments and updates to: andy@stanford-clark.com