RIOT/tests/riotboot/README.md

RIOT bootloader test

This is a basic example how to use RIOT bootloader in your embedded application.

This test should foremost give you an overview how to use riotboot:

• make all build the test using the target riotboot, which generates a binary file of the application with a header on top of it, used by the bootloader to recognise a bootable image.

• make riotboot/flash creates the binary files and flashes both riotboot and the RIOT image with headers included. This should boot as a normal application.

In this test two modules riotboot_hdr and riotboot_slot are used to showcase the access to riotboot shared functions.

Automatic test

This application's "test" target can be used to test basic riotboot functionality:

BOARD=<board> make flash test

This will:

1. flash bootloader and slot0, invalidate slot1

2. get the running slot and current APP_VER

3. flash slot1 with APP_VER + 1

4. verify slot1 has booted and shows version = APP_VER + 1

5. flash slot0 with APP_VER + 2

6. verify slot0 has booted and shows version = APP_VER + 2

If this test runs correctly, it shows that riotboot's basic functions are working properly on the target board.