From 501220d8280c4c2a387b90bc2c98d9dce22a8cbb Mon Sep 17 00:00:00 2001 From: Matt Date: Mon, 15 Dec 2025 00:44:12 +0000 Subject: [PATCH] Update README.md --- README.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 96304ed..976b820 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,8 @@ ## Overview ESP-Scope is a web-based oscilloscope built using the ESP-IDF framework. It allows users to visualize analog signals in real-time through a web browser. The project leverages the ESP32's ADC capabilities and serves a web interface for signal visualization. It contains complete source code and 3D design for a case for the Seeed XIAO ESP32C6. +This project was written in part to test AI code generators and see if they're any good. Much of the code was written by Google Antigravity using Gemini 3, with refinements, hints and top and overall design specified by a human. The whole app was up and running a few hours and finished, including 3D design in a weekend. + ![esp-scope](screenshot.png) ## Features @@ -10,6 +12,7 @@ ESP-Scope is a web-based oscilloscope built using the ESP-IDF framework. It allo - Adjustable sample rate (1-83333 Hz) and attenuation. - Crosshair functionality for precise measurements. - Adjustable trigger level. +- Test signal generation. - Reset functionality to clear settings and reload the interface. - Power off from the browser. @@ -33,7 +36,7 @@ ESP-Scope is a web-based oscilloscope built using the ESP-IDF framework. It allo ### Building and Flashing -If you have the esp-idf VSCode extension, just click on the flame to build, flash & monitor. Use the config settings for "espScope" to specify GPIO pins for the LED & "AP-Mode" button, and if necessary and board-specific setup file (one provided for the Seeed Studio XIAO ESP32C6). +If you have the esp-idf VSCode extension, just click on the flame to build, flash & monitor. Use the config settings for "espScope" to specify GPIO pins for the LED & "AP-Mode" button, and if necessary a board-specific setup file (one is provided for the Seeed Studio XIAO ESP32C6 to enable the internal ceramic antenna). 1. Set up the ESP-IDF environment: ```bash @@ -59,11 +62,11 @@ If you have the esp-idf VSCode extension, just click on the flame to build, flas ### Accessing the Web Interface -If your DHCP server supports it, the app sets its hostname and you can just navigate to http://esp-scope (you may have/need a default domain extension) +If your DHCP server supports it (most seem to), the app sets its hostname and you can just navigate to http://esp-scope (you may have/need a default domain extension) 1. After flashing, ESP-SCOPE will start as a WiFi access point. Connect to it to access the UI. 2. If desired, click the "WiFi" button and set your SSID & WiFi password. The device will reboot and join your network. Pressing and holding the GPIO "AP-Mode" button will erase the WiFi credentials and return to Access Point mode. -3. Open a web browser and navigate to "http://esp-scope" (you may have/need a default domain extension) +3. Open a web browser and navigate to "http://esp-scope" (you may have/need a default domain extension). 4. Use the web interface to: - Adjust settings like sample rate, attenuation & the test signal frequency. - Visualize signals in real-time. @@ -73,11 +76,11 @@ If your DHCP server supports it, the app sets its hostname and you can just navi ### Attaching hardware -The displayed signal is sampled from ADC0. The test signal is output on D1. The default GPIOs for the LED and "AP-Mode" button are 15 and 9 respectively (hardwired on an Seeed XIAO ESP32C6 to the yellow LED and "Boot" button). +The displayed signal is sampled from ADC0. The test signal is output on D1. The default GPIOs for the LED and "AP-Mode" button are 15 and 9 respectively (hard-wired on an Seeed XIAO ESP32C6 to the yellow LED and "Boot" button). ## 3D design -The 3D design is a two part case with space for a AA-battery (Li-poly 3.7, which can connect directly to a Seeed XIAO ESP device) clips and holes for the USB-C connector and "ground", "signal" and "test" connections using standard 2.54mm pitch, easily cut from jumpers and soldered directly to the Seeed XIAO. The design was done using Fusion 360. +The 3D design is a two part case with space for a AA-battery (Li-poly 3.7v, which can connect directly to a Seeed XIAO ESP device) clips and holes for the USB-C connector and "ground", "signal" and "test" connections using standard 2.54mm pitch, easily cut from jumpers and soldered directly to the Seeed XIAO. The 3D design was done using Fusion 360 and printed on a Bambu Labs A1 Mini in 30 minutes. ![esp-scope](esp-scope-3d.jpg) @@ -86,6 +89,4 @@ This project is licensed under the MIT License. See the LICENSE file for details ## Acknowledgments - Built using the ESP-IDF framework by Espressif Systems. -- Inspired by the need for affordable and accessible signal visualization tools. - -This project was written in part to test AI code generators. Much of the code was written by Google Antigravity using Gemini 3, with refinements, hints and top and overall design specified by a human. The whole app was up and running a few hours and finished, including 3D design in a weekend. +- Gemini 3.