gilles/pilot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
6c4c6ee866f891dc59d499b7c97aa48c720948a8
pilot/docs/analyse_v1.md
Gilles Soulier c5381b7112 Pilot v2: Core implementation + battery telemetry 
Major updates:
- Complete Rust rewrite (pilot-v2/) with working MQTT client
- Fixed MQTT event loop deadlock (background task pattern)
- Battery telemetry for Linux (auto-detected via /sys/class/power_supply)
- Home Assistant auto-discovery for all sensors and switches
- Comprehensive documentation (AVANCEMENT.md, CLAUDE.md, roadmap)
- Docker test environment with Mosquitto broker
- Helper scripts for development and testing

Features working:
✅ MQTT connectivity with LWT
✅ YAML configuration with validation
✅ Telemetry: CPU, memory, IP, battery (Linux)
✅ Commands: shutdown, reboot, sleep, screen (dry-run tested)
✅ HA discovery and integration
✅ Allowlist and cooldown protection

Ready for testing on real hardware.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-30 06:23:00 +01:00

2.8 KiB
Raw Blame History

Analyse v1 (etat des lieux)

Objectif

  • Agent MQTT de pilotage PC pour Home Assistant.
  • Publie des capteurs (CPU, RAM, batterie, GPU, IP) et expose des commandes (shutdown, reboot, ecran, frequence CPU).

Technologies et dependances

  • Python 3
  • paho-mqtt
  • psutil
  • pynvml (GPU, selon variante)
  • systemd (service Linux)

Points d'entree / scripts

  • main.py : variante desktop + GPU temp/memoire, shutdown.
  • main_prog.py : variante laptop (Lenovo), shutdown/reboot/ecran/freq CPU + telemetrie + slider.
  • main-lenovo-bureau.py : variante desktop (CPU/RAM), shutdown.
  • mqtt_unvai.py : publie availability=offline puis se termine.
  • mqtt_pilot.service : service systemd pointant vers main_prog.py.

MQTT (topics et payloads)

Les topics sont hardcodes et varient selon le script.

Variante main_prog.py (device_name = yoga14)

  • Discovery: homeassistant/<component>/yoga14/<entity>/config (retain=true)
  • Commandes:
    • pilot/yoga14/shutdown/set payload OFF -> shutdown
    • pilot/yoga14/reboot/set payload OFF -> reboot
    • pilot/yoga14/screen/set payload ON/OFF -> busctl (GNOME)
    • pilot/yoga14/cpu_frequency_slider/set payload float GHz -> write /sys
  • States: pilot/yoga14/<entity>/state (retain=true)
  • Availability: pilot/yoga14/<entity>/available (retain=true)

Variante main.py / main-lenovo-bureau.py (hostname dynamique)

  • Discovery: homeassistant/<component>/<hostname>/<entity>/config (retain=true)
  • Commandes:
    • pilot/<hostname>/shutdown/available payload OFF -> shutdown
  • States: pilot/<hostname>/<sensor> (retain=true)
  • Availability: pilot/<hostname>/<sensor>/available (retain=true)

Auth/TLS/LWT: Non trouve (pas de TLS ni LWT, username/password vides).

Commandes systeme

  • Shutdown : sudo shutdown -h now
  • Reboot : sudo reboot
  • Ecran : busctl --user set-property ... PowerSaveMode i 1/0
  • Frequence CPU : ecriture /sys/devices/system/cpu/cpu0/cpufreq/scaling_setspeed

Service systemd

  • Fichier: mqtt_pilot.service
  • ExecStart: /home/gilles/pilot/monenv/bin/python3 /home/gilles/pilot/main_prog.py
  • Restart: on-failure
  • ExecStopPost: mqtt_unvai.py (publie offline)

Config

  • Hardcode dans les scripts (broker, topics, device_name, intervals).
  • Pas de .env ou YAML.

Points faibles

  • Securite: pas d'auth/TLS, commandes privilegiees, pas d'allowlist.
  • Config: hardcodee, duplication entre scripts.
  • MQTT: pas de LWT, pas de QoS explicite, pas de schema de payload formalise.
  • Observabilite: logs stdout simples, pas de tests.

Ce que la v2 doit corriger

  • Contrat MQTT unique et documente.
  • Config YAML centralisee.
  • Auth/TLS optionnel, allowlist et validation des payloads.
  • LWT + status + capabilities.
  • Separation Linux/Windows avec backends.
Reference in New Issue View Git Blame Copy Permalink