Use custom shields

The previous shields were loading too slow and didn't fit the documentation style
This commit is contained in:
Otto Winter 2019-02-14 16:19:07 +01:00
parent 2c85e5a17d
commit 2ae45de9b8
No known key found for this signature in database
GPG Key ID: DB66C0BE6013F97E
23 changed files with 382 additions and 396 deletions

View File

@ -1,7 +1,7 @@
.row-odd { .row-odd {
background-color: #f3f6f6; background-color: #f3f6f6;
} }
table:not(.no-center) tr.row-even > td { .table-center tr.row-even > td {
text-align: center; text-align: center;
} }

View File

@ -113,112 +113,109 @@ Please see :ref:`display-printf` for a quick introduction into the ``printf`` fo
All 7-Segment Characters All 7-Segment Characters
------------------------ ------------------------
.. table:: ============================== ==============================
:class: no-center **MAX7219 Representation** **Character**
------------------------------ ------------------------------
============================== ============================== |max721900| *(space)*
**MAX7219 Representation** **Character** ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721980| ``.``
|max721900| *(space)* ------------------------------ ------------------------------
------------------------------ ------------------------------ |max7219B0| ``!``
|max721980| ``.`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72197E| ``0``, ``O``
|max7219B0| ``!`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721930| ``1``, ``I``
|max72197E| ``0``, ``O`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72196D| ``2``, ``Z``
|max721930| ``1``, ``I`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721979| ``3``
|max72196D| ``2``, ``Z`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721933| ``4``
|max721979| ``3`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72195B| ``5``, ``S``, ``s``
|max721933| ``4`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72195F| ``6``
|max72195B| ``5``, ``S``, ``s`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721970| ``7``
|max72195F| ``6`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72197F| ``8``
|max721970| ``7`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721973| ``9``
|max72197F| ``8`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721937| ``H``
|max721973| ``9`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72194E| ``(``, ``[``, ``C``
|max721937| ``H`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721931| ``{``
|max72194E| ``(``, ``[``, ``C`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721978| ``)``, ``]``
|max721931| ``{`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721907| ``}``, ``T``, ``t``
|max721978| ``)``, ``]`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721920| ``\```
|max721907| ``}``, ``T``, ``t`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721902| ``'``
|max721920| ``\``` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721922| ``"``
|max721902| ``'`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72196F| ``@``
|max721922| ``"`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721965| ``?``
|max72196F| ``@`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721910| ``,``, ``i``
|max721965| ``?`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721949| ``%``
|max721910| ``,``, ``i`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721940| ``*``
|max721949| ``%`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721948| ``:``
|max721940| ``*`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721958| ``;``
|max721948| ``:`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721977| ``A``, ``a``
|max721958| ``;`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72191F| ``B``, ``b``
|max721977| ``A``, ``a`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72193D| ``D``, ``d``
|max72191F| ``B``, ``b`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72194F| ``E``, ``e``
|max72193D| ``D``, ``d`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721947| ``F``, ``f``
|max72194F| ``E``, ``e`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72195E| ``G``, ``g``
|max721947| ``F``, ``f`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72193C| ``J``, ``j``
|max72195E| ``G``, ``g`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72190E| ``L``, ``l``
|max72193C| ``J``, ``j`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721915| ``N``, ``n``
|max72190E| ``L``, ``l`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721967| ``P``, ``p``
|max721915| ``N``, ``n`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max7219FE| ``Q``
|max721967| ``P``, ``p`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721905| ``R``, ``r``
|max7219FE| ``Q`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72193E| ``U``, ``V``
|max721905| ``R``, ``r`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72193F| ``W``
|max72193E| ``U``, ``V`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721927| ``Y``, ``y``
|max72193F| ``W`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721901| ``-``
|max721927| ``Y``, ``y`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721908| ``_``
|max721901| ``-`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721906| ``|``
|max721908| ``_`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72190D| ``c``
|max721906| ``|`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max721917| ``h``
|max72190D| ``c`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72191D| ``o``
|max721917| ``h`` ------------------------------ ------------------------------
------------------------------ ------------------------------ |max72191C| ``u``, ``v``
|max72191D| ``o`` ============================== ==============================
------------------------------ ------------------------------
|max72191C| ``u``, ``v``
============================== ==============================
.. |max721900| image:: images/max7219/seg00.svg .. |max721900| image:: images/max7219/seg00.svg
:class: component-image :class: component-image

View File

@ -20,28 +20,25 @@ The communication esphomelib has chosen to use for this integration is 4-wire :r
and high-speed. So you need to make sure your board is set to the 4-wire SPI mode and have an ``spi:`` section in your and high-speed. So you need to make sure your board is set to the 4-wire SPI mode and have an ``spi:`` section in your
configuration. configuration.
.. table:: ==================== ===================== =====================
:class: no-center **E-Paper Pin** **ESP Pin** **esphomelib Option**
-------------------- --------------------- ---------------------
==================== ===================== ===================== ``VCC`` ``3.3V`` N/A
**E-Paper Pin** **ESP Pin** **esphomelib Option** -------------------- --------------------- ---------------------
-------------------- --------------------- --------------------- ``GND`` ``GND`` N/A
``VCC`` ``3.3V`` N/A -------------------- --------------------- ---------------------
-------------------- --------------------- --------------------- ``CLK`` Any GPIO ``spi.clk_pin``
``GND`` ``GND`` N/A -------------------- --------------------- ---------------------
-------------------- --------------------- --------------------- ``DIN`` Any GPIO ``spi.mosi_pin``
``CLK`` Any GPIO ``spi.clk_pin`` -------------------- --------------------- ---------------------
-------------------- --------------------- --------------------- ``CS`` Any GPIO ``cs_pin``
``DIN`` Any GPIO ``spi.mosi_pin`` -------------------- --------------------- ---------------------
-------------------- --------------------- --------------------- ``DC`` Any GPIO ``dc_pin``
``CS`` Any GPIO ``cs_pin`` -------------------- --------------------- ---------------------
-------------------- --------------------- --------------------- ``BUSY`` (Optional) Any GPIO ``busy_pin``
``DC`` Any GPIO ``dc_pin`` -------------------- --------------------- ---------------------
-------------------- --------------------- --------------------- ``RESET`` (Optional) Any GPIO ``reset_pin``
``BUSY`` (Optional) Any GPIO ``busy_pin`` ==================== ===================== =====================
-------------------- --------------------- ---------------------
``RESET`` (Optional) Any GPIO ``reset_pin``
==================== ===================== =====================
.. figure:: images/waveshare_epaper-pins.jpg .. figure:: images/waveshare_epaper-pins.jpg
:align: center :align: center

View File

@ -74,38 +74,35 @@ Alternatively, you can use ``.utcnow()`` to get the current UTC time.
The returned object can either be used directly to get the current minute, hour, ... as numbers or a string can be The returned object can either be used directly to get the current minute, hour, ... as numbers or a string can be
created based on a given format. If you want to get the current time attributes, you have these fields created based on a given format. If you want to get the current time attributes, you have these fields
.. table:: ==================== ======================================== ======================================== ====================
:class: no-center **Name** **Meaning** **Range (inclusive)** **Example**
-------------------- ---------------------------------------- ---------------------------------------- --------------------
==================== ======================================== ======================================== ==================== ``.second`` Seconds after the minute [0-60] (generally [0-59], 42
**Name** **Meaning** **Range (inclusive)** **Example** extra range is to accommodate leap
-------------------- ---------------------------------------- ---------------------------------------- -------------------- seconds.)
``.second`` Seconds after the minute [0-60] (generally [0-59], 42 -------------------- ---------------------------------------- ---------------------------------------- --------------------
extra range is to accommodate leap ``.minute`` Minutes after the hour [0-59] 31
seconds.) -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.hour`` Hours since midnight [0-23] 16
``.minute`` Minutes after the hour [0-59] 31 -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.day_of_week`` Day of the week, sunday=1 [1-7] 7 (saturday)
``.hour`` Hours since midnight [0-23] 16 -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.day_of_month`` Day of the month [1-31] 18
``.day_of_week`` Day of the week, sunday=1 [1-7] 7 (saturday) -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.day_of_year`` Day of the year [1-366] 231
``.day_of_month`` Day of the month [1-31] 18 -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.month`` Month, january=1 [1-12] 8 (august)
``.day_of_year`` Day of the year [1-366] 231 -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.year`` Year since 0 A.C. [1970-∞[ 2018
``.month`` Month, january=1 [1-12] 8 (august) -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.is_dst`` Is daylight savings time false, true true
``.year`` Year since 0 A.C. [1970-∞[ 2018 -------------------- ---------------------------------------- ---------------------------------------- --------------------
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ``.time`` Unix epoch time (seconds since UTC [-2147483648 - 2147483647] (negative 1534606002
``.is_dst`` Is daylight savings time false, true true Midnight January 1, 1970) values for time past January 19th 2038)
-------------------- ---------------------------------------- ---------------------------------------- -------------------- -------------------- ---------------------------------------- ---------------------------------------- --------------------
``.time`` Unix epoch time (seconds since UTC [-2147483648 - 2147483647] (negative 1534606002 ``.is_valid()`` Basic check if the time is valid false, true true
Midnight January 1, 1970) values for time past January 19th 2038) (i.e. not January 1st 1970)
-------------------- ---------------------------------------- ---------------------------------------- -------------------- ==================== ======================================== ======================================== ====================
``.is_valid()`` Basic check if the time is valid false, true true
(i.e. not January 1st 1970)
==================== ======================================== ======================================== ====================
.. note:: .. note::
@ -131,59 +128,56 @@ The strftime will parse the format string (here ``"%Y-%m-%d %H:%M"``) and match
a percent sign ``%`` and a letter corresponding to one of the below formatting options and replace it a percent sign ``%`` and a letter corresponding to one of the below formatting options and replace it
with the current time representation of that format option. with the current time representation of that format option.
.. table:: ============= ============================================================== =========================
:class: no-center **Directive** **Meaning** **Example**
------------- -------------------------------------------------------------- -------------------------
============= ============================================================== ========================= ``%a`` Abbreviated **weekday** name Sat
**Directive** **Meaning** **Example** ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%A`` Full **weekday** name Saturday
``%a`` Abbreviated **weekday** name Sat ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%w`` **Weekday** as decimal number, where 0 is Sunday and 6 6
``%A`` Full **weekday** name Saturday is Saturday
------------- -------------------------------------------------------------- ------------------------- ------------- -------------------------------------------------------------- -------------------------
``%w`` **Weekday** as decimal number, where 0 is Sunday and 6 6 ``%d`` **Day of month** as zero-padded decimal number 01, 02, ..., 31
is Saturday ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%b`` Abbreviated **month** name Aug
``%d`` **Day of month** as zero-padded decimal number 01, 02, ..., 31 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%B`` Full **month** name August
``%b`` Abbreviated **month** name Aug ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%m`` **Month** as zero-padded decimal number 01, 02, ..., 12
``%B`` Full **month** name August ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%y`` **Year** without century as a zero-padded decimal number 00, 01, ..., 99
``%m`` **Month** as zero-padded decimal number 01, 02, ..., 12 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%Y`` **Year** with century as a decimal number 2018
``%y`` **Year** without century as a zero-padded decimal number 00, 01, ..., 99 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%H`` **Hour** (24-hour clock) as a zero-padded decimal number 00, 01, ..., 23
``%Y`` **Year** with century as a decimal number 2018 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%I`` **Hour** (12-hour clock) as a zero-padded decimal number 00, 01, ..., 12
``%H`` **Hour** (24-hour clock) as a zero-padded decimal number 00, 01, ..., 23 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%p`` **AM or PM** designation AM, PM
``%I`` **Hour** (12-hour clock) as a zero-padded decimal number 00, 01, ..., 12 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%M`` **Minute** as a zero-padded decimal number 00, 01, ..., 59
``%p`` **AM or PM** designation AM, PM ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%S`` **Second** as a zero-padded decimal number 00, 01, ..., 59
``%M`` **Minute** as a zero-padded decimal number 00, 01, ..., 59 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%j`` **Day of year** as a zero-padded decimal number 001, 002, ..., 366
``%S`` **Second** as a zero-padded decimal number 00, 01, ..., 59 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%U`` **Week number of year** (Sunday as the first day of the week) 00, 01, ..., 53
``%j`` **Day of year** as a zero-padded decimal number 001, 002, ..., 366 as a zero-padded decimal number. All days in a new year
------------- -------------------------------------------------------------- ------------------------- preceding the first Sunday are considered to be in week 0.
``%U`` **Week number of year** (Sunday as the first day of the week) 00, 01, ..., 53 ------------- -------------------------------------------------------------- -------------------------
as a zero-padded decimal number. All days in a new year ``%W`` **Week number of year** (Monday as the first day of the week) 00, 01, ..., 53
preceding the first Sunday are considered to be in week 0. as a zero-padded decimal number. All days in a new year
------------- -------------------------------------------------------------- ------------------------- preceding the first Monday are considered to be in week 0.
``%W`` **Week number of year** (Monday as the first day of the week) 00, 01, ..., 53 ------------- -------------------------------------------------------------- -------------------------
as a zero-padded decimal number. All days in a new year ``%c`` **Date and time** representation Sat Aug 18 16:31:42 2018
preceding the first Monday are considered to be in week 0. ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%x`` **Date** representation 08/18/18
``%c`` **Date and time** representation Sat Aug 18 16:31:42 2018 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%X`` **Time** representation 16:31:42
``%x`` **Date** representation 08/18/18 ------------- -------------------------------------------------------------- -------------------------
------------- -------------------------------------------------------------- ------------------------- ``%%`` A literal ``%`` character %
``%X`` **Time** representation 16:31:42 ============= ============================================================== =========================
------------- -------------------------------------------------------------- -------------------------
``%%`` A literal ``%`` character %
============= ============================================================== =========================
.. _time-on_time: .. _time-on_time:

View File

@ -51,75 +51,69 @@ Some notes on the pins:
Special Pins Special Pins
------------ ------------
.. table:: =================== =============================================
:class: no-center ``GPIO0`` Controls Boot Mode
------------------- ---------------------------------------------
=================== ============================================= ``GPIO1`` UART TX pin
``GPIO0`` Controls Boot Mode ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO2`` Controls Boot Mode
``GPIO1`` UART TX pin ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO3`` UART RX pin
``GPIO2`` Controls Boot Mode ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO6`` SDIO/Flash CLK pin
``GPIO3`` UART RX pin ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO7`` SDIO/Flash Data 0 pin
``GPIO6`` SDIO/Flash CLK pin ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO8`` SDIO/Flash Data 1 pin
``GPIO7`` SDIO/Flash Data 0 pin ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO9`` SDIO/Flash Data 2 pin (qio/qout only)
``GPIO8`` SDIO/Flash Data 1 pin ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO10`` SDIO/Flash Data 3 pin (qio/qout only)
``GPIO9`` SDIO/Flash Data 2 pin (qio/qout only) ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO11`` SDIO/Flash CMD pin
``GPIO10`` SDIO/Flash Data 3 pin (qio/qout only) ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO12`` Attached to Hardware SPI controller MISO
``GPIO11`` SDIO/Flash CMD pin ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO13`` Attached to Hardware SPI controller MOSI
``GPIO12`` Attached to Hardware SPI controller MISO ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO14`` Attached to Hardware SPI controller CLK
``GPIO13`` Attached to Hardware SPI controller MOSI ------------------- ---------------------------------------------
------------------- --------------------------------------------- ``GPIO15`` Controls Boot Mode; Attached to Hardware SPI
``GPIO14`` Attached to Hardware SPI controller CLK controller CS
------------------- --------------------------------------------- ------------------- ---------------------------------------------
``GPIO15`` Controls Boot Mode; Attached to Hardware SPI ``GPIO16`` Special pin that can be accessed from RTC,
controller CS and is Deep-Sleep wakeup pin
------------------- --------------------------------------------- ------------------- ---------------------------------------------
``GPIO16`` Special pin that can be accessed from RTC, TOUT aka ``GPIO17`` ADC pin for measuring voltages, can only be
and is Deep-Sleep wakeup pin used as analog input pin
------------------- --------------------------------------------- =================== =============================================
TOUT aka ``GPIO17`` ADC pin for measuring voltages, can only be
used as analog input pin
=================== =============================================
This means effectively only the following pins can be used as general purpose GPIO: This means effectively only the following pins can be used as general purpose GPIO:
.. table:: ========== ============================== ==============================
:class: no-center **Pin** **Restrictions** **State after Reset**
---------- ------------------------------ ------------------------------
========== ============================== ============================== ``GPIO0`` If HIGH on boot Weak Pull Up
**Pin** **Restrictions** **State after Reset** ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO2`` If HIGH on boot Weak Pull Up
``GPIO0`` If HIGH on boot Weak Pull Up ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO4`` High Impedance
``GPIO2`` If HIGH on boot Weak Pull Up ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO5`` High Impedance
``GPIO4`` High Impedance ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO6`` Weak Pull Up
``GPIO5`` High Impedance ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO12`` Weak Pull Up
``GPIO6`` Weak Pull Up ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO13`` Weak Pull Up
``GPIO12`` Weak Pull Up ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO14`` Weak Pull Up
``GPIO13`` Weak Pull Up ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO15`` If LOW on boot Weak Pull Up
``GPIO14`` Weak Pull Up ---------- ------------------------------ ------------------------------
---------- ------------------------------ ------------------------------ ``GPIO16`` Has pull-down (but no pull-up Weak Pull Down
``GPIO15`` If LOW on boot Weak Pull Up resistor
---------- ------------------------------ ------------------------------ ========== ============================== ==============================
``GPIO16`` Has pull-down (but no pull-up Weak Pull Down
resistor
========== ============================== ==============================
Boot Modes Boot Modes
---------- ----------
@ -127,18 +121,15 @@ Boot Modes
On each boot, the ESP8266 will check three pins to determine in which boot mode to enter. On each boot, the ESP8266 will check three pins to determine in which boot mode to enter.
There are three boot modes: There are three boot modes:
.. table:: ========================= ========= ========= ========== ==============
:class: no-center **Mode** ``GPIO0`` ``GPIO2`` ``GPIO15`` ``boot mode:``
------------------------- --------- --------- ---------- --------------
========================= ========= ========= ========== ============== Boot from Flash (normal) HIGH HIGH LOW 3
**Mode** ``GPIO0`` ``GPIO2`` ``GPIO15`` ``boot mode:`` ------------------------- --------- --------- ---------- --------------
------------------------- --------- --------- ---------- -------------- Download Code from UART LOW HIGH LOW 1
Boot from Flash (normal) HIGH HIGH LOW 3 ------------------------- --------- --------- ---------- --------------
------------------------- --------- --------- ---------- -------------- Boot from SD-Card ANY ANY HIGH 4-7
Download Code from UART LOW HIGH LOW 1 ========================= ========= ========= ========== ==============
------------------------- --------- --------- ---------- --------------
Boot from SD-Card ANY ANY HIGH 4-7
========================= ========= ========= ========== ==============
You can identify these on boot-up by looking at the UART output, the first number You can identify these on boot-up by looking at the UART output, the first number
in the ``boot mode:`` line tells you what mode was selected in the ``boot mode:`` line tells you what mode was selected
@ -156,48 +147,42 @@ Reset Causes
Additionally, the first line also contains the **reset cause**. Additionally, the first line also contains the **reset cause**.
These reset causes `are documented <https://www.espressif.com/sites/default/files/documentation/esp8266_reset_causes_and_common_fatal_exception_causes_en.pdf>`__: These reset causes `are documented <https://www.espressif.com/sites/default/files/documentation/esp8266_reset_causes_and_common_fatal_exception_causes_en.pdf>`__:
.. table:: == ===================================
:class: no-center 0 Undefined
-- -----------------------------------
== =================================== 1 Power On Reboot
0 Undefined -- -----------------------------------
-- ----------------------------------- 2 External reset or deep-sleep wakeup
1 Power On Reboot -- -----------------------------------
-- ----------------------------------- 4 Hardware WDT reset
2 External reset or deep-sleep wakeup == ===================================
-- -----------------------------------
4 Hardware WDT reset
== ===================================
After a software reset, the reset cause will not change. After a software reset, the reset cause will not change.
Electrical Characteristics Electrical Characteristics
-------------------------- --------------------------
.. table:: =========================================================== =========== =========== =========== ===========
:class: no-center **Parameter** **Min.** **Typical** **Max.** **Unit**
----------------------------------------------------------- ----------- ----------- ----------- -----------
=========================================================== =========== =========== =========== =========== Operating Temperature -40 125 °C
**Parameter** **Min.** **Typical** **Max.** **Unit** ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- Working Voltage ``V_IO`` 2.5 3.3 3.6 V
Operating Temperature -40 125 °C ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- ``V_IL`` - INPUT voltage level to be considered LOW -0.3 0.25*V_IO V
Working Voltage ``V_IO`` 2.5 3.3 3.6 V ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- ``V_IH`` - INPUT voltage level to be considered HIGH 0.75*V_IO 3.6 V
``V_IL`` - INPUT voltage level to be considered LOW -0.3 0.25*V_IO V ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- ``V_OL`` - OUTPUT voltage level for LOW 0.1*V_IO V
``V_IH`` - INPUT voltage level to be considered HIGH 0.75*V_IO 3.6 V ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- ``V_OH`` - OUTPUT voltage level for HIGH 0.8*V_IO V
``V_OL`` - OUTPUT voltage level for LOW 0.1*V_IO V ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- ``I_MAX`` - Maximum current for GPIO 12 mA
``V_OH`` - OUTPUT voltage level for HIGH 0.8*V_IO V ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- Power Consumption in Deep Sleep 20 µA
``I_MAX`` - Maximum current for GPIO 12 mA ----------------------------------------------------------- ----------- ----------- ----------- -----------
----------------------------------------------------------- ----------- ----------- ----------- ----------- Power Consumption in Active Mode 120 mA
Power Consumption in Deep Sleep 20 µA =========================================================== =========== =========== =========== ===========
----------------------------------------------------------- ----------- ----------- ----------- -----------
Power Consumption in Active Mode 120 mA
=========================================================== =========== =========== =========== ===========
Source: `ESP8266EX datasheet <https://www.espressif.com/sites/default/files/documentation/0a-esp8266ex_datasheet_en.pdf>`__ Source: `ESP8266EX datasheet <https://www.espressif.com/sites/default/files/documentation/0a-esp8266ex_datasheet_en.pdf>`__

View File

@ -202,32 +202,29 @@ Now we would like the 4CH to actually do something, not just connect to WiFi and
Below you will find a table of all usable GPIO pins of the Sonoff 4CH and a configuration file that exposes all Below you will find a table of all usable GPIO pins of the Sonoff 4CH and a configuration file that exposes all
of the basic functions. of the basic functions.
.. table:: ======================================== =========================================
:class: no-center ``GPIO0`` Button #1 (inverted)
---------------------------------------- -----------------------------------------
======================================== ========================================= ``GPIO9`` Button #2 (inverted)
``GPIO0`` Button #1 (inverted) ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO10`` Button #3 (inverted)
``GPIO9`` Button #2 (inverted) ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO14`` Button #4 (inverted)
``GPIO10`` Button #3 (inverted) ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO12`` Relay #1 and red LED
``GPIO14`` Button #4 (inverted) ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO5`` Relay #2 and red LED
``GPIO12`` Relay #1 and red LED ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO4`` Relay #3 and red LED
``GPIO5`` Relay #2 and red LED ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO15`` Relay #4 and red LED
``GPIO4`` Relay #3 and red LED ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO13`` Blue LED (inverted)
``GPIO15`` Relay #4 and red LED ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO1`` ``RX`` pin (for external sensors)
``GPIO13`` Blue LED (inverted) ---------------------------------------- -----------------------------------------
---------------------------------------- ----------------------------------------- ``GPIO3`` ``TX`` pin (for external sensors)
``GPIO1`` ``RX`` pin (for external sensors) ======================================== =========================================
---------------------------------------- -----------------------------------------
``GPIO3`` ``TX`` pin (for external sensors)
======================================== =========================================
.. code-block:: yaml .. code-block:: yaml

View File

@ -40,22 +40,19 @@ said that other flash modes can brick the device, it's always good to specify it
Below you will find a table of all usable GPIO pins of the Sonoff Basic and a configuration file that Below you will find a table of all usable GPIO pins of the Sonoff Basic and a configuration file that
exposes all of the basic functions. exposes all of the basic functions.
.. table:: ================================================== ==================================================
:class: no-center ``GPIO0`` Button (inverted)
-------------------------------------------------- --------------------------------------------------
================================================== ================================================== ``GPIO1`` ``RX`` pin (C1 Pin 2)
``GPIO0`` Button (inverted) -------------------------------------------------- --------------------------------------------------
-------------------------------------------------- -------------------------------------------------- ``GPIO3`` ``TX`` pin (C1 Pin 3)
``GPIO1`` ``RX`` pin (C1 Pin 2) -------------------------------------------------- --------------------------------------------------
-------------------------------------------------- -------------------------------------------------- ``GPIO12`` Relay
``GPIO3`` ``TX`` pin (C1 Pin 3) -------------------------------------------------- --------------------------------------------------
-------------------------------------------------- -------------------------------------------------- ``GPIO13`` Green LED (inverted)
``GPIO12`` Relay -------------------------------------------------- --------------------------------------------------
-------------------------------------------------- -------------------------------------------------- ``GPIO14`` Optional Sensor (C1 Pin 5)
``GPIO13`` Green LED (inverted) ================================================== ==================================================
-------------------------------------------------- --------------------------------------------------
``GPIO14`` Optional Sensor (C1 Pin 5)
================================================== ==================================================
.. code-block:: yaml .. code-block:: yaml

View File

@ -198,20 +198,17 @@ Now we would like the S20 to actually do something, not just connect to WiFi and
Below you will find a table of all usable GPIO pins of the S20 and a configuration file that exposes all Below you will find a table of all usable GPIO pins of the S20 and a configuration file that exposes all
of the basic functions. of the basic functions.
.. table:: ======================================== ========================================
:class: no-center ``GPIO0`` Push Button (HIGH = off, LOW = on)
---------------------------------------- ----------------------------------------
======================================== ======================================== ``GPIO12`` Relay and its status LED
``GPIO0`` Push Button (HIGH = off, LOW = on) ---------------------------------------- ----------------------------------------
---------------------------------------- ---------------------------------------- ``GPIO13`` Green LED (HIGH = off, LOW = on)
``GPIO12`` Relay and its status LED ---------------------------------------- ----------------------------------------
---------------------------------------- ---------------------------------------- ``GPIO1`` ``RX`` pin (for external sensors)
``GPIO13`` Green LED (HIGH = off, LOW = on) ---------------------------------------- ----------------------------------------
---------------------------------------- ---------------------------------------- ``GPIO3`` ``TX`` pin (for external sensors)
``GPIO1`` ``RX`` pin (for external sensors) ======================================== ========================================
---------------------------------------- ----------------------------------------
``GPIO3`` ``TX`` pin (for external sensors)
======================================== ========================================
.. code-block:: yaml .. code-block:: yaml

View File

@ -91,6 +91,7 @@ class ImageTableDirective(Table):
col_widths = self.get_column_widths(3) col_widths = self.get_column_widths(3)
title, messages = self.make_title() title, messages = self.make_title()
table = nodes.table() table = nodes.table()
table['classes'].append('table-center')
# Set up column specifications based on widths # Set up column specifications based on widths
tgroup = nodes.tgroup(cols=3) tgroup = nodes.tgroup(cols=3)
@ -141,7 +142,6 @@ class ImageTableDirective(Table):
rows.append(trow) rows.append(trow)
tbody.extend(rows) tbody.extend(rows)
table['classes'] += []
self.add_name(table) self.add_name(table)
if title: if title:
table.insert(0, title) table.insert(0, title)
@ -207,7 +207,6 @@ class PinTableDirective(Table):
trow += entry trow += entry
tbody += trow tbody += trow
table['classes'] += ['no-center']
self.add_name(table) self.add_name(table)
if title: if title:
table.insert(0, title) table.insert(0, title)

View File

@ -315,14 +315,14 @@ This will result in really small firmware data which has a high chance of fittin
Donations Donations
--------- ---------
I invest lots of time into this project, so if you like esphomelib and want to support the project, donations I invest a lot of time into this project, so if you like ESPHome and want to
are very welcome. support the project, donations are very welcome :)
Before donating here though, please consider donating to charity (for example the red cross, UNICEF, greenpeace, ...). You can donate to me via PayPal. Other donation options are being
They can use the money much better than I can. Also, I don't want donations for feature requests as I cannot explored. https://www.paypal.me/ottowinter
_guarantee_ that I can get a specific feature to work reliably.
Donations are currently only possible via PayPal: https://www.paypal.me/ottowinter (Please do not donate for specific features as I cannot guarantee I will
be able to implement a feature because of complexity or other problems.)
See Also See Also
-------- --------

17
images/index.rst Normal file
View File

@ -0,0 +1,17 @@
Images
======
This is a dummy file to include images in the sphinx output
that will only be used in raw HTML and thus not auto-included.
.. image:: shield-discord.svg
.. image:: shield-github.svg
.. image:: shield-donate.svg
.. image:: shield-twitter.svg
.. image:: logo.svg
.. image:: logo-core.svg
.. image:: logo-docs.svg
.. image:: logo-flasher.svg
.. image:: logo-release.svg
.. image:: logo-text.svg

File diff suppressed because one or more lines are too long

Before

Width:  |  Height:  |  Size: 7.9 KiB

After

Width:  |  Height:  |  Size: 7.9 KiB

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 209 43"><g fill="none" fill-rule="evenodd"><path d="M10 0h189c5.54 0 10 4.46 10 10v23c0 5.54-4.46 10-10 10H10C4.46 43 0 38.54 0 33V10C0 4.46 4.46 0 10 0z" fill="#000"/><path d="M179.5 9.326c-8.162 0-13.887 3.244-13.887 3.244 3.137-2.596 8.618-4.09 8.618-4.09l-.517-.48c-5.147.085-9.807 3.385-9.807 3.385-5.238 10.126-4.903 18.87-4.903 18.87 4.264 5.106 10.598 4.74 10.598 4.74l2.163-2.54c-3.807-.761-6.213-3.892-6.213-3.892s5.725 3.61 13.948 3.61 13.948-3.61 13.948-3.61-2.406 3.131-6.213 3.893l2.163 2.538s6.334.367 10.598-4.739c0 0 .335-8.744-4.903-18.87 0 0-4.66-3.3-9.807-3.385l-.517.48s5.481 1.494 8.618 4.09c0 0-5.725-3.244-13.887-3.244z" fill="#fff" fill-rule="nonzero"/><path d="M173.485 20c1.952 0 3.545 1.57 3.515 3.5a3.52 3.52 0 0 1-3.515 3.5c-1.923 0-3.485-1.598-3.485-3.5 0-1.93 1.532-3.5 3.485-3.5zM185.485 20A3.503 3.503 0 0 1 189 23.5a3.52 3.52 0 0 1-3.515 3.5c-1.923 0-3.485-1.598-3.485-3.5 0-1.93 1.532-3.5 3.485-3.5z" fill="#000" fill-rule="nonzero"/><g aria-label="Discord" fill="#fff"><path d="M9.401 8.092h9.947q1.777 0 3.4.461 1.641.462 3.043 1.3 1.418.836 2.563 2.016 1.162 1.162 1.982 2.597.82 1.436 1.265 3.094.444 1.657.444 3.452 0 1.794-.444 3.452t-1.265 3.11q-.82 1.436-1.982 2.632-1.145 1.18-2.563 2.034-1.402.837-3.042 1.299-1.624.461-3.401.461H9.4v-4.683h2.068V12.792H9.401zm7.742 4.7v16.525h2.17q1.385 0 2.615-.649 1.23-.65 2.136-1.76.906-1.128 1.436-2.632.53-1.521.53-3.264 0-1.726-.53-3.23t-1.436-2.615q-.905-1.11-2.136-1.743-1.23-.632-2.615-.632zM34.455 16.295h7.947v13.022h2.46V34H34.456v-4.683h2.666v-8.34h-2.666zm2.393-5.708q0-.632.222-1.18.24-.563.65-.973.41-.41.956-.65.564-.24 1.214-.24.615 0 1.162.24.547.24.957.65.41.41.65.974.238.547.238 1.179t-.239 1.196q-.24.547-.65.957-.41.41-.956.65-.547.239-1.162.239-.65 0-1.214-.24-.547-.239-.957-.649-.41-.41-.65-.957-.221-.564-.221-1.196zM59.287 21.712q0-.41-.274-.786-.256-.376-.769-.65-.513-.29-1.265-.46-.734-.171-1.674-.171-.36 0-.77.068-.41.051-.768.205-.342.154-.581.427-.223.257-.223.667 0 .205.052.393.068.188.239.359.17.17.461.324.308.137.786.223l3.213.632q1.744.342 2.923.854 1.179.513 1.897 1.197.717.683 1.025 1.52.325.838.325 1.812 0 1.521-.718 2.666-.7 1.145-1.863 1.914-1.145.752-2.597 1.128-1.436.393-2.906.393-.957 0-1.743-.12-.769-.119-1.401-.324-.615-.205-1.111-.479-.479-.29-.889-.632h-3.093v-4.75h4.836v.102q.018.495.308.871.29.36.752.615.479.257 1.077.394.598.12 1.264.12 1.538 0 2.24-.394.7-.41.7-1.042 0-.496-.342-.838-.342-.359-1.213-.564l-3.282-.7q-3.093-.599-4.665-1.983-1.572-1.401-1.572-3.589 0-1.281.598-2.324.598-1.06 1.623-1.794 1.026-.752 2.393-1.163 1.384-.41 2.956-.41 1.077 0 1.914.137.838.12 1.504.325.667.205 1.162.495.513.274.906.581h2.974v4.751zM80.12 22.413q-.736-.923-1.641-1.384-.906-.479-2.137-.41-.99-.069-1.811.273-.803.342-1.402.957-.58.615-.905 1.47-.325.837-.325 1.897 0 .94.342 1.777.342.838.923 1.453.598.598 1.4.94.821.342 1.778.41.804-.068 1.453-.325.666-.273 1.18-.683.512-.428.87-.94.377-.53.582-.992l4.7 1.3q-.291 1.025-1.009 2.136-.7 1.11-1.846 2.033-1.127.906-2.7 1.504-1.555.598-3.554.598-2.034 0-3.743-.735-1.71-.752-2.94-2.033-1.23-1.282-1.93-3.008-.684-1.726-.684-3.709 0-1.965.7-3.64.718-1.692 1.966-2.94 1.247-1.264 2.956-1.965 1.726-.7 3.743-.632 1.435-.068 2.786.325 1.35.393 2.563 1.179h3.4v5.144zM86.887 25.08q0-1.932.7-3.624.701-1.692 1.949-2.956 1.247-1.265 2.973-2 1.726-.735 3.794-.735t3.794.735q1.743.735 2.99 2 1.248 1.264 1.932 2.956.7 1.692.7 3.623 0 1.931-.683 3.64-.666 1.692-1.914 2.974-1.23 1.265-2.974 2-1.726.734-3.845.734-2.136 0-3.88-.735-1.725-.734-2.956-2-1.23-1.264-1.914-2.956-.666-1.709-.666-3.657zm5.11 0q0 1.007.341 1.862.342.837.923 1.453.598.615 1.367.957.787.341 1.675.341.906 0 1.675-.324.786-.342 1.35-.957.581-.616.906-1.453.325-.855.325-1.88 0-1.06-.325-1.914-.325-.854-.906-1.453-.564-.598-1.35-.905-.769-.325-1.675-.308-.888-.017-1.675.308-.769.307-1.367.905-.58.599-.923 1.453-.341.855-.341 1.914zM124.348 22.738h-4.803v-1.829q-.7 0-1.281.103-.581.085-1.026.307-.427.223-.735.616-.29.393-.41.974v6.408h3.606V34h-11.553v-4.683h2.65v-8.34h-2.615v-4.682h7.878v1.247q.752-.598 1.692-.922.94-.325 2.05-.325 1.129 0 2.325.017 1.196.017 2.222.017zM137.763 7.408h7.742v21.91h3.452V34h-8.716v-.684q-.923.479-1.897.752-.957.274-1.948.274-2.034 0-3.743-.718-1.692-.735-2.922-2-1.213-1.264-1.897-2.956-.684-1.709-.684-3.657t.667-3.623q.683-1.692 1.88-2.94 1.213-1.247 2.888-1.965 1.692-.718 3.708-.718 1.111 0 2.085.222.975.205 1.863.598v-4.494h-2.478zm-1.076 22.217q1.127-.034 2.033-.581.923-.547 1.521-1.436v-5.212q-.598-.906-1.555-1.401-.94-.513-2-.496-.888-.017-1.674.308-.77.324-1.367.922-.582.599-.923 1.436-.342.837-.342 1.897 0 1.042.342 1.897.341.837.923 1.436.598.58 1.367.888.786.308 1.675.342z"/></g></g></svg>

After

Width:  |  Height:  |  Size: 4.6 KiB

1
images/shield-donate.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 183 43"><g fill="none" fill-rule="evenodd"><path d="M10 0h163c5.54 0 10 4.46 10 10v23c0 5.54-4.46 10-10 10H10C4.46 43 0 38.54 0 33V10C0 4.46 4.46 0 10 0z" fill="#000"/><g aria-label="Donate" fill="#fff"><path d="M9.401 8.092h9.947q1.777 0 3.4.461 1.641.462 3.043 1.3 1.418.836 2.563 2.016 1.162 1.162 1.982 2.597.82 1.436 1.265 3.094.444 1.657.444 3.452 0 1.794-.444 3.452t-1.265 3.11q-.82 1.436-1.982 2.632-1.145 1.18-2.563 2.034-1.402.837-3.042 1.299-1.624.461-3.401.461H9.4v-4.683h2.068V12.792H9.401zm7.742 4.7v16.525h2.17q1.385 0 2.615-.649 1.23-.65 2.136-1.76.906-1.128 1.436-2.632.53-1.521.53-3.264 0-1.726-.53-3.23t-1.436-2.615q-.905-1.11-2.136-1.743-1.23-.632-2.615-.632zM34.318 25.08q0-1.932.701-3.624.7-1.692 1.948-2.956 1.248-1.265 2.974-2 1.726-.735 3.794-.735t3.794.735q1.743.735 2.99 2 1.248 1.264 1.932 2.956.7 1.692.7 3.623 0 1.931-.683 3.64-.667 1.692-1.914 2.974-1.23 1.265-2.974 2-1.726.734-3.845.734-2.136 0-3.88-.735-1.726-.734-2.956-2-1.23-1.264-1.914-2.956-.667-1.709-.667-3.657zm5.11 0q0 1.007.342 1.862.342.837.923 1.453.598.615 1.367.957.786.341 1.675.341.906 0 1.675-.324.786-.342 1.35-.957.58-.616.906-1.453.324-.855.324-1.88 0-1.06-.324-1.914-.325-.854-.906-1.453-.564-.598-1.35-.905-.77-.325-1.675-.308-.889-.017-1.675.308-.769.307-1.367.905-.581.599-.923 1.453-.342.855-.342 1.914zM70.275 23.814q0-1.486-.786-2.324-.786-.854-2.085-.854-.888 0-1.794.393t-1.76 1.47v6.818h2.87V34H55.716v-4.683h2.597v-8.34H55.75v-4.682h8.066v1.555q1.111-.871 2.478-1.367 1.385-.513 2.906-.513 3.196 0 4.922 1.795 1.726 1.777 1.726 5.212v6.34h2.512V34h-8.084zM91.552 33.043q-.598.376-1.094.65-.495.256-.99.41-.496.17-1.026.239-.53.085-1.162.085-1.59 0-2.854-.427-1.248-.444-2.12-1.196-.854-.77-1.315-1.795-.462-1.042-.462-2.256 0-1.23.462-2.273.478-1.042 1.367-1.777.889-.752 2.17-1.162 1.3-.427 2.957-.427 1.213 0 2.204.136 1.009.12 1.863.308v-.547q0-.666-.256-1.145-.256-.495-.718-.803-.461-.325-1.11-.461-.65-.154-1.42-.154-1.606 0-2.836.324-1.213.308-2.341.906l-1.641-3.315q1.743-1.196 3.64-1.829 1.914-.632 4.05-.632 1.658 0 3.06.376 1.418.359 2.426 1.196 1.009.82 1.573 2.153.58 1.333.58 3.248v6.442h2.376V34h-7.383zm-3.896-2.649q1.213 0 2.204-.393.992-.393 1.692-.957v-2.256h-4.101q-.393 0-.77.12-.375.12-.683.342-.29.222-.478.546-.171.325-.171.752 0 .786.564 1.316.58.53 1.743.53zM109.223 16.295h3.538v4.477h-3.572l-.034 7.486q0 .65.102 1.06.103.392.29.632.206.239.48.324.273.086.632.086.65 0 1.145-.12.495-.136.99-.307l.736 3.298q-.872.547-1.948.872-1.06.324-2.53.324-1.042 0-2-.359-.94-.359-1.657-1.076-.718-.735-1.145-1.829-.427-1.094-.41-2.546l.051-7.845h-2.546v-4.477h2.563l.034-4.238 5.315-2.53zM120.81 26.258l.051.53q.188.77.633 1.35.461.581 1.076.974.616.393 1.368.598.751.188 1.52.188.77 0 1.453-.085.7-.103 1.35-.256.65-.171 1.265-.376.615-.223 1.247-.462l1.88 3.504q-.974.598-1.794 1.025-.803.41-1.624.684-.82.273-1.743.393-.923.136-2.153.136-2.307 0-4.102-.752-1.794-.769-3.025-2.067-1.213-1.3-1.862-3.042-.633-1.744-.633-3.692 0-1.948.667-3.657.683-1.709 1.914-2.974 1.23-1.281 2.94-2.016 1.708-.735 3.793-.735t3.692.7q1.623.684 2.734 1.915 1.11 1.213 1.71 2.87.597 1.641.648 3.538.052.428.052.855.017.41-.017.854zm4.085-6.46q-.958 0-1.641.24-.667.222-1.128.632-.461.393-.735.906-.273.512-.427 1.076h7.4q-.12-.58-.342-1.093-.222-.513-.615-.906t-1.009-.615q-.598-.24-1.503-.24z"/></g><path d="M154.46 36.955c-.185-.075-.405-.315-.439-.48-.05-.225-.101.165 1.014-6.137 1.014-5.703.997-5.613 1.132-5.778.22-.255.186-.255 2.72-.27 2.231-.045 2.704-.045 3.701-.18 5.492-.675 8.888-3.541 10.071-8.493.068-.33.135-.615.152-.615 0-.015.119.06.254.15 1.74 1.17 2.332 3.331 1.673 6.212-.778 3.437-2.84 5.717-6.05 6.693-1.368.42-2.517.585-4.545.63-1.352.06-1.386.06-1.774.285-.288.255-.27.21-.93 3.826-.456 2.551-.625 3.377-.693 3.527-.118.24-.354.45-.625.57l-.186.105H157.3c-2.18 0-2.737 0-2.839-.045z" fill="#fff" fill-rule="nonzero"/><path d="M146.535 32.937c-.318-.157-.535-.425-.535-.74 0-.425 4.36-26.126 4.478-26.41.15-.283.534-.582.835-.693l.25-.094h5.899c6.533 0 6.282 0 7.753.315 4.377.866 6.382 3.622 5.63 7.764-.835 4.614-3.308 7.354-7.519 8.346-1.453.33-2.472.425-5.246.425-2.189 0-2.356.016-2.79.237a1.972 1.972 0 0 0-.936 1.18c-.067.111-.451 2.316-.885 4.883a359.853 359.853 0 0 0-.786 4.756l-.05.094h-2.974c-2.64 0-3.007 0-3.124-.063z" fill="#fff" fill-rule="nonzero"/></g></svg>

After

Width:  |  Height:  |  Size: 4.3 KiB

1
images/shield-github.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 192 43"><g fill="none" fill-rule="evenodd"><path d="M10 0h172c5.54 0 10 4.46 10 10v23c0 5.54-4.46 10-10 10H10C4.46 43 0 38.54 0 33V10C0 4.46 4.46 0 10 0z" fill="#000"/><g aria-label="GitHub" fill="#fff"><path d="M26.713 35v-4.443q-1.06 1.862-2.068 2.734-1.008.872-2.29 1.401-1.265.53-3.4.513-1.06-.017-2.12-.24-1.06-.238-2.05-.649-.992-.427-1.95-1.008-.939-.598-1.708-1.367-1.897-1.914-2.957-4.426-1.042-2.53-1.042-5.503 0-1.829.444-3.538.445-1.709 1.248-3.196.803-1.486 1.931-2.7 1.145-1.23 2.53-2.102 1.4-.872 3.007-1.35 1.607-.479 3.367-.479 2.016 0 3.503.547 1.487.53 3.196 2h3.828v5.776h-5.28q-.787-1.213-1.487-1.76-.684-.547-1.504-.906-.804-.359-2.256-.359-1.436 0-2.666.65t-2.136 1.76q-.89 1.094-1.402 2.598-.513 1.486-.513 3.059 0 1.555.462 2.956.461 1.402 1.401 2.53.94 1.11 2.188 1.709 1.247.598 2.666.598 1.811 0 3.161-1.06t1.949-2.888h-4.94v-4.683h11.998V35zM35.326 17.295h7.947v13.022h2.46V35H35.327v-4.683h2.666v-8.34h-2.666zm2.393-5.708q0-.632.222-1.18.24-.563.65-.973.41-.41.956-.65.564-.24 1.214-.24.615 0 1.162.24.547.24.957.65.41.41.65.974.239.547.239 1.179t-.24 1.196q-.239.547-.65.957-.41.41-.956.65-.547.239-1.162.239-.65 0-1.214-.24-.547-.239-.957-.649-.41-.41-.65-.957-.221-.564-.221-1.196zM55.543 17.295h3.538v4.477H55.51l-.034 7.486q0 .65.103 1.06.102.392.29.632.205.239.479.324.273.086.632.086.65 0 1.145-.12.496-.136.991-.307l.735 3.298q-.871.547-1.948.872-1.06.324-2.53.324-1.042 0-1.999-.359-.94-.359-1.658-1.076-.717-.735-1.145-1.829-.427-1.094-.41-2.546l.051-7.845h-2.546v-4.477h2.564l.034-4.238 5.315-2.53zM80.443 9.092h11.109v4.7h-2.735v16.525h2.735V35H80.443v-4.683h2.7v-6.63H71.455v6.63h2.734V35h-11.09v-4.683h2.682V13.792h-2.683v-4.7h11.091v4.7h-2.734v5.383h11.69v-5.383h-2.7zM105.856 17.295h8.374v13.022h2.136V35h-7.502v-1.504q-.906.82-2.12 1.265-1.213.444-2.802.444-1.47 0-2.769-.461-1.298-.462-2.273-1.385-.957-.94-1.52-2.34-.547-1.402-.547-3.3v-5.741h-2.308v-4.683h7.828V27.72q0 1.777.905 2.666.906.871 2.359.871 1.025 0 1.862-.632.838-.632 1.214-1.709v-6.938h-2.837zM118.126 8.408h7.725v9.28q.923-.444 1.897-.684.974-.239 2-.239 1.965 0 3.64.735 1.674.735 2.888 2 1.213 1.264 1.897 2.956.7 1.692.7 3.589 0 1.914-.683 3.606-.667 1.692-1.88 2.956-1.213 1.248-2.888 1.983-1.675.718-3.674.718-1.077 0-2.051-.205-.974-.206-1.846-.582V35h-5.247V13.09h-2.478zm11.263 13.074q-1.128 0-2.034.513-.889.512-1.504 1.47v5.297q.547.82 1.453 1.333.923.496 2.05.496.872 0 1.658-.308.786-.325 1.367-.906.599-.598.94-1.418.342-.837.342-1.88 0-1.06-.342-1.914-.341-.854-.923-1.453-.58-.598-1.367-.905-.769-.325-1.64-.325z"/></g><path d="M165.5 4C155.283 4 147 11.8 147 21.422c0 7.7 5.31 14.234 12.654 16.551.925.14 1.221-.4 1.221-.871v-2.944c-5.125 1.045-6.216-2.335-6.216-2.335-.851-2.02-2.054-2.561-2.054-2.561-1.683-1.08.13-1.045.13-1.045 1.85.122 2.83 1.794 2.83 1.794 1.61 2.648 4.33 1.864 5.384 1.446.166-1.132.647-1.899 1.165-2.334-4.107-.436-8.417-1.934-8.417-8.572 0-1.934.703-3.484 1.905-4.721-.185-.436-.832-2.248.185-4.6 0 0 1.554-.47 5.088 1.777a18.446 18.446 0 0 1 4.625-.575c1.573 0 3.163.192 4.625.575 3.534-2.247 5.088-1.777 5.088-1.777 1.017 2.352.37 4.164.185 4.6 1.202 1.237 1.905 2.787 1.905 4.721 0 6.655-4.329 8.119-8.454 8.554.666.54 1.276 1.603 1.276 3.223v4.774c0 .47.296 1.028 1.24.871 7.344-2.335 12.635-8.85 12.635-16.55 0-4.622-1.95-9.053-5.419-12.32C175.112 5.836 170.407 4 165.5 4z" fill="#fff" fill-rule="nonzero"/></g></svg>

After

Width:  |  Height:  |  Size: 3.4 KiB

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 202 43"><g fill="none" fill-rule="evenodd"><path d="M10 0h182c5.54 0 10 4.46 10 10v23c0 5.54-4.46 10-10 10H10C4.46 43 0 38.54 0 33V10C0 4.46 4.46 0 10 0z" fill="#000"/><path d="M195 11.294a19.31 19.31 0 0 1-4.821 1.137c1.724-.873 3.057-2.257 3.684-3.92-1.626.823-3.43 1.4-5.33 1.729-1.549-1.416-3.724-2.24-6.194-2.24-4.605 0-8.368 3.162-8.368 7.066 0 .56.078 1.103.215 1.614-6.977-.296-13.19-3.113-17.325-7.379a6.163 6.163 0 0 0-1.136 3.541c0 2.454 1.47 4.629 3.743 5.864-1.392 0-2.685-.33-3.822-.824v.05c0 3.426 2.9 6.292 6.742 6.934a9.755 9.755 0 0 1-3.782.115c1.058 2.784 4.135 4.859 7.839 4.908-2.861 1.911-6.487 3.031-10.446 3.031-.666 0-1.333-.033-1.999-.099 3.724 2.01 8.153 3.179 12.896 3.179 15.443 0 23.93-10.772 23.93-20.11 0-.314 0-.61-.02-.923A15.58 15.58 0 0 0 195 11.294z" fill="#fff" fill-rule="nonzero"/><g aria-label="Twitter" fill="#fff"><path d="M14.375 29.317h2.683V12.621h-3.145v3.35H8.342V8.09h23.567v7.88h-5.606v-3.35h-3.572v16.696h2.735V34H14.375zM33.173 16.295h9.246v4.683h-2l1.88 6.306 3.64-10.99h5.008l3.674 11.554 2.256-6.87H54.98v-4.683h9.246v4.683H61.85l-4.734 13.09h-5.11l-3.708-11.296-3.777 11.296h-4.973l-4.392-13.09h-1.983zM66.31 16.295h7.947v13.022h2.461V34H66.311v-4.683h2.666v-8.34H66.31zm2.393-5.708q0-.632.222-1.18.24-.563.65-.973.41-.41.957-.65.564-.24 1.213-.24.615 0 1.162.24.547.24.957.65.41.41.65.974.239.547.239 1.179t-.24 1.196q-.239.547-.649.957-.41.41-.957.65-.547.239-1.162.239-.65 0-1.213-.24-.547-.239-.957-.649-.41-.41-.65-.957-.222-.564-.222-1.196zM86.528 16.295h3.537v4.477h-3.571l-.035 7.486q0 .65.103 1.06.103.392.29.632.206.239.48.324.272.086.631.086.65 0 1.145-.12.496-.136.992-.307l.734 3.298q-.871.547-1.948.872-1.06.324-2.53.324-1.042 0-1.999-.359-.94-.359-1.657-1.076-.718-.735-1.145-1.829-.428-1.094-.41-2.546l.05-7.845H78.65v-4.477h2.564l.034-4.238 5.315-2.53zM100.2 16.295h3.537v4.477h-3.571l-.035 7.486q0 .65.103 1.06.102.392.29.632.205.239.479.324.273.086.632.086.65 0 1.145-.12.496-.136.991-.307l.735 3.298q-.871.547-1.948.872-1.06.324-2.53.324-1.042 0-1.999-.359-.94-.359-1.657-1.076-.718-.735-1.145-1.829-.428-1.094-.41-2.546l.05-7.845h-2.546v-4.477h2.564l.034-4.238 5.315-2.53zM111.787 26.258l.05.53q.189.77.633 1.35.462.581 1.077.974t1.367.598q.752.188 1.521.188.77 0 1.453-.085.7-.103 1.35-.256.65-.171 1.264-.376.616-.223 1.248-.462l1.88 3.504q-.974.598-1.795 1.025-.803.41-1.623.684-.82.273-1.743.393-.923.136-2.154.136-2.307 0-4.101-.752-1.795-.769-3.025-2.067-1.213-1.3-1.863-3.042-.632-1.744-.632-3.692 0-1.948.666-3.657.684-1.709 1.914-2.974 1.23-1.281 2.94-2.016 1.709-.735 3.794-.735t3.691.7q1.624.684 2.735 1.915 1.11 1.213 1.709 2.87.598 1.641.649 3.538.051.428.051.855.017.41-.017.854zm4.084-6.46q-.957 0-1.64.24-.667.222-1.128.632-.462.393-.735.906-.274.512-.428 1.076h7.4q-.12-.58-.341-1.093-.223-.513-.616-.906t-1.008-.615q-.598-.24-1.504-.24zM143.557 22.738h-4.803v-1.829q-.7 0-1.281.103-.581.085-1.026.307-.427.223-.735.616-.29.393-.41.974v6.408h3.606V34h-11.553v-4.683h2.65v-8.34h-2.615v-4.682h7.878v1.247q.752-.598 1.692-.922.94-.325 2.05-.325 1.129 0 2.325.017 1.196.017 2.222.017z"/></g></g></svg>

After

Width:  |  Height:  |  Size: 3.1 KiB

View File

@ -12,9 +12,10 @@ ESPHome
.. raw:: html .. raw:: html
<a href="https://github.com/OttoWinter/esphomelib"><img src="https://img.shields.io/github/stars/OttoWinter/esphomelib.svg?style=social&label=Star&maxAge=2592000" alt="GitHub stars" style="max-width:100%;"></a> <a href="https://github.com/esphome/esphome"><img src="/_images/shield-github.svg" alt="GitHub" style="max-width:100%;height:26px;width:116.1px;margin-top:10px;"></a>
<a href="https://esphomelib.com/esphomeyaml/changelog/index.html"><img src="https://img.shields.io/pypi/v/esphomeyaml.svg" alt="Release" style="max-width:100%;"></a> <a href="https://discord.gg/KhAMKrd"><img src="/_images/shield-discord.svg" alt="Discord" style="max-width:100%;height:26px;width:126.3px;"></a>
<a href="https://discord.gg/KhAMKrd"><img src="https://img.shields.io/discord/429907082951524364.svg" alt="Discord Chat" style="max-width:100%;"></a> <a href="https://twitter.com/esphome_"><img src="/_images/shield-twitter.svg" alt="Twitter" style="max-width:100%;height:26px;width:122.1px;"></a>
<a href="/guides/faq.html#donations"><img src="/_images/shield-donate.svg" alt="Donate" style="max-width:100%;height:26px;width:110.6px;"></a>
.. _guides: .. _guides:
@ -312,3 +313,4 @@ documentation for others to copy. See :doc:`Contributing </guides/contributing>`
guides/index guides/index
changelog/index changelog/index
custom/index custom/index
images/index

BIN
svg2png/logo-flasher.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

BIN
svg2png/logo-release.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

BIN
svg2png/shield-discord.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

BIN
svg2png/shield-donate.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

BIN
svg2png/shield-github.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

BIN
svg2png/shield-twitter.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB