SCB

Struct SCB 

Source
pub struct SCB { /* private fields */ }
Expand description

System Control Block

Implementations§

Source§

impl SCB

Source

pub fn disable_fpu(&mut self)

Shorthand for set_fpu_access_mode(FpuAccessMode::Disabled)

Source

pub fn enable_fpu(&mut self)

Shorthand for set_fpu_access_mode(FpuAccessMode::Enabled)

Source

pub fn fpu_access_mode() -> FpuAccessMode

Gets FPU access mode

Source

pub fn set_fpu_access_mode(&mut self, mode: FpuAccessMode)

Sets FPU access mode

IMPORTANT Any function that runs fully or partly with the FPU disabled must not take any floating-point arguments or have any floating-point local variables. Because the compiler might inline such a function into a caller that does have floating-point arguments or variables, any such function must be also marked #[inline(never)].

Source§

impl SCB

Source

pub fn vect_active() -> VectActive

Returns the active exception number

Source§

impl SCB

Source

pub fn enable_icache(&mut self)

Enables I-Cache if currently disabled

Source

pub fn disable_icache(&mut self)

Disables I-Cache if currently enabled

Source

pub fn icache_enabled() -> bool

Returns whether the I-Cache is currently enabled

Source

pub fn invalidate_icache(&mut self)

Invalidates I-Cache

Source

pub fn enable_dcache(&mut self, cpuid: &mut CPUID)

Enables D-cache if currently disabled

Source

pub fn disable_dcache(&mut self, cpuid: &mut CPUID)

Disables D-cache if currently enabled

Source

pub fn dcache_enabled() -> bool

Returns whether the D-Cache is currently enabled

Source

pub fn clean_dcache(&mut self, cpuid: &mut CPUID)

Cleans D-cache

Source

pub fn clean_invalidate_dcache(&mut self, cpuid: &mut CPUID)

Cleans and invalidates D-cache

Source

pub fn invalidate_dcache_by_address(&mut self, addr: usize, size: usize)

Invalidates D-cache by address

addr: the address to invalidate size: size of the memory block, in number of bytes

Invalidates cache starting from the lowest 32-byte aligned address represented by addr, in blocks of 32 bytes until at least size bytes have been invalidated.

Source

pub fn clean_dcache_by_address(&mut self, addr: usize, size: usize)

Cleans D-cache by address

addr: the address to clean size: size of the memory block, in number of bytes

Cleans cache starting from the lowest 32-byte aligned address represented by addr, in blocks of 32 bytes until at least size bytes have been cleaned.

Source

pub fn clean_invalidate_dcache_by_address(&mut self, addr: usize, size: usize)

Cleans and invalidates D-cache by address

addr: the address to clean and invalidate size: size of the memory block, in number of bytes

Cleans and invalidates cache starting from the lowest 32-byte aligned address represented by addr, in blocks of 32 bytes until at least size bytes have been cleaned and invalidated.

Source§

impl SCB

Source

pub fn set_sleepdeep(&mut self)

Set the SLEEPDEEP bit in the SCR register

Source

pub fn clear_sleepdeep(&mut self)

Clear the SLEEPDEEP bit in the SCR register

Source§

impl SCB

Source

pub fn set_sleeponexit(&mut self)

Set the SLEEPONEXIT bit in the SCR register

Source

pub fn clear_sleeponexit(&mut self)

Clear the SLEEPONEXIT bit in the SCR register

Source§

impl SCB

Source

pub fn system_reset(&mut self) -> !

👎Deprecated since 0.6.1: Use SCB::sys_reset

Initiate a system reset request to reset the MCU

Source

pub fn sys_reset() -> !

Initiate a system reset request to reset the MCU

Source§

impl SCB

Source

pub fn set_pendsv()

Set the PENDSVSET bit in the ICSR register which will pend the PendSV interrupt

Source

pub fn is_pendsv_pending() -> bool

Check if PENDSVSET bit in the ICSR register is set meaning PendSV interrupt is pending

Source

pub fn clear_pendsv()

Set the PENDSVCLR bit in the ICSR register which will clear a pending PendSV interrupt

Source

pub fn set_pendst()

Set the PENDSTSET bit in the ICSR register which will pend a SysTick interrupt

Source

pub fn is_pendst_pending() -> bool

Check if PENDSTSET bit in the ICSR register is set meaning SysTick interrupt is pending

Source

pub fn clear_pendst()

Set the PENDSTCLR bit in the ICSR register which will clear a pending SysTick interrupt

Source§

impl SCB

Source

pub fn get_priority(system_handler: SystemHandler) -> u8

Returns the hardware priority of system_handler

NOTE: Hardware priority does not exactly match logical priority levels. See NVIC.get_priority for more details.

Source

pub unsafe fn set_priority(&mut self, system_handler: SystemHandler, prio: u8)

Sets the hardware priority of system_handler to prio

NOTE: Hardware priority does not exactly match logical priority levels. See NVIC.get_priority for more details.

On ARMv6-M, updating a system handler priority requires a read-modify-write operation. On ARMv7-M, the operation is performed in a single, atomic write operation.

§Unsafety

Changing priority levels can break priority-based critical sections (see register::basepri) and compromise memory safety.

Source

pub fn enable(&mut self, exception: Exception)

Enable the exception

If the exception is enabled, when the exception is triggered, the exception handler will be executed instead of the HardFault handler. This function is only allowed on the following exceptions:

  • MemoryManagement
  • BusFault
  • UsageFault
  • SecureFault (can only be enabled from Secure state)

Calling this function with any other exception will do nothing.

Source

pub fn disable(&mut self, exception: Exception)

Disable the exception

If the exception is disabled, when the exception is triggered, the HardFault handler will be executed instead of the exception handler. This function is only allowed on the following exceptions:

  • MemoryManagement
  • BusFault
  • UsageFault
  • SecureFault (can not be changed from Non-secure state)

Calling this function with any other exception will do nothing.

Source

pub fn is_enabled(&self, exception: Exception) -> bool

Check if an exception is enabled

This function is only allowed on the following exception:

  • MemoryManagement
  • BusFault
  • UsageFault
  • SecureFault (can not be read from Non-secure state)

Calling this function with any other exception will read false.

Source§

impl SCB

Source

pub fn ptr() -> *const RegisterBlock

Returns a pointer to the register block

Trait Implementations§

Source§

impl Deref for SCB

Source§

type Target = RegisterBlock

The resulting type after dereferencing.
Source§

fn deref(&self) -> &<SCB as Deref>::Target

Dereferences the value.
Source§

impl Send for SCB

Auto Trait Implementations§

§

impl Freeze for SCB

§

impl RefUnwindSafe for SCB

§

impl !Sync for SCB

§

impl Unpin for SCB

§

impl UnwindSafe for SCB

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.