KONTRON ELECTRONICS SOFTWARE RELEASE NOTICE NUMBER: 2300-5112-06-32 DATE TYPED: october 29, 1985 SUBJECT: Release v6.32-Z CP/M 2.2 System and Utilities ORIGINATED BY: APPROVED: ECO # 2565 DATE ISSUED: 10/29/85 ETM # PAGE: 1 OF 16 ================================================================= 1.0 SCOPE This document describes release v6.32-Z of CP/M 2.2 System, Utilities, and CP/Net Requestor v6.31-Z Parts Affected: Part No. Title Old Rev. New Rev. KDS-6005 CP/M 2.2 System and 01-06 06-32-Z Utilities Disk KDS-6006 CP/M 2.2 Utilities 01-06 06-32-Z KDS-6003 CP/Net Requestor 01-02 06-31-Z 2.0 CHANGE SUMMARY 2.1 New Features 1. The keyboard now has a type ahead-buffer, and no longer supports the 2300 ADS keyboard. 2. Support for a 1-Megabyte RAM Disk has been added, with 256 directory entries 3. The serial port drivers have been rewritten to fully support ports A, B, C, and D. 4. Support for the downloadable keyboard has been included. 5. Changes have been made to various CP/M Utilities as described in Section 7.0, DETAILED FUNCTIONAL DESCRIP- TION. 6. COPYSYS has been replaced by the standard CP/M program SYSGEN. 2.2 SDRs Fixed SDR Description 770 KONPROM now runs correctly from command files. 821 MODEM7 talks to VAX, at high speeds. 838 BCOMPARE now handles files containing less than 8K correctly. 841 COPYSYS (SYSGEN) to write protected disks no longer hangs. 847 Accessing the hard disk after booting from floppy now works correctly. 857 KONPROM now has a default start address so it won't crash if is entered for this prompt. 859 I/O Byte access for serial ports B, C and D has been added. 876 MODEM7 now uses the XON/XOFF communication proto- col when sending data. 886 SETSIO now handles all four serial ports. 887 Serial ports now work in a consistent manner. 900 Editing a zero length file does not cause system to hang. 915 COMPKG.COM no longer hangs if the requested source file not present. 3.0 KNOWN PROBLEMS 3.1 Outstanding SDRs SDR Description 879 EDIT.COM attempts to create a file when the disk is full. 889 FINDBAD.COM is "too picky" about drive labels. 894 SD.COM "d" option does not work correctly. 926 RENAME.COM can't handle a drive label on source filename. 3.2 BIOS Related 1. "Home Disk" BIOS call has no affect. 2. The CRT driver acts strangely if an attempt is made to backspace past the upper-left corner of the screen (row 0, column 0). 3. ESC-P-0 turns on BIOS error messages, and ESC-P-1 shuts them off. This is inconsistent with the manual. 3.3 Utilities 3.3.1 3.3.2 PIPQ.COM PIPQ is able to read from serial port D, but is not able to write to it. 4.0 CURRENT SYSTEM RESTRICTIONS 1. The type-ahead buffer is limited to 24 characters. 5.0 HARDWARE AND SOFTWARE COMPATIBILITY REQUIREMENTS 1. This software is intended to run on the Z80-based Kontron KDS Series Development System or Kontron Logic Analyzer in the LASER configuration. DOWNLOAD.COM requires that a "downloadable" keyboard is in use. 2. The switches on the 256K MEU card must be set as follows: For the KDS-908: 1 2 3 4 5 6 7 8 --------------- 1 1 1 1 1 0 0 0 0 - Open For the KDS-980: 1 2 3 4 5 6 7 8 1 - Closed --------------- 1 1 0 1 1 1 0 0 3. The switches on the 1-Megabyte MEU card must be set as follows: For the KDS-908: 1 2 3 4 5 6 7 8 --------------- 1 1 1 1 1 0 1 0 0 - Open For the KDS-980: 1 2 3 4 5 6 7 8 1 - Closed --------------- 1 1 0 1 1 1 1 0 6.0 RELEVANT DOCUMENTATION Part No. Title KDS-5000 CP/M Utilities Manual OG--5200 KDS Operations Guide 7.0 DETAILED FUNCTIONAL CHANGES 7.1 BIOS Changes 1. The BIOS now supports serial ports B, C, and D. These serial ports are interrupt driven on the input side. 2. The keyboard has a type ahead buffer, and no longer supports the 2300 ADS keyboard. 3. The CRT driver routines have been changed. The current control codes are: HEX Description 01H Home cursor lower left 06H Non-destructive forward space (Cursor Right) 07H Beep the beeper 08H Non-destructive backspace (Cursor Left) 09H Non-destructive tab (8 spaces right) 0AH Non-destructive linefeed (Cursor Down) 0CH Clear screen and home cursor upper left 0DH Non-destructive carriage return 0EH Set attribute on 0FH Set attribute off 11H Toggle normal/inverse mode 13H Toggle output speed normal/delayed 14H Toggle cursor on/off 16H Toggle screen normal/inverse 1AH Non-destructive up (Cursor Up) 1BH 30H a Select attribute type a: 40H - Normal 42H - Blink 50H - Inverse 52H - Inverse blink 1BH 43H Toggle national/international character set 1BH 4BH Erase to end of line 1BH 53H Toggle lower/upper case conversion 1BH 50H s BIOS Error messages state s: 30H - Error messages off 31H - Error messages on 1BH 56H m Set display mode m: 41H - Set alphanumeric mode 47H - Set bit map graphic mode 52H - Read character at cursor position 1BH 56H 44H p Set display memory page 1BH 56H 57H p Set processing memory page 1BH 56H 42H p Set display and processing memory page p: 30H - Page 0 31H - Page 1 32H - Page 2 33H - Page 3 1BH 59H r c Random cursor addressing r: Row based at 0 plus 20H offset c: Column based at 0 plus 20H offset 1BH 5AH s Set output speed, 1 <= s <= 16 (1 is fastest) speed = s * 20ms 1BH 6BH Erase to end of screen 7.2 Utility Changes 7.2.1 SRCCOM.COM, BCOMPARE.COM SRCCOM and BCOMPARE have been changed to output a report file only on a mis compare, so that they may be used with IF in a command file. 7.2.2 EDIT.COM Won't try to load a 0 length file (nothing is loaded). It is now possible to delete a character on the 80th column. Also, the GET command has been fixed. In previous versions, GET loaded nothing. The COPY FROM command (CF) has also been fixed. 7.2.3 FOR.COM FOR has a new option: %5 expands to d:filename.ext. 7.2.4 KONPROM.COM, DIOPROM.COM These utilities have been changed to allow the user to select which serial port to use for I/O. Support has been added for PROM sizes of 32768 and 65536 bytes (27256 and 27512 PROMs). 7.2.5 MODEM7.COM 1. The function keys are now configurable by the user. 2. Longer timeouts have been implemented to make MODEM7 work with UMODEM (on the VAX), and the DTR and RTS lines are now asserted correctly. 3. The disconnect option (DSC) has been added. This option is similar to the SYS option, but it drops the DTR line for a short period of time, raises it, then exits to the system. 4. Interrupt driven serial I/O is now used when talking to the modem in either terminal or echo mode. 7.2.6 SETSIO.COM Support for serial port C and D has been added. 7.3 New Utilities 7.3.1 CONFIGM7.SUB CONFIGM7.SUB is a SUBMIT file used to reconfigure the MODEM7 prefixed commands -E, -T, and -Y so that they do not conflict with the reomte computer's operations. SYNTAX: DO CONFIGM7 pc ex sc tc pc prefix character in hex ex character to exit to menu in hex sc character to send text file in hex tc character to toggle save on/off in hex USAGE NOTES: 1. Do not save the modified MODEM7.COM on the master System and Utilities diskette. This would destroy the original before the modified version could be tested. 2. Do not use the same character for both prefix and command. This would prevent you from being able to send that character. 3. Do not use the same character for two different commands. This would cause the second command (as listed in the table above) to be ignored. 7.3.2 DOWNLOAD.COM This utility is used to transmit data to the programmable key- board. DOWNLOAD may be used with any string up to 128 bytes in length. Unprogrammed keys continue to send out the code byte that is contained in the EPROM. The programmed strings are erased when the power is turned off. The keys labelled through and can be programmed on three levels, the cursor keypad on one level. The keyboard may also be remotely controlled. SYNTAX: DOWNLOAD or DOWNLOAD * USAGE NOTES: 1. Any keys not defined in the text file retain their default values. 2. DOWNLOAD text files must have the following format: $,,, $ Marks the beginning of a command. identifier F or C. F indicates a function key is to be programmed, C indicates a cursor key is to be programmed. Uppercase indicates that is non-ASCII. Lowercase indicates that is non-ASCII. A number (0 through 9) or an uppercase letter (A through E), that locates the key on the function keypad or helps locate the key on the cursor key pad to be programmed. The function keys are numbered, left to right, 1 to E (hexadecimal). The cursor key columns are numbered, left to right, 0 to 2. For programming function keys, determines one of the three levels ("1...3") on which a function key can be programmed. On the keyboard, the different levels are selected by the key. For programming cursor keys, the parameter in can be any from "0" through "6", denoting (from bottom to top) the row on the keypad in which the cursor key to be pro- grammed is positioned. An ASCII character. The character is sub- sequently be used to terminate the string in . Should not be a character that is contained in the string itself. The character or string you want to assign to a particular key may consist of any ASCII character sequence. Control characters can- not be used directly within the definition; instead they can be indicated by a preceding caret "^" (shifted 6). 3. Remote control functions currently available and their cor- responding code numbers are as follows: 00H Keyboard reset 01H Disable keyboard 02H Enable keyboard 05H Default codes of all loadable keys 06H Select loaded strings 07H Activate beeper 0CH All LEDs ON 0DH All LEDs OFF 0FH Erase all programmed strings 11H LED ON (2nd parameter = number of LED) 12H LED OFF (2nd parameter = number of LED) 13H LED toggle (2nd parameter = number of LED) 15H Enable/disable self-programming (toggle) 18H Change keyboard operating mode 4. Configuring the keyboard with function code 18H by remote control provides access to a number of operating modes that are meaningful for certain application programs: o Select function key level by pressing the and/or -key No key depressed: function key level 1 Shift-mode: function key level 2 (Shift-)Control-mode: function key level 3 o Output of lowercase letters in shift-mode with acti- vated (LED on). This is a reversal of the basic setup. o Activate after a . This is a reversal of the basic setup. 5. A remote control sequence is defined in the text file by using the following format: $R o The dollar sign ($) denotes the beginning of a control se- quence. The identifier "R" stands for remote control. o The function code with parameters must be stated as a 4- digit (maximum) hex number. For example, $R<00> is a keyboard reset. Depending on the remote command used, one or two bytes can be specified. The second byte always refers to a parameter of the function code. 7. Function code 18H's parameter byte is derived as follows: Bit 0: Selection of function level (0 - with , 1 - with ) Bit 1: Function level scroll of -key (0 - only up 1 - up and down with ) Bit 2: Hex output via hex key (0 - no 1 - yes) Bit 3: Character set in and (0 - uppercase letters 1 - lowercase letters) Bit 4: Switch from level 2 to level 1 when is pressed (0 - no 1 - yes for KDS, LA) Bit 5: Capslock after reset (always 0) Bit 6: START/STOP-key in effect (not with LA and KDS!!) (0 - no 1 - yes) Bit 7: Character set (0 - for KDS/LA 1 - for other systems) 7.3.3 FC.COM FC is used to format and/or copy all tracks, including system tracks, or all used tracks on a diskette. SYNTAX: A>FC USAGE NOTES: 1. If the diskette in the destination drive has not been for- matted, the "B" (both format and copy) option must be used to make a copy. 2. Enter -C to recover from a read or write error. 7.3.4 FORMAT.COM Similar to FC, FORMAT is used to initialize a floppy diskette. SYNTAX: FORMAT USAGE NOTES: 1. The command options for the FORMAT program can also be entered on the command line as follows: FORMAT a: a: indicates the drive to be formatted FORMAT a:/Y /Y indicates that the drive is ready FORMAT a:/Y/V /V requests a verification of the format Y for yes N for no Y/V for yes and verify the format -C to abort the program R to restart the program 2. When the program asks "Repeat format program?", the optional answers are as follows: Y for yes (to restart the FORMAT program) N for no (to return control to the system) -C to abort Drive Letter to restart and designate the drive to be formatted 3. If the Y/V (format and verify) option is used, bad spots on the diskette (if any) are reported. Bad spots are not re- ported if the Y (format only) option is selected. 7.3.5 NCTLIST.COM NCTLIST is used to filter source files before printing. SYNTAX: A>NCTLIST x input output A the drive label x desired characters per line (1 to 32767) input name of the file to be modified output a file name or one of the following device names: LST: (the CP/M list device LST:) CON: (the CP/M console device CON:) AUX: (the CP/M punch device PUN:) USAGE NOTES: 1. NCTLIST strips the 8th bit (parity bit) from the text and removes all control characters except for the following: CTRL-H - X'08 - BS CTRL-I - X'09 - TAB CTRL-J - X'0A - LF CTRL-L - X'0C - FF CTRL-M - X'0D - CR 2. NCTLIST can be used to prepare text files for use with the Kontron Editor. 7.3.6 RSETKEYS This DOWNLOAD text file restores keyboard values to their default state. 7.3.7 SETAUTO.COM The SETAUTO utility is used to establish a default command that is automatically executed following a warm or cold boot. SYNTAX: SETAUTO USAGE NOTES: 1. The SETAUTO program first indicates the current status by naming the current command and its status (active or in- active). Then you are asked to select the execution condition by entering one of the following: W execute on warm boot C execute on cold boot X deactivate 2. If X is entered, the current command is deactivated and con- trol returns to the system. If W or C is entered, you are be asked to enter a new command, or if the old command is to be retained. 3. SETAUTO will execute any CP/M utility or command file. The program accepts any valid command line, including parameters. 7.3.8 SETCRT.COM SETCRT can be used to modify the operating system to the specifi- cations of the connected monitor. SYNTAX: SETCRT The following options are available: 1 --> IBAS, Videoplan, KAP 2000 (Europe) 2 --> IBAS, Videoplan, KAP 2000 (USA) 3 --> MOP-VIP, IBAS-2000, IPS (Europe) 4 --> MOP-VIP, IBAS-2000, IPS (USA) 5 --> PSI 80 (Europe) 6 --> PSI 80 (USA) 7 --> KDS 980, PSI 980, PSI 908, PSI 9C 8 --> KLA xxx (Europe) 9 --> KLA xxx (USA) USAGE NOTES: 1. The current setting is highlighted in reverse video. Select a new setting either by the space bar, which rolls through the settings, or by direct numeric input. The usual delivered setting is 7. 2. Once a setting is selected, store it in the hardware initiali- zation table of the "master" drive by either of the following instructions: S stores the new setting F stores the new setting and saves the current setting in a file named CRTTAB.SYS 3. The new setting becomes the default setting after the next RESET or cold boot. 7.3.9 SETDEV.COM This program is used to permanently alter the I/O byte of the CP/M system to match personal requirements, instead of having to change the I/O byte every time the system is booted. SYNTAX: SETDEV SETDEV lists the I/O byte settings for the physical drivers in memory and those on the currently logged disk. If there is no difference, the program responds "THERE IS NO NEED FOR CHANGING THE I/O BYTE", and returns control to the system. If there is a difference, it responds "TYPE >S< TO STORE ACTUAL IO ASSIGNMENT TO DISK:". To change the stored I/O byte, enter "S". USAGE NOTES: 1. The I/O byte in memory can be changed with STAT.COM before using SETDEV (see the Osborne CP/M User Guide, KDS-5100, for details about STAT). 7.3.10 SETDRV.COM SETDRV is changes the drive designation letters of the drives in your system, temporarily or permanently on disk. It also permits you to install a new hard disk configuration, temporarily or permanently on disk. SYNTAX: SETDRV [option] options definitions no option describes the options and returns to system -T displays current drive configuration and returns to system -M changes drive labels in memory -D stores M-modified drive labels on disk -MI same as M, but adds a choice between 10 or 20 Mbyte hard disk -DI stores MI-modified drive labels on disk USAGE NOTES: 1. The drives are listed and numbered at the top of the screen, and the numbers and the current labels are shown at the bottom of the screen. Move the cursor by using the space bar. An entry of "0" (zero) instead of a letter disables the drive indicated by the cursor. 2. -C aborts this program. 3. Memory size shown by SETDRV does not include the space for system tracks, but does include space for the directory tracks included. 7.3.11 SYSGEN.COM SYSGEN writes the CP/M system tracks to the specified disk. SYNTAX: A>SYSGEN [s: d:] s: source drive d: destination drive USAGE NOTES: 1. When SYSGEN is entered without the optional drive designa- tions, the program prompt for the source and destination drives, and verification. 7.3.12 WSKEYS WSKEYS is an example of a DOWNLOAD text file. It loads Wordstar- usable string values into the cursor keypad. 8.0 9.0 SYSTEM GENERATION AND INSTALLATION Back up all disks received from any vendor, including Kontron, before anything is done. Also, the user should copy the CP/M system to all his other disks using SYSGEN. Although CP/M is not shipped from Kontron on every disk, it is much easier to use a working disk if it has CP/M on it.