Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zarusz/esp_thing
Baseline IoT thing implementation for ESP8266 chip
https://github.com/zarusz/esp_thing
arduino esp8266 esp8266-arduino iot openhab smart-home
Last synced: about 6 hours ago
JSON representation
Baseline IoT thing implementation for ESP8266 chip
- Host: GitHub
- URL: https://github.com/zarusz/esp_thing
- Owner: zarusz
- License: apache-2.0
- Created: 2019-12-26T11:14:06.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-30T07:57:26.000Z (about 5 years ago)
- Last Synced: 2024-11-10T21:42:57.537Z (about 2 months ago)
- Topics: arduino, esp8266, esp8266-arduino, iot, openhab, smart-home
- Language: C++
- Size: 74.5 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.com/zarusz/ESP_Thing)
# What is ESP_Thing?
It is meant for makers of IoT things. It is a basline implementation (C++) targeting the ESP8266 chip (Arduino Espressif8266 Framework).
The implementation out of the box supports basic sensors and actuators (DHT-22 Himidity & Temperature sensors, LEDs, RGB LED strips, relays/switches), with ability to extend.
Communcation with the device ESP_Thing device is established using the MQTT protocol over WiFi.
It can be easily connected with Smart Home platform [openHAB](https://www.openhab.org/) using the [MQTT addon](https://www.openhab.org/addons/bindings/mqtt/). Since MQTT is platform agnostic it could work with other smart home platforms (HomeKit).
# History
When doing my smart home I needed to build multiple custom hardware things running on ESP8266 and integrate that into the openHAB platform. Some of those devices are Switches running the ESP_Thing software (instead of the stock firmware).
This has been running succesfully for several years now.
# Using
Use [Visual Studio Code](https://code.visualstudio.com/) with the [Platform IO IDE extension](https://marketplace.visualstudio.com/items?itemName=platformio.platformio-ide).
To build simply do `Platform IO > Project Tasks > Build`.
As a result of compilation you get the `firmware.bin` file that can be used to flash the ESP8266 device.
```
Linking .pio\build\esp12e\firmware.elf
Building .pio\build\esp12e\firmware.bin
Retrieving maximum program size .pio\build\esp12e\firmware.elf
Checking size .pio\build\esp12e\firmware.elf
Advanced Memory Usage is available via "PlatformIO Home > Project Inspect"
DATA: [==== ] 43.5% (used 35640 bytes from 81920 bytes)
PROGRAM: [==== ] 37.2% (used 388644 bytes from 1044464 bytes)
```
Alternatively, you can use the Over the Air Updates (OTA) to push never firmware updates.
# Features
* Smart Config
* With first run (or after a push button is pressed and hold during boot) the device enter config mode.
* It starts an open WiFi network you can join to from your mobile phone.
* It displays a configuration website where you can enter basic settings (WiFi name & pass, device name).
* This uses the WiFiManager library.
* Over the Air Updates (OTA)
* You can send a command to the device with a URL from which it should download the latest firmware from (bin file).
* Deep sleep mode support (to lower energy usage)
* In `MainApp.cpp` compose what pins are used (ideally in the future this will be configured):
```cpp
if (_deviceConfig->UniqueId.startsWith("sonoff_") || _deviceConfig->UniqueId.startsWith("switch_")) {
// Sonoff
/*
12 - Connected to RST (deep sleep)
00 - push button, 0 - pressed, 1 - released
*/
pushButton->SetPin(0);
auto sw = new SwitchFeatureController(10, this, 12, true);
_features.push_back(sw);
_features.push_back(new PushButtonFeatureController(0, this, pushButton, sw));
} else if (_deviceConfig->UniqueId.startsWith("sonoff-dual_") || _deviceConfig->UniqueId.startsWith("switch-dual_")) {
// Sonoff Dual R2
/*
05 - Switch 1
12 - Switch 2
10 - push button, 0 - pressed, 1 - released
13 - blue LED
03 (RX) - DHT22
*/
Serial.end();
pushButton->SetPin(10);
statusLed->SetPin(13);
auto sw = new SwitchFeatureController(10, this, 5, true);
_features.push_back(sw);
_features.push_back(new PushButtonFeatureController(0, this, pushButton, sw));
_features.push_back(new SwitchFeatureController(11, this, 12, true));
_features.push_back(new TempFeatureController(30, 31, this, 3));
}
}
```