The class provide support for TE 5525DSO Pressure sensor. More...

#include <driver_5525DSO.h>

Collaboration diagram for Sensor5525DSO:

[legend]

Public Member Functions
bool	Init (t_i2cdevices device, t_ps_sensor model, t_ps_resolution ps_resolution, void *hw_handle)
	Init pressure sensor TE 5525DSO. More...

bool	doMeasure (float P, float T)
	Perform a full measure in blocking mode. More...

bool	asyncMeasure ()
	Start an asynchronous measure process (NON BLOKING) More...

bool	asyncGetResult (float P, float T)
	Get result from an NON BLOCKING measure process. More...

void	setZero (float value)
	Calibrate sensor zero with a specified value. More...

float	doZero ()
	Calculate sensor zero. More...

void	correctZero (float value)
	Incremental 0 correction for Venturi cycle to cycle adjust. More...

float	GetConversionDelay ()
	Return correction delay. More...

Private Member Functions
void	CalibrateDate_5525DSO (int32_t raw_temp, int32_t raw_pressure, float T, float P)
	Convert row measure in P/V. More...

bool	Reset_5525DSO ()
	Reset the sensor. More...

uint8_t	GetResolutionByteCodeTemp ()
	Obtain the conversion code for T for specified resolution. More...

uint8_t	GetResolutionByteCodePressure ()
	Obtain the conversion code for P for specified resolution. More...

uint32_t	GetResolutionDelay ()
	Obtain the conversion time for specified resolution. More...

Private Attributes
t_5525DSO_calibration_table	sensorCT

t_i2cdevices	i2c_device

t_ps_sensor	sensor_model

t_ps_resolution	sensor_resolution

HW *	hwi

DebugIfaceClass *	dbg

uint32_t	__chache_P

uint32_t	__chache_T

int	__TDiv

bool	__last_is_T

bool	__pending_meas

uint64_t	__last_millis

int	startup_counter

bool	data_valid

bool	_initialized = false

Detailed Description

The class provide support for TE 5525DSO Pressure sensor.

The class support both blocking and non blocking reading

Blocking Reading: The driver start conversion on the sensor and wait for the result. It require the full conversion time

Non Blocking reading: The readout process is spitted in two part 1) the measure is started on the device by asyncMeasure function 2) the result is get from the device by asyncGetResult function there is no delay and dead time

The class download calibration from the device to convert raw data to P/T automatically

Definition at line 42 of file driver_5525DSO.h.

Member Function Documentation

◆ asyncGetResult()

bool Sensor5525DSO::asyncGetResult	(	float *	P,
		float *	T
	)

Get result from an NON BLOCKING measure process.

This function must be polled after asyncMeasure is called When conversion process ends the function return true

Parameters

P	OUT pressure
T	OUT T

Returns: true readout success, false measure not available

