# ESP32 - Complex Waveform Generator V3

#### Installing and Using the ESP32 Complex Waveform Generator V3 Application

Screenshot of web interface

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 136.049%; height: 506px;"><tbody><tr><td style="width: 50.0567%;">[![image-1683400232715.png](https://stanslegacy.com/uploads/images/gallery/2023-05/scaled-1680-/MX4zLcrWYrUJauHX-image-1683400232715.png)](https://stanslegacy.com/uploads/images/gallery/2023-05/MX4zLcrWYrUJauHX-image-1683400232715.png)</td><td style="width: 50.0567%;">[![342755495_606076878142350_7100434860017235921_n.png](https://stanslegacy.com/uploads/images/gallery/2023-05/scaled-1680-/G1uYZlR7805tiMpU-342755495-606076878142350-7100434860017235921-n.png)](https://stanslegacy.com/uploads/images/gallery/2023-05/G1uYZlR7805tiMpU-342755495-606076878142350-7100434860017235921-n.png)</td></tr></tbody></table>

### Prerequisites

To use this application, you need to have the Arduino IDE installed on your computer. You can download the Arduino IDE from the official website: [https://www.arduino.cc/en/software](https://www.arduino.cc/en/software)

1. **ESP32 Development Board**: You'll need an ESP32 development board, such as the popular ESP32-DevKitC or ESP32-WROOM-32D. These boards typically come with Wi-Fi and Bluetooth capabilities and a variety of GPIO pins for interfacing with peripherals.
2. **Rotary Encoders**: To adjust the waveform parameters, you will need a total of 7 rotary encoders. You can use KY-040 rotary encoder modules or any other type of incremental rotary encoder with built-in push buttons. Ensure that the rotary encoders you choose have a CLK, DT, and SW (push button) pinout.
3. **Breadboard and Jumper Wires**: A breadboard and jumper wires are required to make the necessary connections between the ESP32 development board and the rotary encoders.
4. **Power Supply**: You will need a power supply to power the ESP32 development board. This can be a USB power supply, a battery, or any other suitable power source that meets the board's voltage and current requirements, such an ATX Supply from a computer. 5VDC 1A minimum is recommended to prevent brownout conditions while interacting with a driver circuit.
5. **Oscilloscope (optional)**: To visualize the generated waveform, you can use an oscilloscope. Connect the output pins (channel1OutputPin and channel2OutputPin) from the ESP32 development board to the oscilloscope's input channels.

#### Installing required libraries

<div class="flex flex-grow flex-col gap-3" id="bkmrk-arduinojson%3A-to-inst"><div class="flex flex-grow flex-col gap-3"><div class="min-h-[20px] flex flex-col items-start gap-4 whitespace-pre-wrap break-words"><div class="markdown prose w-full break-words dark:prose-invert dark">1. **ArduinoJson**: To install the ArduinoJson library, follow these steps: a. Open the Arduino IDE. b. Click on `Tools` in the menu bar, then `Manage Libraries`. c. In the Library Manager window, search for "ArduinoJson" in the search bar. d. Find "ArduinoJson by Benoit Blanchon" in the search results and click on the `Install` button.
2. **ESP32Encoder**: To install the ESP32Encoder library, follow these steps: a. Open the Arduino IDE. b. Click on `Tools` in the menu bar, then `Manage Libraries`. c. In the Library Manager window, search for "ESP32Encoder" in the search bar. d. Find "ESP32Encoder by Gil Mora" in the search results and click on the `Install` button.

</div></div></div></div>#### Uploading the Application

<div class="flex flex-grow flex-col gap-3" id="bkmrk-download-the-source-"><div class="flex flex-grow flex-col gap-3"><div class="min-h-[20px] flex flex-col items-start gap-4 whitespace-pre-wrap break-words"><div class="markdown prose w-full break-words dark:prose-invert dark">1. Download the source code for the [ESP32 Complex Waveform Generator V3](https://bitbucket.org/cbake6807/esp32-complex-waveform-generator-v3/src/master/) application or copy it to a new file in the Arduino IDE.
2. Connect the ESP32 development board to your computer using a USB cable.
3. In the Arduino IDE, select the appropriate board and port under `Tools` &gt; `Board` and `Tools` &gt; `Port`.
4. Click on the `Upload` button (right-facing arrow icon) in the Arduino IDE to compile and upload the application to the ESP32 development board.

</div></div></div></div>#### Hardware Setup

<div class="flex flex-grow flex-col gap-3" id="bkmrk-wire-the-rotary-enco"><div class="flex flex-grow flex-col gap-3"><div class="min-h-[20px] flex flex-col items-start gap-4 whitespace-pre-wrap break-words"><div class="markdown prose w-full break-words dark:prose-invert dark">1. Wire the rotary encoders and other components according to the pin assignments defined in the source code. <table style="height: 498px; width: 100.057%;"><thead><tr><th style="width: 33.2698%;">ESP32 Pin</th><th style="width: 33.2698%;">Encoder Connection</th><th style="width: 33.2698%;">Encoder Function</th></tr></thead><tbody><tr><td style="width: 33.2698%;">14</td><td style="width: 33.2698%;">Pulse Encoder CLK</td><td style="width: 33.2698%;">Pulse count</td></tr><tr><td style="width: 33.2698%;">13</td><td style="width: 33.2698%;">Pulse Encoder DT</td><td style="width: 33.2698%;">Pulse count</td></tr><tr><td style="width: 33.2698%;">35</td><td style="width: 33.2698%;">Width Encoder CLK</td><td style="width: 33.2698%;">Pulse width</td></tr><tr><td style="width: 33.2698%;">34</td><td style="width: 33.2698%;">Width Encoder DT</td><td style="width: 33.2698%;">Pulse width</td></tr><tr><td style="width: 33.2698%;">19</td><td style="width: 33.2698%;">Spacing Encoder CLK</td><td style="width: 33.2698%;">Pulse spacing</td></tr><tr><td style="width: 33.2698%;">18</td><td style="width: 33.2698%;">Spacing Encoder DT</td><td style="width: 33.2698%;">Pulse spacing</td></tr><tr><td style="width: 33.2698%;">23</td><td style="width: 33.2698%;">Off-time Encoder CLK</td><td style="width: 33.2698%;">Off-time</td></tr><tr><td style="width: 33.2698%;">22</td><td style="width: 33.2698%;">Off-time Encoder DT</td><td style="width: 33.2698%;">Off-time</td></tr><tr><td style="width: 33.2698%;">27</td><td style="width: 33.2698%;">Width Mod Encoder CLK</td><td style="width: 33.2698%;">Width modifier</td></tr><tr><td style="width: 33.2698%;">26</td><td style="width: 33.2698%;">Width Mod Encoder DT</td><td style="width: 33.2698%;">Width modifier</td></tr><tr><td style="width: 33.2698%;">15</td><td style="width: 33.2698%;">Spacing Mod Encoder CLK</td><td style="width: 33.2698%;">Spacing modifier</td></tr><tr><td style="width: 33.2698%;">32</td><td style="width: 33.2698%;">Spacing Mod Encoder DT</td><td style="width: 33.2698%;">Spacing modifier</td></tr><tr><td style="width: 33.2698%;">33</td><td style="width: 33.2698%;">Off-time Mod Encoder CLK</td><td style="width: 33.2698%;">Off-time modifier</td></tr><tr><td style="width: 33.2698%;">4  
    </td><td style="width: 33.2698%;">Off-time Mod Encoder DT</td><td style="width: 33.2698%;">Off-time modifier</td></tr><tr><td style="width: 33.2698%;">2</td><td style="width: 33.2698%;">Output Channel 1</td><td style="width: 33.2698%;">Output waveform</td></tr><tr><td style="width: 33.2698%;">5</td><td style="width: 33.2698%;">Output Channel 2</td><td style="width: 33.2698%;">Output waveform</td></tr></tbody></table>
2. Make sure the connections are secure and verify the CLK/DT pins for each encoder are wired correctly, and that each encoder turns in the correct direction relative to the respective parameter change.

</div></div></div></div>#### Using the Application

<div class="flex flex-grow flex-col gap-3" id="bkmrk-power-on-the-esp32-d"><div class="flex flex-grow flex-col gap-3"><div class="flex flex-grow flex-col gap-3"><div class="min-h-[20px] flex flex-col items-start gap-4 whitespace-pre-wrap break-words"><div class="markdown prose w-full break-words dark:prose-invert dark">1. Power on the ESP32 development board.
2. Use the rotary encoders to adjust the following parameters: 
    - Pulse count
    - Pulse width
    - Pulse spacing
    - Off-time
    - Width modifier
    - Spacing modifier
    - Off-time modifier
3. The application will generate a complex waveform based on the adjusted parameters.
4. Connect the output pins (channel1OutputPin and channel2OutputPin) to an oscilloscope to visualize the generated waveform.
5. Open the WebApp/index.html page in a browser.
6. Fine-tune the parameters using the rotary encoders to achieve the desired waveform shape and characteristics.

</div></div></div></div></div>#### Next Steps For Utilization

<div class="flex flex-grow flex-col gap-3" id="bkmrk-build-esp32-cwg---vi"><div class="flex flex-grow flex-col gap-3"><div class="min-h-[20px] flex flex-col items-start gap-4 whitespace-pre-wrap break-words"><div class="markdown prose w-full break-words dark:prose-invert dark">- Build ESP32 CWG - VIC Driver circuit(s) - [https://stanslegacy.com/books/chris-bake/page/esp32-cwg-driver-amplification](https://stanslegacy.com/books/chris-bake/page/esp32-cwg-driver-amplification)
- Cell Construction - [https://stanslegacy.com/books/ethan-crowder/page/resonant-cavity-related](https://stanslegacy.com/books/ethan-crowder/page/resonant-cavity-related)

</div></div></div></div>#### Troubleshooting

<div class="flex flex-grow flex-col gap-3" id="bkmrk-if-the-waveform-does"><div class="flex flex-grow flex-col gap-3"><div class="min-h-[20px] flex flex-col items-start gap-4 whitespace-pre-wrap break-words"><div class="markdown prose w-full break-words dark:prose-invert dark">1. If the waveform does not match the expected output, verify the wiring connections and ensure the rotary encoders are functioning correctly.
2. If the application does not upload to the ESP32 development board, double-check the board and port selection in the Arduino IDE.
3. If the rotary encoders behave unexpectedly (e.g., adjusting one parameter affects another), check the CLK/DT pin assignments and wiring.
4. Click the PInout button to fetch the currently defined GPIO pins from the ESP32 directly and confirm they are wired correctly.
    
    [![image-1683400997931.png](https://stanslegacy.com/uploads/images/gallery/2023-05/scaled-1680-/0KZXcho6wJLP4Onh-image-1683400997931.png)](https://stanslegacy.com/uploads/images/gallery/2023-05/0KZXcho6wJLP4Onh-image-1683400997931.png)

</div></div></div></div>For further assistance or to report any issues, contact the application's support team or refer to the community forums.