diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index c5be22727..b91a3b4f8 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -8,19 +8,19 @@ In the interest of fostering an open and welcoming environment, we as contributo Examples of behavior that contributes to creating a positive environment include: -* Using welcoming and inclusive language -* Being respectful of differing viewpoints and experiences -* Gracefully accepting constructive criticism -* Focusing on what is best for the community -* Showing empathy towards other community members +- Using welcoming and inclusive language +- Being respectful of differing viewpoints and experiences +- Gracefully accepting constructive criticism +- Focusing on what is best for the community +- Showing empathy towards other community members Examples of unacceptable behavior by participants include: -* The use of sexualized language or imagery and unwelcome sexual attention or advances -* Trolling, insulting/derogatory comments, and personal or political attacks -* Public or private harassment -* Publishing others' private information, such as a physical or electronic address, without explicit permission -* Other conduct which could reasonably be considered inappropriate in a professional setting +- The use of sexualized language or imagery and unwelcome sexual attention or advances +- Trolling, insulting/derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or electronic address, without explicit permission +- Other conduct which could reasonably be considered inappropriate in a professional setting ## Our Responsibilities @@ -34,7 +34,7 @@ This Code of Conduct applies both within project spaces and in public spaces whe ## Enforcement -Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at contact@otto-winter.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. +Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at esphome@nabucasa.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. diff --git a/_static/custom.css b/_static/custom.css index 6dad41e47..70273f248 100644 --- a/_static/custom.css +++ b/_static/custom.css @@ -62,15 +62,18 @@ table.docutils { z-index: 9999; display: none } -#upgrade-footer-changelog { +.footer-button-container { + margin: 0 60px 0 10px; + float: right; +} +.footer-button { background-color: #b3b3b3; color: #4e4e4e; display: inline-block; border-radius: 5px; padding: 0 20px; + margin-left: 10px; cursor: pointer; - float: right; - margin: 0 60px 0 10px; text-decoration: none; } .not-hidden { diff --git a/_templates/layout.html b/_templates/layout.html index 27e04b79a..c8b9d9a29 100644 --- a/_templates/layout.html +++ b/_templates/layout.html @@ -30,15 +30,20 @@ {% block footer %} diff --git a/components/canbus.rst b/components/canbus.rst index 86ac347dd..440cd501b 100644 --- a/components/canbus.rst +++ b/components/canbus.rst @@ -92,7 +92,7 @@ This automation will be triggered when a can frame is received. A variable ``x` .. note:: - Messeges this node sends to te same ID will not show up as reveived messages. + Messages this node sends to the same ID will not show up as received messages. .. code-block:: yaml @@ -144,10 +144,10 @@ Configuration variables: MCP2515 Component ----------------- -The MCP2515 is a spi device and therfore you must first add the configuration for the spi bus to your file. +The MCP2515 is a spi device and therefore you must first add the configuration for the spi bus to your file. You need to have an :ref:`SPI bus ` in your configuration with both the **mosi_pin** and **miso_pin** set. -For wireing up the MSP2515 please refer to the section below. +For wiring up the MSP2515 please refer to the section below. Configuration variables: ************************ @@ -157,7 +157,7 @@ Configuration variables: Sometimes also called ``SS``. - **clock** (*Optional*): One of ``8MHZ``, ``16MHZ`` or ``20MHZ``. Clock crystal used on the MCP2515 device. Defaults to ``8MHZ``. -- **mode** (*Optional*): Operation mode. Default ot ``NORMAL`` +- **mode** (*Optional*): Operation mode. Default to ``NORMAL`` - NORMAL: Normal operation - LOOPBACK: Loopback mode can be used to just test you spi connections to the device @@ -205,7 +205,7 @@ Standard IDs and Extended IDs can coexist on the same segment. .. note:: - It is important to know that for example Standard 0x123 and Extended 0x123 are different addesses. + It is important to know that for example Standard 0x123 and Extended 0x123 are different addresses. This example shows how the different ID types are used in the configuration for transmission and receiving. For the IDs decimal or hexadecimal notation is possible: 0x000 - 0x7ff / 0-2047 for Standard IDs only. diff --git a/components/display/ili9341.rst b/components/display/ili9341.rst index 612a89b91..7ee2ab7c0 100644 --- a/components/display/ili9341.rst +++ b/components/display/ili9341.rst @@ -65,7 +65,7 @@ Configuration examples To utilize the color capabilities of this display module, you'll likely want to add a ``color:`` section to your YAML configuration; please see :ref:`color ` for more detail on this configuration section. -To use colors in your lambada: +To use colors in your lambda: .. code-block:: yaml diff --git a/components/display/index.rst b/components/display/index.rst index 782de3f4e..a8aa8fdb1 100644 --- a/components/display/index.rst +++ b/components/display/index.rst @@ -374,10 +374,10 @@ Configuration variables: - ``BINARY``: Two colors, suitable for 1 color displays or 2 color image in color displays. Uses 1 bit per pixel, 8 pixels per byte. - - ``GREYSCALE``: Full scale grey. Uses 8 bits per pixel, 1 pixel per byte. + - ``GRAYSCALE``: Full scale grey. Uses 8 bits per pixel, 1 pixel per byte. - ``RGB24``: Full RGB color stored. Uses 3 bytes per pixel. -- **dither** (*Optional*): Specifies which dither method used to process the image, only used in GREYSCALE and BINARY type image. Defaults to ``NONE``. You can read more about it `here `__ and `here `__. +- **dither** (*Optional*): Specifies which dither method used to process the image, only used in GRAYSCALE and BINARY type image. Defaults to ``NONE``. You can read more about it `here `__ and `here `__. - ``NONE``: Every pixel convert to its nearest color. - ``FLOYDSTEINBERG``: Uses Floyd-Steinberg dither to approximate the original image luminosity levels. diff --git a/components/display/ssd1325.rst b/components/display/ssd1325.rst index 45740b025..8af7569c4 100644 --- a/components/display/ssd1325.rst +++ b/components/display/ssd1325.rst @@ -71,7 +71,7 @@ To utilize the grayscale capabilities of this display module, add a ``color:`` s please see :ref:`color ` for more details. As this is a grayscale display, it only uses the white color element as shown below. -To use grayscale in your lambada: +To use grayscale in your lambda: .. code-block:: yaml diff --git a/components/display/ssd1327.rst b/components/display/ssd1327.rst index 3ba15b3f8..e8a01aebd 100644 --- a/components/display/ssd1327.rst +++ b/components/display/ssd1327.rst @@ -128,7 +128,7 @@ To utilize the grayscale capabilities of this display module, add a ``color:`` s please see :ref:`color ` for more details. As this is a grayscale display, it only uses the white color element as shown below. -To use grayscale in your lambada: +To use grayscale in your lambda: .. code-block:: yaml diff --git a/components/display/st7789v.rst b/components/display/st7789v.rst index f6352148f..89606c15b 100644 --- a/components/display/st7789v.rst +++ b/components/display/st7789v.rst @@ -70,7 +70,7 @@ As of version 1.15, ESPHome supports color displays. To utilize the color capabi module, you'll likely want to add a ``color:`` section to your YAML configuration; please see :ref:`color ` for more detail on this configuration section. -To use colors in your lambada: +To use colors in your lambda: .. code-block:: yaml diff --git a/components/i2c.rst b/components/i2c.rst index 3fa859ad5..57043320f 100644 --- a/components/i2c.rst +++ b/components/i2c.rst @@ -12,7 +12,7 @@ This component sets up the I²C bus for your ESP32 or ESP8266. In order for thes to work correctly, you need to define the I²C bus in your configuration. Please note the ESP will enable its internal 10kΩ pullup resistors for these pins, so you usually don't need to put on external ones. You can use multiple devices on one I²C bus as each device is given a -unique address for communicating between between it and the ESP. You can do this by hopping +unique address for communicating between it and the ESP. You can do this by hopping wires from the two lines (SDA and SCL) from each device board to the next device board or by connecting the wires from each device back to the two I²C pins on the ESP. diff --git a/components/spi.rst b/components/spi.rst index 2ca47e4ed..5839b0547 100644 --- a/components/spi.rst +++ b/components/spi.rst @@ -31,9 +31,9 @@ rarely be necessary, as the SPI bus can be shared by the devices). # Example configuration entry spi: - clk_pin: GPIO21 - mosi_pin: GPIO22 - miso_pin: GPIO23 + clk_pin: GPIO14 + mosi_pin: GPIO13 + miso_pin: GPIO12 Configuration variables: ------------------------ diff --git a/guides/configuration-types.rst b/guides/configuration-types.rst index 4c4f0e21c..87fde6d27 100644 --- a/guides/configuration-types.rst +++ b/guides/configuration-types.rst @@ -13,15 +13,15 @@ page describes them. ID -- -Quite an important aspect of ESPHome are “ids”. They are used to +Quite an important aspect of ESPHome are “IDs”. They are used to connect components from different domains. For example, you define an -output component together with an id and then later specify that same id +output component together with an ID and then later specify that same ID in the light component. IDs should always be unique within a configuration and ESPHome will warn you if you try to use the same ID twice. Because ESPHome converts your configuration into C++ code and the -ids are in reality just C++ variable names, they must also adhere to +IDs are in reality just C++ variable names, they must also adhere to C++’s naming conventions. `C++ Variable names `__ … @@ -205,7 +205,7 @@ of nodes inherit: To hide these base files from the dashboard, you can - - Place them in a subdirectory (dashboard only shows files in top-level dir) + - Place them in a subdirectory (dashboard only shows files in top-level directory) - Prepend a dot to the filename, like ``.base.yaml`` .. _command-line-substitutions: @@ -271,8 +271,8 @@ config in the main yaml file. All definitions from packages will be merged with config in non-destructive way so you could always override some bits and pieces of package configuration. -Consider the following example where author put common pieces of configuration like WiFi, -I²C into base files and extends it with some devices specific configurations in the main config. +Consider the following example where the author put common pieces of configuration like WiFi and +I²C into base files and extends it with some device specific configurations in the main config. Note how the piece of configuration describing ``api`` component in ``device_base.yaml`` gets merged with the services definitions from main config file. diff --git a/guides/diy.rst b/guides/diy.rst index 47fb07b9e..d64c5520c 100644 --- a/guides/diy.rst +++ b/guides/diy.rst @@ -47,6 +47,7 @@ Blog Posts & Videos - `4$ Xiaomi mijia thermometer LYWSD03MMC + ESP32 + ESPhome `__ by `Omar GHADER `__ - `Baseboard (Line Voltage) Thermostat from Smart Switch `__ by :ghuser:`rjmurph2241` - `Office Doorbell `__ by :ghuser:`shish` +- `Display TM1637 with ESPHome and MQTT showing Youtube subscribers count and other info `__ by :ghuser:`electrofun-smart` Custom Components & Code ------------------------ diff --git a/guides/supporters.rst b/guides/supporters.rst index 690ac643f..732a4d187 100644 --- a/guides/supporters.rst +++ b/guides/supporters.rst @@ -1,100 +1,13 @@ -Supporters & Contributors -========================= - -**Hi! I'm Otto Winter, the author and main developer of ESPHome.** - -Developing ESPHome takes a lot of time. There's a lot of things that go -into developing and maintaining an open-source project: from developing new features, fixing bugs, -answering questions to maintaining servers, preparing releases and moderating discussions. -And of course all of the hardware for new features has to be bought too. I'm a student -so I really appreciate donations :) - -**You can support ESPHome's development** by becoming a Patron or a one-time contribution -with PayPal. - -.. raw:: html - - -
-
-

