Customizing maemo for power users

(Step by step instructions)
(Constructing own patterns)
Line 26: Line 26:
The mce.ini -file has description header before pattern defining start. Here will be hopefully easier way to visualize the long strings.
The mce.ini -file has description header before pattern defining start. Here will be hopefully easier way to visualize the long strings.
 +
 +
Example string:
 +
PatternCommunicationCall=30;1;0;r;9d80400002ff03ff02ff03ff71080000;9d800000
 +
 +
 +
Dissection:
 +
{| class="wikitable" border="0"
 +
|-
 +
|  PatternCommunicationCall=
 +
|  30;
 +
|  1;
 +
|  0;
 +
|  r;
 +
|  9d80400002ff03ff02ff03ff71080000;
 +
|  9d800000
 +
|-
 +
|  Alert pattern
 +
|  priority
 +
|  screen on
 +
|  timeout
 +
|  led mapping
 +
|  Engine 1 pattern
 +
|  Engine 2 pattern
 +
|}
 +
 +
 +
==== Priority ====
 +
This defines that which blinking pattern is the strongest. So if multiple alerts are enabled, which pattern will be shown. Values from 0 to 255 are accepted.
 +
 +
==== Screen on ====
 +
from mce.ini:
 +
0 only show pattern when the display is off
 +
1 show pattern even when the display is on
 +
2 only show pattern when the display is off, including acting dead
 +
3 show pattern even when the display is on, including acting dead
 +
4 only show pattern if the display is off, or if in acting dead
 +
5 always show pattern, even if LED disabled
 +
 +
==== Timeout ====
 +
 +
Time in seconds after blinking is stopped. 0 = infinite blinking.
 +
 +
==== Led mapping ====
 +
*r/g/b maps led to engine 1,
 +
*R/G/B maps led to engine 2.
 +
 +
examples:
 +
rGB = red led is mapped to engine 1, green and blue to engine 2
 +
 +
rBg = red and green leds are mapped to engine 1, blue to engine 2.
 +
 +
You can of course define only one colour, for example:
 +
r = red led is mapped to engine
 +
 +
==== Engine patterns ====
 +
 +
from mce.ini:
 +
# 0000 -- Jump to the start of the pattern for the channel
 +
# 40xx -- Set channel brightness
 +
# 9d80 -- Refresh Mux (use as first command in every pattern!)
 +
# xxyy -- Increment/decrement
 +
#      xx determines the speed;
 +
#        02-3f -- short step time (granularity 0.49ms)
 +
#        42-7f -- long step time (granularity 15.6ms)
 +
#
 +
#   If xx is even, increment
 +
#        If xx is odd, decrement
 +
#      yy determines the increment/decrement steps
 +
#        00-ff -- in/decrement steps
 +
#
 +
#        Use 0 steps to create pauses
 +
#        Two consecutive increment/decrement sequences are needed
 +
#        to cover the entire range from 0-255
 +
# c000 -- End pattern execution
 +
# e002 -- Send engine 1 trigger
 +
# e004 -- Send engine 2 trigger
 +
# e008 -- Send engine 3 trigger <used by key backlight!>
 +
# e080 -- Wait for engine 1 trigger
 +
# e100 -- Wait for engine 2 trigger
 +
# e200 -- Wait for engine 3 trigger <used by key backlight!>
source: http://talk.maemo.org/showthread.php?t=37691
source: http://talk.maemo.org/showthread.php?t=37691

Revision as of 07:48, 20 January 2010

Please remember, that doing anything instructed here is potentially dangerous. Please see General precautions for further information.


Contents

Modifying led colours and patterns

There are multiple triggers for led blinking. All can be found in

/etc/mce/mce.ini

The file can be edited with any text editor that can be run with Root access and open the file. So GUI - editors probably don't work, but terminal versions all will.

Step by step instructions

  • Open terminal
  • Gain Root access
  • Make a backup (not necessary!) from original mce.ini -file, for example:
cp /etc/mce/mce.ini /etc/mce/mce.ini_old
  • Open /etc/mce/mce.ini with a text editor
  • Search for a line:
[LEDPatternLystiRX51]
  • Make your changes to the lines below
  • Save
  • Restart mce -process. Either reboot or type to terminal:
initctl stop mce; sleep 2; initctl start mce

Constructing own patterns

The mce.ini -file has description header before pattern defining start. Here will be hopefully easier way to visualize the long strings.

Example string:

PatternCommunicationCall=30;1;0;r;9d80400002ff03ff02ff03ff71080000;9d800000


Dissection:

PatternCommunicationCall= 30; 1; 0; r; 9d80400002ff03ff02ff03ff71080000; 9d800000
Alert pattern priority screen on timeout led mapping Engine 1 pattern Engine 2 pattern


Priority

This defines that which blinking pattern is the strongest. So if multiple alerts are enabled, which pattern will be shown. Values from 0 to 255 are accepted.

Screen on

from mce.ini:

0 only show pattern when the display is off
1 show pattern even when the display is on
2 only show pattern when the display is off, including acting dead
3 show pattern even when the display is on, including acting dead
4 only show pattern if the display is off, or if in acting dead
5 always show pattern, even if LED disabled

Timeout

Time in seconds after blinking is stopped. 0 = infinite blinking.

Led mapping

  • r/g/b maps led to engine 1,
  • R/G/B maps led to engine 2.

examples:

rGB = red led is mapped to engine 1, green and blue to engine 2
rBg = red and green leds are mapped to engine 1, blue to engine 2.

You can of course define only one colour, for example:

r = red led is mapped to engine

Engine patterns

from mce.ini:

# 0000 -- Jump to the start of the pattern for the channel
# 40xx -- Set channel brightness
# 9d80 -- Refresh Mux (use as first command in every pattern!)
# xxyy -- Increment/decrement
#      xx determines the speed;
#         02-3f -- short step time (granularity 0.49ms)
#         42-7f -- long step time (granularity 15.6ms)
#
#	  If xx is even, increment
#         If xx is odd, decrement
#      yy determines the increment/decrement steps
#         00-ff -- in/decrement steps
#
#         Use 0 steps to create pauses
#         Two consecutive increment/decrement sequences are needed
#         to cover the entire range from 0-255
# c000 -- End pattern execution
# e002 -- Send engine 1 trigger
# e004 -- Send engine 2 trigger
# e008 -- Send engine 3 trigger <used by key backlight!>
# e080 -- Wait for engine 1 trigger
# e100 -- Wait for engine 2 trigger
# e200 -- Wait for engine 3 trigger <used by key backlight!>


source: http://talk.maemo.org/showthread.php?t=37691