Maemo Wiki Mirror - User contributions [en]

Customizing Maemo

2010-03-31T10:37:28Z

220.245.168.84: /* Led notifications */

{{Expand}}

This article will someday describe how everybody can customize Maemo 5 to make it as personal as possible. Discussion on t.m.o concerning customization in [http://talk.maemo.org/showthread.php?t=32845 this thread].

== Editing home ==

Through the Edit mode of the Home screen it is possible to:
* Add/move/delete widgets/shortcuts/contacts/bookmarks on the desktop
* Change the the number of desktop home views (1-4 views are available)
* Change background of the home (either for individual view or for all home views simultaneously through wallpaper sets)
* Change active theme of the device (out of the themes available/installed on the device)
Entering the edit mode happens by long tapping the home screen or by tapping the home screen background once and then tapping the Edit mode button which slides down at the top right corner of the home screen.

== Themes ==

Available themes can be installed straight from Application Manager. If you want to make your own theme, see below. See also article [[Themes]].

== Wallpapers ==

There is already [http://www.n900wallpapers.com/ n900wallpapers.com] for wallpapers. Unfortunately, you need a .desktop-file if you want to configure panoramic wallpapers for now.

There will be an application for wallpaper handling to be released (hopefully) soon. See [http://www.n900wallpapers.com/prismic Prismic wallpaper manager]

Also see http://wiki.maemo.org/Customizing_Maemo#Wallpapers_2

== Advanced customization ==
'''DISCLAIMER: Following instructions are only for [http://wiki.maemo.org/Category:Power_users Power users], and operations are potentially dangerous. Please see [[General precautions]] for further information.'''

=== Shortcut to multiple desktops ===

Use the same shortcut twice on the desktops can be useful. In order to do it, you have to manually modify appropiate .desktop file by adding the "X-Multiple=true" entry into the file. See [[Desktop file format]] for further information.

=== Welcome screen ===

It is possible to edit hildon-welcome. A howto is available [http://talk.maemo.org/showpost.php?p=347925&postcount=9 here]. Examples: [http://talk.maemo.org/showpost.php?p=347794&postcount=1 "Open source. Open heart. Open future."], [http://talk.maemo.org/showpost.php?p=350710&postcount=1 "The Power of Open."]

To insert your own video follow these instructions (from the link above thanks to VDVsx):

1- Copy the video you want to play to /usr/share/hildon-welcome/media

2- Go to /etc/hildon-welcome.d/ and edit the default.conf file or create a similar one (the videos will play by the alphabetic order of the .conf files)

=== LED notifications ===

Detailed description for modifying LED -notifications can be found in [[LED patterns]] -article.

=== Themes ===

There is an application for making themes to Maemo OS2008. This will be updated as soon as possible to cover also N900 and Maemo5. See article [[Maemo Theme Maker HOWTO]]

=== Wallpapers ===

If you want to make panoramic wallpapers of your own, you need to create a .desktop -file and put it to same directory where your pictures are.

Example of a .desktop -file:
[Desktop Entry]
Type=Background Image
Name=Deers
Hidden=true

X-File1=/home/user/MyDocs/.images/deer1.png
X-File2=/home/user/MyDocs/.images/deer2.png
X-File3=/home/user/MyDocs/.images/deer3.png
X-File4=/home/user/MyDocs/.images/deer4.png

X-Order=01

====How to change a certain wall paper in terminal?====
gconftool -s --type string /apps/osso/hildon-desktop/views/1/bg-image $PATHTOIMAGE

Replace number "1" with the number of the desktop that you'd like change.<ref>http://talk.maemo.org/showpost.php?p=483028&postcount=2</ref>

====Where are the slider screen files located?====
The background image is lockslider.png and goes in /usr/share/themes/alpha/backgrounds/

The other images (LockSliderTop.png, LockSliderThumbPortrait.png, LockSliderThumb.png, LockSliderRight.png, LockSliderLeft.png, LockSliderBottom.png) go in /usr/share/themes/alpha/images

===Using the same widget on multiple desktops===

The folder /usr/share/applications/hildon contains files that contain info about installed programs. Duplicating these files will result in duplicating them in the shortcut list. However, this will result in a side effect causing the program to show multiple times the programs in the "More.." folder.

=== Contents of power key menu ===

Information on how to add reboot button to power key menu, add new keyboard shortcuts [http://talk.maemo.org/showthread.php?t=39565 N900 MODs]

Instructions on how to add the reboot key (from the link above thanks to f2thak):

1- Open xterm and type sudo gainroot to enable root access

2- Navigate to /etc/systemui

3- Create a backup copy of the systemui file by typing cp systemui.xml systemui.xml.bak

4- Edit the systemui file by typing vi systemui.xml

5- At the bottom of the file you will notice that part of it (consisting of three ... entries) is disabled within the "comment" marks

6- Move the "comment" marks mentioned above "<! --" without the space between ! and - (e.g. by deleting and re-typing them in other place) so that the two remaining entries ("Soft poweroff" and "Top in XTerm") are still within them but the "Reboot" entry gets outside of them. To do this, hit the key "i" to begin editing and the Esc button in xterm to stop (once you are done editing "dd" will delete any line you created by accident). Type :wq to save and edit after being done editing

7- Close X-Terminal and reboot the device. After the N900 reboots, you should see the new "Reboot" option in the Menu

=== Transitions ===

Transition Control is an application which allows you to change various transition effects of the phone. Another approach is to edit the
/usr/share/hildon-desktop/transitions.ini file (root access is needed)

===Keyboard characters===

[[Remapping keyboard]]

[[Special_characters_view]]

===Application Menu===

[[Application Menu]]

===Camera Sound===

In /usr/share/sounds the files camera_snd_title_1, 2 and 3 (1 is the camera shutter sound, 2 is the video recording sound and 3 is the focus sound) just replace them with any working wav sound file OR for a SILENT CAMERA just rename or delete these files! <ref name="camsnd">[http://talk.maemo.org/showthread.php?p=462484 Silent Camera Hack ]</ref>

===Editing SMS and Chat templates===
You can change the way you read SMS and chat conversations by editing the html files in /usr/share/rtcom-messaging-ui/html.<ref>http://talk.maemo.org/showthread.php?t=36618</ref>

===Slide to Unlock Screen===
You can edit the "Slide to Unlock" screen that appears upon pressing the power button while the phone is locked. You can do this by editing the png files found in /usr/share/themes/alpha/backgrounds/ <ref>http://talk.maemo.org/showpost.php?p=491060&postcount=403</ref>

===Status Icons===
====Editing The Status Icons====
You can edit the status icons by editing the files found in /usr/share/icons/hicolor <ref>http://talk.maemo.org/showpost.php?p=481662&postcount=252</ref>
====Reordering The Status Icons====
You can reorder the status icons that display on top of your desktop by editing /ect/hildon-desktop/status-menu.plugins<ref>http://talk.maemo.org/showpost.php?p=485678&postcount=334</ref>

Change the number(s) for the "X-Status-Menu-Position" section. The higher number, the lower the priority.

=== Icons ===

you can install them into ~/.local/share/icons/hicolor/scalable/hildon and they'll override the system icons, but leave them in place. [Does this apply to all icons adn images??]

*/usr/share/icons/hicolor/scalable/hildon
**Signal images
**Battery1 images
<pre>
statusarea_battery_full13.png
statusarea_battery_full25.png
statusarea_battery_full38.png
statusarea_battery_full50.png
statusarea_battery_full63.png
statusarea_battery_full75.png
statusarea_battery_full88.png
statusarea_battery_full100.png
</pre>

*/usr/share/icons/hicolor/48x48/hildon/
** Battery2 images
** Availability images

*/usr/share/icons/hicolor/16x16/hildon
** Availability (Small) images

To install the bootup icons place the icons here (make sure you backup the original icons first!): /usr/share/icons/hicolor/scalable/hildon/

<pre>
indicator_update1.png
indicator_update2.png
indicator_update3.png
indicator_update4.png
indicator_update5.png
indicator_update6.png
indicator_update7.png
indicator_update8.png
</pre>

===Sound Effects===
You can edit the UI sound effects by editing the sound files found in /usr/share/sounds <ref>http://talk.maemo.org/showpost.php?p=486875&postcount=346</ref>

===Disabling Auto Updates Check===
You may want to disable the automatic software updates checks that occur upon internet connection, in order to consume less bandwidth when using 2G/3G connections. You can do so by editing the gconf file found in /var/lib/gconf/apps/hildon/update-notifier and changing the check interval from 1440(24 hours) to a much larger value. The value must not exceed 4,294,967,295.

== Resources & Links ==

Advanced Tweaks: [http://talk.maemo.org/showthread.php?t=39948 Collection of Low-Level Config-Files / Tools]

[https://garage.maemo.org/projects/powatool/ Powatool]

[http://wiki.maemo.org/Maemo_Summit_2009/Day_2#Personalizing_your_Maemo_5_device Personalizing your Maemo 5 device] presentation ([http://www.slideshare.net/hartti/n900-personalization slides]) at Maemo Summit 2009.

==References==
{{Reflist}}

[[Category:Power_users]]
[[Category:N900]]

Customizing Maemo

2010-03-31T10:36:21Z

220.245.168.84: /* Reordering The Status Icons */

{{Expand}}

This article will someday describe how everybody can customize Maemo 5 to make it as personal as possible. Discussion on t.m.o concerning customization in [http://talk.maemo.org/showthread.php?t=32845 this thread].

== Editing home ==

Through the Edit mode of the Home screen it is possible to:
* Add/move/delete widgets/shortcuts/contacts/bookmarks on the desktop
* Change the the number of desktop home views (1-4 views are available)
* Change background of the home (either for individual view or for all home views simultaneously through wallpaper sets)
* Change active theme of the device (out of the themes available/installed on the device)
Entering the edit mode happens by long tapping the home screen or by tapping the home screen background once and then tapping the Edit mode button which slides down at the top right corner of the home screen.

== Themes ==

Available themes can be installed straight from Application Manager. If you want to make your own theme, see below. See also article [[Themes]].

== Wallpapers ==

There is already [http://www.n900wallpapers.com/ n900wallpapers.com] for wallpapers. Unfortunately, you need a .desktop-file if you want to configure panoramic wallpapers for now.

There will be an application for wallpaper handling to be released (hopefully) soon. See [http://www.n900wallpapers.com/prismic Prismic wallpaper manager]

Also see http://wiki.maemo.org/Customizing_Maemo#Wallpapers_2

== Advanced customization ==
'''DISCLAIMER: Following instructions are only for [http://wiki.maemo.org/Category:Power_users Power users], and operations are potentially dangerous. Please see [[General precautions]] for further information.'''

=== Shortcut to multiple desktops ===

Use the same shortcut twice on the desktops can be useful. In order to do it, you have to manually modify appropiate .desktop file by adding the "X-Multiple=true" entry into the file. See [[Desktop file format]] for further information.

=== Welcome screen ===

It is possible to edit hildon-welcome. A howto is available [http://talk.maemo.org/showpost.php?p=347925&postcount=9 here]. Examples: [http://talk.maemo.org/showpost.php?p=347794&postcount=1 "Open source. Open heart. Open future."], [http://talk.maemo.org/showpost.php?p=350710&postcount=1 "The Power of Open."]

To insert your own video follow these instructions (from the link above thanks to VDVsx):

1- Copy the video you want to play to /usr/share/hildon-welcome/media

2- Go to /etc/hildon-welcome.d/ and edit the default.conf file or create a similar one (the videos will play by the alphabetic order of the .conf files)

=== Led notifications ===

Detailed description for modifying LED -notifications can be found in [[LED patterns]] -article.

=== Themes ===

There is an application for making themes to Maemo OS2008. This will be updated as soon as possible to cover also N900 and Maemo5. See article [[Maemo Theme Maker HOWTO]]

=== Wallpapers ===

If you want to make panoramic wallpapers of your own, you need to create a .desktop -file and put it to same directory where your pictures are.

Example of a .desktop -file:
[Desktop Entry]
Type=Background Image
Name=Deers
Hidden=true

X-File1=/home/user/MyDocs/.images/deer1.png
X-File2=/home/user/MyDocs/.images/deer2.png
X-File3=/home/user/MyDocs/.images/deer3.png
X-File4=/home/user/MyDocs/.images/deer4.png

X-Order=01

====How to change a certain wall paper in terminal?====
gconftool -s --type string /apps/osso/hildon-desktop/views/1/bg-image $PATHTOIMAGE

Replace number "1" with the number of the desktop that you'd like change.<ref>http://talk.maemo.org/showpost.php?p=483028&postcount=2</ref>

====Where are the slider screen files located?====
The background image is lockslider.png and goes in /usr/share/themes/alpha/backgrounds/

The other images (LockSliderTop.png, LockSliderThumbPortrait.png, LockSliderThumb.png, LockSliderRight.png, LockSliderLeft.png, LockSliderBottom.png) go in /usr/share/themes/alpha/images

===Using the same widget on multiple desktops===

The folder /usr/share/applications/hildon contains files that contain info about installed programs. Duplicating these files will result in duplicating them in the shortcut list. However, this will result in a side effect causing the program to show multiple times the programs in the "More.." folder.

=== Contents of power key menu ===

Information on how to add reboot button to power key menu, add new keyboard shortcuts [http://talk.maemo.org/showthread.php?t=39565 N900 MODs]

Instructions on how to add the reboot key (from the link above thanks to f2thak):

1- Open xterm and type sudo gainroot to enable root access

2- Navigate to /etc/systemui

3- Create a backup copy of the systemui file by typing cp systemui.xml systemui.xml.bak

4- Edit the systemui file by typing vi systemui.xml

5- At the bottom of the file you will notice that part of it (consisting of three ... entries) is disabled within the "comment" marks

6- Move the "comment" marks mentioned above "<! --" without the space between ! and - (e.g. by deleting and re-typing them in other place) so that the two remaining entries ("Soft poweroff" and "Top in XTerm") are still within them but the "Reboot" entry gets outside of them. To do this, hit the key "i" to begin editing and the Esc button in xterm to stop (once you are done editing "dd" will delete any line you created by accident). Type :wq to save and edit after being done editing

7- Close X-Terminal and reboot the device. After the N900 reboots, you should see the new "Reboot" option in the Menu

=== Transitions ===

Transition Control is an application which allows you to change various transition effects of the phone. Another approach is to edit the
/usr/share/hildon-desktop/transitions.ini file (root access is needed)

===Keyboard characters===

[[Remapping keyboard]]

[[Special_characters_view]]

===Application Menu===

[[Application Menu]]

===Camera Sound===

In /usr/share/sounds the files camera_snd_title_1, 2 and 3 (1 is the camera shutter sound, 2 is the video recording sound and 3 is the focus sound) just replace them with any working wav sound file OR for a SILENT CAMERA just rename or delete these files! <ref name="camsnd">[http://talk.maemo.org/showthread.php?p=462484 Silent Camera Hack ]</ref>

===Editing SMS and Chat templates===
You can change the way you read SMS and chat conversations by editing the html files in /usr/share/rtcom-messaging-ui/html.<ref>http://talk.maemo.org/showthread.php?t=36618</ref>

===Slide to Unlock Screen===
You can edit the "Slide to Unlock" screen that appears upon pressing the power button while the phone is locked. You can do this by editing the png files found in /usr/share/themes/alpha/backgrounds/ <ref>http://talk.maemo.org/showpost.php?p=491060&postcount=403</ref>

===Status Icons===
====Editing The Status Icons====
You can edit the status icons by editing the files found in /usr/share/icons/hicolor <ref>http://talk.maemo.org/showpost.php?p=481662&postcount=252</ref>
====Reordering The Status Icons====
You can reorder the status icons that display on top of your desktop by editing /ect/hildon-desktop/status-menu.plugins<ref>http://talk.maemo.org/showpost.php?p=485678&postcount=334</ref>

Change the number(s) for the "X-Status-Menu-Position" section. The higher number, the lower the priority.

=== Icons ===

you can install them into ~/.local/share/icons/hicolor/scalable/hildon and they'll override the system icons, but leave them in place. [Does this apply to all icons adn images??]

*/usr/share/icons/hicolor/scalable/hildon
**Signal images
**Battery1 images
<pre>
statusarea_battery_full13.png
statusarea_battery_full25.png
statusarea_battery_full38.png
statusarea_battery_full50.png
statusarea_battery_full63.png
statusarea_battery_full75.png
statusarea_battery_full88.png
statusarea_battery_full100.png
</pre>

*/usr/share/icons/hicolor/48x48/hildon/
** Battery2 images
** Availability images

*/usr/share/icons/hicolor/16x16/hildon
** Availability (Small) images

To install the bootup icons place the icons here (make sure you backup the original icons first!): /usr/share/icons/hicolor/scalable/hildon/

<pre>
indicator_update1.png
indicator_update2.png
indicator_update3.png
indicator_update4.png
indicator_update5.png
indicator_update6.png
indicator_update7.png
indicator_update8.png
</pre>

===Sound Effects===
You can edit the UI sound effects by editing the sound files found in /usr/share/sounds <ref>http://talk.maemo.org/showpost.php?p=486875&postcount=346</ref>

===Disabling Auto Updates Check===
You may want to disable the automatic software updates checks that occur upon internet connection, in order to consume less bandwidth when using 2G/3G connections. You can do so by editing the gconf file found in /var/lib/gconf/apps/hildon/update-notifier and changing the check interval from 1440(24 hours) to a much larger value. The value must not exceed 4,294,967,295.

== Resources & Links ==

Advanced Tweaks: [http://talk.maemo.org/showthread.php?t=39948 Collection of Low-Level Config-Files / Tools]

[https://garage.maemo.org/projects/powatool/ Powatool]

[http://wiki.maemo.org/Maemo_Summit_2009/Day_2#Personalizing_your_Maemo_5_device Personalizing your Maemo 5 device] presentation ([http://www.slideshare.net/hartti/n900-personalization slides]) at Maemo Summit 2009.

==References==
{{Reflist}}

[[Category:Power_users]]
[[Category:N900]]

Mame

2010-03-06T04:45:40Z

220.245.168.84: /* ROM Status */

SDLMAME is the [http://www.libsdl.org/ Simple Directmedia Layer] [[port]] of the [http://mamedev.org/ Multiple Arcade Machine Emulator]. MAME has the ambitious goal to make it possible to archive all arcade machines by creating working hardware emulators to host all the the game code, or ROMs, that these machines employ.

==Project Status==

SDLMAME is currently being [[port| ported]] to Maemo 5. For MAME for earlier Maemo versions, see [http://maemo.org/downloads/product/OS2008/xmame/ XMAME].At this point, SDLMAME is only available in [[Extras-devel]], due to its incomplete state.

See [http://talk.maemo.org/showthread.php?t=42824 the Talk thread] for discussion of the progress.

==ROM Directory==

ROMS go into the following folder:
/home/user/MyDocs/roms

==ROM Status==

Remember, for the sake of organization:
# Add games alphabetically and in the appropriate category.
# Make sure a game doesn't already exist in a different category.
## If a game is already in the list and in the same category as you would put it, make it '''bold''' by adding triple single quotes on either side of the name to indicate confirmation by a second tester.
## If the game is in a different category than you have it, move it to the Mixed Reviews list and indicate next to it the two conflicting experiences.
## If it's already in the Mixed Reviews list and you confirm one of the previous reviews, move it to that list.

Thanks for your help maintaining this list!

===Playable===
''These are games that seem identical to the arcade experience.''

* 1943 - 95% speed, Sound fair.
* Aerofighters
* '''Arkanoid'''
* Astro blaster - working / good - 100% speed
* Astro Force
* '''Atari Tetris''' (very minor sound crackle)
* Aurail
* Black Tiger (blktiger1, I couldn't run the original rom)
* Block
* Block Out (blockout)
* '''Blood Brothers (bloodbro)'''
* '''Bomb Jack'''
* '''Bubble Bobble'''
* Burnin rubber - working / good - 100% speed
* Cabal - working / good - 94% speed (very minor sound crackle)
* Cameltry
* Carnival - working / good - 100% speed (very minor dip in speed now & again)
* Commando - working / good - 99% speed
* '''Dig Dug'''
* DonDonPachi
* Dragon buster - working / good - 99% speed
* Exerion (exerion)
* Gaplus
* Galaga
* '''Ghosts'n Goblins (gng)'''
* Gorf - working / good - 98% speed (works great it just needs portrait mode)
* Hyper sports - working / good - 100% speed
* Jungle King
* '''Mr Do'''
* Pacman
* '''Pacland'''
* Pang (pang)
* Rainbow islands - working . good - 91% speed (the odd stutter but playable)
* Rygar (rygar)
* Side Pocket
* Sky kid - working / good - 99% speed
* '''Tehkan World Cup (tehkanwc)''' - working / good - 100% (very very minor sound crackle)
* Snow Bros (snowbros)
* Track & field - working / good - 100% speed
* '''Wonderboy'''
* Wonderboy in monster land - working / good - 99% speed (very very slight sound crackle)
* Vulgus
* '''Zaxxon'''

===Problematic===

''These are games that run significantly below 100% or have other problems that make them less than ideal for playing.''

* After burner - working / very slow - 29% speed (sound crackle)
* After burner 2 - working / very slow - 27% speed (sound crackle)
* Arkanoid 2 Revenge of Doh (arkanoid2) - Very slow 45%
* Bad dudes vs dragon ninja - working / ok/jerky - 73% speed (sound crackle)
* Chase hq - working / jerky - 42% speed (some sound crackle)
* Continental circus - working / jerky - 46% speed (sound crackle)
* Double Dragon (ddragon) --> Very slow 50%. Can't start game when using same key for coin/start.
* Dungeons & Dragons Tower of Doom (ddtod) --> Slow 65%
* Empire strikes back - working / jerky - 50% speed(sound crackle & dark vector grafix)
* Galaga 88
* Galaxian
* '''Gauntlet''' --> Some audio distortion
* Ghouls n ghosts - working / jerky - 77% speed (some sound crackle)
* Golden Axe 2 --> somewhat slow but runs
* Marble madness - working / slow/jerky - 61% speed (sound crackle)
* Megatech (small selection of megadrive and sms games) - working / jerky and slow - 32% speed (sound crackle and small screen due to megatech layout)
* Metal Slug X - working / jerky - 36% speed (sound crackle)
* Moonwalker - working / jerky and slow - 53% speed (sound crackle)
* Nemesis - working / jerky - 70% speed (some sound crackle)
* Outrun - working / very slow - 16% speed (keys stuck on mouse setting)
* Pacmania
* Paperboy - working / jerky - 53% speed (sound crackle)
* Phoenix (amstar) - working / jerky - 42% speed (sound crackle)
* Road runner - working / jerky - 53% speed (sound crackle)
* Pole position 2 - working / slow - 54% speed
* Rastan (rastan) --> Very slow 55%.
* R-type - working / good-ish - 32% speed then after 40secs jumps to 80%(very odd)
* Road blasters - working / slow/jerky - 44% speed (sound crackle)
* Robocop - working / slow/jerky - 66% speed (sound crackle)
* Robocop 2 - working / jerky - 60% speed (sound crackle)
* Salamander - working / slow/jerky - 56% (sound skips)
* Sega rally championship - working / very slow - 16% speed (graphics incorrect)
* Space harrier - working / slow - 41% (speed sound crackle)
* Spy hunter - working / jerky - 42% speed (some sound crackle)
* Star wars - working / jerky - 62% speed (sound crackle & dark vector grafix)
* Star wars arcade - working / jerky very slow - 26% speed (crackle on sound)
* Strider - working / slow/jerky - 84% speed (sound jumps)
* Super space invaders 91 - works / jerky - 67% speed (some sound crackle)
* Tecmo world cup millenium - working / slow & jerky - 32% speed i think (very small text) sound crackle
* Tecmo world cup 90 - working / good - 94% speed (speed drops for 2secs now & then)
* Vulcan venture - working / jerky - 52% speed (sound crackle)
* Wec le mans - working / jerky - 48% speed (some sound crackle)

===Broken===

''These are games that crash, lockup or otherwise simply fail to work.'

* 1945iii = s1945iii.zip (loading)
* Dragonblaze = dragblz.zip (loading)
* Hard drivin - not working -locks up phone
* Ridge racer - not working - crashes emulator
* Salamander 2 - not working - black screen
* Super World Series = sws.zip (playing)
* Tekken - not working and crashes emulator
* Vs super mario bros - does not load

===Mixed Reviews===

''These ROMs have given two different experiences. A third review confirming one of the other two can move it to the right category.''

* Golden Axe (goldnaxe.zip) --> Very slow and choppy sound

[[Category:Games]]
[[Category:Users]]

Games

2010-03-05T13:05:30Z

220.245.168.84: /* Play-station Six Axis Controller */

[[Image:SNES.jpg]]
=N900 Gaming=
The N900 makes a great gaming device. It has a TV Out, Accelerometers, and hardware support for 3D graphics.

[http://www.youtube.com/watch?v=zBzUNe5ov_o&feature=player_embedded Video] showing what can be done with 3D and TV out

There is a range of options to get games on your device.

==Native Games and Games Publishers==
The N900 supports SDL and hardware accelerated 3D OpenGL ES, allowing it to run several linux games. Several are available in the Maemo 5 'extras' repository.

* [http://talk.maemo.org/showthread.php?t=34559 3d graphics engines]
* [http://maemo.org/downloads/Maemo5/games/?org_openpsa_qbpager_org_openpsa_products_product_dba_page=1 Maemo 5 Downloads]
* [http://maemo.org/downloads/OS2008/games/?org_openpsa_qbpager_org_openpsa_products_product_dba_page=1 OS2008 games] - most of these games should be portable to the N900
* [[Chess]] - there are a variety of chess games available, including:
** [[Miniature]] - a networked, community-developed chess program, designed for Maemo - coming soon
* [http://talk.maemo.org/showthread.php?t=31658 Quake3]
* [[uqm | The Ur-Quan Masters (Starcontrol 2)]]

===Rovio===

Rovio have ported the following games to the N900

* Bounce Evolution
* Angry Birds. The Community have also created [http://talk.maemo.org/showthread.php?t=42999&highlight=angry+birds custom level] editor for this great game

Both are available from the Ovi store
[http://store.ovi.com/publisher/RovioMobile/ Ovi Rovio Games]

===SIO2 Interactive===

SIO2 Interactive have ported their Open Source 3D engine to the N900, and have released a number of games.

[http://talk.maemo.org/showthread.php?t=43202 SIO2 Games Thread]

===Secret Exit===

Secret Exit will be release a number of Games for N900

[http://talk.maemo.org/showthread.php?t=42412&highlight=zeemote Secret Exit Game Thread]

==Flash Games==
As the N900 supports Flash 9 and has a hardware keyboard, many flash games should just work. [http://talk.maemo.org/showthread.php?t=34472&highlight=flash+games Read more about the options].

==Games Emulators==

There are [http://talk.maemo.org/showthread.php?t=34526 many emulators] of older game consoles available for Maemo.

* Game boy colour - [http://maemo.org/downloads/product/Maemo5/vgb/ Vgb]
* Game boy advance - [http://maemo.org/downloads/product/Maemo5/vgba/ Vgba]
* Nintendo Entertainment System - [http://maemo.org/downloads/product/Maemo5/ines/ iNES]
* Nintendo SNES - [http://maemo.org/downloads/product/OS2008/drnoksnes/ DrNokSnes] - (See [http://wiki.maemo.org/Games#Use_WiiMote_as_Gamepad.2FRemote) Use WiiMote as Gamepad..])
* Old PC (x86, DOS) - [http://maemo.org/packages/view/dosbox/ DOSBox]
* Sega 8 bit consoles - [http://maemo.org/downloads/product/Maemo5/mg/ Mastergear]

Other console emulators are not working 100% yet, but are available for the adventurous:

* [http://maemo.org/downloads/product/OS2008/scummvm/ ScummVM] - Needs porting from n8xx to n900
* GemRB - [http://talk.maemo.org/showthread.php?t=32986 Needs porting from n8xx to n900]
* Frodo C64 - [http://talk.maemo.org/showthread.php...ighlight=Frodo Needs porting from n7xx to n900]
* [[Sdlmame | SDLMAME]] - MAME EMU
* [http://koti.mbnet.fi/tammat/hatari/index.shtml Hatari] - Atari ST(e)/TT/Falcon emu

Some other terminal emulators exist for Linux, but do not work on Maemo:

* [http://maemo.org/downloads/product/OS2008/xgngeo/ Neogeo] - doesn't work but someone could fix it
* Amiga - [http://talk.maemo.org/showthread.php?t=5298&page=4 UAE] has been ported to previous versions of maemo
* Exult - [http://talk.maemo.org/showthread.php?t=5978 The engine for some of the Ultima series has been run on previous versions of maemo]

==Game Controllers and Peripherals==

===WiiMote as Gamepad/Remote===

* [http://talk.maemo.org/showthread.php?t=43050&highlight=wiimote Wiimote] - Use your wiimote to play games! WiiMote can also be used GLOBALLY with your N900

* Configure WiiMote as Gamepad for Dr. NokSnes: http://talk.maemo.org/showthread.php?p=506339
[http://www.youtube.com/watch?v=E0wbLaMXeu4 Video Here]

===Play-station Six Axis Controller===

The Six axis Controller now works on the N900

[http://talk.maemo.org/showthread.php?t=41693 Thread Here]

[http://tomasz.sterna.tv/2010/02/play-games-on-nokia-n900-with-ps3-sixaxis-controller/ Instructions Here]

[http://talk.maemo.org/showpost.php?p=517534&postcount=220 Alternate Windows Instructions Here]

[http://www.youtube.com/watch?v=tON2gO72b1U Video Here]

[http://www.youtube.com/user/OzN900 More Videos Here]

===Wii Balance Board===

[http://www.youtube.com/watch?v=9lMtDv-khKQ N900 and Wii Balance Board Video]

== Frequently asked questions ==

===Will n900 play games from big companies?===

Nokia has publicly stated that they are fully committed to creating a proper channel for Premium content publishers to sell their content in a protected form via their Ovi Store. [http://talk.maemo.org/showthread.php?t=34783]

As for what we have now, well from what Ive researched there are vast repositories of games, both old and some semi new where one can get games for the N900. The very nature of the device is such that the onus is upon the user to do the necessary research to find what will work.

There are numerous emulators where you can play thousands of old games for the NES, Gameboy, GBA, etc.

As for Dos Games, it is yet to be seen if we can expect full compatibility, but rest assured, someone, somewhere is working on it. And probably not in English lol.

Being that it is such a new device, and has yet to achieve anywhere near market penetration, the number of developers working on is still relatively small.

Maemo is a developers dream but give it 6 months before you have precompiled, easy to use games....

My two cents for now. You have the full internet in your pocket! Isn`t that enough?

===What if I want a game not yet available?===
See above (where do I get software from)

===All my previous phones have run java games: why can’t I play them on n900?===
Java is [http://talk.maemo.org/showthread.php?t=37405&highlight=java+works currently available] for the N900 but requires some manual installation.

[[Category:Software]]
[[Category:N900]]
[[Category:Games]]

Games

2010-03-05T13:04:42Z

220.245.168.84: /* Play-station Six Axis Controller */

[[Image:SNES.jpg]]
=N900 Gaming=
The N900 makes a great gaming device. It has a TV Out, Accelerometers, and hardware support for 3D graphics.

[http://www.youtube.com/watch?v=zBzUNe5ov_o&feature=player_embedded Video] showing what can be done with 3D and TV out

There is a range of options to get games on your device.

==Native Games and Games Publishers==
The N900 supports SDL and hardware accelerated 3D OpenGL ES, allowing it to run several linux games. Several are available in the Maemo 5 'extras' repository.

* [http://talk.maemo.org/showthread.php?t=34559 3d graphics engines]
* [http://maemo.org/downloads/Maemo5/games/?org_openpsa_qbpager_org_openpsa_products_product_dba_page=1 Maemo 5 Downloads]
* [http://maemo.org/downloads/OS2008/games/?org_openpsa_qbpager_org_openpsa_products_product_dba_page=1 OS2008 games] - most of these games should be portable to the N900
* [[Chess]] - there are a variety of chess games available, including:
** [[Miniature]] - a networked, community-developed chess program, designed for Maemo - coming soon
* [http://talk.maemo.org/showthread.php?t=31658 Quake3]
* [[uqm | The Ur-Quan Masters (Starcontrol 2)]]

===Rovio===

Rovio have ported the following games to the N900

* Bounce Evolution
* Angry Birds. The Community have also created [http://talk.maemo.org/showthread.php?t=42999&highlight=angry+birds custom level] editor for this great game

Both are available from the Ovi store
[http://store.ovi.com/publisher/RovioMobile/ Ovi Rovio Games]

===SIO2 Interactive===

SIO2 Interactive have ported their Open Source 3D engine to the N900, and have released a number of games.

[http://talk.maemo.org/showthread.php?t=43202 SIO2 Games Thread]

===Secret Exit===

Secret Exit will be release a number of Games for N900

[http://talk.maemo.org/showthread.php?t=42412&highlight=zeemote Secret Exit Game Thread]

==Flash Games==
As the N900 supports Flash 9 and has a hardware keyboard, many flash games should just work. [http://talk.maemo.org/showthread.php?t=34472&highlight=flash+games Read more about the options].

==Games Emulators==

There are [http://talk.maemo.org/showthread.php?t=34526 many emulators] of older game consoles available for Maemo.

* Game boy colour - [http://maemo.org/downloads/product/Maemo5/vgb/ Vgb]
* Game boy advance - [http://maemo.org/downloads/product/Maemo5/vgba/ Vgba]
* Nintendo Entertainment System - [http://maemo.org/downloads/product/Maemo5/ines/ iNES]
* Nintendo SNES - [http://maemo.org/downloads/product/OS2008/drnoksnes/ DrNokSnes] - (See [http://wiki.maemo.org/Games#Use_WiiMote_as_Gamepad.2FRemote) Use WiiMote as Gamepad..])
* Old PC (x86, DOS) - [http://maemo.org/packages/view/dosbox/ DOSBox]
* Sega 8 bit consoles - [http://maemo.org/downloads/product/Maemo5/mg/ Mastergear]

Other console emulators are not working 100% yet, but are available for the adventurous:

* [http://maemo.org/downloads/product/OS2008/scummvm/ ScummVM] - Needs porting from n8xx to n900
* GemRB - [http://talk.maemo.org/showthread.php?t=32986 Needs porting from n8xx to n900]
* Frodo C64 - [http://talk.maemo.org/showthread.php...ighlight=Frodo Needs porting from n7xx to n900]
* [[Sdlmame | SDLMAME]] - MAME EMU
* [http://koti.mbnet.fi/tammat/hatari/index.shtml Hatari] - Atari ST(e)/TT/Falcon emu

Some other terminal emulators exist for Linux, but do not work on Maemo:

* [http://maemo.org/downloads/product/OS2008/xgngeo/ Neogeo] - doesn't work but someone could fix it
* Amiga - [http://talk.maemo.org/showthread.php?t=5298&page=4 UAE] has been ported to previous versions of maemo
* Exult - [http://talk.maemo.org/showthread.php?t=5978 The engine for some of the Ultima series has been run on previous versions of maemo]

==Game Controllers and Peripherals==

===WiiMote as Gamepad/Remote===

* [http://talk.maemo.org/showthread.php?t=43050&highlight=wiimote Wiimote] - Use your wiimote to play games! WiiMote can also be used GLOBALLY with your N900

* Configure WiiMote as Gamepad for Dr. NokSnes: http://talk.maemo.org/showthread.php?p=506339
[http://www.youtube.com/watch?v=E0wbLaMXeu4 Video Here]

===Play-station Six Axis Controller===

The Six axis Controller now works on the N900

[http://talk.maemo.org/showthread.php?t=41693 Thread Here]

[http://tomasz.sterna.tv/2010/02/play-games-on-nokia-n900-with-ps3-sixaxis-controller/ Instructions Here]

[http://talk.maemo.org/showpost.php?p=517534&postcount=220 Alternate Windows Instructions Here]

[http://www.youtube.com/watch?v=tON2gO72b1U Video Here]

===Wii Balance Board===

[http://www.youtube.com/watch?v=9lMtDv-khKQ N900 and Wii Balance Board Video]

== Frequently asked questions ==

===Will n900 play games from big companies?===

Nokia has publicly stated that they are fully committed to creating a proper channel for Premium content publishers to sell their content in a protected form via their Ovi Store. [http://talk.maemo.org/showthread.php?t=34783]

As for what we have now, well from what Ive researched there are vast repositories of games, both old and some semi new where one can get games for the N900. The very nature of the device is such that the onus is upon the user to do the necessary research to find what will work.

There are numerous emulators where you can play thousands of old games for the NES, Gameboy, GBA, etc.

As for Dos Games, it is yet to be seen if we can expect full compatibility, but rest assured, someone, somewhere is working on it. And probably not in English lol.

Being that it is such a new device, and has yet to achieve anywhere near market penetration, the number of developers working on is still relatively small.

Maemo is a developers dream but give it 6 months before you have precompiled, easy to use games....

My two cents for now. You have the full internet in your pocket! Isn`t that enough?

===What if I want a game not yet available?===
See above (where do I get software from)

===All my previous phones have run java games: why can’t I play them on n900?===
Java is [http://talk.maemo.org/showthread.php?t=37405&highlight=java+works currently available] for the N900 but requires some manual installation.

[[Category:Software]]
[[Category:N900]]
[[Category:Games]]

Games

2010-03-05T13:03:59Z

220.245.168.84: /* Play-station Six Axis Controller */

[[Image:SNES.jpg]]
=N900 Gaming=
The N900 makes a great gaming device. It has a TV Out, Accelerometers, and hardware support for 3D graphics.

[http://www.youtube.com/watch?v=zBzUNe5ov_o&feature=player_embedded Video] showing what can be done with 3D and TV out

There is a range of options to get games on your device.

==Native Games and Games Publishers==
The N900 supports SDL and hardware accelerated 3D OpenGL ES, allowing it to run several linux games. Several are available in the Maemo 5 'extras' repository.

* [http://talk.maemo.org/showthread.php?t=34559 3d graphics engines]
* [http://maemo.org/downloads/Maemo5/games/?org_openpsa_qbpager_org_openpsa_products_product_dba_page=1 Maemo 5 Downloads]
* [http://maemo.org/downloads/OS2008/games/?org_openpsa_qbpager_org_openpsa_products_product_dba_page=1 OS2008 games] - most of these games should be portable to the N900
* [[Chess]] - there are a variety of chess games available, including:
** [[Miniature]] - a networked, community-developed chess program, designed for Maemo - coming soon
* [http://talk.maemo.org/showthread.php?t=31658 Quake3]
* [[uqm | The Ur-Quan Masters (Starcontrol 2)]]

===Rovio===

Rovio have ported the following games to the N900

* Bounce Evolution
* Angry Birds. The Community have also created [http://talk.maemo.org/showthread.php?t=42999&highlight=angry+birds custom level] editor for this great game

Both are available from the Ovi store
[http://store.ovi.com/publisher/RovioMobile/ Ovi Rovio Games]

===SIO2 Interactive===

SIO2 Interactive have ported their Open Source 3D engine to the N900, and have released a number of games.

[http://talk.maemo.org/showthread.php?t=43202 SIO2 Games Thread]

===Secret Exit===

Secret Exit will be release a number of Games for N900

[http://talk.maemo.org/showthread.php?t=42412&highlight=zeemote Secret Exit Game Thread]

==Flash Games==
As the N900 supports Flash 9 and has a hardware keyboard, many flash games should just work. [http://talk.maemo.org/showthread.php?t=34472&highlight=flash+games Read more about the options].

==Games Emulators==

There are [http://talk.maemo.org/showthread.php?t=34526 many emulators] of older game consoles available for Maemo.

* Game boy colour - [http://maemo.org/downloads/product/Maemo5/vgb/ Vgb]
* Game boy advance - [http://maemo.org/downloads/product/Maemo5/vgba/ Vgba]
* Nintendo Entertainment System - [http://maemo.org/downloads/product/Maemo5/ines/ iNES]
* Nintendo SNES - [http://maemo.org/downloads/product/OS2008/drnoksnes/ DrNokSnes] - (See [http://wiki.maemo.org/Games#Use_WiiMote_as_Gamepad.2FRemote) Use WiiMote as Gamepad..])
* Old PC (x86, DOS) - [http://maemo.org/packages/view/dosbox/ DOSBox]
* Sega 8 bit consoles - [http://maemo.org/downloads/product/Maemo5/mg/ Mastergear]

Other console emulators are not working 100% yet, but are available for the adventurous:

* [http://maemo.org/downloads/product/OS2008/scummvm/ ScummVM] - Needs porting from n8xx to n900
* GemRB - [http://talk.maemo.org/showthread.php?t=32986 Needs porting from n8xx to n900]
* Frodo C64 - [http://talk.maemo.org/showthread.php...ighlight=Frodo Needs porting from n7xx to n900]
* [[Sdlmame | SDLMAME]] - MAME EMU
* [http://koti.mbnet.fi/tammat/hatari/index.shtml Hatari] - Atari ST(e)/TT/Falcon emu

Some other terminal emulators exist for Linux, but do not work on Maemo:

* [http://maemo.org/downloads/product/OS2008/xgngeo/ Neogeo] - doesn't work but someone could fix it
* Amiga - [http://talk.maemo.org/showthread.php?t=5298&page=4 UAE] has been ported to previous versions of maemo
* Exult - [http://talk.maemo.org/showthread.php?t=5978 The engine for some of the Ultima series has been run on previous versions of maemo]

==Game Controllers and Peripherals==

===WiiMote as Gamepad/Remote===

* [http://talk.maemo.org/showthread.php?t=43050&highlight=wiimote Wiimote] - Use your wiimote to play games! WiiMote can also be used GLOBALLY with your N900

* Configure WiiMote as Gamepad for Dr. NokSnes: http://talk.maemo.org/showthread.php?p=506339
[http://www.youtube.com/watch?v=E0wbLaMXeu4 Video Here]

===Play-station Six Axis Controller===

The Six axis Controller now works on the N900

[http://talk.maemo.org/showthread.php?t=41693 Thread Here]
[http://tomasz.sterna.tv/2010/02/play-games-on-nokia-n900-with-ps3-sixaxis-controller/ Instructions Here]
[http://talk.maemo.org/showpost.php?p=517534&postcount=220 Alternate Windows Instructions Here]

[http://www.youtube.com/watch?v=tON2gO72b1U SixAxis Video Here]

===Wii Balance Board===

[http://www.youtube.com/watch?v=9lMtDv-khKQ N900 and Wii Balance Board Video]

== Frequently asked questions ==

===Will n900 play games from big companies?===

Nokia has publicly stated that they are fully committed to creating a proper channel for Premium content publishers to sell their content in a protected form via their Ovi Store. [http://talk.maemo.org/showthread.php?t=34783]

As for what we have now, well from what Ive researched there are vast repositories of games, both old and some semi new where one can get games for the N900. The very nature of the device is such that the onus is upon the user to do the necessary research to find what will work.

There are numerous emulators where you can play thousands of old games for the NES, Gameboy, GBA, etc.

As for Dos Games, it is yet to be seen if we can expect full compatibility, but rest assured, someone, somewhere is working on it. And probably not in English lol.

Being that it is such a new device, and has yet to achieve anywhere near market penetration, the number of developers working on is still relatively small.

Maemo is a developers dream but give it 6 months before you have precompiled, easy to use games....

My two cents for now. You have the full internet in your pocket! Isn`t that enough?

===What if I want a game not yet available?===
See above (where do I get software from)

===All my previous phones have run java games: why can’t I play them on n900?===
Java is [http://talk.maemo.org/showthread.php?t=37405&highlight=java+works currently available] for the N900 but requires some manual installation.

[[Category:Software]]
[[Category:N900]]
[[Category:Games]]

LED patterns

2010-02-26T03:02:09Z

220.245.168.84: /* File Location */

== N800 ==

The N800 has a single-colour (blue) LED behind the dpad.

== N810 ==

The N810 has an RGB LED.

== N900 ==

=== File Location ===

The file defining patterns can be found in
/etc/mce/mce.ini

An application ([http://talk.maemo.org/showthread.php?t=27818 mcedit]) for modifying LED patterns was written for the n8x0, but this will not work with the n900 due to the new mce.ini format.

An app to edit LED patterns on the N900 has just been released: "LED Pattern Editor"

=== Pattern Format ===
The patterns are broken down as follows:

:<tt>PatternName=Priority;ScreenOn;Timeout;LEDsToMap;Engine1Pattern;Engine2Pattern</tt>

==== Priority ====

0-255, 0 is highest, 255 is lowest.

Since currently only a single pattern at a time can be displayed, this is used to assign importance to the LED patterns. Although only a single LED pattern can be displayed at any time, multiple patterns may be active, the pattern with the highest priority being displayed.

A common example of this is where the n900 is on charge, the battery is full (starting PatternBatteryFull with a priority of 40), and an SMS message is received (PatternCommunicationSMS with a priority of 30). On receipt of the SMS, the LED begins to display the flashing blue led of an SMS. Once that SMS has been dismissed, the green LED of the full battery notification is again displayed.

==== ScreenOn ====

* 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 ====

This is the time-out of the LED pattern in seconds. 0 for infinite, i.e. until the notification is dismissed.

If this is set to 20, the pattern will display for 20 seconds, and then stop.

==== LEDsToMap ====

There are two engines that can be used to make custom LED patterns.<ref name="engines">Actually there are three, but the third engine is used exclusively for the keyboard LED.</ref>

r, g, or b maps the corresponding colour channel to Engine 1.

R, G, or B maps the corresponding colour channel to Engine 2.

For example, "rG" maps the red channel to Engine 1, and the green channel to Engine 2.

You should avoid mapping the same channel to both engines, for example "rR", "gG" or "bB"

==== Engine Pattern ====

This is a series of text that describes the speed and intensity of changes in the LED(s) beign managed by that particular engine. See below for a breakdown of the patterns. Each can be at most 16 commands long.

=== Lysti Format Engine Patterns and Commands ===

The LED patterns are of the form
:<tt>9d8040007f007f0040ff7f007f000000</tt>

Breaking this down for ease of reading we get a list of 8 commands, each of which is four characters long.
:<tt>9d80 4000 7f00 7f00 40ff 7f00 7f00 0000</tt>

==== 9d80 - Refresh Engine Multiplexor ====

This is to be used as the first command of every pattern). If this is excluded from the pattern, the led won't flash.

==== 40xx - Set channel brightness ====

Where xx are two hexadecimal digits, e.g. 00 (for a brightness of 0) or ff (for a brightness of 255).

==== xxyy - Adjust channel brightness ====

Increment or decrement the channel brightness over a period of time (xx) and a number of steps (yy).

Where xx and yy are hexadecimal digits

xx - Time (per step?)

yy - Number of steps

The following rules apply to these:
* If xx is even, the steps are increment steps and brightness will increase.
* If xx is odd, the steps are decrement steps and brightness will decrease.
* If xx is between 02 and 3f, a short step time is used (granularity 0.49ms)
* If xx is between 42 and 7f, a long step time is used (granularity 15.6ms)
* yy can be any value between 00 and ff (0 to 255)
* Pauses can be achieved by using 00 steps, e.g. 7f00 where, where the 7f is how long each step takes and 00 is how many increment steps to take.

The mce.ini instructions (/etc/mce/mce.ini) also state that
:Two consecutive increment/decrement sequences are needed to cover the entire range from 0-255
However I believe this is a throwback to the older patterns, and the full range of 00 to ff is available in a single step for the number of steps, since whether these are increment or decrement steps are now handled through use of even or odd xx values.

==== 0000 - Jump to start ====

Jump to the start of the pattern for this channel. You will see this at the end of most repeating patterns.

This command may not actually be needed to make the pattern repeat. If this is removed, the pattern will repeat anyway, although it's useful to have it there as an explicit command to repeat for clarity. If you wanted a pattern to run once and then terminate you would use the c000 command.

==== A000 .. BFFF - Branch ====

101<llllll><sssssss> : 16bit

llllll : 6bit; Loop count, 0=infinite loop, max 63 loops

sssssss : 7 bit; Step number; Value to store to PC (0-95 actual progspace of LP5523 of 96 16bit commands. [Unclear if that's absolute address, or probably offset to start of program space assigned to the particular engine])

==== c000 - End pattern execution ====

(also d000 = with hw INT; c800/d800 = with PC reset. INT might serve to signal end-of-pattern to main CPU ->*)

The pattern is terminated without repeating. It is important to note here that although that pattern has stopped, it is still active *) until the Timeout time has passed. As a consequence of this any higher priority patterns (patterns with a lower priority value, since 0 is the highest and 255 is the lowest) will not be displayed until the pattern has fully expired. In the case that the timeout is 0, it will not display until the notification is dismissed.

==== Sending and receiving engine triggers ====

Further complexity in patterns can be added through use of triggers. This is especially useful if we want to synchronise the two engines in time, for example to wait until the LED has turned red before turning it immediately to green. Rather than waste time with steps doing nothing, we can simply wait for a trigger to be received from the other engine.

The following pattern does exactly that:
:<tt>PatternTest=29;1;0;rG;9d80400008ffe0044000c000;9d80e08040ffc000</tt>

===== e002, e004, e008 - Send engine trigger =====

e002 - Send trigger to engine 1

e004 - Send trigger to engine 2

e008 - Send trigger to engine 3 (used by keyboard backlight)

A signal is sent from the current engine to signal another engine.

Although the trigger information for engine 3 is listed we have no control over the keyboard LED, so it has no effect. Attempting to add a pattern for engine 3 after the pattern for engine 2 causes the pattern to no longer function.

===== e080, e100, e200 - Wait for engine trigger =====

e080 - Wait for trigger from engine 1

e100 - Wait for trigger from engine 2

e200 - Wait for trigger from engine 3 (used by keyboard backlight)

Although the trigger information for engine 3 is listed we have no control over the keyboard LED, so it has no effect. Attempting to add a pattern for engine 3 after the pattern for engine 2 causes the pattern to no longer function.

=== Default LED Patterns for Nokia N900 ===

PatternError=0;5;0;r;9d8040007f007f0040ff7f007f000000;9d800000
PatternDeviceOn=254;0;0;rgb;9d804000422043207f100000;9d800000
PatternDeviceSoftOff=253;0;0;rg;9d804000423f433f7f100000;9d800000
PatternPowerOn=9;3;0;rgb;9d80400042ff02ffc000;9d800000
PatternPowerOff=10;3;0;rgb;9d80400001ff43ff7f007f00c000;9d800000
PatternCommunicationCall=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommunicationIM=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommunicationSMS=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommunicationEmail=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommonNotification=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternWebcamActive=20;1;0;r;9d80400004ffc0000000;9d800000
PatternBatteryCharging=50;4;0;rg;9d804000427f0d7f7f007f0042000000;9d800000
PatternBatteryFull=40;4;0;g;9d80407f0000;9d800000

=== Community-Made Patterns ===
''Please note that these patterns should all be on one line.''
''They can also be used for any notification.''

A traffic-light battery charging pattern, courtesy of [http://talk.maemo.org/showthread.php?p=512430#post512430 blue_led]
PatternBatteryCharging=50;4;0;Rg;9d80407f7f00e0047f0040007f007f007f00407f7f00e0047f007f000000;9d804000e080407fe0800000

A police-siren style pattern, idea by [http://talk.maemo.org/showthread.php?p=499305#post499305 mihapodb]. This pattern cuts quickly between blue and red.
PatternCommunicationEmail=30;1;0;rB;9d8040ff7f00e00440007f000000;9d80e08040ff7f0040000000

A police-siren style pattern, idea by [http://talk.maemo.org/showthread.php?p=540959#post540959 villo]. This pattern fades between red and blue.
PatternCommunicationEmail=30;1;0;rB;9d8004ff05ffe004e1000000;9d80e08004ff05ffe0020000

Cehteh's patterns with some comments

Slow dark glowing in cyan, never goes fully off, so you can locate the device in the dark:
PatternDeviceOn=254;0;0;gb;9d804001620863087f007f007f007f007f007f007f007f007f007f007f000000;9d800000

Slow dark glowing in yellow, never goes fully off, so you can locate the device in the dark:
PatternBatteryCharging=50;3;0;rg;9d804001427f0d7f7f007f0042000000;9d800000

Slow dark glowing in white, never goes fully off, so you can locate the device in the dark:
PatternBatteryFull=40;3;0;rgb;9d804001620863087f007f007f007f007f007f007f007f007f007f007f000000;9d800000

White, bright flashing (must be enabled in 'LEDPatterns=' ?):
PatternExample=42;1;30;rgb;9d8040007f007f0040ff42000000;9d800000

=== 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 (nano, vim, leafpad...)
* 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

Please note: restarting mce several times in 2 minutes will cause the n900 to think there is a problem with mce, and not restart it. The initctl program will inform you of this. When it does, simply wait a while before trying again.

=== Low Level ===

The N900 has a LP5521<ref name="lp5521-spec">http://www.national.com/pf/LP/LP5521.html</ref> <ref name="lp5521-driver">http://mxr.maemo.org/fremantle/source/kernel/drivers/i2c/chips/lp5521.c</ref> programmable three channel controller LED Driver which handles the leds.
(actually it has a LP5523 it seems <ref name="lp5523-spec">http://www.national.com/pf/LP/LP5523.html</ref> <ref name="leds-lp5523-driver">http://mxr.maemo.org/fremantle/source/kernel/drivers/leds/leds-lp5523.c</ref>, which has 3 engines like LP5521 but can drive 9 LEDs via a multiplexer)

The controller can be programmed via "/sys/class/i2c-adapter/i2c-2/2-0032" (FIXME: is this stable?). In that directory there are three files corresponding to the three channels: engine1_mode, engine2_mode and engine3_mode. Each file "stores" one of "run", "load", "disabled" (it seems that there is another mode "direct" but it doesn't work):
* run: The program runs
* disabled: The channel is disabled - not running
* load: In that state, there are two more files in that directory:
** engine1_leds is in the form "0000rgb00" (9 digits, "1" or "0"), where rgb control which leds should participate. The 6 "0" in the above pattern correspond to the 6 kbd white leds controlled by mce via engine3, so readout of engine3_leds gives 111100011 ;-)
** engine1_load accepts a string as specified above (e.g. 9d804000427f0d7f7f007f0042000000). LP5523 has an absolute storage of 96 steps a 16bits, which can dynamically partitioned between the three engines. (ToDo: check if driver supports >16 instructions / machine)
After that, when the state is changed to "run", the program will be ran by the controller.

In order for the leds to work, the led_current of the appropriate leds need to be set to non-zero values. This is accomplished by writing to files leds:lp5523:[bgr]/led_current under the same directory. Perhaps (?) not or values are suitable.

NOTE: There must be a delay (how much? The specs of LP5521 mentions it) between writes to sysfs files.

{{Reflist}}

[[Category:N900 Hardware]]
[[Category:Power users]]

LED patterns

2010-02-25T09:40:21Z

220.245.168.84: /* Community-Made Patterns */

== N800 ==

The N800 has a single-colour (blue) LED behind the dpad.

== N810 ==

The N810 has an RGB LED.

== N900 ==

=== File Location ===

The file defining patterns can be found in
/etc/mce/mce.ini

An application ([http://talk.maemo.org/showthread.php?t=27818 mcedit]) for modifying LED patterns was written for the n8x0, but this will not work with the n900 due to the new mce.ini format.

=== Pattern Format ===
The patterns are broken down as follows:

:<tt>PatternName=Priority;ScreenOn;Timeout;LEDsToMap;Engine1Pattern;Engine2Pattern</tt>

==== Priority ====

0-255, 0 is highest, 255 is lowest.

Since currently only a single pattern at a time can be displayed, this is used to assign importance to the LED patterns. Although only a single LED pattern can be displayed at any time, multiple patterns may be active, the pattern with the highest priority being displayed.

A common example of this is where the n900 is on charge, the battery is full (starting PatternBatteryFull with a priority of 40), and an SMS message is received (PatternCommunicationSMS with a priority of 30). On receipt of the SMS, the LED begins to display the flashing blue led of an SMS. Once that SMS has been dismissed, the green LED of the full battery notification is again displayed.

==== ScreenOn ====

* 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 ====

This is the time-out of the LED pattern in seconds. 0 for infinite, i.e. until the notification is dismissed.

If this is set to 20, the pattern will display for 20 seconds, and then stop.

==== LEDsToMap ====

There are two engines that can be used to make custom LED patterns.<ref name="engines">Actually there are three, but the third engine is used exclusively for the keyboard LED.</ref>

r, g, or b maps the corresponding colour channel to Engine 1.

R, G, or B maps the corresponding colour channel to Engine 2.

For example, "rG" maps the red channel to Engine 1, and the green channel to Engine 2.

You should avoid mapping the same channel to both engines, for example "rR", "gG" or "bB"

==== Engine Pattern ====

This is a series of text that describes the speed and intensity of changes in the LED(s) beign managed by that particular engine. See below for a breakdown of the patterns. Each can be at most 16 commands long.

=== Lysti Format Engine Patterns and Commands ===

The LED patterns are of the form
:<tt>9d8040007f007f0040ff7f007f000000</tt>

Breaking this down for ease of reading we get a list of 8 commands, each of which is four characters long.
:<tt>9d80 4000 7f00 7f00 40ff 7f00 7f00 0000</tt>

==== 9d80 - Refresh Engine Multiplexor ====

This is to be used as the first command of every pattern). If this is excluded from the pattern, the led won't flash.

==== 40xx - Set channel brightness ====

Where xx are two hexadecimal digits, e.g. 00 (for a brightness of 0) or ff (for a brightness of 255).

==== xxyy - Adjust channel brightness ====

Increment or decrement the channel brightness over a period of time (xx) and a number of steps (yy).

Where xx and yy are hexadecimal digits

xx - Time (per step?)

yy - Number of steps

The following rules apply to these:
* If xx is even, the steps are increment steps and brightness will increase.
* If xx is odd, the steps are decrement steps and brightness will decrease.
* If xx is between 02 and 3f, a short step time is used (granularity 0.49ms)
* If xx is between 42 and 7f, a long step time is used (granularity 15.6ms)
* yy can be any value between 00 and ff (0 to 255)
* Pauses can be achieved by using 00 steps, e.g. 7f00 where, where the 7f is how long each step takes and 00 is how many increment steps to take.

The mce.ini instructions (/etc/mce/mce.ini) also state that
:Two consecutive increment/decrement sequences are needed to cover the entire range from 0-255
However I believe this is a throwback to the older patterns, and the full range of 00 to ff is available in a single step for the number of steps, since whether these are increment or decrement steps are now handled through use of even or odd xx values.

==== 0000 - Jump to start ====

Jump to the start of the pattern for this channel. You will see this at the end of most repeating patterns.

This command may not actually be needed to make the pattern repeat. If this is removed, the pattern will repeat anyway, although it's useful to have it there as an explicit command to repeat for clarity. If you wanted a pattern to run once and then terminate you would use the c000 command.

==== A000 .. BFFF - Branch ====

101<llllll><sssssss> : 16bit

llllll : 6bit; Loop count, 0=infinite loop, max 63 loops

sssssss : 7 bit; Step number; Value to store to PC (0-95 actual progspace of LP5523 of 96 16bit commands. [Unclear if that's absolute address, or probably offset to start of program space assigned to the particular engine])

==== c000 - End pattern execution ====

(also d000 = with hw INT; c800/d800 = with PC reset. INT might serve to signal end-of-pattern to main CPU ->*)

The pattern is terminated without repeating. It is important to note here that although that pattern has stopped, it is still active *) until the Timeout time has passed. As a consequence of this any higher priority patterns (patterns with a lower priority value, since 0 is the highest and 255 is the lowest) will not be displayed until the pattern has fully expired. In the case that the timeout is 0, it will not display until the notification is dismissed.

==== Sending and receiving engine triggers ====

Further complexity in patterns can be added through use of triggers. This is especially useful if we want to synchronise the two engines in time, for example to wait until the LED has turned red before turning it immediately to green. Rather than waste time with steps doing nothing, we can simply wait for a trigger to be received from the other engine.

The following pattern does exactly that:
:<tt>PatternTest=29;1;0;rG;9d80400008ffe0044000c000;9d80e08040ffc000</tt>

===== e002, e004, e008 - Send engine trigger =====

e002 - Send trigger to engine 1

e004 - Send trigger to engine 2

e008 - Send trigger to engine 3 (used by keyboard backlight)

A signal is sent from the current engine to signal another engine.

Although the trigger information for engine 3 is listed we have no control over the keyboard LED, so it has no effect. Attempting to add a pattern for engine 3 after the pattern for engine 2 causes the pattern to no longer function.

===== e080, e100, e200 - Wait for engine trigger =====

e080 - Wait for trigger from engine 1

e100 - Wait for trigger from engine 2

e200 - Wait for trigger from engine 3 (used by keyboard backlight)

Although the trigger information for engine 3 is listed we have no control over the keyboard LED, so it has no effect. Attempting to add a pattern for engine 3 after the pattern for engine 2 causes the pattern to no longer function.

=== Default LED Patterns for Nokia N900 ===

PatternError=0;5;0;r;9d8040007f007f0040ff7f007f000000;9d800000
PatternDeviceOn=254;0;0;rgb;9d804000422043207f100000;9d800000
PatternDeviceSoftOff=253;0;0;rg;9d804000423f433f7f100000;9d800000
PatternPowerOn=9;3;0;rgb;9d80400042ff02ffc000;9d800000
PatternPowerOff=10;3;0;rgb;9d80400001ff43ff7f007f00c000;9d800000
PatternCommunicationCall=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommunicationIM=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommunicationSMS=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommunicationEmail=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternCommonNotification=30;1;0;b;9d80400002ff03ff02ff03ff71080000;9d800000
PatternWebcamActive=20;1;0;r;9d80400004ffc0000000;9d800000
PatternBatteryCharging=50;4;0;rg;9d804000427f0d7f7f007f0042000000;9d800000
PatternBatteryFull=40;4;0;g;9d80407f0000;9d800000

=== Community-Made Patterns ===
''Please note that these patterns should all be on one line.''
''They can also be used for any notification.''

A traffic-light battery charging pattern, courtesy of [http://talk.maemo.org/showthread.php?p=512430#post512430 blue_led]
PatternBatteryCharging=50;4;0;Rg;9d80407f7f00e0047f0040007f007f007f00407f7f00e0047f007f000000;9d804000e080407fe0800000

A police-siren style pattern, idea by [http://talk.maemo.org/showthread.php?p=499305#post499305 mihapodb]. This pattern cuts quickly between blue and red.
PatternCommunicationEmail=30;1;0;rB;9d8040ff7f00e00440007f000000;9d80e08040ff7f0040000000

A police-siren style pattern, idea by [http://talk.maemo.org/showthread.php?p=540959#post540959 villo]. This pattern fades between red and blue.
PatternCommunicationEmail=30;1;0;rB;9d8004ff05ffe004e1000000;9d80e08004ff05ffe0020000

Cehteh's patterns with some comments

Slow dark glowing in cyan, never goes fully off, so you can locate the device in the dark:
PatternDeviceOn=254;0;0;gb;9d804001620863087f007f007f007f007f007f007f007f007f007f007f000000;9d800000

Slow dark glowing in yellow, never goes fully off, so you can locate the device in the dark:
PatternBatteryCharging=50;3;0;rg;9d804001427f0d7f7f007f0042000000;9d800000

Slow dark glowing in white, never goes fully off, so you can locate the device in the dark:
PatternBatteryFull=40;3;0;rgb;9d804001620863087f007f007f007f007f007f007f007f007f007f007f000000;9d800000

White, bright flashing (must be enabled in 'LEDPatterns=' ?):
PatternExample=42;1;30;rgb;9d8040007f007f0040ff42000000;9d800000

=== 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 (nano, vim, leafpad...)
* 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

Please note: restarting mce several times in 2 minutes will cause the n900 to think there is a problem with mce, and not restart it. The initctl program will inform you of this. When it does, simply wait a while before trying again.

=== Low Level ===

The N900 has a LP5521<ref name="lp5521-spec">http://www.national.com/pf/LP/LP5521.html</ref> <ref name="lp5521-driver">http://mxr.maemo.org/fremantle/source/kernel/drivers/i2c/chips/lp5521.c</ref> programmable three channel controller LED Driver which handles the leds.
(actually it has a LP5523 it seems <ref name="lp5523-spec">http://www.national.com/pf/LP/LP5523.html</ref> <ref name="leds-lp5523-driver">http://mxr.maemo.org/fremantle/source/kernel/drivers/leds/leds-lp5523.c</ref>, which has 3 engines like LP5521 but can drive 9 LEDs via a multiplexer)

The controller can be programmed via "/sys/class/i2c-adapter/i2c-2/2-0032" (FIXME: is this stable?). In that directory there are three files corresponding to the three channels: engine1_mode, engine2_mode and engine3_mode. Each file "stores" one of "run", "load", "disabled" (it seems that there is another mode "direct" but it doesn't work):
* run: The program runs
* disabled: The channel is disabled - not running
* load: In that state, there are two more files in that directory:
** engine1_leds is in the form "0000rgb00" (9 digits, "1" or "0"), where rgb control which leds should participate. The 6 "0" in the above pattern correspond to the 6 kbd white leds controlled by mce via engine3, so readout of engine3_leds gives 111100011 ;-)
** engine1_load accepts a string as specified above (e.g. 9d804000427f0d7f7f007f0042000000). LP5523 has an absolute storage of 96 steps a 16bits, which can dynamically partitioned between the three engines. (ToDo: check if driver supports >16 instructions / machine)
After that, when the state is changed to "run", the program will be ran by the controller.

In order for the leds to work, the led_current of the appropriate leds need to be set to non-zero values. This is accomplished by writing to files leds:lp5523:[bgr]/led_current under the same directory. Perhaps (?) not or values are suitable.

NOTE: There must be a delay (how much? The specs of LP5521 mentions it) between writes to sysfs files.

{{Reflist}}

[[Category:N900 Hardware]]
[[Category:Power users]]