Contrôlez votre Raspberry Pi à distance à l'aide de PiControl

PiControl de PiCockpit est une fonction puissante qui vous permet de contrôler votre Raspberry Pi à distance à partir de n'importe quel navigateur Web, en cliquant simplement sur des boutons.

Vous verrez l'état et la sortie de la commande.

De nouvelles commandes peuvent être ajoutées en modifiant simplement un fichier JSON sur votre Raspberry Pi.

Dans cet article, nous allons vous montrer comment le faire, et vous donner quelques idées de ce que vous pouvez construire en utilisant PiControl !

À quoi cela ressemble-t-il ?

Vous remarquerez que, par défaut, trois commandes sont incluses et immédiatement disponibles pour votre Raspberry Pi : éteindre, redémarrer, mettre à jour le client.

Que puis-je faire avec un Raspberry Pi et PiControl ?

Voici quelques éléments que vous pouvez construire avec lui. Ces idées nécessiteront quelques recherches, et éventuellement des connaissances en matière de codage et/ou de matériel de votre part. Dans tous les cas, le PiControl de PiCockpit vous aidera à réaliser la partie interface web facile à utiliser de votre projet et vous fera gagner beaucoup de temps pour faire fonctionner le tout sur Internet 🙂 ...

• prendre un cliché à l'aide du module caméra de Raspberry Pi et le recevoir par la poste
• démarrer votre serveur Minecraft Raspberry Pi, et l'arrêter également
• Lisez une vidéo en utilisant omxplayer (vous pouvez également configurer une boucle infinie pour la vidéo, et arrêter la boucle vidéo si vous voulez passer à une autre vidéo)
• créer un contrôle facile pour une caméra d'animation stop-motion, en utilisant le module caméra du Raspberry Pi
• réveiller un ordinateur local dans le même réseau que votre Raspberry Pi avec la fonctionnalité Wake on LAN (réveil sur le réseau local)
• jouer un son (comme une farce pour Halloween, par exemple)
• ouvrir une porte, par exemple une porte de garage, en envoyant des commandes appropriées via Z-Wave, etc.
• démarrer le service SSH sur votre Raspberry Pi, puis l'arrêter - une approche "frapper pour ouvrir" pour une meilleure sécurité
• contrôler les trains miniatures
• allumer et éteindre un relais (nécessite deux boutons, ou peut être fait en utilisant un bouton "toggle")
• commander le téléviseur (changer de chaîne, modifier le volume, ...) à l'aide d'une LED IR, par exemple pour simuler une activité pendant que vous êtes en voyage.
• Lancer une fusée à partir de l'interface web

Nous publierons des instructions étape par étape pour certaines de ces idées de projets, afin que vous disposiez d'un guide facile pour démarrer avec PiControl et contrôler à distance votre Raspberry Pi.

Comment puis-je ajouter des boutons de commande à distance supplémentaires pour le Raspberry Pi avec PiControl ?

Vous pouvez facilement et en toute sécurité définir vos propres commandes, en éditant simplement des fichiers JSON sur votre Raspberry Pi. Ceci est fait pour des raisons de sécurité - j'aurais pu écrire PiCockpit de manière à vous permettre d'ajouter des commandes depuis l'interface web, mais si quelqu'un connaissait votre mot de passe PiCockpit, il pourrait créer n'importe quelle commande qu'il souhaiterait. Par conséquent, veuillez suivre ces instructions simples pour créer un nouveau fichier JSON sur votre Pi.

Remarque : ces instructions sont délibérément rédigées de manière à ce que les utilisateurs qui n'ont pas d'expérience de la ligne de commande puissent les suivre. Si vous savez comment utiliser la ligne de commande, vous trouverez peut-être plus facile/rapide de simplement créer le fichier et de l'éditer avec nano.

Tout d'abord, vous devez ouvrir le navigateur de fichiers en mode super utilisateur (cette étape permet de protéger les fichiers de configuration du PiCockpit PiControl contre tout utilisateur ou application souhaitant les modifier). Cliquez sur le menu Raspberry Pi OS, et ici cliquez sur la commande "Run ..." :

Exécutez pcmanfm en tant que root (sudo pcmanfm) en tapant "sudo pcmanfm" (sans les guillemets) dans la boîte de dialogue qui s'ouvre, puis cliquez sur OK :

Une nouvelle fenêtre s'ouvre, vous montrant le contenu du répertoire /home/pi :