Support Regularly đź’«

- Become A Patron -

- Become a patron for this project. -

-
-
-

One-Time Donation

- Donate with PayPal -

- Make a one-time donation via PayPal. -

-
-
- -Patrons -------- - -People that support ESPHome's development over `Patreon `__. -You guys are awesome! - -- Alexander Leisentritt -- Anders -- Andrea Donno -- Andrew Tierney -- Book of the Future -- Christer Frostmo -- Christoph -- Clayton -- Daan Damhuis -- Dattas Moonchaser -- David Padbury -- Dennis Münchgesang -- Dmitriy Khazansky -- DrZzs -- fabi -- Franck Nijhof -- Gaiar Baimuratov -- Intermittent Technology -- Jung Ervin -- Kenvase -- Lazar Obradovic -- Magnus Overli -- minsuke -- Nick Rout -- Nigel Michki -- Paul Krischer -- Paul Morley -- Paweł Kawa -- Philippe Penochet -- Radu Tizu -- Roman Priesol -- LMR -- Ryan Bahm -- Ryan Nazaretian -- Sam Absalom -- Sasha Mikhnov -- Saulo Onze -- Starwolf73 -- Thibault Maekelbergh -- Thomas Hermine -- Vincèn PUJOL -- Wojciech Bederski -- Yonatan Adest -- Zoltán Jáki - - Contributors ------------- +============ ESPHome is an open-source project, and everybody can contribute to it to make this project awesome. This list contains a list of people who have submitted patches that have made it into the `ESPHome organization's `__ repositories. -Author & Main Developer -*********************** +ESPHome is lead by `Jesse Hills (@jesserockz) `__, who is funded to work on ESPHome full-time by `Nabu Casa `__. To help fund development of ESPHome, subscribe to `Home Assistant Cloud by Nabu Casa `__. -- `Otto Winter (@OttoWinter) `__ - 2361 contributions +ESPHome was originally founded by `Otto Winter (@OttoWinter) `__. Contributors ************ @@ -300,7 +213,6 @@ Contributors - `Joshua Dadswell (@jdads1) `__ - 1 contribution - `jeff-h (@jeff-h) `__ - 2 contributions - `Jeff Rescignano (@JeffResc) `__ - 11 contributions -- `Jesse Hills (@jesserockz) `__ - 133 contributions - `Jérémy JOURDIN (@JJK801) `__ - 1 contribution - `Jonathan Jefferies (@jjok) `__ - 1 contribution - `Justin Maxwell (@jkmaxwell) `__ - 1 contribution diff --git a/index.rst b/index.rst index 0338b36d5..8f8ede82d 100644 --- a/index.rst +++ b/index.rst @@ -19,7 +19,6 @@ ESPHome is a system to control your ESP8266/ESP32 by simple yet powerful configu GitHub Discord Twitter - Donate .. _guides: diff --git a/misc/privacy.rst b/misc/privacy.rst index 976fd9a4c..73b4180f6 100644 --- a/misc/privacy.rst +++ b/misc/privacy.rst @@ -126,4 +126,4 @@ when they are posted on this page. Contact Us ---------- -If you have any questions about this Privacy Policy, please contact us by email: contact@otto-winter.com +If you have any questions about this Privacy Policy, please contact us by email: esphome@nabucasa.com