Joined: 22 Jul 2008
Location: Cambridge, UK
|Posted: Sun Oct 20, 2019 11:46 am Post subject: RM/RMIR v2.09 available
|RM/RMIR v2.09 is now officially released.. This first release is build 6 as the first five builds were for development purposes. This is a major new version, incorporating IrpTransmogrifier by Bengt Martensson (Barf), and results from a cooperative effort with Bengt to whom I am very grateful. IrpTransmogrifier is now the default decoder for learned signals, though DecodeIR is still available through the menu item Options > Set IR Decoder. There is a new menu item Help > IrpTransmogrifier Protocols that provides documentation for IrpTransmogrifier that is equivalent to that for DecodeIR at Help > Interpreting Decoded IR Signals, which is still retained. Command files irptransmogrifier.bat (for Windows) and irptransmogrifier.sh (for Linux and Mac OS X) are provided for command-line access to IrpTransmogrifier itself from the RMIR installation folder, equivalent to those of the same names in a stand-alone installation of IrpTransmogrifier.
As a result of this change, a set of learned signals can now be converted to a device upgrade at the push of a button. There is a button Convert to Device Upgrade on the Learned Signals tab that does this. The intention is that almost all conversions of learned signals to device upgrade that can be performed manually can now be done through this automated process. This has become possible through entries in the protocol database of IrpTransmogrifier that link to entries in the RMIR file protocols.ini.
The supported platforms are 32-bit and 64-bit Windows, Linux and Mac OS X, together with experimental support for Raspberry Pi. This version now requires Java 8 or later, as that is the minimum Java requirement for support of IrpTransmogrifier. It supports all currently known types of UEI remotes, including XSight and Simpleset remotes. UEI has recently closed down the EZ-RC.com website that provided support for XSight and similar remotes. RM/RMIR provides complete replacement support for these remotes, including the ability to upgrade the firmware to the last version that UEI issued. XSight users new to RMIR, especially ones who have been directed here from the legacy page at EZ-RC.com, should read the Wiki article Getting started with XSight and Nevo for further information.
No special action is needed to perform a firmware upgrade on an XSight remote. Just do a download in the usual way. If a firmware upgrade is available it will be offered. You may install it or not, at your choice, and if you choose not to install it, you are given the opportunity not to be offered the upgrade again in future.
The XSight and Simpleset remotes are supported by RMIR directly via their USB interface, without the need for any cable other than the USB lead supplied with the remotes. Other remotes are supported through their JP1 6-pin connector with JP1.x interface cables that use an FTDI chip. These cables are also available with a Prolific chip instead of the FTDI one, but many remotes will not work with these cables. More information on this is given below. It is strongly advised that you use a cable with a genuine FTDI chip - there are also cables with counterfeit FTDI chips on the market and these too will often not work.
Remotes that support the Bluetooth UEI phone app can access RMIR through their Bluetooth interface, in several ways. All supported OS platforms can use the BLED112 Bluetooth dongle, currently available for $10.45 in the US or for GBP8.52 (UK 8 pounds 52 pence) in Europe. Windows users have two additional access methods. One uses the Bluetooth stack that is built in to Windows 10, but the remote needs v2.00 of the Bluetooth extender installed and this installation requires a one-off use of a JP1.x cable. The other is available both for Windows 10 and some earlier Windows versions (but so far only tested on Windows 8.1) and does not require this use of a JP1.x cable, but needs the installation of the BlueSoleil Bluetooth stack. See the Bluetooth thread Bluetooth is coming to RMIR for more details.
This first release build of RM/RMIR v2.09 is available only as a full installation package but subsequent builds will be issued both as a full package containing everything required and as an update package that contains only those files changed since this initial release. To upgrade from v2.08 without losing your settings, delete everything in your installation folder other than the RemoteMaster.properties file that contains your settings. Then unzip the new installation package into that folder and you are done. Alternatively, if you wish to keep your v2.08 installation and port your settings to v2.09, follow the full installation instructions below and then copy the RemoteMaster.properties file from your v2.08 installation to this new one.
The RMIR menu item Help > Check for updates checks for new builds as well as new versions. If a new build or version is available then this menu item displays a message containing a hyperlink that will take you straight to the available downloads for the update. To upgrade to a new build, just unzip the upgrade package into the installation folder for any earlier build of the same version, overwriting any files of the same name. Upgrade packages are cumulative, so it is not necessary to install each upgrade in turn.
To install the full package afresh, for any OS first unzip it to a new folder that is not read-only. For a Windows OS this means, in particular, that it should not be unzipped into a subfolder of the Program Files folder. After unzipping the package, do the appropriate one of the following:
With all three OS's, RMIR can be opened without using a shortcut by double-clicking or otherwise running the Java file RemoteMaster.jar. RM can be opened from RMIR with the menu item File > New > Device Upgrade and RMPB with the menu item File > New > Protocol. The instances of RM or RMPB so opened are independent of the RMIR instance from which they are opened, so you can then close RMIR and leave RM or RMPB open if you wish. RM can also be opened from a command line by running RemoteMaster.jar with an argument -rm and RMPB with an argument -pb. Please note that although it is optional to run Setup.vbs in Windows as RMIR, RM and RMPB can always be opened in these ways, in Linux you need either to run Setup.sh or to use some other means to add your user id to the dialup group of users. This need only be done once ever, however, as it is a system setting that is not specific to the RemoteMaster program.
- If your OS is Windows then run Setup.vbs by double-clicking or otherwise. This will create three shortcuts, one each for RMIR and RMPB and the third (named Remote Master) for RM. They will be created in your installation folder, but they are also copied to Start > All Programs > Remote Master if you are running a Windows version that has a Start menu. You may copy them to your desktop, or any other location, as you wish. Setup.vbs also creates file associations to open .rmir files in RMIR, .rmdu files in RM and .rmpb files in RMPB.
- If your OS is Linux then run Setup.sh from Terminal as a shell script. If the current directory in Terminal is the RemoteMaster installation directory then the command "sh Setup.sh" will run the script. It creates three .desktop shortcuts, one each for RMIR and RMPB and the third (named RemoteMaster) for RM. They will be created in your installation folder, but they are also copied to your $HOME/.local/share/applications folder to ensure that they appear on your Dash. Setup.sh will also add you to the dialout group of users, if you are not already in it. If you need to be added, then it will ask you for your sudo password as this step needs to be run with root privileges. This step is needed to enable RMIR to access USB serial ports without RMIR itself being run as root.
The distribution also contains a text file linux_xsight.rules. If you have an XSight or Nevo remote, you may need to copy this to the directory "/etc/udev/rules.d/". It may be re-named if desired, provided the extension .rules is kept. This file provides a user-friendly name for the XSight as a USB device. Some users have found that Linux systems cannot find the XSight/Nevo remote unless RM/RMIR is run as root, even after running Setup.sh, unless this file is present.
- If your OS is Mac OS X then there is as yet no special installation procedure.
A few remotes have an external 5-hole connector rather than the 6-pin connector in the battery compartment that is common in UEI remotes. These need an adapter to convert the 5-hole connector to the standard 6-pin one. Detailed instructions for making such an adapter are given here. Remotes that use a Maxim processor can all be connected with a standard JP1.2/3 interface cable but only one that uses the FTDI chip. Cables with chips of other manufacturers such as Prolific have difficulty communicating with the Maxim processors. This is discussed in some detail in this thread. The most recent processor used by UEI is from Texas Instruments. These can certainly be connected by JP1.2/3 cables with the FTDI chip. The situation with other chips is not yet known. These remotes can also be connected through their Bluetooth interface as described above.
When using XSight remotes (and similar ones such as Nevo) with Windows 8.1 and Windows 10, Enhanced Power Management needs to be disabled for the USB port concerned. RMIR v2.09 checks for this and displays a message saying exactly what Windows registry setting needs to be changed if it finds that this setting is still enabled. There is also an item "Enhanced Power Management info" under the RMIR Help menu that provides further information on this.
RMIR is available only as a Java file. Version 2.09 requires a Java 8 or later runtime environment, either 32-bit or 64-bit. Versions from 2.04 through 2.08 required Java 7 or later, version 2.03 and earlier only required Java 6. The release package includes the following support files:
An update to any of these files will result in a new build being released, so there is no need for separate updating of any of them. Version 4 of the RDF File Specification covers RDF files for remotes with interfaces up to JP1.3. Version 5 is required to support remotes with interfaces from JP1.4 onward. Version 5 is under continuous review as UEI remotes with new features are discovered, with revisions of the Addendum being issued as required.
- DecodeIR v2.45 as library files for Windows (32-bit and 64-bit), Linux and Mac OS X.
- jp12serial v0.24 as library files for Windows (32-bit and 64-bit), Linux, Mac OS X and Raspberry Pi.
- digitmaps.bin with digit maps up to number 729.
- protocols.ini which is a database of protocol executor data.
- RMIR.sys that contains the data needed by RMIR to perform firmware upgrades of the XSight remotes.
- The RDF File Specification, Version 4.
- The RDF File Specification, Version 5 as revision 12 of an Addendum to Version 4.
Please visit the JP1 Community Wiki for information about how to use RMIR. A link to the Tutorial in the Wiki is also included in the Help menu. Please note that as this project is supported solely by volunteers, the Wiki may not be up to date. This version of RM/RMIR contains many new features required to support the newer types of remote. At the time of its release, these are not covered by the help files contained in the Wiki. RM/RMIR itself, however, shows notes and tooltips (the text shown when you hover the mouse pointer over a button or table entry) designed to make its use as self-explanatory as possible.
The download package is available in the following folder. Just click on it to start the download. The corresponding folder for future builds will contain both the full and upgrade packages.
Please see above for installation instructions.
The RemoteMaster project home page.
JP1 Community Wiki
Tutorial (part of the Wiki)
Getting started with XSight and Nevo (also part of the Wiki)
Nevo and XSight Remotes (thread specific to these remotes)
Bluetooth is coming to RMIR (announcement thread for the new Bluetooth interface)
RMIR XSight Support (development thread)
RMIR Simpleset Support (development thread)
RemoteMaster on Raspberry Pi with Raspian (development thread)
RMIR: Prototype IR function in RM (development thread)
IrpTransmogrifier: new program/library for IRP protocols (development thread for IrpTransmogrifier)
RM/RMIR v2.08 available (announcement thread for last official version)
ChangeLog.txt (also included in the installation package)