百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
P

pciem

> 编程语言
开源

一个 Linux 框架,可支持用户空间定义的"虚拟"PCIe 卡插件,从而支持在主机内开发 PCIe 卡驱动程序。

370 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

一个 Linux 框架,可支持用户空间定义的"虚拟"PCIe 卡插件,从而支持在主机内开发 PCIe 卡驱动程序。

What is PCIem?

PCIem is a framework that creates virtual PCIe devices in the Linux kernel by leveraging a few novel techniques to populate synthetic cards as legitimate PCI devices to the host OS.

To brief what PCIem is: a framework for (Albeit not limited to) developing and testing PCIe device drivers without requiring actual hardware on the host.

Comparison with libfvio-user

PCIem and libfvio-user are two different solutions for different needs, there may be confusion when comparing both so herein the differences (See figure 1 for more).

The main one is that libvfio-user usually relies on a client (That implements the vfio-user protocol), usually QEMU (Through KVM, using VM exits) to expose the emulated PCIe device to the guest. You write your vfio server (With a callback mechanism usually) which then interacts with the client.

What PCIem does instead is, expose the device directly on the host; no KVM, no guests, no virtual machines, nothing. The device appears on the host's PCIe bus as if it was physically connected.

Architecture

mermaid
graph LR
    subgraph Kernel ["Host Linux Kernel"]
        direction TB

        RealDriver["Real PCIe Driver"]

        subgraph Framework ["PCIem Framework"]
            direction TB
            Config["PCI Config Space"]
            BARs["BARs"]
            IRQ["Interrupts"]
            DMA["DMA / IOMMU"]
        end

    end

    Interface(("/dev/pciem"))

    subgraph User ["Linux Userspace"]
        direction TB
        Shim["Device Emulation"]
    end

    Framework  Interface
    Interface  Shim

Current Features

  • BAR creation: Programmatically create and monitor BAR regions.
  • BAR MMIO tracing: MMIO read/write detection and notification to avoid polling for accesses.
  • Interrupts support: Legacy/MSI/MSI-X interrupt injection.
  • PCI capability framework: PCI capabilities system (Linked-list underneath).
  • DMA system: IOMMU-aware DMA accesses from/to userspace device.
    • P2P support (Preliminar!): Peer-to-peer DMA between devices with whitelist-based access control.
  • Userspace: Implement your PCIe devices entirely in userspace.

Minimum supported environment

  • Linux Kernel Version: 6.6
  • C Compiler: gcc-12
  • Architecture: amd64/i386, aarch64, riscv

aarch64 note: Tested w/Raspberry Pi 4b, device-tree (No ACPI)

riscv note: Tested w/VisionFive 2 (Device-tree) and Muse Pi Pro (Device-tree and ACPI)


CI Status

Distribution
Ubuntu Latest - -
Ubuntu 24.04 LTS
Debian Stable - -
Fedora Latest - -
openSUSE Tumbleweed - -

Examples

Bochs BGA (drm) Card

A Bochs BGA-compatible (bochs-drm) card that can be driven by userspace utilities such as Weston; uses SDL3.

https://github.com/user-attachments/assets/d2f7abe4-aef4-4d3a-a30b-ab7ec793faed

NVME Controller

NVME controller with 1GB of storage attached to. User can freely format, mount, create and remove files from the memory.

https://github.com/user-attachments/assets/29ce370a-7317-4fd4-9d1d-c3e868e1083d

Intel HDA Card

ICH6-compatible emulation model that can play samples in conjunction with pipewire.

NOTE: Slight audio crackling only heard on recording, works fine otherwise

https://github.com/user-attachments/assets/7264a18c-6fcb-46c4-acde-9531b0be7ff6

Intel E1000 Card

A pretty naive implementation of the E1000 card. Supports communications redirection to/from your real NIC. Can also use Wi-Fi but it's less stable.

https://github.com/user-attachments/assets/b6b9862c-349c-49da-8a79-4769dfa31915

Legacy example(s)

ProtoPCIem card

The card is programmed entirely in QEMU (State machine for the card, basically), which does all the userspace initialization and command handling from the real driver running in the host.

Can run software-rendered DOOM (Submits finished frames with DMA to the card which QEMU displays) and also simple OpenGL 1.X games (On the screenshots, tyr-glquake and xash3d; thanks to a custom OpenGL state machine implemented entirely in QEMU that software-renders the command lists and updates the internal state accordingly).

Screenshots

License

  • PCIem kernel components: GPLv2
  • Examples: dual MIT/GPLv2.

References

  • Blog post: https://cakehonolulu.github.io/introducing-pciem/
  • Hackernews post: https://news.ycombinator.com/item?id=46689065
  • PCI Express specification: https://pcisig.com/specifications

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言