Skip to content

Latest commit

 

History

History
36 lines (23 loc) · 1.33 KB

README.md

File metadata and controls

36 lines (23 loc) · 1.33 KB

Serial flasher

Overview

Serial flasher component provides portable library for flashing ESP32 from other host microcontroller. ESP32 is normally programmed via serial interface (UART) and port layer for given host microcontroller has to be implemented, if not available. Details can be found in section below.

Supporting new target

In order to support new target, following function has to be implemented by user:

  • loader_port_serial_read()
  • loader_port_serial_write()
  • loader_port_enter_bootloader()
  • loader_port_delay_ms()
  • loader_port_start_timer()
  • loader_port_remaining_time()

Following functions are part of serial_io.h header for convenience, however, user does not have to strictly follow function signatures, as there are not called directly from library.

  • loader_port_serial_init()
  • loader_port_serial_deinit()
  • loader_port_change_baudrate()
  • loader_port_reset_target()
  • loader_port_debug_print()

Prototypes of all function mentioned above can be found in serial_io.h. Please refer to ports in port directory. Currently, only ESP32 port is available.

Component integration

At this point, this component can only be integrated with IDF. Improvement of existing CMakeList.txt file is to be done.

Known limitations

Size of new binary image has to be known before flashing.