Add LibreTiny documentation (#3159)
Co-authored-by: H. Árkosi Róbert <robreg@zsurob.hu>
This commit is contained in:
Kuba Szczodrzyński
GitHub
parent
ea28d5e1c9
commit
6dacabd9ff
|
|
@ -0,0 +1,221 @@
|
|||
LibreTiny Platform
|
||||
==================
|
||||
|
||||
.. seo::
|
||||
:description: Configuration for the LibreTiny platform for ESPHome.
|
||||
:image: libretiny.svg
|
||||
|
||||
This component contains platform-specific options for the `LibreTiny <https://docs.libretiny.eu/>`__ platform.
|
||||
It provides support for the following microcontrollers:
|
||||
|
||||
- **BK72xx**: BK7231T, BK7231N
|
||||
- **RTL87xx**: RTL8710BN, RTL8710BX
|
||||
|
||||
Since different microcontrollers are supported, you need to include the appropriate ESPHome component,
|
||||
depending on which processor your device has.
|
||||
|
||||
Refer to `LibreTiny/Boards <https://docs.libretiny.eu/link/boards>`__ to find your board type.
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
# Example configuration entry for BK72xx
|
||||
bk72xx:
|
||||
board: generic-bk7231n-qfn32-tuya
|
||||
|
||||
# Example configuration entry for RTL87xx
|
||||
rtl87xx:
|
||||
board: generic-rtl8710bn-2mb-788k
|
||||
|
||||
Configuration variables:
|
||||
------------------------
|
||||
|
||||
- **board** (**Required**, string): The PlatformIO board ID that should be used. Choose the appropriate board from
|
||||
`this list <https://registry.platformio.org/packages/platforms/kuba2k2/libretiny/boards>`__
|
||||
(the icon next to the name can be used to copy the board ID).
|
||||
|
||||
**This affects CPU selection and some internal settings** - make sure to choose the right CPU.
|
||||
If unsure about the choice of a particular board, choose a generic board such as ``generic-bk7231n-qfn32-tuya``.
|
||||
|
||||
- **framework** (*Optional*): Options for the underlying framework used by ESPHome.
|
||||
|
||||
- **version** (*Optional*, string): The LibreTiny version number to use, from
|
||||
`LibreTiny platform releases <https://github.com/kuba2k2/libretiny/releases>`__. Defaults to ``recommended``. Additional values
|
||||
|
||||
- ``dev``: Use the latest commit from https://github.com/kuba2k2/libretiny, note this may break at any time
|
||||
- ``latest``: Use the latest *release* from https://github.com/kuba2k2/libretiny/releases, even if it hasn't been recommended yet.
|
||||
- ``recommended``: Use the recommended framework version.
|
||||
|
||||
- **source** (*Optional*, string): The PlatformIO package or repository to use for the framework. This can be used to use a custom or patched version of the framework.
|
||||
|
||||
- :ref:`Advanced options <advanced-options>`
|
||||
|
||||
- **family** (*Optional*, boolean): The family of LibreTiny-supported microcontrollers that is used on this board.
|
||||
One of ``bk7231n``, ``bk7231t``, ``rtl8710b``, ``rtl8720c``, ``bk7251``, ``bk7231q``.
|
||||
Defaults to the variant that is detected from the board, if a board that's unknown to ESPHome is used,
|
||||
this option is mandatory. **It's recommended not to include this option**.
|
||||
|
||||
.. note::
|
||||
|
||||
Support for the LibreTiny platform is still in development and there could be issues or missing components.
|
||||
|
||||
In particular, **MQTT is not supported yet**, because of reported stability issues.
|
||||
|
||||
Please report any issues on `LibreTiny GitHub <https://github.com/kuba2k2/libretiny>`__.
|
||||
|
||||
Getting Started
|
||||
---------------
|
||||
|
||||
Since BK72xx and RTL87xx chips are relatively new on the IoT Open Source development stage,
|
||||
there aren't many resources on flashing and configuring them.
|
||||
|
||||
Here are a few useful links:
|
||||
|
||||
- `tuya-cloudcutter <https://github.com/tuya-cloudcutter/tuya-cloudcutter>`__ - flashing ESPHome Over-the-Air
|
||||
to some devices compatible with Tuya/SmartLife apps (BK72xx only!)
|
||||
|
||||
- `Textual & video guide by digiblurDIY <https://docs.libretiny.eu/link/cloudcutter-digiblur>`__
|
||||
- `Video guide by LibreTiny <https://docs.libretiny.eu/link/cloudcutter-video>`__
|
||||
- `ESPHome-Kickstart <https://docs.libretiny.eu/link/kickstart>`__ - starter firmware to upload OTA with Cloudcutter
|
||||
|
||||
- `Flashing BK72xx by UART <https://docs.libretiny.eu/link/flashing-beken-72xx>`__
|
||||
- `Flashing RTL8710B by UART <https://docs.libretiny.eu/link/flashing-realtek-ambz>`__
|
||||
- `UPK2ESPHome <https://upk.libretiny.eu/>`__ - generating ESPHome YAML automatically, from Cloudcutter profiles or Kickstart firmware (also BK72xx only)
|
||||
|
||||
GPIO Pin Numbering
|
||||
------------------
|
||||
|
||||
Chips supported by LibreTiny use the internal GPIO pin numbering of the boards, this means that
|
||||
you don't have to worry about other kinds of pin numberings, yay!
|
||||
|
||||
Additionally, you can use **pin function macros** to quickly access a GPIO tied to a particular peripheral,
|
||||
such as UART1 TX/RX or PWM0.
|
||||
See `LibreTiny/GPIO Access <https://docs.libretiny.eu/link/gpio-access>`__ to learn more.
|
||||
|
||||
Most of the popular boards (often incorrectly called "chips"), that are usually shipped with Smart Home devices,
|
||||
are *supported by LibreTiny*, which means that a pinout drawing is available, with all GPIOs described.
|
||||
Visit `LibreTiny/Boards <https://docs.libretiny.eu/link/boards>`__ to find all supported boards.
|
||||
|
||||
The ``Pin functions`` table outlines all GPIOs available on the chosen board.
|
||||
*You can use any of the visible names* to access a particular GPIO.
|
||||
|
||||
Some notes about the pins on BK72xx:
|
||||
|
||||
- ``TX2 (P0)`` and ``RX2 (P1)`` are used for the default :doc:`/components/logger` UART port.
|
||||
- ``TX1 (P11)`` and ``RX1 (P10)`` are used for flashing firmware, as well as for :doc:`/components/tuya`.
|
||||
- ``ADC3 (P23)`` is the only :doc:`/components/sensor/adc` available on BK7231.
|
||||
|
||||
Some notes about the pins on RTL8710BN/BX:
|
||||
|
||||
- ``TX2 (PA30)`` and ``RX2 (PA29)`` are used for flashing the firmware,
|
||||
as well as the default :doc:`/components/logger` UART port.
|
||||
- ``TX2 (PA30)`` is additionally used to determine the boot mode on startup (similar to ESP32).
|
||||
Pulling it LOW on startup will enter "download mode".
|
||||
|
||||
Example configuration entries using various naming styles:
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
# GPIO switch on P26/GPIO26 (BK72xx example)
|
||||
switch:
|
||||
- platform: gpio
|
||||
name: Relay 1
|
||||
pin: P26
|
||||
|
||||
# GPIO binary sensor on PA12 (RTL87xx example)
|
||||
binary_sensor:
|
||||
- platform: gpio
|
||||
name: "Pin PA12"
|
||||
pin: PA12
|
||||
|
||||
# ADC reading (BK72xx example)
|
||||
sensor:
|
||||
- platform: adc
|
||||
pin: ADC3
|
||||
name: "Battery Level"
|
||||
|
||||
# PWM component
|
||||
output:
|
||||
- platform: libretiny_pwm
|
||||
pin: PWM2
|
||||
frequency: 1000 Hz
|
||||
id: pwm_output
|
||||
# using light with the PWM
|
||||
light:
|
||||
- platform: monochromatic
|
||||
output: pwm_output
|
||||
name: "Kitchen Light"
|
||||
|
||||
# Tuya MCU on UART1 (BK72xx example)
|
||||
uart:
|
||||
rx_pin: RX1
|
||||
tx_pin: TX1
|
||||
baud_rate: 9600
|
||||
tuya:
|
||||
|
||||
.. _advanced-options:
|
||||
|
||||
Advanced options
|
||||
----------------
|
||||
|
||||
These are some advanced configuration options of LibreTiny platform.
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
# Example configuration entry
|
||||
bk72xx:
|
||||
board: cb2s
|
||||
framework:
|
||||
version: dev
|
||||
loglevel: debug
|
||||
debug:
|
||||
- wifi
|
||||
- ota
|
||||
sdk_silent: auto
|
||||
uart_port: 2
|
||||
gpio_recover: false
|
||||
options:
|
||||
LT_LOG_HEAP: 1
|
||||
LT_AUTO_DOWNLOAD_REBOOT: 1
|
||||
|
||||
- **loglevel** (*Optional*, string): Logging level for LibreTiny core. Controls the output of logging messages
|
||||
from the core (doesn't affect ESPHome logger!). *These messages are only visible on the physical UART*.
|
||||
One of ``verbose``, ``trace`` (same as ``verbose``), ``debug``, ``info``,
|
||||
``warn`` (default), ``error``, ``fatal``, ``none``.
|
||||
|
||||
- **debug** (*Optional*, string or string list): Modules to enable LibreTiny debugging for.
|
||||
Refer to `LibreTiny/Configuration <https://docs.libretiny.eu/link/config-debug>`__
|
||||
for more information - some modules are enabled by default.
|
||||
One or more of ``wifi``, ``client``, ``server``, ``ssl``, ``ota``, ``fdb``,
|
||||
``mdns``, ``lwip``, ``lwip_assert``.
|
||||
Specifying ``none`` will disable all modules. You can also combine ``none`` with one or more of the modules.
|
||||
|
||||
- **sdk_silent** (*Optional*, string): Define the SDK logging "silent mode".
|
||||
This disables messages from vendor SDKs, which makes UART output more readable, but can hide some error messages.
|
||||
*This affects the physical UART port only*.
|
||||
Refer to `LibreTiny/Configuration <https://docs.libretiny.eu/link/config-serial>`__ for more information.
|
||||
|
||||
- ``all``: Disable all messages (default).
|
||||
- ``auto``: Disable selectively, i.e. during Wi-Fi activation.
|
||||
- ``none``: Keep all logging messages, don't disable anything.
|
||||
|
||||
- **uart_port** (*Optional*, int): Choose the default UART port of the framework.
|
||||
This affects LibreTiny logging messages, **as well as the default port for**
|
||||
:doc:`ESPHome logger </components/logger>` (e.g. if you don't specify any other).
|
||||
One of 0, 1, 2. The default value is chip-specific and is chosen by LibreTiny appropriately.
|
||||
|
||||
- **gpio_recover** (*Optional*, boolean): Disable JTAG/SWD debugging peripherals. This may be needed
|
||||
to free GPIOs that should be used for other functions. Defaults to ``true``.
|
||||
|
||||
- **options** (*Optional*, mapping): Custom options passed to LibreTiny platform.
|
||||
Refer to `LibreTiny/Configuration <https://docs.libretiny.eu/link/config>`__ to see all options.
|
||||
*This takes precedence (overrides) all options described above*.
|
||||
|
||||
See Also
|
||||
--------
|
||||
|
||||
- :doc:`esphome`
|
||||
- :doc:`/components/output/libretiny_pwm`
|
||||
- :doc:`/components/text_sensor/libretiny`
|
||||
- `LibreTiny Documentation <https://docs.libretiny.eu/>`__ (external)
|
||||
- :doc:`/components/tuya`
|
||||
- :ghedit:`Edit`
|
||||
|
|
@ -0,0 +1,66 @@
|
|||
LibreTiny PWM Output
|
||||
====================
|
||||
|
||||
.. seo::
|
||||
:description: Instructions for setting up LibreTiny hardware PWMs.
|
||||
:image: pwm.png
|
||||
|
||||
The LibreTiny PWM platform allows you to use a hardware PWM on BK72xx and RTL87xx chips.
|
||||
Refer to `LibreTiny/Boards <https://docs.libretiny.eu/link/boards>`__ to find your board
|
||||
and which PWM pins it supports.
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
# Example configuration entry
|
||||
output:
|
||||
- platform: libretiny_pwm
|
||||
pin: P8
|
||||
frequency: 1000 Hz
|
||||
id: pwm_output
|
||||
|
||||
# Example usage in a light
|
||||
light:
|
||||
- platform: monochromatic
|
||||
output: pwm_output
|
||||
name: "Kitchen Light"
|
||||
|
||||
Configuration variables:
|
||||
------------------------
|
||||
|
||||
- **pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The pin to use PWM on.
|
||||
- **id** (**Required**, :ref:`config-id`): The id to use for this output component.
|
||||
- **frequency** (*Optional*, frequency): The frequency to run the PWM with. Lower frequencies
|
||||
have more visual artifacts, but can represent much more colors. Defaults to ``1000 Hz``.
|
||||
- All other options from :ref:`Output <config-output>`.
|
||||
|
||||
.. _output-libretiny_pwm-set_frequency_action:
|
||||
|
||||
``output.libretiny_pwm.set_frequency`` Action
|
||||
---------------------------------------------
|
||||
|
||||
This :ref:`Action <config-action>` allows you to manually change the frequency of a LibreTiny PWM
|
||||
channel at runtime. Use cases include controlling a passive buzzer (for pitch control).
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
on_...:
|
||||
- output.libretiny_pwm.set_frequency:
|
||||
id: pwm_output
|
||||
frequency: 100Hz
|
||||
|
||||
Configuration variables:
|
||||
|
||||
- **id** (**Required**, :ref:`config-id`): The ID of the PWM output to change.
|
||||
- **frequency** (**Required**, :ref:`templatable <config-templatable>`, float): The frequency
|
||||
to set in hertz.
|
||||
|
||||
See Also
|
||||
--------
|
||||
|
||||
- :doc:`/components/libretiny`
|
||||
- :doc:`/components/output/index`
|
||||
- :doc:`/components/light/monochromatic`
|
||||
- :doc:`/components/fan/speed`
|
||||
- :doc:`/components/power_supply`
|
||||
- :apiref:`libretiny_pwm/libretiny_pwm.h`
|
||||
- :ghedit:`Edit`
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
LibreTiny Text Sensor
|
||||
=====================
|
||||
|
||||
.. seo::
|
||||
:description: Instructions for setting up LibreTiny text sensors.
|
||||
:image: libretiny.svg
|
||||
|
||||
The ``libretiny`` text sensor platform exposes various LibreTiny core
|
||||
information via text sensors.
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
# Example configuration entry
|
||||
text_sensor:
|
||||
- platform: libretiny
|
||||
version:
|
||||
name: LibreTiny Version
|
||||
|
||||
Configuration variables:
|
||||
------------------------
|
||||
|
||||
- **version** (*Optional*): Expose the version of LibreTiny core as a text sensor. All options from
|
||||
:ref:`Text Sensor <config-text_sensor>`.
|
||||
|
||||
|
||||
See Also
|
||||
--------
|
||||
|
||||
- :doc:`/components/libretiny`
|
||||
- :apiref:`libretiny/lt_component.h`
|
||||
- :ghedit:`Edit`
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<svg width="404.53" height="94.488" version="1.1" viewBox="0 0 107.03 25" xmlns="http://www.w3.org/2000/svg">
|
||||
<g>
|
||||
<path d="m5.0006-2.5483e-5h97.032c2.7704 0 5.0006 2.2303 5.0006 5.0006v14.999c0 2.7704-2.2303 5.0006-5.0006 5.0006h-97.032c-2.7704 0-5.0006-2.2303-5.0006-5.0006v-14.999c0-2.7704 2.2303-5.0006 5.0006-5.0006z" stroke-width="2.1757"/>
|
||||
<g fill="#fffffc" stroke-width=".26458" aria-label="BK72xx">
|
||||
<path d="m5.8934 20.666v-15.805h8.4441q3.2738 0 4.8317 1.1741 1.5579 1.1515 1.5579 2.9577 0 1.1966-0.67734 2.1449-0.65476 0.92569-1.9191 1.4676-1.2644 0.54187-3.1158 0.54187l0.45156-1.2192q1.8514 0 3.1835 0.51929 1.3547 0.51929 2.0772 1.5127 0.74507 0.97085 0.74507 2.3481 0 2.0546-1.7159 3.2061-1.6933 1.1515-4.9671 1.1515zm5.2381-3.7254h3.2061q0.88054 0 1.3095-0.31609 0.45156-0.31609 0.45156-0.92569t-0.45156-0.92569q-0.42898-0.31609-1.3095-0.31609h-3.5673v-3.5222h2.8448q0.90312 0 1.3095-0.29351 0.42898-0.31609 0.42898-0.88054 0-0.58703-0.42898-0.88054-0.4064-0.29351-1.3095-0.29351h-2.4836z"/>
|
||||
<path d="m29.231 17.279-0.29351-5.8477 5.9606-6.5702h5.8025l-6.6831 7.3604-2.9577 3.0254zm-4.7639 3.3867v-15.805h5.2381v15.805zm10.386 0-4.651-6.1412 3.4544-3.6576 7.3604 9.7988z"/>
|
||||
<path d="m44.49 20.666 5.9606-13.908 1.4224 2.2352h-7.4959l2.0772-2.4158v4.7188h-4.4027v-6.4347h13.524v3.2738l-5.2607 12.531z"/>
|
||||
<path d="m57.873 20.666v-3.2738l5.7122-5.2832q0.54187-0.51929 0.79023-0.90312 0.27094-0.38382 0.36125-0.67734 0.09031-0.31609 0.09031-0.58703 0-0.58703-0.38382-0.90312-0.38382-0.33867-1.1515-0.33867-0.69992 0-1.3321 0.38382-0.63218 0.36125-0.99343 1.0837l-4.0189-2.0094q0.85796-1.6256 2.5739-2.6416 1.7159-1.016 4.2672-1.016 1.874 0 3.319 0.6096 1.445 0.6096 2.2578 1.7159 0.8128 1.1063 0.8128 2.619 0 0.76765-0.2032 1.5353-0.18062 0.76765-0.76765 1.6256-0.58702 0.83538-1.7385 1.874l-4.2898 3.906-0.83538-1.8514h8.1958v4.1318z"/>
|
||||
<path d="m71.863 20.666 5.8251-7.6313-0.13547 2.9351-5.5542-7.6539h5.7574l2.7319 4.0866-2.1223 0.15804 3.0029-4.2446h5.351l-5.5767 7.4056v-2.8222l5.6896 7.7668h-5.8477l-2.8222-4.3575 2.1449 0.29351-2.9125 4.064z"/>
|
||||
<path d="m87.527 20.666 5.8251-7.6313-0.13547 2.9351-5.5542-7.6539h5.7574l2.7319 4.0866-2.1223 0.15804 3.0029-4.2446h5.351l-5.5767 7.4056v-2.8222l5.6896 7.7668h-5.8477l-2.8222-4.3575 2.1449 0.29351-2.9125 4.064z"/>
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 2.3 KiB |
|
|
@ -0,0 +1,17 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<svg width="493.56" height="116.85" version="1.1" viewBox="0 0 130.59 30.916" xmlns="http://www.w3.org/2000/svg">
|
||||
<g>
|
||||
<path d="m5.0006-2.5483e-5h120.59c2.7704 0 5.0006 2.2303 5.0006 5.0006v20.914c0 2.7704-2.2303 5.0006-5.0006 5.0006h-120.59c-2.7704 0-5.0006-2.2303-5.0006-5.0006v-20.914c0-2.7704 2.2303-5.0006 5.0006-5.0006z" stroke-width="2.6724"/>
|
||||
<g fill="#fffffc" stroke-width=".26458" aria-label="LibreTiny">
|
||||
<path d="m5.8934 23.398v-15.805h5.3284v11.673h7.1346v4.1318z"/>
|
||||
<path d="m20.781 23.398v-12.35h5.1026v12.35zm2.5513-13.344q-1.3998 0-2.2352-0.74507-0.83538-0.74507-0.83538-1.8514t0.83538-1.8514q0.83538-0.74507 2.2352-0.74507t2.2352 0.69991 0.83538 1.8062q0 1.1741-0.83538 1.9417-0.83538 0.74507-2.2352 0.74507z"/>
|
||||
<path d="m37.498 23.623q-1.6933 0-2.7319-0.67734-1.0386-0.67734-1.5127-2.0997-0.45156-1.4224-0.45156-3.635 0-2.1901 0.49671-3.5899 0.49671-1.4224 1.5353-2.0997 1.0612-0.69992 2.6642-0.69992 1.6256 0 2.9803 0.76765 1.3547 0.76765 2.1675 2.2126 0.8128 1.4224 0.8128 3.4093 0 1.9869-0.8128 3.4318-0.8128 1.4224-2.1675 2.2126-1.3547 0.76765-2.9803 0.76765zm-8.2409-0.22578v-16.753h5.1026v6.0509l-0.22578 4.5156-0.02258 4.5156v1.6708zm7.0217-3.7479q0.56445 0 1.016-0.27094t0.72249-0.8128q0.27094-0.56445 0.27094-1.3547 0-0.8128-0.27094-1.3321-0.27094-0.54187-0.72249-0.8128t-1.016-0.27094q-0.56445 0-1.016 0.27094t-0.72249 0.8128q-0.27093 0.51929-0.27093 1.3321 0 0.79023 0.27093 1.3547 0.27094 0.54187 0.72249 0.8128t1.016 0.27094z"/>
|
||||
<path d="m46.155 23.398v-12.35h4.8542v3.7254l-0.79023-1.0612q0.56445-1.445 1.8062-2.1675 1.2418-0.72249 2.9803-0.72249v4.5156q-0.33867-0.04516-0.6096-0.06773-0.24836-0.02258-0.51929-0.02258-1.1515 0-1.8965 0.6096-0.72249 0.58702-0.72249 2.0546v5.4864z"/>
|
||||
<path d="m64.227 23.623q-2.2578 0-3.9511-0.83538-1.6708-0.83538-2.5965-2.2804-0.92569-1.4676-0.92569-3.2964 0-1.874 0.90312-3.319 0.92569-1.445 2.5061-2.2578 1.603-0.8128 3.5899-0.8128 1.8288 0 3.3641 0.72249 1.5579 0.72249 2.4836 2.1449 0.94827 1.4224 0.94827 3.5222 0 0.27093-0.02258 0.6096-0.02258 0.31609-0.04516 0.58702h-9.5053v-2.461h6.7959l-1.9191 0.65476q0-0.72249-0.27094-1.2192-0.24836-0.51929-0.69991-0.79023-0.45156-0.29351-1.0837-0.29351-0.63218 0-1.1063 0.29351-0.45156 0.27094-0.69992 0.79023-0.24836 0.49671-0.24836 1.2192v0.76765q0 0.79023 0.31609 1.3547 0.31609 0.56445 0.90312 0.85796 0.58702 0.27094 1.4224 0.27094 0.85796 0 1.3998-0.22578 0.56445-0.22578 1.174-0.67734l2.6642 2.6868q-0.90312 0.97085-2.2352 1.4901-1.3095 0.49671-3.1609 0.49671z"/>
|
||||
<path d="m74.81 23.398v-11.673h-4.6285v-4.1318h14.585v4.1318h-4.6285v11.673z"/>
|
||||
<path d="m87.104 23.398v-12.35h5.1026v12.35zm2.5513-13.344q-1.3998 0-2.2352-0.74507-0.83538-0.74507-0.83538-1.8514t0.83538-1.8514q0.83538-0.74507 2.2352-0.74507 1.3998 0 2.2352 0.69991 0.83538 0.69991 0.83538 1.8062 0 1.1741-0.83538 1.9417-0.83538 0.74507-2.2352 0.74507z"/>
|
||||
<path d="m104.16 10.822q1.4224 0 2.5739 0.58702 1.1515 0.56445 1.8062 1.7837 0.67733 1.2192 0.67733 3.1609v7.0443h-5.1026v-6.1638q0-1.1515-0.4064-1.6256-0.40641-0.49671-1.1063-0.49671-0.51929 0-0.97085 0.24836-0.42898 0.22578-0.69992 0.76765-0.24835 0.54187-0.24835 1.4676v5.8025h-5.1026v-12.35h4.8542v3.6125l-0.97085-1.0386q0.72249-1.3998 1.9417-2.0997 1.2418-0.69992 2.7545-0.69992z"/>
|
||||
<path d="m115.01 28.004q-1.016 0-2.0772-0.31609-1.0386-0.29351-1.6708-0.79023l1.6933-3.4996q0.38382 0.29351 0.85796 0.47414 0.49671 0.18062 0.94827 0.18062 0.67734 0 1.0386-0.29351 0.36125-0.27094 0.58703-0.83538l0.51929-1.3095 0.36125-0.49671 3.9511-10.07h4.8317l-5.08 12.598q-0.67733 1.6933-1.5804 2.6416-0.88054 0.94827-1.9868 1.3321-1.0837 0.38382-2.3933 0.38382zm1.1966-4.0414-5.3735-12.915h5.2381l3.7028 9.6182z"/>
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 3.6 KiB |
|
|
@ -0,0 +1,15 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<svg width="454.57" height="94.488" version="1.1" viewBox="0 0 120.27 25" xmlns="http://www.w3.org/2000/svg">
|
||||
<g>
|
||||
<path d="m5.0006-2.5483e-5h110.27c2.7704 0 5.0006 2.2303 5.0006 5.0006v14.999c0 2.7704-2.2303 5.0006-5.0006 5.0006h-110.27c-2.7704 0-5.0006-2.2303-5.0006-5.0006v-14.999c0-2.7704 2.2303-5.0006 5.0006-5.0006z" stroke-width="2.3063"/>
|
||||
<g fill="#fffffc" stroke-width=".26458" aria-label="RTL87xx">
|
||||
<path d="m5.8934 20.666v-15.805h7.6088q2.2126 0 3.8157 0.72249 1.6256 0.72249 2.5061 2.0772 0.88054 1.3321 0.88054 3.1609 0 1.8288-0.88054 3.1609-0.88054 1.3095-2.5061 2.0094-1.603 0.69992-3.8157 0.69992h-4.651l2.3707-2.1901v6.1638zm9.4601 0-3.8834-5.7574h5.6445l3.9286 5.7574zm-4.1318-5.5767-2.3707-2.4158h4.3124q1.1063 0 1.6256-0.49671 0.54187-0.49671 0.54187-1.3547 0-0.85796-0.54187-1.3547-0.51929-0.49671-1.6256-0.49671h-4.3124l2.3707-2.4158z"/>
|
||||
<path d="m27.017 20.666v-11.673h-4.6285v-4.1318h14.585v4.1318h-4.6285v11.673z"/>
|
||||
<path d="m39.469 20.666v-15.805h5.3284v11.673h7.1346v4.1318z"/>
|
||||
<path d="m60.882 21.027q-2.0997 0-3.7028-0.6096-1.5805-0.63218-2.4836-1.7611-0.90312-1.1515-0.90312-2.6868t0.92569-2.619q0.92569-1.0837 2.5287-1.6482 1.603-0.56445 3.635-0.56445t3.635 0.56445q1.603 0.56445 2.5287 1.6482 0.92569 1.0837 0.92569 2.619t-0.90312 2.6868q-0.90312 1.1289-2.5061 1.7611-1.5805 0.6096-3.6802 0.6096zm0-3.5899q0.76765 0 1.2418-0.42898 0.49671-0.45156 0.49671-1.2192 0-0.76765-0.49671-1.1966-0.47414-0.45156-1.2418-0.45156-0.76765 0-1.2644 0.45156-0.47414 0.42898-0.47414 1.1966 0 0.76765 0.47414 1.2192 0.49671 0.42898 1.2644 0.42898zm0-3.7254q-1.8514 0-3.3415-0.51929-1.4676-0.54187-2.3255-1.5353-0.85796-1.016-0.85796-2.4384 0-1.445 0.83538-2.4836 0.83538-1.0612 2.3029-1.6482 1.4676-0.58703 3.3867-0.58703 1.9191 0 3.3867 0.58703 1.4676 0.58703 2.3029 1.6482 0.83538 1.0386 0.83538 2.4836 0 1.4224-0.85796 2.4384-0.85796 0.99343-2.3255 1.5353-1.4676 0.51929-3.3415 0.51929zm0-2.9125q0.54187 0 0.90312-0.36125 0.36125-0.36125 0.36125-0.99343 0-0.65476-0.36125-0.99343-0.36125-0.36125-0.90312-0.36125-0.54187 0-0.90312 0.36125-0.36125 0.33867-0.36125 0.99343 0 0.63218 0.36125 0.99343 0.36125 0.36125 0.90312 0.36125z"/>
|
||||
<path d="m72.554 20.666 5.9606-13.908 1.4224 2.2352h-7.4959l2.0772-2.4158v4.7188h-4.4027v-6.4347h13.524v3.2738l-5.2607 12.531z"/>
|
||||
<path d="m85.102 20.666 5.8251-7.6313-0.13547 2.9351-5.5542-7.6539h5.7574l2.7319 4.0866-2.1223 0.15804 3.0029-4.2446h5.351l-5.5767 7.4056v-2.8222l5.6896 7.7668h-5.8477l-2.8222-4.3575 2.1449 0.29351-2.9125 4.064z"/>
|
||||
<path d="m100.76 20.666 5.8251-7.6313-0.13546 2.9351-5.5542-7.6539h5.7574l2.7319 4.0866-2.1223 0.15804 3.0029-4.2446h5.351l-5.5767 7.4056v-2.8222l5.6896 7.7668h-5.8477l-2.8222-4.3575 2.1449 0.29351-2.9126 4.064z"/>
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 2.7 KiB |
|
|
@ -5,14 +5,14 @@
|
|||
|
||||
.. seo::
|
||||
:description: ESPHome Homepage - Reimagining DIY Home Automation. ESPHome is a framework that
|
||||
tries to provide the best possible use experience for using ESP8266, ESP32 and RP2040 microcontrollers
|
||||
tries to provide the best possible use experience for using IoT microcontrollers
|
||||
for Home Automation. Just write a simple YAML configuration file and get your own customized firmware.
|
||||
:image: logo.svg
|
||||
|
||||
.. image:: /images/logo-text.svg
|
||||
:class: dark-invert
|
||||
|
||||
ESPHome is a system to control your ESP8266/ESP32 and RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.
|
||||
ESPHome is a system to control your microcontrollers by simple yet powerful configuration files and control them remotely through Home Automation systems.
|
||||
|
||||
.. image:: /images/hero.png
|
||||
|
||||
|
|
@ -124,6 +124,8 @@ Platforms
|
|||
ESP8266, components/esp8266, esp8266.svg
|
||||
ESP32, components/esp32, esp32.svg
|
||||
RP2040, components/rp2040, rp2040.svg
|
||||
BK72xx, components/libretiny, bk72xx.svg
|
||||
RTL87xx, components/libretiny, rtl87xx.svg
|
||||
|
||||
Core Components
|
||||
---------------
|
||||
|
|
@ -497,6 +499,7 @@ Output Components
|
|||
GPIO Output, components/output/gpio, pin.svg, dark-invert
|
||||
ESP32 DAC, components/output/esp32_dac, dac.svg
|
||||
ESP32 LEDC, components/output/ledc, pwm.png
|
||||
LibreTiny PWM, components/output/libretiny_pwm, pwm.png
|
||||
AC Dimmer, components/output/ac_dimmer, ac_dimmer.svg, dark-invert
|
||||
PCA9685, components/output/pca9685, pca9685.jpg
|
||||
TLC59208F, components/output/tlc59208f, tlc59208f.jpg
|
||||
|
|
@ -677,6 +680,7 @@ Text Sensor Components
|
|||
Nextion Text Sensor, components/text_sensor/nextion, nextion.jpg
|
||||
Tuya Text Sensor, components/text_sensor/tuya, tuya.png
|
||||
WL-134 Pet Tag Sensor , components/text_sensor/wl_134, fingerprint.svg, dark-invert
|
||||
LibreTiny, components/text_sensor/libretiny, libretiny.svg
|
||||
|
||||
Climate Components
|
||||
------------------
|
||||
|
|
|
|||
Loading…
Reference in New Issue