[ ajuda ] · v3.0

Ajuda &
documentação.

Tudo o que precisa para começar: manual, vídeos, perguntas frequentes e contacto. Conteúdo atualizado para o firmware v1.4.1.

01 · Início

Primeira configuração.

01.

Carregue

Ligue o cabo USB-C incluído à calculadora e a um carregador de ≥5V/1A. O carregamento completo demora ~2 h. O LED da placa acende durante o carregamento.
02.

Ligue

Deslize o interruptor lateral para ON. Após ~2 s verá o ecrã de boas-vindas KalkMate e depois o ecrã da calculadora (visor digital).
03.

Abra o menu de IA

No teclado da calculadora, escreva o código de desbloqueio (predefinido 1111) — apenas dígitos, sem operadores entre eles. O ecrã mostra brevemente „AI" e abre o menu principal. Só então ficam disponíveis Definicoes e as restantes funções.
04.

Configure o WiFi

Definicoes → WiFi e conta → Rede WiFi → escolha uma rede da lista → introduza a palavra-passe (teclado no ecrã). Necessário para a IA, a sincronização de notas e as atualizações OTA.
05.

Associe a sua conta

Crie uma conta em kalkmate.pl (confirme o email). Na calculadora: Definicoes → WiFi e conta → ID aparelho + QR — regista-se no servidor e mostra um código QR para digitalizar. Confirme a associação no painel kalkmate.pl. Sem isto, a calculadora funciona em modo offline.

/ Vídeo: primeira configuração

02 · Teclado

Navegação com as teclas.

O teclado tem 27 teclas numa disposição 5×6. Nos menus e definições navega com o teclado numérico:

5 — OK / Confirmar

■ NAVEGAÇÃO■ PANIC■ PADRÃO

/ NOTKA

No modo calculadora as teclas de dígitos e operadores funcionam normalmente (5 = cinco, 4 = quatro, etc.). O teclado numérico só funciona como navegação nos menus e definições.

/ Navegação no teclado de ecrã da IA

03 · Modo IA

Resolver exercícios.

O KalkMate envia o seu exercício para a IA (modelo Gemini através do nosso servidor) e devolve a resolução passo a passo. Funciona para matemática, física, química e biologia.

01.

Introduza o código de IA

No modo calculadora, escreva os 4 dígitos (predefinido 1111) sem nenhuma operação entre eles. Abre-se o menu de IA.
02.

Escolha um modo

[1] Foto camara — aponte a câmara ao exercício. Pré-visualização em direto no ecrã (indicador de focagem à direita), prima 5 (OK) para tirar a foto e enviá-la para a IA.

[2] Escrever texto — teclado QWERTY no ecrã: 8/4/6/2 = navegar, 5 = escolher carácter, confirme com o botão OK (máx. 2000 caracteres).


[3] Historico — consulte resoluções anteriores (offline). O botão → (direita) abre a pergunta para editar e reenviar para a IA.
03.

Nível de detalhe

Em Definicoes → Resolucao → Modo resolucao escolha:
  • Detalhado — passo a passo com explicações
  • So calculo — só fórmulas + passos
  • Resultado — só a resposta final
04.

Ler a resposta

Com 8 / 2 (cima/baixo) percorre respostas longas. C/CE volta ao menu. Cada resposta é guardada automaticamente no histórico.
04 · Memória

Notas e testes.

O KalkMate guarda até 50 notas (60 KB) e 50 testes (160 KB) offline — pode lê-los mesmo sem WiFi. Edita-os em kalkmate.pl/panel.

01.

Adicione no site

Aceda a kalkmate.pl/panel → separador Notas / Testes → adicione o conteúdo (até 4000 caracteres por nota, 30 000 por teste). Suporta LaTeX e markdown.
02.

Sincronize com a calculadora

Na calculadora: Notas → clique na seta para baixo (v = sync). Requer WiFi. Transfere tudo da sua conta.
03.

Leia offline

Depois de sincronizados, ficam na memória flash da calculadora — leia-os em qualquer lugar. O LaTeX é convertido automaticamente em ASCII no ecrã OLED (∞ como bitmap, frações como (a)/(b), etc.).
05 · Bateria

Carregamento e bateria.

1500mAh

Capacidade (LiPo)

~2h

