MT device base class. More...

#include <mtdevice.h>

Inheritance diagram for MtDevice:

[legend]

Public Member Functions
double	accelerometerRange () const

XsFilterProfileArray	availableOnboardFilterProfiles () const override
	Return the list of filter profiles available on the device. More...

virtual bool	canDoOrientationResetInFirmware (XsResetMethod method)
	Checks if this device can do orientation reset in firmware. More...

XsDeviceOptionFlag	deviceOptionFlags () const override
	Returns the device option flags. More...

XsErrorMode	errorMode () const

virtual int	getBaseFrequency (XsDataIdentifier dataType=XDI_None) const
	Returns the base update rate (Hz) corresponding to the dataType. Returns 0 if no update rate is available. More...

XsIntArray	gnssReceiverSettings () const override
	Gets some GNSS receiver settings. More...

double	gyroscopeRange () const

XsVersion	hardwareVersion () const
	Return the hardware version of the device. More...

double	headingOffset () const
	The heading offset set for this device. More...

bool	initialize () override
	Initialize the Mt device using the supplied filter profiles. More...

XsVector	initialPositionLLA () const override

bool	isMotionTracker () const override

int	locationId () const
	Get the location ID of the device. More...

bool	messageLooksSane (const XsMessage &msg) const override
	Checks for the sanity of a message. More...

XsFilterProfile	onboardFilterProfile () const override
	Gets the filter profile in use by the device for computing orientations. More...

XsOutputConfigurationArray	outputConfiguration () const override
	Returns the currently configured output of the device. More...

XsString	productCode () const
	Return the product code of the device. More...

bool	reinitialize ()
	Reinitialize the XsDevice. More...

bool	requestData ()
	Request data from the motion tracker. More...

bool	restoreFactoryDefaults ()
	Restore to factory default settings. More...

uint16_t	rs485TransmissionDelay () const
	Return the RS485 acknowledge transmission delay of the device. More...

XsSelfTestResult	runSelfTest ()
	Run a self test. More...

virtual bool	scheduleOrientationReset (XsResetMethod method)

XsBaudRate	serialBaudRate () const override
	The baud rate configured for cabled connection. More...

bool	setErrorMode (XsErrorMode errorMode)
	Set the error mode of the device. More...

bool	setGnssReceiverSettings (const XsIntArray &gnssReceiverSettings) override
	Sets some GNSS receiver settings. More...

bool	setInitialPositionLLA (const XsVector &lla) override
	Set the current sensor position. More...

virtual bool	setLocationId (int id)
	Set the location ID of the device. More...

bool	setNoRotation (uint16_t duration)
	Set the no rotation period to duration. More...

bool	setOnboardFilterProfile (int profileType) override
	Sets the filter profile to use for computing orientations on the device. More...

bool	setOnboardFilterProfile (XsString const &profileType) override
	Sets the filter profile to use for computing orientations on the device. More...

bool	setRs485TransmissionDelay (uint16_t delay)
	Set the RS485 acknowledge transmission delay of the device. More...

bool	setUbloxGnssPlatform (XsUbloxGnssPlatform ubloxGnssPlatform) override
	Set the device GNSS platform for u-blox GNSS receivers. More...

virtual bool	storeAlignmentMatrix ()
	Store the current alignment matrix in the device. More...

bool	storeFilterState () override
	Store orientation filter state in the device. More...

uint16_t	stringOutputType () const override
	Returns the string output type. More...

uint16_t	stringSamplePeriod () const override
	Returns the sample period for string output. More...

uint16_t	stringSkipFactor () const override
	Returns the skipfactor for string output. More...

uint32_t	supportedStatusFlags () const override
	Returns a bitmask with all the status flags supported by this device. More...

XsUbloxGnssPlatform	ubloxGnssPlatform () const override
	Returns the device GNSS platform for u-blox GNSS receivers. More...

int	updateRateForDataIdentifier (XsDataIdentifier dataType) const override
	Returns the currently configured update rate for the supplied dataType. More...

void	writeDeviceSettingsToFile () override
	Write the emts of the device to the open logfile. More...

virtual	~MtDevice ()
	Destroys the MtDevice. More...

Log files
bool	resetLogFileReadPosition () override
	Set the read position of the open log file to the start of the file. More...

Public Member Functions inherited from XsDevice
virtual bool	abortFlushing ()
	Abort the wireless flushing operation and finalize the recording. More...

virtual bool	abortLoadLogFile ()
	Aborts loading a logfile. More...

virtual bool	acceptConnection ()
	Accept connections from the device on the parent/master device. More...

virtual XsAccessControlMode	accessControlMode () const
	Request the access control mode of the master device. More...

virtual void	addRef ()
	Increase reference count of XsDevice pointer XsDevice pointers stay alive while reference counter is not zero Also increases the reference count of each child device with 1. More...

virtual std::shared_ptr< ReplyObject >	addReplyObject (XsXbusMessageId messageId, uint8_t data)

virtual XsMatrix	alignmentRotationMatrix (XsAlignmentFrame frame) const
	Retrieve the alignment rotation matrix to rotate S to the chosen frame S'. More...

virtual XsQuaternion	alignmentRotationQuaternion (XsAlignmentFrame frame) const
	Retrieve the alignment rotation quaternion. More...

virtual XsResultValue	applyConfigFile (const XsString &filename)
	Loads a config file(.xsa) and configures the device accordingly. More...

virtual bool	areOptionsEnabled (XsOption options) const
	Returns true when all the specified processing options are enabled. More...

virtual XsFilterProfileArray	availableXdaFilterProfiles () const
	Return the list of filter profiles available on the host PC. More...

virtual int	batteryLevel () const
	Get the batterylevel of this device The battery level is a value between 0 and 100 that indicates the remaining capacity as a percentage. Due to battery characteristics, this is not directly the remaining time, but just a rough indication. More...

virtual XsTimeStamp	batteryLevelTime ()
	Requests the time the battery level was last updated. More...

virtual XsBaudRate	baudRate () const
	Get the baud rate (communication speed) of the serial port on which the given deviceId is connected. More...

virtual int	busId () const
	The bus ID for this device. More...

int	cacheSize () const
	Get the number of items currently in the slow data cache for the device. More...

virtual uint32_t	canConfiguration () const
	Returns the currently configured CAN configuration of the device. More...

virtual XsCanOutputConfigurationArray	canOutputConfiguration () const
	Returns the currently configured CAN output of the device. More...

virtual void XSNOEXPORT	checkDataCache ()

virtual int	childCount () const
	Return the number of child-devices this device has. For standalone devices this is always 0. More...

virtual std::vector< XsDevice * >	children () const
	Return a managed array containing the child-devices this device has. For standalone devices this is always an empty array. More...

virtual bool	closeLogFile ()
	Close the log file. More...

Communicator XSNOEXPORT *	communicator () const

virtual XsConnectivityState	connectivityState () const
	Returns the connectivity state of the device. More...

virtual XsResultValue	createConfigFile (const XsString &filename)
	Stores the current device configuration in a config file(.xsa) More...

XsResultValue	createLogFile (const XsString &filename)
	Create a log file for logging. More...

virtual XsDeviceIdArray	currentAccessControlList () const
	Request the access control list of the master device. More...

virtual int	dataLength () const
	Returns the length of the data in the legacy MTData packets that the device will send in measurement mode. More...

