FX-Framework Custom IR Remote Guide
Requires Morph 4K or Morph 2K
The Morph can be controlled with a different IR remote than the one it ships with, as long as the remote uses the NEC IR protocol (used by many remotes, and by most universal remotes for at least some device codes).
Which button triggers which function is stored in an ir.ini file, which can be uploaded via the web interface:
-
Refer to PFX-WebUI for how to connect to the web interface.
-
The
Custom IR Remote (ir.ini)card is on theCustomizepage of the web interface.
Finding the codes of your remote#
-
Press
Start IR debugon theCustom IR Remote (ir.ini)card and wait until the badge next toIR DebugshowsConnected. -
Point the remote at the Morph and press a button. The window shows the
Addressand theCommandof that button. -
Write down the
Commandof every button you want to use. TheAddressis usually the same for all buttons of a remote.
If nothing shows up, the remote does not use the NEC protocol and cannot be used with the Morph. On a universal remote, try a device code of a different brand.
Format#
The mapping is stored in an .ini file, which has the following format:
address = ADDRESS
FUNCTION = COMMAND
-
ADDRESSandCOMMANDare the values shown byIR debug, including the0xprefix (e.g.0xfe01). -
An
addressline applies to allFUNCTIONlines below it, up to the nextaddressline. This way oneir.inican hold the buttons of several remotes (see Example 3). -
Lines starting with
;or#are comments.
Functions (FUNCTION)#
-
command_menuOpen the OSD (inside the OSD: back) -
command_okSelect / confirm inside the OSD (with the OSD closed: open the OSD) -
command_cancelBack / close the OSD -
command_up/command_down/command_left/command_rightNavigate the OSD. With the OSD closed, these open the quick menus:- Morph 4K: up: input, down: output resolution, right: presets
- Morph 2K: up: presets, down: output resolution, left: input, right: scaler
-
command_minus/command_plusChange the selected value in steps of 10 (on OSD pages where values are changed with left / right). In the main menu,command_minusopens the reset menu. -
command_setup/command_appExtra function keys, used by some OSD pages -
command_setOpen the presets (with the OSD closed) (Morph 2K only) -
command_res_resetReset the selected value to its default (on OSD pages that support it). Hold the button for about 5 seconds to reset the output resolution to the default, e.g. when the display does not show a picture. -
command_powerPower the Morph down / up -
command_muteMute / unmute the HDMI audio -
command_a_volume_up/command_a_volume_downAudio volume up / down (if the audio hardware of the Morph supports it) -
command_num_0...command_num_9Trigger what is assigned to that number, e.g. a preset (OSD: select a preset inPresets, thenMap preset to remote). The assignments are stored in/sdcard/conf/remote.ini. -
command_captureSave a screenshot of the picture to the SD card, press again to cancel (Morph 4K only) (requires fw >= 4.0.79) -
command_capture_inputSave an input capture (the source frame as received, before scaling) to the SD card (Morph 4K only, engines with input capture, e.g. Universal Adaptive) (requires fw >= 4.0.79) -
command_auto_zoomZoom the picture inside the frame to the full screen height, until the source changes (Morph 4K only) (requires fw >= 4.0.84) -
command_ovrscn_cTurn the overscan border color on / off
Important#
-
An uploaded
ir.inireplaces the built-in one. Buttons that are not in your file do nothing, including the buttons of the remote that ships with the Morph. To keep using that remote, keep its lines in your file (see Example 3). -
A new
ir.iniis used right after the upload, no restart needed.Deleteon the card removes it, and the built-in setup is used again. -
Download ir.inion the card downloads your uploaded file, or an example if none was uploaded.
Example 1 (default setup)#
The built-in setup for the remote that ships with the Morph:
; # Standard remote
address = 0xfe01
command_menu = 0xee11
command_ok = 0xec13
command_cancel = 0xe619
command_capture = 0xb34c
command_capture_input = 0xa758
command_auto_zoom = 0xff00
command_up = 0xe916
command_down = 0xe51a
command_left = 0xae51
command_right = 0xaf50
command_minus = 0xef10
command_plus = 0xe718
command_setup = 0xbc43
command_app = 0xf00f
command_res_reset = 0xbd42
command_power = 0xbf40
command_a_volume_up = 0x0af5
command_a_volume_down = 0x0bf4
command_mute = 0xbe41
command_set = 0x0df2
; numeric buttons
command_num_0 = 0xfe01
command_num_1 = 0xb14e
command_num_2 = 0xf20d
command_num_3 = 0xf30c
command_num_4 = 0xb54a
command_num_5 = 0xf609
command_num_6 = 0xf708
command_num_7 = 0xb946
command_num_8 = 0xfa05
command_num_9 = 0xfb04
Example 2 (OSSC remote)#
Only the OSSC remote, the remote that ships with the Morph no longer works:
; # OSSC
address = 0x837c
command_menu = 0x4db2
command_ok = 0x47b8
command_cancel = 0x48b7
command_up = 0x4bb4
command_down = 0x4cb3
command_left = 0x4ab5
command_right = 0x49b6
Example 3 (standard remote + Framemeister remote)#
Both remotes work: add these lines at the end of Example 1:
; # Framemeister
address = 0xff00
command_menu = 0xab54
command_ok = 0xfc03
command_cancel = 0xac53
command_up = 0xf30c
command_down = 0xef10
command_left = 0xf708
command_right = 0xfb04
Tip#
-
Always start the file with an
addressline. -
Each button can only trigger one function. If the same
address/COMMANDpair is listed twice, the first line is used. -
To disable a button, remove its line or turn it into a comment:
; command_power = 0xbf40