Note : vous devriez voir cette icône, juste sous le menu "File". Elle indique que vous utilisez pcmanfm en tant qu'utilisateur root, et que vous devez donc être très prudent (puisque root peut modifier / supprimer / déplacer n'importe quel fichier ! même les fichiers qui sont critiques pour le fonctionnement normal du système).

Pas d'inquiétude, nous ne toucherons que les fichiers dont vous avez besoin ici 🙂 .

Ouvrez le répertoire suivant sur votre Raspberry Pi :

/etc/picockpit-client/apps/com.picockpit/picontrol/modules

Astuce : vous pouvez également copier et coller le chemin que j'ai donné ci-dessus, et appuyer sur la touche entrée pour naviguer dans le répertoire.

Les conseils utiles de Raspi Berry sur les Raspberry Pi

cliquez avec le bouton droit de la souris dans la zone vide à côté des fichiers existants, et sélectionnez "Nouveau fichier...".

Appelez le nouveau fichier ssh-server.json :

Vous devez maintenant cliquer avec le bouton droit de la souris sur le nouveau fichier, pour faire apparaître le menu contextuel. Choisissez "Geany" :

Vous pouvez maintenant voir le nouveau fichier que nous venons de créer. Cependant, pour le moment, il est vide.

Créons deux nouvelles commandes, une pour arrêter le service du serveur SSH, et une pour le démarrer. Entrez ce qui suit dans le champ de texte que Geany vous présente :

{
  "name": "SSH commands",
  "icon": "mdi-ssh",
  "handle": "ssh",
  "description": "Control the SSH server",
  "commands": {
    "ssh-stop": {
      "name": "SSH Server off",
      "icon": "mdi-server-minus",
      "description": "Shuts the SSH service down",
      "confirm": true,
      "user": "root",
      "command": ["service", "ssh", "stop"]
    },
    "ssh-start": {
      "name": "SSH Server on",
      "icon": "mdi-server-plus",
      "description": "Starts the SSH service",
      "user": "root",
      "command": ["service", "ssh", "start"]
    }
  }
}

A ce stade, nous devons enregistrer le fichier. Vous pouvez le faire à partir du menu fichier de Geany, par exemple, en sélectionnant Enregistrer. (Ou utilisez Ctrl + S) :

A ce stade, nos nouvelles commandes ne sont pas encore apparues dans l'interface web. Pour cela, il faut redémarrer picockpit-client. Cliquez sur la commande "Run ..." dans le menu du Raspberry Pi OS, et tapez "sudo service picockpit-client restart"dans la fenêtre avant de cliquer sur OK :

Jetez maintenant un coup d'oeil à l'interface web de votre PiControl :

Si vous avez tout tapé correctement, les nouvelles commandes apparaîtront. Si vous avez fait une erreur dans votre fichier JSON (par exemple, vous avez oublié une accolade), PiCockpit ignorera simplement le fichier "cassé".

