Remote Controllers

From LinuxTVWiki

(Difference between revisions)
Jump to: navigation, search
(Remote Controllers)
Line 5: Line 5:
See [[ir-common.c]] IR summary by Aug, 26 2009 for a sample of the confusion.
See [[ir-common.c]] IR summary by Aug, 26 2009 for a sample of the confusion.
-
Starting on Aug, 27 2009, there's a [[proposal]] for using a common keycode definition at the supported IR's to be used also by userspace applications.
+
On Aug, 27 2009, a common mapping were object of a [[proposal]] for using a common keycode definition at the supported IR's to be used also by userspace applications. The table bellow reflects the expected keycode mappings for IR keys.
 +
 
 +
===IR Keycode map used by media devices===
 +
{| border="1" cellpadding="2"
 +
!Key code
 +
!Meaning
 +
!Key examples on IR
 +
|- style= "font-weight: bolder; color: blue"
 +
| Numeric keys
 +
|-
 +
|KEY_0 || Keyboard digit 0 || 0
 +
|-
 +
|KEY_1 || Keyboard digit 1 || 1
 +
|-
 +
|KEY_2 || Keyboard digit 2 || 2
 +
|-
 +
|KEY_3 || Keyboard digit 3 || 3
 +
|-
 +
|KEY_4 || Keyboard digit 4 || 4
 +
|-
 +
|KEY_5 || Keyboard digit 5 || 5
 +
|-
 +
|KEY_6 || Keyboard digit 6 || 6
 +
|-
 +
|KEY_7 || Keyboard digit 7 || 7
 +
|-
 +
|KEY_8 || Keyboard digit 8 || 8
 +
|-
 +
|KEY_9 || Keyboard digit 9 || 9
 +
|- style= "font-weight: bolder; color: blue"
 +
| Movie play control
 +
|-
 +
|KEY_FORWARD || Instantly advance in time ||  >> / FORWARD
 +
|-
 +
|KEY_BACK || Instantly go back in time || <<< / BACK
 +
|-
 +
|KEY_FASTFORWARD || Play movie faster ||  >>> / FORWARD
 +
|-
 +
|KEY_REWIND || Play movie back || REWIND / BACKWARD
 +
|-
 +
|KEY_NEXT || Select next chapter / sub-chapter / interval || NEXT / SKIP
 +
|-
 +
|KEY_PREVIOUS || Select previous chapter / sub-chapter / interval ||  BACK / |<< /  PREV / PREVIOUS
 +
|-
 +
|KEY_AGAIN || Repeat the video or a video interval || REPEAT / LOOP / RECALL
 +
|-
 +
|KEY_PAUSE || Pause stream ||  PAUSE / FREEZE
 +
|-
 +
|KEY_PLAY || Play movie at the normal timeshift ||  NORMAL TIMESHIFT / LIVE / >
 +
|-
 +
|KEY_PLAYPAUSE || Alternate between play and pause || PLAY / PAUSE
 +
|-
 +
|KEY_STOP || Stop stream ||  STOP
 +
|-
 +
|KEY_RECORD || Start/stop recording stream ||  CAPTURE / REC / RECORD/PAUSE
 +
|-
 +
|KEY_CAMERA || Take a picture of the image ||  CAMERA ICON / CAPTURE / SNAPSHOT
 +
|-
 +
|KEY_SHUFFLE || Enable shuffle mode ||  SHUFFLE
 +
|-
 +
|KEY_TIME || Activate time shift mode ||  TIME SHIFT
 +
|-
 +
|KEY_TITLE || Allow changing the chapter || CHAPTER
 +
|-
 +
|KEY_SUBTITLE || Allow changing the subtitle || SUBTITLE
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Image control
 +
|-
 +
|KEY_BRIGHTNESSDOWN || Decrease Brightness ||  BRIGHTNESS DECREASE
 +
|-
 +
|KEY_BRIGHTNESSUP || Increase Brightness ||  BRIGHTNESS INCREASE
 +
|-
 +
|KEY_ANGLE || Switch video camera angle (on videos with more than one angle stored) || ANGLE / SWAP
 +
|-
 +
|KEY_EPG || Open the Electronic Play Guide (EPG) || EPG / GUIDE
 +
|-
 +
|KEY_TEXT || Activate/change closed caption mode ||  CLOSED CAPTION/TELETEXT / DVD TEXT / TELETEXT / TTX
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Audio control
 +
|-
 +
|KEY_AUDIO || Change audio source || AUDIO SOURCE / AUDIO / MUSIC
 +
|-
 +
|KEY_MUTE || Mute/unmute audio ||  MUTE / DEMUTE / UNMUTE
 +
|-
 +
|KEY_VOLUMEDOWN || Decrease volume ||  VOLUME- / VOLUME DOWN
 +
|-
 +
|KEY_VOLUMEUP || Increase volume ||  VOLUME+ / VOLUME UP
 +
|-
 +
|KEY_MODE || Change sound mode || MONO/STEREO
 +
|-
 +
|KEY_LANGUAGE || Select Language ||  1ST / 2ND LANGUAGE / DVD LANG / MTS/SAP / MTS SEL
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Channel control
 +
|-
 +
|KEY_CHANNEL || Go to the next favorite channel ||  ALT / CHANNEL / CH SURFING / SURF / FAV
 +
|-
 +
|KEY_CHANNELDOWN || Decrease channel sequencially ||  CHANNEL - / CHANNEL DOWN / DOWN
 +
|-
 +
|KEY_CHANNELUP || Increase channel sequencially ||  CHANNEL + / CHANNEL UP / UP
 +
|-
 +
|KEY_DIGITS || Use more than one digit for channel ||  PLUS / 100/ 1xx / xxx /  -/--  / Single Double Triple Digit
 +
|-
 +
|KEY_SEARCH || Start channel autoscan ||  SCAN / AUTOSCAN
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Colored keys
 +
|-
 +
|KEY_BLUE || IR “Blue” key
 +
|style= "color: blue" | BLUE
 +
|-
 +
|KEY_GREEN || IR “Green” Key
 +
|style= "color: green" | GREEN
 +
|-
 +
|KEY_RED || IR “Red” key
 +
|style= "color: red" | RED
 +
|-
 +
|KEY_YELLOW || IR “Yellow” key
 +
|style= "color: yellow" | YELLOW
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Media selection
 +
|-
 +
|KEY_CD || Change input source to Compact Disc ||  CD
 +
|-
 +
|KEY_DVD || Change input to DVD ||  DVD / DVD MENU
 +
|-
 +
|KEY_EJECTCLOSECD || Open/close the CD/DVD player ||  -> ) / CLOSE / OPEN
 +
