Documentation

Terminal strips, plugs, PLC and marking

Terminal strips with multi-level terminals and accessories, plugs, PLC cards with the exchange to PLC programming tools, and the markers for the workshop.

Terminal strip editor

Terminal order (move up / down, sort), renumbering 1 … n, jumpers (bridged terminals share their potential), spare terminals (in the terminal diagram and the BOM); every terminal has its part: PE terminals take the strip's part with the tech data Terminal type: PE, all others its feed-through part (bill of materials, panel length of the strip, connection points per terminal); automatic accessories from the tech data of the terminal parts (End bracket: …, End plate: …, Jumper: … with jumper parts Poles: n): an end bracket at both ends, an end plate after the last terminal of each part, plug-in jumpers of the shortest fitting length (cut if longer, teeth broken off at terminals in between) – in the bill of materials, the terminal diagram, the panel layout (2D / 3D) and the check; the terminal strip window shows the strip on the rail with its jumpers and has a switch for the automatic accessories. Multi-level terminals: a terminal on level 2 or higher sits on the block of the terminal before it (one part per block, tech data Levels: 2); the terminal diagram lists every level, the rail layout and the bill of materials count blocks, and the check reports more levels than the part has. Jumper kinds: plug-in jumpers (tech data Jumper), saddle jumpers (Saddle jumper) and wire jumpers (any level, no part); plug-in and saddle jumpers must stay on one level. Commands: list_strips, get_strip, set_terminal, set_jumper_kind, set_strip, renumber_strip.

Plugs

Plugs (Devices › Plugs…, symbol group Plugs): pin and socket (mated pair, two connection points), male pin and female socket (one each); tag = plug (-X10), designation = pin. Male and female pins of the same designation are mated: the potential passes through, the two sides are separate connections (wire numbers, cables). Pins are numbered per plug when placed; the plug window and the plug diagram report list the pins in plug order with the socket side, the pin side and the potential; parts with Plug pin functions give the pin count (unused pins are listed as spare). The check reports pins placed twice and more pins than the plug parts have; the KBL export names the housing part of plug connectors with all cavities of the part.

Connector pin-outs and flat cables

Pin-out (plug window, export Connector pin-outs (SVG) pinouts, command get_pinout): the mating faces of the pin side (male) and the socket side (female, the mirror image) with every pin of the plug's part at its place, filled with the colour of the wire or cable core at the pin (spares empty), the coding key and a pin table with potential, targets and cable cores; hovering a pin shows its details, a click shows its symbol. The face comes from the technical data of the connector part: Pin layout: circle 4 (pins on a circle, pin 1 right of the key at the top, counting counter-clockwise on the male face as in IEC 61076-2-101), circle 7+1 (centre pins last), circle 9+3 / circle 11+5+1 (an inner ring, then the centre), row 8, zigzag 10 (two rows, odd pins above even pins: IDC), grid 2x5 (numbered row by row), cols 20x2 (numbered column by column), dsub 9, each optionally +PE; for any other face the pin centres in mm: points -3.5,2 3.5,2 0,-2 (rectangular face) or round 0,9 -8,-3 8,-3 (circular face with key). Pitch, Coding and Gender (male, female, hermaphroditic) complete it. Numbered pins of a smaller part sit at their number (M8 3-pin: 1, 3, 4); plugs without a layout are shown in a row.

The catalog has, each male and female:

FamilyParts
Sensor / actuatorM5, M8 (3 – 8 pins), M12 A, B (PROFIBUS), D, X (10 Gbit/s Ethernet) and the power codings S, K, T, L, 7/8" (3 – 6 pins)
CircularM16 after IEC 61076-2-106 (3 – 24 pins), M23 signal (12, 17, 19 pins), M23 and M40 servo motor power connectors, GX12 / GX16 / GX20 aviation connectors
ValvesDIN EN 175301-803 forms A, B and C, 2 + PE and 3 + PE
Rectangularheavy duty inserts of the A, D, E and Q series with PE, D-sub 9 – 37, DIN 41612 type C (32, 64, 96), PLC front connectors (20, 40)
BoardIDC sockets and box headers 10 – 64, single row 2.5 mm, dual row 3.0 and 4.2 mm, pluggable terminal blocks 3.5 / 5.08 / 7.62 mm
DataRJ11, RJ12, RJ45, BNC
Mobile machinessealed DT type (2 – 12 pins) and 1.5 mm system (1 – 6 pins)
PowerCEE IEC 60309 16 / 32 / 63 A with 3, 4 and 5 poles, appliance couplers IEC 60320 C5 – C20, Schuko, BS 1363, NEMA 5-15, L14-30, L21-30, installation plug connectors (3 – 5 poles), PV connectors, battery connectors (hermaphroditic, 50 – 175 A), safety banana connectors, thermocouple connectors

Flat cables (Cable form: Flat in the cable part: ribbon cables 10 – 64 cores with pitch 1.27 mm, flat cables for festoon systems): connect_flat_cable makes the wires at one side of a plug cores of the cable, pin n taking core n. Ribbon cables (flat cables with a Pitch) show grey cores with core 1 red on the faces. The check Connector pin-outs and flat cables reports pins the plug's part does not have, cores of a flat cable on an IDC connector (Termination: IDC) that land on another pin and flat cables with another core count than the IDC connector has pins.

Strip and plug navigator

Strip and plug navigator (navigator tab Strips / plugs): the terminal strips with their terminals in rail order (levels of multi-level blocks) and spares, the plugs with their pins and targets and the unused pins of the plug parts; a click shows a placed one, spares and unused pins are dragged into the page.

PLC navigator

PLC navigator (navigator tab PLC): the cards with their channels in address order, placed ones with function text and connected devices (a click shows the symbol), free channels of cards with a device description to drag into the page.

PLC overview

Select the imported card once under Insert center → Devices, then click the sheet for each successive channel. For an EL1008, clicks one through eight share a card tag. Click nine starts channel 1 on another card. Escape ends placement. Expand Representations when a particular wiring variant is required.

A loose EMA with recognized channel definitions has one entry under Symbols and uses the same placement sequence. Import its article XML for a catalog part, BOM assignment and cabinet dimensions.

Beckhoff analog macros with one identifiable signal and its companion terminals produce one PLC point. On the EL3174, voltage input U1 uses terminal 1 for the signal and terminal 9 for its reference. Both terminals can be wired separately. Current-mode representations are alternatives for the same four channels. Use the Insert center to select a particular representation. The PLC overview reports the signal terminal, and readdressing the card leaves analog channel labels intact. TwinCAT variable declarations preserve the supplied data type. Channels without a declared data type remain available on the sheet and in the overview.

For Beckhoff EL1008 and EL2008, import the article XML with the matching EMA beside it. Place a part on the schematic to use its next available channel, or choose a particular multi-line channel in the Insert center. Channels from the same macro family share a card tag. Once all eight are placed, the next default drop starts another card. The PLC navigator lists the remaining channels after the first placement. The PLC overview edits addresses and function texts. Readdressing uses the imported channel order even when points are placed out of order. For example, channel 2 uses physical terminal 5 and bit 1. Set a different start byte for another card in the same address space. The EK1100 coupler retains its supply and bus connections.

All inputs / outputs per card with connected devices, editable addresses and function texts, card start byte / rack / slot, readdressing (of the digital points; analog ones keep their word addresses), symbol table export / import (CSV: name, data type, address, comment) for PLC programming tools, the tag table of Siemens TIA Portal (Excel sheet PLC Tags), the tag import of Rockwell Studio 5000 (aliases of the module channels), the symbol table of Siemens STEP 7 classic (SDF), a global variable list for Beckhoff TwinCAT 3 (TcGVL, AT %I* / AT %Q*), variables for Schneider Control Expert (XSY, EBOOL with topological addresses), device comments for Mitsubishi GX Works (CSV, X / Y in octal) and IEC 61131-3 global variables (CODESYS); addresses used on several cards are reported.

Marking

