Crestron DirecTV Driver
✨ New🚀 Early AccessCrestron SIMPL+ module for DirecTV receivers over SHEF (HTTP, port 8080): power, every remote key, direct tune, 15 presets and Genie clients, with channel and programme feedback.
🚀 Early Access: an untested release. It may have bugs or missing features and will change before 1.0. Sales are final. Your license includes 1.0 and every later update.
Screenshots
Overview
Power on, off and toggle; every SHEF remote key, from the number pad and channel keys to the transport, guide, menu, arrow and colour keys; direct tune by channel text (206, 206-1 or 206.1); and 15 channel presets, each set from the program or a touch panel. Genie clients are reached by their MAC address.
Feedback shows the power state, the current channel and callsign, the programme and episode title and rating, refreshed shortly after every channel change and by a regular poll, with recording, off-air, pay-per-view and on-demand flags and the receiver's ID, software and SHEF versions. A receiver that stops answering is reported within seconds and picked up again by itself, and Connected is shown only for a recognisable SHEF reply, so another device on port 8080 shows an error instead.
The download includes the SIMPL+ module (.usp and .ush), a sample SIMPL Windows program, an HTML5 touch panel, a join reference and the manual. Built for 3-Series and 4-Series processors. The receiver needs External Access set to Allow on its External Device screen (and Current Program set to Allow for programme feedback). RS-232 control and key hold are not included. A 30-minute trial runs on every program start, and activation uses an offline code, so the processor needs no internet connection.
Features
A SIMPL+ module for DirecTV receivers, speaking DirecTV's SHEF control interface (HTTP on TCP port 8080) over your local network. It is compiled into your SIMPL Windows program like any other module and exposes ordinary digital, analog and serial signals.
Control
- Power on, power off, power toggle.
- Every SHEF remote key: channel up and down, previous channel, the number pad with dash and enter, play, pause, stop, fast forward, rewind, record, replay, advance, guide, menu, list, exit, back, info, select, the arrows, the colour keys, Active and Format.
- Direct tune by channel text:
206,206-1or206.1. - 15 channel presets; each preset's channel is set from the program or a touch panel.
- Genie clients, by the client's MAC address.
Feedback
- Power state: Active, Standby or Unknown.
- Current channel, callsign, programme title, episode title and rating, refreshed 1.2 seconds after every channel change and by a regular status poll.
- Recording, off-air, pay-per-view and on-demand flags; parental-lock state as DirecTV defines it.
- Receiver ID, software version, SHEF version and access card ID.
Connection
- Local network only: plain HTTP to the receiver. Nothing leaves the site.
- One request at a time, one connection per request. A receiver that stops answering is reported within seconds, and the module keeps polling, so it is picked up again by itself when the receiver is back (there is no lasting connection to re-establish).
- "Connected" is shown only when the reply is recognisably a SHEF reply, so another device answering on port 8080 shows an error, not "Connected".
- Diagnostics on the module's own signals: connection state, last request, last reply, last error, and traffic counters.
Licensing
- 30-minute trial on every program start; no code needed to evaluate.
- Activation with an offline activation code from the AchKayEm licensing portal. The processor needs no internet connection.
- The license is stored on the processor and checked again on every start (that it survives a reboot, and a change of program, is still to be confirmed on a processor).
- One activation serves every instance of the module on the processor.
- An activation code names the control processor it was issued for. The module can check that only if a Console symbol is wired to it to read the processor's address; without one it accepts the code and says "processor not checked", so the lock is advisory in this module.
Requirements. A DirecTV receiver with SHEF and External Access = Allow on its External Device screen (all DirecTV requires), and Current Program = Allow as HKM's reading of the screen for the channel and programme feedback (DirecTV's own menu path is Menu → System Setup → Whole-Home → External Device; newer receivers may differ). The receiver must be reachable from the processor on TCP port 8080 at a fixed address. A Crestron control system programmed in SIMPL Windows: the module is built for 3-Series and 4-Series: compiled for both; version 0.4.7 ran on a 4-Series processor (an RMC4) against an emulator of the receiver; not yet run on a 3-Series.
Scope note. RS-232 control and key hold are not included. This version has been tested against a
receiver emulator and DirecTV's published sample replies, not yet against a receiver. How a real
receiver ends its replies is not documented by DirecTV; the module accepts a reply as complete when
a whole JSON object has arrived, or its Content-Length is satisfied, or the receiver closes, and
decodes chunked replies; it closes each connection itself (see the manual). The channel text 206- is
refused ("Invalid channel"); a minor channel of 0 or above 999 is not sent but the channel is still
tuned. Both are open decisions.
Version history
Beta Pre-release
