any-uart

Crates.ioany-uart
lib.rsany-uart
version0.2.12
created_at2025-03-25 05:39:03.856986+00
updated_at2025-08-12 06:19:58.271401+00
descriptionInit early console from device tree, mostly for Arm
homepage
repositoryhttps://github.com/rcore-os/any-uart
max_upload_size
id1604799
size22,658
周睿 (ZR233)

documentation

README

Any Uart

Check, Build and Test

A easy way to use early console in ARM.

Get the debug uart address from dtb, and some uart driver are supported.

supported uart

  • 8250 and 16550
  • pl011
  • aux_mini (raspi 4b)

example

use core::ptr::NonNull;

// your dtb address
let dtb_addr = 0usize as *mut u8

fn phys_to_virt(addr: usize) -> *mut u8 { 
    // phys addr to virt addr logic
    addr as *mut u8
}

if let Some(mut uart) = any_uart::init(NonNull::new(dtb_addr).unwrap(), phys_to_virt) {
    let mut tx = uart.tx.take().unwrap();
    let _ = tx.write_str_blocking("Hello, world!\n");
}

test

cargo install ostool
# test with qemu
cargo test -p hello --test test -- --show-output
# test with uboot
cargo test --release -p hello --test test -- --show-output --uboot
Commit count: 32

cargo fmt