Name
baesetup - Bartels AutoEngineer Setup Module
bsetup - Bartels AutoEngineer Setup Utility
Synposis
bsetup -encode <code>
bsetup setupfile
Description
Releasing BAE Software Authorizations
The
bsetup command format
bsetup -encode <code>
is used for releasing BAE software updates and/or authorizations on previously delivered hardlock keys. The
-encode option requires one argument specifying the authorization code for the BAE software configuration to be released. BAE authorization codes are provided by Bartels System GmbH on demand. When using the
-encode option,
bsetup must be called from the BAE programs directory on the machine where the hardlock key to be released is currently mounted. One BAE call is required immediately after running
bsetup with the
-encode option (and a valid authorization code) to release the new software authorization, i.e., to transfer the new authorization code from the BAE setup file
bsetup.dat (where it has been stored to with
bsetup) to the hardlock key (note message
New Options : <sw-config>). Correct BAE authorization check is then ensured on subsequent BAE calls, i.e., BAE must be exited immediately after being called for releasing a new BAE authorization.
Defining and Modifying BAE Setup Data
The
bsetup command format
bsetup setupfile
is used for defining user specified BAE configuration parameters and defaults, such as BAE menu color setup, layer menus, documentary layer definitions, standard library access paths, etc.
bsetup accepts the setup file name
setupfile as argument. This file must have an extension of
.def but this extension must not be included with the command line.
bsetup translates the setup file and stores the defined setup parameters to a file named
bsetup.dat in the current directory. When starting the
Bartels AutoEngineer or activating one of BAE's program modules the corresponding setup parameters are loaded from the
bsetup.dat file in the BAE programs directory.
The Windows, Linux and Unix versions of the BAE software also provide the
baesetup module for modifying the BAE system parameters.
baesetup can be called using the
function from the BAE main menu.
baesetup uses a graphical interface with dialog boxes, making it much easier to be operated than the
bsetup utility which usually requires a DEF file containing the complete BAE parameter data set to be created and/or modified.
baesetup also provides a function for exporting the setup data to a
bsetup compatible DEF file.
Input File Format
Start Data, End Data, Comments
The setup file format must start with the keyword
SETUP and must end with the keyword
END.. Commentary text can be placed between
/* and
*/.
LAYMENUTEXT Command
The
LAYMENUTEXT command is used to set the names of the most used signal layers in the BAE layout system menus. The formal syntax of the
LAYMENUTEXT command is
LAYMENUTEXT LINE <line> ("<text>",<layer>);
where
<line> is the menu line number (in range 1 to 12),
<text> is the text to be displayed in the layer selection menus, and
<layer> is the signal layer to be used (range 1 to 100). A special
LAYMENUTEXT command format is given by
LAYMENUTEXT TOPLAYER ("<text>");
The above command above defines the menu text for the top signal layer option of the layer selection menus.
LAYPADLAYER Command
The
LAYPADLAYER command is used to enable or disable layer assignments on BAE layout library pad hierarchy level. The formal syntax of the
LAYPADLAYER command is
LAYPADLAYER (ENABLE) ;
and/or
LAYPADLAYER (DISABLE) ;
The
LAYPADLAYER command is historic and is used to support earlier versions of the BAE software. It is strongly recommended to use the
DISABLE option when creating new layout elements. The pad layer assignment should only be enabled for updating old job files.
LAYPLTMARKLAY Command
The
LAYPLTMARKLAY command defines a documentary layer to be used by the
CAM Processor for film registration marks. This layer is always plotted with the
mode. The formal syntax of the
LAYPLTMARKLAY command is
LAYPLTMARKLAY (<layer>) ;
where
<layer> is the documentary layer number (we recommend the "Plot Markers" layer).
LAYGRPDISPLAY Command
The
LAYGRPDISPLAY command is applied for defining a documentary layer to be used for displaying layout groups at movement with the group
set to
. The formal syntax of the
LAYGRPDISPLAY command is
LAYGRPDISPLAY (<layer>) ;
where
<layer> is the documentary layer number.
LAYDOCLAYER Command
The
LAYDOCLAYER command is used to define up to 100 documentary layers for the BAE layout system. Each documentary layer can have information relevant to either or both sides of the PCB. I.e., each documentary layer consists of three sides (sub-layers) named
(solder side, bottom layer),
(component side, top layer) and
(both component and solder side). This layer structure enables mirroring of SMT parts with all documentary text and graphic from the component side to the solder side and vice versa. When plotting
or
of a documentary layer with the
mode, the
elements automatically are added to the output, i.e., they are plotted together with
and/or
. The formal syntax of the
LAYDOCLAYER command is
LAYDOCLAYER <layer> ("<text>",<side>,<rotate>[<,index>]) ;
where
<layer> is the number of the documentary layer in a range of 1 to 100. The
<text> entry is used for specifying an up to 18 character long name for the documentary layer (e.g.,
Silkscreen,
Insertion Plan, etc.). The documentary layer name is displayed in the documentary layer selection menus of the BAE layout system. The
<side> entry is used for specifying the query mode to be used with side selections when defining objects on the corresponding documentary layer. The choices for
<side> are
SIDE1 | enables interactive input on of the documentary layer only |
SIDE2 | enables interactive input on of the documentary layer only |
BOTH | enables interactive input on of the documentary layer only |
NONE | causes the BAE layer menu functions to offer a submenu choice for selecting the documentary layer side on interactive input |
The
<rotate> parameter specifies the mode of text to be created on the corresponding documentary layer. The choices for
<rotate> are:
LOGICAL | text can be rotated and mirrored but remains readable (e.g., for silkscreen) |
PHYSICAL | text can be fully mirrored and rotated but cannot be moved with the and/or functions (e.g., for insertion plan) |
NOROTATE | text with fixed mirror and rotate mode, i.e., the part can be rotated and mirrored but the text position remains fixed (e.g., for drill plan) |
The
<index> parameter is optional and specifies the color palette and layer menu output index for the documentary layer. Documentary layer output index numbers start at 1. Documentary layers without output index assignments are automatically assigned to free index output positions. This feature allows for frequently used documentary layers to be placed at the top of the documentary layer selection menus and/or to group documentary layer definitions within layer menus according to their functionality.
DOCMENU Command
The DOCMENU command can be used to assign frequently used docmentary layers to the top levels of the layer selection menus in the layout system. The formal syntax of the DOCMENU command is as follows:
DOCMENU <menuline> (<layer>) ;
<menuline> specifies the line and/or position for displaying the documentary layer <layer> in the top level layer menus.
USERUNITS Command
The
USERUNITS command is used for setting the default units for the BAE layout system. Once set, this default is used whenever the user is prompted for size or coordinate input. The formal syntax of the
USERUNITS command is
USERUNITS (METRIC) ;
and/or
USERUNITS (IMPERIAL) ;
where
METRIC applies for mm units and
INCH applies for inch units. Alternate units can always be used by adding either
" (for inches) or
mm (for mm) to the input value.
SCMDEFLIBRARY Command
The
SCMDEFLIBRARY command is used to set the default SCM library path and the name of the SCM library file containing all the standard SCM symbol definitions (such as bustap, standard label, pin symbol, module port, etc.). The formal syntax of the
SCMDEFLIBRARY command is
SCMDEFLIBRARY ("<libpath>/<stdlib>");
where
<libpath> is the path to the directory which contains the SCM symbol library files and
<stdlib> specifies the name
<stdlib>.ddb of the SCM standard symbol library file in that directory. Please note the use of the slash
/ as directory and database hierarchy delimiter (instead of backslash
\ as in DOS). With the SCM library path properly set any SCM symbol can be accessed either by selecting the library file and symbol from the
popup menu or by specifying the symbol at the corresponding
function prompt as in
<scmlib>/<symbolname>
where
<scmlib>.ddb is the name of a SCM library file in the SCM library directory (e.g.,
74ls/74ls90 for symbol
74ls90 in library
74ls.ddb,
passiv/r for symbol
r in library
passiv.ddb, etc.). The SCM command
(see menu
) can be used to redefine the standard SCM library path
(- input resets the library,
! and/or
. input restores the library path defined through
SCMDEFLIBRARY).
LAYDEFLIBRARY Command
The
LAYDEFLIBRARY command is used to set the default layout library file containing the layout symbols. The formal syntax of
LAYDEFLIBRARY command is
LAYDEFLIBRARY ("<libpath>");
where
<libpath> is the path name of the library file
<libpath>.ddb. Please note the use of the slash
/ directory and database hierarchies delimiting (instead of backslash
\ as in DOS). With the layout library path properly set any layout symbol can be accessed by specifying the symbol with the
function as in
<symbolname>
where
<symbolname> is the name of the part symbol (e.g.,
dil16,
sot23, etc.). The
Layout Editorr command
(see menu
) can be used to redefine the standard layout library path
(- input resets the library,
! and/or
.> input restores the library path defined through
LAYDEFLIBRARY).
The
LAYDEFLIBRARY also sets the standard library file name to be used for logical library definition queries with the
function of the
Schematic Editor.
LAYDEFELEMENT Command
The
LAYDEFELEMENT command is used to set the default element name used when the enter key only is pressed in response to the layout board
Element Name ? system prompt. The formal syntax of the
LAYDEFELEMENT command is
LAYDEFELEMENT ("<layout-elementname>");
where
<layout-elementname> is the default layout board element name. This command considerably simplifies the work with the BAE layout modules since on corresponding user queries the default layout element name can be specified just by pressing the return key
.
PROJROOTDIR Command
The
PROJROOTDIR command is used to set the directory root path for the optional directory selection menus of the BAE file access functions. The directory popup menus display all subdirectories of the root directory specified with the
PROJROOTDIR command. The formal syntax of the
PROJROOTDIR command is:
PROJROOTDIR ("<rootdir>");
where
<rootdir> is the path name of the directory selection root directory. If there is no
PROJROOTDIR command defined in the setup file, then the current directory is used on default. Examples for
<rootdir> are
/ (root directory of the current drive),
d: (root directory of PC drive D:),
c:/cad_data (directory
cad_data on PC drive C:),
/pcb/projects (directory
pcb/projects of the current drive), etc. The
<rootdir> entry must not contain any special characters such as
. or
\.
WINMENUMODE Command
The Windows and Motif versions of the BAE software can be operated with either the BAE standard user interface with side menus or with the windows-like user interface with pull-down menus. The
WINMENUMODE command is used to activate the desired user interface. Use the following command to activate the BAE standard user interface with side menus:
WINMENUMODE (SIDEMENU);
Use the following command to activate the BAE user interface with pull-down menus (context menus through left mouse button, function repetition through right mouse button) for Windows and/or Motif versions of the BAE software:
WINMENUMODE (PULLDOWN);
Use the following command to activate the BAE user interface with pull-down menus (context menus through right mouse button, function repetition through left mouse button) for Windows and/or Motif versions of the BAE software:
WINMENUMODE (PULLDOWN_RMB_CONTEXT);
The BAE standard user interface is activated with the DOS and/or X11 versions of the BAE software or if the
WINMENUMODE command is omitted in the BAE setup file.
FRAMECOLOR Command
The
FRAMECOLOR command is applied for defining the BAE menu color setup. The formal syntax of the
FRAMECOLOR command is
FRAMECOLOR <screenarea> (<colornumber>);
where
<screenarea> designates the workarea of the BAE user interface and
<colornumber> defines the color for the corresponding workarea. The
<screenarea> choices for the user interfaces of the BAE graphic program modules (BAE Shell,
Schematic Editor,
Layout Editor,
Autorouter,
CAM Processor,
CAM View) are:
| Identifier | Workarea |
|---|
DIALAREA | status/input line |
LISTAREA | text output/graphic workarea |
MENUHEAD | menu header/info field |
MENUHEAD BACK | menu header/info field background |
MAINMENU | main menu |
MAINMENU BACK | main menu background |
SUBMENUA | menu/submenu |
SUBMENUA BACK | menu/submenu background |
EMENMARK | menu cursor enabled (system waits for input) |
EFILMARK | menu bar enabled (system waits for input) |
DMENMARK | menu cursor disabled (system is busy) |
DFILMARK | menu bar disabled (system is busy) |
POPMTEXT | popup menu text |
POPMBUTT | popup menu button |
POPMBACK | popup menu background |
POPMFRAM | popup menu frame |
POPMFILL | directory popup menu background |
The
<colornumber> value is an integer between 1 and 15. The following table lists the color to color number assignments.
| Color Number | Color |
|---|
| 1 | blue |
| 2 | green |
| 3 | cyan |
| 4 | red |
| 5 | magenta |
| 6 | brown |
| 7 | light gray |
| 8 | dark gray |
| 9 | light blue |
| 10 | light green |
| 11 | light cyan |
| 12 | light red |
| 13 | light magenta |
| 14 | yellow |
| 15 | white |
Examples
The following listing shows the contents of the BAE standard setup file stdset.def; this file resides in the BAE programs directory and is used as template for the user defaults:
SETUP
/* Bartels AutoEngineer Standard Setup */
/* Menu Layer Texts */
LAYMENUTEXT LINE 1 ("Layer &1 (Solds.)",1);
LAYMENUTEXT LINE 2 ("Layer &2",2);
LAYMENUTEXT LINE 3 ("Layer &3",3);
LAYMENUTEXT LINE 4 ("Layer &4",4);
LAYMENUTEXT TOPLAYER ("Layer n (Par&ts.)");
/* Documentary Layer Definitions */
LAYDOCLAYER 1 ("Insertion Plan",SIDE2,LOGICAL);
LAYDOCLAYER 2 ("Solder Mask",NONE,PHYSICAL);
LAYDOCLAYER 3 ("Drill Plan",BOTH,NOROTATE);
LAYDOCLAYER 4 ("Film Markers",BOTH,PHYSICAL);
LAYDOCLAYER 5 ("Floor Plan",BOTH,LOGICAL);
LAYDOCLAYER 6 ("Part DRC",SIDE2,LOGICAL);
LAYDOCLAYER 7 ("Pin Number",SIDE2,LOGICAL);
LAYDOCLAYER 8 ("Solder Paste (SMT)",SIDE2,LOGICAL);
LAYDOCLAYER 9 ("Measure/Notes",SIDE2,LOGICAL);
/* Pad Layer Query */
LAYPADLAYER (DISABLE);
/* Film Markers Doc. Level */
LAYPLTMARKLAY (4);
/* Group Load Display Doc. Level */
LAYGRPDISPLAY (5);
/* Standard Search Paths and Names */
SCMDEFLIBRARY ("/baelib/stdsym");
LAYDEFLIBRARY ("/baelib/laylib");
LAYDEFELEMENT ("s1");
/* Default User Measure Units */
USERUNITS (METRIC);
/* Windows/Motif Menu Type */
WINMENUMODE (PULLDOWN);
/* Standard Graphic Color Setup */
FRAMECOLOR DIALAREA (11);
FRAMECOLOR LISTAREA (14);
/* Side Menu Color Setup */
FRAMECOLOR MENUHEAD (10);
FRAMECOLOR MENUHEAD BACK (8);
FRAMECOLOR MAINMENU (12);
FRAMECOLOR MAINMENU BACK (8);
FRAMECOLOR SUBMENUA (10);
FRAMECOLOR SUBMENUA BACK (8);
/* Menu Cursor Color Setup */
FRAMECOLOR EMENMARK (2);
FRAMECOLOR DMENMARK (15);
FRAMECOLOR EFILMARK (8);
FRAMECOLOR DFILMARK (4);
/* Popup Menu Color Setup */
FRAMECOLOR POPMTEXT (3);
FRAMECOLOR POPMBUTT (14);
FRAMECOLOR POPMBACK (8);
FRAMECOLOR POPMFRAM (15);
FRAMECOLOR POPMFILL (1);
/* Text Programs Color Setup */
FRAMECOLOR DIALLINE (10);
FRAMECOLOR OUTLINES (14);
FRAMECOLOR HEADLINE (12);
END.
It is recommended to change the setup.def file to define required setup parameters such as library path settings, layer assignments, etc. Then apply the bsetup utility program to convert the setup file stdset.def to the bsetup.dat file as in
> bsetup stdset
Files
bsetup.dat -- Setup parameter file (in BAE programs directory)
stdset.def -- Setup file template
See also
BAE Shell, Schematic Editor, Layout Editor, Autorouter, CAM Processor, CAM View, Packager.
Diagnosis
The error messages issued by bsetup are intended to be self-explanatory.
