[comp.sys.handhelds] DTE48 Terminal Emulator

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

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]69A20FF7349000000050D455C4459450D9D20E16321C432D6E201007E16323C03278B
F1D6E201007EB3A1DE03278BF1E0CF1167E19B632EF53293632B2130B60004045F4746440D
9D20E16323CE2278BF1313C1AFE225D2C15BF22472C15DF2293632B2130840008035253484
255405C480D9D20E163292CF18B9C11C432D6E201087D6E201097D6E201037E1632C9432D9
D20E163278BF13CE22D6E2010874BAC178BF1AFE22D9D202ABF19C2A290DA19C2A2DBBF1C5
8C13F2A20DCF1D6E20103776BA192CF18B9C1C58C1D6E201097DBBF176BA176BA1B21305BF
228DBF15DF2293632B213084E2050D455C44594EF53293632B2130E110060B45495D414056
0C2A20742000202020202020202020216263646566602020202768696A6B6C602020202D6E
6F60717270202020237475767778702020202D097A70280020202020202738393F20202020
20202435363A2020202020202132333D202020202020203E202B2020202020202020202021
4243444546402020202748494A4B4C402020202D4E4F405152502020202354555657585020
20202A095A502F702020202020262A282E70202020202024252E5C2020202020202120432F
502020202020292E3C3D30202020202020202020210203040506002020202708090A0B0C00
2020202D0E0F001112102020202314151617181020202020291A1020202020202020202020
20202020202020202020202020202020202020202020202020202020202020202020202C52
0050444554438350D9D20E16329C2A2ED2A23F2A25D2C15D2C15D2C1858A15BE12C2A20500
00C2A2050000C2A2050000C2A2050000C2A2050000C2A2050000C2A20500003C0323CE2278
0228DBF178BF19C2A2063C1387E1AFE22D9D203CE2278BF1339201000000000000220D5CE1
AFE22D9D208DBF1339201000000000000220B21305DF2259E128DBF1C2A2070000A0C2A205
000084E208035253484255405C433920100000000000031066BC1C2A20700000284E208035
253484255405C476BA13CE2278BF18B9C178BF1339201000000000000220D5CE1AFE22D9D2
092CF1339201000000000000320E0CF1C58C1DBBF19C2A2339201000000000000220C58C1D
BBF1C53A25BCF18DBF1B21305BF228DBF15DF229C2A2743A20A132D6E201096D6E201096A9
CF1C53A2D6E20109690DA1485A1C4232B21305BF228DBF15DF223CE22378A1AFE22D9D20D8
732D9D2078BF1339201000000000000450279E18A7329C2A25DF2278BF1339201000000000
000160279E18A732D9D209C2A284E204045F474648DBF14B2A2B21305DF2278BF133920100
0000000000170279E18A732D9D20ED2A284E204045F474648DBF14B2A2B21305DF2278BF13
39201000000000000180279E18A732D9D203F2A284E204045F474648DBF14B2A2B21305DF2
23CE22ED2A2313C1AFE22D9D20ED2A25D2C133920100000000000059076BA1B21305DF223C
E223F2A2313C1AFE22D9D203F2A25D2C133920200000000000091076BA1B21305DF2284E20
60B45495D41405DBBF178BF1C58C13CE2257E12F88E1AFE228DBF15DF224B2A2B21305DF22
B21305BF224B2A25DF22DE0329B632C53A246CF15DE129C2A2ED2A23F2A25D2C15D2C15D2C
193632B21303F4005094F40514255047A203392030000000000008404B2A29C2A29C2A23F2
A23F2A2B2130CACE[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

bgribble@jarthur.Claremont.EDU (Bill Gribble) (12/05/90)

This might be as good a time as any to announce that a I am in the debugging
  stage of writing a machine-language successor to *my* terminal emulator,
  term2.1, that has been posted here a few times.  When I'm finished (I hope
  within about 3 weeks) I'll post it here.  It promises to be pretty
  speedy - how speedy I can't tell yet, but substantially faster than anything
  I've seen.  Features:  programmable function keys, hooks for *real* terminal
  emulation, selectable display paging, and a few others.  It's a goody,
  if I do say so myself.  

Anyway, it should be here soon - and if it's not posted before the end of
  semester break I will humbly accept any 'vaporware' flames you wish to
  toss my way.

*****************************************************************************
**   Bill Gribble                     Harvey Mudd College, Claremont, CA   **
**   bgribble@jarthur.claremont.edu   Never heard of it?  You're stupid.   **
*****************************************************************************

YEE@rcgl1.eng.ohio-state.edu (Roger Yee) (12/09/90)

Hello,

This note is primarily directed to Kevin Jessup.  I have downloaded the
previous message for the DTE48 V1.02 and used a friends cable to transfer it
to my calculator.  The problem comes in when trying to ASC-> the string.
(after removeing all the carriage returns like the instruction says).  I tried
to do this it and it says invalid string or something on that order.
I was wondering if someone has gotten this to work could send me a copy
in the uploaded ascii directory form (normal uploading no ->asc please).

By the way, The file I downloaded looked like this:

