elektronik mainz OS-9 V2.
Revision History Rev. 1A OS-9 V2.4 on EUROCOM-17 Changes Date First Edition valid for Software Revision 1.A 28.09.93, D.W. DISCLAIMER! The information in this document has been carefully checked and is believed to be entirely reliable. However, no responsibility is assumed for inaccuracies. ELTEC reserves the right to make changes to any products to improve reliability, function or design.
OS-9 V2.4 on EUROCOM-17 Table of Contents Table of Contents Page Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . III Scope of Delivery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents (Continued) OS-9 V2.4 on EUROCOM-17 Page 3.3 RBF Descriptors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 3.3.1 Descriptors for Harddisk with embedded SCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 3.3.2 Descriptors for TEAC FC-1 Controller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 3.3.3 Descriptors for SCFL Controller. . . . . . . . . . . . . . . . . . . . . .
OS-9 V2.4 on EUROCOM-17 List of Tables List of Tables Page Table 1: Table 2: Table 3: Available SCF Descriptors and Appropriate Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Available SBF Descriptors and Appropriate Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Used SCSI IDs on EUROCOM-17 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OS-9 V2.
OS-9 V2.4 on EUROCOM-17 Scope of Delivery Scope of Delivery Description: Order No.: OS-9 V2.4.5 Professional OS-9 V2.4.5 for EUROCOM-17 Industrial MGR 1.3 i W-O917-A105 The last letter of the order numbers refers to the software revision and is subject to changes. Please contact ELTEC for information about valid order numbers.
Options / Related Products OS-9 V2.4 on EUROCOM-17 Options Description: Order No.: None Related Products Description: Order No.: Documentation: Software Manual OS-9 V2.4 on EUROCOM-17 Hardware Manual EUROCOM-17 Software Manual RMon H-O917-A109 V-E17.-A991 W-FIRM-A209 Hardware: EUROCOM-17, 33 MHz, 32 MB EUROCOM-17, 33 MHz, 8 MB EUROCOM-17, 25 MHz, 8 MB EUROCOM-17, 25 MHz, 2 MB V-E17.-A139 V-E17.-A113 V-E17.-A103 V-E17.
OS-9 V2.4 on EUROCOM-17 Conventions Conventions If not otherwise specified, addresses are written in hexadecimal notation and identified by a leading dollar sign ("$"). Signal names preceded by a slash ("/"), indicate that this signal is either active low or that this signal becomes active with the trailing edge.
How to Use this Manual OS-9 V2.4 on EUROCOM-17 How to Use this Manual Document Conventions Font Types: Font Use Helvetica, 8 Pt Tables and drawings Helvetica, 10 Pt Signal names Times, italic Notes Courier, bold Program code, function names, commands, file names, module names Times, bold Emphasized text Other conventions: i ! Indicates information that requires close attention. Indicates critical information that is essential to read. Indicates information that is imperative to read.
OS-9 V2.4 on EUROCOM-17 1 Getting Started 1 Getting Started This manual contains informations about the implementation dependent part of OS-9/68K ELTEC systems. We recommend, that you are familiar with the following documentations: •EUROCOM-17 Hardware Manual •RMon Manual •OS-9/68K Users Manual •Using UMACS 1.1 Pre-Installed System If you have ordered a complete system, the operating system will already be installed completely on the harddisk, when shipped off.
1 Getting Started OS-9 V2.4 on EUROCOM-17 If you want to use a VGA monitor and MF-2 keyboard, set hex switch S2 to '0'. Connect the floppy drive(s) and harddisk(s) according to the description in the hardware manual and jumper them as mentioned in Section 4.2 ‘Fixed Device Parameters’of this manual. Now switch on the terminal and the EUROCOM-17. The LED display now indicates 'F', and you should get the power-on message of the RMon monitor from the terminal.
OS-9 V2.4 on EUROCOM-17 2 Installing OS-9 V2.4.5 2 Installing OS-9 V2.4.5 This chapter explains the installation of the new OS-9 release on a harddisk. 2.1 Booting from Floppy Disk After power-up, the EUROCOM-17 prompts with its monitor program. All commands described in the RMon manual are ready to be used. Insert disk labeled ‘OS9 Bootdisk’into drive 0 if you wish to boot from floppy.
2 Installing OS-9 V2.4.5 OS-9 V2.4 on EUROCOM-17 Type 'c' to change boot controller. "Controller: TEAC" Press '' to select SCFL as boot device. Press '' to accept. 3. Type 'x' to exit boot menu. 4. Type 'x' to exit setup menu. "Save parameters (y/n)?" Type 'y' to save the selected parameters. "[***]>" 5. Type 'boot' to boot OS-9/68K. 6. The boot device is selected and the operating system comes up.
OS-9 V2.4 on EUROCOM-17 2 Installing OS-9 V2.4.5 2.2 Installing OS-9 V2.4.5 on an Empty Harddisk It is recommended to install the operating system on a fresh formatted harddisk. Boot the system from floppy, load the appropriate harddisk descriptor and format the harddisk (see Section 2.1 ‘Booting from Floppy Disk’). 1. Load the back utility from your boot disk and change the current directory to harddisk. $ load back $ chd /h0 2.
2 Installing OS-9 V2.4.5 OS-9 V2.4 on EUROCOM-17 2.3 Updating OS-9 V2.X to V2.4.5 Installing the software on a harddisk already containing an OS-9 (older version or version for a different CPU) may cause trouble if modules are mixed between different releases. The following procedure is a save way to avoid this: 0. Make a complete backup of the harddisk. 1. Generate a bootable floppy with the old version of the operating system. 2.
OS-9 V2.4 on EUROCOM-17 2 Installing OS-9 V2.4.5 4. Generate a new boot file on the harddisk with os9gen . Examine the sample bootlist file in CMDS/BOOTOBJS and add the necessary drivers and descriptors. For the information which drivers and descriptors are needed, refer to Chapter 3 ‘Drivers and Descriptors’. $ chd /h0/cmds/bootobjs $ dmode /h0 format=on $ os9gen /h0 -z=bootlist -eb=200 i The harddisk descriptor may have the Format Inhibit bit set.
2 Installing OS-9 V2.4.5 2.4.2 OS-9 Configuration without SSM OS-9 V2.4 on EUROCOM-17 ELTEC supplies two modified syscache040 modules, which configure the address space of the EUROCOM-17 as follows: syscache040.cb $0000.0000 - $01FF.FFFF: both caches enabled, copy back mode $0200.0000 - $FDFF.FFFF: both caches enabled, write through mode $FE00.0000 - $FFFF.FFFF: both caches disabled, all serialized syscache040.wt $0000.0000 - $01FF.FFFF: both caches enabled, write through mode $0200.0000 - $FDFF.
OS-9 V2.4 on EUROCOM-17 2.4.4 Notes and Restrictions 2 Installing OS-9 V2.4.5 The DDIO bit in module init is set by default. This tells the kernel not to disable the data cache when in I/O. Disabling data cache is required for systems with drivers which use DMA and don't perform any explicit data cache flushing. If your system does not use DMA drivers, or the drivers care for the cache, the DDIO bit should be set. The DDIO bit has to be modify by the label NoDataDis in systype.d .
2 Installing OS-9 V2.4.5 OS-9 V2.4 on EUROCOM-17 2.5 Floating Point Support This release provides soft- and hardware floating point instructions. The following instructions are supported by software: facos , fasin , fatan , fetox , fint , fintrz , flog10 , flogn , fmovecr , fsin , fcos , ftan and ftentox .
OS-9 V2.4 on EUROCOM-17 2 Installing OS-9 V2.4.5 2.6 Memory Configuration with MemList The memory size is set to 2 MB per default with UsrMemEnd label in DEFS/systype.d . If a EUROCOM-17 with a different memory size is used, modify the memory list or choose one of the uncommented UsrMemEnd samples in DEFS/ systype.d . Set the 2 MB UsrMemEnd to comment and remove the comment for your configuration. Init.a contains the following MemList: MemList * Select one of predefined UsrMemEnd labels in systype.
2 Installing OS-9 V2.4.5 12 OS-9 V2.
OS-9 V2.4 on EUROCOM-17 3 Drivers and Descriptors 3 Drivers and Descriptors This chapter describes the drivers and descriptors for clock, RBF, SCF and SBF type devices. All these modules are in directory CMDS/BOOTOBJS. Your directory may contain more drivers and descriptors as mentioned here, since ELTEC feels free to add devices as they become ready, without changing the documentation. 3.
3 Drivers and Descriptors OS-9 V2.4 on EUROCOM-17 3.2 RBF Drivers The RBF drivers are structured in a physical and logical part. • scsi17 is the physical driver which deals the NCR53C720 SCSI I/O controller and has to be loaded if any SCSI I/O is desired. • rbvccs / rbcvccs is the logical driver for all harddisks with embedded SCSI controller. • rbteac / rbcteac is the logical driver for TEAC FC-1 floppy disk with integrated SCSI controller.
OS-9 V2.4 on EUROCOM-17 3 Drivers and Descriptors 3.3 RBF Descriptors The source of these descriptors is located in the IO/RBF directory. 3.3.1 Descriptors for Harddisk with embedded SCSI All descriptors for embedded SCSI disk have the logical unit number (LUN) 0. h0.embscsi h0.scsi256 h0.scsi512 dd.h0.embscsi The descriptors refer to SCSI ID 6. h1.embscsi h1.scsi256 h1.scsi512 dd.h1.embscsi The h1 descriptors refer to SCSI ID 5. h2.embscsi h2.scsi256 h2.scsi512 dd.h2.
3 Drivers and Descriptors 3.3.2 Descriptors for TEAC FC-1 Controller OS-9 V2.4 on EUROCOM-17 All descriptors are for SCSI ID 3. • d0.teac_3ms Descriptor for drive select 0 (LUN 0). It is for the Microware 38W7 floppy disk format. • u0.teac_3ms Descriptor for drive select 0 (LUN 0). It is for the Microware universal floppy disk format. • s0.teac_HD Descriptor for drive select 0 (LUN 0). The descriptor supports HD disk format with 32 sectors per track. This is a special ELTEC floppy disk format. 3.3.
OS-9 V2.4 on EUROCOM-17 3 Drivers and Descriptors 3.4 SCF Drivers and Descriptors • scrmon Depending on the setup of the RMon, the VGA monitor/AT-keyboard or one of the serial channels may be used as console. The console is implemented as SCF device with the device driver scrmon, which operates in polling mode. The console device descriptor name is always term. Using scrmon makes sure that the OS-9 configuration adapts to the RMon configuration.
3 Drivers and Descriptors OS-9 V2.4 on EUROCOM-17 Table 1: Available SCF Descriptors and Appropriate Drivers Descriptor Driver Description term.rmon scrmon Console device depending on RMon setup term.cons sc17cons Interrupt-driven driver for keyboard and graphics term.t0 sccd2401 Serial channel 0 (RJ11 on front panel) t0 sccd2401 CD2401 port A (RJ11 on front panel) t1 sccd2401 CD2401 port B (CHAN.2 on CONV-300) t2 sccd2401 CD2401 port C (CHAN.
OS-9 V2.4 on EUROCOM-17 3 Drivers and Descriptors 3.5 SBF Drivers and Descriptors For each supported streamer there is a driver and an appropriate descriptor. The following streamers are supported: Table 2: Available SBF Descriptors and Appropriate Drivers Driver Descriptor Type sbtandberg mt0.scsi TANDBERG 36xx sbgiga mt0.wang WangDAT 2600 sbviper mt0.viper ARCHIVE VIPER sbgiga mt0.exa EXABYTE sbteac mt0.teac TEAC MT-2 sbteac mt0.standard WANGTEK 5150SE sbteac mt0.
3 Drivers and Descriptors OS-9 V2.4 on EUROCOM-17 The following descriptors are available: Name Format pc0l.scfl_360k 40 tracks, 9 sectors, 5.25" pc0l.scfl_720k 80 tracks, 9 sectors, 3.5" pc0h.scfl_12mb 80 tracks,15 sectors, 5.25" pc0h.scfl_144mb 80 tracks,18 sectors, 3.5" pc0l.teac_720k 80 tracks, 9 sectors, 3.5" pc0h.teac_144mb 80 tracks, 18 sectors, 3.5" pchd.scsi512 Harddisk, SCSI ID 4, 512 B/sector SCFL floppy descriptors are also available for drive 1. i pc0l.
OS-9 V2.4 on EUROCOM-17 4 Installing new RBF Devices 4 Installing new RBF Devices The new OS-9 V2.4 release is no longer restricted to sector sizes of 256 B/sector. It now allows sector sizes of up to 32 KB. For practical use, sector sizes of 256, 512 or 1024 B/sector are the most practicable. Booting is possible from devices with a sector size ≤ 1024. Booting from floppy is restricted to floppies with 256 B/sector. i Most harddisk descriptors have the Format Inhibit bit set.
4 Installing new RBF Devices OS-9 V2.4 on EUROCOM-17 4.
OS-9 V2.4 on EUROCOM-17 5 Features and Enhancements 5 Features and Enhancements This chapter describes the changes in the ELTEC dependent part of the software since the V2.3 release. 5.1 Sysgo The sysgo /systs modules profile utility to proceed are rewritten in C. Sysgo now uses the the startup file. As a consequence the environment variables for the initial shell may be set in the startup file. Sysgo also executes the script file /dd/SYS/ .login_default to set the default environment. 5.
5 Features and Enhancements 24 OS-9 V2.
OS-9 V2.4 on EUROCOM-17 6 Additional Utilities 6 Additional Utilities 6.1 Dmode Utility As an addition to the Microware utilities, ELTEC delivers this utility to examine or change RBF descriptors in runtime (like xmode for SCF descriptors). ❏ Syntax: dmode [] / [] [] ❏ Options: -? List usage ❏ Parameters: (prefix hex values with $) drive= RBF logical drive number type=hard|floppy drive type size=5|8 disk size (use 5 for 3.
6 Additional Utilities OS-9 V2.4 on EUROCOM-17 lsnoffs= disconn=on|off sync=on|off maxcnt= offset to first logical sector enable/disable SCSI disconnect/reselect enable/disable synchronous transfer max. transfer count (0 = default = 64K) 6.2 Back Utility Back is ELTEC's special backup utility for general backup purposes. ❏ Syntax: back []
OS-9 V2.4 on EUROCOM-17 6 Additional Utilities The following streamer types are supported: mt0.scsi for the Tandberg 3620/40/60 Streamers mt0.exa for the ExaByte 8200 mt0.teac for the Teac MT-2ST Streamer mt0.viper for the Archive Viper Tapes mt0.standard for the WangTek 5150SE and Sankyo CP-150SE mt0.wang for the WangDat 2600 Default destination device can be set with the shell environment parameter BACK_DEV, otherwise it is /mt0.
6 Additional Utilities OS-9 V2.4 on EUROCOM-17 -z[=] Reads an exclude list. None of the files/ subdirectories in this list will be treated. Note that the full pathname of each file/directory is required. Wildcards ('*','?') are accepted. If is given, back will read the exclude list from , otherwise it will be read from the standard input path. Input from standard input path can be terminated by . -o[=] Reads a select list.
OS-9 V2.4 on EUROCOM-17 6 Additional Utilities -n Asks if existing destination file with same name shall be overwritten. (default) -u Update mode. Only sources with a more recent creation date than existing destination are treated. Add '-r' option if for automatic update. The following options only work on tapes. -w Rewinds the tape before reading or writing. Use this if you are not sure about the saveset position on the tape.
6 Additional Utilities OS-9 V2.4 on EUROCOM-17 b) Make backups on disks using a saveset: $ back /h0/SOURCES -s=/d0/savesource >/h0/backout& copies all files from /h0/SOURCES into one saveset named savesource on disk. The saveset will be copied into the root directory of /d0. In this case back will work in the background and redirect standard output to /h0/backout. Back $ back /h0/SOURCES -s=/d0/savesource -z=exclude The file exclude may contain the following lines: "/h0/oldprog" "/h0/PROGS/*.
OS-9 V2.4 on EUROCOM-17 7 Additional Libraries 7 Additional Libraries 7.1 The F$System System Call The F$System system call has been added by ELTEC to provide boardhardware specific functions to the user. The functions are available to the members of group 0 only. To keep the number of new system calls to a minimum, all ELTECspecific functions are accessible through the F$System call. A function code is passed in register d0.w to indicate the operation desired.
7 Additional Libraries OS-9 V2.4 on EUROCOM-17 7.
OS-9 V2.4 on EUROCOM-17 Sys$IOS 7 Additional Libraries Get mmu-protected I/O segment ❏ Input: d0.w = 0 (Sys$IOS function code) d1.l = 1: request I/O segment 0: return I/O segment d2.l = size of I/O segment (a0) = address of segment requested ❏ Output: none ❏ Error Output: cc = carry bit set d1.
7 Additional Libraries Sys$VMECCtl OS-9 V2.4 on EUROCOM-17 Enable/disable caching of VMEbus read cycles ❏ Input: d0.w = 1 (Sys$VMECCtl function code) d1.l = 1: enables caching 0: disables caching (*) -1: read status only ❏ Output: d0.l = status ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function ❏ Function: Sys$VMECCtl enables or disables the cache for VMEbus longword read cycles. If d1.
OS-9 V2.4 on EUROCOM-17 Sys$DSCtrl0 7 Additional Libraries Data size control 0 (A32) ❏ Input: d0.w = 2 (Sys$DSCtrl0 function code) d1.l = 1: A32/D16 transfers 0: A32/D32 transfers (*) -1: read status only ❏ Output: d0.l = Status ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function ❏ Function: sets the data size on the VMEbus during master access at the address range $0040.0000 - $EFFF.FFFF. If d1.
7 Additional Libraries Sys$DSCtrl1 OS-9 V2.4 on EUROCOM-17 Data size control 1 (A24) ❏ Input: d0.w = 3 (Sys$DSCtrl1 function code) d1.l = 1: A24/D32 transfers 0: A24/D16 transfers (*) -1: read status only ❏ Output: d0.l = Status ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function ❏ Function: Sys$DSCtrl1 sets the data size on the VMEbus during master access at the address range $FF00.0000 - FFFE.FFFF. If d1.
OS-9 V2.4 on EUROCOM-17 Sys$ASCtrl0 7 Additional Libraries Select VMEbus AM source ❏ Input: d0.w = 4 (Sys$ASCtrl0 function code) d1.l = 1: the AM source register of the VIC is used to generate the address modifier code on the VMEbus. 0: extended AM code is generated for address range from $0040.0000 - $EFFF.FFFF, standard AM code at the address range $FF00.0000 - $FFFE.FFFF and a short AM code at addresses $FFFF.0000 - $FFFF.FFFF. (*) -1: read status only ❏ Output: d0.
7 Additional Libraries Sys$BlkDisp OS-9 V2.4 on EUROCOM-17 Enable/disable hex display ❏ Input: d0.w = 6 (Sys$BlkDisp function code) d1.l = 1: enables hex display (*) 0: disables hex display -1: read status only ❏ Output: d0.l = Status ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function ❏ Function: Sys$BlkDisp controls the Blank input of the hex display at the front panel. If d1.l equals -1, no action takes place.
OS-9 V2.4 on EUROCOM-17 Sys$EnSemIRQH 7 Additional Libraries Enable/disable semaphore interrupt at $7C ❏ Input: d0.w = 7 (Sys$EnSemIRQH function code) d1.l = 1: enables semaphore IRQ at address $7C (*) 0: disables semaphore IRQ at address $7C -1: read status only ❏ Output: d0.l = Status ❏ Error Output: cc = carry bit set d1.
7 Additional Libraries Sys$EnAbort OS-9 V2.4 on EUROCOM-17 Enable abort switch ❏ Input: d0.w = 8 (Sys$EnAbort function code) d1.l = 1: enables abort switch (*) 0: disables abort switch -1: read status only ❏ Output: d0.l = Status ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function ❏ Function: If d1.l equals -1, no action takes place. The status of this function is always returned in d0.
OS-9 V2.4 on EUROCOM-17 Sys$SlavAddr 7 Additional Libraries Set VMEbus slave base address ❏ Input: d0.w = 10 ( Sys$SlavAddr function code) d1.l = VMEbus slave address for standard access d2.l = VMEbus slave address for extended access ❏ Output: none ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function.
7 Additional Libraries Sys$BlkMove OS-9 V2.4 on EUROCOM-17 VMEbus block transfer via VIC ❏ Input: d0.w = 11 (Sys$BlkMove function code) d1.l = transfer length in bytes d2.l = bit 0 = 0: write to slave bit 0 = 1: read from slave a0.l = pointer to local buffer a1.l = pointer to target buffer ❏ Output: none ❏ Error Output: cc = carry bit set d1.
OS-9 V2.4 on EUROCOM-17 Sys$AlignPtr 7 Additional Libraries Align pointer to 256 byte boundary ❏ Input: d0.w = 12 ( Sys$AlignPtr function code) d1.l = pointer to memory block ❏ Output: d0.l = the given pointer aligned to the next 256 byte boundary ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function ❏ Function: Normally, a pointer to a memory block is returned by a 'Request Memory' function.
7 Additional Libraries Sys$SetDisp OS-9 V2.4 on EUROCOM-17 Set digit of hex display ❏ INPUT: d0.w = 13 (Sys$SetDisp function code) d1.l = Digit for hex display ❏ Output: none ❏ Error Output: cc = carry bit set d1.w = error code if error ❏ Possible Errors: E$Permit - you must belong to group 0 to use this function E$Param - impossible value for hex display ❏ Function: Sys$SetDisp writes the value of d1.l into the boards hex display, which is located at the front panel.
OS-9 V2.4 on EUROCOM-17 7 Additional Libraries 7.
7 Additional Libraries vme_cctl() OS-9 V2.4 on EUROCOM-17 Enable/disable caching of VMEbus READ cycles ❏ Synopsis: int vme_cctl (cntrl) int cntrl; /* 1: enables caching */ /* 0: disables caching (*) */ /* -1: read status only */ ❏ Usage: The vme_cctl() function controls the cache for VMEbus longword read cycles. This is allowed for aligned longword read cycles (A32, D32) only. If an error occurs, vme_cctl() returns -1 and the appropriate error code is placed in the global variable errno.
OS-9 V2.4 on EUROCOM-17 ds_cntrl1() 7 Additional Libraries Data size control 1 (A24) ❏ Synopsis: int ds_cntrl1 (cntrl) int cntrl; /* 1: A24/D32 transfers */ /* 0: A24/D16 transfers (*) */ /* -1: read status only */ ❏ Usage: The ds_cntrl1() function sets the data size on the VMEbus during master access at the address range from $FF00.0000 - $FFFE.FFFF. If an error occurs, ds_cntrl1() returns -1 and the appropriate error code is placed in the global variable errno.
7 Additional Libraries blk_disp() OS-9 V2.4 on EUROCOM-17 Enable/disable hex display ❏ Synopsis: int blk_disp (cntrl) int cntrl; /* 1: enables hex display (*) */ /* 0: disables hex display */ /* -1: read status only */ ❏ Usage: The blk_disp() function enables or disables the hex display at the front panel. If an error occurs, blk_disp() returns -1 and the appropriate error code is placed in the global variable errno. If no error occurs, blk_disp() returns the current status.
OS-9 V2.4 on EUROCOM-17 en_abort() 7 Additional Libraries Enable abort switch ❏ Synopsis: int en_abort(cntrl) int cntrl; /* 1: enables abort switch (*) */ /* 0: disables abort switch */ /* -1: read status only */ ❏ Usage: The en_abort() function enables or disables the abort switch at the front panel. If an error occurs, en_abort() returns -1 and the appropriate error code is placed in the global variable errno. If no error occurs, en_abort() returns the current status.
7 Additional Libraries slave_addr() OS-9 V2.4 on EUROCOM-17 Set VMEbus slave base address ❏ Synopsis: int slave_addr (std_addr, ext_addr) unsigned std_addr; /* VMEbus addr. for standard access */ unsigned ext_addr; /* VMEbus addr. for extended access */ ❏ Usage: The slave_addr() function sets the VMEbus slave base address for both standard and extended addressing. If an error occurs, slave_addr() returns -1 and the appropriate error code is placed in the global variable errno.
OS-9 V2.4 on EUROCOM-17 align_ptr() 7 Additional Libraries Align a given pointer to a 256 byte boundary ❏ Synopsis: long *align_ptr (pointer) long *pointer; ❏ Usage: Normally, a pointer to a memory block is returned by a 'Request Memory' function, e.g. malloc() . It will be aligned in any way suitable for the operating system. Some applications (i.e. blk_move() ) require a 256-byte alignment of all pointers.
7 Additional Libraries 52 OS-9 V2.
OS-9 V2.4 on EUROCOM-17 Appendix A: Control Sequence Codes Appendix A: Control Sequence Codes ANSI Standard Terminal Emulation The sc17cons output character functions for the graphic interface emulates a subset of a standard ANSI X3.64 terminal. The sc17cons displays 24 lines of 80 ASCII characters per line (default setting), with scrolling, (x, y) cursor addressability, and some other control functions. The non-blinking block cursor marks the current line and character position on the screen.
Appendix A: Control Sequence Codes [ CSI OS-9 V2.4 on EUROCOM-17 represents the ASCII escape character (, -[, $1B). The next character is a left square bracket '[' ($5B). are a sequence of zero or more decimal numbers made up of digits between 0 and 9, separated by semicolons. represents a function character which is different for each control sequence. represents the ANSI control sequence introducer ($9B).
OS-9 V2.4 on EUROCOM-17 Appendix A: Control Sequence Codes If a syntactical error is found within a sequence, the sc17cons output function skips all input until a terminating code is encountered, which results in a return to the normal not-in-sequence state. • [ A Cursor Up (CUU) Takes one parameter, (default 1). Moves the cursor up lines. If the cursor is fewer than lines from the top of the screen, moves the cursor to the topmost line on the screen.
Appendix A: Control Sequence Codes OS-9 V2.4 on EUROCOM-17 • [ M Delete Line (DL) Takes one parameter, (default 1). Delete beginning with the current line. The portion of the screen from the current line inclusive to the bottom is scrolled upwards by lines. The new lines scrolling onto the bottom of the screen are filled with spaces. The old lines beginning at the cursor line are deleted. The position of the cursor on the screen is unchanged.