kicer/stm8loader
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix README.md

Browse Source
This commit is contained in:
kicer
2025-12-22 09:04:13 +08:00
parent ec9348f41e
commit 1abf1d48fe
1 changed files with 10 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@@ -9,7 +9,7 @@ Note: The bootloader implementation is based on and inspired by the [STM8uLoader
## Features ## Features
- **Three-stage Bootloader**: - **Three-stage Bootloader**:
- Boot0: TRAP isr for load boot1 - Boot0: Reset/TRAP isr for load boot1
- Boot1: Minimal bootloader stored in *reserved* option bytes - Boot1: Minimal bootloader stored in *reserved* option bytes
- Boot2: Full-featured bootloader loaded via serial communication - Boot2: Full-featured bootloader loaded via serial communication
@@ -37,7 +37,7 @@ This project's bootloader implementation is derived from the excellent STM8uLoad
1. **Power-on/Reset**: 1. **Power-on/Reset**:
- MCU starts execution at reset vector(0x8000) - MCU starts execution at reset vector(0x8000)
- Control transfers to `bootloader_enter()` in `bsp/init0.c` - Control transfers to `bootloader_enter()`
2. **Stage 1 (Boot1)**: 2. **Stage 1 (Boot1)**:
- Copies Boot1 from option bytes (0x480E-0x483F) to RAM and Run - Copies Boot1 from option bytes (0x480E-0x483F) to RAM and Run
@@ -53,6 +53,14 @@ This project's bootloader implementation is derived from the excellent STM8uLoad
- On successful programming or timeout, jumps to main application(0x8004) - On successful programming or timeout, jumps to main application(0x8004)
- Option to stay in bootloader mode for debugging - Option to stay in bootloader mode for debugging
## Bootloader Integration
1. The main application includes `bootloader.h`, which redirects the TRAP interrupt vector to `bootloader_enter()` in `bsp/boot0.c`.
2. During the build process, the Makefile swaps the reset vector (0x8000) and trap vector (0x8004) positions. This ensures that upon startup, the bootloader entry routine executes first.
3. It sends a handshake signal (`0x00 0x0D`) via UART1 and waits approximately 200ms for a response. Within the timeout period, execution proceeds to the main application.
## Building the Project ## Building the Project
### Prerequisites ### Prerequisites
@@ -81,16 +89,6 @@ make all
make flash make flash
``` ```
## Bootloader Integration
1. The main application includes `bootloader.h`, which redirects the TRAP interrupt vector to `bootloader_enter()` in `bsp/boot0.c`.
2. During the build process, the Makefile swaps the reset vector (0x8000) and trap vector (0x8004) positions. This ensures that upon startup, the bootloader entry routine executes first.
3. It sends a handshake signal (`0x00 0x0D`) via UART1 and waits approximately 200ms for a response.
4. If no response is received within the timeout period, execution proceeds to the main application (reset vector).
## Option Bytes Configuration ## Option Bytes Configuration
The bootloader uses the reserved option byte area for storage: The bootloader uses the reserved option byte area for storage: