Siri Voice Control

Driver & Setup Guide - Version 0.13

Control your RTI system with Siri. Say "Hey Siri, movie mode" on an iPhone, iPad or HomePod and this driver runs the RTI macro you mapped to that phrase. Commands travel over a secure cloud link, so they work from anywhere - home Wi-Fi, cellular, even from the car on the way home.

Key features

- Any Apple device - iPhone, iPad or HomePod, completely hands-free.

- Works anywhere - a secure cloud relay keeps voice control working off-Wi-Fi and on cellular.

- Map any command - each phrase runs an RTI macro (scenes, all-off, lighting) or a function with a value (volume, level).

- One-click Discover - each processor gets its own token from its MAC, with a ready-made client setup link.

- Up to 20 voice commands per processor, plus an optional on-LAN endpoint.

- 120-minute free trial built in.

Part A - Set up in Integration Designer (once)

1. Add the driver

Drivers - add the Siri Voice Control driver and assign it to your RTI XP processor. Leave the Pairing Token field BLANK; each processor generates its own token from its MAC address.

2. Get the token (Discover)

Deploy to the processor, then right-click the driver and choose "Siri: Discover token". Enter the processor's IP address - it reads the processor, fills in the Pairing Token, and shows you the client setup link to send. (You can also read the token any time from the Pairing Token variable in Driver Info, or the debug console token command.)

3. Map your voice commands

For each Voice Command slot set:

- Phrase / slug - the short id the shortcut sends, e.g. movie_mode. Spaces become underscores.

- Run Macro - the RTI macro to run (scenes, all off, lighting), OR

- Run Function + Function Value - a function that takes a number (volume, level).

Up to 20 commands per processor.

4. Deploy

Deploy again. The Pairing Token and Client Setup Link variables are now populated - that link is what you send the customer.

Part B - On the customer's iPhone or iPad

Send the customer their setup link (the one Discover gave you). It looks like this, with this processor's token on the end:

https://shpdrivers.services/siri/setup/YOUR-TOKEN

Open it on the iPhone or iPad. Everything they need is on that page: a QR code that installs the shortcut, the exact command names (with Copy Slug buttons), and step-by-step instructions.

1. Scan the QR code (or tap Import). The QR on the setup page installs a ready-made shortcut straight onto the phone - just tap Add Shortcut. No building from scratch.

2. Open the shortcut, tap Get Contents of URL, and set the token field to your Pairing Token and the cmd field to one of your commands (tap Copy Slug on the setup page so it matches exactly).

3. Rename the shortcut to what you'll say (e.g. "Movie Mode"), test it with the play button, then say "Hey Siri, Movie Mode".

4. Duplicate it for each command. The QR installs one shortcut - for the rest, long-press it, Duplicate, rename, and change ONLY the cmd field.

Important - the cmd must match exactly

The cmd your shortcut sends must match a Phrase / slug you mapped in the driver, exactly. Copy it from the setup page with the Copy Slug button to avoid typos. A mismatch (for example sending all_lights_off when the driver has all_light_off, or move_mode instead of movie_mode) is delivered and appears to succeed, but runs a generic catch-all instead of your macro - so nothing happens.

Important - naming your spoken phrases

Siri reserves everyday home-control words for HomeKit. If you name a shortcut with words like lights, lamp, turn on, turn off, dim, brightness, thermostat, lock or door, Siri may answer "you have no lights set up" and never run your shortcut. The shortcut's NAME (what you say) is separate from the cmd field, so keep the cmd as your slug and rename the shortcut to a distinctive phrase - e.g. "Blackout", "Cinema Off" or "Goodnight" instead of "All Lights Off".

Local option (no cloud)

The driver also listens directly on the home network (Local Endpoint, default port 8354). A shortcut can POST to http://PROCESSOR-IP:8354/siri instead of the cloud - useful when the phone or HomePod is always on the home Wi-Fi. Set an Auth Token to require a secret on that endpoint.

Licensing - how to get your key

The driver runs fully for a 120-minute trial every time the processor reboots - plenty of time to set up and demo. To license it permanently:

1. Read the processor's MAC from the driver's MAC For Key variable (Driver Info).

2. Buy a licence for that processor from the Smart Home Programming store - you'll be issued a key tied to that MAC:

https://smarthomeprogramming.com.au/store/?product=siri-voice-control

3. Paste the key into the Licence Key setting in Driver Properties and deploy.

Live status keeps updating after the trial; only command dispatch is gated until a valid key is entered.

Diagnostics

- Debug console: telnet the processor on the Debug Console Port (default 12533). Type help, status, token, or cmd followed by a slug.

- Remote Logging: enable in Driver Properties (or the Remote Logging On function) to stream logs to SHP support.

- If your network cannot resolve shpdrivers.services, set Relay Host to 209.38.27.58.

- Command "delivered" but nothing happens: the cmd does not exactly match a mapped slug. Use Copy Slug on the setup page.

- Siri says "you have no lights set up": the spoken phrase collides with HomeKit. Rename the shortcut.

Support

Smart Home Programming

https://smarthomeprogramming.com.au

Email support via the website contact form. Include your processor MAC (MAC For Key) and, if asked, enable Remote Logging so we can see the live driver output.