RRRR A 1./| R R AA l,lMl,ll,l R RA Al4l,,ll,l RRRR A A l.,l l.l RR AAAAAM R R A AI4 I.I R RA A1,I
f ff t f ttt sss oo0 t s o o fff sss o of t so of tt f t ssss ooo

illler

Ambhler &
Parallel /Fl oppy-Interf Users Guide

16/09/85 TRAilsoft

C0PYRIG|T
by TRAI{soft Ambtlhler & lrtller
TRAMsoft Para I lel /Floppy-Interface
*********************************

Introduction

The TRAMsoft Parallel/Floppy-Interface can be used as 16 bit paraltel-input/output interface (using port A & B) Interface to any printer with CENTRONlCS-standard-interfcae (port B) Interface to up to 4 COMI'IODORE VC 1541 floppy-drives (port A)
It is possible to connect the printer and the floppy-drives at the same

Power Up

sequence ***

To prevent hardware

sequence: 1 ) Make sure,
distruction or data-loss, follow always this

power up-

that no peripheral-device is switched 2) Switch on the SHARP PC-1500/PC-1500A 3) Switch on all peripheral-devices in any order

Off - sequence ***

For the same reason follow

sequence:

2) Switch off the

1) Switch

off all
peripheral-devices in any order

SHARP PC-1500/PC-1500A

Anti-Auto-Power-0ff

- Feature (AAP0)

switched on again. To prevent this uncomfortable situation, the TRAMsoft Parallel/Floppy-Interface has a anti-auto-power-off-feature which prevents the PC-1500/A to switch off by issuing interrupts. This feature is disabled after a CLOAD- or CSAVE-operation. To start it again, CALL &E107 must be performed. The following message NE}{ 0. or CHECK:. can be ignored. P0KE &79D4,0 disables the MPO-feature.
If the SHARP PC-1500/PC-1500A is switched off by its auto-power-off-feature all its peripheral-devices MUST be switched off, before the PC-1500/A is

16/09/85

TRAMsoft
to use the TRAMsoft Parallel-Interface-Software ***************************************************

PC0N Port

, Direction , Control-Signal-1 , Control-Signal-2
Controls the direction of the data-signals and the functions of the controls igna I s.
- Port' rrArr or ttBt' input, rr0rr - Direction: "I" forrr+rr,rr-rr,"D" for output set flag if pulse poS., [g., - Control-Signal-1 : Control-Signal-2: different use for port A and B PFLAG Port

Represents

disable flag
the status of the control-signals (0

- Port'

( Port , Line ) or

( Port , Line )

the status of a certain line (0,1 or "L","H")

Linez 0

ttB"

PREAD Port

Represents the status of the (O 255 or 0 65535).
lines of one port or both ports together

Port , Line ,

Sets a certain line to the specified status.
or - Line: 0. 7 - Value: 0 or

PWRITE

Port ,

Value by

Sets the line of one port or both ports together to the status specified the value.

Value: 0

"Btt or 255 or 0
****************************************

Device-name

use the TRAMsoft Printer-Software
Specifies the device for LLIST and LPRINT commands (only necessary of more then one printer is connected, e.g. SHARP CE-150 and a printer via the TRAMsoft Paral lel /Floppy-Interface ).
Device-name: '.MGP" for CE-150,

rrPARrr

Parallel/Floppy-Interf.

C0NS0LE Length

Endcode-l

Endcode-2

Specifies the number of characters per line, the endcode and the edge of the printer-signal.
- Lenght: 16. 255, 0 for no endcode - Endcode-l, Endcode-2: Characters to be sent to the printer at the end of the line; 0 for "Carriage Return" (&0D), 1 for "Line Feed" (&0A). - Edge:0 if the printer has a BUSY-signal, 1 if it has an ACKNOWLEDGEsignal. But always use pin 10 at the interface.

LLIST First

line ,

Last line

CE-158

function as LLIST of the

module".
but always related to the "current

LPRINT Expression

function as

CE-158.

PR0GRAM l'lodule-number

any label

in the

program-module

Sets the specified program-module as the "current module".

function as CE-158.

************************************************

DCHAIN Program-name

use the TRAMsoft Floppy-Standard-Software

memory and

a program from the floppy into operation of the CE-150).

starts execution

(same as

DCMD Floppy-Cormand

Performs execution

Drive-number

of a floppy-command

(see VC 1541 manual)

- Floppy-Command: NEI'I, INITIALIZE, VALIDATE, C0PY, RENAME, $CRATCH - Drive-number: I. 11 (default is 8)
DEFDISK Drive-number Sets the specified floppy-drive to the default drive (drive-number 8). Applicable only if more then one floppy-drives are connected.

Drive-number:8

10 (11

the drive-numbers)

DFRE Drive-number

Represents the number

of free blocks.

Driver-number:

Lists the files on the disk. If there is no program in memory, the full directory is stored as a program in memory otherwise each entry is listed in the display. ENTER proceeds to the next entry (ENTER with autorepeat).

Drive-number:

11 (default 8)

Entry-number

the specified entry of the directory as a character string.

Entry-number:

number

of files plus

PF-4 e
use the TRAMsoft Floppy-Standard-Software (cont)

DLOAD LOAD

DLOAD M

Performs

operation. as CLOAD of the CE-150. as CLOAD M of the CE-150, but as CLOAD M of the CE-150. as MERGE of the CE-150.

DL0AD:

DL0AD M: DLOAD P: DLOAD V:

Same Same Same Same Same

memory-bank

as INPUT /l of the

CE-150.

DSAVE M

Performs SAVE operation.
- DSAVE: Same as CSAVE of the CE-150. - DSAVE I: Same as CSAVE M of the CE-150, but for memory-bank with PV=1. - DSAVE M: Same as CSAVE M of the CE-150. - DSAVE P: Saves only the "current module", no equivalent instruction with the CE-150. - DSAVE V: Same as PRINT /l of the CE-150.

DSTAT$ Drive-number

the status of the specified floppy-drive as a string.

DVERIFY

DVERIFY M

Compares

data on disk with data in memory (same syntax as

DLOAD).

PF-5 e
to use the TRAMsoft Floppy-Extension-Software *************************************************

BACKUP Drive-number-1 Copies the contents

Drive-number-2

of the disk in drive-1 to drive-2 (duration ca.

28 min.)

Drive-number-l, Drive-number-2:

CLOSE Log. File-number

Closes an opened channel.

Log. File-number: 0

DRECPOS Log.

File-number

Record-number

Byte-number

Sets the read/write-pointer

of a relative file.

to the specified byte in the specified record
- Log. File-number: 0. 9 - Record-number: 1. 65535 - Byte-number: 1. 254
DSH0}J$ Log. File-number Represents the contents

an OPEN-variable.

Device-number

Log. File-number

Variables:list

Loads data from

disk into variables.
- Device-number: 15 for floppy-interface - Log. File-number: 0. 9 - Variables-list: Variables where data is to be load into.

PF-6 e

use the TRAMsoft Floppy-Extension-Software (cont)

0PEN Log. File-number

0pens a channel.
, Primary-adr. , Secundary-adr. , File-descriptor

- Log. File-number: 0.

Primary-address: Drive-number 8. 11 Secundary-address: Channel-number 2. 14 , 15 for commands File-descriptor: For sequential fi les : Filename, Fi letype,Filemode For relative fi les: Filename,Fi letype,Recordlength - Filename: up to 16 characters

-F'e'iYP''

. i:i:: i3i i!iiirt;:il$,., rrurr

Filemode:

for user-files

append, add data

at the

of the file

Recordlength: Number

: ::fi:: SB:l l:i

of the
ffi?t. of bytes per record.

See also manual

VC 1541.

, Variables-list

Writes data from variables

to the floppy.

- Variables-list: List of variables or expressions
The 0PEN-variable The OPEN-variable contains all information about an opened channel. Each 0PEN-instruction creats an OPEN-variable (mayby even if an ERROR occurs). A CLOSE connand delets the appartaining OPEN-variable. OPEN-variables have the name o0. o9 and cannot be accessed from BASIC, except with DSH0W$. Never use NEll 0 or CLEAR while files are opened, if a files is not orderly closed, data might be lost !
- Device-number: 15 for floppy-interface - Log. File-number: 0. 9
of an OPEN-variable: pp,sS,nnnnnnnnnnnnnnnn,t,m,lll l,{here: p: Primary-address 2 characters) s: Secundary-address 2 characters) n: Filename 16 characters)

