home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
8bitfiles.net/archives
/
archives.tar
/
archives
/
genie-commodore-file-library
/
C64Telecom
/
CBTERM-DOC2
< prev
next >
Wrap
Text File
|
2019-04-13
|
19KB
|
512 lines
For information on the CBterm Vidtex overlay program, see the file
CBTVTX.DOC in DL2 of the CBIG SIG. (go CBIG)
VIDTEX is a trademark of Compuserve Inc.
CLOCK
=====
Just so you can keep track of your time on line, CBterm includes an on screen
time clock. To set the clock, press C= J. You will be prompted for 4 digits
[HHMM]. To set the clock to 6:30, enter 0630. 10:48 would be 1048. The clock
starts as soon as the last digit is pressed. You can turn the clock display on
and off with C= K. The clock will still keep time even if it is not being
displayed.
--------------------------------------------------------------------------------
To exit CBterm/C64 press C= SHIFT and CTRL together. This will reset the
computer.
--------------------------------------------------------------------------------
Please report any bugs or suggestions to CHRISDOS by posting a message in the
Compuserve CBIG sig to SYSOP. (no email please) (Go CBIG at any ! prompt.)
--------------------------------------------------------------------------------
Key Summary
-----------
C= 8 80 column mode.
C= 4 40 column mode.
C= A Add LF after CR (sending).
C= B Batch Transmit (80 col only).
C= C Close RAM Buffer.
C= D Display RAM Buffer.
C= E Extra LF after CR (recieved).
C= F File Translation (ASCII/PETSCII).
C= G Send Control Codes to Printer.
C= H HELP!
C= I 7/8 Bits.
C= J Set Clock.
C= K Display Clock.
C= L Load RAM.
C= M Mask/Local LF.
C= N Xmodem Download.
C= O Open RAM Buffer.
C= P Print RAM Buffer.
C= Q Disk Command.
C= R Read Disk File.
C= S Save RAM to Disk.
C= T Transmit RAM.
C= U Xmodem Upload.
C= V Set Printers Secondary Addr.
C= W Write Disk File.
C= X Full/Half Duplex.
C= Y Disk Directory.
C= Z Zero RAM Buffer.
C= 1 Pick Up Auto Modem.
C= 2 Hang Up Auto Modem.
C= 3 Dial Auto Modem.
C= 5 Positive/Negitive Dialing.
C= 7 300/1200 Baud.
C= 6 Dump HiRes Screen to printer.
C= \ (English Pound) Invert Black/White to printer dump.
SHIFT Hold RAM display.
CTRL Abort RAM display or transmit or up/down loads.
+ - RAM Transmit speed adjust.
Shift/RunStop Restart CBterm/C64.
C=/Shift/CTRL EXIT CBterm/C64 and RESET Computer.
F7 User Defined Function Keys On/Off
F8 Load Function Key File.
To send Type a
------------- --------------
Backslash British-pound
Escape Back Arrow
Underline F1
Vertical-bar F2
Grave-accent F3
Tilde F4
Left-brace F5
Right-brace F6
(Unless F keys have been user defined.)
Control S CLR/HOME
Control Q Shift/CLR/HOME or CRSR Down
Backspace INST/DEL
Space CRSR Right
ASCII DEL. Shift/CRSR Right
**************************************************************************
Function Keys
=============
CBterm will allow you to turn the keys F1 through F6 into
Programable Function keys. These keys may be used for either LOCAL (C=)
control or for transmittable data.
A support program is required to define the function keys, and this is
done off line. The support program creates a disk file with the key info
that can be loaded into CBterm. Any number of files may be created, and any
or all used during a session.
The support program is called CBTKEY.BAS.
--------------------------------------------------------------------------------
Operation of CBTKEY is fairly simple. You load and run the program. You will
see a menu of 5 items. If you are creating your first key file, you pick
the number for making a NEW file. The Screen will present the F key numbers
and the lines will be blank, ready for data.
You are asked for the F key number you wish to define, you enter 1 to 6.
You are then prompted for the info for that key. You enter the info just
as if you were entering it into CBterm itself. You may enter up to
31 key presses for each F key.
If you wanted to have F1 transmitt your ID number, you would select key 1
and enter: 77777,777<RETURN> (Press <CRSR RIGHT> to signal end.)
The <RETURN> key would show on the screen as ^M in reverse video. ^M is the
code for control M, and that is a <RETURN>.
To program F2 to send your password, you would select 2 then enter:
password<return> <CRSR RIGHT>
you would see: password^M
You could program the other keys to transmitt anything else you like. If you
make a mistake, exit the line and reenter that line again. Backsapce will
not backspace, as it is taken as data itself.
Once you have defined your keys (they do not all need to be set) you exit
to the main menu by pressing 0 for a key value.
You then select SAVE file option to save the data to disk. You are asked for
a name for the file, you could use like: keys1 or keys2 etc.
The file is then written to disk. It should only be 1 block long.
The above examples only show the F keys being set to transmittable data, but
since the F keys are read by CBterm just like they came from the keyboard, you
can program them to do C= functions as well. Again, you would enter the key
strokes into the file just as if you were doing it to CBterm.
You could program a key to dial CBterm for you, you would enter:
C=2C=355512122^M^M (<CRSR RIGHT>)
This is C=2 (Press the Commodore key and hit 2) - Hang up command.
C=3 (commodore and 3) - Dialing command
5551212^M - the number to dial ending with a <RETURN>
^M - a second return to answer the EXTRA DELAY question.
If this were programmed into F4 and F4 was pressed in CBterm, the whole
dialing sequence would be automatic.
Note: the combination of C= and a key will display as the key in reverse
video. The C= does not display. So a key in reverse video is a C= key function.
A key in reverse video with a ^ before it is a CTRL value.
Another key might be set to reset the clock/timer to 0 so it could be
used as a timer. The action in CBterm would be to press C=J and then
4 zeros to answer the SET TIME question. If you programmed a f key for:
C=J0000 (<CRSR RIGHT>)
Pressing the F key would reset the time to 0:00:00.
As you can see, you simple act as if you were typing to CBterm, all the key
presses are stored and read back by CBterm.
NOTE: If you use a F key to send control codes to the Printer, (the C=G option)
you will have to press <SHIFT><CTRL> by hand to exit it. As there is no way
to store the <CTRL> key ITSELF in the file.
The other options on the CBTKEY menu allow you to read in and edit an OLD
function key file. Operation is the same as above, except the values
of the file you enter are loaded into CBTKEY so that they may be altered.
Don't forget to then resave the file.
If you return to the main menu, but want to go back and alter the file in
memory again, use the DISPLAY and EDIT option.
The last option on the menu exits CBTKEY.
--------------------------------------------------------------------------------
Using the F key files and CBterm.
Normally the F keys in CBterm transsmitt special characters |_~`}{
and they will continue to do so unless a F KEY file is loaded into CBterm.
The Function key F7 turns the F keys (1-6) on and off. If the keys are turned
on and no file has been loaded, then the F keys (1 to 6) will not do anything.
Using the F8 (Shift F7) will prompt for a F Key file name. Enter the name
for a file you created with CBTKEY. You will be prompted for S or P. A F Key
file is allways (S).
The File will be loaded and the keys turned ON. You may use F7 to toggle
the F (1-6) keys between the ASCII characters and the F Key file.
One other nice thing about the F Key system is the fact that F keys themselves
may be chained into another F key. When creating the F key file, you can
enter another F key into it. If you had F6 programmed as:
<F8>keys2^Ms (<CRSR RIGHT>)
Then pressing F6 would invoke the load F keys function and load
the file KEYS2 into the F Key Buffer.
(The F Key Buffer is the cassette buffer.)
------------------------------------------------------------------------------
Hi and Med Res. Graphics
========================
In addition to all its other functions, CBterm has the
ability to translate CIS' Medium and HiRes Graphics codes into pictures
on the 80 column screen. This operation is automatic and controlled
by escape sequences sent from CIS.
And, if you have a Gemini-10x or other compatable printer, you
can dump the Hi Res screen to it.
Operation
---------
To use the Graphics option, you must be switched into 80 column mode (C=8)
in CBterm. Then simply select the graphics picture you require.
(at this time there are only 2 hires graphic areas on CIS. The weather
maps [go AWX-4] and the picture demo [go VID-100]. To use the picture
demo, you must temporaly set your terminal type to VIDTEX. This being done on
page CIS-9 [The DEFALT program].)
CBterm will recieve the graphics data and build the picture on the screen.
While recieving, the keyboard is still active and the OUTPUT display line
is also.
At the end of the picture, to return to normal mode, you press your
<RETURN> key to send a CR to CIS.
To print the screen, press the C= 6 keys. The computer will then
do a fast dump of the Hi Res screen to the printer along with the control
codes required to put the printer into Bit Map mode. If your picture
comes out with black and white reversed (a negitive image) then press
C= \ (english pound sign) to toggle the reverse image setting of CBterm.
(press once to reverse, press again to return to normal) Then press
C= 6 again to dump to printer.
Note: The C= 6 dump will print anything on the 80 column screen,
so you can use it to dump text as well as graphics. Think of it as a
screen print. You may also use the 25th (output) line to title your
screen before you dump your Hi Res picture.
******************************************************************************
Ascii/Petscii modes and CBterm
------------------------------
Due to the fact that CBterm must be able to handle both standard ASCII files
and Commodore's PETSCII files, a number of flags were built into CBterm.
The 2 most important ones are the C= M (Mask/Local LF) and C= F (Ascii/Petscii
File Type).
These 2 flags are often set/reset together to tell CBterm if it should
translate a file. Most of the translation is done on Reading of Disk into ram
memory, or on Writing of ram to disk. (Note: This could be either RAM BUFFER
or XMODEM transfer.) They also affect data going to the Printer.
In a nutshell, you can think of CBterm having a TRANSLATE and NO
TRANSLATE mode. When C= M is set ON and C= F is set PETSCII, you are
TRANSLATING (either Petscii to Ascii or Ascii to Petscii).
When both C=M is OFF and C= S is ASCII, CBterm does NOT TRANSLATE and you
are woring with what ever you are sending or recieving. If you have a PETSCII
file, and you want to send it out PETSCII, you wold not need to translate it,
so you would have C=M OFF and C=F ASCII.
You can see that this sometimes looks backwards, but if you think about
what type your file is, and how you want it to wind up, it is really simple.
When using XMODEM, you will be prompted for the kind of translation you want,
you are asked (A)scii (P)etscii (N)o change.
It might help you to think of it as NO TRANSLATE, TRANSLATE and SPECIAL.
( (N)o change is a special mode that keeps the flags the way you have
manually set them with C=M and C=F. Used for doing special translation.)
If you are posting a file to a SIG or BBS, you should include in its description
what type of data it is: ASCII or PETSCII. This will help other when they come
to download it.
Customization of CBterm.
------------------------
You can load CBterm and alter some values in the program, then save CBterm
back to your disk with the new defalt values. The most offen changed ones are
the screen colors. Here is a list of where to poke what.
What Position Hex Position Dec Current Value Comments
-------------- ------------ ------------ ------------- ---------------
User Baud HIGH $0A50 2640 1 1200 baud
User Baud LOW $0A4F 2639 59 1200 baud
Color 25TH line $0ADD 2781 177 output line 80c
Color 40 Col $0AE2 2786 27 Char & screen
Color 80 Col $0AE7 2791 191 Char & screen
Border Color $0AF8 2808 12 Border color
Printer Sec Adr $1D8E 7566 5 Secondary Addr.
Printer Dev # $1D97 7575 4 Device number
Hayes Speed $32FE 13054 6 #of 1/60 second
Dial Open $3020 12320 3 Ticks open
Dial Close $3030 12336 3 Ticks close
Time Bet Digs $3063 12387 60 Ticks between
The Program may be loaded, but before being RUN, you may poke to memory
the defalt values you choose and resave the program.
The user baud rates are the defined rates used in 1200 baud mode.
The color values are the combination of Charater and screen colors (Forground-
backgraound).
Printer device number and secondary address are for those who wish to alter
the defalt values. And the Hayes speed is the wait time between characters
when CBterm is sending commands to the modem. The value is counts in ticks.
--------------------------------------------------------------------------------
SPECIAL BUG NOTE: CBterms RAM buffer starts a $0400, this is the old area
used by the 40 column screen. (It was moved to high memory.) But is seems
that when you switch between 40 and 80 column or back again, this area is
being cleared, so the first 1K of ram data is being lost.
So please do not switch screens while you have valuable data in RAM, save
it to disk first.
-------------------------------------------------------------------------------
CBterm may be restarted after a C=/SHIFT/CTRL or a reset by a SYS 33451
assuming that the memory image has not been overwritten.
CBterm loads as a basic program into $0801 and is about 11.5k long. It
relocates itself after turning basic ROM off to $8000 thru $AFFF.
$B000 thru $BFFF contains buffers and scratch memory. $C000 thru $CFFF is not
used so that Wedges there may be reused after CBterm is exited. The 40 column
screen is moved to high memory, and when in 80 column mode ram in the range
of $5c00 to $7FFF is used. CBterms MAIN RAM BUFFER runs from $0400 to $5BFF.
--------------------------------------------------------------------------------
Messages from CBterm
--------------------
The following is a list of messages you may encounter from CBterm and what
they mean.
Baud?
Enter 3 for 300 or 12 for 1200 baud operation.
[Done]
CBterm finished a process you asked for. (You should now be in terminal mode.)
[Recv. 8 Bits]
[Recv. 7 Bits]
You changed CBterm to Recieve 7 or 8 bit data.
[Batch Xmit ON]
[Batch Xmit OFF]
CBterm is in (or out) of Batch Transmit mode for the output line.
[Full Duplex]
[Half Duplex]
Your duplex setting.
[Output extra LF ON]
[Output extra LF OFF]
Cbterm will (will not) send a line feed after a return character.
[Input LF Add ON]
[Input LF Add OFF]
Cbterm will (will not) add a LF after a recieved return character.
[LF Mask/Local ON]
[LF Mask/Local OFF]
CBterm will (will not) ignore all recieved LF's and provide a new line on
a retern charater recived.
[ASCII Mode]
CBterm will not translate a file. (Should also require LF Mask/Local OFF)
[PETSCII Mode]
CBterm will translate a file. (Should also require LF Mask/Local ON)
(A)scii,(P)etscii,(N)o change?
You are being asked if you wish CBterm to alter the settings of the
Ascii/Petscii and LF Mask/Local flags. Enter A,P, or N.
[RAM Buffer Full]
It's all fed up.
[Ram Buffer Zeroed] nnnnn
You pressed C= Z. It's now empty. nnnnn = number of bytes in buffer.
[Ram Buffer Closed] nnnnn
You closed the ram buffer. nnnnn = number of bytes left.
[Ram Buffer Open] nnnnn
Ram capturing data. nnnnn = number of free bytes.
[RAM Buffer Display]
Displaying to screen.
[RAM Buffer End]
End of the display.
[*ABORTED*]
Anytime a process is aborted by pressing CTRL or entering a NULL filename.
Secondary Address:
You are being prompted for a new printer secondary address. Press 0-9.
[Printing Buffer]
Ram going to printer.
[Transmitting Buffer]
Sending the Ram buffer.
Load:
Save:
You are being prompted for a filename for a Kernal type Load or Save.
[*Kernal I/O Error*] nnn
The kernal has flaged an error during Disk I/O. nnn = either the Kernals
error return value, OR the value of the ST Status variable.
[Write to Disk]
CBterm is writing RAM buffer to disk.
[Nothing in RAM]
You wanted to write to disk when there was no info in the RAM buffer.
[Read From Disk]
Reading a file into RAM.
Write:
Read:
You are being prompted for a file name.
[00,ok,00,00]
What the disk's error channel is reporting. May vary if there is an error.
[*Check Disk*]
You get this anytime the disk's error channel reports an error.
[FAILURE TO COMMUNICATE]
Your XMODEM download bombed out for some reason.
(S)eq or (P)rg ?
You are being prompted for the proper file type.
[CheckSum Error]
The checksum on the recived XMODEM block does not match what is expected.
[Header No Good]
The XMODEM block has bad header info.
[Block Mismatch]
The XMODEM block does not have the correct block number in its header.
[Cant Get Block]
CBterm has tried it maximum amount of loops to recieve a block and can not.
[Time out - Block] nn
xxx
The alloted time has expired to recieve a full Xmodem block. nn = Block number.
xxx = the number of bytes that were recived. (1 block = 132 bytes.)
[Have Block] nn
A full XMODEM block was recived. nn = block number.
[Stripped VIDTEX Header]
The first XMODEM block had a VIDTEX (.IMG) file header, and it was stripped.
[Download Done]
Xmodem finished.
Download:
Upload:
Prompt for a file name.
[Upload Done]
Xmodem finished.
[Sent Block] nn
An Xmodem block was sent.
[Waiting for NAK]
Waiting for a handshake from the remote computer for upload to begin.
[XOFF]
A stop transmitting (or any) character was recived during an upload.
[XON]
The strat character was recived.
[Time Out XON]
CBterm waited long enugh, will start transmitting anway.
Set Clock [HHMM]:
Prompt for the correct time.
Command:
Command to be sent to the disk drive.
[*Disk Drive Not Present*]
[*Process ABORTED*]
You tried to talk to the disk drive when it was off or unplugged.
Enter Codes. (Shift/CTRL to End) :
Prompt for escape codes to be sent to the printer.
Enter Number to Dial:
Prompt for a phone number.
Dialing: abcdxyz
As the number is being dialed.
[Standby]
After dialing and waiting for connect.
[Hung Up]
Modem on hook.
[Pick Up]
Modem on line.
[Negitive Dialing]
Hes,Mighty Mo, 1660 Mode for dialing pulses.
[Positive Dialing]
Normal,Hayes, every thing else mode.
[DCD Switched]
The Data Carried Detect line changed state.
# of extra 20 sec. delays (0-9):
Prompt for wait time out.
[Hanging up...]
Hang up in 4 seconds.
[On Line]
From auto dialing into terminal mode.
-------------------------------------------------------------------------------
-Chrisdos [76703,717]
F┼