NanoOcp1::DS100 Namespace Reference

OCA object definitions for the d&b audiotechnik DS100 signal engine. More...

Classes
struct	dbOcaObjDef_MatrixSettings_ReverbRoomIdEnableds
struct	dbOcaObjDef_MatrixSettings_ReverbRoomIdNames
struct	dbOcaObjectDef_CoordinateMapping_Source_Position
	OCA definition for a sound object's position in a coordinate mapping area's virtual space. More...
struct	dbOcaObjectDef_CoordinateMappingSettings_Flip
struct	dbOcaObjectDef_CoordinateMappingSettings_Name
struct	dbOcaObjectDef_CoordinateMappingSettings_P1_real
struct	dbOcaObjectDef_CoordinateMappingSettings_P1_virtual
struct	dbOcaObjectDef_CoordinateMappingSettings_P2_real
struct	dbOcaObjectDef_CoordinateMappingSettings_P3_real
struct	dbOcaObjectDef_CoordinateMappingSettings_P3_virtual
struct	dbOcaObjectDef_CoordinateMappingSettings_P4_real
struct	dbOcaObjectDef_CoordinateMappingSettings_Type
struct	dbOcaObjectDef_Error_ErrorText
struct	dbOcaObjectDef_Error_GnrlErr
struct	dbOcaObjectDef_Fixed_GUID
	OCA definition for the DS100 firmware/model GUID string (read-only). More...
struct	dbOcaObjectDef_Fixed_HardwareVariant
	OCA definition for the DS100 hardware-variant identifier (read-only int32). More...
struct	dbOcaObjectDef_Fixed_SerNr
	OCA definition for the DS100 serial number string (read-only). More...
struct	dbOcaObjectDef_FunctionGroup_Delay
struct	dbOcaObjectDef_FunctionGroup_Name
struct	dbOcaObjectDef_FunctionGroup_SpreadFactor
struct	dbOcaObjectDef_MatrixInput_ChannelName
struct	dbOcaObjectDef_MatrixInput_Delay
struct	dbOcaObjectDef_MatrixInput_DelayEnable
struct	dbOcaObjectDef_MatrixInput_EqEnable
struct	dbOcaObjectDef_MatrixInput_Gain
struct	dbOcaObjectDef_MatrixInput_ISP
struct	dbOcaObjectDef_MatrixInput_LevelMeterIn
struct	dbOcaObjectDef_MatrixInput_LevelMeterPostMute
struct	dbOcaObjectDef_MatrixInput_LevelMeterPreMute
struct	dbOcaObjectDef_MatrixInput_Mute
struct	dbOcaObjectDef_MatrixInput_Polarity
struct	dbOcaObjectDef_MatrixInput_ReverbSendGain
struct	dbOcaObjectDef_MatrixNode_Delay
struct	dbOcaObjectDef_MatrixNode_DelayEnable
struct	dbOcaObjectDef_MatrixNode_Enable
struct	dbOcaObjectDef_MatrixNode_Gain
struct	dbOcaObjectDef_MatrixOutput_ChannelName
struct	dbOcaObjectDef_MatrixOutput_Delay
struct	dbOcaObjectDef_MatrixOutput_DelayEnable
struct	dbOcaObjectDef_MatrixOutput_EqEnable
struct	dbOcaObjectDef_MatrixOutput_Gain
struct	dbOcaObjectDef_MatrixOutput_LevelMeterIn
struct	dbOcaObjectDef_MatrixOutput_LevelMeterPostMute
struct	dbOcaObjectDef_MatrixOutput_LevelMeterPreMute
struct	dbOcaObjectDef_MatrixOutput_Mute
struct	dbOcaObjectDef_MatrixOutput_OSP
struct	dbOcaObjectDef_MatrixOutput_Polarity
struct	dbOcaObjectDef_MatrixSettings_PositioningEnable
struct	dbOcaObjectDef_MatrixSettings_ReverbEnable
struct	dbOcaObjectDef_MatrixSettings_ReverbPredelayFactor
struct	dbOcaObjectDef_MatrixSettings_ReverbRearLevel
struct	dbOcaObjectDef_MatrixSettings_ReverbRoomId
struct	dbOcaObjectDef_Positioning_Source_DelayMode
struct	dbOcaObjectDef_Positioning_Source_Enable
struct	dbOcaObjectDef_Positioning_Source_Position
	OCA definition for a sound object's 3D position in real-world space (En-Scene). More...
struct	dbOcaObjectDef_Positioning_Source_Speaker_Group
struct	dbOcaObjectDef_Positioning_Source_Speaker_Position
	OCA definition for loudspeaker 6-DOF position — legacy firmware only (stack-ident 0). More...
struct	dbOcaObjectDef_Positioning_Source_Spread
struct	dbOcaObjectDef_Positioning_Speaker_Group
struct	dbOcaObjectDef_Positioning_Speaker_Position
	OCA definition for loudspeaker 6-DOF position — firmware ≥ DB000CD0 (stack-ident 1). More...