%%HP: T(3)A(D)F(.);    @ADDED THIS LIKE MOST PROGRAMS I HAVE SEEN HAVE
"69A20FF............."    @ONE LONG STRING

Any help would be greatly appreciated.

Thanks in advance,

Roger Yee  (YEE@RCGL1.ENG.OHIO-STATE.EDU)

akcs.kevin@hpcvbbs.UUCP (Kevin Jessup) (12/11/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]
"69A20FF7349000000050D455C4459450D9D20E16321C432D6E201007E16323C03278BF1D6
E201007EB3A1DE03278BF1E0CF1167E19B632EF53293632B2130B60004045F4746440D9D20
E16323CE2278BF1313C1AFE225D2C15BF22472C15DF2293632B21308400080352534842554
05C480D9D20E163292CF18B9C11C432D6E201087D6E201097D6E201037E1632C9432D9D20E
163278BF13CE22D6E2010874BAC178BF1AFE22D9D202ABF19C2A290DA19C2A2DBBF1C58C13
F2A20DCF1D6E20103776BA192CF18B9C1C58C1D6E201097DBBF176BA176BA1B21305BF228D
BF15DF2293632B213084E2050D455C44594EF53293632B2130E110060B45495D4140560C2A
20742000202020202020202020216263646566602020202768696A6B6C602020202D6E6F60
717270202020237475767778702020202D097A70280020202020202738393F202020202020
2435363A2020202020202132333D202020202020203E202B20202020202020202020214243
444546402020202748494A4B4C402020202D4E4F4051525020202023545556575850202020
2A095A502F702020202020262A282E70202020202024252E5C2020202020202120432F5020
20202020292E3C3D30202020202020202020210203040506002020202708090A0B0C002020
202D0E0F001112102020202314151617181020202020291A10202020202020202020202020
2020202020202020202020202020202020202020202020202020202020202020202C520050
444554438350D9D20E16329C2A2ED2A23F2A25D2C15D2C15D2C1858A15BE12C2A2050000C2
A2050000C2A2050000C2A2050000C2A2050000C2A2050000C2A20500003C0323CE22780228
DBF178BF19C2A2063C1387E1AFE22D9D203CE2278BF1339201000000000000220D5CE1AFE2
2D9D208DBF1339201000000000000220B21305DF2259E128DBF1C2A2070000A0C2A2050000
84E208035253484255405C433920100000000000031066BC1C2A20700000284E2080352534
84255405C476BA13CE2278BF18B9C178BF1339201000000000000220D5CE1AFE22D9D2092C
F1339201000000000000320E0CF1C58C1DBBF19C2A2339201000000000000220C58C1DBBF1
C53A25BCF18DBF1B21305BF228DBF15DF229C2A2743A20A132D6E201096D6E201096A9CF1C
53A2D6E20109690DA1485A1C4232B21305BF228DBF15DF223CE22378A1AFE22D9D20D8732D
9D2078BF1339201000000000000450279E18A7329C2A25DF2278BF13392010000000000001
60279E18A732D9D209C2A284E204045F474648DBF14B2A2B21305DF2278BF1339201000000
000000170279E18A732D9D20ED2A284E204045F474648DBF14B2A2B21305DF2278BF133920
1000000000000180279E18A732D9D203F2A284E204045F474648DBF14B2A2B21305DF223CE
22ED2A2313C1AFE22D9D20ED2A25D2C133920100000000000059076BA1B21305DF223CE223
F2A2313C1AFE22D9D203F2A25D2C133920200000000000091076BA1B21305DF2284E2060B4
5495D41405DBBF178BF1C58C13CE2257E12F88E1AFE228DBF15DF224B2A2B21305DF22B213
05BF224B2A25DF22DE0329B632C53A246CF15DE129C2A2ED2A23F2A25D2C15D2C15D2C1936
32B21303F4005094F40514255047A203392030000000000008404B2A29C2A29C2A23F2A23F
2A2B2130CACE"[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

degen@bnlux0.bnl.gov (christopher degen) (12/11/90)

In article <276418eb:1405comp.sys.handhelds@hpcvbbs.UUCP> akcs.kevin@hpcvbbs.UUCP (Kevin Jessup) writes:

>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-> .

   I thought ASC-> eliminated the need for removing carrige returns?

 -Chris.

    *******************************************************************
    *   Christopher M. Degen             Phone:(516) 282-2492         *
    *   Brookhaven National Laboratory   FTS: 666-2492                *
    *   Building 923  Room 42            E-Mail:degen@bnlux0.bnl.gov  *
    *   Upton NY 11973                                                *
    *******************************************************************

akcs.tyrone@hpcvbbs.UUCP (Tyrone Johnson) (12/12/90)

I just download the above string and am not able to get the correct
Checksum or  Byte count on my 48.  I've done it 3 times to make sure that
I was not losing anything along the way, but no luck.  
I get Checksum: 7802 hex
     Byte count: 2458
Is it possible to have lost characters again while uploading it?

akcs.joehorn@hpcvbbs.UUCP (Joseph K. Horn) (12/12/90)

Roger: Try NOT removing the carriage returns.  ASC-> expects them.
-jkh-

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

See item 1409 in this conferance.  It has a good copy of DTE48.
Sorry about the upload problems.

Kevin J.