Openmoko - User contributions [en]

Ringtones

2008-12-14T21:16:25Z

Narmo: /* Updating howtos */

We need freely distributable/licensed ringtones to ship as default ringtones with the phone.

== License ==

Ringtones should be in OGG/Vorbis format (or converted to it), and licensed in a way that allows free redistribution, such as creative commons by, by-nd, by-sa, gpl, public domain, etc ().

Unless a different license type is required for Openmoko all files are released under the CreativeCommons Attribution-ShareAlike 3.0 license.

== Tools ==

All tunes have been composed in Rosegarden (an OpenSource MIDI sequencer available at www.rosegardenmusic.com), rendered on a Yamaha Motif ES tone generator and recorded using Audacity or Ardour.

If you would like to modify the tunes, please keep in mind that rendering the .rg files on a different tone generator will most likely produce very different (maybe better :-P) results. MIDI files are available on request, or can be created using Rosegarden's export function.

== File types ==

*.rg - music "source" files in Rosegarden's native format
*.wav - Rendered music in uncompressed Wave format
*.ogg, .mp3 - Wave files compressed with Ogg Vorbis/LAME

== bugzilla.openmoko.org related bug ==
More information at [http://bugzilla.openmoko.org/cgi-bin/bugzilla//show_bug.cgi?id=199 Bugzilla #199]

== svn.openmoko.org ringtones ==

Here you can listen the current ringtones and sounds made by Marek "Wansti":
http://svn.openmoko.org/trunk/src/target/OM-2007.2/artwork/sounds/

== Monophonic ==
The GTA02 release of the [[Neo1973 Hardware | Neo1973]] will only have ONE speaker, making it mono. This might be worthwhile to remember when creating the ringtones.

== Themes ==
The default ringtones need to be part of a [[Themes|theme]]. The different tones for calls/messages should have a unified feel to it.

== Comunity ringtones and sounds wishlist ==
There are some ringtones proposals from the comunity here: [[Wish List - Openmoko Ringtones and Sounds]].
See also {{ticket|2080}} for the package at http://212.83.231.34/artwork_sounds_20081024_extra.tar.gz
and /src/target/OM-2007.2/artwork/sounds/ from version control

== Updating howtos ==

For ASU, look around for qtopia packages related to sound profiles in the repository.

'''Tom Yates wrote:'''

The stock ringtone is ''/opt/Qtopia/etc/SystemRingTones/phonering.wav.'' It's a 44.1kHz stereo WAV file, 16-bit.

I decided I wanted a traditional old BT phone, and I found an audio clip of one on the web. It was an 8-bit 16kHz mono clip, called 706_ring.wav. It sounded awful when I moved it into place on the 'phone; very distorted and hissy. I re-codec'ed it on my desktop, using

mplayer 706_ring.wav -ao pcm -srate 44100 -af-add volume=-20

which created a file audiodump.wav, having the right sampling frequency (-srate 44100) and being slightly quieter (volume=-20 being the drop in dB) Being quieter, the distortion wasn't as bad and so it didn't make me jump out of my skin when the 'phone rang. I put this into place as openmoko:''/opt/Qtopia/etc/SystemRingTones/phonering.wav'' (saving the old file first) and now I have my custom ringtone.

Reference: http://www.teaparty.net/technotes/openmoko-2.html#Custom-ringtone

For FSO, see the [[FSO ringtones]] page.

== SID ringtones ==

There are many websites where you can download original c64 sid music files.
* [http://hvsc.c64.org. The High Voltage SID Collection] has over 30.000 sid files
* [http://www.transbyte.org/SID/HVSC_Top100.html The top 100]

Recommendations: theme from R-Type, IK+ (International Karate Plus), Maniac Mansion, Robocop, Bubble bobble.

== TODO LIST ==

Source: http://svn.openmoko.org/trunk/src/target/OM-2007.2/artwork/sounds/TODO

Feel free to add your own comments or requests here.

Changes:

-There Is No Phone and Ring'n'Roll are too silent compared to the
others. The ending of Ring'n'Roll needs more treble since the low
frequencies are hardly audible on the small speaker.
-The transition parts in Squirrels and Supertux don't work well;
they're too silent so that it sounds as if the phone has stopped
ringing if it's carried in a pocket or lying around at a distance.
-Notify sounds should be shorter and less intrusive. Maybe reducing
the volume will already help.

Additions:

-Startup will have a voice saying "Welcome to Openmoko" mixed into it.
-Themes of matching tones for sms, notify, error, ringtone, etc.
-More sounds. :-)

[[Category:Add-on data]]

Gtkaddpoi

2008-12-04T23:10:39Z

Narmo:

[[Image:Gtkaddpoi 01.jpg|thumb|Window for search address]]

[[Image:Gtkaddpoi 02.jpg|thumb|Window for delete POI]]

[[Image:Gtkaddpoi preview.png|thumb|Window with preview of POI with zoom button]]

==Introduction==
gtkaddpoi is a simple gtk interface for search an address and add as POI on TangoGPS.
It's use Yahoo Maps API for found coordinate from an address and put this POI on TangoGPS database.

==Installation==
You can download ipk fils from following link

http://projects.openmoko.org/frs/download.php/490/gtkaddpoi_0.5_all.opk

and then:

opkg install gtkaddpoi_0.5_all.opk

or directly:

opkg install http://projects.openmoko.org/frs/download.php/490/gtkaddpoi_0.5_all.opk

Or you can use repository http://minucci.net/file/opkg/ . For add repository follow this command:

cd /etc/opkg
wget http://minucci.net/file/gecco-feed.conf

and then:

opkg update
opkg install gtkaddpoi

[[Category:GPS Applications]]

Main Page/ru

2008-12-03T08:44:53Z

Narmo: Added news about Android source for Freerunner from Koolu

__NOTOC__
{{Languages|Main_Page}}
 
<DIV ALIGN=center><big>'''Openmoko™ Открытый. Мобильный. Свободный.'''</big> </DIV>
 
[http://www.linuxphone.ru Портал русскоязычных пользователей]

__NOTOC__
__NOEDITSECTION__ [[Image:Freerunner02.gif|thumb|150px|right|Neo FreeRunners]]

==Введение в Openmoko==
[[Image:OpenmokoFramework08.png|250px|left|Программный стек Openmoko|thumb]]
Openmoko™ - рожден как проект с [http://ru.wikipedia.org/wiki/%D0%9E%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE%D0%B5_%D0%BE%D0%B1%D0%B5%D1%81%D0%BF%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5 Открытым Исходным Кодом] под [[License| лицензиями GPL и LGPL]], представляющий открытую программную архитектуру для мобильных платформ. Openmoko на данный момент продает смартфон [[Neo FreeRunner]] для продвинутых пользователей и начинает компанию по разработке программного обеспечения под него.

[[NeoSoftwareStack|Архитектура Openmoko]] включает в себя [[Host-based development with Xoo and Xephyr|X сервер]] и позволяет пользователям и разработчикам превратить аппаратную платформу мобильных устройств в уникальные продукты. Наша лицензия дает свободу пользователям и разработчикам от "iron to the eyeballs," свободу в поверхностной настройке устройства или радикальном его изменении; сменить фоновый рисунок или пересобрать всю систему! Она дает свободу, например, превратить телефон в медицинское устройство, или устройство продаж, или просто свободно устанавливать ваши программы. Для полной свободы программного обеспечения для наших устройств, мы также опубликовали схему устройства в формате CAD под лицензией Creative Commons. Дав свободу программному обеспечению под лицензией GPL, мы позволили сообществу разработчиков FOSS "сделать ее новой". Освободив схемы устройства в файлах [http://downloads.openmoko.org/CAD/ CAD], мы предоставляем промышленным дизайнерам и инженерам эту же возможность. И на LinuxWorld 2008, мы предоставили [http://downloads.openmoko.org/schematics/ принципиальные схемы].

<div style="clear:both"> </div>

<table class="wikitable" cellspacing="4" cellpadding="6" width="100%" style="color:white">
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Новости и события</td>
<td width="50%">Новости Openmoko?</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
* 02/12: [http://www.koolu.com Koolu.com] выпустила [http://git.koolu.org/ исходный код Android] для Freerunner! ([http://koolu.com/Press-Release/ Пресс-релиз])
* 01/12: [[Openmoko:Usb light/ru | USB-фонарик]]
* 24/11: [http://www.linuxphone.ru/2008/11/koolu-android-for-freerunner/ Koolu выпустит порт Android на Neo FreeRunner в декабре]
* 9/10: [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* 6/10: [[Community_Updates/October_3rd%2C_2008/ru|Community update]]
* 2/10: Nokia выпустила [http://qtextended.org/ Qt Extended 4.4.1] ([http://qtextended.org/modules/mydownloads/visit.php?lid=86 image], [http://qtextended.org/modules/mydownloads/visit.php?lid=85 SDK])
* 27/9: Вышел релиз [[FDOM]]
* 19/9: точка релиза [[Om_2008.9_Update|Om 2008.9]]
* 17/9: [[17th September, 2008 - Activity since launch|Community update]] - Activity since launch
* 2/9: Trolltech [http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=83 опубликовала] Qtopia 4.3.3-snapshot.
* 28/8: Trolltech [http://n2.nabble.com/qtopia-4.3.2-release-tp789148p789148.html опубликовала] Qtopia 4.3.2.
* 26/8: Openmoko [http://lists.openmoko.org/pipermail/community/2008-August/027997.html updates] [[Om 2008.8]] дистрибутив.
 
* [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* [[News Archive|(news archive)]]
</td>
<td>
===О Openmoko===
* [[Introduction/ru| Введение]]
* [[Why Openmoko| Почему Openmoko]]
* [[Neo FreeRunner|Neo FreeRunner phone]]
* [[Supported Hardware]]
* [[FAQ| ЧаВо]]

===Старт с Openmoko===
* [[Getting Openmoko/ru|Getting Openmoko]]
* [http://www.openmoko.com Openmoko Inc.]

</td>
</tr>
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Для пользователей</td>
<td width="50%">Для разработчиков</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
===C чего начать===
* [[Getting Started with your Neo FreeRunner/ru | Neo FreeRunner getting started guide]]
* [[Applications]]

===Дистрибутивы===
* [[Distributions|Features comparison table]]
* [[Om 2008.8|Om 2008.8 (ASU)]] - [[Om 2007.2|Om 2007.2 (old stable)]]
* [[OpenmokoFramework|FSO]] - [[Qtopia_on_FreeRunner|Qtopia]] - [[Debian|Debian]] - [[Gentoo|Gentoo]]

===Общение===
* [[Mailing List Duplicates| Mailing List Duplicates]]
* [[Discussion_Forums| Форум]]
* [[Community repository]]
* [[Development resources | Ресурсы для разработчиков]]
</td>
<td>
===Разработка приложений===
* [[Openmoko developer guide| Руководство разработчика ]]
* [[Toolchain|Средства разработки]]

* [[Python|Введение в Python]]
* [http://projects.openmoko.org/ Projects hosted in our GForge]
* [[OpenmokoFramework|Openmoko dbus-based service level framework]]

===Интеграция и дистрибутивы===
* [[OpenEmbedded|The OpenEmbedded distribution building framework]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Менеджер пакетов Opkg]]

===Эмуляция===
* [[Openmoko under QEMU| Openmoko в QEMU]]
</td>
</tr>
</table>

==Продукция Openmoko==

Первый продукт Openmoko - Neo1973, продавался исключительно через интернет-магазин Openmoko. Продажи закончились в начале февраля 2008 года.

С 26 июня 2008 года Openmoko поставляет Neo FreeRunner (GTA02) - второе поколение Neo. Если вы заинтересованны в покупке Neo FreeRunner, добавьте своё имя в Лист Заинтересованных в Покупке. Также посмотрите групповые покупки на [[GroupSales|Групповых Продажах]] с дополнительными скидками и услугами.

==Присоединяйтесь к развитию Openmoko==

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | Руководство разработчика
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Тестирование / Эмуляция и участие в проектах
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Разработчику ===
* [[Toolchain|Использование инструментов разработчика]]
* VMware
* [[Python|Введение в python]]
* [[Openmoko_under_QEMU|Openmoko через QEMU]]

===Системная интеграция и настройка===
* [[OpenEmbedded|OE - Платформа построения приложений]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Opkg]]
===Низкоуровневая / системная разработка===
* [[u-boot]] - Загрузчик используемый нами, включая документацию для его модификации
* [[kernel]] - Ядро Linux используемое нами, включая документацию для его модификации
* [[gsmd]] - GSM демон управления GSM Модемом
* [[agpsd]] - AGPS (Assisted GPS) демон

|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Тестирование===
*[[Test Cases|Пройденные тесты]]
 ※ [[:Category: Test | Узнать больше о Тестировании]]

===Эмуляция===
*[[Getting Openmoko working on host with Xephyr|Эмуляция Openmoko на ПК с использованием Xephyr]]
*[[Test_Openmoko Emulation with chroot image|Эмуляция Openmoko с готовым образом корневой файловой системы]]
===Публикация вашего проекта===
*[[Community Repository|Опубликовать Ваш Проект]]
|}

==Сообщество Openmoko==
Каждый может присоединиться к проекту Openmoko и сделать свой вклад в разработку открытых продуктов. Присоединяйтесь к нам и сотрудничайте в рамках любого [[Development resources | проекта]], в том числе и Энциклопедии по Openmoko. См. страницу помощи по редактированию информации или внесении/добавлении изменений в энциклопедии.

Вы можете начать с [[introduction|вводной]] страницы , фотографий, видео и Оффициальной Страницы Openmoko Wiki. Как всегда, используйте [[FAQ | Часто Задаваемые Вопросы]] (ЧАВО), [http://lists.openmoko.org/mailman/listinfo/| списки рассылки] и [[Discussion_Forums| Форумы]] для получения помощи.

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | В Новостях
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Сообщество и События
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
==В Новостях==
*[[Getting Started with your Neo FreeRunner|Neo FreeRunner - с чего начать]]
*[[ASU Feature Plan|План реализации АОП(Апрельское обновление ПО)]]
*[[Community Repository|Публикация вашего проекта]]
*[[GroupSales|Групповые продажи]]
*[[WhyOpenmoko|Почему Openmoko лучше: Сравнительный Взгляд]]
==Ежедневные Сборки==
*Здесь вы всегда можете загрузить последнюю сборку.
** Для FreeRunner [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
** Для Neo 1973 [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
*Обзоры ежденевных сборок [[Snapshot_review|здесь]], рекомендуемое ядро и корневой образ с обзором будут всегда доступны [http://downloads.openmoko.org/releases/ здесь].
Заметим, что рекомендованные сборки, не всегда являются последними, но они самые стабильные, надежные и функциональные.
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |

== Обновления Сообщества==
Просмотр текущего статуса [[Community_Updates|Обновлений Сообщества]]

 ※[[:Category:Community| Узнать больше о Сообществе...]]

==Обзор Вики==
*Для получения обзора Openmoko Вики, смотрите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].
==События==
*[[Summer of Code 2008]]
*[[Openmoko Education/zh tw]]
*[[Events:FOSDEM 2008]]
*[[OpenLab]]

 ※[[:Category:Event| Узнать больше о Событиях...]]

|}

==Openmoko Wiki - с чего начать==
Энциклопедия Openmoko открытая. Каждый может присоединиться. Вы сможете найти любую информацию, в том числе: аппаратную и программную документацию, списки ошибок, новости сообщества Openmoko и другое. Присоединяйтесь к энциклопедии, редактируйте ее, наполняйте материалами и помогайте другим. Для полного обзора Openmoko Wiki, пожалуйста посетите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].

* Пожалуйста прочтите наше [[Openmoko Wiki Editing Guidelines|Руководство по Редактированию Openmoko Wiki]]
* [http://www.mediawiki.org/wiki/Help:Configuration_settings Настройка параметров списка]
* [http://meta.wikimedia.org/wiki/Help:Wikitext_reference Руководство по MediaWiki и Wikitext]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki ЧАВО]

Main Page/ru

2008-12-02T20:10:44Z

Narmo:

__NOTOC__
{{Languages|Main_Page}}
 
<DIV ALIGN=center><big>'''Openmoko™ Открытый. Мобильный. Свободный.'''</big> </DIV>
 
[http://www.linuxphone.ru Портал русскоязычных пользователей]

__NOTOC__
__NOEDITSECTION__ [[Image:Freerunner02.gif|thumb|150px|right|Neo FreeRunners]]

==Введение в Openmoko==
[[Image:OpenmokoFramework08.png|250px|left|Программный стек Openmoko|thumb]]
Openmoko™ - рожден как проект с [http://ru.wikipedia.org/wiki/%D0%9E%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE%D0%B5_%D0%BE%D0%B1%D0%B5%D1%81%D0%BF%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5 Открытым Исходным Кодом] под [[License| лицензиями GPL и LGPL]], представляющий открытую программную архитектуру для мобильных платформ. Openmoko на данный момент продает смартфон [[Neo FreeRunner]] для продвинутых пользователей и начинает компанию по разработке программного обеспечения под него.

[[NeoSoftwareStack|Архитектура Openmoko]] включает в себя [[Host-based development with Xoo and Xephyr|X сервер]] и позволяет пользователям и разработчикам превратить аппаратную платформу мобильных устройств в уникальные продукты. Наша лицензия дает свободу пользователям и разработчикам от "iron to the eyeballs," свободу в поверхностной настройке устройства или радикальном его изменении; сменить фоновый рисунок или пересобрать всю систему! Она дает свободу, например, превратить телефон в медицинское устройство, или устройство продаж, или просто свободно устанавливать ваши программы. Для полной свободы программного обеспечения для наших устройств, мы также опубликовали схему устройства в формате CAD под лицензией Creative Commons. Дав свободу программному обеспечению под лицензией GPL, мы позволили сообществу разработчиков FOSS "сделать ее новой". Освободив схемы устройства в файлах [http://downloads.openmoko.org/CAD/ CAD], мы предоставляем промышленным дизайнерам и инженерам эту же возможность. И на LinuxWorld 2008, мы предоставили [http://downloads.openmoko.org/schematics/ принципиальные схемы].

<div style="clear:both"> </div>

<table class="wikitable" cellspacing="4" cellpadding="6" width="100%" style="color:white">
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Новости и события</td>
<td width="50%">Новости Openmoko?</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
* 01/12: [[Openmoko:Usb light/ru | USB-фонарик]]
* 24/11: [http://www.linuxphone.ru/2008/11/koolu-android-for-freerunner/ Koolu выпустит порт Android на Neo FreeRunner в декабре]
* 9/10: [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* 6/10: [[Community_Updates/October_3rd%2C_2008/ru|Community update]]
* 2/10: Nokia выпустила [http://qtextended.org/ Qt Extended 4.4.1] ([http://qtextended.org/modules/mydownloads/visit.php?lid=86 image], [http://qtextended.org/modules/mydownloads/visit.php?lid=85 SDK])
* 27/9: Вышел релиз [[FDOM]]
* 19/9: точка релиза [[Om_2008.9_Update|Om 2008.9]]
* 17/9: [[17th September, 2008 - Activity since launch|Community update]] - Activity since launch
* 2/9: Trolltech [http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=83 опубликовала] Qtopia 4.3.3-snapshot.
* 28/8: Trolltech [http://n2.nabble.com/qtopia-4.3.2-release-tp789148p789148.html опубликовала] Qtopia 4.3.2.
* 26/8: Openmoko [http://lists.openmoko.org/pipermail/community/2008-August/027997.html updates] [[Om 2008.8]] дистрибутив.
 
* [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* [[News Archive|(news archive)]]
</td>
<td>
===О Openmoko===
* [[Introduction/ru| Введение]]
* [[Why Openmoko| Почему Openmoko]]
* [[Neo FreeRunner|Neo FreeRunner phone]]
* [[Supported Hardware]]
* [[FAQ| ЧаВо]]

===Старт с Openmoko===
* [[Getting Openmoko/ru|Getting Openmoko]]
* [http://www.openmoko.com Openmoko Inc.]

</td>
</tr>
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Для пользователей</td>
<td width="50%">Для разработчиков</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
===C чего начать===
* [[Getting Started with your Neo FreeRunner/ru | Neo FreeRunner getting started guide]]
* [[Applications]]

===Дистрибутивы===
* [[Distributions|Features comparison table]]
* [[Om 2008.8|Om 2008.8 (ASU)]] - [[Om 2007.2|Om 2007.2 (old stable)]]
* [[OpenmokoFramework|FSO]] - [[Qtopia_on_FreeRunner|Qtopia]] - [[Debian|Debian]] - [[Gentoo|Gentoo]]

===Общение===
* [[Mailing List Duplicates| Mailing List Duplicates]]
* [[Discussion_Forums| Форум]]
* [[Community repository]]
* [[Development resources | Ресурсы для разработчиков]]
</td>
<td>
===Разработка приложений===
* [[Openmoko developer guide| Руководство разработчика ]]
* [[Toolchain|Средства разработки]]

* [[Python|Введение в Python]]
* [http://projects.openmoko.org/ Projects hosted in our GForge]
* [[OpenmokoFramework|Openmoko dbus-based service level framework]]

===Интеграция и дистрибутивы===
* [[OpenEmbedded|The OpenEmbedded distribution building framework]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Менеджер пакетов Opkg]]

===Эмуляция===
* [[Openmoko under QEMU| Openmoko в QEMU]]
</td>
</tr>
</table>

==Продукция Openmoko==

Первый продукт Openmoko - Neo1973, продавался исключительно через интернет-магазин Openmoko. Продажи закончились в начале февраля 2008 года.

С 26 июня 2008 года Openmoko поставляет Neo FreeRunner (GTA02) - второе поколение Neo. Если вы заинтересованны в покупке Neo FreeRunner, добавьте своё имя в Лист Заинтересованных в Покупке. Также посмотрите групповые покупки на [[GroupSales|Групповых Продажах]] с дополнительными скидками и услугами.

==Присоединяйтесь к развитию Openmoko==

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | Руководство разработчика
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Тестирование / Эмуляция и участие в проектах
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Разработчику ===
* [[Toolchain|Использование инструментов разработчика]]
* VMware
* [[Python|Введение в python]]
* [[Openmoko_under_QEMU|Openmoko через QEMU]]

===Системная интеграция и настройка===
* [[OpenEmbedded|OE - Платформа построения приложений]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Opkg]]
===Низкоуровневая / системная разработка===
* [[u-boot]] - Загрузчик используемый нами, включая документацию для его модификации
* [[kernel]] - Ядро Linux используемое нами, включая документацию для его модификации
* [[gsmd]] - GSM демон управления GSM Модемом
* [[agpsd]] - AGPS (Assisted GPS) демон

|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Тестирование===
*[[Test Cases|Пройденные тесты]]
 ※ [[:Category: Test | Узнать больше о Тестировании]]

===Эмуляция===
*[[Getting Openmoko working on host with Xephyr|Эмуляция Openmoko на ПК с использованием Xephyr]]
*[[Test_Openmoko Emulation with chroot image|Эмуляция Openmoko с готовым образом корневой файловой системы]]
===Публикация вашего проекта===
*[[Community Repository|Опубликовать Ваш Проект]]
|}

==Сообщество Openmoko==
Каждый может присоединиться к проекту Openmoko и сделать свой вклад в разработку открытых продуктов. Присоединяйтесь к нам и сотрудничайте в рамках любого [[Development resources | проекта]], в том числе и Энциклопедии по Openmoko. См. страницу помощи по редактированию информации или внесении/добавлении изменений в энциклопедии.

Вы можете начать с [[introduction|вводной]] страницы , фотографий, видео и Оффициальной Страницы Openmoko Wiki. Как всегда, используйте [[FAQ | Часто Задаваемые Вопросы]] (ЧАВО), [http://lists.openmoko.org/mailman/listinfo/| списки рассылки] и [[Discussion_Forums| Форумы]] для получения помощи.

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | В Новостях
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Сообщество и События
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
==В Новостях==
*[[Getting Started with your Neo FreeRunner|Neo FreeRunner - с чего начать]]
*[[ASU Feature Plan|План реализации АОП(Апрельское обновление ПО)]]
*[[Community Repository|Публикация вашего проекта]]
*[[GroupSales|Групповые продажи]]
*[[WhyOpenmoko|Почему Openmoko лучше: Сравнительный Взгляд]]
==Ежедневные Сборки==
*Здесь вы всегда можете загрузить последнюю сборку.
** Для FreeRunner [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
** Для Neo 1973 [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
*Обзоры ежденевных сборок [[Snapshot_review|здесь]], рекомендуемое ядро и корневой образ с обзором будут всегда доступны [http://downloads.openmoko.org/releases/ здесь].
Заметим, что рекомендованные сборки, не всегда являются последними, но они самые стабильные, надежные и функциональные.
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |

== Обновления Сообщества==
Просмотр текущего статуса [[Community_Updates|Обновлений Сообщества]]

 ※[[:Category:Community| Узнать больше о Сообществе...]]

==Обзор Вики==
*Для получения обзора Openmoko Вики, смотрите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].
==События==
*[[Summer of Code 2008]]
*[[Openmoko Education/zh tw]]
*[[Events:FOSDEM 2008]]
*[[OpenLab]]

 ※[[:Category:Event| Узнать больше о Событиях...]]

|}

==Openmoko Wiki - с чего начать==
Энциклопедия Openmoko открытая. Каждый может присоединиться. Вы сможете найти любую информацию, в том числе: аппаратную и программную документацию, списки ошибок, новости сообщества Openmoko и другое. Присоединяйтесь к энциклопедии, редактируйте ее, наполняйте материалами и помогайте другим. Для полного обзора Openmoko Wiki, пожалуйста посетите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].

* Пожалуйста прочтите наше [[Openmoko Wiki Editing Guidelines|Руководство по Редактированию Openmoko Wiki]]
* [http://www.mediawiki.org/wiki/Help:Configuration_settings Настройка параметров списка]
* [http://meta.wikimedia.org/wiki/Help:Wikitext_reference Руководство по MediaWiki и Wikitext]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki ЧАВО]

Main Page/ru

2008-12-02T20:10:21Z

Narmo: Новость про фонарик через USB (русский вариант)

__NOTOC__
{{Languages|Main_Page}}
 
<DIV ALIGN=center><big>'''Openmoko™ Открытый. Мобильный. Свободный.'''</big> </DIV>
 
[http://www.linuxphone.ru Портал русскоязычных пользователей]

__NOTOC__
__NOEDITSECTION__ [[Image:Freerunner02.gif|thumb|150px|right|Neo FreeRunners]]

==Введение в Openmoko==
[[Image:OpenmokoFramework08.png|250px|left|Программный стек Openmoko|thumb]]
Openmoko™ - рожден как проект с [http://ru.wikipedia.org/wiki/%D0%9E%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE%D0%B5_%D0%BE%D0%B1%D0%B5%D1%81%D0%BF%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5 Открытым Исходным Кодом] под [[License| лицензиями GPL и LGPL]], представляющий открытую программную архитектуру для мобильных платформ. Openmoko на данный момент продает смартфон [[Neo FreeRunner]] для продвинутых пользователей и начинает компанию по разработке программного обеспечения под него.

[[NeoSoftwareStack|Архитектура Openmoko]] включает в себя [[Host-based development with Xoo and Xephyr|X сервер]] и позволяет пользователям и разработчикам превратить аппаратную платформу мобильных устройств в уникальные продукты. Наша лицензия дает свободу пользователям и разработчикам от "iron to the eyeballs," свободу в поверхностной настройке устройства или радикальном его изменении; сменить фоновый рисунок или пересобрать всю систему! Она дает свободу, например, превратить телефон в медицинское устройство, или устройство продаж, или просто свободно устанавливать ваши программы. Для полной свободы программного обеспечения для наших устройств, мы также опубликовали схему устройства в формате CAD под лицензией Creative Commons. Дав свободу программному обеспечению под лицензией GPL, мы позволили сообществу разработчиков FOSS "сделать ее новой". Освободив схемы устройства в файлах [http://downloads.openmoko.org/CAD/ CAD], мы предоставляем промышленным дизайнерам и инженерам эту же возможность. И на LinuxWorld 2008, мы предоставили [http://downloads.openmoko.org/schematics/ принципиальные схемы].

<div style="clear:both"> </div>

<table class="wikitable" cellspacing="4" cellpadding="6" width="100%" style="color:white">
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Новости и события</td>
<td width="50%">Новости Openmoko?</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
* 01/12 [[Openmoko:Usb light/ru | USB-фонарик]]
* 24/11 * [http://www.linuxphone.ru/2008/11/koolu-android-for-freerunner/ Koolu выпустит порт Android на Neo FreeRunner в декабре]
* 9/10: [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* 6/10: [[Community_Updates/October_3rd%2C_2008/ru|Community update]]
* 2/10: Nokia выпустила [http://qtextended.org/ Qt Extended 4.4.1] ([http://qtextended.org/modules/mydownloads/visit.php?lid=86 image], [http://qtextended.org/modules/mydownloads/visit.php?lid=85 SDK])
* 27/9: Вышел релиз [[FDOM]]
* 19/9: точка релиза [[Om_2008.9_Update|Om 2008.9]]
* 17/9: [[17th September, 2008 - Activity since launch|Community update]] - Activity since launch
* 2/9: Trolltech [http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=83 опубликовала] Qtopia 4.3.3-snapshot.
* 28/8: Trolltech [http://n2.nabble.com/qtopia-4.3.2-release-tp789148p789148.html опубликовала] Qtopia 4.3.2.
* 26/8: Openmoko [http://lists.openmoko.org/pipermail/community/2008-August/027997.html updates] [[Om 2008.8]] дистрибутив.
 
* [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* [[News Archive|(news archive)]]
</td>
<td>
===О Openmoko===
* [[Introduction/ru| Введение]]
* [[Why Openmoko| Почему Openmoko]]
* [[Neo FreeRunner|Neo FreeRunner phone]]
* [[Supported Hardware]]
* [[FAQ| ЧаВо]]

===Старт с Openmoko===
* [[Getting Openmoko/ru|Getting Openmoko]]
* [http://www.openmoko.com Openmoko Inc.]

</td>
</tr>
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Для пользователей</td>
<td width="50%">Для разработчиков</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
===C чего начать===
* [[Getting Started with your Neo FreeRunner/ru | Neo FreeRunner getting started guide]]
* [[Applications]]

===Дистрибутивы===
* [[Distributions|Features comparison table]]
* [[Om 2008.8|Om 2008.8 (ASU)]] - [[Om 2007.2|Om 2007.2 (old stable)]]
* [[OpenmokoFramework|FSO]] - [[Qtopia_on_FreeRunner|Qtopia]] - [[Debian|Debian]] - [[Gentoo|Gentoo]]

===Общение===
* [[Mailing List Duplicates| Mailing List Duplicates]]
* [[Discussion_Forums| Форум]]
* [[Community repository]]
* [[Development resources | Ресурсы для разработчиков]]
</td>
<td>
===Разработка приложений===
* [[Openmoko developer guide| Руководство разработчика ]]
* [[Toolchain|Средства разработки]]

* [[Python|Введение в Python]]
* [http://projects.openmoko.org/ Projects hosted in our GForge]
* [[OpenmokoFramework|Openmoko dbus-based service level framework]]

===Интеграция и дистрибутивы===
* [[OpenEmbedded|The OpenEmbedded distribution building framework]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Менеджер пакетов Opkg]]

===Эмуляция===
* [[Openmoko under QEMU| Openmoko в QEMU]]
</td>
</tr>
</table>

==Продукция Openmoko==

Первый продукт Openmoko - Neo1973, продавался исключительно через интернет-магазин Openmoko. Продажи закончились в начале февраля 2008 года.

С 26 июня 2008 года Openmoko поставляет Neo FreeRunner (GTA02) - второе поколение Neo. Если вы заинтересованны в покупке Neo FreeRunner, добавьте своё имя в Лист Заинтересованных в Покупке. Также посмотрите групповые покупки на [[GroupSales|Групповых Продажах]] с дополнительными скидками и услугами.

==Присоединяйтесь к развитию Openmoko==

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | Руководство разработчика
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Тестирование / Эмуляция и участие в проектах
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Разработчику ===
* [[Toolchain|Использование инструментов разработчика]]
* VMware
* [[Python|Введение в python]]
* [[Openmoko_under_QEMU|Openmoko через QEMU]]

===Системная интеграция и настройка===
* [[OpenEmbedded|OE - Платформа построения приложений]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Opkg]]
===Низкоуровневая / системная разработка===
* [[u-boot]] - Загрузчик используемый нами, включая документацию для его модификации
* [[kernel]] - Ядро Linux используемое нами, включая документацию для его модификации
* [[gsmd]] - GSM демон управления GSM Модемом
* [[agpsd]] - AGPS (Assisted GPS) демон

|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Тестирование===
*[[Test Cases|Пройденные тесты]]
 ※ [[:Category: Test | Узнать больше о Тестировании]]

===Эмуляция===
*[[Getting Openmoko working on host with Xephyr|Эмуляция Openmoko на ПК с использованием Xephyr]]
*[[Test_Openmoko Emulation with chroot image|Эмуляция Openmoko с готовым образом корневой файловой системы]]
===Публикация вашего проекта===
*[[Community Repository|Опубликовать Ваш Проект]]
|}

==Сообщество Openmoko==
Каждый может присоединиться к проекту Openmoko и сделать свой вклад в разработку открытых продуктов. Присоединяйтесь к нам и сотрудничайте в рамках любого [[Development resources | проекта]], в том числе и Энциклопедии по Openmoko. См. страницу помощи по редактированию информации или внесении/добавлении изменений в энциклопедии.

Вы можете начать с [[introduction|вводной]] страницы , фотографий, видео и Оффициальной Страницы Openmoko Wiki. Как всегда, используйте [[FAQ | Часто Задаваемые Вопросы]] (ЧАВО), [http://lists.openmoko.org/mailman/listinfo/| списки рассылки] и [[Discussion_Forums| Форумы]] для получения помощи.

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | В Новостях
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Сообщество и События
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
==В Новостях==
*[[Getting Started with your Neo FreeRunner|Neo FreeRunner - с чего начать]]
*[[ASU Feature Plan|План реализации АОП(Апрельское обновление ПО)]]
*[[Community Repository|Публикация вашего проекта]]
*[[GroupSales|Групповые продажи]]
*[[WhyOpenmoko|Почему Openmoko лучше: Сравнительный Взгляд]]
==Ежедневные Сборки==
*Здесь вы всегда можете загрузить последнюю сборку.
** Для FreeRunner [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
** Для Neo 1973 [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
*Обзоры ежденевных сборок [[Snapshot_review|здесь]], рекомендуемое ядро и корневой образ с обзором будут всегда доступны [http://downloads.openmoko.org/releases/ здесь].
Заметим, что рекомендованные сборки, не всегда являются последними, но они самые стабильные, надежные и функциональные.
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |

== Обновления Сообщества==
Просмотр текущего статуса [[Community_Updates|Обновлений Сообщества]]

 ※[[:Category:Community| Узнать больше о Сообществе...]]

==Обзор Вики==
*Для получения обзора Openmoko Вики, смотрите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].
==События==
*[[Summer of Code 2008]]
*[[Openmoko Education/zh tw]]
*[[Events:FOSDEM 2008]]
*[[OpenLab]]

 ※[[:Category:Event| Узнать больше о Событиях...]]

|}

==Openmoko Wiki - с чего начать==
Энциклопедия Openmoko открытая. Каждый может присоединиться. Вы сможете найти любую информацию, в том числе: аппаратную и программную документацию, списки ошибок, новости сообщества Openmoko и другое. Присоединяйтесь к энциклопедии, редактируйте ее, наполняйте материалами и помогайте другим. Для полного обзора Openmoko Wiki, пожалуйста посетите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].

* Пожалуйста прочтите наше [[Openmoko Wiki Editing Guidelines|Руководство по Редактированию Openmoko Wiki]]
* [http://www.mediawiki.org/wiki/Help:Configuration_settings Настройка параметров списка]
* [http://meta.wikimedia.org/wiki/Help:Wikitext_reference Руководство по MediaWiki и Wikitext]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki ЧАВО]

Openmoko:Usb light/ru

2008-12-02T20:05:48Z

Narmo: Translated page to Russian

{{Languages|Openmoko:Usb_light}}

= USB-фонарик =

В моём старом телефоне, Sony Ericsson W800i, была одна любимая мной вещь - фонарик (основной функцией которого была подсветка во время фотосъёмки встроенной камерой; но его также можно было использовать и как обычный фонарик). Поэтому я подумал о подобном решении для моего Freerunner, результатом чего стала эта статья.

== Идея ==

* два светодиода
* два резистора
* один разъём MiniUSB (папа)
* немного припоя
* немного горячего клея...

...и в вашем Freerunner появится фонарик :D

= Инструкции =

== Компоненты ==

* 2 белых светодиода повышенной яркости ⇒ [http://www.reichelt.de/?;ACTION=3;LA=4;GROUP=A5332;GROUPID=3019;ARTICLE=26496;START=0;SORT=artnr;OFFSET=16;SID=28SA7h56wQARwAACk@Bmsa794de820d10a89112a12211e64ae497 LED 3-2000 WS в каталоге Reichelt] (немецкий поставщик электронных компонентов)
* 2 резистора по 75 Ом 1/4 Вт ⇒ [http://www.reichelt.de/?;ACTION=3;LA=4;GROUP=B1112;GROUPID=3063;ARTICLE=1466;START=0;SORT=artnr;OFFSET=16;SID=28SA7h56wQARwAACk@Bmsa794de820d10a89112a12211e64ae497 1/4W 75 Ом по каталогу Reichelt]
* 1 кабель USB mini B ⇒ [http://www.reichelt.de/?;ACTION=3;LA=4;GROUP=C6992;GROUPID=3348;ARTICLE=45361;START=0;SORT=artnr;OFFSET=16;SID=28SA7h56wQARwAACk@Bmsa794de820d10a89112a12211e64ae497 AK 673-A USB mini B / USB коннектор по каталогу Reichelt]

= Схемы =
[[Image:Fetch.png|align|center]]

[http://ru.wikipedia.org/wiki/USB#.D0.9A.D0.B0.D0.B1.D0.B5.D0.BB.D0.B8_.D0.B8_.D1.80.D0.B0.D0.B7.D1.8A.D1.91.D0.BC.D1.8B_USB_1.0_.D0.B8_2.0 Статья на Википедии о USB]

= Подготовка =

Отрежьте кабель USB, снимите изоляцию и уберите ножки 2, 3, 4 (для уменьшения риска короткого замыкания). Теперь соедините компоненты так, как показано на схеме выше. ВНИМАНИЕ ⇒ существует риск замыкания схемы о металлические части разъёма. Проверьте работоспособность схемы без металлических частей.

{|
|-
[[Image:Fetch1.png|align|center|400px|thumb|'''* без металлических частей разъёма''']]
|-
[[Image:Fetch2.png|align|center|400px|thumb|'''* с металлическими частями разъёма''']]
|-
[[Image:Fetch3.png|align|center|400px|thumb|'''* с горячим клеем (я знаю, что смотрится это не очень симпатично, но оно работает, оно прочное, и без коротких замыканий''' ;)]]
|-

= Программное обеспечение =

Когда я искал хорошее решение для запуска host-mode на Freerunner, я нашёл эту запись в блоге

* http://blogs.thehumanjourney.net/finds/entry/usb_host_mode_the_button

Джозеф Ривз модифицировал свой пакет usbmode-button после нескольких моих предложений, и вот его статья в блоге о версии 0.2

* http://blogs.thehumanjourney.net/finds/entry/usb_mode_button_0_2

Спасибо Джозефу Ривзу :D

Вы можете включать и выключать host-mode одним нажатием на иконку.
Оно работает!

== Изображения ==

[[Image:Fetch4.jpeg|200px|align|center]]
[[Image:Fetch6.jpeg|200px|align|center]]

== Видео ==

* Freerunner при дневном свете ⇒ http://www.youtube.com/watch?v=iK5w-OHSm9g
* Freerunner ночью ⇒ http://www.youtube.com/watch?v=f2H4QZq2xxE

* Моя версия ⇒ http://www.youtube.com/watch?v=-qMmwOoLiZ8 :)

= Улучшения? Идеи! =

Это работает, но выглядит не очень симпатично. Возможно, у вас появятся идеи по этому поводу. Пишите мне :D
[[Category:Hardware ideas]]

Openmoko:Usb light

2008-12-02T19:50:17Z

Narmo:

{{Languages|Openmoko:Usb_light}}

=USB-Light=
One thing that i like on my older phone, a Sony Ericsson W800i, is the light (camera light, but you can use it without the camera). So i thought about a solution for my Freerunner and the result is the following article. At least ⇒ At own's risk ;)

==Idea==

* Two leds
* Two resitors
* a miniusb B male connector
* a bit solder
* and a bit hot glue

and you have a light for your Freerunner :D

=Instructions=
==Components==

* 2 x white LED ultra bright ⇒ [http://www.reichelt.de/?;ACTION=3;LA=4;GROUP=A5332;GROUPID=3019;ARTICLE=26496;START=0;SORT=artnr;OFFSET=16;SID=28SA7h56wQARwAACk@Bmsa794de820d10a89112a12211e64ae497 LED 3-2000 WS on Reichelt] (german distributor for electrical components)
* 2 x 75 Ohm resistors 1/4 W ⇒ [http://www.reichelt.de/?;ACTION=3;LA=4;GROUP=B1112;GROUPID=3063;ARTICLE=1466;START=0;SORT=artnr;OFFSET=16;SID=28SA7h56wQARwAACk@Bmsa794de820d10a89112a12211e64ae497 1/4W 75 Ohm resistor on Reichelt]
* 1 x USB mini B cable ⇒ [http://www.reichelt.de/?;ACTION=3;LA=4;GROUP=C6992;GROUPID=3348;ARTICLE=45361;START=0;SORT=artnr;OFFSET=16;SID=28SA7h56wQARwAACk@Bmsa794de820d10a89112a12211e64ae497 AK 673-A USB mini B to normal usb connector on Reichelt]

=Schematic=
[[Image:Fetch.png|align|center]]
German Wikipedia-article about the universal serial bus ⇒ http://de.wikipedia.org/wiki/Universal_Serial_Bus#Farbkodierung_und_Pinouts

=Preparation=
Cut the usb cable and seperate the rubber of the usbmini connector and remove the pins 2,3,4 (a lower risk of a short circuit). Now solder the components according to the schematic. WARNING ⇒ risk of a short circuit on the metal parts of the connector. Check the circuit without the metal part, if it works.

{|
|-
[[Image:Fetch1.png|align|center|400px|thumb|'''* without the metal part of the connector''']]
|-
[[Image:Fetch2.png|align|center|400px|thumb|'''* with the metal part of the connector''']]
|-
[[Image:Fetch3.png|align|center|400px|thumb|'''* with hot glue (i know its not very beautiful, but it works, it's robust and i have no short circuit''' ;)]]
|-

=Software=
When i searched for a good solution to activate the host-mode of the freerunner i found this blog entry

* http://blogs.thehumanjourney.net/finds/entry/usb_host_mode_the_button

Joseph Reeves modified his usbmode-button package after a few suggestions by me and here is his new blog-article with Version 0.2

* http://blogs.thehumanjourney.net/finds/entry/usb_mode_button_0_2

Thanks Joseph Reeves :D

You can toggle the host-mode on and off with a click on the icon.
It works!

==Images==

[[Image:Fetch4.jpeg|200px|align|center]]
[[Image:Fetch6.jpeg|200px|align|center]]

==Videos==

* Freerunner in broad daylight ⇒ http://www.youtube.com/watch?v=iK5w-OHSm9g
* Freerunner at night ⇒ http://www.youtube.com/watch?v=f2H4QZq2xxE

* My version ⇒ http://www.youtube.com/watch?v=-qMmwOoLiZ8 :)

=Improvements? Ideas!=

It works but it's not very beautiful, perhaps you have any ideas. Mail me :D
[[Category:Hardware ideas]]

Distributions

2008-12-02T18:39:54Z

Narmo: /* Toolkits / Runtimes */

{{Languages|Distributions}}

{| class="wikitable" style="float:right;width:200px;background-color:#FF6600;text-align:center;border-collapse:collapse;font-weight:bold"
|Distributions
|-
! style='background-color:#333333;color:#FFFFFF'|
<div align=left>
* Openmoko (official)
** [[Om 2008.9 Update]]
** [[Om 2008.8]]
** [[Om 2007.2]]
** [[OpenmokoFramework|FSO]]
* Community
** [[SHR]]
** [[FDOM]]
* Other
** [[Qtopia]]
** [[Debian]]
** [[Gentoo]]
** [[Android]]
</div>
|-
|}
Openmoko distributions are designed to run on various mobile devices, with the primary aim of supporting Openmoko Inc.'s [[GTA01:Neo 1973|Neo 1973]] and [[Neo FreeRunner]] phones. They are GNU/Linux distributions -- complete operating systems with more or less user applications. You can install any of them on your phone or even have a multiboot system with two distributions installed.

While the Openmoko distributions will run on [[Supported devices|other mobile devices]] too, some other software distributions will also run on the Openmoko Inc. phones (see below).

For downloads see [[Download]], for installation instructions see [[Flashing the Neo FreeRunner]].

== About distributions ==

=== Which distribution should I use ?===
* Most new users find [[FDOM]] the most comprehensive and functional distribution.
* If you want "just a phone", try [[Qtopia]].
* If you want to develop anything that last, your platform is [[FSO]] (and the choice between EFL, GTK+, Qt, Java, Python or whatever is open).
* [[SHR]], [[Debian]], [[Gentoo]] and [[Android]] are for people who do not need to ask which distribution they should use.
* Tracking the "base image" by updating daily from testing/unstable is a different game either.

===Status as of November 9th, 2008 ===
* The phones ship with [[Om 2007.2]]. It is not supported by Openmoko Inc. anymore. But community developpers continue to work on its phone stack in the [[SHR]] project.
* The branch currently supported by Openmoko Inc. is [[Om 2008.9 Update]], which is a minor upgrade of [[Om 2008.8]] (formerly named ASU). Based on that, the community made the [[FDOM]] distribution by adding lots of fixes and applications to it.
* The trunk tip is a "base image" on which the next major release should be based. This next release can be previewed by installing milestones of the [[FSO]] - Free Smartphone.Org project. The [[Debian]] packaging team also track that branch.
* The FreeRunner is a reference platform for TrollTech's Qt Extended (formerly [[Qtopia]]) distribution.
* The Android port is work-in-progress.

=== Warnings ===

* Stable in the FreeRunner world does not mean the same thing as stable in Debian world.
* Most distributions use the same bootloader, kernel, drivers and hardware. Therefore, the same low level bugs are commonly found in all distributions. The latest and greatest software usually has most bug fixes, plus a whole set of new fresh bugs.
* Most of these distributions also have package repositories. It is a BAD idea to feed from another distribution's repository.
* Upgrade path between these distributions are mostly not tested, thus updating by changing the feeds will most likely end in broken packages or even an unbootable system. It is advisable to reflash the whole filesystem with [[dfu-util]] to switch between the different distributions, with the reminder that a dual-boot setup (e.g. via sdcard or NFS) can be used.

== Openmoko Inc. driven release targets ==

These different 'release targets' are built out of different branches of the [[OpenEmbedded]] metadistribution source tree.

=== Om 2008.9 ===

The Om 2008.9 Update is the first point release after the initial Om 2008.8 release. Openmoko recommends that all existing installations of Om 2008.8 should be updated to that version. Quality-wise, we are still far from the goal, but this version includes general stability enhancing operating system improvements and a new splash screen. No applications were added or removed. Users with basic telephony needs will find it tolerable as an everyday phone.

{{Main|Om 2008.9 Update}}

=== Om 2008.8 ===

Om 2008.8 was released on August 8, 2008, to replace 2007.2. Prior to that, its codename was ASU (April/August Software Update). This is still the name of the branch in the version control system. This distribution integrates the [http://trolltech.com/products/qtopia Qtopia] phone stack with a set of new Openmoko applications based on the Enlightenment Foundation Libraries. Qtopia being a more mature product than the GNOME Mobile stack, the standard phone applications (dialer, contacts, calculator, calendar) work better than in 2007.2. The Qtopia used in 2008.8 was ported to run on X11, contrary to standard Qtopia which uses the framebuffer. This allows non-Qt applications to safely share the screen with Qt applications. This is a .0 release, many unresolved issues remain in the lower layers (kernel power management, sound, wifi drivers...).

{{Main|Om2008.8}}

=== Om 2007.2 ===

[[Om 2007.2]] is the base-system which is installed on FreeRunner when it leaves the factory. The interface was totally finger-oriented, optimized for 285ppi, and very orange. It used the GTK+ stack, which is part of the [http://www.gnome.org/mobile/ GNOME Mobile] platform. This distribution is now considered obsolete and not being worked on by Openmoko Inc or by OpenedHand. There is a community effort (see [[SHR]]) to port the GTK based telephony applications to the future middleware from [[FSO]].

{{Main|Om 2007.2}}

=== FSO Milestone IV ===

FSO is an abbreviation for FreeSmartphone.Org. Openmoko is working on a stable system services back-end. Focus is on stable highlevel services that you can access from whatever language or UI that supports [http://dbus.freesmartphone.org/ dbus]. The framework will be used in forthcoming Openmoko distributions. FSO is all about middleware, but if one stacks a bootloader+kernel under it and telephony applications on top, one gets a functional distribution. These are made available as FSO-image milestones. Openmoko Framework Image milestone IV was released on November 11th, 2008 and named 'Homework'. People report that despite its infancy, the phone server part in FSO is already more solid than anywhere else. The kernel under it is a Linux 2.6.24 with modules packaged separately. The telephony application on top of it is Zhone. This is a basic Python dialer/homescreen designed as scaffolding to test the FSO functionalities (even if Zhone is pretty, code path coverage is more critical to it than user-friendliness).

{{Main|FSO}}

== Openmoko Community driven release targets ==

=== SHR - Stable Hybrid Release ===

SHR is a community driven distribution. It contains some basic GTK+ based applications which make use of the FSO. There currently is a EFL (with elementary) dialer, messages and contacts application programmed in C. As of November 9th, 2008, there is no stable release of this distribution yet, as the SHR team doesn't feel it to be good enough. You can find images though on the [http://shr.bearstech.com/shr-testing SHR buildhost].

{{Main|Stable Hybrid Release}}

=== FDOM (FAT and Dirty Openmoko) ===

[[FDOM]] is a distribution based on Openmoko's currently supported image, updated with many ready-to-use applications and with fixes posted in the mailing lists. A combination of applications (everything goes) and fixes to demonstrate 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.

{{Main|FDOM}}

== Non-Openmoko distributions ==

These are not Openmoko (and OE) based distributions. These are alternatives you can run on your Openmoko phones.

=== Qt Extended ===

The Qt Extended distribution was formerly known as Qtopia up to version 4.3.x included. It comes from [http://www.trolltech.com Trolltech], a Nokia company, the makers of the Qt cross-platform application framework. This distribution aims to provide a ready-to use image for Openmoko devices. It features a noticeably robust telephony stack. Recent release 4.4.2 also sports a webkit-based web browser and Gtalk support.

{{Main|Qtopia / Qt Extended on FreeRunner}}

=== Debian ===

Debian is "the universal operating system". It comes with thousands and thousands of packages (most of them designed for desktops or servers so far). So in the words of Joachim "nomeata" Breitner from the [http://wiki.debian.org/Teams/DebianFSO pkg-fso] team, this is not really a distribution in the Openmoko sense of the word, but rather a different underlying system for Openmoko distributions. At the moment, we ship the software from the FSO stack, but hopefully we’ll also have, for example, the Stable Hybrid Release software in our archive. So for now, Debian is a different way of installing FSO, which takes more space and provides more programs :-)

{{Main|Debian}}

=== Gentoo ===

Gentoo is all about choices. When installing Gentoo, this is made clear to you several times -- you can choose how much you want to compile yourself, how to install Gentoo, what system logger you want, etc. Gentoo is a fast, modern metadistribution with a clean and flexible design. Gentoo is built around free software and doesn't hide from its users what is beneath the hood. Portage, the package maintenance system which Gentoo uses, is written in Python, meaning you can easily view and modify the source code. Gentoo's packaging system uses source code (although support for precompiled packages is included too) and configuring Gentoo happens through regular textfiles. In other words, openness everywhere.

{{Main|Gentoo}}

=== Android ===

Android is a mobile phone platform by Google, and later the Open Handset Alliance (OHA). Openmoko is fully supporting Android running on the Freerunner. Details along with images are being constructed at the moment. Visit the user web page for [http://wiki.openmoko.org/wiki/User:Seanmcneil3 Sean McNeil] for further details. And you can download kernel and image [http://people.openmoko.org/sean_mcneil/ here].

{{Main|Android}}

=== Hackable:1===
Hackable1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform.
{{Main|Hackable:1}}

=== Others / unreleased ===

* The [http://www.neopwn.com/software.php NeoPwn] network auditng system's core is a modified Linux 2.6.24 kernel, with cross-compiled module driver support for the numerous compatible addon devices running on a FULL Debian (ARMEL) operating system. The filesystem has been optimized for performance and size and includes the NeoPwn menu system and several GUI dialogs for hardware control and attack automation. ''Status: Unknown, the GPL requires source code to be distributed only to customers''.
* [http://runningbear.org/trac RunningBear] is an innovating yet free and open-source Operating System for hackable devices driven by Bearstech. Lightweight, Portable, Secure, Friendly and Useful. ''Status: In development''.
* [[Hackable:1|Hackable1]] is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform. ''Status: In development. Link with RunningBear to be clarified.''
* [http://pokylinux.org/ Poky] and Sato, by OpenedHand/Intel. An open source platform build tool derived from OE. It is a complete software development environment for the creation of Linux devices. It enables you to design, develop, build, debug, and test a complete, modern, software stack using Linux, the X Window System and GNOME Mobile based application frameworks for both ARM and x86 based platforms. ''Status: Not sure if it ever ran on the FreeRunner, but it surely could if they wanted.''
* [http://pyneo.org/ PyNeo] lead dev writes that Mickey Lauer gave the whole pyneo stack and his work to build a flashable image the name "moko underground". This was an alias for pyneo at that moment. He then started his own stack using most of the technics & architecture, library & language choices used in pyneo. ''Status: still active, ask around on #neo1973-germany ''
* [http://www.quantum-step.com/ mySTEP] by Openmoko distributor Golden Delicious Computers is based on GNUstep and brings a Objective-C API to the Neo. Core GUI frameworks are "Foundation" & "AppKit". It has been shown on FOSDEM 2008, LinuxTag 2008 and SYSTEMS 2008 to run on the Neo 1973. If someone reengineers UIKit, (open) source code compatibility to iPhone apps appears achievable. ''Status: it does not have its own kernel so a Freerunner distribution waits for a solid basis and an arm-linux-gnueabi toolchain that runs natively on Mac OS X is currently lacking.''

== Features by distribution/release target ==

Generally, distributions can differ on one or more of the following components:
* The bootsplash screen image. This is purely decorative.
* The bootloader. Theoretically, any version of ''uboot'' could be used with any distribution. In the future ''Qi'' will replace ''uboot''.
* The kernel. GNU/Linux kernels versions 2.6.24, 2.6.26 or 2.6.28 can be found. Some have modules compiled in, others have modules compiled separately. If compiled separately, modules can be distributed in the same package file as the kernel or separately.
* Middleware: daemons to handle GSM calls or GPS, sound system, personal information storage and so on. Qt and Android have their own subsystems, FreeSmartphone.Org (FSO) is working towards a standard-based Free Software one.
* Display driver. The original ''Qt Extended'' uses the framebuffer, most other distributions today use ''X11''.
* Libraries and application framework (widget toolkit and and graphical environment) : EFL, Qt, Gtk+ or Java ?
* Basic telephony applications: voice calls, SMS, alarm clock...
* Smartphone applications: GPS, media player, simple games, web browser...
* Open source applications: more games, scientific, you name it...

=== Connectivity ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om 2008.8 !! width=9%|Om 2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gentoo !! width=9%|Android
|-
| Telephony || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{no}}
|-
| SMS || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{no}}
|-
| [[GPRS]] || ?? || Not through UI || Not through UI|| Not through UI || Not through UI || ?? || {{Yes}} || {{Yes}} (1) || ?? || {{no}}
|-
| WiFi || ?? || {{Yes}} (*) || {{Yes}} || Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{no}}
|-
| VoIP || ?? || ?? || ?? || ?? || ?? || {{Yes}} || {{Yes}} (1) || {{Yes}} || ?? || {{no}}
|-
| Bluetooth || ?? || {{Yes}} || {{Yes}} || {{No}} || ?? || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| GPS (1) || ?? || {{Yes}} (1) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== User Interaction ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om2008.8 !! width=9%|2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gentoo !! width=9%|Android
|-
| Stylus friendly || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| Finger friendly || ?? || Partially || Partially || Partially || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || ?? || {{Yes}}
|-
| Accelerometer || ?? || {{Yes}} [[Gestures|(1)]] || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || ?? || {{Yes}}
|-
|}

=== Applications ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om2008.8 !! width=9%|2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gentoo !! width=9%|Android
|-
| Terminal || ?? || {{Yes}} (1) || Basic (2) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || ??
|-
| PIM || ?? || {{Yes}} || {{Yes}} || {{No}} || N/A || ?? || {{Yes}} || {{Yes}} (1) || ?? || ??
|-
| Phonebook || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Dialer || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Web Browser || ?? || {{Yes}} (1) || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Mail Client || ?? || {{Yes}} || ? || ? || ? || ?? || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| XMPP Client || ?? || {{Yes}} [[Instant Messaging|(1)]] || {{Yes}} (1) || ? || ? || ?? || {{Yes}} || {{Yes}} (1) || || ??
|-
| Media Player || ?? || {{Yes}} (1) || {{Yes}} || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== Toolkits / Runtimes ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om2008.8 !! width=9%|2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gentoo !! width=9%|Android
|-
| GTK+ || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{No}} || {{Yes}} || ?? || ??
|-
| Qt/Qt Extended || ?? || {{Yes}} || {{No}} || {{Yes}} ? || {{Yes}}? || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| Middleware || ?? || qtopia-x11 || gsmd/neod || FSO || FSO || ?? || Qt Extended || FSO || ?? || ??
|-
| [[Java]] || ?? || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || ?? || ?? || {{Yes|CacaoVM, JamVM}} || ?? || ??
|-
| [[Python]] || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{yes}} || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| [[Mono]] || ?? || {{Yes}} (1) || {{Yes}} (1) || ?? || {{no}} || ?? || ?? || {{Yes}} (1) || ?? || ??
|}

=== Images ===
Latest and stable combinations for Neo FreeRunner gta02
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
| || OM || FDOM || Qt Extended || Android
|-
| current bootloader || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/daily/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/daily/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/daily/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] ||
|-
| future bootloader || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu ||
|-
| splash || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz ||
|-
| kernel || [[Linux]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest uImage.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] from [http://wiki.openmoko.org/wiki/User:Seanmcneil3 McNiel] version [http://people.openmoko.org/sean_mcneil/uImage-android 2.6.26-android]
|-
| modules || ? || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz ||
|-
| rootfs || [[Main_Page|OM]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest rootfs.jffs2 || [[FDOM]] from [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/ TuxBrain] version [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/Fat_and_Dirty_OM.200809_20081023.rootfs.jff2 200809_20081023] || [[Qtopia_/_Qt_Extended_on_FreeRunner|QtExtended]] from [http://qtextended.org/modules/mydownloads/viewcat.php?cid=6 TrollTech] latest qtextended-gta02-flash.tgz or from [http://other.lastnetwork.net/OpenMoko/ Hypnotize] latest qtextended-gta02-rootfs-release-working.jffs2 || [[Android]] from [http://wiki.openmoko.org/wiki/User:Seanmcneil3 McNiel] version [http://people.openmoko.org/sean_mcneil/androidfs.jffs2 android]
|}

Footnotes:

(1) works, but need additional software to be installed

(2) unusable due to lack of certain keyboard characters. [[Switching_Keyboards#Matchbox_keyboard|Various fixes available.]]

(*) unstable

== See also ==

* Mickey Lauer's post "[http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO, TMTLA!]" describes the differences between distributions 2007.2, ASU and FSO.

[[Category:Distributions|*]]

Distributions

2008-12-02T18:39:42Z

Narmo: /* Applications */

{{Languages|Distributions}}

{| class="wikitable" style="float:right;width:200px;background-color:#FF6600;text-align:center;border-collapse:collapse;font-weight:bold"
|Distributions
|-
! style='background-color:#333333;color:#FFFFFF'|
<div align=left>
* Openmoko (official)
** [[Om 2008.9 Update]]
** [[Om 2008.8]]
** [[Om 2007.2]]
** [[OpenmokoFramework|FSO]]
* Community
** [[SHR]]
** [[FDOM]]
* Other
** [[Qtopia]]
** [[Debian]]
** [[Gentoo]]
** [[Android]]
</div>
|-
|}
Openmoko distributions are designed to run on various mobile devices, with the primary aim of supporting Openmoko Inc.'s [[GTA01:Neo 1973|Neo 1973]] and [[Neo FreeRunner]] phones. They are GNU/Linux distributions -- complete operating systems with more or less user applications. You can install any of them on your phone or even have a multiboot system with two distributions installed.

While the Openmoko distributions will run on [[Supported devices|other mobile devices]] too, some other software distributions will also run on the Openmoko Inc. phones (see below).

For downloads see [[Download]], for installation instructions see [[Flashing the Neo FreeRunner]].

== About distributions ==

=== Which distribution should I use ?===
* Most new users find [[FDOM]] the most comprehensive and functional distribution.
* If you want "just a phone", try [[Qtopia]].
* If you want to develop anything that last, your platform is [[FSO]] (and the choice between EFL, GTK+, Qt, Java, Python or whatever is open).
* [[SHR]], [[Debian]], [[Gentoo]] and [[Android]] are for people who do not need to ask which distribution they should use.
* Tracking the "base image" by updating daily from testing/unstable is a different game either.

===Status as of November 9th, 2008 ===
* The phones ship with [[Om 2007.2]]. It is not supported by Openmoko Inc. anymore. But community developpers continue to work on its phone stack in the [[SHR]] project.
* The branch currently supported by Openmoko Inc. is [[Om 2008.9 Update]], which is a minor upgrade of [[Om 2008.8]] (formerly named ASU). Based on that, the community made the [[FDOM]] distribution by adding lots of fixes and applications to it.
* The trunk tip is a "base image" on which the next major release should be based. This next release can be previewed by installing milestones of the [[FSO]] - Free Smartphone.Org project. The [[Debian]] packaging team also track that branch.
* The FreeRunner is a reference platform for TrollTech's Qt Extended (formerly [[Qtopia]]) distribution.
* The Android port is work-in-progress.

=== Warnings ===

* Stable in the FreeRunner world does not mean the same thing as stable in Debian world.
* Most distributions use the same bootloader, kernel, drivers and hardware. Therefore, the same low level bugs are commonly found in all distributions. The latest and greatest software usually has most bug fixes, plus a whole set of new fresh bugs.
* Most of these distributions also have package repositories. It is a BAD idea to feed from another distribution's repository.
* Upgrade path between these distributions are mostly not tested, thus updating by changing the feeds will most likely end in broken packages or even an unbootable system. It is advisable to reflash the whole filesystem with [[dfu-util]] to switch between the different distributions, with the reminder that a dual-boot setup (e.g. via sdcard or NFS) can be used.

== Openmoko Inc. driven release targets ==

These different 'release targets' are built out of different branches of the [[OpenEmbedded]] metadistribution source tree.

=== Om 2008.9 ===

The Om 2008.9 Update is the first point release after the initial Om 2008.8 release. Openmoko recommends that all existing installations of Om 2008.8 should be updated to that version. Quality-wise, we are still far from the goal, but this version includes general stability enhancing operating system improvements and a new splash screen. No applications were added or removed. Users with basic telephony needs will find it tolerable as an everyday phone.

{{Main|Om 2008.9 Update}}

=== Om 2008.8 ===

Om 2008.8 was released on August 8, 2008, to replace 2007.2. Prior to that, its codename was ASU (April/August Software Update). This is still the name of the branch in the version control system. This distribution integrates the [http://trolltech.com/products/qtopia Qtopia] phone stack with a set of new Openmoko applications based on the Enlightenment Foundation Libraries. Qtopia being a more mature product than the GNOME Mobile stack, the standard phone applications (dialer, contacts, calculator, calendar) work better than in 2007.2. The Qtopia used in 2008.8 was ported to run on X11, contrary to standard Qtopia which uses the framebuffer. This allows non-Qt applications to safely share the screen with Qt applications. This is a .0 release, many unresolved issues remain in the lower layers (kernel power management, sound, wifi drivers...).

{{Main|Om2008.8}}

=== Om 2007.2 ===

[[Om 2007.2]] is the base-system which is installed on FreeRunner when it leaves the factory. The interface was totally finger-oriented, optimized for 285ppi, and very orange. It used the GTK+ stack, which is part of the [http://www.gnome.org/mobile/ GNOME Mobile] platform. This distribution is now considered obsolete and not being worked on by Openmoko Inc or by OpenedHand. There is a community effort (see [[SHR]]) to port the GTK based telephony applications to the future middleware from [[FSO]].

{{Main|Om 2007.2}}

=== FSO Milestone IV ===

FSO is an abbreviation for FreeSmartphone.Org. Openmoko is working on a stable system services back-end. Focus is on stable highlevel services that you can access from whatever language or UI that supports [http://dbus.freesmartphone.org/ dbus]. The framework will be used in forthcoming Openmoko distributions. FSO is all about middleware, but if one stacks a bootloader+kernel under it and telephony applications on top, one gets a functional distribution. These are made available as FSO-image milestones. Openmoko Framework Image milestone IV was released on November 11th, 2008 and named 'Homework'. People report that despite its infancy, the phone server part in FSO is already more solid than anywhere else. The kernel under it is a Linux 2.6.24 with modules packaged separately. The telephony application on top of it is Zhone. This is a basic Python dialer/homescreen designed as scaffolding to test the FSO functionalities (even if Zhone is pretty, code path coverage is more critical to it than user-friendliness).

{{Main|FSO}}

== Openmoko Community driven release targets ==

=== SHR - Stable Hybrid Release ===

SHR is a community driven distribution. It contains some basic GTK+ based applications which make use of the FSO. There currently is a EFL (with elementary) dialer, messages and contacts application programmed in C. As of November 9th, 2008, there is no stable release of this distribution yet, as the SHR team doesn't feel it to be good enough. You can find images though on the [http://shr.bearstech.com/shr-testing SHR buildhost].

{{Main|Stable Hybrid Release}}

=== FDOM (FAT and Dirty Openmoko) ===

[[FDOM]] is a distribution based on Openmoko's currently supported image, updated with many ready-to-use applications and with fixes posted in the mailing lists. A combination of applications (everything goes) and fixes to demonstrate 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.

{{Main|FDOM}}

== Non-Openmoko distributions ==

These are not Openmoko (and OE) based distributions. These are alternatives you can run on your Openmoko phones.

=== Qt Extended ===

The Qt Extended distribution was formerly known as Qtopia up to version 4.3.x included. It comes from [http://www.trolltech.com Trolltech], a Nokia company, the makers of the Qt cross-platform application framework. This distribution aims to provide a ready-to use image for Openmoko devices. It features a noticeably robust telephony stack. Recent release 4.4.2 also sports a webkit-based web browser and Gtalk support.

{{Main|Qtopia / Qt Extended on FreeRunner}}

=== Debian ===

Debian is "the universal operating system". It comes with thousands and thousands of packages (most of them designed for desktops or servers so far). So in the words of Joachim "nomeata" Breitner from the [http://wiki.debian.org/Teams/DebianFSO pkg-fso] team, this is not really a distribution in the Openmoko sense of the word, but rather a different underlying system for Openmoko distributions. At the moment, we ship the software from the FSO stack, but hopefully we’ll also have, for example, the Stable Hybrid Release software in our archive. So for now, Debian is a different way of installing FSO, which takes more space and provides more programs :-)

{{Main|Debian}}

=== Gentoo ===

Gentoo is all about choices. When installing Gentoo, this is made clear to you several times -- you can choose how much you want to compile yourself, how to install Gentoo, what system logger you want, etc. Gentoo is a fast, modern metadistribution with a clean and flexible design. Gentoo is built around free software and doesn't hide from its users what is beneath the hood. Portage, the package maintenance system which Gentoo uses, is written in Python, meaning you can easily view and modify the source code. Gentoo's packaging system uses source code (although support for precompiled packages is included too) and configuring Gentoo happens through regular textfiles. In other words, openness everywhere.

{{Main|Gentoo}}

=== Android ===

Android is a mobile phone platform by Google, and later the Open Handset Alliance (OHA). Openmoko is fully supporting Android running on the Freerunner. Details along with images are being constructed at the moment. Visit the user web page for [http://wiki.openmoko.org/wiki/User:Seanmcneil3 Sean McNeil] for further details. And you can download kernel and image [http://people.openmoko.org/sean_mcneil/ here].

{{Main|Android}}

=== Hackable:1===
Hackable1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform.
{{Main|Hackable:1}}

=== Others / unreleased ===

* The [http://www.neopwn.com/software.php NeoPwn] network auditng system's core is a modified Linux 2.6.24 kernel, with cross-compiled module driver support for the numerous compatible addon devices running on a FULL Debian (ARMEL) operating system. The filesystem has been optimized for performance and size and includes the NeoPwn menu system and several GUI dialogs for hardware control and attack automation. ''Status: Unknown, the GPL requires source code to be distributed only to customers''.
* [http://runningbear.org/trac RunningBear] is an innovating yet free and open-source Operating System for hackable devices driven by Bearstech. Lightweight, Portable, Secure, Friendly and Useful. ''Status: In development''.
* [[Hackable:1|Hackable1]] is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform. ''Status: In development. Link with RunningBear to be clarified.''
* [http://pokylinux.org/ Poky] and Sato, by OpenedHand/Intel. An open source platform build tool derived from OE. It is a complete software development environment for the creation of Linux devices. It enables you to design, develop, build, debug, and test a complete, modern, software stack using Linux, the X Window System and GNOME Mobile based application frameworks for both ARM and x86 based platforms. ''Status: Not sure if it ever ran on the FreeRunner, but it surely could if they wanted.''
* [http://pyneo.org/ PyNeo] lead dev writes that Mickey Lauer gave the whole pyneo stack and his work to build a flashable image the name "moko underground". This was an alias for pyneo at that moment. He then started his own stack using most of the technics & architecture, library & language choices used in pyneo. ''Status: still active, ask around on #neo1973-germany ''
* [http://www.quantum-step.com/ mySTEP] by Openmoko distributor Golden Delicious Computers is based on GNUstep and brings a Objective-C API to the Neo. Core GUI frameworks are "Foundation" & "AppKit". It has been shown on FOSDEM 2008, LinuxTag 2008 and SYSTEMS 2008 to run on the Neo 1973. If someone reengineers UIKit, (open) source code compatibility to iPhone apps appears achievable. ''Status: it does not have its own kernel so a Freerunner distribution waits for a solid basis and an arm-linux-gnueabi toolchain that runs natively on Mac OS X is currently lacking.''

== Features by distribution/release target ==

Generally, distributions can differ on one or more of the following components:
* The bootsplash screen image. This is purely decorative.
* The bootloader. Theoretically, any version of ''uboot'' could be used with any distribution. In the future ''Qi'' will replace ''uboot''.
* The kernel. GNU/Linux kernels versions 2.6.24, 2.6.26 or 2.6.28 can be found. Some have modules compiled in, others have modules compiled separately. If compiled separately, modules can be distributed in the same package file as the kernel or separately.
* Middleware: daemons to handle GSM calls or GPS, sound system, personal information storage and so on. Qt and Android have their own subsystems, FreeSmartphone.Org (FSO) is working towards a standard-based Free Software one.
* Display driver. The original ''Qt Extended'' uses the framebuffer, most other distributions today use ''X11''.
* Libraries and application framework (widget toolkit and and graphical environment) : EFL, Qt, Gtk+ or Java ?
* Basic telephony applications: voice calls, SMS, alarm clock...
* Smartphone applications: GPS, media player, simple games, web browser...
* Open source applications: more games, scientific, you name it...

=== Connectivity ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om 2008.8 !! width=9%|Om 2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gentoo !! width=9%|Android
|-
| Telephony || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{no}}
|-
| SMS || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{no}}
|-
| [[GPRS]] || ?? || Not through UI || Not through UI|| Not through UI || Not through UI || ?? || {{Yes}} || {{Yes}} (1) || ?? || {{no}}
|-
| WiFi || ?? || {{Yes}} (*) || {{Yes}} || Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{no}}
|-
| VoIP || ?? || ?? || ?? || ?? || ?? || {{Yes}} || {{Yes}} (1) || {{Yes}} || ?? || {{no}}
|-
| Bluetooth || ?? || {{Yes}} || {{Yes}} || {{No}} || ?? || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| GPS (1) || ?? || {{Yes}} (1) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== User Interaction ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om2008.8 !! width=9%|2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gentoo !! width=9%|Android
|-
| Stylus friendly || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| Finger friendly || ?? || Partially || Partially || Partially || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || ?? || {{Yes}}
|-
| Accelerometer || ?? || {{Yes}} [[Gestures|(1)]] || {{No}} || {{No}} || {{No}} || {{Yes}} || {{No}} || {{Yes}} || ?? || {{Yes}}
|-
|}

=== Applications ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om2008.8 !! width=9%|2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gentoo !! width=9%|Android
|-
| Terminal || ?? || {{Yes}} (1) || Basic (2) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || ??
|-
| PIM || ?? || {{Yes}} || {{Yes}} || {{No}} || N/A || ?? || {{Yes}} || {{Yes}} (1) || ?? || ??
|-
| Phonebook || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Dialer || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Web Browser || ?? || {{Yes}} (1) || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Mail Client || ?? || {{Yes}} || ? || ? || ? || ?? || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| XMPP Client || ?? || {{Yes}} [[Instant Messaging|(1)]] || {{Yes}} (1) || ? || ? || ?? || {{Yes}} || {{Yes}} (1) || || ??
|-
| Media Player || ?? || {{Yes}} (1) || {{Yes}} || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== Toolkits / Runtimes ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
! width=10%| !! width=9%|Om 2008.9 !! width=9%|Om2008.8 !! width=9%|2007.2 !! width=9%|FSO !! width=9%|SHR !! width=9%|FDOM !! width=9%|Qt Extended !! width=9%|Debian !! width=9%|Gento !! width=9%|Android
|-
| GTK+ || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{No}} || {{Yes}} || ?? || ??
|-
| Qt/Qt Extended || ?? || {{Yes}} || {{No}} || {{Yes}} ? || {{Yes}}? || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| Middleware || ?? || qtopia-x11 || gsmd/neod || FSO || FSO || ?? || Qt Extended || FSO || ?? || ??
|-
| [[Java]] || ?? || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || ?? || ?? || {{Yes|CacaoVM, JamVM}} || ?? || ??
|-
| [[Python]] || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{yes}} || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| [[Mono]] || ?? || {{Yes}} (1) || {{Yes}} (1) || ?? || {{no}} || ?? || ?? || {{Yes}} (1) || ?? || ??
|}

=== Images ===
Latest and stable combinations for Neo FreeRunner gta02
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
| || OM || FDOM || Qt Extended || Android
|-
| current bootloader || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/daily/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/daily/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/daily/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] ||
|-
| future bootloader || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu ||
|-
| splash || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz ||
|-
| kernel || [[Linux]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest uImage.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] from [http://wiki.openmoko.org/wiki/User:Seanmcneil3 McNiel] version [http://people.openmoko.org/sean_mcneil/uImage-android 2.6.26-android]
|-
| modules || ? || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz ||
|-
| rootfs || [[Main_Page|OM]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest rootfs.jffs2 || [[FDOM]] from [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/ TuxBrain] version [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/Fat_and_Dirty_OM.200809_20081023.rootfs.jff2 200809_20081023] || [[Qtopia_/_Qt_Extended_on_FreeRunner|QtExtended]] from [http://qtextended.org/modules/mydownloads/viewcat.php?cid=6 TrollTech] latest qtextended-gta02-flash.tgz or from [http://other.lastnetwork.net/OpenMoko/ Hypnotize] latest qtextended-gta02-rootfs-release-working.jffs2 || [[Android]] from [http://wiki.openmoko.org/wiki/User:Seanmcneil3 McNiel] version [http://people.openmoko.org/sean_mcneil/androidfs.jffs2 android]
|}

Footnotes:

(1) works, but need additional software to be installed

(2) unusable due to lack of certain keyboard characters. [[Switching_Keyboards#Matchbox_keyboard|Various fixes available.]]

(*) unstable

== See also ==

* Mickey Lauer's post "[http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO, TMTLA!]" describes the differences between distributions 2007.2, ASU and FSO.

[[Category:Distributions|*]]

MokoMakefile

2008-11-25T20:37:19Z

Narmo: Some code formatting

{{Languages|MokoMakefile}}

MokoMakefile is a Makefile which saves lots of work when setting up an Openmoko build environment.
By automating the setup process of a new Openmoko build environment, it provides an environment which is configured the same for all the existing developers and should therefore be preferred over manual procedures or individual setup procedures.
It brings the same repeatability to build environment creation and maintenance as that which the BitBake scripts bring to [[OpenEmbedded]] ease and standardize the process of building OpenEmbedded.

MokoMakefile does not install anything into your system (it can and should be started as normal user). MokoMakefile is a wrapper around all that is required to make it easy to set up and maintain a development environment that fully complies with the setup instructions published by Openmoko.

MokoMakefile is developed by [[User:RodWhitby|Rod Whitby]] - it is not an official product of Openmoko (although I would be happy for them to pick it up and use it internally). If there is any discrepancy between the [[Openmoko2007.2#How_to_build|official Openmoko build instructions]], and the operation of the MokoMakefile, then you should consider the official instructions to be correct.

The MokoMakefile is able to build both Om2008.8 (org.openmoko.asu.stable, openmoko-asu-image) and "Bleeding Edge" (org.openmoko.dev, openmoko-base-image) images.

MokoMakefile also builds the QEMU-based Neo1973 emulator as part of the build process and has make targets to install the Openmoko images into it and run it. These commands can also be used without downloading and building the whole Openmoko OpenEmbedded distribution. This part is described in [[Using QEMU with MokoMakefile]].

== Requirements for building Openmoko ==
Independent on whether MokoMakefile or a manual process is used to setup an Openmoko build environment, there are several requirements which must be fulfilled in order for the Openmoko build to succeed:

* RAM: The build host needs to have at least 512MB of RAM, and about the same amount of swap. Some packages built by OpenEmbedded like busybox are built by compiling all source files into one binary which causes gcc to grow beyond 300MB of size and no part of this memory may be on swap for the compile to finish in predictable time. For busybox, this can be turned off, but turning this off means that busybox will not as well optimized by gcc.

* Disk space: You need about 12 GB of available disk space for the Openmoko build to succeed (see below for a tip on how to reduce this).

* Time: The initial build takes at least 5 hours (on 2GHz core2duo without multiprocessor optimization) and may take several days on slower machines.

=== Required software ===

Some distribution specific hints on preparing your build host for building OpenEmbedded are on http://wiki.openembedded.net/index.php/OEandYourDistro but they may be outdated, incomplete and do not cover everything which Openmoko needs to build.

A good guide is [[Building Openmoko from scratch#Build host prerequisites|the section on build host prerequisites]] in [[Building Openmoko from scratch]]

If you forgot anything which OE needs itself, OE will tell you shortly after you start building, but it does not check build dependencies of Openmoko, so you either have to install them before starting or install them after the build failed. OpenEmbedded will continue where it stopped when you restart the build afterwards.

==== Package requirements by distribution ====
Your distribution needs to provide these commands in order for OpenEmbedded to start building:
subversion texi2html texinfo help2man

Openmoko needs the development packages (with header files, development libraries and tools) in order to finish building:

<pre>ncurses zlib (or libz) OpenSSL GTK++</pre>

Because there are bugs in the interaction of QEMU and GCC-4, you'll need a copy of gcc-3.x installed as well.

===== Debian / Ubuntu =====

<pre>sudo apt-get install subversion build-essential help2man diffstat texi2html texinfo cvs gawk zip unzip cogito bzip2
sudo apt-get install libncurses5-dev zlib1g-dev libssl-dev libgtk2.0-dev
# To prevent errors in host validation
sudo apt-get install ca-certificates
# For Openmoko 2007.2 using BitBake-1.8.8:
sudo apt-get install python-pysqlite2 sqlite3 sqlite3-doc python-pysqlite2-dbg
# For building faster
sudo apt-get install quilt python-psyco ccache
# For qemu, install a second compiler for bug avoidance; MokoMakefile knows to look for it.
sudo apt-get install gcc-3.4 g++-3.4 libsdl1.2-dev lynx netpbm dosfstools

# On Ubuntu 8.04 and and Debian testing/unstable, the following was required instead of cogito
sudo apt-get install git-core
# Ubuntu links /bin/sh to /bin/dash, but some scripts fail because they use pushd and popd, which dash does not support
sudo dpkg-reconfigure dash
# Select No when it asks you to install dash as /bin/sh.

# This may be needed only for ASU
sudo apt-get install libxtst-dev</pre>

===== SuSE =====
For building Openmoko on 10.3, you need

<pre>gcc-c++ ncurses-devel zlib-devel libopenssl-devel gtk2-devel subversion diffstat texinfo help2man</pre>

For MokoMakefile to not fail on compiling qemu-user, you need to use gcc33:

<pre>wget download.opensuse.org/repositories/devel:/tools:/gcc/openSUSE_Factory/i586/{cpp,gcc}33-3.3.3-41.8.i586.rpm
rpm -Uhv {cpp,gcc}33-3.3.3-41.8.i586.rpm</pre>

See also the [[Talk:MokoMakefile#Building_on_SuSE_Linux_10.3-AMD64|Talk page on Building on SuSE Linux 10.3-AMD64]]

10.1 and 10.2: same packages as 10.3, but install <code>openssl-devel</code> instead of libopenssl-devel.

===== Mandriva =====

<pre>urpmi git help2man diffstat texi2html texinfo</pre>

(Tested with Mandriva 2009.0. <tt>kernel-desktop-devel</tt> of the current kernel is installed in advance, which installs compilers, binutils and many other general compilation tools.)

==== For all distributions ====

As the QEMU-based neo1973 emulator is also built as part of the build process started by MokoMakefile, so you need gcc-3.3 and other packages for building QEMU installed. See [[Using QEMU with MokoMakefile#Build requirements|the build requirements section]] in [[Using QEMU with MokoMakefile]] for information on the required software.

If you are having problems compiling QEMU and do not need it, you can disable building of QEMU by adding following line to build/conf/local.conf file:

<pre>ENABLE_BINARY_LOCALE_GENERATION = "0"</pre>

===== Proxy =====

Users behind a proxy should ensure that their proxy is configured in their wgetrc file as the http_proxy environment variable is unset by MokoMakefile.

== Building Openmoko with MokoMakefile ==

=== Preparations ===
Create your $OMDIR directory (note that you can change ~/moko to any directory you like):

<pre>mkdir ~/moko ; cd ~/moko</pre>

If you have your ~moko dir mounted from a different file system, be sure to edit /etc/mtab to add the 'exec' permission to the file system, else bitbake will fail with error messages stating that /usr/bin/env is an invalid interpreter.
If you ever want to move your $OMDIR to another location, you must run

<pre>make clobber ; make setup</pre>

to reinitialize the environment. Yes, this will take a long time, so choose $OMDIR carefully.

=== MokoMakefile ===

Grab MokoMakefile:

<pre>wget http://www.rwhitby.net/files/openmoko/Makefile</pre>

If that doesn't work, try

<pre>wget http://svn.projects.openmoko.org/svnroot/mokomakefile/trunk/Makefile</pre>

{{note|MokoMakefile uses BitBake 1.8.8 which requires python-sqlite2 and sqlite-3.3 or later. Users of SUSE Linux 10.1 can update to [http://download.opensuse.org/pub/opensuse/distribution/10.2/repo/oss/suse/i586/sqlite-3.3.8-14.i586.rpm the version of openSUSE 10.2]}}

=== Environment ===

If you want to make the "Bleeding Edge" (org.openmoko.dev, openmoko-base-image) image instead of the Om2008.8 image, see [[Distributions]], you need to edit your Makefile. Read the top of the Makefile for details.

Note that if you want to build FSO, you should use the FSO Makefile at http://downloads.freesmartphone.org rather than the MokoMakefile.

Set up the environment with:

<pre>make setup</pre>

If you are building for the Neo1973 GTA01, then also do this

<pre>make setup-machine-om-gta01</pre>

If you are building for the FreeRunner GTA02, then also do this

<pre>make setup-machine-om-gta02</pre>

=== Building ===

Before starting a lengthy make process, check the [[#Tips|Tips]] section below for how to make Make multicore aware. You may want to modify the build/conf/local.conf file for your target (emulation/chroot) environment.

<pre>make image</pre>

''Hint:'' The images build with this command can be found under {$OMDIR}/build/tmp/deploy/glibc/images/neo1973

This will set up the recommended directory structure as described in [[Building Openmoko from scratch]], will download all the required software (from the right places with the right versions), and will immediately start building an image.

Once you have done this, you can choose to continue using the MokoMakefile to initiate your subsequent builds, or you can go into the build directory and run bitbake commands manually. The choice is yours.

==Updating the environment==

For easy maintenance of your build environment the following commands are available.

1 - To update the MokoMakefile to the latest version:

<pre>make update-makefile</pre>

Be aware that any changes you previously made to the Makefile (like the git branch to use) are lost when executing ''update-makefile''.

2 - To make sure that any recent changes to the build directory structure have been applied:

<pre>make setup</pre>

3 - To update the Openmoko repository checkout and the MokoMakefile patches to the latest version:

<pre>make update</pre>

A quick way to rebuild a new image with the latest updates:

<pre>make update-makefile && make setup update image</pre>

==Build issues==

First, make sure that the problem is reproducible after running

<pre>make update-makefile && make setup && make update</pre>

then run

<pre>make clean-package-<foo></pre>

(where you replace <foo> with the name of the package which is failing)

and finally

<pre>make image</pre>

With luck - you should now have images in your $omdir/build/tmp/deploy/glibc/images/neo1973/ directory. You can then [[Flashing the Neo FreeRunner|flash these]].

If not, and you can get the error to occur three times in a row after running that sequence of commands (including the update and setup steps) three times, then feel free to report it to rwhitby in #openmoko on [[Development_resources#IRC|IRC]].

If you have chronic build problems, cleaning your environment variables and re-running the build from scratch may help. The following script should remove all non-essential variables; you should also manually trim your path to the minimum.

<pre>`env | grep -Ev '^(SHELL|TERM|OLDPWD|USER|USERNAME|PATH|EDITOR|LANG|HOME|DISPLAY|_)=' \
| sed 's/^$.*$=.*/unset \1/'`</pre>

(you must include the backticks).

Note that on some boxes it is necessary to call "make" by typing "/usr/bin/make" afterwards.

On current Ubuntu/Debian unstable/testing boxes another trick is necessary. glibc_2.6.1 fails to build since it is unable to generate the necessary locales until you type in the following line:

<pre>sudo sysctl -w vm.mmap_min_addr=0</pre>

Note that this temporarily disables a new security vulnerability check that has entered /etc/sysctrl - but that makes problems with loads of applications.

To re-enable this check do the following:

<pre>sudo sysctl -w vm.mmap_min_addr=65536</pre>

See the talk page of this article for more details on this solution.

===Known MokoMakefile errors ===

==== SVN Server Certificate Errors ====

If you get an error like the following:

<pre>NOTE: Fetch svn://svn.projects.openmoko.org/svnroot/;module=assassin;proto=https
Error validating server certificate for 'https://svn.projects.openmoko.org:443':
- The certificate is not issued by a trusted authority. Use the
fingerprint to validate the certificate manually!
Certificate information:
- Hostname: projects.openmoko.org
- Valid: from Thu, 05 Jun 2008 01:02:42 GMT until Tue, 02 Dec 2008 01:02:42 GMT
- Issuer: http://www.cacert.org, Root CA
- Fingerprint: a5:7d:4e:37:e8:94:ee:ba:c1:e8:e9:4b:33:cb:34:91:a9:6d:d3:84
(R)eject, accept (t)emporarily or accept (p)ermanently?
svn: OPTIONS of 'https://svn.projects.openmoko.org/svnroot/assassin':
Server certificate verification failed: issuer is not trusted (https://svn.projects.openmoko.org)</pre>

It means you haven't yet accepted the server certificate for the SVN server. To remedy this, execute the following commands, and hit "p" (to permanently accept the certificate) when prompted:

<pre>cd /tmp
svn co https://svn.projects.openmoko.org/svnroot/assassin
rm -rf assassin
cd -</pre>

==== exposure_svn and Subversion 1.5.0 ====

If you get an error like this:

<code>"NameError: global name 'log' is not defined"</code>

There's a bug with subversion 1.5.0 -- downgrade to 1.4.x (or check out the latest subversion sources and use those as they're fixed) and re-fetch the sources.

=== Fixes for distribution/environment-specific or isolated issues ===

Work-arounds for temporary or isolated problems can be found and should be added to the [[Talk:MokoMakefile|Discussion page]] which is associated with this page. As they are fixed, they will be removed from that page.

==Tips==

* Make sure umask is set to 0022 before you run "make setup"
* If a certain package does not build due to corrupted download or some such try to remove the sources and rebuild it.
<pre>rm sources/<package>*
cd build
. ../setup-env
bitbake -crebuild <package></pre>
After that your build might just work again.

* For people with multiple CPU's (or dual-core ones) this small patch might be useful to build things faster.
Edit the local.conf and add the following lines:
<pre>PARALLEL_MAKE = "-j 4"
BB_NUMBER_THREADS = "4"</pre>

Change the PARALLEL_MAKE and BB_NUMBER_THREADS values to something that suits better if it chokes your machine.

* I have some problem with the parallel building, mkfs.jffs failed to build the image because the directory was modify while the building of the fs. [[User:Patrick.hetu|patrick.hetu]] 02:19, 27 May 2008 (UTC)

* If you encounter an error related with the qemu-native package and not compiling for the qemu, you can edit the build/conf/local.conf file and add ENABLE_BINARY_LOCALE_GENERATION = "0" line to avoid the error.

* To prevent building tons of locales, add a line like this to local.conf:
<pre>GLIBC_GENERATE_LOCALES = "en_US.UTF-8 nl_NL.UTF-8"</pre>

* To not build any binary locales at all, add this to local.conf:
<pre>ENABLE_BINARY_LOCALE_GENERATION = "0"</pre>

* If you want to rebuild the package indexes (for instance, after compiling a new version of a package) without building the whole <code>image</code>, run <code>make build-package-package-index</code>.

[[User:Wurp]] will update this to be a little more comprehensible, but maybe it can help someone as-is in the meantime:
* If MokoMakefile always fails on some fetch in zlib, just find the binary somewhere, add it to the downloads or sources directory manually (create the .md5 matching file if necessary), and retry.

* Make sure you do not have . in your PATH, this causes an "unrecognized option -Qy" error when building g++spec

=== Useful commands ===

Here is the list (not complete) of useful MokoMakefile commands (actually make targets) and a short description of each one. These should be run inside $OMDIR directory.

; make image : build the full development image

; make tools : build statically-linked [[dfu-util]] and [[openocd]] binaries

; make toolchain : builds [[toolchain]]

; make qemu : builds qemu, downloads flash images from official repository, flashes qemu emulated Neo1973 and runs emulator (see also [[Openmoko under QEMU]]).

; make qemu-local : same as ''make qemu'', but uses locally built images instead of official ones.

; make run-qemu : runs qemu with usb keyboard ''(note: qemu must first be built!)''. This target starts the emulator with some predefined set of options. If you need to start it with other options (enable telnet, etc), see [[QEMU_command_line]].

; make build-package-<package name> : buids ''<package name>'' package

; make update-makefile : updates MokoMakefile

; make clean-package-<foo>: cleans the "<foo>" package

; make setup : to make sure that any recent changes to the build directory structure have been applied

; make update : to update the Openmoko repository checkout and the MokoMakefile patches to the latest version

; make setup-machine-om-gta01 : setup for GTA01 version of Neo1973

; make setup-machine-om-gta02 : setup for GTA02 version of FreeRunner

; make build-package-package-index : Rebuild the package index

== Developing with MokoMakefile ==

For the following explanations $OMDIR is the directory where there Makefile puts all the stuff.

To make in-tree changes and have them built and used by qemu:

<pre>cd $OMDIR/openmoko
quilt new descriptive-patch-name.patch
quilt add trunk/src/name-of-file-to-change # do this for every file you are about to modify
...make the changes...
quilt refresh # this creates a file in $OMDIR/patches/openmoko-HEAD/ and updates the
# quilt series file there</pre>

Note: Do '''NOT''' use absolute paths as this confuses quilt and will get you a diff of the file against /dev/null!

To build the changes and have them used by qemu:

<pre>make build-qemu
make flash-qemu-local
make run-qemu</pre>

If you want to modify applications instead of the openmoko toolchain, this is what you have to do (example: openmoko-messages):

<pre>cd $OMDIR/build
. ../setup-env
bitbake -c patch openmoko-messages
cd tmp/work/armv4t-linux/openmoko-messages-0.0.1+svnnow-r2_2276/openmoko-messages/
''...make the changes...''
cd -
bitbake -c compile openmoko-messages
bitbake -c build openmoko-messages</pre>

Note: The compile step is only necessary if you already had the package compiled before patching it.

Note: if you just use <tt>bitbake openmoko-messages</tt> it will remove the sources after building!

Note: You can use the '-f' switch to force a command to be run (e.g. ''bitbake -f -c compile openmoko-messages'' to force a compile run.

Then continue with MokoMakefile usage.

If you want to add an application to your openmoko distribution, do this:
All file edits should be done using quilt as described above. That way a patch can easily be submitted to the openmoko project.
First, create a directory that will correspond to your package and edit a '''.bb''' file in there:

<pre>cd $OMDIR/openmoko/
quilt new mycoolpackage.patch
mkdir trunk/openembedded/packages/mycoolpackage
quilt add trunk/openembedded/packages/mycoolpackage/mycoolpackage_1.bb
quilt edit trunk/openembedded/packages/mycoolpackage/mycoolpackage_1.bb</pre>

The file should have the following content:

<pre>DESCRIPTION = "This is a cool package"
SECTION = "username/mycoolpackage"
PV = "1"

inherit autotools

SRC_URI = "http://www.example.com/download/mycoolpackage-1.tar.gz"</pre>

Explanation:
* DESCRIPTION - Just a short text explaining the package
* SECTION - I have no clue, but I'll use username/mycoolpackage for now
* PV - Package Version
* inherit autotools - The package can be compiled by './configure && make && make install' so we tell MokoMakefile to do it this way.
* SRC_URI = ... - This is the download location of the package source. It's imperative that the tar.gz contains a directory called '''packagename-packageversion''' (in this case: mycoolpackage-1) so that MokoMakefile can find it automatically or the build will fail.

This is not all. We also need to tell MokoMakfile that it needs to build and include the package in the image. To do this, do

<pre>$OMDIR/openmoko $ quilt edit trunk/openembedded/packages/tasks/task-openmoko.bb</pre>

Here, increase the value '''PR''' by one and add '''mycoolpackage \''' (with the backslash!) just before the line reading '''# update-alternatives \'''.

Now run

<pre>quilt refresh
cd ..
make update image</pre>

And if everything's alright you should now have an Openmoko image to flash to your phone or run in qemu as described above.

=== Hello World application ===

There is a [[Building a hello world application|Hello World!]] tutorial available too.

== Testimonials ==

MokoMakefile is recommended by 4 out of 4 new developers on #openmoko, with testimonials such as "For some reason last night I couldn't get my manual install of everything to work (bb complained about my bbpath I think) ... but with your makefile, it works great!", "MokoMakefile rocks!", "Wow this build system is nice - it just seems more polished than my gumstix toolchain buildroot system", "make openmoko-devel-image :) - no magic there", and "I have never been able to get a build to complete in the pure OE environment, whereas Mokomakefile for some reason builds fine."

Project page:
http://mokomakefile.projects.openmoko.org/

[[Category:Application Developer]]
[[Category:System Developers]]

User:Narmo

2008-11-19T19:05:23Z

Narmo: /* Links */

I've bought OpenMoko Neo FreeRunner on 1st, November, 2008.

== Links ==

* [http://werewolf.weho.ru My private blog]
* [http://weho.ru Developers' blog]
* [http://wiki.weho.ru My wiki]

Openmoko Local Groups: Moscow

2008-11-18T19:30:33Z

Narmo:

=== Possible Participants ===
{|border=1
!Name
!Skills
!Level of Interest
!Other
!Has Device
!Has Debug Board
|-
|[[User:Shadowjack|Shadowjack]]
|C, C++, Linux, GPS
|High
|
|
|
|-
|[[User:Denizzz|Denizzz]]
|C, C++, Linux, GPS
|High
|
|
|
|-
|[[User:BasilK|BasilK]]
|C, C++, Linux, GPS
|High
|
|
|[[Image: MokoBox.jpg|center]]
|-
|[[User:Vc24|vc24]]
|C, C++, Linux
|High
|
| GTA01
|
|-
|[[User:Shallburn|Shallburn]]
|C,OCaml,Scheme,Linux
|Middle
|
|
|
|-
|[[User:Kayo|Kayo]]
|C++, Lua, Python, GNU/Linux
|High
|
|
|
|-
|[[User:yoush|yoush]]
|C/C++, Linux kernel hacker, Debian Developer
|High
|
|
|
|-
|[[User:GreyCardinal|GreyCardinal]]
|C/C++, Linux kernel hacker, Debian Developer
|High
|
|GTA02v5
|
|-
|[[User:SR|SR]]
|C, C++, GNU/Linux
|High
|
|GTA02v6
|Yes
|-
|[[User:Narmo|Narmo]]
|C, C++, GNU/Linux, Objective-C
|High
|
|[[Image:Moko.jpg|center]]
|

|-|}

[[Category:Openmoko Local Groups]]

Openmoko Local Groups: Moscow

2008-11-18T19:29:02Z

Narmo:

=== Possible Participants ===
{|border=1
!Name
!Skills
!Level of Interest
!Other
!Has Device
!Has Debug Board
|-
|[[User:Shadowjack|Shadowjack]]
|C, C++, Linux, GPS
|High
|
|
|
|-
|[[User:Denizzz|Denizzz]]
|C, C++, Linux, GPS
|High
|
|
|
|-
|[[User:BasilK|BasilK]]
|C, C++, Linux, GPS
|High
|
|
|[[Image: MokoBox.jpg|center]]
|-
|[[User:Vc24|vc24]]
|C, C++, Linux
|High
|
| GTA01
|
|-
|[[User:Shallburn|Shallburn]]
|C,OCaml,Scheme,Linux
|Middle
|
|
|
|-
|[[User:Kayo|Kayo]]
|C++, Lua, Python, GNU/Linux
|High
|
|
|
|-
|[[User:yoush|yoush]]
|C/C++, Linux kernel hacker, Debian Developer
|High
|
|
|
|-
|[[User:GreyCardinal|GreyCardinal]]
|C/C++, Linux kernel hacker, Debian Developer
|High
|
|GTA02v5
|
|-
|[[User:SR|SR]]
|C, C++, GNU/Linux
|High
|
|GTA02v6
|Yes
|-
|[[User:Narmo|Narmo]]
|C, C++, GNU/Linux, Objective-C
|High
|
|GTA02v6
|

|-|}

[[Category:Openmoko Local Groups]]

Edje

2008-11-16T15:40:47Z

Narmo:

This page is about changing windows decoration and behavior. For [[CustomizeApplicationIcons|changing application icons]] on the home screen, simply change ''.desktop'' files ''/usr/share/applications'' directory. For more general pimping, see the [[Themes]] page.

= Introduction: What is Edje ? =

In most Openmoko FreeRunner distributions, the graphical environment is the Illume module of the [http://www.enlightenment.org/ Enlightenment 17] window manager. Under this environment, the windows decorations and behavior are managed by a graphical library called ''Edge''. Accordingly, the theme is defined in a ''.edj'' file.

On the FreeRunner, Edje themes are stored at ''/usr/share/enlightenment/data/themes''. Which theme gets loaded by default is defined via the symlink ''/usr/share/enlightenment/data/themes/illume.edj''. To use a custom theme, simply put a '''.edj'' file to ''~/.e/e/themes/illume.edj''.

A ''.edj'' file is a collection of possibly several files, including images and even fonts in some cases (see [http://web.enlightenment.org/p.php?p=docs&l=en E17 documentation]). It allows to change the background image (see the example below) but is much more powerful than that. Along with the visual definitions and elements, it includes programmatic statements controlling interaction between GUI elements and between GUI and application. For instance, the dialer may have three 'program' triggers written into the edje for each button - change GUI to 'pressed', change GUI to 'released', and add digit to number. Unlike traditional ideas about theming, this interaction is defined in the 'theme' instead of the application itself. This allows for unprecedented flexibility insofar as 'theming' - you can change button layouts, graphics, even add some features like 'delete last digit' all within the .edj.

If you want to play around with edje themes here are two approaches:

1. Use ''edje-editor''. Keep in mind that the editor works, quite nicely in some regards, but has some flaws and some distinctly missing features like it can't remove a no-longer-used background image from the .edj file. See [http://lists.openmoko.org/pipermail/community/2008-October/034477.html this message].

2. Alternatively, use ''edje-decc'' to decompile the theme back to config files and images and what-not, manually edit the aforementioned parts, and recompile with ''edje-cc''. These two tools should be available in your friendly package feed for your Freerunner as ''edje-tools'', and possibly for your desktop linux. This is the method explained below.

Edje uses *.edj Files as binary-configuration files and *.edc as the source of such an *.edj file.

= Installing the Edge compiler/decompiler =

== Installation on Ubuntu ==
You can install edje_cc and edje_decc for Ubuntu by adding this source to your /etc/apt/sources.lst:
<pre>
deb http://e17.dunnewind.net/ubuntu hardy e17
or
deb http://e17.dunnewind.net/ubuntu gutsy e17
or
deb http://e17.dunnewind.net/ubuntu feisty e17
</pre>
After that you can install the needed tools with:
<pre>sudo apt-get update && sudo apt-get install libedje-bin</pre>

Note: It appears only packages for hardy exist there at this point.

== Installation on Debian ==
The packages for Ubuntu look like they are compatible with debian.
Verified is: feisty<->lenny

Unfortunately, something seems to be broken in recompiling the edjefiles. edje_cc reports syntax errors in fso.edj file; but that comes maybe from the file itself. Maybe edje_cc from ubuntu is just outdated?

It looks like edje is available in [http://packages.debian.org/libedje-bin debian] unstable.

== Installation on Freerunner ==
To compile/decompile Edje files directly at your freerunner, you first need to install several packages.
You need at least ''edje-utils'' which provides the compiler and decompiler tools.
Depending on the contents of the theme, you need additional modules which are provided by ''libevas-*'' packages.
For example, to be able to load and save JPG files, you need both the ''libevas-loader-jpeg'' and ''libevas-saver-jpg'' packages.

To successfully compile .edj files, you also need a C++ compiler and the embryo_cc scripting language compiler installed.

This line should get you started:
<pre>
opkg install edje-utils libevas-loader-jpeg libevas-loader-png libevas-saver-jpeg libevas-saver-png
</pre>

To decompile an theme, just type:
<pre>
root@om-gta02:/usr/share/enlightenment/data/themes# edje_decc illume.edj
</pre>

To recompile, you can use edje_cc, but most theme files have a build.sh bundled that provides the neccessary parameters:
<pre>
root@om-gta02:/usr/share/enlightenment/data/themes/illume# ./build.sh
</pre>

= Example: changing wallpaper =

This walkthrough example is divided into two sections. The first one describes how to get a background image if one has not set one before. In this case, also the second section must be performed, which describes, how you can exchange an already set background image if you followed this tutorial.

== First time to set a background image ==
* ssh to your freerunner
* Install edje-utils:
<pre>
opkg install edje-utils libevas-loader-jpeg libevas-loader-png libevas-saver-jpeg libevas-saver-png
</pre>
* cd to the theme directory and decompile the default theme with edje_dcc:

<pre>
root@om-gta02:~# cd /usr/share/enlightenment/data/themes
root@om-gta02:/usr/share/enlightenment/data/themes# edje_decc illume.edj
</pre>

* now you have a new directory "illume". Edit the file ''freerunner.edc'' inside it.
* there, add the following code (Please note, that this works for an image with 480x640 pixels. If you have other sizes, adjust min/max/align/aspect):
<pre>
/*** DEFAULT WALLPAPER ***/
group { name: "e/desktop/background";
images{
image: "background.png" COMP;
}
parts {
part {
name: "base";
description {
state: "default" 0.0;
color: 238 238 236 255;
image.normal: "background.png";
min: 480 640;
max: 480 640;
align: 0.0 1.0;
aspect: 1.0 1.0;
}
}
}
}
</pre>
* prepare a symlink so updating is more easy if you want to change again later:
root@om-gta02:/usr/share/enlightenment/data/themes# ln -s illume/illume.edj illume_mytheme.edj
* replace the theme symlink to point to your one:
root@om-gta02:/usr/share/enlightenment/data/themes# rm illume.edj; ln -s illume_mytheme.edj illume.edj

== Exchanging background again ==
* scp your ''background.png'' image from host-pc to freerunner:
<pre>
scp background.png moko:/usr/share/enlightenment/data/themes/illume/
</pre>
* on freerunner, recompile the theme
<pre>
root@om-gta02:/usr/share/enlightenment/data/themes/illume# ./build.sh
</pre>
* restart x and enjoy your new background. If you want to change it again, you only need to copy over the new image, recompile the Edje file and reload X:
<pre>
root@om-gta02:~# /etc/init.d/xserver-nodm restart
</pre>

= Example: hiding the "Install" Bar =
<pre>
>> I have removed the assassin installer so it doesn't show up any more
>> (I do everything command line while ssh'd in) and I want to get rid
>> of the bottom thing with the little pluses. Is this a possibility?
>>
> It should be quite easy. Just decompile the edj file, edit the
> proper section (compare to the tango freerunner.edc file) and recompile
> it back.
>
Not so simple, but it seems to be the right place... check for "*" or
"+", they are in the .edc In place, I've added the value "Bar;" in the Categories of
"qtopia-clock.desktop" and "qtopia-ringtones.desktop" to get these two
appli accessible from the bottom bar.
</pre>
Reference: http://lists.openmoko.org/pipermail/community/2008-September/031188.html

= Troubleshooting =
If something goes wrong at compiling time, there is most certainly something wrong in your freerunner.edc file. The problem is, that edjecc will complain with cryptical text.
Check if all files referenced are really there and if no syntax errors are present.

In order to install the new theme, it must be referenced (see above) and illume must be restarted.

= Links =
* [http://docs.enlightenment.org/api/edje/edje-reference.pdf docs.enlightenment.org] - offical edje documentation
* [http://52grad.de/.stuff/freerunner/ 52grad.de] - example on using edj files
* [http://trac.enlightenment.org/e/export/36203/trunk/THEMES/b_and_w/theme.edc example theme file] - with LOTS of comments

[[Category:Settings]]
[[Category:System Developers]]

Android/ru

2008-11-06T18:57:08Z

Narmo: New page: {{Languages|Android}} {{Distributions|Android}} = Обновления = * 20081104 Первый образ Android был создан Шоном МакНейлом! Вы можете ...

{{Languages|Android}}
{{Distributions|Android}}

= Обновления =

* 20081104 Первый образ Android был создан Шоном МакНейлом! Вы можете его потестировать: [http://people.openmoko.org/sean_mcneil/ образ ядра и файловой системы Android] - SMS и звонки работают, WiFi и Bluetooth - пока нет. [http://onlinedev.blogspot.com/2008/11/porting-android-phase-3-done.html ''источник новости'']
* 20081029 [[User:Cfriedt]] [http://benno.id.au Benno] модифицировал систему сборки Android, так что теперь она создаёт образ JFFS2 вместо YAFFS. Unlike JFFS2, which [http://64.233.169.104/search?q=cache:e8czlAdKTn0J:gentoo-wiki.com/JFFS2/Mounting+gentoo+jffs2&hl=en&ct=clnk&cd=1&gl=ca&client=firefox-a can be mounted read-only from an image], mounting a YAFFS image is not possible unless it's already been written to flash (it complains about the block device being of type '1' and not 'NAND'). JFFS2 also has the benefit that it's a standard OpenMoko image format (See [[Flashing the Neo FreeRunner]] or [[Flashing the Neo 1973]])
* 20081023 [[User:Bricode]] To track the status of which parts of the Android source tree contain ARMv5 specific code, I've created a table of where it is contained, and the status of patches. It can be found at: http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw
* 20081022 [[User:Cfriedt]] I was able to 'trivially' compile all of the Android source code without error for the ARMv4T architecture by removing v5TE instructions. Although it will definitely not run anything predictably, at least now that I know the build system will work with a few simple substitutions in build/core/combo/arm-linux.mk. At this point I am able to go ahead and re-implement v5TE instructions as v4T instruction sequences instead (or re-implement entire sections of assembly with hand-optimized v4T instructions).
* 20081021 [[User:Cfriedt]] Android -> FreeRunner updates on my [http://perpetual-notion.blogspot.com/search/label/android blog]
* 20081021 Google released the majority [http://source.android.com/download source code] for the phone under Apache free and open-source [http://source.android.com/license license], with portions covered by other existing licenses, such as the Linux kernel under GPLv2.
* 200810?? [http://www.koolu.com Koolu.com] has announced that they will be '''selling the OpenMoko Freerunner with Android pre-installed''' beginning in November 2008, as well as offering '''free downloads of the Freerunner port of Android''' to existing Freerunner owners. Well-known open-source advocate [http://koolu.com/The-Koolu-Team/maddog.html Jon "maddog" Hall] is CTO and Ambassador for Koolu.

= Вступление =
Эта страница посвящена портированию [http://www.android.com Android OS] на устройства [[Neo 1973]] и [[Neo FreeRunner]]. С момента, как Android OS была [http://source.android.com/posts/opensource выпущена] 2008-10-21, [http://benno.id.au/blog/2007/11/21/android-neo1973 работа] по портированию Android на [[Neo1973 Hardware|Neo 1973]] и [[Neo_FreeRunner_GTA02_Hardware|FreeRunner]] [http://perpetual-notion.blogspot.com/search/label/android продолжается] и [http://groups.google.com/group/android-porting продолжается].

== Goals ==
# Systematically introduce patches for ARMv4T in the Android codebase
# Provide Neo1973 and Neo FreeRunner hardware-dependent patches in the Android codebase, leveraging the work already done by the Openmoko developers, without forcing Android-specific changes upstream
# Provide a useable Android filesystem and kernel on the [[Distributions]] page that conform to current Openmoko installation routines

== Early Attempts ==
As [http://benno.id.au Ben Leslie] had pointed out on his [http://benno.id.au/blog/2007/11/21/android-neo1973 blog] far before the source code was released, [http://www.android.com Android] was originally designed to work with the ARMv5TE [http://en.wikipedia.org/wiki/Instruction_set_architecture instruction set architecture] (ISA), which allows for [http://en.wikipedia.org/wiki/ARM_architecture#DSP_Enhancement_Instructions DSP enhanced instructions]. Contrary to the ARMv5TE ISA, the Neo1973 and FreeRunner handsets both feature an arm920t core, which comply to the ARMv4T ISA.

Before the source code was released, kernel trap handlers were implemented to 'emulate' the ARMv5TE ISA. Although the results worked in many cases, trapping is costly and performance suffered as a result. Moreover, without explicitly knowing which conditions were set by various instructions, such as Thumb Mode execution, the result became nondeterministic.

== Current State ==

With the release of the Android [http://source.android.com source code], the Open Source community is no longer limited to dealing with a binary-only product. The Open Handset Alliance (OHA) has let their source code become their product for everyone enrich and benefit from.

Currently, porting efforts are underway in many circles. Patches should be submitted via the [http://source.android.com/submit-patches official Android channels].

To track the status of which parts of the Android source tree contain ARMv5 specific code, I've created a table of where it is contained, and the status of patches. It can be found at: http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw [[User:Bricode]]

[[User:Seanmcneil3|Sean McNeil]] said that he was able to get Androind running (including telephony) in his Freerunner [http://3v1n0.tuxfamily.org/tumblelog/post/368 source].

Ben Leslie mentioned on the android-porting list that he was able to get the 'Android' logo to appear on his Neo 1973.

= How to Help =

== Getting Started ==

You can start by following the instructions to download and build the Android source from scratch. Please see [http://source.android.com/download http://source.android.com/download] and follow the instructions for your architecture.

== Publicize Your Efforts ==

It's generally a good idea to make your efforts known via wiki systems, public mailing lists, forums, and publically open version control systems.

Always take credit for your work but please don't do it in the form of comments. Some code is already hard enough to read without comments polluting the text. The best thing to do is to create a patch and put a header with your information at the top. Collaboration systems such as git might already do this for you (??).

If you create something new and have the ability to designate the license for it, please consider license compatibility issues.

== Porting Strategy ==

* Analysis and leverage of the existing build system
** buid/core/combo/arm-linux.mk
*** -D__ARCH_ARM_4__ -D__ARCH_ARM_4T__
*** -march=armv4t -mcpu=arm920t
** fix various static references to 'armv5'
* Isolating ARMv5TE ISA dependent code
** e.g. grep -n -R -i "${armv5te_isa_pattern}" ~/android
* Abstracting
** ( C/C++ )
*** Use inlined functions / #ifdef statments to implement functions in a portable manner
*** For inlined assembler calls, it's acceptable for now to use generic C code instead, so long as later on we optimize it by hand.
** ( ASM )
*** Proprocessor statements based on ISA / architecture, e.g. #ifdef __ARCH_ARM_5__ ... #endif #ifdef __ARCH_ARM_4__ ... #endif
*** It's highly suggested that preprocessor statements should not be nested (i.e. make them mutually exclusive)
*** Some people have suggested that we should not do #ifdef's based on ARCH or ISA, but rather based on an AndroidConfig.h which would define macros like PLD(...) #ifdef HAVE_ARM_PLD pld #else ... #endif .

For each ARMv5TE instruction, one could potentially
* Implement the instruction using general registers instead of DSP calls (i.e. eabi / softfloat)
* If that is a) nondeterministic, or b) slow, then sections of code need to be analyzed and hand-optimized for the ARMv4T isa

== List of Unsupported Instructions ==

This is a list of opcodes, extracted from the Android source, that are unsupported for ARMv4T compliant processors (specifically the arm920t). The opcodes represent instructions available for ARMv5, ARMv5T, and ARMv5TE architectures, which are not present in the ARMv4T ISA. The list was obtained by exhaustively editing the recompiling the Android source code until it compiled without error.

Please keep in mind, that in some cases, translating these instructions into a sequence of ARMv4T instructions will be impossible and / or result in nondeterministic execution because of
* the requirement of additional context
* the tendencies of certain opcodes to change condition registers that may or may not be present in the arm920t core

=== Opcodes ===

{{scroll box|height=480px|text=
<TABLE BORDER="1">
<TR>
<TH>Opcode</TH>
<TH>Desription</TH>
<TH>[[http://www.arm.com/miscPDFs/14128.pdf PDF]] Page Number</TH>
<TH>C</TH>
<TH>ASM</TH>
</TR>
<TR>
<TH VALIGN="TOP">BLX(1)</TH>
<TD>Branch, Link, and Exchange</TD>
<TD>166</TD>
<TD>N/A (Unused in Android)</TD>
<TD>N/A (Unused in Android)</TD>
</TR>
<TR>
<TH VALIGN="TOP">BLX(2)</TH>
<TD>Branch, Link, and Exchange</TD>
<TD>168</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_BLX
... (inline asm) ...
#else
... (inline asm with equivalent blx code, as shown to the right) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_BLX
#define BLX(a) \
blx a
#else
#define BLX(a) \
mov pc,lr \
bx a
#endif
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">CLZ</TH>
<TD>Count Leading Zeros</TD>
<TD>175</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_CLZ
... (inline asm) ...
#else
... (inline asm with equivalent clz code, as shown to the right) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081029
<pre>
#ifdef HAVE_CLZ
#define CLZ(Rd,Rm) \
clz Rd,Rm
#else
#define CLZ(Rd,Rm) \
...
#endif
...
CLZ(Rd,Rm)
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">LDRD</TH>
<TD>Load Registers Doubleword</TD>
<TD>200</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute different inline assembly code with something like
<pre>
#ifdef HAVE_LDRD
... (inline asm) ...
#else
... (inline asm with ldrd substituted) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_LDRD
#define LDRD(a,b) \
ldrd a,b
#else
#define LDRD(a,b) \
...
#endif
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">PLD</TH>
<TD>Preload Data</TD>
<TD>240</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_PLD
... (inline asm) ...
#else
... (inline asm with pld removed) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove or substitute with a macro reference such as
<pre>
#ifdef HAVE_PLD
#define PLD(a,b) \
pld a,b
#else
#define PLD(a,b)
#endif
...
PLD(r0,#0)
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLA<x><y></TH>
<TD>Signed Multiply-Accumulate</TD>
<TD>291</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLAL<x><y></TH>
<TD>Signed Multiply Accumulate Long</TD>
<TD>298</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLAW<y></TH>
<TD>Signed Multiply-Accumulate Word</TD>
<TD>302</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMUL<x><y></TH>
<TD>Signed Multiply</TD>
<TD>316</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMULW<y></TH>
<TD>Signed Multiply Word</TD>
<TD>320</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QADD</TH>
<TD>Saturating Add</TD>
<TD>242</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QDADD</TH>
<TD>Saturating Double and Add</TD>
<TD>249</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QDSUB</TH>
<TD>Saturating Double and Subtract</TD>
<TD>251</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QSUB</TH>
<TD>Saturating Subtract</TD>
<TD>253</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">STRD</TH>
<TD>Store Registers Doubleword</TD>
<TD>349</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute different inline assembly code with something like
<pre>
#ifdef HAVE_STRD
... (inline asm) ...
#else
... (inline asm without strd) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_STRD
#define STRD(a,b) \
strd a,b
#else
#define STRD(a,b) \
...
#endif
</pre>

</TD>
</TR>
</TABLE>
}}

=== Scanning for Files That Use the ARMv5TE ISA ===

Using the above list of opcodes, one can scan the Android source code for ARMv4T-incompatible instruction sequences.

'''Code:'''
{{scroll box|height=240px|text=
<pre>
#!/bin/sh

# $1 is the android directory

if [ $# -ne 1 ]; then
exit -1
fi

cd "${1}"

opcodes="blx clz ldrd pld smlabb smlabt smlatt
smlal smlawb smlawt smulbb smulbt smultt smulwb
smulwt qadd qdadd qdsub qsub strd"

for op in ${opcodes}; do

echo "* ${op} ====================================="

if [ ! -e .files.${op} ]; then

files="$(grep -R -i "${op} " * 2>/dev/null)"
files="$(echo $files | grep -v "^Binary file" | sed -e 's/:.*//')"
files="$(echo $files| grep -v "CREDIT\|README\|^$kernel/\|.git/$\|$\.txt$$" | sort -u)"

echo "${files}" > .files.${op}

else
files="$(cat .files.${op})"
fi

for fil in ${files}; do
lines="$(grep -n -i "${op} " ${fil} | sed -e 's/:.*//g' )"
lines="$(echo $lines | sed -e 's/ /,/g')"
echo "** ${fil}: lines {${lines}}"
done
done
</pre>
}}

=== Source Files in Android that Use the ARMv5TE ISA ===

The list of files below may or may not be complete. There might also be some assembly code that is generated with a python script (verification?).

{{scroll box|height=150px|text=
* blx =====================================
** bionic/libc/tools/gensyscalls.py: lines {168,186}
** bootloader/legacy/nandwrite/init.S: lines {77}
** bootloader/legacy/usbloader/init.S: lines {95}
** dalvik/vm/arch/arm/CallEABI.S: lines {239}
** dalvik/vm/arch/arm/CallOldABI.S: lines {145}
** development/emulator/qtools/thumbdis.cpp: lines {187,265}
** external/qemu/target-arm/translate.c: lines {1151,1971,2444}
** external/qemu/trace.c: lines {774,1353,1358}
** system/core/libpixelflinger/codeflinger/disassem.c: lines {416}
* clz =====================================
** development/emulator/qtools/armdis.cpp: lines {654}
** external/opencore/codecs_v2/audio/aac/dec/src/pv_normalize.h: lines {67,84}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/norm_l.h: lines {137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/normalize_amr_wb.h: lines {78,95}
** external/opencore/codecs_v2/audio/mp3/dec/src/pvmp3_normalize.h: lines {67,84}
** external/opencore/codecs_v2/video/avc_h264/dec/src/vlc.cpp: lines {23}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/vlc_encode_inline.h: lines {125,162,168,204,218}
** external/qemu/target-arm/translate.c: lines {1247}
** external/skia/libcorecg/Sk64.cpp: lines {340,341,343}
** external/skia/libcorecg/SkMatrix.cpp: lines {500,501}
** external/skia/libsgl/effects/SkColorMatrixFilter.cpp: lines {135}
** external/skia/libsgl/sgl/SkBitmap.cpp: lines {945,946,947}
** external/skia/libsgl/sgl/SkBitmapShader.cpp: lines {32,33,34}
** external/skia/libsgl/sgl/SkGraphics.cpp: lines {429,437}
* ldrd =====================================
** dalvik/vm/mterp/armv5/OP_AGET_WIDE.S: lines {28}
** dalvik/vm/mterp/armv5/OP_IGET_WIDE.S: lines {37}
** dalvik/vm/mterp/armv5/OP_IGET_WIDE_QUICK.S: lines {10}
** dalvik/vm/mterp/armv5/OP_SGET_WIDE.S: lines {17}
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2653,7464,8318,8390}
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {40,41,42,43}
* pld =====================================
** bionic/libc/arch-arm/bionic/memcmp.S: lines {37,44,45,56,57,107,108,195,196}
** bionic/libc/arch-arm/bionic/memcmp16.S: lines {37,44,45,67,68,116,117,198,199}
** bionic/libc/arch-arm/bionic/memcpy.S: lines {55,56,57,145,266,293,320}
** bionic/libc/arch-arm/bionic/strlen.c: lines {59,65}
** bionic/libc/kernel/arch-arm/asm/arch/irqs.h: lines {162}
** external/elfutils/src/Makefile: lines {243}
** external/elfutils/src/Makefile.am: lines {32}
** external/elfutils/src/Makefile.in: lines {243}
** external/jpeg/jidctfst.S: lines {69,235,247}
** external/qemu/target-arm/translate.c: lines {1149}
** system/core/libpixelflinger/codeflinger/ARMAssembler.cpp: lines {368}
** system/core/libpixelflinger/codeflinger/ARMAssemblerInterface.cpp: lines {104,108,117}
** system/core/libpixelflinger/t32cb16blend.S: lines {111,112,134,143}
* smlabb =====================================
** external/jpeg/jidctfst.S: lines {110,115,155,156}
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {584,589}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {147,166}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {120,129}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {514,533}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {418,429}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {202}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {250}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {119,155,167,278,326,341}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {178,225,437,517}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {405,436}
* smlabt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {184}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {138}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {131,143,294,310}
* smlatt =====================================
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {585,590}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {157}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {441}
* smlal =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4.h: lines {179,223,236,257,267}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4_gcc.h: lines {264,341}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {178,188,198}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9.s: lines {84,90,96,101,109,114,116,118,121,132,138,150,163,165,167,174,176,178}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9_gcc.s: lines {73,79,86,90,98,103,105,107,110,121,127,139,152,154,156,163,165,167}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.asm: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.s: lines {145,164,180,190,194,201,209,219,227,233,239,243,246}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18_gcc.s: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.asm: lines {62,63,66,72,76,77,81,82,85,90,94,97,99,100,103,108,113,114,118,119,122,129,136,137,176,179,183,187,190,193}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.s: lines {67,68,71,77,81,82,86,87,90,95,99,102,104,105,108,113,118,119,123,124,127,134,141,142,181,184,188,192,195,198}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window_gcc.s: lines {65,66,69,75,79,80,84,85,88,93,97,100,102,103,106,111,116,117,121,122,125,132,139,140,179,182,186,190,193,196}
** external/opencore/codecs_v2/audio/mp3/dec/src/pv_mp3dec_fxd_op_arm.h: lines {148}
** external/qemu/trace.c: lines {813}
** frameworks/base/opengl/libagl/iterators.S: lines {66,67}
** frameworks/base/opengl/libagl/matrix.h: lines {67,68,96,126,127,282,283,314,315,316}
* smlawb =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {203,259}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {166,416}
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {93,109}
** frameworks/base/opengl/libagl/matrix.h: lines {163,203}
* smlawt =====================================
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {114}
** frameworks/base/opengl/libagl/matrix.h: lines {162,202,243,244}
* smulbb =====================================
** external/jpeg/jidctfst.S: lines {109,114,151,153}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {79}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {71,81}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {207,251,297,348,361,375,427,440,487}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {199,234,274,314,316,326,367,369,404}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {121,137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {123,142}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {122,140}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {132,134,138,164,177,191}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {127,129,150,163}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mult.h: lines {121,141}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {115,139,151,163,189,190,212}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {112,113,164,183,201,218,265}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {250,457,531}
** external/skia/include/corecg/SkMath.h: lines {170}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {420,462}
** system/core/libpixelflinger/t32cb16blend.S: lines {39,66,74,82}
* smulbt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {115}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {109}
** system/core/libpixelflinger/codeflinger/texturing.cpp: lines {1091}
** system/core/libpixelflinger/t32cb16blend.S: lines {47,55}
* smultt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {131}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {100}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {467}
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {73}
* smulwb =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {221}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {373}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {222}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {283}
** external/opencore/codecs_v2/audio/sbc/enc/src/sbcenc_filter.h: lines {33}
** frameworks/base/opengl/libagl/matrix.h: lines {161,201,242}
* smulwt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {202,240}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {385,415}
* qadd =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {64}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {60}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {130,256}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {128,235}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_add.h: lines {122,137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {123,145}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {71,102,152,176,192}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {91,115,148,202,234}
** external/openssl/crypto/bn/bn_prime.c: lines {454,455}
* qdadd =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/calc_sbr_synfilterbank.cpp: lines {116,162}
** external/opencore/codecs_v2/audio/aac/dec/src/trans4m_freq_2_time_fxp.cpp: lines {472,494}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {212,356,370,385,435,449}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {200,315,321,331,368,371}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {122,142}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {133,136,140,172,186,201}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {128,131,158,172}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {116}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {184}
* qdsub =====================================
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {302}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {275}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {124,147}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {140}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {165}
* qsub =====================================
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {167}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {162}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_sub.h: lines {121,138}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {88,127}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {70,133}
* strd =====================================
** dalvik/vm/mterp/armv5/OP_APUT_WIDE.S: lines {31}
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE.S: lines {39}
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE_QUICK.S: lines {14}
** dalvik/vm/mterp/armv5/OP_SPUT_WIDE.S: lines {21}
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2834,7530,8331,8542}
** dalvik/vm/oo/Object.h: lines {589}
** external/opencore/fileformats/avi/parser/include/pv_avifile_streamlist.h: lines {179}
** external/opencore/fileformats/avi/parser/src/pv_avifile_streamlist.cpp: lines {153}
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {47,52,56,60}
}}

=== Discussion ===
=== Notes ===
The file
<pre>
system/core/libpixelflinger/codeflinger/ARMAssembler.cpp
</pre>

will need special attention. It's responsible for dynamic generation of DSP code.

== Suggestions ==
* [[User:Cfriedt]] 20081024 I'm not sure how feasible this is, given that the [http://wiki.openmoko.org/wiki/Neo_FreeRunner_Hardware_Issues#SMedia_3362_Documentation_.26_OpenGL_ES_Drivers SMedia 3362 is heavily NDA'd]. However, since the arm920t lacks a floating-point unit / DSP core, is it possible to use the SMedia chip for general-purpose math? This would help in the Android platform, at least, for things like audio and video codecs. Aside from an OpenGL ES driver, OpenMoko documentation for the SMedia would be highly appreciated.

= Important Links =
(Please Update Me)

== Documentation ==
* [http://source.android.com/documentation Android Documentation]
* [http://www.arm.com/documentation/ ARM Documentation], (keywords: armv4t, armv5t, armv5te, arm920t, arm926ej-s)
* [http://www.arm.com/miscPDFs/9658.pdf ARM Assembly Language Programming]
* [http://www.cse.unsw.edu.au/~cs3221/labs/assembler-intro.pdf An Introduction to the GNU Assembler]
* [http://www.heyrick.co.uk/assembler/apcsintro.html ARM Procedure Call Standard], [http://en.wikipedia.org/wiki/Calling_convention#ARM ARM Calling Conventions]

== Instruction Set References ==
* [http://www.arm.com/miscPDFs/14128.pdf ARM Architecture Reference Manual], The definitive ISA documentation
* [http://www.simplemachines.it/doc/QRC0001H_rvct_v2.1_arm.pdf ARM Instruction Set Quick Reference Card]
* [http://infocenter.arm.com/help/topic/com.arm.doc.qrc0001l/QRC0001_UAL.pdf ARM and Thumb -2 Instruction Set Quick Reference Card]
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0025b/DVI0025.pdf ARMv4T] (See section 1.4.13)
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0014a/DVI0014A_ARM10T_PO.pdf ARMv5T] (See section 4.16)
* [http://www.arm.com/pdfs/ARM-DSP.pdf ARM DSP Enhanced Instruction Set]
* [http://infocenter.arm.com/help/topic/com.arm.doc.ihi0042c/IHI0042C_aapcs.pdf Procedure Call Standard for the ARM Architecture]

== Hardware Reference ==

* [[Neo1973 Hardware]]
* [[Neo FreeRunner GTA02 Hardware]]

== Communities ==
* [http://source.android.com/discuss Android Public Mailing Lists]
** Specifically, [http://groups.google.com/group/android-porting android-porting]
* [http://lists.openmoko.org/mailman/listinfo OpenMoko Mailing Lists]
** Specifically, [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel openmoko-kernel]
* [http://forum.koolu.org/viewforum.php?f=10 Android on FreeRunner] at KoolU.com
* [[Openmoko Local Groups]]
* [[Openmoko:Community_Portal]]

= See also =

* [[Debug_Board]]

= External Links =

Android

2008-11-06T18:30:16Z

Narmo:

{{Languages|Android}}
{{Distributions|Android}}

= Updates =

* 20081104 The first Android-image has been successfully created by Sean McNeil! You can try on your own: [http://people.openmoko.org/sean_mcneil/ android image and kernel] - sms and calling works, wifi and bluetooth doesn't. [http://onlinedev.blogspot.com/2008/11/porting-android-phase-3-done.html ''news-source'']
* 20081029 [[User:Cfriedt]] [http://benno.id.au Benno] has modified Android's build system so that it will output a JFFS2 image instead of YAFFS . Unlike JFFS2, which [http://64.233.169.104/search?q=cache:e8czlAdKTn0J:gentoo-wiki.com/JFFS2/Mounting+gentoo+jffs2&hl=en&ct=clnk&cd=1&gl=ca&client=firefox-a can be mounted read-only from an image], mounting a YAFFS image is not possible unless it's already been written to flash (it complains about the block device being of type '1' and not 'NAND'). JFFS2 also has the benefit that it's a standard OpenMoko image format (See [[Flashing the Neo FreeRunner]] or [[Flashing the Neo 1973]])
* 20081023 [[User:Bricode]] To track the status of which parts of the Android source tree contain ARMv5 specific code, I've created a table of where it is contained, and the status of patches. It can be found at: http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw
* 20081022 [[User:Cfriedt]] I was able to 'trivially' compile all of the Android source code without error for the ARMv4T architecture by removing v5TE instructions. Although it will definitely not run anything predictably, at least now that I know the build system will work with a few simple substitutions in build/core/combo/arm-linux.mk. At this point I am able to go ahead and re-implement v5TE instructions as v4T instruction sequences instead (or re-implement entire sections of assembly with hand-optimized v4T instructions).
* 20081021 [[User:Cfriedt]] Android -> FreeRunner updates on my [http://perpetual-notion.blogspot.com/search/label/android blog]
* 20081021 Google released the majority [http://source.android.com/download source code] for the phone under Apache free and open-source [http://source.android.com/license license], with portions covered by other existing licenses, such as the Linux kernel under GPLv2.
* 200810?? [http://www.koolu.com Koolu.com] has announced that they will be '''selling the OpenMoko Freerunner with Android pre-installed''' beginning in November 2008, as well as offering '''free downloads of the Freerunner port of Android''' to existing Freerunner owners. Well-known open-source advocate [http://koolu.com/The-Koolu-Team/maddog.html Jon "maddog" Hall] is CTO and Ambassador for Koolu.

= Introduction =
This page is dedicated to porting the [http://www.android.com Android OS] to the [[Neo 1973]] and [[Neo FreeRunner]] handsets. Since the Android OS was [http://source.android.com/posts/opensource publically released] on 20081021, [http://benno.id.au/blog/2007/11/21/android-neo1973 work] [http://perpetual-notion.blogspot.com/search/label/android is] [http://groups.google.com/group/android-porting currently underway] to port Android to the [[Neo1973 Hardware|Neo 1973]] and [[Neo_FreeRunner_GTA02_Hardware|FreeRunner]] handsets.

== Goals ==
# Systematically introduce patches for ARMv4T in the Android codebase
# Provide Neo1973 and Neo FreeRunner hardware-dependent patches in the Android codebase, leveraging the work already done by the Openmoko developers, without forcing Android-specific changes upstream
# Provide a useable Android filesystem and kernel on the [[Distributions]] page that conform to current Openmoko installation routines

== Early Attempts ==
As [http://benno.id.au Ben Leslie] had pointed out on his [http://benno.id.au/blog/2007/11/21/android-neo1973 blog] far before the source code was released, [http://www.android.com Android] was originally designed to work with the ARMv5TE [http://en.wikipedia.org/wiki/Instruction_set_architecture instruction set architecture] (ISA), which allows for [http://en.wikipedia.org/wiki/ARM_architecture#DSP_Enhancement_Instructions DSP enhanced instructions]. Contrary to the ARMv5TE ISA, the Neo1973 and FreeRunner handsets both feature an arm920t core, which comply to the ARMv4T ISA.

Before the source code was released, kernel trap handlers were implemented to 'emulate' the ARMv5TE ISA. Although the results worked in many cases, trapping is costly and performance suffered as a result. Moreover, without explicitly knowing which conditions were set by various instructions, such as Thumb Mode execution, the result became nondeterministic.

== Current State ==

With the release of the Android [http://source.android.com source code], the Open Source community is no longer limited to dealing with a binary-only product. The Open Handset Alliance (OHA) has let their source code become their product for everyone enrich and benefit from.

Currently, porting efforts are underway in many circles. Patches should be submitted via the [http://source.android.com/submit-patches official Android channels].

To track the status of which parts of the Android source tree contain ARMv5 specific code, I've created a table of where it is contained, and the status of patches. It can be found at: http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw [[User:Bricode]]

[[User:Seanmcneil3|Sean McNeil]] said that he was able to get Androind running (including telephony) in his Freerunner [http://3v1n0.tuxfamily.org/tumblelog/post/368 source].

Ben Leslie mentioned on the android-porting list that he was able to get the 'Android' logo to appear on his Neo 1973.

= How to Help =

== Getting Started ==

You can start by following the instructions to download and build the Android source from scratch. Please see [http://source.android.com/download http://source.android.com/download] and follow the instructions for your architecture.

== Publicize Your Efforts ==

It's generally a good idea to make your efforts known via wiki systems, public mailing lists, forums, and publically open version control systems.

Always take credit for your work but please don't do it in the form of comments. Some code is already hard enough to read without comments polluting the text. The best thing to do is to create a patch and put a header with your information at the top. Collaboration systems such as git might already do this for you (??).

If you create something new and have the ability to designate the license for it, please consider license compatibility issues.

== Porting Strategy ==

* Analysis and leverage of the existing build system
** buid/core/combo/arm-linux.mk
*** -D__ARCH_ARM_4__ -D__ARCH_ARM_4T__
*** -march=armv4t -mcpu=arm920t
** fix various static references to 'armv5'
* Isolating ARMv5TE ISA dependent code
** e.g. grep -n -R -i "${armv5te_isa_pattern}" ~/android
* Abstracting
** ( C/C++ )
*** Use inlined functions / #ifdef statments to implement functions in a portable manner
*** For inlined assembler calls, it's acceptable for now to use generic C code instead, so long as later on we optimize it by hand.
** ( ASM )
*** Proprocessor statements based on ISA / architecture, e.g. #ifdef __ARCH_ARM_5__ ... #endif #ifdef __ARCH_ARM_4__ ... #endif
*** It's highly suggested that preprocessor statements should not be nested (i.e. make them mutually exclusive)
*** Some people have suggested that we should not do #ifdef's based on ARCH or ISA, but rather based on an AndroidConfig.h which would define macros like PLD(...) #ifdef HAVE_ARM_PLD pld #else ... #endif .

For each ARMv5TE instruction, one could potentially
* Implement the instruction using general registers instead of DSP calls (i.e. eabi / softfloat)
* If that is a) nondeterministic, or b) slow, then sections of code need to be analyzed and hand-optimized for the ARMv4T isa

== List of Unsupported Instructions ==

This is a list of opcodes, extracted from the Android source, that are unsupported for ARMv4T compliant processors (specifically the arm920t). The opcodes represent instructions available for ARMv5, ARMv5T, and ARMv5TE architectures, which are not present in the ARMv4T ISA. The list was obtained by exhaustively editing the recompiling the Android source code until it compiled without error.

Please keep in mind, that in some cases, translating these instructions into a sequence of ARMv4T instructions will be impossible and / or result in nondeterministic execution because of
* the requirement of additional context
* the tendencies of certain opcodes to change condition registers that may or may not be present in the arm920t core

=== Opcodes ===

{{scroll box|height=480px|text=
<TABLE BORDER="1">
<TR>
<TH>Opcode</TH>
<TH>Desription</TH>
<TH>[[http://www.arm.com/miscPDFs/14128.pdf PDF]] Page Number</TH>
<TH>C</TH>
<TH>ASM</TH>
</TR>
<TR>
<TH VALIGN="TOP">BLX(1)</TH>
<TD>Branch, Link, and Exchange</TD>
<TD>166</TD>
<TD>N/A (Unused in Android)</TD>
<TD>N/A (Unused in Android)</TD>
</TR>
<TR>
<TH VALIGN="TOP">BLX(2)</TH>
<TD>Branch, Link, and Exchange</TD>
<TD>168</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_BLX
... (inline asm) ...
#else
... (inline asm with equivalent blx code, as shown to the right) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_BLX
#define BLX(a) \
blx a
#else
#define BLX(a) \
mov pc,lr \
bx a
#endif
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">CLZ</TH>
<TD>Count Leading Zeros</TD>
<TD>175</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_CLZ
... (inline asm) ...
#else
... (inline asm with equivalent clz code, as shown to the right) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081029
<pre>
#ifdef HAVE_CLZ
#define CLZ(Rd,Rm) \
clz Rd,Rm
#else
#define CLZ(Rd,Rm) \
...
#endif
...
CLZ(Rd,Rm)
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">LDRD</TH>
<TD>Load Registers Doubleword</TD>
<TD>200</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute different inline assembly code with something like
<pre>
#ifdef HAVE_LDRD
... (inline asm) ...
#else
... (inline asm with ldrd substituted) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_LDRD
#define LDRD(a,b) \
ldrd a,b
#else
#define LDRD(a,b) \
...
#endif
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">PLD</TH>
<TD>Preload Data</TD>
<TD>240</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_PLD
... (inline asm) ...
#else
... (inline asm with pld removed) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove or substitute with a macro reference such as
<pre>
#ifdef HAVE_PLD
#define PLD(a,b) \
pld a,b
#else
#define PLD(a,b)
#endif
...
PLD(r0,#0)
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLA<x><y></TH>
<TD>Signed Multiply-Accumulate</TD>
<TD>291</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLAL<x><y></TH>
<TD>Signed Multiply Accumulate Long</TD>
<TD>298</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLAW<y></TH>
<TD>Signed Multiply-Accumulate Word</TD>
<TD>302</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMUL<x><y></TH>
<TD>Signed Multiply</TD>
<TD>316</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMULW<y></TH>
<TD>Signed Multiply Word</TD>
<TD>320</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QADD</TH>
<TD>Saturating Add</TD>
<TD>242</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QDADD</TH>
<TD>Saturating Double and Add</TD>
<TD>249</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QDSUB</TH>
<TD>Saturating Double and Subtract</TD>
<TD>251</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QSUB</TH>
<TD>Saturating Subtract</TD>
<TD>253</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">STRD</TH>
<TD>Store Registers Doubleword</TD>
<TD>349</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute different inline assembly code with something like
<pre>
#ifdef HAVE_STRD
... (inline asm) ...
#else
... (inline asm without strd) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_STRD
#define STRD(a,b) \
strd a,b
#else
#define STRD(a,b) \
...
#endif
</pre>

</TD>
</TR>
</TABLE>
}}

=== Scanning for Files That Use the ARMv5TE ISA ===

Using the above list of opcodes, one can scan the Android source code for ARMv4T-incompatible instruction sequences.

'''Code:'''
{{scroll box|height=240px|text=
<pre>
#!/bin/sh

# $1 is the android directory

if [ $# -ne 1 ]; then
exit -1
fi

cd "${1}"

opcodes="blx clz ldrd pld smlabb smlabt smlatt
smlal smlawb smlawt smulbb smulbt smultt smulwb
smulwt qadd qdadd qdsub qsub strd"

for op in ${opcodes}; do

echo "* ${op} ====================================="

if [ ! -e .files.${op} ]; then

files="$(grep -R -i "${op} " * 2>/dev/null)"
files="$(echo $files | grep -v "^Binary file" | sed -e 's/:.*//')"
files="$(echo $files| grep -v "CREDIT\|README\|^$kernel/\|.git/$\|$\.txt$$" | sort -u)"

echo "${files}" > .files.${op}

else
files="$(cat .files.${op})"
fi

for fil in ${files}; do
lines="$(grep -n -i "${op} " ${fil} | sed -e 's/:.*//g' )"
lines="$(echo $lines | sed -e 's/ /,/g')"
echo "** ${fil}: lines {${lines}}"
done
done
</pre>
}}

=== Source Files in Android that Use the ARMv5TE ISA ===

The list of files below may or may not be complete. There might also be some assembly code that is generated with a python script (verification?).

{{scroll box|height=150px|text=
* blx =====================================
** bionic/libc/tools/gensyscalls.py: lines {168,186}
** bootloader/legacy/nandwrite/init.S: lines {77}
** bootloader/legacy/usbloader/init.S: lines {95}
** dalvik/vm/arch/arm/CallEABI.S: lines {239}
** dalvik/vm/arch/arm/CallOldABI.S: lines {145}
** development/emulator/qtools/thumbdis.cpp: lines {187,265}
** external/qemu/target-arm/translate.c: lines {1151,1971,2444}
** external/qemu/trace.c: lines {774,1353,1358}
** system/core/libpixelflinger/codeflinger/disassem.c: lines {416}
* clz =====================================
** development/emulator/qtools/armdis.cpp: lines {654}
** external/opencore/codecs_v2/audio/aac/dec/src/pv_normalize.h: lines {67,84}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/norm_l.h: lines {137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/normalize_amr_wb.h: lines {78,95}
** external/opencore/codecs_v2/audio/mp3/dec/src/pvmp3_normalize.h: lines {67,84}
** external/opencore/codecs_v2/video/avc_h264/dec/src/vlc.cpp: lines {23}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/vlc_encode_inline.h: lines {125,162,168,204,218}
** external/qemu/target-arm/translate.c: lines {1247}
** external/skia/libcorecg/Sk64.cpp: lines {340,341,343}
** external/skia/libcorecg/SkMatrix.cpp: lines {500,501}
** external/skia/libsgl/effects/SkColorMatrixFilter.cpp: lines {135}
** external/skia/libsgl/sgl/SkBitmap.cpp: lines {945,946,947}
** external/skia/libsgl/sgl/SkBitmapShader.cpp: lines {32,33,34}
** external/skia/libsgl/sgl/SkGraphics.cpp: lines {429,437}
* ldrd =====================================
** dalvik/vm/mterp/armv5/OP_AGET_WIDE.S: lines {28}
** dalvik/vm/mterp/armv5/OP_IGET_WIDE.S: lines {37}
** dalvik/vm/mterp/armv5/OP_IGET_WIDE_QUICK.S: lines {10}
** dalvik/vm/mterp/armv5/OP_SGET_WIDE.S: lines {17}
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2653,7464,8318,8390}
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {40,41,42,43}
* pld =====================================
** bionic/libc/arch-arm/bionic/memcmp.S: lines {37,44,45,56,57,107,108,195,196}
** bionic/libc/arch-arm/bionic/memcmp16.S: lines {37,44,45,67,68,116,117,198,199}
** bionic/libc/arch-arm/bionic/memcpy.S: lines {55,56,57,145,266,293,320}
** bionic/libc/arch-arm/bionic/strlen.c: lines {59,65}
** bionic/libc/kernel/arch-arm/asm/arch/irqs.h: lines {162}
** external/elfutils/src/Makefile: lines {243}
** external/elfutils/src/Makefile.am: lines {32}
** external/elfutils/src/Makefile.in: lines {243}
** external/jpeg/jidctfst.S: lines {69,235,247}
** external/qemu/target-arm/translate.c: lines {1149}
** system/core/libpixelflinger/codeflinger/ARMAssembler.cpp: lines {368}
** system/core/libpixelflinger/codeflinger/ARMAssemblerInterface.cpp: lines {104,108,117}
** system/core/libpixelflinger/t32cb16blend.S: lines {111,112,134,143}
* smlabb =====================================
** external/jpeg/jidctfst.S: lines {110,115,155,156}
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {584,589}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {147,166}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {120,129}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {514,533}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {418,429}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {202}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {250}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {119,155,167,278,326,341}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {178,225,437,517}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {405,436}
* smlabt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {184}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {138}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {131,143,294,310}
* smlatt =====================================
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {585,590}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {157}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {441}
* smlal =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4.h: lines {179,223,236,257,267}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4_gcc.h: lines {264,341}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {178,188,198}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9.s: lines {84,90,96,101,109,114,116,118,121,132,138,150,163,165,167,174,176,178}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9_gcc.s: lines {73,79,86,90,98,103,105,107,110,121,127,139,152,154,156,163,165,167}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.asm: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.s: lines {145,164,180,190,194,201,209,219,227,233,239,243,246}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18_gcc.s: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.asm: lines {62,63,66,72,76,77,81,82,85,90,94,97,99,100,103,108,113,114,118,119,122,129,136,137,176,179,183,187,190,193}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.s: lines {67,68,71,77,81,82,86,87,90,95,99,102,104,105,108,113,118,119,123,124,127,134,141,142,181,184,188,192,195,198}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window_gcc.s: lines {65,66,69,75,79,80,84,85,88,93,97,100,102,103,106,111,116,117,121,122,125,132,139,140,179,182,186,190,193,196}
** external/opencore/codecs_v2/audio/mp3/dec/src/pv_mp3dec_fxd_op_arm.h: lines {148}
** external/qemu/trace.c: lines {813}
** frameworks/base/opengl/libagl/iterators.S: lines {66,67}
** frameworks/base/opengl/libagl/matrix.h: lines {67,68,96,126,127,282,283,314,315,316}
* smlawb =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {203,259}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {166,416}
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {93,109}
** frameworks/base/opengl/libagl/matrix.h: lines {163,203}
* smlawt =====================================
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {114}
** frameworks/base/opengl/libagl/matrix.h: lines {162,202,243,244}
* smulbb =====================================
** external/jpeg/jidctfst.S: lines {109,114,151,153}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {79}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {71,81}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {207,251,297,348,361,375,427,440,487}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {199,234,274,314,316,326,367,369,404}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {121,137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {123,142}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {122,140}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {132,134,138,164,177,191}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {127,129,150,163}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mult.h: lines {121,141}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {115,139,151,163,189,190,212}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {112,113,164,183,201,218,265}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {250,457,531}
** external/skia/include/corecg/SkMath.h: lines {170}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {420,462}
** system/core/libpixelflinger/t32cb16blend.S: lines {39,66,74,82}
* smulbt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {115}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {109}
** system/core/libpixelflinger/codeflinger/texturing.cpp: lines {1091}
** system/core/libpixelflinger/t32cb16blend.S: lines {47,55}
* smultt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {131}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {100}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {467}
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {73}
* smulwb =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {221}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {373}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {222}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {283}
** external/opencore/codecs_v2/audio/sbc/enc/src/sbcenc_filter.h: lines {33}
** frameworks/base/opengl/libagl/matrix.h: lines {161,201,242}
* smulwt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {202,240}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {385,415}
* qadd =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {64}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {60}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {130,256}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {128,235}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_add.h: lines {122,137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {123,145}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {71,102,152,176,192}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {91,115,148,202,234}
** external/openssl/crypto/bn/bn_prime.c: lines {454,455}
* qdadd =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/calc_sbr_synfilterbank.cpp: lines {116,162}
** external/opencore/codecs_v2/audio/aac/dec/src/trans4m_freq_2_time_fxp.cpp: lines {472,494}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {212,356,370,385,435,449}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {200,315,321,331,368,371}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {122,142}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {133,136,140,172,186,201}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {128,131,158,172}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {116}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {184}
* qdsub =====================================
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {302}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {275}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {124,147}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {140}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {165}
* qsub =====================================
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {167}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {162}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_sub.h: lines {121,138}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {88,127}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {70,133}
* strd =====================================
** dalvik/vm/mterp/armv5/OP_APUT_WIDE.S: lines {31}
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE.S: lines {39}
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE_QUICK.S: lines {14}
** dalvik/vm/mterp/armv5/OP_SPUT_WIDE.S: lines {21}
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2834,7530,8331,8542}
** dalvik/vm/oo/Object.h: lines {589}
** external/opencore/fileformats/avi/parser/include/pv_avifile_streamlist.h: lines {179}
** external/opencore/fileformats/avi/parser/src/pv_avifile_streamlist.cpp: lines {153}
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {47,52,56,60}
}}

=== Discussion ===
=== Notes ===
The file
<pre>
system/core/libpixelflinger/codeflinger/ARMAssembler.cpp
</pre>

will need special attention. It's responsible for dynamic generation of DSP code.

== Suggestions ==
* [[User:Cfriedt]] 20081024 I'm not sure how feasible this is, given that the [http://wiki.openmoko.org/wiki/Neo_FreeRunner_Hardware_Issues#SMedia_3362_Documentation_.26_OpenGL_ES_Drivers SMedia 3362 is heavily NDA'd]. However, since the arm920t lacks a floating-point unit / DSP core, is it possible to use the SMedia chip for general-purpose math? This would help in the Android platform, at least, for things like audio and video codecs. Aside from an OpenGL ES driver, OpenMoko documentation for the SMedia would be highly appreciated.

= Important Links =
(Please Update Me)

== Documentation ==
* [http://source.android.com/documentation Android Documentation]
* [http://www.arm.com/documentation/ ARM Documentation], (keywords: armv4t, armv5t, armv5te, arm920t, arm926ej-s)
* [http://www.arm.com/miscPDFs/9658.pdf ARM Assembly Language Programming]
* [http://www.cse.unsw.edu.au/~cs3221/labs/assembler-intro.pdf An Introduction to the GNU Assembler]
* [http://www.heyrick.co.uk/assembler/apcsintro.html ARM Procedure Call Standard], [http://en.wikipedia.org/wiki/Calling_convention#ARM ARM Calling Conventions]

== Instruction Set References ==
* [http://www.arm.com/miscPDFs/14128.pdf ARM Architecture Reference Manual], The definitive ISA documentation
* [http://www.simplemachines.it/doc/QRC0001H_rvct_v2.1_arm.pdf ARM Instruction Set Quick Reference Card]
* [http://infocenter.arm.com/help/topic/com.arm.doc.qrc0001l/QRC0001_UAL.pdf ARM and Thumb -2 Instruction Set Quick Reference Card]
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0025b/DVI0025.pdf ARMv4T] (See section 1.4.13)
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0014a/DVI0014A_ARM10T_PO.pdf ARMv5T] (See section 4.16)
* [http://www.arm.com/pdfs/ARM-DSP.pdf ARM DSP Enhanced Instruction Set]
* [http://infocenter.arm.com/help/topic/com.arm.doc.ihi0042c/IHI0042C_aapcs.pdf Procedure Call Standard for the ARM Architecture]

== Hardware Reference ==

* [[Neo1973 Hardware]]
* [[Neo FreeRunner GTA02 Hardware]]

== Communities ==
* [http://source.android.com/discuss Android Public Mailing Lists]
** Specifically, [http://groups.google.com/group/android-porting android-porting]
* [http://lists.openmoko.org/mailman/listinfo OpenMoko Mailing Lists]
** Specifically, [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel openmoko-kernel]
* [http://forum.koolu.org/viewforum.php?f=10 Android on FreeRunner] at KoolU.com
* [[Openmoko Local Groups]]
* [[Openmoko:Community_Portal]]

= See also =

* [[Debug_Board]]

= External Links =

[[Category:Distributions]]

Android

2008-11-06T18:29:48Z

Narmo:

{{Languages|Main Page}}
{{Distributions|Android}}

= Updates =

* 20081104 The first Android-image has been successfully created by Sean McNeil! You can try on your own: [http://people.openmoko.org/sean_mcneil/ android image and kernel] - sms and calling works, wifi and bluetooth doesn't. [http://onlinedev.blogspot.com/2008/11/porting-android-phase-3-done.html ''news-source'']
* 20081029 [[User:Cfriedt]] [http://benno.id.au Benno] has modified Android's build system so that it will output a JFFS2 image instead of YAFFS . Unlike JFFS2, which [http://64.233.169.104/search?q=cache:e8czlAdKTn0J:gentoo-wiki.com/JFFS2/Mounting+gentoo+jffs2&hl=en&ct=clnk&cd=1&gl=ca&client=firefox-a can be mounted read-only from an image], mounting a YAFFS image is not possible unless it's already been written to flash (it complains about the block device being of type '1' and not 'NAND'). JFFS2 also has the benefit that it's a standard OpenMoko image format (See [[Flashing the Neo FreeRunner]] or [[Flashing the Neo 1973]])
* 20081023 [[User:Bricode]] To track the status of which parts of the Android source tree contain ARMv5 specific code, I've created a table of where it is contained, and the status of patches. It can be found at: http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw
* 20081022 [[User:Cfriedt]] I was able to 'trivially' compile all of the Android source code without error for the ARMv4T architecture by removing v5TE instructions. Although it will definitely not run anything predictably, at least now that I know the build system will work with a few simple substitutions in build/core/combo/arm-linux.mk. At this point I am able to go ahead and re-implement v5TE instructions as v4T instruction sequences instead (or re-implement entire sections of assembly with hand-optimized v4T instructions).
* 20081021 [[User:Cfriedt]] Android -> FreeRunner updates on my [http://perpetual-notion.blogspot.com/search/label/android blog]
* 20081021 Google released the majority [http://source.android.com/download source code] for the phone under Apache free and open-source [http://source.android.com/license license], with portions covered by other existing licenses, such as the Linux kernel under GPLv2.
* 200810?? [http://www.koolu.com Koolu.com] has announced that they will be '''selling the OpenMoko Freerunner with Android pre-installed''' beginning in November 2008, as well as offering '''free downloads of the Freerunner port of Android''' to existing Freerunner owners. Well-known open-source advocate [http://koolu.com/The-Koolu-Team/maddog.html Jon "maddog" Hall] is CTO and Ambassador for Koolu.

= Introduction =
This page is dedicated to porting the [http://www.android.com Android OS] to the [[Neo 1973]] and [[Neo FreeRunner]] handsets. Since the Android OS was [http://source.android.com/posts/opensource publically released] on 20081021, [http://benno.id.au/blog/2007/11/21/android-neo1973 work] [http://perpetual-notion.blogspot.com/search/label/android is] [http://groups.google.com/group/android-porting currently underway] to port Android to the [[Neo1973 Hardware|Neo 1973]] and [[Neo_FreeRunner_GTA02_Hardware|FreeRunner]] handsets.

== Goals ==
# Systematically introduce patches for ARMv4T in the Android codebase
# Provide Neo1973 and Neo FreeRunner hardware-dependent patches in the Android codebase, leveraging the work already done by the Openmoko developers, without forcing Android-specific changes upstream
# Provide a useable Android filesystem and kernel on the [[Distributions]] page that conform to current Openmoko installation routines

== Early Attempts ==
As [http://benno.id.au Ben Leslie] had pointed out on his [http://benno.id.au/blog/2007/11/21/android-neo1973 blog] far before the source code was released, [http://www.android.com Android] was originally designed to work with the ARMv5TE [http://en.wikipedia.org/wiki/Instruction_set_architecture instruction set architecture] (ISA), which allows for [http://en.wikipedia.org/wiki/ARM_architecture#DSP_Enhancement_Instructions DSP enhanced instructions]. Contrary to the ARMv5TE ISA, the Neo1973 and FreeRunner handsets both feature an arm920t core, which comply to the ARMv4T ISA.

Before the source code was released, kernel trap handlers were implemented to 'emulate' the ARMv5TE ISA. Although the results worked in many cases, trapping is costly and performance suffered as a result. Moreover, without explicitly knowing which conditions were set by various instructions, such as Thumb Mode execution, the result became nondeterministic.

== Current State ==

With the release of the Android [http://source.android.com source code], the Open Source community is no longer limited to dealing with a binary-only product. The Open Handset Alliance (OHA) has let their source code become their product for everyone enrich and benefit from.

Currently, porting efforts are underway in many circles. Patches should be submitted via the [http://source.android.com/submit-patches official Android channels].

To track the status of which parts of the Android source tree contain ARMv5 specific code, I've created a table of where it is contained, and the status of patches. It can be found at: http://spreadsheets.google.com/pub?key=pzDEXnU19gkeTjpD28t-7fw [[User:Bricode]]

[[User:Seanmcneil3|Sean McNeil]] said that he was able to get Androind running (including telephony) in his Freerunner [http://3v1n0.tuxfamily.org/tumblelog/post/368 source].

Ben Leslie mentioned on the android-porting list that he was able to get the 'Android' logo to appear on his Neo 1973.

= How to Help =

== Getting Started ==

You can start by following the instructions to download and build the Android source from scratch. Please see [http://source.android.com/download http://source.android.com/download] and follow the instructions for your architecture.

== Publicize Your Efforts ==

It's generally a good idea to make your efforts known via wiki systems, public mailing lists, forums, and publically open version control systems.

Always take credit for your work but please don't do it in the form of comments. Some code is already hard enough to read without comments polluting the text. The best thing to do is to create a patch and put a header with your information at the top. Collaboration systems such as git might already do this for you (??).

If you create something new and have the ability to designate the license for it, please consider license compatibility issues.

== Porting Strategy ==

* Analysis and leverage of the existing build system
** buid/core/combo/arm-linux.mk
*** -D__ARCH_ARM_4__ -D__ARCH_ARM_4T__
*** -march=armv4t -mcpu=arm920t
** fix various static references to 'armv5'
* Isolating ARMv5TE ISA dependent code
** e.g. grep -n -R -i "${armv5te_isa_pattern}" ~/android
* Abstracting
** ( C/C++ )
*** Use inlined functions / #ifdef statments to implement functions in a portable manner
*** For inlined assembler calls, it's acceptable for now to use generic C code instead, so long as later on we optimize it by hand.
** ( ASM )
*** Proprocessor statements based on ISA / architecture, e.g. #ifdef __ARCH_ARM_5__ ... #endif #ifdef __ARCH_ARM_4__ ... #endif
*** It's highly suggested that preprocessor statements should not be nested (i.e. make them mutually exclusive)
*** Some people have suggested that we should not do #ifdef's based on ARCH or ISA, but rather based on an AndroidConfig.h which would define macros like PLD(...) #ifdef HAVE_ARM_PLD pld #else ... #endif .

For each ARMv5TE instruction, one could potentially
* Implement the instruction using general registers instead of DSP calls (i.e. eabi / softfloat)
* If that is a) nondeterministic, or b) slow, then sections of code need to be analyzed and hand-optimized for the ARMv4T isa

== List of Unsupported Instructions ==

This is a list of opcodes, extracted from the Android source, that are unsupported for ARMv4T compliant processors (specifically the arm920t). The opcodes represent instructions available for ARMv5, ARMv5T, and ARMv5TE architectures, which are not present in the ARMv4T ISA. The list was obtained by exhaustively editing the recompiling the Android source code until it compiled without error.

Please keep in mind, that in some cases, translating these instructions into a sequence of ARMv4T instructions will be impossible and / or result in nondeterministic execution because of
* the requirement of additional context
* the tendencies of certain opcodes to change condition registers that may or may not be present in the arm920t core

=== Opcodes ===

{{scroll box|height=480px|text=
<TABLE BORDER="1">
<TR>
<TH>Opcode</TH>
<TH>Desription</TH>
<TH>[[http://www.arm.com/miscPDFs/14128.pdf PDF]] Page Number</TH>
<TH>C</TH>
<TH>ASM</TH>
</TR>
<TR>
<TH VALIGN="TOP">BLX(1)</TH>
<TD>Branch, Link, and Exchange</TD>
<TD>166</TD>
<TD>N/A (Unused in Android)</TD>
<TD>N/A (Unused in Android)</TD>
</TR>
<TR>
<TH VALIGN="TOP">BLX(2)</TH>
<TD>Branch, Link, and Exchange</TD>
<TD>168</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_BLX
... (inline asm) ...
#else
... (inline asm with equivalent blx code, as shown to the right) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_BLX
#define BLX(a) \
blx a
#else
#define BLX(a) \
mov pc,lr \
bx a
#endif
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">CLZ</TH>
<TD>Count Leading Zeros</TD>
<TD>175</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_CLZ
... (inline asm) ...
#else
... (inline asm with equivalent clz code, as shown to the right) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081029
<pre>
#ifdef HAVE_CLZ
#define CLZ(Rd,Rm) \
clz Rd,Rm
#else
#define CLZ(Rd,Rm) \
...
#endif
...
CLZ(Rd,Rm)
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">LDRD</TH>
<TD>Load Registers Doubleword</TD>
<TD>200</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute different inline assembly code with something like
<pre>
#ifdef HAVE_LDRD
... (inline asm) ...
#else
... (inline asm with ldrd substituted) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_LDRD
#define LDRD(a,b) \
ldrd a,b
#else
#define LDRD(a,b) \
...
#endif
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">PLD</TH>
<TD>Preload Data</TD>
<TD>240</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove from inline assembly with something like
<pre>
#ifdef HAVE_PLD
... (inline asm) ...
#else
... (inline asm with pld removed) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Remove or substitute with a macro reference such as
<pre>
#ifdef HAVE_PLD
#define PLD(a,b) \
pld a,b
#else
#define PLD(a,b)
#endif
...
PLD(r0,#0)
</pre>
</TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLA<x><y></TH>
<TD>Signed Multiply-Accumulate</TD>
<TD>291</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLAL<x><y></TH>
<TD>Signed Multiply Accumulate Long</TD>
<TD>298</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMLAW<y></TH>
<TD>Signed Multiply-Accumulate Word</TD>
<TD>302</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMUL<x><y></TH>
<TD>Signed Multiply</TD>
<TD>316</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">SMULW<y></TH>
<TD>Signed Multiply Word</TD>
<TD>320</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QADD</TH>
<TD>Saturating Add</TD>
<TD>242</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QDADD</TH>
<TD>Saturating Double and Add</TD>
<TD>249</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QDSUB</TH>
<TD>Saturating Double and Subtract</TD>
<TD>251</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">QSUB</TH>
<TD>Saturating Subtract</TD>
<TD>253</TD>
<TD></TD>
<TD></TD>
</TR>
<TR>
<TH VALIGN="TOP">STRD</TH>
<TD>Store Registers Doubleword</TD>
<TD>349</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute different inline assembly code with something like
<pre>
#ifdef HAVE_STRD
... (inline asm) ...
#else
... (inline asm without strd) ...
#endif
</pre>
</TD>
<TD>
[[User:Cfriedt]] 20081028
Substitute with a macro reference such as
<pre>
#ifdef HAVE_STRD
#define STRD(a,b) \
strd a,b
#else
#define STRD(a,b) \
...
#endif
</pre>

</TD>
</TR>
</TABLE>
}}

=== Scanning for Files That Use the ARMv5TE ISA ===

Using the above list of opcodes, one can scan the Android source code for ARMv4T-incompatible instruction sequences.

'''Code:'''
{{scroll box|height=240px|text=
<pre>
#!/bin/sh

# $1 is the android directory

if [ $# -ne 1 ]; then
exit -1
fi

cd "${1}"

opcodes="blx clz ldrd pld smlabb smlabt smlatt
smlal smlawb smlawt smulbb smulbt smultt smulwb
smulwt qadd qdadd qdsub qsub strd"

for op in ${opcodes}; do

echo "* ${op} ====================================="

if [ ! -e .files.${op} ]; then

files="$(grep -R -i "${op} " * 2>/dev/null)"
files="$(echo $files | grep -v "^Binary file" | sed -e 's/:.*//')"
files="$(echo $files| grep -v "CREDIT\|README\|^$kernel/\|.git/$\|$\.txt$$" | sort -u)"

echo "${files}" > .files.${op}

else
files="$(cat .files.${op})"
fi

for fil in ${files}; do
lines="$(grep -n -i "${op} " ${fil} | sed -e 's/:.*//g' )"
lines="$(echo $lines | sed -e 's/ /,/g')"
echo "** ${fil}: lines {${lines}}"
done
done
</pre>
}}

=== Source Files in Android that Use the ARMv5TE ISA ===

The list of files below may or may not be complete. There might also be some assembly code that is generated with a python script (verification?).

{{scroll box|height=150px|text=
* blx =====================================
** bionic/libc/tools/gensyscalls.py: lines {168,186}
** bootloader/legacy/nandwrite/init.S: lines {77}
** bootloader/legacy/usbloader/init.S: lines {95}
** dalvik/vm/arch/arm/CallEABI.S: lines {239}
** dalvik/vm/arch/arm/CallOldABI.S: lines {145}
** development/emulator/qtools/thumbdis.cpp: lines {187,265}
** external/qemu/target-arm/translate.c: lines {1151,1971,2444}
** external/qemu/trace.c: lines {774,1353,1358}
** system/core/libpixelflinger/codeflinger/disassem.c: lines {416}
* clz =====================================
** development/emulator/qtools/armdis.cpp: lines {654}
** external/opencore/codecs_v2/audio/aac/dec/src/pv_normalize.h: lines {67,84}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/norm_l.h: lines {137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/normalize_amr_wb.h: lines {78,95}
** external/opencore/codecs_v2/audio/mp3/dec/src/pvmp3_normalize.h: lines {67,84}
** external/opencore/codecs_v2/video/avc_h264/dec/src/vlc.cpp: lines {23}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/vlc_encode_inline.h: lines {125,162,168,204,218}
** external/qemu/target-arm/translate.c: lines {1247}
** external/skia/libcorecg/Sk64.cpp: lines {340,341,343}
** external/skia/libcorecg/SkMatrix.cpp: lines {500,501}
** external/skia/libsgl/effects/SkColorMatrixFilter.cpp: lines {135}
** external/skia/libsgl/sgl/SkBitmap.cpp: lines {945,946,947}
** external/skia/libsgl/sgl/SkBitmapShader.cpp: lines {32,33,34}
** external/skia/libsgl/sgl/SkGraphics.cpp: lines {429,437}
* ldrd =====================================
** dalvik/vm/mterp/armv5/OP_AGET_WIDE.S: lines {28}
** dalvik/vm/mterp/armv5/OP_IGET_WIDE.S: lines {37}
** dalvik/vm/mterp/armv5/OP_IGET_WIDE_QUICK.S: lines {10}
** dalvik/vm/mterp/armv5/OP_SGET_WIDE.S: lines {17}
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2653,7464,8318,8390}
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {40,41,42,43}
* pld =====================================
** bionic/libc/arch-arm/bionic/memcmp.S: lines {37,44,45,56,57,107,108,195,196}
** bionic/libc/arch-arm/bionic/memcmp16.S: lines {37,44,45,67,68,116,117,198,199}
** bionic/libc/arch-arm/bionic/memcpy.S: lines {55,56,57,145,266,293,320}
** bionic/libc/arch-arm/bionic/strlen.c: lines {59,65}
** bionic/libc/kernel/arch-arm/asm/arch/irqs.h: lines {162}
** external/elfutils/src/Makefile: lines {243}
** external/elfutils/src/Makefile.am: lines {32}
** external/elfutils/src/Makefile.in: lines {243}
** external/jpeg/jidctfst.S: lines {69,235,247}
** external/qemu/target-arm/translate.c: lines {1149}
** system/core/libpixelflinger/codeflinger/ARMAssembler.cpp: lines {368}
** system/core/libpixelflinger/codeflinger/ARMAssemblerInterface.cpp: lines {104,108,117}
** system/core/libpixelflinger/t32cb16blend.S: lines {111,112,134,143}
* smlabb =====================================
** external/jpeg/jidctfst.S: lines {110,115,155,156}
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {584,589}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {147,166}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {120,129}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {514,533}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {418,429}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {202}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {250}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {119,155,167,278,326,341}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {178,225,437,517}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {405,436}
* smlabt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {184}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {138}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/dct_inline.h: lines {131,143,294,310}
* smlatt =====================================
** external/neven/Embedded/common/src/b_BasicEm/Math.c: lines {585,590}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {157}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {441}
* smlal =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4.h: lines {179,223,236,257,267}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v4_gcc.h: lines {264,341}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {178,188,198}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9.s: lines {84,90,96,101,109,114,116,118,121,132,138,150,163,165,167,174,176,178}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_dct_9_gcc.s: lines {73,79,86,90,98,103,105,107,110,121,127,139,152,154,156,163,165,167}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.asm: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18.s: lines {145,164,180,190,194,201,209,219,227,233,239,243,246}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_mdct_18_gcc.s: lines {143,162,178,188,192,199,207,217,225,231,237,241,244}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.asm: lines {62,63,66,72,76,77,81,82,85,90,94,97,99,100,103,108,113,114,118,119,122,129,136,137,176,179,183,187,190,193}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window.s: lines {67,68,71,77,81,82,86,87,90,95,99,102,104,105,108,113,118,119,123,124,127,134,141,142,181,184,188,192,195,198}
** external/opencore/codecs_v2/audio/mp3/dec/src/asm/pvmp3_polyphase_filter_window_gcc.s: lines {65,66,69,75,79,80,84,85,88,93,97,100,102,103,106,111,116,117,121,122,125,132,139,140,179,182,186,190,193,196}
** external/opencore/codecs_v2/audio/mp3/dec/src/pv_mp3dec_fxd_op_arm.h: lines {148}
** external/qemu/trace.c: lines {813}
** frameworks/base/opengl/libagl/iterators.S: lines {66,67}
** frameworks/base/opengl/libagl/matrix.h: lines {67,68,96,126,127,282,283,314,315,316}
* smlawb =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {203,259}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {166,416}
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {93,109}
** frameworks/base/opengl/libagl/matrix.h: lines {163,203}
* smlawt =====================================
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {114}
** frameworks/base/opengl/libagl/matrix.h: lines {162,202,243,244}
* smulbb =====================================
** external/jpeg/jidctfst.S: lines {109,114,151,153}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {79}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {71,81}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {207,251,297,348,361,375,427,440,487}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {199,234,274,314,316,326,367,369,404}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {121,137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {123,142}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {122,140}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {132,134,138,164,177,191}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {127,129,150,163}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mult.h: lines {121,141}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {115,139,151,163,189,190,212}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {112,113,164,183,201,218,265}
** external/opencore/codecs_v2/video/m4v_h263/enc/src/fastquant_inline.h: lines {250,457,531}
** external/skia/include/corecg/SkMath.h: lines {170}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {420,462}
** system/core/libpixelflinger/t32cb16blend.S: lines {39,66,74,82}
* smulbt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {115}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {109}
** system/core/libpixelflinger/codeflinger/texturing.cpp: lines {1091}
** system/core/libpixelflinger/t32cb16blend.S: lines {47,55}
* smultt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {131}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {100}
** frameworks/base/libs/audioflinger/AudioMixer.cpp: lines {467}
** frameworks/base/libs/audioflinger/AudioResamplerSinc.cpp: lines {73}
* smulwb =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {221}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {373}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {222}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {283}
** external/opencore/codecs_v2/audio/sbc/enc/src/sbcenc_filter.h: lines {33}
** frameworks/base/opengl/libagl/matrix.h: lines {161,201,242}
* smulwt =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {202,240}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {385,415}
* qadd =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_gcc.h: lines {64}
** external/opencore/codecs_v2/audio/aac/dec/src/fxp_mul32_arm_v5.h: lines {60}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {130,256}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {128,235}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_add.h: lines {122,137}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mult.h: lines {123,145}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {71,102,152,176,192}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {91,115,148,202,234}
** external/openssl/crypto/bn/bn_prime.c: lines {454,455}
* qdadd =====================================
** external/opencore/codecs_v2/audio/aac/dec/src/calc_sbr_synfilterbank.cpp: lines {116,162}
** external/opencore/codecs_v2/audio/aac/dec/src/trans4m_freq_2_time_fxp.cpp: lines {472,494}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {212,356,370,385,435,449}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {200,315,321,331,368,371}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_mac.h: lines {122,142}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32.h: lines {133,136,140,172,186,201}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/mpy_32_16.h: lines {128,131,158,172}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {116}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {184}
* qdsub =====================================
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {302}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {275}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_msu.h: lines {124,147}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {140}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {165}
* qsub =====================================
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_gcc_v5.h: lines {167}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/basic_op_arm_v5.h: lines {162}
** external/opencore/codecs_v2/audio/gsm_amr/amr_nb/common/include/l_sub.h: lines {121,138}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_armv5.h: lines {88,127}
** external/opencore/codecs_v2/audio/gsm_amr/amr_wb/dec/src/pvamrwbdecoder_basic_op_gcc_armv5.h: lines {70,133}
* strd =====================================
** dalvik/vm/mterp/armv5/OP_APUT_WIDE.S: lines {31}
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE.S: lines {39}
** dalvik/vm/mterp/armv5/OP_IPUT_WIDE_QUICK.S: lines {14}
** dalvik/vm/mterp/armv5/OP_SPUT_WIDE.S: lines {21}
** dalvik/vm/mterp/out/InterpAsm-armv5.S: lines {2834,7530,8331,8542}
** dalvik/vm/oo/Object.h: lines {589}
** external/opencore/fileformats/avi/parser/include/pv_avifile_streamlist.h: lines {179}
** external/opencore/fileformats/avi/parser/src/pv_avifile_streamlist.cpp: lines {153}
** system/core/libpixelflinger/rotate90CW_4x4_16v6.S: lines {47,52,56,60}
}}

=== Discussion ===
=== Notes ===
The file
<pre>
system/core/libpixelflinger/codeflinger/ARMAssembler.cpp
</pre>

will need special attention. It's responsible for dynamic generation of DSP code.

== Suggestions ==
* [[User:Cfriedt]] 20081024 I'm not sure how feasible this is, given that the [http://wiki.openmoko.org/wiki/Neo_FreeRunner_Hardware_Issues#SMedia_3362_Documentation_.26_OpenGL_ES_Drivers SMedia 3362 is heavily NDA'd]. However, since the arm920t lacks a floating-point unit / DSP core, is it possible to use the SMedia chip for general-purpose math? This would help in the Android platform, at least, for things like audio and video codecs. Aside from an OpenGL ES driver, OpenMoko documentation for the SMedia would be highly appreciated.

= Important Links =
(Please Update Me)

== Documentation ==
* [http://source.android.com/documentation Android Documentation]
* [http://www.arm.com/documentation/ ARM Documentation], (keywords: armv4t, armv5t, armv5te, arm920t, arm926ej-s)
* [http://www.arm.com/miscPDFs/9658.pdf ARM Assembly Language Programming]
* [http://www.cse.unsw.edu.au/~cs3221/labs/assembler-intro.pdf An Introduction to the GNU Assembler]
* [http://www.heyrick.co.uk/assembler/apcsintro.html ARM Procedure Call Standard], [http://en.wikipedia.org/wiki/Calling_convention#ARM ARM Calling Conventions]

== Instruction Set References ==
* [http://www.arm.com/miscPDFs/14128.pdf ARM Architecture Reference Manual], The definitive ISA documentation
* [http://www.simplemachines.it/doc/QRC0001H_rvct_v2.1_arm.pdf ARM Instruction Set Quick Reference Card]
* [http://infocenter.arm.com/help/topic/com.arm.doc.qrc0001l/QRC0001_UAL.pdf ARM and Thumb -2 Instruction Set Quick Reference Card]
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0025b/DVI0025.pdf ARMv4T] (See section 1.4.13)
* [http://infocenter.arm.com/help/topic/com.arm.doc.dvi0014a/DVI0014A_ARM10T_PO.pdf ARMv5T] (See section 4.16)
* [http://www.arm.com/pdfs/ARM-DSP.pdf ARM DSP Enhanced Instruction Set]
* [http://infocenter.arm.com/help/topic/com.arm.doc.ihi0042c/IHI0042C_aapcs.pdf Procedure Call Standard for the ARM Architecture]

== Hardware Reference ==

* [[Neo1973 Hardware]]
* [[Neo FreeRunner GTA02 Hardware]]

== Communities ==
* [http://source.android.com/discuss Android Public Mailing Lists]
** Specifically, [http://groups.google.com/group/android-porting android-porting]
* [http://lists.openmoko.org/mailman/listinfo OpenMoko Mailing Lists]
** Specifically, [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel openmoko-kernel]
* [http://forum.koolu.org/viewforum.php?f=10 Android on FreeRunner] at KoolU.com
* [[Openmoko Local Groups]]
* [[Openmoko:Community_Portal]]

= See also =

* [[Debug_Board]]

= External Links =

[[Category:Distributions]]

Development with Eclipse/ru

2008-11-05T23:31:11Z

Narmo:

{{Languages| Development with Eclipse}}
Графические приложения Openmoko снованы на среде Gnome. Их легко создавать, запускать и отлаживать как программы для настольных ПК или загружать в мобильный телефон только на финальной стадии отладки. Используя мобильный телефон, можно использовать экран, клавиатуру и мышь настольного комьютера, и это работает. Данная статья предоставляет инструкции для Debian, но они подходят для любых (не сломанных) Linux-дистрибутивов.

Eclipse включает в себя модуль для разработки на C/C++. Вам необходима последняя версия Eclipse, плагин для C/C++ и, возможно, обновление пакета разработчика GTK. Самый лёгкий способ заставить простое приложение выполняться - это создать проект C и добавить в флаги компилятора и линковщика флаги `pkg-config --cflags --libs gtk+-2.0`. После этого посетите страницу [http://library.gnome.org/devel/gtk-tutorial/stable/ GTK tutorial] и, следуя этим инструкциям, создайте простое приложение.

Данное решение не только сокращает время разработки, но также позволяет использовать отладчик Eclipse для разработки на C.

Исполняемый файл для мобильного телефона создаётся из тех же самых исходных кодов, используя средства разработки Openmoko. Так как процессы сборки под настольный компьютер и под Openmoko различиаются, самым лучшим вариантом является создание двух окружений разработки и создание символических ссылок для них.

After producing the Openmoko executable, it may be reasonable to try it via X, using the keyboard, mouse and screen of the desktop computer. All you need is to use the -X option in the ssh command when you log in into the connected mobile phone. After that, you should be able to run the application inside the phone but have its X window on a screen of the desktop machine. This way you can check the actual execution speed and have access to the mobile phone devices that are not present on PC.

Eclipse allows to add the custom builder to the project. These builders can be either Ant scripts or the executable shell scripts. These possibilities can be used to force the Openmoko toolchain to produce the phone executable without leaving the Eclipse IDE.

== Установка конфигурации создания Freerunner==

# установите [[Toolchain]]
# откройте 'Properties' для вашего проекта C или C++
# выберите 'C/C++ Build'->'Tool Settings'
# Кликните на 'Configuration'->'Manage' и создайте новую конфигурацию например. Freerunner (скопируйте настройки с конфигурации 'Relase' )
# измените GCC C||C++||Assembler Compiler command на /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/gcc||g++||as
# измените GCC Linker Command на /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/gcc (g++ для проектов C++)
# идите 'Build Steps' и добавьте ". /usr/local/openmoko/arm/setup-env" к 'Pre-build step'
# щелкните на Ok и выберите 'Freerunner' в 'Active Build Configuration' для вашего проекта

----
Поправки для Eclipse Ganymed (3.4)

There are three places where you have to change settings as above in Project Properties -> C/C++ Build -> Settings -> Tool Settings
#GCC C Compiler -> Command: /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/gcc
#GCC C Linker -> Command: /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/gcc
#GCC Assembler -> Command: /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/gcc||g++||as

--[[User:Perty|Perty]] 20:22, 18 September 2008 (UTC)
----

вы можеет скопировать свои бинарники на Freerunner через добавление команды Post-Build в 'Build Steps' так.

scp ${имя_проекта} root@neo:/home/root/dev_app/

или вы можете запустить ваше приложение на Freerunner добавив в конфигурацию Run

C/C++ Application: /usr/bin/ssh
Arguments: root@neo "cd dev_app && DISPLAY=:0 ./${project_name}"

--[[User:PipBoy2000|PipBoy2000]] 22:30, 9 September 2008 (UTC)

==Настройка Eclipse для разработки с Qt4==

===Настройка Environment с Libraries===

*Установите [[Toolchain]]

*Установите Eclipse с C/C++ development plug-in

*Добавьте Anstrom Repository в '''Host'''-toolchain и также '''FreeRunner'''
**Добавьте Anstrom Repository в '''Host'''-toolchain:
echo arch base 50 >> /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/etc/opkg.conf
echo src/gz base http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base >> /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/etc/opkg.conf

и тогда ..
opkg-target update
opkg-target install qt4-x11-free
opkg-target install qt4-x11-free-dev qt4-designer qt4-assistant

**Add the [[Users Repositories|Anstrom Repository]] also to the '''FreeRunner''' and do:
opkg update
opkg install qt4-x11-free

===Конфигурирование проекта Eclipse ===
Project - right click - Properties --> C/C++ Build -- Tab "Tool Settings"

====Конфигурация: Debug====

*GCC c++ compiler -> Directories --- add
/usr/include/qt4
/usr/include/qt4/QtGui

*GCC C++ Linker -> Libraries ---add
**Libraries (-l): QtCore and QtGui
**Library search path (-L): /usr/lib

====Конфигурация: Freerunner====

Project - right click - Properties --> C/C++ Build -- Tab "Tool Settings"

Создаем конфигурацию "Freerunner":
кликнув 'Configuration'->'Manage' и создав новую конфигурацию например Freerunner (скопируйте настройки из конфигурации 'Relase')

*GCC C++ Compiler
**Command: /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/g++
*GCC C++ Compiler -> Directories
/usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/usr/include/qt4/QtCore
/usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/usr/include/qt4/QtGui
/usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/usr/include/qt4
/usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/usr/include/c++/4.1.2/arm-angstrom-linux-gnueabi
/usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/usr/include/c++/4.1.2
/usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/usr/include/c++/4.1.2/backward

*GCC C++ Linker
**Command: /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/g++

*GCC C++ Linker -> Libraries --- add
**Libraries (-l): QtCore and QtGui
**Library search path (-L): /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/usr/lib

* GCC Assembler
**Command: /usr/local/openmoko/arm/arm-angstrom-linux-gnueabi/bin/as

перейдем к закладке 'Build Steps' и добавим ". /usr/local/openmoko/arm/setup-env" к 'Pre-build step'

====workaround to deal with .ui файлы с Qt-Designer====

mayby somody has a better solution please correct!!

Create a project with properties as mentioned above.
Для компилирования вашего проекта вызовите терминал в Project-Folder и введите там
qmake-qt4 -project
qmake-qt4
make
и теперь собирайте ваш проект с Eclipse Configuration "Freerunner"

[[Category:Application Developer/ru]]

Main Page/ru

2008-11-01T19:00:10Z

Narmo:

__NOTOC__
{{Languages|Main_Page}}
 
<DIV ALIGN=center><big>'''Openmoko™ Открытый. Мобильный. Свободный.'''</big> </DIV>
 
[http://www.linuxphone.ru Портал русскоязычных пользователей]

__NOTOC__
__NOEDITSECTION__ [[Image:Freerunner02.gif|thumb|150px|right|Neo FreeRunners]]

==Введение в Openmoko==
[[Image:OpenmokoFramework08.png|250px|left|Программный стек Openmoko|thumb]]
Openmoko™ - рожден как проект с [http://ru.wikipedia.org/wiki/%D0%9E%D1%82%D0%BA%D1%80%D1%8B%D1%82%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE%D0%B5_%D0%BE%D0%B1%D0%B5%D1%81%D0%BF%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5 Открытым Исходным Кодом] под [[License| лицензиями GPL и LGPL]], представляющий открытую программную архитектуру для мобильных платформ. Openmoko на данный момент продает смартфон [[Neo FreeRunner]] для продвинутых пользователей и начинает компанию по разработке программного обеспечения под него.

[[NeoSoftwareStack|Архитектура Openmoko]] включает в себя [[Host-based development with Xoo and Xephyr|X сервер]] и позволяет пользователям и разработчикам превратить аппаратную платформу мобильных устройств в уникальные продукты. Наша лицензия дает свободу пользователям и разработчикам от "iron to the eyeballs," свободу в поверхностной настройке устройства или радикальном его изменении; сменить фоновый рисунок или пересобрать всю систему! Она дает свободу, например, превратить телефон в медицинское устройство, или устройство продаж, или просто свободно устанавливать ваши программы. Для полной свободы программного обеспечения для наших устройств, мы также опубликовали схему устройства в формате CAD под лицензией Creative Commons. Дав свободу программному обеспечению под лицензией GPL, мы позволили сообществу разработчиков FOSS "сделать ее новой". Освободив схемы устройства в файлах [http://downloads.openmoko.org/CAD/ CAD], мы предоставляем промышленным дизайнерам и инженерам эту же возможность. И на LinuxWorld 2008, мы предоставили [http://downloads.openmoko.org/schematics/ принципиальные схемы].

<div style="clear:both"> </div>

<table class="wikitable" cellspacing="4" cellpadding="6" width="100%" style="color:white">
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Новости и события</td>
<td width="50%">Новости Openmoko?</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
* 9/10: [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* 6/10: [[Community_Updates/October_3rd%2C_2008/ru|Community update]]
* 2/10: Nokia выпустила [http://qtextended.org/ Qt Extended 4.4.1] ([http://qtextended.org/modules/mydownloads/visit.php?lid=86 image], [http://qtextended.org/modules/mydownloads/visit.php?lid=85 SDK])
* 27/9: Вышел релиз [[FDOM]]
* 19/9: точка релиза [[Om_2008.9_Update|Om 2008.9]]
* 17/9: [[17th September, 2008 - Activity since launch|Community update]] - Activity since launch
* 11/9: Команда сделала релиз [http://downloads.openmoko.org/framework/milestone3/ milestone 3] дистрибутива от FSO.
* 2/9: Trolltech [http://www.qtopia.net/modules/mydownloads/singlefile.php?lid=83 опубликовала] Qtopia 4.3.3-snapshot.
* 28/8: Trolltech [http://n2.nabble.com/qtopia-4.3.2-release-tp789148p789148.html опубликовала] Qtopia 4.3.2.
* 26/8: Openmoko [http://lists.openmoko.org/pipermail/community/2008-August/027997.html updates] [[Om 2008.8]] дистрибутив.
 
* [[Weekly Engineering News|Openmoko Weekly Engineering News]]
* [[News Archive|(news archive)]]
</td>
<td>
===О Openmoko===
* [[Introduction/ru| Введение]]
* [[Why Openmoko| Почему Openmoko]]
* [[Neo FreeRunner|Neo FreeRunner phone]]
* [[Supported Hardware]]
* [[FAQ| ЧаВо]]

===Старт с Openmoko===
* [[Getting Openmoko]]
* [http://www.openmoko.com Openmoko Inc.]

</td>
</tr>
<tr style="background:#ff6600; text-align:center; font-weight:bold">
<td width="50%">Для пользователей</td>
<td width="50%">Для разработчиков</td>
</tr>
<tr valign="top" style="background:#333333">
<td>
===C чего начать===
* [[Getting Started with your Neo FreeRunner/ru | Neo FreeRunner getting started guide]]
* [[Applications]]

===Дистрибутивы===
* [[Distributions|Features comparison table]]
* [[Om 2008.8|Om 2008.8 (ASU)]] - [[Om 2007.2|Om 2007.2 (old stable)]]
* [[OpenmokoFramework|FSO]] - [[Qtopia_on_FreeRunner|Qtopia]] - [[Debian|Debian]] - [[Gentoo|Gentoo]]

===Общение===
* [[Mailing List Duplicates| Mailing List Duplicates]]
* [[Discussion_Forums| Форум]]
* [[Community repository]]
* [[Development resources | Ресурсы для разработчиков]]
</td>
<td>
===Разработка приложений===
* [[Openmoko developer guide| Руководство разработчика ]]
* [[Toolchain|Средства разработки]]

* [[Python|Введение в Python]]
* [http://projects.openmoko.org/ Projects hosted in our GForge]
* [[OpenmokoFramework|Openmoko dbus-based service level framework]]

===Интеграция и дистрибутивы===
* [[OpenEmbedded|The OpenEmbedded distribution building framework]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Менеджер пакетов Opkg]]

===Эмуляция===
* [[Openmoko under QEMU| Openmoko в QEMU]]
</td>
</tr>
</table>

==Продукция Openmoko==

Первый продукт Openmoko - Neo1973, продавался исключительно через интернет-магазин Openmoko. Продажи закончились в начале февраля 2008 года.

С 26 июня 2008 года Openmoko поставляет Neo FreeRunner (GTA02) - второе поколение Neo. Если вы заинтересованны в покупке Neo FreeRunner, добавьте своё имя в Лист Заинтересованных в Покупке. Также посмотрите групповые покупки на [[GroupSales|Групповых Продажах]] с дополнительными скидками и услугами.

==Присоединяйтесь к развитию Openmoko==

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | Руководство разработчика
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Тестирование / Эмуляция и участие в проектах
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Разработчику ===
* [[Toolchain|Использование инструментов разработчика]]
* VMware
* [[Python|Введение в python]]
* [[Openmoko_under_QEMU|Openmoko через QEMU]]

===Системная интеграция и настройка===
* [[OpenEmbedded|OE - Платформа построения приложений]]
* [[MokoMakefile|Сборка Openmoko с использованием MokoMakefile]]
* [[Opkg|Opkg]]
===Низкоуровневая / системная разработка===
* [[u-boot]] - Загрузчик используемый нами, включая документацию для его модификации
* [[kernel]] - Ядро Linux используемое нами, включая документацию для его модификации
* [[gsmd]] - GSM демон управления GSM Модемом
* [[agpsd]] - AGPS (Assisted GPS) демон

|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
===Тестирование===
*[[Test Cases|Пройденные тесты]]
 ※ [[:Category: Test | Узнать больше о Тестировании]]

===Эмуляция===
*[[Getting Openmoko working on host with Xephyr|Эмуляция Openmoko на ПК с использованием Xephyr]]
*[[Test_Openmoko Emulation with chroot image|Эмуляция Openmoko с готовым образом корневой файловой системы]]
===Публикация вашего проекта===
*[[Community Repository|Опубликовать Ваш Проект]]
|}

==Сообщество Openmoko==
Каждый может присоединиться к проекту Openmoko и сделать свой вклад в разработку открытых продуктов. Присоединяйтесь к нам и сотрудничайте в рамках любого [[Development resources | проекта]], в том числе и Энциклопедии по Openmoko. См. страницу помощи по редактированию информации или внесении/добавлении изменений в энциклопедии.

Вы можете начать с [[introduction|вводной]] страницы , фотографий, видео и Оффициальной Страницы Openmoko Wiki. Как всегда, используйте [[FAQ | Часто Задаваемые Вопросы]] (ЧАВО), [http://lists.openmoko.org/mailman/listinfo/| списки рассылки] и [[Discussion_Forums| Форумы]] для получения помощи.

{| class="wikitable" cellspacing="4" cellpadding="6" width=100%
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600; " | В Новостях
! width=50% style="background:#ff6600;border-left:5px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #ff6600;" |Сообщество и События
|-
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |
==В Новостях==
*[[Getting Started with your Neo FreeRunner|Neo FreeRunner - с чего начать]]
*[[ASU Feature Plan|План реализации АОП(Апрельское обновление ПО)]]
*[[Community Repository|Публикация вашего проекта]]
*[[GroupSales|Групповые продажи]]
*[[WhyOpenmoko|Почему Openmoko лучше: Сравнительный Взгляд]]
==Ежедневные Сборки==
*Здесь вы всегда можете загрузить последнюю сборку.
** Для FreeRunner [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
** Для Neo 1973 [http://downloads.openmoko.org/daily/ http://downloads.openmoko.org/daily/]
*Обзоры ежденевных сборок [[Snapshot_review|здесь]], рекомендуемое ядро и корневой образ с обзором будут всегда доступны [http://downloads.openmoko.org/releases/ здесь].
Заметим, что рекомендованные сборки, не всегда являются последними, но они самые стабильные, надежные и функциональные.
|valign="top" style="background:#333333;border-left:5px solid white;border-right:5px solid white;border-bottom:0px solid white; border:1px solid #cccccc; " |

== Обновления Сообщества==
Просмотр текущего статуса [[Community_Updates|Обновлений Сообщества]]

 ※[[:Category:Community| Узнать больше о Сообществе...]]

==Обзор Вики==
*Для получения обзора Openmoko Вики, смотрите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].
==События==
*[[Summer of Code 2008]]
*[[Openmoko Education/zh tw]]
*[[Events:FOSDEM 2008]]
*[[OpenLab]]

 ※[[:Category:Event| Узнать больше о Событиях...]]

|}

==Openmoko Wiki - с чего начать==
Энциклопедия Openmoko открытая. Каждый может присоединиться. Вы сможете найти любую информацию, в том числе: аппаратную и программную документацию, списки ошибок, новости сообщества Openmoko и другое. Присоединяйтесь к энциклопедии, редактируйте ее, наполняйте материалами и помогайте другим. Для полного обзора Openmoko Wiki, пожалуйста посетите [[Openmoko Wiki Official Index Page|Оффициальную Страницу Openmoko Wiki]].

* Пожалуйста прочтите наше [[Openmoko Wiki Editing Guidelines|Руководство по Редактированию Openmoko Wiki]]
* [http://www.mediawiki.org/wiki/Help:Configuration_settings Настройка параметров списка]
* [http://meta.wikimedia.org/wiki/Help:Wikitext_reference Руководство по MediaWiki и Wikitext]
* [http://www.mediawiki.org/wiki/Help:FAQ MediaWiki ЧАВО]

User:Narmo

2008-11-01T18:52:17Z

Narmo: /* Narmo */

I've bought OpenMoko Neo FreeRunner on 1st, November, 2008.

== Links ==

[http://werewolf.weho.ru My private blog]

[http://weho.ru Developers' blog]

User:Narmo

2008-11-01T18:50:51Z

Narmo: New page: = Narmo = I've bought OpenMoko Neo FreeRunner on 1st, November, 2008.

= Narmo =

I've bought OpenMoko Neo FreeRunner on 1st, November, 2008.