Skip to content

F0002 boot-10

Rule: Backup-domain helpers restore what they found.

Code F0002 (stable, never reused)
Id boot-10
Category boot
Source spirit_level
Fix by hand

Level per tier

Tier Level Reason
small off
small-workspace off
medium off
big off
ai off
embedded warn bedrock warning: Backup-domain helper that turns the RTC clock or PWR_CR1.DBP off afterwards instead of restoring what it found
ui off
egui off
units-strict off
units-paranoid off

Why

A helper that enables backup-domain write access (RTC clock, PWR_CR1.DBP) to do one write, then turns the RTC clock or DBP off afterward unconditionally, instead of restoring whatever state it found before it ran.

If the backup domain was already in use for something else (the RTC running, another feature's backup registers), turning its enabling bits off "to be tidy" after a one-off write breaks that other use — the helper's caller has no way to know its "harmless" write just disabled someone else's clock.

Example

Vb135 BOOT-5/BOOT-6: every boot came up unhealthy, eventually falling into the ROM bootloader after four boots, traced back to a backup-domain helper leaving the domain in a different state than it found it.

How to fix

Read the current enable state before changing it; restore that saved state afterward instead of always disabling.

How it is checked

src mid: a backup-domain-enabling helper must save the prior state of what it's about to change and restore exactly that state when done, not an assumed default.

Source

Ported from embedded_bedrock's firmware check catalogue, BOOT-10 (book/checks.md, detail in book/checks/boot.md). Found on: vb135 BOOT-⅚ (every boot unhealthy, ROM after 4).

Configure

[lints.boot-10]
level = "deny"
reason = "why this project wants it at this level"

Allow one finding in the code with // spirit-level: allow(boot-10) <reason> (waivers); the code works there too, as in [lints.F0002].