From a9bb416c822d20c1b94fb7b2bfab282d25e11125 Mon Sep 17 00:00:00 2001 From: Ian McIntyre Date: Wed, 11 Feb 2026 16:29:27 -0500 Subject: 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 --- src/host.rs | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) (limited to 'src/host.rs') 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(()) } -- cgit v1.2.3