本頁面由 Cloud Translation API 翻譯而成。

建立複合式節點

本教學課程說明如何在 Fuchsia 系統中為複合驅動程式庫建立複合節點。

複合節點規格是一種機制，用於描述 Fuchsia 系統中的複合節點。複合節點：具有多個父項節點的節點。驅動程式庫會繫結至複合節點，並使用系統中多個父項節點管理的資源。

如要為複合驅動程式庫建立複合節點，您需要執行下列工作：

建立複合節點規格
編寫複合驅動程式庫繫結規則 (以符合複合節點規格)

步驟如下：

準備父項規格。
建立複合節點規格。
定義複合驅動程式的繫結規則。

有關故障排除問題，請參閱調試複合驅動程式庫問題。

理解複合節點概念

複合節點是一個多個父節點的節點。複合節點充當多個父節點的中央連接點，從而能夠存取這些父節點管理的資源。當驅動程式庫繫結至複合節點時，複合驅動程式庫可以存取父項驅動程式提供的合併資源。

複合節點

圖 1. 複合節點可以存取多個父節點及其資源。

在開始之前，請先熟悉以下開發概念：

關鍵背景概念
什麼是複合節點規格？
驅動程式庫架構如何在 Fuchsia 系統中建立複合節點？
驅動程式庫框架如何將複合驅動程式庫與複合節點配對？
繫結規則如何運作？

關鍵背景概念

本教學課程假設您熟悉下列與 Fuchsia 驅動程式相關的概念：

驅動程式繫結：將驅動程式與 Fuchsia 系統中的節點配對的程序。
複合節點：具有多個父項節點的節點，可存取 Fuchsia 系統中的多項資源。
驅動程式架構 (DFv2)：這項新架構可管理 Fuchsia 中的驅動程式和節點。

什麼是複合節點規範？

複合節點規格是建立複合節點的機制。它描述了可以作為複合節點的父節點的節點，以及可以繫結到複合節點的適當複合驅動程式庫。

與元件資訊清單 (.cml) 和繫結規則 (.bind) 不同，複合節點規格「不是檔案」。這是需要由驅動程式庫程式 (確切來說，是由載入 Fuchsia 系統的驅動程式原始碼) 建構及新增 (使用 CompositeNodeManager 通訊協定) 的物件。

複合節點規範

圖 2. 複合節點規範是父節點規範的集合。

複合節點規範由一組父節點規範組成，每個父節點規範代表複合節點的父節點的標準。一組父項規格可達到下列目的：

描述此複合節點的父節點。
提供用於識別複合驅動程式庫的屬性。

複合節點規格中的每個父項規格都包含下列項目：

繫結規則：用於將這個父項規格與拓撲中的節點比對的繫結規則。
屬性: 用於在複合節點匹配過程中尋找複合驅動程式庫的鍵值對的一部分。(格式與節點屬性相同)。

驅動程式庫架構如何在 Fuchsia 系統中建立複合節點？

當系統中引入複合節點規範時，會發生以下事件：

複合節點規格會由 Fuchsia 系統中載入的驅動程式庫 (通常是主機板驅動程式) 新增至驅動程式庫架構。
驅動程式管理員會要求驅動程式索引根據複合節點規格，搜尋相符的複合驅動程式庫。

系統會比對複合驅動程式庫，其繫結規則可滿足這個複合節點規格中父項規格的所有屬性。(請參閱「驅動程式庫架構如何將複合式驅動程式庫與複合式節點相符？」一文)。
找到複合驅動程式庫後，驅動程式管理器會要求驅動程式庫索引根據複合節點規格，在系統中搜尋節點。

節點屬性能夠滿足複合節點規範中父規範提供的 bind 規則 的節點將會被比對。每個相符節點都會成為步驟 4 中新建立複合節點的父項節點。
所有父項規格都相符後，驅動程式管理器會使用相符節點做為父項，建立複合節點，最後將複合驅動程式庫 (在步驟 2 中相符) 繫結至新建立的複合節點。（複合節點提供主節點和節點名稱。）

驅動程式庫框架如何將複合驅動程式庫與複合節點進行配對？

複合驅動程式的匹配過程是透過將複合驅動程式的 bind rules 應用於複合節點規範中父規範提供的 properties 來完成的。（請注意，這與將父規範的繫結規則應用於拓撲中的匹配節點不同。）

