From a759c6fa010701a9d149e97165993f80bdcd5118 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 22:18:49 -0700 Subject: [PATCH 01/46] Add files via upload --- content/tutorials/TEMPLATE.md | 107 ++++++++++++++++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 content/tutorials/TEMPLATE.md diff --git a/content/tutorials/TEMPLATE.md b/content/tutorials/TEMPLATE.md new file mode 100644 index 00000000..298d19c3 --- /dev/null +++ b/content/tutorials/TEMPLATE.md @@ -0,0 +1,107 @@ +--- +title: My Super Awesome Tutorial +date: 1970-01-01 +authors: + - name: John Doe + - name: Mary Jane +--- + +![relevant graphic or workshop logo](image/path) + +## Introduction + +Write a short section on what the tutorial is aiming to accomplish. +What is the motivation behind the tutorial? +What do you want readers to gain from the tutorial? + +### Learning Objectives + +- Bullet list of skills/concepts to be covered + +Any additional notes from the developers can be included here. + +### Background Information + +Describe your topic here. What does it do? Why do you use it? +Are there other similar things to use? What are the pros and cons? +Explain important concepts that are necessary to understand. +Include (and cite if needed) any visuals that will help the audience understand. + +## Getting Started + +For any software prerequisites, write a simple excerpt on each +technology the participant will be expecting to download and install. +Aim to demystify the technologies being used and explain any design +decisions that were taken. Walk through the installation processes +in detail. Be aware of any operating system differences. +For hardware prerequisites, list all the necessary components that +the participant will receive. A table showing component names and +quantities should suffice. Link any reference sheets or guides that +the participant may need. +The following are stylistic examples of possible prerequisites, +customize these for each workshop. + +### Required Downloads and Installations + +List any required downloads and installations here. +Make sure to include tutorials on how to install them. +You can either make your own tutorials or include a link to them. + +### Required Components + +List your required hardware components and the quantities here. + +| Component Name | Quanitity | +| -------------- | --------- | +| | | +| | | + +### Required Tools and Equipment + +List any tools and equipment you need here. +(Ex, computer, soldering station, etc.) + +## Part 01: Name + +### Introduction + +Briefly introduce what you are teaching in this section. + +### Objective + +- List the learning objectives of this section + +### Background Information + +Give a brief explanation of the technical skills learned/needed +in this challenge. There is no need to go into detail as a +separation document should be prepared to explain more in depth +about the technical skills + +### Components + +- List the components needed in this challenge + +### Instructional + +Teach the contents of this section + +## Example + +### Introduction + +Introduce the example that you are showing here. + +### Example + +Present the example here. Include visuals to help better understanding + +### Analysis + +Explain how the example used your tutorial topic. Give in-depth analysis of each part and show your understanding of the tutorial topic + +## Additional Resources + +### Useful links + +List any sources you used, documentation, helpful examples, similar projects etc. From c0a85a172415cfbee73792807d1ee9519a09ffe0 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 22:24:22 -0700 Subject: [PATCH 02/46] Update TEMPLATE.md --- content/tutorials/TEMPLATE.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/tutorials/TEMPLATE.md b/content/tutorials/TEMPLATE.md index 298d19c3..95702104 100644 --- a/content/tutorials/TEMPLATE.md +++ b/content/tutorials/TEMPLATE.md @@ -2,8 +2,7 @@ title: My Super Awesome Tutorial date: 1970-01-01 authors: - - name: John Doe - - name: Mary Jane + - name: Jasmine Le --- ![relevant graphic or workshop logo](image/path) From 2c5b4a9adf6fc623e1885690618fc0169c46beab Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 22:27:50 -0700 Subject: [PATCH 03/46] Update TEMPLATE.md --- content/tutorials/TEMPLATE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/TEMPLATE.md b/content/tutorials/TEMPLATE.md index 95702104..fe173568 100644 --- a/content/tutorials/TEMPLATE.md +++ b/content/tutorials/TEMPLATE.md @@ -1,6 +1,6 @@ --- title: My Super Awesome Tutorial -date: 1970-01-01 +date: 2025-19-05 authors: - name: Jasmine Le --- From be4a3f1f64f81cf80b7d6b30c308ecc79533fe74 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:03:31 -0700 Subject: [PATCH 04/46] Update TEMPLATE.md --- content/tutorials/TEMPLATE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/TEMPLATE.md b/content/tutorials/TEMPLATE.md index fe173568..113a40c8 100644 --- a/content/tutorials/TEMPLATE.md +++ b/content/tutorials/TEMPLATE.md @@ -1,5 +1,5 @@ --- -title: My Super Awesome Tutorial +title: ESP32 WiFi Scanner date: 2025-19-05 authors: - name: Jasmine Le From 3171a6659d95a1c3cc0368566444c5f1c7f82f4c Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:05:32 -0700 Subject: [PATCH 05/46] Rename TEMPLATE.md to WiFiScanner.md --- content/tutorials/{TEMPLATE.md => WiFiScanner.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename content/tutorials/{TEMPLATE.md => WiFiScanner.md} (100%) diff --git a/content/tutorials/TEMPLATE.md b/content/tutorials/WiFiScanner.md similarity index 100% rename from content/tutorials/TEMPLATE.md rename to content/tutorials/WiFiScanner.md From a9ad3c2a383503056e3d61285656b9757ff659a8 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:15:27 -0700 Subject: [PATCH 06/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 113a40c8..94fe9bbf 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -15,7 +15,9 @@ What do you want readers to gain from the tutorial? ### Learning Objectives -- Bullet list of skills/concepts to be covered +- Understand how the ESP32 performs Wi-Fi network scans +- Learn how to use the Serial Monitor to display data +- Explore `WiFi.h` library functions and network properties Any additional notes from the developers can be included here. From cfeef9b5b852b1160ee7fb4e71b7c023d5ad1285 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:20:20 -0700 Subject: [PATCH 07/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 94fe9bbf..74c34e2e 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -13,6 +13,9 @@ Write a short section on what the tutorial is aiming to accomplish. What is the motivation behind the tutorial? What do you want readers to gain from the tutorial? +This tutorial walks through building a simple **Wi-Fi scanner** using only the **ESP32 Dev Board**. +The project scans for nearby Wi-Fi networks and displays their names and signal strengths through the Serial Monitor. + ### Learning Objectives - Understand how the ESP32 performs Wi-Fi network scans From 42478932174738087096e33664631aa3748341ce Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:21:00 -0700 Subject: [PATCH 08/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 74c34e2e..ca747ec1 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -9,10 +9,6 @@ authors: ## Introduction -Write a short section on what the tutorial is aiming to accomplish. -What is the motivation behind the tutorial? -What do you want readers to gain from the tutorial? - This tutorial walks through building a simple **Wi-Fi scanner** using only the **ESP32 Dev Board**. The project scans for nearby Wi-Fi networks and displays their names and signal strengths through the Serial Monitor. From 6e427a532ccd08eec6e5472cf7725181d1eaa01f Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:40:25 -0700 Subject: [PATCH 09/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index ca747ec1..bfc0d017 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -5,7 +5,8 @@ authors: - name: Jasmine Le --- -![relevant graphic or workshop logo](image/path) +![relevant graphic or workshop logo](imag![esp32beginimage](https://github.com/user-attachments/assets/3c0e92ed-89ed-4ea6-887e-c67e81da1bf5) +e/path) ## Introduction From 4e4ba4d4d289c38a07b38c161c542318eb185a79 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:41:15 -0700 Subject: [PATCH 10/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index bfc0d017..5ded8972 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -5,7 +5,7 @@ authors: - name: Jasmine Le --- -![relevant graphic or workshop logo](imag![esp32beginimage](https://github.com/user-attachments/assets/3c0e92ed-89ed-4ea6-887e-c67e81da1bf5) +(imag![esp32beginimage](https://github.com/user-attachments/assets/3c0e92ed-89ed-4ea6-887e-c67e81da1bf5) e/path) ## Introduction From 969566075f68f23e66b9a304227bd71ad5201571 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:46:03 -0700 Subject: [PATCH 11/46] Update WiFiScanner.md From 87d71d579572d572fe09f7b54820003088673f77 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:48:36 -0700 Subject: [PATCH 12/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 5ded8972..afb74472 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -4,9 +4,9 @@ date: 2025-19-05 authors: - name: Jasmine Le --- +![esp32wifitop](https://github.com/user-attachments/assets/34787a73-4880-49aa-9bcc-420d115f39c9) -(imag![esp32beginimage](https://github.com/user-attachments/assets/3c0e92ed-89ed-4ea6-887e-c67e81da1bf5) -e/path) +![relevant graphic or workshop logo](image/path) ## Introduction From d1c2c6d0e70af0905669e9470af8352c4a984756 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Mon, 19 May 2025 23:48:50 -0700 Subject: [PATCH 13/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index afb74472..66d63d00 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -6,8 +6,6 @@ authors: --- ![esp32wifitop](https://github.com/user-attachments/assets/34787a73-4880-49aa-9bcc-420d115f39c9) -![relevant graphic or workshop logo](image/path) - ## Introduction This tutorial walks through building a simple **Wi-Fi scanner** using only the **ESP32 Dev Board**. From 19973e6bf866da816f1b42ebdf4d78977833ae35 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 18:45:53 -0700 Subject: [PATCH 14/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 66d63d00..94a44b84 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -11,6 +11,10 @@ authors: This tutorial walks through building a simple **Wi-Fi scanner** using only the **ESP32 Dev Board**. The project scans for nearby Wi-Fi networks and displays their names and signal strengths through the Serial Monitor. +This tutorial will show you how to use an **ESP32 Dev Board** to scan for Wi-Fi networks and display them in both the Arduino Serial Monitor and (optionally) on a simple web server. +By the end, you’ll know how to set up your board, write and upload code, and understand how Wi-Fi scanning works on the ESP32—even if you’re new to Arduino! + + ### Learning Objectives - Understand how the ESP32 performs Wi-Fi network scans From 1031b4f861d243e565a8aada67c9705aa14b6dfe Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 18:50:56 -0700 Subject: [PATCH 15/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 94a44b84..c0e19508 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -8,12 +8,7 @@ authors: ## Introduction -This tutorial walks through building a simple **Wi-Fi scanner** using only the **ESP32 Dev Board**. -The project scans for nearby Wi-Fi networks and displays their names and signal strengths through the Serial Monitor. - -This tutorial will show you how to use an **ESP32 Dev Board** to scan for Wi-Fi networks and display them in both the Arduino Serial Monitor and (optionally) on a simple web server. -By the end, you’ll know how to set up your board, write and upload code, and understand how Wi-Fi scanning works on the ESP32—even if you’re new to Arduino! - +This tutorial walks through building a simple **Wi-Fi scanner** using a **ESP32 Dev Board** you have created and a USB-C cable. It will then display them in both the Arduino Serial Monitor and on a simple web server, which this tutorial will walk you through. The project scans for nearby Wi-Fi networks and displays their names and signal strengths through the Serial Monitor. By the end, you’ll know how to set up your board, write and upload code, and understand how Wi-Fi scanning works on the ESP32! ### Learning Objectives From 9803ec34ffecafddc24d944dab584ed74780fe6f Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 18:52:39 -0700 Subject: [PATCH 16/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index c0e19508..8dc4d7bc 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -13,8 +13,11 @@ This tutorial walks through building a simple **Wi-Fi scanner** using a **ESP32 ### Learning Objectives - Understand how the ESP32 performs Wi-Fi network scans -- Learn how to use the Serial Monitor to display data -- Explore `WiFi.h` library functions and network properties +- Set up Arduino IDE and connect your ESP32 +- Learn how to use the Serial Monitor to display data as well as on a web server +- Explore `WiFi.h` library functions and network properties to scan for Wi-Fi networks +- Understand 2.4 GHz vs. 5 GHz Wi-Fi limitations +- Make your ESP32 create its own Wi-Fi for demonstration Any additional notes from the developers can be included here. From 33009f32a070a852e11f47c67191852bf7016f40 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 18:53:08 -0700 Subject: [PATCH 17/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 8dc4d7bc..944a0a29 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -19,8 +19,6 @@ This tutorial walks through building a simple **Wi-Fi scanner** using a **ESP32 - Understand 2.4 GHz vs. 5 GHz Wi-Fi limitations - Make your ESP32 create its own Wi-Fi for demonstration -Any additional notes from the developers can be included here. - ### Background Information Describe your topic here. What does it do? Why do you use it? From 4b3f5e1f043cd005401aeed4a63b8369e988e1ff Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 18:56:36 -0700 Subject: [PATCH 18/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 944a0a29..f020c186 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -26,6 +26,11 @@ Are there other similar things to use? What are the pros and cons? Explain important concepts that are necessary to understand. Include (and cite if needed) any visuals that will help the audience understand. +The ESP32 is a popular microcontroller with built-in Wi-Fi. +By scanning for nearby networks, you can learn about radio environments, understand Wi-Fi security, and practice displaying real-world data in your code. +**Note:** The ESP32 can only scan 2.4 GHz Wi-Fi networks, not 5 GHz networks (which is why some campus networks and personal hotspots may not appear if *Maximize Compatibility* is not enabled). + + ## Getting Started For any software prerequisites, write a simple excerpt on each From b1038ce202893f0ab6e76a10f348f712299c995d Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 19:00:08 -0700 Subject: [PATCH 19/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index f020c186..83cbbd22 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -20,15 +20,9 @@ This tutorial walks through building a simple **Wi-Fi scanner** using a **ESP32 - Make your ESP32 create its own Wi-Fi for demonstration ### Background Information - -Describe your topic here. What does it do? Why do you use it? -Are there other similar things to use? What are the pros and cons? -Explain important concepts that are necessary to understand. -Include (and cite if needed) any visuals that will help the audience understand. - The ESP32 is a popular microcontroller with built-in Wi-Fi. By scanning for nearby networks, you can learn about radio environments, understand Wi-Fi security, and practice displaying real-world data in your code. -**Note:** The ESP32 can only scan 2.4 GHz Wi-Fi networks, not 5 GHz networks (which is why some campus networks and personal hotspots may not appear if *Maximize Compatibility* is not enabled). +**Note:** The ESP32 can only scan 2.4 GHz Wi-Fi networks, not 5 GHz networks (which is why some campus networks and personal hotspots may not appear if **Maximize Compatibility** is not enabled). ## Getting Started From 1553b129b635ce7eb95c1625eaca0c93a5996b91 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 19:50:37 -0700 Subject: [PATCH 20/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 83cbbd22..8833c82c 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -45,6 +45,16 @@ List any required downloads and installations here. Make sure to include tutorials on how to install them. You can either make your own tutorials or include a link to them. + - The main environment for writing and uploading code to your ESP32. +- **ESP32 Board Package for Arduino IDE** + 1. Open Arduino IDE → *Preferences*. + 2. In “Additional Board Manager URLs” add: + ``` + https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json + ``` + 3. Go to *Tools > Board > Boards Manager* and search for “ESP32”. + Click **Install**. + ### Required Components List your required hardware components and the quantities here. From 24514877cb04634c034b7bf7fcd0b602193baef2 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 19:55:12 -0700 Subject: [PATCH 21/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 8833c82c..f8ad09b1 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -40,12 +40,8 @@ The following are stylistic examples of possible prerequisites, customize these for each workshop. ### Required Downloads and Installations - -List any required downloads and installations here. -Make sure to include tutorials on how to install them. -You can either make your own tutorials or include a link to them. - - - The main environment for writing and uploading code to your ESP32. +[Arduino IDE](https://www.arduino.cc/en/software) +- Arduino is the main environment for writing and uploading code to your ESP32. - **ESP32 Board Package for Arduino IDE** 1. Open Arduino IDE → *Preferences*. 2. In “Additional Board Manager URLs” add: From 9968e08a371bb4d8c5ae457afd6b3b319af09a52 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 19:55:54 -0700 Subject: [PATCH 22/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index f8ad09b1..224b07d6 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -40,7 +40,9 @@ The following are stylistic examples of possible prerequisites, customize these for each workshop. ### Required Downloads and Installations + [Arduino IDE](https://www.arduino.cc/en/software) + - Arduino is the main environment for writing and uploading code to your ESP32. - **ESP32 Board Package for Arduino IDE** 1. Open Arduino IDE → *Preferences*. From 7187d602d3a4620b101788d314488772625e23d5 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 20:01:28 -0700 Subject: [PATCH 23/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 13 +------------ 1 file changed, 1 insertion(+), 12 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 224b07d6..2bc598d9 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -26,18 +26,7 @@ By scanning for nearby networks, you can learn about radio environments, underst ## Getting Started - -For any software prerequisites, write a simple excerpt on each -technology the participant will be expecting to download and install. -Aim to demystify the technologies being used and explain any design -decisions that were taken. Walk through the installation processes -in detail. Be aware of any operating system differences. -For hardware prerequisites, list all the necessary components that -the participant will receive. A table showing component names and -quantities should suffice. Link any reference sheets or guides that -the participant may need. -The following are stylistic examples of possible prerequisites, -customize these for each workshop. +You should have Arduino IDE installed on your device, Please do so if you haven't (link down below). This is all you need in terms of a software application that is both Mac and Windows supported. You will then use the ESP32 that you have assembled to use for wireless communication on the Wifi Scan tutorial we will be going through. ### Required Downloads and Installations From ae6477fcabee8827459bad5c96bb203ea0c12781 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 20:24:12 -0700 Subject: [PATCH 24/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 2bc598d9..06a1102f 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -48,8 +48,8 @@ List your required hardware components and the quantities here. | Component Name | Quanitity | | -------------- | --------- | -| | | -| | | +| ESP32 Dev Board (S3, C3, or classic) | 1 | +| USB-C or Micro-USB Cable (for your board) | 1 | ### Required Tools and Equipment From 6d931213b8aefa33666494dc12632f05cbac5edb Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 20:24:37 -0700 Subject: [PATCH 25/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 06a1102f..55a307b9 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -48,7 +48,7 @@ List your required hardware components and the quantities here. | Component Name | Quanitity | | -------------- | --------- | -| ESP32 Dev Board (S3, C3, or classic) | 1 | +| ESP32 Dev Board | 1 | | USB-C or Micro-USB Cable (for your board) | 1 | ### Required Tools and Equipment From a5aa2081acc44b68e48f7825c2171f3a839cbb67 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 20:25:26 -0700 Subject: [PATCH 26/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 55a307b9..8aa578a0 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -49,7 +49,7 @@ List your required hardware components and the quantities here. | Component Name | Quanitity | | -------------- | --------- | | ESP32 Dev Board | 1 | -| USB-C or Micro-USB Cable (for your board) | 1 | +| USB-C Cable | 1 | ### Required Tools and Equipment From 1e3da420a75925da8aa04ed067ba5d181b186278 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 20:25:54 -0700 Subject: [PATCH 27/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 8aa578a0..d77fcc71 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -54,7 +54,8 @@ List your required hardware components and the quantities here. ### Required Tools and Equipment List any tools and equipment you need here. -(Ex, computer, soldering station, etc.) +- Computer (Windows, Mac, or Linux) +- Arduino IDE installed ## Part 01: Name From 7ec20403a919486081c59a09618880407a39a422 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 20:48:30 -0700 Subject: [PATCH 28/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index d77fcc71..aab0736e 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -42,6 +42,9 @@ You should have Arduino IDE installed on your device, Please do so if you haven' 3. Go to *Tools > Board > Boards Manager* and search for “ESP32”. Click **Install**. + It should look like this in your Boards Manager: + Screenshot 2025-06-06 at 8 47 15 PM + ### Required Components List your required hardware components and the quantities here. From b1e3ffd910dd3ca073f1ec13c2f0a5a6c6395bb0 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 20:48:54 -0700 Subject: [PATCH 29/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index aab0736e..93acdb73 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -43,6 +43,7 @@ You should have Arduino IDE installed on your device, Please do so if you haven' Click **Install**. It should look like this in your Boards Manager: + Screenshot 2025-06-06 at 8 47 15 PM ### Required Components From 99e43fa0c89f728640ceab40d789c809cbe40542 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 21:30:40 -0700 Subject: [PATCH 30/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 93acdb73..73e372f1 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -46,6 +46,9 @@ You should have Arduino IDE installed on your device, Please do so if you haven' Screenshot 2025-06-06 at 8 47 15 PM + Screenshot 2025-06-06 at 9 30 14 PM + + ### Required Components List your required hardware components and the quantities here. From f587c4b8c8c2fc5e3910c978d78629fd089d23b8 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 21:31:33 -0700 Subject: [PATCH 31/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 73e372f1..bbf09370 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -39,6 +39,8 @@ You should have Arduino IDE installed on your device, Please do so if you haven' ``` https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json ``` + Screenshot 2025-06-06 at 9 30 14 PM + 3. Go to *Tools > Board > Boards Manager* and search for “ESP32”. Click **Install**. @@ -46,9 +48,6 @@ You should have Arduino IDE installed on your device, Please do so if you haven' Screenshot 2025-06-06 at 8 47 15 PM - Screenshot 2025-06-06 at 9 30 14 PM - - ### Required Components List your required hardware components and the quantities here. From 29109d2d8e355d988fd3dc32e941d8e387d52471 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 21:44:49 -0700 Subject: [PATCH 32/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index bbf09370..b66593b3 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -39,6 +39,7 @@ You should have Arduino IDE installed on your device, Please do so if you haven' ``` https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json ``` + It should look like this in the correct section: Screenshot 2025-06-06 at 9 30 14 PM 3. Go to *Tools > Board > Boards Manager* and search for “ESP32”. From c4b65c71c528ef5d1dd277806416704109d61fed Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 21:45:20 -0700 Subject: [PATCH 33/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index b66593b3..ce7a8735 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -45,7 +45,7 @@ You should have Arduino IDE installed on your device, Please do so if you haven' 3. Go to *Tools > Board > Boards Manager* and search for “ESP32”. Click **Install**. - It should look like this in your Boards Manager: + It should look like this in your Boards Manager (Once installed): Screenshot 2025-06-06 at 8 47 15 PM From 51f206abad622e40f4725f7cadd228cc286833d4 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 22:56:36 -0700 Subject: [PATCH 34/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 30 ++++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index ce7a8735..742717fa 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -64,30 +64,40 @@ List any tools and equipment you need here. - Computer (Windows, Mac, or Linux) - Arduino IDE installed -## Part 01: Name +## Part 01: Setting up Arduino & Connecting Your ESP32 ### Introduction -Briefly introduce what you are teaching in this section. +In this section, you will install Arduino on your computer (if you haven't already). Once that is done, you will learn to connect your ESP32 to Arduino successfully. ### Objective -- List the learning objectives of this section +- Install and open Arduino IDE +- Add the ESP32 board package +- Select the correct board and port ### Background Information -Give a brief explanation of the technical skills learned/needed -in this challenge. There is no need to go into detail as a -separation document should be prepared to explain more in depth -about the technical skills +At this point, you should have Arduino IDE installed on your device. In this section, we will walk through how to connect your ESP32 to Arduino and select the correct board and modules. ### Components -- List the components needed in this challenge +- Computer/Laptop +- ESP32 Board +- USB-C cable -### Instructional +### Instructions + +1. **Install Arduino IDE** and open it. If you don't have anything open, you can hover over to File -> New Sketch. +2. **Plug in your ESP32 board** via USB. +4. **Select the correct board:** + - Since it is your first time, you want to click the dropdown and select "Select other board and port" + Screenshot 2025-06-06 at 10 53 01 PM + - Once you get there, you want to select these options on your end, then press "Ok". + Screenshot 2025-06-06 at 10 55 00 PM +5. **Make sure the correct port is selected:** + - Tools → Port → Select the new device (if not sure, unplug/replug and see which one disappears/reappears). -Teach the contents of this section ## Example From 76742a76a57210b20364fc5189af7b2fb9bce676 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 22:57:06 -0700 Subject: [PATCH 35/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 742717fa..f03ff2b3 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -93,6 +93,7 @@ At this point, you should have Arduino IDE installed on your device. In this sec 4. **Select the correct board:** - Since it is your first time, you want to click the dropdown and select "Select other board and port" Screenshot 2025-06-06 at 10 53 01 PM + - Once you get there, you want to select these options on your end, then press "Ok". Screenshot 2025-06-06 at 10 55 00 PM 5. **Make sure the correct port is selected:** From d4ed60aea4b21ce6f505d6014bccad4300c0099f Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 22:57:31 -0700 Subject: [PATCH 36/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index f03ff2b3..5c887efc 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -92,7 +92,7 @@ At this point, you should have Arduino IDE installed on your device. In this sec 2. **Plug in your ESP32 board** via USB. 4. **Select the correct board:** - Since it is your first time, you want to click the dropdown and select "Select other board and port" - Screenshot 2025-06-06 at 10 53 01 PM + Screenshot 2025-06-06 at 10 53 01 PM - Once you get there, you want to select these options on your end, then press "Ok". Screenshot 2025-06-06 at 10 55 00 PM From 88aaccbe950e05e944984ad5da879add88bf23bf Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 22:57:51 -0700 Subject: [PATCH 37/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 5c887efc..ef3bc7a2 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -92,7 +92,7 @@ At this point, you should have Arduino IDE installed on your device. In this sec 2. **Plug in your ESP32 board** via USB. 4. **Select the correct board:** - Since it is your first time, you want to click the dropdown and select "Select other board and port" - Screenshot 2025-06-06 at 10 53 01 PM + Screenshot 2025-06-06 at 10 53 01 PM - Once you get there, you want to select these options on your end, then press "Ok". Screenshot 2025-06-06 at 10 55 00 PM From 45869c4cb5d5673a89201206d77677b7c279b713 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 22:58:13 -0700 Subject: [PATCH 38/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index ef3bc7a2..3a81d949 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -92,7 +92,7 @@ At this point, you should have Arduino IDE installed on your device. In this sec 2. **Plug in your ESP32 board** via USB. 4. **Select the correct board:** - Since it is your first time, you want to click the dropdown and select "Select other board and port" - Screenshot 2025-06-06 at 10 53 01 PM + Screenshot 2025-06-06 at 10 53 01 PM - Once you get there, you want to select these options on your end, then press "Ok". Screenshot 2025-06-06 at 10 55 00 PM From 9bc2fb433256c6f378926db154d72d7ab7823fdd Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 22:58:30 -0700 Subject: [PATCH 39/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 3a81d949..91a60393 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -92,7 +92,7 @@ At this point, you should have Arduino IDE installed on your device. In this sec 2. **Plug in your ESP32 board** via USB. 4. **Select the correct board:** - Since it is your first time, you want to click the dropdown and select "Select other board and port" - Screenshot 2025-06-06 at 10 53 01 PM + Screenshot 2025-06-06 at 10 53 01 PM - Once you get there, you want to select these options on your end, then press "Ok". Screenshot 2025-06-06 at 10 55 00 PM From e08f8478da664b815bc10f6e38e6f0d1b5fb294e Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 22:58:51 -0700 Subject: [PATCH 40/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 91a60393..b8526bc0 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -92,7 +92,7 @@ At this point, you should have Arduino IDE installed on your device. In this sec 2. **Plug in your ESP32 board** via USB. 4. **Select the correct board:** - Since it is your first time, you want to click the dropdown and select "Select other board and port" - Screenshot 2025-06-06 at 10 53 01 PM + Screenshot 2025-06-06 at 10 53 01 PM - Once you get there, you want to select these options on your end, then press "Ok". Screenshot 2025-06-06 at 10 55 00 PM From 2b6a872b2698c7b827eba0cf46184d8adf106464 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 23:20:56 -0700 Subject: [PATCH 41/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 54 ++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index b8526bc0..883f5b57 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -100,6 +100,60 @@ At this point, you should have Arduino IDE installed on your device. In this sec - Tools → Port → Select the new device (if not sure, unplug/replug and see which one disappears/reappears). +## Part 2: Scanning Wi-Fi Networks (Serial Monitor Version) + +### Introduction + +Let’s write code to make your ESP32 scan and list all nearby Wi-Fi networks in the Serial Monitor. + +### Objective + +- Understand how to use the `WiFi.h` library +- See the Wi-Fi networks displayed from the Serial Monitor + +### Background Information +Now that we have set up Arduino and successfully connected our ESP32 board, we will start to see this Wi-Fi display in action! + +### Instructions +1. Assuming you have already opened a new sketch (File -> New Sketch), you should have the following template displayed: +``` +void setup() { + // put your setup code here, to run once: + +} + +void loop() { + // put your main code here, to run repeatedly: + +} +``` +2. You want to first include the Wifi.h library: +``` +#include "WiFi.h" +``` +3. Inside your ```void setup()``` function you want to include this block inside: +``` + Serial.begin(115200); + delay(1000); + + WiFi.mode(WIFI_STA); // Station mode is best for scanning + Serial.println("Scanning for WiFi networks..."); + int n = WiFi.scanNetworks(); + if (n == 0) { + Serial.println("No networks found."); + } else { + Serial.println("Networks found:"); + for (int i = 0; i < n; ++i) { + Serial.printf("%d: %s (%d dBm) Encryption: %s\n", + i + 1, + WiFi.SSID(i).c_str(), + WiFi.RSSI(i), + WiFi.encryptionType(i) == WIFI_AUTH_OPEN ? "Open" : "Secured" + ); + } + } +``` + ## Example ### Introduction From 7c4bfbed102ca133c8443d52307383877d48e964 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 23:21:53 -0700 Subject: [PATCH 42/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 883f5b57..071d988e 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -116,7 +116,7 @@ Now that we have set up Arduino and successfully connected our ESP32 board, we w ### Instructions 1. Assuming you have already opened a new sketch (File -> New Sketch), you should have the following template displayed: -``` +```c void setup() { // put your setup code here, to run once: @@ -128,11 +128,11 @@ void loop() { } ``` 2. You want to first include the Wifi.h library: -``` +```c #include "WiFi.h" ``` 3. Inside your ```void setup()``` function you want to include this block inside: -``` +```c Serial.begin(115200); delay(1000); From b19eedaab739299240328c51dcdd60495e991fd4 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 23:51:32 -0700 Subject: [PATCH 43/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 105 +++++++++++++++++++++++++++++-- 1 file changed, 100 insertions(+), 5 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 071d988e..f1a1dfc1 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -129,7 +129,7 @@ void loop() { ``` 2. You want to first include the Wifi.h library: ```c -#include "WiFi.h" +#include ``` 3. Inside your ```void setup()``` function you want to include this block inside: ```c @@ -153,16 +153,111 @@ void loop() { } } ``` +**What this code does:** +- Sets up Serial Monitor +- Scans for Wi-Fi networks +- Prints each network’s name (SSID), signal strength, and encryption type -## Example +5. How to View Results: + - Click Tools → Serial Monitor + - You’ll see the scan results appear in the Serial window + - Note: Only 2.4 GHz Wi-Fi networks will appear. + +## Part 3: Scanning and Displaying on a Web Page (ESP32 as Access Point) ### Introduction -Introduce the example that you are showing here. +Let’s make your ESP32 create its own Wi-Fi network and host a web page that lists all Wi-Fi networks it can see. + +### Objective + +- Set up the ESP32 in “Access Point” mode +- Build a simple web server to show Wi-Fi scan results in any browser -### Example +### Background Information +Now that we have the Wi-Fi networks displaying, let's get a little fancy and host it on a web page! + +### Instructions +1. With your existing code from the beginning add this right below the include WiFi.h: +```c +#include -Present the example here. Include visuals to help better understanding +const char* ap_ssid = "ESP32-Scanner"; +const char* ap_password = "ece196test"; + +WebServer server(80); +``` +This block of code: +- Includes the WebServer library in your program +- The WebServer library lets your ESP32 run a simple website that you can view in your browser +- For ```const char* ap_ssid```, you can change whatever you want in the parentheses, but in this case we are using "ESP32-Scanner" +- The same applies for the password, in this case we are using "ece196test" +```#include ``` adds the web server functions to your code. + +```ap_ssid``` and ```ap_password``` set the Wi-Fi name and password for your ESP32’s own hotspot. + +```WebServer server(80);``` sets up a server that will listen for visitors on the standard web port. + +2. You will then create a ```void handleRoot()``` function here: +```c +void handleRoot() { + String page = "

