Skip to content

Commit 75f464f

Browse files
gerard33gerard33
authored
Update info.md
1 parent eceb2df commit 75f464f

1 file changed

Lines changed: 161 additions & 26 deletions

File tree

‎info.md‎

Lines changed: 161 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,13 @@
2020
[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg?style=for-the-badge)](https://github.com/custom-components/hacs)
2121
[![Community Forum](https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge)](https://community.home-assistant.io/t/sony-bravia-tv-component-with-pre-shared-key/30698?u=gerard33)
2222

23-
# Custom component for Sony Bravia TV using Pre-Shared Key (PSK)
23+
## Custom component for Sony Bravia TV using Pre-Shared Key (PSK)
2424
A platform which allows you to interact with the Sony Bravia TV using a Pre-Shared Key.
2525

26-
## Homekit TV supported
26+
### Homekit TV supported
2727
The media player will show up as Television accessories on devices running iOS 12.2 or later
2828

29-
## Screenshots
29+
### Screenshots
3030
_Component used with Mini Media Player_
3131

3232
<img src="https://github.com/custom-components/media_player.braviatv_psk/blob/master/screenshots/bravia_1.png">
@@ -35,8 +35,8 @@ _Component used with standard Media Player_
3535

3636
<img src="https://github.com/custom-components/media_player.braviatv_psk/blob/master/screenshots/bravia_2.png">
3737

38-
## Configuration
39-
**Example configuration.yaml:**
38+
### Configuration
39+
#### Example configuration.yaml
4040

4141
```yaml
4242
media_player:
@@ -50,36 +50,171 @@ media_player:
5050
- ' HD'
5151
- HDMI
5252
time_format: 12H
53+
user_labels: True
5354
name: MyBraviaTV
5455
```
5556
56-
**Configuration variables:**
57-
58-
key | description
59-
:--- | :---
60-
**platform (Required)** | The platform name `braviatv_psk`.
61-
**host (Required)** | The IP of the Sony Bravia TV, eg. 192.168.1.101.
62-
**psk (Required)** | The Pre-Shared Key of the Sony Bravia TV, eg. sony (see below for instructions how to configure this on the TV). Place the psk between quotes if you use digits and those start with one or more zero's, e.g. '0044'.
63-
**mac (Optional)** | The MAC address of the Sony Bravia TV (see below for instructions how to get this from the TV). This is used to turn on the TV using WakeOn LAN and is only needed if the TV is non-Android.
64-
**amp (Optional)** | Boolean, defaults to False. Set this to True if you have an amplifier attached to the TV and not use the internal TV speakers. Then the volume slider will not be shown as this doesn’t work for the amplifier. Mute and volume up and down buttons are there and working with an amplifier.
65-
**android (Optional)** | Boolean, defaults to False. Set this to True when you have an Android TV as these TV’s don’t respond to WakeOn LAN commands, so another method of turning on the TV can be used.
66-
**sourcefilter (Optional)** | List of text that is used to filter the source list, eg. ’ HD’ (with quotes) will only show TV channels in the source list which contain ‘HD’, eg. ‘NPO 3 HD’ (in my config this will only show HD channels).
67-
**time_format (Optional)** | Time format to use for program information. Valid options are `12H` or `24H`, default is `24H`.
68-
**user_labels (Optional)** | Use the user defined labels from the TV (where configured), instead of default port labels.
69-
**name (Optional)** | The name the TV will have in Home Assistant, default is `Sony Bravia TV`.
70-
71-
**Installation instructions TV**
57+
### Configuration variables
58+
59+
key | required | value | description
60+
:--- | :--- | :--- | :---
61+
**platform** | yes | `braviatv_psk` | The platform name `braviatv_psk`.
62+
**host** | yes | `192.168.1.101` | The IP of the Sony Bravia TV, eg. 192.168.1.101.
63+
**psk** | yes | `sony` | The Pre-Shared Key of the Sony Bravia TV, eg. sony (see below for instructions how to configure this on the TV). Place the psk between quotes if you use digits and those start with one or more zero's, e.g. '0044'.
64+
**mac** | no | `AA:BB:CC:DD:EE:FF` | The MAC address of the Sony Bravia TV (see below for instructions how to get this from the TV). This is used to turn on the TV using WakeOn LAN and is only needed if the TV is non-Android.
65+
**amp** | no | `False` | Boolean, defaults to False. Set this to True if you have an amplifier attached to the TV and not use the internal TV speakers. Then the volume slider will not be shown as this doesn’t work for the amplifier. Mute and volume up and down buttons are there and working with an amplifier.
66+
**android** | no | `False` |"Boolean, defaults to False. Set this to True when you have an Android TV as these TV’s don’t respond to WakeOn LAN commands, so another method of turning on the TV can be used. Also a service to open apps is added to Home Assistant.
67+
**sourcefilter** | no | `HD` | List of text that is used to filter the source list, eg. ’ HD’ (with quotes) will only show TV channels in the source list which contain ‘HD’, eg. ‘NPO 3 HD’ (in my config this will only show HD channels).
68+
**time_format** | no | `24H` | Time format to use for program information. Valid options are `12H` or `24H`, default is `24H`.
69+
**user_labels** | no | `True` | Use the user defined labels from the TV (where configured), instead of default port labels. If you have given e.g. the HDMI2 port on your TV a label, that will be shown.
70+
**name** | no | `Sony Bravia TV` | The name the TV will have in Home Assistant, default is `Sony Bravia TV`.
71+
72+
### Installation instructions TV
7273
1. Enable remote start on your TV: [Settings] => [Network] => [Home Network Setup] => [Remote Start] => [On]
7374
2. Enable pre-shared key on your TV: [Settings] => [Network] => [Home Network Setup] => [IP Control] => [Authentication] => [Normal and Pre-Shared Key]
7475
3. Set pre-shared key on your TV: [Settings] => [Network] => [Home Network Setup] => [IP Control] => [Pre-Shared Key] => sony
7576
4. Give your TV a static IP address, or make a DHCP reservation for a specific IP address in your router
7677
5. Determine the MAC address of your TV: [Settings] => [Network] => [Network Setup] => [View Network Status]
7778

78-
<img src="https://github.com/custom-components/media_player.braviatv_psk/blob/master/screenshots/bravia_3.png">
79+
### Services
80+
The following service is added to Home Assistant
81+
* braviatv_psk.bravia_command
7982

80-
<br>
83+
This service can be used to send commands to your TV, like `Return` or `Up`. Useful for creating a virtual remote
84+
control for example. A complete list with examples can be found below.
85+
86+
When you have an Android TV and have set `Android: True` in the configuration also the following service is added
87+
* braviatv_psk.bravia_open_app
8188

82-
***
83-
Due to how `custom_componentes` are loaded, it is normal to see a `ModuleNotFoundError` error on first boot after adding this, to resolve it, restart Home-Assistant.
89+
This service can be used to open an app on your Android TV, like `Kodi` or `Youtube`. You have to send the corresponding uri to open the app. A list with some example uris can be found below.
8490

85-
***
91+
#### braviatv_psk.bravia_command
92+
The use of `command_id` depends on which one are supported by your TV. Some examples are:
93+
```
94+
Num1
95+
Num2
96+
Num3
97+
Num4
98+
Num5
99+
Num6
100+
Num7
101+
Num8
102+
Num9
103+
Num0
104+
Num11
105+
Num12
106+
Enter
107+
GGuide
108+
ChannelUp
109+
ChannelDown
110+
VolumeUp
111+
VolumeDown
112+
Mute
113+
TvPower
114+
Audio
115+
MediaAudioTrack
116+
Tv
117+
Input
118+
TvInput
119+
TvAntennaCable
120+
WakeUp
121+
PowerOff
122+
Sleep
123+
Right
124+
Left
125+
SleepTimer
126+
Analog2
127+
TvAnalog
128+
Display
129+
Jump
130+
PicOff
131+
PictureOff
132+
Teletext
133+
Video1
134+
Video2
135+
AnalogRgb1
136+
Home
137+
Exit
138+
PictureMode
139+
Confirm
140+
Up
141+
Down
142+
ClosedCaption
143+
Component1
144+
Component2
145+
Wide
146+
EPG
147+
PAP
148+
TenKey
149+
BSCS
150+
Ddata
151+
Stop
152+
Pause
153+
Play
154+
Rewind
155+
Forward
156+
DOT
157+
Rec
158+
Return
159+
Blue
160+
Red
161+
Green
162+
Yellow
163+
SubTitle
164+
CS
165+
BS
166+
Digital
167+
Options
168+
Media
169+
Prev
170+
Next
171+
DpadCenter
172+
CursorUp
173+
CursorDown
174+
CursorLeft
175+
CursorRight
176+
ShopRemoteControlForcedDynamic
177+
FlashPlus
178+
FlashMinus
179+
DemoMode
180+
Analog
181+
Mode3D
182+
DigitalToggle
183+
DemoSurround
184+
AD
185+
AudioMixUp
186+
AudioMixDown
187+
PhotoFrame
188+
Tv_Radio
189+
SyncMenu
190+
Hdmi1
191+
Hdmi2
192+
Hdmi3
193+
Hdmi4
194+
TopMenu
195+
PopUpMenu
196+
OneTouchTimeRec
197+
OneTouchView
198+
DUX
199+
FootballMode
200+
iManual
201+
Netflix
202+
Assists
203+
FeaturedApp
204+
FeaturedAppVOD
205+
GooglePlay
206+
ActionMenu
207+
Help
208+
TvSatellite
209+
WirelessSubwoofer
210+
AndroidMenu
211+
```
212+
213+
#### braviatv_psk.bravia_open_app
214+
If you have an Android TV you can use an uri from the list below to open the corresponding app. See [this](https://community.home-assistant.io/t/sony-bravia-tv-component-with-pre-shared-key/30698/164) post to get a list of all apps supported by your TV.
215+
```
216+
YouTube uri: "com.sony.dtv.com.google.android.youtube.tv.com.google.android.apps.youtube.tv.activity.ShellActivity"
217+
Music uri: "com.sony.dtv.com.sony.dtv.osat.music.com.sonyericsson.music.MusicActivity"
218+
Netflix uri: "com.sony.dtv.com.netflix.ninja.com.netflix.ninja.MainActivity"
219+
Kodi uri: "com.sony.dtv.org.xbmc.kodi.org.xbmc.kodi.Splash"
220+
```

0 commit comments

Comments
 (0)