舉例來說，下列繫結規則來自複合驅動程式庫：

composite focaltech_touch;

using fuchsia.gpio;
using fuchsia.hardware.i2c;
using fuchsia.i2c;

primary node "i2c" {
  fuchsia.hardware.i2c.Service == fuchsia.hardware.i2c.Service.ZirconTransport;
  fuchsia.BIND_I2C_ADDRESS == fuchsia.i2c.BIND_I2C_ADDRESS.FOCALTECH_TOUCH;
}

node "gpio-int" {
  fuchsia.BIND_PROTOCOL == fuchsia.gpio.BIND_PROTOCOL.DEVICE;
  fuchsia.gpio.FUNCTION == fuchsia.gpio.FUNCTION.TOUCH_INTERRUPT;
}

使用這些繫結規則時，相符的複合節點規格需要父項規格，且屬性必須與 i2c 相符，另一個父項規格的屬性則必須與 gpio-int 相符。

如果滿足以下條件，則複合驅動程式庫與複合節點（規範）之間的匹配成功：

所有父項規格都必須與複合驅動程式庫繫結規則中的節點相符。

複合驅動程式庫繫結規則中的所有 非可選 節點必須與父規範相符。

例如，複合驅動程式庫中的這些繫結規則包含一個可選節點：

composite virtio_input;

using fuchsia.acpi;
using fuchsia.hardware.pci;
using fuchsia.pci;

primary node "pci" {
    fuchsia.hardware.pci.Service == fuchsia.hardware.pci.Service.ZirconTransport;
    fuchsia.BIND_PCI_VID == fuchsia.pci.BIND_PCI_VID.VIRTIO;
    fuchsia.BIND_PCI_DID == fuchsia.pci.BIND_PCI_DID.VIRTIO_DEV_TYPE_INPUT;
}

optional node "acpi" {
    fuchsia.BIND_PROTOCOL == fuchsia.acpi.BIND_PROTOCOL.DEVICE;
}

（來源: virtio_input.bind）

節點無需按照複合驅動程式庫繫結規則中列出的順序進行比對。

但是，匹配不能有歧義，也就是說：

每個父級規範必須僅與複合驅動程式庫繫結規則中的一個節點相對應。
複合繫結規則中的每個節點最多只能與一個父項規格相符。(選用節點可能與任何父項規格不符)。

如果發生模稜兩可的情況，驅動程式管理工具會在記錄中列印警告訊息。(目前系統仍會比對，但日後將不允許。請參閱這張相關票證)。

父級規範繫結規則

圖 3. 每個父級規範的繫結規則用於尋找複合節點的父節點。

複合節點繫結規則

圖 4. 複合驅動程式庫繫結規則與複合節點的屬性進行匹配，這些屬性由複合節點規範中的父規範共同提供。

繫結規則是如何運作的？

上層規格中的繫結規則會提供接受和拒絕的屬性值清單。如要讓節點符合繫結規則，節點屬性必須包含所有接受的節點屬性值，且不得包含任何遭拒的屬性值。

例如，父規範可以包含以下繫結規則：

接受 fuchsia.BIND_PROTOCOL 值 15 和 17。
拒絕 fuchsia.BIND_PLATFORM_DEV_VID 值 Intel。

使用這些繫結規則，只有當節點的 fuchsia.BIND_PROTOCOL 屬性值為 15 或 17，且 fuchsia.BIND_PLATFORM_DEV_VID 屬性值為 Intel 時，該節點才能被符合。

1. 準備母體規格

首先，您需要準備構成複合節點規格的父項規格。

如要準備父項規格，請按照下列步驟操作：

在父項規格中定義繫結規則。
在父項規格中定義屬性。

1. 在父項規格中定義繫結規則

繫結規則會根據父項規格，在拓撲中尋找及比對節點。系統會根據父項規格中的繫結規則評估節點的屬性。如果相符，該節點就會成為複合節點的父項。

編寫繫結規則的程序

為複合節點的父項節點編寫繫結規則的程序，與繫結規則教學課程中說明的程序類似。如要判斷繫結規則，請先找出要繫結的每個父項節點屬性。

如要查看節點拓撲中每個節點的屬性，可以使用下列 ffx 指令：

ffx driver list-devices -v

這個指令會列印類似下列的項目：

