Editing LED Pattern Editor

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

A control panel applet to edit notification light blinking patterns.

The [[Nokia N900|N900]] has two configurable LED pattern engines.

Each engine can be flexibly programmed with up to 16 commands to vary the brightness of the LEDs it is connected to.

Either engine can be connected to one or more of the three LEDs (Red, Green, Blue) that make up the notification light.

Details can be found on the [[LED patterns]] page.

== Opening ==
To open the LED Pattern Editor, select ''Settings'' and ''LED Patterns''.

=== Viewing patterns ===
The ''LED Patterns'' dialog shows the list of defined patterns with a graphical representation of the LED brightness over time. Each vertical line corresponds to one second.

=== Editing patterns ===
Clicking on a pattern button opens the ''LED pattern editor'' dialog. Below the graphical pattern view, there is a list of commands that will be interpreted by the currently selected engine. Engine 1 or 2 can be selected by the toggle button to the right, below the color chooser buttons which assign the LEDs to drive to each of the engines.
* To edit a command in the currently selected engine's program, tap the command button in the list. Change the command's parameters in the command edit dialog and observe the changes in the graphical pattern view. Select ''Done'' when finished or close the dialog to revert the changes.
* Select ''Delete'' to remove the command from the list.
To add a new command, tap the ''New command'' button at the end of the list.

==== Pattern engine commands ====
Each of the two engines controls a single PWM output that can be used to drive any of the three LEDs in the notification light.
* The ''Set PWM'' command sets the PWM output to the specified level (0-255).
* The ''Ramp'' command increases or decreases the PWM output by the specified number of steps with a specified wait time after each step. The total duration of the ramp is the wait time multiplied by the number of steps plus one, (''wait_time'' * (''steps'' + 1)).
* The ''Wait'' command is the same as a ''Ramp'' with zero steps. The duration is equal to the wait time.
* A ''Trigger'' command is used to wait for a trigger from the other engine or to set a trigger to the other engine to release it from a waiting state. This command can be used to synchronize the two independently running engines.
* The ''Go To Start'' command is used to repeat the pattern from the first step. All patterns must end in a ''Go To Start'' or ''End'' command.
* The ''End'' command stops the engine, ending the program. It can be configured to either ''Hold'' the PWM level at the current value indefinitely or to ''Reset'' the PWM level to 0, turning off the connected LEDs.

=== Copy & paste ===
Patterns can be copied to and pasted from the clipboard in the [[LED patterns#Pattern Format|format described here]].
* The ''Copy'' button (or the keyboard shortcut '''Ctrl+c''') copy the current pattern to the clipboard.
* To paste a pattern from the clipboard, use the keyboard shortcut '''Ctrl+v'''.
See [[LED patterns#Community-Made Patterns|Community-Made Patterns]] for some examples.

=== Testing patterns ===
The ''Test'' button will start to replay the current pattern if it is well-formed. Unfortunately, the mce process will stop the playback occasionally and uncontrollably.

=== Saving changes ===
Selecting ''Done'' in the ''LED pattern editor'' dialog will save the changes to the pattern in the ''LED Patterns'' list. At this point, the changes are not yet applied. Just closing the ''LED Patterns'' dialog will revert any changes. Selecting ''Save'' will store the changes to the mce configuration file after a warning and restart the mce process.

== Restoring original patterns ==
During the first installation, the LED Pattern Editor package stores a backup copy of the mce configuration file. Selecting ''Restore original patterns'' will restore the LED patterns from that file, overwriting all user-created patterns.

[[Category:Software]]
[[Category:Fremantle]]

----

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "https://wiki.maemo.org/LED_Pattern_Editor"

Personal tools

Navigation

Views

Editing LED Pattern Editor

@@ Line 22: / Line 22: @@
 ==== Pattern engine commands ====
-Each of the two engines controls a single PWM (Pulse Width Modulation, a way of dimming) output that can be used to drive any of the three LEDs in the notification light.
+Each of the two engines controls a single PWM output that can be used to drive any of the three LEDs in the notification light.
 * The ''Set PWM'' command sets the PWM output to the specified level (0-255).
 * The ''Ramp'' command increases or decreases the PWM output by the specified number of steps with a specified wait time after each step. The total duration of the ramp is the wait time multiplied by the number of steps plus one, (''wait_time'' * (''steps'' + 1)).