[ pomoc ] · v1.0

Pomoc &
dokumentacja.

Wszystko czego potrzebujesz żeby zacząć: instrukcja, wideo, FAQ i kontakt do nas. Materiały zaktualizowane dla firmware v1.4.1.

01 · Start

Pierwsze uruchomienie.

01.

Naładuj

Podłącz dołączony kabel USB-C do kalkulatora i ładowarki ≥5V/1A. Pełne ładowanie ~3h. LED na płytce świeci podczas ładowania.
02.

Włącz

Przesuń przełącznik suwakowy na boku w pozycję ON. Po ~2s zobaczysz ekran powitalny i menu główne.
03.

Skonfiguruj WiFi

Ustawienia → WiFi → wybierz sieć z listy → wpisz hasło (klawiatura ekranowa). To wymagane do działania AI, sync notatek i OTA.
04.

Sparuj konto

Załóż konto na kalkmate.pl (potwierdź email), wpisz Device ID w panelu. Sparuje automatycznie. Bez tego — kalkulator działa w trybie offline (kalkulator, notatki/sprawdziany z poprzedniego sync).

Wideo: pierwsze uruchomienie (1:30)

/ WKRÓTCE

02 · Klawiatura

Nawigacja klawiszami.

Klawiatura ma 27 klawiszy w układzie 5×6. W menu/ustawieniach poruszasz się numpadem:

%
MU
MC
MR
M−
M+
÷
±
7
8
9
×
4
5
6
C/CE
1
2
3
+
0
00
.
=
■ NAWIGACJA■ PANIC■ STANDARD
8
W górę
2
W dół
4
W lewo
6
W prawo
5
OK / Zatwierdź
C/CE
Wstecz / Anuluj
MU
PANIC — natychmiastowy powrót do kalkulatora
W kalkulatorze: backspace

/ NOTKA

W trybie kalkulatora klawisze cyfr/operatorów działają normalnie (5 = piątka, 4 = czwórka itd.). Numpad jako nawigacja działa tylko w menu i ustawieniach.

.gif

GIF: nawigacja klawiaturą ekranową AI

/ WKRÓTCE

03 · Tryb AI

Rozwiązywanie zadań.

KalkMate wysyła Twoje zadanie do AI (model Gemini przez nasz serwer) i zwraca rozwiązanie krok po kroku. Działa dla matematyki, fizyki, chemii, biologii — poziom maturalny.

01.

Wpisz kod AI

W trybie kalkulatora wpisz 4 cyfry (domyślnie 1111) bez żadnej operacji między cyframi. Otworzy się menu AI.
02.

Wybierz tryb

Tekst — klawiatura ekranowa do wpisania treści zadania.
Historia — przeglądaj poprzednie rozwiązania (offline).
03.

Tryb rozwiązania

W Ustawienia → Tryb wybierz:
  • Szczegółowy — krok po kroku z wyjaśnieniami
  • Obliczenia — same wzory + przejścia
  • Wynik — sama odpowiedź końcowa
04.

Czytanie odpowiedzi

Strzałkami 8 / 2 (góra/dół) scrollujesz długie odpowiedzi. C/CE wraca do menu. Każda odpowiedź jest auto-zapisana w historii.
04 · Pamięć

Notatki i sprawdziany.

KalkMate trzyma do 50 notatek (60 KB)i 50 sprawdzianów (160 KB) offline — czytasz je nawet bez WiFi. Edytujesz na kalkmate.pl/panel.

01.

Dodaj na stronie

Wejdź kalkmate.pl/panel→ zakładka Notatki / Sprawdziany → dodaj treść (do 4000 znaków dla notatki, 30 000 dla sprawdzianu). LaTeX i markdown wspierane.
02.

Sync do kalkulatora

Na kalkulatorze: Menu → Notatki → klik strzałka w dół (sync). Wymaga WiFi. Pobiera wszystko z konta.
03.

Czytaj offline

