[comp.sys.handhelds] DT48 Terminal Emulator

akcs.kevin@hpcvbbs.UUCP (Kevin Jessup) (12/12/90)

For some reason, my previous upload of DTE48 lost some characters.
Let's try it again...

A few people have been asking for DTE48, a terminal emulator program
for the 48SX.  Unless someone else out there has created a program
with the same name, here is what you have been asking for...

*********************************************************************
*              DOCUMENTATION FILE FOR DTE48  V1.02                  *
*********************************************************************

DTE48 is a Dumb Terminal Emulator program for the HP48SX.  "Dumb"
implies that the terminal cannot be read by a remote system or
respond to inquiry commands like a VT100.

At least 3 other "terminal" programs have been posted for the 48SX.
All have various limitations.  This one is not necesarily better
than any of the others.

Version 1.02 differs from previous versions in that incomming carriage
returns are replaced with an ASCII space before display.  A more
generic SRCHREPL (search and replace) string function has been sustituted
for the previous FILTER function.  Note that SRCHREPL requires MULTI
which is also provided.  Incomming linefeed characters are stripped!
The main program, DTE48, can be modified so as to replace linefeeds with
a space or any other character.

FEATURES
--------------------------------------------------------------------
1.)    Tramsmits upper and lower case as well as all of the ASCII
       control characters.
2.)    Characters are displayed AS THEY ARRIVE, not only when a full
       line is available.
3.)    The screen can be paused at any time.  This assumes the trans-
       mitting system handles XON/XOFF protocol and will not time-out
       and start resending!!
4.)    7 line by 22 character scrolling display.

LIMITATIONS
--------------------------------------------------------------------
1.)    Probably not 100% reliable at 9600 baud.
2.)    Control characters (ASCII 1 thru 26) are not processed and
       are displayed as a dot.  Checking each individual character
       so as to process tabs, carriage returns and linefeeds slows
       it down too much.  An assembly language version is needed.

FILES
--------------------------------------------------------------------
There are five.  DTE48 is the main executable.  KEYMAP is a string
used for keycode translation.  TOGF is a flag toggling function.
SRCHREPL strips or replaces characters in strings.  MULTI performs an
operation till the results no longer change.  Place the files in the
directory of your choice.

FILE       BYTES       CHECKSUM (HEX)
--------   -----       --------------
DTE48      636.0       # 81C8
SRCHREPL   145.5       # FD08
KEYMAP     304.5       # 5BFC
TOGF        38.5       # 921E
MULTI       56.0       # 8FCF

RUNNING IT
--------------------------------------------------------------------
Setup the 48SX I/O for the required baud rate and enable XON/XOFF
protocol.  If you don't know what that means, read the manual!
Hit DTE48 to run.  Here is an example of the IOPAR list with XON/XOFF
enabled:   { 4800 0 1 1 3 3 }

Characters will be displayed starting on the bottom line and lines
will scroll upwards as needed.

KEY        UNSHIFTED RESULT   LEFT SHIFTED RESULT   RIGHT SHIFTED RESULT
--------   ----------------   -------------------   --------------------
A          a                  A                     ^A (ASCII 1)
B          b                  B                     ^B (ASCII 2)
C          c                  C                     ^C (ASCII 3)...

Z          z                  Z                     ^Z (ASCII 26)

1          1                  !
2          2                  @
3          3                  #
4          4                  $
5          5                  %
6          6                  ^
7          7                  &
8          8                  *
9          9                  (
0          0                  )
*          *                  ,
-          -                  _    (underscore)
+          +                  =
.          .                  <
SPC        space              >
<-         backspace          delete
ENTER      carriage return    linefeed
DEL        QUIT               QUIT

                                                  
Hitting the ALPHA key will pause the display.  Hit it again to
continue.  The left shift and right shift keys are active for
one keystroke only.

All keys not defined above generate a space.

DISCLAIMERS
------------------------------------------------------------------
NOTHING is guaranteed.  I may or may not provide new and/or assembly
language versions.  Use it at your own risk.  Hack away at it and repost
only if you give me credit for the original version.

Kevin Jessup
9118 N. 85th St
Milwaukee, WI 53224

Office:    (414) 362-2020
Home:      (414) 355-9752

