Welcome to the Bartels Group of Companies
BAESETUP, BSETUP - Deutsche Version BAESETUP, BSETUP - English Version
Bartels

Bartels System GmbH
Bartels
Bartels AutoEngineer
BAE Product Info
BAE Price List
BAE Downloads
BAE Documentation
BAE Installation Guide
BAE User Manual
Preface
1 Introduction
2 Circuit Design
3 Packager
4 PCB Design
5 IC/ASIC Design
6 Rule System
7 Utilities
7.1 BAEHELP
7.2 BAESETUP, BSETUP
7.3 BICSET (IC Design)
7.4 BLDRING (IC Design)
7.5 CONCONV
7.6 COPYDDB
7.7 FONTCONV
7.8 FONTEXTR
7.9 INSTALL
7.10 LISTDDB
7.11 LOGLIB
7.12 NETCONV
7.13 REDASC
7.14 RULECOMP
7.15 ULC - User Language Compiler
7.16 User Language Interpreter
7.17 USERLIST
7.18 VALCONV
BAE Libraries
User Language Programmer's Guide
BAE Update History
BAE Next Version Release Notes Preliminary
BAE V8.0 Release Notes
BAE V7.8 Release Notes
BAE V7.6 Release Notes
BAE V7.4 Release Notes
BAE V7.2 Release Notes
BAE V7.0 Release Notes
BAE V6.8 Release Notes
BAE V6.6 Release Notes
BAE V6.4 Release Notes
BAE V6.2 Release Notes
BAE V6.0 Release Notes
BAE V5.4 Release Notes
BAE V5.0 Release Notes
BAE V4.6 Release Notes
BAE V4.4 Release Notes
BAE V4.2 Release Notes
BAE V4.0 Release Notes
BAE V3.4 Release Notes
BAE Support
BAE Contributions
BAE Development and Service Companies
Electronics Development
Bartels Sport Service
Company Profile
Corporate Info
Bartels :: Bartels AutoEngineer :: BAE Documentation :: BAE User Manual :: Utilities :: BAESETUP, BSETUP
Bartels AutoEngineer® - User Manual

7.2 BAESETUP, BSETUP

Bartels AutoEngineer® Dokumentation

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 Setup 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 All Layers 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 Display Mode set to Display Layer Only. 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 Side 1 (solder side, bottom layer), Side 2 (component side, top layer) and Both Sides (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 Side 1 or Side 2 of a documentary layer with the All Layer mode, the Both Sides elements automatically are added to the output, i.e., they are plotted together with Side 1 and/or Side 2. 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

SIDE1enables interactive input on Side 1 of the documentary layer only
SIDE2enables interactive input on Side 2 of the documentary layer only
BOTH enables interactive input on Both Sides 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)
PHYSICALtext can be fully mirrored and rotated but cannot be moved with the Move Name and/or Move Attribute functions (e.g., for insertion plan)
NOROTATEtext 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 Add Symbol popup menu or by specifying the symbol at the corresponding Add Symbol 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 Select Library (see menu Settings) 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 Add Part function as in

<symbolname>

where <symbolname> is the name of the part symbol (e.g., dil16, sot23, etc.). The Layout Editorr command Select Library (see menu Settings) 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 Show Symbol Logic 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 Return/Enter Key (CR).

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:

IdentifierWorkarea
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 NumberColor
1blue
2green
3cyan
4red
5magenta
6brown
7light gray
8dark gray
9light blue
10light green
11light cyan
12light red
13light magenta
14yellow
15white

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 Return/Enter Key (CR)

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.

Bartels :: Bartels AutoEngineer :: BAE Documentation :: BAE User Manual :: Utilities :: BAESETUP, BSETUP

BAESETUP, BSETUP
© 1985-2024 Oliver Bartels F+E • Updated: 18 March 2011, 19:43 [UTC]

© 1985-2024 Oliver Bartels F+E Bartels Homepage Contact and Corporate Info

Web Development by Baumeister Mediasoft Engineering

BAESETUP, BSETUP - Deutsche Version BAESETUP, BSETUP - English Version