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 Wi-Fi STA 연결 (LCD 화면 포함)
ESP32를 집의 무선 네트워크에 연결하는 것은 온라인으로 가는 모든 프로젝트의 첫 단계예요. 연결되면 보드의 불이 계속 켜져 있고, 작은 화면은 3초마다 번갈아 네트워크상의 보드 주소와 신호 세기를 아주 좋음부터 아주 약함까지 단어로 보여 줘요. 연결이 끊기면 불이 깜박이고 보드는 30초마다 다시 연결을 시도해요.

동영상

회로도

ESP32 Wi-Fi STA 연결 (LCD 화면 포함) - 회로도

소스 코드

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}
165

FAQ

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보다 낮으면 약해서 연결이 끊길 수 있어요.

연결이 끊기면 어떻게 돼요?

코드는 연결 상태를 주기적으로 확인하고 연결이 끊기면 다시 연결을 시도해요. 이 자동 재연결 덕분에 공유기가 다시 시작돼도 기기가 저절로 네트워크에 다시 연결돼요.