# Espressif

**Repository Path**: semisheet/espressif

## Basic Information

- **Project Name**: Espressif
- **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-09-30
- **Last Updated**: 2026-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Espressif Registry（semisheet.com/espressif/registry）

乐鑫科技（Espressif Systems）芯片与模组的 Zener 可复用组件注册库。
66 个组件包全部通过 `pcb fmt` + `pcb build` 验证（2026-09-30）。

## 分类结构

- `SoC/` — SoC 芯片包（15 个）：ESP32、ESP32-PICO、ESP8266EX、ESP8285、
  ESP32-C2/C3/C5/C6/C61、ESP32-S2/S3/S31、ESP32-H2、ESP32-P4/P4X
- `Memory/` — 存储芯片包（4 个）：APmemory PSRAM（APS6404L-3SQR/SQN、APS1604M）
  与乐鑫品牌 ESP-PSRAM64H；乐鑫↔APmemory 可替换型号映射见 kb.md 第 7 节
- `Module/` — 硬件模组包（47 个）：ESP32 经典 WROOM/WROVER/MINI/PICO/SOLO/DA、
  S2/S3/S31 全系、C2~C61 全系、H2、ESP8684/8685 小模组、ESP32-DU1906 语音模组等
- `kb.md` — 乐鑫知识库：产品系列、型号总表、datasheet 版本、命名规则、设计要点

每个包内含：`<NAME>.zen`（primitive Component 入口）、`<NAME>.kicad_sym`（符号，
源自 espressif/kicad-libraries 或按 datasheet 新建）、`<NAME>.kicad_mod`（封装，
对照 datasheet 尺寸章复核）、`README.md`（资产来源、证据链、已知缺口）、
空 `pcb.toml`。订货变体（-N4/-R2/-H4/-U 等）以 `Part(alternatives)` 表达。

**评估板（DevKit）不组件化**；官方评估板的 Zener 复刻见顶层 `boards/espressif/`
（独立板工程，git 版本依赖消费本仓库，供参考、不被其他项目依赖）。

## 版本与发布

全部 66 个包已打 `<包路径>/v0.1.0` tag 并推送 gitee（2026-09-30），可被
git 版本依赖消费。包内容变更时：修改 → `pcb fmt` + `pcb build` 验证 →
commit → `git tag <包路径>/v<新版本>` → push master 与 tag。

## 消费方式

```toml
# 板项目 pcb.toml
[dependencies]
"semisheet.com/espressif/registry/SoC/ESP32-C3" = "0.1.0"
```

```zen
# 板入口 .zen
ESP32C3 = Module("semisheet.com/espressif/registry/SoC/ESP32-C3/ESP32-C3.zen")
ESP32C3(name="U1", VDD=vcc, GND=gnd, ...)
```

## 本地维护文件（不入库）

以下内容仅存在于本地 checkout，**不纳入 git**：

- `datasheets/` — 官方 datasheet 全量备份（134 个文件 = 乐鑫中英 PDF 129 + APmemory PDF 3 + ESP8266 引脚表 XLS 2，2026-09-30 抓取）
- `AGENTS.md` — 维护指南：官网/CDP 接口地址、更新流程、分类与封装策略约定
- `tools/` — 官网/CDP 抓取与解析脚本（cdp-fetch-datasheets、download-datasheets、
  parse-product-pages、parse-module-variants）及目录快照 JSON

上述文件的重建方法按 `kb.md` 记录的接口与流程执行（AGENTS.md 本地有完整步骤）。