# docs

**Repository Path**: celestia-anypi/docs

## Basic Information

- **Project Name**: docs
- **Description**: celestia/docs
- **Primary Language**: Unknown
- **License**: CC-BY-4.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Celestia

**面向 Anyka SoC 的多仓嵌入式软件栈** · Nova / Luna 产品线

上板三步 → 按角色对 AI → skill / guide 下钻。文档与代码冲突时，以代码为准  
（`tests/` › `*.c` › `*.h` › `Makefile` / `build.sh` / `config.mk` › `docs/`）。

---

## 导航

| 目标 | 入口 |
|:-----|:-----|
| 拉源码 · 编译 · 烧录 | [Quick Start](#quick-start) |
| AI 填写表 · 对话样例 | [roles.md](quick-start/roles.md) |
| 层概念 · API | [guide/](guide/api-index.md) · [architecture](architecture/overview.md) |
| 目录约定 · 边界 · 排障 | [skills/](skills/README.md) |
| BSP · 新产品 · Board | [bsp-and-products.md](quick-start/bsp-and-products.md) |

```mermaid
flowchart LR
  R[README] --> QS[Quick Start]
  R --> Roles[roles 选角色]
  Roles --> Skill[skills]
  Skill --> Guide[guide / 代码]
  QS --> Board[上板验证]
```

---

## Quick Start

| # | 步骤 | 文档 |
|:-:|:-----|:-----|
| 1 | 下载源码与 SDK | [download.md](quick-start/download.md) |
| 2 | `build.sh --product-name <product>` | [build.md](quick-start/build.md) |
| 3 | 烧录 · 串口 · PASS/FAIL | [deploy.md](quick-start/deploy.md) |

板级组装 / 新增 SoC·产品 → [bsp-and-products.md](quick-start/bsp-and-products.md)

### 按角色进入

选角色 → 贴 [roles.md](quick-start/roles.md) 填写表 → AI 读 skill 落地。

| 角色 | 要点 | 导读 |
|:-----|:-----|:-----|
| 新产品移植 | BOARD + UI 形态；无屏单应用 → services SO | [§2](quick-start/roles.md#2-新产品移植开发者) |
| 应用开发 | 仿现有 App；只走 Framework | [§3](quick-start/roles.md#3-应用开发者) |
| 新芯片移植 | HAL + board overlay；公开头不改 | [§4](quick-start/roles.md#4-新芯片移植开发者) |
| 调试维护 | 贴 log → Bug A–G → 闭环 | [§5](quick-start/roles.md#5-调试与维护) |

---

## Products

与 `project/*/config.mk` 对齐。

| 产品 | SoC / SDK | Board | 主程序 | GUI |
|:-----|:----------|:------|:-------|:----|
| **anypi_nova_lite** | AV200 / V1.04 | `PDB_MBD_AK3918AV200_ACTCAM` | `ipc_main` | `GUI_NOVA` · `launch_mode=ui` |
| **anypi_luna** | AV100_V2 / V2.04 | `PDB_MBD_KM01W_ACTCAM` | `luna_main` | `GUI_LUNA` · 小屏 |
| **anypi_nova** | AV200 / V1.04 | `EVB_MBD_AK3918AV200` | `nova_main` | `GUI_NOVA` · 大屏 |

```bash
./build.sh                              # 未指定：交互选择并缓存
./build.sh --product-name anypi_nova_lite
./build.sh --product-name anypi_luna
./build.sh --product-name anypi_nova
```

| 项 | 约定 |
|:---|:-----|
| 工具链 | AV200 → `riscv64-anyka-linux-musl-` · AV100_V2 → `arm-anycloud-linux-uclibcgnueabi-` |
| Overlay | `project/<prod>/system/<SoC>/<SDK>/board/<BOARD>/` |
| Vendor PDK | `system/<SoC>/<SDK>/`（无 `board/`） |
| 无屏单应用 | `ipc_main` + 关 GUI + `launch_mode=headless` + `services/<id>/` SO（`module_init` / `module_start` 保活）→ [roles §2](quick-start/roles.md#2-新产品移植开发者) · [application skill](skills/celestia-application.md#headless-单应用推荐方案) |
| services / 云 | `uvc` · `weather` 为 static；云实现 `aliyun` · `volc_engine` |

---

## Documentation Map

```text
docs/
├── README.md              ← 入口
├── quick-start/           download · build · deploy · bsp · roles
├── architecture/          五层总览 · 调用方向
├── guide/                 层概念 · *-api · api-index
└── skills/                AI skill 唯一源（扁平 <name>.md）
```

---

## Architecture

| 层 | Guide | API |
|:---|:------|:----|
| Overview | [overview.md](architecture/overview.md) | — |
| Application | [application.md](guide/application.md) | `app_main.h` · [api-index](guide/api-index.md) |
| Framework | [framework.md](guide/framework.md) | [framework-api](guide/framework-api.md) |
| Hardware HAL | [hardware-hal.md](guide/hardware-hal.md) | [hardware-api](guide/hardware-api.md) |
| System Core | [system-core.md](guide/system-core.md) | [system-core-api](guide/system-core-api.md) |

### 启动流 · `app_main/main.c`

```text
platform_startup
  → load app_runtime.json
  → app_main_run()                 # type=so → module_init / module_start
  → start_framework_modules
  → GUI_LUNA ? app_gui_run()
  → GUI_NOVA ? nova_run()
  → 两 GUI 皆关 → return           # 无屏须靠 module_start 阻塞保活
```

句柄：`app_main_get_multimedia` · `network` · `notification` · `nebula` · `runtime`  
→ [application guide](guide/application.md)

---

## Skills

唯一源：[skills/README.md](skills/README.md)。  
`.claude/skills/` / `.cursor/skills/` 仅放该 README 副本；内容读 `docs/skills/<name>.md`（或链到 `<name>/SKILL.md`）。

| Skill | 范围 |
|:------|:-----|
| [celestia](skills/celestia.md) | 路由 · 跨层规则 · 分层编译 |
| [celestia-application](skills/celestia-application.md) | App · cloud · headless SO |
| [celestia-framework](skills/celestia-framework.md) | 服务层 |
| [celestia-hardware](skills/celestia-hardware.md) | HAL · 新增 SoC |
| [celestia-system-core](skills/celestia-system-core.md) | system/core |
| [celestia-project](skills/celestia-project.md) | 产品 · BOARD · BSP |
| [celestia-scripts](skills/celestia-scripts.md) | build.sh |
| [celestia-third-party](skills/celestia-third-party.md) | third_party |
| [celestia-debug](skills/celestia-debug.md) | 上板 · PASS/FAIL · Bug A–G |
| [celestia-contributing](skills/celestia-contributing.md) | 规范 |
| [git-gitee](skills/git-gitee.md) | 多仓提交 · 默认 `develop` |

---

## Clone

```bash
git clone https://gitee.com/celestia-anypi/docs.git
```

[manifest](https://gitee.com/celestia-anypi/manifest) · [celestia-anypi](https://gitee.com/celestia-anypi)