- 시리얼 터미널 프로그램 (Token2Shell, PuTTY, TeraTerm 등)
- TCP Server 프로그램 (Hercules 등)
본 문서에서는 Cat.M1 단말인 우리넷 외장형 모뎀의 HTTP 데이터 송수신 방법에 대한 가이드를 제공합니다.
외장형 모뎀은 UART 인터페이스를 통해 활용하는 AT 명령어로 제어하는 것이 일반적입니다. Cat.M1 모듈 제조사에 따라 AT 명령어의 차이는 있지만, 일반적인 HTTP client의 통신 과정은 다음과 같은 순서로 구현합니다.
- 네트워크 인터페이스 활성화
- HTTP 설정 - 목적지 URL, 옵션
- HTTP Request 전송
- HTTP Response 확인
- 네트워크 인터페이스 비활성화
추가적으로, TCP 가이드 문서에는 다른 응용 가이드 문서에는 포함되어 있지 않은 Cat.M1 단말의 상태 확인 및 PDP context 관련 명령어에 대한 내용이 함께 포함되어 있습니다. 해당 명령어는 응용 구현 시 필수적으로 활용되어야 하므로, 함께 확인하시기 바랍니다.
Cat M1 모듈의 에코 모드 설명, USIM 상태 확인, 네트워크 접속 확인, PDP Context 활성화 등의 일반적인 내용은 TCP 가이드를 참고하시기 바랍니다.
HTTP/HTTPS설정 및 확인
AT Command: AT*WHTTP
Syntax:
| Type | Syntax | Response | Example |
|---|---|---|---|
| Write | AT*WHTTP=<CODE>,<METHOD>,<URL>[,<PORT>[,<ID>[,<PW>[,<DATA>[,<HEAD>[,<HEADONLY>[,<HEADBODY>[,<NOCERT>[,<TIMEOUT>]]]]]]]]] | *WHTTP:<CODE>,<METHOD>,<URL>,<PORT>,<ID>,<PW>,<DATA>,<HEAD>,<HEADONLY>,<HEADBODY>,<NOCERT>,<TIMEOUT> OK |
AT*WHTTP=0,POST,google.com *WHTTP:HTTP,POST,google.com,0,,,,,0,0,0,10,TCP OK |
Defined values:
| Parameter | Type | Description |
|---|---|---|
| <CODE> | integer | Code Type 0: HTTP 1: HTTPS 2: OPTION 3: START 4: STOP |
| <METHOD> | string | GET, POST, PUT, DELETE |
| <URL> | string | HTTP Server의 URL |
| <PORT> | integer | HTTP Server의 Port Number 값이 없을 경우 Default Value |
| <ID> | string | ID 값이 없을 경우 ID 없음 |
| <PW> | string | Password 값이 없을 경우 Password 없음 |
| <DATA> | string | POST Data 값이 없을 경우 Data 없음 |
| <HEAD> | string | Header 입력(MAX 5개, 하나당 최대 64byte) 값이 없을 경우 Default Header |
| <HEADONLY> | integer | 0: Header, Content 모두 표시 1 : Header만 표시 값이 없을 경우 Body만 표시 |
| <HEADBODY> | integer | 0: Body만 표시 1 : Header, Body 모두 표시 값이 없을 경우 Body만 표시 |
| <NOCERT> | integer | 0 : SSL Cerificate검증 1 : SSL Cerificat 검증안함 값이 없을 경우 검증함 |
| <TIMEOUT> | integer | Connect Timeout 설정 값이 없거나 0일 경우 10초 |
HTTP/HTTPS옵션 설정 및 확인
AT Command: AT*WHTTP
Syntax:
| Type | Syntax | Response | Example |
|---|---|---|---|
| Write | AT*WHTTP=2,<value1>,<value2> | *WHTTP:<value1>,<value2> OK |
AT*WHTTP=2,HEAD,Content-Type: application/json *WHTTP: HEAD,Content-Type: application/json OK |
Defined values:
| Parameter | Type | Description |
|---|---|---|
| <value1> | string | METHOD, URL, PORT, ID, PW, DATA, HEAD, HEADONLY, HEADBODY, NOCERT, TIMEOUT |
| <value2> | string | <value1>-METHOD: GET,POST,PUT,DELETE <value1>-URL: HTTP Server의 URL <value1>-PORT: HTTP Server의 Port Number <value1>-ID: ID <value1>-PW: Password <value1>-DATA: HTTP Post Data <value1>-HEAD: Header 입력(MAX 5개, 하나당 최대 64byte) <value1>-HEADONLY: 0: Header, Content 모두 표시, 1 : Header만 표시 <value1>-HEADBODY: 0: Body만 표시, 1 : Header, Body 모두 표시 <value1>-NOCERT: 0 : SSL Cerificate검증, 1 : SSL Cerificat 검증 안함 <value1>-TIMEOUT: Connect Timeout 설정 |
HTTP/HTTPS 시작 및 정지 AT*WHTTP=3 명령으로 START 되며, 완료되기전에 AT*WHTTP=4 명령을 전송할 경우 중단된다.
AT Command: AT*WHTTP
Syntax:
| Type | Syntax | Response | Example |
|---|---|---|---|
| Write | AT*WHTTP=3 | *WHTTPR:START …. *WHTTPR:COMPLETED |
AT*WHTTP=3 *WHTTPR:START test2 *WHTTPR:COMPLETED |
| Write | AT*WHTTP=4 | [*WHTTPR:EXEC_FAILED] OK |
AT*WHTTP=4 *WHTTPR:START Terminated *WHTTPR:EXEC_FAILED OK |
- 모뎀을 PC와 Serial로 연결한 후 COM Port Number를 확인합니다.
- 확인한 COM Port Nubmer로 Serial Terminal 프로그램을 실행하여 Open합니다. TCP Socket을 생성하기전에 아래의 명령어를 수행합니다.
// Serial 통신 확인
AT
OK
// AT 명령어 echo 비활성화
ATE0
OK
// USIM 상태 확인 (READY : 정상)
AT$$STAT?
$$STAT:READY
OK
// 망 접속 확인
AT+CEREG?
+CEREG: 0,1
OK
// PDP context 활성화
AT*RNDISDATA=1
*RNDISDATA:1
OK
- HTTP를 설정합니다. Server주소는 google.com, POST method를 전송합니다.
- HTTP START를 설정하여 POST method를 전송하고 Response를 수신합니다.
