Go to Triangle Digital Support Home Page TDS9092 TECHNICAL MANUAL
Forth word list
EDIT to HRS
Live website search
Enter key words
 

ALPHANUMERIC WORD DEFINITIONS


EDIT

       n -

Enter editor at screen n where n is 1 to 13 for TDS9092. The editor commands are then available.  Quit the editor with ctrl+Q. See SCREEN EDITOR.


EIM,

       addr imm -

Assembler word. Exclusive-or immediate data with the content of a memory location. E.g.

 $8000 8 ## EIM,

inverts bit 3 of the content of address hex 8000.


EIS

       -

Enables Interrupt System. Note that to be active each interrupt must also have its own enable bit set.


ELSE

       addr1 n1 - addr2 n2
       -

SYNTAX:
: cccc . IF . ELSE . THEN . ;

COMPILING: At compile-time ELSE compiles BRANCH reserving a branch offset, leaves the address addr2 and n2 for error checking. ELSE also resolves the pending forward branch from IF by calculating the offset from addr1 to HERE and storing it at addr1.

EXECUTING: At run-time ELSE executes after the true part following IF . ELSE forces execution to skip over the following false part and resumes execution after the THEN or ENDIF .


ELSE,

       addr1 - addr2

Assembler word. Used in an

xx IF, . ELSE, . THEN,

structure. See IF, . The addr1 is used to fix up a branch left at IF, so that it will point to after the ELSE, . ELSE, itself assembles a branch, leaving addr2 for use by THEN, which will fix it up to point to after the THEN, .


EMIT

       b -

The default action of EMIT is <EMIT> which sends the byte to the RS232 serial output SOUT1 on pin c25. EMIT is vectored through the user variable 'EMIT which has the cfa of the word which will execute when EMIT is used. The words (KEY) and ?TERMINAL work similarly so it is possible to completely re-vector the main Forth input-output. The example transfers control of the TDS9092 Forth to a connected LCD and keypad:

 : KEY

    BEGIN NEWKEY -DUP UNTIL

    TRANSLATE

 : TRANSFER
    ' LCDEMIT CFA 'EMIT !
    ' KEY CFA '(KEY) !
    ABORT ;

See also definition of NEWKEY .


EMPTY-BUFFERS

          -

Mark block buffers as empty. Updated blocks will not be written out to mass memory.


ENCLOSE

       addr1 c - addr1 n1 n2 n3

Text scanning primitive used by WORD . From the text address addr1 and an ASCII delimiting character c is determined the byte offset to the first non-delimiter character n1, the offset to the first delimiter after the text n2, and the offset to the first character not included n3. The procedure will not process past an ASCII 'null', treating it as an unconditional delimiter.


END

       addr n -
       f -

A duplicate of the definition UNTIL .


END-CODE

       -

Ends definition of Forth word defined in assembly language which runs at machine code speed. For example see CODE .


ENDCASE

       n -

Part of a CASE structure. See CASE .


ENDIF

       addr n -
       -

A duplicate of the definition THEN .


ENDOF

       n1 - n2

Part of a CASE structure. See CASE .


ENTRY-SET

       -

Transfers parameters sh and id to an alphanumeric display on chip select line CS01C0. When sh=1 display shifts on write with LCDEMIT , when id=1 character position is auto-incremented on write.


EOR,

       n -

Assembler word. Logically Exclusive-or  immediate or memory content to accumulator. E.g.

 8 ## B EOR,

inverts bit 3 of accumulator B.


EQ

       - 26 (hex)

SYNTAX:
CODE cccc . EQ IF, . THEN, .
END-CODE

EXECUTING: Assembler word. Condition code for use before IF, WHILE, and UNTIL, - see IF, . The IF, is true when in the status register Z=1 (zero flag set).


ERASE

       addr  n -

Set all bits to zero in each of n consecutive bytes of memory beginning at addr. n should be 1 to 32767 inclusive.


ERROR

       n - in  blk

Execute error notification and re-start of system. n is error number and contents of IN and BLK are put on the stack to assist in determining the location of the error. Final action is execution of QUIT , unless WARNING is not zero. In that case the word whose code field address (cfa) is in WARNING is executed to allow user defined messages.


EXECUTE

       addr -

Execute the definition whose code field address (cfa) is on the stack.


EXPECT

       addr count -

The default action of this word is shown under <EXPECT> . The action of EXPECT is that of the word whose cfa is stored in 'EXPECT and so it can be changed. See NUMBER for the method.


F>A

       -

Used to embed assembler within Forth words. See A>F for an example.


FENCE

       - addr

A user variable containing an address below which it is not possible to discard dictionary by use of FORGET . Default is hex 083C.


FILL

       addr  n  b -

Set all bytes to b in each of n consecutive bytes of memory beginning at addr. n should be 1 to 32767 inclusive.


FLUSH

       -

Empties the block buffers into the appropriate places in mass memory.  Always use FLUSH before EMPTY-BUFFERS if integrity of the data in the screens is to be maintained. There are 2 block buffers, each 1024 bytes (one block, or screen).


FORGET

       -

SYNTAX: FORGET cccc

Deletes definition named cccc from the dictionary, along with all entries following it.


FORTH

       -

FORTH is initially the compilation vocabulary and also the only word list searched. New definitions become part of FORTH until a different compilation vocabulary is established. FORTH is immediate so it will execute during a colon definition to select this vocabulary at compile time.


H1500

       -

Sets up editor control codes to match Hazeltine 1500 and some other dumb terminals.


H1520

       -

Sets up editor control codes to match Hazeltine 1520 and some other dumb terminals.


HERE

       - addr

addr is the address of the next available dictionary location.


HEX

       -

Set the numeric conversion base to 16 for hex input and output.


HLD

       - addr

A user variable that holds the address of the latest character of text during numeric output conversion.


HOLD

       c -

SYNTAX: <# . n HOLD . #>

Add char to the beginning of the pictured numeric output string. Typically used between <# and #> . For example:

 ". HOLD

will place a decimal point in the output string.


HOME

       -

Sets the cursor to the top left of the screen without clearing the page. If it does not work set terminal control codes by typing first one of these:  IBM  VT52  or  STD .


HOME-CURSOR

       -

Sets LCD cursor and/or display to the first position after having been moved with SHIFT . See  SHIFT  ENTRY-SET  R/L S/C .


HRS

       hrs.mins.secs -

Use to set the on-board clock to the correct time. The double number expected is in the format XX.YY.ZZ where XX is hrs (0-23), YY minutes, ZZ seconds. E.g.

 17.08.00 HRS

sets the clock to 5.08pm. This word is used automatically by the software TDS-PC at power-up to set the clock on the TDS9092 from that in the host PC. Each part of the input number must be two digits, made up with zeros if needed.

Go to Triangle Digital Support Home Page Go to top   Next page