boards/esp8266: reformat text for 80 chars
This commit is contained in:
Gunar Schorcht
parent
bce0d4cb10
commit
4c03e9c113
@ -8,14 +8,23 @@
|
||||
|
||||
## Overview
|
||||
|
||||
This board definition covers not just a single board, but rather a large set of generic boards that either use one of the AI-Tinker ESP-12x ESP8266 modules or are compatible with them. ESP-12x stands for different versions of the ESP-12 module: ESP-12, ESP-12E, ESP-12E and ESP-12S.
|
||||
This board definition covers not just a single board, but rather a large
|
||||
set of generic boards that either use one of the AI-Tinker ESP-12x ESP8266
|
||||
modules or are compatible with them. ESP-12x stands for different versions
|
||||
of the ESP-12 module: ESP-12, ESP-12E, ESP-12E and ESP-12S.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/ESP-12F_Module.png" "ESP8266 ESP-12F module" width=250px
|
||||
\n
|
||||
|
||||
Common examples for this type of boards are the [WEMOS LOLIN D1 mini V2](#esp8266_wemos_lolin_d1_mini), the [NodeMCU DEVKIT](#esp8266_nodemcu_devkit_esp8266) and the [Adafruit Feather HUZZAH ESP8266](#esp8266_adafruit_feather_huzzah_esp8266). All these boards are characterized by using any of the ESP-12x module and breaking out all GPIO pins.
|
||||
Common examples for this type of boards are the
|
||||
[WEMOS LOLIN D1 mini V2](#esp8266_wemos_lolin_d1_mini), the
|
||||
[NodeMCU DEVKIT](#esp8266_nodemcu_devkit_esp8266) and the
|
||||
[Adafruit Feather HUZZAH ESP8266](#esp8266_adafruit_feather_huzzah_esp8266).
|
||||
All these boards are characterized by using any of the ESP-12x module and
|
||||
breaking out all GPIO pins.
|
||||
|
||||
@note This board definition is the most generic one and might also be used for other ESP8266 and ESP8285 boards.
|
||||
@note This board definition is the most generic one and might also be used
|
||||
for other ESP8266 and ESP8285 boards.
|
||||
|
||||
## MCU
|
||||
|
||||
@ -44,11 +53,13 @@ Technical Reference | [Technical Reference](https://www.espressif.com/sites/defa
|
||||
|
||||
## Flashing the Device
|
||||
|
||||
Flashing RIOT is quite straight forward, just connect the board using the programming port to your host computer and type:
|
||||
Flashing RIOT is quite straight forward, just connect the board using the
|
||||
programming port to your host computer and type:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
make flash BOARD=esp8266-esp-12x ...
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
For detailed information about ESP8266 as well as configuring and compiling RIOT for ESP8266 boards, see \ref esp8266_riot.
|
||||
For detailed information about ESP8266 as well as configuring and compiling
|
||||
RIOT for ESP8266 boards, see \ref esp8266_riot.
|
||||
|
||||
## WEMOS LOLIN D1 mini {#esp8266_wemos_lolin_d1_mini}
|
||||
|
||||
@ -65,12 +76,17 @@ without the need for a soldering iron or a breadboard.
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/Wemos_D1_mini_Stack.png" "WEMOS LOLIN D1 mini stack example" width=400px
|
||||
\n
|
||||
|
||||
There is also a MRF24J40 shield that can be used to extend the board with an IEEE 802.15.4 radio module, the standard networking technology in RIOT.
|
||||
There is also a MRF24J40 shield that can be used to extend the board with
|
||||
an IEEE 802.15.4 radio module, the standard networking technology in RIOT.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/Wemos_MRF24J40_Shield.png" "MRF24J40 shield for WEMOS LOLIN D1 mini" width=280px
|
||||
\n
|
||||
|
||||
There are several versions of WEMOS LOLIN D1 mini, which only differ in the size of the flash memory and the MCU version used. All versions have a microUSB port with flash / boot / reset logic that makes flashing much easier. Their peripherals are equal and work with the default ESP8266 ESP-12x board definition.
|
||||
There are several versions of WEMOS LOLIN D1 mini, which only differ in the
|
||||
size of the flash memory and the MCU version used. All versions have a
|
||||
microUSB port with flash / boot / reset logic that makes flashing much
|
||||
easier. Their peripherals are equal and work with the default ESP8266 ESP-12x
|
||||
board definition.
|
||||
|
||||
For more information, see [D1 Boards]
|
||||
(https://docs.wemos.cc/en/latest/d1/d1_mini.html).
|
||||
@ -85,26 +101,40 @@ D1 mini Pro | ESP8266EX | 16 MByte | ceramic | |
|
||||
</center>
|
||||
\n
|
||||
|
||||
Following image shows the pinout of all WEMOS LOLIN D1 mini boards. It is compatible with the WEMOS LOLIN D32 Pro ESP32 board.
|
||||
Following image shows the pinout of all WEMOS LOLIN D1 mini boards. It is
|
||||
compatible with the WEMOS LOLIN D32 Pro ESP32 board.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/Wemos_D1_mini_pinout.png" "WEMOS LOLIN D1 mini pinout"
|
||||
|
||||
## NodeMCU DEVKIT {#esp8266_nodemcu_devkit_esp8266}
|
||||
|
||||
NodeMCU DEVKIT is an open-source hardware project hosted on [GitHub](https://github.com/nodemcu/nodemcu-devkit-v1.0). Therefore, there are a lot of clones available. The board was originally designed for NodeMCU firmware development.
|
||||
NodeMCU DEVKIT is an open-source hardware project hosted on
|
||||
[GitHub](https://github.com/nodemcu/nodemcu-devkit-v1.0). Therefore,
|
||||
there are a lot of clones available. The board was originally designed
|
||||
for NodeMCU firmware development.
|
||||
|
||||
As the other boards described here, NodeMCU ESP12 is generic board that uses ESP-12E module and breaks out all available GPIO pins. It has a Micro-USB port including a flash/boot/reset logic which makes flashing much easier.
|
||||
As the other boards described here, NodeMCU ESP12 is generic board that
|
||||
uses ESP-12E module and breaks out all available GPIO pins. It has a
|
||||
Micro-USB port including a flash/boot/reset logic which makes flashing
|
||||
much easier.
|
||||
|
||||
@image html "https://raw.githubusercontent.com/nodemcu/nodemcu-devkit-v1.0/master/Documents/NodeMCU_DEVKIT_1.0.jpg" "NodeMCE DEVKIT V1.0" width=500px
|
||||
\n
|
||||
|
||||
Following image shows the pinout of NodeMCU DEVKIT boards.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/NodeMCU_pinout.png" "NodeMCE DEVKIT V1.0 pinout".
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/NodeMCU_pinout.png" "NodeMCE DEVKIT V1.0 pinout"
|
||||
|
||||
## Adafruit Feather HUZZAH ESP8266 {#esp8266_adafruit_feather_huzzah_esp8266}
|
||||
|
||||
Feather is the new series of development boards from Adafruit. [Adafruit Feather HUZZAH ESP8266](https://www.adafruit.com/product/2821) is a ESP8266 based development board with built in WiFi, USB and battery charging. As the other boards described here, Adafruit Feather HUZZAH ESP8266 is a generic board that uses an ESP-12x module and breaks out most of the available GPIO pins. It has one additional LED connected to GPIO0 and a Micro-USB port including a flash/boot/reset logic which makes flashing much easier.
|
||||
Feather is the new series of development boards from Adafruit.
|
||||
[Adafruit Feather HUZZAH ESP8266](https://www.adafruit.com/product/2821)
|
||||
is a ESP8266 based development board with built in WiFi, USB and battery
|
||||
charging. As the other boards described here, Adafruit Feather HUZZAH ESP8266
|
||||
is a generic board that uses an ESP-12x module and breaks out most of the
|
||||
available GPIO pins. It has one additional LED connected to GPIO0 and a
|
||||
Micro-USB port including a flash/boot/reset logic which makes flashing much
|
||||
easier.
|
||||
|
||||
@image html "https://cdn-shop.adafruit.com/640x480/2821-04.jpg" "Adafruit Feather HUZZAH ESP8266" width=500px
|
||||
\n
|
||||
|
||||
@ -6,16 +6,28 @@
|
||||
|
||||
## Overview
|
||||
|
||||
Olimex MOD-WIFI-ESP8266-DEV is a tiny development board that is available as open-source hardware at [GitHub](https://github.com/OLIMEX/ESP8266/tree/master/HARDWARE/MOD-WIFI-ESP8266-DEV). It uses Espressif's ESP8266EX SoC and was originally designed to add WiFi capabilities to existing boards.
|
||||
Olimex MOD-WIFI-ESP8266-DEV is a tiny development board that
|
||||
is available as open-source hardware at
|
||||
[GitHub](https://github.com/OLIMEX/ESP8266/tree/master/HARDWARE/MOD-WIFI-ESP8266-DEV).
|
||||
It uses Espressif's ESP8266EX SoC and was originally designed to add
|
||||
WiFi capabilities to existing boards.
|
||||
|
||||
Olimex MOD-WIFI-ESP8266-DEV belongs to the class of general purpose boards where all ESP8266EX pins are broken out for easier access. The board can either be soldered directly to a PCB or it can be used with a breadboard.
|
||||
Olimex MOD-WIFI-ESP8266-DEV belongs to the class of general purpose
|
||||
boards where all ESP8266EX pins are broken out for easier access. The
|
||||
board can either be soldered directly to a PCB or it can be used with
|
||||
a breadboard.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/Olimex-MOD-DEV.png" "Olimex MOD-WIFI-ESP8266-DEV"
|
||||
\n
|
||||
|
||||
The board provides some pads for an UEXT interface. UEXT interface (introduced by Olimex) can be used to connect different peripherals to the board. This UEXT interface comprises the 3 serial interfaces UART, SPI and I2C. For more information about UEXT, see [UEXT](https://www.olimex.com/Products/Modules/UEXT).
|
||||
The board provides some pads for an UEXT interface. UEXT interface
|
||||
(introduced by Olimex) can be used to connect different peripherals
|
||||
to the board. This UEXT interface comprises the 3 serial interfaces
|
||||
UART, SPI and I2C. For more information about UEXT, see
|
||||
[UEXT](https://www.olimex.com/Products/Modules/UEXT).
|
||||
|
||||
Together with the Olimex ESP8266-EVB evaluation board, a development platform for IoT devices is available.
|
||||
Together with the Olimex ESP8266-EVB evaluation board, a development
|
||||
platform for IoT devices is available.
|
||||
|
||||
@image html "https://www.olimex.com/Products/IoT/ESP8266-EVB/images/ESP8266-EVB.jpg" "Olimex ESP8266-EVB"
|
||||
|
||||
@ -50,25 +62,39 @@ Board Schematic | [Board Schematic](https://github.com/OLIMEX/ESP8266/blob/maste
|
||||
|
||||
### RIOT Pin Mapping
|
||||
|
||||
Olimex MOD-WIFI-ESP8266-DEV has 22 pin holes that can be soldered to PCB or used with a breadboard. The following figure shows the mapping of these pin holes to RIOT pins.
|
||||
Olimex MOD-WIFI-ESP8266-DEV has 22 pin holes that can be soldered to PCB
|
||||
or used with a breadboard. The following figure shows the mapping of these
|
||||
pin holes to RIOT pins.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/Olimex-MOD-DEV_pins.png" "Olimex MOD-WIFI-ESP8266-DEV pin mapping"
|
||||
\n
|
||||
|
||||
Since GPIOs 6, 7, 8, and 11 are used for flash memory, they cannot be used for other purposes. Furthermore, when flash mode `qout` or `qio` is used for flash memory, GPIOs 9 and 10 are used for flash memory additionally and cannot be used for other purposes, see section Flash Modes in \ref esp8266_riot.
|
||||
Since GPIOs 6, 7, 8, and 11 are used for flash memory, they cannot be used
|
||||
for other purposes. Furthermore, when flash mode `qout` or `qio` is used for
|
||||
flash memory, GPIOs 9 and 10 are used for flash memory additionally and cannot
|
||||
be used for other purposes, see section Flash Modes in \ref esp8266_riot.
|
||||
|
||||
## Flashing the Device
|
||||
|
||||
To flash the RIOT image, the device must be connected to the host computer through an FTDI USB to Serial adapter/cable connected to the device's UART interface, GPIO1 (TxD) and GPIO3 (RxD) ,
|
||||
To flash the RIOT image, the device must be connected to the host computer
|
||||
through an FTDI USB to Serial adapter/cable connected to the device's
|
||||
UART interface, GPIO1 (TxD) and GPIO3 (RxD) ,
|
||||
|
||||
@note Please make sure the FTDI USB to Serial adapter/cable uses 3.3 V.
|
||||
|
||||
Once the device is connected to the host computer, it must be booted into UART mode where the firmware can be downloaded via the UART interface. For this purpose, GPIO15 (MTD0) and GPIO0 must be pulled down and GPIO2 must be pulled up while the device is restarted using the RSTB pin. Since GPIO15 (MTDO) is pulled down and GPIO0 as well as GPIO2 are pulled up by solder bridges, only GPIO0 needs to be pulled down while the device is being reset with the RSTB pin.
|
||||
Once the device is connected to the host computer, it must be booted into
|
||||
UART mode where the firmware can be downloaded via the UART interface. For
|
||||
this purpose, GPIO15 (MTD0) and GPIO0 must be pulled down and GPIO2 must
|
||||
be pulled up while the device is restarted using the RSTB pin. Since
|
||||
GPIO15 (MTDO) is pulled down and GPIO0 as well as GPIO2 are pulled up
|
||||
by solder bridges, only GPIO0 needs to be pulled down while the device
|
||||
is being reset with the RSTB pin.
|
||||
|
||||
To flash the RIOT image just type:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
make flash BOARD=esp8266-olimex-mod ...
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
For detailed information about ESP8266 as well as configuring and compiling RIOT for ESP8266 boards, see \ref esp8266_riot.
|
||||
For detailed information about ESP8266 as well as configuring and compiling
|
||||
RIOT for ESP8266 boards, see \ref esp8266_riot.
|
||||
*/
|
||||
|
||||
@ -6,7 +6,11 @@
|
||||
|
||||
## Overview
|
||||
|
||||
The [SparkFun ESP8266 Thing](https://www.sparkfun.com/products/13231) and [SparkFun ESP8266 Thing DEV](https://www.sparkfun.com/products/13711) are low-cost and easy to use breakout and development boards for the ESP8266. Both SparkFun ESP8266 Thing boards are relatively simple boards. The pins are simply broken out to two parallel, breadboard-compatible rows.
|
||||
The [SparkFun ESP8266 Thing](https://www.sparkfun.com/products/13231) and
|
||||
[SparkFun ESP8266 Thing DEV](https://www.sparkfun.com/products/13711) are
|
||||
low-cost and easy to use breakout and development boards for the ESP8266.
|
||||
Both SparkFun ESP8266 Thing boards are relatively simple boards. The pins
|
||||
are simply broken out to two parallel, breadboard-compatible rows.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/Sparkfun_Thing_x.png" "SparkFun ESP8266 Thing (left) / SparkFun ESP8266 Thing DEV (right)"
|
||||
|
||||
@ -42,7 +46,8 @@ Board Schematic | [ESP8266 Thing](https://cdn.sparkfun.com/datasheets/Wireless/W
|
||||
|
||||
### Board Versions
|
||||
|
||||
Although the board definition works with both boards, it's important to know that they differ slightly in some features:
|
||||
Although the board definition works with both boards, it's important
|
||||
to know that they differ slightly in some features:
|
||||
|
||||
<center>
|
||||
|
||||
@ -60,9 +65,13 @@ CHIP_EN broken out | yes | no
|
||||
|
||||
</center>
|
||||
|
||||
[1] Although the SparkFun ESP8266 Thing Dev has no on-board I2C pull-up resistors, the I2C interface can be used because the ESP8266 SoC has built-in pull-up resistors that are activated by the I2C peripheral driver.
|
||||
[1] Although the SparkFun ESP8266 Thing Dev has no on-board I2C pull-up
|
||||
resistors, the I2C interface can be used because the ESP8266 SoC has
|
||||
built-in pull-up resistors that are activated by the I2C peripheral driver.
|
||||
|
||||
[2] The board configuration defines high-active LEDs. If the SparkFun ESP8266 Thing Dev is used with this board configuration, the LED outputs must be inverted by the application.
|
||||
[2] The board configuration defines high-active LEDs. If the
|
||||
SparkFun ESP8266 Thing Dev is used with this board configuration,
|
||||
the LED outputs must be inverted by the application.
|
||||
|
||||
### RIOT Pin Mapping
|
||||
|
||||
@ -74,19 +83,27 @@ The following figures show the mapping of these pin holes to RIOT pins.
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp8266/Sparkfun_Thing_Dev_pinout.png" "SparkFun Thin Dev Pinout"
|
||||
\n
|
||||
|
||||
Flash SPI pins including GPIO9 and GPIO10 are not broken out. The SparkFun Thing board has solder pads for these pins at the bottom layer.
|
||||
Flash SPI pins including GPIO9 and GPIO10 are not broken out. The
|
||||
SparkFun Thing board has solder pads for these pins at the bottom layer.
|
||||
|
||||
## Flashing the Device
|
||||
|
||||
To flash the RIOT image, the device has to be connected to the host computer. Since the SparkFun Thing Dev board has an USB to Serial adapter on board, this can done directly using the Micro USB. SparkFun Thin board has to be connected to the host computer using the FTDI interface and a FTDI USB to Serial adapter/cable. For more information on how to program the SparkFun Thing board, please refer the [ESP8266 Thing Hookup Guide](https://learn.sparkfun.com/tutorials/esp8266-thing-hookup-guide/programming-the-thing).
|
||||
To flash the RIOT image, the device has to be connected to the host computer.
|
||||
Since the SparkFun Thing Dev board has an USB to Serial adapter on board,
|
||||
this can done directly using the Micro USB. SparkFun Thin board has to be
|
||||
connected to the host computer using the FTDI interface and a FTDI USB to
|
||||
Serial adapter/cable. For more information on how to program the
|
||||
SparkFun Thing board, please refer the [ESP8266 Thing Hookup Guide]
|
||||
(https://learn.sparkfun.com/tutorials/esp8266-thing-hookup-guide/programming-the-thing).
|
||||
|
||||
@note Please make sure the FTDI USB to Serial adapter/cable uses 3.3 V.
|
||||
|
||||
Both boards have a reset/flash/boot logic on-board so that flashing is quite simple. To flash the RIOT image just type:
|
||||
Both boards have a reset/flash/boot logic on-board so that flashing is
|
||||
quite simple. To flash the RIOT image just type:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
make flash BOARD=esp8266-sparkfun-thing ...
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
For detailed information about ESP8266 as well as configuring and compiling RIOT for ESP8266 boards, see \ref esp8266_riot.
|
||||
For detailed information about ESP8266 as well as configuring and compiling
|
||||
RIOT for ESP8266 boards, see \ref esp8266_riot.
|
||||
*/
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user