硬體測試指南

本指南將說明如何測試 實體 Fuchsia 裝置。

本指南的目標對象

本指南假設您對硬體和軟體 開發低階軟體開發作業

總覽

本指南中的所有 Fuchsia 硬體測試工作流程都假設 您的 Fuchsia 裝置連線至測試主機。 測試主機是指搭載 Linux 或 Windows 的筆記型電腦或桌上型電腦。 如要測試 Fuchsia 裝置的硬體子系統，請執行指令 例如測試主機上的 adb shell gpioutil list。指令的第一部分 adb shell，是處理傳輸系統， 測試主機和 Fuchsia 裝置。指令的第二部分 gpioutil list，是實際練習或查詢的測試工具 安裝 Fuchsia 裝置上的硬體子系統。

`adb shell gpioutil list` 工作流程的序列圖表。

支援的設定

測試主機的作業系統會決定您所使用的傳輸系統 。例如，目前僅支援 adb 。下表顯示測試的組合 支援的主機 OS 和傳輸系統：

測試主機 OS ffx adb UART
Linux
Windows

運輸系統會決定何種實體連線類型 建立測試主機和目標裝置。例如： 「adb」必須在測試主機和 Fuchsia 之間透過 USB 連線 裝置。Fuchsia 裝置的硬體配置也會影響 可以使用的運輸系統舉例來說，如果您的 Fuchsia 裝置 並未公開 GND、TX 和 RX 接腳，因此無法使用 UART。

設定 Fuchsia 版本進行硬體測試

本節為需要建造 Fuchsia 的人員提供指引 啟動硬體測試工具的映像檔如果已有 搭配所需工具的 Fuchsia 圖片，您可以略過這個部分。

使用來源建構 Fuchsia

如果您從未使用原始碼建構 Fuchsia， 基本工作流程，請參閱下列教學課程：

  1. 下載原始碼
  2. 設定及建構 Fuchsia

在您的版本中加入硬體測試工具

如果您嘗試執行硬體測試工具 (例如 gpioutil) 且收到 not found 錯誤時，可能表示硬體已啟動 測試工具並未在建立 Fuchsia 映像檔時啟用。 範例：

-v: 1: gpioutil: not found

如要解決這個問題，請嘗試在 fx set 中加入 --with-base //bundles/tools 請撥打：

fx set PRODUCT.BOARD --with-base '//bundles/tools'

--with-base 選項會新增 在 Fuchsia 圖片中將 //bundles/tools/BUILD.gn 當做基本套件使用。 Fuchsia 大部分的硬體測試工具都放在這個套件中。

直接加入一項工具

如果 //bundles/tools/BUILD.gn 未列出您需要的硬體測試工具 請嘗試將 --with-base 值設為硬體測試路徑 工具的 BUILD.gn 檔案。舉例來說，gpioutil 建構檔案位於 //src/devices/gpio/bin/gpioutil/BUILD.gn。您可以直接加入 gpioutil 當做基本套件使用，並加上以下 fx set 指令：

fx set PRODUCT.BOARD --with-base '//src/devices/gpio/bin/gpioutil'

您可以視需要重複 --with-base 選項：

fx set PRODUCT.BOARD \
    --with-base '//src/devices/gpio/bin/gpioutil' \
    --with-base '//src/media/audio/tools/audio-driver-ctl'

包含 ADB

如要在 Fuchsia 圖片中啟用 adb，您需要加入 ADB 函式驅動程式和 Daemon。 Daemon 可以是 Fuchsia ADB Daemon 或其他任何與函式驅動程式庫對話的 Daemon

執行中的指令

如總覽中所述，您希望透過 透過傳輸系統傳送至 Fuchsia 裝置 例如 ffx、adb 或 UART。本節會詳細說明 瞭解如何使用各個運輸系統執行指令

不同傳輸系統之間的主要差異：能力

基礎模型 元件 每項運輸系統運作的系統，都會影響該系統提供的功能 。不同的元件公開 功能 ，直接在 Google Cloud 控制台實際操作。

ffx 提供的功能取決於 測試元件Cloud IAM 中的 adb 和 UART 取決於 console-launcher、 這是驅動這些殼層的基礎元件

ffx

ffx 是 Fuchsia 的主要工具 互動模式。

如何啟動互動式殼層：

ffx component explore COMPONENT -l namespace

如要執行單一指令 (例如 gpioutil list)：

ffx component explore COMPONENT -l namespace -c 'gpioutil list'

UART

多數富奇西亞 主面板 支援團隊 3-pin (TX、RX、GND) UART 通訊。他們通常希望 一般 115200 8N1 UART 設定。如要將指令從測試主機傳送至 Fuchsia 裝置需使用序列控制台，例如 minicom 或 fx serial。

adb

如果內含 adb 的 Fuchsia 圖片，您可以傳送 將指令從測試主機傳送到 Fuchsia 裝置上，並使用 adb。

如何啟動互動式殼層：

adb shell

如要執行單一指令 (例如 gpioutil list)：

adb shell 'gpioutil list'

Fuchsia 在設計時僅提供部分 adb 支援。請參閱 RFC-0200 並詳細瞭解支援與不支援的項目詳情請見 //src/developer/adb/bin/README.md敬上 ，進一步瞭解如何搭配使用 adb 與 Fuchsia。

硬體測試工具清單

下表指示您使用具體工具 能用來測試裝置上的各種硬體子系統 Fuchsia 裝置。

硬體子系統 工具
音訊
GPIO
I2C
燈光