Peter M. Groen / EasyOpenTherm

Commit 5ed6b8b9faf9bd2342e504833977ddde904e3b5c

Authored by Jeroen88
1 parent 0c2590eb

Minor textual changes in README.md

Inline Side-by-side
Showing 1 changed file with 4 additions and 6 deletions
README.md
  View file @5ed6b8b
@@ -24,6 +24,7 @@ Select two free GPIO pins, one to send data to the boiler and one to receive dat @@ -24,6 +24,7 @@ Select two free GPIO pins, one to send data to the boiler and one to receive dat
24 #define OT_TX_PIN (17) 24 #define OT_TX_PIN (17)
25 ``` 25 ```
26 In this case GPIO34 is used for receiving and GPIO17 is used for sending data. Note that the **Rx** pin is connected to the **TxD** pin of the [OpenTherm controller](https://www.tindie.com/products/jeroen88/opentherm-controller/) and vice versa! 26 In this case GPIO34 is used for receiving and GPIO17 is used for sending data. Note that the **Rx** pin is connected to the **TxD** pin of the [OpenTherm controller](https://www.tindie.com/products/jeroen88/opentherm-controller/) and vice versa!
  27 +
27 Create an OpenTherm class instance 28 Create an OpenTherm class instance
28 ```cpp 29 ```cpp
29 OpenTherm thermostat(OT_RX_PIN, OT_TX_PIN); 30 OpenTherm thermostat(OT_RX_PIN, OT_TX_PIN);
@@ -43,10 +44,8 @@ thermostat.write(OpenTherm::WRITE_DATA_ID::CONTROL_SETPOINT_CH, CH_SETPOINT) @@ -43,10 +44,8 @@ thermostat.write(OpenTherm::WRITE_DATA_ID::CONTROL_SETPOINT_CH, CH_SETPOINT)
43 All these functions take an OpenTherm DATA-ID as _first_ parameter. The DATA-ID refers to the action requested from the boiler. All known DATA-ID's are defined in _EasyOpenTherm.h_. The DATA-IDs for reading data from the boiler are defined in ```enum class READ_DATA_ID```, DATA-IDs for writing data to the boiler are defined in ```enum class WRITE_DATA_ID``` and DATA-IDs for writing and reading data to and from the boiler are defined in ```enum class READ_WRITE_DATA_ID```. The _second_ parameter and sometimes _third_ parameter defines the value _written to_ the boiler or _read from_ the boiler. The data types are: 44 All these functions take an OpenTherm DATA-ID as _first_ parameter. The DATA-ID refers to the action requested from the boiler. All known DATA-ID's are defined in _EasyOpenTherm.h_. The DATA-IDs for reading data from the boiler are defined in ```enum class READ_DATA_ID```, DATA-IDs for writing data to the boiler are defined in ```enum class WRITE_DATA_ID``` and DATA-IDs for writing and reading data to and from the boiler are defined in ```enum class READ_WRITE_DATA_ID```. The _second_ parameter and sometimes _third_ parameter defines the value _written to_ the boiler or _read from_ the boiler. The data types are:
44 - uint16_t marked as u16 in the comments 45 - uint16_t marked as u16 in the comments
45 - sint16_t marked as s16 46 - sint16_t marked as s16
46 -- float marked as f8.8 (because actually it is a sint_16 / 256)  
47 -- Two times a uint8_t marked as flag8, u8 or s8. If it is a flag the meaning of bits is defined in an enum class with a name inding in _FLAG, e.g. ```enum class STATUS_FLAGS```  
48 -  
49 -Remember: the thermostat is always the _primary_ device and the boiler always the _secondary_. 47 +- float marked as f8.8 (because actually it is a sint16_t / 256)
  48 +- Two times a uint8_t marked as flag8, u8 or s8. If it is a flag the meaning of bits is defined in an enum class with a name ending in _FLAG, e.g. ```enum class STATUS_FLAGS```
50 49
51 ## Glossary 50 ## Glossary
52 - _primary_: the device issuing the requests, in this context also called _thermostat_ 51 - _primary_: the device issuing the requests, in this context also called _thermostat_
@@ -61,9 +60,8 @@ Remember: the thermostat is always the _primary_ device and the boiler always th @@ -61,9 +60,8 @@ Remember: the thermostat is always the _primary_ device and the boiler always th
61 - _flow_: water leaving the boiler 60 - _flow_: water leaving the boiler
62 - _return_: water returning to the boiler 61 - _return_: water returning to the boiler
63 62
64 -  
65 ## License 63 ## License
66 -© 2022 Jeroen Döll, licensed under the [GNU General Public License](https://www.gnu.org/licenses/gpl-3.0.html). Enjoy using the library, feedback is wellcome! 64 +© 2022 Jeroen Döll, licensed under the [GNU General Public License](https://www.gnu.org/licenses/gpl-3.0.html). Enjoy using the library, feedback is welcome!
67 65
68 66
69 67