APOTEK

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Walkabot v2 — Installation complète sur GMKtec NucBox G3S (Xubuntu 26.04) ======

Cette documentation décrit l'installation complète de Walkabot sur un **GMKtec NucBox G3S (Intel N95)** sous **Xubuntu 26.04 LTS**.

Cette version remplace la plateforme Raspberry Pi devenue instable (cartes SD défectueuses) par une plateforme x86 plus fiable, plus rapide et alimentable via PowerBank USB-C PD.

-----

====== Matériel ======

  * GMKtec NucBox G3S (Intel N95)
  * SSD NVMe
  * Xubuntu 26.04 LTS
  * Interface audio USB HID
  * PowerBank USB-C PD 65W
  * Câble USB-C PD → DC 12V 5.5x2.5 mm
  * Réseau Ethernet ou WiFi

-----

====== Création de la clé USB ======

Le BIOS du GMKtec est relativement exigeant.

Les clés créées avec certains outils graphiques Ubuntu n'étaient pas reconnues.

La méthode fiable consiste à utiliser ''dd''.

Repérer la clé :

<code bash>
lsblk
</code>

Puis écrire l'image :

<code bash>
sudo umount /dev/sdX*
sudo dd if=/home/USER/Downloads/xubuntu-26.04-desktop-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync
sync
</code>

**Attention :**

Utiliser :

<code>
/dev/sdX
</code>

et non

<code>
/dev/sdX1
</code>

-----

====== Installation Xubuntu ======

Installation classique.

Créer par exemple :

<code>
Computer name :
walkabot

Username :
apobot
</code>

-----

====== Mise à jour ======

<code bash>
sudo apt update
sudo apt full-upgrade -y
</code>

-----

====== Installation SSH ======

<code bash>
sudo apt install openssh-server
sudo systemctl enable ssh
sudo systemctl start ssh
</code>

Connexion :

<code bash>
ssh apobot@IP_DU_WALKABOT
</code>

-----

====== Installation VNC ======

Installation :

<code bash>
sudo apt install x11vnc
</code>

Créer le service :

<code bash>
sudo nano /etc/systemd/system/x11vnc.service
</code>

Contenu :

<code>
[Unit]
Description=x11vnc server for Walkabot desktop
After=display-manager.service network.target
Requires=display-manager.service

[Service]
Type=simple
ExecStart=/usr/bin/x11vnc -display :0 -auth /var/run/lightdm/root/:0 -forever -shared -rfbport 5900 -listen 0.0.0.0 -noxdamage
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
</code>

Activer :

<code bash>
sudo systemctl daemon-reload
sudo systemctl enable x11vnc
sudo systemctl start x11vnc
</code>

Vérifier :

<code bash>
sudo systemctl status x11vnc
</code>

Connexion :

<code bash>
vncviewer IP_DU_WALKABOT
</code>

-----

====== Installation de Pure Data ======

<code bash>
sudo apt install \
puredata \
qjackctl \
jackd2 \
alsa-utils \
pavucontrol \
pd-zexy \
pd-iemlib \
pd-iemmatrix \
pd-iemambi \
pd-creb \
pd-bsaylor \
pd-pdogg
</code>

Ajouter l'utilisateur au groupe audio :

<code bash>
sudo usermod -aG audio apobot
</code>

Puis redémarrer.

-----

====== Vérification des librairies ======

Les externals sont installés dans :

<code>
/usr/lib/pd/extra/
</code>

Les principaux dossiers sont :

<code>
/usr/lib/pd/extra/pdogg
/usr/lib/pd/extra/iemlib
/usr/lib/pd/extra/zexy
</code>

-----

====== Vérification de la carte son ======

Lister les interfaces audio :

<code bash>
aplay -l
arecord -l
</code>

Résultat attendu :

<code>
card 1: HID [USB Audio and HID]
device 0
</code>

Le script utilisera donc :

<code>
hw:1,0
</code>

-----

====== Copie du patch ======

Copie du dossier :

<code>
/home/apobot/BotPatch
</code>

Patch principal :

<code>
PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd
</code>

-----

====== Script de démarrage ======

Créer :

<code bash>
nano /home/apobot/start_walkabot.sh
</code>

Contenu :

<code bash>
#!/bin/bash

sleep 10

export DISPLAY=:0
export XAUTHORITY=/var/run/lightdm/root/:0

pkill -f "puredata.*PATCH_GENERAL_BORGBOT" 2>/dev/null
pkill jackd 2>/dev/null

sleep 2

jackd \
-d alsa \
-d hw:1,0 \
-r 44100 \
-p 256 \
-n 3 &

sleep 5

puredata \
-jack \
-verbose \
-stderr \
-path /usr/lib/pd/extra/pdogg \
-path /usr/lib/pd/extra/iemlib \
-path /usr/lib/pd/extra/zexy \
-lib zexy \
-lib iemlib \
-path /home/apobot/BotPatch \
-open /home/apobot/BotPatch/PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd
</code>

Rendre exécutable :

<code bash>
chmod +x /home/apobot/start_walkabot.sh
</code>

-----

====== Démarrage automatique ======

Créer le dossier :

<code bash>
mkdir -p ~/.config/autostart
</code>

Créer le lanceur :

<code bash>
nano ~/.config/autostart/walkabot.desktop
</code>

Contenu :

<code>
[Desktop Entry]
Type=Application
Name=Walkabot
Exec=/home/apobot/start_walkabot.sh
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true
</code>

-----

====== Vérification ======

Après redémarrage :

<code bash>
ps aux | grep jackd
ps aux | grep puredata
</code>

Le système doit lancer automatiquement :

  * la session graphique Xubuntu
  * JACK
  * Pure Data
  * le patch Walkabot
  * le serveur VNC
  * le serveur SSH

-----

====== Architecture ======

<code>
Boot

↓

LightDM Autologin

↓

Desktop Xubuntu

↓

Autostart

↓

start_walkabot.sh

↓

JACK (USB Audio hw:1,0)

↓

Pure Data

↓

PATCH_GENERAL_BORGBOT_VERSION_ALPHA_0.1-2.pd

↓

Icecast / Ogg Stream
</code>

-----

====== Dépannage ======

===== VNC =====

Si ''x11vnc'' ne trouve pas la session X :

<code bash>
ps aux | grep Xorg
</code>

Le serveur X doit contenir :

<code>
-auth /var/run/lightdm/root/:0
</code>

Le service ''x11vnc'' doit utiliser exactement ce chemin.

-----

===== Pure Data =====

Si ''oggcast~'' ou ''lp2~'' ne sont pas trouvés, vérifier que les chemins suivants sont présents :

<code>
/usr/lib/pd/extra/pdogg
/usr/lib/pd/extra/iemlib
/usr/lib/pd/extra/zexy
</code>

-----

===== JACK =====

Si JACK refuse de démarrer :

Lister les interfaces :

<code bash>
aplay -l
</code>

Puis adapter :

<code>
-d hw:1,0
</code>

dans ''start_walkabot.sh''.

-----

====== Résultat ======

Walkabot démarre désormais de manière totalement autonome :

  * alimentation
  * boot automatique
  * ouverture de session
  * lancement de JACK
  * lancement de Pure Data
  * chargement du patch
  * diffusion Icecast
  * accès SSH
  * accès VNC

Le système ne dépend plus d'une carte SD Raspberry Pi mais d'un SSD NVMe, ce qui améliore considérablement la fiabilité et facilite le clonage sur d'autres machines.
APOTEK

User Tools

Site Tools

Page Tools
