Difference between revisions of "MX3 Air Mouse Remote"

From MythTV Official Wiki
Jump to: navigation, search
m
m (Edit Keys)
 
(38 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Image:Airmouseremote.jpg|300px|right|thumb]]
+
[[Image:Airmouseremote.jpg|300px|right|thumb|The original MX3 has no backlight but has more colorful keys and an F2 key.]]
  
This combination of a remote control, keyboard and pointing device is an unbranded product made by someone in China and sold under many names. Amazon has had it under Aerb, Rii, Ideapro, X-Strong, Lynec and others. NewEgg has had it under TomTop and other names. It can be recognized by its rectangular shape, the large, blue “OK” button and the row of four colored buttons at the bottom of the numeric pad. It sells in the $12 to $20 range. It is a hand held device which has a good set of remote control buttons on one side and a small QWERTY keyboard on the other side. It also incorporates a gyro mouse which allows the mouse cursor to be moved by waving the unit around. It connects to the computer by a microwave (2.4 GHz) radio link to a tiny receiver which plugs directly into a USB port and sticks out only about 1/2”. It does not have to be pointed at the receiver and the signal should go through non-metallic barriers at least up to a point.  The range is about 30 feet/10 meters. The Linux kernel recognizes it as a keyboard and a mouse when the receiver is connected and no system configuration or extra software is required. The keyboard and pointer work immediately but MythTV will need to be configured to use most of the remote keys.
+
This is an excellent all-in-one [[USB]] [[HID]] that appears to Linux and MythTV as a keyboard and mouse. It has everything we need in a remote: navigation, media control, numeric keypad, mini QWERTY and even a mouse and 5 learning IR buttons! Many features work automatically but it may be necessary to tell MythTV about the multimedia keys as detailed below.
  
As a bonus, the unit also has an Infra-red (IR) interface with a learning function which can emulate many proprietary remote controls for other appliances. Note that this is a computer peripheral, not a universal remote.  The power button and the four colored buttons at the bottom are the only ones which can generate IR outputs. It may be possible to turn a TV set or sound system on and off and control a few functions such as volume levels with the buttons. It works with many appliances but not all. The “TV” button is used to program this function.
+
== Hardware Description ==
 +
 
 +
