Minor grammatical tweaks for SmartCast Component (#3123)

This commit is contained in:
Charles Garwood 2017-08-02 08:52:34 -04:00 committed by Fabian Affolter
parent 3caddc2bad
commit 2a93609459

View File

@ -18,23 +18,24 @@ The `vizio` component will allow you to control [SmartCast](https://www.vizio.co
## Pairing
Before adding TV to Home Assistant you'll need to pair it manually, to do so follow these steps:
Before adding your TV to Home Assistant you'll need to pair it manually. To do so follow these steps:
Install the command-line tool using pip (you can choose to download it manually):
Install the command-line tool using pip (or you can choose to download it manually):
```bash
$ pip3 install git+https://github.com/vkorn/pyvizio.git@master
$ pip3 install -I .
```
Make sure that your TV is on, as sometimes it won't show PIN code if it wasn't on during pairing initialization.
Make sure that your TV is on before continuing.
If you don't know IP address of your TV run following command:
```bash
$ pyvizio --ip=0 --auth=0 discover
```
Initiate pairing:
Enter the following command to initiate pairing:
```bash
$ pyvizio --ip={ip} pair
@ -44,20 +45,20 @@ Initiation will show you two different values:
| Value | Description |
|:----------------|:---------------------|
| Challenge type | Usually it's should be `"1"`, if it's not the case for you, use additional parameter `--ch_type=your_type` in the next step |
| Challenge type | Usually it should be `"1"`. If not, use the additional parameter `--ch_type=your_type` in the next step |
| Challenge token | Token required to finalize pairing in the next step |
Finally, at this point PIN code should be displayed at the top of your TV. With all these values, you can now finish pairing:
Finally, at this point a PIN code should be displayed at the top of your TV. With all these values, you can now finish pairing:
```bash
$ pyvizio --ip={ip} pair_finish --token={challenge_token} --pin={tv_pin}
```
You will need authentication token returned by this command to configure Home Assistant.
You will need the authentication token returned by this command to configure Home Assistant.
## Configuration
To add your Vizio TV to your installation, add following to your `configuration.yaml` file:
To add your Vizio TV to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
@ -70,13 +71,13 @@ media_player:
Configuration variables:
- **host** (*Required*): IP address of your TV.
- **access_token** (*Required*): Authentication token you've received in last step of the pairing process.
- **access_token** (*Required*): Authentication token you received in the last step of the pairing process.
## Notes and limitations
### Turning TV on
If you do have `Power Mode` of your TV configured to be `Eco Mode`, turning device ON won't work.
If the `Power Mode` of your TV is set to `Eco Mode`, turning the device ON won't work.
### Changing tracks
@ -87,7 +88,8 @@ Changing tracks works like channels switching. If you have source other than reg
Source list shows all external devices connected to the TV through HDMI plus list of internal devices (TV mode, Chrome Cast, etc.).
<p class='note'>
Vizio SmartCast service is accessible through HTTPS with self-signed certificate. It means that if you have low LOGLEVEL in your Home Assistant configuration, you'll see a lot of warnings like this `InsecureRequestWarning: Unverified HTTPS request is being made. Adding certificate verification is strongly advised.`
Vizio SmartCast service is accessible through HTTPS with self-signed certificate. If you have low LOGLEVEL in your Home Assistant configuration, you'll see a lot of warnings like this:
`InsecureRequestWarning: Unverified HTTPS request is being made. Adding certificate verification is strongly advised.`
As an option, you could proxy all calls for example through NGINX.
You can adjust the log level for `media_player` components with the [logger](https://home-assistant.io/components/logger/) component, or if you need to keep a low log level for `media_player` you could proxy calls to your TV through an NGINX reverse proxy.
</p>