Gestion du WI-FI & Hotspot via nmcli

🧾 Objectif général

Ce script Python permet de gérer les connexions Wi-Fi et de créer un point d’accès (Hotspot) en ligne de commande sur un système Linux. Il s’appuie sur les outils nmcli (de NetworkManager) et iwconfig pour :

Scanner les réseaux Wi-Fi disponibles
Obtenir des informations de connexion détaillées
Se connecter à un réseau Wi-Fi existant
Créer et configurer un hotspot local
Gérer les canaux Wi-Fi (bande 2.4 GHz)

🔧 Prérequis

Distribution Linux (Debian, Ubuntu, Raspberry Pi OS, etc.)
Interface Wi-Fi disponible (ex: wlan0)
Outils en ligne de commande installés :
- nmcli (NetworkManager)
- iwconfig (Wireless Tools)
Script lancé avec des droits suffisants (souvent sudo requis)

📚 Structure du script

🔁 `run_cmd(cmd)`

Exécute une commande shell, retourne la sortie standard. Affiche les erreurs sauf si ce sont des avertissements (Warning).

📶 `freq_to_channel(freq_ghz)`

Convertit une fréquence Wi-Fi (en GHz) en numéro de canal :

Utilise uniquement la bande 2.4 GHz (2412 à 2484 MHz)
Retourne None pour les autres bandes (ex: 5 GHz)

📊 `dbm_to_percent(dbm)`

Convertit une puissance du signal (en dBm) en pourcentage :

Linéaire entre -90 dBm (0%) et -30 dBm (100%)

🛰️ `get_wifi_info(interface="wlan0")`

Renvoie un dictionnaire contenant l’état de la connexion active:

SSID (nom du réseau)
Puissance du signal (en dBm et en %)
Fréquence (GHz)
Canal associé

📡 `get_wifi_list()`

Liste les réseaux Wi-Fi disponibles avec :

SSID
Qualité du signal (en %)
Résultat trié du plus fort au plus faible

🔥 `set_hotspot(ssid, password, ip=None, channel=6)`

Configure le mode point d’accès Wi-Fi (hotspot) avec :

ssid : nom du hotspot à créer
password : mot de passe WPA2
ip : IP locale pour le partage de connexion (ex: 192.168.4.1)
channel : canal Wi-Fi (par défaut : 6)

🌐 `connect_wifi(ssid, password, ip=None)`

Connexion à un réseau Wi-Fi existant :

Crée une nouvelle connexion au réseau nommé ssid
Configure l’adresse IP statique si souhaité

📌 Conseils pour le choix du canal en mode Hotspot

Choisir un bon canal Wi-Fi permet de limiter les interférences avec les autres réseaux et d’améliorer la qualité de la connexion.

📈 Méthode recommandée : scanner les réseaux voisins

Utilisez get_wifi_list() pour lister les réseaux et analyser ceux qui utilisent les canaux 1 à 14.

✅ Remarques et conseils

Canaux recommandés : 1, 6, 11
- Ce sont les seuls canaux non chevauchants en 2.4 GHz.
- Privilégier celui qui est le moins utilisé autour de vous.
Évitez un canal déjà saturé :
- Si get_wifi_list() retourne de nombreux réseaux sur le canal 6, essayez 1 ou 11.
Canal 14 est uniquement autorisé au Japon.
Bande 5 GHz non supportée dans ce script (ajustable).
Supprimer les connexions précédentes (nmcli con delete) pour éviter les conflits.
Toujours tester les fonctions sur un réseau de test avant déploiement.
Pour usage autonome (ex: robot, serveur portable), préférer une IP fixe pour le hotspot.
S’assurer que NetworkManager gère l’interface wlan0.

🔐 Sécurité

Le mot de passe Wi-Fi est transmis en clair dans la commande : évitez d’utiliser des mots de passe sensibles dans les scripts produits.
Le hotspot est configuré en WPA2-PSK par défaut (suffisant pour usage personnel).

🚀 Avantages

✅ Simple à intégrer dans un projet Python autonome (robot, IoT, serveur embarqué)
✅ Pas besoin d’interface graphique
✅ Permet la configuration complète d’un hotspot en quelques lignes

🧪 Exemples d’utilisation

1. Créer un hotspot sur le canal 1

Python

set_hotspot(ssid="MyRobot", password="12345678", ip="192.168.50.1", channel=1)

2. Se connecter à un réseau avec IP fixe

Python

connect_wifi(ssid="MyHome", password="mypass", ip="192.168.1.100")

3. Se connecter à un Raspberry Pi en mode hotspot avec RealVNC

