#vga #high-level #freestanding #0x-b8000 #prelude #color #vgastream

vgastream-rs

High level VGA(0xB8000) library in freestanding Rust

3 releases

0.1.2 Dec 2, 2023
0.1.1 Dec 1, 2023
0.1.0 Nov 29, 2023

#254 in Embedded development

41 downloads per month

MIT/Apache

14KB
269 lines

vgastream-rs

  • High level VGA(0xB8000) library in freestanding Rust.
  • Provides println print eprintln eprint macros.

How to use


cargo add vgastream-rs


Examples

/*main.rs*/

#![no_std]
#![no_main]

mod multiboot;
mod panic;

extern crate vgastream_rs;
use vgastream_rs::prelude::*;
use vga_rs::Color;

#[no_mangle]
pub extern "C" fn _start() -> ! {
	VgaOutStream::new().reset_with((Color::BLACK, Color::WHITE));

    let _ = main();
	loop{
		unsafe { panic::halt() }
	}
}

fn main() {
    println!("Hello, World!");
}


/*multiboot.rs*/

#[repr(C, align(4))]
pub struct MultiBoot {
    magic: u32,
    flags: u32,
    checksum: u32,
}

const ALIGN: u32 = 1 << 0;
const MEMINFO: u32 = 1 << 1;
const MAGIC: u32 = 0x1BADB002;
const FLAGS: u32 = ALIGN | MEMINFO;

#[used]
#[link_section = ".multiboot"]
#[no_mangle]
static multiboot: MultiBoot = MultiBoot {
    magic: MAGIC,
    flags: FLAGS,
    checksum: !(MAGIC + FLAGS)+1,
};

/*panic.rs*/

use core::panic::PanicInfo;
use vgastream_rs::prelude::*;

use core::arch::asm;
#[inline]
pub unsafe fn halt() -> ! {
    asm!("cli","hlt");
    core::hint::unreachable_unchecked()
}

#[panic_handler]
fn panic(info: &PanicInfo) -> ! {
    eprintln!("{}", info);
	loop
	{
		unsafe { halt() }
	}
}

simplekernel-rs

git clone https://gitlab.com/hwoy/simplekernel-rs.git

simplekernel-rs can print out "Hello, World!" on x86 freestanding.

Contact me

Dependencies

~22KB