Cables Create Custom Connector/de

Anleitung
Thema
Cables Benutzerdefinierte Leitungsverbindung erstellen
Niveau
Intermediate
Bearbeitungszeit
N/A
Autoren
SargoDevel
FreeCAD-Version
1.0 or above
Beispieldateien
None
Siehe auch
Arbeitsbereich Cables

Einleitung

Das Werkzeug Leitungsverbindung des Arbeitsbereichs Cables enthält einige einsatzbereite Modelle von Leitungsverbindungen (Klemmen, Steckverbinder usw.) in einer integrierten Bibliothek. Zusätzlich zu der Bibliothek kann jeder individuelle Leitungsverbindungen aus vorhandenen STEP-Modellen erstellen, die z. B. von den Herstellern erhältlich sind.

Die individuelle Leitungsverbindung sollte in einem dem Benutzer zugeordneten Ordner erstellt werden. Die integrierte Bibliothek des Arbeitsbereichs Cables sollte als schreibgeschützte Referenz behandelt werden. Jede zusätzliche Datei in der integrierten Bibliothek würde bei einer nachfolgenden Aktualisierung des Arbeitsbereiches verlorengehen.

Diese Anleitung stellt eine Methode vor, für das manuelle Erstellen einer selbserstellten Leitungsverbindung, in diesem Falle ein Steckverbinder, der Anschlüsse (CableTerminals) und ein Anschlusskreuz (SuppLines) beinhaltet.

Der neu erstellte Steckverbinder wird während der Erstellung einer Leitungsverbindung in der Liste Voreinstellung im Aufgaben-Fenster bereitgestellt. FreeCAD muss dafür nicht neu gestartet werden.

HINWEIS: Diese Anleitung beschreibt nur die Erstellung einer Leitungsverbindung der sogenannten Voreinstellungsart Fixed.

Ordner vorbereiten

Bevor der Steckverbinder erstellt wird, müssen zwei separate Bibliothekordner vorbereitet werden und einige Dateien.

Es ist sicherzustellen, dass die nachfolgenden Ordner vorhanden sind. Wenn nicht, müssen sie angelegt werden.

$FREECAD_USER_DIR/Cables/
$FREECAD_USER_DIR/Cables/lib/

Das Benutzerverzeichnis $FREECAD_USER_DIR kann über die Python-Konsole abgefragt werden:

FreeCAD.getUserAppDataDir()

Dateien vorbereiten

Haupt-Voreinstellungsdatei

Für Leitungsverbindungen (CableConnector-Objekte) heißt die Haupt-Voreistellungsdatei connectorpresets.csv. Die Datei connectorpresets.csv aus dem Quellcodes des Arbeitsbereichs Cables herunterladen und in dem Ordner $FREECAD_USER_DIR/Cables/ ablegen, der im vorherigen Schritt erstellt wurde.

Die Datei connectorpresets.csv mit einem beliebigen Text-Editor bearbeiten. Ich empfehle den Editor Kate, der eine nette eingebaute farbliche Hervorhebung für CSV-Dateien besitzt.

Innerhalb der Datei connectorpresets.csv werden alle Zeilen entfernt, die NICHT mit einem '#'-Zeichen beginnen (leere Zeilen können bleiben, wie sie sind). Dies erfolgt, um zu verhindern, dass Leitungsverbindungen, die schon in der integrierten Bibliothek vorhanden sind, dupliziert werden.

WICHTIG: Die Datei connectorpresets.csv muss nur einmal erstellt werden. Diese Datei kann die grundlegenden Einstellungen aller individueller Leitungsverbindungen enthalten. Jede Leitungsverbindung wird durch eine einzelne Zeile in dieser Datei definiert. wenn später eine neue Leitungsverbindung hinzugefügt wird, muss einfach nur eine neue Zeile in dieser Datei ergänzt werden. Es sind einige weitere Dateien in dem Unterordner lib/ erforderlich; dies wird in den nächsten Schritten erklärt.

STEP-Datei

Die Leitungsverbindung der Voreinstellungsart Fixed ist nich parametrisch und erfordert jedes Mal eine externe Form aus einer STEP-Datei zu laden, wenn eine neue Leitungsverbindungerstellt wird.

Als Beispiel in dieser Anleitung wird der Steckverbinder Micro-Fit 3.0 Plug for 2 circuits with Panel Mount Ears verwendet. Dieser wird im Format STEP AP242 heruntergeladen.

SEHR WICHTIG: Einige STEP-Dateien werden wahrscheinlich nicht korrekt in die Leitungsverbindung geladen. Leitungsverbindung, STEP-Datei beschreibt, wie man das Problem beheben kann.

Nach dem Herunterladen wird der die Datei in Micro-Fit3_DualRow-PME-2.step umbenannt (der Name ist eigentlich beliebig, sollte aber den Steckverbinder so genau wie möglich beschreiben). Dazu die Datei in den Ordner $FREECAD_USER_DIR/Cables/lib/ ablegen.