struct	dbOcaObjectDef_ReverbInput_Gain
struct	dbOcaObjectDef_ReverbInputProcessing_EqEnable
struct	dbOcaObjectDef_ReverbInputProcessing_Gain
struct	dbOcaObjectDef_ReverbInputProcessing_LevelMeter
struct	dbOcaObjectDef_ReverbInputProcessing_Mute
struct	dbOcaObjectDef_Scene_SceneComment
struct	dbOcaObjectDef_Scene_SceneIndex
struct	dbOcaObjectDef_Scene_SceneName
struct	dbOcaObjectDef_SceneAgent
struct	dbOcaObjectDef_Settings_DeviceName
struct	dbOcaObjectDef_SoundObjectRouting_Gain
struct	dbOcaObjectDef_SoundObjectRouting_Mute
struct	dbOcaObjectDef_Status_AudioNetworkSampleStatus
struct	dbOcaObjectDef_Status_StatusText

Variables
static constexpr BoxAndObjNo	Fixed_Box = 0x00
	Box number for all Fixed (read-only) device identity objects.
static constexpr BoxAndObjNo	Fixed_HardwareVariant = 0x02
	Hardware variant code (int32).
static constexpr BoxAndObjNo	Fixed_SerNr = 0x0a
	Serial number string.
static constexpr BoxAndObjNo	Fixed_GUID = 0x0f
	8-char hex firmware/model GUID (e.g. "DB000CD0"). Read on connect to detect stack-ident.
static constexpr BoxAndObjNo	Settings_Box = 0x01
	Box number for writable device settings.
static constexpr BoxAndObjNo	Settings_DeviceName = 0x0d
	User-assignable device name string.
static constexpr BoxAndObjNo	Status_Box = 0x03
	Box number for read-only status objects.
static constexpr BoxAndObjNo	Status_StatusText = 0x03
	Human-readable device status string.
static constexpr BoxAndObjNo	Status_AudioNetworkSampleStatus = 0x30
	Audio network sample-rate/lock status.
static constexpr BoxAndObjNo	Error_Box = 0x04
	Box number for error-reporting objects.
static constexpr BoxAndObjNo	Error_GnrlErr = 0x01
	General error flag.
static constexpr BoxAndObjNo	Error_ErrorText = 0x03
	Human-readable error description string.
static constexpr BoxAndObjNo	MatrixSettings_Box = 0x02
	Box number for global matrix / En-Space / En-Scene settings.
static constexpr BoxAndObjNo	MatrixSettings_PositioningEnable = 0x02
	Enable / disable En-Scene object-based positioning globally.
static constexpr BoxAndObjNo	MatrixSettings_ReverbEnable = 0x03
	Enable / disable En-Space convolution reverb globally.
static constexpr BoxAndObjNo	MatrixSettings_ReverbRoomId = 0x0a
	En-Space room impulse-response selection (uint32 room index).
static constexpr BoxAndObjNo	MatrixSettings_ReverbPredelayFactor = 0x14
	Pre-delay scaling factor for the selected room (float32).
static constexpr BoxAndObjNo	MatrixSettings_ReverbRearLevel = 0x15
	Rear-channel level adjustment for the reverb tail (float32, dB).
static constexpr BoxAndObjNo	CoordinateMappingSettings_Box = 0x15
	Box number for coordinate-mapping corner-point configuration (per area).
static constexpr BoxAndObjNo	CoordinateMappingSettings_Name = 0x01
	Name string for this mapping area.
static constexpr BoxAndObjNo	CoordinateMappingSettings_Type = 0x02
	Mapping type (uint32 enum).
static constexpr BoxAndObjNo	CoordinateMappingSettings_Flip = 0x03
	Axis-flip flags (bool).
static constexpr BoxAndObjNo	CoordinateMappingSettings_P1_real = 0x04
	Corner point P1 in real-world coordinates (3 × float32 XYZ).
static constexpr BoxAndObjNo	CoordinateMappingSettings_P2_real = 0x05
	Corner point P2 in real-world coordinates.
static constexpr BoxAndObjNo	CoordinateMappingSettings_P3_real = 0x06
	Corner point P3 in real-world coordinates.
static constexpr BoxAndObjNo	CoordinateMappingSettings_P4_real = 0x07
	Corner point P4 in real-world coordinates.
static constexpr BoxAndObjNo	CoordinateMappingSettings_P1_virtual = 0x08
	Corner point P1 in virtual (mapped) coordinates.
static constexpr BoxAndObjNo	CoordinateMappingSettings_P3_virtual = 0x09
	Corner point P3 in virtual (mapped) coordinates.
static constexpr BoxAndObjNo	CoordinateMapping_Box = 0x16
	Box number for per-source coordinate-mapped positions (per area).
static constexpr BoxAndObjNo	CoordinateMapping_Source_Position = 0x01
	Source position in the virtual coordinate space of the mapping area (3 × float32 XYZ, blob).
static constexpr BoxAndObjNo	MatrixInput_Box = 0x05
	Box number for per-input-channel (sound object) parameters.
