H200 Managing IR Receiver

Introduction

This document outlines the available methods for enabling or disabling the IR receiver on the H200 set-top box. This feature may be useful in a number of scenarios, such as:

1. When multiple set-top boxes are deployed in close proximity and it is necessary to control which device responds to IR signals.

2. When IR control needs to be disabled on set-top boxes that have been set up for signage purposes.

Method 1 :- Manage IR receiver with system parameter

The system parameter system.ir_control.enable manages the IR receiver state. This parameter may be read-in during boot and sets the IR receiver status.

If the set-top box is boot with VCI, add system.ir_control.enable to the h200_entone_boot.ini file. Set the value to true to enable IR receiver or false to disable IR receiver.

Example : Adding the setting to disable IR receiver to the h200_entone_boot.ini file

system.ir_control.enable = false

If the set-top box is boot with Orchestrate, select ON from the dropdown menu to enable IR receiver or select OFF from the dropdown menu to disable IR receiver. 

Example : Adding the setting to disable IR receiver to the Orchestrate group.

 

Method 2 :- Manage IR receiver with EELM API

Enable Enterprise Local Management (EELM) is a configurable management service which supports a small set of operations accessible via a REST API. EELM is disabled by default on H200 set-top box, please read H200 Enable Enterprise Local Management (EELM) Server and enable EELM on your H200 set-top box before proceeding to the next paragraph.

Following EELM APIs manage system.ir_control.enable in real-time, allowing the user to check, enable or disable IR receiver on a specified H200 set-top box.

To confirm IR recevier status on the H200 set-top box, use the following API:

curl -v -X GET http://<Set-top box IP>:8090/api/v2/input/irControl

Example: Checking the status of IR receiver on set-top box with IP 10.0.35.209 and IR receiver is enabled.

# curl -v -X GET http://10.0.35.209:8090/api/v2/input/irControl
* Hostname was NOT found in DNS cache
* Trying 10.0.35.209...
* Connected to 10.0.35.209 (10.0.35.209) port 8090 (#0)
> GET /api/v2/input/irControl HTTP/1.1
> User-Agent: curl/7.35.0
> Host: 10.0.35.209:8090
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Thu, 19 Jan 2023 07:45:45 GMT
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Methods: *
< Content-Type: application/json;charset=utf-8
< Content-Length: 19
* Server Jetty(9.4.35.v20201120) is not blacklisted
< Server: Jetty(9.4.35.v20201120)
<
{"ircontrol":true}
* Connection #0 to host 10.0.35.209 left intact

To enable IR receiver on the H200 set-top box, use the following API:

curl -v -X PUT -d ' {"enable": true}' http://<Set-top box IP>:8090/api/v2/input/irControl

Example: Enable IR receiver on set-top box with IP 10.0.35.209

# curl -v -X PUT -d ' {"enable": true}' http://10.0.35.209:8090/api/v2/input/irControl
* Hostname was NOT found in DNS cache
* Trying 10.0.35.209...
* Connected to 10.0.35.209 (10.0.35.209) port 8090 (#0)
> PUT /api/v2/input/irControl HTTP/1.1
> User-Agent: curl/7.35.0
> Host: 10.0.35.209:8090
> Accept: */*
> Content-Length: 17
> Content-Type: application/x-www-form-urlencoded
>
* upload completely sent off: 17 out of 17 bytes
< HTTP/1.1 200 OK
< Date: Thu, 19 Jan 2023 07:45:43 GMT
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Methods: *
< Content-Type: application/json;charset=utf-8
< Content-Length: 0
* Server Jetty(9.4.35.v20201120) is not blacklisted
< Server: Jetty(9.4.35.v20201120)
<
* Connection #0 to host 10.0.35.209 left intact

To disable IR receiver on the H200 set-top box, use the following API:

curl -v -X PUT -d ' {"enable": false}' http://<Set-top box IP>:8090/api/v2/input/irControl

Example: Disable IR receiver on set-top box with IP 10.0.35.209

# curl -v -X PUT -d ' {"enable": false}' http://10.0.35.209:8090/api/v2/input/irControl
* Hostname was NOT found in DNS cache
* Trying 10.0.35.209...
* Connected to 10.0.35.209 (10.0.35.209) port 8090 (#0)
> PUT /api/v2/input/irControl HTTP/1.1
> User-Agent: curl/7.35.0
> Host: 10.0.35.209:8090
> Accept: */*
> Content-Length: 18
> Content-Type: application/x-www-form-urlencoded
>
* upload completely sent off: 18 out of 18 bytes
< HTTP/1.1 200 OK
< Date: Thu, 27 Apr 2023 10:24:33 GMT
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Methods: *
< Content-Type: application/json;charset=utf-8
< Content-Length: 0
* Server Jetty(9.4.35.v20201120) is not blacklisted
< Server: Jetty(9.4.35.v20201120)
<
* Connection #0 to host 10.0.35.209 left intact