Crash_Override/OVMS3-idf
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
OVMS3-idf/examples/peripherals/uart_echo_rs485/README.md
Alex Lisitsyn 51e9cf6848 driver: add rs485 half duplex interface support to uart driver (update after review) 
An existing UART driver does not support RS485 half duplex mode.
This task adds this functionality to ESP_IDF UART driver.
driver/uart.c/h: updated to add support of RS485 half duplex mode
examples/peripherals/uart_echo_rs485/main/rs485_example.c: added test example
components/driver/test/test_uart.c: added test of RS485 half duplex mode
docs/en/api-reference/peripherals/uart.rst: updated documentation
test_uart.c: suppress GCC warnings about discarded const qualifiers
uart.rst: remove sphinx warning - "Duplicate explicit target name"
simple change in uart.h file
update (test_uart.c) after rebase from master
update uart.rst, uart.c, rs485_example.c
Update example description in file Readme.md
update uart.c/h, uart.rst, test_uart.c according to review results

The tests are completed using RS485 adapters hardware connected to two ESP32 WROVER KITs.

TW#13812
Closes https://github.com/espressif/esp-idf/pull/667
Closes https://github.com/espressif/esp-idf/pull/1006
2018-07-02 15:24:58 +02:00

2.6 KiB
Raw Blame History

UART RS485 Echo Example

This is an example which echoes any data it receives on UART2 back to the sender.

Setup

This example uses external RS485 interface. The MAX485 line driver can be used for example.

RS485 example connection circuit schematic:

     VCC ---------------+                               +--------------- VCC
                        |                               |
                +-------x-------+               +-------x-------+
     RXD <------| RO            |               |             RO|-----> RXD
                |              B|---------------|B              |
     TXD ------>| DI  MAX485    |    \  /       |    MAX485   DI|<----- TXD

ESP32 WROVER KIT | | RS-485 side | | SERIAL ADAPTER RTS --+--->| DE | / \ | DE|---+ | | A|---------------|A | | +----| /RE | | /RE|---+-- RTS +-------x-------+ +-------x-------+ | | --- ---

  1. Connect an external RS485 serial interface to an ESP32 board.

| ESP32 Interface | #define | ESP32 Pin | External RS485 | | ----------------------|---------------|-----------| Driver Pin | | Transmit Data (TxD) | ECHO_TEST_TXD | GPIO23 | DI | | Receive Data (RxD) | ECHO_TEST_RXD | GPIO22 | RO | | Request To Send (RTS) | ECHO_TEST_RTS | GPIO18 | ~RE/DE | | Ground | n/a | GND | GND |

  1. Connect USB to RS485 adapter to computer and connect its D+, D- output lines with the D+, D- lines of RS485 driver connected to ESP32.
  2. Compile and load the example to the ESP32 board
  3. Refer to the example and set up a serial terminal program to the same settings as of UART in ESP32
  4. Open the external serial interface in the terminal.
  5. By default if no any symbols received the application sends character "." to check transmission side. When typing message and push send button in the terminal you should see the message "RS485 Received: [ your message ], where your message is the message you sent from terminal.
  6. Verify if echo indeed comes from ESP32 by disconnecting either 'TxD' or 'RxD' pin. There should be no any "." once TxD pin is disconnected.