Halaman utama Jelajahi Bantuan
Masuk
RT-Thread
/
rt-thread
cermin dari https://github-proxy.rt-thread.io/RT-Thread/rt-thread.git
2
0
Fork 0
Berkas Masalah 0 Wiki
Cabang: copilot/update-virtio-to-modern-version
Ranting Tag
rt-thread
/
components
/
drivers
/
virtio
copilot-swe-agent[bot] a45ccc69cb [virtio] Address review feedback - simplify documentation and fix cppcheck 2 bulan lalu
..
Kconfig ee5dac3daa [virtio] Add comprehensive documentation and maintain backward compatibility 3 bulan lalu
README.md a45ccc69cb [virtio] Address review feedback - simplify documentation and fix cppcheck 2 bulan lalu
README_zh.md a45ccc69cb [virtio] Address review feedback - simplify documentation and fix cppcheck 2 bulan lalu
SConscript 9bc68d26a4 format Kconfig and sconscript 3 tahun lalu
virtio.c 81d0c2a75d [virtio] Add modern VirtIO (v1.2.0) support with backward compatibility 3 bulan lalu
virtio.h ee5dac3daa [virtio] Add comprehensive documentation and maintain backward compatibility 3 bulan lalu
virtio_blk.c 81d0c2a75d [virtio] Add modern VirtIO (v1.2.0) support with backward compatibility 3 bulan lalu
virtio_blk.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu
virtio_console.c 81d0c2a75d [virtio] Add modern VirtIO (v1.2.0) support with backward compatibility 3 bulan lalu
virtio_console.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu
virtio_gpu.c 81d0c2a75d [virtio] Add modern VirtIO (v1.2.0) support with backward compatibility 3 bulan lalu
virtio_gpu.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu
virtio_input.c 81d0c2a75d [virtio] Add modern VirtIO (v1.2.0) support with backward compatibility 3 bulan lalu
virtio_input.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu
virtio_input_event_codes.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu
virtio_mmio.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu
virtio_net.c 81d0c2a75d [virtio] Add modern VirtIO (v1.2.0) support with backward compatibility 3 bulan lalu
virtio_net.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu
virtio_queue.h 501b22aabe [HUST CSE] Fix many abnormal symbols in annotations and format code 2 tahun lalu

README.md

VirtIO Driver for RT-Thread

中文 | English

Overview

The VirtIO driver provides support for virtual I/O devices in RT-Thread, primarily used in virtualized environments like QEMU.

Supported Versions

The driver now supports both legacy and modern VirtIO specifications:

  • Legacy VirtIO (v0.95): Version field 0x1, compatible with older QEMU versions
  • Modern VirtIO (v1.0+): Version field 0x2, supports VirtIO 1.0, 1.1, and 1.2 specifications

Supported Devices

  • VirtIO Block (virtio-blk): Virtual block device
  • VirtIO Network (virtio-net): Virtual network interface
  • VirtIO Console (virtio-console): Virtual serial console
  • VirtIO GPU (virtio-gpu): Virtual graphics device
  • VirtIO Input (virtio-input): Virtual input device (keyboard, mouse, tablet)

Configuration

Use menuconfig to configure VirtIO support:

RT-Thread Components → Device Drivers → Using VirtIO device drivers

Version Selection

Choose between legacy and modern VirtIO:

RT-Thread Components → Device Drivers → Using VirtIO device drivers → VirtIO Version

Options:

  • VirtIO Legacy (v0.95): For compatibility with older QEMU versions (default)
  • VirtIO Modern (v1.0+): For newer QEMU versions (2.4+) with enhanced features

Device Selection

Enable individual VirtIO devices:

  • RT_USING_VIRTIO_BLK: VirtIO block device support
  • RT_USING_VIRTIO_NET: VirtIO network device support
  • RT_USING_VIRTIO_CONSOLE: VirtIO console device support
  • RT_USING_VIRTIO_GPU: VirtIO GPU device support
  • RT_USING_VIRTIO_INPUT: VirtIO input device support

Key Differences

Legacy VirtIO (v0.95)

  • 32-bit feature negotiation
  • Single queue descriptor area
  • Simple status flags
  • Guest page size configuration

Modern VirtIO (v1.0+)

  • 64-bit feature negotiation (supports more features)
  • Separate descriptor/driver/device queue areas
  • Enhanced status flow with FEATURES_OK check
  • Better memory alignment and atomicity guarantees

Migration Guide

From Legacy to Modern

  1. Update your QEMU command line to use modern VirtIO devices (most recent QEMU versions default to modern)

  2. Change the VirtIO version in menuconfig:

    RT-Thread Components → Device Drivers → Using VirtIO device drivers → VirtIO Version
→ Select "VirtIO Modern (v1.0+)"

  3. Rebuild your application

  4. The driver will automatically negotiate the VERSION_1 feature with the device

Backward Compatibility

The driver automatically detects the device version from the MMIO config and adapts its behavior accordingly. Both legacy (version 0x1) and modern (version 0x2) devices are supported in the same build.

BSP Support

The following BSPs have been updated to support both legacy and modern VirtIO:

  • qemu-virt64-riscv: QEMU RISC-V 64-bit
  • qemu-virt64-aarch64: QEMU ARM64 (AArch64)

Reference Specifications

License

Apache-2.0