Wi-Fi AT 명령어들

[2025/08/24] First Start.

소나무 기운 ,  전자제품 개발/생산

메인 제목 Wi-Fi AT 명령어들

 

 

 

 

 

 

 

 

📡 AT+CWINIT

1. ESP32의 Wi-Fi 드라이버를 초기화하거나 해제하는 명령어입니다.
2. 파라미터 값으로 STA(클라이언트) 모드, SoftAP 모드, 또는 두 가지를 모두 지원하도록 설정할 수 있습니다.
3. Wi-Fi 관련 다른 AT 명령어들을 사용하려면 반드시 드라이버가 초기화되어 있어야 합니다.
4. AT+CWINIT=0 은 드라이버 해제, AT+CWINIT=1 은 STA 모드 초기화 등으로 사용됩니다.
5. 초기화가 안 되어 있으면 연결 시도가 실패하므로, Wi-Fi 동작 전 필수적으로 실행하는 명령어입니다.

 

 

 

📡 AT+CWMODE

1. 장치의 Wi-Fi 동작 모드를 설정하거나 조회합니다.
2. 1은 스테이션(STA), 2는 SoftAP, 3은 STA+AP 동시 모드입니다.
3. 예: AT+CWMODE=1 → 공유기에 접속하는 클라이언트로 동작.
4. AT+CWMODE? 를 실행하면 현재 설정된 모드를 확인할 수 있습니다.
5. 특정 환경에서는 STA 전용으로 설정하는 것이 전력 절감에 유리합니다.

 

 

📡 AT+CWSTATE

1. 현재 Wi-Fi 연결 상태와 연결된 SSID 정보를 확인하는 명령어입니다.
2. 출력값은 상태 코드(0: 연결 안 됨, 2: 연결됨 등)와 SSID를 포함합니다.
3. 연결이 유지되고 있는지 디버깅할 때 자주 사용됩니다.
4. AT+CWSTATE? 입력 시 현재 연결된 AP 정보를 표시합니다.
5. 연결 모니터링을 위한 상태 확인 루틴에 자주 포함됩니다.

 

 

 

📡 AT+CWCONFIG

1. Wi-Fi 절전 모드와 Listen Interval(데이터 수신 대기 주기)을 설정합니다.
2. 전력 소모를 줄이거나 안정적인 연결 유지를 위해 조정할 수 있습니다.
3. 파라미터에 따라 전력 절약 모드를 켜거나 끌 수 있습니다.
4. 배터리 기반 장치에서 유용하게 사용됩니다.
5. 기본적으로는 성능 위주로 설정되어 있으므로, 필요 시 전력 위주로 변경 가능합니다.

 

 

 

📡 AT+CWJAP

1. 특정 SSID와 비밀번호를 이용해 AP(공유기)에 연결하는 명령어입니다.
2. AT+CWJAP="SSID","password" 형태로 사용합니다.
3. 연결에 성공하면 IP가 할당되고 상태 조회로 확인할 수 있습니다.
4. AT+CWJAP? 명령으로 현재 연결된 AP 정보를 볼 수 있습니다.
5. 전원 재시작 후 자동 재연결 설정도 함께 지원합니다.

 

 

 

📡 AT+CWRECONNCFG

1. Wi-Fi 연결이 끊겼을 때 자동으로 재연결할지 여부를 설정합니다.
2. AT+CWRECONNCFG=enable,interval,retry 형식으로 사용합니다.
3. interval은 재시도 간격, retry는 최대 재시도 횟수를 의미합니다.
4. 장치가 이동하거나 전파가 약한 환경에서 안정성을 높여줍니다.
5. 배터리 소모를 고려해 적절한 간격과 횟수를 설정하는 것이 좋습니다.

 

 

📡 AT+CWLAPOPT

1. Wi-Fi AP 스캔 결과의 출력 옵션을 설정하는 명령어입니다.
2. 예: 보안 모드, 신호 세기, MAC 주소 등을 표시 여부로 제어합니다.
3. 특정 SSID만 검색하도록 필터링할 수도 있습니다.
4. 출력 데이터를 줄이면 파싱이 쉬워지고 처리 속도가 빨라집니다.
5. AT+CWLAPOPT=1,1 같이 세부 항목을 조정합니다.

 

 

📡 AT+CWLAP

1. 주변에서 검색 가능한 Wi-Fi AP 목록을 조회합니다.
2. SSID, RSSI(신호 세기), 암호화 방식, 채널 등의 정보를 반환합니다.
3. AT+CWLAP만 입력하면 전체를, 옵션을 주면 특정 SSID만 검색 가능합니다.
4. 연결 가능한 네트워크 환경을 탐색할 때 필수적으로 사용됩니다.
5. 출력 데이터가 많으므로 MCU 파싱 시 버퍼 크기를 고려해야 합니다.

 

 

