Robust Linux Python serial port filtering por name y manufacturer usando 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)'
    }

    ```

o solo ve a hard-coding directo del puerto como `/dev/ttyACM0`.

Debería ser bastante obvio por que esto no es robusto:
* Podría haber múltiples puertos serie y el orden es desconocido
* Tu código podría necesitar funcionar en diferentes computadoras, lo cual lleva a que se asignen diferentes puertos
* Cuando vuelves a conectar un dispositivo, podría asignársele un número diferente de puerto serie (p. ej. `/dev/ttyACM1`)


El siguiente código usa solo la herramienta integrada de linux `udevadm` para consultar información y bibliotecas integradas. **Actualmente no funciona en nada excepto Linux.**

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

def get_serial_ports():
    # Obtener una lista de dispositivos /dev/ttyACM* y /dev/ttyUSB*
    ports = glob.glob('/dev/ttyACM*') + glob.glob('/dev/ttyUSB*')
    return ports

def get_udev_info(port):
    # Ejecutar el comando udevadm y obtener la salida
    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):
    # Mapeo de nombres legibles por humanos a claves 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"
    }

    # Filtros basados en los argumentos proporcionados
    filters = {}
    for key, value in locals().items():
        if value and key in attribute_mapping:
            filters[attribute_mapping[key]] = value

    # Encontrar y filtrar puertos
    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):
    # Mapeo de claves udevadm a nombres legibles por humanos
    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",
    }

    # Ejecutar el comando udevadm y obtener la salida
    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:
                # Decodificar secuencias de escape como \x20 a un espacio.
                # NOTA: Ya que solo \x20 es común, actualmente solo reemplazamos ese
                port_info[attribute_mapping[key]] = value.replace('\\x20', ' ')

    return port_info

def find_serial_port(**kwargs):
    """
    Encuentra un único puerto serie que coincida con los filtros proporcionados.
    """
    ports = find_serial_ports(**kwargs)
    if len(ports) > 1:
        raise ValueError("Múltiples puertos coincidentes encontrados para los filtros: " + str(kwargs))
    elif len(ports) == 0:
        raise ValueError("No se encontraron puertos coincidentes para los filtros: " + str(kwargs))
    else:
        return ports[0]

Ejemplo: Encontrar un puerto serie

find_serial_example.py
# Ejemplo de uso: Encontrar un puerto serie
matching_ports = find_serial_ports(vendor="OpenMoko, Inc.")
print(matching_ports) # Imprime p. ej. ['/dev/ttyACM0']

Ejemplo: Imprimir información sobre un puerto dado

Esto es típicamente usado para que sepas qué filtros añadir para find_serial_ports().

print_port_info_example.py
# Ejemplo de uso: Imprimir información sobre un puerto serie
serial_port_info = get_serial_port_info('/dev/ttyACM0')
print(serial_port_info)

Esto imprime, por ejemplo:

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)'
}

Echa un vistazo a artículos similares por categoría: Electronics Linux