External · Integration Guide

集成指南

From Flow-Graph to Firmware · End-to-End Integration

集成指南

集成指南摘要

本页提供 Xisound 全产品线（XiStudio / XiDSP / XiAlgo / XiForge / XiTune / XiTest）的公开集成流程 —— 从下载工具、建立第一个流图、位精确仿真验证、到烧录到实机，涵盖个人开发者与Tier1 团队两种典型路径。

1. 集成总览

Xisound 集成的核心链路是：XiStudio 流图 → XiForge 编译 → XiDSP / 第三方芯片固件 → XiTune 调音。

graph LR
    Start[注册 / 下载]:::xyL4
    Flow[XiStudio 建立流图]:::xyL4
    Sim[位精确仿真]:::xyL4
    Build[XiForge 编译固件]:::xyL4
    Flash[烧录到 XiDSP]:::xyL0
    Tune[XiTune 调音]:::xyL2
    Test[XiTest 验收]:::xyL2

    Start --> Flow
    Flow --> Sim
    Sim --> Build
    Build --> Flash
    Flash --> Tune
    Tune --> Test

    classDef xyL0 fill:#0B1C2E,color:#5DDECF,stroke:#5DDECF
    classDef xyL2 fill:#0B1C2E,color:#D4A574,stroke:#D4A574
    classDef xyL4 fill:#0B1C2E,color:#D4A574,stroke:#D4A574

2. 路径 A · 个人开发者（30 分钟起步）

Step 1 · 下载 XiStudio Community

免费下载 XiStudio Community Edition（Windows / macOS / Linux） → 软件下载

Step 2 · 申请 XiDSP-D1 评估板

发送邮件至 samples@xisound.com，说明你的身份（个人 / 高校 / 独立开发者）与使用场景。

Step 3 · 跑通第一个流图

示例：正弦波 → PEQ → 输出
1. 打开 XiStudio
2. 新建项目 · 选模板 "Hello World · Sine Wave"
3. 连接 XiDSP-D1 评估板（USB）
4. 点击 "Build & Flash" · 耳机听到经过 PEQ 的 1 kHz 正弦波

第一次踩坑？

查看 FAQ 或加入社区的 #getting-started 频道。

3. 路径 B · Tier1 / 团队集成（1 周原型）

Step 1 · 商务对接 + NDA

联系商务 sales@xisound.com，索取：

XiStudio Pro / Enterprise 试用许可证
XiDSP-D2 / D3 量产样片 + 参考设计
XiAlgo 商业许可证（按项目）

Step 2 · 组建开发环境

# XiForge CLI · CI/CD 集成示例
xiforge build project.flow -target xidsp-d2 -o build/firmware.bin
xiforge verify build/firmware.bin --bit-exact

Step 3 · 团队协作（Enterprise）

Git 流图版本控制
多人实时协作
权限分级 / 审批工作流

4. 常用集成模式

模式 1 · 车载 8ch 音响功放

XiStudio PEQ + Crossover + DRC 模板 → XiForge → XiDSP-D2 → XiTune 调音 → XiTest 产线验收。

模式 2 · HiFi 一体机

XiStudio 三分频 + 房间补偿 → XiDSP-D1 → XiTune Pro 调音 → 量产。

模式 3 · 云端 FOTA 升级

XiStudio 新版本流图 → XiForge 签名固件 → 云端 FOTA 推送 → XiCore 无咔哒切换。

5. CI/CD 最佳实践

# .gitlab-ci.yml 示例
stages:
  - build
  - verify
  - release

build:
  stage: build
  script:
    - xiforge build flow/*.flow -target xidsp-d2

verify:
  stage: verify
  script:
    - xiforge verify --bit-exact --regression test/*.wav

CI/CD 支持度

XiForge CLI 支持 Linux / macOS / Windows 容器化 · 无 GUI 依赖。

6. 资源与后续步骤

主题	链接
FAQ	external/support/faq
API 快速入门	external/support/api-quickstart
工单系统	external/support/ticket-system
社区	external/support/community
公开路线图	external/support/roadmap-public
商务合作	sales@xisound.com
技术支持	support@xisound.com

7. 版本历史

版本	日期	变更摘要
v1.0	2026-05-06	首次对外发布