[virtio] Address review feedback - simplify documentation and fix cppcheck

- Removed TESTING.md and SPECIFICATIONS.md as requested
- Simplified README.md with essential information only
- Added Chinese version README_zh.md with language links
- Fixed cppcheck AST error by rewriting version check condition
- Changed from (version != 1 && version != 2) to ((version < 1) || (version > 2))

Co-authored-by: BernardXiong <[email protected]>

Author: Copilot

bsp/qemu-virt64-aarch64/drivers/drv_virtio.c

@@ -80,7 +80,7 @@ int rt_virtio_devices_init(void)
         }
 
         /* Support both legacy (0x1) and modern (0x2) versions */
-        if (mmio_config->version != 1 && mmio_config->version != 2)
+        if ((mmio_config->version < 1) || (mmio_config->version > 2))
         {
             continue;
         }

bsp/qemu-virt64-riscv/driver/drv_virtio.c

@@ -86,7 +86,7 @@ int rt_virtio_devices_init(void)
         }
 
         /* Support both legacy (0x1) and modern (0x2) versions */
-        if (mmio_config->version != 1 && mmio_config->version != 2)
+        if ((mmio_config->version < 1) || (mmio_config->version > 2))
         {
             continue;
         }

components/drivers/virtio/README.md

@@ -1,5 +1,7 @@
 # VirtIO Driver for RT-Thread
 
+[中文](README_zh.md) | English
+
 ## Overview
 
 The VirtIO driver provides support for virtual I/O devices in RT-Thread, primarily used in virtualized environments like QEMU.
@@ -43,17 +45,13 @@ Options:
 
 Enable individual VirtIO devices:
 
