From cb8c235bb5409759c20e7bb8386814b379ddf436 Mon Sep 17 00:00:00 2001 From: esphomebot Date: Tue, 28 Jul 2020 20:27:27 +0000 Subject: [PATCH] :tada: Release of add-on ESPHome (beta) 1.15.0b2 --- README.md | 25 +++++++++ esphome/CHANGELOG.md | 1 + esphome/README.md | 122 +++++++++++++++++++++++++++++++++++++++++++ esphome/config.json | 47 +++++++++++++++++ esphome/icon.png | Bin 0 -> 2448 bytes esphome/logo.png | Bin 0 -> 16889 bytes 6 files changed, 195 insertions(+) create mode 100644 esphome/CHANGELOG.md create mode 100644 esphome/README.md create mode 100644 esphome/config.json create mode 100644 esphome/icon.png create mode 100644 esphome/logo.png diff --git a/README.md b/README.md index 216f3fc6..9a977e4c 100644 --- a/README.md +++ b/README.md @@ -138,6 +138,20 @@ Simple & Free Wiki Software [:books: Bookstack add-on documentation][addon-doc-bookstack] +### ✓ [ESPHome (beta)][addon-esphome] + +![Latest Version][esphome-version-shield] +![Supports armhf Architecture][esphome-armhf-shield] +![Supports armv7 Architecture][esphome-armv7-shield] +![Supports aarch64 Architecture][esphome-aarch64-shield] +![Supports amd64 Architecture][esphome-amd64-shield] +![Supports i386 Architecture][esphome-i386-shield] +![Docker Pulls][esphome-pulls-shield] + +Beta version of ESPHome Hass.io add-on. + +[:books: ESPHome (beta) add-on documentation][addon-doc-esphome] + ### ✓ [Example][addon-example] ![Latest Version][example-version-shield] @@ -692,6 +706,7 @@ on the correct GitHub repository matching the add-on. - [Open an issue for the add-on: AppDaemon 4][appdaemon-issue] - [Open an issue for the add-on: Bitwarden RS][bitwarden-issue] - [Open an issue for the add-on: Bookstack][bookstack-issue] +- [Open an issue for the add-on: ESPHome (beta)][esphome-issue] - [Open an issue for the add-on: Example][example-issue] - [Open an issue for the add-on: FTP][ftp-issue] - [Open an issue for the add-on: FlexTV][phlex-issue] @@ -846,6 +861,16 @@ SOFTWARE. [bookstack-armhf-shield]: https://img.shields.io/badge/armhf-yes-green.svg [bookstack-armv7-shield]: https://img.shields.io/badge/armv7-yes-green.svg [bookstack-i386-shield]: https://img.shields.io/badge/i386-yes-green.svg +[addon-esphome]: https://github.com/esphome/hassio/tree/1.15.0b2 +[addon-doc-esphome]: https://github.com/esphome/hassio/blob/1.15.0b2/README.md +[esphome-issue]: https://github.com/esphome/hassio/issues +[esphome-version-shield]: https://img.shields.io/badge/version-1.15.0b2-blue.svg +[esphome-pulls-shield]: https://img.shields.io/docker/pulls/esphome/esphome-hassio-amd64.svg +[esphome-aarch64-shield]: https://img.shields.io/badge/aarch64-yes-green.svg +[esphome-amd64-shield]: https://img.shields.io/badge/amd64-yes-green.svg +[esphome-armhf-shield]: https://img.shields.io/badge/armhf-no-red.svg +[esphome-armv7-shield]: https://img.shields.io/badge/armv7-yes-green.svg +[esphome-i386-shield]: https://img.shields.io/badge/i386-no-red.svg [addon-example]: https://github.com/hassio-addons/addon-example/tree/v3.4.0 [addon-doc-example]: https://github.com/hassio-addons/addon-example/blob/v3.4.0/README.md [example-issue]: https://github.com/hassio-addons/addon-example/issues diff --git a/esphome/CHANGELOG.md b/esphome/CHANGELOG.md new file mode 100644 index 00000000..f4be3be7 --- /dev/null +++ b/esphome/CHANGELOG.md @@ -0,0 +1 @@ +See https://beta.esphome.io/changelog/v1.15.0.html \ No newline at end of file diff --git a/esphome/README.md b/esphome/README.md new file mode 100644 index 00000000..c4862da9 --- /dev/null +++ b/esphome/README.md @@ -0,0 +1,122 @@ +# ESPHome Home Assistant Add-On + +[![ESPHome logo](https://raw.githubusercontent.com/esphome/hassio/master/esphome-dev/logo.png)](https://esphome.io/) + +[![GitHub stars](https://img.shields.io/github/stars/esphome/esphome.svg?style=social&label=Star&maxAge=2592000)](https://github.com/esphome/esphome) +[![GitHub Release][releases-shield]][releases] +[![Discord][discord-shield]][discord] + +## About + +This add-on allows you to manage and program your ESP8266 and ESP32 based microcontrollers +directly through Home Assistant **with no programming experience required**. All you need to do +is write YAML configuration files; the rest (over-the-air updates, compiling) is all +handled by ESPHome. + +

+ +