📡 AT+CWQAP

1. 현재 연결된 Wi-Fi AP와의 연결을 종료합니다.
2. 연결이 끊어지면 자동 재연결 설정이 켜져 있다면 다시 시도할 수 있습니다.
3. AT+CWQAP 단독으로 실행하면 즉시 연결 해제됩니다.
4. AP를 바꾸고 싶을 때 반드시 실행 후 새 SSID로 재접속합니다.
5. 해제 후 상태는 AT+CWSTATE로 확인할 수 있습니다.

 

 

📡 AT+CWSAP

1. ESP32를 SoftAP 모드로 설정하거나 현재 설정을 조회합니다.
2. AT+CWSAP="SSID","password",channel,encrypt 형태로 사용합니다.
3. 비밀번호는 최소 8자 이상이어야 하고, 암호화 모드 선택 가능.
4. 동시에 여러 기기가 ESP32에 접속할 수 있습니다.
5. 조회(AT+CWSAP?)하면 현재 AP 정보가 표시됩니다.

 

 

AT+CWLIF

1. SoftAP 모드에서 ESP32에 접속 중인 기기의 IP와 MAC 주소를 보여줍니다.
2. AT+CWLIF 실행 시 현재 연결된 클라이언트가 모두 표시됩니다.
3. 연결된 장치 수를 파악하거나 접근 제어할 때 유용합니다.
4. DHCP 서버를 사용할 경우, 해당 장치들이 할당받은 IP도 함께 표시됩니다.
5. IoT 게이트웨이 같은 경우 접속 상태 모니터링에 활용됩니다.

 

 

📡 AT+CWQIF

1. SoftAP에 연결된 클라이언트를 강제로 연결 해제합니다.
2. 특정 MAC 주소를 지정하거나 전체 연결을 끊을 수 있습니다.
3. AT+CWQIF="MAC" 형태로 특정 클라이언트만 제거 가능합니다.
4. 보안 목적이나 접속 제한 시 활용됩니다.
5. 해제 후에는 해당 장치가 다시 접속하지 않도록 필터링 설정 가능.

 

 

📡 AT+CWDHCP

1. DHCP 클라이언트 또는 서버 기능을 켜거나 끄는 명령어입니다.
2. STA 모드, AP 모드 각각 독립적으로 설정 가능합니다.
3. AT+CWDHCP=mode,enable 형식으로 사용합니다.
4. mode=1(Station), 2(AP), 3(둘 다)에 적용할 수 있습니다.
5. IP를 수동으로 할당할 때는 DHCP를 꺼야 합니다.

 

 

 

📡 AT+CWDHCPS

1. SoftAP에서 동작하는 DHCP 서버의 IP 할당 범위를 설정합니다.
2. AT+CWDHCPS=enable,startIP,endIP 형식으로 지정합니다.
3. IP 풀을 제한해 연결되는 클라이언트 수를 조절할 수 있습니다.
4. 예: AT+CWDHCPS=1,"192.168.4.100","192.168.4.200".
5. DHCP 서버를 껐다 켜서 새로운 범위를 반영할 수 있습니다.

 

📡 AT+CWAUTOCONN

1. 전원이 켜질 때 마지막으로 연결된 AP에 자동 재연결할지 설정합니다.
2. AT+CWAUTOCONN=1 → 자동 연결 활성화.
3. AT+CWAUTOCONN=0 → 수동 연결 모드로 동작.
4. 배터리 절약이나 보안 목적에 따라 선택적으로 사용합니다.
5. 현재 상태는 AT+CWAUTOCONN?로 확인 가능합니다.

 

 

AT+CWAPPROTO

1. SoftAP 모드에서 지원할 Wi-Fi 프로토콜을 설정합니다.
2. b(802.11b), g(802.11g), n(802.11n) 등을 조합해 지정할 수 있습니다.
3. 구형 장치 호환성을 위해 b/g 모드를 켜 두는 경우가 많습니다.
4. 고속 전송이 필요하면 n 모드를 활성화하는 것이 좋습니다.
5. AT+CWAPPROTO?로 현재 설정을 확인할 수 있습니다.

 

 

📡 AT+CWSTAPROTO

