mirror of
https://github.com/saymrwulf/xous-core.git
synced 2026-11-04 04:27:34 +00:00
5a2df4432c
- make the "base" field no longer public. It is accessible, but only through an `unsafe` method, because, it is unsafe. - add accessors to offest/mask fields. Because, it's not at all unsafe to access these, and it can be useful for bit-ops that are not part of the generic set of UTRA. - add Arc to AtomicCSR, and require `std` for AtomicCSR types. This should not break anything, I checked inside @foundation-devices keyOS and they don't seem to be using AtomicCSR anywhere. The Arc makes it a bit safer to clone the AtomicCSR base pointer and share it between threads, but it will have an impact on performance. The USB stack (which requires AtomicCSR) was regression testing and the impact seems minimal. Recall that the main purpose of AtomicCSR is to provide a CSR accessor that does not require a mutable reference to the base object. This can make certain Rust idioms a bit cleaner. We wrap the base accessor in Arc+Atomic to try and improve the safety of throwing the borrow checker under the bus, but it's still not perfect because hardware mutable state can have side-effects within hardware itself that cannot be modeled or checked by Rust's borrow checker. |
||
|---|---|---|
| .. | ||
| src | ||
| Cargo.toml | ||
| README.md | ||
Xous API: Log
API calls to access the Xous logging service. Provides glue between the log crate, the Xous kernel and the hardware.
Every process that relies on the logging service should call xous_api_log::init_wait() before using any log calls.
Below is a minimal example of how to use the logging service.
fn main() -> ! {
xous_api_log::init_wait().unwrap();
log::set_max_level(log::LevelFilter::Info);
log::info!("my PID is {}", xous::process::id());
let timeout = std::time::Duration::from_millis(1000);
let mut count = 0;
loop {
log::info!("test loop {}", count);
count += 1;
std::thread::sleep(timeout);
}
}