1.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later 2 3.. _Remote_controllers_tables: 4 5************************ 6Remote controller tables 7************************ 8 9Unfortunately, for several years, there was no effort to create uniform 10IR keycodes for different devices. This caused the same IR keyname to be 11mapped completely differently on different IR devices. This resulted 12that the same IR keyname to be mapped completely different on different 13IR's. Due to that, V4L2 API now specifies a standard for mapping Media 14keys on IR. 15 16This standard should be used by both V4L/DVB drivers and userspace 17applications 18 19The modules register the remote as keyboard within the linux input 20layer. This means that the IR key strokes will look like normal keyboard 21key strokes (if CONFIG_INPUT_KEYBOARD is enabled). Using the event 22devices (CONFIG_INPUT_EVDEV) it is possible for applications to access 23the remote via /dev/input/event devices. 24 25 26.. _rc_standard_keymap: 27 28.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| 29 30.. flat-table:: IR default keymapping 31 :header-rows: 0 32 :stub-columns: 0 33 :widths: 1 1 2 34 35 36 - .. row 1 37 38 - Key code 39 40 - Meaning 41 42 - Key examples on IR 43 44 - .. row 2 45 46 - **Numeric keys** 47 48 - .. row 3 49 50 - ``KEY_NUMERIC_0`` 51 52 - Keyboard digit 0 53 54 - 0 55 56 - .. row 4 57 58 - ``KEY_NUMERIC_1`` 59 60 - Keyboard digit 1 61 62 - 1 63 64 - .. row 5 65 66 - ``KEY_NUMERIC_2`` 67 68 - Keyboard digit 2 69 70 - 2 71 72 - .. row 6 73 74 - ``KEY_NUMERIC_3`` 75 76 - Keyboard digit 3 77 78 - 3 79 80 - .. row 7 81 82 - ``KEY_NUMERIC_4`` 83 84 - Keyboard digit 4 85 86 - 4 87 88 - .. row 8 89 90 - ``KEY_NUMERIC_5`` 91 92 - Keyboard digit 5 93 94 - 5 95 96 - .. row 9 97 98 - ``KEY_NUMERIC_6`` 99 100 - Keyboard digit 6 101 102 - 6 103 104 - .. row 10 105 106 - ``KEY_NUMERIC_7`` 107 108 - Keyboard digit 7 109 110 - 7 111 112 - .. row 11 113 114 - ``KEY_NUMERIC_8`` 115 116 - Keyboard digit 8 117 118 - 8 119 120 - .. row 12 121 122 - ``KEY_NUMERIC_9`` 123 124 - Keyboard digit 9 125 126 - 9 127 128 - .. row 13 129 130 - **Movie play control** 131 132 - .. row 14 133 134 - ``KEY_FORWARD`` 135 136 - Instantly advance in time 137 138 - >> / FORWARD 139 140 - .. row 15 141 142 - ``KEY_BACK`` 143 144 - Instantly go back in time 145 146 - <<< / BACK 147 148 - .. row 16 149 150 - ``KEY_FASTFORWARD`` 151 152 - Play movie faster 153 154 - >>> / FORWARD 155 156 - .. row 17 157 158 - ``KEY_REWIND`` 159 160 - Play movie back 161 162 - REWIND / BACKWARD 163 164 - .. row 18 165 166 - ``KEY_NEXT`` 167 168 - Select next chapter / sub-chapter / interval 169 170 - NEXT / SKIP 171 172 - .. row 19 173 174 - ``KEY_PREVIOUS`` 175 176 - Select previous chapter / sub-chapter / interval 177 178 - << / PREV / PREVIOUS 179 180 - .. row 20 181 182 - ``KEY_AGAIN`` 183 184 - Repeat the video or a video interval 185 186 - REPEAT / LOOP / RECALL 187 188 - .. row 21 189 190 - ``KEY_PAUSE`` 191 192 - Pause stream 193 194 - PAUSE / FREEZE 195 196 - .. row 22 197 198 - ``KEY_PLAY`` 199 200 - Play movie at the normal timeshift 201 202 - NORMAL TIMESHIFT / LIVE / > 203 204 - .. row 23 205 206 - ``KEY_PLAYPAUSE`` 207 208 - Alternate between play and pause 209 210 - PLAY / PAUSE 211 212 - .. row 24 213 214 - ``KEY_STOP`` 215 216 - Stop stream 217 218 - STOP 219 220 - .. row 25 221 222 - ``KEY_RECORD`` 223 224 - Start/stop recording stream 225 226 - CAPTURE / REC / RECORD/PAUSE 227 228 - .. row 26 229 230 - ``KEY_CAMERA`` 231 232 - Take a picture of the image 233 234 - CAMERA ICON / CAPTURE / SNAPSHOT 235 236 - .. row 27 237 238 - ``KEY_SHUFFLE`` 239 240 - Enable shuffle mode 241 242 - SHUFFLE 243 244 - .. row 28 245 246 - ``KEY_TIME`` 247 248 - Activate time shift mode 249 250 - TIME SHIFT 251 252 - .. row 29 253 254 - ``KEY_TITLE`` 255 256 - Allow changing the chapter 257 258 - CHAPTER 259 260 - .. row 30 261 262 - ``KEY_SUBTITLE`` 263 264 - Allow changing the subtitle 265 266 - SUBTITLE 267 268 - .. row 31 269 270 - **Image control** 271 272 - .. row 32 273 274 - ``KEY_BRIGHTNESSDOWN`` 275 276 - Decrease Brightness 277 278 - BRIGHTNESS DECREASE 279 280 - .. row 33 281 282 - ``KEY_BRIGHTNESSUP`` 283 284 - Increase Brightness 285 286 - BRIGHTNESS INCREASE 287 288 - .. row 34 289 290 - ``KEY_ANGLE`` 291 292 - Switch video camera angle (on videos with more than one angle 293 stored) 294 295 - ANGLE / SWAP 296 297 - .. row 35 298 299 - ``KEY_EPG`` 300 301 - Open the Elecrowonic Play Guide (EPG) 302 303 - EPG / GUIDE 304 305 - .. row 36 306 307 - ``KEY_TEXT`` 308 309 - Activate/change closed caption mode 310 311 - CLOSED CAPTION/TELETEXT / DVD TEXT / TELETEXT / TTX 312 313 - .. row 37 314 315 - **Audio control** 316 317 - .. row 38 318 319 - ``KEY_AUDIO`` 320 321 - Change audio source 322 323 - AUDIO SOURCE / AUDIO / MUSIC 324 325 - .. row 39 326 327 - ``KEY_MUTE`` 328 329 - Mute/unmute audio 330 331 - MUTE / DEMUTE / UNMUTE 332 333 - .. row 40 334 335 - ``KEY_VOLUMEDOWN`` 336 337 - Decrease volume 338 339 - VOLUME- / VOLUME DOWN 340 341 - .. row 41 342 343 - ``KEY_VOLUMEUP`` 344 345 - Increase volume 346 347 - VOLUME+ / VOLUME UP 348 349 - .. row 42 350 351 - ``KEY_MODE`` 352 353 - Change sound mode 354 355 - MONO/STEREO 356 357 - .. row 43 358 359 - ``KEY_LANGUAGE`` 360 361 - Select Language 362 363 - 1ST / 2ND LANGUAGE / DVD LANG / MTS/SAP / MTS SEL 364 365 - .. row 44 366 367 - **Channel control** 368 369 - .. row 45 370 371 - ``KEY_CHANNEL`` 372 373 - Go to the next favorite channel 374 375 - ALT / CHANNEL / CH SURFING / SURF / FAV 376 377 - .. row 46 378 379 - ``KEY_CHANNELDOWN`` 380 381 - Decrease channel sequentially 382 383 - CHANNEL - / CHANNEL DOWN / DOWN 384 385 - .. row 47 386 387 - ``KEY_CHANNELUP`` 388 389 - Increase channel sequentially 390 391 - CHANNEL + / CHANNEL UP / UP 392 393 - .. row 48 394 395 - ``KEY_DIGITS`` 396 397 - Use more than one digit for channel 398 399 - PLUS / 100/ 1xx / xxx / -/-- / Single Double Triple Digit 400 401 - .. row 49 402 403 - ``KEY_SEARCH`` 404 405 - Start channel autoscan 406 407 - SCAN / AUTOSCAN 408 409 - .. row 50 410 411 - **Colored keys** 412 413 - .. row 51 414 415 - ``KEY_BLUE`` 416 417 - IR Blue key 418 419 - BLUE 420 421 - .. row 52 422 423 - ``KEY_GREEN`` 424 425 - IR Green Key 426 427 - GREEN 428 429 - .. row 53 430 431 - ``KEY_RED`` 432 433 - IR Red key 434 435 - RED 436 437 - .. row 54 438 439 - ``KEY_YELLOW`` 440 441 - IR Yellow key 442 443 - YELLOW 444 445 - .. row 55 446 447 - **Media selection** 448 449 - .. row 56 450 451 - ``KEY_CD`` 452 453 - Change input source to Compact Disc 454 455 - CD 456 457 - .. row 57 458 459 - ``KEY_DVD`` 460 461 - Change input to DVD 462 463 - DVD / DVD MENU 464 465 - .. row 58 466 467 - ``KEY_EJECTCLOSECD`` 468 469 - Open/close the CD/DVD player 470 471 - -> ) / CLOSE / OPEN 472 473 - .. row 59 474 475 - ``KEY_MEDIA`` 476 477 - Turn on/off Media application 478 479 - PC/TV / TURN ON/OFF APP 480 481 - .. row 60 482 483 - ``KEY_PC`` 484 485 - Selects from TV to PC 486 487 - PC 488 489 - .. row 61 490 491 - ``KEY_RADIO`` 492 493 - Put into AM/FM radio mode 494 495 - RADIO / TV/FM / TV/RADIO / FM / FM/RADIO 496 497 - .. row 62 498 499 - ``KEY_TV`` 500 501 - Select tv mode 502 503 - TV / LIVE TV 504 505 - .. row 63 506 507 - ``KEY_TV2`` 508 509 - Select Cable mode 510 511 - AIR/CBL 512 513 - .. row 64 514 515 - ``KEY_VCR`` 516 517 - Select VCR mode 518 519 - VCR MODE / DTR 520 521 - .. row 65 522 523 - ``KEY_VIDEO`` 524 525 - Alternate between input modes 526 527 - SOURCE / SELECT / DISPLAY / SWITCH INPUTS / VIDEO 528 529 - .. row 66 530 531 - **Power control** 532 533 - .. row 67 534 535 - ``KEY_POWER`` 536 537 - Turn on/off computer 538 539 - SYSTEM POWER / COMPUTER POWER 540 541 - .. row 68 542 543 - ``KEY_POWER2`` 544 545 - Turn on/off application 546 547 - TV ON/OFF / POWER 548 549 - .. row 69 550 551 - ``KEY_SLEEP`` 552 553 - Activate sleep timer 554 555 - SLEEP / SLEEP TIMER 556 557 - .. row 70 558 559 - ``KEY_SUSPEND`` 560 561 - Put computer into suspend mode 562 563 - STANDBY / SUSPEND 564 565 - .. row 71 566 567 - **Window control** 568 569 - .. row 72 570 571 - ``KEY_CLEAR`` 572 573 - Stop stream and return to default input video/audio 574 575 - CLEAR / RESET / BOSS KEY 576 577 - .. row 73 578 579 - ``KEY_CYCLEWINDOWS`` 580 581 - Minimize windows and move to the next one 582 583 - ALT-TAB / MINIMIZE / DESKTOP 584 585 - .. row 74 586 587 - ``KEY_FAVORITES`` 588 589 - Open the favorites stream window 590 591 - TV WALL / Favorites 592 593 - .. row 75 594 595 - ``KEY_MENU`` 596 597 - Call application menu 598 599 - 2ND CONTROLS (USA: MENU) / DVD/MENU / SHOW/HIDE CTRL 600 601 - .. row 76 602 603 - ``KEY_NEW`` 604 605 - Open/Close Picture in Picture 606 607 - PIP 608 609 - .. row 77 610 611 - ``KEY_OK`` 612 613 - Send a confirmation code to application 614 615 - OK / ENTER / RETURN 616 617 - .. row 78 618 619 - ``KEY_ASPECT_RATIO`` 620 621 - Select screen aspect ratio 622 623 - 4:3 16:9 SELECT 624 625 - .. row 79 626 627 - ``KEY_FULL_SCREEN`` 628 629 - Put device into zoom/full screen mode 630 631 - ZOOM / FULL SCREEN / ZOOM+ / HIDE PANNEL / SWITCH 632 633 - .. row 80 634 635 - **Navigation keys** 636 637 - .. row 81 638 639 - ``KEY_ESC`` 640 641 - Cancel current operation 642 643 - CANCEL / BACK 644 645 - .. row 82 646 647 - ``KEY_HELP`` 648 649 - Open a Help window 650 651 - HELP 652 653 - .. row 83 654 655 - ``KEY_HOMEPAGE`` 656 657 - Navigate to Homepage 658 659 - HOME 660 661 - .. row 84 662 663 - ``KEY_INFO`` 664 665 - Open On Screen Display 666 667 - DISPLAY INFORMATION / OSD 668 669 - .. row 85 670 671 - ``KEY_WWW`` 672 673 - Open the default browser 674 675 - WEB 676 677 - .. row 86 678 679 - ``KEY_UP`` 680 681 - Up key 682 683 - UP 684 685 - .. row 87 686 687 - ``KEY_DOWN`` 688 689 - Down key 690 691 - DOWN 692 693 - .. row 88 694 695 - ``KEY_LEFT`` 696 697 - Left key 698 699 - LEFT 700 701 - .. row 89 702 703 - ``KEY_RIGHT`` 704 705 - Right key 706 707 - RIGHT 708 709 - .. row 90 710 711 - **Miscellaneous keys** 712 713 - .. row 91 714 715 - ``KEY_DOT`` 716 717 - Return a dot 718 719 - . 720 721 - .. row 92 722 723 - ``KEY_FN`` 724 725 - Select a function 726 727 - FUNCTION 728 729 730It should be noted that, sometimes, there some fundamental missing keys 731at some cheaper IR's. Due to that, it is recommended to: 732 733 734.. _rc_keymap_notes: 735 736.. flat-table:: Notes 737 :header-rows: 0 738 :stub-columns: 0 739 740 741 - .. row 1 742 743 - On simpler IR's, without separate channel keys, you need to map UP 744 as ``KEY_CHANNELUP`` 745 746 - .. row 2 747 748 - On simpler IR's, without separate channel keys, you need to map 749 DOWN as ``KEY_CHANNELDOWN`` 750 751 - .. row 3 752 753 - On simpler IR's, without separate volume keys, you need to map 754 LEFT as ``KEY_VOLUMEDOWN`` 755 756 - .. row 4 757 758 - On simpler IR's, without separate volume keys, you need to map 759 RIGHT as ``KEY_VOLUMEUP`` 760