Definition at line 211 of file driver_5525DSO.cpp.

 {
     bool bres = true;
     uint8_t wbuffer[6];
     uint8_t rbuffer[6];
     int32_t pressure_raw;
     int32_t temperature_raw;
  
     if (!_initialized) return false;
  
     //Check if there is a measure pending, if no return
     if (!__pending_meas)
         return false;
  
     //Check if conversion time is expired
     if (hwi->Get_dT_millis(__last_millis) < GetResolutionDelay())
         return false;
  
     __pending_meas = false;
  
     //Start readout process
     wbuffer[0] = 0x00;
     bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
     if (!bres) return false;
     hwi->__delay_blocking_ms(2);
     bres = hwi->I2CRead(i2c_device, rbuffer, 3, true);
     if (!bres) return false;
  
     //Get P or T and use opposite (not read value) from cache
     //Then convert raw to P,T
     if (__last_is_T)
     {
         temperature_raw = (rbuffer[0] << 16) + (rbuffer[1] << 8) + rbuffer[2];
         __chache_T = temperature_raw;
         CalibrateDate_5525DSO(__chache_T, __chache_P, T, P);
     }
     else
     {
         pressure_raw = (rbuffer[0] << 16) + (rbuffer[1] << 8) + rbuffer[2];
         __chache_P = pressure_raw;
         CalibrateDate_5525DSO(__chache_T, __chache_P, T, P);
     }
  
     //Discard data on startup
     if (startup_counter > 0)
     {
         startup_counter--;
     }
     else
     {
         data_valid = true;
     }
     
     return data_valid;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ asyncMeasure()

bool Sensor5525DSO::asyncMeasure ( )

Start an asynchronous measure process (NON BLOKING)

This function start the measure process for P/T (alternating in internally managed) and start measure timer in order to correctly delay the end of measure

Returns: true if success, false if measure is in progress

Definition at line 168 of file driver_5525DSO.cpp.

 {
     bool bres = true;
     uint8_t wbuffer[6];
  
     if (!_initialized) return false;
     
     //Check if there is a measure pending, if yes return
     if (__pending_meas)
         return false;
  
     //Every 50 cycles read temperature 
     if (__TDiv <= 0)
     {
         __TDiv = 50;
         wbuffer[0] = GetResolutionByteCodeTemp();
         bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
         if (!bres) return false;
         __last_is_T = true;
     }
     else
     {
         __TDiv--;
         wbuffer[0] = GetResolutionByteCodePressure();
         bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
         if (!bres) return false;
         __last_is_T = false;
     }
     __last_millis = hwi->GetMillis();
     __pending_meas = true;
     return true;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CalibrateDate_5525DSO()

void Sensor5525DSO::CalibrateDate_5525DSO	(	int32_t	raw_temp,
		int32_t	raw_pressure,
		float *	T,
		float *	P
	)

private

Convert row measure in P/V.

Parameters

raw_temp	raw temperature measured
raw_pressure	raw pressure measured
T	OUT Temperature
P	OUT Pressure

Definition at line 275 of file driver_5525DSO.cpp.

 {
     float PINSIDE, PINSIDE_ZERO;
     int32_t Q1 = sensorCT.Q[0];
     int32_t Q2 = sensorCT.Q[1];
     int32_t Q3 = sensorCT.Q[2];
     int32_t Q4 = sensorCT.Q[3];
     int32_t Q5 = sensorCT.Q[4];
     int32_t Q6 = sensorCT.Q[5];
  
     int32_t C1 = sensorCT.C[0];
     int32_t C2 = sensorCT.C[1];
     int32_t C3 = sensorCT.C[2];
     int32_t C4 = sensorCT.C[3];
     int32_t C5 = sensorCT.C[4];
     int32_t C6 = sensorCT.C[5];
  
     int32_t dT;
     int64_t OFF;
     int64_t SENS;
  
     int32_t Temp;
     int64_t Pres;
  
     dT = raw_temp - (C5 * pow(2, Q5));
     Temp = 2000 + ((dT * C6) / pow(2, Q6));
     OFF = (C2 * pow(2, Q2)) + ((C4 * dT) / (pow(2, Q4)));
     SENS = (C1 * pow(2, Q1)) + ((C3 * dT) / (pow(2, Q3)));
     Pres = (((raw_pressure * SENS) / (pow(2, 21))) - OFF) / (pow(2, 15));
  
     *T = ((float)Temp) / 100.0;
     PINSIDE = ((float)Pres) / 10000.0 * 68.9476;
     PINSIDE_ZERO = PINSIDE - sensorCT.ZERO;
    //     Serial.println("DBG; " + String(PINSIDE) + " " + String(sensorCT.ZERO) + " " + String(PINSIDE_ZERO));
     *P = PINSIDE_ZERO;
 }

Here is the caller graph for this function:

◆ correctZero()

void Sensor5525DSO::correctZero ( float value )

Incremental 0 correction for Venturi cycle to cycle adjust.

Parameters

value Incremental correction

Definition at line 455 of file driver_5525DSO.cpp.

 {
     sensorCT.ZERO += value;
 }

Here is the caller graph for this function:

◆ doMeasure()

bool Sensor5525DSO::doMeasure	(	float *	P,
		float *	T
	)

Perform a full measure in blocking mode.

Parameters

P	measured P in mbar
T	measured T in �C

Returns: true if success

Definition at line 107 of file driver_5525DSO.cpp.

 {
     bool bres = true;
     uint8_t wbuffer[6];
     uint8_t rbuffer[6];
     int32_t pressure_raw;
     int32_t temperature_raw;
  
     if (!_initialized) return false;
     //Read raw pressure
     wbuffer[0] = GetResolutionByteCodePressure();
     bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
     if (!bres) return false;
     hwi->__delay_blocking_ms(GetResolutionDelay()*2);
  
     wbuffer[0] = 0x00;
     bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
     if (!bres) return false;
  
     hwi->__delay_blocking_ms(2);
  
     bres = hwi->I2CRead(i2c_device, rbuffer, 3, true);
     if (!bres) return false;
   
     pressure_raw = (rbuffer[0] << 16) + (rbuffer[1] << 8) + rbuffer[2];
  
     //Read raw temperature
     wbuffer[0] = GetResolutionByteCodeTemp();
     bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
     if (!bres) return false;
     hwi->__delay_blocking_ms(GetResolutionDelay()*2);
  
     wbuffer[0] = 0x00;
     bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
     if (!bres) return false;
  
     hwi->__delay_blocking_ms(2);
  
     bres = hwi->I2CRead(i2c_device, rbuffer, 3, true);
     if (!bres) return false;
  
     temperature_raw = (rbuffer[0] << 16) + (rbuffer[1] << 8) + rbuffer[2];
  
     //Convert raw in P,T
     CalibrateDate_5525DSO(temperature_raw, pressure_raw, T, P);
  
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "T:  " + String(*T) + "   P:  " + String(*P));
  
  
     return true;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ doZero()

float Sensor5525DSO::doZero ( )

Calculate sensor zero.

The function average 50 measure to extract the 0

Returns

Definition at line 422 of file driver_5525DSO.cpp.

 {
     float T, P;
     float value=0;
     float cnt = 0;
     sensorCT.ZERO = 0;
     doMeasure(&P, &T);
  
     for (int i = 0; i < 50; i++)
     {
         
         if (doMeasure(&P, &T))
         {
             value += P;
             cnt++;
         }
  
     }
     if (cnt > 0)
     {
         value = value / cnt;
     }
     sensorCT.ZERO = value;
     doMeasure(&P, &T);
     return value;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetConversionDelay()

float Sensor5525DSO::GetConversionDelay ( )

Return correction delay.

Returns: Delay in ms

Definition at line 465 of file driver_5525DSO.cpp.

 {
     return (float) GetResolutionDelay();
 }

Here is the call graph for this function:

◆ GetResolutionByteCodePressure()

uint8_t Sensor5525DSO::GetResolutionByteCodePressure ( )

private

Obtain the conversion code for P for specified resolution.

Returns: Conversion Code

Definition at line 341 of file driver_5525DSO.cpp.

 {
     switch (sensor_resolution)       //ERRORE DEVE ESSERE ps_resolution
     {
     case OVS_256:
         return 0x40;
     case OVS_512:
         return 0x42;
     case OVS_1024:
         return 0x44;
     case OVS_2048:
         return 0x46;
     case OVS_4096:
         return 0x48;
     default:
         break;
     }
 }

Here is the caller graph for this function:

◆ GetResolutionByteCodeTemp()

uint8_t Sensor5525DSO::GetResolutionByteCodeTemp ( )

private

Obtain the conversion code for T for specified resolution.

Returns: Conversion Code

Definition at line 317 of file driver_5525DSO.cpp.

 {
     switch (sensor_resolution)       //ERRORE DEVE ESSERE ps_resolution
     {
     case OVS_256:
         return 0x50;
     case OVS_512:
         return 0x52;
     case OVS_1024:
         return 0x54;
     case OVS_2048:
         return 0x56;
     case OVS_4096:
         return 0x58;
     default:
         break;
     }
 }

Here is the caller graph for this function:

◆ GetResolutionDelay()

uint32_t Sensor5525DSO::GetResolutionDelay ( )

private

Obtain the conversion time for specified resolution.

Returns: Conversion Code

Definition at line 366 of file driver_5525DSO.cpp.

 {
     switch (sensor_resolution)       //ERRORE DEVE ESSERE ps_resolution
     {
     case OVS_256:
         return 1;
     case OVS_512:
         return 2;
     case OVS_1024:
         return 3;
     case OVS_2048:
         return 4.9;
     case OVS_4096:
         return 11;
     default:
         break;
     }
 }

Here is the caller graph for this function:

◆ Init()

bool Sensor5525DSO::Init	(	t_i2cdevices	device,
		t_ps_sensor	model,
		t_ps_resolution	ps_resolution,
		void *	handle
	)

Init pressure sensor TE 5525DSO.

The driver initialize the sensor and download the calibration table via I2C.

Calibration table is stored in the driver

The driver print the calibration table

Parameters

device	Name of the I2C device
model	Model of the sensor
ps_resolution	Resolution
handle	Handle to the DriverContext class

Returns: true if sensor is initialized correctly

Definition at line 24 of file driver_5525DSO.cpp.

 {
     //Copy device contex and extract pointer to DebugClass and Hardware Class
     DriverContext* dc;
     dc = (DriverContext*)handle;
     hwi = (HW*)dc->hwi;
     dbg = (DebugIfaceClass*)dc->dbg;
     i2c_device = device;
     sensor_model = model;
     sensor_resolution = ps_resolution;
  
     //Download calibration table from sensor
     _initialized = false;
     bool bres = true;
     uint8_t wbuffer[6];
     uint8_t rbuffer[6];
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "Starting 5525DSO Initialization... ");
  
     //Reset Senspr
     Reset_5525DSO();
     hwi->__delay_blocking_ms(100);
  
     //Read Calibration Table
     for (int i = 0; i < 6; i++) {
         wbuffer[0] = 0xA0 + ((i + 1) << 1);
         bres = hwi->I2CRead(i2c_device, wbuffer, 1, rbuffer, 2, true);
         if (!bres) return false;
         sensorCT.C[i] = (rbuffer[0] << 8) + rbuffer[1];
     }
     sensorCT.ZERO = 0;
  
     //Select coefficient in function of model
     switch (sensor_model) {
         case DS_01:
             sensorCT.Q[0] = 15;
             sensorCT.Q[1] = 17;
             sensorCT.Q[2] = 7;
             sensorCT.Q[3] = 5;
             sensorCT.Q[4] = 7;
             sensorCT.Q[5] = 21;
             break;
  
         case GS_05:
             sensorCT.Q[0] = 16;
             sensorCT.Q[1] = 17;
             sensorCT.Q[2] = 6;
             sensorCT.Q[3] = 5;
             sensorCT.Q[4] = 7;
             sensorCT.Q[5] = 21;
             break;
     }
  
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "SENS_T1:          " + String(sensorCT.C[0]));
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "OFF_T1:           " + String(sensorCT.C[1]));
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "TCS:              " + String(sensorCT.C[2]));
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "TCO:              " + String(sensorCT.C[3]));
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "TREF:             " + String(sensorCT.C[4]));
     dbg->DbgPrint(DBG_KERNEL, DBG_INFO, "TEMPSENS:         " + String(sensorCT.C[5]));
  
     //Initialize default parameters
     //We need a cache for P and T because we
     //read T only few time in order to reduce
     //bus access
     __last_is_T=false;
     __chache_P=0;
     __chache_T=0;
     __TDiv=0;
     __pending_meas = false;
  
     startup_counter = 1;
     data_valid = false;
     _initialized = true;
     __last_millis = hwi->GetMillis();
     return true;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Reset_5525DSO()