static constexpr BoxAndObjNo	MatrixInput_Mute = 0x01
	Input mute (bool: 0=unmuted, 1=muted).
static constexpr BoxAndObjNo	MatrixInput_Gain = 0x02
	Input gain in dB (float32).
static constexpr BoxAndObjNo	MatrixInput_Delay = 0x03
	Input delay in ms (float32).
static constexpr BoxAndObjNo	MatrixInput_DelayEnable = 0x04
	Input delay enable (bool).
static constexpr BoxAndObjNo	MatrixInput_EqEnable = 0x05
	Input EQ enable (bool).
static constexpr BoxAndObjNo	MatrixInput_Polarity = 0x06
	Input polarity invert (bool).
static constexpr BoxAndObjNo	MatrixInput_ChannelName = 0x07
	User-assignable input channel name (string).
static constexpr BoxAndObjNo	MatrixInput_LevelMeterIn = 0x08
	Pre-processing level meter reading (float32, dBFS).
static constexpr BoxAndObjNo	MatrixInput_LevelMeterPreMute = 0x09
	Pre-mute level meter reading (float32, dBFS).
static constexpr BoxAndObjNo	MatrixInput_LevelMeterPostMute = 0x0a
	Post-mute level meter reading (float32, dBFS).
static constexpr BoxAndObjNo	MatrixInput_ISP = 0x0b
	Input signal presence indicator (bool).
static constexpr BoxAndObjNo	MatrixInput_ReverbSendGain = 0x0d
	En-Space send gain for this input (float32, dB).
static constexpr BoxAndObjNo	MatrixNode_Box = 0x07
	Box number for per-crosspoint (input × output) routing parameters.
static constexpr BoxAndObjNo	MatrixNode_Enable = 0x01
	Crosspoint enable / mute (bool).
static constexpr BoxAndObjNo	MatrixNode_Gain = 0x02
	Crosspoint gain (float32, dB).
static constexpr BoxAndObjNo	MatrixNode_Delay = 0x03
	Crosspoint delay (float32, ms).
static constexpr BoxAndObjNo	MatrixNode_DelayEnable = 0x04
	Crosspoint delay enable (bool).
static constexpr BoxAndObjNo	MatrixOutput_Box = 0x08
	Box number for per-output-channel parameters.
static constexpr BoxAndObjNo	MatrixOutput_Mute = 0x01
	Output mute (bool).
static constexpr BoxAndObjNo	MatrixOutput_Gain = 0x02
	Output gain in dB (float32).
static constexpr BoxAndObjNo	MatrixOutput_Delay = 0x03
	Output delay in ms (float32).
static constexpr BoxAndObjNo	MatrixOutput_DelayEnable = 0x04
	Output delay enable (bool).
static constexpr BoxAndObjNo	MatrixOutput_EqEnable = 0x05
	Output EQ enable (bool).
static constexpr BoxAndObjNo	MatrixOutput_Polarity = 0x06
	Output polarity invert (bool).
static constexpr BoxAndObjNo	MatrixOutput_ChannelName = 0x07
	User-assignable output channel name (string).
static constexpr BoxAndObjNo	MatrixOutput_LevelMeterIn = 0x08
	Pre-processing level meter reading (float32, dBFS).
static constexpr BoxAndObjNo	MatrixOutput_LevelMeterPreMute = 0x09
	Pre-mute level meter reading (float32, dBFS).
static constexpr BoxAndObjNo	MatrixOutput_LevelMeterPostMute = 0x0a
	Post-mute level meter reading (float32, dBFS).
static constexpr BoxAndObjNo	MatrixOutput_OSP = 0x0b
	Output signal presence indicator (bool).
static constexpr BoxAndObjNo	Positioning_Source_Box = 0x0d
	Box number for per-sound-object En-Scene positioning parameters.
static constexpr BoxAndObjNo	Positioning_Source_Position = 0x02
	Sound object XYZ position in real-world space (3 × float32 blob, normalised 0–1).
static constexpr BoxAndObjNo	Positioning_Source_Enable = 0x03
	En-Scene processing enable for this sound object (bool).
static constexpr BoxAndObjNo	Positioning_Source_Spread = 0x04
	Sound object spread factor (float32, 0–1).
static constexpr BoxAndObjNo	Positioning_Source_Speaker_Group = 0x06
static constexpr BoxAndObjNo	Positioning_Source_Speaker_Position = 0x07
static constexpr BoxAndObjNo	Positioning_Source_DelayMode = 0x0b
	Delay mode for this sound object (uint32 enum).
static constexpr BoxAndObjNo	FunctionGroup_Box = 0x0e
	Box number for per-function-group parameters (groups 1–32).
static constexpr BoxAndObjNo	FunctionGroup_Name = 0x01
	User-assignable function group name (string).
static constexpr BoxAndObjNo	FunctionGroup_Delay = 0x02
	Group delay in ms (float32).
static constexpr BoxAndObjNo	FunctionGroup_SpreadFactor = 0x06
	Group spread factor (float32).
static constexpr BoxAndObjNo	ReverbInput_Box = 0x10
	Box number for per-(sound-object × reverb-zone) send parameters.
