= Neo1973 side =

== Name resolution ==

By default Neo1973 has usb0 interface working due to Ethernet gadget (g_ether) compiled into kernel.

On the Neo, if you want to reach out to the internets using full qualified hostnames, you need to define your DNS server. Create a file /etc/resolv.conf with at least one line saying

nameserver xxx.xxx.xxx.xxx

e.g. nameserver 192.168.1.1

Then you can also easily update your 2007.2 OpenMoko packages with "ipkg update && ipkg upgrade" on the Neo.

A better approach is to symlink

ln -s /var/run/resolv.conf /etc/resolv.conf

and fill the file at bootup with a script /etc/network/if-up.d/08setupdns containing:

#!/bin/sh -e
echo nameserver 192.168.0.200 > /var/run/resolv.conf

this way the file is correctly handled from ppp package when dialing into gprs.

== Routing ==

You need a additional route for traffic to the internet. This traffic can be routed through your pc (see below) if the pc is the default route destination. you can achieve this by adding

gateway 192.168.0.200

to your /etc/network/interfaces in the usb0 section.

= Desktop side =

== Manual method ==

With the device connected, modprobe usbnet module and configure usb0 interface (as root):
<pre>
ifconfig usb0 192.168.0.200 netmask 255.255.255.0
</pre>
If your eth0 interface is also in the same 'range' (e.g. 192.168.0.105) then you can do the following:

1. ping the Neo with
# ping -I usb0 192.168.0.202
2. add a route to your Neo:
# /sbin/route add -host 192.168.0.202/32 dev usb0
3 log in to the Neo
# ssh root@192.168.0.202

