ES-25고급
ESP32 Wi-Fi STA 연결 (LCD 화면 포함)
이 프로젝트에서는 ESP32를 Station(STA) 모드로 집의 Wi-Fi 네트워크에 안전하고 장애에 강하게 연결해요. SSID와 비밀번호는 Git에 새어 나가지 않도록 별도의 secrets.h 파일에 저장하고, 자동 재연결 기능을 만들고, RSSI 신호 세기와 IP 주소를 I2C LCD 화면에 표시해요. 내장 LED는 상태 표시등 역할을 해요. 실제 제품 수준의 연결 관리자예요.
4.4(21)
38 완료
ESP32를 집의 무선 네트워크에 연결하는 것은 온라인으로 가는 모든 프로젝트의 첫 단계예요. 연결되면 보드의 불이 계속 켜져 있고, 작은 화면은 3초마다 번갈아 네트워크상의 보드 주소와 신호 세기를 아주 좋음부터 아주 약함까지 단어로 보여 줘요. 연결이 끊기면 불이 깜박이고 보드는 30초마다 다시 연결을 시도해요.
동영상
회로도

소스 코드
C++ (Arduino IDE)
1// ─────────────────────────────────────────
2// BlueGrays · bluegrays.com
3// ESP32 Wi-Fi STA Connection (with LCD Screen)
4// ─────────────────────────────────────────
5// The ESP32 joins a Wi-Fi network as a station (STA); the IP address and
6// the RSSI signal strength take turns on the 16x2 I2C LCD every 3 s. If
7// the link drops it retries every 30 s. The built-in LED shows the link
8// status.
9//
10// Pins:
11// GPIO 2 -> Built-in LED (connection status)
12// GPIO 21 -> LCD SDA, GPIO 22 -> LCD SCL
13// LCD VCC -> 5V (VIN), GND -> GND
14
15#include <Wire.h>
16#include <LiquidCrystal_I2C.h>
17#include <WiFi.h>
18
19// Wi-Fi credentials. If secrets.h exists in the sketch folder (defining WIFI_SSID and WIFI_PASS) it
20// is used, keep it out of Git. Otherwise the Wokwi default applies; for real hardware put your own
21// SSID and password!
22#if __has_include("secrets.h")
23#include "secrets.h"
24#else
25const char* WIFI_SSID = "Wokwi-GUEST";
26const char* WIFI_PASS = ""; // Wokwi-GUEST has no password
27#endif
28
29// Pin and timing settings
30#define LED_PIN 2 // Onboard LED
31#define WIFI_TIMEOUT_MS 15000 // Initial connect timeout
32#define WIFI_RECOVER_MS 30000 // Reconnect interval
33#define SCREEN_SWITCH_MS 3000 // Screen switch period
34
35LiquidCrystal_I2C lcd(0x27, 16, 2);
36
37unsigned long lastReconnect = 0; // Last retry (ms)
38unsigned long lastScreenSwitch = 0; // Last screen switch (ms)
39bool showIpScreen = true; // IP or RSSI screen
40
41// RSSI -> signal quality
42const char* rssiQuality(int rssi) {
43 if (rssi >= -55) return "Excellent";
44 if (rssi >= -65) return "Good";
45 if (rssi >= -75) return "Fair";
46 if (rssi >= -85) return "Weak";
47 return "Very weak";
48}
49
50// Screen: connecting
51void showConnecting() {
52 lcd.clear();
53 lcd.setCursor(0, 0);
54 lcd.print("Connecting...");
55 lcd.setCursor(0, 1);
56 lcd.print("Please wait");
57}
58
59// Screen: disconnected
60void showDisconnected() {
61 lcd.clear();
62 lcd.setCursor(0, 0);
63 lcd.print("No connection");
64 lcd.setCursor(0, 1);
65 lcd.print("Retrying soon");
66}
67
68// Screen: IP address
69void showIpInfo() {
70 lcd.clear();
71 lcd.setCursor(0, 0);
72 lcd.print("IP:");
73 lcd.setCursor(0, 1);
74 lcd.print(WiFi.localIP());
75}
76
77// Screen: RSSI (dBm) and signal quality
78void showRssiInfo() {
79 int rssi = WiFi.RSSI();
80 lcd.clear();
81 lcd.setCursor(0, 0);
82 lcd.print("RSSI:");
83 lcd.print(rssi);
84 lcd.print(" dBm");
85 lcd.setCursor(0, 1);
86 lcd.print(rssiQuality(rssi));
87}
88
89// Connects in STA mode, waits up to WIFI_TIMEOUT_MS; returns true when connected
90bool connectWiFi() {
91 WiFi.mode(WIFI_STA);
92 WiFi.setAutoReconnect(true);
93 WiFi.setSleep(false); // Power save off
94 WiFi.setHostname("bluegrays-esp32");
95 WiFi.begin(WIFI_SSID, WIFI_PASS);
96
97 unsigned long start = millis();
98 while (WiFi.status() != WL_CONNECTED && millis() - start < WIFI_TIMEOUT_MS) {
99 delay(500);
100 }
101 return WiFi.status() == WL_CONNECTED;
102}
103
104void setup() {
105 pinMode(LED_PIN, OUTPUT);
106 digitalWrite(LED_PIN, LOW);
107
108 // DevKit V1 default I2C pins
109 Wire.begin(21, 22);
110 lcd.init();
111 lcd.backlight();
112
113 // Splash screen 3 s
114 lcd.setCursor(3, 0);
115 lcd.print("BlueGrays");
116 lcd.setCursor(2, 1);
117 lcd.print("Wi-Fi STA v1");
118 delay(3000);
119
120 // If connected, the LED turns on and the IP is shown
121 showConnecting();
122 if (connectWiFi()) {
123 digitalWrite(LED_PIN, HIGH);
124 showIpInfo();
125 lastScreenSwitch = millis();
126 } else {
127 showDisconnected();
128 }
129}
130
131void loop() {
132 // Without a link the LED blinks and a reconnect is tried every 30 s
133 if (WiFi.status() != WL_CONNECTED) {
134 digitalWrite(LED_PIN, (millis() / 500) % 2);
135 if (millis() - lastReconnect > WIFI_RECOVER_MS) {
136 showConnecting();
137 WiFi.disconnect();
138 WiFi.reconnect();
139 lastReconnect = millis();
140 delay(3000);
141 if (WiFi.status() == WL_CONNECTED) {
142 digitalWrite(LED_PIN, HIGH);
143 showIpInfo();
144 lastScreenSwitch = millis();
145 } else {
146 showDisconnected();
147 }
148 }
149 return;
150 }
151
152 // Connected: the LED stays on (setAutoReconnect may also restore the link by itself)
153 digitalWrite(LED_PIN, HIGH);
154
155 // While connected, alternate IP and RSSI screens
156 if (millis() - lastScreenSwitch > SCREEN_SWITCH_MS) {
157 lastScreenSwitch = millis();
158 showIpScreen = !showIpScreen;
159 if (showIpScreen) showIpInfo();
160 else showRssiInfo();
161 }
162
163 delay(50);
164}
165FAQ
Wi-Fi 비밀번호를 왜 별도 파일에 둬요?
secrets.h 파일을 Git에 올리지 않으면(.gitignore) 코드를 공유해도 비밀번호가 드러나지 않아요. 실제 프로젝트에서 쓰는 모범 사례예요.
ESP32를 5 GHz Wi-Fi에 연결할 수 있어요?
아니요, ESP32는 2.4 GHz 네트워크만 지원해요. 공유기의 2.4 GHz 대역이 켜져 있는지 확인하고, 듀얼 밴드 네트워크에서 문제가 생기면 2.4 GHz 대역에 별도의 이름(SSID)을 정하세요.
RSSI 값은 무슨 뜻이에요?
dBm으로 잰 신호 세기예요. −50 dBm은 아주 좋고, −70 dBm은 쓸 만하고, −80 dBm보다 낮으면 약해서 연결이 끊길 수 있어요.
연결이 끊기면 어떻게 돼요?
코드는 연결 상태를 주기적으로 확인하고 연결이 끊기면 다시 연결을 시도해요. 이 자동 재연결 덕분에 공유기가 다시 시작돼도 기기가 저절로 네트워크에 다시 연결돼요.
