Questions from New Users

Schoolchildren reportedly are able to discover how to use an XO without adult assistance, except for features that are not currently working correctly. For those who are having trouble, and in particular those who have run into bugs and unfinished features, help is available.

• If you have questions about how to use the software, please see the draft manual.
• If you are having technical problems, please see the Support page.

If the available documentation doesn't help, please post your questions here. Somebody is sure to answer sooner or later.

These questions will become input to the documentation process. So even having trouble becomes a contribution to the success of the program.

New, Unanswered Questions

Anything about the XO hardware or software that you can't figure out and is not documented.

Put a subheading before your question. If you're signed in, type ~~~~ (four tildes) to sign your post automatically. Or use the signature button on the Wiki edit toolbar.

qemu question

Can someone show me the syntax for qemu's -L option to specify the directory where I installed qemu? ToysRGood 16:52, 20 December 2007 (EST)

`-L path'
   Set the directory for the BIOS, VGA BIOS and keymaps.

according to http://fabrice.bellard.free.fr/qemu/qemu-doc.html#SEC10. I don't think this is what you are trying to do. Doesn't your package manager tell you where it puts files?--Mokurai 17:10, 21 December 2007 (EST)

Stylus

How do you enable the use of a stylus?

Not sure yet, but my USB Logitech optical trackball mouse worked well. Paul Bock 12:48, 20 December 2007 (EST)

The "graphics tablet" functionality of the touchpad isn't supported yet, but it should be supported in an upcoming software release. See Walter's comments on the "Using the stylus area" question on the Ask OLPC a Question page. —Joe 16:04, 20 December 2007 (EST)

Touchpad orientation

Is it possible to alter the orientation of the touchpad to match the screen orientation in book mode?

64 bit key

My WiFi network uses 64 bit WEP encoding. when I try to connect in Neighborhood, a pop up box asks for a 128 n\bit key. The 64 bit key is not accepted. Do I have to change the network? Is there a way to have the laptop accept 64 bit encoding?

I don't know the answer to that, but WEP is hopelessly broken. An outsider can reconstruct your key by listening to a few minutes of traffic, and then read everything you send and receive. (Instructions here.) Get WPA or WPA2 if at all possible.--Mokurai 17:21, 21 December 2007 (EST)

Static IP address

My WiFi network uses static IP addresses (i.e. I don't run dhcp). How can I manually set up networking?

Answering my own question...(with help from OLPC IRC):

1. Open Terminal Activity, become root (su) and cd to /etc 2. In rc.local add the following:

  /etc/init.d/NetworkManager stop
  /sbin/ifconfig eth0 yr.ip.address.here up
  /sbin/iwconfig eth0 key yr.wep.key.here  #I use WEP, don't know about WPA
  /sbin/iwconfig eth0 key restricted  #I use a shared key
  /sbin/iwconfig eth0 mode Managed  
  /sbin/iwconfig eth0 essid yr.ssid.here  #I found I had to set the essid after setting the mode
  /sbin/route add default gw yr.default.gw.here

3. In resolv.conf add your nameservers 4. Reboot

After doing the above my XO would automatically connect to my static ip, WEP protected, home wireless network. The key to this seems to be stopping the NetworkManager before calling ifconfig and iwconfig. I'm sure there's a more RedHat approved way of doing this but the above works for me.

One caveat: after making these changes I tried updating my build to 653 (via /usr/sbin/olpc-update ship.2-653). The update seemed to take but when I rebooted I got a Boot Failure message and had to fall back to build 650. Don't know if my changes to rc.local were the cause...

Downloading file from internet

I've downloaded the MP3 codec from Fluendo as I found in one of your wiki entries but I can't figure out where it put it to unzip it and copy it to the directory I want

Dcutter1 10:51, 23 December 2007 (EST)

Here's some notes on how I finally got the MP3 codec moved. Not sure if this was the correct way to do it but hey I'm not a 8 year old working on this machine :-)

Location of these instructions: http://wiki.laptop.org/go/Fluendo_mp3_decoder (modified with actual commands I used to get file unpacked and moved)

In order to download the codec you have to "buy" the Fluendo mp3 decoder from their store for $0.00 from https://shop.fluendo.com/.

You are then allowed to download the file fluendo-mp3-2.i386.tar.bz2

At this point I'm not sure where it downloaded the file but I went to the journal and clicked on the clipboard icon. I then went into terminal mode did a cd / to get to root and found the file in the tmp directory. The file name is in the awful long string of numbers and letters that this system uses to keep track of file names.

Unzip it - tar -xvfj fluendo-mp3-2.i386.tar.bz2 (the filename actually looked like this 1256ab-345-15b-123f45RMm.tbz2,

The unpacked worked and it created a new directory in the tmp directory (note: if the file name has a "(" in it tar can not unpack it as it thinks this is an invalid name, I ran into this the first time I tried this).

I changed to SU so I could copy to user/lib and then I did the copy cp fluendo-mp3-2.i386/libgstflump3dec.so /usr/lib/gstreamer-0.10

You can also copy into $HOME/.gstreamer-0.10/plugins on your local system.

If you copy to /usr/lib/gstreamer-0.10 then the plugin will be available to any user logging into this machine.

Once it is copied over, verify that gstreamer recognises the plugin by doing a 'gst-inspect-0.10 flump3dec' from the root directory.

Unless this command reports back 'No such element or plugin 'flump3dec' the plugin should be sucessfully installed and you should have access to playing back MP3 files using GStreamer applications. You should see a couple pages of information about the plugin.

Hope this helps and for you people that know this system please update with any easier way to do this.

Dcutter1 08:24, 24 December 2007 (EST)

Issues

Bugs, unfinished features.

In the first-time user startup instructions - there is no mention of the inital User Name: entry required

• my experience was that after typing the child's name, the NEXT> button on screen did not work - it wasn't until I pressed the keyboard ENTER key that I got the system to actually start and bring up the UI.

The REGISTER feature never confirmed in any way what was registered - is this a central registration of the machine - or is this in a dynamic ad-hoc network?

Have not seen Wiki entries for the following:

• simple instructions for laoding new apps (Activities)
• re-imaging the system - where to get image and how to re-install OS
• how to install patches and upgrades to the OS

[thank you]

WPA WiFi

From OLPC Ship.2 Software Release Notes

We continue to work on improving support for WPA encryption, and hope to have a better solution in our Update.1 release. In the meanwhile, WPA Manual Setting documents procedures for manual use of WPA encrypted access points.

Answers

Questions that have been answered. To avoid confusing the Wiki history, entering the answer and moving the question and answer here should be done in two edit sessions.

Entering user name

The initial "Enter your name" prompt is undocumented and confusing. What name? My name? The computer's name? What happens if I "choose poorly"? Can I change it? THis is the very first thing the user sees and it needs to be in the paperwork that ships with the laptop.

This is a good question—perhaps they will enhance the prompt in a future version. There will be an easy way to change the name eventually; until then, there are workaround instructions in the Support FAQ. —Joe 14:13, 21 December 2007 (EST)

Slideshow?

I don't see a "Slideshow" activity - is there a good way to create a slideshow on the XO? ToysRGood 11:32, 20 December 2007 (EST)

I'm not sure how this would be accomplished. To me, slideshow means a picture viewer that can move to the next or previous picture in a collection of pictures. However, the limitation is in the Journal application, which is the storage/file management activity on the XO. You may have noticed that you can't open a stored file from a running activity. To open an existing file you have to go the Journal and have the Journal launch the file with an appropriate activity that can understand the file data. This is a security mechanism to prevent malware from attacking the XO. An activity and a file are launched together so that the activity can only manipulate itself and the file it was passed when launched. The activity can't access any other file or program on the XO. An activity won't have an "open file" functionality. The Browser activity has an "open" button when you have downloaded a file, but the browser isn't opening the file directly. The downloaded file is saved as an entry in the Journal, and then the "open" button launches an activity with your downloaded file. As an aside, the Record activity, that lets you take pictures and video, saves each picture or video file as seperate journal entries. Maybe a slideshow concept could be built into the Record activity. Or maybe a special file could be created (like a multi page TIFF) that you could migrate pictures to by using the clipboard. Then within this single file you could flip from picture to picture. Paul Bock 12:10, 20 December 2007 (EST)

• • People have discussed making a slideshow activity in the past—maybe in eToys or as part of the Read activity's functionality. I've found that you can browse a directory of jpgs using the Browse activity; just click the page title in the top toolbar and change the page address to "file:///", then browse to the image file (probably somewhere in "/home/olpc/.sugar" for journal entries or "/media" for USB drives/SD cards). This technique is counter to the Sugar design, though, so it will probably be superseded by something better. —Joe 16:04, 20 December 2007 (EST)

You can fake it by putting a set of images in the Record activity directory, where the journal has an entry for opening a set of pictures.--Mokurai 16:52, 21 December 2007 (EST)

Anti-virus software?

What about Anti-Virus software? Don't I need it? Is it already installed?

Someone will probably replace this with a more "official" answer, but in a sense of humor let me say this. By asking a question about anti-virus software, you are probably a Windows user. The XO laptop runs on the Linux OS. People who run Linux instead of Windows don't usually run anti-virus software. This concept may enlighten you to stop paying for poor software (Windows and Anti-virus software) and open your mind to more secure, software with freedom. Specifically, OLPC uses a variant of Red Hat's Desktop Linux called Fedora Core. Also, you can run the full blown Fedora Core, for little to no cost, on the same machine you currently run Windows and anti-virus software. The XO laptop is exceptionally good at compartmentalizing program and data to limit what a virus or "bad" program can do, see Online threats and security and Bitfrost Paul Bock 13:04, 19 December 2007 (EST)

Setting time

How can I set the correct time on this computer? And time zone, for that matter? I get that there wouldn't be a whole lot of config programs à la System Preferences on the Mac, but I would think there'd have to be something for this sort of basic configuration.blahedo 01:18, 18 December 2007 (EST)

There will be a control panel user interface available eventually. Until then, there is a command line application that can tweak various system settings, including time zone; see Sugar Control Panel. I'm not sure why it doesn't let you set the time as well... Perhaps it syncs with an internet server? —Joe 01:41, 18 December 2007 (EST)

Update: someone has added instructions to the Sugar Control Panel page for syncing the laptop's time with internet time servers. —Joe 16:04, 20 December 2007 (EST)

Mesh network

What exactly is a "mesh"? I don't really understand this concept- can someone explain it in lay terms?

Imagine trying to yell a message to someone a couple miles away. And you are not allowed to use a telephone (wired network). You will probably have a hard time getting your message to the other person a couple miles away. Now imagine that you live in a neighborhood with people spaced about 10 feet apart. You can easily talk with your neighbor and you tell him the message and who it has to go to. Then your neighbor relays your message to his neighbor and so on until it gets to the person a couple miles away. So anybody that is close enough to communicate with at least one person on the network, can then gain the ability to talk to everybody that is on the network. That's what this mesh network is all about. PaulBock 12/19/2007

And then if one of the people in the network has a telephone, you can talk to anyone that can be called on that phone. The parallel here is that hopefully someone in a village of XO laptops has a connection to the internet, thereby giving everybody in that small mesh network access to the internet. This connection to the internet will probably exist through a School Server. Paul Bock 13:04, 19 December 2007 (EST)

Opening files

Using the Write application, I can save a file but I cannot find a way to open an existing file. For that matter, I cannot determine where (or even if) this file is saved. How does the file saving/opening work?

This was difficult for me too. Every time you use an activity, or save a file, an entry is created in the Journal activity that is by default always running. Go to the Journal activity from the home view and scroll up and down the list to find the file you want. The Journal activity also handles the mounting of an SD card and any USB flash drives. Paul Bock 13:04, 19 December 2007 (EST)

No activity can open a file. You have to use the Journal activity to open a saved file. You find the file in the journal entry list and then "resume" it to launch an activity that can read the file data. The inability for an activity to open another file is a security measure. The concept is single activity to a single file. If you want to work between two text documents you have to open two sessions of the Write activity each looking at its respective text document. Use the clipboard, along the left edge, to move text between the files. Paul Bock 12:24, 20 December 2007 (EST)

Shell script

Using the Write application, I was able to type in a shell script. I did a "keep", and I can find the script in the Journal, but I haven't been able to find it from the Terminal to execute it. Is it possible?

You can't save files to the file system from Write.--Mokurai 16:52, 21 December 2007 (EST)

1. Open your file from the Journal.
2. Select all of the text, and copy it.
3. Create the file from the terminal with 'cat - >filename' and paste to the terminal. End with Ctl-D.

User account on Wiki

How do you get a user name on this wiki?

There should be a "Sign in/create an account" link in the upper right corner of each page. —Joe 12:59, 19 December 2007 (EST)