# camera_pipeline

**Repository Path**: posty_banana/camera_pipeline

## Basic Information

- **Project Name**: camera_pipeline
- **Description**: camera_pipeline子仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Camera Pipeline

面向嵌入式 Linux 的可复用 Camera Pipeline 核心框架。生产代码使用 C11，平台能力通过项目自有 Contract 与
Adapter 隔离；当前首个闭环在 x86 Ubuntu 上使用 Mock Source 运行 Host SIL/HWM。

## 当前能力

- 稳定 C ABI 的 Source、Frame Lease、Format 和 Result 合同。
- 独立 Common 静态库、固定宽度类型、Common Result 和可替换日志 Sink。
- Pipeline Create、Start、Acquire、Stop、Destroy 生命周期。
- Node/Link Capability、DAG 拓扑、Ownership 和最坏缓冲预算预校验。
- Start 进入 Running 前执行有限超时的首帧 Readiness 验证。
- Pipeline Health Snapshot、首帧状态、观测帧计数和最后错误。
- 确定性 GRAY8 Mock Source。
- 单 Outstanding Lease 所有权约束和有界停止行为。
- GoogleTest Host SIL，默认启用 ASan、LSan 和 UBSan。
- 固定版本与校验和的 GoogleTest 依赖。

## 构建与验证

```bash
cmake --preset host-debug
cmake --build --preset host-debug
ctest --preset host-debug
./build-output/host-debug-make/post_camera_host_sil
```

首次配置会下载并校验 GoogleTest v1.18.0。后续离线构建可复用 CMake 已准备的依赖目录。

## 架构边界

```text
products / examples
        |
domain/media_graph
        |
contracts
        ^
        |
adapters/media/mock
```

Domain 只依赖项目自有 Contract。Adapter 实现 Contract，Composition Root 选择具体实现。Linux UAPI、V4L2 和
未来 Vendor SDK 类型不得进入公共 Contract 或 Domain。

## 验证边界

当前测试属于 Host SIL/HWM，能够验证公共 API、状态机、错误路径、资源生命周期和内存安全；不能证明真实
DMA/Cache、ISP、驱动时序、实时性、电气特性和目标板性能。相关结论需要后续 V4L2 实机与 SoC HIL 补充。

完整方向与路线见 [`docs/develop_md/PROJECT_VISION.md`](docs/develop_md/PROJECT_VISION.md) 和
[`docs/develop_md/TODO.md`](docs/develop_md/TODO.md)。