Telepítés és használat

A KOFA telepítése és első beállítása

Ez az útmutató a teljes KOFA telepítését és az első beállításokat mutatja be: honnan szerezd be, hogyan indítsd el, mi hol van a felületen, és hogyan jutsz el az első működő járműig. A képek egy friss telepítésen készültek.

Mit kapsz

A KOFA egy szerverből és egy böngészőből kezelhető felületből áll. A funkciókat Komod pluginok adják (szenzor, vezérlő, kamera, AI, kijelző); ezeket a Gráf oldalon kötöd össze, és az eredményt a Dashboard mutatja.

Melyik változatot válaszd?

A telepítő és a kiadások a kofa.kncsk.hu oldalról tölthetők le.

Telepítés Windowsra

1. Töltsd le a KOFA-Setup-<verzió>-win-x64.exe telepítőt, és futtasd (rendszergazdai jog kell).
2. A varázsló kéri a licenc elfogadását, majd telepíti a KOFA Developer programot (alapból C:\Program Files\KOFA Developer). Az adatok a C:\ProgramData\Kofa mappába kerülnek, és az eltávolítás nem törli őket.
3. A Start menüből indítsd a KOFA Developer parancsikont. Megnyílik egy konzolablak a naplóval, és a böngésző a http://localhost:5080 címen.

A Windowson futó változat fejlesztői célú: a hardver Komodok (PCA9685, kamera, INA219) szimulált hardverrel futnak, a Wi-Fi és a Bluetooth kezelés szimulált vagy nem érhető el.

Telepítés Raspberry Pi-re (Ubuntu Server / Raspberry Pi OS)

Előkészítés

• Az ajánlott rendszer az Ubuntu Server 24.04 LTS (64 bit) vagy a Raspberry Pi OS Lite 64 bit (Bookworm). Asztali környezet nem kell.
• A Raspberry Pi Imager beállításaiban (fogaskerék) add meg a gépnevet, a felhasználót, az SSH-t és ha kell a Wi-Fi-t.
• A csomag önálló (self-contained), a gépre nem kell .NET-et telepíteni.

Egy paranccsal (internet kell)

curl -fsSL https://kofa.kncsk.hu/install-kofa.sh | sudo bash -s -- --lan

Kézzel, a kiadási csomagból

A kofa-linux-arm64.tar.gz fájlt másold a gépre, csomagold ki, és futtasd a telepítőt:

scp kofa-linux-arm64.tar.gz ubuntu@<gép>.local:/tmp/
ssh ubuntu@<gép>.local
cd /tmp && tar xzf kofa-linux-arm64.tar.gz
sudo ./linux-arm64/deploy/install.sh --lan

A telepítő létrehozza a kofa rendszerfelhasználót, bekapcsolja az I2C-t, felteszi a Bluetooth csomagokat, a programot az /opt/kofa mappába másolja, és elindítja a kofa systemd szolgáltatást. A végén kiírja a címet és a setup tokent.

Ubuntun az I2C a /boot/firmware/config.txt-ben kapcsol be, ezután egyszer újra kell indítani a gépet. A részletes kapcsolók, a bekötés és a hálózati lépések: docs/DEPLOY-rpi.md.

Hol van minden telepítés után

Hasznos parancsok:

sudo systemctl status kofa          # fut-e
journalctl -u kofa -f               # napló élőben
journalctl -u kofa | grep "one-time token"   # a setup token

Az első indítás: az admin fiók létrehozása

Nincs alapértelmezett jelszó. Egy friss KOFA az első megnyitáskor az Első indítás oldalra visz.

1. Telepítési token: a szerver indításkor kiírja a naplóba (Windowson a konzolablakba, Linuxon a telepítő végére és a journalctl -u kofa kimenetébe). Egyszeri, 16 karakteres kód.
2. Admin felhasználónév és jelszó (legalább 10 karakter, kétszer).
3. E-mail: nem kötelező, de a bejelentkezéshez használható.
4. Kattints az Admin létrehozása gombra: a rendszer be is léptet.

Ezután minden belépés a Belépés oldalon történik.

A felület: mi hol van

Bejelentkezés után a bal oldali menüvel éred el az oldalakat. Az Admin szerepű felhasználó mindent lát; a Kezelő (Operator) gráfot szerkeszthet és járművet vezérelhet; a Néző (Viewer) csak olvashat. A rendszer-, hálózat- és felhasználókezelő oldalak Adminnak valók.

A Komodok oldalon látod, mi van telepítve:

Komodok telepítése

A Linux kiadási csomagban a Komodok nincsenek benne: a Komod tárból (kofa.kncsk.hu) telepíthetők. Olvasni nem kell hozzá bejelentkezni.

