이 WiFiWebServer_RTL8720 라이브러리는 Realtek RTL8720DN, RTL8722DM 및 RTL8722CSM 보드를 위한 간단하면서도 완전한 WebServer 라이브러리입니다.
이 기능은 ESP32 WebServer
및 ESP8266WebServer
라이브러리의 기능과 유사하고 호환되므로 ESP8266/ESP32에서 스케치를 훨씬 쉽게 포팅할 수 있습니다.
이 WiFiWebServer_RTL8720 라이브러리는 ArduinoHttpClient 라이브러리 와 유사하고 호환되는 기능을 갖춘 고급 HTTP 및 WebSocket 클라이언트 도 제공합니다.
라이브러리는 다음을 지원합니다.
이는 다음을 기반으로 하고 수정되었습니다.
WiFiWebServer_RTL8720.h
헤더에 있는 WiFiWebServer
클래스는 GET 및 POST와 같은 HTTP 요청을 처리하는 방법을 알고 있으며 한 번에 하나의 클라이언트만 지원할 수 있는 간단한 웹 서버입니다.
이 WiFiWebServer_RTL8720 라이브러리는 현재 다음 보드를 지원합니다.
Arduino IDE 1.8.19+
.Arduino AmebaD core 3.1.4+
.Functional-Vlpp library v1.0.2+
서버의 람다 기능을 사용합니다. 설치합니다. 확인하다 가장 좋고 쉬운 방법은 Arduino Library Manager
사용하는 것입니다. WiFiWebServer_RTL8720 을 검색한 후 최신 버전을 선택/설치하세요. 자세한 지침을 보려면 이 링크를 사용할 수도 있습니다.
WiFiWebServer_RTL8720-main.zip
다운로드합니다.WiFiWebServer_RTL8720-main
디렉터리에 zip 파일을 추출합니다.WiFiWebServer_RTL8720-main
폴더를 ~/Arduino/libraries/
와 같은 Arduino 라이브러리 디렉터리에 복사합니다.PROGMEM과 관련된 컴파일 오류를 방지하려면 Realtek AmebaD core pgmspace.h 파일을 Realtek AmebaD 디렉터리(~/.arduino15/packages/realtek/hardware/AmebaD/3.1.4/cores/ambd/avr/pgmspace.h)에 복사해야 합니다. 시간).
Realtek AmebaD 코어 버전이 3.1.4라고 가정합니다. 이 파일은 다음 디렉터리에 복사되어야 합니다.
~/.arduino15/packages/realtek/hardware/AmebaD/3.1.4/cores/ambd/avr/pgmspace.h
새 버전이 설치될 때마다 이 파일을 새 버전 디렉터리에 복사하는 것을 잊지 마세요. 예를 들어 새 버전은 x.yy.zz입니다. 이 파일은 다음 디렉터리에 복사되어야 합니다.
~/.arduino15/packages/realtek/hardware/AmebaD/x.yy.zz/cores/ambd/avr/pgmspace.h
WiFiWebServer server ( 80 );
WiFiWebServer 클래스 객체를 생성합니다.
매개변수:
호스트 포트 번호: int port
(기본값은 표준 HTTP 포트 80)
서버 시작
void begin ();
들어오는 클라이언트 요청 처리
void handleClient ();
서버 비활성화
void close ();
void stop ();
두 방법 모두 동일하게 작동합니다.
클라이언트 요청 핸들러
void on ();
void addHandler ();
void onNotFound ();
void onFileUpload ();
예:
server.on( " / " , handlerFunction);
server.onNotFound(handlerFunction); // called when handler is not assigned
server.onFileUpload(handlerFunction); // handle file uploads
클라이언트에 응답 보내기
void send ();
void send_P ();
Parameters:
code
- HTTP 응답 코드는 200
또는 404
등일 수 있습니다.
content_type
- "text/plain"
또는 "image/png"
등과 같은 HTTP 콘텐츠 유형입니다.
content
- 실제 콘텐츠 본문
요청 인수에 대한 정보 가져오기
const String & arg ();
const String & argName ();
int args ();
bool hasArg ();
Function usage:
arg
- 요청 인수 값을 가져옵니다. arg("plain")
사용하여 POST 본문을 가져옵니다.
argName
- 요청 인수 이름을 가져옵니다.
args
- 인수 개수를 가져옵니다.
hasArg
- 인수가 존재하는지 확인
요청 헤더에 대한 정보 가져오기
const String & header ();
const String & headerName ();
const String & hostHeader ();
int headers ();
bool hasHeader ();
Function usage:
header
- 요청 헤더 값을 가져옵니다.
headerName
- 요청 헤더 이름을 가져옵니다.
hostHeader
- 사용 가능한 경우 요청 호스트 헤더를 가져오고, 그렇지 않으면 빈 문자열을 가져옵니다.
headers
- 헤더 수를 가져옵니다.
hasHeader
- 헤더가 존재하는지 확인
입증
bool authenticate ();
void requestAuthentication ();
Function usage:
authenticate
- 서버 인증, 클라이언트가 인증되면 true를 반환하고, 그렇지 않으면 false를 반환합니다.
requestAuthentication
- 클라이언트에 인증 실패 응답을 보냅니다.
Example Usage:
if (!server.authenticate(username, password))
{
server. requestAuthentication ();
}
const String& uri (); // get the current uri
HTTPMethod method (); // get the current method
WiFiClient client (); // get the current client
HTTPUpload& upload (); // get the current upload
void setContentLength (); // set content length
void sendHeader (); // send HTTP header
void sendContent (); // send content
void sendContent_P ();
void collectHeaders (); // set the request headers to collect
void serveStatic ();
size_t streamFile ();
WiFiWebServer_RTL8720/examples/AdvancedWebServer/AdvancedWebServer.ino
74723f4의 40~245행
WiFiWebServer_RTL8720/examples/AdvancedWebServer/defines.h
74723f4의 11~42행
다음은 Rtlduino RTL8720DN 에서 AdvancedWebServer 예제를 실행할 때의 디버그 터미널 출력 및 스크린샷입니다.
Starting AdvancedServer on Rtlduino RTL8720DN with RTL8720DN
WiFiWebServer_RTL8720 v1 .1.2
interface 0 is initialized
interface 1 is initialized
Initializing WIFI ...
WIFI initialized
Current Firmware Version = 1.0.0
Attempting to connect to SSID: HueNet1
RTL8721D[Driver]: set ssid [HueNet1]
RTL8721D[Driver]: rtw_set_wpa_ie[ 1160 ]: AuthKeyMgmt = 0x2
RTL8721D[Driver]: rtw_restruct_sec_ie[ 4225 ]: no pmksa cached
RTL8721D[Driver]: start auth to 68 : 7f : 74 : 94 :f4:a5
RTL8721D[Driver]: auth alg = 2
RTL8721D[Driver]:
OnAuthClient:algthm = 0 , seq = 2 , status = 0 , sae_msg_len = 11
RTL8721D[Driver]: auth success, start assoc
RTL8721D[Driver]: association success (res= 1 )
RTL8721D[Driver]: ClientSendEAPOL[1624]: no use cache pmksa
RTL8721D[Driver]: ClientSendEAPOL[1624]: no use cache pmksa
RTL8721D[Driver]: set pairwise key to hw: alg:4(WEP40- 1 WEP104- 5 TKIP- 2 AES- 4 )
RTL8721D[Driver]: set group key to hw: alg:2(WEP40- 1 WEP104- 5 TKIP- 2 AES- 4 ) keyid:1
Interface 0 IP address : 192.168.2.117
[INFO] Listen socket successfully
[INFO] Socket conntect successfully
HTTP server started @ 192.168.2.117
[INFO] Accept connection successfully
A client connected to this server :
[PORT]: 36912
[IP]:192.168.2.30
[INFO] Accept connection successfully
A client connected to this server :
[PORT]: 36914
[IP]:192.168.2.30
[WIFI] String Len = 0, extend to 2048
[INFO] Accept connection successfully
다음은 Rtlduino RTL8720DN 에서 예제 WebClient를 실행할 때의 디버그 터미널 출력 및 스크린샷입니다.
Starting WebClientRepeating on Rtlduino RTL8720DN with RTL8720DN
WiFiWebServer_RTL8720 v1 .1.2
interface 0 is initialized
interface 1 is initialized
Initializing WIFI ...
WIFI initialized
Current Firmware Version = 1.0.0
Attempting to connect to SSID: HueNet1
RTL8721D[Driver]: set ssid [HueNet1]
RTL8721D[Driver]: rtw_set_wpa_ie[ 1160 ]: AuthKeyMgmt = 0x2
RTL8721D[Driver]: rtw_restruct_sec_ie[ 4225 ]: no pmksa cached
RTL8721D[Driver]: start auth to 68 : 7f : 74 : 94 :f4:a5
RTL8721D[Driver]: auth alg = 2
RTL8721D[Driver]:
OnAuthClient:algthm = 0 , seq = 2 , status = 0 , sae_msg_len = 11
RTL8721D[Driver]: auth success, start assoc
RTL8721D[Driver]: association success (res= 1 )
RTL8721D[Driver]: ClientSendEAPOL[1624]: no use cache pmksa
RTL8721D[Driver]: ClientSendEAPOL[1624]: no use cache pmksa
RTL8721D[Driver]: set pairwise key to hw: alg:4(WEP40- 1 WEP104- 5 TKIP- 2 AES- 4 )
RTL8721D[Driver]: set group key to hw: alg:2(WEP40- 1 WEP104- 5 TKIP- 2 AES- 4 ) keyid:1
Interface 0 IP address : 192.168.2.117You're connected to the network, IP = 192.168.2.117
SSID: HueNet1, Signal strength (RSSI):-26 dBm
[INFO]server_drv.cpp: start_client
[INFO] Create socket successfully
[INFO] Connect to Server successfully!
Connecting...
HTTP/1.1 200 OK
Date: Thu, 28 Apr 2022 02:46:07 GMT
Content-Type: text/plain
Content-Length: 2263
Connection: close
x-amz-id-2: 0v2VZitmKPb1GvH/Of2rACgGVIyluvsMCTX1kbkYKmtOMZMLlHXAT1n7wdAcMiFQ6LPQ1Qy2tSg=
x-amz-request-id: 72CSXT4AMDTCDJYE
Last-Modified: Wed, 23 Feb 2022 14:56:42 GMT
ETag: "667cf48afcc12c38c8c1637947a04224"
CF-Cache-Status: DYNAMIC
Report-To: { " endpoints " :[{ " url " : " https://a.nel.cloudflare.com/report/v3?s=vdeduIIMRyhO44T972z7Z0qfco3T5svA5zYhyMJqQE5hTNGvTxTg%2B8S8e90uedVsSDo5oj73gg%2BxEoPfXW1%2FUCfu6XkFt6oLuf9zjLCo%2BSe58OLsZhr25mZ3MxPD%2ByY%3D " }], " group " : " cf-nel " , " max_age " : 604800 }
NEL: { " success_fraction " : 0 , " report_to " : " cf-nel " , " max_age " : 604800 }
Server: cloudflare
CF-RAY: 702c77389848b671-YWG
alt-svc: h3= " :443 " ; ma= 86400 , h3- 29 = " :443 " ; ma= 86400
`:;;;,` .:;;:.
.;;;;;;;;;;;` :;;;;;;;;;;: TM
`;;;;;;;;;;;;;;;` :;;;;;;;;;;;;;;;
:;;;;;;;;;;;;;;;;;; `;;;;;;;;;;;;;;;;;;
;;;;;;;;;;;;;;;;;;;;; .;;;;;;;;;;;;;;;;;;;;
;;;;;;;;:` `;;;;;;;;; ,;;;;;;;;.` .;;;;;;;;
.;;;;;;, :;;;;;;; .;;;;;;; ;;;;;;;
;;;;;; ;;;;;;; ;;;;;;, ;;;;;;.
,;;;;; ;;;;;;.;;;;;;` ;;;;;;
;;;;;. ;;;;;;;;;;;` ``` ;;;;;`
;;;;; ;;;;;;;;;, ;;; .;;;;;
`;;;;: `;;;;;;;; ;;; ;;;;;
,;;;;` `,,,,,,,, ;;;;;;; .,,;;;,,, ;;;;;
:;;;;` .;;;;;;;; ;;;;;, :;;;;;;;; ;;;;;
:;;;;` .;;;;;;;; `;;;;;; :;;;;;;;; ;;;;;
.;;;;. ;;;;;;;. ;;; ;;;;;
;;;;; ;;;;;;;;; ;;; ;;;;;
;;;;; .;;;;;;;;;; ;;; ;;;;;,
;;;;;; `;;;;;;;;;;;; ;;;;;
`;;;;;, .;;;;;; ;;;;;;; ;;;;;;
;;;;;;: :;;;;;;. ;;;;;;; ;;;;;;
;;;;;;;` .;;;;;;;, ;;;;;;;; ;;;;;;;:
;;;;;;;;;:,:;;;;;;;;;: ;;;;;;;;;;:,;;;;;;;;;;
`;;;;;;;;;;;;;;;;;;;. ;;;;;;;;;;;;;;;;;;;;
;;;;;;;;;;;;;;;;; :;;;;;;;;;;;;;;;;:
,;;;;;;;;;;;;;, ;;;;;;;;;;;;;;
.;;;;;;;;;` ,;;;;;;;;:
;;; ;;;;;` ;;;;: .;; ;; ,;;;;;, ;;. `;, ;;;;
;;; ;;:;;; ;;;;;; .;; ;; ,;;;;;: ;;; `;, ;;;:;;
,;:; ;; ;; ;; ;; .;; ;; ,;, ;;;,`;, ;; ;;
;; ;: ;; ;; ;; ;; .;; ;; ,;, ;;;;`;, ;; ;;.
;: ;; ;;;;;: ;; ;; .;; ;; ,;, ;;`;;;, ;; ;;`
,;;;;; ;;`;; ;; ;; .;; ;; ,;, ;; ;;;, ;; ;;
;; ,;, ;; .;; ;;;;;: ;;;;;: ,;;;;;: ;; ;;, ;;;;;;
;; ;; ;; ;;` ;;;;. `;;;: ,;;;;;, ;; ;;, ;;;;
다음은 Rtlduino RTL8720DN 에서 예제 ScanNetworks를 실행할 때의 디버그 터미널 출력 및 스크린샷입니다.
Starting ScanNetworks on Rtlduino RTL8720DN with RTL8720DN
WiFiWebServer_RTL8720 v1 .1.2
Current Firmware Version = 1.0.0
Attempting to connect to SSID: HueNet_5G
You ' re connected to the network, IP = 192.168.2.152
MAC address: 69:4E:06:60:C9:94
Scanning available networks...
Number of available networks:19
0) HueNet Signal: -26 dBm Encryption: WPA2_PSK
1) HueNet_5G Signal: -32 dBm Encryption: WPA2_PSK
2) HueNetTek Signal: -32 dBm Encryption: WPA2_PSK
3) HueNetTek_5G Signal: -33 dBm Encryption: WPA2_PSK
4) HueNet1 Signal: -36 dBm Encryption: WPA2_PSK
5) HueNet2 Signal: -58 dBm Encryption: WPA2_PSK
6) HueNet2_5G Signal: -60 dBm Encryption: WPA2_PSK
7) guest_24 Signal: -64 dBm Encryption: WPA2_PSK
8) bacau Signal: -65 dBm Encryption: WPA2_PSK
9) guest_5 Signal: -77 dBm Encryption: WPA2_PSK
10) pitesti Signal: -77 dBm Encryption: WPA2_PSK
다음은 Rtlduino RTL8720DN 에서 예제 MQTTClient_Auth를 실행할 때의 디버그 터미널 출력 및 스크린샷입니다.
Starting MQTTClient_Auth on Rtlduino RTL8720DN with RTL8720DN
WiFiWebServer_RTL8720 v1 .1.2
Current Firmware Version = 1.0.0
Attempting to connect to SSID: HueNet_5G
Connected! IP address: 192.168.2.152
Attempting MQTT connection to broker.emqx.io...connected
Message Send : MQTT_Pub => Hello from MQTTClient_Auth on Rtlduino RTL8720DN with RTL8720DN
Message arrived [MQTT_Pub] Hello from MQTTClient_Auth on Rtlduino RTL8720DN with RTL8720DN
Message Send : MQTT_Pub => Hello from MQTTClient_Auth on Rtlduino RTL8720DN with RTL8720DN
Message arrived [MQTT_Pub] Hello from MQTTClient_Auth on Rtlduino RTL8720DN with RTL8720DN
다음은 Rtlduino RTL8720DN 에서 예제 MQTT_ThingStream을 실행할 때의 디버그 터미널 출력 및 스크린샷입니다.
Start MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
WiFiWebServer_RTL8720 v1 .1.2
Current Firmware Version = 1.0.0
Attempting to connect to SSID: HueNet_5G
Connected! IP address: 192.168.2.152
***************************************
STM32_Pub
***************************************
Attempting MQTT connection to broker.emqx.io
...connected
Published connection message successfully!
Subscribed to: STM32_Sub
MQTT Message Send : STM32_Pub => Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
MQTT Message receive [STM32_Pub] Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
MQTT Message Send : STM32_Pub => Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
MQTT Message receive [STM32_Pub] Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
MQTT Message Send : STM32_Pub => Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
MQTT Message receive [STM32_Pub] Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
MQTT Message Send : STM32_Pub => Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
MQTT Message receive [STM32_Pub] Hello from MQTT_ThingStream on Rtlduino RTL8720DN with RTL8720DN
다음은 Rtlduino RTL8720DN 에서 예제 WiFiUdpNTPClient를 실행할 때의 디버그 터미널 출력 및 스크린샷입니다.
Starting WiFiUdpNTPClient on Rtlduino RTL8720DN with RTL8720DN
WiFiWebServer_RTL8720 v1 .1.2
Current Firmware Version = 1.0.0
Attempting to connect to SSID: HueNet_5G
Connected! IP address: 192.168.2.152
SSID: HueNet1, Signal strength (RSSI):-39 dBm
Starting connection to server...
Listening on port 2390
packet received
Seconds since Jan 1 1900 = 3835239949
Unix time = 1626251149
The UTC time is 8:25:49
packet received
Seconds since Jan 1 1900 = 3835239960
Unix time = 1626251160
The UTC time is 8:26:00
packet received
Seconds since Jan 1 1900 = 3835239971
Unix time = 1626251171
The UTC time is 8:26:11
디버그는 직렬에서 기본적으로 활성화됩니다. 디버그 수준은 0에서 4까지입니다. 비활성화하려면 WIFI_LOGLEVEL을 0으로 변경하세요.
// Use this to output debug msgs to Serial
# define DEBUG_WIFI_WEBSERVER_PORT Serial
// Debug Level from 0 to 4
# define _WIFI_LOGLEVEL_ 1
컴파일 오류가 자주 발생하는 경우 라이브러리의 패치, 패키지의 패치 또는 이 라이브러리 최신 버전을 적용하여 최신 버전의 보드 코어를 설치해야 할 수도 있습니다.
이 WiFiWebServer_RTL8720 라이브러리는 현재 다음 보드를 지원합니다.
라이브러리는 다음을 지원합니다.
문제 제출: WiFiWebServer_RTL8720 문제
arduino.cc
를 arduino.tips
로 변경합니다.allman
스타일을 이용하여 스타일을 추가해보세요. 라이브러리 스타일 바꾸기 ️️ 이반 그로호트코프 | ️ 아드리안 맥이웬 |
이 프로젝트에 기여하고 싶다면:
저작권 (c) 2021- 코이호앙