lucasrguerra/ESPDocs
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 10 Wiki Activity

feat(i18n): zh-CN content (data, glossary, diagnostics, components, messages, examples)

Browse Source 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
Lucas RayanandClaude Sonnet 5.5 committed 2026-11-01 22:06:21 -03:00
1 parent ea51aa62b8
commit 1d79051250
31 files changed
+13005
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

data/zh-CN/conexoes/ESP32-C2.json
+307
View File
@@ -0,0 +1,307 @@
[
{
"numero": "1",
"nome": "ANT",
"tipo": "analog",
"funcoes": ["RF 天线连接（Wi-Fi 和 Bluetooth）"],
"categorias": ["天线", "射频"],
"avisos": ["专用 RF 引脚。避免长走线或未做 50 欧姆阻抗匹配。"]
},
{
"numero": "2",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": ["3.3V 模拟电源"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V（3.0V 至 3.6V）",
"为芯片的模拟和 RF 电路供电"
]
},
{
"numero": "3",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": ["3.3V 模拟电源"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V（3.0V 至 3.6V）",
"为芯片的模拟和 RF 电路供电"
]
},
{
"numero": "4",
"nome": "GPIO0",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO0",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 0 模拟输入引脚"]
},
{
"numero": "5",
"nome": "GPIO1",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO1",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 1 模拟输入引脚"]
},
{
"numero": "6",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO2",
"ADC1_CH2",
"FSPIQ"
],
"categorias": [
"GPIO",
"ADC",
"SPI"
],
"avisos": ["启动时默认映射为 SPI MISO（FSPIQ）功能"]
},
{
"numero": "7",
"nome": "CHIP_EN",
"tipo": "analog",
"funcoes": ["使能芯片（上电/复位）"],
"categorias": ["电源"],
"avisos": [
"高电平有效。拉高以启动芯片。",
"请勿让该引脚浮空。请使用外部 RC 延迟电路以实现稳定启动。"
]
},
{
"numero": "8",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO3",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 3 模拟输入引脚"]
},
{
"numero": "9",
"nome": "GPIO4",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO4",
"MTMS",
"FSPIQ",
"ADC1_CH4"
],
"categorias": [
"GPIO",
"JTAG",
"SPI",
"ADC"
],
"avisos": [
"多功能引脚：JTAG MTMS、SPI2 MISO 和 ADC1 通道 4。",
"可与其他 JTAG 引脚配合用于 JTAG 调试。"
]
},
{
"numero": "10",
"nome": "GPIO5",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO5",
"MTDI",
"FSPIWP"
],
"categorias": [
"GPIO",
"JTAG",
"SPI"
],
"avisos": ["多功能引脚：JTAG MTDI 和 SPI2 Write Protect（FSPIWP）。"]
},
{
"numero": "11",
"nome": "VDD3P3_RTC",
"tipo": "power",
"funcoes": ["RTC 域和低功耗 IO 的电源"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V"]
},
{
"numero": "12",
"nome": "GPIO6",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO6",
"MTCK",
"FSPICLK"
],
"categorias": [
"GPIO",
"JTAG",
"SPI"
],
"avisos": ["多功能引脚：JTAG MTCK 和 SPI2 Clock（FSPICLK）。"]
},
{
"numero": "13",
"nome": "GPIO7",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO7",
"MTDO",
"FSPID"
],
"categorias": [
"GPIO",
"JTAG",
"SPI"
],
"avisos": ["多功能引脚：JTAG MTDO 和 SPI2 MOSI（FSPID）。"]
},
{
"numero": "14",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": ["GPIO8"],
"categorias": ["GPIO", "启动配置"],
"avisos": [
"用于启动控制的 Strapping 引脚。",
"与 GPIO9 配合选择 SoC 启动模式（若 GPIO9=0，复位期间必须为 1 才能进入 Joint Download Boot）。"
]
},
{
"numero": "15",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": ["GPIO9"],
"categorias": ["GPIO", "启动配置"],
"avisos": [
"主 Strapping 引脚。复位时高电平（1）启用 SPI Boot（默认通过弱上拉）。",
"复位时低电平（0）使芯片进入 UART/SPI 下载模式。"
]
},
{
"numero": "16",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO10",
"FSPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["多功能引脚：SPI2 Chip Select 0（FSPICS0）。"]
},
{
"numero": "17",
"nome": "VDD3P3_CPU",
"tipo": "power",
"funcoes": ["CPU 及相应 IO 的数字电源（3.3V）"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V"]
},
{
"numero": "18",
"nome": "GPIO18",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": ["GPIO18"],
"categorias": ["GPIO"]
},
{
"numero": "19",
"nome": "GPIO19",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO19",
"U0RXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": ["UART0 接收引脚（默认用于烧录和监视的 Serial RX）。"]
},
{
"numero": "20",
"nome": "GPIO20",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO20",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": ["UART0 发送引脚（默认用于烧录和监视的 Serial TX）。"]
},
{
"numero": "21",
"nome": "VDDA",
"tipo": "power",
"funcoes": ["3.3V 模拟输入电源"],
"categorias": ["电源"]
},
{
"numero": "22",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": ["外部晶振连接（输出）"],
"categorias": ["时钟"]
},
{
"numero": "23",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": ["外部晶振连接（输入）"],
"categorias": ["时钟"]
},
{
"numero": "24",
"nome": "VDDA",
"tipo": "power",
"funcoes": ["3.3V 模拟输入电源"],
"categorias": ["电源"]
},
{
"numero": "25",
"nome": "GND",
"tipo": "power",
"funcoes": ["中心接地焊盘（Exposed Pad）"],
"categorias": ["电源"],
"avisos": ["应正确焊接至 PCB 接地平面（GND），以实现稳定性能和散热。"]
}
]
data/zh-CN/conexoes/ESP32-C3.json
+533
View File
@@ -0,0 +1,533 @@
[
{
"numero": "1",
"nome": "LNA_IN",
"tipo": "analog",
"funcoes": ["天线 RF 信号（Wi-Fi 和 Bluetooth）输入输出"],
"categorias": ["天线"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "2",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "3",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "4",
"nome": "XTAL_32K_P",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO0",
"XTAL_32K_P",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"时钟",
"ADC"
]
},
{
"numero": "5",
"nome": "XTAL_32K_N",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO1",
"XTAL_32K_N",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"时钟",
"ADC"
]
},
{
"numero": "6",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO2",
"ADC1_CH2",
"FSPIQ"
],
"categorias": [
"GPIO",
"ADC",
"SPI",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"实际上，该引脚并不决定启动模式，但建议将其上拉以避免毛刺（详见数据手册第 3.1 节）"
]
},
{
"numero": "7",
"nome": "CHIP_EN",
"tipo": "analog",
"funcoes": ["使能芯片"],
"categorias": ["电源"],
"avisos": [
"将该引脚置高将使芯片工作",
"将该引脚置低将禁用芯片工作",
"请勿让该引脚浮空，请使用外部上拉电阻"
]
},
{
"numero": "8",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO3",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "9",
"nome": "MTMS",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO4",
"ADC1_CH4",
"FSPIHD",
"MTMS"
],
"categorias": [
"GPIO",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "10",
"nome": "MTDI",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO5",
"ADC2_CH0",
"FSPIWP",
"MTDI"
],
"categorias": [
"GPIO",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "11",
"nome": "VDD3P3_RTC",
"tipo": "power",
"funcoes": ["低功耗域和部分数字域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "12",
"nome": "MTCK",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO6",
"FSPICLK",
"MTCK"
],
"categorias": [
"GPIO",
"SPI",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "13",
"nome": "MTDO",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO7",
"FSPID",
"MTDO"
],
"categorias": [
"GPIO",
"SPI",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "14",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": ["GPIO8"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "15",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": ["GPIO9"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "16",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO10",
"FSPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "17",
"nome": "VDD3P3_CPU",
"tipo": "power",
"funcoes": ["数字域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "18",
"nome": "VDD_SPI",
"tipo": "power",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"内部/外部 Flash 电源输入/输出",
"GPIO11"
],
"categorias": [
"电源",
"GPIO"
],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节",
"仅当 Flash 存储由外部电源供电时，才能用作 GPIO"
]
},
{
"numero": "19",
"nome": "SPIHD",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDD3P3_CPU"],
"funcoes": [
"GPIO12",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "20",
"nome": "SPIWP",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDD3P3_CPU"],
"funcoes": [
"GPIO13",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "21",
"nome": "SPICS0",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDD3P3_CPU"],
"funcoes": [
"GPIO14",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "22",
"nome": "SPICLK",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDD3P3_CPU"],
"funcoes": [
"GPIO15",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "23",
"nome": "SPID",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDD3P3_CPU"],
"funcoes": [
"GPIO16",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "24",
"nome": "SPIQ",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDD3P3_CPU"],
"funcoes": [
"GPIO17",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "25",
"nome": "GPIO18",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO18",
"USB_D-"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": ["默认情况下，该引脚用于 USB Serial/JTAG"]
},
{
"numero": "26",
"nome": "GPIO19",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO19",
"USB_D+"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": ["默认情况下，该引脚用于 USB Serial/JTAG"]
},
{
"numero": "27",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO20",
"U0RXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "28",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO21",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"复位后，该引脚将启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "29",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": ["时钟负输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.3.2 节"]
},
{
"numero": "30",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": ["时钟正输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.3.2 节"]
},
{
"numero": "31",
"nome": "VDDA",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "32",
"nome": "VDDA",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "33",
"nome": "GND",
"tipo": "ground",
"funcoes": ["电路电气参考（地）"],
"categorias": ["GND"]
}
]
data/zh-CN/conexoes/ESP32-C5.json
+776
View File
@@ -0,0 +1,776 @@
[
{
"numero": "1",
"nome": "VDDA6",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "2",
"nome": "GND",
"tipo": "ground",
"funcoes": ["电路电气参考（地）"],
"categorias": ["GND"]
},
{
"numero": "3",
"nome": "VDDA7",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "4",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": ["时钟负输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.3.3 节"]
},
{
"numero": "5",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": ["时钟正输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.3.3 节"]
},
{
"numero": "6",
"nome": "VDDA8",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "7",
"nome": "CHIP_PU",
"tipo": "analog",
"alimentacao": ["VDDPST1"],
"funcoes": ["使能芯片"],
"categorias": ["电源"],
"avisos": [
"将该引脚置高将使芯片工作",
"将该引脚置低将禁用芯片工作",
"请勿让该引脚浮空，请使用外部上拉电阻"
]
},
{
"numero": "8",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": ["低功耗数字域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "9",
"nome": "XTAL_32K_P",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO0",
"LP_GDIO0",
"XTAL_32K_P",
"LP_UART_DTRN"
],
"categorias": [
"GPIO",
"低功耗",
"时钟",
"UART"
]
},
{
"numero": "10",
"nome": "XTAL_32K_N",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO1",
"LP_GDIO1",
"XTAL_32K_N",
"LP_UART_DSRN",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"低功耗",
"时钟",
"UART",
"ADC"
]
},
{
"numero": "11",
"nome": "MTMS",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO2",
"LP_GDIO2",
"LP_UART_RTSN",
"LP_I2C_SDA",
"ADC1_CH1",
"FSPIQ",
"MTMS"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"I2C",
"ADC",
"SPI",
"JTAG",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"I2C_SDA 功能在低功耗（LP）模式下可用",
"用于调试的引脚",
"用于控制芯片晶振频率（详见数据手册第 3.5 节）"
]
},
{
"numero": "12",
"nome": "MTDI",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO3",
"LP_GDIO3",
"LP_UART_CTSN",
"LP_I2C_SCL",
"ADC1_CH2",
"MTDI"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"I2C",
"ADC",
"JTAG",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"I2C_SDA 功能在低功耗（LP）模式下可用",
"用于调试的引脚",
"用于控制 SDIO Slave 时序（详见数据手册第 3.2 节）"
]
},
{
"numero": "13",
"nome": "MTCK",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO4",
"LP_GDIO4",
"LP_UART_RXD",
"ADC1_CH3",
"FSPIHD",
"MTCK"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "14",
"nome": "MTDO",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO5",
"LP_GDIO5",
"LP_UART_TXD",
"ADC1_CH4",
"FSPIWP",
"MTDO"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "15",
"nome": "GPIO6",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO6",
"LP_GDIO6",
"ADC1_CH5",
"FSPICLK"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"SPI"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "16",
"nome": "GPIO7",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO7",
"FSPID",
"SDIO_DATA1"
],
"categorias": [
"GPIO",
"SPI",
"SD"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制 JTAG 信号源（详见数据手册第 3.4 节）"
]
},
{
"numero": "17",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO8",
"SDIO_DATA0",
"PAD_COMP0"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "18",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO9",
"SDIO_CLK",
"PAD_COMP1"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "19",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO10",
"FSPICS0",
"SDIO_CMD"
],
"categorias": [
"GPIO",
"SPI",
"SD"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "20",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO11",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"复位后，该引脚将启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "21",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO12",
"U0RXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "22",
"nome": "GPIO13",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO13",
"USB_D-",
"SDIO_DATA3"
],
"categorias": [
"GPIO",
"USB",
"SD"
],
"avisos": [
"复位后，该引脚将配置为输入",
"默认情况下，该引脚用于 USB Serial/JTAG"
]
},
{
"numero": "23",
"nome": "GPIO14",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO14",
"USB_D+",
"SDIO_DATA4"
],
"categorias": [
"GPIO",
"USB",
"SD"
],
"avisos": [
"复位期间，该引脚将启用 USB 内部上拉",
"复位后，该引脚将配置为输入并启用 USB 内部上拉",
"默认情况下，该引脚用于 USB Serial/JTAG"
]
},
{
"numero": "24",
"nome": "VDDPST2",
"tipo": "power",
"funcoes": ["高性能数字域和部分模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "25",
"nome": "SPICS1",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO15",
"SPICS1"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "26",
"nome": "SPICS0",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO16",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "27",
"nome": "SPIQ",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO17",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "28",
"nome": "SPIWP",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO18",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "29",
"nome": "VDD_SPI",
"tipo": "power",
"funcoes": [
"外部 Flash 电源输出",
"GPIO19"
],
"categorias": [
"电源",
"GPIO"
],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节",
"仅当外部 Flash 存储由外部电源供电时，才能用作 GPIO"
]
},
{
"numero": "30",
"nome": "SPIHD",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO20",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "31",
"nome": "SPICLK",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO21",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "32",
"nome": "SPID",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO22",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "33",
"nome": "GPIO23",
"tipo": "io",
"alimentacao": ["VDDPST3"],
"funcoes": ["GPIO23"],
"categorias": ["GPIO"],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "34",
"nome": "GPIO24",
"tipo": "io",
"alimentacao": ["VDDPST3"],
"funcoes": ["GPIO24"],
"categorias": ["GPIO"],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "35",
"nome": "GPIO25",
"tipo": "io",
"alimentacao": ["VDDPST3"],
"funcoes": ["GPIO25"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制 SDIO Slave 时序（详见数据手册第 3.4 节）"
]
},
{
"numero": "36",
"nome": "GPIO26",
"tipo": "io",
"alimentacao": ["VDDPST3"],
"funcoes": ["GPIO26"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "37",
"nome": "GPIO27",
"tipo": "io",
"alimentacao": ["VDDPST3"],
"funcoes": ["GPIO27"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于控制芯片启动模式（详见数据手册第 3.1 节）",
"用于控制 UART0 上 ROM 消息的显示（详见数据手册第 3.3 节）"
]
},
{
"numero": "38",
"nome": "GPIO28",
"tipo": "io",
"alimentacao": ["VDDPST3"],
"funcoes": ["GPIO28"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "39",
"nome": "VDDPST3",
"tipo": "power",
"funcoes": ["高性能数字域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "40",
"nome": "VDDA1",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "41",
"nome": "VDDA2",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "42",
"nome": "ANT_2G",
"tipo": "analog",
"funcoes": ["2 GHz 频段的 RF 天线连接"],
"categorias": ["天线"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "43",
"nome": "GND",
"tipo": "ground",
"funcoes": ["电路电气参考（地）"],
"categorias": ["GND"]
},
{
"numero": "44",
"nome": "VDDA3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "44",
"nome": "VDDA4",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "45",
"nome": "VDDA5",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "47",
"nome": "GND",
"tipo": "ground",
"funcoes": ["电路电气参考（地）"],
"categorias": ["GND"]
},
{
"numero": "48",
"nome": "ANT_5G",
"tipo": "analog",
"funcoes": ["5 GHz 频段的 RF 天线连接"],
"categorias": ["天线"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
}
]
data/zh-CN/conexoes/ESP32-C6.json
+715
View File
@@ -0,0 +1,715 @@
[
{
"numero": "1",
"nome": "ANT",
"tipo": "analog",
"funcoes": ["RF 天线连接"],
"categorias": ["天线"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "2",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "3",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "4",
"nome": "CHIP_PU",
"tipo": "analog",
"funcoes": ["使能芯片"],
"categorias": ["电源"],
"avisos": [
"将该引脚置高将使芯片工作",
"将该引脚置低将禁用芯片工作",
"请勿让该引脚浮空，请使用外部上拉电阻"
]
},
{
"numero": "5",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": ["低功耗数字域和部分模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "6",
"nome": "XTAL_32K_P",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO0",
"LP_GDIO0",
"XTAL_32K_P",
"LP_UART_DTRN",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"低功耗",
"时钟",
"UART"
]
},
{
"numero": "7",
"nome": "XTAL_32K_N",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO1",
"LP_GDIO1",
"XTAL_32K_N",
"LP_UART_DSRN",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"低功耗",
"时钟",
"UART",
"ADC"
]
},
{
"numero": "8",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO2",
"LP_GDIO2",
"LP_UART_RTSN",
"ADC1_CH2",
"FSPIQ"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"ADC",
"SPI"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "9",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO3",
"LP_GDIO3",
"LP_UART_CTSN",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"ADC"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "10",
"nome": "MTMS",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO4",
"LP_GDIO4",
"LP_UART_RXD",
"ADC1_CH3",
"FSPIHD",
"MTMS"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于调试的引脚",
"用于控制 SDIO Slave 时序（详见数据手册第 3.2 节）"
]
},
{
"numero": "11",
"nome": "MTDI",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO5",
"LP_GDIO5",
"LP_UART_TXD",
"ADC1_CH5",
"FSPIWP",
"MTDI"
],
"categorias": [
"GPIO",
"低功耗",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于调试的引脚",
"用于控制 SDIO Slave 时序（详见数据手册第 3.2 节）"
]
},
{
"numero": "12",
"nome": "MTCK",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO6",
"LP_GDIO6",
"LP_I2C_SDA",
"ADC1_CH6",
"FSPICLK",
"MTCK"
],
"categorias": [
"GPIO",
"低功耗",
"I2C",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"I2C_SDA 功能在低功耗（LP）模式下可用",
"用于调试的引脚"
]
},
{
"numero": "13",
"nome": "MTDO",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO7",
"LP_GDIO7",
"LP_I2C_SCL",
"FSPID",
"MTDO"
],
"categorias": [
"GPIO",
"低功耗",
"I2C",
"SPI",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入",
"I2C_SDA 功能在低功耗（LP）模式下可用",
"用于调试的引脚"
]
},
{
"numero": "14",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO8"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制芯片启动模式（详见数据手册第 3.1 节）",
"用于控制 UART0 上 ROM 消息的显示（详见数据手册第 3.3 节）"
]
},
{
"numero": "15",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO9"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "16",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO10"],
"categorias": ["GPIO"],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "17",
"nome": "GPIO11",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO11"],
"categorias": ["GPIO"],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "18",
"nome": "GPIO12",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO12",
"USB_D-"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"复位后，该引脚将配置为输入",
"默认情况下，该引脚用于 USB Serial/JTAG"
]
},
{
"numero": "19",
"nome": "GPIO13",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO13",
"USB_D+"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"默认情况下，该引脚用于 USB Serial/JTAG"
]
},
{
"numero": "20",
"nome": "SPICS0",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO24",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "21",
"nome": "SPIQ",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO25",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "22",
"nome": "SPIWP",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO26",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "23",
"nome": "VDD_SPI",
"tipo": "power",
"funcoes": [
"Flash 存储电源输入/输出",
"GPIO27"
],
"categorias": [
"电源",
"GPIO"
],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节",
"仅当外部 Flash 存储由外部电源供电时，才能用作 GPIO"
]
},
{
"numero": "24",
"nome": "SPIHD",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO28",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "25",
"nome": "SPICLK",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO29",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "26",
"nome": "SPID",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": [
"GPIO30",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"由 SPI Flash 存储使用",
"不建议将该引脚用作 GPIO"
]
},
{
"numero": "27",
"nome": "GPIO15",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO15"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制 JTAG 信号源（详见数据手册第 3.4 节）"
]
},
{
"numero": "28",
"nome": "VDDA2",
"tipo": "power",
"funcoes": ["高性能数字域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "29",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO16",
"U0TXD",
"FSPICS0"
],
"categorias": [
"GPIO",
"UART",
"SPI"
],
"avisos": [
"复位后，该引脚将启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "30",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO17",
"U0RXD",
"FSPICS1"
],
"categorias": [
"GPIO",
"UART",
"SPI"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "31",
"nome": "SDIO_CMD",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO18",
"SDIO_CMD",
"FSPICS2"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "32",
"nome": "SDIO_CLK",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO19",
"SDIO_CLK",
"FSPICS3"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "33",
"nome": "SDIO_DATA0",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO20",
"SDIO_DATA0",
"FSPICS4"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "34",
"nome": "SDIO_DATA1",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO21",
"SDIO_DATA1",
"FSPICS5"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "35",
"nome": "SDIO_DATA2",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO22",
"SDIO_DATA2"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "36",
"nome": "SDIO_DATA3",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO23",
"SDIO_DATA3"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": [
"复位期间，该引脚将启用内部上拉",
"复位后，该引脚将配置为输入"
]
},
{
"numero": "37",
"nome": "VDDA1",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "38",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": ["时钟负输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "39",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": ["时钟正输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "40",
"nome": "VDDA2",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "41",
"nome": "GND",
"tipo": "ground",
"funcoes": ["电路电气参考（地）"],
"categorias": ["GND"]
}
]
data/zh-CN/conexoes/ESP32-C61.json
+536
View File
@@ -0,0 +1,536 @@
[
{
"numero": "1",
"nome": "ANT_2G",
"tipo": "analog",
"funcoes": ["RF 天线连接（Wi-Fi 和 Bluetooth）"],
"categorias": ["天线", "射频"],
"avisos": ["专用于 2.4 GHz 的 RF 引脚。需要 50 欧姆阻抗匹配。"]
},
{
"numero": "2",
"nome": "VDDA3",
"tipo": "power",
"funcoes": ["3.3V 模拟域电源"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V（3.0V 至 3.6V）。为 RF 和时钟电路供电。"]
},
{
"numero": "3",
"nome": "VDDA4",
"tipo": "power",
"funcoes": ["3.3V 模拟域电源"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V（3.0V 至 3.6V）。为 RF 和时钟电路供电。"]
},
{
"numero": "4",
"nome": "CHIP_PU",
"tipo": "analog",
"funcoes": ["使能芯片（上电/复位）"],
"categorias": ["电源"],
"avisos": [
"高电平有效。拉高以启动芯片。",
"请勿让该引脚浮空。建议使用外部 RC 电路以实现干净复位。"
]
},
{
"numero": "5",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": ["HP（High Performance）和 LP（Low Power）域的数字电源"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V。为低功耗数字部分及相关引脚供电。"]
},
{
"numero": "6",
"nome": "GPIO0",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO0",
"XTAL_32K_P"
],
"categorias": [
"GPIO",
"时钟"
],
"avisos": ["低功耗多功能引脚。可连接外部 32 kHz 晶振（P 输入）。"]
},
{
"numero": "7",
"nome": "GPIO1",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO1",
"XTAL_32K_N",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"时钟",
"ADC"
],
"avisos": ["多功能引脚。外部 32 kHz 晶振连接（N 输出）和 ADC1 通道 0 模拟输入。"]
},
{
"numero": "8",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": ["GPIO2"],
"categorias": ["GPIO"]
},
{
"numero": "9",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO3",
"MTMS",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"JTAG",
"ADC",
"启动配置"
],
"avisos": [
"多功能引脚：JTAG MTMS、ADC1 通道 1 和用于 SDIO 时钟边沿控制的 Strapping 引脚。",
"复位期间默认为浮空。"
]
},
{
"numero": "10",
"nome": "GPIO4",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO4",
"MTDI",
"ADC1_CH2"
],
"categorias": [
"GPIO",
"JTAG",
"ADC",
"启动配置"
],
"avisos": [
"多功能引脚：JTAG MTDI、ADC1 通道 2 和用于 SDIO 时钟边沿控制的 Strapping 引脚。",
"复位期间默认为浮空。"
]
},
{
"numero": "11",
"nome": "GPIO5",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO5",
"MTCK",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"JTAG",
"ADC"
],
"avisos": ["多功能引脚：JTAG MTCK 和 ADC1 通道 3 模拟输入。"]
},
{
"numero": "12",
"nome": "GPIO6",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO6",
"MTDO"
],
"categorias": [
"GPIO",
"JTAG"
],
"avisos": ["JTAG MTDO 多功能引脚。"]
},
{
"numero": "13",
"nome": "GPIO25",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO25",
"SDIO_CMD",
"FSPICS0"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": ["高速多功能引脚：SDIO Command 或 SPI2 Chip Select 0。"]
},
{
"numero": "14",
"nome": "GPIO26",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO26",
"SDIO_CLK",
"FSPICLK"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": ["高速多功能引脚：SDIO Clock 或 SPI2 Clock。"]
},
{
"numero": "15",
"nome": "GPIO27",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO27",
"SDIO_DATA0",
"FSPID"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": ["高速多功能引脚：SDIO 数据 0 或 SPI2 MOSI（FSPID）。"]
},
{
"numero": "16",
"nome": "GPIO28",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO28",
"SDIO_DATA1",
"FSPIQ"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": ["高速引脚：SDIO 数据 1 或 SPI2 MISO（FSPIQ）。"]
},
{
"numero": "17",
"nome": "GPIO22",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO22",
"SDIO_DATA2",
"FSPIWP"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": ["高速引脚：SDIO 数据 2 或 SPI2 Write Protect。"]
},
{
"numero": "18",
"nome": "GPIO23",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO23",
"SDIO_DATA3",
"FSPIHD"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": ["高速引脚：SDIO 数据 3 或 SPI2 Hold。"]
},
{
"numero": "19",
"nome": "GPIO14",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDDPST2"],
"funcoes": [
"GPIO14",
"SPICS1"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["SPI Flash/PSRAM 存储接口 Chip Select 1 的专用引脚。"]
},
{
"numero": "20",
"nome": "GPIO15",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDDPST2"],
"funcoes": [
"GPIO15",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["SPI Flash 存储接口 Chip Select 0 的专用引脚。"]
},
{
"numero": "21",
"nome": "VDDPST2",
"tipo": "power",
"funcoes": ["HP（High Performance）数字域电源"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V（3.0V 至 3.6V）。为高速数字接口供电。"]
},
{
"numero": "22",
"nome": "GPIO16",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDDPST2"],
"funcoes": [
"GPIO16",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["SPI Flash 存储接口的数据 Q（MISO）引脚。"]
},
{
"numero": "23",
"nome": "GPIO17",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDDPST2"],
"funcoes": [
"GPIO17",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["SPI Flash 存储接口的写保护（Write Protect）引脚。"]
},
{
"numero": "24",
"nome": "VDD_SPI",
"tipo": "power",
"funcoes": ["由 VDDPST2 生成的 LDO 输出电压，用于为 Flash 和 PSRAM 供电"],
"categorias": ["电源"],
"avisos": [
"可根据内部/外部 Flash 规格通过软件配置的输出电压（通常为 3.3V 或 1.8V）。",
"不得用作大电流通用电源"
]
},
{
"numero": "25",
"nome": "GPIO19",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDDPST2"],
"funcoes": [
"GPIO19",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["SPI Flash 存储接口的 Hold 控制引脚。"]
},
{
"numero": "26",
"nome": "GPIO20",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDDPST2"],
"funcoes": [
"GPIO20",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["SPI Flash 存储接口的时钟信号引脚。"]
},
{
"numero": "27",
"nome": "GPIO21",
"tipo": "io",
"alimentacao": ["VDD_SPI", "VDDPST2"],
"funcoes": [
"GPIO21",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["SPI Flash 存储接口的数据 D（MOSI）引脚。"]
},
{
"numero": "28",
"nome": "GPIO12",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO12",
"USB_D-"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": ["集成 USB Serial/JTAG 收发器的负信号引脚。"]
},
{
"numero": "29",
"nome": "GPIO13",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO13",
"USB_D+"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"集成 USB Serial/JTAG 收发器的正信号引脚。",
"USB 初始化时默认启用内置上拉电阻。"
]
},
{
"numero": "30",
"nome": "GPIO24",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO24"],
"categorias": ["GPIO"]
},
{
"numero": "31",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO8"],
"categorias": ["GPIO", "启动配置"],
"avisos": [
"用于选择启动模式和控制 ROM 消息打印的 Strapping 引脚。",
"复位期间默认为浮空。高电平（1）启用启动日志打印。"
]
},
{
"numero": "32",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO9"],
"categorias": ["GPIO", "启动配置"],
"avisos": [
"用于启动模式选择的主 Strapping 引脚。",
"内置弱上拉。复位时高电平（1）启用 SPI Boot（从 Flash 加载）。低电平（0）强制进入 Download 模式。"
]
},
{
"numero": "33",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO10",
"U0RXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": ["UART0 串口接收（用于外部固件烧录和调试的 Serial RX）。"]
},
{
"numero": "34",
"nome": "GPIO11",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO11",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": ["UART0 串口发送（用于外部固件烧录和调试的 Serial TX）。"]
},
{
"numero": "35",
"nome": "GPIO29",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO29"],
"categorias": ["GPIO"]
},
{
"numero": "36",
"nome": "GPIO7",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO7"],
"categorias": ["GPIO", "启动配置"],
"avisos": [
"用于选择 JTAG 信号源的 Strapping 引脚（早期初始化）。",
"复位时无内部上拉电阻。如使用，必须通过外部电路保持稳定。"
]
},
{
"numero": "37",
"nome": "VDDA1",
"tipo": "power",
"funcoes": ["3.3V 模拟域电源"],
"categorias": ["电源"]
},
{
"numero": "38",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": ["40 MHz 外部晶振连接（N 输出）"],
"categorias": ["时钟"]
},
{
"numero": "39",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": ["40 MHz 外部晶振连接（P 输入）"],
"categorias": ["时钟"]
},
{
"numero": "40",
"nome": "VDDA2",
"tipo": "power",
"funcoes": ["3.3V 模拟域电源"],
"categorias": ["电源"]
},
{
"numero": "41",
"nome": "GND",
"tipo": "power",
"funcoes": ["中心接地焊盘（Exposed Pad）"],
"categorias": ["电源"],
"avisos": ["应正确焊接至 PCB 接地平面（GND），以实现稳定的 RF 和热控制。"]
}
]
data/zh-CN/conexoes/ESP32-H2.json
+482
View File
@@ -0,0 +1,482 @@
[
{
"numero": "1",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "2",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "3",
"nome": "GPIO0",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO0",
"FSPIQ"
],
"categorias": [
"GPIO",
"SPI"
]
},
{
"numero": "4",
"nome": "GPIO1",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO1",
"FSPICS0",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"SPI",
"ADC"
]
},
{
"numero": "5",
"nome": "MTMS",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO1",
"FSPIWP",
"ADC1_CH1",
"MTMS"
],
"categorias": [
"GPIO",
"SPI",
"ADC",
"JTAG"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "6",
"nome": "MTDO",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO3",
"FSPIHD",
"ADC1_CH2",
"MTDO"
],
"categorias": [
"GPIO",
"SPI",
"ADC",
"JTAG"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "7",
"nome": "MTCK",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO4",
"FSPICLK",
"ADC1_CH3",
"MTCK"
],
"categorias": [
"GPIO",
"SPI",
"ADC",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "8",
"nome": "MTDI",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO5",
"FSPID",
"ADC1_CH4",
"MTDI"
],
"categorias": [
"GPIO",
"SPI",
"ADC",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入",
"用于调试的引脚"
]
},
{
"numero": "9",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": ["IO 域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "10",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": ["GPIO8"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制芯片启动模式（详见数据手册第 3.1 节）",
"用于控制 UART0 上 ROM 消息的显示（详见数据手册第 3.3 节）"
]
},
{
"numero": "11",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": ["GPIO9"],
"categorias": [
"GPIO",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "12",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO10",
"ZCD0"
],
"categorias": ["GPIO"]
},
{
"numero": "13",
"nome": "GPIO11",
"tipo": "io",
"alimentacao": ["VDDPST1"],
"funcoes": [
"GPIO11",
"ZCD1"
],
"categorias": ["GPIO"]
},
{
"numero": "14",
"nome": "GPIO12",
"tipo": "io",
"alimentacao": ["VDDA_PMU", "VBAT"],
"funcoes": ["GPIO12"],
"categorias": ["GPIO"]
},
{
"numero": "15",
"nome": "XTAL_32K_P",
"tipo": "io",
"alimentacao": ["VDDA_PMU", "VBAT"],
"funcoes": [
"GPIO13",
"XTAL_32K_P"
],
"categorias": [
"GPIO",
"时钟"
]
},
{
"numero": "16",
"nome": "XTAL_32K_N",
"tipo": "io",
"alimentacao": ["VDDA_PMU", "VBAT"],
"funcoes": [
"GPIO14",
"XTAL_32K_N"
],
"categorias": [
"GPIO",
"时钟"
]
},
{
"numero": "17",
"nome": "CHIP_EN",
"tipo": "analog",
"alimentacao": ["VBAT"],
"funcoes": ["使能芯片"],
"categorias": ["电源"],
"avisos": [
"将该引脚置高将使芯片工作",
"将该引脚置低将禁用芯片工作",
"请勿让该引脚浮空，请使用外部上拉电阻"
]
},
{
"numero": "18",
"nome": "VBAT",
"tipo": "power",
"funcoes": ["模拟域或电池电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "19",
"nome": "VDDA_PMU",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "20",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": ["IO 域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "21",
"nome": "GPIO22",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": ["GPIO22"],
"categorias": ["GPIO"]
},
{
"numero": "22",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO23",
"U0RXD",
"FSPICS1"
],
"categorias": [
"GPIO",
"UART",
"SPI"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "23",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO24",
"U0TXD",
"FSPICS2"
],
"categorias": [
"GPIO",
"UART",
"SPI"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "24",
"nome": "GPIO25",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO24",
"FSPICS3"
],
"categorias": [
"GPIO",
"SPI",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入",
"复位后，该引脚将配置为输入",
"用于控制 JTAG 信号源（详见数据手册第 3.3 节）"
]
},
{
"numero": "25",
"nome": "GPIO26",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO26",
"FSPICS4",
"USB_D-"
],
"categorias": [
"GPIO",
"SPI",
"USB"
],
"avisos": [
"复位后，该引脚将配置为输入",
"默认情况下，该引脚用于 USB Serial/JTAG"
]
},
{
"numero": "26",
"nome": "GPIO27",
"tipo": "io",
"alimentacao": ["VDDPST2"],
"funcoes": [
"GPIO27",
"FSPICS5",
"USB_D+"
],
"categorias": [
"GPIO",
"SPI",
"USB"
],
"avisos": [
"复位后，该引脚将配置为输入并启用 USB 内部上拉",
"默认情况下，该引脚用于 USB Serial/JTAG"
]
},
{
"numero": "27",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "28",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": ["时钟负输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.3.2 节"]
},
{
"numero": "29",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": ["时钟正输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.3.2 节"]
},
{
"numero": "30",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "31",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：3.0V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "32",
"nome": "ANT",
"tipo": "analog",
"funcoes": ["RF 天线连接"],
"categorias": ["天线"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "33",
"nome": "GND",
"tipo": "ground",
"funcoes": ["电路电气参考（地）"],
"categorias": ["GND"]
}
]
data/zh-CN/conexoes/ESP32-P4.json
+1528
View File
File diff suppressed because it is too large. Load diff
data/zh-CN/conexoes/ESP32-S2.json
+1014
View File
File diff suppressed because it is too large. Load diff
data/zh-CN/conexoes/ESP32-S3.json
+1059
View File
File diff suppressed because it is too large. Load diff
data/zh-CN/conexoes/ESP32-S31.json
+956
View File
@@ -0,0 +1,956 @@
[
{
"numero": "1",
"nome": "ANT",
"tipo": "analog",
"funcoes": ["RF 天线连接（Wi-Fi 和 Bluetooth）"],
"categorias": ["天线", "射频"],
"avisos": ["专用于 2.4 GHz 的 RF 引脚。需要 50 欧姆阻抗匹配。"]
},
{
"numero": "2",
"nome": "VDDA3",
"tipo": "power",
"funcoes": ["模拟域电源（3.3V）"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V（3.0V 至 3.6V）。为 RF 和时钟部分供电。"]
},
{
"numero": "3",
"nome": "VDDA4",
"tipo": "power",
"funcoes": ["模拟域电源（3.3V）"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V（3.0V 至 3.6V）。为 RF 和时钟部分供电。"]
},
{
"numero": "4",
"nome": "CHIP_PU",
"tipo": "analog",
"funcoes": ["使能芯片（上电/复位）"],
"categorias": ["电源"],
"avisos": [
"高电平有效。拉高以启动芯片。",
"请勿让该引脚浮空。建议使用外部 RC 延迟电路以实现稳定启动。"
]
},
{
"numero": "5",
"nome": "GPIO0",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO0",
"XTAL_32K_N"
],
"categorias": [
"GPIO",
"时钟"
],
"avisos": ["低功耗时钟引脚。可连接外部 32.768 kHz 晶振（N 引脚）。"]
},
{
"numero": "6",
"nome": "GPIO1",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO1",
"XTAL_32K_P",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"时钟",
"ADC"
],
"avisos": ["多功能引脚。外部 32.768 kHz 晶振（P 引脚）和 ADC1 通道 0 模拟输入。"]
},
{
"numero": "7",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO2",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 1 模拟输入引脚。"]
},
{
"numero": "8",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO3",
"ADC1_CH2"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 2 模拟输入引脚。"]
},
{
"numero": "9",
"nome": "GPIO4",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO4",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 3 模拟输入引脚。"]
},
{
"numero": "10",
"nome": "GPIO5",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO5",
"ADC1_CH4"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 4 模拟输入引脚。"]
},
{
"numero": "11",
"nome": "VDDPST_1",
"tipo": "power",
"funcoes": ["域 1 的 I/O 电源（3.3V）"],
"categorias": ["电源"],
"avisos": ["建议电压：3.3V。"]
},
{
"numero": "12",
"nome": "GPIO6",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO6",
"ADC1_CH5"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 5 模拟输入引脚。"]
},
{
"numero": "13",
"nome": "GPIO7",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO7",
"ADC1_CH6"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 6 模拟输入引脚。"]
},
{
"numero": "14",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO8",
"ADC1_CH7"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 7 模拟输入引脚。"]
},
{
"numero": "15",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO9",
"ADC1_CH8"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 8 模拟输入引脚。"]
},
{
"numero": "16",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO10",
"ADC1_CH9"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 9 模拟输入引脚。"]
},
{
"numero": "17",
"nome": "GPIO11",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO11",
"ADC1_CH10"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC1 通道 10 模拟输入引脚。"]
},
{
"numero": "18",
"nome": "VREF_TOUCH",
"tipo": "analog",
"funcoes": ["电容触摸引脚的参考电压"],
"categorias": ["触摸"],
"avisos": ["用于电容读取稳定的专用模拟引脚。"]
},
{
"numero": "19",
"nome": "GPIO12",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO12",
"ADC2_CH0"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 0 模拟输入引脚。"]
},
{
"numero": "20",
"nome": "GPIO13",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO13",
"ADC2_CH1"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 1 模拟输入引脚。"]
},
{
"numero": "21",
"nome": "GPIO14",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO14",
"ADC2_CH2"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 2 模拟输入引脚。"]
},
{
"numero": "22",
"nome": "GPIO15",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO15",
"ADC2_CH3"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 3 模拟输入引脚。"]
},
{
"numero": "23",
"nome": "GPIO16",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO16",
"ADC2_CH4"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 4 模拟输入引脚。"]
},
{
"numero": "24",
"nome": "GPIO17",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO17",
"ADC2_CH5"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 5 模拟输入引脚。"]
},
{
"numero": "25",
"nome": "GPIO18",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO18",
"ADC2_CH6"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 6 模拟输入引脚。"]
},
{
"numero": "26",
"nome": "GPIO19",
"tipo": "io",
"alimentacao": ["VDDPST_1"],
"funcoes": [
"GPIO19",
"ADC2_CH7"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["ADC2 通道 7 模拟输入引脚。"]
},
{
"numero": "27",
"nome": "SDIO_DATA0",
"tipo": "io",
"alimentacao": ["VDDPST_SD"],
"funcoes": [
"SDIO_DATA0",
"FSPID"
],
"categorias": [
"SDIO",
"SPI"
],
"avisos": ["高速 SDIO 接口引脚（数据 0）或 SPI2 MOSI。"]
},
{
"numero": "28",
"nome": "SDIO_DATA1",
"tipo": "io",
"alimentacao": ["VDDPST_SD"],
"funcoes": [
"SDIO_DATA1",
"FSPIQ"
],
"categorias": [
"SDIO",
"SPI"
],
"avisos": ["高速 SDIO 接口引脚（数据 1）或 SPI2 MISO。"]
},
{
"numero": "29",
"nome": "SDIO_DATA2",
"tipo": "io",
"alimentacao": ["VDDPST_SD"],
"funcoes": [
"SDIO_DATA2",
"FSPIWP"
],
"categorias": [
"SDIO",
"SPI"
],
"avisos": ["高速 SDIO 接口引脚（数据 2）或 SPI2 Write Protect。"]
},
{
"numero": "30",
"nome": "VDD_PSRAM_1P8_1",
"tipo": "power",
"funcoes": ["封装内集成 PSRAM 的 1.8V 电源"],
"categorias": ["电源"],
"avisos": ["由内部 LDO 生成，为集成 PSRAM 供电。请勿连接外部电源电路。"]
},
{
"numero": "31",
"nome": "SDIO_DATA3",
"tipo": "io",
"alimentacao": ["VDDPST_SD"],
"funcoes": [
"SDIO_DATA3",
"FSPIHD"
],
"categorias": [
"SDIO",
"SPI"
],
"avisos": ["高速 SDIO 接口引脚（数据 3）或 SPI2 Hold。"]
},
{
"numero": "32",
"nome": "SDIO_CLK",
"tipo": "io",
"alimentacao": ["VDDPST_SD"],
"funcoes": [
"SDIO_CLK",
"FSPICLK"
],
"categorias": [
"SDIO",
"SPI"
],
"avisos": ["高速 SDIO 接口时钟或 SPI2 Clock。"]
},
{
"numero": "33",
"nome": "SDIO_CMD",
"tipo": "io",
"alimentacao": ["VDDPST_SD"],
"funcoes": [
"SDIO_CMD",
"FSPICS0"
],
"categorias": [
"SDIO",
"SPI"
],
"avisos": ["高速 SDIO 接口命令或 SPI2 Chip Select 0。"]
},
{
"numero": "34",
"nome": "VDD_PSRAM_1P8_2",
"tipo": "power",
"funcoes": ["封装内集成 PSRAM 的 1.8V 电源"],
"categorias": ["电源"]
},
{
"numero": "35",
"nome": "VDD_LDO_1P8",
"tipo": "power",
"funcoes": ["1.8V LDO 输入/输出引脚"],
"categorias": ["电源"]
},
{
"numero": "36",
"nome": "SPICS",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": ["SPICS"],
"categorias": ["SPI"],
"avisos": ["外部或内部 SPI Flash 的专用片选。"]
},
{
"numero": "37",
"nome": "SPIQ",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": ["SPIQ"],
"categorias": ["SPI"],
"avisos": ["外部或内部 SPI Flash 的专用数据 Q（MISO）。"]
},
{
"numero": "38",
"nome": "SPIWP",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": ["SPIWP"],
"categorias": ["SPI"],
"avisos": ["外部或内部 SPI Flash 的专用 Write Protect。"]
},
{
"numero": "39",
"nome": "VDD_SPI",
"tipo": "power",
"funcoes": ["SPI Flash 接口的专用电源电压"],
"categorias": ["电源"],
"avisos": ["典型电压：内部生成的 3.3V 或 1.8V。"]
},
{
"numero": "40",
"nome": "SPIHD",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": ["SPIHD"],
"categorias": ["SPI"],
"avisos": ["外部或内部 SPI Flash 的专用 Hold。"]
},
{
"numero": "41",
"nome": "SPICLK",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": ["SPICLK"],
"categorias": ["SPI"],
"avisos": ["外部或内部 SPI Flash 的专用时钟。"]
},
{
"numero": "42",
"nome": "SPID",
"tipo": "io",
"alimentacao": ["VDD_SPI"],
"funcoes": ["SPID"],
"categorias": ["SPI"],
"avisos": ["外部或内部 SPI Flash 的专用数据 D（MOSI）。"]
},
{
"numero": "43",
"nome": "VCCA/VDDPST_2",
"tipo": "power",
"funcoes": ["域 2 的模拟和数字电源（3.3V）"],
"categorias": ["电源"]
},
{
"numero": "44",
"nome": "USB_DP",
"tipo": "analog",
"funcoes": ["集成 USB Serial/JTAG 收发器的正引脚"],
"categorias": ["USB"],
"avisos": ["USB D+。具有内部硬件上拉。"]
},
{
"numero": "45",
"nome": "USB_DM",
"tipo": "analog",
"funcoes": ["集成 USB Serial/JTAG 收发器的负引脚"],
"categorias": ["USB"],
"avisos": ["USB D-。"]
},
{
"numero": "46",
"nome": "GPIO33",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO33",
"ADC2_CH8"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["多功能引脚：GPIO33 和 ADC2 通道 8。"]
},
{
"numero": "47",
"nome": "GPIO34",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO34",
"ADC2_CH9"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": ["多功能引脚：GPIO34 和 ADC2 通道 9。"]
},
{
"numero": "48",
"nome": "GPIO35",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO35",
"ADC2_CH10"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "49",
"nome": "GPIO36",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO36",
"ADC2_CH11"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "50",
"nome": "GPIO37",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO37",
"ADC2_CH12"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "51",
"nome": "GPIO38",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO38",
"ADC2_CH13"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "52",
"nome": "GPIO39",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO39",
"ADC2_CH14"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "53",
"nome": "GPIO40",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO40",
"ADC2_CH15"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "54",
"nome": "VDDPST_3",
"tipo": "power",
"funcoes": ["域 3 的 I/O 电源（3.3V）"],
"categorias": ["电源"]
},
{
"numero": "55",
"nome": "GPIO42",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO42",
"ADC2_CH16"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "56",
"nome": "GPIO43",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO43",
"ADC2_CH17"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "57",
"nome": "GPIO44",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO44",
"ADC2_CH18"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "58",
"nome": "GPIO45",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO45",
"ADC2_CH19"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "59",
"nome": "GPIO46",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO46",
"ADC2_CH20"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "60",
"nome": "GPIO47",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": [
"GPIO47",
"ADC2_CH21"
],
"categorias": [
"GPIO",
"ADC"
]
},
{
"numero": "61",
"nome": "GPIO48",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": ["GPIO48"],
"categorias": ["GPIO"]
},
{
"numero": "62",
"nome": "GPIO49",
"tipo": "io",
"alimentacao": ["VDDPST_3"],
"funcoes": ["GPIO49"],
"categorias": ["GPIO"]
},
{
"numero": "63",
"nome": "VREF_ADC",
"tipo": "analog",
"funcoes": ["用于 ADC 校准的外部稳定参考电压"],
"categorias": ["电源", "ADC"],
"avisos": ["用于模数转换器精确校准的专用模拟引脚。"]
},
{
"numero": "64",
"nome": "VDDPST_4",
"tipo": "power",
"funcoes": ["域 4 的 I/O 电源（3.3V）"],
"categorias": ["电源"]
},
{
"numero": "65",
"nome": "GPIO50",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO50"],
"categorias": ["GPIO"]
},
{
"numero": "66",
"nome": "GPIO51",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO51"],
"categorias": ["GPIO"]
},
{
"numero": "67",
"nome": "GPIO52",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO52"],
"categorias": ["GPIO"]
},
{
"numero": "68",
"nome": "GPIO53",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO53"],
"categorias": ["GPIO"]
},
{
"numero": "69",
"nome": "GPIO54",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": [
"GPIO54",
"MTDO"
],
"categorias": [
"GPIO",
"JTAG"
],
"avisos": ["多功能引脚：JTAG MTDO。"]
},
{
"numero": "70",
"nome": "GPIO55",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": [
"GPIO55",
"MTCK"
],
"categorias": [
"GPIO",
"JTAG"
],
"avisos": ["多功能引脚：JTAG MTCK。"]
},
{
"numero": "71",
"nome": "GPIO56",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": [
"GPIO56",
"MTDI"
],
"categorias": [
"GPIO",
"JTAG"
],
"avisos": ["多功能引脚：JTAG MTDI。"]
},
{
"numero": "72",
"nome": "GPIO57",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": [
"GPIO57",
"MTMS"
],
"categorias": [
"GPIO",
"JTAG"
],
"avisos": ["多功能引脚：JTAG MTMS。"]
},
{
"numero": "73",
"nome": "GPIO58",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO58"],
"categorias": ["GPIO"]
},
{
"numero": "74",
"nome": "GPIO59",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO59"],
"categorias": ["GPIO"]
},
{
"numero": "75",
"nome": "GPIO60",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO60"],
"categorias": ["GPIO", "启动配置"],
"avisos": [
"启动配置（Strapping）引脚（与 GPIO61 配合）。",
"默认启用内部上拉。"
]
},
{
"numero": "76",
"nome": "GPIO61",
"tipo": "io",
"alimentacao": ["VDDPST_4"],
"funcoes": ["GPIO61"],
"categorias": ["GPIO", "启动配置"],
"avisos": [
"用于启动选择的主 Strapping 引脚。",
"默认启用内部上拉。复位时高电平（1）启用 SPI Boot。低电平（0）强制进入 Download 模式。"
]
},
{
"numero": "77",
"nome": "VDDA1",
"tipo": "power",
"funcoes": ["3.3V 模拟域电源"],
"categorias": ["电源"]
},
{
"numero": "78",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": ["高速外部晶振连接（N 输出）"],
"categorias": ["时钟"]
},
{
"numero": "79",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": ["高速外部晶振连接（P 输入）"],
"categorias": ["时钟"]
},
{
"numero": "80",
"nome": "VDDA2",
"tipo": "power",
"funcoes": ["3.3V 模拟域电源"],
"categorias": ["电源"]
},
{
"numero": "81",
"nome": "GND",
"tipo": "power",
"funcoes": ["中心接地焊盘（Exposed Pad）"],
"categorias": ["电源"],
"avisos": ["应正确焊接至 PCB 接地平面（GND），以实现稳定的 RF 控制和散热。"]
}
]
data/zh-CN/conexoes/ESP32.json
+964
View File
@@ -0,0 +1,964 @@
[
{
"numero": "1",
"nome": "VDDA",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：2.3V 或 3.0V",
"建议最大电压：3.6V",
"对于集成 Flash 或 PSRAM 的芯片，建议最低电压为 3.0V",
"对于未集成 Flash 或 PSRAM 的芯片，建议最低电压为 2.3V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "2",
"nome": "LNA_IN",
"tipo": "analog",
"alimentação": ["VDD3P3"],
"funcoes": ["Wi-Fi 和 Bluetooth 接收机的低噪声放大器（LNA）输入"],
"categorias": ["天线"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "3",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：2.3V 或 3.0V",
"建议最大电压：3.6V",
"对于集成 Flash 或 PSRAM 的芯片，建议最低电压为 3.0V",
"对于未集成 Flash 或 PSRAM 的芯片，建议最低电压为 2.3V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "4",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：2.3V 或 3.0V",
"建议最大电压：3.6V",
"对于集成 Flash 或 PSRAM 的芯片，建议最低电压为 3.0V",
"对于未集成 Flash 或 PSRAM 的芯片，建议最低电压为 2.3V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "5",
"nome": "SENSOR_VP",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO36",
"RTC_GPIO0",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"低功耗",
"ADC"
],
"avisos": ["该引脚仅为输入（input only）"]
},
{
"numero": "6",
"nome": "SENSOR_CAPP",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO37",
"RTC_GPIO1",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"低功耗",
"ADC"
],
"avisos": ["该引脚仅为输入（input only）"]
},
{
"numero": "7",
"nome": "SENSOR_CAPN",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO38",
"RTC_GPIO2",
"ADC1_CH2"
],
"categorias": [
"GPIO",
"低功耗",
"ADC"
],
"avisos": ["该引脚仅为输入（input only）"]
},
{
"numero": "8",
"nome": "SENSOR_VN",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO39",
"RTC_GPIO3",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"低功耗",
"ADC"
],
"avisos": ["该引脚仅为输入（input only）"]
},
{
"numero": "9",
"nome": "CHIP_PU",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": ["使能芯片"],
"categorias": ["电源"],
"avisos": [
"将该引脚置高将使芯片工作",
"将该引脚置低将禁用芯片工作",
"请勿让该引脚浮空，请使用外部上拉电阻",
"有关模拟引脚的更多详情，详见数据手册第 2.4 节"
]
},
{
"numero": "10",
"nome": "VDET_1",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO34",
"RTC_GPIO4",
"ADC1_CH6"
],
"categorias": [
"GPIO",
"低功耗",
"ADC"
],
"avisos": ["该引脚仅为输入（input only）"]
},
{
"numero": "11",
"nome": "VDET_2",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO35",
"RTC_GPIO5",
"ADC1_CH7"
],
"categorias": [
"GPIO",
"低功耗",
"ADC"
],
"avisos": ["该引脚仅为输入（input only）"]
},
{
"numero": "12",
"nome": "32K_XP",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO32",
"RTC_GPIO9",
"ADC1_CH4",
"TOUCH9",
"XTAL_32K_P"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"时钟"
]
},
{
"numero": "13",
"nome": "32K_XN",
"tipo": "analog",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO33",
"RTC_GPIO8",
"ADC1_CH5",
"TOUCH8",
"XTAL_32K_N"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"时钟"
]
},
{
"numero": "14",
"nome": "GPIO25",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO25",
"RTC_GPIO6",
"ADC2_CH8",
"DAC_1",
"EMAC_RXD0"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"DAC",
"Ethernet"
]
},
{
"numero": "15",
"nome": "GPIO26",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO26",
"RTC_GPIO7",
"ADC2_CH9",
"DAC_2",
"EMAC_RXD1"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"DAC",
"Ethernet"
]
},
{
"numero": "16",
"nome": "GPIO27",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO27",
"RTC_GPIO17",
"ADC2_CH7",
"TOUCH7",
"EMAC_RXDV"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"Ethernet"
]
},
{
"numero": "17",
"nome": "MTMS",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO14",
"RTC_GPIO16",
"ADC2_CH6",
"TOUCH6",
"HSPICLK",
"HS2_CLK",
"SD_CLK",
"EMAC_TXD2",
"MTMS"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"SPI",
"SD",
"Ethernet",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "18",
"nome": "MTDI",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO12",
"RTC_GPIO15",
"ADC2_CH5",
"TOUCH5",
"HSPIQ",
"HS2_DATA2",
"SD_DATA2",
"EMAC_TXD3",
"MTDI"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"SPI",
"SD",
"Ethernet",
"JTAG",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部下拉",
"复位后，该引脚将配置为输入并启用内部下拉",
"用于调试的引脚",
"用于控制 VDD_SDIO（内部 LDO）电压（详见数据手册第 3.2 节）"
]
},
{
"numero": "19",
"nome": "VDD3P3_RTC",
"tipo": "power",
"funcoes": ["低功耗（RTC）域和部分模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：2.3V 或 3.0V",
"建议最大电压：3.6V",
"对于集成 Flash 或 PSRAM 的芯片，建议最低电压为 3.0V",
"对于未集成 Flash 或 PSRAM 的芯片，建议最低电压为 2.3V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "20",
"nome": "MTCK",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO13",
"RTC_GPIO14",
"ADC2_CH4",
"TOUCH4",
"HSPID",
"HS2_DATA3",
"SD_DATA3",
"EMAC_RX_ER",
"MTCK"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"SPI",
"SD",
"Ethernet",
"JTAG"
],
"avisos": [
"复位后，该引脚将配置为输入并启用内部下拉",
"用于调试的引脚"
]
},
{
"numero": "21",
"nome": "MTDO",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO15",
"RTC_GPIO13",
"ADC2_CH3",
"TOUCH3",
"HSPICS0",
"HS2_CMD",
"SD_CMD",
"EMAC_RXD3",
"MTDO",
"I2C_SDA"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"SPI",
"SD",
"Ethernet",
"JTAG",
"I2C",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"I2C_SDA 功能在低功耗（RTC）模式下可用",
"用于调试的引脚",
"用于控制 UART0 上 ROM 消息的显示（详见数据手册第 3.3 节）",
"用于控制 SDIO Slave 时序（详见数据手册第 3.4 节）"
]
},
{
"numero": "22",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO2",
"RTC_GPIO12",
"ADC2_CH2",
"TOUCH2",
"HSPIWP",
"HS2_DATA0",
"SD_DATA0",
"I2C_SCL"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"SPI",
"SD",
"I2C",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部下拉",
"复位后，该引脚将配置为输入并启用内部下拉",
"I2C_SCL 功能在低功耗（RTC）模式下可用",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "23",
"nome": "GPIO0",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO0",
"RTC_GPIO11",
"ADC2_CH1",
"TOUCH1",
"CLC_OUT1",
"EMAC_TX_CLK",
"I2C_SDA"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"时钟",
"Ethernet",
"I2C",
"启动配置"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"I2C_SDA 功能在低功耗（RTC）模式下可用",
"用于控制芯片启动模式（详见数据手册第 3.1 节）"
]
},
{
"numero": "24",
"nome": "GPIO4",
"tipo": "io",
"alimentacao": ["VDD3P3_RTC"],
"funcoes": [
"GPIO4",
"RTC_GPIO10",
"ADC2_CH0",
"TOUCH0",
"HSPIHD",
"HS2_DATA1",
"SD_DATA1",
"EMAC_TX_ER",
"I2C_SCL"
],
"categorias": [
"GPIO",
"低功耗",
"ADC",
"触摸",
"SPI",
"SD",
"Ethernet",
"I2C"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部下拉",
"复位后，该引脚将配置为输入并启用内部下拉",
"I2C_SCL 功能在低功耗（RTC）模式下可用"
]
},
{
"numero": "25",
"nome": "GPIO16",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO16",
"HS1_DATA4",
"U2RXD",
"EMAC_CLK_OUT"
],
"categorias": [
"GPIO",
"SPI",
"UART",
"Ethernet"
],
"avisos": [
"复位后，该引脚将配置为输入",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "26",
"nome": "VDD_SDIO",
"tipo": "power",
"funcoes": ["内部 SDIO 存储（Flash/PSRAM）电源输入/输出"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：2.3V 或 3.0V",
"建议最大电压：3.6V",
"该引脚连接至内部 LDO 输出",
"如果直接连接到 VDD3P3_RTC，内部 LDO 将自动禁用",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "27",
"nome": "GPIO17",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO17",
"HS1_DATA5",
"U2TXD",
"EMAC_CLK_OUT_180"
],
"categorias": [
"GPIO",
"SPI",
"UART",
"Ethernet"
],
"avisos": [
"复位后，该引脚将配置为输入",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "28",
"nome": "SD_DATA_2",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO9",
"SPIHD",
"HS1_DATA2",
"SD_DATA2",
"U1RXD"
],
"categorias": [
"GPIO",
"SPI",
"SD",
"UART"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "29",
"nome": "SD_DATA_3",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO10",
"SPIWP",
"HS1_DATA3",
"SD_DATA3",
"U1TXD"
],
"categorias": [
"GPIO",
"SPI",
"SD",
"UART"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "30",
"nome": "SD_CMD",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO11",
"SPICS0",
"HS1_CMD",
"SD_CMD",
"U1RTS"
],
"categorias": [
"GPIO",
"SPI",
"SD",
"UART"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "31",
"nome": "SD_CLK",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO6",
"SPICLK",
"HS1_CLK",
"SD_CLK",
"U1CTS"
],
"categorias": [
"GPIO",
"SPI",
"SD",
"UART"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "32",
"nome": "SD_DATA_0",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO7",
"SPIQ",
"HS1_DATA0",
"SD_DATA0",
"U2RTS"
],
"categorias": [
"GPIO",
"SPI",
"SD",
"UART"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "33",
"nome": "SD_DATA_1",
"tipo": "io",
"alimentacao": ["VDD_SDIO"],
"funcoes": [
"GPIO8",
"SPID",
"HS1_DATA1",
"SD_DATA1",
"U2CTS"
],
"categorias": [
"GPIO",
"SPI",
"SD",
"UART"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"专用于内部 Flash/PSRAM 通信，不建议用于其他功能"
]
},
{
"numero": "34",
"nome": "GPIO5",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO5",
"VSPICS0",
"HS1_DATA6",
"EMAC_RX_CLK"
],
"categorias": [
"GPIO",
"SPI",
"Ethernet"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于控制 SDIO Slave 时序（详见数据手册第 3.4 节）"
]
},
{
"numero": "35",
"nome": "GPIO18",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO18",
"VSPICLK",
"HS1_DATA7"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "36",
"nome": "GPIO23",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO23",
"VSPID",
"HS1_STROBE"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "37",
"nome": "VDD3P3_CPU",
"tipo": "power",
"funcoes": ["数字域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：1.8V",
"建议最大电压：3.6V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "38",
"nome": "GPIO19",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO19",
"VSPIQ",
"U0CTS",
"EMAC_TXD0"
],
"categorias": [
"GPIO",
"SPI",
"UART",
"Ethernet"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "39",
"nome": "GPIO22",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO22",
"VSPIWP",
"U0RTS",
"EMAC_TXD1"
],
"categorias": [
"GPIO",
"SPI",
"UART",
"Ethernet"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "40",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO3",
"CLK_OUT2",
"U0RXD"
],
"categorias": [
"GPIO",
"时钟",
"UART"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "41",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO1",
"CLK_OUT3",
"U0TXD",
"EMAC_RXD2"
],
"categorias": [
"GPIO",
"时钟",
"UART",
"Ethernet"
],
"avisos": [
"复位期间，该引脚将配置为输入并启用内部上拉",
"复位后，该引脚将配置为输入并启用内部上拉",
"用于调试的引脚"
]
},
{
"numero": "42",
"nome": "GPIO21",
"tipo": "io",
"alimentacao": ["VDD3P3_CPU"],
"funcoes": [
"GPIO21",
"VSPIHD",
"EMAC_TX_EN"
],
"categorias": [
"GPIO",
"SPI",
"Ethernet"
],
"avisos": ["复位后，该引脚将配置为输入"]
},
{
"numero": "43",
"nome": "VDDA",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：2.3V 或 3.0V",
"建议最大电压：3.6V",
"对于集成 Flash 或 PSRAM 的芯片，建议最低电压为 3.0V",
"对于未集成 Flash 或 PSRAM 的芯片，建议最低电压为 2.3V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "44",
"nome": "XTAL_N",
"tipo": "analog",
"alimentação": ["VDDA"],
"funcoes": ["时钟负输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "45",
"nome": "XTAL_P",
"tipo": "analog",
"alimentação": ["VDDA"],
"funcoes": ["时钟正输入/输出"],
"categorias": ["时钟"],
"avisos": ["有关模拟引脚的更多详情，详见数据手册第 2.4 节"]
},
{
"numero": "46",
"nome": "VDDA",
"tipo": "power",
"funcoes": ["模拟域电源输入"],
"categorias": ["电源"],
"avisos": [
"建议电压：3.3V",
"建议最小电压：2.3V 或 3.0V",
"建议最大电压：3.6V",
"对于集成 Flash 或 PSRAM 的芯片，建议最低电压为 3.0V",
"对于未集成 Flash 或 PSRAM 的芯片，建议最低电压为 2.3V",
"有关芯片电源的更多详情，详见数据手册第 2.5 节"
]
},
{
"numero": "47",
"nome": "CAP2",
"tipo": "analog",
"alimentação": ["VDDA"],
"funcoes": ["滤波电容"],
"categorias": ["电源"],
"avisos": [
"将一个 3.3nF（10%）电容和一个 20kΩ 电阻与 CAP1 并联",
"详见数据手册第 2.2 节"
]
},
{
"numero": "48",
"nome": "CAP1",
"tipo": "analog",
"alimentação": ["VDDA"],
"funcoes": ["滤波电容"],
"categorias": ["电源"],
"avisos": [
"将一个 10nF 电容与 GND 串联",
"详见数据手册第 2.2 节"
]
},
{
"numero": "49",
"nome": "GND",
"tipo": "ground",
"funcoes": ["电路电气参考（地）"],
"categorias": ["GND"]
}
]
data/zh-CN/frameworks.json
+394
View File
@@ -0,0 +1,394 @@
{
"ESP-IDF": {
"nome": "ESP-IDF",
"icone": "⚙️",
"nome_completo": "Espressif IoT Development Framework",
"descricao": "乐鑫官方原生框架，适用于所有 ESP32 SoC。基于多核 FreeRTOS 和 CMake，可完全控制芯片、外设、射频和模块化组件架构。",
"linguagem": "C / C++",
"tipo": "官方基础框架",
"funcao_principal": "工业级高性能开发，可直接访问寄存器、实时 RTOS 和完整协议栈",
"caracteristicas": [
"实时操作系统（FreeRTOS SMP 多核）",
"通过 idf_component.yml 原生支持 ESP Component Registry",
"完整的 Wi-Fi 4/6、BLE 5.x、Zigbee 和 Thread 连接协议栈",
"支持所有 SoC（ESP32、S2、S3、C2、C3、C6、H2、P4）",
"高级电源管理和 Deep Sleep 模式",
"强大的安全性：Secure Boot v2、Flash Encryption 和 Crypto HW",
"带自动回滚的加密 OTA 更新",
"现代 Clang/GCC 工具链，支持 C++23 和 JTAG OpenOCD 调试"
],
"casos_uso": [
"商业和工业 IoT 产品",
"对电池和功耗有严格要求的设备",
"带中断控制的实时应用",
"使用硬件加密的安全系统",
"高性能多协议网关"
],
"exemplo": "/exemplos/esp-idf.c",
"exemplos": "https://github.com/espressif/esp-idf/tree/master/examples",
"documentacao": "https://docs.espressif.com/projects/esp-idf/en/latest/",
"repositorio": "https://github.com/espressif/esp-idf",
"cor": "#E74C3C"
},
"ESP-RainMaker": {
"nome": "ESP-RainMaker",
"icone": "☁️",
"nome_completo": "ESP RainMaker AIoT Cloud Platform",
"descricao": "乐鑫面向联网产品的完整云和固件平台。无需从零开发后端或移动应用即可创建 IoT 设备。",
"linguagem": "C / C++",
"tipo": "云端与 AIoT 框架",
"funcao_principal": "借助移动应用（iOS/Android）、AWS Serverless 云和语音控制（Alexa/Google Home）加速智能产品构建",
"caracteristicas": [
"通过官方应用辅助进行 Wi-Fi 和 BLE 配网",
"根据固件参数在应用中动态生成界面",
"原生集成 Amazon Alexa 和 Google Assistant",
"同时支持本地控制（通过 mDNS/HTTP 的 Local Control）和云端",
"用于设备群和 OTA 管理的管理面板（RainMaker Dashboard）",
"原生兼容 Matter 节点和设备桥接",
"通过 ESP Component Registry 集成的库（espressif/esp_rainmaker）"
],
"casos_uso": [
"面向终端消费者的家电和智能照明",
"缩短上市时间（Time-to-Market）的 IoT 产品",
"需要移动应用控制且无需自建基础设施成本的设备",
"带集中式 OTA 更新的远程监控系统"
],
"exemplo": "/exemplos/esp-rainmaker.c",
"exemplos": "https://github.com/espressif/esp-rainmaker/tree/master/examples",
"documentacao": "https://rainmaker.espressif.com/docs/",
"repositorio": "https://github.com/espressif/esp-rainmaker",
"cor": "#3B82F6"
},
"ESP-Matter": {
"nome": "ESP-Matter",
"icone": "🏠",
"nome_completo": "ESP Matter SDK",
"descricao": "乐鑫面向 Matter 通用智能家居标准（原 Project CHIP）的官方 SDK。让你的设备可与 Apple HomeKit、Google Home、Amazon Alexa 和 Home Assistant 互操作。",
"linguagem": "C++",
"tipo": "智能家居框架",
"funcao_principal": "开发兼容 Wi-Fi 和 Thread 上统一 Matter 标准的智能设备和桥接",
"caracteristicas": [
"Matter 规范集群的完整实现",
"支持基于 Wi-Fi 和 Thread 的传输（ESP32-H2 和 ESP32-C6 上的 802.15.4）",
"通过 BLE 或 On-Network 简化调试入网",
"同时兼容 Apple Home、Google Home、Alexa 和 SmartThings",
"基于设备认证证书（DAC）的安全机制",
"支持 Matter Bridge（将传统 Zigbee/BLE 设备接入 Matter）",
"直接集成 ESP-IDF 和 ESP Component Registry"
],
"casos_uso": [
"可互操作的灯具、插座、开关和调光器",
"人体存在、温度、湿度和门磁传感器",
"电子锁和窗帘执行器",
"Matter 边界路由器和住宅桥接"
],
"exemplo": "/exemplos/esp-matter.c",
"exemplos": "https://github.com/espressif/esp-matter/tree/main/examples",
"documentacao": "https://docs.espressif.com/projects/esp-matter/en/latest/",
"repositorio": "https://github.com/espressif/esp-matter",
"cor": "#F59E0B"
},
"ESP-ADF": {
"nome": "ESP-ADF",
"icone": "🎵",
"nome_completo": "ESP Audio Development Framework",
"descricao": "面向 ESP32 SoC 的高质量数字音频处理、串流和播放专用框架。",
"linguagem": "C / C++",
"tipo": "音频与语音框架",
"funcao_principal": "创建灵活的音频流水线，包含解码器、网络串流、均衡和声学效果",
"caracteristicas": [
"模块化音频流水线架构（Audio Elements 与 Audio Stream）",
"支持多种编解码器：MP3、AAC、FLAC、WAV、OGG、Opus 和 AMR",
"通过 HTTP、HTTPS、HLS、RTSP 和 WebSockets 进行音频串流",
"支持 Bluetooth A2DP（Sink/Source）和 Bluetooth Handsfree（HFP）",
"声学处理算法（AEC、AGC、NS、参数均衡器）",
"支持 ESP32-LyraT 和 ESP32-S3-Korvo 等专用开发板"
],
"casos_uso": [
"智能音箱和网络收音机",
"对讲机、walkie-talkie 和 VoIP 对讲系统",
"带 PSRAM 的音乐播放器",
"楼宇自动化背景音乐系统"
],
"exemplo": "/exemplos/esp-adf.c",
"exemplos": "https://github.com/espressif/esp-adf/tree/master/examples",
"documentacao": "https://docs.espressif.com/projects/esp-adf/en/latest/",
"repositorio": "https://github.com/espressif/esp-adf",
"cor": "#0284C7"
},
"ESP-SR": {
"nome": "ESP-SR",
"icone": "🎙️",
"nome_completo": "ESP Speech Recognition Framework",
"descricao": "本地语音识别和边缘 AI 音频处理框架，无需互联网连接即可实现语音命令。",
"linguagem": "C / C++",
"tipo": "语音与 AI 框架",
"funcao_principal": "本地语音处理、唤醒词（Wake Word）检测和实时语音命令识别",
"caracteristicas": [
"WakeNet：精确定位本地唤醒词（如 'Hi, ESP' 和自定义词）",
"MultiNet：离线本地识别数百条语音命令，支持葡萄牙语、英语和普通话",
"AFE（音频前端）：回声消除（AEC）、噪声抑制（BSS/NS）和自动增益控制（AGC）",
"支持多个麦克风和定向波束成形（Beamforming）",
"针对 ESP32-S3 和 ESP32-P4 使用 SIMD 向量加速优化",
"组件可在 ESP Component Registry 中获取（espressif/esp-sr）"
],
"casos_uso": [
"100% 离线且保护隐私的语音控制家电",
"语音驱动的智能家居面板",
"互动玩具和教育机器人",
"需要免手操作的医疗和工业设备"
],
"exemplo": "/exemplos/esp-sr.c",
"exemplos": "https://github.com/espressif/esp-sr/tree/master/examples",
"documentacao": "https://docs.espressif.com/projects/esp-sr/en/latest/",
"repositorio": "https://github.com/espressif/esp-sr",
"cor": "#6366F1"
},
"ESP-IoT-Solution": {
"nome": "ESP-IoT-Solution",
"icone": "🧩",
"nome_completo": "ESP-IoT-Solution Driver & Peripheral Suite",
"descricao": "乐鑫官方集合，包含数十个可直接用于生产的驱动、外设组件、触摸屏、传感器和总线协议。",
"linguagem": "C / C++",
"tipo": "外设与驱动库",
"funcao_principal": "加速硬件组件集成（LCD/OLED 屏、环境/IMU 传感器、智能按键、I2C/SPI/Modbus 总线）",
"caracteristicas": [
"完整传感器驱动（温度、湿度、压力、加速度计、光照）",
"高级物理按键、触摸矩阵和旋转编码器管理",
"LCD 和 OLED 显示屏驱动（ST7789、ILI9341、SSD1306）及触摸控制器（FT6X36、GT911）",
"工业 Modbus 协议栈（基于 RS-485 或 TCP 的 Master 和 Slave）",
"步进电机控制和可寻址 LED 驱动（WS2812/SK6812）",
"在 ESP Component Registry 中完全模块化"
],
"casos_uso": [
"带触摸屏和电容按键的人机界面（IHM / HMI）",
"气象站和工业传感器监测",
"通过 RS-485 Modbus 集成的工业自动化设备",
"使用复杂 RGB LED 灯带和矩阵的项目"
],
"exemplo": "/exemplos/esp-iot-solution.c",
"exemplos": "https://github.com/espressif/esp-iot-solution/tree/master/examples",
"documentacao": "https://docs.espressif.com/projects/esp-iot-solution/en/latest/",
"repositorio": "https://github.com/espressif/esp-iot-solution",
"cor": "#10B981"
},
"ESP-NOW": {
"nome": "ESP-NOW & Mesh",
"icone": "📡",
"nome_completo": "ESP-NOW Protocol & Mesh-Lite",
"descricao": "乐鑫开发的超低延迟无线通信协议，工作在 2.4 GHz 频段，无需传统 Wi-Fi 路由器。",
"linguagem": "C / C++",
"tipo": "网络与 Mesh 协议",
"funcao_principal": "数十块 ESP32 开发板之间的点对点消息、广播和轻量网状组网",
"caracteristicas": [
"无需路由器或接入点（AP）的直接通信",
"毫秒级传输延迟和即时连接",
"使用 AES-128 密钥的原生加密",
"极其节能，非常适合电池供电节点",
"支持遥控器配对和向多个节点广播",
"支持 Mesh-Lite 进行带 IP 跳转的网状路由"
],
"casos_uso": [
"无线遥控器和电池供电墙壁开关",
"田间分布式农业传感器网络",
"舞台灯光和无人机的实时同步",
"住宅报警器和紧急按钮"
],
"exemplo": "/exemplos/esp-now.c",
"exemplos": "https://github.com/espressif/esp-now/tree/master/examples",
"documentacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/network/esp_now.html",
"repositorio": "https://github.com/espressif/esp-now",
"cor": "#8B5CF6"
},
"ESP-Zigbee-SDK": {
"nome": "ESP-Zigbee-SDK",
"icone": "🐝",
"nome_completo": "ESP Zigbee SDK (ZCL & ZBOSS)",
"descricao": "官方 SDK，用于在支持 802.15.4 射频的 ESP32 SoC（如 ESP32-H2 和 ESP32-C6）上开发 Zigbee 3.0 节点、路由器和协调器。",
"linguagem": "C / C++",
"tipo": "智能家居与 Mesh",
"funcao_principal": "构建基于 Zigbee 3.0 标准的超轻量、超低功耗楼宇自动化网络",
"caracteristicas": [
"基于 ZBOSS 协议栈的 Zigbee 3.0 认证实现",
"支持协调器（ZC）、路由器（ZR）和终端设备（ZED / Sleepy End Device）角色",
"丰富的 ZCL 集群库（开/关、亮度、颜色、温度、电能计量）",
"深度睡眠期间功耗仅为微安级，传感器可依靠电池运行多年",
"原生兼容 Zigbee 桥接（Home Assistant ZHA/Zigbee2MQTT、Philips Hue）"
],
"casos_uso": [
"由纽扣电池供电的人体存在、门窗和漏水传感器",
"Zigbee 3.0 网络中的智能灯和插座",
"Zigbee 转 Wi-Fi 或 Zigbee 转 Ethernet 网关和桥接",
"高节点密度的商业楼宇自动化"
],
"exemplo": "/exemplos/esp-zigbee.c",
"exemplos": "https://github.com/espressif/esp-zigbee-sdk/tree/main/examples",
"documentacao": "https://docs.espressif.com/projects/esp-zigbee-sdk/en/latest/",
"repositorio": "https://github.com/espressif/esp-zigbee-sdk",
"cor": "#EC4899"
},
"ESP-WHO": {
"nome": "ESP-WHO",
"icone": "📷",
"nome_completo": "ESP Image Processing & Vision Framework",
"descricao": "乐鑫面向边缘图像处理和计算机视觉（Edge Vision）的框架，可连接 ESP32 摄像头。",
"linguagem": "C / C++",
"tipo": "计算机视觉与 AI",
"funcao_principal": "人脸检测、生物识别、人体检测和视频流处理",
"caracteristicas": [
"实时人脸检测和人脸关键点（Landmarks）提取",
"使用已注册用户数据库的本地人脸识别",
"人体存在检测和人数统计（Human Detection）",
"针对 ESP32-S3 和 ESP32-P4 使用 AI 向量指令优化",
"支持 DVP 和 MIPI-CSI 摄像头传感器（OV2640、OV3660、OV5640、SC030IOT）"
],
"casos_uso": [
"人脸生物识别门禁",
"智能门铃和安全摄像头（Smart Doorbells）",
"房间和办公室占用智能传感器",
"人体跟随机器人和互动玩具"
],
"exemplo": "/exemplos/esp-who.c",
"exemplos": "https://github.com/espressif/esp-who/tree/master/examples",
"documentacao": "https://github.com/espressif/esp-who",
"repositorio": "https://github.com/espressif/esp-who",
"cor": "#F97316"
},
"ESP-NN": {
"nome": "ESP-NN",
"icone": "🧠",
"nome_completo": "ESP Neural Network Acceleration Library",
"descricao": "针对 ESP32 芯片 Xtensa 和 RISC-V 架构高度优化的神经网络内核与运算库。",
"linguagem": "C / C++",
"tipo": "专用 AI 库",
"funcao_principal": "利用向量 SIMD 指令，对深度神经网络进行 INT8 和 INT16 量化推理加速",
"caracteristicas": [
"优化运算：2D 卷积、Depthwise Conv、Fully Connected 和 Pooling",
"官方加速后端，集成 TensorFlow Lite for Microcontrollers（TFLM）",
"高效的 8 位和 16 位量化，大幅降低 RAM 和 Flash 占用",
"在 ESP32-S3 和 ESP32-P4 上利用专用向量指令实现极致加速",
"无实时操作系统开销的执行"
],
"casos_uso": [
"音频分类和工业振动信号分析（预测性维护）",
"使用 TinyML 模型进行传感器异常检测",
"通过 IMU 进行手势识别",
"微控制器上的超轻量计算机视觉"
],
"exemplo": "/exemplos/esp-nn.c",
"exemplos": "https://github.com/espressif/esp-nn/tree/master/test_app",
"documentacao": "https://github.com/espressif/esp-nn",
"repositorio": "https://github.com/espressif/esp-nn",
"cor": "#14B8A6"
},
"ESP-DSP": {
"nome": "ESP-DSP",
"icone": "📊",
"nome_completo": "ESP Digital Signal Processing Library",
"descricao": "面向 ESP32 系列的官方数字信号处理库，提供硬件加速的数学算法。",
"linguagem": "C / C++",
"tipo": "专用信号处理库",
"funcao_principal": "以最高速度执行 FFT、变换、数字滤波和矩阵运算等繁重数学计算",
"caracteristicas": [
"以汇编优化的快速傅里叶变换（实数和复数 FFT）",
"IIR、FIR 数字滤波器和卡尔曼估计器",
"矩阵、向量和标量积运算",
"支持浮点数和定点数（Radix-2 和 Radix-4）",
"针对 Xtensa 双核和 RISC-V 架构的定制优化"
],
"casos_uso": [
"实时音频和振动频谱分析",
"生物医学（ECG/EMG）和工业传感器的抗噪滤波器",
"高精度电机控制和 FOC 算法",
"边缘端数据压缩与编码"
],
"exemplo": "/exemplos/esp-dsp.c",
"exemplos": "https://github.com/espressif/esp-dsp/tree/master/examples",
"documentacao": "https://docs.espressif.com/projects/esp-dsp/en/latest/",
"repositorio": "https://github.com/espressif/esp-dsp",
"cor": "#A855F7"
},
"Rust-ESP": {
"nome": "Rust on ESP32",
"icone": "🦀",
"nome_completo": "ESP-RS Rust Ecosystem for ESP32",
"descricao": "面向 ESP32 系列的现代 Rust 语言开发生态，兼具内存安全（Memory Safety）、稳健并发和高性能。",
"linguagem": "Rust",
"tipo": "现代语言与框架",
"funcao_principal": "安全高性能固件开发，既支持裸机模式（通过 esp-hal 使用 no_std），也支持完整协议栈（通过 esp-idf-svc 使用 std）",
"caracteristicas": [
"裸机 `no_std` 模式配合 `esp-hal` 库：无 RTOS 的完全控制和超快启动",
"`std` 模式配合 `esp-idf-svc`：访问 Rust 标准库、Wi-Fi、BLE、HTTP、MQTT 和线程",
"在编译期保证防止内存损坏和 Data Race",
"支持 Xtensa（ESP32、S2、S3）和原生 RISC-V（C2、C3、C6、H2、P4）目标",
"与 `embedded-hal` crate 生态集成，并使用 `embassy` 的 async/await",
"官方工具：用于烧录和串口监视的 `espflash`，以及用于模板的 `esp-generate`"
],
"casos_uso": [
"不允许内存故障（Null Pointer、Buffer Overflow）的关键系统",
"具有简洁异步并发的现代 IoT 应用",
"需要高安全级别的工业设备",
"现代机器人和仪器仪表项目"
],
"exemplo": "/exemplos/rust-esp.rs",
"exemplos": "https://github.com/esp-rs/esp-hal/tree/main/examples",
"documentacao": "https://esp-rs.github.io/book/",
"repositorio": "https://github.com/esp-rs",
"cor": "#E44D26"
},
"Arduino": {
"nome": "Arduino Core",
"icone": "🛠️",
"nome_completo": "Arduino Core for ESP32",
"descricao": "ESP-IDF 上的 Arduino 框架官方实现（3.x+ 版本基于 ESP-IDF v5.1+），兼具极高易用性和 ESP32 高级特性。",
"linguagem": "C++",
"tipo": "热门替代框架",
"funcao_principal": "利用庞大的 Arduino 库生态进行快速原型设计、教育项目和加速开发",
"caracteristicas": [
"经典 `setup()` 和 `loop()` 语法，兼容数十万个库",
"作为官方 ESP-IDF 上的 FreeRTOS 任务运行",
"完整支持 Wi-Fi、Bluetooth Classic/BLE、WebServer 和 WebSockets",
"兼容 Arduino IDE 2.x、PlatformIO 和 VS Code",
"更新支持所有主流 SoC（ESP32、S2、S3、C3、C6）",
"需要时可访问 ESP-IDF 原生功能"
],
"casos_uso": [
"快速原型设计和概念验证（PoC）",
"教育、创客和学术项目",
"带仪表盘的简单 IoT 系统（Blynk、Adafruit IO、ThingSpeak）",
"业余机器人和 DIY 家庭自动化"
],
"exemplo": "/exemplos/arduino.ino",
"exemplos": "https://github.com/espressif/arduino-esp32/tree/master/docs/en/tutorials",
"documentacao": "https://docs.espressif.com/projects/arduino-esp32/en/latest/",
"repositorio": "https://github.com/espressif/arduino-esp32",
"cor": "#00979D"
},
"MicroPython": {
"nome": "MicroPython",
"icone": "🐍",
"nome_completo": "MicroPython for ESP32",
"descricao": "精简高效的 Python 3 实现，针对 ESP32 CPU 直接运行优化，并提供实时解释器。",
"linguagem": "Python",
"tipo": "动态语言与解释器",
"funcao_principal": "使用 Python 进行交互式开发和敏捷原型设计，提供交互式 REPL 控制台和即时硬件操作",
"caracteristicas": [
"完整的 Python 3 解释器，可编译为 RAM 中的字节码",
"通过串口的交互式 REPL 控制台和通过 Wi-Fi 的 WebREPL",
"集成文件系统（LittleFS / FAT），无需重新编译即可上传 `.py` 脚本",
"原生模块 `machine`、`network`、`bluetooth`、`espnow` 和 `asyncio`",
"非常适合用真实硬件教授编程和算法"
],
"casos_uso": [
"实体计算教学和大学实验室",
"敏捷原型设计和传感器快速台架测试",
"台架测试自动化脚本",
"IoT 数据采集实验应用"
],
"exemplo": "/exemplos/micropython.py",
"exemplos": "https://github.com/micropython/micropython/tree/master/examples",
"documentacao": "https://docs.micropython.org/en/latest/esp32/",
"repositorio": "https://github.com/micropython/micropython",
"cor": "#2B2B2B"
}
}
data/zh-CN/series.json
+732
View File
@@ -0,0 +1,732 @@
{
"ESP32": {
"nome_completo": "ESP32（经典版）",
"icone": "🔷",
"descricao": "初代型号，双核处理器，外设丰富",
"arquitetura": "Xtensa® LX6 32 位双核",
"nucleos": "1（单核）或 2（双核）",
"frequencia": "最高 240 MHz",
"coprocessador_ulp": "是",
"seguranca": {
"aes": "AES-128/192/256",
"sha": "SHA-1/256/384/512",
"rsa": "是（RSA/MPI 最高 4096 位）",
"ecc": "否",
"ecdsa": "否",
"hmac": "否",
"assinatura_digital": "否",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "是（AES-256，旧方案）",
"secure_boot": "V1（AES，旧方案）；自 v3.0 版本（ECO3）起为 V2（RSA-3072、RSA-PSS）",
"protecao_dpa": "否"
},
"wifi": "IEEE 802.11 b/g/n（2.4 GHz，最高 150 Mbps）",
"bluetooth": "Bluetooth 4.2 BR/EDR（经典蓝牙）和 Bluetooth LE（双模）",
"ethernet": "是（集成 Ethernet MAC）",
"memoria_sram": "520 KB",
"memoria_sram_rtc": "16 KB（分为 RTC FAST 和 RTC SLOW）",
"memoria_rom": "448 KB（用于启动和核心功能）",
"flash_externa": "通过 QSPI，最高 16 MB",
"psram_externa": "通过 QSPI，最高 8 MB（特定模组如 WROVER）",
"gpio": "34",
"adc": "2 个 12 位 SAR ADC，最高 18 通道",
"dac": "2 个 8 位 DAC",
"touch": "10 个电容式通道",
"uart": "3",
"spi": "4（SPI、HSPI、VSPI，其中 2 个可用于 Flash/PSRAM）",
"i2c": "2",
"i2s": "2",
"pwm": "LED PWM（最高 16 通道）、电机 PWM",
"ethernet_mac": "1（需外接 PHY）",
"can": "1（CAN 2.0，TWAI®）",
"sdio": "1（SD/SDIO/MMC 主机），1（SDIO/SPI 从机）",
"sensor_hall": "1（内部）",
"sensor_temperatura": "否（2018 年从数据手册中移除；ESP-IDF 无驱动）",
"consumo_energia": {
"active_cpu_240mhz": "30-68 mA",
"active_wifi_tx": "180-240 mA",
"modem_sleep": "20-44 mA",
"light_sleep": "0.8 mA",
"deep_sleep": "10-150 µA",
"hibernation": "5 µA"
},
"temperatura_operacao": "-40°C 至 125°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "外部 JTAG（需调试探针，例如 ESP-PROG）",
"esp_idf_minimo": "自初始版本起（v3.x 及更早）",
"arduino_core": "是（官方核心中有 147 个板卡定义）",
"encapsulamento": "QFN48（6×6 mm）和 QFN48（5×5 mm）",
"modulos": "ESP32-MINI-1、ESP32-PICO-MINI-02、ESP32-PICO-V3、ESP32-PICO-V3-02 等 11 款",
"datasheet": "https://documentation.espressif.com/esp32_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html",
"placa": "/placas/esp32.png",
"cor": "#007bff"
},
"ESP32-S2": {
"nome_completo": "ESP32-S2",
"icone": "🔒",
"descricao": "专注安全与低功耗，具备原生 USB 和家族中唯一 13 位输出的 ADC",
"arquitetura": "Xtensa® LX7 32 位单核",
"nucleos": "1（单核）",
"frequencia": "最高 240 MHz",
"coprocessador_ulp": "是（RISC-V）",
"seguranca": {
"aes": "AES-128/192/256（GCM）",
"sha": "SHA-1/224/256/384/512",
"rsa": "是（RSA/MPI 最高 4096 位）",
"ecc": "否",
"ecdsa": "否",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128/256",
"secure_boot": "V2（RSA-3072）",
"protecao_dpa": "否"
},
"wifi": "IEEE 802.11 b/g/n（2.4 GHz，最高 150 Mbps）",
"bluetooth": "否",
"memoria_sram": "320 KB",
"memoria_sram_rtc": "16 KB",
"memoria_rom": "128 KB",
"flash_externa": "通过 QSPI，最高 1 GB",
"psram_externa": "通过 QSPI/八线 SPI，最高 1 GB",
"gpio": "43",
"adc": "2 个 SAR ADC，最高 20 通道：13 位输出（0–8191，家族中唯一），自 v1.0 版本起有效分辨率为 12 位（勘误 ADC-112）",
"dac": "2 个 8 位 DAC",
"touch": "14 个电容式通道",
"uart": "2",
"spi": "4（SPI0/1 用于 Flash，SPI2/3 用于通用）",
"i2c": "2",
"i2s": "1",
"pwm": "LED PWM（最高 8 通道）",
"usb": "1（USB OTG 1.1 全速）",
"lcd": "8/16 位 LCD 接口",
"camera": "8/16 位 DVP 接口",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active_wifi_tx": "160-310 mA",
"modem_sleep_cpu_160mhz": "14-24 mA",
"light_sleep": "750 µA",
"deep_sleep": "20-190 µA"
},
"temperatura_operacao": "-40°C 至 105°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "外部 JTAG（需调试探针，例如 ESP-PROG）",
"esp_idf_minimo": "v4.2",
"arduino_core": "是（官方核心中有 26 个板卡定义）",
"encapsulamento": "QFN56（7×7 mm）",
"modulos": "ESP32-S2-MINI-1、ESP32-S2-MINI-2、ESP32-S2-SOLO、ESP32-S2-SOLO-2 等 4 款",
"datasheet": "https://documentation.espressif.com/esp32-s2_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-s2_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html",
"placa": "/placas/esp32-s2.png",
"cor": "#28a745"
},
"ESP32-S3": {
"nome_completo": "ESP32-S3",
"icone": "🤖",
"descricao": "双核处理器，集成 AI 和信号处理加速器",
"arquitetura": "Xtensa® LX7 32 位双核",
"nucleos": "2（双核）",
"frequencia": "最高 240 MHz",
"coprocessador_ulp": "是（RISC-V）",
"aceleradores_ia": "是（面向 AI 的向量指令）",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256/384/512",
"rsa": "是（RSA/MPI 最高 4096 位）",
"ecc": "否",
"ecdsa": "否",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128/256",
"secure_boot": "V2（RSA-3072）",
"protecao_dpa": "否"
},
"wifi": "IEEE 802.11 b/g/n（2.4 GHz，最高 150 Mbps）",
"bluetooth": "Bluetooth 5（LE）和 Bluetooth Mesh",
"memoria_sram": "512 KB",
"memoria_sram_rtc": "16 KB",
"memoria_rom": "384 KB",
"flash_externa": "通过 QSPI/八线 SPI，最高 1 GB",
"psram_externa": "通过 QSPI/八线 SPI，最高 1 GB",
"gpio": "45",
"adc": "2 个 12 位 SAR ADC，最高 20 通道",
"dac": "否",
"touch": "14 个电容式通道",
"uart": "3",
"spi": "4（SPI0/1 用于 Flash，SPI2/3 用于通用）",
"i2c": "2",
"i2s": "2",
"pwm": "LED PWM（最高 8 通道）、电机 PWM（6 通道）",
"usb": "1（USB OTG 1.1 全速）+ 1（USB Serial/JTAG）",
"lcd": "8/16 位 RGB LCD 接口",
"camera": "8/16 位 DVP 接口",
"sdio": "1（SD/SDIO/MMC 主机）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active": "78 mW（约 24 mA @3.3V）",
"modem_sleep": "13-42 mA（40-80 MHz，视负载而定）",
"light_sleep": "240 µA（另有 PSRAM 的 40 至 200 µA）",
"deep_sleep": "7 µA"
},
"temperatura_operacao": "-40°C 至 65/85/105°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v4.4",
"arduino_core": "是（官方核心中有 158 个板卡定义）",
"encapsulamento": "QFN56（7×7 mm）",
"modulos": "ESP32-S3-MINI-1、ESP32-S3-WROOM-1、ESP32-S3-WROOM-2",
"datasheet": "https://documentation.espressif.com/esp32-s3_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-s3_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/get-started/index.html",
"placa": "/placas/esp32-s3.png",
"cor": "#fd7e14"
},
"ESP32-S31": {
"nome_completo": "ESP32-S31",
"icone": "🌀",
"descricao": "高性能 320MHz 双核 RISC-V 处理器，支持 Wi-Fi 6、Bluetooth 5.4 和经典蓝牙、Zigbee/Thread、Matter 及 AI 加速",
"arquitetura": "32 位双核 RISC-V（HP）+ RISC-V 单核（LP）",
"nucleos": "2（双核 HP）+ 1（单核 LP）",
"frequencia": "最高 320 MHz",
"coprocessador_ulp": "是（RISC-V，40 MHz LP CPU）",
"aceleradores_ia": "是（自定义 AI 和 DSP 扩展 XespV）",
"seguranca": {
"aes": "AES-128/256（GCM）",
"sha": "SHA-1/224/256/384/512",
"rsa": "是（RSA/MPI 最高 4096 位）",
"ecc": "是（P-192、P-256、P-384）",
"ecdsa": "是（确定性模式，RFC 6979）",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "是",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128/256",
"secure_boot": "V2（RSA-3072）",
"protecao_dpa": "是"
},
"wifi": "Wi-Fi 6（802.11ax）2.4 GHz",
"bluetooth": "Bluetooth 5.4 LE 和经典蓝牙",
"zigbee_thread": "IEEE 802.15.4（Zigbee 3.0、Thread 1.4）",
"matter": "是",
"memoria_sram": "512 KB（HP SRAM）",
"memoria_sram_rtc": "32 KB（LP SRAM）",
"memoria_rom": "320 KB",
"flash_externa": "通过 QSPI，最高 256 MB",
"psram_externa": "16 MB 或 32 MB 八线 DDR，仅限封装内部（NRV16、NRV32）",
"gpio": "60",
"adc": "2 个 12 位 SAR ADC，最高 16 通道",
"dac": "是（2 个 10 位 DAC 和 2 个 12 位 DAC）",
"touch": "14 个电容式通道",
"uart": "5（4 个 UART + 1 个 LP UART）",
"spi": "7（6 个 SPI + 1 个 LP SPI）",
"i2c": "3（2 个 I2C + 1 个 LP I2C）",
"i2s": "2",
"pwm": "LED PWM（最高 8 通道）、电机 PWM（MCPWM）",
"usb": "1（USB 2.0 高速 OTG 和 USB Serial/JTAG）",
"can": "是（CAN FD 控制器）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active": "可配置的高性能优化功耗",
"light_sleep": "0.1-0.8 mA",
"deep_sleep": "低功耗，LP CPU 保持运行"
},
"temperatura_operacao": "-40°C 至 85°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v6.1 预览版；自 v6.1.1 起正式支持",
"arduino_core": "arduino-esp32 核心尚不支持",
"encapsulamento": "QFN80（8×8 mm）",
"modulos": "ESP32-S31-WROOM-1、ESP32-S31-WROOM-3",
"datasheet": "https://documentation.espressif.com/esp32-s31_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-s31_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s31/get-started/index.html",
"placa": "/placas/esp32-s31.png",
"cor": "#ff2a5f",
"sdio": "1（SDIO 3.0 主机）"
},
"ESP32-C2": {
"nome_completo": "ESP32-C2（ESP8684）",
"icone": "🌱",
"descricao": "超低成本、低功耗 RISC-V 微控制器，支持 Wi-Fi 4 和 Bluetooth 5.3 LE",
"arquitetura": "32 位单核 RISC-V",
"nucleos": "1（单核）",
"frequencia": "最高 120 MHz",
"seguranca": {
"aes": "否",
"sha": "SHA-1/224/256",
"rsa": "否",
"ecc": "是（P-192、P-256）",
"ecdsa": "否",
"hmac": "否",
"assinatura_digital": "否",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128",
"secure_boot": "V2（ECDSA P-192 或 P-256）",
"protecao_dpa": "否"
},
"wifi": "IEEE 802.11 b/g/n（2.4 GHz，最高 72.2 Mbps）",
"bluetooth": "Bluetooth 5.3 LE（认证）",
"memoria_sram": "272 KB（16 KB 用于缓存）",
"memoria_sram_rtc": "否",
"memoria_rom": "576 KB",
"flash_externa": "通过 QSPI，最高 16 MB，但已售变体不可用（ESP8684H2X/H4X 封装内有 2 MB 或 4 MB，且不引出 Flash 引脚）",
"psram_externa": "否",
"gpio": "14",
"adc": "1 个 12 位 SAR ADC，最高 5 通道",
"dac": "否",
"touch": "否",
"uart": "2",
"spi": "3（SPI0/1 用于内部 Flash，SPI2 用于通用）",
"i2c": "1（仅主机）",
"i2s": "否",
"pwm": "LED PWM（最高 6 通道）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active_cpu_120mhz": "10,7-15,6 mA（modem sleep）",
"light_sleep": "140 µA",
"deep_sleep": "5 µA"
},
"temperatura_operacao": "-40°C 至 105°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "外部 JTAG（需调试探针，例如 ESP-PROG）",
"esp_idf_minimo": "v5.0",
"arduino_core": "是（官方核心中有 1 个板卡定义）",
"encapsulamento": "QFN24（4×4 mm）",
"modulos": "ESP8684-MINI-1、ESP8684-WROOM-01C、ESP8684-WROOM-02C、ESP8684-WROOM-02UC 等 5 款",
"datasheet": "https://documentation.espressif.com/esp32-c2_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-c2_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32c2/get-started/index.html",
"placa": "/placas/esp32-c2.png",
"cor": "#8c52ff"
},
"ESP32-C3": {
"nome_completo": "ESP32-C3",
"icone": "💎",
"descricao": "超低功耗 RISC-V 处理器",
"arquitetura": "32 位单核 RISC-V",
"nucleos": "1（单核）",
"frequencia": "最高 160 MHz",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256",
"rsa": "是（RSA/MPI 最高 3072 位）",
"ecc": "否",
"ecdsa": "否",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128",
"secure_boot": "V2（RSA-3072），自 v0.3 版本（ECO3）起",
"protecao_dpa": "否"
},
"wifi": "IEEE 802.11 b/g/n（2.4 GHz，最高 150 Mbps）",
"bluetooth": "Bluetooth 5（LE）和 Bluetooth Mesh",
"memoria_sram": "400 KB",
"memoria_sram_rtc": "8 KB",
"memoria_rom": "384 KB",
"flash_externa": "通过 QSPI，最高 16 MB",
"psram_externa": "否",
"gpio": "22",
"adc": "2 个 12 位 SAR ADC，最高 6 通道",
"dac": "否",
"touch": "否",
"uart": "2",
"spi": "3（SPI0/1 用于 Flash，SPI2 用于通用）",
"i2c": "1",
"i2s": "1",
"pwm": "LED PWM（最高 6 通道）",
"usb": "1（USB Serial/JTAG）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active_cpu_160mhz": "20 mA",
"active_wifi_tx_peak": "335 mA",
"modem_sleep_cpu_160mhz": "16-28 mA",
"light_sleep": "130 µA",
"deep_sleep": "5 µA"
},
"temperatura_operacao": "-40°C 至 105°C（ESP32-C3FN4 为 85°C）",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v4.3",
"arduino_core": "是（官方核心中有 29 个板卡定义）",
"encapsulamento": "QFN32（5×5 mm）和 QFN28（4×4 mm）",
"modulos": "ESP32-C3-MINI-1、ESP32-C3-WROOM-02",
"datasheet": "https://documentation.espressif.com/esp32-c3_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-c3_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html",
"placa": "/placas/esp32-c3.png",
"cor": "#20c997"
},
"ESP32-C5": {
"nome_completo": "ESP32-C5",
"icone": "📶",
"descricao": "首款支持双频 Wi-Fi 6 和 Bluetooth 6.0，配备 RISC-V CPU 和 ULP 协处理器",
"arquitetura": "32 位单核 RISC-V（HP）+ RISC-V 单核（LP）",
"nucleos": "1（单核 HP）+ 1（单核 LP）",
"frequencia": "最高 240 MHz",
"coprocessador_ulp": "是（RISC-V，48 MHz LP CPU）",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256/384/512",
"rsa": "是（RSA/MPI 最高 3072 位）",
"ecc": "是（P-192、P-256、P-384）",
"ecdsa": "是（确定性模式，RFC 6979）",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "是",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128/256",
"secure_boot": "V2（RSA-3072 或 ECDSA P-256/P-384）",
"protecao_dpa": "是"
},
"wifi": "Wi-Fi 6（802.11ax）双频 2.4 GHz 和 5 GHz",
"bluetooth": "Bluetooth 5（LE）（Bluetooth Core 6.0 认证）",
"zigbee_thread": "IEEE 802.15.4（Zigbee 3.0、Thread 1.4）",
"matter": "是",
"memoria_sram": "384 KB",
"memoria_sram_rtc": "16 KB",
"memoria_rom": "320 KB",
"flash_externa": "通过 QSPI，最高 16 MB",
"psram_externa": "是，通过 SPI（带缓存的 Flash/PSRAM 控制器）",
"gpio": "29",
"adc": "1 个 12 位 SAR ADC，最高 6 通道",
"dac": "否",
"touch": "否",
"uart": "3（2 个 UART + 1 个 LP UART）",
"spi": "3",
"i2c": "2（1 个 I2C + 1 个 LP I2C）",
"i2s": "1",
"pwm": "LED PWM（最高 6 通道）、电机 PWM",
"usb": "1（USB Serial/JTAG）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active_wifi": "最高 377 mA（5 GHz TX）",
"light_sleep": "60-250 µA",
"deep_sleep": "12 µA"
},
"temperatura_operacao": "-40°C 至 105°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v5.5.2",
"arduino_core": "是（官方核心中有 10 个板卡定义）",
"encapsulamento": "QFN48（6×6 mm）",
"modulos": "ESP32-C5-MINI-1、ESP32-C5-WROOM-1",
"datasheet": "https://documentation.espressif.com/esp32-c5_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-c5_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32c5/get-started/index.html",
"placa": "/placas/esp32-c5.png",
"cor": "#6f42c1",
"sdio": "1（SDIO 从机，v1.0 版本起）",
"can": "2（CAN FD）"
},
"ESP32-C6": {
"nome_completo": "ESP32-C6",
"icone": "🌐",
"descricao": "高级安全特性，支持 Wi-Fi 6、Bluetooth 6.0、Zigbee 和 Thread（兼容 Matter）",
"arquitetura": "32 位单核 RISC-V（HP）+ RISC-V 单核（LP）",
"nucleos": "1（单核 HP）+ 1（单核 LP）",
"frequencia": "最高 160 MHz",
"coprocessador_ulp": "是（RISC-V，20 MHz LP CPU）",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256",
"rsa": "是（RSA/MPI 最高 3072 位）",
"ecc": "是（P-192、P-256）",
"ecdsa": "否",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128",
"secure_boot": "V2（RSA-3072 或 ECDSA）",
"protecao_dpa": "是"
},
"wifi": "Wi-Fi 6（802.11ax）2.4 GHz",
"bluetooth": "Bluetooth 5（LE）（Bluetooth 5.3 认证）",
"zigbee_thread": "IEEE 802.15.4（Zigbee 3.0、Thread 1.3）",
"matter": "是",
"memoria_sram": "512 KB",
"memoria_sram_rtc": "16 KB",
"memoria_rom": "320 KB",
"flash_externa": "通过 QSPI，最高 16 MB",
"psram_externa": "否",
"gpio": "30",
"adc": "1 个 12 位 SAR ADC，最高 7 通道",
"dac": "否",
"touch": "否",
"uart": "3（2 个 UART + 1 个 LP UART）",
"spi": "3",
"i2c": "2（1 个 I2C + 1 个 LP I2C）",
"i2s": "1",
"pwm": "LED PWM（最高 6 通道）、电机 PWM",
"usb": "1（USB Serial/JTAG）",
"sdio": "1（SDIO 2.0 从机）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active_wifi6": "252-354 mA（TX）",
"light_sleep": "35-180 µA",
"deep_sleep": "7 µA"
},
"temperatura_operacao": "-40°C 至 105°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v5.1",
"arduino_core": "是（官方核心中有 21 个板卡定义）",
"encapsulamento": "QFN40（5×5 mm）和 QFN32（5×5 mm）",
"modulos": "ESP32-C6-MINI-1、ESP32-C6-WROOM-1",
"datasheet": "https://documentation.espressif.com/esp32-c6_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-c6_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32c6/get-started/index.html",
"placa": "/placas/esp32-c6.png",
"cor": "#17a2b8"
},
"ESP32-C61": {
"nome_completo": "ESP32-C61",
"icone": "🛰️",
"descricao": "高性价比 160MHz RISC-V 微控制器，支持 Wi-Fi 6、Bluetooth 6.0 LE，封装内支持 Flash/PSRAM",
"arquitetura": "32 位单核 RISC-V",
"nucleos": "1（单核）",
"frequencia": "最高 160 MHz",
"seguranca": {
"aes": "否",
"sha": "SHA-1/224/256",
"rsa": "否",
"ecc": "是（P-192、P-256）",
"ecdsa": "是（确定性模式，RFC 6979）",
"hmac": "否",
"assinatura_digital": "否",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128",
"secure_boot": "V2（ECDSA）",
"protecao_dpa": "是"
},
"wifi": "Wi-Fi 6（802.11ax）2.4 GHz",
"bluetooth": "Bluetooth 5（LE）（Bluetooth Core 6.0 认证）",
"zigbee_thread": "否",
"matter": "是（通过 Wi-Fi）",
"memoria_sram": "320 KB",
"memoria_sram_rtc": "否",
"memoria_rom": "256 KB",
"flash_externa": "通过 QSPI，最高 16 MB（部分型号封装内集成 4 MB 或 8 MB）",
"psram_externa": "通过 QSPI，最高 16 MB（部分型号封装内集成 2 MB 或 8 MB）",
"gpio": "30",
"adc": "1 个 12 位 SAR ADC，最高 4 通道",
"dac": "否",
"touch": "否",
"uart": "3",
"spi": "3（2 个用于 Flash/PSRAM，1 个通用）",
"i2c": "1",
"i2s": "1",
"pwm": "LED PWM（最高 6 通道）",
"usb": "1（USB Serial/JTAG）",
"sdio": "1（SDIO 2.0 从机）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active": "240-360 mA（TX）",
"light_sleep": "50-200 µA",
"deep_sleep": "10 µA"
},
"temperatura_operacao": "-40°C 至 105°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v5.5.2",
"arduino_core": "是（官方核心中有 1 个板卡定义）",
"encapsulamento": "QFN40（5×5 mm）或 LGA40（5×5 mm）",
"modulos": "ESP32-C61-MINI-1、ESP32-C61-WROOM-1",
"datasheet": "https://documentation.espressif.com/esp32-c61_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-c61_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32c61/get-started/index.html",
"placa": "/placas/esp32-c61.png",
"cor": "#0dcaf0"
},
"ESP32-P4": {
"nome_completo": "ESP32-P4",
"icone": "⚡",
"descricao": "高性能：400MHz 双核 RISC-V 处理器、AI 加速器和丰富的多媒体接口",
"arquitetura": "32 位 RISC-V 高性能双核（HP）+ 低功耗单核（LP）",
"nucleos": "2（双核 HP）+ 1（单核 LP）",
"frequencia": "最高 400 MHz（HP，v3.x 版本；v1.x 为 360 MHz）；LP 最高 40 MHz",
"coprocessador_ulp": "是（RISC-V，40 MHz LP CPU）",
"aceleradores_ia": "是（向量指令、AI 加速器）",
"seguranca": {
"aes": "AES-128/256（GCM）",
"sha": "SHA-1/224/256/384/512",
"rsa": "是（RSA/MPI 最高 4096 位）",
"ecc": "是（P-192、P-256、P-384）",
"ecdsa": "是（确定性模式，RFC 6979）",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "是",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128/256",
"secure_boot": "V2（RSA-3072 或 ECDSA）",
"protecao_dpa": "否"
},
"wifi": "否",
"bluetooth": "否",
"ethernet": "是（集成 Ethernet MAC）",
"memoria_sram": "768 KB",
"memoria_sram_rtc": "32 KB",
"memoria_rom": "128 KB（HP ROM）+ 16 KB（LP ROM）",
"flash_externa": "通过 QSPI/八线 SPI，最高 128 MB",
"psram_externa": "16 MB 或 32 MB 集成于封装内（OPI/HPI，1,8 V）",
"gpio": "55",
"adc": "2 个 12 位 SAR ADC，最高 14 通道",
"dac": "否",
"touch": "是（电容式触摸传感器）",
"uart": "6（5 个 UART + 1 个 LP UART）",
"spi": "3",
"i2c": "3（2 个 I2C + 1 个 LP I2C）",
"i2s": "4（3 个 I2S + 1 个 LP I2S）",
"pwm": "LED PWM（最高 8 通道）、电机 PWM（6 通道）",
"usb": "USB 2.0 高速 OTG + USB 2.0 全速 OTG + USB Serial/JTAG",
"mipi_csi": "摄像头 MIPI CSI 接口",
"mipi_dsi": "显示屏 MIPI DSI 接口",
"lcd": "8/16/24 位 LCD 接口",
"camera": "8/16 位 DVP 接口",
"sdio": "1 个 SD/MMC 主机控制器（SDHOST）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active": "15-150 mA（40 至 400 MHz，视负载而定）",
"light_sleep": "75-800 µA",
"deep_sleep": "12 µA"
},
"temperatura_operacao": "-40°C 至 85°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v5.3",
"arduino_core": "是（官方核心中有 7 个板卡定义）",
"encapsulamento": "QFN104（10×10 mm）",
"modulos": "官方产品目录中无模组（仅裸芯片）",
"datasheet": "https://documentation.espressif.com/esp32-p4-chip-revision-v1.3_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-p4-chip-revision-v1.3_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32p4/get-started/index.html",
"placa": "/placas/esp32-p4.png",
"cor": "#ffc107"
},
"ESP32-H2": {
"nome_completo": "ESP32-H2",
"icone": "🔋",
"descricao": "专注于超低功耗，支持 Bluetooth 6.0、Zigbee 和 Thread，但不支持 Wi-Fi",
"arquitetura": "32 位单核 RISC-V",
"nucleos": "1（单核）",
"frequencia": "最高 96 MHz",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256",
"rsa": "是（RSA/MPI 最高 3072 位）",
"ecc": "是（P-192、P-256）",
"ecdsa": "是（确定性模式，RFC 6979）",
"hmac": "是",
"assinatura_digital": "是",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128",
"secure_boot": "V2（RSA-3072 或 ECDSA）",
"protecao_dpa": "是"
},
"wifi": "否",
"bluetooth": "Bluetooth 5（LE）（Bluetooth 5.3 认证）",
"zigbee_thread": "IEEE 802.15.4（Zigbee 3.0、Thread 1.4）",
"matter": "是",
"memoria_sram": "320 KB",
"memoria_sram_rtc": "4 KB（LP 存储）",
"memoria_rom": "128 KB",
"flash_externa": "通过 QSPI，最高 16 MB",
"psram_externa": "否",
"gpio": "19",
"adc": "1 个 12 位 SAR ADC，最高 5 通道",
"dac": "否",
"touch": "否",
"uart": "2",
"spi": "3",
"i2c": "2",
"i2s": "1",
"pwm": "LED PWM（最高 6 通道）",
"usb": "1（USB Serial/JTAG）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active": "24-140 mA（射频，-24 至 20 dBm）",
"light_sleep": "25-85 µA",
"deep_sleep": "7 µA"
},
"temperatura_operacao": "-40°C 至 105°C",
"temperatura_armazenamento": "-40°C 至 150°C",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v5.1",
"arduino_core": "是（官方核心中有 3 个板卡定义）",
"encapsulamento": "QFN32（4×4 mm）",
"modulos": "ESP32-H2-MINI-1、ESP32-H2-WROOM-02C",
"datasheet": "https://documentation.espressif.com/esp32-h2_datasheet_en.html",
"manual_tecnico": "https://documentation.espressif.com/esp32-h2_technical_reference_manual_en.html",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32h2/get-started/index.html",
"placa": "/placas/esp32-h2.png",
"cor": "#6c757d"
},
"ESP32-H4": {
"nome_completo": "ESP32-H4",
"icone": "🛡️",
"descricao": "超高能效双核 RISC-V SoC，支持 Bluetooth 5.4 LE（LE Audio）和 IEEE 802.15.4，适用于 Thread、Zigbee 和 Matter，不支持 Wi-Fi",
"status_documentacao": "初步文档：乐鑫尚未发布 ESP32-H4 的数据手册和技术参考手册。以下数据来自产品官方公告和 ESP-IDF 硬件定义（soc_caps），发布前可能变更。",
"arquitetura": "32 位双核 RISC-V",
"nucleos": "2（双核）",
"frequencia": "最高 96 MHz",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256/384/512",
"rsa": "否",
"ecc": "是（P-192、P-256、P-384）",
"ecdsa": "是（确定性模式，RFC 6979）",
"hmac": "是",
"assinatura_digital": "否",
"key_manager": "否",
"rng": "是（硬件 TRNG）",
"criptografia_flash": "XTS-AES-128/256",
"secure_boot": "硬件支持；ESP-IDF 尚未启用",
"protecao_dpa": "否"
},
"wifi": "否",
"bluetooth": "Bluetooth 5.4 LE（Bluetooth 6.0 认证；LE Audio、BIS/CIS 同步通道、PAwR、Connection Subrating 和 AoA/AoD 测向）",
"zigbee_thread": "IEEE 802.15.4（Zigbee 3.0、Thread 1.4）",
"matter": "是",
"memoria_sram": "384 KB",
"memoria_sram_rtc": "是（LP SRAM）",
"memoria_rom": "128 KB",
"flash_externa": "是，通过 QSPI（ESP32-H4HF4 封装内集成 4 MB）",
"psram_externa": "是（ESP32-H4HR2 封装内集成 2 MB）",
"gpio": "40",
"adc": "1 个 12 位 SAR ADC，最高 5 通道",
"dac": "否",
"touch": "15 个电容式通道（版本 3，支持防水和接近检测）",
"uart": "2",
"spi": "3",
"i2c": "2",
"i2s": "1",
"pwm": "LED PWM（最高 8 通道）、电机 PWM（MCPWM）",
"can": "1（CAN 2.0，TWAI®）",
"usb": "1（USB OTG 1.1）+ 1（USB Serial/JTAG）",
"sensor_temperatura": "1（内部）",
"consumo_energia": {
"active": "未公布（初步文档）"
},
"temperatura_operacao": "-40°C 至 105°C",
"temperatura_armazenamento": "未公布（初步文档）",
"depuracao": "USB 集成 JTAG（无需外部探针）",
"esp_idf_minimo": "v6.0 预览版（无稳定支持）",
"arduino_core": "arduino-esp32 核心尚不支持",
"encapsulamento": "QFN56（6×6 mm）",
"modulos": "ESP32-H4-WROOM-1",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32h4/get-started/index.html",
"cor": "#e83e8c"
}
}
lib/data/zh-CN/componentes.js
+858
View File
@@ -0,0 +1,858 @@
/**
* 官方精选数据库：ESP Component Registry 与 IDF Component Manager
*
* ESP Component Registry（https://components.espressif.com）是面向
* ESP-IDF v4.4+ / v5.x+ 的模块化库的核心分发生态。
*/
export const CATEGORIAS_COMPONENTES = [
{
id: "todos",
nome: "全部组件",
icone: "Layers",
descricao: "浏览完整的精选库与驱动目录"
},
{
id: "ui_display",
nome: "UI、显示屏与图形",
icone: "Monitor",
descricao: "图形库（LVGL）、LCD/OLED 显示驱动、触摸与解码器"
},
{
id: "cloud_conectividade",
nome: "云与网络连接",
icone: "Cloud",
descricao: "ESP RainMaker、AWS IoT、MQTT、WebSocket、Mesh-Lite 与 ESP-Hosted 协处理"
},
{
id: "audio_voz_ia",
nome: "音频、语音与 AI",
icone: "Brain",
descricao: "ESP-SR 语音识别、DSP 处理、编解码器、DVP 摄像头与 TinyML"
},
{
id: "smart_home_mesh",
nome: "智能家居与 Mesh",
icone: "Home",
descricao: "Matter SDK、Zigbee 3.0（ZBOSS）协议栈、Thread 与 ESP-NOW 网络"
},
{
id: "drivers_perifericos",
nome: "驱动与传感器",
icone: "Cpu",
descricao: "按键、编码器、RGB LED、以太网（W5500/CH390）、原生 USB 以及环境/IMU 传感器"
},
{
id: "bsp_placas",
nome: "BSP（板级支持包）",
icone: "CircuitBoard",
descricao: "对 ESP-BOX-3、Korvo、EYE 和 M5Stack 等官方开发板的直接支持包"
},
{
id: "sistema_utilitarios",
nome: "系统与工具",
icone: "Wrench",
descricao: "LittleFS 文件系统、现代 C++ 封装、CBOR 与网络工具"
}
];
export const COMPONENTES_REGISTRY = [
// ==========================================
// 1. UI, Displays & Gráficos
// ==========================================
{
id: "espressif-esp_lvgl_port",
namespace: "espressif",
name: "esp_lvgl_port",
versao: "^2.4.0",
categoria: "ui_display",
oficial: true,
popular: true,
titulo: "ESP LVGL Port",
descricao: "官方的线程安全 LVGL（Light and Versatile Graphics Library）移植，面向 ESP-IDF，支持硬件加速和多显示屏。",
tags: ["LVGL", "GUI", "显示屏", "触摸", "人机界面"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
dependenciasSugeridas: ["lvgl/lvgl^9.1.0"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_lvgl_port",
urlRepo: "https://github.com/espressif/esp-bsp/tree/master/components/esp_lvgl_port",
exemploYaml: `dependencies:
espressif/esp_lvgl_port: "^2.4.0"
lvgl/lvgl: "^9.1.0"`
},
{
id: "lvgl-lvgl",
namespace: "lvgl",
name: "lvgl",
versao: "^9.1.0",
categoria: "ui_display",
oficial: false,
popular: true,
titulo: "LVGL Graphics Library Core",
descricao: "嵌入式系统中最流行的 C 语言开源图形库。提供丰富的控件、流畅的动画和现代化的布局支持。",
tags: ["LVGL 9", "Graphics", "Widgets", "GUI", "Embedded UI"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/lvgl/lvgl",
urlRepo: "https://github.com/lvgl/lvgl",
exemploYaml: `dependencies:
lvgl/lvgl: "^9.1.0"`
},
{
id: "espressif-esp32_display_panel",
namespace: "espressif",
name: "esp32_display_panel",
versao: "^0.2.0",
categoria: "ui_display",
oficial: true,
popular: true,
titulo: "ESP32 Display Panel Driver",
descricao: "统一的 LCD 控制器（RGB、SPI、QSPI、MIPI-DSI）与电容触摸驱动，专为 ESP32-S3 和 ESP32-P4 设计。",
tags: ["LCD", "MIPI-DSI", "QSPI", "Touch", "ST7789", "ILI9341"],
chips: ["ESP32-S3", "ESP32-P4", "ESP32-S2", "ESP32"],
urlRegistry: "https://components.espressif.com/components/espressif/esp32_display_panel",
urlRepo: "https://github.com/esp-arduino-libs/ESP32_Display_Panel",
exemploYaml: `dependencies:
espressif/esp32_display_panel: "^0.2.0"`
},
{
id: "espressif-esp_lcd_touch",
namespace: "espressif",
name: "esp_lcd_touch",
versao: "^1.1.2",
categoria: "ui_display",
oficial: true,
popular: true,
titulo: "ESP LCD Touch Framework",
descricao: "触摸屏 LCD 触摸面板的核心抽象组件。支持坐标校准、多点触控读取，并可直接与 LVGL 集成。",
tags: ["触摸屏", "电容式", "电阻式", "I2C 触摸", "坐标"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_lcd_touch",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/display/touch_panel/esp_lcd_touch",
exemploYaml: `dependencies:
espressif/esp_lcd_touch: "^1.1.2"`
},
{
id: "espressif-esp_lcd_touch_gt911",
namespace: "espressif",
name: "esp_lcd_touch_gt911",
versao: "^1.1.2",
categoria: "ui_display",
oficial: true,
popular: true,
titulo: "GT911 电容触摸驱动",
descricao: "专用于 Goodix GT911 电容触摸控制器的 I2C 驱动，广泛用于 ESP32-S3 和 P4 的 4.3\"、5\" 和 7\" 显示屏。",
tags: ["GT911", "Goodix", "电容触摸", "多点触控", "I2C"],
chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-S2"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_lcd_touch_gt911",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/display/touch_panel/esp_lcd_touch_gt911",
exemploYaml: `dependencies:
espressif/esp_lcd_touch_gt911: "^1.1.2"`
},
{
id: "espressif-esp_lcd_touch_ft5x06",
namespace: "espressif",
name: "esp_lcd_touch_ft5x06",
versao: "^1.1.0",
categoria: "ui_display",
oficial: true,
popular: false,
titulo: "FocalTech FT5x06 / FT6x36 触摸驱动",
descricao: "面向 FocalTech 控制器（FT5206、FT5316、FT5436、FT6236、FT6336）的电容触摸面板驱动，支持手势和中断。",
tags: ["FT6236", "FT5x06", "FocalTech", "触摸", "I2C"],
chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-S2", "ESP32-C3"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_lcd_touch_ft5x06",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/display/touch_panel/esp_lcd_touch_ft5x06",
exemploYaml: `dependencies:
espressif/esp_lcd_touch_ft5x06: "^1.1.0"`
},
{
id: "espressif-esp_jpeg",
namespace: "espressif",
name: "esp_jpeg",
versao: "^1.3.0",
categoria: "ui_display",
oficial: true,
popular: false,
titulo: "ESP JPEG Decoder (TJpgDec)",
descricao: "高速 JPEG 编解码器，带有汇编 SIMD 优化，可在显示屏上无延迟地显示图像和摄像头视频流。",
tags: ["JPEG", "TJpgDec", "摄像头", "图像", "SIMD"],
chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_jpeg",
urlRepo: "https://github.com/espressif/esp-jpeg",
exemploYaml: `dependencies:
espressif/esp_jpeg: "^1.3.0"`
},
// ==========================================
// 2. Cloud & Conectividade
// ==========================================
{
id: "espressif-esp_rainmaker",
namespace: "espressif",
name: "esp_rainmaker",
versao: "^1.4.0",
categoria: "cloud_conectividade",
oficial: true,
popular: true,
titulo: "ESP RainMaker Agent",
descricao: "乐鑫 ESP RainMaker AIoT 云平台的官方固件代理。支持手机 App、Alexa、Google Home 控制以及 OTA。",
tags: ["RainMaker", "AWS Cloud", "iOS/Android App", "Alexa", "Google Home", "OTA"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_rainmaker",
urlRepo: "https://github.com/espressif/esp-rainmaker",
exemploYaml: `dependencies:
espressif/esp_rainmaker: "^1.4.0"`
},
{
id: "espressif-mesh_lite",
namespace: "espressif",
name: "mesh_lite",
versao: "^1.2.0",
categoria: "cloud_conectividade",
oficial: true,
popular: true,
titulo: "ESP Mesh-Lite Network Stack",
descricao: "轻量级 Wi-Fi Mesh 网络，每个节点都有独立的 IP 连接，可在局域网内直接通信，并通过多跳访问云端。",
tags: ["Mesh", "Wi-Fi Mesh", "Mesh 网络", "分布式 IoT", "IP Layer"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/mesh_lite",
urlRepo: "https://github.com/espressif/esp-mesh-lite",
exemploYaml: `dependencies:
espressif/mesh_lite: "^1.2.0"`
},
{
id: "espressif-esp_modbus",
namespace: "espressif",
name: "esp_modbus",
versao: "^1.0.15",
categoria: "cloud_conectividade",
oficial: true,
popular: true,
titulo: "ESP-Modbus Industrial Stack",
descricao: "完整的工业 Modbus 协议栈（主站/从站），支持 RS-485（RTU/ASCII）以及以太网/Wi-Fi（Modbus TCP）接口。",
tags: ["Modbus", "RS-485", "Modbus TCP", "工业自动化", "PLC"],
chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_modbus",
urlRepo: "https://github.com/espressif/esp-modbus",
exemploYaml: `dependencies:
espressif/esp_modbus: "^1.0.15"`
},
{
id: "espressif-net_connect",
namespace: "espressif",
name: "net_connect",
versao: "^1.0.0",
categoria: "cloud_conectividade",
oficial: true,
popular: false,
titulo: "Unified Network Connect",
descricao: "统一的网络连接管理组件，可透明地切换并初始化 Wi-Fi、以太网、Thread 或移动 PPP。",
tags: ["Network", "Wi-Fi", "Ethernet", "故障切换", "自动连接"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/net_connect",
urlRepo: "https://github.com/espressif/esp-idf/tree/master/components",
exemploYaml: `dependencies:
espressif/net_connect: "^1.0.0"`
},
{
id: "espressif-esp_hosted",
namespace: "espressif",
name: "esp_hosted",
versao: "^0.0.10",
categoria: "cloud_conectividade",
oficial: true,
popular: false,
titulo: "ESP-Hosted Coprocessor",
descricao: "把 ESP32 变成无线通信协处理器（Wi-Fi + BLE），供 Linux 主机（Raspberry Pi、i.MX）或通过 SPI/SDIO/UART 连接的微控制器使用。",
tags: ["协处理器", "SDIO", "SPI", "Linux Wi-Fi", "Raspberry Pi"],
chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_hosted",
urlRepo: "https://github.com/espressif/esp-hosted",
exemploYaml: `dependencies:
espressif/esp_hosted: "^0.0.10"`
},
{
id: "espressif-esp-now",
namespace: "espressif",
name: "esp-now",
versao: "^2.5.0",
categoria: "cloud_conectividade",
oficial: true,
popular: true,
titulo: "ESP-NOW Enhanced & Provisioning",
descricao: "ESP-NOW 协议的扩展，提供遥控配对、AES-128 安全以及多设备控制等高级功能。",
tags: ["ESP-NOW", "无线", "低延迟", "广播", "遥控"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-now",
urlRepo: "https://github.com/espressif/esp-now",
exemploYaml: `dependencies:
espressif/esp-now: "^2.5.0"`
},
// ==========================================
// 3. Áudio, Voz & IA
// ==========================================
{
id: "espressif-esp-sr",
namespace: "espressif",
name: "esp-sr",
versao: "^1.5.0",
categoria: "audio_voz_ia",
oficial: true,
popular: true,
titulo: "ESP-SR Speech Recognition",
descricao: "100% 离线的语音识别框架，包含 WakeNet（唤醒词）、MultiNet（本地命令）和 AFE 声学算法。",
tags: ["语音", "WakeNet", "MultiNet", "语音识别", "离线", "AEC"],
chips: ["ESP32-S3", "ESP32-P4", "ESP32"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-sr",
urlRepo: "https://github.com/espressif/esp-sr",
exemploYaml: `dependencies:
espressif/esp-sr: "^1.5.0"`
},
{
id: "espressif-esp_codec_dev",
namespace: "espressif",
name: "esp_codec_dev",
versao: "^1.3.0",
categoria: "audio_voz_ia",
oficial: true,
popular: true,
titulo: "ESP Audio Codec Device HAL",
descricao: "统一的 I2S/I2C 音频编解码器抽象层（ES8311、ES8388、ES7210、ES7243、TAS5805M），用于立体声输入输出。",
tags: ["Audio Codec", "I2S", "ES8311", "ES8388", "麦克风 DAC"],
chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_codec_dev",
urlRepo: "https://github.com/espressif/esp-codec-dev",
exemploYaml: `dependencies:
espressif/esp_codec_dev: "^1.3.0"`
},
{
id: "espressif-es8311",
namespace: "espressif",
name: "es8311",
versao: "^1.0.0",
categoria: "audio_voz_ia",
oficial: true,
popular: true,
titulo: "ES8311 音频编解码器驱动",
descricao: "面向 Everest ES8311 编解码器（单声道 DAC + 麦克风 ADC）的专用低功耗驱动，见于 ESP32-S3-BOX 和 IoT 开发板。",
tags: ["ES8311", "音频", "DAC", "麦克风", "I2S"],
chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3"],
urlRegistry: "https://components.espressif.com/components/espressif/es8311",
urlRepo: "https://github.com/espressif/esp-bsp/tree/master/components/es8311",
exemploYaml: `dependencies:
espressif/es8311: "^1.0.0"`
},
{
id: "espressif-esp32-camera",
namespace: "espressif",
name: "esp32-camera",
versao: "^2.0.12",
categoria: "audio_voz_ia",
oficial: true,
popular: true,
titulo: "ESP32 Camera Driver",
descricao: "官方 CMOS 摄像头驱动（OV2640、OV3660、OV5640、OV7670、GC0308），支持 DMA、DMA-2D、JPEG 捕获，以及通过 HTTP/RTSP 的 MJPEG 流。",
tags: ["摄像头", "OV2640", "OV5640", "DVP", "MIPI-CSI", "视频"],
chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-S2"],
urlRegistry: "https://components.espressif.com/components/espressif/esp32-camera",
urlRepo: "https://github.com/espressif/esp32-camera",
exemploYaml: `dependencies:
espressif/esp32-camera: "^2.0.12"`
},
{
id: "espressif-esp-dsp",
namespace: "espressif",
name: "esp-dsp",
versao: "^1.5.1",
categoria: "audio_voz_ia",
oficial: true,
popular: true,
titulo: "ESP-DSP Signal Processing",
descricao: "面向 ESP32 SoC 的官方数字信号处理库（FFT、FIR/IIR 数字滤波器、矩阵与加速的线性代数）。",
tags: ["DSP", "FFT", "滤波器", "数学", "SIMD", "汇编"],
chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-dsp",
urlRepo: "https://github.com/espressif/esp-dsp",
exemploYaml: `dependencies:
espressif/esp-dsp: "^1.5.1"`
},
{
id: "espressif-esp-nn",
namespace: "espressif",
name: "esp-nn",
versao: "^1.2.0",
categoria: "audio_voz_ia",
oficial: true,
popular: true,
titulo: "ESP-NN Neural Network Kernels",
descricao: "用向量汇编优化的内核，在 ESP32 芯片上加速神经网络和 TensorFlow Lite Micro 模型。",
tags: ["TinyML", "TensorFlow Lite", "神经网络", "推理", "Edge AI"],
chips: ["ESP32-S3", "ESP32-P4", "ESP32"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-nn",
urlRepo: "https://github.com/espressif/esp-nn",
exemploYaml: `dependencies:
espressif/esp-nn: "^1.2.0"`
},
// ==========================================
// 4. Smart Home & Mesh
// ==========================================
{
id: "espressif-esp-matter",
namespace: "espressif",
name: "esp-matter",
versao: "^1.3.0",
categoria: "smart_home_mesh",
oficial: true,
popular: true,
titulo: "ESP Matter SDK",
descricao: "官方 SDK，用于创建可在 Wi-Fi 和 Thread 上与 Apple Home、Google Home、Amazon Alexa 和 Home Assistant 互操作的设备。",
tags: ["Matter", "智能家居", "Apple HomeKit", "Google Home", "Thread", "CHIP"],
chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-matter",
urlRepo: "https://github.com/espressif/esp-matter",
exemploYaml: `dependencies:
espressif/esp-matter: "^1.3.0"`
},
{
id: "espressif-esp-zigbee-lib",
namespace: "espressif",
name: "esp-zigbee-lib",
versao: "^1.6.0",
categoria: "smart_home_mesh",
oficial: true,
popular: true,
titulo: "ESP Zigbee 3.0 Library",
descricao: "经过认证的 Zigbee 3.0 协议栈（ZBOSS），用于在 802.15.4 芯片上创建低功耗的协调器、路由器和终端设备节点。",
tags: ["Zigbee 3.0", "ZBOSS", "802.15.4", "Home Automation", "电池供电"],
chips: ["ESP32-H2", "ESP32-C6"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-zigbee-lib",
urlRepo: "https://github.com/espressif/esp-zigbee-sdk",
exemploYaml: `dependencies:
espressif/esp-zigbee-lib: "^1.6.0"`
},
{
id: "espressif-esp_rcp_update",
namespace: "espressif",
name: "esp_rcp_update",
versao: "^1.0.0",
categoria: "smart_home_mesh",
oficial: true,
popular: false,
titulo: "ESP RCP Thread/Zigbee Gateway",
descricao: "用于更新 802.15.4 射频协处理器（RCP）的组件，用来构建 Thread 边界路由器和多协议 Zigbee 网关。",
tags: ["Thread Border Router", "OpenThread", "RCP", "Zigbee Gateway"],
chips: ["ESP32-H2", "ESP32-C6", "ESP32-S3"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_rcp_update",
urlRepo: "https://github.com/espressif/esp-thread-br",
exemploYaml: `dependencies:
espressif/esp_rcp_update: "^1.0.0"`
},
// ==========================================
// 5. Drivers & Sensores
// ==========================================
{
id: "espressif-led_indicator",
namespace: "espressif",
name: "led_indicator",
versao: "^1.2.0",
categoria: "drivers_perifericos",
oficial: true,
popular: true,
titulo: "LED Indicator Driver",
descricao: "智能的 LED 灯效控制驱动（快闪、呼吸/渐变、错误码和 RGB），不会阻塞主循环。",
tags: ["LED", "PWM", "RGB", "闪烁", "视觉反馈"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C2", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/led_indicator",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/led/led_indicator",
exemploYaml: `dependencies:
espressif/led_indicator: "^1.2.0"`
},
{
id: "espressif-button",
namespace: "espressif",
name: "button",
versao: "^3.4.0",
categoria: "drivers_perifericos",
oficial: true,
popular: true,
titulo: "IoT Button Handler (iot_button)",
descricao: "完整的按键管理器，支持消抖、单击、双击、多击、长按事件以及矩阵键盘。",
tags: ["按键", "消抖", "Long Press", "Double Click", "GPIO"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/button",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/button",
exemploYaml: `dependencies:
espressif/button: "^3.4.0"`
},
{
id: "espressif-led_strip",
namespace: "espressif",
name: "led_strip",
versao: "^2.5.4",
categoria: "drivers_perifericos",
oficial: true,
popular: true,
titulo: "Addressable LED Strip (WS2812/SK6812)",
descricao: "高性能驱动，使用 RMT 或 SPI 外设控制 WS2812、WS2813 和 SK6812 可寻址 LED 灯带与灯阵。",
tags: ["WS2812B", "Neopixel", "SK6812", "RMT", "LED 灯带", "RGB"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/led_strip",
urlRepo: "https://github.com/espressif/idf-extra-components/tree/master/led_strip",
exemploYaml: `dependencies:
espressif/led_strip: "^2.5.4"`
},
{
id: "espressif-esp_tinyusb",
namespace: "espressif",
name: "esp_tinyusb",
versao: "^1.5.0",
categoria: "drivers_perifericos",
oficial: true,
popular: true,
titulo: "ESP Native USB Device (TinyUSB)",
descricao: "乐鑫为 ESP32-S2、ESP32-S3 和 ESP32-P4 提供的官方 TinyUSB 扩展，可模拟 USB CDC 串口、HID 键盘/鼠标、MSC 优盘、DFU 和 WebUSB。",
tags: ["原生 USB", "TinyUSB", "USB CDC", "USB HID", "WebUSB", "MSC"],
chips: ["ESP32-S2", "ESP32-S3", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_tinyusb",
urlRepo: "https://github.com/espressif/esp-tinyusb",
exemploYaml: `dependencies:
espressif/esp_tinyusb: "^1.5.0"`
},
{
id: "espressif-w5500",
namespace: "espressif",
name: "w5500",
versao: "^1.2.0",
categoria: "drivers_perifericos",
oficial: true,
popular: true,
titulo: "WIZnet W5500 SPI Ethernet Driver",
descricao: "通过 SPI 总线驱动 WIZnet W5500 以太网芯片的官方驱动，把物理接口无缝接入 ESP-IDF 原生 TCP/IP 协议栈（lwIP）。",
tags: ["W5500", "Ethernet", "SPI Ethernet", "RJ45", "lwIP", "有线网络"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/w5500",
urlRepo: "https://github.com/espressif/esp-eth-drivers/tree/master/w5500",
exemploYaml: `dependencies:
espressif/w5500: "^1.2.0"`
},
{
id: "espressif-ch390",
namespace: "espressif",
name: "ch390",
versao: "^1.0.0",
categoria: "drivers_perifericos",
oficial: true,
popular: false,
titulo: "CH390 SPI Ethernet Driver",
descricao: "面向 WCH CH390 控制器的 SPI 10/100M 以太网驱动，适合在 ESP32-C3、S3 或 P4 开发板上低成本添加 RJ45 网口。",
tags: ["CH390", "Ethernet", "WCH", "SPI Ethernet", "RJ45"],
chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/ch390",
urlRepo: "https://github.com/espressif/esp-eth-drivers/tree/master/ch390",
exemploYaml: `dependencies:
espressif/ch390: "^1.0.0"`
},
{
id: "espressif-usb_host_uvc",
namespace: "espressif",
name: "usb_host_uvc",
versao: "^1.0.4",
categoria: "drivers_perifericos",
oficial: true,
popular: false,
titulo: "USB Host UVC (Webcam Driver)",
descricao: "USB Host 驱动，可把标准 USB UVC 网络摄像头直接接到 ESP32-S2、ESP32-S3 或 ESP32-P4 的原生 USB 口。",
tags: ["USB Host", "UVC", "Webcam", "USB 摄像头", "视频"],
chips: ["ESP32-S2", "ESP32-S3", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/usb_host_uvc",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/usb/usb_host_uvc",
exemploYaml: `dependencies:
espressif/usb_host_uvc: "^1.0.4"`
},
{
id: "espressif-sensor_hub",
namespace: "espressif",
name: "sensor_hub",
versao: "^1.0.0",
categoria: "drivers_perifericos",
oficial: true,
popular: false,
titulo: "ESP Sensor Hub Manager",
descricao: "统一的框架，用于管理异构传感器（I2C/SPI），支持周期采样、数据融合以及由事件/中断触发。",
tags: ["传感器", "Sensor Hub", "I2C", "事件", "周期采集"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/sensor_hub",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/sensors/sensor_hub",
exemploYaml: `dependencies:
espressif/sensor_hub: "^1.0.0"`
},
{
id: "espressif-bmi270_sensor",
namespace: "espressif",
name: "bmi270_sensor",
versao: "^1.0.1",
categoria: "drivers_perifericos",
oficial: true,
popular: false,
titulo: "Bosch BMI270 IMU 传感器驱动",
descricao: "面向 Bosch BMI270 六轴惯性 IMU 传感器（加速度计 + 陀螺仪）的官方驱动，支持运动手势和计步检测。",
tags: ["BMI270", "IMU", "加速度计", "陀螺仪", "Bosch", "手势"],
chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/bmi270_sensor",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/sensors/imu/bmi270",
exemploYaml: `dependencies:
espressif/bmi270_sensor: "^1.0.1"`
},
{
id: "espressif-ds18b20",
namespace: "espressif",
name: "ds18b20",
versao: "^1.0.0",
categoria: "drivers_perifericos",
oficial: true,
popular: true,
titulo: "DS18B20 温度传感器驱动",
descricao: "面向 Dallas/Maxim DS18B20 单总线（1-Wire）温度传感器的数字驱动，通过 RMT 总线支持在同一个 GPIO 引脚上挂接多个传感器。",
tags: ["DS18B20", "1-Wire", "温度", "传感器", "Dallas"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/ds18b20",
urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/sensors/temperature/ds18b20",
exemploYaml: `dependencies:
espressif/ds18b20: "^1.0.0"`
},
{
id: "esp-idf-lib-scd4x",
namespace: "esp-idf-lib",
name: "scd4x",
versao: "^1.0.0",
categoria: "drivers_perifericos",
oficial: false,
popular: true,
titulo: "Sensirion SCD40/SCD41 CO2 传感器驱动",
descricao: "面向 Sensirion SCD40 和 SCD41 光声式 CO2、温度和相对湿度传感器的高精度 I2C 驱动，带自动校准。",
tags: ["SCD40", "SCD41", "Sensirion", "CO2", "空气质量", "I2C"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/esp-idf-lib/scd4x",
urlRepo: "https://github.com/UncleRus/esp-idf-lib/tree/master/components/scd4x",
exemploYaml: `dependencies:
esp-idf-lib/scd4x: "^1.0.0"`
},
// ==========================================
// 6. BSPs (Board Support Packages)
// ==========================================
{
id: "espressif-esp-box-3",
namespace: "espressif",
name: "esp-box-3",
versao: "^1.2.0",
categoria: "bsp_placas",
oficial: true,
popular: true,
titulo: "BSP ESP32-S3-BOX-3",
descricao: "面向 ESP32-S3-BOX-3 AI 开发板的完整支持包，只需一个函数即可初始化触摸屏、音频编解码器、双麦克风、运动传感器和 LED。",
tags: ["BSP", "ESP-BOX-3", "触摸显示屏", "麦克风", "音频 ES8311", "I2C/SPI"],
chips: ["ESP32-S3"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-box-3",
urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/esp-box-3",
exemploYaml: `dependencies:
espressif/esp-box-3: "^1.2.0"`
},
{
id: "espressif-esp32_s3_korvo_2",
namespace: "espressif",
name: "esp32_s3_korvo_2",
versao: "^1.1.0",
categoria: "bsp_placas",
oficial: true,
popular: false,
titulo: "BSP ESP32-S3-Korvo-2",
descricao: "面向 ESP32-S3-Korvo-2 音频与语音识别开发套件的板级支持包（Board Support Package），支持 I2S 麦克风和触摸按键。",
tags: ["BSP", "Korvo", "音频", "麦克风阵列", "ESP-SR"],
chips: ["ESP32-S3"],
urlRegistry: "https://components.espressif.com/components/espressif/esp32_s3_korvo_2",
urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/esp32_s3_korvo_2",
exemploYaml: `dependencies:
espressif/esp32_s3_korvo_2: "^1.1.0"`
},
{
id: "espressif-esp32_s3_eye",
namespace: "espressif",
name: "esp32_s3_eye",
versao: "^1.1.0",
categoria: "bsp_placas",
oficial: true,
popular: true,
titulo: "BSP ESP32-S3-EYE",
descricao: "面向官方计算机视觉开发板 ESP32-S3-EYE 的板级支持包，配置 OV2640 摄像头、圆形 SPI LCD 显示屏和数字麦克风。",
tags: ["BSP", "ESP32-S3-EYE", "摄像头", "计算机视觉", "显示屏"],
chips: ["ESP32-S3"],
urlRegistry: "https://components.espressif.com/components/espressif/esp32_s3_eye",
urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/esp32_s3_eye",
exemploYaml: `dependencies:
espressif/esp32_s3_eye: "^1.1.0"`
},
{
id: "espressif-m5stack_core_s3",
namespace: "espressif",
name: "m5stack_core_s3",
versao: "^1.0.0",
categoria: "bsp_placas",
oficial: true,
popular: true,
titulo: "BSP M5Stack CoreS3",
descricao: "面向 M5Stack CoreS3 设备的官方板级支持包，初始化触摸屏、AXP2101 电源管理芯片、GC0308 摄像头和 I2S 扬声器。",
tags: ["BSP", "M5Stack", "CoreS3", "Display ILI9342C", "AXP2101", "摄像头"],
chips: ["ESP32-S3"],
urlRegistry: "https://components.espressif.com/components/espressif/m5stack_core_s3",
urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/m5stack_core_s3",
exemploYaml: `dependencies:
espressif/m5stack_core_s3: "^1.0.0"`
},
{
id: "waveshare-esp32_p4_wifi6_touch_lcd_7b",
namespace: "waveshare",
name: "esp32_p4_wifi6_touch_lcd_7b",
versao: "^1.0.0",
categoria: "bsp_placas",
oficial: false,
popular: true,
titulo: "BSP Waveshare ESP32-P4 Touch LCD 7\"",
descricao: "面向高性能 Waveshare ESP32-P4 开发板的支持包，配备 7 英寸电容触摸屏（MIPI-DSI 1024x600）和 Wi-Fi 6 协处理器。",
tags: ["BSP", "ESP32-P4", "MIPI-DSI", "Waveshare", "7 英寸屏", "触摸"],
chips: ["ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/waveshare/esp32_p4_wifi6_touch_lcd_7b",
urlRepo: "https://github.com/waveshare/ESP32-P4-WiFi6-Touch-LCD-7B",
exemploYaml: `dependencies:
waveshare/esp32_p4_wifi6_touch_lcd_7b: "^1.0.0"`
},
// ==========================================
// 7. Sistema & Utilitários
// ==========================================
{
id: "joltwallet-littlefs",
namespace: "joltwallet",
name: "littlefs",
versao: "^1.14.8",
categoria: "sistema_utilitarios",
oficial: false,
popular: true,
titulo: "LittleFS Filesystem for ESP-IDF",
descricao: "面向 SPI 闪存的 LittleFS 文件系统的稳健移植，带动态磨损均衡和防断电损坏保护。",
tags: ["LittleFS", "Flash", "Filesystem", "Wear Leveling", "NVS"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/joltwallet/littlefs",
urlRepo: "https://github.com/joltwallet/esp_littlefs",
exemploYaml: `dependencies:
joltwallet/littlefs: "^1.14.8"`
},
{
id: "espressif-esp-idf-cxx",
namespace: "espressif",
name: "esp-idf-cxx",
versao: "^1.2.0",
categoria: "sistema_utilitarios",
oficial: true,
popular: true,
titulo: "ESP-IDF C++ Idiomatic Wrappers",
descricao: "现代 C++（C++17/C++20/C++23）类与封装集合，采用 RAII 语义，覆盖 GPIO、Wi-Fi、定时器、FreeRTOS 队列和信号量。",
tags: ["C++", "C++20", "RAII", "Modern C++", "面向对象", "FreeRTOS"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/esp-idf-cxx",
urlRepo: "https://github.com/espressif/esp-idf-cxx",
exemploYaml: `dependencies:
espressif/esp-idf-cxx: "^1.2.0"`
},
{
id: "espressif-cbor",
namespace: "espressif",
name: "cbor",
versao: "^0.6.0",
categoria: "sistema_utilitarios",
oficial: true,
popular: false,
titulo: "TinyCBOR Serialization",
descricao: "超轻量级库，用于 CBOR（Concise Binary Object Representation）二进制格式的数据序列化与反序列化。",
tags: ["CBOR", "序列化", "二进制", "IoT Protocol", "紧凑 JSON"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/cbor",
urlRepo: "https://github.com/espressif/tinycbor",
exemploYaml: `dependencies:
espressif/cbor: "^0.6.0"`
},
{
id: "espressif-esp_websocket_client",
namespace: "espressif",
name: "esp_websocket_client",
versao: "^1.2.4",
categoria: "sistema_utilitarios",
oficial: true,
popular: true,
titulo: "ESP WebSocket Client",
descricao: "支持 TLS/SSL（WSS）、自动重连、子协议和 ping/pong 心跳的实时双向 WebSocket 客户端。",
tags: ["WebSocket", "WSS", "TLS", "实时", "Sockets", "JSON"],
chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
urlRegistry: "https://components.espressif.com/components/espressif/esp_websocket_client",
urlRepo: "https://github.com/espressif/esp-protocols/tree/master/components/esp_websocket_client",
exemploYaml: `dependencies:
espressif/esp_websocket_client: "^1.2.4"`
}
];
export const GUIA_COMPONENT_MANAGER = {
titulo: "如何在 ESP-IDF 中使用 ESP Component Registry",
resumo: "从 ESP-IDF v4.4 开始，并在 v5.x 及以后版本中趋于成熟，乐鑫采用了由 IDF Component Manager 管理的模块化包架构。不用再处理复杂的 git 子模块：现在只需在项目的 idf_component.yml 清单文件中声明所需的库。",
vantagens: [
{
titulo: "自动安装，彼此解耦",
descricao: "在执行 'idf.py build' 或 'idf.py reconfigure' 时，编译系统会自动下载、编译并管理库的版本。"
},
{
titulo: "严格的语义化版本",
descricao: "通过版本运算符精确控制何时更新（^ 表示兼容次版本，~ 表示补丁版本，也可以固定为精确版本）。"
},
{
titulo: "项目更轻量、更整洁",
descricao: "项目仓库保持干净，Git 历史中不会混入第三方代码。"
},
{
titulo: "面向企业或社区的共享",
descricao: "可以把你自己的组件发布到乐鑫的公共云，也可以发布到公司内部的私有注册中心。"
}
],
comandosCli: [
{
comando: 'idf.py add-dependency "namespace/componente^versao"',
exemplo: 'idf.py add-dependency "espressif/esp_lvgl_port^2.4.0"',
explicacao: "自动创建或更新 'main/idf_component.yml' 文件，并加入指定的依赖。"
},
{
comando: "idf.py reconfigure",
exemplo: "idf.py reconfigure",
explicacao: "强制 CMake 和 Component Manager 重新解析依赖树，并下载尚未获取的包。"
},
{
comando: "compote component upload --name <component_name> --namespace <sua_org>",
exemplo: "compote component upload --name meu_driver_sensor --namespace minhadiv",
explicacao: "使用官方的 Compote CLI 工具，把你的开源或专有组件发布到 ESP Component Registry。"
}
],
sintaxeManifesto: `# 典型的文件结构：main/idf_component.yml
dependencies:
# 从乐鑫官方注册中心下载
espressif/esp_lvgl_port: "^2.4.0"
espressif/button: "~3.4.0"
# 精确版本
espressif/led_indicator: "1.2.0"
# 社区依赖
joltwallet/littlefs: "^1.14.8"
# 本地磁盘上的依赖（可选）
# meu_driver_local:
# path: "../../components/meu_driver"`
};
lib/data/zh-CN/diagnostico.js
+744
View File
@@ -0,0 +1,744 @@
/**
* ESP32 故障诊断、常见错误与问题排查指南的结构化数据。
* 涵盖 6 个技术类别，包含根因分析、最佳实践与临时凑合方案的对比，
* 以及 Arduino C++、ESP-IDF（C）和 MicroPython 的代码示例。
* 代码示例中的注释为中文，串口日志字符串保持英文，以免终端显示乱码。
*/
export const categoriasDiagnostico = [
{
id: "alimentacao",
nome: "供电与硬件",
icone: "Zap",
cor: "amber",
descricao: "Wi-Fi/BLE 射频峰值引起的电压跌落、冲突的 Strapping 引脚、电磁噪声以及 LDO 问题。",
},
{
id: "cpu-panics",
nome: "CPU 异常与 Guru Meditation",
icone: "Cpu",
cor: "red",
descricao: "空指针、内存访问违规（Load/StoreProhibited）、非法指令以及 ISR 中的缓存异常。",
},
{
id: "freertos",
nome: "FreeRTOS 与多任务",
icone: "Layers",
cor: "purple",
descricao: "任务看门狗（TWDT）、中断看门狗（IWDT）、栈溢出（Stack Overflow）以及调度器阻塞。",
},
{
id: "memoria",
nome: "内存、堆与 PSRAM",
icone: "Activity",
cor: "blue",
descricao: "堆碎片化、内存泄漏（Memory Leaks）、DMA 内存分配以及 PSRAM 的限制。",
},
{
id: "boot-flash",
nome: "引导加载程序与烧录",
icone: "Terminal",
cor: "emerald",
descricao: "串口通信失败（DTR/RTS）、SPI 闪存读取错误、时钟不匹配与分区问题。",
},
{
id: "conectividade",
nome: "网络连接与协议",
icone: "Wifi",
cor: "cyan",
descricao: "Wi-Fi Beacon 超时、缺少 SNTP 时钟导致的 TLS/HTTPS 握手失败，以及信号不稳定。",
},
];
export const sintomasRapidos = [
{ id: "bootloop", rotulo: "🔄 反复重启（Bootloop）", categoria: "todos" },
{ id: "wifi-crash", rotulo: "📶 开启 Wi-Fi/BLE 时死机", categoria: "alimentacao" },
{ id: "upload-fail", rotulo: "🔌 烧录代码失败（Upload）", categoria: "boot-flash" },
{ id: "random-freeze", rotulo: "⏱️ 运行数分钟/数小时后死机", categoria: "memoria" },
{ id: "null-pointer", rotulo: "💥 Guru Meditation（崩溃）", categoria: "cpu-panics" },
{ id: "wdt-reset", rotulo: "🐕 Watchdog Triggered", categoria: "freertos" },
{ id: "tls-fail", rotulo: "🔒 HTTPS / SSL 失败", categoria: "conectividade" },
];
export const errosCatalogo = [
{
id: "brownout-reset",
titulo: "Brownout Detector 复位（电压跌落）",
categoria: "alimentacao",
sintomas: ["bootloop", "wifi-crash"],
gravidade: "高",
logSerial: "Brownout detector was triggered\n\nrst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)",
resumo: "ESP32 的供电电压跌到了安全工作阈值以下（约 2.8V ~ 2.43V）。",
causaRaiz:
"开启 Wi-Fi 或 BLE 射频时，功率放大级（PA）会在不到 1 毫秒内产生超过 500mA 的快速电流脉冲。如果电源、又长又细的 USB 线、面包板电源轨或 LDO 稳压器无法以低阻抗提供瞬时电流，芯片 3V3 引脚上的电压就会瞬间塌陷，触发内部的 Brownout 比较电路，以避免闪存数据损坏和不确定状态。",
gambiarra: {
titulo: "通过软件关闭 Brownout",
descricao: "调用 WRITE_PERI_REG(RTC_CNTL_BROWN_OUT_REG, 0)，在代码里让错误不再出现。",
consequencia: "极其危险：ESP32 会在欠压下继续执行指令，损坏 SPI 闪存、锁死寄存器，并在现场出现无预警的不可预测行为。",
},
solucaoEngenharia: {
titulo: "合理设计硬件与去耦",
passos: [
"在尽可能靠近 ESP32 的 3V3 和 GND 引脚处，并联一个 10µF 到 100µF 的低 ESR（Low-ESR）钽电容或陶瓷电容，以及一个 100nF 陶瓷电容。",
"使用峰值电流不低于 600mA 至 1A、瞬态响应优秀的 LDO 稳压器（例如 AP2112K、ME6211、TPS73733 或可靠的 XC6206）。避免使用老款 AMS1117 的劣质仿品。",
"当 Wi-Fi 以最大功率发射时，避免用很长的面包板电源轨加细杜邦线给 ESP32 供电。",
],
},
codigoArduino: `// 不要关闭 Brownout！如果测试时需要降低峰值：
#include <WiFi.h>
void setup() {
Serial.begin(115200);
// 可选：把 Wi-Fi 最大发射功率从 20dBm 略降到 17dBm，
// 可使电流峰值降低约 20%
WiFi.setTxPower(WIFI_POWER_17dBm);
WiFi.begin("SSID", "PASSWORD");
}`,
codigoEspIdf: `// ESP-IDF 中的配置：
#include "esp_wifi.h"
#include "esp_log.h"
void app_main(void) {
// 在 menuconfig 中：Component config -> ESP32-specific -> Hardware Brownout Reset（始终保持开启）
// 在有功率限制的环境中降低峰值：
esp_wifi_set_max_tx_power(68); // 68 = 17dBm（单位为 0.25dBm）
}`,
codigoMicroPython: `# MicroPython 中带稳定等待的安全 Wi-Fi 连接：
import network
import time
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
# 等待供电稳定后再开始发射
time.sleep_ms(200)
wlan.connect("SSID", "PASSWORD")
tentativas = 0
while not wlan.isconnected() and tentativas < 30:
time.sleep_ms(200)
tentativas += 1
if wlan.isconnected():
print("Wi-Fi connected! IP:", wlan.ifconfig()[0])
else:
print("[ERROR] Failed to connect to Wi-Fi")`,
dicaPro: "如果你在设计自己的 PCB，请在模组下方铺设完整的地平面，并让电源走线宽度至少为 0.5mm 到 1mm，以承受电流浪涌而不产生阻性压降（IR drop）。",
},
{
id: "strapping-pins",
titulo: "启动时 Strapping 引脚冲突",
categoria: "alimentacao",
sintomas: ["bootloop", "upload-fail"],
gravidade: "严重",
logSerial: "rst:0x1 (POWERON_RESET),boot:0x12 (SPI_FAST_FLASH_BOOT)\nflash read err, 1000\nwaiting for download",
resumo: "ESP32 无法从闪存启动固件，或意外进入下载模式，原因是某个 Strapping 引脚在复位时被强制到了错误的逻辑电平。",
causaRaiz:
"在 EN/CHIP_PU 引脚拉高（上电复位）的瞬间，CPU 会对特定引脚（Strapping 引脚）的状态采样，以配置闪存电压（1.8V 或 3.3V）、启动模式（UART 下载或 SPI 闪存）和时钟输出。如果你在这些引脚上接了带上拉/下拉的传感器、继电器或 LED，微控制器读到的就是无效逻辑电平，启动随之卡住。",
gambiarra: {
titulo: "在代码里加延时，或每次上电都手动拔线",
descricao: "试图在 setup() 里用软件解决问题，或依赖每次重启前手动断开连线。",
consequencia: "没用：Strapping 引脚由硬件读取，此时 CPU 还没有加载你的代码或引导加载程序中的任何一行。",
},
solucaoEngenharia: {
titulo: "安全的 GPIO 分配与复位期间隔离",
passos: [
"经典 ESP32：避免使用 GPIO 0（Boot）、GPIO 2（闪存启动时必须为 LOW 或悬空）、GPIO 12（决定闪存电压：复位时若被拉高，会损坏或卡死 3.3V 闪存）以及 GPIO 15（为 LOW 时屏蔽启动日志）。",
"ESP32-C3：避免在复位时把 GPIO 8 或 GPIO 9 拉低。",
"ESP32-S3：注意 GPIO 0、GPIO 45（VDD_SPI 电压）和 GPIO 46。",
"如果必须把这些引脚用于外设，请用三极管或缓冲器隔离，直到 EN 信号完全稳定。",
],
},
codigoArduino: `// 安全引脚分配建议（经典 ESP32）：
// 适合 I2C / SPI / 一般传感器的引脚：
// SDA: GPIO 21 | SCL: GPIO 22
// SPI: MOSI 23 | MISO 19 | SCK 18 | CS 5
// 注意：GPIO 34、35、36 (VP)、39 (VN) 只能作输入（没有内部上拉）。
// 不要对它们使用 pinMode(..., OUTPUT)，也不要用于 I2C/SPI。`,
codigoEspIdf: `// 在 ESP-IDF 中，通过 eFuse 固定闪存电压设置（注意：不可逆）：
// 如果你使用经典 ESP32 且需要释放 GPIO12，可以烧写 3.3V 的 eFuse：
// espefuse.py --port /dev/ttyUSB0 set_flash_voltage 3.3V
// 这会永久关闭 GPIO12 上的硬件采样。`,
codigoMicroPython: `# MicroPython 中正确的引脚配置：
from machine import Pin
# ✅ 可安全用于输出和带内部上拉按键的引脚：
led = Pin(2, Pin.OUT) # GPIO 2
botao = Pin(4, Pin.IN, Pin.PULL_UP) # GPIO 4（安全）
# ⚠️ 引脚 34、35、36、39 只能作输入，且没有内部上拉：
sensor_analogico = Pin(36, Pin.IN) # 正确（若用作按键，需要外接电阻）`,
dicaPro: "请始终记住：“仅输入”引脚（经典 ESP32 的 GPI 34 到 39）在芯片内没有上拉/下拉电路，也没有输出三极管。在这些引脚上接模拟传感器或按键，需要外接上拉电阻。",
},
{
id: "guru-load-prohibited",
titulo: "Guru Meditation：LoadProhibited / StoreProhibited",
categoria: "cpu-panics",
sintomas: ["bootloop", "null-pointer"],
gravidade: "严重",
logSerial: "Guru Meditation Error: Core 0 panic'ed (LoadProhibited). Exception was unhandled.\nCore 0 register dump:\nPC : 0x400d14bc PS : 0x00060830 A0 : 0x800d1512 A1 : 0x3ffb1f20 \nEXCVADDR: 0x00000000",
resumo: "CPU 试图读取（Load）或写入（Store）一个不可访问或无效的内存地址，通常是空地址 0x00000000。",
causaRaiz:
"这是典型的空指针解引用（Null Pointer Dereference）或野指针（Dangling Pointer）。EXCVADDR 寄存器给出了引发故障的地址：如果 EXCVADDR 为 0x00000000 或非常接近零（例如 0x00000008，即结构体成员的偏移），就说明你访问了一个未初始化、或 malloc/创建失败的对象/指针的成员。",
gambiarra: {
titulo: "随便加延时，或在循环里不处理就重启",
descricao: "以为是时序问题，在代码里堆满 delay()，或者不查原因就屏蔽自动重启。",
consequencia: "空指针条件再次出现时，系统在量产环境中仍会随机崩溃。",
},
solucaoEngenharia: {
titulo: "防御式校验与 Backtrace 解码",
passos: [
"在访问返回值的成员之前，始终检查分配或查找类函数（malloc、WiFi.client()、JSON 解析、xQueueReceive）是否返回了 NULL。",
"在你的 IDE（Arduino IDE / PlatformIO）中安装“Espressif Exception Decoder”，或使用命令 'xtensa-esp32-elf-addr2line -pfia -e firmware.elf 0x400d14bc'，精确找到崩溃发生在 .c/.cpp 的哪一行。",
"在 ESP-IDF 中运行 'idf.py monitor'，它会实时自动解码栈回溯。",
],
},
codigoArduino: `// 防御式编程：
struct SensorData {
float temperatura;
float umidade;
};
void processarSensor(SensorData* sensor) {
// 防止 LoadProhibited 的必要检查：
if (sensor == nullptr) {
Serial.println("[ERROR] Null sensor pointer!");
return;
}
Serial.printf("Temp: %.1f C\\n", sensor->temperatura);
}`,
codigoEspIdf: `// 在 ESP-IDF 中使用 ESP_ERROR_CHECK 或显式断言：
#include "esp_log.h"
#include "esp_check.h"
static const char* TAG = "SENSOR";
esp_err_t ler_dado(char* buffer, size_t max_len) {
ESP_RETURN_ON_FALSE(buffer != NULL, ESP_ERR_INVALID_ARG, TAG, "Null buffer provided!");
// 安全的操作...
return ESP_OK;
}`,
codigoMicroPython: `# 在 MicroPython 中防止 NoneType 和对象异常：
import json
def processar_sensor(dados_raw):
# 防御式处理空 payload：
if dados_raw is None:
print("[ERROR] Null data received!")
return None
try:
obj = json.loads(dados_raw)
# 安全使用带默认值的 .get()，避免 KeyError
temperatura = obj.get("temp", 0.0)
return temperatura
except (ValueError, AttributeError) as e:
print("Error processing object:", e)
return None`,
dicaPro: "如果 EXCVADDR 类似 0x3fxxxxxx 或 0x40xxxxxx 但你的代码仍然出错，可能是数组越界访问（buffer overflow）覆盖了内存中的指针。",
},
{
id: "guru-iram-cache",
titulo: "ISR 中的 Cache Error / InstructionFetchError",
categoria: "cpu-panics",
sintomas: ["bootloop", "null-pointer"],
gravidade: "高",
logSerial: "Guru Meditation Error: Core 0 panic'ed (Cache disabled but cached memory region accessed)\nGuru Meditation Error: Core 0 panic'ed (InstructionFetchError)",
resumo: "中断服务例程（ISR）试图在 SPI 闪存因读写操作而被禁用时，执行闪存中的代码或读取其中的数据。",
causaRaiz:
"默认情况下，ESP32 的代码存放在外部闪存中，并通过内部缓存（Cache）按需加载给 CPU。当 ESP32 向闪存写入数据（如写入 NVS、LittleFS、SPIFFS 或 OTA 升级）时，控制器会暂时关闭指令缓存。如果此刻触发了硬件中断（定时器、GPIO 等），而 ISR 函数位于闪存中，CPU 就取不到下一条指令，立即陷入异常。",
gambiarra: {
titulo: "写闪存前关闭中断",
descricao: "不加区分地用 noInterrupts() 包住所有文件写入操作。",
consequencia: "会丢失高速传感器的脉冲，导致系统定时器不稳定，并可能引发看门狗溢出。",
},
solucaoEngenharia: {
titulo: "把 ISR 与常量放进 IRAM / DRAM",
passos: [
"给每一个中断回调函数都加上 IRAM_ATTR 属性（或 IRAM_ATTR static void...）。",
"确保 ISR 中访问的变量或字符串也位于 DRAM 中（在 ESP-IDF 中，避免在 ISR 里直接使用没有 DRAM_ATTR 标记的字符串字面量）。",
"不要在 ISR 里调用外部库的重型函数（如 Serial.print 或大量浮点计算）。",
],
},
codigoArduino: `// 正确放入 IRAM 的 ISR：
volatile uint32_t contadorPulsos = 0;
void IRAM_ATTR tratarInterrupcaoGPIO() {
contadorPulsos++;
}
void setup() {
pinMode(4, INPUT_PULLUP);
attachInterrupt(digitalPinToInterrupt(4), tratarInterrupcaoGPIO, FALLING);
}`,
codigoEspIdf: `// 在 ESP-IDF 中：
#include "esp_attr.h"
#include "driver/gpio.h"
static volatile uint32_t pulsos = 0;
// 显式放入内部 IRAM 的函数：
static void IRAM_ATTR gpio_isr_handler(void* arg) {
pulsos++;
}
void app_main(void) {
gpio_install_isr_service(ESP_INTR_FLAG_IRAM);
gpio_isr_handler_add(GPIO_NUM_4, gpio_isr_handler, NULL);
}`,
codigoMicroPython: `# MicroPython 中安全的中断（ISR）处理：
import micropython
from machine import Pin
# 分配应急缓冲区，用于调试 ISR 内部的异常：
micropython.alloc_emergency_exception_buf(100)
contador_pulsos = 0
# 中断回调：不要分配内存（不要创建字符串，不要产生新的浮点数）
def tratar_pulso(pin):
global contador_pulsos
contador_pulsos += 1
sensor = Pin(4, Pin.IN, Pin.PULL_UP)
sensor.irq(trigger=Pin.IRQ_FALLING, handler=tratar_pulso)`,
dicaPro: "如果在 ESP-IDF 中注册中断时传入了 ESP_INTR_FLAG_IRAM，那么该中断调用的任何函数（包括 FreeRTOS 函数）都必须支持 IRAM（例如 xQueueSendFromISR）。",
},
{
id: "freertos-twdt",
titulo: "任务看门狗定时器（TWDT）超时",
categoria: "freertos",
sintomas: ["bootloop", "wdt-reset"],
gravidade: "严重",
logSerial: "E (10532) task_wdt: Task watchdog got triggered. The following tasks/users did not reset the watchdog in time:\nE (10532) task_wdt: - IDLE0 (CPU 0)\nTask watchdog got triggered. System will be reset.",
resumo: "一个高优先级任务陷入阻塞式循环，没有让出 CPU 时间，使 IDLE 任务无法喂狗。",
causaRaiz:
"ESP32 上的 FreeRTOS 在每个 CPU 内核上都运行一个优先级为 0 的关键任务，名为 IDLE。任务看门狗会监测 IDLE 任务能否周期性运行（默认每 5 秒）。如果你创建了一个优先级 >= 1 的任务，其中有 while(1) 循环却没有任何阻塞调用（vTaskDelay、读队列、信号量），CPU 就会 100% 被占满，看门狗随即触发紧急复位。",
gambiarra: {
titulo: "在 menuconfig 里关闭任务看门狗，或把它调到 60 秒",
descricao: "关掉 TWDT，让代码不再重启。",
consequencia: "如果代码陷入死循环或死锁，微控制器会永远冻结，只能有人跑到现场拔电源。",
},
solucaoEngenharia: {
titulo: "事件驱动架构与让出 CPU（Yield）",
passos: [
"在 FreeRTOS 任务中，不要使用空的忙等待循环 while(!condicao);。",
"始终加入 vTaskDelay(pdMS_TO_TICKS(10))，或通过带超时的 xQueueReceive()、ulTaskNotifyTake() 或 xSemaphoreTake() 等待事件。",
"如果必须持续进行繁重的数学运算，请用 esp_task_wdt_reset() 显式喂狗。",
],
},
codigoArduino: `// Arduino 搭配 FreeRTOS 的正确写法：
void minhaTarefa(void *pvParameters) {
for (;;) {
// 读取传感器
float valor = analogRead(36);
// 把 CPU 让给 FreeRTOS 和 IDLE 任务：
vTaskDelay(pdMS_TO_TICKS(100)); // 以非阻塞方式等待 100ms
}
}`,
codigoEspIdf: `// ESP-IDF 中使用任务看门狗：
#include "esp_task_wdt.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
void tarefa_processamento(void *pvParameters) {
// 可选：把当前任务注册到 TWDT
esp_task_wdt_add(NULL);
while (1) {
// 处理...
// 如果这段处理很长，就喂狗：
esp_task_wdt_reset();
vTaskDelay(pdMS_TO_TICKS(50));
}
}`,
codigoMicroPython: `# MicroPython 中使用 uasyncio 的看门狗与非阻塞循环：
from machine import WDT
import uasyncio as asyncio
# 初始化硬件看门狗，超时 5 秒
wdt = WDT(timeout=5000)
async def tarefa_sensor():
while True:
# 每个正常周期都喂狗：
wdt.feed()
# 把控制权交还给协作式调度器：
await asyncio.sleep_ms(100)
async def main():
asyncio.create_task(tarefa_sensor())
while True:
await asyncio.sleep(1)
asyncio.run(main())`,
dicaPro: "在 Arduino 中，delay(ms) 函数内部其实调用的是 FreeRTOS 的 vTaskDelay。但使用 delayMicroseconds() 的循环或纯 CPU 运算不会让出时间，持续数秒以上就可能触发 TWDT。",
},
{
id: "freertos-stack-overflow",
titulo: "栈溢出（Stack Overflow）",
categoria: "freertos",
sintomas: ["bootloop", "null-pointer"],
gravidade: "严重",
logSerial: "Guru Meditation Error: Core 1 panic'ed (Unhandled debug exception).\nDebug exception reason: Stack canary watchpoint triggered (minha_tarefa)",
resumo: "任务消耗的栈（Stack）内存超过了创建时分配的大小，破坏了 RTOS 的保护金丝雀（canary）。",
causaRaiz:
"FreeRTOS 中的每个任务都会得到一块固定的连续内存，用来存放局部变量、函数参数和调用的返回地址。如果你声明了大数组（如 char buffer[2048];）、实例化了较大的 JSON 缓冲区（如 DynamicJsonDocument doc(4096);），或在默认栈为 2048 字节的任务里做很深的递归调用，栈就会越界并覆盖系统的关键区域。",
gambiarra: {
titulo: "不加考虑地给所有任务都设 64KB 栈",
descricao: "分配巨大的栈，免得操心溢出。",
consequencia: "ESP32 的内部 SRAM（实际可用约 320KB）很快会耗尽，导致 Wi-Fi 初始化和堆分配失败。",
},
solucaoEngenharia: {
titulo: "有意识地确定大小，并用 HighWaterMark 监控",
passos: [
"使用 uxTaskGetStackHighWaterMark() 函数测量栈的实际消耗。它返回自启动以来栈剩余空闲字节/字数的最小值。",
"把体积大的缓冲区从栈移到动态堆（临时使用 malloc/free），如果会被重复使用，则在函数作用域外声明为 static。",
"使用 TLS/HTTPS 安全连接或 SSL 的 MQTT 的任务，由于 MbedTLS 加密例程很复杂，至少需要 6KB 到 8KB 的栈。",
],
},
codigoArduino: `// 在 Arduino 中监控栈：
void tarefaSensor(void *pvParameters) {
for (;;) {
// 任务代码...
// 检查栈的最小剩余空间（经典 FreeRTOS 以 Word 为单位，ESP32 以字节为单位）
UBaseType_t espacoLivre = uxTaskGetStackHighWaterMark(NULL);
Serial.printf("[STACK] Minimum free space: %d bytes\\n", (int)espacoLivre);
vTaskDelay(pdMS_TO_TICKS(5000));
}
}
void setup() {
Serial.begin(115200);
// 合理地分配 4096 字节（4KB）：
xTaskCreatePinnedToCore(tarefaSensor, "tarefaSensor", 4096, NULL, 1, NULL, 1);
}`,
codigoEspIdf: `// 在 menuconfig 中启用栈的双重检查：
// Component config -> FreeRTOS -> Set a end of stack check -> Option 2 (Check by Stack Canary)
// 这样能在运行时数据被破坏之前就检测到溢出。`,
codigoMicroPython: `# MicroPython 中监控内存与栈：
import gc
import micropython
# 输出 Python 虚拟机的 RAM 与栈统计：
micropython.mem_info()
# 运行垃圾回收，释放孤立的内存块：
gc.collect()
print("Free heap:", gc.mem_free(), "bytes")
print("Allocated heap:", gc.mem_alloc(), "bytes")`,
dicaPro: "如果函数只是偶尔处理一次 JSON 或 HTTP 数据包，请只在处理期间把缓冲区分配在堆上，用完立刻释放，而不是撑大任务的常驻栈。",
},
{
id: "memoria-fragmentacao-heap",
titulo: "堆碎片化与内存泄漏",
categoria: "memoria",
sintomas: ["random-freeze", "tls-fail"],
gravidade: "高",
logSerial: "E (45892) mbedtls: mbedtls_ssl_setup returned -0x7f00\nE (45892) esp-tls: create_ssl_handle failed\nE (45893) HTTP_CLIENT: Connection failed, out of memory",
resumo: "微控制器分配内存失败，尽管报告的空闲内存总量看起来还很多。",
causaRaiz:
"当长时间发生成千上万次大小不一的分配与释放时（在 Arduino 中对 String 对象在循环里不断拼接文本时非常常见），堆就会碎片化。堆被分割成许多被占用块隔开的小空闲块。当 Wi-Fi 驱动或 TLS 库需要一块连续的 40KB 作为 SSL 加密缓冲区时，即便分散的空闲内存总共有 100KB，malloc 也会失败。",
gambiarra: {
titulo: "每隔 X 小时用 ESP.restart() 定期重启 ESP32",
descricao: "安排每天重启一次，以清理碎片化的内存。",
consequencia: "只是掩盖缺陷：在请求高峰时，设备会远早于计划的重启就崩溃。",
},
solucaoEngenharia: {
titulo: "避免动态字符串，使用预先分配的静态缓冲区",
passos: [
"在 Arduino 中避免使用 String 类。使用 C 风格的字符缓冲区（char buffer[128];）和 snprintf() 这类安全函数。",
"通过对照空闲内存总量（heap_caps_get_free_size）与最大连续空闲块（heap_caps_get_largest_free_block）来监控碎片化。",
"在复杂的 ESP-IDF 固件中，启用堆内存追踪（Heap Memory Tracing，CONFIG_HEAP_TRACING），精确列出是哪些文件和行忘了调用 free()。",
],
},
codigoArduino: `// 对比：
// ❌ 避免（会造成严重的堆碎片化）：
// String json = "{\\"temp\\":";
// json += String(temperatura) + "}";
// ✅ 正确（不在堆上动态分配）：
char payload[64];
snprintf(payload, sizeof(payload), "{\\"temp\\":%.2f,\\"umid\\":%.2f}", temperatura, umidade);
// 监控：
Serial.printf("Free heap: %u | Largest block: %u\\n",
ESP.getFreeHeap(),
ESP.getMaxAllocHeap());`,
codigoEspIdf: `// ESP-IDF 中的堆监控：
#include "esp_heap_caps.h"
#include "esp_log.h"
void inspecionar_memoria(void) {
size_t livre_total = heap_caps_get_free_size(MALLOC_CAP_8BIT);
size_t maior_bloco = heap_caps_get_largest_free_block(MALLOC_CAP_8BIT);
ESP_LOGI("HEAP", "Total free: %d bytes | Largest contiguous block: %d bytes", livre_total, maior_bloco);
}`,
codigoMicroPython: `# MicroPython 中预防堆碎片化：
import gc
# 1. 启用自动回收
gc.enable()
# 2. 预先分配 bytearray 并复用，而不是创建新字符串：
buffer_leitura = bytearray(256)
def ler_sensor_sem_alocacao(stream):
# 复用同一块内存读取（零分配，Zero-Allocation）：
bytes_lidos = stream.readinto(buffer_leitura)
return buffer_leitura[:bytes_lidos]
# 3. 在建立重量级连接（如 HTTPS / TLS）之前触发 GC：
gc.collect()
print(f"Free heap: {gc.mem_free()} B | Allocated: {gc.mem_alloc()} B")`,
dicaPro: "如果最大连续空闲块小于 35KB ~ 40KB，现代 HTTPS/TLS 连接会在证书握手期间失败。",
},
{
id: "memoria-dma-psram",
titulo: "在外部内存（PSRAM）中分配 DMA 失败",
categoria: "memoria",
sintomas: ["bootloop", "random-freeze"],
gravidade: "高",
logSerial: "E (1204) spi_master: spi_bus_initialize: DMA channel not compatible with external RAM buffer\nESP_ERROR_CHECK failed: esp_err_t 0x102 (ESP_ERR_INVALID_ARG)",
resumo: "固件试图把分配在外部 PSRAM 中的缓冲区交给带 DMA 的外设（SPI、I2S、LCD、SDMMC），而这些外设只能访问内部 SRAM。",
causaRaiz:
"在 ESP32 系列芯片中（尤其是采用标准总线的经典 ESP32、ESP32-S2 和 ESP32-S3），外设的 DMA 控制器没有直接访问通过 SPI/QSPI 连接的外部 PSRAM 的物理总线。DMA 要求收发缓冲区必须位于芯片的内部 SRAM 中。",
gambiarra: {
titulo: "关闭外设的 DMA",
descricao: "把 SPI/I2S 总线配置为不用 DMA 的轮询模式。",
consequencia: "传输速率大幅下降，向显示屏发送帧或进行音频流传输时 CPU 被 100% 占满。",
},
solucaoEngenharia: {
titulo: "用 MALLOC_CAP_DMA 和 MALLOC_CAP_INTERNAL 显式分配",
passos: [
"始终使用 heap_caps_malloc(大小, MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL) 函数分配专用于 DMA 的缓冲区。",
"把体积大的非 DMA 数据（如解码后的图像、机器学习模型和待播放的音频）保留在 PSRAM 中，并按需把较小的块复制到内部的 DMA 缓冲区（乒乓缓冲，ping-pong buffering）。",
],
},
codigoArduino: `// 在 Arduino ESP32 中分配 DMA 缓冲区：
#include <esp_heap_caps.h>
uint8_t* dmaBuffer = nullptr;
void setup() {
size_t tamanho = 4096;
// 确保缓冲区位于支持 DMA 的内部 SRAM 中：
dmaBuffer = (uint8_t*) heap_caps_malloc(tamanho, MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL);
if (dmaBuffer == nullptr) {
Serial.println("[ERROR] Failed to allocate DMA buffer in internal memory!");
}
}`,
codigoEspIdf: `// ESP-IDF：
#include "esp_heap_caps.h"
uint8_t* alocar_buffer_spi(size_t len) {
return (uint8_t*) heap_caps_aligned_alloc(4, len, MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL);
}`,
codigoMicroPython: `# 在 MicroPython 中，检查可用的 PSRAM 内存：
import gc
import esp32
# 如果固件编译时带有 SPIRAM 支持（例如名称含 'SPIRAM' 的固件）：
print("Total memory accessible in MicroPython:", gc.mem_free() + gc.mem_alloc(), "bytes")
# 对外设做快速操作时，使用连续的 bytearray：
buffer_spi = bytearray(1024)`,
dicaPro: "在 ESP32-P4 上，先进的 AXI 总线架构允许在某些外部区域使用 DMA，但对整个 ESP32/S2/S3/C3 系列，必须使用内部 SRAM 的规则是严格的。",
},
{
id: "boot-failed-connect",
titulo: "Failed to connect to ESP32: Timed out waiting for packet header",
categoria: "boot-flash",
sintomas: ["upload-fail"],
gravidade: "中",
logSerial: "A fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header\nesptool.py v4.6\nConnecting...................",
resumo: "烧录工具（esptool / Arduino IDE / PlatformIO）无法让微控制器进入 UART 引导加载模式。",
causaRaiz:
"开始烧录固件时，USB 转串口芯片（CH340、CP2102、FTDI）会通过 DTR 和 RTS 线把 GPIO 0 引脚拉低，同时让 EN/RST 引脚先拉低再拉高。在许多常见开发板上，EN 引脚的 RC（电阻电容）延时电路电容量不足，无法在 DTR 信号变化期间保持复位。",
gambiarra: {
titulo: "每次烧录都用手指按住 BOOT 按钮",
descricao: "每次编译器生成完二进制文件后，都要按一下物理 BOOT/GPIO0 按钮。",
consequencia: "不利于敏捷开发，对于封装好的或装在外壳内的板子则根本做不到。",
},
solucaoEngenharia: {
titulo: "在 EN 引脚加 10µF 电容，或检查数据线",
passos: [
"在板子的 EN（RST）引脚和 GND 之间接一个 10µF（或 1µF 到 10µF）的电解电容或陶瓷电容，以稳定自动复位的上升斜坡。",
"检查 USB 线的数据线（D+ 和 D-）是否正常。许多便宜的手机充电线只有 VBUS 和 GND 两根电源线。",
"在 Linux 上，确认你的用户属于 'dialout' 组（sudo usermod -a -G dialout $USER），并且 'brltty' 服务没有占用串口。",
],
},
codigoArduino: `// 用 esptool 测试串口通信的命令行提示：
// python -m esptool --port /dev/ttyUSB0 chip_id
// 如果返回了 MAC 地址和芯片型号，说明物理通信完全正常。`,
codigoEspIdf: `// 在 ESP-IDF 中：
// idf.py -p /dev/ttyUSB0 -b 460800 flash
// 如果高速烧录失败，请把波特率降到 115200：
// idf.py -p /dev/ttyUSB0 -b 115200 flash`,
codigoMicroPython: `# 通过终端把官方 MicroPython 固件烧录到 ESP32：
# 1. 擦除闪存：
# esptool.py --port /dev/ttyUSB0 erase_flash
# 2. 以稳妥的波特率写入二进制文件：
# esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x1000 ESP32_GENERIC-*.bin`,
dicaPro: "如果你使用的是带原生 USB（Direct USB-JTAG）的 ESP32-S3 或 C3 模组，请确认选择的是 CDC/JTAG 端口，而不是传统的 UART 端口。",
},
{
id: "tls-sntp-clock-fail",
titulo: "时钟不同步导致 TLS/HTTPS 握手失败",
categoria: "conectividade",
sintomas: ["tls-fail", "random-freeze"],
gravidade: "高",
logSerial: "E (15420) esp-tls-mbedtls: mbedtls_ssl_handshake returned -0x2700\nE (15420) esp-tls: Failed to verify peer certificate!\nE (15421) esp-tls: Verification info: The certificate is not yet valid (or has expired)",
resumo: "HTTPS 安全连接、AWS IoT、带 TLS 的 MQTT 或 Web API 失败，原因是 ESP32 的内部时钟停在默认日期 1970 年 1 月 1 日。",
causaRaiz:
"数字安全证书（X.509 SSL/TLS）有严格的有效期（Not Before 和 Not After）。由于 ESP32 默认没有外部 RTC 电池，上电时内部时钟总是从 Unix 纪元零点（1970 年）开始。MbedTLS 客户端校验服务器证书的日期时，会认为证书“尚未生效”（因为相对 1970 年，2026 年是未来），并立刻以错误 -0x2700（MBEDTLS_ERR_X509_CERT_VERIFY_FAILED）中止加密连接。",
gambiarra: {
titulo: "关闭 SSL 证书校验（Insecure / No-Verify）",
descricao: "在 Arduino 中使用 client.setInsecure()，或在 ESP-IDF 中关闭 CA 检查。",
consequencia: "开了一个非常严重的安全缺口：设备易受中间人攻击（MitM），攻击者可以截获密码和固件。",
},
solucaoEngenharia: {
titulo: "在 TLS 连接之前，必须通过 SNTP 同步日期和时间",
passos: [
"在 Wi-Fi 获得 IP 之后，立即启动 SNTP 客户端，指向可靠的服务器（如 pool.ntp.org、time.google.com）。",
"等待时钟状态变为已同步，再发起第一次 HTTPS/MQTT 连接。",
"配置正确的时区（Timezone），让日志显示准确的时间。",
],
},
codigoArduino: `// Arduino 中 HTTPS 之前先做 SNTP 同步：
#include <WiFi.h>
#include <time.h>
void sincronizarRelogio() {
// 配置 NTP 服务器（pool.ntp.org 和 Google）
configTime(8 * 3600, 0, "pool.ntp.org", "time.google.com");
Serial.print("Waiting for time sync");
time_t now = time(nullptr);
// 2020 年的 Unix 时间是 1577836800。如果更小，说明仍停在 1970 年：
while (now < 1577836800) {
delay(500);
Serial.print(".");
now = time(nullptr);
}
Serial.println("\\n[OK] Time synchronized! TLS connections enabled.");
}`,
codigoEspIdf: `// ESP-IDF 中的 SNTP：
#include "esp_sntp.h"
#include "esp_log.h"
void inicializar_sntp(void) {
ESP_LOGI("SNTP", "Starting SNTP client...");
esp_sntp_setoperatingmode(SNTP_OPMODE_POLL);
esp_sntp_setservername(0, "pool.ntp.org");
esp_sntp_init();
// 等待时钟同步...
}`,
codigoMicroPython: `# MicroPython 中的 SNTP 同步与 HTTPS 请求：
import ntptime
import time
import urequests
def sincronizar_e_requisitar():
try:
print("Syncing clock via NTP...")
ntptime.host = "pool.ntp.org"
ntptime.settime() # 通过 NTP 更新 ESP32 的内部 RTC
print("Synchronized UTC time:", time.localtime())
# 现在 TLS 握手可以正常校验证书，不会再出现 -0x2700 错误：
resposta = urequests.get("https://api.github.com")
print("HTTPS response:", resposta.status_code)
resposta.close()
except Exception as e:
print("[TLS/NTP ERROR]:", e)`,
dicaPro: "如果你的项目运行在无法访问外部互联网的环境（隔离的局域网），请在路由器上配置本地 NTP 服务器，或通过 I2C 添加 DS3231 之类的实体 RTC 模块。",
},
];
export const regrasDecodificadorLog = [
{
padrao: /Brownout detector was triggered/i,
titulo: "Brownout Detector（严重欠压）",
tipo: "供电 / 硬件",
explicacao:
"ESP32 的 3V3 引脚电压跌到了安全水平以下（通常是 Wi-Fi/BLE 射频的电流峰值，或电源容量不足所致）。",
acaoRecomendada:
"在 VCC 处加一个 10µF 到 100µF 的低 ESR 电容，使用稳定的电源，并检查 LDO 稳压器。",
},
{
padrao: /LoadProhibited|StoreProhibited/i,
titulo: "Guru Meditation：Load/StoreProhibited（空指针或无效指针）",
tipo: "CPU 异常 / 异常",
explicacao:
"试图读取或写入内存中的无效地址（几乎总是 NULL 指针解引用或数组越界）。",
acaoRecomendada:
"用 Exception Decoder 或 'addr2line' 解码 Backtrace，找到确切的行。加入防御式检查 `if (ptr != NULL)`。",
},
{
padrao: /Cache disabled but cached memory region accessed|InstructionFetchError/i,
titulo: "中断中的 Cache Error（ISR 不在 IRAM 中）",
tipo: "CPU 异常 / 闪存",
explicacao:
"中断服务例程（ISR）试图从闪存运行，而此时闪存正忙于写入数据（NVS、LittleFS 或 OTA）。",
acaoRecomendada:
"给中断函数加上 `IRAM_ATTR` 属性，并确保它不会访问闪存中没有 DRAM_ATTR 的变量。",
},
{
padrao: /Task watchdog got triggered/i,
titulo: "任务看门狗定时器（TWDT）超时",
tipo: "FreeRTOS / 多任务",
explicacao:
"一个高优先级任务独占 CPU 而不让出时间（没有 vTaskDelay 或阻塞），使 IDLE 任务的看门狗无法喂狗。",
acaoRecomendada:
"在长循环中加入 `vTaskDelay(pdMS_TO_TICKS(10))`，或使用队列/信号量来代替持续的 `while(1)` 循环。",
},
{
padrao: /Stack canary watchpoint triggered/i,
titulo: "栈溢出（任务栈溢出）",
tipo: "FreeRTOS / 内存",
explicacao:
"任务超出了创建时分配的栈（Stack）内存量，破坏了保护金丝雀。",
acaoRecomendada:
"在 `xTaskCreate` 中增大栈的大小（例如从 2048 增加到 4096 字节），并把大数组移到堆或静态变量中。",
},
{
padrao: /Timed out waiting for packet header|Failed to connect to ESP32/i,
titulo: "UART / 烧录连接失败",
tipo: "引导加载程序 / 连接",
explicacao:
"电脑无法通过 DTR/RTS 让 ESP32 进入烧录模式，或 USB 线没有数据线。",
acaoRecomendada:
"在 EN 引脚和 GND 之间接一个 10µF 电容，换一根带数据线的 USB 线，并在连接时尝试按住 BOOT 按钮。",
},
{
padrao: /The certificate is not yet valid|-0x2700/i,
titulo: "SSL/TLS 证书失败（时钟停在 1970 年）",
tipo: "网络连接 / TLS",
explicacao:
"ESP32 试图在日期仍为 Unix 纪元零点（1970 年 1 月 1 日）的情况下验证 HTTPS/TLS 证书。",
acaoRecomendada:
"在发起安全的 HTTPS 请求之前，通过 SNTP 同步时间（Arduino 中用 `configTime`，MicroPython 中用 `ntptime.settime()`）。",
},
{
padrao: /rst:0x1 \(POWERON_RESET\),boot:0x[0-9a-fA-F]+/i,
titulo: "上电复位 / Strapping 引脚",
tipo: "硬件 / 启动",
explicacao:
"微控制器重启并报告了 Strapping 引脚寄存器。如果之后卡住，可能是某个启动引脚处于错误的逻辑电平。",
acaoRecomendada:
"检查 GPIO 0、2、12、15（ESP32）或 8、9（C3）是否连着在启动时会强制出错误电平的电阻或外设。",
},
];
lib/data/zh-CN/glossario.js
+408
View File
@@ -0,0 +1,408 @@
/**
* ESP32 技术术语表的结构化数据。
* 涵盖乐鑫全部芯片系列（ESP32、S2、S3、S31、C2、C3、C5、C6、C61、H2、H4、P4）
* 及其硬件、外设、无线、安全与软件特性。
*/
export const categoriasGlossario = [
{
id: "processamento",
nome: "处理器、CPU 与芯片",
icone: "Cpu",
emoji: "🧠",
cor: "blue",
descricao: "Xtensa 与 RISC-V 架构、内核、ULP 协处理器、AI 向量加速器和浮点运算单元。",
termos: [
{
termo: "Xtensa 与 RISC-V 架构",
definicao: "处理器的基础指令集。经典 ESP32、S2 和 S3 使用 Tensilica 的专有 Xtensa 内核（LX6/LX7）；较新的 C 系列（C2、C3、C5、C6、C61）、H 系列（H2、H4）和 P 系列（P4）则采用开放、模块化且高能效的 32 位 RISC-V 架构。",
exemplo: "ESP32-S3 使用双核 Xtensa LX7，ESP32-C6 使用单核 RISC-V，ESP32-P4 使用 400 MHz 的双核 RISC-V。",
},
{
termo: "CPU 内核（双核与单核）",
definicao: "彼此独立的中央处理单元。双核芯片可以让一个内核（Core 0）专门负责 Wi-Fi/蓝牙射频和 FreeRTOS 调度，把第二个内核（Core 1）完全留给用户应用和计算。",
exemplo: "ESP32、ESP32-S3 和 ESP32-P4 是双核；ESP32-S2、C2、C3、C6 和 H2 是单核。",
},
{
termo: "时钟频率（MHz）",
definicao: "以兆赫兹（MHz）衡量的处理速度。ESP-IDF 会动态调整频率（动态频率调节，DFS），在空闲时节省电能。",
exemplo: "ESP32-C2 最高运行在 120 MHz；ESP32、S2、S3 和 C6 可达 160/240 MHz；ESP32-P4 可达 400 MHz。",
},
{
termo: "ULP（超低功耗协处理器）",
definicao: "独立的超低功耗辅助处理器。在主内核处于深度睡眠（Deep Sleep）时，它仍可继续执行指令，读取模拟传感器（ADC）、I2C 和 GPIO 引脚。",
exemplo: "初代 ESP32 带有 ULP FSM；ESP32-S2、S3 和 C6 带有可用 C 语言编程的 ULP RISC-V；ESP32-P4 带有专用的低功耗 ULP。",
},
{
termo: "AI 向量扩展（Vector Extension / ESP-NN）",
definicao: "芯片中的专用指令，可并行执行整数（int8/int16）向量与矩阵运算，加速卷积神经网络（CNN）和信号处理。",
exemplo: "ESP32-S3 和 ESP32-P4 可加速人脸识别、语音检测以及 TensorFlow Lite for Microcontrollers 模型的推理。",
},
{
termo: "FPU（浮点运算单元）",
definicao: "硬件浮点运算单元，可在一个时钟周期内完成小数（`float`）的加、乘、除运算，没有软件开销。",
exemplo: "ESP32 和 ESP32-S3 的 Xtensa 内核带有 FPU，ESP32-P4 的高性能 RISC-V 内核同样带有。",
},
{
termo: "PPA（像素处理加速器）",
definicao: "ESP32-P4 独有的 2D 图形硬件加速器，用于加速图像处理：帧旋转、缩放、Alpha 通道混合和颜色转换（RGB565、ARGB8888、YUV420）。",
exemplo: "以 60 FPS 渲染复杂图形界面（LVGL），且不占用主 CPU 内核的时间。",
},
],
},
{
id: "seguranca",
nome: "安全、加密与 eFuse",
icone: "ShieldCheck",
emoji: "🔒",
cor: "red",
descricao: "防篡改 eFuse、安全启动 V2（Secure Boot V2）、XTS-AES 闪存加密、密钥管理器（Key Manager）、ECC 以及 DPA 防护。",
termos: [
{
termo: "eFuse（电子熔丝）",
definicao: "由微型硅熔丝构成、只能一次性且不可逆写入的存储（OTP，一次性可编程）。用于保存加密密钥、出厂 MAC 地址，并在商用产品中锁定调试接口。",
exemplo: "配合 `espefuse.py` 工具烧写安全启动密钥，并在产品出货前禁用 JTAG 端口。",
},
{
termo: "安全启动（Secure Boot，V1 与 V2）",
definicao: "一种安全启动协议：ROM 代码先对引导加载程序和固件的 RSA-3072 或 ECDSA 签名做密码学校验，通过后才允许执行，从而阻止被篡改的代码注入。",
exemplo: "经典 ESP32 使用安全启动 V1；从 ESP32-S2 起全部采用支持多组签名密钥的安全启动 V2。",
},
{
termo: "闪存加密（Flash Encryption）",
definicao: "硬件机制，使用 XTS-AES 算法对外部 SPI 闪存的内容进行实时加密和解密。即使开发板被盗或闪存被拆焊，也无法直接读取固件。",
exemplo: "大多数芯片使用 XTS-AES-128；ESP32-S3、C5、P4 和 H4 还支持 XTS-AES-256。",
},
{
termo: "密钥管理器（Key Manager）",
definicao: "高级安全模块，在芯片内部生成、存储并使用密钥，密钥不会暴露给 SRAM 或固件，因此即使软件存在漏洞也无法提取密钥。",
exemplo: "见于 ESP32-S31、ESP32-C5 和 ESP32-P4 等高安全性系列。",
},
{
termo: "硬件 ECC 与 ECDSA",
definicao: "在芯片中实现的椭圆曲线加速器（如 P-256 和 P-384）和 ECDSA 数字签名算法，对于快速安全地连接云端以及满足 Matter 标准的认证要求至关重要。",
exemplo: "ESP32-S31、C5、C61、P4、H2 和 H4 带有 ECDSA 硬件加速器。",
},
{
termo: "HMAC 与数字签名（DS）",
definicao: "密码学认证外设，使用烧写在 eFuse 中、对固件不可见的密钥来计算 HMAC 并对消息签名。",
exemplo: "无需以明文保存证书，即可与 AWS IoT Core 和 Microsoft Azure IoT 进行安全、快速的认证。",
},
{
termo: "TRNG（真随机数发生器）",
definicao: "基于射频与硅电路的模拟热噪声的真随机数发生器，对于在 TLS/HTTPS 握手中生成会话密钥至关重要。",
exemplo: "ESP32 全系列均提供，为 HTTPS/MbedTLS 连接提供可靠的熵源。",
},
{
termo: "DPA 防护（差分功耗分析）",
definicao: "硬件层面的物理机制，通过在芯片电流消耗中加入噪声并做平衡，防止攻击者用示波器测量功耗来推断密钥。",
exemplo: "见于 ESP32-C5、C6、C61 和 H2 系列。",
},
],
},
{
id: "memoria",
nome: "内存、总线与存储",
icone: "Database",
emoji: "💾",
cor: "purple",
descricao: "内部 SRAM、启动 ROM、SPI 闪存、QSPI/Octal PSRAM、RTC 内存与 DMA 分配。",
termos: [
{
termo: "内部 SRAM",
definicao: "直接集成在 CPU 芯片内的超高速易失性存储器，用于程序变量、FreeRTOS 数据结构、驱动缓冲区和运行栈。断电后数据丢失。",
exemplo: "经典 ESP32 有 520 KB SRAM；ESP32-S3 为 512 KB；ESP32-C3 为 400 KB；ESP32-C6 为 512 KB；ESP32-P4 为 768 KB。",
},
{
termo: "启动 ROM",
definicao: "乐鑫在出厂时永久写入的只读存储器，包含一级引导加载程序（First-Stage Bootloader）、数学表和基础初始化例程，永远无法修改。",
exemplo: "上电后 ROM 最先运行，检查 Strapping 引脚，然后从闪存加载用户的引导加载程序。",
},
{
termo: "SPI 闪存（Quad-SPI 与 Octal-SPI）",
definicao: "存放应用固件的外部非易失性存储器。通过 4 线（Quad SPI / QSPI）或 8 位数据线（Octal SPI / OPI / OSPI）连接，后者的带宽和传输速率是前者的两倍。",
exemplo: "ESP32-S3 和 ESP32-P4 支持最高 120 MHz 的 Octal SPI 闪存与 PSRAM，可获得最快的纹理和代码加载速度。",
},
{
termo: "PSRAM（外部伪静态 RAM）",
definicao: "通过 SPI/QSPI/OPI 连接的高密度外部 RAM，可把微控制器的内存扩展到数十 MB，适用于需要超大缓冲区的应用。",
exemplo: "ESP32-WROVER 和 ESP32-S3-WROOM-1 配备 8 MB 外部 PSRAM，用于摄像头的 JPEG 解码和 TFT 显示屏的图形缓冲。",
},
{
termo: "RTC 快速与慢速 SRAM",
definicao: "专属于实时时钟（RTC）供电域的 SRAM 块。在深度睡眠（Deep Sleep）期间保持供电，用于存放 ULP 代码和标记为 `RTC_DATA_ATTR` 的变量。",
exemplo: "在 ESP32 以 10 µA 的功耗进入深度睡眠期间，保持读数计数器或校准数据不丢失。",
},
{
termo: "DMA 内存分配（MALLOC_CAP_DMA）",
definicao: "兼容直接内存访问（DMA）的内存，使外设（SPI、I2S、LCD、SDMMC）可以直接向 RAM 传输数据，而不占用 CPU 时间。",
exemplo: "在大多数 ESP32 芯片上，DMA 必须通过 `MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL` 标志在内部 SRAM 中分配。",
},
{
termo: "堆碎片化（Heap Fragmentation）",
definicao: "经过多次分配与释放后，动态内存被拆成零散的小块（使用 Arduino 的 `String` 对象时很常见），导致无法为 TLS/Wi-Fi 分配大块连续内存。",
exemplo: "在 ESP-IDF 中通过 `heap_caps_get_largest_free_block()` 监测，以避免 HTTPS 连接失败。",
},
],
},
{
id: "conectividade",
nome: "无线连接与协议",
icone: "Wifi",
emoji: "📡",
cor: "emerald",
descricao: "Wi-Fi 4/6、5 GHz 双频、OFDMA、TWT、经典蓝牙、BLE 5.x、LE Audio、Zigbee 3.0、Thread 与 Matter。",
termos: [
{
termo: "Wi-Fi 6（802.11ax）",
definicao: "新一代无线网络标准，支持 OFDMA（并行通信，延迟更低）、1024-QAM 调制，以及 TWT（目标唤醒时间）功能，可大幅延长 IoT 传感器的电池寿命。",
exemplo: "见于 ESP32-C6、ESP32-C61 和 ESP32-C5。",
},
{
termo: "Wi-Fi 双频（2.4 GHz 与 5 GHz）",
definicao: "既能工作在传统的 2.4 GHz 频段，也能工作在电磁拥塞更少的 5 GHz 频段，支持 20 MHz / 40 MHz 信道，连接更稳定。",
exemplo: "ESP32-C5 是乐鑫首款集成 Wi-Fi 6 双频射频的芯片。",
},
{
termo: "OFDMA（正交频分多址）",
definicao: "Wi-Fi 6 的技术，把单个射频信道划分为几十个更小的子载波（资源单元，Resource Unit），让路由器同时服务多个 ESP32 设备而不产生冲突。",
exemplo: "在有数十个节点相连的密集家庭或工业环境中，降低响应延迟。",
},
{
termo: "TWT（目标唤醒时间）",
definicao: "Wi-Fi 6 的协议：ESP32 与路由器约定好交换数据包的确切时间，使微控制器可以长时间完全关闭射频，同时不断开网络连接。",
exemplo: "由电池供电的 ESP32-C6 传感器可连接 Wi-Fi 6 运行数年，且不丢失同步。",
},
{
termo: "经典蓝牙（Bluetooth Classic，BR/EDR）",
definicao: "传统蓝牙协议，用于连续传输立体声音频（A2DP）、虚拟串口（SPP），以及需要持续高传输速率的设备。",
exemplo: "在经典 ESP32 上实现蓝牙音箱、音频接收器和 HID 键盘。",
},
{
termo: "低功耗蓝牙（BLE 5.0 至 5.4）",
definicao: "蓝牙的低功耗版本，支持 2 Mbps 速率（2M PHY）、可达数百米的远距离（Coded PHY / Long Range）、广播扩展以及蓝牙 Mesh 网络。",
exemplo: "ESP32-S3 支持 BLE 5.0；ESP32-C6 和 ESP32-H2 支持蓝牙 5.4 LE。",
},
{
termo: "蓝牙 LE Audio 与 Auracast",
definicao: "新一代高保真、超低功耗的蓝牙音频，采用 LC3 编解码器，并支持向多个听众同时广播音频（Broadcast Audio / Auracast）。",
exemplo: "ESP32-H4 系列支持，面向新的音频生态和智能耳机。",
},
{
termo: "IEEE 802.15.4（Zigbee 3.0 与 Thread）",
definicao: "2.4 GHz 的低功耗、低数据速率射频标准，是 Zigbee 3.0 和 Thread 1.3 这类工业与家用 Mesh 网络的物理层基础。",
exemplo: "ESP32-C6、ESP32-H2 和 ESP32-H4 在芯片内集成了 IEEE 802.15.4 收发器。",
},
{
termo: "Matter 协议",
definicao: "由 CSA 维护的通用开放式智能家居连接标准，可运行在 Wi-Fi、以太网和 Thread 网络上，原生兼容 Apple Home、Google Home、Alexa 和 Home Assistant。",
exemplo: "使用 ESP-Matter 在 ESP32-C6 或 ESP32-H2 上开发智能灯泡和插座，无需依赖专有云。",
},
],
},
{
id: "perifericos",
nome: "输入输出与外设",
icone: "Sliders",
emoji: "🔌",
cor: "amber",
descricao: "GPIO 引脚、Strapping 引脚、ADC/DAC 转换器、PWM/LEDC、MCPWM、RMT、PCNT、TWAI®/CAN、I2C、SPI 与 I2S。",
termos: [
{
termo: "GPIO（通用输入输出）",
definicao: "多功能引脚，可配置为数字输入或输出，带有可选的内部上拉/下拉电阻，任意引脚都支持外部中断。",
exemplo: "用 `gpio_set_level()` 或 `digitalWrite()` 读取按键、控制继电器和 LED。",
},
{
termo: "Strapping 引脚",
definicao: "特定的 GPIO 引脚，芯片在复位释放的那一毫秒由硬件采样，以决定启动模式（UART 下载与 SPI 闪存启动）和电压电平。",
exemplo: "经典 ESP32/S3 的 GPIO 0 或 ESP32-C3 的 GPIO 9：复位期间若被拉低，芯片会进入固件烧录模式。",
},
{
termo: "ADC（模数转换器）",
definicao: "把连续的模拟电压（0 至 3.3V）转换为 12 位数字值的转换器（ESP32-S2 输出 13 位，其中 12 位有效），可通过衰减器配置（0dB、2.5dB、6dB、11dB/12dB）。",
exemplo: "读取 LDR 光敏电阻、电位器、热敏电阻，以及测量锂电池电量。",
},
{
termo: "DAC（数模转换器）",
definicao: "根据软件生成的数字值产生连续比例模拟电压的转换器，无需外部电路。",
exemplo: "经典 ESP32 和 ESP32-S2 提供，可合成模拟音频或直接输出控制信号。",
},
{
termo: "LEDC（LED PWM 控制器）",
definicao: "专用于产生多路脉宽调制（PWM）信号的外设，可控制频率，分辨率最高 14-20 位，并支持硬件渐变（fade），不占用 CPU。",
exemplo: "平滑调节 RGBW LED 灯带的亮度，以及舵机定位。",
},
{
termo: "MCPWM（电机控制 PWM）",
definicao: "为驱动电机设计的高级 PWM 控制器，适用于三相变频器、可配置死区时间（dead-time）的 H 桥，并可采集正交编码器信号。",
exemplo: "在经典 ESP32、S3 和 P4 上精确控制无刷电机（BLDC）和移动机器人。",
},
{
termo: "RMT（远程控制外设）",
definicao: "可精确到微秒级时序的脉冲收发与生成器，最初为红外遥控（NEC、RC5、Sony）设计，被广泛用于驱动 WS2812B / NeoPixel 数字 LED 灯带。",
exemplo: "刷新数百颗 NeoPixel LED，而无需关闭系统中断。",
},
{
termo: "PCNT（脉冲计数器）",
definicao: "硬件脉冲计数器，可对外部高频信号的上升/下降沿计数，而无需软件为 CPU 产生中断。",
exemplo: "读取工业旋转编码器、转速计和水流量计。",
},
{
termo: "TWAI®（双线汽车接口 / CAN 总线）",
definicao: "芯片内集成的、符合 ISO 11898-1 标准的 CAN 2.0B 车载与工业总线控制器，只需外接一个物理收发器（如 SN65HVD230）。",
exemplo: "OBD-II 汽车诊断、电动车遥测以及稳健的工业自动化。",
},
{
termo: "电容触摸（Touch）",
definicao: "专用引脚，用于测量手指靠近时静电电容的变化，可隔着玻璃或亚克力制作触摸按键和滑条。",
exemplo: "ESP32-S2 和 S3 最多提供 14 个通道，可做现代触摸控制面板。",
},
{
termo: "PARLIO（并行 IO 控制器）",
definicao: "较新系列（C6、H2、P4）提供的可配置高速并行总线，使用自定义时钟向 LCD 显示屏、摄像头和外部传感器同步传输数据。",
exemplo: "与外围芯片进行高效并行通信，无需让 CPU 用位操作（bit-banging）模拟。",
},
],
},
{
id: "multimidia",
nome: "多媒体、USB 与高级接口",
icone: "Sparkles",
emoji: "✨",
cor: "pink",
descricao: "原生 USB OTG、USB Serial/JTAG、USB 高速 480Mbps、MIPI CSI/DSI、H.264 编码器与以太网 MAC。",
termos: [
{
termo: "原生 USB OTG（On-The-Go）",
definicao: "芯片内置的全速（12 Mbps）USB 控制器，使 ESP32 既可作为外设（HID 键盘、鼠标、Mass Storage 优盘），也可作为 USB 主机（读取优盘或外设）。",
exemplo: "ESP32-S2 和 ESP32-S3 原生提供，可用于制作自定义键盘和模拟器。",
},
{
termo: "原生 USB Serial/JTAG",
definicao: "芯片内集成的 USB 接口，同时提供用于控制台的串口和完整的 JTAG 调试探针，无需外接转换芯片（CH340/CP2102）。",
exemplo: "在 ESP32-C3、S3、C6 和 H2 上，只需把 USB 线接到 D+/D- 引脚，就能烧录固件并在 VS Code 中用断点调试。",
},
{
termo: "USB 2.0 高速（480 Mbps）",
definicao: "高速 USB 2.0 控制器，集成 PHY，传输速率最高 480 Mbps，带宽是全速 USB 的 40 倍。",
exemplo: "ESP32-P4 独有，用于高清视频流和大批量数据传输。",
},
{
termo: "MIPI CSI 与 MIPI DSI",
definicao: "智能手机行业的标准高速差分串行接口：MIPI-CSI（摄像头串行接口）用于高分辨率摄像头传感器，MIPI-DSI（显示串行接口）用于触摸屏。",
exemplo: "在 ESP32-P4 SoC 上连接 1080p 屏幕和高帧率摄像头。",
},
{
termo: "硬件 H.264 视频编码器",
definicao: "专用加速模块，可实时把摄像头的原始视频流压缩为标准 H.264（AVC）格式，分辨率最高 1080p、30 FPS，不增加 CPU 负担。",
exemplo: "在 ESP32-P4 上用高效压缩实现智能安防摄像头和电子门铃。",
},
{
termo: "以太网 MAC 10/100 Mbps",
definicao: "芯片内集成的有线网络数据链路层（Media Access Control）控制器，只需通过 RMII 接口外接一颗物理层收发芯片（PHY，如 LAN8720 或 IP101）。",
exemplo: "在经典 ESP32 和 ESP32-P4 上，提供不受射频噪声影响、稳定的 RJ45 以太网连接，用于楼宇自动化。",
},
{
termo: "DVP 摄像头接口（8 位 / 16 位）",
definicao: "并行总线，包含 VSYNC、HREF、PCLK 信号和数据总线，支持 DMA，可直接从常见摄像头模组（OV2640、OV5640）采集帧。",
exemplo: "用于 ESP32-CAM 和 ESP32-S3-CAM 开发板，拍照并传输 MJPEG 视频流。",
},
],
},
{
id: "energia",
nome: "电源管理与睡眠模式",
icone: "BatteryCharging",
emoji: "🔋",
cor: "teal",
descricao: "Active 模式、Modem Sleep、Light Sleep、Deep Sleep、Hibernation、欠压检测器（Brownout Detector）与唤醒源。",
termos: [
{
termo: "Active 模式",
definicao: "正常运行模式：CPU 以最高频率执行指令，所有外设和射频随时可用，电流消耗在 30 mA 到约 240 mA 之间（Wi-Fi 发射期间）。",
exemplo: "ESP32 处理音频、刷新显示屏或实时传输传感器数据。",
},
{
termo: "Modem Sleep",
definicao: "在两次发射的间隔里暂时关闭 Wi-Fi 和蓝牙射频电路，而 CPU 继续正常运行代码，把电流降到约 20 至 40 mA。",
exemplo: "连接 Wi-Fi 的应用在等待网络事件时的默认模式，不会丢失与路由器的关联。",
},
{
termo: "Light Sleep",
definicao: "中间级别的节能模式：CPU 时钟暂停、射频关闭，但内部 SRAM、外设和任务状态完整保留。芯片可在 1 ms 内唤醒。",
exemplo: "需要被按键中断或定时器快速唤醒的设备，电流约 0.8 mA。",
},
{
termo: "Deep Sleep",
definicao: "深度睡眠模式：所有数字电源域和 CPU 都被关闭，仅保留 RTC 域供电（可选保留 RTC 内存和 ULP）。电流降到 5 至 15 µA，芯片唤醒后从头开始执行。",
exemplo: "由电池和太阳能板供电的远程气象站，每小时测量一次。",
},
{
termo: "Hibernation 模式",
definicao: "芯片中功耗最低的状态：连 RTC 的晶振和慢速域都被关闭，只保留一个模拟恢复电路，可由外部按键或复位唤醒。",
exemplo: "使用 CR2032 纽扣电池、可运行数年的设备，残余电流约 5 µA。",
},
{
termo: "唤醒源（Wakeup Sources）",
definicao: "用于把 ESP32 从深度睡眠或浅睡眠中唤醒的硬件事件：RTC 定时器、外部 GPIO 引脚（EXT0 / EXT1）、电容触摸，或 ULP 协处理器的信号。",
exemplo: "`esp_sleep_enable_timer_wakeup(60 * 1000000)` 可让芯片每 60 秒准时唤醒。",
},
{
termo: "欠压检测器（Brownout Detector）",
definicao: "内部的模拟比较器硬件电路，监测 3V3 引脚的供电电压，当电压降到约 2.8V 以下时强制安全复位，防止闪存数据损坏。",
exemplo: "避免电源不足的供电在射频发射峰值期间引起部分复位，保护微控制器。",
},
],
},
{
id: "desenvolvimento",
nome: "固件、启动与操作系统",
icone: "Code2",
emoji: "🚀",
cor: "rose",
descricao: "引导加载程序、FreeRTOS、IRAM_ATTR 宏、闪存分区、带回滚的 OTA 升级与 NVS 存储。",
termos: [
{
termo: "引导加载程序（Bootloader，一级与二级）",
definicao: "电气复位后立即执行的代码。一级位于芯片 ROM 中；二级位于闪存中，负责校验分区表、检查安全签名，并加载用户固件。",
exemplo: "控制 OTA 分区之间的切换，并在 `app_main` 之前初始化 PSRAM 内存。",
},
{
termo: "FreeRTOS（实时操作系统）",
definicao: "ESP-IDF 默认的抢占式多任务内核，在多个任务（Task）、消息队列（Queue）、信号量、互斥量和软件定时器之间划分 CPU，并支持优先级控制。",
exemplo: "用 `xTaskCreatePinnedToCore()` 把繁重的任务分配到指定的 CPU 内核上。",
},
{
termo: "IRAM_ATTR 与 DRAM_ATTR",
definicao: "ESP32 的 GCC 编译器专用属性，强制函数和变量驻留在内部超高速 IRAM/DRAM 中，而不是外部闪存，对中断服务例程（ISR）是必需的。",
exemplo: "避免在闪存忙于写入数据时，中断引发崩溃（*Cache Error*）。",
},
{
termo: "分区表（partitions.csv）",
definicao: "配置文件，把闪存的存储空间映射为多个逻辑块，分别用于引导加载程序、NVS 数据、LittleFS 文件和多个固件镜像（Factory、OTA_0、OTA_1）。",
exemplo: "可自定义，以容纳带有蓝牙、Wi-Fi 和加密库的大型固件。",
},
{
termo: "带回滚的 OTA（空中升级）",
definicao: "无线固件升级：新版本被写入另一个分区。若新固件启动失败，系统会自动回滚（*Rollback*）到之前可用的版本。",
exemplo: "`esp_ota_mark_app_valid_cancel_rollback()` 用于确认现场的新升级运行正常。",
},
{
termo: "NVS（非易失性存储）与 NVS 加密",
definicao: "闪存中的结构化键值机制，用于持久保存网络凭据、校准参数和计数器，并支持通过 eFuse 中的 AES 密钥进行硬件加密。",
exemplo: "保存 Wi-Fi 名称和加密后的密码，以便断电后自动重连。",
},
{
termo: "LittleFS 与 SPIFFS",
definicao: "为闪存设计的文件系统，带磨损均衡（*wear leveling*），使应用可以读写 HTML 页面、SSL 证书和日志等文件。",
exemplo: "保存 ESP32 内置网页服务器的 HTML/CSS 页面，用于通过浏览器配置网络。",
},
{
termo: "JTAG 与 OpenOCD",
definicao: "硬件级调试标准，可通过 USB-JTAG 探针在 VS Code 或 Eclipse 中暂停 CPU、设置断点，并实时查看寄存器和变量。",
exemplo: "调试复杂崩溃和空指针问题，而不必只依赖 `Serial.println()`。",
},
],
},
];
messages/zh-CN.json
+152
View File
@@ -0,0 +1,152 @@
{
"Common": {
"siteName": "ESPDocs",
"author": "Lucas Rayan Guerra",
"organization": "Ciência Embarcada",
"skipToContent": "跳到正文",
"allRightsReserved": "内容采用 MIT 许可证。为嵌入式系统社区而做。",
"backToHome": "返回首页",
"explore": "探索",
"tools": "工具",
"project": "项目",
"loading": "加载中...",
"search": "搜索...",
"officialDocumentation": "官方文档",
"community": "社区",
"mitLicense": "MIT 许可证"
},
"Header": {
"brand": "ESPDocs",
"homeAria": "ESPDocs，首页",
"navAria": "主导航",
"mobileNavAria": "移动端导航",
"openMenu": "打开导航菜单",
"closeMenu": "关闭菜单",
"navigationTitle": "导航",
"whereToGo": "前往",
"selectChip": "选择芯片",
"selectMyChip": "选择我的芯片",
"hardware": "硬件",
"hardwareDesc": "12 款芯片的引脚与规格",
"series": "ESP32 系列",
"seriesDesc": "12 款芯片的引脚与规格",
"comparator": "对比工具",
"comparatorDesc": "最多四个系列并排对比",
"catalog": "开发板目录",
"catalogDesc": "DevKit、引脚与购买渠道",
"tools": "工具",
"selector": "智能选型",
"selectorDesc": "为你的项目找到合适的芯片",
"diagnostics": "故障诊断",
"diagnosticsDesc": "欠压、启动循环、看门狗等问题",
"components": "Component Registry",
"componentsDesc": "驱动与 idf_component.yml 清单",
"library": "资料库",
"frameworks": "框架与 SDK",
"frameworksDesc": "ESP-IDF、Arduino、Rust 与 Matter",
"glossary": "技术术语表",
"glossaryDesc": "数据手册中出现的术语",
"about": "关于本项目",
"aboutDesc": "作者、方法与开放性"
},
"Footer": {
"ariaLabel": "ESPDocs 页脚",
"description": "ESP32 生态的独立文档。公开数据、编辑整理，并链接到官方资料来源。",
"exploreTitle": "探索",
"toolsTitle": "工具",
"projectTitle": "项目",
"authorTitle": "作者",
"reportIssue": "反馈问题",
"repository": "代码仓库",
"personalSite": "个人网站",
"linkedin": "LinkedIn"
},
"Home": {
"badge": "ESP32 开放文档",
"titleLine1": "ESP32，",
"titleLine2": "去繁就简。",
"lede": "规格、引脚、对比与故障诊断，一次读完。少啃数据手册，多花时间在工作台上做原型。",
"chooseMyChip": "选择我的芯片",
"exploreSeries": "浏览全部 {count} 个系列",
"seriesCount": "{count} 个系列",
"frameworkCount": "{count} 个框架",
"portugueseFlag": "100% 中文",
"featuredSeries": "精选系列",
"featuredDesc": "打开数据手册之前，先看每个系列的要点。",
"fullIndex": "完整索引",
"toolsTitle": "从问题出发。",
"toolsEyebrow": "工具",
"toolsDesc": "帮助你选对芯片、诊断硬件故障并加快开发的工具。"
},
"NotFound": {
"eyebrow": "404 错误",
"title": "该页面不存在。",
"lede": "地址可能已更改或输入有误。请从以下入口继续浏览。",
"backToHome": "返回首页",
"seriesTitle": "ESP32 系列",
"seriesDesc": "12 个系列，含引脚与规格。",
"selectorTitle": "芯片选型",
"selectorDesc": "回答八个问题，获得推荐型号。",
"comparatorTitle": "对比工具",
"comparatorDesc": "最多四个系列并排对比。",
"glossaryTitle": "术语表",
"glossaryDesc": "清晰解释硬件术语。"
},
"Sobre": {
"label": "独立项目",
"title": "关于 ESPDocs",
"lede": "一个非官方平台，整理 ESP32 的技术信息，并直接链接到乐鑫（Espressif）官方文档。为开源硬件社区而做。",
"viewRepository": "查看代码仓库",
"features": {
"portugueseTitle": "精心整理的内容",
"portugueseDesc": "结构化的技术数据，清晰呈现，没有数据手册的冗余。",
"visualCompareTitle": "可视化对比",
"visualCompareDesc": "用表格和图示选出合适的系列，无需翻阅十份数据手册。",
"centralizedAccessTitle": "集中入口",
"centralizedAccessDesc": "直达官方文档、代码仓库与示例的链接。",
"openSourceTitle": "开源",
"openSourceDesc": "欢迎在 Gitea 上贡献。"
}
},
"Series": {
"title": "ESP32 系列",
"description": "12 个 ESP32 系列并排对比：ESP32、S2、S3、S31、C2、C3、C5、C6、C61、P4、H2 和 H4。每个系列的架构、内存、无线、外设与引脚。",
"pinout": "引脚",
"specifications": "规格",
"peripherals": "外设",
"architecture": "架构",
"memory": "内存",
"radio": "无线",
"security": "硬件安全"
},
"Catalogo": {
"title": "开发板目录",
"description": "官方与第三方 DevKit，含引脚、接口与购买链接。",
"filterBySeries": "按系列筛选",
"searchBoards": "搜索开发板..."
},
"Comparacao": {
"title": "ESP32 系列对比",
"description": "最多并排对比 4 个系列，涵盖处理器、无线、内存与引脚的完整规格。"
},
"Componentes": {
"title": "ESP Component Registry",
"description": "可直接用于 ESP-IDF 的驱动、库与 idf_component.yml 清单。"
},
"Diagnostico": {
"title": "故障诊断与排查",
"description": "欠压、启动循环、CPU 异常、FreeRTOS 与硬件最佳实践。"
},
"Frameworks": {
"title": "框架与 SDK",
"description": "主要开发环境的指南与概览：ESP-IDF、Arduino、MicroPython、Rust 与 ESP-Matter。"
},
"Glossario": {
"title": "技术术语表",
"description": "对数据手册中出现的硬件、外设、无线与架构概念的实用解释。"
},
"Seletor": {
"title": "ESP32 智能选型",
"description": "回答几个关于项目的具体问题，依据技术指标找到最合适的系列。"
}
}
public/exemplos/zh-CN/arduino.ino
+29
View File
@@ -0,0 +1,29 @@
#include <WiFi.h>
// 替换为你自己的 Wi-Fi 网络信息
const char* ssid = "NOME_DA_SUA_REDE";
const char* password = "SENHA_DA_SUA_REDE";
void setup() {
Serial.begin(115200);
delay(1000);
Serial.println("Conectando ao Wi-Fi...");
WiFi.begin(ssid, password);
// 等待连接
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println("");
Serial.println("Wi-Fi conectado com sucesso!");
Serial.print("Endereço IP: ");
Serial.println(WiFi.localIP());
}
void loop() {
// 在这里放置程序的主要代码
delay(1000);
}
public/exemplos/zh-CN/esp-adf.c
+72
View File
@@ -0,0 +1,72 @@
#include "esp_log.h"
#include "audio_pipeline.h"
#include "audio_element.h"
#include "audio_event_iface.h"
#include "audio_common.h"
#include "i2s_stream.h"
#include "mp3_decoder.h"
#include "fatfs_stream.h"
#include "esp_peripherals.h"
#include "periph_sdcard.h"
static const char *TAG = "HELLO_ADF";
void app_main(void)
{
// 初始化外设（如 SD 卡）
esp_periph_config_t periph_cfg = DEFAULT_ESP_PERIPH_SET_CONFIG();
esp_periph_set_handle_t set = esp_periph_set_init(&periph_cfg);
periph_sdcard_cfg_t sd_cfg = {
.root = "/sdcard",
};
esp_periph_handle_t sdcard_handle = periph_sdcard_init(&sd_cfg);
esp_periph_start(set, sdcard_handle);
// 等待 SD 卡挂载
periph_sdcard_wait_for_ready(sdcard_handle, portMAX_DELAY);
ESP_LOGI(TAG, "SD card montado!");
// 创建流水线
audio_pipeline_handle_t pipeline;
audio_pipeline_cfg_t pipeline_cfg = DEFAULT_AUDIO_PIPELINE_CONFIG();
pipeline = audio_pipeline_init(&pipeline_cfg);
// 元素：文件（fatfs）、解码器（mp3）和输出（i2s）
audio_element_handle_t fatfs_stream_reader, i2s_stream_writer, mp3_decoder;
fatfs_stream_cfg_t fatfs_cfg = FATFS_STREAM_CFG_DEFAULT();
fatfs_cfg.type = AUDIO_STREAM_READER;
fatfs_stream_reader = fatfs_stream_init(&fatfs_cfg);
mp3_decoder_cfg_t mp3_cfg = DEFAULT_MP3_DECODER_CONFIG();
mp3_decoder = mp3_decoder_init(&mp3_cfg);
i2s_stream_cfg_t i2s_cfg = I2S_STREAM_CFG_DEFAULT();
i2s_cfg.type = AUDIO_STREAM_WRITER;
i2s_stream_writer = i2s_stream_init(&i2s_cfg);
// 注册并连接元素
audio_pipeline_register(pipeline, fatfs_stream_reader, "file");
audio_pipeline_register(pipeline, mp3_decoder, "mp3");
audio_pipeline_register(pipeline, i2s_stream_writer, "i2s");
audio_pipeline_link(pipeline, (const char *[]) {"file", "mp3", "i2s"}, 3);
// 指定要播放的 MP3 文件
audio_element_set_uri(fatfs_stream_reader, "/sdcard/test.mp3");
// 启动流水线
ESP_LOGI(TAG, "Iniciando pipeline...");
audio_pipeline_run(pipeline);
// 保持流水线运行
while (1) {
vTaskDelay(1000 / portTICK_PERIOD_MS);
}
// （不会执行到这里，但这里本应是清理逻辑）
audio_pipeline_stop(pipeline);
audio_pipeline_wait_for_stop(pipeline);
audio_pipeline_terminate(pipeline);
}
public/exemplos/zh-CN/esp-dsp.c
+37
View File
@@ -0,0 +1,37 @@
#include <stdio.h>
#include "esp_dsp.h"
#define N 8 // 向量长度
void app_main(void)
{
// 输入向量（信号示例）
float x[N] = {1.0, -2.0, 3.0, -4.0, 2.5, -1.5, 0.0, 4.5};
float y[N]; // 输出向量
// 初始化 ESP-DSP
esp_err_t ret = dsps_fft2r_init_fc32(NULL, CONFIG_DSP_MAX_FFT_SIZE);
if (ret != ESP_OK) {
printf("Erro ao inicializar o ESP-DSP!\n");
return;
}
printf("Sinal de entrada:\n");
for (int i = 0; i < N; i++) {
printf("%f ", x[i]);
}
printf("\n");
// 计算每个值的平方
dsps_mulc_f32(x, y, N, 1.0f);
dsps_mul_f32(y, y, y, N, 1, 1, 1);
// 对所有平方值求和
float soma = 0;
dsps_sum_f32(y, N, &soma, 1);
// 计算幅值（平方和的平方根）
float magnitude = sqrtf(soma);
printf("Magnitude do vetor: %f\n", magnitude);
}
public/exemplos/zh-CN/esp-idf.c
+56
View File
@@ -0,0 +1,56 @@
/*
* 面向 ESP32 的 ESP-IDF v5.x+ 示例
* 演示系统初始化、FreeRTOS 任务管理和统一日志
*
* 组件管理（main/idf_component.yml）：
* dependencies:
* espressif/led_strip: "^2.5.0"
*/
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"
#include "esp_log.h"
#include "esp_system.h"
#include "esp_chip_info.h"
static const char *TAG = "main_app";
#define BLINK_GPIO GPIO_NUM_2 // 根据开发板 LED 引脚调整
static void blink_task(void *pvParameters)
{
// 使用 ESP-IDF 新 API 配置 GPIO 引脚
gpio_reset_pin(BLINK_GPIO);
gpio_set_direction(BLINK_GPIO, GPIO_MODE_OUTPUT);
bool led_state = false;
while (1) {
led_state = !led_state;
gpio_set_level(BLINK_GPIO, led_state);
ESP_LOGI(TAG, "LED %s | Heap livre: %lu bytes",
led_state ? "LIGADO" : "DESLIGADO",
(unsigned long)esp_get_free_heap_size());
vTaskDelay(pdMS_TO_TICKS(1000));
}
}
void app_main(void)
{
// SoC 芯片信息
esp_chip_info_t chip_info;
esp_chip_info(&chip_info);
ESP_LOGI(TAG, "===========================================");
ESP_LOGI(TAG, " Iniciando ESP-IDF v5.x Modern Application ");
ESP_LOGI(TAG, " Modelo do Chip: %d | Núcleos: %d | Rev: %d",
chip_info.model, chip_info.cores, chip_info.revision);
ESP_LOGI(TAG, "===========================================");
// 创建一个专用的 FreeRTOS 任务
xTaskCreate(blink_task, "blink_task", 3072, NULL, 5, NULL);
}
public/exemplos/zh-CN/esp-iot-solution.c
+72
View File
@@ -0,0 +1,72 @@
/*
* Exemplo ESP-IoT-Solution para ESP32
* Inicialização de Botão Inteligente com Callbacks e Driver de Display/Sensores
*
* Dependência (idf_component.yml):
* espressif/button: "^3.3.0"
* espressif/led_indicator: "^1.2.0"
*/
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "iot_button.h"
#include "led_indicator.h"
static const char *TAG = "iot_solution_app";
#define BUTTON_GPIO_NUM 0 // Botão BOOT nativo
#define LED_INDICATOR_GPIO 2 // LED indicador
static led_indicator_handle_t led_handle = NULL;
/* Callback para clique único do botão */
static void button_single_click_cb(void *arg, void *data)
{
ESP_LOGI(TAG, "Evento: Clique Único detectado!");
led_indicator_start(led_handle, BLINK_DOUBLE_FAST);
}
/* Callback para clique longo (> 3 segundos) */
static void button_long_press_cb(void *arg, void *data)
{
ESP_LOGW(TAG, "Evento: Pressionamento Longo! Acionando modo de reset de fábrica.");
led_indicator_start(led_handle, BLINK_BREATHE_FAST);
}
void app_main(void)
{
ESP_LOGI(TAG, "Iniciando ESP-IoT-Solution Component Suite");
// 1. Configuração do LED Indicator
led_indicator_gpio_config_t led_cfg = {
.is_active_level_high = true,
.gpio_num = LED_INDICATOR_GPIO,
};
led_handle = led_indicator_create(&led_cfg);
// 2. Configuração do Botão com debounce de hardware/software automático
button_config_t btn_cfg = {
.type = BUTTON_TYPE_GPIO,
.long_press_time = 3000,
.short_press_time = 180,
.gpio_button_config = {
.gpio_num = BUTTON_GPIO_NUM,
.active_level = 0,
},
};
button_handle_t btn_handle = iot_button_create(&btn_cfg);
assert(btn_handle != NULL);
// Registra callbacks para diferentes gestos
iot_button_register_cb(btn_handle, BUTTON_SINGLE_CLICK, button_single_click_cb, NULL);
iot_button_register_cb(btn_handle, BUTTON_LONG_PRESS_START, button_long_press_cb, NULL);
ESP_LOGI(TAG, "Drivers inicializados com sucesso! Pressione o botão GPIO 0.");
while (1) {
vTaskDelay(pdMS_TO_TICKS(1000));
}
}
public/exemplos/zh-CN/esp-matter.c
+44
View File
@@ -0,0 +1,44 @@
#include <stdio.h>
#include "esp_log.h"
#include "esp_matter.h"
#include "esp_matter_controller.h"
#include "nvs_flash.h"
static const char *TAG = "esp-matter-example";
void app_event_cb(const esp_matter_event_t *event)
{
switch (event->event_id) {
case ESP_MATTER_EVENT_ATTRIBUTE_UPDATE: {
const esp_matter_attr_update_t *attr_update = &event->data.attr_update;
if (attr_update->endpoint_id == 1 && attr_update->cluster_id == ESP_MATTER_ON_OFF_CLUSTER_ID) {
bool on = false;
esp_matter_attribute_get(attr_update->endpoint_id, attr_update->cluster_id,
attr_update->attribute_id, &on);
ESP_LOGI(TAG, "Lâmpada %s", on ? "ligada" : "desligada");
}
break;
}
default:
break;
}
}
void app_main(void)
{
// Inicializa NVS
esp_err_t err = nvs_flash_init();
if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
ESP_ERROR_CHECK(nvs_flash_erase());
ESP_ERROR_CHECK(nvs_flash_init());
}
// Inicializa o Matter node
esp_matter::node_t *node = esp_matter::node::create(NULL, app_event_cb);
esp_matter::endpoint_t *endpoint = esp_matter::endpoint::create(node, ESP_MATTER_ENDPOINT_TYPE_ON_OFF_LIGHT);
// Inicia o stack Matter
ESP_ERROR_CHECK(esp_matter::start(node));
ESP_LOGI(TAG, "Dispositivo Matter iniciado. Aguardando comissionamento...");
}
public/exemplos/zh-CN/esp-nn.c
+44
View File
@@ -0,0 +1,44 @@
#include <stdio.h>
#include "esp_nn.h"
#include "esp_nn_defs.h"
#define INPUT_SIZE 4
#define OUTPUT_SIZE 3
void print_array(const char *label, int16_t *array, int size) {
printf("%s: ", label);
for (int i = 0; i < size; i++) {
printf("%d ", array[i]);
}
printf("\n");
}
void app_main(void)
{
// Vetor de entrada (ex: saída de uma camada anterior)
int16_t input[INPUT_SIZE] = {1, 2, 3, 4};
// Pesos da camada densa (3x4)
int8_t weights[OUTPUT_SIZE * INPUT_SIZE] = {
1, -1, 2, 0,
0, 1, -1, 1,
2, 0, 1, -2
};
// Bias de cada neurônio
int16_t bias[OUTPUT_SIZE] = {10, -5, 0};
// Saída
int16_t output[OUTPUT_SIZE];
// Multiplicação da matriz: output = weights * input + bias
esp_nn_mul_mat_16x8_16(weights, input, bias, output,
OUTPUT_SIZE, INPUT_SIZE, /*shift=*/0);
print_array("Antes da ReLU", output, OUTPUT_SIZE);
// Aplicar função de ativação ReLU
esp_nn_relu_16(output, OUTPUT_SIZE);
print_array("Depois da ReLU", output, OUTPUT_SIZE);
}
public/exemplos/zh-CN/esp-now.c
+92
View File
@@ -0,0 +1,92 @@
/*
* Exemplo ESP-NOW para ESP32
* Comunicação Sem Fio Ponto-a-Ponto e Broadcast sem roteador Wi-Fi
*
* Protocolo nativo integrado no ESP-IDF
*/
#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_wifi.h"
#include "esp_now.h"
#include "esp_log.h"
#include "nvs_flash.h"
static const char *TAG = "esp_now_demo";
// Estrutura de dados enviada no pacote
typedef struct {
uint32_t sensor_id;
float temperatura;
float umidade;
uint32_t tempo_ms;
} __attribute__((packed)) dados_pacote_t;
// Endereço MAC de Broadcast (envia para todos os nós ESP-NOW por perto)
static const uint8_t broadcast_mac[ESP_NOW_ETH_ALEN] = { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF };
/* Callback executado ao enviar um pacote */
static void on_data_sent(const uint8_t *mac_addr, esp_now_send_status_t status)
{
ESP_LOGI(TAG, "Envio concluído: %s", status == ESP_NOW_SEND_SUCCESS ? "SUCESSO (ACK)" : "FALHA");
}
/* Callback executado ao receber um pacote de outro ESP32 */
static void on_data_recv(const esp_now_recv_info_t *recv_info, const uint8_t *data, int len)
{
if (len == sizeof(dados_pacote_t)) {
dados_pacote_t *pct = (dados_pacote_t *)data;
ESP_LOGI(TAG, "Pacote recebido de [%02X:%02X:%02X:%02X:%02X:%02X]: Sensor #%ld | Temp: %.1f C | Umid: %.1f %%",
recv_info->src_addr[0], recv_info->src_addr[1], recv_info->src_addr[2],
recv_info->src_addr[3], recv_info->src_addr[4], recv_info->src_addr[5],
pct->sensor_id, pct->temperatura, pct->umidade);
}
}
void app_main(void)
{
// Inicializa NVS e Wi-Fi em modo Station
nvs_flash_init();
esp_netif_init();
esp_event_loop_create_default();
wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
esp_wifi_init(&cfg);
esp_wifi_set_mode(WIFI_MODE_STA);
esp_wifi_start();
// Inicializa o protocolo ESP-NOW
ESP_ERROR_CHECK(esp_now_init());
esp_now_register_send_cb(on_data_sent);
esp_now_register_recv_cb(on_data_recv);
// Registra o peer de Broadcast
esp_now_peer_info_t peer_info = {
.channel = 1,
.ifidx = WIFI_IF_STA,
.encrypt = false,
};
memcpy(peer_info.peer_addr, broadcast_mac, ESP_NOW_ETH_ALEN);
ESP_ERROR_CHECK(esp_now_add_peer(&peer_info));
ESP_LOGI(TAG, "ESP-NOW pronto! Enviando telemetria a cada 3 segundos...");
dados_pacote_t telemetria = {
.sensor_id = 101,
.temperatura = 24.8f,
.umidade = 58.2f,
};
while (1) {
telemetria.tempo_ms = esp_log_timestamp();
telemetria.temperatura += ((float)(rand() % 10) - 5.0f) / 10.0f;
esp_err_t res = esp_now_send(broadcast_mac, (uint8_t *)&telemetria, sizeof(telemetria));
if (res != ESP_OK) {
ESP_LOGE(TAG, "Erro ao disparar envio ESP-NOW: %d", res);
}
vTaskDelay(pdMS_TO_TICKS(3000));
}
}
public/exemplos/zh-CN/esp-rainmaker.c
+76
View File
@@ -0,0 +1,76 @@
/*
* Exemplo ESP-RainMaker para ESP32
* Dispositivo: Interruptor Inteligente com controle via App e Nuvem
*
* Dependência (idf_component.yml):
* espressif/esp_rainmaker: "^1.4.0"
*/
#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "nvs_flash.h"
#include <esp_rmaker_core.h>
#include <esp_rmaker_standard_params.h>
#include <esp_rmaker_standard_devices.h>
#include <app_wifi.h>
static const char *TAG = "app_rainmaker";
static esp_rmaker_device_t *switch_device;
/* Callback acionado quando o usuário altera o estado no App móvel */
static esp_err_t write_cb(const esp_rmaker_device_t *dev, const esp_rmaker_param_val_t val, void *priv_data, esp_rmaker_write_ctx_t *ctx)
{
if (ctx) {
ESP_LOGI(TAG, "Comando recebido via %s", esp_rmaker_device_cb_src_to_str(ctx->src));
}
bool state = val.val.b;
ESP_LOGI(TAG, "Estado do interruptor alterado para: %s", state ? "LIGADO" : "DESLIGADO");
// Atualiza o parâmetro na nuvem e no aplicativo
esp_rmaker_param_update_and_report(priv_data, val);
return ESP_OK;
}
void app_main(void)
{
// Inicialização da memória não-volátil (NVS)
esp_err_t err = nvs_flash_init();
if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
ESP_ERROR_CHECK(nvs_flash_erase());
err = nvs_flash_init();
}
ESP_ERROR_CHECK(err);
// Inicializa o provisionamento Wi-Fi
app_wifi_init();
// Configura o nó RainMaker
esp_rmaker_config_t rainmaker_cfg = {
.enable_time_sync = true,
};
esp_rmaker_node_t *node = esp_rmaker_node_init(&rainmaker_cfg, "ESP32_SmartSwitch", "Switch");
// Cria o dispositivo padrão 'Switch'
switch_device = esp_rmaker_switch_device_create("Luz Sala", NULL, true);
// Registra callback de escrita
esp_rmaker_device_add_cb(switch_device, write_cb, NULL);
esp_rmaker_node_add_device(node, switch_device);
// Habilita serviços adicionais (OTA e Timezone)
esp_rmaker_ota_enable_default();
esp_rmaker_timezone_service_enable();
// Inicia o agente RainMaker
esp_rmaker_start();
// Inicia o provisionamento Wi-Fi via BLE (abre no app oficial RainMaker)
app_wifi_start(POP_TYPE_RANDOM);
ESP_LOGI(TAG, "Nó RainMaker pronto! Escaneie o QR Code no app ESP RainMaker.");
}
public/exemplos/zh-CN/esp-sr.c
+98
View File
@@ -0,0 +1,98 @@
/*
* Exemplo ESP-SR para ESP32-S3 / ESP32-P4
* Reconhecimento de Fala Local Offline (WakeNet + MultiNet)
*
* Dependência (idf_component.yml):
* espressif/esp-sr: "^1.5.0"
*/
#include <stdio.h>
#include <stdlib.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_wn_iface.h"
#include "esp_wn_models.h"
#include "esp_mn_iface.h"
#include "esp_mn_models.h"
#include "esp_afe_sr_iface.h"
#include "esp_afe_sr_models.h"
static const char *TAG = "app_voice_sr";
void feed_audio_task(void *arg)
{
esp_afe_sr_data_t *afe_data = (esp_afe_sr_data_t *)arg;
int audio_chunksize = afe_handle->get_feed_chunksize(afe_data);
int16_t *feed_buff = (int16_t *)malloc(audio_chunksize * sizeof(int16_t) * 2);
while (1) {
// Leitura de áudio I2S dos microfones da placa
// i2s_read(I2S_NUM_0, feed_buff, ...);
afe_handle->feed(afe_data, feed_buff);
vTaskDelay(pdMS_TO_TICKS(10));
}
free(feed_buff);
vTaskDelete(NULL);
}
void speech_recognition_task(void *arg)
{
esp_afe_sr_data_t *afe_data = (esp_afe_sr_data_t *)arg;
const esp_afe_sr_iface_t *afe_handle = &ESP_AFE_SR_HANDLE;
// Inicializa o modelo de comandos de fala (MultiNet)
const esp_mn_iface_t *multinet = &ESP_MN_HANDLE;
model_iface_data_t *model_data = multinet->create(&MULTINET_MODEL, 6000);
ESP_LOGI(TAG, "Aguardando palavra-chave de ativação (ex: 'Hi, ESP')...");
while (1) {
afe_fetch_result_t *res = afe_handle->fetch(afe_data);
if (!res || res->ret_value == ESP_FAIL) {
continue;
}
// 1. Verificação de Wake Word (Palavra de ativação)
if (res->wake_word_detected == WAKENET_DETECTED) {
ESP_LOGW(TAG, ">>> PALAVRA-CHAVE DETECTADA! Canal de escuta aberto.");
}
// 2. Reconhecimento de comando local
if (res->raw_data_size > 0) {
esp_mn_state_t mn_state = multinet->detect(model_data, res->data);
if (mn_state == ESP_MN_STATE_DETECTED) {
esp_mn_results_t *mn_res = multinet->get_results(model_data);
ESP_LOGI(TAG, ">>> COMANDO RECONHECIDO: ID #%d (Frase correspondente)", mn_res->command_id[0]);
// Exemplo de ação
if (mn_res->command_id[0] == 1) {
ESP_LOGI(TAG, "Ação: Ligar Luz da Sala");
} else if (mn_res->command_id[0] == 2) {
ESP_LOGI(TAG, "Ação: Desligar Luz da Sala");
}
} else if (mn_state == ESP_MN_STATE_TIMEOUT) {
ESP_LOGI(TAG, "Tempo esgotado. Retornando ao modo de escuta de Wake Word.");
}
}
}
vTaskDelete(NULL);
}
void app_main(void)
{
ESP_LOGI(TAG, "Iniciando ESP-SR Speech Recognition Engine");
// Configura o pipeline de Audio Front-End (AEC, BSS, VAD, WakeNet)
afe_config_t afe_config = AFE_CONFIG_DEFAULT();
afe_config.wakenet_init = true;
afe_config.voice_communication_init = false;
esp_afe_sr_data_t *afe_data = ESP_AFE_SR_HANDLE.create_from_config(&afe_config);
// Cria as tarefas de alimentação de áudio e reconhecimento
xTaskCreatePinnedToCore(feed_audio_task, "feed_task", 4096, afe_data, 5, NULL, 0);
xTaskCreatePinnedToCore(speech_recognition_task, "sr_task", 8192, afe_data, 5, NULL, 1);
}
public/exemplos/zh-CN/esp-who.c
+71
View File
@@ -0,0 +1,71 @@
#include "esp_camera.h"
#include "fd_forward.h" // Face Detection
#include "fr_forward.h" // Face Recognition
#include "human_face_detect_msr01.hpp"
#include "human_face_detect_mnp01.hpp"
#define CAMERA_MODEL_AI_THINKER // ou o modelo da sua placa
#include "camera_pins.h"
void setup() {
Serial.begin(115200);
Serial.setDebugOutput(true);
Serial.println("Iniciando câmera...");
camera_config_t config;
config.ledc_channel = LEDC_CHANNEL_0;
config.ledc_timer = LEDC_TIMER_0;
config.pin_d0 = Y2_GPIO_NUM;
config.pin_d1 = Y3_GPIO_NUM;
config.pin_d2 = Y4_GPIO_NUM;
config.pin_d3 = Y5_GPIO_NUM;
config.pin_d4 = Y6_GPIO_NUM;
config.pin_d5 = Y7_GPIO_NUM;
config.pin_d6 = Y8_GPIO_NUM;
config.pin_d7 = Y9_GPIO_NUM;
config.pin_xclk = XCLK_GPIO_NUM;
config.pin_pclk = PCLK_GPIO_NUM;
config.pin_vsync = VSYNC_GPIO_NUM;
config.pin_href = HREF_GPIO_NUM;
config.pin_sscb_sda = SIOD_GPIO_NUM;
config.pin_sscb_scl = SIOC_GPIO_NUM;
config.pin_pwdn = PWDN_GPIO_NUM;
config.pin_reset = RESET_GPIO_NUM;
config.xclk_freq_hz = 20000000;
config.pixel_format = PIXFORMAT_RGB565;
config.frame_size = FRAMESIZE_QVGA;
config.fb_count = 1;
if (esp_camera_init(&config) != ESP_OK) {
Serial.println("Falha ao iniciar a câmera!");
return;
}
Serial.println("Câmera inicializada com sucesso!");
}
void loop() {
camera_fb_t *fb = esp_camera_fb_get();
if (!fb) {
Serial.println("Falha ao capturar imagem!");
return;
}
// Detecta rostos na imagem
box_array_t *faces = face_detect_msr01(fb->buf, fb->width, fb->height, fb->format);
if (faces) {
Serial.printf("Rostos detectados: %d\n", faces->len);
for (int i = 0; i < faces->len; i++) {
box_t *box = &faces->box[i];
Serial.printf("Face %d - x:%d y:%d w:%d h:%d\n", i, box->box_p[0], box->box_p[1],
box->box_p[2] - box->box_p[0], box->box_p[3] - box->box_p[1]);
}
dl_lib_free(faces);
} else {
Serial.println("Nenhum rosto detectado.");
}
esp_camera_fb_return(fb);
delay(1000);
}
public/exemplos/zh-CN/esp-zigbee.c
+97
View File
@@ -0,0 +1,97 @@
/*
* Exemplo ESP-Zigbee-SDK para ESP32-H2 e ESP32-C6 (IEEE 802.15.4)
* Dispositivo: Lâmpada Inteligente Zigbee 3.0 (Home Automation End Device)
*
* Dependência (idf_component.yml):
* espressif/esp-zigbee-lib: "^1.6.0"
*/
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "nvs_flash.h"
#include "esp_zigbee_core.h"
static const char *TAG = "zigbee_light_device";
#define HA_ESP_LIGHT_ENDPOINT 1
#define ESP_ZB_PRIMARY_CHANNEL_MASK (1l << 15) // Canal 15 padrão Zigbee
/* Callback de escrita em atributos Zigbee (ex: Liga/Desliga via Home Assistant) */
static esp_err_t zb_attribute_handler(const esp_zb_zcl_set_attr_value_message_t *message)
{
if (message->info.cluster == ESP_ZB_ZCL_CLUSTER_ID_ON_OFF) {
if (message->attribute.id == ESP_ZB_ZCL_ATTR_ON_OFF_ON_OFF_ID &&
message->attribute.data.type == ESP_ZB_ZCL_ATTR_TYPE_BOOL) {
bool on_off_state = message->attribute.data.value ? *(bool *)message->attribute.data.value : false;
ESP_LOGW(TAG, ">>> COMANDO ZIGBEE RECEBIDO: Lâmpada %s", on_off_state ? "LIGADA" : "DESLIGADA");
}
}
return ESP_OK;
}
/* Callback de eventos da pilha Zigbee */
void esp_zb_app_signal_handler(esp_zb_app_signal_msg_t *signal_msg)
{
uint32_t *p_sg_p = signal_msg->p_app_signal;
esp_err_t err_status = signal_msg->esp_err_status;
esp_zb_app_signal_type_t sig_type = *p_sg_p;
switch (sig_type) {
case ESP_ZB_ZDO_SIGNAL_SKIP_STARTUP:
ESP_LOGI(TAG, "Iniciando comissionamento na rede Zigbee...");
esp_zb_bdb_start_top_level_commissioning(ESP_ZB_BDB_MODE_NETWORK_STEERING);
break;
case ESP_ZB_BDB_SIGNAL_STEERING:
if (err_status == ESP_OK) {
ESP_LOGI(TAG, "Conectado com sucesso à rede Zigbee 3.0!");
} else {
ESP_LOGW(TAG, "Buscando coordenador Zigbee novamente...");
esp_zb_scheduler_alarm((esp_zb_callback_t)esp_zb_bdb_start_top_level_commissioning, ESP_ZB_BDB_MODE_NETWORK_STEERING, 1000);
}
break;
default:
break;
}
}
static void esp_zb_task(void *pvParameters)
{
// Configura nó Zigbee como End Device
esp_zb_cfg_t zb_nwk_cfg = {
.esp_zb_role = ESP_ZB_DEVICE_TYPE_ED,
.install_code_policy = false,
.nwk_cfg.zed_cfg = {
.ed_timeout = ESP_ZB_ED_0_5_MIN,
.keep_alive = 3000,
},
};
esp_zb_init(&zb_nwk_cfg);
// Cria o cluster de On/Off de iluminação residencial
esp_zb_on_off_light_cfg_t light_cfg = ESP_ZB_DEFAULT_ON_OFF_LIGHT_CONFIG();
esp_zb_ep_list_t *ep_list = esp_zb_on_off_light_ep_create(HA_ESP_LIGHT_ENDPOINT, &light_cfg);
// Registra endpoint e manipulador de atributos
esp_zb_device_register(ep_list);
esp_zb_core_action_handler_register(zb_attribute_handler);
esp_zb_set_primary_network_channel_set(ESP_ZB_PRIMARY_CHANNEL_MASK);
ESP_ERROR_CHECK(esp_zb_start(false));
esp_zb_main_loop_iteration();
}
void app_main(void)
{
ESP_ERROR_CHECK(nvs_flash_init());
// Inicializa a pilha de rádio IEEE 802.15.4
esp_zb_platform_config_t config = {
.radio_config = { .radio_mode = ZB_RADIO_MODE_NATIVE },
.host_config = { .host_connection_mode = ZB_HOST_CONNECTION_MODE_NONE },
};
ESP_ERROR_CHECK(esp_zb_platform_config(&config));
xTaskCreate(esp_zb_task, "Zigbee_main", 4096, NULL, 5, NULL);
}
public/exemplos/zh-CN/micropython.py
+11
View File
@@ -0,0 +1,11 @@
from machine import Pin
from time import sleep
# Define o pino 2 como saída (geralmente o LED embutido)
led = Pin(2, Pin.OUT)
while True:
led.value(1) # Liga o LED
sleep(0.5) # Aguarda 0,5 segundos
led.value(0) # Desliga o LED
sleep(0.5) # Aguarda 0,5 segundos
public/exemplos/zh-CN/rust-esp.rs
+48
View File
@@ -0,0 +1,48 @@
//! Exemplo Rust no ESP32 usando `esp-hal` (Modo Bare-Metal / no_std)
//! Pisca um LED e envia mensagens via UART Serial com segurança de memória garantida.
//!
//! Cargo.toml:
//! esp-hal = { version = "0.22", features = ["esp32s3"] }
//! esp-println = { version = "0.12", features = ["esp32s3", "log"] }
#![no_std]
#![no_main]
use esp_backtrace as _;
use esp_hal::{
clock::ClockControl,
gpio::{Io, Level, Output},
peripherals::Peripherals,
system::SystemControl,
timer::timg::TimerGroup,
delay::Delay,
prelude::*,
};
use esp_println::println;
#[entry]
fn main() -> ! {
// Inicializa periféricos do SoC com verificação em tempo de compilação
let peripherals = Peripherals::take();
let system = SystemControl::new(peripherals.SYSTEM);
let clocks = ClockControl::boot_defaults(system.clock_control).freeze();
// Configura os pinos de E/S
let io = Io::new(peripherals.GPIO, peripherals.IO_MUX);
let mut led = Output::new(io.pins.gpio2, Level::Low);
let delay = Delay::new(&clocks);
println!("🦀 Firmware Rust Bare-Metal inicializado no ESP32!");
let mut counter: u32 = 0;
loop {
// Inverte estado do LED com garantia de exclusão mútua
led.toggle();
counter += 1;
println!("Ciclo Rust #{}: LED está {:?}", counter, led.is_set_high());
delay.delay_millis(500);
}
}