This is a project that attempts to make all (or at least most) of the I/O on the ESP8266 available over the network. Currently this includes GPIO's (as GPIO or PWM), I2C and the UART.
The GPIOs can be selected to work as "normal" input, "normal" output, "timer" mode (this means trigger once, either manually or at startup, or "blink" continuously) or "pwm" mode (16 bits PWM mode, running at 330 Hz, suitable for driving lighting).
The "normal" UART lines (TXD/RXD) are available and are bridged to the ESP8266's ip address at port 25. This is unless the UART lines are re-assigned as GPIOs, which is also possible.
GPIOs can also be selected to work as i2c lines (sda, scl). You can use the "raw" i2c send and receive commands to send/receive arbitrary commands/data to arbitrary slaves. For a number of i2c sensors there is built-in support, which allows you to read them out directly, where a temperature etc. is given as result.
The firmware also listens at tcp port 24, and that is where the configuration and commands go to. Type telnet <ip_address> 24 and type ? for help.
The project is still in development, expect more features in the future.
The UART bridge accepts connections on tcp port 23, gets all data from it, sends it to the UART (serial port) and the other way around. This is the way to go to make your non-networking microcontroller WiFi-ready. If you add an RS-232C buffer (something like a MAX232 or similar), you can even make your non-networking peripherals like printers etc. available over the wireless lan.
The UART driver is heavily optimised and is completely interrupt driven, no polling, which makes it very efficient.
This code is very loosely based on the work of beckdac (https://github.com/beckdac/ESP8266-transparent-bridge), which I used as a starting point, although there hasn't been any original code left for some time ;-)
This is how it works:
- Attach your microcontroller's UART lines or RS232C's line driver lines to the ESP8266, I think enough has been written about how to do that.
- Load a generic "AT-command" style firmware into the ESP8266. Exactly how to do that should be on the page you're downloading the firmware from.
- Setup the wlan parameters (SSID and password) from this firmware, using a terminal emulator. Check it's working and write to flash (if the firmware doesn't do that automatically).
- Now flash this firmware, for example with the esptool.py command, something like this:
esptool.py --port /dev/pl2303 --baud 460800 write_flash 0x00000 fw-0x00000.bin 0x40000 fw-0x40000.bin. Replace /dev/pl2303 by the proper device node. The ESP8266 can indeed be flashed at this high speed, it's autoprobing the baud rate. If it doesn't succeed immediately, try again, sometimes the ESP8266 gets the baud rate wrong initially. If it still doesn't work, try a lower baud rate. - After flashing restart. In theory this is not necessary, but I found the UART won't start if you leave out the reset.
- Start a
telnetsession to port 24 of the ip address, typehelpand<enter>. - You will now see all commands.
- Use the commands starting with baud to setup the UART. After that, issue the
config-writecommand to save and use theresetcommand to restart. - After restart you will have a transparent connection between tcp port 23 and the UART, tcp port 24 is always available for control.
To work with i2c, first select two GPIO's as sda and scl lines using the gm .. mode sda and gm .. mode scl commands. Besides the "normal" GPIOs, it should be possible to use GPIO0 and GPIO2 for i2c (boot selection), just as GPIO1 and GPIO3 (normally connected to the UART) using a proper pull-up resistor, but I didn't try it myself.
The selected GPIO's are set to open drain mode without pull-up, so you will have to add them yourself. The proper value of the resistors should be calculated but 4.7 kOhm usually works just fine.
Use the i2c-address, i2c-read and i2c-write commands to read/write raw data to/from i2c slaves.
For a selection of well-known i2c sensors, there is built-in support. Use the i2c-sensor-dump and i2c-sensor-read commands for these.
Currently supported i2c sensors are:
- digipicco (temperature and humidity)
- lm75 (and compatible sensors) (temperature)
- ds1621/ds1631/ds1731 (temperature)
- bmp085 (temperature and pressure) (untested for now)
- htu21 (temperature and humdity) (untested for now)
- am2321 (temperature and humidity)
- tsl2560 (light intensity)
- bh1750 (light intensity).
| short | long | parameters | description |
|---|---|---|---|
| ub | uart-baud | baud rate | Any baud rate you like, forget the 300-600-1200-2400-etc. list, the ESP8266 can freely use any baud rate you like. Don't forget to config-write and reset. |
| ud | uart-data | 5, 6, 7, or 8 | The number of data bits, usually 8. |
| us | uart-stop | 1 or 2 | The number of stop bits, usually 1. |
| up | uart-parity | none, even or odd | The parity, usually none. Don't forget to set data bits to 7 if you want to use any parity. |
| short | long | parameters | description |
|---|---|---|---|
| cd | config-dump | none | Shows the complete configuration as stored in non volatile memory. |
| cw | config-write | none | Writes config to non volatile memory. |
| short | long | parameters | description |
|---|---|---|---|
| gd | gpio-dump | none | Dump GPIO configuration and current status. |
| gg | gpio-get | gpio | Read GPIO. For example gg 2 reads the GPIO 2 as input. |
| gs | gpio-set | gpio [value] | Set the GPIO if it's set as output, if set as timer, trigger the timer, if it's set as pwm, set the duty cycle (default startup value is taken if it's missing). |
| gm | gpio-mode | mode [mode parameters] | Without mode/parameters: dump all GPIOs and their mode. See the table below for available modes and their syntax when parameters are supplied. After making changes, use reset to enable the changes. |
| command: gm gpio mode | parameters: | description: | ||||
| disable | none | Dont' use the GPIO (leave completely untouched). | ||||
| input | none | Set GPIO to input. | ||||
| counter | [reset_on_get [debounce_time]] | Set GPIO to counter. Set reset_on_get to 1 to have the counter reset when read. Set debounce to set debounce time in milliseconds (default is 100 ms). | ||||
| output | startup-state | Set GPIO to output. Set startup-state to 0 or 1 to configure the state of the output directly after start. | ||||
| timer | direction delay repeat autotrigger |
|
||||
| pwm | [startup-duty-cycle] | startup duty cycle is the duty cycle after boot, default 0. The duty cycle can be 0 (off) to 65535 (continuously on). | ||||
| i2c | sda or scl | configure this GPIO for i2c operation. Specify two GPIOs to assign to sda and scl. |
| short | long | parameters | description |
|---|---|---|---|
| ia | i2c-address | address | set i2c slave's client address for subsequent read and write commands. |
| ir | i2c-read | bytes | Read (raw) this amount of bytes from the i2c slave. The bytes returned are in hex. |
| iw | i2c_write | byte [byte ...] | Write (raw) bytes to i2c slave. Format is hex bytes separated by a space, e.g. 1 2 a b cc. |
| irst | i2c-reset | none | Reset the i2c bus. Required whenever a read or write failed. |
| isd | i2c-sensor-dump | [verbose] | Dump all detected sensors on the i2c bus. Set verbose to 1 to list all known sensors, including those that are not detected, set verbose to 2 to get even more verbose output, including i2c bus errors. |
| isr | i2c-sensor-read | sensor-id | Get the value of the sensor with id sensor id. Obtain sensor id's with i2c-sensor-dump. |
| isc | i2c-sensor-calibrate | sensor-id scale offset | Set calibration of the sensor with id sensor id. The result from the sensor is multiplied by scale and then offset is added. Both values may be negative and are floating point types. Don't forget to write the config afterwards. |
| short | long | parameters | description |
|---|---|---|---|
| ? | help | none | Shows list of commands. |
| s or u | set/unset | [option] | Sets / unset options. Add option to set/unset option, leave out the option to list all options. Currently known options are: print-debug, shows debug info on the UART (wlan, dhcp etc). strip-telnet, disable / enable stripping initial "garbage" from telnet at the UART bridge. tsl-high-sens, set tsl2550 and tsl2561 sensors to "high sensitivity mode", recommended unless operated outdoors in sunlight. bh-high-sens, set bh1750 sensor to "high sensitivity mode", recommended unless operated outdoors in sunlight. To activate, write config and restart. |
| q | quit | none | Disconnect from the control channel. |
| r | reset | none | Reset the ESP8266, required if you make changes to the UART parameters or to the GPIOs mode. |
| S | stats | none | Shows some statistics (timers, wlan, memory). These may change over time. |
| rs | rtc-set | hours minutes seconds | Set "real time clock". It's a real time clock in the sense that it counts hours, minutes, seconds. It may not be that precise. YMMV. |
See here for latest news and join the discussion: http://www.esp8266.com/viewtopic.php?t=3959, old topic: http://www.esp8266.com/viewtopic.php?&t=3212.