# open-ipc

**Repository Path**: endless22/open_ipc

## Basic Information

- **Project Name**: open-ipc
- **Description**: IPC开源方案、网络摄像头方案。
- **Primary Language**: C++
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 28
- **Forks**: 29
- **Created**: 2022-04-09
- **Last Updated**: 2025-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: IPC, 网络摄像头

## README

# open_ipc

## 1. 项目简介

open_ipc是一个功能丰富的网络摄像头开源方案，主要特点：
- 支持基于云端多模态大模型的AI语音对话和视频识别
- 提供完整基础功能：存储卡录像、RTSP流媒体、RESTful API、Web界面
- 支持两个开发平台：
  - 海思3516cv610平台（易百纳模组）
  - QEMU的aarch64平台（虚拟开发平台）

## 2. 项目文档

- [产品需求文档 (PRD)](docs/zh/PRD.md) - 详细的产品功能与需求规格
- [技术栈文档](docs/zh/TechStack.md) - 完整的技术架构与开发规范
- [用户操作指南](docs/zh/UserGuide.md) - 设备使用与操作详解
- [前端设计](docs/zh/design/web_design.md)

## 3. 技术架构

整体遵从分层设计，从底层到顶层依次为：

```
+---------------------+
|      应用层         | <- Web界面、RESTful API、ONVIF、GB28181
+---------------------+
|    基础业务层       | <- 音视频存储、设备升级
+---------------------+
|    基础软件层       | <- 开源三方库、配置管理、事件管理
+---------------------+
|    硬件抽象层       | <- 音频、视频、USB等硬件接口
+---------------------+
|      内核层         | <- Linux内核、设备驱动
+---------------------+
|      硬件层         | <- 3516cv610/aarch64平台
+---------------------+
```

在代码实现上，将不同功能抽象为组件，通过拼装和配置组件的方式定制适用于不同设备。

![](./docs/zh/figures/架构.png)

## 4. 编译说明

### 4.1 已编译好的镜像
每次发布版本都有编译完整的镜像，点击网页右侧的发行版下载，解压后说明如下
- burn目录：用海思工具Hitool烧写的镜像文件
- upgrade目录：web升级的镜像文件

### 4.2 环境要求

- Linux开发环境: Ubuntu 24
- npm（用于Web前端构建）
- 交叉编译工具链：
  - **子模块初始化**：`git submodule init; git submodule update --remote`
  - **海思3516cv610平台**：需预先安装SDK的交叉编译工具链 `arm-v01c02-linux-musleabi-gcc`
  - **aarch64平台**：使用toolchains/aarch64

### 4.3 编译步骤

```bash
# 常用命令示例
# 编译3516cv610平台release版本
./build.sh pa build release

# 3516cv610镜像打包
./build.sh pa all
```

编译完成后，输出文件位于`out`目录下。

## 5. 使用指南

### 5.1 登录访问

- 通过HTTP访问设备，格式：`http://设备IP地址`
- 默认登录凭据：
  - 用户名：`admin`
  - 密码：`admin123`

![登录界面](./docs/zh/figures/login.png)

### 5.2 界面功能

#### 5.2.1 实时预览页面

![播放界面](./docs/zh/figures/live.png)

- 基于WebRTC实现低延迟视频流播放
- 支持截图、录制、图像参数调整等功能

#### 5.2.2 配置页面

![配置界面](./docs/zh/figures/config.png)

- 视频参数配置：分辨率、码率、编码格式等
- 网络设置：有线/无线网络配置、RTSP服务等
- 系统设置：用户管理、固件升级、设备重启等

#### 5.2.3 算法分析

![算法分析](./docs/zh/figures/vehicle.png)

- 支持：人脸、人形、车辆检测
- 支持：宠物检测
- 支持：包裹检测
- 算法版本会延迟开源，有需求可以公众号联系

## 6. 开发路线图

### 6.1 已完成功能
- [x] RTSP服务支持
- [x] 本地录像存储
- [x] Web界面实时预览(WebRTC)
- [x] 阿里云同义千问VL集成，支持图片分析
- [x] 镜像文件打包与Web升级
- [x] 用户管理与网络配置
- [x] 看门狗与RTC时钟支持
- [x] 增加内存监控
- [x] 支持设备搜索
- [x] 支持脸人车检测、包裹检测、宠物检测
- [x] 语音对讲功能支持

### 6.2 近期目标（高优先级）
- [ ] GB28181协议
- [ ] ONVIF协议
- [ ] 云端APP对接方案

### 6.3 中长期计划（低优先级）

- [ ] 部标808协议
- [ ] 海思3519dv500平台支持
- [ ] 君正T32平台支持
- [ ] 安凯AK3918Av100平台支持
- [ ] 星宸SSC338平台支持

## 7. 联系方式

- 邮箱：endless@endless-sky.onaliyun.com
- 微信公众号联系![微信公众号](./docs/zh/figures/公众号.jpg)