Carregamento completo

2–3dias

Utilização típica

5–7dias

Em espera

/ NOTKA

O que mais consome é o OLED a 12V (conversor elevador MT3608). Reduza a suspensão automática para 1–2 minutos e a autonomia aumenta 2–3×. Definicoes → Ecra → Suspensao.

Carregamento: USB-C (não requer PD, serve qualquer carregador de ≥5V/1A). O LED da placa acende durante o carregamento e apaga aos 100 %. A bateria está protegida contra sobrecarga (MCP73831 + DW01A).

06 · Atualizações

OTA — atualizações de firmware.

01.

Verifique se há atualizações

Definicoes → Sistema → Atualizacao → OK. A calculadora pergunta ao servidor se existe uma versão mais recente do que a sua (mostrada como v1.4.1, etc.).
02.

Instale

Se houver uma nova — mostra a lista de alterações + o botão OK = instalar. Transfere (~1 MB), grava a partição OTA e reinicia. ~1 minuto. Não desligue a alimentação durante a atualização.

/ NOTKA

As atualizações são gratuitas e opcionais. O firmware antigo continua a funcionar, mas as novas funções (p. ex. melhor LaTeX) exigem a atualização.

/ VERSÃO ATUAL NO SERVIDOR:

v1.4.1

Veja a sua versão em Definicoes → Sistema → Atualizacao (ou Definicoes → Informacao → Sobre aparelho).

07 · Problemas

Resolução de problemas comuns.

/ PROBLEM

O ecrã não liga / fica preto

/ FIX

1) Verifique o interruptor (deve estar em ON). 2) Carregue 30+ minutos — a bateria pode estar totalmente descarregada. 3) Se o LED de carregamento não acender ao ligar o USB-C — o cabo/porta está danificado.

/ PROBLEM

O WiFi não encontra redes / lista vazia

/ FIX

Definicoes → WiFi e conta → Rede WiFi → OK Procurar. Se continuar vazia — desde a v0.6.4 existe um reinício automático do rádio. Tente novamente após 5 segundos. As redes de 5 GHz não são suportadas (ESP32 = apenas 2,4 GHz).

/ PROBLEM

AI Chat: 'AI error 400' ou tempo esgotado

/ FIX

1) Verifique o WiFi (Definicoes → WiFi e conta → Estado da conta — deve mostrar 'Estado: ASSOCIADO'). 2) A conta precisa de tokens de IA — consulte e carregue o saldo no painel, no separador AI. 3) Experimente um exercício mais curto — o limite é ~2000 caracteres.

/ PROBLEM

Algumas teclas não respondem

/ FIX

Definicoes → Diagnostico → Teste teclado. Se a tecla acender quando a prime — funciona (o problema está noutro lado). Se não acender — é uma avaria física (soldadura fria, cabo FFC). Contacte-nos através do formulário.

/ PROBLEM

As notas/testes não sincronizam

/ FIX

1) O WiFi tem de funcionar. 2) A conta tem de estar associada (Definicoes → WiFi e conta → Estado da conta = 'Estado: ASSOCIADO'). 3) Verifique em kalkmate.pl/panel se estão na sua conta. 4) Se houver dados a mais (>50 testes ou >160 KB no total) — a calculadora não transfere tudo.

/ PROBLEM

O conversor MT3608 zumbe / o ecrã tem riscas

/ FIX

É um problema de hardware com os condensadores cerâmicos (piezoelétricos). Contacte-nos através do formulário — substituímos a placa ao abrigo da garantia.

08 · FAQ

Perguntas frequentes.

09 · Changelog

Histórico do firmware.

Todas as versões publicadas. Atualize em Definicoes → Sistema → Atualizacao.

