Openmoko - User contributions [en]

User talk:Seanmcneil3

2008-11-18T02:36:29Z

Tkep:

==What's new?==
This would be a nice area for a changelog. What's new in the November 17th image? Anything worth noting?

== Android running problems ==

I had flashed it now on my FR but it doesn't work. I see only a black screen.

It works, but you need 2 partition on your SD card. First about 8MB formated vfat, secound ext3. That partitions must be empty.

--

Hi Sean, how can the imgages be put on the GTA02? I also flashed my GTA02 and android will not start, only black screen.

Sean:
I've just begun adding more information to the page which explains what is necessary to bring up Android. Sorry for the delay.

--

Hi Sean I split sd card to 2 partition fat32 and ext3, noting in fat32(1.5g) and in ext3(2.2G) have lostxxfound directory,I never set boot flag to sd card's partition, now I flash image and rootfs according your "setup guide" but now it not start just black screen. what's wrong with it

== Android doesn't accept the pin ==

I have flashed my GTA02 and android will boot but it does not accept the pin code for my SIM-card.
Jofry

Sean:
Hi Jofry, I've never really tried a locked SIM, so I don't know if the dialpad comes up to let you type in the code. Does it? If so, then I can probably fix the issue. Otherwise, we are kind of stuck until a virtual keyboard is developed.

Jofry: Yes, the dialpad comes up and ask for my pin number. But if i type in the number the application means that it was the wrong number. But it is the right one.

Skamster: i've got the same problem. i could enter the pin as much as i want but it doesn't let me in. normaly, it lock the sim after 3 try's (i try 4-6 times), but here it doesn't. i flashed with qtopia again and don't need a puck. maybe it doesn't "send" the pin to the simcard?

--

i've got the same problem like jofry. i could enter the pin as much as i want but it doesn't let me in. normaly, it lock the sim after 3 try's (i try 4-6 times), but here it doesn't. i flashed with qtopia again and don't need a puck. maybe it doesn't "send" the pin to the simcard?

That's a known issue. For more information about the things you have to do, before you can successful use Android, look at http://onlinedev.blogspot.com/2008/11/getting-started-with-android-on-neo.html [[User:Dolfje|Dolfje]] 12:03, 5 November 2008 (UTC)

== Android rootfs for µSD boot ==

Treviño: Could you set-up a rootfs for running Android from MicroSD?

== Android and replying calls ==

Actually it is not possible to reply to a call due to the missing hardware "accept" button.

Treviño: So, what about adding a workaround to it by using the AUX button as an "accept" button if pressed briefly (below 0.5 second), while keeping it to the "reject" (home) button when pressed longer?!

== Android Misc requests ==

--

dilersam: thanks for having added more informations to the page. It helps a lot.

-

fate: thanks for all your great work. i was wondering when will the next flash image be released?

FDOM - a Fat and Dirty OM based distribution

2008-09-28T15:04:31Z

Tkep: /* Roadmap */ added (done) to those options which are such

{{Languages|FDOM_-_a_Fat_and_Dirty_OM_based_distribution}}
=== Description ===
A combination of apps and fixes to demo the capabilities of the Freerunner and to have a functional phone (sort of). This all while retaining the ability to update through the official feeds.

Any questions can be sent to dsamblas at gmail dot com

or at community list or local-openmoko-spain list

See [[Development_resources#Mailing_Lists|mailing lists]]

David-Reyes Samblas Martinez

Co Admins
Armin ranjbar aka zoup
Nacho Seijo aka himero

=== Download ===
Download from http://compartida.net/openmoko/FDOM .
* Note: Use '''wget -c''' to retrieve the files, because the server seems to cut the connection time to time. Do check the md5 hashes of the files after downloading to prevent any problems. or try one of the mirrors
* Mirrors:
** http://files.tdobson.net/openmoko/freerunner/fdom/
*** Mirror admin contact: www.tdobson.net/contact
** http://openmoko.truebox.co.uk/mirror/compartida.net/

=== Development ===
I you want to come to the script kidding party :) join us at

http://projects.openmoko.org/projects/fdom/

Serious developers are welcome too :) but remember "if it's cool, it works(in some way),doesn't annoying(too much) rest of things and fits on the nand it's in" :) we will let scalability, stability, resource saving and so on to the OM guys :)

=== Warnings ===
* If after an opkg update/upgrade dialer, contacts and other qtopia-x11 apps don't work and qpe shows an error window you should check whether the startup file is executable, or revert changes.

The following adds permissions of '''r'''ead and e'''x'''ecution to the qtopia startup session file:
# chmod a+rx /etc/X11/Xsession.d/89qtopia

The following reverts last change to the qtopia startup session file:
# cp /etc/X11/Xsession.d/89qtopia.bk~ /etc/X11/Xsession.d/89qtopia

Now reboot the neo.

==== 15 Sep Updates ====
* It seems that there were major updates today that caused dialer to not work , It does happen when you click on dialer and it does exit with Enlightenment error , qucik fix to this is

# ln /opt/Qtopia/bin/qcop /usr/bin/qcop -s

but i believe adding /opt/Qtopia/bin to global system path is better solution (How?).

==== 20080927 and Pidgin ====
* I forget to install the following packages to enable ssl (needed by msn) and irc
install the following to make it work
opkg -force-depends install http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base/libpurple-plugin-ssl_2.5.0-r0_armv4t.ipk

opkg -force-depends install http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base/libpurple-plugin-ssl-nss_2.5.0-r0_armv4t.ipk

opkg -force-depends install http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base/libpurple-plugin-ssl-gnutls_2.5.0-r0_armv4t.ipk

opkg -force-depends install http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base/libpurple-protocol-irc_2.5.0-r0_armv4t.ipk

=== Changelog ===
==== version 20080927 ====
* added up to 29 games including kobodeluxe
* added pythm -> python gtk mplayer frontend
* added FDSubmenu-> a Fat and Dirty first aproach to have submenus
* updated orrery 2.0 -> now with zoom feature
* arrange some icons
* fixed the sound out when suspend