Name     : i2c-1-56
Topo Path: sys/platform/i2c-0/aml-i2c/i2c/i2c-1-56
Driver   : fuchsia-boot:///#driver/i2c.so
Flags    : MUST_ISOLATE | BOUND
Proto    : ZX_PROTOCOL_I2C (24)
3 Properties
[ 1/  3] : Key fuchsia.BIND_I2C_BUS_ID        Value 0x000001
[ 2/  3] : Key fuchsia.BIND_I2C_ADDRESS       Value 0x000038
[ 3/  3] : Key "fuchsia.hardware.i2c.Service" Value "fuchsia.hardware.i2c.Service.ZirconTransport"

上述範例項目顯示 i2c-1-56 節點的下列節點屬性：

fuchsia.I2C_BUS_ID = 0x000001undefined
fuchsia.I2C_ADDRESS = 0x000038
fuchsia.hardware.i2c.Service = fuchsia.hardware.i2c.Service.ZirconTransport

如要查看可接受的屬性值，可以在 Fuchsia 程式碼庫中查詢繫結程式庫 (例如在 src/devices/bind 目錄中)。在本範例中，由於節點是 I2C 節點，因此屬性值位於 fuchsia.i2c 繫結程式庫中，如下所示：

extend uint fuchsia.BIND_I2C_BUS_ID {
  I2C_A0_0 = 0,
  I2C_2 = 1,
  I2C_3 = 2,
};

extend uint fuchsia.BIND_I2C_ADDRESS {
  BACKLIGHT = 0x2C,
  ETH = 0x18,
  FOCALTECH_TOUCH = 0x38,
  AMBIENTLIGHT = 0x39,
  AUDIO_CODEC = 0x48,
  GOODIX_TOUCH = 0x5d,
  TI_INA231_MLB = 0x49,
  TI_INA231_SPEAKERS = 0x40,
  TI_INA231_MLB_PROTO = 0x46,
};

除了 Fuchsia 程式碼集中的繫結程式庫外，您也可以從 FIDL 程式庫產生繫結程式庫。在上述範例中，fuchsia.hardware.i2c.Service 鍵的屬性及其值 fuchsia.hardware.i2c.Service.ZirconTransport 來自這裡。(詳情請參閱產生的繫結程式庫)。

使用繫結程式庫中的屬性值，重新對應節點屬性，如下所示：

fuchsia.BIND_I2C_BUS_ID = fuchsia.i2c.BIND_I2C_BUS_ID.I2C_2
fuchsia.BIND_I2C_ADDRESS = fuchsia.i2c.BIND_I2C_ADDRESS.FOCALTECH_TOUCH
fuchsia.hardware.i2c.Service = fuchsia.hardware.i2c.Service.ZirconTransport

您可以在驅動程式庫原始碼中，透過產生的程式庫存取這些繫結程式庫值。(詳情請參閱繫結程式庫程式碼產生教學課程)。

符合這些屬性的繫結規則定義如下：

accept fuchsia.hardware.i2c.Service { fuchsia.hardware.i2c.Service.ZirconTransport }
accept BIND_I2C_BUS_ID { fuchsia.i2c.BIND_I2C_BUS_ID.I2C_2 }
accept BIND_I2C_ADDRESS { fuchsia.i2c.BIND_I2C_ADDRESS.FOCALTECH_TOUCH }

在 DFv1 中定義繫結規則

在 DFv1 中，複合節點規格是使用 DDKTL (裝置驅動程式套件範本程式庫) 編寫。用於編寫繫結規則的函式位於 composite-node-spec.h 中。

有了 DDK 程式庫和繫結程式庫的程式碼產生值，我們就能編寫下列內容：

const ddk::BindRule kI2cBindRules[] = {
    ddk::MakeAcceptBindRule(bind_fuchsia_hardware_i2c::SERVICE,
                            bind_fuchsia_hardware_i2c::SERVICE_ZIRCONTRANSPORT),
    ddk::MakeAcceptBindRule(bind_fuchsia::I2C_BUS_ID,
                            bind_fuchsia_i2c::BIND_I2C_BUS_ID_I2C_2),
    ddk::MakeAcceptBindRule(bind_fuchsia::I2C_ADDRESS,
                            bind_fuchsia_focaltech_platform::BIND_I2C_ADDRESS_TOUCH),
};

在 DFv2 中定義繫結規則

