In order to get a standardized implementation for the user there must be some definitions. Vision App Control should be designed as an input source like DMX,CRMX or ArtNet.

Name of input Source: „VISION APP“ or when there is not enough characters use „VC APP“.

The VISION APP menu is structured into one action, one optional setting and a group of read-only information items. The table below lists all entries that should be exposed to the user:

Level 1	Level 2	Level 3	Type	Description
VISION APP	Unlink		Action	Unlinks the fixture from the network. Needs to be confirmed by the user.
	App Visibility	Vision Active*	Setting (optional)	Vision is selected as Input Source.
		Input Inactive		Vision becomes active when no other active Input Source is available.
		Always		Vision is always active.
	Information	State	Information (read-only)	Current link state: Unlinked / Linked / Active / Master / Inactive.
		Network Name		Name of the network the fixture is linked to.
		Signal Quality		Signal quality in % (0 – 100).
		UUID		Unique identifier of the fixture.

Note: The App Visibility setting is optional. If it is not implemented, the fixture should behave as if „Vision Active“ was selected.

Vision-related Fixture Settings (Battery)

The following fixture settings are optional, but recommended because they are surfaced and used by the Vision Control app. If implemented, they should be reachable from the regular fixture menu (typically under General Settings and Fixture Brightness).

Setting	Options	Type	Description
AC Emergency	OFF* / ON	Setting (optional)	Defines fixture behaviour during AC emergency. The Vision app only toggles this setting On / Off.
Battery Runtime	OFF* Remaining Time: xx	Setting (optional)	Battery runtime limit disabled.
	Full battery: 2 h Remaining Time: xx		Target runtime 2 h.
	Full battery: 4 h Remaining Time: xx … Full battery: 22 h Remaining Time: xx		Target runtime selectable in 2 h steps.
	Full battery: 24 h Remaining Time: xx		Maximum target runtime.

Full Menu Example

The following example shows how the VISION APP entries can be embedded into a complete fixture menu, alongside common fixture settings. Default values are marked with a „*“.

Level 1	Level 2	Level 3	Level 4	Description / Default
DMX Settings	DMX Address	1 – 512		Default: 1.
	DMX Mode	RGB / RGBL / …		Default: RGB
Input Source	Wired DMX			Wired DMX input.
	CRMX			Wireless CRMX input.
	Vision App			Make sure CRMX is off in this mode.
	Master / Slave	Set as Master / Set as Slave		Default: Slave.
Input Settings	Vision App	Unlink	Yes / No	Action — unlinks fixture from network.
		Visibility (optional)	Vision Active* / Input Inactive / Always	Default: Vision Only.
		Information	State / Network Name	Read-only.
			Signal Quality / UUID	Read-only.
	CRMX	Unlink	Yes / No*	Unlinks CRMX network.
Dimmer Settings	Dimmer Curve	Linear / Square / Square Inv / S-Curve*		Default: S-Curve.
	Dimmer Response	Off* / Slow / Middle / Fast / Very Fast		Default: Off.
Fixture Settings	AC Emergency	OFF* / Hold / Blackout / White / Color Macro		Behaviour on AC emergency. The Vision app only toggles this setting On / Off.
	Battery Runtime	OFF* Remaining Time: xx		Battery runtime limit disabled.
		Full battery: 2 h Remaining Time: xx		Target runtime 2 h.
		Full battery: 4 h Remaining Time: xx … Full battery: 22 h Remaining Time: xx		Target runtime selectable in 2 h steps.
		Full battery: 24 h Remaining Time: xx		Maximum target runtime.
	DMX Fail	Hold* / Blackout		Behaviour on DMX signal loss.
Factory Defaults	Yes / No		Resets all settings to factory defaults.
Information	Device Hours			Standard RDM counter (PID 0x0400). Total runtime of fixture.
	Lamp Hours			Standard RDM counter (PID 0x0401). Total LED runtime; the Vision app uses this as LED hours.
	Device Power Cycles			Standard RDM counter (PID 0x0405). Total power cycles.
	RDM ID			Unique RDM device identifier.
	Software Version			Firmware / software version of the fixture.
	Sensors			Sensors like temperature/td>

Anti-Theft Lockscreen

When the fixture is locked via the Anti-Theft feature, the display should clearly indicate this state and tell the user how to unlock it. The recommended message is:

Anti-Theft is active: Use Vision Control app to unlock

For displays with limited character space, the following short variant can be used instead:

Anti-Theft: Unlock via Vision Control

How to get this information?

Unlink (Action) :

Using the Vision SPI Library this function can be found in „libIqMeshSpiInterface.h“ and is called „iqMesh_unlinkIqData“. This will unlink the fixture from an network created through the Vision App.

State (Information)

Using the Vision SPI Library this function can be found in „libIqMeshSpiInterface.h“ and is called iqMesh_getStatusFlags. The return type is iqmesh_status_flags_t. Inside this type you can find the iqmesh_iq_status_t which is the needed information.

Network Name (Information)

Using the Vision SPI Library this function can be found in „libIqMeshSpiInterface.h“ and is called iqMesh_getInformation.The return type is iqMesh_information_t which includes a 12 Bytes long network name.

Signal Quality (Information)

Using the Vision SPI Library this function can be found in „libIqMeshSpiInterface.h“ and is called iqMesh_getInformation.The return type is iqMesh_information_t which includes a signalQuality. 0 – 100: Quality in %

UUID (Information)

Using the Vision SPI Library this function can be found in „libIqMeshSpiInterface.h“ and is called iqMesh_getInformation.The return type is iqMesh_information_t which includes a uuid.