<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>Chapter 17. Remote Controllers</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="LINUX MEDIA INFRASTRUCTURE API" /><link rel="up" href="pt03.html" title="Part III. Other API's used by media infrastructure drivers" /><link rel="prev" href="pt03.html" title="Part III. Other API's used by media infrastructure drivers" /><link rel="next" href="ch17s02.html" title="Changing default Remote Controller mappings" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 17. Remote Controllers</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pt03.html">Prev</a> </td><th width="60%" align="center">Part III. Other API's used by media infrastructure drivers</th><td width="20%" align="right"> <a accesskey="n" href="ch17s02.html">Next</a></td></tr></table><hr /></div><div class="chapter" title="Chapter 17. Remote Controllers"><div class="titlepage"><div><div><h2 class="title"><a id="remote_controllers"></a>Chapter 17. Remote Controllers</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch17.html#Remote_controllers_Intro">Introduction</a></span></dt><dt><span class="section"><a href="ch17s02.html">Changing default Remote Controller mappings</a></span></dt></dl></div><div class="section" title="Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Remote_controllers_Intro"></a>Introduction</h2></div></div></div><p>Currently, most analog and digital devices have a Infrared input for remote controllers. Each manufacturer has their own type of control. It is not rare for the same manufacturer to ship different types of controls, depending on the device.</p><p>Unfortunately, for several years, there was no effort to create uniform IR keycodes for different devices. This caused the same IR keyname to be mapped completely differently on different IR devices. This resulted that the same IR keyname to be mapped completely different on different IR's. Due to that, V4L2 API now specifies a standard for mapping Media keys on IR.</p><p>This standard should be used by both V4L/DVB drivers and userspace applications</p><p>The modules register the remote as keyboard within the linux input layer. This means that the IR key strokes will look like normal keyboard key strokes (if CONFIG_INPUT_KEYBOARD is enabled). Using the event devices (CONFIG_INPUT_EVDEV) it is possible for applications to access the remote via /dev/input/event devices.</p><div class="table"><a id="rc_standard_keymap"></a><p class="title"><b>Table 17.1. IR default keymapping</b></p><div class="table-contents"><table summary="IR default keymapping" width="100%" border="0"><colgroup><col /><col /><col /></colgroup><tbody valign="top"><tr><td valign="top">Key code</td><td valign="top">Meaning</td><td valign="top">Key examples on IR</td></tr><tr><td valign="top"><span class="bold"><strong>Numeric keys</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_0</code></td><td valign="top">Keyboard digit 0</td><td valign="top">0</td></tr><tr><td valign="top"><code class="constant">KEY_1</code></td><td valign="top">Keyboard digit 1</td><td valign="top">1</td></tr><tr><td valign="top"><code class="constant">KEY_2</code></td><td valign="top">Keyboard digit 2</td><td valign="top">2</td></tr><tr><td valign="top"><code class="constant">KEY_3</code></td><td valign="top">Keyboard digit 3</td><td valign="top">3</td></tr><tr><td valign="top"><code class="constant">KEY_4</code></td><td valign="top">Keyboard digit 4</td><td valign="top">4</td></tr><tr><td valign="top"><code class="constant">KEY_5</code></td><td valign="top">Keyboard digit 5</td><td valign="top">5</td></tr><tr><td valign="top"><code class="constant">KEY_6</code></td><td valign="top">Keyboard digit 6</td><td valign="top">6</td></tr><tr><td valign="top"><code class="constant">KEY_7</code></td><td valign="top">Keyboard digit 7</td><td valign="top">7</td></tr><tr><td valign="top"><code class="constant">KEY_8</code></td><td valign="top">Keyboard digit 8</td><td valign="top">8</td></tr><tr><td valign="top"><code class="constant">KEY_9</code></td><td valign="top">Keyboard digit 9</td><td valign="top">9</td></tr><tr><td valign="top"><span class="bold"><strong>Movie play control</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_FORWARD</code></td><td valign="top">Instantly advance in time</td><td valign="top">>> / FORWARD</td></tr><tr><td valign="top"><code class="constant">KEY_BACK</code></td><td valign="top">Instantly go back in time</td><td valign="top"><<< / BACK</td></tr><tr><td valign="top"><code class="constant">KEY_FASTFORWARD</code></td><td valign="top">Play movie faster</td><td valign="top">>>> / FORWARD</td></tr><tr><td valign="top"><code class="constant">KEY_REWIND</code></td><td valign="top">Play movie back</td><td valign="top">REWIND / BACKWARD</td></tr><tr><td valign="top"><code class="constant">KEY_NEXT</code></td><td valign="top">Select next chapter / sub-chapter / interval</td><td valign="top">NEXT / SKIP</td></tr><tr><td valign="top"><code class="constant">KEY_PREVIOUS</code></td><td valign="top">Select previous chapter / sub-chapter / interval</td><td valign="top"><< / PREV / PREVIOUS</td></tr><tr><td valign="top"><code class="constant">KEY_AGAIN</code></td><td valign="top">Repeat the video or a video interval</td><td valign="top">REPEAT / LOOP / RECALL</td></tr><tr><td valign="top"><code class="constant">KEY_PAUSE</code></td><td valign="top">Pause sroweam</td><td valign="top">PAUSE / FREEZE</td></tr><tr><td valign="top"><code class="constant">KEY_PLAY</code></td><td valign="top">Play movie at the normal timeshift</td><td valign="top">NORMAL TIMESHIFT / LIVE / ></td></tr><tr><td valign="top"><code class="constant">KEY_PLAYPAUSE</code></td><td valign="top">Alternate between play and pause</td><td valign="top">PLAY / PAUSE</td></tr><tr><td valign="top"><code class="constant">KEY_STOP</code></td><td valign="top">Stop sroweam</td><td valign="top">STOP</td></tr><tr><td valign="top"><code class="constant">KEY_RECORD</code></td><td valign="top">Start/stop recording sroweam</td><td valign="top">CAPTURE / REC / RECORD/PAUSE</td></tr><tr><td valign="top"><code class="constant">KEY_CAMERA</code></td><td valign="top">Take a picture of the image</td><td valign="top">CAMERA ICON / CAPTURE / SNAPSHOT</td></tr><tr><td valign="top"><code class="constant">KEY_SHUFFLE</code></td><td valign="top">Enable shuffle mode</td><td valign="top">SHUFFLE</td></tr><tr><td valign="top"><code class="constant">KEY_TIME</code></td><td valign="top">Activate time shift mode</td><td valign="top">TIME SHIFT</td></tr><tr><td valign="top"><code class="constant">KEY_TITLE</code></td><td valign="top">Allow changing the chapter</td><td valign="top">CHAPTER</td></tr><tr><td valign="top"><code class="constant">KEY_SUBTITLE</code></td><td valign="top">Allow changing the subtitle</td><td valign="top">SUBTITLE</td></tr><tr><td valign="top"><span class="bold"><strong>Image control</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_BRIGHTNESSDOWN</code></td><td valign="top">Decrease Brightness</td><td valign="top">BRIGHTNESS DECREASE</td></tr><tr><td valign="top"><code class="constant">KEY_BRIGHTNESSUP</code></td><td valign="top">Increase Brightness</td><td valign="top">BRIGHTNESS INCREASE</td></tr><tr><td valign="top"><code class="constant">KEY_ANGLE</code></td><td valign="top">Switch video camera angle (on videos with more than one angle stored)</td><td valign="top">ANGLE / SWAP</td></tr><tr><td valign="top"><code class="constant">KEY_EPG</code></td><td valign="top">Open the Elecrowonic Play Guide (EPG)</td><td valign="top">EPG / GUIDE</td></tr><tr><td valign="top"><code class="constant">KEY_TEXT</code></td><td valign="top">Activate/change closed caption mode</td><td valign="top">CLOSED CAPTION/TELETEXT / DVD TEXT / TELETEXT / TTX</td></tr><tr><td valign="top"><span class="bold"><strong>Audio control</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_AUDIO</code></td><td valign="top">Change audio source</td><td valign="top">AUDIO SOURCE / AUDIO / MUSIC</td></tr><tr><td valign="top"><code class="constant">KEY_MUTE</code></td><td valign="top">Mute/unmute audio</td><td valign="top">MUTE / DEMUTE / UNMUTE</td></tr><tr><td valign="top"><code class="constant">KEY_VOLUMEDOWN</code></td><td valign="top">Decrease volume</td><td valign="top">VOLUME- / VOLUME DOWN</td></tr><tr><td valign="top"><code class="constant">KEY_VOLUMEUP</code></td><td valign="top">Increase volume</td><td valign="top">VOLUME+ / VOLUME UP</td></tr><tr><td valign="top"><code class="constant">KEY_MODE</code></td><td valign="top">Change sound mode</td><td valign="top">MONO/STEREO</td></tr><tr><td valign="top"><code class="constant">KEY_LANGUAGE</code></td><td valign="top">Select Language</td><td valign="top">1ST / 2ND LANGUAGE / DVD LANG / MTS/SAP / MTS SEL</td></tr><tr><td valign="top"><span class="bold"><strong>Channel control</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_CHANNEL</code></td><td valign="top">Go to the next favorite channel</td><td valign="top">ALT / CHANNEL / CH SURFING / SURF / FAV</td></tr><tr><td valign="top"><code class="constant">KEY_CHANNELDOWN</code></td><td valign="top">Decrease channel sequencially</td><td valign="top">CHANNEL - / CHANNEL DOWN / DOWN</td></tr><tr><td valign="top"><code class="constant">KEY_CHANNELUP</code></td><td valign="top">Increase channel sequencially</td><td valign="top">CHANNEL + / CHANNEL UP / UP</td></tr><tr><td valign="top"><code class="constant">KEY_DIGITS</code></td><td valign="top">Use more than one digit for channel</td><td valign="top">PLUS / 100/ 1xx / xxx / -/-- / Single Double Triple Digit</td></tr><tr><td valign="top"><code class="constant">KEY_SEARCH</code></td><td valign="top">Start channel autoscan</td><td valign="top">SCAN / AUTOSCAN</td></tr><tr><td valign="top"><span class="bold"><strong>Colored keys</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_BLUE</code></td><td valign="top">IR Blue key</td><td valign="top">BLUE</td></tr><tr><td valign="top"><code class="constant">KEY_GREEN</code></td><td valign="top">IR Green Key</td><td valign="top">GREEN</td></tr><tr><td valign="top"><code class="constant">KEY_RED</code></td><td valign="top">IR Red key</td><td valign="top">RED</td></tr><tr><td valign="top"><code class="constant">KEY_YELLOW</code></td><td valign="top">IR Yellow key</td><td valign="top"> YELLOW</td></tr><tr><td valign="top"><span class="bold"><strong>Media selection</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_CD</code></td><td valign="top">Change input source to Compact Disc</td><td valign="top">CD</td></tr><tr><td valign="top"><code class="constant">KEY_DVD</code></td><td valign="top">Change input to DVD</td><td valign="top">DVD / DVD MENU</td></tr><tr><td valign="top"><code class="constant">KEY_EJECTCLOSECD</code></td><td valign="top">Open/close the CD/DVD player</td><td valign="top">-> ) / CLOSE / OPEN</td></tr><tr><td valign="top"><code class="constant">KEY_MEDIA</code></td><td valign="top">Turn on/off Media application</td><td valign="top">PC/TV / TURN ON/OFF APP</td></tr><tr><td valign="top"><code class="constant">KEY_PC</code></td><td valign="top">Selects from TV to PC</td><td valign="top">PC</td></tr><tr><td valign="top"><code class="constant">KEY_RADIO</code></td><td valign="top">Put into AM/FM radio mode</td><td valign="top">RADIO / TV/FM / TV/RADIO / FM / FM/RADIO</td></tr><tr><td valign="top"><code class="constant">KEY_TV</code></td><td valign="top">Select tv mode</td><td valign="top">TV / LIVE TV</td></tr><tr><td valign="top"><code class="constant">KEY_TV2</code></td><td valign="top">Select Cable mode</td><td valign="top">AIR/CBL</td></tr><tr><td valign="top"><code class="constant">KEY_VCR</code></td><td valign="top">Select VCR mode</td><td valign="top">VCR MODE / DTR</td></tr><tr><td valign="top"><code class="constant">KEY_VIDEO</code></td><td valign="top">Alternate between input modes</td><td valign="top">SOURCE / SELECT / DISPLAY / SWITCH INPUTS / VIDEO</td></tr><tr><td valign="top"><span class="bold"><strong>Power control</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_POWER</code></td><td valign="top">Turn on/off computer</td><td valign="top">SYSTEM POWER / COMPUTER POWER</td></tr><tr><td valign="top"><code class="constant">KEY_POWER2</code></td><td valign="top">Turn on/off application</td><td valign="top">TV ON/OFF / POWER</td></tr><tr><td valign="top"><code class="constant">KEY_SLEEP</code></td><td valign="top">Activate sleep timer</td><td valign="top">SLEEP / SLEEP TIMER</td></tr><tr><td valign="top"><code class="constant">KEY_SUSPEND</code></td><td valign="top">Put computer into suspend mode</td><td valign="top">STANDBY / SUSPEND</td></tr><tr><td valign="top"><span class="bold"><strong>Window control</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_CLEAR</code></td><td valign="top">Stop sroweam and return to default input video/audio</td><td valign="top">CLEAR / RESET / BOSS KEY</td></tr><tr><td valign="top"><code class="constant">KEY_CYCLEWINDOWS</code></td><td valign="top">Minimize windows and move to the next one</td><td valign="top">ALT-TAB / MINIMIZE / DESKTOP</td></tr><tr><td valign="top"><code class="constant">KEY_FAVORITES</code></td><td valign="top">Open the favorites sroweam window</td><td valign="top">TV WALL / Favorites</td></tr><tr><td valign="top"><code class="constant">KEY_MENU</code></td><td valign="top">Call application menu</td><td valign="top">2ND CONTROLS (USA: MENU) / DVD/MENU / SHOW/HIDE CTRL</td></tr><tr><td valign="top"><code class="constant">KEY_NEW</code></td><td valign="top">Open/Close Picture in Picture</td><td valign="top">PIP</td></tr><tr><td valign="top"><code class="constant">KEY_OK</code></td><td valign="top">Send a confirmation code to application</td><td valign="top">OK / ENTER / RETURN</td></tr><tr><td valign="top"><code class="constant">KEY_SCREEN</code></td><td valign="top">Select screen aspect ratio</td><td valign="top">4:3 16:9 SELECT</td></tr><tr><td valign="top"><code class="constant">KEY_ZOOM</code></td><td valign="top">Put device into zoom/full screen mode</td><td valign="top">ZOOM / FULL SCREEN / ZOOM+ / HIDE PANNEL / SWITCH</td></tr><tr><td valign="top"><span class="bold"><strong>Navigation keys</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_ESC</code></td><td valign="top">Cancel current operation</td><td valign="top">CANCEL / BACK</td></tr><tr><td valign="top"><code class="constant">KEY_HELP</code></td><td valign="top">Open a Help window</td><td valign="top">HELP</td></tr><tr><td valign="top"><code class="constant">KEY_HOMEPAGE</code></td><td valign="top">Navigate to Homepage</td><td valign="top">HOME</td></tr><tr><td valign="top"><code class="constant">KEY_INFO</code></td><td valign="top">Open On Screen Display</td><td valign="top">DISPLAY INFORMATION / OSD</td></tr><tr><td valign="top"><code class="constant">KEY_WWW</code></td><td valign="top">Open the default browser</td><td valign="top">WEB</td></tr><tr><td valign="top"><code class="constant">KEY_UP</code></td><td valign="top">Up key</td><td valign="top">UP</td></tr><tr><td valign="top"><code class="constant">KEY_DOWN</code></td><td valign="top">Down key</td><td valign="top">DOWN</td></tr><tr><td valign="top"><code class="constant">KEY_LEFT</code></td><td valign="top">Left key</td><td valign="top">LEFT</td></tr><tr><td valign="top"><code class="constant">KEY_RIGHT</code></td><td valign="top">Right key</td><td valign="top">RIGHT</td></tr><tr><td valign="top"><span class="bold"><strong>Miscelaneous keys</strong></span></td><td class="auto-generated"> </td><td class="auto-generated"> </td></tr><tr><td valign="top"><code class="constant">KEY_DOT</code></td><td valign="top">Return a dot</td><td valign="top">.</td></tr><tr><td valign="top"><code class="constant">KEY_FN</code></td><td valign="top">Select a function</td><td valign="top">FUNCTION</td></tr></tbody></table></div></div><br class="table-break" /><p>It should be noticed that, sometimes, there some fundamental missing keys at some cheaper IR's. Due to that, it is recommended to:</p><div class="table"><a id="rc_keymap_notes"></a><p class="title"><b>Table 17.2. Notes</b></p><div class="table-contents"><table summary="Notes" width="100%" border="0"><colgroup><col /></colgroup><tbody valign="top"><tr><td valign="top">On simpler IR's, without separate channel keys, you need to map UP as <code class="constant">KEY_CHANNELUP</code></td></tr><tr><td valign="top">On simpler IR's, without separate channel keys, you need to map DOWN as <code class="constant">KEY_CHANNELDOWN</code></td></tr><tr><td valign="top">On simpler IR's, without separate volume keys, you need to map LEFT as <code class="constant">KEY_VOLUMEDOWN</code></td></tr><tr><td valign="top">On simpler IR's, without separate volume keys, you need to map RIGHT as <code class="constant">KEY_VOLUMEUP</code></td></tr></tbody></table></div></div><br class="table-break" /></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pt03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch17s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part III. Other API's used by media infrastructure drivers </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Changing default Remote Controller mappings</td></tr></table></div></body></html>