在 DFv2 中，複合節點規格是由 CompositeNodeSpec 通訊協定從 composite_node_spec.fidl 定義，位於 fuchsia.driver.framework FIDL 程式庫中。sdk/lib/driver/component/cpp 目錄中的 composite_node_spec.h 程式庫可用於簡化繫結規則的定義。

使用 CompositeNodeSpec 程式庫和繫結程式庫程式碼產生值，我們可以編寫下列內容：

auto i2c_bind_rules = std::vector {
    MakeAcceptBindRule(bind_fuchsia_hardware_i2c::SERVICE,
                       bind_fuchsia_hardware_i2c::SERVICE_ZIRCONTRANSPORT),
    MakeAcceptBindRule(bind_fuchsia::I2C_BUS_ID,
                       bind_fuchsia_i2c::BIND_I2C_BUS_ID_I2C_2),
    MakeAcceptBindRule(bind_fuchsia::I2C_ADDRESS,
                       bind_fuchsia_focaltech_platform::BIND_I2C_ADDRESS_TOUCH),
};

2. 在上層規格中定義屬性

除了定義節點的繫結規則，您還需要在父項規格中定義用於尋找複合式驅動程式庫的屬性。

這些屬性是鍵/值組合，用於將父項規格與複合驅動程式庫的繫結規則相符。這與節點屬性相同，格式也相同。屬性鍵可以是整數或字串，而屬性值可以是整數、布林值、字串或列舉類型。

在 DFv1 中定義屬性

在 DFv1 中，複合節點規格是使用 DDKTL 編寫，而編寫繫結規則的函式位於 composite-node-spec.h 中。您可以使用 DDK 程式庫定義屬性，並繫結程式庫程式碼產生值，如下所示：

const device_bind_prop_t kI2cProperties[] = {
    ddk::MakeProperty(bind_fuchsia_hardware_i2c::SERVICE,
                      bind_fuchsia_hardware_i2c::SERVICE_ZIRCONTRANSPORT),
    ddk::MakeProperty(bind_fuchsia::I2C_ADDRESS,
                      bind_fuchsia_focaltech_platform::BIND_I2C_ADDRESS_TOUCH),
};

在 DFv2 中定義屬性

在 DFv2 中，複合節點規格是為 composite_node_spec.fidl 寫入，位於 fuchsia.driver.framework FIDL 程式庫中。//sdk/lib/driver/component/cpp 中的 node_add_args.h 程式庫可用於簡化屬性定義。您可以使用 CompositeNodeSpec 程式庫定義屬性，並繫結程式庫程式碼產生值，如下所示：

auto i2c_properties[] = std::vector {
    ddk::MakeProperty(bind_fuchsia::I2C_ADDRESS,
                      bind_fuchsia_focaltech_platform::BIND_I2C_ADDRESS_TOUCH),
};

2. 建立複合節點規格

建立複合節點規格時，需要定義一組父項規格並新增至驅動程式管理器。

複合節點規格是由 Fuchsia 系統中載入的驅動程式庫 (通常是主機板驅動程式庫) 新增至驅動程式庫程式架構。(如要進一步瞭解這個程序，請參閱「How does the 驅動程式庫 framework create a composite node in a Fuchsia system?」)

在 DFv1 中新增複合節點規格

在 DFv1 中，驅動程式庫可透過 DDKTL 的 DdkAddCompositeNodeSpec() 函式新增複合節點規格。

驅動程式必須先在 composite-node-spec.h 程式庫中定義 CompositeNodeSpec 物件。使用上一節中的範例繫結規則和屬性，您可以定義具有 I2C 父項規格的 CompositeNodeSpec 物件，如下所示：

const ddk::BindRule kI2cBindRules[] = {
    ddk::MakeAcceptBindRule(bind_fuchsia_hardware_i2c::SERVICE,
                            bind_fuchsia_hardware_i2c::SERVICE_ZIRCONTRANSPORT),
    ddk::MakeAcceptBindRule(bind_fuchsia::I2C_BUS_ID,
                            bind_fuchsia_i2c::BIND_I2C_BUS_ID_I2C_2),
    ddk::MakeAcceptBindRule(bind_fuchsia::I2C_ADDRESS,
                            bind_fuchsia_focaltech_platform::BIND_I2C_ADDRESS_TOUCH),
};