static constexpr BoxAndObjNo	ReverbInput_Gain = 0x01
	Send gain from sound object to reverb zone (float32, dB).
static constexpr BoxAndObjNo	ReverbInputProcessing_Box = 0x11
	Box number for per-reverb-send processing parameters.
static constexpr BoxAndObjNo	ReverbInputProcessing_Mute = 0x01
	Reverb send mute (bool).
static constexpr BoxAndObjNo	ReverbInputProcessing_Gain = 0x02
	Reverb send gain trim (float32, dB).
static constexpr BoxAndObjNo	ReverbInputProcessing_EqEnable = 0x03
	Reverb send EQ enable (bool).
static constexpr BoxAndObjNo	ReverbInputProcessing_LevelMeter = 0x05
	Reverb send level meter reading (float32, dBFS).
static constexpr BoxAndObjNo	Scene_Box = 0x17
	Box number for scene-related read/write objects.
static constexpr BoxAndObjNo	Scene_SceneIndex = 0x01
	Currently active scene index (uint32).
static constexpr BoxAndObjNo	Scene_SceneName = 0x03
	Name of the currently active scene (string).
static constexpr BoxAndObjNo	Scene_SceneComment = 0x04
	Comment text for the currently active scene (string).
static constexpr BoxAndObjNo	SoundObjectRouting_Box = 0x18
	Box number for per-(sound-object × function-group) routing parameters.
static constexpr BoxAndObjNo	SoundObjectRouting_Mute = 0x01
	Routing mute for this sound-object/function-group pair (bool).
static constexpr BoxAndObjNo	SoundObjectRouting_Gain = 0x02
	Routing gain for this sound-object/function-group pair (float32, dB).
static constexpr BoxAndObjNo	Positioning_Speaker_Box = 0x1a
	Box number for per-loudspeaker 6-DOF position parameters.
static constexpr BoxAndObjNo	Positioning_Speaker_Group = 0x01
	Function-group assignment for this loudspeaker output (uint32).
static constexpr BoxAndObjNo	Positioning_Speaker_Position = 0x02
	Loudspeaker 6-DOF position: [hor, vert, rot, x, y, z] (6 × float32 blob).
static constexpr std::uint32_t	SceneAgentONo = 0x2714
	Fixed ONo for the DS100 Scene Agent object.

Detailed Description

OCA object definitions for the d&b audiotechnik DS100 signal engine.

What is the DS100?

The DS100 is a d&b audiotechnik spatial audio signal engine used as the processing core of d&b Soundscape systems. It acts as an audio matrix and hosts two spatial processing engines:

• En-Scene — object-based panning: each sound object (matrix input) is positioned in real-world XY coordinates and routed to loudspeakers accordingly.
• En-Space — convolution reverb with four independent zones (L/C/R stage + audience area).

The DS100 comes in three hardware variants:

Variant	GUID suffix	Notes
DS100 (legacy Dante)	D0	Original model; stack-ident depends on firmware ≥ 0C.
DS100D (updated Dante)	D1	Always stack-ident 1.
DS100M (Milan)	D2	Stack-ident 1 from firmware ≥ 02.

OCA object model on the DS100

DS100 parameters are organised into functional boxes, each with a _Box ONo prefix and individual per-parameter BoxAndObjNo constants. The final ONo is computed by GetONoTy2() (most DS100 objects) or GetONo() (amp-style objects).

Box	Prefix	Description
Fixed	Fixed_Box = 0x00	Read-only device identity (GUID, serial, hardware variant).
Settings	Settings_Box = 0x01	Writable device settings (name).
Status	Status_Box = 0x03	Status text, audio network sample status.
MatrixSettings	MatrixSettings_Box = 0x02	En-Scene/En-Space enable, reverb parameters.
CoordinateMappingSettings	CoordinateMappingSettings_Box = 0x15	Corner-point definitions for mapping areas 1–4.
CoordinateMapping	CoordinateMapping_Box = 0x16	Per-source position in virtual/mapped space.
MatrixInput	MatrixInput_Box = 0x05	Per-input-channel (sound object): mute, gain, delay, EQ, level meters.
MatrixNode	MatrixNode_Box = 0x07	Per-crosspoint: enable, gain, delay.
MatrixOutput	MatrixOutput_Box = 0x08	Per-output-channel: mute, gain, delay, EQ, level meters.
Positioning (source)	Positioning_Source_Box = 0x0d	En-Scene position, spread, delay mode per sound object.
Positioning (speaker)	Positioning_Speaker_Box = 0x1a	6-DOF loudspeaker position per output. Introduced with GUID DB000CD0; earlier firmware used Positioning_Source_Speaker_Position.
FunctionGroup	FunctionGroup_Box = 0x0e	Named loudspeaker groups: delay, spread factor.
ReverbInput	ReverbInput_Box = 0x10	Send gain per sound object / zone.
ReverbInputProcessing	ReverbInputProcessing_Box = 0x11	Mute, gain, EQ per send.
Scene	Scene_Box = 0x17	Scene index, name, comment; scene recall uses the SceneAgent ONo.
SoundObjectRouting	SoundObjectRouting_Box = 0x18	Mute/gain per sound-object × function-group routing pair.

