Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
A SmartThings SmartApp for controlling your DirecTV receivers.
/**
* DirecThings v0.32
*
* Created by Joe Beeson <jbeeson@gmail.com>
*
* This is free and unencumbered software released into the public domain.
*
* Anyone is free to copy, modify, publish, use, compile, sell, or
* distribute this software, either in source code form or as a compiled
* binary, for any purpose, commercial or non-commercial, and by any
* means.
*
* In jurisdictions that recognize copyright laws, the author or authors
* of this software dedicate any and all copyright interest in the
* software to the public domain. We make this dedication for the benefit
* of the public at large and to the detriment of our heirs and
* successors. We intend this dedication to be an overt act of
* relinquishment in perpetuity of all present and future rights to this
* software under copyright law.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
* IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*
* For more information, please refer to <http://unlicense.org/>
*/
include 'asynchttp_v1'
// /info/mode, 0 = on, 1 = off
definition(
author : "Joe Beeson",
category : "Convenience",
description: "Control your DirecTV receiver",
iconUrl : "http://a4.mzstatic.com/us/r30/Purple18/v4/41/93/a8/4193a8ee-0863-0458-7d03-fd050517c400/icon175x175.jpeg",
iconX2Url : "http://a4.mzstatic.com/us/r30/Purple18/v4/41/93/a8/4193a8ee-0863-0458-7d03-fd050517c400/icon175x175.jpeg",
iconX3Url : "http://a4.mzstatic.com/us/r30/Purple18/v4/41/93/a8/4193a8ee-0863-0458-7d03-fd050517c400/icon175x175.jpeg",
name : "DirecThings",
namespace : "joebeeson"
)
preferences {
section("Receiver") {
href(
description: "For help with setting up your receivers to be remotely controlled, click here.",
name : "hrefNotRequired",
required : false,
style : "external",
title : "Receiver remote control help",
url : "https://support.directv.com/app/answers/detail/a_id/3150/~/i%E2%80%99m-having-trouble-with-the-receiver-control-feature-on-my-directv-app.-what"
)
input(
name : "receiverIpStr",
required: true,
type : "text",
title : "IP Address"
)
input(
defaultValue: 8080,
name : "receiverPortInt",
range : "1..65535",
required : true,
type : "number",
title : "Port"
)
paragraph "You only need to set the below field if attempting to control a client (not primary) receiver."
input(
defaulValue: "0",
name : "receiverMacStr",
required : false,
type : "text",
title : "MAC Address"
)
}
section("Control power with this switch") {
input(
name : "monitorSwitchObj",
required: false,
type : "capability.switch"
)
}
}
/**
* Using a Switch "Off" event, send the "poweroff" key.
*
* @param eventWrapperObj EventWrapper object.
*/
def doHandleSwitchOffEvent(eventWrapperObj) {
doReceiverRequestKey("poweroff")
}
/**
* Using a Switch "On" event, send the "poweron" key.
*
* @param eventWrapperObj EventWrapper object.
*/
def doHandleSwitchOnEvent(eventWrapperObj) {
doReceiverRequestKey("poweron")
}
/**
* Sends a receiver request to press a key.
*
* @param keyNameStr Name of the key to send.
* @see doReceiverRequest
*/
def doReceiverRequestKey(keyNameStr) {
log.debug "[doReceiverRequestKey] Sending key '${keyNameStr}'"
return doReceiverRequest(
"/remote/processKey",
[
hold: "keyPress",
key : keyNameStr
]
)
}
/**
* Sends a tuning request.
*
* @param channelNumberStr The channel number in either "###" or "###-###" format.
*/
def doReceiverRequestTune(channelNumberStr) {
channelNumberStr = channelNumberStr.tokenize(".")[0]
def channelMajorStr = channelNumberStr.tokenize("-")[0]
def channelMinorStr = channelNumberStr.tokenize("-")[1]
doReceiverRequest(
"/tv/tune",
[
major: channelMajorStr,
minor: (channelMinorStr ?: "65535")
]
)
}
def doReceiverModeAsyncRequest() {
return sendHubCommand(
new physicalgraph.device.HubAction(
headers: [
HOST: "${settings.receiverIpStr}:${receiverPortInt}"
],
method : "GET",
path : "/info/mode",
query : []
)
)
}
/**
* Send a receiver request.
*
* @param requestUrlStr The path, without query parameters, to send. Required.
* @param requestQueryMap Query parameters to send. Default empty.
* @param requestMethodStr HTTP Method to use for the request. Default "GET"
*/
def doReceiverRequest(requestUrlStr, requestQueryMap = [], requestMethodStr = "GET") {
log.debug "[doReceiverRequest] Requesting '${requestUrlStr} with query " +
"'${requestQueryMap}' as '${requestMethodStr}' to " +
"'${settings.receiverIpStr}:${receiverPortInt}'"
return sendHubCommand(
new physicalgraph.device.HubAction(
headers: [
HOST: "${settings.receiverIpStr}:${receiverPortInt}"
],
method : requestMethodStr,
path : requestUrlStr,
query : requestQueryMap + [
clientAddr: (settings.receiverMacStr ?: "0").replace(":", "").toUpperCase()
]
)
)
}
def installed() {
log.debug "[installed] Installed with settings: ${settings}"
initialize()
}
def updated() {
log.debug "[updated] Updated with settings: ${settings}"
unschedule()
unsubscribe()
initialize()
}
def lanResponseHandler(evt) {
def response = new groovy.json.JsonSlurper().parseText(
parseLanMessage(evt.description).body
)
unsubscribe([settings.monitorSwitchObj])
if (response.mode == 1) {
if (settings.monitorSwitchObj.currentSwitch != "off") {
log.debug("Device appears off, but switch is on. Changing switch state...")
settings.monitorSwitchObj.off()
}
} else {
if (settings.monitorSwitchObj.currentSwitch != "on") {
log.debug("Device appears on, but switch is off. Changing switch state...")
settings.monitorSwitchObj.on()
}
}
subscribe(settings.monitorSwitchObj, "switch.on", "doHandleSwitchOnEvent")
subscribe(settings.monitorSwitchObj, "switch.off", "doHandleSwitchOffEvent")
runIn(5, doReceiverModeAsyncRequest)
}
def initialize() {
subscribe(location, null, lanResponseHandler, [filterEvents:false])
if (settings.monitorSwitchObj) {
runIn(5, doReceiverModeAsyncRequest)
}
}
@Dave-Owens

This comment has been minimized.

Copy link

@Dave-Owens Dave-Owens commented Aug 18, 2017

Hi Joe, I'm new to this. Where do I edit to add my ip address, port# and MAC address? With or withour quotes? Any other areas I need to edit? I used a github code for an Alexa skill for DirecTV but it won't turn-on, turn-off the mini geni, so I want to try yours.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment