Crestron NVidia Shield
Intro PriceCrestron driver for the NVIDIA SHIELD TV over ADB: power, the full remote, twelve apps by name, typed text, and power and app feedback, as a native Video Server device.
Screenshots
Overview
Wake and sleep the Shield; send the d-pad, OK, Home, Back, Menu, the transport and number keys; and launch twelve apps directly: Netflix, YouTube, Plex, Kodi, Disney+, Prime Video, Spotify, Hulu, Max, Apple TV, Twitch and Steam Link. Any other app launches by its package name, and text can be typed into the focused field for searches and sign-ins. Volume and mute go to the TV over HDMI-CEC.
Feedback shows whether the Shield is awake, which of the twelve apps is in front, and whether the Shield has accepted the driver's key. The key is made on the processor at the first connect and never leaves it; its fingerprint is shown so it can be checked against the Shield's on-screen prompt. The driver sends only a fixed set of commands, never a free shell command.
The download includes the driver package, a sample SIMPL Windows program, an HTML5 touch panel and the manual. Built for 4-Series processors; the package also loads on a 3-Series. The Shield needs Network debugging turned on in Developer options and a fixed address. A 30-minute trial runs on every program start; a licence key or an offline activation code activates it, so the processor needs no internet connection.
Features
Crestron driver for the NVIDIA SHIELD TV, controlling it over your local network through Android's developer interface
(ADB, TCP 5555, RSA-2048 authentication). Native Video Server device type (Driver SDK V1 / RAD): in SIMPL it is
loaded from a .pkg by Crestron's stock Crestron Device Drivers VideoServer Ethernet module (v2.5); for 4-Series
processors (the Compact Framework package loads on a 3-Series as well).
Safety and intended use. This driver is a convenience interface between a Crestron program and an NVIDIA SHIELD TV streaming player. It is not a life-safety, security, medical or critical control product, and it must never be the sole means of controlling or monitoring anything whose failure can injure a person or damage property. It drives the Shield through Android's developer interface (ADB over the network, Network debugging), which gives whoever holds a key the Shield trusts the control a developer has. The driver sends only a fixed set of commands - remote keys, app launches, typed text and a read-only status poll - and never a command a program or a panel could compose; the integrator who turns Network debugging on is responsible for keeping the Shield on a trusted network, for the security of the processor that holds the key, and for the instructions given to the people who live or work with it. Feedback is polled and may lag by one poll interval; control stops when the licence trial ends or a licence is refused, and the last commanded state stands; commands waiting when the connection is lost are discarded, not sent later. The driver's ADB key is a credential: it never leaves the processor, and Forget Key replaces it.
Which Shields
- SHIELD TV Pro (2019), SHIELD TV (2019), SHIELD TV (2017) and SHIELD Android TV (2015) on SHIELD Experience 9.x (Android TV 11).
Before you start
- On the Shield: Settings > Device Preferences > About, select Build seven times; then Developer options > Network debugging on.
- A fixed IP address for the Shield (a DHCP reservation).
- At the first Connect, accept "Allow network debugging?" on the TV with Always allow ticked, after checking the key fingerprint against the driver's.
Control
- Power on (wake), power off (sleep), power toggle.
- The d-pad and OK; Home, Back, Menu, Search, Info, Guide; play/pause, play, pause, stop, rewind, fast forward, previous, next; the number pad; channel up/down, Live, Record, the four colour keys.
- Twelve apps as media services: Netflix, YouTube, Plex, Kodi, Disney+, Prime Video, Spotify, Hulu, Max, Apple TV,
Twitch, Steam Link. Any other app by its package name (
app:<package>onSend_Custom_Command_In$). - Typed text into the focused field (
text:<text>): searches, user names. - Volume up, down and mute (custom commands), carried to the TV over HDMI-CEC.
Feedback
Connection_FandAuthenticationStatus: the Shield has accepted the driver's key.Power_F: the Shield is awake.ActiveMediaService_FriendlyName: the app in front, when it is one of the twelve.RxOut: the Shield's last reply, and the key fingerprint while the TV's question waits.- Polled every 3 seconds (2-30 s), and 700 ms after a power key, an app launch, Home or Back.
The key
- Made on the processor at the first Connect, kept in its NVRAM folder; the private half never leaves the processor.
- Its fingerprint on the processor console (again whenever the Show Key custom command is pulsed) and on RxOut.
- Forget Key makes a new one (the Shield then asks again). One key for every Shield in the program, or one per driver with the Key Name attribute.
In the zip
- The driver package (
3-Series/ships;4-Series/for comparison), the user manual, an HTML5 touch panel for a 4-Series processor's Web XPanel, and a sample SIMPL Windows program.
Licensing
- 30-minute trial from every program start; then controls are refused and feedback continues.
- A licence key or an offline activation code from Vault (user attribute 2, or the touch panel's Setup card) activates the driver on that processor (bound to its MAC address); an offline code needs no internet connection.
Version history
- Initial Release
