Control Circuit 2026 › Tutorial › Chapter 4

Chapter 4: The Connectivity Engine and a Simple Circuit

Goal Build a small test circuit, meet the Connectivity Engine (the CE), understand what a net and a Wire Group are, and learn the wiring tools that tidy a sheet up afterwards.

Where we are

Previously we discovered how wires are first-class citizens, and the essential building blocks the engine uses to work out networks and circuit integrity. In this chapter we introduce the Connectivity Engine and build a simple test circuit to use it on. In the next chapter we move on to the two wire numbering methods: manual, and fully automated numbering.

Again, how fully you use the range and depth of Circuit's automation tools is entirely up to you. The more automation you want, the more groundwork and the better the preparation you need to put in.

The Connectivity Engine serves to validate three things:

The wire numbering engine builds on a successful outcome from the CE, and won’t run while the CE is reporting errors. (Warnings do not block numbering; only errors do.)

Wire Numbering Nodes (WNNs) are placed by you on every wire segment where you want to see a wire number. The CE and the numbering engine supply the logic that marks the same wire with the same number, and wires on different segments, or wires that have crossed a boundary such as a symbol or a terminal, with new numbers. There are many configurable options.

The CE gives a very thorough report on what passes and what fails. With that information it becomes apparent what the extra tools at the bottom of the Wiring menu could be useful for.

The Wiring menu with its last group of items ringed in red: Straighten All Wires, Remove Unwired Nodes, Join Selected and Heal Sheet Wiring
The tools at the bottom of the Wiring menu. We will come back to them at the end of the chapter.

Part 1: A simple circuit

Before we can sensibly use the CE and wire numbering, we need a simple yet valid circuit. It is only a backdrop, so it needn’t be something NASA will approve of. Just get some symbols on the sheet.

  1. Choose a symbol library

    Switch to the Symbols palette. Control Circuit ships with some very basic starter libraries: IEC_BASIC, NFPA_BASIC and TERMS_BASIC. Use the drop-down arrow to change library. We will use IEC_BASIC, but NFPA_BASIC works just as well.

    The Symbols palette with the library drop-down open, listing IEC_BASIC, NFPA_BASIC and TERMS_BASIC, with IEC_BASIC ticked
    The libraries are a starting point They are there to get you going, and to show how a library is formed and indexed and how symbols are presented. The shipped libraries are updated from time to time, but they are in BIN (encrypted binary) format, so you cannot alter a symbol in them. You can, however, open any symbol in the Symbol Editor and change it. When you save, you are prompted to save to a custom library, for example IEC_CUSTOM. That way the shipped libraries are preserved, and you can make as many libraries of your own as you need. (The Symbol Editor gets its own chapter later.)
  2. Drag symbols onto the sheet

    With a symbol selected, you can drag it from the tree list or from the preview image underneath.

    The 2P MCB 1PH Neutral selected in the tree list, with its tooltip showing, and arrows showing it can be dragged either from the list or from the preview image onto the sheet

    Build up a simple circuit. Here we have a 2-pole MCB, a power supply, a ground symbol, a single-pole MCB and a lamp.

    Five symbols laid out down the sheet: a 2-pole MCB, a power supply with its ground symbol, a 1-pole MCB and a lamp
  3. Add some End Cap nodes

    Once you have some components arranged, switch to the Tools palette.

    To start, add a couple of End Cap nodes. These can represent incoming supplies or bus-bar ends, and they usefully give wiring a clean start and finish, symbolically, if you want one. Choose the tool, then click anywhere to place the End Cap.

    The Tools palette with the End Cap node tool highlighted, beside the sheet with the symbols laid out
    One & Done By default One & Done mode is on: after every use of a tool the mouse returns to the Pointer. Later on, when you are planting lots of nodes and other items, you can switch the mode off and multi-drop to your heart’s content.
    The Settings section of the Tools palette with One and Done ticked, and the status bar reading Mode: Pointer
  4. Outline the rest with nodes

    Carry on with the other node types, and outline your intended circuit. Here the red squares are End Caps and the red corners are corner nodes. (There are various tools, such as snap alignment and instant auto-wire, available, but for right now just eyeball it and place the nodes.)

    The symbols with two End Caps above the 2-pole MCB and corner nodes placed beside the power supply, ground symbol and lamp
  5. Auto-wire it

    Tap Alt+W to auto-wire the circuit. It looks OK, but the End Caps have joined themselves together, which is not what we wanted. An End Cap has no idea where you want it to go, unlike the other node types, which have directional branches.

    The auto-wired circuit, with a short wire joining the two End Caps at the top
  6. Fix the End Caps with Free Wire

    Select the small wire between the End Caps and delete it. Then use the Free Wire tool to run a wire from one End Cap to the correct pin on the MCB, and then from the other.

    Free Wire is used because an End Cap is a node, not a pin, so Smart Wire’s pin-to-pin routing doesn’t apply. Free Wire draws at any angle. Here the End Caps sit directly above the pins, so the wires come out straight. If one ever comes out slanted, Alt+S will square it off; we meet that command at the end of the chapter.

    The Free Wire tool drawing a dashed wire from the right-hand End Cap down to the N1 pin of the MCB

    We now have a completed circuit for our purposes.

Part 2: Nets, Wire Groups and the Connectivity Engine

Before we run the CE, there is one idea worth getting straight, because everything the CE checks hangs off it.

What is a net?

