杰理 SDK 文档中心
首页
首页
  • 概述与快速开始

    • SDK 总览与芯片能力
    • 环境搭建与编译构建
    • 烧录与固件升级
    • 文档与版本资源
  • 应用与示例方案

    • demo 示例工程
    • WiFi 摄像头方案 (wifi_camera)
    • WiFi 音箱方案 (wifi_soundbox)
    • WiFi 婴儿监护方案 (wifi_bbm)
    • 公共应用模块库
    • 示例代码库 (example)
  • 系统架构与平台

    • 总体架构与工程分层
    • 系统启动与运行框架
    • 芯片驱动与板级适配
    • 设备管理与文件系统
    • 系统工具库与算法
  • 音频子系统

    • 音频框架与处理节点
    • 音频编解码与音效
    • 播放器与录音器
    • 语音交互与 AI 唤醒
    • LE Audio 与蓝牙音频
    • 音频调试与歌词
  • 视频与显示子系统

    • 摄像头驱动与 ISP
    • 视频编码与图像处理
    • 显示与 GPU 加速
    • 屏幕镜像 (screen_mirror)
  • 无线连接与网络

    • 蓝牙协议栈 (双模蓝牙)
    • WiFi 协议栈与配网
    • 网络协议栈
    • 云平台与 IoT 协议
  • UI 子系统

    • LVGL 集成与应用
    • UI 工程与工具链
  • 配置系统

    • 功能配置
    • 板级配置
    • 网络与蓝牙配置
    • 音频配置与提示音
  • 工具与测试

    • 产测与射频测试工具
    • 固件升级与更新机制
    • 调试与日志工具
  • 硬件参考设计

    • 原理图参考设计
    • 芯片数据手册

原理图参考设计

本文介绍 AC792N 系列芯片在 fw-AC792_SDK 仓库中的原理图/硬件参考设计资料:doc/硬件资料/ 目录下的硬件设计指南、屏接口与摄像头接口说明、各型号 Datasheet,以及原理图引脚定义在软件侧的对应物——板级配置(board_develop_AC79xx.h 与 板级配置.json 的 TCFG_* 宏)。

Purpose and Scope

本页面向硬件工程师与系统工程师,说明:

  • 仓库内硬件参考设计资料的存放位置、文件清单与各自用途;
  • 从芯片选型 → 参考原理图 → Layout → 板级配置 → Bring-up 的完整硬件设计链路;
  • 原理图上的引脚/外设设计如何映射到软件板级配置(TCFG_* 宏与 IO_PORTA_xx 引脚定义)。

不在本页范围:SDK 的编译与烧录流程(见 SDK 使用手册)、功能/网络/蓝牙等业务配置(见「配置体系」相关页面)、UI 工程资源。本页聚焦于硬件设计参考与原理图-软件映射,不重复展开各业务子系统的细节。

说明:doc/硬件资料/ 下的资料以 PDF 二进制格式存放,本文基于仓库文件清单、README 索引与可读取的板级配置文件整理;PDF 内文的详细电气参数(如电源树、时序、Layout 要求)请以对应 PDF 原件为准。

Overview

AC792N 是杰理科技面向 WiFi 视频类应用的 SoC 系列(包含 AC7921A / AC7922A / AC7922C 等型号),可支撑摄像头、显示、联网、音频等产品形态。原理图参考设计是硬件工程师开展产品硬件设计的起点:芯片选型决定封装、内存(DDR1/SDRAM/Flash)、摄像头路数、屏接口(MIPI/RGB)、以太网等能力,参考原理图则给出电源、时钟、复位、存储与各外设接口的典型接法。

