Circuits are the central structuring element of Antares.

In the introductory chapter First Steps you have already made first experiences with your own circuits. The chapter Projects and Libraries describes how to group circuits into your own projects or how to organize circuits in libraries so that they can be used in multiple projects. In the chapter Workbench you learn how to create new circuits or open existing circuits for editing.

This chapter describes how to edit a single circuit.

Orientation

You open a circuit by double-clicking on the project element or the library element in the workbench tree. The name of the opened circuit is displayed in several places in the Antares window:

  • Title bar: The Antares window title bar shows the name of the circuit and whether the circuit is part of the open project or library. Example: Antares - Project Element "4-Bit Carry Ripple Adder".

  • Navigation bar: The first element of the navigation bar specifies the name of the open circuit.

  • Properties view: If you click on the background of the current circuit in the drawing area, the attributes of the circuit are displayed in the properties window. The title of the properties window contains the name of the open circuit.

  • Workbench tree: The node in the workbench tree corresponding to the open circuit contains the name of the circuit. The icon of the node is highlighted in orange for the open circuit.

A circuit always consists of the circuit itself and its symbol, which is used when the circuit is added as a subcircuit to other circuits. Both parts can be edited separately. Use the view tools (the first two buttons in the toolbar) to switch between the two views.

All changes - whether to the circuit itself, to the symbol, or to attributes of the circuit - are always saved together. The circuit is the "storage unit" of Antares. While changes to project or library structures are always saved automatically, you must save changes to the circuit itself. Use the menu File  Save or the key combination Cmd+S.

Select view

If the circuit is larger, the need to select the size and section of the circuit display in the main window quickly arises. The size of the area containing the circuit is basically unlimited. This is also the reason why the main view does not contain scrollbars; instead, Antares offers several other options for selecting the size and section of the display.

Tip
When the mouse is moved around in the main view, Antares displays the current coordinates of the mouse position in the status bar at the bottom right.
Manual zooming

Manual zooming can be triggered with the same action that is used in windows with scroll bars for vertical scrolling. For a mouse with mouse wheel, this is moving the mouse wheel. When using a trackpad, the corresponding scroll gesture can be used.

Select region (Pan)

The currently displayed region of the main window can be moved by dragging the mouse while holding down the middle mouse button. When using a trackpad, the scroll gesture can be used with the Alt key pressed simultaneously.

View  Zoom In

Enlarges the section of the main window by one zoom level.

View  Original Size

Centers the display and sets the zoom factor to 100%.

View  Zoom Out

Reduces the section of the main window by one zoom level.

View  Center

Centers the display without changing the zoom factor.

View  Fit

Centers the display and sets the zoom factor so that the circuit completely fills the entire main view.

Circuit attributes

If you click with the mouse on the background of the circuit in the main window, the attributes of the circuit are offered for editing in the attibutes view.

Name

In this attribute a short name of the circuit can be entered in all supported languages. Note that you can still change the name of a circuit even if it is part of a library and is already used in projects as a subcircuit. This is because Antares does not use the name of the circuit for referencing subcircuits in libraries, but an internal unique identification (a so-called UUID).

Description

This attribute is used to capture a longer description of the circuit which is displayed in the preview of the explorer and in the description popup when used as a subcircuit in other circuits.

Propagation Delay

This optional attribute can be used to specify the length of time that elapses between the processing of an input signal and the appearance of a modified output signal. It is used to control the display of the processing state of a subcircuit during simulation.

Function

This attribute can be used to specify the script that Antares executes for this component during simulation, if the simulation is run in "Flat simulation" mode. This is an advanced technique; for details on scripting, see the chapter "Scripting in Circuits".

Default light color

The light color that all components in this circuit should have by default (LED, 7-segment display, terminal). If you change the value of this attribute while the circuit already contains lit components, Antares will ask you if the new light color should be applied to these components. With this option, for example, all red LEDs and 7-segment displays can be changed to yellow with a single action.

Add components

You add components to a circuit by selecting the components to be added in the workbench tree and dragging them into the circuit (Drag & Drop). The new component is given the default attributes specified by the programming.

It often happens that you need several components with the same, modified attributes in a circuit, e.g. OR gates with three inputs instead of only two as with the default value. In these cases it may be useful to use copy/paste: Drag the first copy of the component into the circuit, set the desired attributes, copy the component to the clipboard using Edit  Copy, and then paste the required number of additional components into the circuit using Edit  Paste.

When inserting a component for the first time, Antares places the inserted component at a small distance from the original. If you then move the inserted component to a new location and then insert additional components from the clipboard, Antares will use the distance between the original and the location you defined for the first inserted component as a template. This makes it easy to create uniform arrangements of similar components, e.g. for flip-flops in shift register circuits.

Connect components

Connecting components using wires is a separate, large topic that is dealt with in the separate chapter "Wires".

Attributes of subcircuits