Here is the ASCII string for the DTE48 directory object.  Use ASC->
to convert it...

[CUT HERE]
"69A20FF7349000000050D455C4459450D9D20E16321C432D6E201007E16323C0
3278BF1D6E201007EB3A1DE03278BF1E0CF1167E19B632EF53293632B2130B60
004045F4746440D9D20E16323CE2278BF1313C1AFE225D2C15BF22472C15DF22
93632B2130840008035253484255405C480D9D20E163292CF18B9C11C432D6E2
01087D6E201097D6E201037E1632C9432D9D20E163278BF13CE22D6E2010874B
AC178BF1AFE22D9D202ABF19C2A290DA19C2A2DBBF1C58C13F2A20DCF1D6E201
03776BA192CF18B9C1C58C1D6E201097DBBF176BA176BA1B21305BF228DBF15D
F2293632B213084E2050D455C44594EF53293632B2130E110060B45495D41405
60C2A20742000202020202020202020216263646566602020202768696A6B6C6
02020202D6E6F60717270202020237475767778702020202D097A70280020202
020202738393F2020202020202435363A2020202020202132333D20202020202
0203E202B20202020202020202020214243444546402020202748494A4B4C402
020202D4E4F40515250202020235455565758502020202A095A502F702020202
020262A282E70202020202024252E5C2020202020202120432F5020202020202
92E3C3D30202020202020202020210203040506002020202708090A0B0C00202
0202D0E0F001112102020202314151617181020202020291A102020202020202
0202020202020202020202020202020202020202020202020202020202020202
02020202020202C520050444554438350D9D20E16329C2A2ED2A23F2A25D2C15
D2C15D2C1858A15BE12C2A2050000C2A2050000C2A2050000C2A2050000C2A20
50000C2A2050000C2A20500003C0323CE22780228DBF178BF19C2A2063C1387E
1AFE22D9D203CE2278BF1339201000000000000220D5CE1AFE22D9D208DBF133
9201000000000000220B21305DF2259E128DBF1C2A2070000A0C2A205000084E
208035253484255405C433920100000000000031066BC1C2A20700000284E208
035253484255405C476BA13CE2278BF18B9C178BF1339201000000000000220D
5CE1AFE22D9D2092CF1339201000000000000320E0CF1C58C1DBBF19C2A23392
01000000000000220C58C1DBBF1C53A25BCF18DBF1B21305BF228DBF15DF229C
2A2743A20A132D6E201096D6E201096A9CF1C53A2D6E20109690DA1485A1C423
2B21305BF228DBF15DF223CE22378A1AFE22D9D20D8732D9D2078BF133920100
0000000000450279E18A7329C2A25DF2278BF1339201000000000000160279E1
8A732D9D209C2A284E204045F474648DBF14B2A2B21305DF2278BF1339201000
000000000170279E18A732D9D20ED2A284E204045F474648DBF14B2A2B21305D
F2278BF1339201000000000000180279E18A732D9D203F2A284E204045F47464
8DBF14B2A2B21305DF223CE22ED2A2313C1AFE22D9D20ED2A25D2C1339201000
00000000059076BA1B21305DF223CE223F2A2313C1AFE22D9D203F2A25D2C133
920200000000000091076BA1B21305DF2284E2060B45495D41405DBBF178BF1C
58C13CE2257E12F88E1AFE228DBF15DF224B2A2B21305DF22B21305BF224B2A2
5DF22DE0329B632C53A246CF15DE129C2A2ED2A23F2A25D2C15D2C15D2C19363
2B21303F4005094F40514255047A203392030000000000008404B2A29C2A29C2
A23F2A23F2A2B2130CACE"[CUT HERE]

Make sure all carriage return characters (0d hex) are removed from
the ASCII string before you attempt to checksum it or convert it
using ASC-> .

Checksum for ASCII string (string on stack): D25F hex
Byte count: 2508.5

This is my third attempt at uploading this bugger.  I am using procomm+
in ASCII upload mode via the 2400 baud HPBBS.  I hope it works this time!

akcs.kevin@hpcvbbs.UUCP (Kevin Jessup) (12/12/90)

OK!  This time it uploaded fine because I just downloaded it and
ASC-> converted it with no error.  Hope it helps those of you that
requested it.

Kevin Jessup