KalkMate
Панэль

[ дапамога ] · v3.0

Дапамога &
дакументацыя.

Усё, што трэба для пачатку: інструкцыя, відэа, FAQ і кантакт з намі. Матэрыялы абноўлены для прашыўкі v1.4.1.

01 · Старт

Першы запуск.

01.

Зарадзіце

Падключыце кабель USB-C з камплекта да калькулятара і зараднай прылады ≥5V/1A. Поўная зарадка займае ~2 г. Падчас зарадкі свеціцца святлодыёд на плаце.
02.

Уключыце

Перавядзіце перамыкач збоку ў становішча ON. Праз ~2 с вы ўбачыце экран прывітання KalkMate, а потым экран калькулятара (лічбавы дысплэй).
03.

Адкрыйце меню AI

На клавіятуры калькулятара ўвядзіце код разблакіроўкі (па змаўчанні 1111) — толькі лічбы, без аперацый паміж імі. Экран на імгненне пакажа „AI" і адкрые галоўнае меню. Толькі цяпер даступныя Nalady і іншыя функцыі.
04.

Наладзьце WiFi

Nalady → WiFi i akaunt → Sietka WiFi → выберыце сетку са спіса → увядзіце пароль (экранная клавіятура). Патрэбна для AI, сінхранізацыі нататак і OTA-абнаўленняў.
05.

Звяжыце ўліковы запіс

Стварыце ўліковы запіс на kalkmate.pl (пацвердзіце email). На калькулятары: Nalady → WiFi i akaunt → ID prylady + QR — ён зарэгіструецца на серверы і пакажа QR-код для сканавання. Пацвердзіце прывязку ў панэлі kalkmate.pl. Без гэтага калькулятар працуе ў афлайн-рэжыме.

/ Відэа: першы запуск

02 · Клавіятура

Навігацыя клавішамі.

Клавіятура мае 27 клавіш у раскладцы 5×6. У меню і наладах вы перамяшчаецеся лічбавым блокам:

5 — OK / Пацвердзіць

■ НАВІГАЦЫЯ■ PANIC■ СТАНДАРТ

/ NOTKA

У рэжыме калькулятара клавішы лічбаў і аперацый працуюць звычайна (5 = пяць, 4 = чатыры і г. д.). Лічбавы блок служыць навігацыяй толькі ў меню і наладах.

/ Навігацыя па экраннай клавіятуры AI

03 · Рэжым AI

Рашэнне задач.

KalkMate адпраўляе вашу задачу AI (мадэль Gemini праз наш сервер) і вяртае рашэнне крок за крокам. Працуе для матэматыкі, фізікі, хіміі і біялогіі.

01.

Увядзіце код AI

У рэжыме калькулятара ўвядзіце 4 лічбы (па змаўчанні 1111) без аніякіх аперацый паміж імі. Адкрыецца меню AI.
02.

Выберыце рэжым

[1] Fota kameraj — накіруйце камеру на задачу. Жывы прагляд на экране (індыкатар рэзкасці справа), націсніце 5 (OK), каб зрабіць фота і адправіць яго AI.

[2] Uviesci tekst — экранная клавіятура QWERTY: 8/4/6/2 = навігацыя, 5 = выбраць знак, пацвердзіце кнопкай OK (макс. 2000 знакаў).

[3] Historyja — праглядайце папярэднія рашэнні (афлайн). Кнопка → (управа) адкрывае пытанне для рэдагавання і паўторнай адпраўкі AI.
03.

Падрабязнасць рашэння

У Nalady → Rasennie zadac → Rezym rasennia выберыце:
  • Padrabiazny — крок за крокам з тлумачэннямі
  • Razlik — толькі формулы + пераходы
  • Vynik — толькі канчатковы адказ
04.

Чытанне адказу

Клавішамі 8 / 2 (уверх/уніз) пракручваеце доўгія адказы. C/CE вяртае ў меню. Кожны адказ аўтаматычна захоўваецца ў гісторыі.
04 · Памяць

Нататкі і тэсты.

KalkMate захоўвае да 50 нататак (60 KB) і 50 тэстаў (160 KB) афлайн — чытайце іх нават без WiFi. Рэдагуюцца яны на kalkmate.pl/panel.

01.

Дадайце на сайце

Перайдзіце на kalkmate.pl/panel → укладка Нататкі / Тэсты → дадайце змест (да 4000 знакаў для нататкі, 30 000 для тэсту). Падтрымліваюцца LaTeX і markdown.
02.

Сінхранізацыя з калькулятарам

На калькулятары: Natatki → націсніце стрэлку ўніз (v = sync). Патрабуецца WiFi. Спампоўвае ўсё з вашага ўліковага запісу.
03.

Чытайце афлайн

