# HW-AGENT-V821

**Repository Path**: aiwebops_admin/hw-agent-v821

## Basic Information

- **Project Name**: HW-AGENT-V821
- **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-05-22
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hw-agent-v821

全志 V821 (AvaotaF1) 嵌入式开发板的项目仓库。覆盖设备体检诊断、SDK 编译管理、板级初始化、问题分析与追踪。

## 硬件平台

| 项目 | 规格 |
|------|------|
| SoC | Allwinner V821B (Andes A27L2, RISC-V 32-bit, rv32imafdc) |
| 内存 | 64MB DDR2 (Linux 可用 ~40MB) |
| 存储 | 32MB SPI NOR Flash (Puya PY25Q256HA) |
| WiFi | SIP XRADIO 2.4GHz (via E907 协处理器) |
| 摄像头 | MIPI CSI GC2083 (2MP) |
| 系统 | Tina Linux 5.0 (OpenWrt-based, kernel 5.4.220) |

## 项目结构

```
hw-agent-v821/
├── scripts/              # ★ 可执行脚本
│   ├── health_check.sh    #   设备全面体检 (20 大项)
│   ├── run_health_check.sh#   远程体检启动器 (adb/ssh)
│   ├── sdk-sync.sh        #   Tina SDK 版本联动
│   ├── init.sh            #   设备初始化 (WiFi + SSH)
│   ├── test_firmware.sh   #   固件烧录验证
│   ├── avota_f1_quick_test.sh  # SDK 编译环境检查
│   └── avota_f1_build.sh  #   SDK 一键编译
│
├── docs/                 # 文档 (按主题)
│   ├── hardware/         #   硬件规格、芯片资源
│   ├── sdk/              #   Tina SDK 指南 (01-08)
│   ├── guides/           #   操作指南
│   ├── analysis/         #   分析报告
│   └── CHANGELOG.md      #   变更日志
│
├── logs/                 # 精选日志 (git 追踪)
│   ├── device/           #   设备端 (体检报告)
│   └── build/            #   编译
│
├── archive/              # 历史归档
├── SDK_VERSION           # Tina SDK 版本关联
├── README.md
└── .gitignore
```

## 快速开始

### 1. 连接设备

```bash
# ADB (USB)
adb shell

# SSH (需先连 WiFi)
ssh root@192.168.100.38
```

### 2. 设备体检

```bash
# 远程一键 (ADB)
cd scripts && ./run_health_check.sh adb

# 手动执行
adb push scripts/health_check.sh /tmp/ && adb shell "sh /tmp/health_check.sh"
```

### 3. SDK 编译

```bash
cd scripts && ./avaota_f1_quick_test.sh && ./avaota_f1_build.sh
```

## Tina SDK 版本联动

Tina SDK 在本地使用 git 管理变更，`SDK_VERSION` 记录当前项目关联的 SDK commit。

```bash
# 查看 SDK 与项目版本一致性
./scripts/sdk-sync.sh check

# 保存 SDK 变更 → 关联到项目
./scripts/sdk-sync.sh save "描述这次改动"

# 回滚 SDK 到项目记录的版本
./scripts/sdk-sync.sh restore
```

**典型工作流:**

```bash
# 1. 修改 SDK 配置 → 编译 → 烧录验证
cd /home/ubuntu/workspace/tina-v821-v1.3
# ... 修改板级配置、menuconfig ...
./build.sh && ./build.sh pack

# 2. 提交 SDK 变更 + 联动项目
cd /home/ubuntu/workspace/hw-agent-v821
./scripts/sdk-sync.sh save "启用 openssl / 修复 WDT 配置"

# 3. SDK_VERSION 自动更新并 commit 到项目

# 4. 项目回滚时，SDK 同步回滚
cd /home/ubuntu/workspace/hw-agent-v821
git checkout <历史commit>
./scripts/sdk-sync.sh restore    # SDK 回滚到对应版本
```

> SDK 的 git 仓库仅在本地维护，不推送到 gitee。

## 设备当前状态

| 指标 | 数值 |
|------|------|
| 体检通过率 | 41/41 (100%) |
| 严重故障 | 0 |
| 已知问题 | MIPI CSI 时钟缺失 (摄像头不可用) |
| 设备 IP | 192.168.100.38 |

## 项目维护

### 新增文件规范

| 目录 | 放入条件 | 命名格式 |
|------|----------|----------|
| `scripts/` | 当前使用的可执行脚本 | `snake_case.sh` |
| `docs/hardware/` | 芯片 datasheet、引脚表 | 中文: `V821-xxx.md` |
| `docs/analysis/` | 问题分析、体检报告 | `问题名.md` 或 `体检分析-YYYY-MM-DD.md` |
| `logs/device/` | 代表性设备日志 | `类型-YYYY-MM-DD.txt` |
| `archive/` | 已不再活跃使用但有参考价值 | 保留原名, 放入子目录 |

### 维护操作

```bash
# 每次设备上电后
adb push scripts/init.sh /tmp/ && adb shell "sh /tmp/init.sh"

# 每次固件更新后
adb push scripts/health_check.sh /tmp/ && adb shell "sh /tmp/health_check.sh"

# 保存体检结果
adb pull /tmp/health_report_*.txt logs/device/health-check/

# 提交变更
git add -A && git commit -m "描述变更内容"
git push origin master
```

### 开发工作流

1. **修改固件** → 修改 SDK 代码 → `sdk-sync.sh save "..."` → 编译 → 烧录 → `test_firmware.sh` 验证
2. **系统调测** → `health_check.sh` 体检 → 分析 → 写入 `docs/analysis/`
3. **版本回退** → `git checkout <commit>` → `sdk-sync.sh restore`
4. **日常维护** → `git pull` → 操作 → `sdk-sync.sh check` → `git add` → `git commit` → `git push`

### Git 提交规范

```
feat: 新功能/脚本
fix: 修复 bug  
docs: 文档更新
refactor: 重构
chore: 清理/维护
```

## Git 远程

```
https://gitee.com/aiwebops_admin/hw-agent-v821.git
```