virtual void XSNOEXPORT	deinitializeSoftwareCalibration ()

virtual XsDevice *	deviceAtBusId (int busid)
	Return the device with bus ID busid. More...

const XsDevice *	deviceAtBusIdConst (int busid) const
	Return the device with bus ID busid. More...

virtual uint32_t	deviceBufferSize ()
	Request the size of the interal buffer. More...

XsDeviceConfiguration	deviceConfiguration () const
	Returns the device configuration. More...

virtual XsDeviceConfiguration const &XSNOEXPORT	deviceConfigurationConst () const

XsDeviceConfiguration &XSNOEXPORT	deviceConfigurationRef ()

XsDeviceId const &	deviceId () const
	Return the device ID of the device. More...

virtual bool	deviceIsDocked (XsDevice *dev) const
	Check if the device is docked. More...

virtual XsResultValue	deviceParameter (XsDeviceParameter &parameter) const
	Retrieves the requested parameter's current value. More...

virtual XsDeviceState	deviceState () const
	Return the state of this device. More...

virtual bool	disableProtocol (XsProtocolType protocol)
	Disable a communication protocol previously added by XsDevice::enableProtocol. More...

virtual bool	disableRadio ()
	Disables the radio for this station, resetting all children to disconnected state. More...

virtual void	discardRetransmissions (int64_t firstNewPacketId)
	Tell XDA and the device that any data from before firstNewPacketId may be lossy. More...

virtual bool	enableProtocol (XsProtocolType protocol)
	Enable an additional communication protocol when reading messages. More...

virtual bool	enableRadio (int channel)
	Set the radio channel to use for wireless communication. More...

virtual XsDevice *	findDevice (XsDeviceId const &deviceid) const
	Find the child device with deviceid. More...

XsDevice const *	findDeviceConst (XsDeviceId const &deviceid) const
	Find the child device with deviceid. More...

virtual XsVersion	firmwareVersion () const
	Return the firmware version. More...

virtual void	flushInputBuffers ()
	Clear the inbound data buffers of the device. More...

virtual XsDataPacket	getDataPacketByIndex (XsSize index) const
	Return the cached data packet with index. More...

XsSize	getDataPacketCount () const
	Return the current size of the retained data packet cache. More...

virtual XsDevice *	getDeviceFromLocationId (uint16_t locId)
	Get the device given locId. More...

XsOption	getOptions () const
	Return the currently enabled options. More...

int64_t	getStartRecordingPacketId () const
	Return the ID of the first packet that should be recorded. More...

int64_t	getStopRecordingPacketId () const
	Return the ID of the last packet that should be recorded. More...

virtual XsVector	gnssLeverArm () const

XSNOEXPORT XSDEPRECATED XsGnssPlatform	gnssPlatform () const

virtual bool	gotoConfig ()
	Put the device in config mode. More...

virtual bool	gotoMeasurement ()
	Put this device in measurement mode. More...

virtual double	gravityMagnitude () const
	Returns the 'Gravity Magnitude' of the device. More...

virtual XSNOEXPORT void	handleDataPacket (const XsDataPacket &packet)

virtual XSNOEXPORT void	handleErrorMessage (const XsMessage &msg)

virtual XSNOEXPORT void	handleMasterIndication (const XsMessage &message)

virtual XSNOEXPORT void	handleMessage (const XsMessage &msg)

virtual XSNOEXPORT void	handleNonDataMessage (const XsMessage &msg)

virtual XSNOEXPORT void	handleUnavailableData (int64_t frameNumber)

virtual XSNOEXPORT void	handleWakeupMessage (const XsMessage &msg)

virtual XSNOEXPORT void	handleWarningMessage (const XsMessage &msg)

virtual bool	hasDataEnabled (XsDataIdentifier dataType) const
	Returns if the currently configured output contains dataType. More...

virtual bool	hasProcessedDataEnabled (XsDataIdentifier dataType) const
	Returns if the currently configured output contains dataType after processing on the host. More...

virtual bool XSNOEXPORT	initializeSoftwareCalibration ()

virtual bool	isBlueToothEnabled () const
	Returns true if the device has its BlueTooth radio enabled. More...

virtual bool	isBusPowerEnabled () const
	Returns if the Xbus is powering its child devices or not. More...

virtual bool	isContainerDevice () const
	Returns true if this device can have child devices. More...

virtual bool	isFixedGravityEnabled () const
	Returns if the fixed gravity value should be used or if it should be computed from the initialPositionLLA value. More...

virtual bool	isInitialBiasUpdateEnabled () const
	Returns if the device does gyroscope bias estimation when switching to measurement mode. More...

bool	isInitialized () const
	Returns true when the device is initialized. More...

virtual bool	isInStringOutputMode () const
	Returns if the device is outputting data in string mode. More...

virtual bool	isInSyncStationMode ()

bool	isLoadLogFileInProgress () const
	Returns true if the file operation started by loadLogFile is still in progress. More...

bool	isMasterDevice () const
	Returns true if this is the master device (not a child of another device) More...

virtual bool	isMeasuring () const
	Returns true if the device is currently in a measuring state. More...

virtual bool	isOperational () const

virtual bool	isProtocolEnabled (XsProtocolType protocol) const

virtual bool	isRadioEnabled () const
	Returns if the radio is enabled. More...

virtual bool	isReadingFromFile () const
	Returns true if the device is reading from a file. More...

virtual bool	isRecording () const
	Returns true if the device is currently in a recording state. More...

bool	isStandaloneDevice () const
	Returns true if this is a standalone device (not a child of another device and not a container device) More...

virtual bool	isSyncMaster () const
	returns whether this device is in a master role regarding the device synchronization More...

virtual bool	isSyncSlave () const
	returns whether this device is in a slave role regarding the device synchronization More...

XsDataPacket	lastAvailableLiveData () const
	Return the last available live data. More...

virtual int16_t	lastKnownRssi () const
	Returns the last known RSSI value of the device. More...

XsResultValue	lastResult () const
	Get the result value of the last operation. More...

XsString	lastResultText () const
	Get the accompanying error text for the value returned by lastResult() It may provide situation-specific information instead. More...

virtual bool	loadLogFile ()
	Load a complete logfile. More...

virtual DataLogger XSNOEXPORT *	logFileInterface (std::unique_ptr< xsens::Lock > &myLock) const

virtual XsString	logFileName () const
	Get the name of the log file the device is reading from. More...

XsFilePos	logFileReadPosition () const
	Get the current read position of the open log file. More...

XsFilePos	logFileSize () const
	Get the size of the log file the device is reading from. More...

virtual bool	makeOperational ()
	Sets the Awinda station to operational state. More...

virtual XsDevice *	master () const
	Return the master device of this device. More...

virtual int	maximumUpdateRate () const
	Get the maximum update rate for the device. More...

xsens::GuardedMutex *	mutex () const

virtual XsMatrix	objectAlignment () const
	Returns the object alignment matrix of the device. More...

virtual XsOperationalMode	operationalMode () const
	Returns the operational mode. More...

bool	operator< (const XsDevice &dev) const
	Compare device ID with that of dev. More...

bool	operator< (XsDeviceId const &devId) const
	Compare device ID with devId. More...

bool	operator== (const XsDevice &dev) const
	Compare device ID with that of dev. More...

bool	operator== (XsDeviceId const &devId) const
	Compare device ID with devId. More...

