Skip to content

Latest commit

 

History

History
540 lines (456 loc) · 19.1 KB

intel_nuc.md

File metadata and controls

540 lines (456 loc) · 19.1 KB
Raw

在 NUC 迷你电脑上安装 Fuchsia

本指南提供了有关在 Intel NUC{:.external}（Next Unit of Computing）迷你电脑设备上 Fuchsia 安装方法的说明。

安装步骤为：

  1. 前提条件。
  2. 构建 Fuchsia。
  3. 准备 USB 驱动器。
  4. 启用 NUC 迷你电脑上的 EFI 引导。
  5. 将 Fuchsia 安装至 NUC 迷你电脑。

1. 前提条件 {#prerequisites}

开始在 NUC 迷你电脑设备上安装 Fuchsia 之前，请确保您完成了以下工作：

设置 Fuchsia 开发环境 {#set-up-fuchsia-env}

要在工作站上建立 Fuchsia 开发环境，请您完成开始使用 Fuchsia 指南。

获取配件 {#get-parts}

注意：Fuchsia 仅支持列入支持的系统配置清单的特定系统配置。

本指南需要使用以下配件：

  • 一台 NUC 迷你电脑设备（请参阅示例型号）
  • 一个 USB 3.0 闪存驱动器
  • 一个键盘
  • 一只鼠标（可选）
  • 一台带有 HDMI 端口的显示器
  • 一条 HDMI 线缆
  • 一条以太网线缆
  • 一把十字头螺丝刀（带有磁性尖端）

注意：“2. 构建 Fuchsia”和“3. 准备 USB 驱动器”两节不需要 NUC 迷你电脑设备，因此您可以在获得 NUC 迷你电脑设备之前完成这些章节。但是，“3. 准备 USB 驱动器”一节需要 USB 闪存驱动器。

2. 构建 Fuchsia {#build-fuchsia}

要在 NUC 迷你电脑设备上安装 Fuchsia，您需要构建工作站镜像（workstation_eng.x64），并在工作站上生成构建内容（包括 Fuchsia 安装程序）。

要构建安装在 NUC 迷你电脑上的 Fuchsia，请执行以下操作：

  1. 将构建配置设置为 workstation_eng.x64 恢复包（recovery-installer）：

    fx set workstation_eng.x64 --with //build/images/recovery:recovery-installer

  1. 构建 Fuchsia ：

    fx build

Fuchsia 构建可能长达 90 分钟。

3. 准备 USB 驱动器 {#prepare-usb}

您需要准备一个运行 Fuchsia 安装程序的可引导 USB 驱动器。稍后，在将 Fuchsia 安装至 NUC 迷你电脑一节，您将使用该 USB 驱动器将 NUC 迷你电脑引导至 Fuchsia 安装程序。

注意：下面的说明要求您已经在先前的构建 Fuchsia 一节完成了构建。

要准备可引导 USB 驱动器，请执行以下操作：

  1. 将 USB 驱动器插入您的工作站。

  1. 确定 USB 驱动器路径：

    fx list-usb-disks

该命令打印的输出内容形如：

$ fx list-usb-disks
/dev/sda - My Example USB Disk

  1. 创建可引导 USB 驱动器：

    fx mkinstaller -v --new-installer {{ "<var>" }}PATH_TO_USB_DRIVE{{ "</var>" }}

在上述步骤中将 PATH_TO_USB_DRIVE 替换为 USB 驱动器路径。

下面的示例命令选择了 /dev/sda 路径：

$ fx mkinstaller -v --new-installer /dev/sda

完成后，命令最终的输出结果形如：

$ fx mkinstaller -v --new-installer /dev/sda
mkinstaller: WARNING: Changing ownership of /dev/sda to alice
[sudo] password for alice:
...
mkinstaller: INFO:    Writing image fvm.sparse.blk to partition storage-sparse...
mkinstaller: INFO:      Wrote 835.6M in 35.55s, 23.5M/s
mkinstaller: INFO: Done.
mkinstaller: INFO: Ejected USB disk
  1. 从工作站上拔下 USB 驱动器。

4. 启用 NUC 迷你电脑上的 EFI 引导 {#enable-efi-booting}

请更新 NUC 迷你电脑的 BIOS 设置，以便其从 USB 驱动器启动。

要启用 NUC 迷你电脑上的 EFI（Extensible Firmware Interface，可扩展固件接口）引导，请执行以下操作：

  1. 重新启动您的 NUC 迷你电脑。

  2. 要进入 BIOS 设置，请在启动时按下 F2。

  3. 在左侧的 Boot Order（启动顺序）窗口中，点击 Legacy（旧版）选项卡。

  4. 取消勾选 Legacy Boot（旧版启动）。

  1. 点击 Advanced（高级）按钮。
  2. 确认以下引导配置：
    • 在 Boot Priority（引导优先级）选项卡下：
      • UEFI Boot（UEFI 引导）已勾选。
    • 在 Boot Configuration（引导配置）选项卡下：
      • 在 UEFI Boot（UEFI 引导）窗口中：
        • Boot USB Devices First（首先使用 USB 设备引导）已勾选。
        • Boot Network Devices Last（最后使用网络设备引导）已勾选。
        • Unlimited Network Boot Attempts（网络引导尝试不限次数）已勾选。
      • 在 Boot Devices（引导设备）窗口中：
        • USB 已勾选。
        • Network Boot（网络引导）已设置为 UEFI PXE & iSCSI。
    • 在 Secure Boot（安全引导）选项卡下：
      • Secure Boot（安全引导）已取消勾选。
  3. 要保存并退出 BIOS，请按下 F10，然后点击 Yes（是）。

5. 将 Fuchsia 安装至 NUC 迷你电脑 {#install-fuchsia}

请使用可引导 USB 驱动器将您的 NUC 迷你电脑引导到 Fuchsia 安装程序中。之后程序会将预构建的工作站镜像从您的工作站刷入 NUC 迷你电脑，以进行 Fuchsia 的首次安装。

要在您的 NUC 迷你电脑上安装 Fuchsia，请执行以下操作：

  1. 将可引导 USB 驱动器插入您的 NUC 迷你电脑中。
  1. 重新启动您的 NUC 迷你电脑。

NUC 迷你电脑引导至 Fuchsia 工作站安装程序（背景为粉红色）。

  1. 按下 Enter（回车）键选择 Install from USB（从 USB 安装）选项。
  1. 在出现其他提示时按下 Enter（回车）键继续。

安装完成后，屏幕显示 Success! Please restart your computer（成功！请重新启动您的计算机）。

  1. 从 NUC 迷你电脑设备上拔下 USB 驱动器。
  1. 重新启动 NUC 迷你电脑设备。

现在将 NUC 迷你电脑引导至 Fuchsia 工作站。

  1. 设置登录密码以启动 Fuchsia 工作站。

之后，如果您需要安装新版本的 Fuchsia（例如，在使用 fx build 重新构建新的工作站镜像后），请参见附录中将 Fuchsia 新镜像刷入 NUC 迷你电脑 一节。

重要提示：您如果打算将此 NUC 迷你电脑设备用于 Fuchsia 开发，则在通过可引导 USB 驱动器安装 Fuchsia 后，必须完成将 Fuchsia 新镜像刷入 NUC 迷你电脑一节至少一次。运行 fx flash 将向 NUC 迷你电脑设备上传[Fuchsia 特定的 SSH 键][Fuchsia-specific SSH keys]，这将启用其他有用的ffx 工作流。

附录

支持的 NUC 迷你电脑型号 {#supported-nuc-models}

为获得 GPU 支持，请使用 NUC 迷你电脑 7（Kaby Lake）、NUC 迷你电脑 8（Coffee Lake）或更新版本。

下面的列表展示了一些示例型号：

将 Fuchsia 新镜像刷入 NUC 迷你电脑 {#flash-fuchsia}

NUC 迷你电脑运行 Fuchsia 之后，您就可以使用 Fuchsia 的刷入机制（flashing mechanism）来为 NUC 迷你电脑提供 Fuchsia 新镜像了。

要将 Fuchsia 镜像刷入您的 NUC 迷你电脑，请执行以下操作：

  1. 使用以太网线缆将 NUC 迷你电脑直接连接到工作站（或将 NUC 迷你电脑连接到与工作站相同本地网络下的路由器或 WiFi 调制解调器）。

注意：网络引导仅适用于 NUC 迷你电脑的内置以太网端口——（通过以太网转 USB 适配器）使用 USB 端口进行网络引导是不支持的。

  1. 重新启动您的 NUC 迷你电脑。
  1. 要将 NUC 迷你电脑引导至 Fastboot 模式，请在 Fuchsia 引导屏幕下按 f 键。

当 NUC 迷你电脑处于 Fastboot 模式时，您可以看到屏幕上输出的 entering fastboot mode（正在进入 fastboot 模式）。

  1. 在您的工作站上，检测 NUC 迷你电脑处于 Fastboot 模式：

    ffx target list

该命令打印的输出形如：

$ ffx target list
NAME                      SERIAL       TYPE       STATE       ADDRS/IP                           RCS
fuchsia-54b2-0389-644b    <unknown>    Unknown    Fastboot    [fe81::55b1:2ff:fe34:567b%en10]    N

验证设备状态处于 Fastboot。

  1. 将 Fuchsia 新镜像刷入 NUC 迷你电脑：

注意：要构建 Fuchsia 新镜像，请参阅上述构建 Fuchsia 一节。

fx flash

完成后，NUC 迷你电脑重新启动并开始运行 Fuchsia 新镜像。

重要提示：在使用该 NUC 迷你电脑设备进行 Fuchsia 开发时，对于其他ffx工作流，您目前只能使用 USB 端口将 NUC 迷你电脑连接到您的主机。亦即，不进行步骤 1 中的线缆设置，而是使用两个以太网转 USB 适配器和一条以太网线缆，在仅使用 USB 端口的情况下，建立 NUC 迷你电脑和您的主机之间的连接。