|-
 +
|KEY_MEDIA || Turn on/off Media application ||  PC/TV /  TURN ON/OFF APP
 +
|-
 +
|KEY_PC || Selects from TV to PC || PC
 +
|-
 +
|KEY_RADIO || Put into AM/FM radio mode ||  RADIO / TV/FM / TV/RADIO / FM / FM/RADIO
 +
|-
 +
|KEY_TV || Select tv mode || TV / LIVE TV
 +
|-
 +
|KEY_TV2 || Select Cable mode ||  AIR/CBL
 +
|-
 +
|KEY_VCR || Select VCR mode ||  VCR MODE / DTR
 +
|-
 +
|KEY_VIDEO || Alternate between input modes || SOURCE / SELECT / DISPLAY / SWITCH INPUTS / VIDEO
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Power control
 +
|-
 +
|KEY_POWER || Turn on/off computer ||  SYSTEM POWER / COMPUTER POWER
 +
|-
 +
|KEY_POWER2 || Turn on/off application ||  TV ON/OFF / POWER
 +
|-
 +
|KEY_SLEEP || Activate sleep timer ||  SLEEP / SLEEP TIMER
 +
|-
 +
|KEY_SUSPEND || Put computer into suspend mode ||  STANDBY / SUSPEND
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Window control
 +
|-
 +
|KEY_CLEAR || Stop stream and return to default input video/audio ||  CLEAR / RESET / BOSS KEY
 +
|-
 +
|KEY_CYCLEWINDOWS || Minimize windows and move to the next one || ALT-TAB / MINIMIZE / DESKTOP
 +
|-
 +
