demus/openhab-addons
1
0
Fork 0
mirror of https://github.com/openhab/openhab-addons.git synced 2025-01-25 14:55:55 +01:00
Code Issues Packages Projects Releases Wiki Activity

update README (#11075)

Browse Source 
Signed-off-by: Michael Lobstein <michael.lobstein@gmail.com>
This commit is contained in:
mlobstein 2021-08-01 02:24:37 -05:00 committed by GitHub
parent e1eb18ee3f
commit 440554dcc1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 125 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

144
bundles/org.openhab.binding.oppo/README.md
View File

@ -14,10 +14,10 @@ The binding supports three different kinds of connections:
* serial connection, * serial connection,
* serial over IP connection * serial over IP connection
For users without a serial connector on the server side, you can use a serial to USB adapter. For users without a serial port on the server side, you can use a USB to serial adapter.
You don't need to have your player device directly connected to your openHAB server. You don't need to have your player device directly connected to your openHAB server.
You can connect it for example to a Raspberry Pi and use [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) to make the serial connection available on LAN (serial over IP). You can connect it for example to a Raspberry Pi and use [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) to make the serial connection available on the LAN (serial over IP).
## Supported Things ## Supported Things
@ -77,40 +77,40 @@ Some notes:
The following channels are available: The following channels are available:
| Channel ID | Item Type | Description | | Channel ID | Item Type | Description |
|-------------------|-------------|----------------------------------------------------------------------------------------------------------------| |-------------------|-------------|---------------------------------------------------------------------------------------------------------------------------------------|
| power | Switch | Turn the power for the player on or off | | power | Switch | Turn the power for the player on or off |
| volume | Dimmer | Control the volume for the player (0-100%) | | volume | Dimmer | Control the volume for the player (0-100%) |
| mute | Switch | Mute or unmute the volume on the player | | mute | Switch | Mute or unmute the volume on the player |
| source | Number | Select the source input for the player (0-6; number of available options varies by model) | | source | Number | Select the source input for the player (0-6; number of available options varies by model) |
| play_mode | String | Indicates the current playback mode of the player (ReadOnly) | | play_mode | String | Indicates the current playback mode of the player (ReadOnly) |
| control | Player | Simulate pressing the transport control buttons on the remote control (play/pause/next/previous/rew/ffwd) | | control | Player | Simulate pressing the transport control buttons on the remote control (play/pause/next/previous/rew/ffwd) |
| time_mode | String | Sets the time information display mode on the player (T, X, C, K) | | time_mode | String | Sets the time information display mode on the player (T= Title Elapsed, X= Title Remaining, C= Chapter Elapsed, K= Chapter Remaining) |
| time_display | Number:Time | The playback time elapsed/remaining in seconds (ReadOnly) | | time_display | Number:Time | The playback time elapsed/remaining in seconds (ReadOnly) |
| current_title | Number | The current title or track number playing (ReadOnly) | | current_title | Number | The current title or track number playing (ReadOnly) |
| total_title | Number | The total number of titles or tracks on the disc (ReadOnly) | | total_title | Number | The total number of titles or tracks on the disc (ReadOnly) |
| current_chapter | Number | The current chapter number player (ReadOnly) | | current_chapter | Number | The current chapter number player (ReadOnly) |
| total_chapter | Number | The total number of chapters in the current title (ReadOnly) | | total_chapter | Number | The total number of chapters in the current title (ReadOnly) |
| repeat_mode | String | Sets the current repeat mode (00-06) | | repeat_mode | String | Sets the current repeat mode (00-06) |
| zoom_mode | String | Sets the current zoom mode (00-12) | | zoom_mode | String | Sets the current zoom mode (00-12) |
| disc_type | String | The current type of disc in the player (ReadOnly) | | disc_type | String | The current type of disc in the player (ReadOnly) |
| audio_type | String | The current audio track type (ReadOnly) | | audio_type | String | The current audio track type (ReadOnly) |
| subtitle_type | String | The current subtitle selected (ReadOnly) | | subtitle_type | String | The current subtitle selected (ReadOnly) |
| aspect_ratio | String | The aspect ratio of the current video output [UDP-203/205 only] (ReadOnly) | | aspect_ratio | String | The aspect ratio of the current video output [UDP-203/205 only] (ReadOnly) |
| source_resolution | String | The video resolution of the content being played (ReadOnly) | | source_resolution | String | The video resolution of the content being played (ReadOnly) |
| output_resolution | String | The video resolution of the player output (ReadOnly) | | output_resolution | String | The video resolution of the player output (ReadOnly) |
| 3d_indicator | String | Indicates if the content playing is 2D or 3D (ReadOnly) | | 3d_indicator | String | Indicates if the content playing is 2D or 3D (ReadOnly) |
| osd_position | Number | Sets the OSD position (0 to 5) [10x models and up] | | osd_position | Number | Sets the OSD position (0 to 5) [10x models and up] |
| sub_shift | Number | Sets the subtitle shift (-10 to 10) [10x models and up] (note more than 5 from 0 throws an error on the BDP103)| | sub_shift | Number | Sets the subtitle shift (-10 to 10) [10x models and up] (note more than 5 from 0 throws an error on the BDP103) |
| hdmi_mode | String | Sets the current HDMI output mode (options vary by model; see notes above for allowed values) | | hdmi_mode | String | Sets the current HDMI output mode (options vary by model; see notes above for allowed values) |
| hdr_mode | String | Sets current HDR output mode (Auto, On, Off) [UDP-203/205 only] | | hdr_mode | String | Sets current HDR output mode (Auto, On, Off) [UDP-203/205 only] |
| remote_button | String | Simulate pressing a button on the remote control (3 letter code; codes can be found in the API documentation) | | remote_button | String | Simulate pressing a button on the remote control (3 letter code; codes can be found in Appendix A below) |
## Full Example ## Full Example
oppo.things: oppo.things:
```java ```
// direct IP connection // direct IP connection
oppo:player:myoppo "Oppo Blu-ray" [ host="192.168.0.10", model=103, verboseMode=false] oppo:player:myoppo "Oppo Blu-ray" [ host="192.168.0.10", model=103, verboseMode=false]
@ -119,11 +119,12 @@ oppo:player:myoppo "Oppo Blu-ray" [ serialPort="COM5", model=103, verboseMode=tr
// serial over IP connection // serial over IP connection
oppo:player:myoppo "Oppo Blu-ray" [ host="192.168.0.9", port=4444, model=103, verboseMode=true] oppo:player:myoppo "Oppo Blu-ray" [ host="192.168.0.9", port=4444, model=103, verboseMode=true]
``` ```
oppo.items: oppo.items:
```java ```
Switch oppo_power "Power" { channel="oppo:player:myoppo:power" } Switch oppo_power "Power" { channel="oppo:player:myoppo:power" }
Dimmer oppo_volume "Volume [%d %%]" { channel="oppo:player:myoppo:volume" } Dimmer oppo_volume "Volume [%d %%]" { channel="oppo:player:myoppo:volume" }
Switch oppo_mute "Mute" { channel="oppo:player:myoppo:mute" } Switch oppo_mute "Mute" { channel="oppo:player:myoppo:mute" }
@ -154,7 +155,7 @@ String oppo_remote_button "Remote Button [%s]" { channel="oppo:player:myoppo:rem
secondsformat.js: secondsformat.js:
```java ```
(function(totalSeconds) { (function(totalSeconds) {
if (isNaN(totalSeconds)) { if (isNaN(totalSeconds)) {
return '-'; return '-';
@ -179,11 +180,11 @@ secondsformat.js:
oppo.sitemap: oppo.sitemap:
```perl ```
sitemap oppo label="Oppo Blu-ray" { sitemap oppo label="Oppo Blu-ray" {
Frame label="Player" { Frame label="Player" {
Switch item=oppo_power Switch item=oppo_power
//Volume can be a Setpoint also // Volume can be a Setpoint also
Slider item=oppo_volume minValue=0 maxValue=100 step=1 visibility=[oppo_power==ON] icon="soundvolume" Slider item=oppo_volume minValue=0 maxValue=100 step=1 visibility=[oppo_power==ON] icon="soundvolume"
Switch item=oppo_mute visibility=[oppo_power==ON] icon="soundvolume_mute" Switch item=oppo_mute visibility=[oppo_power==ON] icon="soundvolume_mute"
Selection item=oppo_source visibility=[oppo_power==ON] icon="player" Selection item=oppo_source visibility=[oppo_power==ON] icon="player"
@ -212,3 +213,76 @@ sitemap oppo label="Oppo Blu-ray" {
} }
} }
``` ```
### Appendix A - 'remote_button' codes:
POW Toggle power ON and OFF
SRC Select input source
EJT Open/close the disc tray
PON Discrete on
POF Discrete off
SYS Switch output TV system (PAL/NTSC/MULTI)
DIM Dim front panel display
PUR Pure audio mode (no video)
VUP Increase volume
VDN Decrease volume
MUT Mute/Unmute audio
NU1 Numeric key 1
NU2 Numeric key 2
NU3 Numeric key 3
NU4 Numeric key 4
NU5 Numeric key 5
NU6 Numeric key 6
NU7 Numeric key 7
NU8 Numeric key 8
NU9 Numeric key 9
NU0 Numeric key 0
CLR Clear numeric input
GOT Play from a specified location
HOM Go to Home Menu to select media source
PUP Show previous page
PDN Show next page
OSD Show/hide on-screen display
TTL Show BD top menu or DVD title menu
MNU Show BD pop-up menu or DVD menu
NUP Up Arrow Navigation
NLT Left Arrow Navigation
NRT Right Arrow Navigation
NDN Down Arrow Navigation
SEL ENTER Navigation
SET Enter the player setup menu
RET Return to the previous menu or mode
RED RED Function varies by content
GRN GREEN Function varies by content
BLU BLUE Function varies by content
YLW YELLOW Function varies by content
STP Stop playback
PLA Start playback
PAU Pause playback
PRE Skip to previous
REV Fast reverse play
FWD Fast forward play
NXT Skip to next
AUD Change audio language or channel
SUB Change subtitle language
ANG Change camera angle
ZOM Zoom in/out and adjust aspect ratio
SAP Turn on/off Secondary Audio Program
ATB AB Repeat play the selected section
RPT Repeat play
PIP Show/hide Picture-in-Picture
HDM Switch output resolution
SUH Press and hold the SUBTITLE key. This activates the subtitle shift feature
NFX Stop current playback and start the Netflix application
VDU Stop current playback and start the VUDU application
OPT Show/hide the Option menu
M3D 3D Show/hide the 2D-to-3D Conversion or 3D adjustment menu
SEH Display the Picture Adjustment menu
DRB Display the Darbee Adjustment menu
#### Extra buttons on UDP models:
HDR Display the HDR selection menu
INH Show on-screen detailed information
RLH Set resolution to Auto
AVS Display the A/V Sync adjustment menu
GPA Gapless Play. This functions the same as selecting Gapless Play in the Option Menu.

22
bundles/org.openhab.binding.oppo/src/main/resources/OH-INF/thing/channels.xml
View File

@ -46,11 +46,11 @@
<description>Choose Model of Oppo Player</description> <description>Choose Model of Oppo Player</description>
<limitToOptions>true</limitToOptions> <limitToOptions>true</limitToOptions>
<options> <options>
<option value="83">Oppo BDP-83 or BDP-93/95</option> <option value="83">BDP-83 or BDP-93/95</option>
<option value="103">Oppo BDP-103/103D</option> <option value="103">BDP-103/103D</option>
<option value="105">Oppo BDP-105/105D</option> <option value="105">BDP-105/105D</option>
<option value="203">Oppo UDP-203</option> <option value="203">UDP-203</option>
<option value="205">Oppo UDP-205</option> <option value="205">UDP-205</option>
</options> </options>
</parameter> </parameter>
<parameter name="serialPort" type="text" required="false"> <parameter name="serialPort" type="text" required="false">
@ -71,7 +71,7 @@
</parameter> </parameter>
<parameter name="verboseMode" type="boolean" required="false"> <parameter name="verboseMode" type="boolean" required="false">
<label>Verbose Mode</label> <label>Verbose Mode</label>
<description>If true, the player will send time updates every second. If false, the binding polls the player evey 30 <description>If true, the player will send time updates every second. If false, the binding polls the player evey 10
seconds</description> seconds</description>
<default>false</default> <default>false</default>
<advanced>true</advanced> <advanced>true</advanced>
@ -326,8 +326,18 @@
<option value="RPT">Repeat</option> <option value="RPT">Repeat</option>
<option value="PIP">Picture in Picture</option> <option value="PIP">Picture in Picture</option>
<option value="HDM">HDMI Mode</option> <option value="HDM">HDMI Mode</option>
<option value="SUH">Subtitle</option>
<option value="NFX">Netflix</option> <option value="NFX">Netflix</option>
<option value="VDU">Vudu</option>
<option value="OPT">Option Menu</option>
<option value="M3D">3D Menu</option>
<option value="SEH">Picture Adjustment</option>
<option value="DRB">Darbee Adjustment</option>
<option value="HDR">HDR Menu</option>
<option value="INH">Extended OSD</option> <option value="INH">Extended OSD</option>
<option value="RLH">Resolution Select</option>
<option value="AVS">A/V Sync Menu</option>
<option value="GPA">Gapless Play</option>
</options> </options>
</state> </state>
</channel-type> </channel-type>