chip-specs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ChipCtx MCU Specs

ChipCtx MCU芯片规格查询

Authoritative MCU chip specification queries for embedded development. Real-time access to chip parameters, pin definitions, TRM registers, and programming guides via the ChipCtx MCP Server.

面向嵌入式开发的权威MCU芯片规格查询服务。通过ChipCtx MCP Server实时获取芯片参数、引脚定义、TRM寄存器及编程指南。

When to Apply

适用场景

Activate this Skill when ANY of the following conditions are detected:

1. Explicit — User mentions chip model

Specific model: STM32F407VGT6, ESP32-S3-WROOM-1, nRF52840
Series reference: "STM32F4 series", "ESP32", "nRF52"
Chip search or comparison: "which chip has BLE and 1MB flash?"

2. Code Context — Chip-specific headers or APIs

Headers:
```
stm32f4xx.h
```
,
```
esp_system.h
```
,
```
nrf.h
```
,
```
nrf52840.h
```

HAL/SDK calls:

HAL_GPIO_Init()

esp_wifi_init()

nrf_gpio_cfg_output()

Chip-specific register or memory address references

3. Project Configuration — Build system files

STM32CubeMX
```
.ioc
```
files
```
platformio.ini
```
with
```
board = ...
```
```
Makefile
```
/
```
CMakeLists.txt
```
with MCU definitions (
```
-DSTM32F407xx
```
)
ESP-IDF
```
sdkconfig
```
, Zephyr
```
prj.conf
```

4. Topic-Related — Hardware discussion

Pin assignments, peripheral configuration, register operations
GPIO, UART, SPI, I2C, ADC, DMA, Timer topics
Datasheet, TRM, or hardware design references

当检测到以下任意一种情况时，激活该Skill：

1. 明确提及芯片型号

具体型号：STM32F407VGT6、ESP32-S3-WROOM-1、nRF52840
系列参考："STM32F4系列"、"ESP32"、"nRF52"
芯片搜索或对比："哪款芯片支持BLE且拥有1MB闪存？"

2. 代码上下文包含芯片专属头文件或API

头文件：
```
stm32f4xx.h
```
、
```
esp_system.h
```
、
```
nrf.h
```
、
```
nrf52840.h
```

HAL/SDK调用：

HAL_GPIO_Init()

、

esp_wifi_init()

、

nrf_gpio_cfg_output()

芯片专属寄存器或内存地址引用

3. 项目配置文件

STM32CubeMX
```
.ioc
```
文件
包含
```
board = ...
```
的
```
platformio.ini
```
带有MCU定义（
```
-DSTM32F407xx
```
）的
```
Makefile
```
/
```
CMakeLists.txt
```
ESP-IDF
```
sdkconfig
```
、Zephyr
```
prj.conf
```

4. 硬件相关讨论

引脚分配、外设配置、寄存器操作
GPIO、UART、SPI、I2C、ADC、DMA、定时器相关话题
数据手册、TRM或硬件设计参考

MCP Interface Quick Reference

MCP接口快速参考

MCP Server Endpoint:

https://mcp.chipctx.com

(Streamable HTTP)

User Intent	MCP Tool	Input	Output
Find/identify chip model	`chip_identify`	query (string)	Chip list with id, model, vendor, series, matchScore
Chip parameters & specs	`chip_specs`	chipId, category?	Core params, electrical specs, peripheral list
Pin definitions & package	`chip_hardware`	chipId, query?	Pin table with AF mapping, package info
TRM registers & modules	`chip_trm`	chipId, section?	TRM sections, register/field definitions
Programming guide & code	`chip_programming_guide`	chipId, topic	Init steps, code examples, pitfalls

Key Principle:

chipId

bridges all queries. Always call

chip_identify

first to obtain

chipId

, then use it in all subsequent tool calls.

MCP服务器端点：

https://mcp.chipctx.com

（支持流式HTTP）

用户意图	MCP工具	输入	输出
查找/识别芯片型号	`chip_identify`	query（字符串）	包含id、型号、厂商、系列、匹配分数的芯片列表
芯片参数与规格	`chip_specs`	chipId, category?	核心参数、电气规格、外设列表
引脚定义与封装	`chip_hardware`	chipId, query?	带有复用功能映射、封装信息的引脚表
TRM寄存器与模块	`chip_trm`	chipId, section?	TRM章节、寄存器/位域定义
编程指南与代码	`chip_programming_guide`	chipId, topic	初始化步骤、代码示例、注意事项

