# OAK4 离线和生产设置

当 OAK4 没有直接互联网访问 且您需要可重复的离线或生产线工作流程时，请使用本指南。

开始之前：

 * 在主机 PC 上安装 [`oakctl`](/software-v3/oak-apps/oakctl.md)。
 * 确保您的设备已安装 Luxonis OS 版本 1.37.0 或更高版本。如果您的设备是旧版本，请按照 [本指南](/software-v3/sw-stack/luxonis-os.md) 进行更新。

## 为相机供电

| 供电方式 | 连接 |
| --- | --- |
| USB 同时用于供电和数据。相机启动至少需要 15W，建议使用 30W 以获得全功率。请使用 PD 额定 USB-C 连接；USB-A 在此设置中不起作用。 |  |
| PoE+ 用于供电，USB 仅用于数据。在此设置中，USB-C 和 USB-A 都适用。 |  |

更多信息，请参阅 [为相机供电](/hardware/platform/deploy/oak4-deployment-guide/oak4-getting-started.md)。

## 操作系统更新

首先从 [Luxonis OS](/software-v3/sw-stack/luxonis-os.md) 下载 OTA 文件到主机。如果主机上已存在固定的目标版本，则可以使用该文件进行操作系统更新。

将 OTA 文件复制到设备上，然后在设备上运行更新：

```bash
oakctl adb root
oakctl adb push ./full_update_luxonis_ext4-<version>.zip /data/
oakctl adb shell
agentconfd update /data/full_update_luxonis_ext4-<version>.zip
# 然后通过重新连接电源重启相机
```

有关更多兼容性说明，请参阅 [Luxonis OS](/software-v3/sw-stack/luxonis-os.md)。

## 网络设置

选择您希望如何准备设置命令，该命令将设置密码、SSH 状态和 IP 配置。

#### Build the command manually

如果您想自己组装设置命令，而不是在浏览器中生成它，请使用此路径。按照
[本地设置](/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md) 中的说明将设备置于设置模式。

```bash
oakctl start-setup
```

然后在主机 PC 上运行 `oakctl device setup apply` 并带上您需要的标志。

启用 SSH 并保持 DHCP：

```bash
oakctl device setup apply -p <password> --dont-check-internet
```

启用 SSH 并设置静态 IP：

```bash
oakctl device setup apply -p <password> \
  --static-ip 192.168.10.101,255.255.255.0,192.168.10.1 \
  --dont-check-internet
```

禁用 SSH 并设置静态 IP：

```bash
oakctl device setup apply -p <password> \
  --no-ssh \
  --static-ip 192.168.10.101,255.255.255.0,192.168.10.1 \
  --dont-check-internet
```

如果您需要覆盖 DNS，请添加 `--dns 10.12.102.2`。如果有多个设备可用，请添加 `-d <serial-or-ip>` 以定位正确的单元。如果每个设备需要唯一的静态 IP，则只需在运行之间调整 `--static-ip` 值。

#### Generate command in web GUI

如果您希望生成一个包含新密码、启用或禁用 SSH 以及 IP 设置的命令，请使用此路径：

 1. 使用 `oakctl start-setup` 将设备置于设置模式。
 2. 打开 [setup.luxonis.com](https://setup.luxonis.com)。
 3. 打开 `Advanced setup using CLI`。
 4. 填写您想要的值： * 新密码
     * 启用或禁用 SSH
     * DHCP 或静态 IP 设置
 5. 复制生成的终端命令。
 6. 在设备仍处于设置模式时，在主机 PC 上运行生成的终端命令。

这是在多个设备之间保持设置值一致的最简单方法。如果每个设备需要唯一的静态 IP，请为每个单元重新生成命令，或仅在运行之间调整与 IP 相关的值。

有关完整的本地设置演练、其他命令行选项、后续更改网络以及 SSH 或 ADB 访问详细信息，请参阅 [OAK4
高级设置](/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md)。

## 应用程序更新/安装

提前准备好构建的 `*.oakapp` 包（如果需要构建您的应用程序，请遵循 [oakctl 应用程序构建指南](/software-v3/oak-apps/oakctl.md)）。然后将包复制到配置 PC
并本地安装：

```bash
oakctl app install ./dist/my-app.oakapp
```

如果已安装具有相同标识符的应用程序，`oakctl app install` 默认会更新它。 默认情况下，新安装的应用程序是启用并运行的，因此当相机启动时它会自动启动。如果您不希望这种行为，请使用 `--enable=false`。

## 适用于多个设备的生产工作流程

为了在多个设备上进行可重复的部署，请准备一套经过批准的工件，并在每个单元上线之前对其应用相同的流程：

 * 一个目标 OS OTA 文件，例如 `full_update_luxonis_ext4-<version>.zip`
 * 一个经过批准的应用程序包，例如 `my-app.oakapp`
 * 您希望在每个设备上使用的密码或本地设置值
 * 网络计划：DHCP 或每个设备唯一的静态 IP

当同时连接多个设备时，通过 ADB 在 USB 连接的单元上执行 OS 更新，然后对后续的 `oakctl` 命令（例如应用程序安装）使用 `-d`：

```bash
oakctl app install -d <serial-or-ip> ./dist/my-app.oakapp
```

一个实用的每设备流程是：

 * 为设备供电并使用 `oakctl list` 发现它
 * 如果需要，使用 [setup.luxonis.com](https://setup.luxonis.com) 生成本地设置命令，以一致地设置密码、SSH 模式和 IP 设置
 * 通过 ADB 将设备更新到批准的 OS 版本
 * 安装预构建的 `*.oakapp` 包
 * 应用预期的网络配置
 * 在部署前验证预期的 OS 版本、应用程序和 IP 地址

### 需要帮助？

请访问[讨论论坛](https://discuss.luxonis.com/)以获取技术支持或您可能有的任何其他问题。
