Connect with a known state.
Need direct help? Email [email protected]. Include app version/build, iOS version, endpoint implementation/version, and the exact error text. Never send credentials.
Requirements
- iPhone or iPad with iOS/iPadOS 17 or later.
- A trusted local network with client-to-endpoint TCP access.
- A Generic Link v1 endpoint. The default reference port is
5200, but profiles may use any valid TCP port.
First connection
- Connect the endpoint and Apple device to the same trusted network.
- Open More › Processors › Add processor.
- Enter a friendly name, local IP/host and TCP port.
- Allow Local Network access when iOS asks.
- Wait for identity, capabilities and the first complete snapshot.
- Review the state, then tap the lock in the operator bar to enable writes.
Connection troubleshooting
- Verify the IP and port and confirm both devices can communicate on the same subnet.
- Disable VPN, guest Wi-Fi or wireless client isolation while testing.
- Check Local Network permission in iOS Settings › Privacy & Security.
- Confirm the endpoint implements Generic Link v1 and accepts one JSON object per line.
- If a result is indeterminate, let the app read state back and unlock only after verification.
Controls are intentionally missing
The app hides a feature when the endpoint does not declare its capability. A control that appears in full Demo Mode may be absent on a limited endpoint. This is expected and prevents an unavailable function from looking operational.
Demo and reference endpoint
Use Try full demo for an offline workflow. Developers and integrators can implement the documented Generic Link contract or run the Generic Reference Processor supplied with the project.
Operational safety
Test writes on a non-production display first. EDID, output format, blackout, test patterns, preset overwrite/clear and other disruptive actions require deliberate confirmation. Writes are never retried automatically.