Generic Link v1

Generic Link is an original, manufacturer-neutral semantic protocol. It is not derived from or presented as an implementation of a third-party hardware protocol.

Wire contract

• TCP on a user-configured local endpoint.
• UTF-8 JSON Lines, one envelope per line.
• 1 MiB maximum message size.
• Version and UUID request ID required.
• Three-step handshake: hello, capabilities, synchronize.
• Complete snapshot after every confirmed write.

Safe command surface

Generic Link defines semantic writes for layer state/routing/geometry/crop/opacity, input color/backup/EDID, presets, display state, output format, sync, audio and transitions. It has no raw command or executable extension primitive.

Result semantics

An endpoint returns confirmed, rejected or indeterminate. The app never automatically retries a write. It reads the complete state after uncertainty and relocks controls.

Security boundary

Version 1 is intended only for trusted, isolated local networks. It is not encrypted and should not be exposed directly to the public internet. Remote access and discovery are outside v1.

Build an endpoint

Use the published field model and the fictional Generic Reference Processor as conformance guidance. An endpoint must truthfully advertise only the features and ranges it can read and confirm.