virtual int	packetErrorRate () const
	Returns the packet error rate for the for the device. More...

virtual XsIntArray	portConfiguration () const
	Get the current port configuration of a device. More...

virtual XsPortInfo	portInfo () const
	The port information of the connection. More...

virtual XsString	portName () const
	The port name of the connection. More...

virtual bool	powerDown ()
	Tell the device to power down completely. More...

virtual XSNOEXPORT void	prepareForTermination ()

virtual XsOutputConfigurationArray	processedOutputConfiguration () const
	Return the full output configuration including post processing outputs. More...

virtual int	radioChannel () const
	Returns the radio channel used for wireless communication. More...

virtual XSNOEXPORT bool	readEmtsAndDeviceConfiguration ()

virtual XsByteArray	readMetaDataFromLogFile ()
	Returns internal meta-data about the recording that some devices store in the mtb logfile. More...

int	recordingQueueLength () const
	Get the number of packets currently waiting in the slow data cache for the device based. More...

XsSize	refCounter () const
	The current reference counter. More...

virtual bool	rejectConnection ()
	Reject connections from the device on the parent/master device. More...

virtual XsRejectReason	rejectReason () const
	Returns the reason why a device's connection was rejected. More...

virtual void	removeRef ()
	Decrease this XsDevices reference counter with 1. More...

virtual bool	reopenPort (bool gotoConfig, bool skipDeviceIdCheck=false)
	Reopens a port Uses rescan method to redetect a device. Also if USB descriptor has changed. More...

virtual bool	replaceFilterProfile (XsFilterProfile const &profileCurrent, XsFilterProfile const &profileNew)
	Replaces profileCurrent by profileNew in the device. More...

virtual bool	representativeMotionState ()
	Retrieves the active representative motion state for the In-Run Compass Calibration. More...

virtual bool	requestBatteryLevel ()
	Request the battery level from the device. More...

virtual XSNOEXPORT bool	requestUtcTime ()

virtual bool	reset ()
	Reset the device. More...

virtual XSNOEXPORT bool	reset (bool skipDeviceIdCheck)

virtual bool	resetOrientation (XsResetMethod resetmethod)
	Perform an orientation reset on the device using the given resetMethod. More...

virtual void	restartFilter ()
	Restart the software filter used by this device. More...

virtual bool	sendCustomMessage (const XsMessage &messageSend, bool waitForResult, XsMessage &messageReceive, int timeout=0)
	Send a custom message messageSend to the device and possibly wait for a result. More...

virtual XSNOEXPORT bool	sendCustomMessage (const XsMessage &messageSend, bool waitForResult, XsXbusMessageId messageId, XsMessage &messageReceive, int timeout=0)

virtual bool	sendRawMessage (const XsMessage &message)
	Send a message directly to the communicator. More...

virtual bool	setAccessControlMode (XsAccessControlMode mode, const XsDeviceIdArray &initialList)
	Set the access control mode of the master device. More...

virtual bool	setAlignmentRotationMatrix (XsAlignmentFrame frame, const XsMatrix &matrix)
	Set an arbitrary alignment rotation matrix Use to rotate either L to the chosen frame L' or S to the chosen frame S'. More...

virtual bool	setAlignmentRotationQuaternion (XsAlignmentFrame frame, const XsQuaternion &quat)
	Set an arbitrary alignment rotation quaternion. Use to rotate either L to the chosen frame L' or S to the chosen frame S'. More...

virtual bool	setBlueToothEnabled (bool enabled)
	Enable or disable the BlueTooth radio of the device. More...

virtual bool	setBusPowerEnabled (bool enabled)
	Tell the Xbus to provide power to its child devices or not. More...

virtual bool	setCanConfiguration (uint32_t config)
	Set the CAN configuration for this device. More...

virtual bool	setCanOutputConfiguration (XsCanOutputConfigurationArray &config)
	Set the CAN output configuration for this device. More...

virtual bool	setDeviceAccepted (const XsDeviceId &deviceId)
	Accepts a device. More...

virtual bool	setDeviceBufferSize (uint32_t frames)
	Request the device to set it's internal buffer to the specified size. More...

virtual bool	setDeviceOptionFlags (XsDeviceOptionFlag setFlags, XsDeviceOptionFlag clearFlags)
	Set the device option flags. More...

virtual XsResultValue	setDeviceParameter (XsDeviceParameter const &parameter)
	Sets the given parameter for the device. More...

virtual bool	setDeviceRejected (const XsDeviceId &deviceId)
	Rejects a device. More...

virtual bool	setFixedGravityEnabled (bool enable)
	Sets whether the fixed gravity value should be used or if it should be computed from the initialPositionLLA value. More...

virtual bool	setGnssLeverArm (const XsVector &arm)
	Sets the GNSS Lever Arm vector. More...

XSNOEXPORT virtual XSDEPRECATED bool	setGnssPlatform (XsGnssPlatform gnssPlatform)

void	setGotoConfigOnClose (bool gotoConfigOnClose)
	On closePort the device will go to config by default, with this function it is possible to prevent that. More...

virtual bool	setGravityMagnitude (double mag)
	Sets the 'Gravity Magnitude' of the device to the given value mag. More...

virtual bool	setHeadingOffset (double offset)
	Set the 'heading offset' setting of the device. More...

virtual bool	setInitialBiasUpdateEnabled (bool enable)
	Set if the device does gyroscope bias estimation when switching to measurement mode. More...

virtual bool	setObjectAlignment (const XsMatrix &matrix)
	Sets the object alignment of the device to the given matrix. More...

virtual bool	setOperationalMode (XsOperationalMode mode)
	Set the device in the given operational mode. More...

virtual void	setOptions (XsOption enable, XsOption disable)
	Enable and disable processing options. More...

bool	setOutputConfiguration (XsOutputConfigurationArray &config)
	Set the output configuration for this device. More...

virtual XSNOEXPORT void	setPacketErrorRate (int per)

virtual bool	setPortConfiguration (XsIntArray &config)
	Change the port configuration of a device. More...

virtual bool	setSerialBaudRate (XsBaudRate baudrate)
	Change the serial baudrate to baudrate. More...

XSNOEXPORT void	setSkipEmtsReadOnInit (bool skip)

virtual bool	setStealthMode (bool enabled)
	Enable or disable stealth mode. More...

virtual bool	setStringOutputMode (uint16_t type, uint16_t period, uint16_t skipFactor)
	Sets the string output mode for this device. More...

virtual bool	setSyncSettings (const XsSyncSettingArray &settingList)
	Set the synchronization settings of the device. More...

virtual bool	setSyncStationMode (bool enabled)
	Set the Sync Station mode of the Awinda Station device. More...

virtual bool	setTransportMode (bool transportModeEnabled)
	Enable or disable the transport mode for the device. More...

virtual bool	setUpdateRate (int rate)
	Set the legacy update rate of the device. More...

virtual bool	setUtcTime (const XsTimeInfo &time)
	Sets the 'UTC Time' setting of the device to the given time. More...

virtual bool	setWirelessPriority (int priority)
	Sets the wireless priority of the device. More...

virtual bool	setXdaFilterProfile (int profileType)
	Sets the filter profile to use for computing orientations on the host PC. More...

virtual bool	setXdaFilterProfile (XsString const &profileType)
	Sets the filter profile to use for computing orientations on the host PC. More...

