Résoudre un nom de couche en ID par script avec l'API Python de pcbnew

GetLayerID renvoie -1 si le nom n’est pas reconnu — silencieusement, sans lever d’exception. Autant l’envelopper dans une petite fonction qui échoue tout de suite :

def get_layer_id(board, layer_name):
    layer_id = board.GetLayerID(layer_name)
    if layer_id == -1:
        raise Exception(f"couche inconnue : {layer_name} (sensible à la casse)")
    return layer_id

f_cu = get_layer_id(board, "F.Cu")

⚠️ La recherche est sensible à la casse : "f.cu" renvoie aussi -1, exactement comme un nom qui n’existe pas.

get_layer_by_name est plus sournois : sur un nom inconnu, il ne lève pas d’exception et ne renvoie pas non plus BL_UNKNOWN — il renvoie silencieusement BL_UNDEFINED, une valeur de couche valide en apparence. Sans vérification explicite, un item assigné à cette couche se retrouve simplement… nulle part d’utile :

from kipy.board_types import BoardLayer

def get_layer_id(board, layer_name):
    layer_id = board.get_layer_by_name(layer_name)
    if layer_id == BoardLayer.BL_UNDEFINED:
        raise Exception(f"couche inconnue : {layer_name} (sensible à la casse)")
    return layer_id

f_cu = get_layer_id(board, "F.Cu")

⚠️ Testé : get_layer_by_name("NotALayer") ne lève rien et renvoie BL_UNDEFINED — le point le plus facile à rater des deux APIs si on ne vérifie pas la valeur de retour.

GetLayerName ne renvoie pas forcément "F.Cu" : c’est le nom d’affichage de cette board, qui peut avoir été personnalisé (un board 4 couches nommé “TOP”/“GND”/“PWR”/“BOTTOM” par exemple). Pour retrouver le nom canonique attendu par GetLayerID, il faut GetStandardLayerName :

board.GetLayerName(pcbnew.F_Cu)          # nom personnalisé de la board, ex. "TOP"
board.GetStandardLayerName(pcbnew.F_Cu)  # toujours "F.Cu"

Sur une board dont les couches n’ont jamais été renommées, les deux renvoient la même chose — le piège n’apparaît que sur des boards réelles avec des noms de couches personnalisés, ce qui est fréquent en entreprise.

Même subtilité côté IPC : get_layer_name renvoie le nom personnalisé de la board, pas le nom canonique. Contrairement à pcbnew, il n’existe pas d’équivalent confirmé à GetStandardLayerName — BoardLayer.Name(...) existe bien, mais renvoie l’identifiant Python de l’enum ("BL_F_Cu"), pas le format pointé ("F.Cu") attendu par get_layer_by_name :

from kipy.board_types import BoardLayer

board.get_layer_name(BoardLayer.BL_F_Cu)  # nom personnalisé de la board, ex. "TOP"
BoardLayer.Name(BoardLayer.BL_F_Cu)       # "BL_F_Cu" — pas réutilisable tel quel dans get_layer_by_name

Si vous avez besoin du nom canonique côté IPC, gardez plutôt votre propre correspondance nom ↔ constante BoardLayer dans votre script.