v1.4.1 ·2026-05-28Bezpieczeństwo: Signed OTA (ECDSA P-256) + obfuskacja API key w binarce — chronione przed wstrzyknięciem firmware i strings extraction
v1.4.0 2026-05-28Bezpieczeństwo: OTA wymaga autoryzacji (x-api-key + zarejestrowany device-id), pliki .bin poza public/
v1.3.9 2026-05-28Kamera: test rotacji — tylko vflip + Serial log z aktualną konfiguracją
v1.3.8 2026-05-28Kamera: hmirror+vflip dla rotacji 180° (sensor zamontowany do góry nogami)
v1.3.7 2026-05-28Kamera OV2640: AEC/AGC/AWB włączone + gamma/lens correction + 5-klatkowy warm-up (fix prześwietlenia + zielonego tintu)
v1.3.6 2026-05-28Polskie znaki UTF-8 → ASCII w odpowiedziach AI + błędach (wzorzec z tests.h)
v1.3.5 2026-05-28Auto-sync licencji z serwera do NVS (fix dla x-license-key 403)
v1.3.4 2026-05-28Kamera UXGA 1600×1200 (max sensora 2MP) + auto-WiFi po AI menu z 3s delay
v1.3.3 2026-05-28Solve_screen: camBegin → capture → camEnd przed WiFi (anty-XCLK interference)
v1.3.2 2026-05-28Wspólny bus I2C dla MCP23017 + OV2640 SCCB (fix Error 263)
v1.3.1 2026-05-28Kamera: CAMERA_GRAB_WHEN_EMPTY + fb_count=1 (fix freeze ekranu testu)
v1.3.0 2026-05-28Kamera OV2640 — realny test w Settings + pełna persistencja ustawień w NVS
v1.2.0 2026-05-27Production release PCB v4: kontrast 60, VBAT watchdog, early-battery splash
v1.1.5 2026-05-27Niski kontrast OLED (anty-brownout na batery LiPo) + VBAT watchdog co 2s
v1.1.4 2026-05-27Diagnostic markery wokół powrotu z runCalculator dla logowania crashy
v1.1.3 2026-05-27Wyłączenie auto-WiFi przy boot (peak prądu psuł LiPo)
v1.1.2 2026-05-27Early battery check + splash NISKA BATERIA przed boost EN
v1.1.1 2026-05-27Lazy WiFi init z 2s opóźnieniem po menu (anty-brownout)
v1.1.0 2026-05-27Pomiar baterii LiPo + ikonka + auto-shutdown + ekran w Ustawieniach + charging detect
v1.0.0 2026-05-26Migracja na PCB v4 (ESP32-S3-WROOM-1-N16R8 + native USB-C)
v0.6.8 2026-05-18Reset fabryczny w Settings (NVS + SPIFFS + restart)
v0.6.7 2026-05-15Streaming HTTP do PSRAM — fix przy 28+ sprawdzianach
v0.6.6 2026-05-15Streaming JSON do SPIFFS + polskie znaki w tytułach
v0.6.5 2026-05-15Cache tytułów sprawdzianów — eliminuje lagi listy
v0.6.4 2026-05-15WiFi scan: reset radia przed skanem (fix dla niedostępnej zapisanej sieci)
v0.6.3 2026-05-15LaTeX: sqrt[n], overrightarrow, środowiska cases/bmatrix
v0.6.2 2026-05-15LaTeX stripper: greckie, zbiory, logika, strzałki, mathbb, vec
v0.6.1 2026-05-15Funkcje matematyczne LaTeX (log, ln, sin, cos itd.)
v0.6.0 2026-05-15GPA7 OUTPUT HIGH przy boot — MT3608 EN nie floatuje
v0.5.8 2026-05-09Settings — reorganizacja (Preferencje/Konto/System/Diagnostyka)
v0.5.4 2026-05-08JSON-aware parser dla notes/tests (fix dla LaTeX z [ { } ])
v0.5.0 2026-05-07Parowanie deviceId + unlockCode, Status konta w Settings
v0.4.9 2026-05-08Nowy keyboard mapping po przelutowaniu klawiatury
v0.4.7 2026-05-06Mapowanie klawiatury — kreator z zapisem do NVS
v0.4.6 2026-05-06Pin Driver Test — diagnostyka MCP23017
v0.4.0 2026-04-30Notatki + Sprawdziany przez WiFi sync
v0.3.0 2026-04-25Tryb AI: zdjęcie / tekst / historia
v0.2.0 2026-04-20OTA update przez HTTPS
v0.1.0 2026-04-15Pierwsza działająca wersja: kalkulator + WiFi
10 · Contacto

Escreva-nos.

Respondo em 24 h (normalmente mais depressa). Também pode escrever diretamente para kontakt@kalkmate.pl — em inglês, se preferir.

0/5000