# kinara_setup

**Repository Path**: joy_ai/kinara_setup

## Basic Information

- **Project Name**: kinara_setup
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kinara Ara2 r1.3 环境与开机自启

本仓库提供 Kinara Ara2 **r1.3** 的脚本与 systemd 服务，用于 uiodma 驱动加载、硬件 bringup、proxy 启动及日常运维（烧录、推理、芯片信息、日志查看等）。与原有 **r1.1.1** 的 `rt-sdk-ara2` 互斥使用，只启用其一。

## 目录结构

```
kinara_setup/
├── README.md
├── scripts/                          # 所有 r1.3 脚本
│   ├── rt-sdk-ara2-r1.3_script.sh   # 主启动脚本（uiodma + hw_bringup + proxy）
│   ├── uiodma_pcie_r1.3.sh          # 加载 uiodma 并绑定 PCI 设备 1e58
│   ├── hw_bringup_r1.3.sh           # 硬件上电、DDR 配置、启动 proxy
│   ├── launch_proxy_r1.3.sh         # 单独启动 proxy
│   ├── program_flash_r1.3.sh        # 烧录固件
│   ├── chip_info_r1.3.sh            # 查看 Ara2 芯片信息
│   ├── run_inference_r1.3.sh        # 使用 nnapp 运行推理（resnet50 / yolov8n / io_speed_test）
│   ├── ara2_metrics_r1.3.sh         # 硬件 metrics 工具（需 hw_metrics_*.out）
│   └── logs_r1.3.sh                 # 实时查看 rt-sdk-ara2-r1.3 的 systemd 日志
└── service/
    └── rt-sdk-ara2-r1.3.service     # 开机自启 unit
```

## 依赖

- **rt_sdk_r1.3**：默认根目录为 `/root/kinara/rt_sdk_r1.3`（可通过环境变量 `ART_DIR` 覆盖）。脚本会使用其中的 `art/linux/drivers/uiodma_cache_management`、`art/linux/*/hw_utils`、`art/linux/config/`、`art/linux/*/nnapp` 等。
- **Weston**：自启服务依赖 `weston.service`，在图形会话之后执行。
- **PCI 设备**：Ara2 板卡需能被识别为 PCI ID `1e58`（脚本会绑定到 uiodma 驱动）。

## 安装与启用

### 1. 复制脚本到系统路径

将本仓库 `scripts/` 下所有脚本复制到 `/usr/bin/kinara/scripts/`（若目录不存在需先创建）：

```bash
sudo mkdir -p /usr/bin/kinara/scripts
sudo cp -r /path/to/kinara_setup/scripts/* /usr/bin/kinara/scripts/
```

### 2. 安装并启用开机自启服务

```bash
sudo cp /path/to/kinara_setup/service/rt-sdk-ara2-r1.3.service /etc/systemd/system/
sudo systemctl daemon-reload
# 启用 r1.3 自启（与 r1.1.1 互斥，二选一）
sudo systemctl enable rt-sdk-ara2-r1.3.service
# 若之前启用了 r1.1.1，请先禁用：
# sudo systemctl disable rt-sdk-ara2.service
```

### 3. 重启或立即测试

- 重启后会自动执行 uiodma 加载、hw_bringup 与 proxy 启动。
- 不重启也可立即测试：`sudo systemctl start rt-sdk-ara2-r1.3.service`

## 脚本说明

| 脚本 | 说明 |
|------|------|
| `rt-sdk-ara2-r1.3_script.sh` | 主流程：先执行 `uiodma_pcie_r1.3.sh`，再执行 `hw_bringup_r1.3.sh`（chip_info → active_enable → DDR → chip_info → 启动 proxy）。由 systemd 在开机时调用。 |
| `uiodma_pcie_r1.3.sh` | 加载 uiodma 内核模块并绑定 PCI 设备 1e58，依赖 `ART_DIR`。 |
| `hw_bringup_r1.3.sh` | 硬件上电与 DDR 配置，并启动 proxy，依赖 `ART_DIR`、可选 `MAIN_LOG`。 |
| `launch_proxy_r1.3.sh` | 单独启动 proxy（使用 rt_sdk_r1.3 的 proxy_config.yaml）。 |
| `program_flash_r1.3.sh` | 烧录 Ara2 固件，日志写入 `ART_DIR/saved_logs/`。 |
| `chip_info_r1.3.sh` | 仅运行 chip_info 查看 Ara2 芯片信息。 |
| `run_inference_r1.3.sh` | 使用 nnapp 跑推理，支持 resnet50、yolov8n、io_speed_test，可通过 `MODEL_DIR` 等覆盖路径。 |
| `ara2_metrics_r1.3.sh` | 运行 hw_metrics 二进制；需在 `/usr/bin/kinara/ara2_metrics_bin/` 下放置 `hw_metrics_x86_64.out` 或 `hw_metrics_aarch64.out`（可从 deb 或 r1.1.1 部署目录拷贝）。 |
| `logs_r1.3.sh` | 在 xterm 全屏中实时查看 `journalctl -u rt-sdk-ara2-r1.3 -f`。 |

## 环境变量

- **ART_DIR**：rt_sdk_r1.3 根目录，默认 `/root/kinara/rt_sdk_r1.3`。所有依赖 SDK 路径的脚本都会读取该变量。
- **MAIN_LOG**：主脚本传入的日志文件路径，供 `hw_bringup_r1.3.sh` 等追加日志。
- **UIODMA_LOG_FILE**：uiodma 步骤的日志文件（主脚本会设置）。
- **MODEL_DIR**：`run_inference_r1.3.sh` 的模型根目录，默认 `/usr/share/cnn`。

## 日志位置

- 主流程与各子步骤日志目录：`$ART_DIR/saved_logs/`（如 `/root/kinara/rt_sdk_r1.3/saved_logs/`）。
- 服务输出：`journalctl -u rt-sdk-ara2-r1.3` 或通过 `logs_r1.3.sh` 实时查看。

## 与 r1.1.1 的互斥

- 本套为 **r1.3** 专用；与原有 **r1.1.1** 的 `rt-sdk-ara2.service` 不要同时启用，否则会重复加载驱动、重复 bringup。
- 使用 r1.3 时：`enable rt-sdk-ara2-r1.3.service`，并 `disable rt-sdk-ara2.service`。
- 使用 r1.1.1 时：`disable rt-sdk-ara2-r1.3.service`，并 `enable rt-sdk-ara2.service`。