const device_bind_prop_t kI2cProperties[] = {
    ddk::MakeProperty(bind_fuchsia_hardware_i2c::SERVICE,
                      bind_fuchsia_hardware_i2c::SERVICE_ZIRCONTRANSPORT),
    ddk::MakeProperty(bind_fuchsia::I2C_ADDRESS,
                      bind_fuchsia_focaltech_platform::BIND_I2C_ADDRESS_TOUCH),
};

auto spec = ddk::CompositeNodeSpec(kI2cBindRules, kI2cProperties);

您可以使用 AddParentSpec() 函式新增任何其他節點。舉例來說，如要為 GPIO 解譯插腳新增父項規格，可以編寫下列內容：

const ddk::BindRule kGpioInterruptRules[] = {
    ddk::MakeAcceptBindRule(bind_fuchsia::PROTOCOL,
                            bind_fuchsia_gpio::BIND_PROTOCOL_DEVICE),
    ddk::MakeAcceptBindRule(bind_fuchsia::GPIO_PIN,
                bind_fuchsia_amlogic_platform_s905d2::GPIOZ_PIN_ID_PIN_4),
};

const device_bind_prop_t kGpioInterruptProperties[] = {
    ddk::MakeProperty(bind_fuchsia::PROTOCOL,
                      bind_fuchsia_gpio::BIND_PROTOCOL_DEVICE),
    ddk::MakeProperty(bind_fuchsia_gpio::FUNCTION,
                      bind_fuchsia_gpio::FUNCTION_TOUCH_INTERRUPT)};

desc.AddParentSpec(kGpioInterruptRules, kGpioInterruptProperties);

CompositeNodeSpec 物件準備就緒後，即可使用 DdkAddCompositeNodeSpec() 新增，其中 spec 是包含複合節點規格的物件，例如：

auto status = DdkAddCompositeNodeSpec("ft3x27_touch", spec);

由於 CompositeNodeSpec 物件遵循建構工具模式，因此可以簡化為：

