Link Search Menu Expand Document

HTControlService

The HTControlService is available on these models: v1-S9.

  1. Available actions
    1. CommitLearnedIRCodes
    2. GetIRRepeaterState
    3. GetLEDFeedbackState
    4. IdentifyIRRemote
    5. IsRemoteConfigured
    6. LearnIRCode
    7. SetIRRepeaterState
    8. SetLEDFeedbackState
  2. Events
    1. Subscribe to events
    2. Event variables

Service data

name value
Control URL http://192.168.x.x:1400/HTControl/Control
Event subscription URL http://192.168.x.x:1400/HTControl/Event
Discovery url http://192.168.x.x:1400/xml/HTControl1.xml
Service ID urn:upnp-org:serviceId:HTControl
Service type urn:schemas-upnp-org:service:HTControl:1

Sample request

POST /HTControl/Control
Host: 192.168.x.x:1400
soapaction: "urn:schemas-upnp-org:service:HTControl:1#{ActionName}"
Content-Type: text/xml; charset="utf-8"

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" s:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <s:Body>
    {ActionBodyHere}
  </s:Body>
</s:Envelope>

Available actions

CommitLearnedIRCodes

Action body:

<u:CommitLearnedIRCodes xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
  <Name>string</Name>
</u:CommitLearnedIRCodes>

Inputs:

parameter type description
Name string Β 

GetIRRepeaterState

Action body:

<u:GetIRRepeaterState xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
</u:GetIRRepeaterState>

No input arguments

Outputs:

parameter type description
CurrentIRRepeaterState string Possible values: On / Off / Disabled

GetLEDFeedbackState

Action body:

<u:GetLEDFeedbackState xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
</u:GetLEDFeedbackState>

No input arguments

Outputs:

parameter type description
LEDFeedbackState string Possible values: On / Off

IdentifyIRRemote

Action body:

<u:IdentifyIRRemote xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
  <Timeout>ui4</Timeout>
</u:IdentifyIRRemote>

Inputs:

parameter type description
Timeout ui4 Β 

IsRemoteConfigured

Action body:

<u:IsRemoteConfigured xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
</u:IsRemoteConfigured>

No input arguments

Outputs:

parameter type description
RemoteConfigured boolean Β 

LearnIRCode

Action body:

<u:LearnIRCode xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
  <IRCode>string</IRCode>
  <Timeout>ui4</Timeout>
</u:LearnIRCode>

Inputs:

parameter type description
IRCode string Β 
Timeout ui4 Β 

SetIRRepeaterState

Action body:

<u:SetIRRepeaterState xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
  <DesiredIRRepeaterState>string</DesiredIRRepeaterState>
</u:SetIRRepeaterState>

Inputs:

parameter type description
DesiredIRRepeaterState string Allowed values: On / Off / Disabled

SetLEDFeedbackState

Action body:

<u:SetLEDFeedbackState xmlns:u="urn:schemas-upnp-org:service:HTControl:1">
  <LEDFeedbackState>string</LEDFeedbackState>
</u:SetLEDFeedbackState>

Inputs:

parameter type description
LEDFeedbackState string Allowed values: On / Off

Events

The HTControlService has variables that might be emitted if you subscribe to events.

Subscribe to events

SUBSCRIBE /HTControl/Event
Host: 192.168.x.x:1400
callback: <http://...>
NT: upnp:event
Timeout: Second-3600

Event variables

Variable Sends events* type possible values
IRRepeaterState βœ” string On / Off / Disabled
LEDFeedbackState ❌ string On / Off
RemoteConfigured ❌ boolean  
TOSLinkConnected βœ” boolean Β 

If the variable has a βœ” in the Sends events column, the service discovery specifies this variable emits events. A ❌ doesn’t mean that is won’t emit events.


This file is automatically generated with @svrooij/sonos-docs, do not edit manually.