FUXA installeren op de reComputer RK-serie

Laatst bijgewerkt:

FUXA is een browsergebaseerd SCADA/HMI- en dashboardplatform. Het kan verbinding maken met gegevensbronnen zoals MQTT, Modbus en OPC UA en hun waarden op monitoringschermen tonen. Deze handleiding laat zien hoe je FUXA op reComputer RK3576 installeert en de service en webeditor controleert.

Omgeving: reComputer RK3576 DevKit met ARM64 Armbian (Debian Bookworm) en geïnstalleerde Docker. De image latest kan veranderen. Gebruik voor een reproduceerbare installatie een geverifieerde imageversie of digest.

Voordat je begint

  • Verbind de RK3576 en je computer met een vertrouwd netwerk.
  • Zorg voor SSH- of terminaltoegang tot de RK3576 en een werkende Docker Engine.
  • Controleer of de systeemschijf voldoende ruimte voor de image heeft.

Controleer de omgeving op de RK3576:

bash
uname -m
cat /etc/os-release
docker --version
df -h /

uname -m hoort aarch64 te tonen. Als Docker ontbreekt, installeer en start Docker Engine volgens de instructies voor je Armbian-image.

Stap 1: De FUXA ARM64-image ophalen

bash
sudo docker pull --platform linux/arm64 frangoteam/fuxa:latest

Als het ophalen een time-out geeft, controleer dan de verbinding met Docker Hub. Een proxy die alleen in je SSH-shell is ingesteld, wordt niet automatisch gebruikt door de Docker-daemon. Als je netwerk een proxy vereist, volg dan de Docker-instructies voor de daemonproxy met het proxyadres van je netwerk.

Stap 2: De container starten

Start na het ophalen van de image de FUXA-container:

bash
sudo docker run -d \
  --name fuxa-rk3576 \
  --platform linux/arm64 \
  --network host \
  --restart unless-stopped \
  -v fuxa_rk3576_appdata:/usr/src/app/FUXA/server/_appdata \
  -v fuxa_rk3576_db:/usr/src/app/FUXA/server/_db \
  -v fuxa_rk3576_logs:/usr/src/app/FUXA/server/_logs \
  -v fuxa_rk3576_images:/usr/src/app/FUXA/server/_images \
  frangoteam/fuxa:latest

Met -d draait FUXA op de achtergrond. De verwachte uitvoer is een container-ID, geen webpagina. De benoemde volumes bewaren projectgegevens, historie, logboeken en geüploade afbeeldingen. Deze opdracht gebruikt de Linux-netwerkmodus host, zodat -p 1881:1881 niet nodig is. Houd poort 1881 binnen een vertrouwd netwerk en stel toegangsbeheer in voordat je FUXA breder beschikbaar maakt.

Stap 3: De service controleren

bash
sudo docker ps --filter name=fuxa-rk3576
sudo docker logs --tail 40 fuxa-rk3576
curl -I http://127.0.0.1:1881/
hostname -I

De container hoort Up te tonen, in de logboeken hoort FUXA started! te staan en de lokale webaanvraag hoort een HTTP-antwoord te geven. Open op een computer in hetzelfde vertrouwde netwerk het LAN-adres van de RK3576 uit hostname -I:

  • Runtimepagina: http://<RK3576_IP>:1881/
  • Webeditor: http://<RK3576_IP>:1881/editor

De runtimepagina kan aanvankelijk leeg zijn, omdat er nog geen visualisatie is gemaakt.

Stap 4: De editor controleren

Open de editor en selecteer MainView in het paneel Views. Plaats als eenvoudige test een tekstelement uit General op het canvas en voer bijvoorbeeld RK3576 FUXA test in. Sla op met het diskettepictogram en gebruik de voorbeeldknop. Controleer of de opgeslagen tekst in de runtimeweergave verschijnt.

FUXA is nu geïnstalleerd en de editor werkt. Live apparaatgegevens, een MQTT-verbinding, alarmen en een SCADA-proces zijn nog niet ingesteld.

Problemen oplossen

  • De pagina opent niet vanaf je computer: Controleer de containerstatus, curl -I http://127.0.0.1:1881/ op de RK3576, het LAN-IP-adres en de netwerk-/firewalltoegang tot poort 1881.
  • De runtimepagina is leeg: Open /editor en sla een weergave op. Alleen een aanvankelijk lege pagina betekent niet dat de installatie is mislukt.
  • Ophalen van de image mislukt: Controleer schijfruimte en netwerk-/proxyinstellingen van de Docker-daemon. Verwijder geen andere images zonder ze eerst te bekijken.

Volgende stappen

Raadpleeg na de installatie de FUXA-documentatie om een gegevensbron te verbinden, tags aan meters en grafieken te koppelen en live gegevens op de runtimepagina te bekijken.