Skip to content

Commit

Permalink
more updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
dacb committed Dec 16, 2014
1 parent e23a4c9 commit a4068b5
Showing 1 changed file with 32 additions and 2 deletions.
34 changes: 32 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ Absolutely transparent bridge for the ESP8266
This is really basic firmware for the ESP that creates a totally transparent TCP socket to ESP UART0 bridge. Characters come in on one interface and go out the other. The totally transparent bridge mode is something that has been missing and is available on higher priced boards.

**Pros: **

* It works. Do you already have a serial project to which you just want to add WiFi? This is your ticket. No more dealing with the AT command set.
* You can program your Arduino over WiFi. Just hit the reset button and upload your sketch using avrdude's socket port, e.g.
```
Expand All @@ -20,7 +21,7 @@ avrdude -c avrisp -p m328p -P net:192.168.4.1:23 -F -U flash:w:mySketch.hex:i
```
#define CONFIG_DYNAMIC
```
The dynamic configuration commands are:
Telnet into the module and issue commands prefixed by +++AT to escape each command from bridge mode. The dynamic configuration commands are:
```
+++AT # do nothing, print OK
+++AT MODE # print current opmode
Expand All @@ -33,8 +34,37 @@ The dynamic configuration commands are:
+++AT RESET # software reset the unit
```
Upon success, all commands send back "OK" as their final output. Note that passwords may not contain spaces. For the softAP, the mode is fixed to AUTH_WPA_PSK.
Example session:
```
user@host:~$ telnet 192.168.1.197
Trying 192.168.1.197...
Connected to 192.168.1.197.
Escape character is '^]'.
+++AT MODE
MODE=3
OK
+++AT AP
SSID=ESP_9E2EA6 PASSWORD= AUTHMODE=0 CHANNEL=3
OK
+++AT AP newSSID password
OK
+++AT AP
SSID=newSSID PASSWORD=password AUTHMODE=2 CHANNEL=3
OK
+++AT AP ESP_9E2EA6
OK
+++AT AP
SSID=ESP_9E2EA6 PASSWORD= AUTHMODE=0 CHANNEL=3
OK
^]c
telnet> c
Connection closed.
```
In order, this gets the current opmode. Good, it is 3 for STA + AP. Next, the current AP settings are retrieved. Next, the AP ssid is changed to newSSID and the authmode set to WPA and a password set. The AP settings are retrieved again to verify. Finally, the AP SSID is changed back to the original and by not using a password, the authmode is set to OPEN.

**Cons:**

**Cons: **
* Unbuffered TCP writes. Each incoming UART character gets sent as a separate TCP packet. This could potentially impact performance, however, in my hands that hasn't been an issue.


Expand Down

0 comments on commit a4068b5

Please sign in to comment.