This combination of a remote control, keyboard and pointing device is a product made in China and most often listed as an '''MX3''' model under various brands. [https://www.amazon.com/s?k=MX3+Air+Mouse+Remote Amazon] and [https://www.newegg.com/p/pl?d=MX3+air+mouse+remote NewEgg] are common sources. It can be recognized by its rectangular shape, the large, round “OK” button and the row of four colored buttons at the bottom of the numeric pad. It sells in the $12 to $20 range. It is a hand held device which has a good set of remote control buttons on one side and a small QWERTY keyboard on the other side. It also incorporates a gyro mouse which allows the mouse cursor to be moved by waving the unit around. It connects to the computer by a microwave (2.4 GHz) radio link to a tiny receiver which plugs directly into a USB port and sticks out only about 1/2”. It does not have to be pointed at the receiver and the signal should go through non-metallic barriers at least up to a point.  The range is about 30 feet/10 meters. The Linux kernel recognizes it as a keyboard and a mouse when the receiver is connected and no system configuration or extra software is required.  The keyboard and pointer work immediately but MythTV will need to be configured to use most of the remote keys, see below.
 +
 
 +
As a bonus, the unit also has an Infra-red (IR) interface with a learning function which can emulate many proprietary remote controls for other appliances. Note that this is a computer peripheral, not a universal remote.  The power button and the four colored buttons at the bottom are the only ones which can generate IR outputs. It is possible to turn a TV set or sound system on and off and control a few functions such as volume levels with these buttons. It can learn from remotes that use the NEC protocol. The “TV” button is used to program this function.
  
 
If the unit is held with the remote side up, the keyboard shuts off to prevent buttons from being pressed accidentally. If the keyboard side is upwards, the mouse function shuts off so that the cursor position is not affected by moving the unit around while using it as a keyboard.
 
If the unit is held with the remote side up, the keyboard shuts off to prevent buttons from being pressed accidentally. If the keyboard side is upwards, the mouse function shuts off so that the cursor position is not affected by moving the unit around while using it as a keyboard.
  
The unit has a quirk in that it shuts down if a button is not pressed for a minute or so. This obviously saves the battery but it is necessary to press any key to get it started again. In practice, this means that a key is pressed and, if nothing happens, it is pressed again. On some units (probably older ones), the mouse function comes back on when it wakes up, even if it had been turned off earlier. This is annoying if the "OK" key needs to produce Return/Enter. A work around is to get into the habit of pressing the mouse control key twice whenever the control is picked up. This wakes it up and turns the mouse back off. If it was already running, it toggles the mouse on and back off which does not hurt anything.
+
The unit has a quirk in that it shuts down if a button is not pressed for a minute or so. This obviously saves the battery but it is necessary to press any key to get it started again. In practice, this means that a key is pressed and, if nothing happens, it is pressed again. On some units (probably older ones), the mouse function comes back on when it wakes up, even if it had been turned off earlier. This is annoying if button control is preferred.  Pressing and holding the mouse control button for about 5 seconds (until the LED stops flashing rapidly) seems to fix this temporarily but it comes back on at some point. Buying from a fairly high-volume dealer such as Aerb may increase the chances of getting a current unit. There seems to be some ongoing development.
 +
 
 +
There is a new version which features a back-light but it has other minor refinements and it is nicer looking as well. It is worth paying a few dollars more for this unit.
 +
 
 +
There is a magic trick to opening the battery compartment which should be in the instructions. Hold the keyboard side up and put a thumbnail into the center of the gap in the case next to the "Enter" and "Backspace" keys. The cover will pop back slightly and can then be lifted up and off. To replace it, set it in just slightly back from its closed position and make sure it is all the way down on both sides. Push it towards the keyboard to engage the latch.
 +
 
 +
== Remote Key Layout ==
 +
 
 +
The back side is a miniature 4 row QWERTY keyboard while the front side is a remote control of Key Names in this layout:
 +
 
 +
[[Image:MX3.jpg|300px|right|thumb|Backlight versions exist in white or RGB.  The F2 key is replaced by the backlight toggle button.]]
 +
 
 +
{| class="wikitable" style="text-align:center;"
 +
|- style="color:#cb0000;"
 +
| [Power]
 +
| colspan="3" |
 +
|-
 +
| Media Rewind
 +
| Media Fast Forward
 +
| Media Previous
 +
| Media Next
 +
|-
 +
| Search / F3
 +
| Media Play
 +
| ''zoom+''
 +
| ''zoom-''
 +
|-
 +
| Menu
 +
| colspan="2" | Home Page
 +
| Back<br />(3)
 +
|-
 +
|
 +
| colspan="2" | Up
 +
|
 +
|-
 +
| Left
 +
| colspan="2" | Return<br />(1)
 +
| Right
 +
|-
 +
|
 +
| colspan="2" | Down
 +
|
 +
|-
 +
| Volume Up
 +
| colspan="2" |
 +
| PgUp
 +
|-
 +
| Volume Down
 +
| Mute
 +
| (mouse)
 +
| PgDown
 +
|-
 +
| 1
 +
| 2
 +
| 3
 +
| Tools
 +
|-
 +
| 4
 +
| 5
 +
| 6
 +
| Launch Mail
 +
|-
 +
| 7
 +
| 8
 +
| 9
 +
| F2 / light
 +
|-
 +
| style="color:#cb0000;" | [TV]
 +
| 0
 +
| Backspace
 +
| WWW / Mic
 +
|- style="color:#cb0000;"
 +
| [red]
 +
| [green]
 +
| [yellow]
 +
| [blue]
 +
|}
 +
 
 +
The keys in red [brackets] are programmable Infrared except for [TV] which is used to program the 5 others from an IR remote.  These keys can be used for powering on the TV or a sound bar or adjusting its volume. Per the manual, only the NEC protocol is supported.
 +
 
 +
The (mouse) button toggles the air mouse.  When on, the center "Return" button becomes mouse button(1) while "Back" becomes mouse button(3).
  
There is a minor problem with controlling MythTV using a keyboard device in that the program must have the desktop focus to receive keyboard input. Input from LIRC is independent of the desktop focus which can be handy if a dual monitor system is used as both a workstation and a media player. Unfortunately, the LIRC package is becoming increasingly difficult to set up with the newer kernels and SELinux configurations. The fact that this control includes the pointing device makes it easy to establish the focus without having to use the workstation mouse.
+
The ''zoom'' buttons are not available to Linux by default. F2 is a light toggle on the backlight models. WWW is a speak button on the microphone models, probably not useful to MythTV. The rest of the keys are available to MythTV with the names given in the table.
  
== Configuring MythTV ==
+
== Edit Keys ==
  
The keyboard and some of the remote control keys work immediately. The numeric keypad works and the “DEL” key generates a backspace. The ring key around the “OK” button generates the keyboard arrow keys and they have done something clever with the “OK” button. If the mouse function is active, “OK” generates the left mouse button. If the mouse is off, “OK” generates the Return/Enter key. The mouse is toggled on and off by the red-marked key which shows a cursor arrow and on/off symbol. The Mute key (red “X” over a speaker symbol) should work and whether the volume control keys will work depends on the way the system audio is set up. The “PG+” and “PG-” keys generate the “Page Up” and “Page Down” keys which may be useful or can be reconfigured.
+
All keys not listed below should already work as they are also found on all standard keyboards. As MythTV predates the newer Media keys, these may not work by default. With some patience we can bind all available keys to work well as in the table shown here.
  
Of the three blue-marked keys above the “OK” button, the leftmost generates the Menu key found on many modern keyboards. It makes sense to configure MythTV to use this to enter the menu system but some desktop environments may trap this key to bring up an internal menuIt may be necessary to disable this feature in the desktop settings to use it with MythTV. The rightmost key (with the “U-turn” arrow) generates the right mouse button whether the mouse is on or off and probably can't be used for other purposes. The center key with the upward pointing arrow is not assigned and works well for the Escape/Exit function in MythTV.
+
In MythTV's Setup menu select "Edit Keys".  Use the arrow keys to navigate to a "Context" column and "ACTION" below.  Then right arrow to an unused key binding slot (to preserve all current keys) and hit EnterThen hit the remote key from column 1 and Enter to save it or Escape to cancel. Move left to return to the ACTION/context and work on more entries from the grid. Upon Escaping out, be sure to save the changes!
  
Of the four keys above the blue-marked keys, the leftmost (magnifying glass) generates the “F3” key which MythTV defaults as a jump to the Program Guide display.  This is likely to be useful as is but can be reassigned if desired. The Pause/Play key to its right is arbitrary and can obviously be assigned to the “Pause” and “Play” functions in several places in MythTV. The remaining two buttons, intended as “Zoom In” and “Zoom Out”, generate off-the-wall key codes (418 and 419) which are unlikely to be implemented in current Linux systems but may be usable in some systems.  Making them work in Linux is complicated and messing with the keymaps can easily make the system unbootable.
+
{| class="wikitable"
 +
|-
 +
! Remote Key
 +
! act<br />like
 +
! Global
 +
! TV Frontend
 +
! TV Playback
 +
! Music
 +
! Gallery /<br />Images
 +
! Browser
 +
! Video
 +
! Main Menu
 +
|-
 +
| Media Rewind
 +
| <
 +
| PREVIOUS
 +
| PAGELEFT
 +
| RWNDSTICKY
 +
| RWND
 +
| ZOOMOUT
 +
| ZOOMOUT
 +
|
 +
|
 +
|-
 +
| Media Fast Forward
 +
| >
 +
| NEXT
 +
| PAGERIGHT
 +
| FFWDSTICKY
 +
| FFWD
 +
| ZOOMIN
 +
| ZOOMIN
 +
|
 +
|
 +
|-
 +
| Media Previous
 +
| Home
 +
| PREVVIEW
 +
| DAYLEFT
 +
| SKIPCOMMBACK
 +
| PREVTRACK
 +
| HOME
 +
| PREVIOUSLINK
 +
| HOME
 +
|
 +
|-
 +
| Media Next
 +
| End
 +
| NEXTVIEW
 +
| DAYRIGHT
 +
| SKIPCOMMERCIAL
 +
| NEXTTRACK
 +
| END
 +
| NEXTLINK
 +
| END
 +
|
 +
|-
 +
| Search / F3
 +
| Ctrl+S
 +
| SEARCH
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
| Media Play
 +
| P
 +
|
 +
| PLAYBACK
 +
| PAUSE
 +
| PAUSE
 +
| PLAY
 +
|
 +
|
 +
|
 +
|-
 +
| Menu
 +
| M
 +
| MENU
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
| Home Page
 +
| I
 +
| INFO
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
| Back
 +
| Esc
 +
| ESCAPE
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
| EXITPROMPT
 +
|-
 +
| Tools
 +
|
 +
| SCREENSHOT
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
| Launch Mail
 +
| D
 +
| DELETE
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
| F2
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
| Backspace
 +
|
 +
|
 +
|
 +
|
 +
| STOP
 +
|
 +
|
 +
|
 +
|
 +
|-
 +
| WWW
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|
 +
|}
  
The top row of transport keys are arbitrary and can be assigned as desiredSome systems may use these keys to control a default playback system of some sort and this may need to be disabled to use the keys with MythTV. It may be desirable to leave them as is, in which case the Pause/Play key will also have to be left as is.
+
Volume and Mute keys should already be bound to MythTV Global actionsSometimes they are trapped by the desktop or something like a pulseaudio plugin and therefore don't make it to MythTV. This can be preferable as then the volume keys control the volume of all applications, not just MythTV.
  
Of the four keys to the right of the numeric keys, the one marked with four little squares generates the “F2” key which MythTV defaults to a jump point which may or may not be useful.  It can be reassigned.  The other keys are arbitrary and can be assigned as desired. The Clapperboard key works well for the “Record” mode in the Program Guide (TOGGLERECORD in the “TV Frontend” context) while the Exclamation Point key can be used for the global DELETE function. The others can be jumps to commonly used functions.
+
Clearly Tools, Launch Mail, F2 (without back-light) and WWW (without microphone) can be used for any ACTIONS you wish.  SCREENSHOT and DELETE are given as examples.
  
== Using the “Edit Keys” Function ==
 
  
The keys can be set up in MythTV by going to the “Setup” system and selecting the “Edit Keys” function.  A function can be selected and associated with a key by simply pressing the desired key.  The  interface is a bit awkward from the keyboard; the right and left arrow keys, along with Return/Enter, have to be used in the correct sequence. Navigation is more natural with the mouse but certain options do not work properly. The control keys are organized into different “contexts”, some of which are global and some of which are specific to an internal function. Start by selecting the “Global” context with the up and down arrow keys and then use the right-arrow to move to the function list. Use down-arrow to find a needed function, such as “DELETE”. The field below the list will show the currently assigned key, a “D” by default. Press the right-arrow to enter this display field and press Return/Enter. If a key is already assigned, a dialog box appears giving the options to set or remove the binding. If a conflict exists, the “remove” option can be used to clear it.  Otherwise, select “Set Binding”. A dialog displaying “Press a Key” will appear. This dialog can also be produced by a left-click on the display field but the Set/Clear dialog is not offered. Now press the key to be assigned to this function. The box will display the symbolic name assigned to this key by the system. To accept this, press right arrow twice to select the “OK” button and press Return/Enter or left-click the “OK” button. To enter a another key, press Return/Enter. “Press a Key” will return and another key (up to four) may be entered. To retain the original default value, use the keyboard to set the “D” key as an option.  It is important to retain the original keyboard options so that the program can be run from a regular keyboard if the remote control is not available. The “Set Binding” option clears the existing bindings. There does not appear to be an option to append additional keys. When all of the desired keys have been entered, press the left arrow key or the keyboard Esc key to return to the function list.  When all functions for this context have been entered, press the keyboard Esc key and a dialog will come up asking to save the entries. Select and Enter or left-click the “Save” button. The left arrow key can also be used to return to the context list and choose another context.
 
  
 
[[Category:Remote Controls]]
 
[[Category:Remote Controls]]

Latest revision as of 06:28, 20 May 2024

The original MX3 has no backlight but has more colorful keys and an F2 key.

This is an excellent all-in-one USB HID that appears to Linux and MythTV as a keyboard and mouse. It has everything we need in a remote: navigation, media control, numeric keypad, mini QWERTY and even a mouse and 5 learning IR buttons! Many features work automatically but it may be necessary to tell MythTV about the multimedia keys as detailed below.

Hardware Description

This combination of a remote control, keyboard and pointing device is a product made in China and most often listed as an MX3 model under various brands. Amazon and NewEgg are common sources. It can be recognized by its rectangular shape, the large, round “OK” button and the row of four colored buttons at the bottom of the numeric pad. It sells in the $12 to $20 range. It is a hand held device which has a good set of remote control buttons on one side and a small QWERTY keyboard on the other side. It also incorporates a gyro mouse which allows the mouse cursor to be moved by waving the unit around. It connects to the computer by a microwave (2.4 GHz) radio link to a tiny receiver which plugs directly into a USB port and sticks out only about 1/2”. It does not have to be pointed at the receiver and the signal should go through non-metallic barriers at least up to a point. The range is about 30 feet/10 meters. The Linux kernel recognizes it as a keyboard and a mouse when the receiver is connected and no system configuration or extra software is required. The keyboard and pointer work immediately but MythTV will need to be configured to use most of the remote keys, see below.

As a bonus, the unit also has an Infra-red (IR) interface with a learning function which can emulate many proprietary remote controls for other appliances. Note that this is a computer peripheral, not a universal remote. The power button and the four colored buttons at the bottom are the only ones which can generate IR outputs. It is possible to turn a TV set or sound system on and off and control a few functions such as volume levels with these buttons. It can learn from remotes that use the NEC protocol. The “TV” button is used to program this function.

If the unit is held with the remote side up, the keyboard shuts off to prevent buttons from being pressed accidentally. If the keyboard side is upwards, the mouse function shuts off so that the cursor position is not affected by moving the unit around while using it as a keyboard.

The unit has a quirk in that it shuts down if a button is not pressed for a minute or so. This obviously saves the battery but it is necessary to press any key to get it started again. In practice, this means that a key is pressed and, if nothing happens, it is pressed again. On some units (probably older ones), the mouse function comes back on when it wakes up, even if it had been turned off earlier. This is annoying if button control is preferred. Pressing and holding the mouse control button for about 5 seconds (until the LED stops flashing rapidly) seems to fix this temporarily but it comes back on at some point. Buying from a fairly high-volume dealer such as Aerb may increase the chances of getting a current unit. There seems to be some ongoing development.

There is a new version which features a back-light but it has other minor refinements and it is nicer looking as well. It is worth paying a few dollars more for this unit.

There is a magic trick to opening the battery compartment which should be in the instructions. Hold the keyboard side up and put a thumbnail into the center of the gap in the case next to the "Enter" and "Backspace" keys. The cover will pop back slightly and can then be lifted up and off. To replace it, set it in just slightly back from its closed position and make sure it is all the way down on both sides. Push it towards the keyboard to engage the latch.

Remote Key Layout

The back side is a miniature 4 row QWERTY keyboard while the front side is a remote control of Key Names in this layout:

Backlight versions exist in white or RGB. The F2 key is replaced by the backlight toggle button.
[Power]
Media Rewind Media Fast Forward Media Previous Media Next
Search / F3 Media Play zoom+ zoom-
Menu Home Page Back
(3)
Up
Left Return
(1)
Right
Down
Volume Up PgUp
Volume Down Mute (mouse) PgDown
1 2 3 Tools
4 5 6 Launch Mail
7 8 9 F2 / light
[TV] 0 Backspace WWW / Mic
[red] [green] [yellow] [blue]

The keys in red [brackets] are programmable Infrared except for [TV] which is used to program the 5 others from an IR remote. These keys can be used for powering on the TV or a sound bar or adjusting its volume. Per the manual, only the NEC protocol is supported.

The (mouse) button toggles the air mouse. When on, the center "Return" button becomes mouse button(1) while "Back" becomes mouse button(3).

The zoom buttons are not available to Linux by default. F2 is a light toggle on the backlight models. WWW is a speak button on the microphone models, probably not useful to MythTV. The rest of the keys are available to MythTV with the names given in the table.

Edit Keys

All keys not listed below should already work as they are also found on all standard keyboards. As MythTV predates the newer Media keys, these may not work by default. With some patience we can bind all available keys to work well as in the table shown here.

In MythTV's Setup menu select "Edit Keys". Use the arrow keys to navigate to a "Context" column and "ACTION" below. Then right arrow to an unused key binding slot (to preserve all current keys) and hit Enter. Then hit the remote key from column 1 and Enter to save it or Escape to cancel. Move left to return to the ACTION/context and work on more entries from the grid. Upon Escaping out, be sure to save the changes!

Remote Key act
like
Global TV Frontend TV Playback Music Gallery /
Images
Browser Video Main Menu
Media Rewind < PREVIOUS PAGELEFT RWNDSTICKY RWND ZOOMOUT ZOOMOUT
Media Fast Forward > NEXT PAGERIGHT FFWDSTICKY FFWD ZOOMIN ZOOMIN
Media Previous Home PREVVIEW DAYLEFT SKIPCOMMBACK PREVTRACK HOME PREVIOUSLINK HOME
Media Next End NEXTVIEW DAYRIGHT SKIPCOMMERCIAL NEXTTRACK END NEXTLINK END
Search / F3 Ctrl+S SEARCH
Media Play P PLAYBACK PAUSE PAUSE PLAY
Menu M MENU
Home Page I INFO
Back Esc ESCAPE EXITPROMPT
Tools SCREENSHOT
Launch Mail D DELETE
F2
Backspace STOP
WWW

Volume and Mute keys should already be bound to MythTV Global actions. Sometimes they are trapped by the desktop or something like a pulseaudio plugin and therefore don't make it to MythTV. This can be preferable as then the volume keys control the volume of all applications, not just MythTV.

Clearly Tools, Launch Mail, F2 (without back-light) and WWW (without microphone) can be used for any ACTIONS you wish. SCREENSHOT and DELETE are given as examples.