Vous pouvez maintenant essayer les commandes. Si vous cliquez sur le bouton SSH SERVER OFF, il vous sera demandé si vous voulez vraiment exécuter la commande. Cliquez ici aussi sur ssh server off pour exécuter la commande (ou cliquez sur cancel si vous ne voulez pas l'exécuter).

PiCockpit va maintenant exécuter la commande, vous verrez des informations sur la progression - et une fois l'exécution terminée, vous verrez l'indicateur de succès suivant :

Si vous essayez de vous connecter à votre Pi maintenant en utilisant SSH, la connexion sera refusée :

Redémarrez le serveur SSH en cliquant sur "SSH SERVER ON". Maintenant une connexion sera à nouveau possible.

Félicitations ! Vous venez de créer votre propre ensemble de commandes que vous pouvez exécuter à partir de l'interface web.

Restez sur la page pendant que vous exécutez les commandes - l'état sera actuellement effacé si vous naviguez ailleurs. Pour déterminer si le serveur SSH est en cours d'exécution, vous pouvez construire un test PiDoctor - PiControl sert simplement à exécuter des actions à distance sur votre Pi.

Les conseils utiles de Raspi Berry concernant Raspberry Pi (et PiCockpit)

N'oubliez pas de redémarrer le picockpit-client lorsque vous ajoutez de nouvelles commandes ou que vous mettez à jour des commandes. Vous pouvez également supprimer les commandes que vous ne souhaitez pas avoir, par exemple si vous voulez supprimer la possibilité d'éteindre votre Raspberry Pi à distance.

Explication de la syntaxe de la commande à distance

Ce fichier configure un nouveau module pour PiControl. Il a une syntaxe .JSON, veuillez vous assurer que vous ouvrez et terminez par des accolades de manière correcte, comme présenté dans mon exemple.

Il y a une tête, qui configure le module lui-même, et les commandes (dans la partie "commandes"). Elles partagent certaines entrées communes :

nom

Les entrées "nom" sont des noms lisibles par l'homme qui vous sont montrés dans l'interface web.

icône

Les entrées "icon" sont facultatives pour décorer vos boutons et votre module. Il s'agit de noms d'icônes Material Design, par exemple "mdi-ssh".

Vous pouvez consulter un Liste complète des icônes Material Design ici. Il suffit de copier le nom de l'icône (y compris le mdi- au début).

Les conseils utiles de Raspi Berry concernant Raspberry Pi (et PiCockpit)

description

Les entrées "description" sont facultatives et vous permettent d'ajouter un peu plus d'informations sur la commande ou le module.

poignée

L'entrée "handle" est explicite pour le module, et doit être unique parmi les modules. Dans le cas des commandes, le handle est implicite. "ssh-stop" et "ssh-start"sont les deux poignées que j'ai utilisées pour les commandes dans mon exemple.

Vous pouvez choisir n'importe quoi comme poignée, tant que cela ne comprend pas les caractères "/", "+", "$", "*". Je recommande de s'en tenir aux caractères ASCII minuscules de base, et d'utiliser le "-". L'identifiant est requis.

Votre fichier peut d'ailleurs avoir un nom différent de celui de l'identifiant. Je vous encourage à utiliser au moins des noms apparentés pour le nom du fichier et l'identifiant, afin de pouvoir identifier facilement le fichier .JSON du module sur votre disque dur.

Les conseils utiles de Raspi Berry concernant Raspberry Pi (et PiCockpit)

Les commandes sont placées dans la section "commandes"et offrent des possibilités de configuration supplémentaires :

confirmer

Si "confirmer" est présent et défini à true, l'interface web PiControl affichera une boîte de dialogue de confirmation avant d'exécuter la commande. Ceci est utile pour s'assurer que les commandes "dangereuses" ne sont pas exécutées par un tapotement ou un clic accidentel.

utilisateur

Si "utilisateur" est présent, la commande sera exécutée en tant qu'utilisateur particulier (en tant que racine dans notre exemple, pour s'assurer que nous disposons de privilèges suffisants).

PiControl exécutera les commandes en tant qu'utilisateur "pi"par défaut. Vous pouvez également le définir sur d'autres utilisateurs ayant moins de privilèges que "pi“.

Si vous essayez d'exécuter des commandes GPIO, ou de lire des vidéos à l'aide d'omxplayer, vous devrez peut-être donner à votre nouvel utilisateur des capacités supplémentaires. L'utilisateur pi possède ces privilèges par défaut. Habituellement, ces privilèges sont définis en ajoutant l'utilisateur à un groupe spécial.

Les conseils utiles de Raspi Berry concernant Raspberry Pi (et PiCockpit)

commande

Voici la commande que vous devez exécuter sur votre Raspberry Pi. Notez que vous devez remplacer les espaces dans la commande comparée à comme vous le feriez sur la ligne de commande. Par exemple,

service ssh start

devrait être écrit comme suit :

["service", "ssh", "start"]

PiControl prend également en charge le chaînage d'une séquence de commandes (par exemple, la séquence habituelle apt-get update, apt-get upgrade). Consultez le fichier core.json pour un exemple de la façon dont cela est fait.

Les conseils utiles de Raspi Berry concernant Raspberry Pi (et PiCockpit)

Conclusion : PiControl pour vos besoins en télécommande de Raspberry Pi

En utilisant PiCockpit et PiControl, il est très facile d'ajouter n'importe quelle commande à distance que vous souhaitez exécuter sur votre Raspi, et de pouvoir contrôler votre Pi depuis une interface web. Pour que cela fonctionne, le Raspberry Pi a seulement besoin d'une connexion Internet. vous n'avez pas besoin d'être dans le même réseau.

Qu'aimeriez-vous construire en utilisant PiCockpit et PiControl ? Commentez ci-dessous, et j'essaierai de vous aider à réaliser votre projet 🙂 .

Un grand pouvoir implique une grande responsabilité - faites attention à qui vous donnez accès à votre interface PiCockpit, gardez votre mot de passe et vos clés API en sécurité. Veillez également à "protéger" les commandes dangereuses, comme indiqué ci-dessus, afin qu'elles ne soient pas exécutées en cliquant accidentellement dessus.

Les conseils utiles de Raspi Berry concernant Raspberry Pi (et PiCockpit)