Momentum-Apps

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.

Licence

Code is distributed under Apache 2.0 license.

Known limitations

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