Skip to content

Commit 7fde2e8

Browse files
author
shennongmin
committed
Update docs
1 parent 4a7f41e commit 7fde2e8

File tree

53 files changed

+3640
-1199
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

53 files changed

+3640
-1199
lines changed

ESP8266.h

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ class ESP8266 {
106106
/**
107107
* Start function of deep sleep.
108108
*
109-
* @param time - the sleep time
109+
* @param time - the sleep time.
110110
* @retval true - success.
111111
* @retval false - failure.
112112
* @note the feature requires hardware support.
@@ -134,7 +134,8 @@ class ESP8266 {
134134
/**
135135
* Set up a serial port configuration.
136136
*
137-
* @param mode -1 send "AT+UART=", -2 send "AT+UART_CUR=", -3 send "AT+UART_DEF=".
137+
* @param pattern -1 send "AT+UART=", -2 send "AT+UART_CUR=", -3 send "AT+UART_DEF=".
138+
* @param baudrate - the uart baudrate.
138139
* @retval true - success.
139140
* @retval false - failure.
140141
* @note Only allows baud rate design, for the other parameters:databits- 8,stopbits -1,parity -0,flow control -0 .
@@ -144,7 +145,8 @@ class ESP8266 {
144145
/**
145146
* Set operation mode to station.
146147
*
147-
* @param pattern -1, send "AT+CWMODE_DEF",-2,send "AT+CWMODE_CUR",-3,send "AT+CWMODE".
148+
* @param pattern1 -1, send "AT+CWMODE_DEF?",-2,send "AT+CWMODE_CUR?",-3,send "AT+CWMODE?".
149+
* @param pattern2 -1, send "AT+CWMODE_DEF=",-2,send "AT+CWMODE_CUR=",-3,send "AT+CWMODE=".
148150
* @retval true - success.
149151
* @retval false - failure.
150152
*
@@ -154,13 +156,14 @@ class ESP8266 {
154156
/**
155157
* Get the model values list.
156158
*
157-
* @rerurns the list of model.
159+
* @return the list of model.
158160
*/
159161
String getWifiModeList(void);
160162

161163
/**
162164
* Set operation mode to softap.
163-
* if pattern - 1,send "AT+CWMODE_DEF",-2,send "AT+CWMODE_CUR",-3,send "AT+CWMODE".
165+
* @param pattern1 -1, send "AT+CWMODE_DEF?",-2,send "AT+CWMODE_CUR?",-3,send "AT+CWMODE?".
166+
* @param pattern2 -1, send "AT+CWMODE_DEF=",-2,send "AT+CWMODE_CUR=",-3,send "AT+CWMODE=".
164167
*
165168
* @retval true - success.
166169
* @retval false - failure.
@@ -169,7 +172,8 @@ class ESP8266 {
169172

170173
/**
171174
* Set operation mode to station + softap.
172-
* @param pattern -1, send "AT+CWMODE_DEF",-2,send "AT+CWMODE_CUR",-3,send "AT+CWMODE".
175+
* @param pattern1 -1, send "AT+CWMODE_DEF?",-2,send "AT+CWMODE_CUR?",-3,send "AT+CWMODE?".
176+
* @param pattern2 -1, send "AT+CWMODE_DEF=",-2,send "AT+CWMODE_CUR=",-3,send "AT+CWMODE=".
173177
*
174178
* @retval true - success.
175179
* @retval false - failure.
@@ -232,11 +236,6 @@ class ESP8266 {
232236
* get SoftAP parameters.
233237
*
234238
* @param pattern -1 send "AT+CWSAP_DEF?" -2 send "AT+CWSAP_CUR?" -3 send "AT+CWSAP?".
235-
* @param ssid - SSID of SoftAP.
236-
* @param pwd - PASSWORD of SoftAP.
237-
* @param chl - the channel (1 - 13, default: 7).
238-
* @param ecn - the way of encrypstion (0 - OPEN, 1 - WEP,
239-
* 2 - WPA_PSK, 3 - WPA2_PSK, 4 - WPA_WPA2_PSK, default: 4).
240239
* @note This method should not be called when station mode.
241240
*/
242241
String getSoftAPParam(uint8_t pattern=3);
@@ -261,14 +260,16 @@ class ESP8266 {
261260
/**
262261
* Set the state of DHCP.
263262
* @param pattern -1 send "AT+CWDHCP_DEF=" -2 send "AT+CWDHCP_CUR=" -3 send "AT+CWDHCP=".
263+
* @param mode - set ap or set station or set ap + station.
264+
* @param en - 0 disable DHCP - 1 enable DHCP.
264265
* @retval true - success.
265266
* @retval false - failure.
266267
*/
267268
bool setDHCP(uint8_t mode, uint8_t en, uint8_t pattern=3);
268269

269270
/**
270271
* make boot automatically connected.
271-
* @en -1 enable -0 disable.
272+
* @param en -1 enable -0 disable.
272273
* @retval true - success.
273274
* @retval false - failure.
274275
*/
@@ -285,6 +286,7 @@ class ESP8266 {
285286
/**
286287
* Set the station's MAC address.
287288
* @param pattern -1 send "AT+CIPSTAMAC_DEF=" -2 send "AT+CIPSTAMAC_CUR=" -3 send "AT+CIPSTAMAC=".
289+
* @param mac - the mac address of station.
288290
* @retval true - success.
289291
* @retval false - failure.
290292
*/
@@ -301,6 +303,9 @@ class ESP8266 {
301303
/**
302304
* Set the station's IP.
303305
* @param pattern -1 send "AT+CIPSTA_DEF=" -2 send "AT+CIPSTA_CUR=" -3 send "AT+CIPSTA=".
306+
* @param ip - the ip of station.
307+
* @param gateway -the gateway of station.
308+
* @param netmask -the netmask of station.
304309
* @retval true - success.
305310
* @retval false - failure.
306311
* @note This method should not be called when ap mode.
@@ -309,7 +314,7 @@ class ESP8266 {
309314

310315
/**
311316
* Get the AP's IP.
312-
* @Param pattern -1 send "AT+CIPAP_DEF?" -2 send "AT+CIPAP_CUR?" -3 send "AT+CIPAP?".
317+
* @param pattern -1 send "AT+CIPAP_DEF?" -2 send "AT+CIPAP_CUR?" -3 send "AT+CIPAP?".
313318
* @return ap's ip.
314319
* @note This method should not be called when station mode.
315320
*
@@ -319,6 +324,7 @@ class ESP8266 {
319324
/**
320325
* Set the AP IP.
321326
* @param pattern -1 send "AT+CIPAP_DEF=" -2 send "AT+CIPAP_CUR=" -3 send "AT+CIPAP=".
327+
* @param ip - the ip of AP.
322328
* @retval true - success.
323329
* @retval false - failure.
324330
* @note This method should not be called when station mode.
@@ -376,7 +382,6 @@ class ESP8266 {
376382
*/
377383
bool disableMUX(void);
378384

379-
380385
/**
381386
* Create TCP connection in single mode.
382387
*
@@ -453,7 +458,6 @@ class ESP8266 {
453458
*/
454459
bool unregisterUDP(uint8_t mux_id);
455460

456-
457461
/**
458462
* Set the timeout of TCP Server.
459463
*
@@ -487,6 +491,7 @@ class ESP8266 {
487491
* @retval false - failure.
488492
*/
489493
bool stopTCPServer(void);
494+
490495
/**
491496
*Set the module transfer mode
492497
*
@@ -655,11 +660,11 @@ class ESP8266 {
655660
bool qATCIPSTAMAC(String &mac,uint8_t pattern=3);
656661
bool eATCIPSTAMAC(String mac,uint8_t pattern=3);
657662
bool qATCIPSTAIP(String &ip,uint8_t pattern=3);
658-
bool eATCIPSTAIP(String ip,String gateway,String netmask,uint8_t pattern=3);
659-
bool qATCIPAP(String &ip,uint8_t pattern=3);
660-
bool eATCIPAP(String ip,uint8_t pattern=3);
661-
bool eCWSTARTSMART(uint8_t type);
662-
bool eCWSTOPSMART(void);
663+
bool eATCIPSTAIP(String ip,String gateway,String netmask,uint8_t pattern=3);
664+
bool qATCIPAP(String &ip,uint8_t pattern=3);
665+
bool eATCIPAP(String ip,uint8_t pattern=3);
666+
bool eCWSTARTSMART(uint8_t type);
667+
bool eCWSTOPSMART(void);
663668

664669

665670
bool eATCIPSTATUS(String &list);

doc/API-html/_connect_wi_fi_8ino-example.html

Lines changed: 3 additions & 3 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

doc/API-html/_connect_wi_fi_8ino_source.html

Lines changed: 8 additions & 7 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

doc/API-html/_e_s_p8266_8cpp.html

Lines changed: 2 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)