virtual XsString	shortProductCode () const
	Return the shortened product code of the device suitable for display. More...

virtual bool	startRecording ()
	Start recording incoming data. More...

virtual bool	startRepresentativeMotion ()
	Let the user indicate that he is starting the representative motion for the In-Run Compass Calibration. More...

virtual bool	stealthMode () const
	Return the state of the stealth mode setting. More...

virtual bool	stopRecording ()
	Stop recording incoming data. More...

virtual XsIccRepMotionResult	stopRepresentativeMotion ()
	Let the user indicate that he stopped the representative motion. More...

virtual bool	storeIccResults ()
	Store the onboard ICC results for use by the device. More...

virtual XsDevice *	subDevice (int subDeviceId) const
	Returns the sub-device at index index. More...

virtual int	subDeviceCount () const
	Returns the number of sub-devices of this device. More...

virtual XsStringOutputTypeArray	supportedStringOutputTypes () const
	Ask the device for its supported string output types. More...

virtual XsSyncSettingArray	supportedSyncSettings () const
	Get all supported synchronization settings available on the device. More...

virtual std::vector< int >	supportedUpdateRates (XsDataIdentifier dataType=XDI_None) const
	Ask the device for its supported update rates for the given dataType. More...

virtual XsSyncRole	syncRole () const
	Returns the synchronization role of the device. More...

virtual XsSyncSettingArray	syncSettings () const
	Get all the current synchronization settings of the device. More...

XsDataPacket	takeFirstDataPacketInQueue ()
	Return the first packet in the packet queue or an empty packet if the queue is empty. More...

template<typename T >
XSNOEXPORT T *	toType ()

virtual bool	transportMode ()
	Returns the current state of the transport mode feature. More...

virtual bool	triggerStartRecording ()
	Start recording incoming data through generating a virtual input trigger. More...

virtual bool	updateCachedDeviceInformation ()
	Updates the cached device information for all devices connected to this port. More...

virtual XsResultValue	updatePortInfo (XsPortInfo const &newInfo)
	Update the connection information, this is only useful for devices communicating over a dynamic link such as a TCP/IP connection. More...

virtual int	updateRate () const
	Get the legacy update rate of the device. More...

virtual int	updateRateForProcessedDataIdentifier (XsDataIdentifier dataType) const
	Returns the currently configured update rate for the supplied dataType. More...

virtual bool	usesLegacyDeviceMode () const
	Returns whether the device uses legacy device mode. More...

virtual XsTimeInfo	utcTime () const
	Gets the 'UTC Time' setting of the device. More...

virtual void	waitForAllDevicesInitialized ()
	Wait until are known devices are initialized. More...

virtual XSNOEXPORT bool	waitForCustomMessage (std::shared_ptr< ReplyObject > reply, XsMessage &messageReceive, int timeout)

virtual XSNOEXPORT bool	waitForCustomMessage (XsXbusMessageId messageId, XsMessage &messageReceive, int timeout=0)

void	waitForLoadLogFileDone () const
	Wait for the file operation started by loadLogFile to complete. More...

virtual int	wirelessPriority () const
	Returns the wireless priority of the device. More...

virtual XSNOEXPORT bool	writeEmtsPage (uint8_t const *data, int pageNr, int bankNr)

virtual XsFilterProfile	xdaFilterProfile () const
	Gets the filter profile in use for computing orientations on the host PC. More...

virtual XSNOEXPORT	~XsDevice ()
	Destroy the device. More...

virtual XSNOEXPORT void	onMessageSent (const XsMessage &message)

virtual XSNOEXPORT void	onMessageReceived (const XsMessage &message)

virtual XSNOEXPORT void	onMessageDetected2 (XsProtocolType type, const XsByteArray &rawMessage)

virtual XSNOEXPORT void	onSessionRestarted ()

virtual XSNOEXPORT void	onConnectionLost ()

virtual XSNOEXPORT void	onEofReached ()

virtual XSNOEXPORT void	onWirelessConnectionLost ()

virtual XSNOEXPORT int64_t	deviceRecordingBufferItemCount (int64_t &lastCompletePacketId) const

Public Member Functions inherited from CallbackManagerXda
void	addCallbackHandler (XsCallbackPlainC *cb, bool chain=true)
	Add a handler to the list. More...

void	addChainedManager (CallbackManagerXda *cm)
	Add a chained manager to the list. More...

	CallbackManagerXda ()
	Constructor, initializes the callback list. More...

void	clearCallbackHandlers (bool chain=true)
	Clear the callback list. More...

void	clearChainedManagers ()
	Clear the chained manager list. More...

void	copyCallbackHandlersFrom (CallbackManagerXda *cm, bool chain=true)
	Copy all handlers from cm into this manager. More...

void	copyCallbackHandlersTo (CallbackManagerXda *cm, bool chain=true)
	Copy all handlers from this manager into cm. More...

void	onAllBufferedDataAvailable (XsDevicePtrArray devs, const XsDataPacketPtrArray packets) override
	The XsCallback::onAllBufferedDataAvailable() callback forwarding function. More...

void	onAllDataAvailable (XsDevicePtrArray devs, const XsDataPacketPtrArray packets) override
	The XsCallback::onAllDataAvailable() callback forwarding function. More...

void	onAllLiveDataAvailable (XsDevicePtrArray devs, const XsDataPacketPtrArray packets) override
	The XsCallback::onAllLiveDataAvailable() callback forwarding function. More...

void	onAllRecordedDataAvailable (XsDevicePtrArray devs, const XsDataPacketPtrArray packets) override
	The XsCallback::onAllRecordedDataAvailable() callback forwarding function. More...

void	onBufferedDataAvailable (XsDevice dev, const XsDataPacket data) override
	The XsCallback::onBufferedDataAvailable() callback forwarding function. More...

void	onConnectivityChanged (XsDevice *dev, XsConnectivityState newState) override
	The XsCallback::onConnectivityChanged() callback forwarding function. More...

void	onDataAvailable (XsDevice dev, const XsDataPacket data) override
	The XsCallback::onDataAvailable() callback forwarding function. More...

void	onDataUnavailable (XsDevice *dev, int64_t packetId) override
	The XsCallback::onDataUnavailable() callback forwarding function. More...

void	onDeviceStateChanged (XsDevice *dev, XsDeviceState newState, XsDeviceState oldState) override
	The XsCallback::onDeviceStateChanged() callback forwarding function. More...

void	onError (XsDevice *dev, XsResultValue error) override
	The Xscallback::onError() callback forwarding function. More...

void	onInfoResponse (XsDevice *dev, XsInfoRequest request) override
	The XsCallback::onInfoResponse() callback forwarding function. More...

void	onLiveDataAvailable (XsDevice dev, const XsDataPacket packet) override
	The XsCallback::onLiveDataAvailable() callback forwarding function. More...

void	onMessageDetected (XsDevice dev, XsProtocolType type, XsByteArray const rawMessage) override
	The Xscallback::onMessageReceivedFromDevice() callback forwarding function. More...

void	onMessageReceivedFromDevice (XsDevice dev, XsMessage const message) override
	The Xscallback::onMessageReceivedFromDevice() callback forwarding function. More...

void	onMessageSentToDevice (XsDevice dev, XsMessage const message) override
	The Xscallback::onMessageSentToDevice() callback forwarding function. More...

