openhab-addons/bundles/org.openhab.binding.sonyaudio

SonyAudio Binding

This binding integrates the Sony Audio Control API.

Supported Things

At the moment, the devices supported by this binding are:

• STR-DN1080
• HT-CT800
• SRS-ZR5
• HT-ST5000
• HT-Z9F
• HT-ZF9
• HT-MT500

When defined in a .things file, the specific Thing types STR-DN1080, HT-ST5000, HT-ZF9, HT-Z9F, HT-CT800, HT-MT500, and SRS-ZR5 should be used.

Please note that these Thing types are case-sensitive (define them in uppercase).

Discovery

SonyAudio devices are discovered via UPnP on the local network, and all devices are placed in the Inbox.

Thing Configuration

The SonyAudio Thing requires the network address, port, and path as configuration values so the binding knows how to access the device. Additionally, a refresh interval (in seconds), used to poll the Sony Audio device, can be specified.

Thing sonyaudio:HT-ST5000:1 [ipAddress="192.168.123.123", port=10000, path="/sony", refresh=60]

Channels

The devices support the following channels:

Channel Type ID	Item Type	Access Mode	Description	Thing types
power	Switch	RW	Main power on/off	HT-CT800, SRS-ZR5, HT-ST5000, HT-ZF9, HT-Z9F, HT-MT500
input	String	RW	Set or get the input source	HT-CT800, SRS-ZR5, HT-ST5000, HT-ZF9, HT-Z9F, HT-MT500
volume	Dimmer	RW	Set or get the master volume	HT-CT800, SRS-ZR5, HT-ST5000, HT-ZF9, HT-Z9F, HT-MT500
mute	Switch	RW	Set or get the mute state of the master volume	HT-CT800, SRS-ZR5, HT-ST5000, HT-ZF9, HT-Z9F, HT-MT500
soundField	String	RW	Sound field	HT-CT800, SRS-ZR5, HT-ST5000, HT-ZF9, HT-Z9F, HT-MT500
master#power	Switch	RW	Main power on/off	STR-DN1080
master#soundField	String	RW	Sound field	STR-DN1080
zone1#power	Switch	RW	Power for zone1 for devices supporting multizone	STR-DN1080
zone1#input	String	RW	Set or get the input source for zone1 for devices supporting multizone	STR-DN1080
zone1#volume	Dimmer	RW	Set or get the zone1 volume for devices supporting multizone	STR-DN1080
zone1#mute	Switch	RW	Set or get the mute state for zone1 volume	STR-DN1080
zone2#power	Switch	RW	Power for zone2 for devices supporting multizone	STR-DN1080
zone2#input	String	RW	Set or get the input source for zone2 for devices supporting multizone	STR-DN1080
zone2#volume	Dimmer	RW	Set or get the zone2 volume for devices supporting multizone	STR-DN1080
zone2#mute	Switch	RW	Set or get the mute state for zone2 volume	STR-DN1080
zone3#power	Switch	RW	Power for zone3 for devices supporting multizone	none
zone3#input	String	RW	Set or get the input source for zone3 for devices supporting multizone	none
zone3#volume	Dimmer	RW	Set or get the zone3 volume for devices supporting multizone	none
zone3#mute	Switch	RW	Set or get the mute state for zone3 volume	none
zone4#power	Switch	RW	Power for zone4 for devices supporting multizone	STR-DN1080
zone4#input	String	RW	Set or get the input source for zone4 for devices supporting multizone	STR-DN1080
radio#broadcastFreq	Number	R	Current radio frequency	STR-DN1080
radio#broadcastStation	Number	RW	Set or get current preset radio station	STR-DN1080
radio#broadcastSeekStation	String	W	Seek for a new broadcast station: forward "fwdSeeking", backward "bwdSeeking"	STR-DN1080
nightMode	Switch	RW	Set or get the Night Mode state	HT-ZF9

Full Example

demo.things:

Thing sonyaudio:HT-ST5000:living [ipAddress="192.168.123.123"]

demo.items:

Group SonyAudio <sonyaudio>

Dimmer Sony_Volume       "Volume [%.0f %%]"  <soundvolume>      (SonyAudio) {channel="sonyaudio:HT-ST5000:living:volume"}
Switch Sony_Mute         "Mute"              <soundvolume_mute> (SonyAudio) {channel="sonyaudio:HT-ST5000:living:mute"}
String Sony_Sound_Field  "Sound Field: [%s]" <text>             (SonyAudio) {channel="sonyaudio:HT-ST5000:living:soundField"}

demo.sitemap:

sitemap demo label="Main Menu" {
    Frame label="Sony" {
        Text label="Volume" icon="soundvolume" {
            Slider item=Sony_Volume
            Switch item=Sony_Mute
        }
        Text item=Sony_Sound_Field
    }
}