Tezzeret  1
Tezzeret
Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions | Protected Attributes | Static Protected Attributes | List of all members
Geometrics::GmMfamDataSource Class Referenceabstract

Abstract class - the interface - to the MFAM sensor. This abstract layer was created in order to accommodate the creation of two MFAM sensors, one - Geometrics::GmMfam - for acquiring data from the actual physics package, and another - Geometrics::GmMfamEmulator - for use in developing and debugging MFAM-based applications. More...

#include <GmMFAMDataSource.hpp>

Inheritance diagram for Geometrics::GmMfamDataSource:
Inheritance graph
[legend]
Collaboration diagram for Geometrics::GmMfamDataSource:
Collaboration graph
[legend]

Public Member Functions

 GmMfamDataSource (UInt8 iSubjectId, GmManagedArrayRingBuffer< uint8_t, GM_SIZE_OF_APP_DATA_QUEUE > *mainEventQueue)
 
int Start ()
 
virtual int CheckCalibrate (Bool bForceCalibrate)
 
int SetSimpleSubsampleRate (int iNewRate)
 
int ResetBuffers (Bool bForceCalibrate)
 
virtual UInt16 SystemStatus ()
 
virtual int WriteToStorage (UInt32 ui32Topic, char *pData, UInt32 iSize, GmStorage *psStorage, UInt32 ui32FormatId)
 
virtual void Halt ()=0
 
Bool IsSuperMag ()
 
Bool MagOneDataValid ()
 
Bool MagTwoDataValid ()
 
Bool PpsLocked ()
 
Bool PpsAvailable ()
 
int MagOneStartupStatusString (char *strBuffer, int iBufferLength)
 
int MagTwoStartupStatusString (char *strBuffer, int iBufferLength)
 
int MagOneOperatingStatusString (char *strBuffer, int iBufferLength)
 
int MagTwoOperatingStatusString (char *strBuffer, int iBufferLength)
 
int LastMagOneDataValue (float *pfDataValue)
 
int LastMagTwoDataValue (float *pfDataValue)
 
UInt16 MagMainMode ()
 
UInt16 CompassStatus ()
 
bool IsInStartup ()
 
Bool SystemHasStartedUp ()
 
Bool SystemFailed ()
 
void SaveMonitorPacket (IndexedMfamFilteredPacketWithHeader *pMonitorPacket, Bool bFilter)
 
- Public Member Functions inherited from Geometrics::GmBufferedSensor
 GmBufferedSensor (UInt8 iSubjectId, int iRingCount, int iDataSize, GmManagedArrayRingBuffer< uint8_t, GM_SIZE_OF_APP_DATA_QUEUE > *mainEventQueue)
 Constructor for derived classes, when it's OK to allocate a local buffer dynamically. More...
 
 GmBufferedSensor (UInt8 iSubjectId, int iRingCount, int iDataSize, UInt8 *puiBuffer, UInt32 uiBufferSize, GmManagedArrayRingBuffer< uint8_t, GM_SIZE_OF_APP_DATA_QUEUE > *mainEventQueue)
 Constructor used by most derived classes on memory-constrained systems. In this case the derived class provides a buffer, usually static, so that the buffer doesn't need to be allocated dynamically. More...
 
int Start ()
 
int ResetBuffers ()
 
Bool HasData ()
 
int ReadRecord (char *pcDestination, int iSize)
 The main interface for consumers of a sensors data to get that data. It simply copies the data in the sensor's buffer into the caller's buffer. It is up to the caller to know what to do with that data, and how to free any local memory. (This function should have been name ReadNextRecord)
 
virtual int DeleteNextRecord ()
 DeleteNextRecord allows a caller to discard the next record without retrieving it. The subclasses that implement DeleteNextRecord must be able to deal with any memory that needs to be freed, or other such concerns.
 
- Public Member Functions inherited from Geometrics::GmEventSource
void SetSensorId (int iSensorId)
 
int GetSensorId ()
 

Static Public Member Functions

static int DecodeMagStartupStatus (UInt16 iMagStatus, char *strBuffer, int iBufferLength)
 
static int DecodeMagOperatingStatus (UInt16 iMagStatus, char *strBuffer, int iBufferLength)
 

Public Attributes

uint32_t mQueueFillTopThreshold
 
uint32_t mQueueFillRestartThreshold
 
- Public Attributes inherited from Geometrics::GmBufferedSensor
CChildRingBufferm_rbBuffer
 The local buffer into which the sensor or event source stores each of its events or measurements. When an item is committed to this buffer, it also adds an event (consisting of the sensor's subject ID) into the application main event queue. The full event or measurement remains here, until the application reads the subject ID out of the main queue and then asks this sensor object for the full information by calling ReadRecord.
 
UInt8 m_iSubjectId
 

Static Public Attributes

static UInt16 m_static_iSystemStatus
 

Protected Member Functions

int RecordStatus (MfamSpiPacket *pmspRecord)
 

Protected Attributes

IndexedMfamFilteredPacketWithHeader m_mspStatusPacket
 
int m_iSimpleSubsampleRate
 
IndexedMfamFilteredPacketWithHeader m_amspStatusRecords [MAG_SPI_TOTAL_RECORDS]
 
- Protected Attributes inherited from Geometrics::GmEventSource
int m_iSensorId
 

Static Protected Attributes

static bool m_static_boolInitialized
 
static int m_static_iSubsampleCount = 0
 

Detailed Description

Abstract class - the interface - to the MFAM sensor. This abstract layer was created in order to accommodate the creation of two MFAM sensors, one - Geometrics::GmMfam - for acquiring data from the actual physics package, and another - Geometrics::GmMfamEmulator - for use in developing and debugging MFAM-based applications.

Member Function Documentation

◆ WriteToStorage()

int GmMfamDataSource::WriteToStorage ( UInt32  ui32Topic,
char *  pData,
UInt32  iSize,
GmStorage psStorage,
UInt32  ui32FormatId 
)
virtual

Virtual function, abstract in this class, called when a sensor should write its data to a storage or other event handler.

Parameters
ui32TopicHint to the storage (MQTT is one) about adding some topic or header information about the data. Not all storages use the hint.
pDataThe data to be written.
iSizeSize of the data to be written.
psStorageStorage or event handler to which the data will be written.
ui32FormatIdFormatting information to be used by the sensor. Within a single application, a sensor might be asked to write different formats to different storages or event handlers. Very likely the per-storage, per-mode information was stored in an instance of Geometrics::SensorStorageModeInfo.

Implements Geometrics::GmEventSource.


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