|KEY_FAVORITES || Open the favorites stream window || TV WALL / Favorites
 +
|-
 +
|KEY_MENU || Call application menu ||  2ND CONTROLS (USA: MENU) / DVD/MENU / SHOW/HIDE CTRL
 +
|-
 +
|KEY_NEW || Open/Close Picture in Picture ||  PIP
 +
|-
 +
|KEY_OK || Send a confirmation code to application || OK / ENTER / RETURN
 +
|-
 +
|KEY_SCREEN || Select screen aspect ratio ||  4:3 16:9 SELECT
 +
|-
 +
|KEY_ZOOM || Put device into zoom/full screen mode ||  ZOOM / FULL SCREEN / ZOOM+ / HIDE PANNEL / SWITCH
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Navigation keys
 +
|-
 +
|KEY_ESC || Cancel current operation || CANCEL / BACK
 +
|-
 +
|KEY_HELP || Open a Help window ||  HELP
 +
|-
 +
|KEY_HOMEPAGE || Navigate to Homepage || HOME
 +
|-
 +
|KEY_INFO || Open On Screen Display ||  DISPLAY INFORMATION / OSD
 +
|-
 +
|KEY_WWW || Open the default browser ||  WEB
 +
|-
 +
|- style= "font-weight: bolder; color: blue"
 +
| Miscelaneous keys
 +
|-
 +
|KEY_DOT || Return a dot ||  .
 +
|-
 +
|KEY_FN || Select a function ||  FUNCTION
 +
|}
===Technical details about IR===
===Technical details about IR===

Revision as of 11:36, 29 August 2009

Remote Controllers

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 that the same manufacturer to ship different types of controls, depending on the device. Unfortunately, during several years, there weren't any effort to uniform the IR keycodes under different boards. This resulted that the same IR keyname to be mapped completely different on differnt IR's. There were, however, an effort to keep those IR layouts at the same file (ir-common.c).

See ir-common.c IR summary by Aug, 26 2009 for a sample of the confusion.

On Aug, 27 2009, a common mapping were object of a proposal for using a common keycode definition at the supported IR's to be used also by userspace applications. The table bellow reflects the expected keycode mappings for IR keys.

IR Keycode map used by media devices

