Paroli

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Installation)
 
(52 intermediate revisions by 21 users not shown)
Line 1: Line 1:
In a few words one could say: paroli is a new approach to application development on the Openmoko phones.
+
[[Image:Paroli.png|thumb|Paroli Screenshot]]
 +
===What is Paroli===
 +
Paroli a phone application for the Openmoko phones, that can be used for ....
 +
 
 +
 
 +
=== History ===
 +
Originally it was planned to be released with [[Om2009]] distribution but as OM2009 developement slowed down, Paroli was also compiled for [[SHR]]
 +
 
 
Paroli is based on top of the [[OpenmokoFramework|FSO framework]] and enables the use of it via a core and several services.
 
Paroli is based on top of the [[OpenmokoFramework|FSO framework]] and enables the use of it via a core and several services.
  
 
For more information please visit [http://www.paroli-project.org/ Paroli website]
 
For more information please visit [http://www.paroli-project.org/ Paroli website]
  
== Getting the sources ==
+
If you are  interested in helping out with paroli, contribute code or test or or or ... Let us know! Send a mail to [mailto:vegyraupe@paroli-project.org Mirko] and/or visit #paroli IRC channel!
 +
 
 +
== Important links ==
 +
 
 +
* [[Paroli-developer-setup|Paroli developer setup]]
 +
* [[Paroli-application-ideas|Paroli application ideas]]
 +
* [[Paroli-issues|Paroli issues]]
 +
* [[Paroli-background|Change the background image]]
 +
* [[Paroli-e|Some e tips]]
 +
* [[Illume_improvements|Illume keyboard improvements]]
 +
 
 +
== Stuff that works ==
 +
 
 +
Paroli actually makes FR a simple, very working phone!!
 +
* ability to turn off PIN check & change pin! (The first distro that does it ?)
 +
* Connecting to WLAN (with WPA, WPA2, WEP)
 +
* suspend & resume
 +
* etc etc
 +
 
 +
==Installation / download ==
 +
 
 +
=== Paroli on SHR unstable ===
 +
If you want to try and run paroli in SHR unstable RFN. Flash the latest shr-unstable image from http://shr.bearstech.com/shr-unstable/images/om-gta02/.
 +
 
 +
The image from 08-08-09 has a minor problem with opkg. to fix it
 +
 
 +
opkg-cl update
 +
opkg-cl upgrade
 +
 
 +
then install paroli
 +
 
 +
opkg install paroli
 +
 
 +
Fix the conf files that the paroli installer messes with ( I hope to fix the recipe in the next couple of days. )
 +
 
 +
cp /etc/old_frameworkd.conf /etc/frameworkd.conf
 +
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml
 +
 
 +
now if you want to disable the shr phone apps without removing them comment all of the lines out in
 +
 
 +
/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd
 +
 
 +
if you want the bind-home to ease upgrades add this line to fstab.
 +
 
 +
/media/card/bind-home  /home/root    none        bind                  0  0
 +
 
 +
You should now have a functional paroli on SHR setup. Once you have a working setup it might be better not to run opkg upgrades but only upgrade specific packages when needed.
 +
 
 +
=== Paroli on OM2009 ===
 +
 
 +
To install the [[Om2009]] distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/
 +
 
 +
=== Only the package ===
 +
In order to get the package from unstable you'll need to adjust the configuration of opkg:
 +
 
 +
<nowiki>echo src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t > /etc/opkg/om-unstable.conf</nowiki>
 +
 
 +
Then do an opkg-update and opkg install paroli.
 +
 
 +
This should get you the newest version.
 +
 
 +
=== Download ===
 +
 
 +
Download paroli from
 +
[http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2fdc16174258e9276e7c2d80f500b4dd624442-r0_armv4t.ipk http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2...442-r0_armv4t.ipk]
 +
 
 +
or from http://downloads.openmoko.org/distro/experimental/
 +
 
 +
=== Getting the sources ===
  
 
  git clone http://git.paroli-project.org/paroli.git/
 
  git clone http://git.paroli-project.org/paroli.git/
  
==biggest changes:==
+
== FAQ/Tips ==
- a launcher was introduced allowing the launching of paroli-applications from within paroli itself.
+
- the dbus interface is optional and both modes should work.
+
  
- closing application windows from within the window-manager does not kill the process anymore
+
===What's in the main menu?===
  
- introduction of a preliminary audio service allowing to mute calls (a test service for non-fso environments was also added).
+
* Call-Log is the phone log. It'll show your dialled, answered and missed calls.
  
- a reworked version of the dialer was added
+
** To SMS a contact from Call-Log slide the number to the right to expose "Msg"; push this button to compose a new message.
  
- works on an error-message service have begun
+
* SMS is the place to send & read messages
  
- works on a service checking for changes in the fso have begun and many small fixes in the code
+
** Slide existing SMS to the right to expose Re: to Reply.
  
===7 days update Feb 13 ~ Feb 20===
+
* Dialer is the dialer
  
 +
* People is the phone book
  
- gotten daily build unstable images which by now boot directly into paroli
+
** To call someone, enter the People list, click on the contact, and click on the number displayed
  
http://downloads.openmoko.org/distro/unstable/NeoFreerunner/fso-paroli-image-om-gta02.jffs2
+
** To SMS someone, enter the People list, and slide the contact's name to the right. A "Msg" button will be exposed, which you can press to start a text message.
  
http://downloads.openmoko.org/distro/unstable/NeoFreerunner/uImage-2.6.28-oe1+gitr34240a1c06ae36180dee695aa25bbae869b2aa26-r3-om-gta02.bin
+
===What's beyond the main menu?===
 +
Check "how do I change the theme" below. By default, the display is set to 'paroli' which gives Paroli a full window, but you can change the theme so that you can access other applications outside Paroli using Illume.
  
They do come with bugs and issues sometimes critical like today when paroli hangs because a resource in the framework is not available at paroli launch. This will be gone tomorrow.
+
===How do I get to settings?===
  
- Fixed lots of bugs and issues such as:
+
Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.
-- unicode in message reading
+
-- loading messages from the SIM and saving incoming messages in the
+
phone automatically
+
-- made all our lists automatically react to changes in items etc
+
-- gui issues such as the PIN dialog
+
-- got rid of the green topbar  ;)  
+
-- muting ringtone on incoming call
+
-- muting call in call (also as of tomorrow again)
+
  
- moved most of the Milestone two tickets[1] to testing
 
  
and
+
===How do i get gprs to work? ===
  
- were feverishly working on the stuff for the next milestone[2]
+
Simpy click on Status in Settings - gprs, it toggles from unregistered to active.
  
What are we planning to do next?
+
===How do I change the theme (Illume / Paroli / Paroli-serenity)?===
 +
Open settings, click on "display" and then hit "profile". This will change the profile to the next: after some rumbling on the screen you will have the new theme activated.
 +
* ''paroli'' = Paroli fullscreen
 +
* ''illume'' = Paroli windowed, Illume bar on top
 +
* ''paroli-serenity'' = Paroli windowed, black Illume bar on top
  
- keep on fixing issues in MS2
+
To change to paroli-serenity on command line, run:
- continue working towards MS3
+
DISPLAY=:0 mdbus org.enlightenment.wm.service /org/enlightenment/wm/RemoteObject org.enlightenment.wm.Profile.Set paroli-serenity
- get the kbd to match paroli on the image
+
- get messaging and contacts up and running as soon as possible to allow
+
brave testers to use paroli daily ... any volnteers ?  ;)
+
  
