Maemo Wiki Mirror - User contributions [en]

Enterprise Device Configuration

2011-12-15T03:15:45Z

114.79.28.10: /* Summary */

The user device is configured using the following components:
* User configuration file: Enterprise User Configuration File (EUF)
* Configuration package: Enterprise Package (EP)

== Enterprise User Configuration File ==

The EUF is a result of the provisioning phase of the installation (recall [[Enterprise_-_Tried_and_tested_provisioning_strategies|the tried and tested]] or [[Enterprise_Provisioning_-_Strategy_Variations|the alternate]] provisioning strategies depending on your environment setup).
It may contain, e.g., user specific information. It is a simple XML file. We use the following as an example:

<source lang="xml">
<?xml version="1.0" encoding="UTF-8" ?>
<CONF>
<NAME>Joe Buck</NAME>
<REMOTE_ACCESS>
<LOGIN>joebuck</LOGIN>
</REMOTE_ACCESS>
<SIP>
<NAME>ext-joe.4.buck</NAME>
<PASS>98765876</PASS>
</SIP>
<WLAN>
<RESTAURANT>
<LOGIN>joejoe</LOGIN>
<PASS>buckybuck</PASS>
</RESTAURANT>
</WLAN>
<EMAIL>
<ADDRESS>ext-joe.4.buck@company.org</ADDRESS>
</EMAIL>
</CONF>
</source>

This file is used by configuration scripts and programs to automatically fill-in e-mail addresses, passwords, etc. in the configuration files of the supported
applications. This way, after the installation of the Enterprise Package, the user will need to do only the minimal (if any) amount of manual setup.

In our examples, this configuration file is assumed to be in <code>/home/user/MyDocs/.documents/EnterpriseConfig.xml</code> after the provisioning.

== Enterprise Package ==

The EP is an installable application package that contains the following main parts:
* List of included applications
* Configuration scripts and configuration data: Used to configure the supported settings and applications on the device.

In this section, we create a simple EP that you can soon download from carage. This example can be used as a template to create your own customized package.

=== Adding applications ===

The EP may contain references to applications that are automatically installed when EP is installed.

To add an application you need to do the following steps:
# Make sure that a Debian package is available of the application.
# Make sure that the repository where the debian package is found is accessible via the Application Manager during the installation of the EP.
# Edit the debian/control file of EP. For example, to add an application called "vpngui" you will have a control file similar to this:

<pre>
Source: ep-example
Section: user/office
Priority: optional
Maintainer: Joe Buck <joe.buck@net.org>
Build-Depends: debhelper (>= 4.0.0), maemo-optify
Standards-Version: 3.6.0

Package: ep-example
Architecture: all
Section: user/office
Depends: ${shlibs:Depends}, rdesktop-maemo (>= 1.6.0-2maemo1), rdesktop-m5ui (>= 1.0), enterprise-configurator (>= 1.0), vpngui (>= 5.5.0), vpnc (>= 0.5.9-1m6)
Description: Enterprise application package for Joe Buck and his company.
XB-Maemo-Display-Name: Joe Buck's Enterprise Package
</pre>

