Creating Design Kits. Creating Design Kits. The Library Builder User Interface. Create New Library

Creating Design Kits

Creating Design Kits

This section will introduce you to the various elements of Library Builder and offer an example explaining the use model of the Library Builder system. Using the Library Builder you can create and package libraries, also known as design kits, for use with ADS.

The Library Builder User Interface

This dialog offers the following options.

Create New Library

Open an Existing Library

This selection is used to open a project ( .lbp file) created previously.

Open Recently Created Libraries

The last 10 Library Builder projects are stored in the drop-down list. Select a file from this list and click Open Recently Created Libraries to open it.

The Library Builder Design Environment

Library Builder User Interface features: Main Window / Content Editor Palette Editor

The Main Window consists of: Menu and Toolbar

The Menu and Toolbar has the following options:

File File operations Edit Editing operations

Add Add groups, palettes and components

Build The package option, used to create packaged kits for distribution Help Topics and Index , provides access to the online documentation. Tree View

The Tree View displays the contents of the library in a hierarchy. The items in this component can be dragged around and placed as desired.

The following rules apply to dragging components:

Component(s) can be dragged from one group to another. Component(s) can be dragged out of one group and into the root. Component(s) cannot be made the child of another component. One group cannot be dragged into another group.

Main Viewing Panel

The Main Viewing panel has two modes for viewing the library contents: Detailed View (default)

Spreadsheet View

The Detailed View

In the Detailed View , shown in the following illustration, the Library Manager is displayed at the main library level. This view displays all the main library properties. At the sublibrary level, the Library Manager displays all sublibrary properties and at the component level, the Component Manager is displayed for the selected component.

Note

The Spreadsheet View

The Spreadsheet View displays all the components in a library. At the component level, a single component only shows one row. A sequence of components will have a "+" sign in front of the component element in the Tree View. Clicking the "+" expands the component view. The spreadsheet displays all the different sets of parameter values that are defined for a sequence component. If a sublibrary is selected only the components details are displayed and enabled for editing, the parameter values are not editable.

You can cut, copy, or paste rows and the values within the cells. For example, you can select a row, then copy and paste it to the end of the table. You can also copy a cell and paste it over another cell, or paste the cell over a selected list of cells. However, parameter names can only be changed using the Component Manager.

1. 2. 3.

The Palette Editor

The palette only displays components for which a bitmap file has been set.

To use the Palette Editor:

Enter the palette name in the Palette Name field.

3. 4.

Clicking the " >> " button adds the component to the palette. Click OK to save the palette.

Summary of Files and Directories

An ADS design kit library is a group of files related to a set of ADS components that are self-contained for ease of transfer and use. The files in a design kit reside in specific subdirectories, located under a directory that bears the name of the design kit. For distribution, the files are packaged into an archive file, using .zip file format.

Opening an Existing Library Builder Project

Any existing Library Builder project file can be opened using one the following methods: Select File > Open.

Select Open Existing an Project from the initial Welcome dialog. Select Open a Recent Project from the initial Welcome dialog.

Creating a New Library

This section illustrates how to create a new library using Library Builder. Note

Double-click the component bitmap to edit it or browse for new component bitmaps.

Note

New libraries can be created in two ways from the user interface: Select Create New Library from the Welcome Dialog. or

Select File > New from the Library Builder Main menu.

The library created for this example will be called "MyFirstKit". This kit will be comprised of a basic passive element, a resistor and an S-parameter (SP) file based component. For more information on these specific components, refer to Components and Models.

The following fields in the main dialog must be completed in order to create a new library:

Library Name

The name of the library (i.e., MyFirstKit).

Library Location

Note

Where the library will be created. This should not be confused with the Library Builder project location. This field cannot be edited directly. Use the browse button to select the location of the library (i.e., C:/).

Vendor Name

This is used to identify the vendor organization that owns this library (i.e., XYZ Technologies).

Vendor URL

Add the vendor's internet web-site URL. This is used to generate Help files associated with the components, (i.e., "http://www.xyztech.com").

Description

A brief description of the library contents.

Version

The version number of the kit. By default, it will be 1.0 and this can be changed to any format or other version number.

Date Created

By default, the current system date is displayed here. The completed form should look like the following:

Note

Click Add to create this library and add it to the to the project.

Selecting Reset returns all the fields to the default values.

Once a library has been created, it appears in the Library Viewer located on the left side of the Main Library Builder window, the New Sublibrary and New buttons at the bottom of the window also become active.

