da5c6ab9ae
* Add Config * Add Cache and remove pre-commit action * [pre-commit.ci lite] apply automatic fixes * Remove freeze * Fix * Update action * Use latest stable Python 3 version * Improve caching * Improve cache tag * Improve bot message * fix(typos): Fix typos * fix(typos): Fix more typos * refactor(udp_server): Convert script from Python 2 to 3 * Fix whitespace * Clang-format fixes * Prettier fixes * Black formatting * Manual fixes * Line endings * Fix flake and make Vale manual * Fix flake and reformat --------- Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Rodrigo Garcia <rodrigo.garcia@espressif.com>
78 lines
2 KiB
ReStructuredText
78 lines
2 KiB
ReStructuredText
##########
|
|
SigmaDelta
|
|
##########
|
|
|
|
About
|
|
-----
|
|
|
|
ESP32 provides a second-order sigma delta modulation module and 8 (4 for ESP32-C3)
|
|
independent modulation channels. The channels are capable to output 1-bit
|
|
signals (output index: 100 ~ 107) with sigma delta modulation.
|
|
|
|
========= =============================
|
|
ESP32 SoC Number of SigmaDelta channels
|
|
========= =============================
|
|
ESP32 8
|
|
ESP32-S2 8
|
|
ESP32-S3 8
|
|
ESP32-C3 4
|
|
ESP32-C6 4
|
|
ESP32-H2 4
|
|
========= =============================
|
|
|
|
Arduino-ESP32 SigmaDelta API
|
|
----------------------------
|
|
|
|
sigmaDeltaAttach
|
|
****************
|
|
|
|
This function is used to set up the SigmaDelta channel with the selected frequency and attach it to the selected pin.
|
|
|
|
.. code-block:: arduino
|
|
|
|
bool sigmaDeltaAttach(uint8_t pin, uint32_t freq);
|
|
|
|
* ``pin`` select GPIO pin.
|
|
* ``freq`` select frequency.
|
|
|
|
* range is 1-14 bits (1-20 bits for ESP32).
|
|
|
|
This function returns ``true`` if the configuration was successful.
|
|
If ``false`` is returned, an error occurred and the SigmaDelta channel was not configured.
|
|
|
|
sigmaDeltaWrite
|
|
***************
|
|
|
|
This function is used to set duty for the SigmaDelta pin.
|
|
|
|
.. code-block:: arduino
|
|
|
|
bool sigmaDeltaWrite(uint8_t pin, uint8_t duty);
|
|
|
|
* ``pin`` selects the GPIO pin.
|
|
* ``duty`` selects the duty to be set for selected pin.
|
|
|
|
This function returns ``true`` if setting the duty was successful.
|
|
If ``false`` is returned, error occurs and duty was not set.
|
|
|
|
sigmaDeltaDetach
|
|
****************
|
|
|
|
This function is used to detach a pin from SigmaDelta and deinitialize the channel that was attached to the pin.
|
|
|
|
.. code-block:: arduino
|
|
|
|
bool sigmaDeltaDetach(uint8_t pin);
|
|
|
|
* ``pin`` select GPIO pin.
|
|
|
|
This function returns ``true`` if detaching was successful.
|
|
If ``false`` is returned, an error occurred and pin was not detached.
|
|
|
|
Example Applications
|
|
********************
|
|
|
|
Here is example use of SigmaDelta:
|
|
|
|
.. literalinclude:: ../../../libraries/ESP32/examples/AnalogOut/SigmaDelta/SigmaDelta.ino
|
|
:language: arduino
|