[ assistenza ] · v3.0

Assistenza &
documentazione.

Tutto ciò che ti serve per iniziare: manuale, video, FAQ e contatti. Contenuti aggiornati per il firmware v1.4.1.

01 · Avvio

Primo avvio.

01.

Caricala

Collega il cavo USB-C in dotazione alla calcolatrice e a un caricatore ≥5V/1A. La ricarica completa richiede ~2 h. Il LED sulla scheda si accende durante la ricarica.
02.

Accendila

Sposta l'interruttore laterale su ON. Dopo ~2 s vedrai la schermata di benvenuto KalkMate e poi la schermata della calcolatrice (display digitale).
03.

Apri il menu IA

Sulla tastiera della calcolatrice digita il codice di sblocco (predefinito 1111) — solo cifre, senza operatori in mezzo. Lo schermo mostra per un attimo „AI" e apre il menu principale. Solo ora sono disponibili Impostazioni e le altre funzioni.
04.

Configura il WiFi

Impostazioni → WiFi e account → Rete WiFi → scegli una rete dall'elenco → inserisci la password (tastiera su schermo). Necessario per l'IA, la sincronizzazione delle note e gli aggiornamenti OTA.
05.

Collega il tuo account

Crea un account su kalkmate.pl (conferma l'email). Sulla calcolatrice: Impostazioni → WiFi e account → ID disposit. + QR — si registra sul server e mostra un codice QR da scansionare. Conferma il collegamento nel pannello kalkmate.pl. Senza questo passaggio la calcolatrice funziona in modalità offline.

/ Video: primo avvio

02 · Tastiera

Navigazione con i tasti.

La tastiera ha 27 tasti disposti in 5×6. Nei menu e nelle impostazioni ti muovi con il tastierino numerico:

5 — OK / Conferma

■ NAVIGAZIONE■ PANIC■ STANDARD

/ NOTKA

In modalità calcolatrice i tasti delle cifre e degli operatori funzionano normalmente (5 = cinque, 4 = quattro, ecc.). Il tastierino numerico funge da navigazione solo nei menu e nelle impostazioni.

/ Navigazione nella tastiera su schermo dell'IA

03 · Modalità IA

Risolvere esercizi.

KalkMate invia il tuo esercizio all'IA (modello Gemini tramite il nostro server) e restituisce la soluzione passo per passo. Funziona per matematica, fisica, chimica e biologia.

01.

Inserisci il codice IA

In modalità calcolatrice digita le 4 cifre (predefinito 1111) senza alcuna operazione in mezzo. Si apre il menu IA.
02.

Scegli una modalità

[1] Foto camera — inquadra l'esercizio con la fotocamera. Anteprima dal vivo sullo schermo (indicatore di messa a fuoco a destra), premi 5 (OK) per scattare la foto e inviarla all'IA.

[2] Scrivi testo — tastiera QWERTY su schermo: 8/4/6/2 = navigazione, 5 = scegli carattere, conferma con il pulsante OK (max 2000 caratteri).


[3] Storico — consulta le soluzioni precedenti (offline). Il pulsante → (destra) apre la domanda per modificarla e reinviarla all'IA.
03.

Livello di dettaglio

In Impostazioni → Risoluzione → Modo soluzione scegli:
  • Dettagliato — passo per passo con spiegazioni
  • Solo calc. — solo formule + passaggi
  • Risultato — solo la risposta finale
04.

Leggere la risposta

Con 8 / 2 (su/giù) scorri le risposte lunghe. C/CE torna al menu. Ogni risposta viene salvata automaticamente nella cronologia.
04 · Memoria

Note e verifiche.

KalkMate conserva fino a 50 note (60 KB) e 50 verifiche (160 KB) offline — le leggi anche senza WiFi. Le modifichi su kalkmate.pl/panel.

01.

Aggiungile sul sito

Vai su kalkmate.pl/panel → scheda Note / Verifiche → aggiungi il contenuto (fino a 4000 caratteri per nota, 30 000 per verifica). Supporta LaTeX e markdown.
02.

Sincronizza con la calcolatrice

Sulla calcolatrice: Note → clicca la freccia giù (v = sync). Richiede il WiFi. Scarica tutto dal tuo account.
03.

Leggi offline

Dopo la sincronizzazione sono salvate nella memoria flash della calcolatrice — leggile ovunque. Il LaTeX viene convertito automaticamente in ASCII sullo schermo OLED (∞ come bitmap, frazioni come (a)/(b), ecc.).
05 · Batteria

Ricarica e batteria.

1500mAh

Capacità (LiPo)

~2h

Ricarica completa

2–3giorni

Uso tipico

5–7giorni

Standby

/ NOTKA

A consumare di più è l'OLED a 12V (convertitore boost MT3608). Riduci lo spegnimento automatico a 1–2 minuti per un'autonomia 2–3 volte maggiore. Impostazioni → Schermo → Sospensione.

Ricarica: USB-C (PD non necessario, va bene qualsiasi caricatore ≥5V/1A). Il LED sulla scheda si accende durante la ricarica e si spegne al 100%. La batteria è protetta dal sovraccarico (MCP73831 + DW01A).

06 · Aggiornamenti

OTA — aggiornamenti del firmware.

01.

Verifica la disponibilità

Impostazioni → Sistema → Aggiornamento → OK. La calcolatrice chiede al server se esiste una versione più recente della tua (mostrata come v1.4.1, ecc.).
02.

Installa

Se ce n'è una nuova, mostra l'elenco delle modifiche + il pulsante OK = installa. Scarica (~1 MB), scrive la partizione OTA e si riavvia. ~1 minuto. Non scollegare l'alimentazione durante l'aggiornamento.

/ NOTKA

Gli aggiornamenti sono gratuiti e facoltativi. Il vecchio firmware continuerà a funzionare, ma le nuove funzioni (ad es. un LaTeX migliore) richiedono l'aggiornamento.

/ VERSIONE ATTUALE SUL SERVER:

v1.4.1

Controlla la tua versione in Impostazioni → Sistema → Aggiornamento (oppure Impostazioni → Informazioni → Info disposit.).

07 · Problemi

Risoluzione dei problemi comuni.

/ PROBLEM

Lo schermo non si accende / resta nero

/ FIX

1) Controlla l'interruttore (deve essere su ON). 2) Ricarica per 30+ minuti — la batteria potrebbe essere completamente scarica. 3) Se il LED di ricarica non si accende collegando l'USB-C — il cavo/la porta è danneggiato.

