homebridge-lg-netcast

homebridge-lg-netcast

Homebridge plugin for interacting with LG Netcast-based TVs (2012, 2013)

Warning: This is very much a proof of concept to get my TV working. It might work for you, and it might also not.

• Installation
• Setup
• Configuration
  • Regarding channels
  • Example config
• Caveats
  • Turning on the TV
  • Switching between HDMI and TV
• What is working
• ETC

Installation

npm install -g homebridge-lg-netcast

Setup

To pair with the TV, you need to get it to display a valid access token. If you leave out the access_token key it should prompt it for you.

This repository also comes with a netcast-cli helper tool that you can use to query the TV. Not specifying anything will prompt the access token / pair code:

netcast-cli --host 192.168.1.14:8080

Note: The default port is :8080, make sure you specify that.

Configuration

Add the platform to your config.json:

• name: Name of the accessory
• host: IP + Port of your TV
• mac: Mac address of the TV (currently unused)
• accessToken: Pair code of the TV
• keyInputDelay: Delay in ms to wait before issuing repeated key presses (such as switching input source)
• offPauseDuration: Delay in ms to pause polling for TV status after turning off. This is needed because the TV still responds to channel query requests when it has been turned off
• channels: List of channels that are available

Regarding channels

To identify the current channel, use the netcast-cli helper tool:

❯ netcast-cli --host 192.168.1.14:8080 --access_token xxxxx
Querying current channel
{
  chtype: 'terrestrial',
  sourceIndex: '1',
  physicalNum: '21',
  major: '81',
  displayMajor: '81',
  minor: '65535',
  displayMinor: '-1',
  chname: 'フジテレビ',
  progName: 'ザ・ノンフィクション　たたかれても　たたかれても…　〜山根明と妻のその 後〜',
  audioCh: '0',
  inputSourceName: 'TV',
  inputSourceType: '0',
  labelName: {},
  inputSourceIdx: '0'
}

Important notes here are:

For HDMI devices: Specify only inputSourceType and inputSourceIdx. Set type to "hdmi", this is very important!

For channels: Specify type = "tuner" and the following keys:

"sourceIndex": "1",
"physicalNum": "25",
"major": "41",
"minor": "65535",
"inputSourceType": "0",
"inputSourceIdx": "0"

Example config

 "platforms": [
        {
            "platform": "LgNetcast",
            "name": "LGPlatform",
            "accessories": [
                {
                    "accessory": "LgNetcastTV",
                    "name": "TestTV",
                    "host": "192.168.1.14:8080",
                    "mac": "cc:2d:8c:a4:4a:d6",
                    "accessToken": "xxxxx",
                    "keyInputDelay": 600,
                    "offPauseDuration": 600000,
                    "channels": [
                        {
                            "name": "AppleTV",
                            "type": "hdmi",
                            "channel": {
                                "inputSourceType": "6",
                                "inputSourceIdx": "3"
                            }
                        },
                        {
                            "name": "Chromecast",
                            "type": "hdmi",
                            "channel": {
                                "inputSourceType": "6",
                                "inputSourceIdx": "4"
                            }
                        },
                        {
                            "name": "Nihon TV",
                            "type": "tuner",
                            "channel": {
                                "sourceIndex": "1",
                                "physicalNum": "25",
                                "major": "41",
                                "minor": "65535",
                                "inputSourceType": "0",
                                "inputSourceIdx": "0"
                            }
                        },
                    }
                }
            ]
        }

Caveats

Turning on the TV

This is not supported. It's just not possible through the Netcast API nor wakeonlan, so as a workaround, use automations and HDMI CEC through LG Simplink. Turning the TV on itself won't do anything except setting the TV state to "on".

For example, use an AppleTV or Chromecast, and turn it on when the TV state turns to "on". (I personally use homebridge-apple-tv-remote and turn the ATV on when my TV turns on.)

Switching between HDMI and TV

This is also not supported through the Netcast API. The workaround that this plugin uses is to manually open the input source menu, then physically clicking LEFT/RIGHT, then hitting "OK". That's also why the inputSourceIdx key is needed for everything.

To change the interval in which keys are being issued, change the keyInputDelay config key. For my TV the UI loads really slow, so I had to set it between 600 - 1000ms.

What is working

• Turning the TV off
• Switching channels
• Displaying current channel
• Switching between HDMI/TV through the workaround above
• Controlling the TV through the remote API
• Changing volume

ETC

Powered by https://github.com/dvcrn/lg-netcast