Openmoko - User contributions [en]

Community Updates/2009-10-28

2009-10-29T07:38:20Z

Any Key: cleaning

====='''Period 2009-10-15 to 2009-10-28'''=====

==Distributions==
{{DistributionBox|
Name=Hackable:1 [rev5]|
Description=Hackable:1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform. See Architecture for details.

The goals are:

* provide a Stable platform for development
* encourage Quick start
* enjoy Ease of development |
Screenshot=Hackable-1-Screenshot-today.png|
Codename='chuck'|
Homepage=http://www.hackable1.org/|
Image=http://www.hackable1.org/wiki/Downloads Images|
Works={{Works on Hackable:1}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=kbosd|
Description=Small and simple virtual keyboard for OpenMoko FreeRunner, inspired from fatfingershell.
The idea was to use XShape extention to display the virtual keyboard above the terminal|
Screenshot=Kbosd screenshot.png|
Homepage=http://gitorious.org/kbosd|
TestedOn=hackable:1 rev5|
PackageName=not known yet
}}

===Application Updates===
{{ApplicationBox|
Name=xminimokostatus|
Description=xminimokostatus is the background on the root window of [[Minimoko]], a fast and lean Desktop based on shr, openbox and idesk using DBUS in C with glib|
Screenshot=Mini-1_1.png|
Homepage=http://wiki.openmoko.org/wiki/Minimoko|
TestedOn=SHR-Unstable|
PackageName=[http://wiki.openmoko.org/wiki/Minimokostatus Minimokostatus]
}}

{{ApplicationBox|
Name=ffalarms 0.3|
Description=ffalarms is a finger friendly alarms application.
Notes:
* add support for recurring alarms, attaching messages to alarms, and
choosing alarm date from a calendar
* add configuration option for alarm volume, alarm_script and alsa_state|
Screenshot=Ffalarms_0.2.4_add.png|
Homepage=http://projects.openmoko.org/projects/ffalarms/|
TestedOn=SHR|
PackageName=[http://projects.openmoko.org/frs/download.php/915/ffalarms_0.3-r0_armv4t.ipk ffalarms]
}}
==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..

*[[Image:Gry_e-wm.png|100px|right]] '''[http://www.opkg.org/package_291.html gry* Illume Theme 0.2]''' and [[Image:Gry_elm.png|100px|right]] '''[http://www.opkg.org/package_290.html gry* Elementary Theme 0.8]''' released.
** fast as hell! (as fast as the nEo themes, probably faster in some situations)
** shiny, inspired by the b&w smooth as silk theme
** survive opkg upgrade
** are still beauties even with software_16
** integrate well with default shr etk theme
** allow 'launcher' users to use dark as well as bright backgrounds while maintaining labels readable
** flower power! (the flowers were removed due to environmental reasons, but i still like to think the theme is powered by daisies and sunflowers)
Questions/Suggestions should be posted [http://jmccloud.jm.funpic.de here]

==Event News==
* '''2009-11-08''' '''[http://www.linuxalt.cz LinuxAlt]''' Lecture about Openmoko and community meeting.
* '''2010-02-6/7''' '''[http://www.fosdem.org FOSDEM]''' sign up to [[Fosdem 2010]] if you're going to be there and tell us what you're willing to do

==Openmoko Development Survey==
Kerstin from Open Innovation Projects has completed a survey on the influence of open source development in the openmoko project. The full results are available here: http://open-innovation-projects.org/openmoko-survey-results/

The results of the survey shouldn't be too much of a surprise given the nature of this particular project. The overwhelming majority of respondents agree with statements like "I really care about the fate of the project" and "I enjoy being part of this community". The community is mostly male, young (average age = 30) and well educated with over half of respondents indicating they have at least a university level degree.

===Work Distribution===
With regard to the split between developers and users, the community seems to be led by a small number of lead developers committing the majority of the work. The largest group indentify themselves as part of the community with just under a third identifying themselves as end-users.

===Documentation===
Access to documentation is important for the members of the openmoko community. The level of access granted to the community is satisfactory with over half of members indicating a strong degree of satisfaction with the level of access to software documentation and just under half for the hardware documentation. The community is satisfied with the ease of access to the community documentation with less than 5% of respondents finding it difficult to access software/hardware documentation. The community documentation is deemed to be useful by the majority of respondents. However, the number of respondents finding it difficult to contribute due to lack of information suggests a disparity between the perceived ease of access and value of documentation and the breadth of coverage. Few respondents were completely satisfied by the available information. The story is a little worse for 3rd party documentation as is to be expected. This can be considered an area for improvement. The level of access granted to documentation has a bearing on the satisfaction of developers as shown by the level of satisfation with the completeness of the documentation.

===Community Influence===
Despite the fact that few respondents indicated a leading role in the development of software and identified themselves as end users or community members they majority felt they were able to influence the direction of the project. This indicates that the lead developers are listening to users and there seems to be a high level of satisfaction amongst users with their ability to influence the direction of development.

[[Category:Community Update]]

Community Updates/2009-11-11

2009-10-29T07:29:42Z

Any Key: changed dates

Talk:Community Updates/2009-11-11

2009-10-29T07:25:58Z

Any Key: New page: ==Welcome== Here you can get a clue on how to contribute to Community updates, while conforming to wiki editing guidelines. You can take a look at [[Community_Update_Draft|Community_Update...

==Welcome==
Here you can get a clue on how to contribute to Community updates, while conforming to wiki editing guidelines. You can take a look at [[Community_Update_Draft|Community_Update_Draft]], to have a feel how coming update draft would look like, if we follow all these standarised wiki guidelines. Feel free to discuss here about this topic, maybe we achieve consensus before next CU. Everybody is welcome to help. Following are main topics which should be covered.

==Guidelines==
Conform to [[Openmoko Wiki Editing Guidelines]]. These guidelines covers most of uncertain cases an editor might run into while editing wiki pages. It takes half an hour to dig through this, but is worth to do it at least summarily.

==Editing==
Conform to [[Help:Editing]]

==Creating new templates==
Using Template:ApplicationBox is great idea! Why not create similar templates for other parts of CU? The disadvantage of this way would be little more code to fill, but all entries in particular part of CU would have similar layout. Following this idea [[Template:DistributionBox]] is currently being developed. You can see preview on [[Community_Update_Draft]] in Distribution section.
* Currently there is voting ongoing on [mailto:community@lists.openmoko.org community] mailing list. Come on in and vote for your favourite template, or leave comment here!

==Mailing list interface==
Often there is a need to provide link pointing to discussion on a mailing list. Services providing web interface to mailing lists (like nabble.com) were [http://lists.openmoko.org/pipermail/community/2009-June/050363.html reported] many times to break discussion threads in mail clients. Remember, mailing lists were designed to be used with mail clients, not with web forums. If you need to provide link to discussion on mailinglist for those who are not subscribed, use mailing list archives.
* Go to [http://news.gmane.org/index.php?prefix=gmane.comp.handhelds.openmoko gname]
* choose a mailing list
* From top panel choose a post (preferably the one on the top of a thread)
* At bottom panel click "Subject:" link
* Copy URL from your browser into Community Update

Community Updates/2009-11-11

2009-10-29T07:25:14Z

Any Key: initial edit

Talk:Community Updates/Draft 2009-10-28

2009-10-29T07:19:51Z

Any Key: Talk:Community Updates/Draft 2009-10-28 moved to Talk:Community Updates/2009-10-28: 2009-10-28 is over lets release

#REDIRECT [[Talk:Community Updates/2009-10-28]]

Community Updates/Draft 2009-10-28

2009-10-29T07:19:51Z

Any Key: Community Updates/Draft 2009-10-28 moved to Community Updates/2009-10-28: 2009-10-28 is over lets release

#REDIRECT [[Community Updates/2009-10-28]]

Talk:Community Updates/2009-10-28

2009-10-29T07:19:51Z

Any Key: Talk:Community Updates/Draft 2009-10-28 moved to Talk:Community Updates/2009-10-28: 2009-10-28 is over lets release

I've added a section on the community survey. Please feel free to add more descriptive comments at the end. At the moment it is really just a summary of the results.

==Welcome==
Here you can get a clue on how to contribute to Community updates, while conforming to wiki editing guidelines. You can take a look at [[Community_Update_Draft|Community_Update_Draft]], to have a feel how coming update draft would look like, if we follow all these standarised wiki guidelines. Feel free to discuss here about this topic, maybe we achieve consensus before next CU. Everybody is welcome to help. Following are main topics which should be covered.

==Guidelines==
Conform to [[Openmoko Wiki Editing Guidelines]]. These guidelines covers most of uncertain cases an editor might run into while editing wiki pages. It takes half an hour to dig through this, but is worth to do it at least summarily.

==Editing==
Conform to [[Help:Editing]]

==Creating new templates==
Using Template:ApplicationBox is great idea! Why not create similar templates for other parts of CU? The disadvantage of this way would be little more code to fill, but all entries in particular part of CU would have similar layout. Following this idea [[Template:DistributionBox]] is currently being developed. You can see preview on [[Community_Update_Draft]] in Distribution section.
* Currently there is voting ongoing on [mailto:community@lists.openmoko.org community] mailing list. Come on in and vote for your favourite template, or leave comment here!

==Mailing list interface==
Often there is a need to provide link pointing to discussion on a mailing list. Services providing web interface to mailing lists (like nabble.com) were [http://lists.openmoko.org/pipermail/community/2009-June/050363.html reported] many times to break discussion threads in mail clients. Remember, mailing lists were designed to be used with mail clients, not with web forums. If you need to provide link to discussion on mailinglist for those who are not subscribed, use mailing list archives.
* Go to [http://news.gmane.org/index.php?prefix=gmane.comp.handhelds.openmoko gname]
* choose a mailing list
* From top panel choose a post (preferably the one on the top of a thread)
* At bottom panel click "Subject:" link
* Copy URL from your browser into Community Update

Community Updates/2009-10-28

2009-10-29T07:19:51Z

Any Key: Community Updates/Draft 2009-10-28 moved to Community Updates/2009-10-28: 2009-10-28 is over lets release

====='''Period 2009-10-15 to 2009-10-28'''=====

==Distributions==
{{DistributionBox|
Name=Hackable:1 [rev5]|
Description=Hackable:1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform. See Architecture for details.

The goals are:

* provide a Stable platform for development
* encourage Quick start
* enjoy Ease of development |
Screenshot=Hackable-1-Screenshot-today.png|
Codename='chuck'|
Homepage=http://www.hackable1.org/|
Image=http://www.hackable1.org/wiki/Downloads Images|
Works={{Works on Hackable:1}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=kbosd|
Description=Small and simple virtual keyboard for OpenMoko FreeRunner, inspired from fatfingershell.
The idea was to use XShape extention to display the virtual keyboard above the terminal|
Screenshot=Kbosd screenshot.png|
Homepage=http://gitorious.org/kbosd|
TestedOn=hackable:1 rev5|
PackageName=not known yet
}}

===Application Updates===
{{ApplicationBox|
Name=xminimokostatus|
Description=xminimokostatus is the background on the root window of [[Minimoko]], a fast and lean Desktop based on shr, openbox and idesk using DBUS in C with glib|
Screenshot=Mini-1_1.png|
Homepage=http://wiki.openmoko.org/wiki/Minimoko|
TestedOn=SHR-Unstable|
PackageName=[http://wiki.openmoko.org/wiki/Minimokostatus Minimokostatus]
}}

{{ApplicationBox|
Name=ffalarms 0.3|
Description=ffalarms is a finger friendly alarms application.
Notes:
* add support for recurring alarms, attaching messages to alarms, and
choosing alarm date from a calendar
* add configuration option for alarm volume, alarm_script and alsa_state|
Screenshot=Ffalarms_0.2.4_add.png|
Homepage=http://projects.openmoko.org/projects/ffalarms/|
TestedOn=SHR|
PackageName=[http://projects.openmoko.org/frs/download.php/915/ffalarms_0.3-r0_armv4t.ipk ffalarms]
}}
==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..

*[[Image:Gry_e-wm.png|100px|right]] '''[http://www.opkg.org/package_291.html gry* Illume Theme 0.2]''' and [[Image:Gry_elm.png|100px|right]] '''[http://www.opkg.org/package_290.html gry* Elementary Theme 0.8]''' released.
** fast as hell! (as fast as the nEo themes, probably faster in some situations)
** shiny, inspired by the b&w smooth as silk theme
** survive opkg upgrade
** are still beauties even with software_16
** integrate well with default shr etk theme
** allow 'launcher' users to use dark as well as bright backgrounds while maintaining labels readable
** flower power! (the flowers were removed due to environmental reasons, but i still like to think the theme is powered by daisies and sunflowers)
Questions/Suggestions should be posted [http://jmccloud.jm.funpic.de here]

==Event News==
* '''2009-11-08''' '''[http://www.linuxalt.cz LinuxAlt]''' Lecture about Openmoko and community meeting.
* '''2010-02-6/7''' '''[http://www.fosdem.org FOSDEM]''' sign up to [[Fosdem 2010]] if you're going to be there and tell us what you're willing to do
* '''2009-10-DD''' '''[http://example.url.xom Example event]''' add your event here

==Openmoko Development Survey==
Kerstin from Open Innovation Projects has completed a survey on the influence of open source development in the openmoko project. The full results are available here: http://open-innovation-projects.org/openmoko-survey-results/

The results of the survey shouldn't be too much of a surprise given the nature of this particular project. The overwhelming majority of respondents agree with statements like "I really care about the fate of the project" and "I enjoy being part of this community". The community is mostly male, young (average age = 30) and well educated with over half of respondents indicating they have at least a university level degree.

===Work Distribution===
With regard to the split between developers and users, the community seems to be led by a small number of lead developers committing the majority of the work. The largest group indentify themselves as part of the community with just under a third identifying themselves as end-users.

===Documentation===
Access to documentation is important for the members of the openmoko community. The level of access granted to the community is satisfactory with over half of members indicating a strong degree of satisfaction with the level of access to software documentation and just under half for the hardware documentation. The community is satisfied with the ease of access to the community documentation with less than 5% of respondents finding it difficult to access software/hardware documentation. The community documentation is deemed to be useful by the majority of respondents. However, the number of respondents finding it difficult to contribute due to lack of information suggests a disparity between the perceived ease of access and value of documentation and the breadth of coverage. Few respondents were completely satisfied by the available information. The story is a little worse for 3rd party documentation as is to be expected. This can be considered an area for improvement. The level of access granted to documentation has a bearing on the satisfaction of developers as shown by the level of satisfation with the completeness of the documentation.

===Community Influence===
Despite the fact that few respondents indicated a leading role in the development of software and identified themselves as end users or community members they majority felt they were able to influence the direction of the project. This indicates that the lead developers are listening to users and there seems to be a high level of satisfaction amongst users with their ability to influence the direction of development.

[[Category:Community Update]]

Community Updates/2009-10-28

2009-10-29T07:18:55Z

Any Key: final version

====='''Period 2009-10-15 to 2009-10-28'''=====

==Distributions==
{{DistributionBox|
Name=Hackable:1 [rev5]|
Description=Hackable:1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform. See Architecture for details.

The goals are:

* provide a Stable platform for development
* encourage Quick start
* enjoy Ease of development |
Screenshot=Hackable-1-Screenshot-today.png|
Codename='chuck'|
Homepage=http://www.hackable1.org/|
Image=http://www.hackable1.org/wiki/Downloads Images|
Works={{Works on Hackable:1}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=kbosd|
Description=Small and simple virtual keyboard for OpenMoko FreeRunner, inspired from fatfingershell.
The idea was to use XShape extention to display the virtual keyboard above the terminal|
Screenshot=Kbosd screenshot.png|
Homepage=http://gitorious.org/kbosd|
TestedOn=hackable:1 rev5|
PackageName=not known yet
}}

===Application Updates===
{{ApplicationBox|
Name=xminimokostatus|
Description=xminimokostatus is the background on the root window of [[Minimoko]], a fast and lean Desktop based on shr, openbox and idesk using DBUS in C with glib|
Screenshot=Mini-1_1.png|
Homepage=http://wiki.openmoko.org/wiki/Minimoko|
TestedOn=SHR-Unstable|
PackageName=[http://wiki.openmoko.org/wiki/Minimokostatus Minimokostatus]
}}

{{ApplicationBox|
Name=ffalarms 0.3|
Description=ffalarms is a finger friendly alarms application.
Notes:
* add support for recurring alarms, attaching messages to alarms, and
choosing alarm date from a calendar
* add configuration option for alarm volume, alarm_script and alsa_state|
Screenshot=Ffalarms_0.2.4_add.png|
Homepage=http://projects.openmoko.org/projects/ffalarms/|
TestedOn=SHR|
PackageName=[http://projects.openmoko.org/frs/download.php/915/ffalarms_0.3-r0_armv4t.ipk ffalarms]
}}
==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..

*[[Image:Gry_e-wm.png|100px|right]] '''[http://www.opkg.org/package_291.html gry* Illume Theme 0.2]''' and [[Image:Gry_elm.png|100px|right]] '''[http://www.opkg.org/package_290.html gry* Elementary Theme 0.8]''' released.
** fast as hell! (as fast as the nEo themes, probably faster in some situations)
** shiny, inspired by the b&w smooth as silk theme
** survive opkg upgrade
** are still beauties even with software_16
** integrate well with default shr etk theme
** allow 'launcher' users to use dark as well as bright backgrounds while maintaining labels readable
** flower power! (the flowers were removed due to environmental reasons, but i still like to think the theme is powered by daisies and sunflowers)
Questions/Suggestions should be posted [http://jmccloud.jm.funpic.de here]

==Event News==
* '''2009-11-08''' '''[http://www.linuxalt.cz LinuxAlt]''' Lecture about Openmoko and community meeting.
* '''2010-02-6/7''' '''[http://www.fosdem.org FOSDEM]''' sign up to [[Fosdem 2010]] if you're going to be there and tell us what you're willing to do
* '''2009-10-DD''' '''[http://example.url.xom Example event]''' add your event here

==Openmoko Development Survey==
Kerstin from Open Innovation Projects has completed a survey on the influence of open source development in the openmoko project. The full results are available here: http://open-innovation-projects.org/openmoko-survey-results/

The results of the survey shouldn't be too much of a surprise given the nature of this particular project. The overwhelming majority of respondents agree with statements like "I really care about the fate of the project" and "I enjoy being part of this community". The community is mostly male, young (average age = 30) and well educated with over half of respondents indicating they have at least a university level degree.

===Work Distribution===
With regard to the split between developers and users, the community seems to be led by a small number of lead developers committing the majority of the work. The largest group indentify themselves as part of the community with just under a third identifying themselves as end-users.

===Documentation===
Access to documentation is important for the members of the openmoko community. The level of access granted to the community is satisfactory with over half of members indicating a strong degree of satisfaction with the level of access to software documentation and just under half for the hardware documentation. The community is satisfied with the ease of access to the community documentation with less than 5% of respondents finding it difficult to access software/hardware documentation. The community documentation is deemed to be useful by the majority of respondents. However, the number of respondents finding it difficult to contribute due to lack of information suggests a disparity between the perceived ease of access and value of documentation and the breadth of coverage. Few respondents were completely satisfied by the available information. The story is a little worse for 3rd party documentation as is to be expected. This can be considered an area for improvement. The level of access granted to documentation has a bearing on the satisfaction of developers as shown by the level of satisfation with the completeness of the documentation.

===Community Influence===
Despite the fact that few respondents indicated a leading role in the development of software and identified themselves as end users or community members they majority felt they were able to influence the direction of the project. This indicates that the lead developers are listening to users and there seems to be a high level of satisfaction amongst users with their ability to influence the direction of development.

[[Category:Community Update]]

File:Kbosd screenshot.png

2009-10-29T07:02:51Z

Any Key:

Community Updates/2009-10-28

2009-10-29T06:51:40Z

Any Key: /* Distributions */

{{Improve}}
{{Note|
*Take a moment and look at Discussion page to get a clue on how to contribute to Community Updates while following OM wiki editing guidelines please.
*I you are planning longer edition, please use <nowiki>{{Editing|your_username_here|date_here|editing_summary_here}}tag. Remember to remove/comment out it right after you save your work.</nowiki>
*Please fill in everything you think the community should know.
*On 2009-10-28 this content will be _moved_ to http://wiki.openmoko.org/wiki/Community_Updates/2009-10-28, feel free to do it.
*Post a note about CU release on the community mailing list.
}}



====='''Period 2009-10-15 to 2009-10-28'''=====

==Distributions==
{{DistributionBox|
Name=Distro Name [version]|
Description=Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.|
Screenshot=System_boot.png|
Codename='codename'|
Homepage=http://www.homepage.org|
Image=[http://www.homepage.org/path/to/ images]|
Works={{Works}}
}}
{{DistributionBox|
Name=Hackable:1 [rev5]|
Description=Hackable:1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and implements the GNOME mobile platform. See Architecture for details.

The goals are:

* provide a Stable platform for development
* encourage Quick start
* enjoy Ease of development |
Screenshot=Hackable-1-Screenshot-today.png|
Codename='chuck'|
Homepage=http://www.hackable1.org/|
Image=http://www.hackable1.org/wiki/Downloads Images|
Works={{Works on Hackable:1}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff..|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=SHR-Unstable,Om2009T5|
PackageName=[http://www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

===Application Updates===
{{ApplicationBox|
Name=xminimokostatus|
Description=xminimokostatus is the background on the root window of [[Minimoko]], a fast and lean Desktop based on shr, openbox and idesk using DBUS in C with glib|
Screenshot=Mini-1_1.png|
Homepage=http://wiki.openmoko.org/wiki/Minimoko|
TestedOn=SHR-Unstable|
PackageName=[http://wiki.openmoko.org/wiki/Minimokostatus Minimokostatus]
}}

==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..

*[[Image:Gry_e-wm.png|100px|right]] '''[http://www.opkg.org/package_291.html gry* Illume Theme 0.2]''' and [[Image:Gry_elm.png|100px|right]] '''[http://www.opkg.org/package_290.html gry* Elementary Theme 0.8]''' released.
** fast as hell! (as fast as the nEo themes, probably faster in some situations)
** shiny, inspired by the b&w smooth as silk theme
** survive opkg upgrade
** are still beauties even with software_16
** integrate well with default shr etk theme
** allow 'launcher' users to use dark as well as bright backgrounds while maintaining labels readable
** flower power! (the flowers were removed due to environmental reasons, but i still like to think the theme is powered by daisies and sunflowers)
Questions/Suggestions should be posted [http://jmccloud.jm.funpic.de here]

==Event News==
* '''2009-11-08''' '''[http://www.linuxalt.cz LinuxAlt]''' Lecture about Openmoko and community meeting.
* '''2010-02-6/7''' '''[http://www.fosdem.org FOSDEM]''' sign up to [[Fosdem 2010]] if you're going to be there and tell us what you're willing to do
* '''2009-10-DD''' '''[http://example.url.xom Example event]''' add your event here

==Openmoko Development Survey==
Kerstin from Open Innovation Projects has completed a survey on the influence of open source development in the openmoko project. The full results are available here: http://open-innovation-projects.org/openmoko-survey-results/

The results of the survey shouldn't be too much of a surprise given the nature of this particular project. The overwhelming majority of respondents agree with statements like "I really care about the fate of the project" and "I enjoy being part of this community". The community is mostly male, young (average age = 30) and well educated with over half of respondents indicating they have at least a university level degree.

===Work Distribution===
With regard to the split between developers and users, the community seems to be led by a small number of lead developers committing the majority of the work. The largest group indentify themselves as part of the community with just under a third identifying themselves as end-users.

===Documentation===
Access to documentation is important for the members of the openmoko community. The level of access granted to the community is satisfactory with over half of members indicating a strong degree of satisfaction with the level of access to software documentation and just under half for the hardware documentation. The community is satisfied with the ease of access to the community documentation with less than 5% of respondents finding it difficult to access software/hardware documentation. The community documentation is deemed to be useful by the majority of respondents. However, the number of respondents finding it difficult to contribute due to lack of information suggests a disparity between the perceived ease of access and value of documentation and the breadth of coverage. Few respondents were completely satisfied by the available information. The story is a little worse for 3rd party documentation as is to be expected. This can be considered an area for improvement. The level of access granted to documentation has a bearing on the satisfaction of developers as shown by the level of satisfation with the completeness of the documentation.

===Community Influence===
Despite the fact that few respondents indicated a leading role in the development of software and identified themselves as end users or community members they majority felt they were able to influence the direction of the project. This indicates that the lead developers are listening to users and there seems to be a high level of satisfaction amongst users with their ability to influence the direction of development.

[[Category:Community Update]]

File:Hackable-1-Screenshot-today.png

2009-10-29T06:50:50Z

Any Key:

List of bluetooth headsets

2009-09-28T06:35:09Z

Any Key: /* Stereo headsets */ minor grammmar

{{todo|All headsets listed on this page need additional testings. Please add your impressions/suggestions}}
{{Improve}}

List of all headsets known to work fully or partially, or don't work at all.

=Mono headsets=

Note: Please report using headset buttons to pick/release call.

{| border="1" cellspacing=0 cellpadding=4
!Model
!Person
!Link to official website
!Price
!GSM Call
!Controls
!Remark
|-
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|-
|no-name "Jabra"
|PaulFertser
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|discovered as "Bluetooth headset"
|-
|"Jabra BT 125"
|chaitanya chandel
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|Connect/Vol
|also responds to IndicateCall
|-
|Plantronics Voyager 855
|DigitalPioneer
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|
|-
|Plantronics Explorer 220
|Vendion
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|
|-
|BT Headset-12
|Vanous
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|no-name
|-
|Insmat (HS200?)
|Rakshasa
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|a real cheap one
|-
|qstarz BT-Q360
|Martin JaMa Jansa
|[http://www.qstarz.com/Products/Bluetooth%20Products/BH-Q360.html www.qstarz.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|
|-
|Iqua BHS-333
|PaulFertser
|{{Unknown}}
|{{Unknown}}
|{{No}}
|{{Unknown}}
|it turns on/off, beeps etc properly, but gives no sound
|-
|Nokia BH-200
|Vanous
|{{Unknown}}
|{{Unknown}}
|{{No}}
|{{Unknown}}
|same as above :(
|}

=Stereo headsets=

Note: None of the below headsets have been tested with GSM calls unless that is explicitly mentioned.

Note: To test play controls (AVRCP) please test with [[Intone]]. For now (31-07-2009) it's only known player to support AVRCP. [[User:Any Key|Any Key]]

{| border="1" cellspacing=0 cellpadding=4
!Model
!Person
!Link to official website
!Price
!A2DP
!GSM Call
!play controls (AVRCP)
!Remark
|-
|B-Speech Calypso
|DJDAS
|[http://www.b-speech.de/en/produkt-information/stereo-headsets-und-adapter/b-speech_calypso/ B-Speech.de]
|{{Unknown}}
|{{Yes}}
|{{Yes}}
|{{Unknown}}
|both A2DP and Headset, tested in FDOM
|-
|BCK-08
|Zorkman
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
| tested on shr unstable from 09 feb) ; very cheap on e-bay (A2DP Stereo Bluetooth Headphone Headset) -ONLY TESTED WITH MUSIC PLAYBACK, NOT GSM CALL-
|-
|Jabra BT3030
|Elleo
|[http://www.jabra.com/Sites/Jabra/na-us/Headsets/Pages/JabraBT3030.aspx www.jabra.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|Tested on SHR with bluez3 and bluez4; A2DP works correctly, GSM calls untested.
|-
|Jabra BT8010
|Montgoss
|[http://www.jabra.com/Sites/Jabra/ee-uk/Headsets/Pages/JabraBT8010.aspx jabra.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Yes}}
|Tested on SHR-Unstable 20090708. A2DP works correctly, GSM calls untested.
|-
|Lubix UBHS-NC1
|Dan Staley
|[http://www.lubixmobile.com/content.php?mode=view&c_idx=c0005&c_type=06&str_block=l001 lubixmobile.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Yes}}
|Stero Music via mplayer or Intone works great. All buttons work. I havent tried GSM calls yet. (Tested on SHR-U)
|-
|Motorola HT820
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|headset (need to restart bluetoothd to get headset working after pairing) tested in SHR testing (and unstable) with bluez4 and kernel 2.6.29
|-
|Motorola S9-HD
|BillK
|[http://www.motorola.com/staticfiles/Consumers/global/flash_content/microsites/s9hd/index.html motorola.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|SHR-unstable - A2DP works fine(mplayer/intone), gsm may work but have NOT tried it. Good for active use (walking/running/bike etc) - but sound may not be highest quality.
|-
|Nokia BH-103
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|tested in Om 2008.12
|-
|Nokia BH-604
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|DJ-style headphones, tested in FDOM and FSO milestone 5

|-
|Plantronix Model 320
|shoragan (#openmoko)
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|tested to work with GSM calls according to shoragan on #openmoko.
|-
|Plantronics Voyager 855
|The Digital Pioneer
|[http://www.plantronics.com/north_america/en_US/products/mobile/bluetooth-headsets/voyager-855 plantronics.com]
|$30-$60 on Newegg
|{{Yes}}
|{{Yes}}
|{{Yes}}
|Stereo for music, mono for calls. Other person reported: stereo bluetooth tested in SHR-Unstable with bluez4 and kernel 2.6.29 -- A2DP/mplayer works perfectly. Works with GSM calls and AVRCP (media player buttons)
|-
|Sennheiser MM200
|CyrusDreams
|[http://www.sennheiser.com/sennheiser/home_en.nsf/root/private_headsets_mobile_music_502411?Open&row=3 sennheiser.com]
|90-160EUR
|{{yes}}
|{{Unknown}}
|{{yes}}
|Manually configured, SHR-unstable, bluez4. A2DP/mplayer works, Intone works with controls. GSM untested.
|-
|Sony Ericsson HBH-DS200
|Valos
|[http://www.sonyericsson.com/cws/products/accessories/overview/hbh-ds200?lc=en&cc=gb sonyericsson.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|tested in SHR-Unstable with bluez4 and kernel 2.6.29 -- A2DP/mplayer works
perfectly; GSM calls not tested yet
|-
|Sony HBH-DS970
|KaZeR
|[http://www.sonyericsson.com/cws/products/accessories/overview/hbh-ds970?lc=en&cc=gb sonyericsson.com]
|{{Unknown}}
|{{Yes}}
|{{Yes}}
|{{Yes}}
|Intone works, with buttons. Calls untested yet
|-
|Venturi Mini
|KaZeR
|[http://www.myventuri.com/home.aspx MyVenturi]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|Intone works, calls and phonebook sync not tested yet.
|-
|Iqua BHS-701
|Yogiz
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Yes}}
|Just tried A2DP for now. Works perfectly, volume controls, track changing, everything. Will try gsm calls later. Used SHR unstable.
|}

[[Category:Headsets]]
[[Category:Bluetooth]]

Community Updates/2009-09-16

2009-09-03T08:29:50Z

Any Key: /* New Applications */

File:Eneolock.jpg

2009-09-03T08:27:52Z

Any Key: ENeoLock screenshot

ENeoLock screenshot

Manually using Bluetooth

2009-08-24T11:00:07Z

Any Key: /* List of known to work headsets */

{{InProgress}}
Bluetooth is one of the core functions of the Neo1973, however it is basically unimplemented on the software side at the moment.
Hardware problems in the P1 phone mean that the CPU has to be active in order to wake on external bluetooth events, which will reduce the battery life to some 2 days at best in standby.

This page details how to use bluetooth from the command line.
We have quite a lot of plans about what exactly Bluetooth should be used for.

'''Please keep in mind that whenever <code>hcid</code> or <code>pand</code> or <code>hidd</code> are mentioned it means that instructions are applicable only to bluez3 systems which is deprecated ages ago. Modern bluez4 uses only one daemon - <code>bluetoothd</code> and you are supposed to use dbus api directly to configure it. For pairing from command line use simple-agent script.'''

== Power it up ==
'''Bluez4-compatible'''

Power up the adapter by clicking on the bluetooth icon in the top bar and selecting power on.

For any FSO-based distro (including SHR) you want to consult [[FSO_Resources]] page.

For others consult your distro's documentation. The most low-level way to power bluetooth on is to
echo 1 > /sys/bus/platform/devices/neo1973-pm-bt.0/power_on

At the shell, "hciconfig" should print information about the adapter if it powered up properly:

hciconfig

The devices should show as UP. If not you can use

hciconfig <device> up

i.e.

hciconfig hci0 up

== How to use bluez4 dbus API ==
'''Bluez4-compatible'''

You can do it with [[OpenmokoFramework/mdbus]] or with <code>dbus-send</code>. To introspect with dbus-send you can employ something like this:
dbus-send --system --dest=org.bluez --print-reply /org/bluez/`pidof bluetoothd`/hci0 org.freedesktop.DBus.Introspectable.Introspect

The next example is how to make your device discoverable:
dbus-send --system --dest=org.bluez --print-reply /org/bluez/`pidof bluetoothd`/hci0 org.bluez.Adapter.SetProperty string:Discoverable variant:boolean:true

== Scanning for bluetooth devices ==
'''Bluez4-compatible'''

hcitool scan

This will list the addresses of any discoverable bluetooth devices in the vicinity

== Pair ==
'''Bluez4-compatible'''

Pairing is nothing special, do it with simple-agent [http://git.kernel.org/?p=bluetooth/bluez.git;a=blob_plain;f=test/simple-agent;hb=HEAD] as described here or with any other agent you like as described in that agent's documentation.

Make sure the bluetooth chip is powered up (see below) and that bluetoothd is running.

Now, to actually pair with other device, you will need the simple-agent script. If you do not have that already, download, put it in /usr/local/bin/ and run '''chmod a+x /usr/local/bin/simple-agent'''

Now put the other device into pairing mode and run '''hcitool scan'''. Find that device and use its address in the command '''simple-agent hci0 XX:XX:XX:XX:XX:XX'''. If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect.

If you give it only one parameter, it will register as an agent and will wait for other devices to initiate pairing. Feel free to tweak that script to your needs (e.g. to hardcode a pin to use).

== HID (Human Input Device) ==
'''Bluez4-compatible'''

Pair with your device first.

Then do
dbus-send --system --dest=org.bluez --print-reply /org/bluez/`pidof bluetoothd`/hci0/dev_00_18_00_00_C2_37 org.bluez.Input.Connect

Where <code>00_18_00_00_C2_37</code> is the address of your HID device. You can query for the device address with:

dbus-send --system --dest=org.bluez --print-reply /org/bluez/`pidof bluetoothd`/hci0 org.bluez.Adapter.ListDevices

Then modprobe the <code>uinput</code> kernel module:
modprobe uinput

Enjoy.

==== Being able to use HID devices ====
'''deprecated bluez3-specific, will be removed'''

If you are trying to connect a keyboard and you have bluez4, see [[Freedom_Slim_Keyboard]].

Using a bluetooth keyboard with the built-in terminal is a little funky... I can only type into the console using the bt keyboard if the onscreen keyboard is visible. Also, pressing "p" twice on the bt keyboard actually gives you a "q".

We want to be able to use a bluetooth keyboard to type into the various applications of our Neo1973.
To use a Bluetooth Keyboard type: (11:22:33:44:55:66 is the Address of your BT-Keyboard)

hidd --connect 11:22:33:44:55:66

and press "Connect" on your BT-KB. Alternately, if you know that only one BT-Keyboard is within range, you can just:

hidd --search

to find and connect to any BT-Keyboard. There are some bluetooth keyboard only support SPP profile can't direct using hidd comannd to connect. Please reference the discussion of this page for more information.

Tested on:
* [http://www.logitech.com/index.cfm/keyboards/keyboard/devices/3848&cl=us,en Logitech diNovo Mini] Works well, very portable and the touchpad also works just fine. Also has no problems with double letters.
* [http://www.logitech.com/index.cfm/products/details/US/EN,CRID=2166,CONTENTID=10717 Logitech Dinovo Edge]
* [http://www.logitech.com/index.cfm/keyboards/keyboard_mice_combos/devices/164&cl=us,en Logitech Dinovo Media Desktop (keyboard)]
* [http://www.nokia.es/A4181580 Nokia SU-8W]. Switched on the BT keyboard, scanned for BT address and ran the connect statement above. Works fine.
* [http://blog.russnelson.com/chordite Chordite]. This keyboard uses the Broadcom BCM2042 BT keyboard controller along with a custom driver.
* [http://www.apple.com/keyboard/ Apple's Aluminum Keyboard]. You may have to add 'auth enable; encrypt enable;' to device {} in hcid.conf. Run the passkey agent the first time. --search works to pair and every time after. (Might be obvious for those who have used BT in other spots, but you have to type in y our passkey on the keyboard as the connect is happening, otherwise pairing doesn't take place. I don't think there is a prompt on the Neo for this)
* [http://www.apple.com/support/keyboard/ Apple's white "Wireless Keyboard (original)"] - details may be the same as above. (tested some time ago)
* [http://www.frogpad.com/ FrogPad] - as above
* [http://freedominput.com The freedom keyboard] and its many rebranded models (they look like this: [http://rabenfrost.net/openmoko/keyboard.jpg]) need 'modprobe uinput' to circumvent the 'Can't open input device: No such file or directory (2)' error of 'hidd --search'. It works as of february 7th 2008.
** Freeedom Universal Keyboard Model G912 does not work (see Discussion Page)
* [http://www.nextag.com/Playstation-3-Logitech-Cordless-564345667/prices-html?nxtg=f8320a24052a-7789F8FE732FF6E3 Logitech Playstation 3 Keyboard] Works well, Mouse pad works.
* [http://corporate.igo.com/product_details.aspx?id=16 iGo Stowaway UltraSlim] (which was apparently discontinued early 2008, but can still be bought in some places) ([[user:ChristW]] I have 2008.8 on it, and using hidd --search to connect to the iGo works perfectly. I also used it to edit a new contact, dial a number and edit a settings text box in [[TangoGPS]]. So far, no problems...)
* [http://www.vkb-support.com/ I-Tech Virtual Laser Keyboard] works. Cursor keys not recognized as such, but produce keycodes than can be mapped.

This is a script that I've ([[User:ChristW]]) been using with varying results. YMMV:
<pre>
echo Power on
echo 1 > /sys/bus/platform/devices/neo1973-pm-bt.0/power_on
sleep 1
echo Reset on
echo 1 > /sys/bus/platform/devices/neo1973-pm-bt.0/reset
sleep 1
echo Reset off
echo 0 > /sys/bus/platform/devices/neo1973-pm-bt.0/reset
sleep 1
echo hciconfig down
hciconfig hci0 down
sleep 1
echo hciconfig up
hciconfig hci0 up
sleep 1
echo Connect
hidd --connect XX:XX:XX:XX:XX:XX
</pre>

(See also [[Freedom_Slim_Keyboard]] for fso scripts which work with bluez4.)

==== Acting as HID device ====

We want to be able to use the Neo as a HID device, being able to use it as controller for presentations. See [[ReMoko]]

== RFCOMM ==
'''i guess it's Bluez4-compatible'''

Here's how to connect to an external Bluetooth GPS and read NMEA data (Tested with a Holux GPSSlim236 and a Nokia LD-3W ).

First, switch on the GPS and identify the BT address:

hcitool scan

Then, edit /etc/bluetooth/rfcomm.conf, which by default has all settings commented out, to something like this:

rfcomm0 {
# Automatically bind the device at startup
bind no;
# Bluetooth address of the device
device 00:11:22:33:44:55;
# RFCOMM channel for the connection (check your GPS docs for details)
channel 1;
# Description of the connection
comment "Bluetooth GPS";
}

Restart the BT services:

root@neo:~$ /etc/init.d/bluetooth stop
root@neo:~$ /etc/init.d/bluetooth start

You should now be able to bind the GPS to /dev/rfcomm0, like this:

root@neo:~$ rfcomm bind 0

Confirm the connect:

root@neo:~$ rfcomm
rfcomm0: 00:11:22:33:44:55 channel 1 clean

... and watch the NMEA strings coming from your GPS:

root@neo:~$ cat /dev/rfcomm0
$GPGGA,111748.000,5907.6964,N,01121.1787,E,1,06,1.2,57.7,M,40.1,M,,0000*6F
$GPRMC,111748.000,A,5907.6964,N,01121.1787,E,0.00,94.94,160807,,,A*50
$GPVTG,94.94,T,,M,0.00,N,0.0,K,A*3D

If you have nothing better to do, you can now pinpoint my office :-).

== OBEX ==
'''Mostly bluez4-compatible, you don't need to edit hcid.conf at all, bluetoothd will take care of using proper parameters itself'''

OBEX (abbreviation of OBject EXchange, also termed IrOBEX) is a communications protocol that facilitates the exchange of binary objects between devices. Here is the notes about how to use OBEX to send/receive files via bluetooth in NEO.

power on bluetooth.

[http://linux.die.net/man/5/hcid.conf hcid.conf]
modify /etc/bluetooth/hcid.conf

<pre>
#
# HCI daemon configuration file.
#

# HCId options
options {
# Automatically initialize new devices
autoinit yes;

# Security Manager mode
# none - Security manager disabled
# auto - Use local PIN for incoming connections
# user - Always ask user for a PIN
#
security auto;

# Pairing mode
# none - Pairing disabled
# multi - Allow pairing with already paired devices
# once - Pair once and deny successive attempts
pairing multi;

# Default PIN code for incoming connections
passkey "1234";
}

# Default settings for HCI devices
device {
# Local device name
# %d - device id
# %h - host name
name "%h-%d";

# Local device class
class 0x000100;

# Default packet type
pkt_type DH1,DM1,HV1;

# Inquiry and Page scan
iscan enable; pscan enable;

# Default link mode
# none - no specific policy
# accept - always accept incoming connections
# master - become master on incoming connections,
# deny role switch on outgoing connections
lm accept;

# Default link policy
# none - no specific policy
# rswitch - allow role switch
# hold - allow hold mode
# sniff - allow sniff mode
# park - allow park mode
lp rswitch,hold,sniff,park;
}
</pre>

[http://linux.die.net/man/8/hcid hcid] - Bluetooth Host Controller Interface Daemon

All paired devices information are stored in /var/lib/bluetooth/BT HW addr folder
eg.
<pre>
root@om-gta02:/var/lib/bluetooth/00:06:6E:16:EB:C7# ls
classes features lastused names panu
config gn manufacturers nap
</pre>

Display local devices
root@om-gta02:/# hcitool dev

Scan all nearby bluetooth devices
root@om-gta02:~# hcitool scan

Browse what kind of services in this device
root@om-gta02:~# sdptool browse 00:18:C5:42:18:78

<pre>
Browsing 00:18:C5:42:18:78 ...

Service Name: OBEX File Transfer
Service RecHandle: 0x1005b
Service Class ID List:
"OBEX File Transfer" (0x1106)
Protocol Descriptor List:
"L2CAP" (0x0100)
"RFCOMM" (0x0003)
Channel: 11
"OBEX" (0x0008)
Language Base Attr List:
code_ISO639: 0x454e
encoding: 0x6a
base_offset: 0x100
Profile Descriptor List:
"OBEX File Transfer" (0x1106)
Version: 0x0100

Service Name: OBEX Object Push
Service RecHandle: 0x1005e
Service Class ID List:
"OBEX Object Push" (0x1105)
Protocol Descriptor List:
"L2CAP" (0x0100)
"RFCOMM" (0x0003)
Channel: 9
"OBEX" (0x0008)
Language Base Attr List:
code_ISO639: 0x454e
encoding: 0x6a
base_offset: 0x100
Profile Descriptor List:
"OBEX Object Push" (0x1105)
Version: 0x0100

</pre>

Use obexpush and obexftp tools

install obexpush, obexftp packages
opkg install obexpush [http://www.go2linux.org/linux-command-line-obexftp-man-page obexftp]

obexpush would launch 'opd' and it's a obex data server. It starts OBEX file transfer service. The default folder is /home/root and it would store all received files here.

<pre>
root@om-gta02:~# ps aux | grep opd
root 1322 0.0 0.4 1972 604 ? Ss 16:21 0:00 opd: waiting for incomming OBEX connections on channel 10...
</pre>

How to pair with a bluetooth device, check [http://wiki.bluez.org/wiki/Security bluez wiki]

== Networking ==

''' Please note that whenever <code>hcid</code> or <code>pand</code> is mentioned it means that instructions are applicable only to bluez3 systems which is deprecated ages ago. Modern bluez4 uses only one daemon - <code>bluetoothd</code> and you are supposed to use dbus api directly to configure it to connect as a client or act as a server. The API is described at [http://git.kernel.org/?p=bluetooth/bluez.git;a=blob;f=doc/network-api.txt;hb=HEAD]. Please update other instructions as soon as you get it working.'''

To ease the task you can try to use [https://launchpad.net/blueman Blueman] GUI software on one or both sides of the link.

=== Information about bluez4 networking ===
'''I managed to successfully connect from PocketPC PDA (used as PANU) to my FR (both NAP and GN configurations worked). Also i was able to use my laptop as PANU and my FR as GN/NAP, reverse should work too'''.

For some reason bluez4 needs ipv6 (fixed on 2009-03-10) and ethernet bridging kernel support. So to avoid more problems you better have it. Also you'll need bnep kernel module.

==== Bluetooth networking concepts ====
This HOW-TO is directly applicable only to bluez3 but still worth reading to understand PANU/GN/NAP roles: [http://bluez.sourceforge.net/contrib/HOWTO-PAN].

In short, GN is network bridge (aka hub/switch), NAP is network router and PANU is a network client.

You can enable or disable various roles by setting <code>Enable</code> property to true/false. Example for GN:
dbus-send --system --dest=org.bluez --print-reply /org/bluez/`pidof bluetoothd`/hci0 org.bluez.NetworkHub.SetProperty string:Enabled variant:boolean:true

For PANU use org.bluez.NetworkPeer interface and for NAP use org.bluez.NetworkRouter.

You might want to know UUID of GN for later use, so you need to read its properties:
dbus-send --system --dest=org.bluez --print-reply /org/bluez/`pidof bluetoothd`/hci0 org.bluez.NetworkHub.GetProperties

To use NAP you'll need to create bridge device manually with
brctl addbr pan1
For GN bridge <code>pan0</code> is created automatically on <code>bluetoothd</code> start.

''I can't see a difference between GN and NAP in the Linux networking context so i suppose GN is the easiest to get going''

==== Pairing ====
Pairing is nothing special, do it with simple-agent as described in other sections or by any other pairing agent.

==== Trust ====
On GN/NAP role you need to ''trust'' the PANU peer:
dbus-send --system --dest=org.bluez --print-reply /org/bluez/`pidof bluetoothd`/hci0/dev_00_06_6E_17_27_E0 org.bluez.Device.SetProperty string:Trusted variant:boolean:true

Where <code>00_06_6E_17_27_E0</code> is the MAC of peer.

==== Connection establishing ====
On PANU you need to have a helper script <code>panu.py</code>:
<pre>
#!/usr/bin/python

import dbus
import sys
import os

bus = dbus.SystemBus()
network = dbus.Interface(bus.get_object("org.bluez",
"/org/bluez/"+sys.argv[1]+"/hci0/"+sys.argv[2]),
"org.bluez.Network")

network.Connect("GN")
print "Networking established, exit the shell to end this session"
os.spawnl(os.P_WAIT, os.environ['SHELL'])
print "Networking released"
</pre>

Then you do:
./panu.py `pidof bluetoothd` dev_00_06_6E_17_27_E0

Where <code>00_16_CE_E4_44_D5</code> is MAC of GN/NAP.

Hopefully after this you'll have two new interfaces <code>bnep0</code> created on both sides and it'll be added to the <code>pan0</code> bridge on GN.

Set up packet forwarding, IP addresses etc. as usual.

==== Using PC's connection from Neo ====

===== Bluetooth networking with a Linux system =====
'''deprecated bluez3-specific, to be removed soon'''

Bluetooth should behave just like our usbnet and provide full TCP/IP access to the phone. BNEP has to be used.

'''On the laptop'''

* Start bluetooth
/etc/init.d/bluetooth start

* Start pand as server
pand -s

* As soon as pand is started on the phone configure your IP address
ip a add 10.0.0.1/24 dev bnep0
ip l set bnep0 up

* Configure IP forwarding and masquerading to your liking (see [[USB_Networking]]). You can even set up Udev rules to do this for you once the bnep0 interface appears.

'''On the Neo'''

* There is a little script that does the steps below (and retries the pand -c command; I had issues with it not working the first time every time) at [[Bt-net-script]] You shouldn't need the other steps below if you use the script.

* Power on bluetooth (see above)

* Scan for the laptop
root@fic-gta01:~$ hcitool scan
Scanning ...
00:0E:6D:C0:0l:6A Sho
00:20:E0:5A:FE:C8 BlueZ (0)

* Connect to the laptop pand
root@fic-gta01:~$ pand -c 00:20:E0:5A:FE:C8

* Configure your IP address
ip a add 10.0.0.2/24 dev bnep0
ip r add default via 10.0.0.1

* Sometimes you may need to bring up the bnep0 on the phone as well:
ip l set bnep0 up
* Enjoy

*--[[User:Mantis|Mantis]] 18:37, 15 October 2008 (UTC) Note for use on OpenSuse 11.0 - I was getting a connection failure with 'Host is down(112)' errors in /var/log/messages (on neo).
I found that editing /etc/bluetooth/hcid.conf to set 'pscan enable' instead of 'pscan disable' and making passkey consistent with Neo Freerunner made it work.

Should see log line like
''pand[17965]: New connection from 00:06:6E:XX:XX:XX at bnep0''

if connection is successful in server's /var/log/messages.

===== Bluetooth networking with a MacOS X system =====

Please refer to [[MacOS_X#Bluetooth_2]]

For using the Neo as a dialup Bluetooth server and the Mac as the client, please see below at [[Manually_using_Bluetooth#PPP_Networking]]

===== Bluetooth networking with a Windows XP system =====

This was tested with a Windows XP SP2 on a IBM Thinkpad T41 with the Widcomm BT stack

* Start bluetooth on Windows XP

* Enable "Network Access" in the Bluetooth configuration

* Scan for the Neo and pair with the Neo (right click, select pair)

On the Neo

* Enable PAN support on the Neo by changing Autostart from false to true in /etc/bluetooth/network.service

* Power on bluetooth (see above)

* Scan for the laptop
root@fic-gta01:~$ hcitool scan
Scanning ...
<laptop_bt_address> Thinkpad
...

* Connect to the laptop pand
pand -c <laptop_bt_address> -r PANU -d NAP -e bnep0 -A -E -S
(add '-n' to see the pand status messages until you get it right)

For some reason, I was not able to initiate PAN connections from the Neo, I got 'Permission denied (13)' even when I had explicitly allowed the Neo to connect (right click on Neo icon, set properties, on Authorization tab). But initiating 'PAN User' from Windows worked when executing on Neo:
pand -l -r PANU -d NAP -e bnep0 -A -E -S
(add '-n' to see the pand status messages until you get it right)

* Configure your IP address. It should work like when connecting to Linux:
ip a add 10.0.0.2/24 dev bnep0
ip r add default via 10.0.0.1
If this does not work, the IP stacks may have auto-assigned network addresses to themselves. You can look this up with 'ifconfig' on the Neo and with 'ipconfig' on Windows.

* You should now be able to ssh/putty from Windows to your Neo. Enjoy!
By setting up the Windows Bluetooth connection properly, it should also be possible to share the Internet Connection of the Windows box with the Neo.

===== PPP Networking =====

If you are unable to use the 'BNEP' method described above, you may be able to use [[PPP]] and a DUN (dialup-networking) emulation mode. On the Neo:

* Edit the /etc/default/bluetooth file and set the following options:
RFCOMM_ENABLE=true
DUND_ENABLE=true
DUND_OPTIONS="--listen --persist call dun"

* Create an /etc/ppp/peers/dun file with options like the following:
115200
192.168.2.202:192.168.2.200
passive
local
noipdefault
noauth
nodefaultroute

* Restart bluetooth (/etc/init.d/bluetooth stop ; /etc/init.d/bluetooth start)

To connect from a MacOS 10.3 client:

* Open "Applications/Utilities/Bluetooth Serial Utility"

* Click on "New"

* Choose a name, then click "Choose Device"

* Locate your Neo, then select the "LAN Access Point" service. If your device is not found, or if this service does not show up, then you will need to troubleshoot and fix that before continuing. Bluetooth is designed for short-range communication, so make sure that the devices are physically close to each other.

* Select "Port type: RS-232" and "Show in Network Preferences". Click OK.

* Open the Network Preferences page then "Show: Network Port Configurations". Enable the new device that you defined in the previous step and drag it to the bottom of the device list (so that it will not interfere with your other network connections)

* Choose "Show: <your-device-name>", then click "Modem"

* Select "Null Modem 115200" from the list of available devices. Uncheck "Wait for dial tone" and "Enable error correction and compression in modem". Optionally check "Show modem status in menu bar".

* Click "Connect". If everything worked, you will end up with a 'ppp0' device on your Mac with a local address of 192.168.2.200 and you will be able to access your Neo at 192.168.2.202.

===== Bluetooth networking with a Linux system - More secure way =====

''Check this, probably needs some corrections''

Bluetooth should behave just like our usbnet and provide full TCP/IP access to the phone. BNEP has to be used.

On the laptop

* check these options in /etc/bluetooth/hcid.conf
security auto;
passkey "your pin";
lm master;

* Start bluetooth
# /etc/init.d/bluetooth start

* Start pand as server
pand --listen --role NAP --encrypt

* Add in /etc/network/interfaces (see [[USB_Networking]])
auto bnep0
iface bnep0 inet static
address 192.168.1.1
netmask 255.255.255.0
network 192.168.1.0
post-up iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.1.0/24
post-up echo 1 > /proc/sys/net/ipv4/ip_forward
post-up iptables -P FORWARD ACCEPT

On the Neo

* Power on bluetooth (see above)

* Scan for the laptop
root@fic-gta01:~$ hcitool scan
Scanning ...
00:20:E0:5A:FE:C8 laptop

* Set pin
root@fic-gta01:~$ passkey-agent 'your pin' 00:20:E0:5A:FE:C8 &

* Connect to the laptop pand
root@fic-gta01:~$ pand -c 00:20:E0:5A:FE:C8

* Configure your IP address
root@fic-gta01:~$ ifconfig bnep0 192.168.1.2
root@fic-gta01:~$ route add default gateway 192.168.1.1

* Enjoy

==== Using Neo's connection from PC ====

===== Calling Neo's GPRS modem via Bluetooth =====

In this mode, Neo would behave like any other phone which can be used from a PC to get a network connection.

This section not written yet. Has someone set it up?

===== Sharing existing Neo's connection =====

In this mode, Neo already has a network connection (GPRS, WLAN, ...), and it should get shared to the PC. This guide is general on how to forward network connection from a machine running Linux to another machine. If interested, please see more information for example at http://www.gentoo.org/doc/en/bluetooth-guide.xml.

On the PC
# Check with hciconfig you have working Bluetooth
On the Neo
(if on Debian etc., remember modprobe ohci_hcd hci_usb)
# Initialize Bluetooth as told before:
## echo 1 > /sys/bus/platform/devices/neo1973-pm-bt.0/power_on
## echo 0 > /sys/bus/platform/devices/neo1973-pm-bt.0/reset
# install iptables: opkg install http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base/iptables_1.3.8-r4.1_armv4t.ipk
# modprobe bnep
# Check that hcid is running both on Neo and PC (Bluetooth 4.x: install bluez-compat)
# Use default passkey "1234" in /etc/bluetooth/hcid.conf
# pand --listen --role NAP --master --autozap # note: after this you might have to the the step 1 below ("On the PC") or the next step of getting the interface up does not work # note2: you could automate pand listener to start automatically when Bluetooth is turned on
# ifconfig bnep0 10.0.5.2 up
# echo 1 > /proc/sys/net/ipv4/ip_forward
# iptables -t nat -A POSTROUTING -j MASQUERADE -o ppp0
On the PC:
# sudo pand --connect <your bluetooth mac address> --service NAP --autozap
# ifconfig bnep0 10.0.5.1 up
# You can test the connection with ping 10.0.5.2
# sudo ip route add default via 10.0.5.2 dev bnep0
# [not automated yet] add GPRS connection's nameservers to /etc/resolv.conf

== Advanced Audio Distribution Profile (A2DP) ==

See [[A2DP]].

== Headset Audio ==

[[Neo1973_Audio_Subsystem]] has detail about alsa settings and a proposal for audio scenario management.

To try this out, follow the instructions on the [[A2DP]] page to install software and run the passkey agent.

Remove or disable the stuff you put in asound.conf. When using a voice headset, the application uses the regular system audio device and it gets routed to bluetooth in the codec.

Put the headset in pairing mode. Replace the bluetooth address below with your headset's and run the python script:

#!/usr/bin/python
import dbus
bus = dbus.SystemBus()
manager = dbus.Interface(bus.get_object('org.bluez', '/org/bluez'), 'org.bluez.Manager')
conn = manager.ActivateService('audio')
audio = dbus.Interface(bus.get_object(conn, '/org/bluez/audio'), 'org.bluez.audio.Manager')
path = audio.CreateHeadset('00:0B:2E:39:33:22')
audio.ChangeDefaultHeadset(path)
headset = dbus.Interface (bus.get_object(conn, path), 'org.bluez.audio.Headset')
headset.Connect()
headset.Play()

Now place a call and try to route it to bluetooth (after it's in progress):

alsactl -f /etc/gsmbluetooth.state restore

You may also be able to listen to system audio given the right state file:

alsactl -f /etc/systembluetooth.state restore
madplay song.mp3

==Bluetooth Headset on Freerunner ==

'''The following describes a procedure applicable only to some old deprecated shit (namely OM2008.x), skip to the next section if you want to see instructions on using BT headset with modern FSO-based distros.'''

[http://lists.openmoko.org/pipermail/support/2008-September/thread.html#2627 This thread] suggests the following:

:Turn on bluetooth. If some of the scripts below fail you may need to reboot [https://docs.openmoko.org/trac/ticket/1744 Bluetooth after suspend]

:Pair your headset according to [http://wiki.bluez.org/ these] instructions or use the script below. The script will change your .asoundrc so make a backup before you run it.

:http://handheldshell.com/BtConfigure.py
:Put the headset in pairing mode ( this only needs to be done once for each new headset ) and run
BtConfigure.py

:Download the the following python scripts to set up the audio service and set the headset as the default device:

:http://handheldshell.com/BtHeadset.py
:http://handheldshell.com/passkey.py
:http://handheldshell.com/BtHeadsetDisconnect.py
:http://handheldshell.com/python-pyalsaaudio_0.3-ml0_armv4t.ipk - can someone add python-pyalsa to the feeds ?

:Download the the following python scripts if you prefer not to mess around with alsactl:

:http://handheldshell.com/pymixer.py
:http://handheldshell.com/volume.desktop

:put pymixer in /usr/bin

chmod u+x /usr/bin/pymixer.py

:put volume.desktop in /usr/share/applications

:Get the [[http://handheldshell.com/gsm_headset.txt alsa state file]] - this state file _WORKS_, mic and earphones are properly routed

cp gsm_headset.txt /usr/share/openmoko/scenarios/btheadset.state

:from the home screen run Volume

:from the terminal run

BtHeadset.py

:Wait until it says waiting for call to end, you should hear static in the headset. If you don't something has gone wrong.

:Now start the call

:In the volume control switch to the btheadset tab. press restore

:You should now hear the call in your headset.

:End the call

BtHeadsetDisconnect.py

:This was all done with the 2008-updates image from sept 4.

:The new scripts rely on a specific format for the .asoundrc . A stanza like this is required :

pcm.headset {
type bluetooth
device <headset mac>
profile "voice"
}

== Once Again, Bluetooth Headset on Freerunner ==
'''Bluez4-compatible'''

=== List of known to work headsets ===
Moved to [[List_of_bluetooth_headsets]]

=== List of non-working headsets ===
'''Iqua BHS-333''' (it turns on/off, beeps etc properly, but gives no sound) -- PaulFertser

'''Nokia BH-200''' same as above :( , will try again --Vanous

=== User reports ===
Heh, firsthand success experience finally :) I did everything according to these instructions, restarted frameworkd, started zhone, used fsoraw to request bluetooth resource (once i needed to press button on headset to turn it on). Call ring sounds at the Freerunner, calls got automatically routed to the headset, the sound was ok both ways (probably some tweaking might be needed depending on your headset's mic sensitivity). Unfortunately, alsa python bindings in Debian are too old so this works only for the first call (updating bindings should solve that). - <i>this is not valid for SHR users, more calls can be placed and even after suspend when the bt device get's disconnected, it can be manually reconnected via dbus call (see bellow) -- Vanous</i>. -- PaulFertser

=== Prerequisites ===
PLEASE NOTE: You will need a recent git revision of frameworkd (latest in SHR-Unstable repos will do) and bluez4 to do this.

If you're using SHR unstable, you already has a correct state file and rules.yaml, so you can skip to the pairing section.

==== State file ====
To prepare, you will need a fixed statefile for bluetooth. You can download this at:
http://dl.getdropbox.com/u/453116/gsmbluetooth.state
You need to put it on your Freerunner in the /usr/share/openmoko/scenarios/ directory.

==== Rules file ====
You will also need to modify your /etc/freesmartphone/oevents/rules.yaml file. You should replace the entire section from '''Call -> Audio Scenario Handling''' (Which is shown) to (but not including) '''while: PowerStatus()''' with the following:

-
#
# Call -> Audio Scenario Handling
#
trigger: IncomingMessage()
actions: MessageTone(play)

-
while: CallListContains("incoming")
filters: Not(CallListContains("active"))
actions:
- RingTone()
- SetDisplayBrightness("0", 90)
- OccupyResource(CPU)

-
while: CallStatus()
filters: Or(HasAttr(status, "outgoing"), HasAttr(status, "active"))
actions:
- OccupyResource(CPU)
-
while: CallStatus()
filters:
- Or(HasAttr(status, "outgoing"), HasAttr(status, "active"))
- Not(BTHeadsetIsConnected())
actions:
- SetScenario(gsmhandset)
-
while: CallStatus()
filters:
- Or(HasAttr(status, "outgoing"), HasAttr(status, "active"))
- BTHeadsetIsConnected()
actions:
- SetScenario(gsmbluetooth)
- BTHeadsetPlaying()
-

Now you will need to restart frameworkd:
/etc/init.d/frameworkd restart
This causes problems for me, so you may find it easier to reboot. (Restarting ophonekitd seems to help with this):

killall ophonekitd && ophonekitd&

=== Pairing ===
Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here:
http://dl.getdropbox.com/u/453116/simple-agent
Put it in /usr/bin/ and run '''chmod a+x /usr/bin/simple-agent'''

Now put your headset into pairing mode and run '''hcitool scan'''. Find your headset and use its address in the command '''simple-agent hci0 XX:XX:XX:XX:XX:XX'''. If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset.

=== Configuring bluez ===
Uncomment '''SCORouting=PCM''' setting in '''[General]''' section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

=== Configuring FSO ===
Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

===Connecting and reconnecting the bt device===

You might need to get the bluetooth headset connected manually on the beggining and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

===Additional helpfull testing commands===
Unfortunately, some headsets do not output any sound while everything else (it turns on, beeps, powers amplifier, turns off) works as expected. The reason is unknown but nevertheless one might try these commands (please don't forget to report the results on ML!):

rmmod sco
modprobe sco disable_esco=1

If you want to manually play with bluetooth and statefiles, take into account that there's a kernel bug that makes loading gsmbluetooth state file not enough to actually work. One has to do

amixer sset "Capture Left Mixer" "Analogue Mix Right"
amixer sset "Capture Left Mixer" "Analogue Mix Left"

every time after loading this statefile.

=== Troubleshooting ===
Ensure you have bluetooth powered and that bluetoothd is running. Read frameworkd log for the hints. Report on IRC/ML.

== Debugging ==

If anything goes wrong, capture the bluetooth traffic with
hcidump -l 4096 -w bt.dump
and attach bt.dump to your bug reports etc.

== Further reading ==

http://www.holtmann.org/papers/bluetooth/ols2006_slides.pdf
http://wiki.bluez.org/wiki/Audio#org.bluez.Audio
http://www.gentoo.org/doc/en/bluetooth-guide.xml

{{Languages|Manually_using_Bluetooth}}

[[Category:Bluetooth| ]]

A2DP

2009-08-24T10:52:50Z

Any Key: /* 6. Devices that work */

List of bluetooth headsets

2009-07-31T14:13:40Z

Any Key: Collected data from ower the wiki to one page

{{todo|All headsets listed on this page need additional testings. Please add your impressions/suggestions}}
{{Improve}}

List of all headsets known to work fully or partially, or don't work at all.

=Mono headsets=

Note: Please report using headset buttons to pick/release call.

{| border="1" cellspacing=0 cellpadding=4
!Model
!Person
!Link to official website
!Price
!GSM Call
!Controlls
!Remark
|-
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|-
|no-name "Jabra"
|PaulFertser
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|discovered as "Bluetooth headset"
|-
|Plantronics Voyager 855
|DigitalPioneer
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|
|-
|Plantronics Explorer 220
|Vendion
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|
|-
|BT Headset-12
|Vanous
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|no-name
|-
|Insmat (HS200?)
|Rakshasa
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|a real cheap one
|-
|qstarz BT-Q360
|Martin JaMa Jansa
|[http://www.qstarz.com/Products/Bluetooth%20Products/BH-Q360.html www.qstarz.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|
|-
|Iqua BHS-333
|PaulFertser
|{{Unknown}}
|{{Unknown}}
|{{No}}
|{{Unknown}}
|it turns on/off, beeps etc properly, but gives no sound
|-
|Nokia BH-200
|Vanous
|{{Unknown}}
|{{Unknown}}
|{{No}}
|{{Unknown}}
|same as above :(
|}

=Stereo headsets=

Note: None of the above headsets have been tested with GSM calls unless that is explicitly mentioned.

Note: To test play controls (AVRCP) please test with [[Intone]]. For now (31-07-2009) it's only known player to support AVRCP. [[User:Any Key|Any Key]]

{| border="1" cellspacing=0 cellpadding=4
!Model
!Person
!Link to official website
!Price
!A2DP
!GSM Call
!play controls (AVRCP)
!Remark
|-
|Sennheiser MM200
|{{Unknown}}
|[http://www.sennheiser.com/sennheiser/home_en.nsf/root/private_headsets_mobile_music_502411?Open&row=3 sennheiser.com]
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|
|-
|Sony HBH-DS970
|KaZeR
|[http://www.sonyericsson.com/cws/products/accessories/overview/hbh-ds970?lc=en&cc=gb sonyericsson.com]
|{{Unknown}}
|{{Yes}}
|{{Yes}}
|{{Yes}}
|Intone works, with buttons. Calls untested yet
|-
|Venturi Mini
|KaZeR
|[http://www.myventuri.com/home.aspx MyVenturi]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|Intone works, calls and phonebook sync not tested yet.
|-
|Plantronics Voyager 855
|The Digital Pioneer
|[http://www.plantronics.com/north_america/en_US/products/mobile/bluetooth-headsets/voyager-855 plantronics.com]
|$30-$60 on Newegg
|{{Yes}}
|{{Yes}}
|{{Yes}}
|Stereo for music, mono for calls. Other person reported: stereo bluetooth tested in SHR-Unstable with bluez4 and kernel 2.6.29 -- A2DP/mplayer works perfectly. Works with GSM calls and AVRCP (media player buttons)
|-
|Lubix UBHS-NC1
|Dan Staley
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|I have to start a song, pause it and then start it again...
|-
|BCK-08
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
| tested on shr unstable from 09 feb) ; very cheap on e-bay (A2DP Stereo Bluetooth Headphone Headset) -ONLY TESTED WITH MUSIC PLAYBACK, NOT GSM CALL-
|-
|Motorola HT820
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|headset (need to restart bluetoothd to get headset working after pairing) tested in SHR testing (and unstable) with bluez4 and kernel 2.6.29
|-
|Motorola S9-HD
|BillK
|[http://www.motorola.com/staticfiles/Consumers/global/flash_content/microsites/s9hd/index.html motorola.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|SHR-unstable - A2DP works fine(mplayer/intone), gsm may work but have NOT tried it. Good for active use (walking/running/bike etc) - but sound may not be highest quality.
|-
|Nokia BH-604
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|DJ-style headphones, tested in FDOM and FSO milestone 5
|-
|Nokia BH-103
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|tested in Om 2008.12
|-
|B-Speech Calypso
|DJDAS
|[http://www.b-speech.de/en/produkt-information/stereo-headsets-und-adapter/b-speech_calypso/ B-Speech.de]
|{{Unknown}}
|{{Yes}}
|{{Yes}}
|{{Unknown}}
|both A2DP and Headset, tested in FDOM
|-
|Sony Ericsson HBH-DS200
|Valos
|[http://www.sonyericsson.com/cws/products/accessories/overview/hbh-ds200?lc=en&cc=gb sonyericsson.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|tested in SHR-Unstable with bluez4 and kernel 2.6.29 -- A2DP/mplayer works
perfectly; GSM calls not tested yet
|-
|Plantronix Model 320
|shoragan (#openmoko)
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|tested to work with GSM calls according to shoragan on #openmoko.
|}

[[Category:Audio]] [[Category:Bluetooth]]

A2DP

2009-07-22T08:18:34Z

Any Key: /* 6. Devices that work */ changу in table style template conformance

The [http://en.wikipedia.org/wiki/A2DP A2DP] bluetooth profile allows high quality audio to be transferred from the phone.

This page describes how to setup A2DP on the Freerunner.

== How to setup A2DP manually ==
This information is mostly taken from [http://lists.openmoko.org/nabble.html#nabble-td2176481 this mail thread]. It has been tested on [[FDOM]] and [[FSO]] milestone 5, but should also work on [[2008.12]].

=== 1. Check installed packages ===
First check that you have the correct package versions installed with {{{opkg list_installed | grep blue}}}. The versions should be these:

bluez-audio - 3.33-r3
bluez-utils - 3.33-r3
bluez-utils-alsa - 3.33-r3
bluez-utils-compat - 3.33-r3
libbluetooth2 - 3.33-r0

=== 1.1 Check installed packages (Bluez4) ===
For user with bluez4 (SHR-unstable ecc.) bluez-audio 3.33 and bluez-utils-alsa 3.33 are not compatible with bluez4

bluez4 - 4.30-r1
connman-plugin-bluetooth - 0.10-r0 -
kernel-module-bluetooth - 2.6.28-oe1+xxxxx
libasound-module-bluez - 4.30-r0
libbluetooth2 - 3.33-r0

If you are willing to risk your installationand want to stay on bluez3, you can remove bluez4 to resolve this issue by doing

opkg remove -recursive bluez4

(will also remove connman-plugin-bluetooth). After that you need to edit /etc/init.d/bluetooth and replace '''DAEMON_NAME=bluetoothd''' with '''DAEMON_NAME=hcid'''. This has been tested and works on FSO MS5.

=== 2. Add bluetooth device to /etc/asound.conf ===
Your /etc/asound.conf should contain these:

pcm.!default {
type plug
slave.pcm "dmix"
}

ctl.mixer0 {
type hw
card 0
}

pcm.bluetooth {
type bluetooth
device "XX:XX:XX:XX:XX:XX"
profile "auto"
}

XX:XX:XX should be replaced with your device ID.

=== 3. Connect to the device ===
Turn on bluetooth in the GUI and then do

export DEVICE=XX:XX:XX:XX:XX:XX

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

passkey-agent --default 0000 &

dbus-send --system --type=method_call --print-reply --dest=org.bluez \
/org/bluez/hci0 org.bluez.Adapter.CreateBonding string:$DEVICE

dbus-send --system --print-reply --dest=org.bluez \
/org/bluez org.bluez.Manager.ActivateService string:audio

dbus-send --system --type=method_call --print-reply --dest=org.bluez \
/org/bluez/audio org.bluez.audio.Manager.CreateDevice string:$DEVICE

dbus-send --system --type=method_call --print-reply --dest=org.bluez \
"/org/bluez/audio/device0" org.bluez.audio.Sink.Connect

If the last step fails, see to it that the device returned in the step before is device0 - otherwise use the other number.

=== 3.1 Connect to the device (Bluez4) ===
Turn on bluetooth in the GUI and then pair with simple-agent (passkey-agent from bluez-utils 3.33 won't work)
simple-agent is included in bluez4 source package (src folder) or you can find it there : http://shr-project.org/trac/wiki/Using

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

python simple-agent hci0 XX:XX:XX:XX:XX:XX

Response is something like this :

RequestPinCode (/org/bluez/XXXX/hci0/dev_XX_XX_XX_XX_XX_XX)
Enter PIN Code: XXXX
Release
New device (/org/bluez/XXXX/hci0/dev_XX_XX_XX_XX_XX_XX)

Now you can start playing, no need to connect manualy.

=== 4. Start playing ===
To play a file with [[mplayer]] use the following command:

mplayer -ao alsa:device=bluetooth /path/to/file.ogg

== 5. Potential troubles ==
* If you experience problems with choppiness, try changing your hcid.conf to include "lm accept,master;" and "lp hold,sniff,park;" You may also have to bond (commonly known as 'pairing') your phone and your headset. See http://wiki.bluez.org/wiki/HOWTO/Bonding for details. [[User:Mercury|Mercury]] 17:36, 5 September 2008 (UTC)

== 6. Devices that work==
Note: None of the above headsets have been tested with GSM calls unless that is explicitely mentioned.

{| border="1" cellspacing=0 cellpadding=4
!Model
!Person
!Link to official website
!Price
!A2DP
!GSM Call
!play controlls
!Remark
|-
|Sennheiser MM200
|{{Unknown}}
|[http://www.sennheiser.com/sennheiser/home_en.nsf/root/private_headsets_mobile_music_502411?Open&row=3 sennheiser.com]
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|
|-
|Sony HBH-DS970
|KaZeR
|[http://www.sonyericsson.com/cws/products/accessories/overview/hbh-ds970?lc=en&cc=gb sonyericsson.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|Intone works. Buttons needs to be tested.
|-
|Plantronics Voyager 855
|The Digital Pioneer
|[http://www.plantronics.com/north_america/en_US/products/mobile/bluetooth-headsets/voyager-855 plantronics.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|Stereo for musics, mono for calls. Other person reported: stereo bluetooth tested in SHR-Unstable with bluez4 and kernel 2.6.29 -- A2DP/mplayer works perfectly; haven't gotten GSM calls working yet
|-
|Lubix UBHS-NC1
|Dan Staley
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|I have to start a song, pause it and then start it again...
|-
|BCK-08
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
| tested on shr unstable from 09 feb) ; very cheap on e-bay (A2DP Stereo Bluetooth Headphone Headset) -ONLY TESTED WITH MUSIC PLAYBACK, NOT GSM CALL-
|-
|Motorola HT820
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|headset (need to restart bluetoothd to get headset working after pairing) tested in SHR testing (and unstable) with bluez4 and kernel 2.6.29
|-
|Motorola S9-HD
|BillK
|[http://www.motorola.com/staticfiles/Consumers/global/flash_content/microsites/s9hd/index.html motorola.com]
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|SHR-unstable - A2DP works fine(mplayer/intone), gsm may work but have NOT tried it. Good for active use (walking/running/bike etc) - but sound may not be highest quality.
|-
|Nokia BH-604
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|DJ-style headphones, tested in FDOM and FSO milestone 5
|-
|Nokia BH-103
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|tested in Om 2008.12
|-
|B-Speech Calypso
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Yes}}
|{{Unknown}}
|both A2DP and Headset, tested in FDOM
|-
|Sony Ericsson HBH-DS200
|{{Unknown}}
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|tested in SHR-Unstable with bluez4 and kernel 2.6.29 -- A2DP/mplayer works
perfectly; haven't gotten GSM calls working yet
|-
|Plantronix Model 320
|shoragan (#openmoko)
|{{Unknown}}
|{{Unknown}}
|{{Yes}}
|{{Unknown}}
|{{Unknown}}
|tested to work with GSM calls according to shoragan on #openmoko.
|}

[[Category:Audio]]

Tichy

2009-05-16T23:40:19Z

Any Key:

{{Languages|Tichy}}

<pre>
_ _
_ (_) | |
_| |_ _ ____| |__ _ _
(_ _) |/ ___) _ \| | | | A Python Applets Manager
| |_| ( (___| | | | |_| |
\__)_|\____)_| |_|\__ | For Openmoko
(____/

</pre>

[[Image:Tichy-main2.png|thumb|tichy main window]]
[[Image:Tichy-drawing.png|thumb|tichy drawing app]]
[[Image:Tichy-style.png|thumb|tichy style app]]
[[Image:Tichy-Media.png|thumb|tichy freedesktop app]]
[[Image:Tichy-Keyboard.png|thumb|tichy keyboard app]]

== Warning ==
Tichy currently diverged back from [[Paroli]].
Tichy is a work in progress, for more information and to understand the goals of tichy, please read the README file included in the source repository.

== Tichy webpage ==
http://code.google.com/p/tichy/

== About ==
Tichy is a python applets manager for embedded devices.

The goal of the project is to make it easy to write many kind of applications for openmoko using the python language.

Tichy provides the following things :
* Graphics User Interface widgets
* Services registering and Requesting (for example an application that wants to send a message will request for an application implementing the message sending service)
* Tasklets system (This allow to write callback waiting process as if they were threads)
* Abstraction of Item / View
* A plug in system that make it easy to add new functionalities / applets to tichy

== How to write an applets / plug-ins for tichy ? ==
Unfortunately There is currently no documentation.

Fortunately it is very easy to do. If you want to write a new applet, you just need to create a new directory in tichy/test/plugins/apps/. You can have a look at the other plug-ins to get an idea of how to do it. A basic app look like this :

<pre>
import tichy
import tichy.gui as gui
import tichy.item as item
from tichy.application import Application

class MyApp(Application):
name = "My Application"
icon = 'icon.png' # to be found in the app directory

def run(self, parent):
w = gui.Window(parent, modal = True) # We run into a new modal window
# Create a new frame with a "back" button on top
frame = gui.ApplicationFrame(w, self, back_button=True)

# This box is used to store the widgets
box = gui.Box(frame, axis=1)

# Create a text item
text = item.Text('click to edit', editable = True)
# Put a view of the item on the screen
text.view(box)

# Add a button
button = gui.Button(box)
gui.Label(button, "click me")

def on_click(b):
# "yield" means "block until the tasklet returns"
yield gui.Message(w, you just clicked the button)
button.connect('clicked', on_click)

yield Wait(frame, 'back') # Wait until the back button is clicked
w.close() # Don't forget to close the window
</pre>

== Authors ==
* Guillaume "Charlie" Chereau, main developer
* Michael "Goodwill"

== Sources ==
Now Tichy hosted on code.google.com so use svn to fetch:
svn checkout http://tichy.googlecode.com/svn/trunk/ tichy-read-only

== Running on the desktop ==
Thanks to the service system, that allows to provide several version of the same service, Tichy can run as well on a desktop computer as on the neo. When run on a desktop, tichy will simulate phone functionalities, when run on the neo, it will use the [[OpenmokoFramework | Framework]].

To run it on the desktop, make sure you have python-pygames installed
sudo apt-get install python-pygame

Then just download the sources, then go into test, and run
./tichy

== Running on neo ==
You will need to compile some files, see the README for more information on how to do it.

== Dependencies ==
You need python 2.5 and some libraries installed :
* python-pygame
* python-dbus
* python-yaml
* python-gst
* python-gobject

== ipkg package ==
A package is available from opkg http://www.opkg.org/package_16.html
[[Category:Application Developer]]

Tichy

2009-05-16T23:24:07Z

Any Key: change in sources

{{Languages|Tichy}}

<pre>
_ _
_ (_) | |
_| |_ _ ____| |__ _ _
(_ _) |/ ___) _ \| | | | A Python Applets Manager
| |_| ( (___| | | | |_| |
\__)_|\____)_| |_|\__ | For Openmoko
(____/

</pre>

[[Image:Tichy-main2.png|thumb|tichy main window]]
[[Image:Tichy-drawing.png|thumb|tichy drawing app]]
[[Image:Tichy-style.png|thumb|tichy style app]]
[[Image:Tichy-Media.png|thumb|tichy freedesktop app]]
[[Image:Tichy-Keyboard.png|thumb|tichy keyboard app]]

== Warning ==

Tichy currently diverged bach from [[Paroli]].

== About ==
Tichy is a python applets manager for embedded devices.

The goal of the project is to make it easy to write many kind of applications for openmoko using the python language.

Tichy provides the following things :
* Graphics User Interface widgets
* Services registering and Requesting (for example an application that wants to send a message will request for an application implementing the message sending service)
* Tasklets system (This allow to write callback waiting process as if they were threads)
* Abstraction of Item / View
* A plug in system that make it easy to add new functionalities / applets to tichy

== How to write an applets / plug-ins for tichy ? ==
Unfortunately There is currently no documentation.

Fortunately it is very easy to do. If you want to write a new applet, you just need to create a new directory in tichy/test/plugins/apps/. You can have a look at the other plug-ins to get an idea of how to do it. A basic app look like this :

<pre>
import tichy
import tichy.gui as gui
import tichy.item as item
from tichy.application import Application

class MyApp(Application):
name = "My Application"
icon = 'icon.png' # to be found in the app directory

def run(self, parent):
w = gui.Window(parent, modal = True) # We run into a new modal window
# Create a new frame with a "back" button on top
frame = gui.ApplicationFrame(w, self, back_button=True)

# This box is used to store the widgets
box = gui.Box(frame, axis=1)

# Create a text item
text = item.Text('click to edit', editable = True)
# Put a view of the item on the screen
text.view(box)

# Add a button
button = gui.Button(box)
gui.Label(button, "click me")

def on_click(b):
# "yield" means "block until the tasklet returns"
yield gui.Message(w, you just clicked the button)
button.connect('clicked', on_click)

yield Wait(frame, 'back') # Wait until the back button is clicked
w.close() # Don't forget to close the window
</pre>

== Authors ==
* Guillaume "Charlie" Chereau, main developer
* Michael "Goodwill"

== Sources ==
Now Tichy hosted on code.google.com so use svn to fetch:
svn checkout http://tichy.googlecode.com/svn/trunk/ tichy-read-only

== Running on the desktop ==
Thanks to the service system, that allows to provide several version of the same service, Tichy can run as well on a desktop computer as on the neo. When run on a desktop, tichy will simulate phone functionalities, when run on the neo, it will use the [[OpenmokoFramework | Framework]].

To run it on the desktop, make sure you have python-pygames installed
sudo apt-get install python-pygame

Then just download the sources, then go into test, and run
./tichy

== Running on neo ==
You will need to compile some files, see the README for more information on how to do it.

== Dependencies ==
You need python 2.5 and some libraries installed :
* python-pygame
* python-dbus
* python-yaml
* python-gst
* python-gobject

== ipkg package ==
A package is available for it in Openmoko Testing and unstable feed. Unfortunately tichy won't work yet, because of a bug in python-pygame in openmoko feeds.

[[Category:Application Developer]]

Template:L10N

2009-04-12T00:38:26Z

Any Key:

<includeonly>{{{{{1}}}|{{{2}}}|{{{3}}}}}</includeonly>

<noinclude>
=Example=
This template has to be used inside a table.
The second table row below is generated by this code:

<pre>

{| class="wikitable sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|-style="background: #ececec; white-space:nowrap;"
!Language
!Status
!Contact
{{L10N|Language|Status|Contact}}
|}
</noinclude>

<noinclude>
Here sits the hidden <nowiki>[[Category:Templates]]</nowiki> link: "[[Category:Templates]]"
</noinclude>

Template:L10N

2009-04-12T00:33:04Z

Any Key:

<includeonly>{{L1|#59dfeb|#ccffff|0N|{{{1}}}|{{{2}}}|{{{3}}}}}</includeonly>

<noinclude>
=Example=
This template has to be used inside a table.
The second table row below is generated by this code:

<pre>
<nowiki>
{{L10N|Language|Status|Contact}}
</nowiki> </pre>

{| class="wikitable sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|-style="background: #ececec; white-space:nowrap;"
!Language
!Status
!Contact
{{L10N|Language|Status|Contact}}
|}
</noinclude>

<noinclude>
Here sits the hidden <nowiki>[[Category:Templates]]</nowiki> link: "[[Category:Templates]]"
</noinclude>

Template:L10N

2009-04-12T00:29:19Z

Any Key:

<includeonly>{{L1|0N|#ccffff|{{{1}}}|{{{2}}}|{{{3}}}|{{{4|}}}}}</includeonly>
<noinclude>
=Example=
This template has to be used inside a table.
The second table row below is generated by this code:

<pre>
<nowiki>
{{L10N|Language|Status|Contact}}
</nowiki> </pre>

{| class="wikitable sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|-style="background: #ececec; white-space:nowrap;"
!Language
!Status
!Contact
{{L10N|Language|Status|Contact}}
|}
</noinclude>

<noinclude>
Here sits the hidden <nowiki>[[Category:Templates]]</nowiki> link: "[[Category:Templates]]"
</noinclude>

Template:L10N

2009-04-12T00:26:30Z

Any Key: New page: <includeonly>{{L10N|#ccffff|{{{1}}}|{{{2}}}|{{{3}}}|{{{4|}}}}}</includeonly><noinclude> =Example= This template has to be used inside a table. The second table row below is generated by th...

<includeonly>{{L10N|#ccffff|{{{1}}}|{{{2}}}|{{{3}}}|{{{4|}}}}}</includeonly><noinclude>
=Example=
This template has to be used inside a table.
The second table row below is generated by this code:

<pre>
<nowiki>
{{L10N|Language|Status|Contact}}
</nowiki> </pre>

{| class="wikitable sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|-style="background: #ececec; white-space:nowrap;"
!Language
!Status
!Contact
{{L10N|Language|Status|Contact}}
|}
</noinclude>

<noinclude>
Here sits the hidden <nowiki>[[Category:Templates]]</nowiki> link: "[[Category:Templates]]"
</noinclude>

Translation

2009-04-12T00:18:17Z

Any Key: Added list of languages & ISO639-2 codes

{{Languages|Translation}}

{|style="float:right;cellpadding:0.5 em;cellspacing:0;border:0.5"
|+ LIst of Languages
|-
!Language!!ISO-639-2
|-
|[[Translation#Afrikaans|Afrikaans]]||af
|-
|[[Translation#Amharic|Amharic]]||am
|-
|[[Translation#Arabic|Arabic]]||ar
|-
|[[Translation#Armenian|Armenian]]||hy
|-
|[[Translation#Basque|Basque]]||eu
|-
|[[Translation#Bulgarian|Bulgarian]]||bg
|-
|[[Translation#Catalan|Catalan]]||ca
|-
|[[Translation#Chinese (Simplified)|Chinese (Simplified)]]||zh_CN
|-
|[[Translation#Chinese (Traditional)|Chinese (Traditional)]]||zh_TW
|-
|[[Translation#Czech|Czech]]||cs
|-
|[[Translation#Danish|Danish]]||da
|-
|[[Translation#Dutch|Dutch]]||nl
|-
|[[Translation#English|English]]||en
|-
|[[Translation#Esperanto|Esperanto]]||eo
|-
|[[Translation#Estonian|Estonian]]||et
|-
|[[Translation#Finnish|Finnish]]||fi
|-
|[[Translation#French|French]]||fr
|-
|[[Translation#Galician|Galician]]||gl
|-
|[[Translation#German|German]]||de
|-
|[[Translation#Greek|Greek]]||el
|-
|[[Translation#Hebrew|Hebrew]]||he
|-
|[[Translation#Hungarian|Hungarian]]||hu
|-
|[[Translation#Indonesian|Indonesian]]||id
|-
|[[Translation#Italian|Italian]]||it
|-
|[[Translation#Japanese|Japanese]]||ja
|-
|[[Translation#Norwegian|Norwegian]]||no
|-
|[[Translation#Panjabi|Panjabi]]||pa
|-
|[[Translation#Polish|Polish]]||pl
|-
|[[Translation#Portuguese|Portuguese]]||pt
|-
|[[Translation#Romanian|Romanian]]||ro
|-
|[[Translation#Russian|Russian]]||ru
|-
|[[Translation#Slovak|Slovak]]||sk
|-
|[[Translation#Spanish|Spanish]]||es
|-
|[[Translation#Swedish|Swedish]]||sv
|-
|[[Translation#Turkish|Turkish]]||tr
|-
|[[Translation#Welsh|Welsh]]||cy
|}

Let us spread the popularity of Openmoko by localization of the software and translation of documentation and wiki.

Just as an overview who is able and willing to translate parts into other languages, please join and add your Language and name. The source for the translation will be English. If you have good English skills then you could contribute by correcting the sources :)

A good point to start would be to continuous translating of
http://en.wikipedia.org/wiki/Openmoko into more languages on the other language sites of wikipedia.

"...it is easy to join and spend some minutes for translating,
and when someone finds some mistakes in any languages don't
blame the translator - just be productive and fix it yourself!" -[[User:RobertMichel|Robert Michel]]

Please take a look at [[Translation HOWTO]] and improve it if possible.

Languages already offered on our community mailinglist, please add your name yourself and join community mailinglist (until we'll have a proper mailinglist) to discuss about translations:

== Afrikaans ==

== Amharic ==
* [[User:ethiopia|Ethiopia Alemayehu]]

== Armenian ==
* [[User:surenk|Suren Karapetyan]]

== Arabic ==
عربي
* Hossam Mahmoud حسام محمود
* [[User:ترجمان05|ترجمان05]]
* [[User:Lixy|Lixy]] 17:54, 21 July 2007 (CEST)
* [[User:Waraqa|Waraqa]]

== Bulgarian ==
* [[User:Mr700|Doncho Nicolaev Gunchev]]

== Basque ==

* [[User:garrop|Ugartemendia]]
* [[User:aritza|aritza]]

== Catalan ==

* [[User:montxovs|Montxo Vicente i Sempere]]

* [[User:Mandarino|Mandarino]]

* [[User:RafaelCarreras|Rafael Carreras]]

* [[User:JaumeI|JaumeI]]

== Chinese (Simplified)==
* [[User:JarodWang|JarodWang]]
* [[User:Liuxf|Liuxf]]
* [[User:sunlt|sunlt]]

== Chinese (Traditional)==
* [[User:coolcat|Brenda Wang]]

== Czech ==
* [[User:Mikesh|Michal Heczko]]
* [[User:Vatoz|Vaclav Cerny]]
* [[User:Fox|Pavel Kovář]] (wiki)

== Danish ==
* [[User:EsbenDamgaard|Esben Damgaard]]
* [[User:UlrikRasmussen|Ulrik Rasmussen]]
* [[User:miki|Mikkel Kirkgaard Nielsen]]

== Dutch ==
* [[User:MarcVerwerft|Marc Verwerft]]
* [[User:Madjo|Marcel De Jong]]
* [[User:LuitvD|Luit van Drongelen]]
* [[User:reinouts|Reinout van Schouwen]]
* [[User:Steamrunner|Koen De Voegt]]

([[User:Madjo|Marcel]] 18/04) Misschien is het handig om alvast te beginnen met vertalen van de Wiki? Of hebben jullie andere ideeen? Ik heb al een start gemaakt van de voorpagina van de wiki, maar ben nog niet veel verder gekomen
([[User:reinouts|Reinout]] 21/04) Valt er verder nog niks te vertalen? De wiki is niet echt boeiend.

== Esperanto ==
* [[User:Antono|Antono Vasiljev]]
* [[User:Alekcxjo|Alekĉjo Rajmondo]]

== Estonian ==
* [[User:Hadara|Sven Petai]]
* [[User:Myoldryn|Jaan Nigul]]
* [[User:Yogiz|Yogiz]]

== Finnish ==

See also [[Openmoko Local Groups: Finland]].

Notes to Finnish translators: please use the dictionary at [http://lokalisointi.org/ lokalisointi.org], avoid anglisms, avoid capital letters where unnecessary etc., kiitos :) Also, send new, big translations to [http://lokalisointi.org/mailman/listinfo/laatu laatu] mailing list for review. Until openmoko specific lists, you may join [http://lokalisointi.org/mailman/listinfo/keskustelu keskustelu] list too (it can be used despite the fact it's been silent).

* [[User:Jani-Matti_Hätinen|Jani-Matti Hätinen]]
* [[User:TimoJyrinki|Timo Jyrinki]]
* [[User:Eyec|Samuli Perttula]]
* [[User:TuomoSipola|Tuomo Sipola]]

== French ==
* [[User:SebastienJolicoeur|Sebastien Jolicoeur]]
* [[User:MarcSert|Marc Sert]]
* [[User:FoucaultdeBonneval|Foucault deBonneval]]
* [[User:Sufflope|Jean-Sébastien Bour]]
* [[User:Ymahe|Yves Mahé]]
* [[User:opampca|Richard Lussier, Canada]]
* [[User:Kheldar|Guillaume Maiano]]
* [[User:Thomas01|Thomas Leclere]]
* [[User:fredlala|Frédéric Lasnier]]
* [[User:alekcxjo|Alexandre Raymond]]
* [[User:VdeGrandpré|Vincent de Grandpré, Montréal, Québec]]
* [[User:youshe|Frédéric Bouquet, Grenoble, France]]
* [[User:netdruide|Daniel Pallier, Lampaul-Plouarzel, France]]
* [[User:Pierrebrua|Pierre Brua]]

== Galician ==
* [[User:Fjrial|Frco. Javier Rial]]<br>
[http://www.mancomun.org Mancomun]<br>
Para poñerse en contacto enviar un correo-e a rolda http://listas.mancomun.org/mailman/listinfo/g11n

== German ==
* [[User:RobertMichel|Robert Michel]]
* [[User:FabianOff|Fabian Off]]
* [[User:Denis std|Denis]]
* [[User:ktd85|Thomas Drewermann]]
* Lars C.
* [[User:AndreasHochsteger|Andreas Hochsteger]]
* [[User:Christophloew|Christoph Löw]]
* [[User:dFence|Daniel Zauner]]
* [[User:Imitation|Thomas Sanladerer]]
* [[User:Peter Santo|Peter Santo]]
* [[User:Bartholomaus|Marco K.]]
* [[User:Gorschkow|Andre Gorschkow]]
* [[User:Klischeepunk|David Dorst]]

== Greek ==
* [[User:Chronix|Polychronis Papadakis]]

== Hebrew ==
עברית
* [[User:YaronSh|Yaron Shahrabani]]
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:Any_Key|Any_Key]]
* [[User:Koala|Koala]]

== Hungarian ==
* [[User:ZeD|Zoltán Balogh]]

== Indonesian ==
* [[User:Hcblue|Hcblue]]

== Italian ==
* per il momento useremo [http://www.openmokoboard.com/index.php?getforum=10 questo forum] per organizzarci. iscrivetevi e partecipate.
* [[User:SergioTota|Sergio Tota]]
* [[User:Franco|Franco Rimoldi]]
* [[User:Filippo|Filippo]]
* [[User:Massi|Massimiliano]]
* [[User:Markk0|Marco Cattaneo]]
* [[User:Cga|Callea Gaetano Andrea]]
* [[User:Herod2k|Alessandro]]
* [[User:shainer|Lisa Vitolo]]
* [[User:tia1982|Mattia]]
* [[User:azanutta|abe]]
* [[User:Gualti|Gualtiero]]
* [[User:Milo|Milo Casagrande]]
* [[User:White|Marco Celeri]]
* [[User:Aegis|Maurizio Scorianz]]

== Japanese ==
*[[User:WilliamLai|William Lai]]
*[[Momoko Matsuzaki]]

== Norwegian ==
*[[User:Vegar|Vegar Storvann]]
*[[User:Denniz|Denniz Fjerdingby]]
*[[User:StianEllingsen|Stian Ellingsen]]

== Polish ==
* [[User:KrzysztofKajkowski|Krzysztof Kajkowski]]
* Tomasz Zieliński
* [[User:MaciejLigenza|Maciej Ligenza]]
* [[User:PiotrDuda|Piotr Duda]]
* [[User:Zbraniecki|Zbigniew Braniecki]]

== Portuguese ==
*[[User:Skull Death|James Côrtes]]
* Sergio Bessa
* Mario Costa
*[[User:kuyky|Tiago Saraiva]]

== Panjabi ==
* [[User:aalam|A S Alam]]

== Romanian ==

* [[User:alexxed|Alexandru Szasz]]
* [[User:sin|Lucian]]
* [[User:Adrians|Adrians]]

== Russian ==
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:DenisBY|Denis Kot]]
* [[User:MikhailGusarov|Mikhail Gusarov]]
* [[User:x-demon|Alexander Sokolow]]
* [[User:Any_Key|Any_Key]]
* [[User:Dmitri|Dmitri]]
* [[User:Buffet|Denis Kaledin]]
* [[User:Nes|Mike Drapolyuk]]
* [[User:vase|Vasiliy Tolstov]]
* [[User:Shadowjack|Shadowjack]]
* [[User:Cray|Denis Parchenko]]
* [[User:Vlad|Vladimir Orlov]]
* [[User:xnike|Nikolay Khramchenkov]]
* [[User:kainspb|Nikolay Kasatkin]]

Можем начинать переводить wiki :)
К любой странице добавляете /ru и переводите. В конце оригинальной страницы и переведенной добавляете ссылку на шаблон
<nowiki>{{Languages|Имя_страницы_оригинала}}</nowiki>

== Slovak ==
* [[User:Cezz|Cezz]]
* [[User:PipBoy2000|PipBoy2000]]
* [[User:m4rtin.m|m4rtin.m]]

== Spanish ==
* [[User:RosangelaCaninoKoning|Rosangela CaninoKoning]]
* [[User:kresp0|Santiago Crespo (kresp0)]]
* [[User:José_Suárez|José Suárez]]
* [[User:Rafa_Couto|Rafa Couto (caligari)]]
* [[User:NeoMorfeo|Guillermo Santos (NeoMorfeo)]]
* [[User:Mandarino|Mandarino]]
* [[User:pptudela|Pepe Tudela]]
* [[User:avathar|Fernando González (Avathar)]]
* [[User:Rbruzz|Rbruzz]]
* [[User:Saaib|Urivan Flores Saaib (Saaib)]]
* [[User:mutrox|David Samblas Martinez (mutrox)]]

== Swedish ==
* [[User:yeager|Daniel Nylander]]
* [[User:possan|Per-Olov Jernberg]]
* [[User:C.M|Claes Mogren]]

== Turkish ==
* [[User:EnginErenturk|Engin Erenturk]]
* [[User:Supernova|İsmail AŞCI]]

== Welsh ==
* [[User:Rhoslyn_Prys|Rhoslyn Prys]]

And feel free to join and add an new language to this list above.

[[Category:Wiki Editing]]
[[Category:L10N]]

Getting Started with your Neo FreeRunner

2009-04-11T23:10:05Z

Any Key: /* Buttons and connectors */

{{Languages|Getting Started with your Neo FreeRunner}}

{| class="wikitable" cellspacing="2" cellpadding="2" style="padding: 0%; margin:0em 0em 1em 0em; background:#eeeeee; width:100%;floating="center"; "
! style="background:#fcfcfc; width:75% " |
<p align="left">
Thank you for purchasing this Developer release of Neo FreeRunner. The [[Neo FreeRunner]] phone is the second hardware platform to take advantage of Openmoko. This guide will help you get to know your Neo FreeRunner and how to start using your Neo FreeRunner.</p>

<p align="left">
Some Frequently Asked Questions for new owners are featured in the [[FAQ#Getting_Started_with_your_Neo_FreeRunner|FAQ]].
</p>

! style="background:#fcfcfc; width:25% " |
[[Image:Freerunner box.png|200px|thumb|Neo FreeRunner Package]]
|}
{{Neo FreeRunner Menu}}

== Package Contents ==

[[Image:Openmokset.jpg|left|400px|thumb|Inside the package]]
<br />
: [[Image:Circle２.gif|10px]] Neo FreeRunner
: [[Image:Circle２.gif|10px]] Stylus
: [[Image:Circle２.gif|10px]] Battery
: [[Image:Circle２.gif|10px]] Charger
: [[Image:Circle２.gif|10px]] USB Cable (A -> Mini-B 5-pole)
: [[Image:Circle２.gif|10px]] [[Thank You green card]]
<div style="clear: both"> </div>

{{Note|
== Get the source code ==
The software included in this product contains copyrighted software that is licensed under the [http://downloads.openmoko.org/sources/Om2008.9-Lite.iso GPL]. A complete corresponding source code or CD-ROM ISO image with the GPL license is available for download [http://downloads.openmoko.org/sources/Om2008.9-Lite.iso here]. You may also obtain the same corresponding CD-ROM by sending a money order or check for $10 to any one of our [http://downloads.openmoko.org/sources/Om2008.9-Lite.iso distributors].

Please write “source for Neo FreeRunner ” in the memo line of your payment.
}}

== Setting up the hardware, getting to know the Neo FreeRunner physically ==

===Installing the Micro-SD card, the SIM card, and the Battery ===

[[Image:Circle２.gif|10px]] Remove the rear cover of the Neo FreeRunner by first holding the Neo FreeRunner on the side and then use a credit card (or your fingernail, if you have strong fingernails) to prise off the rear cover at the slot on top of the device.

<table width="80%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
<tr valign="top" style="background: #ffffff">
<td style="width: 50%; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:menu13.jpg|233px|thumb|Open the case like this.|center]]</td>
<td style="padding: 1px 1em 0; background: #ffffff;">[[Image:menu14.jpg|250px|thumb|Opening !|center]]</td>
</tr>
</table>

[[Image:Circle２.gif|10px]] Now you should be able to locate the combined SIM and Micro-SD card holder at the bottom of the battery compartment.

[[Image:Circle２.gif|10px]] Unlock the SIM card holder by sliding the metal clip down, towards the USB socket, with your fingernail. Use caution, as these parts are delicate and could be damaged by forcing them in the wrong direction.

[[Image:menu11.jpg|260px|thumb|Put the SIM card and SD card here.|center]]

[[Image:Circle２.gif|10px]] Lift up on the SIM card holder.

[[Image:Circle２.gif|10px]] The Micro-SD card holder is held in place by a latch on either side. It is easiest to open the Micro-SD card holder by releasing these latches one at a time rather than by lifting from the middle, as lifting from the middle tends to increase the latching pressure. A small screwdriver or knife can be used for this.

[[Image:Circle２.gif|10px]] Insert the Micro-SD card into the Micro-SD card holder. Note that on the inside of metal part of the holder there are little holding tabs for the card. Slide the card in these holders (on the metal part) before closing the card holder. Note that the electrical contacts should face down and towards the edge of the Neo FreeRunner.

[[Image:Circle２.gif|10px]] Close the Micro-SD card holder, making sure that both latches of the holder are securely fastened.

[[Image:Circle２.gif|10px]] Insert the SIM card into the SIM card holder, taking care to slide inside the two metal tabs in the cover. Note that the electrical contacts should face down and that the cut corner should be closest to the external GPS Antenna Socket.

[[Image:Circle２.gif|10px]] Close the SIM card holder and lock it by sliding the metal clip towards the external GPS Antenna Socket on the FreeRunner.
<table width="80%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
<tr valign="top" style="background: #ffffff">
<td style="width: 50%; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">
[[Image:FR_SIM_SD_open.jpg|457px|thumb|SIM and SD holders open, with cards in place|center]]</td>
<td style="padding: 1px 1em 0; background: #ffffff;">
[[Image:Engchang.jpg|392px|thumb|Some models look like this, the little blob is not a defect|center]]</td>
</tr>
</table>

[[Image:Circle２.gif|10px]] Insert the battery into the battery compartment, aligning the electrical contacts on the battery with the electrical contacts in the battery compartment. Insert the side with the electrical contacts first.

[[Image:Circle２.gif|10px]] Replace the rear cover on the FreeRunner.

{| class="wikitable" style="background#00CC00;border-left:1px solid white;border-right:1px solid white;border-top:0px solid white; border:1px solid #00CC00; float:right; margin: 0 0 1em 1em;"
! style="background:#00cc00;border-left:1px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #00CC00;" |<font color=white>Tips</font>
|-
!style="background:#ffffff;border-left:1px solid white;border-right:1px solid white;border-top:0px solid white; border:1px solid #FFFFff;" |
<div align=left>
[http://video.google.de/videoplay?docid=-8343770443102960945 A short video] is also available. It was shot using the previous version of the Neo, but the installation procedure remains the same.
</div>

|}

===Charging the Neo FreeRunner===

Before using the Neo FreeRunner for the first time, you should charge the battery completely. The battery can be charged using the provided charger at 1000mA or from a powered USB port capable of providing 500mA worth of current. Most computers will be able to charge the FreeRunner without any problems.

Neo FreeRunner '''does NOT charge when powered off''', so be sure to turn it on and allow it to boot all the way to the GUI (Graphical User Interface). This should happen automatically when you plug in USB power, either from a computer or the provided charger.

Although the provided charger is rated at 2A, the maximum charge rate of the Neo FreeRunner is 1A, and thus the charge rate with the charger is less than the charger capacity.

The provided charger includes three "national" plugs. The default is North America, with alternative U.K (3 square pins) and Euro (two round pins) adapters. To install the alternative power adapters, depress the latch in the cover (on the opposite side of the charger from the product information label) and slide the cover outward. Note that the two North American pins do not come out; the other adapters slide over them, and snap into place. The two-pin Euro adapter is removed in the same way as the cover. The three-pin U.K. adapter is removed by '''gently''' pressing the dummy ground pin (black) '''toward the end of the adapter with the cord''' and then sliding it off the adapter.

Charging an empty battery at 100mA takes 12~15 hours, at 500mA takes 2,5~3,5 hours, and at 1000mA takes 1.5~2.5 hours. (90%~100%) [to be confirmed]

{{Note|See [[Neo_FreeRunner_Hardware_Issues|Neo FreeRunner Hardware Issues]] about not allowing the battery to discharge completely.}}

===Buttons and connectors===

<table width="80%" style="clear: both; border-collapse: collapse" valign="top">
<tr>
<td style="width: 25px"> </td>
<td style="width: 370px">[[Image:menu9.jpg|370px|thumb|Power Button, USB and external GPS Antenna (left to right)|center]]</td>
<td style="width: 25px"> </td>
<td style="width: 370px">[[Image:menu8.jpg|370px|thumb|AUX Button and headset jack (left to right)|center]]</td>
</tr
<tr>
<td></td>
<td>'''Power'''
Tapping the power button exits the current application.

Holding the power button brings up a menu allowing you to:
* Power on and off the GPS, wifi, GSM, and bluetooth antennae
* Change power management mode to:
** Dim first then lock
** Dim only, don't lock
** Disabled
* Lock the screen
* Shutdown the device.</td>
<td></td>
<td>'''Aux'''
Tapping the Aux button hides or shows the currently running application.

Holding the Aux button brings up a menu allowing you to:

* Hide and show the title bar (Fullscreen toggle)
* Alternate wide or tall display modes (Swap Orientation)
* Save the content of the screen as an image file (Screenshot)
</td>
</tr>
</table>

'''Booting'''

[[Booting the Neo FreeRunner]] takes about 2 minutes overall, so patience is in order. The longest step comes after the Linux boot messages in very small fonts have scrolled by, at the graphical "openmoko" sunrise page.

'''Phone Jack'''

The phone jack is a 2.5mm connector with four contacts: stereo + MIC. It is compatible with the headsets used by Motorola smartphones (A780,A1200, ...) and the V-360.

More information on [[Headset]] page.

===Unlocking the screen===

When the screen is locked, you should see a Matrix-style green graphic with the Openmoko symbol in the middle of the bottom of the screen along with lock and unlock symbols. If you drag the Openmoko symbol to the unlock symbol at the top then the screen will become unlocked.

===Identifying which revision you have===
You will want to determine which revision of the phone you have

* remember your date code, the bottom of your shipping box should have a sticker stating it.
* read [[Finding_hardware_revision]]

These two are important, as they allow you to know which image is flashed on you phone at the factory (c.f. [[Distributions]] and [[Neo_FreeRunner_Hardware#History]]).

== Image Issue==

Because the software changes so rapidly and the phones were imaged during mass production, we don't ship the newest image with phones.
There are two different kinds of images shipped with the phones:

1. [[Om 2007.2]]

2. [[Om 2008.9]]

But according to the [[FAQ]] and [[Distributions]] pages, all phones ship with [[Om 2007.2]]. This distribution is no longer supported, so before even getting your feet wet, you'll probably want to switch to something else, especially since the FreeRunner is not really usable as a mobile phone with these old distributions.

Switching to another distribution is easy if you have a computer with a USB port and internet connectivity that can run the dfu-util utility. Most current Linux distros have packaged dfu-util, so if you use Linux you can probably just get it from your distro's repository. The next step is to choose which Openmoko distribution to switch to. See [[Distributions]] for information about the alternatives.

That page will point you to the files to download, and to the instructions for installing them using dfu-util.

==For Om 2007.2==

===Navigating menus and applications===
====Today Page====

[[Image:Todaypage_reduced_true.png|200px|right]] Openmoko starts by displaying the "Today" page, which is your home page. Icons in the top row indicate the status of the phone. The bottom row consists of three tabs. The tab with a house on the left leads to the "Today" page you're viewing now. The central tab leads to the "Launch Task" page, which is the main menu used to start applications. The tab with gears on the right leads to the "Running Tasks" page, which is used to deal with currently open windows and applications.

<br clear=all />

[[Image:Todaypage_reduced_false.png|right|200px|]] The "Today" page is empty, as shown above, when you first start Openmoko. We explain below how to turn on the "full view", displayed to the right. In the full view, a second row of icons give quick links to commonly-used applications such as the dialer, the adressbook, mailbox and calendar. The main body of the screen displays a clock and other useful information.

See [[Today/2007.2]] for more information about the Today page and customization.

<br clear=all />

====Launch Task Page====

{{stub}}

[[Image:LaunchTasks.png|right|200px]] This page displays a menu of available applications. You may choose a category of applications to display to simplify the screen, or choose to display them all.

Current categories are [PIM Suite], [[Om_2007.2_Applications|Applications]], [[Games/Om 2007.2|Games]], Utilities, and All.

<br clear=all />

====Running Tasks Page====

{{stub}}

[[Image:RunningTasks.png|right|200px]] This page displays currently-running tasks. Any individual task may be terminated by selecting it and then clicking on the garbage-can icon to close it. All tasks may be terminated by clicking on any one of them and then clicking on the "folder" icon in the upper right (expect this to change in future releases). Any task may be rejoined by selecting it and then selecting the "return" icon at the middle top.

<br clear=all />

====Exiting from and switching to an Application====

Any time an application is running, you can simply click the device's power button and the application will exit, returning you to the Today page.

Alternatively, you can cycle through active applications using the AUX button

Clicking the top-left of the screen displays the drop down ''task menu''. This menu lists all active applications and allows to switch directly to any one. ''Note:'' If the task menu is not shown, click and hold the [[#Aux|Aux]] button to bring up the Aux menu, and select "Toggle Fullscreen".

=== Using the terminal ===

To start a console from "Today" page, click the middle tab at the bottom of the screen to display the "Launch applications" page, then select Terminal in the "Applications" submenu. The multitaps keyboard slides up (and down) from the bottom of the screen automatically when you touch the screen.

====Setting date and time====

From the terminal, type the following, but replace ''MM'' with the month (01-12); ''DD'' with the day (01-31); ''hhmm'' with the time (0000-2359); ''YYYY'' with the year (optional); and ''.ss'' with the seconds (optional).

date -s ''MMDDhhmmYYYY.ss''

To make the change persist between reboots, sync the hardware clock with the updated system time.

hwclock --systohc

See [[Setting Date and Time]] for more discussion, including synchronizing with an NTP server.

Note: UNIX traditionally sets the system clock to GMT (UTC) or "Zulu" (Z time zone). So I use the stanza:
date -u MMDDhhmmYYYY.ss (well, I usually ignore the seconds)
Then I can set the local time using the techniques described elsewhere. iceworm

==== Accessing the microSD card ====

Mounted at /media/card by default.
<pre>
　mount /media/card
</pre>
If you have multiple partitions on the card, the first (/dev/mmcblk0p1) will be mounted at /media/card, the second at /media/mmcblk0p2, the third at /media/mmcblk0p3 etc. To setup the package management to write on the microSD card when installing new software follow the [[Package_management | package management guide]].

fox example :
<pre>
Filesystem 1k-blocks Used Available Use% Mounted on
rootfs 252544 153560 98984 61% /
/dev/root 252544 153560 98984 61% /
/dev/root 252544 153560 98984 61% /dev/.static/dev
udev 2048 76 1972 4% /dev
/dev/mmcblk0p1 3362 1794 1568 53% /media/card
/dev/mmcblk0p2 476382 157368 294419 35% /media/mmcblk0p2
tmpfs 61928 380 61548 1% /var/volatile
tmpfs 61928 0 61928 0% /dev/shm
</pre>

== For Om 2008.12 ==

=== Entering the SIM PIN ===

Some SIM cards require a PIN code to be entered. If your SIM card is like this, you will see a screen like this after the FreeRunner boots:
[[Image:Enterpin.jpg|center]]
The keypad in the lower part of the screen shows only letters, and your PIN is probably numeric. Switch to other keypads by stroking downwards on the screen with the stylus. Then enter your PIN. If you enter a wrong digit, you can backspace by stroking the screen to the left with the stylus. (Keep trying if it doesn't seem to work.) Finally, having composed the correct PIN, tap on the composed number with the stylus. This will enter it into the dialog box where it needs to be. After a brief pause, you will then see the word "Enter" at the top right of the keypad. Tap it. The PIN will then be checked, and if all is well, the Home Screen (next section) will be displayed.

=== The Home screen ===

With the bare-bones installation, the home screen looks like this.
[[Image:Homescreen.jpg|center]]

=== Terminal ===

In Om 2008.12, no terminal app is installed by default. To get to a command prompt, you need to set up USB-based networking and use SSH; see next section.

== Set up USB-based networking, SSH and update ==

Openmoko allows TCP/IP-over-USB networking for your phone. The main advantages of this are
* You don't need to set-up GPRS or WLAN network connection for the phone software to reach the Internet
* You can SSH from your computer into the phone shell and comfortably do low-level tasks using your computer's terminal software and real keyboard instead of the tiny screen and touchscreen keyboard

Naturally, the phone must be connected to your computer with USB cable.

===Connect with the Neo FreeRunner===

This is discussed in the [[USB_Networking|USB Networking]] section.

===Update with the package manager===

In order to keep the FreeRunner up-to-date with the latest features and bug-fixes, it is advisable update the software at regular intervals.

There are two main methods of doing this:
* upgrading with the package manager '''[[Opkg]]'''
* or manually flashing the device (see [[Flashing the Neo FreeRunner]]).

There are three layers to the software on the FreeRunner:

* [[uboot|uBoot]]: Think of u-boot as a combination of the BIOS and Grub on a PC.
* Kernel: The Linux kernel
* Root Filesystem: The rest of the system

Note that ''uboot'', the ''kernel'' and the ''root filesystem'' may all be flashed to update them. For uboot, this is the only possibility (see [[Flashing_the_Neo_FreeRunner#Flashing_the_boot_loader]]). The advantage of flashing the kernel manually rather than using opkg seems to be speed. The disadvantage of flashing the root file system is that it wipes out all local modifications, including /home. If /home is moved to the SD disk, this is no longer a problem.

{{Warning| UPGRADING TO DAILY KERNELS FROM THE DEVELOPMENT BRANCH MAY BREAK THINGS. That said, assuming that your FreeRunner can access the internet (see above), the kernel and other packages can be updated with

# opkg update
# opkg -test upgrade
# opkg upgrade

The first updates the repository information, telling opkg what packages are available. The second allows you to see what the package manager wants to do. The third upgrades all packages for which a newer version is available. '''At the moment, some signature files are missing (404 errors), which opkg complains about, but this is cosmetic.''' The repositories will still update with the missing signature files.
}}

'''Important:''' If you have followed the Getting Started Guide this far, but opkg upgrades do not appear to be happening. Try checking the .conf files in the /etc/opkg/ directory. If you see four URLs pointing at
<nowiki>http://buildhost.openmoko.org/</nowiki>, this is your problem. <nowiki>http://buildhost.openmoko.org/</nowiki> is no longer supported. If you're running Om 2007.2 (the stock distribution that comes with the Freerunner according to the [[FAQ]]), you'll need to edit those files to point to an unofficial [[Users Repositories|User Repository]]. Or, you could install another [[Distributions|distribution]] (which is probably the best bet in the long run).

Note that running opkg upgrade on a factory-fresh phone will upgrade dropbear (the ssh software) and various xserver packages, and neither upgrades elegantly while in use. Xserver must be updated over ssh to complete succesfully. Dropbear can be updated over ssh with the proper command:

nohup opkg upgrade dropbear &

Or upgrade it directly in the FreeRunner terminal.

opkg upgrade dropbear

When updating over ssh, the session will be interrupted, but the command should complete successfully(check nohup.out on your device to verify), and you should be able to reconnect within a few seconds.

Another (better) option is to start a screen session before the upgrade with:

screen

After loosing the ssh connection and login in again via ssh reconnect to the running screen session with:

screen -x

Then connect to the FreeRunner via ssh and type:

opkg upgrade

And run this command :

depmod

Alternatively you can upgrade the xserver packages via ssh and then upgrade the rest from the FreeRunner's terminal.

If you do your first upgrade in two installments like this, it will go more smoothly.

It will be possible in the future to update uboot with opkg, but this has not yet been implemented.

=== Installing applications ===

There are many applications you can install - check out the [[Repositories]] for a list of packages, an example of how to add a repository using scaredy cat as an example can also be found here. A list of pre-installed and available packages with descriptions can be found here - [[Available Packages]].
Or you can check [[Applications]] page to get applications developed from community.

If you want to install any application on Neo, there three steps:

'''
1. Download the applicatiion you want to install on Neo.

2. scp the opkg/ipk file to the root of Neo.

3. Use Opkg command to intall opkg files.'''

By following example you can install web browser on Neo:

The calendar can be installed with

First download and unpack it on your GNU/Linux host:

<pre>
wget http://www.ginguppin.de/files/minimo.tar.bz2
tar jvxf minimo.tar.bz2
</pre>

Copy it over to the FreeRunner:
<pre>
scp minimo_* root@192.168.0.202:/tmp
</pre>

Then on the FreeRunner:
<pre>
opkg install /tmp/minimo_0.02\+cvs20070626-r0_armv4t.ipk
</pre>

You'll probably also want to [[Switching Keyboards|change the keyboard]] including the [[Switching Keyboards#How_to_add_a_keyboard_toggle_button|keyboard toggle applet]]

=== Importing contacts ===

If you can export your contacts to VCard format, either multiple files or single file containing all of them, you may use the script on [[Import Vcf Contacts]] page to bring them to Neo.

==The next steps==

Congratulations for setting up your Neo FreeRunner. There are many more resources to help free your phone:

===Customize the interface===
home screen clock, keyboard

The stock [[Openmoko2007.2]] image flashed onto the Neo FreeRunner is really just the bare bones. For example, you don't have the clock and the quick-launch icons showing. Here's how you can change that:

# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/reduced false
# /etc/init.d/xserver-nodm restart

If you rather have a regular clock instead of the digital one, do this instead:

# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/reduced false
# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/digital_clock false
# /etc/init.d/xserver-nodm restart

REMOVE CLICK SOUND VIA /etc/pulse/session

More information about today screen customization at [[Today/2007.2]].

Also, if you prefer having a full keyboard, using matchbox's qwerty keybord, see [[Switching_Keyboards#Matchbox_keyboard|these instructions]]. Then you may also see [http://lists.openmoko.org/pipermail/community/2008-July/021296.html these], which describe a way to add an applet allowing the showing/hiding of that keyboard.

===Use the GPS===
You can see [[Manually using GPRS]] to get more information about GPS. Or download [[TangoGPS]] from [http://www.tangogps.org/downloads/tangogps_0.9.3-r1_armv4t.ipk tangogps.org].

There were critical [[GPS Problems]] earlier that are largely fixed in newest kernels, see the instructions above to install the updates. More information is on the [[GPS]] page.

===Play with WLAN, GPRS and Bluetooth===

There are plenty of development opportunities to integrate these functions in the Openmoko software.

'''WLAN''': See [[Wireless Networking]]

'''GPRS''': See [[Manually using GPRS]]

'''Bluetooth''': See [[Manually using Bluetooth]]

=== Testing a new distribution ===

For the feature of Openness, you can flash any Linux [[Distributions]] into FreeRunner. You can testing a new distribution by following ways:

* [[Booting from SD]].
* Boot from the built-in NAND flash memory.
** [[NeoTool]] gives you a GUI to flash and backup.
** [http://code.google.com/p/om-manager/ om-manager] is another GUI to flash, backup and [[Community_Updates/December_29th%2C_2008#New_applications|more]].

=== Welcome to the community ===

The release of the FreeRunner in the summer 2008 has led the community into a new period of rapid growth. The resources available are summarized on the [[Community Resources]]. These are always exciting and interesting times to live in when the balance between Chaos and Order tilts towards change.

As an entry point, the [http://lists.openmoko.org/pipermail/community/ openmoko community mailing list] is perhaps the most active. As of July 2008, its volume amounts to dozens of messages per day. Read the [[Community_Updates]] for a digest. Openmoko people are there too. You may ask for help on the [[https://lists.openmoko.org/mailman/listinfo/support support mailing list]].

Or if you use IRC, there is always a good group in the channel #openmoko on FreeNode.

The links on the top-right of this page lead to the sister sites in the Openmoko community:
* Home and Wiki lead to the same Main Page on the wiki. It needs cleaning, we know...
* Doc leads to the bug ''Trac''king system.
* Planet goes to the collection of Openmoko-relatd blogs.
* Projects is the GForge, free hosting for application developers.
* Lists is the listing of all the public mailing lists on lists.openmoko.org.

== Annotated references ==

* [[Neo FreeRunner]]. The top-level view of the specifications.
* [[Neo FreeRunner GTA02 Hardware]]. The detailed specifications.
* [[GTA02 Openness]]. Ultimate chip-level specifications, data sheets and hardware documentation.
* [[Distributions]]. Strengths and weaknesses of the various distributions available for the Neo.
* [[FAQ#Getting_Started_with_your_Neo_FreeRunner]]. Answers.

To search this wiki with Google, use the following search term:

<search term> site:http://wiki.openmoko.org/wiki/

[[Category:Neo FreeRunner Hardware| ]]
[[Category:Basic End User]]

Getting Started with your Neo FreeRunner

2009-04-11T23:07:16Z

Any Key: /* Buttons and connectors */

{{Languages|Getting Started with your Neo FreeRunner}}

{| class="wikitable" cellspacing="2" cellpadding="2" style="padding: 0%; margin:0em 0em 1em 0em; background:#eeeeee; width:100%;floating="center"; "
! style="background:#fcfcfc; width:75% " |
<p align="left">
Thank you for purchasing this Developer release of Neo FreeRunner. The [[Neo FreeRunner]] phone is the second hardware platform to take advantage of Openmoko. This guide will help you get to know your Neo FreeRunner and how to start using your Neo FreeRunner.</p>

<p align="left">
Some Frequently Asked Questions for new owners are featured in the [[FAQ#Getting_Started_with_your_Neo_FreeRunner|FAQ]].
</p>

! style="background:#fcfcfc; width:25% " |
[[Image:Freerunner box.png|200px|thumb|Neo FreeRunner Package]]
|}
{{Neo FreeRunner Menu}}

== Package Contents ==

[[Image:Openmokset.jpg|left|400px|thumb|Inside the package]]
<br />
: [[Image:Circle２.gif|10px]] Neo FreeRunner
: [[Image:Circle２.gif|10px]] Stylus
: [[Image:Circle２.gif|10px]] Battery
: [[Image:Circle２.gif|10px]] Charger
: [[Image:Circle２.gif|10px]] USB Cable (A -> Mini-B 5-pole)
: [[Image:Circle２.gif|10px]] [[Thank You green card]]
<div style="clear: both"> </div>

{{Note|
== Get the source code ==
The software included in this product contains copyrighted software that is licensed under the [http://downloads.openmoko.org/sources/Om2008.9-Lite.iso GPL]. A complete corresponding source code or CD-ROM ISO image with the GPL license is available for download [http://downloads.openmoko.org/sources/Om2008.9-Lite.iso here]. You may also obtain the same corresponding CD-ROM by sending a money order or check for $10 to any one of our [http://downloads.openmoko.org/sources/Om2008.9-Lite.iso distributors].

Please write “source for Neo FreeRunner ” in the memo line of your payment.
}}

== Setting up the hardware, getting to know the Neo FreeRunner physically ==

===Installing the Micro-SD card, the SIM card, and the Battery ===

[[Image:Circle２.gif|10px]] Remove the rear cover of the Neo FreeRunner by first holding the Neo FreeRunner on the side and then use a credit card (or your fingernail, if you have strong fingernails) to prise off the rear cover at the slot on top of the device.

<table width="80%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
<tr valign="top" style="background: #ffffff">
<td style="width: 50%; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:menu13.jpg|233px|thumb|Open the case like this.|center]]</td>
<td style="padding: 1px 1em 0; background: #ffffff;">[[Image:menu14.jpg|250px|thumb|Opening !|center]]</td>
</tr>
</table>

[[Image:Circle２.gif|10px]] Now you should be able to locate the combined SIM and Micro-SD card holder at the bottom of the battery compartment.

[[Image:Circle２.gif|10px]] Unlock the SIM card holder by sliding the metal clip down, towards the USB socket, with your fingernail. Use caution, as these parts are delicate and could be damaged by forcing them in the wrong direction.

[[Image:menu11.jpg|260px|thumb|Put the SIM card and SD card here.|center]]

[[Image:Circle２.gif|10px]] Lift up on the SIM card holder.

[[Image:Circle２.gif|10px]] The Micro-SD card holder is held in place by a latch on either side. It is easiest to open the Micro-SD card holder by releasing these latches one at a time rather than by lifting from the middle, as lifting from the middle tends to increase the latching pressure. A small screwdriver or knife can be used for this.

[[Image:Circle２.gif|10px]] Insert the Micro-SD card into the Micro-SD card holder. Note that on the inside of metal part of the holder there are little holding tabs for the card. Slide the card in these holders (on the metal part) before closing the card holder. Note that the electrical contacts should face down and towards the edge of the Neo FreeRunner.

[[Image:Circle２.gif|10px]] Close the Micro-SD card holder, making sure that both latches of the holder are securely fastened.

[[Image:Circle２.gif|10px]] Insert the SIM card into the SIM card holder, taking care to slide inside the two metal tabs in the cover. Note that the electrical contacts should face down and that the cut corner should be closest to the external GPS Antenna Socket.

[[Image:Circle２.gif|10px]] Close the SIM card holder and lock it by sliding the metal clip towards the external GPS Antenna Socket on the FreeRunner.
<table width="80%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
<tr valign="top" style="background: #ffffff">
<td style="width: 50%; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">
[[Image:FR_SIM_SD_open.jpg|457px|thumb|SIM and SD holders open, with cards in place|center]]</td>
<td style="padding: 1px 1em 0; background: #ffffff;">
[[Image:Engchang.jpg|392px|thumb|Some models look like this, the little blob is not a defect|center]]</td>
</tr>
</table>

[[Image:Circle２.gif|10px]] Insert the battery into the battery compartment, aligning the electrical contacts on the battery with the electrical contacts in the battery compartment. Insert the side with the electrical contacts first.

[[Image:Circle２.gif|10px]] Replace the rear cover on the FreeRunner.

{| class="wikitable" style="background#00CC00;border-left:1px solid white;border-right:1px solid white;border-top:0px solid white; border:1px solid #00CC00; float:right; margin: 0 0 1em 1em;"
! style="background:#00cc00;border-left:1px solid white;border-right:5px solid white;border-top:0px solid white; border:1px solid #00CC00;" |<font color=white>Tips</font>
|-
!style="background:#ffffff;border-left:1px solid white;border-right:1px solid white;border-top:0px solid white; border:1px solid #FFFFff;" |
<div align=left>
[http://video.google.de/videoplay?docid=-8343770443102960945 A short video] is also available. It was shot using the previous version of the Neo, but the installation procedure remains the same.
</div>

|}

===Charging the Neo FreeRunner===

Before using the Neo FreeRunner for the first time, you should charge the battery completely. The battery can be charged using the provided charger at 1000mA or from a powered USB port capable of providing 500mA worth of current. Most computers will be able to charge the FreeRunner without any problems.

Neo FreeRunner '''does NOT charge when powered off''', so be sure to turn it on and allow it to boot all the way to the GUI (Graphical User Interface). This should happen automatically when you plug in USB power, either from a computer or the provided charger.

Although the provided charger is rated at 2A, the maximum charge rate of the Neo FreeRunner is 1A, and thus the charge rate with the charger is less than the charger capacity.

The provided charger includes three "national" plugs. The default is North America, with alternative U.K (3 square pins) and Euro (two round pins) adapters. To install the alternative power adapters, depress the latch in the cover (on the opposite side of the charger from the product information label) and slide the cover outward. Note that the two North American pins do not come out; the other adapters slide over them, and snap into place. The two-pin Euro adapter is removed in the same way as the cover. The three-pin U.K. adapter is removed by '''gently''' pressing the dummy ground pin (black) '''toward the end of the adapter with the cord''' and then sliding it off the adapter.

Charging an empty battery at 100mA takes 12~15 hours, at 500mA takes 2,5~3,5 hours, and at 1000mA takes 1.5~2.5 hours. (90%~100%) [to be confirmed]

{{Note|See [[Neo_FreeRunner_Hardware_Issues|Neo FreeRunner Hardware Issues]] about not allowing the battery to discharge completely.}}

===Buttons and connectors===

<table width="80%" style="clear: both; border-collapse: collapse" valign="top">
<tr>
<td style="width: 25px"> </td>
<td style="width: 370px">[[Image:menu9.jpg|370px|thumb|Power Button, USB and external GPS Antenna (left to right)|center]]</td>
<td style="width: 25px"> </td>
<td style="width: 370px">[[Image:menu8.jpg|370px|thumb|AUX Button and handset jack (left to right)|center]]</td>
</tr>
<tr>
<td></td>
<td>'''Power'''
Tapping the power button exits the current application.

Holding the power button brings up a menu allowing you to:
* Power on and off the GPS, wifi, GSM, and bluetooth antennae
* Change power management mode to:
** Dim first then lock
** Dim only, don't lock
** Disabled
* Lock the screen
* Shutdown the device.</td>
<td></td>
<td>'''Aux'''
Tapping the Aux button hides or shows the currently running application.

Holding the Aux button brings up a menu allowing you to:

* Hide and show the title bar (Fullscreen toggle)
* Alternate wide or tall display modes (Swap Orientation)
* Save the content of the screen as an image file (Screenshot)
</td>
</tr>
</table>

'''Booting'''

[[Booting the Neo FreeRunner]] takes about 2 minutes overall, so patience is in order. The longest step comes after the Linux boot messages in very small fonts have scrolled by, at the graphical "openmoko" sunrise page.

'''Phone Jack'''

The phone jack is a 2.5mm connector with four contacts: stereo + MIC. It is compatible with the headsets used by Motorola smartphones (A780,A1200, ...) and the V-360.

More information on [[Headset]] page.

===Unlocking the screen===

When the screen is locked, you should see a Matrix-style green graphic with the Openmoko symbol in the middle of the bottom of the screen along with lock and unlock symbols. If you drag the Openmoko symbol to the unlock symbol at the top then the screen will become unlocked.

===Identifying which revision you have===
You will want to determine which revision of the phone you have

* remember your date code, the bottom of your shipping box should have a sticker stating it.
* read [[Finding_hardware_revision]]

These two are important, as they allow you to know which image is flashed on you phone at the factory (c.f. [[Distributions]] and [[Neo_FreeRunner_Hardware#History]]).

== Image Issue==

Because the software changes so rapidly and the phones were imaged during mass production, we don't ship the newest image with phones.
There are two different kinds of images shipped with the phones:

1. [[Om 2007.2]]

2. [[Om 2008.9]]

But according to the [[FAQ]] and [[Distributions]] pages, all phones ship with [[Om 2007.2]]. This distribution is no longer supported, so before even getting your feet wet, you'll probably want to switch to something else, especially since the FreeRunner is not really usable as a mobile phone with these old distributions.

Switching to another distribution is easy if you have a computer with a USB port and internet connectivity that can run the dfu-util utility. Most current Linux distros have packaged dfu-util, so if you use Linux you can probably just get it from your distro's repository. The next step is to choose which Openmoko distribution to switch to. See [[Distributions]] for information about the alternatives.

That page will point you to the files to download, and to the instructions for installing them using dfu-util.

==For Om 2007.2==

===Navigating menus and applications===
====Today Page====

[[Image:Todaypage_reduced_true.png|200px|right]] Openmoko starts by displaying the "Today" page, which is your home page. Icons in the top row indicate the status of the phone. The bottom row consists of three tabs. The tab with a house on the left leads to the "Today" page you're viewing now. The central tab leads to the "Launch Task" page, which is the main menu used to start applications. The tab with gears on the right leads to the "Running Tasks" page, which is used to deal with currently open windows and applications.

<br clear=all />

[[Image:Todaypage_reduced_false.png|right|200px|]] The "Today" page is empty, as shown above, when you first start Openmoko. We explain below how to turn on the "full view", displayed to the right. In the full view, a second row of icons give quick links to commonly-used applications such as the dialer, the adressbook, mailbox and calendar. The main body of the screen displays a clock and other useful information.

See [[Today/2007.2]] for more information about the Today page and customization.

<br clear=all />

====Launch Task Page====

{{stub}}

[[Image:LaunchTasks.png|right|200px]] This page displays a menu of available applications. You may choose a category of applications to display to simplify the screen, or choose to display them all.

Current categories are [PIM Suite], [[Om_2007.2_Applications|Applications]], [[Games/Om 2007.2|Games]], Utilities, and All.

<br clear=all />

====Running Tasks Page====

{{stub}}

[[Image:RunningTasks.png|right|200px]] This page displays currently-running tasks. Any individual task may be terminated by selecting it and then clicking on the garbage-can icon to close it. All tasks may be terminated by clicking on any one of them and then clicking on the "folder" icon in the upper right (expect this to change in future releases). Any task may be rejoined by selecting it and then selecting the "return" icon at the middle top.

<br clear=all />

====Exiting from and switching to an Application====

Any time an application is running, you can simply click the device's power button and the application will exit, returning you to the Today page.

Alternatively, you can cycle through active applications using the AUX button

Clicking the top-left of the screen displays the drop down ''task menu''. This menu lists all active applications and allows to switch directly to any one. ''Note:'' If the task menu is not shown, click and hold the [[#Aux|Aux]] button to bring up the Aux menu, and select "Toggle Fullscreen".

=== Using the terminal ===

To start a console from "Today" page, click the middle tab at the bottom of the screen to display the "Launch applications" page, then select Terminal in the "Applications" submenu. The multitaps keyboard slides up (and down) from the bottom of the screen automatically when you touch the screen.

====Setting date and time====

From the terminal, type the following, but replace ''MM'' with the month (01-12); ''DD'' with the day (01-31); ''hhmm'' with the time (0000-2359); ''YYYY'' with the year (optional); and ''.ss'' with the seconds (optional).

date -s ''MMDDhhmmYYYY.ss''

To make the change persist between reboots, sync the hardware clock with the updated system time.

hwclock --systohc

See [[Setting Date and Time]] for more discussion, including synchronizing with an NTP server.

Note: UNIX traditionally sets the system clock to GMT (UTC) or "Zulu" (Z time zone). So I use the stanza:
date -u MMDDhhmmYYYY.ss (well, I usually ignore the seconds)
Then I can set the local time using the techniques described elsewhere. iceworm

==== Accessing the microSD card ====

Mounted at /media/card by default.
<pre>
　mount /media/card
</pre>
If you have multiple partitions on the card, the first (/dev/mmcblk0p1) will be mounted at /media/card, the second at /media/mmcblk0p2, the third at /media/mmcblk0p3 etc. To setup the package management to write on the microSD card when installing new software follow the [[Package_management | package management guide]].

fox example :
<pre>
Filesystem 1k-blocks Used Available Use% Mounted on
rootfs 252544 153560 98984 61% /
/dev/root 252544 153560 98984 61% /
/dev/root 252544 153560 98984 61% /dev/.static/dev
udev 2048 76 1972 4% /dev
/dev/mmcblk0p1 3362 1794 1568 53% /media/card
/dev/mmcblk0p2 476382 157368 294419 35% /media/mmcblk0p2
tmpfs 61928 380 61548 1% /var/volatile
tmpfs 61928 0 61928 0% /dev/shm
</pre>

== For Om 2008.12 ==

=== Entering the SIM PIN ===

Some SIM cards require a PIN code to be entered. If your SIM card is like this, you will see a screen like this after the FreeRunner boots:
[[Image:Enterpin.jpg|center]]
The keypad in the lower part of the screen shows only letters, and your PIN is probably numeric. Switch to other keypads by stroking downwards on the screen with the stylus. Then enter your PIN. If you enter a wrong digit, you can backspace by stroking the screen to the left with the stylus. (Keep trying if it doesn't seem to work.) Finally, having composed the correct PIN, tap on the composed number with the stylus. This will enter it into the dialog box where it needs to be. After a brief pause, you will then see the word "Enter" at the top right of the keypad. Tap it. The PIN will then be checked, and if all is well, the Home Screen (next section) will be displayed.

=== The Home screen ===

With the bare-bones installation, the home screen looks like this.
[[Image:Homescreen.jpg|center]]

=== Terminal ===

In Om 2008.12, no terminal app is installed by default. To get to a command prompt, you need to set up USB-based networking and use SSH; see next section.

== Set up USB-based networking, SSH and update ==

Openmoko allows TCP/IP-over-USB networking for your phone. The main advantages of this are
* You don't need to set-up GPRS or WLAN network connection for the phone software to reach the Internet
* You can SSH from your computer into the phone shell and comfortably do low-level tasks using your computer's terminal software and real keyboard instead of the tiny screen and touchscreen keyboard

Naturally, the phone must be connected to your computer with USB cable.

===Connect with the Neo FreeRunner===

This is discussed in the [[USB_Networking|USB Networking]] section.

===Update with the package manager===

In order to keep the FreeRunner up-to-date with the latest features and bug-fixes, it is advisable update the software at regular intervals.

There are two main methods of doing this:
* upgrading with the package manager '''[[Opkg]]'''
* or manually flashing the device (see [[Flashing the Neo FreeRunner]]).

There are three layers to the software on the FreeRunner:

* [[uboot|uBoot]]: Think of u-boot as a combination of the BIOS and Grub on a PC.
* Kernel: The Linux kernel
* Root Filesystem: The rest of the system

Note that ''uboot'', the ''kernel'' and the ''root filesystem'' may all be flashed to update them. For uboot, this is the only possibility (see [[Flashing_the_Neo_FreeRunner#Flashing_the_boot_loader]]). The advantage of flashing the kernel manually rather than using opkg seems to be speed. The disadvantage of flashing the root file system is that it wipes out all local modifications, including /home. If /home is moved to the SD disk, this is no longer a problem.

{{Warning| UPGRADING TO DAILY KERNELS FROM THE DEVELOPMENT BRANCH MAY BREAK THINGS. That said, assuming that your FreeRunner can access the internet (see above), the kernel and other packages can be updated with

# opkg update
# opkg -test upgrade
# opkg upgrade

The first updates the repository information, telling opkg what packages are available. The second allows you to see what the package manager wants to do. The third upgrades all packages for which a newer version is available. '''At the moment, some signature files are missing (404 errors), which opkg complains about, but this is cosmetic.''' The repositories will still update with the missing signature files.
}}

'''Important:''' If you have followed the Getting Started Guide this far, but opkg upgrades do not appear to be happening. Try checking the .conf files in the /etc/opkg/ directory. If you see four URLs pointing at
<nowiki>http://buildhost.openmoko.org/</nowiki>, this is your problem. <nowiki>http://buildhost.openmoko.org/</nowiki> is no longer supported. If you're running Om 2007.2 (the stock distribution that comes with the Freerunner according to the [[FAQ]]), you'll need to edit those files to point to an unofficial [[Users Repositories|User Repository]]. Or, you could install another [[Distributions|distribution]] (which is probably the best bet in the long run).

Note that running opkg upgrade on a factory-fresh phone will upgrade dropbear (the ssh software) and various xserver packages, and neither upgrades elegantly while in use. Xserver must be updated over ssh to complete succesfully. Dropbear can be updated over ssh with the proper command:

nohup opkg upgrade dropbear &

Or upgrade it directly in the FreeRunner terminal.

opkg upgrade dropbear

When updating over ssh, the session will be interrupted, but the command should complete successfully(check nohup.out on your device to verify), and you should be able to reconnect within a few seconds.

Another (better) option is to start a screen session before the upgrade with:

screen

After loosing the ssh connection and login in again via ssh reconnect to the running screen session with:

screen -x

Then connect to the FreeRunner via ssh and type:

opkg upgrade

And run this command :

depmod

Alternatively you can upgrade the xserver packages via ssh and then upgrade the rest from the FreeRunner's terminal.

If you do your first upgrade in two installments like this, it will go more smoothly.

It will be possible in the future to update uboot with opkg, but this has not yet been implemented.

=== Installing applications ===

There are many applications you can install - check out the [[Repositories]] for a list of packages, an example of how to add a repository using scaredy cat as an example can also be found here. A list of pre-installed and available packages with descriptions can be found here - [[Available Packages]].
Or you can check [[Applications]] page to get applications developed from community.

If you want to install any application on Neo, there three steps:

'''
1. Download the applicatiion you want to install on Neo.

2. scp the opkg/ipk file to the root of Neo.

3. Use Opkg command to intall opkg files.'''

By following example you can install web browser on Neo:

The calendar can be installed with

First download and unpack it on your GNU/Linux host:

<pre>
wget http://www.ginguppin.de/files/minimo.tar.bz2
tar jvxf minimo.tar.bz2
</pre>

Copy it over to the FreeRunner:
<pre>
scp minimo_* root@192.168.0.202:/tmp
</pre>

Then on the FreeRunner:
<pre>
opkg install /tmp/minimo_0.02\+cvs20070626-r0_armv4t.ipk
</pre>

You'll probably also want to [[Switching Keyboards|change the keyboard]] including the [[Switching Keyboards#How_to_add_a_keyboard_toggle_button|keyboard toggle applet]]

=== Importing contacts ===

If you can export your contacts to VCard format, either multiple files or single file containing all of them, you may use the script on [[Import Vcf Contacts]] page to bring them to Neo.

==The next steps==

Congratulations for setting up your Neo FreeRunner. There are many more resources to help free your phone:

===Customize the interface===
home screen clock, keyboard

The stock [[Openmoko2007.2]] image flashed onto the Neo FreeRunner is really just the bare bones. For example, you don't have the clock and the quick-launch icons showing. Here's how you can change that:

# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/reduced false
# /etc/init.d/xserver-nodm restart

If you rather have a regular clock instead of the digital one, do this instead:

# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/reduced false
# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/digital_clock false
# /etc/init.d/xserver-nodm restart

REMOVE CLICK SOUND VIA /etc/pulse/session

More information about today screen customization at [[Today/2007.2]].

Also, if you prefer having a full keyboard, using matchbox's qwerty keybord, see [[Switching_Keyboards#Matchbox_keyboard|these instructions]]. Then you may also see [http://lists.openmoko.org/pipermail/community/2008-July/021296.html these], which describe a way to add an applet allowing the showing/hiding of that keyboard.

===Use the GPS===
You can see [[Manually using GPRS]] to get more information about GPS. Or download [[TangoGPS]] from [http://www.tangogps.org/downloads/tangogps_0.9.3-r1_armv4t.ipk tangogps.org].

There were critical [[GPS Problems]] earlier that are largely fixed in newest kernels, see the instructions above to install the updates. More information is on the [[GPS]] page.

===Play with WLAN, GPRS and Bluetooth===

There are plenty of development opportunities to integrate these functions in the Openmoko software.

'''WLAN''': See [[Wireless Networking]]

'''GPRS''': See [[Manually using GPRS]]

'''Bluetooth''': See [[Manually using Bluetooth]]

=== Testing a new distribution ===

For the feature of Openness, you can flash any Linux [[Distributions]] into FreeRunner. You can testing a new distribution by following ways:

* [[Booting from SD]].
* Boot from the built-in NAND flash memory.
** [[NeoTool]] gives you a GUI to flash and backup.
** [http://code.google.com/p/om-manager/ om-manager] is another GUI to flash, backup and [[Community_Updates/December_29th%2C_2008#New_applications|more]].

=== Welcome to the community ===

The release of the FreeRunner in the summer 2008 has led the community into a new period of rapid growth. The resources available are summarized on the [[Community Resources]]. These are always exciting and interesting times to live in when the balance between Chaos and Order tilts towards change.

As an entry point, the [http://lists.openmoko.org/pipermail/community/ openmoko community mailing list] is perhaps the most active. As of July 2008, its volume amounts to dozens of messages per day. Read the [[Community_Updates]] for a digest. Openmoko people are there too. You may ask for help on the [[https://lists.openmoko.org/mailman/listinfo/support support mailing list]].

Or if you use IRC, there is always a good group in the channel #openmoko on FreeNode.

The links on the top-right of this page lead to the sister sites in the Openmoko community:
* Home and Wiki lead to the same Main Page on the wiki. It needs cleaning, we know...
* Doc leads to the bug ''Trac''king system.
* Planet goes to the collection of Openmoko-relatd blogs.
* Projects is the GForge, free hosting for application developers.
* Lists is the listing of all the public mailing lists on lists.openmoko.org.

== Annotated references ==

* [[Neo FreeRunner]]. The top-level view of the specifications.
* [[Neo FreeRunner GTA02 Hardware]]. The detailed specifications.
* [[GTA02 Openness]]. Ultimate chip-level specifications, data sheets and hardware documentation.
* [[Distributions]]. Strengths and weaknesses of the various distributions available for the Neo.
* [[FAQ#Getting_Started_with_your_Neo_FreeRunner]]. Answers.

To search this wiki with Google, use the following search term:

<search term> site:http://wiki.openmoko.org/wiki/

[[Category:Neo FreeRunner Hardware| ]]
[[Category:Basic End User]]

Translation

2009-04-11T22:14:32Z

Any Key: /* Punjabi */ make it ISO-639-2 compliant

{{Languages|Translation}}

Let us spread the popularity of Openmoko by localization of the software and translation of documentation and wiki.

Just as an overview who is able and willing to translate parts into other languages, please join and add your Language and name. The source for the translation will be English. If you have good English skills then you could contribute by correcting the sources :)

A good point to start would be to continuous translating of
http://en.wikipedia.org/wiki/Openmoko into more languages on the other language sites of wikipedia.

"...it is easy to join and spend some minutes for translating,
and when someone finds some mistakes in any languages don't
blame the translator - just be productive and fix it yourself!" -[[User:RobertMichel|Robert Michel]]

Please take a look at [[Translation HOWTO]] and improve it if possible.

Languages already offered on our community mailinglist, please add your name yourself and join community mailinglist (until we'll have a proper mailinglist) to discuss about translations:

== Afrikaans ==

== Amharic ==
* [[User:ethiopia|Ethiopia Alemayehu]]

== Armenian ==
* [[User:surenk|Suren Karapetyan]]

== Arabic ==
عربي
* Hossam Mahmoud حسام محمود
* [[User:ترجمان05|ترجمان05]]
* [[User:Lixy|Lixy]] 17:54, 21 July 2007 (CEST)
* [[User:Waraqa|Waraqa]]

== Bulgarian ==
* [[User:Mr700|Doncho Nicolaev Gunchev]]

== Basque ==

* [[User:garrop|Ugartemendia]]
* [[User:aritza|aritza]]

== Catalan ==

* [[User:montxovs|Montxo Vicente i Sempere]]

* [[User:Mandarino|Mandarino]]

* [[User:RafaelCarreras|Rafael Carreras]]

* [[User:JaumeI|JaumeI]]

== Chinese (Simplified)==
* [[User:JarodWang|JarodWang]]
* [[User:Liuxf|Liuxf]]
* [[User:sunlt|sunlt]]

== Chinese (Traditional)==
* [[User:coolcat|Brenda Wang]]

== Czech ==
* [[User:Mikesh|Michal Heczko]]
* [[User:Vatoz|Vaclav Cerny]]
* [[User:Fox|Pavel Kovář]] (wiki)

== Danish ==
* [[User:EsbenDamgaard|Esben Damgaard]]
* [[User:UlrikRasmussen|Ulrik Rasmussen]]
* [[User:miki|Mikkel Kirkgaard Nielsen]]

== Dutch ==
* [[User:MarcVerwerft|Marc Verwerft]]
* [[User:Madjo|Marcel De Jong]]
* [[User:LuitvD|Luit van Drongelen]]
* [[User:reinouts|Reinout van Schouwen]]
* [[User:Steamrunner|Koen De Voegt]]

([[User:Madjo|Marcel]] 18/04) Misschien is het handig om alvast te beginnen met vertalen van de Wiki? Of hebben jullie andere ideeen? Ik heb al een start gemaakt van de voorpagina van de wiki, maar ben nog niet veel verder gekomen
([[User:reinouts|Reinout]] 21/04) Valt er verder nog niks te vertalen? De wiki is niet echt boeiend.

== Esperanto ==
* [[User:Antono|Antono Vasiljev]]
* [[User:Alekcxjo|Alekĉjo Rajmondo]]

== Estonian ==
* [[User:Hadara|Sven Petai]]
* [[User:Myoldryn|Jaan Nigul]]
* [[User:Yogiz|Yogiz]]

== Finnish ==

See also [[Openmoko Local Groups: Finland]].

Notes to Finnish translators: please use the dictionary at [http://lokalisointi.org/ lokalisointi.org], avoid anglisms, avoid capital letters where unnecessary etc., kiitos :) Also, send new, big translations to [http://lokalisointi.org/mailman/listinfo/laatu laatu] mailing list for review. Until openmoko specific lists, you may join [http://lokalisointi.org/mailman/listinfo/keskustelu keskustelu] list too (it can be used despite the fact it's been silent).

* [[User:Jani-Matti_Hätinen|Jani-Matti Hätinen]]
* [[User:TimoJyrinki|Timo Jyrinki]]
* [[User:Eyec|Samuli Perttula]]
* [[User:TuomoSipola|Tuomo Sipola]]

== French ==
* [[User:SebastienJolicoeur|Sebastien Jolicoeur]]
* [[User:MarcSert|Marc Sert]]
* [[User:FoucaultdeBonneval|Foucault deBonneval]]
* [[User:Sufflope|Jean-Sébastien Bour]]
* [[User:Ymahe|Yves Mahé]]
* [[User:opampca|Richard Lussier, Canada]]
* [[User:Kheldar|Guillaume Maiano]]
* [[User:Thomas01|Thomas Leclere]]
* [[User:fredlala|Frédéric Lasnier]]
* [[User:alekcxjo|Alexandre Raymond]]
* [[User:VdeGrandpré|Vincent de Grandpré, Montréal, Québec]]
* [[User:youshe|Frédéric Bouquet, Grenoble, France]]
* [[User:netdruide|Daniel Pallier, Lampaul-Plouarzel, France]]
* [[User:Pierrebrua|Pierre Brua]]

== Galician ==
* [[User:Fjrial|Frco. Javier Rial]]<br>
[http://www.mancomun.org Mancomun]<br>
Para poñerse en contacto enviar un correo-e a rolda http://listas.mancomun.org/mailman/listinfo/g11n

== German ==
* [[User:RobertMichel|Robert Michel]]
* [[User:FabianOff|Fabian Off]]
* [[User:Denis std|Denis]]
* [[User:ktd85|Thomas Drewermann]]
* Lars C.
* [[User:AndreasHochsteger|Andreas Hochsteger]]
* [[User:Christophloew|Christoph Löw]]
* [[User:dFence|Daniel Zauner]]
* [[User:Imitation|Thomas Sanladerer]]
* [[User:Peter Santo|Peter Santo]]
* [[User:Bartholomaus|Marco K.]]
* [[User:Gorschkow|Andre Gorschkow]]
* [[User:Klischeepunk|David Dorst]]

== Greek ==
* [[User:Chronix|Polychronis Papadakis]]

== Hebrew ==
עברית
* [[User:YaronSh|Yaron Shahrabani]]
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:Any_Key|Any_Key]]
* [[User:Koala|Koala]]

== Hungarian ==
* [[User:ZeD|Zoltán Balogh]]

== Indonesian ==
* [[User:Hcblue|Hcblue]]

== Italian ==
* per il momento useremo [http://www.openmokoboard.com/index.php?getforum=10 questo forum] per organizzarci. iscrivetevi e partecipate.
* [[User:SergioTota|Sergio Tota]]
* [[User:Franco|Franco Rimoldi]]
* [[User:Filippo|Filippo]]
* [[User:Massi|Massimiliano]]
* [[User:Markk0|Marco Cattaneo]]
* [[User:Cga|Callea Gaetano Andrea]]
* [[User:Herod2k|Alessandro]]
* [[User:shainer|Lisa Vitolo]]
* [[User:tia1982|Mattia]]
* [[User:azanutta|abe]]
* [[User:Gualti|Gualtiero]]
* [[User:Milo|Milo Casagrande]]
* [[User:White|Marco Celeri]]
* [[User:Aegis|Maurizio Scorianz]]

== Japanese ==
*[[User:WilliamLai|William Lai]]
*[[Momoko Matsuzaki]]

== Norwegian ==
*[[User:Vegar|Vegar Storvann]]
*[[User:Denniz|Denniz Fjerdingby]]
*[[User:StianEllingsen|Stian Ellingsen]]

== Polish ==
* [[User:KrzysztofKajkowski|Krzysztof Kajkowski]]
* Tomasz Zieliński
* [[User:MaciejLigenza|Maciej Ligenza]]
* [[User:PiotrDuda|Piotr Duda]]
* [[User:Zbraniecki|Zbigniew Braniecki]]

== Portuguese ==
*[[User:Skull Death|James Côrtes]]
* Sergio Bessa
* Mario Costa
*[[User:kuyky|Tiago Saraiva]]

== Panjabi ==
* [[User:aalam|A S Alam]]

== Romanian ==

* [[User:alexxed|Alexandru Szasz]]
* [[User:sin|Lucian]]
* [[User:Adrians|Adrians]]

== Russian ==
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:DenisBY|Denis Kot]]
* [[User:MikhailGusarov|Mikhail Gusarov]]
* [[User:x-demon|Alexander Sokolow]]
* [[User:Any_Key|Any_Key]]
* [[User:Dmitri|Dmitri]]
* [[User:Buffet|Denis Kaledin]]
* [[User:Nes|Mike Drapolyuk]]
* [[User:vase|Vasiliy Tolstov]]
* [[User:Shadowjack|Shadowjack]]
* [[User:Cray|Denis Parchenko]]
* [[User:Vlad|Vladimir Orlov]]
* [[User:xnike|Nikolay Khramchenkov]]
* [[User:kainspb|Nikolay Kasatkin]]

Можем начинать переводить wiki :)
К любой странице добавляете /ru и переводите. В конце оригинальной страницы и переведенной добавляете ссылку на шаблон
<nowiki>{{Languages|Имя_страницы_оригинала}}</nowiki>

== Slovak ==
* [[User:Cezz|Cezz]]
* [[User:PipBoy2000|PipBoy2000]]
* [[User:m4rtin.m|m4rtin.m]]

== Spanish ==
* [[User:RosangelaCaninoKoning|Rosangela CaninoKoning]]
* [[User:kresp0|Santiago Crespo (kresp0)]]
* [[User:José_Suárez|José Suárez]]
* [[User:Rafa_Couto|Rafa Couto (caligari)]]
* [[User:NeoMorfeo|Guillermo Santos (NeoMorfeo)]]
* [[User:Mandarino|Mandarino]]
* [[User:pptudela|Pepe Tudela]]
* [[User:avathar|Fernando González (Avathar)]]
* [[User:Rbruzz|Rbruzz]]
* [[User:Saaib|Urivan Flores Saaib (Saaib)]]
* [[User:mutrox|David Samblas Martinez (mutrox)]]

== Swedish ==
* [[User:yeager|Daniel Nylander]]
* [[User:possan|Per-Olov Jernberg]]
* [[User:C.M|Claes Mogren]]

== Turkish ==
* [[User:EnginErenturk|Engin Erenturk]]
* [[User:Supernova|İsmail AŞCI]]

== Welsh ==
* [[User:Rhoslyn_Prys|Rhoslyn Prys]]

And feel free to join and add an new language to this list above.

[[Category:Wiki Editing]]
[[Category:L10N]]

Translation

2009-04-11T22:06:43Z

Any Key: /* Hebrew - make it link friendly (ASCII) */

{{Languages|Translation}}

Let us spread the popularity of Openmoko by localization of the software and translation of documentation and wiki.

Just as an overview who is able and willing to translate parts into other languages, please join and add your Language and name. The source for the translation will be English. If you have good English skills then you could contribute by correcting the sources :)

A good point to start would be to continuous translating of
http://en.wikipedia.org/wiki/Openmoko into more languages on the other language sites of wikipedia.

"...it is easy to join and spend some minutes for translating,
and when someone finds some mistakes in any languages don't
blame the translator - just be productive and fix it yourself!" -[[User:RobertMichel|Robert Michel]]

Please take a look at [[Translation HOWTO]] and improve it if possible.

Languages already offered on our community mailinglist, please add your name yourself and join community mailinglist (until we'll have a proper mailinglist) to discuss about translations:

== Afrikaans ==

== Amharic ==
* [[User:ethiopia|Ethiopia Alemayehu]]

== Armenian ==
* [[User:surenk|Suren Karapetyan]]

== Arabic ==
عربي
* Hossam Mahmoud حسام محمود
* [[User:ترجمان05|ترجمان05]]
* [[User:Lixy|Lixy]] 17:54, 21 July 2007 (CEST)
* [[User:Waraqa|Waraqa]]

== Bulgarian ==
* [[User:Mr700|Doncho Nicolaev Gunchev]]

== Basque ==

* [[User:garrop|Ugartemendia]]
* [[User:aritza|aritza]]

== Catalan ==

* [[User:montxovs|Montxo Vicente i Sempere]]

* [[User:Mandarino|Mandarino]]

* [[User:RafaelCarreras|Rafael Carreras]]

* [[User:JaumeI|JaumeI]]

== Chinese (Simplified)==
* [[User:JarodWang|JarodWang]]
* [[User:Liuxf|Liuxf]]
* [[User:sunlt|sunlt]]

== Chinese (Traditional)==
* [[User:coolcat|Brenda Wang]]

== Czech ==
* [[User:Mikesh|Michal Heczko]]
* [[User:Vatoz|Vaclav Cerny]]
* [[User:Fox|Pavel Kovář]] (wiki)

== Danish ==
* [[User:EsbenDamgaard|Esben Damgaard]]
* [[User:UlrikRasmussen|Ulrik Rasmussen]]
* [[User:miki|Mikkel Kirkgaard Nielsen]]

== Dutch ==
* [[User:MarcVerwerft|Marc Verwerft]]
* [[User:Madjo|Marcel De Jong]]
* [[User:LuitvD|Luit van Drongelen]]
* [[User:reinouts|Reinout van Schouwen]]
* [[User:Steamrunner|Koen De Voegt]]

([[User:Madjo|Marcel]] 18/04) Misschien is het handig om alvast te beginnen met vertalen van de Wiki? Of hebben jullie andere ideeen? Ik heb al een start gemaakt van de voorpagina van de wiki, maar ben nog niet veel verder gekomen
([[User:reinouts|Reinout]] 21/04) Valt er verder nog niks te vertalen? De wiki is niet echt boeiend.

== Esperanto ==
* [[User:Antono|Antono Vasiljev]]
* [[User:Alekcxjo|Alekĉjo Rajmondo]]

== Estonian ==
* [[User:Hadara|Sven Petai]]
* [[User:Myoldryn|Jaan Nigul]]
* [[User:Yogiz|Yogiz]]

== Finnish ==

See also [[Openmoko Local Groups: Finland]].

Notes to Finnish translators: please use the dictionary at [http://lokalisointi.org/ lokalisointi.org], avoid anglisms, avoid capital letters where unnecessary etc., kiitos :) Also, send new, big translations to [http://lokalisointi.org/mailman/listinfo/laatu laatu] mailing list for review. Until openmoko specific lists, you may join [http://lokalisointi.org/mailman/listinfo/keskustelu keskustelu] list too (it can be used despite the fact it's been silent).

* [[User:Jani-Matti_Hätinen|Jani-Matti Hätinen]]
* [[User:TimoJyrinki|Timo Jyrinki]]
* [[User:Eyec|Samuli Perttula]]
* [[User:TuomoSipola|Tuomo Sipola]]

== French ==
* [[User:SebastienJolicoeur|Sebastien Jolicoeur]]
* [[User:MarcSert|Marc Sert]]
* [[User:FoucaultdeBonneval|Foucault deBonneval]]
* [[User:Sufflope|Jean-Sébastien Bour]]
* [[User:Ymahe|Yves Mahé]]
* [[User:opampca|Richard Lussier, Canada]]
* [[User:Kheldar|Guillaume Maiano]]
* [[User:Thomas01|Thomas Leclere]]
* [[User:fredlala|Frédéric Lasnier]]
* [[User:alekcxjo|Alexandre Raymond]]
* [[User:VdeGrandpré|Vincent de Grandpré, Montréal, Québec]]
* [[User:youshe|Frédéric Bouquet, Grenoble, France]]
* [[User:netdruide|Daniel Pallier, Lampaul-Plouarzel, France]]
* [[User:Pierrebrua|Pierre Brua]]

== Galician ==
* [[User:Fjrial|Frco. Javier Rial]]<br>
[http://www.mancomun.org Mancomun]<br>
Para poñerse en contacto enviar un correo-e a rolda http://listas.mancomun.org/mailman/listinfo/g11n

== German ==
* [[User:RobertMichel|Robert Michel]]
* [[User:FabianOff|Fabian Off]]
* [[User:Denis std|Denis]]
* [[User:ktd85|Thomas Drewermann]]
* Lars C.
* [[User:AndreasHochsteger|Andreas Hochsteger]]
* [[User:Christophloew|Christoph Löw]]
* [[User:dFence|Daniel Zauner]]
* [[User:Imitation|Thomas Sanladerer]]
* [[User:Peter Santo|Peter Santo]]
* [[User:Bartholomaus|Marco K.]]
* [[User:Gorschkow|Andre Gorschkow]]
* [[User:Klischeepunk|David Dorst]]

== Greek ==
* [[User:Chronix|Polychronis Papadakis]]

== Hebrew ==
עברית
* [[User:YaronSh|Yaron Shahrabani]]
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:Any_Key|Any_Key]]
* [[User:Koala|Koala]]

== Hungarian ==
* [[User:ZeD|Zoltán Balogh]]

== Indonesian ==
* [[User:Hcblue|Hcblue]]

== Italian ==
* per il momento useremo [http://www.openmokoboard.com/index.php?getforum=10 questo forum] per organizzarci. iscrivetevi e partecipate.
* [[User:SergioTota|Sergio Tota]]
* [[User:Franco|Franco Rimoldi]]
* [[User:Filippo|Filippo]]
* [[User:Massi|Massimiliano]]
* [[User:Markk0|Marco Cattaneo]]
* [[User:Cga|Callea Gaetano Andrea]]
* [[User:Herod2k|Alessandro]]
* [[User:shainer|Lisa Vitolo]]
* [[User:tia1982|Mattia]]
* [[User:azanutta|abe]]
* [[User:Gualti|Gualtiero]]
* [[User:Milo|Milo Casagrande]]
* [[User:White|Marco Celeri]]
* [[User:Aegis|Maurizio Scorianz]]

== Japanese ==
*[[User:WilliamLai|William Lai]]
*[[Momoko Matsuzaki]]

== Norwegian ==
*[[User:Vegar|Vegar Storvann]]
*[[User:Denniz|Denniz Fjerdingby]]
*[[User:StianEllingsen|Stian Ellingsen]]

== Polish ==
* [[User:KrzysztofKajkowski|Krzysztof Kajkowski]]
* Tomasz Zieliński
* [[User:MaciejLigenza|Maciej Ligenza]]
* [[User:PiotrDuda|Piotr Duda]]
* [[User:Zbraniecki|Zbigniew Braniecki]]

== Portuguese ==
*[[User:Skull Death|James Côrtes]]
* Sergio Bessa
* Mario Costa
*[[User:kuyky|Tiago Saraiva]]

== Punjabi ==
* [[User:aalam|A S Alam]]

== Romanian ==

* [[User:alexxed|Alexandru Szasz]]
* [[User:sin|Lucian]]
* [[User:Adrians|Adrians]]

== Russian ==
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:DenisBY|Denis Kot]]
* [[User:MikhailGusarov|Mikhail Gusarov]]
* [[User:x-demon|Alexander Sokolow]]
* [[User:Any_Key|Any_Key]]
* [[User:Dmitri|Dmitri]]
* [[User:Buffet|Denis Kaledin]]
* [[User:Nes|Mike Drapolyuk]]
* [[User:vase|Vasiliy Tolstov]]
* [[User:Shadowjack|Shadowjack]]
* [[User:Cray|Denis Parchenko]]
* [[User:Vlad|Vladimir Orlov]]
* [[User:xnike|Nikolay Khramchenkov]]
* [[User:kainspb|Nikolay Kasatkin]]

Можем начинать переводить wiki :)
К любой странице добавляете /ru и переводите. В конце оригинальной страницы и переведенной добавляете ссылку на шаблон
<nowiki>{{Languages|Имя_страницы_оригинала}}</nowiki>

== Slovak ==
* [[User:Cezz|Cezz]]
* [[User:PipBoy2000|PipBoy2000]]
* [[User:m4rtin.m|m4rtin.m]]

== Spanish ==
* [[User:RosangelaCaninoKoning|Rosangela CaninoKoning]]
* [[User:kresp0|Santiago Crespo (kresp0)]]
* [[User:José_Suárez|José Suárez]]
* [[User:Rafa_Couto|Rafa Couto (caligari)]]
* [[User:NeoMorfeo|Guillermo Santos (NeoMorfeo)]]
* [[User:Mandarino|Mandarino]]
* [[User:pptudela|Pepe Tudela]]
* [[User:avathar|Fernando González (Avathar)]]
* [[User:Rbruzz|Rbruzz]]
* [[User:Saaib|Urivan Flores Saaib (Saaib)]]
* [[User:mutrox|David Samblas Martinez (mutrox)]]

== Swedish ==
* [[User:yeager|Daniel Nylander]]
* [[User:possan|Per-Olov Jernberg]]
* [[User:C.M|Claes Mogren]]

== Turkish ==
* [[User:EnginErenturk|Engin Erenturk]]
* [[User:Supernova|İsmail AŞCI]]

== Welsh ==
* [[User:Rhoslyn_Prys|Rhoslyn Prys]]

And feel free to join and add an new language to this list above.

[[Category:Wiki Editing]]
[[Category:L10N]]

Translation

2009-04-11T22:03:26Z

Any Key: Arabic - Make it link frienfly (ASCII)

{{Languages|Translation}}

Let us spread the popularity of Openmoko by localization of the software and translation of documentation and wiki.

Just as an overview who is able and willing to translate parts into other languages, please join and add your Language and name. The source for the translation will be English. If you have good English skills then you could contribute by correcting the sources :)

A good point to start would be to continuous translating of
http://en.wikipedia.org/wiki/Openmoko into more languages on the other language sites of wikipedia.

"...it is easy to join and spend some minutes for translating,
and when someone finds some mistakes in any languages don't
blame the translator - just be productive and fix it yourself!" -[[User:RobertMichel|Robert Michel]]

Please take a look at [[Translation HOWTO]] and improve it if possible.

Languages already offered on our community mailinglist, please add your name yourself and join community mailinglist (until we'll have a proper mailinglist) to discuss about translations:

== Afrikaans ==

== Amharic ==
* [[User:ethiopia|Ethiopia Alemayehu]]

== Armenian ==
* [[User:surenk|Suren Karapetyan]]

== Arabic ==
عربي
* Hossam Mahmoud حسام محمود
* [[User:ترجمان05|ترجمان05]]
* [[User:Lixy|Lixy]] 17:54, 21 July 2007 (CEST)
* [[User:Waraqa|Waraqa]]

== Bulgarian ==
* [[User:Mr700|Doncho Nicolaev Gunchev]]

== Basque ==

* [[User:garrop|Ugartemendia]]
* [[User:aritza|aritza]]

== Catalan ==

* [[User:montxovs|Montxo Vicente i Sempere]]

* [[User:Mandarino|Mandarino]]

* [[User:RafaelCarreras|Rafael Carreras]]

* [[User:JaumeI|JaumeI]]

== Chinese (Simplified)==
* [[User:JarodWang|JarodWang]]
* [[User:Liuxf|Liuxf]]
* [[User:sunlt|sunlt]]

== Chinese (Traditional)==
* [[User:coolcat|Brenda Wang]]

== Czech ==
* [[User:Mikesh|Michal Heczko]]
* [[User:Vatoz|Vaclav Cerny]]
* [[User:Fox|Pavel Kovář]] (wiki)

== Danish ==
* [[User:EsbenDamgaard|Esben Damgaard]]
* [[User:UlrikRasmussen|Ulrik Rasmussen]]
* [[User:miki|Mikkel Kirkgaard Nielsen]]

== Dutch ==
* [[User:MarcVerwerft|Marc Verwerft]]
* [[User:Madjo|Marcel De Jong]]
* [[User:LuitvD|Luit van Drongelen]]
* [[User:reinouts|Reinout van Schouwen]]
* [[User:Steamrunner|Koen De Voegt]]

([[User:Madjo|Marcel]] 18/04) Misschien is het handig om alvast te beginnen met vertalen van de Wiki? Of hebben jullie andere ideeen? Ik heb al een start gemaakt van de voorpagina van de wiki, maar ben nog niet veel verder gekomen
([[User:reinouts|Reinout]] 21/04) Valt er verder nog niks te vertalen? De wiki is niet echt boeiend.

== Esperanto ==
* [[User:Antono|Antono Vasiljev]]
* [[User:Alekcxjo|Alekĉjo Rajmondo]]

== Estonian ==
* [[User:Hadara|Sven Petai]]
* [[User:Myoldryn|Jaan Nigul]]
* [[User:Yogiz|Yogiz]]

== Finnish ==

See also [[Openmoko Local Groups: Finland]].

Notes to Finnish translators: please use the dictionary at [http://lokalisointi.org/ lokalisointi.org], avoid anglisms, avoid capital letters where unnecessary etc., kiitos :) Also, send new, big translations to [http://lokalisointi.org/mailman/listinfo/laatu laatu] mailing list for review. Until openmoko specific lists, you may join [http://lokalisointi.org/mailman/listinfo/keskustelu keskustelu] list too (it can be used despite the fact it's been silent).

* [[User:Jani-Matti_Hätinen|Jani-Matti Hätinen]]
* [[User:TimoJyrinki|Timo Jyrinki]]
* [[User:Eyec|Samuli Perttula]]
* [[User:TuomoSipola|Tuomo Sipola]]

== French ==
* [[User:SebastienJolicoeur|Sebastien Jolicoeur]]
* [[User:MarcSert|Marc Sert]]
* [[User:FoucaultdeBonneval|Foucault deBonneval]]
* [[User:Sufflope|Jean-Sébastien Bour]]
* [[User:Ymahe|Yves Mahé]]
* [[User:opampca|Richard Lussier, Canada]]
* [[User:Kheldar|Guillaume Maiano]]
* [[User:Thomas01|Thomas Leclere]]
* [[User:fredlala|Frédéric Lasnier]]
* [[User:alekcxjo|Alexandre Raymond]]
* [[User:VdeGrandpré|Vincent de Grandpré, Montréal, Québec]]
* [[User:youshe|Frédéric Bouquet, Grenoble, France]]
* [[User:netdruide|Daniel Pallier, Lampaul-Plouarzel, France]]
* [[User:Pierrebrua|Pierre Brua]]

== Galician ==
* [[User:Fjrial|Frco. Javier Rial]]<br>
[http://www.mancomun.org Mancomun]<br>
Para poñerse en contacto enviar un correo-e a rolda http://listas.mancomun.org/mailman/listinfo/g11n

== German ==
* [[User:RobertMichel|Robert Michel]]
* [[User:FabianOff|Fabian Off]]
* [[User:Denis std|Denis]]
* [[User:ktd85|Thomas Drewermann]]
* Lars C.
* [[User:AndreasHochsteger|Andreas Hochsteger]]
* [[User:Christophloew|Christoph Löw]]
* [[User:dFence|Daniel Zauner]]
* [[User:Imitation|Thomas Sanladerer]]
* [[User:Peter Santo|Peter Santo]]
* [[User:Bartholomaus|Marco K.]]
* [[User:Gorschkow|Andre Gorschkow]]
* [[User:Klischeepunk|David Dorst]]

== Greek ==
* [[User:Chronix|Polychronis Papadakis]]

== Hebrew - עברית ==
* [[User:YaronSh|Yaron Shahrabani]]
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:Any_Key|Any_Key]]
* [[User:Koala|Koala]]

== Hungarian ==
* [[User:ZeD|Zoltán Balogh]]

== Indonesian ==
* [[User:Hcblue|Hcblue]]

== Italian ==
* per il momento useremo [http://www.openmokoboard.com/index.php?getforum=10 questo forum] per organizzarci. iscrivetevi e partecipate.
* [[User:SergioTota|Sergio Tota]]
* [[User:Franco|Franco Rimoldi]]
* [[User:Filippo|Filippo]]
* [[User:Massi|Massimiliano]]
* [[User:Markk0|Marco Cattaneo]]
* [[User:Cga|Callea Gaetano Andrea]]
* [[User:Herod2k|Alessandro]]
* [[User:shainer|Lisa Vitolo]]
* [[User:tia1982|Mattia]]
* [[User:azanutta|abe]]
* [[User:Gualti|Gualtiero]]
* [[User:Milo|Milo Casagrande]]
* [[User:White|Marco Celeri]]
* [[User:Aegis|Maurizio Scorianz]]

== Japanese ==
*[[User:WilliamLai|William Lai]]
*[[Momoko Matsuzaki]]

== Norwegian ==
*[[User:Vegar|Vegar Storvann]]
*[[User:Denniz|Denniz Fjerdingby]]
*[[User:StianEllingsen|Stian Ellingsen]]

== Polish ==
* [[User:KrzysztofKajkowski|Krzysztof Kajkowski]]
* Tomasz Zieliński
* [[User:MaciejLigenza|Maciej Ligenza]]
* [[User:PiotrDuda|Piotr Duda]]
* [[User:Zbraniecki|Zbigniew Braniecki]]

== Portuguese ==
*[[User:Skull Death|James Côrtes]]
* Sergio Bessa
* Mario Costa
*[[User:kuyky|Tiago Saraiva]]

== Punjabi ==
* [[User:aalam|A S Alam]]

== Romanian ==

* [[User:alexxed|Alexandru Szasz]]
* [[User:sin|Lucian]]
* [[User:Adrians|Adrians]]

== Russian ==
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:DenisBY|Denis Kot]]
* [[User:MikhailGusarov|Mikhail Gusarov]]
* [[User:x-demon|Alexander Sokolow]]
* [[User:Any_Key|Any_Key]]
* [[User:Dmitri|Dmitri]]
* [[User:Buffet|Denis Kaledin]]
* [[User:Nes|Mike Drapolyuk]]
* [[User:vase|Vasiliy Tolstov]]
* [[User:Shadowjack|Shadowjack]]
* [[User:Cray|Denis Parchenko]]
* [[User:Vlad|Vladimir Orlov]]
* [[User:xnike|Nikolay Khramchenkov]]
* [[User:kainspb|Nikolay Kasatkin]]

Можем начинать переводить wiki :)
К любой странице добавляете /ru и переводите. В конце оригинальной страницы и переведенной добавляете ссылку на шаблон
<nowiki>{{Languages|Имя_страницы_оригинала}}</nowiki>

== Slovak ==
* [[User:Cezz|Cezz]]
* [[User:PipBoy2000|PipBoy2000]]
* [[User:m4rtin.m|m4rtin.m]]

== Spanish ==
* [[User:RosangelaCaninoKoning|Rosangela CaninoKoning]]
* [[User:kresp0|Santiago Crespo (kresp0)]]
* [[User:José_Suárez|José Suárez]]
* [[User:Rafa_Couto|Rafa Couto (caligari)]]
* [[User:NeoMorfeo|Guillermo Santos (NeoMorfeo)]]
* [[User:Mandarino|Mandarino]]
* [[User:pptudela|Pepe Tudela]]
* [[User:avathar|Fernando González (Avathar)]]
* [[User:Rbruzz|Rbruzz]]
* [[User:Saaib|Urivan Flores Saaib (Saaib)]]
* [[User:mutrox|David Samblas Martinez (mutrox)]]

== Swedish ==
* [[User:yeager|Daniel Nylander]]
* [[User:possan|Per-Olov Jernberg]]
* [[User:C.M|Claes Mogren]]

== Turkish ==
* [[User:EnginErenturk|Engin Erenturk]]
* [[User:Supernova|İsmail AŞCI]]

== Welsh ==
* [[User:Rhoslyn_Prys|Rhoslyn Prys]]

And feel free to join and add an new language to this list above.

[[Category:Wiki Editing]]
[[Category:L10N]]

Translation HOWTO

2009-04-11T07:46:21Z

Any Key: adding category L10N

{{Languages|Translation_HOWTO}}

Main page for localization is [[Translation]]. This page contains some help on how to do Wiki text and Openmoko software translations.

== Translating Openmoko Wiki ==

Rule of thumb: It's better to have some translation than nothing, so feel free to translate.

To create a new translation, simply click on your language's link when viewing the English version and start editing in the appearing box.

Always add the Languages template to the page, so that users can link back to other languages. For example this page starts with:

<pre><nowiki>
{{Languages|Translation_HOWTO}}
</nowiki></pre>

Translated articles should not be added to the English category. Please always use the language suffix for the category name too.

=== Article titles ===

Please use the '''English''' title of the article. This will ensure that the language bar template can link to localized version of the article. For example: [[Main_Page]] and [[Main_Page/fr]].

=== Category names and category pages ===

The category names must be '''English'''. Append your language's code to the end. This will ensure that language bar will work and allow users to navigate between various languages of the category. For example: [[:Category:Hardware]] and [[:Category:Hardware/fr]].

If the category name becomes red in your article, that means there is no '''category page''' for this category yet in this language. (First make sure you don't have a typo in the name!) Please click that red category name, and create the category page for it, which contains the following:

* Languages template, same as on the English version of the category
* Parent categories, same as on the English version but with language suffixes

For example on [[:Category:Basic End User]]:

<pre><nowiki>
{{Languages|:Category:Basic End User}}

[[Category:Community/de]]
</nowiki></pre>

Of course you may want to translate the English description of this category too and add between these lines.

=== Finding what to translate ===

If you are not sure what page is most popular and ready for translation. Please refer to following list.

Please start at these pages. Or you can add the page you think is important.

{| class="wikitable sortable" style="margin: 0em " cellspacing="0" cellpadding="5" border="1"
! Page Name !! Language Versions !!Maintainer!!Status
|-
| [[Getting Started with your Neo FreeRunner]] ||Tranditional Chinese || {{user|coolcat|Brenda Wang}} ||Finished
|-
| [[Neo FreeRunner GTA02 Hardware]] ||Tranditional Chinese || {{user|coolcat|Brenda Wang}} ||Finished
|-
| [[Booting from SD]] ||Tranditional Chinese || {{user|coolcat|Brenda Wang}} ||Finished
|-
| [[Toolchain]] ||Tranditional Chinese || {{user|coolcat|Brenda Wang}} ||Finished
|-
| [[Distributions]] ||none || none ||todo
|-
| [[Om2008.8]] ||none || none ||todo
|}

== Translating Openmoko software ==

There are specialized tools for *.pot (*.po) files edition gtranslator, po4a, poedit, pootle, potool ... [http://translate.sourceforge.net/wiki/pootle/index Pootle] can host several projects and languages to coordinate translation activities, and allow online translation.

Most of text editors will fit also: vim, emacs, ed, gedit ...

=== Updating source tree ===
{{todo|descript SVN update after editing}}

=== Notes ===
* Encoding for *.po is UTF-8
* Most of packages in [[OpenEmbedded]] tree already internationalized, its worth to review them

=== Common space for localization effort ===

'''please join the community ml for now.''' there's also some talking about creating a translators ml [[Talk:Translation#Need for translation mailing list (and coordinators?)|here]] [http://lists.openmoko.org/pipermail/community/2007-April/004973.html and here: OM-i18n-ml] feel free to join both discussions. [[User:Cga|cga]] sat apr 28th 20:48:35 CEST 2007)

=== List of Openmoko related PO's===

Most of apps in /home/moko/sources/svn/ and /home/moko/openmoko/trunk/src/target/OM-2007/applications/ don have *.pot files for now, but some of them have *.po files for some of the languages

[[Category:Wiki Editing]]
[[Category:L10N]]

Category:L10N

2009-04-11T07:42:22Z

Any Key: New page: L10N stands for localization, thats mean you can translate your favorite programm top your language of choice. If you know more than one language don't hesitate, pick up some progect and t...

L10N stands for localization, thats mean you can translate your favorite programm top your language of choice.
If you know more than one language don't hesitate, pick up some progect and translate it.

Translation

2009-04-11T07:38:31Z

Any Key: /* Welsh */

{{Languages|Translation}}

Let us spread the popularity of Openmoko by localization of the software and translation of documentation and wiki.

Just as an overview who is able and willing to translate parts into other languages, please join and add your Language and name. The source for the translation will be English. If you have good English skills then you could contribute by correcting the sources :)

A good point to start would be to continuous translating of
http://en.wikipedia.org/wiki/Openmoko into more languages on the other language sites of wikipedia.

"...it is easy to join and spend some minutes for translating,
and when someone finds some mistakes in any languages don't
blame the translator - just be productive and fix it yourself!" -[[User:RobertMichel|Robert Michel]]

Please take a look at [[Translation HOWTO]] and improve it if possible.

Languages already offered on our community mailinglist, please add your name yourself and join community mailinglist (until we'll have a proper mailinglist) to discuss about translations:

== Afrikaans ==

== Amharic ==
* [[User:ethiopia|Ethiopia Alemayehu]]

== Armenian ==
* [[User:surenk|Suren Karapetyan]]

== Arabic عربي ==
* Hossam Mahmoud حسام محمود
* [[User:ترجمان05|ترجمان05]]
* [[User:Lixy|Lixy]] 17:54, 21 July 2007 (CEST)
* [[User:Waraqa|Waraqa]]

== Bulgarian ==
* [[User:Mr700|Doncho Nicolaev Gunchev]]

== Basque ==

* [[User:garrop|Ugartemendia]]
* [[User:aritza|aritza]]

== Catalan ==

* [[User:montxovs|Montxo Vicente i Sempere]]

* [[User:Mandarino|Mandarino]]

* [[User:RafaelCarreras|Rafael Carreras]]

* [[User:JaumeI|JaumeI]]

== Chinese (Simplified)==
* [[User:JarodWang|JarodWang]]
* [[User:Liuxf|Liuxf]]
* [[User:sunlt|sunlt]]

== Chinese (Traditional)==
* [[User:coolcat|Brenda Wang]]

== Czech ==
* [[User:Mikesh|Michal Heczko]]
* [[User:Vatoz|Vaclav Cerny]]
* [[User:Fox|Pavel Kovář]] (wiki)

== Danish ==
* [[User:EsbenDamgaard|Esben Damgaard]]
* [[User:UlrikRasmussen|Ulrik Rasmussen]]
* [[User:miki|Mikkel Kirkgaard Nielsen]]

== Dutch ==
* [[User:MarcVerwerft|Marc Verwerft]]
* [[User:Madjo|Marcel De Jong]]
* [[User:LuitvD|Luit van Drongelen]]
* [[User:reinouts|Reinout van Schouwen]]
* [[User:Steamrunner|Koen De Voegt]]

([[User:Madjo|Marcel]] 18/04) Misschien is het handig om alvast te beginnen met vertalen van de Wiki? Of hebben jullie andere ideeen? Ik heb al een start gemaakt van de voorpagina van de wiki, maar ben nog niet veel verder gekomen
([[User:reinouts|Reinout]] 21/04) Valt er verder nog niks te vertalen? De wiki is niet echt boeiend.

== Esperanto ==
* [[User:Antono|Antono Vasiljev]]
* [[User:Alekcxjo|Alekĉjo Rajmondo]]

== Estonian ==
* [[User:Hadara|Sven Petai]]
* [[User:Myoldryn|Jaan Nigul]]
* [[User:Yogiz|Yogiz]]

== Finnish ==

See also [[Openmoko Local Groups: Finland]].

Notes to Finnish translators: please use the dictionary at [http://lokalisointi.org/ lokalisointi.org], avoid anglisms, avoid capital letters where unnecessary etc., kiitos :) Also, send new, big translations to [http://lokalisointi.org/mailman/listinfo/laatu laatu] mailing list for review. Until openmoko specific lists, you may join [http://lokalisointi.org/mailman/listinfo/keskustelu keskustelu] list too (it can be used despite the fact it's been silent).

* [[User:Jani-Matti_Hätinen|Jani-Matti Hätinen]]
* [[User:TimoJyrinki|Timo Jyrinki]]
* [[User:Eyec|Samuli Perttula]]
* [[User:TuomoSipola|Tuomo Sipola]]

== French ==
* [[User:SebastienJolicoeur|Sebastien Jolicoeur]]
* [[User:MarcSert|Marc Sert]]
* [[User:FoucaultdeBonneval|Foucault deBonneval]]
* [[User:Sufflope|Jean-Sébastien Bour]]
* [[User:Ymahe|Yves Mahé]]
* [[User:opampca|Richard Lussier, Canada]]
* [[User:Kheldar|Guillaume Maiano]]
* [[User:Thomas01|Thomas Leclere]]
* [[User:fredlala|Frédéric Lasnier]]
* [[User:alekcxjo|Alexandre Raymond]]
* [[User:VdeGrandpré|Vincent de Grandpré, Montréal, Québec]]
* [[User:youshe|Frédéric Bouquet, Grenoble, France]]
* [[User:netdruide|Daniel Pallier, Lampaul-Plouarzel, France]]
* [[User:Pierrebrua|Pierre Brua]]

== Galician ==
* [[User:Fjrial|Frco. Javier Rial]]<br>
[http://www.mancomun.org Mancomun]<br>
Para poñerse en contacto enviar un correo-e a rolda http://listas.mancomun.org/mailman/listinfo/g11n

== German ==
* [[User:RobertMichel|Robert Michel]]
* [[User:FabianOff|Fabian Off]]
* [[User:Denis std|Denis]]
* [[User:ktd85|Thomas Drewermann]]
* Lars C.
* [[User:AndreasHochsteger|Andreas Hochsteger]]
* [[User:Christophloew|Christoph Löw]]
* [[User:dFence|Daniel Zauner]]
* [[User:Imitation|Thomas Sanladerer]]
* [[User:Peter Santo|Peter Santo]]
* [[User:Bartholomaus|Marco K.]]
* [[User:Gorschkow|Andre Gorschkow]]
* [[User:Klischeepunk|David Dorst]]

== Greek ==
* [[User:Chronix|Polychronis Papadakis]]

== Hebrew - עברית ==
* [[User:YaronSh|Yaron Shahrabani]]
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:Any_Key|Any_Key]]
* [[User:Koala|Koala]]

== Hungarian ==
* [[User:ZeD|Zoltán Balogh]]

== Indonesian ==
* [[User:Hcblue|Hcblue]]

== Italian ==
* per il momento useremo [http://www.openmokoboard.com/index.php?getforum=10 questo forum] per organizzarci. iscrivetevi e partecipate.
* [[User:SergioTota|Sergio Tota]]
* [[User:Franco|Franco Rimoldi]]
* [[User:Filippo|Filippo]]
* [[User:Massi|Massimiliano]]
* [[User:Markk0|Marco Cattaneo]]
* [[User:Cga|Callea Gaetano Andrea]]
* [[User:Herod2k|Alessandro]]
* [[User:shainer|Lisa Vitolo]]
* [[User:tia1982|Mattia]]
* [[User:azanutta|abe]]
* [[User:Gualti|Gualtiero]]
* [[User:Milo|Milo Casagrande]]
* [[User:White|Marco Celeri]]
* [[User:Aegis|Maurizio Scorianz]]

== Japanese ==
*[[User:WilliamLai|William Lai]]
*[[Momoko Matsuzaki]]

== Norwegian ==
*[[User:Vegar|Vegar Storvann]]
*[[User:Denniz|Denniz Fjerdingby]]
*[[User:StianEllingsen|Stian Ellingsen]]

== Polish ==
* [[User:KrzysztofKajkowski|Krzysztof Kajkowski]]
* Tomasz Zieliński
* [[User:MaciejLigenza|Maciej Ligenza]]
* [[User:PiotrDuda|Piotr Duda]]
* [[User:Zbraniecki|Zbigniew Braniecki]]

== Portuguese ==
*[[User:Skull Death|James Côrtes]]
* Sergio Bessa
* Mario Costa
*[[User:kuyky|Tiago Saraiva]]

== Punjabi ==
* [[User:aalam|A S Alam]]

== Romanian ==

* [[User:alexxed|Alexandru Szasz]]
* [[User:sin|Lucian]]
* [[User:Adrians|Adrians]]

== Russian ==
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:DenisBY|Denis Kot]]
* [[User:MikhailGusarov|Mikhail Gusarov]]
* [[User:x-demon|Alexander Sokolow]]
* [[User:Any_Key|Any_Key]]
* [[User:Dmitri|Dmitri]]
* [[User:Buffet|Denis Kaledin]]
* [[User:Nes|Mike Drapolyuk]]
* [[User:vase|Vasiliy Tolstov]]
* [[User:Shadowjack|Shadowjack]]
* [[User:Cray|Denis Parchenko]]
* [[User:Vlad|Vladimir Orlov]]
* [[User:xnike|Nikolay Khramchenkov]]
* [[User:kainspb|Nikolay Kasatkin]]

Можем начинать переводить wiki :)
К любой странице добавляете /ru и переводите. В конце оригинальной страницы и переведенной добавляете ссылку на шаблон
<nowiki>{{Languages|Имя_страницы_оригинала}}</nowiki>

== Slovak ==
* [[User:Cezz|Cezz]]
* [[User:PipBoy2000|PipBoy2000]]
* [[User:m4rtin.m|m4rtin.m]]

== Spanish ==
* [[User:RosangelaCaninoKoning|Rosangela CaninoKoning]]
* [[User:kresp0|Santiago Crespo (kresp0)]]
* [[User:José_Suárez|José Suárez]]
* [[User:Rafa_Couto|Rafa Couto (caligari)]]
* [[User:NeoMorfeo|Guillermo Santos (NeoMorfeo)]]
* [[User:Mandarino|Mandarino]]
* [[User:pptudela|Pepe Tudela]]
* [[User:avathar|Fernando González (Avathar)]]
* [[User:Rbruzz|Rbruzz]]
* [[User:Saaib|Urivan Flores Saaib (Saaib)]]
* [[User:mutrox|David Samblas Martinez (mutrox)]]

== Swedish ==
* [[User:yeager|Daniel Nylander]]
* [[User:possan|Per-Olov Jernberg]]
* [[User:C.M|Claes Mogren]]

== Turkish ==
* [[User:EnginErenturk|Engin Erenturk]]
* [[User:Supernova|İsmail AŞCI]]

== Welsh ==
* [[User:Rhoslyn_Prys|Rhoslyn Prys]]

And feel free to join and add an new language to this list above.

[[Category:Wiki Editing]]
[[Category:L10N]]

User:Any Key

2009-04-11T07:18:59Z

Any Key:

Ilive in Saint-Petersburg, Russia.
So if you application developer or just want some app to be translated to/from Rusiian or Hebrew feel free to drop me email.

[[User:Any Key|Any Key]]

Voicenote

2009-02-26T08:03:38Z

Any Key: spelling

This page is a draft description / to-do list for my 1st application "voicenote"

= Voicenote 0.3=
[[Image:Voicenote.png]]
== Presentation ==
'''Voicenote''' is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.

It is based on the '''arecord''' / aplay librairy and use the '''alsactl''' to change the audio scenario ( /usr/share/openmoko/scenarios/voip-handset.state restore is used) .

It uses '''zenity''' as a basic graphical gui.

== Installation ==

=== Dependencies ===
You need '''zenity''' and '''alsa-utils-aplay''' to make it work.

=== OM / SHR ===

So to install it, you can do :
opkg install http://buildhost.automated.it/OM2007.2/packages/armv4t/zenity_2.20.1-r0_armv4t.ipk alsa-utils-aplay http://kimaidou.kilu.de/openmoko/voicenote/voicenote_0.3_arm.ipk

For SHR user, you might use the -force-depends option to avoid the error with gtk+fastscaling

=== Debian base distributions ===
I have not made a package yet. So if you want to try it, you have to use the script alone :
apt-get install zenity alsa-utils-aplay
cd ~
wget http://kimaidou.kilu.de/openmoko/voicenote/voicenote
chmod +x voicenote
To launch it, do
cd ~
./voicenote

== Using voicenote ==
* Just click on the desktop icon [[Image:Voicenote.png|30px]] called "Voicenote" to load the software

* Then you have to choose between recording or playing a voice note (a wav file). When finished recording or playing, you go back to this first window. Click "Cancel" to quit the application.

* For now the wav files are saved with a "voicenote_" prefix and the date and time (YYYY-MM-DD_HH-MI). For example: '''voicenote_2009-02-20_12-34.wav''' means a this voice note has been recorded at 12:34 the 20th of feb 2009.

== Changelog ==
=== 2009-02-25 - v0.3 ===
* Now you can play the wav files from Voicenote
* You go back to the 1st choice window after recording or playing a file. To quit the software, click on the button "Cancel".

=== 2009-02-24 - v0.2 ===
2nd version:
* GPL license added
* the user can select the wave files destination folder at the first startup (and then modify it in the file ~/.voicenote/voicenote.cfg
* the wave file is now recorded in mono at 8000 kHz (which saves a lot of CPU and bytes)
* addition of comments in the script
* the script is called "voicenote", and not anymore "voicenote.sh"

=== 2009-02-19 - v0.1 ===
initial version

== Future improvements / To do list ==
* add the GPS date and time information (+/- latitude and longitude) so that each wav file can be used for OpenStreetMap mapping.
* improve the quality of the sound
* add a README text file
* package it for debian
* allow the user to choose the microphone source (headset or handset)
* allow the user to choose the state file for playing the wave files.
* enable job control (set -m in th script)
* more language
* replace zenity by a real frontend as EFL ?
[[Category:Audio]]
[[Category:Audio Applications]]

Voicenote

2009-02-26T08:02:00Z

Any Key: /* Futur improvement / To do list */

This page is a draft description / to-do list for my 1st application "voicenote"

= Voicenote 0.3=
[[Image:Voicenote.png]]
== Presentation ==
'''Voicenote''' is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.

It is based on the '''arecord''' / aplay librairy and use the '''alsactl''' to change the audio scenario ( /usr/share/openmoko/scenarios/voip-handset.state restore is used) .

It uses '''zenity''' as a basic graphical gui.

== Installation ==

=== Dependencies ===
You need '''zenity''' and '''alsa-utils-aplay''' to make it work.

=== OM / SHR ===

So to install it, you can do :
opkg install http://buildhost.automated.it/OM2007.2/packages/armv4t/zenity_2.20.1-r0_armv4t.ipk alsa-utils-aplay http://kimaidou.kilu.de/openmoko/voicenote/voicenote_0.3_arm.ipk

For SHR user, you might use the -force-depends option to avoid the error with gtk+fastscaling

=== Debian base distributions ===
I have not made a package yet. So if you want to try it, you have to use the script alone :
apt-get install zenity alsa-utils-aplay
cd ~
wget http://kimaidou.kilu.de/openmoko/voicenote/voicenote
chmod +x voicenote
To launch it, do
cd ~
./voicenote

== Using voicenote ==
* Just click on the desktop icon [[Image:Voicenote.png|30px]] called "Voicenote" to load the software

* Then you have to choose between recording or playing a voice note (a wav file). When finished recording or playing, you go back to this first window. Click "Cancel" to quit the application.

* For now the wav files are saved with a "voicenote_" prefix and the date and time (YYYY-MM-DD_HH-MI). For example: '''voicenote_2009-02-20_12-34.wav''' means a this voice note has been recorded at 12:34 the 20th of feb 2009.

== Changelog ==
=== 2009-02-25 - v0.3 ===
* Now you can play the wav files from Voicenote
* You go back to the 1st choice window after recording or playing a file. To quit the software, click on the button "Cancel".

=== 2009-02-24 - v0.2 ===
2nd version:
* GPL license added
* the user can select the wave files destination folder at the first startup (and then modify it in the file ~/.voicenote/voicenote.cfg
* the wave file is now recorded in mono at 8000 kHz (which saves a lot of CPU and bytes)
* addition of comments in the script
* the script is called "voicenote", and not anymore "voicenote.sh"

=== 2009-02-19 - v0.1 ===
initial version

== Futur improvement / To do list ==
* add the GPS date and time information (+/- latitude and longitude) so that each wav file can be used for OpenStreetMap mapping.
* improve the quality of the sound
* add a README text file
* package it for debian
* allow the user to choose the microphone source (headset or handset)
* allox the user to choose the state file for playing the wave files.
* enable job control (set -m in th script)
* more language
* replace zenity by a real frontend as EFL ?
[[Category:Audio]]
[[Category:Audio Applications]]

Recording audio

2009-02-26T08:01:02Z

Any Key: /* Information for developers */

== For the impatient ==

In order to record audio you need a special alsa state file and we provide a link to one that works below (SHA1:55888a699e969c5e2c4690e6aff47ccad7ad0f3d). It can be used to put the device into voice recording mode.

alsactl -f [http://svn.arhuaco.org/svn/src/openmoko/misc-files/ALSA/voip-handset.state voip-handset.state] restore
arecord -D hw -f cd -v -t wav rec-$(date +%Y-%m-%d-%H-%M).wav

With these commands you should get a file in Waveform audio format (WAV) in the local directory.

== Applications that record audio ==

In alphabetical order.

* [[Guitartune]]
* [[Monologue]]
* [[Voicenote]]

== Information for developers ==

Mixer settings for voice recording: It is required that DAI Mode (alsa control number 50) is "DAI 2". As of 23/Feb/2009 "DAI 1" mode is broken. Not all the DAI modes work and people are working on this.

Here we have a list of relevant tickets that are open now:

* [https://docs.openmoko.org/trac/ticket/2073 #2073]

[[Category:Audio]]
[[Category:Audio Applications]]

Recording audio

2009-02-26T08:00:14Z

Any Key: /* Information for developers */

Monologue

2009-02-26T07:57:39Z

Any Key:

{{ApplicationBox|
Name=[[Monologue]]|
Description= Dictaphone software (record only then speaking)|
Screenshot= |
Homepage=http://lindi.iki.fi/lindi/darcs/monologue/|
TestedOn=|
PackageName=
}}

Download source:http://lindi.iki.fi/lindi/darcs/monologue/

==Introduction==

This programs records audio only when you talk. It's a very early version so don't expect much.

It is useful when you want to dictate notes and use it with different programs. Right now the author is planning to use it with [http://www.openstreetmap.org/ Openstreetmap].

==Libraries==

...

===To Install===
...

[[category:Audio Applications]]

Unison

2008-11-26T07:23:27Z

Any Key:

== Overview ==

[http://www.cis.upenn.edu/~bcpierce/unison Unison] is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.

Unison comes in two flavors:
* Text mode only version (debian package name: unison)
* GTK-based graphical version (debian package name: unison-gtk)

Unison can sync
* between two directory trees on the same computer or
* between directory trees on two separate machines.

For syncing desktop machine and Neo we use the latter. The recommended way to do this is the [http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html#rshmeth remote shell method]:

We start unison or unison-gtk on the desktop PC. The program will connect to the Neo via ssh and start a text-only instance of unison on the Neo to retrieve new files or deltas and to modify files on the Neo.

{{note|The following deals with Unsion on '''Linux'''. It should apply for a [http://wiki.openmoko.org/wiki/Neo1973_and_Windows#USB_Ethernet_emulation network connection from a Windows machine] as well. Check [http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html#ssh-win unison manual] for details!}}

== SSH Setup ==

For this to work, ssh must not output any text itself, because unison parses the first line of console output to determine the version of unison on the remote computer:

* So we should setup ssh for public key authentication as described under [http://wiki.openmoko.org/wiki/USB_Networking#SSH_Keys USB Networking].
* If you are working with more than one distribution to boot from or even with more than one device, I found it convenient to make them all use the same host key (/etc/dropbear/dropbear_rsa_host_key).

== Installation ==

On the Neo we use the text version of unison. Since there's no native opkg file available currently, we take the [http://packages.debian.org/lenny/armel/unison/download debian package]. Extract the file unison-2.27.57, copy it to /usr/bin on neo and create a symlink by the name of unison!

When calling Unison via ssh, the console must only show the unison version information:
<pre>
user@desktoppc:~$ ssh moko unison -version
unison version 2.27.57
</pre>

== Configuration ==

Unison allows for multiple configuration profiles on the desktop PC. My ~/.unison/moko.prf looks like this:
<pre>
# Unison preferences file

label = Syncing Openmoko

# the directories on the desktop and on the neo
root = /home/user/Openmoko/data
root = ssh://root@moko//media/mmc4

# common options
include Common.opt

# Do not compare modification time
times = false

########### Music ##############
path = music

########### GPS Data ###########
path = gps
ignore = Path gps/Maps/*
ignorenot = Path gps/Maps/OSM

</pre>

== Using Unison ==

On first execution of unison on the desktop with the above profile
<pre>
unison-gtk moko
</pre>
unison will ask you to create a new hash archive. Depending on your directory tree, this may take a while. After that you may choose how to proceed with differences.

On the second call unison is actually able to detect changes an will automatically suggest appropriate actions on how to sync the directory trees:

[[Image:UnisonScreenshot1.png|thumb|908px|center|Unison-GTK syncing with the Neo]]

Unison can integrate programs for comparing and merging files during synchronization and offers a great number of other usefull options (see the [http://www.cis.upenn.edu/~bcpierce/unison/download/releases/stable/unison-manual.html manual]).

[[Category:Applications]]

Unison

2008-11-26T07:22:48Z

Any Key:

Translation

2008-08-08T06:07:33Z

Any Key: /* Chinese (Traditional0 */

{{todo|{{PAGENAME}}}}

Let us spread the popularity of Openmoko/Neo1973 by localization of the software and translation of documentation and wiki.

Just as an overview who is able and willing to translate parts into other languages,
please join and add your Language and name. The source for the translation will
be English. If you have good English skills then you could contribute by correcting
the sources :)

A good point to start would be to continuous translating of
http://en.wikipedia.org/wiki/OpenMoko into more languages on the other language sites of wikipedia.

"...it is easy to join and spend some minutes for translating,
and when someone finds some mistakes in any languages don't
blame the translator - just be productive and fix it yourself!" -[[User:RobertMichel|Robert Michel]]

Please take a look at [[Translation HOWTO]] and improve it if possible.

Languages already offered on our community mailinglist, please add your name yourself and join community mailinglist (until we'll have a proper mailinglist) to discuss about translations:

== Afrikaans ==

== Amharic ==
* [[User:ethiopia|Ethiopia Alemayehu]]

== Armenian ==
* [[User:surenk|Suren Karapetyan]]

== Arabic عربي ==
* Hossam Mahmoud حسام محمود
* [[User:ترجمان05|ترجمان05]]
* [[User:Lixy|Lixy]] 17:54, 21 July 2007 (CEST)
* [[User:Waraqa|Waraqa]]

== Bulgarian ==
* [[User:Mr700|Doncho Nicolaev Gunchev]]

== Catalan ==

* [[User:montxovs|Montxo Vicente i Sempere]]

* [[User:Mandarino|Mandarino]]

* [[User:RafaelCarreras|Rafael Carreras]]

* [[User:JaumeI|JaumeI]]

== Chinese (Simplified)==
* [[User:JarodWang|JarodWang]]
* [[User:Liuxf|Liuxf]]
* [[User:sunlt|sunlt]]

== Chinese (Traditional)==
* [[User:coolcat|Brenda Wang]]

== Czech ==
* [[User:Mikesh|Michal Heczko]]
* [[User:Vatoz|Vaclav Cerny]]
* [[User:Fox|Pavel Kovář]] (wiki)

== Danish ==
* [[User:EsbenDamgaard|Esben Damgaard]]
* [[User:UlrikRasmussen|Ulrik Rasmussen]]
* [[User:miki|Mikkel Kirkgaard Nielsen]]

== Dutch ==
* [[User:MarcVerwerft|Marc Verwerft]]
* [[User:Madjo|Marcel De Jong]]
* [[User:LuitvD|Luit van Drongelen]]
* [[User:reinouts|Reinout van Schouwen]]
* [[User:Steamrunner|Koen De Voegt]]

([[User:Madjo|Marcel]] 18/04) Misschien is het handig om alvast te beginnen met vertalen van de Wiki? Of hebben jullie andere ideeen? Ik heb al een start gemaakt van de voorpagina van de wiki, maar ben nog niet veel verder gekomen
([[User:reinouts|Reinout]] 21/04) Valt er verder nog niks te vertalen? De wiki is niet echt boeiend.

== Esperanto ==
* [[User:Antono|Antono Vasiljev]]
* [[User:Alekcxjo|Alekĉjo Rajmondo]]

== Estonian ==
* [[User:Hadara|Sven Petai]]
* [[User:Myoldryn|Jaan Nigul]]
* [[User:Yogiz|Yogiz]]

== Finnish ==

Notes to Finnish translators: please use the dictionary at [http://lokalisointi.org/ lokalisointi.org], avoid anglisms, avoid capital letters where unnecessary etc., kiitos :) Also, send new, big translations to [http://lokalisointi.org/mailman/listinfo/laatu laatu] mailing list for review. Until openmoko specific lists, you may join [http://lokalisointi.org/mailman/listinfo/keskustelu keskustelu] list too (it can be used despite the fact it's been silent).

* [[User:Jani-Matti_Hätinen|Jani-Matti Hätinen]]
* [[User:TimoJyrinki|Timo Jyrinki]]
* [[User:Eyec|Samuli Perttula]]
* [[User:TuomoSipola|Tuomo Sipola]]

== French ==
* [[User:SebastienJolicoeur|Sebastien Jolicoeur]]
* [[User:MarcSert|Marc Sert]]
* [[User:FoucaultdeBonneval|Foucault deBonneval]]
* [[User:Sufflope|Jean-Sébastien Bour]]
* [[User:Ymahe|Yves Mahé]]
* [[User:opampca|Richard Lussier, Canada]]
* [[User:Kheldar|Guillaume Maiano]]
* [[User:Thomas01|Thomas Leclere]]
* [[User:fredlala|Frédéric Lasnier]]
* [[User:alekcxjo|Alexandre Raymond]]
* [[User:VdeGrandpré|Vincent de Grandpré, Montréal, Québec]]

== Galician ==
* [[User:Fjrial|Frco. Javier Rial]]<br>
[http://www.mancomun.org Mancomun]<br>
Para poñerse en contacto enviar un correo-e a rolda http://listas.mancomun.org/mailman/listinfo/g11n

== German ==
* [[User:RobertMichel|Robert Michel]]
* [[User:FabianOff|Fabian Off]]
* [[User:Denis std|Denis]]
* [[User:ktd85|Thomas Drewermann]]
* Lars C.
* [[User:AndreasHochsteger|Andreas Hochsteger]]
* [[User:Christophloew|Christoph Löw]]
* [[User:dFence|Daniel Zauner]]
* [[User:Imitation|Thomas Sanladerer]]
* [[User:Peter Santo|Peter Santo]]
* [[User:Bartholomaus|Marco K.]]

== Greek ==
* [[User:Chronix|Polychronis Papadakis]]

== Hebrew - עברית ==
* [[User:YaronSh|Yaron Shahrabani]]
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:Any_Key|Any_Key]]
* [[User:Koala|Koala]]

== Hungarian ==
* [[User:ZeD|Zoltán Balogh]]

== Indonesian ==
* [[User:Hcblue|Hcblue]]

== Italian ==
* per il momento useremo [http://www.openmokoboard.com/index.php?getforum=10 questo forum] per organizzarci. iscrivetevi e partecipate.
* [[User:SergioTota|Sergio Tota]]
* [[User:Franco|Franco Rimoldi]]
* [[User:Filippo|Filippo]]
* [[User:Massi|Massimiliano]]
* [[User:Markk0|Marco Cattaneo]]
* [[User:Cga|Callea Gaetano Andrea]]
* [[User:Herod2k|Alessandro]]
* [[User:shainer|Lisa Vitolo]]
* [[User:tia1982|Mattia]]
* [[User:azanutta|abe]]
* [[User:Gualti|Gualtiero]]
* [[User:Milo|Milo Casagrande]]
* [[User:White|Marco Celeri]]
* [[User:Aegis|Maurizio Scorianz]]

== Japanese ==
*[[User:WilliamLai|William Lai]]
*[[Momoko Matsuzaki]]

== Norwegian ==
*[[User:Vegar|Vegar Storvann]]
*[[User:Denniz|Denniz Fjerdingby]]
*[[User:StianEllingsen|Stian Ellingsen]]

== Polish ==
* [[User:KrzysztofKajkowski|Krzysztof Kajkowski]]
* Tomasz Zieliński
* [[User:MaciejLigenza|Maciej Ligenza]]
* [[User:PiotrDuda|Piotr Duda]]
* [[User:Zbraniecki|Zbigniew Braniecki]]

== Portuguese ==
*[[User:Skull Death|James Côrtes]]
* Sergio Bessa
* Mario Costa
*[[User:kuyky|Tiago Saraiva]]

== Punjabi ==
* [[User:aalam|A S Alam]]

== Romanian ==

* [[User:alexxed|Alexandru Szasz]]
* [[User:sin|Lucian]]
* [[User:Adrians|Adrians]]

== Russian ==
* [[User:OlegSverdlov|Oleg Sverdlov]]
* [[User:DenisBY|Denis Kot]]
* [[User:MikhailGusarov|Mikhail Gusarov]]
* [[User:x-demon|Alexander Sokolow]]
* [[User:Any_Key|Any_Key]]
* [[User:Dmitri|Dmitri]]
* [[User:Buffet|Denis Kaledin]]
* [[User:Nes|Mike Drapolyuk]]
* [[User:vase|Vasiliy Tolstov]]
* [[User:Shadowjack|Shadowjack]]
* [[User:Cray|Denis Parchenko]]
* [[User:Vlad|Vladimir Orlov]]
* [[User:xnike|Nikolay Khramchenkov]]
* [[User:kainspb|Nikolay Kasatkin]]

Можем начинать переводить wiki :)
К любой странице добавляете /ru и переводите. В конце оригинальной страницы и переведенной добавляете ссылку на шаблон
<nowiki>{{Languages|Имя_страницы_оригинала}}</nowiki>

== Slovak ==
* [[User:Cezz|Cezz]]
* [[User:PipBoy2000|PipBoy2000]]
* [[User:m4rtin.m|m4rtin.m]]

== Spanish ==
* [[User:RosangelaCaninoKoning|Rosangela CaninoKoning]]
* [[User:kresp0|Santiago Crespo (kresp0)]]
* [[User:José_Suárez|José Suárez]]
* [[User:Rafa_Couto|Rafa Couto (caligari)]]
* [[User:NeoMorfeo|Guillermo Santos (NeoMorfeo)]]
* [[User:Mandarino|Mandarino]]
* [[User:pptudela|Pepe Tudela]]
* [[User:avathar|Fernando González (Avathar)]]
* [[User:Rbruzz|Rbruzz]]
* [[User:Saaib|Urivan Flores Saaib (Saaib)]]
* [[User:mutrox|David Samblas Martinez (mutrox)]]

== Swedish ==
* [[User:yeager|Daniel Nylander]]
* [[User:possan|Per-Olov Jernberg]]
* [[User:C.M|Claes Mogren]]

== Turkish ==
* [[User:EnginErenturk|Engin Erenturk]]
* [[User:Supernova|İsmail AŞCI]]

== Welsh ==
* [[User:Rhoslyn_Prys|Rhoslyn Prys]]

And feel free to join and add an new language to this list above.

{{Languages|Translation}}

Download

2008-08-01T10:56:48Z

Any Key: /* FSO */

At this page , we just collect the files that every one can download.

==Neo 1973 Images==

You can always download the latest build of Neo 1973 here.
[http://buildhost.openmoko.org/daily/neo1973/ http://buildhost.openmoko.org/daily/neo1973/]

==Neo FreeRunner==

For the FreeRunner images , you can download the daily build here.
[http://buildhost.openmoko.org/daily/freerunner/ http://buildhost.openmoko.org/daily/freerunner/]

The recommended kernel and root image from the review will always be available [http://downloads.openmoko.org/recommended/ here].

<font color=blue>Note that the recommended set is not always the latest, but is the most stable, reliable, and functional.</font>

==FSO ==
You can download the FSO images here:

Milestone 1 [http://downloads.openmoko.org/framework/milestone1/ http://downloads.openmoko.org/framework/milestone1/]

Milestone 2 [http://downloads.openmoko.org/framework/milestone2/ http://downloads.openmoko.org/framework/milestone2/]

==Tools==
Tools , like dfu-util and openocd:
[http://buildhost.openmoko.org/daily/tools/ http://buildhost.openmoko.org/daily/tools/]

==Neo 1973 Artwork==
Download Neo 1973's artworks here:
[http://people.openmoko.org/sean/specifications/images/ http://people.openmoko.org/sean/specifications/images/]

See more [[Artwork]].
==Neo FreeRunner Artwork==
Download Neo FreeRunner photos in various sizes for print and web use here:
[http://openmoko.com/press-press-material.html http://openmoko.com/press-press-material.html]

[[Category:Openmoko]]

Download

2008-08-01T10:55:28Z

Any Key: /* FSO */

At this page , we just collect the files that every one can download.

==Neo 1973 Images==

You can always download the latest build of Neo 1973 here.
[http://buildhost.openmoko.org/daily/neo1973/ http://buildhost.openmoko.org/daily/neo1973/]

==Neo FreeRunner==

For the FreeRunner images , you can download the daily build here.
[http://buildhost.openmoko.org/daily/freerunner/ http://buildhost.openmoko.org/daily/freerunner/]

The recommended kernel and root image from the review will always be available [http://downloads.openmoko.org/recommended/ here].

<font color=blue>Note that the recommended set is not always the latest, but is the most stable, reliable, and functional.</font>

==FSO ==
You can download the FSO images here:
[http://downloads.openmoko.org/framework/milestone1/ http://downloads.openmoko.org/framework/milestone1/].
[http://downloads.openmoko.org/framework/milestone2/ http://downloads.openmoko.org/framework/milestone2/]

==Tools==
Tools , like dfu-util and openocd:
[http://buildhost.openmoko.org/daily/tools/ http://buildhost.openmoko.org/daily/tools/]

==Neo 1973 Artwork==
Download Neo 1973's artworks here:
[http://people.openmoko.org/sean/specifications/images/ http://people.openmoko.org/sean/specifications/images/]

See more [[Artwork]].
==Neo FreeRunner Artwork==
Download Neo FreeRunner photos in various sizes for print and web use here:
[http://openmoko.com/press-press-material.html http://openmoko.com/press-press-material.html]

[[Category:Openmoko]]

Wishlist/Rotary Dialer

2008-07-31T11:15:52Z

Any Key:

So, this is mainly a joke, but it would be an interesting dispay app for the capabilities of the touchscreen environment and is a departure from the standard 'mouse' behavior of most touchscreens.

[[Image:rotarydial.png]]

pseudo-code:
if(release > init){
value = null; // no backward dialing or dialing past the fingerstop
}elseif((init - release - 1) <= 0){
value = null; // not enough mojo (moko?) in your stroke - try again.
}elseif((init - release - 1) == 10){
value = 0; // necessary substitution
}else{
value = init - release - 1; // allows for old-school dialing, where it didn't
// actually matter where your finger was - it only mattered how much it moved.
}

with these area values:
:black type = display value
:(num) = positional value ''(if different)''

It would be '''really cool''' (tm) if it moved under your finger and snapped back after you released.

Looks like already implemented http://www.cibomahto.com/?p=192

[[Category:Software ideas]]

Supported Hardware

2008-06-20T06:05:15Z

Any Key: Redirecting to Openmoko-supported hardware

#REDIRECT [[Openmoko-supported hardware]]

Shipping Notes/ru

2008-02-07T07:40:35Z

Any Key:

Согласно [[Shipping_Notes#Russian_Federation|примечанию]] на англоязычной странице от 19 апреля 2007 года, поставки в РФ не производятся.

Дословный перевод:
Таможня не пропускает электронные устройства (например, Nokia 770), которые
не имееют сертификации Ростеста.
По этой причине доставка в РФ невозможна. -Liane

В любом случае эту информацию лучше дополнительно уточнить, сделав пробный заказ.

Translation HOWTO/ru

2007-12-04T23:44:00Z

Any Key: emax -> emacs

Основная страница по локализации - это [[Translation]];
помогите улучшить эту страницу

== Поиск материалов для перевода ==
Создатель или майнтейнер (техподдержка) любого пакета прежде всего должен создать файл формата *.pot, включающий все текстовые сообщения.
Найдите эти файлы в дереве исходных текстов программы и можете их переводить.

== Перевод ==
Простой принцип: Любой перевод лучше, чем полное отсутствие перевода. Поэтому не стесняйтесь переводить!

== Программы ==
Существуют специальные утилиты для редактирования файлов *.pot (*.po): gtranslator, po4a, poedit, pootle, potool ...
Подойдут также большинство текстовых редакторов: vim, emacs, ed ...

== Обновление дерева исходных текстов ==
{{todo|descript SVN update after editing}}

== Примечания ==
* Кодировка файлов *.po - UTF-8
* Большая часть пакетов в дереве Openembedded уже интернационализированы, имеет смысл просмотреть их

== Где общаются переводчики и локализаторы ==
Рассылка openmoko-dev, вероятно, отличное место для встречи всех локализаторов, также можно отмечать заголовки писем, например, тэгом [i18n].
: это несколько противоречит сложившейся на данный момент ситуации. '''пожалуйста, пока присоединяйтесь к рассылке сообщества.''' также идут переговоры о создании рассылки для переводчиков [http://wiki.openmoko.org/wiki/Talk:Translation#Need_for_translation_mailing_list_.28and_coordinators.3F.29 тут] [http://lists.openmoko.org/pipermail/community/2007-April/004973.html и тут: OM-i18n-ml] (я только что написал в рассылку сообщества: '''не стесняйтесь участвовать в обеих дискуссиях''' ). [[User:Cga|cga]] sat apr 28th 20:48:35 CEST 2007)

== Список файлов PO, связанных с OpenMoko ==
Программы в /home/moko/sources/svn/ и /home/moko/openmoko/trunk/src/target/OM-2007/applications/ большей частью пока не имеют файлов *.pot, но у некоторых из них есть файлы *.po для определенных языков.
{{Languages|Translation_HOWTO}}

User:Any Key

2007-09-13T07:19:08Z

Any Key:

Saint-Petersburg, wellcome

Openmoko Local Groups: Saint-Petersburg

2007-08-27T12:57:50Z

Any Key:

{|border=1
!Name
!Skills
!Level of Interest
!Location
!Has Device
!Has Debug Board
|-
|[[User:Any_Key|Any_Key]]
|None
|Translating (ru, heb), [http://netsukuku.freaknet.org Netsukuku] port
|Saint-Petersbugr
|
|
|}

[[Category:Community]]