SYNC4 R7 Reference
Data Stream Source List
sats– [u8] Satellite (#,dB), 2 columns: number, snrgps– [f32] Position (deg,deg,m), 3 columns: lat, lon, altvco– [f32] Local oscillator (ns,ppb), 2 columns: delta, pullstatus– [u8] Status bits (mask) (1 column)rail– [f32] Power supply, 2 columns: voltage, current
Command List
Synchronization control
sync.start– Start synchronous sampling.sync.stop– Stop synchronous sampling.sync.passthrough– Pass through data without processing or reordering.sync.unixtime– Unix timestamp epoch for current acquisition.sync.downsample– [u32] Reduce output data rate by integer decimation of data stream.
GPS location
gps.data.active– [u8] Set to 1 to include gps location in data stream.gps.data.decimation– [u32] Decimation of gps location relative to previous data source.gps.data.autocutoff– [u8] Set to 1 to automaticaly configure gps location IIR lowpass filter according to decimation.gps.data.cutoff– [f32] Manually control gps location IIR lowpass filter cutoff.gps.data.id– [u16] Returns stream ID of gps location.gps.ext– [u8] When enabled, switches GPS input to the LVTTL port for use with external GPS systems. The LVTTL port expects serial NMEA messages at 9600 baud in the RX pin, 1PPS signals at the 1PPS pin, and a ground connection.vco.data.active– [u8] Set to 1 to include local oscillator deviation in data stream.vco.data.decimation– [u32] Decimation of local oscillator deviation relative to previous data source.vco.data.autocutoff– [u8] Set to 1 to automaticaly configure local oscillator deviation IIR lowpass filter according to decimation.vco.data.cutoff– [f32] Manually control local oscillator deviation IIR lowpass filter cutoff.vco.data.id– [u16] Returns stream ID of local oscillator deviation.sats.data.active– [u8] Set to 1 to include satellites in data stream.sats.data.decimation– [u32] Decimation of satellites relative to previous data source.sats.data.id– [u16] Returns stream ID of satellites.
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.
Voltage rail
rail.data.active– [u8] Set to 1 to include voltage rail in data stream.rail.data.decimation– [u32] Decimation of voltage rail relative to previous data source.rail.data.autocutoff– [u8] Set to 1 to automaticaly configure voltage rail IIR lowpass filter according to decimation.rail.data.cutoff– [f32] Manually control voltage rail IIR lowpass filter cutoff.rail.data.id– [u16] Returns stream ID of voltage rail.
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.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.boot_mode– [u8] Startup mode of this port 1=text, 0=binary.dev.port.text– Change mode of this port to text.dev.port.binary– Change mode of this port to binary.dev.port.count– [u32] Number of control ports.