ESP8266-termostat/README.md

# ESP8266 - Termostat

![ESP8266 Termostat](https://git.microlab.space/pixx/ESP8266-termostat/raw/branch/master/imgs/termostat.jpg)

Jedná se o termostat postavený na **ESP8266** s možností připojení na Wi-Fi.

Díky Wi-Fi konektivitě lze termostat ovládat pomocí jakéhokoli jiného zařízení a také lze z termostatu exportovat metriky.
Termostat nemusí sloužit pouze k regulaci kotle, ale i jako teplotní čidlo exportující své metriky.
Toto lze nastavit v configu.

**ToDo list:**
- [ ] Zabezpečení (API + JS app)
	- [ ] API
	- [ ] JS app
	- [ ] OTA update
- [x] API
- [x] JS app
	- [x] v flash paměti
	- [ ] aktualizace
- [x] OTA update
- [x] Wi-Fi konektivita
- [x] Metric export

## Hardware

Bylo zvoleno **ESP-01**. Tento model ESP má vyvedeny 2 GPIO piny.

Termostat obsahuje teplotní čidlo **DS18B20**, právě kvůli sběrnici OneWire, na kterou lze připojit více čidel.

Ke spínání kotle byl zvolen **relay modul**, který by bylo vhodné do budoucna nahradit nějakým polovodičem, aby termostat necvakal. Případně při návrhu boardu navrhnout osazení jak relé, tak nějakého polovodiče, který by sloužil ke spínání kotle (volba jumprem).

Termostat je napájen 230v, obsahuje **trafo** z 230v AC na 3.3v DC.

## Config

Před nahráváním programu odmažte příponu `.example` z názvu souboru `config.h.example`

	mv config.h.example config.h

Termostat může běžet ve dvou režimech, toto se dá nastavit před kompilací pomocí přepínače `THERMOSTAT` v `config.h`.

V případě, že je `THERMOSTAT` nastaveno na `0`, tak  termostat pouze odpovídá na teplotu a stav relátka pomocí API dotazu, stav relátka lze dotazem na API změnit.

V připadě, že je `THERMOSTAT` nastaveno na `1`, tak termostat odpovídá na všechny API dotazy, ale nelze stav relátka libovolně změnit (ovládání relátka je v režii termostatu)

	#define STASSID "SSID"		<- SSID sítě, ke které se má termostat připojit
	#define STAPSK  "heslo"		<- heslo k síti, ke které se má termostat připojit

	#define DS18B20_PIN 0		<- Číslo pinu, ke kterému je připojeno teplotní čidlo
	#define RELAY_PIN 2			<- Číslo pinu, ke kterému je připojeno relé

	#define METRICS_EXPORT 1	<- nastavení zda má čislo exportovat metriky (/metrics)
	#define THERMOSTAT 1		<- nastavení režimu fungování viz. výše

	#define CORRECTION 0		<- nastavení korekce teploty

## HTTP API

Zde se „exportují“ metriky pro import do TSDB [Prometheus](https://prometheus.io/):

	http://<ip_address>/metrics

### Získání aktuálních hodnot:

**Aktuální teplota** - vrací aktuální teplotu (float)

	http://<ip_address>/get?temp

**Požadovaná teplota** - vrací nastavenou teplotu (float), pouze pokud je nastavení `THERMOSTAT 1`

	http://<ip_address>/get?reqtemp

**Rozmezí spínání** - vrací v jakém rozmezí termostat spíná ± (float), pouze pokud je nastavení `THERMOSTAT 1`

	http://<ip_address>/get?relay

**Stav relé** - vrací stav relé (boolean)

	http://<ip_address>/get?relay

### Nastavení hodnot:

**Zvětšení požadované teploty** - vrací požadovanou teplotu, požaduje float číslo, funguje pouze pokud je nastavení `THERMOSTAT 1`

	http://<ip_address>/set?increasereqtemp=0.1

**Zmenšení požadované teploty** - vrací požadovanou teplotu, požaduje float číslo, funguje pouze pokud je nastavení `THERMOSTAT 1`

	http://<ip_address>/set?decreasereqtemp=0.1

**Zvětšení rozmení teplot** - vrací požadované rozmezí, požaduje float číslo, funguje pouze pokud je nastavení `THERMOSTAT 1`

	http://<ip_address>/set?increaseoffset=0.1

**Zmenšení rozmení teplot** - vrací požadované rozmezí, požaduje float číslo, funguje pouze pokud je nastavení `THERMOSTAT 1`

	http://<ip_address>/set?decreaseoffset=0.1

**Nastavení stavu relé** - vrací potvrzení o nastavení, požaduje boolean (0/1), funguje pouze pokud je nastavení `THERMOSTAT 0`

	http://<ip_address>/set?relay=0