Key code Meaning Key examples on IR
Numeric keys
KEY_0 Keyboard digit 0 0
KEY_1 Keyboard digit 1 1
KEY_2 Keyboard digit 2 2
KEY_3 Keyboard digit 3 3
KEY_4 Keyboard digit 4 4
KEY_5 Keyboard digit 5 5
KEY_6 Keyboard digit 6 6
KEY_7 Keyboard digit 7 7
KEY_8 Keyboard digit 8 8
KEY_9 Keyboard digit 9 9
Movie play control
KEY_FORWARD Instantly advance in time >> / FORWARD
KEY_BACK Instantly go back in time <<< / BACK
KEY_FASTFORWARD Play movie faster >>> / FORWARD
KEY_REWIND Play movie back REWIND / BACKWARD
KEY_NEXT Select next chapter / sub-chapter / interval NEXT / SKIP
KEY_PREVIOUS Select previous chapter / sub-chapter / interval << / PREV / PREVIOUS
KEY_AGAIN Repeat the video or a video interval REPEAT / LOOP / RECALL
KEY_PAUSE Pause stream PAUSE / FREEZE
KEY_PLAY Play movie at the normal timeshift NORMAL TIMESHIFT / LIVE / >
KEY_PLAYPAUSE Alternate between play and pause PLAY / PAUSE
KEY_STOP Stop stream STOP
KEY_RECORD Start/stop recording stream CAPTURE / REC / RECORD/PAUSE
KEY_CAMERA Take a picture of the image CAMERA ICON / CAPTURE / SNAPSHOT
KEY_SHUFFLE Enable shuffle mode SHUFFLE
KEY_TIME Activate time shift mode TIME SHIFT
KEY_TITLE Allow changing the chapter CHAPTER
KEY_SUBTITLE Allow changing the subtitle SUBTITLE
Image control
KEY_BRIGHTNESSDOWN Decrease Brightness BRIGHTNESS DECREASE
KEY_BRIGHTNESSUP Increase Brightness BRIGHTNESS INCREASE
KEY_ANGLE Switch video camera angle (on videos with more than one angle stored) ANGLE / SWAP
KEY_EPG Open the Electronic Play Guide (EPG) EPG / GUIDE
KEY_TEXT Activate/change closed caption mode CLOSED CAPTION/TELETEXT / DVD TEXT / TELETEXT / TTX
Audio control
KEY_AUDIO Change audio source AUDIO SOURCE / AUDIO / MUSIC
KEY_MUTE Mute/unmute audio MUTE / DEMUTE / UNMUTE
KEY_VOLUMEDOWN Decrease volume VOLUME- / VOLUME DOWN
KEY_VOLUMEUP Increase volume VOLUME+ / VOLUME UP
KEY_MODE Change sound mode MONO/STEREO
KEY_LANGUAGE Select Language 1ST / 2ND LANGUAGE / DVD LANG / MTS/SAP / MTS SEL
Channel control
KEY_CHANNEL Go to the next favorite channel ALT / CHANNEL / CH SURFING / SURF / FAV
KEY_CHANNELDOWN Decrease channel sequencially CHANNEL - / CHANNEL DOWN / DOWN
KEY_CHANNELUP Increase channel sequencially CHANNEL + / CHANNEL UP / UP
KEY_DIGITS Use more than one digit for channel PLUS / 100/ 1xx / xxx / -/-- / Single Double Triple Digit
KEY_SEARCH Start channel autoscan SCAN / AUTOSCAN
Colored keys
KEY_BLUE IR “Blue” key BLUE
KEY_GREEN IR “Green” Key GREEN
KEY_RED IR “Red” key RED
KEY_YELLOW IR “Yellow” key YELLOW
Media selection
KEY_CD Change input source to Compact Disc CD
KEY_DVD Change input to DVD DVD / DVD MENU
KEY_EJECTCLOSECD Open/close the CD/DVD player -> ) / CLOSE / OPEN
KEY_MEDIA Turn on/off Media application PC/TV / TURN ON/OFF APP
KEY_PC Selects from TV to PC PC
KEY_RADIO Put into AM/FM radio mode RADIO / TV/FM / TV/RADIO / FM / FM/RADIO
KEY_TV Select tv mode TV / LIVE TV
KEY_TV2 Select Cable mode AIR/CBL
KEY_VCR Select VCR mode VCR MODE / DTR
KEY_VIDEO Alternate between input modes SOURCE / SELECT / DISPLAY / SWITCH INPUTS / VIDEO
Power control
KEY_POWER Turn on/off computer SYSTEM POWER / COMPUTER POWER
KEY_POWER2 Turn on/off application TV ON/OFF / POWER
KEY_SLEEP Activate sleep timer SLEEP / SLEEP TIMER
KEY_SUSPEND Put computer into suspend mode STANDBY / SUSPEND
Window control
KEY_CLEAR Stop stream and return to default input video/audio CLEAR / RESET / BOSS KEY
KEY_CYCLEWINDOWS Minimize windows and move to the next one ALT-TAB / MINIMIZE / DESKTOP
KEY_FAVORITES Open the favorites stream window TV WALL / Favorites
KEY_MENU Call application menu 2ND CONTROLS (USA: MENU) / DVD/MENU / SHOW/HIDE CTRL
KEY_NEW Open/Close Picture in Picture PIP
KEY_OK Send a confirmation code to application OK / ENTER / RETURN
KEY_SCREEN Select screen aspect ratio 4:3 16:9 SELECT
KEY_ZOOM Put device into zoom/full screen mode ZOOM / FULL SCREEN / ZOOM+ / HIDE PANNEL / SWITCH
Navigation keys
KEY_ESC Cancel current operation CANCEL / BACK
KEY_HELP Open a Help window HELP
KEY_HOMEPAGE Navigate to Homepage HOME
KEY_INFO Open On Screen Display DISPLAY INFORMATION / OSD
KEY_WWW Open the default browser WEB
Miscelaneous keys
KEY_DOT Return a dot .
KEY_FN Select a function FUNCTION

Technical details about IR

http://linuxtv.org/wiki/index.php/Remote_controllers-V4L

Personal tools