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. or the Getting Started page.
• If you are having technical problems, please see the Support page.
• There are also answers for some problems on the Workarounds 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.

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?

Register is a feature for School Servers: not relevant to individual machines that are part of the G1G1 program.

Have not seen Wiki entries for the following:

• simple instructions for loading new apps (Activities)

See the instructions at the top of the Activities page and at the end of the [1] page.

• re-imaging the system - where to get image and how to re-install OS

See Olpc-update

• how to install patches and upgrades to the OS

See Olpc-update

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.

Q: Why does script have to be loaded from USB device? Can't I just download it to my XO directly (via a non-WPA connection)? A: There is no reason why not. Yes, you can!

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.

Build number

How can I find my build number?

In the Terminal activity, enter

ls /versions/configs

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 the IP addresses of 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...

Another editor notes: You can probably simplify the above by putting multiple parameters on the same command line:

/etc/init.d/NetworkManager stop
/sbin/ifconfig eth0 <yr.ip.address.here> up
/sbin/iwconfig eth0  key restricted <yr.wep.key.here>  mode Managed   essid <yr.ssid.here>
/sbin/route add default gw <yr.default.gw.here>

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)

I don't know about the Journal implications, but I've started a slideshow program (PyGstSlideshow) http://sourceforge.net/projects/xotabletredux that uses gstreamer and cairo. I'm willing to improve it if there is interest.--Eph 21:23, 25 December 2007 (EST)

There is also a slideshow Pippy project (it is in the Joyride builds, but it can also be found here. --Walter 09:49, 2 January 2008 (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.

The files saved by various programs appear to be stored in /home/olpc/.sugar/default/datastore/store/ with heavily hashed filenames. --Dlarson 20:59, 3 January 2008 (EST)

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)

Turning off wireless

I would like to use my XO on an airplane. How do I turn off the wireless?

For the current session, in a terminal, enter the following command as root.

iwconfig eth0 txpower off

To disable the wireless so you can turn your XO off and then on again without the radio coming on, you need to rename /lib/firmware/usb8388.bin as root. Something like the following.

su
cd /lib/firmware
mv usb8388.bin usb8388.bak
exit

To reenable wireless, reverse the process

su
cd /lib/firmware
mv usb8388.bak usb8388.bin
exit

and reboot--Mokurai 19:18, 16 January 2008 (EST)

See also How do I disable wireless when flying?