Firmware branching (stack-ident)

The speaker-position OCA definition changed between firmware generations. DeviceController reads Fixed_GUID immediately after connect, determines the stack-ident (0 = legacy, 1 = extended), and selects the correct definition struct:

• Stack 0: dbOcaObjectDef_Positioning_Source_Speaker_Position (deprecated object under Positioning_Source_Box).
• Stack 1+: dbOcaObjectDef_Positioning_Speaker_Position (dedicated Positioning_Speaker_Box).

Usage example (Umsci <tt>DeviceController</tt> pattern)

// Subscribe to and read sound-object 3 position:
DS100::dbOcaObjectDef_Positioning_Source_Position def(3);
uint32_t subHandle, getHandle;
client->sendData(Ocp1CommandResponseRequired(def.AddSubscriptionCommand(), subHandle).GetSerializedData());
client->sendData(Ocp1CommandResponseRequired(def.GetValueCommand(), getHandle).GetSerializedData());
 
// In onDataReceived, when a notification arrives:
auto* notif = static_cast<Ocp1Notification*>(msg.get());
if (def.GetValueCommand().m_targetOno == notif->GetEmitterOno()) {
    Variant v(notif->GetParameterData(), OCP1DATATYPE_BLOB);
    auto [x, y, z] = v.ToPosition();
}

Variable Documentation

CoordinateMapping_Box

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMapping_Box = 0x16

staticconstexpr

Box number for per-source coordinate-mapped positions (per area).

Definition at line 139 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMapping_Source_Position

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMapping_Source_Position = 0x01

staticconstexpr

Source position in the virtual coordinate space of the mapping area (3 × float32 XYZ, blob).

Definition at line 140 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_Box

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_Box = 0x15

staticconstexpr

Box number for coordinate-mapping corner-point configuration (per area).

Definition at line 127 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_Flip

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_Flip = 0x03

staticconstexpr

Axis-flip flags (bool).

Definition at line 130 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_Name

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_Name = 0x01

staticconstexpr

Name string for this mapping area.

Definition at line 128 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_P1_real

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_P1_real = 0x04

staticconstexpr

Corner point P1 in real-world coordinates (3 × float32 XYZ).

Definition at line 131 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_P1_virtual

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_P1_virtual = 0x08

staticconstexpr

Corner point P1 in virtual (mapped) coordinates.

Definition at line 135 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_P2_real

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_P2_real = 0x05

staticconstexpr

Corner point P2 in real-world coordinates.

Definition at line 132 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_P3_real

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_P3_real = 0x06

staticconstexpr

Corner point P3 in real-world coordinates.

Definition at line 133 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_P3_virtual

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_P3_virtual = 0x09

staticconstexpr

Corner point P3 in virtual (mapped) coordinates.

Definition at line 136 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_P4_real

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_P4_real = 0x07

staticconstexpr

Corner point P4 in real-world coordinates.

Definition at line 134 of file Ocp1DS100ObjectDefinitions.h.

CoordinateMappingSettings_Type

constexpr BoxAndObjNo NanoOcp1::DS100::CoordinateMappingSettings_Type = 0x02

staticconstexpr

Mapping type (uint32 enum).

Definition at line 129 of file Ocp1DS100ObjectDefinitions.h.

Error_Box

constexpr BoxAndObjNo NanoOcp1::DS100::Error_Box = 0x04

staticconstexpr

Box number for error-reporting objects.

Definition at line 114 of file Ocp1DS100ObjectDefinitions.h.

Error_ErrorText

constexpr BoxAndObjNo NanoOcp1::DS100::Error_ErrorText = 0x03

staticconstexpr

Human-readable error description string.

Definition at line 116 of file Ocp1DS100ObjectDefinitions.h.

Error_GnrlErr

constexpr BoxAndObjNo NanoOcp1::DS100::Error_GnrlErr = 0x01

staticconstexpr

General error flag.

Definition at line 115 of file Ocp1DS100ObjectDefinitions.h.

Fixed_Box

constexpr BoxAndObjNo NanoOcp1::DS100::Fixed_Box = 0x00

staticconstexpr

Box number for all Fixed (read-only) device identity objects.

Definition at line 99 of file Ocp1DS100ObjectDefinitions.h.

Fixed_GUID

constexpr BoxAndObjNo NanoOcp1::DS100::Fixed_GUID = 0x0f

staticconstexpr

8-char hex firmware/model GUID (e.g. "DB000CD0"). Read on connect to detect stack-ident.

Definition at line 102 of file Ocp1DS100ObjectDefinitions.h.

Fixed_HardwareVariant

constexpr BoxAndObjNo NanoOcp1::DS100::Fixed_HardwareVariant = 0x02

staticconstexpr

Hardware variant code (int32).

Definition at line 100 of file Ocp1DS100ObjectDefinitions.h.

Fixed_SerNr