Пасля сінхранізацыі яны захоўваюцца ў flash-памяці калькулятара — чытайце дзе заўгодна. LaTeX на OLED-экране аўтаматычна пераўтвараецца ў ASCII (∞ як bitmap, дробы як (a)/(b) і г. д.).
05 · Батарэя

Зарадка і батарэя.

1500mAh

Ёмістасць (LiPo)

~2г

Поўная зарадка

2–3дні

Звычайнае выкарыстанне

5–7дзён

Рэжым чакання

/ NOTKA

Найбольш энергіі спажывае OLED пры 12V (пераўтваральнік MT3608). Скараціце аўтаматычны сон да 1–2 хвілін, і час працы павялічыцца ў 2–3 разы. Nalady → Ekran → Usyplennie.

Зарадка: USB-C (PD не патрабуецца, падыдзе любая зарадная прылада ≥5V/1A). Святлодыёд на плаце свеціцца падчас зарадкі і гасне пры 100 %. Батарэя абаронена ад перазарадкі (MCP73831 + DW01A).

06 · Абнаўленні

OTA — абнаўленні прашыўкі.

01.

Праверце наяўнасць

Nalady → Sistema → Abnaulennie → OK. Калькулятар пытаецца ў сервера, ці ёсць версія навейшая за вашу бягучую (паказваецца як v1.4.1 і г. д.).
02.

Усталюйце

Калі ёсць новая — паказвае спіс змен + кнопку OK = ustalavac. Спампоўвае (~1 MB), запісвае ў OTA-раздзел і перазапускаецца. ~1 хвіліна. Не адключайце сілкаванне падчас абнаўлення.

/ NOTKA

Абнаўленні бясплатныя і добраахвотныя. Старая прашыўка будзе працаваць і далей, але новыя функцыі (напр. лепшы LaTeX) патрабуюць абнаўлення.

/ БЯГУЧАЯ ВЕРСІЯ НА СЕРВЕРЫ:

v1.4.1

Сваю версію праверце ў Nalady → Sistema → Abnaulennie (або Nalady → Infarmacyja → Pra prylada).

07 · Праблемы

Вырашэнне частых праблем.

/ PROBLEM

Экран не ўключаецца / застаецца чорным

/ FIX

1) Праверце перамыкач (павінен быць у становішчы ON). 2) Зараджайце 30+ хвілін — батарэя можа быць цалкам разраджаная. 3) Калі святлодыёд зарадкі не свеціцца пасля падключэння USB-C — пашкоджаны кабель/раздым.

/ PROBLEM

WiFi не знаходзіць сеткі / пусты спіс

/ FIX

Nalady → WiFi i akaunt → Sietka WiFi → OK Posuk. Калі пуста — з v0.6.4 мы дадалі аўтаматычнае скіданне радыёмодуля. Паспрабуйце яшчэ раз праз 5 секунд. Сеткі 5 GHz не падтрымліваюцца (ESP32 = толькі 2,4 GHz).

/ PROBLEM

AI Chat: 'AI error 400' або тайм-аўт

/ FIX

1) Праверце WiFi (Nalady → WiFi i akaunt → Stan akaunta — павінна быць 'Stan: PRYVIAZANA'). 2) На ўліковым запісе павінны быць AI-токены — баланс праверыце і папоўніце ў панэлі, ва ўкладцы AI. 3) Паспрабуйце карацейшую задачу — ліміт ~2000 знакаў.

/ PROBLEM

Некаторыя клавішы не рэагуюць

/ FIX

Nalady → Diahnostyka → Test klavis. Калі клавіша пры націсканні падсвечваецца — яна працуе (праблема ў іншым месцы). Калі не — фізічная непаладка (халодная пайка, кабель FFC). Напішыце нам праз форму.

/ PROBLEM

Нататкі/тэсты не сінхранізуюцца

/ FIX

1) WiFi павінен працаваць. 2) Уліковы запіс павінен быць прывязаны (Nalady → WiFi i akaunt → Stan akaunta = 'Stan: PRYVIAZANA'). 3) Праверце на kalkmate.pl/panel, ці ёсць яны ва ўліковым запісе. 4) Калі даных зашмат (>50 тэстаў або разам >160 KB) — калькулятар спампуе не ўсё.

/ PROBLEM

Пераўтваральнік MT3608 гудзе / на экране палосы

/ FIX

Гэта апаратная праблема з керамічнымі (п'езаэлектрычнымі) кандэнсатарамі. Звяжыцеся з намі праз форму — заменім плату па гарантыі.

08 · FAQ

Частыя пытанні.

09 · Changelog

Гісторыя прашыўкі.

Усе выпушчаныя версіі. Абнаўленне праз Nalady → Sistema → Abnaulennie.

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 · Кантакт

Напішыце нам.

Адказваю на працягу 24 г (звычайна хутчэй). Можна таксама пісаць наўпрост на kontakt@kalkmate.pl — у тым ліку па-англійску.

0/5000