Run Smart-Frac to create initial SDL File

1. Double Click the SMART-FRAC Entry 

Note the SYMBOL_DESCRIPTION_FILE entry is empty

In this case, SMART-Frac creates the initial Symbol Description Language (SDL) File for us.

It identifies and collapses all the busses and diff_pairs in the pinData. 

It treats Power Pins and Signal Pins differently

It distributes the existing Power Pins across multiple symbols if needed, using an intelligent algorithm that honors the SYMBOL_PIN_LIMIT CSET

It places the remaining pinMatches in the ALL_SIGNAL_PINS symbol

It places Inputs pinMatches on the LEFT, Output pinMatches  on the RIGHT and 

sets the location for all other pinTypes to CHOOSE_SIDE which we will need to fix before we can complete building our symbols

If we do a good job in the intial steps where we fixing pinNames and pinTypes, SMART-Frac will make the remaining task of editing the SDL file to refine our symbols much easier. 

2. Smart-Frac Creates the SYMBOL_DESCRIPTION_FILE

Because the SYMBOL_DESCRIPTION_FILE entry was empty when we started SMART-FRAC,

partBuilder knows that we want to create the inital SDL template file so when it finishes

it copies the file it created to SDL_from_template.sdl file 

If we run Smart-Frac again and the SYMBOL_DESCRIPTION_FILE entry contains:SDL_from_template.sdl, 

Smart-Frac will ask if we want to overwrite the existing template.

if the SYMBOL_DESCRIPTION_FILE entry contains a different file name, PartBuilder will assume that we no longer

want to over-write that file. 

This protects us when we have started to make changes to the SDL file to create the symbol sets we want

3. We scroll back to find The Smart-Frac Report in the Status Window

***

*** SmartFrac Report *** 

***

SmartFrac created:

   22 SIGNAL MATCH_STATEMENTS matching:53 Signal Pins  

   and 

   5 POWER MATCH_STATEMENTS matching:43 Power Pins

   for a total of:96 Pins

So our remaining job is to place the 22 Signal Match_Statements in the order we want to create the symbols for the device. 

We will do this with the SDL Editor. 

4. Click the Open SDL Editor Button

It will open the SDL file selected in the SYMBOL_DESCRIPTION_FILE entry which is

the SDL_from_template.sdl file

5. First Look at the SDL EDITOR

This is the first look the SDL created by SMART-FRAC

The SDL file is a simple text file which could even be edited in your favorite text editor.

The SDL Editor is a powerful editor which provides efficient functions targeted at efficiently modifying the SDL

that  a typcial text editor would not. 

6. ALL_SIGNAL_PINS symbol

We can see the ALL_SIGNAL_PINS entry in the SymbolName column. 

This tells partBuilder to start a new Symbol called ALL_SIGNAL_PINS 

The following lines contain pinMatch statements and are indented to show that

they will place pins in the ALL_SIGNAL_PINS symbol

In this picture we see the LEFT and CHOOSE_SIDE buttons. The buttons let us choose where

we will place the pins that match the pattern in the PinMatch column.

some pinMatch patterns match only one pin, but many match multiple pins which is part of the

power of SDL.

7. The POWER_PINS_1 Symbol

The semicolon at line 26 ends the ALL_SIGNAL_PINS Symbol 

and the POWER_PINS_1 statement at line 28 starts the Power Pins symbol

In this simple part, the POWER_PINS_1 symbol can hold all of the power pins

and they are preplaced nicely with the POWER pins on the left and GROUND pins on the right

The SDL created by SMART-FRAC creates a fully functional power symbol, 

but we are free to change the order, spacing or sides that the pins will appear on if we want.