Parameter

Parent page: Schematic Objects

Parameters are used for components (shown), documents and projects to add detail information to the design.

Summary

Parameters are general purpose text strings that are child objects of a parent object that allows detail information to be added to that parent object. For example, schematic components make extensive use of parameters. They are used to define the Designator and the Comment, as well as the general purpose parameter strings that can be added to fully define it. General purpose component parameters can be used for a variety of functions including component detail, such as Wattage, Voltage, eyc., supplier detail, including the supplier name and part number, library component design detail, such as the revision number of the symbol, and documentation detail, such as a URL that links to a component datasheet.

Parameters can be defined at the schematic sheet (document) level and the project level. Document-level parameters are ideal for defining fields, such as the document title and number, and project-level parameters are ideal for defining fieldssuch as the designer or the project name.

Availability

Parameters are added as a property of the parent object; they are not placed independently like a Text String. Parameters can be added to any of the following design objects:

  • Component - add user-defined parameters in the Parameters region of the Component Properties dialog or the Library Component Properties dialog if they are being added during component definition in the schematic library editor. Designator and Comment parameters are always present for a Component object. To access the dialog, double-click a component in the Schematic editor or double-click the component name in the Sch Library panel in the Schematic Library editor.
  • Pin - on the Parameters tab of the Pin Properties dialog.
  • Port - on the Parameters tab of the Port Properties dialog.
  • Sheet Symbol - on the Parameters tab of the Sheet Symbol dialog.
  • Document - in the Document Options dialog (Project | Content | ). Parameters are listed on the Parameters tab of the dialog; a number of default parameters are automatically included in a new schematic sheet.
  • Project - in the Options for Project dialog (Project | Content | ). Parameters are listed on the Parameters tab of the dialog.

Graphical Editing

Visible strings can be edited graphically using what is known as in-place editing. To edit a string in-place, click once to select, pause for a second, then click a second time to enter edit mode.

 Click once to select the string.

 Pause, then click a second time to enter in-place edit mode.

 Here the string has been selected, ready to type in a replacement string.

The value of the designator string can be edited in-place.

Once editing is complete, press Enter or click away from the string to exit in-place editing mode.

An object that has its Locked property enabled cannot be selected or graphically edited. Double-click on the locked object directly then disable the Locked property to graphically edit the object.

Editing via an Inspector Panel

Panel pages: SCH Inspector, SCHLIB Inspector

An Inspector panel enables you to interrogate and edit the properties of one or more design objects in the active document.

The Inspector panel also supports adding additional parameters to selected components. Click Add User Parameter at the bottom of the panel, enter the parameter Value then press Enter. A dialog will then open prompting for the Parameter Name.

Component Parameters

Component parameters include the designator and comment, as well as any user-defined parameters.

Editing Component Parameters in the Schematic Library Editor

By default, the designator, comment and user-defined parameters are not visible in the Schematic Library editor. They are edited in the Library Component Properties dialog. Double-click on the Component name in the SCH Library panel or click the Edit button to open the dialog, as shown in the image below.

Double click on the component name or click the Edit button to open the dialog and edit the component parameters in the library editor.

User-defined parameters can be displayed by enabling their Visible checkbox in the Library Component Properties dialog. Enabling this will display the parameter Value. To display the parameter name, click the Edit button to open the Parameter Properties dialog where the Visible checkbox for the Name field can be enabled.

Alternatively, the designator and comment strings can be displayed in the Schematic Library Editor then doubled-clicked on to edit their properties. To display these strings, click Tools | Options | to open the Library Editor Workspace dialog, then enable the Always Show Comment/Designator option as shown in the image below. This setting is a property of the Schematic Library.

Enable the Always Show Comment/Designator option to display these strings in the Schematic Library Editor.

Editing Component Parameters in the Schematic Editor

Component parameters can be defined in the Schematic Editor as the component is being placed or after the component has been placed on a schematic sheet.

  • To define the designator/comment/user-parameter during component placement, press the Tab key while the component is floating on the cursor. The Properties for Schematic Component dialog will open. Enter the required designator/comment/user-defined parameter string then click OK to close the dialog and complete the component placement. Continue to place components, or press Esc to terminate placement.
  • To define the designator/comment/user-parameter after placement, double-click on the placed component to open the Properties for Schematic Component dialog where the designator/comment/user-parameter can be edited. Click OK to close the dialog and commit the change.

Editing the Display Properties of Component Parameters