Lorsque l’on utilise un Raspberry Pi sans écran, il est pratique de pouvoir y accéder à distance via une interface graphique. Si le Raspberry Pi est configuré en mode hotspot Wi-Fi (point d’accès), il peut créer son propre réseau Wi-Fi auquel on peut se connecter avec un ordinateur à l’aide de RealVNC.

Avant de commencer, il faut :

Avoir un Raspberry Pi configuré en mode hotspot Wi-Fi
Avoir installé et activé le serveur VNC sur le Raspberry Pi.
Avoir installé RealVNC Viewer sur l’ordinateur client (Windows, macOS ou Linux).
Connaître l’adresse IP locale du Raspberry Pi sur le réseau hotspot.

Connexion au réseau Wi-Fi créé par le Raspberry Pi

Sur l’ordinateur client (PC portable, etc.) :

Rechercher les réseaux Wi-Fi disponibles.
Se connecter à réseau hotspot avec le mot de passe correspondant.
Une fois connecté, l’ordinateur est sur le même réseau local que le Raspberry Pi.

Connexion avec RealVNC Viewer

Ouvrir RealVNC Viewer sur l’ordinateur client et saisir l’adresse ip du Raspberry. Appuyez sur Entrée. Une fenêtre de connexion s’ouvre.

Entrez le nom d’utilisateur et le mot de passe du Raspberry Pi.

Cliquer sur OK.

Le bureau du Raspberry Pi doit s’afficher à l’écran.

En cas d’erreur de certificat ou de message d’avertissement, accepter simplement pour établir la connexion.

Source du script

Python

import subprocess,re