Contents

t: Filetype m: Filemode l:

Recordlength

1 characters) 1 characters) 3 characters)
Example with a sequential file ******************************

a) 0pen a new sequential

2,8,5, "Testl.DAT,S,l'l"
is successfull, the red LED will stay switched on.
b) Print the 0PEN-variable

PRrNT DSHol'l$ 2

" 8, S,Test1.DAT ,S,W

Testl.DAT

0"

c) Write data to

T$="SHARP PC-l500" :DIM N(5) :N(3)=t /Z PRINT tl-15,2,"TRAMsoft",12345,T$, N(3)
d) Close the file Testl.DAT
The data temporary stored in the memory the disk and the red LED is turned off.

of the floppy is

written to
0,8, 12, "Test1.DAT,S,R"
The red LED is switched on again.

data from the

Testl.DAT into variables

INPUT INPUT

/t-15,0,A$,8$,C$,D$ or

/I-15,0,A,8,C,D

is stored as a string, so it can be read always into string data is read into num. variables, a VAL operation is performed. If there is no translation into numerical value possible, the result is zero. There will never an ERROR occure.

0n disk, data

variables.

PF-8 e

Example with a relative Jnk**************************

a new relative

9,8, 10, "Test2.DAT, 1,80"
If the OPEN is successfull, the red LED will stay switched on.
b) Print the OPEN-variable

PRINT DSHOl.l$ 9

" 8,l0,Test2.DAT ,L, ,

80"

c) Hrite data into record 20 of the file

Test2.DAT

VN$=t'pglgrr', M$="Sample", ST$=r'l-9ngstreet", PZ$="1234" 0T$="ftugmlang", TN$="123. 45.67"

DRECP0S

9,20,1
9,20,16 9,20,30 DRECP0S 9,20,50 DRECPOS 9,20,55 DRECP0S 9,20,70

DRECP0S DRECP0S

:PRINT lt-15,9,VN$ :PRINT #-15,9,NA$ :PRINT tt-,|5,9,ST$ :PRINT tt-15,9,P2$ :PRINT tl-l5,9,0T$ :PRINT tI-15,9,TN$
the just saved data into the variables

DRECPOS 9 ,20

9,20,16 : INPUT /t-15,9,8$ 9,20,30 : INPUT /l-15,9,C$ 9,20,50 : INPUT /l-15,9,D$ DRECPOS 9,20,55 : INPUT /l-15,9, E$ DRECPOS 9,20,70 : INPUT /l-1 5, 9, F$

DRECP0S DRECP0S DRECP0S

: I NPUT /t-1 5, 9, A$

e) Close the

CLOSE 9

The data

will now be stored on disk and the red LED turns off.

PF-9 e