A net is a run of wire that is electrically joined together with nothing in between. The moment the current passes through a device (a breaker, a switch, a power supply, a terminal) one net ends and another begins. Our little circuit is made of 8 nets, although it is drawn with 14 wire segments, because a net can be several segments long, thanks to the corners.

Wire Groups

A Wire Group says what a net is: its potential. L1, N, 24VDC, 0VDC, Earth. Every wire in a net must belong to the same Wire Group; a net with two different groups in it is a serious (cross-voltage) error. The same Wire Group is used again and again, on as many nets as you like.

For example, L1 going into the 2P MCB and L1 coming out of it are both Wire Group L1, but they are two distinct nets, because the breaker sits between them.

The CE insists that every wire belongs to a Wire Group, so that is what we will set up here.

Net Names

A net can also carry a Net Name, a label for that one net. For example, L1_SUPPLY for the L1 going into the MCB and L1_LOAD for the L1 leaving it. Net Names are entirely optional, and our simple circuit does not need any. A name on a wire is there for you: it makes reports and messages easier to read, and the CE uses it for a cross-check, warning you if two separate nets have been given the same name.

Don’t confuse it with the Net Name on an Interruption Node. That one is set on the node itself, and it is the one that matters: two Interruptions sharing a Net Name is what links them, so a signal can leave one place on a sheet, or one sheet, and arrive at another (we met this in Chapter 2).

Name the signals that matterYou do not need to name every wire, but it pays to name a few strategic ones, such as MASTER_RST or CHARGE_START. In the Find and Replace dialog, tick Net Names under Search targets, set Look in to Entire Project, and Find All lists every wire carrying that name, whichever sheet it is on. Double-click a result to jump straight to it. On a project with a couple of hundred sheets, that is a quick way to track a key signal down.
The colour and the addressIf it helps: the Wire Group is the colour of the wire, and the Net Name, if you use one, is its address.
  1. Run the Connectivity Engine

    Now for our first outing with the CE. Tap F5, or choose Wiring › Connectivity Engine.

    The Connectivity Engine Trace window: 8 nets, 14 wires, 0 cross-sheet and ungrouped=8, with ungrouped=8 ringed in red

    The circuit is sound, but none of the wires have been assigned to a Wire Group. Note that the summary counts nets, not wires: 8 nets, made up of 14 wire segments, and all 8 are ungrouped.

  2. See the problem on the sheet

    Press Esc to dismiss the window. Because Wiring › Show Wire Issues is ticked, every wire with an issue is highlighted in purple.

    The whole circuit with every wire highlighted in purple
  3. Set a Wire Group

    Let’s fix that. We know these two segments are both L1, so select them both, right-click and drill to Wire Group, then choose L1.

    Two wire segments selected, one above and one below the MCB, with the right-click menu open on Wire Group and the list 0VDC, 24VDC, Earth, L1, L2, L3, N and Clear Wire Group
    Where do the groups come from? The Wire Groups offered here come from the Wire Group Definitions list (Wiring › Wire Group Definitions…), which also carries the auto-numbering rules we meet in the next chapter. If your list is empty, Chapter 3 shows how to import the starter set.
  4. Do the rest in one go

    You could do the same for every other set of wires, but there is a quicker way. Select all the wires of one potential, even across several nets, right-click and choose Wire Properties. With more than one wire selected, that opens the Mass Wire Update dialog (also Alt+M from the Wiring menu). Fields left blank are skipped, so we just choose the Wire Group and apply it to all of them at once.

    The Mass Wire Update dialog for 2 selected wires with Net name blank, Wire group set to L1 and Wire type set to no change, beside the two selected wires either side of the MCB

    Go around the circuit and update the remaining wires (N, Earth, 24VDC and 0VDC).

  5. Run it again

    Hit F5 again, and the summary turns green.

    The Connectivity Engine Trace window with a green tick: nets=8, wires=14, cross-sheet=0
  6. Look at the full diagnostics

    Press F5 once more while the CE window is open and it lists everything it found, net by net, with its Wire Group, and finishes with a summary.

    The full diagnostics: each net listed as closed with its wires, pins and group, then a summary of 1 sheet, 8 nets, 14 wires, no group conflicts, no ungrouped nets and no open stubs, with 8 unnamed nets in the status bar
    Unnamed nets Because we have not used Net Names, the status bar also reminds you that the nets are unnamed. That is a soft note, not an error, and nothing to worry about here.

Part 3: The wiring tools

Of course, we have pretty much just done everything the hard way. Now you will appreciate what follows.

Let the CE help

The CE can actually solve some problems for you. For example, it can automatically propagate a Wire Group or Net Name across a net, so you only need to set it on one wire in that net. Tap F5 to open the CE, then choose View › Settings.

The Connectivity Engine Settings dialog, with the two Auto-Propagation options at the bottom highlighted and both unticked
The two Auto-Propagation options are at the bottom.

The Auto-Propagation options are switched off by default. Tick them if you want the CE to fill in ungrouped or unnamed wires in a net, once at least one wire in that net already has a Wire Group or Net Name. We will not dig too deep here; just be aware that automation options exist.

Tools for the sheet itself

The sheet editor has tools of its own, too: the four at the bottom of the Wiring menu.

Straighten All Wires Alt+S, Remove Unwired Nodes Alt+K, Join Selected Alt+J, Heal Sheet Wiring Alt+Shift+H

What you just did

Next

In the next chapter we add WNNs (Wire Numbering Nodes) to our wires and look at the two wire numbering methods, manual and fully automated. Until then, the program’s help (F1) is the place to dig deeper into anything in this chapter; try searching for Connectivity Engine.