If you don't have the necessary modules to get usb0 going, make sure you have the following kernel options enabled:
* CONFIG_USB_USBNET
* CONFIG_USB_NET_CDCETHER
Both options are available in the Device Drivers -> USB support -> USB Network Adapters. For more info see the [http://www.linux-usb.org/usbnet/ usbnet driver homepage].

== Automatic method ==

Took from [http://blog.haerwu.biz/2007/03/22/hotpluging-usbnet/ Hotplugging usbnet] post by Marcin 'Hrw' Juszkiewicz.

=== Debian or similar ===
Edit /etc/network/interfaces:
<pre>
allow-hotplug usb0
iface usb0 inet static
address 192.168.0.200
netmask 255.255.255.0
network 192.168.0.0
post-up iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
post-up echo 1 > /proc/sys/net/ipv4/ip_forward
post-up iptables -P FORWARD ACCEPT
</pre>

=== Ubuntu (Tested with Feisty and Gutsy) ===
Edit /etc/network/interfaces:
<pre>
auto usb0
iface usb0 inet static
address 192.168.0.200
netmask 255.255.255.0
network 192.168.0.0
up iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24 &
up echo 1 > /proc/sys/net/ipv4/ip_forward &
up iptables -P FORWARD ACCEPT &
down iptables -D POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24 &
</pre>

If you are doing the echo 1 > /proc/... command manually, sudo may not be enough, then you will have to execute it from a sudo bash.

Ubuntu Feisty and Gutsy appear to have a bug where ifdown is not run when the interface is unplugged, meaning this only works once after the system is booted.
One can patch /etc/udev/rules.d/85-ifupdown.rules, editing the two lines at the end of the file:
<pre>
SUBSYSTEM=="net", DRIVERS=="?*", GOTO="net_start"
GOTO="net_end"

LABEL="net_start"

# Bring devices up and down only if they're marked auto.
# Use start-stop-daemon so we don't wait on dhcp
ACTION=="add", RUN+="/sbin/start-stop-daemon --start --background --pidfile /var/run/network/bogus --startas /sbin/ifup -- --allow auto $env{INTERFACE}"

LABEL="net_end"

ACTION=="remove", RUN+="/sbin/start-stop-daemon --start --background --pidfile /var/run/network/bogus --startas /sbin/ifdown -- --allow auto $env{INTERFACE}"
</pre>

the bug is that the LABEL="net_end" is at the wrong position
=== SuSE ===
/etc/sysconfig/network/ifcfg-usb0
# USB configuration for PDAs (openmoko)
IPADDR=192.168.0.200
NETMASK=255.255.255.0
STARTMODE=onboot
=== Fedora (Tested with FC8) ===
/etc/sysconfig/network-scripts/ifcfg-usb0
<pre>
# USB configuration for PDAs (openmoko)
# from http://www.handhelds.org/moin/moin.cgi/UsbNet
DEVICE=usb0
BOOTPROTO=none
IPADDR=192.168.0.200
NETMASK=255.255.255.0
ONBOOT=yes
</pre>

=== Red Hat or similar ===
Edit /etc/sysconfig/network-scripts/net.hotplug:

After this command
<pre>
case $INTERFACE in
# interfaces that are registered after being "up" (?)
</pre>
add
<pre>
usb0)
ifconfig usb0 192.168.0.200 netmask 255.255.255.0
route add 192.168.0.202 usb0
iptables -I INPUT 1 -s 192.168.0.202 -j ACCEPT
iptables -I OUTPUT 1 -s 192.168.0.200 -j ACCEPT
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
echo 1 > /proc/sys/net/ipv4/ip_forward
exit 0
;;
</pre>
=== Gentoo ===
* Open /etc/conf.d/net and add:
# Neo1973
config_usb0=( "192.168.0.200 netmask 255.255.255.0" )
routes_usb0=( "192.168.0.202/32 via 192.168.0.200" )
* Create a new init script:
cd /etc/init.d
ln -s net.lo net.usb0
* Put iptables into use:
iptables -I INPUT 1 -s 192.168.0.202 -j ACCEPT
iptables -I OUTPUT 1 -s 192.168.0.200 -j ACCEPT
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
* Store them
/etc/init.d/iptables save
* If you want the routing by default:
rc-update add iptables default
=== MacOS X ===
See the [[MacOS_X#USB_Networking|USB Networking section in the MacOS X article]]

= Mobile development =

== Proxying DNS requests ==

If, like me, you move about quite a lot, connecting to various networks as you go and getting your ip via dhcp, you'll probably be annoyed at having to constantly update your resolv.conf on the Neo 1973.

To get round this, as part of my setup script, I run a proxy dns on the ip address the neo comes in on at the usb0 port. This means that my Neo /etc/resolv.conf only contains:

nameserver 192.168.0.200

and my laptop will proxy all dns requests based on it's own /etc/resolv.conf

'''note that we only run the dns proxy on the usb0 interface so that we don't break any other networking'''

=== Proxying with dnrd ===

The script is designed to use [http://dnrd.sourceforge.net/ dnrd] as the dns proxy. The [http://buildhost.automated.it/gta01 script] and a copy of [http://buildhost.automated.it/dnrd-2.20.3.tar.gz dnrd] are available from my site. The script also performs the initial setup of the connection as per the [[USB_Networking#Manual_method]] above.

=== Proxying with a UDP forwarder ===
Another easy setup is using a udp forwarder like the one from http://www.tapor.com/udpf/ - is use it with the command

udpf-elf\
-p=53\
-f=`cat /etc/resolv.conf|awk '$1 == "nameserver"{print $2; exit(0);}'`:53

=== Proxying with iptables ===
Its is possible to forward DNS requests with iptables using the DNAT target

iptables -t nat -A PREROUTING -p tcp -s 192.168.0.202 -d 192.168.0.200 --dport domain -j DNAT --to-destination 192.168.0.1
iptables -t nat -A PREROUTING -p udp -s 192.168.0.202 -d 192.168.0.200 --dport domain -j DNAT --to-destination 192.168.0.1

where <tt>192.168.0.1</tt> is the IP of your residential gateway (router). This is the easiest method, but its not recommended if you have a direct connection to the Internet as ISP DNS servers can change, and this does no load-balancing.

= Connecting to phone =

Then <tt>ssh root@192.168.0.202</tt> with empty password to get into phone.

NOTE: the ssh daemon (dropbear 0.49) on the OpenMoko appears to have a bug when sending the exit status back to the client. From time to time you receive an exit status of 255.

===SSH Extras===

If you get fed up with typing root@192.168.0.202, on your PC edit /etc/hosts and add an entry for 'phone'

192.168.0.202 phone

then edit ~/.ssh/config (or create it) and add

host phone
user root

then all you need to do is type

# ssh phone

To avoid ssh added a new line for every ssh host-key to you known_hosts you can add the following to the phone section in ~/.ssh/config

UserKnownHostsFile /dev/null

You might want to use keys to bypass the login prompt too.

===SSH Keys===
====From host to phone====

To generate ssh keys for use as a login mechanism type

ssh-keygen -t rsa

when prompted for a password either hit enter for no password (''not really a good idea'') or enter a password for this key. ssh into the phone and create ~/.ssh

# mkdir ~/.ssh

then from your PC copy the '''.pub''' file to the phone.

# scp ~/.ssh/id_rsa.pub phone:.ssh/authorized_keys

You should now be able to ssh directly into the phone.

To disable password logins ('''after setting up key access''') edit /etc/init.d/dropbear and change the following line:

DROPBEAR_EXTRA_ARGS=

to

DROPBEAR_EXTRA_ARGS="-s"

You will need to restart dropbear for this to take effect.

====From phone to host====
Generate the key

dropbearkey -t rsa -f id_rsa

The output will look something like this:

Will output 1024 bit rsa secret key to 'id_rsa'
Generating key, this may take a while...
Public key portion is:
ssh-rsa AAAAB3Nza[...]
Fingerprint: md5 ca:e8:f0:b7:f6:7b:c2:b6:b9:71:e4:45:86:a9:ff:b8

Copy and paste the one line (in this example, starting with 'ssh-rsa' onto the end of the host's authorized_keys file (often in ~/.ssh/).

From the phone, ssh with -i:

ssh -i id_rsa user@host

This works for me. I ripped off these instructions from: [[http://forum.openwrt.org/viewtopic.php?pid=53705]]

===GUI on desktop through SSH===

If you need to get the GUI on the phone onto the desktop via usb, you can use ssh as follows

ssh -l root -X -v 192.168.0.202

Login, and run openmoko-finger-demo for example, and it will open up on the desktop. To get landscape view, just resize the GUI window on the desktop.

===Remote apps on neo===

To get desktop apps to show up on your neo, first log in to the phone

ssh -l root 192.168.0.202

Then once inside, run:

DISPLAY=:0 xhost +192.168.0.200

After this you can close the ssh session. Back on the desktop computer, run:

DISPLAY=moko:0 xclock

Note that the xhost command will allow remote applications on 192.168.0.200 to access the X server. It will allow anyone on the desktop machine to access the X server of the neo, including snooping anything you type on it. To disallow remote applications again, run this in the neo:

DISPLAY=:0 xhost -192.168.0.200


{{Languages|USB Networking}}

[[Category:Hardware]]
[[Category:Implemented]]

2007-11-20T13:50:36Z

BernhardKaindl: /* Tips */ Moved the link to the Qtopia forum area from the Main Page here.

{{Languages|Qtopia_on_Neo_1973}}

== Installation ==

=== Qtopia image ===
Get "Qtopia on Neo Flash Image and kernel" [http://www.qtopia.net/modules/devices/openmoko.php from here]. Currently the flash tarball has the 2.6.21 openmoko kernel and a Qtopia phone edition jffs2 flash image cross-compiled for the Neo.

Newer unofficial Qtopia images can be found in the ScaredyCat [[repositories]].

It appears you must clear the flash chunks first (if you have not updated your uboot. If you have, you may skip this step). Get into uboot console [http://wiki.openmoko.org/wiki/Uboot#Accessing_the_bootloader_prompt] and enter

nand erase kernel
nand erase rootfs

Download and use dfu-util as [[Flashing_openmoko|normal]] and the ip address and cidr are the same as the openmoko build (192.168.0.202/24) :D - Simple, Eh?

=== Qtopia AND OpenMoko Option 1 ===
Why choose when you can have both ;)

If you do not already have a recent version of OpenMoko on your Neo1973, have a look at [[Flashing openmoko]].

{{warning|The following step will reformat your MircoSD card with the ext3 filesystem. We need it because we need support for symbolic or/and static links, which other filesystems like FAT do not support directly. After reformatting, no data on the card will be accessible to you anymore, so create good backups of anything which you need before starting!}}

Then ssh to your neo and reformat your MicroSD card with:
umount /dev/mmcblk0p1
mkfs.ext3 /dev/mmcblk0p1
mount /dev/mmcblk0p1

On your desktop: Get "Developer root filesystem" [http://www.qtopia.net/modules/devices/openmoko.php from here]. Get the opt/Qtopia folder plus the qpe init script out of the archive repack and copy it to your neo. One could do this like this:
tar xzf ficgta01-qtopia-developer-rootfs.tgz opt/Qtopia etc/init.d/qpe
mv opt/Qtopia etc/init.d/qpe . && rm -r opt etc
tar czf Qtopia.tar.gz Qtopia qpe
scp Qtopia.tar.gz root@192.168.0.202:/media/card/

On your neo again: unpack the archive you just copied and link the Qtopia folder to /opt/Qtopia. Then move the init script to /etc/init.d/:
cd /media/card
tar xzf Qtopia.tar.gz
mkdir -p /opt
ln -s /media/card/Qtopia /opt/Qtopia
mv qpe /etc/init.d

Now kill the x server and gsmd and start Qtopia (this can take some time):
/etc/init.d/xserver-nodm stop
/etc/init.d/gsmd stop
/etc/init.d/qpe start

Where from here? You could put the last step in a script and start it from a terminal on your phone. But much nicer would be if you could choose between both interfaces on init time and have some small application in Qtopia/OpenMoko to switch.

=== Qtopia AND OpenMoko Option 2 ===

* format your SD card with ext3 and mount it (see above)
* unpack rootfs from qtopia-4.3.0-preview-neo-flash.tgz to SD card (see above)
* copy the uImage-2.6.22.5-moko11-r2-fic-gta01.bin kernel to the boot/ on SD card and rename it to uImage
* put a 'Boot from SD' menu item in uboot menu as explained here: [[Booting_from_SD#Step_3:_Add_uboot_boot_entry]]

=== Build your own ===
If you want to build qtopia for yourself you can download the [ftp://ftp.trolltech.com/qtopia/tech-preview/ technical preview] or [ftp://ftp.trolltech.com/qtopia/snapshots/ snapshots]

== Tips ==
Most things seem to work out of the box, however you may need to use the following command to get audio:
alsactl -f /etc/gsmhandset.state restore
Or put this command in /etc/init.d/qpe line 64

Do not switch themes. Only the default theme is usable. For example, once you switch themes, the lock feature continues to work, but only if you unlock using the smallest # keypad in the world.

Suspend support is very flaky. The neo often shuts off from a suspend state. It will not wake from suspend for an incoming call or text message (someone try setting an alarm and report results here). To turn suspend off (this will of course use the batteries very quickly), hit the down arrow next to the suspend setting in the power management until it says "Off".

When using the virtual keyboard, do a quick flick up or down over the keyboard to access numbers/symbols/capitals.

In summary, Qtopia on the Neo1973 is much closer to being ready than OpenMoko as of this writing. However, sound and suspend support prevent it from being at all useful as a cell phone (as a landline that doesn't ring but instead vibrates, it works ok).

The [http://www.qtopia.net/modules/newbb_plus/viewtopic.php?topic_id=473&forum=4 Qtopia forum area on the FIC GTA01] might be helpful, but it is preferred that you update this section with issues and fixes which you find.

== Screenshots ==

Here are some screenshots of Qtopia runing on a Neo 1973. Personally I find it very impressive...

{|
|-
|[[Image:Qtopia001.png|thumb|center|300px]]
|[[Image:Qtopia002.png|thumb|center|300px]]
|[[Image:Qtopia003.png|thumb|center|300px]]
|-
|[[Image:Qtopia004.png|thumb|center|300px]]
|[[Image:Qtopia005.png|thumb|center|300px]]
|[[Image:Qtopia006.png|thumb|center|300px]]
|}

== Videos ==

http://www.youtube.com/watch?v=YW5q8SpY7t4
http://www.youtube.com/watch?v=iOG_mtSEMgs

For full size videos, 346 MiB:

http://linuxtracker.org/download.php?id=4613&name=qt_on_neo1973_videos.torrent

Main Page

2007-11-20T04:11:35Z

BernhardKaindl: Turned the "Latest status" section into a table with color background (actually copied from "What is your interest", you may want to find a different color for the copy but it can stay as it is also)

{{Languages|Main_Page}}
__NOTOC__
__NOEDITSECTION__
__NOTOC__
{| cellspacing="5" cellpadding="0" style="padding: 2%; margin:0em 0em 1em 0em; border:1px solid #F9D163; background:#FCE9B4; width:100%"
| <big>'''Welcome to the [[OpenMoko]]™ public Wiki'''</big> 
|}

[[Image:FIC-neo1973_small.jpg|200px|right|frontside]]
OpenMoko™ is an [http://en.wikipedia.org/wiki/Open_source Open Source] project to create the world's first free mobile phone operating system which runs a full X server and can therefore run most X applications.

The [[OpenMoko]] project is a community that anyone can join, to help design their ideal phone.

You can install any OpenMoko software over the whole range of [[Supported Hardware|supported phones]], and if you upgrade your phone, you don't lose that software. Bugs fixed on any phone are fixed on all.

{{warning|'''The software is not suitable for end-users yet.''' It is of alpha-quality, and much functionality which expected to be present in a phone is not ready for an end-user yet. That means that even the most critical phone uses like making/receiving calls and SMS, using contacts and a calendar, are not there yet or are not finished yet. If you order a Neo1973, DO NOT expect to be able to use it as an everyday phone until December 2007 at the soonest, and probably later.}}

The [[Neo1973]] from [[FIC]] is the first of possibly many phones that OpenMoko may be used on. Buy it at [https://direct.openmoko.com/ Openmoko Online Shop]. You may wish to see the [[SH1 FAQ|Shipment 1 FAQ]] and [[Phase 1 Software Testing]]

Please join us in collaborating on the OpenMoko project through any of the [[Development resources | project resources]] including this OpenMoko wiki. Please see the [[Help:Contents | wiki editing help]] page for information on making contributions to this wiki. A [[Meet the Core Team | core team]] of developers funded by FIC, Inc. leads the project.

An [[introduction]] page is available, with [[Introduction#Photos|photos]] and [[Introduction#Videos|videos]]. Moreover, the usual [[FAQ | Frequently Asked Questions]] (FAQ) page might be helpful. Developers may find the [[ChangeLog | change log]] an important resource.

The members of the OpenMoko community would like to thank FIC Inc. for showing leadership and initiating the OpenMoko project.

{| class="wikitable" cellspacing="0" cellpadding="5" width=100%
! width=100% colspan="2" style="background:#F9D163;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | Latest status
|-
|valign="TOP" width="50%" style="background:#FCE9B4;border-left:5px solid white;border-bottom:5px solid white;" |
* The Openmoko snapshot from [[Phase_1_Software_Testing#Official_20071113_rootfs_with_20071113_.28r3238.29_kernel|20071113]], when employing a few steps, can be used to make and receive calls, but this has seen very little testing! Please also note that there is NO graphical frontend for sending/receiving of SMS included. With additional software, it is possible to send SMS.
|valign="TOP" width="50%" style="background:#FCE9B4;border-right:5px solid white;border-bottom:5px solid white;" |
* With some work, and only for 3-5 hours due to issues with suspend, it is now also also possible to use the Qtopia to make and receive calls, use contacts, and other basic tasks. See [[Qtopia on Neo 1973]] , http://www.qtopia.net/modules/mydownloads/ and the [http://www.qtopia.net/modules/newbb_plus/viewtopic.php?topic_id=473&forum=4 Qtopia forum] for more details.
|}

{| class="wikitable" cellspacing="0" cellpadding="5" width=100%
! width=100% colspan="2" style="background:#F9D163;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | What's Your Interest?
|-

|valign="TOP" width="50%" style="background:#FCE9B4;border-left:5px solid white;border-bottom:5px solid white;" |

* [[Basic End-user]] - Information for end users who want basic functionality and no surprises
* [[Advanced End-user]] - Information for advanced end-users who want advanced and experimental functionality but who are not programmers
* [[Business Development]] - Exchange of commercial opportunities for promoting widespread end-user acceptance.

|valign="TOP" width="50%" style="background:#FCE9B4;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Application Developer]] - Information for application developers, including ideas and specifications for applications, and tools to build them
* [[System Developer]] - Information for system developers, including bootloader, kernel, and libraries
* [[Hardware Developer]] - Information for hardware developers, including hardware specs and debug board

|}

{| class="wikitable" cellspacing="0" cellpadding="5" width=100%
! width=33% style="background:#d1d1d1;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | General
! width=33% style="background:#C5FDAF;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | Developer Guides
! width=33% style="background:#FDAFAF;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | Developer Reference Documentation
|-
|valign="TOP" style="background:#ebebeb;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Development resources | Project Resources]] - Provides a centralized location of all resources such as [[Development resources#Mailing_Lists|mailing lists]], [[Development resources#IRC | communication tools]], and other software development oriented resources.

* [[Current events]] - Information on both past and future events where FIC or OpenMoko had or will have a presence.
* [http://forums.makeopensource.com/ Unofficial OpenMoko Forums] - Everyone is invited to collaborate with OpenMoko users and developers on the forums.
* Most of the documentation and Wiki assumes you are using Linux; here are some notes for users of [[Other OSes]].
* [[MacOS_X|Mac OS X]] - Information specific for those who use Mac OS X

'''Administrative + Organizational'''
* [[Shipping Notes]] - Information to help FIC figure out how to ship products to you, and how much it might cost.
* [[My Account]] - Ideas for what sort of account-based services FIC should provide with the phone.
* [[Hear Me FIC]] - Information to help FIC know what the community wants.
* [[Listen Up Community]] - Community's To-Do-List
* [[Wiki Issues]] - problems/requests regarding this Wiki

|valign="TOP" style="background:#E8FFDF;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Getting Started with your Neo1973]]
* [[installation_guide|A guide for flashing and emulating the openmoko software]] (In progress, this should replace the following options)
** [[Flashing_openmoko|Flashing Neo1973 with the kernel, the root filesystem and optionally u-boot.]]
** [[MokoMakefile|Building OpenMoko using the MokoMakefile]]
** [[Application Development Crash Course]] -A very basic how-to for the new people.
** [[OpenMoko2007.2|Building OpenMoko 2007.2]]
** [[Building OpenMoko from scratch]]
*** [[Building a hello world application]]
*** Old [[Building OpenMoko from scratch (pre-BBT)]]
** [[Running OpenMoko on PC]]
*** [[Getting OpenMoko working on host with Xoo]]
*** [[Getting OpenMoko working on host with Xephyr]]
*** [[How to run OpenMoko Apps on PC]]
*** [[OpenMoko under QEMU]]
*** [[Test Openmoko Emulation with chroot image|Test Openmoko Emulation with a Prebuilt chroot Image]]
* [[Migration to bad block tolerant builds]]
* [[Booting from SD]]

|valign="TOP" style="background:#FFDADA;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;"|
'''Hardware Reference Documentation'''
* All [[:Category:Hardware|Hardware]] related documentation and specifications are found on the [[:Category:Hardware|Hardware page]].
* The [[Neo1973 Hardware]] page provides an overview of the hardware components used by the [[:Category:Neo1973 Hardware|Neo1973 hardware platform]]. PCB photographs are also included. A [[Disassembling Neo1973 | photo disassembly story]] may be an interesting starting place.
* [[:Category:Neo1973 Hardware Debugging | Neo1973 Hardware Debugging]] is assisted with the [[Debug Board | Neo1973 debug board]]. A page discussing [[Connecting Neo1973 with Debug Board v2 | debug board and Neo1973 configurations]] is also provided.

'''Software Reference Documentation'''
* Architectural
** [[OpenMokoFramework]] - The OpenMoko Application Framework
* [[Neo1973 host software]]
* Device Software
** Low-Level
*** [[u-boot]] - The bootloader we use, including documentation for our modifications
*** [[kernel]] - The Linux kernel we use, including documentation for our modifications
** Userspace
*** [[binary compatibility]]
*** [[gsmd]] - the GSM daemon managing the GSM Modem
*** [[gpsd]] - the AGPS (Assisted GPS) daemon

|}

{| class="wikitable" cellspacing="0" cellpadding="5" width=100%
! width=33% style="background:#FCC6FF;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | OpenMoko-specific Development
! width=33% style="background:#B3DDF4;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | OpenMoko Miscellaneous Development
! width=33% style="background:#F5FC7F;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | Miscellaneous
|-
|valign="TOP" style="background:#FEE9FF;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[OpenEmbedded]] - The distribution-building framework
* [[Toolchain]] - The toolchain we use for compilation
* [[OpenMoko]] - The OpenMoko distribution
** [[OpenMoko2007]] - The first intended release of it
** [[OpenMoko2007.2]] - An improved release with more formalized style guidelines.
** [[Userspace root image]]

'''User Interface Related'''
* [[GUI Style Guidelines]] -- New for [[OpenMoko2007.2]]
* [[Look & Feel]]
** [[Artwork]]
* [[Applications]]
* [[Widgets]]
** [[Widget Inheritance Graph]]
* [[Application UI Design Recommendations]]

|valign="TOP" style="background:#D4EDFB;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Thesis work]]
* [[Freshman todo]]
* [[Templates]]
* [[PIM Storage]]
* [[Coding Guidelines]]
* [[OpenMoko#Setting_up_an_OpenMoko_SDK|How to setup the OpenMoko SDK]]
* Alternative distributions for [[Neo1973]] GTA01: [[Angstrom on Neo1973]], [http://pokylinux.org Poky] [http://www.usome.com](instructions needed!)
* [[License]] - How we license our code
* [[Development resources]] - Describes resources for developers (lists, svn, ...)
* [[Neo1973 Phase 0]] - Information for Phase 0 device owners
* [[Wishlist:Neo1973 P0 Review]] - Impressions of the Phase 0 hardware device, also the Phase 0 FAQ
* [[Neo1973 Phase 1]] - Information for Phase 1 device owners
* [[Wishlist:Neo1973 P1 Review]] - Impressions of the Phase 1 hardware device
* [[External Feeds]] - List of feeds from people blogging about OpenMoko

|valign="TOP" style="background:#FCFFCD;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[WiFi support in OpenMoko]]
* [[Neo1973 and Windows]]
* [[Press Coverage]] - What the press says about the OpenMoko project
* [[mFAQ]] - The OpenMoko Misinformation FAQ ('''mFAQ''') - What the press '''''incorrectly''''' says about the OpenMoko project
* [[Wish List]] - A collection of ideas and ideals we'd like to see implemented some day
* [[Wish List - Hardware]] - A collection of ideas we'd like to see in the next Neo release
* [[Wishlist:BuiltInScriptingLanguage|Wish List - Built-in Scripting Language]] - Discussion on a suitable scripting language to be included
* [[Wish List - OpenMoko Ringtones and Sounds]] Collection of [http://en.wikipedia.org/wiki/Free_music free music]/sounds/ringtones we'd like to listen in the next Neo release
* [[Media Content]] - What types of media on the device can we use (that is non-software)?
* [[Testimonials]] - How did you get to OpenMoko?
* [[Buying Interest List]] - (Not official and not a pre-order page) Have you put money aside for Neo1973? Put your nick here.
* [[iPhone]] - Comparison between Apple iPhone and FIC Neo1973
* [[Translation]] - Translation of OpenMoko
* [[Summer of code]] - Our page with project applications for Google's Summer of Code
* [[SWAG]] - Where to purchase openmoko swag (T-Shirts!)
* [[Trademark Policy]] -- The OpenMoko Trademark Policy

|}



[[Category:Information| ]]
[[Category:Categories| ]]

Main Page

2007-11-20T03:56:40Z

BernhardKaindl: Moved the not-ready-for-end-users warning into a warning template. Besides OpenMoko, Qtopia is now also Open Source, so OpenMoko stays unique in that it uses a full X server, capable of running X apps

{{Languages|Main_Page}}
__NOTOC__
__NOEDITSECTION__
__NOTOC__
{| cellspacing="5" cellpadding="0" style="padding: 2%; margin:0em 0em 1em 0em; border:1px solid #F9D163; background:#FCE9B4; width:100%"
| <big>'''Welcome to the [[OpenMoko]]™ public Wiki'''</big> 
|}

[[Image:FIC-neo1973_small.jpg|200px|right|frontside]]
OpenMoko™ is an [http://en.wikipedia.org/wiki/Open_source Open Source] project to create the world's first free mobile phone operating system which runs a full X server and can therefore run most X applications.

The [[OpenMoko]] project is a community that anyone can join, to help design their ideal phone.

You can install any OpenMoko software over the whole range of [[Supported Hardware|supported phones]], and if you upgrade your phone, you don't lose that software. Bugs fixed on any phone are fixed on all.

{{warning|'''The software is not suitable for end-users yet.''' It is of alpha-quality, and much functionality which expected to be present in a phone is not ready for an end-user yet. That means that even the most critical phone uses like making/receiving calls and SMS, using contacts and a calendar, are not there yet or are not finished yet. If you order a Neo1973, DO NOT expect to be able to use it as an everyday phone until December 2007 at the soonest, and probably later.}}

Latest developments:
* The Openmoko snapshot from [[Phase_1_Software_Testing#Official_20071113_rootfs_with_20071113_.28r3238.29_kernel|20071113]], when employing a few steps, can be used to make and receive calls, but this has seen very little testing! Please also note that there is graphical frontend for sending/receiving of SMS included. With additional software, it is possible to send SMS.
* With some work, and only for 3-5 hours due to issues with suspend, it is now also also possible to use the Qtopia to make and receive calls, use contacts, and other basic tasks. See [[Qtopia on Neo 1973]] , http://www.qtopia.net/modules/mydownloads/ and the [http://www.qtopia.net/modules/newbb_plus/viewtopic.php?topic_id=473&forum=4 Qtopia forum] for more details.

The [[Neo1973]] from [[FIC]] is the first of possibly many phones that OpenMoko may be used on. Buy it at [https://direct.openmoko.com/ Openmoko Online Shop]. You may wish to see the [[SH1 FAQ|Shipment 1 FAQ]] and [[Phase 1 Software Testing]]

Please join us in collaborating on the OpenMoko project through any of the [[Development resources | project resources]] including this OpenMoko wiki. Please see the [[Help:Contents | wiki editing help]] page for information on making contributions to this wiki. A [[Meet the Core Team | core team]] of developers funded by FIC, Inc. leads the project.

An [[introduction]] page is available, with [[Introduction#Photos|photos]] and [[Introduction#Videos|videos]]. Moreover, the usual [[FAQ | Frequently Asked Questions]] (FAQ) page might be helpful. Developers may find the [[ChangeLog | change log]] an important resource.

Update 2007-07-25: The [http://forums.makeopensource.com/ Unofficial OpenMoko Forums] are now open! Everyone is invited to participate!

The members of the OpenMoko community would like to thank FIC Inc. for showing leadership and initiating the OpenMoko project.

{| class="wikitable" cellspacing="0" cellpadding="5" width=100%
! width=100% colspan="2" style="background:#F9D163;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | What's Your Interest?
|-

|valign="TOP" width="50%" style="background:#FCE9B4;border-left:5px solid white;border-bottom:5px solid white;" |

* [[Basic End-user]] - Information for end users who want basic functionality and no surprises
* [[Advanced End-user]] - Information for advanced end-users who want advanced and experimental functionality but who are not programmers
* [[Business Development]] - Exchange of commercial opportunities for promoting widespread end-user acceptance.

|valign="TOP" width="50%" style="background:#FCE9B4;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Application Developer]] - Information for application developers, including ideas and specifications for applications, and tools to build them
* [[System Developer]] - Information for system developers, including bootloader, kernel, and libraries
* [[Hardware Developer]] - Information for hardware developers, including hardware specs and debug board

|}

{| class="wikitable" cellspacing="0" cellpadding="5" width=100%
! width=33% style="background:#d1d1d1;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | General
! width=33% style="background:#C5FDAF;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | Developer Guides
! width=33% style="background:#FDAFAF;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | Developer Reference Documentation
|-
|valign="TOP" style="background:#ebebeb;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Development resources | Project Resources]] - Provides a centralized location of all resources such as [[Development resources#Mailing_Lists|mailing lists]], [[Development resources#IRC | communication tools]], and other software development oriented resources.

* [[Current events]] - Information on both past and future events where FIC or OpenMoko had or will have a presence.
* [http://forums.makeopensource.com/ Unofficial OpenMoko Forums] - Everyone is invited to collaborate with OpenMoko users and developers on the forums.
* Most of the documentation and Wiki assumes you are using Linux; here are some notes for users of [[Other OSes]].
* [[MacOS_X|Mac OS X]] - Information specific for those who use Mac OS X

'''Administrative + Organizational'''
* [[Shipping Notes]] - Information to help FIC figure out how to ship products to you, and how much it might cost.
* [[My Account]] - Ideas for what sort of account-based services FIC should provide with the phone.
* [[Hear Me FIC]] - Information to help FIC know what the community wants.
* [[Listen Up Community]] - Community's To-Do-List
* [[Wiki Issues]] - problems/requests regarding this Wiki

|valign="TOP" style="background:#E8FFDF;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Getting Started with your Neo1973]]
* [[installation_guide|A guide for flashing and emulating the openmoko software]] (In progress, this should replace the following options)
** [[Flashing_openmoko|Flashing Neo1973 with the kernel, the root filesystem and optionally u-boot.]]
** [[MokoMakefile|Building OpenMoko using the MokoMakefile]]
** [[Application Development Crash Course]] -A very basic how-to for the new people.
** [[OpenMoko2007.2|Building OpenMoko 2007.2]]
** [[Building OpenMoko from scratch]]
*** [[Building a hello world application]]
*** Old [[Building OpenMoko from scratch (pre-BBT)]]
** [[Running OpenMoko on PC]]
*** [[Getting OpenMoko working on host with Xoo]]
*** [[Getting OpenMoko working on host with Xephyr]]
*** [[How to run OpenMoko Apps on PC]]
*** [[OpenMoko under QEMU]]
*** [[Test Openmoko Emulation with chroot image|Test Openmoko Emulation with a Prebuilt chroot Image]]
* [[Migration to bad block tolerant builds]]
* [[Booting from SD]]

|valign="TOP" style="background:#FFDADA;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;"|
'''Hardware Reference Documentation'''
* All [[:Category:Hardware|Hardware]] related documentation and specifications are found on the [[:Category:Hardware|Hardware page]].
* The [[Neo1973 Hardware]] page provides an overview of the hardware components used by the [[:Category:Neo1973 Hardware|Neo1973 hardware platform]]. PCB photographs are also included. A [[Disassembling Neo1973 | photo disassembly story]] may be an interesting starting place.
* [[:Category:Neo1973 Hardware Debugging | Neo1973 Hardware Debugging]] is assisted with the [[Debug Board | Neo1973 debug board]]. A page discussing [[Connecting Neo1973 with Debug Board v2 | debug board and Neo1973 configurations]] is also provided.

'''Software Reference Documentation'''
* Architectural
** [[OpenMokoFramework]] - The OpenMoko Application Framework
* [[Neo1973 host software]]
* Device Software
** Low-Level
*** [[u-boot]] - The bootloader we use, including documentation for our modifications
*** [[kernel]] - The Linux kernel we use, including documentation for our modifications
** Userspace
*** [[binary compatibility]]
*** [[gsmd]] - the GSM daemon managing the GSM Modem
*** [[gpsd]] - the AGPS (Assisted GPS) daemon

|}

{| class="wikitable" cellspacing="0" cellpadding="5" width=100%
! width=33% style="background:#FCC6FF;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | OpenMoko-specific Development
! width=33% style="background:#B3DDF4;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | OpenMoko Miscellaneous Development
! width=33% style="background:#F5FC7F;border-left:5px solid white;border-right:5px solid white;border-top:5px solid white;" | Miscellaneous
|-
|valign="TOP" style="background:#FEE9FF;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[OpenEmbedded]] - The distribution-building framework
* [[Toolchain]] - The toolchain we use for compilation
* [[OpenMoko]] - The OpenMoko distribution
** [[OpenMoko2007]] - The first intended release of it
** [[OpenMoko2007.2]] - An improved release with more formalized style guidelines.
** [[Userspace root image]]

'''User Interface Related'''
* [[GUI Style Guidelines]] -- New for [[OpenMoko2007.2]]
* [[Look & Feel]]
** [[Artwork]]
* [[Applications]]
* [[Widgets]]
** [[Widget Inheritance Graph]]
* [[Application UI Design Recommendations]]

|valign="TOP" style="background:#D4EDFB;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[Thesis work]]
* [[Freshman todo]]
* [[Templates]]
* [[PIM Storage]]
* [[Coding Guidelines]]
* [[OpenMoko#Setting_up_an_OpenMoko_SDK|How to setup the OpenMoko SDK]]
* Alternative distributions for [[Neo1973]] GTA01: [[Angstrom on Neo1973]], [http://pokylinux.org Poky] [http://www.usome.com](instructions needed!)
* [[License]] - How we license our code
* [[Development resources]] - Describes resources for developers (lists, svn, ...)
* [[Neo1973 Phase 0]] - Information for Phase 0 device owners
* [[Wishlist:Neo1973 P0 Review]] - Impressions of the Phase 0 hardware device, also the Phase 0 FAQ
* [[Neo1973 Phase 1]] - Information for Phase 1 device owners
* [[Wishlist:Neo1973 P1 Review]] - Impressions of the Phase 1 hardware device
* [[External Feeds]] - List of feeds from people blogging about OpenMoko

|valign="TOP" style="background:#FCFFCD;border-left:5px solid white;border-right:5px solid white;border-bottom:5px solid white;" |
* [[WiFi support in OpenMoko]]
* [[Neo1973 and Windows]]
* [[Press Coverage]] - What the press says about the OpenMoko project
* [[mFAQ]] - The OpenMoko Misinformation FAQ ('''mFAQ''') - What the press '''''incorrectly''''' says about the OpenMoko project
* [[Wish List]] - A collection of ideas and ideals we'd like to see implemented some day
* [[Wish List - Hardware]] - A collection of ideas we'd like to see in the next Neo release
* [[Wishlist:BuiltInScriptingLanguage|Wish List - Built-in Scripting Language]] - Discussion on a suitable scripting language to be included
* [[Wish List - OpenMoko Ringtones and Sounds]] Collection of [http://en.wikipedia.org/wiki/Free_music free music]/sounds/ringtones we'd like to listen in the next Neo release
* [[Media Content]] - What types of media on the device can we use (that is non-software)?
* [[Testimonials]] - How did you get to OpenMoko?
* [[Buying Interest List]] - (Not official and not a pre-order page) Have you put money aside for Neo1973? Put your nick here.
* [[iPhone]] - Comparison between Apple iPhone and FIC Neo1973
* [[Translation]] - Translation of OpenMoko
* [[Summer of code]] - Our page with project applications for Google's Summer of Code
* [[SWAG]] - Where to purchase openmoko swag (T-Shirts!)
* [[Trademark Policy]] -- The OpenMoko Trademark Policy

|}



[[Category:Information| ]]
[[Category:Categories| ]]