/** * Conhecimento de domínio da busca inteligente. * * Sem dependências nem alias de import: roda no servidor (montando o índice), * no navegador (interpretando a consulta) e em scripts de teste no Node. * * Todos os textos de `termos` já estão normalizados (minúsculos, sem acento). */ export const normalizar = (s = "") => String(s) .toLowerCase() .normalize("NFD") .replace(/[\u0300-\u036f]/g, ""); /** * Reconhece pinos ocupados por flash/PSRAM com base no que o diagrama diz. * "forte": o pino é consumido pela memória (ou é a alimentação dela). * "fraco": só é afetado em certos modos (ex.: SPI de 8 linhas/octal). * Avisos genéricos de tensão mínima ("para chips com flash integrada...") não contam. */ const nivelMemoria = (palavra) => (p) => { const citam = p._avs.filter((a) => a.includes(palavra) && !/^para chips (com|sem)/.test(a)); if (citam.some((a) => /(utilizad|dedicad|conectad)/.test(a) && !/a menos que/.test(a))) return "forte"; if (p._fn.some((f) => /alimentacao/.test(f) && f.includes(palavra))) return "forte"; if (citam.length) return "fraco"; return null; }; /** * Assuntos que o usuário pode citar. Cada um sabe: * - termos: como as pessoas escrevem (sinônimos, siglas, plurais comuns); * - pinoCats / pinoRe: como reconhecer os pinos relacionados no diagrama; * - pinoRotulo: frase usada no título do resultado de pinos. * Os dados de especificação ligam-se aos assuntos por SPEC_CAMPOS. */ export const TOPICOS = [ { id: "flash", nome: "Flash", termos: ["flash", "memoria flash", "spi flash", "armazenamento", "firmware", "rom externa"], pinoNivel: nivelMemoria("flash"), pinoRotulo: "connected to flash memory" }, { id: "psram", nome: "PSRAM", termos: ["psram", "ram externa", "spiram"], pinoNivel: nivelMemoria("psram"), pinoRotulo: "connected to PSRAM" }, { id: "memoria", nome: "Memory", termos: ["memoria", "sram", "heap", "rtc ram", "kb de ram", "memoria interna", "ram", "memory"], pinoRotulo: "" }, { id: "wifi", nome: "Wi-Fi", termos: ["wifi", "wi-fi", "wireless", "sem fio", "802.11", "wifi6", "wifi 6", "wi-fi 6"], pinoCats: ["Antena"], pinoRotulo: "antenna and radio pins" }, { id: "bluetooth", nome: "Bluetooth", termos: ["bluetooth", "ble", "bt", "bluetooth le", "mesh"], pinoCats: ["Antena"], pinoRotulo: "antenna and radio pins" }, { id: "zigbee", nome: "Zigbee/Thread", termos: ["zigbee", "thread", "802.15.4", "ieee 802.15.4"], pinoRotulo: "" }, { id: "matter", nome: "Matter", termos: ["matter", "casa inteligente", "smart home"], pinoRotulo: "" }, { id: "ethernet", nome: "Ethernet", termos: ["ethernet", "rmii", "cabo de rede", "lan"], pinoCats: ["Ethernet"], pinoRotulo: "Ethernet pins" }, { id: "can", nome: "CAN / TWAI", termos: ["can", "twai", "can bus", "canbus", "can fd"], pinoRe: /twai|\bcan\b/, pinoRotulo: "CAN/TWAI pins" }, { id: "usb", nome: "USB", termos: ["usb", "otg", "usb serial", "usb otg", "hid", "cdc"], pinoCats: ["USB"], pinoRotulo: "USB pins" }, { id: "jtag", nome: "JTAG / Debug", termos: ["jtag", "debug", "depuracao", "depurar", "openocd", "gdb"], pinoCats: ["JTAG"], pinoRotulo: "JTAG pins" }, { id: "adc", nome: "ADC", termos: ["adc", "analogico", "entrada analogica", "conversor analogico", "analogread", "saradc", "analog"], pinoCats: ["ADC"], pinoRotulo: "with ADC" }, { id: "dac", nome: "DAC", termos: ["dac", "saida analogica", "conversor digital"], pinoCats: ["DAC"], pinoRotulo: "with DAC" }, { id: "touch", nome: "Capacitive Touch", termos: ["touch", "capacitivo", "toque", "touchpad", "sensor de toque"], pinoCats: ["Touch"], pinoRotulo: "capacitive touch pins" }, { id: "uart", nome: "UART", termos: ["uart", "serial", "tx", "rx", "txd", "rxd", "porta serial"], pinoCats: ["UART"], pinoRotulo: "UART pins" }, { id: "spi", nome: "SPI", termos: ["spi", "mosi", "miso", "sclk", "barramento spi"], pinoCats: ["SPI"], pinoRotulo: "SPI pins" }, { id: "i2c", nome: "I2C", termos: ["i2c", "sda", "scl", "twi", "iic"], pinoCats: ["I2C"], pinoRotulo: "I2C pins" }, { id: "i2s", nome: "I2S", termos: ["i2s", "audio", "som", "microfone", "pdm", "codec"], pinoRe: /i2s|\bpdm\b/, pinoRotulo: "I2S / audio pins" }, { id: "pwm", nome: "PWM", termos: ["pwm", "ledc", "mcpwm", "servo", "dimmer"], pinoRe: /ledc|pwm/, pinoRotulo: "PWM pins" }, { id: "sd", nome: "SD Card / SDIO", termos: ["sd", "sdio", "sd card", "sdcard", "cartao sd", "microsd", "sdmmc", "mmc"], pinoCats: ["SD"], pinoRe: /sdio|sdmmc|\bsd\b/, pinoRotulo: "SD Card / SDIO pins" }, { id: "camera", nome: "Camera", termos: ["camera", "cam", "dvp", "csi", "mipi csi", "ov2640", "video"], pinoCats: ["CSI"], pinoRe: /\bcam\b|dvp|cam_/, pinoRotulo: "camera pins" }, { id: "lcd", nome: "Display / LCD", termos: ["lcd", "display", "tela", "dsi", "mipi dsi", "oled", "tft", "lvgl", "rgb"], pinoCats: ["DSI"], pinoRe: /lcd/, pinoRotulo: "display/LCD pins" }, { id: "strapping", nome: "Boot / Strapping", termos: ["strapping", "boot", "bootstrap", "modo de boot", "download mode", "modo de gravacao", "inicializacao"], pinoCats: ["Strapping"], pinoRotulo: "strapping (boot mode) pins" }, { id: "energia_pinos", nome: "Power", termos: ["alimentacao", "vdd", "3v3", "3.3v", "tensao", "regulador", "ldo", "fonte", "power"], pinoCats: ["Power"], pinoRotulo: "power pins" }, { id: "clock", nome: "Clock / Crystal", termos: ["clock", "xtal", "cristal", "oscilador", "32khz", "40mhz", "crystal"], pinoCats: ["Clock"], pinoRotulo: "clock/crystal pins" }, { id: "gpio", nome: "GPIO", termos: ["gpio", "entradas e saidas"], pinoCats: ["GPIO"], pinoRotulo: "GPIO pins" }, { id: "baixo_consumo", nome: "Low Power / ULP", termos: ["ulp", "lp core", "lp cpu", "coprocessador", "lp gpio", "low power", "rtc gpio"], pinoCats: ["Low Power"], pinoRotulo: "low-power (LP/RTC) pins" }, { id: "antena", nome: "Antenna / RF", termos: ["antena", "rf", "radiofrequencia", "ipex", "antenna"], pinoCats: ["Antena"], pinoRotulo: "antenna/RF pins" }, { id: "seguranca", nome: "Security", termos: ["seguranca", "secure boot", "criptografia", "encriptacao", "aes", "sha", "rsa", "hmac", "ecdsa", "efuse", "tee", "trng", "rng", "hsm", "protecao", "security"], pinoRotulo: "" }, { id: "consumo", nome: "Power Consumption", termos: ["consumo", "bateria", "deep sleep", "light sleep", "sleep", "modem sleep", "corrente", "miliamperes", "autonomia", "economia de energia", "low power mode", "power consumption"], pinoRotulo: "" }, { id: "temperatura", nome: "Temperature", termos: ["temperatura", "calor", "graus", "faixa de temperatura", "industrial", "temperature"], pinoRotulo: "" }, { id: "ia", nome: "AI / Acceleration", termos: ["ia", "ai", "machine learning", "ml", "tinyml", "vetorial", "inteligencia artificial", "rede neural", "esp-nn", "esp-dl"], pinoRotulo: "" }, { id: "processador", nome: "Processor", termos: ["processador", "cpu", "nucleo", "nucleos", "core", "dual core", "single core", "arquitetura", "xtensa", "risc-v", "riscv", "processor"], pinoRotulo: "" }, { id: "frequencia", nome: "Frequency", termos: ["frequencia", "mhz", "velocidade", "desempenho", "performance", "frequency"], pinoRotulo: "" }, { id: "ferramentas", nome: "Tools / SDK", termos: ["esp-idf", "idf", "arduino", "sdk", "toolchain", "versao do idf", "tools"], pinoRotulo: "" }, { id: "encapsulamento", nome: "Modules & Packaging", termos: ["modulo", "modulos", "encapsulamento", "package", "qfn", "wroom", "wrover", "mini-1", "modules"], pinoRotulo: "" }, ]; /** * Campos de public/series.json que respondem a cada assunto. * `campo` aceita caminho com ponto (seguranca.aes). `secao` é o id da âncora * na página /series/[key]. */ export const SPEC_CAMPOS = [ { campo: "arquitetura", label: "Architecture", secao: "processador", topicos: ["processador"] }, { campo: "nucleos", label: "Cores", secao: "processador", topicos: ["processador"] }, { campo: "frequencia", label: "Frequency", secao: "processador", topicos: ["frequencia", "processador"] }, { campo: "coprocessador_ulp", label: "ULP Coprocessor", secao: "processador", topicos: ["baixo_consumo"] }, { campo: "aceleradores_ia", label: "AI Accelerators", 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: "RTC SRAM", secao: "memoria", topicos: ["memoria", "baixo_consumo"] }, { campo: "memoria_rom", label: "ROM", secao: "memoria", topicos: ["memoria"] }, { campo: "flash_externa", label: "External Flash", secao: "memoria", topicos: ["flash", "memoria"] }, { campo: "psram_externa", label: "External PSRAM", 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: "Touch", 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: "Camera", 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: "Temperature Sensor", 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: "Digital Signature", secao: "seguranca", topicos: ["seguranca"] }, { campo: "seguranca.rng", label: "Random Number Generator", secao: "seguranca", topicos: ["seguranca"] }, { campo: "seguranca.criptografia_flash", label: "Flash Encryption", secao: "seguranca", topicos: ["seguranca", "flash"] }, { campo: "seguranca.secure_boot", label: "Secure Boot", secao: "seguranca", topicos: ["seguranca", "strapping"] }, { campo: "temperatura_operacao", label: "Operating Temperature", secao: "temperatura", topicos: ["temperatura"] }, { campo: "temperatura_armazenamento", label: "Storage Temperature", secao: "temperatura", topicos: ["temperatura"] }, { campo: "esp_idf_minimo", label: "Minimum ESP-IDF", secao: "ferramentas", topicos: ["ferramentas"] }, { campo: "arduino_core", label: "Arduino Core", secao: "ferramentas", topicos: ["ferramentas"] }, { campo: "depuracao", label: "Debugging", secao: "ferramentas", topicos: ["jtag", "ferramentas"] }, { campo: "encapsulamento", label: "Package", secao: "ferramentas", topicos: ["encapsulamento"] }, { campo: "modulos", label: "Modules", secao: "ferramentas", topicos: ["encapsulamento"] }, ]; const ROTULOS_ENERGIA = { active: "Active", modem_sleep: "Modem Sleep", light_sleep: "Light Sleep", deep_sleep: "Deep Sleep", hibernation: "Hibernation", }; const pegar = (obj, caminho) => caminho.split(".").reduce((o, k) => (o == null ? o : o[k]), obj); /** * Monta, para cada série, a lista plana de especificações (com os assuntos a * que respondem) e os pinos do diagrama. É o que o navegador baixa. * * @param {Record} series conteúdo de public/series.json * @param {Record} conexoes pinos por série (public/conexoes) */ 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: `Power: ${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; }