Cables Create Custom Connector/fr

Pour les objets Cable Connector, le fichier de préréglages principal est nommé connectorpresets.csv. Téléchargez le fichier connectorpresets.csv à partir du code source de l'atelier Câbles et placez-le dans le dossier $FREECAD_USER_DIR/Cables/ créé à l'étape précédente.

Modifiez le fichier connectorpresets.csv à l'aide de votre éditeur de texte préféré. Je recommande l'éditeur Kate editor, qui intègre une fonctionnalité pratique de coloration des fichiers CSV modifiés.

Dans le fichier connectorpresets.csv, supprimez toutes les lignes qui NE COMMENCENT PAS par le signe « # » (les lignes vides peuvent être laissées telles quelles). Cela permet d'éviter les doublons avec les connecteurs qui existent déjà dans la bibliothèque intégrée.

IMPORTANT : le fichier connectorpresets.csv ne doit être créé qu'une seule fois. Ce fichier peut contenir les définitions de base de tous les connecteurs personnalisés. Chaque connecteur est défini par une seule ligne dans ce fichier. Si un nouveau connecteur est ajouté à l'avenir, il vous suffira d'ajouter une nouvelle ligne à ce fichier. D'autres fichiers sont nécessaires dans le sous-dossier « lib/ », mais cela sera expliqué dans les étapes suivantes.

Le type de connecteur Type de préréglage fixé n'est pas paramétrique et nécessite un modèle externe chargé à partir d'un fichier STEP à chaque fois qu'un nouveau connecteur est créé.

À titre d'exemple, le CatalogPath=TRACEPARTS%3ATP10016001005006&Product=90-04042024-042829&PartNumber=430200210 Micro-Fit 3.0 Plug for 2 circuits with Panel Mount Ears sera utilisé dans ce tutoriel. Téléchargez-le au format STEP AP242.

TRÈS IMPORTANT: certains fichiers STEP risquent de ne pas se charger correctement dans le connecteur. Le fichier Cable Connecteur Fichier STEP explique comment résoudre ce problème.

Après le téléchargement, renommez le fichier Micro-Fit3_DualRow-PME-2.step (le nom peut être quelconque, mais il doit décrire le modèle de connecteur aussi précisément que possible). Placez le fichier dans le dossier $FREECAD_USER_DIR/Cables/lib/.

REMARQUE : le nom du connecteur ayant été défini, il doit être utilisé de manière cohérente dans toutes les étapes ci-dessous, en particulier dans les fichiers CSV. Par exemple, les champs Name et Connector Class du fichier connectorpresets.csv sont utilisés par le logiciel pour rechercher un nom de connecteur valide (si Name = DualRow-PME-2, Connector Class = Micro-Fit3 et le fichier de description CSV doit être nommé Connector Class_Name.csv, ce qui donne Micro-Fit3_DualRow-PME-2.csv pour cet exemple).

Chaque modèle STEP utilisé pour construire un connecteur de câble doit avoir son propre fichier de description CSV. Ce fichier contient des informations supplémentaires sur l'emplacement du modèle, les terminaisons de câble et les SuppLines connectées au modèle. Dans ce tutoriel, le fichier de description CSV portera le nom Micro-Fit3_DualRow-PME-2.csv.

Téléchargez le fichier Connector_Dummy.csv à partir du code source de l'atelier Câbles et placez-le dans le dossier $FREECAD_USER_DIR/Cables/lib/. Renommez-le Micro-Fit3_DualRow-PME-2.csv.

Modifiez le fichier Micro-Fit3_DualRow-PME-2.csv à l'aide d'un éditeur de texte. Dans le fichier Micro-Fit3_DualRow-PME-2.csv, supprimez toutes les lignes qui NE COMMENCENT PAS par le signe « # » (les lignes vides peuvent être laissées telles quelles). Les nouvelles lignes nécessaires seront créées dans les étapes suivantes.

Modifiez à nouveau le fichier connectorpresets.csv. Créez une nouvelle ligne sous les lignes suivantes :

