硬體測試指南

本指南將說明如何測試 實體 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 裝置 例如 ffxadb 或 UART。本節會詳細說明 瞭解如何使用各個運輸系統執行指令

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

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

ffx 提供的功能取決於 測試元件Cloud IAM 中的 adbUART 取決於 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 裝置需使用序列控制台,例如 minicomfx 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
燈光