ESP32 Wi-Fi Scanner (AP Mode)

"; + page += "

Scanning for networks...

"; + int n = WiFi.scanNetworks(); + if (n == 0) { + page += "No networks found."; + } else { + page += "
    "; + for (int i = 0; i < n; ++i) { + page += "
  1. "; + page += WiFi.SSID(i); + page += " ("; + page += WiFi.RSSI(i); + page += " dBm) - "; + page += (WiFi.encryptionType(i) == WIFI_AUTH_OPEN ? "Open" : "Secured"); + page += "
    2. "; + } + page += "
"; + } + page += "

"; + server.send(200, "text/html", page); +} +``` +The ```handleRoot()``` function is responsible for creating and displaying the main web page on your ESP32. +Whenever someone connects to your ESP32’s Wi-Fi and visits its IP address in a browser, this function: +- Scans for all nearby Wi-Fi networks +- Builds an HTML page listing each network’s name, signal strength, and security type +- Adds a Refresh button to allow users to re-scan +- Sends the page to the browser for easy viewing + +3. You will want to replace everything in your ```void setup()``` to look like this: +```c +Serial.begin(115200); + delay(1000); + + WiFi.mode(WIFI_AP); + WiFi.softAP(ap_ssid, ap_password); + IPAddress myIP = WiFi.softAPIP(); + Serial.println(); + Serial.print("ESP32 AP IP address: "); + Serial.println(myIP); + Serial.print("Wi-Fi name: "); + Serial.println(ap_ssid); + Serial.print("Wi-Fi password: "); + Serial.println(ap_password); + + server.on("/", handleRoot); + server.begin(); + Serial.println("Web server started. Connect to ESP32 Wi-Fi and visit above IP in your browser."); +``` +The web server version of setup() puts the ESP32 in Access Point mode, creates a Wi-Fi network, starts a simple web server, and displays the network and connection info in the Serial Monitor. +The version just scans for nearby Wi-Fi in Station mode and prints results directly to the Serial Monitor with no web interface (See Part 2). + +4. In your ```void loop()``` function, you would want to add this line: +```c +server.handleClient(); +``` +The loop() function repeatedly calls server.handleClient(), which keeps the web server running and responsive. Every time a device tries to connect to your ESP32’s web page, this line ensures the page is served with up-to-date scan results. ### Analysis From 6ecab34ac2e8cd80231f2a934416374e587c98e4 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Fri, 6 Jun 2025 23:54:34 -0700 Subject: [PATCH 44/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index f1a1dfc1..842911a2 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -163,6 +163,10 @@ void loop() { - You’ll see the scan results appear in the Serial window - Note: Only 2.4 GHz Wi-Fi networks will appear. +You should see something like this for the output in your Serial Monitor: + +Screenshot 2025-06-06 at 11 32 49 PM + ## Part 3: Scanning and Displaying on a Web Page (ESP32 as Access Point) ### Introduction From a1a4e6c5b6349df52f2545eb7fd71b636908a7b5 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Sat, 7 Jun 2025 00:00:20 -0700 Subject: [PATCH 45/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 842911a2..95dc9ae8 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -165,7 +165,7 @@ void loop() { You should see something like this for the output in your Serial Monitor: -Screenshot 2025-06-06 at 11 32 49 PM +Screenshot 2025-06-06 at 11 55 12 PM ## Part 3: Scanning and Displaying on a Web Page (ESP32 as Access Point) @@ -263,6 +263,16 @@ server.handleClient(); ``` The loop() function repeatedly calls server.handleClient(), which keeps the web server running and responsive. Every time a device tries to connect to your ESP32’s web page, this line ensures the page is served with up-to-date scan results. +5. Once you upload your code you should see something like this on your Serial Monitor Output: +Screenshot 2025-06-06 at 11 32 49 PM + +This is the information you will use to connect to the Wi-Fi that you just created. You will select taht Wi-fi and enter in the password you set it to: +![IMG_8254](https://github.com/user-attachments/assets/65cf377d-524d-4890-bc9c-350193b73636) + +6. Once you are successfully connected, you will head over to your webrowser and enter in the ip adress given, in this case: ```192.168.4.1``` and you should see your web server look like this! + +![IMG_8253](https://github.com/user-attachments/assets/b59c0766-ee86-458e-8c1d-fd9ccc834189) + ### Analysis Explain how the example used your tutorial topic. Give in-depth analysis of each part and show your understanding of the tutorial topic From ed5e2e9d46a0ba792b981bee8217f64cb979d531 Mon Sep 17 00:00:00 2001 From: jasmine-le29 <116687332+jasmine-le29@users.noreply.github.com> Date: Sat, 7 Jun 2025 00:05:29 -0700 Subject: [PATCH 46/46] Update WiFiScanner.md --- content/tutorials/WiFiScanner.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/content/tutorials/WiFiScanner.md b/content/tutorials/WiFiScanner.md index 95dc9ae8..859587b5 100644 --- a/content/tutorials/WiFiScanner.md +++ b/content/tutorials/WiFiScanner.md @@ -275,10 +275,13 @@ This is the information you will use to connect to the Wi-Fi that you just creat ### Analysis -Explain how the example used your tutorial topic. Give in-depth analysis of each part and show your understanding of the tutorial topic +This project demonstrates how to use the ESP32’s built-in Wi-Fi hardware as a sensor to detect and report information about the wireless networks in its environment. By utilizing WiFi.h and WebServer.h libraries, we not only scan for available 2.4 GHz networks but also present this data to users in two accessible ways: through the Arduino Serial Monitor and via a simple web page hosted on the ESP32 itself. By following this tutorial, students gain hands-on experience with embedded Wi-Fi scanning, basic web serving, and troubleshooting real hardware/software interactions. These skills are foundational for networking and embedded systems projects. ## Additional Resources ### Useful links +[Installing the ESP32 Board in Arduino IDE](https://randomnerdtutorials.com/installing-the-esp32-board-in-arduino-ide-windows-instructions/) -List any sources you used, documentation, helpful examples, similar projects etc. +[ESP32 Useful Wi-Fi Library Functions](https://randomnerdtutorials.com/esp32-useful-wi-fi-functions-arduino/) + +[How to Set an ESP32 Access Point (AP) for Web Server](https://randomnerdtutorials.com/esp32-access-point-ap-web-server/)