# Fixed Preset Type
# Name,Fixed,Connector Class,StepFileName,NrOfTerminals,NrOfSuppLines

et ajoutez un texte comme celui ci-dessous :

DualRow-PME-2,Fixed,Micro-Fit3,Micro-Fit3_DualRow-PME-2.step,2,1

Il contient les informations indiquant que ce connecteur aura 2 terminaisonss et 1 croix SuppLines. Pour en savoir plus sur les règles relatives à cette ligne, consultez Cable Connecteur Plus de détails sur le type de préréglage fixé dans le fichier connectorpresets.csv.

Modifiez ensuite le fichier Micro-Fit3_DualRow-PME-2.csv. Créez une nouvelle ligne sous les lignes suivantes :

# Connector Element Type
# Name,ExtShape,Class,Offset X,Offset Y,Offset Z,Rotation Yaw(Z),Rotation Pitch(Y), Rotation Roll(X)

et ajoutez le texte :

DualRow-PME-2,ExtShape,Micro-Fit3,0.0,0.0,0.0,0.0,0.0,0.0

puis sous les lignes :

# Terminal Element Type
# Name,Terminal,Class,Offset X,Offset Y,Offset Z,Rotation Yaw(Z),Rotation Pitch(Y), Rotation Roll(X),NrOfConnections,Length,Spacing

ajoutez 2 lignes :

Pin001,Terminal,Terminal,-10.0,0.0,0.0,0.0,0.0,0.0,1,10.0,1.0
Pin002,Terminal,Terminal,10.0,0.0,0.0,0.0,0.0,0.0,1,10.0,1.0

et enfin sous les lignes :

# SupportLines Element Type
# Name,SupportLines,Class,Offset X,Offset Y,Offset Z,Rotation Yaw(Z),Rotation Pitch(Y), Rotation Roll(X)

ajoutez 1 ligne :

SuppLines001,SupportLines,SupportLines,0,0,30.0,0,0,0

Les lignes ajoutées ci-dessus définissent les positions de départ du corps du connecteur, des 2 bornes et de la croix supplines. Les étapes suivantes permettront de déterminer les positions finales de tous les éléments.

Le placement de la forme STEP importée peut être différent de celui attendu. Supposons dans cet exemple que la fiche doit être placée verticalement, avec les câbles sortant vers le haut, et que le bas doit toucher le point (0,0,0).

Oublions un instant les CableTerminals et les SuppLines, sélectionnons le connecteur dans l'arborescence et déplaçons-le et faisons-le pivoter à l'aide de l'outil Std Transformer.

Son emplacement peut désormais être vérifié dans l'éditeur de propriétés ou dans la console Python. Les détails sur la manière de procéder sont présentés dans Placement. Choisissez l'affichage de l'angle de lacet, de tangage et de roulis dans le panneau de tâches Placement. Cela permettra de mieux présenter les résultats de rotation. Les valeurs précises peuvent être saisies manuellement.

Le résultat du placement devrait être le suivant : Placement [Pos=(0,0,8.445), Yaw-Pitch-Roll=(0,0,-90)]

Modifiez à nouveau le fichier Micro-Fit3_DualRow-PME-2.csv et modifiez la ligne :

DualRow-PME-2,ExtShape,Micro-Fit3,0.0,0.0,0.0,0.0,0.0,0.0

en :

DualRow-PME-2,ExtShape,Micro-Fit3,0.0,0.0,8.445,0.0,0.0,-90.0

et enregistrez le fichier Micro-Fit3_DualRow-PME-2.csv.

Supprimez tous les objets du document FreeCAD actuel et recréez le connecteur en choisissant le préréglage Micro-Fit3_DualRow-PME-2. Son emplacement actuel devrait correspondre à celui qui vient d'être défini. Notez que l'emplacement du connecteur affiché dans l'éditeur de propriétés ou dans la console Python est désormais Placement [Pos=(0,0,0), Yaw-Pitch-Roll=(0,0,0)]. Ceci est correct car le placement de la forme du connecteur a été défini lors de sa création sur la base des données du fichier Micro-Fit3_DualRow-PME-2.csv.

