diff options
| author | Ian McIntyre <me@mciantyre.dev> | 2026-02-11 16:29:27 -0500 |
|---|---|---|
| committer | Ian McIntyre <me@mciantyre.dev> | 2026-03-08 14:14:31 -0400 |
| commit | a9bb416c822d20c1b94fb7b2bfab282d25e11125 (patch) | |
| tree | 5dcf3e22c65a4422e71a103ca1afbe8b5f5e5e0c /src/host.rs | |
| parent | 57978b04a7e141e0f34bc24088771a6fedea634e (diff) | |
Preload RAM for ECC ciphers
Testing shows that we must blow fuses in order to activate either ECC
engine. Once the fuse is blown, NXP's boot ROM will enable the ECC
engine. So by the time the reset handler is running, ECC may already
be enabled.
The 32-bit copy loops won't work for initializing ITCM and OCRAM.
Since these bus widths are 64-bit and the ECC is computed over 64
bits, these 32 bit accesses result in a read-modify-write (RMW) on the
underlying interface. If these RAM regions aren't already initialized,
we'll fail an ECC check; the read in RMW compares bogus RAM contents
against a bogus ECC. This seems to dramatically slow down
initialization, or stall it (I've seen the CPU spinning in the boot
ROM).
If we listen to NXP and use 64-bit writes to preload ECC-protected RAM
regions, the 32-bit copy loops will work as expected. Note that we can
still issue 64-bit accesses towards DTCM; they're scattered across the
two 32-bit interfaces. There's an NXP whitepaper [1] describing that.
Once TCM ECC is enabled, we need to tell the TCM interfaces to RMW
smaller accesses. Otherwise, we won't generate correct ciphers. We
also might need to retry operations if there was a correction by the
RAM controller. We can perform these with predicated instructions.
Tested on an 1010EVK, where I used the debugger to show the control
registers weren't touched; and tested on the 1170EVK, with the same
approach showing the expected set bits.
[1]: https://www.nxp.com/docs/en/white-paper/CORTEXM7WP.pdf
[2]: https://www.nxp.com/docs/en/application-note/AN13204.pdf
Diffstat (limited to 'src/host.rs')
| -rw-r--r-- | src/host.rs | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/src/host.rs b/src/host.rs index 5f1dc33..e809895 100644 --- a/src/host.rs +++ b/src/host.rs @@ -816,6 +816,7 @@ impl RuntimeBuilder { "__flexram_config = {:#010X};", flexram_config(self.family, &self.flexram_layout) )?; + // The target runtime looks at this value to predicate some pre-init instructions. // Could be helpful for binary identification, but it's an undocumented feature. writeln!(writer, "__imxrt_rt_v0.2 = {:#010X};", self.family.id(),)?; @@ -925,6 +926,59 @@ fn write_flexram_memories( Ok(()) } +/// Generate spans for zeroing ECC RAM. +fn write_ecc_zero_spans( + output: &mut dyn Write, + family: Family, + flexram_layout: &[FlexRamKind], + flexram_ecc: FlexRamEcc, + mecc64: Mecc64, +) -> io::Result<()> { + let itcm_count = layout_count_of(FlexRamKind::Itcm, flexram_layout); + let dtcm_count = layout_count_of(FlexRamKind::Dtcm, flexram_layout); + let ocram_count = layout_count_of(FlexRamKind::Ocram, flexram_layout); + + // If memory isn't available or doesn't need + // use ECC, then we don't need to zero it. + // Generate dummy values that skip the loops. + + if itcm_count > 0 && flexram_ecc.is_enable() { + // Make sure to zero the reserved regions, too, + // just in case they're accidentally / intentionally accessed. + let itcm = family.itcm_start_size(itcm_count); + let start = itcm.start - 32; + let end = start + itcm.size + 32; + writeln!(output, "__sitcm = {:#010X};", start)?; + writeln!(output, "__eitcm = {:#010X};", end)?; + } else { + writeln!(output, "__sitcm = 0;")?; + writeln!(output, "__eitcm = 0;")?; + }; + + if dtcm_count > 0 && flexram_ecc.is_enable() { + writeln!(output, "__sdtcm = ORIGIN(DTCM);")?; + writeln!(output, "__edtcm = ORIGIN(DTCM) + LENGTH(DTCM);")?; + } else { + writeln!(output, "__sdtcm = 0;")?; + writeln!(output, "__edtcm = 0;")?; + }; + + let ocram = family.ocram_start_size(ocram_count, flexram_ecc, mecc64); + + // The zeroization should specifically target one of the two regions. + // But we're not prepared to do that, so incur the loop for the whole + // region no matter which is enabled. + if ocram.size > 0 && (mecc64.is_enable() || flexram_ecc.is_enable()) { + writeln!(output, "__socram = {:#010X};", ocram.start)?; + writeln!(output, "__eocram = {:#010X};", ocram.start + ocram.size)?; + } else { + writeln!(output, "__socram = 0;")?; + writeln!(output, "__eocram = 0;")?; + } + + Ok(()) +} + /// Generate a linker script MEMORY command that includes a FLASH block. fn write_flash_memory_map( output: &mut dyn Write, @@ -949,6 +1003,7 @@ fn write_flash_memory_map( write_flexram_memories(output, family, flexram_layout, flexram_ecc, mecc64)?; writeln!(output, "}}")?; writeln!(output, "__fcb_offset = {:#X};", family.fcb_offset())?; + write_ecc_zero_spans(output, family, flexram_layout, flexram_ecc, mecc64)?; Ok(()) } @@ -970,6 +1025,7 @@ fn write_ram_memory_map( writeln!(output, "MEMORY {{")?; write_flexram_memories(output, family, flexram_layout, flexram_ecc, mecc64)?; writeln!(output, "}}")?; + write_ecc_zero_spans(output, family, flexram_layout, flexram_ecc, mecc64)?; Ok(()) } |
