QX

From Openmoko

Revision as of 21:58, 27 November 2010 by Niebert (Talk | contribs)

Jump to: navigation, search

QX is a X-Server that runs under Qt Extended. Especially in the distribution QtMoko it is used to run applications like:

under Qt Extended.

Contents

Starting Applications

You can start applications that need the X-Server with the following steps in QtMoko:

  1. Open Main Menu by clicking on the green Q-Topia "Q"-Box.
  2. Open Applications (4 Boxes, red, yellow, green, blue)
  3. Scroll down and open QX
  4. Select the application that needs the X-Server (e.g. Navit)
  5. Click on the white Paper Icon on the bottom left to open the context menu of the QX application.
  6. Select "Launch" to start application

With the AUX-Button you can exit the X-Server environment without quitting the application.

Screenshots

Use QX-Menu-Button at bottom left
Select Launch to start Navit in QX
  • In Settings you can change the launch settings of the selected application
  • with Favourites you can select the predefined applications you can add to your favourites menu.

QX Favorites

Favorites in QX with Linphone-icon added

QX is the X-Server in QtMoko you can add favorites to the QX-Menu too by manual editing the files in:

 /opt/qtmoko/etc/qx

The file

 favourites.conf

detemines the list of application you will see after starting QX. The file looks like this:

 [Apps]
 list=navit, tangogps

The applicationsnames must exist and need an entry in the profiles.conf file. The file

 profiles.conf

defines the QX-settings for the application. E.g. navit needs the GPS-daemon to be started and the auto-dim function of the display is disabled. These settings can be defined for the applications individually. The file contain profile records like the following for tangogps and navit:

 [tangogps]
 antidim=true
 antisuspend=true
 gps=true
 init=gpsd /dev/ttySAC1
 kbd=false
 qvga=false
 rotate=false
 wm=true

 [navit]
 antidim=true
 antisuspend=true
 gps=true
 init=gpsd /dev/ttySAC1
 kbd=false
 qvga=false
 rotate=false
 wm=true

Add to QX-Favourites

You have installed or programmed an application with the name myapp. Test the application in the QX-terminal if it works properly. Now we add this application myapp to the application list in favourites.conf. We do this e.g. with vi:

 # vi /opt/qtmoko/etc/qx/favourites.conf

The file look like this (press "I" for switching to INSERT mode):

 [Apps]
 list=navit, tangogps, myapp

add lines press ESC and :w for "write to file" and ":q" for "quit VI". Now we have to add a profile record for myapp in file profiles.conf. We do this e.g. with vi:

 # vi /opt/qtmoko/etc/qx/profiles.conf

The file is depended on your settings could look like this and e.g. the following lines (press "I" for switching to INSERT mode):

 [myapp]
 antidim=false
 antisuspend=true
 gps=false
 init=
 kbd=false
 qvga=false
 rotate=false
 wm=false

Then press "ESC" and ":w" for "write to file" and ":q" for "quit VI".

Remove QX-Favorites

You just have to remove the application name from the list of applications in:

 /opt/qtmoko/etc/qx/favorites.conf

You do not need to remove the application profile for your application in profiles.conf.

Personal tools

QX is a X-Server that runs under Qt Extended. Especially in the distribution QtMoko it is used to run applications like:

under Qt Extended.

Starting Applications

You can start applications that need the X-Server with the following steps in QtMoko:

  1. Open Main Menu by clicking on the green Q-Topia "Q"-Box.
  2. Open Applications (4 Boxes, red, yellow, green, blue)
  3. Scroll down and open QX
  4. Select the application that needs the X-Server (e.g. Navit)
  5. Click on the white Paper Icon on the bottom left to open the context menu of the QX application.
  6. Select "Launch" to start application

With the AUX-Button you can exit the X-Server environment without quitting the application.

Screenshots

Use QX-Menu-Button at bottom left
Select Launch to start Navit in QX
  • In Settings you can change the launch settings of the selected application
  • with Favourites you can select the predefined applications you can add to your favourites menu.

QX Favorites

Favorites in QX with Linphone-icon added

QX is the X-Server in QtMoko you can add favorites to the QX-Menu too by manual editing the files in:

 /opt/qtmoko/etc/qx

The file

 favourites.conf

detemines the list of application you will see after starting QX. The file looks like this:

 [Apps]
 list=navit, tangogps

The applicationsnames must exist and need an entry in the profiles.conf file. The file

 profiles.conf

defines the QX-settings for the application. E.g. navit needs the GPS-daemon to be started and the auto-dim function of the display is disabled. These settings can be defined for the applications individually. The file contain profile records like the following for tangogps and navit:

 [tangogps]
 antidim=true
 antisuspend=true
 gps=true
 init=gpsd /dev/ttySAC1
 kbd=false
 qvga=false
 rotate=false
 wm=true

 [navit]
 antidim=true
 antisuspend=true
 gps=true
 init=gpsd /dev/ttySAC1
 kbd=false
 qvga=false
 rotate=false
 wm=true

Add to QX-Favourites

You have installed or programmed an application with the name myapp. Test the application in the QX-terminal if it works properly. Now we add this application myapp to the application list in favourites.conf. We do this e.g. with vi:

 # vi /opt/qtmoko/etc/qx/favourites.conf

The file look like this (press "I" for switching to INSERT mode):

 [Apps]
 list=navit, tangogps, myapp

add lines press ESC and :w for "write to file" and ":q" for "quit VI". Now we have to add a profile record for myapp in file profiles.conf. We do this e.g. with vi:

 # vi /opt/qtmoko/etc/qx/profiles.conf

The file is depended on your settings could look like this and e.g. the following lines (press "I" for switching to INSERT mode):

 [myapp]
 antidim=false
 antisuspend=true
 gps=false
 init=
 kbd=false
 qvga=false
 rotate=false
 wm=false

Then press "ESC" and ":w" for "write to file" and ":q" for "quit VI".

Remove QX-Favorites

You just have to remove the application name from the list of applications in:

 /opt/qtmoko/etc/qx/favorites.conf

You do not need to remove the application profile for your application in profiles.conf.