[ nápověda ] · v3.0

Nápověda &
dokumentace.

Vše, co potřebuješ na začátek: návod, videa, FAQ a kontakt na nás. Obsah aktualizován pro firmware v1.4.1.

01 · Start

První spuštění.

01.

Nabij ji

Připoj přiložený kabel USB-C ke kalkulačce a k nabíječce ≥5V/1A. Plné nabití trvá ~2 h. LED na desce během nabíjení svítí.
02.

Zapni ji

Posuň přepínač na boku do polohy ON. Asi po 2 s uvidíš úvodní obrazovku KalkMate a potom obrazovku kalkulačky (digitální displej).
03.

Otevři menu AI

Na klávesnici kalkulačky zadej odemykací kód (výchozí 1111) — jen číslice, bez operátorů mezi nimi. Displej na chvíli ukáže „AI" a otevře hlavní menu. Teprve teď jsou dostupná Nastaveni a další funkce.
04.

Nastav WiFi

Nastaveni → WiFi a ucet → Sit WiFi → vyber síť ze seznamu → zadej heslo (klávesnice na displeji). Nutné pro AI, synchronizaci poznámek a OTA aktualizace.
05.

Spáruj účet

Založ si účet na kalkmate.pl (potvrď e-mail). Na kalkulačce: Nastaveni → WiFi a ucet → ID zarizeni + QR — zaregistruje se na serveru a zobrazí QR kód ke skenování. Spárování potvrď v panelu kalkmate.pl. Bez toho kalkulačka běží v offline režimu.

/ Video: první spuštění

02 · Klávesnice

Ovládání klávesami.

Klávesnice má 27 kláves v rozložení 5×6. V menu a nastavení se pohybuješ numerickou klávesnicí:

5 — OK / Potvrdit

■ NAVIGACE■ PANIC■ STANDARD

/ NOTKA

V režimu kalkulačky fungují číslice a operátory normálně (5 = pětka, 4 = čtyřka atd.). Jako navigace slouží numerická klávesnice jen v menu a nastavení.

/ Ovládání AI klávesnice na displeji

03 · Režim AI

Řešení úloh.

KalkMate pošle tvou úlohu AI (model Gemini přes náš server) a vrátí řešení krok za krokem. Funguje pro matematiku, fyziku, chemii a biologii.

01.

Zadej AI kód

V režimu kalkulačky zadej 4 číslice (výchozí 1111) bez jakékoli operace mezi nimi. Otevře se menu AI.
02.

Vyber režim

[1] Foto kamerou — namiř kameru na úlohu. Živý náhled na displeji (ukazatel ostrosti vpravo), stiskni 5 (OK) a fotka se pošle AI.

[2] Zadat text — QWERTY klávesnice na displeji: 8/4/6/2 = navigace, 5 = vybrat znak, potvrď tlačítkem OK (max. 2000 znaků).


[3] Historie — procházej předchozí řešení (offline). Tlačítko → (doprava) otevře otázku k úpravě a novému odeslání AI.
03.

Podrobnost řešení

V Nastaveni → Reseni uloh → Rezim reseni zvol:
  • Podrobny — krok za krokem s vysvětlením
  • Jen vypocet — jen vzorce + kroky
  • Vysledek — pouze konečná odpověď
04.

Čtení odpovědi

Šipkami 8 / 2 (nahoru/dolů) posouváš dlouhé odpovědi. C/CE vrací do menu. Každá odpověď se automaticky uloží do historie.
04 · Paměť

Poznámky a testy.

KalkMate uloží až 50 poznámek (60 KB) a 50 testů (160 KB) offline — přečteš si je i bez WiFi. Upravuješ je na kalkmate.pl/panel.

01.

Přidej je na webu

Jdi na kalkmate.pl/panel → záložka Poznámky / Testy → přidej obsah (až 4000 znaků u poznámky, 30 000 u testu). Podporuje LaTeX i markdown.
02.

Synchronizace do kalkulačky

Na kalkulačce: Poznamky → klikni na šipku dolů (v = sync). Vyžaduje WiFi. Stáhne vše z tvého účtu.
03.

Čti offline

Po synchronizaci jsou uložené ve flash paměti kalkulačky — čteš je kdekoli. LaTeX se na OLED displeji automaticky převádí na ASCII (∞ jako bitmapa, zlomky jako (a)/(b) atd.).
05 · Baterie