void	onMissedPackets (XsDevice *dev, int count, int first, int last) override
	The XsCallback::onMissedPackets() callback forwarding function. More...

void	onNonDataMessage (XsDevice dev, XsMessage const message) override
	The Xscallback::onNonDataMessage() callback forwarding function. More...

void	onProgressUpdated (XsDevice dev, int current, int total, const XsString identifier) override
	The XsCallback::onProgressUpdated() callback forwarding function. More...

void	onRecordedDataAvailable (XsDevice dev, const XsDataPacket data) override
	The XsCallback::onRecordedDataAvailable() callback forwarding function. More...

void	onRestoreCommunication (const XsString *portName, XsResultValue result) override
	The Xscallback::onRestoreCommunication callback forwarding function. More...

void	onTransmissionRequest (int channelId, const XsByteArray *data) override

void	onWakeupReceived (XsDevice *dev) override
	The XsCallback::onWakeupReceived() callback forwarding function. More...

int	onWriteMessageToLogFile (XsDevice dev, const XsMessage message) override
	The XsCallback::onWriteMessageToLogFile() callback forwarding function. More...

void	removeCallbackHandler (XsCallbackPlainC *cb, bool chain=true)
	Remove a handler from the list. More...

void	removeChainedManager (CallbackManagerXda *cm)
	Remove achained manager from the list. More...

	~CallbackManagerXda ()
	Destructor, clears the callback list. More...

Static Public Member Functions
static int	calcFrequency (int baseFrequency, uint16_t skipFactor)
	Calculates the frequency. More...

Static Public Member Functions inherited from XsDevice
static bool	isCompatibleSyncSetting (XsDeviceId const &deviceId, XsSyncSetting const &setting1, XsSyncSetting const &setting2)
	Determines whether setting1 is compatible with setting2 for deviceId deviceId. More...

static XsSyncSettingArray	supportedSyncSettings (XsDeviceId const &deviceId)
	Return the supported synchronization settings for a specified deviceId or deviceId mask. More...

static bool	supportsSyncSettings (XsDeviceId const &deviceId)
	Determines whether the device specified by deviceId supports sync settings. More...

static unsigned int	syncSettingsTimeResolutionInMicroSeconds (XsDeviceId const &deviceId)

Protected Member Functions
virtual void	fetchAvailableHardwareScenarios ()
	Fetches available hardware scenarios. More...

	MtDevice (Communicator *comm)
	Constructs a standalone MtDevice based on comm. More...

	MtDevice (XsDevice *, const XsDeviceId &)
	Constructs a standalone MtDevice based on master and childDeviceId. More...

	MtDevice (XsDeviceId const &id)
	Constructs a standalone MtDevice with device Id id. More...

XsFilterProfileArray	readFilterProfilesFromDevice () const
	Request the filter profiles headers from the hardware device and returns a vector with the found profiles. the order in the output vector is the same as the order in the hardware device. More...

uint32_t	syncTicksToUs (uint32_t ticks) const
	Convert mt sync ticks to microseconds. More...

virtual void	updateFilterProfiles ()
	Updates the scenarios. More...

uint32_t	usToSyncTicks (uint32_t us) const
	Convert microseconds to mt sync ticks. More...

Protected Member Functions inherited from XsDeviceEx
	XsDeviceEx (Communicator *comm)
	Construct a device using comm for communication. More...

	XsDeviceEx (XsDevice *master, const XsDeviceId &childDeviceId)
	Construct a device using a device id childDeviceId for master masterDevice. More...

	XsDeviceEx (XsDeviceId const &id)
	Construct a device using a device id id. More...

virtual	~XsDeviceEx ()
	Destroy the device. More...

Protected Member Functions inherited from XsDevice
virtual void	clearExternalPacketCaches ()

virtual XsDevice const *	firstChild () const

virtual bool	interpolateMissingData (XsDataPacket const &pack, XsDataPacket const &prev, std::function< void(XsDataPacket *)> packetHandler)

void	retainPacket (XsDataPacket const &pack)

void	setCommunicator (Communicator *comm)

virtual void	setRecordingStartFrame (uint16_t startFrame)

virtual void	setRecordingStopFrame (uint16_t stopFrame)

virtual bool	shouldDataMsgBeRecorded (const XsMessage &msg) const

virtual bool	shouldDoRecordedCallback (XsDataPacket const &packet) const

bool	skipEmtsReadOnInit () const

void	updateLastAvailableLiveDataCache (XsDataPacket const &pack)

void	useLogInterface (DataLogger *logger)
	Uses log interface for a given data logger. More...

	XSENS_DISABLE_COPY (XsDevice)

void	extractFirmwareVersion (XsMessage const &message)

virtual void	setDeviceState (XsDeviceState state)

virtual void	updateDeviceState (XsDeviceState state)

void	removeIfNoRefs ()

	XsDevice (XsDeviceId const &id)
	Construct an empty device with device id id. More...

	XsDevice (Communicator *comm)
	Construct a device using inf for communication. More...

	XsDevice (XsDevice *master, const XsDeviceId &childDeviceId)
	Construct a device with device id childDeviceId for master masterDevice. More...

const XsDeviceConfiguration &	deviceConfig () const

void	setDeviceId (const XsDeviceId &deviceId)

XsOutputConfiguration	findConfiguration (XsDataIdentifier dataType) const

virtual void	writeMessageToLogFile (const XsMessage &message)

virtual void	writeFilterStateToFile ()

virtual void	processLivePacket (XsDataPacket &pack)

virtual void	processBufferedPacket (XsDataPacket &pack)

virtual bool	readDeviceConfiguration ()

XsDataPacket &	latestLivePacket ()

XsDataPacket &	latestBufferedPacket ()

XsDataPacket const &	latestLivePacketConst () const

XsDataPacket const &	latestBufferedPacketConst () const

virtual int64_t	latestLivePacketId () const

virtual int64_t	latestBufferedPacketId () const

virtual void	resetPacketStamping ()

void	updateConnectivityState (XsConnectivityState newState)

virtual XsConnectivityState	defaultChildConnectivityState () const

void	setInitialized (bool initialized)
	Set the initialized state to initialized. More...

void	setTerminationPrepared (bool prepared) NOEXCEPT
	Set the "termination prepared" state to prepared. More...

virtual bool	shouldWriteMessageToLogFile (const XsMessage &msg) const

virtual bool	shouldWriteMessageToLogFile (const XsDevice *dev, const XsMessage &message) const

virtual XsResultValue	setOutputConfigurationInternal (XsOutputConfigurationArray &config)

bool	doTransaction (const XsMessage &snd) const

bool	doTransaction (const XsMessage &snd, XsMessage &rcv) const

bool	doTransaction (const XsMessage &snd, XsMessage &rcv, uint32_t timeout) const

bool	doTransaction (const XsMessage &snd, uint32_t timeout) const

bool	justWriteSetting () const

virtual void	clearProcessors ()

virtual void	clearDataCache ()

virtual void	insertIntoDataCache (int64_t pid, XsDataPacket *pack)

virtual void	reinitializeProcessors ()

virtual bool	expectingRetransmissionForPacket (int64_t packetId) const

virtual bool	resetRemovesPort () const

virtual bool	isSoftwareFilteringEnabled () const

virtual bool	isSoftwareCalibrationEnabled () const

virtual void	setStartRecordingPacketId (int64_t startFrame)

