mirror of https://github.com/Motorhead1991/qemu.git synced 2025-08-02 15:23:53 -06:00

History

Paolo Bonzini e2e0828e0f rust: pl011: extend registers to 32 bits The PL011 Technical Reference Manual lists the "real" size of the registers in table 3-1, and only rounds up to the next byte when describing the registers; for example, UARTDR is listed as having width 12/8 (12 bits read, 8 written) and only bits 15:0 are listed in "Table 3-2 UARTDR Register". However, in practice these are 32-bit registers, accessible only through 32-bit MMIO accesses; preserving the fiction that they're smaller introduces multiple casts (to go from the bilge bitfield type to e.g u16 to u64) and more importantly it breaks the migration stream because the Rust vmstate macros are not yet type safe. So, just make everything 32-bits wide. Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>		2024-12-19 19:36:38 +01:00
..
src	rust: pl011: extend registers to 32 bits	2024-12-19 19:36:38 +01:00
Cargo.toml	rust: cargo: store desired warning levels in workspace Cargo.toml	2024-12-10 18:44:06 +01:00
meson.build	rust: add PL011 device model	2024-11-05 14:18:15 +01:00
README.md	rust: add PL011 device model	2024-11-05 14:18:15 +01:00

README.md

PL011 QEMU Device Model

This library implements a device model for the PrimeCell® UART (PL011) device in QEMU.

Build static lib

Host build target must be explicitly specified:

cargo build --target x86_64-unknown-linux-gnu

Replace host target triplet if necessary.

Generate Rust documentation

To generate docs for this crate, including private items:

cargo doc --no-deps --document-private-items --target x86_64-unknown-linux-gnu

To include direct dependencies like bilge (bitmaps for register types):

cargo tree --depth 1 -e normal --prefix none \
 | cut -d' ' -f1 \
 | xargs printf -- '-p %s\n' \
 | xargs cargo doc --no-deps --document-private-items --target x86_64-unknown-linux-gnu