本指南將說明如何測試 實體 Fuchsia 裝置。
本指南的目標對象
本指南假設您對硬體和軟體 開發低階軟體開發作業
總覽
本指南中的所有 Fuchsia 硬體測試工作流程都假設
您的 Fuchsia 裝置連線至測試主機。
測試主機是指搭載 Linux 或 Windows 的筆記型電腦或桌上型電腦。
如要測試 Fuchsia 裝置的硬體子系統,請執行指令
例如測試主機上的 adb shell gpioutil list
。指令的第一部分
adb shell
,是處理傳輸系統,
測試主機和 Fuchsia 裝置。指令的第二部分
gpioutil list
,是實際練習或查詢的測試工具
安裝 Fuchsia 裝置上的硬體子系統。
支援的設定
測試主機的作業系統會決定您所使用的傳輸系統
。例如,目前僅支援 adb
。下表顯示測試的組合
支援的主機 OS 和傳輸系統:
測試主機 OS | ffx |
adb |
UART |
---|---|---|---|
Linux | |||
Windows |
運輸系統會決定何種實體連線類型
建立測試主機和目標裝置。例如:
「adb
」必須在測試主機和 Fuchsia 之間透過 USB 連線
裝置。Fuchsia 裝置的硬體配置也會影響
可以使用的運輸系統舉例來說,如果您的 Fuchsia 裝置
並未公開 GND、TX 和 RX 接腳,因此無法使用 UART。
設定 Fuchsia 版本進行硬體測試
本節為需要建造 Fuchsia 的人員提供指引 啟動硬體測試工具的映像檔如果已有 搭配所需工具的 Fuchsia 圖片,您可以略過這個部分。
使用來源建構 Fuchsia
如果您從未使用原始碼建構 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 | |
燈光 |