virtual void	setStopRecordingPacketId (int64_t stopFrame)

virtual void	endRecordingStream ()

virtual void	clearCacheToRecordingStart ()

Static Protected Member Functions
static XsString	stripProductCode (const XsString &code)
	Helper function to strip the hardware type from the product code. More...

Static Protected Member Functions inherited from XsDevice
static bool	checkDataEnabled (XsDataIdentifier dataType, XsOutputConfigurationArray const &configurations)

static bool	packetContainsRetransmission (XsDataPacket const &pack)

Protected Attributes
XsFilterProfile	m_hardwareFilterProfile
	A hardware filter profile. More...

XsFilterProfileArray	m_hardwareFilterProfiles
	A vector of hardware filter profiles. More...

Protected Attributes inherited from XsDevice
Communicator *	m_communicator
	A communicator. More...

XsDeviceConfiguration	m_config
	A device configuration. More...

XsConnectivityState	m_connectivity
	A current device connectivity state. More...

DataPacketCache	m_dataCache
	A data cache. More...

XsDeviceId	m_deviceId
	An ID of the device. More...

xsens::GuardedMutex	m_deviceMutex
	The mutex for guarding state changes of the device. More...

XsMessage	m_emtsBlob
	An EMTS blob from device. More...

XsVersion	m_firmwareVersion
	A firmware version. More...

bool	m_gotoConfigOnClose
	Go to confing on close boolean variable. More...

bool	m_isInitialized
	Is intialized boolean variable. More...

bool	m_justWriteSetting
	Just write setting boolean variable. More...

XsDataPacket *	m_lastAvailableLiveDataCache
	A last available live data cache. More...

XsTimeStamp	m_lastDataOkStamp
	A time stamp for an OK last data. More...

LastResultManager	m_lastResult
	The last result of an operation. More...

XsDataPacket *	m_latestBufferedPacket
	A copy of the latest ready recording packet. This is the last packet that was popped off the front of m_dataCache. Use latestBufferedPacket() to access. More...

XsDataPacket *	m_latestLivePacket
	A copy of the latest ready live packet. This is the packet with the highest 64-bit sample counter so far. Use latestLivePacket() to access. More...

std::deque< XsDataPacket * >	m_linearPacketCache
	A linear data packet cache. More...

DataLogger *	m_logFileInterface
	A data logger for a file interface. More...

xsens::Mutex	m_logFileMutex
	The mutex for guarding access to the log file. More...

XsDevice *	m_master
	A device object. More...

XsOption	m_options
	The options. More...

XsOutputConfigurationArray	m_outputConfiguration
	A devices output configuration. More...

PacketStamper	m_packetStamper
	A packet stamper. More...

volatile std::atomic_int	m_refCounter
	A reference counter. More...

bool	m_skipEmtsReadOnInit
	Skip EMTS read on init boolean variable. More...

int64_t	m_startRecordingPacketId
	The ID of the first packet that should be / was recorded. More...

XsDeviceState	m_state
	A current device state. More...

int64_t	m_stoppedRecordingPacketId
	The ID of the last packet that was recorded. Remains valid after Flushing has ended, until a new recording is started. More...

int64_t	m_stopRecordingPacketId
	The ID of the last packet that should be / was recorded. Only valid in Recording/Flushing states. More...

bool	m_terminationPrepared
	Termination prepared boolean variable. More...

DebugFileType *	m_toaDumpFile
	To a dump file. More...

int64_t	m_unavailableDataBoundary
	A packet ID of the last sample we know to be unavailable. More...

bool	m_writeToFile
	Write to file boolean variable. More...

Detailed Description

MT device base class.

Definition at line 84 of file mtdevice.h.

Constructor & Destructor Documentation

◆ ~MtDevice()

MtDevice::~MtDevice ( )

virtual

Destroys the MtDevice.

Definition at line 104 of file mtdevice.cpp.

◆ MtDevice() [1/3]

MtDevice::MtDevice ( XsDeviceId const & id )

explicitprotected

Constructs a standalone MtDevice with device Id id.

Definition at line 83 of file mtdevice.cpp.

◆ MtDevice() [2/3]

MtDevice::MtDevice ( Communicator * comm )

explicitprotected

Constructs a standalone MtDevice based on comm.

Definition at line 90 of file mtdevice.cpp.

◆ MtDevice() [3/3]

MtDevice::MtDevice	(	XsDevice *	master,
		const XsDeviceId &	childDeviceId
	)

explicitprotected

Constructs a standalone MtDevice based on master and childDeviceId.

Definition at line 97 of file mtdevice.cpp.

Member Function Documentation

◆ accelerometerRange()

double MtDevice::accelerometerRange ( ) const

virtual

Returns: The accelerometer range for this device

The range is an absolute maximum number. This means that if 100 is returned, the sensor range is (100, -100)

Reimplemented from XsDevice.

Definition at line 668 of file mtdevice.cpp.

◆ availableOnboardFilterProfiles()

XsFilterProfileArray MtDevice::availableOnboardFilterProfiles ( ) const

overridevirtual

Return the list of filter profiles available on the device.

Reimplemented from XsDevice.

Definition at line 435 of file mtdevice.cpp.

◆ calcFrequency()

int MtDevice::calcFrequency	(	int	baseFrequency,
		uint16_t	skipFactor
	)

static

Calculates the frequency.

Parameters

baseFrequency	The base frequency to calculate with
skipFactor	The skip factor to calculate with

Returns: The calculated frequency

Definition at line 854 of file mtdevice.cpp.

◆ canDoOrientationResetInFirmware()

bool MtDevice::canDoOrientationResetInFirmware ( XsResetMethod method )

virtual

Checks if this device can do orientation reset in firmware.

Parameters

method The reset method

Returns: True if successful

Definition at line 298 of file mtdevice.cpp.

◆ deviceOptionFlags()

XsDeviceOptionFlag MtDevice::deviceOptionFlags ( ) const

overridevirtual

Returns the device option flags.

Reimplemented from XsDevice.

Definition at line 216 of file mtdevice.cpp.

◆ errorMode()

XsErrorMode MtDevice::errorMode ( ) const

virtual

Returns: the error mode of the device.

See also: setErrorMode

Reimplemented from XsDevice.

Reimplemented in MtiBaseDevice.

Definition at line 754 of file mtdevice.cpp.

◆ fetchAvailableHardwareScenarios()

void MtDevice::fetchAvailableHardwareScenarios ( )

protectedvirtual

Fetches available hardware scenarios.

Reimplemented in MtiBaseDevice.

Definition at line 480 of file mtdevice.cpp.

◆ getBaseFrequency()

int MtDevice::getBaseFrequency ( XsDataIdentifier dataType = XDI_None ) const

virtual

Returns the base update rate (Hz) corresponding to the dataType. Returns 0 if no update rate is available.

Reimplemented in MtiBaseDevice.

Definition at line 913 of file mtdevice.cpp.

◆ gnssReceiverSettings()

XsIntArray MtDevice::gnssReceiverSettings ( ) const

overridevirtual

Gets some GNSS receiver settings.

Returns: XsIntArray containing the receiver settings

Reimplemented from XsDevice.

Definition at line 248 of file mtdevice.cpp.

◆ gyroscopeRange()

double MtDevice::gyroscopeRange ( ) const

virtual