核心原则：

chipId

是所有查询的桥梁。必须先调用

chip_identify

获取

chipId

，再在后续所有工具调用中使用它。

Intent Routing Matrix

意图路由矩阵

Keywords in User Query	Tool to Call	Priority
Model, series, find, compare, identify	`chip_identify`	Always call first
Parameters, specs, frequency, flash, RAM, features	`chip_specs`	Basic info
Pin, GPIO, package, pinout, AF	`chip_hardware`	Hardware design
Register, TRM, module, address, bit field	`chip_trm`	Deep technical
Code, init, configure, program, example, HAL	`chip_programming_guide`	Programming

用户查询中的关键词	调用工具	优先级
型号、系列、查找、对比、识别	`chip_identify`	始终优先调用
参数、规格、主频、闪存、RAM、特性	`chip_specs`	基础信息
引脚、GPIO、封装、引脚分布、复用功能	`chip_hardware`	硬件设计
寄存器、TRM、模块、地址、位域	`chip_trm`	深度技术
代码、初始化、配置、编程、示例、HAL	`chip_programming_guide`	编程实现

Standard Query Flow

标准查询流程

Every chip-related query follows this 5-step flow:

Step 1: Extract chip model keywords from user input or project context
Step 2: chip_identify(query) -> validate model, get chipId
Step 3: Check matchScore -> confirm unique match or ask user to select
Step 4: Route to appropriate tool based on user intent
Step 5: Format and present results, generate code if requested

Important: Never skip Step 2. All other tools require

chipId

from

chip_identify

所有芯片相关查询遵循以下5步流程：

Step 1: 从用户输入或项目上下文中提取芯片型号关键词
Step 2: 调用chip_identify(query) -> 验证型号，获取chipId
Step 3: 检查匹配分数 -> 确认唯一匹配项或请求用户选择
Step 4: 根据用户意图路由至对应工具
Step 5: 格式化并展示结果，按需生成代码

重要提示： 绝不能跳过Step 2。所有其他工具都需要来自

chip_identify

的

chipId

。

Hardware-Aware Identification

硬件感知式识别

The chip identification flow supports automatic detection from project context:

Automatic Detection Sources:

C/C++ header includes:
```
#include "stm32f4xx.h"
```
-> STM32F4 series
Platform IO config:
```
board = esp32-s3-devkitc-1
```
-> ESP32-S3
CMake definitions:
```
-DNRF52840_XXAA
```
-> nRF52840
STM32CubeMX
```
.ioc
```
files: project chip configuration

matchScore Thresholds:

= 0.9: High confidence, proceed directly
0.7-0.9: Moderate confidence, confirm with user
< 0.7: Low confidence, present candidates for user selection

Multi-Candidate Handling: When multiple chips match, present a numbered list with model, vendor, and description. Ask the user to select. Never silently pick a low-confidence match.

See

rules/flow-chip-identify.md

for detailed flow and error handling.

芯片识别流程支持从项目上下文中自动检测：

自动检测来源：

C/C++头文件引用：
```
#include "stm32f4xx.h"
```
-> STM32F4系列
Platform IO配置：
```
board = esp32-s3-devkitc-1
```
-> ESP32-S3
CMake定义：
```
-DNRF52840_XXAA
```
-> nRF52840
STM32CubeMX
```
.ioc
```
文件：项目芯片配置

匹配分数阈值：

= 0.9：高置信度，直接继续
0.7-0.9：中等置信度，需与用户确认
< 0.7：低置信度，展示候选列表供用户选择

多候选处理方式： 当多个芯片匹配时，展示带编号的列表，包含型号、厂商及描述，请求用户选择。绝不能静默选择低置信度的匹配项。

详细流程及错误处理请参考

rules/flow-chip-identify.md

。

Context Injection Strategy

上下文注入策略

After chip identification, inject specification data progressively:

芯片识别完成后，逐步注入规格数据：

Layer 1: Always Inject (after identification)

第一层：识别后必注入

Chip model, vendor, series
CPU core (e.g., ARM Cortex-M4), max frequency
Flash and RAM capacity, operating voltage

芯片型号、厂商、系列
CPU内核（如ARM Cortex-M4）、最高主频
闪存与RAM容量、工作电压

Layer 2: On-Demand Inject (when discussing peripherals)

第二层：讨论外设时按需注入