The appearance of the designator/comment/user-parameter strings, which includes the font type, size and color, can be defined as:

  1. A property of the symbol by setting the properties of the designator/comment/user-parameter in the Parameter Properties dialog in the Schematic Library Editor. This requires the designator string to be made visible, as described previously.
  2. By editing the component designator/comment/user-parameter string of the placed schematic component - double-click on the component to edit the different parameter properties.

Both approaches open the Parameter Properties dialog, as shown below. Note that all properties of the parameter can be edited in this dialog.

The value and the appearance of the Designator string can be edited in the Parameter Properties dialog.

Fixing the Location of the Parameter Strings

The default behavior of a component parameter string is to autoposition it as a component is rotated during placement. If this behavior is not required, turn off the Autoposition option in the Parameter Properties dialog (refer to the previous image) either during symbol creation or after the component has been placed on a schematic sheet. Note that doing this sets this parameter to be classified as a manual parameter (meaning manually positioned parameter). Manual Parameters are identified by a dot on the lower left corner of their selection box.

Special Purpose Component Parameters

Special purpose component parameters have been created for defining links from components to related documentation. These include the HelpURL and the ComponentLink parameter pair.

The HelpURL Parameter

The HelpURL parameter allows you to define a link from a component to an external document, such as a PDF or web page. The link is activated when you press F1 over the component on the schematic sheet or when that component in selected in the Libraries panel. Using this parameter you can reference a PDF, a text file, or an HTML page. To use the feature, add the HelpURL parameter to the required component and set the value of the parameter to the document you want to open.

When specifying the value for the parameter, you can either include an absolute path or enter the document name. The following examples are valid entries for the value of the parameter:

  • C:\Design_Projects\Schematics\Modifications.txt
  • From Idea to Manufacture - Driving a PCB Design through CircuitStudio.pdf
  • www.circuitstudio.com

When F1 is pressed with the cursor hovering over the placed object, a search for the document is conducted as follows:

  • If a path to is specified, this location is searched first,
  • If the document cannot be found at this location or if no path is specified, the \Help folder of the CircuitStudio installation is searched,
  • If the document cannot be found, the default help topic for the object is displayed.
The target document can also be accessed by right-clicking over the placed part in the workspace. The entry for the link will appear as the top entry in the References sub-menu, entitled Help.

The ComponentLink Parameter Pair

This feature enables you to define and present named links to any number of reference documents. Multiple ComponentLink parameter pairs can be defined. To use this feature, add and configure the two parameters for each ComponentLink pair as follows:

First parameter - used to define the target document:

  • Parameter Name = ComponentLinknURL (where n is any integer value)
  • Parameter Value = target document path\name

Second parameter - used to define the entry that appears in the menu:

  • Name = ComponentLinknDescription (where n is the same integer value used in the first parameter)
  • Value = Entry to appear in the menu

Any number of ComponentLink parameter pairs can be defined, each pair is associated by sharing the same value for n.

To access component links, right-click on the placed part in the workspace. The entry for the link will appear in the References sub-menu.

Replacing the Value of a String with a Parameter Value

Component parameters can easily be displayed via their Visible checkbox. This is not the case for Document or Project parameters, which cannot be directly displayed on the schematic sheet. To display these parameters, a technique known as String Indirection is used. String Indirection is a system where a standard text string is placed on the schematic sheet, and instead of entering a string value, you enter the name of a Document or Project parameter preceded by an equal sign, for example =Title. The software automatically detects such strings and instead of displaying the contents of the text string, such as =Title, it checks the Document and Project parameters and if a parameter called Title is found, the value of the Title parameter is displayed.

Indirected strings are known as Special Strings. There are a large number of predefined special strings, which are listed below. Any user-defined document or project parameter can also be thought of as a special string and be indirected to a Text String on the schematic sheet.

Indirected strings are always interpreted and displayed during output generation, such as printing the schematic sheets. Many are also interpreted and displayed directly on-screen.

Use Special Strings to define fields in a title block. The string indirection feature will ensure the correct information for the active schematic is extracted from the document parameters and displayed in the title block.

Schematic Predefined Special Strings