HINWEIS: Da jetzt ein Name für den Steckverbinder vergeben wurde, muss er konsequent in allen folgenden Schritten verwendet werden, besonders innerhalb der CSV-Dateien. Zum Beispiel werden die Felder Name und Connector Class in der Datei connectorpresets.csv durch die Software genutzt, um nach einem gültigen Namen für eine Leitungsverbindung zu suchen (Wenn Name = DualRow-PME-2, Connector Class = Micro-Fit3 und die CSV-Beschreibungsdatei Connector Class_Name.csv benannt werden soll, ergibt sich für dieses Beispiel Micro-Fit3_DualRow-PME-2.csv).

CSV-Beschreibungsdatei für STEP-Datei

Jedes STEP-Modell, das zum Erstellen einer Leitungsverbindung verwendet wird, sollte seine eigene CSV-Beschreibungsdatei besitzen. Diese Datei enthält zusätzliche Informationen über die Positionierung des Modells sowie über Anschlüsse (CableTerminal-Objekte) und Anschlusskreuze (SuppLines-Objekte), die an dem Modell befestigt sind. In dieser Anleitung ist der Name der CSV-Beschreibungsdatei Micro-Fit3_DualRow-PME-2.csv.

Die Datei Connector_Dummy.csv aus dem Quellcode des Arbeitsbereichs Cables wird herunterladen und in dem Ordner $FREECAD_USER_DIR/Cables/lib/ abgeleg. Ihr Name wird zu Micro-Fit3_DualRow-PME-2.csv geändert.

Die Datei Micro-Fit3_DualRow-PME-2.csv wird mit einem Text-Editor bearbeite. Dabei werden innerhalb der Datei Micro-Fit3_DualRow-PME-2.csv alle Zeilen gelöscht, die NICHT mit einem '#'-Zeichen beginnen (leere Zeilen können bleiben, wie sie sind). Erforderliche neue Zeiten werden in den folgenden Schritten erstellt.

Dateien mit grundlegenden Daten befüllen

Die Datei connectorpresets.csv wird noch einmal bearbeitet. Dafür wird eine neue Zeile unter den folgenden Zeilen erstellt:

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

und ein Text wie der folgende hinzugefügt:

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

Er enthält die Informationen darüber, dass dieser Steckverbinder 2 Anschlüsse (CableTerminal-Objekte) und 1 Anschlusskreuz (SuppLines-Objekt) enthält. Um mehr über die Regeln dieser Zeile zu erfahren, siehe Leitungsverbindung, Weitere Einzelheiten über die Voreinstellungsart Fixed in der Datei connectorpresets.csv.

Dann wird die Datei Micro-Fit3_DualRow-PME-2.csv bearbeitet. Dafür wird eine neue Zeile unter den folgenden Zeilen erstellt:

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

und dieser Text hinzugefügt:

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

dann unter den Zeilen:

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

2 Zeilen hinzufügen:

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

und schließlich unter den folgenden Zeilen:

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

1 Zeile hinzufügen:

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

Die oben hinzugefügten Zeilen legen die Ausgangspositionen des Steckverbinderkörpers, der 2 Anschlüsse und eines Anschlusskreuzes fest. In den folgenden Schritten werden die endgültigen Positionen aller Elemente bestimmt.

Elementpositionen anpassen

Wenn die vorherigen Schritte richtig ausgeführt wurden, sollte es jetzt möglich sein, den Steckvervinder mit der Voreinstellung Micro-Fit3_DualRow-PME-2 zu erstellen. Ein neues Dokument in FreeCAD erstellen und den Steckverbinder erstellen, wie unter Leitungsverbindung, Anwendung beschrieben. Dafür im Aufgaben-Fenster die Voreinstellung Micro-Fit3_DualRow-PME-2 auswählen und mit OK bestätigen. Das Ergebnis sollte wie in der folgenden Abbildung aussehen.

Steckverbinder Micro-Fit3_DualRow-PME-2 mit den Ausgangsdaten für die Positionierung.

In folgenden Schritten werden die Positionierungen von Steckverbinderkörper, Anschlüssen und Anschlusskreuz angepasst.

Position des Steckverbinderkörpers anpassen

Die Positionierung der importierten STEP-Form kann anders ausfallen, als erwartet. Stellen wir uns vor, dass der Steckverbinder in diesem Beispiel aufrecht stehen soll, mit dem Leitungsabgang nach oben und seine Unterseite soll den Punkt (0,0,0) berühren.

Vergessen wir für eine Weile die Anschlüsse und das Anschlusskreuz, wählen den Steckverbinder in der Baumansicht aus und drehen ihn mit dem Werkzeug Std Bewegen.

Seine Positionierung kann in der Eigenschaften-Ansicht oder in der Python-Konsole überprüft werden. Einzelheiten zur Ausführung sind unter Positionierung beschrieben. Im Aufgaben-Fenster die Werte im Abschnitt mit Gieren, Nicken, Rollen (Yaw, Pitch, Roll) ablesen. Diese stellen die Ergebnisse der Drehung besser dar. Die genauen Werte können manuell eingegeben werden.