Peripheral specs (UART count, SPI features, etc.)
Pin definitions and alternate functions for specific peripherals
Package info (pin count, dimensions)

外设规格（UART数量、SPI特性等）
特定外设的引脚定义与复用功能
封装信息（引脚数、尺寸）

Layer 3: Deep Inject (when writing low-level code)

第三层：编写底层代码时深度注入

TRM register definitions (name, address, bit fields, access type)
Programming guide with init sequences and code examples
Both HAL-level and register-level implementations

TRM寄存器定义（名称、地址、位域、访问类型）
包含初始化序列与代码示例的编程指南
HAL层与寄存器层两种实现方式

Context Management

上下文管理

Avoid overflow: Do NOT load all chip data at once. Load only what the current task needs.
Prioritize relevance: When discussing UART, load UART data, not all peripherals.
Chip switching: When user switches to a different chip, clear old context completely and load new chip data. Never mix data from different chips.

See

rules/flow-context-inject.md

for detailed injection flow.

避免过载： 请勿一次性加载所有芯片数据。仅加载当前任务所需的内容。
优先相关性： 讨论UART时，仅加载UART相关数据，而非所有外设。
芯片切换： 当用户切换至另一款芯片时，完全清除旧上下文并加载新芯片数据。绝不能混合不同芯片的数据。

详细注入流程请参考

rules/flow-context-inject.md

。

Supported Chip Families

支持的芯片系列

Vendor	Series	Example Models
STMicroelectronics	STM32F0/F1/F2/F3/F4/F7/H7/L0/L1/L4/G0/G4/U5/WB/WL	STM32F407VGT6
Espressif	ESP32/ESP32-S2/S3/C3/C6/H2	ESP32-S3-WROOM-1
Nordic Semiconductor	nRF52810/832/833/840	nRF52840

厂商	系列	示例型号
STMicroelectronics	STM32F0/F1/F2/F3/F4/F7/H7/L0/L1/L4/G0/G4/U5/WB/WL	STM32F407VGT6
Espressif	ESP32/ESP32-S2/S3/C3/C6/H2	ESP32-S3-WROOM-1
Nordic Semiconductor	nRF52810/832/833/840	nRF52840

Rule Categories

规则分类

Detailed rules are organized in

rules/

for progressive loading:

File	Impact	Description
`rules/flow-chip-identify.md`	HIGH	Chip identification triggers, 5-step flow, matchScore handling, error recovery
`rules/flow-context-inject.md`	HIGH	3-layer injection strategy, context window management, chip switching protocol
`rules/api-chip-identify.md`	HIGH	chip_identify interface: fuzzy matching, alias recognition, response format
`rules/api-chip-trm.md`	HIGH	chip_trm interface: section filtering, Register/RegisterField data format
`rules/api-chip-specs.md`	MEDIUM	chip_specs interface: 4 category queries, electrical specs with limits
`rules/api-chip-hardware.md`	HIGH	chip_hardware interface: pin/function filtering, AF mapping, package info
`rules/api-chip-programming.md`	MEDIUM	chip_programming_guide: SDK/HAL code, init sequences, dual implementations

Section index: See

rules/_sections.md

for loading order and strategy.

详细规则按类别组织在

rules/

目录中，支持渐进式加载：

文件	影响级别	描述
`rules/flow-chip-identify.md`	高	芯片识别触发条件、5步流程、匹配分数处理、错误恢复
`rules/flow-context-inject.md`	高	三层注入策略、上下文窗口管理、芯片切换协议
`rules/api-chip-identify.md`	高	chip_identify接口：模糊匹配、别名识别、响应格式
`rules/api-chip-trm.md`	高	chip_trm接口：章节过滤、Register/RegisterField数据格式
`rules/api-chip-specs.md`	中	chip_specs接口：4类查询、带限制的电气规格
`rules/api-chip-hardware.md`	高	chip_hardware接口：引脚/功能过滤、复用功能映射、封装信息
`rules/api-chip-programming.md`	中	chip_programming_guide：SDK/HAL代码、初始化序列、双重实现

章节索引： 加载顺序及策略请参考

rules/_sections.md

。

Full Compiled Document

完整编译文档

For platforms that prefer a single file with all rules, see

AGENTS.md

— a compiled version of all rule files in this Skill.

若平台偏好单文件包含所有规则，请查看

AGENTS.md

——本Skill所有规则文件的编译版本。