http://openmoko.org/api.php?action=feedcontributions&user=Linuxxr&feedformat=atomOpenmoko - User contributions [en]2024-03-28T14:57:02ZUser contributionsMediaWiki 1.19.24http://openmoko.org/wiki/User_talk:DjdasUser talk:Djdas2011-03-31T02:34:16Z<p>Linuxxr: New page: lets see an installable rootfs image and an installable kernel</p>
<hr />
<div>lets see an installable rootfs image and an installable kernel</div>Linuxxrhttp://openmoko.org/wiki/Deb19Deb192010-12-17T06:46:17Z<p>Linuxxr: /* ToDo */</p>
<hr />
<div>'''deb19''' is ready to use, modified Debian sid, maintained by [[user:adiblol|adiblol]].<br />
[[Image:Deb19 enter pin.png|thumb|deb19 with Zhone running]]<br />
<br />
== Installation ==<br />
# Download filesystem:<br />
#* Experimental, 2010-10-17: http://dl.dropbox.com/u/7926454/openmoko/deb19/deb19_2010-10-17.tar.bz2 - 282MiB, 850MiB unpacked. '''This is really experimental version, don't rely on it''', but in my opinion it is usable. Feel free to test and comment it.<br />
# Install [[Qi]] bootloader in NAND flash.<br />
# Prepare SD card:<br />
#* 1st partition: ext2 for system, at least 1GiB<br />
#* 2nd partition: fat32 for user data such as music. Mounted on /mnt/userfiles. Non-obligatory, if you don't want to have this partition, comment out /dev/mmcblk0p2 in /etc/fstab.<br />
# Untar filesystem archive to first partition.<br />
# Unmount and/or eject SD card, then insert it into your FreeRunner.<br />
# Boot by pressing POWER. Root password is <tt>changeme</tt><br />
<br />
== Changes comparing to original Debian ==<br />
[[Image:Deb19 Sonata.png|thumb|Music playback with mpd - Sonata client]]<br />
* Xorg uses glamo driver instead of fbdev,<br />
* Configured Matchbox windows manager with finger-friendly theme,<br />
* Installed: Woosh, Pidgin, mpd, Sonata, VLC, SMplayer and others,<br />
* More finger-friendly matchbox-keyboard with Polish characters (ąćęłńóżź),<br />
* Touch and hold the screen to simulate right click<br />
<br />
== Known problems ==<br />
* Profile selection in Zhone doesn't work,<br />
* You can't switch to any window from desktop (workaround: select battery from openmoko-panel-plugin and do the switching from window that will appear),<br />
* Matchbox-keyboard layout has no Tab button (You can restore original keyboard layout by removing or renaming <tt>/home/omuser/.matchbox/keyboard.xml</tt>),<br />
* Bottom panel can crash after screen orientation change.<br />
* Mokomaze doesn't work because of permissions problem. (workaround: run as root).<br />
<br />
== In next release... ==<br />
* Installed wicd and Sakura<br />
* Screen rotation buttons (at top panel?)<br />
<br />
== ToDo ==<br />
* Replace Zhone with something better. '''Installing phoneui-apps can destabilize frameworkd, you have been warned!'''<br />
* Better application launcher<br />
* Better keyboard (write something new?)<br />
* Install Paroli please<br />
<br />
[[category:Distributions]]</div>Linuxxrhttp://openmoko.org/wiki/Community_Updates/2010-07-01Community Updates/2010-07-012010-07-08T14:34:29Z<p>Linuxxr: /* Community */</p>
<hr />
<div>====='''Period 2010-06-01 to 2010-06-30'''=====<br />
<br />
==Distributions==<br />
{{DistributionBox|<br />
Name=Debian GNU/Linux |<br />
Description=[[Debian]] (http://wiki.openmoko.org/wiki/Debian) is a universal operating system used on many other embedded devices, and also on home computers. Using Debian on the FreeRunner gives access to the Huge army of software packaged in the Debian repositories, already compiled for the Neo's arm(v4) processor. Moreover, one can build one's own source files for programs without having to learn the OpenEmbedded way. For an existing Debian/Ubuntu user, choosing Debian for Neo FreeRunner makes phone a very familiar, trustworthy and flexible place to hack in.<br><br>The FSO phone stack and SHR user applications have seen a lot of updates. The following packages have been updated to official Debian archives and also made their way to testing repository (which will become Debian 6.0):: libphone-ui 0.1+git20100517.1, libphone-utils 0.1+git20100219-1, libfsotransport 0.9.5.9+git20100507-2, fso-abyss 0.9.0+git20100310-1, libgsm0710mux 0.9.1+git20100322-2, phonefsod 0.1+git20100515-1. The majority of FSO/SHR stack is now in Debian official archives, a major step forward from hosting them only pkg-fso team's own repository. Literki keyboard was also transferred and improved from pkg-fso to official Debian repositories. Jonas Smedegaard drew a nice overview graph of the all the old and new components in the stack: http://wiki.debian.org/Teams/DebianFSO?action=AttachFile&do=view&target=pkgdeps.png <br><br>As a final note, the new FSO2/cornucopia GSM daemon, fso-gsmd 0.5.0+git20100602-1, has just been uploaded to Debian. |<br />
Screenshot=debian-openlogo-480.png|<br />
Codename='sid'|<br />
Homepage=http://wiki.debian.org/DebianOnFreeRunner |<br />
Image=http://wiki.openmoko.org/wiki/Debian |<br />
Works={{Works on Debian}}<br />
}}<br />
<br />
{{DistributionBox|<br />
Name=SHR [unstable]|<br />
Description=SHR is a community driven GNU/Linux distribution for smartphones based on OpenEmbedded using E17 (illume) as window manager and own gui apps on top of FSO.<br />
After hopefully lucky incident we have finally switched to new kernel (based on 2.6.32.13, KMS enabled):<br />
*New images are built with kernel and all needed changes are already included.<br />
*Images doesn't have udevd installed by default (using devtmpfs), which makes it boot about twice as fast as before (less then 1 min to PIN dialog). But it also won't mount your uSD automatically (it was blacklisted before, but removing it from blacklist won't help now).<br />
*Included packages contains latest stuff like xserver-1.9 (RC3), foxtrotgps and tangogps 0.99.4, QT 4.7.0-beta1 and QML enabled navit.<br />
*Distribution revision was changed in OE, this means that every package installed from shr-unstable feeds will be upgraded during next opkg upgrade (so be sure that you have enough time and space in /var partition). Consider flashing new image, it can be faster and safer in the end.<br />
*Used GCC was upgraded from version 4.4.4 to 4.5 (svn revision 160764 from gcc-4.5-branch, because released 4.5.0 has few issues on ARM targets).<br />
*New GCC brings LTO optimizations, which can give us 30% speedup in some cases see [http://sakrah.dontexist.org/node/1 Benchmark results]. LTO is not enabled by default yet.<br />
*New kernel has some issues, so please try first (on another uSD partition), before upgrading your daily-phone-partition.<br />
*The kernel is bigger than 2MB so if you're using u-boot, update your environment according to [http://wiki.openmoko.org/wiki/Kernel#.22Verifying_Checksum_..._Bad_Data_CRC.22_with_U-boot this wiki entry]<br />
*With slower uSD you can see unknown-block-device while booting. Flash newer Qi [http://build.shr-project.org/shr-unstable/images/om-gta02/ from SHR] it is using rootwait instead of rootdelay=1. For u-boot increase rootdelay or use rootwait.<br />
*Sometimes (and only on some devices) it can show all white (looks like old WSoD, but it's without death). Suspend/Resume should fix this.<br />
*[http://build.shr-project.org/shr-unstable.29/ SHR unstable with kernel version 2.6.29] is still available for download <br />
*[http://git.openembedded.org/cgit.cgi/openembedded/log/ Changelog for all libs/apps included in image]<br />
*[http://git.shr-project.org/git/ Changelog for SHR apps]|<br />
Screenshot=SHR-Logo.png|<br />
Codename=unstable|<br />
Homepage=http://www.shr-project.org|<br />
Image=http://build.shr-project.org/shr-unstable/images/|<br />
Works={{Works on SHR}}<br />
}}<br />
<br />
==Applications== <br />
===New Applications===<br />
{{ApplicationBox|<br />
Name=[[DWDWetter]] 0.2.8|<br />
Description=DWDwetter 0.2.8 is an application to get free (only registration), available worldwide Weather information from DWD and view this in a Viewer Window. Possibility for automatically update files delivered on ftp-server of DWD.|<br />
Screenshot=Dwdwetter-Screenshot-2.png|<br />
Homepage=http://www.huber-computer.de/openmoko|<br />
TestedOn=SHR|<br />
PackageName=[http://www.huber-computer.de/openmoko/dwdwetter_0.2.8_all.ipk]<br />
}}<br />
{{ApplicationBox|<br />
Name=FoxtrotGPS 0.99.4|<br />
Description=FoxtrotGPS is a tangoGPS fork adding multiple improvements (see changelog)|<br />
Screenshot=Foxtrotgps.png|<br />
Homepage=http://www.foxtrotgps.org/|<br />
TestedOn=SHR-Unstable(feeds)|<br />
PackageName=[http://www.foxtrotgps.org/releases/foxtrotgps-0.99.4.tar.gz foxtrotgps-0.99.4.tar.gz]<br />
}}<br />
<br />
===Application Updates===<br />
{{ApplicationBox|<br />
Name=MC Navi 0.2.10|<br />
Description=MC Navi is GPS navigation system aimed at portable devices like Neo Freerunner using OpenStreetMap as map source. It uses Enlightenment Foundation Libraries (EFL) for graphic GUI, so it is fast and light. In future it may be ported to other devices. This version needs [http://www.gps-routes.info/index.php?name=Downloads&d_op=viewdownload&cid=3 new map] If you want to use new features. New version of MC Navi should be more stable now and have some improvements:<br />
*added support for orchards<br />
*mcnavi: fixed crash on invalid speed value (routing on cycle route)<br />
*mcnavi: fixed routing of car on cycle routes<br />
*osm2mcmap: added link from way to street name<br />
*mcnavi: draw cycle and tourist ways<br />
*mcnavi: optimized routing for cycle and MTB<br />
*mcnavi: show route distance and time after routing<br />
*mcnavi: fixed computing of route time (only speed of first way used)<br />
*mcnavi: fixed crash when reached destination<br />
*mcnavi: draw the street names|<br />
Screenshot=Mcnavi1.png|<br />
Homepage=http://www.gps-routes.info/index.php?name=Content&pa=showpage&pid=1|<br />
TestedOn=QtMoko, (any Debian based distro)|<br />
PackageName=[http://www.gps-routes.info/index.php?name=Downloads&d_op=viewdownload&cid=2 Packages]<br />
}}<br />
<br />
==Community==<br />
*''Gennady Kupava'' '''[http://lists.openmoko.org/pipermail/community/2010-June/062385.html announced]''' his Neo FreeRunner overclocking experiments with enclosed performance tests. Overclocked u-boot images are [http://www.bsdmn.com/openmoko/uboot500/ here]. Read full announcement before use them. You should use them at your own risk!<br />
*''Christoph Mair'' has '''[http://lists.openmoko.org/pipermail/community/2010-June/062276.html announced]''' that he is developing second version of navigation board for Neo FreeRunner. If you wan to upgrade your smartphone write an email Christoph, if there will be enough interest, a first "production run" will be made. Initial price shoul be 75-80€ but this probably depends on how many devices will be made.<br />
*''Gennady Kupava'' again amazed us with his new series of file system performance tests. Full message is available on community mailing list '''[http://lists.openmoko.org/pipermail/community/2010-June/062355.html archive]'''. The file systems tested were: btrfs,nilfs2,ext2,ext3,ext4,reiserfs,jfs,xfs. Or if you are just curious, you can peek into [http://www.bsdmn.com/openmoko/fstest/fstestresults.html results table].<br />
*Regarding ''Al Johnson'''s [http://lists.openmoko.org/pipermail/community/2010-June/062155.html email], apparently HTC Corporation is trying to patent application for Joerg's Y-cable. Short '''[http://appft.uspto.gov/netacgi/nph-Parser?Sect1=PTO1&Sect2=HITOFF&d=PG01&p=1&u=%2Fnetahtml%2FPTO%2Fsrchnum.html&r=1&f=G&l=50&s1=%2220100077121%22.PGNR.&OS=DN/20100077121&RS=DN/20100077121 abstract]''' shows very similar design. Any legal savvy volunteers to point out mistakes to US Patent & Trademarks office?<br />
*As ''David "leviathan" Lanzendöfer'' '''[http://lists.openmoko.org/pipermail/gta02-core/2010-June/000939.html writes]''' to gta02-core mailing list, new idea was born, to pilot a new Openmoko like platform, based on SAMSUNG-Omnia. The plan is to provide full hardware support by the upstream kernel, and a full SHR-userspace on the shipped phone. The target customers will be business employees, but also private users.<br />
*Recently a lot is happening on ''openmoko-kernel@lists.openmoko.org'', '''[http://lists.openmoko.org/pipermail/openmoko-kernel/2010-June/011024.html initiated]''' by ''Sveinung Kvilhaugsvik'' and mainly caused by ''Thibaut Girka'' who is merging upstreaming a lot of patches for Neo FreeRunner.<br />
*''Aaron Carroll'' and ''Gernot Heiser'' published their study [http://ertos.nicta.com.au/publications/papers/Carroll_Heiser_10.abstract ''An Analysis of Power Consumption in a Smartphone''] in [http://www.usenix.org/events/atc10/tech/techAbstracts.html#Carroll Proceedings of the 2010 USENIX Annual Technical Conference] ([http://ertos.nicta.com.au/publications/papers/Carroll_Heiser_10.pdf '''full paper'''], [http://www.usenix.org/events/atc10/tech/slides/carroll.pdf '''slides''']). The study is measuring and analysing Neo FreeRunner power consumption of main hardware components. They also investigated influence of CPU dynamic voltage and frequency scaling (DVFS) on energy usage. In conclusion, they analysed power consumption and overall battery lifetime on various daily life usage patterns, however without GSM deep sleep mode enabled, which can be fixed by [[1024|recamping rework]].<br />
<br />
==Event News==<br />
* '''[http://lists.openmoko.org/pipermail/community/2010-July/062415.html Open Hard&Software Event in Germany]''' | There are plans for German speaking community workshop/conference/meeting to exchange ideas, knowledge, projects and make friends. [https://www.kwiksurveys.com/online-survey.php?surveyID=KLMDNG_d1f1fd00&UID=3164427512 Online questionnaire] is place where you can send your ideas, wishes and proposals.<br />
<br />
[[Category:Community Update]]</div>Linuxxrhttp://openmoko.org/wiki/Community_Updates/2010-07-01Community Updates/2010-07-012010-07-08T14:33:24Z<p>Linuxxr: /* Community */</p>
<hr />
<div>====='''Period 2010-06-01 to 2010-06-30'''=====<br />
<br />
==Distributions==<br />
{{DistributionBox|<br />
Name=Debian GNU/Linux |<br />
Description=[[Debian]] (http://wiki.openmoko.org/wiki/Debian) is a universal operating system used on many other embedded devices, and also on home computers. Using Debian on the FreeRunner gives access to the Huge army of software packaged in the Debian repositories, already compiled for the Neo's arm(v4) processor. Moreover, one can build one's own source files for programs without having to learn the OpenEmbedded way. For an existing Debian/Ubuntu user, choosing Debian for Neo FreeRunner makes phone a very familiar, trustworthy and flexible place to hack in.<br><br>The FSO phone stack and SHR user applications have seen a lot of updates. The following packages have been updated to official Debian archives and also made their way to testing repository (which will become Debian 6.0):: libphone-ui 0.1+git20100517.1, libphone-utils 0.1+git20100219-1, libfsotransport 0.9.5.9+git20100507-2, fso-abyss 0.9.0+git20100310-1, libgsm0710mux 0.9.1+git20100322-2, phonefsod 0.1+git20100515-1. The majority of FSO/SHR stack is now in Debian official archives, a major step forward from hosting them only pkg-fso team's own repository. Literki keyboard was also transferred and improved from pkg-fso to official Debian repositories. Jonas Smedegaard drew a nice overview graph of the all the old and new components in the stack: http://wiki.debian.org/Teams/DebianFSO?action=AttachFile&do=view&target=pkgdeps.png <br><br>As a final note, the new FSO2/cornucopia GSM daemon, fso-gsmd 0.5.0+git20100602-1, has just been uploaded to Debian. |<br />
Screenshot=debian-openlogo-480.png|<br />
Codename='sid'|<br />
Homepage=http://wiki.debian.org/DebianOnFreeRunner |<br />
Image=http://wiki.openmoko.org/wiki/Debian |<br />
Works={{Works on Debian}}<br />
}}<br />
<br />
{{DistributionBox|<br />
Name=SHR [unstable]|<br />
Description=SHR is a community driven GNU/Linux distribution for smartphones based on OpenEmbedded using E17 (illume) as window manager and own gui apps on top of FSO.<br />
After hopefully lucky incident we have finally switched to new kernel (based on 2.6.32.13, KMS enabled):<br />
*New images are built with kernel and all needed changes are already included.<br />
*Images doesn't have udevd installed by default (using devtmpfs), which makes it boot about twice as fast as before (less then 1 min to PIN dialog). But it also won't mount your uSD automatically (it was blacklisted before, but removing it from blacklist won't help now).<br />
*Included packages contains latest stuff like xserver-1.9 (RC3), foxtrotgps and tangogps 0.99.4, QT 4.7.0-beta1 and QML enabled navit.<br />
*Distribution revision was changed in OE, this means that every package installed from shr-unstable feeds will be upgraded during next opkg upgrade (so be sure that you have enough time and space in /var partition). Consider flashing new image, it can be faster and safer in the end.<br />
*Used GCC was upgraded from version 4.4.4 to 4.5 (svn revision 160764 from gcc-4.5-branch, because released 4.5.0 has few issues on ARM targets).<br />
*New GCC brings LTO optimizations, which can give us 30% speedup in some cases see [http://sakrah.dontexist.org/node/1 Benchmark results]. LTO is not enabled by default yet.<br />
*New kernel has some issues, so please try first (on another uSD partition), before upgrading your daily-phone-partition.<br />
*The kernel is bigger than 2MB so if you're using u-boot, update your environment according to [http://wiki.openmoko.org/wiki/Kernel#.22Verifying_Checksum_..._Bad_Data_CRC.22_with_U-boot this wiki entry]<br />
*With slower uSD you can see unknown-block-device while booting. Flash newer Qi [http://build.shr-project.org/shr-unstable/images/om-gta02/ from SHR] it is using rootwait instead of rootdelay=1. For u-boot increase rootdelay or use rootwait.<br />
*Sometimes (and only on some devices) it can show all white (looks like old WSoD, but it's without death). Suspend/Resume should fix this.<br />
*[http://build.shr-project.org/shr-unstable.29/ SHR unstable with kernel version 2.6.29] is still available for download <br />
*[http://git.openembedded.org/cgit.cgi/openembedded/log/ Changelog for all libs/apps included in image]<br />
*[http://git.shr-project.org/git/ Changelog for SHR apps]|<br />
Screenshot=SHR-Logo.png|<br />
Codename=unstable|<br />
Homepage=http://www.shr-project.org|<br />
Image=http://build.shr-project.org/shr-unstable/images/|<br />
Works={{Works on SHR}}<br />
}}<br />
<br />
==Applications== <br />
===New Applications===<br />
{{ApplicationBox|<br />
Name=[[DWDWetter]] 0.2.8|<br />
Description=DWDwetter 0.2.8 is an application to get free (only registration), available worldwide Weather information from DWD and view this in a Viewer Window. Possibility for automatically update files delivered on ftp-server of DWD.|<br />
Screenshot=Dwdwetter-Screenshot-2.png|<br />
Homepage=http://www.huber-computer.de/openmoko|<br />
TestedOn=SHR|<br />
PackageName=[http://www.huber-computer.de/openmoko/dwdwetter_0.2.8_all.ipk]<br />
}}<br />
{{ApplicationBox|<br />
Name=FoxtrotGPS 0.99.4|<br />
Description=FoxtrotGPS is a tangoGPS fork adding multiple improvements (see changelog)|<br />
Screenshot=Foxtrotgps.png|<br />
Homepage=http://www.foxtrotgps.org/|<br />
TestedOn=SHR-Unstable(feeds)|<br />
PackageName=[http://www.foxtrotgps.org/releases/foxtrotgps-0.99.4.tar.gz foxtrotgps-0.99.4.tar.gz]<br />
}}<br />
<br />
===Application Updates===<br />
{{ApplicationBox|<br />
Name=MC Navi 0.2.10|<br />
Description=MC Navi is GPS navigation system aimed at portable devices like Neo Freerunner using OpenStreetMap as map source. It uses Enlightenment Foundation Libraries (EFL) for graphic GUI, so it is fast and light. In future it may be ported to other devices. This version needs [http://www.gps-routes.info/index.php?name=Downloads&d_op=viewdownload&cid=3 new map] If you want to use new features. New version of MC Navi should be more stable now and have some improvements:<br />
*added support for orchards<br />
*mcnavi: fixed crash on invalid speed value (routing on cycle route)<br />
*mcnavi: fixed routing of car on cycle routes<br />
*osm2mcmap: added link from way to street name<br />
*mcnavi: draw cycle and tourist ways<br />
*mcnavi: optimized routing for cycle and MTB<br />
*mcnavi: show route distance and time after routing<br />
*mcnavi: fixed computing of route time (only speed of first way used)<br />
*mcnavi: fixed crash when reached destination<br />
*mcnavi: draw the street names|<br />
Screenshot=Mcnavi1.png|<br />
Homepage=http://www.gps-routes.info/index.php?name=Content&pa=showpage&pid=1|<br />
TestedOn=QtMoko, (any Debian based distro)|<br />
PackageName=[http://www.gps-routes.info/index.php?name=Downloads&d_op=viewdownload&cid=2 Packages]<br />
}}<br />
<br />
==Community==<br />
*''Gennady Kupava'' '''[http://lists.openmoko.org/pipermail/community/2010-June/062385.html announced]''' his Neo FreeRunner overclocking experiments with enclosed performance tests. Overclocked u-boot images are [http://www.bsdmn.com/openmoko/uboot500/ here]. Read full announcement before use them. You should use them at your own risk!<br />
*''Christoph Mair'' has '''[http://lists.openmoko.org/pipermail/community/2010-June/062276.html announced]''' that he is developing second version of navigation board for Neo FreeRunner. If you wan to upgrade your smartphone write an email Christoph, if there will be enough interest, a first "production run" will be made. Initial price shoul be 75-80€ but this probably depends on how many devices will be made.<br />
*''Gennady Kupava'' again amazed us with his new series of file system performance tests. Full message is available on community mailing list '''[http://lists.openmoko.org/pipermail/community/2010-June/062355.html archive]'''. The file systems tested were: btrfs,nilfs2,ext2,ext3,ext4,reiserfs,jfs,xfs. Or if you are just curious, you can peek into [http://www.bsdmn.com/openmoko/fstest/fstestresults.html results table].<br />
*Regarding ''Al Johnson'''s [http://lists.openmoko.org/pipermail/community/2010-June/062155.html email], apparently HTC Corporation is trying to patent application for Joerg's Y-cable. Short '''[http://appft.uspto.gov/netacgi/nph-Parser?Sect1=PTO1&Sect2=HITOFF&d=PG01&p=1&u=%2Fnetahtml%2FPTO%2Fsrchnum.html&r=1&f=G&l=50&s1=%2220100077121%22.PGNR.&OS=DN/20100077121&RS=DN/20100077121 abstract]''' shows very similar design. Any legal savvy volunteers to point out mistakes to US Patent & Trademarks office?<br />
*As ''David "leviathan" Lanzendöfer'' '''[http://lists.openmoko.org/pipermail/gta02-core/2010-June/000939.html writes]''' to gta02-core mailing list, new idea was born, to pilot a new Openmoko like platform, based on SAMSUNG-Omnia. The plan is to provide full hardware support by the upstream kernel, and a full SHR-userspace on the shipped phone. The target customers will be business employees, but also private users.<br />
*Recently a lot is happening on ''openmoko-kernel@lists.openmoko.org'', '''[http://lists.openmoko.org/pipermail/openmoko-kernel/2010-June/011024.html initiated]''' by ''Sveinung Kvilhaugsvik'' and mainly caused by ''Thibaut Girka'' who is merging upstreaming a lot of patches for Neo FreeRunner.<br />
*''Aaron Carroll'' and ''Gernot Heiser'' published their study [http://ertos.nicta.com.au/publications/papers/Carroll_Heiser_10.abstract ''An Analysis of Power Consumption in a Smartphone''] in [http://www.usenix.org/events/atc10/tech/techAbstracts.html#Carroll Proceedings of the 2010 USENIX Annual Technical Conference] ([http://ertos.nicta.com.au/publications/papers/Carroll_Heiser_10.pdf '''full paper'''], [http://www.usenix.org/events/atc10/tech/slides/carroll.pdf '''slides''']). The study is measuring and analysing Neo FreeRunner power consumption of main hardware components. They also investigated influence of CPU dynamic voltage and frequency scaling (DVFS) on energy usage. In conclusion, they analysed power consumption and overall battery lifetime on various daily life usage patterns, however without GSM deep sleep mode enabled, which can be fixed by [[1024|recamping rework]].<br />
<br />
==Event News==<br />
* '''[http://lists.openmoko.org/pipermail/community/2010-July/062415.html Open Hard&Software Event in Germany]''' | There are plans for German speaking community workshop/conference/meeting to exchange ideas, knowledge, projects and make friends. [https://www.kwiksurveys.com/online-survey.php?surveyID=KLMDNG_d1f1fd00&UID=3164427512 Online questionnaire] is place where you can send your ideas, wishes and proposals.<br />
<br />
[[Category:Community Update]]</div>Linuxxrhttp://openmoko.org/wiki/DebianDebian2010-07-07T05:04:00Z<p>Linuxxr: </p>
<hr />
<div>{{Languages|Debian}}<br />
<br />
Debian is a ''universal operating system'' used on many other embedded devices, and also on home computers. Using Debian on the FreeRunner gives access to the Huge army of software packaged in the Debian repositories, already compiled for the Neo's arm(v4) processor. Moreover, one can build one's own source files for programs without having to learn the OpenEmbedded way. For example compiling natively is a snap with Debian, just apt-get gcc&libc-dev.<br />
<br />
For an existing Debian/Ubuntu user, choosing Debian for Neo FreeRunner makes phone a very familiar, trustworthy and flexible place to hack in.<br />
<br />
'''The bulk of information related to running Debian on FreeRunner is supposed to be at [http://wiki.debian.org/ wiki.debian.org]. For all installation, support or bug reporting needs please see [http://wiki.debian.org/DebianOnFreeRunner DebianOnFreeRunner] in the Debian wiki.'''<br />
<br />
''The current method of installation, install.sh, is not fail-proof. Work is progressing on a real debian-installer support.'' Please be sure Bash is installed before trying install.sh<br />
<br />
== Debian Showcase: Desktop Environments And Applications ==<br />
<br />
=== fbpanel + Matchbox ===<br />
<br />
It is not really a Desktop environment, but using fbpanel with Matchbox you can have a fast, lightweight, gtk2 desktop panel.<br />
[[Image:Debian_fbpanel_zhone.png|right|thumb|300px|Debian with fbpanel, matchbox-window-manager and Zhone running, default settings]]<br />
[[Image:Debian5.png|right|thumb|300px|Custom matchbox theme and fbpanel configuration.]]<br />
<br />
Quick howto:<br />
<ol><li>Install fbpanel:<br />
<pre>sudo apt-get install fbpanel hicolor-icon-theme</pre></li><br />
<li>Customize the X startup process:<br />
<pre>~/.xsession</pre><br />
<pre><br />
#!/bin/sh<br />
export GTK_MODULES=libgtkstylus.so<br />
zhone &<br />
xsetroot -solid black<br />
matchbox-keyboard-toggle &<br />
matchbox-window-manager -use_titlebar yes &<br />
# -use_titlebar yes to minimize & toggle between apps<br />
# fbpanel's taskbar does not work with matchbox-window-manager<br />
#~/bin/auxlaunch &<br />
while true;<br />
do<br />
fbpanel;<br />
sleep 1;<br />
done;<br />
</pre></li><br />
<br />
<li>Read http://fbpanel.sourceforge.net/docs.html#config<br />
<pre>~/.fbpanel/default</pre><br />
<pre><br />
mkdir ~/.fbpanel<br />
cp /etc/fbpanel/default ~/.fbpanel/default<br />
nano ~/.fbpanel/default<br />
</pre><br />
Remove section with 'taskbar' plugin - it's useless with matchbox-window-manager. You may add plugin 'cpu'<br />
<pre>Plugin {<br />
type = cpu<br />
}</pre><br />
Also, plugin 'genmon' is useful:<br />
<pre>Plugin {<br />
type = genmon<br />
config {<br />
Command = echo -e $(grep "MemFree" /proc/meminfo | \<br />
awk '{printf "%0.2f", $2 / 1024}') "|"\<br />
$(cat /proc/loadavg | awk '{print $3}') "|" \<br />
$(apm | awk '{print $5}')<br />
PollingTime = 60<br />
TextSize = small<br />
TextColor = darkblue<br />
}<br />
}</pre><br />
[[Image:Debian6.png|right|thumb|300px|Custom edje Zhone theme.]]<br />
After 'killall fbpanel' it will show: free mem in megabytes | loadavg | battery % left.</li><br />
<li>Default theme is ugly. You can change it and / or make fonts bigger:<br />
<pre>~/.gtkrc-2.0</pre><br />
<pre>sudo apt-cache search gtk2-engines<br />
sudo apt-get install gtk2-engines gtk-theme-switch<br />
DISPLAY=:0 gtk-theme-switch2</pre><br />
Now choose your theme, font and save it. To see changes do 'killall fbpanel'. (killall requires psmisc package to be installed)</li></ol><br />
<br />
=== Illume ===<br />
[[Image:Debian_illume_zhone.png|right|thumb|250px|Debian with illume, and Zhone running]]<br />
[[Image:Debian_illume_zhone_kb.png|right|thumb|250px|Debian with illume, and Zhone running, with the on-screen keyboard visible]]<br />
[[Illume]], the desktop environment used in recent openmoko distribution releases, is also available under Debian. It's part of the Enlightenment window manager version 17 (which is currently in the alpha stage of development), which the Debian FSO package maintainers have placed in their repository. If you have a Debian FSO system running, you can use the following commands to install illume.<br />
<br />
apt-get install e17<br />
<br />
Then use the following commands to ensure that it starts on boot.<br />
<br />
apt-get remove zhone-session<br />
apt-get install nodm<br />
<br />
mv /root/.xsession /root/.xsession.backup <br />
cat << END > /root/.xsession<br />
#!/bin/sh<br />
zhone &<br />
enlightenment_start<br />
END<br />
<br />
<br style="clear:both" /><br />
<br />
=== LXDE ===<br />
<br />
I you want a really nice desktop enviroment but you think XFCE is too fat, you can try to install [http://en.wikipedia.org/wiki/LXDE LXDE]. It give to you the GTK comfort, but use only a fraction of the ram needed by XFCE.<br />
[[Image:Debian_lxde_zhone.png|right|thumb|300px|Debian with lxde and Zhone running]]<br />
To install it:<br />
<pre>apt-get install lxde</pre><br />
<br />
to launch it create a <code>/etc/init.d/lxde</code> script in the same way descripted for xfce4, replacing <code>startxfce4</code> occurrences with <code>startlxde</code>.<br />
<div style="clear:right;">&nbsp;</div><br />
<br />
=== OpenOffice.org ===<br />
[[Image:Freerunner_Debian_runs_openoffice3.jpg|right|thumb|300px|Debian running OpenOffice.org 3]]<br />
<br />
Did we already mention you can install ''anything'' in Debian?<br />
<br />
<br style="clear:both" /><br />
<br />
=== XFCE ===<br />
The debian installation script installs by default the matchbox window manager. It doesn't feature a desktop environment. '''xfce''' is a small and lightweight desktop environment and so is quite fast for the FreeRunner.<br />
<br />
<pre>apt-get install xfce4</pre><br />
<br />
Edit your .xsession to launch xfce4 at X startup :<br />
<br />
<pre>#!/bin/sh<br />
xfce4-session</pre><br />
<br />
Edit section [Failsafe Session] of /etc/xdg/xfce4-session/xfce4-session.rc (or ~/.config/xfce4-session/xfce4-session.rc) to handle the auto-started apps. For example:<br />
<pre>[Failsafe Session]<br />
Count=3<br />
Client0_Command=xfce4-panel<br />
Client0_PerScreen=False<br />
Client1_Command=xfdesktop<br />
Client1_PerScreen=False<br />
Client2_Command=zhone<br />
Client2_PerScreen=True</pre><br />
Start XFCE !<br />
<br />
<pre>/etc/init.d/nodm restart</pre><br />
<br />
The desktop takes a while to start but once up was snappy as can be expected.<br />
I've not yet looked at the reason for the seemingly too slow start for the desktop.<br />
<br />
zhone is available from the "Office" menu in xfce.<br />
The matchbox keyboard is available in "Accessories".<br />
<br />
If you want to display the screen on the long side (ie rotated, 4:3 aspect), add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections :<br />
<br />
<pre>Option "Rotate" "CCW"</pre><br />
<br />
and then (re)start xfce.<br />
<br />
If you want to be able to shutdown/restart the device, add the following line to ''/etc/sudoers'' (don't forget to replace ''username'' with your actual username):<br />
<pre>username localhost = NOPASSWD: /usr/sbin/xfsm-shutdown-helper</pre><br />
<br />
''' Using matchbox-window-manager with XFCE '''<br />
<br />
XFCE's window manager is poorly configured for use with the FreeRunner. Fortunately, matchbox's window manager is compatible with xfce. To use the matchbox window manager, modify ~/.xsession as follows:<br />
<br />
<pre>#!/bin/sh<br />
exec matchbox-window-manager -use_titlebar no -use_cursor no &<br />
xfce4-session</pre><br />
<br />
== Derivative Distributions of Debian ==<br />
<br />
Several distributions are sharing Debian's infrastructure - this is long known. For the Openmoko, <br />
* [[Fyp]] extends the basic Debian installation while avoiding the need of an SD<br />
* [[Hackable1]] focuses on GNOME Mobile integration<br />
* [[Mer]] : based on [[Maemo]] ; see demo and download image at http://www.newlc.com/en/mer-best-maemo-debianubuntu-mobiles-watch-freerunner-demo<br />
* [[QtMoko]] - Debian with Qt Extended Improved plus configuration changes put manually on top of it<br />
* [[Telefoninux]] http://telefoninux.projects.openmoko.org/index.html<br />
<br />
[[Category:Debian| ]]</div>Linuxxrhttp://openmoko.org/wiki/Manuals/SHRManuals/SHR2010-03-29T02:46:01Z<p>Linuxxr: /* FSO Resources */</p>
<hr />
<div>{{Languages|Manuals/SHR}}<br />
{| align="right"<br />
| __TOC__<br />
|}<br />
<br />
==SHR Introduction==<br />
<br />
Welcome to '''[[SHR]]''', a community driven distribution for (not only) Openmoko Neo phones.<br />
<br />
[[Image:SHR-Logo.png|200px|thumb|center|SHR]]<br />
<br />
'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install into your device to use as a daily phone and PDA. There are many prepackaged programs available that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. '''SHR unstable''' is a testing environment before software gets stabilized and it is the main testing ground for [[FSO]] releases. '''SHR testing''' images provide as much stability as possible for day-to-day usage.<br />
<br />
SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.<br />
<br />
==Installation==<br />
<br />
===Getting SHR===<br />
<br />
You need to download two files for your version as above: kernel and root filesystem. Depending whether you will be installing into the internal [[NAND memory]] or on the [[microSD]] card, you need to either get .jffs2 file for NAND or .tar.gz file for microSD.<br />
<br />
- Get the latest kernel from the below linkpages. Starts with uImage-...<br />
<br />
- Get the root filesystem, for NAND: full-om-gta0_.jffs2, for µSD: full-om-gta0_.tar.gz<br />
<br />
The above are '''full''' images. You can also choose images with less packages, marked as '''lite'''.<br />
<br />
;GTA02 Neo FreeRunner<br />
*testing line: http://build.shr-project.org/shr-testing/images/om-gta02/<br />
*unstable line: http://build.shr-project.org/shr-unstable/images/om-gta02/<br />
<br />
;GTA01 Neo 1973<br />
*testing line: http://build.shr-project.org/shr-testing/images/om-gta01/<br />
*unstable line: http://build.shr-project.org/shr-unstable/images/om-gta01/<br />
<br />
;Image lite to image full<br />
If you flashed a '''lite''' image and want to upgrade to the '''full''' image run:<br />
<br />
opkg update<br />
opkg install task-shr-apps task-shr-games task-shr-gtk<br />
<br />
;Kernel modules<br />
The images of the filesystems mentioned above (.jffs2, .tar.gz), already contain the newest kernel modules.<br />
<br />
Get the new kernel modules if you only want to flash a new kernel, but not a whole new file system. From the same page as the kernel download the modules to match your kernel (their dates should be the same). Use sftp to put that file on the FreeRunner via the usb connection. Run gzip to unwrap the modules:<br />
# gzip -dc modules-...tar.gz | tar -xf - -C /<br />
<br />
===Installation on Flash===<br />
<br />
In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.<br />
<br />
Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.<br />
<br />
{{Note|Your battery must be charged (sufficiently) before NAND flashing. Symptom of insufficient charge: Your progress bar "####" stops while flashing. If so, you must charge, and later you should be able to make the complete flash.}}<br />
Commands to flash the filesystem and the kernel:<br />
<br />
Note that there are some issues using dfu-util with sudo.<br />
<br />
'''Don't use sudo with dfu-util. Make sure you are root before using dfu-util!'''<br />
<br />
for the GTA02 Neo FreeRunner:<br />
<br />
# dfu-util -d [[USB Product IDs|0x1d50:0x5119]] -a rootfs -R -D full-om-gta02.jffs2<br />
# dfu-util -d [[USB Product IDs|0x1d50:0x5119]] -a kernel -R -D uImage-om-gta02-latest.bin<br />
<br />
for the GTA01 Neo 1973:<br />
<br />
# dfu-util -d [[USB Product IDs|0x1457:0x5119]] -a rootfs -R -D full-om-gta01.jffs2<br />
# dfu-util -d [[USB Product IDs|0x1457:0x5119]] -a kernel -R -D uImage-om-gta01-latest.bin<br />
<br />
===Installation on the microSD Card===<br />
<br />
Installing SHR on your microSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.<br />
<br />
In simple words, the difference between both systems resides on how you must prepare your microSD Card and files you use to fill them:<br />
<br />
* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 or ext2 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).<br />
<br />
* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .<br />
<br />
Please visit the links below for detailed information and tips:<br />
*For [[Booting from SD | uBoot]] and for [[Qi]].<br />
<br />
===SHR version===<br />
<br />
Should you ever later wonder what version of SHR you have actually installed, please run<br />
<br />
cat /etc/shr-version<br />
<br />
{{Note|Please note that running opkg update;opkg upgrade does not change the SHR version. Only flashing or a new image download can change the SHR version.}}<br />
<br />
==Running SHR==<br />
<br />
===First boot===<br />
[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]<br />
<br />
====Booting====<br />
First boot usually takes a bit longer as your phone's new software needs to do some initial setting up. It is recommended to reboot after this first boot (and after the initial setup), to make sure that all packages get initialized properly.<br />
<br />
====Initial Setup====<br />
<br />
During the first run, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. These steps vary as both Enlightenment desktop and SHR evolve, at this point preferred language and desktop profile options are available. The Profile offers to choose a preconfigured way of displaying the desktop. If unsure, please choose Illume-SHR.<br />
<br />
{| class="wikitable"<br />
| [[Image:SHR-Setup-Language.png|200px|thumb|language selection]]<br />
| [[Image:SHR-Setup-Profile.png|200px|thumb|theme selection]]<br />
|}<br />
<br />
====SHR Wizard====<br />
After the initial Setup, SHR Setting Wizard is launched to allow setting up your local phone settings and setting up root password.<br />
<br />
Screenshot TBD<br />
<br />
===First look===<br />
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]<br />
'''Illume desktop''' is the default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelf or by using the '''<''' left or right '''>''' arrows in the Top Shelf. You can access Task switcher, Illume Settings and more by tapping on the Top Shelve - the shelve will open up by sliding down.<br />
<br />
<br />
====Keyboard====<br />
<br />
Keyboard comes up automagically when a text field is tapped or you can also toggle the keyboard by it's icon or 'alpha' in the Top Shelve. In the Keyboard, dictionary switcher is the arrow-up on left side, alternative keyboard layouts are under the ABC button on the right. The Default keyboard has English dictionary enabled. For Space quick slide left-to-right, for Enter, quick slide up-down, to quick change keyboard layout quick slide down-up. While typing with a dictionary enabled keyboard, possible word options start appearing in the keyboard's upper part or more word options are available under the arrow-up on the left. When happy with the word, tap it, it will be pasted into the text field with a space attached. The Keyboard and dictionary can [[#Illume_keyboard_and_dictionaries | easily be localized]].<br />
<br />
====Copy & Paste====<br />
<br />
In '''E based''' applications (for example the phone suite (messages)) tap and hold down for over two seconds. Select-Paste menu will pop up. By pressing Select, you can now swipe through the text to select desirable part. Tap and hold down again, Copy-Cut-Cancel menu will appear to Copy to clipboard. Another long tap will provide Select-Paste for Paste.<br />
<br />
In '''Gtk''' based application you can use keyboard for Ctrl-C (Copy) and Ctrl-V (Paste).<br />
<br />
In the Vala '''Terminal''' you can select by keyboard swipe and for Paste there is a icon in the menu bar of this application.<br />
<br />
====Alarm====<br />
<br />
The Alarms application (installed by default) allows alarm presetting for single or repeatable alarms. If you set an alarm and turn your Openmoko Freerunner off, at the time of the alarm the phone will be powered up and alarm will sound.<br />
<br />
====Phone applications====<br />
<br />
Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.<br />
<br />
{|<br />
| [[Image:SHR-Dialer.png|200px|thumb|Dialer]]<br />
| [[Image:SHR-Contacts.png|200px|thumb|Contacts]]<br />
| [[Image:SHR-Mesages.png|200px|thumb|Messages]]<br />
| [[Image:SHR-Phonelog.png|200px|thumb|Phone log]]<br />
|}<br />
<br />
====Setting applications====<br />
<br />
[[#SHR_Settings | SHR Settings]] is accessible by tapping Settings icon on the desktop. [[#Illume_settings | Illume settings (and Enlightenment desktop settings)]] are accessible by sliding down the Top shelve and then tapping the "SHR Logo" icon.<br />
<br />
[[Image:SHR-Top-Shelve.png|200px|thumb|Top Shelve with SHR Logo icon for Illume settings and Desktop with Settings icon for SHR Settings]]<br />
<br />
<br />
====Hardware Buttons====<br />
<br />
=====Power Button=====<br />
<br />
The '''PWR''' (Power) button is mapped to start [[#quick_settings | Quick Settings]] screen (Illume System menu in older versions) on a short press. <br />
<br />
Mapping of the PWR button be configured via the '''Illume Settings-> Input -> Key Bindings'''.<br />
<br />
Pressing the Power button for longer then 8 seconds will force a complete power down of the device. This is hardconfigured in the kernel.<br />
<div id="quick_settings"> </div><br />
The '''Quick Settings''' screen provides several toggles: Airplane mode, Phone profiles, Power settings and Power buttons.<br />
<br />
=====Auxiliary Button=====<br />
The '''AUX''' (Auxiliary) button is mapped to toggle on/off the SHR Idle screen. Mapping of this button is configured in /etc/phonefsod.conf<br />
<br />
idle_screen = aux,lock<br />
<br />
You can configure the [[#idle_screen | Idle Screen]] to come up even during active phone call by adding '''phone''' to the setting: <br />
<br />
idle_screen = aux,lock, phone<br />
<br />
<div id="idle_screen"> </div><br />
The '''Idle Screen''' shows current date and time, missed calls and messaged and also what [[#FSO_Resources | FSO resources]] are currently being requested - used.<br />
<br />
======Replacing idle screen======<br />
<br />
If you with to use the previous simple LOCKED screen instead of the new standard Idle Screen<br />
<br />
Edit '''/etc/phonefsod.conf''' to this:<br />
<br />
# when to show idle screen<br />
# ...<br />
# idle_screen = aux,lock<br />
idle_screen =<br />
<br />
You need to restart phonefsod to make the change happen.<br />
<br />
Also, change key mapping for the AUX button by setting '''Illume Settings''' -> '''Input''' -> '''Key Bindings''', bind the key '''XF86Phone''' to '''Desktop Simple Lock'''<br />
<br />
===First steps===<br />
<br />
Right after installation and first boot you might want to do a few initial steps like adjusting the call volume and some other tasks.<br />
<br />
====Audio - Call Volume====<br />
<br />
During the first phone call please use the Volume and Mic sliders on the Active Call Screen and adjust them to fit your preferences. When you have found good settings, terminate the test call and reboot the phone. The new improved settings will then be used for all in- and outgoing calls thereafter.<br />
<br />
====Network Connection====<br />
''Establish network connection'' and SSH into your phone. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]<br />
<br />
====Initializing the opkg database====<br />
''Initialize the opkg database'' in order to install some applications from SHR repositories or from other sources, for example [http://opkg.org opkg.org]. While being online, you need to run<br />
<br />
opkg update<br />
<br />
Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through. Do this only once or after every opkg update:<br />
<br />
opkg list > packages.txt<br />
<br />
Then you can search quickly for package name, for example for navit:<br />
<br />
grep navit packages.txt<br />
<br />
====SwapSpace====<br />
<br />
When the RAM is used up, applications get killed. This is particularly bad while doing opkg upgrade. Therefore you might want to create a swap space. Read [[SwapSpace]] article.<br />
<br />
==Settings==<br />
===SHR Settings===<br />
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]<br />
<br />
SHR Settings is the main setting application of SHR. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).<br />
<br />
Please refer to [[#FSO_Resources | this section]] about a better way to manage preventing screen dim or suspend.<br />
<br />
While some settings are persistent over reboots, others are not.<br />
<br />
====Main Screen====<br />
The main screen is divided into eight categories, which contain several modules. Every SHR Settings module has a specified task - for example controlling the GSM antenna power, setting the time etc.<br />
<br />
====Phone====<br />
Here you can set if the GSM antenna is on and if your phone number is shown when you call someone.<br />
<br />
'''GSM'''<br />
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.<br />
<br />
To list available providers, click on Operators button. Scanning can take some time. After a while, a list of operators should pop up.<br />
<br />
You can't connect to operators marked [forbidden].<br />
<br />
Selecting an operator from the list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.<br />
<br />
'''Call'''<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]<br />
<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]<br />
<br />
|}<br />
<br />
You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")<br />
<br />
'''Phoneutils'''<br />
<br />
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to set the right country code for your location. (for example 420 for Czech republic) for more info, please go to: http://wiki.openmoko.org/wiki/Phone_Prefixes<br />
<br />
'''SIM'''<br />
<br />
Here you can view some informations about your SIM card and clean phone and messagebooks.<br />
<br />
====Profiles====<br />
<br />
Here you can select the current profile, which the device should use to determine ring tone etc.<br />
<br />
'''Current profile'''<br />
<br />
Here you can adjust properties of the currently used profile. <br />
<br />
To change the ring tone, click the "Change" button.<br />
<br />
To use your own ring tone, place it in /usr/share/sounds directory.<br />
<br />
After selecting a sid tune as the ring tone, there are available controls to select tune number from the file.<br />
<br />
If you like to test a .sid you can play it using this command on the FR:<br />
<br />
gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink<br />
<br />
Note that it's a ! used and not a | to construct the gstreamer pipe command.<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]<br />
<br />
|}<br />
<br />
====Connectivity====<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]<br />
|}<br />
<br />
'''WiFi'''<br />
<br />
With the "WiFi radio" toggle you can set, if the wifi module is powered. WiFi radio has to be turned on before trying to connect to a WiFi network, unless you try to connect through [[Mokonnect]] which is capable of powering it up.<br />
<br />
'''GPRS'''<br />
<br />
To enter APN, login and password fields, just click on the actual value (default: "internet"). Your phone provider can provide the required configuration options.<br />
<br />
{{Note|You can also use Mokonnect to manage your GPRS connection}}<br />
<br />
'''USB'''<br />
<br />
With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.<br />
<br />
'''Bluetooth'''<br />
<br />
To power up Bluetooth module, switch the "Bluetooth radio" toggle to "On". After that, the "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.<br />
<br />
====Power====<br />
<br />
'''Battery'''<br />
<br />
This module displays informations about battery state - charge, voltage, remaining time etc. To update the data, click the "Update" button.<br />
<br />
Here you can also force enable 500mA charging.<br />
<br />
'''Display'''<br />
<br />
With this slider you can easily set the backlight brightness.<br />
<br />
{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 80%.}}<br />
<br />
'''Power'''<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Power.png |200px|thumb|Power]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]<br />
|}<br />
<br />
Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)<br />
<br />
'''Timeouts'''<br />
<br />
Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. <br />
<br />
{{Note|Configuration behavior has been changed due to FSO rewrite.}}<br />
<br />
'''Old behavior''' (delete by Apr 1st):<br />
<br />
Here (Timeouts screen of SHR Settings) you can set up values of idle timeouts used by the device. This setting changes parameters in '''/etc/frameworkd.conf''' :<br />
<br />
[fsodevice.kernel_idle]<br />
suspend = 20<br />
lock = 2<br />
idle_prelock = 12<br />
idle = 10<br />
idle_dim = 20<br />
<br />
'''New behavior:'''<br />
<br />
Storing of this setting via D-bus calls is not supported in the new API of Vala rewrite of FSO2. SHR Settings doesn't have a setting for this. Configurable values are now stored in '''/etc/freesmartphone/conf/GTA02/fsodeviced.conf''' but you can keep your own config file in your home directory:<br />
<br />
~/.fsodeviced.conf<br />
<br />
====Appearance====<br />
<br />
'''Theming'''<br />
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]<br />
<br />
The Apperance section allows you to change between installed themes. To install more themes, see also [[#Installing themes | Installing themes]].<br />
<br />
You can change finger size - this will mainly effect vertical spacing between widgets.<br />
<br />
Switching between engines:<br />
<br />
E can be switched to use different engines. The default engine is x11. Alternative engine x11-16 is not supported and results in buggy behavior of several applications, for example the phone suite or Ventura browser.<br />
<br />
Changing Splash screen is also possible in this module. To install more splash screens, see also [[#Installing splash screen themes|Installing splash themes]].<br />
<br />
====Position====<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]<br />
|}<br />
<br />
'''GPS'''<br />
<br />
By default, GPS is turned on only when requested by an application. That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.<br />
<br />
'''GPS information'''<br />
<br />
This page can be used to monitor GPS status. You either have to turn GPS on manually or start another application to enable the GPS.<br />
<br />
You can also view information about every visible satellite and check, which are used for getting a fix. To do that, click "Satellite details".<br />
<br />
'''Remove AGPS data'''<br />
If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.<br />
Assisted GPS ([[aGPS]]) support GPS receiver to find position by non-satellite information.<br />
<br />
====Date/time====<br />
<br />
[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]<br />
<br />
'''Time'''<br />
<br />
Here you can view and set the time. By default, the time is just displayed, To adjust it, click on "Set time".<br />
<br />
After finishing adjusting, click the "OK" button.<br />
<br />
'''Date'''<br />
<br />
This module displays the current date.<br />
<br />
====Others====<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
[[Image:SHR-Settings-Others.png |200px|thumb|Others]]<br />
<br />
'''PIM'''<br />
<br />
Pim data are stored in opimd domains. Every opimd domain has different backends to store its data to. The domain reads data from every backend and writes data to the default backend. This elector allows you to choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.<br />
<br />
'''Services'''<br />
<br />
The services selector is listing scripts from /etc/init.d/ directory.<br />
<br />
After clicking on a servis, you can either start, restart or stop the service and view the result.<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]<br />
|}<br />
<br />
<br />
'''Userspace backups'''<br />
<br />
Here you can either archive or restore your files and configurations.<br />
<br />
=== Illume settings ===<br />
<br />
The Illume desktop can be easily customized - slide the top shelf down and tap the Settings icon (SHR Logo).<br />
<br />
'''Illume settings''' (SHR Logo icon) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to view more options on the right hand side.<br />
<br />
The little applets in the top shelf (for example Battery, GSM, Bluetooth etc.) are called '''shelf gadgets''' and you can configure whether they are visible (on the front part of the top shelf) or hidden (you can access them by sliding the top shelf) through Illume Settings -> Display -> Shelf gadget.<br />
<br />
Some setting screens are not resized properly to fit the phone's display - for example the Wallpapper setting. This is a known bug already reported upstream.<br />
<br />
<!-- [[Image:SHR-Top-Shelve.png|200px|thumb|Top Shelf]] --><br />
<br />
<br />
==Localization==<br />
<br />
=== Localize SHR manually ===<br />
<br />
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]<br />
<br />
====Desktop environment====<br />
<br />
You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in the Illume top shelf go to Settings (SHR Logo) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.<br />
<br />
You can list all available languages by running:<br />
<br />
opkg list | grep eglibc-locale-<br />
<br />
And install the language of your choice (for example czech):<br />
<br />
opkg install eglibc-locale-cs<br />
<br />
After this, the Language Settings of Illume will offer Czech. <br />
<br />
This will localize the Illume environment and will also set correct lang environment variable of your desktop. <br />
<br />
====Applications====<br />
<br />
If you wish to have other applications localized, you need to install translation for each of them (presuming it is available):<br />
<br />
This will install czech localization for SHR phone applications, SHR Settings and TangoGps:<br />
<br />
opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs<br />
<br />
====Terminal environment====<br />
<br />
For localized terminal environment (ssh login) set lang variables in /etc/profile, example for Czech language:<br />
<br />
export LANG=cs_CZ<br />
export LC_ALL=cs_CZ<br />
<br />
====Illume keyboard and dictionaries====<br />
<br />
The Illume keyboard offers English dictionary correction by default. You can list all the dictionaries available for installation:<br />
<br />
opkg list | grep illume-dic<br />
<br />
If your language is not available and the English one is bothering you, you can set an empty dictionary:<br />
<br />
echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic<br />
<br />
By using it, it will get filled by the words you use and after time will start helping and correcting your typing.<br />
<br />
[[Image:Illume-keyboards-terminal-dutch-nl-screenshot.png| Dutch terminal virtual keyboard|256px|thumb]]<br />
Furthermore you can install a different keyboard with a layout which fits your language or alternatives for the default keyboards like the numerical one. The localized [[Illume keyboard]]s are available in the SHR repository under the name ''illume-keyboard-LANG''.<br />
<br />
Note that sometimes after an upgrade of Illume has taken place, these keyboards have to be installed again before they become available again. Removing these packages will restore the availability of the respective original keyboards.<br />
<br />
==== German (and Austria) Language ====<br />
<br />
See [[Configure_SHR_for_German-speaking_use]] for detailed customization for german speaking.<br />
<br />
===Date and time===<br />
<br />
The local timezone is automatically retrieved from the GSM network.<br />
<br />
create a symlink named /etc/localtime which points to the appropriate file in /usr/share/zoneinfo. For example, if you're in France., the following command will link the correct zoneinfo file to your /etc/localtime, giving you the correct time:<br />
<br />
ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime<br />
<br />
Afterwards, edit /etc/timezone if necessary [?]<br />
<br />
Local timezone work instantly for the current boot when:<br />
<br />
TZ="Europe/Paris"<br />
export TZ<br />
<br />
For a permanent timezone change edit /etc/profile and change to:<br />
<br />
TZ="Europe/Paris"<br />
<br />
Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.<br />
<br />
Time can set time also manually.<br />
<br />
Via SHR-Settings -> Date/time -> Set time<br />
<br />
From linux based desktop:<br />
<br />
ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"<br />
<br />
You can also set the hardware clock to the system time:<br />
<br />
hwclock --systohc<br />
<br />
Is this better?:<br />
<br />
hwclock --utc --systohc<br />
<br />
It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :<br />
<br />
[otimed]<br />
# a list of time/zone sources to use or NONE<br />
timesources = GPS,NTP<br />
zonesources = GSM<br />
# use an ip address here, otherwise DNS resolution will block<br />
ntpserver = 134.169.172.1<br />
<br />
To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf<br />
<br />
==FSO Resources==<br />
<br />
[[FSO]] is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better than running dbus commands)<br />
<br />
opkg install fsoraw<br />
<br />
Example of usage fsoraw:<br />
<br />
fsoraw -r Display mokomaze<br />
<br />
See [[FSO Resources]] for more details on using the following resources:<br />
<br />
'''Wifi'''<br />
<br />
Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the [[Mokonnect]] network manager to set up networks, it will power Wifi up automatically when needed.<br />
<br />
'''Bluetooth'''<br />
<br />
You need to have this resource requested to have bluetooth module powered.<br />
<br />
'''GPS'''<br />
<br />
The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off<br />
<br />
'''GSM'''<br />
<br />
You need to have this resource requested to have GSM module powered.<br />
<br />
'''Display'''<br />
<br />
While this resource is requested the display won't be blanked and suspend is disabled.<br />
<br />
'''CPU'''<br />
<br />
While this resource is requested then suspend is disabled. Display will blank as normal.<br />
<br />
'''Test'''<br />
<br />
A test resource.<br />
<br />
'''UsbHost'''<br />
<br />
While this resource is requested the USB is turned into powered USB Host mode.<br />
<br />
'''Accelerometer'''<br />
<br />
You need to have this resource requested to have the Accelerometer module powered.<br />
<br />
==Network manager==<br />
<br />
While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.<br />
<br />
Enhanced configuration is possible through direct editing of /etc/network/interfaces or through [[Mokonnect]].<br />
<br />
The <tt>connmand</tt> daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. The Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable it after use.<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |<br />
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " | <br />
<br />
[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " | <br />
<br />
[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]<br />
<br />
<br />
|}<br />
<br />
==Bluetooth==<br />
<br />
Bluetooth can be used for several different applications - file transfer (OBEX), networking, input devices (HIDD), music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better than for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if the bluetooth headset is not around, making it quite difficult to use.<br />
<br />
In the SHR repositories are applications ready to be installed (by opkg) that already do provide bluetooth support. This means that they request the bluetooth resource automatically, can search bluetooth devices around, help you with pairing and can perhaps even reconnect bluetooth headset upon resume from suspend. From applications that have some bluetooth support some are for example [[Launcher]] (home screen launcher and phone suite), [[Podboy]] (podcast player), [[Elmtooth]] (bluetooth manager). In order to set up bluetooth for phone calls, some manual setup from [[#GSM_phone_calls_with_bluetooth_headset | bellow]] is still required.<br />
<br />
===Bluez3 - the manual non D-Bus way===<br />
<br />
If you want to use the bluetooth device directly, you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On. You can also make the bluetooth device visible here.<br />
<br />
====OBEX file transfer====<br />
<br />
There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:<br />
<br />
opkg install obexpush<br />
<br />
Default receiving path (editable in /etc/default/opd_args ) does not exist, so create it<br />
<br />
mkdir /var/obexpush<br />
<br />
Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush<br />
<br />
To send some files, first scan for devices:<br />
<br />
hcitool scan<br />
Scanning ...<br />
00:16:41:F5:A5:BC laptop<br />
<br />
Then send the file onto bluetooth address found in the scan:<br />
<br />
obextool push image.jpg 00:16:41:F5:A5:BC 10<br />
<br />
====Connect Bluetooth keyboard====<br />
<br />
hidd --search<br />
<br />
Editors note: This is the old bluez3 way, but it works. New bluez4 way will replace this.<br />
<br />
===Bluez4 - D-Bus based way===<br />
<br />
SHR uses bluez4 which is completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for a list of supported devices.<br />
<br />
====Pairing====<br />
<br />
[[Emtooth]] is a bluetooth manager. It provides setting up bluetooth device name, pairing/unpairing, visibility setting and more. Install Emtooth:<br />
<br />
opkg install emtooth<br />
<br />
It will discover nearby devices, double tapping on found device will initiate pairing process.<br />
<br />
====GSM with bluetooth headset====<br />
<br />
In order to use bluetooth headset for phone calls, several simple steps need to be done.<br />
<br />
1). Your bluetooth headset device must be [[#Pairing | paired]] first.<br />
<br />
2). [[#Configuring_FSO | Add]] your bluetooth headset into FSO configuration.<br />
<br />
<br />
Please note: phonecalls are now always routed to the bluetooth headset. <br />
After startup and after every resume, the headset needs to be [[#Re-Connecting_the_bluetooth_headset |reconnected]].<br />
<br />
=====Configuring FSO=====<br />
<br />
Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in<br />
<br />
/etc/freesmartphone/opreferences/conf/phone/default.yaml<br />
<br />
Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).<br />
<br />
You need to restart FSO for the changes to take effect.<br />
<br />
# /etc/init.d/frameworkd restart<br />
<br />
example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:<br />
<br />
message-length: 7<br />
message-tone: notify_message.wav<br />
message-vibration: 1<br />
message-volume: 10<br />
ring-loop: 1<br />
ring-tone: ringtone_ringnroll.wav<br />
ring-vibration: 1<br />
ring-volume: 10<br />
bt-headset-enabled: 1<br />
bt-headset-address: 00:09:DD:31:92:98<br />
<br />
=====Re-Connecting the headset=====<br />
<br />
You might need to get the bluetooth headset connected manually on the beginning and also after suspend:<br />
<br />
mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect<br />
<br />
where xx_xx_xx_xx_xx_xx is address of the device, for example:<br />
<br />
mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect<br />
<br />
Hopefully, your bluetooth headset now works. Good luck!<br />
<br />
==System Customizing==<br />
<br />
===Installing splash screen themes===<br />
<br />
List available splash screen themes<br />
<br />
opkg list | grep splash-theme<br />
<br />
Install one of the available themes<br />
<br />
opkg install shr-splash-theme-dontpanic<br />
<br />
Then go to '''SHR Settings -> Appearance -> Splash settings'''. Here you can preview installed themes and change the default one.<br />
<br />
===Installing themes===<br />
<br />
Every theme is made of several components (a theme for illume, theme for the phone applications, theme for etk and so on). There is a SHR metapackage for each theme that allows installing the complete theme in one go.<br />
<br />
List available SHR theme metapackages:<br />
<br />
opkg list | grep shr-theme<br />
<br />
Install one of the available themes<br />
<br />
opkg install shr-theme-gry<br />
<br />
Then go to '''SHR Settings -> Appearance -> Elementary Settings'''. Here you can preview installed themes and choose the preferred one.<br />
<br />
The Illume screen requires to change theme via '''Settings (SHR Logo) -> Look -> Theme'''. Here you can preview installed themes and choose the preferred one.<br />
<br />
===Enable mouse cursor=== <br />
<br />
edit line 143 of /etc/X11/Xserver and erase '''-nocursor'''<br />
<br />
ARGS="$ARGS"<br />
<br />
<br />
<br />
===Random errors===<br />
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.<br />
<br />
For reboot into nand and fix 1st partition of ext2 on your card<br />
<br />
fsck.ext2 /dev/mmcblk0p1<br />
<br />
===GSM modem 1024 suspend bug===<br />
<br />
The calypso GSM modem suffers a known [[1024]] hardware bug that causes unreliable GSM function. To work it around, SHR by default doesn't suspend the modem completely. If you have undertaken a fix for this bug you can extend your battery time by enabling the modem to fully suspend when possible.<br />
<br />
Edit the following in /etc/frameworkd.conf file:<br />
<br />
ti_calypso_deep_sleep = always<br />
<br />
Then restart framework or reboot the phone.<br />
<br />
==Reporting bugs==<br />
<br />
SHR is a work in progress. If you experience issues, please report them back to SHR. With your report provide relevant logs from<br />
<br />
/var/log/<br />
<br />
To report a bug, please go to http://shr-project.org/trac/report<br />
<br />
Check if the bug is already reported. If not, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on. If bug already exists, see if you can help fixing it by providing some fresh info.<br />
<br />
==More information==<br />
<br />
For SHR home page, source code and other resources, visit:<br />
<br />
* [http://trac.shr-project.org SHR Project Homepage]<br />
* [http://blog.shr-project.org SHR Blog]<br />
* [http://trac.shr-project.org Trac Bugtracker]<br />
* [http://git.shr-project.org Git Sourcecode-repository]<br />
* [http://build.shr-project.org Downloads on buildhost]<br />
* [http://lists.shr-project.org SHR User and Development Mailing Lists]<br />
<br />
<br />
<br />
[[Category:SHR]]<br />
[[Category:Manuals]]</div>Linuxxrhttp://openmoko.org/wiki/Manuals/SHRManuals/SHR2010-03-05T05:03:11Z<p>Linuxxr: /* Appearance */</p>
<hr />
<div>{{Languages|Manuals/SHR}}<br />
{| align="right"<br />
| __TOC__<br />
|}<br />
<br />
==SHR Introduction==<br />
<br />
Welcome to '''[[SHR]]''', a community driven distribution for (not only) Openmoko Neo phones.<br />
<br />
[[Image:SHR-Logo.png|200px|thumb|center|SHR]]<br />
<br />
'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install into your device to use as a daily phone and PDA. There are many prepackaged programs available that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. '''SHR unstable''' is a testing environment before software gets stabilized and it is the main testing ground for [[FSO]] releases. '''SHR testing''' images provide as much stability as possible for day-to-day usage.<br />
<br />
SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.<br />
<br />
==Installation==<br />
<br />
===Getting SHR===<br />
<br />
You need to download two files for your version as above: kernel and root filesystem. Depending whether you will be installing into the internal [[NAND memory]] or on the [[microSD]] card, you need to either get .jffs2 file for NAND or .tar.gz file for microSD.<br />
<br />
For the '''GTA02 Neo FreeRunner''' you need to download the images of the:<br />
*testing line: http://build.shr-project.org/shr-testing/images/om-gta02/<br />
*unstable line: http://build.shr-project.org/shr-unstable/images/om-gta02/<br />
<br />
- Get the latest kernel from the above linkpage. Starts with uImage-...<br />
<br />
- Get the root filesystem, for NAND: full-om-gta02.jffs2, for µSD: full-om-gta02.tar.gz<br />
<br />
The above are '''full''' images. You can also choose images with less packages, marked as '''lite''' which can be upgraded to the full image by running<br />
<br />
opkg update<br />
opkg install task-shr-apps task-shr-games task-shr-gtk<br />
<br />
- '''Get the kernel modules.''' From the same page, download the modules to match your kernel (their dates should be the same). Put that file on the FreeRunner and run<br />
<br />
# gzip -dc modules-...tar.gz | tar -xf - -C /<br />
<br />
'''Editors note''': Running depmod should not be necessary, if it's needed, please report a bug. Recommending of the depmod command will be removed in near future.<br />
<br />
'''GTA01 Neo 1973''' images are at:<br />
*unstable line: http://build.shr-project.org/shr-testing/images/om-gta01/<br />
*testing line: http://build.shr-project.org/shr-unstable/images/om-gta01/ (20100304 future)<br />
<br />
===Installation on Flash===<br />
<br />
In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.<br />
<br />
Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.<br />
<br />
{{Note|Your battery must be charged (sufficiently) before NAND flashing. Symptom of insufficient charge: Your progress bar "####" stops while flashing. If so, you must charge, and later you should be able to make the complete flash.}}<br />
Commands to flash the filesystem and the kernel:<br />
<br />
Note that there are some issues using dfu-util with sudo.<br />
<br />
'''Don't use sudo with dfu-util. Make sure you are root before using dfu-util!'''<br />
<br />
for the GTA02 Neo FreeRunner:<br />
<br />
# dfu-util -d [[USB Product IDs|0x1d50:0x5119]] -a rootfs -R -D full-om-gta02.jffs2<br />
# dfu-util -d [[USB Product IDs|0x1d50:0x5119]] -a kernel -R -D uImage-om-gta02-latest.bin<br />
<br />
for the GTA01 Neo 1973:<br />
<br />
# dfu-util -d [[USB Product IDs|0x1457:0x5119]] -a rootfs -R -D full-om-gta01.jffs2<br />
# dfu-util -d [[USB Product IDs|0x1457:0x5119]] -a kernel -R -D uImage-om-gta01-latest.bin<br />
<br />
===Installation on the microSD Card===<br />
<br />
Installing SHR on your microSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.<br />
<br />
In simple words, the difference between both systems resides on how you must prepare your microSD Card and files you use to fill them:<br />
<br />
* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 or ext2 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).<br />
<br />
* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .<br />
<br />
Please visit the links below for detailed information and tips:<br />
*For [[Booting from SD | uBoot]] and for [[Qi]].<br />
<br />
===SHR version===<br />
<br />
Should you ever later wonder what version of SHR you have actually installed, please run<br />
<br />
cat /etc/shr-version<br />
<br />
{{Note|Please note that running opkg update;opkg upgrade does not change the SHR version. Only flashing or a new image download can change the SHR version.}}<br />
<br />
<br />
==Running SHR==<br />
<br />
===First boot===<br />
[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]<br />
<br />
====Booting====<br />
First boot usually takes a bit longer as your phone's new software needs to do some initial setting up. It is recommended to reboot after this first boot (and after the initial setup), to make sure that all packages get initialized properly.<br />
<br />
====Initial Setup====<br />
<br />
During the first run, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. These steps vary as both Enlightenment desktop and SHR evolve, at this point preferred language and desktop profile options are available. The Profile offers to choose a preconfigured way of displaying the desktop. If unsure, please choose Illume-SHR.<br />
<br />
{| class="wikitable"<br />
| [[Image:SHR-Setup-Language.png|200px|thumb|language selection]]<br />
| [[Image:SHR-Setup-Profile.png|200px|thumb|theme selection]]<br />
|}<br />
<br />
====SHR Wizard====<br />
After the initial Setup, SHR Setting Wizard is launched to allow setting up your local phone settings and setting up root password.<br />
<br />
Screenshot TBD<br />
<br />
===First look===<br />
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]<br />
'''Illume desktop''' is the default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelf or by using the '''<''' left or right '''>''' arrows in the Top Shelf. You can access Task switcher, Illume Settings and more by tapping on the Top Shelve - the shelve will open up by sliding down.<br />
<br />
<br />
====Keyboard====<br />
<br />
Keyboard comes up automagically when a text field is tapped or you can also toggle the keyboard by it's icon in the Top Shelve. In the Keyboard, dictionary switcher is the arrow-up on left side, alternative keyboard layouts are under the ABC button on the right. The Default keyboard has English dictionary enabled. For Space quick slide left-to-right, for Enter, quick slide up-down, to quick change keyboard layout quick slide down-up. While typing with a dictionary enabled keyboard, possible word options start appearing in the keyboard's upper part or more word options are available under the arrow-up on the left. When happy with the word, tap it, it will be pasted into the text field with a space attached. The Keyboard and dictionary can [[#Illume_keyboard_and_dictionaries | easily be localized]].<br />
<br />
====Copy & Paste====<br />
<br />
In '''E based''' applications (for example the phone suite (messages)) tap and hold down for over two seconds. Select-Paste menu will pop up. By pressing Select, you can now swipe through the text to select desirable part. Tap and hold down again, Copy-Cut-Cancel menu will appear to Copy to clipboard. Another long tap will provide Select-Paste for Paste.<br />
<br />
In '''Gtk''' based application you can use keyboard for Ctrl-C (Copy) and Ctrl-V (Paste).<br />
<br />
In the Vala '''Terminal''' you can select by keyboard swipe and for Paste there is a icon in the menu bar of this application.<br />
<br />
====Alarm====<br />
<br />
The Alarms application (installed by default) allows alarm presetting for single or repeatable alarms. If you set an alarm and turn your Openmoko Freerunner off, at the time of the alarm the phone will be powered up and alarm will sound.<br />
<br />
====Phone applications====<br />
<br />
Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.<br />
<br />
{|<br />
| [[Image:SHR-Dialer.png|200px|thumb|Dialer]]<br />
| [[Image:SHR-Contacts.png|200px|thumb|Contacts]]<br />
| [[Image:SHR-Mesages.png|200px|thumb|Messages]]<br />
| [[Image:SHR-Phonelog.png|200px|thumb|Phone log]]<br />
|}<br />
<br />
====Setting applications====<br />
<br />
[[#SHR_Settings | SHR Settings]] is accessible by tapping Settings icon on the desktop. [[#Illume_settings | Illume settings (and Enlightenment desktop settings)]] are accessible by sliding down the Top shelve and then tapping the "SHR Logo" icon.<br />
<br />
[[Image:SHR-Top-Shelve.png|200px|thumb|Top Shelve with SHR Logo icon for Illume settings and Desktop with Settings icon for SHR Settings]]<br />
<br />
<br />
====Hardware Buttons====<br />
<br />
=====Power Button=====<br />
<br />
The '''PWR''' (Power) button is mapped to start [[#quick_settings | Quick Settings]] screen (Illume System menu in older versions) on a short press. <br />
<br />
Mapping of the PWR button be configured via the '''Illume Settings-> Input -> Key Bindings'''.<br />
<br />
Pressing the Power button for longer then 8 seconds will force a complete power down of the device. This is hardconfigured in the kernel.<br />
<div id="quick_settings"> </div><br />
The '''Quick Settings''' screen provides several toggles: Airplane mode, Phone profiles, Power settings and Power buttons.<br />
<br />
=====Auxiliary Button=====<br />
The '''AUX''' (Auxiliary) button is mapped to toggle on/off the SHR Idle screen. Mapping of this button is configured in /etc/phonefsod.conf<br />
<br />
idle_screen = aux,lock<br />
<br />
You can configure the [[#idle_screen | Idle Screen]] to come up even during active phone call by adding '''phone''' to the setting: <br />
<br />
idle_screen = aux,lock, phone<br />
<br />
<div id="idle_screen"> </div><br />
The '''Idle Screen''' shows current date and time, missed calls and messaged and also what [[#FSO_Resources | FSO resources]] are currently being requested - used.<br />
<br />
======Replacing idle screen======<br />
<br />
If you with to use the previous simple LOCKED screen instead of the new standard Idle Screen<br />
<br />
Edit '''/etc/phonefsod.conf''' to this:<br />
<br />
# when to show idle screen<br />
# ...<br />
# idle_screen = aux,lock<br />
idle_screen =<br />
<br />
You need to restart phonefsod to make the change happen.<br />
<br />
Also, change key mapping for the AUX button by setting '''Illume Settings''' -> '''Input''' -> '''Key Bindings''', bind the key '''XF86Phone''' to '''Desktop Simple Lock'''<br />
<br />
===First steps===<br />
<br />
Right after installation and first boot you might want to do a few initial steps like adjusting the call volume and some other tasks.<br />
<br />
====Audio - Call Volume====<br />
<br />
During the first phone call please use the Volume and Mic sliders on the Active Call Screen and adjust them to fit your preferences. When you have found good settings, terminate the test call and reboot the phone. The new improved settings will then be used for all in- and outgoing calls thereafter.<br />
<br />
====Network Connection====<br />
''Establish network connection'' and SSH into your phone. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]<br />
<br />
====Initializing the opkg database====<br />
''Initialize the opkg database'' in order to install some applications from SHR repositories or from other sources, for example [http://opkg.org opkg.org]. While being online, you need to run<br />
<br />
opkg update<br />
<br />
Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through. Do this only once or after every opkg update:<br />
<br />
opkg list > packages.txt<br />
<br />
Then you can search quickly for package name, for example for navit:<br />
<br />
grep navit packages.txt<br />
<br />
====SwapSpace====<br />
<br />
When the RAM is used up, applications get killed. This is particularly bad while doing opkg upgrade. Therefore you might want to create a swap space. Read [[SwapSpace]] article.<br />
<br />
==Settings==<br />
===SHR Settings===<br />
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]<br />
<br />
SHR Settings is the main setting application of SHR. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).<br />
<br />
Please refer to [[#FSO_Resources | this section]] about a better way to manage preventing screen dim or suspend.<br />
<br />
While some settings are persistent over reboots, others are not.<br />
<br />
====Main Screen====<br />
The main screen is divided into eight categories, which contain several modules. Every SHR Settings module has a specified task - for example controlling the GSM antenna power, setting the time etc.<br />
<br />
====Phone====<br />
Here you can set if the GSM antenna is on and if your phone number is shown when you call someone.<br />
<br />
'''GSM'''<br />
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.<br />
<br />
To list available providers, click on Operators button. Scanning can take some time. After a while, a list of operators should pop up.<br />
<br />
You can't connect to operators marked [forbidden].<br />
<br />
Selecting an operator from the list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.<br />
<br />
'''Call'''<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]<br />
<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]<br />
<br />
|}<br />
<br />
You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")<br />
<br />
'''Phoneutils'''<br />
<br />
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to set the right country code for your location. (for example 420 for Czech republic) for more info, please go to: http://wiki.openmoko.org/wiki/Phone_Prefixes<br />
<br />
'''SIM'''<br />
<br />
Here you can view some informations about your SIM card and clean phone and messagebooks.<br />
<br />
====Profiles====<br />
<br />
Here you can select the current profile, which the device should use to determine ring tone etc.<br />
<br />
'''Current profile'''<br />
<br />
Here you can adjust properties of the currently used profile. <br />
<br />
To change the ring tone, click the "Change" button.<br />
<br />
To use your own ring tone, place it in /usr/share/sounds directory.<br />
<br />
After selecting a sid tune as the ring tone, there are available controls to select tune number from the file.<br />
<br />
If you like to test a .sid you can play it using this command on the FR:<br />
<br />
gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink<br />
<br />
Note that it's a ! used and not a | to construct the gstreamer pipe command.<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]<br />
<br />
|}<br />
<br />
====Connectivity====<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]<br />
|}<br />
<br />
'''WiFi'''<br />
<br />
With the "WiFi radio" toggle you can set, if the wifi module is powered. WiFi radio has to be turned on before trying to connect to a WiFi network, unless you try to connect through [[Mokonnect]] which is capable of powering it up.<br />
<br />
'''GPRS'''<br />
<br />
To enter APN, login and password fields, just click on the actual value (default: "internet"). Your phone provider can provide the required configuration options.<br />
<br />
{{Note|You can also use Mokonnect to manage your GPRS connection}}<br />
<br />
'''USB'''<br />
<br />
With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.<br />
<br />
'''Bluetooth'''<br />
<br />
To power up Bluetooth module, switch the "Bluetooth radio" toggle to "On". After that, the "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.<br />
<br />
====Power====<br />
<br />
'''Battery'''<br />
<br />
This module displays informations about battery state - charge, voltage, remaining time etc. To update the data, click the "Update" button.<br />
<br />
Here you can also force enable 500mA charging.<br />
<br />
'''Display'''<br />
<br />
With this slider you can easily set the backlight brightness.<br />
<br />
{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 80%.}}<br />
<br />
'''Power'''<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Power.png |200px|thumb|Power]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]<br />
|}<br />
<br />
Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)<br />
<br />
'''Timeouts'''<br />
<br />
Here you can set up values of idle timeouts used by the device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :<br />
<br />
[fsodevice.kernel_idle]<br />
suspend = 20<br />
lock = 2<br />
idle_prelock = 12<br />
idle = 10<br />
idle_dim = 20<br />
<br />
====Appearance====<br />
<br />
'''Theming'''<br />
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]<br />
<br />
The Apperance section allows you to change between installed themes. To install more themes, see also [[#Installing themes | Installing themes]].<br />
<br />
You can change finger size - this will mainly effect vertical spacing between widgets.<br />
<br />
Switching between engines:<br />
<br />
E can be switched to use different engines. The default engine is x11. Alternative engine x11-16 is not supported and results in buggy behavior of several applications, for example the phone suite or Ventura browser.<br />
<br />
Changing Splash screen is also possible in this module. To install more splash screens, see also [[#Installing splash themes|Installing splash themes]].<br />
<br />
====Position====<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]<br />
|}<br />
<br />
'''GPS'''<br />
<br />
By default, GPS is turned on only when requested by an application. That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.<br />
<br />
'''GPS information'''<br />
<br />
This page can be used to monitor GPS status. You either have to turn GPS on manually or start another application to enable the GPS.<br />
<br />
You can also view information about every visible satellite and check, which are used for getting a fix. To do that, click "Satellite details".<br />
<br />
'''Remove AGPS data'''<br />
If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.<br />
Assisted GPS ([[aGPS]]) support GPS receiver to find position by non-satellite information.<br />
<br />
====Date/time====<br />
<br />
[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]<br />
<br />
'''Time'''<br />
<br />
Here you can view and set the time. By default, the time is just displayed, To adjust it, click on "Set time".<br />
<br />
After finishing adjusting, click the "OK" button.<br />
<br />
'''Date'''<br />
<br />
This module displays the current date.<br />
<br />
====Others====<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
[[Image:SHR-Settings-Others.png |200px|thumb|Others]]<br />
<br />
'''PIM'''<br />
<br />
Pim data are stored in opimd domains. Every opimd domain has different backends to store its data to. The domain reads data from every backend and writes data to the default backend. This elector allows you to choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.<br />
<br />
'''Services'''<br />
<br />
The services selector is listing scripts from /etc/init.d/ directory.<br />
<br />
After clicking on a servis, you can either start, restart or stop the service and view the result.<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |<br />
<br />
[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " | <br />
<br />
[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]<br />
|}<br />
<br />
<br />
'''Userspace backups'''<br />
<br />
Here you can either archive or restore your files and configurations.<br />
<br />
=== Illume settings ===<br />
<br />
The Illume desktop can be easily customized - slide the top shelf down and tap the Settings icon (SHR Logo).<br />
<br />
'''Illume settings''' (SHR Logo icon) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to view more options on the right hand side.<br />
<br />
The little applets in the top shelf (for example Battery, GSM, Bluetooth etc.) are called '''shelf gadgets''' and you can configure whether they are visible (on the front part of the top shelf) or hidden (you can access them by sliding the top shelf) through Illume Settings -> Display -> Shelf gadget.<br />
<br />
Some setting screens are not resized properly to fit the phone's display - for example the Wallpapper setting. This is a known bug already reported upstream.<br />
<br />
<!-- [[Image:SHR-Top-Shelve.png|200px|thumb|Top Shelf]] --><br />
<br />
<br />
==Localization==<br />
<br />
=== Localize SHR manually ===<br />
<br />
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]<br />
<br />
====Desktop environment====<br />
<br />
You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in the Illume top shelf go to Settings (SHR Logo) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.<br />
<br />
You can list all available languages by running:<br />
<br />
opkg list | grep eglibc-locale-<br />
<br />
And install the language of your choice (for example czech):<br />
<br />
opkg install eglibc-locale-cs<br />
<br />
After this, the Language Settings of Illume will offer Czech. <br />
<br />
This will localize the Illume environment and will also set correct lang environment variable of your desktop. <br />
<br />
====Applications====<br />
<br />
If you wish to have other applications localized, you need to install translation for each of them (presuming it is available):<br />
<br />
This will install czech localization for SHR phone applications, SHR Settings and TangoGps:<br />
<br />
opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs<br />
<br />
====Terminal environment====<br />
<br />
For localized terminal environment (ssh login) set lang variables in /etc/profile, example for Czech language:<br />
<br />
export LANG=cs_CZ<br />
export LC_ALL=cs_CZ<br />
<br />
====Illume keyboard and dictionaries====<br />
<br />
The Illume keyboard offers English dictionary correction by default. You can list all the dictionaries available for installation:<br />
<br />
opkg list | grep illume-dic<br />
<br />
If your language is not available and the English one is bothering you, you can set an empty dictionary:<br />
<br />
echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic<br />
<br />
By using it, it will get filled by the words you use and after time will start helping and correcting your typing.<br />
<br />
[[Image:Illume-keyboards-terminal-dutch-nl-screenshot.png| Dutch terminal virtual keyboard|256px|thumb]]<br />
Furthermore you can install a different keyboard with a layout which fits your language or alternatives for the default keyboards like the numerical one. The localized [[Illume keyboard]]s are available in the SHR repository under the name ''illume-keyboard-LANG''.<br />
<br />
Note that sometimes after an upgrade of Illume has taken place, these keyboards have to be installed again before they become available again. Removing these packages will restore the availability of the respective original keyboards.<br />
<br />
==== German (and Austria) Language ====<br />
<br />
See [[Configure_SHR_for_German-speaking_use]] for detailed customization for german speaking.<br />
<br />
===Date and time===<br />
<br />
The local timezone is automatically retrieved from the GSM network.<br />
<br />
create a symlink named /etc/localtime which points to the appropriate file in /usr/share/zoneinfo. For example, if you're in France., the following command will link the correct zoneinfo file to your /etc/localtime, giving you the correct time:<br />
<br />
ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime<br />
<br />
Afterwards, edit /etc/timezone if necessary [?]<br />
<br />
Local timezone work instantly for the current boot when:<br />
<br />
TZ="Europe/Paris"<br />
export TZ<br />
<br />
For a permanent timezone change edit /etc/profile and change to:<br />
<br />
TZ="Europe/Paris"<br />
<br />
Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.<br />
<br />
Time can set time also manually.<br />
<br />
Via SHR-Settings -> Date/time -> Set time<br />
<br />
From linux based desktop:<br />
<br />
ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"<br />
<br />
You can also set the hardware clock to the system time:<br />
<br />
hwclock --systohc<br />
<br />
Is this better?:<br />
<br />
hwclock --utc --systohc<br />
<br />
It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :<br />
<br />
[otimed]<br />
# a list of time/zone sources to use or NONE<br />
timesources = GPS,NTP<br />
zonesources = GSM<br />
# use an ip address here, otherwise DNS resolution will block<br />
ntpserver = 134.169.172.1<br />
<br />
To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf<br />
<br />
==FSO Resources==<br />
<br />
[[FSO]] is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)<br />
<br />
opkg install fsoraw<br />
<br />
Example of usage fsoraw:<br />
<br />
fsoraw -r Display mokomaze<br />
<br />
See [[FSO Resources]] for more details on using the following resources:<br />
<br />
'''Wifi'''<br />
<br />
Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the [[Mokonnect]] network manager to set up networks, it will power Wifi up automatically when needed.<br />
<br />
'''Bluetooth'''<br />
<br />
You need to have this resource requested to have bluetooth module powered.<br />
<br />
'''GPS'''<br />
<br />
The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off<br />
<br />
'''GSM'''<br />
<br />
You need to have this resource requested to have GSM module powered.<br />
<br />
'''Display'''<br />
<br />
While this resource is requested the display won't be blanked and suspend is disabled.<br />
<br />
'''CPU'''<br />
<br />
While this resource is requested then suspend is disabled. Display will blank as normal.<br />
<br />
'''Test'''<br />
<br />
A test resource.<br />
<br />
'''UsbHost'''<br />
<br />
While this resource is requested the USB is turned into powered USB Host mode.<br />
<br />
'''Accelerometer'''<br />
<br />
You need to have this resource requested to have the Accelerometer module powered.<br />
<br />
==Network manager==<br />
<br />
While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.<br />
<br />
Enhanced configuration is possible through direct editing of /etc/network/interfaces or through [[Mokonnect]].<br />
<br />
The <tt>connmand</tt> daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. The Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable it after use.<br />
<br />
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |<br />
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " | <br />
<br />
[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]<br />
<br />
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " | <br />
<br />
[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]<br />
<br />
<br />
|}<br />
<br />
==Bluetooth==<br />
<br />
Bluetooth can be used for several different applications - file transfer (OBEX), networking, input devices (HIDD), music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better than for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if the bluetooth headset is not around, making it quite difficult to use.<br />
<br />
In the SHR repositories are applications ready to be installed (by opkg) that already do provide bluetooth support. This means that they request the bluetooth resource automatically, can search bluetooth devices around, help you with pairing and can perhaps even reconnect bluetooth headset upon resume from suspend. From applications that have some bluetooth support some are for example [[Launcher]] (home screen launcher and phone suite), [[Podboy]] (podcast player), [[Elmtooth]] (bluetooth manager). In order to set up bluetooth for phone calls, some manual setup from [[#GSM_phone_calls_with_bluetooth_headset | bellow]] is still required.<br />
<br />
===Bluez3 - the manual non D-Bus way===<br />
<br />
If you want to use the bluetooth device directly, you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On. You can also make the bluetooth device visible here.<br />
<br />
====OBEX file transfer====<br />
<br />
There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:<br />
<br />
opkg install obexpush<br />
<br />
Default receiving path (editable in /etc/default/opd_args ) does not exist, so create it<br />
<br />
mkdir /var/obexpush<br />
<br />
Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush<br />
<br />
To send some files, first scan for devices:<br />
<br />
hcitool scan<br />
Scanning ...<br />
00:16:41:F5:A5:BC laptop<br />
<br />
Then send the file onto bluetooth address found in the scan:<br />
<br />
obextool push image.jpg 00:16:41:F5:A5:BC 10<br />
<br />
====Connect Bluetooth keyboard====<br />
<br />
hidd --search<br />
<br />
Editors note: This is the old bluez3 way, but it works. New bluez4 way will replace this.<br />
<br />
===Bluez4 - D-Bus based way===<br />
<br />
SHR uses bluez4 which is completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for a list of supported devices.<br />
<br />
====Pairing====<br />
<br />
[[Emtooth]] is a bluetooth manager. It provides setting up bluetooth device name, pairing/unpairing, visibility setting and more. Install Emtooth:<br />
<br />
opkg install emtooth<br />
<br />
It will discover nearby devices, double tapping on found device will initiate pairing process.<br />
<br />
====GSM with bluetooth headset====<br />
<br />
In order to use bluetooth headset for phone calls, several simple steps need to be done.<br />
<br />
1). Your bluetooth headset device must be [[#Pairing | paired]] first.<br />
<br />
2). [[#Configuring_FSO | Add]] your bluetooth headset into FSO configuration.<br />
<br />
<br />
Please note: phonecalls are now always routed to the bluetooth headset. <br />
After startup and after every resume, the headset needs to be [[#Re-Connecting_the_bluetooth_headset |reconnected]].<br />
<br />
=====Configuring FSO=====<br />
<br />
Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in<br />
<br />
/etc/freesmartphone/opreferences/conf/phone/default.yaml<br />
<br />
Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).<br />
<br />
You need to restart FSO for the changes to take effect.<br />
<br />
# /etc/init.d/frameworkd restart<br />
<br />
example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:<br />
<br />
message-length: 7<br />
message-tone: notify_message.wav<br />
message-vibration: 1<br />
message-volume: 10<br />
ring-loop: 1<br />
ring-tone: ringtone_ringnroll.wav<br />
ring-vibration: 1<br />
ring-volume: 10<br />
bt-headset-enabled: 1<br />
bt-headset-address: 00:09:DD:31:92:98<br />
<br />
=====Re-Connecting the headset=====<br />
<br />
You might need to get the bluetooth headset connected manually on the beginning and also after suspend:<br />
<br />
mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect<br />
<br />
where xx_xx_xx_xx_xx_xx is address of the device, for example:<br />
<br />
mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect<br />
<br />
Hopefully, your bluetooth headset now works. Good luck!<br />
<br />
==System Customizing==<br />
<br />
===Installing splash screen themes===<br />
<br />
List available splash screen themes<br />
<br />
opkg list | grep splash-theme<br />
<br />
Install one of the available themes<br />
<br />
opkg install shr-splash-theme-dontpanic<br />
<br />
Then go to '''SHR Settings -> Appearance -> Splash settings'''. Here you can preview installed themes and change the default one.<br />
<br />
===Installing themes===<br />
<br />
Every theme is made of several components (a theme for illume, theme for the phone applications, theme for etk and so on). There is a SHR metapackage for each theme that allows installing the complete theme in one go.<br />
<br />
List available SHR theme metapackages:<br />
<br />
opkg list | grep shr-theme<br />
<br />
Install one of the available themes<br />
<br />
opkg install shr-theme-gry<br />
<br />
Then go to '''SHR Settings -> Appearance -> Elementary Settings'''. Here you can preview installed themes and choose the preferred one.<br />
<br />
The Illume screen requires to change theme via '''Settings (SHR Logo) -> Look -> Theme'''. Here you can preview installed themes and choose the preferred one.<br />
<br />
===Enable mouse cursor=== <br />
<br />
edit line 143 of /etc/X11/Xserver and erase '''-nocursor'''<br />
<br />
ARGS="$ARGS"<br />
<br />
<br />
<br />
===Random errors===<br />
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.<br />
<br />
For reboot into nand and fix 1st partition of ext2 on your card<br />
<br />
fsck.ext2 /dev/mmcblk0p1<br />
<br />
===GSM modem 1024 suspend bug===<br />
<br />
The calypso GSM modem suffers a known [[1024]] hardware bug that causes unreliable GSM function. To work it around, SHR by default doesn't suspend the modem completely. If you have undertaken a fix for this bug you can extend your battery time by enabling the modem to fully suspend when possible.<br />
<br />
Edit the following in /etc/frameworkd.conf file:<br />
<br />
ti_calypso_deep_sleep = always<br />
<br />
Then restart framework or reboot the phone.<br />
<br />
==Reporting bugs==<br />
<br />
SHR is a work in progress. If you experience issues, please report them back to SHR. With your report provide relevant logs from<br />
<br />
/var/log/<br />
<br />
To report a bug, please go to http://shr-project.org/trac/report<br />
<br />
Check if the bug is already reported. If not, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on. If bug already exists, see if you can help fixing it by providing some fresh info.<br />
<br />
==More information==<br />
<br />
For SHR home page, source code and other resources, visit:<br />
<br />
* [http://trac.shr-project.org SHR Project Homepage]<br />
* [http://blog.shr-project.org SHR Blog]<br />
* [http://trac.shr-project.org Trac Bugtracker]<br />
* [http://git.shr-project.org Git Sourcecode-repository]<br />
* [http://build.shr-project.org Downloads on buildhost]<br />
* [http://lists.shr-project.org SHR User and Development Mailing Lists]<br />
<br />
<br />
<br />
[[Category:SHR]]<br />
[[Category:Manuals]]</div>Linuxxrhttp://openmoko.org/wiki/Community_Updates/2010-01-14Community Updates/2010-01-142010-01-15T22:06:11Z<p>Linuxxr: /* Introduction */</p>
<hr />
<div>====='''Period 2010-01-01 to 2010-01-14'''=====<br />
<br />
==Introduction==<br />
Since begin of year 2010 a lot has happened, both in application and distribution ground. But not everyone remembers, that all this progress would not be possible without '''middleware''' software layer. Following this thought we would like to remind FreeRunner's community about, often underestimated, [http://www.ohloh.net/p/fso FSO] framework. Michael 'Mickey' Lauer, FSO's Framework lead [http://lists.openmoko.org/pipermail/community/2010-January/058826.html stated], that 2009 was a turbulent year for FSO's team and thanked to all contributors and users of FSO APIs.<br />
<br />
Concerning general problem of "invisibility", which affects all middleware, together with Sebastian Spaeth [http://lists.shr-project.org/pipermail/shr-devel/2010-January/001785.html post] and [http://lists.openmoko.org/pipermail/community/2010-January/059288.html this one], which states that currently only one guy ('Mickey') is working, unpaid, on FSO development, we would like to call Community for help. '''Both, developers men-power and financial contributions are needed''' to keep up great progress of FSO Framework. Keep in mind, that this progress will affect all distributions and applications which use FSO Framework. Thus, if you have few spare coins on your PayPal account, and willing to donate to FSO project: [mailto:coreteam@freesmartphone.org coreteam@freesmartphone.org] , or particular FSO [http://www.ohloh.net/p/fso/contributors contributors], go for it!<br />
<br />
==Applications== <br />
<br />
===New Applications===<br />
{{ApplicationBox|<br />
Name=Elm-Browser 1.0_r0.4|<br />
Description=This is an initial release of a very fast, finger friendly webkit-efl / elementary based browser.<br />
* finger scrolling<br />
* double-click to zoom in<br />
* triple click to zoom out (not working as of now - help needed)<br />
* layout optimised for max viewing space|<br />
Screenshot=Browser-c_c.png|<br />
Homepage=http://elm-browser.googlecode.com|<br />
TestedOn=SHR-Unstable|<br />
PackageName=[http://elm-browser.googlecode.com/files/browser_1.0-r0.4_armv4t.ipk browser_1.0-r0.4_armv4t.ipk]<br />
}}<br />
{{ApplicationBox|<br />
Name=rtmom 0.1| <br />
Description=rtmom is a Python client for [http://www.rememberthemilk.com/ RememberTheMilk]. It is based on Elementary.<br />
* Currently, rtmom is more or less read-only:<br />
** you can download and display your tasks and <br />
** you may mark a task as complete<br />
** no editing or creating of tasks yet implemented<br />
* Check [http://wiki.github.com/kichkasch/rtmom/end-user wiki] for installation and usage.|<br />
Screenshot=Rtmom.png|<br />
Homepage=http://freshmeat.net/projects/rtmom|<br />
TestedOn=SHR-Testing|<br />
PackageName=[http://cloud.github.com/downloads/kichkasch/rtmom/rtmom_0.1_armv4t.ipk rtmom]<br />
}}<br />
{{ApplicationBox|<br />
Name=[[Openmokontrol]] 0.1|<br />
Description=Openmokontrol is a CLI-controlled application for the Freerunner to send input events to a remote X11 server caused by accelerometer events, well usable for games.|<br />
Screenshot=System_boot.png|<br />
Homepage=http://wiki.openmoko.org/wiki/openmokontrol|<br />
TestedOn=SHR-Unstable,Hackable:1|<br />
PackageName=[http://www.opkg.org/packages/0_openmokontrol_0.1_arm.ipk Openmokontrol], [http://build.hackable1.org/debian/dists/wip/main/binary-armel/openmokontrol_0.1-1_armel.deb Debian package]<br />
}}<br />
{{ApplicationBox|<br />
Name=[[QCurrency]] 0.1|<br />
Description=Christian Rüb developed QCurrency. It is a simple currency calculator, with save exchange rate capability.|<br />
Screenshot=Qcurrency.png|<br />
Homepage=http://git.senfdax.de/?p=qcurrency;a=summary|<br />
TestedOn=SHR|<br />
PackageName=[http://openmoko.senfdax.de/shr-new-unstable/qcurrency_0.1-r1.4_armv4t.ipk qcurrency]<br />
}}<br />
{{ApplicationBox|<br />
Name=MKPRN 0.3|<br />
Description=MKPRN is a [http://en.wikipedia.org/wiki/RPN_calculator Reverse Polish Notation] calculator. Currently it is in early stage of development. Suggestions and feature requests are welcome.|<br />
Screenshot=MKPRN_v0.2.png|<br />
Homepage=http://glitch.tl/mkrpn.html|<br />
TestedOn=?|<br />
PackageName=http://opkg.glitch.tl/mkrpn_0.2_arm.ipk mkprn]<br />
}}<br />
{{ApplicationBox|<br />
Name=qspectemu|<br />
Description=Radek Polak have just finished porting of Miklos Szeredi's [http://www.inf.bme.hu/~mszeredi/spectemu/ spectemu] - A Sinclair ZX Spectrum emulator for Linux/UNIX, to Qt on Freerunner. It's now in QtMoko package feed if you want to try it or you can compile from sources for your favourite distro. The main work was port to Qt, possibility to use touchscreen and creating GUI for loading/saving snapshots and creating mouse/touchscreen bindings. For QtMoko you will need [http://activationrecord.net/radekp/qtmoko/download/experimental/uImage-v17.bin v17] kernel to get decent speed. Emulator can now do following:<br />
*download my favourite games from internet<br />
*load/save snapshot<br />
*define custom on screen locations for spectrum keys<br />
*rotate, qvga<br />
*vibrate to notice if pressed border location of two keys<br />
*use virtual keyboard for input (longer press requited for some games)<br />
*autocorrect on screen key location during game playing|<br />
Screenshot=System_boot.png|<br />
Homepage=http://activationrecord.net/radekp/qspectemu/|<br />
TestedOn=QtMoko|<br />
PackageName=QSpectemu binares are included in [http://activationrecord.net/radekp/qtmoko/ QtMoko] default package feed, sources are in [http://github.com/radekp/spectemu GIT] repository.<br />
}}<br />
<br />
===Application Updates===<br />
{{ApplicationBox|<br />
Name=SpojeGUI|<br />
Description=SpojeGUI is GUI program which use CLI program/modul [http://code.google.com/p/spoje/ spoje.py] which is used mainly for Czech and Slovak transport.<br />
* Save confing and link to DB. |<br />
Screenshot=spojeguiV4.png|<br />
Homepage=http://www.multi.mluv.cz/programovani/spojegui.html|<br />
TestedOn=SHR-Testing|<br />
PackageName=[http://data.multi.mluv.cz/spoje_0.4.0_all.ipk SpojeGUI]<br />
}}<br />
{{ApplicationBox|<br />
Name=[[Podboy]] 1.2.0|<br />
Description=Podboy is a podcast aggregator/player written in Python/Elementary. Its interface aims to be easy and finger friendly. It uses Feedparser Python module for download/parsing of podcast feeds, Gstreamer for playing of episodes and SQLite for storing data. Changes since version 1.0.0:<br />
* New feature: possibility to show details of episodes before to play them via a new entry "Show Details" in the menu "Actions" of pages "Episodes" and "Downloads".<br />
* New feature: update only the selected podcast in page "Downloads".<br />
* New feature: episodes can now be tagged as "Ignore" in page "Downloads". All episodes with status "ignore" will be skip when the downloading of all episodes of a podcast will be requested.<br />
* New feature: unplayed episodes can now be identified by a yellow star. Unplayed/played status of episodes can be manually toggled via a new entry "Toggle Played Status" in the menu "Actions" of page "Episodes".<br />
* New feature: import of podcasts via an OPML file (new button "Import" in the page "Podcasts")<br />
* Fixed occasionnaly incorrect display size of podcasts covers.|<br />
Screenshot=Podboy.png|<br />
Homepage=http://code.google.com/p/podboy/|<br />
TestedOn=SHR-Unstable|<br />
PackageName=[http://podboy.googlecode.com/files/podboy_1.2.0-r0_all.ipk podboy_1.2.0-r0_all.ipk]<br />
}}<br />
{{ApplicationBox|<br />
Name=[[Literki]] 0.0.2-r6|<br />
Description=Literki is a full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. With literki comes the touchpad. With it use can use the bottom of the touchscreen to move a cursor around. You can then use left and right click with it. There are also four scroll buttons, which are useful if your application has very small scroll bars. Changes from previous version are:<br />
*page up, page down keys work now<br />
*$ key works now<br />
*can toggle between opaque and transparent mode|<br />
Screenshot=Literki.png|<br />
Homepage=http://www.opkg.org/package_232.html|<br />
TestedOn=SHR-Testing,SHR-Unstable|<br />
PackageName=[http://pvtrace.com/~miki150/literki_0.0.2-r6_armv4t.ipk literki]<br />
}}<br />
<br />
==Community==<br />
* Sebastian Spaeth, responsible for testing images of SHR is '''calling for final [http://www.shr-project.org/trac bug reports]''' before making a SHR-Stable images! It looks like recent SHR-Testing images has reached stability level, which allows to make a '''snapshot of SHR-Stable!''' Although for this to be done, your help is needed, as there might still be some bugs hidden that need to be discovered. Do not hesitate, even one bug filed by you will greatly help to improve SHR-Stable!<br />
<br />
* Harald Welte is '''[http://laforge.gnumonks.org/weblog/2010/01/07/#20100107-gsm_devel_board-planning planning]''' to create a GSM development board based on 100% open hardware design and 100% free software. The initial focus is to create a board that behaves like a GSM cellphone. This could be interesting for the gta02-core project.<br />
<br />
* Werner Almesberger posted another '''[http://lists.openmoko.org/pipermail/gta02-core/2010-January/000808.html component update]''' note. It states that there are plenty of mechanical parts left but electrical parts are more of a problem. There seem to be some inconsistencies in the inventory, so some positions may still change. If you are able to provide project with with missing parts, take a look at '''[http://lists.openmoko.org/pipermail/gta02-core/2010-January/000815.html full inventory list]''' and consult with Werner.<br />
<br />
* Marc Andre Tanner made some boot time optimization with his '''[http://repo.or.cz/w/qi-bootmenu-system.git qi-bootmenu-system]''' and provided his latest [http://www.brain-dump.org/tmp/uImage-GTA02-bootmenu.bin kernel] build and slightly modified version of [http://www.brain-dump.org/tmp/qi-s3c2442-bootmenu.udfu Qi], although it isn't strictly necessary. You can read more about [http://thread.gmane.org/gmane.comp.handhelds.openmoko.devel/4434 qi-bootmenu] or about [http://lists.openmoko.org/pipermail/openmoko-kernel/2009-December/010778.html boot time optimization]<br />
<br />
* '''[[SHR]]''' is a community driven distribution and according to latest [http://lists.openmoko.org/pipermail/community/2010-January/058833.html pool], is the most popular OS for the Freerunner. Although it has not made a stable release yet, it is actively developed. According to this '''[http://lists.shr-project.org/pipermail/shr-devel/2010-January/001800.html thread]''', recently a substantial FSO upgrade (mentioned in Introduction) is hitting SHR. Thanks to reimplementation of FSO middleware API's in Vala, you can expect significant speed improvements. Specifically, SHR-Unstable now features fsodeviced, fsousaged and fsonetworkd, and introduces a more elegant separation of configuration files for each daemon. Images are now available for [[UBIFS]], in addition to jffs and ext. The discussions about faster kernels is also affecting SHR among other distributions. MTD_NAND_VERIFY_WRITE kernel option, which should speed it up, is already pushed in. Experimental kernels (2.6.29-rc3-drm, 2.6.31, 2.6.32) are [http://build.shr-project.org/tests/mrmoku/kms/images/om-gta02/ available] for testing.<br />
<br />
* Gennady Kupava has been '''[http://lists.openmoko.org/pipermail/openmoko-kernel/2010-January/010811.html working]''' on optimizing the speed of kernel and [http://lists.openmoko.org/pipermail/openmoko-kernel/2010-January/010804.html measuring the result]. This has caused a '''[http://lists.openmoko.org/pipermail/openmoko-kernel/2010-January/010844.html great noise]''' on the kernel list and irc. It seems that even after that many months of work on the kernel, one can still discover new ways of catching big chunks of speed improvements here and there. Some interesting [http://lists.openmoko.org/pipermail/openmoko-kernel/2010-January/010853.html results here].<br />
<br />
* Ghislain has prepared installer-image for Radek Polak's QtMoko '''[http://www.openmobile.nl/pages/downloads.php#qtm16b V16B]''' which is basically V16 with:<br />
** Kernel without debugging options (overall speedup)<br />
** TangoGPS to V0.99.2<br />
** Latest patch from Radek (mmap & mmap64)<br />
<br />
* Great news for all [http://www.opkg.org/ opkg.org] fans! It appear that this web service author is back again with us, and is planning '''[http://www.opkg.org/posting_6.html opkg.org reanimation]'''. Feature requests should be directed to '''[mailto:reanimation@opkg.org reanimation@opkg.org]'''<br />
<br />
==Event News==<br />
<br />
* '''2009-01-19''' Next Cyclic '''Openmoko "Stammtisch" meeting''' in Munich, Germany takes place at 19:00 local time. This time Dr. Mickey "FSO" Lauer has planned to visit. A location as usuall is "Die Wildsau", Balanstrasse 121, 81549 München. Please register yourself through [http://www.doodle.com/sgsqrv46yinsmib4 doodle]<br />
* '''2009-01-29''' New '''Hackable:1 and Openmoko Users Meeting''' in [http://lacantine.org La Cantine] (Paris) from 19h to 22h. If you plan to attend, please file the [http://openmoko-fr.org/wiki/index.php/2010-01-29_:_La_Cantine Wiki page]. High risks of restaurant after closing time.<br />
<br />
[[Category:Community Update]]</div>Linuxxrhttp://openmoko.org/wiki/Community_Updates/2010-01-14Community Updates/2010-01-142010-01-14T15:10:35Z<p>Linuxxr: /* Community */</p>
<hr />
<div>====='''Period 2010-01-01 to 2010-01-14'''=====<br />
<br />
==Introduction==<br />
<br />
==Distributions==<br />
{{DistributionBox|<br />
Name=Distro Name [version]|<br />
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.|<br />
Screenshot=System_boot.png|<br />
Codename='codename'|<br />
Homepage=http://www.homepage.org|<br />
Image=[http://www.homepage.org/path/to/ images]|<br />
Works={{Works}}<br />
}}<br />
<br />
==Applications== <br />
<br />
===New Applications===<br />
{{ApplicationBox|<br />
Name=Elm-Browser 1.0_r0.4|<br />
Description=This is an initial release of a very fast, finger friendly webkit-efl / elementary based browser.<br />
* finger scrolling<br />
* double-click to zoom in<br />
* triple click to zoom out (not working as of now - help needed)<br />
* layout optimised for max viewing space|<br />
Screenshot=Browser-c_c.png|<br />
Homepage=http://elm-browser.googlecode.com|<br />
TestedOn=SHR-Unstable|<br />
PackageName=[http://elm-browser.googlecode.com/files/browser_1.0-r0.4_armv4t.ipk browser_1.0-r0.4_armv4t.ipk]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=rtmom 0.1| <br />
Description=rtmom is a Python client for [http://www.rememberthemilk.com/ RememberTheMilk]. It is based on Elementary.<br />
* Currently, rtmom is more or less read-only:<br />
** you can download and display your tasks and <br />
** you may mark a task as complete<br />
** no editing or creating of tasks yet implemented<br />
* Check [http://wiki.github.com/kichkasch/rtmom/end-user wiki] for installation and usage.|<br />
Screenshot=Rtmom.png|<br />
Homepage=http://freshmeat.net/projects/rtmom|<br />
TestedOn=SHR-Testing|<br />
PackageName=[http://cloud.github.com/downloads/kichkasch/rtmom/rtmom_0.1_armv4t.ipk rtmom]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=Openmokontrol 0.1|<br />
Description=Openmokontrol is a CLI-controlled application for the Freerunner to send input events to a remote X11 server caused by accelerometer events, well usable for games.|<br />
Screenshot=System_boot.png|<br />
Homepage=http://wiki.openmoko.org/wiki/openmokontrol|<br />
TestedOn=SHR-Unstable,Hackable:1|<br />
PackageName=[http://www.opkg.org/packages/0_openmokontrol_0.1_arm.ipk Openmokontrol]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=[[QCurrency]] 0.1|<br />
Description=Christian Rüb developed QCurrency. It is a simple currency calculator, with save exchange rate capability.|<br />
Screenshot=Qcurrency.png|<br />
Homepage=http://git.senfdax.de/?p=qcurrency;a=summary|<br />
TestedOn=SHR|<br />
PackageName=[http://openmoko.senfdax.de/shr-new-unstable/qcurrency_0.1-r1.4_armv4t.ipk qcurrency]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=MKPRN 0.3|<br />
Description=MKPRN is a [http://en.wikipedia.org/wiki/RPN_calculator Reverse Polish Notation] calculator. Currently it is in early stage of development. Suggestions and feature requests are welcome.|<br />
Screenshot=MKPRN_v0.2.png|<br />
Homepage=http://glitch.tl/mkrpn.html|<br />
TestedOn=?|<br />
PackageName=http://opkg.glitch.tl/mkrpn_0.2_arm.ipk mkprn]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=qspectemu|<br />
Description=Radek Polak have just finished porting of Miklos Szeredi's [http://www.inf.bme.hu/~mszeredi/spectemu/ spectemu] - A Sinclair ZX Spectrum emulator for Linux/UNIX, to Qt on Freerunner. It's now in QtMoko package feed if you want to try it or you can compile from sources for your favourite distro. The main work was port to Qt, possibility to use touchscreen and creating GUI for loading/saving snapshots and creating mouse/touchscreen bindings. For QtMoko you will need [http://activationrecord.net/radekp/qtmoko/download/experimental/uImage-v17.bin v17] kernel to get decent speed. Emulator can now do following:<br />
*download my favourite games from internet<br />
*load/save snapshot<br />
*define custom on screen locations for spectrum keys<br />
*rotate, qvga<br />
*vibrate to notice if pressed border location of two keys<br />
*use virtual keyboard for input (longer press requited for some games)<br />
*autocorrect on screen key location during game playing|<br />
Screenshot=System_boot.png|<br />
Homepage=http://activationrecord.net/radekp/qspectemu/|<br />
TestedOn=QtMoko|<br />
PackageName=QSpectemu binares are included in [http://activationrecord.net/radekp/qtmoko/ QtMoko] default package feed, sources are in [http://github.com/radekp/spectemu GIT] repository.<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=qspectemu 0.0.1|<br />
Description=Exampleapp 0.0.1 is an application to do some stuff..|<br />
Screenshot=System_boot.png|<br />
Homepage=http://wiki.openmoko.org/|<br />
TestedOn=SHR-Unstable,Om2009T5|<br />
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]<br />
}}<br />
<br />
===Application Updates===<br />
<br />
{{ApplicationBox|<br />
Name=Exampleapp 0.0.1|<br />
Description=Exampleapp 0.0.1 is an application to do some stuff..|<br />
Screenshot=System_boot.png|<br />
Homepage=http://wiki.openmoko.org/|<br />
TestedOn=SHR-Unstable,Om2009T5|<br />
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=SpojeGUI|<br />
Description=SpojeGUI is GUI program which use CLI program/modul [http://code.google.com/p/spoje/ spoje.py] which is used mainly for Czech and Slovak transport.<br />
* Save confing and link to DB. |<br />
Screenshot=spojeguiV4.png|<br />
Homepage=http://www.multi.mluv.cz/programovani/spojegui.html|<br />
TestedOn=SHR-Testing|<br />
PackageName=[http://data.multi.mluv.cz/spoje_0.4.0_all.ipk SpojeGUI]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=[[Podboy]] 1.2.0|<br />
Description=Podboy is a podcast aggregator/player written in Python/Elementary. Its interface aims to be easy and finger friendly. It uses Feedparser Python module for download/parsing of podcast feeds, Gstreamer for playing of episodes and SQLite for storing data. Changes since version 1.0.0:<br />
* New feature: possibility to show details of episodes before to play them via a new entry "Show Details" in the menu "Actions" of pages "Episodes" and "Downloads".<br />
* New feature: update only the selected podcast in page "Downloads".<br />
* New feature: episodes can now be tagged as "Ignore" in page "Downloads". All episodes with status "ignore" will be skip when the downloading of all episodes of a podcast will be requested.<br />
* New feature: unplayed episodes can now be identified by a yellow star. Unplayed/played status of episodes can be manually toggled via a new entry "Toggle Played Status" in the menu "Actions" of page "Episodes".<br />
* New feature: import of podcasts via an OPML file (new button "Import" in the page "Podcasts")<br />
* Fixed occasionnaly incorrect display size of podcasts covers.|<br />
Screenshot=Podboy.png|<br />
Homepage=http://code.google.com/p/podboy/|<br />
TestedOn=SHR-Unstable|<br />
PackageName=[http://podboy.googlecode.com/files/podboy_1.2.0-r0_all.ipk podboy_1.2.0-r0_all.ipk]<br />
}}<br />
<br />
{{ApplicationBox|<br />
Name=[[Literki]] 0.0.2-r6|<br />
Description=Literki is a full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. With literki comes the touchpad. With it use can use the bottom of the touchscreen to move a cursor around. You can then use left and right click with it. There are also four scroll buttons, which are useful if your application has very small scroll bars. Changes from previous version are:<br />
*page up, page down keys work now<br />
*$ key works now<br />
*can toggle between opaque and transparent mode|<br />
Screenshot=Literki.png|<br />
Homepage=http://www.opkg.org/package_232.html|<br />
TestedOn=SHR-Testing,SHR-Unstable|<br />
PackageName=[http://pvtrace.com/~miki150/literki_0.0.2-r6_armv4t.ipk literki]<br />
}}<br />
<br />
==Community==<br />
<br />
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..<br />
<br />
* '''Harald Welte''' is [http://laforge.gnumonks.org/weblog/2010/01/07/#20100107-gsm_devel_board-planning planning] to create a GSM development board based on 100% open hardware design and 100% free software. The initial focus is to create a board that behaves like a GSM cellphone. This could be interesting for the gta02-core project.<br />
<br />
* Werner Almesberger posted another '''[http://lists.openmoko.org/pipermail/gta02-core/2010-January/000808.html component update]''' note. It states that there are plenty of mechanical parts left but electrical parts are more of a problem. There seem to be some inconsistencies in the inventory, so some positions may still change. If you are able to provide project with with missing parts, take a look at '''[http://lists.openmoko.org/pipermail/gta02-core/2010-January/000815.html full inventory list]''' and consult with Werner.<br />
<br />
* Marc Andre Tanner made some boot time optimization with his '''[http://repo.or.cz/w/qi-bootmenu-system.git qi-bootmenu-system]''' and provided his latest [http://www.brain-dump.org/tmp/uImage-GTA02-bootmenu.bin kernel] build and slightly modified version of [http://www.brain-dump.org/tmp/qi-s3c2442-bootmenu.udfu Qi], although it isn't strictly necessary. You can read more about [http://thread.gmane.org/gmane.comp.handhelds.openmoko.devel/4434 qi-bootmenu] or about [http://lists.openmoko.org/pipermail/openmoko-kernel/2009-December/010778.html boot time optimization]<br />
<br />
* '''[[SHR]]''' is a community driven distribution and according to latest [http://lists.openmoko.org/pipermail/community/2010-January/058833.html pool], is the most popular OS for the Freerunner. Although it has not made a stable release yet, it is actively developed. According to this [http://lists.shr-project.org/pipermail/shr-devel/2010-January/001800.html thread], recently a substantial FSO upgrade (mentioned in Introduction) is hitting SHR. Thanks to reimplementation of FSO middleware API's in Vala, you can expect significant speed improvements. Specifically, SHR-Unstable now features fsodeviced, fsousaged and fsonetworkd, and introduces a more elegant separation of configuration files for each daemon. Images are now available for [[UBIFS]], in addition to jffs and ext. The discussions about faster kernels is also affecting SHR among other distributions. MTD_NAND_VERIFY_WRITE kernel option, which should speed it up, is already pushed in. Experimental kernels (2.6.29-rc3-drm, 2.6.31, 2.6.32) are [http://build.shr-project.org/tests/mrmoku/kms/images/om-gta02/ available] for testing.<br />
<br />
==Event News==<br />
<br />
* '''2009-01-19''' Next Cyclic '''Openmoko "Stammtisch" meeting''' in Munich, Germany takes place at 19:00 local time. This time Dr. Mickey "FSO" Lauer has planned to visit. A location as usuall is "Die Wildsau", Balanstrasse 121, 81549 München. Please register yourself through [http://www.doodle.com/sgsqrv46yinsmib4 doodle]<br />
<br />
[[Category:Community Update]]</div>Linuxxrhttp://openmoko.org/wiki/OpkgOpkg2009-11-13T04:15:46Z<p>Linuxxr: /* Nead Little Tricks */</p>
<hr />
<div>{{Languages|Opkg}}<br />
<br />
== About Opkg ==<br />
<br />
Opkg is a lightweight [[package management]] system based on [[Ipkg]].<br />
<br />
<br />
Mid December, 2008, the project moved to Google code: http://code.google.com/p/opkg/<br />
* Group: http://groups.google.com/group/opkg-devel<br />
* mailto: opkg-devel at googlegroups.com <opkg-devel at googlegroups.com><br />
* Checkout Code: http://code.google.com/p/opkg/source/checkout<br />
<br />
Prior to that date, a mailing list for discussion was available here: http://lists.openmoko.org/mailman/listinfo/opkg-devel<br />
Source code was available in the subversion repository: http://svn.openmoko.org/trunk/src/target/opkg/. The repository could also be [http://svnweb.openmoko.org/trunk/src/target/opkg/ viewed online].<br />
<br />
You can learn how to create own [http://handhelds.org/moin/moin.cgi/BuildingIpkgs Opkg packages] on the Ipkg site.<br />
<br />
Packages should install .desktops at the very end of the installation process. This ensures that the icons referenced in the .desktop file are available. [https://docs.openmoko.org/trac/ticket/1524 Reference]<br />
<br />
== New Features ==<br />
<br />
This is a list of features that have been completed. Mostly this is a list of changes from Ipkg.<br />
<br />
* Use libcurl to download files<br />
* Send download progress updates to libopkg clients<br />
* Re-organize and clean up source code into sub directories<br />
* Verify package lists with gpg detached signature<br />
* Mark packages that were installed to satisfy dependencies (auto installed)<br />
* Additional command line option to remove "auto installed" packages<br />
* Support for faceted classification (similar to debtags). ''A "Tags" line has been added to the package information and opkg makes this available to clients, but does not process it in anyway. The command line client also does not use this features yet.''<br />
<br />
<br />
=== Ipkg Patches ===<br />
<br />
The following ipkg patches have been applied:<br />
<br />
* "2-pkg-vec--Optimize-gross-inefficiency.patch" from OpenEmbedded <br />
* "1-pkg-parse--Optimize-inefficient-parsing.patch" from OpenEmbedded<br />
<br />
* [http://svn.o-hand.com/view/poky/trunk/meta/packages/ipkg/files/update_version_comparision.patch?rev=3827&view=auto update_version_comparision.patch] from Richard Purdie<br />
* [http://svn.o-hand.com/view/poky/trunk/meta/packages/ipkg/files/enable_debversion.patch?rev=3827&view=auto enable_debversion.patch] from Richard Purdie<br />
<br />
== Planned features ==<br />
<br />
These are features either under development or planned for inclusion before the next release.<br />
<br />
* improve/cleanup [[libopkg]] api<br />
* locking system to prevent two simultaneous operations on the file system<br />
<br />
=== Bug fixes ===<br />
<br />
* Ipkg bug - Overflowing / crashes machine - [http://bugs.openembedded.net/show_bug.cgi?id=1028]<br />
* ipkg tries to access ro SD card - [http://bugs.openembedded.net/show_bug.cgi?id=1029]<br />
<br />
=== Lower priority features ===<br />
<br />
* Simple user interactions during postinstall<br />
* Improve command line options<br />
* Restructure source code and make it more robust<br />
* Store packages in database<br />
* Check available space in /tmp prior to downloading<br />
* Check available space in dest prior to unpacking<br />
<br />
== Possible Issues ==<br />
<br />
This is a list of possible issues or known bugs.<br />
<br />
* http proxy works but authentication not tested yet (--[[User:cberger|cberger]] tested version 0.1.4, does not recognize proxy_username and proxy_password for authentication)<br />
* autoremove feature only inspects "depends" and not "pre-depends"<br />
* if you encounter fork failures, and/or segmentation fault, you probably need more memory. To do so, add temporarily swap by:<br />
** Creating a file which will be used for swap:<br />
***If you are using dd from coreutils:<br />
dd if=/dev/zero of=/media/card/file.swap bs=1M count=512<br />
***If you are using dd from busybox (Interrupt the process (ctrl+c) once the file is big enough. 128 MB should be enough):<br />
dd if=/dev/zero of=/media/card/file.swap<br />
**Turn the file into a swap<br />
mkswap /media/card/file.swap<br />
**Activate the swap through the file (until swapoff command is used, or reboot)<br />
swapon /media/card/file.swap<br />
**Upgrade<br />
opkg upgrade<br />
**Deactivate swap<br />
swapoff or reboot<br />
<br />
Next time you will simply need to reactivate the swap before upgrading.<br />
<br />
== Error Codes ==<br />
<br />
It looks like, in some cases, Opkg will return an error code if something goes wrong. Here's a list that I pulled from the error.h file:<br />
<br />
* -1: Unknown Error<br />
* 0: No Error (Success)<br />
<br />
Configuration Errors:<br />
* 1: Could not set default destination<br />
* 2: Error parsing config file<br />
* 3: Could not create temporary directory<br />
* 4: Could not obtain administrative lock<br />
** This could be cause by assassin not releasing the lock on the package management. It can be released by killing its manager:<br />
killall packagekitd<br />
<br />
Package Errors<br />
* 5: Unsatisfied Dependencies<br />
* 6: Is Essential<br />
* 7: Has Dependents<br />
* 8: Has No Candidate<br />
* 9: PackageHas No Available Architecture<br />
<br />
Install Errors<br />
* 10: Not Trusted<br />
* 11: Download Error<br />
* 12: Conflicts<br />
* 13: Already Installed<br />
* 14: Dependencies<br />
* 15: No Downgrade<br />
* 16: Out Of Space<br />
* 17: Bad Signature<br />
* 18: MD5 Error<br />
* 19: Internal Error<br />
<br />
{{note|I had a problem where I was trying to manually install a package that had dependencies. The dependencies had a bad signature (actually, my signature files were bad). Instead of returning 17 because of the bad signature, it returned 14 because of a dependency problem. So if you get a 14, try installing that package by itself and see what you get. --[[User:Jtickle|Jtickle]] 18:16, 23 July 2008 (EST) }}<br />
<br />
== FAQ ==<br />
<br />
Q. What version of Ipkg is Opkg based on?<br />
<br />
A. It is based on the [http://www.handhelds.org/download/packages/ipkg/ipkg-0.99.163.tar.gz ipkg-0.99.163] tarball<br />
<br />
Q. Why "fork" and rename Ipkg?<br />
<br />
A. Ipkg is no longer actively maintained upstream and there are potential trademark issues with using the Ipkg name<br />
<br />
Q. Does opkg have a feature similar to APT pinning?<br />
<br />
A. Yes you can define priorities on the architecture field (the second field in a feed definition) in /etc/opkg/arch.conf<br />
<br />
Q. Does opkg have an auto completion system ?<br />
<br />
A. Yes, it's a contribution script available at the [http://blog.upme.fr/?/Linux/28-Openmoko-Opkg-Autocompletion-With-Packages-Names upme blog]<br />
<br />
Q. How similar is the ipk format, to the deb format? They look very similar; the data and control tar balls are identical as far as i can tell.<br />
<br />
A. Very similar. ipk files are basically deb files with documentation removed, and ipkg is even supposedly able to handle deb files. Opkg can install .deb packages directly, with no change. There may be issues with some packages, concerning preinst and postinst scripts<br />
<br />
<br />
== Neat Little Tricks ==<br />
<br />
At one point I ended up doing a complete upgrade before i had updated my opkg. As a result i borked a lot af packages. To reinstall them all, you can use this little sed magic.<br />
opkg -force-reinstall install `opkg list_installed | sed 's/ - .*//'<br />
<br />
<br />
{{Languages|Opkg}}<br />
<br />
[[Category:Package management]]</div>Linuxxrhttp://openmoko.org/wiki/User_talk:LinuxxrUser talk:Linuxxr2009-11-04T02:25:13Z<p>Linuxxr: </p>
<hr />
<div>Yay,,its time to free my phone!!! 20091101-Android allows me to write this note</div>Linuxxrhttp://openmoko.org/wiki/User:LinuxxrUser:Linuxxr2009-09-29T16:12:20Z<p>Linuxxr: Summary</p>
<hr />
<div>It's Been a Very Productive Year__ A Complete Fanblade of Distros Appeared, an then the Project was shunted to the Public.</div>Linuxxrhttp://openmoko.org/wiki/File:Adam_20080713_back_notworking.JPGFile:Adam 20080713 back notworking.JPG2008-08-02T06:08:05Z<p>Linuxxr: </p>
<hr />
<div>Not working SIM 20080713<br />
The 71234G problem is caused by the center contact on the 3 contact side of the sim grounding on the holder tab causing failure to register.<br />
Use a more centered contact to avoid this. this sim did work sometimes if positioned properly</div>Linuxxrhttp://openmoko.org/wiki/File:Adam_20080713_back_notworking.JPGFile:Adam 20080713 back notworking.JPG2008-08-02T06:05:22Z<p>Linuxxr: </p>
<hr />
<div>Not working SIM 20080713<br />
71234 G caused by the center contact on the 3 contact side of the sim grounding on the holder tab causing failure to register</div>Linuxxrhttp://openmoko.org/wiki/File:Adam_20080713_back_notworking.JPGFile:Adam 20080713 back notworking.JPG2008-08-02T06:04:33Z<p>Linuxxr: </p>
<hr />
<div>Not working SIM 20080713<br />
71234 G caused by the center contacton the 3 contact of the sim grounding on the holder tab causing failure to register</div>Linuxxrhttp://openmoko.org/wiki/File:Adam_20080713_back_notworking.JPGFile:Adam 20080713 back notworking.JPG2008-08-02T06:02:21Z<p>Linuxxr: sim holder tab grounding on sim contact</p>
<hr />
<div>Not working SIM 20080713 caused by the center contact grounding on the holder tab</div>Linuxxrhttp://openmoko.org/wiki/File:Adam_20080713_back_notworking.JPGFile:Adam 20080713 back notworking.JPG2008-08-02T05:58:55Z<p>Linuxxr: grounded bracket tab</p>
<hr />
<div>Not working SIM 20080713 caused by the center contact grounding on the tab</div>Linuxxrhttp://openmoko.org/wiki/User:OpearceUser:Opearce2008-07-05T18:46:24Z<p>Linuxxr: New page: yup got a freerunner on its way</p>
<hr />
<div>yup got a freerunner on its way</div>Linuxxrhttp://openmoko.org/wiki/User:OdigityUser:Odigity2008-07-02T14:29:50Z<p>Linuxxr: New page: wassa</p>
<hr />
<div>wassa</div>Linuxxrhttp://openmoko.org/wiki/User_talk:LinuxxrUser talk:Linuxxr2008-06-29T16:08:35Z<p>Linuxxr: New page: Yay,,its time to free my phone!!!</p>
<hr />
<div>Yay,,its time to free my phone!!!</div>Linuxxr