def run_cmd(cmd):
    result = subprocess.run(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
    out = result.stdout.decode().strip()
    err = result.stderr.decode().strip()
    if err and "Warning" not in err:
        print(f"[CMD] {cmd}")
        print(f"[ERROR] {err}")
    return out

def freq_to_channel(freq_ghz):
    """Convertit une fréquence GHz en numéro de canal (2.4 GHz uniquement ici)."""
    freq_mhz = round(freq_ghz * 1000)
    if 2412 <= freq_mhz <= 2472:
        return (freq_mhz – 2407) // 5
    elif freq_mhz == 2484:
        return 14
    return None  # Hors 2.4 GHz

def dbm_to_percent(dbm):
    """Convertit le niveau de signal dBm en pourcentage (0 à 100)."""
    if dbm is None:
        return None
    # Clampé entre -90 et -30
    dbm = max(-90, min(-30, dbm))
    return int((dbm + 90) * 100 / 60)  # linéaire entre -90 (0%) et -30 (100%)

def get_wifi_info(interface="wlan0"):
    try:
        result = subprocess.check_output(["iwconfig", interface], stderr=subprocess.DEVNULL).decode()
    except subprocess.CalledProcessError:
        return None

    # SSID
    ssid_match = re.search(r'ESSID:"([^"]+)"', result)
    ssid = ssid_match.group(1) if ssid_match else None

    # Signal level (dBm)
    signal_match = re.search(r'Signal level=(-?\d+) dBm', result)
    signal_dbm = int(signal_match.group(1)) if signal_match else None
    signal_percent = dbm_to_percent(signal_dbm)

    # Fréquence
    freq_match = re.search(r'Frequency:(\d+\.\d+)', result)
    freq = float(freq_match.group(1)) if freq_match else None
    channel = freq_to_channel(freq) if freq else None

    return {
        "ssid": ssid,
        "signal_dbm": signal_dbm,
        "signal_percent": signal_percent,
        "frequency": freq,
        "channel": channel
    }

def get_wifi_list():
    run_cmd("nmcli device wifi rescan")
    output = run_cmd("nmcli -t -f SSID,SIGNAL device wifi list")
    wifi_list = []
    lines = output.strip().split("\n")
    for line in lines:
        if not line.strip():
            continue
        parts = line.split(":", 1)
        if len(parts) != 2:
            continue
        ssid, signal = parts
        ssid = ssid.strip()
        try:
            signal = int(signal.strip())
            if ssid:  
                wifi_list.append((ssid, signal))
        except ValueError:
            continue
    wifi_list.sort(key=lambda x: x[1], reverse=True)
    return wifi_list

def set_hotspot(ssid,password,ip=None,channel=6):
    run_cmd(f"nmcli con delete '{ssid}'")
    run_cmd(f"nmcli con add type wifi ifname wlan0 con-name '{ssid}' ssid '{ssid}'")
    run_cmd(f"nmcli con modify '{ssid}' 802-11-wireless.mode ap 802-11-wireless.band bg")
    run_cmd(f"nmcli con modify '{ssid}' 802-11-wireless.channel {channel}")  
    run_cmd(f"nmcli con modify '{ssid}' wifi-sec.key-mgmt wpa-psk wifi-sec.psk '{password}'")
    if ip!=None:
        run_cmd(f"nmcli con modify '{ssid}' ipv4.addresses {ip}/24")
        run_cmd(f"nmcli con modify '{ssid}' ipv4.method shared")
        run_cmd(f"nmcli con modify '{ssid}' ipv6.method ignore")
    run_cmd(f"nmcli con up '{ssid}'")

def connect_wifi(ssid, password, ip=None):
    run_cmd(f"nmcli con delete '{ssid}'")
    run_cmd(f"nmcli con add type wifi ifname wlan0 con-name '{ssid}' ssid '{ssid}'")
    run_cmd(f"nmcli con modify '{ssid}' wifi-sec.key-mgmt wpa-psk")
    run_cmd(f"nmcli con modify '{ssid}' wifi-sec.psk '{password}'")
    if ip!=None:
        gateway = ip.rsplit('.', 1)[0] + ".1"
        run_cmd(f"nmcli connection modify '{ssid}' ipv4.addresses {ip}/24")
        run_cmd(f"nmcli connection modify '{ssid}' ipv4.method manual")
        run_cmd(f"nmcli connection modify '{ssid}' ipv4.gateway {gateway}")
        run_cmd(f"nmcli connection modify '{ssid}' ipv4.dns 8.8.8.8")
    run_cmd(f"nmcli connection up '{ssid}'")

Grimeco

Gestion du WI-FI & Hotspot via nmcli

🧾 Objectif général

🔧 Prérequis

📚 Structure du script

🔁 `run_cmd(cmd)`

📶 `freq_to_channel(freq_ghz)`

📊 `dbm_to_percent(dbm)`

🛰️ `get_wifi_info(interface="wlan0")`

📡 `get_wifi_list()`

🔥 `set_hotspot(ssid, password, ip=None, channel=6)`

🌐 `connect_wifi(ssid, password, ip=None)`

📌 Conseils pour le choix du canal en mode Hotspot

📈 Méthode recommandée : scanner les réseaux voisins

✅ Remarques et conseils

🔐 Sécurité

🚀 Avantages

🧪 Exemples d’utilisation

1. Créer un hotspot sur le canal 1

2. Se connecter à un réseau avec IP fixe

3. Se connecter à un Raspberry Pi en mode hotspot avec RealVNC

Avant de commencer, il faut :

Connexion au réseau Wi-Fi créé par le Raspberry Pi

Connexion avec RealVNC Viewer

Source du script

A DECOUVRIR EGALEMENT

PTA 98 Guide Utilisateur & Développeur

🖥️ Démarrer automatiquement une application graphique Python au boot sur Raspberry Pi (méthode .desktop)

Tests de modèles d’IA

Laisser un commentaire Annuler la réponse

Gestion du WI-FI & Hotspot via nmcli

🧾 Objectif général

🔧 Prérequis

📚 Structure du script

🔁 run_cmd(cmd)

📶 freq_to_channel(freq_ghz)

📊 dbm_to_percent(dbm)

🛰️ get_wifi_info(interface="wlan0")

📡 get_wifi_list()

🔥 set_hotspot(ssid, password, ip=None, channel=6)

🌐 connect_wifi(ssid, password, ip=None)

📌 Conseils pour le choix du canal en mode Hotspot

📈 Méthode recommandée : scanner les réseaux voisins

✅ Remarques et conseils

🔐 Sécurité

🚀 Avantages

🧪 Exemples d’utilisation

1. Créer un hotspot sur le canal 1

2. Se connecter à un réseau avec IP fixe

3. Se connecter à un Raspberry Pi en mode hotspot avec RealVNC

Avant de commencer, il faut :

Connexion au réseau Wi-Fi créé par le Raspberry Pi

Connexion avec RealVNC Viewer

Source du script

A DECOUVRIR EGALEMENT

PTA 98 Guide Utilisateur & Développeur

🖥️ Démarrer automatiquement une application graphique Python au boot sur Raspberry Pi (méthode .desktop)

Tests de modèles d’IA

Laisser un commentaire Annuler la réponse

🔁 `run_cmd(cmd)`

📶 `freq_to_channel(freq_ghz)`

📊 `dbm_to_percent(dbm)`

🛰️ `get_wifi_info(interface="wlan0")`

📡 `get_wifi_list()`

🔥 `set_hotspot(ssid, password, ip=None, channel=6)`

🌐 `connect_wifi(ssid, password, ip=None)`