View source for Importing Foreign IR Remotes in RemoteMaster

= Importing Foreign IR Remotes in RemoteMaster =

''This guide will take the reader through a method for importing foreign (i.e. non-JP1) IR remotes into RemoteMaster.''
''The procedure requires some knowledge by the user, who have to make some manual decisions. The guide is not aimed at beginning users. Some prior knowledge about RemoteMaster and IrScrutinizer is assumed. Also, importing raw or unknown codes are not covered.''

= Ultra-short version =

* Perform an "RemoteMaster" export from IrScrutinizer 1.3 (or later) to a temporary file,
* Open the above created file in RemoteMaster. Select a usable executor manually. Perform other desired fixes.

= History =

The previous version of this article described a faily "dumb" method of exporting a Girr file from IrScrutinizer to a stripped-down RemoteMaster rmdu file, using a effectively empty, dummy executor called "ImportOnly". This is imported in RemoteMaster, after which the user has to chose the executor manually. 
The previous version can be access through the Wiki history function, or directly [http://www.hifi-remote.com/wiki/index.php?title=Importing_Foreign_IR_Remotes_in_RemoteMaster&oldid=880 here].

Since then, amazing work has been done in RemoteMaster on importing foreign IR signals, or more exactly, mapping the foreign protocols on the JP1's executors. Accordingly, Girr files can be imported directly, which makes the importing procedure almost automatic.

= Introduction =

The Internet is a vast source of infrared code sets, see for example [http://harctoolbox.org/IR-resources.html this list].
For usage with RemoteMaster ("RM"), this information is in general not directly usable. 
Often, usable RM device update files ("rmdu") can be found in the
[http://www.hifi-remote.com/forums/dload.php?action=category&cat_id=4 JP1 device update repository]  (see also
[http://www.hifi-remote.com/forums/dload.php?action=file&file_id=8487 the master list] and 
[http://www.getzweb.net/jp1/ the lookup tool]).
But still some cases remain; in particular self captured ("learned") remotes. 

Of course, one way to solve the problem would be to manually type the signals
(protocol, parameters, name, possible comment) in the function editor of RM, possibly the help of cut-n-paste.
This is a very tedious and error prone approach.
Importing these in a systematic way, with minimal interaction, is the topic of the current article.

= Solution =

The [http://www.harctoolbox.org/Girr.html Girr format for IR signals] is an open and very versatile format for collections of IR signals. These can be parametrized, or in raw format. It is an XML based format.

First, acquire or generate a suitable Girr file. [IrScrutinizer_Guide IrScrutinizer] can generate such files, either by (using a suitable hardware receiver) "learning" an available physical remote, or by importing/converting from other format. (See the example below).

This file is then imported into RMDU, by "Open"-ing them. (See pictures in the next section). If the Girr file contains more than one remote, the useer is required to select one of them. In rare cases, the user is requested to select between several possible alternative executors.  Although the import almost always succeeds, in rare cases it may fail. The import should be checked for plausibility. Assign the keys to functions, and make other desired fixes. The thus created device update can now be used as any other update.

Importing remotes is still a quite complicated process. Limitations (for example by "uncommon" protocols, or if signals from several substantially different protocols are present), and in rare cases even bugs, may show up. In this case, please report in the forum.

= Example =
We consider the Oppo BDP 103 BluRay player, which has a [http://download.oppodigital.com/BDP103/BDP-103_BDP-105_Remote_Code_v1.1.xls published set of IR commands].
(The [http://www.hifi-remote.com/wiki/index.php?title=IrScrutinizer_Guide#Importing_.22text.22_files IrScrutinizer Tutorial]
describes how such files can be imported into IrScrutinizer.) Here we show the import from a csv file:

[[Image:Screenshot%20from%202022-05-14%2022-16-25.png]]

We now assume that this command set has been imported in IrScrutinizer, see the screenshot below.
Note that every row denotes a command, has a name, a protocol, and one or more parameters. A comment may describe the command further.


[[Image:Screenshot%20from%202022-05-14%2021-54-01.png]]


Typically, the protocol and all but one parameter, in general called "F", are constant. 
Here, the protocol is "NEC1", D = 73, and S is "nonexistent".
Having inspected this table, and made
any desirable changes, the table is exported,

This is exported by selecting the "Export" pane, selecting "Girr" as the Export format, checking "Parameters" and pressing "Export param. remote".
This creates a girr file.

After starting RMDU, the just-created simple girr file is imported through File -> Open.

[[Image:rm_opening_file.png]]

Next screenshot shows RMDU after the import:

[[Image:Screenshot%20from%202022-05-14%2021-32-52.png]]

Now, select the "Functions" pane, and check the sanity of its content, in particular hex- and OBC values.

[[Image:Screenshot%20from%202022-05-14%2021-33-56.png]]


The import has been successful! It now remains to tune the device update (rmdu) to your needs:
adjusting description, notes, device type as desired, select setup code and the target remote, assigning the functions to its buttons, saving the
file to a suitable name, etc.
This is outside of the scope of this article, and described in detail the RM documentation.

= Support and help =

Please post help requests in the forum.

Suggestions for improvements, both of the procedure here described, and of the present document,
are solicited.