Interface Guide
Interface Guide
August, 2001
7$%/( 2) &217(176
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I/O Ports and Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Software Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1-1 1-2 1-5
DIGIT.INF and PLOT.INF Information Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 .INF File Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Preface
Please note that MEDEXE is an environmental variable that points to the directory where the MineSight program files are located. On Windows NT platforms, WINEXE is a common name for this directory. Also, MineSight does not support USB (Universal Serial Bus) ports at this time.
i-1
i-2
Chapter 1Digitizers
Chapter 1Overview
One of the most difficult phases of installing any software system is interfacing with the hardware devices (plotters and digitizers). This short guide is designed to help relieve the frustration that often accompanies this phase. The first step is to examine your hardware to make sure that you can physically make all the necessary connections. We recommend that the plotter be connected via network or via the parallel port. You will need a serial cable to connect to digitizers and possibly to your plotter. This cable must have the proper connectors to match your exact equipment combination. As you work to set up your digitizer and plotter, you may experience a situation that is different from the one described in this Device Interface Guide. If this happens to you, follow the steps below: 1. 2. Reread the guide to make sure you have followed the steps given. Repeat the steps and record exactly what you have done and what has happened during each step. You will need to supply this information to Mintecs Technical Support personnel.
3.
For PCs, run winmsd, choose File$Save Report, and toggle ON the All Tabs and Complete options. Send this report to Mintecs Technical Support group. When you reach the point of being able to duplicate the error you experienced, call Mintecs Technical Support for assistance (see Appendix A for Technical Support
1-1
4.
Chapter 1Digitizers
telephone numbers). 5. Have the Computer and digitizer or plotter available for testing during your telephone conversation with Mintec personnel.
Be sure your cable has the correct gender and number of pins on both ends. A wide array of adapters is available to convert the number of pins, gender, and routing of wires. It is easier to use these than to rewire the cable for a new connector. The path that the wires take within the cable is as important as the connectors themselves. This guide is not designed to explain the intricacies of serial communication, but there are several points that should be made. Data actually flows in only two of the wires. These are numbered 2 and 3. In order for data to flow, these wires (pins) must be connected to the appropriate pins on both hardware devices. Sometimes you will need to connect 2-2 and 3-3. This is called a straight through cable. Other cases require connecting 2-3 and 3-2. This is known as a crossover cable. Often an adapter is used to convert the 9-pin to a 25-pin connector. These adapters (called pigtails) are usually crossover connections, but occasionally they are straight through connections. Be sure to check which type you have. A null modem is also a crossover connection. The rest of the pins communicate the current state of the ports on both the computer and the hardware device. The MineSight device drivers do not use these pins, except where noted in the diagram below. The following diagram shows a general wiring scheme for most MineSight device drivers. The Zeta plotter driver is the only exception. Note that this is a generalized schematic and that, in 99% of the cases, more simple cables can be used. If you are already using a cable with other software and it does not match the diagram below, try it with MineSight. Chances are very good that it will work with no changes. Also, if you plan to use other software with the device, configure the cable for the other software. Other packages usually place more constraints on the cable design.
1-2
Chapter 1Digitizers
1-3
Chapter 1Digitizers
MineSight Device Driver Schematic
On PCs, the serial ports must be configured in the standard manner. If the configuration of the serial ports is not standard, MineSight will not recognize it. You can change the address and IRQ by entering the Control Panel (click on the Start button, then on Settings), and then clicking on the Ports icon $ Settings $ Advanced. Below is a table of the standard IRQs and Addresses for COM1 and COM2.
COM1 Serial port 1 Address IRQ 03F8-03FE 4 COM2 Serial port 2 02F8-02FE 3
These ports must not be under the control of a driver program that does not use the driver, such as wintab.exe. If a driver is in control of the port, then Windows NT will not allow other software (such as MineSight) to access the port. Similarly, the port cannot be dedicated as a pointing device if it is to be available to MineSight. If the tablet is configured as a pointing device, then it cannot be used as a digitizing device.
1-4
Chapter 1Digitizers
To disable wintab, enter the Control Panel and select Devices. Use the slider bar to get to the "W" listing, click wintab to select it and click on the HW Profiles button, then on the Disable button. Also, check for ccntdrv in the Services icon under the Control Panel. Reboot Windows NT, log in, start Hyperterminal and digitize a test point.
Note that AutoCAD does not need to use wintab. AutoCAD has drivers for most digitizers and can be configured to use the AutoCAD ADI digitizer driver. Using the ADI driver removes the WINTAB/MineSight conflict. With this key information you are ready to look at the second step for interfacing hardwarethe software interface.
1-5
Chapter 1Digitizers
1-6
Chapter 1Digitizers
1-7
Chapter 2Digitizers
Chapter 2Digitizers
Recommendations
CalComp Series 9100 and CalComp-compatible digitizers are recommended for use with MineSight. Because most of our clients use these digitizer models, Mintecs Technical Support group has accumulated a large bank of information on how they interface with MineSight programs. Other digitizer models are also supported by MineSight. In general, MineSight expects ASCII point data from the digitizer. Device configuration tables are included for every supported model. Additional information from the Technical Support data bank is provided where it is known.
Installation on PCs
Connect an RS232 cable from COM1 or COM2 to the digitizer. ICOMM=0 corresponds to port1 and ICOMM=1 corresponds to port2 in the DIGIT.INF file. Digitizers are commonly used to input data in the initial stages of a project. Therefore, the digitizer driver is often configured before the plotter. Configuring the digitizer is a two-step process: 1. Use a communications program, like Hyperterminal, to verify data communication between the digitizer and the computer. Once data is flowing between the computer and the digitizer, make any necessary changes to the DIGIT.INF file and try running the M650ED program.
2.
2-1
Chapter 2Digitizers
Verify Data Communications 1. From the Windows Program Manager Select File$Run. Type Hyperterminal and press Enter. The first thing that Hyperterminal will seek is a name for the connection. Enter a name and select an icon.
Next, Hyperterminal will request a telephone number. Leave these spaces blank and enter only the communications port that the digitizer is using.
2-2
Chapter 2Digitizers
2.
From the COM Properties window, select the baud rate, data bits, parity, stop bits and flow control that correspond to your anticipated digitizer settings. Check Hardware for Flow Control.
3.
2-3
Chapter 2Digitizers
4.
If data appears on the screen, you have successfully established communication and you can skip to the next section. If the computer screen is blank, then you are using the wrong cable configuration or the wrong communications parameters, or the digitizer is not sending data. Continue with the remaining steps. Recheck the switch settings on the digitizer and the current communications parameters that Hyperterminal is using. Make sure Hyperterminal is using the correct COM port. Try changing the port to COM1 or COM2, or look at the back of the computer. Check the cable for problems in the continuity of the data lines. If at this time you still see no data on the computer screen, swap pins 2 and 3 in the cable by adding a null modem adapter to your cable configuration and try again. A null modem adapter has a 2-3 pin crossover and is included with MineSight. If the data that appears on the screen is not in the expected format, ensure that the communications parameters are identical for Hyperterminal and your digitizer. Once these values match, you should see the data on the computer screen exactly as it is received from the digitizer. The format MineSight expects is given by the value in the ITYPE files in DIGIT.INF. Make note of the communications parameter values for use with the DIGIT.INF program. Move to your MEDEXE directory and use a text editing program to update the communications parameters in your DIGIT.INF file. Refer to Flow Chart 1 for more information.
5.
6.
7.
8.
9.
10.
2-4
Chapter 2Digitizers
2-5
Chapter 2Digitizers
2-6
Chapter 2Digitizers
Run M650ED The M650ED program is an interactive VBM editor. One of the capabilities of this program is digitizing directly into a VBM File 25. We will use this program to test the digitizer setup. In order to do so, we need a VBM File 25 with which to perform the test. Step One is to initialize one of these files. 1. Start M650ED. To do this, go to: Group: VBM Operation: Edit Procedure: Edit VBM Data
On the first panel, enter the name of your VBM File 25. Click Next
2-7
Chapter 2Digitizers
Fill in the second panel as pictured below. Click Next. M650ED will open.
2.
Now that you are in M650ED, you need to get into digitizer mode. Click on the digitizer icon. The digitizer icon is in the upper right portion of the screen. Then click on Digitizer On. You will be asked if the digitizer is connected; answer Yes. The digitizer setup window should appear on your screen. Click on 4, indicating that you want a four-point setup. Now click on four points on your digitizer. You will now be prompted for the coordinates of those points. Enter these coordinates.
3.
2-8
Chapter 2Digitizers
4.
The setup should be complete. Test the setup by clicking on Test Point and then clicking on a point with known coordinates on the digitizer. The coordinates will appear on the screen. If these coordinates are correct, click Exit. If the coordinates are incorrect, redo the four-point setup.
5.
To digitize more test points, go to menu strip 2 by clicking on the 2" in the lower right corner, and click on New Feature. Enter a feature code and plane number (these can be anything because you will not be saving this data). Now digitize a few points. You should see a line appearing on the screen. If this is the case, then your digitizer is set up correctly.
2-9
Chapter 2Digitizers
2-10
Chapter 2Digitizers
2-11
Chapter 2Digitizers
DIGIT.INF File
Purpose DIGIT.INF contains information used by all MineSight programs that interface with a digitizer. This data determines which device driver the program will use, and how the program will communicate with the digitizer. Location Your primary copy of DIGIT.INF should be located in the MEDEXE directory, but you may also copy it to your project directories. If you do, that copy will be used before the one located in MEDEXE. For sites with multiple projects or more than one digitizer, this method ensures that the appropriate DIGIT.INF file is used. If no copy is found, you will be asked to accept or reject the default parameters. These default parameters can be found in the Device Configuration Tables. Structure DIGIT.INF is an ASCII file composed of seven lines. Print two copies of this file, one for your project book, and one to put on the digitizer. Once you have the digitizer working correctly, this file needs no further attention. If, however, you obtain a new digitizer or change the emulation of your current one, the parameters in the DIGIT.INF file will need to be updated. Use a text editing program to change the copy in the MEDEXE directory, then copy the new file to all directories where this file exists. Line 1 2 3 4 5 6 7 Column 1-2 1-2 1-2 1-2 1-2 1-2 1-20 Description MineSight device driver code Baud rate code Parity code Number of data bits Number of stop bits Communications port code Optional digitizer output format
Line 7 of DIGIT.INF is used to modify the default format of the digitizer output. If line 7 is blank, the default is used. The default format is listed in each sample DIGIT.INF. The form of the optional format must be the same as that of the default. For example, the default formats of the data sent from the digitizer assume that the digitizer is using Imperial coordinates. When the digitizer is set up to use Metric coordinates, the output from the digitizer normally has more digits for the X and Y coordinates. In order to provide support for digitizers using Metric coordinates, MineSight allows the width of the coordinate field to be changed.
MineSight Device Interface Guide
2-12
Chapter 2Digitizers
For example, the default format from the CalComp 9100 digitizer using the Data Format 3 and Imperial coordinates is: cmxxxxxyyyyy which has one column for the digitizer puck key that is pressed, one column for the type of output (d for discrete), and five columns each for the X and Y coordinates. The CalComp 9100 digitizer using the Data Format 3 and Metric coordinates is: cmxxxxxxyyyyyy which has one column for the digitizer puck key that is pressed, one column for the type of output (d for discrete), and six columns each for the X and Y coordinates. The formats are FORTRAN statements and have specific structures. Normally, the only change would be to the number of digits used to specify the X and Y coordinates. The optional format can change the number of characters in each field, but cannot change the order of the fields. For example, the CalComp 9100 series (format 3), which is itype 9, has a default format of: A1, 1X, 2I5 It can be changed to: A1, 3X, 2I7 or A1,1X,I6,I6 but not to: 2I7, 3X, A1 or I6,I6, 1X,A1
Below is a typical (default) DIGIT.INF file: 9 7 1 7 1 0 /* ITYPE (CalComp 9100 data format 3) /* BAUD (7=9600,6=4800,5=2400,4=1200,3=600,2=300,1=150,0=110) /* PARITY (0 = NO PARITY, 1 = ODD, 2 = EVEN) /* WRDLEN (7 OR 8) /* STPBIT (1 OR 2) /* ICOMM (0 = PORT 1, 1 = PORT 2) /* OPTIONAL FORMAT
2-13
Chapter 2Digitizers
2-14
Chapter 2Digitizers
2-15
Chapter 2Digitizers
On the SGI Workstation: Connect the digitizer to serial port 2. Serial port 1 on most SGIs is an auxiliary console, and should not be used. In /etc/inittab, make sure there is a line that says: t2:23:off /sbin/getty -N ttyd2 co_9600 It should be there by default. As user root: ln -s /dev/ttyd2 /dev/digitizer
2-16
Chapter 2Digitizers
DIGIT.INF Codes The following two tables list the codes used in the DIGIT.INF filethe MineSight device driver codes, baud rate codes, parity codes, and communications port codes. MineSight Device Driver Code Description
Kurta Digipad Series I and Series III CalComp 9000 Series (Talos) Numonics Model 224 CalComp Model 9001 GTCO 5A and 5LA Series (16 button cursor) GTCO 5A and 5LA Series (4 button cursor) Altek AC 90C Datatab CalComp 9100 Series (data format 3) Summagraphics Microgrid Series CalComp 2000 Series Numonics Model 1224 CalComp 9100 Series (data format 1) Houston Instruments Complot 7000 Series or Summagraphics Summasketch Series (1000 lpi) Geographics Drafting Board Digitizer Summagraphics Summasketch Series (500 lpi) IBM 5084 Model 3 Summagraphics Summasketch (1000 lpi) (no initialization codes) CalComp (data format 3) (no initialization codes)
Number
0 1 3 5 6 7 8 9 10 11 12 13 17 18 19 20 21 23
Baud Rate Codes Code 0 1 2 3 4 5 6 7 Baud 110 150 300 600 1200 2400 4800 9600
Optional Format Entry Blank Non-blank Format Uses default Uses given
2-17
Chapter 2Digitizers
Alteck AC 30 Datatab
Default Parameters Device Code Baud Rate Parity Data Bits Stop Bits Communications port Optional Format 8 1200 Odd 7 2 COM1 Typical DIGIT.INF File 8 / itype 4 / baud rate 1 / parity 7 / data bits 2 / stop bits 0 / icomm A1, 2(1X,I5) Data Format Standard Set (FMT) 1. CbsXXXXXbsYYYYY<cr>(<lf>) 2. CsXXXXXsYYYYY<cr>(<lf>) 3. C,sXXXXX,SYYYYY<cr>(<lf>) 4. CbXXXXXbYYYYY<cr>(<lf>) 5. CSsXXXXXSYYYYY<cr>(<lf>) 6. rsXXXXXsYYYYYt 7. SF,sXXXXX,sYYYYY<cr>(<lf>) 8. Binary Format (6 Bytes) Alternate Set 1. CXXXXXbYYYYY<cr>(<lf>) 2. CXXXXXYYYYYb<cr>(<lf>) 3. XXXXX,YYYYY,C<cr>(<lf>) 4. CbXXXXXbYYYYY<cr>(<lf>) 5. CSXXXXXYYYYY<cr>(<lf>) 6. SXXXXXbYYYYYC<cr>(<lf>) 7. Binary Format (5 Bytes) 8. Binary Format (8 Bytes) where: b = blank s = sign X = x value Y = y value C = cursor key code 0-9, A-F (16 codes) r = ASCII STX t = ASCII ETX S = Status (U or D) <cr> = return <lf> = line feed Switch Settings - Altek AC30 (S2 - 6,7,8) ON ON ON ON OFF OFF OFF OFF ON ON OFF OFF ON ON OFF OFF ON OFF ON OFF ON OFF ON OFF
Rate 2 5 10 14 20 25 50 100
#, FORTRAN format (1) A1,2X,I5,2X,I5 (2) A1,1X,I5,1X,I5 (3) A1,2X,I5,2X,I5 (4) A1,IX,I5,1X,I5 (5) A1,2X,I5,1X,I5 (6) 2X,I5,1X,I5,A1,1X (7) 1X,A1,2X,I5,2X,I5 (8) BINARY
2-18
Chapter 2Digitizers
On Of f
(10) Rate/Increm Resolution (0.001") Line Feed Menu
1 S2
On Of f
NOT USED (1200) Baud Rate (4) Format
JUMPE R H1
A*
JUMPE R H2
B C
E F
8 / itype 4 / baud rate 1 / parity 7 / data bits 1 / stop bits 0 / icomm A1,2(1X,I5)
Fortran format is: A1,2(1X,I5) /format ASCII Output is: Cbxxxxxbyyyyy<cr>(<lf>) where C = cursor key code b = blank x = x digitizer coordinate y = y digitizer coordinate c = cursor key code <cr> = carriage return <lf> = line feed
2-19
Chapter 2Digitizers
Mode T M P 7/8
Parity 1 2 3
Baud Rate 1 2 3 1
Format 2 3 4 LF
2-20
Chapter 2Digitizers
SW1
U D
SW2
U D 7 Data Bits 1 Stop Bit Parity Odd Tablet Size - See chart
SW2 Tablet size Switches 5-8 9120U D D D 9240D U D D 9360U U D D 9480D D U D 9600U D U D U=Up D=Down
SW3
Note: To emulate a 9100/Data Format 1 digitizer, set the device code to 13 and the baud rate to 7 (9600 baud).
2-21
Chapter 2Digitizers
2-22
Chapter 2Digitizers
2-23
Chapter 2Digitizers
Old Style 9100 These boards are located inside the digitizer and must be removed to change the settings. Pay attention to the position of each internal board. They must be put back in the same way.
SB1 Tablet size Switches 7 & 8 91140: C O 91170: C C 91250: O C 91240: C C 91360: C O 91480: O C 91600: O O O=Open C=Closed
1-Port B/D 23-LF Port A/C 4-Port A/C 5-Small Menu 6-Cursor 7-Echo B/D 8-LF B/D 2-24
Chapter 2Digitizers
On Off
2-25
Chapter 2Digitizers
1 Bank A On Off
Pt Mode
10
11
12
13
14
15
16
17
18
Increment
Resolution
Format
LF
Data bits
Bank B
On Off
9600 baud Parity
See your Drawing Board documentation for full descriptions of all switch settings.
Mode T M P 7/8
Parity 1 2 3
Baud Rate 1 2 3 1
Format 2 3 4 LF
2-26
Chapter 2Digitizers
10
11
12
13
14
15
16
17
18
Bank B
On Off
9600 baud Parity - odd
2-27
Chapter 2Digitizers
10
11
12
13
14
15
16
17
18
Bank B
On Off
9600 baud Parity
Bank C
On Off
CR
2-28
Chapter 2Digitizers
Area 1
1 On Off
1 0
1 1
1 2
1 3
1 4
1 5
1 6
17
Point Mode
Area 2 On Off
9600 Baud 7 Data Parity - Odd Bits 1 Stop TX pin Line Bit 2 Feed Port Echo
Switch TX to ON for transmitting on pin 3. This will emulate a null modem. This setup emulates a CalComp 9100 and, as with the 9100, the setup must be saved as User1 (the default).
2-29
Chapter 2Digitizers
2-30
Chapter 2Digitizers
1 S1 On Off
9600 Baud
Parity Odd
Stop Bits
Data Bits
S2
On Off
See GTCO documentation for a full description of all switch settings.
S3
On Off
See GTCO documentation for a full description of all switch settings.
2-31
Chapter 2Digitizers
For the four-button format, change the S3 switch 5 to OFF. The other switch settings remain the same. Or use CalComp formats, if using CalComp emulation mode.
2-32
Chapter 2Digitizers
2-33
Chapter 2Digitizers
2-34
Chapter 2Digitizers
2-35
Chapter 2Digitizers
Numonics 224
Default Parameters Device Code Baud Rate Parity Data Bits Stop Bits Communications port 3 1200 Even 7 1 COM1 Typical DIGIT.INF File 3 / itype 4 / baud rate 2 / parity 7 / data bits 1 / stop bits 0 / icomm Data Format Variable, single, and multiple cursor button modes are supported. Single button - Each string must consist of the digitizer X coordinate followed by a separator, the digitizer Y coordinate, and the end of string character. Valid separators include the space and comma characters. Multiple button - Each string must consist of the cursor code followed by a separator, the digitizer X coordinate followed by a separator, the digitizer Y coordinate, and the end of string character. Valid separators include the space and comma characters.
Optional Format
n/a
/ blank line
2-36
Chapter 2Digitizers
Optional Format
n/a
/ blank line
2-37
Chapter 2Digitizers
2-38
Chapter 3Plotters
Chapter 3Plotters
Recommendations
Mintec recommends that the plotter be connected to the computer via Ethernet or a parallel cable. This type of connection is many times faster than a serial connection. If the plotter is connected by one of these recommended connections, you can create deferred plots, then use the copy or network print command to send the deferred plot to the plotter. In this method, the PLOT.INF information file is used to define the page size, model number, and step size.
Installation
The installation of a plotter is a two-step process. 1. 2. Verify the setup of the PLOT.INF file and the plotter switch settings. Run a plot using MineSight.
Verify the Setup 1. Copy M122xx to M122V1, and Plotxx to PlotV1, where xx = CC = CalComp (906 PCI Controller) ZT = Zeta TN = CalComp (907 PCI Controller) HP = HPGL H2 = HPGL/2 HPGL/2 (or M122H2 or PLOTH2) is the default plotter, which is installed as m122v1 or plotv1. If the program shows the wrong device driver, replace it with the appropriate program version. Available versions for M122V1.EXE and PLOTV1.EXE are included on the installation CD. Locate this file, uncompress the appropriate M122XX.EXE and PLOTXX.EXE files, and rename them M122V1.EXE and PLOTV1.EXE, respectively. 2. Check the switch settings on the plotter and refer to the plotter operations manual for their meanings. Compare them with the parameters listed for your plotter in the Device Configuration Tables. Make any necessary changes. Edit the PLOT.INF file to make sure that the parameters in the information file are correct. Make any necessary changes (e.g., copy PLOT.HP to PLOT.INF for HPGL and HPGL/2; copy PLOT.907 to PLOT.INF for CalComp).
3.
3-1
Chapter 3Plotters
Run M122V1 You will need a MineSight run file for program M122V1. If you do not have plotting run files available on a project directory, you will find a number of M122V1 run files on the MSOP, MSUG sample project (this was optional in your installation). The run files are named RUN122.ext, where ext is a variable file name extension. The run file should contain some simple plot commands such as LINE, BORDR, GRID and LABEL. 1. Move to the directory that contains the M122V1 run file and type the command: M122V15 This will begin the M122V1 program using the appropriate driver for your plotter. 2. When the program begins, it prompts you for a run file. Enter the appropriate name. The map size will appear. The program then displays the driver it is using and the communications parameters it will employ. You can choose either to exit at this point or to continue plotting. If any of the above information is incorrect, you must exit the program or it will freeze. If the program shows the wrong communication parameters, change to the MEDEXE directory and use a text editing program to update the parameters in PLOT.INF. Copy the updated file to all directories where this file exists. When the map and communications parameters are correct, plot the map or create a deferred plot. If the plotter responds to the computer commands and all looks good, your setup is complete. If not, continue through the next steps very carefully. If the plot has the wrong size, check the MAP line in the run file to be sure that the appropriate X and Y values have been entered. Also check the PLOT.INF file to see if the appropriate step size has been used. If the map has other problems with appearance, check your run and report files to make sure all the plot commands are valid. If you get a Fortran error or any error message on the computer screen, the problem is most likely in the communications parameters. Check the parameters in PLOT.INF very carefully against those found on the plotter and in the plotter manual. If the program still does not work after making any necessary modifications, call Mintec for help. If the program freezes the computer and the plotter does not respond, the problem is most likely in the cable or the plotter itself. First, make sure that the plotter is properly connected to the computer, is initialized, and is ready to accept plot commands. If the program continues to freeze the computer, try swapping pins 2 and 3 in the cable. If the
3-2
3.
4.
5.
6.
7.
8.
Chapter 3Plotters
plotter still does not respond, call Mintec for further assistance.
9.
If you have exhausted these solutions, you will need to use a breakout box. The breakout box has LEDs that display the changing voltages in the cable wires. With this box, you can decide if your cable needs to be rewired and if any data is passing to the plotter or back to the computer. This information is essential to further debugging efforts.
Note: Most HP plotters using HPGL can use a maximum of 8 pens; those using HPGL/2 can use up to 256 pens. Exceptions to the set available with MineSight are: 7470 Series 7220 and 9872 Series 7475 Series 2 pens only 4 pens only 6 pens only
3-3
Chapter 3Plotters
PLOT.INF File
Purpose PLOT.INF contains information used by all MineSight programs that interface with a plotter. This data determines which device driver the program will use, and how the program will communicate to the plotter. Location Your primary copy of PLOT.INF should be located in the MEDEXE directory, but you may copy it to your project directories also. If you do, that copy will be used before the one located in MEDEXE. For sites with multiple projects or more than one plotter, this method ensures that the appropriate PLOT.INF file is used. If no copy is found, you will be asked to select a set of communications parameters. These default parameters can be found in the Device Configuration Tables. You must, however, have the appropriate executable for your plotter. The plotting programs have a unique executable version for each plotting device. When MineSight is installed, the unique version for your plotting device is installed under the common name M122V1.EXE. For example, the M122V1 version used for plotting on a Hewlett Packard plotter is in the installation files as M122H2.EXE, but is copied to your MEDEXE directory as M122V1.EXE. Structure PLOT.INF is an ASCII file composed of 12 lines. Once the plotter is working correctly, this file needs no further attention. If, however, you obtain a new plotter or change the emulation of your current one, the parameters in the PLOT.INF file will need to be updated. Use a text editing program to change the file in the MEDEXE directory, then copy the new file to all directories where PLOT.INF exists. If you obtain a second plotter, the procedure will be different. In this case, change the PLOT.INF parameters in the project directory copy of the file using your text editor. Copy this file to any directory that will use the second plotter. This is a typical PLOT.INF file. 4 7 0 8 1 0 7586 2 1013 00 00 1016 /* ITYPE (4=ALL PLOTTERS) /* BAUD (7=9600,6=4800,5=2400,4=1200,3=600,2=300,1=150,0=110) /* PARITY (0 = NO PARITY, 1 = ODD, 2 = EVEN) /* WRDLEN (7 OR 8) /* STPBIT (1 OR 2) /* ICOMM (0 = PORT 1, 1 = PORT 2) /* PLOTTER MODEL NUMBER /* VERSION CODE /* PAPER SIZE CODE /* /* /* PLOTTER STEP SIZE /* BLANK LINE MUST BE HERE.
3-4
Chapter 3Plotters
1 2 3 4 5 6
**These settings are not relevant if the plotter is connected to computer network via Ethernet or parallel cable** Lines 1 and 7-12 are important because they define that it is a plotter that is being employed, and they also define the page size and step size.
PLOT.INF Codes The following table lists the codes used in the PLOT.INF filethe MineSight device driver codes, baud rate codes, parity codes, and communications port codes.
MineSight Device Driver Code Device All plotters Code 4 Baud Rate Codes Code 0 1 2 3 4 5 6 7 Baud 110 150 300 600 1200 2400 4800 9600 Parity Codes Code 0 1 2 3 4 Parity None Odd Even Mark Space Communications Port Code 0 1 Port COM1: COM2:
3-5
Chapter 3Plotters
On the SUN Workstation: In the /dev directory, the following softlinks need to exist: /dev/plotter (device node to which plotter is attached) Typically, the command that user root uses to make these links looks like this: ln -s /dev/ttyy07 /dev/plotter where ttyy07 is the device name for the serial port to which a plotter is connected. The permissions for the softlink must be read/write/execute for everyone. To check these permissions, type the following command: ls -l plotter and it must return something similar to the following: lrwxrwxrwx 1 root other oct 13 12:22 /dev/plotter -> /dev/ttyy07. /dev/plotter corresponds to ICOMM1 in the PLOT.INF file.
On the SGI Workstation: Connect the plotter to serial port 2. Serial port 1 on most SGIs is an auxiliary console, and should not be used. In /etc/inittab, make sure there is a line that says: t2:23:off /sbin/getty -N ttyd2 co_9600 It should be there by default. As user root: ln -s /dev/ttyd2 /dev/plotter
3-6
Chapter 3Plotters
Device Code Baud Rate Parity Data Bits Stop Bits Communications Port Communications Scheme
4 9600 None 8 1 COM1 PCI mode used. ACK/NAK must be used. XON/XOFF and synchronous modes not supported. 1 (enabled) 02 03 0 2032 906
4 / itype 7 / baud rate 0 / parity 8 / data bits 1 / stop bits 0 / communication port 1 / number of synchronous characters
Checksum Synchronous Character End of Record Character Plotter Model Code Plotter Step Size Controller Type
1 / checksum enabled 02 / synchronous character (22 for AutoCAD) 03 / end of record character (13 for AutoCAD) 0 / plotter model code for 1020 series (1 for all others) 2032 / plotter step size 906 / controller
Note: The step size in the PLOT.INF file should match the step size of the plotter.
3-7
Chapter 3Plotters
1 / checksum enabled 02 / synchronous character (22 for AutoCAD) 03 / end of record character (13 for AutoCAD) 0 / plotter model code for 1020 series (1 for all others) 2032 / plotter step size 907 / controller
Note: The step size in the PLOT.INF file should match the step size of the plotter.
3-8
Switches 0 1 1 1 1 0 0 0 1 1 0 0
S4
On Off
Character framing End of message character
S5
On Off
Full/half duplex Ack/ Nak Not used
S6
On Off
Sync character No dbl sync
3-9
Chapter 3Plotters
Device Code Baud Rate Parity Data Bits Stop Bits Communications Port Plotter Model Code Plotter Version Code Paper Size Code
4 / itype 7 / baud rate 0 / parity 8 / data bits 1 / stop bits 0 / communication port 7586 / plotter model number (HP 7586 plotter) 2 / version code (i.e., for 7586B plotter, vers code=2) 1013 = Roll feed paper
SIZE BORDERS NORMAL EXPANDED
A B C D E
14 13 12 11 10
/ blank line / blank line Plotter Step Size 1016 1016 / plotter step size, 400 for metric
3-10
Chapter 3Plotters
Device Code Baud Rate Parity Data Bits Stop Bits Communications Port Communications Scheme Checksum
4 9600 None 8 1 COM1 Software handshake with or without checksum used. 1 (enabled)
4 / itype 7 / baud rate 0 / parity 8 / data bits 1 / stop bits 0 / communication port 1 / number of synchronous characters 1 / checksum enabled / blank line / blank line / blank line / blank line
Cable Configurations for Bruning-Zeta Plotter Error Correct Computer Plotter Non-error Correct Computer Plotter
2 ______ 3 3 ______ 2 4 ______ 4 5 ______ 5 6 ______ 20 7 ______ 7 8 ______ 8 20 ______ 6 22 ______ 22 Software handshake with checksum
2 ______ 2 3 ______ 3 4 ______ 4 5 ______ 5 6 ______ 6 7 ______ 7 8 ______ 8 20 ______ 20 22 ______ 22 Hardware handshake without checksum
3-11
Chapter 3Plotters
Run the Procedure and Create a Deferred Plot File After you run your procedure to create a plot file, view the plot file using M122MF (choose V = Preview/Create Metafile from the mplot menu). Then select D = Dump Deferred Plot File from the mplot menu to create a deferred plot file.
3-12
Chapter 3Plotters
Run pentab.dat Run pentab.dat, define your pen colors, and input the name of the deferred plot file that you just created.
Pentab.dat can create an external pen definition file and insert it into your HPGL-2 deferred plot file, which will control the colors and widths of any pens specified in the plot file (up to 32 pens). This will override the plotters current palette settings.
3-13
Chapter 3Plotters
The procedure can also read an existing pen definition file located in your project directory. This is useful in that you can set up and save multiple pen definition files to be used at any time, without having to fill out the procedure panels each time. Considerations: HPGL-2 deferred plot files must already exist in the project directory. Under DOS and Windows NT operating systems, a text editing program must be in your path statement. Plotters palette must be set to Software Palette.
Format of the palette file: (without the comments) SD6,3 /Font Boldness Value NP32 /Number of Pens to be defined (32 max. in procedure - 255 max manually) PC1,245,245,0PW0.18,1 /PEN1, Red Value, Green Value, Blue Value, Pen Width, Pen # PC2,233,245,0PW0.18,2 . . . PC32,123,123,123PW0.2,32
3-14
Chapter 3Plotters
In Advanced Procedures Using a pen palette in the Advanced Procedures requires only one step. When you run the procedure and create a deferred HPGL/2 plot, the pen color palette definition file that you selected is automatically inserted into the deferred plot file. You can select an existing pen definition file or customize a new one. In the advanced procedures, check the box Use/Create a pen definition file?, as shown in the center of the figure below. This check box is just below the part of the panel that asks which M122 program to use. (Red lettering means there is pop-up help.)
3-15
Chapter 3Plotters
If you check the Use/Create a pen definition file? box in the advanced procedures, the pen definition panel will be displayed, as shown below:
Choose to use an existing pen definition file, or define new pen colors and let the procedure write a new pen definition file. To use an existing pen definition file, the file must already exist in your local project subdirectory. If you choose to let the procedure write a new pen definition file, a new file will be created in the directory where you are working. Warning: If you want to use an existing pen definition file, you must check the box Use an existing pen definition file? Otherwise, a new file will be created and the old file of the same name will be overwritten. As always, we recommend you keep a backup copy of your existing pen definition file.
3-16
Chapter 3Plotters
Match Plot Colors to Screen Colorspentab.med For regular plotting procedures, when running pentab.dat use the pen definition file that was created for this purpose, pentab.med. This pen definition file closely matches MineSights standard 16 pen colors that display on the screen (defined in the color.tab file), although the 16th pen is black in color.tab, and that pen is white in pentab.med. Copy pentab.med to your local directory from the \MEDEXE directory (or whatever the standard MineSight executable directory is named on your system). If you are unsure which Red, Green, Blue combination of colors make a particular color, check your plotters demo color chart or look at the help file for the procedure pentab.dat. When using an advanced plotting procedure, indicate that you wish to use the pentab.med pen definition file and the procedure will automatically insert the pen palette information in the HPGL/2 deferred plot that was created through the procedure.
Match Screen Colors to Plotter Colorscolor.tab You can also change the default screen colors to match your plotters colors by specifying the red-green-blue components for any pen in a special file called color.tab file. Editing the screen colors directly in M122MF will create a local, custom copy of the color.tab file. There are 255 available pens from which to chose. MineSight uses 15 default colors, which are defined in the file pentab.med (defines plotter colors) and color.tab (defines screen colors). These default colors are: 1 2 3 4 5 6 7 8 = = = = = = = = Black Green Blue Red Magenta Brown Cyan Light Grey 9 10 11 12 13 14 15 = = = = = = = Cyan Light Green Light Red Light Blue Light Magenta Light Yellow Dark Grey
3-17
Chapter 3Plotters
M122MF - Modifying pen colors If you are creating a deferred plot, you can use the color.tab file directly by including the file as File 30 on the names line of your M122H2 run file, and setting IOP32=1. If IOP32=0, File 30 will be treated as a pentab.dat format file.
3-18
Toll Free Technical Support Numbers USA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . (800) 533-6337 Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . (800) 548-6337 South Africa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0800-996052 Mexico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 (800) 548-6337 Chile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123-020-2154 Peru . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 001800-533-6337
E-mail [email protected]
Appendix Bi
Appendix Bi
notes:
New Tools
Digitizer
MineSight 2.5 can interface directly with Mintec supported digitizer tablets. You can now digitize maps or other data directly into MineSight 2.5 Geometry Objects. MineSight supports any digitizer that has a Wintab driver. To install a digitizer for use with MineSight: 1. Obtain the latest Wintab drivers for the digitizer. Wintab drivers should be available from the hardware vendor or from the manufacturers website. 2. Connect the digitizer to the serial port. 3. Switch on the digitizer. 4. Run Setup for the Wintab driver, and follow the installation instructions. You will need Administrator permissions. 5. Reboot the computer.
Page 1
notes:
6. Depending on the Wintab driver used, you can modify digitizer parameters, such as number of buttons, port settings, motion speed, and so on in these places: t t t During Wintab setup. In Windows Control Panel (Wintab setup creates a program item for Wintab settings). In a new folder created by Wintab setup (this folder may also contain help files).
To use a digitizer with MineSight: 1. Click the Digitizer choice in the Tools menu.
Page 2
A. Choose the orientation of the map that you will be digitizing in Setup Coordinate System.
notes:
Plan East West section North South section Non-Orthogonal vertical section
B. Pick either a 2-point or a 4-point setup type. The default is 4-points, as this gives better definition. C. Clear any unintentional points in the digitizer buffer by clicking the Clear All button, then digitize the 2 or 4-control points. D. Type in the associated X, Y coordinates of the control points. Note that the label of the X, Y coordinates change with the orientation of the map. E. Click Calc Offsets to place the digitized data into your project area. F. Digitize a test point. Assigning Puck Buttons MineSight allows you to configure the digitizing puck so that the buttons on the puck can automate certain tasks, such as adding a point, removing an unwanted point, or ending the input for the current polyline. By default, all buttons on the puck add points to the current polyline.
Entering Points With the Digitizer All polylines created with the Digitizer Tool are 2-D polylines. Except in the case of Non-Orthogonal vertical sections, one of the three coordinates will be constant. To control the constant coordinate, enter the desired value in the Point Digitizer window. For example, if you are digitizing topographical contours in plan, enter the elevation of the contour that you are digitizing in the Point Digitizer window. Click the Apply button. To change elevations, enter the new elevation in the Point Digitizer window ,and click the Apply button. You can change any or all three of the coordinates of a point by typing in the desired coordinate in the appropriate window, and clicking the Apply button.
Page 3