Nabíjení a baterie.

1500mAh

Kapacita (LiPo)

~2h

Plné nabití

2–3dny

Běžné použití

5–7dní

Pohotovostní režim

/ NOTKA

Nejvíc energie spotřebuje OLED na 12V (měnič MT3608). Zkrať automatický spánek na 1–2 minuty a výdrž se prodlouží 2–3×. Nastaveni → Displej → Uspani.

Nabíjení: USB-C (PD není potřeba, stačí libovolná nabíječka ≥5V/1A). LED na desce při nabíjení svítí a při 100 % zhasne. Baterie je chráněna proti přebití (MCP73831 + DW01A).

06 · Aktualizace

OTA — aktualizace firmwaru.

01.

Zkontroluj dostupnost

Nastaveni → System → Aktualizace → OK. Kalkulačka se zeptá serveru, jestli existuje novější verze než tvoje aktuální (zobrazená jako v1.4.1 apod.).
02.

Nainstaluj

Pokud je nová — ukáže seznam změn + tlačítko OK = instalovat. Stáhne (~1 MB), nahraje do OTA oddílu a restartuje. Trvá ~1 minutu. Během aktualizace neodpojuj napájení.

/ NOTKA

Aktualizace jsou zdarma a dobrovolné. Starý firmware bude dál fungovat, ale nové funkce (např. lepší LaTeX) aktualizaci vyžadují.

/ AKTUÁLNÍ VERZE NA SERVERU:

v1.4.1

Svou verzi zjistíš v Nastaveni → System → Aktualizace (nebo Nastaveni → Informace → O zarizeni).

07 · Problémy

Řešení běžných problémů.

/ PROBLEM

Displej se nezapne / zůstává černý

/ FIX

1) Zkontroluj přepínač (má být v poloze ON). 2) Nabíjej 30+ minut — baterie může být úplně vybitá. 3) Pokud LED nabíjení po připojení USB-C nesvítí — je poškozený kabel/port.

/ PROBLEM

WiFi nenachází sítě / prázdný seznam

/ FIX

Nastaveni → WiFi a ucet → Sit WiFi → OK Hledat. Pokud je prázdný — od v0.6.4 jsme přidali automatický reset rádia. Zkus to znovu po 5 sekundách. Sítě 5 GHz nejsou podporovány (ESP32 = jen 2,4 GHz).

/ PROBLEM

AI Chat: 'AI error 400' nebo timeout

/ FIX

1) Zkontroluj WiFi (Nastaveni → WiFi a ucet → Stav uctu — má ukazovat 'Stav: PROPOJENO'). 2) Účet musí mít AI tokeny — zůstatek zkontroluješ a dobiješ v panelu, v záložce AI. 3) Zkus kratší úlohu — limit je ~2000 znaků.

/ PROBLEM

Některé klávesy nereagují

/ FIX

Nastaveni → Diagnostika → Test klavesnice. Pokud se klávesa při stisku rozsvítí — funguje (problém je jinde). Pokud ne — jde o fyzickou závadu (studený spoj, kabel FFC). Napiš nám přes formulář.

/ PROBLEM

Poznámky/testy se nesynchronizují

/ FIX

1) WiFi musí fungovat. 2) Účet musí být spárovaný (Nastaveni → WiFi a ucet → Stav uctu = 'Stav: PROPOJENO'). 3) Na kalkmate.pl/panel zkontroluj, že je máš v účtu. 4) Pokud je dat moc (>50 testů nebo celkem >160 KB) — kalkulačka nestáhne vše.

/ PROBLEM

Měnič MT3608 bzučí / displej má pruhy

/ FIX

Jde o hardwarový problém s keramickými (piezoelektrickými) kondenzátory. Ozvi se přes formulář — v rámci záruky desku vyměníme.

08 · FAQ

Časté dotazy.

09 · Changelog

Historie firmwaru.

Všechny vydané verze. Aktualizace přes Nastaveni → System → Aktualizace.

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

Napiš nám.

Odpovídám do 24 hodin (obvykle rychleji). Můžeš psát i přímo na kontakt@kalkmate.pl — klidně anglicky.

0/5000