auto status =
     DdkAddCompositeNodeSpec("ft3x27_touch",
          ddk::CompositeNodeSpec(kFocaltechI2cRules, kFocaltechI2cProperties)
              .AddParentSpec(kGpioInterruptRules, kGpioInterruptProperties)
              .set_metadata(metadata);

在 DFv2 中新增複合節點規格

在 DFv2 中，我們會使用 fuchsia.driver.framework FIDL API 的 CompositeNodeManager 通訊協定，新增複合節點規格：

@discoverable
protocol CompositeNodeManager {
    /// Add the given spec to the driver manager.
    AddSpec(CompositeNodeSpec) -> () error CompositeNodeSpecError;
};

將複合節點規格新增至平台匯流排

如果複合節點需要平台匯流排上節點的父項，則板載驅動程式庫可以透過 platform_bus.fidl API 新增複合節點規格。這適用於 DFv1 和 DFv2。

/// Adds a composite node specification to the bus. This will add a platform device specified
/// by |node| and insert a node into the composite node specification that matches the device.
AddCompositeNodeSpec(struct {
    node Node;
    spec fuchsia.driver.framework.CompositeNodeSpec;
}) -> () error zx.Status;

平台匯流排 API 使用 composite_node_spec.fidl 中定義的相同 CompositeNodeSpec 結構體。

舉例來說，假設我們定義了下列複合節點規格：

std::vector<fuchsia_driver_framework::BindRule> bind_rules = {
    fdf::MakeAcceptBindRule(bind_fuchsia_hardware_i2c::SERVICE,
        bind_fuchsia_hardware_i2c::SERVICE_ZIRCONTRANSPORT),
    fdf::MakeAcceptBindRule(bind_fuchsia::I2C_ADDRESS,
        bind_fuchsia_i2c::BIND_I2C_ADDRESS_BACKLIGHT),
};

std::vector<fuchsia_driver_frameowork::Node> properties = {
    fdf::MakeProperty(bind_fuchsia_hardware_i2c::SERVICE,
        bind_fuchsia_hardware_i2c::SERVICE_ZIRCONTRANSPORT),
    fdf::MakeProperty(bind_fuchsia::I2C_ADDRESS,
        bind_fuchsia_i2c::BIND_I2C_ADDRESS_BACKLIGHT),
};

std::vector<fuchsia_driver_framework::ParentSpec> spec = {
    {{bind_rules, properties}}
};

(如要進一步瞭解上述範例中使用的程式庫，請參閱「在 DFv2 中定義屬性」和「在 DFv2 中定義繫結規則」。)

定義複合節點規格後，板載驅動程式庫即可透過 PlatformBus FIDL 通訊協定連線至平台匯流排，並使用用戶端呼叫 AddCompositeNodeSpec()。

AddCompositeNodeSpec() 呼叫會將平台裝置的父項規格 (從節點欄位中的資料建立) 插入指定的複合節點規格，並將這個修改過的複合節點規格新增至驅動程式庫架構。然後建立並新增平台裝置，例如：

fpbus::Node dev;
dev.name() = "backlight";
dev.vid() = PDEV_VID_TI;  // 0x10
dev.pid() = PDEV_PID_TI_LP8556; // 0x01
dev.did() = PDEV_DID_TI_BACKLIGHT;  // 0x01

auto endpoints =
    fdf::CreateEndpoints<fuchsia_hardware_platform_bus::PlatformBus>();
if (endpoints.is_error()) {
    return endpoints.error_value();
}

fdf::WireSyncClient<fuchsia_hardware_platform_bus::PlatformBus> pbus =
    endpoints->client;
auto result = pbus.buffer(arena)->AddCompositeNodeSpec(
fidl::ToWire(fidl_arena, dev),
fidl::ToWire(fidl_arena, spec), false);

if (!result.ok()) {
    FDF_LOG(ERROR, "AddCompositeNodeSpec request failed: %s",
               result.FormatDescription().data());
    return result.status();
}

呼叫 AddCompositeNodeSpec() 後，下列複合節點規格會新增至驅動程式庫架構：

Name      : backlight
Driver    : fuchsia-boot:///#meta/ti-lp8556.cm
Nodes     : 2
Node 0    : None
  3 Bind Rules
  [ 1/ 3] : Accept "fuchsia.BIND_PLATFORM_DEV_VID" { 0x000010 }
  [ 2/ 3] : Accept "fuchsia.BIND_PLATFORM_DEV_PID" { 0x000001 }
  [ 2/ 3] : Accept "fuchsia.BIND_PLATFORM_DEV_DID" { 0x000001 }
  3 Properties
  [ 1/ 3] : Key "fuchsia.BIND_PLATFORM_DEV_VID"   Value 0x000010
  [ 2/ 3] : Key "fuchsia.BIND_PLATFORM_DEV_PID"   Value 0x000001
  [ 3/ 3] : Key "fuchsia.BIND_PLATFORM_DEV_DID"   Value 0x000001
Node 1    : None
  2 Bind Rules
  [ 1/ 2] : Accept "fuchsia.hardware.i2c.Service" { "fuchsia.hardware.i2c.Service.ZirconTransport" }
  [ 2/ 2] : Accept "fuchsia.BIND_I2C_ADDRESS"     { 0x00002C }
  2 Properties
  [ 1/ 2] : Key "fuchsia.hardware.i2c.Service" Value "fuchsia.hardware.i2c.Service.ZirconTransport"
  [ 2/ 2] : Key "fuchsia.BIND_I2C_ADDRESS"     Value 0x00002C
}

複合節點規格範例中顯示的第一個節點 (Node 0) 與從 AddCompositeNodeSpec() 建立的平台裝置相符。第一個父規範由 AddCompositeSpec() 插入，目標是匹配平台設備，其中包含來自 VID, PID 和 DID 的繫結規則和屬性，這些規則和屬性在 fpbus::Node dev 中提供。其餘父節點規範來自傳入的複合節點規範。

3. 為複合驅動程式庫定義繫結規則

定義複合節點規格後，即可開始為複合驅動程式庫編寫繫結規則，這些規則會與根據複合節點規格建立的複合節點相符。

為複合驅動程式庫編寫繫結規則的過程與為驅動程式庫編寫繫結規則的過程類似。

前幾節的範例在父項規格中包含下列屬性：

i2c parent specification properties {
     fuchsia.hardware.i2c.Service: fuchsia.hardware.i2c.Service.ZirconTransport,
     fuchsia.BIND_I2C_ADDRESS: fuchsia.focaltech.platform.BIND_I2C_ADDRESS_TOUCH,
}

gpio-interrupt parent specification properties {
     fuchsia.BIND_PROTOCOL: fuchsia.gpio.BIND_PROTOCOL_DEVICE,
     fuchsia.gpio.FUNCTION: fuchsia.gpio.FUNCTION.TOUCH_INTERRUPT,
}

