Getting Started with your Neo 1973

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(By using ethernet over a USB cable: SSH login to the local machine?)
Line 1: Line 1:
FIXME: Some first steps guide for our phase-0 recipients.
+
Some first steps guide for those who have just received their first Neo1973 hardware
  
The software install I have on a phone right now is several months old -- until I upgrade it, these instructions might not all be relevant.
+
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/GPE.
  
Just hitting the power button should get the phone booted and running X/GPE.  From this point, there are a few ways to hack on the phone:
+
From this point, there are a few ways to hack on the phone:
  
 
== By using the terminal emulator and on-screen keyboard ==
 
== By using the terminal emulator and on-screen keyboard ==
Line 11: Line 11:
 
From the desktop, choose "Active tasks->rxvt" to get a root shell.
 
From the desktop, choose "Active tasks->rxvt" to get a root shell.
  
== By using ethernet over a USB cable ==
+
== By using Ethernet emulation over a USB cable ==
  
You can run `ifconfig` in the terminal to see which IP the phone has taken.  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.  The IP the phone I have was set to use is 192.168.2.2; on my Linux machine, I did:
+
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.
  
  ifconfig usb0 192.168.2.2 netmask 255.255.255.0 
+
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.
  ssh root@192.168.2.2
+
  <hit enter when asked for a password>
+
  
You should now have a root login.
+
The Phone will have the IPv4 address 192.168.0.202/24.  You can run `ifconfig` in the terminal to verify this.
  
* One of these IPs should probably be 192.168.2.1
+
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.
  
* [[User:DanielWillmann|DanielWillmann]] 23:06, 27 February 2007 (CET)
+
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
  
== By using the debug board/serial/JTAG ==
+
Then you should be able to
 +
ping 192.168.0.202
  
I don't have a debug board yet; this will be added later.
+
and last, but not least
 +
ssh root@192.168.0.202
 +
 
 +
Once you press 'enter' (empty password), you should now have a root login.
 +
 
 +
== By using the debug board/serial/JTAG ==
  
[[User:Cjb|Cjb]] 23:14, 23 February 2007 (CET)
+
TBD.

Revision as of 03:01, 28 February 2007

Some first steps guide for those who have just received their first Neo1973 hardware

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/GPE.

From this point, there are a few ways to hack on the phone:

By using the terminal emulator and on-screen keyboard

"Click" (using a stylus) the top-left arrow icon to get a drop-down menu with "Media", "Settings", "Utilities" and "Desktop". Choose "Utilities->Panel->Input Manager", and a keyboard icon will appear on the top bar. You can get an on-screen keyboard at any time by choosing it.

From the desktop, choose "Active tasks->rxvt" to get a root shell.

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.

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 to verify this.

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.

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.

By using the debug board/serial/JTAG

TBD.

Personal tools

Some first steps guide for those who have just received their first Neo1973 hardware

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/GPE.

From this point, there are a few ways to hack on the phone:

By using the terminal emulator and on-screen keyboard

"Click" (using a stylus) the top-left arrow icon to get a drop-down menu with "Media", "Settings", "Utilities" and "Desktop". Choose "Utilities->Panel->Input Manager", and a keyboard icon will appear on the top bar. You can get an on-screen keyboard at any time by choosing it.

From the desktop, choose "Active tasks->rxvt" to get a root shell.

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.

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 to verify this.

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.

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.

By using the debug board/serial/JTAG

TBD.