该 SDK 仓库将硬件资料集中维护在 doc/硬件资料/ 下,同时在软件侧(sdk/apps/*/board/wl83/)提供与原理图一一对应的板级引脚配置。因此,原理图设计并非孤立的硬件工作:原理图上的每一个引脚复用决策,最终都要落到 board_develop_AC79xx.h 与工程工具管理的 板级配置.json 中,两侧必须保持一致才能完成 Bring-up。

Architecture

下图展示硬件参考设计资料的组织结构,以及硬件资料与软件板级配置之间的映射关系:

flowchart TD
    subgraph sg_HW["硬件参考设计资料 doc/硬件资料/"]
        HG["AC792N硬件设计指南 20241203"]
        LCD["AC792N系列屏接口说明 (MIPI/RGB)"]
        CAM["AC792N系列摄像头接口说明"]
        DS["datasheet/ 各型号规格书"]
    end

    subgraph sg_SW["软件板级配置 (原理图软件映射)"]
        BOARD_H["board_develop_AC79xx.h 引脚/外设定义"]
        BOARD_JSON["板级配置.json (TCFG_* 宏)"]
        SDKCFG["sdk_config.h 全局配置"]
    end

    HG --> LCD
    HG --> CAM
    HG --> DS
    LCD -->|"引脚复用约束"| BOARD_H
    CAM -->|"引脚复用约束"| BOARD_H
    BOARD_H --> BOARD_JSON
    BOARD_H --> SDKCFG

各节点职责:

节点角色说明
AC792N硬件设计指南总纲系统级硬件设计权威参考(电源、时钟、复位、接口、Layout 等)
屏接口说明外设参考MIPI/RGB 屏的接口定义、引脚分配与时序要点
摄像头接口说明外设参考摄像头(按路数/接口)的引脚分配与信号定义
datasheet/器件规格各型号的电气特性、封装、引脚功能与选型依据
board_develop_AC79xx.h软件映射按芯片型号区分的引脚映射、外设使能、时钟、内存配置
板级配置.json工具配置杰理工程工具生成的宏配置,如调试串口使能与输出 IO 选择

该结构的设计意图:将器件级规格(Datasheet)、系统级设计指导(硬件设计指南)与外设专项说明(屏/摄像头)分层存放,硬件工程师按需取用;同时通过 README 索引与软件板级配置建立"原理图 → 代码"的追溯关系,降低硬件-软件联调时的沟通成本。

硬件资料目录结构

仓库中与原理图参考设计直接相关的文件如下(来自 doc/ 目录清单):

文件类型用途
AC792N硬件设计指南20241203.pdf系统设计指南原理图设计的核心参考:电源树、时钟、复位、各外设接口推荐接法、Layout 要求
AC792N系列屏接口说明-V1.0-20240725.pdf外设接口说明MIPI/RGB 屏接口的引脚定义与设计要点
AC792N系列摄像头接口说明-V1.0-20240725.pdf外设接口说明摄像头接口的引脚定义与设计要点
AC7921A Datasheet V1.2.pdf器件规格书AC7921A 电气特性、封装、引脚功能
AC7922A Datasheet V1.5.pdf器件规格书AC7922A 电气特性、封装、引脚功能
AC7922C Datasheet V1.2.pdf器件规格书AC7922C 电气特性、封装、引脚功能

仓库根 README.md 将 doc/硬件资料/datasheet/ 归类为「各型号 datasheet + 选型表」,并提示选型依据(封装、内存、摄像头路数、屏接口、以太网)。

硬件设计指南(原理图总纲)

AC792N硬件设计指南20241203.pdf 是原理图设计阶段最先应阅读的文档,属于系统级设计指导(非单外设说明)。根据文件命名与 README 索引可确认其覆盖 AC792N 全系列的系统硬件设计,典型内容包括:

  • 电源系统:AC792N 多路电源轨的供电拓扑(DC-DC/LDO 选型、上电时序、去耦电容布局);
  • 时钟与复位:晶振/振荡器接法、复位电路与上下电时序要求;
  • 存储系统:DDR1/SDRAM 与 SPI Flash 的接法、走线约束;
  • 外设接口:屏(MIPI/RGB)、摄像头、以太网、USB、SD 卡、WiFi 天线等接口的原理图接法;
  • Layout 与 EMC:阻抗、等长、分区布线等物理设计约束。

注:该 PDF 为二进制文档,本文无法直接提取内文;具体电气参数与推荐电路请打开 AC792N硬件设计指南20241203.pdf 查阅。

参考设计系统框图

综合硬件资料的组织与 README 中关于选型依据的描述,AC792N 典型参考设计的系统组成如下:

flowchart TD
    subgraph sg_Power["电源系统"]
        PWR["DC-DC / LDO 电源树"]
        CHG["充电管理(可选)"]
    end

    subgraph sg_Core["核心系统"]
        AC79["AC792N SoC"]
        DDR["DDR1 / SDRAM"]
        FLASH["SPI Flash / eMMC"]
        CLK["晶振时钟"]
        RST["复位电路"]
    end

    subgraph sg_IO["外设接口(参考设计外设域)"]
        LCD2["MIPI/RGB 屏"]
        CAM2["摄像头(按路数)"]
        ETH["以太网(可选)"]
        USB["USB"]
        SD["SD 卡"]
        WIFI["WiFi 天线"]
        AUDIO["音频(MIC/SPK)"]
    end

    PWR --> AC79
    CHG --> PWR
    CLK --> AC79
    RST --> AC79
    DDR --> AC79
    FLASH --> AC79
    AC79 --> LCD2
    AC79 --> CAM2
    AC79 --> ETH
    AC79 --> USB
    AC79 --> SD
    AC79 --> WIFI
    AC79 --> AUDIO

设计意图:AC792N 集成度较高,多数外设(屏、摄像头、音频、网络)可直接由 SoC 引出,参考设计的核心价值在于电源树与引脚复用的正确性——这是硬件设计中最容易出错、也最影响量产良率的部分。屏与摄像头接口各有一份专项说明,正是因为这两类接口的引脚分配与信号完整性要求复杂,需要单独成文。

屏接口参考设计

AC792N系列屏接口说明-V1.0-20240725.pdf 专门规定屏接口的参考设计,覆盖:

  • 接口类型:MIPI DSI 与 RGB 并行接口两类;
  • 引脚分配:各信号(时钟、数据 lane、使能、背光、复位等)对应的 SoC 引脚与复用关系;
  • 设计要点:信号走线、阻抗匹配、背光与电源要求。

选型时屏接口是决定性因素之一——README.md 明确将「屏接口(MIPI/RGB)」列为选型依据:支持 MIPI 还是仅 RGB,直接决定可搭配的面板范围与对应原理图接法。软件侧需在板级配置中按所选屏的引脚复用关系配置对应的 IO 与显示外设。

摄像头接口参考设计

AC792N系列摄像头接口说明-V1.0-20240725.pdf 规定摄像头接口的参考设计,覆盖:

  • 摄像头路数:按芯片型号支持的单路/多路摄像头配置;
  • 接口信号:MIPI CSI / DVP 数据、时钟、复位、使能(PWDN)等;
  • 设计要点:摄像头电源、时钟源、走线与阻抗要求。

摄像头路数同样是 README 列出的核心选型依据之一:不同型号(如 AC7921A / AC7922A / AC7922C)支持的摄像头路数与接口不同,原理图设计必须与所选型号的 datasheet 交叉核对,避免引脚资源不足或复用冲突。

芯片选型与 Datasheet

doc/硬件资料/datasheet/ 目录按型号存放规格书,供原理图设计时核对电气特性与引脚功能:

  • AC7921A Datasheet V1.2.pdf
  • AC7922A Datasheet V1.5.pdf
  • AC7922C Datasheet V1.2.pdf

README 给出的选型口径(README.md):

参考 doc/硬件资料/AC792N系列芯片选型表,按封装、内存(DDR1/SDRAM/Flash)、摄像头路数、屏接口(MIPI/RGB)、以太网等需求选型。

这意味着原理图设计的第一个决策点就是型号选型,它同时约束了封装(影响 PCB 布局)、内存类型(影响 DDR/Flash 接法)、摄像头路数、屏接口与是否带以太网。选型确定后,再从 datasheet 中核对引脚功能表,最后依据硬件设计指南绘制原理图。

原理图 → 软件板级配置的映射

原理图设计完成并确定引脚分配后,必须将引脚/外设决策同步到软件板级配置中。仓库 README 明确了两处软件映射载体(README.md):

  • board_develop_AC79xx.h - 板级配置(引脚、外设等,按芯片型号区分,如 board_develop_AC7926A.h)
  • board_develop.c / sdk_config.h - 板级初始化与全局配置

同时,杰理工程工具管理的 JSON 配置(仓库根 src/ 与 cache/ 下的配置文件)也承载板级宏配置(README.md):

  • 板级配置:sdk/apps/*/board/wl83/board_develop_AC79xx.h(按芯片型号区分,含引脚映射、外设使能、时钟、内存配置)
  • 项目配置:仓库根 src/ 下的 JSON 配置(板级配置 / 功能配置 / 蓝牙配置 / 网络配置 / 音频配置 / LE_AUDIO 配置),由杰理工程工具 project.jlproj 管理

以 cache/V1.0.0/config/config/板级配置.json 为例,其中「调试串口」配置组展示了原理图 UART 引脚如何映射为软件宏(板级配置.json):

{
  "__config__": {
    "componentName": "调试串口",
    "children": [
      {
        "__config__": {
          "label": "使能调试串口",
          "tag": "el-switch",
          "defaultValue": 1,
          "dataType": ["8", "macro"],
          "saveWay": "macro",
          "uuid": "TCFG_DEBUG_UART_ENABLE",
          "originValue": 1
        }
      },
      {
        "__config__": {
          "label": "输出IO",
          "tag": "el-select",
          "dataType": ["macro"],
          "saveWay": "macro",
          "uuid": "TCFG_DEBUG_PORT",
          "defaultValue": "id_1651200760502_13",
          "originValue": "id_1651200760502_13"
        },
        "__slot__": {
          "options": [
            { "label": "IO_PORTA_00", "value": "id_1647485267192_66" },
            { "label": "IO_PORTA_01", "value": "id_1647485267192_67" },
            { "label": "IO_PORTA_02", "value": "id_1647485267192_68" },
            { "label": "IO_PORTA_03", "value": "id_1647485267192_69" },
            { "label": "IO_PORTA_04", "value": "id_1647485267192_70" },
            { "label": "IO_PORTA_05", "value": "id_1647485267192_71" },
            { "label": "IO_PORTA_06", "value": "id_1647485267192_72" },
            { "label": "IO_PORTA_07", "value": "id_1647485267192_73" },
            { "label": "IO_PORTA_08", "value": "id_1647485267192_74" }
          ]
        }
      }
    ]
  }
}

Sources:

  • 板级配置.json(原文为单行压缩 JSON,此处为结构化摘录)

这段配置的设计意图:工程工具以表单(el-switch / el-select)形式让开发者可视化地完成板级宏配置,每个控件通过 uuid 绑定一个 TCFG_* 宏(如 TCFG_DEBUG_UART_ENABLE、TCFG_DEBUG_PORT),选项值与 IO_PORTA_xx 引脚一一对应。原理图上调试串口接在哪个引脚,就应在此处选择对应的 IO——硬件与软件必须使用同一引脚定义,否则调试串口无法工作。这也解释了为何原理图参考设计与板级配置在同一个 SDK 仓库中维护。

核心设计流程

硬件工程师从原理图参考设计到量产的整体流程如下:

flowchart TD
    Start([开始]) --> Sel{"芯片选型<br/>封装/内存/摄像头/屏/以太网"}
    Sel -->|"参考选型表与 Datasheet"| Sch["参考原理图设计<br/>硬件设计指南 + 屏/摄像头接口说明"]
    Sch --> Layout["PCB Layout"]
    Layout --> BoardCfg["板级配置<br/>board_develop_AC79xx.h / 板级配置.json"]
    BoardCfg --> BringUp["硬件 Bring-up<br/>调试串口验证"]
    BringUp --> Check{"功能验证通过?"}
    Check -->|"否"| Sch
    Check -->|"引脚冲突/电气问题"| Sel
    Check -->|"是"| MassPro["量产"]
    MassPro --> End([结束])

流程要点:

  1. 选型先行:依据 README.md 给出的口径(封装、内存、摄像头路数、屏接口、以太网)确定型号,避免后续原理图返工;
  2. 参考原理图:以硬件设计指南为总纲、屏/摄像头接口说明为专项,绘制电源树、时钟复位、存储与外设电路;
  3. Layout 布线:遵循设计指南中的阻抗、等长与分区要求;
  4. 板级配置同步:将引脚决策写入 board_develop_AC79xx.h 与 板级配置.json 的 TCFG_* 宏;
  5. Bring-up 验证:通过调试串口(TCFG_DEBUG_PORT 所配 IO)验证系统启动,再逐项验证各外设;
  6. 闭环修正:功能验证失败时,可能是引脚复用冲突或电气设计问题,需回到原理图或板级配置修正。

板级配置选项(原理图相关)

下表汇总了 板级配置.json 中与原理图引脚设计直接相关的配置宏(来自 板级配置.json 可读取部分):

配置宏 (uuid)类型默认值说明
TCFG_DEBUG_UART_ENABLEmacro (int)1是否使能调试串口;原理图若未引出调试 UART,应置 0
TCFG_DEBUG_PORTmacro (枚举)IO_PORTA_* 之一调试串口输出 IO,与原理图 UART 引脚一一对应

TCFG_DEBUG_PORT 的可选值覆盖 IO_PORTA_00 ~ IO_PORTA_08(及后续更多引脚),选值必须与原理图上调试 UART 的实际接法一致。

注:板级配置.json 为工程工具生成的表单配置,除调试串口外还包含按键、LED、电源、输入等配置组;其他配置宏(如按键 IO、LED IO、电源检测脚等)同样与原理图引脚相关,但因文件为单行压缩 JSON,本次仅能确认调试串口组的完整结构。完整配置组请通过杰理工程工具 project.jlproj 打开查看。

失败模式与边界情况

基于可读取的源码与配置证据,原理图相关的主要风险点如下:

风险表现规避方式
引脚复用冲突多个外设(调试串口/屏/摄像头/按键)争用同一 IO_PORTA_xx,导致功能异常设计原理图时交叉核对 datasheet 引脚功能表与板级配置中的 IO 选择;Bring-up 时优先验证调试串口
调试串口不可用原理图未引出 UART 或引脚选择与配置不一致,TCFG_DEBUG_UART_ENABLE 仍为 1保证 TCFG_DEBUG_PORT 与原理图一致;未引出时置 0
选型不当摄像头路数/屏接口(MIPI/RGB)超出所选型号能力,原理图无法满足严格按 README 选型口径先选型再设计
电源/时序错误上电时序或去耦不满足要求,芯片启动异常或偶发复位以硬件设计指南中的电源树与时序要求为准
板级配置与原理图脱节软件侧 board_develop_AC79xx.h 与原理图引脚定义漂移硬件改动必须同步更新板级配置,保持单一事实来源

边界情况:PDF 硬件资料无法在仓库内以文本形式检索,因此本文未对电源、Layout 等 PDF 内文细节展开——这些内容必须打开对应 PDF 原件核对,切勿仅凭文件名推断电气参数。

性能与运维注意事项

  • 原理图参考设计直接影响量产良率与 EMC 认证,Layout 阶段应尽早对照硬件设计指南评审(阻抗、等长、电源分区);
  • 调试串口(TCFG_DEBUG_PORT)是 Bring-up 的第一验证手段,建议在原理图阶段预留并引出,便于产线与研发排障;
  • 仓库内的硬件资料按版本命名(如 20241203、V1.0-20240725),升级 SDK 时注意核对硬件资料版本是否与所用芯片批次匹配。

扩展点

  • 新板型适配:README 建议"复制 sdk/apps/ 下最接近的方案工程,进入其 board/wl83/ 目录,复制并修改与目标芯片型号最接近的 board_develop_AC79xx.h,调整引脚和外设配置即可"(README.md)——这是基于参考原理图衍生新硬件后,软件侧的标准适配路径;
  • 新增外设:在原理图规划阶段预留 GPIO,并在板级配置中登记对应的 TCFG_* 宏与 IO 选项,可避免后续功能开发时无引脚可用。

Related Links

  • AC792N硬件设计指南20241203.pdf —— 原理图设计的核心参考
  • AC792N系列屏接口说明-V1.0-20240725.pdf
  • AC792N系列摄像头接口说明-V1.0-20240725.pdf
  • datasheet 目录(选型表与各型号规格书)
  • 板级配置.json —— 原理图引脚的软件宏映射
  • README.md(板级配置说明与选型 Q&A)
  • 在线文档中心:doc.zh-jieli.com/AC792
Next
芯片数据手册