Component

These selections do the following:

New Sublibrary

Opens a dialog with which you can create a new sublibrary.

New Component

Opens a dialog enabling you to create and add a new component. Note

Creating a New Sublibrary

A sublibrary can be created by doing one of the following: Select the New Sublibrary button in the library form. Select the button in the left side tool-bar. Select New Sublibrary from the Add Menu.

New Sublibrary Example

In this example, we will create two sublibraries, Passive Components and Custom Components. The following information is required:

Name of Sublibrary

The name chosen for the sublibrary. For this example, PassiveComponents.

Vendor Name

The name of the vendor company that owns the library or it's components. In this example, XYZ Technologies is used. The default values are from the library information previously entered.

Vendor URL

Enter the vendor's internet web-site URL in this space. This is used to generate the Help files associated with the components. In this case "http://www. xyztech.com". The default values are from the library information entered previously.

Description

Enter a brief description about the content of this library (i.e., My Passive Component Library ). Note

These buttons remain disabled if no library is available in the project.

Note

Help

This section displays information about the currently selected field.

This dialog has two tabs. The second tab is used to set default values for the components that belong to the sublibrary.

Setting Sublibrary Default Values

Defining the default values is optional. Clicking Next >> or selecting the tab labeled Sublibrary Default Values opens this dialog. The Sublibrary Default Values include:

Prefix Name

The value entered in this field will be given as a default name for all the components. When creating a component, this value can be changed, or the name can be appended to a prefix you enter here.

Model Type

This the default model type of the components in the sublibrary. This can be changed at the time of component creation. For this example we used the model type . For a detailed list of supported components, refer to R Components and Models.

Symbol Name

The default symbol for the components in this sublibrary. You can either enter the path to the symbol file ( .dsn ) directly, enter the the name of the default symbol, or use the Browse button to enter the symbol.

The pre-defined symbols are categorized. The catergory can be changed by either selecting the category from the "Category" drop down list or by selecting the appropriate tab. Once a default symbol is selected, the name of the symbol will appear in the Name field.

For selecting a custom symbol, click on the "Browse..." button and select the file.

For this example we used: C:/ADS2008/circuit/symbols/SYM_2Port.dsn

Layout Type

Sets the default layout artwork for components in the sublibrary. This can be an AEL Macro file ( .ael ), Fixed Artwork - ADS layout file ( .dsn ), or No Artwork . For more information about layout artwork, refer to Layout Artwork. In this case No Artwork was chosen.

Bitmap

The default bitmap for the components in the sublibrary. For this example: C:/ADS2008/designguides/projects/dgstudio/ui/bitmaps/adsbmps/R.BMP

You can either enter the path to the bitmap file (.bmp) directly, or use the Browse button to enter the symbol. Clicking the "Browse..." button opens the following dialog.

Note

In case of custom symbols, care needs to be taken. If the symbol is residing on the same design file as the schematic, then the schematic may be exposed. To prevent this, draw the symbol in a separate design file

Note

In the ADS Installation directory ( $HPEESOF_DIR ), symbols are located in the circuit/symbols and de/symbols folder.

Note

1. 2. 3.

The arrangement of the pre-defined bitmaps is the same as the "Symbol Browser" dialog. However, there is an additional option that can be used to define a caption for the bitmap.

To define a caption:

Select a bitmap. Pre-defined bitmaps can be selected from the dialog directly. For custom bitmaps, click on browse and browse to the directory containing the bitmap and select it. Once a bitmap is selected a preview will be shown.

Select the appropriate position where the bitmap needs to be placed.

Enter the caption in the Bitmap Caption field. the caption text can be up to six characters. To finish, click OK.

1.

1. 2.

1.

2.

Click Add to place the sublibrary in the Library Viewer.

Layout Artwork

Library builder supports two types of artwork: Fixed Artwork

Parameterized Artwork

There are large number of pre-defined artworks available in ADS for both types. To select layout artwork, use the following steps: Select the Layout Type

Select the artwork Name

The artwork name list contains the pre-defined artwok of ADS. You don't need to attach the layout files for the pre-defined artworks. You can also create custom artwork of either type. To add your custom artwork, write the artwork name in the Name field and attach the related layout file. For the fixed artwork, write the artwork name as the ADS design file name, without .dsn extension and browse the layout design file. For the AEL Macro type of artwork, write the artwork name as the Macro name and browse the AEL file. For detailed information about layout artwork, refer to Artwork.

Parameterized Artwork

