= Steps and Tips about Wrench tool in ASU theme =

== enlightenment_remote ==
Wrench probably uses utility '''enlightenment_remote'''

This tool is able to
<ul>
<li>Load, Unload and List modules     ( ENABLED = AUTOSTART, module must be LOADed before doing this )</li>
<li>Restart enlightenment, reboot OM, logout from session</li>
<li>Manage fonts, virtual desktops, winlist and process freeze detection&killing</li>
<li>And a lot of less important (some not available on FR) functions</li>
</ul>

To use it from SSH you need to setup environment variable E_IPC_SOCKET. Because it points to a file, it isn't hard to locate it. Just do this:

ls /tmp/enlightenment-root

'''For reply "disp-:0.0-2166|0"''' do

{{note| Don't forget to escape colon (":") and remove anything after pipe ("|") symbol}}

export E_IPC_SOCKET=/tmp/enlightenment-root/disp-\:0.0-2166

Now you should be able to use this tool from SSH connection

Source: Enlightenment wiki page: http://wiki.enlightenment.org/index.php/Modules

== Adding wrench to ASU theme ==

This is already described in article [[Enlightenment .cfg]], including (planned) binary configration files download

[[Category:Utility Applications]]

Enlightenment .cfg

2009-01-09T16:13:58Z

MMlosh: Added section "how to get it"

Enlightenment .cfg

2009-01-09T15:12:44Z

MMlosh: added one small note, that there are no binaries yet

= eet -- '''Way to change enlightenment .cfg files''' =

== Get it ==

NOTE: eet is development tool, so it's not present on FreeRunner (If someone has working mokomakefile, creating package with it should be great idea)

(Comming soon............)

== Use it ==

I've got recently this mail from enlightenment mailing list:

you have to use "eet" command line utility, it is the tool that reads
.src and turns then into .cfg if you check out Makefile (and
Makefile.am).

eet -l e.cfg # list all keys, usually just "config"
eet -d e.cfg config e.src # writes human readable values to file e.src
$EDITOR e.src # change whatever you like
eet -e e.cfg config e.src 1 # compile human readable values to binary form and use compression

If you find that useful and want to help, please create a wiki page
with your new knowledge.

= interesting illume cfg files =
{{note | After any change you must delete directory /home/root/.e/e/config/asu to force configuration reload}}
{{warning | All your changes to illume configuration (usually not so many) will be lost}}
{{note | Maybe it's possible to edit directly files in you home directory, I don't know}}
== /usr/share/enlightenment/data/config/asu/e.cfg ==

Add this in group 'group "E_Config_Gadcon"' after block named " illume-bluetooth" (ASU 2008.12 line 431) to enable Wrench tool (but most of configuration dialogs are not defined in .edj files..)

group "clients" list {
group "E_Config_Gadcon_Client" struct {
value "name" string: "illume-cfg";
value "id" string: "illume-cfg";
value "geom.pos" int: 0;
value "geom.size" int: 32;
value "geom.res" int: 472;
value "geom.pos_x" double: 0.0000000000000000000000000;
value "geom.pos_y" double: 0.0000000000000000000000000;
value "geom.size_w" double: 0.0000000000000000000000000;
value "geom.size_h" double: 0.0000000000000000000000000;
value "state_info.seq" int: 1;
value "state_info.flags" int: 1;
value "style" string: "plain";
value "autoscroll" uchar: 0;
value "resizable" uchar: 0;
}
}

{{note | You get working wrench icon, but color scheme is bad and layouts of some configuration dialogs are missing -> asu.edj needs to be updated too}}

== /usr/share/enlightenment/data/config/asu/module.illume.cfg ==

To switch illume from qtopia predictive keyboard to illume keyboard

REPLACE

value "kbd.use_internal" int: 0;
value "kbd.dict" string: "English_(US).dic";

WITH

value "kbd.use_internal" int: 1;

= ready to use binary configuration files =

(not created / uploaded yet...)

Keyboard Toggle

2009-01-07T21:12:48Z

MMlosh: Added note, that it's still possible in 2008.12 ASU theme

{{Languages|Keyboard Toggle}}
The [[Om 2008.8]] and [[Om 2007.2]] Openmoko [[distributions]] have been designed to bring up an on-screen keyboard which supplies keystroke information to applications. However, this requires the cooperation of the application, which is a problem for software designed with another X11 based phone stack in mind, or software which has been quickly ported from Linux desktop systems, because it will never bring up a keyboard for (possibly important) keystroke information. It is also possible that the keyboard could be brought or remain up by accident when you don't want it there, or even software specifically designed with this functionality in mind may occasionally fail or become confused when an on screen keyboard is supposed to be available.

See [[Om2008.8 Keyboard]] for details of the Om 2008.8 keyboard's usage.

== Alternatives ==
Alternatively, you can try connecting a [[Manually_using_Bluetooth#Being_able_to_use_HID_devices|bluetooth keyboard]] or USB keyboard (Only available with a special cable, or an extra special cable in the case of the older unpowered USB units.)

== Reactivating the keyboard toggle under Om 2008.8 ==
For advanced users using the [[Om 2008.8]] [[Distributions|distribution]], it may be worth your while to change the E17 theme information which prevents the 'qwerty' link in the upper left from showing.

=== On the phone ===

==== Method 1 ====

Simply install the illume-config theme:

opkg install illume-config

Attention: With a Om2008.8 you have then the qpe bug [http://docs.openmoko.org/trac/ticket/1691]. The 'new' Om2008.9-gta02-20081117.rootfs.tar.gz did not have this bug, so a
tar -zxf /media/mmcblk0p2/ in /

fix the bug, but then your settings are restored.

==== Method 2 ====
Install the tools required to decompile and recompile E17 theme code.

opkg install libevas-saver-png edje-utils cpp cpp-symlinks libembryo-tests

Decompile the theme, and edit the edc file

cd /usr/share/enlightenment/data/themes
edje_decc illume.edj
cd illume
vi freerunner.edc

Search for the text 'qwerty'. This should take you to the section which defines the small 'qwerty' button in the upper left.

* Under 'part { name: "kbd";' change 'visible 0;' to 'visible 1;', and change 'relative: 0.0 1.0; ' to 'relative: 1.0 1.0; '
* Under 'part { name: "kbdtext";' change 'visible 0;' to 'visible 1;'

And then recompile the .edj

sh build.sh
mv illume.edj ../illume.edj

And finally restart X to take new theme in use
/etc/init.d/xserver-nodm restart

=== Building a custom package ===
If that doesn't work, follow the instructions on [[Mokomakefile|building Om 2008.8 from source]]. Unpack the source for the package 'illume-theme', edit its edc file using the same method described above, and then finish building the ipk. You should be able to install this ipk, overiding the previous configuration.

=== Upgrading ===
If you upgrade, such as with opkg upgrade, you may have to perform the modification again.

=== In base-image (testing) ===

The openmoko-base-image installs both ''illume'' and ''asu'' themes. You can change theme by editing E's profile. To get QWERTY and the wrench back in base-image, you have use the ''illume'' theme. So there are 3 steps to do:

sed -i -e s,asu,illume, /etc/enlightenment/default_profile
restart X
waiting for few seconds

[http://lists.openmoko.org/pipermail/devel/2008-September/001758.html Reference]

{{note | this is not necessary, see page [[Enlightenment .cfg]], it will guide you to get Wrench & QWERTY button & Illume/Raster's keyboard in ASU theme}}

=== Englightments segfaults with Illume theme too often? ===

If after switching to ''illume'' theme, you experience plentiful of WDOD (white dialog of death) stating that you should recompile and gdb the Enlightenment, you have two choices:

# Disable 'Dropshadow' module (go to illume config (Wrench) -> Modules). It still might segfault at some places but now phone becomes usable with illume theme
# Switch to ''software_x'' from ''software_16'' (same illume config (Wrench) -> Engine). The side-effect is general slow down of graphics performance

Relevant bug reports: [http://docs.openmoko.org/trac/ticket/1767 1767]

[[Category:Application Developer]]

Enlightenment .cfg

2009-01-07T21:03:15Z

MMlosh:

= eet -- '''Way to change enlightenment .cfg files''' =

== Get it ==

(Comming soon............)

== Use it ==

I've got recently this mail from enlightenment mailing list:

you have to use "eet" command line utility, it is the tool that reads
.src and turns then into .cfg if you check out Makefile (and
Makefile.am).

eet -l e.cfg # list all keys, usually just "config"
eet -d e.cfg config e.src # writes human readable values to file e.src
$EDITOR e.src # change whatever you like
eet -e e.cfg config e.src 1 # compile human readable values to binary form and use compression

If you find that useful and want to help, please create a wiki page
with your new knowledge.

= interesting illume cfg files =
{{note | After any change you must delete directory /home/root/.e/e/config/asu to force configuration reload}}
{{warning | All your changes to illume configuration (usually not so many) will be lost}}
{{note | Maybe it's possible to edit directly files in you home directory, I don't know}}
== /usr/share/enlightenment/data/config/asu/e.cfg ==

Add this in group 'group "E_Config_Gadcon"' after block named " illume-bluetooth" (ASU 2008.12 line 431) to enable Wrench tool (but most of configuration dialogs are not defined in .edj files..)

group "clients" list {
group "E_Config_Gadcon_Client" struct {
value "name" string: "illume-cfg";
value "id" string: "illume-cfg";
value "geom.pos" int: 0;
value "geom.size" int: 32;
value "geom.res" int: 472;
value "geom.pos_x" double: 0.0000000000000000000000000;
value "geom.pos_y" double: 0.0000000000000000000000000;
value "geom.size_w" double: 0.0000000000000000000000000;
value "geom.size_h" double: 0.0000000000000000000000000;
value "state_info.seq" int: 1;
value "state_info.flags" int: 1;
value "style" string: "plain";
value "autoscroll" uchar: 0;
value "resizable" uchar: 0;
}
}

{{note | You get working wrench icon, but color scheme is bad and layouts of some configuration dialogs are missing -> asu.edj needs to be updated too}}

== /usr/share/enlightenment/data/config/asu/module.illume.cfg ==

To switch illume from qtopia predictive keyboard to illume keyboard

REPLACE

value "kbd.use_internal" int: 0;
value "kbd.dict" string: "English_(US).dic";

WITH

value "kbd.use_internal" int: 1;

= ready to use binary configuration files =

(not created / uploaded yet...)

Enlightenment .cfg

2009-01-07T14:44:38Z

MMlosh:

= eet -- '''Way to change enlightenment .cfg files''' =

I've got recently this mail from enlightenment mailing list:

you have to use "eet" command line utility, it is the tool that reads
.src and turns then into .cfg if you check out Makefile (and
Makefile.am).

eet -l e.cfg # list all keys, usually just "config"
eet -d e.cfg config e.src # writes human readable values to file e.src
$EDITOR e.src # change whatever you like
eet -e e.cfg config e.src 1 # compile human readable values to binary form and use compression

If you find that useful and want to help, please create a wiki page
with your new knowledge.

= interesting illume cfg files =
{{note | After any change you must delete directory /home/root/.e/e/config/asu to force configuration reload}}
{{warning | All your changes to illume configuration (usually not so many) will be lost}}
{{note | Maybe it's possible to edit directly files in you home directory, I don't know}}
== /usr/share/enlightenment/data/config/asu/e.cfg ==

Add this in group 'group "E_Config_Gadcon"' after block named " illume-bluetooth" (ASU 2008.12 line 431) to enable Wrench tool (but most of configuration dialogs are not defined in .edj files..)

group "clients" list {
group "E_Config_Gadcon_Client" struct {
value "name" string: "illume-cfg";
value "id" string: "illume-cfg";
value "geom.pos" int: 0;
value "geom.size" int: 32;
value "geom.res" int: 472;
value "geom.pos_x" double: 0.0000000000000000000000000;
value "geom.pos_y" double: 0.0000000000000000000000000;
value "geom.size_w" double: 0.0000000000000000000000000;
value "geom.size_h" double: 0.0000000000000000000000000;
value "state_info.seq" int: 1;
value "state_info.flags" int: 1;
value "style" string: "plain";
value "autoscroll" uchar: 0;
value "resizable" uchar: 0;
}
}

{{note | You get working wrench icon, but color scheme is bad and layouts of some configuration dialogs are missing -> asu.edj needs to be updated too}}

== /usr/share/enlightenment/data/config/asu/module.illume.cfg ==

To switch illume from qtopia predictive keyboard to illume keyboard

REPLACE

value "kbd.use_internal" int: 0;
value "kbd.dict" string: "English_(US).dic";

WITH

value "kbd.use_internal" int: 1;

= ready to use binary configuration files =

(not created / uploaded yet...)

User:MMlosh

2008-11-06T17:06:37Z

MMlosh: New page: = Miloš Klouček = '''Kontakty na mě:''' *IRC: MMlosh *Jabber: MMlosh@jabber.cz *mail: FR@elektromaniak.wz.cz

= Miloš Klouček =

'''Kontakty na mě:'''
*IRC: MMlosh
*Jabber: MMlosh@jabber.cz
*mail: FR@elektromaniak.wz.cz