mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
256 lines
8.2 KiB
Markdown
256 lines
8.2 KiB
Markdown
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
|
[](https://github.com/RobTillaart/MAX6675/actions/workflows/arduino-lint.yml)
|
|
[](https://github.com/RobTillaart/MAX6675/actions/workflows/jsoncheck.yml)
|
|
[](https://github.com/RobTillaart/MAX6675/blob/master/LICENSE)
|
|
[](https://github.com/RobTillaart/MAX6675/releases)
|
|
|
|
|
|
# MAX6675
|
|
|
|
Max6675 is an Arduino library for MAX6675 chip with a K type thermocouple.
|
|
|
|
The library is based upon (stripped and adapted version of) the https://github.com/RobTillaart/MAX31855_RT library.
|
|
|
|
Currently the library is experimental, so use with care.
|
|
|
|
Hardware has finally arrived (April 2022) and I had time to do my first round of tests with an UNO @ 16 MHz.
|
|
The library works and it reads temperatures well, both with HW SPI and SW SPI.
|
|
|
|
|
|
## Description
|
|
|
|
The MAX6675 is a chip to convert the reading of a K-type thermocouple to a temperature.
|
|
The MAX6675 only supports positive degrees Celsius.
|
|
|
|
The values are read with an precision of **0.25°C.**
|
|
Typical noise seen during usage are **± 0.5°C**, so using a low pass filter on the temperature might be a good idea.
|
|
|
|
The working of thermocouples (TC) is based upon Seebeck effect.
|
|
Different TC's have a different Seebeck Coefficient (SC) expressed in µV/°C.
|
|
See http://www.analog.com/library/analogDialogue/archives/44-10/thermocouple.html
|
|
|
|
|
|
### Breakout
|
|
|
|
The library is tested with a breakout board with following pins:
|
|
|
|
```
|
|
+---------------------+
|
|
| signal out | --> MISO
|
|
| - chip select | <-- SELECT
|
|
TC here | clock | <-- CLOCK processor side
|
|
| + VCC | --- VCC
|
|
| GND | --- GND
|
|
+---------------------+
|
|
```
|
|
|
|
|
|
## Hardware SPI vs software SPI
|
|
|
|
|
|
### Pins
|
|
|
|
Default pin connections. ESP32 can overrule with **setGPIOpins()**.
|
|
|
|
| HW SPI | UNO | ESP32 VSPI | ESP32 HSPI | Notes
|
|
|:---------|:-----:|:-----------:|:-----------:|:----------|
|
|
| CLOCK | 13 | 18 | 14 |
|
|
| MISO | 12 | 19 | 12 |
|
|
| MOSI | 11 | 23 | 13 | *not used...*
|
|
| SELECT | eg. 4 | 5 | 15 | *can be others too.*
|
|
|
|
|
|
### Performance
|
|
|
|
Performance read() function, timing in us.
|
|
- UNO @ 16 MHz
|
|
- TODO ESP32 @ 240 MHz
|
|
|
|
| mode | clock | timing UNO | timing ESP32 | Notes
|
|
|:-------|---------:|-----------:|-------------:|:----------|
|
|
| HW SPI | 4000000 | 36 | | highest supported.
|
|
| HW SPI | 3500000 | 40 | |
|
|
| HW SPI | 3000000 | 40 | |
|
|
| HW SPI | 2500000 | 40 | |
|
|
| HW SPI | 2000000 | 40-44 | |
|
|
| HW SPI | 1500000 | 48 | |
|
|
| HW SPI | 1000000 | 48-52 | |
|
|
| HW SPI | 500000 | 64-68 | |
|
|
| SW SPI | bit bang | 276 | |
|
|
|
|
Note the UNO micros() has a 4 us precision, but it is clear that
|
|
4 Mb is not even twice the speed of 0.5 Mb.
|
|
Tested with **MAX6675_test_HWSPI.ino**
|
|
|
|
|
|
## Interface
|
|
|
|
|
|
### Constructor
|
|
|
|
- **MAX6675()** create object.
|
|
- **void begin(const uint8_t select)** set select pin => hardware SPI
|
|
- **void begin(const uint8_t sclk, const uint8_t select, const uint8_t miso)**
|
|
set CLOCK, SELECT and MISO pin => software SPI
|
|
|
|
|
|
### Hardware SPI
|
|
|
|
To be used only if one needs a specific speed.
|
|
|
|
- **void setSPIspeed(uint32_t speed)** set SPI transfer rate.
|
|
- **uint32_t getSPIspeed()** returns SPI transfer rate.
|
|
- **void setSWSPIdelay(uint16_t del = 0)** for tuning SW SPI signal quality.
|
|
Del is the time in micros added per bit. Even numbers keep the duty cycle of the clock around 50%.
|
|
- **uint16_t getSWSPIdelay()** get set value in micros.
|
|
|
|
|
|
### ESP32 specific
|
|
|
|
- **void selectHSPI()** must be called before **begin()**
|
|
- **void selectVSPI()** must be called before **begin()**
|
|
- **bool usesHSPI()**
|
|
- **bool usesVSPI()**
|
|
- **void setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select)** to overrule ESP32 default hardware pins.
|
|
|
|
|
|
### Reading
|
|
|
|
To make a temperature reading call **read()**.
|
|
It returns the status of the read which is a value between 0..7
|
|
The function **getStatus()** returns the same status value.
|
|
|
|
Table: values returned from **uint8_t read()** and **uint8_t getStatus()**
|
|
|
|
Note: this list is a subset of MAX31855 errors.
|
|
|
|
| value | Description | Action |
|
|
|:-----:|:--------------------------|:-------------|
|
|
| 0 | OK | |
|
|
| 4 | Thermocouple short to VCC | check wiring |
|
|
| 128 | No read done yet | check wiring |
|
|
| 129 | No communication | check wiring |
|
|
|
|
|
|
After a **uint8_t read()** you can get the temperature with **float getTemperature()**.
|
|
|
|
Repeated calls to **getTemperature()** will give the same value until a new **read()**.
|
|
The latter fetches a new value from the sensor. Note that if the **read()** fails
|
|
the value of **getTemperature()** can become incorrect. So it is important to check
|
|
the return value of **read()**.
|
|
|
|
|
|
### Offset
|
|
|
|
The library supports a fixed offset to calibrate the thermocouple.
|
|
For this the functions **float getOffset()** and **void setOffset(float offset)** are available.
|
|
This offset is "added" in the **getTemperature()** function.
|
|
|
|
Notes
|
|
- the offset used is a float, so decimals can be used.
|
|
A typical usage is to call **setOffset(273.15)** to get ° Kelvin.
|
|
- the offset can cause negative temperatures.
|
|
|
|
|
|
### Delta analysis
|
|
|
|
As the **tc** object holds its last known temperature it is easy to determine the delta
|
|
with the last known temperature, e.g. for trend analysis.
|
|
|
|
```cpp
|
|
float last = tc.getTemperature();
|
|
int state = tc.read();
|
|
if (state == STATUS_OK)
|
|
{
|
|
float new = tc.getTemperature();
|
|
float delta = new - last;
|
|
// process data
|
|
}
|
|
```
|
|
|
|
|
|
### Last time read
|
|
|
|
The **tc** object keeps track of the last time **read()** is called in the function **uint32_t lastRead()**.
|
|
The time is tracked in **millis()**. This makes it easy to read the sensor at certain intervals.
|
|
|
|
```cpp
|
|
if (millis() - tc.lastRead() >= interval)
|
|
{
|
|
int state = tc.read();
|
|
if (state == STATUS_OK)
|
|
{
|
|
float new = tc.getTemperature();
|
|
// process read value.
|
|
}
|
|
else
|
|
{
|
|
// handle error
|
|
}
|
|
}
|
|
```
|
|
|
|
|
|
### GetRawData
|
|
|
|
The function **uint32_t getRawData()** allows you to get all the 32 bits raw data from the board,
|
|
after the standard **uint8_t tc.read()** call.
|
|
|
|
Example code can be found in the examples folder.
|
|
|
|
```cpp
|
|
int state = thermocouple.read();
|
|
uint32_t value = thermocouple.getRawData(); // Read the raw Data value from the module
|
|
```
|
|
|
|
This allows one to compact the measurement e.g. for storage or sending over a network.
|
|
|
|
|
|
## Pull Up Resistor
|
|
|
|
To have proper working of the MAX6675 board, you need to add a pull-up resistor
|
|
(e.g. 4K7 - 1K depending on wire length) between the MISO pin (from constructor call) and the
|
|
VCC (5 Volt). This improves the signal quality and will allow you to detect if there is
|
|
proper communication with the board. Without pull-up one might get random noise that could
|
|
look like real data.
|
|
|
|
**Note:** the MISO pin can be different from each board, please refer to your board datasheet.
|
|
|
|
If the MAX6675 board is not connected **tc.read()** will return **STATUS_NO_COMMUNICATION**.
|
|
|
|
You can verify this by **tc.getRawData()** which will give 16 HIGH bits or 0xFFFF).
|
|
|
|
You can use a simple code to detect connection error board:
|
|
|
|
```cpp
|
|
uint8_t status = thermocouple.read();
|
|
if (status == STATUS_NO_COMMUNICATION)
|
|
{
|
|
Serial.println("NO COMMUNICATION");
|
|
}
|
|
```
|
|
|
|
or
|
|
|
|
```cpp
|
|
uint8_t status = thermocouple.read();
|
|
if (thermocouple.getRawData() == 0xFFFF)
|
|
{
|
|
Serial.println("NO COMMUNICATION");
|
|
}
|
|
```
|
|
|
|
|
|
## Operation
|
|
|
|
See examples
|
|
|
|
|
|
## Future
|
|
|
|
- update and verify documentation (as it is copied from MAX31855 lib)
|
|
- keep interface in sync with MAX31855 if possible.
|
|
-
|
|
|