mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
150 lines
4.0 KiB
Markdown
150 lines
4.0 KiB
Markdown
|
|
|||
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
|||
|
|
[](https://github.com/RobTillaart/MSP300/actions/workflows/arduino-lint.yml)
|
|||
|
|
[](https://github.com/RobTillaart/MSP300/actions/workflows/jsoncheck.yml)
|
|||
|
|
[](https://github.com/RobTillaart/MSP300/blob/master/LICENSE)
|
|||
|
|
[](https://github.com/RobTillaart/MSP300/releases)
|
|||
|
|
|
|||
|
|
|
|||
|
|
# MSP300
|
|||
|
|
|
|||
|
|
Arduino library for I2C MSP300 pressure transducer.
|
|||
|
|
|
|||
|
|
The library is experimental and not tested yet (no hardware).
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Description
|
|||
|
|
|
|||
|
|
The MSP300 is an industrial digital pressure transducer.
|
|||
|
|
This library implements the I2C version (J) of the sensor.
|
|||
|
|
It is written based upon the datasheet.
|
|||
|
|
|
|||
|
|
The library does not implement the SPI or analog version.
|
|||
|
|
|
|||
|
|
Note: be aware to buy the right sensor: PSI/BAR, SPI/I2C/analog and I2C address as these are hardcoded.
|
|||
|
|
(OK pressure output can be converted)
|
|||
|
|
|
|||
|
|
As the sensor is industrial quality, many applications can be realized with it.
|
|||
|
|
|
|||
|
|
Issues, remarks, experience and improvements are welcome, please open an issue on https://github.com/RobTillaart/MSP300.
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### Available pressure ranges
|
|||
|
|
|
|||
|
|
- PSI := 100, 200, 300, 500, 1K, 3K, 5K, 10K, 15K
|
|||
|
|
- BAR := 7, 10, 20, 35, 70, 200, 350, 700, 1000
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### I2C connection
|
|||
|
|
|
|||
|
|
| colour | description |
|
|||
|
|
|:--------:|:-------------:|
|
|||
|
|
| RED | 2.7 <20> 5.0V |
|
|||
|
|
| BLACK | GND |
|
|||
|
|
| GREEN | SCL |
|
|||
|
|
| WHITE | SDA |
|
|||
|
|
| YELLOW | NC |
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### Analog version
|
|||
|
|
|
|||
|
|
For Arduino analog output version 3 is also interesting.
|
|||
|
|
It provide 0.5-4.5 volt output which matches many ADC ranges.
|
|||
|
|
|
|||
|
|
White wire is the output (page 4 datasheet).
|
|||
|
|
|
|||
|
|
This version is not supported in the library.
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### Related libraries
|
|||
|
|
|
|||
|
|
This library is related to:
|
|||
|
|
- https://github.com/RobTillaart/Pressure to convert PSI to BAR and back.
|
|||
|
|
|
|||
|
|
|
|||
|
|
## I2C
|
|||
|
|
|
|||
|
|
#### Address
|
|||
|
|
|
|||
|
|
The MSP300 has a fixed address, however there a five different supported.
|
|||
|
|
So without a multiplexer you can have up to 5 transducers on one I2C bus.
|
|||
|
|
The address is in the product number of the sensor you buy. (check datasheet Page 7).
|
|||
|
|
|
|||
|
|
| code | address |
|
|||
|
|
|:----:|:---------:|
|
|||
|
|
| 0 | 0x28 |
|
|||
|
|
| 1 | 0x36 |
|
|||
|
|
| 2 | 0x46 |
|
|||
|
|
| 3 | 0x48 |
|
|||
|
|
| 4 | 0x51 |
|
|||
|
|
|
|||
|
|
#### Speed
|
|||
|
|
|
|||
|
|
The sensor should work at 100 - 400 KHz I2C.
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Interface
|
|||
|
|
|
|||
|
|
The library has a number of functions which are all quite straightforward.
|
|||
|
|
|
|||
|
|
- **MSP300(uint8_t address, TwoWire \*wire = &Wire)** constructor
|
|||
|
|
- **bool begin(uint8_t sda, uint8_t scl, int maxValue)** ESP32 a.o initializing of Wire.
|
|||
|
|
maxValue is the maximum the sensor can read.
|
|||
|
|
This can be either PSI or BAR.
|
|||
|
|
- **bool begin(int maxValue)** for UNO.
|
|||
|
|
maxValue is the maximum the sensor can read.
|
|||
|
|
- **bool isConnected()** See if address set in constructor is on the bus.
|
|||
|
|
- **bool setAddress(const uint8_t deviceAddress)**
|
|||
|
|
- **uint8_t getAddress()**
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### Read
|
|||
|
|
|
|||
|
|
- **uint32_t readPT()** must be called before pressure or temperature can be read.
|
|||
|
|
Returns the raw value which is useful for debugging.
|
|||
|
|
- **float getPressure()** returns the pressure in PSI or BAR (whatever sensor you have).
|
|||
|
|
- **float getTemperature()** returns the temperature in
|
|||
|
|
|
|||
|
|
#### Calibration
|
|||
|
|
|
|||
|
|
- **void setPressureCounts(uint16_t Pmin = 1000, uint16_t Pmax = 15000)** set the count rates.
|
|||
|
|
Use with care.
|
|||
|
|
|
|||
|
|
#### Error handling
|
|||
|
|
|
|||
|
|
- **int lastError();
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Error codes
|
|||
|
|
|
|||
|
|
| define | value |
|
|||
|
|
|:---------------|:-------:|
|
|||
|
|
| MSP300_OK | 0 |
|
|||
|
|
| MSP300_ERROR | 100 |
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Operation
|
|||
|
|
|
|||
|
|
The examples show the basic working of the functions.
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Future
|
|||
|
|
|
|||
|
|
#### must
|
|||
|
|
- improve documentation
|
|||
|
|
- get hardware
|
|||
|
|
- test
|
|||
|
|
|
|||
|
|
#### should
|
|||
|
|
- add examples
|
|||
|
|
- elaborate error handling.
|
|||
|
|
- test I2C performance.
|
|||
|
|
|
|||
|
|
#### could
|
|||
|
|
- unit tests
|
|||
|
|
- add simple class for the analog version
|
|||
|
|
- MSP300A
|
|||
|
|
|
|||
|
|
#### wont
|
|||
|
|
|