1. 스테이션 모드에서 사용할 Wi-Fi 프로토콜을 설정합니다.
2. SoftAP와 동일하게 b/g/n 조합을 선택할 수 있습니다.
3. 예: AT+CWSTAPROTO=7 → b/g/n 모두 허용.
4. 특정 공유기와 호환성 문제가 생기면 b/g 위주로 제한할 수 있습니다.
5. 전송 속도와 안정성 요구에 맞게 조정 가능합니다.

 

 

📡 AT+CIPSTAMAC

1. 스테이션 모드에서 사용할 MAC 주소를 조회/설정합니다.
2. AT+CIPSTAMAC? → 현재 MAC 주소 확인.
3. AT+CIPSTAMAC="xx:xx:xx:xx:xx:xx" → 새로운 MAC 적용.
4. MAC 주소 변경으로 네트워크 식별 우회가 가능합니다.
5. DHCP 서버에서 예약된 IP를 사용해야 할 때 자주 활용됩니다.

 

 

📡 AT+CIPAPMAC

1. SoftAP 모드에서 사용할 MAC 주소를 설정하거나 확인합니다.
2. AT+CIPAPMAC? → 현재 AP의 MAC 주소 확인.
3. AT+CIPAPMAC="xx:xx:xx:xx:xx:xx" → 새로운 주소로 설정.
4. 특정 환경에서 충돌 방지를 위해 AP MAC을 변경할 수 있습니다.
5. 기본값은 ESP 칩에 내장된 고유 MAC에서 파생됩니다.

 

 

📡 AT+CIPSTA

1. 스테이션 모드에서 사용할 IP 설정을 구성합니다.
2. AT+CIPSTA? → 현재 IP, 게이트웨이, 서브넷 마스크 조회.
3. AT+CIPSTA="ip","gateway","netmask" → 수동 할당.
4. DHCP를 끄고 정적 IP로 고정하려 할 때 자주 사용됩니다.
5. 네트워크 충돌을 피하기 위해 관리자가 직접 지정할 수 있습니다.

 

📡 AT+CIPAP

1. SoftAP 모드에서 사용할 IP 정보를 설정합니다.
2. 기본값은 192.168.4.1 같은 내부 네트워크 대역입니다.
3. AT+CIPAP? → 현재 AP IP, 게이트웨이, 마스크 확인.
4. AT+CIPAP="ip","gateway","netmask" → 직접 변경.
5. DHCP 서버와 일치해야 클라이언트 연결이 정상 동작합니다.

 

📡 AT+CWSTARTSMART

1. SmartConfig 기능을 시작하여 스마트폰 앱으로 Wi-Fi 설정을 받습니다.
2. AT+CWSTARTSMART=mode 형식으로 사용합니다.
3. mode=1일 때 EspTouch, mode=2는 AirKiss 등 방식 선택 가능.
4. AP 정보를 직접 입력하지 않고도 손쉽게 연결할 수 있습니다.
5. IoT 제품 초기 설정 시 자주 사용됩니다.

 

 

📡 AT+CWSTOPSMART

1. 실행 중인 SmartConfig 기능을 종료합니다.
2. SmartConfig 관련 메모리와 리소스를 해제합니다.
3. AT+CWSTOPSMART 단독으로 호출하면 즉시 중지됩니다.
4. 불필요한 전력 소모를 막기 위해 반드시 종료하는 것이 좋습니다.
5. SmartConfig가 끝난 후 보통 바로 이 명령을 호출합니다.

 

📡 AT+WPS

1. Wi-Fi WPS(Push Button Configuration) 기능을 사용합니다.
2. AT+WPS=1 → WPS 활성화, AT+WPS=0 → 비활성화.
3. 공유기 WPS 버튼과 함께 사용하면 SSID/비밀번호 입력 없이 연결됩니다.
4. 보안상 WPS는 권장되지 않지만, 빠른 연결용으로 사용됩니다.
5. IoT 설치 환경에서 유용하지만 기업망에서는 잘 쓰지 않습니다.

 

 

📡 AT+CWJEAP

1. WPA2-Enterprise(802.1X) 기반 Wi-Fi 네트워크에 연결합니다.
2. AT+CWJEAP 명령으로 EAP 방식, 사용자 이름, 비밀번호 등을 설정합니다.
3. 기업용 네트워크나 대학 캠퍼스 Wi-Fi 환경에서 필요합니다.
4. 일반 WPA2-PSK와 달리 인증 서버와의 통신이 필요합니다.
5. IoT 제품을 기업 환경에 배포할 때 중요한 기능입니다.

 

📡 AT+CWHOSTNAME

