ioBroker.esphome

Tests:

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

ESPHome adapter for ioBroker

Control your ESP8266/ESP32 with simple yet powerful configuration files created and managed by ESPHome. Native integration of ESPHome managed device (Including Dashboard) by its native API and ensure all data is synchronised (live-event handling, no data polling ! :)

This adapter uses the esphome-native-api with all credits to @Nafaya to interact with ESPHome API!

Documentation

All our adapter documentation can be found at The DrozmotiX Docu Page

Prerequisites

* NodeJS >= 12.x
* Python >=3.7, <4.0
* API is activated in YAML
* For admin tabs (optional)
    * ESPHome Dashboard IP is provided in instance settings

Activate API in YAML

api:
  password: 'MyPassword'

Example config

Example config, for more examples see The DrozmotiX Docu Page or ESPHome Documentation

Show example config

esphome:
  name: sensor_badkamer
  platform: ESP32
  board: esp-wrover-kit

wifi:
  use_address: 192.168.10.122
  ssid: "xxxxx"
  password: "xxxxxx"
          
# Enable ESPHome API
api:
    password: 'MyPassword'
# Activate i2c bus  
i2c:
  sda: 21
  scl: 22
  scan: True
  id: bus_a
  
# Example configuration for bh1750
sensor:
  - platform: bh1750
    name: "Hal_Illuminance"
    address: 0x23
    measurement_time: 69
    update_interval: 10s
    
# Example configuration for an GPIO output    
output:
  - platform: gpio
    pin: 12
    inverted: true
    id: gpio_12
    
# Example configuration linking a switch to the previous defined output
switch:
  - platform: output
    name: "Generic Output"
    output: 'gpio_12'

Tasmota / ESPEasy migration

Migrating from previous Sonoff Tasmota or ESPEasy setups is very easy. You just need to have ESPHome create a binary for you and then upload that in the web interface.
See for more details our Docu Page

.. note::

Generated yaml files are stored at ```/opt/iobroker/node_modules/iobroker.esphome/config/>device<.yaml```

Support me

If you like my work, please consider a personal donation
(this is an personal Donate link for DutchmanNL, no relation to the ioBroker Project !)

Changelog

0.2.4 (2021-08-24)

(DutchmanNL) Version of ESPHome Dashboard updated to 2021.8
(DutchmanNL) Add option if config of ESPHome device should be shown as states (default = FALSE, safes 8 states for each sensor)

0.2.3 (2021-06-29)

(Jey-Cee) Bugfix : Light component state not changed #74
(DutchmanNL) Update compatibility to version 1.19.4 of ESPHome Dashboard

0.2.2 (2021-06-24)

(DutchmanNL) [!!! Breaking !!!] Make YAML file persistent, backup your configuration before updating ! solves #57
(DutchmanNL) Update ESPHome Dashboard to 1.18.0, requires Python >=3.7 (and ensure <4.0!)
(DutchmanNL) Bugfix : Reconnect to devices without autodiscovery / MDNS-Broadcast in network, solves #66

0.2.1-1 (2021-03-30)

(DutchmanNL) add cover component
(DutchmanNL) add transitionLength for lights

0.2.1-0 (2021-03-30)

(DutchmanNL) Logging improved, solves #48
(DutchmanNL) Name of states changed, solves #49

0.2.0 (2021-03-29)

(DutchmanNL) Translations updated
(DutchmanNL) Configuration page updated
(DutchmanNL) Added to sentry error reporting
(DutchmanNL) Native integration of ESPHome Dashboard added

0.1.5 (2021-03-21)

(DutchmanNL) Add Translations

0.1.4 (2021-03-19)

(DutchmanNL) Implemented RGBW
(DutchmanNL) Ensure correct encryption and storage of passwords
(DutchmanNL) Proper value ranges for type light (255 instead 100)
(DutchmanNL) Implemented hex color state for type light (if RGB is available)

0.1.2 (2021-03-02)

(DutchmanNL) Type Fan added
(DutchmanNL) Type Light added
(DutchmanNL) Error messages optimized
(DutchmanNL) Device reconnect handling improved
(DutchmanNL) [Breaking!] Change state name to default "state" for type BinarySensor / Climate / Sensor / TextSensor & Switch
(DutchmanNL) Autodiscovery improved, non-ESPHome devices excluded

0.1.0 (2021-02-27)

(DutchmanNL) Autodiscovery implemented
(DutchmanNL) Type Climat added
(DutchmanNL) Type TextSensor added
(DutchmanNL) Solved reconnection issues
(DutchmanNL) Optimized error messages for unknown types
(DutchmanNL & @xXBJXx) Adapter configuration page optimized

0.0.1

(DutchmanNL) initial release

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

volkerrichert / iobroker.esphome Goto Github PK