Marking (Connections › Marking…: wire marker text, material per kind with piece counts and export; File › Export › Export marking (CSV)…, report Marking): device markers (legend plates for door devices; the enclosure's location left out of the tag), terminal markers in rail order with the strip marker, wire markers (wire number on both ends, or destination marking: each end shows the other end), cable markers; grouped by marker material in the order of application, as CSV for marking software (UTF-8, ;, header Material;Category;Text;Count;Enclosure;Group); the material is in the bill of materials. Texts and materials are project settings (marking). Labeling schemes choose the markers, the columns and their order, the separator, header and one row per printed label, for CSV / text and Excel export; built-in import tables for Phoenix Contact CLIP PROJECT, Weidmüller M-Print PRO, Brady, Murrplastik and Partex (starting points – copy and adjust to the program version), own schemes are stored in the project (commands marking_schemes, set_marking_scheme, exporters marking / marking_xlsx with scheme).

This document in the repository

More documentation

Getting started: from the first page to the bill of materials

This tutorial walks through a small control circuit in OpenECraft: pages, symbols, wires, devices with parts, terminals, a PLC, the project check, reports, the panel layout and the output. Commands are written as Tab ›…

Read

Installation and building

Packages for Windows, Linux and macOS, the web version, and building from source.

Read

User interface

The editor's layout and the commands and keys of everyday work. New users start with the tutorial.

Read

Schematic editor

Pages, devices and their structure, live cross references, editing tools, navigators and project storage. The user interface lists the commands and keys.

Read

Symbols and libraries

The built-in symbol libraries (IEC, NFPA / JIC, GB, GOST, JIS, fluid power, P&ID, single-line) and the symbol editor for own symbols.

Read

Wires, cables, potentials and numbering

How connections get their cable, colour, cross-section and number, and how devices, pages and wires are numbered.

Read

Macros, configurator and table editing

Reuse of circuits as macros with variants and placeholders, pages generated by the configurator, and bulk changes in tables and spreadsheets.

Read

Parts management

The parts database shared by all projects (EPLAN style): commercial, technical and mounting data, function templates, connection points, 2D / 3D graphics and the import of manufacturer data. Parts are shared between…

Read

Reports, forms and the project check

Reports as windows, CSV / Excel or live report pages, title blocks and report forms (also graphical and own drawn forms), and the project check with its message management.

Read

Electrical sizing, calculations and verification

Conductor sizing, short circuit and protection coordination, load calculation, EMC, functional safety and rule sets – all part of the project check – and the inspection and test report of the installation.

Read

Panel layout, rooms and 3D routing

OpenECraft aligns the device's clip to the rail centerline. For Beckhoff's 12 × 100 × 68 mm EL I/O housings with 8 or 16 terminals, and the matching EK1100 coupler, the rail center is 63.8 mm from the top. For example…

Read

Wiring and mounting assistants

The panel layout as a checklist for the workshop, on a desktop or a tablet.

Read

Fluid power, process and plant engineering

Hoses and pipes in their own nets, electro-fluid links, PCT loops, the pre-planning of the plant and single-line / multi-line engineering.

Read

Wire harnesses

Harnesses with 3D topology, protections and fixings, KBL export, the harness interface for machines and nailboard drawings (Connections › Harnesses…). The example project conveyor has a door harness.

Read

Output and data exchange

PDF, DXF / DWG, SVG and 3D exports, DXF / DWG import, the enterprise integration layer (ERP, PDM, PLM, ECAD, MCAD, procurement, wiring machines) and Autodesk Vault.

Read

Revisions, review and change management

Revisions with locked pages and marked changes, the approval workflow, baselines with compare and merge, comments and redlining, and change requests.

Read

Command line, MCP server and plugins

Projects and the parts server without a window, for scripts and AI agents.

Read

Plugins

OpenECraft is extended through the openecraft-api crate. A plugin adds

Read

Parts server and parts manager

The data portal shared by all OpenECraft installations and the app that maintains it.

Read

Project server

Shared projects for a team: several users work on the same project, each page is locked by one of them.

Read

Access control of the servers

The parts server and the project server share one access model: users sign in with a local account or with a directory (Active Directory, OpenLDAP or another LDAP server), and what they may do comes from roles given to…

Read