2023-01-10 05:59:46 +00:00
|
|
|
| Supported Targets | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C6 | ESP32-H2 | ESP32-S2 | ESP32-S3 |
|
|
|
|
| ----------------- | ----- | -------- | -------- | -------- | -------- | -------- | -------- |
|
2022-07-13 02:41:36 +00:00
|
|
|
|
2018-11-01 10:57:24 +00:00
|
|
|
# UART Asynchronous Example with Separate Receive and Transfer Tasks
|
2017-10-01 11:02:06 +00:00
|
|
|
|
2018-11-01 10:57:24 +00:00
|
|
|
(See the README.md file in the upper level 'examples' directory for more information about examples.)
|
2017-10-01 11:02:06 +00:00
|
|
|
|
2018-11-01 10:57:24 +00:00
|
|
|
This example demonstrates how two asynchronous tasks can use the same UART interface for communication. One can use
|
|
|
|
this example to develop more complex applications for serial communication.
|
2017-10-19 19:45:58 +00:00
|
|
|
|
2018-11-01 10:57:24 +00:00
|
|
|
The example starts two FreeRTOS tasks:
|
|
|
|
1. The first task periodically transmits `Hello world` via the UART.
|
|
|
|
2. The second task task listens, receives and prints data from the UART.
|
2017-10-19 19:45:58 +00:00
|
|
|
|
2018-11-01 10:57:24 +00:00
|
|
|
## How to use example
|
|
|
|
|
|
|
|
### Hardware Required
|
|
|
|
|
2021-06-08 02:47:49 +00:00
|
|
|
The example can be run on any commonly available ESP32, ESP32-S and ESP32-C series based development board. You will need a USB cable to connect the
|
2018-11-01 10:57:24 +00:00
|
|
|
development board to a computer, and a simple one-wire cable for shorting two pins of the board.
|
|
|
|
|
|
|
|
### Setup the Hardware
|
|
|
|
|
|
|
|
The `RXD_PIN` and `TXD_PIN` which are configurable in the code (by default `GPIO4` and `GPIO5`) need to be shorted in
|
|
|
|
order to receive back the same data which were sent out.
|
|
|
|
|
|
|
|
### Configure the project
|
|
|
|
|
|
|
|
```
|
2019-08-02 03:31:20 +00:00
|
|
|
idf.py menuconfig
|
2017-10-19 19:45:58 +00:00
|
|
|
```
|
2018-11-01 10:57:24 +00:00
|
|
|
|
|
|
|
### Build and Flash
|
|
|
|
|
|
|
|
Build the project and flash it to the board, then run monitor tool to view serial output:
|
|
|
|
|
|
|
|
```
|
2019-08-02 03:31:20 +00:00
|
|
|
idf.py -p PORT flash monitor
|
2018-11-01 10:57:24 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
(To exit the serial monitor, type ``Ctrl-]``.)
|
|
|
|
|
|
|
|
See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
|
|
|
|
|
|
|
|
## Example Output
|
|
|
|
|
|
|
|
You will receive the following repeating output from the monitoring console:
|
|
|
|
```
|
|
|
|
...
|
2017-10-19 19:45:58 +00:00
|
|
|
I (3261) TX_TASK: Wrote 11 bytes
|
|
|
|
I (4261) RX_TASK: Read 11 bytes: 'Hello world'
|
|
|
|
I (4261) RX_TASK: 0x3ffb821c 48 65 6c 6c 6f 20 77 6f 72 6c 64 |Hello world|
|
|
|
|
...
|
|
|
|
```
|
2018-11-01 10:57:24 +00:00
|
|
|
|
|
|
|
## Troubleshooting
|
|
|
|
|
|
|
|
If you do not see any output from `RX_TASK` then check if you have the `RXD_PIN` and `TXD_PIN` pins shorted on the board.
|