Files
ESPDocs/lib/data/zh-CN/componentes.js
T
Lucas RayanandClaude Sonnet 5.5 5a9fe676fc
CI / Lint e auditorias (push) Successful in 1m10s
CI / Trivy (dependências e segredos) (push) Successful in 12s
CI / Imagem Docker (linux/arm64) (push) Successful in 2m39s
Release / Plano (reaproveitar a imagem?) (push) Successful in 6s
Release / ci (push) Skipped
Release / Publica a imagem (linux/arm64) (push) Successful in 18s
Release / Cria a release no Gitea (push) Successful in 5s
feat(i18n): Simplified Chinese (zh-CN), search answers per locale, fr/de/es data fixes
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-01 23:28:39 -03:00

859 lines
34 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 官方精选数据库: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 增强版与配网",
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、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: "可寻址 LED 灯带(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 7\" 触摸 LCD",
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++ 现代封装",
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"`
};