==== version 20080925 ====
* based on 2008.9
* added nano -> Terminal text editor
* added navit -> Car navigation system with routing engine
* added Duke Nukem 3D -> Legendary first person shooter game. more information: [[Games#Duke_Nukem_3D]]
* added Linphone -> VoIP client
* added Pidgin msn and yahoo plugins
* added jalimo with javaSE and javaME
* opkg update/upgrade make today

==== version 20080913 ====
* added Pidgin -> Instant Messaging multiprotocol, installed with plugins for irc and xppm/googletalk. More plugins are avaible on the amstrong repository. There are some gtk gliches, but messaging is functionally usable.
* added Remoko -> PC remote controler via bluetooth, with gestures it's easy to look like one is performing black magic conjurations, I recommend to train gestures with more subtle moviments ;)
* added Thomas B. <tommy.b at gmx dot net> illume Raster's keyboard Numbers splitted version-> my wrong pin entries has decreased sensible. Thanks, Thomas !
* omview e17 theme applied
* opkg update/upgrade make today

==== version 20080909 ====
* Some 20080805 bugs eliminated
* opkg update/upgrade make today

==== version 20080905 ====

===== Installed graphical applications =====

* Default apps from OM2008.08-updates excluding Locations
* qtopia-phone-x11-datebook
* qtopia-phone-x11-mediaplayer (not tested yet)
* Raster's Illume keyboard with qwerty button and configuration wrench
* tap/untap -> silly script to landscape/portrait screen switch
* numptyphysics -> addictive game
* openmoko-terminal2
* tangogps -> configured to use Google Maps
* Mofi-> wifi assistant
* omview-> image viewer
* orrery-> Stelar maps of the sky GPS capable
* services -> GPRS and GSM control. You must reconfigure the GPRS scripts for your data-provider. Search the wiki or lists for more information.
* agps-ui-> GPS testing
* minimo-> web browser
* gestures

===== Installed terminal-based applications =====
* joe
* mplayer
* tapuntap

===== Additional fixes =====
* fixed qte-illume keyboard fights (here illume wins :) )
* fixed pygtk
* fixed gtk2 theme
* Used packages from angstrom repository, but without adding it to the feeds, dependencies solved manually

=== Roadmap ===
* some method to add submenus ->I was thinking about some simply pygtk .desktop reader that can read a dir passed by parameter and shows an scrollable list of buttons, more sofistications later (seemingly done)
* Duke Nukem 3d (done)
* Spanish Dictionary
* Tango look
* Navit-> route solver (done)

=== External Links ===
Some people talking about us ;) thanks a lot

http://openmoko-fr.org/blog/index.php?post/2008/09/16/Test-de-FDOM (FR)

http://www.bunix.de/key/personal-blog/blog_id/533.htm (DE)

http://community.livejournal.com/ru_openmoko/6577.html (RU)

http://www.linuxphone.ru/2008/09/fdom-distributive-for-openmoko-freerunner/ (RU)

[[category:Distributions]]

User:Tkep

2008-09-08T03:09:21Z

Tkep:

