探索教育设备

edu 设备连接到系统 PCI 总线,并使用以下配置寄存器值进行自我标识:

  • 供应商 ID (VID)0x1234
  • 设备 ID (DID)0x11E8

设备驱动程序通过中断和内存映射 I/O 与设备交互 (MMIO) 寄存器。

在此 Codelab 中,您将编写一个 Fuchsia 驱动程序,以向其他系统组件提供此 edu 设备的功能。

启动模拟器

停止当前可能正在运行的所有模拟器实例:

ffx emu stop --all

启动已启用驱动程序框架 v2 的 Fuchsia 模拟器的新实例:

ffx emu start core.x64 --headless

探索设备节点

使用 ffx driver list-devices 命令列出已知 系统:

ffx driver list-devices

该命令会输出如下所示的列表:

root
root.sys
root.sys.platform
root.sys.cpu-trace
root.sys.platform.pt
root.sys.platform.ram-disk
root.sys.platform.00_00_2e
root.sys.platform.virtual-audio
root.sys.platform.bt-hci-emulator
root.sys.platform.00_00_1b
root.sys.cpu-trace.perfmon
root.sys.platform.pt.acpi
root.sys.platform.pt.PCI0
...

edu 设备在 PCI 总线上,因此使用以下命令缩小范围 设备列表:

ffx driver list-devices | grep 'PCI'

您会看到类似于以下输出的简短列表:

root.sys.platform.pt.PCI0
root.sys.platform.pt.PCI0.bus
root.sys.platform.pt.PCI0.bus.00_00_0
root.sys.platform.pt.PCI0.bus.00_00_0_
root.sys.platform.pt.PCI0.bus.00_01_0
root.sys.platform.pt.PCI0.bus.00_01_0_
root.sys.platform.pt.PCI0.bus.00_02_0
root.sys.platform.pt.PCI0.bus.00_02_0_
root.sys.platform.pt.PCI0.bus.00_03_0
root.sys.platform.pt.PCI0.bus.00_03_0_
root.sys.platform.pt.PCI0.bus.00_04_0
root.sys.platform.pt.PCI0.bus.00_04_0_
root.sys.platform.pt.PCI0.bus.00_05_0
root.sys.platform.pt.PCI0.bus.00_05_0_
root.sys.platform.pt.PCI0.bus.00_06_0
root.sys.platform.pt.PCI0.bus.00_06_0_
root.sys.platform.pt.PCI0.bus.00_07_0
root.sys.platform.pt.PCI0.bus.00_07_0_
root.sys.platform.pt.PCI0.bus.00_0b_0
root.sys.platform.pt.PCI0.bus.00_0b_0_
root.sys.platform.pt.PCI0.bus.00_1f_0
root.sys.platform.pt.PCI0.bus.00_1f_0_
root.sys.platform.pt.PCI0.bus.00_1f_2
root.sys.platform.pt.PCI0.bus.00_1f_2_
root.sys.platform.pt.PCI0.bus.00_1f_3
root.sys.platform.pt.PCI0.bus.00_1f_3_

这些是当前模拟器实例中的 PCI 设备节点。

发现正确的设备

如需确定其中哪个设备节点是 edu 设备,请使用 使用 lspci 命令查找具有匹配的 VID (0x1234) 和 edu 设备的 DID (0x11e8):

ffx driver lspci

该命令会输出如下所示的列表,指示匹配的 PCI 设备节点为 00:06.0

00:00.0 Host bridge: Intel Corporation 82G33/G31/P35/P31 Express DRAM Controller (rev 00)
00:01.0 Audio device: Intel Corporation 82801FB/FBM/FR/FW/FRW (ICH6 Family) High Definition Audio Controller (rev 01)
00:02.0 SCSI storage controller: Red Hat, Inc. Virtio block device (rev 00)
00:03.0 Mouse controller: Red Hat, Inc. Virtio input (rev 01)
00:04.0 Ethernet controller: Red Hat, Inc. Virtio network device (rev 00)
00:05.0 Keyboard controller: Red Hat, Inc. Virtio input (rev 01)
00:06.0 Unclassified device: [1234:11e8] (rev 10)
00:07.0 Mouse controller: Red Hat, Inc. Virtio input (rev 01)
00:0b.0 Unclassified device: [607d:f153] (rev 01)
...

在上一部分中的设备列表中,这意味着 edu 设备映射 到 PCI 设备节点 root.sys.platform.pt.PCI0.bus.00_06_0_.pci-00_06.0-fidl

使用以下命令探索此设备节点的属性:

ffx driver list-devices root.sys.platform.pt.PCI0.bus.00_06_0_.pci-00_06.0-fidl --verbose

该命令会输出类似于以下内容的输出:

Name     : 0-fidl
Moniker  : root.sys.platform.pt.PCI0.bus.00_06_0_.pci-00_06.0-fidl
Driver   : None
11 Properties
[ 1/ 11] : Key fuchsia.BIND_FIDL_PROTOCOL     Value 0x000004
[ 2/ 11] : Key fuchsia.BIND_PCI_VID           Value 0x001234
[ 3/ 11] : Key fuchsia.BIND_PCI_DID           Value 0x0011e8
[ 4/ 11] : Key fuchsia.BIND_PCI_CLASS         Value 0x000000
[ 5/ 11] : Key fuchsia.BIND_PCI_SUBCLASS      Value 0x0000ff
[ 6/ 11] : Key fuchsia.BIND_PCI_INTERFACE     Value 0x000000
[ 7/ 11] : Key fuchsia.BIND_PCI_REVISION      Value 0x000010
[ 8/ 11] : Key fuchsia.BIND_PCI_TOPO          Value 0x000030
[ 9/ 11] : Key "fuchsia.hardware.pci.Device"  Value true
[10/ 11] : Key fuchsia.BIND_PROTOCOL          Value 0x000000
[11/ 11] : Key "fuchsia.platform.DRIVER_FRAMEWORK_VERSION" Value 0x000002

请注意,此设备目前没有加载驱动程序(Driver 字段设置为 None)。这些属性用于描述 框架在确定驱动程序是否与设备节点匹配时考虑。 在下一部分中,您将声明一个使用这些属性绑定到此设备的驱动程序组件。