如果要繫結到具有上述屬性的複合節點規範，可以編寫以下複合繫結規則來符合目標父規範：

composite focaltech_touch;

using fuchsia.gpio;
using fuchsia.hardware.i2c;
using fuchsia.i2c;

primary node "i2c" {
  fuchsia.hardware.i2c.Service == fuchsia.hardware.i2c.Service.ZirconTransport;
  fuchsia.BIND_I2C_ADDRESS == fuchsia.i2c.BIND_I2C_ADDRESS.FOCALTECH_TOUCH;
}

node "gpio-int" {
  fuchsia.BIND_PROTOCOL == fuchsia.gpio.BIND_PROTOCOL.DEVICE;
  fuchsia.gpio.FUNCTION == fuchsia.gpio.FUNCTION.TOUCH_INTERRUPT;
}

附錄

調試複合驅動程式庫問題

如要確認複合節點已順利建立，並嘗試繫結複合驅動程式庫，您可以檢查記錄檔，並尋找類似下列行的陳述式：

Binding driver fuchsia-boot:///#meta/focaltech.cm

如要確認複合節點規格已順利新增並與複合驅動程式庫相符，請執行下列指令：

ffx driver list-composite-node-specs -v

這個指令會輸出類似以下的結果：

Name      : ft3x27_touch
Driver    : fuchsia-boot:///#meta/focaltech.cm
Nodes     : 2
Node 0    : "i2c" (Primary)
  3 Bind Rules
  [ 1/ 3] : Accept "fuchsia.hardware.i2c.Service" { "fuchsia.hardware.i2c.Service.ZirconTransport" }
  [ 2/ 3] : Accept "fuchsia.BIND_I2C_BUS_ID" { 0x000001 }
  [ 3/ 3] : Accept "fuchsia.BIND_I2C_ADDRESS" { 0x000038 }
  2 Properties
  [ 1/ 2] : Key "fuchsia.hardware.i2c.Service" Value "fuchsia.hardware.i2c.Service.ZirconTransport"
  [ 2/ 2] : Key "fuchsia.BIND_I2C_ADDRESS"     Value 0x000038
Node 1    : "gpio-int"
  2 Bind Rules
  [ 1/ 2] : Accept "fuchsia.BIND_PROTOCOL" { 0x000014 }
  [ 2/ 2] : Accept "fuchsia.BIND_GPIO_PIN" { 0x000004 }
  2 Properties
  [ 1/ 2] : Key "fuchsia.BIND_PROTOCOL"        Value 0x000014
  [ 2/ 2] : Key "fuchsia.gpio.FUNCTION"        Value "fuchsia.gpio.FUNCTION.TOUCH_INTERRUPT"

如果沒有與複合節點規範相符的複合驅動程式庫，則該命令將輸出類似於以下內容：

Name      : focaltech_touch
Driver    : None
Nodes     : 2
Node 0    : None
  3 Bind Rules
  [ 1/ 3] : Accept "fuchsia.hardware.i2c.Service" { "fuchsia.hardware.i2c.Service.ZirconTransport" }
  [ 2/ 3] : Accept "fuchsia.BIND_I2C_BUS_ID" { 0x000001 }
  [ 3/ 3] : Accept "fuchsia.BIND_I2C_ADDRESS" { 0x000038 }
  1 Properties
  [ 1/ 2] : Key "fuchsia.hardware.i2c.Service" Value "fuchsia.hardware.i2c.Service.ZirconTransport"
  [ 2/ 2] : Key "fuchsia.BIND_I2C_ADDRESS"     Value 0x000038
Node 1    : None
  2 Bind Rules
  [ 1/ 2] : Accept "fuchsia.BIND_PROTOCOL" { 0x000014 }
  [ 2/ 2] : Accept "fuchsia.BIND_GPIO_PIN" { 0x000004 }
  2 Properties
  [ 1/ 2] : Key "fuchsia.BIND_PROTOCOL"        Value 0x000014
  [ 2/ 2] : Key "fuchsia.gpio.FUNCTION"        Value "fuchsia.gpio.FUNCTION.TOUCH_INTERRUPT

如要進一步瞭解 ffx driver 指令，請參閱「查看驅動程式庫資訊」。