1. 스테이션 모드에서 사용할 호스트네임을 설정하거나 조회합니다.
2. AT+CWHOSTNAME="name" → 새로운 호스트네임 지정.
3. DHCP 서버에 등록될 때 이 이름이 함께 표시됩니다.
4. 네트워크에서 장치를 식별하기 쉽게 만들어 줍니다.
5. 여러 ESP32를 동시에 운영할 때 유용합니다.

 

📡 AT+CWCOUNTRY

1. Wi-Fi 동작 국가를 설정하여 사용 가능한 채널을 제한합니다.
2. AT+CWCOUNTRY="CN",start_ch,end_ch,policy 형식으로 지정합니다.
3. 각 나라별 규격에 맞는 채널 범위를 지정해야 합법적으로 동작합니다.
4. 잘못 설정하면 일부 채널이 비활성화되어 연결이 불안정할 수 있습니다.
5. 전파 규제 준수를 위해 꼭 올바른 국가 코드를 사용해야 합니다.

 

 

 

📑 ESP32 Wi-Fi AT 명령어 요약표

명령어	기능	주요 파라미터	비고
AT+CWINIT	Wi-Fi 드라이버 초기화/해제	mode (0=해제, 1=STA, 2=AP 등)	Wi-Fi 명령 사용 전 필수
AT+CWMODE	동작 모드 설정/조회	1=STA, 2=AP, 3=STA+AP	전력/성능 요구에 맞춰 선택
AT+CWSTATE	현재 연결 상태 확인	없음	상태 코드 + 연결된 SSID 반환
AT+CWCONFIG	절전 모드 및 Listen Interval	enable, interval	전력 절약용
AT+CWJAP	AP에 연결/조회	SSID, password	자동 재연결 가능
AT+CWRECONNCFG	자동 재연결 설정	enable, interval, retry	끊김 환경에서 유용
AT+CWLAPOPT	AP 스캔 출력 옵션 설정	mask, filter	출력 항목/조건 조정
AT+CWLAP	주변 AP 검색	SSID(optional)	RSSI, 보안 모드 포함
AT+CWQAP	AP 연결 해제	없음	재연결 여부 설정에 따라 동작
AT+CWSAP	SoftAP 설정/조회	SSID, password, channel, enc	ESP32를 AP로 동작
AT+CWLIF	SoftAP 접속 클라이언트 확인	없음	IP, MAC 리스트 표시
AT+CWQIF	SoftAP 클라이언트 강제 해제	MAC(optional)	특정/전체 클라이언트 해제
AT+CWDHCP	DHCP 클라이언트/서버 활성화	mode, enable	STA/AP 개별 제어
AT+CWDHCPS	SoftAP DHCP 서버 범위 설정	enable, startIP, endIP	DHCP 서버 주소풀 관리
AT+CWAUTOCONN	자동 재연결 여부 설정	0=off, 1=on	전원 켤 때 자동 접속
AT+CWAPPROTO	SoftAP Wi-Fi 프로토콜 설정	b/g/n 조합	구형 호환성/속도 조정
AT+CWSTAPROTO	STA Wi-Fi 프로토콜 설정	b/g/n 조합	호환성 문제 해결 가능
AT+CIPSTAMAC	STA MAC 주소 설정/조회	MAC	DHCP 예약 등에서 활용
AT+CIPAPMAC	SoftAP MAC 주소 설정/조회	MAC	충돌 방지 목적
AT+CIPSTA	STA IP 설정/조회	IP, gateway, netmask	정적 IP 지정 가능
AT+CIPAP	SoftAP IP 설정/조회	IP, gateway, netmask	DHCP 서버와 일치 필요
AT+CWSTARTSMART	SmartConfig 시작	mode (1=EspTouch, 2=AirKiss)	앱으로 Wi-Fi 설정 전달
AT+CWSTOPSMART	SmartConfig 종료	없음	자원 해제
AT+WPS	WPS 연결 활성/비활성	0=off, 1=on	보안 취약점 존재
AT+CWJEAP	WPA2-Enterprise 연결	EAP 방식, ID, PW	기업망/캠퍼스 Wi-Fi용
AT+CWHOSTNAME	STA 호스트네임 설정/조회	이름	네트워크에서 식별 용이
AT+CWCOUNTRY	Wi-Fi 국가 코드 설정	country, start_ch, end_ch	규제 채널 준수

 

 

참고문헌

마무리5

https://docs.espressif.com/projects/esp-at/en/latest/esp32/AT_Command_Set/Wi-Fi_AT_Commands.html

Wi-Fi AT Commands - ESP32 - — ESP-AT User Guide latest documentation

 

 

 

 

 

 

틀린 부분이나 질문은 댓글 달아주세요.

즐거운 하루 보내세요. 감사합니다.