The following are the predefined special strings available for use on a schematic document. The majority of these link to default parameter information defined for the active document on the Parameters tab of the Document Options dialog (Project | Content | Document Options).

  • =Address1 – displays the value specified for the default document-level parameter Address1.
  • =Address2 – displays the value specified for the default document-level parameter Address2.
  • =Address3 – displays the value specified for the default document-level parameter Address3.
  • =Address4 – displays the value specified for the default document-level parameter Address4.
  • =Application_BuildNumber – displays the version and build for the current CircuitStudio installation.
  • =ApprovedBy – displays the value specified for the default document-level parameter ApprovedBy.
  • =Author – displays the value specified for the default document-level parameter Author.
  • =CheckedBy – displays the value specified for the default document-level parameter CheckedBy.
  • =CompanyName – displays the value specified for the default document-level parameter CompanyName.
  • =CurrentDate – the current date, automatically calculated from the user's system settings and in the format dd/mm/yyyy, updated upon editing the schematic or on refresh/redraw. Example: 10/12/2012.
  • =CurrentTime – the current time, automatically calculated from the user's system settings and in the format h:mm:ss AM/PM, updated upon editing the schematic or on refresh/redraw. Example: 2:39:47 PM.
  • =Date – used to display static date information. Displays the value specified for the default document-level parameter Date. Unlike the =CurrentDate special string, which is automatically calculated and presented in a set format, you can enter static date information in any format you like.
  • =DocumentFullPathAndName – used to display the full path and name of the document into which the string is placed. Example: C:\MyTestDesign\PSU.SchDoc.
  • =DocumentName – used to display the schematic's file name only (without the file path). Example: PSU.SchDoc.
  • =DocumentNumber – displays the value specified for the default document-level parameter DocumentNumber. The source parameter can also be updated through the Sheet Numbering For Project dialog when using the Tools | Annotation | Number Sheets command.
  • =DrawnBy – displays the value specified for the default document-level parameter DrawnBy.
  • =Engineer – displays the value specified for the default document-level parameter Engineer.
  • =ImagePath – displays the value specified for the default document-level parameter ImagePath.
  • =ModifiedDate – the modified date stamp of the schematic, automatically populated. Example: 10/12/2012.
  • =Organization – displays the value specified for the default document-level parameter Organization.
  • =ProjectName – displays the actual name of the project (including extension). For example, for a project with filename MyPCB.PrjPcb, this special string will display MyPCB.PrjPcb.
  • =Revision – displays the value specified for the default document-level parameter Revision.
  • =Rule – displays the value specified for the default document-level parameter Rule. The value for this parameter will initially be Undefined Rule (appearing as * on the schematic). Double-click on the parameter value to access the ability to define a rule type and edit its constraint(s).
  • =SheetNumber – the sheet number of the current schematic. This value is calculated when using the Tools | Annotate | Number Sheets command. The assigned sheet number in the Sheet Numbering For Project dialog will be entered into the value for the default document-level parameter SheetNumber. The special string, when used on the Editor tab view of the schematic sheet, will source its information from here.
  • =SheetTotal – the sheet total for the project. This value is calculated when using the Tools | Annotate | Number Sheets command. The sheet total in the Sheet Numbering For Project dialog will be entered into the value for the default document-level parameter SheetTotal. The special string, when used on the Editor tab view of the schematic sheet, will source its information from here.
  • =Time – used to display static time information. Displays the value specified for the default document-level parameter Time. Unlike the =CurrentTime special string, which is automatically calculated and presented in a set format, you can enter static time information in any format you like.
  • =Title – displays the value specified for the default document-level parameter Title.
  • =VariantName - displays the variant from which output has been generated. This follows the entry for the current variant (Project | Project Actions | Current Variant). If the base design is used to generate the output, the value will be [No Variations].

Remember that the full list of special strings available in the Annotation dialog will also include any derived from user-defined document-level and project-level parameters.

Sheet numbers can be manually defined or they can be assigned using Tools | Annotation | Number Sheets. This command opens the Sheet Numbering for Project dialog, which can be used to assign consecutive numbers to each sheet in the project.

Special Strings for use with Component Parameters

Several additional special strings (or special interpretations of existing ones) are available when defining component parameters. In each case, the special string is entered as the value for a parameter.

  • =CurrentFootprint – displays the name of the currently assigned footprint for the component as defined in the Models region of the associated Component Properties dialog.
  • =Comment – displays the value appearing in the component's Comment field as defined in the Properties region of the associated Component Properties dialog.
  • =Description – displays the value appearing in the component's Description field as defined in the Properties region of the associated Component Properties dialog.
  • =[ParameterName] – displays the value defined for a specified component parameter. Enter the actual name of a component parameter as the special string name, for example, for a component parameter named PowerRating, enter =PowerRating. When defining the Comment property for a component, the associated drop-down field will be populated with special strings for all existing component parameters, which enables quick use of any defined parameter's value for the Comment.

 

You are reporting an issue with the following selected text and/or image within the active document: