Difference between revisions of "Tutoriel Zynthian Headless pour débutants (french)"

Latest revision as of 20:56, 21 January 2021

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 peut être contrôlé à distance depuis un autre ordinateur, une tablette, un smartphone, une interface MIDI et/ou OSC. 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

Raspberry Pi (Pi3 possible mais Pi4 recommandée avec au moins 2Go de RAM / jusqu'à 8Go)
Carte micro SD (class 10) (Avec adaptateur SD si besoin pour flasher la carte depuis son ordi. Dans ce cas, pensez à mettre le loquet vers le haut pour pouvoir écrire dessus)
Alimentation (prenez l'officielle pour être sûr)
DAC (carte son) I2S, par exemple de ce type avec son boitier.

3 ZynthianOS

Téléchargez l'image de la dernière version stable de Zynthian OS
Téléchargez Etcher
Installez avec Etcher 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

Mettez la carte SD dans la Raspberry Pi
Allumez en branchant l'alimentation (il est recommandé d'utiliser une prise avec un interrupteur)
Soyez patients le temps que le système se configure
Ouvrez votre navigateur web

Sur MacOS, allez à l'adresse http://zynthian.local pour accéder au Zynthian WebConf Tool
Sur Windows, commencez par trouver l'adresse IP de votre Raspberry Pi, puis rentrez là dans le navigateur web pour accéder au Zynthian WebConf Tool

Si vous ne pouvez pas entrer dans le Zynthian WebConf Tool, attendez un peu plus que cela charge. Sinon, essayez de redémarrer en coupant le courant. Sinon, essayez de réinstaller la carte SD. Sinon, criez très fort. Sinon, demandez de l'aide sur le forum zynthian.

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 directement 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 Configuration du 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 / Reboot

10 Installation du 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.

Si ça ne marche pas, essayez :

sudo ssh zynthian.local

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 devez 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 (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 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 Installation de 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.  Sur une tablette, il faut aller dans "Address Book" puis cliquer sur le + (en haut à droite sur iOS, en bas à droite sur Android) pour rajouter la Zynthian.

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 WebConf :

Interface / UI options  
Advanced view : ON 
Enable Touch Widgets: ON 
Enable cursor: ON

Sur scène, vous pouvez vous déconnecter 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

Note : sur Android, le système va automatiquement se connecter au réseau qui capte le mieux Internet. Il faut donc aller dans les paramètres et désactiver les options suivantes : “Auto Network Switch” (options avancées) et « connexion automatique » sur les réseaux déjà enregistrés. Cela peut nécessiter de redémarrer votre téléphone.

Voici un tutoriel vidéo de Benoit Bouchez en français concernant la prise en main de l'interface Zynthian UI :

https://www.youtube.com/watch?v=4jb-8cQQQgQ

Et bien sur le manuel !

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 :

Sur MacOS: Xquartz
Sur Windows: Xming

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).

A noter que l'interface graphique de Mod-UI (le pedal board virtuel) n'a pas besoin de X11 et se trouve simplement, une fois le "layer" créé, en page Web via le WebConf :

Software / MOD-UI

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 directement 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 gestionnaire de fichiers (finder ou explorer) de votre ordinateur, voici la procédure :

1. Installez un client SFPT sur votre ordinateur :

Sur MacOS: Cyberduck
Sur Windows: PuTTy

2. Ouvrez une connexion SFPT :

Serveur : zynthian.local (MacOS) ou Adresse 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

@@ Line 8: / Line 8: @@
 === Matériel ===
-# Raspberry Pi ([https://www.kubii.fr/cartes-raspberry-pi/2771-nouveau-raspberry-pi-4-modele-b-2gb-0765756931175.html Pi4 recommandée] avec au moins 2Go de RAM / jusqu'à [https://www.reichelt.de/de/en/raspberry-pi-4-b-4x-1-5-ghz-8-gb-ram-wlan-bt-rasp-pi-4-b-8gb-p276923.html?&trstct=vrt_pdn&nbc=1 8Go] possibles)
+# Raspberry Pi (Pi3 possible mais [https://www.kubii.fr/cartes-raspberry-pi/2771-nouveau-raspberry-pi-4-modele-b-2gb-0765756931175.html Pi4 recommandée] avec au moins 2Go de RAM / jusqu'à [https://www.reichelt.de/de/en/raspberry-pi-4-b-4x-1-5-ghz-8-gb-ram-wlan-bt-rasp-pi-4-b-8gb-p276923.html?&trstct=vrt_pdn&nbc=1 8Go])
-# [https://www.reichelt.de/de/en/microsdhc-card-16gb-sandisk-ultra-sdsquar016ggn6ma-p214843.html?&nbc=1 Carte SD (class 10)]
+# [https://www.reichelt.de/de/en/microsdhc-card-16gb-sandisk-ultra-sdsquar016ggn6ma-p214843.html?&nbc=1 Carte micro SD (class 10)] (Avec adaptateur SD si besoin pour flasher la carte depuis son ordi. Dans ce cas, pensez à mettre le loquet vers le haut pour pouvoir écrire dessus)
 # Alimentation ([https://www.reichelt.de/de/en/raspberry-pi-power-supply-5-1-v-3-0-a-usb-type-c-eu-plug--rpi-ps-15w-wt-eu-p260026.html?&nbc=1 prenez l'officielle pour être sûr])
 # DAC (carte son) I2S, par exemple [https://www.hifiberry.com/shop/boards/hifiberry-dac-adc/ de ce type] avec son [https://www.hifiberry.com/shop/cases/hifiberry-universal-case-black-pi4/ boitier].
@@ Line 29: / Line 29: @@
 # Mettez la carte SD dans la Raspberry Pi
 # Allumez en branchant l'alimentation (il est recommandé d'utiliser une prise avec un interrupteur)
-# Soyez patients
+# Soyez patients le temps que le système se configure
 # Ouvrez votre navigateur web
 * Sur MacOS, allez à l'adresse http://zynthian.local pour accéder au [https://wiki.zynthian.org/index.php/Configuration_Users_Guide Zynthian WebConf Tool]
 * Sur Windows, commencez par [https://wiki.zynthian.org/index.php/Finding_your_IP_address trouver l'adresse IP de votre Raspberry Pi], puis rentrez là dans le navigateur web pour accéder au [https://wiki.zynthian.org/index.php/Configuration_Users_Guide Zynthian WebConf Tool]
-Si vous ne pouvez pas entrer dans le [https://wiki.zynthian.org/index.php/Configuration_Users_Guide Zynthian WebConf Tool], attendez un peu plus que cela charge. Sinon, essayer de redémarrer en coupant le courant. Sinon, essayez de réinstaller la carte SD.
+Si vous ne pouvez pas entrer dans le [https://wiki.zynthian.org/index.php/Configuration_Users_Guide Zynthian WebConf Tool], attendez un peu plus que cela charge. Sinon, essayez de redémarrer en coupant le courant. Sinon, essayez de réinstaller la carte SD. Sinon, criez très fort. Sinon, demandez de l'aide sur le [https://discourse.zynthian.org/ forum zynthian].
 === Configuration d'Internet ===
@@ Line 53: / Line 53: @@
    [http://zynthian.local/hw-display Hardware / Display] / Generic HDMI Display
   [http://zynthian.local/hw-wiring Hardware / Wiring] / DUMMIES
-  [http://zynthian.local/sys-reboot System / Reboot]
+ [http://zynthian.local/sys-reboot System / Reboot]
 === Installation du serveur VNC sur la Raspberry Pi ===
@@ Line 66: / Line 66: @@
 - 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)
+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.
+Si vous voyez root@zynthian:~# vous êtes bien connecté au terminal de la Raspberry Pi.
+Si ça ne marche pas, essayez :
+ sudo ssh zynthian.local
 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 devez 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).
+Dans l'éditeur de texte nano, vous pouvez alors effacer la ligne correspondant à zynthian (control K), puis sauvegarder (control O + enter), puis quitter (control X).
 - Sur Windows, téléchargez [https://www.putty.org/ 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
@@ Line 92: / Line 94: @@
 . 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.
+Tapez [https://www.raspberrypi.org/documentation/remote-access/ip-address.md l'adresse IP] de la Raspberry Pi (si vous êtes sur Windows ou android) ou zynthian.local (sur MacOS and iOS) dans VNC Viewer.  Sur une tablette, il faut aller dans "Address Book" puis cliquer sur le + (en haut à droite sur iOS, en bas à droite sur Android) pour rajouter la Zynthian.
   Nom d'utilisateur : root
   Mot de passe : raspberry
@@ Line 98: / Line 100: @@
 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 :
+Pour une utilisation optimum, configurez l'interface Zynthian pour une utilisation headless via le WebConf :
   [http://zynthian.local/ui-options Interface / UI options ]
   Advanced view : ON
@@ Line 104: / Line 106: @@
   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.
+Sur scène, vous pouvez vous déconnecter d'internet et configurer la Raspberry comme un émetteur Wifi afin d'y connecter vos appareils.
 Pour cela, allez dans le WebConf:
   [http://zynthian.local/sys-wifi System / WIFI] / Hotspot
-* Voici un tutoriel vidéo en français concernant la prise en main de l'interface Zynthian UI :
+Note : sur Android, le système va automatiquement se connecter au réseau qui capte le mieux Internet. Il faut donc aller dans les paramètres et désactiver les options suivantes : “Auto Network Switch” (options avancées) et « connexion automatique » sur les réseaux déjà enregistrés. Cela peut nécessiter de redémarrer votre téléphone.
+* Voici un tutoriel vidéo de Benoit Bouchez en français concernant la prise en main de l'interface Zynthian UI :
 https://www.youtube.com/watch?v=4jb-8cQQQgQ
 * Et bien sur le [https://wiki.zynthian.org/index.php/Zynthian_UI_Users_Guide manuel] !
@@ Line 127: / Line 131: @@
 === 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 [https://wiki.zynthian.org/index.php/Configuration_Users_Guide manuel]). Mais dans certains cas, il est nécessaire d'accéder directement 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 :
+La meilleur manière de charger des patchs, des presets, des soundfonts etc. est via le WebConf (lisez le [https://wiki.zynthian.org/index.php/Configuration_Users_Guide manuel]). Mais dans certains cas, il est nécessaire d'accéder directement aux dossiers (peu recommandé pour les débutants). Vous pouvez le faire en SSH via le terminal si vous connaissez les [http://www.epingle.info/?p=3178 commandes de base du shell UNIX]. Mais si vous préférez y accéder graphiquement comme si vous étiez sur le gestionnaire de fichiers (finder ou explorer) de votre ordinateur, voici la procédure :
 . Installez un client SFPT sur votre ordinateur :
@@ Line 133: / Line 137: @@
 * Sur Windows: [https://www.putty.org/ PuTTy]
 . Ouvrez une connexion SFPT :
-  Serveur : zynthian.local (MacOS) ou Address IP (Windows)
+  Serveur : zynthian.local (MacOS) ou Adresse IP (Windows)
   Utilisateur : root
   Mot de passe : raspberry
 . 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