Manuals/Om 2008

From Openmoko

Revision as of 15:58, 28 July 2009 by Marko Knöbl (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Contents

Entering the SIM PIN

Some SIM cards require a PIN code to be entered. If your SIM card is like this, you will see a screen like this after the FreeRunner boots:

Enterpin.jpg

The keypad in the lower part of the screen shows only letters, and your PIN is probably numeric. Switch to other keypads by stroking downwards on the screen with the stylus. Then enter your PIN. If you enter a wrong digit, you can backspace by stroking the screen to the left with the stylus. (Keep trying if it doesn't seem to work.) Finally, having composed the correct PIN, tap on the composed number with the stylus. This will enter it into the dialog box where it needs to be. After a brief pause, you will then see the word "Enter" at the top right of the keypad. Tap it. The PIN will then be checked, and if all is well, the Home Screen (next section) will be displayed.

The Home screen

With the bare-bones installation, the home screen looks like this.

Homescreen.jpg

Interface

New Keyboard

More details at : Om2008.8 Keyboard

Installer

The button to run the Installer is now on the bottom of the homescreen. The plus signs are placeholders for the graphical buttons to be added later.

Top Menu

The top menu is now your task switcher and is activated by touching the down arrow. Press "remove" to close currently focused application.

Terminal

In Om 2008.12, no terminal app is installed by default. To get to a command prompt, you need to set up USB-based networking and use SSH. Before trying to ssh into the FreeRunner, go into the Settings app and set "Suspend" to "off". The default is to go into suspend mode after 30 seconds without activity on the touchscreen, and when in suspend mode, the FreeRunner does not respond to commands sent over the ssh session.

Commands

These commands may be used in the terminal application (or in a remote SSH connection). Minimal shell usage skills may be required for Unix newcomers.

  • "ifconfig" - Displays network information.
  • "opkg update" - Updates list of available software.
  • "opkg install" - Install software.
  • "opkg upgrade" - Updates your software.
  • "killall packagekitd" - Quits any package manager which could be running. (Run this command if you get the "Could not obtain administrative lock" error message while running opkg commands)
  • "shutdown -r now" or "reboot" or "telinit 6" - Reboots your phone.

Configuring Om 2008

Internet

Connecting your FR through USB to an internet-connected computer

Follow this guide (Windows Users)to share your internet with your phone.

To share your internet connection on a Linux host follow this USB networking guide.

  • If you are also behind a router you may have to change your LAN IP range in your router to avoid using 192.168.0.* as this is the same IP range as what your phone and ICS uses. (If you don't there will be an IP conflict) (see below for a workaround)

After you install and run [Om 2008] for the first time you have to restart to get the USB working. Once you have done that you have to ssh into your phone (192.168.0.202) to edit your /etc/network/interfaces so you can access the internet through USB to install software and updates.

Edit the USB section to look like this:

  1. Ethernet/RNDIS gadget (g_ether)
  2. ... or on host side, usbnet and random hwaddr

auto usb0 iface usb0 inet static address 192.168.0.202 netmask 255.255.255.0 network 192.168.0.0 gateway 192.168.0.1

Editing: (10/12/08) This page is being edited by Emsyr: I believe that the gateway address above should be 192.168.0.200. At least that is how it worked for me (after connecting my NEO to PC following USB networking guide). Please confirm if this edit is globally correct or not and then delete it.

If this note persists without edits in the history, feel free to remove the Editing template from the page.


up echo nameserver 208.67.222.222 > /etc/resolv.conf up echo nameserver 208.67.220.220 >> /etc/resolv.conf

  1. up echo nameserver 192.168.0.200 > /etc/resolv.conf

If you have a 192.168.0.* network, with .200 to .203 ip not used, you can do the following on FR:

auto usb0 iface usb0 inet static address 192.168.0.202 netmask 255.255.255.252 network 192.168.0.200 gateway 192.168.0.201

and set your host ip to 201. Don't forget to modify routing and check USB networking guide for a DNS MASQ using 192.168.0.201 as FR DNS.

Wireless

See Neo FreeRunner Wifi for details on how to use Wifi to connect your FR to the internet.

Advanced power management

If you decide not to install the Unofficial Zecke updates you should install "illume-config" to can gain access to more advanced power management features and to change the look of the GUI through the wrench that will now appear in the top bar. (Restart your phone)

Mediaplayer

There are 2 media players available for the 2008 device.

opkg install qtopia-phone-x11-mediaplayer

Seems to be a very nice application, place media in " ~/Documents/ " or " /media/card/ "

Install it using the "install" application or by typing:

opkg install qtopia-phone-x11-mediaplayer


Openmoko-mediaplayer2

Sice this media player currently is based on the pulseaudio sound server --- and this sound server breaks all phone applications using sound as soon as the phone goes into power saving mode it is unwise to install this application at this time.

If you have already installed this application you have to uninstall pulseaudio, as well, to get your phone working as a phone again.

This Media Player is basically useless due to the default theme, to. To install with a better theme run:

opkg install openmoko-mediaplayer2 wget http://abraxa.dyndns.org:81/random/openmoko-mediaplayer-theme.tar.bz2 tar xjf openmoko-mediaplayer-theme.tar.bz2 -C /usr/share/themes/Moko/gtk-2.0 rm openmoko-mediaplayer-theme.tar.bz2

Bugs/Fixes

TODO: Link to bugreports and check if some of them might be fixed in newer updates (See: To-Do List)
  • The Media Player is basically unusable because of the skin. And is also very buggy.
  • Battery meter always says its charging. Installing a terminal and running "apm" will display the proper battery status. (Appears to now work with the latest updates -- Tkep
  • Your phone will go into standby after 30 seconds EVEN when connected to your computer or wall charger. (Disable this under the settings menu)
  • The wifi doesn't work too well right now. (well, works now with 2008 updates, I think -- OlivierBerger 14:25, 31 August 2008 (UTC))
  • Accelerometers have alpha support via Gestures
  • If you let the battery completely drain you will have problems booting it up. Plug it into the wall charger for a few hours and then plug it into your computer and press power.
  • BUT, if you have another charged battery, such as from the Spares pack, you can boot the Neo with the good battery, plug in wall-charger, and hot-swap the drained battery while booted. This allows you to immediately start "fast-charging" with the wall-charger. (Neo needs to be booted to recognize charger and switch to fast-charging)
  • You'll have to install "illume-config" to have more control over power management, scrolling speeds, keyboard options, and to change how the interface looks.
  • Some software that you install by command-line may appear in in the settings menu (wrench) that you unlock after installing "illume-config".

See also

Personal tools

Entering the SIM PIN

Some SIM cards require a PIN code to be entered. If your SIM card is like this, you will see a screen like this after the FreeRunner boots:

Enterpin.jpg

The keypad in the lower part of the screen shows only letters, and your PIN is probably numeric. Switch to other keypads by stroking downwards on the screen with the stylus. Then enter your PIN. If you enter a wrong digit, you can backspace by stroking the screen to the left with the stylus. (Keep trying if it doesn't seem to work.) Finally, having composed the correct PIN, tap on the composed number with the stylus. This will enter it into the dialog box where it needs to be. After a brief pause, you will then see the word "Enter" at the top right of the keypad. Tap it. The PIN will then be checked, and if all is well, the Home Screen (next section) will be displayed.

The Home screen

With the bare-bones installation, the home screen looks like this.

Homescreen.jpg

Interface

New Keyboard

More details at : Om2008.8 Keyboard

Installer

The button to run the Installer is now on the bottom of the homescreen. The plus signs are placeholders for the graphical buttons to be added later.

Top Menu

The top menu is now your task switcher and is activated by touching the down arrow. Press "remove" to close currently focused application.

Terminal

In Om 2008.12, no terminal app is installed by default. To get to a command prompt, you need to set up USB-based networking and use SSH. Before trying to ssh into the FreeRunner, go into the Settings app and set "Suspend" to "off". The default is to go into suspend mode after 30 seconds without activity on the touchscreen, and when in suspend mode, the FreeRunner does not respond to commands sent over the ssh session.

Commands

These commands may be used in the terminal application (or in a remote SSH connection). Minimal shell usage skills may be required for Unix newcomers.

  • "ifconfig" - Displays network information.
  • "opkg update" - Updates list of available software.
  • "opkg install" - Install software.
  • "opkg upgrade" - Updates your software.
  • "killall packagekitd" - Quits any package manager which could be running. (Run this command if you get the "Could not obtain administrative lock" error message while running opkg commands)
  • "shutdown -r now" or "reboot" or "telinit 6" - Reboots your phone.

Configuring Om 2008

Internet

Connecting your FR through USB to an internet-connected computer

Follow this guide (Windows Users)to share your internet with your phone.

To share your internet connection on a Linux host follow this USB networking guide.

  • If you are also behind a router you may have to change your LAN IP range in your router to avoid using 192.168.0.* as this is the same IP range as what your phone and ICS uses. (If you don't there will be an IP conflict) (see below for a workaround)

After you install and run [Om 2008] for the first time you have to restart to get the USB working. Once you have done that you have to ssh into your phone (192.168.0.202) to edit your /etc/network/interfaces so you can access the internet through USB to install software and updates.

Edit the USB section to look like this:

  1. Ethernet/RNDIS gadget (g_ether)
  2. ... or on host side, usbnet and random hwaddr

auto usb0 iface usb0 inet static address 192.168.0.202 netmask 255.255.255.0 network 192.168.0.0 gateway 192.168.0.1

Editing: (10/12/08) This page is being edited by Emsyr: I believe that the gateway address above should be 192.168.0.200. At least that is how it worked for me (after connecting my NEO to PC following USB networking guide). Please confirm if this edit is globally correct or not and then delete it.

If this note persists without edits in the history, feel free to remove the Editing template from the page.


up echo nameserver 208.67.222.222 > /etc/resolv.conf up echo nameserver 208.67.220.220 >> /etc/resolv.conf

  1. up echo nameserver 192.168.0.200 > /etc/resolv.conf

If you have a 192.168.0.* network, with .200 to .203 ip not used, you can do the following on FR:

auto usb0 iface usb0 inet static address 192.168.0.202 netmask 255.255.255.252 network 192.168.0.200 gateway 192.168.0.201

and set your host ip to 201. Don't forget to modify routing and check USB networking guide for a DNS MASQ using 192.168.0.201 as FR DNS.

Wireless

See Neo FreeRunner Wifi for details on how to use Wifi to connect your FR to the internet.

Advanced power management

If you decide not to install the Unofficial Zecke updates you should install "illume-config" to can gain access to more advanced power management features and to change the look of the GUI through the wrench that will now appear in the top bar. (Restart your phone)

Mediaplayer

There are 2 media players available for the 2008 device.

opkg install qtopia-phone-x11-mediaplayer

Seems to be a very nice application, place media in " ~/Documents/ " or " /media/card/ "

Install it using the "install" application or by typing:

opkg install qtopia-phone-x11-mediaplayer


Openmoko-mediaplayer2

Sice this media player currently is based on the pulseaudio sound server --- and this sound server breaks all phone applications using sound as soon as the phone goes into power saving mode it is unwise to install this application at this time.

If you have already installed this application you have to uninstall pulseaudio, as well, to get your phone working as a phone again.

This Media Player is basically useless due to the default theme, to. To install with a better theme run:

opkg install openmoko-mediaplayer2 wget http://abraxa.dyndns.org:81/random/openmoko-mediaplayer-theme.tar.bz2 tar xjf openmoko-mediaplayer-theme.tar.bz2 -C /usr/share/themes/Moko/gtk-2.0 rm openmoko-mediaplayer-theme.tar.bz2

Bugs/Fixes

TODO: Link to bugreports and check if some of them might be fixed in newer updates (See: To-Do List)
  • The Media Player is basically unusable because of the skin. And is also very buggy.
  • Battery meter always says its charging. Installing a terminal and running "apm" will display the proper battery status. (Appears to now work with the latest updates -- Tkep
  • Your phone will go into standby after 30 seconds EVEN when connected to your computer or wall charger. (Disable this under the settings menu)
  • The wifi doesn't work too well right now. (well, works now with 2008 updates, I think -- OlivierBerger 14:25, 31 August 2008 (UTC))
  • Accelerometers have alpha support via Gestures
  • If you let the battery completely drain you will have problems booting it up. Plug it into the wall charger for a few hours and then plug it into your computer and press power.
  • BUT, if you have another charged battery, such as from the Spares pack, you can boot the Neo with the good battery, plug in wall-charger, and hot-swap the drained battery while booted. This allows you to immediately start "fast-charging" with the wall-charger. (Neo needs to be booted to recognize charger and switch to fast-charging)
  • You'll have to install "illume-config" to have more control over power management, scrolling speeds, keyboard options, and to change how the interface looks.
  • Some software that you install by command-line may appear in in the settings menu (wrench) that you unlock after installing "illume-config".

See also