76 lines
2.4 KiB
ReStructuredText
76 lines
2.4 KiB
ReStructuredText
ESP8266 Software PWM Output
|
|
===========================
|
|
|
|
.. seo::
|
|
:description: Instructions for setting up ESP8266 software-based PWMs.
|
|
:image: pwm.png
|
|
|
|
The ESP8266 Software PWM platform allows you to use a software PWM on
|
|
the pins GPIO0-GPIO16 on your ESP8266. Note that this is a software PWM,
|
|
so there can be some flickering during periods of high WiFi activity. Hardware PWMs
|
|
like the one on the ESP32 (see :doc:`ledc`) are preferred.
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Example configuration entry
|
|
output:
|
|
- platform: esp8266_pwm
|
|
pin: GPIOXX
|
|
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>`.
|
|
|
|
.. note::
|
|
|
|
If you previously had Tasmota installed on your device and have just flashed ESPHome onto it,
|
|
you may encounter an issue where the PWM output is only fully on or off.
|
|
|
|
A hard reset fixes the problem - if you have this issue please power cycle the device, that
|
|
should fix it.
|
|
|
|
.. _output-esp8266_pwm-set_frequency_action:
|
|
|
|
``output.esp8266_pwm.set_frequency`` Action
|
|
-------------------------------------------
|
|
|
|
This :ref:`Action <config-action>` allows you to manually change the frequency of an ESP8266 PWM
|
|
channel at runtime. Use cases include controlling a passive buzzer (for pitch control).
|
|
|
|
.. code-block:: yaml
|
|
|
|
on_...:
|
|
- output.esp8266_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/output/index`
|
|
- :doc:`/components/output/ledc`
|
|
- :doc:`/components/light/monochromatic`
|
|
- :doc:`/components/fan/speed`
|
|
- :doc:`/components/power_supply`
|
|
- :apiref:`esp8266_pwm/esp8266_pwm.h`
|
|
- :ghedit:`Edit`
|