+ +[View the ESPHome documentation](https://esphome.io/) + +## Example + +With ESPHome, you can go from a few lines of YAML straight to a custom-made +firmware. For example, to include a [DHT22][dht22]. +temperature and humidity sensor, you just need to include 8 lines of YAML +in your configuration file: + + + +Then just click UPLOAD and the sensor will magically appear in Home Assistant: + + + +## Installation + +To install this Home Assistant add-on you need to add the ESPHome add-on repository +first: + +1. Add the ESPHome add-ons repository to your Home Assistant instance. You can do this by navigating to the "Add-on store" tab in the Supervisor panel and then entering https://github.com/esphome/hassio in the "Add repository" field after selecting "Repositories" from the top-right menu. +2. Now scroll down and select the "ESPHome" add-on. +3. Press install to download the add-on and unpack it on your machine. This can take some time. +4. Optional: If you're using SSL/TLS certificates and want to encrypt your communication to this add-on, please enter `true` into the `ssl` field and set the `fullchain` and `certfile` options accordingly. +5. Start the add-on, check the logs of the add-on to see if everything went well. +6. Click "OPEN WEB UI" to open the ESPHome dashboard. You will be asked for your Home Assistant credentials - ESPHome uses Home Assistant's authentication system to log you in. + +You can view the ESPHome documentation at https://esphome.io/ + +## Configuration + +**Note**: _Remember to restart the add-on when the configuration is changed._ + +Example add-on configuration: + +```json +{ + "ssl": false, + "certfile": "fullchain.pem", + "keyfile": "privkey.pem" +} +``` + +### Option: `ssl` + +Enables or disables encrypted SSL/TLS (HTTPS) connections to the web server of this add-on. +Set it to `true` to encrypt communications, `false` otherwise. +Please note that if you set this to `true` you must also generate the key and certificate +files for encryption. For example using [Let's Encrypt](https://www.home-assistant.io/addons/lets_encrypt/) +or [Self-signed certificates](https://www.home-assistant.io/docs/ecosystem/certificates/tls_self_signed_certificate/). + +### Option: `certfile` + +The certificate file to use for SSL. If this file doesn't exist, the add-on start will fail. + +**Note**: The file MUST be stored in `/ssl/`, which is the default for Home Assistant + +### Option: `keyfile` + +The private key file to use for SSL. If this file doesn't exist, the add-on start will fail. + +**Note**: The file MUST be stored in `/ssl/`, which is the default for Home Assistant + +### Option: `leave_front_door_open` + +Adding this option to the add-on configuration allows you to disable +authentication by setting it to `true`. + +### Option: `esphome_version` + +Manually override which ESPHome version to use in the add-on. +For example to install the latest development version, use `"esphome_version": "dev"`, +or for version 1.14.0: `"esphome_version": "v1.14.0""`. + +Please note that this does not always work and is only meant for testing, usually the +ESPHome add-on and dashboard version must match to guarantee a working system. + +### Option: `relative_url` + +Host the ESPHome dashboard under a relative URL, so that it can be integrated +into existing web proxies like NGINX under a relative URL. Defaults to `/`. + +### Option: `status_use_ping` + +By default the dashboard uses mDNS to check if nodes are online. This does +not work across subnets unless your router supports mDNS forwarding or avahi. + +Setting this to `true` will make ESPHome use ICMP ping requests to get the node status. Use this if all nodes always have offline status even when they're connected. + +### Option: `streamer_mode` + +If set to `true`, this will enable streamer mode, which makes ESPHome hide all +potentially private information. So for example WiFi (B)SSIDs (which could be +used to find your location), usernames, etc. Please note that you need to use +the `!secret` tag in your YAML file to also prevent these from showing up +while editing and validating. + +[discord-shield]: https://img.shields.io/discord/429907082951524364.svg +[dht22]: https://esphome.io/components/sensor/dht.html +[discord]: https://discord.gg/KhAMKrd +[releases-shield]: https://img.shields.io/github/release/esphome/esphome.svg +[releases]: https://esphome.io/changelog/index.html +[repository]: https://github.com/esphome/esphome diff --git a/esphome/config.json b/esphome/config.json new file mode 100644 index 00000000..0c25913d --- /dev/null +++ b/esphome/config.json @@ -0,0 +1,47 @@ +{ + "arch": [ + "amd64", + "armv7", + "aarch64" + ], + "auth_api": true, + "auto_uart": true, + "boot": "auto", + "description": "Beta version of ESPHome Hass.io add-on.", + "hassio_api": true, + "hassio_role": "default", + "homeassistant_api": false, + "host_network": true, + "image": "esphome/esphome-hassio-{arch}", + "ingress": true, + "ingress_port": 0, + "map": [ + "ssl:ro", + "config:rw" + ], + "name": "ESPHome (beta)", + "options": {}, + "panel_icon": "mdi:chip", + "ports": { + "6052/tcp": null + }, + "ports_description": { + "6052/tcp": "Web interface (Not required for Home Assistant Ingress)" + }, + "schema": { + "certfile": "str?", + "esphome_version": "str?", + "keyfile": "str?", + "leave_front_door_open": "bool?", + "relative_url": "str?", + "ssl": "bool?", + "status_use_ping": "bool?", + "streamer_mode": "bool?" + }, + "slug": "esphome-beta", + "stage": "experimental", + "startup": "application", + "url": "https://beta.esphome.io/", + "version": "1.15.0b2", + "webui": "http://[HOST]:[PORT:6052]" +} \ No newline at end of file diff --git a/esphome/icon.png b/esphome/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..8845ae8534aad189f788528716809cfa4ffb180a GIT binary patch literal 2448 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 AVgLXD literal 0 HcmV?d00001