The properties of the built-in base components are explained in chapter "Base Library". This section describes the attributes of subcircuits which are inserted into a circuit.

Orientation

The cardinal point to which the symbol of the subcircuit points. Like basic components, symbols of subcircuits can also be rotated with Cmd+R.

Mirror Horizontally

Mirrors the symbol in horizontal direction (or on the vertical axis through the origin of the symbol). This is useful, for example, if wires with input signals arrive in the using circuit from the right side, but the inputs in the symbol are located on the left side of the symbol.

Mirror Vertically

Mirrors the symbol in vertical direction (or on the horizontal axis through the origin of the symbol). This is useful e.g. if wires with control signals arrive from above in the using circuit, but the control inputs in the symbol are located at the lower side of the symbol.

Description

In this attribute a description of the subcircuit can be entered which is only valid for this one use of the subcircuit. This description replaces the one given by the author of the subcircuit.

Label

This attribute is only available if the symbol of the subcircuit contains at least one designation element, i.e. a text and/or a label. This attribute can be used to change the text of the label specified by the symbol.

Example: The example project "Microcomputer (Tannenbaum)" contains two 16-bit registers that serve as latches in both data paths A and B of the CPU. The symbol of the 16-bit register contains the label component "REG" (for register). When using the registers within the CPU, this attribute "Label" can now be used to replace the text "REG" with "A Latch" or "B Latch".

The value of the attribute "Label" can also be deleted to ensure that the label specified by the symbol is not displayed.

Edit symbol

The previously presented possibilities of adapting the symbol of a subcircuit by mirroring or changing the designation are often sufficient to integrate a subcircuit optimally into a circuit. Sometimes, however, the symbol of a subcircuit needs to be adapted even further.

The figure below shows the already described application of 16-bit registers as data path latches in a CPU. In addition to adapting the standard description of the register, in this case one would like to display e.g. the currently stored value of the register directly in the symbol, something which is not provided by the 16-bit register in the standard library.

Edit Symbol

For such and similar applications, Antares offers the possibility to edit the symbol of a single subcircuit completely free. With context menu Edit Symbol Antares opens the same symbol editor that is used for editing the symbol of circuits. This provides all the editor’s options such as moving inputs, editing graphical elements such as rectangles, or adding control elements. In the example above, the control element "Output" of the 16-bit register has been added to the symbol.

With OK the symbol editor is closed and the changed symbol is saved as symbol of the subcircuit in the current circuit.

Note
The modified symbol is only valid for the selected subcircuit in the current circuit. Other subcircuits of the same circuit retain their symbol and, in particular, the library or project containing the subcircuit is not changed.

The original symbol can be restored with context menu Reset Symbol.

Drawing tools

A circuit in Antares can not only consist of digital components and the connected wires, but also of purely graphical elements such as rectangles or texts. Use the drawing tools in the Antares window toolbar to add such elements to the circuit.

Select the drawing tool and then move the mouse over the drawing area. The changed mouse pointer icon indicates that you can start drawing.

Selection Selection With the selection tool you can select single or multiple components. In addition to clicking the left mouse button, use Shift to expand or reduce the current selection. Click with the mouse on the background to draw a selection range with the mouse button pressed down.

Rectangle Rectangle Click the left mouse button and draw the rectangle while holding down the mouse button. With Shift a square can be created.

Ellipse Ellipse Click the left mouse button and draw the ellipse with the mouse button pressed down. With Shift a circle can be created.

Polyline Polyline Click the left mouse button to set the points of a polyline. A double click terminates the creation of the polyline. To add further points later, you can select the polyline and double-click on a segment of the polyline. If you move an intermediate point to another intermediate point, the two points will be merged into a single point.

Curve Curve Click with the mouse at three points to define the three points of a curve. The three points are the support points of a square B├ęzier curve.

Text Text A click with the left mouse button creates a text component with a standard text. Double click on the text to change the text or use the "Text" attribute in the Antares properties window. The text can contain several lines. In the current version of Antares, the text is left aligned. Change the size of the text box by editing it like a rectangle.

The selection state of the graphical objects is displayed by drawing in the selection color, as with digital components, and not by displaying the small editing rectangles (handles) as in other applications. These are only displayed when you move the mouse over a selected graphic component.

Select a graphic component and change its attributes such as "Fill", "Border", "Shadow", "Style", "Color", "Line style" to customize the appearance of the component. In chapter "Styles and themes" you can find more information about styles, colors and other graphical properties.

Alignment

Antares offers two tools that facilitate the mutual alignment of components.

Raster Raster This tool always sets the zero point of a component to a grid point. The spacing of the grid points can be changed in Antares preferences; note, however, that most of the given components are dimensioned so that their pins are aligned to the standard grid spacing.

Components Components With this tool, Antares tries to align the component you place with respect to existing components. Depending on the type of component, either the zero point of the component or its inputs and outputs will be used. Antares uses thin orange guidelines to indicate where it has found a possible alignment with others.

Alignment