# FFC 部署指南

> **OAK-FFC 4P 和 OAK-FFC 4P PoE 硬件更新**
> 2026年5月之后生产的设备将不包含eMMC存储。需要eMMC？请联系我们的支持团队 support@luxonis.com。

## 概述

OAK FFC 底板和摄像头模块非常适合原型设计的灵活性。由于摄像头是模块化的，您可以将它们放置在不同的立体基线上，并根据项目需求（分辨率、快门类型、帧率、光学器件）选择摄像头模块。

### OAK FFC 底板

OAK FFC 底板是带有板载VPU的OAK设备，其FFC连接器外露，您可以连接OAK
FFC摄像头模块。此外，它们还提供类似[UART](#FFC%2520%25E9%2583%25A8%25E7%25BD%25B2%25E6%258C%2587%25E5%258D%2597-Extending%2520functionality-UART)的接口，因此可以进一步扩展。

以下是我们现有的OAK FFC底板列表：

PoE 设备：

 * [OAK-FFC 4P PoE](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA)
 * [OAK-FFC 1P PoE](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA)

USB 设备：

 * [OAK-FFC 4P](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA)
 * [OAK-FFC 3P](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA)

### FFC 摄像头模块

以下是已构建的OAK FFC摄像头模块列表，您可以使用扁平柔性电缆轻松将其连接到任何OAK FFC底板。我们正在努力为所有支持的CCM提供OAK FFC摄像头模块。

| OAK FFC 摄像头模块 | 快门 | 分辨率 | 备注 |
| --- | --- | --- | --- |
| [OAK-FFC-IMX378 (AF)](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 卷帘 | 12MP |
彩色，自动对焦 |
| [OAK-FFC-IMX378-FF](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 卷帘 | 12MP |
彩色，定焦 |
| [OAK-FFC-IMX378-W](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 卷帘 | 12MP |
彩色，定焦，宽视场角 |
| [OAK-FFC-OV9282](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 全局 | 1MP | 黑白，定焦
|
| [OAK-FFC-OV9282-M12](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 全局 | 1MP |
黑白，M12接口 |
| [OAK-FFC-OV9282-W](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 全局 | 1MP |
黑白，定焦，宽视场角 |
| [OAK-FFC-OV9782-M12](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 全局 | 1MP |
彩色，M12接口 |
| [OAK-FFC-OV9782-W](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 全局 | 1MP |
彩色，定焦，宽视场角 |
| [OAK-FFC IMX582](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 卷帘 | 32MP |
彩色，自动对焦 |
| [OAK-FFC-IMX577-M12](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 卷帘 | 12MP |
彩色，M12接口 |
| [OAK-FFC-IMX214-W](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 卷帘 | 13MP |
彩色，定焦，宽视场角 |
| [OAK-FFC-AR0234-M12](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 全局 | 2.3MP |
彩色，M12接口 |
| [OAK-FFC-IMX462 (M12)](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) | 卷帘 | 2MP |
彩色，定焦 |
| [Arducam HQ Cam for RPi, IMX477](https://www.arducam.com/product/b0240-arducam-imx477-hq-quality-camera/) | 卷帘 | 12.3MP |
彩色，CS接口镜头 |

#### Raspberry Pi 摄像头模块

Raspberry Pi 销售[多种摄像头模块](https://www.raspberrypi.com/documentation/accessories/camera.html)，这些模块与OAK
FFC底板兼容。RPi摄像头可通过[RPi摄像头适配器](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA)连接到FFC底板。

| RPi 摄像头模块 | 传感器 | 快门 | 像素 | 备注 |
| --- | --- | --- | --- | --- |
| [RPi Camera Module 3](https://www.raspberrypi.com/products/camera-module-3/) | IMX708 | 卷帘 | 12 MP | 彩色，自动对焦。初始（**WIP**）集成 |
| [RPi Camera Module 2](https://www.raspberrypi.com/products/camera-module-v2/) | IMX219 | 卷帘 | 8 MP | 彩色，定焦。需要 `imx219` 分支 |
| [RPi High Quality Camera](https://www.raspberrypi.com/products/raspberry-pi-high-quality-camera/) | IMX477 | 卷帘 | 12 MP |
彩色，C/CS接口 |
| [RPi Global Shutter Camera](https://www.raspberrypi.com/products/raspberry-pi-high-quality-camera/) | IMX296 | 全局 | 1.6 MP |
彩色，C/CS接口。可能存在颜色伪影，见[解决方案](https://discuss.luxonis.com/d/2372-rpi-global-shutter-camera-imx296-module/7) |

> UC-244 适配器与 RPi HQ 和全局快门摄像头不兼容。需要额外步骤，
> [详见此处](https://discuss.luxonis.com/d/1460-rpi-high-quality-camera-with-oak-ffc-baseboard)
> 。

如果您只想使用 IMX477，我们建议使用 [Arducam HQ Cam for RPi,
IMX477](https://www.arducam.com/product/b0240-arducam-imx477-hq-quality-camera/)，它可直接与 OAK FFC 基板配合使用（无需 UC-244 适配器）。

### FFC 摄像头安装

OAK-FFC 套件是安装 OAK FFC
摄像头模块的绝佳方式。它允许您轻松自定义水平和垂直立体基线。您可以从[我们的商店](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA)购买。使用说明请参见[此处](https://github.com/luxonis/oak-hardware/blob/master/oak-ffc-kit/OAK-FFC-Kit_assembly_instruction.pdf)。

安装适配器也可见于 [Github](https://github.com/luxonis/oak-hardware/tree/master/adapters)。

### M12 安装镜头

上述部分 FFC 摄像头模块具有 M12 安装，因此您可以使用多种不同的镜头（用于自定义视场角），例如：

 * [10 种不同 M12 镜头的套件](https://www.arducam.com/product/m12-mount-camera-lens-kit-arduino-raspberry-pi/)（用于测试目的），
 * [M25156H14 (HFoV: 141°)](https://www.arducam.com/product/M25156H14/),
 * [M40180H10 (HFoV: 100°)](https://www.arducam.com/product/M40180H10/),
 * [M2506ZH04 (HFoV: 33°)](https://www.arducam.com/product/M2506ZH04/),
 * 以及[其他](https://www.arducam.com/product-category/lenses/m12-lens-arducam/)。

### M12 可选择的视场角

测试使用了 2 个 [OAK-FFC-IMX477-M12](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) 和两种不同的
M12 镜头：[20°
视场角](https://www.arducam.com/product/arducam-telephoto-20-degree-1-2-3-m12-mount-with-lens-adapter-for-raspberry-pi-high-quality-camera/)
和 [190° 视场角](https://www.arducam.com/product/arducam-190-degrees-lens-for-hq-camera-ln074/)。

在 OAK-FFC-IMX477-M12 上窄视场角和宽视场角 M12 镜头的并排比较：

俯视图测试设置：

## 使用 OAK FFC 进行开发

### 安装要求

根据您使用的 FFC 设备，请参考以下快速入门指南：

 * [USB 部署指南](https://docs.luxonis.com/hardware/platform/deploy/usb-deployment-guide.md)
 * [PoE 部署指南](https://docs.luxonis.com/hardware/platform/deploy/poe-deployment-guide.md)

安装依赖项和 depthai 库后，您就可以开始使用 OAK FFC 设备进行开发了。

### 测试配置

将摄像头连接到基板后，您可以使用 [utilities/cam_test.py](https://github.com/luxonis/depthai-python/blob/main/utilities/cam_test.py)
脚本快速测试摄像头是否正常工作。默认情况下，它会尝试在 2 通道 MIPI 端口 B（左）和 C（右）上运行 2 个单目摄像头，并在端口 A（RGB）和 D（4 通道 MIPI 端口）上运行 2 个彩色摄像头。

如果您连接了不同的摄像头，可以通过 --cameras 参数指定要使用的摄像头类型：

```bash
cam_test.py [-h] [--cameras <BoardSocket>,<CameraType>]
```

例如，如果您在端口 A、B 和 C 上连接了 3 个单目摄像头，可以运行以下命令：

```bash
python3 cam_test.py --cameras rgb,m right,m left,m
```

### 在代码中使用摄像头

类似地，要将此类配置添加到脚本中，可以使用以下代码：

#### Python

```python
cam_a = pipeline.create(dai.node.Camera)
cam_a.build(dai.CameraBoardSocket.CAM_A) # 等同于 CameraBoardSocket.RGB

cam_b = pipeline.create(dai.node.Camera)
cam_b.build(dai.CameraBoardSocket.CAM_B) # 等同于 CameraBoardSocket.LEFT

cam_c = pipeline.create(dai.node.Camera)
cam_c.build(dai.CameraBoardSocket.CAM_C) # 等同于 CameraBoardSocket.RIGHT

cam_d = pipeline.create(dai.node.Camera)
cam_d.build(dai.CameraBoardSocket.CAM_D)
```

#### C++

```cpp
auto cam_a = pipeline.create<dai::node::MonoCamera>();
cam_a->setBoardSocket(dai::CameraBoardSocket::CAM_A); // 等同于 CameraBoardSocket::RGB
cam_a->setResolution(dai::MonoCameraProperties::SensorResolution::THE_400_P);

auto cam_b = pipeline.create<dai::node::MonoCamera>();
cam_b->setBoardSocket(dai::CameraBoardSocket::CAM_B); // 等同于 CameraBoardSocket::LEFT

auto cam_c = pipeline.create<dai::node::MonoCamera>();
cam_c->setBoardSocket(dai::CameraBoardSocket::CAM_C); // 等同于 CameraBoardSocket::RIGHT

auto cam_d = pipeline.create<dai::node::MonoCamera>();
cam_d->setBoardSocket(dai::CameraBoardSocket::CAM_D);
```

## Extending functionality

### PSRBS Connector

The OAK-FFC-4P has a PSRBS connector, which allows users to easily connect the OAK camera to the external logic. You can use
[PSRBS cable](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) to connect to this
connector.

| Pin | Name | Description |
| --- | --- | --- |
| 1 | VDD_5V | 5V power input/output |
| 2 | STROBE | Strobe signal output, can drive external lighting (projector, illumination lights, etc.) |
| 3 | MODULE_nRST | Allows resetting the OAK-FFC from an external source (GND will reset the
[RVC2](https://docs.luxonis.com/hardware/platform/rvc/rvc2.md), same as RST button) |
| 4 | BOOT_SEL | Allows selecting whether to boot into the
[bootloader](https://docs.luxonis.com/software-v3/depthai/depthai-components/bootloader.md) (1.8V will skip bootloader, same as
BOOT button) |
| 5 | COM_AUX_IO2 | 2-lane MIPI FSYNC signal input/output |
| 6 | FSIN_4LANE | 4-lane MIPI FSYNC signal input/output |
| 7 | GND | GND power input/output |

### Connecting an IR Module

If you have an [OAK-FFC-4P](https://docs.luxonis.com/hardware/products/OAK-FFC%25204P.md) R5 or newer and you wish to use the
[OAK-FFC-IR](https://shop71313603.taobao.com/?spm=pc_detail.30350276.shop_block.dshopinfo.27a17dd635FNDA) module, you must first
configure which camera will drive the STROBE signal to the connector to which you connect your IR module. The connector is located
to the left of the switch (J12, see the image below).

If you have a stereo pair on CAM_B and CAM_C and want to have a dot projector synced with the stereo pair, you should move the
switch 2 or 3 up (ON). Keep in mind that only one switch can be up at a time.

### UART

Some OAK FFC devices have UART exposed, so you can use it for communication with other devices. For example, you can connect a GPS
module to the UART port and get the GPS data in your application.

To use UART in your application, checkout the [UART Example](https://docs.luxonis.com/software/depthai/examples/script_uart.md).

#### UART Pinout

Pinout depends on the board you are using. Here are the UART pinouts for the OAK-FFC devices:

| OAK-FFC Device | TX | RX |
| --- | --- | --- |
| OAK-FFC-4P | 15 | 16 |
| OAK-FFC-4P POE | / | / |
| OAK-FFC-1P POE | 45 | 46 |
| OAK-FFC-3P | / | / |

### SD Card support

SD card functionality is community support only and should still work on separate [depthai
branch](https://github.com/luxonis/depthai-python/tree/sdcard_no_eth_updated) but won't be updated frequently.

You can use the SD card to store data (logs/images/configs) from the running device - see
[example](https://github.com/luxonis/depthai-python/blob/sdcard_no_eth_updated/examples/Script/script_jpeg_to_sdcard.py).

### 需要帮助？

请前往 [OAKChina 官网](https://www.oakchina.cn/) 获取技术支持或解答您的任何疑问。
