Tutoriel Zynthian Headless pour débutants (french)

From ZynthianWiki
Jump to navigation Jump to search

1 Introduction

Voici un tutoriel pas à pas pour commencer simplement avec une Zynthian "headless" (acéphale pour les québécois ^^).

Il s'agit d'une Raspberry Pi avec le système d'exploitation ZynthianOS (un système linux dérivant de Raspberry Pi OS, lui même variante de debian) mais sans écran ni boutons ni potentiomètres. Tout est controllé à distance en réseau depuis un autre ordinateur, une tablette, un smartphone ou une interface MIDI. Dans la plupart des cas, les kits Zynthian avec écran et boutons sont la manière la plus efficace d'aborder ce système. Mais parfois, des versions headless sont très intéressantes, notamment pour la mise en réseau d'un grand nombre de Raspberry Pi.

2 Matériel

  1. Raspberry Pi (Pi4 recommandée)
  2. Carte SD (class 10)
  3. Alimentation (prennez l'officielle pour être sûr)
  4. DAC (carte son) I2S (cartes son recommandées)

3 ZynthianOS

  1. Téléchargez l'image de la dernière version stable de Zynthian OS
  2. Téléchargez Etcher
  3. Installez l'image ZynthianOS sur la carte SD

4 Connexion en Réseau

  • Le plus simple est de connecter directement la Raspberry Pi à votre ordinateur avec un câble ethernet.
  • Une autre manière est de les connecter tous les deux à un routeur (switch) ethernet.

5 Navigateur Web

Vous avez besoin d'un navigateur internet, mais ils ne fonctionnent pas tous.

  • Google Chrome semble marcher le mieux

6 Premier démarrage

  1. Mettez la carte SD dans la Raspberry Pi
  2. Allumez en branchant l'alimentation (il est recommandé d'utiliser une prise avec un interrupteur)
  3. Soyez patients
  4. Ouvrez votre navigateur web

Si vous ne pouvez pas entrer dans le Zynthian WebConf Tools, attendez un peu plus que cela charge. Sinon, essayer de redémarrer en coupant le courant. Sinon, essayez de réinstaller la carte SD.

7 Configuration d'Internet

  • Si vous êtes connectés en réseau via un routeur ethernet, connectez le sur votre box ethernet
  • Si vous êtes dirrectement connecté via un câble ethernet entre la Raspberry Pi et votre Ordinateur, configurez le Wifi dans le WebConf :
System / WIFI / Add Network
Mode = ON

8 Mise à jour de ZynthianOS

Maintenant que vous êtes sur Internet, vous pouvez mettre à jour ZynthianOS via le WebConf : 

Software / Update

System / Reboot

9 Configurer le matériel

Configurez correctement votre matériel avec le WebConf : 

Hardware / Kit / Custom

Hardware / Audio / Selectionnez votre carte son dans la liste

Hardware / Display / Generic HDMI Display

Hardware / Wiring / DUMMIES


 System/sys-reboot / Reboot

10 Installer le serveur VNC sur la Raspberry Pi

VNC vous permet de charger en réseau l'interface graphique de la Raspberry Pi sur votre ordinateur, votre tablette ou votre smartphone. Pour installer VNC (ou d'autres logiciels) sur une Raspberry Pi, vous devez avoir accès au terminal :

  • Option 1 : En utilisant le terminal du WebConf
