mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-18 23:06:58 +00:00
Update config to new Samsung TV integration (#11616)
* update config * add wol example * move WOL example to separate chapter * Update samsungtv.markdown * Update ssdp.markdown * Update samsungtv.markdown
This commit is contained in:
parent
a27cbc7cae
commit
056db4e679
@ -6,6 +6,7 @@ ha_category:
|
|||||||
- Media Player
|
- Media Player
|
||||||
ha_release: 0.13
|
ha_release: 0.13
|
||||||
ha_iot_class: Local Polling
|
ha_iot_class: Local Polling
|
||||||
|
ha_config_flow: true
|
||||||
ha_codeowners:
|
ha_codeowners:
|
||||||
- '@escoand'
|
- '@escoand'
|
||||||
---
|
---
|
||||||
@ -14,49 +15,57 @@ The `samsungtv` platform allows you to control a [Samsung Smart TV](https://www.
|
|||||||
|
|
||||||
### Setup
|
### Setup
|
||||||
|
|
||||||
|
Go to the integrations page in your config and click on new integration -> Samsung TV.
|
||||||
|
If you have enabled [ssdp](/integrations/ssdp) discovery and your TV is on, it's likely that you just have to confirm the detected device.
|
||||||
|
|
||||||
When the TV is first connected, you will need to accept Home Assistant on the TV to allow communication.
|
When the TV is first connected, you will need to accept Home Assistant on the TV to allow communication.
|
||||||
|
|
||||||
### Configuration
|
### YAML Configuration
|
||||||
|
|
||||||
To add a TV to your installation without relying on the [discovery component](/integrations/discovery/), add the following to your `configuration.yaml` file:
|
YAML configuration is around for people that prefer YAML.
|
||||||
|
To use a TV add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
media_player:
|
samsungtv:
|
||||||
- platform: samsungtv
|
- host: IP_ADDRESS
|
||||||
host: IP_ADDRESS
|
|
||||||
```
|
```
|
||||||
|
|
||||||
{% configuration %}
|
{% configuration %}
|
||||||
host:
|
host:
|
||||||
description: "The IP of the Samsung Smart TV, e.g., `192.168.0.10`."
|
description: "The hostname or IP of the Samsung Smart TV, e.g., `192.168.0.10`."
|
||||||
required: true
|
required: true
|
||||||
type: string
|
type: string
|
||||||
port:
|
port:
|
||||||
description: The port of the Samsung Smart TV. If set to 8001, the new websocket connection will be used (required for 2016+ TVs) - for installs other than Hass.io or Docker you may need to install a Python package, see below.
|
description: The port of the Samsung Smart TV. If set to 8001, the new websocket connection will be used (required for 2016+ TVs) - for installs other than Hass.io or Docker you may need to install a Python package, see below.
|
||||||
required: false
|
required: false
|
||||||
type: integer
|
type: integer
|
||||||
default: 55000
|
default: automatically detected
|
||||||
name:
|
name:
|
||||||
description: The name you would like to give to the Samsung Smart TV.
|
description: The name you would like to give to the Samsung Smart TV.
|
||||||
required: false
|
required: false
|
||||||
type: string
|
type: string
|
||||||
timeout:
|
turn_on_action:
|
||||||
description: The timeout for communication with the TV in seconds.
|
description: "Defines an [action](/docs/automation/action/) to turn the TV on."
|
||||||
required: false
|
required: false
|
||||||
type: time
|
type: list
|
||||||
default: 0 (no timeout)
|
|
||||||
mac:
|
|
||||||
description: "The MAC address of the Samsung Smart TV, e.g., `00:11:22:33:44:55:66`. Required for power on support via wake on lan."
|
|
||||||
required: false
|
|
||||||
type: string
|
|
||||||
broadcast_address:
|
|
||||||
description: The broadcast address on which to send the Wake-On-Lan packet.
|
|
||||||
required: false
|
|
||||||
default: 255.255.255.255
|
|
||||||
type: string
|
|
||||||
{% endconfiguration %}
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
#### Wake up TV
|
||||||
|
|
||||||
|
To wake up the TV when switched off you can use the [wake-on-lan](/integrations/wake_on_lan/) integration and call a service. This is not possible with every device.
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
wake_on_lan:
|
||||||
|
|
||||||
|
samsungtv:
|
||||||
|
- host: IP_ADDRESS
|
||||||
|
turn_on_action:
|
||||||
|
- service: wake_on_lan.send_magic_packet
|
||||||
|
data:
|
||||||
|
mac: "11:22:33:44:55:66"
|
||||||
|
```
|
||||||
|
|
||||||
### Supported models
|
### Supported models
|
||||||
|
|
||||||
If your model is not on the list then give it a test, if everything works correctly then add it to the list on [GitHub](https://github.com/home-assistant/home-assistant.io/tree/current/source/_integrations/samsungtv.markdown).
|
If your model is not on the list then give it a test, if everything works correctly then add it to the list on [GitHub](https://github.com/home-assistant/home-assistant.io/tree/current/source/_integrations/samsungtv.markdown).
|
||||||
@ -147,16 +156,14 @@ None of the 2014 (H) and 2015 (J) model series (e.g., J5200) will work, since Sa
|
|||||||
Changing channels can be done by calling the `media_player.play_media` service
|
Changing channels can be done by calling the `media_player.play_media` service
|
||||||
with the following payload:
|
with the following payload:
|
||||||
|
|
||||||
```javascript
|
```yaml
|
||||||
{
|
entity_id: media_player.samsung_tv
|
||||||
"entity_id": "media_player.office_tv",
|
media_content_id: 590
|
||||||
"media_content_id": "590",
|
media_content_type: channel
|
||||||
"media_content_type": "channel"
|
|
||||||
}
|
|
||||||
```
|
```
|
||||||
#### Selecting a source
|
#### Selecting a source
|
||||||
|
|
||||||
Source selection is not yet implemented.
|
It's possible to switch between the 2 sources `TV` and `HDMI`.
|
||||||
|
|
||||||
### Hass.io
|
### Hass.io
|
||||||
|
|
||||||
|
@ -27,3 +27,4 @@ The following integrations are automatically discovered by the SSDP integration:
|
|||||||
- [deCONZ](../deconz/)
|
- [deCONZ](../deconz/)
|
||||||
- [Huawei LTE](../huawei_lte/)
|
- [Huawei LTE](../huawei_lte/)
|
||||||
- [Philips Hue](../hue/)
|
- [Philips Hue](../hue/)
|
||||||
|
- [Samsung TV](../samsungtv/)
|
||||||
|
Loading…
x
Reference in New Issue
Block a user