Filtrage robuste de port série Python Linux par nom et fabricant en utilisant udev

udev_info_example.py
    {
        'serial': '01010A23535223934CF29A1EF5000007',
        'vendor_id': '1d50',
        'usb_model': 'Marlin USB Device',
        'usb_model_id': '6029',
        'usb_vendor':
        'marlinfw.org',
        'vendor': 'OpenMoko, Inc.',
        'model': 'Marlin 2.0 (Serial)'
    }

    ```

ou allez directement au codage en dur du port tel que `/dev/ttyACM0`.

Il devrait être assez évident pourquoi ceci n'est pas robuste :
* Il pourrait y avoir plusieurs ports série et l'ordre est inconnu
* Votre code pourrait avoir besoin de fonctionner sur différents ordinateurs, ce qui conduit à différents ports étant assignés
* Quand vous rebranchez un appareil, il pourrait se voir assigner un numéro de port série différent (par ex. `/dev/ttyACM1`)


Le code suivant utilise seulement l'outil intégré linux `udevadm` pour requêter des informations et des bibliothèques intégrées. **Actuellement, cela ne fonctionne que sur Linux.**

```python {filename="udev_serial_utils.py"}
import glob
import subprocess
import re

def get_serial_ports():
    # Obtient une liste des appareils /dev/ttyACM* et /dev/ttyUSB*
    ports = glob.glob('/dev/ttyACM*') + glob.glob('/dev/ttyUSB*')
    return ports

def get_udev_info(port):
    # Exécute la commande udevadm et obtient la sortie
    result = subprocess.run(['udevadm', 'info', '-q', 'all', '-r', '-n', port], capture_output=True, text=True)
    return result.stdout

def find_serial_ports(vendor=None, model=None, usb_vendor=None, usb_model=None, usb_model_id=None, vendor_id=None):
    # Mapping des noms lisibles par l'humain vers les clés udevadm
    attribute_mapping = {
        "vendor": "ID_VENDOR_FROM_DATABASE",
        "model": "ID_MODEL_FROM_DATABASE",
        "usb_vendor": "ID_USB_VENDOR",
        "usb_model": "ID_USB_MODEL_ENC",
        "usb_model_id": "ID_USB_MODEL_ID",
        "vendor_id": "ID_VENDOR_ID",
        "usb_path": "ID_PATH",
        "serial": "ID_SERIAL_SHORT"
    }

    # Filtres basés sur les arguments fournis
    filters = {}
    for key, value in locals().items():
        if value and key in attribute_mapping:
            filters[attribute_mapping[key]] = value

    # Trouve et filtre les ports
    ports = get_serial_ports()
    filtered_ports = []

    for port in ports:
        udev_info = get_udev_info(port)
        match = True

        for key, value in filters.items():
            if not re.search(f"{key}={re.escape(value)}", udev_info):
                match = False
                break

        if match:
            filtered_ports.append(port)

    return filtered_ports

def get_serial_port_info(port):
    # Mapping des clés udevadm vers les noms lisibles par l'humain
    attribute_mapping = {
        "ID_VENDOR_FROM_DATABASE": "vendor",
        "ID_MODEL_FROM_DATABASE": "model",
        "ID_USB_VENDOR": "usb_vendor",
        "ID_USB_MODEL_ENC": "usb_model",
        "ID_USB_MODEL_ID": "usb_model_id",
        "ID_VENDOR_ID": "vendor_id",
        "ID_SERIAL_SHORT": "serial",
    }

    # Exécute la commande udevadm et obtient la sortie
    udev_info = get_udev_info(port)
    port_info = {}

    for line in udev_info.splitlines():
        if line.startswith('E: '):
            key, value = line[3:].split('=', 1)
            if key in attribute_mapping:
                # Décode les séquences d'échappement comme \x20 en espace.
                # NOTE : Puisque seul \x20 est commun, nous remplaçons actuellement seulement celui-là
                port_info[attribute_mapping[key]] = value.replace('\\x20', ' ')

    return port_info

def find_serial_port(**kwargs):
    """
    Trouve un seul port série correspondant aux filtres fournis.
    """
    ports = find_serial_ports(**kwargs)
    if len(ports) > 1:
        raise ValueError("Plusieurs ports correspondants trouvés pour les filtres : " + str(kwargs))
    elif len(ports) == 0:
        raise ValueError("Aucun port correspondant trouvé pour les filtres : " + str(kwargs))
    else:
        return ports[0]

Exemple : Trouver un port série

find_serial_example.py
# Exemple d'utilisation : Trouver un port série
matching_ports = find_serial_ports(vendor="OpenMoko, Inc.")
print(matching_ports) # Affiche par ex. ['/dev/ttyACM0']

Exemple : Afficher des informations sur un port donné

Ceci est typiquement utilisé pour que vous sachiez quels filtres ajouter pour find_serial_ports().

print_port_info_example.py
# Exemple d'utilisation : Afficher des infos sur un port série
serial_port_info = get_serial_port_info('/dev/ttyACM0')
print(serial_port_info)

Ceci affiche, par exemple :

serial_port_info_output.py
{
    'serial': '01010A23535223934CF29A1EF5000007',
    'vendor_id': '1d50',
    'usb_model': 'Marlin USB Device',
    'usb_model_id': '6029',
    'usb_vendor':
    'marlinfw.org',
    'vendor': 'OpenMoko, Inc.',
    'model': 'Marlin 2.0 (Serial)'
}

Consultez les articles similaires par catégorie : Electronics Linux