驱动程序评分准则

概览

本文档介绍了编写新驱动程序的规则。

位置信息

许多驱动程序位于 /src/devices 下（根据驱动程序类型命名）。例如 /src/devices/clock/drivers、/src/devices/usb/drivers 等。部分功能区域包含其驱动程序（位于其自己的目录中，例如 /src/media/audio/drivers、/src/graphics/drivers 等）。新驱动程序必须与同类型的其他驱动程序放在一起。如果不存在任何现有文件夹，则新驱动程序应在逻辑上放置在其下，则需要向 /src/devices 添加一个新文件夹，并适当命名并在其下包含驱动程序文件夹。

所有者

与 Fuchsia 中的其他代码一样，必须由所有者批准添加新驱动程序。用于检查审批的 OWNERS 文件取决于添加驱动程序的位置。

驱动程序信息

将驱动程序添加到 Fuchsia 树时，必须创建驱动程序信息文件，并且 fuchsia_driver_component 目标必须包含 info = <some-driver-info.json> 条目。info 中列出的 JSON 文件必须至少包含一个 short_description 文本和一个 areas 列表，该列表包含来自区域的条目。例如，aml-g12-tdm-dai-info.json 包含：

{
    "short_description": "AMLogic g12 audio subsystem DAI TDM driver",
    "manufacturer": "AMLogic",
    "families": [
        "g12"
    ],
    "models": [
        "S905D2",
        "T931",
        "S905D3"
    ],
    "areas": [
        "Media",
        "Audio"
    ]
}

请注意，此文件由 fx create driver 自动创建，请参阅创建新驱动程序。