constexpr BoxAndObjNo NanoOcp1::DS100::Fixed_SerNr = 0x0a

staticconstexpr

Serial number string.

Definition at line 101 of file Ocp1DS100ObjectDefinitions.h.

FunctionGroup_Box

constexpr BoxAndObjNo NanoOcp1::DS100::FunctionGroup_Box = 0x0e

staticconstexpr

Box number for per-function-group parameters (groups 1–32).

Definition at line 188 of file Ocp1DS100ObjectDefinitions.h.

FunctionGroup_Delay

constexpr BoxAndObjNo NanoOcp1::DS100::FunctionGroup_Delay = 0x02

staticconstexpr

Group delay in ms (float32).

Definition at line 190 of file Ocp1DS100ObjectDefinitions.h.

FunctionGroup_Name

constexpr BoxAndObjNo NanoOcp1::DS100::FunctionGroup_Name = 0x01

staticconstexpr

User-assignable function group name (string).

Definition at line 189 of file Ocp1DS100ObjectDefinitions.h.

FunctionGroup_SpreadFactor

constexpr BoxAndObjNo NanoOcp1::DS100::FunctionGroup_SpreadFactor = 0x06

staticconstexpr

Group spread factor (float32).

Definition at line 191 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_Box

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_Box = 0x05

staticconstexpr

Box number for per-input-channel (sound object) parameters.

Definition at line 143 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_ChannelName

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_ChannelName = 0x07

staticconstexpr

User-assignable input channel name (string).

Definition at line 150 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_Delay

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_Delay = 0x03

staticconstexpr

Input delay in ms (float32).

Definition at line 146 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_DelayEnable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_DelayEnable = 0x04

staticconstexpr

Input delay enable (bool).

Definition at line 147 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_EqEnable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_EqEnable = 0x05

staticconstexpr

Input EQ enable (bool).

Definition at line 148 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_Gain

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_Gain = 0x02

staticconstexpr

Input gain in dB (float32).

Definition at line 145 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_ISP

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_ISP = 0x0b

staticconstexpr

Input signal presence indicator (bool).

Definition at line 154 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_LevelMeterIn

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_LevelMeterIn = 0x08

staticconstexpr

Pre-processing level meter reading (float32, dBFS).

Definition at line 151 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_LevelMeterPostMute

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_LevelMeterPostMute = 0x0a

staticconstexpr

Post-mute level meter reading (float32, dBFS).

Definition at line 153 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_LevelMeterPreMute

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_LevelMeterPreMute = 0x09

staticconstexpr

Pre-mute level meter reading (float32, dBFS).

Definition at line 152 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_Mute

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_Mute = 0x01

staticconstexpr

Input mute (bool: 0=unmuted, 1=muted).

Definition at line 144 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_Polarity

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_Polarity = 0x06

staticconstexpr

Input polarity invert (bool).

Definition at line 149 of file Ocp1DS100ObjectDefinitions.h.

MatrixInput_ReverbSendGain

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixInput_ReverbSendGain = 0x0d

staticconstexpr

En-Space send gain for this input (float32, dB).

Definition at line 155 of file Ocp1DS100ObjectDefinitions.h.

MatrixNode_Box

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixNode_Box = 0x07

staticconstexpr

Box number for per-crosspoint (input × output) routing parameters.

Definition at line 158 of file Ocp1DS100ObjectDefinitions.h.

MatrixNode_Delay

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixNode_Delay = 0x03

staticconstexpr

Crosspoint delay (float32, ms).

Definition at line 161 of file Ocp1DS100ObjectDefinitions.h.

MatrixNode_DelayEnable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixNode_DelayEnable = 0x04

staticconstexpr

Crosspoint delay enable (bool).

Definition at line 162 of file Ocp1DS100ObjectDefinitions.h.

MatrixNode_Enable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixNode_Enable = 0x01

staticconstexpr

Crosspoint enable / mute (bool).

Definition at line 159 of file Ocp1DS100ObjectDefinitions.h.

MatrixNode_Gain

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixNode_Gain = 0x02

staticconstexpr

Crosspoint gain (float32, dB).

Definition at line 160 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_Box

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_Box = 0x08

staticconstexpr

Box number for per-output-channel parameters.

Definition at line 165 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_ChannelName

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_ChannelName = 0x07

staticconstexpr

User-assignable output channel name (string).

Definition at line 172 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_Delay

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_Delay = 0x03

staticconstexpr

Output delay in ms (float32).

Definition at line 168 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_DelayEnable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_DelayEnable = 0x04

staticconstexpr

Output delay enable (bool).

Definition at line 169 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_EqEnable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_EqEnable = 0x05

staticconstexpr

Output EQ enable (bool).

Definition at line 170 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_Gain

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_Gain = 0x02

staticconstexpr

Output gain in dB (float32).

Definition at line 167 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_LevelMeterIn

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_LevelMeterIn = 0x08

staticconstexpr

Pre-processing level meter reading (float32, dBFS).

Definition at line 173 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_LevelMeterPostMute

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_LevelMeterPostMute = 0x0a

staticconstexpr