--if anyone is interested in helping out with paroli, contribute code or test or or or ... Let us know! [mailto:mirko@openmoko.com|Mirko]]
+
===How do I shut it down?===
  
==Installation==
+
To turn off Paroli, use the Illume top bar: click the bar when running Paroli and click on the red X to shut down Paroli.
  
on its own image (FSO MS 5 based):
+
To kill it from command line:
 +
pkill paroli
  
kernel:
+
To turn of the whole phone, hold the power button down for 10 seconds. It will not give you a visual feedback, it just starts shutting down.
[http://downloads.openmoko.org/distro/unstable/NeoFreerunner/uImage-2.6.28-oe1+gitr34240a1c06ae36180dee695aa25bbae869b2aa26-r3-om-gta02.bin kernel]
+
  
image:
+
===How do I change the audio profile?===
[http://downloads.openmoko.org/distro/unstable/NeoFreerunner/fso-paroli-image-om-gta02.jffs2 paroli-image]
+
  
only the package
+
* When not on call, short pressing of AUX changes between audio profiles (default / silent).
In order to get the package from unstable you'll need to add a file:
+
* When on call, it changes the speaker volume (20-40-60-80-100%). Using level over 80 might cause some echo.
  
create a file in the '''/etc/opkg''' folder with the content:
+
===How do I close an application?===
 +
When illume or paroli-serenity theme is activated (see above), clicking the top bar will show you 3 icons. The one in the right (the big X) closes the current app.
  
src/gz openmoko-unstable-armv4t
+
===How to I turn on the keyboards?===
http://downloads.openmoko.org/repository/unstable/armv4t
+
In the top up menu, there is is a "qwerty" icon. Same to close it.
  
Then do an opkg-update and opkg install paroli .
+
===Where are the messages folder? Drafts, sent etc.?===
  
This should get you the newest version.
+
The messages will be saved to /home/root/.paroli
 +
 
 +
===How do I lock the screen, without going to suspend?===
 +
 
 +
Sorry, not implemented yet.
 +
 
 +
===How do i set the alarm?===
 +
 
 +
Sorry, not implemented yet.
 +
 
 +
===How do I change the background image?===
 +
 
 +
For a detailed (step-by-step) instruction with example images, please see this page:
 +
[[Paroli-background|Change the background image]]
 +
 
 +
===How do I contribute?===
  
==Downloads==
+
See [[Om 2009 get active#Paroli phone software|Paroli section on Om2009 "get active" page]].
  
You can downloads paroli  from :
+
===Is there a way to import my contacts into Paroli's adressbook?===
http://downloads.freesmartphone.org/fso-
+
milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2fdc16174258e9276e7c2d80f500b4dd624442-
+
r0_armv4t.ipk
+
  
or from:
+
Yes, Ingvaldur Sigurjonsson made a script allowing to import *.vcf files. See [[vcf2paroli]].
  
http://downloads.openmoko.org/distro/experimental/
+
== Known issues ==
 +
See wiki page [[paroli-issues]] for the list of known issues and vital feature requests.
  
 +
Bug tracker is available at http://www.paroli-project.org/trac
  
[[Category:FSO]]
+
[[Category:Paroli]]
 +
[[Category:ApplicationsElementary]]

Latest revision as of 15:05, 15 February 2010

Paroli Screenshot

Contents

[edit] What is Paroli

Paroli a phone application for the Openmoko phones, that can be used for ....


[edit] History

Originally it was planned to be released with Om2009 distribution but as OM2009 developement slowed down, Paroli was also compiled for SHR

Paroli is based on top of the FSO framework and enables the use of it via a core and several services.

For more information please visit Paroli website

If you are interested in helping out with paroli, contribute code or test or or or ... Let us know! Send a mail to Mirko and/or visit #paroli IRC channel!

[edit] Important links

[edit] Stuff that works

Paroli actually makes FR a simple, very working phone!!

  • ability to turn off PIN check & change pin! (The first distro that does it ?)
  • Connecting to WLAN (with WPA, WPA2, WEP)
  • suspend & resume
  • etc etc

[edit] Installation / download

[edit] Paroli on SHR unstable

If you want to try and run paroli in SHR unstable RFN. Flash the latest shr-unstable image from http://shr.bearstech.com/shr-unstable/images/om-gta02/.

The image from 08-08-09 has a minor problem with opkg. to fix it

opkg-cl update
opkg-cl upgrade

then install paroli

opkg install paroli

Fix the conf files that the paroli installer messes with ( I hope to fix the recipe in the next couple of days. )

cp /etc/old_frameworkd.conf /etc/frameworkd.conf
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml

now if you want to disable the shr phone apps without removing them comment all of the lines out in

/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd

if you want the bind-home to ease upgrades add this line to fstab.

/media/card/bind-home   /home/root     none        bind                   0  0

You should now have a functional paroli on SHR setup. Once you have a working setup it might be better not to run opkg upgrades but only upgrade specific packages when needed.

[edit] Paroli on OM2009

To install the Om2009 distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/

[edit] Only the package

In order to get the package from unstable you'll need to adjust the configuration of opkg:

echo src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t > /etc/opkg/om-unstable.conf

Then do an opkg-update and opkg install paroli.

This should get you the newest version.

[edit] Download

Download paroli from http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2...442-r0_armv4t.ipk

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

[edit] Getting the sources

git clone http://git.paroli-project.org/paroli.git/

[edit] FAQ/Tips

[edit] What's in the main menu?

  • Call-Log is the phone log. It'll show your dialled, answered and missed calls.
    • To SMS a contact from Call-Log slide the number to the right to expose "Msg"; push this button to compose a new message.
  • SMS is the place to send & read messages
    • Slide existing SMS to the right to expose Re: to Reply.
  • Dialer is the dialer
  • People is the phone book
    • To call someone, enter the People list, click on the contact, and click on the number displayed
    • To SMS someone, enter the People list, and slide the contact's name to the right. A "Msg" button will be exposed, which you can press to start a text message.

[edit] What's beyond the main menu?

Check "how do I change the theme" below. By default, the display is set to 'paroli' which gives Paroli a full window, but you can change the theme so that you can access other applications outside Paroli using Illume.

[edit] How do I get to settings?

Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.


[edit] How do i get gprs to work?

Simpy click on Status in Settings - gprs, it toggles from unregistered to active.

[edit] How do I change the theme (Illume / Paroli / Paroli-serenity)?

Open settings, click on "display" and then hit "profile". This will change the profile to the next: after some rumbling on the screen you will have the new theme activated.

  • paroli = Paroli fullscreen
  • illume = Paroli windowed, Illume bar on top
  • paroli-serenity = Paroli windowed, black Illume bar on top

To change to paroli-serenity on command line, run:

DISPLAY=:0 mdbus org.enlightenment.wm.service /org/enlightenment/wm/RemoteObject org.enlightenment.wm.Profile.Set paroli-serenity

[edit] How do I shut it down?

To turn off Paroli, use the Illume top bar: click the bar when running Paroli and click on the red X to shut down Paroli.

To kill it from command line:

pkill paroli

To turn of the whole phone, hold the power button down for 10 seconds. It will not give you a visual feedback, it just starts shutting down.

[edit] How do I change the audio profile?

  • When not on call, short pressing of AUX changes between audio profiles (default / silent).
  • When on call, it changes the speaker volume (20-40-60-80-100%). Using level over 80 might cause some echo.

[edit] How do I close an application?

When illume or paroli-serenity theme is activated (see above), clicking the top bar will show you 3 icons. The one in the right (the big X) closes the current app.

[edit] How to I turn on the keyboards?

In the top up menu, there is is a "qwerty" icon. Same to close it.

[edit] Where are the messages folder? Drafts, sent etc.?

The messages will be saved to /home/root/.paroli

[edit] How do I lock the screen, without going to suspend?

Sorry, not implemented yet.

[edit] How do i set the alarm?

Sorry, not implemented yet.

[edit] How do I change the background image?

For a detailed (step-by-step) instruction with example images, please see this page: Change the background image

[edit] How do I contribute?

See Paroli section on Om2009 "get active" page.

[edit] Is there a way to import my contacts into Paroli's adressbook?

Yes, Ingvaldur Sigurjonsson made a script allowing to import *.vcf files. See vcf2paroli.

[edit] Known issues

See wiki page paroli-issues for the list of known issues and vital feature requests.

Bug tracker is available at http://www.paroli-project.org/trac

Personal tools

In a few words one could say: paroli is a new approach to application development on the Openmoko phones. Paroli is based on top of the FSO framework and enables the use of it via a core and several services.

For more information please visit Paroli website

Getting the sources

git clone http://git.paroli-project.org/paroli.git/

biggest changes:

- a launcher was introduced allowing the launching of paroli-applications from within paroli itself. - the dbus interface is optional and both modes should work.

- closing application windows from within the window-manager does not kill the process anymore

- introduction of a preliminary audio service allowing to mute calls (a test service for non-fso environments was also added).

- a reworked version of the dialer was added

- works on an error-message service have begun

- works on a service checking for changes in the fso have begun and many small fixes in the code

7 days update Feb 13 ~ Feb 20

- gotten daily build unstable images which by now boot directly into paroli

http://downloads.openmoko.org/distro/unstable/NeoFreerunner/fso-paroli-image-om-gta02.jffs2

http://downloads.openmoko.org/distro/unstable/NeoFreerunner/uImage-2.6.28-oe1+gitr34240a1c06ae36180dee695aa25bbae869b2aa26-r3-om-gta02.bin

They do come with bugs and issues sometimes critical like today when paroli hangs because a resource in the framework is not available at paroli launch. This will be gone tomorrow.

- Fixed lots of bugs and issues such as: -- unicode in message reading -- loading messages from the SIM and saving incoming messages in the phone automatically -- made all our lists automatically react to changes in items etc -- gui issues such as the PIN dialog -- got rid of the green topbar  ;) -- muting ringtone on incoming call -- muting call in call (also as of tomorrow again)

- moved most of the Milestone two tickets[1] to testing

and

- were feverishly working on the stuff for the next milestone[2]

What are we planning to do next?

- keep on fixing issues in MS2 - continue working towards MS3 - get the kbd to match paroli on the image - get messaging and contacts up and running as soon as possible to allow brave testers to use paroli daily ... any volnteers ?  ;)

--if anyone is interested in helping out with paroli, contribute code or test or or or ... Let us know! [1]]

Installation

on its own image (FSO MS 5 based):

kernel: kernel

image: paroli-image

only the package In order to get the package from unstable you'll need to add a file:

create a file in the /etc/opkg folder with the content:

src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t

Then do an opkg-update and opkg install paroli .

This should get you the newest version.

Downloads

You can downloads paroli from : http://downloads.freesmartphone.org/fso- milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2fdc16174258e9276e7c2d80f500b4dd624442- r0_armv4t.ipk

or from:

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