Getting Started with your Neo 1973 - Revision history

Marko Knöbl: moved information to Manuals/Neo 1973: See Openmoko Wiki Editing Guidelines#Manuals

2009-08-03T22:03:48Z

moved information to Manuals/Neo 1973: See Openmoko Wiki Editing Guidelines#Manuals

Show changes

Phobie: /* Micro-SD card (optional) */ linkfix

2009-02-12T14:27:41Z

‎Micro-SD card (optional): linkfix

Tyler Oderkirk: Capitalized "Linux"

2008-12-01T03:11:47Z

Capitalized "Linux"

Phobie: linkfix

2008-10-22T14:32:40Z

linkfix

Tyler Oderkirk: /* Where to from here */

2008-09-28T05:31:25Z

‎Where to from here

Kempelen: Remove broken link to Shipment 1 deleted page.

2008-09-16T21:44:02Z

Remove broken link to Shipment 1 deleted page.

Salahx: Link directly

2008-09-03T21:01:20Z

Link directly

DolfjeBot1: Replacing 'OpenMoko' with 'Openmoko'

2008-08-22T23:00:51Z

Replacing 'OpenMoko' with 'Openmoko'

Dolfje at 22:16, 15 August 2008

2008-08-15T22:16:02Z

Galadh: Getting Started with your Neo1973 moved to Getting Started with your Neo 1973: See Openmoko Wiki Editing Guidelines

2008-07-13T10:07:14Z

Getting Started with your Neo1973 moved to Getting Started with your Neo 1973: See Openmoko Wiki Editing Guidelines

@@ Line 79: / Line 79: @@
 ==== Micro-SD card (optional) ====
-You should have received a [[micro-SD]] memory card with your phone. You might want to copy some mp3 (or better Ogg Vorbis) files to it to try media playback.
+You should have received a [[microSD]] memory card with your phone. You might want to copy some mp3 (or better Ogg Vorbis) files to it to try media playback.
 The micro-SD slot is right under the SIM slot. Gently slide the micro-SD holder toward the battery contacts to unlock it. Lift up the holder. To remove a card, simply slide it out.

@@ Line 106: / Line 106: @@
 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 ====
+==== 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.

@@ Line 1: / Line 1: @@
 {{Neo1973}}
 This is a guide of some first steps for those who have just received their first [[Neo1973]] phone.
 == Overview of the device ==
@@ Line 39: / Line 39: @@
 The Neo ships with a stereo headset including a microphone and a push button. See [[#Interconnections]] above for connecting.
 Also included are replacement rubber earbud sleaves in various sizes.
 ==== Lanyard ====
@@ Line 63: / Line 63: @@
 ==== Battery ====
 To remove the [[battery]], lift its bottom edge with your fingernail.
 Before closing the cover, insert the battery by pushing it against the three metal springs with the contacts aligned and pressing the bottom edge of the battery down into the case.
 ==== SIM card (optional) ====
 The [[SIM card]] is obtained from a cell network operator. The slot for the SIM card is found just under the battery.  The metallic card holder has arrows and text indicating which way to push it to lock and unlock it - make sure you don't open it with force when it's locked or it may break.
 Click the holder unlocked and open it up. To remove the SIM card, slide it out of the holder.
@@ Line 124: / Line 124: @@
 ==== 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
+usb0: full speed config #1: 500 mA, Ethernet Gadget, using CDC Ethernet
 == Getting shell access on the phone ==
@@ Line 133: / Line 133: @@
 === 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.
@@ Line 143: / Line 143: @@
 The following description is for generic *NIX system. For setting up connectivity specifically on a MacOS X machine, refer to [[MacOS_X]]. Older Mac OS X versions did not include a CDC Ethernet driver, you might have to install one first. There are also issues with Leopard.
 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)
@@ Line 150: / Line 150: @@
 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
- # ping 192.168.0.202
+# ping 192.168.0.202
 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.
@@ Line 164: / Line 164: @@
 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.
@@ Line 181: / Line 181: @@
 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/
@@ Line 187: / Line 187: @@
 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
- cat ringtone_thereisnophone.au > /dev/dsp
+cat ringtone_thereisnophone.au > /dev/dsp
 By default, calls pick up a lot of ambient noise and drown out the caller's voice. [[User:TonyGarnockJones|Here is a fix]]
@@ Line 202: / Line 202: @@
 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 ===
@@ Line 226: / Line 226: @@
 |}
-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.
+This stores the five NAND [[Neo 1973 Partitions|partitions]] in files named mtdblock*.  Knowing the partition layout (u-boot "mtdparts" command or Linux dmesg) you can restore the whole flash with it.
 {{note|On some recent netcat (ex.: the one on Fedora 8), semantic changed and using -l and -p is an error. On the host, you could have to run:
 <pre>
 $ nc -l 20000 > mtdblock0
@@ Line 242: / Line 242: @@
 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.
@@ Line 248: / Line 248: @@
 Now, you need to synchronize the time with the hardware date/time by typing:
- # hwclock --systohc
+# hwclock --systohc
 === Where to go from here ===

@@ Line 250: / Line 250: @@
   # hwclock --systohc
-=== Where to from here ===
+=== Where to go 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_using_GSM | manually use GSM]], [[Manually_using_SMS | manually use SMS]],  or you can start playing with the [[GPS]].

@@ Line 1: / Line 1: @@
 {{Neo1973}}
-This is a guide of some first steps for those who have just received their first [[Neo1973]] phone. [[Shipment 1]] has some specifics limited to that batch.
+This is a guide of some first steps for those who have just received their first [[Neo1973]] phone.
 == Overview of the device ==

@@ Line 98: / Line 98: @@
 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 ===

@@ Line 89: / Line 89: @@
 === Powering up the phone ===
 [[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.

← Older revision		Revision as of 22:16, 15 August 2008
Line 1:		Line 1:
−	{{~~Box~~}}	+	{{Neo1973}}

	This is a guide of some first steps for those who have just received their first [[Neo1973]] phone. [[Shipment 1]] has some specifics limited to that batch.		This is a guide of some first steps for those who have just received their first [[Neo1973]] phone. [[Shipment 1]] has some specifics limited to that batch.