Sign Up
Log In
Log In
or
Sign Up
Places
All Projects
Status Monitor
Collapse sidebar
DISCONTINUED:openSUSE:11.1:Update
fnfx
overview.html
Overview
Repositories
Revisions
Requests
Users
Attributes
Meta
File overview.html of Package fnfx
<html> <head> <title>FnFX :: Toshiba Fn-Keys/Hotkeys & Linux</title> <meta http-equiv="expires" content="900"> <meta name="keywords" content="FnFX, Linux, Toshiba, Laptop, Portege, Satellite, Fn, Fn-Keys, Keys, Hotkey, Hotkeys"> </head> <style type="text/css"> body,td {FONT-SIZE: 10pt; COLOR: #444444; FONT-FAMILY: verdana;} .mini {FONT-SIZE: 10px; COLOR: #999999; FONT-FAMILY: verdana; TEXT-DECORATION: underline;} A.mini {FONT-SIZE: 10px; COLOR: #999999; FONT-FAMILY: verdana; TEXT-DECORATION: underline;} A.mini:visited {FONT-SIZE: 10px; COLOR: #999999; FONT-FAMILY: verdana; TEXT-DECORATION: underline;} A.mini:hover {TEXT-DECORATION: underline;} A.mini:hover {TEXT-DECORATION: underline;} A {TEXT-DECORATION: underline;} .dottedtop {border: 1pt solid black; margin-top: 2pt;margin-bottom: 2pt;FONT-SIZE: 11px; COLOR: #444444; FONT-FAMILY: arial; background: #FFFFFF; padding-right:5pt; padding-left:5pt; padding-top:0pt; padding-bottom: 0pt; text-align:left;} .dotted {border: 1pt solid black; margin-left: 2pt;margin-right: 2pt;margin-top: 2pt;margin-bottom: 2pt;FONT-SIZE: 11px; COLOR: #444444; FONT-FAMILY: arial; background: #FFFFFF; padding-right:5pt; padding-left:5pt; padding-top:0pt; padding-bottom: 0pt; text-align:left;} .dottedbot {border: 1pt solid black; margin-left: 2pt;margin-right: 2pt;margin-top: 0pt;margin-bottom: 2pt;FONT-SIZE: 11px; COLOR: #444444; FONT-FAMILY: arial; background: #FFFFFF; padding-right:5pt; padding-left:5pt; padding-top:2pt; padding-bottom: 3pt; text-align:left;} .table {border: 1pt solid white; margin-left: 2pt;margin-right: 2pt;margin-top: 2pt;margin-bottom: 2pt;FONT-SIZE: 11px; COLOR: #444444; FONT-FAMILY: verdana; background: #f0f0f0; padding-right:3pt; padding-left:3pt; padding-top:2pt; padding-bottom:pt; text-align:left;} .smile {border: 0pt solid white; margin-left: 0pt;margin-right: 0pt;margin-top: 0pt;margin-bottom: 0pt; padding-right:0pt; padding-left:0pt; padding-top:0pt; padding-bottom:0pt; text-align:left;} .content {border: 1pt solid black; margin-left: 2pt;margin-right: 2pt;margin-top: 2pt;margin-bottom: 2pt;FONT-SIZE: 11px; COLOR: #444444; FONT-FAMILY: verdana, arial; background: #f0f0f0; padding-right:5pt; padding-left:5pt; padding-top:5pt; padding-bottom:pt; text-align:left;} .menu {margin-left: 2pt;margin-right: 2pt;margin-top: 2pt;margin-bottom: 2pt;FONT-SIZE: 11px; COLOR: #444444; FONT-FAMILY: arial; padding-left:5pt; padding-right:5pt; padding-top:0pt; padding-bottom: 0pt; text-align:left; } </style> <body bgcolor="#909CA3" link="#444444" alink="#444444" vlink="#444444" text="#444444" marginheight="0" marginwidth="0" topmargin="0" leftmargin="0" bgproperties="fixed"> <center> <table class=dottedtop border=0 cellspacing=0 cellpadding=0 width=770> <tr><td class=menu background=g/fnfx.png width=190 height=63></td><td class=menu background=g/fnfxbg.png width=150><a href=index.php?section=news><center><u>Home</u></center></a></td><td class=menu background=g/fnfxbg.png width=150><a href=index.php?section=files><center><u>Files</u></center></a></td><td class=menu background=g/fnfxbg.png width=150><a href=index.php?section=doc><center><u>Documentation</u></center></a></td><td class=menu background=g/fnfxbg.png width=150><a href=forum/index.php><center>Forum</center></a><td class=menu background=g/fnfxbg.png><td class=menu background=g/fnfxbg.png width=150><a href=index.php?section=about><center><u>About</u></center></a><td class=menu background=g/fnfxbg.png></td></td></td> </tr> </table> </center> <center> <table border=0 width=774 cellpadding=0 cellspacing=0> <tr> <td> <table border=0 width=100%> <tr> <td class=dottedbot width=100%> Quicklinks: <a href=?section=doc#models>Supported Laptops</a> || <a href=?section=doc#swreq>Kernel Requirements</a> || <a href=?section=files>Download Source and Packages</a> </td> </tr> </table> </td> </tr> </table> </center> <center> <table border=0 width=774 cellpadding=0 cellspacing=0> <tr> <td> <table border=0 width=100%> <tr> <td valign=top class=content> <u>Documentation</u><br><br> <a href=#fnfx> <b>1. FnFX</b><br><br> </a> <a href=#req> <b>2. Requirements</b><br> </a> <a href=#hwreq> <b>2.1 Hardware Requirements</b><br> </a> <a href=#swreq> <b>2.2 Software Requirements</b><br><br> </a> <a href=#info> <b>3. General Information</b><br> </a> <a href=#concept> <b>3.1 FnFX Concept</b><br> </a> <a href=#models> <b>3.2 Verified Toshiba Models</b><br><br> </a> <a href=#functions> <b>4. Functions</b><br> </a> <a href=#daemon> <b>4.1 Daemon Functions</b><br> </a> <a href=#client> <b>4.2 Client Functions</b><br><br> </a> <a href=#install> <b>5. Installation</b><br> </a> <a href=#compile> <b>5.1 Compilation</b><br> </a> <a href=#dconf> <b>5.2 Daemon Configuration</b><br> </a> <a href=#cconf> <b>5.3 Client Configuration</b><br> </a> <a href=#confex> <b>5.4 Configuration Examples</b><br><br> </a> <a href=#todo> <b>6. To-do</b><br><br> </a> <a href=#license> <b>7. License</b><br><br> </a> <a href=#contact> <b>8. Contact</b><br><br> </a> <a href=#thanks> <b>9. Thanks</b><br><br> <a href=#ref> <b>10. References</b><br><br> </a> <hr> <a name="fnfx"> <b>1. FnFX</b><br><br> </a> FnFX enables owners of Toshiba laptops to change the LCD brightness, control, the internal fan and use the special keys on their keyboard (Fn-x combinations, hot-keys). The internal functions will give the possibility to map the Fn-Keys to functions like volume up/down, mute, suspend to disk, suspend to ram and switch LCD/CRT/TV-out. These functions heavily depend on the system and/or kernel configuration. You will need at least a kernel (v2.4.x, v2.5.x, v2.6.x) with ACPI and Toshiba support (CONFIG_ACPI and CONFIG_ACPI_TOSHIBA). <br><br><br<br> <a name="req"> <b>2. Requirements</b><br><br> </a> <a name="hwreq"> <b>2.1 Hardware Requirements</b><br><br> </a> Any recent Toshiba model. Recent means: Every Toshiba laptop built in 2002 and later will work with FnFX. A list with verified and tested Toshiba laptops is found under 3.2. <br><br> <a name="swreq"> <b>2.2 Software Requirements</b><br><br> </a> - Linux v2.4.x <br> - Linux v2.5.x <br> - Linux v2.6.x <br><br> All Linux v2.4.x kernels will need ACPI patches. All 'major' distributions already roll out v2.4.x kernels with these patches. To make it short: At least CONFIG_ACPI and CONFIG_ACPI_TOSHIBA must be defined in the kernel config. More information on ACPI and Linux can be found under [1]. <br><br> All v2.5.x and v2.6.x kernels already have the required ACPI drivers. Again: ACPI must be enabled. CONFIG_ACPI and CONFIG_ACPI_TOSHIBA are your friends. <br><br> To check if ACPI and ACPI Toshiba support are enabled check the following proc entries exists: <br><br> /proc/acpi<br> /proc/acpi/toshiba <br><br> If they do exist, FnFX will work on that system. If they do not exist try `modprobe toshiba_acpi' as root. If this throws errors like 'FATAL: Module toshiba_acpi not found' the kernel is most likely not compiled with CONFIG_ACPI and CONFIG_ACPI_TOSHIBA. <br><br> Please recompile your kernel with the ACPI drivers or have a look for a precompiled kernel for your distribution which has ACPI and ACPI Toshiba support. <br><br><br><br> <a name="info"> <b>3. General Information</b><br><br> </a> <a name="concept"> <b>3.1 FnFX Concept</b><br><br> </a> FnFX consists of two programs: The daemon `fnfxd` and the client `fnfx`. Fnfxd has to be run as root. While running without fnfx, the daemon reacts on Fn-x combinations and hot-keys which are defined in `/etc/fnfx/fnfxd.conf' ('/usr/local/etc/fnfx/fnfxd.conf'). If a instance of fnfx is running, the received Fn-x/hot key events are passed to the client which reads its configuration from '~/.fnfxrc'. While fnfxd only executes internal commands, fnfx can also start arbitrary programs. <br><br> If you only want to use the internal commands (changing LCD brightness...), there is no need to run the client fnfx. On the other side, if you really want to map the Fn-x combinations/hot-keys to launch programs, you will need to configure and start both -- the server and client. <br><br> <a name="models"> <b>3.2 Verified Toshiba Models</b><br><br> </a> The following Toshiba laptops have been tested by FnFX users. Note: every new Toshiba laptop really should work just fine with FnFX. <br><br> - Toshiba Libretto L5W<br> - Toshiba Portege 2000<br> - Toshiba Portege 2010<br> - Toshiba Portege R100<br> - Toshiba Satellite 1410-604<br> - Toshiba Satellite 2410-303<br> - Toshiba Satellite 2450-401<br> - Toshiba Satellite 5205<br> - Toshiba Satellite 5100-201<br> - Toshiba Satellite 5200-801<br> - Toshiba Satellite 5205<br> - Toshiba Satellite A10-S203<br> - Toshiba Satellite Pro 490CDT<br> - Toshiba Tecra 9000<br> <br><br> <a name="functions"> <b>4. Functions</b><br><br> </a> <a name="daemon"> <b>4.1 Daemon Functions</b> </a> <br><br> The daemon can execute the following internal commands: <br><br> - brightness up -- increase LCD brightness<br> - brightness down -- decrease LCD brightness<br> - toggle fan -- switch fan on/off<br> - toggle video -- toggle video: LCD -> LCD & CRT -> CRT<br> - suspend to ram -- suspend to ram via ACPI<br> - suspend to disk -- suspend to disk (hibernate) via ACPI<br> - volume up -- increase mixer volume<br> - volume down -- decrease mixer volume<br> - mute -- toggle mute<br> <br> <b>Notes:</b><br><br> - "toggle video" is _not_ supposed to work on all systems.<br> - "suspend to ram" and "suspend to disk" will only work, if the kernel was compiled with the corresponding power management and acpi drivers and if the system does support the sleep states (S3, S4). <br><br> The daemon configuration is made by changing the file '/etc/fnfx/fnfxd.conf'. All valid Fn-x combinations and hot-keys can be found in '/etc/fnfx/keymap'. If you have run `./configure` without parameters, they're found in '/usr/local/etc/fnfx'. <br><br> Examples for the daemon configuration are found under 5.2. <br><br> <a name="client"> <b>4.2 Client Functions</b> </a> <br><br> The client can execute the internal commands as well as any arbitrary program. The client configuration '~/.fnfxrc' has to be copied to the home directory of the user who executes the client. An example can be found in '/etc/fnfx/fnfxrc_example'. If you have run `./configure` without parameters, they're found in '/usr/local/etc/fnfx'. <br><br> Examples for the client configuration are found under 5.3. <br><br><br> <a name="install"> <b>5. Installation</b> </a><br><br> <a name="compile"> <b>5.1 Compilation</b><br><br> </a> The same as usual: <br><br> - ./configure<br> - make<br> - su -<br> - make install<br> <br> Too quick? To compile FnFX, simply extract the file `fnfx-0.2.tar.gz` by running `tar xfv fnfx-0.2.tar.gz`. Afterwards run `./configure`. To compile FnFX run 'make'. If this worked, become root and run 'make install' <br><br> If './configure' was run without any additional parameters, the daemon is found in '/usr/local/sbin/fnfxd' and the client resides in '/usr/local/bin/fnfx'. The configuration files are copied to '/usr/local/etc/fnfx'. <br><br> <a name="dconf"> <b>5.2 Daemon and Client Configuration</b><br><br> </a> If all steps from 5.1 went well, FnFX is ready to be configured. The daemon configuration '/etc/fnfx/fnfxd.conf' ('/usr/local/etc/fnfx/fnfxd.conf') has a two sections. <br><br> All actions are defined in the section [actions] and are parsed by the daemon on start up. An action entry has the following format: <br><br> action(key="FN-KEY";command="COMMAND") <br><br> Where FN-KEY is a Fn-x combination or hot-key. See `/etc/fnfx/keymap' ('/usr/local/etc/fnfx/keymap') and COMMAND is one of the internal commands listed under 4.1. <br><br> In the second section [mixer], the mixer can be defined which is taken for the internal commands "volume up", "volume down" and "mute". <br><br> The format is quite easy: <br><br> mixer(device="MIXER") <br><br> Where MIXER is the mixer device. For example: /dev/mixer. <br><br> <a name="cconf"> <b>5.3 Client Configuration</b><br><br> </a> The client configuration file is `.fnfxrc`, which first has to be copied to the home directory of the user who is starting fnfx. See 4.2 and 5.4 for details. <br><br> The configuration file has the same structure like the one of fnfxd. All actions are defined below [actions] and have the format: <br><br> action(key="FN-KEY";command="COMMAND") <br><br> While the daemon can only use the internal commands as command, fnfx is able to run programs. See 5.4 for details. <br><br> <a name="confex"> <b>5.4 Configuration Examples</b><br><br> </a> The following lines are examples for action commands. <br><br> action(key="Fn-Escape";command="mute")<br> action(key="Fn-F6";command="brightness down")<br> action(key="Fn-F7";command="brightness up")<br> action(key="Fn-a";command="xmms")<br> <br> The first three examples don't need further explanation. The forth line is only possible in the client configuration. Remember? Only fnfx can start programs, in this case 'xmms' when hitting Fn-a. <br><br> <a name="todo"> <b>6. To-do</b><br><br> </a> Yes, a X11 client is still missing. It's prio #1 and the next I will code. <br><br> <a name="license"> <b>7. License</b><br><br> </a> FnFX is released under the GPL. <br><br> <a name="contact"> <b>8. Contact</b><br><br> </a> Comments, bugs and beer to: Timo Hoenig, thoenig at nouse dot net <br><br> Project home page is: <a href=http://fnfx.sf.net/ target=_extern>http://fnfx.sf.net/</a><br> Sourceforge home page is: <a href=http://sf.net/projects/fnfx target=_extern>http://sf.net/projects/fnfx</a><br> <br><br> <a name="thanks"> <b>9. Thanks</b><br><br> </a> A very warm 'Thank You' goes to all people who tested the previous version of FnFX: <br><br> Curtis, Alex James, Alexandre, Nicolas, Meiosis, Peter, Jay, Glenn, Paul, Alejandro (great pic! :), Marc, Alberto, Free, Mantas, Bruno, Johannes and Wissam. <br><br> And I am damn sure that I have forgotten someone. Sorry. <br><br> <a name="ref"> <b>10. References</b><br><br> </a> [1] ACPI4Linux,<br><br> <a href=http://acpi.sf.net target=_extern>http://acpi.sf.net</a> <br><br> </td> </tr> </table> </td> </tr> </table> </center> <center> <table border=0 width=774 cellpadding=0 cellspacing=0> <tr> <td> <table border=0 width=100%> <tr><td class=dottedbot width=100%> FnFX © <a href="mailto:thoenig at nouse dot net?subject=FnFX"><u>Timo Hoenig</u></a> || FnFX SF Project Site: <a href=http://sf.net/projects/fnfx><u>http://sf.net/projects/fnfx</u></a> </td> <td class=dottedbot>26.01.2004</td> </tr> </table> </td> </tr> </table> </center> <br> <font color="#909CA3"> 6520</font> </body> </html>
Locations
Projects
Search
Status Monitor
Help
OpenBuildService.org
Documentation
API Documentation
Code of Conduct
Contact
Support
@OBShq
Terms
openSUSE Build Service is sponsored by
The Open Build Service is an
openSUSE project
.
Sign Up
Log In
Places
Places
All Projects
Status Monitor