210 lines
5.4 KiB
Markdown
210 lines
5.4 KiB
Markdown
# Comment lancer l'extension Pilot Control
|
|
|
|
## ✅ L'extension est installée et corrigée !
|
|
|
|
L'extension a été mise à jour pour supporter GNOME Shell 48.
|
|
|
|
## 🚀 Étapes pour utiliser l'extension
|
|
|
|
### 1. Redémarrer GNOME Shell
|
|
|
|
**Sur X11 (recommandé si vous êtes sur X11) :**
|
|
```bash
|
|
# Méthode 1 : Via le dialogue "Exécuter"
|
|
# Appuyez sur Alt+F2
|
|
# Tapez : r
|
|
# Appuyez sur Entrée
|
|
```
|
|
|
|
**Sur Wayland :**
|
|
```bash
|
|
# Déconnectez-vous et reconnectez-vous
|
|
# Ou redémarrez votre session
|
|
```
|
|
|
|
**Alternative - Redémarrer complètement :**
|
|
```bash
|
|
# Si les méthodes ci-dessus ne fonctionnent pas
|
|
sudo systemctl restart gdm
|
|
# Ou redémarrez l'ordinateur
|
|
```
|
|
|
|
### 2. Vérifier que l'extension est activée
|
|
|
|
```bash
|
|
# Vérifier le statut
|
|
gnome-extensions list --enabled | grep pilot
|
|
|
|
# Si elle n'est pas activée, l'activer :
|
|
gnome-extensions enable pilot-control@gnome-shell-extensions
|
|
```
|
|
|
|
### 3. Localiser l'icône dans le panel
|
|
|
|
Après le redémarrage de GNOME Shell, vous devriez voir :
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────┐
|
|
│ [WiFi] [Volume] [🖥️ Computer] [Power] [Clock] │
|
|
│ ↑ │
|
|
│ └─ Icône Pilot Control │
|
|
└─────────────────────────────────────────────────┘
|
|
```
|
|
|
|
L'icône ressemble à un **ordinateur** (computer-symbolic).
|
|
|
|
### 4. Utiliser l'extension
|
|
|
|
**Option 1 : Menu rapide**
|
|
1. Cliquez sur l'icône d'ordinateur
|
|
2. Vous verrez le menu :
|
|
```
|
|
Status: 🟢 Running (ou 🔴 Stopped)
|
|
──────────────────────
|
|
Open Control Panel
|
|
──────────────────────
|
|
Start Service
|
|
Stop Service
|
|
Restart Service
|
|
──────────────────────
|
|
Reload Config
|
|
```
|
|
|
|
**Option 2 : Fenêtre complète**
|
|
1. Cliquez sur l'icône
|
|
2. Cliquez sur "Open Control Panel"
|
|
3. La fenêtre principale s'ouvre avec 3 sections :
|
|
- **Service Control** : Gérer le service
|
|
- **Telemetry Metrics** : Gérer les métriques
|
|
- **Commands** : Gérer les commandes autorisées
|
|
|
|
## 🔍 Dépannage
|
|
|
|
### L'icône n'apparaît pas
|
|
|
|
```bash
|
|
# 1. Vérifier que l'extension est bien installée
|
|
ls ~/.local/share/gnome-shell/extensions/pilot-control@gnome-shell-extensions/
|
|
|
|
# 2. Vérifier qu'elle est activée
|
|
gnome-extensions list --enabled | grep pilot
|
|
|
|
# 3. Regarder les logs
|
|
journalctl --since "5 minutes ago" -o cat | grep -i pilot
|
|
|
|
# 4. Réinstaller l'extension
|
|
cd /home/gilles/app/pilot/gnome-pilot-extension
|
|
./install.sh
|
|
|
|
# 5. Redémarrer GNOME Shell (Alt+F2, 'r')
|
|
```
|
|
|
|
### Message "Extension had error"
|
|
|
|
```bash
|
|
# Voir les erreurs détaillées
|
|
journalctl -f -o cat /usr/bin/gnome-shell | grep -i pilot
|
|
|
|
# Ou utiliser Looking Glass (debugger GNOME)
|
|
# Alt+F2, tapez 'lg', regardez l'onglet "Errors"
|
|
```
|
|
|
|
### L'extension se charge mais rien ne se passe
|
|
|
|
```bash
|
|
# Vérifier que le service Pilot existe
|
|
systemctl --user status mqtt_pilot.service
|
|
|
|
# Vérifier que le config.yaml existe
|
|
cat ~/app/pilot/pilot-v2/config.yaml
|
|
|
|
# Tester manuellement l'extension
|
|
dbus-run-session -- gnome-shell --replace 2>&1 | grep -i pilot
|
|
```
|
|
|
|
## 📝 Actions courantes
|
|
|
|
### Activer/désactiver une métrique
|
|
|
|
1. Ouvrir le Control Panel
|
|
2. Section "Telemetry Metrics"
|
|
3. Utiliser le switch à côté de la métrique
|
|
4. Cliquer sur [💾] Save (en haut à droite)
|
|
5. Le service redémarre automatiquement
|
|
|
|
### Modifier l'intervalle d'une métrique
|
|
|
|
1. Ouvrir le Control Panel
|
|
2. Section "Telemetry Metrics"
|
|
3. Cliquer sur [...] à côté de la métrique
|
|
4. Modifier "Update Interval (seconds)"
|
|
5. Cliquer "Save" dans le dialogue
|
|
6. Cliquer [💾] Save dans la fenêtre principale
|
|
|
|
### Gérer les commandes autorisées
|
|
|
|
1. Ouvrir le Control Panel
|
|
2. Section "Commands"
|
|
3. Cliquer sur "Allowed Commands"
|
|
4. Cocher/décocher les commandes (shutdown, reboot, etc.)
|
|
5. Cliquer "Save" dans le dialogue
|
|
6. Cliquer [💾] Save dans la fenêtre principale
|
|
|
|
### Redémarrer le service Pilot
|
|
|
|
**Méthode rapide :**
|
|
1. Cliquer sur l'icône
|
|
2. Cliquer sur "Restart Service"
|
|
|
|
**Méthode complète :**
|
|
1. Ouvrir le Control Panel
|
|
2. Section "Service Control"
|
|
3. Cliquer sur le bouton "Restart"
|
|
|
|
## 🧪 Tester que tout fonctionne
|
|
|
|
```bash
|
|
# Script de test complet
|
|
cd /home/gilles/app/pilot/gnome-pilot-extension
|
|
./test.sh
|
|
|
|
# Vérifier manuellement
|
|
# 1. L'extension est activée
|
|
gnome-extensions list --enabled | grep pilot
|
|
|
|
# 2. Le service Pilot tourne
|
|
systemctl --user is-active mqtt_pilot.service
|
|
|
|
# 3. Le config.yaml est accessible
|
|
ls -l ~/app/pilot/pilot-v2/config.yaml
|
|
|
|
# 4. Les logs ne montrent pas d'erreur
|
|
journalctl --since "10 minutes ago" -o cat | grep -i "pilot.*error"
|
|
```
|
|
|
|
## 📖 Plus d'aide
|
|
|
|
- **README complet** : [README.md](README.md)
|
|
- **Guide débutant** : [GUIDE_DEBUTANT.md](GUIDE_DEBUTANT.md)
|
|
- **Architecture** : [STRUCTURE.md](STRUCTURE.md)
|
|
|
|
## 🎯 Résumé rapide
|
|
|
|
```bash
|
|
# 1. Redémarrer GNOME Shell (Alt+F2, 'r')
|
|
|
|
# 2. Chercher l'icône d'ordinateur en haut à droite
|
|
|
|
# 3. Cliquer dessus → "Open Control Panel"
|
|
|
|
# 4. Modifier vos paramètres
|
|
|
|
# 5. Cliquer sur [💾] Save
|
|
|
|
# 6. C'est tout ! Le service redémarre automatiquement
|
|
```
|
|
|
|
---
|
|
|
|
**Note importante :** L'extension a été corrigée pour supporter GNOME Shell 48. Elle devrait maintenant fonctionner correctement après un redémarrage de GNOME Shell.
|