Post-mute level meter reading (float32, dBFS).

Definition at line 175 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_LevelMeterPreMute

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_LevelMeterPreMute = 0x09

staticconstexpr

Pre-mute level meter reading (float32, dBFS).

Definition at line 174 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_Mute

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_Mute = 0x01

staticconstexpr

Output mute (bool).

Definition at line 166 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_OSP

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_OSP = 0x0b

staticconstexpr

Output signal presence indicator (bool).

Definition at line 176 of file Ocp1DS100ObjectDefinitions.h.

MatrixOutput_Polarity

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixOutput_Polarity = 0x06

staticconstexpr

Output polarity invert (bool).

Definition at line 171 of file Ocp1DS100ObjectDefinitions.h.

MatrixSettings_Box

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixSettings_Box = 0x02

staticconstexpr

Box number for global matrix / En-Space / En-Scene settings.

Definition at line 119 of file Ocp1DS100ObjectDefinitions.h.

MatrixSettings_PositioningEnable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixSettings_PositioningEnable = 0x02

staticconstexpr

Enable / disable En-Scene object-based positioning globally.

Definition at line 120 of file Ocp1DS100ObjectDefinitions.h.

MatrixSettings_ReverbEnable

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixSettings_ReverbEnable = 0x03

staticconstexpr

Enable / disable En-Space convolution reverb globally.

Definition at line 121 of file Ocp1DS100ObjectDefinitions.h.

MatrixSettings_ReverbPredelayFactor

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixSettings_ReverbPredelayFactor = 0x14

staticconstexpr

Pre-delay scaling factor for the selected room (float32).

Definition at line 123 of file Ocp1DS100ObjectDefinitions.h.

MatrixSettings_ReverbRearLevel

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixSettings_ReverbRearLevel = 0x15

staticconstexpr

Rear-channel level adjustment for the reverb tail (float32, dB).

Definition at line 124 of file Ocp1DS100ObjectDefinitions.h.

MatrixSettings_ReverbRoomId

constexpr BoxAndObjNo NanoOcp1::DS100::MatrixSettings_ReverbRoomId = 0x0a

staticconstexpr

En-Space room impulse-response selection (uint32 room index).

Definition at line 122 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Source_Box

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Source_Box = 0x0d

staticconstexpr

Box number for per-sound-object En-Scene positioning parameters.

Definition at line 179 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Source_DelayMode

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Source_DelayMode = 0x0b

staticconstexpr

Delay mode for this sound object (uint32 enum).

Definition at line 185 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Source_Enable

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Source_Enable = 0x03

staticconstexpr

En-Scene processing enable for this sound object (bool).

Definition at line 181 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Source_Position

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Source_Position = 0x02

staticconstexpr

Sound object XYZ position in real-world space (3 × float32 blob, normalised 0–1).

Definition at line 180 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Source_Speaker_Group

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Source_Speaker_Group = 0x06

staticconstexpr

Deprecated:

Function-group assignment. Use Positioning_Speaker_Group from firmware DB000CD0 onwards.

Definition at line 183 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Source_Speaker_Position

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Source_Speaker_Position = 0x07

staticconstexpr

Deprecated:

Loudspeaker position (6-DOF blob). Use Positioning_Speaker_Position from firmware DB000CD0 onwards.

Definition at line 184 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Source_Spread

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Source_Spread = 0x04

staticconstexpr

Sound object spread factor (float32, 0–1).

Definition at line 182 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Speaker_Box

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Speaker_Box = 0x1a

staticconstexpr

Box number for per-loudspeaker 6-DOF position parameters.

Note

Introduced with firmware GUID DB000CD0; use Positioning_Source_Speaker_Position on earlier firmware.

Definition at line 216 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Speaker_Group

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Speaker_Group = 0x01

staticconstexpr

Function-group assignment for this loudspeaker output (uint32).

Note

Introduced with firmware GUID DB000CD0.

Definition at line 217 of file Ocp1DS100ObjectDefinitions.h.

Positioning_Speaker_Position

constexpr BoxAndObjNo NanoOcp1::DS100::Positioning_Speaker_Position = 0x02

staticconstexpr

Loudspeaker 6-DOF position: [hor, vert, rot, x, y, z] (6 × float32 blob).

Note

Introduced with firmware GUID DB000CD0.

Definition at line 218 of file Ocp1DS100ObjectDefinitions.h.

ReverbInput_Box

constexpr BoxAndObjNo NanoOcp1::DS100::ReverbInput_Box = 0x10

staticconstexpr

Box number for per-(sound-object × reverb-zone) send parameters.

Definition at line 194 of file Ocp1DS100ObjectDefinitions.h.

ReverbInput_Gain

constexpr BoxAndObjNo NanoOcp1::DS100::ReverbInput_Gain = 0x01

staticconstexpr

Send gain from sound object to reverb zone (float32, dB).

Definition at line 195 of file Ocp1DS100ObjectDefinitions.h.

ReverbInputProcessing_Box

constexpr BoxAndObjNo NanoOcp1::DS100::ReverbInputProcessing_Box = 0x11