1. Nyisd meg a Komodok → Komod tár oldalt.
2. Keress név, leírás vagy porttípus szerint, és szűrj kategóriára vagy járműre.
3. A Telepítés gomb előtt megnézheted a csomag tartalmát; a letöltött fájl ellenőrző összegét a KOFA az indexhez hasonlítja.
4. Frissítés: csomagonként vagy a Mind frissítése gombbal.

Más forrásból érkező csomagot (.komod fájl) a Komodok oldal feltöltési területére húzva telepíthetsz; telepítés előtt a KOFA mutatja a tartalmát. Saját Komod írása: Komod fejlesztés.

Hálózat: Wi-Fi, hotspot, Bluetooth

A Hálózat oldal (Admin) a gép Wi-Fi-jét és Bluetooth adapterét kezeli. Linuxon a hálózatkezelést a NetworkManager végzi: a telepítőnek a --network kapcsolót kell adni. (Windowson és fejlesztői gépen az oldal szimulált hálózatot mutat.)

• Csatlakozás egy másik Wi-Fi-re (rejtett hálózat is), mentett hálózatok sorrendje és törlése.
• Saját hotspot: a gép maga oszt Wi-Fi-t (SSID, jelszó, sáv); a rácsatlakozó telefon a 10.42.0.1 címen éri el. Internet nélküli helyen (víz, pálya) ez a leggyakoribb elérés.
• Tartalék hotspot: ha a gép indításkor nem talál ismert hálózatot, magától hotspotot indít.
• Csatlakozási QR kód a KOFA apphoz.

Az első gráf

A gráf a járműved „huzalozása”: Komod példányok, amiket típusos portokon kötsz össze (egy kimenet csak vele azonos típusú bemenetre köthető).

Két út van az első gráfhoz:

• Kész példa importálása (ajánlott kezdéshez): a kiadás és a repó examples/graphs/ mappájában vannak kész profilok (autó, vitorlás, szimulátoros és élő változatok). A Gráf importálása ikonnal válaszd ki a *.kofa-graph.json fájlt. A példák a kofa.kncsk.hu oldalról is elérhetők, és ott egyedi gráfot is összeállíthatsz belőlük és a Komod tár Komodjaiból: Példa gráfok és a gráf összeállító. Az import mindig új profilt hoz létre, és figyelmeztet a hiányzó vagy eltérő verziójú Komodokra (ezeket előbb telepítsd a Komod tárból).
• Építés a nulláról: a palettán a Komod mellett a + gombbal vagy húzással tedd a vászonra, majd húzz kötést a kimenetről (jobb oldal) a bemenetre (bal oldal). A node-ra kattintva a beállításait szerkesztheted. Törlés: Delete.

A szerkesztő felső sorának ikonjai (balról): profil választó, Új profil, Átnevezés / járműtípus, Profil törlése, Visszavonás és Újra, Minden látszódjon, Verziók, Exportálás fájlba, Exportálás programként (KOFA Lite), Gráf importálása.

Aktiválás

Az Aktiválás gomb éleszti a gráfot. A KOFA előbb megmutatja az ellenőrzést (hibák, figyelmeztetések) és a változásokat: mely példányok jönnek létre, melyek szűnnek meg, mely kötések változnak. Az aktiválás a most futó gráfot erre cseréli.

Aktiválás után a gomb helyén az Alkalmazva jelzés és a Leállítás gomb látszik.

A dashboard

A Dashboard az aktív gráf Komodjainak widgetjeit mutatja. Az Elrendezés gombbal a csempék húzással áthelyezhetők és mindkét irányban méretezhetők; a csempe fejlécének ikonjaival a Komod felülete nagyobb nézetben vagy dialógus ablakban is megnyitható.

Felhasználók és szerepek

A Felhasználók oldalon (Admin) veheted fel a további fiókokat. Szerepkörök:

Elérés máshonnan

Mentés és frissítés

• Mentés: sudo systemctl stop kofa && sudo cp -a /var/lib/kofa ~/kofa-backup && sudo systemctl start kofa.
• Frissítés: a Rendszer → Frissítés kártyán (admin) egy gombbal, vagy az egysoros telepítő (install-kofa.sh) újrafuttatásával. A konfiguráció (/etc/kofa) és az adatok (/var/lib/kofa) megmaradnak; hiba esetén az előző verzió áll vissza.
• Komodok frissítése: Komodok → Komod tár → Mind frissítése.

Hibaelhárítás

Továbbiak: Hibaelhárítás.

Következő lépések

• Járműbe szánt, offline program készítése a gráfodból: KOFA Lite.
• Saját Komod írása: Első Komodok (oktatóanyag).