Installer FUXA sur la série reComputer RK

Dernière mise à jour:

FUXA est une plateforme SCADA/IHM et de tableaux de bord accessible dans un navigateur. Elle peut se connecter à des sources de données comme MQTT, Modbus et OPC UA pour afficher leurs valeurs sur des écrans de supervision. Ce guide explique comment installer FUXA sur reComputer RK3576 et vérifier le service et l'éditeur Web.

Environnement : reComputer RK3576 DevKit sous Armbian ARM64 (Debian Bookworm), avec Docker installé. L'image latest peut évoluer ; pour un déploiement reproductible, utilisez une version ou un digest que vous avez vérifié.

Avant de commencer

  • Connectez le RK3576 et votre ordinateur à un réseau de confiance.
  • Préparez un accès SSH ou terminal au RK3576 et un Docker Engine opérationnel.
  • Vérifiez que le disque système dispose de suffisamment d'espace pour l'image.

Sur le RK3576, vérifiez l'environnement :

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

uname -m doit afficher aarch64. Si Docker n'est pas installé, installez et démarrez Docker Engine selon les instructions adaptées à votre image Armbian.

Étape 1 : récupérer l'image FUXA ARM64

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

Si le téléchargement expire, vérifiez l'accès à Docker Hub. Un proxy configuré uniquement dans la session SSH ne configure pas automatiquement le démon Docker. Si votre réseau nécessite un proxy, suivez les instructions de configuration du proxy du démon Docker avec l'adresse appropriée.

Étape 2 : démarrer le conteneur

Une fois l'image récupérée, exécutez le conteneur FUXA :

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

-d exécute FUXA en arrière-plan : recevoir un identifiant de conteneur plutôt qu'une page Web est normal. Les volumes nommés conservent les données du projet, l'historique, les journaux et les images importées. Le réseau host de Linux est utilisé ; n'ajoutez pas -p 1881:1881. Limitez le port 1881 à un réseau de confiance et configurez le contrôle d'accès avant une exposition plus large.

Étape 3 : vérifier le service

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

Le conteneur doit être Up, les journaux doivent contenir FUXA started! et la requête Web locale doit recevoir une réponse HTTP. Depuis un ordinateur du même réseau de confiance, utilisez l'adresse LAN du RK3576 donnée par hostname -I :

  • Page d'exécution : http://<RK3576_IP>:1881/
  • Éditeur Web : http://<RK3576_IP>:1881/editor

La page d'exécution peut être vide au début, car aucune visualisation n'a encore été créée.

Étape 4 : vérifier l'éditeur

Ouvrez l'éditeur et sélectionnez MainView dans le panneau Views. Pour un premier essai, placez un élément de texte des outils General sur la zone de travail et saisissez une courte étiquette comme RK3576 FUXA test. Enregistrez avec l'icône de disquette, puis utilisez le bouton d'aperçu. Vérifiez que le texte enregistré apparaît dans la vue d'exécution.

FUXA est désormais installé et l'éditeur fonctionne. Les données en temps réel d'un appareil, la connexion MQTT, les alarmes et un processus SCADA ne sont pas encore configurés.

Dépannage

  • La page ne s'ouvre pas depuis votre ordinateur : Vérifiez l'état du conteneur, curl -I http://127.0.0.1:1881/ sur le RK3576, son adresse LAN et l'accès réseau ou le pare-feu sur le port 1881.
  • La page d'exécution est vide : Ouvrez /editor et enregistrez une vue. Une page initialement vide ne signifie pas à elle seule que l'installation a échoué.
  • Le téléchargement de l'image échoue : Vérifiez l'espace disque et la configuration réseau/proxy du démon Docker. Ne supprimez pas d'autres images sans les examiner.

Étapes suivantes

Après l'installation, consultez la documentation FUXA pour connecter une source de données, associer des tags à des jauges et graphiques et afficher les données en direct dans la page d'exécution.