OMG R24 Reference
Data Stream Source List
field– [f64] Magnetic Field (nT), 1 columns: Bgradient– [f64] Magnetic Field (nT/cm), 1 columns: Bstatus– [i8] Status (1 column)signal– [f32] Signal strength, 1 columns: V
Command List
Scalar field gradient
gradient.data.active– [u8] Set to 1 to include gradient field in data stream.gradient.data.decimation– [u32] Decimation of gradient field relative to previous data source.gradient.data.autocutoff– [u8] Set to 1 to automaticaly configure gradient field IIR lowpass filter according to decimation.gradient.data.cutoff– [f32] Manually control gradient field IIR lowpass filter cutoff.gradient.data.id– [u16] Returns stream ID of gradient field.gradient.baseline– [f32] Distance between magnetometers (cm).
Total magnetic field
field.data.active– [u8] Set to 1 to include total field in data stream.field.data.decimation– [u32] Decimation of total field relative to previous data source.field.data.autocutoff– [u8] Set to 1 to automaticaly configure total field IIR lowpass filter according to decimation.field.data.cutoff– [f32] Manually control total field IIR lowpass filter cutoff.field.data.id– [u16] Returns stream ID of total field.
Total magnetic field channel 2
field2.data.active– [u8] Set to 1 to include second total field in data stream.field2.data.decimation– [u32] Decimation of second total field relative to previous data source.field2.data.autocutoff– [u8] Set to 1 to automaticaly configure second total field IIR lowpass filter according to decimation.field2.data.cutoff– [f32] Manually control second total field IIR lowpass filter cutoff.field2.data.id– [u16] Returns stream ID of second total field.
Lock signal strength
signal.data.active– [u8] Set to 1 to include lock signal strength in data stream.signal.data.decimation– [u32] Decimation of lock signal strength relative to previous data source.signal.data.autocutoff– [u8] Set to 1 to automaticaly configure lock signal strength IIR lowpass filter according to decimation.signal.data.cutoff– [f32] Manually control lock signal strength IIR lowpass filter cutoff.signal.data.id– [u16] Returns stream ID of lock signal strength.
System settings
mode.sleep– [u8:0|1] Enable sleep mode, turns off laser and heaters.
Status byte
status.data.active– [u8] Set to 1 to include status in data stream.status.data.decimation– [u32] Decimation of status relative to previous data source.status.data.id– [u16] Returns stream ID of status.status.laser– [f32] Fraction original laser power.
Device configuration memory
dev.conf.autosave– [i16] Automatically save configuration specified number of seconds after changes; -1 disables. Maximum 10,000 writes.dev.conf.save– Save configuration. Configuration is used on next power cycle.dev.conf.load– Load configuration from last saved version.dev.conf.verbose– [u8] Send a log message every time settings are saved.
Device information
dev.name– Short name of device.dev.model– Short name of device.dev.desc– Description of device.dev.serial– Serial number assigned to device.dev.revision– [u16] Hardware revision number.dev.version_major– [u16] Software version, major rev number in major.minor format.dev.version_minor– [u16] Software version, minor rev number in major.minor format.dev.lock– Attempts to secure advisory lock. No effect in device; useful for multi-client access control.dev.unlock– Unlock the advisory lock. No effective in device; useful for multi-client access control.dev.systime– [u64] Time elapsed since boot counted by microcontroller.dev.loglevel– [u8] Set max level of log messages sent by device.dev.session– [u32] Random number set at power on.dev.start– Start or restart operation. Synchronization: provide atl_timebase_infostruct and deliver an external clock.dev.stop– Halt operation.dev.reboot– Restart device controller.dev.synctime– Updates the timebase properties for an external clock. Expects atl_timebase_infostruct.dev.firmware.upload– Used to upload firmware into RAM. Must issue dev.stop first. See the tio-firmware-upgrade in tio-tools.dev.firmware.upgrade– Used to commit firmware to flash. See the tio-firmware-upgrade in tio-tools.dev.firmware.serial– Serial number/identifier of firmware.
Data stream introspection
Devices have multiple data sources, sampled on specific timebases, which can be selected for streaming.
data.rate– Specify primary source data rate (Hz)data.timebase.list– Number of timebases availbale on device; internal clock, external clock, etc.data.timebase.info– Request with timebase ID, reply with timebase metadata.data.timebase.send– Request with timebase ID, sends timebase metadata.data.source.list– Number of data sources available on device.data.source.info– Request with data source ID, reply with source metadata.data.source.send– Request with data source ID, sends soure metadata as source update.data.stream.list– Number of data streams. Most systems have only one data stream.data.stream.info– Request with data stream ID, reply with stream metadata.data.stream.send– Request with data stream ID, sends data stream metadata as stream update.data.stream.columns– Number of active columns in stream.data.list– List active streams. Request with ID to enumerate stream names.data.send_all– Iteratively sends metadata on all timebases, sources, and streams.data.atomic– Preface a set of atomic data stream changes.data.apply– Apply data stream changes atomically.
Command introspection
rpc.list– No argument: List number of RPCs. Pass [u16] ID number: returns name of RPC.rpc.info– [u16] Return RPC metadata, 16 bits.rpc.listinfo– Same as rpc.list, but prepends rpc.info metadata.rpc.id– Return 16 bit ID number for named RPC.rpc.name– [u16] Return RPC name string for 16 bit ID number.
Communications port configuration
dev.port.count– [u32] Number of control ports.dev.port.mode.textdev.port.mode.binarydev.port.mode.boot_textdev.port.mode.boot_binarydev.port.ratedev.port.rate.neardev.port.rate.mindev.port.rate.maxdev.port.maxrate