diff options
Diffstat (limited to 'src')
| -rw-r--r-- | src/host/imxrt-link.x | 5 | ||||
| -rw-r--r-- | src/lib.rs | 22 |
2 files changed, 27 insertions, 0 deletions
diff --git a/src/host/imxrt-link.x b/src/host/imxrt-link.x index 7fcd76c..f07601b 100644 --- a/src/host/imxrt-link.x +++ b/src/host/imxrt-link.x @@ -37,6 +37,11 @@ EXTERN(__INTERRUPTS); /* `static` variable similar to `__EXCEPTIONS` */ /* # Sections */ SECTIONS { + .bootrom ORIGIN(OCRAM) (NOLOAD) : + { + KEEP(*(.bootrom_reservation)); + } > OCRAM + .stack (NOLOAD) : ALIGN(8) { __estack = .; @@ -176,6 +176,28 @@ //! //! With this in place, your package should be able to use the `#[exception]` macro //! exported by `imxrt-rt`. See the `imxrt-rt` package examples for a demonstration. +//! +//! # Extras +//! +//! The runtime package has extra features to support i.MX RT programs. +//! +//! ## Reserving OCRAM for NXP's boot ROM +//! +//! If you're using NXP's boot ROM, you may need to reserve a region at the start of +//! OCRAM for API calls. You can achieve that by placing a buffer into `.bootrom_reservation`. +//! You're responsible for sizing this buffer depending chip's ROM. +//! +//! Here's an example of how to reserve the first 48KiB of OCRAM for the boot ROM. +//! The example assumes the boot ROM requires at most 48KiB. +//! +//! ``` +//! # use core::mem::MaybeUninit; +//! #[unsafe(link_section = ".bootrom_reservation")] +//! static ROM_RESERVATION: MaybeUninit<[u8; 48 * 1024]> = MaybeUninit::uninit(); +//! ``` +//! +//! Without this reservation, this program is allowed to use the lower addresses of +//! OCRAM without concern for the boot ROM. #![cfg_attr(all(target_arch = "arm", target_os = "none"), no_std)] |
