2 Commits
Author SHA1 Message Date
Lucas RayanandClaude Sonnet 5.5 7b673aeb4b docs: changelog 1.4.0
Release / Plano (reaproveitar a imagem?) (push) Successful in 5s
Release / ci (push) Skipped
Release / Publica a imagem (linux/arm64) (push) Successful in 17s
Release / Cria a release no Gitea (push) Successful in 5s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VAyr8dT9k6tS5BbPrzYvAv
2026-11-01 20:09:05 -03:00
Lucas RayanandAntigravity 660b28c09d feat(i18n): Spanish localization (phase 4)
CI / Lint e auditorias (push) Successful in 1m31s
CI / Trivy (dependências e segredos) (push) Successful in 10s
CI / Imagem Docker (linux/arm64) (push) Successful in 2m23s
Complete implementation of Spanish (es-419) language support:
- Canonical catalogs and data: messages/es.json, data/es/**, lib/data/es/**, public/exemplos/es/**
- Canonical slugs: /es/series, /es/catalogo, /es/comparacion, /es/componentes, /es/diagnostico, /es/frameworks, /es/glosario, /es/selector, /es/acerca
- Dedicated search index at /api/busca/es with Spanish accent normalization
- Strict exclusion of book references in Spanish routes and catalogs
- Language selector and root negotiation with es active (ENABLED_LOCALES = ['pt', 'en', 'es'])
- Extended verification suite: check-i18n, smoke-imagem and verifica-vazamentos

Co-Authored-By: Antigravity <noreply@google.com>
2026-11-01 19:50:20 -03:00
72 changed files with 17852 additions and 948 deletions

No files matched your search

+18 -1
View File
@@ -6,6 +6,22 @@ Tudo o que muda de relevante no ESPDocs está aqui. O formato segue o
## [Não lançado]
## [1.4.0] - 2026-11-01
### Adicionado
- Internacionalização completa para o idioma espanhol neutro latino-americano (`es`) (Fase 4):
- Ativação do espanhol em `ENABLED_LOCALES = ["pt", "en", "es"]` e no seletor de idiomas do cabeçalho.
- Tradução técnica integral e paridade estrutural em `messages/es.json` (15 namespaces) e arquivos de dados em `data/es/` (`series.json`, `frameworks.json`, `conexoes/*.json`) e `lib/data/es/` (`glossario.js`, `diagnostico.js`, `componentes.js`, `topicos.js`).
- 14 exemplos práticos de código com comentários em espanhol em `public/exemplos/es/`.
- Roteamento com slugs canônicos em espanhol (`/es/catalogo`, `/es/comparacion`, `/es/componentes`, `/es/diagnostico`, `/es/frameworks`, `/es/glosario`, `/es/selector`, `/es/acerca`).
- Busca por idioma em `/api/busca/es` com normalização de acentos e 'ñ', sem menção ao livro e com links para os slugs canônicos em espanhol.
- Exclusão total e estrita de referências ao livro no idioma espanhol (menu, rodapé, busca, sitemap e metadados), mantendo `/es/livro` respondendo HTTP 404.
- Tabela de catálogo com cabeçalhos traduzidos e mapeamento de valores na interface em espanhol.
- Negociação de idioma na raiz com roteamento para `es` para cabeçalhos Accept-Language `es-*` ou cookie `NEXT_LOCALE=es`, e fallback padrão para `en` para navegadores com idiomas inativos (`fr`, `de`, `zh-CN`).
- Metadados de SEO, Open Graph e Twitter Cards localizados com `og:locale` (`es_419`), `inLanguage` (`es-419`) e `hreflang` cruzado entre `pt-BR`, `en`, `es-419` e `x-default`.
- Extensão dos scripts de verificação: `scripts/check-i18n.mjs` valida `es`, `scripts/smoke-imagem.sh` testa as rotas espanholas e `scripts/verifica-vazamentos.py` varre as 36 rotas em espanhol (texto visível e JSON-LD).
## [1.3.0] - 2026-11-01
### Adicionado
@@ -134,7 +150,8 @@ entrada resume tudo desde o primeiro commit, em 2025-10-21, até a imagem Docker
otimização de imagens (GHSA-2464-fhr4-w9xw), e `postcss` fixado acima da cópia
embutida no `next`.
[Não lançado]: https://git.lucasrguerra.dev.br/lucasrguerra/ESPDocs/compare/v1.3.0...HEAD
[Não lançado]: https://git.lucasrguerra.dev.br/lucasrguerra/ESPDocs/compare/v1.4.0...HEAD
[1.4.0]: https://git.lucasrguerra.dev.br/lucasrguerra/ESPDocs/compare/v1.3.0...v1.4.0
[1.3.0]: https://git.lucasrguerra.dev.br/lucasrguerra/ESPDocs/compare/v1.2.0...v1.3.0
[1.2.0]: https://git.lucasrguerra.dev.br/lucasrguerra/ESPDocs/compare/v1.1.0...v1.2.0
[1.1.0]: https://git.lucasrguerra.dev.br/lucasrguerra/ESPDocs/compare/v1.0.0...v1.1.0
+14 -5
View File
@@ -3,15 +3,20 @@ import { paginaMeta, jsonLd } from "@/lib/seo";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return paginaMeta({
titulo: isEn ? "ESP32 Board Catalog" : "Catálogo de placas ESP32",
titulo: isEn ? "ESP32 Board Catalog" : isEs ? "Catálogo de placas ESP32" : "Catálogo de placas ESP32",
descricao: isEn
? "ESP32 development boards and DevKits available in Brazil, with filters by series, connector, and USB-serial converter."
: isEs
? "Placas de desarrollo y DevKits con ESP32, con filtros por serie, conector y conversor USB-serial."
: "Placas de desenvolvimento com ESP32 disponíveis no Brasil, com filtro por série, conector e conversor USB-serial.",
caminho: "/catalogo",
locale,
keywords: isEn
? ["ESP32 boards", "ESP32 DevKit", "buy ESP32", "ESP32 DevKitC"]
: isEs
? ["placas ESP32", "DevKit ESP32", "comprar ESP32", "ESP32 DevKitC"]
: ["placas ESP32", "DevKit ESP32", "comprar ESP32", "ESP32 DevKitC"],
});
}
@@ -19,6 +24,8 @@ export async function generateMetadata({ params }) {
export default async function Layout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
const canonPath = isEn ? "/en/catalog" : isEs ? "/es/catalogo" : "/catalogo";
return (
<>
@@ -27,11 +34,13 @@ export default async function Layout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.aplicacaoWeb({
nome: isEn ? "ESP32 Development Board Catalog" : "Catálogo de Placas ESP32",
nome: isEn ? "ESP32 Development Board Catalog" : isEs ? "Catálogo de placas de desarrollo ESP32" : "Catálogo de Placas ESP32",
descricao: isEn
? "Interactive guide and catalog of development boards and DevKits featuring ESP32 microcontrollers."
: isEs
? "Guía y catálogo interactivo de placas de desarrollo y DevKits con microcontroladores ESP32."
: "Guia e catálogo interativo de placas de desenvolvimento e DevKits com microcontroladores ESP32.",
caminho: isEn ? "/en/catalog" : "/catalogo",
caminho: canonPath,
locale,
})
),
@@ -42,8 +51,8 @@ export default async function Layout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "Board Catalog" : "Catálogo de Placas", caminho: isEn ? "/en/catalog" : "/catalogo" },
{ nome: isEn ? "Home" : isEs ? "Inicio" : "Início", caminho: isEn ? "/en" : isEs ? "/es" : "/" },
{ nome: isEn ? "Board Catalog" : isEs ? "Catálogo de placas" : "Catálogo de Placas", caminho: canonPath },
])
),
}}
+53 -18
View File
@@ -33,9 +33,35 @@ const VALUE_MAP_EN = {
"Opcional": "Optional",
};
const HEADER_MAP_ES = {
"Nome": "Nombre",
"Descrição": "Descripción",
"Série": "Serie",
"Loja Oficial": "Tienda oficial",
"Fabricante": "Fabricante",
"Processador": "Procesador",
"Memória Flash": "Memoria flash",
"PSRAM": "PSRAM",
"Conector USB": "Conector USB",
"Interface USB": "Interfaz USB",
"Antena": "Antena",
"Bateria": "Batería",
"Display": "Pantalla",
"Sensores": "Sensores",
"Botões": "Botones",
"LEDs": "LEDs",
};
const VALUE_MAP_ES = {
"Sim": "Sí",
"Não": "No",
"Opcional": "Opcional",
};
export default function PlacasPage() {
const pathname = usePathname() || "";
const isEn = pathname === "/en" || pathname.startsWith("/en/");
const isEs = pathname === "/es" || pathname.startsWith("/es/");
const [boards, setBoards] = useState([]);
const [filteredBoards, setFilteredBoards] = useState([]);
@@ -64,7 +90,7 @@ export default function PlacasPage() {
const response = await fetch("/api/placas");
if (!response.ok) {
throw new Error(isEn ? "Failed to load board data" : "Erro ao carregar dados das placas");
throw new Error(isEn ? "Failed to load board data" : isEs ? "Error al cargar los datos de las placas" : "Erro ao carregar dados das placas");
}
const result = await response.json();
@@ -168,13 +194,16 @@ export default function PlacasPage() {
const hero = (
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Board Catalog" : "Catálogo de placas" }]}
isEs={isEs}
trail={[{ label: isEn ? "Board Catalog" : isEs ? "Catálogo de placas" : "Catálogo de placas" }]}
icon={ShoppingCart}
label={isEn ? "Real DevKits and modules" : "DevKits e módulos reais"}
title={isEn ? "ESP32 Board Catalog" : "Catálogo de placas ESP32"}
label={isEn ? "Real DevKits and modules" : isEs ? "DevKits y módulos reales" : "DevKits e módulos reais"}
title={isEn ? "ESP32 Board Catalog" : isEs ? "Catálogo de placas ESP32" : "Catálogo de placas ESP32"}
lede={
isEn
? "Compare official and third-party boards for your project: USB interface, on-board sensors and direct store links."
: isEs
? "Compare placas oficiales y alternativas para su proyecto: interfaz USB, sensores integrados y enlace directo a la tienda."
: "Compare placas oficiais e alternativas para o seu projeto: interface USB, sensores integrados e link direto para a loja."
}
/>
@@ -186,14 +215,14 @@ export default function PlacasPage() {
<Header />
<main id="conteudo">
{hero}
<section className="shell section pt-10" aria-busy="true" aria-label={isEn ? "Loading boards" : "Carregando placas"}>
<section className="shell section pt-10" aria-busy="true" aria-label={isEn ? "Loading boards" : isEs ? "Cargando placas" : "Carregando placas"}>
<div className="grid gap-4 md:grid-cols-2 xl:grid-cols-3">
{Array.from({ length: 6 }).map((_, i) => (
<div key={i} className="card h-72 animate-pulse bg-surface-2" />
))}
</div>
<p role="status" className="mt-6 text-center text-sm text-muted">
{isEn ? "Querying boards database…" : "Consultando o banco de placas…"}
{isEn ? "Querying boards database…" : isEs ? "Consultando la base de datos de placas…" : "Consultando o banco de placas…"}
</p>
</section>
</main>
@@ -213,14 +242,14 @@ export default function PlacasPage() {
<AlertTriangle className="mt-0.5 h-5 w-5 shrink-0 text-danger" aria-hidden="true" />
<div>
<p className="font-semibold text-ink">
{isEn ? "Could not load boards" : "Não foi possível carregar as placas"}
{isEn ? "Could not load boards" : isEs ? "No se pudieron cargar las placas" : "Não foi possível carregar as placas"}
</p>
<p className="mt-1">
{error}. {isEn ? "Check your connection and try again." : "Verifique a conexão e tente de novo."}
{error}. {isEn ? "Check your connection and try again." : isEs ? "Compruebe la conexión y vuelva a intentarlo." : "Verifique a conexão e tente de novo."}
</p>
<button type="button" onClick={fetchBoards} className="btn btn-primary btn-sm mt-4">
<RefreshCw className="h-4 w-4" aria-hidden="true" />
{isEn ? "Try again" : "Tentar novamente"}
{isEn ? "Try again" : isEs ? "Reintentar" : "Tentar novamente"}
</button>
</div>
</div>
@@ -235,14 +264,14 @@ export default function PlacasPage() {
<div className="space-y-6">
<div>
<label htmlFor="busca-placa" className="text-sm font-semibold text-ink">
{isEn ? "Search board" : "Buscar placa"}
{isEn ? "Search board" : isEs ? "Buscar placa" : "Buscar placa"}
</label>
<div className="relative mt-2">
<Search className="pointer-events-none absolute left-3.5 top-1/2 h-4 w-4 -translate-y-1/2 text-muted" aria-hidden="true" />
<input
id="busca-placa"
type="search"
placeholder={isEn ? "Name or description" : "Nome ou descrição"}
placeholder={isEn ? "Name or description" : isEs ? "Nombre o descripción" : "Nome ou descrição"}
value={searchTerm}
onChange={(e) => setSearchTerm(e.target.value)}
className="field pl-10 text-sm"
@@ -253,7 +282,7 @@ export default function PlacasPage() {
{filterableColumns.map((column) => {
const filterData = filterOptions[column];
if (!filterData) return null;
const colLabel = isEn ? (HEADER_MAP_EN[column] || column) : column;
const colLabel = isEn ? (HEADER_MAP_EN[column] || column) : isEs ? (HEADER_MAP_ES[column] || column) : column;
if (filterData.isBinary) {
return (
@@ -277,7 +306,7 @@ export default function PlacasPage() {
</legend>
<div className="mt-2 max-h-44 space-y-0.5 overflow-y-auto pr-1">
{filterData.values.map((option) => {
const optLabel = isEn ? (VALUE_MAP_EN[option] || option) : option;
const optLabel = isEn ? (VALUE_MAP_EN[option] || option) : isEs ? (VALUE_MAP_ES[option] || option) : option;
return (
<label key={option} className="flex min-h-10 cursor-pointer items-center gap-3 rounded-lg px-2 text-sm text-muted transition-colors hover:bg-surface-2 hover:text-ink">
<input
@@ -304,14 +333,14 @@ export default function PlacasPage() {
<main id="conteudo">
{hero}
<section className="shell section pt-10 sm:pt-12" aria-label={isEn ? "Boards" : "Placas"}>
<section className="shell section pt-10 sm:pt-12" aria-label={isEn ? "Boards" : isEs ? "Placas" : "Placas"}>
<div className="grid gap-8 lg:grid-cols-[17rem_1fr] lg:gap-10">
<aside className="lg:sticky lg:top-28 lg:self-start">
<details className="panel" open={filtrosAbertos} onToggle={(e) => setFiltrosAbertos(e.currentTarget.open)}>
<summary className="flex min-h-12 cursor-pointer list-none items-center justify-between gap-3 px-5 py-3 lg:cursor-default">
<span className="flex items-center gap-2 text-sm font-semibold text-ink">
<SlidersHorizontal className="h-4 w-4 text-accent" aria-hidden="true" />
{isEn ? "Filters" : "Filtros"}
{isEn ? "Filters" : isEs ? "Filtros" : "Filtros"}
{activeFilterCount > 0 && <span className="chip chip-accent px-2 py-0">{activeFilterCount}</span>}
</span>
{activeFilterCount > 0 && (
@@ -323,7 +352,7 @@ export default function PlacasPage() {
}}
className="text-sm font-medium text-accent hover:text-accent-strong"
>
{isEn ? "Clear" : "Limpar"}
{isEn ? "Clear" : isEs ? "Limpiar" : "Limpar"}
</button>
)}
</summary>
@@ -338,6 +367,10 @@ export default function PlacasPage() {
? filteredBoards.length === 1
? "board found"
: "boards found"
: isEs
? filteredBoards.length === 1
? "placa encontrada"
: "placas encontradas"
: filteredBoards.length === 1
? "placa encontrada"
: "placas encontradas"}
@@ -347,15 +380,17 @@ export default function PlacasPage() {
<div className="card mt-4 px-6 py-14 text-center">
<Search className="mx-auto h-10 w-10 text-muted" aria-hidden="true" />
<h2 className="mt-4 font-display text-xl font-semibold text-ink">
{isEn ? "No boards match these filters" : "Nenhuma placa com esses filtros"}
{isEn ? "No boards match these filters" : isEs ? "Ninguna placa coincide con estos filtros" : "Nenhuma placa com esses filtros"}
</h2>
<p className="mx-auto mt-2 max-w-md text-sm text-muted">
{isEn
? "Remove some filters or search by another name."
: isEs
? "Elimine algunos filtros o busque por otro nombre."
: "Remova alguns filtros ou busque por outro nome."}
</p>
<button type="button" onClick={clearFilters} className="btn btn-primary mt-6">
{isEn ? "Clear filters" : "Limpar filtros"}
{isEn ? "Clear filters" : isEs ? "Limpiar filtros" : "Limpar filtros"}
</button>
</div>
) : (
+30 -6
View File
@@ -3,15 +3,20 @@ import { paginaMeta, jsonLd } from "@/lib/seo";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return paginaMeta({
titulo: isEn ? "Compare ESP32 Series: Side-by-Side Table" : "Comparar séries ESP32",
titulo: isEn ? "Compare ESP32 Series: Side-by-Side Table" : isEs ? "Comparar series ESP32: tabla comparativa" : "Comparar séries ESP32",
descricao: isEn
? "Compare up to four ESP32 series side by side: processor, Wi-Fi, Bluetooth, memory, GPIO, peripherals, and hardware security, with official datasheet data."
: isEs
? "Compare hasta cuatro series de ESP32 frente a frente: procesador, Wi-Fi, Bluetooth, memoria, GPIO, periféricos y seguridad en hardware, con datos de hojas de datos oficiales."
: "Compare até quatro séries de ESP32 lado a lado: processador, Wi-Fi, Bluetooth, memória, GPIO, periféricos e segurança em hardware, com os dados dos datasheets oficiais.",
caminho: "/comparacao",
locale,
keywords: isEn
? ["compare ESP32", "ESP32 vs ESP32-S3", "ESP32 comparison table", "which ESP32 is best"]
: isEs
? ["comparar ESP32", "ESP32 vs ESP32-S3", "tabla comparativa ESP32", "cuál ESP32 es mejor"]
: ["comparar ESP32", "ESP32 vs ESP32-S3", "tabela comparativa ESP32", "qual ESP32 é melhor"],
});
}
@@ -46,10 +51,27 @@ const faqsEn = [
},
];
const faqsEs = [
{
pergunta: "¿Cómo comparar microcontroladores ESP32 frente a frente?",
resposta: "El comparador de ESPDocs le permite seleccionar hasta cuatro series simultáneamente para cotejar arquitectura, frecuencia de reloj, memoria SRAM/PSRAM, estándares de radio (Wi-Fi 4/6, Bluetooth 5/6, 802.15.4), interfaces de periféricos y bloques de seguridad en hardware.",
},
{
pergunta: "¿Cuál es la diferencia entre el ESP32 clásico y el ESP32-S3?",
resposta: "El ESP32 clásico utiliza núcleos Xtensa LX6 y Bluetooth clásico/LE. El ESP32-S3 incorpora núcleos Xtensa LX7 con instrucciones vectoriales para inteligencia artificial (TinyML), USB nativo OTG, más GPIOs (45 frente a 36) y Bluetooth 5.0 LE.",
},
{
pergunta: "¿Cuál es la diferencia entre ESP32-C3 y ESP32-C6?",
resposta: "El ESP32-C3 es un microcontrolador RISC-V con Wi-Fi 4 y Bluetooth 5 LE. El ESP32-C6 evoluciona a Wi-Fi 6 (802.11ax), Bluetooth 5.4 LE, radio IEEE 802.15.4 para Zigbee 3.0 y Thread 1.3, además de un coprocesador de consumo ultrabajo.",
},
];
export default async function Layout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const faqs = isEn ? faqsEn : faqsPt;
const isEs = locale === "es";
const faqs = isEn ? faqsEn : isEs ? faqsEs : faqsPt;
const canonPath = isEn ? "/en/compare" : isEs ? "/es/comparacion" : "/comparacao";
return (
<>
@@ -58,11 +80,13 @@ export default async function Layout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.aplicacaoWeb({
nome: isEn ? "ESP32 Series Comparator" : "Comparador de Séries ESP32",
nome: isEn ? "ESP32 Series Comparator" : isEs ? "Comparador de series ESP32" : "Comparador de Séries ESP32",
descricao: isEn
? "Technical comparison table to analyze specifications, pinouts, and features of multiple ESP32 series."
: isEs
? "Tabla comparativa técnica para analizar especificaciones, patillaje y características de múltiples series de ESP32."
: "Tabela comparativa técnica para analisar especificações, pinagens e recursos de múltiplas séries de ESP32.",
caminho: isEn ? "/en/compare" : "/comparacao",
caminho: canonPath,
locale,
})
),
@@ -73,8 +97,8 @@ export default async function Layout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "Compare Series" : "Comparar Séries", caminho: isEn ? "/en/compare" : "/comparacao" },
{ nome: isEn ? "Home" : isEs ? "Inicio" : "Início", caminho: isEn ? "/en" : isEs ? "/es" : "/" },
{ nome: isEn ? "Compare Series" : isEs ? "Comparar series" : "Comparar Séries", caminho: canonPath },
])
),
}}
+121 -26
View File
@@ -8,6 +8,7 @@ import { usePathname } from "next/navigation";
import Link from "next/link";
import seriesDataPt from "@/public/series.json";
import seriesDataEn from "@/data/en/series.json";
import seriesDataEs from "@/data/es/series.json";
import { getLocalizedHref } from "@/i18n/links";
import { ArrowRight, ArrowUpRight, Check, ChevronDown, Scale } from "lucide-react";
@@ -177,18 +178,98 @@ const COMPARE_FIELDS_EN = [
]},
];
const COMPARE_FIELDS_ES = [
{ category: "General", fields: [
{ key: "nome_completo", label: "Nombre completo" },
{ key: "descricao", label: "Descripción" },
]},
{ category: "Disponibilidad y herramientas", fields: [
{ key: "esp_idf_minimo", label: "ESP-IDF mínimo" },
{ key: "arduino_core", label: "Core Arduino" },
{ key: "depuracao", label: "Depuración / JTAG" },
{ key: "encapsulamento", label: "Encapsulado" },
{ key: "modulos", label: "Módulos disponibles" },
]},
{ category: "Procesador", fields: [
{ key: "arquitetura", label: "Arquitectura" },
{ key: "nucleos", label: "Núcleos" },
{ key: "frequencia", label: "Frecuencia" },
{ key: "coprocessador_ulp", label: "Coprocesador ULP" },
{ key: "aceleradores_ia", label: "Aceleradores de IA" },
]},
{ category: "Conectividad", fields: [
{ key: "wifi", label: "Wi-Fi" },
{ key: "bluetooth", label: "Bluetooth" },
{ key: "zigbee_thread", label: "Zigbee/Thread" },
{ key: "matter", label: "Matter" },
{ key: "ethernet", label: "Ethernet" },
]},
{ category: "Memoria", fields: [
{ key: "memoria_sram", label: "SRAM" },
{ key: "memoria_sram_rtc", label: "SRAM RTC" },
{ key: "memoria_rom", label: "ROM" },
{ key: "flash_externa", label: "Flash externa" },
{ key: "psram_externa", label: "PSRAM externa" },
]},
{ category: "Periféricos digitales", fields: [
{ key: "gpio", label: "GPIO" },
{ key: "uart", label: "UART" },
{ key: "spi", label: "SPI" },
{ key: "i2c", label: "I²C" },
{ key: "i2s", label: "I²S" },
{ key: "pwm", label: "PWM" },
{ key: "can", label: "CAN" },
{ key: "usb", label: "USB" },
{ key: "depuracao", label: "Depuración / JTAG" },
{ key: "sdio", label: "SDIO" },
]},
{ category: "Periféricos analógicos", fields: [
{ key: "adc", label: "ADC" },
{ key: "dac", label: "DAC" },
{ key: "touch", label: "Touch capacitivo" },
{ key: "sensor_hall", label: "Sensor Hall" },
{ key: "sensor_temperatura", label: "Sensor de temperatura" },
]},
{ category: "Seguridad", fields: [
{ key: "seguranca.aes", label: "AES" },
{ key: "seguranca.sha", label: "SHA" },
{ key: "seguranca.rsa", label: "RSA / MPI" },
{ key: "seguranca.ecc", label: "ECC (curvas elípticas)" },
{ key: "seguranca.ecdsa", label: "ECDSA en hardware" },
{ key: "seguranca.hmac", label: "HMAC" },
{ key: "seguranca.assinatura_digital", label: "Firma digital (DS)" },
{ key: "seguranca.key_manager", label: "Key Manager" },
{ key: "seguranca.rng", label: "Generador aleatorio (TRNG)" },
{ key: "seguranca.criptografia_flash", label: "Cifrado de flash" },
{ key: "seguranca.secure_boot", label: "Secure Boot" },
{ key: "seguranca.protecao_dpa", label: "Protección contra DPA" },
]},
{ category: "Interfaces especiales", fields: [
{ key: "lcd", label: "LCD" },
{ key: "camera", label: "Cámara" },
{ key: "mipi_csi", label: "MIPI CSI" },
{ key: "mipi_dsi", label: "MIPI DSI" },
{ key: "ethernet_mac", label: "Ethernet MAC" },
]},
{ category: "Especificaciones ambientales", fields: [
{ key: "temperatura_operacao", label: "Temp. operación" },
{ key: "temperatura_armazenamento", label: "Temp. almacenamiento" },
]},
];
export default function Comparacao() {
const pathname = usePathname();
const isEn = pathname?.startsWith("/en");
const currentLocale = isEn ? "en" : "pt";
const seriesData = isEn ? seriesDataEn : seriesDataPt;
const compareFields = isEn ? COMPARE_FIELDS_EN : COMPARE_FIELDS_PT;
const isEs = pathname?.startsWith("/es");
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const seriesData = isEs ? seriesDataEs : isEn ? seriesDataEn : seriesDataPt;
const compareFields = isEs ? COMPARE_FIELDS_ES : isEn ? COMPARE_FIELDS_EN : COMPARE_FIELDS_PT;
const [selectedSeries, setSelectedSeries] = useState(["ESP32", "ESP32-S3"]);
const [soDiferencas, setSoDiferencas] = useState(false);
const [collapsedCategories, setCollapsedCategories] = useState(() => ({
[isEn ? "Special Interfaces" : "Interfaces Especiais"]: true,
[isEn ? "Environmental Specifications" : "Especificações Ambientais"]: true,
[isEs ? "Interfaces especiales" : isEn ? "Special Interfaces" : "Interfaces Especiais"]: true,
[isEs ? "Especificaciones ambientales" : isEn ? "Environmental Specifications" : "Especificações Ambientais"]: true,
}));
const series = Object.entries(seriesData);
@@ -214,19 +295,19 @@ export default function Comparacao() {
};
const renderValue = (value) => {
if (!value || value === "Não" || value === "No") return <span className="text-muted">{isEn ? "No" : "Não"}</span>;
if (value === "Sim" || value === "Yes") {
if (!value || value === "Não" || value === "No") return <span className="text-muted">{isEs || isEn ? "No" : "Não"}</span>;
if (value === "Sim" || value === "Yes" || value === "Sí") {
return (
<span className="inline-flex items-center gap-1.5 font-medium text-ok">
<Check className="h-4 w-4" aria-hidden="true" />
{isEn ? "Yes" : "Sim"}
{isEs ? "Sí" : isEn ? "Yes" : "Sim"}
</span>
);
}
return <span className="font-medium text-ink">{value}</span>;
};
const valores = (key) => selectedSeries.map((k) => String(valorDe(seriesData[k], key) ?? (isEn ? "No" : "Não")));
const valores = (key) => selectedSeries.map((k) => String(valorDe(seriesData[k], key) ?? (isEs || isEn ? "No" : "Não")));
const diferem = (key) => new Set(valores(key)).size > 1;
return (
@@ -236,12 +317,15 @@ export default function Comparacao() {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Comparator" : "Comparador" }]}
isEs={isEs}
trail={[{ label: isEs ? "Comparador" : isEn ? "Comparator" : "Comparador" }]}
icon={Scale}
label={isEn ? "Up to four series side by side" : "Até quatro séries lado a lado"}
title={isEn ? "ESP32 Series Comparator" : "Comparador de séries"}
label={isEs ? "Hasta cuatro series lado a lado" : isEn ? "Up to four series side by side" : "Até quatro séries lado a lado"}
title={isEs ? "Comparador de series ESP32" : isEn ? "ESP32 Series Comparator" : "Comparador de séries"}
lede={
isEn
isEs
? "Ponga núcleos, radio, memoria, periféricos y seguridad en la misma tabla y vea lo que realmente cambia de un chip a otro."
: isEn
? "Put cores, radio, memory, peripherals, and security in the same table and see what really changes from chip to chip."
: "Coloque núcleos, rádio, memória, periféricos e segurança na mesma tabela e veja o que realmente muda de um chip para outro."
}
@@ -252,14 +336,21 @@ export default function Comparacao() {
<div className="flex flex-wrap items-end justify-between gap-3">
<div>
<h2 id="escolha-titulo" className="text-base font-semibold text-ink">
{isEn ? (
{isEs ? (
<>Elija de {MIN_SERIES} a {MAX_SERIES} series</>
) : isEn ? (
<>Choose {MIN_SERIES} to {MAX_SERIES} series</>
) : (
<>Escolha de {MIN_SERIES} a {MAX_SERIES} séries</>
)}
</h2>
<p role="status" aria-live="polite" className="mt-1 text-sm text-muted">
{isEn ? (
{isEs ? (
<>
{selectedSeries.length} de {MAX_SERIES} seleccionadas
{selectedSeries.length === MAX_SERIES && ". Elimine una para cambiar."}
</>
) : isEn ? (
<>
{selectedSeries.length} of {MAX_SERIES} selected
{selectedSeries.length === MAX_SERIES && ". Remove one to switch."}
@@ -298,7 +389,7 @@ export default function Comparacao() {
<section className="shell mt-8" aria-labelledby="tabela-titulo">
<div className="flex flex-wrap items-center justify-between gap-3">
<h2 id="tabela-titulo" className="text-base font-semibold text-ink">
{isEn ? "Specifications" : "Especificações"}
{isEs ? "Especificaciones" : isEn ? "Specifications" : "Especificações"}
</h2>
<label className="flex min-h-11 cursor-pointer items-center gap-2.5 text-sm font-medium text-ink-soft">
<input
@@ -307,7 +398,7 @@ export default function Comparacao() {
onChange={(e) => setSoDiferencas(e.target.checked)}
className="h-5 w-5 cursor-pointer accent-[var(--accent)]"
/>
{isEn ? "Show differences only" : "Mostrar só as diferenças"}
{isEs ? "Mostrar solo diferencias" : isEn ? "Show differences only" : "Mostrar só as diferenças"}
</label>
</div>
@@ -315,7 +406,9 @@ export default function Comparacao() {
<div className="overflow-x-auto">
<table className="w-full min-w-[30rem] border-collapse text-sm">
<caption className="sr-only">
{isEn ? (
{isEs ? (
<>Comparación de las series {selectedSeries.join(", ")}</>
) : isEn ? (
<>Comparison of series {selectedSeries.join(", ")}</>
) : (
<>Comparação das séries {selectedSeries.join(", ")}</>
@@ -324,7 +417,7 @@ export default function Comparacao() {
<thead>
<tr className="border-b border-line bg-surface-2">
<th scope="col" className="sticky left-0 z-20 w-28 bg-surface-2 px-4 py-4 text-left font-semibold text-muted sm:w-52 sm:px-6">
{isEn ? "Specification" : "Especificação"}
{isEs ? "Especificación" : isEn ? "Specification" : "Especificação"}
</th>
{selectedSeries.map((seriesKey) => (
<th key={seriesKey} scope="col" className="min-w-40 px-4 py-4 text-left sm:px-6">
@@ -381,7 +474,7 @@ export default function Comparacao() {
<section className="shell section" aria-labelledby="docs-titulo">
<h2 id="docs-titulo" className="section-title">
{isEn ? "Official documentation" : "Documentação oficial"}
{isEs ? "Documentación oficial" : isEn ? "Official documentation" : "Documentação oficial"}
</h2>
<div className="mt-6 grid gap-3 sm:grid-cols-2 lg:grid-cols-4">
{selectedSeries.map((seriesKey) => {
@@ -393,13 +486,13 @@ export default function Comparacao() {
</Link>
{seriesItem.datasheet ? (
<a href={seriesItem.datasheet} target="_blank" rel="noopener noreferrer" className="btn btn-ghost btn-sm">
{isEn ? "Official datasheet" : "Datasheet oficial"}
{isEs ? "Datasheet oficial" : isEn ? "Official datasheet" : "Datasheet oficial"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
<span className="sr-only"> {isEn ? "(opens in a new tab)" : "(abre em nova aba)"}</span>
<span className="sr-only"> {isEs ? "(abre en una nueva pestaña)" : isEn ? "(opens in a new tab)" : "(abre em nova aba)"}</span>
</a>
) : (
<span className="text-sm text-muted">
{isEn ? "Datasheet not yet published" : "Datasheet ainda não publicado"}
{isEs ? "Datasheet aún no publicado" : isEn ? "Datasheet not yet published" : "Datasheet ainda não publicado"}
</span>
)}
</div>
@@ -410,16 +503,18 @@ export default function Comparacao() {
<div className="panel mt-10 flex flex-col items-start justify-between gap-6 p-7 sm:p-10 md:flex-row md:items-center">
<div className="max-w-2xl">
<h2 className="section-title">
{isEn ? "Want to test on the bench?" : "Quer testar na bancada?"}
{isEs ? "¿Desea probar en banco?" : isEn ? "Want to test on the bench?" : "Quer testar na bancada?"}
</h2>
<p className="mt-3 text-base text-muted">
{isEn
{isEs
? "Vea las placas de desarrollo con patillaje, periféricos y enlace a la tienda oficial."
: isEn
? "Explore development boards with pinouts, peripherals, and official store links."
: "Veja as placas de desenvolvimento com pinagem, periféricos e link para a loja."}
</p>
</div>
<Link href={getLocalizedHref("/catalogo", currentLocale)} className="btn btn-primary shrink-0">
{isEn ? "View boards catalog" : "Ver catálogo de placas"}
{isEs ? "Ver catálogo de placas" : isEn ? "View boards catalog" : "Ver catálogo de placas"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
+52 -9
View File
@@ -3,16 +3,33 @@ import { paginaMeta, jsonLd } from "@/lib/seo";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return paginaMeta({
titulo: isEn
titulo: isEs
? "ESP Component Registry & IDF Component Manager · ESPDocs"
: isEn
? "ESP Component Registry & IDF Component Manager · ESPDocs"
: "ESP Component Registry & IDF Component Manager · ESPDocs",
descricao: isEn
descricao: isEs
? "Catálogo interactivo del ESP Component Registry: controladores de pantalla, LVGL, reconocimiento de voz ESP-SR, RainMaker, BSPs y generador de idf_component.yml."
: isEn
? "Official interactive catalog of the ESP Component Registry: display drivers, LVGL, ESP-SR voice recognition, RainMaker, BSPs, and idf_component.yml generator."
: "Catálogo oficial e interativo do ESP Component Registry: drivers de displays, LVGL, reconhecimento de voz ESP-SR, RainMaker, BSPs e gerador de idf_component.yml.",
caminho: "/componentes",
locale,
keywords: isEn
keywords: isEs
? [
"ESP Component Registry",
"IDF Component Manager",
"idf_component.yml",
"idf.py add-dependency",
"componentes ESP32",
"espressif esp_lvgl_port",
"espressif esp_rainmaker",
"espressif esp-sr",
"bibliotecas ESP-IDF",
]
: isEn
? [
"ESP Component Registry",
"IDF Component Manager",
@@ -76,10 +93,30 @@ const faqsEn = [
},
];
const faqsEs = [
{
pergunta: "¿Qué es el ESP Component Registry y el IDF Component Manager?",
resposta: "El ESP Component Registry (components.espressif.com) es el repositorio oficial de paquetes modulares de Espressif. El IDF Component Manager es la herramienta integrada en ESP-IDF (a partir de v4.4 y estándar en v5.x+) que descarga, compila y resuelve versiones de dependencias automáticamente desde el manifiesto idf_component.yml.",
},
{
pergunta: "¿Cómo agregar un componente a mi proyecto ESP-IDF?",
resposta: "Puede ejecutar el comando 'idf.py add-dependency \"namespace/componente^version\"' en la terminal del proyecto (por ejemplo: idf.py add-dependency \"espressif/esp_lvgl_port^2.4.0\") o editar directamente el archivo main/idf_component.yml.",
},
{
pergunta: "¿Cuál es la diferencia entre usar Component Registry y submódulos git?",
resposta: "El Component Registry elimina la complejidad de gestionar submódulos Git pesados y versiones manuales. Ofrece versionamiento semántico (^ y ~), resolución automática de dependencias transitivas y compilación modular bajo demanda.",
},
{
pergunta: "¿Puedo crear y publicar mis propios componentes?",
resposta: "Sí, cualquier desarrollador o empresa puede publicar componentes públicos o privados en el ESP Component Registry utilizando la herramienta oficial Compote CLI (pip install idf-component-manager).",
},
];
export default async function ComponentesLayout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const faqs = isEn ? faqsEn : faqsPt;
const isEs = locale === "es";
const faqs = isEs ? faqsEs : isEn ? faqsEn : faqsPt;
return (
<>
@@ -88,8 +125,8 @@ export default async function ComponentesLayout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: "ESP Component Registry", caminho: isEn ? "/en/components" : "/componentes" },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEs ? "/es" : isEn ? "/en" : "/" },
{ nome: "ESP Component Registry", caminho: isEs ? "/es/componentes" : isEn ? "/en/components" : "/componentes" },
])
),
}}
@@ -105,11 +142,17 @@ export default async function ComponentesLayout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.aplicacaoWeb({
nome: isEn ? "ESP Component Registry Hub & Manifest Builder" : "Hub do ESP Component Registry & Construtor de Manifesto",
descricao: isEn
nome: isEs
? "Hub de ESP Component Registry & Generador de Manifiesto"
: isEn
? "ESP Component Registry Hub & Manifest Builder"
: "Hub do ESP Component Registry & Construtor de Manifesto",
descricao: isEs
? "Catálogo curado y generador de manifiesto idf_component.yml para componentes modulares de ESP-IDF."
: isEn
? "Curated catalog and idf_component.yml manifest generator for modular ESP-IDF components."
: "Catálogo curado e gerador de manifesto idf_component.yml para componentes modulares do ESP-IDF.",
caminho: isEn ? "/en/components" : "/componentes",
caminho: isEs ? "/es/componentes" : isEn ? "/en/components" : "/componentes",
locale,
})
),
+63 -41
View File
@@ -8,6 +8,7 @@ import PageHero from "@/components/PageHero";
import SectionHead from "@/components/SectionHead";
import * as componentesPt from "@/lib/componentRegistryData";
import * as componentesEn from "@/lib/data/en/componentes";
import * as componentesEs from "@/lib/data/es/componentes";
import {
ArrowUpRight,
Box,
@@ -44,7 +45,8 @@ const ICONES_CATEGORIA = {
export default function ComponentRegistryPage() {
const pathname = usePathname();
const isEn = pathname?.startsWith("/en");
const { CATEGORIAS_COMPONENTES, COMPONENTES_REGISTRY, GUIA_COMPONENT_MANAGER } = isEn ? componentesEn : componentesPt;
const isEs = pathname?.startsWith("/es");
const { CATEGORIAS_COMPONENTES, COMPONENTES_REGISTRY, GUIA_COMPONENT_MANAGER } = isEs ? componentesEs : isEn ? componentesEn : componentesPt;
const [busca, setBusca] = useState("");
const [categoriaAtiva, setCategoriaAtiva] = useState("todos");
@@ -98,19 +100,23 @@ export default function ComponentRegistryPage() {
);
if (selecionados.length === 0) {
return isEn
return isEs
? `# No hay componentes seleccionados.\n# Haga clic en "+ Agregar al manifiesto" en las tarjetas de abajo.`
: isEn
? `# No components selected.\n# Click "+ Add to Manifest" on the cards below.`
: `# Nenhum componente selecionado.\n# Clique em "+ Adicionar ao Manifesto" nos cards abaixo.`;
}
let yaml = isEn
let yaml = isEs
? `# main/idf_component.yml\n# Generado mediante ESPDocs Component Hub (https://espdocs.cienciaembarcada.com.br/es/componentes)\n\ndependencies:\n`
: isEn
? `# main/idf_component.yml\n# Generated via ESPDocs Component Hub (https://espdocs.cienciaembarcada.com.br/en/components)\n\ndependencies:\n`
: `# main/idf_component.yml\n# Gerado via ESPDocs Component Hub (https://espdocs.cienciaembarcada.com.br/componentes)\n\ndependencies:\n`;
selecionados.forEach((c) => {
yaml += ` ${c.namespace}/${c.name}: "${c.versao}"\n`;
});
return yaml;
}, [componentesSelecionados, COMPONENTES_REGISTRY, isEn]);
}, [componentesSelecionados, COMPONENTES_REGISTRY, isEn, isEs]);
const copiarManifesto = () => {
navigator.clipboard.writeText(manifestoYaml);
@@ -145,31 +151,34 @@ export default function ComponentRegistryPage() {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Component Registry" : "Component Registry" }]}
isEs={isEs}
trail={[{ label: isEs ? "Component Registry" : isEn ? "Component Registry" : "Component Registry" }]}
icon={Box}
label="ESP-IDF Component Manager"
title="ESP Component Registry"
lede={
isEn
isEs
? "El catálogo oficial de paquetes reutilizables de Espressif para ESP-IDF. Elija controladores, voz y pilas industriales, copie el comando y genere el manifiesto del proyecto."
: isEn
? "Official Espressif catalog of reusable packages for ESP-IDF. Choose drivers, voice stacks, and industrial protocols, copy commands, and generate project manifests."
: "O catálogo oficial de pacotes reutilizáveis da Espressif para o ESP-IDF. Escolha drivers, voz e pilhas industriais, copie o comando e gere o manifesto do projeto."
}
>
<a href="https://components.espressif.com" target="_blank" rel="noopener noreferrer" className="btn btn-primary">
{isEn ? "Open official registry" : "Abrir o registro oficial"}
{isEs ? "Abrir el registro oficial" : isEn ? "Open official registry" : "Abrir o registro oficial"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
<span className="sr-only"> {isEn ? "(opens in a new tab)" : "(abre em nova aba)"}</span>
<span className="sr-only"> {isEs ? "(abre en una nueva pestaña)" : isEn ? "(opens in a new tab)" : "(abre em nova aba)"}</span>
</a>
<a href="#manifesto-builder" className="btn btn-ghost">
{isEn ? "Generate idf_component.yml" : "Gerar idf_component.yml"}
{isEs ? "Generar idf_component.yml" : isEn ? "Generate idf_component.yml" : "Gerar idf_component.yml"}
</a>
</PageHero>
<section className="shell pt-10 sm:pt-12" aria-label={isEn ? "Search and filters" : "Busca e filtros"}>
<section className="shell pt-10 sm:pt-12" aria-label={isEs ? "Búsqueda y filtros" : isEn ? "Search and filters" : "Busca e filtros"}>
<div className="panel p-5 sm:p-6">
<div className="relative">
<label htmlFor="busca-componente" className="sr-only">
{isEn ? "Search by name, namespace, or tag" : "Buscar por nome, namespace ou tag"}
{isEs ? "Buscar por nombre, namespace o etiqueta" : isEn ? "Search by name, namespace, or tag" : "Buscar por nome, namespace ou tag"}
</label>
<Search className="pointer-events-none absolute left-4 top-1/2 h-5 w-5 -translate-y-1/2 text-muted" aria-hidden="true" />
<input
@@ -177,14 +186,14 @@ export default function ComponentRegistryPage() {
type="search"
value={busca}
onChange={(e) => setBusca(e.target.value)}
placeholder={isEn ? "Search by name, namespace, or tag" : "Buscar por nome, namespace ou tag"}
placeholder={isEs ? "Buscar por nombre, namespace o etiqueta" : isEn ? "Search by name, namespace, or tag" : "Buscar por nome, namespace ou tag"}
autoComplete="off"
className="field pl-12 pr-4 text-base"
/>
</div>
<div className="mt-5">
<h2 className="text-sm font-semibold text-ink">{isEn ? "Category" : "Categoria"}</h2>
<h2 className="text-sm font-semibold text-ink">{isEs ? "Categoría" : isEn ? "Category" : "Categoria"}</h2>
<div className="mt-3 flex flex-wrap gap-2">
{CATEGORIAS_COMPONENTES.map((cat) => {
const Icone = ICONES_CATEGORIA[cat.id] ?? Layers;
@@ -192,7 +201,7 @@ export default function ComponentRegistryPage() {
return (
<button key={cat.id} type="button" onClick={() => setCategoriaAtiva(cat.id)} aria-pressed={categoriaAtiva === cat.id} className="chip-btn">
<Icone className="h-4 w-4" aria-hidden="true" />
{cat.id === "todos" ? (isEn ? "All" : "Todos") : cat.nome.replace(/\s*\(.*\)/, "").split(",")[0].split(" &")[0]}
{cat.id === "todos" ? (isEs ? "Todos" : isEn ? "All" : "Todos") : cat.nome.replace(/\s*\(.*\)/, "").split(",")[0].split(" &")[0]}
<span className="tabular-nums opacity-80">{contagem}</span>
</button>
);
@@ -201,11 +210,11 @@ export default function ComponentRegistryPage() {
</div>
<div className="mt-5 border-t border-line pt-5">
<h2 className="text-sm font-semibold text-ink">{isEn ? "Compatible chip" : "Chip compatível"}</h2>
<h2 className="text-sm font-semibold text-ink">{isEs ? "Chip compatible" : isEn ? "Compatible chip" : "Chip compatível"}</h2>
<div className="mt-3 flex flex-wrap gap-2">
{chipsDisponiveis.map((chip) => (
<button key={chip} type="button" onClick={() => setChipFiltro(chip)} aria-pressed={chipFiltro === chip} className="chip-btn">
{chip === "todos" ? (isEn ? "All" : "Todos") : chip}
{chip === "todos" ? (isEs ? "Todos" : isEn ? "All" : "Todos") : chip}
</button>
))}
</div>
@@ -216,17 +225,17 @@ export default function ComponentRegistryPage() {
<section className="shell section pt-8 sm:pt-10" aria-labelledby="lista-titulo">
<div className="flex flex-wrap items-center justify-between gap-3">
<h2 id="lista-titulo" role="status" aria-live="polite" className="text-base font-semibold text-ink">
{componentesFiltrados.length} {componentesFiltrados.length === 1 ? (isEn ? "component" : "componente") : (isEn ? "components" : "componentes")}
{componentesFiltrados.length} {componentesFiltrados.length === 1 ? (isEs ? "componente" : isEn ? "component" : "componente") : (isEs ? "componentes" : isEn ? "components" : "componentes")}
</h2>
<div className="flex flex-wrap items-center gap-x-5 gap-y-1">
{totalFiltros > 0 && (
<button type="button" onClick={limparFiltros} className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent hover:text-accent-strong">
<X className="h-4 w-4" aria-hidden="true" />
{isEn ? "Clear filters" : "Limpar filtros"}
{isEs ? "Limpiar filtros" : isEn ? "Clear filters" : "Limpar filtros"}
</button>
)}
<a href="#manifesto-builder" className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent hover:text-accent-strong">
{isEn ? "Manifest:" : "Manifesto:"} {componentesSelecionados.length} {componentesSelecionados.length === 1 ? (isEn ? "component" : "componente") : (isEn ? "components" : "componentes")}
{isEs ? "Manifiesto:" : isEn ? "Manifest:" : "Manifesto:"} {componentesSelecionados.length} {componentesSelecionados.length === 1 ? (isEs ? "componente" : isEn ? "component" : "componente") : (isEs ? "componentes" : isEn ? "components" : "componentes")}
</a>
</div>
</div>
@@ -235,13 +244,17 @@ export default function ComponentRegistryPage() {
<div className="card mt-6 px-6 py-14 text-center">
<Box className="mx-auto h-10 w-10 text-muted" aria-hidden="true" />
<h3 className="mt-4 font-display text-xl font-semibold text-ink">
{isEn ? "No components found" : "Nenhum componente encontrado"}
{isEs ? "No se encontraron componentes" : isEn ? "No components found" : "Nenhum componente encontrado"}
</h3>
<p className="mx-auto mt-2 max-w-md text-sm text-muted">
{isEn ? "Search for a more general term or return to all categories." : "Busque por um termo mais geral ou volte para todas as categorias."}
{isEs
? "Busque por un término más general o regrese a todas las categorías."
: isEn
? "Search for a more general term or return to all categories."
: "Busque por um termo mais geral ou volte para todas as categorias."}
</p>
<button type="button" onClick={limparFiltros} className="btn btn-primary mt-6">
{isEn ? "Clear filters" : "Limpar filtros"}
{isEs ? "Limpiar filtros" : isEn ? "Clear filters" : "Limpar filtros"}
</button>
</div>
) : (
@@ -261,7 +274,7 @@ export default function ComponentRegistryPage() {
{comp.oficial && (
<span className="chip chip-accent px-2 py-0">
<ShieldCheck className="h-3 w-3" aria-hidden="true" />
{isEn ? "Official" : "Oficial"}
{isEs ? "Oficial" : isEn ? "Official" : "Oficial"}
</span>
)}
</p>
@@ -285,12 +298,12 @@ export default function ComponentRegistryPage() {
type="button"
onClick={() => copiarComando(comp.id, cliCmd)}
className="code-panel flex w-full min-h-11 items-center justify-between gap-3 rounded-lg px-3 py-2 text-left font-mono text-xs transition-colors hover:border-white/30"
aria-label={isEn ? `Copy command to add ${comp.name}` : `Copiar comando para adicionar ${comp.name}`}
aria-label={isEs ? `Copiar comando para agregar ${comp.name}` : isEn ? `Copy command to add ${comp.name}` : `Copiar comando para adicionar ${comp.name}`}
>
<span className="truncate text-[#e9eef4]">{cliCmd}</span>
{foiCopiado ? <Check className="h-4 w-4 shrink-0 text-[#5fe0a2]" aria-hidden="true" /> : <Copy className="h-4 w-4 shrink-0 text-[#a6afbd]" aria-hidden="true" />}
</button>
<p role="status" className="sr-only">{foiCopiado ? (isEn ? "Command copied" : "Comando copiado") : ""}</p>
<p role="status" className="sr-only">{foiCopiado ? (isEs ? "Comando copiado" : isEn ? "Command copied" : "Comando copiado") : ""}</p>
<p className="mt-3 text-xs text-muted">
<span className="font-medium text-ink-soft">Chips: </span>
@@ -306,14 +319,14 @@ export default function ComponentRegistryPage() {
className={`btn btn-sm ${selecionado ? "btn-primary" : "btn-ghost"}`}
>
{selecionado ? <Check className="h-4 w-4" aria-hidden="true" /> : <Plus className="h-4 w-4" aria-hidden="true" />}
{selecionado ? (isEn ? "In manifest" : "No manifesto") : (isEn ? "Add to manifest" : "Adicionar ao manifesto")}
{selecionado ? (isEs ? "En manifiesto" : isEn ? "In manifest" : "No manifesto") : (isEs ? "Agregar al manifiesto" : isEn ? "Add to manifest" : "Adicionar ao manifesto")}
</button>
<a
href={comp.urlRegistry}
target="_blank"
rel="noopener noreferrer"
className="btn-icon inline-flex h-11 w-11 items-center justify-center rounded-full text-muted transition-colors hover:bg-surface-2 hover:text-accent"
aria-label={isEn ? `Open ${comp.name} in official registry (new tab)` : `Abrir ${comp.name} no registro oficial (nova aba)`}
aria-label={isEs ? `Abrir ${comp.name} en el registro oficial (nueva pestaña)` : isEn ? `Open ${comp.name} in official registry (new tab)` : `Abrir ${comp.name} no registro oficial (nova aba)`}
>
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
@@ -329,12 +342,14 @@ export default function ComponentRegistryPage() {
<div className="panel p-6 sm:p-9">
<div className="flex flex-col justify-between gap-5 md:flex-row md:items-end">
<div className="max-w-2xl">
<p className="eyebrow">{isEn ? "Manifest generator" : "Gerador de manifesto"}</p>
<p className="eyebrow">{isEs ? "Generador de manifiesto" : isEn ? "Manifest generator" : "Gerador de manifesto"}</p>
<h2 id="manifesto-titulo" className="section-title mt-3">
{isEn ? "Your idf_component.yml" : "Seu idf_component.yml"}
{isEs ? "Su idf_component.yml" : isEn ? "Your idf_component.yml" : "Seu idf_component.yml"}
</h2>
<p className="mt-3 text-sm leading-relaxed text-muted">
{isEn ? (
{isEs ? (
<>Guarde el archivo en la carpeta <code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono">main/</code> del proyecto y ESP-IDF descargará todas las bibliotecas durante la compilación.</>
) : isEn ? (
<>Save this file in your project&apos;s <code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono">main/</code> folder and ESP-IDF will download all dependencies during build.</>
) : (
<>Salve o arquivo na pasta <code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono">main/</code> do projeto e o ESP-IDF baixa todas as bibliotecas na compilação.</>
@@ -344,27 +359,27 @@ export default function ComponentRegistryPage() {
<div className="flex flex-wrap items-center gap-2">
<button type="button" onClick={copiarManifesto} className="btn btn-primary btn-sm">
{manifestoCopiado ? <Check className="h-4 w-4" aria-hidden="true" /> : <Copy className="h-4 w-4" aria-hidden="true" />}
<span role="status">{manifestoCopiado ? (isEn ? "Copied" : "Copiado") : (isEn ? "Copy YAML" : "Copiar YAML")}</span>
<span role="status">{manifestoCopiado ? (isEs ? "Copiado" : isEn ? "Copied" : "Copiado") : (isEs ? "Copiar YAML" : isEn ? "Copy YAML" : "Copiar YAML")}</span>
</button>
<button type="button" onClick={baixarManifesto} className="btn btn-ghost btn-sm">
<Download className="h-4 w-4" aria-hidden="true" />
{isEn ? "Download .yml" : "Baixar .yml"}
{isEs ? "Descargar .yml" : isEn ? "Download .yml" : "Baixar .yml"}
</button>
{componentesSelecionados.length > 0 && (
<button type="button" onClick={() => setComponentesSelecionados([])} className="btn btn-ghost btn-sm">
<Trash2 className="h-4 w-4" aria-hidden="true" />
{isEn ? "Clear" : "Limpar"}
{isEs ? "Limpiar" : isEn ? "Clear" : "Limpar"}
</button>
)}
</div>
</div>
<div className="code-panel mt-6">
<pre tabIndex={0} aria-label={isEn ? "Content of idf_component.yml" : "Conteúdo do idf_component.yml"} className="!text-sm"><code className="text-[#e9eef4]">{manifestoYaml}</code></pre>
<pre tabIndex={0} aria-label={isEs ? "Contenido de idf_component.yml" : isEn ? "Content of idf_component.yml" : "Conteúdo do idf_component.yml"} className="!text-sm"><code className="text-[#e9eef4]">{manifestoYaml}</code></pre>
</div>
{componentesSelecionados.length > 0 && (
<ul className="mt-5 flex flex-wrap items-center gap-2" aria-label={isEn ? "Included components" : "Componentes incluídos"}>
<ul className="mt-5 flex flex-wrap items-center gap-2" aria-label={isEs ? "Componentes incluidos" : isEn ? "Included components" : "Componentes incluídos"}>
{componentesSelecionados.map((id) => {
const c = COMPONENTES_REGISTRY.find((item) => item.id === id);
if (!c) return null;
@@ -375,7 +390,7 @@ export default function ComponentRegistryPage() {
type="button"
onClick={() => toggleSelecaoManifesto(id)}
className="-my-2 grid h-11 w-11 place-items-center rounded-full hover:bg-accent/15"
aria-label={isEn ? `Remove ${c.name} from manifest` : `Remover ${c.name} do manifesto`}
aria-label={isEs ? `Eliminar ${c.name} del manifiesto` : isEn ? `Remove ${c.name} from manifest` : `Remover ${c.name} do manifesto`}
>
<X className="h-3.5 w-3.5" aria-hidden="true" />
</button>
@@ -388,7 +403,7 @@ export default function ComponentRegistryPage() {
</section>
<section className="shell section border-t border-line pt-14" aria-labelledby="guia-titulo">
<SectionHead id="guia-titulo" eyebrow={isEn ? "Quick guide" : "Guia rápido"} title={GUIA_COMPONENT_MANAGER.titulo} lede={GUIA_COMPONENT_MANAGER.resumo} />
<SectionHead id="guia-titulo" eyebrow={isEs ? "Guía rápida" : isEn ? "Quick guide" : "Guia rápido"} title={GUIA_COMPONENT_MANAGER.titulo} lede={GUIA_COMPONENT_MANAGER.resumo} />
<ul className="mt-8 grid gap-3 md:grid-cols-2 lg:grid-cols-4">
{GUIA_COMPONENT_MANAGER.vantagens.map((v) => (
@@ -401,7 +416,7 @@ export default function ComponentRegistryPage() {
<h3 className="mt-12 flex items-center gap-2 font-display text-xl font-semibold tracking-[-0.03em] text-ink">
<Terminal className="h-5 w-5 text-accent" aria-hidden="true" />
{isEn ? "Essential commands" : "Comandos essenciais"}
{isEs ? "Comandos esenciales" : isEn ? "Essential commands" : "Comandos essenciais"}
</h3>
<ul className="mt-4 space-y-3">
{GUIA_COMPONENT_MANAGER.comandosCli.map((cmd, i) => (
@@ -416,7 +431,7 @@ export default function ComponentRegistryPage() {
className="inline-flex min-h-11 shrink-0 items-center gap-1.5 self-start rounded-full border border-white/15 px-4 text-sm font-medium text-[#e9eef4] transition-colors hover:bg-white/10 md:self-auto"
>
{copiadoId === `cmd-${i}` ? <Check className="h-4 w-4 text-[#5fe0a2]" aria-hidden="true" /> : <Copy className="h-4 w-4" aria-hidden="true" />}
{copiadoId === `cmd-${i}` ? (isEn ? "Copied" : "Copiado") : (isEn ? "Copy" : "Copiar")}
{copiadoId === `cmd-${i}` ? (isEs ? "Copiado" : isEn ? "Copied" : "Copiado") : (isEs ? "Copiar" : isEn ? "Copy" : "Copiar")}
</button>
</li>
))}
@@ -425,10 +440,17 @@ export default function ComponentRegistryPage() {
<div className="callout mt-8">
<h3 className="flex items-center gap-2 font-semibold text-ink">
<HelpCircle className="h-4 w-4 text-accent" aria-hidden="true" />
{isEn ? "Semantic versioning in ESP-IDF" : "Versionamento semântico no ESP-IDF"}
{isEs ? "Versionamiento semántico en ESP-IDF" : isEn ? "Semantic versioning in ESP-IDF" : "Versionamento semântico no ESP-IDF"}
</h3>
<ul className="mt-2 list-disc space-y-1.5 pl-5">
{isEn ? (
{isEs ? (
<>
<li><code>^1.2.0</code>: acepta actualizaciones menores y correcciones (1.2.1, 1.3.0), pero bloquea cambios importantes de API (2.0.0). <strong>Recomendado.</strong></li>
<li><code>~1.2.0</code>: acepta solo correcciones de errores (1.2.1, 1.2.5).</li>
<li><code>1.2.0</code>: bloquea en esta versión exacta.</li>
<li><code>*</code>: acepta cualquier versión. Evite en producción.</li>
</>
) : isEn ? (
<>
<li><code>^1.2.0</code>: accepts minor updates and bug fixes (1.2.1, 1.3.0), but blocks breaking API changes (2.0.0). <strong>Recommended.</strong></li>
<li><code>~1.2.0</code>: accepts patch releases only (1.2.1, 1.2.5).</li>
+47 -9
View File
@@ -3,16 +3,32 @@ import { paginaMeta, jsonLd } from "@/lib/seo";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return paginaMeta({
titulo: isEn
titulo: isEs
? "Diagnóstico de errores comunes en ESP32: Guía profesional"
: isEn
? "Common ESP32 Errors & Diagnostics: Professional Guide"
: "Diagnóstico de Erros Comuns no ESP32: Guia Profissional",
descricao: isEn
descricao: isEs
? "Guía técnica definitiva para identificar y solucionar Brownout, Guru Meditation, Task Watchdog, Stack Overflow, fugas de memoria y fallas de arranque en ESP32 (Arduino y ESP-IDF)."
: isEn
? "Definitive technical guide to identify and fix Brownout, Guru Meditation, Task Watchdog, Stack Overflow, memory leaks, and boot issues on ESP32 (Arduino & ESP-IDF)."
: "Guia técnico definitivo para identificar e resolver Brownout, Guru Meditation, Task Watchdog, Stack Overflow, vazamento de memória e falhas de boot no ESP32 (Arduino e ESP-IDF).",
caminho: "/diagnostico",
locale,
keywords: isEn
keywords: isEs
? [
"errores comunes ESP32",
"brownout detector was triggered",
"guru meditation error",
"task watchdog got triggered",
"stack canary watchpoint triggered",
"cómo depurar ESP32",
"ESP32 reiniciando en bucle",
"failed to connect to esp32",
]
: isEn
? [
"common ESP32 errors",
"brownout detector was triggered",
@@ -74,10 +90,30 @@ const faqsEn = [
},
];
const faqsEs = [
{
pergunta: "¿Qué causa el error 'Brownout detector was triggered' en el ESP32?",
resposta: "Ocurre cuando la tensión en el pin 3V3 cae por debajo de 2.8V ~ 2.43V debido a picos rápidos de corriente de la radio Wi-Fi/BLE (que superan los 500mA), cables USB delgados o un regulador LDO inadecuado. La solución de ingeniería implica agregar condensadores Low-ESR de 10µF a 100µF cerca de VCC y usar reguladores LDO robustos de más de 600mA.",
},
{
pergunta: "¿Cómo solucionar el 'Guru Meditation Error (LoadProhibited)'?",
resposta: "LoadProhibited indica un intento de acceder a un puntero nulo (NULL) o inválido en la memoria. La solución consiste en utilizar Espressif Exception Decoder o addr2line para localizar la línea exacta en el código e implementar comprobaciones defensivas como if (puntero != NULL).",
},
{
pergunta: "¿Por qué se activa el Task Watchdog Timer (TWDT) en FreeRTOS?",
resposta: "El TWDT se activa cuando una tarea de mayor prioridad monopoliza la CPU en un bucle bloqueante (por ejemplo: while(1) sin vTaskDelay), impidiendo que la tarea IDLE alimente el watchdog del sistema operativo.",
},
{
pergunta: "¿Por qué fallan las conexiones HTTPS y TLS con el código -0x2700 en ESP32?",
resposta: "Porque al encenderse, el reloj interno del ESP32 comienza en el año 1970. El validador de certificados TLS considera inválido el certificado del servidor por estar en el 'futuro'. Sincronizar el reloj mediante SNTP (configTime) antes de la conexión resuelve el problema.",
},
];
export default async function DiagnosticoLayout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const faqs = isEn ? faqsEn : faqsPt;
const isEs = locale === "es";
const faqs = isEs ? faqsEs : isEn ? faqsEn : faqsPt;
return (
<>
@@ -86,8 +122,8 @@ export default async function DiagnosticoLayout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "Diagnostics & Common Errors" : "Diagnóstico & Erros Comuns", caminho: isEn ? "/en/diagnostics" : "/diagnostico" },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEs ? "/es" : isEn ? "/en" : "/" },
{ nome: isEs ? "Diagnóstico y errores comunes" : isEn ? "Diagnostics & Common Errors" : "Diagnóstico & Erros Comuns", caminho: isEs ? "/es/diagnostico" : isEn ? "/en/diagnostics" : "/diagnostico" },
])
),
}}
@@ -105,11 +141,13 @@ export default async function DiagnosticoLayout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.aplicacaoWeb({
nome: isEn ? "ESP32 Error Diagnostics & Debugging Guide" : "Guia de Diagnóstico e Erros no ESP32",
descricao: isEn
nome: isEs ? "Guía de diagnóstico y errores en ESP32" : isEn ? "ESP32 Error Diagnostics & Debugging Guide" : "Guia de Diagnóstico e Erros no ESP32",
descricao: isEs
? "Herramienta y guía técnica de análisis de fallas, pánicos de CPU y decodificación de registros en ESP32."
: isEn
? "Technical guide and log decoder for troubleshooting CPU panics, crashes, and exceptions on ESP32."
: "Ferramenta e guia técnico de análise de falhas, pânicos de CPU e decodificação de logs no ESP32.",
caminho: isEn ? "/en/diagnostics" : "/diagnostico",
caminho: isEs ? "/es/diagnostico" : isEn ? "/en/diagnostics" : "/diagnostico",
locale,
})
),
+90 -43
View File
@@ -7,6 +7,7 @@ import Footer from "@/components/Footer";
import PageHero from "@/components/PageHero";
import * as diagnosticoPt from "@/lib/diagnosticoData";
import * as diagnosticoEn from "@/lib/data/en/diagnostico";
import * as diagnosticoEs from "@/lib/data/es/diagnostico";
import {
Activity,
AlertTriangle,
@@ -49,6 +50,13 @@ const EXEMPLOS_LOG_EN = [
["TLS Handshake", "mbedtls_ssl_handshake returned -0x2700\nThe certificate is not yet valid"],
];
const EXEMPLOS_LOG_ES = [
["Brownout", "Brownout detector was triggered\n\nrst:0xc (SW_CPU_RESET),boot:0x13"],
["LoadProhibited", "Guru Meditation Error: Core 0 panic'ed (LoadProhibited).\nEXCVADDR: 0x00000000"],
["Task watchdog", "Task watchdog got triggered. The following tasks/users did not reset the watchdog: - IDLE0"],
["Handshake TLS", "mbedtls_ssl_handshake returned -0x2700\nThe certificate is not yet valid"],
];
const GRAVIDADE = {
"Crítica": "text-danger",
"Critical": "text-danger",
@@ -56,6 +64,7 @@ const GRAVIDADE = {
High: "text-gold",
"Média": "text-accent",
Medium: "text-accent",
Media: "text-accent",
};
const CHECKLISTS_PT = [
@@ -104,12 +113,36 @@ const CHECKLISTS_EN = [
},
];
const CHECKLISTS_ES = [
{
icon: Zap,
titulo: "Hardware y alimentación",
itens: [
"Condensador de 10 µF a 100 µF de bajo ESR en VCC, más uno cerámico de 100 nF junto al chip.",
"Regulador LDO dimensionado para picos de 600 mA a 1 A, con margen térmico.",
"Ningún periférico forzando niveles lógicos en los pines de strapping durante el arranque.",
"Condensador de 10 µF o 1 µF en el pin EN (RST) para auto-reset estable durante la programación.",
],
},
{
icon: Layers,
titulo: "Firmware y FreeRTOS",
itens: [
"Cada tarea de FreeRTOS cede la CPU con vTaskDelay, colas o semáforos.",
"Cada ISR marcada con IRAM_ATTR y sin llamadas bloqueantes.",
"Sin uso continuo de String de Arduino en bucles para evitar la fragmentación del heap.",
"Hora sincronizada mediante SNTP antes de abrir conexiones TLS/HTTPS.",
],
},
];
export default function DiagnosticoPage() {
const pathname = usePathname();
const isEn = pathname?.startsWith("/en");
const { categoriasDiagnostico, sintomasRapidos, errosCatalogo, regrasDecodificadorLog } = isEn ? diagnosticoEn : diagnosticoPt;
const exemplosLog = isEn ? EXEMPLOS_LOG_EN : EXEMPLOS_LOG_PT;
const checklists = isEn ? CHECKLISTS_EN : CHECKLISTS_PT;
const isEs = pathname?.startsWith("/es");
const { categoriasDiagnostico, sintomasRapidos, errosCatalogo, regrasDecodificadorLog } = isEs ? diagnosticoEs : isEn ? diagnosticoEn : diagnosticoPt;
const exemplosLog = isEs ? EXEMPLOS_LOG_ES : isEn ? EXEMPLOS_LOG_EN : EXEMPLOS_LOG_PT;
const checklists = isEs ? CHECKLISTS_ES : isEn ? CHECKLISTS_EN : CHECKLISTS_PT;
const [termoBusca, setTermoBusca] = useState("");
const [categoriaAtiva, setCategoriaAtiva] = useState("todos");
@@ -139,7 +172,16 @@ export default function DiagnosticoPage() {
}
setResultadoLog(
isEn
isEs
? {
titulo: "Patrón de error no categorizado automáticamente",
tipo: "Desconocido",
explicacao:
"No identificamos una firma clásica de Guru Meditation o Brownout en este fragmento. Verifique que la velocidad de baudios (ej: 115200) sea correcta y si el encabezado 'rst:' o 'panic' está presente.",
acaoRecomendada:
"Busque palabras clave como 'Guru Meditation', 'rst:', 'LoadProhibited', 'watchdog' o 'panic' en la consola serie.",
}
: isEn
? {
titulo: "Error pattern not automatically classified",
tipo: "Unknown",
@@ -213,12 +255,15 @@ export default function DiagnosticoPage() {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Diagnostics" : "Diagnóstico" }]}
isEs={isEs}
trail={[{ label: isEs ? "Diagnóstico" : isEn ? "Diagnostics" : "Diagnóstico" }]}
icon={AlertTriangle}
label={isEn ? "Firmware Debugging" : "Depuração de firmware"}
title={isEn ? "ESP32 Diagnostics and Crash Decoder" : "Diagnóstico de falhas do ESP32"}
label={isEs ? "Depuración de firmware" : isEn ? "Firmware Debugging" : "Depuração de firmware"}
title={isEs ? "Diagnóstico de fallas del ESP32" : isEn ? "ESP32 Diagnostics and Crash Decoder" : "Diagnóstico de falhas do ESP32"}
lede={
isEn
isEs
? "Comprenda la causa raíz de las fallas por Brownout, Guru Meditation, Watchdog y Stack Overflow, y aplique la corrección de ingeniería en lugar de soluciones improvisadas."
: isEn
? "Understand the root cause of Brownout, Guru Meditation, Watchdog, and Stack Overflow crashes, and apply engineering solutions instead of workarounds."
: "Entenda a causa de Brownout, Guru Meditation, Watchdog e Stack Overflow, e aplique a correção de engenharia, não o remendo."
}
@@ -229,9 +274,9 @@ export default function DiagnosticoPage() {
rel="noopener noreferrer"
className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent hover:text-accent-strong"
>
{isEn ? "Based on article by Ciência Embarcada" : "Baseado no artigo do Ciência Embarcada"}
{isEs ? "Basado en el artículo de Ciência Embarcada" : isEn ? "Based on article by Ciência Embarcada" : "Baseado no artigo do Ciência Embarcada"}
<ExternalLink className="h-4 w-4" aria-hidden="true" />
<span className="sr-only"> {isEn ? "(opens in a new tab)" : "(abre em nova aba)"}</span>
<span className="sr-only"> {isEs ? "(abre en una nueva pestaña)" : isEn ? "(opens in a new tab)" : "(abre em nova aba)"}</span>
</a>
</PageHero>
@@ -240,14 +285,14 @@ export default function DiagnosticoPage() {
<div className="flex flex-col justify-between gap-4 md:flex-row md:items-end">
<div className="max-w-xl">
<h2 id="decodificador-titulo" className="section-title">
{isEn ? "Paste the log to see the cause" : "Cole o log e veja a causa"}
{isEs ? "Pegue el registro y descubra la causa" : isEn ? "Paste the log to see the cause" : "Cole o log e veja a causa"}
</h2>
<p className="mt-2 text-sm text-muted">
{isEn ? "Copy the serial monitor output snippet. Diagnostics appear instantly." : "Copie o trecho do monitor serial. O diagnóstico aparece na hora."}
{isEs ? "Copie el fragmento del monitor serie. El diagnóstico aparece al instante." : isEn ? "Copy the serial monitor output snippet. Diagnostics appear instantly." : "Copie o trecho do monitor serial. O diagnóstico aparece na hora."}
</p>
</div>
<div className="flex flex-wrap items-center gap-2">
<span className="text-sm text-muted">{isEn ? "Test with" : "Testar com"}</span>
<span className="text-sm text-muted">{isEs ? "Probar con" : isEn ? "Test with" : "Testar com"}</span>
{exemplosLog.map(([rotulo, texto]) => (
<button key={rotulo} type="button" onClick={() => analisarLog(texto)} className="chip-btn">
{rotulo}
@@ -258,21 +303,21 @@ export default function DiagnosticoPage() {
<div className="relative mt-5">
<label htmlFor="log-serial" className="sr-only">
{isEn ? "Serial monitor log" : "Log do monitor serial"}
{isEs ? "Registro del monitor serie" : isEn ? "Serial monitor log" : "Log do monitor serial"}
</label>
<textarea
id="log-serial"
rows={4}
value={logInput}
onChange={(e) => analisarLog(e.target.value)}
placeholder={isEn ? "Paste serial monitor log here" : "Cole o log do monitor serial aqui"}
placeholder={isEs ? "Pegue el registro del monitor serie aquí" : isEn ? "Paste serial monitor log here" : "Cole o log do monitor serial aqui"}
spellCheck={false}
className="code-panel field !min-h-32 w-full resize-y !rounded-xl !border-white/10 !bg-[var(--code-bg)] p-4 font-mono text-sm !text-[#e9eef4] placeholder:!text-[#a6afbd]"
/>
{logInput && (
<button type="button" onClick={() => analisarLog("")} className="absolute right-3 top-3 inline-flex min-h-11 items-center gap-1 rounded-full border border-white/15 px-3 text-xs font-medium text-[#e9eef4] hover:bg-white/10">
<X className="h-3.5 w-3.5" aria-hidden="true" />
{isEn ? "Clear" : "Limpar"}
{isEs ? "Limpiar" : isEn ? "Clear" : "Limpar"}
</button>
)}
</div>
@@ -286,8 +331,8 @@ export default function DiagnosticoPage() {
<h3 className="font-semibold text-ink">{resultadoLog.titulo}</h3>
<span className="chip">{resultadoLog.tipo}</span>
</div>
<p><strong className="font-semibold text-ink">{isEn ? "Likely cause:" : "Causa provável:"}</strong> {resultadoLog.explicacao}</p>
<p><strong className="font-semibold text-ink">{isEn ? "What to do:" : "O que fazer:"}</strong> {resultadoLog.acaoRecomendada}</p>
<p><strong className="font-semibold text-ink">{isEs ? "Causa probable:" : isEn ? "Likely cause:" : "Causa provável:"}</strong> {resultadoLog.explicacao}</p>
<p><strong className="font-semibold text-ink">{isEs ? "Qué hacer:" : isEn ? "What to do:" : "O que fazer:"}</strong> {resultadoLog.acaoRecomendada}</p>
</div>
</div>
)}
@@ -297,13 +342,13 @@ export default function DiagnosticoPage() {
<section className="shell section pt-12 sm:pt-14" aria-labelledby="catalogo-titulo">
<h2 id="catalogo-titulo" className="section-title">
{isEn ? "Fault catalog" : "Catálogo de falhas"}
{isEs ? "Catálogo de fallas" : isEn ? "Fault catalog" : "Catálogo de falhas"}
</h2>
<div className="panel mt-6 p-5 sm:p-6">
<div className="relative">
<label htmlFor="busca-erro" className="sr-only">
{isEn ? "Search by error, symptom, or serial message" : "Buscar por erro, sintoma ou mensagem serial"}
{isEs ? "Buscar por error, síntoma o mensaje serie" : isEn ? "Search by error, symptom, or serial message" : "Buscar por erro, sintoma ou mensagem serial"}
</label>
<Search className="pointer-events-none absolute left-4 top-1/2 h-5 w-5 -translate-y-1/2 text-muted" aria-hidden="true" />
<input
@@ -312,14 +357,14 @@ export default function DiagnosticoPage() {
type="search"
value={termoBusca}
onChange={(e) => setTermoBusca(e.target.value)}
placeholder={isEn ? "Search error, symptom, or message" : "Buscar erro, sintoma ou mensagem"}
placeholder={isEs ? "Buscar error, síntoma o mensaje" : isEn ? "Search error, symptom, or message" : "Buscar erro, sintoma ou mensagem"}
autoComplete="off"
className="field pl-12 pr-4 text-base"
/>
</div>
<div className="mt-5">
<h3 className="text-sm font-semibold text-ink">{isEn ? "Symptom" : "Sintoma"}</h3>
<h3 className="text-sm font-semibold text-ink">{isEs ? "Síntoma" : isEn ? "Symptom" : "Sintoma"}</h3>
<div className="mt-3 flex flex-wrap gap-2">
{sintomasRapidos.map((sintoma) => (
<button key={sintoma.id} type="button" onClick={() => setSintomaAtivo(sintomaAtivo === sintoma.id ? null : sintoma.id)} aria-pressed={sintomaAtivo === sintoma.id} className="chip-btn">
@@ -330,11 +375,11 @@ export default function DiagnosticoPage() {
</div>
<div className="mt-5 border-t border-line pt-5">
<h3 className="text-sm font-semibold text-ink">{isEn ? "Area" : "Área"}</h3>
<h3 className="text-sm font-semibold text-ink">{isEs ? "Área" : isEn ? "Area" : "Área"}</h3>
<div className="mt-3 flex flex-wrap gap-2">
<button type="button" onClick={() => setCategoriaAtiva("todos")} aria-pressed={categoriaAtiva === "todos"} className="chip-btn">
<LayoutGrid className="h-4 w-4" aria-hidden="true" />
{isEn ? "All" : "Todas"}
{isEs ? "Todas" : isEn ? "All" : "Todas"}
<span className="tabular-nums opacity-80">{errosCatalogo.length}</span>
</button>
{categoriasDiagnostico.map((cat) => {
@@ -354,13 +399,13 @@ export default function DiagnosticoPage() {
<div className="mt-6 flex flex-wrap items-center justify-between gap-3">
<p role="status" aria-live="polite" className="text-sm font-semibold text-ink">
{errosFiltrados.length} {errosFiltrados.length === 1 ? (isEn ? "fault" : "falha") : (isEn ? "faults" : "falhas")}
{totalFiltros > 0 && <span className="font-normal text-muted">{isEn ? " with current filters" : " com os filtros atuais"}</span>}
{errosFiltrados.length} {errosFiltrados.length === 1 ? (isEs ? "falla" : isEn ? "fault" : "falha") : (isEs ? "fallas" : isEn ? "faults" : "falhas")}
{totalFiltros > 0 && <span className="font-normal text-muted">{isEs ? " con los filtros actuales" : isEn ? " with current filters" : " com os filtros atuais"}</span>}
</p>
{temFiltroAtivo && (
<button type="button" onClick={limparTodosFiltros} className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent hover:text-accent-strong">
<RotateCcw className="h-4 w-4" aria-hidden="true" />
{isEn ? "Reset filters" : "Redefinir filtros"}
{isEs ? "Restablecer filtros" : isEn ? "Reset filters" : "Redefinir filtros"}
</button>
)}
</div>
@@ -370,13 +415,13 @@ export default function DiagnosticoPage() {
<div className="card px-6 py-14 text-center">
<HelpCircle className="mx-auto h-10 w-10 text-muted" aria-hidden="true" />
<h3 className="mt-4 font-display text-xl font-semibold text-ink">
{isEn ? "No faults matching these filters" : "Nenhuma falha com esses filtros"}
{isEs ? "Ninguna falla coincide con estos filtros" : isEn ? "No faults matching these filters" : "Nenhuma falha com esses filtros"}
</h3>
<p className="mx-auto mt-2 max-w-md text-sm text-muted">
{isEn ? "Search for a more general term or remove selected symptom and area." : "Busque por um termo mais geral ou remova o sintoma e a área selecionados."}
{isEs ? "Busque por un término más general o elimine el síntoma y el área seleccionados." : isEn ? "Search for a more general term or remove selected symptom and area." : "Busque por um termo mais geral ou remova o sintoma e a área selecionados."}
</p>
<button type="button" onClick={limparTodosFiltros} className="btn btn-primary mt-6">
{isEn ? "Clear filters" : "Limpar filtros"}
{isEs ? "Limpiar filtros" : isEn ? "Clear filters" : "Limpar filtros"}
</button>
</div>
) : (
@@ -384,7 +429,7 @@ export default function DiagnosticoPage() {
const estaAberto = cardAberto === erro.id;
const lang = linguagemCodigo[erro.id] || "arduino";
const codigoAtual =
lang === "arduino" ? erro.codigoArduino : lang === "espidf" ? erro.codigoEspIdf : erro.codigoMicroPython || (isEn ? "# Example not applicable" : "# Exemplo não aplicável");
lang === "arduino" ? erro.codigoArduino : lang === "espidf" ? erro.codigoEspIdf : erro.codigoMicroPython || (isEs ? "# Ejemplo no aplicable" : isEn ? "# Example not applicable" : "# Exemplo não aplicável");
const catInfo = categoriasDiagnostico.find((c) => c.id === erro.categoria);
const IconeCat = ICONES[catInfo?.icone] ?? AlertTriangle;
@@ -405,7 +450,9 @@ export default function DiagnosticoPage() {
{catInfo?.nome}
</span>
<span className={`chip ${GRAVIDADE[erro.gravidade] ?? "text-accent"}`}>
{isEn ? (
{isEs ? (
<>Severidad {erro.gravidade.toLowerCase()}</>
) : isEn ? (
<>Severity: {erro.gravidade.toLowerCase()}</>
) : (
<>Gravidade {erro.gravidade.toLowerCase()}</>
@@ -427,11 +474,11 @@ export default function DiagnosticoPage() {
<div className="flex items-center justify-between gap-3">
<h4 className="flex items-center gap-2 text-sm font-semibold text-ink">
<Terminal className="h-4 w-4 text-accent" aria-hidden="true" />
{isEn ? "How it appears in serial monitor" : "Como aparece no monitor serial"}
{isEs ? "Cómo aparece en el monitor serie" : isEn ? "How it appears in serial monitor" : "Como aparece no monitor serial"}
</h4>
<button type="button" onClick={() => copiarParaClipboard(erro.logSerial, `log-${erro.id}`)} className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent hover:text-accent-strong">
{copiadoId === `log-${erro.id}` ? <Check className="h-4 w-4 text-ok" aria-hidden="true" /> : <Copy className="h-4 w-4" aria-hidden="true" />}
{copiadoId === `log-${erro.id}` ? (isEn ? "Copied" : "Copiado") : (isEn ? "Copy log" : "Copiar log")}
{copiadoId === `log-${erro.id}` ? (isEs ? "Copiado" : isEn ? "Copied" : "Copiado") : (isEs ? "Copiar registro" : isEn ? "Copy log" : "Copiar log")}
</button>
</div>
<div className="code-panel mt-1">
@@ -442,7 +489,7 @@ export default function DiagnosticoPage() {
<div>
<h4 className="flex items-center gap-2 text-sm font-semibold text-ink">
<Cpu className="h-4 w-4 text-accent" aria-hidden="true" />
{isEn ? "Root cause" : "Causa raiz"}
{isEs ? "Causa raíz" : isEn ? "Root cause" : "Causa raiz"}
</h4>
<p className="callout mt-2">{erro.causaRaiz}</p>
</div>
@@ -451,17 +498,17 @@ export default function DiagnosticoPage() {
<div className="callout callout-danger">
<p className="flex items-center gap-2 font-semibold text-ink">
<XCircle className="h-4 w-4 shrink-0 text-danger" aria-hidden="true" />
{isEn ? "The common workaround" : "O remendo comum"}
{isEs ? "La solución improvisada común" : isEn ? "The common workaround" : "O remendo comum"}
</p>
<p className="mt-2 font-medium text-ink">{erro.gambiarra.titulo}</p>
<p className="mt-1">{erro.gambiarra.descricao}</p>
<p className="mt-2"><strong className="font-semibold text-danger">{isEn ? "Consequence:" : "Consequência:"}</strong> {erro.gambiarra.consequencia}</p>
<p className="mt-2"><strong className="font-semibold text-danger">{isEs ? "Consecuencia:" : isEn ? "Consequence:" : "Consequência:"}</strong> {erro.gambiarra.consequencia}</p>
</div>
<div className="callout callout-ok">
<p className="flex items-center gap-2 font-semibold text-ink">
<CheckCircle2 className="h-4 w-4 shrink-0 text-ok" aria-hidden="true" />
{isEn ? "The engineering solution" : "A solução de engenharia"}
{isEs ? "La solución de ingeniería" : isEn ? "The engineering solution" : "A solução de engenharia"}
</p>
<p className="mt-2 font-medium text-ink">{erro.solucaoEngenharia.titulo}</p>
<ul className="mt-2 space-y-1.5">
@@ -477,7 +524,7 @@ export default function DiagnosticoPage() {
<div>
<div className="flex flex-wrap items-center justify-between gap-3">
<div role="group" aria-label={isEn ? "Example language" : "Linguagem do exemplo"} className="flex flex-wrap gap-2">
<div role="group" aria-label={isEs ? "Lenguaje del ejemplo" : isEn ? "Example language" : "Linguagem do exemplo"} className="flex flex-wrap gap-2">
{[
["arduino", "Arduino C++"],
["espidf", "ESP-IDF (C)"],
@@ -490,7 +537,7 @@ export default function DiagnosticoPage() {
</div>
<button type="button" onClick={() => copiarParaClipboard(codigoAtual, `code-${erro.id}`)} className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent hover:text-accent-strong">
{copiadoId === `code-${erro.id}` ? <Check className="h-4 w-4 text-ok" aria-hidden="true" /> : <Copy className="h-4 w-4" aria-hidden="true" />}
{copiadoId === `code-${erro.id}` ? (isEn ? "Copied" : "Copiado") : (isEn ? "Copy code" : "Copiar código")}
{copiadoId === `code-${erro.id}` ? (isEs ? "Copiado" : isEn ? "Copied" : "Copiado") : (isEs ? "Copiar código" : isEn ? "Copy code" : "Copiar código")}
</button>
</div>
<div className="code-panel mt-3">
@@ -500,7 +547,7 @@ export default function DiagnosticoPage() {
<div className="callout callout-warn flex items-start gap-3">
<Wrench className="mt-0.5 h-4 w-4 shrink-0 text-gold" aria-hidden="true" />
<p><strong className="font-semibold text-ink">{isEn ? "Engineering tip:" : "Dica de engenharia:"}</strong> {erro.dicaPro}</p>
<p><strong className="font-semibold text-ink">{isEs ? "Consejo de ingeniería:" : isEn ? "Engineering tip:" : "Dica de engenharia:"}</strong> {erro.dicaPro}</p>
</div>
</div>
)}
@@ -513,10 +560,10 @@ export default function DiagnosticoPage() {
<section className="shell pb-20 md:pb-28" aria-labelledby="checklist-titulo">
<h2 id="checklist-titulo" className="section-title">
{isEn ? "Pre-deployment checklist" : "Checklist antes de ir para campo"}
{isEs ? "Lista de verificación previa a campo" : isEn ? "Pre-deployment checklist" : "Checklist antes de ir para campo"}
</h2>
<p className="mt-3 max-w-2xl text-base text-muted">
{isEn ? "Essential items to validate on hardware and firmware before shipping a product." : "Itens essenciais para validar no hardware e no firmware antes de entregar o produto."}
{isEs ? "Elementos esenciales para validar en hardware y firmware antes de entregar el producto." : isEn ? "Essential items to validate on hardware and firmware before shipping a product." : "Itens essenciais para validar no hardware e no firmware antes de entregar o produto."}
</p>
<div className="mt-8 grid gap-4 md:grid-cols-2">
{checklists.map(({ icon: Icon, titulo, itens }) => (
+43 -25
View File
@@ -7,14 +7,16 @@ import { notFound } from "next/navigation";
import CodeExample from "@/components/CodeExample";
import frameworksDataPt from "@/public/frameworks.json";
import frameworksDataEn from "@/data/en/frameworks.json";
import frameworksDataEs from "@/data/es/frameworks.json";
import { getLocalizedHref } from "@/i18n/links";
import { ArrowRight, ArrowUpRight, BookOpen, Box, Check, Code, Layers } from "lucide-react";
export default async function FrameworkDetail({ params }) {
const { locale, key } = await params;
const isEn = locale === "en";
const currentLocale = isEn ? "en" : "pt";
const frameworksData = isEn ? frameworksDataEn : frameworksDataPt;
const isEs = locale === "es";
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const frameworksData = isEs ? frameworksDataEs : isEn ? frameworksDataEn : frameworksDataPt;
const framework = frameworksData[key];
if (!framework) {
@@ -36,8 +38,8 @@ export default async function FrameworkDetail({ params }) {
type="application/ld+json"
dangerouslySetInnerHTML={{
__html: JSON.stringify(jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "Frameworks" : "Frameworks", caminho: getLocalizedHref("/frameworks", currentLocale) },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEs ? "/es" : isEn ? "/en" : "/" },
{ nome: "Frameworks", caminho: getLocalizedHref("/frameworks", currentLocale) },
{ nome: framework.nome, caminho: getLocalizedHref(`/frameworks/${encodeURIComponent(key)}`, currentLocale) },
])),
}}
@@ -48,7 +50,8 @@ export default async function FrameworkDetail({ params }) {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Frameworks & SDKs" : "Frameworks e SDKs", href: getLocalizedHref("/frameworks", currentLocale) }, { label: framework.nome }]}
isEs={isEs}
trail={[{ label: isEs ? "Frameworks y SDKs" : isEn ? "Frameworks & SDKs" : "Frameworks e SDKs", href: getLocalizedHref("/frameworks", currentLocale) }, { label: framework.nome }]}
icon={Layers}
label={framework.tipo}
title={framework.nome}
@@ -57,41 +60,41 @@ export default async function FrameworkDetail({ params }) {
{framework.documentacao && (
<a href={framework.documentacao} target="_blank" rel="noopener noreferrer" className="btn btn-primary">
<BookOpen className="h-4 w-4" aria-hidden="true" />
{isEn ? "Official documentation" : "Documentação oficial"}
{isEs ? "Documentación oficial" : isEn ? "Official documentation" : "Documentação oficial"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
)}
{framework.repositorio && (
<a href={framework.repositorio} target="_blank" rel="noopener noreferrer" className="btn btn-ghost">
<Code className="h-4 w-4" aria-hidden="true" />
{isEn ? "GitHub repository" : "Repositório no GitHub"}
{isEs ? "Repositorio en GitHub" : isEn ? "GitHub repository" : "Repositório no GitHub"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
)}
</PageHero>
<section className="shell mt-10" aria-label={isEn ? "Summary" : "Resumo"}>
<section className="shell mt-10" aria-label={isEs ? "Resumen" : isEn ? "Summary" : "Resumo"}>
<dl className="grid gap-3 md:grid-cols-3">
<div className="tile">
<dt className="text-xs font-medium text-muted">{isEn ? "Language" : "Linguagem"}</dt>
<dt className="text-xs font-medium text-muted">{isEs ? "Lenguaje" : isEn ? "Language" : "Linguagem"}</dt>
<dd className="mt-1 font-display text-2xl font-semibold tracking-[-0.03em] text-ink">{framework.linguagem}</dd>
<dd className="mt-0.5 text-xs text-muted">{framework.nome_completo}</dd>
</div>
<div className="tile">
<dt className="text-xs font-medium text-muted">{isEn ? "Category" : "Categoria"}</dt>
<dt className="text-xs font-medium text-muted">{isEs ? "Categoría" : isEn ? "Category" : "Categoria"}</dt>
<dd className="mt-1 font-display text-2xl font-semibold tracking-[-0.03em] text-ink">{framework.tipo}</dd>
</div>
<div className="tile">
<dt className="text-xs font-medium text-muted">{isEn ? "Main purpose" : "Objetivo principal"}</dt>
<dt className="text-xs font-medium text-muted">{isEs ? "Objetivo principal" : isEn ? "Main purpose" : "Objetivo principal"}</dt>
<dd className="mt-1 text-sm font-medium leading-relaxed text-ink">{framework.funcao_principal}</dd>
</div>
</dl>
</section>
<section className="shell mt-12 grid gap-5 lg:grid-cols-2" aria-label={isEn ? "Features and applications" : "Recursos e aplicações"}>
<section className="shell mt-12 grid gap-5 lg:grid-cols-2" aria-label={isEs ? "Funciones y aplicaciones" : isEn ? "Features and applications" : "Recursos e aplicações"}>
<div className="card p-5 sm:p-7">
<h2 className="font-display text-xl font-semibold tracking-[-0.03em] text-ink">
{isEn ? "Key features" : "Recursos de destaque"}
{isEs ? "Funciones destacadas" : isEn ? "Key features" : "Recursos de destaque"}
</h2>
<ul className="mt-5 space-y-3">
{features.map((feature) => (
@@ -105,7 +108,7 @@ export default async function FrameworkDetail({ params }) {
<div className="card p-5 sm:p-7">
<h2 className="font-display text-xl font-semibold tracking-[-0.03em] text-ink">
{isEn ? "When to use" : "Quando usar"}
{isEs ? "Cuándo usar" : isEn ? "When to use" : "Quando usar"}
</h2>
<ul className="mt-5 space-y-2.5">
{useCases.map((useCase) => (
@@ -123,13 +126,19 @@ export default async function FrameworkDetail({ params }) {
<div className="max-w-2xl">
<span className="chip chip-accent">
<Box className="h-3.5 w-3.5" aria-hidden="true" />
{isEn ? "ESP-IDF 4.4 or higher" : "ESP-IDF 4.4 ou superior"}
{isEs ? "ESP-IDF 4.4 o superior" : isEn ? "ESP-IDF 4.4 or higher" : "ESP-IDF 4.4 ou superior"}
</span>
<h2 className="section-title mt-4">
{isEn ? "Modules with the ESP Component Registry" : "Módulos com o ESP Component Registry"}
{isEs ? "Módulos con ESP Component Registry" : isEn ? "Modules with the ESP Component Registry" : "Módulos com o ESP Component Registry"}
</h2>
<p className="mt-3 text-base leading-relaxed text-muted">
{isEn ? (
{isEs ? (
<>
En los proyectos ESP-IDF v4.4+ y v5.x, las bibliotecas ya no necesitan agregarse como submódulos Git. Utilice el{" "}
<code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono text-sm">idf_component.yml</code> y el comando{" "}
<code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono text-sm">idf.py add-dependency</code> para descargar controladores de pantalla (LVGL), pilas industriales (Modbus), RainMaker y más.
</>
) : isEn ? (
<>
In ESP-IDF v4.4+ and v5.x projects, libraries no longer need to be added as Git submodules. Use{" "}
<code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono text-sm">idf_component.yml</code> and the command{" "}
@@ -145,7 +154,7 @@ export default async function FrameworkDetail({ params }) {
</p>
</div>
<Link href={getLocalizedHref("/componentes", currentLocale)} className="btn btn-primary shrink-0">
{isEn ? "Explore components" : "Explorar componentes"}
{isEs ? "Explorar componentes" : isEn ? "Explore components" : "Explorar componentes"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
@@ -161,7 +170,7 @@ export default async function FrameworkDetail({ params }) {
<div className="shell section pt-10">
<Link href={getLocalizedHref("/frameworks", currentLocale)} className="inline-flex min-h-11 items-center gap-2 text-sm font-medium text-accent hover:text-accent-strong">
<ArrowRight className="h-4 w-4 rotate-180" aria-hidden="true" />
{isEn ? "View all frameworks" : "Ver todos os frameworks"}
{isEs ? "Ver todos los frameworks" : isEn ? "View all frameworks" : "Ver todos os frameworks"}
</Link>
</div>
</main>
@@ -174,24 +183,33 @@ export default async function FrameworkDetail({ params }) {
export async function generateMetadata({ params }) {
const { locale, key } = await params;
const isEn = locale === "en";
const currentLocale = isEn ? "en" : "pt";
const frameworksData = isEn ? frameworksDataEn : frameworksDataPt;
const isEs = locale === "es";
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const frameworksData = isEs ? frameworksDataEs : isEn ? frameworksDataEn : frameworksDataPt;
const framework = frameworksData[key];
if (!framework) {
return { title: isEn ? "Framework not found" : "Framework não encontrado", robots: { index: false, follow: false } };
return { title: isEs ? "Framework no encontrado" : isEn ? "Framework not found" : "Framework não encontrado", robots: { index: false, follow: false } };
}
return {
...paginaMeta({
titulo: isEn ? `${framework.nome} for ESP32 · Technical Guide` : `${framework.nome} para ESP32 · Guia Técnico`,
descricao: isEn
titulo: isEs ? `${framework.nome} para ESP32 · Guía técnica` : isEn ? `${framework.nome} for ESP32 · Technical Guide` : `${framework.nome} para ESP32 · Guia Técnico`,
descricao: isEs
? `${framework.nome_completo}: ${framework.descricao} Guía con ejemplos prácticos de código y casos de uso.`
: isEn
? `${framework.nome_completo}: ${framework.descricao} Guide with practical code examples and use cases.`
: `${framework.nome_completo}: ${framework.descricao} Guia com exemplos práticos de código e casos de uso.`,
caminho: `/frameworks/${encodeURIComponent(key)}`,
tipo: "article",
locale: currentLocale,
keywords: isEn
keywords: isEs
? [
framework.nome, framework.nome_completo,
`${framework.nome} ESP32`, `programar ESP32 con ${framework.nome}`,
"ESP32", "framework ESP32",
]
: isEn
? [
framework.nome, framework.nome_completo,
`${framework.nome} ESP32`, `program ESP32 with ${framework.nome}`,
+26 -6
View File
@@ -3,17 +3,36 @@ import { paginaMeta, jsonLd } from "@/lib/seo";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return {
...paginaMeta({
titulo: isEn
titulo: isEs
? "Frameworks y SDKs para ESP32: Guía completa y comparativa"
: isEn
? "ESP32 Frameworks & SDKs: Complete Guide and Comparison"
: "Frameworks & SDKs para ESP32: Guia Completo e Comparativo",
descricao: isEn
descricao: isEs
? "Guía completa de desarrollo: ESP-IDF, ESP-RainMaker, ESP-Matter, Rust, ESP-ADF, ESP-SR, ESP-WHO, Arduino y MicroPython con ejemplos de código."
: isEn
? "Complete development guide: ESP-IDF, ESP-RainMaker, ESP-Matter, Rust, ESP-ADF, ESP-SR, ESP-WHO, Arduino, and MicroPython with code examples."
: "Guia completo de desenvolvimento: ESP-IDF, ESP-RainMaker, ESP-Matter, Rust, ESP-ADF, ESP-SR, ESP-WHO, Arduino e MicroPython com exemplos de código.",
caminho: "/frameworks",
locale: isEn ? "en" : "pt",
keywords: isEn
locale,
keywords: isEs
? [
"ESP-IDF",
"ESP-RainMaker",
"ESP-Matter",
"Rust ESP32",
"ESP-SR",
"ESP-ADF",
"ESP-IoT-Solution",
"Arduino ESP32",
"MicroPython ESP32",
"frameworks ESP32",
"programar ESP32",
]
: isEn
? [
"ESP-IDF",
"ESP-RainMaker",
@@ -47,6 +66,7 @@ export async function generateMetadata({ params }) {
export default async function FrameworksLayout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return (
<>
<script
@@ -54,8 +74,8 @@ export default async function FrameworksLayout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: "Frameworks", caminho: isEn ? "/en/frameworks" : "/frameworks" },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEs ? "/es" : isEn ? "/en" : "/" },
{ nome: "Frameworks", caminho: isEs ? "/es/frameworks" : isEn ? "/en/frameworks" : "/frameworks" },
])
),
}}
+58 -15
View File
@@ -5,6 +5,7 @@ import SectionHead from "@/components/SectionHead";
import Link from "next/link";
import frameworksDataPt from "@/public/frameworks.json";
import frameworksDataEn from "@/data/en/frameworks.json";
import frameworksDataEs from "@/data/es/frameworks.json";
import { paginaMeta } from "@/lib/seo";
import { getLocalizedHref } from "@/i18n/links";
import { ArrowRight, ArrowUpRight, Box, Brain, Cloud, GraduationCap, Layers, Mic, Music, Sparkles } from "lucide-react";
@@ -75,13 +76,47 @@ const GUIAS_EN = [
},
];
const GUIAS_ES = [
{
icon: GraduationCap,
titulo: "Estoy comenzando",
texto: "Arduino o MicroPython son los caminos más rápidos para probar sensores y APIs. Para producto, elija ESP-IDF o Rust.",
links: [
["Arduino", "/frameworks/Arduino"],
["MicroPython", "/frameworks/MicroPython"],
["Rust", "/frameworks/Rust-ESP"],
],
},
{
icon: Cloud,
titulo: "Nube y hogar conectado",
texto: "ESP-Matter para interoperabilidad, ESP-RainMaker para nube lista y Zigbee para redes locales de bajo consumo.",
links: [
["RainMaker", "/frameworks/ESP-RainMaker"],
["Matter", "/frameworks/ESP-Matter"],
["Zigbee", "/frameworks/ESP-Zigbee-SDK"],
],
},
{
icon: Sparkles,
titulo: "Audio, voz e IA",
texto: "ESP-ADF para procesamiento de audio, ESP-SR para reconocimiento de voz offline y ESP-NN para acelerar TinyML.",
links: [
["Audio", "/frameworks/ESP-ADF", Music],
["Voz", "/frameworks/ESP-SR", Mic],
["IA", "/frameworks/ESP-NN", Brain],
],
},
];
export default async function Frameworks({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const currentLocale = isEn ? "en" : "pt";
const frameworksData = isEn ? frameworksDataEn : frameworksDataPt;
const isEs = locale === "es";
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const frameworksData = isEs ? frameworksDataEs : isEn ? frameworksDataEn : frameworksDataPt;
const frameworks = Object.entries(frameworksData);
const guias = isEn ? GUIAS_EN : GUIAS_PT;
const guias = isEs ? GUIAS_ES : isEn ? GUIAS_EN : GUIAS_PT;
return (
<div className="site-canvas min-h-screen">
@@ -90,18 +125,21 @@ export default async function Frameworks({ params }) {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Frameworks & SDKs" : "Frameworks e SDKs" }]}
isEs={isEs}
trail={[{ label: isEs ? "Frameworks y SDKs" : isEn ? "Frameworks & SDKs" : "Frameworks e SDKs" }]}
icon={Layers}
label={isEn ? `${frameworks.length} frameworks and SDKs` : `${frameworks.length} frameworks e SDKs`}
title={isEn ? "ESP32 Frameworks and SDKs" : "Frameworks e SDKs do ESP32"}
label={isEs ? `${frameworks.length} frameworks y SDKs` : isEn ? `${frameworks.length} frameworks and SDKs` : `${frameworks.length} frameworks e SDKs`}
title={isEs ? "Frameworks y SDKs de ESP32" : isEn ? "ESP32 Frameworks and SDKs" : "Frameworks e SDKs do ESP32"}
lede={
isEn
isEs
? "Desde C/C++ nativo con FreeRTOS hasta Rust, nube IoT, reconocimiento de voz, audio y Matter. Elija según lo que desee construir."
: isEn
? "From native C/C++ with FreeRTOS to Rust, IoT cloud, speech recognition, audio, and Matter. Choose by what you want to build."
: "Do C/C++ nativo com FreeRTOS ao Rust, passando por nuvem IoT, reconhecimento de voz, áudio e Matter. Escolha pelo que você quer construir."
}
/>
<section className="shell pt-10 sm:pt-12" aria-label={isEn ? "Where to begin" : "Por onde começar"}>
<section className="shell pt-10 sm:pt-12" aria-label={isEs ? "Por dónde empezar" : isEn ? "Where to begin" : "Por onde começar"}>
<div className="grid gap-4 md:grid-cols-3">
{guias.map(({ icon: Icon, titulo, texto, links }) => (
<div key={titulo} className="card flex flex-col p-5 sm:p-6">
@@ -130,11 +168,16 @@ export default async function Frameworks({ params }) {
<div className="max-w-2xl">
<span className="chip chip-accent">
<Box className="h-3.5 w-3.5" aria-hidden="true" />
{isEn ? "Modular architecture" : "Arquitetura modular"}
{isEs ? "Arquitectura modular" : isEn ? "Modular architecture" : "Arquitetura modular"}
</span>
<h2 className="section-title mt-4">ESP Component Registry</h2>
<p className="mt-3 text-base leading-relaxed text-muted">
{isEn ? (
{isEs ? (
<>
Instale controladores de pantalla (LVGL), pilas industriales (Modbus), integraciones en la nube y paquetes de soporte para placas
(BSPs) con una sola línea en su manifiesto <code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono text-sm">idf_component.yml</code>.
</>
) : isEn ? (
<>
Install display drivers (LVGL), industrial stacks (Modbus), cloud integrations, and board support packages
(BSPs) with a single line in your <code className="rounded bg-surface-2 px-1.5 py-0.5 font-mono text-sm">idf_component.yml</code> manifest.
@@ -148,7 +191,7 @@ export default async function Frameworks({ params }) {
</p>
</div>
<Link href={getLocalizedHref("/componentes", currentLocale)} className="btn btn-primary shrink-0">
{isEn ? "Explore components" : "Explorar componentes"}
{isEs ? "Explorar componentes" : isEn ? "Explore components" : "Explorar componentes"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
@@ -157,9 +200,9 @@ export default async function Frameworks({ params }) {
<section className="shell section" aria-labelledby="todos-titulo">
<SectionHead
id="todos-titulo"
eyebrow={isEn ? "All" : "Todos"}
title={isEn ? "All frameworks" : "Todos os frameworks"}
lede={isEn ? "Each page provides features, ideal use cases, code examples, and official links." : "Cada ficha traz recursos, aplicações ideais, exemplo de código e links oficiais."}
eyebrow={isEs ? "Todos" : isEn ? "All" : "Todos"}
title={isEs ? "Todos los frameworks" : isEn ? "All frameworks" : "Todos os frameworks"}
lede={isEs ? "Cada ficha ofrece funciones, aplicaciones ideales, ejemplos de código y enlaces oficiales." : isEn ? "Each page provides features, ideal use cases, code examples, and official links." : "Cada ficha traz recursos, aplicações ideais, exemplo de código e links oficiais."}
/>
<div className="mt-8 grid gap-4 md:grid-cols-2 lg:grid-cols-3">
@@ -181,7 +224,7 @@ export default async function Frameworks({ params }) {
</ul>
<span className="mt-5 inline-flex items-center gap-1 border-t border-line pt-4 text-sm font-medium text-accent">
{isEn ? "View details and example" : "Ver detalhes e exemplo"}
{isEs ? "Ver detalles y ejemplo" : isEn ? "View details and example" : "Ver detalhes e exemplo"}
<ArrowUpRight className="h-4 w-4 transition-transform group-hover:-translate-y-0.5 group-hover:translate-x-0.5" aria-hidden="true" />
</span>
</Link>
+28 -9
View File
@@ -1,20 +1,36 @@
import { paginaMeta, jsonLd } from "@/lib/seo";
import { categoriasGlossario as categoriasGlossarioPt } from "@/lib/glossarioData";
import { categoriasGlossario as categoriasGlossarioEn } from "@/lib/data/en/glossario.js";
import { categoriasGlossario as categoriasGlossarioEs } from "@/lib/data/es/glossario.js";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return paginaMeta({
titulo: isEn
titulo: isEs
? "Glosario técnico de ESP32: Términos y conceptos"
: isEn
? "ESP32 Technical Glossary: Terms and Concepts"
: "Glossário Técnico do ESP32: Termos e Conceitos",
descricao: isEn
descricao: isEs
? "Más de 50 conceptos esenciales de ESP32 explicados: GPIO, Strapping Pins, ULP, PSRAM, FreeRTOS, eFuse, Deep Sleep, OTA, Secure Boot, ECDSA, Matter y Thread."
: isEn
? "Over 50 essential ESP32 concepts explained: GPIO, Strapping Pins, ULP, PSRAM, FreeRTOS, eFuse, Deep Sleep, OTA, Secure Boot, ECDSA, Matter, and Thread."
: "Mais de 50 termos e conceitos essenciais do ecossistema ESP32 explicados em português: GPIO, Strapping Pins, ULP, PSRAM, FreeRTOS, eFuse, Deep Sleep, OTA, Secure Boot, ECDSA, Matter e Thread.",
caminho: "/glossario",
locale,
keywords: isEn
keywords: isEs
? [
"glosario ESP32",
"qué es GPIO",
"qué son strapping pins",
"qué es ESP32 ULP",
"qué es ESP32 PSRAM",
"términos técnicos microcontrolador",
"conceptos ESP32 hardware",
]
: isEn
? [
"ESP32 glossary",
"what is GPIO",
@@ -39,7 +55,8 @@ export async function generateMetadata({ params }) {
export default async function GlossarioLayout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const categorias = isEn ? categoriasGlossarioEn : categoriasGlossarioPt;
const isEs = locale === "es";
const categorias = isEs ? categoriasGlossarioEs : isEn ? categoriasGlossarioEn : categoriasGlossarioPt;
return (
<>
@@ -54,8 +71,8 @@ export default async function GlossarioLayout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "Technical Glossary" : "Glossário Técnico", caminho: isEn ? "/en/glossary" : "/glossario" },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEs ? "/es" : isEn ? "/en" : "/" },
{ nome: isEs ? "Glosario técnico" : isEn ? "Technical Glossary" : "Glossário Técnico", caminho: isEs ? "/es/glosario" : isEn ? "/en/glossary" : "/glossario" },
])
),
}}
@@ -65,11 +82,13 @@ export default async function GlossarioLayout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.aplicacaoWeb({
nome: isEn ? "ESP32 Technical Glossary" : "Glossário Técnico do ESP32",
descricao: isEn
nome: isEs ? "Glosario técnico de ESP32" : isEn ? "ESP32 Technical Glossary" : "Glossário Técnico do ESP32",
descricao: isEs
? "Enciclopedia de términos técnicos y conceptos de hardware y software del ecosistema ESP32."
: isEn
? "Encyclopedia of hardware and software technical terms for the ESP32 ecosystem."
: "Enciclopédia de termos técnicos e conceitos de hardware e software do ecossistema ESP32.",
caminho: isEn ? "/en/glossary" : "/glossario",
caminho: isEs ? "/es/glosario" : isEn ? "/en/glossary" : "/glossario",
locale,
})
),
+37 -28
View File
@@ -8,6 +8,7 @@ import PageHero from "@/components/PageHero";
import Link from "next/link";
import * as glossarioPt from "@/lib/glossarioData";
import * as glossarioEn from "@/lib/data/en/glossario";
import * as glossarioEs from "@/lib/data/es/glossario";
import { getLocalizedHref } from "@/i18n/links";
import {
ArrowRight,
@@ -40,8 +41,9 @@ const nomeCurto = (nome) => nome.split(/,| &/)[0].trim();
export default function GlossarioPage() {
const pathname = usePathname();
const isEn = pathname?.startsWith("/en");
const currentLocale = isEn ? "en" : "pt";
const { categoriasGlossario } = isEn ? glossarioEn : glossarioPt;
const isEs = pathname?.startsWith("/es");
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const { categoriasGlossario } = isEs ? glossarioEs : isEn ? glossarioEn : glossarioPt;
const [busca, setBusca] = useState("");
const [categoriaSelecionada, setCategoriaSelecionada] = useState("todas");
@@ -109,22 +111,25 @@ export default function GlossarioPage() {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Glossary" : "Glossário" }]}
isEs={isEs}
trail={[{ label: isEs ? "Glosario" : isEn ? "Glossary" : "Glossário" }]}
icon={BookOpen}
label={isEn ? `${todosOsTermos.length} terms explained` : `${todosOsTermos.length} termos explicados`}
title={isEn ? "ESP32 Technical Glossary" : "Glossário técnico do ESP32"}
label={isEs ? `${todosOsTermos.length} términos explicados` : isEn ? `${todosOsTermos.length} terms explained` : `${todosOsTermos.length} termos explicados`}
title={isEs ? "Glosario técnico de ESP32" : isEn ? "ESP32 Technical Glossary" : "Glossário técnico do ESP32"}
lede={
isEn
isEs
? "Definiciones directas, parámetros de hardware y un ejemplo práctico para cada término del ecosistema, desde ADC hasta Secure Boot."
: isEn
? "Direct definitions, hardware parameters, and practical examples for every ecosystem term, from ADC to Secure Boot."
: "Definições diretas, parâmetros de hardware e um exemplo prático para cada termo do ecossistema, de ADC a Secure Boot."
}
/>
<section className="shell pt-10 sm:pt-12" aria-label={isEn ? "Search and filters" : "Busca e filtros"}>
<section className="shell pt-10 sm:pt-12" aria-label={isEs ? "Búsqueda y filtros" : isEn ? "Search and filters" : "Busca e filtros"}>
<div className="panel p-5 sm:p-7">
<div className="relative">
<label htmlFor="busca-glossario" className="sr-only">
{isEn ? "Search term, acronym, or concept" : "Buscar termo, sigla ou conceito"}
{isEs ? "Buscar término, sigla o concepto" : isEn ? "Search term, acronym, or concept" : "Buscar termo, sigla ou conceito"}
</label>
<Search className="pointer-events-none absolute left-4 top-1/2 h-5 w-5 -translate-y-1/2 text-muted" aria-hidden="true" />
<input
@@ -133,7 +138,7 @@ export default function GlossarioPage() {
type="search"
value={busca}
onChange={(e) => setBusca(e.target.value)}
placeholder={isEn ? "Search term, acronym, or concept" : "Buscar termo, sigla ou conceito"}
placeholder={isEs ? "Buscar término, sigla o concepto" : isEn ? "Search term, acronym, or concept" : "Buscar termo, sigla ou conceito"}
autoComplete="off"
className={`field pl-12 text-base ${busca ? "pr-28" : "pr-4"}`}
/>
@@ -141,14 +146,14 @@ export default function GlossarioPage() {
{busca && (
<button type="button" onClick={() => { setBusca(""); searchInputRef.current?.focus(); }} className="btn btn-ghost btn-sm">
<X className="h-3.5 w-3.5" aria-hidden="true" />
{isEn ? "Clear" : "Limpar"}
{isEs ? "Limpiar" : isEn ? "Clear" : "Limpar"}
</button>
)}
</div>
</div>
<div className="mt-4 flex flex-wrap items-center gap-2">
<span className="mr-1 text-sm text-muted">{isEn ? "Popular searches" : "Mais buscados"}</span>
<span className="mr-1 text-sm text-muted">{isEs ? "Más buscados" : isEn ? "Popular searches" : "Mais buscados"}</span>
{BUSCAS_POPULARES.map((rotulo) => (
<button
key={rotulo}
@@ -162,7 +167,7 @@ export default function GlossarioPage() {
</div>
<div className="mt-5 border-t border-line pt-5">
<h2 className="text-sm font-semibold text-ink">{isEn ? "Category" : "Categoria"}</h2>
<h2 className="text-sm font-semibold text-ink">{isEs ? "Categoría" : isEn ? "Category" : "Categoria"}</h2>
<div className="mt-3 flex flex-wrap gap-2">
<button
type="button"
@@ -171,7 +176,7 @@ export default function GlossarioPage() {
className="chip-btn"
>
<LayoutGrid className="h-4 w-4" aria-hidden="true" />
{isEn ? "All" : "Todas"}
{isEs ? "Todas" : isEn ? "All" : "Todas"}
<span className="tabular-nums opacity-80">{todosOsTermos.length}</span>
</button>
{categoriasGlossario.map((cat) => {
@@ -194,10 +199,10 @@ export default function GlossarioPage() {
</div>
<div className="mt-6 border-t border-line pt-6">
<h2 className="text-sm font-semibold text-ink">{isEn ? "Alphabetical order" : "Ordem alfabética"}</h2>
<div className="mt-3 flex flex-wrap gap-1.5" role="group" aria-label={isEn ? "Filter by first letter" : "Filtrar pela letra inicial"}>
<h2 className="text-sm font-semibold text-ink">{isEs ? "Orden alfabético" : isEn ? "Alphabetical order" : "Ordem alfabética"}</h2>
<div className="mt-3 flex flex-wrap gap-1.5" role="group" aria-label={isEs ? "Filtrar por letra inicial" : isEn ? "Filter by first letter" : "Filtrar pela letra inicial"}>
<button type="button" onClick={() => setLetraFiltro(null)} aria-pressed={letraFiltro === null} className="chip-btn">
{isEn ? "All" : "Todas"}
{isEs ? "Todas" : isEn ? "All" : "Todas"}
</button>
{alfabeto.map(({ letra, temTermos }) => (
<button
@@ -219,13 +224,13 @@ export default function GlossarioPage() {
<section className="shell section pt-8 sm:pt-10" aria-labelledby="resultado-titulo">
<div className="flex flex-wrap items-center justify-between gap-3">
<h2 id="resultado-titulo" className="text-base font-semibold text-ink" role="status" aria-live="polite">
{total} {total === 1 ? (isEn ? "term" : "termo") : (isEn ? "terms" : "termos")}
{temFiltroAtivo && <span className="font-normal text-muted">{isEn ? " with current filters" : " com os filtros atuais"}</span>}
{total} {total === 1 ? (isEs ? "término" : isEn ? "term" : "termo") : (isEs ? "términos" : isEn ? "terms" : "termos")}
{temFiltroAtivo && <span className="font-normal text-muted">{isEs ? " con los filtros actuales" : isEn ? " with current filters" : " com os filtros atuais"}</span>}
</h2>
{temFiltroAtivo && (
<button type="button" onClick={limparTodosFiltros} className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent hover:text-accent-strong">
<RotateCcw className="h-4 w-4" aria-hidden="true" />
{isEn ? "Reset filters" : "Redefinir filtros"}
{isEs ? "Restablecer filtros" : isEn ? "Reset filters" : "Redefinir filtros"}
</button>
)}
</div>
@@ -234,16 +239,18 @@ export default function GlossarioPage() {
<div className="card mt-6 px-6 py-14 text-center">
<HelpCircle className="mx-auto h-10 w-10 text-muted" aria-hidden="true" />
<h3 className="mt-4 font-display text-xl font-semibold text-ink">
{isEn ? "No terms found" : "Nenhum termo encontrado"}
{isEs ? "No se encontraron términos" : isEn ? "No terms found" : "Nenhum termo encontrado"}
</h3>
<p className="mx-auto mt-2 max-w-md text-sm text-muted">
{isEn
{isEs
? "Nada coincide con la búsqueda y los filtros actuales. Pruebe con una sigla más corta o vuelva a todas las categorías."
: isEn
? "Nothing matches your current search and filters. Try a shorter acronym or reset to all categories."
: "Nada combina com a busca e os filtros atuais. Tente uma sigla mais curta ou volte para todas as categorias."}
</p>
<button type="button" onClick={limparTodosFiltros} className="btn btn-primary mt-6">
<RotateCcw className="h-4 w-4" aria-hidden="true" />
{isEn ? "Clear filters" : "Limpar filtros"}
{isEs ? "Limpiar filtros" : isEn ? "Clear filters" : "Limpar filtros"}
</button>
</div>
) : (
@@ -260,7 +267,7 @@ export default function GlossarioPage() {
<button
type="button"
onClick={() => copiarLinkTermo(item.slug)}
aria-label={isEn ? `Copy link for ${item.termo}` : `Copiar link para ${item.termo}`}
aria-label={isEs ? `Copiar enlace para ${item.termo}` : isEn ? `Copy link for ${item.termo}` : `Copiar link para ${item.termo}`}
className="btn-icon inline-flex h-11 w-11 items-center justify-center rounded-full text-muted transition-colors hover:bg-surface-2 hover:text-accent"
>
{copiadoSlug === item.slug ? <Check className="h-4 w-4 text-ok" aria-hidden="true" /> : <Link2 className="h-4 w-4" aria-hidden="true" />}
@@ -275,7 +282,7 @@ export default function GlossarioPage() {
<div className="callout mt-5">
<p className="flex items-center gap-1.5 text-sm font-semibold text-ink">
<Lightbulb className="h-4 w-4 text-accent" aria-hidden="true" />
{isEn ? "In practice" : "Na prática"}
{isEs ? "En la práctica" : isEn ? "In practice" : "Na prática"}
</p>
<p className="mt-1">
<TextoComLinks texto={item.exemplo} currentLocale={currentLocale} />
@@ -291,20 +298,22 @@ export default function GlossarioPage() {
<section className="shell pb-20 md:pb-28">
<div className="panel p-8 text-center sm:p-12">
<h2 className="section-title mx-auto max-w-2xl">
{isEn ? "From concept to the right chip." : "Do conceito ao chip certo."}
{isEs ? "Del concepto al chip adecuado." : isEn ? "From concept to the right chip." : "Do conceito ao chip certo."}
</h2>
<p className="lede mx-auto mt-4 max-w-2xl">
{isEn
{isEs
? "Con los términos a mano, compare las series lado a lado o responda al selector para encontrar el modelo que se adapta a su proyecto."
: isEn
? "With the terms in hand, compare series side by side or answer the selector to find the model that fits your project."
: "Com os termos em mãos, compare as séries lado a lado ou responda ao seletor para chegar ao modelo que cabe no seu projeto."}
</p>
<div className="mt-8 flex flex-col items-center justify-center gap-3 sm:flex-row">
<Link href={getLocalizedHref("/seletor", currentLocale)} className="btn btn-primary w-full sm:w-auto">
<Sliders className="h-4 w-4" aria-hidden="true" />
{isEn ? "Choose my chip" : "Escolher meu chip"}
{isEs ? "Elegir mi chip" : isEn ? "Choose my chip" : "Escolher meu chip"}
</Link>
<Link href={getLocalizedHref("/series", currentLocale)} className="btn btn-ghost w-full sm:w-auto">
{isEn ? "Explore series" : "Explorar as séries"}
{isEs ? "Explorar las series" : isEn ? "Explore series" : "Explorar as séries"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
+16
View File
@@ -45,6 +45,7 @@ export function generateStaticParams() {
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
const ogLocaleMap = {
pt: "pt_BR",
@@ -59,10 +60,14 @@ export async function generateMetadata({ params }) {
const titleDefault = isEn
? "ESPDocs · ESP32 Open Documentation"
: isEs
? "ESPDocs · Documentación abierta de ESP32"
: "ESPDocs · Documentação do ESP32 em português";
const description = isEn
? "Specifications, pinouts, comparison and selection of 12 ESP32 microcontroller series. Datasheets, peripherals, hardware security and connection diagrams."
: isEs
? "Especificaciones, patillaje, comparación y selección de las 12 series de microcontroladores ESP32. Hojas de datos, periféricos, seguridad en hardware y diagramas de conexión."
: "Especificações, pinagem, comparação e seleção das 12 séries de microcontroladores ESP32, em português brasileiro. Datasheets, periféricos, segurança em hardware e diagramas de conexão.";
const keywords = isEn
@@ -72,6 +77,13 @@ export async function generateMetadata({ params }) {
"compare ESP32", "which ESP32 to choose", "ESP32 datasheet",
"microcontroller", "Espressif", "ESP-IDF", "IoT", "embedded systems",
]
: isEs
? [
"ESP32", "ESP32 en español", "documentación ESP32", "patillaje ESP32", "pinout ESP32",
"ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4", "ESP32-H2",
"comparar ESP32", "cuál ESP32 elegir", "datasheet ESP32", "hoja de datos ESP32",
"microcontrolador", "Espressif", "ESP-IDF", "IoT", "sistemas embebidos",
]
: [
"ESP32", "ESP32 português", "documentação ESP32", "pinout ESP32",
"ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4", "ESP32-H2",
@@ -112,6 +124,8 @@ export async function generateMetadata({ params }) {
title: titleDefault,
description: isEn
? "Specifications, pinouts, comparison and selection of 12 ESP32 microcontroller series."
: isEs
? "Especificaciones, patillaje, comparación y selección de las 12 series de microcontroladores ESP32."
: "Especificações, pinagem, comparação e seleção das 12 séries de microcontroladores ESP32, em português brasileiro.",
},
twitter: {
@@ -119,6 +133,8 @@ export async function generateMetadata({ params }) {
title: titleDefault,
description: isEn
? "Specifications, pinouts, comparison and selection of 12 ESP32 series."
: isEs
? "Especificaciones, patillaje, comparación y selección de las 12 series de ESP32."
: "Especificações, pinagem, comparação e seleção das 12 séries de ESP32, em português.",
},
robots: {
+16 -6
View File
@@ -24,6 +24,13 @@ const CAMINHOS_EN = [
{ href: "/glossario", icon: BookOpen, titulo: "Glossary", texto: "Hardware terms explained clearly." },
];
const CAMINHOS_ES = [
{ href: "/series", icon: Compass, titulo: "Series ESP32", texto: "Las 12 familias, con patillaje y especificaciones." },
{ href: "/seletor", icon: SlidersHorizontal, titulo: "Selector de chip", texto: "Responda a ocho preguntas y reciba los modelos recomendados." },
{ href: "/comparacao", icon: Scale, titulo: "Comparador", texto: "Hasta cuatro series frente a frente." },
{ href: "/glossario", icon: BookOpen, titulo: "Glosario", texto: "Términos de hardware explicados con claridad." },
];
export default async function NotFound() {
let locale = "pt";
try {
@@ -32,7 +39,8 @@ export default async function NotFound() {
locale = "pt";
}
const isEn = locale === "en";
const caminhos = isEn ? CAMINHOS_EN : CAMINHOS_PT;
const isEs = locale === "es";
const caminhos = isEn ? CAMINHOS_EN : isEs ? CAMINHOS_ES : CAMINHOS_PT;
return (
<div className="site-canvas min-h-screen">
@@ -40,16 +48,18 @@ export default async function NotFound() {
<main id="conteudo" className="shell section">
<div className="mx-auto max-w-2xl text-center">
<p className="eyebrow justify-center">{isEn ? "Error 404" : "Erro 404"}</p>
<h1 className="page-title mt-4">{isEn ? "This page does not exist." : "Essa página não existe."}</h1>
<p className="eyebrow justify-center">{isEn ? "Error 404" : "Error 404"}</p>
<h1 className="page-title mt-4">{isEn ? "This page does not exist." : isEs ? "Esta página no existe." : "Essa página não existe."}</h1>
<p className="lede mx-auto mt-5 max-w-xl">
{isEn
? "The address may have changed or was mistyped. Choose one of these paths to continue."
: isEs
? "La dirección puede haber cambiado o estar mal escrita. Elija uno de estos caminos para continuar."
: "O endereço pode ter mudado ou estar digitado errado. Escolha um destes caminhos para continuar."}
</p>
<div className="mt-8 flex justify-center">
<Link href={isEn ? "/en" : "/"} className="btn btn-primary">
{isEn ? "Back to home" : "Voltar ao início"}
<Link href={isEn ? "/en" : isEs ? "/es" : "/"} className="btn btn-primary">
{isEn ? "Back to home" : isEs ? "Volver al inicio" : "Voltar ao início"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
@@ -57,7 +67,7 @@ export default async function NotFound() {
<ul className="mx-auto mt-14 grid max-w-4xl gap-3 sm:grid-cols-2">
{caminhos.map(({ href, icon: Icon, titulo, texto }) => {
const targetHref = isEn ? getLocalizedHref(href, "en") : href;
const targetHref = getLocalizedHref(href, locale);
return (
<li key={href}>
<Link href={targetHref} className="card card-interactive group flex h-full items-start gap-4 p-5">
+113 -21
View File
@@ -6,6 +6,8 @@ import seriesDataPt from "@/public/series.json";
import frameworksDataPt from "@/public/frameworks.json";
import seriesDataEn from "@/data/en/series.json";
import frameworksDataEn from "@/data/en/frameworks.json";
import seriesDataEs from "@/data/es/series.json";
import frameworksDataEs from "@/data/es/frameworks.json";
import { SITE } from "@/lib/seo";
import { getLocalizedHref } from "@/i18n/links";
import {
@@ -112,6 +114,51 @@ const TOOLS_EN = [
},
];
const TOOLS_ES = [
{
href: "/seletor",
title: "Selector inteligente",
desc: "Responda a ocho preguntas sobre su proyecto y reciba los chips más compatibles, con justificación técnica.",
icon: SlidersHorizontal,
action: "Encontrar mi chip",
},
{
href: "/comparacao",
title: "Comparador de series",
desc: "Compare hasta cuatro modelos frente a frente: núcleos, radio, memoria, periféricos y seguridad.",
icon: Scale,
action: "Comparar ahora",
},
{
href: "/diagnostico",
title: "Diagnóstico de fallos",
desc: "Causas y soluciones para brownout, bootloop, Guru Meditation, watchdog y fallos de flash.",
icon: AlertTriangle,
action: "Abrir diagnóstico",
},
{
href: "/componentes",
title: "Component Registry",
desc: "Drivers, bibliotecas y BSPs del registro oficial de Espressif, con manifiesto listo para su proyecto.",
icon: Box,
action: "Explorar componentes",
},
{
href: "/frameworks",
title: "Frameworks y SDKs",
desc: "ESP-IDF, Arduino, Rust, Matter, MicroPython y las herramientas que rodean al silicio.",
icon: Terminal,
action: "Ver frameworks",
},
{
href: "/catalogo",
title: "Catálogo de placas",
desc: "DevKits y módulos reales, con interfaz USB, sensores integrados y enlace directo a la tienda oficial.",
icon: Cpu,
action: "Ver placas",
},
];
const ERRORS_PT = [
{
code: "Brownout detector was triggered",
@@ -158,15 +205,40 @@ const ERRORS_EN = [
},
];
const ERRORS_ES = [
{
code: "Brownout detector was triggered",
cause: "Caída de tensión al inicializar la etapa de radio.",
fix: "Condensador de 10–100 µF junto al chip y fuente de 5 V con corriente suficiente.",
},
{
code: "Guru Meditation Error",
cause: "Puntero inválido, desbordamiento de pila o uso incorrecto de interrupciones.",
fix: "Analice el backtrace con addr2line y dimensione la pila de la tarea en FreeRTOS.",
},
{
code: "ADC2 no disponible con Wi-Fi",
cause: "El controlador de radio reserva ADC2 mientras permanece activo.",
fix: "Utilice los pines de ADC1 para sensores analógicos que funcionen junto con Wi-Fi.",
},
{
code: "Flash Read err / bootloader",
cause: "Tensión o modo de flash incorrectos, o pin de strapping forzado en el arranque.",
fix: "Compruebe la línea de 3,3 V, los pull-ups de arranque y la configuración de flash en esptool.",
},
];
export default async function Home({ params }) {
const { locale } = await params;
const isPt = locale === "pt";
const isEn = locale === "en";
const isEs = locale === "es";
const getLinkHref = (href) => getLocalizedHref(`/${locale}${href}`, locale);
const seriesData = isPt ? seriesDataPt : seriesDataEn;
const frameworksData = isPt ? frameworksDataPt : frameworksDataEn;
const tools = isPt ? TOOLS_PT : TOOLS_EN;
const errors = isPt ? ERRORS_PT : ERRORS_EN;
const seriesData = isPt ? seriesDataPt : isEs ? seriesDataEs : seriesDataEn;
const frameworksData = isPt ? frameworksDataPt : isEs ? frameworksDataEs : frameworksDataEn;
const tools = isPt ? TOOLS_PT : isEs ? TOOLS_ES : TOOLS_EN;
const errors = isPt ? ERRORS_PT : isEs ? ERRORS_ES : ERRORS_EN;
const seriesCount = Object.keys(seriesData).length;
const frameworkCount = Object.keys(frameworksData).length;
@@ -181,7 +253,7 @@ export default async function Home({ params }) {
<div className="mx-auto max-w-4xl text-center">
<span className="chip chip-accent">
<Cpu className="h-3.5 w-3.5" aria-hidden="true" />
{isPt ? "Documentação aberta do ESP32" : "Open ESP32 documentation"}
{isPt ? "Documentação aberta do ESP32" : isEs ? "Documentación abierta de ESP32" : "Open ESP32 documentation"}
</span>
<h1 className="display mt-6 text-[clamp(2.9rem,7.4vw,5.4rem)]">
{isPt ? (
@@ -189,6 +261,11 @@ export default async function Home({ params }) {
O ESP32,
<br className="sm:hidden" /> sem ruído.
</>
) : isEs ? (
<>
El ESP32,
<br className="sm:hidden" /> sin ruido.
</>
) : (
<>
The ESP32,
@@ -199,17 +276,21 @@ export default async function Home({ params }) {
<p className="lede mx-auto mt-6 max-w-2xl">
{isPt
? "Especificações, pinagem, comparações e diagnóstico em uma leitura só. Menos tradução de datasheet, mais tempo com o protótipo na bancada."
: isEs
? "Especificaciones, patillaje, comparaciones y diagnóstico en una sola lectura. Menos traducción de hojas de datos, más tiempo con el prototipo en el banco de trabajo."
: "Specifications, pinouts, comparisons and diagnostics in a single read. Less datasheet translation, more workbench time."}
</p>
<div className="mt-8 flex flex-col items-center justify-center gap-3 sm:flex-row">
<Link href={getLinkHref("/seletor")} className="btn btn-primary w-full sm:w-auto">
<SlidersHorizontal className="h-4 w-4" aria-hidden="true" />
{isPt ? "Escolher meu chip" : "Choose my chip"}
{isPt ? "Escolher meu chip" : isEs ? "Elegir mi chip" : "Choose my chip"}
</Link>
<Link href={getLinkHref("/series")} className="btn btn-ghost w-full sm:w-auto">
{isPt ? (
<>Explorar as {seriesCount} séries</>
) : isEs ? (
<>Explorar las {seriesCount} series</>
) : (
<>Explore the {seriesCount} series</>
)}
@@ -218,7 +299,7 @@ export default async function Home({ params }) {
</div>
<p className="mt-7 flex flex-wrap items-center justify-center gap-x-5 gap-y-2 text-sm text-muted">
<span><strong className="font-semibold text-ink">{seriesCount}</strong> {isPt ? "séries" : "series"}</span>
<span><strong className="font-semibold text-ink">{seriesCount}</strong> {isPt ? "séries" : isEs ? "series" : "series"}</span>
<span aria-hidden="true" className="text-line-strong">·</span>
<span><strong className="font-semibold text-ink">{frameworkCount}</strong> frameworks</span>
{isPt ? (
@@ -228,6 +309,11 @@ export default async function Home({ params }) {
<span aria-hidden="true" className="text-line-strong">·</span>
<span>100% em português</span>
</>
) : isEs ? (
<>
<span aria-hidden="true" className="text-line-strong">·</span>
<span>100% en español</span>
</>
) : (
<>
<span aria-hidden="true" className="text-line-strong">·</span>
@@ -240,13 +326,13 @@ export default async function Home({ params }) {
<div className="panel mt-12 overflow-hidden sm:mt-16">
<div className="flex flex-wrap items-center justify-between gap-3 px-5 py-4 sm:px-7">
<div>
<h2 className="text-sm font-semibold text-ink">{isPt ? "Séries em destaque" : "Featured series"}</h2>
<h2 className="text-sm font-semibold text-ink">{isPt ? "Séries em destaque" : isEs ? "Series destacadas" : "Featured series"}</h2>
<p className="mt-0.5 text-xs text-muted">
{isPt ? "O essencial de cada família, antes de abrir o datasheet." : "The essentials of each family before opening the datasheet."}
{isPt ? "O essencial de cada família, antes de abrir o datasheet." : isEs ? "Lo esencial de cada familia, antes de abrir la hoja de datos." : "The essentials of each family before opening the datasheet."}
</p>
</div>
<Link href={getLinkHref("/series")} className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-accent transition-colors hover:text-accent-strong">
{isPt ? "Índice completo" : "Full index"}
{isPt ? "Índice completo" : isEs ? "Índice completo" : "Full index"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
@@ -271,7 +357,7 @@ export default async function Home({ params }) {
<div className="mt-5 flex items-center justify-between gap-3 border-t border-line pt-3.5">
<span className="truncate font-mono text-[0.6875rem] text-ink-soft">{serie.frequencia}</span>
<span className="inline-flex shrink-0 items-center gap-1 text-xs font-medium text-accent">
{isPt ? "Ficha" : "Spec sheet"}
{isPt ? "Ficha" : isEs ? "Ficha" : "Spec sheet"}
<ArrowUpRight className="h-3.5 w-3.5 transition-transform duration-300 group-hover:-translate-y-0.5 group-hover:translate-x-0.5" aria-hidden="true" />
</span>
</div>
@@ -352,13 +438,15 @@ export default async function Home({ params }) {
<section className="shell section" aria-labelledby="ferramentas-titulo">
<div className="mx-auto max-w-2xl text-center">
<p className="eyebrow">{isPt ? "Ferramentas" : "Tools"}</p>
<p className="eyebrow">{isPt ? "Ferramentas" : isEs ? "Herramientas" : "Tools"}</p>
<h2 id="ferramentas-titulo" className="display mt-4 text-[clamp(2rem,4.8vw,3.4rem)]">
{isPt ? "Comece pelo problema." : "Start with the problem."}
{isPt ? "Comece pelo problema." : isEs ? "Empiece por el problema." : "Start with the problem."}
</h2>
<p className="lede mt-4">
{isPt
? "Cada ferramenta resolve uma etapa concreta do projeto, sem cadastro e sem rodeio."
: isEs
? "Cada herramienta resuelve una fase concreta del proyecto, sin registros ni rodeos."
: "Each tool addresses a concrete development phase, with no sign-ups and zero fluff."}
</p>
</div>
@@ -386,18 +474,20 @@ export default async function Home({ params }) {
<section className="shell section pt-0" aria-labelledby="diagnostico-titulo">
<div className="grid items-start gap-10 lg:grid-cols-[0.78fr_1.22fr] lg:gap-16">
<div className="lg:sticky lg:top-28">
<p className="eyebrow">{isPt ? "Diagnóstico" : "Diagnostics"}</p>
<p className="eyebrow">{isPt ? "Diagnóstico" : isEs ? "Diagnóstico" : "Diagnostics"}</p>
<h2 id="diagnostico-titulo" className="display mt-4 text-[clamp(2rem,4.8vw,3.4rem)]">
{isPt ? "O primeiro boot não precisa virar noite." : "First boot doesn't have to take all night."}
{isPt ? "O primeiro boot não precisa virar noite." : isEs ? "El primer arranque no tiene por qué desvelarlo." : "First boot doesn't have to take all night."}
</h2>
<p className="lede mt-4">
{isPt
? "Os erros mais comuns têm causa conhecida. O guia parte da mensagem no terminal e chega ao ajuste de hardware ou firmware."
: isEs
? "Los errores más comunes tienen una causa conocida. Esta guía parte del mensaje en el terminal y llega al ajuste de hardware o firmware."
: "Common errors have known causes. This guide starts with the serial terminal log and leads to the hardware or firmware adjustment."}
</p>
<Link href={getLinkHref("/diagnostico")} className="btn btn-accent mt-7">
<AlertTriangle className="h-4 w-4" aria-hidden="true" />
{isPt ? "Abrir os 30+ diagnósticos" : "Open the 30+ diagnostics"}
{isPt ? "Abrir os 30+ diagnósticos" : isEs ? "Abrir los 30+ diagnósticos" : "Open the 30+ diagnostics"}
</Link>
</div>
@@ -407,7 +497,7 @@ export default async function Home({ params }) {
<Terminal className="h-4 w-4" aria-hidden="true" />
boot.log
</span>
<span className="text-xs text-[#a6afbd]">{isPt ? "4 exemplos de 30+" : "4 examples of 30+"}</span>
<span className="text-xs text-[#a6afbd]">{isPt ? "4 exemplos de 30+" : isEs ? "4 ejemplos de 30+" : "4 examples of 30+"}</span>
</div>
<div className="divide-y divide-white/10">
{errors.map((item) => (
@@ -424,22 +514,24 @@ export default async function Home({ params }) {
<section className="shell pb-20 pt-4 md:pb-28">
<div className="mx-auto max-w-3xl text-center">
<p className="eyebrow">{isPt ? "Curadoria independente" : "Independent curation"}</p>
<p className="eyebrow">{isPt ? "Curadoria independente" : isEs ? "Curaduría independiente" : "Independent curation"}</p>
<h2 className="display mt-4 text-[clamp(2rem,4.5vw,3.2rem)]">
{isPt ? "Feito para consultar no meio do projeto." : "Built for quick lookup mid-project."}
{isPt ? "Feito para consultar no meio do projeto." : isEs ? "Diseñado para consultar en mitad del proyecto." : "Built for quick lookup mid-project."}
</h2>
<p className="lede mx-auto mt-4 max-w-2xl">
{isPt
? "O ESPDocs organiza dados públicos da Espressif e aponta sempre para a fonte oficial. Para decisões críticas, o datasheet e o Technical Reference Manual continuam sendo a palavra final."
: isEs
? "ESPDocs organiza datos públicos de Espressif y apunta siempre a la fuente oficial. Para decisiones críticas, la hoja de datos y el Technical Reference Manual continúan teniendo la última palabra."
: "ESPDocs organizes public Espressif data and points directly to official sources. For critical engineering decisions, the datasheet and Technical Reference Manual remain the definitive authority."}
</p>
<div className="mt-8 flex flex-col items-center justify-center gap-3 sm:flex-row">
<Link href={getLinkHref("/glossario")} className="btn btn-ghost w-full sm:w-auto">
<BookOpen className="h-4 w-4" aria-hidden="true" />
{isPt ? "Glossário" : "Glossary"}
{isPt ? "Glossário" : isEs ? "Glosario" : "Glossary"}
</Link>
<Link href={getLinkHref("/sobre")} className="btn btn-primary w-full sm:w-auto">
{isPt ? "Sobre o projeto" : "About the project"}
{isPt ? "Sobre o projeto" : isEs ? "Acerca del proyecto" : "About the project"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
+36 -9
View File
@@ -3,14 +3,19 @@ import { paginaMeta, jsonLd } from "@/lib/seo";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return paginaMeta({
titulo: isEn ? "Which ESP32 to Choose" : "Qual ESP32 escolher",
descricao: isEn
titulo: isEs ? "Qué ESP32 elegir" : isEn ? "Which ESP32 to Choose" : "Qual ESP32 escolher",
descricao: isEs
? "Responda a preguntas sencillas sobre conectividad (Wi-Fi 6, 5GHz, Matter), energía, periféricos y seguridad o use el filtro paramétrico para encontrar el ESP32 perfecto."
: isEn
? "Answer simple questions about connectivity (Wi-Fi 6, 5GHz, Matter), power, peripherals, and security or use the parametric filter to find the perfect ESP32."
: "Responda a perguntas simples sobre conectividade (Wi-Fi 6, 5GHz, Matter), energia, periféricos e segurança ou use o filtro paramétrico para encontrar o ESP32 perfeito.",
caminho: "/seletor",
locale,
keywords: isEn
keywords: isEs
? ["qué ESP32 elegir", "cuál ESP32 usar", "elegir microcontrolador", "ESP32 para mi proyecto", "comparar ESP32"]
: isEn
? ["which ESP32 to choose", "which ESP32 to use", "choose microcontroller", "ESP32 for my project", "compare ESP32"]
: ["qual ESP32 escolher", "qual ESP32 usar", "escolher microcontrolador", "ESP32 para meu projeto", "comparar ESP32"],
});
@@ -54,10 +59,30 @@ const faqsEn = [
},
];
const faqsEs = [
{
pergunta: "¿Cuál ESP32 elegir para principiantes?",
resposta: "Para quienes se inician en el mundo Maker e IoT, el ESP32 clásico (NodeMCU/DevKitC) o el ESP32-C3 son las mejores opciones gracias al amplio soporte de bibliotecas, ejemplos listos en Arduino IDE y abundante documentación.",
},
{
pergunta: "¿Cuál ESP32 soporta Wi-Fi 6, Bluetooth 6 y Thread/Zigbee/Matter?",
resposta: "El ESP32-C6 y el ESP32-C5 son las series destacadas para redes modernas. El ESP32-C6 ofrece Wi-Fi 6 (2.4 GHz) y radio 802.15.4 (Zigbee 3.0 / Thread / Matter). El ESP32-C5 es el primero en ofrecer soporte para Wi-Fi 6 de doble banda operando en 2.4 GHz y 5 GHz simultáneamente.",
},
{
pergunta: "¿Cuál es el ESP32 más potente para Inteligencia Artificial (TinyML) y Pantallas?",
resposta: "El ESP32-P4 (dual-core RISC-V a 400 MHz con extensiones vectoriales de IA, interfaces MIPI-CSI/DSI para cámaras/pantallas y hasta 64 MB de PSRAM) y el ESP32-S3 (dual-core Xtensa a 240 MHz con aceleradores vectoriales para redes neuronales y soporte para LCD RGB) son los más rápidos para IA en el borde e interfaces gráficas avanzadas.",
},
{
pergunta: "¿Cuál ESP32 consume menos energía para proyectos a batería?",
resposta: "Los microcontroladores con arquitectura RISC-V compacta y coprocesador ULP, como el ESP32-C2, ESP32-C3 y ESP32-H2 (dedicado a 802.15.4 sin radio Wi-Fi), ofrecen corrientes de deep sleep extremadamente bajas (en el rango de 5 µA a 10 µA).",
},
];
export default async function Layout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const faqs = isEn ? faqsEn : faqsPt;
const isEs = locale === "es";
const faqs = isEs ? faqsEs : isEn ? faqsEn : faqsPt;
return (
<>
@@ -66,11 +91,13 @@ export default async function Layout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.aplicacaoWeb({
nome: isEn ? "Intelligent ESP32 Selector" : "Seletor Inteligente de ESP32",
descricao: isEn
nome: isEs ? "Selector Inteligente de ESP32" : isEn ? "Intelligent ESP32 Selector" : "Seletor Inteligente de ESP32",
descricao: isEs
? "Herramienta interactiva que analiza conectividad, consumo, periféricos y seguridad para recomendar la serie ideal de ESP32."
: isEn
? "Interactive tool analyzing connectivity, power consumption, peripherals, and security to recommend the ideal ESP32 series."
: "Ferramenta interativa que analisa conectividade, consumo, periféricos e segurança para indicar a série ideal de ESP32.",
caminho: isEn ? "/en/selector" : "/seletor",
caminho: isEs ? "/es/selector" : isEn ? "/en/selector" : "/seletor",
locale,
})
),
@@ -81,8 +108,8 @@ export default async function Layout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "ESP32 Selector" : "Seletor de ESP32", caminho: isEn ? "/en/selector" : "/seletor" },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEs ? "/es" : isEn ? "/en" : "/" },
{ nome: isEs ? "Selector de ESP32" : isEn ? "ESP32 Selector" : "Seletor de ESP32", caminho: isEs ? "/es/selector" : isEn ? "/en/selector" : "/seletor" },
])
),
}}
File diff suppressed because it is too large. Load diff
+187 -67
View File
@@ -7,6 +7,7 @@ import PageHero from "@/components/PageHero";
import { notFound } from "next/navigation";
import seriesDataPt from "@/public/series.json";
import seriesDataEn from "@/data/en/series.json";
import seriesDataEs from "@/data/es/series.json";
import ConnectionsDiagram from "@/components/ConnectionsDiagram";
import SeriesTabMenu from "@/components/SeriesTabMenu";
import PinRestrictions from "@/components/PinRestrictions";
@@ -35,8 +36,9 @@ import {
export default async function SerieDetail({ params }) {
const { locale, key } = await params;
const isEn = locale === "en";
const currentLocale = isEn ? "en" : "pt";
const seriesData = isEn ? seriesDataEn : seriesDataPt;
const isEs = locale === "es";
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const seriesData = isEs ? seriesDataEs : isEn ? seriesDataEn : seriesDataPt;
const serie = seriesData[key];
if (!serie) {
@@ -45,7 +47,11 @@ export default async function SerieDetail({ params }) {
let conexoes = [];
try {
conexoes = isEn ? require(`@/data/en/conexoes/${key}.json`) : require(`@/public/conexoes/${key}.json`);
conexoes = isEs
? require(`@/data/es/conexoes/${key}.json`)
: isEn
? require(`@/data/en/conexoes/${key}.json`)
: require(`@/public/conexoes/${key}.json`);
} catch (error) {
console.log(`Arquivo de conexões não encontrado para ${key}`);
}
@@ -55,10 +61,18 @@ export default async function SerieDetail({ params }) {
const previousKey = currentIndex > 0 ? seriesKeys[currentIndex - 1] : null;
const nextKey = currentIndex < seriesKeys.length - 1 ? seriesKeys[currentIndex + 1] : null;
const nao = isEn ? "No" : "Não";
const naoInformado = isEn ? "Not informed" : "Não informado";
const nao = isEs || isEn ? "No" : "Não";
const naoInformado = isEs ? "No informado" : isEn ? "Not informed" : "Não informado";
const processadorSpecs = isEn
const processadorSpecs = isEs
? [
{ label: "Arquitectura", value: serie.arquitetura },
{ label: "Núcleos", value: serie.nucleos },
{ label: "Frecuencia", value: serie.frequencia },
{ label: "Coprocesador ULP", value: serie.coprocessador_ulp || nao },
{ label: "Aceleradores de IA", value: serie.aceleradores_ia || nao },
]
: isEn
? [
{ label: "Architecture", value: serie.arquitetura },
{ label: "Cores", value: serie.nucleos },
@@ -75,7 +89,22 @@ export default async function SerieDetail({ params }) {
];
const seg = serie.seguranca || {};
const segurancaSpecs = isEn
const segurancaSpecs = isEs
? [
{ label: "AES", value: seg.aes || nao },
{ label: "SHA", value: seg.sha || nao },
{ label: "RSA / MPI", value: seg.rsa || nao },
{ label: "ECC (curvas elípticas)", value: seg.ecc || nao },
{ label: "ECDSA en hardware", value: seg.ecdsa || nao },
{ label: "HMAC", value: seg.hmac || nao },
{ label: "Firma digital (DS)", value: seg.assinatura_digital || nao },
{ label: "Key Manager", value: seg.key_manager || nao },
{ label: "Generador aleatorio (TRNG)", value: seg.rng || nao },
{ label: "Cifrado de flash", value: seg.criptografia_flash || nao },
{ label: "Secure Boot", value: seg.secure_boot || nao },
{ label: "Protección contra DPA", value: seg.protecao_dpa || nao },
]
: isEn
? [
{ label: "AES", value: seg.aes || nao },
{ label: "SHA", value: seg.sha || nao },
@@ -105,7 +134,15 @@ export default async function SerieDetail({ params }) {
{ label: "Proteção contra DPA", value: seg.protecao_dpa || "Não" },
];
const ferramentasSpecs = isEn
const ferramentasSpecs = isEs
? [
{ label: "ESP-IDF mínimo", value: serie.esp_idf_minimo || naoInformado },
{ label: "Core Arduino", value: serie.arduino_core || naoInformado },
{ label: "Depuración", value: serie.depuracao || naoInformado },
{ label: "Encapsulado", value: serie.encapsulamento || naoInformado },
{ label: "Módulos disponibles", value: serie.modulos || naoInformado },
]
: isEn
? [
{ label: "Minimum ESP-IDF", value: serie.esp_idf_minimo || naoInformado },
{ label: "Arduino Core", value: serie.arduino_core || naoInformado },
@@ -121,7 +158,16 @@ export default async function SerieDetail({ params }) {
{ label: "Módulos disponíveis", value: serie.modulos || "Não informado" },
];
const conectividadeSpecs = isEn
const conectividadeSpecs = isEs
? [
{ label: "Wi-Fi", value: serie.wifi || nao },
{ label: "Bluetooth", value: serie.bluetooth || nao },
{ label: "Zigbee/Thread", value: serie.zigbee_thread || nao },
{ label: "Matter", value: serie.matter || nao },
{ label: "Ethernet", value: serie.ethernet || serie.ethernet_mac || nao },
{ label: "CAN", value: serie.can || nao },
]
: isEn
? [
{ label: "Wi-Fi", value: serie.wifi || nao },
{ label: "Bluetooth", value: serie.bluetooth || nao },
@@ -139,7 +185,15 @@ export default async function SerieDetail({ params }) {
{ label: "CAN", value: serie.can || "Não" },
];
const memoriaSpecs = isEn
const memoriaSpecs = isEs
? [
{ label: "SRAM", value: serie.memoria_sram },
{ label: "SRAM RTC", value: serie.memoria_sram_rtc },
{ label: "ROM", value: serie.memoria_rom },
{ label: "Flash externa", value: serie.flash_externa },
{ label: "PSRAM externa", value: serie.psram_externa || nao },
]
: isEn
? [
{ label: "SRAM", value: serie.memoria_sram },
{ label: "RTC SRAM", value: serie.memoria_sram_rtc },
@@ -155,7 +209,20 @@ export default async function SerieDetail({ params }) {
{ label: "PSRAM Externa", value: serie.psram_externa || "Não" },
];
const perifericos = isEn
const perifericos = isEs
? [
{ label: "GPIO", value: serie.gpio },
{ label: "ADC", value: serie.adc },
{ label: "DAC", value: serie.dac || nao },
{ label: "Touch", value: serie.touch || nao },
{ label: "UART", value: serie.uart },
{ label: "SPI", value: serie.spi },
{ label: "I2C", value: serie.i2c },
{ label: "I2S", value: serie.i2s },
{ label: "PWM", value: serie.pwm },
{ label: "USB", value: serie.usb || nao },
]
: isEn
? [
{ label: "GPIO", value: serie.gpio },
{ label: "ADC", value: serie.adc },
@@ -183,12 +250,12 @@ export default async function SerieDetail({ params }) {
const interfacesEspeciais = [];
if (serie.lcd) interfacesEspeciais.push({ label: "LCD", value: serie.lcd });
if (serie.camera) interfacesEspeciais.push({ label: isEn ? "Camera" : "Câmera", value: serie.camera });
if (serie.camera) interfacesEspeciais.push({ label: isEs ? "Cámara" : isEn ? "Camera" : "Câmera", value: serie.camera });
if (serie.mipi_csi) interfacesEspeciais.push({ label: "MIPI CSI", value: serie.mipi_csi });
if (serie.mipi_dsi) interfacesEspeciais.push({ label: "MIPI DSI", value: serie.mipi_dsi });
if (serie.sdio) interfacesEspeciais.push({ label: "SDIO", value: serie.sdio });
if (serie.sensor_hall) interfacesEspeciais.push({ label: isEn ? "Hall Sensor" : "Sensor Hall", value: serie.sensor_hall });
if (serie.sensor_temperatura) interfacesEspeciais.push({ label: isEn ? "Temperature Sensor" : "Sensor Temperatura", value: serie.sensor_temperatura });
if (serie.sensor_hall) interfacesEspeciais.push({ label: isEs ? "Sensor Hall" : isEn ? "Hall Sensor" : "Sensor Hall", value: serie.sensor_hall });
if (serie.sensor_temperatura) interfacesEspeciais.push({ label: isEs ? "Sensor de temperatura" : isEn ? "Temperature Sensor" : "Sensor Temperatura", value: serie.sensor_temperatura });
// Consumo de Energia
const consumoEnergia = [];
@@ -221,7 +288,21 @@ export default async function SerieDetail({ params }) {
'deep_sleep': 'Deep Sleep',
'hibernation': 'Hibernation'
};
const modoLabels = isEn ? modoLabelsEn : modoLabelsPt;
const modoLabelsEs = {
'active': 'Modo activo',
'active_cpu_240mhz': 'Activo (CPU 240MHz)',
'active_cpu_160mhz': 'Activo (CPU 160MHz)',
'active_wifi_tx': 'Activo (Wi-Fi TX)',
'active_wifi_tx_peak': 'Activo (Wi-Fi TX Pico)',
'active_wifi': 'Activo (Wi-Fi)',
'active_wifi6': 'Activo (Wi-Fi 6)',
'modem_sleep': 'Modem Sleep',
'modem_sleep_cpu_160mhz': 'Modem Sleep (CPU 160MHz)',
'light_sleep': 'Light Sleep',
'deep_sleep': 'Deep Sleep',
'hibernation': 'Hibernación'
};
const modoLabels = isEs ? modoLabelsEs : isEn ? modoLabelsEn : modoLabelsPt;
Object.entries(serie.consumo_energia).forEach(([modo, consumo]) => {
consumoEnergia.push({
@@ -234,17 +315,17 @@ export default async function SerieDetail({ params }) {
const tabs = [
{
id: "devboard",
label: isEn ? "Development board" : "Placa de desenvolvimento",
label: isEs ? "Placa de desarrollo" : isEn ? "Development board" : "Placa de desenvolvimento",
available: serie.placa,
content: (
<div className="card p-5 sm:p-7">
<h2 className="text-lg font-semibold text-ink">
{isEn ? "Official development kit" : "Kit de desenvolvimento oficial"}
{isEs ? "Kit de desarrollo oficial" : isEn ? "Official development kit" : "Kit de desenvolvimento oficial"}
</h2>
<div className="mt-5 overflow-hidden rounded-xl border border-line bg-surface-2 p-4">
<Image
src={serie.placa}
alt={isEn ? `Development board ${key}` : `Placa de desenvolvimento ${key}`}
alt={isEs ? `Placa de desarrollo ${key}` : isEn ? `Development board ${key}` : `Placa de desenvolvimento ${key}`}
width={1200}
height={800}
className="mx-auto h-auto max-h-[28rem] w-full rounded-lg object-contain"
@@ -252,7 +333,9 @@ export default async function SerieDetail({ params }) {
/>
</div>
<p className="mt-3 text-sm text-muted">
{isEn ? (
{isEs ? (
<>Placa estándar de Espressif para la serie {key}.</>
) : isEn ? (
<>Official Espressif board for the {key} series.</>
) : (
<>Placa padrão da Espressif para a série {key}.</>
@@ -263,7 +346,7 @@ export default async function SerieDetail({ params }) {
},
{
id: "connections",
label: isEn ? "Pinout diagram" : "Diagrama de conexões",
label: isEs ? "Diagrama de patillaje" : isEn ? "Pinout diagram" : "Diagrama de conexões",
available: conexoes.length > 0,
content: (
<div className="card p-5 sm:p-7">
@@ -271,10 +354,12 @@ export default async function SerieDetail({ params }) {
<AlertTriangle className="mt-0.5 h-5 w-5 shrink-0 text-gold" aria-hidden="true" />
<div>
<p className="font-semibold text-ink">
{isEn ? "This is the chip diagram, not the development board" : "Este é o diagrama do chip, não da placa"}
{isEs ? "Este es el diagrama del chip, no de la placa" : isEn ? "This is the chip diagram, not the development board" : "Este é o diagrama do chip, não da placa"}
</p>
<p className="mt-1">
{isEn ? (
{isEs ? (
`El mapa muestra las conexiones del silicio del ${key}. Cada placa de desarrollo expone solo parte de ellas o las enruta de otra forma.`
) : isEn ? (
`The map shows the silicon connections for the ${key}. Each development board exposes only a subset or routes them differently.`
) : (
<>
@@ -293,10 +378,26 @@ export default async function SerieDetail({ params }) {
<div className="callout mt-8">
<p className="flex items-center gap-2 font-semibold text-ink">
<Lightbulb className="h-4 w-4 text-accent" aria-hidden="true" />
{isEn ? "Almost every pin is reconfigurable" : "Quase todo pino é reconfigurável"}
{isEs ? "Casi todos los pines son reconfigurables" : isEn ? "Almost every pin is reconfigurable" : "Quase todo pino é reconfigurável"}
</p>
<p className="mt-1">
{isEn ? (
{isEs ? (
<>
La matriz de E/S del {key} permite mover buses SPI, I2C, UART, PWM y cámara/pantalla
a la mayoría de los pines digitales. Para las restricciones de strapping y pines analógicos,
consulte la{" "}
<a
href={`https://docs.espressif.com/projects/esp-idf/en/latest/${String(key).toLowerCase().replace("-", "")}/api-reference/peripherals/gpio.html`}
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-1 font-medium text-accent underline decoration-accent/30 underline-offset-2 hover:decoration-accent"
>
guía oficial de GPIO
<ExternalLink className="h-3.5 w-3.5" aria-hidden="true" />
</a>
.
</>
) : isEn ? (
<>
The {key} IO matrix allows moving SPI, I2C, UART, PWM, and camera/display buses
to most digital pins. For strapping restrictions and analog pins, consult the{" "}
@@ -336,42 +437,44 @@ export default async function SerieDetail({ params }) {
];
const secoes = [
{ id: "processador", titulo: isEn ? "Processor" : "Processador", icon: Cpu, specs: processadorSpecs },
{ id: "conectividade", titulo: isEn ? "Connectivity" : "Conectividade", icon: Wifi, specs: conectividadeSpecs },
{ id: "ferramentas", titulo: isEn ? "Tools and availability" : "Ferramentas e disponibilidade", icon: Package, specs: ferramentasSpecs },
{ id: "seguranca", titulo: isEn ? "Security" : "Segurança", icon: ShieldCheck, specs: segurancaSpecs },
{ id: "memoria", titulo: isEn ? "Memory" : "Memória", icon: Database, specs: memoriaSpecs },
{ id: "processador", titulo: isEs ? "Procesador" : isEn ? "Processor" : "Processador", icon: Cpu, specs: processadorSpecs },
{ id: "conectividade", titulo: isEs ? "Conectividad" : isEn ? "Connectivity" : "Conectividade", icon: Wifi, specs: conectividadeSpecs },
{ id: "ferramentas", titulo: isEs ? "Herramientas y disponibilidad" : isEn ? "Tools and availability" : "Ferramentas e disponibilidade", icon: Package, specs: ferramentasSpecs },
{ id: "seguranca", titulo: isEs ? "Seguridad" : isEn ? "Security" : "Segurança", icon: ShieldCheck, specs: segurancaSpecs },
{ id: "memoria", titulo: isEs ? "Memoria" : isEn ? "Memory" : "Memória", icon: Database, specs: memoriaSpecs },
...(consumoEnergia.length > 0
? [{
id: "energia",
titulo: isEn ? "Power consumption" : "Consumo de energia",
titulo: isEs ? "Consumo de energía" : isEn ? "Power consumption" : "Consumo de energia",
icon: Battery,
specs: consumoEnergia,
nota: isEn
nota: isEs
? "Valores típicos a 3,3 V y 25 °C. El consumo real depende del ciclo de trabajo de la radio y de la frecuencia de reloj configurada."
: isEn
? "Typical values at 3.3 V and 25 °C. Actual power consumption depends on radio duty cycle and configured clock frequency."
: "Valores típicos a 3,3 V e 25 °C. O consumo real depende do ciclo de trabalho do rádio e da frequência de clock configurada.",
}]
: []),
{ id: "perifericos", titulo: isEn ? "Peripherals" : "Periféricos", icon: Sliders, specs: perifericos },
{ id: "perifericos", titulo: isEs ? "Periféricos" : isEn ? "Peripherals" : "Periféricos", icon: Sliders, specs: perifericos },
...(interfacesEspeciais.length > 0
? [{ id: "interfaces", titulo: isEn ? "Special interfaces" : "Interfaces especiais", icon: Sliders, specs: interfacesEspeciais }]
? [{ id: "interfaces", titulo: isEs ? "Interfaces especiales" : isEn ? "Special interfaces" : "Interfaces especiais", icon: Sliders, specs: interfacesEspeciais }]
: []),
{
id: "temperatura",
titulo: isEn ? "Temperature limits" : "Limites de temperatura",
titulo: isEs ? "Límites de temperatura" : isEn ? "Temperature limits" : "Limites de temperatura",
icon: Thermometer,
specs: [
{ label: isEn ? "Operating" : "Operação", value: serie.temperatura_operacao },
{ label: isEn ? "Storage" : "Armazenamento", value: serie.temperatura_armazenamento },
{ label: isEs ? "Operación" : isEn ? "Operating" : "Operação", value: serie.temperatura_operacao },
{ label: isEs ? "Almacenamiento" : isEn ? "Storage" : "Armazenamento", value: serie.temperatura_armazenamento },
],
},
];
const fatos = [
{ label: isEn ? "Processor" : "Processador", value: String(serie.nucleos).includes("2") ? "Dual-core" : "Single-core", detail: serie.frequencia },
{ label: "SRAM", value: serie.memoria_sram, detail: isEn ? `+ ${serie.memoria_sram_rtc} RTC SRAM` : `+ ${serie.memoria_sram_rtc} de SRAM RTC` },
{ label: "GPIO", value: serie.gpio, detail: isEn ? "programmable pins" : "pinos programáveis" },
{ label: isEn ? "Architecture" : "Arquitetura", value: String(serie.arquitetura).includes("RISC-V") ? "RISC-V" : "Xtensa", detail: serie.arquitetura },
{ label: isEs ? "Procesador" : isEn ? "Processor" : "Processador", value: String(serie.nucleos).includes("2") ? "Dual-core" : "Single-core", detail: serie.frequencia },
{ label: "SRAM", value: serie.memoria_sram, detail: isEs ? `+ ${serie.memoria_sram_rtc} de SRAM RTC` : isEn ? `+ ${serie.memoria_sram_rtc} RTC SRAM` : `+ ${serie.memoria_sram_rtc} de SRAM RTC` },
{ label: "GPIO", value: serie.gpio, detail: isEs ? "pines programables" : isEn ? "programmable pins" : "pinos programáveis" },
{ label: isEs ? "Arquitectura" : isEn ? "Architecture" : "Arquitetura", value: String(serie.arquitetura).includes("RISC-V") ? "RISC-V" : "Xtensa", detail: serie.arquitetura },
];
return (
@@ -384,8 +487,8 @@ export default async function SerieDetail({ params }) {
type="application/ld+json"
dangerouslySetInnerHTML={{
__html: JSON.stringify(jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "Series" : "Séries", caminho: getLocalizedHref("/series", currentLocale) },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEn ? "/en" : isEs ? "/es" : "/" },
{ nome: isEs ? "Series" : isEn ? "Series" : "Séries", caminho: getLocalizedHref("/series", currentLocale) },
{ nome: serie.nome_completo, caminho: getLocalizedHref(`/series/${key}`, currentLocale) },
])),
}}
@@ -396,7 +499,8 @@ export default async function SerieDetail({ params }) {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Series" : "Séries", href: getLocalizedHref("/series", currentLocale) }, { label: key }]}
isEs={isEs}
trail={[{ label: isEs ? "Series" : isEn ? "Series" : "Séries", href: getLocalizedHref("/series", currentLocale) }, { label: key }]}
icon={Cpu}
label={serie.arquitetura}
title={key}
@@ -405,32 +509,32 @@ export default async function SerieDetail({ params }) {
{serie.datasheet ? (
<a href={serie.datasheet} target="_blank" rel="noopener noreferrer" className="btn btn-primary">
<FileText className="h-4 w-4" aria-hidden="true" />
{isEn ? "Official datasheet" : "Datasheet oficial"}
{isEs ? "Datasheet oficial" : isEn ? "Official datasheet" : "Datasheet oficial"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
) : (
<span className="btn btn-ghost cursor-not-allowed opacity-70" aria-disabled="true">
<FileText className="h-4 w-4" aria-hidden="true" />
{isEn ? "Datasheet not yet published" : "Datasheet ainda não publicado"}
{isEs ? "Datasheet aún no publicado" : isEn ? "Datasheet not yet published" : "Datasheet ainda não publicado"}
</span>
)}
{serie.guia_de_programacao && (
<a href={serie.guia_de_programacao} target="_blank" rel="noopener noreferrer" className="btn btn-ghost">
<Code className="h-4 w-4" aria-hidden="true" />
{isEn ? "Programming guide" : "Guia de programação"}
{isEs ? "Guía de programación" : isEn ? "Programming guide" : "Guia de programação"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
)}
{serie.manual_tecnico && (
<a href={serie.manual_tecnico} target="_blank" rel="noopener noreferrer" className="btn btn-ghost">
<BookOpen className="h-4 w-4" aria-hidden="true" />
{isEn ? "Technical reference manual" : "Manual técnico"}
{isEs ? "Manual de referencia técnica" : isEn ? "Technical reference manual" : "Manual técnico"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
)}
</PageHero>
<section className="shell mt-10" aria-label={isEn ? "Summary" : "Resumo"}>
<section className="shell mt-10" aria-label={isEs ? "Resumen" : isEn ? "Summary" : "Resumo"}>
<dl className="grid grid-cols-2 gap-3 lg:grid-cols-4">
{fatos.map((fato) => (
<div key={fato.label} className="tile">
@@ -446,7 +550,7 @@ export default async function SerieDetail({ params }) {
<AlertTriangle className="mt-0.5 h-5 w-5 shrink-0 text-gold" aria-hidden="true" />
<div>
<p className="font-semibold text-ink">
{isEn ? "Preliminary documentation" : "Documentação preliminar"}
{isEs ? "Documentación preliminar" : isEn ? "Preliminary documentation" : "Documentação preliminar"}
</p>
<p className="mt-1">{serie.status_documentacao}</p>
</div>
@@ -455,13 +559,13 @@ export default async function SerieDetail({ params }) {
</section>
<div className="shell mt-10">
<SeriesTabMenu tabs={tabs} isEn={isEn} />
<PinRestrictions conexoes={conexoes} serieKey={key} isEn={isEn} />
<SeriesTabMenu tabs={tabs} isEn={isEn} isEs={isEs} />
<PinRestrictions conexoes={conexoes} serieKey={key} isEn={isEn} isEs={isEs} />
</div>
<div className="shell mt-12">
<nav
aria-label={isEn ? "Datasheet sections" : "Seções da ficha"}
aria-label={isEs ? "Secciones de la ficha" : isEn ? "Datasheet sections" : "Seções da ficha"}
className="nav-pill no-scrollbar sticky top-20 z-30 flex gap-1 overflow-x-auto rounded-full p-1.5"
>
{secoes.map((secao) => (
@@ -482,30 +586,34 @@ export default async function SerieDetail({ params }) {
<div className="panel flex flex-col items-start justify-between gap-6 p-7 sm:p-10 md:flex-row md:items-center">
<div className="max-w-2xl">
<h2 className="section-title">
{isEn ? (
{isEs ? (
<>¿Listo para prototipar con {key}?</>
) : isEn ? (
<>Ready to prototype with {key}?</>
) : (
<>Pronto para prototipar o {key}?</>
)}
</h2>
<p className="mt-3 text-base text-muted">
{isEn
{isEs
? "Explore las placas de desarrollo disponibles para esta serie, con USB, sensores integrados y enlaces a la tienda oficial."
: isEn
? "Explore development boards available for this series, with USB, onboard sensors, and official store links."
: "Veja as placas de desenvolvimento disponíveis para a série, com USB, sensores integrados e link para a loja oficial."}
</p>
</div>
<Link href={getLocalizedHref("/catalogo", currentLocale)} className="btn btn-primary shrink-0">
{isEn ? "View boards" : "Ver placas"}
{isEs ? "Ver placas" : isEn ? "View boards" : "Ver placas"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
<nav aria-label={isEn ? "Other series" : "Outras séries"} className="mt-6 grid gap-3 sm:grid-cols-[1fr_auto_1fr] sm:items-center">
<nav aria-label={isEs ? "Otras series" : isEn ? "Other series" : "Outras séries"} className="mt-6 grid gap-3 sm:grid-cols-[1fr_auto_1fr] sm:items-center">
{previousKey ? (
<Link href={getLocalizedHref(`/series/${previousKey}`, currentLocale)} className="card card-interactive group flex items-center gap-3 px-5 py-4">
<ArrowLeft className="h-4 w-4 text-muted transition-transform group-hover:-translate-x-1" aria-hidden="true" />
<span>
<span className="block text-xs text-muted">{isEn ? "Previous series" : "Série anterior"}</span>
<span className="block text-xs text-muted">{isEs ? "Serie anterior" : isEn ? "Previous series" : "Série anterior"}</span>
<span className="block font-display text-lg font-semibold text-ink">{previousKey}</span>
</span>
</Link>
@@ -514,12 +622,12 @@ export default async function SerieDetail({ params }) {
)}
<Link href={getLocalizedHref("/comparacao", currentLocale)} className="btn btn-ghost justify-self-center">
<Scale className="h-4 w-4" aria-hidden="true" />
{isEn ? "Compare series" : "Comparar séries"}
{isEs ? "Comparar series" : isEn ? "Compare series" : "Comparar séries"}
</Link>
{nextKey ? (
<Link href={getLocalizedHref(`/series/${nextKey}`, currentLocale)} className="card card-interactive group flex items-center justify-end gap-3 px-5 py-4 text-right">
<span>
<span className="block text-xs text-muted">{isEn ? "Next series" : "Próxima série"}</span>
<span className="block text-xs text-muted">{isEs ? "Siguiente serie" : isEn ? "Next series" : "Próxima série"}</span>
<span className="block font-display text-lg font-semibold text-ink">{nextKey}</span>
</span>
<ArrowRight className="h-4 w-4 text-muted transition-transform group-hover:translate-x-1" aria-hidden="true" />
@@ -564,12 +672,13 @@ function SpecSection({ id, titulo, icon: Icon, specs, nota }) {
export async function generateMetadata({ params }) {
const { locale, key } = await params;
const isEn = locale === "en";
const currentLocale = isEn ? "en" : "pt";
const seriesData = isEn ? seriesDataEn : seriesDataPt;
const isEs = locale === "es";
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const seriesData = isEs ? seriesDataEs : isEn ? seriesDataEn : seriesDataPt;
const serie = seriesData[key];
if (!serie) {
return { title: isEn ? "Series not found" : "Série não encontrada", robots: { index: false, follow: false } };
return { title: isEs ? "Serie no encontrada" : isEn ? "Series not found" : "Série não encontrada", robots: { index: false, follow: false } };
}
const radio = [
@@ -578,7 +687,12 @@ export async function generateMetadata({ params }) {
serie.zigbee_thread && !String(serie.zigbee_thread).startsWith("Não") && !String(serie.zigbee_thread).startsWith("No") ? "802.15.4" : null,
].filter(Boolean).join(", ");
const descricao = isEn
const descricao = isEs
? `${serie.nome_completo}: ${serie.arquitetura}, ${serie.frequencia}, ` +
`${serie.memoria_sram} de SRAM y ${serie.gpio} GPIO` +
(radio ? `. Radio: ${radio}` : "") +
`. Patillaje completo, periféricos, seguridad por hardware y pines restringidos, en español.`
: isEn
? `${serie.nome_completo}: ${serie.arquitetura}, ${serie.frequencia}, ` +
`${serie.memoria_sram} SRAM, and ${serie.gpio} GPIOs` +
(radio ? `. Radio: ${radio}` : "") +
@@ -589,10 +703,16 @@ export async function generateMetadata({ params }) {
`. Pinagem completa, periféricos, segurança em hardware e pinos com restrição, em português.`;
const imagem = serie.placa
? [{ url: serie.placa, width: 1600, height: 1091, alt: isEn ? `Pinout of ${serie.nome_completo}` : `Pinagem do ${serie.nome_completo}` }]
? [{ url: serie.placa, width: 1600, height: 1091, alt: isEs ? `Patillaje de ${serie.nome_completo}` : isEn ? `Pinout of ${serie.nome_completo}` : `Pinagem do ${serie.nome_completo}` }]
: [{ url: "/opengraph-image.png", width: 1200, height: 630, alt: "ESPDocs" }];
const keywords = isEn
const keywords = isEs
? [
serie.nome_completo, `${serie.nome_completo} pinout`, `${serie.nome_completo} patillaje`,
`${serie.nome_completo} datasheet`, `${serie.nome_completo} especificaciones`,
`${serie.nome_completo} español`, "ESP32", "Espressif", "microcontrolador",
]
: isEn
? [
serie.nome_completo, `${serie.nome_completo} pinout`,
`${serie.nome_completo} datasheet`, `${serie.nome_completo} specifications`,
@@ -606,14 +726,14 @@ export async function generateMetadata({ params }) {
const meta = {
...paginaMeta({
titulo: isEn ? `${serie.nome_completo}: specifications and pinout` : `${serie.nome_completo}: especificações e pinagem`,
titulo: isEs ? `${serie.nome_completo}: especificaciones y patillaje` : isEn ? `${serie.nome_completo}: specifications and pinout` : `${serie.nome_completo}: especificações e pinagem`,
descricao,
caminho: `/series/${key}`,
tipo: "article",
locale: currentLocale,
keywords,
}),
other: { "article:section": isEn ? "ESP32 Series" : "Séries ESP32" },
other: { "article:section": isEs ? "Series ESP32" : isEn ? "ESP32 Series" : "Séries ESP32" },
};
meta.openGraph = { ...meta.openGraph, images: imagem };
+24 -7
View File
@@ -3,19 +3,24 @@ import { paginaMeta, jsonLd } from "@/lib/seo";
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
const meta = paginaMeta({
titulo: isEn ? "ESP32 Series: Technical Guide and Pinouts" : "Séries ESP32",
descricao: isEn
titulo: isEs ? "Series ESP32: Guía técnica y patillaje" : isEn ? "ESP32 Series: Technical Guide and Pinouts" : "Séries ESP32",
descricao: isEs
? "Las 12 series de ESP32 lado a lado: ESP32, S2, S3, S31, C2, C3, C5, C6, C61, P4, H2 y H4. Arquitectura, memoria, radio, periféricos y patillaje de cada una."
: isEn
? "All 12 ESP32 series side by side: ESP32, S2, S3, S31, C2, C3, C5, C6, C61, P4, H2 and H4. Architecture, memory, radio, peripherals and pinouts for each one."
: "As 12 séries de ESP32 lado a lado: ESP32, S2, S3, S31, C2, C3, C5, C6, C61, P4, H2 e H4. Arquitetura, memória, rádio, periféricos e pinagem de cada uma, em português.",
caminho: "/series",
locale,
keywords: isEn
keywords: isEs
? ["series ESP32", "modelos de ESP32", "ESP32 S3", "ESP32 C6", "ESP32 P4", "diferencia entre ESP32"]
: isEn
? ["ESP32 series", "ESP32 models", "ESP32 S3", "ESP32 C6", "ESP32 P4", "difference between ESP32"]
: ["séries ESP32", "modelos de ESP32", "ESP32 S3", "ESP32 C6", "ESP32 P4", "diferença entre ESP32"],
});
meta.title = {
default: isEn ? "ESP32 Series" : "Séries ESP32",
default: isEs ? "Series ESP32" : isEn ? "ESP32 Series" : "Séries ESP32",
template: "%s · ESPDocs",
};
return meta;
@@ -43,10 +48,22 @@ const faqsEn = [
},
];
const faqsEs = [
{
pergunta: "¿Cuántas series de ESP32 existen actualmente?",
resposta: "Actualmente, el ecosistema de Espressif cuenta con 12 series principales: ESP32 clásico, ESP32-S2, ESP32-S3, ESP32-S31, ESP32-C2, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-C61, ESP32-P4, ESP32-H2 y ESP32-H4.",
},
{
pergunta: "¿Cuáles son las series más recientes de Espressif?",
resposta: "Las series más recientes incluyen el ESP32-P4 (enfocado en alto rendimiento con dual-core RISC-V a 400 MHz), el ESP32-C5 (primer chip con Wi-Fi de doble banda 2.4/5 GHz de Espressif) y el ESP32-C61 (Wi-Fi 6 y Bluetooth 6 de bajo costo).",
},
];
export default async function Layout({ children, params }) {
const { locale } = await params;
const isEn = locale === "en";
const faqs = isEn ? faqsEn : faqsPt;
const isEs = locale === "es";
const faqs = isEs ? faqsEs : isEn ? faqsEn : faqsPt;
return (
<>
@@ -55,8 +72,8 @@ export default async function Layout({ children, params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isEn ? "Home" : "Início", caminho: isEn ? "/en" : "/" },
{ nome: isEn ? "ESP32 Series" : "Séries ESP32", caminho: isEn ? "/en/series" : "/series" },
{ nome: isEs ? "Inicio" : isEn ? "Home" : "Início", caminho: isEs ? "/es" : isEn ? "/en" : "/" },
{ nome: isEs ? "Series ESP32" : isEn ? "ESP32 Series" : "Séries ESP32", caminho: isEs ? "/es/series" : isEn ? "/en/series" : "/series" },
])
),
}}
+51 -26
View File
@@ -8,6 +8,7 @@ import PageHero from "@/components/PageHero";
import Link from "next/link";
import seriesDataPt from "@/public/series.json";
import seriesDataEn from "@/data/en/series.json";
import seriesDataEs from "@/data/es/series.json";
import { getLocalizedHref } from "@/i18n/links";
import {
AlertTriangle,
@@ -36,29 +37,39 @@ const FILTROS_EN = [
{ id: "ia", rotulo: "AI Acceleration", testa: (s) => Boolean(s.aceleradores_ia) },
];
const FILTROS_ES = [
{ id: "todas", rotulo: "Todas", testa: () => true },
{ id: "riscv", rotulo: "RISC-V", testa: (s) => s.arquitetura.includes("RISC-V") },
{ id: "xtensa", rotulo: "Xtensa", testa: (s) => !s.arquitetura.includes("RISC-V") },
{ id: "matter", rotulo: "Matter", testa: (s) => s.matter === "Yes" || s.matter === "Sim" || s.matter === "Sí" },
{ id: "ia", rotulo: "Aceleración de IA", testa: (s) => Boolean(s.aceleradores_ia) },
];
/** Marcador de segurança: o recurso que diferencia a série, não o que todas têm. */
function nivelSeguranca(serie, isEn) {
function nivelSeguranca(serie, isEn, isEs) {
const seg = serie.seguranca || {};
if (seg.key_manager === "Sim" || seg.key_manager === "Yes") return "Key Manager";
if (String(seg.ecdsa).startsWith("Sim") || String(seg.ecdsa).startsWith("Yes")) {
return isEn ? "Hardware ECDSA" : "ECDSA em hardware";
if (seg.key_manager === "Sim" || seg.key_manager === "Yes" || seg.key_manager === "Sí") return "Key Manager";
if (String(seg.ecdsa).startsWith("Sim") || String(seg.ecdsa).startsWith("Yes") || String(seg.ecdsa).startsWith("Sí")) {
return isEs ? "ECDSA en hardware" : isEn ? "Hardware ECDSA" : "ECDSA em hardware";
}
if (String(seg.ecc).startsWith("Sim") || String(seg.ecc).startsWith("Yes")) {
return isEn ? "Hardware ECC" : "ECC em hardware";
if (String(seg.ecc).startsWith("Sim") || String(seg.ecc).startsWith("Yes") || String(seg.ecc).startsWith("Sí")) {
return isEs ? "ECC en hardware" : isEn ? "Hardware ECC" : "ECC em hardware";
}
if (String(seg.aes).startsWith("AES")) return "AES + SHA";
return isEn ? "SHA only" : "Só SHA";
return isEs ? "Solo SHA" : isEn ? "SHA only" : "Só SHA";
}
const simPt = (v) => !String(v).includes("Não");
const simEn = (v) => !String(v).includes("No") && !String(v).includes("Não");
const simEs = (v) => !String(v).includes("No") && !String(v).includes("Não");
export default function Series() {
const pathname = usePathname();
const isEn = pathname?.startsWith("/en");
const currentLocale = isEn ? "en" : "pt";
const seriesData = isEn ? seriesDataEn : seriesDataPt;
const filtros = isEn ? FILTROS_EN : FILTROS_PT;
const isEs = pathname?.startsWith("/es");
const currentLocale = isEs ? "es" : isEn ? "en" : "pt";
const seriesData = isEs ? seriesDataEs : isEn ? seriesDataEn : seriesDataPt;
const filtros = isEs ? FILTROS_ES : isEn ? FILTROS_EN : FILTROS_PT;
const [filtro, setFiltro] = useState("todas");
const todas = Object.entries(seriesData);
@@ -72,19 +83,22 @@ export default function Series() {
<main id="conteudo">
<PageHero
isEn={isEn}
trail={[{ label: isEn ? "Series" : "Séries" }]}
isEs={isEs}
trail={[{ label: isEs ? "Series" : isEn ? "Series" : "Séries" }]}
icon={Compass}
label={isEn ? `${todas.length} Espressif families` : `${todas.length} famílias da Espressif`}
title={isEn ? "ESP32 Series" : "Séries ESP32"}
label={isEs ? `${todas.length} familias de Espressif` : isEn ? `${todas.length} Espressif families` : `${todas.length} famílias da Espressif`}
title={isEs ? "Series ESP32" : isEn ? "ESP32 Series" : "Séries ESP32"}
lede={
isEn
isEs
? "Cada serie fue diseñada para un tipo de proyecto específico, desde sensores a batería hasta aceleradores de IA. Abra la ficha para ver patillaje, periféricos y seguridad."
: isEn
? "Each series was designed for a specific project type, from battery-powered sensors to AI accelerators. Open the sheet to see pinout, peripherals, and security."
: "Cada série foi desenhada para um tipo de projeto, do sensor a bateria ao acelerador de IA. Abra a ficha para ver pinagem, periféricos e segurança."
}
/>
<section className="shell pt-10 sm:pt-12" aria-label={isEn ? "Series list" : "Lista de séries"}>
<div role="group" aria-label={isEn ? "Filter series" : "Filtrar séries"} className="flex flex-wrap gap-2">
<section className="shell pt-10 sm:pt-12" aria-label={isEs ? "Lista de series" : isEn ? "Series list" : "Lista de séries"}>
<div role="group" aria-label={isEs ? "Filtrar series" : isEn ? "Filter series" : "Filtrar séries"} className="flex flex-wrap gap-2">
{filtros.map((f) => (
<button key={f.id} type="button" aria-pressed={filtro === f.id} onClick={() => setFiltro(f.id)} className="chip-btn">
{f.rotulo}
@@ -92,13 +106,22 @@ export default function Series() {
))}
</div>
<p role="status" aria-live="polite" className="mt-4 text-sm text-muted">
{series.length} {series.length === 1 ? (isEn ? "series" : "série") : (isEn ? "series" : "séries")}
{series.length} {series.length === 1 ? (isEs ? "serie" : isEn ? "series" : "série") : (isEs ? "series" : isEn ? "series" : "séries")}
</p>
<div className="mt-4 grid gap-4 md:grid-cols-2 lg:grid-cols-3">
{series.map(([key, serie]) => {
const riscv = serie.arquitetura.includes("RISC-V");
const fatos = isEn
const fatos = isEs
? [
["Núcleos", serie.nucleos],
["Frecuencia", serie.frequencia],
["SRAM", serie.memoria_sram],
["Wi-Fi", simEs(serie.wifi) ? "Sí" : "No"],
["Bluetooth", String(serie.bluetooth).includes("No") || String(serie.bluetooth).includes("Não") ? "No" : "Sí"],
serie.consumo_energia?.deep_sleep ? ["Deep sleep", serie.consumo_energia.deep_sleep] : null,
].filter(Boolean)
: isEn
? [
["Cores", serie.nucleos],
["Frequency", serie.frequencia],
@@ -136,14 +159,14 @@ export default function Series() {
{serie.aceleradores_ia && (
<li className="chip chip-accent">
<Sparkles className="h-3 w-3" aria-hidden="true" />
{isEn ? "AI Accelerators" : "Aceleradores de IA"}
{isEs ? "Aceleradores de IA" : isEn ? "AI Accelerators" : "Aceleradores de IA"}
</li>
)}
<li className="chip">
<ShieldCheck className="h-3 w-3 text-accent" aria-hidden="true" />
{nivelSeguranca(serie, isEn)}
{nivelSeguranca(serie, isEn, isEs)}
</li>
{(serie.matter === "Sim" || serie.matter === "Yes") && (
{(serie.matter === "Sim" || serie.matter === "Yes" || serie.matter === "Sí") && (
<li className="chip">
<Home className="h-3 w-3 text-accent" aria-hidden="true" />
Matter
@@ -152,13 +175,13 @@ export default function Series() {
{serie.status_documentacao && (
<li className="chip">
<AlertTriangle className="h-3 w-3 text-gold" aria-hidden="true" />
{isEn ? "Preliminary documentation" : "Documentação preliminar"}
{isEs ? "Documentación preliminar" : isEn ? "Preliminary documentation" : "Documentação preliminar"}
</li>
)}
</ul>
<span className="mt-5 inline-flex items-center gap-1 text-sm font-medium text-accent">
{isEn ? "Open datasheet" : "Abrir ficha"}
{isEs ? "Abrir ficha" : isEn ? "Open datasheet" : "Abrir ficha"}
<ArrowUpRight className="h-4 w-4 transition-transform group-hover:-translate-y-0.5 group-hover:translate-x-0.5" aria-hidden="true" />
</span>
</Link>
@@ -171,17 +194,19 @@ export default function Series() {
<div className="panel flex flex-col items-start justify-between gap-6 p-7 sm:p-10 md:flex-row md:items-center">
<div className="max-w-2xl">
<h2 className="section-title">
{isEn ? "Unsure between two series?" : "Ficou em dúvida entre duas séries?"}
{isEs ? "¿Tiene dudas entre dos series?" : isEn ? "Unsure between two series?" : "Ficou em dúvida entre duas séries?"}
</h2>
<p className="mt-3 text-base text-muted">
{isEn
{isEs
? "El comparador coloca hasta cuatro modelos lado a lado: núcleos, radio, memoria, periféricos y seguridad."
: isEn
? "The comparator tool puts up to four models side by side: cores, radio, memory, peripherals, and security."
: "O comparador coloca até quatro modelos lado a lado: núcleos, rádio, memória, periféricos e segurança."}
</p>
</div>
<Link href={getLocalizedHref("/comparacao", currentLocale)} className="btn btn-primary shrink-0">
<Scale className="h-4 w-4" aria-hidden="true" />
{isEn ? "Compare series" : "Comparar séries"}
{isEs ? "Comparar series" : isEn ? "Compare series" : "Comparar séries"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
+69 -27
View File
@@ -11,13 +11,18 @@ const REPOSITORIO = SITE.repositorio;
export async function generateMetadata({ params }) {
const { locale } = await params;
const isEn = locale === "en";
const isEs = locale === "es";
return paginaMeta({
titulo: isEn ? "About the Project" : "Sobre o projeto",
descricao: isEn
titulo: isEs ? "Acerca del proyecto" : isEn ? "About the Project" : "Sobre o projeto",
descricao: isEs
? "ESPDocs es una plataforma independiente que organiza la documentación técnica del ecosistema ESP32. Conozca el proyecto y cómo contribuir."
: isEn
? "ESPDocs is an independent platform organizing technical documentation of the ESP32 ecosystem. Learn about the project and how to contribute."
: "O ESPDocs é uma plataforma independente que reúne a documentação do ecossistema ESP32 em português brasileiro. Saiba como o projeto nasceu e como contribuir.",
caminho: "/sobre",
keywords: isEn
keywords: isEs
? ["ESPDocs", "documentación ESP32", "proyecto open source ESP32", "código abierto"]
: isEn
? ["ESPDocs", "ESP32 documentation", "open source ESP32 project"]
: ["ESPDocs", "documentação ESP32 português", "projeto open source ESP32"],
locale,
@@ -27,6 +32,8 @@ export async function generateMetadata({ params }) {
export default async function Sobre({ params }) {
const { locale } = await params;
const isPt = locale === "pt";
const isEn = locale === "en";
const isEs = locale === "es";
const featuresPt = [
{ icon: Languages, title: "Em português", desc: "Dados técnicos organizados e apresentados em português do Brasil." },
@@ -42,7 +49,14 @@ export default async function Sobre({ params }) {
{ icon: Code, title: "Open source", desc: "Contributions are welcome on Gitea." },
];
const features = isPt ? featuresPt : featuresEn;
const featuresEs = [
{ icon: Languages, title: "En español", desc: "Datos técnicos organizados y presentados de forma clara en español neutro." },
{ icon: GitCompare, title: "Comparaciones visuales", desc: "Tablas y diagramas para elegir la serie adecuada sin abrir diez hojas de datos." },
{ icon: Globe, title: "Acceso centralizado", desc: "Enlaces directos a la documentación oficial, repositorios y ejemplos." },
{ icon: Code, title: "Código abierto", desc: "Las contribuciones son bienvenidas en Gitea." },
];
const features = isEs ? featuresEs : isEn ? featuresEn : featuresPt;
return (
<div className="site-canvas min-h-screen">
@@ -56,8 +70,8 @@ export default async function Sobre({ params }) {
dangerouslySetInnerHTML={{
__html: JSON.stringify(
jsonLd.trilha([
{ nome: isPt ? "Início" : "Home", caminho: isPt ? "/" : "/en" },
{ nome: isPt ? "Sobre o Projeto" : "About the Project", caminho: isPt ? "/sobre" : "/en/about" },
{ nome: isEs ? "Inicio" : isPt ? "Início" : "Home", caminho: isEn ? "/en" : isEs ? "/es" : "/" },
{ nome: isEs ? "Acerca del proyecto" : isPt ? "Sobre o Projeto" : "About the Project", caminho: isEn ? "/en/about" : isEs ? "/es/acerca" : "/sobre" },
])
),
}}
@@ -67,20 +81,23 @@ export default async function Sobre({ params }) {
<main id="conteudo">
<PageHero
isEn={!isPt}
trail={[{ label: isPt ? "Sobre" : "About" }]}
isEn={isEn}
isEs={isEs}
trail={[{ label: isEs ? "Acerca" : isPt ? "Sobre" : "About" }]}
icon={Info}
label={isPt ? "Projeto independente" : "Independent project"}
title={isPt ? "Sobre o ESPDocs" : "About ESPDocs"}
label={isEs ? "Proyecto independiente" : isPt ? "Projeto independente" : "Independent project"}
title={isEs ? "Acerca de ESPDocs" : isPt ? "Sobre o ESPDocs" : "About ESPDocs"}
lede={
isPt
isEs
? "Una plataforma no oficial, en español, que organiza la información técnica del ESP32 y le conecta con la documentación oficial de Espressif. Creada para la comunidad de hardware abierto."
: isPt
? "Uma plataforma não oficial, em português, que organiza as informações técnicas do ESP32 e leva você à documentação oficial da Espressif. Feita para a comunidade de hardware livre."
: "An unofficial platform organizing technical information about the ESP32 and linking directly to official Espressif documentation. Built for the open hardware community."
}
>
<a href={REPOSITORIO} target="_blank" rel="noopener noreferrer" className="btn btn-primary">
<GiteaMark className="h-4 w-4" />
{isPt ? "Ver o repositório" : "View repository"}
{isEs ? "Ver el repositorio" : isPt ? "Ver o repositório" : "View repository"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
</PageHero>
@@ -88,18 +105,22 @@ export default async function Sobre({ params }) {
<div className="shell section grid grid-cols-1 gap-10 pt-12 sm:pt-16 lg:grid-cols-[1fr_22rem] lg:gap-14">
<div className="min-w-0 max-w-3xl space-y-12">
<section aria-labelledby="missao">
<h2 id="missao" className="section-title">{isPt ? "Missão" : "Mission"}</h2>
<h2 id="missao" className="section-title">{isEs ? "Misión" : isPt ? "Missão" : "Mission"}</h2>
<p className="mt-4 text-base leading-relaxed text-muted">
{isPt
{isEs
? "Facilitar el acceso y la comprensión del ecosistema ESP32 con una interfaz en español que organiza especificaciones, compara series, presenta frameworks y centraliza los enlaces a la documentación oficial. El objetivo es ahorrar tiempo en el desarrollo de firmware e IoT."
: isPt
? "Facilitar o acesso e a compreensão do ecossistema ESP32 com uma interface em português que organiza especificações, compara séries, apresenta frameworks e centraliza os links da documentação oficial. O objetivo é economizar o seu tempo no desenvolvimento de firmware e IoT."
: "Facilitate access and understanding of the ESP32 ecosystem with an interface organizing specifications, comparing series, presenting frameworks and centralizing links to official documentation. The goal is to save development time in firmware and IoT projects."}
</p>
</section>
<section aria-labelledby="porque">
<h2 id="porque" className="section-title">{isPt ? "Por que o ESPDocs existe" : "Why ESPDocs exists"}</h2>
<h2 id="porque" className="section-title">{isEs ? "¿Por qué existe ESPDocs?" : isPt ? "Por que o ESPDocs existe" : "Why ESPDocs exists"}</h2>
<p className="mt-4 text-base leading-relaxed text-muted">
{isPt
{isEs
? "La información sobre el ESP32 suele estar dispersa entre hojas de datos densas, manuales de referencia técnica (TRM) y repositorios secundarios. ESPDocs condensa y estructura estos datos para una evaluación rápida antes de profundizar en la ingeniería oficial."
: isPt
? "As informações sobre os ESP32 costumam estar espalhadas entre datasheets densos, manuais de referência (TRM) e repositórios secundários, tudo em inglês. O ESPDocs condensa e estrutura esses dados para a triagem rápida, antes de você aprofundar na engenharia oficial."
: "Information regarding the ESP32 is often scattered across dense datasheets, Technical Reference Manuals (TRM), and secondary repositories. ESPDocs condenses and structures this data for rapid evaluation before diving into in-depth engineering documentation."}
</p>
@@ -119,14 +140,22 @@ export default async function Sobre({ params }) {
</section>
<section aria-labelledby="contribuir">
<h2 id="contribuir" className="section-title">{isPt ? "Como contribuir" : "How to contribute"}</h2>
<h2 id="contribuir" className="section-title">{isEs ? "Cómo contribuir" : isPt ? "Como contribuir" : "How to contribute"}</h2>
<p className="mt-4 text-base leading-relaxed text-muted">
{isPt
{isEs
? "Las correcciones de traducción, ajustes en tablas y nuevos ejemplos de código son muy bienvenidos. El proyecto crece junto con la comunidad."
: isPt
? "Correções de tradução, ajustes em tabelas e novos exemplos de código são muito bem-vindos. O projeto cresce com a comunidade."
: "Translation fixes, table refinements and new code examples are welcome. The project grows with the community."}
</p>
<ol className="mt-6 space-y-3">
{(isPt
{(isEs
? [
"Haga un fork del repositorio en Gitea.",
"Implemente las mejoras y verifique las referencias técnicas oficiales.",
"Abra una solicitud de extracción (Pull Request) describiendo los cambios realizados.",
]
: isPt
? [
"Faça o fork do repositório no Gitea.",
"Implemente as melhorias e confira as referências técnicas oficiais.",
@@ -149,16 +178,18 @@ export default async function Sobre({ params }) {
</section>
<section aria-labelledby="acessibilidade">
<h2 id="acessibilidade" className="section-title">{isPt ? "Acessibilidade" : "Accessibility"}</h2>
<h2 id="acessibilidade" className="section-title">{isEs ? "Accesibilidad" : isPt ? "Acessibilidade" : "Accessibility"}</h2>
<p className="mt-4 text-base leading-relaxed text-muted">
{isPt
{isEs
? "ESPDocs prioriza la legibilidad, el alto contraste (nivel AAA de WCAG) y la navegación completa por teclado. Si encuentra alguna barrera de lectura o navegación, abra un issue en el repositorio."
: isPt
? "O ESPDocs prioriza a legibilidade, o contraste alto (nível AAA da WCAG) e a navegação completa por teclado. Se encontrar alguma barreira de leitura ou navegação, abra uma issue no repositório."
: "ESPDocs prioritizes readability, high contrast (WCAG AAA level), and full keyboard navigation. If you encounter any accessibility or navigation hurdles, please open an issue in the repository."}
</p>
</section>
</div>
<aside className="space-y-5 lg:sticky lg:top-28 lg:self-start" aria-label={isPt ? "Autor e aviso legal" : "Author and legal notice"}>
<aside className="space-y-5 lg:sticky lg:top-28 lg:self-start" aria-label={isEs ? "Autor y aviso legal" : isPt ? "Autor e aviso legal" : "Author and legal notice"}>
<div className="panel p-6 sm:p-7">
<div className="flex items-center gap-4">
<span className="grid h-16 w-16 shrink-0 place-items-center rounded-2xl border border-line bg-white">
@@ -166,11 +197,20 @@ export default async function Sobre({ params }) {
</span>
<div>
<h2 className="font-display text-lg font-semibold text-ink">Lucas Rayan Guerra</h2>
<p className="text-sm text-muted">{isPt ? "Criador do Ciência Embarcada" : "Creator of Ciência Embarcada"}</p>
<p className="text-sm text-muted">{isEs ? "Creador de Ciência Embarcada" : isPt ? "Criador do Ciência Embarcada" : "Creator of Ciência Embarcada"}</p>
</div>
</div>
<div className="mt-5 space-y-3 text-sm leading-relaxed text-muted">
{isPt ? (
{isEs ? (
<>
<p>
Técnico en Desarrollo de Sistemas, estudiante de Ciencias de la Computación en la UFRPE e investigador en Blockchain y Criptografía.
</p>
<p>
Director de Software en Semine AgriTech y ponente en eventos como REC&apos;n&apos;Play, compartiendo contenido sobre hardware, IoT y ciberseguridad.
</p>
</>
) : isPt ? (
<>
<p>
Técnico em Desenvolvimento de Sistemas, estudante de Ciência da Computação na UFRPE e pesquisador de
@@ -193,15 +233,17 @@ export default async function Sobre({ params }) {
)}
</div>
<a href="https://cienciaembarcada.com.br" target="_blank" rel="noopener noreferrer" className="btn btn-ghost mt-6 w-full">
{isPt ? "Visitar o Ciência Embarcada" : "Visit Ciência Embarcada"}
{isEs ? "Visitar Ciência Embarcada" : isPt ? "Visitar o Ciência Embarcada" : "Visit Ciência Embarcada"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
</a>
</div>
<div className="callout callout-warn">
<p className="font-semibold text-ink">{isPt ? "Aviso legal" : "Legal notice"}</p>
<p className="font-semibold text-ink">{isEs ? "Aviso legal" : isPt ? "Aviso legal" : "Legal notice"}</p>
<p className="mt-1">
{isPt
{isEs
? "ESPDocs es un agregador y organizador. Los manuales y repositorios referenciados pertenecen a Espressif Systems. En proyectos críticos o comerciales, consulte siempre la documentación oficial."
: isPt
? "O ESPDocs é um agregador e organizador. Os manuais e repositórios referenciados pertencem à Espressif Systems. Em projetos críticos ou comerciais, consulte sempre a documentação oficial."
: "ESPDocs is an aggregator and curation platform. Referenced manuals and repositories are property of Espressif Systems. In mission-critical or commercial designs, always consult official documentation."}
</p>
+2 -2
View File
@@ -3,12 +3,12 @@ import { construirIndiceBusca } from "@/lib/searchIndex";
export const dynamic = "force-static";
export function generateStaticParams() {
return [{ locale: "pt" }, { locale: "en" }];
return [{ locale: "pt" }, { locale: "en" }, { locale: "es" }];
}
export async function GET(request, { params }) {
const { locale } = await params;
const loc = locale === "en" ? "en" : "pt";
const loc = locale === "en" ? "en" : locale === "es" ? "es" : "pt";
return Response.json(construirIndiceBusca(loc), {
headers: {
"Cache-Control": "no-cache, no-store, must-revalidate",
+26 -6
View File
@@ -22,9 +22,29 @@ const HEADER_MAP_EN = {
"LEDs": "LEDs",
};
const HEADER_MAP_ES = {
"Nome": "Nombre",
"Descrição": "Descripción",
"Série": "Serie",
"Loja Oficial": "Tienda oficial",
"Fabricante": "Fabricante",
"Processador": "Procesador",
"Memória Flash": "Memoria flash",
"PSRAM": "PSRAM",
"Conector USB": "Conector USB",
"Interface USB": "Interfaz USB",
"Antena": "Antena",
"Bateria": "Batería",
"Display": "Pantalla",
"Sensores": "Sensores",
"Botões": "Botones",
"LEDs": "LEDs",
};
export default function BoardCard({ board }) {
const pathname = usePathname() || "";
const isEn = pathname === "/en" || pathname.startsWith("/en/");
const isEs = pathname === "/es" || pathname.startsWith("/es/");
const mainFields = ["Nome", "Link", "Imagem", "Loja Oficial"];
@@ -47,21 +67,21 @@ export default function BoardCard({ board }) {
{lojaOficial && (
<span className="chip chip-accent mb-3 w-fit">
<Award className="h-3.5 w-3.5" aria-hidden="true" />
{isEn ? "Official store" : "Loja oficial"}
{isEn ? "Official store" : isEs ? "Tienda oficial" : "Loja oficial"}
</span>
)}
<h3 className="line-clamp-2 font-display text-lg font-semibold leading-snug tracking-[-0.02em] text-ink">
{board.Nome || (isEn ? "Generic board" : "Placa genérica")}
{board.Nome || (isEn ? "Generic board" : isEs ? "Placa genérica" : "Placa genérica")}
</h3>
{recursos.length > 0 && (
<div className="mt-4">
<p className="text-xs font-medium text-muted">{isEn ? "On-board features" : "Recursos embarcados"}</p>
<p className="text-xs font-medium text-muted">{isEn ? "On-board features" : isEs ? "Recursos integrados" : "Recursos embarcados"}</p>
<ul className="mt-2 flex flex-wrap gap-1.5">
{recursos.map((campo) => {
const opcional = valor(campo) === "opcional";
const label = isEn ? (HEADER_MAP_EN[campo] || campo) : campo;
const label = isEn ? (HEADER_MAP_EN[campo] || campo) : isEs ? (HEADER_MAP_ES[campo] || campo) : campo;
return (
<li key={campo} className={`chip ${opcional ? "text-gold" : "text-ink-soft"}`}>
{opcional ? (
@@ -80,9 +100,9 @@ export default function BoardCard({ board }) {
{board.Link && (
<a href={board.Link} target="_blank" rel="noopener noreferrer" className="btn btn-primary mt-6 w-full">
{isEn ? "View on AliExpress" : "Ver no AliExpress"}
{isEn ? "View on AliExpress" : isEs ? "Ver en AliExpress" : "Ver no AliExpress"}
<ArrowUpRight className="h-4 w-4" aria-hidden="true" />
<span className="sr-only">{isEn ? " (opens in new tab)" : " (abre em nova aba)"}</span>
<span className="sr-only">{isEn ? " (opens in new tab)" : isEs ? " (abre en una pestaña nueva)" : " (abre em nova aba)"}</span>
</a>
)}
</div>
+29 -17
View File
@@ -7,6 +7,8 @@ import { usePathname } from "next/navigation";
export default function CodeExample({ framework }) {
const pathname = usePathname() || "";
const isEn = pathname === "/en" || pathname.startsWith("/en/");
const isEs = pathname === "/es" || pathname.startsWith("/es/");
const loc = isEn ? "en" : isEs ? "es" : "pt";
const examplesUrl = framework?.exemplos;
@@ -27,15 +29,17 @@ export default function CodeExample({ framework }) {
setSample(
isEn
? `// Full examples: ${examplesUrl || "see repository"}\n`
: `// Exemplos completos: ${examplesUrl || "ver repositório"}\n`
: isEs
? `// Ejemplos completos: ${examplesUrl || "ver repositorio"}\n`
: `// Exemplos completos: ${examplesUrl || "ver repositório"}\n`
);
return;
}
// Se locale for en, busca primeiro em /exemplos/en/
// Se locale for diferente de pt, busca primeiro em /exemplos/<loc>/
let url = exemploPath.startsWith("/") ? exemploPath : `/${exemploPath}`;
if (isEn && url.startsWith("/exemplos/") && !url.startsWith("/exemplos/en/")) {
url = url.replace("/exemplos/", "/exemplos/en/");
if (loc !== "pt" && url.startsWith("/exemplos/") && !url.startsWith(`/exemplos/${loc}/`)) {
url = url.replace("/exemplos/", `/exemplos/${loc}/`);
}
let cancelled = false;
@@ -64,9 +68,11 @@ export default function CodeExample({ framework }) {
setSample(
isEn
? "// The example file is empty. Refer to the official repository.\n"
: "// O arquivo de exemplo está vazio. Consulte o repositório oficial.\n"
: isEs
? "// El archivo de ejemplo está vacío. Consulte el repositorio oficial.\n"
: "// O arquivo de exemplo está vazio. Consulte o repositório oficial.\n"
);
setError(isEn ? "empty file" : "arquivo vazio");
setError(isEn ? "empty file" : isEs ? "archivo vacío" : "arquivo vazio");
}
})
.catch((err) => {
@@ -74,9 +80,11 @@ export default function CodeExample({ framework }) {
setSample(
isEn
? "// Could not load example.\n// Refer to official repository for complete examples.\n"
: "// Não foi possível carregar o exemplo.\n// Consulte o repositório oficial para exemplos completos.\n"
: isEs
? "// No fue posible cargar el ejemplo.\n// Consulte el repositorio oficial para ver los ejemplos completos.\n"
: "// Não foi possível carregar o exemplo.\n// Consulte o repositório oficial para exemplos completos.\n"
);
setError(err.message || (isEn ? "load failure" : "falha ao carregar"));
setError(err.message || (isEn ? "load failure" : isEs ? "fallo al cargar" : "falha ao carregar"));
})
.finally(() => {
if (!cancelled) setLoading(false);
@@ -85,7 +93,7 @@ export default function CodeExample({ framework }) {
return () => {
cancelled = true;
};
}, [framework?.exemplo, framework?.exemplos, isEn]);
}, [framework?.exemplo, framework?.exemplos, isEn, isEs, loc]);
const lines = (sample || "").replace(/\n$/, "").split("\n");
@@ -102,25 +110,27 @@ export default function CodeExample({ framework }) {
<div className="flex flex-wrap items-start justify-between gap-4">
<div>
<h2 className="font-display text-xl font-semibold tracking-[-0.03em] text-ink">
{isEn ? "Code example" : "Exemplo de código"}
{isEn ? "Code example" : isEs ? "Ejemplo de código" : "Exemplo de código"}
</h2>
<p className="mt-1 text-sm text-muted">
{isEn
? `Starter snippet in ${framework?.linguagem}. Adjust pins and configuration for your board.`
: `Trecho de partida em ${framework?.linguagem}. Ajuste pinos e configuração à sua placa.`}
: isEs
? `Fragmento de inicio en ${framework?.linguagem}. Ajuste los pines y la configuración para su placa.`
: `Trecho de partida em ${framework?.linguagem}. Ajuste pinos e configuração à sua placa.`}
</p>
</div>
<div className="flex flex-wrap items-center gap-2">
<button type="button" onClick={handleCopy} className="btn btn-ghost btn-sm">
{copied ? <Check className="h-4 w-4 text-ok" aria-hidden="true" /> : <Copy className="h-4 w-4" aria-hidden="true" />}
<span role="status">{copied ? (isEn ? "Copied" : "Copiado") : (isEn ? "Copy" : "Copiar")}</span>
<span role="status">{copied ? (isEn ? "Copied" : isEs ? "Copiado" : "Copiado") : (isEn ? "Copy" : isEs ? "Copiar" : "Copiar")}</span>
</button>
{examplesUrl && (
<a href={examplesUrl} target="_blank" rel="noopener noreferrer" className="btn btn-ghost btn-sm">
{isEn ? "More examples" : "Mais exemplos"}
{isEn ? "More examples" : isEs ? "Más ejemplos" : "Mais exemplos"}
<ExternalLink className="h-4 w-4" aria-hidden="true" />
<span className="sr-only">{isEn ? " (opens in new tab)" : " (abre em nova aba)"}</span>
<span className="sr-only">{isEn ? " (opens in new tab)" : isEs ? " (abre en una pestaña nueva)" : " (abre em nova aba)"}</span>
</a>
)}
</div>
@@ -129,9 +139,9 @@ export default function CodeExample({ framework }) {
<div className="code-panel mt-5" aria-busy={loading}>
<div className="flex items-center justify-between border-b border-white/10 px-4 py-2.5 text-xs text-[#a6afbd]">
<span className="font-mono">{framework?.nome}</span>
<span>{loading ? (isEn ? "Loading example…" : "Carregando exemplo…") : framework?.linguagem}</span>
<span>{loading ? (isEn ? "Loading example…" : isEs ? "Cargando ejemplo…" : "Carregando exemplo…") : framework?.linguagem}</span>
</div>
<pre tabIndex={0} aria-label={isEn ? `Code example in ${framework?.linguagem}` : `Código de exemplo em ${framework?.linguagem}`}>
<pre tabIndex={0} aria-label={isEn ? `Code example in ${framework?.linguagem}` : isEs ? `Código de ejemplo en ${framework?.linguagem}` : `Código de exemplo em ${framework?.linguagem}`}>
<code>
{lines.map((line, idx) => (
<span key={idx} className="flex">
@@ -147,7 +157,9 @@ export default function CodeExample({ framework }) {
<p role="alert" className="callout callout-warn mt-4">
{isEn
? `Could not load local example (${error}). Use “More examples” to view official code.`
: `Não foi possível carregar o exemplo local (${error}). Use “Mais exemplos” para ver o código oficial.`}
: isEs
? `No se pudo cargar el ejemplo local (${error}). Utilice “Más ejemplos” para ver el código oficial.`
: `Não foi possível carregar o exemplo local (${error}). Use “Mais exemplos” para ver o código oficial.`}
</p>
)}
</div>
+72 -35
View File
@@ -56,6 +56,29 @@ const FILTER_CATEGORIES_EN = [
{ id: "Antena", name: "Antenna", color: "#06b6d4" },
];
const FILTER_CATEGORIES_ES = [
{ id: "All", name: "Todos", color: "#8b5cf6" },
{ id: "GND", name: "Tierra (GND)", color: "#64748b" },
{ id: "Power", name: "Alimentación", color: "#ef4444" },
{ id: "GPIO", name: "GPIO", color: "#22c55e" },
{ id: "Low Power", name: "GPIO LP", color: "#f59e0b" },
{ id: "ADC", name: "ADC", color: "#ec4899" },
{ id: "DAC", name: "DAC", color: "#a855f7" },
{ id: "Touch", name: "Touch", color: "#06b6d4" },
{ id: "UART", name: "UART", color: "#3b82f6" },
{ id: "SPI", name: "SPI", color: "#f43f5e" },
{ id: "USB", name: "USB", color: "#a855f7" },
{ id: "Clock", name: "Reloj", color: "#eab308" },
{ id: "JTAG", name: "JTAG", color: "#6366f1" },
{ id: "Strapping", name: "Arranque (Boot)", color: "#dc2626" },
{ id: "DSI", name: "Pantalla (DSI)", color: "#f97316" },
{ id: "CSI", name: "Cámara (CSI)", color: "#14b8a6" },
{ id: "Ethernet", name: "Ethernet", color: "#0284c7" },
{ id: "SD", name: "Tarjeta SD", color: "#10b981" },
{ id: "I2C", name: "I2C", color: "#f59e0b" },
{ id: "Antena", name: "Antena", color: "#06b6d4" },
];
const type_colors = {
power: "#ef4444", // high-voltage red
ground: "#64748b", // slate gray
@@ -82,6 +105,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
const params = useSearchParams();
const pathname = usePathname();
const isEn = pathname?.startsWith("/en");
const isEs = pathname?.startsWith("/es");
const router = useRouter();
const pinosFiltro = useMemo(() => new Set((params.get("pinos") ?? "").split(",").filter(Boolean)), [params]);
const motivoFiltro = params.get("motivo") ?? "";
@@ -93,7 +117,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
const dialogRef = useRef(null);
const gatilhoRef = useRef(null);
const filterCategories = isEn ? FILTER_CATEGORIES_EN : FILTER_CATEGORIES;
const filterCategories = isEn ? FILTER_CATEGORIES_EN : isEs ? FILTER_CATEGORIES_ES : FILTER_CATEGORIES;
useEffect(() => {
setMounted(true);
@@ -115,11 +139,15 @@ function ConnectionsDiagramInner({ connections, serie }) {
};
const nomeCategoria = (cat) => {
if (cat === "Strapping") return isEn ? "Boot mode" : "Inicialização";
if (cat === "Strapping") return isEn ? "Boot mode" : isEs ? "Arranque (Boot)" : "Inicialização";
if (isEn) {
const found = FILTER_CATEGORIES_EN.find((f) => f.id === cat);
if (found) return found.name;
}
if (isEs) {
const found = FILTER_CATEGORIES_ES.find((f) => f.id === cat);
if (found) return found.name;
}
return cat;
};
@@ -176,10 +204,10 @@ function ConnectionsDiagramInner({ connections, serie }) {
<div className="px-4 py-14 text-center">
<Sliders className="mx-auto h-10 w-10 text-muted" aria-hidden="true" />
<p className="mt-4 font-display text-xl font-semibold text-ink">
{isEn ? "Pinout diagram unavailable" : "Diagrama de conexões indisponível"}
{isEn ? "Pinout diagram unavailable" : isEs ? "Diagrama de conexiones no disponible" : "Diagrama de conexões indisponível"}
</p>
<p className="mt-1 text-sm text-muted">
{isEn ? "This model does not yet have a detailed pinout and bus map." : "Este modelo ainda não tem um mapa detalhado de conexões e barramentos."}
{isEn ? "This model does not yet have a detailed pinout and bus map." : isEs ? "Este modelo todavía no dispone de un mapa detallado de conexiones y buses." : "Este modelo ainda não tem um mapa detalhado de conexões e barramentos."}
</p>
</div>
);
@@ -191,11 +219,13 @@ function ConnectionsDiagramInner({ connections, serie }) {
<div className="space-y-6">
<div>
<h2 className="font-display text-xl font-semibold tracking-[-0.03em] text-ink">
{isEn ? "Interactive pinout diagram" : "Diagrama de conexões interativo"}
{isEn ? "Interactive pinout diagram" : isEs ? "Diagrama de conexiones interactivo" : "Diagrama de conexões interativo"}
</h2>
<p className="mt-2 max-w-3xl text-sm leading-relaxed text-muted">
{isEn ? (
`All connections and multiplexing for the ${serie.nome_completo}. Search by name or number, filter by function, and open a pin to see details.`
) : isEs ? (
`Todas las conexiones y la multiplexación del ${serie.nome_completo}. Busque por nombre o número, filtre por función y abra un pin para ver los detalles.`
) : (
`Todas as conexões e a multiplexação do ${serie.nome_completo}. Busque por nome ou número, filtre por função e abra um pino para ver os detalhes.`
)}
@@ -205,11 +235,11 @@ function ConnectionsDiagramInner({ connections, serie }) {
{pinosFiltro.size > 0 && (
<div role="status" className="callout flex flex-wrap items-center justify-between gap-3">
<p className="text-sm text-ink">
<strong className="font-semibold">{isEn ? "Filtered by search:" : "Filtrado pela busca:"}</strong> {motivoFiltro || (isEn ? "selected pins" : "pinos selecionados")} ({pinosFiltro.size}{" "}
{pinosFiltro.size === 1 ? (isEn ? "pin" : "pino") : (isEn ? "pins" : "pinos")})
<strong className="font-semibold">{isEn ? "Filtered by search:" : isEs ? "Filtrado por la búsqueda:" : "Filtrado pela busca:"}</strong> {motivoFiltro || (isEn ? "selected pins" : isEs ? "pines seleccionados" : "pinos selecionados")} ({pinosFiltro.size}{" "}
{pinosFiltro.size === 1 ? (isEn ? "pin" : isEs ? "pin" : "pino") : (isEn ? "pins" : isEs ? "pines" : "pinos")})
</p>
<button type="button" onClick={mostrarTodos} className="btn btn-ghost btn-sm">
{isEn ? "Show all pins" : "Mostrar todos os pinos"}
{isEn ? "Show all pins" : isEs ? "Mostrar todos los pines" : "Mostrar todos os pinos"}
</button>
</div>
)}
@@ -217,43 +247,45 @@ function ConnectionsDiagramInner({ connections, serie }) {
<div className="flex flex-col gap-3 sm:flex-row">
<div className="relative flex-1">
<label htmlFor="busca-pino" className="sr-only">
{isEn ? "Search connection by name or number" : "Buscar conexão por nome ou número"}
{isEn ? "Search connection by name or number" : isEs ? "Buscar conexión por nombre o número" : "Buscar conexão por nome ou número"}
</label>
<Search className="pointer-events-none absolute left-4 top-1/2 h-4 w-4 -translate-y-1/2 text-muted" aria-hidden="true" />
<input
id="busca-pino"
type="search"
placeholder={isEn ? "Search pin (e.g.: GPIO1, TXD, XTAL)" : "Buscar pino (ex.: GPIO1, TXD, XTAL)"}
placeholder={isEn ? "Search pin (e.g.: GPIO1, TXD, XTAL)" : isEs ? "Buscar pin (ej.: GPIO1, TXD, XTAL)" : "Buscar pino (ex.: GPIO1, TXD, XTAL)"}
value={searchQuery}
onChange={(e) => setSearchQuery(e.target.value)}
autoComplete="off"
className="field pl-11 pr-4 text-sm"
/>
</div>
<div role="group" aria-label={isEn ? "Display mode" : "Modo de exibição"} className="flex gap-2">
<div role="group" aria-label={isEn ? "Display mode" : isEs ? "Modo de visualización" : "Modo de exibição"} className="flex gap-2">
<button type="button" onClick={() => setViewMode("grid")} aria-pressed={viewMode === "grid"} className="chip-btn">
<Grid className="h-4 w-4" aria-hidden="true" />
{isEn ? "Grid" : "Grade"}
{isEn ? "Grid" : isEs ? "Cuadrícula" : "Grade"}
</button>
<button type="button" onClick={() => setViewMode("list")} aria-pressed={viewMode === "list"} className="chip-btn">
<List className="h-4 w-4" aria-hidden="true" />
{isEn ? "List" : "Lista"}
{isEn ? "List" : isEs ? "Lista" : "Lista"}
</button>
</div>
</div>
<div>
<div className="flex items-center justify-between gap-3">
<h3 className="text-sm font-semibold text-ink">{isEn ? "Pin function" : "Função do pino"}</h3>
<h3 className="text-sm font-semibold text-ink">{isEn ? "Pin function" : isEs ? "Función del pin" : "Função do pino"}</h3>
<p role="status" aria-live="polite" className="text-sm text-muted">
{isEn ? (
`${visibleConnections.length} of ${connections.length} pins`
) : isEs ? (
`${visibleConnections.length} de ${connections.length} pines`
) : (
`${visibleConnections.length} de ${connections.length} pinos`
)}
</p>
</div>
<div role="group" aria-label={isEn ? "Filter by function" : "Filtrar por função"} className="mt-3 flex flex-wrap gap-2">
<div role="group" aria-label={isEn ? "Filter by function" : isEs ? "Filtrar por función" : "Filtrar por função"} className="mt-3 flex flex-wrap gap-2">
{filterCategories.map((filter) => {
const isActive = activeFilter === filter.id;
const count = connections.filter((c) => (filter.id === "All" ? true : c.categorias.includes(filter.id))).length;
@@ -272,10 +304,10 @@ function ConnectionsDiagramInner({ connections, serie }) {
{visibleConnections.length === 0 ? (
<div className="rounded-2xl border border-dashed border-line-strong px-6 py-12 text-center">
<Search className="mx-auto h-8 w-8 text-muted" aria-hidden="true" />
<p className="mt-3 font-semibold text-ink">{isEn ? "No connections found" : "Nenhuma conexão encontrada"}</p>
<p className="mt-1 text-sm text-muted">{isEn ? "Adjust your search or return to all functions." : "Ajuste a busca ou volte para todas as funções."}</p>
<p className="mt-3 font-semibold text-ink">{isEn ? "No connections found" : isEs ? "No se encontraron conexiones" : "Nenhuma conexão encontrada"}</p>
<p className="mt-1 text-sm text-muted">{isEn ? "Adjust your search or return to all functions." : isEs ? "Ajuste la búsqueda o vuelva a todas las funciones." : "Ajuste a busca ou volte para todas as funções."}</p>
<button type="button" onClick={() => { setActiveFilter("All"); setSearchQuery(""); if (pinosFiltro.size) mostrarTodos(); }} className="btn btn-primary btn-sm mt-5">
Limpar busca e filtros
{isEn ? "Clear search and filters" : isEs ? "Limpiar búsqueda y filtros" : "Limpar busca e filtros"}
</button>
</div>
) : viewMode === "grid" ? (
@@ -288,7 +320,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
type="button"
onClick={(e) => abrir(connection, e)}
aria-haspopup="dialog"
aria-label={isEn ? `Pin ${connection.nome}, number ${connection.numero}${connection.avisos ? ", with usage restrictions" : ""}` : `Pino ${connection.nome}, número ${connection.numero}${connection.avisos ? ", com restrições de uso" : ""}`}
aria-label={isEn ? `Pin ${connection.nome}, number ${connection.numero}${connection.avisos ? ", with usage restrictions" : ""}` : isEs ? `Pin ${connection.nome}, número ${connection.numero}${connection.avisos ? ", con restricciones de uso" : ""}` : `Pino ${connection.nome}, número ${connection.numero}${connection.avisos ? ", com restrições de uso" : ""}`}
className="flex w-full flex-col items-center rounded-xl border border-line bg-surface p-3 transition-colors hover:bg-surface-2"
>
<span
@@ -317,14 +349,14 @@ function ConnectionsDiagramInner({ connections, serie }) {
<div className="overflow-x-auto rounded-xl border border-line">
<table className="w-full min-w-[40rem] border-collapse text-left text-sm">
<caption className="sr-only">
{isEn ? `Connections of ${serie.nome_completo}` : `Conexões do ${serie.nome_completo}`}
{isEn ? `Connections of ${serie.nome_completo}` : isEs ? `Conexiones del ${serie.nome_completo}` : `Conexões do ${serie.nome_completo}`}
</caption>
<thead>
<tr className="border-b border-line bg-surface-2 text-muted">
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Pin" : "Pino"}</th>
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Name" : "Nome"}</th>
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Functions" : "Funções"}</th>
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Usage" : "Uso"}</th>
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Pin" : isEs ? "Pin" : "Pino"}</th>
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Name" : isEs ? "Nombre" : "Nome"}</th>
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Functions" : isEs ? "Funciones" : "Funções"}</th>
<th scope="col" className="px-4 py-3 font-medium">{isEn ? "Usage" : isEs ? "Uso" : "Uso"}</th>
</tr>
</thead>
<tbody className="divide-y divide-line">
@@ -337,7 +369,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
type="button"
onClick={(e) => abrir(connection, e)}
aria-haspopup="dialog"
aria-label={isEn ? `Open pin details for ${connection.nome}, number ${connection.numero}` : `Abrir detalhes do pino ${connection.nome}, número ${connection.numero}`}
aria-label={isEn ? `Open pin details for ${connection.nome}, number ${connection.numero}` : isEs ? `Abrir detalles del pin ${connection.nome}, número ${connection.numero}` : `Abrir detalhes do pino ${connection.nome}, número ${connection.numero}`}
className="grid h-11 w-11 place-items-center rounded-full border-2 bg-surface text-sm font-semibold tabular-nums text-ink hover:bg-surface-2"
style={{ borderColor: baseColor }}
>
@@ -352,12 +384,12 @@ function ConnectionsDiagramInner({ connections, serie }) {
{connection.avisos ? (
<span className="inline-flex items-center gap-1.5 font-medium text-danger">
<AlertTriangle className="h-4 w-4" aria-hidden="true" />
{isEn ? "Restricted" : "Restrito"}
{isEn ? "Restricted" : isEs ? "Restringido" : "Restrito"}
</span>
) : (
<span className="inline-flex items-center gap-1.5 text-ok">
<CheckCircle className="h-4 w-4" aria-hidden="true" />
{isEn ? "Free" : "Livre"}
{isEn ? "Free" : isEs ? "Libre" : "Livre"}
</span>
)}
</td>
@@ -373,13 +405,18 @@ function ConnectionsDiagramInner({ connections, serie }) {
<div className="callout callout-warn flex items-start gap-3">
<AlertTriangle className="mt-0.5 h-5 w-5 shrink-0 text-gold" aria-hidden="true" />
<div>
<p className="font-semibold text-ink">{isEn ? "Pinout notes" : "Notas sobre a pinagem"}</p>
<p className="font-semibold text-ink">{isEn ? "Pinout notes" : isEs ? "Notas sobre el patillaje" : "Notas sobre a pinagem"}</p>
<ul className="mt-1 list-disc space-y-1 pl-5">
{isEn ? (
<>
<li>Pins with a warning icon have special boot roles or analog limitations. Open the pin to see details.</li>
<li>Isolate capacitive touch traces from coupled RF noise.</li>
</>
) : isEs ? (
<>
<li>Los pines con icono de advertencia tienen un papel especial en el arranque o limitaciones analógicas. Abra el pin para ver los detalles.</li>
<li>Aísle las pistas táctiles capacitivas del ruido de RF acoplado.</li>
</>
) : (
<>
<li>Pinos com o ícone de alerta têm papel especial no boot ou limitações analógicas. Abra o pino para ver os detalhes.</li>
@@ -414,11 +451,11 @@ function ConnectionsDiagramInner({ connections, serie }) {
{selectedConnection.nome}
</h3>
<p className="text-sm text-muted">
{isEn ? `Physical pin ${selectedConnection.numero}` : `Pino físico ${selectedConnection.numero}`}
{isEn ? `Physical pin ${selectedConnection.numero}` : isEs ? `Pin físico ${selectedConnection.numero}` : `Pino físico ${selectedConnection.numero}`}
</p>
</div>
</div>
<button type="button" onClick={fechar} aria-label={isEn ? "Close pin details" : "Fechar detalhes do pino"} className="grid h-11 w-11 shrink-0 place-items-center rounded-full text-muted transition-colors hover:bg-surface-2 hover:text-ink">
<button type="button" onClick={fechar} aria-label={isEn ? "Close pin details" : isEs ? "Cerrar detalles del pin" : "Fechar detalhes do pino"} className="grid h-11 w-11 shrink-0 place-items-center rounded-full text-muted transition-colors hover:bg-surface-2 hover:text-ink">
<X className="h-5 w-5" aria-hidden="true" />
</button>
</div>
@@ -426,7 +463,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
<div className="flex-1 space-y-6 overflow-y-auto p-5 sm:p-7">
{selectedConnection.categorias.length > 0 && (
<section>
<h4 className="text-sm font-semibold text-ink">{isEn ? "Categories" : "Categorias"}</h4>
<h4 className="text-sm font-semibold text-ink">{isEn ? "Categories" : isEs ? "Categorías" : "Categorias"}</h4>
<ul className="mt-3 flex flex-wrap gap-2">
{selectedConnection.categorias.map((cat) => (
<li key={cat} className="chip">
@@ -442,7 +479,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
<section>
<h4 className="flex items-center gap-2 text-sm font-semibold text-ink">
<Zap className="h-4 w-4 text-danger" aria-hidden="true" />
{isEn ? "Power domain" : "Domínio de alimentação"}
{isEn ? "Power domain" : isEs ? "Dominio de alimentación" : "Domínio de alimentação"}
</h4>
<ul className="tile mt-3 space-y-2">
{selectedConnection.alimentacao.map((source) => (
@@ -453,7 +490,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
)}
<section>
<h4 className="text-sm font-semibold text-ink">{isEn ? "Available functions" : "Funções disponíveis"}</h4>
<h4 className="text-sm font-semibold text-ink">{isEn ? "Available functions" : isEs ? "Funciones disponibles" : "Funções disponíveis"}</h4>
<ul className="tile mt-3 grid gap-2.5 sm:grid-cols-2">
{selectedConnection.funcoes.map((func) => (
<li key={func} className="flex items-center gap-2.5 text-sm text-ink-soft">
@@ -468,7 +505,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
<section className="callout callout-danger">
<h4 className="flex items-center gap-2 font-semibold text-ink">
<AlertTriangle className="h-4 w-4 text-danger" aria-hidden="true" />
{isEn ? "Engineering notes" : "Avisos de engenharia"}
{isEn ? "Engineering notes" : isEs ? "Notas de ingeniería" : "Avisos de engenharia"}
</h4>
<ul className="mt-2 list-disc space-y-1.5 pl-5">
{selectedConnection.avisos.map((aviso) => (
@@ -481,7 +518,7 @@ function ConnectionsDiagramInner({ connections, serie }) {
<div className="border-t border-line p-4 sm:px-7">
<button type="button" onClick={fechar} className="btn btn-primary w-full">
{isEn ? "Close" : "Fechar"}
{isEn ? "Close" : isEs ? "Cerrar" : "Fechar"}
</button>
</div>
</div>
+45 -7
View File
@@ -67,6 +67,35 @@ const COLUMNS_EN = [
},
];
const COLUMNS_ES = [
{
title: "Explorar",
links: [
{ href: "/series", label: "Series ESP32" },
{ href: "/comparacao", label: "Comparador" },
{ href: "/catalogo", label: "Catálogo de placas" },
],
},
{
title: "Herramientas",
links: [
{ href: "/seletor", label: "Selector inteligente" },
{ href: "/diagnostico", label: "Diagnóstico" },
{ href: "/componentes", label: "Component Registry" },
{ href: "/frameworks", label: "Frameworks y SDKs" },
],
},
{
title: "Proyecto",
links: [
{ href: "/sobre", label: "Acerca de ESPDocs" },
{ href: "/glossario", label: "Glosario" },
{ href: SITE.repositorio, label: "Repositorio", external: true },
{ href: `${SITE.repositorio}/issues`, label: "Reportar un problema", external: true },
],
},
];
export default function Footer() {
const pathname = usePathname() || "";
const year = new Date().getFullYear();
@@ -74,6 +103,8 @@ export default function Footer() {
const currentLocale =
LOCALES.find((l) => pathname === `/${l.code}` || pathname.startsWith(`/${l.code}/`))?.code || "pt";
const isPt = currentLocale === "pt";
const isEn = currentLocale === "en";
const isEs = currentLocale === "es";
const getLinkHref = (href) => getLocalizedHref(`/${currentLocale}${href}`, currentLocale);
@@ -82,14 +113,16 @@ export default function Footer() {
...column,
links: column.links.filter((link) => link.href !== "/livro" || isPt),
}))
: isEs
? COLUMNS_ES
: COLUMNS_EN;
return (
<footer className="mt-20 border-t border-line md:mt-28" aria-label={isPt ? "Rodapé do ESPDocs" : "ESPDocs footer"}>
<footer className="mt-20 border-t border-line md:mt-28" aria-label={isPt ? "Rodapé do ESPDocs" : isEs ? "Pie de página de ESPDocs" : "ESPDocs footer"}>
<div className="shell py-14 md:py-20">
<div className="grid gap-12 lg:grid-cols-[1.1fr_2fr]">
<div>
<Link href={getLinkHref("/")} className="inline-flex min-h-11 items-center gap-2.5" aria-label={isPt ? "ESPDocs, página inicial" : "ESPDocs, homepage"}>
<Link href={getLinkHref("/")} className="inline-flex min-h-11 items-center gap-2.5" aria-label={isPt ? "ESPDocs, página inicial" : isEs ? "ESPDocs, página de inicio" : "ESPDocs, homepage"}>
<Logo className="h-7 w-7" />
<span className="font-display text-2xl font-semibold tracking-[-0.045em] text-ink">ESPDocs</span>
</Link>
@@ -99,6 +132,11 @@ export default function Footer() {
Documentação independente do ecossistema ESP32, escrita em português brasileiro.
Dados públicos, curadoria editorial e links para as fontes oficiais.
</>
) : isEs ? (
<>
Documentación independiente del ecosistema ESP32.
Datos públicos, curaduría editorial y enlaces a las fuentes oficiales.
</>
) : (
<>
Independent documentation of the ESP32 ecosystem.
@@ -173,7 +211,7 @@ export default function Footer() {
))}
<div>
<h2 className="text-sm font-semibold text-ink">{isPt ? "Autor" : "Author"}</h2>
<h2 className="text-sm font-semibold text-ink">{isPt ? "Autor" : isEs ? "Autor" : "Author"}</h2>
<p className="mt-4 text-sm leading-relaxed text-muted">
Lucas Rayan Guerra
<br />
@@ -184,7 +222,7 @@ export default function Footer() {
href={SITE.repositorio}
target="_blank"
rel="noopener noreferrer"
aria-label={isPt ? "Gitea do projeto (abre em nova aba)" : "Project Gitea (opens in new tab)"}
aria-label={isPt ? "Gitea do projeto (abre em nova aba)" : isEs ? "Gitea del proyecto (abre en una pestaña nueva)" : "Project Gitea (opens in new tab)"}
className="grid h-11 w-11 place-items-center rounded-full border border-line text-ink transition-colors hover:border-line-strong hover:bg-surface"
>
<GiteaMark className="h-4 w-4" />
@@ -193,7 +231,7 @@ export default function Footer() {
href={SITE.autorLinkedin}
target="_blank"
rel="noopener noreferrer"
aria-label={isPt ? "LinkedIn do autor (abre em nova aba)" : "Author LinkedIn (opens in new tab)"}
aria-label={isPt ? "LinkedIn do autor (abre em nova aba)" : isEs ? "LinkedIn del autor (abre en una pestaña nueva)" : "Author LinkedIn (opens in new tab)"}
className="grid h-11 w-11 place-items-center rounded-full border border-line text-ink transition-colors hover:border-line-strong hover:bg-surface"
>
<svg className="h-4 w-4" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
@@ -206,7 +244,7 @@ export default function Footer() {
</div>
<div className="mt-14 flex flex-col gap-4 border-t border-line pt-6 text-xs leading-relaxed text-faint md:flex-row md:items-center md:justify-between">
<p>© {year} {isPt ? "ESPDocs. Projeto independente, sem afiliação com a Espressif Systems." : "ESPDocs. Independent project, not affiliated with Espressif Systems."}</p>
<p>© {year} {isPt ? "ESPDocs. Projeto independente, sem afiliação com a Espressif Systems." : isEs ? "ESPDocs. Proyecto independiente, sin afiliación con Espressif Systems." : "ESPDocs. Independent project, not affiliated with Espressif Systems."}</p>
<p className="flex flex-wrap items-center gap-x-5 gap-y-2">
<a href={SITE.blog} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-1 transition-colors hover:text-accent">
Ciência Embarcada
@@ -216,7 +254,7 @@ export default function Footer() {
lucasrguerra.dev.br
<ArrowUpRight className="h-3 w-3" aria-hidden="true" />
</a>
<span>{isPt ? "Fontes oficiais: Espressif Systems." : "Official sources: Espressif Systems."}</span>
<span>{isPt ? "Fontes oficiais: Espressif Systems." : isEs ? "Fuentes oficiales: Espressif Systems." : "Official sources: Espressif Systems."}</span>
</p>
</div>
</div>
+61 -17
View File
@@ -88,6 +88,36 @@ const MENUS_EN = [
},
];
const MENUS_ES = [
{
id: "hardware",
label: "Hardware",
items: [
{ href: "/series", label: "Series ESP32", desc: "12 chips, patillaje y especificaciones", icon: Cpu },
{ href: "/comparacao", label: "Comparador", desc: "Hasta cuatro series frente a frente", icon: Scale },
{ href: "/catalogo", label: "Catálogo de placas", desc: "DevKits, pines y dónde comprar", icon: Box },
],
},
{
id: "tools",
label: "Herramientas",
items: [
{ href: "/seletor", label: "Selector inteligente", desc: "El chip adecuado para su proyecto", icon: SlidersHorizontal },
{ href: "/diagnostico", label: "Diagnóstico", desc: "Brownout, bootloop, WDT y más", icon: AlertTriangle },
{ href: "/componentes", label: "Component Registry", desc: "Drivers y manifiestos idf_component.yml", icon: Search },
],
},
{
id: "library",
label: "Biblioteca",
items: [
{ href: "/frameworks", label: "Frameworks y SDKs", desc: "ESP-IDF, Arduino, Rust y Matter", icon: BookOpen },
{ href: "/glossario", label: "Glosario técnico", desc: "Términos que aparecen en las hojas de datos", icon: BookA },
{ href: "/sobre", label: "Acerca del proyecto", desc: "Autoría, método y código abierto", icon: Sparkles },
],
},
];
const MOBILE_LINKS_PT = [
{ href: "/series", label: "Séries ESP32" },
{ href: "/comparacao", label: "Comparador" },
@@ -113,6 +143,18 @@ const MOBILE_LINKS_EN = [
{ href: "/sobre", label: "About" },
];
const MOBILE_LINKS_ES = [
{ href: "/series", label: "Series ESP32" },
{ href: "/comparacao", label: "Comparador" },
{ href: "/seletor", label: "Selector inteligente" },
{ href: "/diagnostico", label: "Diagnóstico" },
{ href: "/frameworks", label: "Frameworks y SDKs" },
{ href: "/componentes", label: "Component Registry" },
{ href: "/glossario", label: "Glosario" },
{ href: "/catalogo", label: "Catálogo de placas" },
{ href: "/sobre", label: "Acerca de" },
];
function isActivePath(pathname, href, currentLocale) {
const localized = getLocalizedHref(`/${currentLocale}${href}`, currentLocale);
if (href === "/" || localized === `/${currentLocale}/` || localized === `/${currentLocale}`) {
@@ -133,6 +175,8 @@ export default function Header() {
const currentLocale =
LOCALES.find((l) => pathname === `/${l.code}` || pathname.startsWith(`/${l.code}/`))?.code || "pt";
const isPt = currentLocale === "pt";
const isEn = currentLocale === "en";
const isEs = currentLocale === "es";
const getLinkHref = (href) => getLocalizedHref(`/${currentLocale}${href}`, currentLocale);
@@ -172,19 +216,19 @@ export default function Header() {
};
}, [drawerOpen]);
const visibleMobileLinks = isPt ? MOBILE_LINKS_PT : MOBILE_LINKS_EN;
const MENUS = isPt ? MENUS_PT : MENUS_EN;
const visibleMobileLinks = isPt ? MOBILE_LINKS_PT : isEs ? MOBILE_LINKS_ES : MOBILE_LINKS_EN;
const MENUS = isPt ? MENUS_PT : isEs ? MENUS_ES : MENUS_EN;
return (
<header className="sticky top-0 z-50 pt-3 sm:pt-4">
<div className="shell">
<div className="nav-pill flex h-16 items-center justify-between gap-3 rounded-full px-3 sm:px-4">
<Link href={getLinkHref("/")} className="flex min-h-11 shrink-0 items-center gap-2.5 rounded-full pl-1 pr-2" aria-label={isPt ? "ESPDocs, página inicial" : "ESPDocs, homepage"}>
<Link href={getLinkHref("/")} className="flex min-h-11 shrink-0 items-center gap-2.5 rounded-full pl-1 pr-2" aria-label={isPt ? "ESPDocs, página inicial" : isEs ? "ESPDocs, página de inicio" : "ESPDocs, homepage"}>
<Logo className="h-[30px] w-[30px]" />
<span className="font-display text-[1.3rem] font-semibold leading-none tracking-[-0.045em] text-ink">ESPDocs</span>
</Link>
<nav ref={navRef} className="hidden items-center gap-0.5 lg:flex" aria-label={isPt ? "Navegação principal" : "Main navigation"}>
<nav ref={navRef} className="hidden items-center gap-0.5 lg:flex" aria-label={isPt ? "Navegação principal" : isEs ? "Navegación principal" : "Main navigation"}>
{MENUS.map((menu) => {
const active = menu.items.some((item) => isActivePath(pathname, item.href, currentLocale));
const expanded = openMenu === menu.id;
@@ -237,23 +281,23 @@ export default function Header() {
</Link>
)}
<Link href={getLinkHref("/sobre")} className={`nav-link ${isActivePath(pathname, "/sobre", currentLocale) ? "is-active" : ""}`} aria-current={isActivePath(pathname, "/sobre", currentLocale) ? "page" : undefined}>
{isPt ? "Sobre" : "About"}
{isPt ? "Sobre" : isEs ? "Acerca de" : "About"}
</Link>
</nav>
<div className="flex items-center gap-1.5">
<Link href={getLinkHref("/seletor")} className="btn btn-primary btn-sm hidden lg:inline-flex">
<SlidersHorizontal className="h-4 w-4" aria-hidden="true" />
{isPt ? "Selecionar chip" : "Select chip"}
{isPt ? "Selecionar chip" : isEs ? "Seleccionar chip" : "Select chip"}
</Link>
<SearchDialog />
<LanguageSelector />
<ThemeToggle isPt={isPt} />
<ThemeToggle isPt={isPt} isEs={isEs} />
<button
ref={menuButtonRef}
type="button"
className="grid h-11 w-11 place-items-center rounded-full border border-line text-ink transition-colors hover:bg-surface-2 lg:hidden"
aria-label={isPt ? "Abrir menu de navegação" : "Open navigation menu"}
aria-label={isPt ? "Abrir menu de navegação" : isEs ? "Abrir menú de navegación" : "Open navigation menu"}
aria-expanded={drawerOpen}
onClick={() => setDrawerOpen(true)}
>
@@ -276,7 +320,7 @@ export default function Header() {
<div
role="dialog"
aria-modal="true"
aria-label={isPt ? "Menu de navegação" : "Navigation menu"}
aria-label={isPt ? "Menu de navegação" : isEs ? "Menú de navegación" : "Navigation menu"}
aria-hidden={!drawerOpen}
inert={!drawerOpen}
className={`fixed inset-y-0 right-0 z-[101] flex w-[min(23rem,94vw)] flex-col rounded-l-[2rem] border-l border-line bg-canvas transition-transform duration-300 ${
@@ -285,15 +329,15 @@ export default function Header() {
>
<div className="flex items-start justify-between px-5 py-5">
<div>
<p className="text-xs font-semibold text-muted">{isPt ? "Navegação" : "Navigation"}</p>
<p className="mt-1 font-display text-2xl font-semibold tracking-[-0.04em] text-ink">{isPt ? "Para onde ir" : "Where to go"}</p>
<p className="text-xs font-semibold text-muted">{isPt ? "Navegação" : isEs ? "Navegación" : "Navigation"}</p>
<p className="mt-1 font-display text-2xl font-semibold tracking-[-0.04em] text-ink">{isPt ? "Para onde ir" : isEs ? "A dónde ir" : "Where to go"}</p>
</div>
<button
ref={closeRef}
type="button"
onClick={() => setDrawerOpen(false)}
className="grid h-10 w-10 place-items-center rounded-full border border-line text-ink transition-colors hover:bg-surface-2"
aria-label={isPt ? "Fechar menu" : "Close menu"}
aria-label={isPt ? "Fechar menu" : isEs ? "Cerrar menú" : "Close menu"}
>
<X className="h-5 w-5" aria-hidden="true" />
</button>
@@ -325,7 +369,7 @@ export default function Header() {
</div>
)}
<nav className="flex-1 overflow-y-auto px-3 py-2" aria-label={isPt ? "Navegação móvel" : "Mobile navigation"}>
<nav className="flex-1 overflow-y-auto px-3 py-2" aria-label={isPt ? "Navegação móvel" : isEs ? "Navegación móvil" : "Mobile navigation"}>
{visibleMobileLinks.map((link) => (
<Link
key={link.href}
@@ -343,7 +387,7 @@ export default function Header() {
<div className="p-4 pt-2">
<Link href={getLinkHref("/seletor")} onClick={() => setDrawerOpen(false)} className="btn btn-primary w-full">
<SlidersHorizontal className="h-4 w-4" aria-hidden="true" />
{isPt ? "Selecionar meu chip" : "Select my chip"}
{isPt ? "Selecionar meu chip" : isEs ? "Seleccionar mi chip" : "Select my chip"}
</Link>
</div>
</div>
@@ -354,7 +398,7 @@ export default function Header() {
);
}
function ThemeToggle({ isPt = true }) {
function ThemeToggle({ isPt = true, isEs = false }) {
const { resolvedTheme, setTheme } = useTheme();
const [mounted, setMounted] = useState(false);
@@ -371,8 +415,8 @@ function ThemeToggle({ isPt = true }) {
type="button"
onClick={() => setTheme(dark ? "light" : "dark")}
className="grid h-11 w-11 place-items-center rounded-full border border-line text-ink transition-colors hover:bg-surface-2"
aria-label={dark ? (isPt ? "Ativar tema claro" : "Switch to light theme") : (isPt ? "Ativar tema escuro" : "Switch to dark theme")}
title={dark ? (isPt ? "Tema claro" : "Light theme") : (isPt ? "Tema escuro" : "Dark theme")}
aria-label={dark ? (isPt ? "Ativar tema claro" : isEs ? "Activar tema claro" : "Switch to light theme") : (isPt ? "Ativar tema escuro" : isEs ? "Activar tema oscuro" : "Switch to dark theme")}
title={dark ? (isPt ? "Tema claro" : isEs ? "Tema claro" : "Light theme") : (isPt ? "Tema escuro" : isEs ? "Tema oscuro" : "Dark theme")}
>
{dark ? <Sun className="h-4 w-4" aria-hidden="true" /> : <Moon className="h-4 w-4" aria-hidden="true" />}
</button>
+2 -2
View File
@@ -63,7 +63,7 @@ export default function LanguageSelector() {
className="flex h-11 min-w-[44px] items-center gap-1.5 rounded-full border border-line bg-surface px-3 text-sm font-semibold text-ink transition-colors hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-accent"
aria-haspopup="listbox"
aria-expanded={open}
aria-label={currentLocaleCode === "en" ? `Current language: ${currentLocale.label}. Click to switch language.` : `Idioma atual: ${currentLocale.label}. Clique para trocar de idioma.`}
aria-label={currentLocaleCode === "en" ? `Current language: ${currentLocale.label}. Click to switch language.` : currentLocaleCode === "es" ? `Idioma actual: ${currentLocale.label}. Haga clic para cambiar de idioma.` : `Idioma atual: ${currentLocale.label}. Clique para trocar de idioma.`}
title={currentLocaleCode === "en" ? `Language: ${currentLocale.label}` : `Idioma: ${currentLocale.label}`}
>
<Globe className="h-4 w-4 text-muted" aria-hidden="true" />
@@ -77,7 +77,7 @@ export default function LanguageSelector() {
{open && (
<div
role="listbox"
aria-label={currentLocaleCode === "en" ? "Available languages" : "Idiomas disponíveis"}
aria-label={currentLocaleCode === "en" ? "Available languages" : currentLocaleCode === "es" ? "Idiomas disponibles" : "Idiomas disponíveis"}
className="absolute right-0 top-full mt-2 w-48 rounded-2xl border border-line bg-surface p-1.5 shadow-[0_24px_60px_-20px_rgba(15,23,42,0.35)] dark:shadow-[0_24px_60px_-20px_rgba(0,0,0,0.8)] z-50"
>
{LOCALES.map((loc) => {
+10 -3
View File
@@ -14,6 +14,7 @@ export default function PageHero({
align = "left",
children,
isEn: isEnProp,
isEs: isEsProp,
locale: localeProp,
}) {
const center = align === "center";
@@ -23,13 +24,19 @@ export default function PageHero({
: localeProp
? localeProp === "en"
: trail.some((t) => t.isEn || (t.href && t.href.startsWith("/en")));
const isEs =
isEsProp !== undefined
? isEsProp
: localeProp
? localeProp === "es"
: trail.some((t) => t.isEs || (t.href && t.href.startsWith("/es")));
return (
<section className="shell pt-8 sm:pt-12">
{trail.length > 0 && (
<nav aria-label={isEn ? "Breadcrumb navigation" : "Trilha de navegação"} className="flex flex-wrap items-center gap-2 text-sm text-muted">
<Link href={isEn ? "/en" : "/"} className="inline-flex min-h-11 min-w-11 items-center justify-center transition-colors hover:text-accent">
{isEn ? "Home" : "Início"}
<nav aria-label={isEn ? "Breadcrumb navigation" : isEs ? "Navegación por migas de pan" : "Trilha de navegação"} className="flex flex-wrap items-center gap-2 text-sm text-muted">
<Link href={isEn ? "/en" : isEs ? "/es" : "/"} className="inline-flex min-h-11 min-w-11 items-center justify-center transition-colors hover:text-accent">
{isEn ? "Home" : isEs ? "Inicio" : "Início"}
</Link>
{trail.map((item, i) => (
<span key={item.label} className="flex min-h-11 items-center gap-2">
+79 -9
View File
@@ -140,14 +140,75 @@ const GRUPOS_EN = [
},
];
const GRUPOS_ES = [
{
id: "entrada",
titulo: "Solo entrada",
icone: ArrowDownToLine,
cor: "text-accent",
explicacao:
"Aceptan únicamente lectura. No pueden configurarse como salida y no poseen resistencias de pull-up o pull-down internas. Si necesita una, agréguela en el circuito externo.",
combina: (avisos) => /solo de entrada|input[- ]only/i.test(avisos),
},
{
id: "flash",
titulo: "Conectados a la memoria flash/PSRAM",
icone: HardDrive,
cor: "text-copper",
explicacao:
"Ya están conectados a la memoria desde donde se lee el firmware. Usarlos como GPIO común normalmente bloquea el chip o corrompe la ejecución. En módulos con flash interna ni siquiera llegan a los pines del encapsulado.",
combina: (avisos) =>
/(flash|psram)/i.test(avisos) &&
/(dedicado|utilizado por la mem|no debe|no se recomienda|no recomendado|connected to|dedicated to)/i.test(avisos),
},
{
id: "strapping",
titulo: "Strapping (modo de arranque)",
icone: Power,
cor: "text-gold",
explicacao:
"El chip lee el nivel lógico de estos pines en el instante del reset para decidir cómo inicializarse. Pueden usarse después del arranque, pero el circuito externo no debe forzar el nivel incorrecto durante el reset, de lo contrario la placa no iniciará o entrará en modo de descarga inesperadamente.",
combina: (avisos, cats) =>
cats.includes("Strapping") ||
/strapping|modo de arranque|modo de inicialización|boot mode/i.test(avisos),
},
{
id: "debug",
titulo: "Grabación y depuración",
icone: Bug,
cor: "text-accent",
explicacao:
"Son la UART de grabación y las líneas de JTAG. Siguen utilizables como GPIO, pero al reutilizarlos pierde la posibilidad de grabar y depurar la placa sin desconectar lo que esté conectado allí.",
combina: (avisos, cats) => /depuración|grabación|debugging/i.test(avisos) || cats.includes("JTAG"),
},
{
id: "usb",
titulo: "USB nativo",
icone: Usb,
cor: "text-accent",
explicacao:
"Salen de fábrica conectados al USB Serial/JTAG interno. Para usarlos como GPIO es necesario desactivar esa función, lo que también elimina la grabación por USB directo.",
combina: (avisos) => /usb serial\/jtag|usb_d[+-]/i.test(avisos),
},
{
id: "eletrico",
titulo: "No deben quedar flotando",
icone: Zap,
cor: "text-gold",
explicacao:
"Requieren un nivel lógico definido por hardware: pull-up externo o circuito RC de retardo. Dejarlos sueltos causa reinicios aleatorios o un arranque inestable.",
combina: (avisos) => /flotando|floating/i.test(avisos),
},
];
/** Nome do pino + o GPIO correspondente, quando o nome é uma função (ex.: SENSOR_VP). */
function rotuloDoPino(pino) {
const gpio = (pino.funcoes || []).find((f) => /^GPIO\d+$/.test(f));
return gpio && gpio !== pino.nome ? `${pino.nome} · ${gpio}` : pino.nome;
}
function derivarGrupos(conexoes, isEn) {
const listaGrupos = isEn ? GRUPOS_EN : GRUPOS_PT;
function derivarGrupos(conexoes, isEn, isEs) {
const listaGrupos = isEn ? GRUPOS_EN : isEs ? GRUPOS_ES : GRUPOS_PT;
return listaGrupos.map((grupo) => {
const vistos = new Map();
for (const pino of conexoes) {
@@ -163,10 +224,13 @@ function derivarGrupos(conexoes, isEn) {
}).filter((g) => g.pinos.length > 0);
}
export default function PinRestrictions({ conexoes, serieKey, isEn = false }) {
export default function PinRestrictions({ conexoes, serieKey, isEn = false, isEs = false, locale }) {
if (!conexoes?.length) return null;
const grupos = derivarGrupos(conexoes, isEn);
const effectiveIsEn = isEn || locale === "en";
const effectiveIsEs = isEs || locale === "es";
const grupos = derivarGrupos(conexoes, effectiveIsEn, effectiveIsEs);
if (!grupos.length) return null;
const totalPinos = new Set(grupos.flatMap((g) => g.pinos)).size;
@@ -177,14 +241,18 @@ export default function PinRestrictions({ conexoes, serieKey, isEn = false }) {
<span className="grid h-9 w-9 place-items-center rounded-full bg-gold-soft text-gold">
<AlertTriangle className="h-4 w-4" aria-hidden="true" />
</span>
{isEn ? "Pins with usage restrictions" : "Pinos com restrição de uso"}
{effectiveIsEn ? "Pins with usage restrictions" : effectiveIsEs ? "Pines con restricción de uso" : "Pinos com restrição de uso"}
</h2>
<p className="mt-3 max-w-3xl text-sm leading-relaxed text-muted">
{isEn ? (
{effectiveIsEn ? (
<>
Not every pin on the {serieKey} is free for general-purpose use. {totalPinos} of them have conditions: occupied by memory, sampled during boot, or function as input only. Check before finalizing your schematic.
</>
) : effectiveIsEs ? (
<>
No todos los pines del {serieKey} están libres para uso general. {totalPinos} de ellos tienen alguna condición: ya están ocupados por memoria, se leen durante el arranque o solo funcionan como entrada. Conviene comprobarlos antes de cerrar el esquemático.
</>
) : (
<>
Nem todo pino do {serieKey} está livre para uso geral. {totalPinos} deles têm alguma
@@ -201,7 +269,7 @@ export default function PinRestrictions({ conexoes, serieKey, isEn = false }) {
<Icone className={`h-4 w-4 shrink-0 ${corIcone}`} aria-hidden="true" />
<h3 className="text-sm font-semibold text-ink">{titulo}</h3>
<span className="ml-auto text-xs text-muted tabular-nums">
{pinos.length} {pinos.length === 1 ? (isEn ? "pin" : "pino") : (isEn ? "pins" : "pinos")}
{pinos.length} {pinos.length === 1 ? (effectiveIsEn ? "pin" : effectiveIsEs ? "pin" : "pino") : (effectiveIsEn ? "pins" : effectiveIsEs ? "pines" : "pinos")}
</span>
</div>
@@ -220,14 +288,16 @@ export default function PinRestrictions({ conexoes, serieKey, isEn = false }) {
<div className="mt-6 flex flex-col justify-between gap-4 border-t border-line pt-5 sm:flex-row sm:items-center">
<p className="max-w-xl text-sm leading-relaxed text-muted">
{isEn ? (
{effectiveIsEn ? (
"These groups are derived from the same data as the pinout diagram. There you can see every pin's full functions, power domain, and complete engineering notes."
) : effectiveIsEs ? (
"Estos grupos proceden de los mismos datos que el diagrama de conexiones. Allí podrá consultar pino a pino todas las funciones, el dominio de alimentación y los avisos completos."
) : (
"Estes grupos vêm dos mesmos dados do diagrama de conexões. Lá você vê pino a pino todas as funções, o domínio de alimentação e os avisos completos."
)}
</p>
<Link href="#connections" className="btn btn-ghost shrink-0">
{isEn ? "Open pinout diagram" : "Abrir diagrama de pinos"}
{effectiveIsEn ? "Open pinout diagram" : effectiveIsEs ? "Abrir diagrama de pines" : "Abrir diagrama de pinos"}
<ArrowRight className="h-4 w-4" aria-hidden="true" />
</Link>
</div>
+34 -21
View File
@@ -43,9 +43,21 @@ const TIPOS_EN = {
componente: { label: "Component", Icon: Box, cor: "bg-surface-2 text-ink-soft" },
};
const TIPOS_ES = {
resposta: { label: "Respuesta", Icon: Sparkles, cor: "bg-accent text-accent-contrast" },
pino: { label: "Pines", Icon: Plug, cor: "bg-accent text-accent-contrast" },
pagina: { label: "Página", Icon: FileText, cor: "bg-surface-2 text-ink-soft" },
serie: { label: "Serie", Icon: Cpu, cor: "bg-accent-soft text-accent" },
framework: { label: "Framework", Icon: Terminal, cor: "bg-teal-soft text-teal" },
glossario: { label: "Glosario", Icon: BookOpen, cor: "bg-copper-soft text-copper" },
erro: { label: "Error", Icon: AlertTriangle, cor: "bg-gold-soft text-gold" },
componente: { label: "Componente", Icon: Box, cor: "bg-surface-2 text-ink-soft" },
};
const INTELIGENTES = new Set(["resposta", "pino"]);
const EXEMPLOS_EN = ["flash s3", "usb pins c6", "gpio0 esp32", "brownout", "LVGL", "FreeRTOS"];
const EXEMPLOS_ES = ["flash s3", "pines usb c6", "gpio0 esp32", "brownout", "LVGL", "FreeRTOS"];
function Destaque({ texto, termos }) {
if (!termos.length) return texto;
@@ -98,11 +110,12 @@ function Pilula({ children, onClick, forte = false }) {
export default function SearchDialog() {
const pathname = usePathname() || "";
const locale = pathname === "/en" || pathname.startsWith("/en/") ? "en" : "pt";
const locale = pathname === "/en" || pathname.startsWith("/en/") ? "en" : (pathname === "/es" || pathname.startsWith("/es/") ? "es" : "pt");
const isEn = locale === "en";
const isEs = locale === "es";
const TIPOS = isEn ? TIPOS_EN : TIPOS_PT;
const EXEMPLOS = isEn ? EXEMPLOS_EN : EXEMPLOS_DE_BUSCA;
const TIPOS = isEn ? TIPOS_EN : isEs ? TIPOS_ES : TIPOS_PT;
const EXEMPLOS = isEn ? EXEMPLOS_EN : isEs ? EXEMPLOS_ES : EXEMPLOS_DE_BUSCA;
const [aberto, setAberto] = useState(false);
const [montado, setMontado] = useState(false);
@@ -143,7 +156,7 @@ export default function SearchDialog() {
const carregarIndice = useCallback(() => {
setErro(false);
let cancelado = false;
const url = isEn ? "/api/busca/en?v=2" : "/api/busca?v=2";
const url = isEn ? "/api/busca/en?v=2" : isEs ? "/api/busca/es?v=2" : "/api/busca?v=2";
fetch(url, { cache: "no-cache" })
.then((r) => {
if (!r.ok) {
@@ -167,7 +180,7 @@ export default function SearchDialog() {
return () => {
cancelado = true;
};
}, [isEn]);
}, [isEn, isEs]);
// Carrega o índice (textos + especificações + pinos) na primeira abertura.
useEffect(() => {
@@ -238,7 +251,7 @@ export default function SearchDialog() {
id="botao-busca"
onClick={() => setAberto(true)}
className="flex h-11 min-w-11 shrink-0 cursor-pointer items-center justify-center gap-2 rounded-full border border-line px-3 text-ink transition-colors hover:bg-surface-2 xl:px-4"
aria-label={isEn ? "Search ESPDocs (Ctrl+K)" : "Buscar no ESPDocs (Ctrl+K)"}
aria-label={isEn ? "Search ESPDocs (Ctrl+K)" : isEs ? "Buscar en ESPDocs (Ctrl+K)" : "Buscar no ESPDocs (Ctrl+K)"}
>
<Search className="h-4 w-4" aria-hidden="true" />
<span className="hidden text-sm font-medium xl:inline">{isEn ? "Search" : "Buscar"}</span>
@@ -248,7 +261,7 @@ export default function SearchDialog() {
{montado &&
aberto &&
createPortal(
<div className="fixed inset-0 z-[120] flex items-start justify-center px-4 pt-[8vh]" role="dialog" aria-modal="true" aria-label={isEn ? "Search ESPDocs" : "Buscar no ESPDocs"}>
<div className="fixed inset-0 z-[120] flex items-start justify-center px-4 pt-[8vh]" role="dialog" aria-modal="true" aria-label={isEn ? "Search ESPDocs" : isEs ? "Buscar en ESPDocs" : "Buscar no ESPDocs"}>
<div className="dialog-scrim absolute inset-0 bg-black/45 backdrop-blur-sm" onClick={fechar} />
<div className="dialog-panel relative flex max-h-[80vh] w-full max-w-2xl flex-col overflow-hidden rounded-3xl border border-line bg-canvas shadow-2xl">
<div className="flex items-center gap-3 border-b border-line px-5">
@@ -260,17 +273,17 @@ export default function SearchDialog() {
value={consulta}
onChange={(e) => setConsulta(e.target.value)}
onKeyDown={onInputKey}
placeholder={isEn ? "Ask ESPDocs: “flash s3”, “usb pins c6”, “gpio0 esp32”…" : "Pergunte ao ESPDocs: “flash s3”, “pinos usb c6”, “gpio0 esp32”…"}
placeholder={isEn ? "Ask ESPDocs: “flash s3”, “usb pins c6”, “gpio0 esp32”…" : isEs ? "Pregunte a ESPDocs: “flash s3”, “pines usb c6”, “gpio0 esp32”…" : "Pergunte ao ESPDocs: “flash s3”, “pinos usb c6”, “gpio0 esp32”…"}
className="flex-1 bg-transparent py-5 text-base text-ink outline-none placeholder:text-muted"
autoComplete="off"
spellCheck={false}
aria-label={isEn ? "Search query" : "Termo de busca"}
aria-label={isEn ? "Search query" : isEs ? "Término de búsqueda" : "Termo de busca"}
/>
<button
type="button"
onClick={fechar}
className="grid h-9 w-9 cursor-pointer place-items-center rounded-full text-muted transition-colors hover:bg-surface-2 hover:text-ink"
aria-label={isEn ? "Close search" : "Fechar busca"}
aria-label={isEn ? "Close search" : isEs ? "Cerrar búsqueda" : "Fechar busca"}
>
<X className="h-4 w-4" />
</button>
@@ -278,7 +291,7 @@ export default function SearchDialog() {
{entendeu && (
<div className="flex flex-wrap items-center gap-2 border-b border-line bg-surface px-5 py-2.5">
<span className="text-xs font-semibold text-muted">{isEn ? "Understood:" : "Entendi:"}</span>
<span className="text-xs font-semibold text-muted">{isEn ? "Understood:" : isEs ? "Entendido:" : "Entendi:"}</span>
{interpretacao.chips.map((c) => (
<Pilula key={c.chave} forte>{c.nome}</Pilula>
))}
@@ -290,7 +303,7 @@ export default function SearchDialog() {
{sugestoes.length > 0 && (
<div className="flex flex-wrap items-center gap-2 border-b border-line px-5 py-2.5">
<span className="text-xs font-semibold text-muted">{interpretacao.chips.length ? (isEn ? "Ask about:" : "Perguntar sobre:") : (isEn ? "Which chip?" : "Para qual chip?")}</span>
<span className="text-xs font-semibold text-muted">{interpretacao.chips.length ? (isEn ? "Ask about:" : isEs ? "Preguntar sobre:" : "Perguntar sobre:") : (isEn ? "Which chip?" : isEs ? "¿Para qué chip?" : "Para qual chip?")}</span>
{sugestoes.map((s) => (
<Pilula key={s.rotulo} onClick={() => anexar(s.anexar)}>
{s.rotulo}
@@ -302,21 +315,21 @@ export default function SearchDialog() {
<div ref={listaRef} className="flex-1 overflow-y-auto p-2" role="listbox">
{erro && (
<div className="p-6 text-center">
<p className="text-sm font-semibold text-danger">{isEn ? "Could not load search index." : "Não foi possível carregar o índice de busca."}</p>
<p className="text-sm font-semibold text-danger">{isEn ? "Could not load search index." : isEs ? "No se pudo cargar el índice de búsqueda." : "Não foi possível carregar o índice de busca."}</p>
<button
type="button"
onClick={carregarIndice}
className="btn btn-primary btn-sm mt-3"
>
{isEn ? "Try again" : "Tentar novamente"}
{isEn ? "Try again" : isEs ? "Reintentar" : "Tentar novamente"}
</button>
</div>
)}
{!erro && !indice && <p className="p-6 text-center text-sm text-muted">{isEn ? "Loading…" : "Carregando…"}</p>}
{!erro && !indice && <p className="p-6 text-center text-sm text-muted">{isEn ? "Loading…" : isEs ? "Cargando…" : "Carregando…"}</p>}
{indice && vazia && (
<div className="px-3 pb-3 pt-1">
<p className="text-xs font-semibold text-muted">{isEn ? "Try asking" : "Experimente perguntar"}</p>
<p className="text-xs font-semibold text-muted">{isEn ? "Try asking" : isEs ? "Pruebe a preguntar" : "Experimente perguntar"}</p>
<div className="mt-2 flex flex-wrap gap-2">
{EXEMPLOS.map((ex) => (
<Pilula key={ex} onClick={() => setConsulta(ex)}>
@@ -324,14 +337,14 @@ export default function SearchDialog() {
</Pilula>
))}
</div>
<p className="mt-4 text-xs font-semibold text-muted">{isEn ? "Go to" : "Ir para"}</p>
<p className="mt-4 text-xs font-semibold text-muted">{isEn ? "Go to" : isEs ? "Ir a" : "Ir para"}</p>
</div>
)}
{indice && !vazia && resultados.length === 0 && (
<div className="p-8 text-center">
<p className="font-display text-lg font-semibold text-ink">{isEn ? `No results for “${consulta}”` : `Nenhum resultado para “${consulta}”`}</p>
<p className="mt-1 text-sm text-muted">{isEn ? "Try “brownout”, “flash s3”, “usb pins c6” or “LVGL”." : "Tente “brownout”, “flash s3”, “pinos usb c6” ou “LVGL”."}</p>
<p className="font-display text-lg font-semibold text-ink">{isEn ? `No results for “${consulta}”` : isEs ? `Sin resultados para “${consulta}”` : `Nenhum resultado para “${consulta}”`}</p>
<p className="mt-1 text-sm text-muted">{isEn ? "Try “brownout”, “flash s3”, “usb pins c6” or “LVGL”." : isEs ? "Pruebe “brownout”, “flash s3”, “pines usb c6” o “LVGL”." : "Tente “brownout”, “flash s3”, “pinos usb c6” ou “LVGL”."}</p>
</div>
)}
@@ -396,8 +409,8 @@ export default function SearchDialog() {
<div className="hidden items-center gap-4 border-t border-line bg-surface px-4 py-2.5 text-xs text-muted md:flex">
<span className="flex items-center gap-1"><ArrowUp className="h-3 w-3" /><ArrowDown className="h-3 w-3" /> {isEn ? "navigate" : "navegar"}</span>
<span className="flex items-center gap-1"><CornerDownLeft className="h-3 w-3" /> {isEn ? "open" : "abrir"}</span>
<span><kbd className="font-mono font-semibold">Esc</kbd> {isEn ? "close" : "fechar"}</span>
<span className="ml-auto">{vazia ? (isEn ? "Tip: press / on any page" : "Dica: pressione / em qualquer página") : `${resultados.length} ${isEn ? "result(s)" : "resultado(s)"}`}</span>
<span><kbd className="font-mono font-semibold">Esc</kbd> {isEn ? "close" : isEs ? "cerrar" : "fechar"}</span>
<span className="ml-auto">{vazia ? (isEn ? "Tip: press / on any page" : isEs ? "Consejo: presione / en cualquier página" : "Dica: pressione / em qualquer página") : `${resultados.length} ${isEn ? "result(s)" : "resultado(s)"}`}</span>
</div>
</div>
</div>,
+4 -2
View File
@@ -2,7 +2,9 @@
import { useEffect, useRef, useState } from "react";
export default function SeriesTabMenu({ tabs, isEn = false }) {
export default function SeriesTabMenu({ tabs, isEn = false, isEs = false, locale }) {
const effectiveIsEn = isEn || locale === "en";
const effectiveIsEs = isEs || locale === "es";
const availableTabs = tabs.filter((tab) => tab.available);
const [activeTab, setActiveTab] = useState(availableTabs[0]?.id);
const refs = useRef({});
@@ -59,7 +61,7 @@ export default function SeriesTabMenu({ tabs, isEn = false }) {
return (
<div id="diagrama-abas" className="scroll-mt-28">
<div role="tablist" aria-label={isEn ? "Board and diagram" : "Placa e diagrama"} className="no-scrollbar flex gap-2 overflow-x-auto pb-1">
<div role="tablist" aria-label={effectiveIsEn ? "Board and diagram" : effectiveIsEs ? "Placa y diagrama" : "Placa e diagrama"} className="no-scrollbar flex gap-2 overflow-x-auto pb-1">
{availableTabs.map((tab, indice) => (
<button
key={tab.id}
+422
View File
@@ -0,0 +1,422 @@
[
{
"numero": "1",
"nome": "ANT",
"tipo": "analog",
"funcoes": [
"Conexión de antena de RF (Wi-Fi y Bluetooth)"
],
"categorias": [
"Antena",
"RF"
],
"avisos": [
"Pin de RF dedicado. Evite trazar pistas largas o sin acoplamiento de impedancia de 50 ohms."
]
},
{
"numero": "2",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": [
"Alimentación analógica de 3.3V"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V (3.0V a 3.6V)",
"Suministra energía a los circuitos analógicos y de RF del chip"
]
},
{
"numero": "3",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": [
"Alimentación analógica de 3.3V"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V (3.0V a 3.6V)",
"Suministra energía a los circuitos analógicos y de RF del chip"
]
},
{
"numero": "4",
"nome": "GPIO0",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO0",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": [
"Pin de entrada analógica ADC1 Canal 0"
]
},
{
"numero": "5",
"nome": "GPIO1",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO1",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": [
"Pin de entrada analógica ADC1 Canal 1"
]
},
{
"numero": "6",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO2",
"ADC1_CH2",
"FSPIQ"
],
"categorias": [
"GPIO",
"ADC",
"SPI"
],
"avisos": [
"Mapeado a la función SPI MISO (FSPIQ) por defecto durante el arranque de la flash"
]
},
{
"numero": "7",
"nome": "CHIP_EN",
"tipo": "analog",
"funcoes": [
"Habilitar el chip (Power-up / Reset)"
],
"categorias": [
"Power"
],
"avisos": [
"Activo en alto. Lleve a nivel alto para iniciar el chip.",
"No deje este pin flotando. Use un circuito RC de retardo externo para un arranque estable."
]
},
{
"numero": "8",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO3",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": [
"Pin de entrada analógica ADC1 Canal 3"
]
},
{
"numero": "9",
"nome": "GPIO4",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO4",
"MTMS",
"FSPIQ",
"ADC1_CH4"
],
"categorias": [
"GPIO",
"JTAG",
"SPI",
"ADC"
],
"avisos": [
"Pin multifuncional: JTAG MTMS, SPI2 MISO y ADC1 Canal 4.",
"Puede usarse para depuración JTAG junto con otros pines JTAG."
]
},
{
"numero": "10",
"nome": "GPIO5",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO5",
"MTDI",
"FSPIWP"
],
"categorias": [
"GPIO",
"JTAG",
"SPI"
],
"avisos": [
"Pin multifuncional: JTAG MTDI y SPI2 Write Protect (FSPIWP)."
]
},
{
"numero": "11",
"nome": "VDD3P3_RTC",
"tipo": "power",
"funcoes": [
"Alimentación del dominio RTC e I/Os de bajo consumo"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V"
]
},
{
"numero": "12",
"nome": "GPIO6",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO6",
"MTCK",
"FSPICLK"
],
"categorias": [
"GPIO",
"JTAG",
"SPI"
],
"avisos": [
"Pin multifuncional: JTAG MTCK y SPI2 Clock (FSPICLK)."
]
},
{
"numero": "13",
"nome": "GPIO7",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO7",
"MTDO",
"FSPID"
],
"categorias": [
"GPIO",
"JTAG",
"SPI"
],
"avisos": [
"Pin multifuncional: JTAG MTDO y SPI2 MOSI (FSPID)."
]
},
{
"numero": "14",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO8"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Pin de strapping para control de arranque.",
"Junto con GPIO9, selecciona el modo de arranque del SoC (debe estar en 1 durante el reinicio para Joint Download Boot si GPIO9=0)."
]
},
{
"numero": "15",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO9"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Pin de strapping principal. Nivel alto (1) en el reinicio activa SPI Boot (predeterminado vía pull-up débil).",
"Nivel bajo (0) en el reinicio coloca el chip en modo de descarga UART/SPI."
]
},
{
"numero": "16",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO10",
"FSPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin multifuncional: SPI2 Chip Select 0 (FSPICS0)."
]
},
{
"numero": "17",
"nome": "VDD3P3_CPU",
"tipo": "power",
"funcoes": [
"Alimentación digital de la CPU e I/Os correspondientes (3.3V)"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 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": [
"Pin de recepción UART0 (Serial RX por defecto para grabación y monitorización)."
]
},
{
"numero": "20",
"nome": "GPIO20",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO20",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"Pin de transmisión UART0 (Serial TX por defecto para grabación y monitorización)."
]
},
{
"numero": "21",
"nome": "VDDA",
"tipo": "power",
"funcoes": [
"Alimentación de entrada analógica de 3.3V"
],
"categorias": [
"Power"
]
},
{
"numero": "22",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": [
"Conexión externa del cristal oscilador (Salida)"
],
"categorias": [
"Clock"
]
},
{
"numero": "23",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": [
"Conexión externa del cristal oscilador (Entrada)"
],
"categorias": [
"Clock"
]
},
{
"numero": "24",
"nome": "VDDA",
"tipo": "power",
"funcoes": [
"Alimentación de entrada analógica de 3.3V"
],
"categorias": [
"Power"
]
},
{
"numero": "25",
"nome": "GND",
"tipo": "power",
"funcoes": [
"Pin de conexión a tierra central (Exposed Pad)"
],
"categorias": [
"Power"
],
"avisos": [
"Debe soldarse adecuadamente al plano de tierra (GND) de la PCB para un rendimiento estable y disipación térmica."
]
}
]
+643
View File
@@ -0,0 +1,643 @@
[
{
"numero": "1",
"nome": "LNA_IN",
"tipo": "analog",
"funcoes": [
"Entrada y salida de señales de RF (Wi-Fi y Bluetooth) para la antena"
],
"categorias": [
"Antena"
],
"avisos": [
"Consulte la sección 2.4 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "2",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "3",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "4",
"nome": "XTAL_32K_P",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO0",
"XTAL_32K_P",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"Clock",
"ADC"
]
},
{
"numero": "5",
"nome": "XTAL_32K_N",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO1",
"XTAL_32K_N",
"ADC1_CH1"
],
"categorias": [
"GPIO",
"Clock",
"ADC"
]
},
{
"numero": "6",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO2",
"ADC1_CH2",
"FSPIQ"
],
"categorias": [
"GPIO",
"ADC",
"SPI",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"En realidad, este pin no determina el modo de arranque, pero se recomienda conectarlo con un pull-up para evitar transitorios (consulte la sección 3.1 de la hoja de datos para más detalles)"
]
},
{
"numero": "7",
"nome": "CHIP_EN",
"tipo": "analog",
"funcoes": [
"Habilitar el chip"
],
"categorias": [
"Power"
],
"avisos": [
"Llevar este pin a nivel alto habilitará el funcionamiento del chip",
"Llevar este pin a nivel bajo deshabilitará el funcionamiento del chip",
"No deje este pin flotando, utilice una resistencia pull-up externa"
]
},
{
"numero": "8",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO3",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"ADC"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "9",
"nome": "MTMS",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO4",
"ADC1_CH4",
"FSPIHD",
"MTMS"
],
"categorias": [
"GPIO",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "10",
"nome": "MTDI",
"tipo": "io",
"alimentacao": [
"VDD3P3_RTC"
],
"funcoes": [
"GPIO5",
"ADC2_CH0",
"FSPIWP",
"MTDI"
],
"categorias": [
"GPIO",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "11",
"nome": "VDD3P3_RTC",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio de bajo consumo y parte del dominio digital"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "12",
"nome": "MTCK",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO6",
"FSPICLK",
"MTCK"
],
"categorias": [
"GPIO",
"SPI",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "13",
"nome": "MTDO",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO7",
"FSPID",
"MTDO"
],
"categorias": [
"GPIO",
"SPI",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "14",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO8"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)"
]
},
{
"numero": "15",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO9"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)"
]
},
{
"numero": "16",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO10",
"FSPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "17",
"nome": "VDD3P3_CPU",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio digital"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "18",
"nome": "VDD_SPI",
"tipo": "power",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"Entrada/salida de la alimentación de la flash interna/externa",
"GPIO11"
],
"categorias": [
"Power",
"GPIO"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip",
"Solo puede utilizarse como GPIO si la memoria flash está alimentada por una fuente externa"
]
},
{
"numero": "19",
"nome": "SPIHD",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDD3P3_CPU"
],
"funcoes": [
"GPIO12",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "20",
"nome": "SPIWP",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDD3P3_CPU"
],
"funcoes": [
"GPIO13",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "21",
"nome": "SPICS0",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDD3P3_CPU"
],
"funcoes": [
"GPIO14",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "22",
"nome": "SPICLK",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDD3P3_CPU"
],
"funcoes": [
"GPIO15",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "23",
"nome": "SPID",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDD3P3_CPU"
],
"funcoes": [
"GPIO16",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "24",
"nome": "SPIQ",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDD3P3_CPU"
],
"funcoes": [
"GPIO17",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "25",
"nome": "GPIO18",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO18",
"USB_D-"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "26",
"nome": "GPIO19",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO19",
"USB_D+"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "27",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO20",
"U0RXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "28",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": [
"VDD3P3_CPU"
],
"funcoes": [
"GPIO21",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"Tras el reinicio, este pin estará con el pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "29",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": [
"Entrada/Salida negativa de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.3.2 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "30",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": [
"Entrada/Salida positiva de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.3.2 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "31",
"nome": "VDDA",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "32",
"nome": "VDDA",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "33",
"nome": "GND",
"tipo": "ground",
"funcoes": [
"Referencia eléctrica del circuito (tierra)"
],
"categorias": [
"GND"
]
}
]
+944
View File
@@ -0,0 +1,944 @@
[
{
"numero": "1",
"nome": "VDDA6",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "2",
"nome": "GND",
"tipo": "ground",
"funcoes": [
"Referencia eléctrica del circuito (tierra)"
],
"categorias": [
"GND"
]
},
{
"numero": "3",
"nome": "VDDA7",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "4",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": [
"Entrada/Salida negativa de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.3.3 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "5",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": [
"Entrada/Salida positiva de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.3.3 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "6",
"nome": "VDDA8",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "7",
"nome": "CHIP_PU",
"tipo": "analog",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"Habilitar el chip"
],
"categorias": [
"Power"
],
"avisos": [
"Llevar este pin a nivel alto habilitará el funcionamiento del chip",
"Llevar este pin a nivel bajo deshabilitará el funcionamiento del chip",
"No deje este pin flotando, utilice una resistencia pull-up externa"
]
},
{
"numero": "8",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio digital de bajo consumo"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "9",
"nome": "XTAL_32K_P",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO0",
"LP_GDIO0",
"XTAL_32K_P",
"LP_UART_DTRN"
],
"categorias": [
"GPIO",
"Low Power",
"Clock",
"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",
"Low Power",
"Clock",
"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",
"Low Power",
"UART",
"I2C",
"ADC",
"SPI",
"JTAG",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"La función I2C_SDA está disponible en el modo de bajo consumo (LP)",
"Pin utilizado para depuración",
"Utilizado para controlar la frecuencia del cristal oscilador del chip (consulte la sección 3.5 de la hoja de datos para más detalles)"
]
},
{
"numero": "12",
"nome": "MTDI",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO3",
"LP_GDIO3",
"LP_UART_CTSN",
"LP_I2C_SCL",
"ADC1_CH2",
"MTDI"
],
"categorias": [
"GPIO",
"Low Power",
"UART",
"I2C",
"ADC",
"JTAG",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"La función I2C_SDA está disponible en el modo de bajo consumo (LP)",
"Pin utilizado para depuración",
"Utilizado para controlar la temporización de SDIO Slave (consulte la sección 3.2 de la hoja de datos para más detalles)"
]
},
{
"numero": "13",
"nome": "MTCK",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO4",
"LP_GDIO4",
"LP_UART_RXD",
"ADC1_CH3",
"FSPIHD",
"MTCK"
],
"categorias": [
"GPIO",
"Low Power",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "14",
"nome": "MTDO",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO5",
"LP_GDIO5",
"LP_UART_TXD",
"ADC1_CH4",
"FSPIWP",
"MTDO"
],
"categorias": [
"GPIO",
"Low Power",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "15",
"nome": "GPIO6",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO6",
"LP_GDIO6",
"ADC1_CH5",
"FSPICLK"
],
"categorias": [
"GPIO",
"Low Power",
"ADC",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "16",
"nome": "GPIO7",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO7",
"FSPID",
"SDIO_DATA1"
],
"categorias": [
"GPIO",
"SPI",
"SD"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar la fuente de señales JTAG (consulte la sección 3.4 de la hoja de datos para más detalles)"
]
},
{
"numero": "17",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO8",
"SDIO_DATA0",
"PAD_COMP0"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "18",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO9",
"SDIO_CLK",
"PAD_COMP1"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "19",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO10",
"FSPICS0",
"SDIO_CMD"
],
"categorias": [
"GPIO",
"SPI",
"SD"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "20",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO11",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"Tras el reinicio, este pin estará con el pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "21",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO12",
"U0RXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "22",
"nome": "GPIO13",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO13",
"USB_D-",
"SDIO_DATA3"
],
"categorias": [
"GPIO",
"USB",
"SD"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "23",
"nome": "GPIO14",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO14",
"USB_D+",
"SDIO_DATA4"
],
"categorias": [
"GPIO",
"USB",
"SD"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno para USB activado",
"Tras el reinicio, este pin estará configurado como entrada con el pull-up interno para USB activado",
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "24",
"nome": "VDDPST2",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio digital de alto rendimiento y parte del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "25",
"nome": "SPICS1",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO15",
"SPICS1"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "26",
"nome": "SPICS0",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO16",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "27",
"nome": "SPIQ",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO17",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "28",
"nome": "SPIWP",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO18",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "29",
"nome": "VDD_SPI",
"tipo": "power",
"funcoes": [
"Salida de alimentación para la flash externa",
"GPIO19"
],
"categorias": [
"Power",
"GPIO"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip",
"Solo puede utilizarse como GPIO si la memoria flash externa está alimentada por una fuente externa"
]
},
{
"numero": "30",
"nome": "SPIHD",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO20",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "31",
"nome": "SPICLK",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO21",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "32",
"nome": "SPID",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO22",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "33",
"nome": "GPIO23",
"tipo": "io",
"alimentacao": [
"VDDPST3"
],
"funcoes": [
"GPIO23"
],
"categorias": [
"GPIO"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "34",
"nome": "GPIO24",
"tipo": "io",
"alimentacao": [
"VDDPST3"
],
"funcoes": [
"GPIO24"
],
"categorias": [
"GPIO"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "35",
"nome": "GPIO25",
"tipo": "io",
"alimentacao": [
"VDDPST3"
],
"funcoes": [
"GPIO25"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar la temporización de SDIO Slave (consulte la sección 3.4 de la hoja de datos para mais detalles)"
]
},
{
"numero": "36",
"nome": "GPIO26",
"tipo": "io",
"alimentacao": [
"VDDPST3"
],
"funcoes": [
"GPIO26"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)"
]
},
{
"numero": "37",
"nome": "GPIO27",
"tipo": "io",
"alimentacao": [
"VDDPST3"
],
"funcoes": [
"GPIO27"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)",
"Utilizado para controlar la emisión de mensajes de la ROM en UART0 (consulte la sección 3.3 de la hoja de datos para más detalles)"
]
},
{
"numero": "38",
"nome": "GPIO28",
"tipo": "io",
"alimentacao": [
"VDDPST3"
],
"funcoes": [
"GPIO28"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)"
]
},
{
"numero": "39",
"nome": "VDDPST3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio digital de alto rendimiento"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "40",
"nome": "VDDA1",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "41",
"nome": "VDDA2",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "42",
"nome": "ANT_2G",
"tipo": "analog",
"funcoes": [
"Conexión de la antena RF para la banda de 2 GHz"
],
"categorias": [
"Antena"
],
"avisos": [
"Consulte la sección 2.4 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "43",
"nome": "GND",
"tipo": "ground",
"funcoes": [
"Referencia eléctrica del circuito (tierra)"
],
"categorias": [
"GND"
]
},
{
"numero": "44",
"nome": "VDDA3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "44",
"nome": "VDDA4",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "45",
"nome": "VDDA5",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "47",
"nome": "GND",
"tipo": "ground",
"funcoes": [
"Referencia eléctrica del circuito (tierra)"
],
"categorias": [
"GND"
]
},
{
"numero": "48",
"nome": "ANT_5G",
"tipo": "analog",
"funcoes": [
"Conexión de la antena RF para la banda de 5 GHz"
],
"categorias": [
"Antena"
],
"avisos": [
"Consulte la sección 2.4 de la hoja de datos para más detalles sobre pines analógicos"
]
}
]
+841
View File
@@ -0,0 +1,841 @@
[
{
"numero": "1",
"nome": "ANT",
"tipo": "analog",
"funcoes": [
"Conexión de la antena RF"
],
"categorias": [
"Antena"
],
"avisos": [
"Consulte la sección 2.4 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "2",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "3",
"nome": "VDDA3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "4",
"nome": "CHIP_PU",
"tipo": "analog",
"funcoes": [
"Habilitar el chip"
],
"categorias": [
"Power"
],
"avisos": [
"Llevar este pin a nivel alto habilitará el funcionamiento del chip",
"Llevar este pin a nivel bajo deshabilitará el funcionamiento del chip",
"No deje este pin flotando, utilice una resistencia pull-up externa"
]
},
{
"numero": "5",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio digital de bajo consumo y parte del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "6",
"nome": "XTAL_32K_P",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO0",
"LP_GDIO0",
"XTAL_32K_P",
"LP_UART_DTRN",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"Low Power",
"Clock",
"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",
"Low Power",
"Clock",
"UART",
"ADC"
]
},
{
"numero": "8",
"nome": "GPIO2",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO2",
"LP_GDIO2",
"LP_UART_RTSN",
"ADC1_CH2",
"FSPIQ"
],
"categorias": [
"GPIO",
"Low Power",
"UART",
"ADC",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "9",
"nome": "GPIO3",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO3",
"LP_GDIO3",
"LP_UART_CTSN",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"Low Power",
"UART",
"ADC"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "10",
"nome": "MTMS",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO4",
"LP_GDIO4",
"LP_UART_RXD",
"ADC1_CH3",
"FSPIHD",
"MTMS"
],
"categorias": [
"GPIO",
"Low Power",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración",
"Utilizado para controlar la temporización de SDIO Slave (consulte la sección 3.2 de la hoja de datos para más detalles)"
]
},
{
"numero": "11",
"nome": "MTDI",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO5",
"LP_GDIO5",
"LP_UART_TXD",
"ADC1_CH5",
"FSPIWP",
"MTDI"
],
"categorias": [
"GPIO",
"Low Power",
"UART",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración",
"Utilizado para controlar la temporización de SDIO Slave (consulte la sección 3.2 de la hoja de datos para más detalles)"
]
},
{
"numero": "12",
"nome": "MTCK",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO6",
"LP_GDIO6",
"LP_I2C_SDA",
"ADC1_CH6",
"FSPICLK",
"MTCK"
],
"categorias": [
"GPIO",
"Low Power",
"I2C",
"ADC",
"SPI",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"La función I2C_SDA está disponible en el modo de bajo consumo (LP)",
"Pin utilizado para depuración"
]
},
{
"numero": "13",
"nome": "MTDO",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO7",
"LP_GDIO7",
"LP_I2C_SCL",
"FSPID",
"MTDO"
],
"categorias": [
"GPIO",
"Low Power",
"I2C",
"SPI",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"La función I2C_SDA está disponible en el modo de bajo consumo (LP)",
"Pin utilizado para depuración"
]
},
{
"numero": "14",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO8"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)",
"Utilizado para controlar la emisión de mensajes de la ROM en UART0 (consulte la sección 3.3 de la hoja de datos para más detalles)"
]
},
{
"numero": "15",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO9"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)"
]
},
{
"numero": "16",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO10"
],
"categorias": [
"GPIO"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "17",
"nome": "GPIO11",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO11"
],
"categorias": [
"GPIO"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "18",
"nome": "GPIO12",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO12",
"USB_D-"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "19",
"nome": "GPIO13",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO13",
"USB_D+"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "20",
"nome": "SPICS0",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO24",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "21",
"nome": "SPIQ",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO25",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "22",
"nome": "SPIWP",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO26",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "23",
"nome": "VDD_SPI",
"tipo": "power",
"funcoes": [
"Entrada/Salida de alimentación para la memoria flash",
"GPIO27"
],
"categorias": [
"Power",
"GPIO"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip",
"Solo puede utilizarse como GPIO si la memoria flash externa está alimentada por una fuente externa"
]
},
{
"numero": "24",
"nome": "SPIHD",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO28",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "25",
"nome": "SPICLK",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO29",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "26",
"nome": "SPID",
"tipo": "io",
"alimentacao": [
"VDD_SPI"
],
"funcoes": [
"GPIO30",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado por la memoria flash SPI",
"No se recomienda utilizar este pin como GPIO"
]
},
{
"numero": "27",
"nome": "GPIO15",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO15"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar la fuente de señales JTAG (consulte la sección 3.4 de la hoja de datos para más detalles)"
]
},
{
"numero": "28",
"nome": "VDDA2",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio digital de alto rendimiento"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "29",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO16",
"U0TXD",
"FSPICS0"
],
"categorias": [
"GPIO",
"UART",
"SPI"
],
"avisos": [
"Tras el reinicio, este pin estará con el pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "30",
"nome": "U0RXD",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO17",
"U0RXD",
"FSPICS1"
],
"categorias": [
"GPIO",
"UART",
"SPI"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "31",
"nome": "SDIO_CMD",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO18",
"SDIO_CMD",
"FSPICS2"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "32",
"nome": "SDIO_CLK",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO19",
"SDIO_CLK",
"FSPICS3"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "33",
"nome": "SDIO_DATA0",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO20",
"SDIO_DATA0",
"FSPICS4"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "34",
"nome": "SDIO_DATA1",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO21",
"SDIO_DATA1",
"FSPICS5"
],
"categorias": [
"GPIO",
"SD",
"SPI"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "35",
"nome": "SDIO_DATA2",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO22",
"SDIO_DATA2"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "36",
"nome": "SDIO_DATA3",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO23",
"SDIO_DATA3"
],
"categorias": [
"GPIO",
"SD"
],
"avisos": [
"Durante el reinicio, este pin estará con el pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada"
]
},
{
"numero": "37",
"nome": "VDDA1",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "38",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": [
"Entrada/Salida negativa de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.4 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "39",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": [
"Entrada/Salida positiva de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.4 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "40",
"nome": "VDDA2",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "41",
"nome": "GND",
"tipo": "ground",
"funcoes": [
"Referencia eléctrica del circuito (tierra)"
],
"categorias": [
"GND"
]
}
]
+729
View File
@@ -0,0 +1,729 @@
[
{
"numero": "1",
"nome": "ANT_2G",
"tipo": "analog",
"funcoes": [
"Conexión de antena de RF (Wi-Fi y Bluetooth)"
],
"categorias": [
"Antena",
"RF"
],
"avisos": [
"Pin de RF dedicado a 2.4 GHz. Requer casamento de impedância de 50 ohms."
]
},
{
"numero": "2",
"nome": "VDDA3",
"tipo": "power",
"funcoes": [
"Alimentación del dominio analógico de 3.3V"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V (3.0V a 3.6V). Fornece energia para circuitos de RF e clock."
]
},
{
"numero": "3",
"nome": "VDDA4",
"tipo": "power",
"funcoes": [
"Alimentación del dominio analógico de 3.3V"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V (3.0V a 3.6V). Fornece energia para circuitos de RF e clock."
]
},
{
"numero": "4",
"nome": "CHIP_PU",
"tipo": "analog",
"funcoes": [
"Habilitar el chip (Power-up / Reset)"
],
"categorias": [
"Power"
],
"avisos": [
"Activo en alto. Lleve a nivel alto para iniciar el chip.",
"No deje este pin flotando. Se recomienda usar un circuito RC de retardo externo para un reinicio limpio."
]
},
{
"numero": "5",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": [
"Alimentación digital de los dominios HP (High Performance) y LP (Low Power)"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V. Alimenta a parte digital de baixo consumo e pinos associados."
]
},
{
"numero": "6",
"nome": "GPIO0",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO0",
"XTAL_32K_P"
],
"categorias": [
"GPIO",
"Clock"
],
"avisos": [
"Pin multifuncional de bajo consumo. Puede conectarse al cristal oscilador de 32 kHz externo (Entrada P)."
]
},
{
"numero": "7",
"nome": "GPIO1",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO1",
"XTAL_32K_N",
"ADC1_CH0"
],
"categorias": [
"GPIO",
"Clock",
"ADC"
],
"avisos": [
"Pin multifuncional. Conexión del cristal de 32 kHz externo (Salida N) y entrada analógica ADC1 Canal 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",
"Strapping"
],
"avisos": [
"Pin multifuncional: JTAG MTMS, ADC1 Canal 1 y pin de strapping para control de flanco de reloj de SDIO.",
"Flotante por defecto durante el reinicio."
]
},
{
"numero": "10",
"nome": "GPIO4",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO4",
"MTDI",
"ADC1_CH2"
],
"categorias": [
"GPIO",
"JTAG",
"ADC",
"Strapping"
],
"avisos": [
"Pin multifuncional: JTAG MTDI, ADC1 Canal 2 y pin de strapping para control de flanco de reloj de SDIO.",
"Flotante por defecto durante el reinicio."
]
},
{
"numero": "11",
"nome": "GPIO5",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO5",
"MTCK",
"ADC1_CH3"
],
"categorias": [
"GPIO",
"JTAG",
"ADC"
],
"avisos": [
"Pin multifuncional: JTAG MTCK e entrada analógica ADC1 Canal 3."
]
},
{
"numero": "12",
"nome": "GPIO6",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO6",
"MTDO"
],
"categorias": [
"GPIO",
"JTAG"
],
"avisos": [
"Pin multifuncional JTAG MTDO."
]
},
{
"numero": "13",
"nome": "GPIO25",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO25",
"SDIO_CMD",
"FSPICS0"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": [
"Pin multifuncional de alta velocidade: SDIO Comando ou SPI2 Chip Select 0."
]
},
{
"numero": "14",
"nome": "GPIO26",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO26",
"SDIO_CLK",
"FSPICLK"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": [
"Pin multifuncional de alta velocidade: SDIO Clock ou SPI2 Clock."
]
},
{
"numero": "15",
"nome": "GPIO27",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO27",
"SDIO_DATA0",
"FSPID"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": [
"Pin multifuncional de alta velocidade: SDIO Dados 0 ou SPI2 MOSI (FSPID)."
]
},
{
"numero": "16",
"nome": "GPIO28",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO28",
"SDIO_DATA1",
"FSPIQ"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": [
"Pin de alta velocidade: SDIO Dados 1 ou SPI2 MISO (FSPIQ)."
]
},
{
"numero": "17",
"nome": "GPIO22",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO22",
"SDIO_DATA2",
"FSPIWP"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": [
"Pin de alta velocidade: SDIO Dados 2 ou SPI2 Write Protect."
]
},
{
"numero": "18",
"nome": "GPIO23",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO23",
"SDIO_DATA3",
"FSPIHD"
],
"categorias": [
"GPIO",
"SDIO",
"SPI"
],
"avisos": [
"Pin de alta velocidade: SDIO Dados 3 ou SPI2 Hold."
]
},
{
"numero": "19",
"nome": "GPIO14",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDDPST2"
],
"funcoes": [
"GPIO14",
"SPICS1"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin dedicado para Chip Select 1 de la interfaz de memoria SPI Flash/PSRAM."
]
},
{
"numero": "20",
"nome": "GPIO15",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDDPST2"
],
"funcoes": [
"GPIO15",
"SPICS0"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin dedicado para Chip Select 0 de la interfaz de memoria SPI Flash."
]
},
{
"numero": "21",
"nome": "VDDPST2",
"tipo": "power",
"funcoes": [
"Alimentación del dominio digital HP (High Performance)"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V (3.0V a 3.6V). Alimenta as interfaces digitais rápidas."
]
},
{
"numero": "22",
"nome": "GPIO16",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDDPST2"
],
"funcoes": [
"GPIO16",
"SPIQ"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin de datos Q (MISO) de la interfaz de memoria flash SPI."
]
},
{
"numero": "23",
"nome": "GPIO17",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDDPST2"
],
"funcoes": [
"GPIO17",
"SPIWP"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin de protección contra escritura (Write Protect) de la interfaz de memoria flash SPI."
]
},
{
"numero": "24",
"nome": "VDD_SPI",
"tipo": "power",
"funcoes": [
"Tensión de salida LDO gerada a partir de VDDPST2 para lalimentar a flash e PSRAM"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión de salida configurable por software de acuerdo con las especificaciones de la flash interna/externa (normalmente 3.3V o 1.8V).",
"No debe usarse como fuente general de energía de alta corriente."
]
},
{
"numero": "25",
"nome": "GPIO19",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDDPST2"
],
"funcoes": [
"GPIO19",
"SPIHD"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin de control de Hold de la interfaz de memoria flash SPI."
]
},
{
"numero": "26",
"nome": "GPIO20",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDDPST2"
],
"funcoes": [
"GPIO20",
"SPICLK"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin de señal de reloj de la interfaz de memoria flash SPI."
]
},
{
"numero": "27",
"nome": "GPIO21",
"tipo": "io",
"alimentacao": [
"VDD_SPI",
"VDDPST2"
],
"funcoes": [
"GPIO21",
"SPID"
],
"categorias": [
"GPIO",
"SPI"
],
"avisos": [
"Pin de datos D (MOSI) de la interfaz de memoria flash SPI."
]
},
{
"numero": "28",
"nome": "GPIO12",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO12",
"USB_D-"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"Pin de señal negativa del transceptor USB Serial/JTAG integrado."
]
},
{
"numero": "29",
"nome": "GPIO13",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO13",
"USB_D+"
],
"categorias": [
"GPIO",
"USB"
],
"avisos": [
"Pin de señal positiva del transceptor USB Serial/JTAG integrado.",
"Dispone de pull-up integrado activado por defecto en el arranque del 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",
"Strapping"
],
"avisos": [
"Pin de strapping para selección del modo de arranque y control de emisión de mensajes de la ROM.",
"Flotante por defecto durante el reinicio. Nivel alto (1) activa la emisión del registro de arranque."
]
},
{
"numero": "32",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO9"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Pin de strapping principal para selección del modo de arranque.",
"Equipado con pull-up débil integrado. Nivel alto (1) en el reinicio activa SPI Boot (carga desde la flash). Nivel bajo (0) fuerza el modo Download."
]
},
{
"numero": "33",
"nome": "GPIO10",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO10",
"U0RXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"Recepción serial UART0 (Serial RX para grabación del firmware externa y depuración)."
]
},
{
"numero": "34",
"nome": "GPIO11",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO11",
"U0TXD"
],
"categorias": [
"GPIO",
"UART"
],
"avisos": [
"Transmisión serial UART0 (Serial TX para grabación del firmware externa y depuración)."
]
},
{
"numero": "35",
"nome": "GPIO29",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO29"
],
"categorias": [
"GPIO"
]
},
{
"numero": "36",
"nome": "GPIO7",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO7"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Pin de strapping para selección de la fuente de señales JTAG (arranque temprano).",
"Sin resistencias de pull internas en el reinicio. Debe mantenerse estable mediante circuito externo si se utiliza."
]
},
{
"numero": "37",
"nome": "VDDA1",
"tipo": "power",
"funcoes": [
"Alimentación del dominio analógico de 3.3V"
],
"categorias": [
"Power"
]
},
{
"numero": "38",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": [
"Conexión externa del cristal oscilador de 40 MHz (Salida N)"
],
"categorias": [
"Clock"
]
},
{
"numero": "39",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": [
"Conexión externa del cristal oscilador de 40 MHz (Entrada P)"
],
"categorias": [
"Clock"
]
},
{
"numero": "40",
"nome": "VDDA2",
"tipo": "power",
"funcoes": [
"Alimentación del dominio analógico de 3.3V"
],
"categorias": [
"Power"
]
},
{
"numero": "41",
"nome": "GND",
"tipo": "power",
"funcoes": [
"Pin de conexión a tierra central (Exposed Pad)"
],
"categorias": [
"Power"
],
"avisos": [
"Debe soldarse adecuadamente al plano de masa (GND) de la PCB para un control de RF y térmico estable."
]
}
]
+603
View File
@@ -0,0 +1,603 @@
[
{
"numero": "1",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "2",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"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": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "6",
"nome": "MTDO",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO3",
"FSPIHD",
"ADC1_CH2",
"MTDO"
],
"categorias": [
"GPIO",
"SPI",
"ADC",
"JTAG"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "7",
"nome": "MTCK",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO4",
"FSPICLK",
"ADC1_CH3",
"MTCK"
],
"categorias": [
"GPIO",
"SPI",
"ADC",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "8",
"nome": "MTDI",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO5",
"FSPID",
"ADC1_CH4",
"MTDI"
],
"categorias": [
"GPIO",
"SPI",
"ADC",
"JTAG"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Pin utilizado para depuración"
]
},
{
"numero": "9",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio de E/S"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "10",
"nome": "GPIO8",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO8"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)",
"Utilizado para controlar la emisión de mensajes de la ROM en UART0 (consulte la sección 3.3 de la hoja de datos para más detalles)"
]
},
{
"numero": "11",
"nome": "GPIO9",
"tipo": "io",
"alimentacao": [
"VDDPST1"
],
"funcoes": [
"GPIO9"
],
"categorias": [
"GPIO",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Utilizado para controlar el modo de arranque del chip (consulte la sección 3.1 de la hoja de datos para más detalles)"
]
},
{
"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",
"Clock"
]
},
{
"numero": "16",
"nome": "XTAL_32K_N",
"tipo": "io",
"alimentacao": [
"VDDA_PMU",
"VBAT"
],
"funcoes": [
"GPIO14",
"XTAL_32K_N"
],
"categorias": [
"GPIO",
"Clock"
]
},
{
"numero": "17",
"nome": "CHIP_EN",
"tipo": "analog",
"alimentacao": [
"VBAT"
],
"funcoes": [
"Habilitar el chip"
],
"categorias": [
"Power"
],
"avisos": [
"Llevar este pin a nivel alto habilitará el funcionamiento del chip",
"Llevar este pin a nivel bajo deshabilitará el funcionamiento del chip",
"No deje este pin flotando, utilice una resistencia pull-up externa"
]
},
{
"numero": "18",
"nome": "VBAT",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico o de la batería"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "19",
"nome": "VDDA_PMU",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "20",
"nome": "VDDPST1",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio de E/S"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"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": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "23",
"nome": "U0TXD",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO24",
"U0TXD",
"FSPICS2"
],
"categorias": [
"GPIO",
"UART",
"SPI"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con pull-up interno activado",
"Pin utilizado para depuración"
]
},
{
"numero": "24",
"nome": "GPIO25",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO24",
"FSPICS3"
],
"categorias": [
"GPIO",
"SPI",
"Strapping"
],
"avisos": [
"Durante el reinicio, este pin estará configurado como entrada",
"Tras el reinicio, este pin estará configurado como entrada",
"Utilizado para controlar la fuente de señales JTAG (consulte la sección 3.3 de la hoja de datos para más detalles)"
]
},
{
"numero": "25",
"nome": "GPIO26",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO26",
"FSPICS4",
"USB_D-"
],
"categorias": [
"GPIO",
"SPI",
"USB"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada",
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "26",
"nome": "GPIO27",
"tipo": "io",
"alimentacao": [
"VDDPST2"
],
"funcoes": [
"GPIO27",
"FSPICS5",
"USB_D+"
],
"categorias": [
"GPIO",
"SPI",
"USB"
],
"avisos": [
"Tras el reinicio, este pin estará configurado como entrada con el pull-up interno para USB activado",
"Por defecto, este pin se utiliza para USB Serial/JTAG"
]
},
{
"numero": "27",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "28",
"nome": "XTAL_N",
"tipo": "analog",
"funcoes": [
"Entrada/Salida negativa de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.3.2 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "29",
"nome": "XTAL_P",
"tipo": "analog",
"funcoes": [
"Entrada/Salida positiva de reloj"
],
"categorias": [
"Clock"
],
"avisos": [
"Consulte la sección 2.3.2 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "30",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "31",
"nome": "VDD3P3",
"tipo": "power",
"funcoes": [
"Entrada de alimentación del dominio analógico"
],
"categorias": [
"Power"
],
"avisos": [
"Tensión recomendada: 3.3V",
"Tensión mínima recomendada: 3.0V",
"Tensión máxima recomendada: 3.6V",
"Consulte la sección 2.5 de la hoja de datos para más detalles sobre la alimentación del chip"
]
},
{
"numero": "32",
"nome": "ANT",
"tipo": "analog",
"funcoes": [
"Conexión de la antena RF"
],
"categorias": [
"Antena"
],
"avisos": [
"Consulte la sección 2.4 de la hoja de datos para más detalles sobre pines analógicos"
]
},
{
"numero": "33",
"nome": "GND",
"tipo": "ground",
"funcoes": [
"Referencia eléctrica del circuito (tierra)"
],
"categorias": [
"GND"
]
}
]
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+411
View File
@@ -0,0 +1,411 @@
{
"ESP-IDF": {
"nome": "ESP-IDF",
"icone": "⚙️",
"nome_completo": "Espressif IoT Development Framework",
"descricao": "Framework oficial nativo de Espressif para todos los SoCs ESP32. Basado en FreeRTOS multinúcleo y CMake, ofrece control total del silicio, periféricos, radio y arquitectura de componentes modulares.",
"linguagem": "C / C++",
"tipo": "Framework Base Oficial",
"funcao_principal": "Desarrollo industrial y de alto rendimiento con acceso directo a registros, RTOS en tiempo real y pila completa de protocolos",
"caracteristicas": [
"Sistema operativo de tiempo real (FreeRTOS SMP multinúcleo)",
"Soporte nativo para ESP Component Registry mediante idf_component.yml",
"Pila completa de conectividad Wi-Fi 4/6, BLE 5.x, Zigbee y Thread",
"Soporte para todos los SoCs (ESP32, S2, S3, C2, C3, C6, H2, P4)",
"Gestión avanzada de energía y modos Deep Sleep",
"Seguridad robusta: Secure Boot v2, cifrado de flash y criptografía por hardware",
"Actualizaciones OTA cifradas con reversión automática",
"Cadena de herramientas moderna Clang/GCC, soporte para C++23 y depuración mediante JTAG OpenOCD"
],
"casos_uso": [
"Productos comerciales e industriales de IoT",
"Dispositivos con requisitos estrictos de batería y consumo",
"Aplicaciones en tiempo real con control preciso de interrupciones",
"Sistemas de seguridad con criptografía por hardware",
"Gateways multiprotocolo de alto rendimiento"
],
"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": "Plataforma completa de nube y firmware de Espressif para productos conectados. Permite crear dispositivos IoT sin necesidad de desarrollar backend o aplicaciones móviles desde cero.",
"linguagem": "C / C++",
"tipo": "Cloud & AIoT Framework",
"funcao_principal": "Construcción acelerada de productos inteligentes con aplicación móvil (iOS/Android), nube AWS Serverless y control por voz (Alexa/Google Home)",
"caracteristicas": [
"Aprovisionamiento Wi-Fi y BLE asistido mediante aplicación oficial",
"Generación dinámica de interfaz en la app según los parámetros del firmware",
"Integración nativa con Alexa y Google Assistant",
"Soporte simultáneo para control local (Local Control vía mDNS/HTTP) y nube",
"Panel administrativo (RainMaker Dashboard) para gestión de flotas y OTA",
"Compatibilidad nativa con nodos Matter y Bridge de dispositivos",
"Biblioteca integrada mediante ESP Component Registry (espressif/esp_rainmaker)"
],
"casos_uso": [
"Electrodomésticos inteligentes y línea blanca conectada",
"Iluminación inteligente y enchufes inteligentes para el consumidor final",
"Sistemas de climatización (HVAC) y termostatos conectados",
"Prototipos de IoT comercial con validación rápida de mercado",
"Productos que requieren certificación para Apple Home, Alexa y Google Home"
],
"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": "SDK oficial de Espressif para el nuevo estándar unificado de hogar inteligente Matter (CSA). Permite interoperabilidad directa con Apple HomeKit, Google Home, Alexa y Home Assistant sin intermediarios.",
"linguagem": "C++",
"tipo": "Smart Home Framework",
"funcao_principal": "Desarrollo de dispositivos y puentes inteligentes compatibles con Matter sobre Wi-Fi o Thread",
"caracteristicas": [
"Soporte completo para Matter over Wi-Fi y Matter over Thread",
"Módulos listos para Matter Bridge (puenteando dispositivos Zigbee/BLE a redes Matter)",
"Integración nativa con clusters estándar (Light, Switch, Plug, Sensor, Door Lock)",
"Aprovisionamiento seguro mediante BLE y código QR",
"Soporte para múltiples fabrics simultáneos (control por Apple y Google al mismo tiempo)",
"Compatible con ESP32-C6, ESP32-H2 y chips Wi-Fi clásicos (ESP32/S3) con coprocesador Thread"
],
"casos_uso": [
"Lámparas, enchufes e interruptores con certificación Matter",
"Cerraduras electrónicas y controles de acceso conectados",
"Puentes y pasarelas Matter-to-Zigbee para migración de productos legados",
"Sensores ambientales y de presencia compatibles con ecosistemas múltiples",
"Dispositivos que exigen interoperabilidad entre Apple HomeKit, Alexa y Google Home"
],
"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": "Espressif Audio Development Framework. Marco de trabajo completo para procesamiento de audio digital, códecs, transmisión por streaming y desarrollo de altavoces inteligentes.",
"linguagem": "C / C++",
"tipo": "Framework de Audio y Voz",
"funcao_principal": "Creación de flujos de audio flexibles con decodificadores, ecualizadores, mezcladores y compatibilidad con protocolos de streaming",
"caracteristicas": [
"Arquitectura en pipelines de audio con elementos modulares (Audio Elements)",
"Códecs integrados por software y hardware: MP3, AAC, FLAC, WAV, OGG, Opus",
"Compatibilidad con códecs de hardware externos vía I2S (ES8388, ES8311, TAS5805M)",
"Clientes de streaming de audio: HTTP Live Streaming, Apple AirPlay, DLNA, Icecast",
"Integración con micrófonos MEMS para cancelación de eco acústico (AEC)",
"Controladores para pantallas y botones en placas como ESP32-LyraT y ESP32-Korvo"
],
"casos_uso": [
"Altavoces inteligentes y asistentes de voz conectados",
"Radios por Internet y reproductores de música en red",
"Intercomunicadores IP y timbres con audio bidireccional",
"Dispositivos de audio Bluetooth con receptor y transmisor A2DP",
"Grabadoras y procesadores de sonido ambiental para monitoreo acústico"
],
"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": "Espressif Speech Recognition Framework. Conjunto de algoritmos de inteligencia artificial para procesamiento de voz local, sin necesidad de conexión a Internet ni envío de audio a la nube.",
"linguagem": "C / C++",
"tipo": "Framework de Voz e IA",
"funcao_principal": "Procesamiento de voz local, detección de palabra de activación (Wake Word) y reconocimiento de comandos de voz fuera de línea",
"caracteristicas": [
"Detección de palabra de activación (Wake Word Detection - WakeNet) con bajo consumo y alta precisión",
"Reconocimiento de comandos de voz fuera de línea (Command Recognition - MultiNet) con cientos de comandos",
"Front-end acústico (AFE) para reducción de ruido, supresión de eco acústico (AEC) y formación de haz (Beamforming)",
"Optimizado para instrucciones vectoriales en Xtensa LX7 (ESP32-S3) y RISC-V",
"Soporte multilingüe para palabras de activación y comandos configurables",
"Modelos compactos que caben en la memoria SRAM/PSRAM del microcontrolador"
],
"casos_uso": [
"Electrodomésticos y paneles con control por voz fuera de línea",
"Dispositivos de automatización residencial sin dependencia de la nube",
"Juguetes interactivos y robots con respuesta por voz inmediata",
"Sistemas industriales con comandos de manos libres en entornos ruidosos",
"Front-end de audio para captación de voz en altavoces con Alexa/Google integrados"
],
"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": "Colección de controladores de periféricos, bibliotecas de sensores, actuadores y componentes de software probados para su uso con ESP-IDF.",
"linguagem": "C / C++",
"tipo": "Biblioteca de Periféricos y Drivers",
"funcao_principal": "Acelerar la integración de componentes de hardware (pantallas LCD/OLED, sensores, botones y buses industriales) en ESP-IDF",
"caracteristicas": [
"Controladores para pantallas LCD (ST7789, ILI9341, GC9A01) y OLED (SSD1306) con aceleración gráfica",
"Controladores para sensores de temperatura, humedad, presión (BME280, SHT30) y acelerómetros",
"Gestión avanzada de botones con detección de clic simple, doble, pulsación larga y matriz de teclas",
"Control de motores BLDC y paso a paso con biblioteca MCPWM dedicada",
"Bibliotecas para buses industriales: Modbus Master/Slave, bus CAN/TWAI y RS-485",
"Distribución modular a través de ESP Component Registry"
],
"casos_uso": [
"Interfaces hombre-máquina (HMI) con pantallas a color y perillas codificadoras rotativas",
"Estaciones meteorológicas y monitoreo ambiental industrial",
"Controladores de motores y actuadores para automatización y robótica",
"Gateways Modbus/RS-485 para telemetría industrial",
"Proyectos que requieren integración rápida de sensores y pantallas comerciales"
],
"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": "Protocolo de comunicación inalámbrica sin conexión desarrollado por Espressif. Permite la transmisión ultrarrápida de paquetes cortos entre dispositivos ESP32 sin necesidad de enrutador Wi-Fi.",
"linguagem": "C / C++",
"tipo": "Protocolo de Red y Malla",
"funcao_principal": "Intercambio de mensajes punto a punto, broadcast y formación de redes en malla de baja latencia y consumo mínimo",
"caracteristicas": [
"Comunicación directa entre chips sin handshake ni asociación Wi-Fi (latencia típica < 5 ms)",
"Cifrado seguro de paquetes mediante claves precompartidas CCMP/AES-128",
"Compatible con transmisiones punto a punto, punto a multipunto y broadcast",
"Paquetes de carga útil de hasta 250 bytes por trama",
"Coexistencia nativa con modo Wi-Fi Station o SoftAP tradicional en el mismo chip",
"Soporte para ESP-NOW Mesh para retransmisión de datos en múltiples saltos"
],
"casos_uso": [
"Sensores a batería que despiertan de Deep Sleep, transmiten datos y duermen en < 100 ms",
"Controles remotos industriales y de robótica de latencia ultrabaja",
"Interruptores inalámbricos y mandos de pared para automatización doméstica",
"Redes de sensores agrícolas distribuidas en áreas sin cobertura Wi-Fi",
"Sistemas de emergencia y alarmas de disparo instantáneo"
],
"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 oficial para desarrollo de redes Zigbee 3.0 en SoCs Espressif con radio IEEE 802.15.4 (ESP32-H2, ESP32-C6 y ESP32-H4). Integra la pila ZBOSS de DSR.",
"linguagem": "C / C++",
"tipo": "Smart Home & Mesh",
"funcao_principal": "Construcción de redes de automatización ultraligeras y de bajo consumo en topología de malla Zigbee",
"caracteristicas": [
"Pila certificada Zigbee PRO con especificación Zigbee 3.0 completa (ZBOSS)",
"Soporte para roles de Coordinador (Coordinator), Enrutador (Router) y Dispositivo Final (End Device)",
"Soporte para dispositivos durmientes de ultra bajo consumo (Sleepy End Devices - SED)",
"Clusters estándar de automatización: On/Off, Level Control, Color Control, Temperature Measurement",
"Integración con Matter mediante funcionalidad de puente Zigbee-to-Matter (Bridge)",
"Coexistencia de radio con Wi-Fi y Bluetooth en el ESP32-C6"
],
"casos_uso": [
"Sensores de puerta/ventana, presencia y temperatura que funcionan años con pilas botón",
"Lámparas inteligentes y bombillas que forman la red en malla Zigbee",
"Coordinadores de red Zigbee para integración directa con Home Assistant (ZHA/Zigbee2MQTT)",
"Enchufes inteligentes y relés empotrables con reporte de energía",
"Puentes y pasarelas de automatización residencial industrial"
],
"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": "Plataforma de desarrollo para aplicaciones de visión artificial y procesamiento de imágenes, con soporte para cámaras DVP y MIPI CSI en SoCs como ESP32-S3 y ESP32-P4.",
"linguagem": "C / C++",
"tipo": "Visión por Computadora e IA",
"funcao_principal": "Detección de rostros, identificación biométrica, detección de personas y reconocimiento visual en el borde",
"caracteristicas": [
"Modelos integrados para detección de rostros humanos (Human Face Detection)",
"Reconocimiento e identificación facial con registro local de usuarios autorizados",
"Detección de presencia humana (Human Face/Body Detection)",
"Controladores optimizados para sensores de cámara OmniVision (OV2640, OV3660, OV5640)",
"Aceleración mediante instrucciones SIMD vectoriales en ESP32-S3 y ESP32-P4",
"Transmisión de video vía servidor HTTP/WebSocket MJPEG en Wi-Fi local"
],
"casos_uso": [
"Timbres con video y cámaras de seguridad conectadas con IA local",
"Control de acceso y cerraduras inteligentes con reconocimiento biométrico facial",
"Sensores de ocupación de salas y conteo de personas sin envío de imágenes a la nube",
"Inspección visual básica y lectura de códigos QR en líneas de producción",
"Juguetes inteligentes y dispositivos interactivos con seguimiento de personas"
],
"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": "Biblioteca de núcleos optimizados de redes neuronales de Espressif. Sirve como capa base de aceleración de hardware para TensorFlow Lite for Microcontrollers y otros motores de inferencia.",
"linguagem": "C / C++",
"tipo": "Biblioteca Especializada de IA",
"funcao_principal": "Aceleración de inferencia de redes neuronales profundas con cuantización int8 y punto flotante en Xtensa y RISC-V",
"caracteristicas": [
"Núcleos optimizados en ensamblador con extensiones vectoriales e instrucciones SIMD",
"Operaciones aceleradas: convoluciones 2D (Conv2D), Depthwise Conv2D, Fully Connected y Pooling",
"Integración directa como backend de aceleración para TensorFlow Lite Micro (TFLite Micro)",
"Aumento de velocidad de hasta 3x a 5x en comparación con implementaciones estándar de referencia en C",
"Soporte para operaciones con cuantización simétrica int8 para máxima eficiencia de memoria",
"Código abierto disponible en GitHub y ESP Component Registry"
],
"casos_uso": [
"Modelos TinyML para mantenimiento predictivo y análisis de vibraciones mecánicas",
"Detección de anomalías en señales acústicas e industriales",
"Clasificación de audio y eventos sonoros (rotura de cristales, llanto de bebé, disparos)",
"Reconocimiento de gestos mediante acelerómetros y sensores IMU de 6 ejes",
"Inferencia de redes convolucionales compactas para visión en el borde"
],
"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": "Biblioteca oficial de procesamiento digital de señales (DSP) para SoCs ESP32. Proporciona implementaciones matemáticas de alto rendimiento optimizadas a nivel de ensamblador.",
"linguagem": "C / C++",
"tipo": "Biblioteca Especializada de Señales",
"funcao_principal": "Ejecución de cálculos matemáticos pesados como FFT, transformadas, filtrado digital IIR/FIR y operaciones con matrices",
"caracteristicas": [
"Transformadas Rápidas de Fourier (Radix-2 y Radix-4 FFT) en punto flotante y entero",
"Filtros digitales FIR e IIR optimizados para audio y procesamiento de sensores",
"Operaciones matriciales (multiplicación, inversión, transposición) con aceleración vectorial",
"Generación de señales, funciones de correlación cruzada y cálculo de densidad espectral",
"Optimizaciones específicas para FPU e instrucciones vectoriales de Xtensa LX7 y RISC-V",
"Documentación completa con benchmarks de ciclos de reloj para cada función"
],
"casos_uso": [
"Ecualización y filtrado de audio en tiempo real en sistemas de altavoces",
"Análisis espectral y detección de frecuencias dominantes en mantenimiento predictivo",
"Procesamiento de señales biomédicas (ECG, PPG, EEG) en dispositivos de salud",
"Filtrado digital de ruido en sensores analógicos de alta precisión",
"Algoritmos de control avanzado (filtros de Kalman) para navegación y robótica"
],
"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": "Ecosistema oficial de soporte para el lenguaje Rust en chips ESP32 (desarrollado por Espressif). Ofrece seguridad de memoria sin garbage collector, con opción de runtime bare-metal o sobre ESP-IDF.",
"linguagem": "Rust",
"tipo": "Lenguaje y Framework Moderno",
"funcao_principal": "Desarrollo de firmware seguro y de alto rendimiento tanto en modo bare-metal (no_std) como con acceso al ecosistema estándar (std / esp-idf-svc)",
"caracteristicas": [
"Seguridad de memoria en tiempo de compilación (sin punteros nulos, buffer overflows ni data races)",
"Modo esp-idf-template (std): acceso a Wi-Fi, BLE, HTTP, MQTT y FreeRTOS a través de bindings de ESP-IDF",
"Modo bare-metal esp-hal (no_std): código ultraligero y de arranque instantáneo para microcontroladores RISC-V y Xtensa",
"Compilador Rust con soporte para arquitecturas Xtensa y RISC-V (instalación sencilla mediante espup)",
"Soporte completo para concurrencia asíncrona moderna con async/await y el executor Embassy",
"Ecosistema en rápida expansión mantenido activamente por ingenieros de Espressif"
],
"casos_uso": [
"Dispositivos conectados con requisitos críticos de seguridad de memoria y estabilidad",
"Firmwares que no pueden sufrir fallos de segmentación o desbordamientos en campo",
"Sistemas industriales que aprovechan concurrencia segura con async/await",
"Proyectos de investigación y productos comerciales de vanguardia",
"Desarrolladores con experiencia previa en Rust que ingresan al mundo de los sistemas embebidos"
],
"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": "El core oficial de Arduino para ESP32 (arduino-esp32) mantenido por Espressif. Facilita enormemente el inicio de nuevos proyectos combinando la simplicidad de la API de Arduino con el rendimiento de FreeRTOS.",
"linguagem": "C++",
"tipo": "Framework Alternativo Popular",
"funcao_principal": "Prototipado rápido, proyectos educativos y desarrollo de productos que reutilizan miles de bibliotecas comunitarias de Arduino",
"caracteristicas": [
"Funciones familiares de Arduino (setup, loop, pinMode, digitalWrite, analogRead)",
"Ejecuta internamente sobre ESP-IDF y FreeRTOS (multitarea preventiva disponible bajo cuerda)",
"Ecosistema masivo con decenas de miles de bibliotecas para sensores, pantallas y actuadores",
"Soporte nativo para Wi-Fi, Bluetooth LE, servidores web asíncronos y actualizaciones OTA",
"Compatible con Arduino IDE 2.x, PlatformIO y Visual Studio Code",
"Soporte para casi todas las placas de desarrollo comerciales disponibles en el mercado"
],
"casos_uso": [
"Prototipos de concepto (Proof-of-Concept) y validación rápida de ideas",
"Proyectos Maker, robótica estudiantil y proyectos de fin de carrera",
"Integraciones de hardware comercial con bibliotecas ya existentes para Arduino",
"Dispositivos que no requieren personalización profunda del sistema operativo de bajo nivel",
"Enseñanza de programación de microcontroladores y electrónica digital"
],
"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": "Implementación optimizada y eficiente del lenguaje Python 3 diseñada específicamente para ejecutarse en microcontroladores y sistemas con restricciones de recursos.",
"linguagem": "Python",
"tipo": "Lenguaje e Intérprete Dinámico",
"funcao_principal": "Desarrollo interactivo y prototipado ágil en Python con terminal interactivo REPL y sistema de archivos integrado",
"caracteristicas": [
"Sintaxis completa y moderna de Python 3 con tipos de datos estándar y manejo de excepciones",
"Terminal interactivo (REPL) en puerto serie para probar comandos y periféricos en tiempo real sin recompilar",
"Módulos nativos para control de hardware: machine (Pin, ADC, PWM, I2C, SPI), network (Wi-Fi), bluetooth",
"Sistema de archivos integrado en memoria Flash (LittleFS) accesible como disco virtual",
"Soporte para concurrencia asíncrona mediante el módulo uasyncio",
"Compatibilidad con IDEs como Thonny, Visual Studio Code y herramientas de subida como mpremote"
],
"casos_uso": [
"Educación y enseñanza de programación y conceptos de IoT",
"Pruebas interactivas y diagnóstico de placas directamente en el banco de trabajo",
"Dispositivos de monitoreo y recolección de datos donde la velocidad de iteración supera al rendimiento en microsegundos",
"Proyectos conectados que se benefician de scripts sencillos y legibles",
"Configuración dinámica y ejecución de scripts actualizables sin necesidad de recompilación"
],
"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"
}
}
+774
View File
@@ -0,0 +1,774 @@
{
"ESP32": {
"nome_completo": "ESP32 (Clásico)",
"icone": "🔷",
"descricao": "El modelo original con procesador dual-core y amplia gama de periféricos",
"arquitetura": "Xtensa® LX6 de 32 bits y doble núcleo",
"nucleos": "1 (Single-core) o 2 (Dual-core)",
"frequencia": "Hasta 240 MHz",
"coprocessador_ulp": "Sí",
"seguranca": {
"aes": "AES-128/192/256",
"sha": "SHA-1/256/384/512",
"rsa": "Sí (RSA/MPI hasta 4096 bits)",
"ecc": "No",
"ecdsa": "No",
"hmac": "No",
"assinatura_digital": "No",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (AES-256, esquema heredado)",
"secure_boot": "V1 (AES, heredado); V2 (RSA-3072, RSA-PSS) a partir de la revisión v3.0 (ECO3)",
"protecao_dpa": "No"
},
"wifi": "IEEE 802.11 b/g/n (2.4 GHz, hasta 150 Mbps)",
"bluetooth": "Bluetooth 4.2 BR/EDR (Clásico) y Bluetooth LE (modo dual)",
"ethernet": "Sí (Ethernet MAC integrado)",
"memoria_sram": "520 KB",
"memoria_sram_rtc": "16 KB (dividida en RTC FAST y RTC SLOW)",
"memoria_rom": "448 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 16 MB vía QSPI",
"psram_externa": "Hasta 8 MB vía QSPI (en módulos específicos como WROVER)",
"gpio": "34",
"adc": "2x SAR ADC de 12 bits, hasta 18 canales",
"dac": "2x DAC de 8 bits",
"touch": "10 canales capacitivos",
"uart": "3",
"spi": "4 (SPI, HSPI, VSPI - 2 se pueden usar para Flash/PSRAM)",
"i2c": "2",
"i2s": "2",
"pwm": "LED PWM (hasta 16 canales), Motor PWM",
"ethernet_mac": "1 (requiere PHY externo)",
"can": "1 (CAN 2.0, TWAI®)",
"sdio": "1 (SD/SDIO/MMC Host), 1 (SDIO/SPI Slave)",
"sensor_hall": "1 (interno)",
"sensor_temperatura": "No (retirado de la hoja de datos en 2018; sin controlador en 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 a 125°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "JTAG externo (requiere sonda, ej.: ESP-PROG)",
"esp_idf_minimo": "Desde el inicio (v3.x y anteriores)",
"arduino_core": "Sí (147 definiciones de placa en el core oficial)",
"encapsulamento": "QFN48 (6×6 mm) y QFN48 (5×5 mm)",
"modulos": "ESP32-MINI-1, ESP32-PICO-MINI-02, ESP32-PICO-V3, ESP32-PICO-V3-02 y 11 más",
"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": "Enfoque en seguridad y bajo consumo, con USB nativo y el único ADC con salida de 13 bits",
"arquitetura": "Xtensa® LX7 de 32 bits y núcleo único",
"nucleos": "1 (Single-core)",
"frequencia": "Hasta 240 MHz",
"coprocessador_ulp": "Sí (RISC-V ULP coprocessor)",
"seguranca": {
"aes": "AES-128/192/256 com GCM",
"sha": "SHA-1/224/256/384/512",
"rsa": "Sí (RSA-3072/4096)",
"ecc": "No",
"ecdsa": "No",
"hmac": "Sí (HMAC acelerado por hardware)",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128/256)",
"secure_boot": "V2 (RSA-3072, RSA-PSS)",
"protecao_dpa": "Sí (resistencia DPA de hardware para criptografía)"
},
"wifi": "IEEE 802.11 b/g/n (2.4 GHz, hasta 150 Mbps)",
"bluetooth": "No (sin hardware Bluetooth)",
"memoria_sram": "320 KB",
"memoria_sram_rtc": "16 KB (dividida en RTC FAST y RTC SLOW)",
"memoria_rom": "128 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 1 GB vía SPI/QSPI/OPI",
"psram_externa": "Hasta 1 GB vía SPI/QSPI/OPI",
"gpio": "43",
"adc": "2x SAR ADC de 13 bits, hasta 20 canales",
"dac": "2x DAC de 8 bits",
"touch": "14 canales capacitivos",
"uart": "2",
"spi": "4 (SPI0, SPI1, SPI2, SPI3)",
"i2c": "2",
"i2s": "1",
"pwm": "LED PWM (hasta 8 canales)",
"usb": "1x USB 1.1 OTG (Full-Speed a 12 Mbps con PHY integrado)",
"lcd": "Interfaz LCD de 8/16 bits",
"camera": "Interfaz DVP de 8/16 bits",
"sensor_temperatura": "Sí (1 sensor interno, rango -20°C a 110°C)",
"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 a 105°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "JTAG externo",
"esp_idf_minimo": "ESP-IDF v4.2+",
"arduino_core": "Sí (core oficial)",
"encapsulamento": "QFN56 (7×7 mm)",
"modulos": "ESP32-S2-WROOM, ESP32-S2-WROOM-I, ESP32-S2-WROVER, ESP32-S2-MINI-1 y 5 más",
"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",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No"
},
"ESP32-S3": {
"nome_completo": "ESP32-S3",
"icone": "🤖",
"descricao": "Procesador dual-core con aceleradores para IA y procesamiento de señales",
"arquitetura": "Xtensa® LX7 dual-core de 32 bits con instrucciones vectoriales",
"nucleos": "2 (Dual-core)",
"frequencia": "Hasta 240 MHz",
"coprocessador_ulp": "Sí (RISC-V ULP y FSM coprocessor)",
"aceleradores_ia": "Sí (instrucciones vectoriales para acelerar redes neuronales y DSP)",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256/384/512",
"rsa": "Sí (RSA-3072/4096)",
"ecc": "No",
"ecdsa": "No",
"hmac": "Sí (HMAC acelerado por hardware)",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128/256)",
"secure_boot": "V2 (RSA-3072, RSA-PSS)",
"protecao_dpa": "Sí (resistencia DPA de hardware)"
},
"wifi": "IEEE 802.11 b/g/n (2.4 GHz, hasta 150 Mbps)",
"bluetooth": "Bluetooth 5.0 LE y Bluetooth Mesh (soporte de 2 Mbps y largo alcance)",
"memoria_sram": "512 KB",
"memoria_sram_rtc": "16 KB (dividida en RTC FAST y RTC SLOW)",
"memoria_rom": "384 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 1 GB vía QSPI u Octal SPI",
"psram_externa": "Hasta 1 GB vía QSPI u Octal SPI (hasta 2 MB/8 MB/16 MB en módulos comunes)",
"gpio": "45",
"adc": "2x SAR ADC de 12 bits, hasta 20 canales",
"dac": "No",
"touch": "14 canales capacitivos",
"uart": "3",
"spi": "4 (SPI0, SPI1, SPI2, SPI3)",
"i2c": "2",
"i2s": "2",
"pwm": "LED PWM (hasta 8 canales), MCPWM (para control de motores)",
"usb": "1x USB 1.1 OTG (Full-Speed a 12 Mbps) y 1x USB Serial/JTAG integrado",
"lcd": "1x interfaz de display LCD de 8 a 16 bits (RGB paralelo/8080)",
"camera": "1x interfaz de cámara DVP (8 a 16 bits)",
"sdio": "1 (SD/SDIO/MMC Host)",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active": "78 mW (~24 mA @3.3V)",
"modem_sleep": "13-42 mA (40-80 MHz, conforme a carga)",
"light_sleep": "240 µA (+40 a 200 µA de la PSRAM)",
"deep_sleep": "7 µA"
},
"temperatura_operacao": "-40°C a 65/85/105°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado o JTAG externo",
"esp_idf_minimo": "ESP-IDF v4.4+",
"arduino_core": "Sí (core oficial)",
"encapsulamento": "QFN56 (7×7 mm)",
"modulos": "ESP32-S3-WROOM-1, ESP32-S3-WROOM-2, ESP32-S3-MINI-1 y 12 más",
"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",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No"
},
"ESP32-S31": {
"nome_completo": "ESP32-S31",
"icone": "🌀",
"descricao": "Procesador dual-core RISC-V de alto rendimiento a 320MHz con Wi-Fi 6, Bluetooth 5.4 y Classic, Zigbee/Thread, Matter y aceleración de IA",
"arquitetura": "RISC-V dual-core de 32 bits con extensiones vectoriales",
"nucleos": "2 (Dual-core)",
"frequencia": "Hasta 320 MHz",
"coprocessador_ulp": "Sí (RISC-V ULP de ultra bajo consumo)",
"aceleradores_ia": "Sí (extensiones vectoriales avanzadas para TinyML, reconocimiento de voz y visión)",
"seguranca": {
"aes": "AES-128/256 com GCM",
"sha": "SHA-1/224/256/384/512",
"rsa": "Sí (RSA-3072/4096)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "Sí (Key Manager integrado con eFuse)",
"rng": "Sí (TRNG)",
"criptografia_flash": "Sí (XTS-AES-128/256)",
"secure_boot": "V2 (RSA-3072, ECDSA P-256/384)",
"protecao_dpa": "Sí (resistencia DPA de hardware)"
},
"wifi": "Wi-Fi 6 (802.11ax) 2.4 GHz (retrocompatible con 802.11b/g/n, soporte a OFDMA y TWT)",
"bluetooth": "Bluetooth 5.4 LE y Bluetooth Classic (BR/EDR)",
"zigbee_thread": "IEEE 802.15.4 (Zigbee 3.0 y Thread 1.3)",
"matter": "Sí (soporte completo como terminal o Matter Bridge)",
"memoria_sram": "512 KB (HP SRAM)",
"memoria_sram_rtc": "32 KB LP SRAM",
"memoria_rom": "512 KB",
"flash_externa": "Hasta 1 GB vía Octal SPI (soporte para Flash OPI de alta velocidad)",
"psram_externa": "Hasta 1 GB vía Octal SPI (PSRAM OPI de alto ancho de banda)",
"gpio": "60",
"adc": "2x SAR ADC de 12 bits, hasta 20 canales",
"dac": "No",
"touch": "14 canales capacitivos táctiles",
"uart": "5 (4 UART + 1 LP UART)",
"spi": "SPI, QSPI, OPI (múltiples controladores)",
"i2c": "3 (2 I2C + 1 LP I2C)",
"i2s": "2",
"pwm": "LED PWM y MCPWM para control avanzado de motores",
"usb": "USB OTG 1.1 Full-Speed y USB Serial/JTAG integrado",
"can": "Sim (CAN FD Controller)",
"sensor_temperatura": "Sí (sensor de temperatura integrado)",
"consumo_energia": {
"active": "Consumo optimizado de alto rendimiento configurable",
"light_sleep": "0.1-0.8 mA",
"deep_sleep": "Baixo consumo com LP CPU ativa"
},
"temperatura_operacao": "-40°C a 85°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado y JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.4+",
"arduino_core": "En desarrollo (previsto tras la maduración en ESP-IDF)",
"encapsulamento": "QFN y BGA",
"modulos": "ESP32-S31-WROOM, módulos integrados previstos para 2026",
"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 Host 3.0)",
"ethernet": "No",
"ethernet_mac": "No",
"camera": "Interfaz de cámara paralela DVP / MIPI CSI",
"lcd": "Interfaz de display RGB paralelo y MIPI DSI",
"sensor_hall": "No",
"status_documentacao": "Anunciado por Espressif; especificaciones sujetas a revisión final en la hoja de datos comercial"
},
"ESP32-C2": {
"nome_completo": "ESP32-C2 (ESP8684)",
"icone": "🌱",
"descricao": "Microcontrolador RISC-V ultra económico y de bajo consumo con Wi-Fi 4 y Bluetooth 5.3 LE",
"arquitetura": "RISC-V single-core de 32 bits (RV32IMC)",
"nucleos": "1 (Single-core)",
"frequencia": "Hasta 120 MHz",
"seguranca": {
"aes": "No",
"sha": "SHA-1/224/256",
"rsa": "Sí (RSA-3072)",
"ecc": "Sí (ECC HW acelerado)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "No",
"assinatura_digital": "No",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (AES-128-XTS)",
"secure_boot": "V2 (RSA-3072 o ECDSA-P256)",
"protecao_dpa": "No"
},
"wifi": "IEEE 802.11 b/g/n (2.4 GHz, hasta 72.2 Mbps)",
"bluetooth": "Bluetooth 5.3 LE (soporte a 2 Mbps y 1 Mbps, modo publicitario extendido)",
"memoria_sram": "272 KB (16 KB para cache)",
"memoria_sram_rtc": "No (sin SRAM RTC dedicada; usa SRAM principal)",
"memoria_rom": "576 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 4 MB en encapsulamiento SiP o externa vía QSPI",
"psram_externa": "No",
"gpio": "14",
"adc": "1x SAR ADC de 12 bits, hasta 5 canales",
"dac": "No",
"touch": "No",
"uart": "2",
"spi": "2 (SPI0/1 para Flash interna/externa, SPI2 para propósito general)",
"i2c": "1 (Master-only)",
"i2s": "No",
"pwm": "LED PWM (hasta 6 canales)",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active_cpu_120mhz": "10,7-15,6 mA (modem-sleep)",
"light_sleep": "140 µA",
"deep_sleep": "5 µA"
},
"temperatura_operacao": "-40°C a 105°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.0+",
"arduino_core": "Sí (core oficial)",
"encapsulamento": "QFN24 (4×4 mm) y QFN32 (4×4 mm)",
"modulos": "ESP8684-WROOM-02C, ESP8684-WROOM-06C, ESP8684-MINI-1 y 3 más",
"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",
"coprocessador_ulp": "No",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No",
"usb": "No"
},
"ESP32-C3": {
"nome_completo": "ESP32-C3",
"icone": "💎",
"descricao": "Procesador RISC-V de ultra bajo consumo",
"arquitetura": "RISC-V single-core de 32 bits (RV32IMC)",
"nucleos": "1 (Single-core)",
"frequencia": "Hasta 160 MHz",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256",
"rsa": "Sí (RSA-3072)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí (HMAC acelerado por hardware)",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128)",
"secure_boot": "V2 (RSA-3072)",
"protecao_dpa": "No"
},
"wifi": "IEEE 802.11 b/g/n (2.4 GHz, hasta 150 Mbps)",
"bluetooth": "Bluetooth 5.0 LE y Bluetooth Mesh (soporte a 2 Mbps y largo alcance)",
"memoria_sram": "400 KB",
"memoria_sram_rtc": "8 KB (RTC FAST SRAM)",
"memoria_rom": "384 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 16 MB vía QSPI",
"psram_externa": "No",
"gpio": "22",
"adc": "2x SAR ADC de 12 bits, hasta 6 canales",
"dac": "No",
"touch": "No",
"uart": "2",
"spi": "3 (SPI0, SPI1, SPI2)",
"i2c": "1",
"i2s": "1",
"pwm": "LED PWM (hasta 6 canales)",
"usb": "1x USB Serial/JTAG integrado",
"sensor_temperatura": "Sí (1 sensor interno)",
"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 a 105°C (85°C en el ESP32-C3FN4)",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado o JTAG externo",
"esp_idf_minimo": "ESP-IDF v4.3+",
"arduino_core": "Sí (core oficial)",
"encapsulamento": "QFN32 (5×5 mm)",
"modulos": "ESP32-C3-WROOM-02, ESP32-C3-MINI-1 y 6 más",
"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",
"coprocessador_ulp": "No",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No"
},
"ESP32-C5": {
"nome_completo": "ESP32-C5",
"icone": "📶",
"descricao": "El primero con soporte para Wi-Fi 6 dual-band y Bluetooth 6.0, equipado con CPU RISC-V y coprocesador ULP",
"arquitetura": "RISC-V single-core de 32 bits (RV32IMC) a 240 MHz",
"nucleos": "1 (Single-core)",
"frequencia": "Hasta 240 MHz",
"coprocessador_ulp": "Sí (coprocesador RISC-V ULP de ultra bajo consumo)",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256/384/512",
"rsa": "Sí (RSA-3072)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "Sí (Key Manager integrado)",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128/256)",
"secure_boot": "V2 (RSA-3072 / ECDSA)",
"protecao_dpa": "Sí (resistencia DPA de hardware)"
},
"wifi": "Wi-Fi 6 (802.11ax) dual-band (2.4 GHz y 5 GHz), retrocompatible con 802.11a/b/g/n, ancho de banda de 20/40 MHz, OFDMA y TWT",
"bluetooth": "Bluetooth 6.0 LE (modo de alta velocidad de 2 Mbps, largo alcance de 125/500 kbps, extensiones publicitarias y BLE Mesh)",
"zigbee_thread": "IEEE 802.15.4 (Zigbee 3.0 y Thread 1.3)",
"matter": "Sí (soporte completo para dispositivos Matter sobre Wi-Fi o Thread)",
"memoria_sram": "384 KB",
"memoria_sram_rtc": "16 KB LP SRAM (en dominio de energía de bajo consumo)",
"memoria_rom": "384 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 1 GB vía SPI/QSPI/OPI",
"psram_externa": "Hasta 1 GB vía SPI/QSPI/OPI",
"gpio": "29",
"adc": "2x SAR ADC de 12 bits, hasta 8 canales",
"dac": "No",
"touch": "No",
"uart": "3 (2 UART + 1 LP UART)",
"spi": "SPI, QSPI, OPI",
"i2c": "2 (1 I2C + 1 LP I2C)",
"i2s": "1",
"pwm": "LED PWM (hasta 6 canales)",
"usb": "1x USB Serial/JTAG integrado",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active_wifi": "hasta 377 mA (TX en 5 GHz)",
"light_sleep": "60-250 µA",
"deep_sleep": "12 µA"
},
"temperatura_operacao": "-40°C a 105°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado y JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.3+",
"arduino_core": "En desarrollo (core oficial)",
"encapsulamento": "QFN32 (5×5 mm) y QFN48 (6×6 mm)",
"modulos": "ESP32-C5-WROOM-1, ESP32-C5-WROOM-1U",
"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 Slave, a partir da revisão v1.0)",
"can": "2 (CAN FD)",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No"
},
"ESP32-C6": {
"nome_completo": "ESP32-C6",
"icone": "🌐",
"descricao": "Funciones de seguridad avanzada, Wi-Fi 6, Bluetooth 6.0, Zigbee y Thread con soporte para Matter",
"arquitetura": "RISC-V single-core de 32 bits (RV32IMAC)",
"nucleos": "1 (Single-core) + 1 coprocesador LP RISC-V",
"frequencia": "Hasta 160 MHz (CPU principal) + 20 MHz (CPU LP)",
"coprocessador_ulp": "Sí (coprocesador RISC-V LP de bajo consumo)",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256",
"rsa": "Sí (RSA-3072)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128)",
"secure_boot": "V2 (RSA-3072 / ECDSA)",
"protecao_dpa": "No"
},
"wifi": "Wi-Fi 6 (802.11ax) en 2.4 GHz (retrocompatible con 802.11b/g/n, OFDMA y TWT)",
"bluetooth": "Bluetooth 6.0 LE (modo de 2 Mbps, largo alcance y extensiones publicitarias)",
"zigbee_thread": "IEEE 802.15.4 (Zigbee 3.0 y Thread 1.3)",
"matter": "Sí (soporte completo)",
"memoria_sram": "512 KB",
"memoria_sram_rtc": "16 KB LP SRAM",
"memoria_rom": "320 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 16 MB vía QSPI",
"psram_externa": "No",
"gpio": "30",
"adc": "1x SAR ADC de 12 bits, hasta 7 canales",
"dac": "No",
"touch": "No",
"uart": "3 (2 UART + 1 LP UART)",
"spi": "SPI0/1 (memoria), SPI2 (propósito general)",
"i2c": "2 (1 I2C + 1 LP I2C)",
"i2s": "1",
"pwm": "LED PWM (hasta 6 canales), MCPWM",
"usb": "1x USB Serial/JTAG integrado",
"sdio": "1 (SDIO 2.0 Slave)",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active_wifi6": "252-354 mA (TX)",
"light_sleep": "35-180 µA",
"deep_sleep": "7 µA"
},
"temperatura_operacao": "-40°C a 105°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado o JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.1+",
"arduino_core": "Sí (core oficial)",
"encapsulamento": "QFN40 (5×5 mm) y QFN32 (5×5 mm)",
"modulos": "ESP32-C6-WROOM-1, ESP32-C6-MINI-1 y 4 más",
"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",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No"
},
"ESP32-C61": {
"nome_completo": "ESP32-C61",
"icone": "🛰️",
"descricao": "Microcontrolador RISC-V económico de 160MHz con Wi-Fi 6, Bluetooth 6.0 LE y soporte para Flash/PSRAM en el encapsulado",
"arquitetura": "RISC-V single-core de 32 bits (RV32IMAC)",
"nucleos": "1 (Single-core)",
"frequencia": "Hasta 160 MHz",
"seguranca": {
"aes": "No",
"sha": "SHA-1/224/256",
"rsa": "Sí (RSA-3072)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128)",
"secure_boot": "V2 (RSA-3072 / ECDSA)",
"protecao_dpa": "No"
},
"wifi": "Wi-Fi 6 (802.11ax) en 2.4 GHz (ancho de banda de 20 MHz, OFDMA, TWT y retrocompatible con 802.11b/g/n)",
"bluetooth": "Bluetooth 6.0 LE (modo de 2 Mbps, largo alcance y BLE Mesh)",
"zigbee_thread": "No (enfocado en optimización de costes; sin IEEE 802.15.4)",
"matter": "Sí (soporte para Matter sobre Wi-Fi)",
"memoria_sram": "320 KB",
"memoria_sram_rtc": "No (sin SRAM RTC dedicada; usa SRAM principal)",
"memoria_rom": "256 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 16 MB vía QSPI / Quad SPI Flash integrada en SiP",
"psram_externa": "Soporte para Quad SPI PSRAM en SiP (hasta 2 MB/4 MB)",
"gpio": "30",
"adc": "1x SAR ADC de 12 bits, hasta 6 canales",
"dac": "No",
"touch": "No",
"uart": "3",
"spi": "SPI0/1 para memoria, SPI2 para propósito general",
"i2c": "1",
"i2s": "1",
"pwm": "LED PWM (hasta 6 canales)",
"usb": "1x USB Serial/JTAG integrado",
"sdio": "1 (SDIO 2.0 Slave)",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active": "240-360 mA (TX)",
"light_sleep": "50-200 µA",
"deep_sleep": "10 µA"
},
"temperatura_operacao": "-40°C a 105°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado o JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.4+",
"arduino_core": "En desarrollo (core oficial)",
"encapsulamento": "QFN32 (4×4 mm)",
"modulos": "ESP32-C61-WROOM, módulos SiP integrados previstos para 2026",
"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",
"coprocessador_ulp": "No",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No",
"status_documentacao": "Anunciado por Espressif como optimización de costes sobre el C6"
},
"ESP32-P4": {
"nome_completo": "ESP32-P4",
"icone": "⚡",
"descricao": "Alto rendimiento con procesador RISC-V dual-core a 400MHz, aceleradores de IA y ricas interfaces multimedia",
"arquitetura": "RISC-V dual-core de 32 bits (HP) + RISC-V single-core de 32 bits (LP)",
"nucleos": "2 (Dual-core HP) + 1 (Single-core LP)",
"frequencia": "Hasta 400 MHz (núcleos HP) + 40 MHz (núcleo LP)",
"coprocessador_ulp": "Sí (RISC-V LP core de bajo consumo)",
"aceleradores_ia": "Sí (extensiones vectoriales completas para IA, DSP y códecs de video)",
"seguranca": {
"aes": "AES-128/256 com GCM",
"sha": "SHA-1/224/256/384/512",
"rsa": "Sí (RSA-3072/4096)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "Sí (Key Manager integrado con almacenamiento seguro de claves)",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128/256)",
"secure_boot": "V2 (RSA-3072 / ECDSA)",
"protecao_dpa": "Sí (resistencia DPA de hardware)"
},
"wifi": "No (requiere chip complementario como ESP32-C6 para Wi-Fi)",
"bluetooth": "No (requiere chip complementario para Bluetooth)",
"ethernet": "Sí (Ethernet MAC integrado a 100 Mbps con soporte para RMII)",
"memoria_sram": "768 KB",
"memoria_sram_rtc": "32 KB LP SRAM (en dominio de bajo consumo)",
"memoria_rom": "128 KB (para arranque del sistema)",
"flash_externa": "Hasta 1 GB vía Octal SPI",
"psram_externa": "Hasta 32 MB PSRAM en encapsulado (hasta 16/32 MB a alta velocidad)",
"gpio": "55",
"adc": "2x SAR ADC de 12 bits, hasta 16 canales",
"dac": "No",
"touch": "14 canales capacitivos",
"uart": "6 (5 UART + 1 LP UART)",
"spi": "Múltiples controladores SPI, QSPI y Octal SPI",
"i2c": "3 (2 I2C + 1 LP I2C)",
"i2s": "4 (3 I2S + 1 LP I2S)",
"pwm": "LED PWM y MCPWM para control de precisión de motores",
"usb": "1x USB 2.0 High-Speed OTG (480 Mbps con PHY integrado) y 1x USB 1.1 Full-Speed",
"mipi_csi": "2 carriles (1.5 Gbps/carril), compatible con cámaras HD/FHD",
"mipi_dsi": "2 carriles (1.5 Gbps/carril), resolución hasta 1080p",
"lcd": "1x MIPI DSI (2 carriles, hasta 1.5 Gbps por carril) y 1x interfaz RGB paralela",
"camera": "1x MIPI CSI (2 carriles, hasta 1.5 Gbps por carril) y 1x interfaz DVP paralela (16 bits)",
"sdio": "1 controlador host SD/MMC (SDHOST)",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active": "15-150 mA (40 a 400 MHz, conforme a carga)",
"light_sleep": "75-800 µA",
"deep_sleep": "12 µA"
},
"temperatura_operacao": "-40°C a 85°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado y JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.3+",
"arduino_core": "En desarrollo (core oficial)",
"encapsulamento": "BGA y QFN",
"modulos": "ESP32-P4-Function-EV-Board, placas DevKit",
"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",
"ethernet_mac": "1 (100 Mbps RMII)",
"sensor_hall": "No"
},
"ESP32-H2": {
"nome_completo": "ESP32-H2",
"icone": "🔋",
"descricao": "Enfocado en ultra bajo consumo con Bluetooth 6.0, Zigbee y Thread. Sin soporte para Wi-Fi",
"arquitetura": "RISC-V single-core de 32 bits (RV32IMAC)",
"nucleos": "1 (Single-core)",
"frequencia": "Hasta 96 MHz",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256",
"rsa": "Sí (RSA-3072)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "No",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128)",
"secure_boot": "V2 (RSA-3072 / ECDSA)",
"protecao_dpa": "No"
},
"wifi": "No (sin radio Wi-Fi)",
"bluetooth": "Bluetooth 6.0 LE (modo de 2 Mbps, largo alcance y BLE Mesh)",
"zigbee_thread": "IEEE 802.15.4 (Zigbee 3.0 y Thread 1.3)",
"matter": "Sí (soporte nativo para Matter sobre Thread)",
"memoria_sram": "320 KB",
"memoria_sram_rtc": "4 KB LP SRAM",
"memoria_rom": "128 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 16 MB vía QSPI / 2 MB o 4 MB integrada en SiP",
"psram_externa": "No",
"gpio": "19",
"adc": "1x SAR ADC de 12 bits, hasta 5 canales",
"dac": "No",
"touch": "No",
"uart": "2",
"spi": "SPI0/1 para Flash, SPI2 para propósito general",
"i2c": "2",
"i2s": "1",
"pwm": "LED PWM (hasta 6 canales), MCPWM",
"usb": "1x USB Serial/JTAG integrado",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active": "24-140 mA (radio, de -24 a 20 dBm)",
"light_sleep": "25-85 µA",
"deep_sleep": "7 µA"
},
"temperatura_operacao": "-40°C a 105°C",
"temperatura_armazenamento": "-40°C a 150°C",
"depuracao": "USB Serial/JTAG integrado o JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.1+",
"arduino_core": "Sí (core oficial)",
"encapsulamento": "QFN32 (5×5 mm)",
"modulos": "ESP32-H2-WROOM-07, ESP32-H2-MINI-1 y 3 más",
"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",
"coprocessador_ulp": "No",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No"
},
"ESP32-H4": {
"nome_completo": "ESP32-H4",
"icone": "🛡️",
"descricao": "SoC dual-core RISC-V de altísima eficiencia energética con Bluetooth 5.4 LE (LE Audio) e IEEE 802.15.4 para Thread, Zigbee y Matter. Sin Wi-Fi",
"status_documentacao": "Anunciado por Espressif; soporte para LE Audio y optimización de baja latencia",
"arquitetura": "RISC-V dual-core de 32 bits (núcleo de aplicación y núcleo de conectividad/LP)",
"nucleos": "2 (Dual-core)",
"frequencia": "Hasta 96 MHz",
"seguranca": {
"aes": "AES-128/256",
"sha": "SHA-1/224/256/384/512",
"rsa": "Sí (RSA-3072)",
"ecc": "Sí (ECC HW)",
"ecdsa": "Sí (ECDSA HW)",
"hmac": "Sí",
"assinatura_digital": "Sí (Digital Signature peripheral)",
"key_manager": "Sí (Key Manager integrado)",
"rng": "Sí (TRNG por hardware)",
"criptografia_flash": "Sí (XTS-AES-128/256)",
"secure_boot": "V2 (RSA-3072 / ECDSA)",
"protecao_dpa": "Sí (resistencia DPA de hardware)"
},
"wifi": "No (sin radio Wi-Fi)",
"bluetooth": "Bluetooth 5.4 LE (soporte para Bluetooth LE Audio, Auracast, modo de 2 Mbps y largo alcance)",
"zigbee_thread": "IEEE 802.15.4 (Zigbee 3.0 y Thread 1.3/1.4)",
"matter": "Sí (soporte nativo para Matter sobre Thread con alta eficiencia)",
"memoria_sram": "384 KB",
"memoria_sram_rtc": "16 KB LP SRAM",
"memoria_rom": "256 KB (para arranque y funciones del núcleo)",
"flash_externa": "Hasta 16 MB vía QSPI / SiP integrado",
"psram_externa": "Soporte para PSRAM en SiP (hasta 2 MB/4 MB)",
"gpio": "40",
"adc": "1x SAR ADC de 12 bits, hasta 8 canales",
"dac": "No",
"touch": "No",
"uart": "2",
"spi": "SPI, QSPI",
"i2c": "2",
"i2s": "1",
"pwm": "LED PWM (hasta 6 canales), MCPWM",
"can": "1 (CAN 2.0, TWAI®)",
"usb": "1x USB Serial/JTAG integrado",
"sensor_temperatura": "Sí (1 sensor interno)",
"consumo_energia": {
"active": "No divulgado (documentación preliminar)"
},
"temperatura_operacao": "-40°C a 105°C",
"temperatura_armazenamento": "No divulgado (documentación preliminar)",
"depuracao": "USB Serial/JTAG integrado o JTAG externo",
"esp_idf_minimo": "ESP-IDF v5.4+",
"arduino_core": "En desarrollo (core oficial)",
"encapsulamento": "QFN32 (4×4 mm) y QFN40 (5×5 mm)",
"modulos": "ESP32-H4-WROOM, módulos integrados previstos para 2026",
"guia_de_programacao": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32h4/get-started/index.html",
"cor": "#e83e8c",
"coprocessador_ulp": "Sí (LP core de ultra bajo consumo)",
"ethernet": "No",
"ethernet_mac": "No",
"sensor_hall": "No"
}
}
+2 -2
View File
@@ -4,8 +4,8 @@
*/
// Ponto único de configuração de idiomas ATIVOS.
// Para ativar um novo idioma no site, basta adicionar seu código aqui (ex.: ["pt", "en"]).
export const ENABLED_LOCALES = ["pt", "en"];
// Para ativar um novo idioma no site, basta adicionar seu código aqui (ex.: ["pt", "en", "es"]).
export const ENABLED_LOCALES = ["pt", "en", "es"];
export const ALL_LOCALES = [
{ code: "pt", label: "Português", short: "PT", lang: "pt-BR", og: "pt_BR" },
File diff suppressed because it is too large. Load diff
+700
View File
@@ -0,0 +1,700 @@
/**
* Base de datos estructurada para la guía de diagnóstico, errores comunes y solución de problemas en ESP32.
* Cubre 6 categorías técnicas con causas raíz, comparación de buenas prácticas vs soluciones temporales y ejemplos de código
* en Arduino C++, ESP-IDF (C) y MicroPython.
*/
export const categoriasDiagnostico = [
{
id: "alimentacao",
nome: "Alimentación y Hardware",
icone: "Zap",
cor: "amber",
descricao: "Caídas de tensión por picos de RF Wi-Fi/BLE, pines de strapping en conflicto, ruido electromagnético y problemas de LDO.",
},
{
id: "cpu-panics",
nome: "Pánicos de CPU y Guru Meditation",
icone: "Cpu",
cor: "red",
descricao: "Punteros nulos, violaciones de acceso a memoria (Load/StoreProhibited), instrucciones ilegales y pánicos de caché en ISRs.",
},
{
id: "freertos",
nome: "FreeRTOS y Multitarea",
icone: "Layers",
cor: "purple",
descricao: "Task Watchdog (TWDT), Interrupt Watchdog (IWDT), desbordamiento de pila (Stack Overflow) y bloqueos del planificador.",
},
{
id: "memoria",
nome: "Memoria, Heap y PSRAM",
icone: "Activity",
cor: "blue",
descricao: "Fragmentación del heap, fugas de memoria (Memory Leaks), asignaciones DMA y restricciones de velocidad en PSRAM.",
},
{
id: "boot-flash",
nome: "Bootloader y Grabación",
icone: "Terminal",
cor: "emerald",
descricao: "Fallas de comunicación serie (DTR/RTS), errores de lectura en Flash SPI, discrepancia de reloj y particiones corruptas.",
},
{
id: "conectividade",
nome: "Conectividad y Protocolos",
icone: "Wifi",
cor: "cyan",
descricao: "Timeouts de baliza Wi-Fi, fallos de handshake TLS/HTTPS por ausencia de reloj SNTP e inestabilidad de señal.",
},
];
export const sintomasRapidos = [
{ id: "bootloop", rotulo: "🔄 Bucle de arranque (Crash loop)", categoria: "todos" },
{ id: "wifi-crash", rotulo: "📶 Se reinicia al activar Wi-Fi/BLE", categoria: "alimentacao" },
{ id: "upload-fail", rotulo: "🔌 Fallo al subir firmware (Error de grabación)", categoria: "boot-flash" },
{ id: "random-freeze", rotulo: "⏱️ Se congela tras minutos u horas", categoria: "memoria" },
{ id: "null-pointer", rotulo: "💥 Guru Meditation (Crash de CPU)", categoria: "cpu-panics" },
{ id: "wdt-reset", rotulo: "🐕 Watchdog activado (Reset por TWDT)", categoria: "freertos" },
{ id: "tls-fail", rotulo: "🔒 Fallo en conexión HTTPS / SSL", categoria: "conectividade" },
];
export const errosCatalogo = [
{
id: "brownout-reset",
titulo: "Reinicio por detector de Brownout (Caída de tensión)",
categoria: "alimentacao",
sintomas: ["bootloop", "wifi-crash"],
gravidade: "Alta",
logSerial: "Brownout detector was triggered\n\nrst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)",
resumo: "La tensión de alimentación del ESP32 cayó por debajo del umbral de seguridad (aproximadamente 2.8V ~ 2.43V).",
causaRaiz:
"Al inicializar las radios Wi-Fi o BLE, el amplificador de potencia (PA) demanda picos de corriente instantáneos superiores a 500 mA en menos de 1 ms. Si la fuente de alimentación, cables USB largos/delgados, pistas de protoboard o el regulador LDO no pueden suministrar esa corriente transitoria con baja impedancia, el voltaje en el riel de 3.3V colapsa momentáneamente, activando el circuito comparador interno de Brownout para evitar la corrupción de la memoria Flash y estados lógicos indefinidos.",
gambiarra: {
titulo: "Desactivar el detector de Brownout por software",
descricao: "Llamar a WRITE_PERI_REG(RTC_CNTL_BROWN_OUT_REG, 0) para suprimir el error en el código.",
consequencia: "Extremadamente peligroso: el ESP32 continúa ejecutando instrucciones bajo subtensión, corrompiendo la memoria Flash SPI, bloqueando registros periféricos y causando fallos erráticos en campo sin previo aviso.",
},
solucaoEngenharia: {
titulo: "Dimensionamiento adecuado de hardware y capacitores de desacoplo",
passos: [
"Añadir un capacitor de tantalio o cerámico de baja ESR de 10 µF a 100 µF en paralelo con un capacitor cerámico de 100 nF lo más cerca posible de los pines 3V3 y GND del ESP32.",
"Utilizar reguladores LDO diseñados para picos de al menos 600 mA a 1 A con excelente respuesta transitoria (ej.: AP2112K, ME6211, TPS73733 o XC6206 robusto). Evitar clones deficientes del AMS1117.",
"Evitar alimentar el ESP32 a través de pistas largas de protoboard con cables jumper delgados cuando el Wi-Fi transmite a máxima potencia.",
],
},
codigoArduino: `// ¡NO desactive el detector de Brownout! Si necesita reducir picos de corriente en pruebas de banco:
#include <WiFi.h>
void setup() {
Serial.begin(115200);
// Opcional: Reducir ligeramente la potencia máxima de transmisión Wi-Fi de 20dBm a 17dBm recorta los picos de corriente un ~20%
WiFi.setTxPower(WIFI_POWER_17dBm);
WiFi.begin("SSID", "PASSWORD");
}`,
codigoEspIdf: `// Configuración en ESP-IDF:
#include "esp_wifi.h"
#include "esp_log.h"
void app_main(void) {
// En menuconfig: Component config -> ESP32-specific -> Hardware Brownout Reset (Mantener ACTIVADO)
// Para mitigar picos transitorios en diseños con restricciones de energía:
esp_wifi_set_max_tx_power(68); // 68 = 17dBm (unidades de 0.25dBm)
}`,
codigoMicroPython: `# Conexión Wi-Fi segura en MicroPython con estabilización de rieles:
import network
import time
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
# Esperar a que se estabilicen los rieles antes de activar el transmisor
time.sleep_ms(200)
wlan.connect("SSID", "PASSWORD")
attempts = 0
while not wlan.isconnected() and attempts < 30:
time.sleep_ms(200)
attempts += 1`,
},
{
id: "strapping-pins",
titulo: "Conflicto en pines de arranque (Strapping Pins) durante el encendido",
categoria: "alimentacao",
sintomas: ["bootloop", "upload-fail"],
gravidade: "Alta",
logSerial: "rst:0x10 (RTCWDT_RTC_RESET),boot:0x3 (DOWNLOAD_BOOT(UART/SPI))\nwaiting for download",
resumo: "El ESP32 entra inesperadamente en modo de descarga de firmware o falla al arrancar debido a niveles lógicos forzados en los pines de arranque.",
causaRaiz:
"Durante el reinicio por hardware, el circuito interno muestrea los niveles lógicos presentes en pines específicos (ej.: GPIO0, GPIO2, GPIO12, GPIO15 en ESP32 clásico; GPIO8, GPIO9 en ESP32-C3/C6). Si hay periféricos externos conectados (sensores I2C, tiras LED, relés) que fuerzan estos pines a niveles altos o bajos en el instante del arranque, el chip interpreta que debe entrar en modo de descarga UART o altera el voltaje interno del LDO de la memoria Flash (GPIO12 en 3.3V vs 1.8V), impidiendo la ejecución del código.",
gambiarra: {
titulo: "Desconectar los cables manualmente antes de cada encendido",
descricao: "Retirar los módulos externos cada vez que se reinicia o programa la placa.",
consequencia: "Inviable para cualquier producto en producción o gabinete cerrado, propenso a errores humanos y desgaste de conectores.",
},
solucaoEngenharia: {
titulo: "Aislamiento de pines de arranque o reasignación a GPIOs seguros",
passos: [
"Reservar los pines de arranque exclusivamente para funciones internas o dejarlos sin conexiones externas permanentes.",
"En ESP32 clásico, evitar usar GPIO0, GPIO2, GPIO12 y GPIO15 para cargas externas que contengan resistencias pull-up o pull-down incorporadas.",
"Utilizar transistores de aislamiento (búferes tri-state o conmutadores analógicos controlados por un GPIO libre tras el arranque) si es estrictamente necesario compartir esos pines.",
],
},
codigoArduino: `// Mapeo seguro de pines en Arduino para evitar interferir con strapping:
// En ESP32 clásico: usar GPIO16, 17, 18, 19, 21, 22, 23 (libres de strapping)
const int PIN_RELE = 22; // SEGURO: GPIO22 no es pin de arranque ni tiene restricciones de boot
void setup() {
pinMode(PIN_RELE, OUTPUT);
digitalWrite(PIN_RELE, LOW);
}`,
codigoEspIdf: `// ESP-IDF: Configuración de GPIOs fuera de strapping
#include "driver/gpio.h"
#define SAFE_GPIO_OUTPUT GPIO_NUM_22
void app_main(void) {
gpio_config_t io_conf = {
.pin_bit_mask = (1ULL << SAFE_GPIO_OUTPUT),
.mode = GPIO_MODE_OUTPUT,
.pull_up_en = GPIO_PULLUP_DISABLE,
.pull_down_en = GPIO_PULLDOWN_ENABLE,
.intr_type = GPIO_INTR_DISABLE
};
gpio_config(&io_conf);
}`,
codigoMicroPython: `# MicroPython: Asignación limpia a GPIO seguro
from machine import Pin
# Usar GPIO seguro que no interfiera con el ciclo de arranque
pin_rele = Pin(22, Pin.OUT, value=0)`,
},
{
id: "guru-load-prohibited",
titulo: "Guru Meditation: LoadProhibited / StoreProhibited (Acceso a puntero nulo)",
categoria: "cpu-panics",
sintomas: ["null-pointer", "bootloop"],
gravidade: "Crítica",
logSerial: "Guru Meditation Error: Core 1 panic'ed (LoadProhibited). Exception was unhandled.\nCore 1 register dump:\nPC : 0x400d1234 PS : 0x00060030 A0 : 0x800d1567 A1 : 0x3ffb1230\nA2 : 0x00000000 A3 : 0x3ffb5000",
resumo: "La aplicación intentó leer (LoadProhibited) o escribir (StoreProhibited) en una dirección de memoria protegida o puntero nulo (0x00000000).",
causaRaiz:
"Ocurre cuando el software desreferencia un puntero no inicializado, un puntero nulo devuelto por una función que falló (como malloc sin memoria suficiente o WiFiClient no conectado), o intenta acceder a una estructura de datos ya liberada (use-after-free). Al observar el volcado de registros, si A2 o A3 contienen 0x00000000 o valores cercanos a cero, se confirma la desreferencia nula.",
gambiarra: {
titulo: "Reinicio automático sin depuración mediante ESP.restart()",
descricao: "Configurar el sistema para reiniciar ante fallos sin investigar la causa raíz del crash.",
consequencia: "El error persiste en producción, provocando reinicios cíclicos en campo, pérdida de estado de usuario y posibles corrupciones de archivos.",
},
solucaoEngenharia: {
titulo: "Validación estricta de punteros y decodificación de la traza de llamadas (Backtrace)",
passos: [
"Comprobar siempre el retorno de funciones de asignación y conexión (ej.: if (ptr == NULL) return;).",
"Utilizar la herramienta ESP Exception Decoder en Arduino IDE o 'idf.py monitor' en ESP-IDF para convertir la dirección del PC (Program Counter) y la traza de llamadas en el archivo y número de línea exactos del código fuente.",
"Establecer los punteros a NULL tras invocar free() para evitar dobles liberaciones y accesos a memoria caducada.",
],
},
codigoArduino: `// Práctica segura: Comprobación defensiva de punteros
void procesarMensaje(const char *mensaje) {
if (mensaje == nullptr) {
Serial.println(F("[ERROR] Puntero de mensaje nulo recibido. Operación abortada."));
return;
}
// Procesamiento seguro garantizado
Serial.printf("Longitud del mensaje: %d\n", strlen(mensaje));
}`,
codigoEspIdf: `// ESP-IDF: Verificación defensiva y aserciones
#include "esp_log.h"
#include "esp_check.h"
static const char *TAG = "APP_SAFETY";
esp_err_t inicializar_buffer(char **buf_out, size_t tamano) {
ESP_RETURN_ON_FALSE(buf_out != NULL, ESP_ERR_INVALID_ARG, TAG, "Puntero de salida nulo");
*buf_out = (char *)malloc(tamano);
ESP_RETURN_ON_FALSE(*buf_out != NULL, ESP_ERR_NO_MEM, TAG, "Fallo de memoria al asignar buffer");
return ESP_OK;
}`,
codigoMicroPython: `# MicroPython maneja excepciones en lugar de pánicos de bajo nivel:
def procesar_datos(sensor):
if sensor is None:
print("[WARN] Objeto sensor no inicializado")
return None
try:
return sensor.read()
except Exception as e:
print("Error en lectura:", e)
return None`,
},
{
id: "guru-iram-cache",
titulo: "Fallo de caché e InstructionFetchError en rutinas de interrupción (ISRs)",
categoria: "cpu-panics",
sintomas: ["null-pointer", "random-freeze"],
gravidade: "Crítica",
logSerial: "Guru Meditation Error: Core 0 panic'ed (Cache disabled but cached memory region accessed)\nCore 0 register dump:\nPC : 0x40081234 PS : 0x00060034",
resumo: "Ocurrió una interrupción (ISR) mientras la memoria Flash SPI estaba ocupada escribiendo o borrando datos con la caché desactivada.",
causaRaiz:
"Durante operaciones de escritura o borrado en la memoria Flash SPI (ej.: guardado en NVS, LittleFS o actualizaciones OTA), el controlador de hardware desactiva temporalmente la memoria caché de instrucciones. Si se dispara una interrupción por hardware y su rutina de atención (o cualquier función o constante de cadena a la que llame) reside en la memoria Flash en lugar de la memoria RAM interna (IRAM), la CPU no puede leer la siguiente instrucción y genera un pánico inmediato.",
gambiarra: {
titulo: "Desactivar interrupciones durante toda la escritura en Flash",
descricao: "Bloquear globalmente las interrupciones durante períodos prolongados de escritura.",
consequencia: "Genera desbordamientos en búferes de UART, pérdida de paquetes de red Wi-Fi y dispara el Interrupt Watchdog (IWDT).",
},
solucaoEngenharia: {
titulo: "Colocar la ISR y sus datos en memoria IRAM y DRAM usando atributos",
passos: [
"Declarar todas las funciones de interrupción con el atributo IRAM_ATTR (en Arduino/ESP-IDF).",
"Evitar llamar a funciones que residan en Flash (como Serial.print, sprintf, malloc o FreeRTOS API estándar sin sufijo FromISR) dentro de la ISR.",
"Almacenar constantes accedidas por la ISR con DRAM_ATTR si están fuera de la pila local.",
],
},
codigoArduino: `// Rutina de interrupción correcta con IRAM_ATTR:
volatile uint32_t contadorPulsos = 0;
void IRAM_ATTR manejarInterrupcion() {
// Prohibido usar Serial.print() aquí adentro (reside en Flash)
contadorPulsos++;
}
void setup() {
Serial.begin(115200);
pinMode(4, INPUT_PULLUP);
attachInterrupt(digitalPinToInterrupt(4), manejarInterrupcion, FALLING);
}`,
codigoEspIdf: `// ESP-IDF: Rutina ISR segura en IRAM
#include "esp_attr.h"
#include "driver/gpio.h"
static volatile uint32_t pulsos = 0;
static void IRAM_ATTR gpio_isr_handler(void* arg) {
pulsos++;
// Usar únicamente APIs de FreeRTOS terminadas en FromISR
}
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: Reservar memoria para excepciones en interrupciones
import micropython
from machine import Pin
micropython.alloc_emergency_exception_buf(100)
contador = 0
def handler(p):
global contador
contador += 1 # Operaciones atómicas y simples únicamente
pin = Pin(4, Pin.IN, Pin.PULL_UP)
pin.irq(trigger=Pin.IRQ_FALLING, handler=handler)`,
},
{
id: "freertos-twdt",
titulo: "Reinicio por Task Watchdog Timer (TWDT Timeout en Core 0 o Core 1)",
categoria: "freertos",
sintomas: ["wdt-reset", "bootloop"],
gravidade: "Alta",
logSerial: "E (10543) task_wdt: Task watchdog got triggered. The following tasks did not reset the watchdog in time:\nE (10543) task_wdt: - loopTask (CPU 1)\nE (10543) task_wdt: Tasks currently running on other CPUs:\nE (10543) task_wdt: - IDLE0 (CPU 0)",
resumo: "Una tarea de FreeRTOS acaparó la CPU de forma continua durante más de 5 segundos sin ceder tiempo a otras tareas.",
causaRaiz:
"El planificador de FreeRTOS requiere que las tareas de baja prioridad o la tarea IDLE del sistema se ejecuten periódicamente para alimentar el perro guardián (Watchdog). Si un bucle 'while(1)' o 'for' ejecuta cálculos intensivos o espera una condición sin llamar a vTaskDelay o ceder el procesador (yield), el temporizador del TWDT expira y reinicia el SoC para evitar congelamientos completos.",
gambiarra: {
titulo: "Aumentar el tiempo del Watchdog a 60 segundos o desactivarlo",
descricao: "Elevar el umbral en menuconfig para ocultar el bloqueo de la tarea.",
consequencia: "Si el código se congela realmente en campo, el sistema tardará minutos en recuperarse o quedará bloqueado indefinidamente consumiendo batería.",
},
solucaoEngenharia: {
titulo: "Introducir cesión explícita de CPU (vTaskDelay) o arquitectura dirigida por eventos",
passos: [
"Añadir al menos 'vTaskDelay(pdMS_TO_TICKS(1))' o 'delay(1)' dentro de cualquier bucle de procesamiento continuo.",
"Sustituir bucles de espera activa (polling continuo) por colas de FreeRTOS (xQueueReceive) o semáforos binarios bloqueantes.",
"Alimentar manualmente el perro guardián con esp_task_wdt_reset() si se realizan tareas largas inevitables.",
],
},
codigoArduino: `// Prevención del TWDT en Arduino:
void loop() {
// Procesamiento pesado:
for (int i = 0; i < 10000; i++) {
// Procesar elemento...
// Ceder CPU a la tarea IDLE cada cierto intervalo:
if (i % 500 == 0) {
vTaskDelay(pdMS_TO_TICKS(1)); // O delay(1); alimenta el Watchdog
}
}
}`,
codigoEspIdf: `// ESP-IDF: Tarea bloqueante basada en colas (0% consumo de CPU en reposo)
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/queue.h"
static QueueHandle_t colaEventos;
void tarea_procesadora(void *pvParameters) {
int evento;
while (1) {
// Bloquea indefinidamente hasta recibir datos, cediendo el 100% de la CPU:
if (xQueueReceive(colaEventos, &evento, portMAX_DELAY) == pdTRUE) {
// Procesar evento de forma segura
}
}
}`,
codigoMicroPython: `# MicroPython: Uso de asyncio para evitar bloqueos
import uasyncio as asyncio
async def tarea_pesada():
while True:
# Ejecutar lógica
await asyncio.sleep_ms(10) # Cede el bucle de eventos cooperativo`,
},
{
id: "freertos-stack-overflow",
titulo: "Desbordamiento de pila en tarea FreeRTOS (Stack Overflow)",
categoria: "freertos",
sintomas: ["bootloop", "random-freeze"],
gravidade: "Crítica",
logSerial: "***ERROR*** A stack overflow in task MiTarea has been detected.\nBacktrace:0x4008b123:0x3ffb7890 0x4008c456:0x3ffb78b0",
resumo: "La tarea excedió el espacio de memoria de pila (stack) asignado en su creación, sobrescribiendo variables de otras tareas.",
causaRaiz:
"Cada tarea de FreeRTOS recibe un bloque fijo de memoria para su pila local. Declarar arreglos o búferes grandes dentro de funciones locales (ej.: char buffer[2048]), anidar llamadas a funciones con múltiples niveles de recursión o invocar bibliotecas pesadas de JSON/TLS puede consumir rápidamente el espacio asignado, rompiendo el centinela (canary) de seguridad al final de la pila.",
gambiarra: {
titulo: "Asignar 32 KB de pila a todas las tareas indiscriminadamente",
descricao: "Colocar valores gigantescos en el parámetro usStackDepth de cada xTaskCreate.",
consequencia: "Agotamiento prematuro de la memoria SRAM interna, imposibilitando inicializar conexiones Wi-Fi o crear nuevas tareas.",
},
solucaoEngenharia: {
titulo: "Medir el margen de pila con uxTaskGetStackHighWaterMark y alojar búferes en el heap",
passos: [
"Monitorizar periódicamente el remanente mínimo de pila mediante uxTaskGetStackHighWaterMark(NULL).",
"Trasladar arreglos de más de 256 bytes fuera de la pila local, asignándolos dinámicamente en el heap (malloc) o de forma estática.",
"Dimensionar la pila de tareas que utilicen TLS/HTTPS con un mínimo de 6 KB a 8 KB.",
],
},
codigoArduino: `// Comprobación de pila remanente en Arduino:
void tareaMonitoreada(void *pvParameters) {
while (1) {
// Lógica de trabajo...
vTaskDelay(pdMS_TO_TICKS(1000));
// Devuelve el número mínimo de bytes libres que le quedaron a la pila:
UBaseType_t remanente = uxTaskGetStackHighWaterMark(NULL);
Serial.printf("Margen de seguridad de pila: %d bytes libres\n", remanente);
}
}`,
codigoEspIdf: `// ESP-IDF: Creación con dimensionamiento y habilitación de verificación de pila
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
// En menuconfig: Component config -> FreeRTOS -> Enable Stack Overflow Detection (Method 2)
void tarea_optimizada(void *pvParameters) {
while (1) {
vTaskDelay(pdMS_TO_TICKS(1000));
UBaseType_t espacioLibre = uxTaskGetStackHighWaterMark(NULL);
// Si espacioLibre < 512 bytes, aumente el stack en xTaskCreate
}
}`,
codigoMicroPython: `# MicroPython: Consulta de estado de memoria
import gc
gc.collect()
print("Memoria libre en RAM:", gc.mem_free(), "bytes")`,
},
{
id: "memoria-fragmentacao-heap",
titulo: "Fragmentación del heap y fugas de memoria (Memory Leaks)",
categoria: "memoria",
sintomas: ["random-freeze", "wifi-crash"],
gravidade: "Alta",
logSerial: "E (45210) esp_netif_lwip: Failed to allocate netif buffer\nE (45210) wifi: malloc 1420 failed, free heap: 42300, max allocable: 1200",
resumo: "El sistema tiene memoria libre total, pero no puede asignar un bloque contiguo por estar fragmentado en fragmentos pequeños.",
causaRaiz:
"El uso recurrente de la clase 'String' en bucles rápidos en Arduino, la manipulación de cadenas grandes mediante concatenación (+), o llamadas a malloc sin su correspondiente free van partiendo la memoria dinámica en islas minúsculas. Cuando el driver de Wi-Fi o TLS solicita un búfer de 2 a 4 KB contiguos para recibir un paquete de red, la asignación falla a pesar de que el informe global indique decenas de kilobytes libres.",
gambiarra: {
titulo: "Reiniciar el microcontrolador preventivamente cada noche",
descricao: "Configurar un temporizador para forzar ESP.restart() a intervalos regulares.",
consequencia: "Interrupción de operaciones activas, pérdida de estados de conexión y desatención de la causa subyacente.",
},
solucaoEngenharia: {
titulo: "Uso de búferes estáticos, reserva de memoria previa y monitorización del bloque máximo asignable",
passos: [
"Sustituir objetos String dinámicos por arreglos de caracteres tradicionales (char buffer[128]) con snprintf.",
"Si utiliza la clase String de Arduino, invocar 'str.reserve(tamañoMaximo)' de forma temprana para evitar continuas reasignaciones en el heap.",
"Supervisar el estado con heap_caps_get_largest_free_block(MALLOC_CAP_8BIT) en lugar de consultar únicamente el heap total.",
],
},
codigoArduino: `// Práctica recomendada en Arduino: Uso de snprintf y búfer fijo
void formatearDatos(float temp, float hum) {
char jsonBuffer[64];
// Seguro, rápido y no produce fragmentación en el heap:
snprintf(jsonBuffer, sizeof(jsonBuffer), "{\"t\":%.2f,\"h\":%.2f}", temp, hum);
Serial.println(jsonBuffer);
}`,
codigoEspIdf: `// ESP-IDF: Inspección del bloque contiguo más grande
#include "esp_heap_caps.h"
#include "esp_log.h"
void verificar_salud_memoria(void) {
size_t totalLibre = heap_caps_get_free_size(MALLOC_CAP_8BIT);
size_t mayorBloque = heap_caps_get_largest_free_block(MALLOC_CAP_8BIT);
ESP_LOGI("HEAP", "Total libre: %d bytes | Mayor bloque contiguo: %d bytes",
totalLibre, mayorBloque);
// Si mayorBloque es significativamente menor que totalLibre, existe fragmentación severa
}`,
codigoMicroPython: `# MicroPython: Recolección proactiva de basura
import gc
def ciclo_mantenimiento():
# Forzar compactación y recolección de basura antes de asignaciones grandes:
gc.collect()
print("Memoria disponible tras GC:", gc.mem_free())`,
},
{
id: "memoria-dma-psram",
titulo: "Fallo en asignaciones DMA con memoria externa (PSRAM)",
categoria: "memoria",
sintomas: ["null-pointer", "random-freeze"],
gravidade: "Alta",
logSerial: "E (1234) spi_master: spi_bus_add_device(345): buffer not in DMA-capable memory\nE (1234) lcd: esp_lcd_panel_draw_bitmap failed (-1)",
resumo: "Un controlador periférico (SPI, I2S, LCD) intentó transferir datos por DMA directamente desde o hacia una dirección de memoria PSRAM externa no compatible.",
causaRaiz:
"Los periféricos de alta velocidad utilizan controladores DMA que transfieren datos entre memorias y líneas de hardware de forma autónoma. En chips clásicos (como ESP32 y ESP32-S2), el motor DMA carece de acceso físico directo al bus SPI externo de la PSRAM. Intentar pasar un búfer alojado en PSRAM a funciones de dibujo LCD o transferencias SPI DMA produce un fallo inmediato de asignación.",
gambiarra: {
titulo: "Desactivar transferencias DMA y operar en modo polling por CPU",
descricao: "Configurar los buses para transferir byte por byte mediante registros directos.",
consequencia: "Caída catastrófica del rendimiento gráfico (de 30 FPS a menos de 5 FPS en pantallas a color) y uso total de la CPU.",
},
solucaoEngenharia: {
titulo: "Asignar búferes DMA en memoria interna SRAM con capacidades MALLOC_CAP_DMA",
passos: [
"Alojar siempre los descriptores y búferes activos de DMA en la memoria SRAM interna usando 'heap_caps_malloc(tamaño, MALLOC_CAP_DMA)'.",
"Utilizar arquitecturas de doble búfer (ping-pong): mantener los recursos gráficos en PSRAM y copiar por bloques pequeños a un búfer interno DMA de SRAM antes del envío.",
"En ESP32-S3 y ESP32-P4, verificar las versiones de revisión de silicio que admiten transferencias EDMA directas desde PSRAM.",
],
},
codigoArduino: `// Asignación segura de memoria compatible con DMA en Arduino:
#include <esp_heap_caps.h>
uint8_t *bufferDma = nullptr;
void setup() {
Serial.begin(115200);
// Asignar exclusivamente en memoria interna con capacidad DMA:
bufferDma = (uint8_t *)heap_caps_malloc(4096, MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL);
if (bufferDma == nullptr) {
Serial.println(F("[ERROR] Memoria SRAM interna insuficiente para DMA"));
}
}`,
codigoEspIdf: `// ESP-IDF: Asignación de búfer para transacciones de bus SPI
#include "esp_heap_caps.h"
uint8_t* asignar_buffer_spi(size_t len) {
return (uint8_t*)heap_caps_aligned_alloc(32, len, MALLOC_CAP_DMA | MALLOC_CAP_INTERNAL);
}`,
codigoMicroPython: `# MicroPython: Asignación de búfer con alineación para periféricos
import uctypes
# MicroPython gestiona la memoria DMA internamente al inicializar SPI o Display con drivers compilados`,
},
{
id: "boot-failed-connect",
titulo: "Failed to connect to ESP32: Timed out waiting for packet header (Fallo de conexión en subida)",
categoria: "boot-flash",
sintomas: ["upload-fail"],
gravidade: "Media",
logSerial: "Connecting........_____....._____....._____\nA fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header",
resumo: "La herramienta esptool en la computadora host no pudo comunicarse con la ROM de arranque del ESP32 a través del puerto serie.",
causaRaiz:
"El circuito de reinicio automático formado por transistores y líneas DTR/RTS en la placa de desarrollo no logró colocar a tiempo el pin GPIO0 en nivel bajo en el instante en que el pin EN pasó de bajo a alto. Causas muy frecuentes incluyen: cables USB de solo carga (sin líneas de datos D+/D-), ausencia de capacitor de retardo entre EN y GND, o puertos serie bloqueados por otros programas de terminal abiertos en la computadora.",
gambiarra: {
titulo: "Mantener pulsado manualmente el botón BOOT en cada grabación",
descricao: "Presionar con el dedo el botón físico de BOOT de la placa hasta que el esptool detecte el chip.",
consequencia: "Tedioso durante sesiones prolongadas de desarrollo e inviable cuando el microcontrolador se ubica en un gabinete sellado o en un rack.",
},
solucaoEngenharia: {
titulo: "Capacitor de 10 µF entre EN y GND y cable USB de datos de calidad",
passos: [
"Soldar o conectar un capacitor cerámico o electrolítico de 1 µF a 10 µF entre el pin EN (CHIP_PU) y el pin GND de la placa DevKit para generar el retardo RC necesario.",
"Asegurarse de cerrar cualquier monitor serie o software de depuración antes de iniciar el proceso de subida.",
"Verificar con un polímetro la continuidad de las líneas D+ y D- del cable USB.",
],
},
codigoArduino: `// No requiere código fuente en firmware: Este problema radica en la etapa de hardware y conexión serie.
// Para placas basadas en ESP32-S3 o C3 con USB Serial/JTAG nativo:
// En el menú Tools de Arduino IDE:
// USB CDC On Boot: "Enabled"
// Upload Mode: "UART0 / Hardware CDC"`,
codigoEspIdf: `// Verificación rápida desde la consola de terminal con esptool:
// idf.py -p /dev/ttyUSB0 flash monitor
// Si falla, reducir la velocidad de baudios en el comando:
// esptool.py -p /dev/ttyUSB0 -b 115200 chip_id`,
codigoMicroPython: `# En caso de error de conexión al flashear el firmware binario de MicroPython:
# esptool.py --port /dev/ttyUSB0 --baud 115200 erase_flash
# esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x1000 esp32-firmware.bin`,
},
{
id: "tls-sntp-clock-fail",
titulo: "Fallo en handshake TLS/HTTPS por reloj desincronizado (Año 1970)",
categoria: "conectividade",
sintomas: ["tls-fail"],
gravidade: "Alta",
logSerial: "E (5210) esp-tls-mbedtls: mbedtls_ssl_handshake returned -0x2700\nE (5210) esp-tls: Failed to verify peer certificate! (0x00000008 - BADCERT_EXPIRED / NOT_YET_VALID)",
resumo: "Las solicitudes HTTPS, MQTTS o WebSockets seguros fallan al verificar el certificado de seguridad del servidor.",
causaRaiz:
"Al encenderse, el reloj de tiempo real (RTC) interno del ESP32 se inicializa en la época Unix estándar (01 de enero de 1970). Los certificados digitales SSL/TLS emitidos por autoridades certificadoras (como Let's Encrypt o DigiCert) definen un período de validez temporal estricto (ej.: válido de 2024 a 2026). Al comprobar la fecha del certificado con su reloj fijado en 1970, la pila MbedTLS rechaza la conexión con el error BADCERT_NOT_YET_VALID.",
gambiarra: {
titulo: "Desactivar la verificación de certificados con setInsecure()",
descricao: "Configurar el cliente TLS para aceptar cualquier certificado sin validación.",
consequencia: "Grave vulnerabilidad de seguridad: deja al dispositivo expuesto a ataques Man-in-the-Middle (MitM), donde un atacante en la red local puede interceptar credenciales y datos privados.",
},
solucaoEngenharia: {
titulo: "Sincronizar la hora vía protocolo SNTP antes de iniciar conexiones seguras",
passos: [
"Iniciar el cliente SNTP inmediatamente después de que el ESP32 obtenga dirección IP de la red Wi-Fi.",
"Esperar a que la hora del sistema sea posterior al año 2024 antes de instanciar clientes HTTP/MQTT seguros.",
"Cargar los certificados de las Autoridades Certificadoras raíz (Root CA) de confianza en formato PEM.",
],
},
codigoArduino: `// Sincronización horaria previa obligatoria antes de peticiones HTTPS:
#include <WiFi.h>
#include <WiFiClientSecure.h>
#include <time.h>
void sincronizarHora() {
// Servidores NTP estándar globales:
configTime(0, 0, "pool.ntp.org", "time.google.com");
Serial.print("Sincronizando reloj con servidores NTP");
time_t ahora = time(nullptr);
while (ahora < 1704067200) { // Umbral: 01 de enero de 2024
delay(500);
Serial.print(".");
ahora = time(nullptr);
}
Serial.println("\nHora sincronizada correctamente. HTTPS listo.");
}`,
codigoEspIdf: `// ESP-IDF: Sincronización horaria mediante SNTP nativo
#include "esp_sntp.h"
#include "esp_log.h"
#include <time.h>
void inicializar_sntp(void) {
esp_sntp_setoperatingmode(SNTP_OPMODE_POLL);
esp_sntp_setservername(0, "pool.ntp.org");
esp_sntp_init();
time_t now = 0;
struct tm timeinfo = { 0 };
int reintentos = 0;
while (timeinfo.tm_year < (2024 - 1900) && ++reintentos < 20) {
vTaskDelay(pdMS_TO_TICKS(1000));
time(&now);
localtime_r(&now, &timeinfo);
}
}`,
codigoMicroPython: `# MicroPython: Ajuste de reloj mediante ntptime
import network
import ntptime
import time
wlan = network.WLAN(network.STA_IF)
if wlan.isconnected():
try:
ntptime.settime() # Sincroniza el RTC interno con servidores NTP
print("Hora actual sincronizada:", time.localtime())
except Exception as e:
print("Fallo de sincronización NTP:", e)`,
},
];
export const ERROS_COMUNS = errosCatalogo;
export const analisarLogSerial = [
{
padrao: /Brownout detector was triggered/i,
titulo: "Reinicio por subtensión (Brownout)",
tipo: "Alimentación / Hardware",
explicacao:
"La tensión en el riel de 3.3V cayó por debajo del límite operativo seguro durante picos de corriente del módem RF.",
acaoRecomendada:
"Añada un capacitor de desacoplo de 10 µF a 100 µF entre 3V3 y GND, o sustituya el cable USB y la fuente de alimentación.",
},
{
padrao: /Guru Meditation Error.*LoadProhibited/i,
titulo: "Pánico de CPU: LoadProhibited",
tipo: "Software / Puntero Nulo",
explicacao:
"El código intentó leer una dirección de memoria inválida o puntero desreferenciado con valor NULL.",
acaoRecomendada:
"Compruebe siempre los punteros antes de acceder a sus miembros y utilice el decodificador de excepciones para localizar la línea.",
},
{
padrao: /Guru Meditation Error.*StoreProhibited/i,
titulo: "Pánico de CPU: StoreProhibited",
tipo: "Software / Escritura Inválida",
explicacao:
"El código intentó escribir en una dirección de memoria de solo lectura o en un puntero nulo.",
acaoRecomendada:
"Verifique las operaciones de escritura en cadenas de texto constantes y la asignación válida de búferes.",
},
{
padrao: /Cache disabled but cached memory region accessed/i,
titulo: "Fallo de caché en interrupción (ISR)",
tipo: "Software / Flash & RAM",
explicacao:
"Una rutina de interrupción intentó ejecutar código alojado en Flash mientras la memoria caché estaba deshabilitada por escritura.",
acaoRecomendada:
"Declare la rutina de interrupción con la macro IRAM_ATTR y no invoque funciones que residan en Flash dentro de la ISR.",
},
{
padrao: /Task watchdog got triggered/i,
titulo: "Timeout del Task Watchdog (TWDT)",
tipo: "FreeRTOS / Bloqueo de CPU",
explicacao:
"Una tarea ejecutó un bucle sin ceder tiempo al planificador del sistema durante más de 5 segundos.",
acaoRecomendada:
"Añada vTaskDelay(1) dentro de los bucles intensivos para permitir que la tarea IDLE alimente el perro guardián.",
},
{
padrao: /A stack overflow in task/i,
titulo: "Desbordamiento de pila (Stack Overflow)",
tipo: "FreeRTOS / Memoria de Tarea",
explicacao:
"La tarea agotó el espacio de pila asignado en su creación, corrompiendo el centinela de seguridad.",
acaoRecomendada:
"Incremente el tamaño de pila en xTaskCreate (ej.: de 2048 a 4096 bytes) y traslade arreglos grandes al heap.",
},
{
padrao: /Timed out waiting for packet header|Failed to connect to ESP32/i,
titulo: "Fallo de conexión serie en subida de firmware",
tipo: "Bootloader / Conexión",
explicacao:
"La computadora host no logró colocar el ESP32 en modo de descarga de firmware vía líneas DTR/RTS.",
acaoRecomendada:
"Conecte un capacitor de 10 µF entre EN y GND, verifique que el cable USB tenga líneas de datos o mantenga presionado el botón BOOT.",
},
{
padrao: /The certificate is not yet valid|-0x2700/i,
titulo: "Fallo de certificado SSL/TLS (Reloj en 1970)",
tipo: "Conectividad / TLS",
explicacao:
"El ESP32 intentó validar un certificado HTTPS/TLS con su reloj interno desincronizado en la época de 1970.",
acaoRecomendada:
"Sincronice la hora mediante el protocolo SNTP (configTime en Arduino o ntptime en MicroPython) antes de iniciar peticiones TLS.",
},
{
padrao: /rst:0x1 \(POWERON_RESET\),boot:0x[0-9a-fA-F]+/i,
titulo: "Reinicio por encendido / Muestreo de Strapping Pins",
tipo: "Hardware / Boot",
explicacao:
"El microcontrolador se reinició y registró sus pines de arranque. Si se congela de inmediato, un pin de strapping tiene un nivel incorrecto.",
acaoRecomendada:
"Compruebe que los pines de arranque GPIOs no estén forzados a niveles incompatibles por circuitos externos en el instante del arranque.",
},
];
+408
View File
@@ -0,0 +1,408 @@
/**
* Base de datos estructurada y completa de términos técnicos del Glosario ESP32 en español.
* Abarca todas las series de chips de Espressif (ESP32, S2, S3, S31, C2, C3, C5, C6, C61, H2, H4, P4)
* y sus funciones de hardware, periféricos, radio, seguridad y software.
*/
export const categoriasGlossario = [
{
"id": "processamento",
"nome": "Procesamiento, CPU y Silicio",
"icone": "Cpu",
"emoji": "🧠",
"cor": "blue",
"descricao": "Arquitecturas Xtensa y RISC-V, núcleos, coprocesadores ULP, aceleradores vectoriales de IA y unidades de punto flotante.",
"termos": [
{
"termo": "Arquitectura Xtensa vs RISC-V",
"definicao": "Conjunto de instrucciones base del procesador. El ESP32 clásico, S2 y S3 utilizan núcleos propietarios Tensilica Xtensa (LX6/LX7). Las series modernas C (C2, C3, C5, C6, C61), H (H2, H4) y P (P4) adoptan la arquitectura abierta, modular y eficiente RISC-V (32 bits).",
"exemplo": "El ESP32-S3 usa Xtensa LX7 dual-core, mientras que el ESP32-C6 usa RISC-V single-core y el ESP32-P4 usa RISC-V dual-core a 400 MHz."
},
{
"termo": "Núcleos de CPU (Dual-Core vs Single-Core)",
"definicao": "Unidades centrales de procesamiento independientes. Los chips dual-core permiten dedicar un núcleo (Core 0) exclusivamente a la radio Wi-Fi/Bluetooth y a la planificación de FreeRTOS, dejando el segundo núcleo (Core 1) 100% libre para la aplicación y cálculos del usuario.",
"exemplo": "ESP32, ESP32-S3 y ESP32-P4 son dual-core; ESP32-S2, C2, C3, C6 y H2 son single-core."
},
{
"termo": "Frecuencia de reloj (MHz)",
"definicao": "Velocidad de procesamiento medida en Megahertz (MHz). El ESP-IDF ajusta dinámicamente la frecuencia (Dynamic Frequency Scaling - DFS) para ahorrar energía en momentos de inactividad.",
"exemplo": "El ESP32-C2 opera hasta 120 MHz; ESP32, S2, S3 y C6 alcanzan 160/240 MHz; y el ESP32-P4 alcanza 400 MHz."
},
{
"termo": "ULP (Coprocesador de ultra bajo consumo)",
"definicao": "Procesador secundario independiente de ultra bajo consumo que continúa ejecutando instrucciones, leyendo sensores analógicos (ADC), I2C y pines GPIO mientras los núcleos principales permanecen apagados en Deep Sleep.",
"exemplo": "El ESP32 original cuenta con ULP FSM; ESP32-S2, S3 y C6 disponen de ULP RISC-V programable en C; ESP32-P4 cuenta con ULP dedicado de bajo consumo."
},
{
"termo": "Extensiones vectoriales de IA (Vector Extension / ESP-NN)",
"definicao": "Instrucciones especializadas de silicio que ejecutan operaciones matemáticas vectoriales y matriciales con enteros (int8/int16) en paralelo, acelerando redes neuronales convolucionales (CNNs) y procesamiento de señales.",
"exemplo": "ESP32-S3 y ESP32-P4 aceleran inferencias de reconocimiento facial, detección de voz y modelos TensorFlow Lite for Microcontrollers."
},
{
"termo": "FPU (Unidad de punto flotante)",
"definicao": "Unidad de procesamiento de punto flotante por hardware que realiza sumas, multiplicaciones y divisiones con números decimales (`float`) en un único ciclo de reloj, sin sobrecarga por emulación de software.",
"exemplo": "Presente en los núcleos Xtensa del ESP32 y ESP32-S3, y en los núcleos RISC-V de alto rendimiento del ESP32-P4."
},
{
"termo": "PPA (Pixel Processing Accelerator)",
"definicao": "Acelerador gráfico 2D por hardware exclusivo del ESP32-P4 para manipulación acelerada de imágenes: rotación de fotogramas, escalado (scaling), mezcla alfa (alpha blending) y conversión de espacios de color (RGB565, ARGB8888, YUV420).",
"exemplo": "Renderizado de interfaces gráficas complejas (LVGL) a 60 FPS sin sobrecargar los núcleos de CPU principales."
}
]
},
{
"id": "seguranca",
"nome": "Seguridad, Criptografía y eFuses",
"icone": "ShieldCheck",
"emoji": "🔒",
"cor": "red",
"descricao": "eFuses inviolables, Secure Boot V2, cifrado de flash XTS-AES, Key Manager, ECC y protección contra DPA.",
"termos": [
{
"termo": "eFuse (Fusibles electrónicos)",
"definicao": "Conjunto de fusibles microscópicos de silicio de grabación única e irreversible (One-Time Programmable - OTP). Almacenan claves secretas de cifrado, la dirección MAC de fábrica y bloquean interfaces de depuración en productos comerciales.",
"exemplo": "Utilizado con la herramienta `espefuse.py` para grabar claves de Secure Boot y desactivar puertos JTAG antes del envío al usuario final."
},
{
"termo": "Secure Boot (V1 y V2)",
"definicao": "Protocolo de arranque seguro en el que el código de la ROM verifica criptográficamente la firma RSA-3072 o ECDSA del bootloader y del firmware antes de permitir su ejecución, impidiendo la inyección de código manipulado.",
"exemplo": "ESP32 clásico usa Secure Boot V1; del ESP32-S2 en adelante todos adoptan Secure Boot V2 con múltiples claves de firma."
},
{
"termo": "Cifrado de flash (Flash Encryption)",
"definicao": "Mecanismo de hardware que cifra y descifra en tiempo real el contenido de la memoria Flash SPI externa utilizando el algoritmo XTS-AES. Impide la lectura física del firmware en caso de robo de la placa o desoldado del chip de memoria.",
"exemplo": "XTS-AES-128 en la mayoría de los chips; ESP32-S3, C5, P4 y H4 también admiten XTS-AES-256."
},
{
"termo": "Key Manager",
"definicao": "Módulo de seguridad avanzada que aprovisiona, almacena y opera claves criptográficas en silicio sin exponerlas jamás a la memoria SRAM o al firmware, impidiendo la extracción de claves incluso ante vulnerabilidades de software.",
"exemplo": "Presente en series de alta seguridad como ESP32-S31, ESP32-C5 y ESP32-P4."
},
{
"termo": "ECC y ECDSA en hardware",
"definicao": "Aceleradores de curvas elípticas (como P-256 y P-384) y algoritmos de firma digital ECDSA en silicio, fundamentales para una conexión rápida y segura a la nube y para los requisitos de atestación del estándar Matter.",
"exemplo": "ESP32-S31, C5, C61, P4, H2 y H4 disponen de acelerador de hardware para ECDSA."
},
{
"termo": "HMAC y Firma Digital (DS)",
"definicao": "Periféricos de autenticación criptográfica que calculan códigos HMAC y firman mensajes con claves secretas grabadas en eFuses de forma invisible para el firmware.",
"exemplo": "Permite autenticación rápida y segura con AWS IoT Core y Microsoft Azure IoT sin almacenar certificados en texto plano."
},
{
"termo": "TRNG (Generador de números aleatorios verdaderos)",
"definicao": "Generador de números aleatorios verdaderos basado en el ruido térmico analógico de los circuitos de radio y silicio, esencial para generar claves de sesión en handshakes TLS/HTTPS.",
"exemplo": "Disponible en todas las series de ESP32 para garantizar entropía segura en conexiones HTTPS/MbedTLS."
},
{
"termo": "Protección contra DPA (Differential Power Analysis)",
"definicao": "Mecanismo físico de hardware que añade ruido y balanceo en el consumo de corriente eléctrica del chip para evitar que atacantes descubran claves criptográficas midiendo el consumo con osciloscopios.",
"exemplo": "Presente en las series ESP32-C5, C6, C61 y H2."
}
]
},
{
"id": "memoria",
"nome": "Memoria, Buses y Almacenamiento",
"icone": "Database",
"emoji": "💾",
"cor": "purple",
"descricao": "SRAM, PSRAM externa, buses QSPI y Octal SPI, ROM de arranque, memoria RTC y sistemas de archivos.",
"termos": [
{
"termo": "SRAM interna (Static RAM)",
"definicao": "Memoria de acceso aleatorio de ultra alta velocidad integrada en el silicio, dividida en IRAM (instrucciones) y DRAM (datos). No pierde datos mientras el chip esté alimentado en modo activo.",
"exemplo": "El ESP32 dispone de 520 KB de SRAM, mientras que el ESP32-P4 ofrece 768 KB de SRAM de alto rendimiento."
},
{
"termo": "ROM de arranque (Boot ROM)",
"definicao": "Memoria de solo lectura grabada durante la fabricación del silicio. Contiene el código de arranque primario (First-Stage Bootloader), rutinas de descarga serie y funciones criptográficas básicas.",
"exemplo": "No puede ser alterada por el usuario ni infectada por malware; es la raíz de confianza de todo el chip."
},
{
"termo": "Flash SPI (Quad-SPI vs Octal-SPI)",
"definicao": "Interfaz de comunicación con memorias Flash externas. Quad-SPI (QSPI) usa 4 líneas de datos, mientras que Octal SPI (OPI) usa 8 líneas simultáneas con soporte DDR, duplicando la tasa de transferencia.",
"exemplo": "Octal SPI en ESP32-S3 y ESP32-P4 permite tasas de lectura superiores a 120 MB/s para código y recursos multimedia."
},
{
"termo": "PSRAM (Pseudo-Static RAM externa)",
"definicao": "Memoria RAM dinámica externa empaquetada junto al chip (SiP) o conectada vía bus SPI/QSPI/OPI que expande la memoria disponible para buffers gráficos, audio y modelos de IA.",
"exemplo": "Módulos ESP32-WROVER y ESP32-S3 disponen de 2 MB a 16 MB de PSRAM; ESP32-P4 admite hasta 32 MB."
},
{
"termo": "SRAM RTC Fast y Slow",
"definicao": "Pequeños bloques de memoria SRAM (típicamente 8 KB a 32 KB) ubicados en el dominio de energía de bajo consumo (RTC / Low Power). Conservan su contenido durante el Deep Sleep.",
"exemplo": "Variables declaradas con `RTC_DATA_ATTR` mantienen su valor entre reinicios tras despertar de Deep Sleep."
},
{
"termo": "Asignación DMA (MALLOC_CAP_DMA)",
"definicao": "Solicitud de bloques de memoria RAM con direccionamiento físico continuo y accesibles por controladores DMA (Direct Memory Access) para transmisiones de alta velocidad sin intervención de la CPU.",
"exemplo": "Necesario para buffers de pantallas SPI/I8080, audio I2S, transceptores Wi-Fi y lecturas de tarjetas SD."
},
{
"termo": "Fragmentación del heap",
"definicao": "Degradación del espacio libre de memoria dinámica en múltiples bloques pequeños dispersos debido a asignaciones y liberaciones sucesivas (malloc/free), impidiendo asignar bloques grandes contiguos.",
"exemplo": "Causa común de fallos en conexiones TLS o asignación de buffers de cámara tras horas de funcionamiento."
}
]
},
{
"id": "conectividade",
"nome": "Conectividad Inalámbrica y Protocolos",
"icone": "Wifi",
"emoji": "📡",
"cor": "emerald",
"descricao": "Wi-Fi 4/6, Bluetooth Classic, BLE 5.x, Zigbee 3.0, Thread 1.3, Matter y redes ESP-NOW.",
"termos": [
{
"termo": "Wi-Fi 6 (802.11ax)",
"definicao": "Nueva generación del estándar Wi-Fi que aporta mayor eficiencia espectral, menor latencia y menor consumo energético en entornos saturados mediante OFDMA y Target Wake Time (TWT).",
"exemplo": "ESP32-C6 y ESP32-C5 soportan Wi-Fi 6 en 2.4 GHz; el ESP32-C5 añade compatibilidad con la banda de 5 GHz."
},
{
"termo": "Wi-Fi Dual-Band (2.4 GHz y 5 GHz)",
"definicao": "Capacidad de operar tanto en la banda tradicional de 2.4 GHz como en la banda más descongestionada y de mayor ancho de banda de 5 GHz.",
"exemplo": "El ESP32-C5 es el primer chip de Espressif con radio Wi-Fi 6 de doble banda simultánea (2.4 GHz y 5 GHz)."
},
{
"termo": "OFDMA (Acceso múltiple por división de frecuencias ortogonales)",
"definicao": "Tecnología de modulación de Wi-Fi 6 que divide los canales de radio en subcanales diminutos (Resource Units - RU), permitiendo transmitir datos hacia y desde múltiples dispositivos en un mismo instante.",
"exemplo": "Reduce drásticamente la latencia en redes con cientos de sensores IoT conectados al mismo punto de acceso Wi-Fi 6."
},
{
"termo": "TWT (Target Wake Time)",
"definicao": "Mecanismo de ahorro de energía de Wi-Fi 6 que permite al punto de acceso y al dispositivo acordar ventanas de comunicación específicas, manteniendo el microcontrolador dormido durante horas entre transmisiones.",
"exemplo": "Sensores a batería basados en ESP32-C6 multiplican su autonomía al conectarse a enrutadores Wi-Fi 6 con soporte TWT."
},
{
"termo": "Bluetooth Classic (BR/EDR)",
"definicao": "Modo tradicional de Bluetooth optimizado para streaming de audio continuo (perfil A2DP), transferencia de archivos y puertos serie SPP a tasas de datos de 2 a 3 Mbps.",
"exemplo": "Disponible en el ESP32 original y en el ESP32-S31 para recepción y reproducción de música Bluetooth."
},
{
"termo": "Bluetooth Low Energy (BLE 5.0 a 5.4)",
"definicao": "Versión optimizada para consumo ultra bajo con soporte para modo de alta velocidad (2 Mbps), largo alcance (Coded PHY de 125/500 kbps) y extensiones publicitarias periódicas.",
"exemplo": "Soportado en ESP32, S3, C3, C6, H2 y H4 para balizas, sensores corporales y aprovisionamiento de credenciales Wi-Fi."
},
{
"termo": "Bluetooth LE Audio y Auracast",
"definicao": "Nueva generación de audio Bluetooth basada en el códec LC3 de alta fidelidad y bajo consumo. Auracast permite transmitir audio en broadcast a un número ilimitado de receptores simultáneos.",
"exemplo": "Soportado nativamente por el SoC ESP32-H4 para auriculares inalámbricos y sistemas de transmisión de audio accesible."
},
{
"termo": "IEEE 802.15.4 (Zigbee 3.0 y Thread)",
"definicao": "Estándar de radio de baja potencia y baja tasa de transferencia en 2.4 GHz que sirve de base física para redes en malla de automatización del hogar (Zigbee 3.0 y Thread 1.3).",
"exemplo": "Chips como ESP32-H2 y ESP32-C6 cuentan con radio 802.15.4 para comunicación directa sin necesidad de Wi-Fi."
},
{
"termo": "Matter (Estándar unificado de hogar inteligente)",
"definicao": "Protocolo unificador de capa de aplicación respaldado por Apple, Google y la CSA. Funciona sobre Wi-Fi, Thread y Ethernet, garantizando interoperabilidad directa sin bridges propietarios.",
"exemplo": "Un enchufe inteligente programado con ESP-Matter funciona simultáneamente en Apple HomeKit, Google Home y Home Assistant."
}
]
},
{
"id": "perifericos",
"nome": "Entradas, Salidas y Periféricos",
"icone": "Sliders",
"emoji": "🔌",
"cor": "amber",
"descricao": "GPIO, ADC, DAC, PWM (LEDC/MCPWM), UART, SPI, I2C, I2S y pines táctiles capacitivos.",
"termos": [
{
"termo": "GPIO (Entradas y salidas de propósito general)",
"definicao": "Pines digitales configurables como entradas (lectura de botones y sensores lógicos) o salidas (control de relés, LEDs y actuadores). Cuentan con resistencias pull-up y pull-down configurables por software.",
"exemplo": "El ESP32 cuenta con hasta 34 GPIOs, mientras que el ESP32-S3 dispone de hasta 45 GPIOs multifuncionales."
},
{
"termo": "Pines de arranque (Strapping Pins)",
"definicao": "Pines GPIO específicos muestreados por el hardware durante el ciclo de reinicio (reset) para determinar el modo de arranque: ejecución normal desde Flash SPI, modo de descarga de firmware o configuración de voltajes LDO.",
"exemplo": "GPIO0 y GPIO2 en ESP32, o GPIO8 y GPIO9 en ESP32-C3/C6. Circuitos externos no deben forzar niveles no deseados durante el arranque."
},
{
"termo": "ADC (Convertidor analógico-digital)",
"definicao": "Convertidor que transforma tensiones analógicas continuas en valores numéricos digitales (resolución de 12 bits, o 13 bits en ESP32-S2), con atenuaciones ajustables para rangos de hasta ~3.1V.",
"exemplo": "ADC1 puede utilizarse simultáneamente con Wi-Fi, mientras que ADC2 comparte recursos de hardware con el subsistema de radio en algunos modelos."
},
{
"termo": "DAC (Convertidor digital-analógico)",
"definicao": "Convertidor por hardware que transforma números digitales en tensiones analógicas reales continuas (resolución de 8 bits), permitiendo generar ondas de sonido o voltajes de control.",
"exemplo": "Presente en los pines GPIO25 y GPIO26 del ESP32 clásico y en el ESP32-S2 (los chips RISC-V prescinden de DAC analógico directo)."
},
{
"termo": "LEDC (Controlador LED PWM)",
"definicao": "Periférico por hardware diseñado para modulación por ancho de pulso (PWM) de alta precisión con desvanecimiento automático (fading) por hardware, configurable en múltiples canales y resoluciones de hasta 20 bits.",
"exemplo": "Regulación de intensidad de tiras LED RGBW y servomotores sin ocupar tiempo de ejecución de la CPU."
},
{
"termo": "MCPWM (PWM para control de motores)",
"definicao": "Generador avanzado de PWM concebido para conmutación de puentes H, motores de corriente continua (DC), motores sin escobillas (BLDC) e inversores solares, con control de tiempo muerto (dead-time) y entradas de fallo (fault capture).",
"exemplo": "Presente en ESP32, S3, C6 y P4 para accionamiento preciso de servomotores y robótica."
},
{
"termo": "RMT (Periférico de control remoto)",
"definicao": "Transmisor y receptor de trenes de pulsos precisos con temporización exacta de microsegundos, ideal para protocolos infrarrojos (NEC, RC5, Sony) y control de LEDs direccionables WS2812B (NeoPixel).",
"exemplo": "Control de tiras de LEDs WS2812B con temporizaciones estrictas de 800 kHz sin bloquear interrupciones de la CPU."
},
{
"termo": "PCNT (Contador de pulsos)",
"definicao": "Periférico de hardware dedicado a contar flancos de subida y bajada de señales digitales de forma autónoma, sin generar interrupciones por cada pulso.",
"exemplo": "Lectura de codificadores rotativos en cuadratura (rotary encoders), medidores de caudal de agua y anemómetros."
},
{
"termo": "TWAI® (Interfaz automotriz de dos hilos / Bus CAN)",
"definicao": "Controlador de red automotriz e industrial compatible con la especificación CAN 2.0B y CAN FD, resistente al ruido electromagnético severo con confirmación por hardware de tramas.",
"exemplo": "Lectura de datos de telemetría de vehículos mediante conector OBD-II y comunicación en maquinaria pesada."
},
{
"termo": "Pines táctiles capacitivos (Touch)",
"definicao": "Circuitos analógicos integrados que miden variaciones diminutas de capacitancia eléctrica cuando un dedo humano se aproxima a una pista de cobre o almohadilla conductora.",
"exemplo": "Permite crear botones táctiles detrás de vidrio o plástico y despertar el chip de Deep Sleep mediante toque."
},
{
"termo": "PARLIO (Controlador de I/O paralelo)",
"definicao": "Interfaz paralela flexible de alta velocidad de Espressif con soporte para transmisión y recepción de datos de 1 a 16 bits sincronizados con reloj externo o interno.",
"exemplo": "Presente en ESP32-C6 y P4 para comunicación de alta velocidad con memorias externas, cámaras y pantallas LCD."
}
]
},
{
"id": "multimidia",
"nome": "Multimedia, USB e Interfaces Avanzadas",
"icone": "Sparkles",
"emoji": "✨",
"cor": "pink",
"descricao": "Interfaces de cámara DVP y MIPI CSI, pantallas LCD RGB y MIPI DSI, USB OTG nativo y USB Serial/JTAG.",
"termos": [
{
"termo": "USB OTG (On-The-Go) nativo",
"definicao": "Controlador USB integrado que permite al chip actuar tanto como periférico USB (teclado HID, ratón, puerto serie CDC, almacenamiento masivo) como puerto Host USB para conectar memorias USB o cámaras.",
"exemplo": "Soportado en ESP32-S2 y S3 a 12 Mbps (Full-Speed); ESP32-P4 cuenta con controlador USB 2.0 High-Speed a 480 Mbps."
},
{
"termo": "USB Serial/JTAG nativo",
"definicao": "Periférico de hardware que conecta directamente el puerto USB de la PC a los pines de depuración JTAG y consola serie del chip, eliminando la necesidad de chips conversores externos (como CP2102 o CH340).",
"exemplo": "Disponible en ESP32-C3, C6, S3, C5 y H2 para carga de firmware y depuración con OpenOCD sin sondas adicionales."
},
{
"termo": "USB 2.0 High-Speed (480 Mbps)",
"definicao": "Controlador USB de alta velocidad con capa física integrada (PHY High-Speed) que multiplica por 40 la velocidad de transferencia frente al USB Full-Speed (12 Mbps).",
"exemplo": "Exclusivo del ESP32-P4 para transmisión de video en tiempo real y transferencia masiva de archivos."
},
{
"termo": "MIPI CSI y MIPI DSI",
"definicao": "Interfaces serie diferenciales de ultra alta velocidad estándar de la industria móvil para sensores de cámara (CSI) y pantallas gráficas (DSI) de alta resolución.",
"exemplo": "Presentes en el ESP32-P4 con soporte de hasta 2 carriles a 1.5 Gbps por carril para video 1080p."
},
{
"termo": "Codificador de video H.264 por hardware",
"definicao": "Acelerador de compresión de video por hardware capaz de codificar secuencias de fotogramas en formato H.264 (AVC) a resoluciones de hasta 1080p a 30 FPS.",
"exemplo": "Exclusivo del ESP32-P4 para cámaras de seguridad IP y videoporteros sin sobrecargar la CPU."
},
{
"termo": "Ethernet MAC 10/100 Mbps",
"definicao": "Controlador de capa de enlace Ethernet integrado en silicio que requiere únicamente un chip transceptor físico externo (PHY como LAN8720 o IP101) conectado vía bus RMII.",
"exemplo": "Disponible en el ESP32 clásico y en el ESP32-P4 para conexiones de red por cable ultra estables sin interferencias de RF."
},
{
"termo": "Interfaz de cámara DVP (8 bits / 16 bits)",
"definicao": "Interfaz de cámara paralela de 8 a 16 bits sincronizada por reloj de píxel (PCLK), sincronización horizontal (HREF) y vertical (VSYNC), diseñada para sensores de imagen tipo OV2640 y OV5640.",
"exemplo": "Utilizada en placas como ESP32-CAM y ESP32-S3-EYE para captura y streaming de video MJPEG."
}
]
},
{
"id": "energia",
"nome": "Gestión de Energía y Modos de Suspensión",
"icone": "BatteryCharging",
"emoji": "🔋",
"cor": "teal",
"descricao": "Modo activo, Modem Sleep, Light Sleep, Deep Sleep, fuentes de activación y detección de brownout.",
"termos": [
{
"termo": "Modo activo (Active Mode)",
"definicao": "Estado de funcionamiento pleno en el que todos los núcleos de CPU, buses, periféricos y subsistemas de radio Wi-Fi/Bluetooth operan a su frecuencia nominal.",
"exemplo": "Consumo típico de 30 a 60 mA en cómputo puro, con picos de 200 a 400 mA durante transmisiones RF."
},
{
"termo": "Modem Sleep",
"definicao": "Modo de ahorro de energía en el que la CPU continúa funcionando activamente pero el subsistema de radio Wi-Fi o Bluetooth apaga sus circuitos entre intervalos de baliza (DTIM).",
"exemplo": "El ESP32 permanece asociado al router Wi-Fi consumiendo solo 20 a 40 mA mientras procesa datos locales."
},
{
"termo": "Light Sleep",
"definicao": "Modo en el que el reloj de la CPU se detiene y la mayor parte de los periféricos digitales se suspenden, pero la memoria RAM interna se preserva íntegramente. El retorno al modo activo es prácticamente instantáneo (< 1 ms).",
"exemplo": "Consumo de corriente reducido a 0.8–2.0 mA; puede despertarse por temporizador, pines GPIO, UART o eventos Wi-Fi."
},
{
"termo": "Deep Sleep",
"definicao": "Modo de suspensión profunda en el que la CPU principal, periféricos y SRAM estándar se desenergizan por completo. Solo el dominio RTC/LP y su memoria de bajo consumo permanecen activos.",
"exemplo": "Consumo de corriente diminuto de 5 a 150 µA, permitiendo que sensores autónomos operen durante años con una única batería."
},
{
"termo": "Hibernación (Hibernation Mode)",
"definicao": "El modo de consumo más bajo posible del chip: todos los osciladores internos y memorias se apagan, manteniendo solo un temporizador ultralento o un pin de reactivación externo.",
"exemplo": "Consumo residual tan bajo como 5 µA; al despertar, el chip ejecuta un reinicio completo (reboot)."
},
{
"termo": "Fuentes de activación (Wakeup Sources)",
"definicao": "Eventos de hardware configurados para reactivar el microcontrolador desde Light Sleep o Deep Sleep.",
"exemplo": "Temporizador RTC (Timer), interrupción por pin táctil (Touch), cambio de nivel lógico en pines GPIO (ext0/ext1) o eventos del coprocesador ULP."
},
{
"termo": "Detector de subtensión (Brownout Detector)",
"definicao": "Circuito comparador analógico interno que monitorea continuamente la tensión del riel de 3.3V y reinicia el chip de forma segura si el voltaje cae por debajo del umbral crítico (~2.43V).",
"exemplo": "Evita la corrupción de datos en la memoria Flash SPI durante caídas transitorias de tensión provocadas por picos de transmisión Wi-Fi."
}
]
},
{
"id": "desenvolvimento",
"nome": "Firmware, Arranque y Sistema Operativo",
"icone": "Code2",
"emoji": "🚀",
"cor": "rose",
"descricao": "Bootloader, tabla de particiones, FreeRTOS, ESP-IDF, IDF Component Manager y actualizaciones OTA.",
"termos": [
{
"termo": "Bootloader (Primera y segunda etapa)",
"definicao": "Proceso de arranque en dos fases: la ROM interna (1ª etapa) verifica los pines de arranque e inicia el Second-Stage Bootloader ubicado en la Flash, el cual carga la tabla de particiones y transfiere el control a la aplicación.",
"exemplo": "Permite seleccionar entre múltiples particiones de firmware (fábrica, OTA_0, OTA_1) según el estado del sistema."
},
{
"termo": "FreeRTOS (Sistema operativo de tiempo real)",
"definicao": "Sistema operativo de tiempo real adaptado por Espressif para multitarea simétrica multinúcleo (Symmetric Multiprocessing - SMP), administrando colas, semáforos, mutexes y prioridades de tareas en ambos núcleos.",
"exemplo": "Creación de tareas independientes con `xTaskCreatePinnedToCore()` fijadas específicamente al Core 0 o al Core 1."
},
{
"termo": "Atributos IRAM_ATTR y DRAM_ATTR",
"definicao": "Macros de compilación del ESP-IDF que fuerzan la ubicación de funciones en la memoria interna IRAM (en lugar de la Flash SPI) o datos en DRAM, requisito indispensable para rutinas de interrupción (ISRs).",
"exemplo": "Previene caídas por Guru Meditation si ocurre una interrupción mientras la memoria Flash SPI se encuentra ocupada escribiendo datos."
},
{
"termo": "Tabla de particiones (partitions.csv)",
"definicao": "Archivo de configuración que divide el espacio de la memoria Flash SPI en sectores lógicos con propósitos específicos: bootloader, datos de calibración NVS, aplicaciones de firmware y sistemas de archivos.",
"exemplo": "Configuración esencial para habilitar particiones duales de actualización inalámbrica OTA (`ota_0` y `ota_1`)."
},
{
"termo": "Actualizaciones OTA con Rollback",
"definicao": "Mecanismo que permite actualizar el firmware de dispositivos conectados vía Wi-Fi, Ethernet o BLE, escribiendo la nueva versión en una partición secundaria y alternando el puntero de arranque de forma atómica.",
"exemplo": "Cuenta con soporte para reversión automática (rollback) si el nuevo firmware falla en su primera ejecución."
},
{
"termo": "NVS (Non-Volatile Storage) y cifrado NVS",
"definicao": "Biblioteca y partición de almacenamiento en memoria Flash organizada en pares clave-valor. Incluye balanceo de desgaste (wear leveling) y cifrado con claves basadas en eFuses para datos sensibles de configuración.",
"exemplo": "Utilizada por el ESP-IDF para guardar credenciales Wi-Fi (SSID/contraseña) y claves criptográficas de forma segura."
},
{
"termo": "Sistemas de archivos (LittleFS y SPIFFS)",
"definicao": "Estructuras de archivos sobre memoria Flash SPI. LittleFS es el estándar moderno, más rápido, resistente a fallos de alimentación y con menor sobrecarga de RAM que el obsoleto SPIFFS.",
"exemplo": "Almacenamiento de páginas web (HTML/CSS/JS), imágenes de interfaz y certificados SSL en la memoria Flash local."
},
{
"termo": "JTAG y OpenOCD",
"definicao": "Estándar de depuración por hardware que permite pausar la ejecución de la CPU, inspeccionar el valor de registros, recorrer el código paso a paso y evaluar puntos de interrupción en tiempo real.",
"exemplo": "Depuración integrada mediante USB Serial/JTAG en ESP32-S3/C3/C6 o mediante sondas externas como ESP-PROG."
}
]
}
];
+173
View File
@@ -0,0 +1,173 @@
/**
* Conocimiento de dominio para la búsqueda inteligente en español.
*
* Sin dependencias ni alias de import: se ejecuta en el servidor (montando el índice),
* en el navegador (interpretando la consulta) y en scripts de prueba en Node.
*
* Todos los textos de `termos` ya están normalizados (minúsculas, sin acentos).
*/
export const normalizar = (s = "") =>
String(s)
.toLowerCase()
.normalize("NFD")
.replace(/[\u0300-\u036f]/g, "");
/**
* Reconoce pines ocupados por flash/PSRAM según la descripción del diagrama.
* "forte": el pin es consumido por la memoria (o es su alimentación).
* "fraco": solo se ve afectado en ciertos modos (ej.: SPI de 8 líneas/octal).
*/
const nivelMemoria = (palabra) => (p) => {
const citam = p._avs.filter((a) => a.includes(palabra) && !/^para chips (con|sin|com|sem)/i.test(a));
if (citam.some((a) => /(utilizad|dedicad|conectad)/i.test(a) && !/a menos que/i.test(a))) return "forte";
if (p._fn.some((f) => /alimentacion|alimentacao/i.test(f) && f.includes(palabra))) return "forte";
if (citam.length) return "fraco";
return null;
};
/**
* Temas que el usuario puede consultar en español.
*/
export const TOPICOS = [
{ id: "flash", nome: "Flash", termos: ["flash", "memoria flash", "spi flash", "almacenamiento", "firmware", "rom externa"], pinoNivel: nivelMemoria("flash"), pinoRotulo: "conectados a la memoria flash" },
{ id: "psram", nome: "PSRAM", termos: ["psram", "ram externa", "spiram"], pinoNivel: nivelMemoria("psram"), pinoRotulo: "conectados a la PSRAM" },
{ id: "memoria", nome: "Memoria", termos: ["memoria", "sram", "heap", "rtc ram", "kb de ram", "memoria interna", "ram", "memory"], pinoRotulo: "" },
{ id: "wifi", nome: "Wi-Fi", termos: ["wifi", "wi-fi", "inalambrico", "wireless", "sin cable", "802.11", "wifi6", "wifi 6", "wi-fi 6"], pinoCats: ["Antena"], pinoRotulo: "de antena y radio" },
{ id: "bluetooth", nome: "Bluetooth", termos: ["bluetooth", "ble", "bt", "bluetooth le", "mesh"], pinoCats: ["Antena"], pinoRotulo: "de antena y radio" },
{ id: "zigbee", nome: "Zigbee/Thread", termos: ["zigbee", "thread", "802.15.4", "ieee 802.15.4"], pinoRotulo: "" },
{ id: "matter", nome: "Matter", termos: ["matter", "hogar inteligente", "smart home", "casa inteligente"], pinoRotulo: "" },
{ id: "ethernet", nome: "Ethernet", termos: ["ethernet", "rmii", "cable de red", "lan"], pinoCats: ["Ethernet"], pinoRotulo: "de Ethernet" },
{ id: "can", nome: "CAN / TWAI", termos: ["can", "twai", "can bus", "canbus", "can fd"], pinoRe: /twai|\bcan\b/, pinoRotulo: "de CAN/TWAI" },
{ id: "usb", nome: "USB", termos: ["usb", "otg", "usb serial", "usb otg", "hid", "cdc"], pinoCats: ["USB"], pinoRotulo: "de USB" },
{ id: "jtag", nome: "JTAG / Depuración", termos: ["jtag", "debug", "depuracion", "depurar", "openocd", "gdb"], pinoCats: ["JTAG"], pinoRotulo: "de JTAG" },
{ id: "adc", nome: "ADC", termos: ["adc", "analogico", "entrada analogica", "convertidor analogico", "analogread", "saradc"], pinoCats: ["ADC"], pinoRotulo: "con ADC" },
{ id: "dac", nome: "DAC", termos: ["dac", "salida analogica", "convertidor digital"], pinoCats: ["DAC"], pinoRotulo: "con DAC" },
{ id: "touch", nome: "Táctil capacitivo", termos: ["touch", "capacitivo", "tactil", "toque", "touchpad", "sensor tactil"], pinoCats: ["Touch"], pinoRotulo: "de táctil capacitivo" },
{ id: "uart", nome: "UART", termos: ["uart", "serial", "tx", "rx", "txd", "rxd", "puerto serie"], pinoCats: ["UART"], pinoRotulo: "de UART" },
{ id: "spi", nome: "SPI", termos: ["spi", "mosi", "miso", "sclk", "bus spi"], pinoCats: ["SPI"], pinoRotulo: "de SPI" },
{ id: "i2c", nome: "I2C", termos: ["i2c", "sda", "scl", "twi", "iic"], pinoCats: ["I2C"], pinoRotulo: "de I2C" },
{ id: "i2s", nome: "I2S", termos: ["i2s", "audio", "sonido", "microfono", "pdm", "codec"], pinoRe: /i2s|\bpdm\b/, pinoRotulo: "de I2S / audio" },
{ id: "pwm", nome: "PWM", termos: ["pwm", "ledc", "mcpwm", "servo", "dimmer"], pinoRe: /ledc|pwm/, pinoRotulo: "de PWM" },
{ id: "sd", nome: "Tarjeta SD / SDIO", termos: ["sd", "sdio", "sd card", "sdcard", "tarjeta sd", "microsd", "sdmmc", "mmc"], pinoCats: ["SD"], pinoRe: /sdio|sdmmc|\bsd\b/, pinoRotulo: "de tarjeta SD/SDIO" },
{ id: "camera", nome: "Cámara", termos: ["camera", "camara", "cam", "dvp", "csi", "mipi csi", "ov2640", "video"], pinoCats: ["CSI"], pinoRe: /\bcam\b|dvp|cam_/, pinoRotulo: "de cámara" },
{ id: "lcd", nome: "Pantalla / LCD", termos: ["lcd", "display", "pantalla", "dsi", "mipi dsi", "oled", "tft", "lvgl", "rgb"], pinoCats: ["DSI"], pinoRe: /lcd/, pinoRotulo: "de pantalla/LCD" },
{ id: "strapping", nome: "Boot / Strapping", termos: ["strapping", "boot", "bootstrap", "modo de boot", "modo de arranque", "download mode", "modo de grabacion", "arranque"], pinoCats: ["Strapping"], pinoRotulo: "de strapping (modo de arranque)" },
{ id: "energia_pinos", nome: "Alimentación", termos: ["alimentacion", "vdd", "3v3", "3.3v", "tension", "regulador", "ldo", "fuente"], pinoCats: ["Power"], pinoRotulo: "de alimentación" },
{ id: "clock", nome: "Reloj / Cristal", termos: ["clock", "reloj", "xtal", "cristal", "oscilador", "32khz", "40mhz"], pinoCats: ["Clock"], pinoRotulo: "de reloj/cristal" },
{ id: "gpio", nome: "GPIO", termos: ["gpio", "entradas y salidas", "pines"], pinoCats: ["GPIO"], pinoRotulo: "de GPIO" },
{ id: "baixo_consumo", nome: "Bajo consumo / ULP", termos: ["ulp", "lp core", "lp cpu", "coprocesador", "lp gpio", "low power", "rtc gpio", "bajo consumo"], pinoCats: ["Low Power"], pinoRotulo: "de bajo consumo (LP/RTC)" },
{ id: "antena", nome: "Antena / RF", termos: ["antena", "rf", "radiofrecuencia", "ipex"], pinoCats: ["Antena"], pinoRotulo: "de antena/RF" },
{ id: "seguranca", nome: "Seguridad", termos: ["seguridad", "seguranca", "secure boot", "criptografia", "cifrado", "aes", "sha", "rsa", "hmac", "ecdsa", "efuse", "tee", "trng", "rng", "hsm", "proteccion"], pinoRotulo: "" },
{ id: "consumo", nome: "Consumo de energía", termos: ["consumo", "bateria", "deep sleep", "light sleep", "sleep", "modem sleep", "corriente", "miliamperios", "autonomia", "ahorro de energia", "modo bajo consumo"], pinoRotulo: "" },
{ id: "temperatura", nome: "Temperatura", termos: ["temperatura", "calor", "grados", "rango de temperatura", "industrial"], pinoRotulo: "" },
{ id: "ia", nome: "IA / Aceleración", termos: ["ia", "ai", "machine learning", "ml", "tinyml", "vectorial", "inteligencia artificial", "red neuronal", "esp-nn", "esp-dl"], pinoRotulo: "" },
{ id: "processador", nome: "Procesador", termos: ["procesador", "cpu", "nucleo", "nucleos", "core", "dual core", "single core", "arquitectura", "xtensa", "risc-v", "riscv"], pinoRotulo: "" },
{ id: "frequencia", nome: "Frecuencia", termos: ["frecuencia", "mhz", "velocidad", "rendimiento", "performance"], pinoRotulo: "" },
{ id: "ferramentas", nome: "Herramientas / SDK", termos: ["esp-idf", "idf", "arduino", "sdk", "toolchain", "cadena de herramientas", "version de idf"], pinoRotulo: "" },
{ id: "encapsulamento", nome: "Módulos y encapsulado", termos: ["modulo", "modulos", "encapsulado", "package", "qfn", "wroom", "wrover", "mini-1"], pinoRotulo: "" },
];
/**
* Campos de datos que responden a cada tema en español.
*/
export const SPEC_CAMPOS = [
{ campo: "arquitetura", label: "Arquitectura", secao: "processador", topicos: ["processador"] },
{ campo: "nucleos", label: "Núcleos", secao: "processador", topicos: ["processador"] },
{ campo: "frequencia", label: "Frecuencia", secao: "processador", topicos: ["frequencia", "processador"] },
{ campo: "coprocessador_ulp", label: "Coprocesador ULP", secao: "processador", topicos: ["baixo_consumo"] },
{ campo: "aceleradores_ia", label: "Aceleradores de IA", secao: "processador", topicos: ["ia"] },
{ campo: "wifi", label: "Wi-Fi", secao: "conectividade", topicos: ["wifi"] },
{ campo: "bluetooth", label: "Bluetooth", secao: "conectividade", topicos: ["bluetooth"] },
{ campo: "zigbee_thread", label: "Zigbee/Thread", secao: "conectividade", topicos: ["zigbee"] },
{ campo: "matter", label: "Matter", secao: "conectividade", topicos: ["matter"] },
{ campo: "ethernet", label: "Ethernet", secao: "conectividade", topicos: ["ethernet"] },
{ campo: "ethernet_mac", label: "Ethernet MAC", secao: "conectividade", topicos: ["ethernet"] },
{ campo: "can", label: "CAN", secao: "conectividade", topicos: ["can"] },
{ campo: "memoria_sram", label: "SRAM", secao: "memoria", topicos: ["memoria"] },
{ campo: "memoria_sram_rtc", label: "SRAM RTC", secao: "memoria", topicos: ["memoria", "baixo_consumo"] },
{ campo: "memoria_rom", label: "ROM", secao: "memoria", topicos: ["memoria"] },
{ campo: "flash_externa", label: "Flash externa", secao: "memoria", topicos: ["flash", "memoria"] },
{ campo: "psram_externa", label: "PSRAM externa", secao: "memoria", topicos: ["psram", "memoria"] },
{ campo: "gpio", label: "GPIO", secao: "perifericos", topicos: ["gpio"] },
{ campo: "adc", label: "ADC", secao: "perifericos", topicos: ["adc"] },
{ campo: "dac", label: "DAC", secao: "perifericos", topicos: ["dac"] },
{ campo: "touch", label: "Táctil capacitivo", secao: "perifericos", topicos: ["touch"] },
{ campo: "uart", label: "UART", secao: "perifericos", topicos: ["uart"] },
{ campo: "spi", label: "SPI", secao: "perifericos", topicos: ["spi", "flash"] },
{ campo: "i2c", label: "I2C", secao: "perifericos", topicos: ["i2c"] },
{ campo: "i2s", label: "I2S", secao: "perifericos", topicos: ["i2s"] },
{ campo: "pwm", label: "PWM", secao: "perifericos", topicos: ["pwm"] },
{ campo: "usb", label: "USB", secao: "perifericos", topicos: ["usb"] },
{ campo: "lcd", label: "LCD", secao: "interfaces", topicos: ["lcd"] },
{ campo: "camera", label: "Cámara", secao: "interfaces", topicos: ["camera"] },
{ campo: "mipi_csi", label: "MIPI CSI", secao: "interfaces", topicos: ["camera"] },
{ campo: "mipi_dsi", label: "MIPI DSI", secao: "interfaces", topicos: ["lcd"] },
{ campo: "sdio", label: "SDIO", secao: "interfaces", topicos: ["sd"] },
{ campo: "sensor_temperatura", label: "Sensor de temperatura", secao: "interfaces", topicos: ["temperatura"] },
{ campo: "seguranca.aes", label: "AES", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.sha", label: "SHA", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.rsa", label: "RSA", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.ecc", label: "ECC", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.ecdsa", label: "ECDSA", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.hmac", label: "HMAC", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.assinatura_digital", label: "Firma digital", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.rng", label: "Generador de números aleatorios", secao: "seguranca", topicos: ["seguranca"] },
{ campo: "seguranca.criptografia_flash", label: "Cifrado de flash", secao: "seguranca", topicos: ["seguranca", "flash"] },
{ campo: "seguranca.secure_boot", label: "Secure Boot", secao: "seguranca", topicos: ["seguranca", "strapping"] },
{ campo: "temperatura_operacao", label: "Temperatura de operación", secao: "temperatura", topicos: ["temperatura"] },
{ campo: "temperatura_armazenamento", label: "Temperatura de almacenamiento", secao: "temperatura", topicos: ["temperatura"] },
{ campo: "esp_idf_minimo", label: "ESP-IDF mínimo", secao: "ferramentas", topicos: ["ferramentas"] },
{ campo: "arduino_core", label: "Arduino Core", secao: "ferramentas", topicos: ["ferramentas"] },
{ campo: "depuracao", label: "Depuración", secao: "ferramentas", topicos: ["jtag", "ferramentas"] },
{ campo: "encapsulamento", label: "Encapsulado", secao: "ferramentas", topicos: ["encapsulamento"] },
{ campo: "modulos", label: "Módulos", secao: "ferramentas", topicos: ["encapsulamento"] },
];
const ROTULOS_ENERGIA = {
active: "Activo",
modem_sleep: "Modem Sleep",
light_sleep: "Light Sleep",
deep_sleep: "Deep Sleep",
hibernation: "Hibernación",
};
const pegar = (obj, caminho) => caminho.split(".").reduce((o, k) => (o == null ? o : o[k]), obj);
/**
* Monta la lista plana de especificaciones para cada serie en español.
*/
export function montarConhecimento(series, conexoes) {
const saida = {};
for (const [chave, s] of Object.entries(series)) {
const specs = [];
for (const c of SPEC_CAMPOS) {
const valor = pegar(s, c.campo);
if (valor == null || valor === "") continue;
specs.push({ label: c.label, valor: String(valor), secao: c.secao, topicos: c.topicos });
}
for (const [modo, valor] of Object.entries(s.consumo_energia ?? {})) {
const base = modo.replace(/_cpu.*|_wifi.*/, "");
const label = ROTULOS_ENERGIA[modo] ?? ROTULOS_ENERGIA[base] ?? modo.replace(/_/g, " ");
specs.push({ label: `Consumo: ${label}`, valor: String(valor), secao: "energia", topicos: ["consumo"] });
}
saida[chave] = {
nome: s.nome_completo ?? chave,
specs,
pinos: (conexoes[chave] ?? []).map((p) => ({
n: String(p.numero),
nome: p.nome,
f: p.funcoes ?? [],
c: p.categorias ?? [],
a: p.avisos ?? [],
})),
};
}
return saida;
}
+56 -12
View File
@@ -12,6 +12,13 @@ import { errosCatalogo as errosEn } from "@/lib/data/en/diagnostico";
import { COMPONENTES_REGISTRY as componentesEn } from "@/lib/data/en/componentes";
import { montarConhecimento as montarConhecimentoEn } from "@/lib/data/en/topicos";
import seriesDataEs from "@/data/es/series.json";
import frameworksDataEs from "@/data/es/frameworks.json";
import { categoriasGlossario as glossarioEs } from "@/lib/data/es/glossario";
import { errosCatalogo as errosEs } from "@/lib/data/es/diagnostico";
import { COMPONENTES_REGISTRY as componentesEs } from "@/lib/data/es/componentes";
import { montarConhecimento as montarConhecimentoEs } from "@/lib/data/es/topicos";
import { readFileSync, existsSync } from "node:fs";
import path from "node:path";
@@ -50,24 +57,57 @@ const PAGINAS_EN = [
{ titulo: "About the Project", descricao: "History, author and open source", href: "/en/about", keywords: "author contact" },
];
const PAGINAS_ES = [
{ titulo: "Inicio", descricao: "Página de inicio de ESPDocs", href: "/es", keywords: "home inicio" },
{ titulo: "Todas las Series", descricao: "Distribución de pines, especificaciones y restricciones de cada serie ESP32", href: "/es/series", keywords: "chips distribución de pines especificaciones" },
{ titulo: "Comparador de Series", descricao: "Compare hasta 4 modelos lado a lado", href: "/es/comparacion", keywords: "comparar comparación versus" },
{ titulo: "Catálogo de Placas", descricao: "Placas de desarrollo, conectores y compras", href: "/es/catalogo", keywords: "placas dev boards comprar devkit" },
{ titulo: "Selector Inteligente", descricao: "Descubra el chip ideal para su proyecto", href: "/es/selector", keywords: "quiz elegir recomendar selector" },
{ titulo: "Diagnóstico de Errores", descricao: "Solucione brownout, bucles de arranque, WDT y fallos", href: "/es/diagnostico", keywords: "error problema fallo crash" },
{ titulo: "Frameworks y SDKs", descricao: "ESP-IDF, Arduino, Rust, RainMaker y más", href: "/es/frameworks", keywords: "sdk" },
{ titulo: "Component Registry", descricao: "Catálogo de controladores y generador de idf_component.yml", href: "/es/componentes", keywords: "bibliotecas controladores drivers yml" },
{ titulo: "Glosario Técnico", descricao: "Conceptos esenciales de hardware y software", href: "/es/glosario", keywords: "términos diccionario significado" },
{ titulo: "Acerca del Proyecto", descricao: "Historia, autor y código abierto", href: "/es/acerca", keywords: "autor contacto código abierto" },
];
const cortar = (texto = "", max = 140) => (texto.length > max ? `${texto.slice(0, max - 1).trimEnd()}…` : texto);
export function construirIndiceBusca(locale = "pt") {
const isEn = locale === "en";
const paginas = isEn ? PAGINAS_EN : PAGINAS_PT;
const seriesData = isEn ? seriesDataEn : seriesDataPt;
const frameworksData = isEn ? frameworksDataEn : frameworksDataPt;
const categoriasGlossario = isEn ? glossarioEn : glossarioPt;
const errosCatalogo = isEn ? errosEn : errosPt;
const componentes = isEn ? componentesEn : componentesPt;
const montarConhecimento = isEn ? montarConhecimentoEn : montarConhecimentoPt;
const isEs = locale === "es";
const prefixo = isEn ? "/en" : "";
let paginas = PAGINAS_PT;
let seriesData = seriesDataPt;
let frameworksData = frameworksDataPt;
let categoriasGlossario = glossarioPt;
let errosCatalogo = errosPt;
let componentes = componentesPt;
let montarConhecimento = montarConhecimentoPt;
if (isEn) {
paginas = PAGINAS_EN;
seriesData = seriesDataEn;
frameworksData = frameworksDataEn;
categoriasGlossario = glossarioEn;
errosCatalogo = errosEn;
componentes = componentesEn;
montarConhecimento = montarConhecimentoEn;
} else if (isEs) {
paginas = PAGINAS_ES;
seriesData = seriesDataEs;
frameworksData = frameworksDataEs;
categoriasGlossario = glossarioEs;
errosCatalogo = errosEs;
componentes = componentesEs;
montarConhecimento = montarConhecimentoEs;
}
const prefixo = isEn ? "/en" : isEs ? "/es" : "";
const slugSeries = `${prefixo}/series`;
const slugFrameworks = `${prefixo}/frameworks`;
const slugGlossario = isEn ? "/en/glossary" : "/glossario";
const slugDiagnostico = isEn ? "/en/diagnostics" : "/diagnostico";
const slugComponentes = isEn ? "/en/components" : "/componentes";
const slugGlossario = isEn ? "/en/glossary" : isEs ? "/es/glosario" : "/glossario";
const slugDiagnostico = isEn ? "/en/diagnostics" : isEs ? "/es/diagnostico" : "/diagnostico";
const slugComponentes = isEn ? "/en/components" : isEs ? "/es/componentes" : "/componentes";
const itens = [];
@@ -130,7 +170,11 @@ export function construirIndiceBusca(locale = "pt") {
const conexoes = {};
for (const chave of Object.keys(seriesData)) {
const pastaConexoes = isEn ? path.join(process.cwd(), "data", "en", "conexoes") : path.join(process.cwd(), "public", "conexoes");
const pastaConexoes = isEn
? path.join(process.cwd(), "data", "en", "conexoes")
: isEs
? path.join(process.cwd(), "data", "es", "conexoes")
: path.join(process.cwd(), "public", "conexoes");
const arquivo = path.join(pastaConexoes, `${chave}.json`);
if (existsSync(arquivo)) {
conexoes[chave] = JSON.parse(readFileSync(arquivo, "utf8"));
+51 -29
View File
@@ -40,7 +40,7 @@ export function paginaMeta({ titulo, descricao, caminho, keywords = [], tipo = "
for (const loc of ENABLED_LOCALES) {
if (basePath === "/livro" && loc !== "pt") continue;
const locHref = getLocalizedHref(`/pt${basePath}`, loc);
const langKey = loc === "pt" ? "pt-BR" : loc;
const langKey = loc === "pt" ? "pt-BR" : loc === "es" ? "es-419" : loc;
languages[langKey] = `${SITE.url}${locHref}`;
}
if (ENABLED_LOCALES.includes("en") && basePath !== "/livro") {
@@ -94,6 +94,9 @@ export function paginaMeta({ titulo, descricao, caminho, keywords = [], tipo = "
export const jsonLd = {
siteESociedade(locale = "pt") {
const isEn = locale === "en";
const isEs = locale === "es";
const orgAnchor = isEn ? "organization" : isEs ? "organizacion" : "organizacao";
const authorAnchor = isEn ? "author" : "autor";
return {
"@context": "https://schema.org",
"@graph": [
@@ -102,15 +105,17 @@ export const jsonLd = {
"@id": `${SITE.url}/#site`,
url: `${SITE.url}/${locale}`,
name: SITE.nome,
inLanguage: isEn ? "en" : "pt-BR",
inLanguage: isEn ? "en" : isEs ? "es-419" : "pt-BR",
description: isEn
? "ESP32 ecosystem documentation: specifications, pinouts, comparison, and series selection."
: isEs
? "Documentación del ecosistema ESP32: especificaciones, patillaje, comparación y selección de series."
: "Documentação do ecossistema ESP32 em português brasileiro: especificações, pinagem, comparação e seleção de séries.",
publisher: { "@id": `${SITE.url}/#${isEn ? "organization" : "organizacao"}` },
publisher: { "@id": `${SITE.url}/#${orgAnchor}` },
},
{
"@type": "Organization",
"@id": `${SITE.url}/#${isEn ? "organization" : "organizacao"}`,
"@id": `${SITE.url}/#${orgAnchor}`,
name: "Ciência Embarcada",
url: SITE.blog,
logo: {
@@ -124,7 +129,7 @@ export const jsonLd = {
},
{
"@type": "Person",
"@id": `${SITE.url}/#${isEn ? "author" : "autor"}`,
"@id": `${SITE.url}/#${authorAnchor}`,
name: SITE.autor,
url: SITE.autorUrl,
email: SITE.autorEmail,
@@ -151,45 +156,51 @@ export const jsonLd = {
/** Documentação e ficha técnica da série como TechArticle para o Google. */
serie(chave, serie, locale = "pt") {
const isEn = locale === "en";
const isEs = locale === "es";
const prop = (nome, valor) =>
valor ? { "@type": "PropertyValue", name: nome, value: String(valor) } : null;
const propriedades = [
prop(isEn ? "Manufacturer" : "Fabricante", "Espressif Systems"),
prop(isEn ? "Architecture" : "Arquitetura", serie.arquitetura),
prop(isEn ? "Cores" : "Núcleos", serie.nucleos),
prop(isEn ? "Max frequency" : "Frequência máxima", serie.frequencia),
prop(isEn ? "Manufacturer" : isEs ? "Fabricante" : "Fabricante", "Espressif Systems"),
prop(isEn ? "Architecture" : isEs ? "Arquitectura" : "Arquitetura", serie.arquitetura),
prop(isEn ? "Cores" : isEs ? "Núcleos" : "Núcleos", serie.nucleos),
prop(isEn ? "Max frequency" : isEs ? "Frecuencia máxima" : "Frequência máxima", serie.frequencia),
prop("SRAM", serie.memoria_sram),
prop("RTC SRAM", serie.memoria_sram_rtc),
prop(isEn ? "Supported Flash" : "Flash suportada", serie.flash_suportada),
prop(isEn ? "Supported PSRAM" : "PSRAM suportada", serie.psram_suportada),
prop(isEn ? "Supported Flash" : isEs ? "Flash soportada" : "Flash suportada", serie.flash_suportada),
prop(isEn ? "Supported PSRAM" : isEs ? "PSRAM soportada" : "PSRAM suportada", serie.psram_suportada),
prop("GPIO", serie.gpio),
prop("Wi-Fi", serie.wifi),
prop("Bluetooth", serie.bluetooth),
prop("Zigbee / Thread / 802.15.4", serie.zigbee_thread),
prop(isEn ? "Package" : "Encapsulamento", serie.encapsulamento),
prop(isEn ? "Minimum ESP-IDF" : "ESP-IDF mínimo", serie.esp_idf_minimo),
prop(isEn ? "Package" : isEs ? "Encapsulado" : "Encapsulamento", serie.encapsulamento),
prop(isEn ? "Minimum ESP-IDF" : isEs ? "ESP-IDF mínimo" : "ESP-IDF mínimo", serie.esp_idf_minimo),
].filter(Boolean);
const imagem = serie.placa
? `${SITE.url}${serie.placa}`
: `${SITE.url}/opengraph-image.png`;
const basePath = isEn ? `/en/series/${chave}` : `/series/${chave}`;
const basePath = isEn ? `/en/series/${chave}` : isEs ? `/es/series/${chave}` : `/series/${chave}`;
const anchor = isEn ? "article" : isEs ? "articulo" : "artigo";
return {
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": `${SITE.url}${basePath}#${isEn ? "article" : "artigo"}`,
"@id": `${SITE.url}${basePath}#${anchor}`,
headline: isEn
? `${serie.nome_completo || chave}: specifications and pinout`
: isEs
? `${serie.nome_completo || chave}: especificaciones y patillaje`
: `${serie.nome_completo || chave}: especificações e pinagem`,
name: isEn
? `${serie.nome_completo || chave} - Technical Documentation and Specifications`
: isEs
? `${serie.nome_completo || chave} - Documentación técnica y especificaciones`
: `${serie.nome_completo || chave} - Documentação Técnica e Especificações`,
description: serie.descricao,
image: [imagem],
inLanguage: isEn ? "en" : "pt-BR",
inLanguage: isEn ? "en" : isEs ? "es-419" : "pt-BR",
datePublished: "2026-08-25T00:00:00.000Z",
dateModified: new Date().toISOString(),
mainEntityOfPage: `${SITE.url}${basePath}`,
@@ -222,20 +233,24 @@ export const jsonLd = {
/** Documentação técnica de framework. */
framework(chave, framework, locale = "pt") {
const isEn = locale === "en";
const basePath = isEn ? `/en/frameworks/${encodeURIComponent(chave)}` : `/frameworks/${encodeURIComponent(chave)}`;
const isEs = locale === "es";
const basePath = isEn ? `/en/frameworks/${encodeURIComponent(chave)}` : isEs ? `/es/frameworks/${encodeURIComponent(chave)}` : `/frameworks/${encodeURIComponent(chave)}`;
const anchor = isEn ? "article" : isEs ? "articulo" : "artigo";
return {
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": `${SITE.url}${basePath}#${isEn ? "article" : "artigo"}`,
"@id": `${SITE.url}${basePath}#${anchor}`,
headline: isEn
? `${framework.nome} for ESP32: Guide and Documentation`
: isEs
? `${framework.nome} para ESP32: Guía y documentación`
: `${framework.nome} para ESP32: Guia e Documentação`,
name: isEn
? `${framework.nome_completo || framework.nome} for ESP32`
: `${framework.nome_completo || framework.nome} para ESP32`,
description: framework.descricao,
image: [`${SITE.url}/opengraph-image.png`],
inLanguage: isEn ? "en" : "pt-BR",
inLanguage: isEn ? "en" : isEs ? "es-419" : "pt-BR",
datePublished: "2026-08-25T00:00:00.000Z",
dateModified: new Date().toISOString(),
mainEntityOfPage: `${SITE.url}${basePath}`,
@@ -270,19 +285,21 @@ export const jsonLd = {
/** Glossário: marca cada verbete como termo definido. */
glossario(categorias, locale = "pt") {
const isEn = locale === "en";
const basePath = isEn ? "/en/glossary" : "/glossario";
const isEs = locale === "es";
const basePath = isEn ? "/en/glossary" : isEs ? "/es/glosario" : "/glossario";
const anchor = isEn ? "glossary" : isEs ? "glosario" : "glossario";
return {
"@context": "https://schema.org",
"@type": "DefinedTermSet",
"@id": `${SITE.url}${basePath}#${isEn ? "glossary" : "glossario"}`,
name: isEn ? "ESP32 Technical Glossary" : "Glossário Técnico do ESP32",
inLanguage: isEn ? "en" : "pt-BR",
"@id": `${SITE.url}${basePath}#${anchor}`,
name: isEn ? "ESP32 Technical Glossary" : isEs ? "Glosario técnico de ESP32" : "Glossário Técnico do ESP32",
inLanguage: isEn ? "en" : isEs ? "es-419" : "pt-BR",
hasDefinedTerm: categorias.flatMap((cat) =>
cat.termos.map((t) => ({
"@type": "DefinedTerm",
name: t.termo,
description: t.definicao,
inDefinedTermSet: `${SITE.url}${basePath}#${isEn ? "glossary" : "glossario"}`,
inDefinedTermSet: `${SITE.url}${basePath}#${anchor}`,
}))
),
};
@@ -304,6 +321,7 @@ export const jsonLd = {
/** Aplicação web / ferramenta interativa (Seletor, Comparador, Catálogo). */
aplicacaoWeb({ nome, descricao, caminho, locale = "pt" }) {
const isEn = locale === "en";
const isEs = locale === "es";
return {
"@context": "https://schema.org",
"@type": "WebApplication",
@@ -314,7 +332,7 @@ export const jsonLd = {
applicationCategory: "DeveloperApplication",
operatingSystem: "All",
browserRequirements: "Requires JavaScript",
inLanguage: isEn ? "en" : "pt-BR",
inLanguage: isEn ? "en" : isEs ? "es-419" : "pt-BR",
author: {
"@type": "Person",
name: SITE.autor,
@@ -396,17 +414,21 @@ export const jsonLd = {
/** Página Sobre com metadados E-E-A-T de autoria e reputação. */
paginaSobre(locale = "pt") {
const isEn = locale === "en";
const basePath = isEn ? "/en/about" : "/sobre";
const isEs = locale === "es";
const basePath = isEn ? "/en/about" : isEs ? "/es/acerca" : "/sobre";
const anchor = isEn ? "about" : isEs ? "acerca" : "sobre";
return {
"@context": "https://schema.org",
"@type": "AboutPage",
"@id": `${SITE.url}${basePath}#${isEn ? "about" : "sobre"}`,
name: isEn ? "About ESPDocs" : "Sobre o ESPDocs",
"@id": `${SITE.url}${basePath}#${anchor}`,
name: isEn ? "About ESPDocs" : isEs ? "Acerca de ESPDocs" : "Sobre o ESPDocs",
description: isEn
? "ESPDocs is an independent platform organizing technical documentation of the ESP32 ecosystem."
: isEs
? "ESPDocs es una plataforma independiente que reúne la documentación técnica del ecosistema ESP32."
: "O ESPDocs é uma plataforma independente que reúne a documentação do ecossistema ESP32 em português brasileiro.",
url: `${SITE.url}${basePath}`,
inLanguage: isEn ? "en" : "pt-BR",
inLanguage: isEn ? "en" : isEs ? "es-419" : "pt-BR",
mainEntity: {
"@type": "Person",
name: SITE.autor,
+152
View File
@@ -0,0 +1,152 @@
{
"Common": {
"siteName": "ESPDocs",
"author": "Lucas Rayan Guerra",
"organization": "Ciência Embarcada",
"skipToContent": "Saltar al contenido",
"allRightsReserved": "Contenido bajo licencia MIT. Hecho para la comunidad de sistemas embebidos.",
"backToHome": "Volver al inicio",
"explore": "Explorar",
"tools": "Herramientas",
"project": "Proyecto",
"loading": "Cargando...",
"search": "Buscar...",
"officialDocumentation": "Documentación oficial",
"community": "Comunidad",
"mitLicense": "Licencia MIT"
},
"Header": {
"brand": "ESPDocs",
"homeAria": "ESPDocs, página de inicio",
"navAria": "Navegación principal",
"mobileNavAria": "Navegación móvil",
"openMenu": "Abrir menú de navegación",
"closeMenu": "Cerrar menú",
"navigationTitle": "Navegación",
"whereToGo": "A dónde ir",
"selectChip": "Seleccionar chip",
"selectMyChip": "Seleccionar mi chip",
"hardware": "Hardware",
"hardwareDesc": "12 chips, distribución de pines y especificaciones",
"series": "Series ESP32",
"seriesDesc": "12 chips, distribución de pines y especificaciones",
"comparator": "Comparador",
"comparatorDesc": "Hasta cuatro series lado a lado",
"catalog": "Catálogo de placas",
"catalogDesc": "DevKits, distribución de pines y dónde comprar",
"tools": "Herramientas",
"selector": "Selector inteligente",
"selectorDesc": "El chip adecuado para su proyecto",
"diagnostics": "Diagnóstico",
"diagnosticsDesc": "Brownout, bucles de arranque, WDT y más",
"components": "Component Registry",
"componentsDesc": "Controladores y manifiestos idf_component.yml",
"library": "Biblioteca",
"frameworks": "Frameworks y SDKs",
"frameworksDesc": "ESP-IDF, Arduino, Rust y Matter",
"glossary": "Glosario técnico",
"glossaryDesc": "Términos que aparecen en las hojas de datos",
"about": "Acerca del proyecto",
"aboutDesc": "Autoría, método y código abierto"
},
"Footer": {
"ariaLabel": "Pie de página de ESPDocs",
"description": "Documentación independiente del ecosistema ESP32. Datos abiertos, curaduría editorial y enlaces a fuentes oficiales.",
"exploreTitle": "Explorar",
"toolsTitle": "Herramientas",
"projectTitle": "Proyecto",
"authorTitle": "Autor",
"reportIssue": "Reportar un problema",
"repository": "Repositorio",
"personalSite": "Sitio personal",
"linkedin": "LinkedIn"
},
"Home": {
"badge": "Documentación abierta de ESP32",
"titleLine1": "El ESP32,",
"titleLine2": " sin ruido.",
"lede": "Especificaciones, distribución de pines, comparativas y diagnóstico en una sola lectura. Menos traducción de hojas de datos, más tiempo en el banco de trabajo.",
"chooseMyChip": "Elegir mi chip",
"exploreSeries": "Explorar las {count} series",
"seriesCount": "{count} series",
"frameworkCount": "{count} frameworks",
"portugueseFlag": "100% en español",
"featuredSeries": "Series destacadas",
"featuredDesc": "Lo esencial de cada familia antes de abrir la hoja de datos.",
"fullIndex": "Índice completo",
"toolsTitle": "Comience por el problema.",
"toolsEyebrow": "Herramientas",
"toolsDesc": "Herramientas para seleccionar el chip adecuado, diagnosticar errores de hardware y acelerar el desarrollo."
},
"NotFound": {
"eyebrow": "Error 404",
"title": "Esta página no existe.",
"lede": "La URL puede haber cambiado o haber sido escrita incorrectamente. Elija una de estas rutas para continuar.",
"backToHome": "Volver al inicio",
"seriesTitle": "Series ESP32",
"seriesDesc": "12 familias, con distribución de pines y especificaciones.",
"selectorTitle": "Selector de chips",
"selectorDesc": "Responda ocho preguntas y encuentre los modelos recomendados.",
"comparatorTitle": "Comparador",
"comparatorDesc": "Hasta cuatro series lado a lado.",
"glossaryTitle": "Glosario",
"glossaryDesc": "Términos de hardware explicados con claridad."
},
"Sobre": {
"label": "Proyecto independiente",
"title": "Acerca de ESPDocs",
"lede": "Una plataforma no oficial que organiza información técnica sobre el ESP32 y enlaza directamente a la documentación oficial de Espressif. Creada para la comunidad de hardware abierto.",
"viewRepository": "Ver repositorio",
"features": {
"portugueseTitle": "Contenido seleccionado",
"portugueseDesc": "Datos técnicos estructurados y presentados con claridad, sin el ruido de las hojas de datos.",
"visualCompareTitle": "Comparaciones visuales",
"visualCompareDesc": "Tablas y diagramas para seleccionar la serie adecuada sin abrir diez hojas de datos.",
"centralizedAccessTitle": "Acceso centralizado",
"centralizedAccessDesc": "Enlaces directos a la documentación oficial, repositorios y ejemplos.",
"openSourceTitle": "Código abierto",
"openSourceDesc": "Las contribuciones son bienvenidas en Gitea."
}
},
"Series": {
"title": "Series ESP32",
"description": "12 series de ESP32 lado a lado: ESP32, S2, S3, S31, C2, C3, C5, C6, C61, P4, H2 y H4. Arquitectura, memoria, radio, periféricos y distribución de pines de cada una.",
"pinout": "Distribución de pines",
"specifications": "Especificaciones",
"peripherals": "Periféricos",
"architecture": "Arquitectura",
"memory": "Memoria",
"radio": "Radio",
"security": "Seguridad de hardware"
},
"Catalogo": {
"title": "Catálogo de placas de desarrollo",
"description": "DevKits oficiales y de terceros con distribución de pines, interfaces y enlaces de compra.",
"filterBySeries": "Filtrar por serie",
"searchBoards": "Buscar placas..."
},
"Comparacao": {
"title": "Comparador de series ESP32",
"description": "Compare hasta 4 series lado a lado con especificaciones completas de procesamiento, radio, memoria y distribución de pines."
},
"Componentes": {
"title": "ESP Component Registry",
"description": "Controladores, bibliotecas y manifiestos idf_component.yml listos para usar con ESP-IDF."
},
"Diagnostico": {
"title": "Diagnóstico y solución de problemas",
"description": "Brownout, bucles de arranque, pánicos de CPU, FreeRTOS y buenas prácticas de hardware."
},
"Frameworks": {
"title": "Frameworks y SDKs",
"description": "Guías y resúmenes de los principales entornos de desarrollo: ESP-IDF, Arduino, MicroPython, Rust y ESP-Matter."
},
"Glossario": {
"title": "Glosario técnico",
"description": "Explicaciones prácticas de conceptos de hardware, periféricos, radio y arquitectura presentes en las hojas de datos."
},
"Seletor": {
"title": "Selector inteligente de ESP32",
"description": "Responda preguntas objetivas sobre su proyecto y encuentre la serie ideal según criterios técnicos."
}
}
+29
View File
@@ -0,0 +1,29 @@
#include <WiFi.h>
// Substitua pelos dados da sua rede 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);
// Aguarda a conexão
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() {
// Aqui você pode colocar o código principal do seu programa
delay(1000);
}
+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)
{
// Inicializa periféricos (como o SD card)
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);
// Espera o SD card montar
periph_sdcard_wait_for_ready(sdcard_handle, portMAX_DELAY);
ESP_LOGI(TAG, "SD card montado!");
// Cria o pipeline
audio_pipeline_handle_t pipeline;
audio_pipeline_cfg_t pipeline_cfg = DEFAULT_AUDIO_PIPELINE_CONFIG();
pipeline = audio_pipeline_init(&pipeline_cfg);
// Elementos: arquivo (fatfs), decodificador (mp3) e saída (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);
// Registra e conecta elementos
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);
// Define o arquivo MP3 a ser tocado
audio_element_set_uri(fatfs_stream_reader, "/sdcard/test.mp3");
// Inicia el pipeline
ESP_LOGI(TAG, "Iniciando pipeline...");
audio_pipeline_run(pipeline);
// Mantém o pipeline rodando
while (1) {
vTaskDelay(1000 / portTICK_PERIOD_MS);
}
// (Nunca chega aqui, mas seria o cleanup)
audio_pipeline_stop(pipeline);
audio_pipeline_wait_for_stop(pipeline);
audio_pipeline_terminate(pipeline);
}
+37
View File
@@ -0,0 +1,37 @@
#include <stdio.h>
#include "esp_dsp.h"
#define N 8 // Tamanho do vetor
void app_main(void)
{
// Vetor de entrada (exemplo de sinal)
float x[N] = {1.0, -2.0, 3.0, -4.0, 2.5, -1.5, 0.0, 4.5};
float y[N]; // Vetor de saída
// Inicializa o 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");
// Calcula o quadrado de cada valor
dsps_mulc_f32(x, y, N, 1.0f);
dsps_mul_f32(y, y, y, N, 1, 1, 1);
// Soma todos os quadrados
float soma = 0;
dsps_sum_f32(y, N, &soma, 1);
// Calcula a magnitude (raiz da soma dos quadrados)
float magnitude = sqrtf(soma);
printf("Magnitude do vetor: %f\n", magnitude);
}
+56
View File
@@ -0,0 +1,56 @@
/*
* Ejemplo ESP-IDF v5.x+ para ESP32
* Demostración de inicialización del sistema, gestión de tareas FreeRTOS y log unificado
*
* Gestión de componentes (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 // Ajuste según el pin del LED de su placa
static void blink_task(void *pvParameters)
{
// Configura el pin GPIO con la nueva API de ESP-IDF
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 libre: %lu bytes",
led_state ? "ENCENDIDO" : "DESENCENDIDO",
(unsigned long)esp_get_free_heap_size());
vTaskDelay(pdMS_TO_TICKS(1000));
}
}
void app_main(void)
{
// Informações do chip 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, "===========================================");
// Cria uma tarefa FreeRTOS dedicada
xTaskCreate(blink_task, "blink_task", 3072, NULL, 5, NULL);
}
+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));
}
}
+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 la pila Matter
ESP_ERROR_CHECK(esp_matter::start(node));
ESP_LOGI(TAG, "Dispositivo Matter iniciado. Aguardando comissionamento...");
}
+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);
}
+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));
}
}
+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 ? "ENCENDIDO" : "DESENCENDIDO");
// 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.");
}
+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);
}
+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);
}
+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);
}
+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
+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);
}
}
+16 -4
View File
@@ -125,6 +125,15 @@ const TECHNICAL_ALLOWLIST = new Set([
"4",
"5",
"6",
"Buscar...",
"Catálogo de placas",
"Diagnóstico",
"Índice completo",
"Periféricos",
"Modern C++",
"Núcleos de CPU (Dual-Core vs Single-Core)",
"Bluetooth Classic (BR/EDR)",
"Ethernet MAC 10/100 Mbps",
]);
function isTechnicalAllowlisted(val, path = "") {
@@ -142,7 +151,7 @@ function isTechnicalAllowlisted(val, path = "") {
if (/^(\p{Extended_Pictographic}|\p{Emoji_Presentation}|\s)+$/u.test(s)) return true;
// Medidas, números, percentuais, frequências, consumos, intervalos
if (/^[-+]?\d+([.,]\d+)?(\s*[%]|(\s*(MHz|GHz|KB|MB|GB|µA|mA|A|V|mV|mW|W|dBm|°C|mm|ohms|kΩ|µF|nF)))?$/i.test(s)) return true;
if (/^[-+]?\d+([.,]\d+)?\s*(a|to|-)\s*[-+]?\d+([.,]\d+)?(\s*(MHz|GHz|KB|MB|GB|µA|mA|A|V|mV|mW|W|dBm|°C|mm|ohms|kΩ|µF|nF))?$/i.test(s)) return true;
if (/^[-+]?\d+([.,]\d+)?(\s*°C)?\s*(a|to|-)\s*[-+]?\d+(\/\d+)*([.,]\d+)?(\s*(MHz|GHz|KB|MB|GB|µA|mA|A|V|mV|mW|W|dBm|°C|mm|ohms|kΩ|µF|nF))?$/i.test(s)) return true;
if (/^\d+\s*mW\s*\([^)]*\)$/i.test(s)) return true;
// Hardware specs / contagem de periféricos: "1 (CAN 2.0, TWAI®)", "1 (Single-core)", "2 (Dual-core)"
if (/^\d+(\s*\(.*\))?(\s*(\+|\/|,)\s*\d+(\s*\(.*\))?)*$/i.test(s)) return true;
@@ -416,7 +425,7 @@ async function verificarDadosPorIdioma() {
const problemas = encontrarIdenticos(ptSeries, locSeries, `data/${loc}/series.json`);
if (problemas.length > 0) {
falha(`'${loc}': ${problemas.length} valor(es) string em series.json idênticos ao pt fora da allowlist.`);
for (const p of problemas.slice(0, 5)) {
for (const p of problemas.slice(0, 50)) {
console.log(` ${CORES.cinza}${p.path}: "${p.value}"${CORES.reset}`);
}
} else {
@@ -433,7 +442,7 @@ async function verificarDadosPorIdioma() {
const problemas = encontrarIdenticos(ptFw, locFw, `data/${loc}/frameworks.json`);
if (problemas.length > 0) {
falha(`'${loc}': ${problemas.length} valor(es) string em frameworks.json idênticos ao pt fora da allowlist.`);
for (const p of problemas.slice(0, 5)) {
for (const p of problemas.slice(0, 50)) {
console.log(` ${CORES.cinza}${p.path}: "${p.value}"${CORES.reset}`);
}
} else {
@@ -454,7 +463,7 @@ async function verificarDadosPorIdioma() {
const problemas = encontrarIdenticos(pt, en, `conexoes/${f}`);
totalConexoesProblemas += problemas.length;
if (problemas.length > 0) {
for (const p of problemas.slice(0, 3)) {
for (const p of problemas.slice(0, 10)) {
console.log(` ${CORES.cinza}${p.path}: "${p.value}"${CORES.reset}`);
}
}
@@ -503,6 +512,9 @@ async function verificarDadosPorIdioma() {
const problemasGloss = encontrarIdenticos(ptGloss, locGloss, `lib/data/${loc}/glossario.js`);
if (problemasGloss.length > 0) {
falha(`'${loc}': ${problemasGloss.length} string(s) em glossario.js idênticas ao pt fora da allowlist.`);
for (const p of problemasGloss) {
console.log(` ${CORES.cinza}${p.path}: "${p.value}"${CORES.reset}`);
}
} else {
sucesso(`'${loc}': lib/data/${loc}/glossario.js validado sem strings vazadas.`);
}
+18 -1
View File
@@ -49,6 +49,12 @@ if [[ " $ENABLED_LOCALES " =~ " en " ]]; then
done
fi
if [[ " $ENABLED_LOCALES " =~ " es " ]]; then
for p in /series /catalogo /comparacion /componentes /diagnostico /frameworks /glosario /selector /acerca; do
status 200 "/es$p"
done
fi
# 2. Idiomas INATIVOS: redirecionam com 307 para o idioma fallback (en se ativo, senão pt)
for l in $ALL_LOCALES; do
if [[ ! " $ENABLED_LOCALES " =~ " $l " ]]; then
@@ -84,6 +90,9 @@ else
if [[ ! " $ENABLED_LOCALES " =~ " es " ]]; then
destino 307 / /en 'Accept-Language: es-MX,es;q=0.9'
destino 307 / /en 'Cookie: NEXT_LOCALE=es'
else
destino 307 / /es 'Accept-Language: es-MX,es;q=0.9'
destino 307 / /es 'Cookie: NEXT_LOCALE=es'
fi
if [[ ! " $ENABLED_LOCALES " =~ " fr " ]]; then
destino 307 / /en 'Accept-Language: fr-CA,fr;q=0.9'
@@ -121,8 +130,16 @@ if [[ " $ENABLED_LOCALES " =~ " en " ]]; then
case "$head_en" in *"$marca"*) ;; *) echo "FALHOU /en/about: $marca fora do <head>"; falhas=$((falhas + 1));; esac
done
# 7. Varredura estrita contra vazamento de português (texto visível e blocos ld+json) nas 36 rotas
# 7. Varredura estrita contra vazamento de português (texto visível e blocos ld+json) nas rotas inglesas e espanholas
python3 scripts/verifica-vazamentos.py "$base" || falhas=$((falhas + 1))
fi
if [[ " $ENABLED_LOCALES " =~ " es " ]]; then
html_es=$(curl -s -A 'Mozilla/5.0 Chrome/130' "$base/es/acerca")
head_es=${html_es%%</head>*}
for marca in '<title>' 'rel="canonical"'; do
case "$head_es" in *"$marca"*) ;; *) echo "FALHOU /es/acerca: $marca fora do <head>"; falhas=$((falhas + 1));; esac
done
fi
exit $((falhas > 0))
+54 -6
View File
@@ -41,10 +41,19 @@ pt_regex = re.compile(
re.I
)
# Regex estrito para vazamentos de português em páginas em espanhol
# Palavras/sufixos que existem em português mas são incorretos em espanhol
pt_in_es_regex = re.compile(
r"\b(não|você|para o|para a|com o|com a|são|também|então|pinagem|"
r"série|séries|livro|ção|ções|muito|já|estão|é um|é uma|"
r"pelo|pela|especificações|especificação|início|artigo)\b",
re.I
)
# Termos técnicos legítimos aceitos em links/IDs/nomes
TECHNICAL_EXEMPT_PATHS = {"@id", "@type", "@context", "url", "image", "logo", "sameAs"}
def check_jsonld(obj, path=""):
def check_jsonld(obj, path="", regex=pt_regex, is_es=False):
problems = []
if isinstance(obj, str):
key = path.split(".")[-1].split("[")[0]
@@ -53,14 +62,14 @@ def check_jsonld(obj, path=""):
if (path.endswith("@id") or path.endswith("url")) and ("#artigo" in obj or "#sobre" in obj):
problems.append((path, f"Anchor leak in {obj}"))
return problems
if pt_regex.search(obj):
if regex.search(obj):
problems.append((path, obj))
elif isinstance(obj, list):
for i, val in enumerate(obj):
problems.extend(check_jsonld(val, f"{path}[{i}]"))
problems.extend(check_jsonld(val, f"{path}[{i}]", regex, is_es))
elif isinstance(obj, dict):
for k, val in obj.items():
problems.extend(check_jsonld(val, f"{path}.{k}" if path else k))
problems.extend(check_jsonld(val, f"{path}.{k}" if path else k, regex, is_es))
return problems
falhas = 0
@@ -81,7 +90,7 @@ for u in urls:
for i, s in enumerate(scripts):
try:
data = json.loads(s)
issues = check_jsonld(data, f"script[{i}]")
issues = check_jsonld(data, f"script[{i}]", pt_regex, False)
for p, v in issues:
print(f" ✖ JSON-LD vazamento em {u} -> {p}: \"{v}\"")
falhas += 1
@@ -97,8 +106,47 @@ for u in urls:
print(f" ✖ Texto visível vazamento em {u}: \"{h[:120]}\"")
falhas += 1
# Varredura das rotas em espanhol
fixas_es = [
"/es", "/es/series", "/es/comparacion", "/es/diagnostico", "/es/selector",
"/es/frameworks", "/es/componentes", "/es/glosario", "/es/catalogo", "/es/acerca"
]
urls_es = fixas_es + [f"/es/series/{s}" for s in series] + [f"/es/frameworks/{f}" for f in frameworks]
print(f"\nESPDocs · Varredura de i18n nas 36 rotas em espanhol ({base})")
for u in urls_es:
try:
req = urllib.request.Request(base + u, headers={"User-Agent": "ESPDocs-SmokeTest/1.0"})
raw = urllib.request.urlopen(req, timeout=10).read().decode("utf-8")
except Exception as e:
print(f" ✖ ERRO ao acessar {u}: {e}")
falhas += 1
continue
# 1. Verifica blocos ld+json
scripts = re.findall(r"<script[^>]*type=[\"']application/ld\+json[\"'][^>]*>(.*?)</script>", raw, re.DOTALL)
for i, s in enumerate(scripts):
try:
data = json.loads(s)
issues = check_jsonld(data, f"script[{i}]", pt_in_es_regex, True)
for p, v in issues:
print(f" ✖ JSON-LD vazamento em {u} -> {p}: \"{v}\"")
falhas += 1
except Exception as e:
print(f" ✖ Erro no parse de JSON-LD em {u}: {e}")
falhas += 1
# 2. Verifica texto visível
clean = re.sub(r"<(script|style)[\s\S]*?</\1>", "", raw)
clean = html.unescape(re.sub(r"<[^>]+>", "\n", clean))
hits = [l.strip() for l in clean.split("\n") if l.strip() and pt_in_es_regex.search(l)]
for h in hits:
print(f" ✖ Texto visível vazamento em {u}: \"{h[:120]}\"")
falhas += 1
if falhas == 0:
print(f" ✔ Todas as {len(urls)} rotas em inglês verificadas com ZERO vazamentos (texto e JSON-LD).")
print(f" ✔ Todas as {len(urls)} rotas em inglês e {len(urls_es)} rotas em espanhol verificadas com ZERO vazamentos (texto e JSON-LD).")
sys.exit(0)
else:
print(f" ✖ Total de falhas detectadas: {falhas}")