staticconstexpr

Box number for per-reverb-send processing parameters.

Definition at line 198 of file Ocp1DS100ObjectDefinitions.h.

ReverbInputProcessing_EqEnable

constexpr BoxAndObjNo NanoOcp1::DS100::ReverbInputProcessing_EqEnable = 0x03

staticconstexpr

Reverb send EQ enable (bool).

Definition at line 201 of file Ocp1DS100ObjectDefinitions.h.

ReverbInputProcessing_Gain

constexpr BoxAndObjNo NanoOcp1::DS100::ReverbInputProcessing_Gain = 0x02

staticconstexpr

Reverb send gain trim (float32, dB).

Definition at line 200 of file Ocp1DS100ObjectDefinitions.h.

ReverbInputProcessing_LevelMeter

constexpr BoxAndObjNo NanoOcp1::DS100::ReverbInputProcessing_LevelMeter = 0x05

staticconstexpr

Reverb send level meter reading (float32, dBFS).

Definition at line 202 of file Ocp1DS100ObjectDefinitions.h.

ReverbInputProcessing_Mute

constexpr BoxAndObjNo NanoOcp1::DS100::ReverbInputProcessing_Mute = 0x01

staticconstexpr

Reverb send mute (bool).

Definition at line 199 of file Ocp1DS100ObjectDefinitions.h.

Scene_Box

constexpr BoxAndObjNo NanoOcp1::DS100::Scene_Box = 0x17

staticconstexpr

Box number for scene-related read/write objects.

Definition at line 205 of file Ocp1DS100ObjectDefinitions.h.

Scene_SceneComment

constexpr BoxAndObjNo NanoOcp1::DS100::Scene_SceneComment = 0x04

staticconstexpr

Comment text for the currently active scene (string).

Definition at line 208 of file Ocp1DS100ObjectDefinitions.h.

Scene_SceneIndex

constexpr BoxAndObjNo NanoOcp1::DS100::Scene_SceneIndex = 0x01

staticconstexpr

Currently active scene index (uint32).

Definition at line 206 of file Ocp1DS100ObjectDefinitions.h.

Scene_SceneName

constexpr BoxAndObjNo NanoOcp1::DS100::Scene_SceneName = 0x03

staticconstexpr

Name of the currently active scene (string).

Definition at line 207 of file Ocp1DS100ObjectDefinitions.h.

SceneAgentONo

constexpr std::uint32_t NanoOcp1::DS100::SceneAgentONo = 0x2714

staticconstexpr

Fixed ONo for the DS100 Scene Agent object.

Scene recall is sent via a SetValueCommand to this specific ONo rather than to a property addressed through the normal box/object-number scheme. DeviceController remaps the Scene_Recall / Scene_Previous / Scene_Next remote objects to this ONo via GetObjectDefinition().

Definition at line 229 of file Ocp1DS100ObjectDefinitions.h.

Settings_Box

constexpr BoxAndObjNo NanoOcp1::DS100::Settings_Box = 0x01

staticconstexpr

Box number for writable device settings.

Definition at line 105 of file Ocp1DS100ObjectDefinitions.h.

Settings_DeviceName

constexpr BoxAndObjNo NanoOcp1::DS100::Settings_DeviceName = 0x0d

staticconstexpr

User-assignable device name string.

Definition at line 106 of file Ocp1DS100ObjectDefinitions.h.

SoundObjectRouting_Box

constexpr BoxAndObjNo NanoOcp1::DS100::SoundObjectRouting_Box = 0x18

staticconstexpr

Box number for per-(sound-object × function-group) routing parameters.

Definition at line 211 of file Ocp1DS100ObjectDefinitions.h.

SoundObjectRouting_Gain

constexpr BoxAndObjNo NanoOcp1::DS100::SoundObjectRouting_Gain = 0x02

staticconstexpr

Routing gain for this sound-object/function-group pair (float32, dB).

Definition at line 213 of file Ocp1DS100ObjectDefinitions.h.

SoundObjectRouting_Mute

constexpr BoxAndObjNo NanoOcp1::DS100::SoundObjectRouting_Mute = 0x01

staticconstexpr

Routing mute for this sound-object/function-group pair (bool).

Definition at line 212 of file Ocp1DS100ObjectDefinitions.h.

Status_AudioNetworkSampleStatus

constexpr BoxAndObjNo NanoOcp1::DS100::Status_AudioNetworkSampleStatus = 0x30

staticconstexpr

Audio network sample-rate/lock status.

Definition at line 111 of file Ocp1DS100ObjectDefinitions.h.

Status_Box

constexpr BoxAndObjNo NanoOcp1::DS100::Status_Box = 0x03

staticconstexpr

Box number for read-only status objects.

Definition at line 109 of file Ocp1DS100ObjectDefinitions.h.

Status_StatusText

constexpr BoxAndObjNo NanoOcp1::DS100::Status_StatusText = 0x03

staticconstexpr

Human-readable device status string.

Definition at line 110 of file Ocp1DS100ObjectDefinitions.h.