0001 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
0002
0003 .. _Remote_controllers_tables:
0004
0005 ************************
0006 Remote controller tables
0007 ************************
0008
0009 Unfortunately, for several years, there was no effort to create uniform
0010 IR keycodes for different devices. This caused the same IR keyname to be
0011 mapped completely differently on different IR devices. This resulted
0012 that the same IR keyname to be mapped completely different on different
0013 IR's. Due to that, V4L2 API now specifies a standard for mapping Media
0014 keys on IR.
0015
0016 This standard should be used by both V4L/DVB drivers and userspace
0017 applications
0018
0019 The modules register the remote as keyboard within the linux input
0020 layer. This means that the IR key strokes will look like normal keyboard
0021 key strokes (if CONFIG_INPUT_KEYBOARD is enabled). Using the event
0022 devices (CONFIG_INPUT_EVDEV) it is possible for applications to access
0023 the remote via /dev/input/event devices.
0024
0025
0026 .. _rc_standard_keymap:
0027
0028 .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.5cm}|
0029
0030 .. flat-table:: IR default keymapping
0031 :header-rows: 0
0032 :stub-columns: 0
0033 :widths: 1 1 2
0034
0035
0036 - .. row 1
0037
0038 - Key code
0039
0040 - Meaning
0041
0042 - Key examples on IR
0043
0044 - .. row 2
0045
0046 - **Numeric keys**
0047
0048 - .. row 3
0049
0050 - ``KEY_NUMERIC_0``
0051
0052 - Keyboard digit 0
0053
0054 - 0
0055
0056 - .. row 4
0057
0058 - ``KEY_NUMERIC_1``
0059
0060 - Keyboard digit 1
0061
0062 - 1
0063
0064 - .. row 5
0065
0066 - ``KEY_NUMERIC_2``
0067
0068 - Keyboard digit 2
0069
0070 - 2
0071
0072 - .. row 6
0073
0074 - ``KEY_NUMERIC_3``
0075
0076 - Keyboard digit 3
0077
0078 - 3
0079
0080 - .. row 7
0081
0082 - ``KEY_NUMERIC_4``
0083
0084 - Keyboard digit 4
0085
0086 - 4
0087
0088 - .. row 8
0089
0090 - ``KEY_NUMERIC_5``
0091
0092 - Keyboard digit 5
0093
0094 - 5
0095
0096 - .. row 9
0097
0098 - ``KEY_NUMERIC_6``
0099
0100 - Keyboard digit 6
0101
0102 - 6
0103
0104 - .. row 10
0105
0106 - ``KEY_NUMERIC_7``
0107
0108 - Keyboard digit 7
0109
0110 - 7
0111
0112 - .. row 11
0113
0114 - ``KEY_NUMERIC_8``
0115
0116 - Keyboard digit 8
0117
0118 - 8
0119
0120 - .. row 12
0121
0122 - ``KEY_NUMERIC_9``
0123
0124 - Keyboard digit 9
0125
0126 - 9
0127
0128 - .. row 13
0129
0130 - **Movie play control**
0131
0132 - .. row 14
0133
0134 - ``KEY_FORWARD``
0135
0136 - Instantly advance in time
0137
0138 - >> / FORWARD
0139
0140 - .. row 15
0141
0142 - ``KEY_BACK``
0143
0144 - Instantly go back in time
0145
0146 - <<< / BACK
0147
0148 - .. row 16
0149
0150 - ``KEY_FASTFORWARD``
0151
0152 - Play movie faster
0153
0154 - >>> / FORWARD
0155
0156 - .. row 17
0157
0158 - ``KEY_REWIND``
0159
0160 - Play movie back
0161
0162 - REWIND / BACKWARD
0163
0164 - .. row 18
0165
0166 - ``KEY_NEXT``
0167
0168 - Select next chapter / sub-chapter / interval
0169
0170 - NEXT / SKIP
0171
0172 - .. row 19
0173
0174 - ``KEY_PREVIOUS``
0175
0176 - Select previous chapter / sub-chapter / interval
0177
0178 - << / PREV / PREVIOUS
0179
0180 - .. row 20
0181
0182 - ``KEY_AGAIN``
0183
0184 - Repeat the video or a video interval
0185
0186 - REPEAT / LOOP / RECALL
0187
0188 - .. row 21
0189
0190 - ``KEY_PAUSE``
0191
0192 - Pause stream
0193
0194 - PAUSE / FREEZE
0195
0196 - .. row 22
0197
0198 - ``KEY_PLAY``
0199
0200 - Play movie at the normal timeshift
0201
0202 - NORMAL TIMESHIFT / LIVE / >
0203
0204 - .. row 23
0205
0206 - ``KEY_PLAYPAUSE``
0207
0208 - Alternate between play and pause
0209
0210 - PLAY / PAUSE
0211
0212 - .. row 24
0213
0214 - ``KEY_STOP``
0215
0216 - Stop stream
0217
0218 - STOP
0219
0220 - .. row 25
0221
0222 - ``KEY_RECORD``
0223
0224 - Start/stop recording stream
0225
0226 - CAPTURE / REC / RECORD/PAUSE
0227
0228 - .. row 26
0229
0230 - ``KEY_CAMERA``
0231
0232 - Take a picture of the image
0233
0234 - CAMERA ICON / CAPTURE / SNAPSHOT
0235
0236 - .. row 27
0237
0238 - ``KEY_SHUFFLE``
0239
0240 - Enable shuffle mode
0241
0242 - SHUFFLE
0243
0244 - .. row 28
0245
0246 - ``KEY_TIME``
0247
0248 - Activate time shift mode
0249
0250 - TIME SHIFT
0251
0252 - .. row 29
0253
0254 - ``KEY_TITLE``
0255
0256 - Allow changing the chapter
0257
0258 - CHAPTER
0259
0260 - .. row 30
0261
0262 - ``KEY_SUBTITLE``
0263
0264 - Allow changing the subtitle
0265
0266 - SUBTITLE
0267
0268 - .. row 31
0269
0270 - **Image control**
0271
0272 - .. row 32
0273
0274 - ``KEY_BRIGHTNESSDOWN``
0275
0276 - Decrease Brightness
0277
0278 - BRIGHTNESS DECREASE
0279
0280 - .. row 33
0281
0282 - ``KEY_BRIGHTNESSUP``
0283
0284 - Increase Brightness
0285
0286 - BRIGHTNESS INCREASE
0287
0288 - .. row 34
0289
0290 - ``KEY_ANGLE``
0291
0292 - Switch video camera angle (on videos with more than one angle
0293 stored)
0294
0295 - ANGLE / SWAP
0296
0297 - .. row 35
0298
0299 - ``KEY_EPG``
0300
0301 - Open the Elecrowonic Play Guide (EPG)
0302
0303 - EPG / GUIDE
0304
0305 - .. row 36
0306
0307 - ``KEY_TEXT``
0308
0309 - Activate/change closed caption mode
0310
0311 - CLOSED CAPTION/TELETEXT / DVD TEXT / TELETEXT / TTX
0312
0313 - .. row 37
0314
0315 - **Audio control**
0316
0317 - .. row 38
0318
0319 - ``KEY_AUDIO``
0320
0321 - Change audio source
0322
0323 - AUDIO SOURCE / AUDIO / MUSIC
0324
0325 - .. row 39
0326
0327 - ``KEY_MUTE``
0328
0329 - Mute/unmute audio
0330
0331 - MUTE / DEMUTE / UNMUTE
0332
0333 - .. row 40
0334
0335 - ``KEY_VOLUMEDOWN``
0336
0337 - Decrease volume
0338
0339 - VOLUME- / VOLUME DOWN
0340
0341 - .. row 41
0342
0343 - ``KEY_VOLUMEUP``
0344
0345 - Increase volume
0346
0347 - VOLUME+ / VOLUME UP
0348
0349 - .. row 42
0350
0351 - ``KEY_MODE``
0352
0353 - Change sound mode
0354
0355 - MONO/STEREO
0356
0357 - .. row 43
0358
0359 - ``KEY_LANGUAGE``
0360
0361 - Select Language
0362
0363 - 1ST / 2ND LANGUAGE / DVD LANG / MTS/SAP / MTS SEL
0364
0365 - .. row 44
0366
0367 - **Channel control**
0368
0369 - .. row 45
0370
0371 - ``KEY_CHANNEL``
0372
0373 - Go to the next favorite channel
0374
0375 - ALT / CHANNEL / CH SURFING / SURF / FAV
0376
0377 - .. row 46
0378
0379 - ``KEY_CHANNELDOWN``
0380
0381 - Decrease channel sequentially
0382
0383 - CHANNEL - / CHANNEL DOWN / DOWN
0384
0385 - .. row 47
0386
0387 - ``KEY_CHANNELUP``
0388
0389 - Increase channel sequentially
0390
0391 - CHANNEL + / CHANNEL UP / UP
0392
0393 - .. row 48
0394
0395 - ``KEY_DIGITS``
0396
0397 - Use more than one digit for channel
0398
0399 - PLUS / 100/ 1xx / xxx / -/-- / Single Double Triple Digit
0400
0401 - .. row 49
0402
0403 - ``KEY_SEARCH``
0404
0405 - Start channel autoscan
0406
0407 - SCAN / AUTOSCAN
0408
0409 - .. row 50
0410
0411 - **Colored keys**
0412
0413 - .. row 51
0414
0415 - ``KEY_BLUE``
0416
0417 - IR Blue key
0418
0419 - BLUE
0420
0421 - .. row 52
0422
0423 - ``KEY_GREEN``
0424
0425 - IR Green Key
0426
0427 - GREEN
0428
0429 - .. row 53
0430
0431 - ``KEY_RED``
0432
0433 - IR Red key
0434
0435 - RED
0436
0437 - .. row 54
0438
0439 - ``KEY_YELLOW``
0440
0441 - IR Yellow key
0442
0443 - YELLOW
0444
0445 - .. row 55
0446
0447 - **Media selection**
0448
0449 - .. row 56
0450
0451 - ``KEY_CD``
0452
0453 - Change input source to Compact Disc
0454
0455 - CD
0456
0457 - .. row 57
0458
0459 - ``KEY_DVD``
0460
0461 - Change input to DVD
0462
0463 - DVD / DVD MENU
0464
0465 - .. row 58
0466
0467 - ``KEY_EJECTCLOSECD``
0468
0469 - Open/close the CD/DVD player
0470
0471 - -> ) / CLOSE / OPEN
0472
0473 - .. row 59
0474
0475 - ``KEY_MEDIA``
0476
0477 - Turn on/off Media application
0478
0479 - PC/TV / TURN ON/OFF APP
0480
0481 - .. row 60
0482
0483 - ``KEY_PC``
0484
0485 - Selects from TV to PC
0486
0487 - PC
0488
0489 - .. row 61
0490
0491 - ``KEY_RADIO``
0492
0493 - Put into AM/FM radio mode
0494
0495 - RADIO / TV/FM / TV/RADIO / FM / FM/RADIO
0496
0497 - .. row 62
0498
0499 - ``KEY_TV``
0500
0501 - Select tv mode
0502
0503 - TV / LIVE TV
0504
0505 - .. row 63
0506
0507 - ``KEY_TV2``
0508
0509 - Select Cable mode
0510
0511 - AIR/CBL
0512
0513 - .. row 64
0514
0515 - ``KEY_VCR``
0516
0517 - Select VCR mode
0518
0519 - VCR MODE / DTR
0520
0521 - .. row 65
0522
0523 - ``KEY_VIDEO``
0524
0525 - Alternate between input modes
0526
0527 - SOURCE / SELECT / DISPLAY / SWITCH INPUTS / VIDEO
0528
0529 - .. row 66
0530
0531 - **Power control**
0532
0533 - .. row 67
0534
0535 - ``KEY_POWER``
0536
0537 - Turn on/off computer
0538
0539 - SYSTEM POWER / COMPUTER POWER
0540
0541 - .. row 68
0542
0543 - ``KEY_POWER2``
0544
0545 - Turn on/off application
0546
0547 - TV ON/OFF / POWER
0548
0549 - .. row 69
0550
0551 - ``KEY_SLEEP``
0552
0553 - Activate sleep timer
0554
0555 - SLEEP / SLEEP TIMER
0556
0557 - .. row 70
0558
0559 - ``KEY_SUSPEND``
0560
0561 - Put computer into suspend mode
0562
0563 - STANDBY / SUSPEND
0564
0565 - .. row 71
0566
0567 - **Window control**
0568
0569 - .. row 72
0570
0571 - ``KEY_CLEAR``
0572
0573 - Stop stream and return to default input video/audio
0574
0575 - CLEAR / RESET / BOSS KEY
0576
0577 - .. row 73
0578
0579 - ``KEY_CYCLEWINDOWS``
0580
0581 - Minimize windows and move to the next one
0582
0583 - ALT-TAB / MINIMIZE / DESKTOP
0584
0585 - .. row 74
0586
0587 - ``KEY_FAVORITES``
0588
0589 - Open the favorites stream window
0590
0591 - TV WALL / Favorites
0592
0593 - .. row 75
0594
0595 - ``KEY_MENU``
0596
0597 - Call application menu
0598
0599 - 2ND CONTROLS (USA: MENU) / DVD/MENU / SHOW/HIDE CTRL
0600
0601 - .. row 76
0602
0603 - ``KEY_NEW``
0604
0605 - Open/Close Picture in Picture
0606
0607 - PIP
0608
0609 - .. row 77
0610
0611 - ``KEY_OK``
0612
0613 - Send a confirmation code to application
0614
0615 - OK / ENTER / RETURN
0616
0617 - .. row 78
0618
0619 - ``KEY_ASPECT_RATIO``
0620
0621 - Select screen aspect ratio
0622
0623 - 4:3 16:9 SELECT
0624
0625 - .. row 79
0626
0627 - ``KEY_FULL_SCREEN``
0628
0629 - Put device into zoom/full screen mode
0630
0631 - ZOOM / FULL SCREEN / ZOOM+ / HIDE PANNEL / SWITCH
0632
0633 - .. row 80
0634
0635 - **Navigation keys**
0636
0637 - .. row 81
0638
0639 - ``KEY_ESC``
0640
0641 - Cancel current operation
0642
0643 - CANCEL / BACK
0644
0645 - .. row 82
0646
0647 - ``KEY_HELP``
0648
0649 - Open a Help window
0650
0651 - HELP
0652
0653 - .. row 83
0654
0655 - ``KEY_HOMEPAGE``
0656
0657 - Navigate to Homepage
0658
0659 - HOME
0660
0661 - .. row 84
0662
0663 - ``KEY_INFO``
0664
0665 - Open On Screen Display
0666
0667 - DISPLAY INFORMATION / OSD
0668
0669 - .. row 85
0670
0671 - ``KEY_WWW``
0672
0673 - Open the default browser
0674
0675 - WEB
0676
0677 - .. row 86
0678
0679 - ``KEY_UP``
0680
0681 - Up key
0682
0683 - UP
0684
0685 - .. row 87
0686
0687 - ``KEY_DOWN``
0688
0689 - Down key
0690
0691 - DOWN
0692
0693 - .. row 88
0694
0695 - ``KEY_LEFT``
0696
0697 - Left key
0698
0699 - LEFT
0700
0701 - .. row 89
0702
0703 - ``KEY_RIGHT``
0704
0705 - Right key
0706
0707 - RIGHT
0708
0709 - .. row 90
0710
0711 - **Miscellaneous keys**
0712
0713 - .. row 91
0714
0715 - ``KEY_DOT``
0716
0717 - Return a dot
0718
0719 - .
0720
0721 - .. row 92
0722
0723 - ``KEY_FN``
0724
0725 - Select a function
0726
0727 - FUNCTION
0728
0729
0730 It should be noted that, sometimes, there some fundamental missing keys
0731 at some cheaper IR's. Due to that, it is recommended to:
0732
0733
0734 .. _rc_keymap_notes:
0735
0736 .. flat-table:: Notes
0737 :header-rows: 0
0738 :stub-columns: 0
0739
0740
0741 - .. row 1
0742
0743 - On simpler IR's, without separate channel keys, you need to map UP
0744 as ``KEY_CHANNELUP``
0745
0746 - .. row 2
0747
0748 - On simpler IR's, without separate channel keys, you need to map
0749 DOWN as ``KEY_CHANNELDOWN``
0750
0751 - .. row 3
0752
0753 - On simpler IR's, without separate volume keys, you need to map
0754 LEFT as ``KEY_VOLUMEDOWN``
0755
0756 - .. row 4
0757
0758 - On simpler IR's, without separate volume keys, you need to map
0759 RIGHT as ``KEY_VOLUMEUP``