[http://www.debian.org/doc/debian-policy/ch-controlfields.html Debian Policy Manual: Chapter 5 - Control files and their fields] has more information about creating Debian control files.

=== Configuring applications ===

When you look in the data directory of the example, you will see several different files.

The configurator uses a utility called enterprise-configurator. Here we demonstrate its usage by some practical examples.

This package contains command line utilities that simplify some common tasks.
One major component is the epconf program. It is called from the debian/postinst, preinst and prerm scripts (see [http://www.debian.org/doc/debian-policy/ch-maintainerscripts.html Debian Policy Manual: Chapter 6 - Package maintainer scripts and installation procedure] for more information about Debian maintainer scripts).

The files from the data directory are installed under <code>/usr/share/epconf-sets/ep-example</code> (see <code>data/Makefile.am</code>). The <code>epconf</code> utility processes them, for example, after installation based on debian/postinst:

<source lang="bash">
#!/bin/sh
epconf macro /home/user/MyDocs/.documents/EnterpriseConfig.xml install ep-example
exit 0
</source>

The epconf utility then processes the following files in <code>/usr/share/epconf-sets/ep-example</code>:

* <code>clean-user-data.sh</code>: This script is called when the users requests to clear the user data. It should remove user specific configuration files and sensitive data related to the applications that EP is responsible for.
* <code>process-list</code>: A list of processes that have to be stopped when EP is being configured. For example, if EP configures an IM client, probably the IM client should be stopped before the configuration starts. Every line in this file contains a process name as seen with the "ps" command.
* <code>process-list.stop</code>: This script is called if any of the processes listed in process-list is found running during configuration. It is responsible to stop those processes.

The device configuration is done with the following files:

* <code>*.epin</code>: These are in-files for the epconftool utility used by epconf.
* <code>*.crt</code>: These must be certificates in DER format. They are registered in the device for WLAN authentication.
* <code>*.vcard</code>: Every VCard file is inserted into the Contacts list.
* <code>thumbnail_*</code>: These image files are copied to the device and can be used in, e.g., Web bookmarks for thumbnail images (see [[Enterprise_Device_Configuration#Browser_Bookmarks|Browser Bookmarks]] for more information).

Epconf has two main arguments, <code>"install"</code> and <code>"uninstall"</code>, that do the configuration and de-configuration respectively. Epconf processes these above files during both installation and uninstallation.

Epconf in-files (<code>*.epin</code>) are special. In these, you can refer to text node values in the EUF. For example, based on our sample EUF above, if <code>"%CONF_SIP_NAME%"</code> appears anywhere in an in-file, it is replaced by epconf with the text <code>"ext-joe.4.buck"</code> (both without the double quotes). This is how the values in the EUF can be used to configure the device.

=== Configuration examples ===

The configurations below are included in our example.

==== Contacts ====

Contacts can be added to the contact list by providing the corresponding VCards in the data directory of EP.
An FN field must exist in each VCard that serves as an identifier. During installation, this FN field is used to detect duplicate contacts. During uninstallation, it is used to find the contact to be deleted.

For example:
<pre>
BEGIN:VCARD
VERSION:3.0
N:Helpline;Company
FN:Company Emergency Helpline
ORG:Company Co.
TEL;TYPE=WORK:+456789098765
END:VCARD
</pre>

During uninstallation, all the contacts that have the "Company Emergency Helpline" FN field are deleted.

==== Desktop shortcuts ====

Desktop shortcuts are small icons on the desktop screen of the device. These are created by modifying the GConf database. The configuration file that is responsible for this in our example is <code>data/shortcuts.do-as-user.epin</code>:

<pre>
[CONTROL]
type:gconf

[DATA]
dir:/apps/osso/hildon-home/bookmarks/company
replace:string:icon:%INFILE_DIR%/company_160x96.png
replace:string:label:Company
replace:string:url:http://www.company.com

dir:/apps/osso/hildon-home/bookmarks/company-support
replace:string:icon:%INFILE_DIR%/company_160x96.png
replace:string:label:Support
replace:string:url:http://www.company.com/support

dir:/apps/osso/hildon-home
merge:string-list:bookmark-shortcuts:[company,company-support]
</pre>

This is a GConf in-file that is processed by <code>epconf</code>. The <code>CONTROL</code> section tells that it contains GConf-related settings. The <code>DATA</code> section describes the GConf directories and their nodes that are modified during installation/uninstallation.

This example creates two shortcuts to two web pages. The <code>%INFILE_DIR%</code> macro is replaced by the <code>/usr/share/epconf-sets/ep-example</code> string. So, the icons are taken from <code>/usr/share/epconf-sets/ep-example/company_160x96.png</code>. Those icons are provided in the data directory of the EP package and are installed to /usr/share/epconf-sets/ep-example when the EP is installed.

==== WLAN ====

WLAN access points are also configured by using gconf in-files. The data/wlan.do-as-user.epin configures our example WLAN AP. The new AP will be available in the list of Access Points by the name <code>"COMPANY_RESTAURANT"</code>:

<pre>
[CONTROL]
type:gconf

[DATA]
dir:/system/osso/connectivity/IAP/COMPANY_RESTAURANT
replace:int:EAP_default_type:25
replace:int:proxy_https_port:0
replace:int:proxy_http_port:0
replace:string:type:WLAN_INFRA
replace:string:ipv4_address:0.0.0.0
replace:string:EAP_manual_username:anonymous@anon1
replace:bool:ipv4_autodns:true
replace:int:EAP_GSMSIM_max_reauth_count:100
replace:string:ipv4_gateway:0.0.0.0
replace:string:proxytype:NONE
replace:int:wlan_powersave:4
replace:string:autoconf_url:
replace:string:proxy_https:
replace:string:EAP_MSCHAPV2_username:%CONF_WLAN_RESTAURANT_LOGIN%
replace:bool:TLS_server_authenticates_client_policy_in_client:false
replace:string:wlan_security:WPA_EAP
replace:string:proxy_rtsp:
replace:bool:EAP_use_manual_username:true
replace:int:proxy_ftp_port:0
replace:int:proxy_rtsp_port:0
replace:int-list:wlan_ssid:[87,73,86,79]
replace:bool:EAP_wpa2_only_mode:false
replace:int:wlan_adhoc_channel:0
replace:string:ipv4_dns1:0.0.0.0
replace:string:ipv4_dns2:0.0.0.0
replace:string:proxy_http:
replace:string:ipv4_netmask:0.0.0.0
replace:int:PEAP_tunneled_eap_type:26
replace:int-list:omit_proxy:[]
replace:string:ipv4_type:AUTO
replace:bool:wlan_hidden:false
replace:string:EAP_MSCHAPV2_password:%CONF_WLAN_RESTAURANT_PASS%
replace:int:EAP_MSCHAPV2_password_prompt:0
replace:string:proxy_ftp:
</pre>

Here the <code>%CONF_WLAN_RESTAURANT_USER%</code> macro will be automatically replaced by epconf with the value of the <code>/CONF/WLAN/RESTAURANT/USER</code> node from the <code>/home/user/MyDocs/.documents/EnterpriseConfig.xml</code> file. The <code>%CONF_WLAN_RESTAURANT_PASS%</code> is processed similarly.

Our WLAN needs also a root certificate used for authentication. It is in <code>data/wlan.crt</code> and it is automatically installed to the right place by epconf so, no special in-file is necessary.

==== Mail for Exchange ====

The Mail for Exchange (MfE) account is not fully configured due to the unavailability of the user's password. Nevertheless, the <code>data/activesync.do-as-user.epin</code> fills in most of the fields of the MfE setup wizard so, the user needs to provide only her password:

<pre>
[CONTROL]
type:gconf

[DATA]
dir:/apps/activesync/preconfigure
replace:string:credentials/username:%CONF_REMOTE_ACCESS_LOGIN%
replace:string:email/email_addr:%CONF_EMAIL_ADDRESS%
replace:string:connection/exchange_server:mail.company.org
replace:string:credentials/domain:COMPANY
replace:int:connection/port:443
replace:int:contacts/first_sync:1
replace:bool:connection/secure_connection:true
replace:bool:connection/sync/mail:true
replace:bool:connection/sync/contacts:true
replace:bool:connection/sync/calendar:true
</pre>

Here the <code>%CONF_REMOTE_ACCESS_LOGIN%</code> macro will be automatically replaced by epconf with the value of the <code>/CONF/REMOTE_ACCESS/LOGIN</code> node from the <code>/home/user/MyDocs/.documents/EnterpriseConfig.xml</code> file. The <code>%CONF_EMAIL_ADDRESS%</code> is processed similarly.

==== SIP Account ====

A SIP VoIP account is created by <code>data/im-sip.do-as-user.epin</code>. It is an in-file that contains two shell scripts in its <code>DATA</code> section. One for installation and
one for uninstallation. The scripts after the <code>"install:</code>" mark is executed when epconf is invoked with the <code>"install"</code> argument. Similarly, the script after the <code>"uninstall:</code>" mark is executed during uninstallation (i.e. de-configuration).

==== Browser Bookmarks ====

Browser bookmarks are stored in an XML file. Modifying XML files is a complicated task so, <code>epconf</code> provides a way to do it relatively easily with in-files. In our examples, web browser bookmarks are configured by <code>data/bookmarks.do-as-user.epin</code>:

<pre>
[CONTROL]
type:xml
target:/home/user/.bookmarks/MyBookmarks.xml
node_path:/xbel/bookmark
node_id_path:./title
if_exists:replace

[DATA]
<?xml version="1.0"?>
<DOCTYPE xbel PUBLIC "+//IDN python.org//DTD XML Bookmark Exchange Language 1.0//EN//XML" "http://www.python.org/topics/xml/dtds/xbel-1.0.dtd">
<xbel version="1.0">
<info>
<metadata>
<default_folder>yes</default_folder>
</metadata>
</info>
<title>My bookmarks</title>
<info>
<metadata>
<time_visited>%TIME_EPOCH%</time_visited>
<time_added>%TIME_EPOCH%</time_added>
<operator_bookmark>1</operator_bookmark>
<deleted>0</deleted>
</metadata>
</info>
<bookmark href="https://mail.company.com" favicon="" thumbnail="thumbnail_company.png">
<title>Company Email</title>
<desc>%MARKER%</desc>
</bookmark>
<bookmark href="company.com/" favicon="" thumbnail="thumbnail_company.png">
<title>Company Home Page</title>
<desc>%MARKER%</desc>
</bookmark>
</xbel>
</pre>

The <code>"target"</code> tag in the <code>CONTROL</code> section tells the location of the bookmark file on the device. The <code>"node_path"</code> identifies (by an XPath expression) the nodes that are to be inserted. The <code>node_id_path</code> (also an XPath expression) tells what part of the nodes (identified by <code>node_id_path</code>) should be used for detection duplicate entries (nodes).

The <code>DATA</code> section contains the XML that we want to merge with the contents of the <code>"target"</code>. It must be a complete XML file because if the target does not exist it will be created with the full contents of the <code>DATA</code> section.

So, in our example, we want to add two bookmarks to <code>/home/user/.bookmarks/MyBookmarks.xml</code>. The bookmark nodes are taken from the <code>/xbel/bookmark</code> tags (subtrees). We use the <code>"title"</code> tag inside the <code>"bookmark"</code> tags for detecting if a bookmark already exists in the target. If a duplicate is detected, "if_exists" tells that we want our bookmarks to overwrite the existing ones.

==== VPNGUI ====

The VPN client software has a UI called VPNGUI. The <code>data/vpngui-gateways.epin</code> configures two VPN gateways for our Joe Buck user. It is done by modifying the gconf database. Every VPN gateway has its own gconf directory under <code>/apps/osso/vpngui/ap/</code>. The gateway directory name must be a positive integer. For example, we create gateway 0 (Company-Berlin) and 1 (Company-Vancouver):

<pre>
[CONTROL]
type:gconf

[DATA]
dir:/apps/osso/vpngui/ap/0
replace:string:name:Company-Berlin
replace:string:secret:aruba1
replace:bool:secret_obf:false
replace:string:group:company
replace:string:gateway:192.122.220.123
# Possible values: none, manual or auto
replace:string:proxytype:manual
replace:string:proxy_server:proxy.europe.company.com
replace:int:proxy_port:8080
replace:string:proxy_autoconfig_url:http://proxyconf.company.com/proxy.pac
replace:string-list:proxy_ignore_hosts:[*.company.com]

dir:/apps/osso/vpngui/ap/1
replace:string:name:Company-Vancouver
replace:string:secret:SDFGHJK1234567SDFGH34567XSDCFG34567XDCG
replace:bool:secret_obf:true
replace:string:group:linux-vpn
replace:string:gateway:123.123.123.123
# Possible values: none, manual or auto
replace:string:proxytype:manual
replace:string:proxy_server:proxy.americas.company.com
replace:int:proxy_port:8080
replace:string:proxy_autoconfig_url:http://proxyconf.company.com/proxy.pac
replace:string-list:proxy_ignore_hosts:[*.company.com]
</pre>

Whenever Joe Buck connects to a VPN gateway, we may need to run some actions. The VPNGUI supports post-connect and post-disconnect scripts that are run after connection and after disconnection respectively. These scripts are put in place by <code>data/vpngui-scripts.epin</code>:

<pre>
[CONTROL]
type:shell

[DATA]
install:
#!/bin/sh
for PHASE in post-connect post-disconnect; do
mkdir -p /etc/vpngui/$PHASE
for i in `ls %INFILE_DIR%/*.$PHASE.vpns 2> /dev/null`; do
NAME=`basename $i | cut -f1 -d.`
chmod +x $i
ln -sf $i /etc/vpngui/$PHASE/$NAME
done
done

uninstall:
#!/bin/sh
for PHASE in post-connect post-disconnect; do
for i in `ls %INFILE_DIR%/*.$PHASE.vpns 2> /dev/null`; do
NAME=`basename $i | cut -f1 -d.`
rm -f /etc/vpngui/$PHASE/$NAME
done
rmdir -p /etc/vpngui/$PHASE > /dev/null || true
done
</pre>

It basically copies (links) the <code>data/*.vpns</code> files to the proper place where VPNGUI can find them during run-time. In our example, these scripts (<code>data/50_company*.vpns</code>) force the SIP account to use the VPN connection (this is necessary due to a problem in the N900 software as of 2010.04.28).

==== RDesktop ====

In our example, we use a remote desktop client, rdesktop-maemo, which supports the configuration of a custom help file. We install a company specific help file with <code>data/rdesktop.epin</code>:

<pre>
[CONTROL]
type:shell

[DATA]
install:
#!/bin/sh -ue
mkdir -p /usr/share/rdesktop-m5ui
ln -sf %INFILE_DIR%/rdesktop__help.pdf /usr/share/rdesktop-m5ui/

uninstall:
#!/bin/sh
rm -f /usr/share/rdesktop-m5ui/rdesktop__help.pdf
rmdir -p /usr/share/rdesktop-m5ui 2>/dev/null || true
</pre>

== Summary ==

In this page, we looked at how to create a custom Enterprise User Configuration File and a corresponding Enterprise Package. The provided examples can be used as a basis for your own deployment purposes. [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool] If you wish to learn more about epconf, feel free to read about [[Enterprise_Configurator|Enterprise Configurator]].

[[Category:Enterprise]]

ITVC architecture

2011-12-15T03:15:43Z

114.79.28.10: /* quit */

''Note: development of ITVC has stopped. There are [[Video encoding | many popular community-maintained alternatives]] for transcoding - for example [[Video encoding #tablet-encode |tablet-encode]]''

==Introduction==

The Internet Tablet Video Converter (from now on called ITVC) application is composed of two main components. The UI takes care of only the user interface and high level business logic, it does not process, or even handle, media files directly. This job is working with media files is delegated to a Media Handler process. This approach removes the burden of dealing with the universe of codecs and media conversion from the UI portion of the app and leaving it free to specialize in what it does best: top notch user interface and usability. This architecture also enables ITVC to use different multimedia frameworks seamlessly by isolating them in a completely independent process: the Media Handler.

But all that wouldn't mean much if the communication between ITVC and Media Handler was complicated and hard to implement. Thus the communication is done using simple XML-like elements via TCP sockets. Easy to debug, parse and implement.

This simple and modular architecture also opens the door for third-party developers to easily make their own Media Handlers.

This document describes how ITVC and a Media Handler interact. This is all that one needs to know to be able to develop a Media Handler or to write their own code to interface to it.

==Overview==

The Media Handler acts as a server listening for TCP connections on a given port. The GUI front end then opens one or more simultaneous client sockets to the Media Handler port and exchanges data in a 2-way communication

The Media Handler is launched by the main ITVC application, which reads the mhstarter.cfg file (in its main installation directory) to determine which application to actually launch.

You can start the built-in Media Handler provided by ITVC by launching it manually outside of the main application. To do this, simply open up a command line terminal and change directory to the place where the ITVC app was installed. The port to be listened to by the Media Handler is given as a parameter when launching it. The following command line command, for instance, will open a Media Handler using port 1234:

$> ./mediahandler 1234

Executing the Media Handler without specifying the port is considered to be an error.

There can be only one instance of a Media Handler implementation running at any given time. So when a Media Handler is started it should check whether there's already another instance of itself (regardless of the port being used) running and if that's the case it should quit (leaving the existing one untouched). Please note this design principle if you decide to implement your own Media Handler.

ITVC will maintain a separate idle connection to the Media Handler with the sole purpose of checking whether the Media Handler process is still running.
Communication Protocol

All communication is done using commands from the ITVC to a Media Handler. The data transfered is XML-like elements using regular ASCII characters for the tags. They are XML-like elements instead of regular XML because their format is very limited and strict in order to make the implementation of a command parser as simple as possible. No whitespaces is allowed inside or between the tags. All commands follows this syntax:

<command-name>param1|param2|param3|...</command-name>

Where command-name is the name of the command that is being issued and paramN is the command's Nth parameter. Parameters are separated by a vertical bar "|". For example: Every single byte between "<command-name>" and the first "|" is considered to be the first parameter.

All defined command names and parameter values are case sensitive (they should be lower case, more specifically).

If a command has no parameters, it will look like the following:

<command-name></command-name>

The collapsed format is not supported, so the following is invalid:

<command-name/>

When the execution of a command has finished, Media Handler replies with:

<result>value</result>

Where value is the result value. If a command succeeds, Media Handler will return the following ASCII string to ITVC:

<result>ok</result>

The result value "ok" means a successful command execution. Any value different than that means an error. An error result should be a terse english sentence in ASCII. When possible, a Media Handler should try to use one of the defined error messages.

{|
|+ Command result error messages
|-
! Error message !! Description
|-
| unknown command
| The command issued by ITVC is not known.
|-
| invalid parameters
| If Media Handler fails to parse or recognize one or more parameters of a command.
|-
| command failed
| Media Handler received a known command, with apparently valid parameters, but its execution failed.
|-
| aborted
| If the command was aborted during its execution.
|}

The communication that can happen between ITVC issuing a command and Media Handler replying the result varies according to the command that has been issued.

==Commands==

A Media Handler has the following commands:

=== fetch-info===

Gathers information from the specified media file and, optionally, creates a thumbnail of it.

Parameters:
1. Media's full file path.
2. Optional. Full file path of the thumbnail to be generated.

Example:

<fetch-info>/Users/foo/myvideo.mov|/Users/foo/myvideo_thumbnail.png</fetch-info>

Before sending the command result element, Media Handler will send one or more media properties complying with the following format:

<name>value</name>

Where name and value are set according to the following table:

{|
|+ Possible media properties
! name !! value
|-
| video-codec
| Video codec name.
|-
| audio-codec
| Audio code name.
|-
| fps
| Frames per second. A positive integer.
|-
| width
| Width in pixels. A positive integer.
|-
| height
| Height in pixels. A positive integer.
|-
| length
| Media duration in seconds. A positive integer.
|-
| file-size
| File size in bytes. A positive integer.
|-
| video-bit-rate
| Video bit rate (per second). A positive integer.
|}

Example session:

ITVC -> Media Handler:
<fetch-info>/Users/foo/myvideo.mov|/Users/foo/myvideo_thumbnail.png</fetch-info>

Media Handler -> ITVC:
<audio-codec>Ogg Vorbis</audio-codec>

Media Handler -> ITVC:
<length>182</length>

Media Handler -> ITVC:
<file-size>3072</file-size>

Media Handler -> ITVC:
<result>ok</result>

===transcode===

Converts the specified media file according to the given parameters saving the resulting file at the specified file path.

Parameters:
1. Input path. Full file path of the media that's going to be converted.
2. Output path. Full file path of the conversion result.
3. Width, in pixels, of the converted media file.
4. Height, in pixels, of the converted media file.
5. Preferred video compression technology.
6. Video data rate, in bits per second.
7. Audio data rate, in bits per second.
8. Video refresh rate, in frames per second.

If the video encoder specified in the fifth parameter is not available (or cannot be used for some reason), the Media Handler may fallback to a more convenient one without returning any error or specific feedback. This fallback action is considered a normal (although undesired) behavior.

The table below defines the valid values (along with their respective meanings) for the video compression parameter:

{|
|+ Video compression parameters
! Value !! Description
|-
| mpeg4
| MPEG-4 Part 2, Advanced Simple Profile (ASP)
|-
| h.264
| MPEG-4 Part 10, either Main or High Profile
|-
| theora
| Theora, from Xiph.org Foundation<ref>Note that the default codecs shipped with the ITVC do not support Theora as an output format. This parameter is there as a placeholder should a 3rd party developer actually implement Theora encoding in new codecs.</ref>
|}

<references/>

Example:

<transcode>C:\temp\myvideo.wmv|C:\temp\myconvertedvideo.mp4|400|240|mpeg4|350000|128000|24</transcode>

During the conversion, Media Handler will inform ITVC about the conversion progress by sending progress messsages at arbitrary time intervals. Those messages have the following format:

<progress>number</progress>

Where number is a positive integer from 0 (inclusive, meaning 0% done) to 10000 (inclusive, meaning 100% done).

When Media Handler sends a progress status message, it waits for a response from ITVC on whether it should continue converting or promptly abort the conversion. The progress reply from ITVC has the following format:

<progress-reply>value</progress-reply>

Where value can be either "proceed", meaning that Media Handler should proceed with the conversion, or "abort", meaning that the conversion should stop at once.

Example session:

ITVC -> Media Handler:
<transcode>C:\temp\myvideo.wmv|C:\temp\myconvertedvideo.mp4|400|240|mpeg4|350000|128000|24</transcode>

Media Handler -> ITVC:
<progress>204</progress>

ITVC -> Media Handler:
<progress-reply>proceed</progress-reply>

Media Handler -> ITVC:
<progress>510</progress>

ITVC -> Media Handler:
<progress-reply>proceed</progress-reply>

Media Handler -> ITVC:
<progress>948</progress>

ITVC -> Media Handler:
<progress-reply>proceed</progress-reply>

Media Handler -> ITVC:
<progress>1159</progress>

ITVC -> Media Handler:
<progress-reply>abort</progress-reply>

Media Handler -> ITVC:
<result>aborted</result>

===quit===

Makes Media Handler's process exit.

Example:

<quit></quit>

Here's a [[:Image:ITV_interaction_diagram.png | visual representation ]] of the interaction process between the ITVC GUI and the Media Handler process based on the above protocol. [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool]

[[Category:Development]]

Codenames

2011-12-15T03:15:30Z

114.79.28.10: /* Software */

Nokia hardware and software components have lots of codenames and abbreviations, this page describes what we know about these names.

== Release Table ==
{{Release history table}}

== Maemo ==
Starting from Bora the release names will be alphabetical, E and G have been excluded from this progression for various reasons (see [http://www.slideshare.net/qgil/nokia-and-Maemo-in-the-new-gnome-mobile-context/3 Presentation by Quim Gil at LinuxTag 2007]).

=== OS2006 ===
; Mistral - Maemo 2.0 : 1.2006.26-8
; Scirocco - Maemo 2.1 : Mainly bugfixes and some other enhancements. 2.2006.39-14
; Gregale - Maemo 2.2 : Bugfixes and enhancements.

=== OS2007 ===
; Bora - Maemo : 3.x 1.2006.47-20 (3.0), 3.2007.10-7 (3.1).

=== [[:Category:OS2008|OS2008]] ===
; Chinook - Maemo 4.0 : 1.2007.42-18, 1.2007.42-19, 2.2007.50-2 and 2.2007.51-3
; [[Open development/Maemo roadmap/Diablo|Diablo]] - Maemo 4.1 : 4.2008.23-14, 4.2008.30-2

=== Maemo 5 ===
; [[Open development/Maemo roadmap/Fremantle|Fremantle]] : current Maemo release

=== Announced releases ===

; [[Open development/Maemo roadmap/Harmattan|Harmattan]] : future Maemo release, to include bundled officially-supported Qt libraries

=== Historic names ===

; Sardine : Similar to Debian's Sid/Unstable, Sardine was an experimental distribution of the Hildon Application Framework for the OS2006 and OS2007, primarily of interest to developers who wish to test "bleeding edge" features that are being developed for future releases of Maemo. As components from Sardine stabilized, they moved into Herring. More information on the [http://sardine.garage.Maemo.org/ Sardine web page]. Sardine was [http://lists.maemo.org/pipermail/maemo-developers/2008-June/016119.html declared dead in June 2008].

; Herring : Was to Sardine as Debian Testing is to Debian's Sid/Stable, Herring was the stable branch of Sardine. Components were moved here to be prepared for release once they were feature complete.

; Elephanta : This would have been a release between Diablo and Fremantle, which was skipped in favor of bringing Maemo 5 out earlier (note the alphabetical order of releases starting with "Bora", "G" was skipped because of "Gregale") - some pages still mention it, for example [http://maemo.org/news/announcements/1184675758/] and [http://maemo.org/development/documentation/maemo-quick-start-guide.pdf]; [http://talk.maemo.org/showpost.php?p=374918&postcount=2 Explanation in the forums], [http://www.google.at/search?q=site:maemo.org+elephanta Google search of "elephanta" on maemo.org]

== Hardware ==

; Sputnik : Codename for 770 device. Reported [http://www.gossamer-threads.com/lists/maemo/developers/296?search_string=sputnik;#296 here] and [http://www.gossamer-threads.com/lists/maemo/developers/953?search_string=sputnik;#953 here]
; Soyuz : Codename for mysterious unreleased device, possibly slightly improved 770 (made obsolete by N800?). Mentioned in 2.6.16 linux kernel source for 770 when some support were added for newer hardware - 4 bit SD/MMC mode with faster 24MHz bus speed (with comment "Use faster MMC frequency on Soyuz") and LS0413Y LCD (used later in N800). So possibly this device had 770 features but full SD/MMC slot and better display.
; Gagarin : Codename for N800.
; Selene : Codename for N810.
; Rover : Codename for N900.
; Dali : Not yet known. [http://talk.maemo.org/showthread.php?t=67371 TMO thread] Recently (late 2011) OVI site refers to N9(50) as Dali devices
; SU-18 : 770
; RX-34 : N800
; RX-44 : N810
; RX-48 : [[Nokia N810WME|N810 WiMAX Edition]]
; RX-51 : [[Nokia N900|N900]]
; RX-71 : Not yet known. Device powered by an OMAP3. Possibly less keys (phone?). http://talk.maemo.org/showpost.php?p=268833&postcount=15 related TMO post]
; RM-680 : N950 [https://fjallfoss.fcc.gov/oetcf/eas/reports/ViewExhibitReport.cfm?mode=Exhibits&RequestTimeout=500&calledFromFrame=N&application_id=233837&fcc_id=%27LJPRM-680%27 FCC Link]
; RM-696 : N9

== Software ==

; bme (Battery Management Entity) : Is proxied to D-Bus via the bme-dbus-proxy daemon
; dsme (Device State Management Entity) : DSME mentions: [http://www.internettablettalk.com/forums/printthread.php?t=3129&pp=40] [http://maemo.org/platform/docs/howtos/howto_connectivity_guide.html]
; mce (Mode Control Entity) [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool]
; Retu and Tahvo (Fred and Barney) : "Retu" and "Tahvo" are apparently the Finnish equivalent of Fred and Barney from The Flintstones cartoon ([http://www.tsfs.fi/spin/leffat/flintstones2.shtml]/[http://www.imdb.com/title/tt0158622/]). Various sources indicate Retu is a custom ASIC chip that includes (at least) pseudo real-time clock control, GPIO/userspace interaction(?), power button control and a watchdog timer. The watchdog can be disabled by way of the <code>no-retu-wd</code> flag accessible from the [http://maemo.org/maemowiki/Flasher_tool_usage]. Tahvo is another ASIC(?) related to USB functionality. Retu mentions: [http://maemo.org/pipermail/maemo-users/2006-July/001553.html] [http://maemo.org/pipermail/maemo-developers/2006-January/002445.html][http://repository.maemo.org/sardine/armel/sardine/logs/6995-buildpackage] [http://www.internettablettalk.com/forums/printthread.php?t=3129&pp=40] [http://lists.freedesktop.org/archives/hal/2006-October/006437.html] [http://news.nopcode.org/doc/REN770] [http://www.math.ucla.edu/~jimc/nokia770/physical.html] Tahvo mentions: [http://repository.maemo.org/sardine/armel/sardine/logs/6995-buildpackage][http://www.internettablettalk.com/forums/printthread.php?t=3129&pp=40] [http://lists.freedesktop.org/archives/hal/2006-October/006437.html] [http://news.nopcode.org/doc/REN770] [http://www.math.ucla.edu/~jimc/nokia770/physical.html]
; wd (watchdog) : There are both hardware and software watchdogs / lifeguards that reboot the device in certain circumstances, e.g. excessive CPU usage; important process crashes; system lock up. If the watchdog does not receive a signal within a certain time, the watchdog triggers a system reboot. Some (all?) watchdogs can be disabled in [[R&D mode]].
; OSSO (Open Source Software Operations) : It was a department inside Nokia responsible for producing Maemo. It has been replaced by [[Task:Maemo brand#Definitions|Maemo Software]].
; NOLO (''No''kia boot''lo''ader) : The nolo appears to have a small built-in debug shell.

[[Category:Devices]]
[[Category:Software]]

RubyBox

2011-12-15T03:15:18Z

114.79.28.10: /* Links */

RubyBox is a DosBox frontend written in Ruby. It allows you to run old Dos games and applications easily.

== Features ==

* Categorize your games
* Change settings without editing config files
* Add new games either manually or use the automatic scanner
* Import and export game settings using the online database
* Download freeware games, virtual keyboard layouts and keyboard mapper files with the download feature

== Usage ==

=== First Run ===

At first you should open the RubyBox preferences and enable the online database. Just enter 'nakkiboso.com' as the address and use your nickname of choice as the nickname and press 'Ok' button.

=== Adding your own games ===

[[Image:Rbox_scanner.png|180px|right]]

Adding games is easy. Just copy the games you want to try to your tablet's memory cards. Then select 'Application scan' from the menu. Press the 'Scan' button and RubyBox will scan your memory cards. Available games are then listed. By default RubyBox adds all available games but you can deselect the games you don't want to add. You can also select the correct game executable by clicking on the executable name and selecting it from the dropdown list. If you have enabled the online database, you can also select the 'Try to import game settings' option. RubyBox will then automatically import game settings from the database if found. Finally add the selected games by clicking on the 'Add selected' button. Your added games appear under the 'Uncategorized' category.

=== Importing settings ===

Select a game and click on the 'Import' button. If the game has settings in the database, they are imported automatically. These only change the DosBox' settings and don't touch your personal settings.

=== Editing settings ===

[[Image:Rbox_settings.png|300px|right]]
Select the game you want to edit and press the 'Settings' button.

==== Name ====

Game name that is shown on the category list. You can change it to your liking.

==== Executable ====

If the games has several executables and you have selected a wrong one for example, you can change it here.

==== Category ====

You can add, rename and remove categogories and then categorize your games with them. Blank category means 'Uncategorized'.

==== XKBD Layout ====

N800 users need to use virtual keyboard for most games, so if you have an N800, you should install the xkbd package. This setting allows you to select different keyboards and position them on the screen. When selecting the location, remember to click somewhere on the screen before saving the changes or changes won't be saved. Download section has Addison's keyboard collection with more virtual keyboards.

==== Mapper ====

This will allow you to select a different keyboard mapper. Mappers will change the keyboard bindings of your hardware keys. You can download alternative mappers from the download section.

==== DosBox settings ====

DosBox settings are split into basic and advanced settings. If you need to change a setting, check the 'Enabled' checkbox for that setting and change the value. Only enabled settings are saved and the rest use the DosBox' default setting.

Save the game settings by clicking on the 'Save' button.

=== Exporting settings ===

If you have found the perfect settings for a game, you can click on the 'Export' button. Your settings are stored into the database so others can enjoy them too.

=== Downloader ===

[[Image:Rbox_downloader.png|200px|right]]

RubyBox allows you to install Freeware games and custom virtual keyboards and keyboard mapper files. Just click on the 'Download' button. You can select the type of download from the dropdown at bottom left. Click on the 'Update list' button and you get a list of available downloads. Some items have icons on their left. The wrench icon means the download has imported settings in the database. The image icon means the download has a screenshot which you can view by clicking on the 'Screenshot' button. If you want to download something, select the directory you want to download them to with the 'Browse' button. Only games and temporary files are stored there, keyboards and mappers are stored under your home directory. Click on the 'Download' button to start the download. RubyBox will automatically extract and add the game to your game list.

'Statistics' button shows the statistics of RubyBox like number of registered users, imported game settings and downloads.

== Links ==

* DosBox: http://www.dosbox.com/ [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool]
* DosBox at ITT: http://www.internettablettalk.com/forums/showthread.php?t=5686
* Games that work well with DosBox: http://www.internettablettalk.com/forums/showthread.php?t=15459

[[Category:Software]]
[[Category:Diablo]]

Terminal

2011-12-15T03:15:14Z

114.79.28.10: /* Further reading */

This page is for beginners to Linux that would like to try the terminal. Below are some basic commands you can use in the terminal app to get you started.

== Opening the terminal ==

=== N900 ===

# Navigate to the application menu
#* If using a firmware release older than [[Maemo 5/PR1.2|PR1.2]], navigate to ‘More...’
# Tap ‘X Terminal’

Alternatively, use the Ctrl+Shift+X key combination even without opening the application menu.

=== N800 and N810 ===

# Click the command button on the main page
# Select ‘Utilities’
# Select ‘X Terminal’

=== 770 ===
Terminal is not installed by default on the 770. You need to install it from the Application manager first. After that it will be available in the same menu as on the N8X0.

== Using the terminal ==

'''Before you start, backup your data'''
So long as your data is backed up, then you can start to try out the terminal without any fears of losing any data. This page does not cover gaining '[[Root access|root]]' on your device so you should come to no harm. If you are gaining root, then it would best to not only have a backup before you start tinkering, but also to familiarise yourself with how to reflash your device in extreme cases where you need to get back to where you started.

But don't be afraid of the terminal and command line, it can be a fast and powerful tool when used correctly and non-destructive commands will not harm your device or your data.

'''Understand what a command does before you type it'''
Fundamentally you should understand what a command does before typing it in and pressing enter. If you have a linux desktop distribution, like Ubuntu, you can normally type the command with the parameter <code>--help</code> to get a list of options, i.e. <code>ls --help</code>, or look up manual pages if installed, with:

man ls [enter]

to find out what the commands are and their options. However you can't do this on the tablets though as the tablets use cut down embedded commands, (BusyBox - I think?), so look at [http://ss64.com/bash Linux commands] or [http://www.busybox.net/downloads/BusyBox.html Busybox list of Linux commands and options for each one]

=== Basics ===

==== Basic commands ====

Some example commands, all here are non-destructive. Press enter after each command to execute it.

The terminal should open with a

~ $

To exit the terminal at any time type, exit and enter, so

~ $ exit

<code>echo</code> outputs/prints text to <code>stdout</code>:

~ $ echo "hello world"

hello world

Echo can also be used with variables, such as <code>USER</code>, which contains the current user’s username. Variables are prefixed with a '<code>$</code>':

~ $ echo $USER

user

Use <code>uname</code> to list the kernel version, and use the <code>-a</code> argument to output all known information:

~ $ uname -a

2.6.21-omap1

<code>cat</code> spits out an entire text file to terminal. <code>resolv.conf</code> (remember *NIX is case-sensitive) is where DNS servers are stored. The <code>#</code> hash/pound character is a [[:wikipedia:Comment (computer programming)|comment]], which means that the rest of the line is ignored.

~ $ cat /etc/resolv.conf

#nameserver 127.0.0.1

nameserver 192.168.1.1

#nameserver 4.2.2.2

Basic example of a variable:

~ $ foobar='example'; echo $foobar'''

example

Example of directing output to a file. Files stored in <code>/dev/shm</code> are stored directly in RAM and thus are deleted on shutdown:

~ $ uname -s > /dev/shm/os; cat /dev/shm/os

==== Tab autocompletion ====

In the bottom of the X terminal you find the "tab-key" (it does not exist on the hardware keyboard. The tab-key will autocomplete commands/directory/files when pressed. If you want to see what is in a specific directory you could double-tab. The tab function is a very good way and should be a habit. It not only makes using the terminal faster. It also makes sure you spelt everything correctly.
ls /home/opt/themes/sun[tab]
will finish the word as "<code>sunset</code>".
ls /home/opt/[tab][tab]
shows you what is in the <code>opt</code> folder, for example the "<code>themes</code>" folder

Another good tip is "ctrl+c". You will find Ctrl-key on the keyboard. Together with "c" it will cancel (interrupt) any previously given command (NOTE: can also be used in DOS terminals)
[Ctrl-key] c
For example, if you write "<code>find /</code>" it will start listing all the files on the N900. If you press ctrl+c it will stop.

=== Managing Files ===

==== Listing files ====
To list files in a directory type ls and hit enter, so

~ $ ls

To list files in a directory with permissions, owners, time, the use the long format with <code>ls</code>, which is <code>ls -l</code>:

~ $ ls -l

To list hidden files and directories

~ $ ls -la

To list all mp3 files on memory card mmc1

~ $ ls -l /media/mmc1/*.mp3

==== Copying files ====
To copy files use cp, so

~ $ cp file file2

This would make a copy of file and call it file2. Note that "file2" can be a whole other path (like <code>/home/user/MyDocs/afolder/file2</code>). If file2 already exists it will be overwritten.

You can also copy multiple files in one go, like so:

~ $ cp file1 file2 file3 /the/destination

Where the destination must be a directory.

==== Moving files ====
To move files use <code>mv</code>

~ $ mv file2 mydirectory/file2

moving file2 to mydirectory directory

You can also use <code>mv</code> to rename a file

~ $ mv file newname

But what happens if I want to copy stuff into the directory I am already in do I have to type out the whole directory tree again. Well you can but it is much simpler to do the following:

~ $ mv mydirectory/file .

The dot at the end of the command means the current directory.

You can also move multiple files in one go, like so:

~ $ mv file1 file2 file3 /the/destination

==== Removing files ====

To delete a file, use the <code>rm</code> command:

~ $ rm file

To delete a directory and all of its subdirectories and files, use the recursive option with <code>rm</code>:

~ $ rm -r directory

Be careful when you use the recursive delete, it will remove everything under the given directory without asking you for a confirmation.

==== Directories ====

To change directory use <code>cd</code>, so

~ $ cd MyDocs

To go back a level on a directory

~/MyDocs $ cd ..

To go back two levels on a directory

~ $ cd ../..

To go back three... I think you get the idea

By the way, the bit before the $, tells you the directory you are in. The symbol <code>~</code> means your home directory, however to find out which directory you are in

~ $ pwd

<code>pwd</code> stands for present working directory

To create a directory, use <code>mkdir</code>

mkdir mydirectory

And to remove an empty directory, use <code>rmdir</code>

rmdir mydirectory

=== Directory structure ===

One thing to note is the directory structure on a Maemo device. When you open the terminal on the device you are in the directory <code>/home/user</code> Equivalent to MyDocuments in Windows. The top level directory like C: drive on Windows is a <code>/</code> known as a root directory. Try and stay in the <code>/home/user</code> directory at first, or look at your memory cards which is in the directory <code>/media</code>. Further information about filesystem can be found at an article named [[N900 filesystem]].

=== Finding files ===

find /media -name "*.jpg"

Finds all files ending with a .jpg, i.e. photo files in <code>/media</code> directory, memory card. The <code>*</code> is a wildcard.

=== Wildcards ===

* <code>*</code> means any number (zero or more) of characters
* <code>?</code> means exactly one character
* <code>[a-d]</code> means exactly one character from the range 'a' to 'd' (ie 'a', 'b', 'c' or 'd')
* <code>[xyz]</code> means exactly one character from the set 'x', 'y' and 'z'
* <code>[a-ckp1-3]</code> means one of 'a', 'b', 'c', 'k', 'p', '1', '2' or '3' and so on...

So

find . -name "birthday?[bg]*"

Will find any files starting with birthday, followed by any one character, then either a lowercase b or g, with <code>*</code> meaning any other characters if any.

If you want to stop a search, or any command for that matter press and hold Ctrl and then press c:

<Ctrl> c

To find a word in a file you use <code>grep</code>. For example, if you want to find the word Maemo in file mydocument you type

grep "Maemo" mydocument

=== Opening tar.gz files ===

To open a tar.gz you need to unpack it, it is an archive file, like zip files. I recommend creating a new directory before unpacking, so

mkdir mynewdirectory
cd mynewdirectory/
tar -xvfz myarchive.tar.gz

This will unpack <code>myarchive.tar.gz</code> into <code>mynewdirectory/</code>

=== Starting a GUI application ===

Everything is run from a terminal in *NIX. A GUI program is a running instance of a terminal process. Therefore the camera program can be launched. The <code>&</code> (ampersand) tells the shell to run the command as a [[:wikipedia:Job control (Unix)#Unix shell|background job]]:

~ $ /usr/bin/camera &

=== Show disk usage in megabytes ===

~ $ du -m

To show disk (memory cards, etc.) partitions and their space

~ $ df -h

=== Show a list of installed packages ===

Show a list of all your programmes installed including those not visible in the Application Manager"

dpkg -l

=== Piping ===

You can do fancy things and link commands together with what is called a pipe (this symbol: | ). Press Chr on the [[Nokia N810|N810]] or Fn on the [[Nokia N900|N900]] to find the pipe | symbol. You can program the terminal to show the pipe symbol, by going to tools->settings and entering bar as a toolbar shortcut. What the pipe does is that it takes one program's output and gives it to another as input.

So using <code>du</code> with the sort command you can list files and sort in order of megabytes,

~ $ du -m | sort -r -n | more

<code>du -m</code> lists files in megabytes then pipes it to sort to sort it in order of megabytes, largest first, then the more command shows you one page of the screen at a time, pressing enter to show more pages.

Show Linux Kernel messages:

~ $ dmesg | more

<code>ps</code> lists running processes, you might also be interested in the interactive <code>top</code> command. Piped to <code>awk</code> which in this case says to only show the 5th column (separated by tab characters)

~ $ ps | awk '{ print $5 }'

/usr/bin/osso-xterm
/usr/libexec/gnome-vfs-daemon
bash
ps
awk

=== Networking ===

The user PATH does not include /sbin for some reason by default on NITs, which is annoying as you need to type in <code>/sbin/ifconfig</code> when normally just <code>ifconfig</code> would be sufficient. You can create a symlink to <code>/usr/bin</code> to make things easier:

~ $ ln -s /sbin/ifconfig /usr/bin/ifconfig

Example use of <code>grep</code>, which outputs the entire line matching the pattern, in this case "inet addr" which is piped into it from the output of <code>ifconfig</code>:

~ $ ifconfig | grep "inet addr"

This advanced example pipes from <code>ifconfig</code> to <code>grep</code> to <code>awk</code> and finally to <code>cut</code> to output the clean IP address which can then be fed into something else if desired:

~ $ ifconfig | grep "inet addr" | awk '{ print $2 }' | cut -d : -f2

=== Writing a shell function ===

A simple shell function that uses a variable and if/then/else logic:

~ $ minute() { foo=`date +%S`; echo $foo; if [ "$foo" -lt "30" ]; then echo "under half"; else echo "over half"; fi; }
~ $ minute

29
under half

Using the shell function we just wrote, outputs the current time in seconds (only the seconds part) and whether it is closer to the last minute or next minute. Shell functions are only available for the terminal session. Save in <code>.bashrc</code> or <code>.profile</code> to be persistent.

== Gain root access ==

You might need [[root access]] in order to make some advanced changes.

=== Debian package management ===

Update local metadata detailing what apps are available in the [[repository|repositories]]. This is important so apt-get can find the latest software:
apt-get update

Upgrade any installed apps with newer versions (the <code>-y</code> is optional and just avoids it prompting you as to whether or not to proceed):
apt-get upgrade -y

Remove any downloaded package archives. Once the package is installed the downloaded file is no longer needed. The Application Manager does this automatically but if you are using "apt-get" you'll have to do it manually:
apt-get clean

The same as "<code>apt-get clean</code>" but only remove package archives which are obsolete (no longer in repsitories). Having run "<code>apt-get clean</code>" it is pointless to run this command:
apt-get autoclean

Remove any packages which are no longer needed. These are applications/libraries which were automatically installed because of dependencies but are no longer required:
apt-get autoremove

Install any missing dependencies (which should fix the broken packages issue I had):
apt-get -f install

Search repositories for packages by keyword:

~ $ apt-cache search nano

nano-tiny - free Pico clone
traceroute-nanog - Determine route of packets
nano - nano editor

Install the <code>nano</code> package (an easy to use CLI text editor):

~ $ apt-get install nano

Instead of using the repos, use <code>wget</code> to download a .deb package from a website:

~ $ wget http://nitstuff.appspot.com/dists/chinook/user/binary-armel/nano_2.0.6_armel.deb

Install a locally-stored Debian package:

~ $ dpkg -i nano_2.0.6_armel.deb

== Further reading ==

There are infinite possibilities with the terminal, I'd recommend using google if you want to find out more or look at [http://www.busybox.net/downloads/BusyBox.html Busybox commands] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool] or [http://linuxcommand.org/learning_the_shell.php learning the shell]. Again to reiterate please make sure you backup your data before tinkering and when you want to try a new command, make sure you understand what it does first.

[[Category:HowTo]]
[[Category:Wiki page of the day]]
[[Category:Power users]]

N900 Resources

2011-12-15T03:15:10Z

114.79.28.10: /* Links to source that is relevant for Fremantle */

This page lists relavent resources and information that is of use in working with the binary blobs on the N900 Maemo Fremantle OS or otherwise working with the phone beyond the stock Nokia SDK.
==== Maemo.org Wiki pages ====
*[[Phone_control]] Information on how to use some of the dbus calls exposed by various parts of the phone software
*[[Wl1251-cal]] Information on some of what the closed-source wl1251-cal binary does
*[[N900_Software_BME]] BME related information
*[[Sources]] Links to various bits of N900 source code
*[[Telephony_Stack]] Random notes on how to talk to libisi and the CSD daemon
*[[Dialer]] Random notes on the Fremantle dialer
*[[ICD_Policy_Plugins]] Notes on the ICD2 policy plugins
*[[getbootstate]] Getbootstate - called from /sbin/preinit
*[[Fremantle_closed_packages]] Table which contains informations about all closed packages in Fremantle

==== Links to source that is relevant for Fremantle ====
*[http://gitorious.org/community-ssu/ Community SSU git repository, contains re-implementations of some Nokia closed binaries]
*[http://gitorious.org/maemo-5-certificate-manager/ Source code for the Maemo5 Fremantle certificate manager code]
*[http://talk.maemo.org/showthread.php?t=79957 Source code of PR1.0 Certificate control panel plugin]
*[http://maemo.gitorious.org/ Maemo git repos containing some of the Maemo source code]
*[http://meego.gitorious.org/meego-middleware/mce MCE source code from MeeGo] Won't work as-is on Maemo but still useful for reference.
*[http://meego.gitorious.org/meego-middleware/mce-dev Development headers that match the MCE source code]
*[http://meego.gitorious.org/meego-cellular/ofono/trees ofono source tree] Good as a reference to many bits of the N900 cell modem.
*[http://repository.maemo.org/pool/maemo5.0/free/ all officially open packages from Maemo Fremantle] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool]
*[http://mxr.maemo.org/fremantle/source/ all open source code/packages from Maemo Fremantle on Maemo Cross-Reference]
*[http://meego.gitorious.org/meego-device-adaptation/n900_libbme library for talking to BME] The oldest tree for this contains information that matches the Fremantle BME.
*[http://meego.gitorious.org/maemo-multimedia/ohm-plugins-misc/ ohm plugins] Some of these plugins (of various different trees) may contain useful info for Fremantle.
*[http://repository.maemo.org/rtcomm/pool/diablo/free/source/m/ Diablo MCE source code] May be useful for reference purposes
*[http://www.wirelessmodemapi.com/ Some documentation for the interface to the N900 cell modem]
*[http://maemo.org/packages/view/libhildon-extras1-time-zone-chooser-dev/ Header files for the hildon time chooser widget]
*[http://www.cncmods.net/files/mce.zip An attempt to match the MeeGo MCE source tree to Fremantle] Nothing works yet but it may be a good starting point.
*[http://www.cncmods.net/files/systemui.h Interfaces useful in creating a replacement touchscreen/keypad lock UI]
*[http://pastie.org/pastes/1150052/text header file with info on isi_info interface]
*[http://www.developer.nokia.com/info/sw.nokia.com/id/da8df288-e615-443d-be5c-00c8a72435f8/Qt_SDK.html Nokia QT SDK] Contains some header files for the N900 cell modem. Install the maemo bits and look for the usr/include/isi/icpr82 folder.
*[https://dev.openwrt.org/browser/packages/utils/calvaria Code for reading from the CAL area on the N900 phone]
*[http://meego.gitorious.org/meego-middleware/profiled Profile daemon - sources are compatible with Fremantle version]

==== Packages from the Fremantle SDK nokia-binaries containing useful information but which you may not know about ====
*wappushd-dev interface to wappushd daemon
*sharing-dialog-dev interface to sharing dialogs
*profile-data-dev dev headers for accessing profile data
*opengles-sgx-img-common-dev headers for the SGX drivers
*libgles2-sgx-img-dev headers for the SGX drivers
*libgles1-sgx-img-dev headers for the SGX drivers
*libcsnet-dev header files describing the interface to the Phone.Net Dbus interface used for cell network information (signal strength, cell site changes, operator name/code changes, 2G/3G changes etc). This one is missing dependencies so you will have to force it to install and ignore the dependencies.
*icd2-dev header files for icd2 daemon
*hald-addon-bme Documentation contains information on how to talk to the BME HAL (Hardware Abstraction Layer) interface.
*libcal-dev Interface to the configuration area on N900 phone.

==== Packages from the Harmattan SDK containing useful information not in the Fremantle SDK that may apply to Fremantle ====
*libsysinfo-dev development headers for the Harmattan version of libsysinfo.
*libicd2-dev development headers for the Harmattan version of libicd2.
*libicd-network-wlan-dev development headers for the Harmattan version of icd2 wlan plugin.
*libbmeipc-dev development headers for the Harmattan version of libbmeipc.
*icd2-osso-ic-dev development headers for osso-ic library

==== Packages from the N900 device repository containing useful information in their documentation folders ====
Because the /usr/share/doc bit is removed on the device, you will need to use apt-get to download the .deb and extract the files from that
*csd-gprs This pakage contains full documentation for the dbus interface in /usr/share/doc/csd-gprs
*csd-call This package contains some example code of how one might call libcscall in /usr/share/doc/csd-call/README.gz. Not that useful without headers for libcscall but may provide some tidbits of info

==== Mailing list posts of interest ====
*[http://lists.maemo.org/pipermail/maemo-developers/2011-June/028452.html Information on how to replace hald-addon-bme and libbmeipc as part of any BME replacements]
*[http://lists.maemo.org/pipermail/maemo-developers/2011-July/028472.html Details useful to replace the stock touchscreen keypad lock screen]

Maemo Summit 2008

2011-12-15T03:15:05Z

114.79.28.10: /* Accommodation */

[[image:C-logo_claim_blue.png‎|right]]
[[image:MaemoSummit091908.jpg‎ ]]

'''Join the first Maemo Summit'''

'''Berlin, September 19-20''' @ [http://c-base.org/ c-base] - right after the OSiM World http://www.osimworld.com

'''[https://maemo.org/news/events/registrations/register/2f91448248e711dd8bcbb7b26102ad49ad49.html Free registration]''' - '''[http://maemo.org/news/events/maemo_summit-001/ Who is attending]'''

In Maemo Summit 2008 you will learn more about Nokia's Linux platform and its evolution. Meet the core team, 3rd party professional developers and key community contributors. Showcase and discuss your work. Learn, share, hack. And have fun!

The [http://www.osimworld.com Open Source in Mobile World] conference is an interesting venue to know more about the business and technical context of the Maemo platform. Nokia is active in this event and invites the Maemo community to join it. After the conference we propose the first Maemo Summit calling to all contributors.

== Schedule ==

=== <center>Friday 19 ([http://internettabletblog.de/maemo-summit-friday.ics .ics])</center> ===
{| width="100%" border="1" cellpadding="5" cellspacing="0" bordercolor="#000000"
|+
|-
| width="112" | '''9:00'''
| colspan="3" | '''Doors open'''
|-
| '''9:30'''
| colspan="3" | '''Welcome!''', by [http://maemo.org/profile/view/jaaksi/ Ari Jaaksi] (VP - Maemo Software @ Nokia)
|-
| '''10:00'''
| colspan="3" | '''The outside view''', by [http://dailythemes.wordpress.com/ Jay Sullivan] ([http://www.mozilla.com/ Mozilla Corp.])
|-
| '''10:30'''
| colspan="3" | '''Maemo UI Vision''', by Harri Kiljander (Director, User Experience - Maemo Software @ Nokia)
|-
| '''11:00'''
| colspan="3" | '''What Maemo users want''', by [http://tabletblog.com/2008/05/3rd-anniversary-community-spotlight.html Reggie Suplido] ([http://www.internettablettalk.com/ Internet Tablet Talk])
|-
| '''11:30'''
| colspan="3" | '''Summary: What can we get out of Fremantle''' ([http://www.slideshare.net/silpol/maemo-community-fremantle-support-september-2008-presentation slides]) ([http://www.vimeo.com/1853196?pg=embed&sec=1853196 video]), by [http://maemo.org/profile/view/peterschneider.html Peter Schneider] (Head of Product Marketing, Maemo Software @ Nokia)
|-
| '''12:00'''
| colspan="3" | '''Break.'''
|-
| '''12:15'''
| colspan="3" | '''Lightning sessions''', 5 min each. No more, no less.
# '''Maemo in police cars''': presentation of an embedded project based on N800's [[User:smancke|Sebastian Mancke]]
# '''Developing Multilingual Multimodal Applications in Maemo'''. A Mobile Medical Speech Translator & A Mobile Meeting Calendar by [[User:ntsourak|Nikos Tsourakis]]
# '''[http://liquid.googlepages.com/lcuk liqbase]''', by Gary Birkett ([http://maemo.org/profile/view/lcuk.html lcuk])
# '''Reality or Vision?''' - The Nokia tablets for mobile and desktop use. LiveDemo/Presentation with [http://xsisusb.garage.maemo.org/ USB2VGA Adapter], bluetooth [http://anyremote.sourceforge.net/ anyremote] control by [http://www.linuxvision.de/ Uwe Koch]. ([http://maemo.org/profile/view/asys3/ asys3]) [http://www.linuxvision.de/nokia/maemoSummit2008-RealityOrVision.pdf Presentation slides] .
# '''Screencasting''': x11vnc and pyvnc2swf bring visual documentation to users by [[User:brontide|Eric Warnke]]
# '''[[Maemo User Interface Issues Overview (Presentation)|Maemo User Interface Issues Overview]]''', by [[User:Timsamoff |Tim Samoff]].
# '''[http://esbox.garage.maemo.org/ ESBox] and [http://pluthon.garage.maemo.org/ Pluthon] Eclipse plugins''': how to use Eclipse to develop Maemo applications, by [[User:andy80|Andrea Grandi]].
# '''[http://elisator.garage.maemo.org Elisator] project and how [http://easy.garage.maemo.org Easy] library has helped and how could be improved'''. Elisator has been developed for cow's health analisys based in [http://en.wikipedia.org/wiki/ELISA ELISA assays] in poor Africa's regions and it has been funded by [http://www.fao.org FAO]. [http://www.slideshare.net/jsmanrique/elisator-slides-for-maemo-summit-2008-presentation/ Slides] (by [[user:jsmanrique|jsmanrique]])
# '''Teaser: maemo development using [http://illumination.sf.net Illumination]''' by [[User:framstag|Tim Teulings]] ([http://www.anderenen.de/anderenende/Illumination_Maemo_Submit_2008.pdf Presentation slides]).
# '''[http://dev.openbossa.org/trac/qedje/ QEdje]''', by [[user:etrunko|Eduardo Lima (Etrunko)]].
# '''Maemo Bug Jar: Origins, Results, and Future Plans''', by Stephen Gadsby ([http://maemo.org/profile/view/sjgadsby/ sjgadsby]).
# '''Unit/Integration Test Framework for Maemo''' by [[User:aheimola|Antti Heimola]].
# '''[http://www.internettablettalk.com/forums/showthread.php?t=21629 Debian in a chroot on the tablet]''', demo by Alan Bruce (qole).
# '''[http://codespeak.net/pypy PyPy] Python for Maemo''' (by [[user:hpk|Holger Krekel]] and/or [[user:fijal|Maciej Fijalkowski]]).
|-
| '''14:00'''
| colspan="3" | '''Lunch!''' [[image:MaemoSummit_catering.jpg‎ ]]
|-
| rowspan="3" | '''15:00'''
| colspan="3" | '''Meet the Maemo SW developers''' (a representation of the main platform and OSS teams developing Maemo @ Nokia + special guests)
|-
| width="33%" | '''STREAM 1: ROOM UPSTAIRS'''
| width="33%" | '''STREAM 2: ROOM DOWNSTAIRS'''
| width="33%" | '''STREAM 3: C-BASE'''
|-
| width="33%" | '''Desktop''' by [http://maemo.org/profile/view/rodarvus/ Rodrigo Novo] (Nokia)
| width="33%" | '''Connectivity''' by [http://maemo.org/profile/view/kvalo.html Kalle Valo] and [http://maemo.org/profile/view/pfl.html Patrik Flykt] ([http://www.slideshare.net/pflykt/connectivity-maemo-summit-2008-presentation Connectivity slides] [http://stlc45xx.garage.maemo.org/stlc45xx-maemo-summit-2008.pdf WLAN slides])
| width="33%" | '''Development Platform''' by [http://maemo.org/profile/view/bijjal/ Soumya Bijjal], [http://maemo.org/profile/view/kaltsi/ Juha Kallioinen] (tbc), [http://maemo.org/profile/view/marcell/ Marcell Lengyel], [http://maemo.org/profile/view/qgil.html Quim Gil]
|-
| '''16:00'''
| width="33%" | '''Browser''' by [http://maemo.org/profile/view/andreypetrov.html Andrey Petrov], [http://maemo.org/profile/view/timeless.html timeless]
| width="33%" | '''Real-Time Communication''' by [http://maemo.org/profile/view/kh_naba/ Naba Kumar], [http://maemo.org/profile/view/mzabaluev/ Mikhail Zabaluev]
| width="33%" | '''Technology & Architecture''' by [http://maemo.org/profile/view/jtukkine/ Juha Tukkinen], [http://maemo.org/profile/view/bittinen/ Mika Leppinen]
|-
| '''17:00'''
| width="33%" | '''Core System''' by Kai Svahn (tbc), [http://maemo.org/profile/view/nakkebar/ Eero Tamminen], [http://maemo.org/profile/view/igor_stoppa.html Igor Stoppa], [http://maemo.org/profile/view/poussa.html Sakari Poussa]
| width="33%" | '''Multimedia''' by [http://maemo.org/profile/view/ensonic.html Stefan Kost], [http://maemo.org/profile/view/luc/ Luc Pionchon], ([http://www.slideshare.net/ensonic/maemo-multimedia-framework-presentation Slides])
| width="33%" | '''[[Desktop_Search_Hackfest|Desktop Search Hackfest]]''' link, by [http://maemo.org/profile/view/konttori/ Urho Konttori], [http://maemo.org/profile/view/ifrade/ Iván Frade] + Jamie McCracken (Tracker)
|-
| '''18:00'''
| colspan="3" | '''c-base reconstruction project³ - be future compatible- reboot universe now'''
*learn more about the crashed spacestation c-base ([http://maemosummit.ext.c-base.org/index.php/Videos Video])
|-
| '''18:30'''
| colspan="3" | '''Chill out.'''
* Dinner, music, drinks tbd.
* Dress code recommended: t-shirt with the maemo.org logo of [[Maemo.org_logo_contest_submissions|your choice]]. DISCLAIMER: can't be the winner logo. ;)
: Now that the new logo has been chosen, what exactly does this mean? --[[User:timsamoff|timsamoff]] 12:24, 5 August 2008 (UTC)
:: Wear a t-shirt with a maemo.org logo that you like from the competition. The official one isn't allowed ;) --[[User:xfade|xfade]] 14:47, 5 August 2008 (UTC)
::: what if you liked the official one? --[[User:dneary|Dave Neary]] 22:14, 6 August 2008 (UTC)
|}

{| width="100%" border="1" cellpadding="5" cellspacing="0" bordercolor="#000000"
|+

===Saturday 20===

Coordinated by [[User:brontide| Eric Warnke]]

|-
| width="53" | '''9:00'''
| colspan="3" | '''Opening doors''' and wlan.
|-
| '''9:30'''
| colspan="3" | '''[http://flors.files.wordpress.com/2008/09/howmaemooss.pdf How Maemo Approaches Open Source]''', by [http://flors.wordpress.com/ Quim Gil] (marketing manager, open source - Maemo Software @ Nokia)
|-
| '''10:00'''
| colspan="3" | '''Introducing the [[Community Council|Maemo Community Council]]''', by [[Community_Council|the members]].
|-
| '''10:30'''
| colspan="3" | '''"We are not the Users": The hate and love behind the custom User experiences on Maemo.''' [[User:handful|Marcelo eduardo]]
|-
| width="53" | '''11:00'''
| colspan="3" | '''BoF: Future of maemo.org extras''', by Niels (and Ed?) [http://www.slideshare.net/nbreet/maemo-extras-future-presentation Slides]
|-
| '''11:30'''
| colspan="3" | '''Lightning sessions''', 5 min each. No more, no less.
# '''WorldTV99''': Watching TV on your tablet by [[User:bunanson|bunanson]] and koos
# '''Cloud storage:''' Improve your app by syncing with internet services like Google Docs or Picasaweb by [[User:brontide|Eric Warnke]]
# '''Tablet-encode''': Converting videos on Linux using [http://mediautils.garage.maemo.org/tablet-encode.html tablet-encode], by Andrew Flegg ([http://maemo.org/profile/view/jaffa/ Jaffa])
# '''py2deb''': packaging your app onboard using py2deb and extras autobuilder [[User:khertan|Benoît HERVIER]]
# '''Podcasts on NITs''': [http://maemo.gpodder.org/ gPodder] and [http://thpinfo.com/2008/panucci/ Panucci] by ([http://maemo.org/profile/view/thp.html Thomas Perl])
# '''KDE on maemo''': by Marijn Kruisselbrink
# '''An activist’s wish list''': A location aware software suite to use in reporting, and forensic investigation of, human rights violations by [[User:tonypercy|Tony Percy]]
# '''mCalendar and mContact''': advanced syncing with google services [[User:khertan|Benoît HERVIER]]
|-
| '''12:15'''
| colspan="3" | '''Break'''
|-
| '''TRACKS'''
| width="33%" | '''Community/Discussion'''
| width="33%" | '''Development'''
| width="33%" | '''Core Platform'''
|-
| '''12:30'''
| width="33%" | '''Community story – Productivity suite in Nokia IT''', by Miika Kuha
| width="33%" | '''Packaging and publishing software??? (no show)''', Changed to: '''Maemo plugin for Anjuta DevStudio''', [http://maemo.org/profile/view/kh_naba/ Naba Kumar]
| width="33%" | '''libchamplain''': A Clutter/Gtk+ Map Widget for your application and maybe some Clutter demos :) by [[User:pierlux|Pierre-Luc Beaudoin]]
|-
| '''13:00'''
| width="33%" | '''[http://dev.openbossa.org/trac/mamona Mamona] & Maemo: 2 way contribution (How to learn and grow up together)''', by Mamona developers from INdT.
| width="33%" | '''Porting Applications and exploiting the maemo platform''' lead by [[User:anidel|Aniello Del Sorbo]] ([http://www.slideshare.net/anidel/exploiting-maemo-presentation/ Slides])
| width="33%" | '''maemo.org extras Package Cleanup Sprint'''
|-
| '''13:30'''
| width="33%" | '''[[Maemo User Interface Issues (Presentation)|Maemo User Interface Issues]]''', by [[User:Timsamoff |Tim Samoff]] + chat with Nokia Fremantle UI designers.
| width="33%" | '''Using [http://mud-builder.garage.maemo.org/ mud-builder] to build packages''', by [[User:Jaffa|Jaffa]].
| width="33%" | '''Maemo in QEMU N8x0 emulation:''' by [[User:hrw|Marcin 'hrw' Juszkiewicz]] ([http://blog.haerwu.biz/2008/09/20/maemo-in-qemu-n8x0-emulation-presentation/ materials to download])
|-
| '''14:00'''
| colspan="3" | '''Lunch!''' [[image:MaemoSummit_catering_day2.jpg‎ ]]
|-
| '''15:00'''
| width="33%" rowspan="2" | '''Workshop: Maemo hacking introduction''': coordinated by [[User:kate |Kate Alhola]]
| width="33%" | '''Embedded Webapps''' Using webpy framework for on tablet web services by [[user:fpp]]
| width="33%" | '''maemo.org website redesign meeting''': ([http://www.slideshare.net/nearyd/maemoorg-presentation-presentation presentation]) A meeting to specify the design requirements for restyling the maemo.org website (reference: [[Task:Improving_maemo.org#maemo.org_homepage_refresh|Homepage Refresh]] & [[Task:Maemo.org_facelift|maemo.org Facelift]]). by [[User:dneary|Dave Neary]]
|-
| '''15:30'''
| width="33%" | '''Introduction To Telepathy:''' Components and use on the maemo platform. by Marco Barisione from [http://www.collabora.co.uk Collabora]
| width="33%" | '''Introduction to DSP programming''' by [[User:lardman|Simon Pickering]]. Presentation [http://people.bath.ac.uk/enpsgp/nokia770/dsp/linux_summit.odp|here], expanded version to replace wiki page to follow.
|-
| '''16:00'''
| width="33%" | '''Building a Business on Maemo:''' by [[User:dob|Doug Petkanics]] from [http://frogmetrics.com Frogmetrics]
| width="33%" | '''Qt Maemo-Hildon Port & How to Develop Qt Application for the Maemo Platform''', by [[User:kate |Kate Alhola]] & [[User:gnuton |Antonio Aloisio]].
| width="33%" | '''BoF: Building a vector data extension to maemo Mapper''' Soliciting feedback and developers for the project. by [[user:gnuite]]
|-
| '''16:30'''
| width="33%" | '''[[User:Andre/Presentations|Bugsquad meeting]]''' Anybody interested in helping managing the Maemo bugs is welcome! Hosted by [[User:Andre|Andre Klapper]] and [[User:Karstenb|Karsten Bräckelmann]]
| width="33%" | [[Google Data API for Python (Presentation)|'''Introduction to Google's python based Data API's''']] by [[User:Brontide|Eric Warnke]]
| width="33%" | '''Introduction to WebKit''' Come see WebKit's internals, 2 of its ports (Gtk and Qt). by [[User:pierlux |Pierre-Luc Beaudoin]] from [http://www.collabora.co.uk Collabora]
|-
| '''17:00'''
| colspan="3" | [[2010 Agenda|'''Maemo 2010''']]: Brainstorming session discussing current status / future desires for the Maemo platform. Where do we want to go in the next 24 months? What can we learn and share from other mobile platforms? Bring the whole community together to get input.
|-
| '''18:00'''
| colspan="3" | '''End.''' '''Note: Software Freedom Day (20th of September) [http://softwarefreedomday.org/teams/europe/germany/FreieSoftwareBerlin also in Berlin]'''
|-
| '''20:00-24:00'''
| colspan="3" | '''Post-Summit Openismus Party''': [http://www.openismus.com Openismus] welcome you to their new office at Kastanienallee 88, with beer and pizza. [http://www.murrayc.com/blog/permalink/2008/09/20/openismus-party-tonight/ Directions]
|}

== Venue ==

The Maemo Summit is held in the headquarter of '''[http://www.c-base.org c-base]''' and the contiguous [http://www.eti-berlin.de/ eti Schauspielschule Berlin].

c-base is a non-profit association which has about 300 members. The purpose of this association is to increase knowledge and know-how regarding computer software, hardware and data networks ([http://en.wikipedia.org/wiki/C-base more]). eti Berlin is a school of actors based in a building with several rooms and a total surface available of 1.200m2. The perfect mix, full of creativity!

See [http://share.ovi.com/channel/qgil.public the videos].

c-base is in the very Mitte of Berlin. [http://maps.google.co.uk/maps?ie=UTF-8&oe=utf-8&rls=com.ubuntu:en-GB:unofficial&client=firefox-a&um=1&q=c-base&near=Berlin,+Germany&fb=1&cid=0,0,5828762841994571845&sa=X&oi=local_result&resnum=1&ct=image Map]

== Participants ==
'''[https://maemo.org/news/events/registrations/register/2f91448248e711dd8bcbb7b26102ad49ad49.html REGISTER]'''

It's the first Maemo Summit and it is good to know in advance who plans to attend, to fine tune practicalities and have enough space, connection, drinks, food.

Yes, the entrance is free. Registration is still requested for planning purposes.

== Travel ==
See [[Maemo_Summit_2008/Travel|when people are arriving in and leaving Berlin]].

[[Talk:Maemo_Summit_2008#Travel|Apparently]] there are options as affordable as 20€ including taxes from Stansted! [[Talk:Maemo_Summit_2008#Travel|Share your travel tips]] from different locations.

== Accommodation ==
See [[Maemo Summit 2008/Accommodation]] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool].

== Sponsoring community contributors ==

See [[Maemo Summit 2008/Sponsorship]].

== Maemo in the OSiM program ==
See [[Maemo in OSiM World 2008]].

== Organization ==
See [[Maemo_Summit_2008/Organization]]. Volunteers needed!

== Streaming video ==
Since nearly all of the attendees are carrying internet-connected video cameras, it is possible that someone may find a way to stream live video of the event. ([https://bugs.maemo.org/show_bug.cgi?id=1889 Bug 1889] makes this harder, but it should still be possible...)

== Links ==

Feel free to share/spread/forward/email...

* [http://upcoming.yahoo.com/event/839617/ Maemo summit on Upcoming!]
* [http://www.facebook.com/event.php?eid=16582874206 Maemo summit on Facebook - requires FB registration]
* [http://www.internettablettalk.com/forums/showthread.php?t=21569 Maemo summit discussion at Internet Tablet Talk]
* [http://lwn.net/Calendar/Monthly/2008-09/ LWN Calendar]
* [http://www.flickr.com/groups/maemosummit2008/ Flickr Photo Group Pool: maemo summit 2008]

[[Category:Maemo Summit 2008]]
[[Category:Community]]
[[Category:Events]]

Firefox mobile

2011-12-15T03:15:00Z

114.79.28.10: /* beta 4.b4 */

Firefox mobile, "Fennec" which Mozilla uses as its project code name, is a mobile browser that uses the same engine as the popular desktop version. Unlike MicroB, which is also based on Firefox, supports tabbed browsing but can take longer to initially start.

==Versions of Firefox Mobile==

Nightly/trunk/minefield versions are updated every day and can contain all sorts of bugs, features and improvements.

Beta versions are more ready for general users, but they might contain some bugs, which should be reported by beta testers so that they would be fixed, and stable version released after beta was - stable.

Chinook is Maemo 3 version.

[[Open development/Maemo roadmap/Diablo|Diablo]] is Maemo 4 version.

[[Open development/Maemo roadmap/Fremantle|Fremantle]] is Maemo 5 version.

GTK+ is default cross-platform widget toolkit, which is slowly replaced by Qt cross-platform application framework.

For instance, default application on Maemo 5 are based on GTK+, and at the same time Maemo 5 includes Qt which can be used by additional applications. MeeGo is based on Qt, and GTK+ is included for compatibility.

Firefox mobile, Qt-based, is default browser for MeeGo Handset UX.

Now, the list of Firefox mobile versions.

===Stable 1.1===

* chinook [http://ftp.mozilla.org/pub/mozilla.org/mobile/releases/latest/maemo/en-US/dists/chinook/release/binary-armel/ Latest chinook release]
* fremantle [http://ftp.mozilla.org/pub/mozilla.org/mobile/releases/latest/maemo/en-US/dists/fremantle/release/binary-armel/ Latest fremantle release]

===beta 4.b4===

* fremantle
** [http://ftp.mozilla.org/pub/mozilla.org/mobile/releases/latest-beta/maemo/en-US/dists/fremantle/release/binary-armel/ Latest beta fremantle release]
** [http://ftp.mozilla.org/pub/mozilla.org/mobile/releases/latest-beta/maemo5-gtk/en-US/ Latest beta Maemo 5 GTK+ release] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [http://goo.gl/ggQRY 4shared] [http://goo.gl/U6h6e gemscool]

Actually, I believe there is no difference between these two links.

===nightly 4.b5pre===

* fremantle-qt [http://ftp.mozilla.org/pub/mozilla.org/mobile/repos/trunk_en-US/dists/fremantle-qt/extras/binary-armel/ Latest nightly (trunk) fremantle qt release]
* fremantle [http://ftp.mozilla.org/pub/mozilla.org/mobile/repos/trunk_en-US/dists/fremantle/extras/binary-armel/ Latest nightly (trunk) fremantle (gtk) release]

===nightly 1.1b2pre===

* chinook [http://ftp.mozilla.org/pub/mozilla.org/mobile/repos/1.9.2_en-US/dists/chinook/extras/binary-armel/ Latest nightly (trunk) chinook release]
* fremantle [http://ftp.mozilla.org/pub/mozilla.org/mobile/repos/1.9.2_en-US/dists/fremantle/extras/binary-armel/ Latest nightly (trunk) fremantle release]

==Firefox Settings==

There are two ways to change the settings for Firefox. One is through the settings menu which can be accessed by dragging a webpage to the left and clicking on the cog icon near the bottom right. The other is through "<code>about:config</code>" which allows you to further customize your Firefox configuration.

===Disabling Portrait Mode===
'''This is not working on January 2011''' (on fennec4-b4). Check status on: https://bugzilla.mozilla.org/show_bug.cgi?id=625350

# Press (shift+ctrl+o) to lock/unlock orientation (you will see notification)
OR
# In the location bar (Awesomebar) enter "<code>about:config</code>" and press enter.
# Use the search bar to find the entry below:<pre>toolkit.screen.lock</pre>
# change it to <code>true</code>

===Disabling Auto-Zoom===

====On Input Box====

# Open page:<pre>about:config</pre>
# Find setting:<pre>formhelper.autozoom</pre>By default, it is set to true.
# Set it to false.

====On Find====

# Open page:<pre>about:config</pre>
# Find setting:<pre>findhelper.autozoom</pre>By default, it is set to true.
# Set it to false.

===Enabling Flash===

Firefox mobile has a flash plugin which is disabled by default for stability and speed. It can however be enabled by following these instructions

<ol>
<li>
In the location bar (Awesomebar) enter "about:config" and press enter. You should now also see a search bar below the location bar
</li>
<li>
In the search bar enter "plugin.d" and you should see the two entries below
<pre>
plugin.default_plugin_disabled
plugin.disable
</pre>
</li>
<li>
change both these entries to false and restart Firefox Mobile
</li>
</ol>

you should now have flash enabled.

==Copy and Paste Text==

Firefox Mobile does allow you to copy and paste text. Unlike MicroB you CANNOT enter a text selection mode by swiping to the right from off screen to onscreen. To select text in Firefox mobile you must click on the position where you want to start highlighting text. Nothing will appear to have happened but an invisible cursor is placed where you have clicked. Now press

Shift + Left Arrow : to start highlighting left of the cursor

or

Shift + Right Arrow : to start highlighting right of the cursor

Up and Down do not work. To copy the selected text you must perform the standard copy hotkey (Ctrl+C). Hotkeys for Firefox Mobile are shown below.

==Hotkeys==

This is a list of known hotkeys for Firefox Mobile. Hotkeys are very similar to the desktop version but there are some differences.

* Ctrl + W : Close Tab
* Ctrl + T : New Tab
* Ctrl + R : Reload page
* Ctrl + L : Location bar (AwesomeBar)
* Ctrl + C : Copy
* Ctrl + X : Cut
* Ctrl + V : Paste

[[Category:Web]]
[[Category:Fremantle]]
[[Category:OS2008]]
[[Category:Diablo]]

Evopedia

2011-12-15T03:12:50Z

114.79.28.10: /* Tweaks */

Evopedia is an offline Wikipedia viewer. It allows to search for articles based on their title or the geographic location on a map. If there is a connection to the internet, even images are displayed.

'''The information here is partly outdated. Please visit the
[http://evopedia.info project website].'''

== Dumps ==

'''BitTorrent'''

Since downloads of the dumps caused 2 TB of data transfer on the server in one week, the big dumps are now only available via BitTorrent. Please install a [http://www.bittorrent.com BitTorrent client] (if not already installed on your system) to use the .torrent files.

'''New dumps:'''
* [http://dumpathome.evopedia.info/dumps/finished List of dumps]

Note that you need evopedia version 0.3.0 (NOT 0.3.0 RC 3) for the search function to work properly for languages not based on the latin alphabet.

Dumping Wikipedia is a very time-consuming task. Please be patient or [http://dumpathome.evopedia.info/contribute help creating the dumps].

Please report if you find errors in the dumps.

'''Distributed dump processing'''
* [http://dumpathome.evopedia.info/ Distributed dumping for evopedia at dumpathome].

== Dump Installation ==

Extract one (or more) of the .zip-Files to your device and select it from within evopedia. The dump that is used can be changed using the (second) link at the top-left of the search screen.

Note that you cannot directly download dumps greater than 4 GB onto your device (FAT file size limitation). Please download it to a computer with a non-FAT filesystem and then unzip it directly onto your device (via USB for example).

== Tweaks ==

Evopedia creates a configuration file at <code>/home/user/.evopediarc</code> when it is first started. Most of the options are self-explanatory.

By changing listen_address to 0.0.0.0 you (or anybody else, so be careful) can also access evopedia from a different computer using the url http://<ip adress of your device>:8080/

maptile_repositories is a string that specifies which map types are available and where the tile images are stored. If it is empty, tiles are not stored at all and only OpenStreetmap is available. If this is not done automatically, you can set it to

maptile_repositories = [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [OpenStreetMap I|http://tile.openstreetmap.org/%d/%d/%d.png|/home/user/MyDocs/.maps/OpenStreetMap I/|0,OpenStreetMap II|http://tah.openstreetmap.org/Tiles/tile/%d/%d/%d.png|/home/user/MyDocs/.maps/OpenStreetMap II/|0,OpenCycleMap|http://c.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/home/user/MyDocs/.maps/OpenCycleMap/|0,Public Transport|http://tile.xn--pnvkarte-m4a.de/tilegen/%d/%d/%d.png|/home/user/MyDocs/.maps/Public Transport/|0]

(without line breaks) to use the files also used by maep.

== Creating a Wikipedia Dump ==

'''Please consider joining the distributed dump system mentioned above. Also, the information below is a bit outdated.'''

Creating a Wikipedia dump is unfortunately a rather lengthy process (some days). If you have any suggestions for speeding it up, please step forward. Concerning space, 20 GB should be enough for creating the dump.

For the advanced users, note that the process can be distributed over many computers by calling dumpWiki with the slice number to process on each computer.

==== 1. install needed software (please add packages if I forgot some): ====

apt-get install php5-cli php5-mysql python mysql-server mysql-client wget zip tidy git-core texlive texlive-math-extra

On some distributions, texlive must be replaced by tetex and texlive-math-extra by tetex-extra

==== 2. download evopedia source code ====
git://gitorious.org/evopedia/evopedia.git

Note: '''Please don't use the github address anymore, it's deprecated:'''
<strike>git clone git://github.com/crei/evopedia.gitr (deprecated) </strike>

==== 3. adjust settings ====

Set php's memory_limit to some higher value (128 MB) in <code>/etc/php5/cli/php.ini</code> (or similar)

Create empty mysql database and grant all rights to some user -
e.g. for database named ''wikidb'', user ''thomas'' and password ''x1lx'':
> mysql -p
mysql> create database wikidb;
mysql> grant all privileges on wikidb.* to thomas@localhost identified by 'x1lx';

Edit paths and database settings in <code>dumpscripts/createdump.sh</code>
(especially: dbuser, password, REPODIR, DUMPDIR) - make sure DUMPDIR points to area with plenty of space

Change the dump language ("de" in "for" statement at bottom of dumpscripts/createdump.sh)

Make <code>~/evopedia/evopedia/evopedia/*.py</code> files executable (chmod a+x ...).

==== 4. start the dump process ====

call <code>createdump.sh</code>

(Don't be too optimistic though. After part of the day the database is filled with several gigabytes of downloaded wikipedia content, but something is broken and the final dump gives no results.)

[[Category:Software]]

Red Pill mode

2011-12-15T03:12:45Z

114.79.28.10: /* Activating */

{{ambox|text=Red Pill functionality has been removed from the Hildon Application Manager GUI Maemo5 51-1 forwards. It can be enabled manually [[#activating|as shown below]].}}

An installable package, Fapman aka [http://maemo.org/packages/view/fapman/ Faster Application Manager], though, still allows access to packages outside of user/* .

'''Red Pill''' is an Application manager mode that disables certain safety features, and allows access to certain additional settings. It changes the way Application manager behaves, primarily by removing many of the safety locks that prevent users from installing harmful packages, or upgrading or replacing important system packages (which can result in reboot loops). It also hides packages that aren't relevant to users, and shows additional settings to tweak specific behaviors (like whether to cache packages to the internal memory card during installation).

'''WARNING''': Red Pill is ''not intended'' for use by users, power-users, nor the vast majority of developers. Red Pill mode is ''very likely'' to break your tablet and should not be used unless you know ''exactly'' what you are doing.

== Safety locks ==

In Blue Pill mode (the normal operating mode), Application manager has many safety locks in place to reduce the risk of the user accidentally damaging their tablet by installing harmful packages. Red Pill mode disables these locks.

== Visible packages ==

Normally, only packages in a user/* section will be displayed in the Application manager, but when Red Pill mode is enabled, packages outside of user/*, and magic packages will also be displayed. Packages outside of user/* are generally of no concern to the average user, as they will either be pulled in as dependencies for packages which ''do'' concern the user, or installed from Xterm with <code>apt-get</code>.

Packages outside of user/* will not be backed up for reinstallation by Backup/Restore.

== Settings ==

; Clean apt cache : If activated, the equivalent of "apt-get clean" is performed after every install or update. (This is the default behavior for blue-pill mode.) Contents of the downloaded .deb files can be found in: /home/user/MyDocs/.apt-archive-cache/
; Assume net connection : This will not ask for an active IAP before downloading. This is useful if you have a network connection, but the tablet connectivity APIs are not available or don't know about it.
; Break locks : This will break needed locks instead of failing. This is done by default in blue pill mode so that users don't lock themselves out when a crash leaves a stale lock behind.
; Show dependencies : This adds another tab to the details dialog with some dependencies from the package.
; Show all packages : This will not filter out packages that are not in the "user" section. It will also allow installing packages from any section. When enabled this will show free Ovi Store packages.
; Show magic system package : This will include the "magic:sys" package in the list of packages. Updating that package will do something similar to "apt-get upgrade". It is not yet fully defined what it will do exactly. This feature might become available in blue-pill mode at one point.
; Include package details in log : When this setting is active, opening a package details dialog will dump its content into the Log so that you more easily save it. This should be useful when reporting complicated dependency issues. This setting can only be changed in Red Pill mode, but it's effect stays active also in Blue Pill mode.
; Use MMC to download packages : If activated, all the packages will be downloaded to a temporary directory in an available MMC with enough free space, then installed in the flash memory. The MMC's are considered in order: first the internal MMC and then the removable MMC, If no MMC is available, or no MMC has enough free space, the internal flash memory will be used as usual. Using this option is useful to install/upgrade packages when there's enough free space at the root filesystem to install, but not to download plus install/upgrade, so you can use an alternative storage just to download such those packages. This option is enabled by default.
; Always check for updates : Activating this setting removes the refresh button from the toolbar and instead performs a "Checking for updates" operation everytime you switch to the "Browse installable applications" or "Check for updates" view. This settings was added for some quick UI experiments, but we kept it afterward. You need to restart the Application manager for this setting to take effect.
; Ignore packages from wrong domain : Usually, a package from a wrong domain will be completely ignored by the Application manager. Deactivating this setting will not ignore these packages. However, When actually installing a package from a wrong domain, a warning message will still be displayed and you need to confirm that installation should proceed. You need to restart the Application manager for this setting to take effect.

== Activating ==

'''Red Pill mode has been removed from the GUI in the 1.2009.44-1 [[Nokia N900|N900]] firmware. It can be enabled on future firmwares by editing the configuration file for HAM using terminal.'''

For the vast majority of people, using Red Pill is inadvisable. Please don't use it unless you know exactly what you are doing.

To enable Red Pill mode through HAM on old firmwares:
* Open Application manager and go to "Tools -> Application catalogue"
* Click "New"
* Type "matrix" into the "Web Address" field
* Click "Cancel" (N900: tap outside the window)
* Tap "Red" in the dialog to enabled Red Pill mode, or "Blue" to keep the Application manager as-is or [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] to disable Red Pill.

N900: The Red-Pill mode is not persistent after being enabled. Closing the Application manager, disables Red Pill.

To enable Red Pill mode in [[Maemo 5/PR1.1|51-1 (PR1.1)]] onwards:
* Close Hildon Application Manager if you have it opened.
* Open Terminal. Note that you can use your favorite editor to do this, vi is used for this tutorial as it is preinstalled on the N900. '''Under [[Maemo 5/PR1.2|PR1.2]] this file is not available, so one has to add the two relevant fields below for it to work.'''
* Type <pre>vi /home/user/.osso/hildon-application-manager</pre> press I to enter input mode.
* Change <pre>red-pill-mode 0</pre> to <pre>red-pill-mode 1</pre>.
* Change <pre>red-pill-permanent 0</pre> to <pre>red-pill-permanent 1</pre>.
* Press CTRL+C to exit input mode, type <pre>:w</pre> and press enter to save and <pre>:x</pre> to exit.
Red pill mode will stay on till the steps are reversed.

[[Category:Power users]]

Fremantle Stars

2011-12-15T03:12:40Z

114.79.28.10: /* Alpha/Beta quality */

== Status of Fremantle Stars and other great apps ==

You have an interesting Fremantle project. You want to have it ready by the [[Open development/Maemo roadmap/Fremantle|Maemo 5]] final release. You are willing to get help and promotion from Nokia. List your project here with the current status and the related links.

[http://maemo.org/news/announcements/0eb8fdfeedec11ddb28e1b3c4d7b308a308a/ Fremantle Stars] projects are encouraged to report here, but any other project can join as well. If your project rocks we will help you as well.

* Roadmap - A list of features and improvements planned for Fremantle, so everybody gets an idea on what to expect and what to look for when testing[http://talk.maemo.org/showpost.php?p=296871&postcount=33]
* [[Bugs:Adding_Extra_products|HOWTO: Adding your product to bugs.m.o]]
* '''-devel''' means [http://repository.maemo.org/extras-devel/pool/fremantle/ Extras-Devel for Fremantle] (Upload via [https://garage.maemo.org/extras-assistant/ Extras Assistant])
* maemo-testing doesn't exist yet [http://talk.maemo.org/showpost.php?p=295552&postcount=8]
* Extras - also does not exist yet
* Downloads means you have a proper page at http://maemo.org/downloads [http://talk.maemo.org/showpost.php?p=295552&postcount=8]
* Showstoppers - Major problems blocking your development progress. If you need help from others shout here.

{| class="wikitable"
| style="background:LightGreen" | Mission complete!
| style="background:LightBlue" | Beta in progress
| style="background:Gold" | Too alpha
| style="background:Crimson" | Broken, can't test
| | Missing, can't evaluate
|}

{| class="wikitable sortable"
|-
! Project
! Roadmap
! bugs.m.o
! -devel
! -testing
! extras
! Downloads
! Showstoppers
|- style="background:LightBlue"
| [http://maemo.org/downloads/product/OS2008/ecoach eCoach] || [[Fremantle_Stars/eCoach|yes]] ||[https://bugs.maemo.org/enter_bug.cgi?product=eCoach Yes]||
[http://repository.maemo.org/extras-devel/pool/fremantle/free/e/ecoach/ Yes]
|| - || - || [http://maemo.org/downloads/product/OS2008/ecoach/ Yes] ||
|- style="background:LightBlue"
| [http://maemo.org/downloads/product/OS2008/enigma Enigma] || done || | [https://bugs.maemo.org/enter_bug.cgi?product=enigma Yes] ||
[http://repository.maemo.org/extras-devel/pool/fremantle/free/e/enigma/ Yes]
|| - || - || [http://maemo.org/downloads/product/OS2008/enigma/ Yes] || It works! But gets the app/device frozen sometimes and the screen is dimmed sometimes while playing
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/fbreader FBReader] || - || No || [http://repository.maemo.org/extras-devel/pool/fremantle/free/f/fbreader/ Yes] || Not ready - not installable || ? || ? || libfribidi0 missing due to SDK/image inconsistency
|- style="background:LightBlue"
| [http://maemo.org/downloads/product/OS2008/gpxview GPXView] || Mostly done, internal map still under development || | No ||
[http://repository.maemo.org/extras-devel/pool/fremantle/free/g/gpxview/ Yes]
|| - || - || [http://maemo.org/downloads/product/OS2008/gpxview/ Yes] ||
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/liqbase liqbase] || [[Fremantle_Stars/liqbase|yes]] || soon || No, only liqbase-playground || Not ready - missing || asap || asap || packaging broken and layout styling - liqbase-playground av available, but that is not the real app.
|- style="background:LightBlue"
| [http://maemo.org/downloads/product/OS2008/mauku Mauku] 2.0 Application
|| Totally new Fremantle UI
|| [https://bugs.maemo.org/enter_bug.cgi?product=Mauku yes]
|| [http://repository.maemo.org/extras-devel/pool/fremantle/free/m/mauku/ yes]
|| Almost... || n/a
|| [http://maemo.org/downloads/product/OS2008/mauku Yes]
|| None (only small bugs and feature enhancements that are being worked)
|- style="background:LightBlue"
| [http://maemo.org/downloads/product/OS2008/mauku Mauku] Widget
|| Desktop Widget is ready!
|| [https://bugs.maemo.org/enter_bug.cgi?product=Mauku yes]
|| [http://repository.maemo.org/extras-devel/pool/fremantle/free/m/mauku-widget/ yes]
|| Yes, assuming connection with app works || n/a
|| [http://maemo.org/downloads/product/OS2008/mauku Yes]
|| None (only minor finishing)
|- style="background:LightBlue"
| [http://microfeed.org Microfeed]
|| Separate D-BUS-based backend library for Mauku
|| [https://bugs.maemo.org/enter_bug.cgi?product=Microfeed yes]
|| [http://repository.maemo.org/extras-devel/pool/fremantle/free/m/microfeed/ yes]
|| Yes... || n/a
|| [http://maemo.org/downloads/product/OS2008/mauku Yes]
|| None (beta testing) - Being a backend shouldn't appear in AM? Yes, it should, or it cannot be updated independently (blame the AM, please). Qaiku really works? Yes, it should.
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/numptyphysics NumptyPhysics] || - || ? || Yes || Not ready - unusable || ? || ? || Wrong startup and doesn't go further than BRAVO! screen. Once this raw testing package is available it will help to concentrate efforts and allow people to work on layouts.
|- style="background:LightBlue"
| [http://maemo.org/downloads/product/OS2008/omweather OMWeather] || [[Fremantle_Stars/OMWeather|Yes]] || [https://bugs.maemo.org/enter_bug.cgi?product=OmWeather Yes] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/o/omweather/ Yes] || Yes || n/a || [http://maemo.org/downloads/product/OS2008/omweather Yes] || None.
|- style="background:Gold"
| [http://maemo.org/downloads/product/OS2008/osm2go OSM2Go] || [http://wiki.openstreetmap.org/wiki/Osm2go#What.27s_next.3F Yes] || |[https://bugs.maemo.org/enter_bug.cgi?product=osm2go Yes]||
[http://repository.maemo.org/extras-devel/pool/fremantle/free/o/osm2go/ Yes]
|| Ready with some limitations (which are these?) || - || [http://maemo.org/downloads/product/OS2008/osm2go/ Yes] ||
|-
| [http://maemo.org/downloads/product/OS2008/vagalume Vagalume] || No || Soon || No || Not ready - missing || ? || [http://maemo.org/downloads/product/OS2008/vagalume Yes] || -
|- style="background:LightGreen"
| [http://maemo.org/downloads/product/OS2008/gpodder gPodder] || [[Fremantle Stars/gPodder|Yes]] || [https://bugs.maemo.org/enter_bug.cgi?product=gPodder Yes] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/g/gpodder/ Yes] || [http://maemo.org/packages/view/gpodder/ Yes] || - || [http://maemo.org/downloads/product/OS2008/gpodder Yes] || Works [http://talk.maemo.org/showpost.php?p=311921&postcount=38 according to qgil]
|-
| [https://garage.maemo.org/projects/easy-deb-chroot/ Easy Debian] || - || no || no || - || - || [http://maemo.org/downloads/product/OS2008/easy-deb-chroot Yes] || mount and chroot commands don't work in SDK (no permissions)
|- style="background:LightGreen"
| [https://garage.maemo.org/projects/conboy Conboy] || [http://conbpoy.garage.maemo.org/ Yes] || [https://bugs.maemo.org/enter_bug.cgi?product=Conboy Yes] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/c/conboy/ Yes] || [http://repository.maemo.org/extras-testing/pool/fremantle/free/c/conboy/ Yes] || - || [http://maemo.org/downloads/product/OS2008/conboy Yes] ||
|-
| [http://maemo.org/downloads/product/OS2008/bluemaemo/ BlueMaemo] || [http://www.valeriovalerio.org/?page_id=174 Yes] || [https://bugs.maemo.org/enter_bug.cgi?product=BlueMaemo Yes] || [http://maemo.org/packages/view/bluemaemo/ Yes] || - || - || [http://maemo.org/downloads/product/OS2008/bluemaemo/ Yes] || UI under development, waiting for feedback
|-
| [http://maemo.org/downloads/product/OS2008/pwsafe/ PasswordSafe] || No || [https://bugs.maemo.org/enter_bug.cgi?product=PasswordSafe Yes] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/p/pwsafe/ Yes] || - || - || [http://maemo.org/downloads/product/OS2008/pwsafe/ Yes] || Need someone to test it on a real device ...
|-
| [http://maemo.org/downloads/product/OS2008/tabletbridge/ TabletBridge] || [http://tabletsb.garage.maemo.org/ Yes] || No || [http://repository.maemo.org/extras-devel/pool/fremantle/free/t/tabletbridge/ Yes] || - || - || [http://maemo.org/downloads/product/OS2008/tabletbridge/ Yes] || You need a Soundbridge device to test this...
|-
| [http://openbossa.indt.org/canola Canola] || - || [https://bugs.maemo.org/enter_bug.cgi?product=Canola Yes] || No || - || - || [http://maemo.org/downloads/product/OS2008/canola2 Yes] || Currently building packages for dependencies.
|-
|- style="background:LightGreen"
| [http://maemo.org/downloads/product/OS2008/tennix Tennix] || Network play [http://thpmaemo.blogspot.com/2009/08/multiplayer-tennix-coming-to-your.html in development] || [https://bugs.maemo.org/enter_bug.cgi?product=Tennix Yes] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/t/tennix/ Yes] || [http://maemo.org/packages/view/tennix/ Yes] || - || [http://maemo.org/downloads/product/OS2008/tennix Yes] || Works [http://talk.maemo.org/showpost.php?p=308544&postcount=59 according to qgil]
|- style="background:Gold"
| [http://maemo.org/downloads/product/OS2008/xournal Xournal] || Make the port work / Take advantage of a few Fremantle UI features || [https://bugs.maemo.org/enter_bug.cgi?product=Xournal bugs.m.o] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/x/xournal -devel] || [http://maemo.org/packages/view/xournal Testing] || N || [http://maemo.org/downloads/product/os2008/xournal Download] || Early stage of porting to Fremantle. Apps starts. Works on Chinook/Diablo.
|-
|- style="background:LightGreen"
| [http://maemo.org/packages/view/solarwolf/ SolarWolf] || Done || [https://bugs.maemo.org/enter_bug.cgi?product=SolarWolf Yes] || Yes || Yes || N || For Diablo || -
|- style="background:Crimson"
| [https://launchpad.net/pyqtoreader Pyqtoreader] || Adapting to Fremantle class HW (OpenGL, accelerometers)|| N || N || N || N || N || Waiting for PyQt in the repos, PySide is still too flaky
|- style="background:Crimson"
| [http://www.wormux.org Wormux] || Kinetic scrolling, more touchscreen control || [https://bugs.maemo.org/enter_bug.cgi?product=Wormux Yes] || Yes || [http://maemo.org/packages/package_instance/view/fremantle_extras-testing_free_armel/wormux/0.8.4-0maemo1/ Yes] || N || [http://maemo.org/downloads/product/OS2008/wormux/ For Diablo] || Otherwise OK, but crashes on device. Reason unknown.
|-
| (name linked to project) || Y/N link || Y/N || Y/N || Y/N || Y/N || Y/N || Y/N link to news
|}

== Proposals for Fremantle Stars ==
Nokia wants to support application developers having third party software ready for prime time by the day Maemo 5 is released. The first action is to select few projects to be supported since the day the first Fremantle SDK is released.

If your project hasn't been selected do not surrender. More actions will come with the beta SDK.

Above you have the applications that were proposd by the community. Nokia picked the projects to be supported from that list.

See also the [[Task:Remarkable_community_projects]] and [[Killer_Apps]].

=== Release quality ===

* [http://maemo.org/downloads/product/OS2008/mauku/ Mauku]: The micro-blogging client for Maemo devices
: Mauku was proposed earlier by someone, but was not available in Extras that time. Now it is, and thus, Mauku fulfills all requirements listed above.
* [http://maemo.org/downloads/product/OS2008/maemopadplus/ Maemopad+]: pressure-sensitive sketching, available in Extras, now in development again with focus on fixing Usability issues and finger-friendliness
*[http://maemo.org/downloads/product/OS2008/maemo-mapper Maemo Mapper] [[Image:Star.png]]: Most downloaded application for Maemo. Best map application. Can interact with lots of different mapping sites, including OpenStreetmap.
*[http://maemo.org/downloads/product/OS2008/numptyphysics Numpty Physics] [[Image:Star.png]]: This game is educational, hard, fun. Made for the stylus.
: Any ideas for features making the most from an Internet connection? Adding (optionally) the online dimension would be phantastic.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: High scores, level/content download, maybe co-op gameplay. —[[User:generalantilles|GeneralAntilles]] 08:48, 24 October 2008 (UTC)
: I've started working on online aspect for NP including level download and submission, demo recording and upload etc though obviously the amount of work to get this up and running, especially on the web side, is not insignificant. Need more levels too. In short, an injection of manpower could get NP polished and shiny but I personally am very short on spare time these days. —[[User:tim_edmonds|Tim]] 08:48, 27 October 2008 (UTC)
* [http://maemo.org/downloads/product/OS2008/scummvm/ ScummVM]: Point-and-click adventures are great for touchscreens, some free-as-in-beer games are available (Beneath a Steel Sky, etc..)
: This is an enabler. A user can't do much twith this alone. What about proposing a specific game (or set of games) using ScummVM? --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: As mentioned above, Beneath a Steel Sky, Flight of the Amazon Queen, etc. —[[User:generalantilles|GeneralAntilles]] 08:50, 24 October 2008 (UTC)
::: The problem with those is that they don't fit well onto device rootfs. Much better would be a Hildonized ScummVM "Content frontend" that would depend from ScummVM, list freely available games/gamedemos (with screenshot etc) and allow user to to launch them with ScummVM. If the game/demo isn't yet in the device, the frontend would first automatically download the required files from the net to a external/internal memory card + setup them for ScummVM. Similar thing would be useful also for other things that have large data sets (like Wesnoth). [Eero Tamminen, 2009-06-11]
* [http://maemo.org/downloads/product/OS2008/gpodder/ gPodder]: Finger-friendly UI, highlights the Internet aspect of the tablets (download podcasts); regular releases, many Maemo-specific UI changes; performance issues are worked on; tablet-related podcasts exist (example: [http://www.talkshoe.com/talkshoe/web/talkCast.jsp?masterId=27204&cmd=tc]) - downloading podcasts directly on the mobile device is a thing that you can with Nokia's tablets and gPodder, but not with iPhone/iPod touch right now
: Needs a much better list of podcasts, possibly the list that the N95 podcast application uses if formats are compatible. I've also had issues with gpodder leaking memory, and making my N810 slow down.--[[User:alan_peery|alan_peery]] 18:09, 31 December 2008 (UTC)
*[http://maemo.org/downloads/product/OS2008/xournal Xournal] [[Image:Star.png]]: A great notes/sketch utility. One of ''few'' apps that utilize the pressure sensitivity of the screen! Invaluable to create and annotate PDF documents on a pocket computer.
* [http://www.pimlico-project.org/index.html Pimlico]: PIM applications
* [http://clay.ll.pl/osmo Osmo]: PIM solution supporting open standards (SyncML, iCal)
* [http://tarot.freeshell.org/leafpad/ Leafpad]: for notes taking (and script programming)
: Too geeky for this call. --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
* [http://www.gnome.org/projects/gnumeric/ Gnumeric]: spreadsheet application
: Impressing users with a spreadheet editor? Don't get me wrong, I see the usefulness of the application but we are looking for more shiny things in this call.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
* [http://www.abisource.com/ Abiword]: document editor
: Any thoughts on adding the real time collaborative editing feature? Still, perhaps this is another tool clearly useful but not really impressive for desktop users - nor seems to be taking many advantages of the Maemo 5 features.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: Perhaps it lacks glitz, but it seems to me that an Office-compatible text editor might mean quite a bit to a lot of users (heck, a decent word processor of ''any'' sort is likely to make a lot of people happy). —[[User:generalantilles|GeneralAntilles]] 08:52, 24 October 2008 (UTC)
* [http://pidgin.garage.maemo.org/ Pidgin]: for instant messaging
* [https://addons.mozilla.org/firefox/addon/748 Greasemonkey] support?
: Another enabler. It would be better to have an impressing candidate based on Greasemonkey. --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: [http://browser-extras.garage.maemo.org/downloads_os2008.html browser-extras for OS2008]
* [http://pymaemo.garage.maemo.org/ PyMaemo]
: PyMaemo is great, but it says nothing per se to users. --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
*[http://maemo.org/downloads/product/OS2008/maemo-wordpy Maemo WordPy] [[Image:Star.png]]: Blogging software that hooks to WordPress and Blogger accounts, allows image uploads, post creating and editing, tagging. Especially notable for its finger-friendly menu.
* [http://maemo.org/downloads/product/OS2008/quiver/ quiver]: image viewer
* [http://www.fbreader.org/ FBReader]: e-book reader. Great functionality, but the UI is a bit clunky (file dialogs are not Hildonized, preferences dialogs are overwhelmingly complicated, there's no smooth touch scrolling).
: Will need at least one book included, and preferably a link to where to download more. My recommendation for the latter is manybooks.net, where many of the Gutenberg Project books have been reformatted. --[[User:alan_peery|alan_peery]] 18:05, 31 December 2008 (UTC)
* [https://wiki.mozilla.org/Fennec Fennec]: Mozilla Firefox-based browser made specifically for mobile devices & touch screens. Currently (23 oct 2008) in Alpha phase.
* [http://www.v7f.eu/public/n800/chess/ Eboard and crafty chess engine] port of the [http://www.bergo.eng.br/eboard/ eboard] chess program. Main goal is playing on [http://www.freechess.org fics] or other online chess platforms against other human players. Analysis or games vs. engine are possible to. Can handle .pgn files and looks better than the chess "application" which is installed at the tablet after flashing the firmware.
* [http://maemo.org/downloads/product/OS2008/quickclip/ Quick Clip] A statusbar plugin that allows you to save text from any application (or input it directly) into categorized files; also comes with a fairly nifty viewer. Although relatively stable, still very much in active development.
*[http://garage.maemo.org/projects/bluemaemo/ BlueMaemo]: BlueMaemo is a remote controller program for the Maemo-powered devices. Accelerometer controls and a 3d/air mouse are planned for Fremantle.

=== Alpha/Beta quality ===

*[http://conboy.garage.maemo.org/ conboy]: A port to Maemo of the Tomboy application, this personal wiki software is great for organizing notes, todos, etc.
*[http://maemo.org/downloads/product/OS2008/osm2go/ osm2go]: This is a tool to '''create''' maps. It makes use of the hirez (touch) screen, a permanent internet connection for up- and download and the GPS of course. No such tool seems to exist for any other mobile plattform.
: Very interesting. Any way to make this a plugin of the very popular Maemo Mapper? Imagine that users would just use the maps [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm], having the ability to go for an "editing mode" by pressing a key.--[[User:qgil|qgil]] 08:14, 24 October 2008 (UTC)
::Sure, that's planned to happen soon. Currently not planned as a plugin (does MM support plugins?) but via dbus interaction to e.g. use the current Maemo-Mapper view as the area to work on. Pretty much like gpxview also interacts with Maemo-Mapper --[[User:harbaum|harbaum]] 12:50, 25 October 2008 (UTC)
::Done --[[User:harbaum|harbaum]] 22:50, 3 November 2008 (UTC)
::A freemantle release of osm2go could use the clutter canvas instead of goocanvas or gnomecanvas. This way it would immediately take advantage of the video accelerator.
*[http://garage.maemo.org/projects/maemo-barcode/ maemo-barcode]: Alpha quality, could be a very cool application with some integration and interface development.
: I've not used maemo-barcode but I see something like this could encompass much more than barcodes. From a hi-res picture you can also extract text and then cross reference it on google. Usually, even a short fragment of text can give a very specific match for example for article text, street signs, names numbers addresses etc, eg: similar to [http://exbiblio.com exbiblio]. Then you can log it and tag it with gps/cell-id and make it all searchable. Of course, this would require a high res camera that doesn't just point at your head. --[[User:tim_edmonds|Tim]]
*[http://garage.maemo.org/projects/liqbase liqbase]: Beta (now in extras) playground for sketching with kinetic graffiti with fullscreen tearfree refresh. finger friendly and FAST. shows off your tablet in the best light.
* Bring [http://garage.maemo.org/projects/gazpacho-maemo/ Gazpacho] back to life
: Developer tools are out of scope in this call.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
*[http://garage.maemo.org/projects/tear/ Tear]: Beta quality, a WebKit-based browser which aims for better tablet-oriented experience (and maybe cross-engine).
*[http://www.estamos.de/projects/SyncML/index.html syncevolution]: A very powerful application to synchronize the tablets with a SyncML Server. Actually working with the osso-addressbook and pimlico dates.
*[http://maemo.org/downloads/product/OS2008/pwsafe/ PasswordSafe]: Password safe is a utility to keep a list of usernames and passwords encrypted with a single password by Peter Weston. Its file format is from Bruce Schneier's utility of the same name. the UI has been changed to a tree within a pannable area for Fremantle (that's why it's back to Beta in 1.5)
*[https://launchpad.net/pyqtoreader Pyqtoreader]: Pyqtoreader (pronounced pīkto- rē-dər) is a modular Qt based viewer primarily for books, large images, comic books (cbr/cbz), webcomics, flickr photostreams and through various plugins to any page/image oriented content.
*[http://maemo.org/downloads/product/OS2008/fuelpad/ FuelPad]: functional car fuel usage tracker. The UI is a bit confusing (I always get confused by the labels -- "trip" versus "km", does "price" mean total or per litre, etc?).

[[Category:Community]]
[[Category:Development]]
[[Category:Software]]

Free Maemo

2011-12-15T03:12:35Z

114.79.28.10: /* MCE */

{{out of date}}

The purpose of this page is to document efforts to free the
[http://maemo.org Maemo] mobile environment as well as document the
steps necessary to use the [[Nokia N900|N900]] device as a fully free phone.

At the time of writing, the N900 / [[Open development/Maemo roadmap/Fremantle|Maemo 5]] ship with a mix of free and nonfree components. Our goal should be to figure out how to use only free components while still maintaining a usable and enjoyable device.

Some discussion is happening at http://maemo.org/community/maemo-developers/double_checking_free-nonfree_packages/.

== Components in need of attention ==

Graph depicting status of free/nonfree components on the N900:

[[Image:Top_level_architecture.png|800px]]

(nonfree components are in red, free components are in black)

(taken from [[Documentation/Maemo_5_Developer_Guide/Architecture/Top_Level_Architecture|Toplevel Architecture]] page)

'''NOTE:''' This list probably contains some items that are at the time of writing, actually free software. There is an [http://lists.maemo.org/pipermail/maemo-developers/2009-December/022747.html email thread aiming to clarify this], and once those clarifications are made certain items will be removed from the following list of non-free packages.

=== Sharing plugins / libsharing ===

http://maemo.org/api_refs/5.0/5.0-final/libsharing-plugin/ch07.html

=== calendar-backend ===

Appears to be a free version:

http://maemo.gitorious.org/calendar-backend

=== libtime ===

Time management service is a new subsystem to provide a common library
for all time-related (not alarms, though) services.

http://maemo.org/api_refs/5.0/beta/libtime/

=== libcityinfo ===

From [http://maemo.org/api_refs/5.0/beta/libcityinfo/]:

:Cityinfo library allows to get some informations about set of cities from all over the world. Each city is connected with one timezone (related to standard linux time zone database) so You can get local time in given city by calling functions from libtime (clockd) library.

Maemo mapper is apparently a free replacement: http://maemo.org/downloads/product/OS2008/maemo-mapper/

=== startup wizard ===

Presumably this is the "wizard" that appears when a user first logs in. This would be nice to be made free but is not critical.

=== factory store / clear user data ===

This would be nice to be made free but is not critical.

=== gypsy daemon ===

This appears to be free to me:

http://gypsy.freedesktop.org/wiki/

According to cool900: http://cool900.blogspot.com/2009/11/closed-source-components-in-maemo-5.html

(2009-11-13: Gypsy daemon in location framework is in free.)

=== liblocation / location daemon ===

Some information here: http://maemo.org/api_refs/5.0/5.0-final/liblocation/LocationGPSDevice.html

outdated stuff here: http://maemo.org/maemo_release_documentation/maemo4.1.x/node10.html#SECTION001027000000000000000

=== backup ===

[[Documentation/Maemo_5_Developer_Guide/Generic_Platform_Components/Using_Backup_Application]]

=== Address book / "Contacts" application ===

[[Documentation/Maemo_5_Developer_Guide/Using_Generic_Platform_Components/Using_Address_Book_API]]

Sits on top of evolution backend stuff. So might not be too hard to build a UI replacement that conforms to the the same backend?

=== Media player ===

This is allegedly nonfree

=== mission control ===

This is a strange one because Mission Control is itself free software, which is a Telepathy component:

http://mission-control.sourceforge.net/

However they apparently have some nonfree bits:

: <wjt> paroneayea: MC itself is LGPL [15:13]
: <wjt> paroneayea: Maemo uses osso-mission-control, which is upstream MC plus
: some proprietary bits

=== rtcom-eventlogger ===

Apparently recently freed according to:

http://cool900.blogspot.com/2009/11/closed-source-components-in-maemo-5.html

=== libaccounts ===

http://rtcomm.garage.maemo.org/docs/libaccounts/

=== SSO ===

????

Not even sure what this is. Supposedly single-signon related?

=== PulseAudio PEP ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/Multimedia_Domain#PulseAudio_Policy_Enforcement_Point]]:

:PulseAudio plugin to manage volume levels, re-route streams and eventually forcefully shutdown streams.

=== libplayback ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/Multimedia_Domain#libplayback]]:

:libplayback is a client API that allows an application to declare its playback state. The library uses D-Bus to talk to a central component that manages the states. Media applications can use the API to synchronize their playback state.

=== EAP ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/Multimedia_Domain#EAP_and_AEP]]:

:The EAP (Entertainment Audio Platform) package is used for audio post-processing (music DRC and stereo widening).

=== AEP ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/Multimedia_Domain#EAP_and_AEP]]:

:AEP (Audio Enhancements Package) is a full duplex speech audio enhancement package including echo cancellation, background noise suppression, DRC, AGC, etc. Both EAP and AEP are implemented as a PulseAudio module.

=== FMTX middleware ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/Multimedia_Domain#FMTX_Middleware]]:

:FMTX middleware provides a daemon for controlling the FM Transmitter. The daemon listens to commands from clients via dbus system interface. The frequency of the transmitter is controlled via Video4Linux2 interface. [...]

=== Funambol SyncML ===

Claims "Funambol is the leading mobile open source project and leading provider of open source mobile cloud sync and push email for billions of phones."

https://www.forge.funambol.org/DomainHome.html

If it's "open source", is it really nonfree then?

Appears to be under the AGPL? https://core.forge.funambol.org/source/browse/core/trunk/LICENSE.txt?revision=28308&view=markup

=== xml2wbxml ===

Appears to be linked to the wbxmllib project, which is under the gpl? http://sourceforge.net/projects/wbxmllib/develop

=== ICD2 ===

From [http://maemo.org/api_refs/5.0/beta/icd2/]:

:The Internet Connectivity daemon, ICd2, is responsible for network connectivity in the device. It is started at system boot time from the init script /etc/init.d/icd2, and stopped with the same script at system shutdown.

:Applications requesting network connections do not interact directly with ICd2, but instead use the shared libconic library API. The libconic library is the stable maintained API for network connectivity, which uses internal D-Bus APIs com.nokia.icd and com.nokia.icd2 APIs to communicate with ICd2. These D-Bus APIs are internal and may change without further notice.

libconic appears to be free though

https://stage.maemo.org/svn/maemo/projects/haf/branches/libconic/0.13/COPYING

=== Modem Services & Cellular Modem Software ===

Proprietary, hard to find documentation?

Presumably should be replaced and made free by OFono:
* http://ofono.org/
* http://git.kernel.org/?p=network/ofono/ofono.git;a=summary

=== softupd ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/Core_Domain#Softupd]]:

Program for flashing the eMMC contents
* Unpacks a FIASCO image fed to it
* Copies the unpacked contents to eMMC

=== sysinfod ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/Core_Domain#Sysinfod]]:

Provide interface for accessing device information

Provide a DBUS interface to device specific information (HW id, WLAN MAC, …)

=== CertMan ===

Appears to be free or have a free implementation? http://gitorious.org/+mer/mer/certman

=== OpenGL ES 2.0 ===

Can't seem to find out details about this package

There appear to be some free software implementation tests here, but not really usable?: http://www.khronos.org/developers/resources/opengles/

Vincent 3d is a free software implementation? http://www.vincent3d.com/Vincent3D/index.html

Hm, looks like the problem may be on the driver end: http://forum.openhandhelds.org/viewtopic.php?f=14&t=341

And it does not look likely that this is free or that it will be free soon.

=== Nolo bootloader ===

NoLo bootloader not only is proprietary and sucky, there's almost no documentation available for it anywhere.

Some questions here:
http://maemo.org/community/maemo-developers/debian_on_the_n900-_configuring_nolo/

Could u-boot be a possible replacement?: http://www.denx.de/wiki/U-Boot

Nobody appears to have tried such a thing and there is no documentation on whether or not that will be possible.

In the meanwhile people seem to be using bootmenu as a workaround for this completely unconfigurable bootloader:
http://talk.maemo.org/showpost.php?p=344412&postcount=16

However this isn't ideal, either from a practical or a free software perspective. U-boot is probably the best replacement option?

=== Flasher ===

[[Flasher]]

Not clear if this needs a free software replacement. If we can replace the bootloader, probably doesn't.

Is this a free software replacement?: http://www.nopcode.org/0xFFFF/

=== System UI ===

Part of the "System Control" whatever.

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/System_Software#System_UI]]:

:SystemUI provides services to other components to display UI elements (dialogs, notifications, alarms) that does not have native UI on their own.

Powerlaunch aims to provide a free replacement: http://powerlaunch.garage.maemo.org/

=== DSME ===

Freed according to:
http://cool900.blogspot.com/2009/11/closed-source-components-in-maemo-5.htmlci
(2009-11-13: DSME is in free).

Part of the "System Control" whatever.

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/System_Software#Device_State_Management_Entity_.28DSME.29]]:

:DSME is responsible of device state management , process lifeguard support, watch dogs and thermal management. DSME architecture is based on modular plugin architecture. DSME core provides message handling capabilities to modules. Each module is dynamically loaded library. DSME runs in single process and is single threaded. The D-Bus interface provides services to request reboot, shutdown or powerup (from acting dead mode), indication of shutdown, thermal events and data save.

=== BME ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/System_Software#BME]]:

* Provides battery monitoring and charging service.
* Provides battery identification, monitoring, charging and BME API.
* TSS interface for A/D converter calibration.
* Emulation libraries for Nokia OS services.

=== Clockd ===

From [[Documentation/Maemo_5_Developer_Guide/Architecture/System_Software#Clockd]]:

Provides centralized place for handling time.

=== MCE ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/System_Software#Mode_Control_Entity_.28MCE.29]]:

:MCE is responsible of handling display control [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] (active/dim/blank), activity monitoring (keys, buttons), keyboard backlight, ambient light sensor (ALS), LEDs and device mode control. In addition, MCE is responsible for providing interface to proximity, accelometer and vibra devices.

Powerlaunch aims to provide a free replacement: http://powerlaunch.garage.maemo.org/

Harmattan/MeeGo version of MCE appears free:
https://meego.gitorious.org/meego-middleware/mce

=== IPHBD ===

Apparently used for synchronization, according to:

http://cool900.blogspot.com/2009/11/closed-source-components-in-maemo-5.html

=== Profiled ===

From
[[Documentation/Maemo_5_Developer_Guide/Architecture/System_Software#Profiled]]:

* Provides centralized place for handling (user) profiles related data and notifications.

=== sounds ===
=== icons ===
=== fonts ===
=== themes ===

=== SDK ===

maemo-scratchbox-install_5.0beta.sh is a shell script that claims to be proprietary software owned by Nokia. So does maemo-sdk-install_5.0beta.sh.

[[Category:N900]]

QtRuby

2011-12-15T03:11:15Z

114.79.28.10: /* Important Links */

This is a quick start guide to getting into QtRuby application development. Follow the KDE link at the bottom to take this further than what I have written so far. There is good info in mikec's thread as well that pertains to QtDesigner. Please feel free to add to this guide. Also please feel free to package an optified version of libqt so we don't need to use Easy Debian.

Extra special thanks to Qole for [[Easy Debian]]. None of this would be possible without him.

I'm sure I've screwed something up so let me know in this [http://talk.maemo.org/showthread.php?t=49751 thread.]

== Preperations ==

=== Linux ===
* Get QtDesigner
sudo apt-get libqt4-designer
* Get Qtruby and Ruby
sudo apt-get install libqt4-ruby1.8

=== Windows ===
--Still need to test these directions on a win machine. But I think this is right.
* Get QtDesigner from http://qt.nokia.com/downloads
* Get Ruby 1.87 from http://rubyinstaller.org
* Install QtRuby4 gem from a command prompt
gem install qtruby4

=== Mac ===
I'm not sure what all is gonna be required. Read this maybe: http://osake.wordpress.com/2009/08/21/qt4-qtruby-mac-os-x/

=== N900 ===
* Install Easy Debian (available in the [[extras]] repository)
* Install ibqt4-ruby1.8 under Easy Debian using [[Nokia N900|N900]] [[terminal]].
debbie sudo apt-get install libqt4-ruby1.8

== Your First App ==
=== QtDesigner ===
*Start QtDesigner:
It will open a window called “New Form”.
*Select Main Window.
*Change the Screen Size option to 800x400.
**It may not be possible to do this depending on what platform you are on.
**That's okay as we can change it later.
*Click Create.

Our new form is created. We can now add controls to it and adjust its properties.

*Click the View menu at the top of QtDesigner.
*Check the Property Editor, Object Inspector and Widget Box if needed.

On the right side of the screen we see the Object Inspector and the Property Editor.
You can click on any object in the Object Inspector and you will see that the Property Editor loads that object.

*Select the Main Window in the Object Inspector.
*In the Property Editor window scroll down till you see “geometry”.
You can expand the “geometry” stub by clicking on the triangle to the left of it.
*Change the Width to 800 and the Height to 400 if necessary.

We don't need the Menu Bar or Status Bar that are default on a Main Window form.
Let's remove them.
*In the Object Inspector right click on the “menu bar” object.
*Select “Remove Menu Bar”.
*In the Object Inspector right click on the “status bar” object.
*Select “Remove”.

Let's add a label to our form to display some text.

On the left side of our screen is the Widget Box.
We can scroll through and pick widgets to add to our form.
*Drag the “Label” widget under the “Display Widgets” category onto the form.

You will see a “TextLabel” with blue dots around it.
You can drag the blue dots around to resize it.
*Right click on the label and select “Change rich text”.
This gives you a WYSIWYG text editor.
*Type in “Hello World” (or whatever you like.)
*Click “Ok” when finished.

In the Property Editor window adjust the geometry of the label to 800x400.

Now our form is complete.

Go to the File menu of QtDesigner and Save the form in a new directory somewhere.
Name the form dashboard_ui.ui
=== Rbuic ===
Now we need to translate the QtDesigner file into Ruby source code.
* In Windows drop to a command prompt.
**In linux open an xterm.
* Navigate to the directory you save the form in.
rbuic4 -x dashboard_ui.ui -o dashboard_ui.rb
--note maybe just rbuic for windows.

=== Testing the app ===
* From your apps directory type:
ruby dashboard_ui.rb
or
ruby1.8 dashboard_ui.rb
If all is well you will see your program appear. Congratulations!

=== Transfering it to the N900 ===
*Now copy dashboard_ui.rb to your N900 MyDocs folder.
-- add more directions here

=== Running your app on the N900 ===
*Open the Debian Chroot from your N900 programs menu.
cd home/user/MyDocs
ruby1.8 dashboard_ui.rb

== Revising Your First App For Single Inheritance ==
Coming Soon.
We'll look at how to create a main.rb and subclass are ui to seperate the ui code from our program code.

== Important Links ==
* [http://techbase.kde.org/Development/Tutorials/Developing_Qt4_Applications_using_Qt_Designer_and_Ruby_on_Kubuntu KDE QTRuby tutorial]
* [http://talk.maemo.org/showthread.php?t=43663 mikec's Python/QtDesigner thread]
* [[Easy_Debian|Easy Debian wiki page]] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm]

[[Category:Qt]]
[[Category:Development]]

Perl

2011-12-15T03:11:04Z

114.79.28.10: /* Fremantle */

Because Maemo is based on Debian, and because perl is such a big part of the debian OS, Maemo contains a full-blown Perl platform. This page aims to document and describe this environment so developers can take advantage of it when programming on the Maemo platform.

== Fremantle ==

The current version of perl shipped with the [[Nokia N900|N900]] is 5.8.3.

One caveat of perl development on the N900 is that there is a fuller Perl distribution in the SDK than on the device. This means not just that there are fewer modules on the device, it means that rather fundamental Perl modules are missing form the normal Debian version of Perl on the device. This is done to save space; the device itself is embedded linux, the root files system is rather small, i.e. 228 MB.

You will find it difficult to build Perl modules on the device if you do not add the necessary Perl tools, namely <code>perl</code> and <code>perl-modules</code>. Without these [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] key tools, many of the modules used to build Perl modules won't exist on the device and you won't be able to add software written in Perl. Here is an example of what is shipped with both the SDK and device environments;

{| class="wikitable"
|+ Installed Perl packages
|-
! In the SDK !! On device
|-
| liblocale-gettext-perl ''1.01-17osso2'' 
libtimedate-perl ''1.1600-4osso'' 
perl ''5.8.3-3osso10'' 
perl-base ''5.8.3-3osso10'' 
perl-modules ''5.8.3-3osso10'' 
| liblocale-gettext-perl ''1.01-17osso2'' 
perl-base ''5.8.3-3osso10''
|}

The SDK repositories are here:

deb http://repository.maemo.org fremantle/sdk free non-free
deb http://repository.maemo.org fremantle/tools free non-free

If you wish to add Perl modules what I recommend is to bring in the necessary tools, namely the <code>perl</code> package and the <code>perl-modules</code> package. You can do that by adding the repositories that supply modules to the SDK. Of course you can build Perl yourself, but it is already built for the device's architecture and it is in a known good state, so it is much easier to just take the already built Perl binaries for the N900. (There are later versions of Perl built and packaged for the device, I'll eventually provide links to those, until then, you'll have to rely on Google.)

Once you have added the SDK repositories to your <code>/etc/apt/sources.list</code>, simply run:
apt-get update
apt-get install perl perl-modules

Now you should be ready to start bringing other modules in.

=== Git repo at Gitorious ===

I have packaged one module so far, I hope to bring in many more perl modules. If you package something for the device, why not contribute your module to the maemo repos and/or ask me to pull it into the [http://gitorious.org/maemo-perl-packages/maemo-perl-packages/trees/master gitorious repo that] I have set up?

=== dh-make-perl at garage.maemo.org ===

Just ported <code>dh-make-perl</code> for Maemo fremantle. The packages ported are available at [http://dh-make-perl.garage.maemo.org]. It includes among

Some notes for people who want to port perl modules for ARM. I found out that I had to change the following (change your proxy settings as appropiate):

<source lang="bash">
# Environment vars
SBOX_REDIRECT_IGNORE=/usr/bin/perl
export SBOX_REDIRECT_IGNORE
unset PERL5LIB
export PATH=/usr/bin/dh7:/usr/bin:$PATH
export DISPLAY=:2
export http_proxy=http://172.16.0.1:3128
export https_proxy=http://172.16.0.1:3128
export ftp_proxy=http://172.16.0.1:3128
export GIT_SSL_NO_VERIFY=1
echo "127.0.0.1 localhost" > /etc/hosts
</source>

Nasty script to substitute <code>/usr/bin/man</code> which breaks <code>dh_installdocs</code>

<source lang="bash">
#!/bin/bash
n=$#
echo "$# $1 $2 $n"
while [ $n -ne 1 ]; do
echo "$# $1 $2 $n"
p=$1
shift
n=$#
done
p=$1
echo $p
/usr/lib/man-db/manconv -f UTF-8:ISO-8859-1 -t UTF-8//IGNORE $p
</source>

Some packages ported include ssleay and some others which are needed prerequisites for <code>dh-make-perl</code>.

[[Category:Software]]
[[Category:Development]]

Git For Garage

2011-12-15T03:10:58Z

114.79.28.10: /* Further reading */

[http://git-scm.com/ Git] is available as an alternative version control system to [[Subversion]] for [[Getting started with Maemo Garage|Garage]] projects.

== Requesting Git for your Garage project ==

=== New Projects ===

When you start a new project at garage you can select "git" to be the default version control system. At the bottom of the request form you can pick between "svn" and "git". Your new project will automatically have a "git" repository.

=== Old Project Can Request Conversion ===

This feature has not been advertized, but it is possible to convert an existing subversion repository to a "git" repo. All you need to do is to go to the "Admin" page of your project's SCM section and click the "Convert to git repository" button.

Your request will be scheduled and you can monitor the progress through a link that will be shown to you as soon as you hit the button.

The conversion works the best (tm) with svn repositories that have "standard layout". Standard layout means that the root of the subversion repo has:

-trunk

-branches

-tags

Branches and tags will be converted to proper git branches, while trunk will be the master branch.

If your project has a 'www' directory in its root, then it is also supposed to be converted.

Conversion also works for repositories that do not have the standard layout. However this features was just recently introduced, so bugs might surface.

If the conversion was OK, then your subversion repo will be disabled, meaning that no further can commits can go into it. However it will remain safe on our servers and if you remember the URL than you can even read it.

If you are unhappy with the result of the conversion then please request to restore it. We will revert your svn repository just like it was at the time of your conversion request.

If the conversion FAILED, then the system will not do any changes to your project settings and your svn repo remains usable.

In case you have questions, feedback or experience problems please report them through bugzilla, or just send an email to "garage at maemo dot org".

== Garage-specific information ==

Git on Garage uses the https access method via cURL (most Git installations use Git over ssh, and this is currently under development for Garage). This may cause problems due to the security certificate on https://vcs.maemo.org, so if you experience any issues with 'git clone' or 'git push' please try to set the <code>GIT_SSL_NO_VERIFY</code> environment variable to 1, for example:
export GIT_SSL_NO_VERIFY=1
in a terminal on Linux using bash.

For proxy users, the <code>https_proxy</code> environment variable must be set, for example:
export https_proxy="172.21.112.250:8080"

To authenticate, make sure you have filled in your Garage credentials to ~/.netrc, for example:
machine vcs.maemo.org
login __garage user name__
password __garage password__

== Additional info ==

The information on the Garage SCM page for Git projects seems incorrect or incomplete. If you want to push you will need to specify:

<code><nowiki>https://<garage username>@vcs.maemo.org/git/<project name></nowiki></code>...as the URL of the repository.

== Further reading ==

* [http://git-scm.com/documentation Git documentation] at the Git homepage
* [http://git.or.cz/course/svn.html Subversion to Git documentation] for users familiar with Subversion but new to Git
* See the [[Git for Garage wishlist]] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm]

[[Category:Community]]
[[Category:Development]]

Maemo security

2011-12-15T03:09:17Z

114.79.28.10: /* Is there a diagram showing the security framework and components? */

At the [[Maemo Summit 2009]], Nokia shared a great deal of information about the security mechanisms that would be available and/or mandated in upcoming platforms.

* [http://www.slideshare.net/peterschneider/maemo-6-platform-security Slides]
* Video (TBC)
* [http://meego.gitorious.org/meego-platform-security Source Code]

The concepts outlined include well established favourites in the OSS world (like privilege management) as well as some that are rather less well regarded - such as relatives of the Trusted Computing Platform and DRM.

Inevitably there will be a significant amount of interest and concern about how this affects the open nature of the Maemo platform.

This page is intended to capture community questions (and, eventually I hope, Nokia's answers) about these issues.

''Initially please add questions to the [[Talk:MaemoSecurity|discussion]] page and once they've been refined and consolidated, we'll add them onto this page.''

Some examples:

==Is there a diagram showing the security framework and components?==

See [http://www.slideshare.net/peterschneider/maemo-6-platform-security slide] #2, #5 and #9 of Elena Reshetova's [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] [[Maemo Summit 2009/Day 3#Maemo_Platform_Security:_Principles_and_Concepts | Maemo Summit presentation]]

Elena Reshetova: The presentation was [http://www.slideshare.net/peterschneider/maemo-6-platform-security uploaded], and currently it is the only information, which I can share.

==What is "Open Mode" and can it be revoked remotely?==

"Open" mode is when an unsigned kernel has been booted. Disabling it remotely would, presumably, require a change to the bootloader. See [http://www.slideshare.net/peterschneider/maemo-6-platform-security slide] #??? --[[User:jaffa|Jaffa]] 11:36, 13 October 2009 (UTC)

==What does closed mode restrict you from doing?==

* Terminal?
* Root?

Elena Reshetova: In general "close" mode has its own security policy, which user won't be able to change.

* Cellular is marked as a protected ressource in the slide. Can one still use it (phone, data, sms etc.) while running in open mode? While running a rebuilt kernel?

Elena Reshetova: If you use your own kernel, you are the one to set the security policy for the device, meaning that your SW in this case can make calls, send SMS and so on (for example). Please note that the list of protected resources on the slide is given just as example (to show the possible granularity level), so it doesn't mean that we would have exactly these resources.

==How easy is it to switch between Open and Closed modes?==

Is it so trivial that you would want to and be able to do it several times a day and on the go (without restart)?

Elena Reshetova: I should be able to tell the exact procedure in the future, but for now I can say that it won't be so trivial (like press the GUI button :-)), and the restart is needed. The checks for the SW image are done by the Loader, and during the boot time, so you do need to restart.

==Can network operators restrict you switching to Open mode?==

Like if a device is SIM-locked to a particular network, does the device get locked down in closed DRM mode only too? Can you always switch to open mode?

Elena Reshetova: If the device is SIM-locked, operator can restrict you to the usage of one particular kernel (slide 5), for example the one, which was shipped with a device. However, it is up to you to decide to buy the device from the operator or from the Nokia store.

Till Harbaum: Imho GPLv3 requires you to provide "installation instructions". gstreamer comes under GPLv3, MeeGo uses gstreamer, hence no distributor is allowed to prevent the installation of e.g. a modified version of gstreamer. They are even required to tell you how to do that.

==How granular is the encryption?==

If my app creates content in the closed mode can I see it in open mode?

Elena Reshetova: If your application uses the Protected Storage for encryption (slide 8) in the initial mode, and after you switch to another mode, the application won't be able to get decrypted data. If your application just stores the data in the filesystem, after switching to your own kernel, you will be able to access the data (because they are just plain files in the filesystem).

==Can open applications use the privilege mechanisms in the Open and Closed modes?==

Elena Reshetova: I guess the question is "Can the applications access protected resources in both modes?" I hope I got the question correctly. The answer is that the Device Security Policy (slide 7) defines the resources can be potentially granted to the SW coming from a particular SW source. When one uses the Nokia signed kernel, the device security policy is defined, and user can't change it. If one uses its own kernel (or community kernel for example), he (or community) is the one to define/change the device policy. This means that one can, for example, change the policy in the way that the SW coming from the maemo.org gets access to all protected resources (of course some content becomes unavailable when one switch to its own kernel, for example DRM). However, again, it is possible only while using your own kernel.

==Can open applications use the DRM encryption mechanisms in the Open and Closed modes?==

==Will community extensions to the kernel (modules) be permitted in Open/Closed modes?==
I can't see how - which leads to the question: How do community 'enhancements' to the kernel get adopted?

Elena Reshetova: In the "Open" mode any changes of the kernel are allowed. Regarding the "closed" mode, unfortunately I am not the right person to answer this question.

==Is there any GPLv3 software impacted?==

[[Category:Harmattan]]
[[Category:Development]]

Orrery

2011-12-15T03:09:10Z

114.79.28.10: /* Contact Information */

The orrery is a simple open-source application for [[Open development/Maemo roadmap/Fremantle|Maemo 5]] which displays the night (and day!) sky. It is nowhere near as elaborate as, for example, kstars, xephem or stellarium. It is intended to be a small, finger-friendly application, requiring no network connection. The current stable version is 3.5.x (the x just increments when bugs are fixed). The program version is shown on the "Symbol Key" page.

The source code is hosted on [https://github.com/kenyoung/orrery this github repository]. The version there may not have gone through the Maemo Community QA testing. The most recent version which has been vetted by the community is available in the Maemo [[Extras]] catalog. This wiki page describes the behavior of the version of the program available in the Extras Devel catalog - the only significant difference between this version and the one in Extras is that it has a Jovian Moons page.

The star database was extracted from the [[:wikipedia:Hipparcos_catalog|Hipparcos catalog]]. To ease the computational load, the coordinates are not [[:wikipedia:Precession_(astronomy)#Astronomy|precessed]] or [[:wikipedia:Nutation#Of_the_Earth|nutated]] before being displayed. [[:wikipedia:Orbital_elements|Orbital elements]] are used, rather than [[:wikipedia:Ephemerides|ephemerides]], to calculate planet positions. Although this is less accurate, it dramatically reduces the memory footprint. The planet positions are accurate to a few arc minutes, from 3000 BC to 3000 AD. Since the scale on the default display is approximately 8 arc minutes per pixel, these small errors are imperceptible, unless a very large zoom factor is used.

== The Display ==

[[Image:orreryDefaultPage_3.2.png|thumb|200px|alt=Screenshot of the Orrery default page|Orrery Default Page]]

The image at right shows the default display - all stars visible to the unaided eye, with colors for the brightest ones. It's displayed with a [[:wikipedia:Transverse_Mercator|Transverse Mercator projection]] (similar to [[:wikipedia:Norton%27s_Star_Atlas|Norton's Star Atlas]]) which works well with the [[Nokia N900|N900]] in portrait mode. It's a [[:wikipedia:Conformal_transform|conformal transformation]], so the constellations have about the right shapes. The Sun, Moon and planets are plotted, and the Moon is shown with the proper phase. The Sun and Moon are plotted with a size about 3.5 times larger than their true angular size on the sky. That allows the phase of the moon to be shown.

At the top of the display is shown, from left to right, the [[:wikipedia:Universal_time|Universal Time]] (UT), the [[:wikipedia:Sidereal_Time|Local Sidereal Time]] (LST), and the location on the earth. The UT is essentially the same as the Greenwich Mean Time, and the date will also be displayed if it differs from the current date. The LST is a time based upon the position of the stars, rather than the position of the sun. The user may chose to have the program display the stars visible at the user's current location and at the current time, or at any other position on the earth, or any other time between 3000 BC and 3000 AD.

The blue line near the bottom of the display is the horizon. Nothing below that line is visible, but the program plots objects there anyway, because it is often useful to know which objects are just about to rise, and which ones have recently set.
{{clear}}

=== The orrery as a compass ===

The green numbers at the bottom are the [[:wikipedia:Azimuth|azimuth]] values. The
azimuth is the angle, measured along the horizon, from north through east. So the azimuth of due north is 0, east is 90, south is 180 and west is 270 degrees. By using these azimuth values, the orrery can be used as a celestial compass, if the sky above you is at least partially clear. Notice that the azimuth values are not exactly evenly spaced. This is caused by the distortion introduced by the Transverse Mercator projection.

The azimuth compass which appears if you tap the bottom center of the default page shows the azimuth of the Sun and Moon, if they are currently above the horizon.

You can also use the "Planet Compass" to find directions. If the sun, moon or a planet is visible above the horizon, you can orient the azimuth portion of the planet compass with that object, and use the rest of the compass to find any other direction.

=== Why does this program put my phone in portrait mode? ===

The Transverse Mercator transformation works poorly when the phone is in landscape mode. As we all learned in school, Mercator maps of the earth become very distorted near the earth's poles. For the orrery program, that distortion is unacceptably large when the phone is in landscape mode, because the landscape aspect ratio results in too large a range of azimuth values being displayed. A future version of orrery will support landscape operation, using a different coordinate transformation for that display.

=== Constellations Display ===

[[Image:orreryConstellations_3.2.png|thumb|200px|alt=Screenshot of Orrery constellation screen|Orrery Constellation Screen]]

There are two sky display screens defined. By default, one of them shows the display shown at right, and the other shows the constellations, and symbolic representations of the solar system objects. Tapping the screen within the upper 4/5 of the display toggles in and out of the constellations page.

The constellations are plotted in three colors. The twelve [[:wikipedia:Zodiac|zodiac]]
constellations are plotted in hot pink.The constellations plotted in gold are the classical Greek constellations, as listed in [[:wikipedia:Almagest|Ptolomy's Almagest]] (apart from the zodiac constellations, which are also in the Almagest). The only constellation from the Almagest which is not plotted is Argo Navis, which is not one of the official modern constellations (Argo Navis was broken up into the modern constellations Carina, Puppis and Vela). The remaining constellations, plotted in blue, were added during the last few hundred years.

In addition to constellation names and figures, three great circles, the [[:wikipedia:Celestial_Equator|Celestial Equator]] (light yellow), [[:wikipedia:Ecliptic|Ecliptic]] (red) and [[:wikipedia:Galactic_plane|Galactic Plane]] (blue-green), are shown. Solar system objects are shown symbolically (see Mercury, Venus, the Moon and the Sun in the above image).
{{clear}}

=== Displaying Asterisms ===

[[Image:OrreryAsterisms_3.2.png|thumb|200px|alt=Screenshot of Orrery northern asterisms view|Orrery Northern Asterisms]]

There are many [[:wikipedia:Asterism_(astronomy)|informal constellations]] which are widely known, such as the [[:wikipedia:Big_Dipper|Big Dipper]], the [[:wikipedia:Summer_Triangle|Summer Triangle]], etc. The user can choose to display some of these unofficial constellations by selecting "Use Asterisms" from the "Displayed Items" menu. If you know of some nice asterisms that the orrery does not yet display, please send them to orrery.moko@gmail.com, and I'll include them in a future release if I can. The image on the right shows the Big Dipper and Little Dipper asterisms.

{{clear}}

== Panning ==

The image can be panned by tapping your finger in the bottom 1/5 of the display (excluding menus). The size of the panning step is controlled by how close your finger is to the edge of the display. The program tries to center the azimuth value near where you tap. If you tap near the left or right edges, it pans by the maximum allowed amount, +-40 degrees. Pan steps are
quantized in increments of 5 degrees.

=== Selecting a New Center Azimuth ===

[[Image:OrreryAzCompass_3.2.png|thumb|200px|alt=Screenshot of the Orrery azimuth compass|Orrery Azimuth Compass]]

Panning to a new central azimuth by panning 40 degrees at a time can be tedious. To make a large change in the display's center azimuth you may use the azimuth compass. To call up the azimuth compass, tap near the center of the finger-pan area (bottom 1/5 of the display). The compass shown at right will appear:

The locations of the Sun and Moon are shown if they are above the horizon (if they are too close together, only the Sun is shown). You may use your finger or stylus to select another center azimuth. Keep you finger pressed to the display as you select your new center azimuth - the selected azimuth will be shown by a white pointer on the inside of the compass circle. Once you release pressure on the screen, the compass will disappear, and the display will be redrawn.

The azimuth compass cannot be accessed if the display is zoomed.
{{clear}}

== Main Menu ==

[[Image:orreryMainMenu-3.3.png|thumb|200px|alt=Screenshot of Orrery main menu|Orrery Main Menu]]

The main dropdown menu for the orrery has six options:
{{clear}}

=== Other Pages ===

[[Image:orreryOtherPagesMenu-3.1.png|thumb|200px|alt=Screenshot of Orrery other pages menu|Orrery Other Pages Menu]]

The "Other Pages" option takes you to a menu that allows you to display things other than the night sky. With the exception of the flashlight pages, which are dismissed by tapping anywhere on the screen, the "Other Pages" are dismissed by curved arrow in the upper right hand corner.
{{clear}}

==== Flashlight Modes ====

The "White Flashlight" button paints the entire screen white, and the "Red Flashlight" button paints the entire screen red. Both may be used as a flashlight, but the red one is best if you are trying to preserve your [[:wikipedia:Night_vision|night vision]].

==== Sun and Moon ====

[[Image:orrerySunAndMoon_3.2.png|thumb|200px|alt=Screenshot of sun and moon information|Sun and Moon Information page]]

The "Sun and Moon" button displays a page giving the sun and moon positions, rise and set times, phase, etc. for five days, centered on today.

The highlighted date is the current UT date (unless the time menu has been used to select a different time). The highlighted rise and set times are the next ones which will occur at your location. Of course, that may be on a different UT date (for example, during daylight hours, the next sunrise will be tomorrow). The times are shown as UT, which may annoy people. UT is used because the orrery allows you to select any location on the earth, and any time from 3000 BC until 3000 AD. It would be very difficult to keep track of all the timezone, daylight savings change dates, etc. for that time range! So I have wimped out, and displayed UT, which is always reasonably well defined.

The current sun and moon positions shown are geocentric - no topocentric correction has been applied. However topocentric corrections are applied when rise and set times are calculated, so they should be reasonably accurate for a specific location on earth.

The moon illumination percentage shown on the line with the rising and setting times is the value at [[:wikipedia:Astronomical_transit|transit]]. The illumination shown on the line that has the drawing of the moon phase is the illumination percentage at this moment.

This page also shows the UT date and time of the four major moon phases ([[:wikipedia:Lunar_phases#Names_of_lunar_phases|New, First Quarter, Full and Last Quarter]]) for a time span of 10 [[:wikipedia:Lunar_month|lunar months]], centered on the current time (which of course can be changed with the time menu). The nearest time and date when each phase will occur is highlighted.

===== Seasons =====

The Sun and Moon page also displays the precise times at which each of the four seasons begins (spring and autumn equinoxes, summer and winter solstices).

==== Symbol Key ====

This button displays an annotated list of all the symbols used on the orrery display.

==== Big Moon Calendar ====

[[Image:orreryBigMoonCalendar_3.2.png|thumb|200px|alt=Screenshot of big moon calendar|Big Moon Calendar]]

The Big Moon Calendar is a graphic display of the phase of the moon for each day from 10 months before the current month, until 10 months after the current month (roughly 640 days), as shown at right.

Each column shows one month, and the day number is shown for each row. At the top and bottom of each column is shown the first letter of the name of the month shown in the column. Two vertical green lines separate years. The current Universal Time date is outlined in a red box.
{{clear}}

==== This Month's Moons ====

[[Image:orreryMonthlyMoonCalendar_3.2.png|thumb|200px|alt=Screenshot of monthly moon calendar|Monthly Moon Calendar]]

The ''This Mobth's Moons'' page shows the phase of the moon for each day of a particular month. By default, the current month is shown, but one may use the arrow buttons to pan through the months.

Both moon calendars show "[[:wikipedia:Blue_Moon|Blue Moons]]", which are (according to the most commonly used definition) the second full moon in a calendar month which has two full moons. Both images at right show the Blue Moon which falls on New Year's Eve, 2009.
{{clear}}

==== Meteor Showers ====

[[Image:orreryMeteorShower-3.1.png|thumb|200px|alt=Screenshot of Meteor Showers view|Meteor Showers]]

This display shows information for all the [[:wikipedia:Meteor_shower|meteors showers]] which will occur during the current year. Remember that to see a meteor shower, you must travel to a site that has a very dark sky. In a city, few meteors will be seen even during a shower.

The items shown on the Meteor Showers page are:
# the name of the meteor shower
# the abbreviation used for this shower when its [[:wikipedia:Meteor_shower#The_radiant_point|radiant]] is plotted on the sky display
# the expected number of meteors per hour - this is the maximum you will see under the best circumstances with a very dark sky and the shower radiant directly overhead on the date of the shower maximum. If the rate entry says "Var", that means the rate is variable; such shower are not apt to show a large number of meteors per hour.
# the range of dates during which the shower will occur
# the date at which the shower shows the maximum number of meteors
# the typical velocity of the showers meteors in km/sec - larger numbers lead to brighter, bluer meteors
# the percentage of the moon's disk which is illuminated on the date of shower maximum - full moon = 100%. A minus sign following the percentage means the moon is [[:wikipedia:Lunar_phase#Names_of_lunar_phases|waning]], a plus sign means it is [[:wikipedia:Lunar_phase#Names_of_lunar_phases|waxing]]. Moonlight greatly interferes with seeing meteors
# the number of dark hours on the date of the shower maximum - defined as the time during which the sun is more than 12 degrees below the horizon, and the moon is far enough below
the horizon to not appreciably brighten the sky.

The Meteor Showers page shows information for all showers, the large majority of which are really minor events. Even when a meteor shower is not occurring, you can expect to see 4 to 10 meteors per hour. Many of the showers listed do not even double that background rate, and are of interest only to serious meteor enthusiasts. If you just want to go out and see some meteors for fun, it's best to select a shower with a rate of at least 50 meteors per hour, and to watch it on or very near the date of the shower's maximum.

Each line of the display describes a separate shower. If the shower currently in progress, the line is shown in green - bright green if there will be 2 or more hours of dark sky tonight, and dark green otherwise. If the shower is not currently underway, it will be shown in a cream color if on the night of the shower's maximum, the sky will be dark for at least 2 hours. Otherwise the shower information will be shown in grey, indicating that this year is not a good one to observe that particular shower.

At the bottom of the Meteor Showers page is shown the number of dark sky hours to expect tonight. In this context, "tonight" means the upcoming night if the sun is currently above the horizon, or the current night, if the sun is below the horizon.

If you wish to get meteor shower information for a different year, simply change in year using the time menu.

Many thanks to the International Meteor Organization (http://www.imo.net/imo/intro)
for permission to use their data to produce the meteor shower related displays.

==== Planet Compass ====

[[Image:OrreryPlanetCompass_3.2.png|thumb|200px|alt=Screenshot of moon calendar|Moon Calendar]]

The Planet Compass page graphically shows where each of the planets is at the current time.

The image has one complete circle, which shows the planet azimuth, and one semicircle, which shows the [[:wikipedia:Altitude_(astronomy)|elevation]].

The azimuth circle has blue triangles marking the four [[:wikipedia:Cardinal_points|cardinal points]]: North, South, East and West. There are small tick lines at the NE, SE, SW and NW directions, as well as a small dot every 10 degrees. The planet symbols are shown with lines projecting to their current azimuth. The line is white if the planet is above the horizon, and red if it is below the horizon.

The elevation semicircle has blue triangles marking the directions of the Zenith, Horizon and Nadir. Small dots are shown every 10 degrees, and there are short lines at +-45 degrees. As with the azimuth circle, lines connect the planet symbols to their current elevations.

Below the compass graphic, the name, [[:wikipedia:Hour_angle|Hour Angle]] (HA) rising time and azimuth, transit time and elevation, and setting time and azimuth is shown for each planet. The name of the planet is shown in green if the planet is currently above the horizon, or red if it is not. The time of the next event - rising, transiting or setting, is also highlighted for each planet.
{{clear}}

==== Solar System ====

The program can display the relative planet positions in two different ways. In both cases, the view is from the north looking down, with the direction of the [[:wikipedia:Vernal_Equinox|Vernal Equinox]] to the left of the screen (marked with the vernal equinox symbol, and an arrow). At the time of the vernal equinox, the earth will be at the 3 o'clock position in its orbit, so that the Sun will appear at the vernal equinox position.

===== Schematic Solar System View =====

[[Image:OrrerySchematicSolSys_3.2.png|thumb|200px|alt=Screenshot of schematic solar system view |Solar System View (schematic)]]

This button presents a schematic view of the Solar System, showing the locations of the earth, the earth's moon and the other planets in their orbits around the sun. The view is schematic in the sense that the orbit radii and planet sizes are not shown to scale. However the positions of the objects within their orbits are correct (the heliocentric [[:wikipedia:Ecliptic_longitude|ecliptic longitudes]] are correct).

Several buttons are drawn at the bottom of the display, which allow you to show an animation of the motion of the Solar System objects for several time increments. Showing the motion of planets in this way is what mechanical orreries do.
{{clear}}

===== To-Scale Solar System View =====

[[Image:OrreryToScaleSolSys_3.2.png|thumb|200px|alt=Screenshot of to-scale solar system view|Solar System View (to-scale)]]

This button displays the Solar System with the planet orbits shown with
the proper relative sizes. The orbits are also plotted as [[:wikipedia:Ellipse|ellipses]] in this display, with the correct eccentricity and orientation. The moon is not plotted, because it would be too close to the earth to display if any of the planet orbits were completely shown. Because Neptune's orbit is nearly 100 times larger than Mercury's, it is not possible to display all of the planet orbits simultaneously. There are "Zoom In" and "Zoom Out" buttons which allow you to select which proper subset of planet orbits is shown. The current position of each planet in its orbit is shown. Also plotted are grey lines connecting the Sun to each orbit, terminating with a white dot at the position of the planet's [[:wikipedia:Perihelion#Planetary_perihelion_and_aphelion|perihelion]] (where it is closest to the sun in its orbit). The image at right shows the display when the outermost plotted planet is Mars. Note that the orbits of Mercury and Mars are quite non-circular.
{{clear}}

==== Astronomical Times ====

[[Image:OrreryTimesPage.png|thumb|200px|alt=Screenshot of astronomical times view|Astronomical Times Page]]

This button displays the current value of several astronomically important time scales, including the [[:wikipedia:Julian_day|Julian Date]] (JD), the Modified Julian Date (MJD), which is simply the JD - 2400000.5, the [[:wikipedia:Universal_Time|Universal time]] (UT), the [[:wikipedia:Equation_of_time|Equation of time]] (Eq. of Time), which is the difference between mean solar time and sundial (apparent) solar time, and the Equation of the Equinoxes (Eq. of Equin.), which is the very small difference between the Mean [[:wikipedia:Sidereal_time|Sidereal Time]], and the Apparent Sidereal Time. All of those values are the same anywhere in the world. Also displayed are several times specific to the location you are at (or have selected): The Mean Solar Time, the apparent solar time (the time shown by sundials), the Mean Local Sidereal Time (Mean LST) and the apparent local sidereal time (App. LST). Unlike the other orrery pages, this page is updated rapidly (at 10 Hz), so that you can see the exact current values.
{{clear}}

==== Analemma ====

[[Image:OrreryAnalemma.png|thumb|200px|alt=Screenshot of analemma view|Analemma]]

This button displays the [[:wikipedia:Analemma|Analemma]] for the current time, or the time which has been selected with the Change Time button. The analemma's horizontal axis is the Equation of Time value, which is the difference between Mean Solar Time (what a clock set to your local time, not your timezone time, would show) and the Apparent Solar Time (what a sundial would show - the time defined by the position of the real sun in the sky). The vertical axis shows the elevation of the sun above the horizon, at noon, from your location (or the location you have selected). The analemma is labeled with a year, because it slowly changes as the earth's orbit changes and the earth's pole wobbles. No phone can really be called a smartphone if it cannot show the analemma. The analemma page takes a second or two to display - nearly 750,000 trigonometric function calls are needed to calculate it accurately!

When the Equation of Time is negative, clocks run ahead of sundial (apparent solar) time.

If you were to photograph the sun, at the same time each day, the resulting set of sun images would trace out the analemma. The analemma can be used to calculate the direction of the sun's rays at your location.
{{clear}}

==== Planet Elevations ====

[[Image:OrreryPlanetElevations.png|thumb|200px|alt=Screenshot of Planet Elevations|Planet Elevations]]

The "Planet Elevations" page offers another way of seeing if and when the planets will be visible. A typical display is shown at the right.
The page shows a plot of one full day, with time increasing as you move to the right of the plot. The Universal Time is shown at the top of the plot, and the Local Sidereal time is shown at the bottom. The grey line in the center of the plot marks local midnight (which, in general will ''not'' be timezone midnight). There is a horizontal line drawn for the Sun, the Moon and each of the planets (except earth!).
The line for the sun is drawn in red; for other objects the portion of the line which is drawn in white shows when the object is above the horizon at night and the portion shown in grey shows when the object is above the horizon during daylight. Below each object's line is shown a series of tick marks with the elevation of the object at that time shown below. Below the center of each object line, the elevation of the source at transit is shown. There are grey vertical lines shown covering the entire height of the plot marking sunrize and sunset. In between those lines, the Sun is below the horizon, and a planet may be visible. There is a colored vertical line, with a UT time at the top and an LST at the bottom. That line shows the current time, and it is red if the Sun is above the horizon, yellow during twilight, and green when the sky should be pretty dark. If that line intersects an object line (in the plot shown here, it intersects the lines for Mars, Jupiter, Uranus and Neptune) that object is above the horizon, and the object's current elevation is shown next to the current time line (in this case, 2 degrees for Mars, 58 for Jupiter, 44 for Uranus and 18 degrees for Neptune). If the sky is dark, and the object is above the horizon, its name is shown in green. Otherwise, it is shown in red.

One can obviously change the time on using the orrery's "Change Time" menu item, and then use this page to see the range of time that any planet will be visible for, at any time from 3000 BC until 3000 AD.

One little wrinkle for this display is when to update the tracks for the next day. In other words, if an object is currently below the horizon, is the elevation track shown correct for today, or tomorrow, or yesterday? This doesn't really matter for anything other than the Moon, because no other object moves on the sky enough during one day to make its track change significantly. But a one day change in the Moon's position is very significant. The way the orrery handles this is to switch to the next day's tracks at local noon. So once noon passes, the tracks will be correct for the night which begins at the next sundown. Before local noon, the tracks are correct for the night which ended at the most recent sunrise. This means that the tracks should be correct at all times when the sun is down.

{{clear}}

==== Planet Phenomena ====

[[Image:OrreryPlanetPhenomena.png|thumb|200px|alt=Screenshot of Planet Phenomena|Planet Phenomena]]

The "Planet Phenomena" page shows the date and hour of the most recent and next [[wikipedia:Conjunction_(astronomy_and_astrology)|conjunction]] and [[wikipedia:Opposition_(planets)|opposition]] (for [[wikipedia:Superior_planets|superior planets]]). For [[wikipedia:Superior_planets|inferior planets]], the inferior and superior conjunction dates are shown, along with the date of greatest eastern and western elongation, and the separtion from the Sun on those dates. Mercury and Venus are most easily observed around the date of greatest elongation. In fact, it's virtually impossible to see Mercury with the unaided eye, except very near the time of greatest elongation. When Mercury or Venus is at greatest eastern elongation (labeled "Max. East" on the table) the planet is visible after sunset in the evening. Near greatest western elongation (labeled "Max. West") it is visible before sunrise in the morning.

The dates and times shown on this page have an accuracy of about +- one hour.
{{clear}}

==== Jovian Moons ====
[[Image:orreryJovianMoonGraph.png|thumb|200px|alt=Screenshot of the Jovian Moon Graph Page|Jovian Moon Graph Page]]
The Jovian Moons page displays information about the positions and
phenomena for the four largest moons of Jupiter - the [[wikipedia:Galilean_moons|Galilean Moons]]. These moons are easily seen with even small binoculars. Some sharp-eyed people claim to be able to see them with their unaided eyes. The moons are easily bright enough to be seen with the unaided eye, and at least the outermost two get far enough away from the planet's disk to be resolved by a human eye. But the dazzling brilliance of Jupiter so near the moons makes viewing them without optical aid very difficult.

A screenshot of the Jovian Moon first page is shown on the right. At the top of the page is a plot showing Jupiter and
its four main moons, which are color coded for easy identification, in their proper positions for the current time (or any other time you set). All four moons will not always be visible - sometimes they pass behind Jupiter and are
blocked from our line of sight. Occasionally the shadow of one of the moons will pass across Jupiter's disk, and that shadow too will be shown in the plot.
Because the inclination of Jupiter's axis is only 3 degrees, and the moons orbit nearly in Jupiter's equatorial plane, these moons appear to move nearly on a line, with Jupiter in the center. Eclipses for the three innermost moons happen very frequently, and Callisto, the outermost Galilean Moon, is eclipsed less frequently. Which side the moons appear on depends upon what equipment you use to observe them. Many telescopes invert or mirror reflect the image.
There are four buttons near the bottom of the page which allow you to
invert and reflect the plots, to make them match what you see with your equipment.

Most of the page is taken up with "wiggly line" plots which show the east-west positions of the moons throughout the current month. They are color coded, for identification. At the position in the plot corresponding to the current time, the lines are interrupted, and dots representing the moons are plotted.
Although these lines look like simple sine waves, they are not. The moons (and other objects) perturb the orbits o these moons, making the motion far more complex than simple harmonic motion. The two cream-colored vertical lines in each plot shows the size of Jupiter's disk. You can see on the plot when a moon passes in front of or behind Jupiter. There is a scale at the bottom of the plots which allows you to see the separation in arc seconds. This scale changes as the distant to Jupiter from the Earth changes.

At the bottom of the page is a button you can press to go to the "Events" page.

{{clear}}
[[Image:orreryJovianMoonEvents.png|thumb|200px|alt=Screenshot of the Jovian Moon Events Page|Jovian Moon Events Page]]

The Events page lists the times of the satellite events such as eclipses, occultations and transits. This page takes a second or so to plot,
because it requires roughly one million double precision trigonometric functions to be evaluated (the event timings are calculated by your phone, not fetched from a website). Since the app is location-aware, it can tell you which of these events will be visible to you from your current location. If the Sun is above the horizon, or Jupiter is below the horizon, you cannot see a satellite event; such events are listed in grey. Events that you can see are shown in green, except for he ''next'' event you can see, which is shown in red. The times are all in UT, of course. The plot on the right shows the events for the very special evening of Oct 12, 2013. On that night three satellite shadows crossing Jupiter's disk are visible at once (see plot at the top of the page). The color coding shows that this rare triple shadow event will be visible from my current location.

At the bottom of the Events page is a button you can click to return to the Graph page.
{{clear}}

=== Displayed Items ===

The "Displayed Items" page allows you to configure the display, selecting such things as the faintest magnitude object displayed, whether constellation lines are plotted, whether or not star names are displayed, etc.

==== Deep Sky Objects ====

[[Image:orrerySagitarriusClusters_3.2.png|thumb|200px|alt=Screenshot of star clusters in Sagittarius|Star clusters in Sagittarius]]

If you select "Deep Sky Obs" from the "Displayed Items" menu, you will be shown some of the brightest [[:wikipedia:Deep_sky_object|Deep Sky Objects]]. Deep Sky Objects are objects such as galaxies, expelled envelopes of dying stars, clusters of young stars and luminous gas. A few, such as the Andromeda Galaxy, are visible to the unaided eye. Many more are visible with binoculars or a small telescope. The orrery shows all [[:wikipedia:Messier_object|Messier objects]], and many other well known bright nebulae and star clusters. The image bellow shows the Messier objects in Sagittarius.

===== Adding Your Own Deep Sky Object List =====

You may add your own list of deep sky objects to be plotted. Simply create a file within the directory <code>/usr/share/orrery/deepSky/</code> with any name. The file should contain lines of text with the format:

name HH MM SS.SS DD MM SS.S type mag

where name is the object name, which may not include white space, HH MM SS.SS is the Right Ascension, DD MM SS.S is the declination (do not include a + sign for positive declinations) "type" is an integer specifying the type of object:
* 0 = [[:wikipedia:Supernova_remnant|Supernova Remnant]]
* 1 = [[:wikipedia:Globular_cluster|Globular Cluster]]
* 2 = [[:wikipedia:Open_cluster|Open Cluster]]
* 3 = [[:wikipedia:Nebula#Diffuse_nebulae|Diffuse Nebula]] ([[:wikipedia:H_II_region|HII region]], etc.)
* 4 = [[:wikipedia:Planetary_nebula|Planetary Nebula]]
* 5 = [[:wikipedia:Galaxy|Galaxy]]
The "mag" is the visual magnitude. The orrery program currently does nothing with the visual magnitude, but future versions may use it.

==== Meteor Radiants ====

If you select Meteor Radiants, then the radiant position for any meteor showers which are now occurring will be plotted. The radiant is the position in the sky from which meteors seem to emerge during a shower - it's the best place in the sky to look for meteors.The radiant is plotted in white if more than 50 meteors per hour are expected under optimal viewing conditions, cream-color if 20 or more meteors per hour are expected, and grey if fewer then 20 meteors per hour are expected. Note that these are meteor rates for the date of the shower maximum - see the Meteor Showers page for more information. The radiant position usually changes as the shower progresses. The orrery takes that into account when plotting the radiant.

==== Changing the Magnitude Limit ====

The magnitude scale for expressing the brightness of stars and planets is explained [[:wikipedia:Apparent_magnitude|in this Wikipedia article]]. It is one of the oldest
measurement systems still in use today.

By default, the orrery displays every star a person with excellent eyesight located in a very dark area on a moonless night can see. If your observing conditions are less ideal than that, it can be helpful to use the "Mag. Limit" field in the item menu to lower
the limit of the faintest object plotted.

==== Star Names ====

[[Image:OrreryNamesWithZooming5.png|thumb|400px|alt=Screenshot of star names|Star Names]]

Selecting Star Names will cause the traditional, western names for stars to be displayed. Most of these names are corrupted versions of ancient Arabic names. If you zoom the image, more names will be shown.
{{clear}}

==== Bayer Designations ====

[[Image:OrreryBayerNames.png|thumb|400px|alt=Screenshot of Bayer star names|Bayer star Names]]

As an alternative to displaying the names of the bright stars, you can instead display the [[:wikipedia:Bayer_designation|Bayer Designations]]. These are the designations using Greek letters, like the well-known "[[:wikipedia:Alpha_Centauri|Alpha Centauri]]". It is recommended that you do not display both the star names and Bayer designations at the same time, because the display will become rather crowded. As with star names, if you zoom the display, more Bayer designations will become visible, as shown at right.
{{clear}}

=== Change Time ===

The "Change Time" page allows you to specify an explicit time between 3000 BC and 3000 AD, or the current time. If "Now" is selected, the current time is used and the display updates automatically once per minute. If a specific time is selected, it is shown in red, to remind you that the display is not going to update automatically as time passes. The time may be specified as a calendar date, or as a Julian Date.

If the Calendar checkbox is selected, you can choose the date and time (UT) using the normal Hildon selector widgets for these quantities. Note - this option only allows dates from 1900 to 2100 AD to be selected. To chose a date outside that time range, you must use the Text Entry option.

The [[:wikipedia:Julian_Date|Julian Date]] is a less ambiguous way of entering times
in the distant past than using a calendar date, because of the differing calendar systems in use worldwide before the late 16th century. For example, the date October 10, 1582 never occurred in some European countries. Many countries have gaps in their calendars
with missing dates when they adopted the [[:wikipedia:Gregorian_Calendar|Gregorian Calendar]].

Note about the Text Entry option: At this time, the numeric fields can only be changed with the keyboard's up/down arrow keys, or with text entry via the soft keyboard.

=== Change Location ===

This page allows you to select the position of the observer on the earth's surface. You can use the position derived by the N900 itself (either from cell tower coordinates or GPS), a user specified latitude and longitude, or a location selected from a menu.

If you chose the "Phone" option, the most recent position derived by the N900 will be used. If the phone has not yet established a position, the default location will be used until the phone has derived a position.

If you choose the "Custom" option, you may enter a new position by typing text into the "Name" field, and using the "Longitude" and "Latitude" selection widgets. Don't forget the "West", "East", "North" and "South" buttons - they select the sign of the latitude and longitude. Once you've entered a new custom position, you'll be given the option of saving it in your private catalog.

To choose a predefined position from a menu, select the "Menu" option near the bottom of the page. You will notice that the "Region" menu will then become highlighted. Push "Region", and then select the continent or category of the area you want the sky to be shown for. Once you have selected a region, a pull-down menu with the name of that region will appear next to the "Region" button. Use that new menu to select your city. After the city is selected, its name will appear next to the regional menu.

If you select a "Custom" or "Menu" location, a button labeled "Save in Private Menu" will appear. After you select your new position, you may push that button to save it in the menu labeled "Private". That menu is initially empty.

If you would like to add additional cities, etc. to one of the menus other than the private menu, you may simply edit one of the menu files, and add the name, latitude and longitude of the location. The lists of locations are stored in ASCII text files under the menus subdirectory of the program installation area on your phone. You will need to reload the "Change Location" page for your new locations to become available.

==== How to change the default location from Boston ====

To change the default location, just use the "Change Location" menu option to select a new
location as described above. That will make the currently selected position your new default location, which will be used whenever the program is started, unless "Phone" is selected as the source for position information.

=== Web Help Page ===

This button brings up this wiki page in the browser, provided you have a network connection.

=== Quick Tips ===

This button brings up a page with a few basic instructions for operating the program. It does not require a network connection.

== Minimized Display ==

[[Image:OrreryMinimized.png|thumb|200px|alt=Screenshot of minimized orrery|Minimized Orrery]]
When the orrery window is minimized by the N900's window manager, it produces a different display which is legible even when the window is in its shrunken state. The image at the right shown this minimal mode, when the N900 is in landscape mode. It shown the phase of the moon in the center, and plots indicating the Sun (far right plot) and Moon (far left plot) azimuth (outside triangle) and elevation (inside arrow). The triangle and arrow are green if the object is currently above the horizon. At the top of the display, the UT is shown, and the bottom of the display has the LST. These are continuously updated.

In portrait mode, the minimized display shows the names of each planet that is currently above the horizon (not including uranus and Neptune, which are not visible to the unaided eye). The elevation of the planet, in degrees, is also shown, in green if the source has not yet passed through transit, and red otherwise.

{{clear}}

== Touchscreen Gestures ==

There are four types of touchscreen gestures which you can make in the plotting area which are recognized by the orrery: Taps, Zooms, Pans and Presses.

=== Taps ===

If you press the display area, and withdraw your finger or stylus within 0.25 seconds, that gesture is considered a tap. Tapping in the lower 1/5 of the display area will pan the display in azimuth. Tapping anywhere else toggles between the default screen and the constellation screen.

=== Zooms ===

If you press the screen and trace out a roundish figure, and remain in contact with the screen for more than 0.25 seconds, and if the figure encloses a nontrivial (> 300 pixels) area, the gesture is considered to be a zoom. As you move your finger or stylus, the region you are outlining will be shown as a green dotted line. After you release your finger from the display, a red box will be shown. The red box is a rectangle with the aspect ratio of the display area, and the same area and centroid as the region you
traced out with your finger. The display will then be zoomed so that the region in the red box fills the display area.

Zooming can do some non-intuitive things, especially if you zoom near the upper left or upper right of the display. This is because the orrery's transverse mercator projection always has a line of constant azimuth in the center. This means that something zoomed
at the edge of the display area will be rotated as it is zoomed, and some of the stars you wish to display may be rotated out of the display area. It is best, especially if you are zooming in on an area near the zenith, to first pan the display so that the region
is near the center of the display, before zooming. The nice thing about the transverse mercator projection is that a zoomed area is displayed with the orientation it would have if you were directly facing it at the time indicated by the display.

If your zoom area includes the zenith, the display may do weird things. This is a bug.

'''To unzoom - just press the screen for longer than 0.25 seconds, without moving your finger (much)'''.

=== Pans ===

A pan is like a zoom, but with a more linear, rather than roundish gesture. A pan can be used to move the center of a zoomed region. It has no effect if the display area is not zoomed. After you release your finger or stylus following a zoom gesture, orrery will show the region you traced out in green, and will draw a red arrow showing the direction and size of the pan. After that, the display is re-drawn with the new center position.

=== Presses ===

If you push down on the touchscreen for more than 0.25 seconds, and do not move your finger or stylus significantly while making contact, you will have made a press gesture. Since one almost always moves one's finger a little by while pressing the screen, some small motion is allowed during a press gesture. This means that a zoom or pan gesture cannot be arbitrarily small, because it will be interpreted as a press.

If the screen is zoomed, then the press gesture unzooms it. If the screen is already unzoomed, then the press gesture has the same effect as a tap gesture.

== Symbols ==

=== Symbol Key ===

[[Image:orrerySymbolKey_3.2.png|thumb|200px|alt=Screenshot of Orrery symbols|Symbols used by the orrery]]

If you select "About Orrery / Symbol Key" from the "opts" menu, you will be shown an annotated list of the symbols used by the orrery, which is reproduced at right.

NOTE: the current version is 3.5.

=== Planet Symbols ===

The solar system symbols, used by default on the constellation page (screen two), are the standard astronomical symbols for these objects. They are explained
[[:wikipedia:Planet_symbols|on Wikipedia]].

=== Plotted Lines ===

The dotted yellow line is the Celestial Equator, the intersection of the Earth's equatorial plane with the celestial sphere. The red dotted line is the Ecliptic. The Ecliptic is the intersection of the Earth's orbital plane with the celestial sphere. The Ecliptic is also the path of the Sun across the sky, and the intersection points between the Celestial Equator and the Ecliptic are where the Sun is at the time of an equinox. Constellations lying along the Ecliptic plane are zodiac constellations. The planets and the Moon are always near, but usually not exactly on, the Ecliptic. The blue-green dotted line is the Galactic Plane, the intersection of the plane of the Milky Way's disk and the celestial sphere.
{{clear}}

== Displaying Stars Too Faint for the Unaided Eye to See ==

The default sky catalog used by the orrery contains every star you can see with your unaided eye, even if you have exceptionally good eyesight, and are located in a very dark area on a moonless night. If you wish to display stars which require binoculars or a small telescope to be seen, you can download the file hipparcos_9.0.dat from the
[https://garage.maemo.org/projects/orrery/ orrery area of the gForge site].

You must load this file onto your phone, of course, but you probably will want to store it on the removable microSD card, because the file is so large (3 megabytes). You must make a softlink in the top of the orrery files area called "faintStars", which will point to where the hipparcos_9.0.dat is actually stored. For example, if you do the default installation of the orrery, and if you store the hipparcos_9.0.dat at the top directory of your microSD card, you must issue the following command to make the faint star catalog usable:

ln -s /media/mmc1/hipparcos_9.0.dat /usr/share/orrery/faintStars

You must restart the orrery after making this softlink.

Once the new catalog and softlink are in place, the orrery will allow you to change the maximum magnitude (using the "Displayed Items" menu option) all the way up to magnitude 9.0. Note that the default, smaller catalog is still used if the maximum magnitude is no larger than 6.6, so you may used the orrery with the faint star catalog, and not incur and performance penalty as long as you restrict yourself to stars no fainter than 6.6. The faint (mag > 6.6) stars cannot be displayed in constellation mode.

The default orrery star catalog contains 9931 stars. hipparcos_9.0.dat contains 83392 stars, and is complete to 9th magnitude. The orrery will be more sluggish if you choose to display stars fainter than 6.6, because it must process the larger star catalog.

The plot below shows [[:wikipedia:Hyades_(star_cluster)|Hyades star cluster]] with limiting magnitudes of 6.6 (left) and 9.0 (right).

[[Image:orreryHyadesMagComp.png|thumb|400px|alt=Screenshot of Orrery catalogs|Orrery Catalogs]]

Remember, there's no reason at all to install the hipparcos_9.0.dat file unless you plan to do star gazing with binoculars or a small telescope.
{{clear}}

== Chinese Color Scheme ==

In traditional Chinese astronomy, the zodiac is known as the Yellow Way, and the celestial equator is known as the Red Way. If you want the orrery to use that color scheme for great circles and constellations, edit the file <code>/usr/share/orrery/config</code>, and make the first lineread

CHINESE_COLOR_SCHEME 1

You will need to restart the program.

== Bugs! (and some workarounds) ==

=== Preserving the Private Catalog ===

If you installed the first version of the orrery program (3.0.x), and if you made location entries in the "Private catalog", upgrading to the 3..1.3-1 version will delete your "Private catalog", and all your saved locations will be lost. You may prevent this by using "X Terminal" to issue the following commands '''before upgrading''':

mkdir /home/user/.orrery
cp /opt/maemo/usr/share/orrery/menus/Private /home/user/.orrery/

== Contact Information ==

Please send [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] comments, suggestions, questions and/or abuse to orrery.moko@gmail.com

[[Category:Software]]
[[Category:Users]]

Hebrew

2011-12-15T03:09:03Z

114.79.28.10: /* Specific applications */

''These instructions refer to previous devices, for N900 please go to [[Hebrew N900]]''

This guide covers setting up Hebrew support in Maemo. These instructions assume [[root access]].

= Hebrew for N800/810 =

== Fonts ==

* Copying some Culmus fonts (Nachlieli, David, etc.) or Windows fonts with Hebrew (Arial, Tahoma, etc.) to <code>/home/user/.fonts</code> is useful in some applications.
* Some applications' interface elements use Nokia fonts, so they need to be replaced with fonts that include Hebrew glyphs. Unfortunately, the fonts Nokia use are not free, so I can't distribute the Hebrew including version. To generate these fonts:
** Copy the files <code>nosnr.ttf</code>, <code>nosnb.ttf</code>, and <code>nscnr.ttf</code> from <code>/usr/share/fonts/nokia</code> on the device to a PC.
** Make sure you have [http://fontforge.sourceforge.net/ FontForge] installed.
** Copy Nachlieli Culmus fonts (all files beginning with Nach) from where they are installed in your system to the same directory as the Nokia files.
** Download [http://www.arava.co.il/matan/770/heb/fontmerge fontmerge] and run it in the same directory. to do that run:
::<code>fontforge -lang=ff -script fontmerge</code>
<ul><ul>
<li>Copy the generated <code>nosnb-h.ttf</code>, <code>nosnr-h.ttf</code>, and <code>nscnr-h.ttf</code> to <code>/usr/share/fonts/nokia</code> on the device, and remove the <code>-h</code> from the name, in order to overwrite the original fonts.</li>
<li>Other fonts that might need to be fixed similarly are <code>NtmRR4nh.ttf</code>, <code>NcrRR4nh.ttf</code>, and <code>SwaRR4nh.ttf</code> from <code>/usr/share/fonts</code>. This can be done with the [http://www.arava.co.il/matan/770/heb/fontmerge2 fontmerge] script. It seems that <code>SwaRR4nh.ttf</code> is the font used for the keyboard keys, so you must do this if you want to use Hebrew keyboard.</li></ul>
<li>After installing or changing fonts, you should run <code>fc-cache -f</code>. A reboot might be needed for some applications or parts of the GUI to use the new fonts.</li></ul>

== Virtual keyboard ==

Copy the file <code>[http://www.arava.co.il/matan/770/heb/he_IL.vkb he_IL.vkb]</code> to <code>/usr/share/keyboards</code>. Then he_IL is added to the list of available languages for the keyboard.

== iconv modules ==

These modules are necessary for some applications (FBreader, Minimo). Download <code>[http://www.arava.co.il/matan/770/heb/gconv.tar.gz gconv.tar.gz]</code> to the device, and run (as root):
<pre>
tar xzf gconv.tar.gz -C /usr/local
iconvconfig /usr/local/gconv
</pre>

== Miscellaneous ==

* [http://live.gnome.org/Hildon/HowtoRTL HowToRTL] vaguely relates to BiDi

== Specific applications ==

* Included Opera has no BiDi support, but MicroB (Mozilla based browser) does support BiDi.
* Minimo works (both display and input), as long as gconv modules are installed.
* Claws appears to display Hebrew fine, as long as the encoding is correctly identified in the mail itself.
* FBReader: [http://www.arava.co.il/matan/770/heb/fb-0.8.1-bidi.diff patch] for rudimentary BiDi support. You can install regular packages of FBreader 0.8.1, and use [http://www.arava.co.il/matan/770/heb/FBReader this binary] to replace <code>/usr/bin/FBReader</code> on the device.
* [http://www.arava.co.il/matan/770/heb/links links-2] (graphics) with some BiDi support is available (just run this binary from XTerm) [http://www.arava.co.il/matan/770/heb/links-fribidi.diff Patch] (relative to 2.1pre23) [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm].
* MaemoTeX - [http://www.arava.co.il/matan/770/heb/tex.tgz this] adds Hebrew (and ams) support to MaemoTeX 0.1.6. Just untar it from root directory, and run <code>mktexlsr</code>. Leafnode appears to have no problems editing ISO-8859-8 files.

[[Category:Internationalization]]
[[Category:Power users]]
[[Category:N8x0]]

N900 FM radio transmitter

2011-12-15T03:08:00Z

114.79.28.10: /* Typical Range */

The N900 has a FM radio transmitter capable of sending audio several meters.

==Hardware==

The SI4713 chip is used to transmit FM radio with radiotext in the range 76-108MHz from a digital or analog audio input.

=== Features ===

From the datasheet:
* Integrated receiver for receive power measurement
* Worldwide FM band support (76–108 MHz) for transmit
* Requires only two external components
* Frequency synthesizer with integrated VCO
* Digital stereo modulator
* Programmable pre-emphasis (50/75 µs)
* Analog/digital audio interface
* Programmable reference clock
* RDS/RBDS transmit encoder (Si4713 only)
* PCB loop antenna support with self calibrated capacitor tuning
* Programmable transmit level
* Programmable modulation
* 2.7 to 5.5 V supply voltage
* Digital gain compression
* Integrated LDO regulator
* 3 × 3 × 0.55 mm 20-pin QFN
* Pb-free and RoHS Compliant

It is short range only, see the section on [[#Typical Range|typical range]].

It can also receive the signal level on the tuned frequency. This enables transmitter application to scan all frequencies, checking for vacant ones, and suggesting empty frequencies to the user for selection as transmission frequencies.

The [[Nokia N900|N900]] controls the FM transmitter through the I2C(2) bus, and supplies analog audio (same audio lines as HP-AMP) to the transmitter. The transmitter's digital audio inputs are unused (NC).

The FM signal is transmitted from a loop antenna built into the case, and connected to the PCB with clips.

product marketing sheet: https://www.silabs.com/products/audiovideo/fmtransmitters/Pages/Si471213.aspx
Full datasheet available there immediately after registering.

The documentation for the driver, along with some information on the chip is at
http://www.mjmwired.net/kernel/Documentation/video4linux/si4713.txt

It is connected to the [[N900 Hardware Bus I2C|I2C]] bus-2.

==Software==
===Kernel===
It is controlled through the kernel module fmtx_si4713, which implements the interfaces /dev/radio0 - a video4linux device.

v4l2-ctl dumps the following information about the device.

v4l2-ctl --all -d /dev/radio0
Driver Info:
Driver name : radio-si4713
Card type : Silicon Labs Si4713 FM Radio Tr
Bus info : I2C: 0x63
Driver version: 1
Capabilities : 0x00010000
Tuner
Video input : 0
Frequency: 1400000 (87.500000 MHz)
Video Standard = 0x00000000
Streaming Parameters Video Capture:
Frames per second: 25.000 (25/1)
Read buffers : 0
Tuner:
Name : FM Transmitter
Capabilities : 62.5 Hz stereo
Frequency range : 87.5 MHz - 108.0 MHz
Signal strength/AFC : 0%/0
Current audio mode : stereo
Available subchannels: stereo

See [http://www.stanford.edu/~blp/fmtools/ for more information on the video4linux API].
The driver also exposes the sysfs directory ./class/i2c-adapter/i2c-2/2-0063/ .

===User===
The FM transmitter can be enabled in the settings application, and there are third party applications to more easily enable it.

No software currently uses the ability of the chip to scan for free channels.

The package [http://maemo.org/packages/view/fm-boost/ FM boost] maximizes the transmitter power. In some cases, this may improve reception. In others, the transmitter will already be set to highest output.

There are several bugs open with regards the FM transmitter [https://bugs.maemo.org/show_bug.cgi?id=6792 this one] for example is regarding the policy to turn off the FM transmitter when the device is plugged into a computer using the USB cable.

The D-Bus interface is documented in [http://maemo.org/api_refs/5.0/5.0-final/fmtx-middleware/fmtx_api.html this page]

==Typical Range==

Low power transmitters that are license compliant - do not exceed the regulations - are inherently short range devices and will have poor performance in many desired use-cases simply due to the regulatory limit on power usage.

In the US - the limit is approximately 15 nW, in the UK, 50 nW.

The below OFCOM document lists ranges to a good receiver with a fully extended antenna as 4m for 15nW and 8m for 50nW. (to achieve 'noiseless' reception)

[http://www.ofcom.org.uk/radiocomms/ifi/licensing/classes/rlans/technical/tests/srdtests.pdf This document from OFCOM [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] (UK licensing agency) outlines test results for 50nW devices)] [http://www.ofcom.org.uk/consult/condocs/wtexemption/responses/bbc.pdf and this is a BBC response to the OFCOM proposal to legalise them in the UK]. Quoting the second:

:"The BBC appreciates the advantage in principle of authorising for licence-exempt use low-power Band II transmitters constructed strictly to a common European type-approval regime and ‘CE’ marked.

:However, the chosen maximum ERP of 50 nW is neither sufficiently small to avoid creating interference to broadcast reception nor sufficiently large to guarantee that such ‘Micro’ FM transmitters will actually work as intended in areas where Band II is utilised intensively, such as London."

[[Category:N900]]
[[Category:N900_Hardware]]

SMSCON Editor

2011-12-15T03:06:53Z

114.79.28.10: /* Installation */

The SMSCON Editor is a user interface to the configuration of the [[SMSCON]] application. Further, it can assist in verifying its correct operation and configuration.

It has been created using the PyQT libraries and the functionality is provided by Python.

With its assistance the user is able to edit from a GUI all the options and name the secret pass-phrases of the commands used for controlling the device by the [[SMSCON]]. All settings are stored at its configuration file, i.e. the <code>/opt/smscon/smscon_config</code> file.

In addition, it provides an interface to initialise (i.e. init, start, stop, reset and set/remove from the device's boot sequence) the <code>smscon_daemon</code>.

==Installation==

The application can be installed directly by the Application Manager (HAM) and the [[Extras]] repositories. [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] (Check [http://maemo.org/packages/view/smscon-editor/ here] for its status)

You can also find the latest version in the [https://garage.maemo.org/frs/?group_id=1848&release_id=4063 garage project page].

===Dependencies===

The editor depends to the following packages:
* smscon
* python2.5
* python2.5-qt4-gui
* python2.5-qt4-core
* python2.5-qt4-maemo5

==Usage==

When it starts it loads the current configuration file so that the options already configured to be shown in the appropriate sections of the GUI.

FIXME: add explanations

===Start up===

A banner will popup showing the correct startup, i.e. the <code>smscon_config</code> file is correct and that it has been successfully loaded by the editor.

[[Image:SMSCON_Editor_Startup.png|400px]]

(Since version 0.6) a password dialog will open and request the application password

'''NOTE:''' the default password for the SMSCON Editor is '''12345''' and should not be mistaken with the password that might be requested during the installation of the OpenSSH server (which is a dependency of [[SMSCON]]).

[[Image:SMSCON_Editor_AskPassword.png|400px]]

===General configuration tab===

[[Image:SMSCON_Editor_General.png|600px]]

[[Image:SMSCON_Editor_General1.png|300px]]
[[Image:SMSCON_Editor_General2.png|300px]]

==== Select Reply Options ====

Choice can be made on the communication option the replies are send.

[[Image:SMSCON_Editor_disableReply.png|300px]]
[[Image:SMSCON_Editor_selectReply.png|300px]]

====Disable All Replies ====

Choice can be made to disable all replies (this will not apply for the SMS message send when an not authorised SIM card is inserted).
If no replies to be send is requested, the relevant options will be hidden, i.e. will become non selectable.

[[Image:SMSCON_Editor_disableReply2.png|300px]]
[[Image:SMSCON_Editor_selectReply2.png|300px]]

====Send GPS Coordinates Replies ====

Choice can be made where the replies with the GPS coordinates should be send.
It can be either one of:
*SMS
*Email
*Both

[[Image:SMSCON_Editor_General_selection.png|400px]]

===Email configuration tab===

In order to receive email notifications the appropriate tab must be filled.
Currently only few types are supported.

An example of gmail account settings are shown below:

[[Image:SMSCON_Editor_Email.png|600px]]

===Reverse SSH configuration tab===

'''NOTE:''' Leaving empty the username and password fields will disable the reverse SSH functionality.

[[Image:SMSCON_Editor_SSH.png|600px]]

===Commands renaming first tab===

The Commands can be renamed (it is recommended for maximum safety) to ones preferences.

[[Image:SMSCON_Editor_Commands1.png|300px]]
[[Image:SMSCON_Editor_Commands2.png|300px]]

====Prefixing Commands====

The "Prefix" functionality can be useful in the cases where it is desired all the default names to be prefixed with a common string.

''Note:'' The new names (as all other changes) are stored only after the button "Update Settings" is pressed.

[[Image:SMSCON_Editor_Commands_prefix.png|300px]]

===Program Initialisation tab===

[[Image:SMSCON_Editor_Init.png|600px]]
[[Image:SMSCON_Editor_Init2.png|300px]]

===Invoke program test commands tab===

'''Note:'''
* After each test is executed the daemon is stopped and previous configuration is restored.
* Before exiting the application press the "'''''Tests Done'''''" button to start the daemon again.

[[Image:SMSCON_Editor_Test.png|300px]]
[[Image:SMSCON_Editor_Test2.png|300px]]

===Drop down menu===

[[Image:SMSCON_Editor_Main.png|600px]]

===About===

The about window provides also buttons to connect in the wiki pages for both parts of the application and read the latest documentation.

[[Image:SMSCON_About.png|400px]]

===Change Password===

Menu for changing the password for opening the Editor application.

[[Image:SMSCON_ChangePassword.png|400px]]

===Popups===
There are several popups triggered on actions and updates that inform the user on the current state of the operation.

[[Image:SMSCON_UpdatedSettings.png|400px]]

FIXME: add more popups and explanations.

==Changelog==

=== 0.8-8 '''[http://maemo.org/packages/package_instance/view/fremantle_extras-devel_free_armel/smscon-editor/0.8-8/ Development]'''===
Availability: [[Extras-devel]]

* Correction of error with RESENDTIME creation.
* Replaced "-init" command with "-force init".
* Added check in postinstal script for the config version.

=== 0.8-7 ===

* Modification of the UI to support rotation.
* Enabled rotation on all panels (some parts look ugly but it is functional).

=== 0.8-6 ===

* Added new logic and options for support of SMSCON 0.8.x versions.
* Added dependency on smscon (>= 0.8.0-1) and suggestion for smssend (>= 0.1.8)
* Added auto-disable of options related to SMS replies if SMSSEND is not selected.
* Added auto-disable of options related to SMS retries if SMSRESEND is not selected.
* Added background send of SMS message on password change (optional; requires smssend package).
* Several UI modifications for usability.
* Modification of the General tab to be a scrollable list.
* Modification of the UI to expand on all the available screen estate.
* Added code in the postinstall to compile the python code.

=== 0.7-4 '''[http://maemo.org/downloads/product/Maemo5/smscon-editor/ Stable]'''===
Availability: [[Extras]]

* Addition of more test options.
* Modification of the Tests tab to be a scrollable list.
* Added a button to restart the daemon when tests complete.
* Password to open the editor will persist updates.
* Removed autocapitalisation of first character in several entry fields.
* Aligned Left all entry fields in the Email and SSH tabs.

'''Known issues'''

* options for disabling SMS replies are not displaying correctly.

=== 0.7-3 ===

* Addition of five new commands and one new option in the UI and code (support for SMSCON ver. > 0.7)
* Addition of scrollable list for the commands editing. All the commands now can be edited from one tab.
* Improvement in the UI to hide SMS reply options when replies are disabled.
* Improvement in the change password window.
* Simplification and cleanup in many parts of the code.
* New About page with auto rotation.
* Correction for stackable windows.

=== 0.6-1 ===

* Correction in copying config file for safe editing.
* Added creation of temp config file on first use.

=== 0.6-0 ===

* Added password protection for opening the GUI (default password = 12345).
* Added two new dialog windows (to enter and change the password respectively).
* Added new initialisation command to delete the application stored IMSI number.
* Added new initialisation command to delete the configuration stored.
* New sudoers file to include two scripts for handling operations that need root privileges.
* Removed indirect dependency to rootsh package (i.e. use of root).
* Changed password fields in email and ssh settings to be hidden.
* Changed privileges for supporting files to be more restrictive.

=== 0.5-5 ===

* Added new code to read and encrypt the sensitive config file parameters (Contribution by Frank Visser).
* Restructure and heavy cleanup of the code.
* Some small main GUI corrections and beautifications.
* Package smscon has been added in the dependencies.
* Changed the sequence for updating the config file to give better information to the user.
* Updated several messages to be more descriptive.

=== 0.4.4-14 ===

* Added prefix of a common string to all commands.

=== 0.4.4-12 ===

* Added support for new option to send GPS coordinates to both email and sms.
* Increased the size of the username fields - useful with gmail and such.
* Removed smscon from the dependencies (to allow promotion in extras)

=== 0.4.4-11 ===

* Added tests for receiving GPS coordinates commands
* Added tests for phonecall and sms commands
* Added information and warning boxes
* Many visibility enhancement changes
* Updated icon to be transparent.
* Added icon for the application manager.
* Made MailFrom = MailAddress as a temp solution until dedicated space is made for this field in the GUI.
* Added the About and Credits dialogs.
* Added smscon in the dependencies.

=== 0.4.4-9 ===

* Changes in the postinst script to correct it's execution and privileges
* Added checks on the configuration file existence and to provide messages to the user when missing or corrupted.

=== 0.4.4-5 ===

'''Warning''': This version (and above) will work only with [[SMSCON]] version equal or higher than 0.4.4

* Addition of a new tickbox to provide "Reply On Keybord Open" settings option.
* Update of code reading the config file to include spaces in commands (provided by digitalvoid).
* Corrected canvas of the main window to fit better the N900 screen size.
* Increased the width of commands line enter.
* Corrected the .desktop file to point in the correct iconset
* Added explicit permissions in the postinst script for the gui elements file.

=== 0.4.3-9 ===

* added block on starting the UI as root (it should only be started as user)
* the editor will quit after calling the init or reset commands (after informing user).
* added slightly modified icons.
* added settings and permissions in sudoers file.
* cleanup of postinst instructions
* cleanup of commented out code.

=== 0.4.3-8 ===

* The Editor will trigger a reload of the new configuration after every update of the config file.
* Temporarily the MailFrom field in the email settings will be filled by the MailAddress (in the future will get its own element in the GUI).
* Renamed buttons in the UI from <code>Create Settings</code> to <code>Update Settings</code>.

'''''NOTE''''': For older versions please see the changelogs in the [https://garage.maemo.org/frs/?group_id=1848&release_id=4066 project's garage page]

==Future Development==
* add mailfrom field.
* do not overwrite the password if it is already defined.
* add more test commands.
* add option to hide the desktop entry.
* protect the installation.

==License==
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation; version 2 only.

==Disclaimer==
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

[[Category:Software]]
[[Category:N900]]

Ovi Maps Extra Features

2011-12-15T03:06:27Z

114.79.28.10: /* Voice Navigation and Espeak - OmVoiceServer */

This page is a work in progress. Please add missing information.

== What is Ovi Maps Extra Features ==

Ovi Maps Extra Features is a project that's been worked on to bring enhancements and extra features to Ovi Maps on the [[Nokia N900|N900]]. It began as adding simple functionality, but has progressed to adding voice commands and spoken street names.

Currently the features present in the latest release include:

* Addition of two extra buttons when routing
** First button is to show all maneouvers in the current route and allows them to be turned on and off.
** Second button shows Points of interest on the map, again allowing them to be turned on and off. Further customizations of Points of Interest is discussed below.
* Brought back 3D view of maps which was removed through an update
* Added extra menu to customize POIs
* Added voice capability with spoken languages (requires server, details below)
* Voice capability also allows for spoken street names through espeak
* Added feature to allow saved results to be displayed offline (still experiemental)

== How to use the latest version ==

# Download omVoiceServer from Extras-Devel. Be mindful that this is a work in progress and may contain many bugs. Software from this repository may also cause data loss and problems with your N900. Be sure to backup incase you need to reflash.
# The omvoiceServer icon will be available through the program menu
# Using your prefered method, access your "<code>/usr/share/nokia-maps/html</code>" folder. This contains the necessary files to change.
# Download the newest html file from [http://talk.maemo.org/showthread.php?t=66985 this talk.maemo.org post]. Link will be available in the top.
# In that folder is the original "<code>index.html</code>" file. Rename it to something else for backup purposes. Incase of any errors or problems with ovi maps, restore this file.
# Copy the new modified "<code>index.html</code>" file into the folder
# Copy any extra icons required from [http://talk.maemo.org/attachment.php?attachmentid=19263&stc=1&d=1302432522 here]
# the location of the extra icons is given inside the zip folder (<code>html\pfw\images\spices\{folders}</code>)
# omVoiceServer will look for voice files under cities folder (where all the map data is saved). This location can be changed from the options in omVoiceServer
# POI saved results are found again under the cities folder, but under a sub folder named "poi". This folder may need to be made.

One method for accessing all these required folders is using winSCP. http://talk.maemo.org/showthread.php?t=41422

== Features explained ==

=== Maneuvers ===

With PR1.2, maneuver support was added so that when selecting a junction, its appropriate icon will be displayed. This functionality has been extended to allow all maneuvour icons to be displayed through a simple button, hence allowing the user to know what turns are approaching. The button is only displayed while traveling to a destination (needs a valid route to display manevours for), and hence will only be visible at times of routing. This button requires a new icon which can be added manually or automatically through the latest version of omVoiceServer.

{information on how to edit manuevour button can be added here}

=== Points Of Interest While Driving ===

Ovi Maps supports points of interest display on the map however the default is only transport icons, hence an extra button was added to enable POIs to be displayed and removed, as well as a new menu which allows for customizations of catagories. These catagories can be modified further if the user requires catagories other than the default ones. Similarly to the Manevours button, the button for POI is only availble while routeing. A new icon is again available.

==== Turning on and off certain POI icons ====

A new menu has been added with a few main catagories for POI. This can be found under "Maps" > "More" > "POI Settings". It currently has
* Transport
* Shops
* Education
* Parking
* Activites
* All

WARNING: Choosing the all category will load all points of interest on the map. In cities and areas with many shops/schools/etc it will take a long time to turn them on and off.

==== Customizing the Points of Interest ====

The required function that contains the points of interest is under
<source lang="javascript">
showAllCategories: function (showthem) {
</source>
with the following items under each category
<source lang="javascript">
poiRegExp[0] = /AIRPORT|AIRLINE|METRO|UNDERGROUND|RAILWAY|FERRY|SBAHN|RER_/; //Transport
poiRegExp[1] = /BAR|SHOP/; //shops
poiRegExp[2] = /EDUCATION|EXHIBITION|LIBRARY|MUSEUM|UNIVERSITY/; //Education
poiRegExp[3] = /PARKING/; //Parking
poiRegExp[4] = /BEACH|CAMPING|CASINO|CINEMA|GOLF|HOLIDAY|OPERA|STADIUM|THEATRE|TOURIST|ZOO|SPORT/; //Activities
</source>
Full list of possible POIs are
<source lang="javascript">AIRLINE_ACCESS
AIRPORT
ALL
AMUSEMENT_PARK
AUT_METRO_ACCESS
AUT_METRO_STOP
BARS_CAFES
BAR_DISCO
BEACH
BEL_METRO_ACCESS
BEL_METRO_STOP
CAMPING
CAR_DEALER
CAR_REPAIR
CASH_DISPENSER
CASINO
CINEMA
COMPANY
CONCERT_HALL
CONGRESS
COURTHOUSE
CULTURAL_CENTRE
CZE_METRO_ACCESS
CZE_METRO_STOP
DEN_METRO_ACCESS
DEN_METRO_STOP
DEU_METRO_ACCESS
DEU_METRO_STOP
DEU_SBAHN_ACCESS
DEU_SBAHN_STOP
EDUCATION
EMBASSY
ESP_BARCELONA_METRO_ACCESS
ESP_BARCELONA_METRO_STOP
ESP_CERCANIAS_METRO_ACCESS
ESP_CERCANIAS_METRO_STOP
ESP_MADRID_METRO_ACCESS
ESP_MADRID_METRO_STOP
EXHIBITION_CENTRE
FERRY_TERMINAL
FIN_METRO_ACCESS
FIN_METRO_STOP
FRA_METRO_ACCESS
FRA_METRO_STOP
FRA_RER_ACCESS
FRA_RER_STOP
FRONTIER_CROSSING
GBR_GLASGOW_METRO_ACCESS
GBR_GLASGOW_METRO_STOP
GBR_LONDON_METRO_ACCESS
GBR_LONDON_METRO_STOP
GOLF_COURSE
GOVERNMENT_OFFICE
HOLIDAY_PARK
HOSPITAL
HOTEL
ITA_METRO_ACCESS
ITA_METRO_STOP
LIBRARY
METRO_ACCESS
MOUNTAIN_PASS
MOUNTAIN_PEAK
MUSEUM
NOR_METRO_ACCESS
NOR_METRO_STOP
OPERA
PARKING
PARKING_AREA
PARKING_GARAGE
PARK_RECREATION
PETROL_STATION
PHARMACY
PLACE_OF_WORSHIP
POLICE
POST_OFFICE
PRT_METRO_ACCESS
PRT_METRO_STOP
RAILWAY_STATION
RAILWAY_STATION_ACCESS
RENT_A_CAR_FACILITY
RESTAURANT
REST_AREA
SHOP
SHOPPING_CENTRE
SPORT_OUTDOOR
STADIUM
SWE_METRO_ACCESS
SWE_METRO_STOP
THEATRE
TOURIST_ATTRACTION
TOURIST_INFORMATION_CENTRE
UNDERGROUND_STATION
UNIVERSITY
ZOO</source>

In addition to changing the categories, you may also change the text displayed to the user. This can be found under the function
<source lang="javascript">_createPoiScreen: function (aEvent) {//HERE HERE
...
this._aboutBtn = new nokia.aduno.medosui.Button("ButtonWithIcon", "About");
this._transportBtn = new nokia.aduno.medosui.Button("ButtonWithCheck", "Transport");
this._shopsBtn = new nokia.aduno.medosui.Button("ButtonWithCheck", "Shops");
this._educationBtn = new nokia.aduno.medosui.Button("ButtonWithCheck", "Education");
this._parkingBtn = new nokia.aduno.medosui.Button("ButtonWithCheck", "Parking");
this._activitesBtn = new nokia.aduno.medosui.Button("ButtonWithCheck", "Activities");
this._allBtn = new nokia.aduno.medosui.Button("ButtonWithCheck", "All");</source>

=== 3D View ===

3D view has been re-added to Ovi Maps including the rotation wheel and 3D buildings. This feature was removed in a previous update from Nokia. With this feature, you can also stop the map from rotating at all and lock its direction to always north (or any other direction you choose).

{Add part about changing the code to prevent rotation}

=== Voice Navigation and Espeak - OmVoiceServer ===

One of the main additions to Ovi Maps has been voice navigation and later on spoken street names. This was first done using a python server which would listen for requests from the Maps application and then play the corresponding sound. One drawback from this was the javascript inside the maps application had to convert turns and other route information into file names. This causes a slight problem when changing languages as not all languages contain the same file names for commands and turns. The most current version is omVoiceServer which parses the information from the maps application and looks up the sound files. This allows the maps application to only send the turn information, and the server to do the rest of the work. It also contains a GUI for changing of various options and settings, allowing languages to be changed during routeing and turning on and off spoken street names using eSpeak.

As the server has been changed to get the voice files itself, the code for maps application has also been changed, hence omVoiceServer requires a new index.html page to function. These can be found [http://talk.maemo.org/showthread.php?t=66985 here] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm].

=== Saved POI results - OmVoiceServer ===

The latest version of omVoiceServer also allows for semi-offline routing to common destinations. When connected to the internet, a search may be made and the contents of the result can be saved for later use when there is no internet (or when you wish to save on data downloads). To enable POI offline searching you will need to add an empty ad-hoc network (as ovi maps still requires network connection to search, however due to a bug in maemo, you can connect to non-existant ad-hoc connections and trick ovi maps into thinking your connected).

To setup a no internet network, simply go to

{Settings} > {Internet Connections} > {Connections} > {New} > {Next} > Type a connection name, ie "no internet" > {Next} > Select {No} when asked to search for WLAN Networks > Enter anything in the network name ie "no internet" > untick {Network is hidden} > Change Network Mode from infrastructure to {Ad hoc} > {Next} > {Finish}.

Then:
# With omvoiceserver running, and open the maps application and search for something. For example search for your home address (this step needs internet access).
# press Ctrl + backspace to get to the taskmanager and open omvoicesever. In the last tab under "Last Search" it'll have the details of your last search (in this example, your home address).
# Press the "Save this search" button and save the file under your cities folder in a new folder called "poi" (ie <code>/home/user/MyDocs/cities/poi</code>). Save it with the filename "poi-home" (or any other name but make sure it begins with "poi-".
# omvoiceserver will save the file there as an xml file (see it through the file manager)
# Connect to your ad-hoc network
# In maps (ctrl+backspace to shift screens) do a search for "poi-home"
# Watch as your result comes up even though theres no internet

[[Category:Power users]]
[[Category:Fremantle]]

Developer FAQ

2011-12-15T03:06:06Z

114.79.28.10: /* How can I package software for Maemo? */

This is a list of frequently asked questions related to developing applications for the Maemo platform or working on the platform itself. This is in constant evolution, and new questions and answers are welcome.

For user topics, please see the [[User FAQ]].

== What can I do if my question is not mentioned here? ==

# Look if it is discussed already in one of the mailing lists or in [http://talk.maemo.org talk.maemo.org]
# If not post your question in the developer mailing list or in talk
# If you find the answer and you think it could be interesting for others as well post it here, so that we just have to point on this page in the future if the question pops up again.

== Maemo SDK and Scratchbox ==

=== "dbus-monitor" does not work in Scratchbox. What can I do? ===

'''Error messages'''

Typical error messages in this case are:

X86: ~] > dbus-monitor --system
Failed to open connection to system message bus: Failed to connect to socket /var/run/dbus/system_bus_socket: No such file or directory

or for the session bus:

X86: ~] > dbus-monitor
Failed to open connection to session message bus: (null)

or when starting a python app:
arguments to dbus_connection_get_data() were incorrect, assertion "connection != NULL" failed in file dbus-connection.c
GLIB ERROR ** default - Not enough memory to set up DBusConnection for use with GLib

'''Solution'''
*Tested in Fremantle Beta, Beta_2
Enter the following lines in the Scratchbox:

eval $(dbus-launch --sh-syntax)
export DBUS_SESSION_BUS_ADDRESS
export DBUS_SESSION_BUS_PID

Then run the dbus-monitor command and it should work fine!

=== "xephyr" fails to start in the host with a dbus security error ===

'''Error messages'''
[config/dbus] couldn't take over org.x.config: org.freedesktop.DBus.Error.AccessDenied (Connection ":1.310" is not allowed to own the service "org.x.config.display2" due to security policies in the configuration file)

'''Solution'''
The display you plan on using for Xephyr (typically :2) just needs to be added to the dbus security file.

You need to edit the following file:
/etc/dbus-1/system.d/xorg-server.conf

Add the following three lines in the "<code><policy context="default"></code> group
<source lang="xml">
<allow own="org.x.config.display2"/>
<allow send_destination="org.x.config.display2"/>
<allow send_interface="org.x.config.display2"/>
</source>

Basically you should have one for each display you plan on using, by default display 0 and display 1 are in the file. If you are planning on using a different display number for Xephyr than :2 make sure you use its number rather than "display2" when you add these lines.

=== How can I avoid "qemu" error messages of "af-sb-init start" in ARMEL target? ===

'''Error messages'''

Usually the attempt ends up with something like this:

The error was 'BadWindow (invalid Window parameter)'.
(Details: serial 207 error_code 3 request_code 2 minor_code 0)
(Note to programmers: normally, X errors are reported asynchronously;
that is, you will receive the error a while after causing it.
To debug your program, run it with the --sync command line
option to change this behavior. You can then get a meaningful
backtrace from your debugger if you break on the gdk_x_error() function.)
aborting...
qemu: uncaught target signal 6 (Aborted) - core dumped

'''Solution'''
* all SDK's

The ARMEL target should not be used for application testing and just for cross compiling. The target is not meant to support this. Please use for any other use than cross-compiling the X86 target.

=== Why do I get "command not found" even though I follow the instructions in the documentation? ===

'''Error messages'''

As an example:

X86: ~] > af-sb-init.sh start
bash: af-sb-init.sh: command not found

'''Solution'''
After running the installation script you have to install some closed-source packages to have a full installation of the SDK. Most likely these are not installed. Have a look [http://maemo.org/development/sdks/maemo_5_beta_2_sdk_installation/#32bitinstall here] - the last point under installation instructions - how to do that.

=== How to resolve "Scratchbox devkit debian-etch not found" issue? ===

Sometimes while running the install-script of the SDK this error occurs and produces a message like the following:

'''Error messages'''

E: Scratchbox devkit debian-etch not found.
E: Please complete scratchbox installation first.
E: Specify an alternative installation path using '-s PATH' option.

'''Solution'''
The problem can be resolved like this (with thanks to Frank Banul in the developer list):

<ol>
<li>
add <pre>deb http://scratchbox.org/debian/ maemo5-sdk main</pre> to <code>/etc/apt/sources.list</code>
</li>
<li>
run:
<pre>
sudo apt-get remove scratchbox-devkit-debian
sudo apt-get install scratchbox-devkit-debian
sudo apt-get remove scratchbox-devkit-perl
sudo apt-get install scratchbox-devkit-perl
</pre>
</li>
</ol>

=== Why can I reach an IP-address but no domain inside Scratchbox? ===

In some cases this happens because of the following reasons:
# Network configuration changed on the host-system, after Scratchbox was installed
# Scratchbox not configured correctly:
#* Manual installation of SDK was not complete
#* The target was reset

'''Error messages'''
Depends on the program, which is used. But here a small test client in python:
<source lang="python">
import urllib2
print urllib2.urlopen("http://google.com").read()
</source>

Then the following error message will be returned:

urllib2.URLError: <urlopen error (-3, 'Temporary failure in name resolution')>

'''Solution'''
* Fremantle X86(!), Diablo X86(!)
In any cases it is most likely that the resolv.conf of the Scratchbox is not set up correctly. The following solutions for this issue can solve the problem:

# Network configuration change: Copy the resolv.conf from the host system into the scratchbox/etc folder:

sudo cp /etc/resolv.conf /scratchbox/etc/resolv.conf

If the problem is still the same try 2.:

# Scratchbox configuration: This might be the case, if the target was reset or manual installed, without using the script. In this case run:

SBOX> sb-conf in -edFL

This sets the <code>/scratchbox/etc/resolv.conf</code> as default and ignores the one of the scratchbox. Info about the command you'll find [http://maemo.org/development/sdks/maemo_5_beta_2_sdk_installation/#manualinstall here].

These steps should solve the problem. If it still does not work, you could try to replace the entries of the resolv.conf '''within''' the scratchbox with the same entries of the resolv.conf of the '''host''' system by hand.

=== Script "af-sb-init.sh start" aborting ===

Sometimes it happens, that the script aborts just after starting. A problem might be, that old processes are still active, and cause the error. Indicator that this might be the reason are the following lines after the startup:

'''Indicator'''

_X86: ~] > af-sb-init.sh start
...
DBUS system bus is already running, doing nothing
D-BUS session bus daemon is already running, doing nothing
Starting Maemo Launcher: maemo-launcher start failed.
Sapwood image server is already running, doing nothing
...
aborting...

This shows, that old processes are still running, which might cause problems in starting up the framework again.

''' Solution '''

To solve this stop the framework, kill all old processes and start it again. This can be done by:

# stop the framework:<pre>af-sb-init.sh stop</pre>
# kill old processes:<pre>sb-conf killall</pre>
# restart:<pre>af-sb-init.sh start</pre>

=== How to install the SDK+ on a Linux AMD64 platform? ===

The Maemo SDK+ package includes scratchbox 2 and Qt, but it will only install on 32-bit platforms. If you're running Debian with a 64-bit kernel, Maemo SDK+ can be installed into a chrooted 32-bit environment that sits on top of your 64-bit platform.

'''Solution'''

[[Maemo_SDK%2B_installation_on_Debian_(AMD64)|This guide]] takes you through all the steps to the point of compilation and running the test.

=== QEMU error running cmake in ARMEL target in Fremantle? ===

'''Indicator'''
qemu: uncaught target signal 11 (Segmentation fault) - core dumped
make: *** [cmake_check_build_system] Error 126

''' Solution '''
Check the version of cmake. Using version 2.6.3-2maemo4+0m5 should solve the problem.

=== Git error when trying to clone/pull from https repositories ===

'''Indicator'''
error: error setting certificate verify locations:
CAfile: /usr/share/curl/curl-ca-bundle.crt
CApath: none

warning: remote HEAD refers to nonexistent ref, unable to checkout.

'''Solution'''

Place the CA bundle where curl can find it:
~] > mkdir /usr/share/curl
~] > ln -s /scratchbox/devkits/git/share/curl/curl-ca-bundle.crt /usr/share/curl/

See also [https://bugs.maemo.org/show_bug.cgi?id=4953 bug 4953].

== Porting to Fremantle ==

{{main|Documentation/Maemo 5 Developer Guide/Porting Software}}

This section is intended to consolidate the common errors that occur while trying to port [[Open development/Maemo roadmap/Diablo|Diablo]] applications to [[Open development/Maemo roadmap/Fremantle|Fremantle]]. Feel free to improve this page and/or add additional information.

===maemo-select-menu-location: command not found===

'''Typical error message'''
scratchbox/tools/bin/sh: line 1: /usr/sbin/dpkg-preconfigure: No such file or directory
Setting up leafpad (0.8.16le-0maemo2) ...
gtk-update-icon-cache: Cache file created successfully.
/var/lib/dpkg/info/leafpad.postinst: line 7: maemo-select-menu-location: command not found
dpkg: error processing leafpad (--configure): subprocess post-installation script returned error exit status 127

'''Reason'''
:maemo-select-menu-location is obsolete. In Fremantle, there is no submenu like, "Utility", "Extra", "Settings" etc. All installed 3rd party software will be visible under "Applications" by default.

'''Action'''
:Remove the instance from the post installation script. It is not needed.

===Missing dependency: maemo-installer-utils===

'''Reason'''
:The package <code>hildon-application-manager</code> no longer provides <code>maemo-installer-utils</code>. The commands <code>maemo-confirm-text</code>, <code>maemo-application-running</code>, <code>maemo-list-user-packages</code> are still available.

'''Action'''
:Replace the dependency with <code>hildon-application-manager</code>.

===Missing dependency: libhildonhelp0===

'''Reason'''
:libhildonhelp does not exist in Fremantle.

'''Action'''
:Remove the dependency and calls to the help APIs.

===Limitation of Home Area applets===

Unlike Diablo, in Fremantle these applets do not support text input, pannable areas, resizing nor scrolling.

'''Reason'''
:Framework limitations.

'''Action'''
:Replace text input fields with dialogs. Use buttons for scrolling. Add resizing options in the settings dialog or adapt the UI of the applet regarding to that. For further information on how to develop those applets, please check the [[Documentation/Maemo_5_Developer_Guide/Application_Development/Writing_Desktop_Widgets|documentation]].

===What icon size should be used?===

With Fremantle the size specifications of the icons are different from Diablo:

'''Application Manager'''
* Icon size: <code>HILDON_ICON_SIZE_FINGER</code>
* In Gimp or Photoshop: 48x48 pixels

'''Task Launcher'''
* Icon size: <code>HILDON_ICON_SIZE_THUMB</code>
* In Gimp or Photoshop: 64x64 pixels

Using icons for the task launcher, please remember to run the following in your postinst file:

gtk-update-icon-cache -f /usr/share/icons/hicolor

===Text and icons in dialogs===

'''Problem'''
:The text in dialog boxes is not formatted correctly (truncated on the right size), when a icon is in place.

'''Action'''
:In general icons should not be used in dialogs in Fremantle. Remove the icon and the text will be formatted correctly.

===Initialisation scripts===

'''Problem'''
:Initialisation scripts don't work any more.

'''Reason'''
:Fremantle has switched to using '''upstart''' for system initialisation.

'''Action'''
:Create '''upstart''' job definitions instead of init scripts. Information on writing these can be found on http://upstart.ubuntu.com/getting-started.html. However, be aware that the directory used on Maemo 5 is <code>/etc/event.d</code>.
:The job script should be placed in <code>/etc/event.d/''package''</code>. And the package postinst, prerm and postrm should use the ''start --quiet'' and ''stop --quiet'' commands to start and stop the service. Unfortunately there is no debhelper tool to assist with this.

=== Enabling sudo for user installed scripts ===

'''Problem'''
:Users tend to want to edit /etc/sudoers to allow a command provided by a script they created to run with raise privileges. This is highly likely to result in a bricked device forcing you to re-flash to make it work again from scratch.

'''Reason'''
:The <code>/etc/sudoers</code> file seems deceivingly straight forward to edit. It's not:
<code>
17:27 < MohammadAG51> listen to that advice 
17:27 < MohammadAG51> don't be a smartass like I did once
</code>

'''Action'''
:Add your specific sudo configuration to "<code>/etc/sudoers.d/*</code>" as a new file (courtuesy to the reader, you are advice to read [http://www.sudo.ws/sudo/sudoers.man.html this] to understand how to create sudoers.d/ snippets appropriate for your application or script.
:Run update-sudores and profit.

== Qt ==

=== Where to find a Maemo Qt API Reference? ===
There is a [[Qt4 Hildon|Qt page on the wiki]] with some useful information, and [http://qt.nokia.com/doc/qt-maemo-4.6/index.html official Qt for Maemo documentation].

=== How to create "[[Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/Windows#Window_Views|HildonStackableWindows]]"?===

This is done by setting a special attribute on the window, as shown in the [http://doc.qt.nokia.com/qt-maemo-4.6/maemo5-stackedwindows.html Qt Maemo 5 stacked window example].

== Autobuilder ==

=== Localization isn't working ===

You are probably using the following line in <code>configure.ac</code>:

localedir=`$PKG_CONFIG osso-af-settings --variable=localedir`

This means that you need to add <code>osso-af-settings</code> to your Build-Depends.

=== Package gets rejected: REJECTED: The same or newer version is already in extras-devel ===

You can't upload the same version to the repository twice. If you have changed anything in your package, you should increase your version number or package revision.

=== Build failed: No such file or directory in log file ===

You probably forgot to specify the correct Build-Depends in <code>debian/control</code>. The autobuilder starts every build with a clean SDK image. If you need any application during building which is not available in the default SDK image, you need to specify it specifically.

You may verify that your Build-Depends field in debian/control is complete by running

dpkg-depcheck -m dpkg-buildpackage -rfakeroot -b

in the source tree. (You'll need to "<code>fakeroot apt-get install devscripts</code>" for this to work).

=== Build failed, works in my own scratchbox ===

See the answer above.

== Extras ==

=== How can I package software for Maemo? ===

{{main|Documentation/Maemo 5 Developer Guide/Packaging, Deploying and Distributing}}

As Maemo is based on the Debian operating system, creating packages for Maemo borrows a lot of [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] tools and techniques from Debian, however there are [[Packaging#Maemo-specific packaging information|some Maemo-specific differences]].

A [[Packaging|simple guide to get started]] is available.

=== How do I request upload rights for Extras ===

You can [https://garage.maemo.org/extras-assistant/index.php?target=invitation_request request an invitation] via the Extras Assistant.

=== How do I enable extras, extras-testing, and extras-devel in Scratchbox ===

Add the following lines to <code>/etc/apt/sources.list</code> from within scratchbox:
deb http://repository.maemo.org/extras/ fremantle free non-free
deb-src http://repository.maemo.org/extras/ fremantle free

deb http://repository.maemo.org/extras-testing/ fremantle free non-free
deb-src http://repository.maemo.org/extras-testing/ fremantle free

deb http://repository.maemo.org/extras-devel/ fremantle free non-free
deb-src http://repository.maemo.org/extras-devel/ fremantle free

Then run the following commands from within scratchbox:
cd /tmp
wget http://repository.maemo.org/extras-devel/dists/fremantle/fremantle-extras-pubkey.asc
apt-key add fremantle-extras-pubkey.asc
apt-get update
apt-get update

Yes, running apt-get update twice is sometimes needed.

If you get errors where apt cannot find the keyring, then the above commands should fix that.

[[Category:Development]]
[[Category:Scratchbox]]
[[Category:Fremantle]]

QSportsEvent

2011-12-15T03:05:41Z

114.79.28.10: /* Introduction */

==Introduction==

This is a page that will hold information about the '''QSportsEvent''' app. The initial versions are targeting updated scores and tables for football (soccer). Future versions will include other sports and additional features. The objective of '''QSportsEvent''' is:

''To maximize the experience of following sports events by leveraging the capabilities of the mobile device.''

The data is retrieved from the [http://www.aragon.ws/soccerdb SoccerDB] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] site. You are encouraged to make donations to that project. The community is encouraged to suggest additional data sources.

The thread to follow on talk.maemo.org is [http://talk.maemo.org/showthread.php?t=49508 QSportsEvent - FIFA World Cup and Football App].

Please note that by the time the app will hit Extras it will have been renamed to '''MobiTifo'''.

==Installation==

It should now be possible to install MobiTifo/QSportsEvent from [[extras-devel]]! I leave the below, manual installation instructions for the time being until it is confirmed that there are no issues. So far I only have reports from people who already had the app installed. I'd need to know from someone who is doing a 'fresh' install as well.

===Fremantle (Nokia N900)===

This description is now OBSOLETE.

# Manually uninstall any previous versions first (I've never tested installing on top on an existing one)
# Your database will be replaced, so you will loose all your favourites and all URLs you have entered (I will try to figure out a solution for this...)
# The app does use your Internet connection and there is no 'optimization'. The pages and data downloaded are not huge, so there should not be a big problem, but at least you've been warned...
# There is a dependency on <code>libqt4-webkit</code> and <code>libqt4-xmlpatterns</code>. If you need it, you have to [[root access|be root]] and once you are, you can do:<pre>apt-get install libqt4-webkit libqt4-xmlpatterns</pre>
# Install the .deb file manually from [http://www.mobitifo.com/qsportsevent_0.0.8_armel.deb this link] and launch it from the file manager. Please note that I am now hosting it on its own site as the size of the .deb file is larger than what I'm allowed to upload as an attachment to a post on talk.maemo.org.

Please note that, just like with the previous dependency, it seems that the app dies the first time you try to launch it. After that, it should be OK.

If you don't know how to do that you should probably wait for it to appear in the repositories.

===Diablo (Nokia 8xx)===

For Diablo it IS possible to download from Extras-Devel! Some users have reported issues with the 'SQL plugin'. You might have to install the following packages as well to get it to work:
<pre>
apt-get install libqt4-sql-sqlite2 libqt4-sql
</pre>

==User Guide==

#Select
#Favourites
#Matches
#Table
#News
#Update Score

Future versions of the User Guide might be written as Google Docs.

==UI Customization==
One of the new features is that the UI will be somewhat 'user configurable'. In Qt, stylesheets can be applied to application widgets. These stylesheets can be read from a file and be changed in runtime. There will be a .qsportsevent/user folder where you can put your own matches.css, table.css, select.css, news.css and favourites.css files with the stylesheets to be used in those respective tabs of the application. Instructions as to exactly what and how you can use it can be found in the Qt [http://doc.qt.nokia.com/4.6/stylesheet-syntax.html documentation], [http://thesmithfam.org/blog/2009/09/10/qt-stylesheets-tutorial/ tutorial] and some [http://doc.trolltech.com/4.4/stylesheet-examples.html#customizing-qtableview examples]. As an example, it should be possible for you to change the background image (your favourite team's stadium? a team picture? your girlfriend??) and the appearance of the 'matches' and 'table' tables.

A good source of images would probably be [http://www.futbolwallpapers.com FutbolWallPapers].

Example:
<pre>
background-image: url(/home/user/MyDocs/DCIM/20100501_001.jpg);
</pre>

In the sample file, the full path is preceeded by a ':' character. You should NOT use it! It is only needed when the item is taken from a Qt resource file. For user customization you will take it directly from the file system, so you shouldn't use that prefix!

The other 'user configurable' feature is the rendering of the RSS feeds. You'll find this file in .qsportsevent/user/rss.xsl.

Find samples in the attachment. Please note that the default implementation has the same stylesheet for all tabs, so I only attach one example. To be able to upload files to TMO, they have to have an 'acceptable' extension, that's why I had to add .txt. You don't need that on the device.

Please note that upgrades to newer versions of QSportsEvent might delete your files that you store in these folders, so please make sure to keep backups of them in other locations!

Be creative! Share screenshots, xsl, css and image files on the forum! I'm more than willing to change the default ones that come with the application with better looking examples provided by the community!

Please note that this is very experimental! I have barely tested it myself! I include it mainly because I don't want to spend too much time on the appearance of the UI and prefer to concentrate on functionality. Besides, implementing the feature only took 15-20 minutes anyway... Ok, it took longer to write these instructions :)

I can't guarantee that this feature will remain in the app, but I don't see any reason why not...

==Release Plans==

Version '''0.0.5''' (Previous) was downloaded 99 times.

Version '''0.0.6''' (Previous) was downloaded 51 times. It was released on Tuesday 27th April. The main changes were:

#It is now possible to download full league information from SoccerDB, both current and historical data. Two new 'tabs' are available for that purpose: 'Downloaded Matches' and 'Downloaded Table'.
#It is possible to select the round of matches to look at.
#In the 'favourites' tab it is now possible to select a default league. That will be the one that will be opened when QSportsEvent is launched.
#Background images should now be correct in all tabs. They were not in 0.0.5.
#This version will NOT be uploaded to Extras-Devel (except for Diablo) due to the well known issue with Qt based applications and the non-release of PR1.2.

Version '''0.0.7 - Stadio Olimpico di Roma''' (Previous) was downloaded 81 times. It was released on Thursday 6th May. The main changes were:

#Much faster download of full league results. Now it should take 3-5 seconds.
#In the 'Downloaded Matches' tab is possible to select by Team as well as by round.
#When a RSS URL is selected, an XSL will be applied to it to render it in a readable fashion.
#Partially user configurable UI using Qt widget stylesheets and XSL for the news page.
#Did I mention live scores?

Version '''0.0.8 - Santiago Bernabeu''' (Current) was released on Saturday 22nd May. The main changes are:

#In the 'Downloaded Table' tab, it should be possible to view the table standings for a specific round, not only the most recent situation.
#Chat.
#Predictions.
#UI adjustments.
#Am. Football, Basketball, Baseball, Icehockey and Tennis live scores.
#Slightly optimized network utilization
#New icon and splash screen
#Ability to update SoccerDB results has temporarily been removed due to lack of tabs...

Version '''0.0.9 - San Siro or Allianz Stadium''' (Future)

#Flag icons instead of country name in the 'regions' of the 'Favourites' tab (Makes the .deb too big and thus exceeding the max size allowed to upload to a post on tmo...) .
#Bugfix version only.
#This will be the candidate for pushing to Extras-Testing. Help will be needed for testing this one.
#If PR1.2 is released, this might make it to Extras-Devel, but don't count on it too much...

Version '''0.1.0''' (Future)

#This is the one for Extras-Testing and (hopefully...) Extras

Version '''0.1.1''' (Future)

#Make use of some features from Qt4.6, most notably portrait mode where it makes sense

Version '''0.1.2''' (Future) and others...
#tbd...

Version '''0.2.0''' (Future)

#This is the 'World Cup ready' version with all the features to allow us to fully enjoy the FIFA World Cup 2010!.

==How to report issues and feature requests==

At the moment, the best way to report issues and suggestion is to post them to the thread on talk.maemo.org or to send an email to qsportsevent@gmail.com.

[[Category:Software]]

Knots2

2011-12-15T03:04:52Z

114.79.28.10: /* Donate */

'''NOTICE! It seems VLC 1.1 was released with broken asf muxing and subtitles stopped working too, so don't upgrade from 1.0.6. You can use [http://downloads.sourceforge.net/portableapps/VLCPortable_1.0.5.paf.exe?download VLC Portable] too. Just copy it to Knots/win32 folder and change the path in settings.

Knots is a Media streaming application for Windows, Mac OS X, Linux and FreeBSD. It allows you to access your desktop computer media collection from anywhere with a browser or using the client available for [[Nokia N900]] and N8x0 internet tablets. Media streaming and transcoding is handled by the excellent [http://www.videolan.org VLC]. Adobe Flash-plugin or VLC browser plugin is needed for browsers that don't support Theora video codec.

Please note that transcoding requires a lot of CPU power and enough memory, especially if source material is high definition quality. If your CPU has several cores and decent amount of memory, you may be able to view 1080p material on your Nokia without the need to re-encode them first.

== Features ==

* Fully thumb driven UI
* Stream videos with on-the-fly transcoding to a Knots client or to a remote computer via the web-frontend. Seeking is supported when possible.
* Stream VDR/Dreambox Live-TV and recordings
* Stream MythTV recordings
* Automatic subtitle fetching for movies, provided by http://www.opensubtitles.org
* Additional info for movies, provided by http://themoviedb.org

== Quick setup guide ==

# Download and install VLC media player and the server software (see below).
# Start the server
# Open a browser (Firefox, Chrome, Safari, not IE) and enter address http://localhost:1978/
# Click on the status tab and make sure VLC is running. If it isn't, make sure the path to vlc.exe executable is correct under 'settings' tab. Save settings and restart server.
# Click on the 'collection' tab, add the folders that contain your media to the list and click on 'update collection' button. Wait until scan is finished.
# Install client and start it. You should be automatically connected and able to listen/view your media.

'''If you want to be able to view media outside your home, through 3G for example, do the following:'''

# Click on settings tab and add a new user. Click on the username that appears on the list, set role to admin, add a password and save the user. Then set "Use authentication without SSL" to yes and save settings. Enter your admin username and password to login.
# Click on settings tab and enable remote discovery. You can use the same username and password you used to authenticate to server if you wish, but they can differ.
# Once you have enabled remote discovery, you need to open access to your computer. If it's directly connected to internet, open ports 1978, 19780-19790. If you use a wireless router or similar, consult the manual on how to do port forwarding. Forward ports 1978 and 19780-19790 to your computer.
# Once you have opened access to your computer, you can playback a video using the browser, click on the 'Hide window' button, click on settings tab and click on 'Check server accessibility from the internet' button. You should see a message saying everything is setup correctly if all is ok.
# Then finally open the client, click on window title bar, click on 'Remote discovery' and authenticate with your remote discovery username and password. If authentication succeeds, you should be able to access your computer automatically from outside your network even if your computer has dynamic ip address.
#* Please note that for watching video through 3G you need to lower the video quality a lot. You can try the Nokia N8x0 profile first and lower bitrate and resolution until it plays without glitches. You also need to have enough upload speed on your internet connection.

==Installation==

To get Knots running, some dependencies have to be met. After that, the server package and the tablet client must be installed. The following steps will guide you in those tasks.

===Dependencies===

Knots server uses [http://www.videolan.org/vlc/ VLC] for streaming and [http://www.ffmpeg.org/ FFmpeg] for screenshots and media info. The following steps explain how to setup those dependencies.

====Ubuntu====

These instructions are for Ubuntu Karmic Koala (9.10) 32 and 64 bit. Other Debian derivates might use slightly different package names, but the general concept of the install is the same for all distros.

apt-get install ruby1.8 ruby rubygems libsqlite3-ruby libopenssl-ruby vlc ffmpeg

* Add the [https://help.ubuntu.com/community/Medibuntu Medibuntu repository] (for ffmpeg), reload your Package information, update your system and open a root terminal (sudo -s), and:

apt-get install libavcodec-unstripped-52 libavdevice-unstripped-52 libavfilter-unstripped-0 libavformat-unstripped-52 libavutil-unstripped-49 libpostproc-unstripped-51 libswscale-unstripped-0 ubuntu-restricted-extras

To get the best result, ubuntu users should compile ffmpeg themselves. [http://ubuntuforums.org/showthread.php?t=786095 Here] and [http://ubuntuforums.org/showpost.php?p=6963607&postcount=360 here] are good guides, you only need to copy-paste few lines.

====Debian (sid)====

Debian follows the [[:wikipedia:Debian Free Software Guidelines|Debian Free Software Guidelines]] policy, which prevents inclusion of several codecs with potential patent issues. To run Knots2, add the [http://debian-multimedia.org/ Debian-Multimedia Repository] to your sources list, install the keyring to avoid warnings, then open a root terminal (su root) and:

apt-get update && apt-get install ruby1.8 ruby rubygems libsqlite3-ruby libopenssl-ruby vlc ffmpeg

Then, to ensure that all requisite libraries are installed:

apt-get install libavcodec52 libavdevice52 libavfilter1 libavformat52 libavutil50 libmp3lame0 libpostproc51 libswscale0

This should allow the knots server to transcode using the default knots2 profiles.

====OS X====

Install latest [http://www.videolan.org/vlc/download-macosx.html VLC] and [http://www.ffmpegx.com/ ffmpegX] to <code>/Applications</code>.

====Windows====

Download and install latest [http://www.videolan.org/vlc/download-windows.html VLC]. For easy setup, install it under <code>C:\Program Files</code>, otherwise you will need to edit the path in server settings.

===Server===

====Linux / FreeBSD / OS X====

*nix compatible OS users can get the latest client and server with git:
git clone git://github.com/solmis/knots.git
or download it from [http://github.com/solmis/knots/archives/master github]

Then start the server with
cd knots
./knots.rb

OS X users can create a standalone app too:
./install/create_osx_app

<code>knots2</code> application should appear in your home folder. You can move to that to <code>/Applications</code>. After running the application an icon appears in the dock which then disappears, but knots should be running.

There is also a prebuilt [http://nakkiboso.com/knots2/knots_osx.zip package] for OS X users (Updated 2010-06-02).

====Windows====

Download the [http://www.mediafire.com/?zwnorymqyfg installer] (Updated 2010-06-13). Install and start the server from the start menu. Then select Configure server from the menu to configure it.

Advanced Windows users who want fixes and features quickly can use git too. Following is required only if you want to go through the trouble of updating the server by hand from time to time and report possible bugs about the new features.

Install Git for Windows from [http://code.google.com/p/msysgit/downloads/list here]. Be sure to add the git binary to your path when asked (2nd option). If you are using Vista/7, make sure you run the installer with administrator rights. Once it's installed, open cmd.exe and run these commands:

cd c:\
git clone git://github.com/solmis/knots.git

Then download the installer, install it somewhere and copy the ruby folder and all the executables and cmd files to <code>c:\knots</code>. Then delete the folder made by the installer and edit the Knots 2 menu items to point to <code>c:\knots</code>. After that you can always update the server to latest version: open <code>cmd.exe</code> and run these commands:

cd c:\knots
git pull

after pulling the latest changes, run <code>Migrate.cmd</code> to migrate possible database changes.

====Sheevaplug====

Sheevaplug doesn't have enough power to do transcoding, but you can listen to music and watch sd material using the Passthrough profile. VLC 0.9.9 that is available by default from the Ubuntu repository works well, but you need to either compile your own ffmpeg or install these [http://ugz.ath.cx:1415/ffmpeg_4_0.5_sheeva_armel.deb ffmpeg] and [http://nakkiboso.com/knots2/x264_1_0_sheeva_armel.deb x264] packages.

===Setup===

Just point your browser to http://localhost:1978 and add your media under settings. If you don't see the ''Update collection'' button, please make sure that both ffmpeg and VLC paths are correct.

[[Image:Screen shot 2009-12-22 at 10.24.11 PM.png|HTML-frontend|500px]]

===Client===

Client for the N8x0 (OS2008/diablo) is available from the [[extras]] repository. Client for the N900 (Maemo5/fremantle) is available from the [[extras-devel]] repository. Please bear in mind that the N900 client is still unfinished. You might come across bugs and other strange behavior (like quickly draining battery ect.) since mplayer currently can't utilize the full potential of the N900's hardware. You should not enable extras-devel if you don't know what you are doing. '''Please read [[extras-devel|the extras-devel article]] before installing Knots 2 for the N900'''

===Accessing the server from the internet securely===

You can stream videos and music from outside your home network using 3G or WLAN, but make sure you make the server more secure. Check '''Can I use the server to view stuff from the internet?''' under [[#Questions and Answers|Questions and Answers]] on how to enable basic auth for the server. If you want SSL encryption for more secure server, you need a custom libsoup library, because SSL is not supported by libsoup by default on Maemo platform. '''We take no responsibility if it messes up other applications using this library.''' Then install the latest client and rootsh from extras(-devel) repositories. Open terminal and run these commands:

'''For the N900'''
root
apt-get install libgnutls26 libgcrypt11 wget
wget "http://nakkiboso.com/libsoup2.4-1_2.26.3-0maemo3+0m5_armel.deb"
dpkg -i libsoup2.4-1_2.26.3-0maemo3+0m5_armel.deb
rm libsoup2.4-1_2.26.3-0maemo3+0m5_armel.deb

'''For the N8x0'''
root
apt-get install libgnutls26 wget
wget "http://nakkiboso.com/knots2/libsoup2.2-8_2.2.105-4_armel.deb"
dpkg -i libsoup2.2-8_2.2.105-4_armel.deb
rm libsoup2.2-8_2.2.105-4_armel.deb

Knots doesn't have a 3G profile currently, because the perfect quality depends on so many things, but you can create a copy of some profile like N8x0 and tune it to suit your network.

Knots now has a feature to automatically connect to your server outside your LAN. Go to Settings -> Remote discovery and create an account for yourself. Server will then update your server location to a remote server every 6 hours. Open client and enable remote discovery by logging in with the same username and password. Client should then automatically connect to your server no matter where you are. After enabling remote discovery you can test your server setup with a click of a button.

==Screenshots==

[[Image:Knots-0.2.6-homescreen.png|Knots2 Client Start Screen|500px]]

[[Image:Knots-0.2.6-tvchannels.png|Knots2 Client browsing tv channels|250px]]
[[Image:Knots-0.2.6-movieinfo.png|Knots2 Client displaying movie info|250px]]

[[Image:Knots-0.2.6-searchfile.png|Knots2 Client searching for video files on server|500px]]

[[Image:Knots-0.2.6-mp3playlist.png|Knots2 Client with a mp3 playlist|250px]]
[[Image:Knots-0.2.6-mp3lyrics.png|Knots2 Client showing song lyrics and rating dialog|250px]]

==Questions and Answers==

===Windows===

* '''Knots finds my media, I can browse it, but everytime I click on play I get an error message saying Stream failed to start. What is wrong?'''
*:This may be caused by Windows Vista/7 UAC, that prevents VLC from starting properly. To fix this, select stop server from the menu to shutdown Knots. Then go to the directory where vlc.exe is, create an empty text file inside it with administrator rights and copy the following text to that file:
vlc.exe -Vdummy --intf=telnet --telnet-host=localhost --telnet-port=4212 --telnet-password=knots -vvv
and save it. Then rename the file to startvlc.cmd and double click it. That should show the UAC prompt asking your permission to run VLC. Once you have allowed that, Knots should work normally.
* '''I want to run knots as a windows service.'''
*:Follow [http://talk.maemo.org/showpost.php?p=302977&postcount=62 these steps].
* '''My virus scanner gives me a warning about netcat.exe that is bundled with Knots'''
*:Netcat is used for VDR support and it's clean so the warning is harmless.
* '''Knots doesn't play media if the path contains non-ascii characters.'''
*:This is an issue with Ruby and Windows. It's hard to fix it in Knots so we will have to wait for Ruby 1.9.2 which fixes these issues. Until then, try to avoid non-ascii characters in filenames. Other operating systems shouldn't be affected by this.

===Linux===

* '''I can't view any videos.'''
*:Did you install the correct packages of the FFmpeg libs? FFmpeg in Linux is a problem because all the license issues etc. so if your distro doesn't provide unrestricted builds you need to compile your own FFmpeg with at least libmp3lame and xvid support. Run ./scripts/vlctest to check what is wrong with your VLC/FFmpeg combo.
* '''Knots stopped working after I upgraded to VLC 1.1'''
*:VLC developers rewrote the telnet interface and renamed the old one. if VLC fails to start, run:
killall -9 ruby vlc
./scripts/setup new_vlc 1 "VLC >= 1.1"
and restart the server.
* '''How do I start Knots on startup?'''
*:It depends on your linux distribution, but usually you can add the following line to your /etc/rc.local
su -c "/full/path/to/knots.rb > /dev/null 2> /dev/null &" yourusername
*:If you want to be able to view your knots session that was autostarted, you may choose to use the 'screen' application that will create a separate shell session for your knots server.
First install 'screen', (if not already done):
sudo apt-get install screen

Again, starting knots using screen is done from rc.local:
sudo -u yourusername -H screen -d -m -S kno /home/'''yourusername'''/knots/startknots.sh

Where the <code>startknots.sh</code> script is simply:
<source lang="bash">
#!/bin/sh
cd /home/'''yourusername'''/knots
./knots.rb
</source>

The screen session can then be resumed from a shell session by issuing the command:
screen -R kno

or to simplify this action further, put an alias in the file <code>/home/'''yourusername'''/.bash_aliases</code>:
alias kno='screen -R kno'

===OS X===

* '''Seeking freezes the video for a while and then stops it.'''
*:This is a VLC issue. It seems to have problems with certain codecs, mainly xvid/divx. Try updating VLC from time to time and see if it that helps. Or better yet, issue a bug report.

===Server===

* '''Page content doesn't seem to update.'''
*:That's because most tabs keep their state. Double click on the tab to force a refresh.
* '''I don't see the Update collection -button under settings.'''
*:Make sure both VLC and FFmpeg have correct paths.
* '''Certain videos only have sound.'''
*:Try changing the transcoding profile. 64-bit Windows seems to have issues transcoding to xvid, so try using the passthrough profile for SD content or browser/theora for HD content.
* '''Lyrics don't work.'''
*:Lyrics-site seems to be down from time to time, try leaving it alone for few days and try again.
* '''Can I use VLC browser plugin to view the video without transcoding?'''
*:Sure. Edit the passthrough profile and add a value vlc to embed and save. VLC plugin doesn't seem to close properly though, so you may need to restart the browser to kill it.
* '''I want to use VDR / MythTV / Dreambox with Knots but can't find a setting for them.'''
*:Stop the server, run <code>./install/vdr</code>, <code>./install/mythtv</code> or <code>./install/dreambox</code> and answer the questions. Double click on Settings tab and you should see a button that updates them. If your VDR/Dreambox has several channels, be sure to change Capture screenshots for external urls to 0 before scanning them. Then change it back to 1 and use the Edit button to grab only the screenshots you want. Dreambox enigma1 requires the Zapstream plugin to be installed, enigma2 should work out-of-the-box.
* '''How can I make the server output some debugging messages to the terminal?'''
*:Run <pre>./scripts/enable_debug true</pre> to enable debug and <pre>./scripts/enable_debug false</pre> to disable it.
* '''Can I use the server to view stuff from the internet?'''
*:Yes, just create an admin user first. Then click on the username and set a password and save. Then enable '''Force authentication''' from the settings. If you want SSL encryption, '''enable SSL''' too. Make sure server asks for authentication and that you can login before enabling access from the internet. You need to open/forward the port you are using and then 19780 for the actual video stream (and +1 for each additional video stream). After enabling remote discovery you can check that your server is properly setup without having to use the client from outside your network.
* '''I get black borders around the video. How can I force it to fullscreen?'''
*:Knots tries to maintain the original aspect ratio of the source material. To override this, stop the server and run
./scripts/setup disable_aspect 1 "Disable video aspect"
:or add it with a browser using Add new setting -button. Adding this setting may also create less artifacts in the video.
* '''I want to tune the streaming profile. Where is some information on the available options?'''
*: Knots relies on vlc for handling the transcoding, so refer to it's [http://www.videolan.org/doc/streaming-howto/en/ch03.html Official Documentation] for the available settings.

===Client===

* '''Why isn't there a pause button?'''
*:Long story short, it would technically work as stop and resume now so use stop and resume instead.
* '''How come the video plays fine with the client, but not when moved to the device?'''
*:Knots transcodes everything to a format your tablet supports. If your VLC can play it on your desktop, chances are your tablet then plays it as well.
* '''I see no rotation menu item on my N8x0.'''
*: Please see [[Rotation]]
* '''Can I just add sticky servers with credentials and disable the automatic discovery?'''
*:Sure, but you need to do it from the command line using xterminal. Here is an example of two sticky servers, first with authentication and SSL, second normal and discovery disabled for faster startup:
gconftool-2 -s /apps/knots/sticky_server0 "My Closed Server/1/1978/server_address/username/password" -t string
gconftool-2 -s /apps/knots/sticky_server1 "My Open Server/0/1978/server_address" -t string
gconftool-2 -s /apps/knots/enable_discovery false -t string
* '''I do not hear sound on the tablet client, but i do on the server.'''
*:Ensure that the mplayer volume is up on the client by repeatedly pressing the + rocker button (volume up) For the n900 confirm the phone sound profile is "general" and not "silent."
* '''Can I change the mplayer command used to view the stream?'''
gconftool-2 -s /apps/knots/mplayer_command "/usr/bin/mplayer -your custom -settings" -t string

Amount of cache, X window id and stream address get appended automatically.

===Media===

* '''Some of my audio/video files aren't scanned.'''
*:You can add the the missing file extensions under settings and do a rescan. To keep the dependencies low, I only support MP3-tags out of the box. But it doesn't mean other audio formats won't work, they just don't get tagged properly.
* '''What about image support?'''
*:As a side effect, you can actually use Knots as an image viewer too. Knots will treat images as videos that will play for 5 seconds. You need to have the latest server installed for it to work. Just add jpg,jpeg,png,gif to the list of scanned file extensions in the settings. This is totally unsupported though and may cause some strange behavior.
* '''I have a folder with recorded tv-series and I want to move them all to Series category. How do I do that?'''
*:Go to Edit media, limit search results to - to list them all and use the path as a search criteria. Once they are listed, click on Select all, add a category or select the one you want to move them to, select Set category action and press Apply to selected. All selected videos are then moved to that category. Same idea works with all the actions.
* '''My mp3-tags are messed up and I have the same album with 3 different names. Can i easily fix that?'''
*:Sure. Just go to Edit media, select the album tag, then select the wrong value and rename it to the correct one. All the songs that are in that album are moved to the correct album. Do it for all the wrong names and all the songs should be in the same album.

===Problems===

* '''My VLC doesn't seem to work.'''
*:For now VLC version needs to be 0.9.3 - 1.0.6. Newer version may work if bugs get fixed, but older ones will not work.
* '''My database is all messed up, how do I start fresh?'''
*:Close the server, go to Knots folder, delete the .config folder and restart the server again. Linux/OS X users can do this easily from the command line when server is not running:
rm -rf ~/.config/knots2
* '''My collections is very big and I often get 'No results' messages when browsing it. How do I make it faster?'''
*:You can speed it up by tagging your media so that results don't become so big, but you can also add a bigger value to the network timeout field of your transcoding profile. Try using something like 90.
* '''I locked myself out with user settings, how can I fix that?'''
*:Run the reset_settings script, it will remove all users, but keep the media. On Windows it's win32/ResetSettings.cmd and on Linux/OS X you can run:
./scripts/reset_settings
* '''Browsing etc. works fine, but playback only produces black screen with no sound and video. Progress bar works though. What's wrong?'''
*:You probably haven't opened/forwarded ports 19780-19790 on your router/desktop firewall.

==Bugs==

If you come across bugs report them at the [http://github.com/solmis/knots/issues Knots bugtracker]. Please attach the necessary information (used Operating System, Tablet Revision, terminal output) and clear steps to reproduce the malfunction.

==Discuss==

You can discuss Knots at [http://talk.maemo.org/showthread.php?t=30095 Talk]. Please submit bugs to github instead of discussion thread.

==Contact==

[http://webchat.freenode.net?channels=knots&uio=d4 Please join our IRC channel #knots at Freenode] or email janne dot makinen at surffi dot fi

==Donate==

Knots 2 is free software, but if you feel like donating, you can donate via [http://nakkiboso.com/knots2/donate.html Paypal] [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm].

[[Category:Media]]
[[Category:Software]]
[[Category:Power users]]

QTMapWidget

2011-12-15T03:04:47Z

114.79.28.10: /* Count me in! */

This page is intended to collect thoughts about a Qt map widget.

== Why a QTMapWidget? ==

Maemo/Meego devices are mobile GPS based devices. A demand for mapping services is thus very obvious. The current situation in [[Open development/Maemo roadmap/Fremantle|Maemo 5]] shows that leaving this task to the individual developers has several disadvantages for the developer as well for the end user.

=== Disadvantages of current Maemo5 situation ===

In Maemo5 there is no generic map widget. Thus various developers came up with their own solutions. Some of these were based on existing widgets (e.g. osm-gps-map), are ports of previous maemo4 projects (mappero) or are completely new solutions written from scratch. Few of these share the same map widget.

* Every developer had to implement his own solution
* Map tiles are stored/cached in different locations on the device
** Waste of bandwidth (one widget cannot re-use data cached by another one and needs to re-download it)
*** Some map servers have limited bandwidth [http://wiki.openstreetmap.org/wiki/Tile_usage_policy], one unified map widget may allow easier caching at one proxy server of all applications that use it.
** Waste of flash space as the same data is stored separately by different map widgets
* No central place for map cache maintenance
** No way to globally add new map sources
** No way to flush the map tile cache
** No way to prefetch map tiles for offline usage
* Individual look and feel for widgets addressing the same problem
* No interoperability (e.g. one app cannot display the track that was captured while another one was running)
* Some widgets don't work behind network proxies
* None of the existing widgets is really developer friendly

== Wishlist ==

If you are a developer and are interested in using such a widget. What would be the things you really want to have? What do you explicitly don't want to see in such a widget?

* Support for various map sources
** Classic tile based sources (openstreetmap [http://www.openstreetmap.org], google [http://maps.google.com], yahoo [http://maps.yahoo.com], virtual earth [http://www.bing.com/maps/])
*** Simple/dynamic method to add more sources (also user specific ones like [[Maemo-mapper topomaps]])
** WMS data [http://www.ogc-services.net/]
** Vector data
*** OSM vector data ("planet file" [http://wiki.openstreetmap.org/wiki/Planet.osm])
*** Map data stored by OVI maps [http://maps.ovi.com/]
* Plugin concept for map sources
* Built-in location support, options:
** GPSD: GPS position
** Liblocation: position (GPS, network), compass and gyro
** QT mobility location: position (GPS, network), compass and gyro
** Ability to provide location to main application
* Overlays
** Static overlays (don't move nor zoom with the map)
*** Current position in textual representation
*** Map center ("cross hair")
*** Scale (metric as well as imperial)
*** Zoom buttons
*** Map source selection
** Dynamic overlays (move and zoom with the map)
*** Waypoints incl. icons
*** Tracks incl. a dynamic one built from GPS data
*** Location indicator (position, direction and precision)
* Separate maintenance tool
** Limit/monitor tile cache size
** Clean tile cache
** Preload tiles for offline usage
** Refresh tiles
** Perhaps as a control panel plugin

== Related resources ==

Qt mobility location [http://labs.trolltech.com/page/Projects/QtMobility]

== Existing widgets ==

We are not the first ones to work with maps under Qt. What projects exist? Can they be re-used? What are their advantages and disadvantages?

=== QMapControl [http://www.medieninf.de/qmapcontrol/] ===

Pros:
* Lightweight
* Runs out of the box on Maemo5
* Supports WMS

Cons:
* Not actively maintained atm
* Lacks basic functionality (GPS integration, live track capture, ...)
* Has some rendering problems under Maemo (track display)
* Google maps integration broken

=== Marble [http://edu.kde.org/marble/] ===

Pros:
* Very active big developer community. Some core developers are involved with the Maemo / MeeGo project already. There are currently 3 GSoC developers working exclusively on Marble.
* Support for Maemo 5 and MeeGo. Early Maemo 5 packages available.
* Lightweight for what it does (100000LOC).
* Used in KDE as a generic map widget already.
* Supports OpenStreetMap, Google Maps, Yahoo, Custom Server Layouts. Basic WMS support.
* Online Routing support (via e.g. ORS).
* Support for position providers as plugins (gpsd, GeoClue, liblocation).
* Support for KML, GPS (support for OSM in the works).
* Different projections (sphere, Mercator, Equirectangular).
* Qt-Style API throughout the Marble Library.

Cons:
* Performance improvements for Maemo 5 necessary. However these are in the works.
* While the overall quality of the code is pretty good there is still some legacy code in a few places.
* I am very concerned regarding battery usage with this 3d approach as it puts a huge load (currently 100%) on the CPU even at low refresh rates --[[User:harbaum|harbaum]] 18:40, 12 June 2010 (UTC)

== Count me in! ==

We need some people who would like to contribute. Please state here if you want to contribute some of your time [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm].

Widget coding:
* Till Harbaum

I have an application i'd like to use such a widget in:
* Till Harbaum (tool to visualize contact positions and to track friends)

UI-Design, Mockups:

[[Category:Development]]
[[Category:Qt]]

N900 Hardware USB

2011-12-15T03:04:26Z

114.79.28.10: /* Host mode details. */

The USB connector on the [[Nokia N900|N900]] is a micro-b connector, as now required in European and Chinese markets, under the [http://en.wikipedia.org/wiki/Universal_Charger_Solution#Universal_Charging_Solution|new scheme to make all phone charger sockets identical].

==USB implementation==

The N900 seems initially to have been designed to be capable of acting as a USB host, or implementing OSG mode. This would have allowed keyboards, mice, and other peripherals to be plugged in.

The USB port with embedded host mode could not be certified, as the OTG drivers were not ready. (see [http://talk.maemo.org/showthread.php?p=643577#post643577] last block).

This lead to the the micro-AB USB connector being replaced by a micro-B, and the host functionality being officially removed short time before launch.

Lacking certification would have a large number of issues, from some operating systems requiring certification before allowing drivers to be distributed, to legal compliance with the USB charger specs - it would technically not be a USB port.

===The Chips===

There are four chips involved in the USB subsystem.

====SoC====

The System-on-a-chip is the main processor on the n900.
This is the [http://focus.ti.com/docs/prod/folders/print/omap3530.html TI omap3430]

====Gaia====

The [[N900_Hardware_Power_management/I2C|TWL4030]] is a TI companion chip to the SoC

====USB battery charger====

The [http://focus.ti.com/docs/prod/folders/print/bq24150.html bq24150] charger from TI is a flexible charger. It, along with the PHY chip - support charging without the intervention of the SoC when the system is charging from a completely dead battery. The PHY chip detects a charger (shorted D+ and D- pins) and the charger uses this information to charge more rapidly.

It also features reverse boost mode - which enables power to be supplied to a USB device connected to the N900. (up to a limit of 200mA)

For more information see [[N900 Hardware Battery Charger]]

====USB Phy====

The [http://www.nxp.com/ NXP] isp1707a is used as the USB PHY chip. [http://www.spinics.net/lists/linux-usb/msg25167.html]. This rights to this part have been bought by ST-Ericson and some information is [http://www.stericsson.com/sales_marketing_resources/USB_transceiverBR_1.pdf available in a brief marketing sheet].

There is no published datasheet for this chip. It may be available under another name.

A reasonably similar chip (compare chips: [http://www.ebv.com/fileadmin/products/Products/ST-Ericsson/Flyer_USB_Transceivers_1.pdf]) is the 1704 which has a datasheet [http://www.stericsson.com/technical_documents/CD00222700.pdf]

For more information see [[N900 Hardware USB PHY]]

===The Circuit===

* The SoC has the USB protocol controller - this is the 'high level' controller - it implements most of the USB protocol. This is a [http://www.mentor.com/products/ip/usb/usb20otg/ Mentorgrafix MUSBMHDRC-core] IntelectualProperty function block licenced for the OMAP.
* The PHY (physical layer) chip connects to the world through the USB socket. This is not the normal companion chip - but the NXP part, and is connected to the SoC via a standard ULPI interface. It does the very lowest level USB hardware protocol. Also it detects chargers (by sensing D+/D- short). It also has a connection to VBUS, via a 1k resistor, to do certain probing.
* The [[N900 Hardware Battery Charger|bq24150 Battery charger]]. This is connected to the battery, and the PHY chip, as well as to the SoC though I2C. It handles (with the PHY chip) charging from dead. It also implements boost mode, to enable powering things through the USB socket. Of course it detects when external VBUS is applied.
* Gaia. The [[N900_Hardware_Power_management/I2C|TWL4030]] is used to sense the value of the ID pin. It also has a connection to VBUS, to power up the device on charger insertion and inform a running system about changes in VBUS state. Though TWL4030 has a function similar to PHY chip as well, the original design using this function had to change as early chip revisions had problems with charger detection (so the rumour). Driver sourecode is full of cruft from that original design.

===The Software===

* [[N900 Software BME|BME]] - the battery managment entity. This has its hands in everything, especially the bq24150, and is split into
** charger detection (via PHY) in kernel MUSB_HDRC driver, exposing /sys/devices/platform/musb_hdrc/charger
** BME - userspace driver for the charger chip, as well as monitoring battery voltage through Gaia.
** Hald-addon-bme - a small helper program to interface between HAL and BME.

* Kernel driver.
** This seems to be a partially implemented OTG driver for the initial design of the N900, with OTG mode partially implemented, assuming that the twl4030 would be used as the USB PHY. It seems to have been modified only to the extent required to make the NXP PHY work as a replacement.

==Host mode details.==

Host mode works, see [http://talk.maemo.org/showthread.php?p=901888#post901888 this thread] Mohammad started on talk.maemo.org, when releasing first beta of a package comprising of a hostmode patched kernel build by Paul Fertser with support of h-e-n team, and a lean GUI built by Mohammad. The basic functionality seems to work fine.

A [[N900_Hardware_USB_Host|user friendly implementation]] that makes it easy to use host mode needs a lot more than this, e.g. proper automounting, clean unmounting and sync, drivers for all kinds of peripherals etc.

A USB OTG controller would normally switch between host and device mode (initially) using the ID pin, to detect if it's at the A or B-side of a OTG cable.

Initially it was claimed that ID is not connected externally, and that this made USB host mode impossible.

While this is mostly correct, it needs some exemplification:
* the ID pin is not connected to PHY, but it is connected to GAIA
* MUSB-core has a hw statemachine that reacts on a telegram from PHY, telling MUSB-core about ID pin grounded and to enter OTG_A hostmode now.
* Other PHY chips (e.g. in N810) [http://goo.gl/Dg36c youtube] [http://goo.gl/16GT5 idm] have a command to make them send this telegram, so you can switch MUSB-core to hostmode under software control (go figure!). 1707 is missing this function.
* There is apparently no way to tell MUSB-core directly to switch to hostmode in a natural way.
* However there is a bit in MUSB-core registers called FORCE_HOST, which is switching MUSB-core into a semi-lobotomized test mode and allowed us to implement h-e-n.

===the following text needs update, it doesn't represent current state of investigation results anymore (corrections in ''(italic)'')===

However, similar device datasheets indicate that the ID pin is used on hardware that supports it to switch between host and device mode.

But, importantly, the ID pin does nothing directly to the state of the PHY. It simply informs the CPU ''(the MUSB-core)'' of the state of the ID pin, and leaves the driver to properly configure the chip (nota bene, only for OTG, and only for determining the inital state).

So, if the kernel can be altered to ignore this pin - which should be trivial if there is host mode support for the chip in the kernel ''(the hw statemachine in MUSB-core won't play nice with whatever kernel does to enable hostmode in a "normal" way)''- then host mode works.(the related sourcecode is to be found here:[http://mxr.maemo.org/fremantle/source/kernel/drivers/usb/musb/musb_core.c#2010], a 'echo host >mode' should work if the kernel driver wasn't crippled in some strange way)''(h-e-n kernel hostmode now is working like this, but still needs another 'echo Fx >/proc/drivers/musb-hdrc' where 'x' is depending on speed. The kernel is "crippled" in a way it can not send a command to PHY to switch to hostmode, as the 1707 '''seems''' doesn't support this - further investigation needed, maybe it has this command but it isn't documented. Or we can spoof this command rsp the resulting telegram)''

The current understanding by several people who are working on USB host mode is:

The USB port can supply power - at least 200mA (as demonstrated here:[http://talk.maemo.org/showthread.php?p=588950#post588950]). This is plenty for many devices - mice and keyboards.

It seems likely that a relatively simple kernel change should enable USB hostmode - http://focus.ti.com/lit/ug/spruf98d/spruf98d.pdf - search for FORCE_HOST - there may well be other cleaner solutions. ''(h-e-n is exploiting this. About the "relatively simple" part that's up to your discretion)
''

A possibly related errata is detailed at 3.1.3 in [http://focus.ti.com/lit/er/sprz278d/sprz278d.pdf this document] - this, and other erratas may or may not cause issues with implementing host mode.

==USB socket==

{{main|N900 Hardware USB Socket}}

===Compatible devices===

{| class="wikitable sortable"
|+ Compatible USB devices
|-
! USB NIC name
! Status
! class="unsortable" | Additional information
! Additional driver needed
! class="unsortable" | Discussion link
|-
| Edimax EU-4207 || Working || no problems found || <code>no</code> || http://talk.maemo.org/showthread.php?t=66667
|-
|}

[[Category:N900 Hardware]]