Returns: The accelerometer range for this device

The range is an absolute maximum number. This means that if 300 is returned, the sensor range is (300, -300)

Reimplemented from XsDevice.

Definition at line 676 of file mtdevice.cpp.

◆ hardwareVersion()

XsVersion MtDevice::hardwareVersion ( ) const

virtual

Return the hardware version of the device.

Reimplemented from XsDevice.

Definition at line 424 of file mtdevice.cpp.

◆ headingOffset()

double MtDevice::headingOffset ( ) const

virtual

The heading offset set for this device.

Reimplemented from XsDevice.

Definition at line 374 of file mtdevice.cpp.

◆ initialize()

bool MtDevice::initialize ( )

overridevirtual

Initialize the Mt device using the supplied filter profiles.

Returns: True if successful

Reimplemented from XsDevice.

Definition at line 120 of file mtdevice.cpp.

◆ initialPositionLLA()

XsVector MtDevice::initialPositionLLA ( ) const

overridevirtual

Returns: the current sensor position

See also: setInitialPositionLLA

Reimplemented from XsDevice.

Definition at line 724 of file mtdevice.cpp.

◆ isMotionTracker()

bool MtDevice::isMotionTracker ( ) const

overridevirtual

Returns: True if this is a motion tracker

Reimplemented from XsDevice.

Definition at line 169 of file mtdevice.cpp.

◆ locationId()

int MtDevice::locationId ( ) const

virtual

Get the location ID of the device.

Reimplemented from XsDevice.

Definition at line 398 of file mtdevice.cpp.

◆ messageLooksSane()

bool MtDevice::messageLooksSane ( const XsMessage & msg ) const

overridevirtual

Checks for the sanity of a message.

Parameters

msg	A message to check

Returns: True if successful

Reimplemented from XsDevice.

Definition at line 112 of file mtdevice.cpp.

◆ onboardFilterProfile()

XsFilterProfile MtDevice::onboardFilterProfile ( ) const

overridevirtual

Gets the filter profile in use by the device for computing orientations.

Reimplemented from XsDevice.

Definition at line 536 of file mtdevice.cpp.

◆ outputConfiguration()

XsOutputConfigurationArray MtDevice::outputConfiguration ( ) const

overridevirtual

Returns the currently configured output of the device.

Reimplemented from XsDevice.

Reimplemented in MtiBaseDevice.

Definition at line 289 of file mtdevice.cpp.

◆ productCode()

XsString MtDevice::productCode ( ) const

virtual

Return the product code of the device.

Reimplemented from XsDevice.

Definition at line 497 of file mtdevice.cpp.

◆ readFilterProfilesFromDevice()

XsFilterProfileArray MtDevice::readFilterProfilesFromDevice ( ) const

protected

Request the filter profiles headers from the hardware device and returns a vector with the found profiles. the order in the output vector is the same as the order in the hardware device.

Definition at line 443 of file mtdevice.cpp.

◆ reinitialize()

bool MtDevice::reinitialize ( )

virtual

Reinitialize the XsDevice.

Reimplemented from XsDevice.

Definition at line 514 of file mtdevice.cpp.

◆ requestData()

bool MtDevice::requestData ( )

virtual

Request data from the motion tracker.

The reply is handled by the live data path. This functionality is only available if outputSkipFactor() is set to 0xffff.

Returns: True if successful

Reimplemented from XsDevice.

Definition at line 812 of file mtdevice.cpp.

◆ resetLogFileReadPosition()

bool MtDevice::resetLogFileReadPosition ( )

overridevirtual

Set the read position of the open log file to the start of the file.

If software filtering is enabled, the appropriate filters will be restarted as if the file was just opened. This function sets the lastResult value to indicate success (XRV_OK) or failure.

Returns: True if successful

See also: lastResult()

Note: This is a low-level file operation.

Reimplemented from XsDevice.

Definition at line 873 of file mtdevice.cpp.

◆ restoreFactoryDefaults()

bool MtDevice::restoreFactoryDefaults ( )

virtual

Restore to factory default settings.

Reimplemented from XsDevice.

Definition at line 526 of file mtdevice.cpp.

◆ rs485TransmissionDelay()

uint16_t MtDevice::rs485TransmissionDelay ( ) const

virtual

Return the RS485 acknowledge transmission delay of the device.

The RS485 acknowledge transmission delay determines the minimal delay to response on request messages. See the low-level communication documentation for more details.

Returns: The delay value

See also: setRs485TransmissionDelay()

Reimplemented from XsDevice.

Reimplemented in MtiBaseDevice.

Definition at line 784 of file mtdevice.cpp.

◆ runSelfTest()

XsSelfTestResult MtDevice::runSelfTest ( )

virtual

Run a self test.

Returns: The self test result

Reimplemented from XsDevice.

Definition at line 823 of file mtdevice.cpp.

◆ scheduleOrientationReset()

bool MtDevice::scheduleOrientationReset ( XsResetMethod method )

virtual

Reimplemented from XsDevice.

Definition at line 318 of file mtdevice.cpp.

◆ serialBaudRate()

XsBaudRate MtDevice::serialBaudRate ( ) const

overridevirtual

The baud rate configured for cabled connection.

Reimplemented from XsDevice.

Definition at line 411 of file mtdevice.cpp.

◆ setErrorMode()

bool MtDevice::setErrorMode ( XsErrorMode em )

virtual

Set the error mode of the device.

The error mode determines how the device handles errors. See the low-level communication documentation for more details.

Parameters

em	The error mode

Returns: True if successful

See also: errorMode

Reimplemented from XsDevice.

Reimplemented in MtiBaseDevice.

Definition at line 769 of file mtdevice.cpp.

◆ setGnssReceiverSettings()

bool MtDevice::setGnssReceiverSettings ( const XsIntArray & gnssReceiverSettings )

overridevirtual

Sets some GNSS receiver settings.

Parameters

gnssReceiverSettings XsIntArray containing the receiver settings, that are to be set

Returns: true if the settings were successfully set; false otherwise

Reimplemented from XsDevice.

Definition at line 266 of file mtdevice.cpp.

◆ setInitialPositionLLA()

bool MtDevice::setInitialPositionLLA ( const XsVector & lla )

overridevirtual

Set the current sensor position.

Use this function to set the current position in latitude, longitude, altitude.

Parameters

lla	The LLA vector

Returns: True if successful

See also: initialPositionLLA

Reimplemented from XsDevice.

Reimplemented in MtiBaseDevice.

Definition at line 706 of file mtdevice.cpp.

◆ setLocationId()

bool MtDevice::setLocationId ( int id )

virtual

Set the location ID of the device.

Reimplemented from XsDevice.

Definition at line 387 of file mtdevice.cpp.

◆ setNoRotation()

bool MtDevice::setNoRotation ( uint16_t duration )

virtual

Set the no rotation period to duration.

Reimplemented from XsDevice.

Reimplemented in MtiBaseDevice.

Definition at line 691 of file mtdevice.cpp.

◆ setOnboardFilterProfile() [1/2]

bool MtDevice::setOnboardFilterProfile ( int profileType )

overridevirtual

Sets the filter profile to use for computing orientations on the device.

Reimplemented from XsDevice.

Definition at line 600 of file mtdevice.cpp.

◆ setOnboardFilterProfile() [2/2]

bool MtDevice::setOnboardFilterProfile ( XsString const & profileType )

