Skip to content

Commit b618654

Browse files
authored
update readme.md (#6)
- update readme.md - fix keywords.txt - minor edits
1 parent 12a717d commit b618654

File tree

8 files changed

+62
-26
lines changed

8 files changed

+62
-26
lines changed

CHANGELOG.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,16 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
66
and this project adheres to [Semantic Versioning](http://semver.org/).
77

88

9+
## [0.1.3] - 2023-11-11
10+
- update readme.md
11+
- fix keywords.txt
12+
- minor edits
13+
14+
915
## [0.1.2] - 2022-11-16
1016
- add RP2040 in build-CI
1117
- add changelog.md
1218

13-
1419
## [0.1.1] - 2022-04-20
1520
- updated documentation after tests with UNO.
1621
- added examples

MAX6675.cpp

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,10 @@
11
//
22
// FILE: MAX6675.cpp
33
// AUTHOR: Rob Tillaart
4-
// VERSION: 0.1.2
4+
// VERSION: 0.1.3
55
// PURPOSE: Arduino library for MAX6675 chip for K type thermocouple
66
// DATE: 2022-01-11
77
// URL: https://github.com/RobTillaart/MAX6675
8-
//
9-
// HISTORY: see changelog.md
108

119

1210
#include "MAX6675.h"
@@ -106,7 +104,7 @@ uint8_t MAX6675::read()
106104
// 15 SIGN
107105
uint16_t value = _read();
108106

109-
// needs a pull up on MISO pin to work properly!
107+
// needs a pull up on MISO pin to work properly!
110108
if (value == 0xFFFF)
111109
{
112110
_status = STATUS_NO_COMMUNICATION;
@@ -146,7 +144,7 @@ uint32_t MAX6675::_read(void)
146144
{
147145
// split _swSPIdelay in equal dLow and dHigh
148146
// dLow should be longer one when _swSPIdelay = odd.
149-
uint16_t dHigh = _swSPIdelay/2;
147+
uint16_t dHigh = _swSPIdelay / 2;
150148
uint16_t dLow = _swSPIdelay - dHigh;
151149
digitalWrite(_select, LOW);
152150
for (int8_t i = 15; i >= 0; i--)
@@ -165,5 +163,5 @@ uint32_t MAX6675::_read(void)
165163
}
166164

167165

168-
// -- END OF FILE --
166+
// -- END OF FILE --
169167

MAX6675.h

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
//
33
// FILE: MAX6675.h
44
// AUTHOR: Rob Tillaart
5-
// VERSION: 0.1.2
5+
// VERSION: 0.1.3
66
// PURPOSE: Arduino library for MAX6675 chip for K type thermocouple
77
// DATE: 2022-01-12
88
// URL: https://github.com/RobTillaart/MAX6675
@@ -23,7 +23,7 @@
2323
#include "SPI.h"
2424

2525

26-
#define MAX6675_LIB_VERSION (F("0.1.2"))
26+
#define MAX6675_LIB_VERSION (F("0.1.3"))
2727

2828
#define MAX6675_NO_TEMPERATURE -999
2929

@@ -109,5 +109,5 @@ class MAX6675
109109
};
110110

111111

112-
// -- END OF FILE --
112+
// -- END OF FILE --
113113

README.md

Lines changed: 43 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,11 @@
22
[![Arduino CI](https://github.com/RobTillaart/MAX6675/workflows/Arduino%20CI/badge.svg)](https://github.com/marketplace/actions/arduino_ci)
33
[![Arduino-lint](https://github.com/RobTillaart/MAX6675/actions/workflows/arduino-lint.yml/badge.svg)](https://github.com/RobTillaart/MAX6675/actions/workflows/arduino-lint.yml)
44
[![JSON check](https://github.com/RobTillaart/MAX6675/actions/workflows/jsoncheck.yml/badge.svg)](https://github.com/RobTillaart/MAX6675/actions/workflows/jsoncheck.yml)
5+
[![GitHub issues](https://img.shields.io/github/issues/RobTillaart/MAX6675.svg)](https://github.com/RobTillaart/MAX6675/issues)
6+
57
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/RobTillaart/MAX6675/blob/master/LICENSE)
68
[![GitHub release](https://img.shields.io/github/release/RobTillaart/MAX6675.svg?maxAge=3600)](https://github.com/RobTillaart/MAX6675/releases)
9+
[![PlatformIO Registry](https://badges.registry.platformio.org/packages/robtillaart/library/MAX6675.svg)](https://registry.platformio.org/libraries/robtillaart/MAX6675)
710

811

912
# MAX6675
@@ -31,7 +34,7 @@ Different TC's have a different Seebeck Coefficient (SC) expressed in µV/°C.
3134
See http://www.analog.com/library/analogDialogue/archives/44-10/thermocouple.html
3235

3336

34-
### Breakout
37+
#### Breakout
3538

3639
The library is tested with a breakout board with following pins:
3740

@@ -45,11 +48,17 @@ The library is tested with a breakout board with following pins:
4548
+---------------------+
4649
```
4750

51+
#### Related
52+
53+
- https://github.com/RobTillaart/MAX6675
54+
- https://github.com/RobTillaart/MAX31850
55+
- https://github.com/RobTillaart/MAX31855_RT
56+
4857

4958
## Hardware SPI vs software SPI
5059

5160

52-
### Pins
61+
#### Pins
5362

5463
Default pin connections. ESP32 can overrule with **setGPIOpins()**.
5564

@@ -61,7 +70,7 @@ Default pin connections. ESP32 can overrule with **setGPIOpins()**.
6170
| SELECT | eg. 4 | 5 | 15 | *can be others too.*
6271

6372

64-
### Performance
73+
#### Performance
6574

6675
Performance read() function, timing in us.
6776
- UNO @ 16 MHz
@@ -86,16 +95,19 @@ Tested with **MAX6675_test_HWSPI.ino**
8695

8796
## Interface
8897

98+
```cpp
99+
#include "MAX6675.h"
100+
```
89101

90-
### Constructor
102+
#### Constructor
91103

92104
- **MAX6675()** create object.
93105
- **void begin(const uint8_t select)** set select pin => hardware SPI
94106
- **void begin(const uint8_t sclk, const uint8_t select, const uint8_t miso)**
95107
set CLOCK, SELECT and MISO pin => software SPI
96108

97109

98-
### Hardware SPI
110+
#### Hardware SPI
99111

100112
To be used only if one needs a specific speed.
101113

@@ -106,7 +118,7 @@ Del is the time in micros added per bit. Even numbers keep the duty cycle of the
106118
- **uint16_t getSWSPIdelay()** get set value in micros.
107119

108120

109-
### ESP32 specific
121+
#### ESP32 specific
110122

111123
- **void selectHSPI()** must be called before **begin()**
112124
- **void selectVSPI()** must be called before **begin()**
@@ -115,7 +127,7 @@ Del is the time in micros added per bit. Even numbers keep the duty cycle of the
115127
- **void setGPIOpins(uint8_t clk, uint8_t miso, uint8_t mosi, uint8_t select)** to overrule ESP32 default hardware pins.
116128

117129

118-
### Reading
130+
#### Reading
119131

120132
To make a temperature reading call **read()**.
121133
It returns the status of the read which is a value between 0..7
@@ -141,7 +153,7 @@ the value of **getTemperature()** can become incorrect. So it is important to ch
141153
the return value of **read()**.
142154

143155

144-
### Offset
156+
#### Offset
145157

146158
The library supports a fixed offset to calibrate the thermocouple.
147159
For this the functions **float getOffset()** and **void setOffset(float offset)** are available.
@@ -153,7 +165,7 @@ A typical usage is to call **setOffset(273.15)** to get ° Kelvin.
153165
- the offset can cause negative temperatures.
154166

155167

156-
### Delta analysis
168+
#### Delta analysis
157169

158170
As the **tc** object holds its last known temperature it is easy to determine the delta
159171
with the last known temperature, e.g. for trend analysis.
@@ -170,7 +182,7 @@ with the last known temperature, e.g. for trend analysis.
170182
```
171183
172184
173-
### Last time read
185+
#### Last time read
174186
175187
The **tc** object keeps track of the last time **read()** is called in the function **uint32_t lastRead()**.
176188
The time is tracked in **millis()**. This makes it easy to read the sensor at certain intervals.
@@ -192,7 +204,7 @@ if (millis() - tc.lastRead() >= interval)
192204
```
193205

194206

195-
### GetRawData
207+
#### GetRawData
196208

197209
The function **uint32_t getRawData()** allows you to get all the 32 bits raw data from the board,
198210
after the standard **uint8_t tc.read()** call.
@@ -249,7 +261,26 @@ See examples
249261

250262
## Future
251263

264+
#### Must
265+
266+
#### Should
267+
252268
- update and verify documentation (as it is copied from MAX31855 lib)
253269
- keep interface in sync with MAX31855 if possible.
254-
-
270+
271+
#### Could
272+
273+
- create example to distinguish between MAX6675 and MAX31855
274+
- https://github.com/RobTillaart/MAX6675/issues/5
275+
276+
#### Wont
277+
278+
279+
## Support
280+
281+
If you appreciate my libraries, you can support the development and maintenance.
282+
Improve the quality of the libraries by providing issues and Pull Requests, or
283+
donate through PayPal or GitHub sponsors.
284+
285+
Thank you,
255286

documents/Capture.PNG

28.7 KB
Loading

keywords.txt

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,9 @@ setGPIOpins KEYWORD2
3535

3636

3737
# Constants (LITERAL1)
38-
MAX31855_VERSION LITERAL1
38+
MAX6675_LIB_VERSION LITERAL1
39+
40+
MAX6675_NO_TEMPERATURE LITERAL1
3941

4042
STATUS_OK LITERAL1
4143
STATUS_ERROR LITERAL1

library.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@
1515
"type": "git",
1616
"url": "https://github.com/RobTillaart/MAX6675"
1717
},
18-
"version": "0.1.2",
18+
"version": "0.1.3",
1919
"license": "MIT",
20-
"frameworks": "arduino",
20+
"frameworks": "*",
2121
"platforms": "*",
2222
"headers": "MAX6675.h"
2323
}

library.properties

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name=MAX6675
2-
version=0.1.2
2+
version=0.1.3
33
author=Rob Tillaart <rob.tillaart@gmail.com>
44
maintainer=Rob Tillaart <rob.tillaart@gmail.com>
55
sentence=Arduino library for MAX6675 chip for K type thermocouple.

0 commit comments

Comments
 (0)