Po sync są w pamięci flash kalkulatora — czytasz wszędzie. Format LaTeX automatycznie konwertowany do ASCII na ekranie OLED (∞ jako bitmap, ułamki jako `(a)/(b)`, itd.).
05 · Bateria

Ładowanie i bateria.

2000mAh

Pojemność (LiPo)

~3h

Pełne ładowanie

2–3dni

Typowe użycie

5–7dni

Stand-by

/ NOTKA

Najwięcej prądu zżera OLED przy 12V (przetwornica MT3608). Skróć autosleep do 1–2 minut żeby wydłużyć czas pracy 2–3×. Ustawienia → Sleep.

Ładowanie: USB-C (PD nie wymagany, każdy zasilacz ≥5V/1A). LED na płytce świeci podczas ładowania, gaśnie przy 100%. Bateria jest chroniona przed przeładowaniem (MCP73831 + DW01A).

06 · Aktualizacje

OTA — aktualizacje firmware.

01.

Sprawdź dostępność

Ustawienia → Aktualizacje → OK. Kalkulator pyta serwer, czy jest nowsza wersja niż twoja aktualna (widoczna jako v1.4.1 itp.).
02.

Zainstaluj

Jeśli jest nowa — pokazuje notes do zmian + przycisk Zainstaluj. Pobiera (~1 MB), flashuje partycję OTA, restartuje. ~1 minuta. Nie odłączaj zasilania podczas update'u.

/ NOTKA

Aktualizacje są darmowe i dobrowolne. Stary firmware będzie nadal działał, ale nowe feature'y (np. lepszy LaTeX) wymagają update'u.

/ AKTUALNA WERSJA SERWERA:

v1.4.1

Sprawdź swoją wersję w Ustawienia → Aktualizacje

07 · Problemy

Rozwiązywanie problemów.

/ PROBLEM

Ekran się nie włącza / czarny

/ FIX

1) Sprawdź switch (powinien być w pozycji ON). 2) Naładuj 30+ minut — bateria może być zerowa. 3) Jeśli LED ładowania nie świeci po podłączeniu USB-C — uszkodzony kabel/port.

/ PROBLEM

WiFi nie znajduje sieci / pusta lista

/ FIX

Ustawienia → WiFi → Skanuj. Jeśli pusto — w v0.6.4 dodaliśmy auto-reset radia. Spróbuj jeszcze raz po 5 sekundach. Niektóre sieci 5GHz nie są wspierane (ESP32 = 2.4GHz only).

/ PROBLEM

AI Chat: 'AI error 400' lub timeout

/ FIX

1) Sprawdź WiFi (Ustawienia → Status konta — pokaże 'Podłączone'). 2) Konto musi mieć aktywny trial lub subskrypcję. 3) Spróbuj krótszego zadania — limit ~2000 znaków.

/ PROBLEM

Niektóre klawisze nie reagują

/ FIX

Settings → Diagnostyka → Test klawiatury. Jeśli klawisz świeci się gdy wciskasz — działa OK (problem w innym miejscu). Jeśli nie świeci — fizyczny problem (zimna lutka, FFC). Pisz przez formularz.

/ PROBLEM

Notatki/sprawdziany nie syncują

/ FIX

1) WiFi musi działać. 2) Konto musi być sparowane (Settings → Status konta = 'Podłączone'). 3) Na kalkmate.pl/panel sprawdź czy są na koncie. 4) Jeśli za dużo (>50 sprawdzianów lub łącznie >160 KB) — kalkulator nie pobierze wszystkich.

/ PROBLEM

Boost MT3608 buczy / ekran ma paski

/ FIX

To problem sprzętowy z kondensatorami ceramicznymi (piezoelektrycznymi). Skontaktuj się przez formularz — wymienimy płytkę w gwarancji.

08 · FAQ

Często zadawane pytania.

09 · Changelog

Historia firmware.

Wszystkie wydane wersje. Update przez Ustawienia → Aktualizacje.

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

Napisz do nas.

Odpowiadam w ciągu 24h (zwykle szybciej). Możesz też napisać bezpośrednio na kontakt@kalkmate.pl.

0/5000