Skip to content

Commit f71722e

Browse files
author
Veijo Pesonen
committed
Introduces configuration switches available
1 parent 1d0be78 commit f71722e

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,35 @@ ESP8266 modules come in different shapes and formats, but the most important fac
1212
- Setting up a UDP server is not possible.
1313
- The serial port does not have hardware flow control enabled by default. The AT command set does not either have a way to limit the download rate. Therefore, downloading anything larger than the serial port input buffer is unreliable. An application should be able to read fast enough to stay ahead of the network. This affects mostly the TCP protocol where data would be lost with no notification. On UDP, this would lead to only packet losses which the higher layer protocol should recover from.
1414

15+
## Mandatory configuration
16+
![mbed_lib.json](mbed_lib.json) configuration assumes Arduino form factor. Please adjust according to which board is in use. Parameters are overridable from your app config file.
17+
18+
Least one is expected to check are the following configuration parameters
19+
20+
```javascript
21+
{
22+
"name": "esp8266",
23+
"config": {
24+
"tx": {
25+
"help": "TX pin for serial connection",
26+
"value": "D1" <- Arduino assumed, adjust based on your board
27+
},
28+
"rx": {
29+
"help": "RX pin for serial connection",
30+
"value": "D0" <- Arduino assumed, adjust based on your board
31+
},
32+
"provide-default": {
33+
"help": "Provide default WifiInterface. [true/false]",
34+
"value": false <- Set to 'true' if this is the interface you are using
35+
},
36+
"socket-bufsize": {
37+
"help": "Max socket data heap usage",
38+
"value": 8192 <- Without HW flow control more is better. Once the limit is reached packets are dropped - does not matter is it TCP or UDP.
39+
}
40+
}
41+
}
42+
```
43+
1544
## UART HW flow control
1645

1746
UART HW flow control requires you to additionally wire the CTS and RTS flow control pins between your board and your ESP8266 module. Once this is done remember to add configuration option for flow control in your app config file. Here a [ST NUCLEO-F429ZI](https://os.mbed.com/platforms/ST-Nucleo-F429ZI/) board and [ESPBee XBee Module](https://www.cascologix.com/product/espbee/) are used as an example.

0 commit comments

Comments
 (0)