[FreerunnerHQ|http://www.freerunnerhq.com]

User:Tkep

2008-09-08T03:08:50Z

Tkep:

[http://www.freerunnerhq.com|FreerunnerHQ.com]

User:Tkep

2008-09-08T03:08:32Z

Tkep: New page: [http://www.freerunnerhq.com]

[http://www.freerunnerhq.com]

Om 2008 Guide

2008-09-08T03:07:43Z

Tkep: /* Bugs/Fixes */

{{Om 2008.8}}

This documents quickly some key usability bits about [[Om 2008.8]] and initial setup.

=== Interface ===

'''New Keyboard'''

More details at : [[Om2008.8 Keyboard]]

'''Installer'''

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

'''Top Menu'''

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

=== Things to know ===

''' Commands '''

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

*'''"ifconfig"''' - Displays network information.

*'''"opkg update"''' - Updates list of available software.

*'''"opkg install"''' - Install software.

*'''"opkg upgrade"''' - Updates your software.

*'''"killall packagekitd"''' - Quits any package manager which could be running. (Run this command if you get the "Could not obtain administrative lock" error message while running opkg commands)

*'''"shutdown -r now"''' or '''"reboot"'''- Reboots your phone.

=== Configuring Om 2008.8 ===

==== Internet ====

===== Connecting your FR through USB to an internet-connected computer =====

Follow this [http://support.microsoft.com/kb/306126 guide (Windows Users)]to share your internet with your phone.

To share your internet connection on a Linux host follow this [[USB_Networking|USB networking guide]].

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

After you install and run [[http://wiki.openmoko.org/wiki/Om2008.8#Download Om 2008.8 ]] for the first time you have to restart to get the USB working. Once you have done that you have to ssh into your phone (192.168.0.202) to edit your /etc/network/interfaces so you can access the internet through USB to install software and updates.

Edit the USB section to look like this:

# Ethernet/RNDIS gadget (g_ether)
# ... or on host side, usbnet and random hwaddr
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.1
up echo nameserver 208.67.222.222 > /etc/resolv.conf
up echo nameserver 208.67.220.220 >> /etc/resolv.conf
#up echo nameserver 192.168.0.200 > /etc/resolv.conf

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

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

and set your host ip to 201. Don't forget to modify routing and check [[USB_Networking|USB networking guide]] for a DNS MASQ using 192.168.0.201 as FR DNS. --[[User:Femto|Femto]] 00:34, 1 September 2008 (UTC)

===== Wireless =====

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

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

==== Mediaplayer ====

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

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

=== Bugs/Fixes ===

{{todo|Link to bugreports and check if some of them might be fixed in newer updates}}

*The Media Player is basically unusable because of the skin. And is also very buggy.
*Battery meter always says its charging. Installing a terminal and running "apm" will display the proper battery status. (Appears to now work with the latest updates -- [[User:Tkep|Tkep]]

*Your phone will go into standby after 30 seconds EVEN when connected to your computer or wall charger. (Disable this under the settings menu)

*The wifi doesn't work too well right now. (well, works now with 2008.8 updates, I think -- [[User:OlivierBerger|OlivierBerger]] 14:25, 31 August 2008 (UTC))

*Accelerometers have alpha support via [[Gestures]]

*If you only want the rotate screen effect you can give a [[rotate|try to this one]]

*If you let the battery completely drain you will have problems booting it up. Plug it into the wall charger for a few hours and then plug it into your computer and press power.
*BUT, '''if you have another charged battery''', such as from the [http://us.direct.openmoko.com/products/spares-pack Spares pack], you can boot the Neo with the good battery, plug in wall-charger, and hot-swap the drained battery while booted. This allows you to immediately start "fast-charging" with the wall-charger. (Neo needs to be booted to recognize charger and switch to fast-charging)

*You'll have to install "illume-config" to have more control over power management, scrolling speeds, keyboard options, and to change how the interface looks.

*Some software that you install by command-line may appear in in the settings menu (wrench) that you unlock after installing "illume-config".

[[Category:Om 2008.8]]

Community Repository

2008-09-05T15:22:04Z

Tkep: /* Packages quality control */

There are many [[Users Repositories]] where people can feed software for their Neo smartphones. This diversity makes it sometimes difficult to find the right package for the right distribution. Openmoko Inc. hosts a Community Repository as a central service where independent Neo application developers can release projects, so that installing a new application `just works out of the box'. It is a similar concept to the Multiverse repository in Ubuntu. The Repository is at:

http://downloads.openmoko.org/repository/Multiverse

== How to use the repository ? ==

This feed is already installed by default in [[Om2008.8 | Om 2008.8]].

Otherwise, see instructions on the [http://wiki.openmoko.org/wiki/Om_2008.8_Installer installer page]. They involve creating a one line file in the /etc/opkg directory.

== How to release packages ? ==

Please use the mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository .
The package manager derives from [[opkg]], so applications should be released as .ipk files.

* [[Create package on projects.openmoko.org and upload]]
* Here are [http://handhelds.org/moin/moin.cgi/BuildingIpkgs| instructions to build ipkgs].
** Using OE
** [[Toolchain|Meta-toolchain]]

Packages in '''Installer''' are displayed according to '''Package Tags'''.
To display a package through [[Om2008.8_Installer |Installer]], add the appropriate tag message.
{| class="wikitable" border:1px ;
! Category !! Tag
|-
| Communication || group::communication
|-
| Development || group::programming
|-
| Games || group::games
|-
| Maps || group::maps
|-
| Miscellaneous || group::unknown
|-
| Network || group::network
|-
|Repos || group::repos
|}

* For OpenEmbedded users, add a Tag by adding one line in your bb file
:For [http://code.google.com/p/comic-reader/source/browse/trunk/data/comic-reader_svn.bb example]:
PKG_TAGS_${PN} = "group::games"

== Packages quality control ==

The reviewer will check if there have new packages on the mailing list. If you are reviewer and want to review that package
* reply that mail, and say you want to review that
* check if the package follows the policy
* download the package on projects.openmoko.org
* install that package to see if
** installable?
** executable able?
** functions the claimed works actually works?
** does it do something bad?
** uninstall it and see if everything still ok?
* if the package is okay, put the package in this [https://svn.openmoko.org/trunk/feeds/community-repository/file-index.txt file] and the package will shown next day.

Good packages should conform to these quality guidelines:

* Packages in this repository shall not be in OM Official repositories
* Program shall not collect user information and send to others unless it has very clear notification
* Program shall not destroy the system
* All packages shall be run-able on Neo
* The package file name should refer which version of the project is compiled.

== How to contribute ? ==

We need reviewers who can review new packages. This is currently a low workload. If you want to help, please send e-mail to the mailing list The mailing list: [http://lists.openmoko.org/mailman/listinfo/community-repository community-repository@lists.openmoko.org].

Reviewers must have the following:
* an account on projects.openmoko.org
* ssh public key on projects.openmoko.org
* basic svn skills
* basic opkg skills

Openmoko really appreciates your help!
'''Current Reviewers'''
[http://wiki.openmoko.org/wiki/User_talk:Tick Tick]

== How to create your own repository ? ==

TBD

[[category:Documentation]]
[[category:Community]]

Om 2008.8

2008-08-31T16:22:26Z

Tkep: fixed the other "bellow" and extra )

{{Languages|Om 2008.8}}
{{Om 2008.8}}

{{Distributions|Om 2008.8}}

== Summary ==

'''Om 2008.8''' is the successor to [[Om 2007.2]] and had '''ASU''' as a codename. It was [http://lists.openmoko.org/pipermail/community/2008-August/025619.html released] on '''August 08, 2008''' (+ update "stable" releases starting from '''August 26, 2008'''). Om 2008.8 uses EFL for the launcher, custom UI applications and [[QtopiaOnX11|Qtopia on X11]] for telephony. The distribution is the first step from GTK+ on x11 to using multiple toolkits in combination.

== What's New ? ==

Compared to 2007.2 that has a longer development history, Om 2008.8 is definitely a .0 major release. So think KDE 4.0 vs. 3.5, not Linux 2.6.23 vs. 2.6.22. If you want the stability level required to use the FreeRunner as your main phone, it is suggested for now to keep 2007.2 in the phone's flash memory and test 2008.8 on a removable SD card.

The main user-visible changes:

* The user interface has been fully revised with a new window manager [[illume]]. It is visually much richer, and can be customized further by using your own [[Edje]] files.
* '''[[Om2008.8_Installer|A graphical installer]]''' allows to add easily new applications, themes and functionality.
* A new [[Om2008.8_Locations|Locations]] application is provided, to save your favorite spots and share them with friends via sms.
* Power management has been improved: The Aux button now locks the screen, the Power button suspends and the red LED behind the Aux button lights up when charging.
* The [[Om2008.8_Keyboard| keyboard]] is now the Qtopia one (whether this is an improvement has been [[Keyboard_Debate|hotly debated]]).

For developers, the main changes are:
* Multiple toolkits: '''Om 2008.8''' supports [http://www.enlightenment.org/ EFL], [http://trolltech.com/products/qtopia Qtopia] and [http://www.gtk.org GTK+] applications.
* A [[CommunityRepository| Community Repository]] has been set up, it is integrated in the ([[Om2008.8_Installer|Installer]]).
* '''Source Codes''' are publicly available, allowing for customization all the way down to low level systems.

For more details, see the [[Om 2008.8 Guide]] and the [[Om2008.8 Feature Plan|Om 2008.8 Feature Plan]].

{| class="wikitable" cellspacing="2" cellpadding="2" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; width:100%;floating="center"; "
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Om2008 home.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Installer4.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Om2008 installer1.png|200px|center]]
|-

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Main.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Edit1.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Om locations4.png|200px|center]]
|}




== Installation ==

To install the Om2008.8 stable distribution on the Neo FreeRunner, download the Root Filesystem and the Kernel image files from [[Download]] page and install according to [[Flashing the Neo FreeRunner]]. Note that flashing the smartphone will overwrite all your existing data and software.

== Known Issues ==

This is only a subset, and some of the bits reported below may have been fixed by stable updates (see below too). See [http://docs.openmoko.org/trac/search?q=2008.8 all tickets with 2008.8] in the bug tracker.

'''GSM'''

* [http://docs.openmoko.org/trac/ticket/1766 Cannot make calls or receive SMS messages]
* [http://docs.openmoko.org/trac/ticket/1662 GSM not working properly after x hours]

'''WiFi'''

* [http://docs.openmoko.org/trac/ticket/1625 WiFi can only connect once]
* [http://docs.openmoko.org/trac/ticket/1734 WiFi shows up unknown] is caused by hald not running, which can be fixed by removing <tt>/etc/volatile.cache</tt> and rebooting

'''Audio quality'''

* [http://docs.openmoko.org/trac/ticket/1640 Improve overall audio]

'''System Software'''

* [http://docs.openmoko.org/trac/ticket/1736 Boot screen goes into sleep and never wake up if not touch during booting]
* [http://docs.openmoko.org/trac/ticket/1597 After long suspend, kernel thread events]
* [http://docs.openmoko.org/trac/ticket/1315 xglamo: performance decreases after a while]
* [http://docs.openmoko.org/trac/ticket/1682 Neo turns off before reaching x]

'''Networking'''
* No Updates/Installation are possible or pings to domains because DNS is not working. This problem occurs because the /etc/resolv.conf is empty by default.
Add these lines in /etc/network/interfaces:

up echo nameserver 208.67.222.222 > /etc/resolv.conf
up echo nameserver 208.67.220.220 >> /etc/resolv.conf
This is to be inserted below gateway address and above the bluetooth networking. After this it will be set on every reboot.

For resolving DNS without restarting, run the following commands:

echo nameserver 208.67.222.222 > /etc/resolv.conf
echo nameserver 208.67.220.220 >> /etc/resolv.conf
This should solve most of your moko side networking issues. If you need any other help please refer to [[USB Networking]]

{{note| [http://en.wikipedia.org/wiki/Resolvconf resolvconf] is installed so should probably be used

'''Problem''': parts of resolvconf are missing: without the scripts under /etc/network/if-{up,down}.d, and /etc/resolvconf/run/enable-updates and /lib/resolvconf/list-records it does nothing, and even then, /etc/resolvconf/run should probably be a symlink to /var/run, or /etc/resolv.conf needs to be pointed at /etc/resolvconf/run/resolv.conf -- once all that's done, it seems to work as long as you add something like this to /etc/network/interfaces at the end of the usb0 stanza:

dns-nameservers 192.168.0.200
dns-search example.com

and add <tt>usb*</tt> above <tt>eth*</tt> in <tt>/etc/resolvconf/interface-order</tt>

}}

{{Note| '''Solution:''' Steps to add missing resolvconf script: 
<code>touch /etc/resolvconf/run/enable-updates</code> 
<code>cd /etc ; rm resolv.conf ; ln -s /etc/resolvconf/run/resolv.conf .</code> 
<code>mkdir /lib/resolvconf/ ; cd /lib/resolvconf/</code> 
<code><nowiki>wget http://kopparv34.mine.nu/list-records</nowiki></code> 
<code>chmod +x list-records</code> 
Edit <code>/etc/network/interfaces</code> and remove the lines: 
<code> network 192.168.0.0</code> 
<code> gateway 192.168.0.200</code> 
If we need to use the usb network more then just locally from the computer in the other end of the USB-cable, login with ssh and add a default route like this: 
<code>route add default gateway 192.168.0.200</code>
}}

* Usb-networking will not work until rebooted after initial boot.

'''Usability'''

* The Pin-Dialog by default just shows letters. You have to slide your finger up/down over the keyboard to make the numbers/uppercase/special characters appear.
* The installer app doesn't release administrative rights which results in not being able to use opkg. Solution: run "killall packagekitd" (on the freerunner or when ssh'ed in).
* The installer app doesn't release administrative rights which results in not being able to use opkg. Alternate Solution: On the FreeRunner, use the drop-down menu to close all open applications.
* The keyboard may not be adapted for all uses. See [[Keyboard Debate]] for a full discussion and options.

== Official updates for "stable" Om 2008.8 ==

Posterior to the Om2008.8 release made on 2008/08/08, development of ASU/Om2008.8 is switching to a Debian-like model with three branches: stable, testing and unstable ([http://lists.openmoko.org/pipermail/community/2008-August/026491.html see this message] for more details).

Official updates for the "stable" branch are now available (as of 2008/08/26) in two forms (see [http://lists.openmoko.org/pipermail/community/2008-August/027997.html see this message] for the announcement) :
* in the http://downloads.openmoko.org/repository/Om2008.8/ opkg feeds (which should already be configured for opkg updates in 2008.8),
* as flash-able images in http://downloads.openmoko.org/releases/Om2008.8-update/

The changelog of the stable branch can be ogtained here : http://git.openmoko.org/?p=openmoko.git;a=log;h=org.openmoko.asu.stable

== Dedication ==

<pre>
From: Openmoko
To: openmoko-community mailing list

Om 2008.8 was designed to be empty, for the very purpose of showcasing your ideas.

Think of our products as galleries. We're building the environment.
Each one different from the next. You'll get all the free art supplies
you could imagine because we want you to add your own meaning.
You choose: consume, create, or both.

Either way you create your own meaning. It's about you.
</pre>

[[Category:Openmoko]]
[[Category:Om 2008.8]]

Om 2008.8

2008-08-31T16:21:29Z

Tkep: typo on "bellow"

{{Languages|Om 2008.8}}
{{Om 2008.8}}

{{Distributions|Om 2008.8}}

== Summary ==

'''Om 2008.8''' is the successor to [[Om 2007.2]] and had '''ASU''' as a codename. It was [http://lists.openmoko.org/pipermail/community/2008-August/025619.html released] on '''August 08, 2008''' (+ update "stable" releases starting from '''August 26, 2008'''). Om 2008.8 uses EFL for the launcher, custom UI applications and [[QtopiaOnX11|Qtopia on X11]] for telephony. The distribution is the first step from GTK+ on x11 to using multiple toolkits in combination.

== What's New ? ==

Compared to 2007.2 that has a longer development history, Om 2008.8 is definitely a .0 major release. So think KDE 4.0 vs. 3.5, not Linux 2.6.23 vs. 2.6.22. If you want the stability level required to use the FreeRunner as your main phone, it is suggested for now to keep 2007.2 in the phone's flash memory and test 2008.8 on a removable SD card.

The main user-visible changes:

* The user interface has been fully revised with a new window manager [[illume]]. It is visually much richer, and can be customized further by using your own [[Edje]] files.
* '''[[Om2008.8_Installer|A graphical installer]]''' allows to add easily new applications, themes and functionality.
* A new [[Om2008.8_Locations|Locations]] application is provided, to save your favorite spots and share them with friends via sms.
* Power management has been improved: The Aux button now locks the screen, the Power button suspends and the red LED behind the Aux button lights up when charging.
* The [[Om2008.8_Keyboard| keyboard]] is now the Qtopia one (whether this is an improvement has been [[Keyboard_Debate|hotly debated]]).

For developers, the main changes are:
* Multiple toolkits: '''Om 2008.8''' supports [http://www.enlightenment.org/ EFL], [http://trolltech.com/products/qtopia Qtopia] and [http://www.gtk.org GTK+] applications.
* A [[CommunityRepository| Community Repository]] has been set up, it is integrated in the ([[Om2008.8_Installer|Installer]]).
* '''Source Codes''' are publicly available, allowing for customization all the way down to low level systems.

For more details, see the [[Om 2008.8 Guide]] and the [[Om2008.8 Feature Plan|Om 2008.8 Feature Plan]].

{| class="wikitable" cellspacing="2" cellpadding="2" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; width:100%;floating="center"; "
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Om2008 home.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Installer4.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Om2008 installer1.png|200px|center]]
|-

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Main.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Edit1.png|200px|center]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:33% " |
[[Image:Om locations4.png|200px|center]]
|}




== Installation ==

To install the Om2008.8 stable distribution on the Neo FreeRunner, download the Root Filesystem and the Kernel image files from [[Download]] page and install according to [[Flashing the Neo FreeRunner]]. Note that flashing the smartphone will overwrite all your existing data and software.

== Known Issues ==

This is only a subset, and some of the bits reported below may have been fixed by stable updates (see bellow) too). See [http://docs.openmoko.org/trac/search?q=2008.8 all tickets with 2008.8] in the bug tracker.

'''GSM'''

* [http://docs.openmoko.org/trac/ticket/1766 Cannot make calls or receive SMS messages]
* [http://docs.openmoko.org/trac/ticket/1662 GSM not working properly after x hours]

'''WiFi'''

* [http://docs.openmoko.org/trac/ticket/1625 WiFi can only connect once]
* [http://docs.openmoko.org/trac/ticket/1734 WiFi shows up unknown] is caused by hald not running, which can be fixed by removing <tt>/etc/volatile.cache</tt> and rebooting

'''Audio quality'''

* [http://docs.openmoko.org/trac/ticket/1640 Improve overall audio]

'''System Software'''

* [http://docs.openmoko.org/trac/ticket/1736 Boot screen goes into sleep and never wake up if not touch during booting]
* [http://docs.openmoko.org/trac/ticket/1597 After long suspend, kernel thread events]
* [http://docs.openmoko.org/trac/ticket/1315 xglamo: performance decreases after a while]
* [http://docs.openmoko.org/trac/ticket/1682 Neo turns off before reaching x]

'''Networking'''
* No Updates/Installation are possible or pings to domains because DNS is not working. This problem occurs because the /etc/resolv.conf is empty by default.
Add these lines in /etc/network/interfaces:

up echo nameserver 208.67.222.222 > /etc/resolv.conf
up echo nameserver 208.67.220.220 >> /etc/resolv.conf
This is to be inserted below gateway address and above the bluetooth networking. After this it will be set on every reboot.

For resolving DNS without restarting, run the following commands:

echo nameserver 208.67.222.222 > /etc/resolv.conf
echo nameserver 208.67.220.220 >> /etc/resolv.conf
This should solve most of your moko side networking issues. If you need any other help please refer to [[USB Networking]]

{{note| [http://en.wikipedia.org/wiki/Resolvconf resolvconf] is installed so should probably be used

'''Problem''': parts of resolvconf are missing: without the scripts under /etc/network/if-{up,down}.d, and /etc/resolvconf/run/enable-updates and /lib/resolvconf/list-records it does nothing, and even then, /etc/resolvconf/run should probably be a symlink to /var/run, or /etc/resolv.conf needs to be pointed at /etc/resolvconf/run/resolv.conf -- once all that's done, it seems to work as long as you add something like this to /etc/network/interfaces at the end of the usb0 stanza:

dns-nameservers 192.168.0.200
dns-search example.com

and add <tt>usb*</tt> above <tt>eth*</tt> in <tt>/etc/resolvconf/interface-order</tt>

}}

{{Note| '''Solution:''' Steps to add missing resolvconf script: 
<code>touch /etc/resolvconf/run/enable-updates</code> 
<code>cd /etc ; rm resolv.conf ; ln -s /etc/resolvconf/run/resolv.conf .</code> 
<code>mkdir /lib/resolvconf/ ; cd /lib/resolvconf/</code> 
<code><nowiki>wget http://kopparv34.mine.nu/list-records</nowiki></code> 
<code>chmod +x list-records</code> 
Edit <code>/etc/network/interfaces</code> and remove the lines: 
<code> network 192.168.0.0</code> 
<code> gateway 192.168.0.200</code> 
If we need to use the usb network more then just locally from the computer in the other end of the USB-cable, login with ssh and add a default route like this: 
<code>route add default gateway 192.168.0.200</code>
}}

* Usb-networking will not work until rebooted after initial boot.

'''Usability'''

* The Pin-Dialog by default just shows letters. You have to slide your finger up/down over the keyboard to make the numbers/uppercase/special characters appear.
* The installer app doesn't release administrative rights which results in not being able to use opkg. Solution: run "killall packagekitd" (on the freerunner or when ssh'ed in).
* The installer app doesn't release administrative rights which results in not being able to use opkg. Alternate Solution: On the FreeRunner, use the drop-down menu to close all open applications.
* The keyboard may not be adapted for all uses. See [[Keyboard Debate]] for a full discussion and options.

== Official updates for "stable" Om 2008.8 ==

Posterior to the Om2008.8 release made on 2008/08/08, development of ASU/Om2008.8 is switching to a Debian-like model with three branches: stable, testing and unstable ([http://lists.openmoko.org/pipermail/community/2008-August/026491.html see this message] for more details).

Official updates for the "stable" branch are now available (as of 2008/08/26) in two forms (see [http://lists.openmoko.org/pipermail/community/2008-August/027997.html see this message] for the announcement) :
* in the http://downloads.openmoko.org/repository/Om2008.8/ opkg feeds (which should already be configured for opkg updates in 2008.8),
* as flash-able images in http://downloads.openmoko.org/releases/Om2008.8-update/

The changelog of the stable branch can be ogtained here : http://git.openmoko.org/?p=openmoko.git;a=log;h=org.openmoko.asu.stable

== Dedication ==

<pre>
From: Openmoko
To: openmoko-community mailing list

Om 2008.8 was designed to be empty, for the very purpose of showcasing your ideas.

Think of our products as galleries. We're building the environment.
Each one different from the next. You'll get all the free art supplies
you could imagine because we want you to add your own meaning.
You choose: consume, create, or both.

Either way you create your own meaning. It's about you.
</pre>

[[Category:Openmoko]]
[[Category:Om 2008.8]]

Om 2008 Guide

2008-08-31T00:03:11Z

Tkep: warning that Zecke's is down.

{{Om 2008.8}}

This documents quickly some key usability bits about [[Om 2008.8]] and initial setup.

=== Interface ===

'''New Keyboard'''

More details at : [[Om2008.8 Keyboard]]

'''Installer'''

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

'''Top Menu'''

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

=== Things to know ===

''' Commands '''

*'''"ifconfig"''' - Displays network information.

*'''"opkg update"''' - Updates list of available software.

*'''"opkg install"''' - Install software.

*'''"opkg upgrade"''' - Updates your software.

*'''"killall packagekitd"''' - Quits any package manager which could be running. (Run this command if you get the "Could not obtain administrative lock" error message while running opkg commands)

*'''"shutdown -r now"''' or '''"reboot"'''- Reboots your phone.

=== Configuring Om 2008.8 ===

==== Internet ====
Follow this [[http://support.microsoft.com/kb/306126 guide (Windows Users)]]to share your internet with your phone.

To share your internet connection on a Linux host follow this [[USB_Networking|Guide]]

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

After you install and run [[http://wiki.openmoko.org/wiki/Om2008.8#Download Om 2008.8 ]] for the first time you have to restart to get the USB working. Once you have done that you have to ssh into your phone (192.168.0.202) to edit your /etc/network/interfaces so you can access the internet through USB to install software and updates.

Edit the USB section to look like this:

# Ethernet/RNDIS gadget (g_ether)
# ... or on host side, usbnet and random hwaddr
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.1
up echo nameserver 208.67.222.222 > /etc/resolv.conf
up echo nameserver 208.67.220.220 >> /etc/resolv.conf
#up echo nameserver 192.168.0.200 > /etc/resolv.conf

==== Unofficial (zecke) Updates ====

Create a file named zecke.conf and paste this into it to get the latest unofficial updates. (Currently Down--likely no longer needed)

src/gz zecke-all http://people.openmoko.org/~zecke/om2008.8-dev/all
src/gz zecke-arm http://people.openmoko.org/~zecke/om2008.8-dev/armv4t
src/gz zecke-neo http://people.openmoko.org/~zecke/om2008.8-dev/neo1973
src/gz zecke-gta02 http://people.openmoko.org/~zecke/om2008.8-dev/om-gta02

(Restart your phone)

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

==== Mediaplayer ====

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

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

=== Bugs/Fixes ===

*The Media Player is basically unusable because of the skin. And is also very buggy.
*Battery meter always says its charging. Installing a terminal and running "apm" will display the proper battery status.

*Your phone will go into standby after 30 seconds EVEN when connected to your computer or wall charger. (Disable this under the settings menu)

*The wifi doesn't work too well right now.

*Accelerometers have alpha support via [[Gestures]]

*If you only want the rotate screen effect you can give a [[rotate|try to this one]]

*If you let the battery completely drain you will have problems booting it up. Plug it into the wall charger for a few hours and then plug it into your computer and press power.
*BUT, '''if you have another charged battery''', such as from the [http://us.direct.openmoko.com/products/spares-pack Spares pack], you can boot the Neo with the good battery, plug in wall-charger, and hot-swap the drained battery while booted. This allows you to immediately start "fast-charging" with the wall-charger. (Neo needs to be booted to recognize charger and switch to fast-charging)

*Your have to install "illume-config" to have more control over power management, scrolling speeds, keyboard options, and to change how the interface looks.

*Some software that you install by command-line may appear in in the settings menu (wrench) that you unlock after installing "illume-config".

[[Category:Om 2008.8]]

Building FSO

2008-08-06T13:42:57Z

Tkep:

{{Distributions|FSO}}

'''FSO is an abbreviation for FreeSmartphone.Org'''

[[Image:FSO UI main.png|right|thumb|home screen]]

See [[OpenmokoFramework]] for more information.

And [http://www.freesmartphone.org www.freesmartphone.org]

And also [http://trac.freesmartphone.org trac.freesmartphone.org]

''Note : The following is an essay in order to explain how to build FSO. Please mind the fact that it's a work in progress, done by someone fairly new to Open Embedded.''

''This information is taken as is from [http://wiki.openembedded.net/index.php/OEandYourDistro#Using_OpenEmbedded_on_Linux_systems OpenEmbedded Wiki]. Some commentaries are voluntarily stripped in order to keep this page simple, please look on OE Wiki for more information.''

= Getting Open Embedded =

== Mandatory Packages ==

=== Deb-based distributions ===

apt-get install ccache sed wget cvs subversion git-core monotone coreutils \
unzip texi2html texinfo libsdl1.2-dev docbook-utils gawk

=== Mandriva-based distributions ===

urpmi python python-devel python-psyco ccache patch m4 sed bison make wget bzip2 \
cvs gawk glibc-devel gcc-c++ subversion sharutils coreutils docbook-utils openjade \
quilt pcre-devel unzip

=== SuSE (9.1/9.2) instructions ===
Install [http://linux01.gwdg.de/apt4rpm/ apt4rpm], then follow Debian instructions.

python-dev and python-spyco are not in suse apt repository. python-spyco is not mandatory, so one can ignore it.
I suppose python-devel (suse) is python-dev (debian).

=== Fedora Core 2/3 ===

yum install python patch m4 sed make docbook* openjade glibc-devel xmlto

=== Fedora Core 4 ===

Apart from the usual (native) development packages like gcc and binutils, you should check that you have the following RPM's installed:

* bison
* ccache (not required, but advised to speed up building)
* docbook* packages
* libpcre
* m4
* make
* openjade
* patch
* PyQt
* python
* python-psyco
* sed
* xmlto
* quilt (not required as OE builds it by itself, but install it if you want to use gquilt)

Use apt, synaptic, up2date or yum to automagically retrieve these packages or download and install them manually (lots of work).

=== Fedora Core 5/6 ===

Commands I used to install OE pre-requisites on FC5/6

This long command will ensure all pre-requisites are installed (patch is 2.5.4, not 2.5.9, but appears to work).

su -c "yum install python m4 make wget curl ftp cvs monotone subversion tar bzip2 gzip \
unzip python-psyco ccache perl texinfo texi2html diffstat openjade docbook-style-dsssl \
docbook-style-xsl docbook-dtds docbook-utils sed bison bc glibc-devel gcc binutils pcre \
pcre-devel git quilt groff linuxdoc-tools patch gcc gcc-c++ python-sqlite2 help2man"

or download the metapackage http://www.openembedded.org/dl/packages/rpm/openembedded-essential-1.1-1.noarch.rpm (may be out of date).

then do

su -c "yum localinstall openembedded-essential-1.1-1.noarch.rpm"

=== Fedora 7 ===

This long command will ensure all pre-requisites are installed (patch is 2.5.4, not 2.5.9, but appears to work).

su -c "yum install python m4 make wget curl ftp cvs monotone subversion tar bzip2 gzip \
unzip python-psyco ccache perl texinfo texi2html diffstat openjade docbook-style-dsssl \
docbook-style-xsl docbook-dtds docbook-utils sed bison bc glibc-devel gcc binutils pcre \
pcre-devel git quilt groff linuxdoc-tools patch linuxdoc-tools gcc gcc-c++ help2man"

=== CentOS 4.4 / Red Hat Enterprise Linux 4 ===

yum install bison ccache coreutils cvs docbook-utils gawk git-core monotone \
python quilt rpmlib sed subversion tetex texinfo unzip wget

=== Gentoo instructions ===

emerge -n bitbake psyco ccache patch make sed dev-lang/python m4 bison cvs openjade \
quilt sgmltools-lite docbook-xml-dtd docbook-dsssl-stylesheets xmlto docbook-sgml-utils \
libpcre boost subversion monotone texi2html pysqlite diffstat

=== Ark Linux 2007.1 ===

apt-get install devel-core diffstat texi2html cvs subversion git texinfo psyco monotone \
python-devel python-encodings python-sqlite

=== Arch Linux (Duke) ===

sudo pacman -S psyco ccache patch make sed python m4 bison cvs quilt sgmltools-lite \
docbook-xml xmlto pcre boost monotone jade git texinfo

In Arch Linux the install command is in /bin/install. Since most of Linux distribution assume that install is located in /usr/bin/install, you have to create a symlink:

sudo ln -s /bin/install /usr/bin/install

You can build BitBake by using this PKGBUILD:
pkgname=bitbake
pkgver=1.8.4
pkgrel=1
pkgdesc="A simple tool for task execution derived from Gentoo's portage"
url="http://developer.berlios.de/projects/bitbake/"
arch=('i686')
license=('GPL' 'custom')
depends=('python')
source=(http://download.berlios.de/bitbake/${pkgname}-${pkgver}.tar.gz)
md5sums=('508d9a61c635d469be8facc95151158b')

build() {
cd ${startdir}/src/${pkgname}-${pkgver}
python setup.py install --root=${startdir}/pkg

# Install vim extensions
install -D -m644 ${startdir}/src/${pkgname}-${pkgver}/contrib/vim/ftdetect/bitbake.vim \
${startdir}/pkg/usr/share/vim/ftplugin/bitbake.vim
install -D -m644 ${startdir}/src/${pkgname}-${pkgver}/contrib/vim/syntax/bitbake.vim \
${startdir}/pkg/usr/share/vim/syntax/bitbake.vim

# Handle MIT license
install -D -m644 ${startdir}/src/${pkgname}-${pkgver}/doc/COPYING.MIT \
${startdir}/pkg/usr/share/licenses/${pkgname}/COPYING.MIT
}

= Repository Checkout =

== Bitbake ==

Go to the base directory of your [[OpenEmbedded]] environment and checkout bitbake:
<pre><nowiki>
$ cd /stuff/
$ svn co svn://svn.berlios.de/bitbake/branches/bitbake-1.8/ bitbake</nowiki></pre>
'''NOTE:''' for proxy handling, see [http://subversion.tigris.org/faq.html#proxy SVN FAQ]

== Open Embedded ==

=== Obtaining OpenEmbedded ===
Next, you'll need to obtain the actual Openembedded database. The OE database store all the OE metadata: build classes, configuration files, and packages. Then you can extract from this database the development branch(es) you want.

The Openembedded database is a [http://www.venge.net/monotone/ Monotone] database, which is the current SCM (Source Code Management) system for Openembedded. You can find monotone binaries and documentation at [http://www.venge.net/monotone/ Monotone official site].

To obtain Openembedded:
# Go to the base directory of your Openembedded environment
$ cd /stuff/
# Download and bunzip2 the OE database snapshot. '''Note: Unfortunately some monotone versions differ in database format. Check [http://www.openembedded.org/snapshots Snapshots] and download the one matching your monotone version.'''
$ wget http://www.openembedded.org/snapshots/OE.mtn.bz2
$ bunzip2 -d OE.mtn.bz2
This is the database you'll be using for all the work.

If you run into a problem at this stage, check to make sure you have version 0.32 (or newer) of monotone installed.

If you get further troubles in using monotone, there are two ways out:

* use the [http://openembedded.org/snapshots/ latest OE snapshot]
* use a static monotone image

Then you can checkout your local copy of the Openembedded tree.
$ cd /stuff
$ mtn --db=/stuff/OE.mtn checkout --branch=org.openembedded.dev
This extracts directories and files relating to the selected branch from the OE.mtn database and places them under <nowiki>/stuff/branchname</nowiki> (i.e. in <nowiki>/stuff/org.openembedded.dev</nowiki> in this guide)

IMPORTANT NOTE ! If mtn complains about an outdated database, you can migrate it using the following command :

<pre><nowiki>
mtn db migrate --db=/stuff/OE.mtn
</nowiki></pre>

You'll then have to do the checkout.
=== Create local configuration ===
It's now time to create your local configuration.
While you could copy the default local.conf.sample like that:

<pre><nowiki>
$ cd /stuff/
$ cp org.openembedded.dev/conf/local.conf.sample build/conf/local.conf
$ vi build/conf/local.conf
</nowiki></pre>

It is actually recommended to start smaller and keep local.conf.sample in the background and add entries from there step-by-step as you understand and need them. Please, do not just edit build/conf/local.conf.sample but actually READ it.

For building a .dev branch, in your <nowiki>local.conf</nowiki> file, you should have at least the following three entries. Example for the Angstrom distribution and the Openmoko gta01 machine:
<pre><nowiki>
BBFILES = "/stuff/org.openembedded.dev/packages/*/*.bb"
DISTRO = "angstrom-2008.1"
MACHINE = "om-gta01"
</nowiki></pre>

For a Freerunner, using an openmoko distro, you'll do that :

<pre><nowiki>
BBFILES = "/stuff/org.openembedded.dev/packages/*/*.bb"
DISTRO = "openmoko"
MACHINE = "om-gta02"
</nowiki></pre>

Don't forget to include the two following files :

<pre><nowiki>
require conf/distro/include/fso-autorev.inc
require conf/distro/include/moko-autorev.inc
</nowiki></pre>

=== Setup the environment ===
One of the four command sets below will need to be run every time you open a terminal for development. (You can automate this in ~/.profile, /etc/profile, or perhaps use a script to set the necessary variables for using [[BitBake]].)

If you followed the recommendation above to use an uninstalled [[BitBake]]:
<pre><nowiki>
$ export PATH=/stuff/bitbake/bin:$PATH
$ export BBPATH=/stuff/build:/stuff/org.openembedded.dev
</nowiki></pre>

If you installed [[BitBake]]:
<pre><nowiki>
$ export BBPATH=/stuff/build:/stuff/org.openembedded.dev
</nowiki></pre>

Alternative syntax for those using the tcsh shell (e.g FreeBSD):
<pre><nowiki>
$ setenv PATH "/stuff/bitbake/bin:"$PATH
$ setenv BBPATH "/stuff/build:/stuff/org.openembedded.dev:"$BBPATH
</nowiki></pre>

= Start building =

<pre><nowiki>
cd /stuff/build && bitbake fso-image
</nowiki></pre>
[[category:Technical]]
[[Category:Software (non openmoko)]]
[[category:FSO]]

= Configuration =

== GTK ==

Currently GTK is not well supported in the FSO build. To use GTK applications you'll most likely have to install the gtk library, and the Openmoko theme.

'''Step 1) Install the ipk-packages'''

opkg install moko-gtk-theme
opkg install openmoko-icon-theme-standard2

'''Step 2) Enable Theme'''

ln -s /usr/share/themes/Moko/gtk-2.0/gtkrc /etc/gtk-2.0/gtkrc

'''Step 3) Adjust fontsize and set icon theme'''

vi /etc/gtk-2.0/gtkrc

Add the two lines:
gtk-font-name = "Sans 5"
gtk-icon-theme-name="openmoko-standard"

(Thanks to [[User:Jtickle | Jtickle]] for pointing out how to set the font size on the [[Getting_Started_FAQ]]-Page)