WIFI Management AT Command
통신모듈의 Wi-Fi 기능관련 AT 커맨드 리스트는 하기 테이블과 같다. 각 명령어에 대한 구체적인 용법은 연이어 설명한다.
| No | 명령 | 설명 |
| W1301 | AT+SMARTSTART | 네트워크(AP) 접속(pairing) 모드를 설정하고 시작한다 |
| W1302 | AT+SMARTSTOP | 네트워크(AP) 접속(pairing) 모드를 중지 |
| W1303 | AT+SMARTCFG | Airkiss(wechat) 네트워크 접속모드 설정 |
| W1304 | AT+WFVER | RF 펌웨어 버전 쿼리 |
| W1305 | AT+WMAC | MAC 주소 쿼리 |
| W1306 | AT+WSCANOPT | WiFi 스캔 유형 설정/쿼리 |
| W1307 | AT+WSCAN | WiFi 스캐닝 시작 |
| W1308 | AT+WDHCP | Station의 DHCP 기능 설정/쿼리 |
| W1309 | AT+WSAPIP | Soft AP 모드 명령, 서브넷마스크, 게이트웨이 주소 설정/쿼리 |
| W1310 | AT+WSAP | Soft AP 모드 명령, AP의 이름 과 암호 설정 및 쿼리하고 Soft AP 모드를 시작 |
| W1311 | AT+WSAPQ | Soft AP 모드 명령, AP 끄기 |
| W1312 | AT+WSAPS | Soft AP 모드 명령, AP의 현재 상태쿼리 |
| W1313 | AT+WJAPIP | IP, 서브넷 마스크, 게이트웨이 주소 설정/쿼리 |
| W1314 | AT+WJAP | Station 모드에서 AP 이름 및 암호 설정/쿼리하고 AP에 연결 |
| W1315 | AT+WJAPQ | AP와 연결 해제 |
| W1316 | AT+WJAPS | 현재의 Station 연결 상태쿼리 |
W1301 AT+SMARTSTART 통신모듈을 네트워크/Home AP에 접속하는 방식을 설정하고 접속을 시작한다.
| 실행명령 | AT+SMARTSTART=<type> |
| 응답 | OK |
| 매개변수 | type= 1, 2, 3 → 1(easylink), 2(Airkiss), 3(Easylink_AWS) |
| 1 → Easylink ( Easylink_AWS의 Old 버전) | |
| 2 → Airkiss (Wechat 방식) | |
| 3 → Easylink_AWS (최신 Easylink 버전, 여기서 AWS는 아마존하고는 상관없는 명칭) | |
| 4 → Easylink + Airkiss 짬뽕 (사용할 일 없음) | |
| 5 → Soft AP | |
| 설명 | 명령 후 즉시 발효 |
Usage: Easylink_AWS로 네트워크 접속하기(AP Pairing)
⊗ 여기서 AWS는 Amazon Web Service와 아무런 관련이 없으며 Easylink의 버전에 대한 명칭일 뿐이다.
|
AT\r AT+SMARTSTART=3\r |
[2021-05-20 19:33:20.340 T]AT [2021-05-20 19:33:20.380 R]AT OK [2021-05-20 19:33:25.373 T]AT+SMARTSTART=3 [2021-05-20 19:33:25.403 R]AT+SMARTSTART=3 [2021-05-20 19:33:26.415 R] [2021-05-20 19:33:38.495 R] [2021-05-20 19:33:44.074 T]AT+WJAPIP? [2021-05-20 19:33:44.119 R]AT+WJAPIP? +WJAPIP:192.168.0.143,255.255.255.0,192.168.0.1,168.126.63.1 |
W1302 AT+SMARTSTOP 네트워크 접속모드를 중지한다.
| 실행명령 | AT+SMARTSTOP=<type> |
| 응답 | OK |
| 매개변수 | Type= 1(Easylink), 2(Airkiss),3(Easylink_AWS), 4(짬뽕), 5(Soft AP) |
| 설명 | 명령 후 즉시 발효 |
W1303 AT+SMARTCFG Airkiss(Wechat) 네트워크 접속모드에 대한 설정
| 명령(설정) | AT+SMARTCFG=<device_id>,<original_id> |
| 응답 | OK |
| 매개변수 | device_id=WeChat 등록 시 백엔드에서 제공되는 문자열 |
| original_id= WeChat 등록 시 백엔드에서 제공되는 문자열 | |
| 설명 | 명령 후 즉시 발효。 |
W1304 AT+WFVER RF 드라이버 버전 쿼리
| 명령 | AT+WFVER |
| 응답 | +WFVER: <fver> |
| OK | |
| 매개변수 | fver: RF 펌웨어 버전 |
| 설명 | 명령 후 즉시 발효 |
W1305 AT+WMAC 모듈의 MAC 어드레스 쿼리
| 명령 | AT+WMAC |
| 응답 | +WMAC:<mac> |
| OK | |
| 매개변수 | mac：모듈의 MAC 주소 |
| 설명 | 명령 후 즉시 발효, MAC 주소 형식: XX:XX:XX:XX:XX:XX |
W1306 AT+WSCANOPT WiFi 스캐닝 유형 설정/쿼리
| 명령(쿼리) | AT+WSCANOPT\r |
| 응답 | +WSCANOPT:<option> |
| OK | |
| 매개변수 | 설정 명령의 매개변수 참조 |
| 명령(설정) | AT+WSCANOPT=<option> |
| 응답 | OK |
| 매개변수 | Option: 0(Normal Scan), 1(Advanced Scan) |
| 설명 |
명령 후 즉시 발효, Normal 스캔: SSID 및 신호 강도 만 포함한다. Advanced 스캔: SSID, BSSID, 암호방식, 채널, 신호강도를 포함한다. |
W1307 AT+WSCAN 지정한 AP 또는 모든 AP의 SSID 스캔
| 명령 | AT+WSCAN=<ssid> |
| 응답 | Normal 스캔: 응답: +WSCAN:<number>\r\n<ssid>,<rssi> |
| Advance 스캔: 응답: +WSCAN:<number>\r\n<ssid>,<bssid>,<en>,<channe>,<rssi> | |
| 매개변수 | 모든 AP의 스캔 명령 매개변수 참조 |
기능: 모든 AP를 검색
| 명령 | AT+WSCAN |
| 응답 | +WSCAN:<number> |
| <ssid>, [bssid], [en], [channe], <rssi> | |
| 매개변수 | number=검색된 AP 개수, 일반 및 고급 스캔 모두 표시 |
| ssid=검색된 AP의 SSID, 일반 및 고급 스캔 모두 표시 | |
| bssid= 검색된 AP의 BSSID, 고급 스캔에서만 표시 | |
| en=검색된 AP의 암호화 방법, 고급 스캔에서만 표시 | |
| channel= 검색된 AP의 채널, 고급 스캔에서만 표시 | |
| rssi=검색된 AP의 신호 강도 | |
| 설명 | 명령 후 즉시 발효。 |
W1308 AT+WDHCP Station의 DHCP 기능 사용 여부 설정/쿼리
| 명령(쿼리) | AT+WDHCP? |
| 응답 | +WDHCP:<option> |
| 매개변수 | 설정 명령의 매개변수 참조 |
| 명령(설정) | AT+WDHCP=<option> |
| 응답 | OK |
| 매개변수 | option：ON, OFF |
| 설명 | 명령 후 즉시 발효 |
W1309 AT+WSAPIP SoftAP 모드에서 모듈의 IP 주소 쿼리/설정
| 명령(쿼리) | AT+WSAPIP? |
| 응답 | +WSAPIP:<ip>,<netmask>,<gateway> |
| 매개변수 | 설정 명령의 매개변수 참조 |
| 명령(설정) | AT+WSAPIP=<ip>[,<netmask>,<gateway>] |
| 응답 | OK |
| 매개변수 | ip=SoftAP 의 IP 주소 |
| netmask= subnet mask | |
| gateway=gateway 주소 | |
| 설명 | 명령 후 즉시 발효。 모듈 출하시 기본값은 0 |
Usage: SoftAP의 IP, Netmask, Gateway 변경하기
|
AT+WSAPIP=192.168.0.1,255.255.255.0,192.168.0.1\r AT+WSAP=MOMO,momo1234\r AT+WSAPIP?\r
|
[2021-05-20 19:11:40.899 T]AT+WSAPIP=192.168.0.1,255.255.255.0,192.168.0.1 [2021-05-20 19:11:40.939 R]AT+WSAPIP=192.168.0.1,255.255.255.0,192.168.0.1 OK [2021-05-20 19:11:47.662 T]AT+WSAP=MOMO,momo1234 [2021-05-20 19:11:47.692 R]AT+WSAP=MOMO,momo1234 [2021-05-20 19:11:47.812 R] [2021-05-20 19:11:48.067 R] OK [2021-05-20 19:11:51.004 R] [2021-05-20 19:11:57.521 T]AT+WSAPIP? [2021-05-20 19:11:57.564 R]AT+WSAPIP? +WSAPIP:192.168.0.1,255.255.255.0,192.168.0.1 |
W1310 AT+WSAP SoftAP의 이름, 암호를 채널을 설정 및 쿼리, SoftAP를 시작
| 명령(쿼리) | AT+WSAP=? |
| 응답 | +WSAP:<ssid>,<key> |
| 매개변수 | 설정 명령의 매개변수 참조 |
| 명령(설정) | AT+WSAP=<ssid>,<key>.[<channel>] |
| 응답 | OK |
| 매개변수 | ssid=SoftAP의 SSID, 최대 32자리 |
|
key=SoftAP 암호(최대 64자리) 길이가 8 자리보다 작으면 암호화 방법은 Open이고 8자리 이상이면 암호화 방법은 WPA. |
|
| channel= 2.4GHz 또는 5GHz 채널 번호, 채널를 수동으로 설정하고 자 하는 경우 옵션 사용, 기본으로는 2.4GHz 채널로 자동설정 | |
| 설명 | 명령 후 즉시 발효。 모듈 출하시 기본값은 0 |
주의사항
EMW3380의 경우 2.4GHz와 5GHz의 두 밴드가 하나의 Antenna Port를 공유하고 있으므로 동시에 두 밴드에서 동작을 지원하지는 않는다.
(1) EMC3380은 Dual Mode(Station & SoftAP) 동작을 지원하며 Dual band 동작에서는 2.4GHz 또는 5.GHz Band 중 하나의 Band에서 동작한다.
(2) Dual Mode 동작에서 Station이 연결된 밴드로 SoftAP의 밴들를 바꾸는 것으로 확인되고 있다.
W1311 AT+WSAPQ SoftAP를 끄기
| 명령 | AT+WSAPQ |
| 응답 | OK |
| 매개변수 | 없음 |
| 설명 | 명령 후 즉시 발효。 |
W1312 AT+WSAPS SoftAP의 현재 상태를 확인
| 명령 | AT+WSAPS |
| 응답 | +WSAPS:<state> |
| 매개변수 | State=AP_UP(Soft_AP가 동작하고 있음), AP_DOWN(Soft_AP 꺼져 있음). |
| 설명 | 명령 후 즉시 발효. |
W1313 AT+WJAPIP Station 모드에서 통신모듈의 IP주소를 조회/설정.
| 명령(쿼리) | AT+WJAPIP? |
| 응답 | +WJAPIP:<ip>,<network>,<gateway>,<dns> |
| 매개변수 | 설정 명령의 매개변수 참조 |
| 명령(설정) | AT+WJAPIP=<ip>,<network>,<gateway>[,<dns>] |
| 응답 | OK |
| 매개변수 | ip=Station 모드에서의 모듈의 IP주소. |
| network=서브넷 마스크 | |
| gateway=게이트웨이 주소 | |
| dns=도메인네임 서비스 주소 | |
| 설명 |
설정한 후 AP 접속 명령(AT+WJAP)으로 설정 값이 보존(Flash)되며, AP에 새로운 접속이 성공한 후 설정 값이 쿼리된다. 설정한 후 AP에 새로운 접속이 실패한 상태에서는 최근 접속상태에 의한 정보 값이 쿼리된다. 단, 리부팅 후 AP에 접속된 이력이 없는 경우 0으로 쿼리된다. |
W1314 AT+WJAP (1) Station이 접속할 AP에 대한 SSID와 암호의 설정, 쿼리 또는 (2) Station모드에서 WiFi의 현재 접속상태를 쿼리
| 명령(쿼리) | AT+WJAP=? |
| 응답 | +WJAP:<ssid>,<key> |
| 매개변수 | ssid= 접속할 AP의 이름 |
| key= 접속할 AP의 암호 |
| 명령(쿼리) | AT+WJAP? |
| 응답 | +WJAP:<ssid>,<bssid>,<channel>,<rssi> |
| 매개변수 | ssid=연결 된 AP의 SSID |
| bssid=연결 된 AP의 MAC 주소 | |
| channel=연결 된 AP의 채널 번호 | |
| rssi=연결 된 AP의 신호 감도 | |
| 설명 | 통신모듈이 AP에 연결이 실패하면 각 파리미터의 기본 값은 0.. |
| 명령(설정) | AT+WJAP=<ssid>,<key>[,<bssid>] |
| 응답 | OK |
| 매개변수 | ssid= 접속할 AP의 이름 |
| key= 접속할 AP의 암호 | |
| bssid= 접속할 AP의 MAC → 주변에 동일한 SSID를 보유한 AP들을 서로 구분하는데 사용할 수 있다. | |
| 설명 | 명령 후 즉시 발효. |
W1315 AT+WJAPQ Station 모드를 끄기
| 명령 | AT+WJAPQ |
| 응답 | OK |
| 매개변수 | 없음 |
| 설명 | 명령 후 즉시 발효 |
W1316 AT+WJAPS Station Mode 연결 상태 확인
| 명령 | AT+WJAPS |
| 응답 | +WJAPS:<state> |
| 매개변수 | state=AP_UP(AP에 연결되어 있음), AP_DOWN(AP에 접속 실패) 나타냄, CONNECTING(AP에 연결 중) |
| 연결이 실패하면 오류코드가 반환됨, 0(알 수 없는 오류), 1(암호 오류), 2(SSID를 찾을 수 없음) | |
| 설명 | 명령 후 즉시 발효。 |
WiFi IoT Module
Bluetooth Module
5G/LTE/CAT-M1/NB-IoT