-```
-RT-Thread Components → Device Drivers → Using VirtIO device drivers
-```
-
 - `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 Between Legacy and Modern VirtIO
+## Key Differences
 
 ### Legacy VirtIO (v0.95)
 - 32-bit feature negotiation
@@ -66,7 +64,6 @@ RT-Thread Components → Device Drivers → Using VirtIO device drivers
 - Separate descriptor/driver/device queue areas
 - Enhanced status flow with FEATURES_OK check
 - Better memory alignment and atomicity guarantees
-- Config generation field for atomic configuration reads
 
 ## Migration Guide
 
@@ -94,74 +91,10 @@ The following BSPs have been updated to support both legacy and modern VirtIO:
 
 ## Reference Specifications
 
-- [VirtIO Specification v1.0](https://docs.oasis-open.org/virtio/virtio/v1.0/virtio-v1.0.html)
-- [VirtIO Specification v1.1](https://docs.oasis-open.org/virtio/virtio/v1.1/virtio-v1.1.html)
-- [VirtIO Specification v1.2](https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html)
-
-## Implementation Details
-
-### Feature Negotiation
-
-Modern VirtIO uses 64-bit feature negotiation:
-- Device exposes features via `device_features` register (selected by `device_features_sel`)
-- Driver acknowledges features via `driver_features` register (selected by `driver_features_sel`)
-- For modern devices, the driver must negotiate `VIRTIO_F_VERSION_1` (feature bit 32)
-
-### Queue Initialization
-
-**Legacy VirtIO:**
-- Uses single `queue_pfn` register pointing to the start of the queue area
-- Guest page size configured via `guest_page_size`
-
-**Modern VirtIO:**
-- Uses separate registers for descriptor, driver (avail), and device (used) areas:
-  - `queue_desc_low`/`queue_desc_high`: Descriptor table address
-  - `queue_driver_low`/`queue_driver_high`: Available ring address
-  - `queue_device_low`/`queue_device_high`: Used ring address
-- Queue activated via `queue_ready` register
-
-### Status Flow
-
-**Modern VirtIO adds FEATURES_OK check:**
-1. Reset device (status = 0)
-2. Set ACKNOWLEDGE and DRIVER status bits
-3. Read and negotiate features
-4. Write negotiated features to device
-5. Set FEATURES_OK status bit
-6. Re-read status to verify FEATURES_OK (device may reject features)
-7. If accepted, proceed with queue setup and set DRIVER_OK
-
-## Troubleshooting
-
-### Device Not Detected
-
-Check that:
-1. QEMU is configured with VirtIO devices
-2. The VirtIO version matches your QEMU configuration
-3. The device memory region is correctly mapped
-
-### Build Errors
-
-Ensure:
-1. The Kconfig is properly configured
-2. All VirtIO header files are included
-3. The BSP supports VirtIO (check `BSP_USING_VIRTIO`)
-
-### Runtime Issues
-
-Debug tips:
-1. Check device version in MMIO config
-2. Verify feature negotiation succeeded
-3. Check queue initialization (descriptor, avail, used ring addresses)
-4. Monitor interrupt status and acknowledgment
-
-## Contributing
-
-When adding new VirtIO devices or features:
-1. Support both legacy and modern versions
-2. Use the helper functions for feature negotiation (`virtio_get_features`, `virtio_set_features`)
-3. Use version checking (`dev->version`) for version-specific code
-4. Test on both legacy and modern QEMU configurations
+- [VirtIO Specification v1.2](https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html) (Latest, 2022)
+- [VirtIO Specification v1.1](https://docs.oasis-open.org/virtio/virtio/v1.1/virtio-v1.1.html) (2019)
+- [VirtIO Specification v1.0](https://docs.oasis-open.org/virtio/virtio/v1.0/virtio-v1.0.html) (2016)
+- [OASIS VirtIO TC](https://www.oasis-open.org/committees/virtio/)
 
 ## License
 

components/drivers/virtio/README_zh.md

@@ -0,0 +1,101 @@
+# RT-Thread VirtIO 驱动
+
+[English](README.md) | 中文
+
+## 概述
+
+VirtIO 驱动为 RT-Thread 提供虚拟 I/O 设备支持，主要用于 QEMU 等虚拟化环境。
+
+## 支持的版本
+
+驱动现已支持传统版和现代版 VirtIO 规范：
+
+- **传统版 VirtIO (v0.95)**：版本字段为 0x1，兼容较旧的 QEMU 版本
+- **现代版 VirtIO (v1.0+)**：版本字段为 0x2，支持 VirtIO 1.0、1.1 和 1.2 规范
+
+## 支持的设备
+
+- **VirtIO 块设备 (virtio-blk)**：虚拟块设备
+- **VirtIO 网络设备 (virtio-net)**：虚拟网络接口
+- **VirtIO 控制台 (virtio-console)**：虚拟串口控制台
+- **VirtIO GPU (virtio-gpu)**：虚拟图形设备
+- **VirtIO 输入设备 (virtio-input)**：虚拟输入设备（键盘、鼠标、触摸板）
+
+## 配置
+
+使用 `menuconfig` 配置 VirtIO 支持：
+
+```
+RT-Thread Components → Device Drivers → Using VirtIO device drivers
+```
+
+### 版本选择
+
+在传统版和现代版 VirtIO 之间选择：
+
+```
+RT-Thread Components → Device Drivers → Using VirtIO device drivers → VirtIO Version
+```
+
+选项：
+- **VirtIO Legacy (v0.95)**：与较旧的 QEMU 版本兼容（默认）
+- **VirtIO Modern (v1.0+)**：用于较新的 QEMU 版本（2.4+），具有增强功能
+
+### 设备选择
+
+启用各个 VirtIO 设备：
+
+- `RT_USING_VIRTIO_BLK`：VirtIO 块设备支持
+- `RT_USING_VIRTIO_NET`：VirtIO 网络设备支持
+- `RT_USING_VIRTIO_CONSOLE`：VirtIO 控制台支持
+- `RT_USING_VIRTIO_GPU`：VirtIO GPU 支持
+- `RT_USING_VIRTIO_INPUT`：VirtIO 输入设备支持
+
+## 主要区别
+
+### 传统版 VirtIO (v0.95)
+- 32 位特性协商
+- 单一队列描述符区域
+- 简单状态标志
+- 客户机页面大小配置
+
+### 现代版 VirtIO (v1.0+)
+- 64 位特性协商（支持更多特性）
+- 独立的描述符/驱动/设备队列区域
+- 增强的状态流程，带 FEATURES_OK 检查
+- 更好的内存对齐和原子性保证
+
+## 迁移指南
+
+### 从传统版迁移到现代版
+
+1. 更新 QEMU 命令行以使用现代版 VirtIO 设备（最新的 QEMU 版本默认使用现代版）
+2. 在 menuconfig 中更改 VirtIO 版本：
+   ```
+   RT-Thread Components → Device Drivers → Using VirtIO device drivers → VirtIO Version
+   → 选择 "VirtIO Modern (v1.0+)"
+   ```
+3. 重新构建应用程序
+4. 驱动将自动与设备协商 VERSION_1 特性
+
+### 向后兼容性
+
+驱动从 MMIO 配置中自动检测设备版本，并相应调整其行为。传统版（版本 0x1）和现代版（版本 0x2）设备在同一构建中都受支持。
+
+## BSP 支持
+
+以下 BSP 已更新以支持传统版和现代版 VirtIO：
+
+- `qemu-virt64-riscv`：QEMU RISC-V 64 位
+- `qemu-virt64-aarch64`：QEMU ARM64 (AArch64)
+
+## 规范参考
+
+- [VirtIO 规范 v1.2](https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html)（最新，2022）
+- [VirtIO 规范 v1.1](https://docs.oasis-open.org/virtio/virtio/v1.1/virtio-v1.1.html)（2019）
+- [VirtIO 规范 v1.0](https://docs.oasis-open.org/virtio/virtio/v1.0/virtio-v1.0.html)（2016）
+- [OASIS VirtIO 技术委员会](https://www.oasis-open.org/committees/virtio/)
+
+## 许可证
+
+Apache-2.0