overridevirtual

Sets the filter profile to use for computing orientations on the device.

Reimplemented from XsDevice.

Definition at line 626 of file mtdevice.cpp.

◆ setRs485TransmissionDelay()

bool MtDevice::setRs485TransmissionDelay ( uint16_t delay )

virtual

Set the RS485 acknowledge transmission delay of the device.

Parameters

delay The delay value

Returns: True if successful

See also: rs485TransmissionDelay()

Reimplemented from XsDevice.

Reimplemented in MtiBaseDevice.

Definition at line 798 of file mtdevice.cpp.

◆ setUbloxGnssPlatform()

bool MtDevice::setUbloxGnssPlatform ( XsUbloxGnssPlatform ubloxGnssPlatform )

overridevirtual

Set the device GNSS platform for u-blox GNSS receivers.

Reimplemented from XsDevice.

Reimplemented in Mti6X0Device.

Definition at line 236 of file mtdevice.cpp.

◆ storeAlignmentMatrix()

bool MtDevice::storeAlignmentMatrix ( )

virtual

Store the current alignment matrix in the device.

The alignment matrix is computed when doing an orientation reset and needs to be stored explicitly in the device or it will be forgotten when the device restarts. This function will tell the device to store its alignment matrix or to write the locally computed alignment matrix to the device when filtering is done on the PC side.

Returns: true if the alignment matrix was successfully written to the non-volatile memory of the device

Definition at line 364 of file mtdevice.cpp.

◆ storeFilterState()

bool MtDevice::storeFilterState ( )

overridevirtual

Store orientation filter state in the device.

Reimplemented from XsDevice.

Definition at line 836 of file mtdevice.cpp.

◆ stringOutputType()

uint16_t MtDevice::stringOutputType ( ) const

overridevirtual

Returns the string output type.

Reimplemented from XsDevice.

Definition at line 183 of file mtdevice.cpp.

◆ stringSamplePeriod()

uint16_t MtDevice::stringSamplePeriod ( ) const

overridevirtual

Returns the sample period for string output.

Reimplemented from XsDevice.

Definition at line 194 of file mtdevice.cpp.

◆ stringSkipFactor()

uint16_t MtDevice::stringSkipFactor ( ) const

overridevirtual

Returns the skipfactor for string output.

Reimplemented from XsDevice.

Definition at line 205 of file mtdevice.cpp.

◆ stripProductCode()

XsString MtDevice::stripProductCode ( const XsString & code )

staticprotected

Helper function to strip the hardware type from the product code.

Parameters

code	A productcode to be stripped

Returns: Code without the hardware type postfix

Definition at line 895 of file mtdevice.cpp.

◆ supportedStatusFlags()

uint32_t MtDevice::supportedStatusFlags ( ) const

overridevirtual

Returns a bitmask with all the status flags supported by this device.

Not all devices support all status flags. When receiving an XsDataPacket with a status in it, this can affect how to interpret the flags. Especially with a flag like the self-test it's important not to conclude that a device is defective because it is not set when the device doesn't actually support this feature.

Returns: The bitmask with all the status flags that this device supports

Reimplemented from XsDevice.

Reimplemented in Mti3X0Device, MtiXDevice, Mti6X0Device, Mti8X0Device, MTi7_MTi8Device, MtiX00Device, MtiX0Device, and MtigDevice.

Definition at line 885 of file mtdevice.cpp.

◆ syncTicksToUs()

uint32_t MtDevice::syncTicksToUs ( uint32_t ticks ) const

protected

Convert mt sync ticks to microseconds.

Definition at line 739 of file mtdevice.cpp.

◆ ubloxGnssPlatform()

XsUbloxGnssPlatform MtDevice::ubloxGnssPlatform ( ) const

overridevirtual

Returns the device GNSS platform for u-blox GNSS receivers.

Reimplemented from XsDevice.

Reimplemented in Mti6X0Device.

Definition at line 226 of file mtdevice.cpp.

◆ updateFilterProfiles()

void MtDevice::updateFilterProfiles ( )

protectedvirtual

Updates the scenarios.

Definition at line 141 of file mtdevice.cpp.

◆ updateRateForDataIdentifier()

int MtDevice::updateRateForDataIdentifier ( XsDataIdentifier dataType ) const

overridevirtual

Returns the currently configured update rate for the supplied dataType.

Reimplemented from XsDevice.

Definition at line 176 of file mtdevice.cpp.

◆ usToSyncTicks()

uint32_t MtDevice::usToSyncTicks ( uint32_t us ) const

protected

Convert microseconds to mt sync ticks.

Definition at line 746 of file mtdevice.cpp.

◆ writeDeviceSettingsToFile()

void MtDevice::writeDeviceSettingsToFile ( )

overridevirtual

Write the emts of the device to the open logfile.

Note: The default implementation of MtDevice does not include any children

Reimplemented from XsDevice.

Definition at line 684 of file mtdevice.cpp.

Member Data Documentation

◆ m_hardwareFilterProfile

XsFilterProfile MtDevice::m_hardwareFilterProfile

protected

A hardware filter profile.

Definition at line 181 of file mtdevice.h.

◆ m_hardwareFilterProfiles

XsFilterProfileArray MtDevice::m_hardwareFilterProfiles

protected

A vector of hardware filter profiles.

Definition at line 178 of file mtdevice.h.

The documentation for this class was generated from the following files:

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ~MtDevice()

◆ MtDevice() [1/3]

◆ MtDevice() [2/3]

◆ MtDevice() [3/3]

Member Function Documentation

◆ accelerometerRange()

◆ availableOnboardFilterProfiles()

◆ calcFrequency()

◆ canDoOrientationResetInFirmware()

◆ deviceOptionFlags()

◆ errorMode()

◆ fetchAvailableHardwareScenarios()

◆ getBaseFrequency()

◆ gnssReceiverSettings()

◆ gyroscopeRange()

◆ hardwareVersion()

◆ headingOffset()

◆ initialize()

◆ initialPositionLLA()

◆ isMotionTracker()

◆ locationId()

◆ messageLooksSane()

◆ onboardFilterProfile()

◆ outputConfiguration()

◆ productCode()

◆ readFilterProfilesFromDevice()

◆ reinitialize()

◆ requestData()

◆ resetLogFileReadPosition()

◆ restoreFactoryDefaults()

◆ rs485TransmissionDelay()

◆ runSelfTest()

◆ scheduleOrientationReset()

◆ serialBaudRate()

◆ setErrorMode()

◆ setGnssReceiverSettings()

◆ setInitialPositionLLA()

◆ setLocationId()

◆ setNoRotation()

◆ setOnboardFilterProfile() [1/2]

◆ setOnboardFilterProfile() [2/2]

◆ setRs485TransmissionDelay()

◆ setUbloxGnssPlatform()

◆ storeAlignmentMatrix()

◆ storeFilterState()

◆ stringOutputType()

◆ stringSamplePeriod()

◆ stringSkipFactor()

◆ stripProductCode()

◆ supportedStatusFlags()

◆ syncTicksToUs()

◆ ubloxGnssPlatform()

◆ updateFilterProfiles()

◆ updateRateForDataIdentifier()

◆ usToSyncTicks()

◆ writeDeviceSettingsToFile()

Member Data Documentation

◆ m_hardwareFilterProfile

◆ m_hardwareFilterProfiles