Manuals/Neo 1973/nl

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Buttons)
 
(8 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
{{Languages|Manuals/Neo 1973}}
 +
 
Dit is een handleiding voor de beginnende gebruiker van de [[Neo1973]] telefoon. ''(nog niet compleet in het Nederlands vertaald)''
 
Dit is een handleiding voor de beginnende gebruiker van de [[Neo1973]] telefoon. ''(nog niet compleet in het Nederlands vertaald)''
[[Shipment 1]] has some specifics limited to that batch.
 
  
 
== Hardware ==
 
== Hardware ==
Line 26: Line 27:
 
==== SIM-kaart (optioneel) ====
 
==== SIM-kaart (optioneel) ====
  
De [[SIM/nl | SIM-kaart]] krijgt u van uw mobiele telefonie provider. De houder voor de SIM-kaart is te vinden onder de batterij. Op de metalen houder geven pijlen en tekst aan hoe de SIM-kaarthouder geopend en gesloten wordt. Wees voorzichtig, door teveel kracht te gebruiken kunt u de houder breken.  
+
De [[SIM/nl | SIM-kaart]] krijgt u van uw mobiele telefonie provider. De houder voor de SIM-kaart is te vinden onder de batterij. Op de metalen houder geven pijlen en tekst aan hoe de SIM-kaarthouder geopend en gesloten wordt. Wees voorzichtig, door teveel kracht te gebruiken kunt u de houder breken.
  
 
Schuif de SIM-kaarthouder in de richting van het woord OPEN en til hem op. De SIM-kaart kan uit en in de houder geschoven worden. Let er bij het plaatsen van de SIM-kaart op dat de gouden contacten op de kaart naar beneden gericht zijn. Om de houder weer te sluiten drukt u deze naar beneden en schuift u hem in de tegenstelde richting van woord OPEN.
 
Schuif de SIM-kaarthouder in de richting van het woord OPEN en til hem op. De SIM-kaart kan uit en in de houder geschoven worden. Let er bij het plaatsen van de SIM-kaart op dat de gouden contacten op de kaart naar beneden gericht zijn. Om de houder weer te sluiten drukt u deze naar beneden en schuift u hem in de tegenstelde richting van woord OPEN.
Line 51: Line 52:
 
* Aux knop 1 seconde indrukken: opent het [[functions menu|functie menu]].
 
* Aux knop 1 seconde indrukken: opent het [[functions menu|functie menu]].
  
=== Accessories ===
+
=== Accessoires ===
  
==== Stylus ====
+
==== Stylus (griffel) ====
  
The stylus as shipped has three batteries in it, providing for the laser pointer and flashlight LEDs. A set of replacement batteries is also included. The stylus can be twisted open in middle to access the batteries.
+
De stylus wordt geleverd met 2 sets batterijen voor the laser pointer en de leds voor de flashlight. Voor het plaatsen van de batterijen kan de stylus in het midden opengeschroefd worden.
  
To use the ballpoint or stylus head, turn the bottom part of the stylus to either direction.
+
Om de ballpoint- of styluskop te krijgen: draai het onderste deel van de stylus in de gewenste richting.
  
==== Headset ====
+
==== Hoofdtelefoon ====
  
The Neo ships with a stereo headset including a microphone and a push button. The plug is a standard 2.5 mm four-conductor version, though it differs from standard 3.5 mm headphones. The black socket is on the left side of the phone, and the last millimeter is somewhat firmer so make sure you push the plug all the way.
+
De Neo wordt geleverd met een stereo hoofdtelefoon inclusief een microfoon en drukknop. Het stekkertje is een standaard 2,5mm four-conductor versie (anders dan de normale hoofdtelefoons die gebruik maken van 3,5mm stekkers). De ingang voor de hoofdtelefoon is te vinden aan de linkerzijkant van de Neo.
 +
Let op: druk het stekkertje ver genoeg naar binnen.
  
==== Lanyard ====
+
==== Koord ====
  
The provided lanyard can be attached to the hole in the bottom part of the phone. Put the loose end through the phone, through the two metal loops in the lanyard, between the metal loops and back through the first metal loop.
+
Het meegeleverde koord kan aan de onderkant van de telefoon bevestigd worden.
  
 
=== Powering up the phone ===
 
=== Powering up the phone ===
 
[[Image:Neo1973_uboot_splash.jpg|200px|thumb|bootloader splash screen]]
 
[[Image:Neo1973_uboot_splash.jpg|200px|thumb|bootloader splash screen]]
Just hitting the power button (depending on your [[u-boot]] version you have to press for >= 5 seconds) should get the phone first into the bootloader, then boot the kernel, and get into  X/OpenMoko. The shipped battery typically has enough charge to boot up directly without charging through the usb cable first.
+
Just hitting the power button (depending on your [[u-boot]] version you have to press for >= 5 seconds) should get the phone first into the bootloader, then boot the kernel, and get into  X/Openmoko. The shipped battery typically has enough charge to boot up directly without charging through the usb cable first.
  
 
Once you have pressed the power button sufficiently long, the vibrator makes a short pulse and the screen backlight turns on. You can now release the power button and watch the phone booting.
 
Once you have pressed the power button sufficiently long, the vibrator makes a short pulse and the screen backlight turns on. You can now release the power button and watch the phone booting.
Line 78: Line 80:
 
The GTA01Bv4 devices that are currently shipping do not boot out of the box.  Flashing the phone with the latest kernel and [[Userspace root image|supporting file system ("rootfs")]] is required before the phone will successfully boot.
 
The GTA01Bv4 devices that are currently shipping do not boot out of the box.  Flashing the phone with the latest kernel and [[Userspace root image|supporting file system ("rootfs")]] is required before the phone will successfully boot.
  
Read more information at about [[Flashing openmoko]]. MacOS X users please also refer to [[MacOS_X]].
+
Read more information at about [[Flashing the Neo 1973]]. MacOS X users please also refer to [[MacOS_X]].
  
 
=== Powering down the phone ===
 
=== Powering down the phone ===
Line 104: Line 106:
 
==== While in Linux ====
 
==== While in Linux ====
  
As soon as the phone is connected via USB cable, it will charge.  However, the default charging current is only 100mA, way too little if you want to operate the phone and charge at the same time.  
+
As soon as the phone is connected via USB cable, it will charge.  However, the default charging current is only 100mA, way too little if you want to operate the phone and charge at the same time.
  
 
If your USB upstream port is capable of supplying 500mA, then it will configure the Neo1973 accordingly and use 500mA charging mode.  You can notice this by the following line in the kernel log (/var/log/messages) of the Neo1973:
 
If your USB upstream port is capable of supplying 500mA, then it will configure the Neo1973 accordingly and use 500mA charging mode.  You can notice this by the following line in the kernel log (/var/log/messages) of the Neo1973:
usb0: full speed config #1: 500 mA, Ethernet Gadget, using CDC Ethernet
+
usb0: full speed config #1: 500 mA, Ethernet Gadget, using CDC Ethernet
  
 
== Getting shell access on the phone ==
 
== Getting shell access on the phone ==
Line 113: Line 115:
 
=== By using the terminal emulator and on-screen keyboard ===
 
=== By using the terminal emulator and on-screen keyboard ===
  
In [[Today]] (the main screen the phone boots to and which can always be accessed by pressing the [[AUX button]]), selecting (with a stylus or a thumb) the "+" tab in the center bottom of the screen shows the application launcher. Make sure the filter at the top of the window is set at "Applications" or "All", then drag upward on the list to scroll it until the Terminal application appears. Alternatively, you can toggle the magnifier glass in the filter and type "terminal" to the text box that appears. Click the application in the list to make it turn yellow and start - this might be difficult a first since any movement is interpreted as dragging rather than clicking.  
+
In [[Today]] (the main screen the phone boots to and which can always be accessed by pressing the [[AUX button]]), selecting (with a stylus or a thumb) the "+" tab in the center bottom of the screen shows the application launcher. Make sure the filter at the top of the window is set at "Applications" or "All", then drag upward on the list to scroll it until the Terminal application appears. Alternatively, you can toggle the magnifier glass in the filter and type "terminal" to the text box that appears. Click the application in the list to make it turn yellow and start - this might be difficult a first since any movement is interpreted as dragging rather than clicking.
  
 
The on-screen keyboard should appear whenever you choose a text entry. It can also be toggled by clicking on the tiny keyboard icon in the panel at the very top of the screen. More options are available via Input Manager which can be started in the application launcher filtered by "Utilities" or "All". A white box appears in the panel. It also can be used to toggle the keyboard. You can choose between different keyboard layouts and the stroke recognizer by dragging from the white box to the right of the box, which should make a menu appear.
 
The on-screen keyboard should appear whenever you choose a text entry. It can also be toggled by clicking on the tiny keyboard icon in the panel at the very top of the screen. More options are available via Input Manager which can be started in the application launcher filtered by "Utilities" or "All". A white box appears in the panel. It also can be used to toggle the keyboard. You can choose between different keyboard layouts and the stroke recognizer by dragging from the white box to the right of the box, which should make a menu appear.
Line 123: Line 125:
 
The following description is for generic *NIX system. For setting up connectivity specifically on a MacOS X machine, refer to [[MacOS_X]] (because there is no usb0 and you need a special kernel driver first).
 
The following description is for generic *NIX system. For setting up connectivity specifically on a MacOS X machine, refer to [[MacOS_X]] (because there is no usb0 and you need a special kernel driver first).
  
As soon as the kernel is up and running, and you have the phone connected via USB, you should get a '''usb0''' device on your host.
+
As soon as the kernel is up and running, and you have the phone connected via USB, you should get a '''usb0''' device on your host.
  
 
The Phone will have the IPv4 address 192.168.0.202/24.  You can run `ifconfig` in the terminal on the phone to verify this (this is optional, just check it if it doesn't work given the instructions below)
 
The Phone will have the IPv4 address 192.168.0.202/24.  You can run `ifconfig` in the terminal on the phone to verify this (this is optional, just check it if it doesn't work given the instructions below)
Line 130: Line 132:
  
 
On the '''host PC''', you should then configure your interface to 192.168.0.200 by using
 
On the '''host PC''', you should then configure your interface to 192.168.0.200 by using
# ifconfig usb0 192.168.0.200 netmask 255.255.255.0
+
# ifconfig usb0 192.168.0.200 netmask 255.255.255.0
  
 
Then you should be able to
 
Then you should be able to
# ping 192.168.0.202
+
# ping 192.168.0.202
  
 
and last, but not least
 
and last, but not least
# ssh root@192.168.0.202
+
# ssh root@192.168.0.202
  
 
Once you press 'enter' (empty password), you should now have a root login.
 
Once you press 'enter' (empty password), you should now have a root login.
Line 144: Line 146:
 
Note: If you have a power management profile enabled on your device your ssh connection might appear to freeze when your phone tries to sleep.  To stop this from occuring you need to hold the power button down for a few seconds until you get the menu with the "Power Off" option at the bottom.  Once you do, you should select the "Profile: No PM" option.  If your shell died and you want it back, you can do the following:
 
Note: If you have a power management profile enabled on your device your ssh connection might appear to freeze when your phone tries to sleep.  To stop this from occuring you need to hold the power button down for a few seconds until you get the menu with the "Power Off" option at the bottom.  Once you do, you should select the "Profile: No PM" option.  If your shell died and you want it back, you can do the following:
  
# modprobe -r cdc_ether  
+
# modprobe -r cdc_ether
# modprobe -r cdc_acm
+
# modprobe -r cdc_acm
  
 
Then unplug the device and plug it back in after turning power-management off.
 
Then unplug the device and plug it back in after turning power-management off.
Line 161: Line 163:
 
If you got no Speaker and Mic during a Call you need to load the "gsmhandset.state" alsa-configfile
 
If you got no Speaker and Mic during a Call you need to load the "gsmhandset.state" alsa-configfile
  
alsactl -f /etc/alsa/gsmhandset.state restore
+
alsactl -f /etc/alsa/gsmhandset.state restore
  
 
Maybe you need to load another .state file for playing mp3 or a BT-Headset see in /etc/alsa/
 
Maybe you need to load another .state file for playing mp3 or a BT-Headset see in /etc/alsa/
Line 167: Line 169:
 
To hear something you can find an .au file (or convert a .wav into an .au by using the sox tool):
 
To hear something you can find an .au file (or convert a .wav into an .au by using the sox tool):
  
sox ringtone_thereisnophone.wav -t raw -r 8012 -u -b -c 1 rigtone_thereisnophone.au
+
sox ringtone_thereisnophone.wav -t raw -r 8012 -u -b -c 1 rigtone_thereisnophone.au
  
 
copy it to the device and run
 
copy it to the device and run
  
cat ringtone_thereisnophone.au > /dev/dsp
+
cat ringtone_thereisnophone.au > /dev/dsp
  
 
== Useful commands in Linux ==
 
== Useful commands in Linux ==
Line 180: Line 182:
  
 
If you're connected over ssh, sshd will stop responding when the OS suspends, so to avoid locking up your ssh client, use the command
 
If you're connected over ssh, sshd will stop responding when the OS suspends, so to avoid locking up your ssh client, use the command
# (sleep 1; echo mem > /sys/power/state) & exit
+
# (sleep 1; echo mem > /sys/power/state) & exit
  
 
=== Initial backup ===
 
=== Initial backup ===
  
After getting your new Neo1973 booted for the first time you might want to make a back up of the original flash chip contents on your PC, before you overwrite the flash with a custom image or just update to a newer build.
+
After getting your new Neo1973 booted for the first time you might want to make a back up of the original flash chip contents on your PC, before you overwrite the flash with a custom image or just update to a newer build.
  
 
{{note|For phase 0 developers only (GTA01Bv4 shippment 0, '''not > 0 '''): This is a good idea because there are parts in the root filesystem that can't be distributed over internet so they are only found in the shipped ROM (see the [[GPS]] driver).}}
 
{{note|For phase 0 developers only (GTA01Bv4 shippment 0, '''not > 0 '''): This is a good idea because there are parts in the root filesystem that can't be distributed over internet so they are only found in the shipped ROM (see the [[GPS]] driver).}}
Line 214: Line 216:
 
To set the date and time you need to open a terminal or ssh to the device. To set the date and time to August 9 19:02 2007 type:
 
To set the date and time you need to open a terminal or ssh to the device. To set the date and time to August 9 19:02 2007 type:
  
# date -s 080919022007
+
# date -s 080919022007
  
 
The screensaver might turn on as you execute this command - just tap the screen to get back.
 
The screensaver might turn on as you execute this command - just tap the screen to get back.
Line 220: Line 222:
 
Now, you need to synchronize the time with the hardware date/time by typing:
 
Now, you need to synchronize the time with the hardware date/time by typing:
  
# hwclock --systohc
+
# hwclock --systohc
  
 
=== Where to from here ===
 
=== Where to from here ===
Line 226: Line 228:
 
You'll probably want to play with some of the interesting hardware in this device. Obviously, you can explore the applications available through the touch-screen interface. But for those who prefer doing things more in the raw from a shell prompt, you can [[Manually_using_GSM | manually use GSM]], [[Manually_using_SMS | manually use SMS]],  or you can start playing with the [[GPS]].
 
You'll probably want to play with some of the interesting hardware in this device. Obviously, you can explore the applications available through the touch-screen interface. But for those who prefer doing things more in the raw from a shell prompt, you can [[Manually_using_GSM | manually use GSM]], [[Manually_using_SMS | manually use SMS]],  or you can start playing with the [[GPS]].
  
<span id="bottom">{{Languages|Getting_Started_with_your_Neo1973}}</span>
+
[[Category:Neo1973 Phase 1 related/nl]]
 
+
[[Category:Documentation]]
+
[[Category:Neo1973_Phase_1_related]]
+

Latest revision as of 10:44, 12 January 2010


Dit is een handleiding voor de beginnende gebruiker van de Neo1973 telefoon. (nog niet compleet in het Nederlands vertaald)

Contents

[edit] Hardware

[edit] Aan de slag

: Een korte demonstratie van het in elkaar zetten van de telefoon is te zien op Google video’s: Open de achterkant van de telefoon, verwijder de batterij, verwijder de SIM-kaart, verwijder de micro-SD kaart, plaats de micro-SD kaart, plaats de SIM-kaart, plaats de batterij, sluit de achterkant

De micro-SD houder is te vinden onder de SIM-kaart houder, die weer te vinden is onder de batterij. Om toegang te krijgen tot één van deze onderdelen moet de achterklep van de telefoon verwijderd worden.

De SIM-kaart en de micro-SD geheugen kaart zijn optioneel, zonder deze onderdelen werkt Neo1973 ook. De SIM-kaart is een vereiste om gebruik te maken van het GSM-netwerk, de geheugenkaart kan gebruikt worden voor extra geheugenruimte.

[edit] Achterkant

Aan de bovenkant van de telefoon is een kleine inkeping aangebracht om de achterklep van de telefoon af te halen. (voor demonteren zie ook de eerste stap van Disassembling Neo1973 (en)).

Wanneer u klaar bent met de gewenste handeling, sluit dan de acherkant door de pinnetjes in de daarvoor aangebrachte openingen te plaatsen en vervolgens zachtjes te drukken.

[edit] Batterij

Om de batterij (informatie over de batterij) te verwijderen, haal de onderste rand omhoog met uw vingernagel.

Voor het sluiten van de klep: doe de batterij in de telefoon door de metalen contacten van de batterij tegen de drie metalen contacten van de telefoon te drukken en tegelijkertijd de batterij in de telefoon te drukken.

[edit] SIM-kaart (optioneel)

De SIM-kaart krijgt u van uw mobiele telefonie provider. De houder voor de SIM-kaart is te vinden onder de batterij. Op de metalen houder geven pijlen en tekst aan hoe de SIM-kaarthouder geopend en gesloten wordt. Wees voorzichtig, door teveel kracht te gebruiken kunt u de houder breken.

Schuif de SIM-kaarthouder in de richting van het woord OPEN en til hem op. De SIM-kaart kan uit en in de houder geschoven worden. Let er bij het plaatsen van de SIM-kaart op dat de gouden contacten op de kaart naar beneden gericht zijn. Om de houder weer te sluiten drukt u deze naar beneden en schuift u hem in de tegenstelde richting van woord OPEN.

Als het goed is maakt de Neo1973 na het opstarten verbinding met uw mobiele telefonie provider.

[edit] Micro-SD geheugenkaart (optioneel)

Als het goed is is met de telefoon ook een micro-SD (en) geheugenkaart geleverd. Probeer eens wat mp3 bestanden (of nog beter: Ogg Vorbis bestanden (open source tegenhanger van mp3)) naar de kaart te kopiëren en vervolgens af te spelen.

De micro-SD houder is te vinden onder de SIM-kaarthouder. Druk de micro-SD geheugenkaarthouder zachtjes in de richting van de batterijcontacten en til hem vervolgens op. De geheugenkaart kan nu in of uit de houder geschoven worden. Let op de metalen contactjes bij het plaatsen van de micro-SD kaart, de contacten op de kaart moeten bij het sluiten van de houder contact maken met de metalen contacten in de Neo1973. De houder is weer te sluiten door deze naar beneden te drukken en terug te schuiven (in tegengestelde richting dus van de batterijcontacten af).

De geheugenkaart wordt automatisch herkent bij het opstarten van de Neo1973 als mediacard / mediakaart.

[edit] Knoppen

De aan/uit knop is te vinden aan de rechterzijkant (onder) van het toestel, de AUX knop vindt u linksboven aan de zijkant van Neo1973.

De functies van de knoppen als de telefoon aan is:

  • Aan/uit knop kort indrukken: sluit de huidige applicatie.
  • Aan/uit knop 1 seconde indrukken: opent het power management menu.
  • Aan/uit knop 10 seconden indrukken: schakelt de Neo1973 uit.
  • Aux knop kort indrukken: gaat naar het scherm Vandaag.
  • Aux knop 1 seconde indrukken: opent het functie menu.

[edit] Accessoires

[edit] Stylus (griffel)

De stylus wordt geleverd met 2 sets batterijen voor the laser pointer en de leds voor de flashlight. Voor het plaatsen van de batterijen kan de stylus in het midden opengeschroefd worden.

Om de ballpoint- of styluskop te krijgen: draai het onderste deel van de stylus in de gewenste richting.

[edit] Hoofdtelefoon

De Neo wordt geleverd met een stereo hoofdtelefoon inclusief een microfoon en drukknop. Het stekkertje is een standaard 2,5mm four-conductor versie (anders dan de normale hoofdtelefoons die gebruik maken van 3,5mm stekkers). De ingang voor de hoofdtelefoon is te vinden aan de linkerzijkant van de Neo. Let op: druk het stekkertje ver genoeg naar binnen.

[edit] Koord

Het meegeleverde koord kan aan de onderkant van de telefoon bevestigd worden.

[edit] Powering up the phone

bootloader splash screen

Just hitting the power button (depending on your u-boot version you have to press for >= 5 seconds) should get the phone first into the bootloader, then boot the kernel, and get into X/Openmoko. The shipped battery typically has enough charge to boot up directly without charging through the usb cable first.

Once you have pressed the power button sufficiently long, the vibrator makes a short pulse and the screen backlight turns on. You can now release the power button and watch the phone booting.

If the battery is not sufficiently charged, the phone will not turn on, even if the usb cable is plugged in.

[edit] Flashing the Neo1973 GTA01Bv4

The GTA01Bv4 devices that are currently shipping do not boot out of the box. Flashing the phone with the latest kernel and supporting file system ("rootfs") is required before the phone will successfully boot.

Read more information at about Flashing the Neo 1973. MacOS X users please also refer to MacOS_X.

[edit] Powering down the phone

[edit] While in bootloader mode, or if the phone has crashed

If you press the power button for 9 seconds, the phone will switch off. You can notice this by the backlight going dark.

[edit] While running a full linux system with userspace

In this mode, a power-button press of 5 seconds will be sufficient. After this, the init process will take care of safely shutting down the phone, which might take up to 20 extra seconds. The X server should get killed, you should drop back to a (garbled) console, and it should finally switch off - much like a regular Linux PC.

[edit] Battery charging

See also Neo1973 Battery Charger

The Neo1973 supports two charging modes: One 100mA charge mode (called pre-charge) and 500mA (called fast charge). Charging is always done via the USB socket. You can use any USB-A to USB-mini-B cable to connect the phone to any USB host.

Note: If the Neo1973 battery completely drains it's possible that even after a long recharge you might not be able to power the phone on. To fix that you need to remove the battery, and leave it out for about a minute, then replace the battery and plug the phone back into a usb port. You should be able to power it on after a few minutes of charging.

[edit] While in u-boot

While you are in u-boot mode, the phone only charges with 100mA by default. (This will change in one of the future revisions).

However, using the u-boot console you can manually enable fast charging. See U-boot#Battery_charger_related for more information.

[edit] While in Linux

As soon as the phone is connected via USB cable, it will charge. However, the default charging current is only 100mA, way too little if you want to operate the phone and charge at the same time.

If your USB upstream port is capable of supplying 500mA, then it will configure the Neo1973 accordingly and use 500mA charging mode. You can notice this by the following line in the kernel log (/var/log/messages) of the Neo1973: usb0: full speed config #1: 500 mA, Ethernet Gadget, using CDC Ethernet

[edit] Getting shell access on the phone

[edit] By using the terminal emulator and on-screen keyboard

In Today (the main screen the phone boots to and which can always be accessed by pressing the AUX button), selecting (with a stylus or a thumb) the "+" tab in the center bottom of the screen shows the application launcher. Make sure the filter at the top of the window is set at "Applications" or "All", then drag upward on the list to scroll it until the Terminal application appears. Alternatively, you can toggle the magnifier glass in the filter and type "terminal" to the text box that appears. Click the application in the list to make it turn yellow and start - this might be difficult a first since any movement is interpreted as dragging rather than clicking.

The on-screen keyboard should appear whenever you choose a text entry. It can also be toggled by clicking on the tiny keyboard icon in the panel at the very top of the screen. More options are available via Input Manager which can be started in the application launcher filtered by "Utilities" or "All". A white box appears in the panel. It also can be used to toggle the keyboard. You can choose between different keyboard layouts and the stroke recognizer by dragging from the white box to the right of the box, which should make a menu appear.

[edit] By using Ethernet emulation over a USB cable

The standard Neo1973 Linux kernel has support for the "cdc_ether USB gadget", i.e. a standard implementation of how to emulate an Ethernet device over USB.

The following description is for generic *NIX system. For setting up connectivity specifically on a MacOS X machine, refer to MacOS_X (because there is no usb0 and you need a special kernel driver first).

As soon as the kernel is up and running, and you have the phone connected via USB, you should get a usb0 device on your host.

The Phone will have the IPv4 address 192.168.0.202/24. You can run `ifconfig` in the terminal on the phone to verify this (this is optional, just check it if it doesn't work given the instructions below)

If you plug a USB cable into a laptop running Linux, you'll likely see the "cdc_ether" kernel module being loaded and a usb0 network interface appear. If not, see USB_Networking for more details.

On the host PC, you should then configure your interface to 192.168.0.200 by using

  1. ifconfig usb0 192.168.0.200 netmask 255.255.255.0

Then you should be able to

  1. ping 192.168.0.202

and last, but not least

  1. ssh root@192.168.0.202

Once you press 'enter' (empty password), you should now have a root login.

See USB_Networking for more details, including instructions on how to automatically setup masquerading so that your phone can get access to the internet through the host PC.

Note: If you have a power management profile enabled on your device your ssh connection might appear to freeze when your phone tries to sleep. To stop this from occuring you need to hold the power button down for a few seconds until you get the menu with the "Power Off" option at the bottom. Once you do, you should select the "Profile: No PM" option. If your shell died and you want it back, you can do the following:

  1. modprobe -r cdc_ether
  2. modprobe -r cdc_acm

Then unplug the device and plug it back in after turning power-management off.

[edit] By using the debug board/serial/JTAG

Please see Debug Board#Usage_Instructions

[edit] Getting access to the bootloader console

Please see u-boot#Using_usbtty_from_Linux

[edit] Using Audio

[edit] Enable Internal Speaker and Mic in Phone Calls

If you got no Speaker and Mic during a Call you need to load the "gsmhandset.state" alsa-configfile

alsactl -f /etc/alsa/gsmhandset.state restore

Maybe you need to load another .state file for playing mp3 or a BT-Headset see in /etc/alsa/

To hear something you can find an .au file (or convert a .wav into an .au by using the sox tool):

sox ringtone_thereisnophone.wav -t raw -r 8012 -u -b -c 1 rigtone_thereisnophone.au

copy it to the device and run

cat ringtone_thereisnophone.au > /dev/dsp

[edit] Useful commands in Linux

[edit] Suspending

Writing "mem" into /sys/power/state tells Linux to suspend - it will enter a low power mode where only the GSM and RAM are powered up and the CPU sleeps. It will persist in this state until a wake-up event arrives. Some currently enabled wake-up events are: AUX or POWER key press, USB cable detect.

If you're connected over ssh, sshd will stop responding when the OS suspends, so to avoid locking up your ssh client, use the command

  1. (sleep 1; echo mem > /sys/power/state) & exit

[edit] Initial backup

After getting your new Neo1973 booted for the first time you might want to make a back up of the original flash chip contents on your PC, before you overwrite the flash with a custom image or just update to a newer build.

NOTE: For phase 0 developers only (GTA01Bv4 shippment 0, not > 0 ): This is a good idea because there are parts in the root filesystem that can't be distributed over internet so they are only found in the shipped ROM (see the GPS driver).


One easy way to back up all of the Flash, that doesn't require installing any special software, is with netcat over the USB ethernet. The following commands can be used for that.

On the host On the target
$ nc -l -p 20000 > mtdblock0
$ nc -l -p 20000 > mtdblock1
$ nc -l -p 20000 > mtdblock2
$ nc -l -p 20000 > mtdblock3
$ nc -l -p 20000 > mtdblock4
# cat /dev/mtdblock0 | nc 192.168.0.200 20000
# cat /dev/mtdblock1 | nc 192.168.0.200 20000
# cat /dev/mtdblock2 | nc 192.168.0.200 20000
# cat /dev/mtdblock3 | nc 192.168.0.200 20000
# cat /dev/mtdblock4 | nc 192.168.0.200 20000

This stores the five NAND partitions in files named mtdblock*. Knowing the partition layout (u-boot "mtdparts" command or Linux dmesg) you can restore the whole flash with it.

[edit] Setting date and time

To set the date and time you need to open a terminal or ssh to the device. To set the date and time to August 9 19:02 2007 type:

  1. date -s 080919022007

The screensaver might turn on as you execute this command - just tap the screen to get back.

Now, you need to synchronize the time with the hardware date/time by typing:

  1. hwclock --systohc

[edit] Where to from here

You'll probably want to play with some of the interesting hardware in this device. Obviously, you can explore the applications available through the touch-screen interface. But for those who prefer doing things more in the raw from a shell prompt, you can manually use GSM, manually use SMS, or you can start playing with the GPS.

Personal tools

Dit is een handleiding voor de beginnende gebruiker van de Neo1973 telefoon. (nog niet compleet in het Nederlands vertaald) Shipment 1 has some specifics limited to that batch.

Hardware

Aan de slag

: Een korte demonstratie van het in elkaar zetten van de telefoon is te zien op Google video’s: Open de achterkant van de telefoon, verwijder de batterij, verwijder de SIM-kaart, verwijder de micro-SD kaart, plaats de micro-SD kaart, plaats de SIM-kaart, plaats de batterij, sluit de achterkant

De micro-SD houder is te vinden onder de SIM-kaart houder, die weer te vinden is onder de batterij. Om toegang te krijgen tot één van deze onderdelen moet de achterklep van de telefoon verwijderd worden.

De SIM-kaart en de micro-SD geheugen kaart zijn optioneel, zonder deze onderdelen werkt Neo1973 ook. De SIM-kaart is een vereiste om gebruik te maken van het GSM-netwerk, de geheugenkaart kan gebruikt worden voor extra geheugenruimte.

Achterkant

Aan de bovenkant van de telefoon is een kleine inkeping aangebracht om de achterklep van de telefoon af te halen. (voor demonteren zie ook de eerste stap van Disassembling Neo1973 (en)).

Wanneer u klaar bent met de gewenste handeling, sluit dan de acherkant door de pinnetjes in de daarvoor aangebrachte openingen te plaatsen en vervolgens zachtjes te drukken.

Batterij

Om de batterij (informatie over de batterij) te verwijderen, haal de onderste rand omhoog met uw vingernagel.

Voor het sluiten van de klep: doe de batterij in de telefoon door de metalen contacten van de batterij tegen de drie metalen contacten van de telefoon te drukken en tegelijkertijd de batterij in de telefoon te drukken.

SIM-kaart (optioneel)

De SIM-kaart krijgt u van uw mobiele telefonie provider. De houder voor de SIM-kaart is te vinden onder de batterij. Op de metalen houder geven pijlen en tekst aan hoe de SIM-kaarthouder geopend en gesloten wordt. Wees voorzichtig, door teveel kracht te gebruiken kunt u de houder breken.

Schuif de SIM-kaarthouder in de richting van het woord OPEN en til hem op. De SIM-kaart kan uit en in de houder geschoven worden. Let er bij het plaatsen van de SIM-kaart op dat de gouden contacten op de kaart naar beneden gericht zijn. Om de houder weer te sluiten drukt u deze naar beneden en schuift u hem in de tegenstelde richting van woord OPEN.

Als het goed is maakt de Neo1973 na het opstarten verbinding met uw mobiele telefonie provider.

Micro-SD geheugenkaart (optioneel)

Als het goed is is met de telefoon ook een micro-SD (en) geheugenkaart geleverd. Probeer eens wat mp3 bestanden (of nog beter: Ogg Vorbis bestanden (open source tegenhanger van mp3)) naar de kaart te kopiëren en vervolgens af te spelen.

De micro-SD houder is te vinden onder de SIM-kaarthouder. Druk de micro-SD geheugenkaarthouder zachtjes in de richting van de batterijcontacten en til hem vervolgens op. De geheugenkaart kan nu in of uit de houder geschoven worden. Let op de metalen contactjes bij het plaatsen van de micro-SD kaart, de contacten op de kaart moeten bij het sluiten van de houder contact maken met de metalen contacten in de Neo1973. De houder is weer te sluiten door deze naar beneden te drukken en terug te schuiven (in tegengestelde richting dus van de batterijcontacten af).

De geheugenkaart wordt automatisch herkent bij het opstarten van de Neo1973 als mediacard / mediakaart.

Knoppen

De aan/uit knop is te vinden aan de rechterzijkant (onder) van het toestel, de AUX knop vindt u linksboven aan de zijkant van Neo1973.

De functies van de knoppen als de telefoon aan is:

  • Aan/uit knop kort indrukken: sluit de huidige applicatie.
  • Aan/uit knop 1 seconde indrukken: opent het power management menu.
  • Aan/uit knop 10 seconden indrukken: schakelt de Neo1973 uit.
  • Aux knop kort indrukken: gaat naar het scherm Vandaag.
  • Aux knop 1 seconde indrukken: opent het functie menu.

Accessories

Stylus

The stylus as shipped has three batteries in it, providing for the laser pointer and flashlight LEDs. A set of replacement batteries is also included. The stylus can be twisted open in middle to access the batteries.

To use the ballpoint or stylus head, turn the bottom part of the stylus to either direction.

Headset

The Neo ships with a stereo headset including a microphone and a push button. The plug is a standard 2.5 mm four-conductor version, though it differs from standard 3.5 mm headphones. The black socket is on the left side of the phone, and the last millimeter is somewhat firmer so make sure you push the plug all the way.

Lanyard

The provided lanyard can be attached to the hole in the bottom part of the phone. Put the loose end through the phone, through the two metal loops in the lanyard, between the metal loops and back through the first metal loop.

Powering up the phone

bootloader splash screen

Just hitting the power button (depending on your u-boot version you have to press for >= 5 seconds) should get the phone first into the bootloader, then boot the kernel, and get into X/OpenMoko. The shipped battery typically has enough charge to boot up directly without charging through the usb cable first.

Once you have pressed the power button sufficiently long, the vibrator makes a short pulse and the screen backlight turns on. You can now release the power button and watch the phone booting.

If the battery is not sufficiently charged, the phone will not turn on, even if the usb cable is plugged in.

Flashing the Neo1973 GTA01Bv4

The GTA01Bv4 devices that are currently shipping do not boot out of the box. Flashing the phone with the latest kernel and supporting file system ("rootfs") is required before the phone will successfully boot.

Read more information at about Flashing openmoko. MacOS X users please also refer to MacOS_X.

Powering down the phone

While in bootloader mode, or if the phone has crashed

If you press the power button for 9 seconds, the phone will switch off. You can notice this by the backlight going dark.

While running a full linux system with userspace

In this mode, a power-button press of 5 seconds will be sufficient. After this, the init process will take care of safely shutting down the phone, which might take up to 20 extra seconds. The X server should get killed, you should drop back to a (garbled) console, and it should finally switch off - much like a regular Linux PC.

Battery charging

See also Neo1973 Battery Charger

The Neo1973 supports two charging modes: One 100mA charge mode (called pre-charge) and 500mA (called fast charge). Charging is always done via the USB socket. You can use any USB-A to USB-mini-B cable to connect the phone to any USB host.

Note: If the Neo1973 battery completely drains it's possible that even after a long recharge you might not be able to power the phone on. To fix that you need to remove the battery, and leave it out for about a minute, then replace the battery and plug the phone back into a usb port. You should be able to power it on after a few minutes of charging.

While in u-boot

While you are in u-boot mode, the phone only charges with 100mA by default. (This will change in one of the future revisions).

However, using the u-boot console you can manually enable fast charging. See U-boot#Battery_charger_related for more information.

While in Linux

As soon as the phone is connected via USB cable, it will charge. However, the default charging current is only 100mA, way too little if you want to operate the phone and charge at the same time.

If your USB upstream port is capable of supplying 500mA, then it will configure the Neo1973 accordingly and use 500mA charging mode. You can notice this by the following line in the kernel log (/var/log/messages) of the Neo1973:

usb0: full speed config #1: 500 mA, Ethernet Gadget, using CDC Ethernet

Getting shell access on the phone

By using the terminal emulator and on-screen keyboard

In Today (the main screen the phone boots to and which can always be accessed by pressing the AUX button), selecting (with a stylus or a thumb) the "+" tab in the center bottom of the screen shows the application launcher. Make sure the filter at the top of the window is set at "Applications" or "All", then drag upward on the list to scroll it until the Terminal application appears. Alternatively, you can toggle the magnifier glass in the filter and type "terminal" to the text box that appears. Click the application in the list to make it turn yellow and start - this might be difficult a first since any movement is interpreted as dragging rather than clicking.

The on-screen keyboard should appear whenever you choose a text entry. It can also be toggled by clicking on the tiny keyboard icon in the panel at the very top of the screen. More options are available via Input Manager which can be started in the application launcher filtered by "Utilities" or "All". A white box appears in the panel. It also can be used to toggle the keyboard. You can choose between different keyboard layouts and the stroke recognizer by dragging from the white box to the right of the box, which should make a menu appear.

By using Ethernet emulation over a USB cable

The standard Neo1973 Linux kernel has support for the "cdc_ether USB gadget", i.e. a standard implementation of how to emulate an Ethernet device over USB.

The following description is for generic *NIX system. For setting up connectivity specifically on a MacOS X machine, refer to MacOS_X (because there is no usb0 and you need a special kernel driver first).

As soon as the kernel is up and running, and you have the phone connected via USB, you should get a usb0 device on your host.

The Phone will have the IPv4 address 192.168.0.202/24. You can run `ifconfig` in the terminal on the phone to verify this (this is optional, just check it if it doesn't work given the instructions below)

If you plug a USB cable into a laptop running Linux, you'll likely see the "cdc_ether" kernel module being loaded and a usb0 network interface appear. If not, see USB_Networking for more details.

On the host PC, you should then configure your interface to 192.168.0.200 by using

# ifconfig usb0 192.168.0.200 netmask 255.255.255.0

Then you should be able to

# ping 192.168.0.202

and last, but not least

# ssh root@192.168.0.202

Once you press 'enter' (empty password), you should now have a root login.

See USB_Networking for more details, including instructions on how to automatically setup masquerading so that your phone can get access to the internet through the host PC.

Note: If you have a power management profile enabled on your device your ssh connection might appear to freeze when your phone tries to sleep. To stop this from occuring you need to hold the power button down for a few seconds until you get the menu with the "Power Off" option at the bottom. Once you do, you should select the "Profile: No PM" option. If your shell died and you want it back, you can do the following:

# modprobe -r cdc_ether 
# modprobe -r cdc_acm

Then unplug the device and plug it back in after turning power-management off.

By using the debug board/serial/JTAG

Please see Debug Board#Usage_Instructions

Getting access to the bootloader console

Please see u-boot#Using_usbtty_from_Linux

Using Audio

Enable Internal Speaker and Mic in Phone Calls

If you got no Speaker and Mic during a Call you need to load the "gsmhandset.state" alsa-configfile

alsactl -f /etc/alsa/gsmhandset.state restore

Maybe you need to load another .state file for playing mp3 or a BT-Headset see in /etc/alsa/

To hear something you can find an .au file (or convert a .wav into an .au by using the sox tool):

sox ringtone_thereisnophone.wav -t raw -r 8012 -u -b -c 1 rigtone_thereisnophone.au

copy it to the device and run

cat ringtone_thereisnophone.au > /dev/dsp

Useful commands in Linux

Suspending

Writing "mem" into /sys/power/state tells Linux to suspend - it will enter a low power mode where only the GSM and RAM are powered up and the CPU sleeps. It will persist in this state until a wake-up event arrives. Some currently enabled wake-up events are: AUX or POWER key press, USB cable detect.

If you're connected over ssh, sshd will stop responding when the OS suspends, so to avoid locking up your ssh client, use the command

# (sleep 1; echo mem > /sys/power/state) & exit

Initial backup

After getting your new Neo1973 booted for the first time you might want to make a back up of the original flash chip contents on your PC, before you overwrite the flash with a custom image or just update to a newer build.

NOTE: For phase 0 developers only (GTA01Bv4 shippment 0, not > 0 ): This is a good idea because there are parts in the root filesystem that can't be distributed over internet so they are only found in the shipped ROM (see the GPS driver).


One easy way to back up all of the Flash, that doesn't require installing any special software, is with netcat over the USB ethernet. The following commands can be used for that.

On the host On the target
$ nc -l -p 20000 > mtdblock0
$ nc -l -p 20000 > mtdblock1
$ nc -l -p 20000 > mtdblock2
$ nc -l -p 20000 > mtdblock3
$ nc -l -p 20000 > mtdblock4
# cat /dev/mtdblock0 | nc 192.168.0.200 20000
# cat /dev/mtdblock1 | nc 192.168.0.200 20000
# cat /dev/mtdblock2 | nc 192.168.0.200 20000
# cat /dev/mtdblock3 | nc 192.168.0.200 20000
# cat /dev/mtdblock4 | nc 192.168.0.200 20000

This stores the five NAND partitions in files named mtdblock*. Knowing the partition layout (u-boot "mtdparts" command or Linux dmesg) you can restore the whole flash with it.

Setting date and time

To set the date and time you need to open a terminal or ssh to the device. To set the date and time to August 9 19:02 2007 type:

# date -s 080919022007

The screensaver might turn on as you execute this command - just tap the screen to get back.

Now, you need to synchronize the time with the hardware date/time by typing:

# hwclock --systohc

Where to from here

You'll probably want to play with some of the interesting hardware in this device. Obviously, you can explore the applications available through the touch-screen interface. But for those who prefer doing things more in the raw from a shell prompt, you can manually use GSM, manually use SMS, or you can start playing with the GPS.