GY-63_MS5611/libraries/MTP40C/MTP40C.h
2021-12-22 11:36:50 +01:00

122 lines
2.7 KiB
C++

#pragma once
//
// FILE: MTP40C.h
// AUTHOR: Rob Tillaart
// DATE: 2021-08-20
// VERSION: 0.2.1
// PURPOSE: Arduino library for MTP40C + MTP40D CO2 sensor
// URL: https://github.com/RobTillaart/MTP40C
//
// HISTORY:
// see MTP40C.cpp file
//
// Based upon datasheet June 2020, version 2.0
//
#include "Arduino.h"
#define MTP40_LIB_VERSION (F("0.2.1"))
#define MTP40_DEFAULT_ADDRESS 0x64
#define MTP40_OK 0x00
#define MTP40_INVALID_AIR_PRESSURE 0x01
#define MTP40_INVALID_GAS_LEVEL 0x02
#define MTP40_INVALID_ADDRESS 0xFF
class MTP40
{
public:
MTP40(Stream * str);
bool begin(uint8_t address = 0x64);
bool isConnected();
uint8_t getAddress();
bool setAddress(uint8_t address = 0x64); // default
float getAirPressureReference();
bool setAirPressureReference(float apr);
uint16_t getGasConcentration(); // returns PPM
void suppressError(bool se) { _suppressError = se; };
bool getSuppressError() { return _suppressError; };
// CALIBRATION FUNCTIONS
// READ DATASHEET !!
bool setSinglePointCorrection(float spc);
bool getSinglePointCorrectionReady();
bool openSelfCalibration();
bool closeSelfCalibration();
uint8_t getSelfCalibrationStatus();
bool setSelfCalibrationHours(uint16_t hrs);
uint16_t getSelfCalibrationHours();
void setGenericAddress() { _useAddress = false; };
void setSpecificAddress() { _useAddress = true; };
bool useSpecificAddress() { return _useAddress; };
// set timeout of serial communication.
void setTimeout(uint32_t to = 100) { _timeout = to; };
uint32_t getTimeout() { return _timeout; };
uint32_t lastRead() { return _lastRead; };
// 2 = MTP40C 3 = MTP40D
uint8_t getType() { return _type; };
int lastError();
/////////////////////////
protected:
Stream * _ser;
uint8_t _buffer[24]; // should be big enough.
uint8_t _address = 64;
bool _useAddress = false;
uint32_t _timeout = 100;
uint32_t _lastRead = 0;
float _airPressureReference = 0;
uint16_t _gasLevel = 0;
uint8_t _type = 0xFF;
bool _suppressError = false;
int _lastError = MTP40_OK;
bool request(uint8_t *data, uint8_t cmdlen, uint8_t anslen);
uint16_t CRC(uint8_t *data, uint16_t len);
};
/////////////////////////////////////////////////////////////
//
// DERIVED CLASSES
//
class MTP40C : public MTP40
{
public:
MTP40C(Stream * str);
};
class MTP40D : public MTP40
{
public:
MTP40D(Stream * str);
// TODO
// I2C interface
// PWM interface
};
// -- END OF FILE --