Paroli

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Only the package)
 
(48 intermediate revisions by 18 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!
  
git clone http://git.paroli-project.org/paroli.git/
+
== Important links ==
  
==biggest changes:==
+
* [[Paroli-developer-setup|Paroli developer setup]]
- a launcher was introduced allowing the launching of paroli-applications from within paroli itself.
+
* [[Paroli-application-ideas|Paroli application ideas]]
- the dbus interface is optional and both modes should work.
+
* [[Paroli-issues|Paroli issues]]
 +
* [[Paroli-background|Change the background image]]
 +
* [[Paroli-e|Some e tips]]
 +
* [[Illume_improvements|Illume keyboard improvements]]
  
- closing application windows from within the window-manager does not kill the process anymore
+
== Stuff that works ==
  
- introduction of a preliminary audio service allowing to mute calls (a test service for non-fso environments was also added).
+
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
  
- a reworked version of the dialer was added
+
==Installation / download ==
  
- works on an error-message service have begun
+
=== 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/.
  
- works on a service checking for changes in the fso have begun and many small fixes in the code
+
The image from 08-08-09 has a minor problem with opkg. to fix it
  
===[paroli] weekly update week 10 of 2009===
+
opkg-cl update
here an overview if the highlights of the things the paroli team has been working on in week 9 and the first part of week 10:
+
opkg-cl upgrade
  
-the msgs application is in and being shipped in every build
+
then install paroli
you can view, send, receive, answer to and forward messages
+
also it will offer you to save any unknown number to your phonebook
+
  
-the people application is in and also being shipped every day
+
opkg install paroli
you can view, edit and directly call a contact
+
  
- the call logs i.e. the i/o application is also being shipped
+
Fix the conf files that the paroli installer messes with ( I hope to fix the recipe in the next couple of days. )
you can view your call logs and directly return the call
+
also it will offer you to save any unknown number to your phonebook
+
  
- dtmf in tele
+
cp /etc/old_frameworkd.conf /etc/frameworkd.conf
 +
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml
  
- ussd in tele
+
now if you want to disable the shr phone apps without removing them comment all of the lines out in
you can receive and send simple ussd messages. NOTE: a very ugly window
+
will open with the message written in very small letters, but it works.
+
We will have a look into this a bit later.
+
  
- small reworks on the lists we use
+
/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd
  
- gsm and battery icons
+
if you want the bind-home to ease upgrades add this line to fstab.
  
- muting ringtone when incoming call
+
/media/card/bind-home  /home/root    none        bind                  0  0
  
- muting call  (mutes microphone)
+
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.
  
- Charlie did a complete rework of the service class so that there
+
=== Paroli on OM2009 ===
should not be any errors due to services not waiting for one another anymore
+
  
and lots of other small things that would make this an endless list  :)
+
To install the [[Om2009]] distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/
  
what will we do next:
+
=== Only the package ===
we will focus on some details that had been neglected so far such as
+
In order to get the package from unstable you'll need to adjust the configuration of opkg:
- finally getting some scrolling or paging to work in our lists
+
- getting some secondary actions associated with our list items
+
- look at how we can go about a settings application as discussed on
+
this list earlier
+
- make certain internal adjustments to classes and applications to allow
+
more flexibility
+
- getting an image that works out of the box again
+
  
===7 days update Feb 13 ~ Feb 20===
+
<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.
  
- gotten daily build unstable images which by now boot directly into paroli
+
This should get you the newest version.
  
http://downloads.openmoko.org/distro/unstable/NeoFreerunner/fso-paroli-image-om-gta02.jffs2
+
=== Download ===
  
http://downloads.openmoko.org/distro/unstable/NeoFreerunner/uImage-2.6.28-oe1+gitr34240a1c06ae36180dee695aa25bbae869b2aa26-r3-om-gta02.bin
+
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]
  
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.
+
or from http://downloads.openmoko.org/distro/experimental/
  
- Fixed lots of bugs and issues such as:
+
=== Getting the sources ===
-- 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
+
git clone http://git.paroli-project.org/paroli.git/
  
and
+
== FAQ/Tips ==
  
- were feverishly working on the stuff for the next milestone[2]
+
===What's in the main menu?===
  
What are we planning to do next?
+
* Call-Log is the phone log. It'll show your dialled, answered and missed calls.
  
- keep on fixing issues in MS2
+
** To SMS a contact from Call-Log slide the number to the right to expose "Msg"; push this button to compose a new message.
- 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! [mailto:mirko@openmoko.com|Mirko]]
+
* SMS is the place to send & read messages
  
==Installation==
+
** Slide existing SMS to the right to expose Re: to Reply.
  
on its own image (FSO MS 5 based):
+
* Dialer is the dialer
  
kernel:
+
* People is the phone book
[http://downloads.openmoko.org/distro/unstable/NeoFreerunner/uImage-2.6.28-oe1+gitr34240a1c06ae36180dee695aa25bbae869b2aa26-r3-om-gta02.bin kernel]
+
  
image:
+
** 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 paroli-image]
+
  
===Only the package===
+
** 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.
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:
+
===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.
  
<nowiki>src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t</nowiki>
+
===How do I get to settings?===
  
Then do an opkg-update and opkg install paroli.
+
Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.
  
This should get you the newest version.
 
  
==Downloads==
+
===How do i get gprs to work? ===
  
You can downloads paroli  from :
+
Simpy click on Status in Settings - gprs, it toggles from unregistered to active.
[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]
+
 
 +
===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
 +
 
 +
===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.
 +
 
 +
===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.
 +
 
 +
===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.
 +
 
 +
===How to I turn on the keyboards?===
 +
In the top up menu, there is is a "qwerty" icon. Same to close it.
 +
 
 +
===Where are the messages folder? Drafts, sent etc.?===
 +
 
 +
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?===
 +
 
 +
See [[Om 2009 get active#Paroli phone software|Paroli section on Om2009 "get active" page]].
 +
 
 +
===Is there a way to import my contacts into Paroli's adressbook?===
  
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

[paroli] weekly update week 10 of 2009

here an overview if the highlights of the things the paroli team has been working on in week 9 and the first part of week 10:

-the msgs application is in and being shipped in every build you can view, send, receive, answer to and forward messages also it will offer you to save any unknown number to your phonebook

-the people application is in and also being shipped every day you can view, edit and directly call a contact

- the call logs i.e. the i/o application is also being shipped you can view your call logs and directly return the call also it will offer you to save any unknown number to your phonebook

- dtmf in tele

- ussd in tele you can receive and send simple ussd messages. NOTE: a very ugly window will open with the message written in very small letters, but it works. We will have a look into this a bit later.

- small reworks on the lists we use

- gsm and battery icons

- muting ringtone when incoming call

- muting call (mutes microphone)

- Charlie did a complete rework of the service class so that there should not be any errors due to services not waiting for one another anymore

and lots of other small things that would make this an endless list  :)

what will we do next: we will focus on some details that had been neglected so far such as - finally getting some scrolling or paging to work in our lists - getting some secondary actions associated with our list items - look at how we can go about a settings application as discussed on this list earlier - make certain internal adjustments to classes and applications to allow more flexibility - getting an image that works out of the box again

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+gitr7a2...442-r0_armv4t.ipk

or from:

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