Repository files navigation

Integration an Hisense TV as media player into Home Assistant. The communication is handled via the integrated MQTT broker and wake-on-LAN.Requires Home Assistant >=2021.12.x.

• Turn on / off
• Display current status
  • Source (TV, HDMI, Apps)
  • Channel name / number
  • EPG data of current show
• Volume control
• Media browser
  • LNB selector
  • Channel selector
  • Apps
• Read picture setting

TBD:

• Expose ON/OFF as switch
• Expose all keys as buttons
• Enhance EPG/guide handling

The TV provides a MQTT broker on port36669. Home Assistant can only communicate with one MQTT broker, so you have to create a bridge between the two broker.

The MQTT broker is secured by credentials. Some TVs (like mine) even require client certificates for incomming connections. I won't include them in this repo, but you can find them online or extract them yourself. SeeAcknowledgment.

Connection shema:

+-----------+          +-----------+| Home      |  client  | Mosquitto || Assistant |--------->|           |+-----------+          +-----------+                            /\                     bridge ||                            \/                      +-------------+                      | Hisense TV  |                      | MQTT Broker |                      +-------------+

Themosquitto bridge configuration using client certificates.

connection hisenseaddress <TV_IP_ADDRESS>:36669username <HISENSE_MQTT_USERNAME>password  <HISENSE_MQTT_PASSWORD>clientid HomeAssistantbridge_tls_version tlsv1.2bridge_cafile hisense_ca.pembridge_certfile hisense_client.pembridge_keyfile hisense_client.keybridge_insecure truestart_type automatictry_private truetopic /remoteapp/# both 0 <MQTT_PREFIX> ""

Replace<TV_IP_ADDRESS>, credentials and<MQTT_PREFIX> according to your setup. The<MQTT_PREFIX> is needed if you have multiple TVs, otherwise you should just use the defaulthisense:

topic /remoteapp/# both 0 hisense ""

(Optional) If you have multiple TVs you have to replicate the whole configuration for each TV.The<MQTT_PREFIX> must be unique for every TV. For example:

topic /remoteapp/# both 0 livingroom_tv ""

topic /remoteapp/# both 0 kids_tv ""

(Optional) This setup uses the same prefix for incoming and outgoing messages. The integration supports separated values. You have to adapt the topic setup accordingly.

The TV can be turned on by a Wake-on-LAN packet. The MAC address must be configured during integration setup.

The integration can be added via the Home Assistant UI. Add the integration and setup your TV. During the first setup your TV should be turned on. The integration requires a PIN code from you TV. The PIN will be triggered automatically during setup. This is a onetime step where the clientHomeAssistant is requesting access to remote controll the TV.

Tested on anHisense A71 Series with mandatory client certificates.gettvstate does not return astate but can be used to authenticate the client.The

Everything I needed to write this integration could be gathered from these sources. Information about the MQTT topics, credentials or certificates can be found there.

• @Krazy998's mqtt-hisensetv
• @newAM's hisensetv_hass
• HA Community
• RemoteNOW App
• @d3nd3