#pragma once // // FILE: MS5611_SPI.h // AUTHOR: Rob Tillaart // VERSION: 0.1.1 // PURPOSE: S5611 (SPI) Temperature & Pressure library for Arduino // URL: https://github.com/RobTillaart/MS5611_SPI #include "Arduino.h" #include "SPI.h" // BREAKOUT MS5611 aka GY63 - see datasheet // // SPI I2C // +--------+ // VCC VCC | o | // GND GND | o | // SCL | o | // SDI SDA | o | // CSO | o | // SDO | o L | L = led // PS | o O | O = opening PS = protocol select // +--------+ // // PS to VCC ==> I2C (GY-63 board has internal pull up, so not needed) // PS to GND ==> SPI // CS to VCC ==> 0x76 // CS to GND ==> 0x77 #define MS5611_SPI_LIB_VERSION (F("0.1.1 EXPERIMENTAL")) #define MS5611_READ_OK 0 #define MS5611_ERROR_2 2 // TODO ?? #define MS5611_NOT_READ -999 enum osr_t { OSR_ULTRA_HIGH = 12, // 10 millis OSR_HIGH = 11, // 5 millis OSR_STANDARD = 10, // 3 millis OSR_LOW = 9, // 2 millis OSR_ULTRA_LOW = 8 // 1 millis Default = backwards compatible }; class MS5611_SPI { public: explicit MS5611_SPI(uint8_t select, uint8_t dataOut = 255, uint8_t dataIn = 255, uint8_t clock = 255); bool begin(); bool isConnected(); // reset command + get constants // mathMode = 0 (default), 1 = factor 2 fix. // returns false if ROM constants == 0; bool reset(uint8_t mathMode = 0); // the actual reading of the sensor; // returns MS5611_READ_OK upon success int read(uint8_t bits); // wrapper, uses the preset oversampling rate. inline int read() { return read( (uint8_t) _samplingRate); }; // sets oversampling to a value between 8 and 12 void setOversampling(osr_t samplingRate); // oversampling rate is in osr_t osr_t getOversampling() const { return (osr_t) _samplingRate; }; // temperature is in ²C float getTemperature() const; // pressure is in mBar float getPressure() const; // OFFSET - 0.3.6 void setPressureOffset(float offset = 0) { _pressureOffset = offset; }; float getPressureOffset() { return _pressureOffset; }; void setTemperatureOffset(float offset = 0) { _temperatureOffset = offset; }; float getTemperatureOffset() { return _temperatureOffset; }; // to check for failure int getLastResult() const { return _result; }; // last time in millis() when the sensor has been read. uint32_t lastRead() const { return _lastRead; }; uint32_t getDeviceID() const { return _deviceID; }; void setCompensation(bool flag = true) { _compensation = flag; }; bool getCompensation() { return _compensation; }; // develop functions. /* void setAddress(uint8_t address) { _address = address; }; // RANGE CHECK uint8_t getAddress() const { return _address; }; uint8_t detectAddress() { todo }; // works with only one on the bus? */ // EXPERIMENTAL uint16_t getManufacturer(); uint16_t getSerialCode(); // speed in Hz void setSPIspeed(uint32_t speed); uint32_t getSPIspeed() { return _SPIspeed; }; // debugging bool usesHWSPI() { return _hwSPI; }; // ESP32 specific #if defined(ESP32) void selectHSPI() { _useHSPI = true; }; void selectVSPI() { _useHSPI = false; }; bool usesHSPI() { return _useHSPI; }; bool usesVSPI() { return !_useHSPI; }; // to overrule ESP32 default hardware pins void setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select); #endif protected: void convert(const uint8_t addr, uint8_t bits); uint32_t readADC(); uint16_t readProm(uint8_t reg); int command(const uint8_t command); void initConstants(uint8_t mathMode); uint8_t _address; uint8_t _samplingRate; int32_t _temperature; int32_t _pressure; float _pressureOffset; float _temperatureOffset; int _result; float C[7]; uint32_t _lastRead; uint32_t _deviceID; bool _compensation; uint8_t _select; uint8_t _dataIn; uint8_t _dataOut; uint8_t _clock; bool _hwSPI; uint32_t _SPIspeed = 1000000; uint8_t swSPI_transfer(uint8_t value); SPIClass * mySPI; SPISettings _spi_settings; #if defined(ESP32) bool _useHSPI = true; #endif }; // -- END OF FILE --