Openmoko - User contributions [en]

Qi

2009-08-12T15:07:24Z

Drizzt: /* Testing speed improvements */

{{Languages|Qi}}
[[image:Screenshot-Qi.png|frame|Qi Boot messages]] Qi ( [[http://zh.wikipedia.org/wiki/气| '''氣''' ]] ) is a lightweight replacement for the [[Uboot|uBoot]] bootloader with everything that doesn't assist "loading" and "booting" Linux stripped out.

Its advantages comparing to the [[Uboot|u-boot Openmoko port]] are:
* actively developed (u-boot on GTA02 is deprecated)
* easier configuration, more robust and predictable
* SD and SDHC cards supported properly with partitions of any size
* kernel size is detected by checking the start of the kernel image, so large (>2M) kernels are supported without tweaking or loading more than needed
* Very fast, simple boot direct to Linux

==About Qi==
===Requirements===
There is a [[Neo1973|GTA01]] build of Qi, but using it without a debug board is not recommended because Qi itself does not support DFU, so updating or going back to U-Boot is a difficult process.

[[Freerunner|GTA02 Hardware]] has NOR U-Boot always available, so updating to Qi is safe to try it out.

===Download===

*GTA01 -> [http://people.openmoko.org/andy/ qi-s3c2410]
*GTA02 -> [http://people.openmoko.org/andy/ qi-s3c2442]

====New Versions====

These are the versions we are getting ready for release

Download from either the Neo1973 or NeoFreerunner directory.

http://downloads.openmoko.org/distro/testing

====Unstable and Experimental Versions====

These are the lastest versions from svn.

Download from either the Neo1973 or NeoFreerunner directory.

http://downloads.openmoko.org/distro/unstable

http://downloads.openmoko.org/distro/experimental

====Older Versions====

The download is a ''qi-s3cXXXX-andy_somenumber.udfu'' file at http://people.openmoko.org/andy/ .
Use the file appropriate to your device:

===Installation===
The installation should be flashing like (do it in DFU mode of NOR u-boot):
# dfu-util -a u-boot -R -D qi-s3<version>.udfu
depending on the file you downloaded. The file you use for flashing is depending on the hardware (see section 'Download'). In detail you have to go through the following procedures:

* Connect Freerunner (e.g GTA02 Hardware) with USB-cable
* download [[dfu-util]] via package manager (e.g. YAST with OpenSuse)
* download Qi image (e.g. for GTA02 which is [http://people.openmoko.org/andy/ 'qi-s3c2442-master-hist_3b8513d8b3d9615e.udfu'])
* switch off you freerunner (if necessary) and start uBoot by pressing AUX and Power-On at the same time and then start [[dfu-util]] with the following parameters:
# dfu-util -a u-boot -R -D qi-s3c2442-master-hist_3b8513d8b3d9615e.udfu
See [[Flashing the Neo FreeRunner]] for more details on flashing your phone.

===Features===
* booting from primary SD partitions (1st, 2nd or 3rd) in /boot directory
* booting from NAND (compatible with U-Boot's dynparts scheme)
* configuration per rootfs, by files in /boot in the rootfs
* automatically choose correct kernel for device hardware so rootfs can be used on multiple device types
* automatically tell kernel correct root= for rootfs kernel image came from, simplifying update
* ext2/3 are supported
* symlinks are supported
* parses identity partition and appends kernel commandline with device identity information
* zero "environment" or private persistent state - operation is completely deterministic
* You can always boot from [http://wiki.openmoko.org/wiki/Boot#Log_into_U-Boot_in_the_NOR_Flash NOR menu]

===Use Case===
If you want to install [[Android]] on you OpenMoko you can use Qi. The [[Android on Freerunner]] kernel image can be more than 2MB in size. The UBoot environment that comes with your FreeRunner is only able to boot a kernel of 2MB in size or less. Qi support kernel images greater than 2MB out of the box.

===Limitations===
* no DFU-Mode - USB is not initialized at all (but you can always boot [http://wiki.openmoko.org/wiki/Boot#Log_into_U-Boot_in_the_NOR_Flash from NOR])
* no boot menu (but you can always boot [http://wiki.openmoko.org/wiki/Boot#Log_into_U-Boot_in_the_NOR_Flash from NOR])
* FAT partitions are ignored

Both the lack of DFU and the boot menu are planned to be addressed by the backup / recovery rootfs.

FAT is not supported because it can't provide a rootfs, and Qi wants the kernel to come from the rootfs.

===Defaults===
If the kernel is found on uSD, Qi assumes the rootfs to be on the same partition as the kernel. In case of boot from NAND, it assumes that rootfs is also on NAND (just as u-boot does). See [[#/boot-Partition|below]] for help with an extra /boot-partition. The default rootdelay is 1 second.

===Files===
; /boot/uImage-GTA0[123].bin
: Kernel images, Qi will look for (can be in either uImage (u-boot image) or zImage format, file name should still be uImage-GTA0[123].bin)
; /boot/append-GTA0[123]
: Additional kernel arguments. All arguments should be on the first and the only line separated by spaces, for example: "<tt>loglevel=8 rootdelay=5 </tt>" . Make sure you have an extra space after the last argument (space is no longer needed if the version is from 31 Jan or older)!
; /boot/noboot-GTA0[123]
: make Qi skip this partition

===Speed up kernel resume for SHR===
Since SHR (and perhaps other distributions as well) ouput log messages during resume which slow down the resume process by ca. 3 seconds it make sense there to append the following settings to /boot/append-GTA0[123]:
: loglevel=1 quiet
The disadvantage of this speedup is that you won't see any lifesign of your phone until it starts the graphical user interface after adding these files, though.
===Boot Order===
[[image:Qi-drawings-bootsequence.png|frame|Qi GTA02 Booting order]]
# SD Partition 1
# SD Partition 2
# SD Partition 3
# NAND
# Memory Test

Qi will try to mount each SD partition as ext2 / 3, if that succeeds it will look for the kernel as /boot/uImage-GTA02.bin. If that is found, it'll be fetched, its CRC is checked and then it's booted into with a generated kernel commandline.

===Kernel Commandline Generation===
[[image:Qi-commandline-composition.png‎|frame|Qi commandline composition]] Because Qi has no private stored state, it infers and composes a suitable kernel commandline on each boot.

One of its tasks is to scan NAND memory using the U-Boot dynparts rules to determine the start offset of the NAND partitions on this device, from that it forms the mtdparts kernel parameter that sets Linux's view of NAND partitioning.

The other thing it does is mount the "identity" partition and get from there the globally unique MAC address for the USB over Ethernet function instead of the random one that is otherwise used (If this doesn't work (like with a GTA01) you may use kernel-commandline parameters g_ether.dev_addr= and g_ether.host_addr= for the mac in device and host mode of the usb-ether module).

===LED and Vibrator Signals===
* AUX LED is turned on either on:
** Successful partition mount
** Successful kernel pull
** Successful initramfs pull
* AUX LED is turned off and vibrator runs briefly either on:
** Fail of kernel pull
** Fail of initramfs pull
** Fail of mount partition
** Skipping of current boot possibility
* AUX LED is turned off either on:
** Start of the kernel
** Start of the mem test
** Start of the kernel pull
** Start of the initramfs pull
* One Blue shine every ~10 second: did not find any valid kernel to boot
* About four RED shines per second: kernel panic.

===Booting===
A short press on the power button is enough to make Qi start booting. In a few seconds the backlight will be lit, but the kernel will not spew any console messages unless something is wrong. It may take up to 2 minutes (depends on distribution) until X is started during which there will be no visual feedback. Please be patient.

You can force debug messages on the LCM console by holding in the power button before Linux starts.

===Choosing a Kernel===
If a user presses the AUX button after successful partition mount and
before start of the kernel pull (that is, while the red LED is on),
this boot possibility is skipped (and GTA02 owners can feel
vibration).

On versions newer than Jan 18 if a user holds the POWER button just before start of the kernel,
debugging parameters are added to the kernel command line and a lot of information is output to the screen.

===Boot Menu===
Qi's concept is to leave everything possible to Linux, that includes even the video init. Therefore Qi does NOT provide a boot menu. This should rather be implemented by a minimal Kernel, initramfs and menu system. It may be more comfortable for some users and may get them to switch from uboot to Qi. This does not exist yet (it's already implemented for some Angstrom-supported devices and for Zaurus, so porting should be relatively easy).

===Source code===
git://git.openmoko.org/git/qi.git , http://git.openmoko.org/?p=qi.git;a=summary .
One can also just use strings(1) on the .udfu file to get an idea of where Qi currently looks for files.

===README===
The latest README file can be found in the git as well:http://git.openmoko.org/?p=qi.git;a=blob;f=README;hb=HEAD

==Tips, Tricks, Tweaks==
===General troubleshooting===
Qi does not bring up the LCD backlight. If the backlight is lit, it means you have succeeded to boot into Linux.

If nothing else is happening or there is a panic, enable debugging messages as described below.

===Enabling console messages===

You can just hold in the power button, this automatically appends verbose debugging to the kernel commandline (loglevel=8).

If you always want verbose "dmesg" type debugging messages, you can do it like this:

[http://lists.openmoko.org/pipermail/openmoko-kernel/2008-November/006812.html]
If it's SD Card boot, just create a text file, e.g., for a [[GTA02]] use
/boot/append-GTA02
on the rootfs in question, put in there
loglevel=8
and you'll see the messages on boot. If it's NAND right now you need to edit the default commandline in Qi for gta02.

===/boot-Partition===
If you have a separate partition for /boot, so that your kernel and rootfs are not in fact on the same partition, you will need to append a root= entry on the kernel commandline to override the default action of trying to use the partition where the kernel came from as the rootfs.

Add this in /boot/append-GTA0[123]:
root=/dev/mmcblk0p2
for a rootfs on the second partition.

Note that a default Debian installation puts the kernel straight in the root of /dev/mmcblk0p1, not in a boot subdirectory, expecting u-boot to mount it as /boot. In order for Qi to recognise this, create a boot subdirectory with a symlink to the kernel.

===SD Initialisation===
If you don't specify loglevel=8 in append-GTAXX, and booting fails with a "VFS: Cannot open root device "mmcblk0p1" or unknown-block(2,0)", the SD card needs a little bit more time to initialise.

Put a "rootdelay=5" in append-GTAXX like so:
rootdelay=5

== Testing speed improvements ==

Stopwatch results on Qi (error is approx ±1/2 second):

PLEASE, perform comparable tests !!!!!!!!!!!!

Booting SHR image with uBoot:
* 0:00 power button held down
:: On mine, it apears at 0:05 ... (custom splash)
* 0:07 splash screen appears
:: Here, changing the bootdelay (uboot environnement variable) can improve the delay here
* 0:15 drops to console showing kernel messages scrolling by for ~1 minute
:: This can be improved a lot by using the quiet option on the kernel command line !!!!!!!!!
* 1:18 Openmoko 'please wait' splash
* 1:31 desktop animated splash
* 2:38 finished booting
Why 1'20 min from OM splash to end of boot here
and only 1'00 for the Qi version ???
Qi has no relation to this !!!!!!!!!

Booting identical setup with Qi flashed over uBoot:
* 0:00 power button held down
* 0:06 backlit black
* 0:13 please wait booting... (only this text on console for next 38 seconds)
* 0:51 Angstrom console message (at the end of kernel output with uBoot, but ONLY text display to appear throughout this stage with Qi)
* 0:54 Openmoko 'please wait' splash
* 1:05 desktop animated splash
* 1:54 finished booting

So for this particular configuration, it reduced time-to-desktop by about 28%, about 44 seconds. Surprisingly, the later segments of booting (desktop) were also noticeably faster than with uBoot - One would have expected just the first stages up until init (kernel finished establishing itself) to be faster.

[[Category:Bootloaders]]

FreeRunner unable to work with 3G SIM cards

2008-10-29T16:55:34Z

Drizzt: /* Compatibility table (FreeRunner/GTA02) */

== FreeRunner SIM compatibility ==

See also: [[FreeRunner_Hardware_Issues#Some_SIMs_Don.27t_Work|FreeRunner Hardware Issues]]

=== Carrier ===

There is carrier page documented carriers compatibility [[Carriers]]

=== TRAC Ticket 666 ===
TRAC ticket [http://docs.openmoko.org/trac/ticket/666 666] applies to GTA01 (Neo 1973) and to GTA02 (Neo FreeRunner).

== Compatibility table (FreeRunner/GTA02)==

Please fill out following table .

{| class="wikitable sortable" style="margin: 0em " cellspacing="0" cellpadding="3" border="1"
!Carrier Name!! Error Message !! SIM Card Type!! Country !!Link to picture of SIM card!!Your name!!Did new SIM card solve problem?||Notes
|-
| TDC || Not working || 64K43 || Denmark || no pics || KB || Yes. They sent me a 64K23 card for free and that worked. || The chip on the new card is bigger. It has 4 contact points on each of the 2 columns, instead of 3 on each.
|-
| CHT || Unable to use GSM ||Dont' know|| R.O.C Taiwan || no pics ||王孟蒂 Brenda Wang|| ||When I put it on my Neo, it can't dial out
|-
| AT&T || Unable to use GSM || 71234 G || US || no pics || || || 71234 G SIM not working, 71234 O somebody in discuss thread say it could work
|-
| AT&T || Failed to register || 71234 D|| US || see below || [[Special:Emailuser/Safire|Safire]] || Switched to T-Mobile || Got strong Signal Bars with 2007.2 image despite "Registering...". Actually managed to dial and remote phone showed number, but never completed a full call. Dialer kept crashing. Pre-paid brand new sim, purchased July 2008
|-
| Vodafone || cme 13, 32 || some 3G capable|| DE || no pics || [[Special:Emailuser/Fsp|Fsp]] || no || most up-to-date Plan debitel
|-
| T-Mobile || No Error || 2G SIM || US || no pics || Community List || || Pre-paid SIM
|-
| e-plus || not working || 3G SIM || DE || no pics || Community List || || Plan SIM
|-
| e-plus (SIMYO) || 2G seems working/3G not || 2G/3G SIM || DE || no pics || Community List || || Pre-Paid SIM https://www.simyo.de/de/informieren/umts.html SIMYO has 2 voltage 1.8/3.3v 72K 1.8V #569 J276/2K 3V #568 H276
|-
| e-plus || working || 2G SIM || DE || no pics || Community List || || Plan SIM
|-
| O2 || Not certain/Not working || 3G SIM || DE || no pics || Community List || || Plan SIM, CME: 32, (1001710251761MC working)
|-
| O2 || not working || 3G sim || DE || [http://kev.knet.eu/bugs/openmoko/sim-card/not_working_O2.png link] || [[Special:Emailuser/Kevin|Kevin]] || Did not solve. Both simcards (7 month old one and new one) are looking identical. || I would like to help on testing/whatever, feel free to contact me.
|-
| vodafone(D2 Mannesmann) || working || 2G SIM || DE || no pics || Community List || || Plan SIM
|-
| Blau SIM || some working || 2G/3G SIM || DE || no pics || Community List || || 16K 3V #343 H73 (not work)
|-
| Orange || working || 2G model J2R || FR || no pics || [[Special:Emailuser/pierrebrua|pierrebrua]] || || None
|-
| Orange || working || 2G/3G some wokring || DE || no pics || Community List || || None
|-
| Bouygues || working || 08 series || FR || no pics || [[Special:Emailuser/pierrebrua|pierrebrua]] || || Bad sound
|-
| T-Mobile || Not certain/Not working || unknown || DE || no pics || Community List || || None
|-
| o2 || cme error: 100 
cme error: 313
|| 2G possibly 3g? || UK || no pics.. YET. || [[Special:Emailuser/tdobson|tdobson]] || other SIMs work - MTS(RU) Orange(UK) Vodafone(UK) || Prepaid. Feel free to contact me.
|-
| Orange || working || 3G "USIM" || FR || (see below) || KewlCat || Om2008.8-update (20080827) solved it || Pre-paid SIM
|-
| Proximus Belgacom Mobile || not working || 2G model 3V || BE || no pics || [[Special:Emailuser/pierrebrua|pierrebrua]] || || None
|-
| SFR || partially working || 2G model AF and BC || FR || no pics || [[Special:Emailuser/pierrebrua|pierrebrua]] || || 50% incoming calls are missed due to lost carrier
|-
| SFR || not working || 3G model BK || FR || no pics || [[Special:Emailuser/pierrebrua|pierrebrua]] || || not detected by the phone
|-
| SFR || not working || 3G model BC and BK || FR || no pics || [[Special:Emailuser/Drizzt|Drizzt]] || || not detected by the phone
|-
| IT VODAFONE || not working || 64K || IT || no pics || Six-Blade Knife || Yes || not detected by the phone, changed with 128K and worked
|-
|}

== User Provided tested SIM pictures ==

[[Image:ATT_3G_71234D_SIM.JPG|left|thumb|200px|AT&T 3G 71234 D]]

Base on community post:

The 71324 is the SKU for the AT&T latest UICC.
The 2022 is the Vendor and Version number.

Some cards the vendor numbers are
2 - G&D
3 - Gemalto
4 - Oberthur

Usually user will get CME ERROR 13 (sim failure), rather than CME ERROR 10 (sim not inserted) when 3G SIM not working.

CME ERROR: 32 is Network not allowed, emergency calls only, might because the card not activated.

== The Error ==
<pre>
Here is the AT command:

root@om-gta02:~# libgsmd-tool -m atcmd
libgsm-tool - (C) 2006-2007 by Harald Welte and Openmoko, Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY

AT
STR=`AT'
RSTR=`OK'
AT+CFUN=1
STR=`AT+CFUN=1'
RSTR=`OK'
AT+CPIN?
STR=`AT+CPIN?'
RSTR=`+CPIN: SIM PIN'
AT+CPIN="MyPIN"
STR=`AT+CPIN="MyPIN"'
RSTR=`OK'
AT+CPIN?
STR=`AT+CPIN?'
RSTR=`+CPIN: SIM PIN'
AT+CREG=1
STR=`AT+CREG=1'
RSTR=`OK'
AT+COPS=0
STR=`AT+COPS=0'
EVENT: Netreg searching for network
EVENT: Netreg registration denied
cme error: 32
RSTR=`+CME ERROR: 32'
EVENT: Signal Quality: 31
EVENT: Signal Quality: 31
</pre>

== Working and not working AT&T card ==

* Some AT&T cards have same vendor/ID number, but different contacts (Josh posted at 2008/8/24), following image shows that card that working (right) and not working (left) one.

[[Image:ATT_simcards_small.jpg]]

== Working SIM pics ==

[[Image:Adam_20080713_working_back.JPG]]

[[Image:KewlCat_20080829_Working_front.png]][[Image:Usim2.png]]
[[Image:Working-orange-usim.jpg]]

== Not Working SIM pics ==
* AT&T

[[Image:Adam_20080713_back_notworking.JPG]]

* Orange France

[[Image:Jean_20080715_orange_back_notworking.JPG.gif]]

* O2 Germany

[[Image:O2-sim-nonworking-tesa.jpg]]

[[Category:Neo FreeRunner Hardware]]

User:Drizzt

2008-07-28T11:48:47Z

Drizzt: New tests with SFR cards

OK .. We can have a page "per user", so I'll try to give here some feedback, and what works what does not, and what tests I did.

I received my FR on July 12 2008, and as of yet did this:

== GSM ==
=== Orange ===
Tried "Mobicarte"
* OK, able to dial the number to credit the "Mobicarte" online. Very low sound level.
* Tried a second one, OK. Gave a call but just up to the dialing and "Rings" (people having these cards tend to have very few credit on them.)

Tried another one from Orange (Have to ask my friend what his card was)
* Network OK, dialing OK, but I did not try to go further (do all people using Orange provider have no credit at all !!!!)
* This one had a pin code, all right (first time I saw the pin code screen !).

=== SFR ===
Tried my own SFR card : "Les Illimythics Internet 3G+"
* NOT WORKING...
* Does not ask my PIN code.
* All other cards I tried were OK, so I know it's not completely broken.
* I tried a lot of things....
* I keep having error 10 (SIM not inserted) or 13 (SIM Failure)
[http://www.ctiforum.com/standard/standard/etsi/0707.pdf Doc] - GSM AT Command Set, with Error codes on pages 88 and 89

Tried the SIM card from a friend (SFR, 2 months Old)
* Asks PIN code, login OK.
* Tried Call, OK, though low sound level. Saw some threads about this in the community list, I'll check when my own card will be detected.
* Got access to the contacts from the SIM card.

Went today (2008-07-28) to the SFR shop, they gave me a brand new card :
* Asks for PIN code, code is OK, but then a few seconds later (30?) it asks for the PIN code once again, and so on...
* I did not try on my old phone while in the shop, but I should have, for even with it I have this problem, with the message "General: Operation Expired"
* I'll go back to the shop.

Tests to fix:
* I'll try newer Images to see if anything happens with my SIM problem.
* I also read in the community list that some had their card working with qtopia images. I'll try them, and if it works for me, I'll try to figure out the differences.

== Terminal ==

* I installed the matchbox keyboard and built a new [http://www.nathael.org/Data/OpenMoko/keyboard.xml layout] (mostly out of french keyboard, but not so mutch when it comes to non alpha)
* [http://www.nathael.org/Data/OpenMoko/Sreenshots/ Here] are some screenshots of the layout.

* Had some difficulties with opkg in the beginning, but it did not last and I'm unable to reproduce.

== GPS ==
* Installed what you'll find there : [[Getting_Started_with_your_Neo_FreeRunner#GPS.2C_GPRS_and_WLAN|GPS Tools]]
* A friend Tried a lot of times to have a first fix with no success, even crashing the phone (had to remove the Battery) many times while using agpsui, but he must have had a bad feeling whith the phone as I've had a fix in 18s the first time I tried. [http://www.nathael.org/Data/OpenMoko/Sreenshots/Fix_GPS_OK.png First Fix]
* Tried this with no SD card in the phone of course. Did not try with an SD Yet.

== Devel ==
* Not started Yet (I just released my project to my customer) (24 July 2008)
* git's are now imported, I should start soon :)

Latest Images

2008-07-24T14:09:38Z

Drizzt: /* ScaredyCat */

This page is intended to summarize in one place the various images you can try out on your Openmoko Neo FreeRunner (GTA02) or 1973 (GTA01). Note however, that some of these are works in progress and may not have even released any files yet. Nothing is guaranteed to work. Proceed at your own risk.

Currently, the images in development include:
*The 2007.2 GTK Image that ships on the Freerunner
*The ASU (April|August Software Update) qtopia-based Image
*The FSO (FreeSmartPhone.org) Image
*Qtopia image from qtopia.net
*The SHR (Stable Hybrid Release) Image
*Copying a jffs2 image to ext2 to boot from microSD

;See [[Distributions]] for a chart comparing the features of the various images.

Michael Lauer's blog also has an entry comparing the distributions: [http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO? TMTLA!]

Instructions on flashing your FreeRunner or 1973 are provided at [[Flashing the Neo FreeRunner]] and [[Getting Started with your Neo1973]], respectively.
----
==2007.2 GTK Image==
The latest most stable release should reside here:
[http://buildhost.openmoko.org/releases/Freerunner/ http://buildhost.openmoko.org/releases/Freerunner/]

*You can download the latest daily builds here:
**For Neo FreeRunner [http://buildhost.openmoko.org/daily/freerunner/ http://buildhost.openmoko.org/daily/freerunner/]
***Look for files of the form: Openmoko-openmoko-devel-image-glibc-ipk-P1-Snapshot-YYYYMMDD-om-gta02.rootfs.tar.gz
***and: openmoko-devel-image-om-gta02.tar.gz
**For Neo 1973 the link is [http://buildhost.openmoko.org/daily/neo1973/ http://buildhost.openmoko.org/daily/neo1973/]
***Look for files of the form: openmoko-devel-image-om-gta01.tar.gz
***and: Openmoko-openmoko-devel-image-glibc-ipk-P1-Snapshot-YYYYMMDD-om-gta01.rootfs.tar.gz
**Tools, like dfu-util and openocd [http://buildhost.openmoko.org/daily/tools/ http://buildhost.openmoko.org/daily/tools/]

Several videos of this stack by [http://uk.youtube.com/user/freeyourphone Youtube user freeyourphone]
and [http://uk.youtube.com/watch?v=U05kZfURPig&NR=1 video review by BVB Tech]
=== ScaredyCat ===
Users may have heard of "ScaredyCat" images. These are usable images created by [http://blog.automated.it/category/openmoko/ Andy Powell] and are currently based on the 2007.02 software stack.

Hey, all file names are with "gta01" !
Is this an error and they are gta02 (FR) ??

http://buildhost.automated.it/OM2007.2/
----

==ASU (April|August Software Update) qtopia-based Image==
There has not been a recommended release of the ASU yet. You may wish to review the [[ASU_Feature_Plan]] or some [http://dos.jogger.pl/2008/06/29/asu-to-przyszlosc/ screenshots]

*You can download the latest daily builds here:
**For Neo FreeRunner [http://buildhost.openmoko.org/daily/freerunner/ http://buildhost.openmoko.org/daily/freerunner/]
***Look for files of the form: openmoko-qtopia-x11-image-om-gta02.tar.gz
***and: Openmoko-openmoko-qtopia-x11-image-glibc-ipk-P1-Snapshot-YYYYMMDD-om-gta02.rootfs.tar.gz
**For Neo 1973 the link is [http://buildhost.openmoko.org/daily/neo1973/ http://buildhost.openmoko.org/daily/neo1973/]
***Look for files of the form: openmoko-qtopia-x11-image-om-gta01.tar.gz
***and: Openmoko-openmoko-qtopia-x11-image-glibc-ipk-P1-Snapshot-YYYYMMDD-om-gta01.rootfs.tar.gz
----

==FSO (FreeSmartPhone.org) Image==
Milestone 1 is here: [http://downloads.openmoko.org/framework/milestone1/ http://downloads.openmoko.org/framework/milestone1/]

[http://www.youtube.com/watch?v=toPe0S8QpJY Video of FSO Milestone 1]

Browse the source: [http://trac.freesmartphone.org:8000/trac-example/browser http://trac.freesmartphone.org:8000/trac-example/browser]

Learn more at its wiki page: [[OpenmokoFramework]]
----

==Qtopia image from qtopia.net==
[http://www.qtopia.net/modules/mydownloads/index.php Qtopia.net images] for the
*Neo FreeRunner
**[http://www.qtopia.net/modules/mydownloads/visit.php?lid=67 Freerunner flash image] (qtopia-4.3.2-gta02-flash.tgz) <-- a tarball with both a rootfs and kernel
**and the [http://www.qtopia.net/modules/mydownloads/visit.php?lid=68 root file system (ficgta02-qtopia-developer-rootfs.tgz)]
*Neo 1973
**[http://qtopia.net/downloads/neo/qtopia-4.3.2-gta01-flash.tgz Neo 1973 flash image] (qtopia-4.3.2-gta01-flash.tgz) <-- a tarball with both a rootfs and kernel
**[http://www.qtopia.net/modules/mydownloads/visit.php?lid=39 Neo 1973 root file system] (Link temporarily broken.)
**A Neo 1973 image is also available from here [http://buildhost.automated.it/OM2007.2/openmoko-qtopia-image-om-gta01.tar.gz openmoko-qtopia-image-om-gta01.tar.gz]
*[http://www.qtopia.net/modules/mydownloads/viewcat.php?cid=6 Alternate download page]
*You might also try [http://trolltech.com/developer/downloads/qtopia/qtopia-source-gpl ftp.trolltech.com snapshots]

----

==SHR (Stable Hybrid Release) Image==
The Stable Hybrid Release (SHR) is intended to be a combination of the
FSO, some of the 2007.2 GTK software, and the ASU that provides all of
the functionality of the 2007.2 software, but with the stability of
the FSO and the new GUI toolkits provided by the ASU. It will probably
be based on an ASU build, with the FSO software and GTK end-user apps
added.

The SHR doesn't exist anywhere but in a few people's heads at the moment (2008-07-05). Hopefully, all the work in it will be integrated back into one of the other releases, and it will cease to exist. The point is to get us a release with stable calls & suspend/resume, plus access to all those other nifty apps we had on 2007.2 and the ASU.

Learn more at its wiki page: [[Stable_Hybrid_Release]]
----

==Copying a jffs2 image to ext2 to boot from microSD==
If you want to copy a rootfs jffs2 to a ext2 filesystem on an microSD card, see [[Userspace root image#Mounting the JFFS2 image on a loop back device (Block Memory MTD Emulation) | this]].

[[category:Openmoko]]

User:Drizzt

2008-07-24T01:47:04Z

Drizzt:

OK .. We can have a page "per user", so I'll try to give here some feedback, and what works what does not, and what tests I did.

I received my FR on July 12 2008, and as of yet did this:

== GSM ==
=== Orange ===
Tried "Mobicarte"
* OK, able to dial the number to credit the "Mobicarte" online. Very low sound level.
* Tried a second one, OK. Gave a call but just up to the dialing and "Rings" (people having these cards tend to have very few credit on them.)

Tried another one from Orange (Have to ask him what his card was)
* Network OK, dialing OK, but I did not try to go further (do all people using Orange provider have no credit at all !!!!)
* This one had a pin code, all right (first time I saw the pin code screen !).

=== SFR ===
Tried my own SFR card : "Les Illimythics Internet 3G+"
* NOT WORKING...
* Does not ask my PIN code.
* All other cards I tried were OK, so I know it's not completely broken.
* I tried a lot of things....
* I keep having error 10 (SIM not inserted) or 13 (SIM Failure)
[http://www.ctiforum.com/standard/standard/etsi/0707.pdf Doc] - GSM AT Command Set, with Error codes on pages 88 and 89

Tests to fix:
* I'll try newer Images to see if anything happens with my SIM problem.
* I also read in the community list that some had their card working with qtopia images. I'll try them, and if it works for me, I'll try to figure out the differences.

== Terminal ==

* I installed the matchbox keyboard and built a new [http://www.nathael.org/Data/OpenMoko/keyboard.xml layout] (mostly out of french keyboard, but not so mutch when it comes to non alpha)
* [http://www.nathael.org/Data/OpenMoko/Sreenshots/ Here] are some screenshots of the layout.

* Had some difficulties with opkg in the beginning, but it did not last and I'm unable to reproduce.

== GPS ==
* Installed what you'll find there : [[Getting_Started_with_your_Neo_FreeRunner#GPS.2C_GPRS_and_WLAN|GPS Tools]]
* A friend Tried a lot of times to have a first fix with no success, even crashing the phone (had to remove the Battery) many times while using agpsui, but he must have had a bad feeling whith the phone as I've had a fix in 18s the first time I tried. [http://www.nathael.org/Data/OpenMoko/Sreenshots/Fix_GPS_OK.png First Fix]
* Tried this with no SD card in the phone of course. Did not try with an SD Yet.

== Devel ==
* Not started Yet (I just released my project to my customer) (24 July 2008)
* git's are now imported, I should start soon :)

User:Drizzt

2008-07-24T01:44:53Z

Drizzt: /* GPS */

OK .. We can have a page "per user", so I'll try to give here some feedback, and what works what does not, and what tests I did.

I received my FR on July 12 2008, and as of yet did this:

== GSM ==
=== Orange ===
Tried "Mobicarte"
* OK, able to dial the number to credit the "Mobicarte" online. Very low sound level.
* Tried a second one, OK. Gave a call but just up to the dialing and "Rings" (people having these cards tend to have very few credit on them.)

Tried another one from Orange (Have to ask him what his card was)
* Network OK, dialing OK, but I did not try to go further (do all people using Orange provider have no credit at all !!!!)
* This one had a pin code, all right (first time I saw the pin code screen !).

=== SFR ===
Tried my own SFR card : "Les Illimythics Internet 3G+"
* NOT WORKING...
* Does not ask my PIN code.
* All other cards I tried were OK, so I know it's not completely broken.
* I tried a lot of things....
* I keep having error 10 (SIM not inserted) or 13 (SIM Failure)
[http://www.ctiforum.com/standard/standard/etsi/0707.pdf Doc] - GSM AT Command Set, with Error codes on pages 88 and 89

Tests to fix:
* I'll try newer Images to see if anything happens with my SIM problem.
* I also read in the community list that some had their card working with qtopia images. I'll try them, and if it works for me, I'll try to figure out the differences.

== Terminal ==

* I installed the matchbox keyboard and built a new [http://www.nathael.org/Data/OpenMoko/keyboard.xml layout] (mostly out of french keyboard, but not so mutch when it comes to non alpha)
* [http://www.nathael.org/Data/OpenMoko/Sreenshots/ Here] are some screenshots of the layout.

* Had some difficulties with opkg in the beginning, but it did not last and I'm unable to reproduce.

== GPS ==
* Installed what you'll find there : [http://wiki.openmoko.org/wiki/Getting_Started_with_your_Neo_FreeRunner#GPS.2C_GPRS_and_WLAN GPS Tools]
* A friend Tried a lot of times to have a first fix with no success, even crashing the phone (had to remove the Battery) many times while using agpsui, but he must have had a bad feeling whith the phone as I've had a fix in 18s the first time I tried. [http://www.nathael.org/Data/OpenMoko/Sreenshots/Fix_GPS_OK.png First Fix]
* Tried this with no SD card in the phone of course. Did not try with an SD Yet.

== Devel ==
* Not started Yet (I just released my project to my customer) (24 July 2008)
* git's are now imported, I should start soon :)

User:Drizzt

2008-07-24T01:43:01Z

Drizzt: First Edit of my personal page

OK .. We can have a page "per user", so I'll try to give here some feedback, and what works what does not, and what tests I did.

I received my FR on July 12 2008, and as of yet did this:

== GSM ==
=== Orange ===
Tried "Mobicarte"
* OK, able to dial the number to credit the "Mobicarte" online. Very low sound level.
* Tried a second one, OK. Gave a call but just up to the dialing and "Rings" (people having these cards tend to have very few credit on them.)

Tried another one from Orange (Have to ask him what his card was)
* Network OK, dialing OK, but I did not try to go further (do all people using Orange provider have no credit at all !!!!)
* This one had a pin code, all right (first time I saw the pin code screen !).

=== SFR ===
Tried my own SFR card : "Les Illimythics Internet 3G+"
* NOT WORKING...
* Does not ask my PIN code.
* All other cards I tried were OK, so I know it's not completely broken.
* I tried a lot of things....
* I keep having error 10 (SIM not inserted) or 13 (SIM Failure)
[http://www.ctiforum.com/standard/standard/etsi/0707.pdf Doc] - GSM AT Command Set, with Error codes on pages 88 and 89

Tests to fix:
* I'll try newer Images to see if anything happens with my SIM problem.
* I also read in the community list that some had their card working with qtopia images. I'll try them, and if it works for me, I'll try to figure out the differences.

== Terminal ==

* I installed the matchbox keyboard and built a new [http://www.nathael.org/Data/OpenMoko/keyboard.xml layout] (mostly out of french keyboard, but not so mutch when it comes to non alpha)
* [http://www.nathael.org/Data/OpenMoko/Sreenshots/ Here] are some screenshots of the layout.

* Had some difficulties with opkg in the beginning, but it did not last and I'm unable to reproduce.

== GPS ==
* Installed what you'll find there : [[http://wiki.openmoko.org/wiki/Getting_Started_with_your_Neo_FreeRunner#GPS.2C_GPRS_and_WLAN GPS Tools]]
* A friend Tried a lot of times to have a first fix with no success, even crashing the phone (had to remove the Battery) many times while using agpsui, but he must have had a bad feeling whith the phone as I've had a fix in 18s the first time I tried. [http://www.nathael.org/Data/OpenMoko/Sreenshots/Fix_GPS_OK.png First Fix]
* Tried this with no SD card in the phone of course. Did not try with an SD Yet.

== Devel ==
* Not started Yet (I just released my project to my customer) (24 July 2008)
* git's are now imported, I should start soon :)

Today/2007.2

2008-07-20T22:47:19Z

Drizzt: export of the right DBUS_SESSION_BUS_ADDRESS in one single command without having to copy

== Overview ==
This article defines the second revision of the Today Application, an application designed for the OpenMoko platform.

The Today application is the entry point for the user. It therefore resides on the 'desktop' of the phone, and is used for the following:
1) Quickly finding out the status of phone & calender related items.
2) Launch a new application.
3) Manage running applications i.e. Switch to or close a running application.

== Use Cases ==
Here are some possible use cases:
* I want to be able to view at a glance today's Calendar Events and To Do Items.
* I want to launch an application.
* I want to switch to a running application.

== Core Functionality ==

(Italics = Done, Bold = In progress)

* '''View network provider'''
* ''Overview of missed calls and unread messages''
* ''Overview of future events, tasks and alarms''
* '''Lock the phone to prevent accidental touch-screen press'''
* ''Launch core applications''
* ''Launch dialer to view missed calls''
* ''Launch messages application to view unread messages''

* ''View all applications, with descriptions''
* ''Launch a selected application''
* ''Filter all applications by category''
* ''Filter all applications on name and description by custom search string''

* ''View running applications''
* ''Switch to running application''
* ''Close running application''
* ''Close all running applications''

== Layout Components ==

=== Application Area ===
==== Today Page ====

[[Image:today-main-arrows.png]]

*'''1) Title''' -- This is a global panel applet which automatically sets the title to the currently on screen application. It also provides a quick way to switch between running applications.
*'''2) Phone Group''' -- Has the network operator as the title, and shows the number of missed calls and unread SMS's.
*'''3) Calender Group''' -- Shows the time and date as the title, and has a list of calender items, todo's and reminders.
*'''4) Main Page''' -- Current page.
*'''5) Launch Task Page''' -- Switches to the Launch Task page, where the user can browse and launch applications.
*'''6) Running Tasks Page''' -- Switches to the Running Tasks page, where the user can switch to or close running applications.
*'''7) Quick Launch''' -- A tool-bar housing the most used applications.

==== Launch Task Page ====

[[Image:today-new-arrows.png]]

*'''1) Title'''
*'''2) Application List''' -- A list of available applications.
*'''3) Today Page''' -- Switches to the Today page.
*'''4) Launch Task Page''' -- Current Page.
*'''5) Running Tasks Page''' -- Switches to the Running Tasks page, where the user can switch to or close running applications.
*'''6) Search/Filter Menu''' -- This is used to filter the applications, either by clicking the search icon and typing in a string, or by clicking on the filter menu and choosing an application group.

==== Running Tasks Page ====

[[Image:today-running-arrows.png]]

*'''1) Title'''
*'''2) Switch To''' -- Switches to the highlighted application.
*'''3) Close''' -- Closes the highlighted application.
*'''4) Close All''' -- Closes all the running applications.
*'''5) Today Page''' -- Switches to the Today page.
*'''6) Launch Task Page''' -- Switches to the Launch Task page.
*'''7) Running Tasks Page''' -- Current Page.
*'''8) List Of Running Applications'''

== Adjust UI components at runtime ==

*'''default''': this is from daily build default image
[[Image:Todaypage_reduced_false.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/reduced false

*'''reduced''': remove the upper application icons, no clock, and no date
[[Image:Todaypage_reduced_true.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/reduced true

*'''digital/analog clock''' : change the digital clock to analog clock
[[Image:Todaypage_digitalclock_false.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/digital_clock false

*'''remove clock entirely'''
[[Image:Todaypage_noclock.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/small_clock true

*'''change wallpaper image'''
[[Image:Todaypage_changewallpaper.png|200px|]]
# gconftool-2 --type string --set /desktop/poky/interface/wallpaper /usr/share/pixmaps/wallpaper.png'''

* '''gconf problem (the hard fix)'''
(gconftool-2:1366): GConf-WARNING **: Client failed to connect to the D-BUS daemon:
Failed to execute dbus-launch to autolaunch D-Bus session
Error setting value: No D-BUS daemon running

root@fic-gta02:/$ ps aux | grep today
root 1320 3.7 11.5 33556 14100 ? S 23:00 0:09 openmoko-today
root 1369 0.0 0.4 2860 592 pts/0 S+ 23:04 0:00 grep today

root@fic-gta02:/$ cat /proc/1320/environ

root@fic-gta02:/$ export DBUS_SESSION_BUS_ADDRESS=unix:abstract=/tmp/dbus-80gSL9Q6F4,
guid=6efed88183a7f6b9210cf40047ba0dfe

Doing it with one single line :
cat /proc/`pidof openmoko-today`/environ |grep DBUS > exptmp && export `cat exptmp` && rm exptmp

* '''gconf problem (the easy fix)''': Prefix the command with dbus-launch, see below example:
root@fic-gta02:/$ dbus-launch gconftool-2 --type string --set /desktop/poky/interface/wallpaper /usr/share/pixmaps/wallpaper.png'''

anyone knoe how to change the lock screen stuff? or atleast where to look

{{Languages|Today/2007.2}}
[[Category:Openmoko]]
[[Category:Implemented]]

Today/2007.2

2008-07-20T22:45:51Z

Drizzt: export of the right DBUS_SESSION_BUS_ADDRESS in one single command without having to copy

== Overview ==
This article defines the second revision of the Today Application, an application designed for the OpenMoko platform.

The Today application is the entry point for the user. It therefore resides on the 'desktop' of the phone, and is used for the following:
1) Quickly finding out the status of phone & calender related items.
2) Launch a new application.
3) Manage running applications i.e. Switch to or close a running application.

== Use Cases ==
Here are some possible use cases:
* I want to be able to view at a glance today's Calendar Events and To Do Items.
* I want to launch an application.
* I want to switch to a running application.

== Core Functionality ==

(Italics = Done, Bold = In progress)

* '''View network provider'''
* ''Overview of missed calls and unread messages''
* ''Overview of future events, tasks and alarms''
* '''Lock the phone to prevent accidental touch-screen press'''
* ''Launch core applications''
* ''Launch dialer to view missed calls''
* ''Launch messages application to view unread messages''

* ''View all applications, with descriptions''
* ''Launch a selected application''
* ''Filter all applications by category''
* ''Filter all applications on name and description by custom search string''

* ''View running applications''
* ''Switch to running application''
* ''Close running application''
* ''Close all running applications''

== Layout Components ==

=== Application Area ===
==== Today Page ====

[[Image:today-main-arrows.png]]

*'''1) Title''' -- This is a global panel applet which automatically sets the title to the currently on screen application. It also provides a quick way to switch between running applications.
*'''2) Phone Group''' -- Has the network operator as the title, and shows the number of missed calls and unread SMS's.
*'''3) Calender Group''' -- Shows the time and date as the title, and has a list of calender items, todo's and reminders.
*'''4) Main Page''' -- Current page.
*'''5) Launch Task Page''' -- Switches to the Launch Task page, where the user can browse and launch applications.
*'''6) Running Tasks Page''' -- Switches to the Running Tasks page, where the user can switch to or close running applications.
*'''7) Quick Launch''' -- A tool-bar housing the most used applications.

==== Launch Task Page ====

[[Image:today-new-arrows.png]]

*'''1) Title'''
*'''2) Application List''' -- A list of available applications.
*'''3) Today Page''' -- Switches to the Today page.
*'''4) Launch Task Page''' -- Current Page.
*'''5) Running Tasks Page''' -- Switches to the Running Tasks page, where the user can switch to or close running applications.
*'''6) Search/Filter Menu''' -- This is used to filter the applications, either by clicking the search icon and typing in a string, or by clicking on the filter menu and choosing an application group.

==== Running Tasks Page ====

[[Image:today-running-arrows.png]]

*'''1) Title'''
*'''2) Switch To''' -- Switches to the highlighted application.
*'''3) Close''' -- Closes the highlighted application.
*'''4) Close All''' -- Closes all the running applications.
*'''5) Today Page''' -- Switches to the Today page.
*'''6) Launch Task Page''' -- Switches to the Launch Task page.
*'''7) Running Tasks Page''' -- Current Page.
*'''8) List Of Running Applications'''

== Adjust UI components at runtime ==

*'''default''': this is from daily build default image
[[Image:Todaypage_reduced_false.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/reduced false

*'''reduced''': remove the upper application icons, no clock, and no date
[[Image:Todaypage_reduced_true.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/reduced true

*'''digital/analog clock''' : change the digital clock to analog clock
[[Image:Todaypage_digitalclock_false.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/digital_clock false

*'''remove clock entirely'''
[[Image:Todaypage_noclock.png|200px|]]
# gconftool-2 --type bool --set /desktop/poky/interface/small_clock true

*'''change wallpaper image'''
[[Image:Todaypage_changewallpaper.png|200px|]]
# gconftool-2 --type string --set /desktop/poky/interface/wallpaper /usr/share/pixmaps/wallpaper.png'''

* '''gconf problem (the hard fix)'''
(gconftool-2:1366): GConf-WARNING **: Client failed to connect to the D-BUS daemon:
Failed to execute dbus-launch to autolaunch D-Bus session
Error setting value: No D-BUS daemon running

root@fic-gta02:/$ ps aux | grep today
root 1320 3.7 11.5 33556 14100 ? S 23:00 0:09 openmoko-today
root 1369 0.0 0.4 2860 592 pts/0 S+ 23:04 0:00 grep today

root@fic-gta02:/$ cat /proc/1320/environ

root@fic-gta02:/$ export DBUS_SESSION_BUS_ADDRESS=unix:abstract=/tmp/dbus-80gSL9Q6F4,
guid=6efed88183a7f6b9210cf40047ba0dfe

Doing it with one single line :
cat /proc/`pidof openmoko-today`/environ |grep DBUS_SESSION_BUS_ADDRESS > exptmp && export `cat exptmp` && rm exptmp

* '''gconf problem (the easy fix)''': Prefix the command with dbus-launch, see below example:
root@fic-gta02:/$ dbus-launch gconftool-2 --type string --set /desktop/poky/interface/wallpaper /usr/share/pixmaps/wallpaper.png'''

anyone knoe how to change the lock screen stuff? or atleast where to look

{{Languages|Today/2007.2}}
[[Category:Openmoko]]
[[Category:Implemented]]

Gsmd

2008-07-15T23:02:24Z

Drizzt: indications to run gsmd with a separate logfile and in background, but not as daemon.

{{Languages | Gsmd}}
[[gsmd]] is the [[GSM]] daemon running in background of an Openmoko phone, managing the traditional 'phone' parts (voice/sms/gprs communication links) of the phone.

Further technical details and API documentation in progress, is available [[Gsmd/document |here]].

== Usage ==

=== On the phone ===
gsmd is usually started as a background daemon when booting by the /etc/init.d/gsmd script, in this case gsmd outputs debug messages to the file "/tmp/gsm.log" (stdout and stderr is redirected there).

For debugging purposes gsmd can be run in foreground mode, options can be queried like:
<pre>
> gsmd --help
gsmd - (C) 2006 by Harald Welte <laforge@gnumonks.org>
This program is FREE SOFTWARE under the terms of GNU GPL

Usage:
-v --version Display program version
-d --daemon Deamonize
-h --help Display this help message
-p dev --device dev Specify serial device to be used
-s spd --speed spd Specify speed in bps (9600,38400,115200,...)
-F --hwflow Hardware Flow Control (RTS/CTS)
-L --leak-report Leak Report of talloc memory allocator
-l file --logfile file Specify a logfile to log to
</pre>

If your GSM modem is attached to ttySAC0 (like in the [[:Category:Neo1973 Hardware | Neo1973]]), invoke it as e.g.:
> gsmd -p /dev/ttySAC0 -s 115200 -F
(baud rate seems to be autodetected by the modem)

In order to kill the actual gsmd process and then run gsmd with a separate logfile and in background, but not as daemon:
> kill -SIGTERM `pidof gsmd`
and then to create a logfile with the date in the name
> gsmd -p /dev/ttySAC0 -s 115200 -F -l logs_gsmd-`date +%Y-%m-%d_%Hh%M` &

=== From host PC===
With recent [[uboot]] (svn > r2885), the gsm modem can be powered on and connected to uboot's serial console from uboot itself. Thus allowing the host PC to interact directly with the modem. Some notes about getting gsmd running in this manner is [[User:Miki/hosted_gsmd|here]].

== libgsmd ==

libgsmd is a library with C language API for application programs. Programs using this library can use the phone, e.g. make phone calls, receive incoming calls, register to the network, etc.

== libgsmd-tool ==

libgsmd-tool is a small demo application that can be used to demonstrate the usage of the libgsmd API.

== Usage ==

libgsmd-tool has multiple modes.

=== Usage of shell mode ===

Shell mode provides a simple text-based command interface for making voice calls.

The shell mode can be started using

libgsmd-tool -m shell

It can be used like in the following example:

<pre>
> src/util/libgsmd-tool -m shell
libgsm-tool - (C) 2006 by Harald Welte
This program is Free Software and has ABSOLUTELY NO WARRANTY

?
A Answer incoming call
D Dial outgoing number
H Hangup call
O Antenna Power On
o Antenna Power Off
gos Get Antenna Status
V Vibrator Enable (CVIB=1)
v Vibrator Disable (CVIB=0)
M Modem Power On
m Modem Power Off
r Register to network
R Register to given operator (R=number)
U Unregister from netowrk
P Print current operator
N Print current operator in numeric
L List available operators
Q Read signal quality
nr Query network registration
S Sleep (S[=second], default 5)
T Send DTMF Tone
n Print subscriber numbers
pd PB Delete (pb=index)
pr PB Read (pr=index)
prr PB Read Range (prr=index1,index2)
pf PB Find (pf=indtext)
pw PB Write (pw=index,number,text)
ps PB Support
pm PB Memory
pp PB Set Memory (pp=storage)
sd SMS Delete (sd=index,delflg)
sl SMS List (sl=stat)
sr SMS Read (sr=index)
ss SMS Send (ss=ask_ds,number,text|["text"])
sw SMS Write (sw=stat,number,text)
sm SMS Storage stats
sM SMS Set preferred storage (sM=mem1,mem2,mem3)
sc SMS Show Service Centre
sC SMS Set Service Centre (sC=number)
gvm Get Voicemail number
svm Set Voicemail number(svm=number)
im Get imsi
mf Get manufacturer
ml Get model
rv Get revision
sn Get serial number
cs Get Call status
gp Get PIN status
cbc Get Battery status
Rh Release all held calls (+CHLD=0)
UDUB User Determined User Busy (+CHLD=0)
Ra Release all active calls (+CHLD=1)
Rx Release specific active call x (Rx=x)(+CHLD=1x)
Ha Hold all active calls and accept held or waiting call (+CHLD=2)
Hx Hold all active calls except call x (Hx=x)(+CHLD=2x)
MP Add a held call to the conversation (+CHLD=3)
CFD Disable call forwarding (CFD=reason)
CFE Enable call forwarding (CFE=reason)
CFQ Query the status of call forwarding (CFQ=reason)
CFR Register call forwarding (CFR=reason,number)
CFe Erase a record of call forwarding (CFe=reason)
q Quit

O
# EVENT: PIN request (type=1) Please enter PIN: 6582
r
# EVENT: Netreg searching for network
EVENT: Netreg registered (home network)

D03024033902
# Dial 03024033902
EVENT: Call Progress: UNKNOWN
EVENT: Call Progress: PROCEED
EVENT: Call Progress: SYNC
EVENT: Call Progress: ALERT
H
# Hangup
EVENT: Call Progress: DISCONNECT
EVENT: Call Progress: RELEASE

EVENT: Incoming call type=2!
EVENT: Incoming call clip=`"03024033902"'
EVENT: Incoming call type=2!
A
# Answer
RSTR=`OK'
H
# Hangup
RSTR=`OK'
</pre>

=== Usage of atcmd mode ===

The atcmd mode is a passthrough-mode. Passthrough means that it accepts [[GSM 07.07]] commands, passes them through the daemon to the phone, and returns you the response. this is very useful for debugging.

The atcmd mode can be started using

libgsmd-tool -m atcmd

Usage is like in the following example:

<pre>
> src/util/libgsmd-tool -m atcmd
libgsm-tool - (C) 2006 by Harald Welte
This program is Free Software and has ABSOLUTELY NO WARRANTY

AT+CPAS
STR=`AT+CPAS'
RSTR=`+CPAS: 0'
AT+COPS=?
STR=`AT+COPS=?'
RSTR=`+COPS: (2,"E-Plus","E-Plus","26203"),(3,"o2 - de","o2 - de","26207"),(3,"Vodafone.de","Vodafone","26202"),(3,"T-Mobile D","TMO D","26201")'
</pre>

== Network related functions ==
Operator selection functions were implemented and merged into SVN head[http://lists.openmoko.org/pipermail/gsmd-devel/2007-September/000216.html]:

The new commands in libgsmd-util are as followings:
R - Register to given operator (R=number)
P - Print current operator
L - Detect available operators
Q - Read signal quality

This is implemented by the functions with "_opers_" naming.
== Currently missing ==

(please add items to this list if you're missing more features)

* Phone related functions
** Airplane mode / gsmd stop (this will be done outside gsmd, by using runlevels / upstart)
** Capability to set-up Emergency Calls, even if the device does not hold a SIM card
** obtain manufacturer/model/revision/IMEI
** Ability to notify user if the SIM card is locked (or even automagically unlock it?)

* SMS related features
** send SMS
** receive SMS
** obtain IMSI
** access to SIM-card stored SMS - ''No longer missing - see help''

* SIM related functions
** read phonebook entry - ''No longer missing - see help''
** write phonebook entry - ''No longer missing - see help''

* GPRS related functions
** set up GPRS link, use it via separate DLC of TS07.10 multiplex

* gsmd internal infrastructure
** fine-grained event subscriptions (rather than wildcard-subscribe)
** possibility to specify log-level from command line
** logfile re-opening on SIGUSR1 or SIGHUP (logrotate)
** permission handling
** d-bus interface

== Implementation Thoughts ==

== Testing framework ==

Emulating/mocking the firmware, gsmd and libgsmd can be tested for functionality; on any machine.
See [[User:Kero|Kero's page]] or go directly to [http://chmeee.dyndns.org/om/testing_gsmd.html the (lib)gsmd testing page].

== State tracking ==

gsmd needs to do apropriate state tracking of the underlying GSM hardware. For many of the state transition we only get events from the GSM Modem, but don't have apropriate query commands. Thus, assuming gsmd runs all the time, applications can come and go, but still have an idea about the current state of the modem, even if they missed the initial state transitions.

Also, gsmd state tracking allows us to allow for safer interoperability of multiple applications. If i.e. one applications has just started an outgoing call, gsmd can detect another application who intends to interfere with that and deny access

=== device power state ===

* modem completely off, not responding to AT commands
* modem responding to AT commands, but powered off (CFUN=0)
* modem responding to AT commands, in some power saving mode
* modem responding to AT commands, powered on, fully operational (CFUN=1)

=== Suspend power state ===

It must also configure the modem so that it can on appropriate events wake the system from sleep.

=== network registration state ===

* not registered to any network, not trying to register
* not registred to any network, searching/trying to register
* registered to home network (including cellID)
* registered to roaming network (including cellID)

=== ciphering indication state ===

* ciphering indications not supported by modem
* ciphering indications supported, but disabled in SIM
* ciphering indications supported, ciphering active
* ciphering indications supported, ciphering inactive

=== call state ===

* idle
* busy

Sources of gsmd are kept in [[Openmoko svn]] in src/target/gsm directory.

[[Category:Application Developer]]
[[Category:Implemented]]

Neo FreeRunner Hardware

2008-03-18T20:29:46Z

Drizzt: typo fix

[[OpenMoko]] is a software distribution stack that sits on top of a [[hardware]] platform. The [[Neo FreeRunner]] phone is the second hardware platform to take advantage of OpenMoko. You can find specifications of the hardware by reviewing this introduction page and the pages in the category as shown at the bottom of this page.

{{note|This page is about hardware that is currently in '''design/prototype''' phase, changes are frequent}}

[[Image:Gta02a5 pcba cs.JPG|thumb|400px|display (top) side NOTE: GTA02 A5 PCBA Component Side photo]]
[[Image:Gta02a5 pcba ps.JPG|thumb|400px|component (back) side NOTE: GTA02 A5 PCBA Print Side photo]]
[[Image:GTA02 A5 PCB CS.jpg|thumb|400px|component (back) side NOTE: GTA02 A5 PCB Component Side photo]]
[[Image:GTA02 A5 PCB PS.jpg|thumb|400px|component (back) side NOTE: GTA02 A5 PCB Print Side photo]]

=Summary=
*FIC building a Linux based smart phone with full GPL compatible firmware source code for OPENMOKO, project code named GTA02 (Neo FreeRunner)

Detail hardware component selection could be found in [[Neo FreeRunner GTA02 Hardware]]

=Features=
*Display- Topply o2.8, 480 x 640 pixels, VGA, 200 NIT minimum, resistance type touch

*User Interface Navigation- Touch screen on LCD, 2 control “buttons”, 1 Power button, 1 Aux for 911 emergency call

*Built in 802.11b/g Radio (Atheros chipset AR6001 Flash version)

*Built in Bluetooth 2.0 + EDR (CSR and support PCM audio , BC4 frimware version)

*Built in 2D/3D graphics acceleration chip (S-Media 3362)

*Built in 2x Tri-Axis sensor (ST accelerometer LIS3LV02DL)

*Built in GPS Radio – -130 dBm with internal antenna, -157 dBm tracking on chipset specification , TTFF under 40 seconds with -130 dBm signal strength, and tracking (u-Blox)

*Antenna – Specialized antenna for best in hand hold GPS, GPRS and Wi-Fi/Bluetooth performance are required, -105dBm on receiving, Tx 30dbm+2 on GSM

*External Antennae – MMCX GPS connector

*GPRS Radio –GSM/GPRS radio. A Pre-PTCRB certified module will be preferred

*Linux – Linux kernel 2.6.24 or later OpenMoko kernel

*USB - Client and Host mode switch-able (to be used for software downloading), provide host 5v power

*Power- Normal mode power will be via 1200 mAh battery with built-in coulomb counter, could charge via specialized charger. Internal Lithium Ion or Lithium Polymer battery will keep device in standby mode. Battery life (Approximation/Ideal Target) Standby time 150-200 Hrs (GSM) Talk time (Backlight off) Up to 3-4 hrs(GSM)

*LED- LED indicator under Aux/Power button key

=Hardware Specification=
===Hardware Electrical===

*400/500 MHz Samsung 2442B Processor/SOC (400 minimum)
*Boot code in NAND FLASH or 2MB NOR FLASH (optional design)
*128 MB SDRAM total, 64 MB CPU internal, 64 MB external
*256MB NAND Flash MCP package.

=== Display ===
*Topploy VGA ; 2.8” diagonal, 480 x 640 pixels
*Transmissive display: good readability in high ambient light is essential
*White LED backlight. Required brightness is 200 NIT minimum.
*Resistance type touch panel.

=== WiFi 802.11 b/g transceiver ===
*Must have GPL support source or GPL compatible policy
*TX power at 11 Mbps: 13 dBm minimum
*RX sensitivity at 11 Mbps: -89 dBm desired, -83 dBm minimum
*AP mode desirable, not required
*WEP and WPA supported
*Atheros perferred because it's GPL policy

=== Serial interfaces (UART) ===
*Three serial interfaces are required
*Console
*A-GPS or GPS
*GSM/GPRS

=== Accelerometer ===
* 2x accelerometer required
* Could support interrupt while suspend or power save mode
* 3 axis sensing

=== A-GPS ===
*GPS chipset receiver and antenna
*Sensitivity at Antenna port: -157 dBm tracking on chipset specification
*LNA and SAW filter for maximum interference protection
*Cold start time to first fix: 40 sec typical at -130 dBm, 60 sec max
*Must support GPL for Assist-GPS function with open API
*Industry quality GPS
*Could fit in GTA01 GPS area on the PCB

=== GPS Antenna Performance ===
*Antenna is passive and internal; 15 mm x 15 mm ceramic patch is nominal design
*Antenna LNA and SAW filter are required to meet GPS performance
*15 mm square ground plane (minimum 1 mm ground border around patch) (TBA)
*There will be one external GPS antenna connector (MMCX)
*C/N ratio should higher than 35 on production testing

=== Buttons ===
*Touch screen over LCD is primary data entry mechanism
*Two “hard” buttons: Power button (on side of Neo1973) is a mechanical switch actuated by a plastic pushbutton in a hole in the housing. Aux (911) button on the top of the device, All two of these buttons, when pushed by the operator, are binary inputs (on/off or pressed/not pressed) to the software. The effect of each button is determined by the application software in the device
*Buttons may need to be backlit
*50000 cycles on hardware specification

=== Sound outputs ===
*Speaker in box (need good volume and acoustic behavior innoise environment)
*Audio is monophonic*Max volume: 100 dB at 5 cm to assure good performance in environment.
*Support earphone with mic by jack

=== Power Design Requirements===
*Software based power managment uint perferred
*NXP PCF series perferred
*Need support charge from USB function
*Need support powered by USB function
*Power switch: Neo1973 will have a power switch, for power on/off and suspend
* Power/Aux switch must be backlit
*Switch controls whether device is running or suspended by presses of the switch
*Switch does not shut off the power; it only suspends/resumes the device
*Internal Li-Ion or Li-Polymer battery is included. This battery supplies standby power to the device eliminates the rebooting of the device when local power is again reapplied. Battery is 1200 ma-hr.
*Battery life (Approximation) Ideal/Target Standby time 150-200 Hrs (GSM) Talk time (Backlight off) Up to 4 hrs(GSM)
*Estimated current draw for the entire device when in suspend mode (and ALL peripherals are turned off or set for deep sleep) is <5 mA at 3.6 volts (Li-Ion terminal voltage).
*GSM module deep sleep(alive and keep contact with base station) stage should take less than 8mA
*Battery will reach half capacity (~600 mAh) with 500 charge-discharge cycles. This will occur in less than 2 years of daily service.
*When powered continuously, Neo1973 must suspend (to low power mode) based either on observed low battery voltage condition or a configurable time delay.
*Neo1973 must monitor battery status while suspended and resume automatically if the charger is inserted.
*Primary power connection: 1200mAh battery
*USB charger have ID pin 47.5k pull down for OPENMOKO identification
*Indicators: an LED indicator visible from the side of the unit will illuminate when charging or have missing incoming call

=== GSM/GPRS ===
*850/1800/1900 and 900/1800/1900 MHz bands must be supported
*Design should allow for multi-band version (850/900 MHz)
*Module based GPRS transceiver could meeting PTCRB and appropriate FCC certifications. It preferred that the module be pre-certified with PTCRB or OTA test
*FCC/CE certification required for GSM/GPRS part

=== GSM-GPRS Antenna Performance ===
*-105 dBm receiving on each channel (GSM/PCS)
*30+2 dBm transmission on GSM channel

=== Wi-Fi Modules ===
*Must support GPL driver
*Atheros AR6k preferred
*Flash version required

=== Wi-Fi Antenna Performance ===
*The Wi-Fi antenna with TX 13 to 15 dBm
*RX -89 to -83 dBm @802.11b 11Mbps or an equivalent performance antenna

=== Bluetooth ===
*CSR BC4 or later solutions

=== USB ===
*Neo1973 GTA02 will have USB, client/host. Using USB 1.1
*Could provide USB host 5v power
*Could be powered by USB

=== Microphone ===
1 microphone is in the device

=== Firmware Image ===
*Using Linux 2.6.24 or later
*Could support boot from NAND or Boot from NOR
*Shipping image should come with basic phone function
*Could do full firmware upgrade by USB cable

=== PSN ===
*Device will have a PSN (product serial number) printed on the product label and machine readable in system NAND memory

=== IMEI ===
*Production phase should have IMEI code written

= Package Specification =
*Weight: ~150 grams with battery.
*4 in 1 laser pen passed RoHs and safty regulation for laser equipment safty
*1x 512MB microSD Card (SanDisk/Transcend)
*1x USB cable Standard A to mini-B connector
*1x 1200mAh smart/gauge battery
*Quick start guide
*5v USB power cord w/100-240 switchable power plug
*Safety card, warranty card
*Package could pass 1m to 1.5m drop test
*AC USB charger,100v-240v, Passed UL and all required safety regulation
*Must pass FCC/CE certification
*Must pass NCC certification for Taiwan import regulation
*RoHS Compatible
*WEEE Report required

= Life Cycle Specification =

=== Product Life ===
The product is designed to last a minimum of 2 years.

=== Operating Temperature ===
*Target operating range is –10°C to +60°C

=== Storage Temperature ===
*-15 deg C to +70 deg C

=== ESD ===
The device can withstand a 4.0kV contact discharge and 8.0kV air

=== Drop test ===
Should pass 1m direct drop to concrete ground or 1.5m on slide with carpet

[[Category:Hardware ]]
[[Category:Supported Phone| ]]
[[Category:GTA02 Hardware]]

= GTA02 Hardware Component Selection =

== Physical Dimensions ==
* 120.7 x 62 x 18.5 mm (4.75 x 2.44 x 0.728 inch)
* 110 +/- 5 g (4 ounces) without battery 

== Main components ==
=== Processor ===
The main Processor (CPU) of the Neo1973 GTA02 is a [[Samsung S3C2442B B54]] (running at 400 MHz)

* Product Homepage: [http://www.samsung.com/global/business/semiconductor/productInfo.do?fmly_id=229&partnum=SC32442 Samsung SC32442B]
* User Manual: FIXME
* Core: ARM920T
* Instruction Set: ARMv4 (Android ''currently'' requires ARMv5)
* Built-in 64MB SDRAM
* Built-in 256 MB NAND
* Could run at 500Mhz
* GPIO Assignments: https://svn.openmoko.org/trunk/doc/hardware/GTA02v4/gpio.txt 
* Evaluation board: [http://www.meritech.co.kr/products/product_view.php?num=52 S3C2442 EVB]

=== Power Management ===
A NXP PCF50633 04 N3 is used for [[Neo1973_Power_Management|power management]].

* NXP PMU index: [http://www.nxp.com/products/power_management/pmu/index.html NXP PMU index page] 
* Product Datasheet: [http://people.openmoko.org/tony_tu/GTA02/datasheet/PMU/PCF50633DS_02.pdf NXP PCF50633 Product Data Sheet] 
* Product User manual: [http://people.openmoko.org/tony_tu/GTA02/datasheet/PMU/PCF50633UM_6.pdf NXP PCF50633 User Manual] 
**Special thanks NXP provide full user manual and support openness for all developer
**Datasheet/User manual usage [http://lists.openmoko.org/pipermail/community/2008-March/013898.html was legally authorized by NXP]
* Connected to: S3C2442 via I2C, client address is 0x08. 
* Driver Source: https://svn.openmoko.org/trunk/src/target/kernel/patches/pcf50633.patch 

=== Flash ===
==== NAND Flash ====
256MB integrated Samsung NAND flash inside the 2442 multi-chip package, attached to the S3C2442 NAND controller

* Product Homepage: [http://www.samsung.com/global/business/semiconductor/productInfo.do?fmly_id=229&partnum=SC32442 S3C2442]
* Data Sheet: S3C2442 B54 comes with 256 MB NAND MCP package
* Connected to: S3C2442 NAND controller 

==== NOR Flash ====

16MBit ST M58WR016KB706E NOR flash for 'unbrickable emergency boot' feature.

* Product Homepage: [http://www.st.com/stonline/products/families/memories/fl_nor_mob/index.htm ST Mobile Flash NOR/Mobile Terminal]
* Data Sheet: [http://www.st.com/stonline/products/literature/ds/13023/m58wr032qb.pdf M58WR016]
* Connected to: S3C2442 NAND controller 

=== SDRAM ===
128MB SDRAM (64MB inside 2442 MCP, 1x Samsung K4M51323PC) attached to S3C2442 SDRAM controller
* Product Homepage: [http://www.samsung.com/global/business/semiconductor/productInfo.do?fmly_id=136&partnum=K4M51323PC Samsung K4M51323PC]
* Data Sheet: [http://www.samsung.com/global/system/business/semiconductor/product/2007/6/11/MobileSDRAM/MobileSDRSDRAM/512Mbit/K4M51323PC/ds_k4m51323pc.pdf Samsung K4M51323PC]
* Connected to: S3C2442 

== GSM/GPRS ==
The [[GSM]] (including GPRS) modem is Texas Instruments Calypso based.

* Connected to: S3C2442 UART1 (full-uart, RxD, TxD, CTS, RTS), /dev/ttySAC0 in userspace
* PM Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/gta01-power_control.patch
* Accessible GSM/GPRS antenna jack (if battery cover is removed) 

=== CALYPSO ASIC digital baseband ===
Unfortunately we cannot provide many details on the GSM chipset due to very tight [http://en.wikipedia.org/wiki/Non-disclosure_agreement NDA]s. However, this is not neccessarily required, since it interfaces using a standard UART serial line with the S3C2442. On that interface, [http://www.3gpp.org/ftp/Specs/archive/07_series/07.05/ GSM 07.05], [http://www.3gpp.org/ftp/Specs/archive/07_series/07.10/ GSM 07.10] and other standardized protocols are used.

*Calypso D751992AZHH 
*The firmware within GTA02 should be moko6 or later (internal code name)

=== TI TWL3025BZGMR analog baseband ===
*Product Homepage: [http://focus.ti.com/general/docs/wtbu/wtbuproductcontent.tsp?templateId=6123&navigationId=12295&contentId=4703 TWL3014] 

=== TI TRF6151 (GSM/PCS) RF Transceiver ===
*Product Homepage: [http://focus.ti.com/general/docs/wtbu/wtbuproductcontent.tsp?templateId=6123&navigationId=12296&contentId=4701 TRF6151] 
GPRS Class12/CS4 

== AGPS ==
u-blox ANTARIS 4 chip
* Connected to: S3C2442 UART2, /dev/ttySAC1 in userspace
* Driver: none needed, talks standard NMEA
* u-blox Antaris 4 Protocol [http://www.u-blox.com/customersupport/antaris_doc.html Protocol download page]
* ATR0635 Datasheet: [http://www.u-blox.com/products/Data_Sheets/ATR0630_35_SglChip_Data_Sheet(GPS.G4-X-06009).pdf u-blox ATR0635] 

== Accelerometers ==
Two ST LIS302DL
* Homepage: http://www.st.com/stonline/products/literature/ds/12726/lis302dl.htm
* Datasheet: http://www.st.com/stonline/products/literature/ds/12726.pdf
* Connected to: S3C2442 via SPI interface
* S3C2442 SPI EINT interrupt inputs 

== Graphics/3D Acceleration ==

Smedia Glamo 3362.
* Homepage: http://www.smediatech.com/product3362.htm
* Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/smedia-glamo.patch
* Data sheet: FIXME
* Connected to: S3C2442 Address/Data bus 

=== microSD ===
The GTA02 has one microSD aka Transflash slot. Using the Glamo 3362 MMC/SD controller

*It should support SDHC, and 4GB card has been tested. Anyone with 8GB card? MicroSD slot is [[Disassembling_Neo1973#Opening_back_cover|under battery]].
* Connected to: Glamo 3362 MMC/SD controller
* Driver: Check svn for the SMedia driver with SD implementation
* [[Supported microSD cards]]
* Specifications: [http://www.sdcard.org/about/memory_card/pls/ SD Simplified Specification], [http://www.mmca.org/compliance/buy_spec/AN_MMCA050419.pdf MMC (partial)], [http://www.sandisk.com/Assets/File/OEM/Manuals/manual-rs-mmcv1.0.pdf MMC (product manual)]
* SANDISK 128 MB/512 MB and some 4G SDHC card been verified could work on GTA02 

== LCD Module (LCM) ==
Toppoly (tpo) 2.8" diagonal (1.7" x 2.27" - 43mm x 58mm) 480x640 TD028TTEC1 module, using a Toshiba JBT6K74 TFT
LCD Driver Chipset. 
* Homepage: [http://www.tpo.biz/ENG/business-eng/Activer-Matrix-VGA.htm Activer-Matrix-VGA.htm]
* Specification: FIXME
* Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/gta01-jbt6k74.patch
* Backlight Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/gta01-backlight.patch
* Connected to: Glamo3362 LCM interface and Glamo3362 SPI Interface 

==== Touch Screen ====
* Connected to: S3C2442 TS controller
* Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/s3c2410_touchscreen.patch

== Bluetooth Module==
Delta DFBM-CS320 Class2 Module, using CSR BlueCore4

* Data Sheet: [http://www.delta.com.tw/product/cp/vco/BT/download/pdf/CS/2.DFBM-CS320.pdf 2.DFBM-CS320.pdf]
* CSR Data Sheet: [http://www.csrsupport.com/download/2302/CS-101564-DSP10%20BlueCore4-ROM%20Product%20Data%20Sheet.pdf CS-101564-DSP10 BlueCore4-ROM Product Data Sheet.pdf]
* Driver: Stock Linux Kernel BlueZ
* Connected to: S3C2442 USB Host controller (OHCI)
* PM Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/gta01-power_control.patch 

=== Bluetooth Audio ===
This one is wired via PCM bus from the CSR Bluetooth chip to the Wolfson codec. 

== WiFi Module==

Accton (WLAN 802.11b/g SiP-M WM3236AQ(Flash Ver:2.0 Atheros AR6001GZ)
* Connected to: S3C2442 SDIO Host controller 
* Datasheet: [http://www.accton.com/products/Datasheet/WM3236A.AQ.pdf Accton 3236AQ datasheet] 
* Driver: http://svn.openmoko.org/developers/sameo/patches/ 

== Vibrator ==
* Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/gta01-vibrator.patch
* Connected to: S3C2442 GPIO

== USB Host ==
The USB Host controller is inside the S3C2442
* Driver: Stock Linux kernel ohci_hcd
* USB version 1.1
* Supply USB 5v in Host mode using usb power switch AAT1275IRN-5.0-T1
** http://www.analogictech.com/products/digitalfiles/AAT1275.pdf
* A net EN_USBHOST is controlled by PMU GPIO "GPO", this one signal when asserted (high)
** enables generation of 5V for external device using a charge pump
** enables connection of 15K pulldowns to D+ and D- to allow device insertion and removal detection for host mode
** DISABLES the path for USB power to charge the battery

It should also be possible to use host mode with externally-provided power. This will allow the FreeRunner to be connected to a USB device and be powered and charging the battery if present at the same time.

* Connect 0V, d+, d-, +5 to your USB device
* Connect a 15k ohm resistor between d+ and ground
* Connect a 15k ohm resistor between d- and ground
* Connect 0V, +5 to your >1A power source
** If your power source was not the OpenMoko 1A charger, additionally connect a 47K ohm 5% resistor between the ID pin and ground to pretend to be the 1A charger.

In addition you need to make sure EN_USBHOST signal that enables the physical Host mode power generation and disables the USB -> PMU charging path is deasserted. This may be taken care of automatically shortly by detection of the 48K resistor on a USB insertion leading to forcing EN_USBHOST deasserted. The charge pump that generates the 5V in host mode doesn't seem to mind getting external 5V given to it, but the real issue is that the battery will not be charged at all if we leave EN_USBHOST asserted since one of its jobs is to stop that happening.

== USB Device ==
The USB Device controller is inside the S3C2442
* Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/s3c2410_udc.patch
* Please see [[USB Product IDs]] on information about which Vendor/Product IDs we use
* 1200mAh lithium battery charges when connected to powered host.
* Mini-AB connector similar to [http://www.cypressindustries.com/shoponline/proddetail.asp?prod=CCMUSBAB-32005-700&cat=34 this one].

== I2C Devices ==
The I2C is a simple communication standard intended to move small amounts of data a few inches between chips.
Please see [[I2C | Neo I2C Devices]] for more information & a list of devices & the addresses currently in use & documented for the Neo1973. 

== Audio ==
See also: [[Neo1973 Audio Subsystem]]

=== Wolfson Codec ===
There's a [[WM8753]] Wolfson Microelectronics CODEC (This is not a 'smart' codec that can interpret MP3/... it is a simple dumb 'sound card'.
* Product Homepage: http://www.wolfsonmicro.com/products/WM8753/
* Data Sheet: [http://www.wolfsonmicro.com/uploads/documents/en/WM8753.pdf WM8753.pdf]
* Connected to: S3C2442 IIS interface (PCM data), S3C2442 I2C (Control)
* Driver: https://svn.openmoko.org/trunk/src/target/kernel/patches/asoc.patch

=== Mono Amplifier ===
There's a National Semiconductor [[LM4853]] Mono Amplifier at the analog audio output of the WM8753

* Product Homepage: [http://www.national.com/pf/LM/LM4853.html LM4853.html]
* Data Sheet: [http://www.national.com/ds.cgi/LM/LM4853.pdf LM4853.pdf]
* Connects to: S3C2442 I2C (Control)

=== Analog wired Headset ===
There's a four-ring 2.5mm stereo jack which provides connectivity to old-fashioned wired headsets.

The headsets used by Motorola smartphones (A780,A1200, ...) and the V-360 have a compatible configuration.

=== Buttons ===
The Neo1973 GTA02 features two buttons:
* [[Neo1973 Power Button|The Power Button]]
* [[Neo1973 AUX Button|The "Aux" button]]

== Case ==
The new case for the FreeRunner is all black, as seen on the front page on the wiki.
Source: Mickey on IRC
=Accessory=

== Stylus ==

Using 4 in 1 laser pen
*Vendor: [http://www.quarton.com/laser_pen.html Quarton XPII]
*GTA02 standard setup comes with [http://www.quarton.com.tw/laser_pen_infiniter_xp_2.html QUARTON XPII 4 in 1 laser pen]

== Battery ==
The [[Neo FreeRunner (GTA02) Battery]] is mechanically and electrically compatible with the [[Neo1973 GTA01 Battery]], as well as limited compatibility with a Nokia BL6C battery.
According to [http://lists.openmoko.org/pipermail/community/2007-February/003758.html this] post on the mailinglist.
[http://wiki.openmoko.org/index.php?title=Image:Neo1973-with-BL5C-battery.png Photo] of the battery inside the Neo1973.

* GTA02 using the smart battery based on TI bq27000 chipset
* SANYO UF653450S 1200mAh cell. 
* Battery schematics: [http://people.openmoko.org/tony_tu/GTA02/hardware/GTA02/CT-GTA02.pdf GTA02 Smart Battery Schematics]

== microSD Card ==

GTA02 should comes with one of following microSD card

* [http://www.transcendusa.com/ Transcend] 512MB microSD card
* [http://www.sandisk.com/ SanDisk] 512MB microSD card 

== Charger ==

AKII Technology Charger

*Model: [http://www.ak2.com.tw/pd_main.asp?sg_id=11 A10P1-05MP]
*Input: 100-240v~ /0.3A
*Output: +5v up to 2.0A
*Add 47.5k 1% resistor between ID pin and ground for openmoko charger identification 

= History =

== GTA02v1 ==
First generation of prototypes that was given to internal OpenMoko software developers. Total 30 pcs fabricated.

*It is working just fine, but still based on 2440, with external NAND/SDRAM and no NOR flash
*Using the PCF50633 05 N3 due to 04 N3 not available, re-work power for basic schematics verification
*Using GTA01 SIM socket
*Add external debug port
*Still using Global locate A-GPS

== GTA02v2 ==
Second generation of prototypes, Total 50 pcs run at Taipei SMT factory MOUNT

*Ideal is have 256 MB NAND on Samsung package, Due to chip availability Start using S3C2442 B43
*Using correct PMU PCF50633 04 N3
*Change new SIM socket
*Change to u-blox A-GPS
*Change LCM power from 3.3v to 1.8v
*USB power switch layout/pin assignment mistake, could not verify USB host supply 5v function
*GPS function verified ok with good sensitivity

== GTA02v3 ==
Production verification version, 2007/10/11 28 pcs fabricate at FIC SuZhou

*Still using S3C2442 B43 for hardware verification
*Using control pilot run to verify S3C2442 B54 chips 

== GTA02v4 ==
Mass production release candidate version 1

2 weeks after v3 gerber out, release the v4 gerber, and 2007/10/20 20 pcs fabricate at FIC SuZhou

*Change LCM power from 1.8v to 3.3v for display stability issue
*fabricate another 200 pcs for yield rate/production verification
*fabricate 50 pcs with S3C2442 B43 (128 MB NAND) for quality comparsion
*USB host power chip have some output voltage stability issues with Vb/Vcc comes from different power source, need layout change to fix the issue
*Battery Coulomb design not working on A4

== GTA02v5 ==
Mass production candicate version 2/Mass production version

* First batch fabricate 2008/1/14 at FIC SuZhou
* Mass production A5 trial run start from 2008 March, including some resistor/capacitor change compare with inital 100 pcs prototypes A5, and prototypes for GTA02 developers was tracked in the [[Prototypes| Prototypes Page]]
* Coulomb counter issue fixed
* USB host power switch fixed
* Need add capacitor for PMU Vbat input for stability issue, this could be done by direct SMT or hand rework
* Need rework (still using SMT in production) add capacitor for PMU Vbat input for PMU stability issue.
* Need manual rework GSM IR UART path a 100k pull down for better GSM deep sleep
* ATAG_REVISION: 0350

== GTA02v6 ==
Mass production candicate version 3/Mass production version 

A6 will be fine tune version of A5, only minor schematic change for better product quality and version control. Capacitor and resistor change A6 also on mass production A5 

*First 100 pcs might start from end of 2008 March
*Add capacitor space for Vbat, reduce the SMT effort
*Add GSM IR resistor for better GSM deep sleep
*Reserve 3 GPIO for hardware version control

= Debug Board =

== Debug Board Connector definition ==

This is the connector used to connect the [[Debug Board]] and possibly other hardware.

Connections are:
* 39 - GND
* 38 - STDI
* 37 - _RESET
* 36 - STMS
* 35 - STCK
* 34 - STDO
* 33 - GSM_EN
* 29 - _STRST
* 19 - X_I2C_SCL (H-TP4703)
* 18 - X_I2C_SDA (H-TP4704)
* 17 - SPI_CLK0
* 16 - SPI_MOSI0
* 15 - SPI-MISO0
* 14 - SS0
* 13 - EINT3 (H-TP4705)
* 3 - CONSOLE_TXD (H-TP4701)
* 2 - CONSOLE_RXD (H-TP4702)

Information from [http://people.openmoko.org/roh/Debugport_GTA01bv4.png].

= Distinguishing hardware revisions =
== Inside the [[Bootloader]] ==
Every hardware revision has its own u-boot image type. Thus, the bootloader has the revision hard-coded.
The hardware revision is passed on to the kernel via the ATAG mechanism (ATAG_REVISION)

== Inside the [[Kernel]] ==
The kernel receives the ATAG_REVISION during bootup, and saves its contents in the "system_rev" global variable.

== From Userspace ==
The kernel exports the system_rev variable in /proc/cpuinfo as "Revision :" line.

= Certification =

== FCC ==
*For US Import
** 850/1800/1900 Band, FCC ID: EUNGTA02
** 900/1800/1900 Band, FCC ID: EUNGTA02E
** [http://people.openmoko.org/tony_tu/GTA02/certificate/EUNGTA02_850_1800_1900/ FCC test report(GTA02)]
** [http://people.openmoko.org/tony_tu/GTA02/certificate/EUNGTA02E_900_1800_1900/ FCC test report(GTA02E)]

== NCC ==
*For Taiwan Import
**NCC certification number: CCAF08DG0080T0
**[http://people.openmoko.org/tony_tu/GTA02/certificate/NCC NCC test report]

{{Languages|Neo1973 GTA02 Hardware}}

[[Category:Hardware Support]]
[[Category:GTA02 Hardware]]

Hardware:Neo1973:Alternate Cases:Camera

2007-08-27T13:47:57Z

Drizzt:

Alternate case for the Neo1973, with rear-mounted camera module.

==Concept==

==Rendered images==

==3D model==

==Materials==

==Processes==
Stereolithography

==Components==
Camera module with protection 
At least 2 Mpx.

==Interest==
Leave your nickname here if you are interested in having one made. This is not an order form, but is intended to gauge interest before effort is expended designing the case. 

#[[User:Bootlessjam|Bootlessjam]]
#[[User:Diatessaron|Diatessaron]]
#[[User:Thomas Mathiesen|Thomas Mathiesen]]
#[[User:Gizmhail|Gizmhail]]
#[[User:Fisticuffs|Fisticuffs]]
#[[User:Daniel|Daniel]]
#[[User:Deedend|Deedend]]
#[[User:Aztlek|Aztlek]]
#[[User:Mikesd|Mikesd]]
#[[User:Filippo|Filippo]]
#[[User:Beady|beady]]
#[[User:Wvrn|wvrn]]
#[[User:yvanxxx|yvanxxx]]
#[[User:amarov|amarov]]
#[[User:cedel|cedel]]
#[[User:gwylim|gwylim]]
#[[User:Massa|Humberto Massa]]
#[[User:hhf423|hhf423]]
#[[User:Fursund|Fursund]]
#[[User:Bubbi|Bubbi]]
#[[User:Drizzt|Drizzt]]
[[Category:Neo1973_alternate_cases]]