pub trait Chip {
type MPU: MPU;
type UserspaceKernelBoundary: UserspaceKernelBoundary;
// Required methods
fn service_pending_interrupts(&self);
fn has_pending_interrupts(&self) -> bool;
fn mpu(&self) -> &Self::MPU;
fn userspace_kernel_boundary(&self) -> &Self::UserspaceKernelBoundary;
fn sleep(&self);
unsafe fn atomic<F, R>(&self, f: F) -> R
where F: FnOnce() -> R;
unsafe fn print_state(&self, writer: &mut dyn Write);
}
Expand description
Interface for individual MCUs.
The trait defines chip-specific properties of Tock’s operation. These include whether and which memory protection mechanism and scheduler_timer to use, how to switch between the kernel and userland applications, and how to handle hardware events.
Each microcontroller should define a struct and implement this trait.
Required Associated Types§
sourcetype UserspaceKernelBoundary: UserspaceKernelBoundary
type UserspaceKernelBoundary: UserspaceKernelBoundary
The implementation of the interface between userspace and the kernel for this specific chip. Likely this is architecture specific, but individual chips may have various custom requirements.
Required Methods§
sourcefn service_pending_interrupts(&self)
fn service_pending_interrupts(&self)
The kernel calls this function to tell the chip to check for all pending interrupts and to correctly dispatch them to the peripheral drivers for the chip.
This function should loop internally until all interrupts have been handled. It is ok, however, if an interrupt occurs after the last check but before this function returns. The kernel will handle this edge case.
sourcefn has_pending_interrupts(&self) -> bool
fn has_pending_interrupts(&self) -> bool
Ask the chip to check if there are any pending interrupts.
sourcefn mpu(&self) -> &Self::MPU
fn mpu(&self) -> &Self::MPU
Returns a reference to the implementation for the MPU on this chip.
sourcefn userspace_kernel_boundary(&self) -> &Self::UserspaceKernelBoundary
fn userspace_kernel_boundary(&self) -> &Self::UserspaceKernelBoundary
Returns a reference to the implementation for the interface between userspace and kernelspace.
sourcefn sleep(&self)
fn sleep(&self)
Called when there is nothing left for the chip to do and it should enter a low power sleep state. This low power sleep state should allow interrupts to still be active so that the next interrupt event wakes the chip and resumes the scheduler.
sourceunsafe fn atomic<F, R>(&self, f: F) -> Rwhere
F: FnOnce() -> R,
unsafe fn atomic<F, R>(&self, f: F) -> Rwhere
F: FnOnce() -> R,
Run a function in an atomic state, which means that interrupts are disabled so that an interrupt will not fire during the passed in function’s execution.
sourceunsafe fn print_state(&self, writer: &mut dyn Write)
unsafe fn print_state(&self, writer: &mut dyn Write)
Print out chip state (system registers) to a supplied
writer. This does not print out the execution context
(data registers), as this depends on how they are stored;
that is implemented by
syscall::UserspaceKernelBoundary::print_context
.
This also does not print out a process memory state,
that is implemented by process::Process::print_memory_map
.
The MPU state is printed by the MPU’s implementation of
the Display trait.
Used by panic.