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 – 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
|
||
|