mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
bce0d4cb10
Fixes various issues in documentation: - replaces HTML anchor tags in markdown headings by markdown heading IDs. - replaces HTML linebreaks by newline commands - replaces \htmlonly commands for image resizing by the width argument in \image commands - uses more unique identifiers for references - uses stable references for driver documentation - fix broken links to external HTML documents - replaces the TOC link in headers by a back to TOC link below each section - replaces ``` fenced code blocks by ~~~
101 lines
4.8 KiB
Plaintext
101 lines
4.8 KiB
Plaintext
/*
|
|
* Copyright (C) 2018 Gunar Schorcht
|
|
* Copyright (C) 2020 Google LLC
|
|
*
|
|
* This file is subject to the terms and conditions of the GNU Lesser
|
|
* General Public License v2.1. See the file LICENSE in the top level
|
|
* directory for more details.
|
|
*/
|
|
|
|
/**
|
|
* @defgroup boards_esp32_esp-ethernet-kit-v1_2 ESP32-Ethernet-Kit V1.2 Board
|
|
* @ingroup boards_esp32_esp-ethernet-kit
|
|
* @brief Support for for Espressif ESP32-Ethernet-Kit V1.2
|
|
* @author Gunar Schorcht <gunar@schorcht.net>
|
|
* @author Erik Ekman <eekman@google.com>
|
|
|
|
\section esp32-ethernet-kit-v1_2 Espressif ESP32-Ethernet-Kit v1.2
|
|
|
|
## Table of Contents {#esp32_ethernet_kit_v1_2_toc}
|
|
|
|
1. [Overview](#esp32_ethernet_kit_v1_2_overview)
|
|
2. [Hardware](#esp32_ethernet_kit_v1_2_hardware)
|
|
1. [Board Configuration](#esp32_ethernet_kit_v1_2_board_configuration)
|
|
2. [Board Pinout](#esp32_ethernet_kit_v1_2_pinout)
|
|
3. [Other Documentation Resources](#esp32_ethernet_kit_v1_2_other-resources)
|
|
|
|
## Overview {#esp32_ethernet_kit_v1_2_overview}
|
|
|
|
The Espressif [ESP32-Ethernet-Kit](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/hw-reference/esp32/get-started-ethernet-kit.html) is a development board that uses the ESP32-WROVER-E module. Most important features of the board are
|
|
|
|
- 100 Mbps Ethernet via IP101G PHY
|
|
- USB bridge with JTAG interface
|
|
|
|
Furthermore, some GPIOs are broken out for extension. The USB bridge based on FDI FT2232HL provides a JTAG interface for OCD debugging through the USB interface.
|
|
For flashing and debugging the board, see \ref boards_esp32_esp-ethernet-kit common board documentation.
|
|
|
|
@image html "https://docs.espressif.com/projects/esp-idf/en/latest/esp32/_images/esp32-ethernet-kit-v1.2.jpg" "ESP32-Ethernet-Kit V1.2" width=500
|
|
|
|
[Back to table of contents](#esp32_ethernet_kit_v1_2_toc)
|
|
|
|
## Hardware {#esp32_ethernet_kit_v1_2_hardware}
|
|
|
|
This section describes
|
|
|
|
- the default [board configuration](#esp32_ethernet_kit_v1_2_board_configuration),
|
|
- the [board pinout](#esp32_ethernet_kit_v1_2_pinout).
|
|
|
|
[Back to table of contents](#esp32_ethernet_kit_v1_2_toc)
|
|
|
|
### Board Configuration {#esp32_ethernet_kit_v1_2_board_configuration}
|
|
|
|
ESP32-Ethernet-Kit v1.2 has the following on-board components
|
|
|
|
- 100 Mbps Ethernet via IP101G PHY
|
|
- USB bridge with JTAG interface
|
|
|
|
For detailed information about the configuration of ESP32 boards, see
|
|
section Peripherals in \ref esp32_riot.
|
|
|
|
@note
|
|
Only a few GPIOs are broken out and available for external hardware on ESP32-Ethernet-Kit boards. Which GPIOs are available as peripherals depends on used modules.
|
|
|
|
<center>
|
|
Function | GPIOs | Remarks |Configuration
|
|
:---------------|:-------|:--------|:----------------------------------
|
|
BTN0 | GPIO0 | not available if `esp_eth` is used | |
|
|
ADC | GPIO34, GPIO35, GPIO36, GPIO39 | | \ref esp32_adc_channels "ADC Channels"
|
|
DAC | - | | \ref esp32_dac_channels "DAC Channels"
|
|
PWM_DEV(0) | GPIO2, GPIO4 | | \ref esp32_pwm_channels "PWM Channels"
|
|
I2C_DEV(0):SDA | GPIO32 | | \ref esp32_i2c_interfaces "I2C Interfaces"
|
|
I2C_DEV(0):SCL | GPIO33 | | \ref esp32_i2c_interfaces "I2C Interfaces"
|
|
SPI_DEV(0):CLK | GPIO14 | HSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
|
SPI_DEV(0):MISO | GPIO12 | HSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
|
SPI_DEV(0):MOSI | GPIO13 | HSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
|
SPI_DEV(0):CS0 | GPIO15 | HSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
|
UART_DEV(0):TxD | GPIO1 | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
|
UART_DEV(0):RxD | GPIO3 | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
|
</center>
|
|
\n
|
|
@note
|
|
SPI_DEV(0) is not available if module `esp_jtag` is used. For the SPI_DEV(0) pins to work properly, the function switches (DIP switches) for the JTAG signals must be set to OFF.
|
|
|
|
[Back to table of contents](#esp32_ethernet_kit_v1_2_toc)
|
|
|
|
### Board Pinout {#esp32_ethernet_kit_v1_2_pinout}
|
|
|
|
The board schematic can be found [here](https://dl.espressif.com/dl/schematics/SCH_ESP32-Ethernet-Kit_A_V1.2_20200528.pdf).
|
|
|
|
By default, only 4 bidirectional GPIO pins are unused: GPIO2, GPIO4, GPIO32, GPIO33. The suggested configuration is for PWM
|
|
and I2C, but they can also be used for SPI or another serial port. By disabling the JTAG interface on the board,
|
|
another 4 GPIOs can be made available (GPIO12, GPIO13, GPIO14, GPIO15).
|
|
|
|
[Back to table of contents](#esp32_ethernet_kit_v1_2_toc)
|
|
|
|
## Other Documentation Resources {#esp32_ethernet_kit_v1_2_other-resources}
|
|
|
|
There is a comprehensive [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/hw-reference/esp32/get-started-ethernet-kit.html) for the ESP32-Ethernet-Kit with a lot information about hardware configuration.
|
|
|
|
[Back to table of contents](#esp32_ethernet_kit_v1_2_toc)
|
|
*/
|