SigmaDelta - - — Arduino ESP32 latest documentation (original) (raw)

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.

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.

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.

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.

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:

void setup() { //setup on pin 18 with frequency 312500 Hz sigmaDeltaAttach(18, 312500); //set pin 18 to off sigmaDeltaWrite(18, 0); }

void loop() { //slowly ramp-up the value //will overflow at 256 static uint8_t i = 0; sigmaDeltaWrite(18, i++); delay(100); }