System / Terminal
  • Option 2 : via SSH (c'est-à-dire en utilisant le terminal de votre ordinateur)

- Sur MacOS, ouvrez le Terminal (dans Applications/Utilitaires) puis tapez (suivi de la touche entrée) : 

ssh zynthian.local

Il vous sera tout d'abord demandé votre mot de passe administrateur, puis celui de la Zynthian (mdp = raspberry) Si vous voyez root@zynthian:~ vous êtes bien connecté au terminal de la Raspberry Pi.

Note : Sur MacOS, si vous avez eu besoin de réinstaller la carte SD, vous aurez probablement un message d'erreur “Host key verification failed” quand vous essayerez à nouveau de vous connecter via SSH. Vous avez alors effacer les anciennes données qui se trouvent dans le fichier ssh known_hosts. Pour cela, vous pouvez utiliser le terminal du mac et lancer cette commande : 

sudo nano /var/root/.ssh/known_hosts


Dans l'éditeur de texte nano, vous pouvez alors effacer la ligne correspondant à zynthian line (control K), puis sauvegarder (control O + enter), puis quitter (control X).

- Sur Windows, téléchargez PuTTy et faites la même chose que pour MacOS.

  • Quand vous êtes arrivés sur le terminal de la Raspberry Pi, lancez les commandes suivantes (à chaque fois suivies de la touche entrée) :
sudo apt update
sudo apt install realvnc-vnc-server 
sudo raspi-config

Interfacing Options / VNC / Yes

Si vous utilisez le terminal du WebConf, la visualisation n'est pas idéale. Il faudra donc attendre un moment après la commande de mise à jour (apt update), puis arriver jusqu'en bas pour continuer. Si vous ne voyez toujours rien au bout de quelques minutes, fermez le terminal et rouvrez le pour continuer et lancer l'installation de VNC.

11 Installer VNC Viewer sur vos appareils

1. Téléchargez et installez VNC viewer sur vos appareils :

2. Connectez-vous à l'interface Zynthian UI via VNC : Vous devez être sur le même réseau (câble ethernet et/ou Wifi). Tapez l'adresse IP de la Raspberry Pi (si vous êtes sur Windows ou android) ou zynthian.local (sur MacOS and iOS) dans VNC Viewer.
 

Nom d'utilisateur : root

Mot de passe : raspberry

Vous devez normalement désormais avoir accès à l'interface graphique Zynthian UI en réseau.

Pour une utilisation optimum, configurez l'interface Zynthian pour une utilisation headless via le WebCong : 

Interface / UI options
 
Advanced view : ON

Enable Touch Widgets: ON

Enable cursor: ON

Sur scène, vous pouvez vous deconnecter d'internet et configurer la Raspberry comme un émetteur Wifi afin d'y connecter vos appareils. Pour cela, allez dans le WebConf: 

System / WIFI / Hotspot

12 Etapes optionnelles

12.1 Accéder aux interfaces graphiques des logiciels

Si vous voulez accéder depuis votre ordinateur aux interfaces graphiques des logiciels pour les programmer, par exemple pour Pure Data ou pour Pianoteq, vous devez installer sur votre ordinateur un serveur X11 :

Une fois démarré, dans le terminal du serveur X11, vous pouvez envoyer cette commande : 

ssh -Y root@zynthian.local

Lorsque vous créez un nouveau "layer" Pure Data ou Pianoteq dans l'interface Zynthian UI, le logiciel se lance graphiquement automatiquement sur votre écran (même s'il tourne toujours sur la Raspberry Pi).

12.2 Accéder aux fichiers et aux dossiers de ZynthianOS

La meilleur manière de charger des patchs, des presets, des soundfonts etc. est via le WebConf (lisez le manuel). Mais dans certains cas, il est nécessaire d'accéder aux dossiers (peu recommandé pour les débutants). Vous pouvez le faire en SSH via le terminal si vous connaissez les commandes de base du shell UNIX. Mais si vous préférez y accéder graphiquement comme si vous étiez sur le finder de votre ordinateur, voici la procédure :

1. Installez un client SFPT sur votre ordinateur :

2. Ouvrez une connexion SFPT: 

Serveur : zynthian.local (MacOS) ou Address IP (Windows)

Utilisateur : root

Mot de passe : raspberry

3. Si, par exemple, vous voulez accéder au dossier avec les externals de Pure Data pour en installer manuellement, vous pouvez vous rendre ici et simplement glisser vos fichiers : 

/usr/lib/pd/extra
Retrieved from "http://wiki.zynthian.org/index.php?title=Tutoriel_Zynthian_Headless_pour_débutants_(french)&oldid=11560"