mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-11 15:42:10 +01:00
07dd823933
Signed-off-by: Michael Lobstein <michael.lobstein@gmail.com> Signed-off-by: Ciprian Pascu <contact@ciprianpascu.ro>
243 lines
12 KiB
Markdown
243 lines
12 KiB
Markdown
# Panasonic Blu-ray Player Binding
|
|
|
|
This binding connects Panasonic Blu-ray players from 2011/2012 and UHD Blu-ray players from 2018 to openHAB.
|
|
**Supported Blu-ray models:** DMP-BDT110, DMP-BDT210, DMP-BDT310, DMP-BDT120, DMP-BDT220, DMP-BDT320, DMP-BBT01 & DMP-BDT500.
|
|
**Supported UHD models:** DP-UB420/424, DP-UB820/824 & DP-UB9000/9004.
|
|
|
|
**Please note:** The player must be on the same IP subnet as the openHAB server for this binding to function.
|
|
If the connection to the player originates from a different subnet, 404 response errors are sent in response to all requests.
|
|
|
|
To enable network remote control of the Blu-ray model players, configure the following settings:
|
|
**Player Settings/Network/Network Settings/Remote Device Settings**
|
|
Then make sure you have the following values set:
|
|
**Remote Device Operation: On**
|
|
**Registration Type: Automatic**
|
|
|
|
For the UHD models, Voice Control must be enabled for the player's http interface to be active:
|
|
**Player Settings/Network/Voice Control: On**
|
|
|
|
To enable the binding to control the player while off (network active while off), Quick Start mode must be On as follows:
|
|
**Player Settings/System/Quick Start: On**
|
|
|
|
**UHD Model Command Authentication:**
|
|
The UHD models require authentication to use the control API.
|
|
A player key must be specified in the thing configuration in order for the `power`, `button` and `control` channels to work.
|
|
UHD model players that are patched do not require a player key.
|
|
See the [AVForums discussions](https://www.avforums.com/forums/blu-ray-dvd-player-multiregion-hacks.126/) of the DP-UB420/820/9000 players for more information.
|
|
|
|
## Supported Things
|
|
|
|
There are two supported thing types, which represent either a BD player or a UHD player.
|
|
A supported Blu-ray player uses the `bd-player` id and a supported UHD Blu-ray player uses the `uhd-player` id.
|
|
Multiple Things can be added if more than one player is to be controlled.
|
|
|
|
## Discovery
|
|
|
|
Auto-discovery is supported if the player can be located on the local network using UPnP.
|
|
Otherwise the thing must be manually added.
|
|
|
|
## Binding Configuration
|
|
|
|
The binding has no configuration options, all configuration is done at Thing level.
|
|
|
|
## Thing Configuration
|
|
|
|
The Thing has a few configuration parameters:
|
|
|
|
| Name | Type | Description | Default | Required |
|
|
|-----------|---------|-------------------------------------------------------------------------------------------------------|---------|----------|
|
|
| hostName | text | The host name or IP address of the player. | N/A | yes |
|
|
| refresh | integer | Overrides the refresh interval of the player status. Minimum interval is 5 seconds. | 5 | no |
|
|
| playerKey | text | For UHD models, to enable authentication of control commands, a key for the player must be specified. | N/A | no |
|
|
|
|
Some notes:
|
|
|
|
* The control protocol of these players is undocumented and may not work consistently in all situations
|
|
* The UHD models only support playback elapsed time (not title total time or chapter information) reporting
|
|
* The time and chapter information is only available when playing a Blu-ray disc (not DVD or CD)
|
|
* There are reports in forum postings that not all commands work on all of the older models (i.e.: Power does not work on DMP-BDT110)
|
|
* Not all status information is available from all BD models (i.e.: playback elapsed time not reported by some models)
|
|
|
|
## Channels
|
|
|
|
The following channels are available:
|
|
|
|
| Channel ID | Item Type | Read/Write | Description |
|
|
|-----------------|-------------|------------|---------------------------------------------------------------------------------------|
|
|
| power | Switch | RW | Turn the power for the player ON or OFF. |
|
|
| button | String | W | Sends a command to the player. See lists of available commands in Appendix A below. |
|
|
| control | Player | RW | Control Playback e.g. Play/Pause/Next/Previous/FForward/Rewind. |
|
|
| player-status | String | R | The player status i.e.: Power Off, Tray Open, Stopped, Playback, Pause Playback, etc. |
|
|
| time-elapsed | Number:Time | R | The total number of seconds of playback time elapsed. |
|
|
| time-total | Number:Time | R | The total length of the current playing title in seconds. Not on UHD models. |
|
|
| chapter-current | Number | R | The current chapter number. Not on UHD models. |
|
|
| chapter-total | Number | R | The total number of chapters in the current title. Not on UHD models. |
|
|
|
|
## Full Example
|
|
|
|
panasonicbdp.things:
|
|
|
|
```java
|
|
panasonicbdp:bd-player:mybdplayer "My Blu-ray player" [ hostName="192.168.10.1", refresh=5 ]
|
|
panasonicbdp:uhd-player:myuhdplayer "My UHD Blu-ray player" [ hostName="192.168.10.1", refresh=5, playerKey="ABCDEF1234567890abcdef0123456789" ]
|
|
```
|
|
|
|
panasonicbdp.items:
|
|
|
|
```java
|
|
// BD Player
|
|
Switch Player_Power "Power" { channel="panasonicbdp:bd-player:mybdplayer:power" }
|
|
String Player_Button "Send Command" { channel="panasonicbdp:bd-player:mybdplayer:button", autoupdate="false" }
|
|
Player Player_Control "Control" { channel="panasonicbdp:bd-player:mybdplayer:control" }
|
|
String Player_PlayerStatus "Status: [%s]" { channel="panasonicbdp:bd-player:mybdplayer:player-status" }
|
|
Number:Time Player_TimeElapsed "Elapsed Time: [%d %unit%]" { channel="panasonicbdp:bd-player:mybdplayer:time-elapsed" }
|
|
Number:Time Player_TimeTotal "Total Time: [%d %unit%]" { channel="panasonicbdp:bd-player:mybdplayer:time-total" }
|
|
Number Player_ChapterCurrent "Current Chapter: [%d]" { channel="panasonicbdp:bd-player:mybdplayer:chapter-current" }
|
|
Number Player_ChapterTotal "Total Chapters: [%d]" { channel="panasonicbdp:bd-player:mybdplayer:chapter-total" }
|
|
|
|
// UHD Player
|
|
Switch Player_Power "Power" { channel="panasonicbdp:uhd-player:myuhdplayer:power" }
|
|
String Player_Button "Send Command" { channel="panasonicbdp:uhd-player:myuhdplayer:button", autoupdate="false" }
|
|
Player Player_Control "Control" { channel="panasonicbdp:uhd-player:myuhdplayer:control" }
|
|
String Player_PlayerStatus "Status: [%s]" { channel="panasonicbdp:uhd-player:myuhdplayer:player-status" }
|
|
Number:Time Player_TimeElapsed "Elapsed Time: [%d %unit%]" { channel="panasonicbdp:uhd-player:myuhdplayer:time-elapsed" }
|
|
```
|
|
|
|
panasonicbdp.sitemap:
|
|
|
|
```perl
|
|
sitemap panasonicbdp label="Panasonic Blu-ray" {
|
|
Frame label="Blu-ray Player" {
|
|
Switch item=Player_Power
|
|
Selection item=Player_Button icon="player"
|
|
Default item=Player_Control
|
|
Text item=Player_PlayerStatus
|
|
Text item=Player_TimeElapsed icon="time"
|
|
// The following three channels are not available on UHD models
|
|
Text item=Player_TimeTotal icon="time"
|
|
Text item=Player_ChapterCurrent icon="time"
|
|
Text item=Player_ChapterTotal icon="time"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Appendix A - 'button' channel command codes:
|
|
|
|
**List of available button commands for BD players:**
|
|
|
|
| Function | Command |
|
|
|--------------------------|----------|
|
|
| Power On | POWERON |
|
|
| Power Off | POWEROFF |
|
|
| Power Toggle | POWER |
|
|
| Play | PLAYBACK |
|
|
| Pause | PAUSE |
|
|
| Stop | STOP |
|
|
| Fast Forward | CUE |
|
|
| Reverse | REV |
|
|
| Skip Forward | SKIPFWD |
|
|
| Skip Back | SKIPREV |
|
|
| Open/Close | OP_CL |
|
|
| Status | DSPSEL |
|
|
| Top Menu | TITLE |
|
|
| Pop-Up Menu | PUPMENU |
|
|
| Up | UP |
|
|
| Down | DOWN |
|
|
| Left | LEFT |
|
|
| Right | RIGHT |
|
|
| OK | SELECT |
|
|
| Submenu | MENU |
|
|
| Return | RETURN |
|
|
| 1 (@.) | D1 |
|
|
| 2 (ABC) | D2 |
|
|
| 3 (DEF) | D3 |
|
|
| 4 (GHI) | D4 |
|
|
| 5 (JKL) | D5 |
|
|
| 6 (MNO) | D6 |
|
|
| 7 (PQRS) | D7 |
|
|
| 8 (TUV) | D8 |
|
|
| 9 (WXYZ) | D9 |
|
|
| 0 (-,) | D0 |
|
|
| 12 | D12 |
|
|
| * (Cancel) | CLEAR |
|
|
| # ([_]) | SHARP |
|
|
| Red | RED |
|
|
| Green | GREEN |
|
|
| Blue | BLUE |
|
|
| Yellow | YELLOW |
|
|
| Home | MLTNAVI |
|
|
| Netflix (broken/too old) | NETFLIX |
|
|
| VIERA Cast | V_CAST |
|
|
| Network | NETWORK |
|
|
| Setup | SETUP |
|
|
| Exit | EXIT |
|
|
| Audio | AUDIOSEL |
|
|
| 3D | 3D |
|
|
| Playback View (buttons not in other views)||
|
|
| PIP | P_IN_P |
|
|
| OSD (DISPLAY) | OSDONOFF |
|
|
| Shuttle(BD) View (buttons not in other views)||
|
|
| Swipe in CW circle | SHFWD2 |
|
|
| Swipe in CCW circle | SHREV2 |
|
|
|
|
**List of available button commands for UHD players:**
|
|
|
|
| Function | Command |
|
|
|------------------|------------------|
|
|
| Power On | POWERON |
|
|
| Power Off | POWEROFF |
|
|
| Power Toggle | POWER |
|
|
| Play | PLAYBACK |
|
|
| Pause | PAUSE |
|
|
| Stop | STOP |
|
|
| Fast Forward | CUE |
|
|
| Reverse | REV |
|
|
| Skip Forward | SKIPFWD |
|
|
| Skip Back | SKIPREV |
|
|
| Manual Skip +60s | MNSKIP |
|
|
| Manual Skip -10s | MNBACK |
|
|
| Open/Close | OP_CL |
|
|
| Status | DSPSEL |
|
|
| Top Menu | TITLE |
|
|
| Pop-up Menu | PUPMENU |
|
|
| Up | UP |
|
|
| Down | DOWN |
|
|
| Left | LEFT |
|
|
| Right | RIGHT |
|
|
| OK | SELECT |
|
|
| Submenu | MENU |
|
|
| Return | RETURN |
|
|
| 1 (@.) | D1 |
|
|
| 2 (ABC) | D2 |
|
|
| 3 (DEF) | D3 |
|
|
| 4 (GHI) | D4 |
|
|
| 5 (JKL) | D5 |
|
|
| 6 (MNO) | D6 |
|
|
| 7 (PQRS) | D7 |
|
|
| 8 (TUV) | D8 |
|
|
| 9 (WXYZ) | D9 |
|
|
| 0 (-,) | D0 |
|
|
| 12 | D12 |
|
|
| * (Cancel) | CLEAR |
|
|
| # ([_]) | SHARP |
|
|
| Red | RED |
|
|
| Green | GREEN |
|
|
| Blue | BLUE |
|
|
| Yellow | YELLOW |
|
|
| Home | MLTNAVI |
|
|
| Netflix | NETFLIX |
|
|
| VIERA Cast | V_CAST |
|
|
| Network | NETWORK |
|
|
| Setup | SETUP |
|
|
| Exit | EXIT |
|
|
| Audio | AUDIOSEL |
|
|
| Subtitle | TITLEONOFF |
|
|
| Closed Caption | CLOSED_CAPTION |
|
|
| Playback Info | PLAYBACKINFO |
|
|
| HDR Picture Mode | HDR_PICTUREMODE |
|
|
| Mirroring | MIRACAST |
|
|
| Picture Setting | PICTURESETTINGS |
|
|
| Sound Effect | SOUNDEFFECT |
|
|
| High Clarity | HIGHCLARITY |
|
|
| Skip The Trailer | SKIP_THE_TRAILER |
|