Das Ergebnis der Positionierung (Placement) sollte so aussehen: Placement [Pos=(0,0,8.445), Yaw-Pitch-Roll=(0,0,-90)]

Jetzt wieder die Datei Micro-Fit3_DualRow-PME-2.csv bearbeiten; dabei die folgende Zeile:

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

ändern zu:

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

und die Datei Micro-Fit3_DualRow-PME-2.csv speichern.

Alle Objekte aus dem aktuellen FreeCAD-Dokument löschen und den Steckverbinder erneut mit der Voreinstellung Micro-Fit3_DualRow-PME-2 erstellen. Seine aktuelle Positionierung sollte zu den gerade eingestellten Werten passen. Man beachte, dass die Positionierung des Steckverbinders, die jetzt in der Eigenschaften-Ansicht oder in der Python-Konsole angezeigt wird, jetzt so aussieht: Placement [Pos=(0,0,0), Yaw-Pitch-Roll=(0,0,0)]. Dies ist richtig, da die Positionierung des Steckverbinders während seiner Erstellung aufgrund der Werte in der Datei Micro-Fit3_DualRow-PME-2.csv erfolgte.

Am Ende sollte die Darstellung wie in der folgenden Abbildung aussehen.

Steckverbinder Micro-Fit3_DualRow-PME-2 aufrecht positioniert.

Positionen der Anschlüsse anpassen

Den Steckverbinder, das CableConnector-Objekt, in der Baumansicht erweitern. er sollte zwei abhängige Objekte enthalten, CableConnector_Term001 und CableConnector_Term002. Beide müssen angepasst werden, um in den Steckverbinder zu passen.

Die Eigenschaft Attachment Support in der Eigenschaften-Ansicht beider Anschlüsse (CableTerminal-Objekte) leeren. Dies ist erforderlich, um das Bewegen der Anschlüsse ohne Befestigung zu ermöglichen.

Den ersten Anschluss in der Baumansicht auswählen und in der Eigenschaften-Ansicht seine Eigenschaft Länge auf 6 mm ändern. Dann den Anschluss mit dem Werkzeug Std Bewegen aufrecht im Steckverbinder positionieren und dabei Sicherstellen, dass sein erster Knoten, Vertex1, nach oben zeigt (dies ist später für das Befestigen der Adern wichtig). Die Knotennummer wird in FreeCADs unterer Statuszeile angezeigt, während der Mauszeiger in der 3D-Ansicht über den Knoten schwebt. Alle Schritte für den zweiten Anschluss wiederholen.

Mit derselben Methode wie im vorherigen Schritt prüfen, ob die Positionierung der Anschlüsse den folgenden Angaben entspricht

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)]

Diese Werte werden in die Datei Micro-Fit3_DualRow-PME-2.csv übertragen, indem die Zeilen

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

mit diesen Zeilen überschrieben werden:

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

Alle Objekte aus dem aktuellen FreeCAD-Dokument löschen und den Steckverbinder erneut mit der Voreinstellung Micro-Fit3_DualRow-PME-2 erstellen. Seine aktuelle Positionierung sollte zu den gerade eingestellten Werten passen und wie in der folgenden Abbildung aussehen.

Steckverbinder Micro-Fit3_DualRow-PME-2 mit korrekt ausgerichteten Anschlüssen. Er ist transparent dargestellt, um die Anschlüsse besser sehen zu können.

Position des Anschlusskreuzes anpassen

Das einzelne Anschlusskreuz, das SuppLines-Objekt (CableConnector_SuppLines001 in diesem Beispiel) hat die Form eines Kreuzes und eine voreingestellte Größe. Dieses Objekt kann als Befestigungspunkt verwendet werden, um eine Leitung an dem Steckverbinder zu befestigen. Es steht dem Anwender frei es zu nutzen oder auch nicht.

Die Ausgangsposition des Anschlusskreuzes in dieser Anleitung ist zu hoch. Lasst uns seine Positionierung ändern, indem wir die im vorherigen Schritt beschriebenen Methoden verwenden.

Die endgültige Positionierung des Anschlusskreuzes könnte so aussehen: CableConnector_SuppLines001: Placement [Pos=(0,0,25), Yaw-Pitch-Roll=(0,0,0)]

Diese Werte werden in die Datei Micro-Fit3_DualRow-PME-2.csv übertragen, indem die Zeile

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

mit dieser Zeile überschrieben wird:

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

Noch einmal alle Objekte aus dem aktuellen FreeCAD-Dokument löschen und den Steckverbinder erneut mit der Voreinstellung Micro-Fit3_DualRow-PME-2 preset. erstellen. Das Ergebnis sollte allen endgültigen Anpassungen der erstellten Objekte entsprechen.

Die Voreinstellung des Steckverbinders Micro-Fit3_DualRow-PME-2 ist jetzt bereit für den Einsatz in Projekten.