Le résultat final devrait ressembler à l'image ci-dessous.

Connecteur Micro-Fit3_DualRow-PME-2 placé verticalement.

Développez CableConnector dans l'arborescence. Il devrait contenir deux sous-objets terminaux : CableConnector_Term001 et CableConnector_Term002. Les deux doivent être ajustés pour s'adapter au connecteur.

Effacez la valeur de la propriété Attachment Support des deux terminaisons dans l'éditeur de propriétés. Cela est nécessaire pour permettre le déplacement des terminaisons.

Sélectionnez la première borne dans l'arborescence et modifiez sa longueur à 6 mm dans l'éditeur de propriétés. À l'aide de l'outil Std Transformer, placez-la verticalement à l'intérieur du connecteur en vous assurant que Vertex1 de la terminaison est orienté vers le haut (ceci est important pour la fixation ultérieure du câble). Le numéro du sommet s'affiche dans la ligne d'état inférieure de FreeCAD lorsque vous passez le curseur sur le sommet dans la vue 3D. Répétez toutes ces étapes pour la deuxième terminaison.

En utilisant les mêmes méthodes que dans l'étape précédente, vérifiez si l'emplacement des bornes correspond aux valeurs indiquées ci-dessous :

CableConnector_Term001: Placement [Pos=(0,1.5,12.0), Yaw-Pitch-Roll=(0,0,90)]

CableConnector_Term001: Placement [Pos=(0,-1.5,12.0), Yaw-Pitch-Roll=(0,0,90)]

Retapez ces valeurs dans le fichier Micro-Fit3_DualRow-PME-2.csv en remplaçant les lignes :

Pin001,Terminal,Terminal,-10.0,0.0,0.0,0.0,0.0,0.0,1,10.0,1.0
Pin002,Terminal,Terminal,10.0,0.0,0.0,0.0,0.0,0.0,1,10.0,1.0

avec ces lignes :

Pin001,Terminal,Terminal,0.0,1.5,12.0,0.0,0.0,90.0,1,6.0,1.0
Pin002,Terminal,Terminal,0.0,-1.5,12.0,0.0,0.0,90.0,1,6.0,1.0

Supprimez tous les objets du document FreeCAD actuel et recréez le connecteur en choisissant le préréglage Micro-Fit3_DualRow-PME-2. Son emplacement actuel doit correspondre à celui qui vient d'être défini et doit être similaire à l'image ci-dessous.

Connecteur Micro-Fit3_DualRow-PME-2 avec des terminaisons correctement alignées. Il est transparent pour une meilleure visibilité des terminaisons.

L'unique objet SuppLines (CableConnector_SuppLines001dans cet exemple) a la forme d'une croix avec une taille prédéfinie fixe. Cet objet peut être utilisé comme point de fixation pour un câble relié au connecteur. C'est à l'utilisateur de décider de l'utiliser ou non.

Le placement par défaut de la croix SuppLines dans ce tutoriel est trop haut. Modifions son placement à l'aide des méthodes décrites dans les étapes précédentes.

Le placement final des SuppLines peut ressembler à ceci :
CableConnector_SuppLines001: Placement [Pos=(0,0,25), Yaw-Pitch-Roll=(0,0,0)]

Retapez ces valeurs dans le fichier Micro-Fit3_DualRow-PME-2.csv en remplaçant les lignes :

SuppLines001,SupportLines,SupportLines,0,0,30.0,0,0,0

avec ces lignes :

SuppLines001,SupportLines,SupportLines,0,0,25.0,0,0,0

Supprimez à nouveau tous les objets du document FreeCAD actuel et créez le connecteur en choisissant le préréglage Micro-Fit3_DualRow-PME-2. Le résultat devrait présenter tous les ajustements finaux des objets créés.

La définition du préréglage du connecteur Micro-Fit3_DualRow-PME-2 est désormais prête à être utilisée dans les projets.