# OrangePiTracker

**Repository Path**: skyink-helloworld/orange-pi-tracker

## Basic Information

- **Project Name**: OrangePiTracker
- **Description**: 基于香橙派的应用实践
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-08-14
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# Orange-Pi_Tracker_App

香橙派应用：
面向复杂环境的边缘多模态追踪系统

- 主要代码：python

---

## （一）仓库内容说明

#### `code/` 项目代码

- `frontend/` 前端交互模块
  - | `video_plyaer/` 前端工程调用的相关方法和静态资源
  - | `web_client.py`：前端服务器启动逻辑入口
  - | ==========

- `backend/` 后端功能模块
  - | `utils/` 功能逻辑中的工具类代码
  - | `model/` 模型及相关文件
  - | `app_server.py`：后端服务器启动逻辑入口
  - | `app_service_api.py`：后端服务接口
  - | `app_service_xxx.py`：后端业务逻辑（CPU版本/NPU版本）
  - | ==========

- `resource/` 资源文件（AclLite-python的函数库）

#### `requirements.txt`：本应用使用的Python依赖

#### `【昇腾-V2】作品设计文档.pdf`：作品设计文档 ver2
#### `【昇腾-V2】作品方案介绍PPT.pdf`：作品方案介绍 ver2

---

## （二）系统使用方式

1 根据环境配置的部分完成程序相关依赖的安装

2 启动Redis服务
  - 打开终端，执行指令启动redis
  ````shell
    redis-server
  ````

3 启动前端服务，默认端口号：8001
  - 进入 `code/frontend/` 目录
  - 根据需要修改 `web_client.py` 文件中 `SERVER_IP` 为实际使用的IP地址
    - 本地访问可用 `127.0.0.1`
    - 局域网访问可用实际分配的静态IP（e.g. `192.168.0.32`）
    - 公网访问可用实际IP地址
  - 运行 `web_client.py` 文件
  ```shell
    python3 {your_file_path}/orange-pi-tracker/code/frontend/web_client.py
  ```

4 启动后端服务，默认端口号 8002
  - 进入 `code/backend/` 目录
  - 修改 `app_service_xxx.py` 文件中 `PROJECT_PATH` 为本项目的实际目录地址（构建绝对路径）
  - 运行 `app_server.py` 文件
  ```shell
    python3 {your_file_path}/orange-pi-tracker/code/backend/app_server.py
  ```

---

## （三）环境配置

使用CPU版本，仅需安装本应用的依赖环境。
使用NPU版本，需要安装昇腾生态环境及本应用的依赖。

- 昇腾生态相关的软硬件环境
- 本应用的依赖环境

## 昇腾生态环境

进入`resource`目录下，根据`README.md`完成昇腾生态的软硬件换件部署。

> 官方acllite方法中，dvpp图像裁切方法存在问题，本项目已在对应接口文件中新增真正实现裁切的方法。
如使用含dvpp逻辑的服务，请使用本项目仓库中携带的acllite源码进行安装。

## 本应用的依赖环境

1 安装redis服务，用作前后端服务的数据交互中介。

安装教程可参考：https://www.runoob.com/redis/redis-install.html

- Windows下安装

  - 下载地址：https://github.com/redis-windows/redis-windows/releases
  - 选择下载`Redis-x64-3.2.100.zip`并解压
  - 打开一个cmd窗口，使用cd命令切换到 redis 目录下，运行指令 `redis-server.exe redis-windows.conf`
  - 服务启动时，不能关闭cmd窗口，需要保持redis服务器启动
  - （结束服务时）直接关闭cmd窗口即可断开Redis服务器

- Linux源码安装
  - 略

- Ubuntu apt安装

  - 执行安装指令
  ```shell
  sudo apt update
  sudo apt install redis-server
  ```
  - 启动 Redis
  ```shell
  redis-server
  ```
  - （结束服务时）关闭 Redis，需要另起一个终端
  ```shell
  redis-cli shutdown
  ```

2 安装Python依赖

```shell
  pip3 install -r requirements.txt
```