/ PROBLEM

Il WiFi non trova reti / elenco vuoto

/ FIX

Impostazioni → WiFi e account → Rete WiFi → OK Cerca. Se resta vuoto — dalla v0.6.4 c'è un reset automatico della radio. Riprova dopo 5 secondi. Le reti a 5 GHz non sono supportate (ESP32 = solo 2,4 GHz).

/ PROBLEM

AI Chat: 'AI error 400' o timeout

/ FIX

1) Controlla il WiFi (Impostazioni → WiFi e account → Stato account — deve mostrare 'Stato: COLLEGATO'). 2) L'account deve avere token IA — controlla e ricarica il saldo nel pannello, scheda AI. 3) Prova un esercizio più breve — il limite è di ~2000 caratteri.

/ PROBLEM

Alcuni tasti non rispondono

/ FIX

Impostazioni → Diagnostica → Test tastiera. Se il tasto si illumina quando lo premi — funziona (il problema è altrove). Se non si illumina — è un guasto fisico (saldatura fredda, cavo FFC). Scrivici tramite il modulo.

/ PROBLEM

Le note/verifiche non si sincronizzano

/ FIX

1) Il WiFi deve funzionare. 2) L'account deve essere collegato (Impostazioni → WiFi e account → Stato account = 'Stato: COLLEGATO'). 3) Controlla su kalkmate.pl/panel che siano presenti nell'account. 4) Se i dati sono troppi (>50 verifiche o >160 KB in totale) — la calcolatrice non scaricherà tutto.

/ PROBLEM

Il convertitore MT3608 ronza / lo schermo ha delle righe

/ FIX

È un problema hardware dei condensatori ceramici (piezoelettrici). Contattaci tramite il modulo — sostituiremo la scheda in garanzia.

08 · FAQ

Domande frequenti.

09 · Changelog

Cronologia del firmware.

Tutte le versioni rilasciate. Aggiornamento tramite Impostazioni → Sistema → Aggiornamento.

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 · Contatti

Scrivici.

Rispondo entro 24 ore (di solito prima). Puoi anche scrivere direttamente a kontakt@kalkmate.pl — anche in inglese.

0/5000