bool Sensor5525DSO::Reset_5525DSO ( )

private

Reset the sensor.

Returns: true if sensor is present

Definition at line 390 of file driver_5525DSO.cpp.

 {
     bool bres = true;
     uint8_t wbuffer[6];
  
     //Read raw pressure
     wbuffer[0] = 0x1E;
     bres = hwi->I2CWrite(i2c_device, wbuffer, 1, true);
     if (!bres) return false;
  
   
     return true;
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setZero()

void Sensor5525DSO::setZero ( float value )

Calibrate sensor zero with a specified value.

Parameters

value Value used to zero sensor

Definition at line 409 of file driver_5525DSO.cpp.

 {
     sensorCT.ZERO = value;
 }

Here is the caller graph for this function:

Member Data Documentation

◆ __chache_P

uint32_t Sensor5525DSO::__chache_P

private

Definition at line 77 of file driver_5525DSO.h.

◆ __chache_T

uint32_t Sensor5525DSO::__chache_T

private

Definition at line 78 of file driver_5525DSO.h.

◆ __last_is_T

bool Sensor5525DSO::__last_is_T

private

Definition at line 80 of file driver_5525DSO.h.

◆ __last_millis

uint64_t Sensor5525DSO::__last_millis

private

Definition at line 82 of file driver_5525DSO.h.

◆ __pending_meas

bool Sensor5525DSO::__pending_meas

private

Definition at line 81 of file driver_5525DSO.h.

◆ __TDiv

int Sensor5525DSO::__TDiv

private

Definition at line 79 of file driver_5525DSO.h.

◆ _initialized

bool Sensor5525DSO::_initialized = false

private

Definition at line 87 of file driver_5525DSO.h.

◆ data_valid

bool Sensor5525DSO::data_valid

private

Definition at line 85 of file driver_5525DSO.h.

◆ dbg

DebugIfaceClass* Sensor5525DSO::dbg

private

Definition at line 75 of file driver_5525DSO.h.

◆ hwi

HW* Sensor5525DSO::hwi

private

Definition at line 74 of file driver_5525DSO.h.

◆ i2c_device

t_i2cdevices Sensor5525DSO::i2c_device

private

Definition at line 63 of file driver_5525DSO.h.

◆ sensor_model

t_ps_sensor Sensor5525DSO::sensor_model

private

Definition at line 64 of file driver_5525DSO.h.

◆ sensor_resolution

t_ps_resolution Sensor5525DSO::sensor_resolution

private

Definition at line 65 of file driver_5525DSO.h.

◆ sensorCT

t_5525DSO_calibration_table Sensor5525DSO::sensorCT

private

Definition at line 62 of file driver_5525DSO.h.

◆ startup_counter

int Sensor5525DSO::startup_counter

private

Definition at line 84 of file driver_5525DSO.h.

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

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ asyncGetResult()

◆ asyncMeasure()

◆ CalibrateDate_5525DSO()

◆ correctZero()

◆ doMeasure()

◆ doZero()

◆ GetConversionDelay()

◆ GetResolutionByteCodePressure()

◆ GetResolutionByteCodeTemp()

◆ GetResolutionDelay()

◆ Init()

◆ Reset_5525DSO()

◆ setZero()

Member Data Documentation

◆ __chache_P

◆ __chache_T

◆ __last_is_T

◆ __last_millis

◆ __pending_meas

◆ __TDiv

◆ _initialized

◆ data_valid

◆ dbg

◆ hwi

◆ i2c_device

◆ sensor_model

◆ sensor_resolution

◆ sensorCT

◆ startup_counter