Parameterized artwork is created in ADS by using the AEL macro functions.

Library Builder provides a list of predefined AEL macro artwork. The predefined AEL macros can be can be classified based on the parameters as below:

SMT AEL macros: Library Builder provides a list of predefined SMT Package artwork. For this artwork, you need to select the appropriate macro

from the drop-down list. When you use a predefined SMT Package artwork for a particular component, you must define the first parameter as smtpad and second parameter as offset.

For the smtpad parameter, set the Parameter Type to String and set the default value to the appropriate SMTPAD Instance Name (i.e., Pad1 ). Select the Not netlisted option.

For the offset parameter, set the type to Real, with a default value 0. Select the Not netlisted option.

You must place the component "SMT_pad" in the schematic from the palette "Lumped-With Artwork". Most of SMT AEL macros require two parameters, "smtpad" and "offset", however, a few SMT AEL macros require three parameters, smtpad1 smtpad2, and offset. When the macro has three parameters, you must place two instances of SMT_pad component in the ADS schematic.

2. 3. 1. 2. 3. 4. 5. 6.

AEL macro for Layout only Components: Each artwork macro has different set of parameters. The parameters are displayed in the Component page based on the AEL macro selected. Each parameter has a description and attributes that are set by default. These components Parameters

will not be made available in the ADS Schematic palette. The following are the AEL macros for layout only components: conn cpad2 cpad3 cpad4 pad1 pad3 pad4 padn rpad2 rpad3 rpad4 spac spad2 spad3 spad4 tar1

For detailed information on these layout artworks, refer to Standard AEL Macros in Schematic Capture and Layout.

AEL macro for circuit components: Components may have simulation as well as layout parameters. The attributes of the parameters must be

set properly, if they are not, the components may not behave as expected. The sequence of layout parameters should not be altered.

For a custom AEL macro, you need to supply a custom AEL macro file and ensure that the order of parameters in the AEL macro function are the same as those in the Component Parameters tab of Library Builder.

Creating a Second sublibrary

A second sublibrary can be created by following the same process.

As an alternative method, instead of retyping all the information for a new sublibrary, the old sublibrary can be copied, pasted and edited. To do this:

Select the PassiveComponents sublibrary from the Library Viewer. Select Edit > Copy

Then select Edit > Paste.

This creates a new sublibrary with the same name. Click the newly created PassiveComponents sublibrary. The PassiveComponents sublibrary form will be displayed.

Edit the information in the form as shown in the following illustrations to create the new sublibrary. Click Update.

In this example the sublibrary name was changed to CustomComponents. Note

In the same manner you place "SMT_Pad" component in the ADS schematic along with the SMT AEL macros, you may have to place similar type of components in the ADS schematics for other AEL macros. For example, when you attach the "slin" macro artwork with the component then you must place an "SSub" component from the "TLines-Stripline" palette.

Creating a Component

The next example illustrates how to create a single resistor based component, a sequence of resistor components, an S-parameter file based component (SnP) and an ADS Custom file based component. For more details on each of these components and other components or models supported by Library Builder 2008, refer to Components and Models.

A simple resistor component can be created using the following three methods: Selecting New Component in the Library Form.

Selecting New Component from the Add Menu.

Using the button from the side-toolbar. The Component Information dialog form has the following fields:

sublibrary

This is the drop-down list of sublibraries that are available in the current library. If the component needs to be placed in the root of the library rather than inside any of the sublibraries, then select < No Sublibrary >. Once a sublibrary is selected, then the default values that were given in the sublibrary will be filled in by default. In this case the sample resistor will be placed inside PassiveComponents. Once the sublibrary is selected, the values that were entered in the PassiveComponents sublibrary defaults page will be entered by default.

Model Type

This is the model type of the component. For details on components or models supported by Library Builder 2008, refer to Components and Models. Once " " is selected, this will be set to , as specified.

PassiveComponents R

Name

The name given to the component. The prefix name described in the Sublibrary Default Value page is displayed here. This name can be changed or the name can just be appended to it. It should be set to PC_Res1 for this example.

Symbol

This is the symbol file for this component, which will be used to depict this component inside the Schematic window of ADS. The path to the symbol file ( . ) can be entered directly or the file can be selected using the button.

dsn Browse

For this example:

C:/ADS2008/circuit/symbols/SYM_2Port.dsn

Layout Information

Sets the default artwork for components in the sublibrary. This can be an AEL Macro file ( .ael ), Fixed Artwork - ADS layout file ( .dsn ), or No Artwork. In this case No Artwork was chosen. For more information about layout artwork, refer to Layout Artwork.

Bitmap

Note

The library name cannot start with a number, contain spaces, or any characters other than letters, numbers or underscores.

Note

In the ADS Installation directory ($HPEESOF_DIR), symbols can be found in the circuit/symbols and de/symbols folder. You can also create custom symbols using ADS.

This is the bitmap file for this component. For this example:

C:/ADS2008/designguides/projects/dgstudio/ui/bitmaps/adsbmps/R.BMP

Bitmap Help Text

This text will be displayed as pop-up text when this component is placed in the palette.

Description

Description for the component. Note

Help file/URL

This section is used to link to a Portable Document Format (PDF) help file, or to link to a web page on the internet that has information about the component. The PDF file can be browsed using the Browse button. The URL for the web link must start with "http://".

Setting Component Parameters

Click Next >> to set component parameters. The parameter dialog box is shown in the following illustration.

In the Component Parameters dialog, Single Component is set as the default. Under this setting the component is described with a single set of parameters.

If there are multiple sets of parameters for a single type of component, then the component type Sequence of Components can be used. In this case, each set will have a unique name and the you will have the option of changing the component's parameter set by selecting the name of a particular set. For more information on Sequence components refer to Components and Models.

For the resistor in this example, the component type will be Single Component. To change the values of the components, select the parameter on the left side of the dialog. The corresponding parameter details, such as name, value and unit will also be displayed. Once the value and/or unit has been changed select Apply.

The list of parameters shown for a particular component are the default parameters used in ADS. A new parameter can be added by clicking Add . This will bring up the following window.

Enter the Name Value Unit, Parameter Type, , and Description for the new parameter using this dialog.

Name

Enter the name of the parameter here. This is a required field.

Value

A numeric value for the component can be enter here.

Unit

Parameter Type

Choose the desired parameter type from the drop down list associated with this entry. (e.g., resistance in this example).

Description

Use this field to enter a brief description of the component.

The other choices available from the dialog enable you to display the parameter on the schematic, make it editable, or netlist it. For this example, default values are used.

Display Parameter on Schematic

Check this box if you want the parameter to be displayed in the schematic along with the symbol. For this example, default values are used.

Not Editable

Check this box if you want the parameter to be read-only. By default this is selected. For this example, default values are used.

Not Netlisted

Check this box if you do not want this parameter to be included in the netlist. Parameters that are not netlisted will be used to provide information to the user but not affect the simulation results.

For this example, default values are used.

Layout Parameter

Check this box, if the parameter is a layout parameter. For this example, default values are used.

Click Add to add the component to the sublibrary.

The new component PC_Res1 is displayed in the Library Viewer tree, as shown below.

Creating an SNP Component

The next component to be created is an SNP component. Use the following specifications to create this component beginning with the Component tab:

Information

CustomComponents

Model Type

Ports

Name

Symbol

Layout Information

Leave this blank

Bitmap

C:/ADS2008/designguides/projects/dgstudio/ui/bitmaps/adsbmps/C.BMP

Bitmap Help Text

CC_MySNP

Description:

For SNP Components it is important to check the port mapping. Every N port SNP component has N+1 pins in its symbol, where N pins correspond to the ports and the extra pin is a reference port. The port mapping feature of Library Builder enables you to assign pins to the correct ports in the symbol. For more information about Port Mapping, refer to Port Mapping Symbols for SNP Components

In the following example, we are using a capacitor symbol, that has 2 ports, in this case, we need to ground the third pin of the S2P component. To do this:

1.

2.

Click the Port Mapping button in the Component Information dialog. This opens the following dialog box.

2.

3.

To change the mapping of Pin 3 to ground, select the drop-down list associated with the Port type section of row 3 and choose ground.

Click OK.

Add the following information to the Component Parameters tab:

Component Type

Name

Value

Parameter Type

You must ensure that the symbol selected for a component has the same number of pins as the number of non-grounded ports. For this example, Pin 3 is grounded, leaving 2 non-grounded ports. Therefore, the symbol for this component should only have 2 pins.

To add this component to the sublibrary select Add. The Library Viewer tree will then appear as follows:

Saving a Library Builder Project

Once a library is created, save the project file so that it can be opened in the future for editing or modification. To do this select File > Save.

The Library Builder project file is a an XML file. For more information on this format, refer to Design Kit Installation and Setup.

Closing a Library Builder Project