Copy Link
Add to Bookmark
Report
Commodore Hacking Issue 14
@(#)top:
########
##################
###### ######
#####
##### #### #### ## ##### #### #### #### #### #### #####
##### ## ## #### ## ## ## ### ## #### ## ## ##
##### ######## ## ## ## ##### ## ## ## ## ##
##### ## ## ######## ## ## ## ### ## ## #### ## ##
##### #### #### #### #### ##### #### #### #### #### #### ######
##### ##
###### ###### Issue #14
################## Version 1.0
######## November 1996
-------------------------------------------------------------------------
@(#)contents: Table of Contents
Features
6. The Commodore Telnet BBS by Bo Zimmerman
(Reference: net)
In this age of internetworked computer systems, is the
Commodore left out? No way, as Bo Zimmerman describes how to
coax your Commodore BBS system to play the networking game.
Bo shows how to set up your BBS so that Internet users can
"telnet" to your BBS from anywhere on the 'Net.
8. Menu Toolbox III by Jeff Jones
(Reference: toolbox)
You've got this neat idea for a game, utility, or productivity
application. The engine is complete and working, but the user
interface is a mess. Do you scrap the project because you're
not up to the task of writing a whole UI engine? Nonsense. Jeff
presents a rich set of functions and subroutines to tame that
killer application.
11. The CMD Nirvana: The Guts and Glory by Todd Elliott
(Reference: hw)
Has your computer system started looking like the multi-headed
beast from a "B" movie? Are you tired of having so many items
on your desk? Do you envy IBM PC owners with their all-in-one
computer? Well, if you answered YES! to any of the above, let
Todd show you his souped up C128DCR. Learn how you, too, can
"upgrade" your computer system and refine its image.
13. Jim Butterfield: The Commodore Guru - An Interview by Jim Lawless
(Reference: jb)
Jim Butterfield has long been associated with the Commodore
computer system, from the days of the KIM-1 to the present.
Many of us learned machine language through Jim's articles or
books, while most have benefitted from his early work on
creating memory maps and documenting KERNAL routines for the
Commodore line. Jim Lawless talks to the ubiquitous Commodore
Guru.
Columns
4. Hi Tech Trickery by Alan Jones
(Reference: trick)
In part II of Alan's "Heavy Math" series, he moves right into
Linear Programming and how to accomplish it on the C64. If you're
still not sure what LP math is, read on, as you'll be surprised
at which everyday problems fall into this category of mathematics.
15. Hacking BASICs by Richard T. Cunningham
(Reference: basic)
Even as more and more programmers take up the ML flag and wave it
proudly, there are many who either use BASIC entirely, or prototype
pieces of code in BASIC before converting to ML. Richard outlines
some common "gotchas" in the ever-present programming language.
17. Twiddling the Bits by Ward Shrake
(Reference: bits)
OK, VIC-20 enthusiasts, listen up. Resident VIC-20 cartridge expert
Ward Shrake details exactly how the VIC-20 and its cartridges work
together to allow the user to play games and use applications on
cartridge. Ward details how to archive your collection of VIC
carts, as well as how the computer recognizes and executes code on
a cartridge.
Departments
1. The (cough, cough) Hacking Editor
(Reference: editor)
2. Input/Output
(Reference: io)
3. Newsfront
(Reference: news)
5. Hacking the Mags
(Reference: mags)
7. UseNuggets
(Reference: usenet)
9. FIDO's Nuggets
(Reference: fido)
10. The Hacking Review
(Reference: review)
12. Hack Surfing
(Reference: surf)
14. Commodore Trivia
(Reference: trivia)
16. ? DS, DS$: rem The Error Channel
(Reference: error)
18. The Next Hack
(Reference: next)
19. Hacking the Code
(Reference: code)
-------------------------------------------------------------------------
@(#)legal: Commodore Hacking Legal Notice
Commodore and the respective Commodore product names are trademarks or
registered trademarks of ESCOM GmbH or Visual Information Services
Corporation. Commodore Hacking is in no way affiliated with ESCOM GmbH
or Visual Information Services Corporation (VISCorp), owners of said
trademarks. Commodore Hacking is published 4 times yearly by:
Brain Innovations Inc.
10710 Bruhn Avenue
Bennington, NE 68007
The magazine is published on on-line networks free of charge, and a nominal
fee is charged for alternate mediums of transmission.
Permission is granted to re-distribute this "net-magazine" or "e-zine" in
its entirety for non-profit use. A charge of no more than US$5.00 may be
charged by redistribution parties to cover printed duplication and no more
than US$10.00 for other types of duplication to cover duplication and media
costs for this publication. If this publications is included in a
for-profit compilation, this publication must be alternately available
separately or as part of a non-profit compilation.
This publication, in regards to its specific ordering and compilations of
various elements, is copyright (c) 1995-96 by Brain Innovations,
Incorporated, unless otherwise noted. Each work in this publication
retains any and all copyrights pertaining to the individual work's contents.
For redistribution rights to individual works, please contact the author
of said work or Brain Innovations, Inc.
Brain Innovations, Inc. assumes no responsibility for errors or omissions
in editorial, article, or program listing content.
-------------------------------------------------------------------------
@(#)info: Commodore Hacking Information
Commodore Hacking is published via the Internet 4 times yearly, and is
presented in both ISO-8859-1 and HTML versions. This and previous issues
can be found at the Commodore Hacking Home Page
(http://www.msen.com/~brain/chacking/), as well as via FTP
(ftp://ccnga.uwaterloo.ca/pub/cbm/hacking.mag/)
In addition, the Commodore Hacking mail server can be used to retrieve each
issue. To request a copy of an issue, please send the following electronic
mail message:
To: brain@mail.msen.com
Subject: MAILSERV
Body of Message:
help
catalog
send c=hacking13.txt
quit
To retrieve a PKZIP 1.01 archive of the individual articles in Commodore
Hacking, request the file c=hacking13.zip
To subscribe to the Commodore Hacking and receive new issues as
they are published, add the following command to you MAILSERV message
prior to the quit command:
subscribe c=hacking Firstname Lastname msglen
(msglen is largest size of email message in line you can receive. Each
line is roughly 50 characters, so 600 lines is about 30000 bytes. When
in doubt, choose 600)
example:
subscribe c=hacking Jim Brain 600
Although no fee is charged for this magazine, donations are gladly accepted
from corporate and individual concerns. All moneys will be used to defray
any administrative costs, subscribe to publications for review, and
compensate the individual authors contributing to this issue.
As part of a magazine promotion, Commodore Hacking Issue #12 was
professionally laid out on printed format. These printed copies are for
sale.
If you can not obtain Commodore Hacking through any other means and wish
to purchase a copy on disk or would like to purchase the professionally
printed Issue #12, please address a check or money order to "Jim Brain"
and mail to:
Jim Brain
10710 Bruhn Avenue
Bennington, NE 68007
Disk copies of each issue: USD$5.00
Professionally printed copy of Issue #12: USD$6.00
All prices cover only duplication and materials and include shipping in
the United States. For disk copies, please specify format:
Computer Disk Size Capacity Notes
CBM/PETSCII 5.25 inch 170 kB 1541 format
340 kB 1571 format
3.50 inch 800 kB 1581/FD2000 format
1.6 MB FD2000/FD4000 format
IBM/ASCII 3.50 inch 720 kB Double Density
1.4 MB High Density
Any persons wishing to author articles for inclusion in Commodore Hacking
are encouraged to view the submission guidelines on the WWW
(http://www.msen.com/~brain/pub/c-hacking-submit.txt) or via the MAILSERV
server (send c-hacking-submit.txt).
=========================================================================
@(#)rch: Reading C=Hacking
Starting with Issue 11 of Commodore Hacking, the new QuickFind indexing
system is utilized to aid readers of the text version in navigating the
magazine. At the top of each article or other important place in the
magazine, a word prefixed with a special string is present. (See the
title of this article for an example.) Throughout the magazine, if an
article is mentioned, it will be followed by a reference string. For
example, if we mentioned this article, we would add (Reference: rch) after
the name. By using your favorite editor's search function and searching
for the string after the word "Reference:", prefixed by the magic prefix
string, will move you directly to the article of choice. To merely skip to
the next article in the magazine, search only for the magic prefix string.
Some handy indexing strings possibly not referenced anywhere are:
top top of issue
bottom bottom of issue
contents table of contents
legal legal notice
For those with access to a UNIX system, the command "what" can be
run on the issue, which will result in all the article titles being
printed.
A slightly different magic prefix string "@(A)" is used to delimit
sub-topics or main heading in articles. The text after the magic string
differs depending on article content. For the Input/Output column
(Reference: io), the text after the magic prefix will either be "c" for
comment, or "r" for response. In features and columns, a number after
the prefix indicates the ordinal of that heading or sub-topic in the
article. If a specific sub-topic is referenced elsewhere in the article,
a sub-topic reference will be indicated. A reference to "@(A)r" would
be written as "(SubRef: r)".
As time goes on, the role of this indexing system will be expanded and
changed to ease navigation of the text version, but minimize the clutter
added by these extra items.
=========================================================================
@(#)editor: The Hacking Editor
by Jim Brain (j.brain@ieee.org)
Sometimes, it's important to look back and see how far we've come.
The following story comes to mind:
A young boy sits in the living room and flips earnestly through a
Montgomery Wards catalog looking for some item. The year is 1983.
At last he finds the item and presents the book to his father, who
is reading a periodical in his easy chair. "Dad," the boy begins,
"I want to buy one of these with my savings." The father, startled
upon hearing of such a prospective purchase, looks up and reaches for
the catalog. "What is it you want to buy?" he asks. "That video game
on the top of the page is what I want," the boy explains. The father
looks at the pertinent page and notices a glossy picture of an Atari
VCS2600 console system, complete with options. Frowning, the father
raises his head and look in the boy's eyes. "Son," he starts, "I am
not going to let you buy one of these video game systems. All they are
good for is playing games, and that's too much money to spend to buy a
game." The boy protests, stating that "all his friends" own one and
that it the "thing" to own today. The father, known for being stubborn,
refuses to budge on the issues, but concludes the exchange by handing the
catalog back and saying, "If you want to buy a machine that plays games,
buy one of those new computer systems. That way, you can play games with
it and also use it for other things when the games get old and boring."
The boy takes back the book and sulks for a while as he flips through the
pages. As the hurt wears off, he notices a section near the video console
page that shows off those new computer systems his Dad referred to. At
first, the kid's eye is drawn to the shiny silver Texas Instruments TI-99/4
computer system pictured in the catalog. He is about to jump up and
again hand the catalog to his Dad when he realizes the "new-fangled"
item is priced at $322.00. His heart sinks, for his savings account only
holds a bit over $250.00 and the machine looked so impressive. So, beaten
again, the young boy flips the page and resigns himself to never owning
anything "cool". However, the next page pictures a different computer
system and a quick check confirms the price is within budget: $233.00.
The computer isn't as impressive looking as the TI, but the boy will not
be without a "video game", and this fits the bill.
Needless to say, the computer was a Commodore VIC-20, and the boy bought
a few games for the unit, including a Space Invaders clone and a Pac-Man
clone. As the father predicted, the boy lost interest in the unit after a
while and packed the system away. However, as the boy entered 7th grade, he
again pulled the unit out when he learned that one of his classrooms was
equipped with Commodore VIC machines. His interest in computers as tools
started there and grew with the years.
As I finish my first year of editorship of Commodore Hacking, I am looking
back at the events that have occurred in the last year and those that have
occurred over the years since I first learned about Commodore computers.
Commodore owners have come from 3.5kB and 22 by 23 screens with the
VIC-20 to CBM machines with features like multiple megabytes of RAM, 33.6
kbps FaxModems, gigabyte hard drives, 8-20 MHz operation, and a host of
other options. No, I don't think Commodore computers can solve all the
world's problems. However, they and their owners should be commended on
their loyalty and dedication to the market and to the advances that have
kept the machines out of closets and dumpsters. While I won't doubt that
there are more IBM PC clones in the world today, I wonder how many PC
units are resting under tons of refuse in the city dump.
Here at Hacking Headquarters, I am impressded by what we have accomplished
with the publication, but I have already outlined improvements that can be
made and things I didn't quite get implemented this past year. As always,
your letters and comments are always appreciated. The publication depends
on reader feedback to ensure that covers subjects of interest to the
Commodore enthusiast. Of course, some things, like the technical focus
of Commodore Hacking, define the magazine and its place among the various
Commodore publications. However, even that can be continually improved.
So, as you look back on the past year of Commodore usage, take a look at
our progress or lack thereof and send us a note, if only to tell us to
change nothing. Remember, we can't increase the publication's usefulness
to you if we don't know where it currently falls short.
As for the boy in the above story, I think he's come a long way since that
fateful day in 1983. He no longer thinks TI's look better than CBM's. In
fact, I think he has earned an impressive reputation as a Commodore
advocate. Then again, I might be a bit biased, so you be the judge. The
boy in the story was a youngster named Jimmy. Jimmy Brain.
Enjoy YOUR magazine,
Jim Brain (j.brain@ieee.org)
editor
=========================================================================
@(#)io: Input/Output
Obviously, Commodore Hacking depends on the comments and article
submissions from the Commodore community to flourish. Everyone sees the
articles, but let's not forget those comments. They are very helpful,
and every attempt is made to address concerns in them. Address any
comments, concerns, or suggestions to:
Commodore Hacking
10710 Bruhn Avenue
Bennington, NE 68007
j.brain@ieee.org (Internet)
@(A)c: Hey! You Characters! Sit Down!
From: Adam Vardy (abe0084@InfoNET.st-johns.nf.ca)
Dear C=Hacking,
In the last issue there was some source code for printing very big
numbers. This source code is all in uppercase. This seems to be true
whenever source code is included in the magazine. I am wondering why
that is. This makes it rather difficult for me to extract the source and
put it into a form that my assembler can deal with. I can't load the
source right into Power Assembler. It only accepts lowercase code. It
is puzzling to me why you do this, because I would think any assembler
that accepts plain text would work this way too.
Another thing is this. In the last issue one of the uuencoded files in
the magazine was dim4. The source code for the included files is for the
Merlin Assembler. OK. So I try to read these files. I'm having
problems with this. If I try to More them in ACE, I can't. It's
unreadable. They seem to be text, but however I try to read them, I get
weird characters or other stuff. Loading them into a word processor or
into ZED, or anything doesn't work.
I don't have Merlin. But I would think it must have some way to save
plain text source. That way, everyone can at least read it, right?
@(A)r:
Code is printed in the magazine as it is received by Commodore Hacking.
The only formatting done to source code in articles and columns is to
indent each line 3 spaces. The source code to which you refer above was
in a USENET posting and was captured from the comp.sys.cbm newsgroup in
uppercase. Our theory is that some folks who upload code to the Internet
do not do an PETSCII-ASCII translation, which would cause the effect of
switching all lowercase characters to uppercase. However, we are not
certain that there all assemblers expect lowercase, which is why we do
not try to alter case of source code.
As for your second problem, we accept part of the blame. We are attempting
to obtain allof the source code used in the publciation in ASCII or
PETSCII format. However, a number of assemblers, including Turbo-Assembler,
do have an internal format that is neither ASCII nor PETSCII. Merlin may
also have such a format. However, we are unfamiliar with Merlin, so it
may not have an option to output code in ASCII or PETSCII, as Turbo-
Assembler does. Our suggestion is to contact the author of the article
directly and ask for an ASCII copy of the source and accept our apologies.
@(A)c: A Plea for Information
From: MICHAEL I DEMING <m.deming@genie.geis.com>
Dear C=Hacking,
An article or series of articles on the 80 column chip would be very helpful
e.g. how to use sprites, a screen dump and other things like that. If I knew
how to do this I would write the articles but I don't so I am begging for
any info on this chip.
@(A)r:
Always check back issues of Commodore Hacking for prior articles on topics.
See Commodore Hacking Information (Reference: info) for directions on how
to access back issues. VDC information is included in Issue 1 as part of
Craig Bruce's "Simple Hires Line Drawing Package for the C128" and as part
of Craig Taylor's "An In-Depth Look at the 8563 Video Chip on the C= 128" in
issue 2. As for the other topics, other articles in Commodore Hacking touch
on those issues, but we always appreciate new articles dealing with these
topics.
@(A)c: All I Can Say is Wow!
From: George Szaszvari <gsz@dial.pipex.com>
In Commodore Hacking #13 Preface:
>Whew! Folks, here is the long awaited Issue #13 of Commodore Hacking.
>Hacking Headquarters has produced an issue overflowing with technical
>articles sure to satisfy even the most discerning Commodore enthusiast.
>In fact, this issue is OVERFLOWING with 384 kB of material, so empty out
>that mailbox. Here it comes...
Yeah, a real BUMPER issue, thanks!
@(A)r:
Well, the size is a both a blessing and a curse. While we are happy about
the number and diversity of articles, we know there are those who can't
handle a large issue like #13, so we are trimming the size a bit from #14.
However, thanks for the comments.
@(A)c: Speaking of Kudos!
From: Brett Tabke
Dear C=Hacking,
Thank you! One of, if not THE, best issues yet!
I can't thank you enough for all the work you've done here Jim.
Between Hacking, The FAQ, and the CBM product documetation, you have
put out more valuable information in 6 months than most of the pay
magazines to in their lifetime. The CBM products listing is a rare
treasure that every CBM owner should take time to read.
@(A)r:
We don't know what to say. We're just happy that everyone stood by us
during the move and the delay in getting #13 out. By th way, for those who
have not seen. The CBM Products List to which Brett Tabke refers is
available as "cbmmodel.txt" on the MAILSERV and through the WWW.
(http://www.msen.com/~brain/pub/cbmmodel.txt) If you prefer to wait, an
updated copy will be presented in Commodore Hacking #15.
@(A)c: Who's Got the Right Copyright?
From: Ruth Hackley (fgm@rosenet.net)
Dear C=Hacking,
I am Ruth Hackley, Ron's wife, and newsletter editor for the L.C.C.U.G. in
Eugene. Are there any portions of C=Hacking that can be used in the
newsletter. We plan to provide the magazine on disk to our library as
well.
@(A)r:
The entire publication can be redistributable as a complete work, as
explained in the Commodore Hacking Legal Notice (Reference: legal). As
well, individual articles can be reprinted with permission from the author
of the article. Commodore Trivia is a special case. Permission has been
given by the author to reprint Commodore Trivia in newsletters and
publications, just as _Commodore World_ and this publication do.
@(A)c: A Little Lacking
From: Scott Brockway <fungus@eskimo.com>
Dear C=Hacking,
I thought the magazine was sort of a transactor replacement. When I
downloaded issue 12 of C=Hacking I was not just a bit disappointed. I
like all the technical stuff and now I fear the mag is no longer for me.
Hey C=H, Put the code back in!
@(A)r:
We are sorry you felt this way. It was not, nor is it currently, our
intention to leave technical readers without articles of interest. We ask
that you take a good look at the magazine. Others have initially thought
the magazine lacked technical content, but later determined that the style
of some articles had changed and the technical articles were separated by
a few less technical offerings. However, be aware that due to the time and
space constraints we are trying to fit Commodore hacking in will reduce the
number of technical articles by 1 or possibly 2 each issue over the old
issues. Also, some technical articles do not contain any code pieces.
In the case of Issue 12, we were forced to redo the issue after an important
technical article from a semi-regular writer did not appear. The resulting
rework might have shown through. We hope Issue 13 provided enough
technical content. Our most technical readers might find the current
issue a bit light on content, due to problems associated with Commodore
Hacking's recent relocation efforts. We ask that the technical readers
bear with us as we ramp up in our new location.
One of our continual problems, and one of Craig Taylor's (the previous
editor) as well was finding quality technical articles to publish. One way
to solve the problem is to delay the publication date, a tactic Craig might
have used. However, we are trying to get back on a stable schedule. So,
if you are up to it, write up a technical piece for inclusion in the next
issue.
@(A)c: A Bit of Their Own Medicine
From: wanderer_rtc@usa.pipeline.com (R. T. Cunningham)
Dear C=Hacking,
I just read CHacking #13 and was very impressed with the amount of work
put into it. While I was reading the HTML tutorial, I came to a
not quite brilliant idea.
While working on an HTML viewer, take time to see if you can work standard
C/G viewing. I would love to do up a bunch of web pages using C/G with the
familiar disclaimer up on top, previously posted by someone else and
plagiarized by me, <best viewed using a Commodore 8 Bit Computer>. This
would please quite a few people (besides me of course). Who says we have
to be able to see 256 colors!
@(A)r:
Oh, do we detect a bit of revenge here? I am sure Jim Brain can arrange C/G
graphics in the HTML viewer he is working on, but we can see a problem:
The eventual goal of the HTML viewer is to grow the application into a
full fledge WWW Browser. If a site uses C/G graphics exclusively, the
large number of Commodore enthusiasts that view WWW sites with non-CBM
graphical browsers will not see the C/G graphics.
In addition, some would-be Commodore enthusiasts who explore these C/G
graphics enabled sites might leave thinking we are snobs and never return.
We don't need that.
We think a slightly altered suggestion is better. When designing the
"<IMG>" tag in he HTML viewer, allow it to understand the optional
attribute "CBMSRC". That way, a Commodore site can safely display graphics
to non-CBM browsers and still put the "Best Viewed with a C64" on the
page. All the graphics on the page would then be specified by an image tag
looking like: <IMG SRC="junk.gif" CBMSRC="better.cg">. The CBMSRC attribute
could then be used on a CBM browser to display the alternate C/G graphic.
A non=CBM browser would ignore the CBMSRC attribute, and a tag like:
<IMG CBMSRC=...> would be ignored by the browser as well, since it contains
no SRC attribute. And, best of all, if you really wanted to keep the
Netscape browsers out, simply put <IMG SRC="better.cg">.
@(A)c: UU what?
From: Cameron Kaiser <ckaiser@sdcc13.ucsd.edu>
Dear C=Hacking,
I noticed that the last C-Hacking had a number of uuencoded
files concatenated to each other. This presents a problem in unix
because a number of crufty uudecoders don't recognize them together
(only the first one). I have made a PERL script that folks can use to
fix this. I'll leave it in
ftp.armory.com/pub/user/spectre/UNIX/multiuu.pl
@(A)r:
We appreciate the utility. If someone wants to take advantage of this
helpful utility, simply FTP the file to your local UNIX account and execute:
chmod u+x multiuu.pl
Then you should be able to uudecode multiple part files with this program.
@(A)c: Comfortable Reading
From: rbthomas@freenet.edmonton.ab.ca
I have d-loaded a few issues of C= Hacking and converted them to GEOS and
looked at them with geoWrite but that is a clumsy process. Also, I
understand some of the issues have program files in them and these need
to be extracted for use. How does a person go about this?
Thanks in advance for any help you can offer.
I have a 1581 and an FD-2000 drive so the space isn't a problem with
storing the file. I would like to read it in comfort also. TWS won't
handle it.
@(A)r:
To help people who can't handle the large size of Commodore Hacking,
each issue is now available as an archive of individual articles and already
decoded executable files. Commodore Hacking Information (Reference: info)
has information on how to obtain and dowload the archive files.
=========================================================================
@(#)news: Newsfront
@(A): Commodore Hacking CANCELED!
As many know, one of the distribution mediums for Commodore Hacking is
USENET, which is a services that operates primarily on the Internet.
After dutifully "posting" Issue #13, Hacking Headquarters was informed
that the posting had been "canceled". Since normally only the original
poster can delete or "cancel" a posting, we were alarmed. The culprit
turned out to be a automated program that had been installed on USENET
since Issue #12 was published. The program, called a "cancel robot" or
"cancelbot" for short, had been created by an individual and installed
on one USENET node. This specific cancelbot watches for large postings
to non-binary newsgroups (newsgroups that do not have "binary" or
"binaries" in their names) that contain large UUencoded binary files.
It then "forges" a cancel message by masquerading as the original poster.
Since USENET contains very little security, this notion of "forging"
postings can be done quite easily.
Without detailing the technical side of USENET, suffice it to say that
a posting from one site immediately begins its journey to all other sites
on USENET, being replicated along the way. The cancelbot canceled the
posting immediately after it showed up on its server. The cancel message
then began its journey to each server, canceling the article at each site.
Given the propogation delay of USENET, the posting was up long enough for
some readers to acquire it, but not everyone. Therefore, a pointer to
the location of the issue was posted later.
Along with the pointer posting, Commodore Hacking asked the USENET newgroup
comp.sys.cbm how it should ahndle the situation. We offered three
suggestions and asked for comment. They were:
1. Request an exclusion for the publication from the cancelbot
2. Publish only a pointer to the location of the new issue.
3. Publish the issue stripped of UUencoded binary files.
Suggestions 1 and 2 received an equal number of votes, with suggestion 3
receiving a couple of votes and 1 person voting to split the issue into
multiple parts. Needless to say, the issue is still undecided.
Therefore, for the current issue, we have requested an exclusion from the
USENET cancelbot. However, since most readers can now access the
publication via the World Wide Web, Electronic Mail, and FTP, we are
considering publishing only an announcement in the future. The
announcement will highlight the newest issue and detail where to obtain
it.
Some of the survey respondents mentioned that a few readers may only have
access to USENET as a means of receiving the magazine. If you are one of
those folks, PLEASE WRITE US! We are continuing to post the entire issue
on USENET for your benefit and may not continue to do so if we don't hear
from you. The postal mail address is located in this issue (Reference:
legal). If Commodore Hacking does not receive any aformentioned letters
or objections, we will consider posting only new issue announcements in
the future. Doing so would relieve some burden on the USENET system,
which was really not designed to handle a posting of C=Hacking's size.
If you have any questions about the potential impact of this change,
please mail us at Hacking Headquarters.
@(A): The The Underground Went South!
Shortly after the release of Commodore Hacking #13, Underground Magazine
editor Scott Eggleston informed his subscribers that changes in his life
had forced him to cut back on the time devoted to publishing, and that he
was merging The Underground with the newly announced LOADSTAR LETTER
commercial publication. As reported in the last issue, Scott will co-
edit the new expanded LOADSTAR LETTER with Jeff Jones and unfilled
Underground subscriptions will be filled with LOADSTAR LETTER
subscriptions on a 1 for 1 basis.
@(A): Get Yer QWKRR128 5.0! Read All About It!
In Commodore Hacking #13, Gaelyne Gasson (formerly Gaelyne Moranec),
described how to read Internet electronic mail offline by using an
offline mail reader like QWKRR128. Hot on the heels of that article,Rod
Gasson has announced the availability of a beta of version 5.0 of the
QWKRR128 software. Available to all registered users of QWKRR128, the
beta includes a number of enhancements and bug fixes, including:
1. Supports full 255byte character sets.
2. Reads messages of ANY length (including the ability to print, export,
or small.dat them).
3. Separate VIP & TWIT lists.
4. UUdecodes messages of any length as long as the UUencode is in a
single message. (It won't decode if the file is split over several
messages).
5. Decodes MIME messages (Base64). Same restriction as UUdecodes.
6. Added keyboard tables so it can be configured to 'international
standards'.
7. Updated the 'auto-netmail' routines to include Internet Email as well
as fido netmail.
8. Improved the address book so it will handle both the fidonet format
addresses and email style addresses.
9. Added the ability to ATTACH files to a message or reply. These
attaches are limited in length to about 8megs (the max that the QWK
format can handle).
10. Improved the routines to detect a valid Q.NDX file (the name of the
new QWKRR index file). This means these no longer have to be manually
scratched prior to reading a new mail packet.
11. Added code so that you no longer have to quit QWKRR in order to read
a different mail packet.
12. Improved the macros so that whole words can be used as a 'trigger'.
This can be used as a 'simple' spell corrector. (eg, a macro such as
"Ismeal=Ismael" will ensure that you'll never transpose the "a" and "e"
in Ismael again.
13. Added a 'scrap macro' that can be defined and used while in the
editor itself, without the need to add it to your macro file).
14. Added code so that quote initials can be changed 'on the fly' (This
is useful when quoting from Email messages where the default initials are
often meaningless).
15. Added time/date stamping to the zipped REP packets. (Some BBS's
didn't like having the same date/time stamp on all mail packets).
16. Improved access speed by about 3 times for Ramlink users.
17. Improved tagline handling. You can have up to 10,000 taglines in one
category. Tagline files are now numbered from .000 to 999.
18. Several cosmetic changes and bug fixes.
The new beta version is available from the 221b Baker Street BBS in the
US and GEOZ BBS in Australia and at:
ftp://ccnga.uwaterloo.ca/pub/cbm/INCOMING/telecomm/qwkrrv5b.lzh
ftp://hal9000.net.au/pub/cbm/qwkrr/qwkrrv5b.lzh
More complete information is available at:
http://www.hal9000.net.au/~moranec/qwkrr10.html
@(A): Centsible Software Address Update (And Some Bad News)
The folks at Centsible Software have moved! Well, they are still at the
same location, but they have "electronically moved", to sprynet.com. The
new information appears below:
Centsible Software
PO Box 930
St. Joseph, MI 49085
616-428-9096 (Orders and Information 12-6pm EST)
616-429-7211 (Bulleting Board System and Facsimile)
Cents@sprynet.com (Internet Contact)
http://home.sprynet.com/sprynet/cents (WWW URL)
On a sad note, Centsible contacted Hacking Headquarters later to note
that they will soon be closing down Centsible Software. All outstanding
orders will be completed, and the closure won't happen immediately, but
soon Centsible will be all but a memory.
@(A): Brace Yourself, There's More
Software Support International (SSI), has recently decided that they will
start focusing more on IBM compatible sales. In an initial announcement,
SSI indicated that they would no longer carry Commodore products after
January 1, 1997, but later announced that they would continue to sell
products as long as existing stock holds up. However, they will no
longer promote the CBM or Amiga product lines. The latest catalog from
SSI will be the last to carry CBM and Amiga merchandise.
@(A): And Now for Some Good News
Arkanix Labs, a West Coast hardware and software developer, recently
announced that they had acquired Threshold Productions International.
Petar Strinic (note the 'a' in Petar) announced that the acquisition
would expand their presence in the market. Arkanix Labs develops for the
MS-DOS and C64/128 systems, and is working on SuperCPU products. To find
out more about the company, visit their WWW Site at: www.arkanixlabs.com
or contact Mr. Strinic at: petars@arkanixlabs.com
@(A): The Underground To Live on in LOADSTAR LETTER
Scott Eggleston, editor of The Underground, has recently sent notice to
all Underground readers that recent changes in his life have prompted him
to discontinue publishing of The Underground. Determined that
Underground subscribers would not be left in the lurch, Scott has
arranged for each subscriber to receive issues of the newly launched
commercial LOADSTAR LETTER publication (See Newsfront in C=H #13). While
the size of each issue will be smaller, the issues will arrive monthly,
as opposed to The Underground's bimonthly schedule.
Scott, not bowing out of publishing entirely, will be brought on as
Associate Editor of LOADSTAR LETTER. Subscribers should expect to
receive their first issue of the merged publication at the same time The
Underground #15 would have arrived.
As well, Scott will continue to offer back issues of The Underground for
US$2.50 per issue. The Underware disk will no longer be available from
Eggleston, although reader Tom Adams (tom.adams@neteast.com) has agreed
to copy the disks as long as he is able to do so.
If you need to contact Scott Eggleston, you may do so at:
egglest1@cougarnet.byu.edu
@(A): Video Interface Computer (VIC) Software Available
Ghislain deBlois (dh374@freenet.carleton.ca) is currently releasing a
number of games and utilities for the avid Commodore VIC-20 user
community. Intending to release them in "cassette/disk of the month"
fashion, deBlois' first installment contains:
o Meteor Zone
o Mini Assembler
o Vicfall!
o Ringside
Future installments promise titles like: Realms of Quest, Ice Hockey,
Bosing, and Screen Magic (a multi-color hi-res drawing program). All
programs are written for the unexpanded VIC-20 computer system (VC-20 in
Europe) to better serve VIC enthusiasts. For more information, contact
deBlois at his electronic mail address.
@(A): Get on the Super CPU list!
Brett Tabke, of PHD Software, has created a mailing list for owners of
the CMD SuperCPU accelerator cartridge. To subscribe to the list, send a
message to:
listserve@giga.or.at
with a message body of:
subscribe super-cpu firstname lastname
@(A): Mailing Lists, Take Two!
For those who live in on the OTHER side of that little pond from the US,
or if you just want to keep up on the developments there, there is a new
electronic mailing list for European 64 enthusiasts. Simply send email
to:
listserv@lentil.demon.co.uk
with a subject of:
MAILSERV
and a body of:
subscribe 64EUROPE
END
The list address is: 64europe@lentil.demon.co.uk
@(A): It's Better than Novaterm 9.6!
Nick Rossi has recently announced that patch "A" for the latest version
of Novaterm (9.6) is now available. Citing the help of early purchasers
of the product, Nick noted a list of bug fixes that have been
incorporated in the new release, including:
* Estimated file length omitted from Zmodem upload, to avoid confusing BBS's.
* The "funny ASCII" problem when capturing to the buffer in ANSI or VT102
mode has been fixed.
* Due to the above, you should remove the ".opt ansi" line from all your
scripts and recompile them.
* A bug in the script function that checks for incoming strings was
fixed.
* The "Save buffer when full" option now works properly with hardware
flow control.
* A bug in the recovery function of the BBGRam driver was fixed.
* A bug in one ANSI screen clearing function was fixed.
* Several errors in the font81.ANSI character set were fixed: ASCII 160
was changed to á, and the fractions &188;, &189;, and &190; were put in
their proper order.
* Typing a shift-space now sends a space, rather than the á character.
* Color was added to the VT102 terminal emulation.
* A real-time clock driver was added to read from the CMD SmartMouse and
SmartTrak.
* Functions in the text editor were fixed: loading/saving in the buffer
and changing the device number.
If you have already purchased Novaterm 9.6, you can receive a free
upgrade by making a backup of your master disk and sending the master
disk back to:
Nick Rossi
10002 Aurora Ave. N. #3353
Seattle, WA 98133 U.S.A.
Copies of the latest release are available in either 1541 or 1581 disk
formats for USD$29.95 plus USD$1.50 for shipping and handling. The
software is accompanied by a 90 page user manual.
For more information on the upgrade or Novaterm in general, visit the
Novaterm 9.6 WWW Site: http://www.eskimo.com/~voyager/novaterm.html or
contact Mr. Rossi via email at: voyager@eskimo.com.
@(A): Who's Got the Rights to the Commodore 8-bit line?
That is a very good question. Ever since Commodore was sold to ESCOM
GmbH, Commodore 8-bit users have wondered who owns the intellectual
rights to the Commodore 8-bit line of computers. Now that ESCOM has
declared bankruptcy and initiated the sale of the Amiga line to US based
Visual Information Service Corporation (VISCorp), CBM enthusiasts are
even more curious. The sale, evidently drawn up before the bankruptcy
declaration, would place Amiga technology into the hands of VISCorp,
which was started by several ex-Commodore engineers. However, even if or
when the deal is finalized, who owns the rights to the CBM 8-bit line may
still be a mystery.
@(A): New Address for Meeting 64/128 Users Through the Mail
Tom Adams, president of the mail correspondence club called Meeting
64/128 Users Through the Mail, asks that all electronic correspondence
for either him or the club be addressed to:
tom.adams@neteast.com
@(A): Complete you Transactor Collection!
Karl Hildon, one of the producers of the now-defunct _Transactor_
publication, has announced that he is now able to provide electronic
copies of any issue of the technical magazine for USD$5.00. Issues can
be scanned in the format of your choice, and will be electronically
mailed to the purchaser.
To order, mail Karl Hildon your Visa Card account number (visa only) and
expiration date and issue number request to karl@inforamp.net. If you
need to consult an index first, there is one located at:
http://vanbc.wimsey.com/~danf/cbm/transactor.idx
Mr. Hildon also mentioned that if demand warrants, he will also make
available the _Transactor_ companion disks.
Also, Mr. Hildon has announced that he can also make available copies of
_The Inner Space Anthology_ for USD$20.00 or CAN$20.00. Follow the above
directions to obtain copies of this out of print resource.
@(A): "Ultimate" Demonstration Contest Announced
Commodore Zone and Tim Wright have announced the Commodore 64 Golden
Fleece Award 1997 contest. An award of $100.00 will be presented to the
author of a demo program that represents the best in demo construction
and captures the spirit that have made demos a staple of Commodore
history. The deadline for entry is February 1, 1997, and entries should
be sent to "Binary Zone P.D. Entries must fit on a single side of a 1541
disk, and will be judged as complete works. Authors can enter as many
works as they wish. Entries will be judged on programming ability,
graphics expertise, and musical content as well as overall presentation.
All entries must be previously unreleased material. Entries should be
accompanied by contact details, and the winner will be featured in Binary
Zone P.D. For further information, or to enter the contest, contact:
Jason 'Kenz' Mackenzie
Binary Zone P.D.
34 Portland Road
Droitwich
Worcestershire
England
WR9 7QW
@(A): Possible Products for SuperCPU 'Puter
PROTOVISION, a game development company, is currently working on
compression tools for the SuperCPU, as well as some utilities for the
new unit that are designed to take full advantage of the 16 bit
processing power of the 65C816. In addition, the company is
investigating the possibility of developing a new graphical operating
system for the unit that will run in 16 bit mode and take advantage of
the 16 megabytes of addressing and the new opcodes available in the
accelerator. The new system will be able to multitask and offer several
graphics modes and capabilities.
@(A): New OS Version Available
For those who enjoyed reading about Andre Fachat's OS/A65 operating
system in the last issue of Commodore Hacking (Issue 13, Section: os),
Andre has updated his multitasking OS to version 1.3.10b. New in this
version is:
* MORE AVAILABLE TASKS and STACK SPACE for systems w/o MMU (C64): New
compile option STACKCOPY for systems without MMU. Allows more tasks and
gives each task more stack space.
* new 9600 baud RS232 driver for C64! (see comp.sys.cbm FAQ)
* new 6551 ACIA driver for the C64 (connected to IRQ line)
* new 16550A UART driver for all supported machines!
* New GETB and PUTB kernel calls, to get and put a whole data block from
and to a stream. It is used by the FSIEC filesystem currently.
* Better NMI handling:
New CTRLNMI kernel call, and modified SETNMI call. SETNMI now sets the
NMI routine address, and enables NMI routine chaining. There also must be
a link to a control routine that can enable and disable the NMI line.
Therefore FSIEC and FSIBM now call CTRLNMI to switch the NMI on and off
around their time critical regions.
* Introduced return code to device IRQ routines. This allows to return
from the IRQ routines prematurely, if one IRQ routine signals that it has
removed an IRQ source (if SYSINPORT is not available).
It is available on the World Wide Web at:
http://www.tu-chemnitz.de/~fachat/csa/
@(A): Current Releases for the Commodore from CWI
Computer Workshops, Inc., is currently distributing NewView, an image
effects generato, and HyperLink, a hypermedia authoring system. More
information on these titles and their upcoming 3D Game, "Nether", are
available at:
http://www.armory.com/~spectre/
@(A): Commodore Hacking Selected for Inclusion in PC Webopaedia
Sandy Bay Software, Incorporated has selected Commodore Hacking's
World Root WWW Site to be included in a virtual encyclopedia of WWW
sites. Visit the PC Webopaedia at:
Dear Webmaster:
http://www.sandybay.com/pc-web
@(A): LOADSTAR's Pass Around Issue is Available
J and F Publishing has announced that LOADSTAR Issue #148 has been
selected to be a "pass-around" issue. This issue is available for free
and is intended to allow non-subscribers a chance to see what is in the
disk-based monthly magazine. Issue #148 is available at:
http://www.loadstar.com/pass.html
Wraptorized and ARCed versions are available for 1541 and 1581, while
Compression Kit, .d64 images, and PKZip version are available in 1541
format.
Screen shots of the issue are available at:
http://www.loadstar.com/148contents.html
The issue is packed, filling over 700 kB, and includes articles like:
* How to Copy Files
* Super Snapshot Bypass Switch Installation
* 'Lectronic Formulator
* Directomeister II Directory Editor
* Menu Toolbox III, as published in C=Hacking #14 (Reference: toolbox)
* GEOS Fonts (Ronda and Triana)
Download the issue today, and share it with your friends and user groups.
@(A): Hey! It's the Commodore Man!
If you're in the market for some used equipment or require some service
on your CBM system, contact:
Jon Searle, The Commodore Man
Service and Software
1307 Golfview Drive
Grain Valley, MO 64029
Jon offers over 1000 titles, documentation, books, magazines, and
hardware. A catalog can be requested for a nominal fee. Until December
31, 1996, Jon is offering a "Buy 3, Get 1 Free" offer on software
titles. Write for details and restrictions.
@(A): GEOS III, Revenge of the 8-bit GUI!
Maurice Randall, creator of such GEOS offerings as GeoFAX and many
utilities for CMD, has announced that he is formally working on GEOS 3.0.
He has successfully reverse engineered GEOS 2.0 and is now working to
incorporate changes into the OS that will provide more seamless support
for peripherals announced since the release of GEOS 2.0. Among the
changes is a number of bug fixes to the original GEOS OS code and some
enhancements to allow shortening of the OS code or faster execution. A
time or formal name for the project has not been determined, but the new
version will require some type of RAM expansion.
At a recent Lansing Area Commodore Club meeting, Maurice demonstrated
some of the changes that may show up in the final GEOS 3.0 system. They
include:
o Removal of 15 file limit in file lists.
o Ability to use CMD devices in Native Mode.
o Ability to read CMD FD DD disks in a 1581 drive.
o Ability to create CMD Native partitions on a RAMDisk.
o Ability to read/write MS-DOS floppies as native files on 1571,81, or
FD.
o Ability to read single bytes from drives.
o Ability to utilize 4 separate disk drives simultaneously
These changes are incorporated in new disk driver code that can be used
by any existing GEOS application. The new drivers utilize a radically
different Configure program with more options than the current setup
application of the same name.
Maurice stated that he will likely take a half-written desktop
replacement he has written titled "Dashboard" and develop it into what
will become the replacement for DeskTop in GEOS 2.0.
Although the new system will require the use of RAM expansion, the system
will not require a SuperCPU or other speed enhancement unit to operate.
@(A): Explosive Commodore Surfing Power
Brain Innovations, Inc., recently announced that they had revamped the
popular WWW Links pages on Jim Brain's Commodore home Page. The new
site, completely automated, offers many advantages over the older set of
pages. The new site, called CaBooM!, can display links in either HTML
TABLE or UNORDERED LIST format, include or exclude graphics, and include
or exclude link descriptions. The site is organized into categories and
sub-categories. Surfers can automatically add new sites to the system
and specify which categories fit the site. Users can also update sites
at a later date by specifying their user ID and password used to create
the site. New and updated entries are identified with appropriate
comments, and sites can be listed in multiple categories. Check out the
new system at:
http://www.msen.com/~brain/cbmlinks/index.html
=========================================================================
@(#)trick: HEAVY MATH - Part 1: Introduction to Linear Programming (LP)
by Alan Jones (alan.jones@qcs.org)
This article describes the Linear Programming problem. LP software is
being developed for the C64 to emphasize that the C64 is capable of
solving HEAVY MATH problems. It describes some of the C64 program design
issues and gives readers an opportunity it influence the development of
the software.
@(A): Introduction
Linear Programming, LP, is the simplest type of constrained numerical
optimization problem. It's simplest (standard) form is:
max P = c'x
s.t. Ax = b
x >= 0
That is, we want to find the solution vector x which maximizes the
function P, which is a linear combination of elements of x, while
satisfying the linear equation Ax = b, and with each element of x >= 0.
A is a matrix with typically more columns than rows. The maximization
problem itself is easy, except for the inequalities and determining which
elements of x are fixed at a bound and which are free.
Assume x is a vector of 20 variables and we have 10 equality constraints
making A a 10 by 20 matrix. Solving the problem involves choosing 10 of
the variables to be bound (at zero), eliminating those 10 columns from A
and solving the reduced linear system, say B*xb = b, for the other 10
elements of x, xb. Then sort through the solutions to find the feasible
solutions that satisfy all of the constraints, x >= 0, and chose from
them the solution that will maximize the function P. Taking 20 columns
of A 10 at a time we will have 184,756 solutions to solve and evaluate!
@(A): LP Development
LP is an important problem that requires a computer and clever algorithms
to solve non-trivial problems. The development of LP algorithms
parallels the early development of computers. George Dantzig published
his first paper on his simplex method in 1947. LP problems have long
been studied in mathematics, economics, and business fields, but the
simplex method and the computer were the big breakthroughs. Just imagine
the problem of allocating and distributing limited resources to millions
of soldiers in WW II. There are many types of problems that can be
solved as LP problems, and some have specialized algorithms for their
efficient solution.
@(A): LP Examples
The inequality constraint occurs naturally. Many processes are
irreversible. For example you can burn fuel in rocket at a positive fuel
flow rate to produce thrust, but you can't unburn the exhaust to refill
the tanks. A table leg can push on the floor but not pull (unless
bolted). A rope, cable, or chain can pull but not push. You can't buy or
sell negative quantities of a new item. You can't start assembling a
machine before the parts arrive.
LP problems can also be written in more general forms. Perhaps the most
general is:
max P = c'x
s.t. bl <= Ax <= bu
xl <= x <= xu
Where bl an xl are vectors of lower bounds and bu and xu are vectors of
upper bounds.
The LP forms can be manipulated with simple algebraic operations and by
adding constraints and "slack" variables. Most numerical optimization
problems are set up to minimize a cost function. Historically, LP
problems are set up as maximization problems. If your function P is a
total cost to be minimized, simply multiply the vector c by -1 and
maximize instead. Multiplying the i'th constraint equation by -1 will
change the sign of all the elements of the i'th row of A, bl, bu, and
change the direction of the inequalities, but not change x(i). The i'th
constraint above is actually two equations and can be written (neglecting
the subscripts):
Ax <= bu
Ax >= bl
To convert them to equality constraints:
Ax + y1 = bu
Ax + -y2 = bl
y1 and y2 are additional variables both >= 0 added to take up the "slack"
in the inequality equations. When the constraint is free (i.e. could be
ignored) the slack variable is >0. When the constraint is active, the
slack variable is constrained to zero. The slack variables are simply
appended to the vector x and treated as normal variables.
Lower bounds on x can be removed with a change of variable, x = y - xl,
without adding more rows or variables.
xl <= x <= xu, becomes 0 <= y <= xu - xl
Upper bounds on x can be handled by adding slack variables. The expanded
problem could look like:
Ax = b
x + xs = xu
x >= 0, xs >= 0
This can double the length of the x vector and add an equal number of
equality constraints. A fair amount of algebraic manipulation is
possible to get a LP into the form required by the solution software.
This can significantly increase the problem size. Good software will use
the more general forms of the LP program and use a more sophisticated
solution logic instead of increasing the problem size.
Mixture problems are probably the easiest to describe for illustrating
the importance of LP. Suppose you are producing cans of mixed nuts. You
want to find the percentage of each nut to mix and package at the lowest
cost, or maximum profit. You check the commodities prices of the various
nuts available at different times and places. c(i) could be the price
per pound of each nut, i, and x(i) would be the percent of that nut to be
mixed. One constraint is that the percentages total 100. The Marketing
Department may demand no more than 25% peanuts and no less than 5% of
Cashews, pecans, and almonds. Each nut may be scored for crunchiness,
and other aspects of taste to meet other constraints. Of course no x(i)
can be less than zero. You can do the same thing with "real fruit juice"
drinks. Mix the cheapest available fruit juices while balancing
sweetness, acidity, color, taste, and other factors.
Another type of problem is project scheduling. Suppose you are going to
design and build a bridge, or spacecraft. You identify all of the
tasks that must be accomplished, and then estimate their completion time
and constraints. E.g. task 43 can't begin until tasks 16, 17, and 41
have been completed. You could then set up a LP problem to schedule each
task so as to complete the project in the minimum time. Various other
performance criteria can be embedded in a LP problem.
@(A): Non Linear Programming (NLP)
LP is also a special case of Non Linear Programming, NLP. The NLP
problem is similar to the LP problem except that the objective function P
and constraint equations can be nonlinear functions. NLP is a much more
expensive problem to solve. An approach to solving a NLP is to linearize
the problem at a point to get a LP subproblem. Solving the LP gives a
search direction for the NLP problem. You then advance in the search
direction until you have made sufficient improvement in the objective
function or diverged too far from the constraints. You then correct back
to the constraints and linearize again. The sequence is repeated until
the solution is found.
@(A): C64 Software?
Computers were not created by secretaries and typesetters. Although
computers can do a lot of things, they were created to do Heavy Math.
The first electronic computer, the Attanasoff-Berry Computer, ABC, was
built to solve systems of up to 29 linear equations, although it could be
adapted to solve other problems as well. The second and third, ENIAC and
EDVAC, were intended to solve ODEs (Ordinary Differential Equations, i.e.
computing artillery range tables), as well as more general usage.(ENIAC's
first operational use was solving a 25 by 25 set of linear equations from
Los Alamos to see if an atomic bomb might be feasible. The ABC could
have solved this problem, but it had a read/write reliability problem and
Attanasoff was called up for other war related work instead of perfecting
the ABC.) And I have already discussed the LP problem.
Software for the C64 has been readily available and published in the C64
related literature for solving systems of linear equations and
numerically integrating differential equations (4th order Runge-Kutta
being typical). However nothing is available or published for solving LP
problems on a C64. I do recall seeing a one inch ad in some Commodore
magazines trying to sell software to solve small LP problems on a C64,
maybe 15-20 equations, but I never read any reviews of it and I always
suspected it to be poor software. I intend to plug this hole by writing
a good LP program for the C64.
This is Part 1 of at least a two part series on LP for the C64. Part 2
will include the presentation of the C64 LP program. I usually hate
multi-part articles that could have been published as one large article.
However, in this case Part 2, and indeed the C64 LP computer program, has
not been written yet. Part 2 will be dependent on reader feedback!
No feedback means no reader or user interest and I won't bother to submit
Part 2. I have not written a LP program before, or even used one much
on other systems. There is a very good chance that some readers will
have experience with LP software and can offer practical suggestions
for writing C64 LP software. I would also like to hear from any reader
who may have some type of LP problem that they would like to be able to
solve, perhaps something related to a hobby or home computing application.
Also, someone may be able to point me to an ideal LP reference book or
even provide suitable source code to examine.
Choosing a LP solution method for the C64 is not an easy task.
Appropriate reference books and papers are hard to come by. There is
nothing in the CBM literature that I am aware of. Many books have been
published on the LP subject. However, most are old books written for
business students or for training clerks to solve small problems by hand,
and they use outdated methods. These are easily found in local libraries
and at small colleges. LP is still an active research area and many new
journal articles are still being written, as well as new books. However,
the focus in on solving VERY large LP problems using sparse matrix
algebra techniques, and newer methods such as Karmarker or interior-point
methods. There is even a LP FAQ available. Two of the best references
that I have found so far are: "Computer Solution of Linear Programs", J.
L. Nazareth (1987), and "Advanced Linear Programming", B. A. Murtagh
(1981). The LP source codes that I have looked at were either too crude,
suitable only for small problems, too poorly documented, or suited only
for large problems on large computers. This gives you some idea of where
I am at, should you want to provide helpful feedback.
Our C64 (and 128) does arithmetic slowly, but reliably, and has limited
memory. We would not want to solve a large LP problem with thousands of
constraints and variables on a C64 even if we could. Still, we want to
be able solve problems as large as practical using efficient methods. At
the heart of the solution algorithm we must be able to solve an n by n
system of equations, where n is the number of constraint equations. For,
say n = 70, we will need 24,500 bytes to store the full matrix, leaving
the rest for the OS/language/LP program. The simplex type solutions
typically require computation time = K * n~3, so we will not likely want
to solve any LP problems on the C64 with more than 70 constraints.
The desire to solve huge LP problems also motivated the development of
sparse matrix algebra techniques. Matrices associated with LP tend be
very sparse. The idea is to be able to store only the non-zero elements,
to store them in data structures that can be used effectively by linear
equation solvers, and to use larger but often slower external memory
efficiently. These codes have a higher overhead in terms of code size
and computation/FP multiply. However, these codes can compute the same
results with substantially fewer multiplies than simpler code for dense
or full matrices. They often perform faster overall, at least on scalar
computers. Our 6502 can zip through complicated data structures and ML
code fairly fast compared to the cost of a FP multiply. Using sparse
matrix techniques is possible with the C64, but no
t required. I think
the complications of using sparse matrix methods is not warranted in this
case. Users wanting to solve large sparse problems are free to disagree.
@(A): Types of LP Problems
There are several LP solution methods: (primal) simplex, revised simplex,
dual simplex, primal-dual simplex, Karmarker, and others. There are also
many variations among these. I have chosen the revised simplex method
for the C64 program. Some other choices might be better for some types
of LP problems, and I may also write a primal-dual simplex program.
In the revised simplex method, the constraint matrix A can be stored
outside of main memory (on disk or REU) and brought in a column at a
time. The matrix A can be stored in a sparse matrix form. This is
probably a good idea for our slow disk storage, but unnecessary for our
REU storage. A square matrix B will be based on a set of n columns of A.
At each iteration a new column of A is chosen to enter B and an old
column is re moved. Each column represents an element of x and the
objective is to get the unbound variables selected into B with the
remaining variables set to their limits. At each iteration we have to
solve many linear systems using B with different right hand side vectors
and then update B to account for the column addition and removal.
There are several ways to work with the matrix B. B can be explicitly
inverted. The inverse can then be explicitly updated using the Sherman-
Morrison-Woodburry formula, or updated in product form by storing a
sparse matrix factor that accounts for the update. The later is
preferred for sparse implementations, but the storage used grows with
each iteration and eventually a new explicit inverse of B will have to be
computed. Both methods are numerically unstable and can have excessive
growth of roundoff errors, necessitating error checks and occasional
reinversion.
B can also be efficiently used in an LU factored form. B = LU where L is
lower triangular and U is upper triangular. The updating is difficult,
especially when exploiting sparcity and external storage. Bartels and
Golub (1969) developed a numerically stable way of updating the L and U
factors that enabled L to be stored externally, with U stored in main
memory. Forrest and Tomlin (1972) developed a method that allows both L
and U to use external storage. This is the method used in most
commercial codes for solving large LP problems. However, it is not
numerically stable and needs to be monitored and refactored. Sanders
(1976) developed a variation of the Bartels-Golub method that is stable
and allows most of U to be stored externally. Fletcher and Matthews
(1984) developed a stable method for updating the LU factors explicitly
in main memory.
In the Fletcher-Matthews update we have: PBQ = LU. B is the unfactored
matrix, P is a row permutation matrix, Q is a column permutation matrix,
L is a unit lower triangular matrix, and U is an upper triangular matrix.
L and U are stored explicitly (not in a factored form) in a square matrix
B. L and U are first formed using a normal LU factorization (Gaussian
elimination). P is a row permutation matrix that represents the partial
pivoting normally used to stabilize Gaussian elimination. Q is an
optional column permutation that represents the full pivoting that could
be done with Gaussian elimination to get better numerical stability. P
and Q are completely defined by integer arrays. In the update, one
column of B is removed, the rest of the vectors are shifted left to fill
the gap, and the entering vector placed in the right most column of B.
L, U, and P are then updated to a stable factorization of the new B
matrix. Pivoting is still required for stability, but only two adjacent
rows can be exchanged. This is a weaker form of stability than Gaussian
elimination with partial pivoting. It may be advisable to use some more
extreme measures to assure greater accuracy, such as preliminary scaling
of the problem (equilibration), full pivoting in the initial
factorization, or doing a final refactorization. Q is not changed during
the update (no column pivoting for stability), but we will have to keep
track of where each column of A is located in B (or the LU factorization
of B). The update is also cheaper when the column of B removed is
farther to the right.
I have chosen to use the Fletcher-Matthews update. This choice is ideal
for dense LP problems, but less so for sparse problems. It limits the
number of constraints that we can handle. It also has consequences for
other program design choices that must be made for the C64 LP program.
Using the simple standard form keeps the program logic simple, but
converting problems with inequality constraints and upper and lower
bounds to standard form will make the problem size bigger. This will be
more expensive to solve when not taking advantage of sparcity, and make
our size limit more significant. I am leaning toward solving LP
problems in the form:
Max P = c'x
s.t. Ax = b
xl <= x <= xu
There are many more program design choices to make. There are different
strategies for selecting the entering and leaving variables (columns).
There are different ways to pick a starting B matrix. There are
different ways to perform "Phase 1" of the revised simplex algorithm.
Many of the internal tests of floating point results involve tolerances.
These tolerances do affect the performance of the program. However, I
have only seen arbitrary suggested tolerances. These tolerances should
be determined by the floating point precision used, the problems size,
matrix condition number, and perhaps some problem specific parameters. I
have not seen any numerical analyses indicating how to set the
tolerances.
I have completed the subroutines to perform the Fletcher-Matthews update,
matrix factorization, and solving linear systems. Your interest and
feedback can influence other major parts of the program, or even convince
me to use a different updating method. Or perhaps everyone would rather
not see the sequel? You can reach me via e-mail at: alan.jones@qcs.org
Since I am writing this software it will be developed in the COMAL 2.0
language, which is fast and very readable (and thus easily translated to
other languages). A typical commercial LP code represents about 10 man
years of development. The C64 software will represent perhaps 10 days,
plus past research, or 10 weeks of part time effort, and be submitted for
the next issue of C=Hacking. It won't be the best software, but it will
be good. Over a period of perhaps a year, we can incorporate and publish
changes (hopefully not actual bugs). Then it can be translated be to ACE
assembly or some other language to make it available to more C64/128
users.
@(A): Conclusion
The C64 LP software is being developed simply to fill an empty slot in
C64 software. It is also to emphasize that the C64 can indeed be used
for HEAVY MATH, subject only to constraints of limited speed, memory, and
software. There is little demand for solving LP problems on a C64,
otherwise it would have been done many times already. This article will
not interest many C64/128 users. It does not even come close to
describing how to write a working LP program. It does describe what LP
is and some of the issues involved in designing a LP program for the C64.
I do thank those that read this far. Don't forget to write.
=========================================================================
@(#)mags: Hacking the Mags
Not everything good and/or technical comes from Commodore Hacking, which
is as it should be. (We still think we have the most, though...) Thus,
let's spotlight some good and/or technical reading from the other
Commodore publications.
If you know of a magazine that you would like to see summarized here, let
C=Hacking know about it. These summaries are only limited by Commodore
Hacking's inability to purchase subscriptions to all the Commodore
publications available. We are very grateful to those publications that
send complimentary copies of their publications for review.
@(A): Commodore World (http://www.the-spa.com/cmd/cwhome.html)
Although a bit late, Issue 15 made its way to our mailbox and opened
with an apology from VP Charles Christianson detailing why the current
issue took so long to reach subscribers. As we suspected, it was due
to SuperCPU shipments and general bug-swatting. However, another factor
that wasn't as obvious was some personnel changes in the publication.
Gaelyne Gasson goes over the various graphics formats and how to
convert them to viewable formats on the Commodore. The GEOS programmers
will appreciate Maurice Randall's article on VLIR files, and Doug Cotton
presents Part 2 of his discussion on file transfer utilities. The
demo scene gets a little press with Sherry Freedline's piece on
demos, including a section on _Driven_, reviewed below. Commodore
Hacking even got a mention or two in Max Cottrell's report on the
Lansing Area Commodore Club Expo '96.
@(A): DisC=overy (http://www.eskimo.com/~drray/discovery.html)
Arriving on the Internet October 1st, Issue 2 of this new publication
maintains the level of content started in Issue 1. We suppose it's
too early to tell, but it looks like one will show up every 4 months.
The issue starts with three detailed pieces on VIC video techniques,
including a discussion of the Super Hires FLI technique by Roland
Toegal and 'Count Zero', a starter article on using raster interrupts
by Mike Gordillo and 'Dokken', and how to use simple text scroll
routines in programs by Mike Gordillo. Steve Judd details the basics of
using the SID chip, and Andreas Varga steals the issue with an
interview with SID creator Bob Yannes. The article is a must read.
The highlights of the hardware section is a Atari 2600 cartridge
reader for the VIC-20 by Ravid Noam and how to upgrade a Commodore
16 to 64 kB by Martin Gierich.
@(A): Driven (http://soho.ios.com/~coolhnd/)
In addition to the funky banner on Driven #15, the issue mentions
the resurgence of the Demo Scene and congratulates all the recent
Driven 4kB Competition entrants. If you are interested in demos and
what effects are possible, be sure to check out the recent entries.
#15 details the CMD Swiftlink in an article by Perry Eidelbus.
Users undecided on purchasing a SL, or programmers unsure of whether to
develop for the unit should read this piece. In a look back, 'The Hobbitt'
runs through the history of the NTSC demo scene. Also, if you
didn't get a chance to take a look at DisC=overy yet, there's an
interview with editor Mike Gordillo in this issue.
In between #15 and #16, Driven published the "Driven 4K Compo Edition",
containing reviews and comments on the entries submitted for the recent
Driven competition.
Driven #16 contains a look into the world of Computer Workshops, Inc.
(CWI) by Cameron Kaiser, as well as a detailed description of Craig
Bruce's ACE OS, available on the Internet. As well, there are the
usual notices of new demo releases and groups. The editors remark that
they feel #16 is the best Driven yet.
@(A): LOADSTAR (http://www.loadstar.com)
Sometimes, we read LOADSTAR purely for the entertainment factor. And
I don't mean the games on the disk. In Issue 145, Jeff Jones outlines
his top ten email pet peeves. #145 delves into a rare topic in C64
circles: Musical Instrument Digital Interface (MIDI). Fender goes over
the protocol and how it can be used with a 64/128. On the heels of that
article is a piece by John Serafino that creates MIDI tracks for
your own enjoyment. Bo Zimmerman presents a "Presenter" for LOADSTAR
that utilizes GEOS. In addition, Bo gives GEOS users a handy utility
that archives files and can even create .d64 images. To supplement
Maurice Randall's _Commodore World_ article on VLIR files, Roger
Detaille details the revisions in the directory that GEOS disks dictate.
As a bonus, Issue #145 contains Driven 12, reviewed in C=Hacking Issue
13 (Reference: mags) as well as DisC=overy #1, also reviewed last time.
Issue 146 starts off on an apologetic note, as Jeff repents for
redistributing DisC=overy #1 not in its entirety. It brings up an
important point that compilations like DisC=overy and C=Hacking can
only be freely redistributed in their entirety. Diving into the issue,
developers looking to design their own fonts might find use in Anthony
Rose's Font Studio, Bob Markland's Font Viewer II, or Bob's Font Studio
Printer. Jeff presents his entry in the Directory Editor arena:
DirectoMeister I.
Demo Scene folks will enjoy "Omni's First Demo" on Issue 147.
Continuing with the video theme, Andrew Martin present Hires Sketch II,
an art creation application. Of interest to GEOS DTP (Desktop
Publishing) folks is a set of two GEOPaint documents containing
some clip-art.
As mentioned in Newsfront (Reference: news), Issue 148 has been released
to the Commodore community as a "pass-around" issue. Distribution is
encouraged. Although not technical in nature, everyone should read the
piece describing this issue. It gives some insight into the workings
of LOADSTAR and its ex-parent company, SOFTDISK. Fender Tucker shows
how to add a bypass switch to a Super Snapshot cartridge, while Jeff
revamps his Directomeister I into version II. As well, Menu Toolbox III,
included in this issue (Reference: toolbox) is available on LS148.
As well, Commodore Hacking #13 is included on the 3.5" disk version.
@(A): The Underground
Issue #14 is the last issue for this publication. It has merged with
LOADSTAR LETTER. See Newsfront (Reference: news) for more information.
We were hoping to get the last issue in to review it, but C=Hacking's
recent relocation sent the issue off into never-never land. Anyway,
we wish Scott Eggleston and his family the best. He will continue to
edit LOADSTAR LETTER.
Other magazines not covered in this rundown include:
* _64'er_
* _Atta Bitar_ (_8 bitter_)
* _COIN!_
o _Commodore 64/128 Power User Newsletter (CPU)
o _COMMODORE CEE_
o _Commodore Gazette_
* _Commodore Network_
* _Commodore Zone_
o _LOADSTAR 128_
o _LOADSTAR LETTER_ (We received an electronic copy, but couldn't print it)
* _Gatekeeper_
o _Vision_
Notes on Legend:
* = We have never received an issue of this publication.
o = We have not received a new issue of this publication to review.
+ = We will begin reviewing this magazine in the next issue.
In addition, others exist that C=Hacking is simply not aware of. As soon
as we can snag a copy of any of these, or get the foreign language ones
in English :-), we will give you the scoop on them.
============================================================================
@(#)net: The Commodore Telnet BBS
by Bo Zimmerman (ez13942@swt.edu)
@(A): Overview
The following are instructions for setting up a Commodore computer as a
telnet-able BBS. It relies on a modem connection with a PC running LINUX
with a telnet daemon. The Commodore is connected to the PC via a null
modem cable. The LINUX box has a modified version of minicom, which
comes with the slackware distribution (and others I would imagine), and a
shell script, all described in greater detail below. The essential goal
is this: when a user telnets to the LINUX machine and logs in as the BBS
user, the PC will run the modified minicom, which is set up to
communicate with the COM port connected to the Commodore. When minicom
starts up, it will signal the Commodore that a connection has been made
by setting the modem port's DTR signal. The Commodore BBS program goes
online because the DTR line is attached to the DCD line in the cable. So
long as the user is still in minicom, the connection remains, and wa-la!
A Commodore on the net!
Part I : Required Components (SubRef: 1)
Part II : RS232 Adapter Instructions (SubRef: 2)
Part III: Setting up the LINUX box (SubRef: 3)
Part IV : Setting up the Commodore BBS program (SubRef: 4)
Part V : What's missing (SubRef: 5)
Part VI : Credits (SubRef: 6)
@(A)1: Part I: Required Components
1) Commodore 64/128/VIC-20
2) Sufficient Commodore drives for your BBS software.
3) Commodore BBS software with DCD initiation capabilities (see part IV)
4) Standard RS232 null modem cable adaptor for the Commodore
5) PC 386 or better running Linux
6) Network capabilities for the Linux machine (ethernet card, PPP
connection, or other connection)
@(A)2: Part II: RS232 Adaptor Instructions
(This is cut and pasted from some instructions I downloaded off of
ftp.funet.fi and then modified for a standard 9 pin female COM port on a
PC).
USER PORT STD. DB9 COM NULL DB9 COM
CABLE CABLE
| +------\ | |
| 2 | \ 3 | |
M -|------------------| U1-A O-------|- 2 TX ----------|- 3 RX
| | / | |
| +------/ | |
| \ | |
| | \ | |
| 3| \ 4 4+------\ | |
D -|---|U3-B O----+---| \ 6 | |
| | / | 5| U1-B O-------|- 7 RTS ----------|- 8 CTS
| | / +---| / | |
| / +------/ | |
| | |
| \ | |
| | \ | |
| 5| \ 6 9+------\ | |
E -|---|U3-C O----+---| \ 8 | |
| | / | 10| U1-C O-------|- 4 DTR ------+---|- 6 DSR
| | / +---| / | | |
| / +------/ | | |
| | | |
| | | |
| / | | |
B -|---+ / | | | |
| | 3 / | 1 | | |
C -|-----------------O U2-A -----------|- 2 RX ------|---|- 3 TX
| \ | | | |
| \ | | | |
| \ | | |
| | | |
| | | |
| | | |
| / / | | |
| / | / | | | |
| 10 / |11 6 / | 4 | | |
L -|----O U3-E ------O U2-B -----------|- 6 DSR ---+ +---|- 1 DCD
| \ | \ | | | |
| \ | \ | | | |
| \ \ | | |
| | | |
| | | |
| / / | | |
| / | / | | | |
| 12 / |13 8 / | 10 | | |
K -|----O U3-F ------O U2-C -----------|- 8 CTS ---|------|- 7 RTS
| \ | \ | | | |
| \ | \ | | | |
| \ \ | | |
| | | |
| | | |
| / / | | |
| / | / | | | |
| 8 / | 9 11 / | 13 | | |
H -|----O U3-D ------O U2-D -----------|- 1 DCD ---+------|- 4 DTR
| \ | \ | | |
| \ | \ | | |
| \ \ | |
| | |
| | |
N -|-----------------------------------|- 5 SIG GND ----------|- 5
| | |
| +5V | |
2 -|----+------------+ +------|- PROTECTIVE GND --------|-
| | | | | |
| | | | | |
| --+-- 0.1uF | ------- | |
| --+-- 10V | --- | |
| | | - | *********************************
A -|----+ | | * *
| | | | * U-1 1488 RS-232 XMTR *
| ------- | 14 +----+ 7 | * *
| --- +----| U2 |--+ | * U-2 1489 RS-232 RCVR *
| - | +----+ \ | * *
| | \ | * U-3 7404 HEX INVERTER *
| | 14 +----+ 7\ | * *
| +----| U3 |--+ | * DIODES SIGNAL DIODES *
| |\ | +----+ | | * WILL WORK HERE *
| | \| | | * *
10-|----| |---+--------+ | | * NOTE: THE RS-232 VOLTAGE *
| | /| + | | ------- | * BE APPX +/- 10 VOLTS *
| |/ | --+-- | --- | * WHICH IS OK TO USE *
| 100uF --+-- 14 | - | * PER RS-232 STANDARD *
| 15V | +--|--+ | * *
| | | | 7 | * *
| ------- | U1 +----+ | *********************************
| --- | | | |
| - +--|--+ | |
| 1 | ------- |
| | --- |
| 120uF | - |
| 15V | /| | | *********************************
| +|| |/ | | | * *
11-|--||----+---| |----+----+ | * Commodore User Port to RS-232 *
| || | |\ | | | * Adaptor designed by Stephen *
| | | \| | | * Coan, Version 2, 03-NOV-83. *
| | | | * *
| -------- 100uF ---+--- | * This general design has also *
| \ / 15V ---+--- | * been used in other devices *
| \/ + | | * where a negative voltage was *
| -------- | | * not available for the RS-232 *
| | | | * *
| | | | * The user port is a 44 pin *
| +-------+----------+ | * edge connector and the PC COM *
| | | * port is a female DB 9 (as on *
| | | * on a joystick) *
| ------- | * *
--- | * *
- | * *
| * *
| *********************************
|
|
You'll want to follow the instructions for the NULL modem cable for the
sake of this project, so use the pin settings on the right hand side.
@(A)3: Part III: Setting up the LINUX box
You should know now that if you don't have root access to the LINUX
machine, you should give up now. Secondly, you need to have the machine
already configured with respect to its network hardware and the telnet
daemon. The popular slackware distribution sets all this up during its
installation process.
The first step will be to create the above shell "new_minicom" and its
accompanying configuration "cua0".
1. Log on as root, and enter the /usr/bin directory.
2. Run minicom by entering its name followed by the name of the port
you'll be using. For instance, enter:
"minicom -l -o cua0" for com port 1.
"minicom -l -o cua1" for com port 2.
3. Enter CTRL-A followed by 'z' to view a menu of options.
4. Enter CTRL-A,P for communication parameters. You'll want the
parameters to be: 2400 baud, 8 bits, no parity, 1 stop bit. Exit this
menu when done.
5. Enter CTRL-A,T for terminal parameters. ANSI, Backspace, and enabled
are fine settings.
6. Enter CTRL-A,O for configuration parameters. Select the third option-
communication port setup. Make sure the serial device reads "/dev/cua0"
for com port 1 or "/dev/cua1" for com port 2. Baud/parity/bits should
read as you set them above. Hardware and software flow control should
BOTH be turned OFF!
7. Exit back to the parameters menu and select "modem and dialing." The
reset and initialization strings should be blank. Auto baud detect,
hang-up drops DTR, and modem has DCD line should all read YES.
8. Exit back to the parameters menu again and hit the option "save
configuration as cua0" (or cua1 if you are using com 2).
9. Exit minicom altogether by entering CTRL-A,X.
10.We will make this our TEMPORARY new_minicom by entering from the
shell:
cp minicom new_minicom
If you want to test the RS232 cable, now would be a good time. Run
minicom with the following options:
new_minicom -l -o cua0 (or cua1 for com port 2)
The next step is to create the BBS "user."
1. Log on as root and run the program "adduser." Call your account "bbs"
and give it the name "bbs." After the user is created, you should have a
directory called "/home/bbs."
2. Now load the file "/etc/passwd" into emacs and find the line
containing the information about your BBS. The characters between the
first and second colons in the line are the encrypted password. Delete
these characters. Next change the default shell (the part following the
last colon) to point to the file /usr/bin/new_minicom -l -o cua0.
3. When complete, excepting the ID number (504), your line should look
identical to this one:
bbs::504:100:bbs:/home/bbs:/usr/bin/new_minicom -l -o cua0
If you are using com 2, change the shell command to read "cua1" instead
of cua0.
The next step is a little tricky. You'll need to make some changes to
minicom to make it much more secure against abuse by users. Without
changes, the user can enter all the commands you did above! It will be
necessary to have extensive knowledge of C and knowledge of compiling in
LINUX to perform these changes. ;)
Now that you're frightened, you'll be glad to know that the necessary
files are available at:
147.26.162.107
in the "lib" subdirectory.
The only files you'll really need are "new_minicom", which must be copied
to your /usr/bin directory, and the file "wb.rc" (discussed below), which
must be copied to /home/bbs. Also available is the file "newminicom.zip"
which contains all the modified source code.
The following changes, to the best of my memory, were made:
1. All CTRL-A commands have been disabled, with the exception of CTRL-
A,X.
2. Minicom will automatically exit on the reception of the sequence CTRL-
A,CTRL-B,CTRL-C,CTRL-D from the modem.
3. Spawning out has been disabled.
4. The status windows have been removed.
5. ANSI has been made permanent.
6. A "busy" message for already connected processes has been added.
7. A "cleaning up" message for the com port has been added in the event
of an abnormal exit.
After new_minicom is set up in the /usr/bin directory, you may think
you're done. Well, you almost are! You may need to make sure there are
no protections on the com port, on minicom, or on other necessary files.
Do this with the "chmod" command. You'll want to turn on read and write
for the com port as follows:
chmod +r /dev/cau0 (or cua1)
chmod +w /dev/cau0 (or cua1)
Read and execute abilities can be added to minicom similarly:
chmod +x /usr/bin/new_minicom
Now you're done, right? No, but the last step requires a bit of
explanation. Our telnet session is maintained because we have an actual
user logged on and running a program. Should this user disconnect
themselves from their telnet session without logging off, we are actually
left with an open session of new_minicom still running in LINUX. Normally
we wouldn't care, except that so long as new_minicom is running, the com
port is protected from use, such that the system will be eternally busy!
What we need to do then is to have a shell script, with root privileges,
that will keep an eye on copies of new_minicom running without a telnet
daemon connection. The following shell script will do that.
>From the /home/bbs directory, create the file "wb.rc" (I call it the
watch-boy) and enter the following lines:
set temp=1
while (temp=1)
do
pid=`ps -auxg | grep 'new_minicom' | grep -v 'grep' | grep 'bbs' \
| grep '?'| awk '{print $2}'`
tty=`ps -auxg | grep 'new_minicom' | grep -v 'grep' | grep 'bbs' \
| grep '?' | awk '{print $7}' | grep '?'`
if [ 'expr $tty : "?"' ]
then
kill -9 $pid
fi
sleep 60
done
[!NOTE!: The two lines with the backslash (\) are extensions of the
prior lines. For instance, the characters "| awk '{print $2}'`" should
immediately follow the end of the line that reads "...grep '?'". Do not
include the backslashes!]
What this actually does is to look for occurrences of "new_minicom" being
run by a user called "bbs" in which there is no terminal connection. It
then kills those processes and goes to sleep for awhile before checking
again.
This file can also be downloaded from 147.26.162.107 in the "lib"
subdirectory.
Last thing to do then is to activate the watchboy by adding the following
line to the file /etc/rc.d/rc.local /home/bbs/wb.rc &
You can start up the watch boy as root without rebooting the machine,
but the above will make sure it is started up whenever the LINUX box is
restarted.
Now on to the Commodore side.
@(A)4: Part IV: Setting up the Commodore BBS program
Thankfully, doing this is MUCH easier than setting up the LINUX box. The
requirements on the Commodore end are actually very few, since what we
end up doing is have the LINUX machine act as our modem and phone
connection. As far as the BBS program is concerned (with few exceptions),
it is acting completely as normal.
You'll first want to select the BBS program to work with. Make sure it
is one that is written in BASIC so that you can modify it easily. The
BBS should also support ASCII, and preferably ANSI as well. For the time
being, ANSI is the only way we'll get any color at all out of LINUX. The
BBS program should support 2400 baud through the modem port. If not,
you'll need to lower the set baud rate in minicom above.
Detecting a connection is accomplished by simply watching the Data
Carrier Detect line on the modem port. That will be bit 4 in location
56577. When the following BASIC condition becomes true, the BBS should
go online:
(peek(56577)and16)=16
The BBS program should go online by swinging its Data Terminal Ready
signal high. This can be done with the following:
poke56577,6:poke56579,6
The BBS program should hang up whenever it detects the Data Carrier
Detect line go low. That's done with something similar to the peek
above:
(peek(56577)and16)=0
Lastly, the program will hang-up by doing two things. The first thing is
to tell minicom to terminate. This is done by the following:
print#2,chr$(1);chr$(2);chr$(3);chr$(4);
Where print#2 is above you should substitute the proper modem channel for
the number 2.
The second is to drop the Data Terminal ready signal by entering:
poke56577,0:poke56579,32
If the BBS program does all these things, it will perform admirably.
@(A)5: Part V: What's to Come
There are two current problems with this configuration for a telnet
Commodore BBS. One is that Commodore graphics do not work. For a long
time this baffled me, and I looked all over the minicom source for the
solution. It wasn't there. Now I'm thinking it has something to do with
the telnet daemon itself, which is the next place to check. When it's
solved, I'll let you know.
The other problem concerns time lag. Normally, lag is unimportant, but
some transfer protocols are now especially sensitive to lag time. For
this reason, along with translation problems mentioned above and the
sensitivity of minicom to its termination codes, make the operation
of the stream transfer protocols on the telnet BBS impossible. Perhaps
some modified uuencoding packet based protocol could be written and
patched in to the BBS program. If any such solution presents itself,
it will be pursued.
@(A)6: Part VI: Credits
Very few of these are my original ideas. Special thanks to Matt Beall of
California (mathew@cinenet.net) for most of the modifications done to
minicom. The project itself is the brain child of Henry Knoepfle of
Arizona, who helped me through all the linux changes. Early in August,
as soon as I get my own BBS program properly configured, I'll be putting
it back up on the same machine that the ftp files are on. Telnet to it
and log on as user "bbs" with no password. Good luck!
=========================================================================
@(#)usenet: UseNuggets
COMP.SYS.CBM: The breeding ground of programmers and users alike. Let's
see what topics are showing up this month:
@(A): To C or Not To C, That Is The Question
Over the past few months, there has been some discussion of the C
programming language, a common language used in the development of many
UNIX, Windows, and Macintosh applications. We're not exactly sure what
sparked the discussion, but GNU C came up very early. For those who
don't know, the Free Software Foundation (FSF) is an organization that
sponsors the creation and maintenance of many fine applications and
utilities. One such group of applications are known as the GNU (GNU's
Not UNIX) applications. Many people use the GNU utilities because they
can be compiled and run on many different machines. One of the more
popular apps is GNU C, which can be run on many computer systems as well
as create object code for all the supported environments. The system is
highly customizable, which explains why there was talk of both porting
GNU C to the Commodore 64, and/or using a DOS or UNIX version of the
compiler to create object code that would run on the C64. The thread
has drug on for quite a while, but seems to be winding down. We're not
sure there was a general consensus, but many remarked that GNU C is
simply too large to run on a C64. In addition, the assumptions it makes
about the supported hardware architectures makes cross-compilation a near
impossibility. Still, many are searching for a way to bring ANSI C
to the Commodore system.
Success may come from CMD, as Doug Cotton mentioned that they were
looking into a 65C816 cross compiler with the hopes of porting a small
free C compiler to the 64 environment.
@(A): The SuperCPU this and the SuperCPU that....
Now that the SuperCPU has started shipping from CMD, the newsgroup has
been abuzz with questions and thoughts about the units. However, it
seems the group is always one step ahead of CMD. Now that the units have
started appearing on user's doorsteps, questions about the planned 128
unit and the SCPU RamCard have dominated the topics. The fact that the
64 unit actually contains 128 kB or RAM confused some folks, who wanted
to know why they were paying for this extra RAM, and how they could take
advantage of it now that they have it. Then, as fast as folks described
that the extra RAM was actually used to "shadow" the ROM so that the
KERNAL could run at full speed, the topic switched from present RAM to
planned RAM.
Questions ranging from how much RAM would be available on the RamCard, to
how fast the RAM could be accessed, to what style of modules could be
used have been debated. CMD, the developers of the RamCard, acknowledged
that the full address space of 16 megabytes would be available on the
unit and that they would try to provide speeds as fast as economically
possible. CMD has also stated that they will be utilizing the same 30 pin
SIMM technology that is used in the company's RamLink product. Some
Usenetters debated that 72 pin SIMMs were becoming more cost effective,
but CMD countered that only those that upgrade to the full capacity of
the unit would realize any cost savings.
The substantial increase in power the SuperCPU provides the programmer
brought many questions and comments on planned or potential new operating
systems for the unit. As of yet, none have surfaced, but only time will
tell. For its part, CMD has made GEOS compatibility a staple of the new
unit, so that OS will run correctly. At least one commercial venture,
PROTOVISION, is allegedly planning an all GUI OS for the unit. See
Newsfront (Section: news) for more information.
Brett Tabke, of PHD Software Systems, announced that he is busy upgrading
his Karma assembler for the 128 to run on the new unit and praised the
virtues of the new opcodes, modes, and options available when operating
the unit in "Native mode." This started some discussion on writing code
that only runs on the new processor. The sides were split almost
immediately, as all noted that while the new applications would run very
well on the SCPU, they would not run at all on a stock 64. Proponents
noted that new software demands the purchase of the SCPU, while purists
maintained that that would limit the software to a small market segment.
@(A): The "Virtual 1541"!
Now, before you start thinking of 3-dimensional plastic cases and track
0 head knocking in quadrophonic sound, let's explain the topic. Many
users have expressed a desire to virtualize the IBM PC as a glorified
1541 drive with full emulation. The closest thing as yet is the 64NET
package, which allows you to load and save programs to the IBM PC hard
drive like it was a regular CBM drive. The drawback to 64NET is its non-
standard access method. Before you can access the emulated CBM drive, you
have to load special software on the 64 and use a special user port
cable. So, for users who demand perfect emulation, no choices exist yet.
The lack of options haven't dented the dreams of many who outlined the
"technical specifications" of such a virtual disk drive.
=========================================================================
@(#)toolbox: Menu Toolbox III
by Jeff Jones (jeff@loadstar.com)
Copyright 1996: J and F Publishing
@(A): Introduction
This toolbox has the most versatile menu commands I've ever coded, and
will make your BASIC and ML programs scream with speedy scrolling menus
and file selectors with multi- item selectability. That's right. I said
scrolling! Because of its size, there are only two versions of MENU
TOOLBOX III:
Filename SYS Location Notes
MENUTOOLS 1000 4096 (Reference: code, SubRef: menucode1)
MENUTOOLS 8000 32768 (Reference: code, SubRef: menucode2)
These are the optimal locations for BASIC. It's 8K (33 blocks) in length,
but your programs will be much smaller, and have access to RAM under ROM
for array, screen and menu storage. You won't suffer for memory.
There are four types of menus:
o Custom Item Menus
o File Requestors
o Screen Menus
o Instant Pages (from BASIC only)
@(A): ML and Compiler Users
You usually can't use SYS 32768,1,2,3,4,5 from ML or compiled programs so
you'll have to POKE the parameters into a location and then tell the
toolbox where to get the parameters. You tell MENU TOOLBOX II where to find
the parameters by loading the .X and .Y registers with the low and high
bytes of the location and then SYSing. From BASIC, the .X register is
location 781 and the .Y register is 782. Here I'll use $033C (+828) as an
example. The high/low bytes for location 828 are 3 high and 60 low. The
following BASIC example of the lattice command works equally well as BASIC
or compiled.
poke828,x1
poke829,x2
poke830,y1
poke831,y2
poke832,t1
poke833,t2
poke834,c1
poke835,c2
poke781,60
poke782,3
sys32768+102
This may look slow, but in compiled programs, POKE commands are executed
at near ML speeds. If there is a chance that you're going to compile your
program, you may want to use the ML/compiler protocols from the start. It's
heck converting a program. I know (Directomeister).
ML programmers can embed parameters within their programs. It's actually
easier from ML than compiled:
background ldx <b'lattice
ldy >b'lattice
jsr 32768+102
rts
b'lattice .byt 0,39,0,24,9,10,15,12
@(A): Instant Pages
SYS 32768+198,PAGENAME$, items,list$..., hotkeys$
Since it's by far the easiest to use, we'll discuss instant pages
first. A page is a computer screen with a user interface setup. Instant
page allows you to create with one SYS a screen with a tiled background, a
title bar, and a centered working menu complete with hotkeys. Consider the
following code:
10 T$="M Y D A T A B A S E"
20 A$(1)="OPEN DATABASE (O)"
30 A$(2)="DEFINE FIELDS (D)"
40 A$(3)="ADD RECORD (A)"
50 A$(4)="SEARCH RECORDS (S)
60 A$(5)="PRINT RECORDS (P)"
70 A$(6)="RETURN TO LOADSTAR (Q)"
80 A$(7)="odaspq"
90 sys32768+198,T$,6,A$(1),A$(2),A$(3),A$(4),A$(5),A$(6),a$(7)
100 onf%gosub200,300,400,500,600,700
110 goto 10
Make sure the number of items in your list$ matches the number declared
with ITEMS. If you RUN this program, a typical LOADSTAR type program will
pop up on the screen:
M Y D A T A B A S E
OPEN DATABASE (O)
DEFINE FIELDS (D)
ADD RECORD (A)
SEARCH RECORDS (S)
PRINT RECORDS (P)
RETURN TO LOADSTAR (Q)
CRSR/RETURN TO SELECT
You'll have a CRSR/RETURN menu with hotkeys for each menu item, and more
hotkeys if you simply include them. The menu is automatically centered left
to right and top to bottom. CRSRing to ADD RECORD or pressing [A] will exit
the menu and the variable, F%, will be 3. This is how you know which item
or hotkey was selected by the user. There can be up to 40 hotkeys defined
so that your page goes beyond the items presented on the menu. If hotkey
#20 is pressed, the menu is exited, and F%'s value is 20. It's not
mandatory for your menu to have alternative hotkeys, but if you do, list
the menu's hotkeys first, and in the same order that they appear in the menu
so that F% is always the same as the menu choices and the hotkeys.
Lines 10-80 set up the data for the menu into variables since you can see
that there's no way all this text could fit on one line. Just imagine it
with 20 hotkeys.
Line 90 calls the routine. Program flow is transferred to MENU TOOLBOX II
until a menu item or hotkey is pressed.
Line 100 is one way of dispatching flow of the program based on the user
input.
Ironically, this feature will only work from BASIC. I wrote the INSTANT
PAGE feature as a simple driver to test MENU TOOLBOX II's ability to take
commands from ML. I liked the routine I ended up with and decided it should
be added to the package. Adding links for ML for this routine could be done
-- but since I wrote the routine with many parameters intending for it to
be called from BASIC, it becomes more difficult, even convoluted, to write
ML links for a program which is essentially a series of ML links. Plus
there's no time left this month.
@(A): Instant Page Setup: SYS 32768+201, tilea, tileb, colora, colorb,
title color, highlight color, menu color,
message color, frame color, frame on,
background, border
You can use my bland default colors or you can use your own. This command
simply changes the presets.
Your background is made up of a mesh of two characters, A & B, in two
colors. TILE A is one of the characters in the tiled background (0-255)
TILE B is the other tile in the background
COLOR A is the color of TILE A, 0-15 where COLOR A has the following
effect:
COLOR A VALUE COLOR
0 BLACK
1 WHITE
2 RED
3 CYAN
4 PURPLE
5 GREEN
6 BLUE
7 YELLOW
8 ORANGE
9 BROWN
10 LIGHT RED
11 DARK GRAY
12 MED GRAY
13 LIGHT GREEN
14 LIGHT BLUE
15 LIGHT GRAY
This chart applies to all subsequent color values mentioned in the
documentation.
COLOR B is the color of TILE B
TITLE COLOR is the color of the title of the page.
HIGHLIGHT COLOR is the color of the highlight bar of the menu
MENU COLOR is the color of the menu
MESSAGE COLOR is the color of the message at the bottom of the screen,
"CRSR/RETURN To Select."
FRAME COLOR is the color of the frames surrounding the title and menu.
FRAME ON turns the frame around the menu on with a nonzero value. You
might need to turn off the frame to squeeze in extra menu items. Maybe you
don't like frames, either.
BACKGROUND is the background color
BORDER is the border color
@(A): Change Message: SYS 32768+204,New Message$
In case your page needs a custom message at the bottom of the screen,
change it here. Keep it less than 38 characters.
@(A): Screen To Menu: SYS 32768+63,y,x1,x2,n,t,h,"keys"
Screen To Menu is an easy way to create a CRSR/RETURN menu from a vertical
list of options that you've previously printed on the screen. So any list
on your screen can be made to "spring to life" as a CRSR/RETURN menu. There
may be up to 24 items, as wide as the entire screen. It's up to you to
write the subroutines that correspond to each menu item.
After an item is selected, the variable, F%, tells you which item was
selected. It will hold a value between 1 and the number of items in the
menu. Here it is in use:
150 sysaddr,y,x1,x2,n,t,h,"hotkeys"
160 on f% goto200,300,400,500,600...
"f%" is the nth item selected.
Y is the starting row on the screen.
X1 is the left extreme of the highlight bar.
X2 is the right extreme of the highlight bar.
N is the number of items in the menu.
T is the text color of the unhighlighted items in the menu.
H is the highlight bar color.
NOTE: If you don't want the highlight bar to reverse items, add 128 to
the color codes (0-15) of parameters T and H.
The MENU command has been extended per imperial order of Maurice Jones.
Maurice likes to press one key instead of using CRSR/RETURN menus, which
force you to press more than one key. The new "keys" field allows you to
define hotkeys for each menu item, and also for flow control beyond the
CRSR/RETURN menu.
For instance, you have five items on your menu, but "keys" is defined as
"12345qlprt". 1-5 happen to be hotkeys for the menu in this example. You
can use mnemonic keys if you like. If the user CRSRs to item 4 and presses
RETURN, F% will become 4. If they press 4, f% becomes 4. But as a bonus, if
the user presses "l", which is seventh in the KEYS string, F% becomes 7. If
they press "r", F% becomes 9, and so on. MENU now has the power of
BRANCHER. You can have up to 40 hotkeys in the string.
What would you use these hotkeys for? Well you might have a CRSR/RETURN
menu, but also "q" to quit and SPACE to go to another menu. The only new
requirement is that you now have to define hotkeys for each of your menus.
It's a good idea to let your users know about the hotkeys.
To use screen menus from ML:
ldx <parameters
ldy >parameters
jsr 32768+162
User input is returned in 253
Parameters is a stream of legal parameter bytes followed by the length of
the hotkey string, followed by the hotkey string.
@(A): Introduction to Scrolling Menus
These menus are more involved to implement, but well worth the setup time.
The multi-file selector in DISKMEISTER is an example of a quirky BASIC/ML
slow POKE (pardon the pun). You need self-contained ML to handle your
menus, especially scrolling ones. MENU TOOLBOX will create its own pointers
for the menu items you define. Normally these pointers will be right at the
end of the ML. Each item in your menu will take up 4 bytes. The pointers
can extend under ROM and IO with no problem. If you don't want the pointers
to be at their default location, you can change the array location with the
following SYS.
@(A): Change Location: SYS 32768+27,location
>From ML
ldx <location
ldy >location
jsr 32768+126
Since the default pointers will begin around $a000, you will want to
change the location if you have data such as a screen stored there.
Typically you'll want the pointers somewhere where they won't cost you
anything, which is usually under some ROM.
You'll also want to use this command if you want to switch between
pointers for different menus.
@(A): Declaring Menu Items
Before MENU TOOLBOX can create a menu for you, you must either BLOAD a
directory, an EDSTAR PRG text file with a list of menu items in it, or
declare items from DATA statements. I've included tools to make this
process easy. Since directories are so structured, they don't need pointers
so all you have to do is tell MENU TOOLBOX where to BLOAD the directory:
@(A): Bload Directory: SYS 32768+39,"$:*",device,location
Before you can show a file requestor, you must first have a directory in
memory. You can BLOAD a directory anywhere in RAM, even under IO at
$D000-$DFFF. There is NO NEED to use the CHANGE LOCATION command after
BLOADing a directory. F% holds the number of files, but keep in mind that
counting starts from 0, not 1.
>From ML:
ldx <filename
ldy >filename
lda namelength
jsr 32768+138
the directory filename, usually "$:*" must be followed immediately in
memory by the device number byte and then the low/high bytes of the load
address.
@(A): File Requestor: SYS 32768+45,x,y1,y2,r,c,h,s,m
This command will pop up a scrolling (if necessary) menu on your screen.
Your users will be able to CRSR up and down or page with the + and - keys.
You should print this somewhere on the screen so that your users will know.
Lotta parameters? Here's what they mean:
X is the upper left hand corner of the requestor box. Since directories
are always going to be about 32 columns across, you would never have a
number more than 6 here.
Y1 is the top row of the menu, 0- 20.
Y2 is the bottom row in the menu. Y2 determines how much of your screen
will be taken up by the file requestor.
R stands for REVERSE mode. If you want all the items in the menu to be
printed in reverse, put a 1 here. Highlighted items will appear unreversed.
C is the color of the menu and all unhighlighted menu items.
H is the color of the highlighted (current) item.
S is the color of selected files (if the menu is in multi-file select
mode.
M is for MULTI MODE. It allows the user to select more than one file. Make
this a 0 for a normal single file and 1 for multi-file selection ability.
Files are selected with SPACE or RETURN. To exit the requestor you must
press F1. Your program should inform the user of this if they are in the
multi file mode.
When in single mode the file name is returned in W$, the position in the
directory is in I% and the block size of the selected file is in B%.
>From ML:
ldx <location
ldy >location
jsr 32768+144
Have parameters as a stream of bytes in the order and extremes presented
above. When in single mode, .X and .Y point to the filename and .A holds
the file length. Compiler users, .A is location 780, .X is 781 and .Y is
782.
You can find F% at 253, I% at $14 and b% at $22
@(A): Index Items: SYS32768+33,item
This command works best with bloaded directories, but can be used on
normal scrolling menu data. It returns the filename or menu item string of
ITEM into w$. When f% <> 0, it means the item or file has been selected. So
when you have a multi file menu, do a loop to check each file. If f% <> 0,
act on that file.
[Big note:] if you're hurting for string array space or suffering from
garbage collection blues, why not store/load lists into menu item slots in
high memory? You can use INDEX to check your hidden pseudo arrays, and
DEFINE MENU ITEM (below) to store/flag items. Such arrays won't be dynamic,
but they can come in handy.
>From ML:
ldx <item
ldy >item
jsr 32768+132
.X and .Y point to the returned string and .A holds the string length. F%
is in locations 253 and 254 always.
@(A): Menus from BASIC Strings
Menu items can also exist in BASIC, but preferably in DATA lines and not
in dynamic strings since some dynamic strings can change location after a
garbage collection.
MENU TOOLBOX has to know a few things about your menu items before it can
make a menu out of them. It has to know each item's place in the menu. Is
it item number one or three hundred? If you have many items, you can tell
MENU TOOLBOX all about your menu in a FOR loop with the following command.
This isn't difficult to do. All you have to do is:
@(A): Define Menu Item: SYS32768+30,item$,index,selected
Here you're telling the system the place of a certain string in your menu.
If you're doing this from an array, you can use a FOR loop.
ITEM$ will always be a string variable, probably from an array or from
DATA read into a string. If your menu items are in DATA statements, you
don't need to DIMension an array to hold the strings. You can READ the data
into a throwaway variable like a$ and then
sys32768+42,a$,index,selected
in a FOR loop. If you will want to print the menu item somewhere outside
of the menu, you will probably want and need an array. In any case, string
DATA in arrays doesn't take up any memory except for pointers.
INDEX is just the item's place in the menu.
SELECTED is whether or not the item should be considered selected when the
menu pops up. You can use this even when not in multi-select mode to show
that some items are not available or to highlight items to show that some
pending action is needed.
>From ML:
ldx <parameters
ldy >parameters
lda string'length
jsr 32768+129
parameters .asc "item name"
.word index
.byt selected
@(A): Menu COmmand: SYSaddr+42,x1,x2,y1,y2,r,c,h,s,o,l,m
This command will pop up a scrolling (if necessary) menu on your screen.
Your users will be able to CRSR up and down or page with the + and - keys.
You should print this somewhere on the screen so that your users will know.
Here's what the parameters mean:
X1 is the upper left hand corner of the requestor box.
X2 is the right extreme of the menu. Any menu item that exceeds the width
defined by X1 and X2 will be truncated.
Y1 is the top row of the menu, 0- 20.
Y2 is the bottom row in the menu. Y2 determines how much of your screen
will be taken up by the menu.
R stands for REVERSE mode. If you want all the items in the menu to be
printed in reverse, put a 1 here. Highlighted items will appear unreversed.
C is the color of the menu and all unhighlighted menu items.
H is the color of the highlighted (current) item.
S is the color of selected menu items.
O is the offset, in case you've sectioned off your menu items, generally
zero. If you want to pop into the menu at a particular point (say at the
last item selected which you've preserved), use offset to do so. The rest
of the menu is still accessible.
L is the limit or the highest menu item allowed. Note that this will
usually be one less than f% when you use the Rack Em Up command.
M is for MULTI MODE, which allows the user to be able to select more than
one item. Outside of a file requestor, there are few uses for this. Make
this a 0 for a normal single item and 1 for multi-item selection ability.
Items are selected with RETURN or SPACE. To exit a multi-select menu you
must press F1. Your program should inform the user of this if they are in
the multi item mode.
When RETURN is pressed in single mode, the item number is returned in F%.
>From ML:
ldx <parameters
ldy >parameters
jsr 32768+141
parameters .byt x1,x2,y1,y2,,r,c,h,s
.word o,l
.byt m
@(A): Set Mode: SYS32768+48,n
Sometimes you may have a regular menu and a directory set up in memory.
You may want to set the proper mode for FIND AND CLEAR with this command
before using it. N is 0 for normal retrieval and 1 for file requestor
retrieval.
@(A): BLOADT Text File: SYS32768+15,file$,device,location
This command will BLOAD a standard EDSTAR text file into memory and place
a zero at the end of the file to mark the end. It can also be used as a
regular BLOAD.
FILE$ is the filename of the file you want to BLOAD.
DEVICE is any legal device number.
LOCATION is anywhere in RAM except the IO area $D000-$DFFF. Again, you
really should take advantage of areas outside of BASIC and beneath ROM.
You can indeed use packed text if you BLOAD it with DTEXT, published on
LOADSTAR #122 and the COMPLEAT PROGRAMMER.
>From ML:
ldx <parameters
ldy >parameters
lda filename'length
jsr 32768+114
parameters .asc "filename"
.byt device
.word location
@(A): Rack 'em Up: SYS32768+36,location
This command simply itemizes every line in a text file that you've BLOADed
so that it can be used as a menu. Pointers for each line in the text file
will be located starting from the end of the file. So don't BLOAD a file
that ends too close to $FFFF or the beginning of important data.
F% tells you the number of lines it has itemized. Save this into another
variable because you will need the value to set a limit (bottom) to any
menu made with the BLOADed data.
The longest length of a line is stored in $14 (decimal 20). If you want
your resulting menu properly centered, check out this location immediately
after the call as this location is heavily trafficked by Menu Toolbox and
BASIC.
>From ML:
ldx <location
ldy >location
jsr 32768+135
@(A): Text File Reader
You would simply BLOAD a text file using the aformentioned command, and
then RACK IT UP. Next just define a regular menu wide enough to accommodate
the text anywhere on the screen. Don't forget to prompt your users to press
RETURN to exit the reader (which is really a big menu).
@(A): Report Location: SYS32768+54
If you don't want to rack up a text file again, you can find out and store
exactly where the menu pointers begin with this command. The location will
be reported in F%. Remember that F% is an integer variable, and has a max
of 32767. So if F% is negative, subtract it from 32768:
SYSAD+69:ad=f%:iff%<0thenad=32768- f %
>From ML:
jsr 32768+153
Location returned in .X and .Y
@(A): Get Word: SYS32768+51,color,cursor,limit,text$
Your program will probably need input from the user. Here you have the
best input routine I've ever done. It allows you to cursor through
already-typed text, and it allows you to predefine the text from a variable
or static string, allowing the user to just hit RETURN if they don't want
to change the text as it appears at the blinking cursor. The results of
editing (or non-editing) is returned in W$.
COLOR is the color of text that is typed by the user.
CURSOR is the color of the flashing cursor.
LIMIT is the maximum length of the input.
TEXT$ will usually be null. If not, the contents of the variable will be
printed at the current location of the cursor, respecting the COLOR
parameter. The length of TEXT$ overrides LIMIT only if it's longer than
LIMIT.
>From ML:
ldx <parameters
ldy >parameters
jsr 32768+150
rts
parameters .byt color,cursor,limit
.byt length of default string
.asc "default string"
Returns location of edited string in .X and .Y. .A holds the length of
the string.
@(A): Start Memory Print: SYS32768+60,location,string$
@(A): Continue Memory Print: SYS32768+63,string$
Use START MEMORY print to start a list of text in memory. This command
allows you to print to memory in case you want to build a menu from
softw
are instead of a table or file. You can print a list in memory, RACK
it up, and make a scrolling menu out of it. Works beneath ROMs, too. A
carriage return is appended to the string in memory.
Once you've started memory printing, just keep sending strings with
continue memory print. The updated address of the end of your menu is kept
in locations 251 and 252. USE NO OTHER COMMANDS while building your list
with memory print! You might corrupt 251 and 252.
The final item in your menu should end with a character string 0 so that
RACK IT UP knows where the end of your list is.
sys32768+63,final$+chr$(0).
START From ML:
lda <string'loc
sta $22
lda >string'loc
sta $23
lda string'length
ldx <start
ldy >start
jsr 32768+156
CONTINUE From ML:
lda <string'loc
sta $22
lda >string'loc
sta $23
lda string'length
jsr 32768+159
@(A): Scroll Up: SYS32768+18,x1,x2,y1,y1
This scrolls a section of the screen defined by the extremes above. Scroll
need not be used with menus. That's done automatically, but since the code
exists for the MENU command, I thought I'd give you direct access to it if
you want. The cursor is placed right where new screen text would appear
according to the parameters of the scroll.
>From ML:
ldx <parameters
ldy >parameters
jsr 32768+117
rts
parameters .byt x1,x2,y1,y2
@(A): Scroll Down: SYS32768+21,x1,x2,y1,y1
This scrolls a section of the screen defined by the extremes above.
>From ML:
ldx <parameters
ldy >parameters
jsr 32768+120
rts
parameters .byt x1,x2,y1,y2
@(A): Clear Row: SYS32768+24,code,color
In case you have to blank a duplicated line in the scroll area, this
command will do it using the screen code and color you specify. Cursor
position isn't changed.
>From ML:
ldx code
ldy color
jsr 32768+123
@(A): Titles
In order to make use of the internal tiles, you MUST use a custom font in
your program. The use of fonts in programs is beyond the scope of this
article. FOr information on fonts, please see LOADSTAR's Compleat
Programmer or Font Finale on LOADSTAR #92.
Here is the command structure of the tile functions. Since I made three
versions of the program, I'll refer to only the $C000 version. Replace
32768 with the other addresses if you will be using other versions.
@(A): Lattice: SYS 32768,x1,x2,y1,y2,t1,t2,c1,c2
This command will create a colorful pattern on the screen. If T1 and T2
were 1 and 2, the grid would consist of As and Bs in the following fashion:
abababababababa
bababababababab
ababababbababab
These lattices can be any dimension, as thin as a column or row and as
large as the entire screen. They can be very colorful and eye-catching as
you will see in DIRECTOMEISTER on our pass-around issue, available from our
web page at http://www.loadstar.com/
X1 is the leftmost column of the lattice, 0-39.
X2 is the rightmost column of the screen, 0-39 > X1.
Y1 is the top row of the lattice, 0-24.
Y2 is the bottom of the lattice, 0-24 > Y1. Note that if Y2 is greater
than 24, the lattice can overwrite your BASIC program at $0801 (+2049).
T1 is the screen code of the tile in your lattice, 0-255. You can find the
screen code of any character by printing it at HOME and then issuing the
command:
print peek(1024)
T2 is the screen code of the other tile in your lattice. It can be the
same as T1 if you like. You can still get a lattice effect by using the
same tile with a lattice of color only.
C1 is the color of T1, 0-15.
C2 is the color value of T2 in your lattice. As with tile selection, C1
and C2 can have identical values with T1 and T2 having different values,
creating a lattice of tiles and not color. If T1, T2, C1 and C2 are all the
same, then what you have is a block. There's a simpler way to get a block.
>From ML:
ldx <params
ldy >params
jsr 32768+102
rts
params .byt x1,x2,y1,y1,t1,t2,c1,c2
@(A): Block: SYS 32768+3,x1,x2,y1,y2,code,color
This routine will draw a block of characters on the screen. It will also
paint an area of the screen without changing the characters if you use a
CODE of 255. It can erase portions of the screen if you use spaces, and it
can draw single lines or rows of characters if you like. It is a mainstay
of my programming. Can't do without it.
X1 is the leftmost column of the block, 0-39.
X2 is the rightmost column of the screen, 0-39 > X1.
Y1 is the top row of the block, 0-24.
Y2 is the bottom of the block, 0-24 > Y1. Note that if Y2 is greater than
24, the block can overwrite your BASIC program at $0801 (+2049).
CODE is the screen code of the tile in your block, 0-254. You can find the
screen code of any character by printing it at HOME and then issuing the
command:
print peek(1024)
When a CODE of 255 is issued, the BLOCK program will not alter the screen
at all, only the color. This allows you to change (PAINT) colors of
portions of the screen without having to re-print them. If you must use
character #255 on the screen, use LATTICE with both screen codes set to
255. With both codes and both colors set the same, LATTICE becomes BLOCK.
COLOR is the color of CODE, 0-15.
>From ML:
ldx <params
ldy >params
jsr 32768+105
rts
params .byt x1,x2,y1,y2,code,color
@(A): Outline Box: SYS 32768+6,x1,x2,y1,y2,color
This routine will pop up a box on the screen using the CMDR-A,S,Z,X,
SHIFT-ASTERISK and SHIFT-MINUS characters. The area inside the box will not
be affected.
X1 is the leftmost column of the box, 0-39.
X2 is the rightmost column of the screen, 0-39 > X1.
Y1 is the top row of the box, 0-24.
Y2 is the bottom of the box, 0-24 > Y1. Note that if Y2 is greater than
24, the box can overwrite your BASIC program at $0801 (+2049).
COLOR is the color of the box, 0-15.
>From ML:
ldx <params
ldy >params
jsr 32768+108
rts
params .byt x1,x2,y1,y2,color
@(A): Copy Tile: SYS32768+9,FONT LOCATION,TILE,CHAR
This is a magic command. Within the ML are 60 tiles, lifted from TILE
STYLIST. This command will copy any of those tiles to any character in your
font. All you have to do is tell the command where your font is.
FONT LOCATION is the location of your font in memory.
TILE is the built in tile 0-9, that you want to have copied into your
font.
CHAR is the screen code of the character you want replaced with the tile.
>From ML:
ldx <parms
ldy >parms
jsr 32768+111
rts
parms .word font'location
.byt tile,char
@(A): More Than Sixty Tiles?: SYS32768+12
If you use this command, you must be a tile fanatic. You can use values
greater than 99 for TILE if you BLOAD a tile font into the proper location.
This will only work with the $9000 and $0800 versions of TILE TOOLBOX. It
can work with the $C000 version, but under normal circumstances, you can't
BLOAD to the $D000 area, which is where the VIC chip and I/O are.
To get the proper BLOAD location, SYS32768+12. The address will be
returned in the .X and .Y registers. For BASIC users, the address will be
returned in locations 781 and 782.
ML users would simply insert the JSR before a LOAD:
jsr 32768+12
jsr LOAD
BASIC users would BLOAD their font into place this way:
20 sys57812"tiles",8,0:poke780,0: sys32768+12:sys65493
This would give you a total of 266 tiles in memory if your tile font is 9
blocks long, but you will only be able to access the first 256, including
the ten already in the ML.
@(A): Animation
You can use the COPY TILE command for animation by copying a series of
tiles into the same CHAR. This will be much faster than drawing new
characters or re-drawing an entire lattice or block. Of course if you're
changing just one character, you can poke one byte on the screen, but the
advantage of copying is that you have information [outside] of your font so
your font isn't crowded and barely usable for text.
@(A): Shade: SYS 32768+96,x1,x2,y1,y2
SHADE paints with intelligence. I have always used BLOCK to shade an area
with a uniform color just beneath and to the left of a box I'm about to
draw. This gives a nice 3-D effect. SHADE does one better. If there are
multiple colors in the area, each color is assigned a darker shade. So your
overlapping windows will have a consistent shading effect.
SHADE can have a flash-type cycling effect when used repeatedly on the
same section of a screen. Eventually it will only cycle between blacks and
all the shades of white.
>From ML:
ldx <parms
ldy >parms
jsr 32768+192
rts
parms .byt x1,x2,y1,y2
@(A): Screen Stash: SYS 32768+66,page
@(A): Screen Restore: SYS 32768+69,page
@(A): Screen Merge: SYS 32768+87,page
Without screen swapping, pop-up help screens and menus would be
cumbersome. These two routines will store a screen at any page (256 byte
section) in memory. To store the current screen at $d000 (53248), you
would:
SYS 32768+66,53248/256
To get the screen back:
SYS 32768+99,53248/256
$D000 is at page 208. Note that each screen takes up 8 pages, and should
be kept 8 pages apart.
Note that screen stash stores the current border and background colors, as
well as cursor position per imperial order of Maurice Jones. Screen restore
will bring back the border and background colors of the stored screen.
SCREEN MERGE will restore a screen "under" an existing screen, meaning
that every place where there's a SPACE can be written to by the screen
being merged. Background and border colors aren't changed by MERGE.
In case you're confused about what screen merge does, MERGE would be a
simple screen restore on a blank screen. On a screen with something,
anything that's not a SPACE or SHIFT SPACE, MERGE allows restored screen to
bleed through without wiping out the current screen.
You can use MERGE in games like Concentration, where you only want to
reveal part of the screen at a time.
STASH From ML:
lda page
jsr32768+165
RESTORE From ML:
lda page
jsr32768+168
MERGE From ML:
lda page
jsr32768+183
@(A): Link: SYS 32768+72
Though all TOOLBOX routines that affect the screen use LINX and keep line
links clear, you can call LINX directly with a SYS 32768+72. Same from ML.
@(A): Print At: SYS32768+75,x,y,string$
This will print text anywhere on the screen. X and Y are your screen
parameters. STRING can be a literal or a string variable.
>From ML:
lda <string'loc
sta $22
lda >string'loc
sta $23
ldx row
ldy column
jsr 32768+171
>From ML the string must terminate in a zero.
@(A): Center: SYS 32768+78,row,string$
Centers a string (fewer than 41 bytes) on a specified line.
>From ML:
lda <string'loc
sta $22
lda >string'loc
sta $23
ldx row
jsr 32768+174
String must terminate in zero.
@(A): UPcase: SYS 32768+81,variable$
Converts all characters in a string to upper case. "We, The People"
becomes "WE, THE PEOPLE"
Note UPCASE will not print the string for you.
>From ML:
lda <string'loc
sta $22
lda >string'loc
sta $23
jsr 32768+177
String must terminate in zero.
@(A): LCase: SYS 32768+84,variable$
Converts all characters in a string to lowercase. "We, The People" becomes
"we, the people". Great for use before a test of input like Y and y or N
and n to consistently lowercase input.
>From ML:
lda <string'loc
sta $22
lda >string'loc
sta $23
jsr 32768+180
String must terminate in zero.
@(A): CHARACTER SWAP: SYS32768+90,a,b,c
CHAR SWAP will search the screen for parameter A and change it to
parameter B with the color, C. Here A and B are screen codes as revealed in
LOADSTAR LETTER #34 or page 376 of your Programmer's Reference Guide. But
the quickest way to find out a screen code is to print the character in the
HOME position and then:
print peek(1024)
or if your screen is moved:
print peek(peek(648)*256)
In a flash, you can change every instance of a character to another
character, or you can leave the character the same and just change its
color. This is good for font animation where absolute speed isn't a factor.
Note: if you want to change characters, but not their colors, send a color
code of 128.
>From ML:
ldx <parms
ldy >parms
jsr 32768+186
parms .byt a,b,c
@(A): COLOR SWAP:SYS32768+93,c1,c2
This changes every instance of a target color on the screen to another
color.
>From ML:
ldx <parms
ldy >parms
jsr 32768+189
parms .byt a,b,c
@(A): BRANCHER:SYS32768+99,"string"
BRANCHER adds very quick flow control to BASIC programs. Send this routine
a string and it will wait until a key, included in that string, is pressed.
The string can be up to 207 bytes long. Imagine the BASIC code necessary to
check 207 hot keys! This call will handle it in one command -- and much,
MUCH faster.
When a valid key is pressed, BRANCHER will inform you which key was
pressed by passing its instring position to the F% variable
1000 SYS 32768+99,"mdvc":on f% goto100,200,300,400
Here's the BASIC equivalent:
1000 geta$:if a$<>"m"anda$<>"d" anda$<>"v"anda$ <>"c"then1000
1010 ifa$="m"then100
1020 ifa$="d"then200
1030 ifa$="v"then300
1040 ifa$="c"then400
Not only is this code more bulky, but imagine how clunky it would be if
you had 25 active keys.
>From ML:
ldx <string'loc
ldy >string'loc
stx $22
sty $23
jsr 32768+195
String must terminate in a zero.
@(A): License Agreement
As with all LOADSTAR tools, we encourage you to use them in your
programming endeavors. You can do so without a licensing fee as long as you
mention somewhere briefly in the docs that you got the routines from
LOADSTAR. If you'd prefer not to mention us, write for permission.
LOADSTAR's tools may be used in commercial products, and programs published
in other magazines under the same provisions.
========================================================================
@(#)fido: FIDO's Nuggets
by Geoff Sullivan (sunfish@gis.net)
Summer slows things down everywhere, except perhaps in Zone 3, and the
Commodore FIDO Echos are no different. I like to think we Commodore users
have other interests beside our computers, and that we pursue them at this
time of year. Message flow was slow, and at times sporadic. There was some
discussion of a hitch in the system, and even now, I've been over a week
without one new message arriving at my node. There is also concern that
the Internet has absorbed some of the Echo traffic too. More of us have
access to it, and there is no doubt that it's faster.
@(A): Warning: Killer App. Movie at 11.
The C128 killer application with a life of it's own, QWKRR, by Rod Gasson,
is in version 5.0b at this writing. There are known bugs in it and Rod has
posted the symptoms and cautions frequently on the Echos. Users are able to
respond and help Rod work out the bugs from his Australian lab, while most
of us in the Northern Hemisphere are enjoying a warm summer!
@(A): The Canon Is of Little Use, Sir.
Traffic has been light in the Geos Echo, but a major topic has been the use
of Canon InkJet printers with Geos. Manufacturers are now catering more and
more to Microsoft's Plug-n-Play concept, while we plug-n-pray. Only the
older InkJet printers, such as the BJ-200 and 600 series, have actual DIP
switches for manual configuration. Until software is available for us to
configure the newer printers, their use will be limited.
@(A): Catch What WAVE?
Discussion of Maurice Randall's Wave for Geos 128 has been centered around
speculation as to what it will end up being. Will it be a SLIP/PPP
connection to the Web, or a high speed terminal program? Only Maurice knows
for sure, and lately he's been busy tweaking software for CMD's Super CPU,
the C64 version of which has begun shipping.
@(A): Speed Thrills....
Speaking of the Super CPU, the few users that have them by now are raving.
I expect the message base to have more information as more SCPU's are put
into service. We have all read the hype before, but actual user experiences
posted on the Echos are confirming the awesome speed of this accelerator
cartridge.
@(A): Ingenious Commodore Usage
Finally, an often asked question is, "What do you DO with a Commodore
computer?". There is much to do, and recently a thread addressing that
subject was begun. John Davis' story of how he and his VIC-20 increased his
Union participation by using a mail-merge program to personalize meeting
announcements brought a smile. He also has used his SX-64 to do sing-alongs
for kids at a local campground. SID is his only instrument!
So, that's a glimpse into the world of FIDO, the wonder dog of networks,
for this time.
Here, boy....
=========================================================================
@(#)review: The Hacking Review
by Tom Warnes
@(A): The Compleat Crossword, published by J and F Publishing.
This is a collection of crossword games which are made a little simpler
because the computer is watching to make sure you don't cheat. To start,
simply load the disk just like any LOADSTAR offering: LOAD"!",8,1
(substitute 8 with whatever device you are accessing). You'll find
most of the actions and key mappings identical to those found on the
LOADSTAR menu program.
The start up screen gives you the option of finding out about the
people are who created the puzzles in "All About This Disk". The other
choices are "Change Title", "Change Music" and "Exit to Basic". The
Change Title only allows you to change the background screen. The
Change Music becomes a heaven sent option after you've been playing this
game for a few hours, or even minutes. You may find yourself really
hating the background music; therefore, I'll give a few tips on turning
the music off completely. The music doesn't come on until you've loaded a
puzzle into your computer off of the disk. To turn the music off
completely hold down the CNTR key while pressing the S key or press the
CLR/HOME key. The CLR/HOME key acts as a toggle as does the CNTR-S
combination.
There were a few minor bugs on the disk that I found annoying. In the
option "All About This Disk" only a summary of the creators of the puzzles
is given. They don't attempt to explain the different functions or how to
access them. My suggestion would be to add an extra subgroup called
something like "Credit to the Creators" to put their names in, and in the
"All About This Disk" put a more complete description of the choices
available to the user. The "Change Title" had me stumped for a short while
until I discovered it only changes the texture of the background screen,
not the color to help someone who has been staring at the screen trying to
solve these puzzles.
The puzzles themselves are interesting even if sometimes they don't stick
to the theme of the puzzle. There is a small hiccup in the music presenter,
as it had a small problem playing the last song on the list available to
the user. It acted like a cassette player playing a cassette that has the
tape wound to tight on the spools.
Except for these minor problems it was interesting having the computer
keeping me honest. One big thing that has bothered me for years is the
fact no one has found a way to reward the player for successfully
completing a game on the computer. I've seen a simple message flashed on
the screen or even a colorful display. This is not for everyone. A
possible reward would be to have a timed series of puzzles so the player
could compete against time. A feature I liked was the fact that you could
mark a puzzle as having been completed, or if you're like me, one that
you've worked on and still have to complete. You are given this option
each time you go from a puzzle to the start-up screen. Most of these
puzzles seem to have come from the mind of Barbara Schulak, a name you
will recognize from the Loadstar 128 collection.
@(A): The Compleat Lee O., distributed by J and F Publishing.
Speaking of the Loadstar 128 collection the next group of programs
came from those disks. It is called the complete Lee O. This is a
collection of programs submitted to Loadstar to be put out on their 128
Loadstar disks. The programmer, Leo O. Clinton, tried to help fill the
barren field of 80 column programming. They are all utility programs.
Their titles are "Mutual Funds", "Resumes", "Genealogy", "Auto Expense
Tracking", "Kitchen Upkeep" (Recipes), and "Home Finances". All of these
programs come on one disk and it is highly recommended that you copy
each onto a dedicated disk. To explain the working of the programs,
I sometimes borrowed heavily from the text that Leo O. Clinton typed in
to explain the workings of his programs.
@(A)subapp: Mutual Funds
Works with drive 8 only. Keeps 253 transactions in each of 16 Mutual
Fund Accounts. Computes profit/loss, investment and total returns and
investment and fund performers. Output can be to screen, disk or printer
if you have included all the recommended files on your disk. Escape will
take you one level back from the level youre working on. You can add
accounts, delete accounts, modify accounts, or add transactions. This
program works on the trade date of your accounts and must be entered in
the request for date.
@(A)subapp: Resume Writer
This program is important in today's shifting job market. It works with
a wide range of disk drives. It can create a resume after you type in
the answers to a range of questions. It creates a resume to your personal
preference. The chronological option lists last job first, or you can go
with most important job first and on down to the least important. All
information can be saved to disk and then recalled and printed when you
need it.
@(A)subapp: Pedigree 128
Keeps track of 5 generations of your family. Gives you the option of
creating a full page of information for each member. If you get stuck
and don't know how to answer a question, the help screens will steer you
in the right direction. After the title screen is displayed a chart will
show you the relationship of the people you are entering. Drives 8 through
11 are supported. This is really a fine program for someone interested
in his or her family relations.
@(A)subapp: Auto Expense
If you're one of the people you see at the gas pumps jotting down
mileage, cost and quantity of gas in a little book, this program is for
you. This program keeps a record of 18 cars with the possibility of 252
entries for each car per disk. The program is menu driven. After you enter
data you can use what you have entered to create graphs or print a
record for the car you pick. The graphs will show you Actual mileage,
Cumulative mileage, or a Cents per mile Pie Chart.
@(A)subapp: Cook's Helper
This program is a electronic recipe box with a lot of extra features
thrown in. It allows you to make up a weekly menu and will help make
up a shopping list so you can get all the ingredients you will need.
There is a conversion calculator to help you go from metric to American
Standard, and also an option to convert to different quantities.
Entering the recipes into this program is a little different, as you must
use various buttons to access certain menus. For example, you press the
F1 key whenever you want to print quantities. A list will appear and you
use the cursor keys to select the proper quantity. I have used this
program since it first came out on Loadstar 128 and it saves on the
number of piles of paper I have laying around.
@(A)subapp: Fiduciary
The closest program that I can relate to this program is Sylvia Porter's
Personal Finance 128 series put out by Timeworks. Sylvia Porter's has a
few more small functions this program doesn't have. This program allows
you to know what your transactions have been, balance your checkbook,
create a budget and show you how close you are to staying within that
budget. It shows you what Assets/Liabilities you have, and allows you to
see in a chart where your money is going. A 30+ page manual that explains
what functions this program is capable of is available for you to print out.
=========================================================================
@(#)hw: The CMD Nirvana: The Guts and Glory
by Todd Elliott (telliott@ubmail.ubalt.edu)
http://ubmail.ubalt.edu/~telliott/commodore.html
@(A): Introduction
Before you begin, download the CMD Nirvana picture off of my WWW site!
Take a good look at the picture, and if it doesn't whet your appetite,
this article will! This is the computer that I use at home for my various
programming projects and good old fashioned entertainment. It consists of
a C128DCR with three built-in foreign components: a 12 VDC fan, CMD HD 85
megabyte drive and a FD 4000 3.5 disk drive. The case is painted obsidian
black. It does have a 4MB RAMLink hooked up with a 1750 REU and a
Swiftlink or Action Replay cartridge. Other peripherals circling the CMD
Nirvana's universe are an 1541, 1571, a SlikStik, MW350 printer interface,
in addition to a host of books and magazines dedicated solely to the
c64/128 line. (Soon, it will have a SuperCPU 20!) It is a very powerful
computer, but it doesn't cure my malady of starting programming projects,
but only to leave them unfinished to do the next one. All of this power
is corrupting, indeed!
@(A): Disclaimer:
This article, while resembling a how-to-do-it-yourself article, is only
meant for entertainment and informational purposes and is to be used at
the reader's own risk. Mr Elliott, Commodore Hacking, nor Brain
Innovations, Inc. can be held responsible for any damages and/or injuries
occurring as a result of following this information contained in this
document. Electronic circuitry is fragile and can be damaged easily.
Users must use ground strips or some other means of protecting their
circuitry from accidental discharges of static electricity. Also,
soldering equipment, electronic outlets, etc. pose a significant danger
to self, and extreme care should be used in operating these items or
working on electronic circuitry. Be sure to unplug the electronic
circuitry before commencing work. I also disclaim any and all warranties,
both express or implied.
Tremendous thanks goes to Al Anger, who, with his substantial assistance,
made this CMD Nirvana computer a reality. Thanks, Al Anger! For those who
don't know him, take a peek at Commodore World's Issue Ten cover, and
you'll see his C128T (Tower) computer, plus a host of other hardware
projects. But, Mr. Anger did not write this article and is not
responsible for its contents, in which the disclaimer above still
applies. You can reach Al Anger at coyote@bridge.net. Thanks also go to
Max Cottrell, who did the scans of the photographs, courtesy of MC
Photography, mcphoto@izzy.net. The standard disclaimer also applies to
Max Cottrell and MC Photography.
@(A): A Verbal Tour
Let's begin with a visual inspection of the front panel: The plastic
panel contains a sticker overlay for the CMD HD, which is located on the
left side of the panel. The HD sticker overlay is located next to the
C128D's POWER-ON LED on its right. The FD 4000 occupies the right side of
the plastic panel. The right side of the plastic front panel is used to
house a receptacle for the C128D's built-in 1571 disk drive, with a
swinging gate. But, the built-in 1571 drive was removed, and the left
side panel was cut and filed smoothly with the correct dimensions to fit
a FD 4000 disk drive snugly. (Well,almost.)
Continuing with the visual inspection, we turn to the left side of the
C128D. The metal casing was cut to allow for the fan, power cord and
off/on switch to be accessible. If you note the picture carefully, the
cuts on the case aren't in perfect sync with the interior. I guess the
design won't be winning any art awards anytime soon. ;) The main thing is
that I can access the off/on switch, and be able to plug/unplug the power
cord without any difficulty. As for the fan opening, a circular opening
as shown in the picture is not needed. In fact, a wave of lines cut on
the case would be sufficient to allow air circulation. Going to the back
end of the C128D, you will see wires snaking out of the receptacle in
which the power cord formerly went through.
@(A): Opening the Hood
Let's dispense with the visual inspection and actually open the 'hood' of
the CMD Nirvana computer! Yes, I know it's not a pretty sight and may
look daunting to you, but it can be done! From the top view, it looks
like the power supply for the C128D has been moved from its original
position 90 degrees counterclockwise. The CMD HD motherboard now occupies
the lower left corner of the C128D case. The FD 4000 juts across the
lower right corner of the C128D front panel and the C128D case. As you
can see, the internal 1571 disk drive has been ripped out. Wires are
everywhere, but most of them settle down in the blank area in the upper
right corner of the C128D case.
@(A): Digging In
Ah, where will we start? Let's take a closer look at the plastic front
panel of the C128D. The CMD HD front panel was inserted and attached to
the plastic front panel of the C128D, and is not attached to the metal
case of the C128D. The marriage of the CMD HD front panel and the C128D's
plastic front panel was accomplished by four screws and three pieces of
plastic. First, I used masking tape to cover the CMD HD's metal case on
the front side. This front side already has holes drilled on it by CMD or
some OEM manufacturer. I used an X-Acto® knife to cut holes in the
masking tape, popping through the holes in the metal case. When finished
with the poking of the holes in the masking tape, I have a 'drill image',
so I peel off the tape from the CMD HD's metal case, and affix it to the
C128D's plastic front panel on the left side. Making sure that
everything's aligned, I proceeded to drill holes, following the 'drill
image', in the plastic front panel. After peeling off the masking tape,
and then doing a test fit with the CMD HD's front panel with its
protruding LEDs, and swap buttons, it was a perfect fit! I then made the
connection more solid with four screws and pieces of plastic, by
attaching the CMD HD's front panel to the left side of the C128D's
plastic front panel. Then, I superimposed the sticker overlay for the CMD
HD perfectly with the LED's and the push-buttons, and used spray-on glue
to make the overlay a permanent part of the C128D's plastic front panel.
@(A): Preparing the FD-4000
As for the FD 4000, I used a saw to cut off portions of the plastic front
panel of the C128D where the internal 1571 disk enclosure used to be, cut
in correct dimensions to fit the FD 4000. It was still rough, so I used a
file to smooth the edges, on a gradual basis, until the FD 4000 made a
snug fit. I measured the front cavity of the FD 4000 and used those same
measurements to make the cut on the C128D's plastic front panel on the
right side. As you can see from the picture, there is little room for
error, especially at the top of the plastic front panel. Generally, the
cut was made as far as to the right side of the C128D's plastic front
panel as possible.
@(A): Preparing for the CMD Hard Drive
Now, to the internals of the C128D. I had to move the power supply
counterclockwise 90 degrees to make room for the CMD HD. I quickly ran
into a snag, as the power connector between the PCB and the power supply
was too short. I had to cut off all the wires on the power connector,
then enlarged it by soldering all wiring to a cannibalized wiring from a
power supply wire to both ends of the power connectors. For further
clarification, a close-up of both ends is supplied. The cannibalized
power wiring was very convenient, as they were color marked, and it was
easy for me to make sure that the wiring corresponded with each end of
the power supply connectors. Next, I spliced the +-12 VDC wires on the
power supply connector to supply continuous power to the fan. Usually a
fan comes with black and red wires. Splice the black wire of the fan to
the black wire of the power supply. Splice the red wire of the fan to the
yellow wire of the power supply. Next, the fan was attached to the power
supply with screws, to the right of the power cord connector.
The structural improvements to the PCB was made by bending the PCB power
connector end at a 45 degree angle, for it would collide with the
position of the CMD HD's PCB. Last, I connected one end of the entire
power supply to the back edge of the C128D's metal case. This was
accomplished by bending the end of the power supply at a 90 degree angle
and screwing it together to the metal case of the C128D. However, one end
of the power supply remained unsupported and would tip over onto the PCB,
causing possible malfunctions for the C128D. So, a makeshift support was
propped upon the C128D's PCB to support the remaining end of the power
supply. This support, like all other supports used, were fitted with
black electrical tape at the bottom to prevent shorts on the PCB. The
massive heat sink covering the VIC - II chip and the 80 column display
chip supported the other end of the power supply.
@(A): Installing the HD
With the power supply situated 90 degrees counterclockwise, we now have
room to insert the PCB for the CMD HD 85 megger. I took the CMD HD's PCB
out of its original metallic case that CMD supplied. (NOTE: If you do
that, you may void CMD's warranty on the unit.) But the CMD HD's PCB
could not just sit atop the C128D's motherboard, for there may be
accidental electrical shorts or other problems. So, the CMD HD's PCB just
hovered above the C128D's motherboard by approximately 1/4 of an inch.
This was accomplished by erecting two support beams above the C128D's
motherboard. The beams were obtained at a hardware store. They are
aluminum and are easily malleable with pliers. I screwed down one end of
the beam to the middle edge of the motherboard, leaving the other end of
the beam covered with electrical tape. I could have screwed down the
other end, but might have cut the motherboard in a way that Commodore
never intended and screwed up the whole thing. All supports listed in
this article are screwed down on existing 'drilled holes' in the c128d's
PCB. Please note that the support beam is nearly aligned with the
motherboard's power connector. I put electrical tape on top of the
support beam, as this top will support the CMD HD's PCB. This is to
ensure a smooth operation of the unit without any electrical shorts or
other problems. Also, look at the rear view of the support beam in the
picture, for it can give you a clear idea of how tall it is in relation
to the C128D's motherboard.
As for the other support beam, it is screwed down on both ends to the
C128D's motherboard on the far left side. This support beam is taller
than the one explained earlier. The reason is that the CMD HD's PCB will
be screwed on that support beam, so this support beam would have to be
aligned parallel to the top of the first support beam. Then the second
support beam is covered with electrical tape and two holes are drilled at
both ends, which align perfectly with the CMD's HD PCB's drilled holes.
(See photo for further clarification.)
Finally, to attach the CMD HD's PCB to the two support beams, I made sure
that both beams were in alignment and supported the PCB in a level
fashion, almost parallel to the C128D's motherboard. I attached one end
of the CMD HD's PCB, which has no cable connectors, to the second support
beam on the far left of the C128D's motherboard. Two screws were used to
make a secure connection to the support beam. The other end of the CMD
HD's PCB, the one with all the cable connectors, rested on the first
support beam, but was not screwed down. It could be done, but as the PCB
was already secured, I didn't bother. The cables running out of the CMD
HD's PCB are in a tight space, due to the FD 4000. As you may note from
the picture, there is no room for the internal 1571. If you decide to do
an internal CMD HD operation on your C128D, you must sacrifice your
internal 1571 drive.
@(A): Installing the FD
With the CMD HD PCB out of the way, I began work on the FD 4000. Before
the FD 4000 was inserted, I cut off pin one of the C128D's chip U113.
This pin gives a signal that the internal 1571 drive is in existence.
With that pin cut, the C128D no longer recognizes the existence of the
internal 1571 drive. It will, however, recognize any peripherals using
the serial bus, as I use a external 1571 as Drive #8 in my system. I took
the FD 4000 mechanism and the motherboard (it's built as a single unit)
out of its original case that CMD supplied. (NOTE: Doing so may void
CMD's warranty on the FD x000 unit.) I used trial and error to position
the FD 4000 drive in the C128D's metal casing. This is to ensure that the
FD 4000 would not protrude too far out of the C128D's plastic front
panel, or intrude too far inside the C128D's plastic front panel. As you
can see from the following picture, the FD 4000 unit protrudes from the
C128D's metal case by approximately 1 1/2 inches.
Lastly, I attached a support beam to the bottom right in front of the
C128D's metal case. This involved some cutting on the edge of the bottom
of the C128D's metal case in order to make the FD 4000 fit the C128D's
metal case. The bottom edge of the C128D's metal case was not cut out
completely, rather, it was bent inwards with pliers, creating a small
surface for the FD 4000 to rest upon. Again, trial and error was used to
determine how much to cut and bend the bottom edge, so that the FD 4000
unit would fit the C128D's metal case and the plastic front panel.
Finally, the FD 4000 unit was screwed upon the support beam. This FD 4000
also rests upon the bent in bottom edge. This creates a stable surface
for the FD 4000 unit to operate without having to insert a second support
beam onto the C128D's motherboard to support the other edge of the FD
4000 unit.
Finally, I connected the cables to the CMD HD's PCB and the FD 4000, and
attached the ribbon cables to the CMD HD's PCB, including that of the
hard disk drive and the front panel controls. I extended the length of
the power-on LED wire for the C128D's power supply. This extension was
made by adding more wire and resoldering the connections. This was
necessitated because the 90 degree turn of the power supply made all the
wiring too short. :( Ah, the wisdom of CBM to cut costs by making
everything short and sweet! I made sure that the CMD HD and the FD 4000's
on/off switches were already in the ON position. Last, I bought Velcro®
from an art supply store, and liberally applied it to the CMD HD 85 MB
drive mechanism. The opposite end of the Velcro® attachment was pasted on
the inside of the top metallic case of the C128D. This was positioned
roughly 3 inches from the front edge of the top metallic case. Trial and
error was used here to determine the optimum measurements. The CMD HD 85
mechanism was then attached to the inside of the top metallic case of the
C128D unit by Velcro®. This is a safe method, for the CMD HD has been
running for almost a year without any glitches. Close the case carefully
(The HD is on the case, after all!), and attach all the power to a power
control center with individual switches. The individual switches then can
be used to control a specific peripheral such as the internal FD 4000 or
the CMD HD 85, without having to open the unit to access the off/on
switches, or drilling holes in the case of the C128D to attach these same
switches. Convenient, isnt it?
@(A): Lessons Learned
Before concluding the article, it seems possible that one could put a
1581 drive in lieu of the FD x000 drives. It's possible, but I do not own
a 1581, so I really cannot comment. I would guess that the general
guidelines for the FD x000 drives would apply to the 1581. Granted, all
of this looks quick and dirty. But when I first started out with this
project with Al Anger, we didn't have step-by-step manuals, or other
references. It was truly a new territory for me. (Al has already done
such hacks for his C= computers before me, and his experience was
invaluable.) However, there were some bloopers. One, the c128d died upon
powering up. It turned out that the fan +- 12 VDC wiring was connected to
the wrong wire, and shut down the system. With that fixed, the c128d
powered up okay, but now, the CMD HD died. If that wasn't frustrating
enough, it was difficult to find out what went wrong, and I was wondering
if the FD 4000 would be next. The culprit was a break on the CMD HD PCB.
I accidentally drilled a cut on the PCB. With some soldering, I fixed it
by building a bridge between the break in the CMD HD PCB. Whew!
Everything now worked, and has worked since. Consider those bloopers
invaluable lessons learned in dealing with sensitive electronic
circuitry.
@(A): Conclusion
These are just general guidelines and are meant for entertainment
purposes only. It serves as an inspiration to those who always dreamed of
building their own C= beasts. I'm sure that there are countless users
that have customized their computers, and with these general guidelines,
undoubtedly, some users will want to create such a monster with rich C= 8
bit computing power!
@(A): Postscript
For those Commodore users who do not have access to graphical browsers,
you can contact the author for a Word v7.0 document printout with
pictures. The cost is $3 dollars for people living in the U.S. Canadian
readers will have to pay slightly more in U.S. dollars.
=========================================================================
@(#)surf: Hack Surfing
For those who can access that great expanse of area called the World
Wide Web, here are some new places to visit that are of interest to the
Commodore community. In early 1994, when the US Commodore WWW Site
started, the number of sites online that catered to Commodore numbered
in the 10's. Now, the number is in the 100's. What a change.
If you know of a site that is not listed here, please feel free to send
it to the magazine. The following links have been gleaned from those
recently changed or added to _CaBooM! - Your One Stop Commodore Links Site_.
(http://www.msen.com/~brain/cbmlinks/).
To encourage these sites to strive to continually enhance their
creations, and because we like to gripe :-), we'll point out
improvements that could be made at each site.
@(A): Companies
o Centsible Software
URL: http://home.sprynet.com/sprynet/cents/
Centsible Software has been a common name in Used Software Distribution
for a while now. their WWW Site contains catalogs for the different
platforms they support. C=Hacking gripe: Although the site is
very informative and works well for either text or graphical
browsers, it is rather plain. A bit of text here and some judicious
use of HTML 1.0 tags would spice it up immensely. Text Browser
compatibility shouldn't force WWW sites to be dull.
o Arkanix Labs, Inc.
URL: http://www.arkanixlabs.com/
Arkanix Labs recently purchased Threshold Productions International in
order to expand their presence in the Commodore Market. They have a
stocked WWW Site, complete with a catalog and recent news press
releases. C=H gripe: For the graphical set, the site is heavy
on graphics, although it does offer text link alternatives.
o Herne Data Systems, Inc.
URL: http://ourworld.compuserve.com/homepages/herne_data/cpm.htm
In the 1980's, HDS created some utilities for the C128's CP/M
mode. Jugg'ler 128 allowed the CP/M user to read over 140 different
disk formats, while Scramb'ler 128 encrypted files and disks. Although
HDS doesn't support these products anymore, they do provide them
and numerous reference works on their WWW Site. C=H gripe: text
based browsers might not handle the HTML TABLE very well.
@(A): Demo Groups
o Demolition
URL: http://www.cei.net/~rreed/
As the Webmaster puts it, " Demolition is currently more of a concept
than anything." Demolition is slated to become a disk based demo
programming resource magazine. However, at present, the site contains
a few articles on topics like boolean logic and VIC internals. In
addition, the site contains a comprehensive bibliography of basic and
demo related programming articles. C=H gripe: The bibliography is on
the main page, making it a lengthy piece of text.
@(A): Reference Works
o The Commodore Web Ring
URL: http://www.ncf.carleton.ca/~ag090/HomePage.ringpage.html
Although not a WWW site per se, this site starts you off on a journey
through various Commodore WWW sites. It's entertaining and will
undoubtedly take you somewhere you wouldn't have been before. C=H
gripe: Graphical surfers might find the large "buttons" annoying.
o Info and Files for Commodore GEOS
URL: http://www.radiks.net/irv_cobb/geos2.html
This, a sub page under Irv Cobb's home page, offers various GEOS
utilities that were either programmed by Irv or that he finds useful. GEOS
users should bookmark this page. C=H gripe: As above. A bit of
HTML 1.0 would spice this page right up.
o The History of Commodore
URL: http://www.geocities.com/SiliconValley/Heights/8329/History.html
A sub page of "The Commodore Haven", this sites gives the low-down
on Commodore, from its inception to its demise. C=H gripe: well done
page.
o Commodore Pictures
URL: http://www.swt.edu/~ez13942/commie/cbmpics.htm
Although the author of the page is not mentioned, he takes us on a tour
of his various Commodore computer systems. It's always interesting
to see how folks use their machine. C=H gripe: The graphics and the
captions are all on one page, which makes the page a bit lengthy.
o The KIM-1 page
URL: http://www.magic.ca/~yhpun/ianpun.html
For anyone who doesn't know what a KIM is or how it relates to Commodore,
this page is for you. Featuring pictures and explanations of both
the KIM-1 and the author's home-made expansion board, this site offers
a glimpse of the life of the 6502 pre-CBM. C=H gripe: The KIM-1 stuff
is on the same page as the author's personal and business information.
o CBMSearch - a search engine for searching Commodore related software.
URL: http://www.ts.umu.se/~yak/cccc/cbmsearch/
Bookmark this site. Now. Offering a concise way to find Commodore
software quickly and easily, CBMSearch can relieve the headache of
trying to find CBM titles on the Internet. C=H gripe: Can't really
say there is a gripe. The page is concise and could be spruced up
a bit, but in this case, function overrules form.
@(A): User Groups
o Bronx User's Group (BUG)
URL: http://www.mediaworks.com/bug/
As Commodore Authorized User Group #0065, BUG's WWW site contains
links to mail each of the officers and some links to other sites.
A phone number is given for information. C=H gripe: The site's a
bit low on content. We applaud the presence, but a map or some info
about the group would be nice.
o Stone Mountain User's Group - Contains information on when and where we meet.
URL: http://www.cris.com/~Derektp/
Although supporting all orphaned computer systems, SMUG (love the
acronym) appears to focus on the CBM systems and contains information
on meeting places and times. C=H gripe: As above, the content is a bit
low, but at least directions and times are given.
o ICPUG Independent Commodore Products User Group
URL: http://www.icpug.org.uk/
Although not devoted exclusively to the CBM 8-bit line, ICPUG does
support them. A wealth of information, including the ability to join
and club news is available. C=H gripe: For the graphical set, the
site is a bit heavy on graphics. (For these sites, viewing with Lynx
offers faster response.)
@(A): Individual Commodore Users
o Commie web page -- Better red than IBM
URL: http://www.swt.edu/~ez13942/commie/
Bo Zimmerman titles his page this peculiar way. He offers some history
on his use of Commodore systems and offers some pictures of his
various equipment. He also presents the Commodore Pictures page,
detailed above. C=H gripe: the background makes for hard reading on
some graphical browsers.
o Don's Page
URL: http://people.delphi.com/novan/
In an effort to offer people with text browsers some picture content,
Don has included ASCII art in his page. We are impressed. Basically,
the site details Don's hobbies and how the Commodore fits in. C=H
gripe: We really think the ASCII is great, but there's no reason to
make all the text in the document mono-spaced.
o Dave's Commodore 64 page
URL: http://www.csun.edu/~hbbuse08/c64.html
This page is for those looking for game information, SID tunes, and
emulators. (Note: some of the files on this site are copyrighted.)
C=H gripe: The top says "This page looks best when viewed with
Microsoft's Internet Explorer or Netscape!"
o John Elliott's Home Page
URL: http://www.nsis.com/~prof/
John has a very extensive site detailing computers in education,
including a piece on using "obsolete computers" in the classroom.
A number of pieces available on the site include education conference
highlights, and a discussion of how he finally hooked up to the
Internet. The site is best viewed with Lynx, as it is enhanced for
Lynx! (that's a switch) C=H gripe: The layout of the pages seems a
bit haphazard, but maybe it's just us.
o Irv Cobb's home page
URL: http://www.radiks.net/irv_cobb/
If you want to know about Irv or where he grew up, it's all here.
Hyperlinks are spread throughout the text to direct you to different
topics. C=H gripe: none. Although it isn't as "splashy" as some
pages, it is laid out well, and looks fine, although simplistic, on a
graphical browser.
o Commodore 64 Online
URL: http://www.geocities.com/SiliconValley/Park/4645/
Tim Plelp's site is brimming with links to his favorite utilities and
applications. Also included is a comprehensive list of PD/Shareware
titles. C=H gripe: use unordered lists instead of "*" for the various
items.
o Commodore Connection
URL: http://www.gis.net/~sunfish/crcbm.html
Geoff Sullivan's personal site offers articles and software to make
using a C64 or 128 more enjoyable. Besides links to other sites,
he also offers up Perfect Print fonts and articles on how to expand your
REU to 2MB and how to build a simple RS-232 converter. Of special
interest is a collection of customized GEOS mouse pointer icons and a
program called QWIKSTASH that will copy files in GEOS on bootup.
C=H gripe: Great resource, but little information about Geoff and how
he uses his CBM.
=========================================================================
@(#)jb: Jim Butterfield: The Commodore Guru - An Interview
by Jim Lawless (jimbos@radiks.net)
@(A): Introduction
My initial interest in the Commodore 64 computer began in 1983. At the
time, my primary source of information pertaining to the C64 came from
Compute! and Compute!'s Gazette publications. One author's name stood
from the rest; Jim Butterfield.
I used to turn to Jim's articles immediately when I managed to get my
hands on a new magazine. Mr. Butterfield has the rare ability to
describe complex subjects in simple terms.
I'm certain that I'm not alone when I credit Jim with having taught me
a lot about the inner workings of the Commodore 64. As important as
the specifics of writing code for the C64 was Jim's style. He would
often write code that was readily portable to multiple CBM machines.
His code had longevity and purpose. The solidity of his programs left
me with a lasting impression pertaining to how software should be
developed.
The following interview with Jim was conducted via e-mail.
Q: What was the first programming language that you learned?
A: In about 1963, an assembly language called COGENT for a computer that
few people have ever heard of: a Collins Radio C-8401. That was shortly
followed by work on an IBM 1401, which had a machine language that was
alphanumeric. (Honest! You could keypunch M/L directly!)
Q: Were numbers expressed in Base-36?
A: No. Decimal.
The basic machine had 1000 bytes (not 1K) of (7-bit) memory (core, not
RAM!) so addresses ranged from 000 to 999 (and were given in decimal, of
course). Expanded machines had 4K, then 16K ... the addresses were
slightly more complex in that case.
Thus, to move bytes from an area at, say address 123 to address 456 the
instruction would be M123456. I AM NOT MAKING THIS UP!!!!
Q: Did you guys have contests to spell out goofy words as part of a
program? (I know of a programmer who used to regularly use the return
code $0BAD to indicate a problem...)
A: No (the addresses mixed in with the op codes ruled that out), but you
could do fun things on a 1401 if the system manager wasn't looking ..
such as play music.
Q: What was the first computer that you owned?
A: Not counting the TUTAC-1, which was powered by rubber bands and was
more correctly a logic machine: The KIM-1, a single-board microcomputer
made by MOS Technologies, Inc., of Norristown PA. MOS Technologies was
subsequently acquired by Commodore.
Q: When did you first encounter a Commodore computer?
A: When Commodore acquired MOS Technologies, the computer that I had
owned for over a year became a Commodore computer. Subsequently, an
employee of MOS Technologies, Chuck Peddle, convinced Jack Tramiel of
Commodore that they should launch a personal computer called "The PET".
I got one of those not long after they started production.
Q: Did you have formal training in computer programming?
A: Yes, on that long-ago Collins C-8401. But this was more a process-
control machine; it didn't use of any the newfangled (at the time)
languages such as Fortran and Cobol. So my training was in machine
language/assembler.
Q: What was the first book that you wrote?
A: A couple of enthusiasts and I collaborated on a volume called "The
First Book of KIM", a book describing how to do things with the KIM-1
single board computer. That computer was powered by a 6502,by the way;
in fact the KIM-1 board itself was designed as a engineering prototype
for people who wanted to try out the chip.
Q: Was it similar to the Altair where you had to manually increment an
address-counter before you could throw the switches to set the byte at
that address?
A: No, the KIM-1 had an operating system in ROM. That's one of the
things that made all KIM users "equal" and able to share programs, while
the other early micro owners had quite a scattering of stuff.
Q: What COULD you do with a KIM-1?
A: Hey, watch it! That's like saying, "What could you do with a
Commodore 64"? Although the KIM-1 came with a hexadecimal keypad rather
than a keyboard, and output to a six-digit LED display, you could use
those to good advantage AND hook up extra stuff. Play music? Play
Blackjack? Hunt the Wumpus? Skeet shoot? Unless you had the budget for a
printer, you'd have a hard time doing an accounts receivable, of course.
But this is the 6502 we're talking about! And we all know it can do
ANYTHING!
Q: What was the last book that you wrote?
A: It's probably the revised version of "Machine Language For the
Commodore 64, 128, and Other Commodore Computers". In 1985 and 1986,
however, I did produce a "pocket diary" reference guide for Commodore 8-
bit computers.
Q: Have you ever written articles or books on subjects that are not
computer-related?
A: My first writing experience was a treatise on transistor theory,
published by Popular Electronics in August of 1959. Not much else.
Q: Did you write commercial software for any of the Commodore computers?
A: As a general rule, no. All my stuff is public domain. At one time, I
had written a simple spell-checking engine that was incorporated into a
word processing package for a while.
Q: SuperMon was a tool that I used daily when developing ML routines or
exploring the C64. What prompted you to write SuperMon?
A: In the early days of Commodore personal computers, there were quite a
few machine language monitors around. They were partly based on some
publicly published code by Steve Wozniak (of Apple!), and partly based
on the MOS Technology TIM monitor, from KIM-1 days.
Two variants of the basic monitor caught my eye: NewMon, which added
several useful features to the basic Machine Language Monitor; and
HiMon, which sited the monitor in upper memory where it wouldn't
conflict with BASIC programs. I decided to put the two together and
generate a self-relocating MLM. That was desirable in early PET/CBM
days, where some computers would come with 8K RAM, some with 16K, and
others with 32K; you couldn't assume where the top of memory would be.
In those days, almost every Commodore computer came with a small built-
in MLM, and the first Supermon was an add-on. Later, as Commodore
changed the style of the MLM packages they built into newer machines
such as the 128, I went back and modified those earlier versions so that
they would work the same across all platforms.
Q: Did you ever expand the mini-assembler in SuperMon into a full-blown
assembler development package?
A: No. I hustled Brad Templeton into writing PAL, so that there would be
an assembler available for those who needed it. There had been a few
assemblers around before that - Commodore had one, and another was the
MAE system - but I was sure that somebody like Brad could do better.
Q: Even Superman had to put up with Kryptonite. Describe your worst
experience as a software developer / technical writer.
A: My first publication of SuperMon in Compute! magazine had the wrong
end-of-address supplied (my fault). I got a LOT of mail and phone calls
on that one.
Q: I had heard a rumor pertaining to your software development habits
that indicated you would approach a given project with full force. You
would focus your undivided attention on it until it was complete. Is
this rumor accurate?
A: Possibly. If I have a project under way, it "follows me around" until
it's complete; I fret over it and can't put it away until all the pieces
are in place.
Q: If so, did you ever change this methodology?
A: Not to any great extent. A half-written program bugs me, and I won't
rest until it's finished.
I might, however, decide that I'm taking the wrong track, and scrap a
program completely in order to start over. This isn't a loss: the first
attempt can show you what's really wanted.
Q: Your articles made you seem a bit omniscient. You always had the
inside info on the newest CBM computers and always seemed to be able to
explain their complexities in a manner that would suggest that you had a
lot of time to study them. I don't know a whole lot about your
employment during the mid/late 80's. Were you affiliated with CBM? A
beta-tester?
A: I had many friends in Commodore Canada, but I never worked for the
company, although I did contract work for them on occasion.
The big problem was not getting information from Commodore; it was
learning to ignore most of it. Commodore was bubbling over with ideas
and plans that never came to fruition. There was no point in writing
about projects that never happened (the Commodore music box? the cash
register? the videotape/disk storage device?). I took the position:
"Don't tell me about it until it's a real product!".
Commodore Canada was an excellent source of information, and I relied on
them to keep me from straying too far into technical speculation.
Q: Did you use any high-level languages on CBM computers?
A: BASIC, of course. COMAL, a BASIC derivative language from Denmark,
was nicely constructed. Played around a little with C, but that language
doesn't fit comfortably into an 8-bit environment.
Q: What was your favorite computer that CBM produced?
A: I don't know that I have a single favorite. The early PET/CBM
machines were great "discovery" platforms, where we could investigate
these wonderful new computers. The advent of the VIC-20 and the
Commodore 64 brought color and sound, which added to the charm of these
home computers; but they paid a penalty in slow disk access and screen
width limitations. Today, perhaps the Commodore 128 ranks as the best,
or at least the computer with most general usability. But it wasn't
produced in quantities as great as some of the earlier machines, and so
the user community hasn't been quite as furious.
Q: What kind of home computer do you currently use?
A: C128 .. Amiga .. Pentium system. All three.
Q: Who were your influences as related to writing?
A: Nobody specific. Just tried to write it as I would say it.
Q: Who were your influences as related to programming?
A: I've worked with a lot of sharp programmers over the years. Not one I
can pick out especially.
Q: If you could relive the CBM glory years, would you do anything
differently?
A: I don't think so. On another path, I could have gone for big bucks;
but making money carries a responsibility to support and service, and
that would have taken the fun out of it.
Q: Is your current job computer-related?
A: I'm currently more or less retired.
Q: If you had not chosen a career in computing, what field of endeavor
would you most likely have pursued?
A: Before computers, I worked in electronics and telecommunications.
Q: What are your current hobbies?
A: Reading; travel; films; raising my daughter. (That's a hobby???)
Q: What sort of technical literature do you currently read?
A: Mostly reference material. Current magazines are heavy on the "what's
for sale" stream; to my mind, that's not the fun part of computing.
Q: Are you surprised that a sort of "CBM renaissance" has been ta
king
place the last few years ( ...availability of C64 emulators on multiple
platforms and such...the SuperCPU from CMD...).
A: It's a shame that Commodore wasn't able to/interested in keeping the
8-bit line going. It's good to see that is happening.
Surprised? A little. But enthusiasts and user groups have always had a
stronger effect than manufacturers are willing to admit.
Q: What is your opinion on the way consumer computing has evolved since
the inception of the early PET machines?
A: The average computer user today has a lot less fun than we still have
with the early machines. The industry message today is "Buy it and use
it, and then turn it off .. don't worry or think about how it all
works". That's sure a lot less fun for tinkerers.
Q: What words of wisdom would you care to impart on a new (or
revitalized) generation of CBM hackers?
A: Enjoy what you're doing! If it becomes drudgery, you're doing it
wrong!
=========================================================================
@(#)trivia: Commodore Trivia
by Jim Brain (j.brain@ieee.org)
@(A): Introduction
As some may know, these questions are part of a contest held each month on
the Internet, in which the winner receives a donated prize. I encourage
those who can received the newest editions of trivia to enter the contest.
This article contains the questions and answers for trivia editions #29-32,
with questions for edition #33.
If you wish, you can subscribe to the trivia mailing list and receive the
newest editions of the trivia via Internet email. To add your name to the
list, please mail a message:
To: brain@mail.msen.com
Subject: MAILSERV
Body:
subscribe trivia Firstname Lastname
help
quit
@(A): Trivia Questions and Answers
This edition should be sub-titled "Programmer's Trivia".
Q $1C0) What are the two configurations for the LORAM, HIRAM, GAME, and EXROM
pins that will allow the use of a full 64kB of RAM in the C64?
A $1C0) There are actually 4 configurations, in two categories:
LORAM 0 0 (X means either 1 or 0)
HIRAM 0 0
GAME 1 X
EXROM X 0
Q $1C1) What is the first thing that the C64 (and VIC) KERNAL does upon
powerup?
A $1C1) The first thing each does is reset the stack pointer to $ff.
Q $1C2) What KERNAL routine is used to set a DOS channel to input?
A $1C2) CHKIN ($ffc6)
Q $1C3) What KERNAL routine is used to set a DOS channel to output?
A $1C3) CHKOUT ($ffc9)
Q $1C4) Before calling the routines in $1C2 and $1C3, what register must
you load?
A $1C4) You must load .X with the logical file number.
Q $1C5) What 3 devices can the KERNAL NOT load from?
A $1C5) keyboard (0), RS-232 (2), or screen (3). The first and last are
somewhat obvious, but allowing RS-232 loads would have made
loading from a remote machine possible. Incidentally, you can't
save to any of these devices, either.
Q $1C6) In the Commodore KERNAL, there are "high" and "low" level routines.
To which class of routines does "SECOND" belong?
A $1C6) low. It is used to specify the secondary address, as the '7' in
open 4,4,7.
Q $1C7) If a programmer calls the KERNAL routine "STOP" and the RUN/STOP
key is NOT pressed, what is returned in the .A register?
A $1C7) .A will contain a byte representing the last row of the keyboard
scan.
Q $1C8) The Commodore KERNAL routines are all accessed via a jump table.
What routine is used to change the values in the KERNAL jump table?
A $1C8) The appropriately named VECTOR ($ff8d) call, which few programmers
actually use.
Q $1C9) A call is made to a KERNAL routine, the call returns with the C
bit set and the .A register holds $02. What error does this
indicate?
A $1C9) "File already open"
Q $1CA) If a call to READST is made, and a $40 is returned in .A, what
does this indicate?
A $1CA) End of File.
Q $1CB) What routine can be called to determine the physical format of the
Commodore 64 screen in characters?
A $1CB) The also appropriately named SCREEN ($ffed) call.
Q $1CC) The Commodore 64 starts a non-destructive RAM test at what location?
A $1CC) $0300.
Q $1CD) Which way does the RAM test proceed: up or down?
A $1CD) up.
Q $1CE) Which KERNAL routine is used ONLY in conjunction with a Commodore
IEEE card?
A $1CE) SETTMO ($ffa2), which sets the IEEE bus card timeout flag. I infer
that Commodore thought many people would use the IEEE interface.
(Anyone know any more about this?)
Q $1CF) Many hybrid BASIC/ML programs use SYS to transfer control from BASIC
to ML. However, a few use USR(X). When using the latter function,
where does BASIC fetch the ML routine's starting address from?
A $1CF) 785 and 786, in classic LO:HI format.
The "BASIC" Trivia Set
Q $1D0) To load a program from the current location on a cassette tape, what
two key combination must a user press on a VIC-20 or C64.
A $1D0) SHIFT and the RUN/STOP key. Note that the same key sequence loads
a file from disk on the SX-64 or C128 in 128 mode.
Q $1D1) If I issue the BASIC statement OPEN "JIM,S,W", What type of file
am I opening?
A $1D1) A sequential file.
Q $1D2) Is BASIC in the Commodore computer systems an "interpreted" or
"compiled" language
A $1D2) interpreted. When a program has been "Blitzed!", it is then
compiled.
Q $1D3) What type of variable is A%?
A $1D3) An integer variable.
Q $1D4) If I issue the BASIC line PRINT:PRINT "A","B" what column does
the "B" show up on when run on a C64?
A $1D4) Column 11, if we number columns from 1.
Q $1D5) What column does "B" show up on if I run the BASIC line in $1D4 on
a VIC-20?
A $1D5) Column 12. Since the VIC has 22 columns, the natural column spacing
was 11 positions, instead of 10 on 40 and 80 column CBMs.
Q $1D6) Alphebetically, what is the first BASIC 2.0 command to have a 3
letter abbreviation?
A $1D6) CLOSE.
Q $1D7) How many times does the statement FOR T=1TO0 execute?
A $1D7) once. A BASIC for loop always executes at least once. This is
different from languages like 'C', which would not execute the loop
at all. Feature or bug, who knows...
Q $1D8) What base does the BASIC LOG command use for its logarithm
function?
A $1D8) base e. (2.7....) (one of the entrants claims that "e" in the 64
isn't quite as accurate as we think. He was quoting 2.85....
Q $1D9) A = NOT B can be written as which expression:
a) A = -B
b) A = -(B+1)
A $1D9) b. NOT computes the twos-complement of the number, not the simple
ones-complement negation. This feature simpleifies subtraction in a
CPU, since subtractions can be performed as additions.
Q $1DA) What does INT(-15.43) return?
A $1DA) -16. INT returns the next LOWER integer.
Q $1DB) What does ASC$("JIM") return?
A $1DB) ASC$ returns an error. That's what I get for writing these late
at night. What I menat was "ASC", returns the value of the first
character of a string, in this case 'J'. Since I didn't specify
if this was a uppercase 'j' or lowercase 'J' in graphics mode, the
result could either be 74 or 202.
Q $1DC) What is the abbreviation for GET#?
A $1DC) Technically, there is none. However, on the C128 at least, GET#
shares the same token as GET, so typing gE# will indeed work.
This is different from PRINT and PRINT#, which have different
tokens.
Q $1DD) What is the largest integer value that Commodore BASIC can handle?
A $1DD) Again, this was a little ambiguous. I was looking for the maximum
value that an integer variable can hold, which is 32767, but line
numbers (which are integers) can be up to 63999.
Q $1DE) What is the ONLY Commodore Editor key not affected by "quote mode"
A $1DE) The DEL key. I would have answered return, but the 64 PRG spells
it out that only this key is unaffected.
Q $1DF) What is the range of RND?
A $1DF) 0.0 <= RND < 1.0, or [0,1). Both mean that the range is from 0 to
1, including 0, but not 1.0.
The "VIC Chip" Trivia Set
Q $1E0) We all know that VIC stands for Video Interface Chip. However,
in what computer was a VIC chip first used?
A $1E0) The VIC-I was used in the VIC-20.
Q $1E1) What is the difference between the 6566 and 6567 VIC chips?
A $1E1) The 6566 has fully decoded address lines. The '67 has multiplexed
address lines for connection to DRAM.
Q $1E2) On what computer would one find a VIC-II chip?
A $1E2) C64, C64C, 64SX.
Q $1E3) On what computer would one find a VIC-IIe chip?
A $1E3) C128, C128D
Q $1E4) On what computer would one find a VIC-III chip?
A $1E4) C65 (64DX)
Q $1E5) Versions of each VIC chip exist for each computer model/video
standard combinations suppoerted by Commodore. What model/video
standard would the 6569 work with?
A $1E5) C64 type machine using the PAL-B standard. Note that there are also
PAL-N and PAL-M standards, which required different VIC-II models.
Q $1E6) How much memory could be directly addressed by a VIC-II chip?
A $1E6) 16 kilobytes.
Q $1E7) How many control registers does the VIC-I contain?
A $1E7) 16 control registers.
Q $1E8) How many control registers does the VIC-II contain?
A $1E8) 47 control registers.
Q $1E9) The VIC-II series introduced Movable Object Blocks to the
Commodore programmer. By what common name are MOBs known?
A $1E9) "sprites"
Q $1EA) What are the dimensions of a MOB?
A $1EA) 24 dots wide by 21 tall.
Q $1EB) What difference between the VIC-I and VIC-II causes VIC-II equipped
systems to potentially operate slightly slower than VIC-I equipped
systems, all other items held constant?
A $1EB) Even with all of the fancy features of the VIC-II (like sprites)
turned off, the VIC-II doesn't have quite enough time to do all
of its work, which includes refreshing the DRAM ICs in addition to
the work of drawing the screen and reading the Paddle inputs. So,
every 8th rasterline, the VIC has to "steal cycles" from the CPU to
fetch character data from RAM. Since this time is not available to
the CPU to execute programs, a simple program written on each
machine will execute faster on the VIC because its CPU doesn't
have to fight the video IC for cycles.
Q $1EC) In addition to supporting graphical output to an external display,
what other vitally important function do the VIC chips (starting
with the VIC-II) perform?
A $1EC) They refresh the Dynamic RAM of the computer periodically. If the
DRAM is not refreshed, it would lose its contents.
Q $1ED) Many people know that the VIC-II can deliver up to 320x200
resolution without much trouble. What is the maximum resolution of
the VIC-III chip?
A $1ED) According to the specifications, it is supposed to handle 1280H by
400V interlaced and non-interlaced.
Q $1EE) Between the development of the VIC-II and the VIC-IIe, there was a
related, though not very similar video IC developed for CBM machines.
Name its TLA (three letter acronym).
A $1EE) TED (Text Editting Device). It was developed for the 264 series
(Plus/4, C16).
Q $1EF) How many pins does a VIC-II chip contain?
A $1EF) Every VIC-II has 40 pins.
The "BASIC Tokens" Trivia Set
The following questions refer to the way Commodore "crunched"
BASIC programs by substituting one of more bytes called "tokens"
for BASIC keywords in a BASIC program. The resulting code was
smaller, since multiple character keywords were internally replaced
with smaller length tokens.
(All the answers were taken from _Commodore Magazine_, April 1987,
pp 82-85.)
Q $1F0) Commodore BASIC tokens start at what number?
A $1F0) $80, or 128.
Q $1F1) BASIC 2.0 defines tokens without gaps up to $ca. What keyword
is represented by $cb?
A $1F1) GO.
Q $1F2) Why is the token for PI strange?
A $1F2) It is token $ff, or 255.
Q $1F3) All versions of Commodore BASIC contain at least a subset of
tokens. At what number does this subset end?
A $1F3) $ca.
Q $1F4) BASIC 4.0 defines tokens beyond $cb. What is the last token
included in BASIC 4.0?
A $1F4) $da.
Q $1F5) There was a BASIC 4.0+ included in the B series. It extends the
BASIC with some new commands not in 4.0. What token range are
these new commands at?
A $1F5) $db-$e8.
Q $1F6) When a user plugs a Super Expander into a Commodore 64, he or
she gains access to 25 new BASIC commands. The tokens for these
commands are defined differently from the previous tokens. What
is the difference?
A $1F6) They are two byte tokens of the form: $fe XX, where XX ranges from
$80 to $9e.
Q $1F7) When the Plus/4 and C-16 was developed, new commands were added
to BASIC. In addition, many commands from BASIC 4.0 were also
included. Unfortunately, the tokens for BASIC 4.0 commands included
in these new machines differed from those in the older BASIC 4.0.
If a user lists a program written in BASIC 4.0 on a Plus/4, what
will the BASIC 4.0 CONCAT command show up as?
A $1F7) CONCAT is $cc in BASIC 4.0, and is RGR in BASIC 3.5.
Q $1F8) What is the last token used in the Plus/4 line?
A $1F8) $fd.
Q $1F9) If you list a program written on the Plus/4 with the keyword
SCALE on a BASIC 4.0/4.0+ machine, what happens?
A $1F9) SCALE on BASIC 3.5 is token $e9, which is not in the BASIC 4.0(+)
list. The PET will crash. Interstingly, tokens above $e9 do not
crash the PET.
Q $1FA) When the C128 was released, it shared many tokens with the Plus/4.
However, at $ce, the 128 differs from the Plus/4. The Plus/4 token
$ce corresponds to RLUM, but the C128 uses the token another way.
What is peculiar about the C128 usage?
A $1FA) The C128 uses $ce as a prefix byte for a range of two-byte tokens
that range from $02 to $0a.
Q $1FB) The C128 shares many keywords with the Super Expander cartridge
for the C64. As with the Plus/4, though, keywords don't map to
the same token. To what token does the C128 keyword SPRITE
(token: $fe $07) correspond to on the Super Expander equipped 64?
A $1FB) $fe $93.
Q $1FC) What keyword was not included in BASIC v1, but was included in
BASIC v2?
A $1FC) GO, token $cb.
Q $1FD) The C128 defines all the tokens from $fe $02 to $fe $26, with the
exception of two tokens. Name one of them.
A $1FD) $fe $20 and $fe $22.
Q $1FE) The Plus/4 line had the ability to add keywords dynamically when
running cartridges. At what point in the token list do these
"added" keywords show up in the Plus/4 line?
A $1FE) They use $fe as a prefix byte for two-byte tokens.
Q $1FF) If a programmer want to write a single program to run on a
B128, a plus/4, and a C128, what version of BASIC is the lowest
common denominator?
A $1FF) Unfortunately, BASIC 2.0 is it.
The C128 Set:
Q $200) How many general purpose central processin units does a C128
contain?
Q $201) The Commodore 128 contains a MMU IC. What does MMU stand for?
Q $202) What Commodore produced cartridge is specifically mentioned in
the 128 PRG as being incompatible with the 128?
Q $203) The C128 introduces the concepts of "banks" How many such banks
are recognized by the C128 BASIC?
Q $204) What version is the BASIC included in the C128 in native mode?
Q $205) Can any of the BASIC graphics commands be used on the 80 column
screen?
Q $206) How many high-level graphics commands are available on the C128
in C128 mode?
Q $207) In C128 mode, at what location does screen memory start?
Q $208) The 80 column IC in the 128 can display how many full character
sets of 256 characters each at one time?
Q $209) Many have scorned the C128's 80 column video IC. What about this
IC makes it so hard to use?
Q $20A) What number is the 80 column IC referenced by?
Q $20B) What machine language addressing modes cannot be used with the
80 column chip?
Q $20C) The C128 contains keyboard keys not present on the C64. What IC
is used to read these keys? (besides the CIA, as on the 64)
Q $20D) Following the introduction of the C128, a new version of was
developed. Name it.
Q $20E) Many people refer to C128s as 16k or 64k units. To what does this
refer?
Q $20F) According to the C128 literature, the C128 can be expanded to use
how much memory?
=========================================================================
@(#)basic: Hacking BASICs
by R. T. Cunningham (wanderer_rtc@usa.pipeline.com)
@(A): Introducation
Although BASIC is not an "advanced" language, such as Assembly or C, it's
been used far more often than any other since the first Commodore computer
was introduced. It is not my intent to provide information here that is
widely available in user manuals, newsletters, or other forums. What I am
going to present is what I have learned from "The School of Hard Knocks"
or, in other words, by trial and error.
@(A): Detecting Drives Connected
If your program attempts to access a device number that is not connected to
computer in the serial chain, like fetching a directory, your program will
halt with "?device not present error in (line number)". How do we prevent
this from happening? The answer is to open the device number, close the
device number, and check the status variable:
open15,10,15:close15:ifst<>0then (act on device not being present)
Any number returned by the status variable other than 0 will indicate that
the device is either not connected or not turned on.
In my own programs, I like to do this check for all of the drives early in
the program by stashing the device numbers in an array. Legal device
numbers for disk drives are 8 to 30, with 30 being used as configuration
mode for a CMD drive. Since I know of no other drive that can use device
#30, I won't include that device number in the loop. The array should be
dimensioned to at least 21. I prefer 22 and to use the first variable (0)
to hold the number of devices. I keep the "start up" device number in a
non-array variable so that I can return to it after the drive checking
routine has been completed:
10 dimdv(22):dv(0)=0:rem set number of devices to 0
20 dv=peek(186):rem current device # of last drive accessed
30 ifdv<8thendv=8:rem prevents non-disk device #s
40 fora=1to22:rem device #s 8-29 minus 7 so that array starts at 1
50 open15,a+7,15:close15
60 ifst<>thendv(0)=dv(0)+1:dv(dv(0))=a+7:rem increment number of devices
and store device numbers
70 next
If I have device number 8, 10, 12 and 14 connected, dv(0) will now contain
4, dv(1) through dv(4) will contain those device numbers. You can now use
this array to check for a valid device number prior to an access command:
100 rem d equals the device number selected in this example
110 fl=0:rem set flag to 0
120 fora=1todv(0):rem check total number of drives attached
130 ifd=(dv(a))thenfl=1:rem set flag to 1 if a match is found
140 next
150 rem continue with drive access only if flag is set to 1
@(A): Selective GOTO (GO TO) Routine:
When acting on a number the ON/GOTO command set works by either using a
numeric variable or the value of a string, if the string contains a number:
10 onagoto100,200,300,400
or
10 onval(a$)goto100,200,300,400
What if we want to use a non-numeric character with ON/GOTO, especially
with a list of choices presented to the user?
In the C128's native mode the INSTR function can be used:
10 rem keys accessible by user are A,B,C,D and stored in a$ response
20 oninstr("ABCD",a$)goto100,200,300,400
or
20 a=instr("ABCD",a$):onagoto100,200,300,400
On the 64, since INSTR is not an available function, we can emulate the
function with a different routine:
20 on-1*(a$="A")-2*(a$="B")-3*(a$="C")-3*(a$="D")goto100,200,300,400
or
20 a=-1*(a$="A")-2*(a$="B")-3*(a$="C")-3*(a$="D"):onagoto100,200,300,400
Note that the first 1* is not necessary but the - is. I've added it for
clarity only.
In the first example, INSTR returns the place number (sequence) of each
character in the string. In the second example, the place number is
obtained by multiplying the negative sequence number by the signed value of
a$. The signed value of a string is always -1 (I think!).
When working with a program that is designed to work in both 64 and 128
modes, the INSTR function should not be used since the other method will
also work in 128 mode.
More proficient readers might want to demonstrate the machine language
equivalents of both drive detection and INSTR routines? I for one would
like to add them to my ML arsenal.
=========================================================================
@(#)error: ? DS, DS$: rem The Error Channel
We are not aware of any errors with issue 13.
=========================================================================
@(#)bits: Twiddling the Bits: VIC-20 ROM Cartridge Exploration and Archiving
by Ward Shrake (wshrake@aol.com)
@(A): Introduction
This article's primary purpose is to enable you to understand the basic
principles of making an archival backup of a ROM cartridge. However, I do
wish to point out the following important points, before I begin:
@(A): Disclaimer
1. This is NOT intended for any sort of illegal purposes! The
information can be misused, if one wants to badly enough. However, so can
virtually every other piece of information on the planet. Fire is a good
thing, as are hammers, saws, and other tools, but all of them can be
misused. I urge the reader to use this information in a proper fashion
and to take the time to reflect on what you are doing, to avoid hurting
anyone or anything.
2. I am releasing this information for two basic reasons (besides basic
hacker pride in obscure technical knowledge). First, the Vic20 died many
years ago. Commodore helped accelerate its death, by pushing the C64
computer onto the market, at a time when all the companies out there had
a lot at stake. I don't blame Commodore from a marketing sense; they just
wanted to stay alive themselves in a cutthroat market environment.
However, this means a lot of people still have the idea that the Vic20
was/is a piece of obsolete junk. This is not true, but the public acts as
if it were. The end result is that a lot of perfectly good hardware and
software is thrown away on a regular basis. Once it is in a landfill
somewhere, its rather difficult for anyone to use it! Hence my two-fold
concern: to help show the public (and Commodore Guru types) the Vic20 is
a very cool gaming machine, and to physically rescue the software for the
system before all of it is lost forever. I take little pleasure in
thinking that 50,000 years from now some archaeologist will dig up our
landfills and think we must have had some really cool stuff!
3. I really like the term "Digital Archaeology." (I wasn't the first to
use it, however.) Basically, it means that with the many rapid advances
in the computer sciences, lots of stuff gets lost or forgotten in the
rush to replace everything every few years. Whereas an entire
civilization might take hundreds or even thousands of years to die out
and be all but forgotten, the history, lore, and software of computers
can be gone in just a few years. If we don't revive it now, who will
remember how to use any of this stuff? There are only a few people around
now that can do it, and their memories are getting fuzzy with the passage
of time. I don't mean to preach; I just think this is as good a time as
ever!
A small group of concerned individuals, myself included, have begun the
task of archiving all the VIC-20 cartridges known to exist. The project
also includes documenting every aspect of the VIC-20 hardware and how
it operates.
@(A): General information about Vic20 cartridge software
A Vic20 cartridge is approximately 5.5 inches wide, 3 and 3/8ths inches
deep, and 5/8ths inches tall, when viewed as if ready to be installed.
Most of the cartridges that were made by Commodore are either a beige or
dark brown colored plastic with a tan or metallic all-text label. Some
third-party companies had more interesting looking cartridges; most of
the plastic cases were black as a general rule, with white also being
used at times. In rare cases, oddly-shaped carts existed, for example,
carts by UMI. Some of these seem to be more epoxy-based than plastic,
with glitter inside it! Only a few companies really had fancy, full-
colored labels on their cartridges.
The most common memory configuration, inside the casing, is one bank of
8k. ROM was standard for the larger companies, but EPROM's were also used
at times, even by Commodore themselves. Four-kilobyte cartridges do
exist, as do 8k cartridges made up of two banks of 4k chips. (Memory was
expensive then, as you can no doubt imagine, and some companies had to
make due with whatever they could get cheap enough.) 16K cartridges do
exist as well, although the bulk of these were done by the largest
companies. Commodore made a few 16k carts, as did Atari, Sega, Hes, and a
few others.
If other standard cartridge memory configurations existed in the Vic's
day, the author is currently unaware of them. (I would like to hear of
any, if they do/did exist, especially if they were once made
commercially.) There may be a few exceptions, for instance, for carts
that modified the Vic20's own inherent abilities; for example, 40 and 80
column boards. But the rule of thumb here is that 8k was the accepted
standard, with 4k and 16k at times. All of these cartridge
configurations, by the way, are using 8-bit memory because the Vic20 is
an 8-bit computer.
Inside a typical Vic20 cartridge is one double-sided, etched circuit
board, with some form of memory chip(s) on it. This may be a "standard"
IC chip as we are used to seeing (24 or 28 pin ROM, in a DIP package), or
it could be a blank circuit board, with a tiny blob of black epoxy
material on it, under which are presumably the internal components of a
typical, normal ROM chip.
The standard circuit board size is approximately 3 and 9/16ths inches
wide, and 1 and 3/4 inches deep. A cart fits into a 44-position, double-
sided card edge connector, located in the back, left hand side of the
Vic20.
On the cart circuit board itself, there might be several wire traces or
jumpers, which, if there, are meant to configure the cartridge to a
certain memory arrangement. These jumpers are meant to connect the BLK or
RAM lines to the system ground. These lines, when connected, tell the
Vic20 where to place the cartridge within the Vic20's internal memory
mapping scheme.
While all "normal," autostart game cartridges are located in one fixed
area of memory, this is not true with all cartridges. A rare few of the
total Vic20 cart collection did not use the autostart procedure; you had
to type in a systems number to start the program running after inserting
it. These are very rare, however (6 out of 150+ so far). Most cartridges
all autostart after insertion and power-up, just as cartridges do in game
console systems.
All this memory banking may seem confusing. If it does, remember this:
Every cartridge that autostarts must have at least one bank of memory in
Block 5, or the autostart procedure will not function. If it autostarts,
there has to be some memory in Block 5. That may help relieve some
confusion. There may be additional memory installed as well, in some
cases, for more storage space. The location of this additional memory is
less important than the location of the autostart bank. However, there
are only three additional 8k banks left, for a total of four banks of
user-added RAM or ROM memory. The Vic20 was built when memory was
expensive, and computers were designed to be bare-bones memory-wise with
the capability to expand on later. This may take some getting used to at
first, but understanding it gets easier in time. Take it in stride for
now.
@(A): The Cartridge Auto-Starting Feature
Please note that if you already understand the autostarting system used
in the Commodore 64, this is nearly identical in procedure. Only certain
codes and memory locations differ; the rest applies to both machines.
The "normal" spot for an 8K cartridge to be located in memory is in
"Block 5"(which is located at $A000 to $BFFF). Again, this is not the
only possible spot in memory for a cartridge to be located, but it is the
only spot where the Vic20 will look for a cartridge that automatically
starts on power-up. This is because (at power up) the Vic20 looks for a
precise code in a precise spot to see if it should autostart a cartridge
or not. If the Vic20 finds this EXACT five-byte code, EXACTLY where it is
supposed to be located in memory, the Vic20 turns control over to the
cartridge. If not, it gives over control to the user, via the normal,
power-up Basic READY prompt screen.
This 8K autostart sequence code is shown below:
Address Hex value Decimal value ASCII values
$A004 $41 65 Capitol "A"
$A005 $30 48 Digit "zero"
$A006 $C3 195 Reverse "C" character
$A007 $C2 194 Reverse "B" character
$A008 $CD 205 Reverse "M" character
(You may note that the code above is symbolically saying $A000, and
Commodore Business Machines. In other words, that this is the right
software, for the right machine. The C64 uses $8000 instead.)
If the computer finds this five-byte sequence exactly as shown, it turns
its control over to the machine language program in the cartridge. To do
so, it needs to know where the program begins. There are four bytes which
determine this, as shown in the chart below. Note that this is in the
cart, not the Vic20.
Address What this byte of information contains
$A000 Low-byte of 16-bit "cold start" address (power-up)
$A001 High-byte of 16-bit "cold start" address
$A002 Low-byte of 16-bit "warm start" address (restore key)
$A003 High-byte of 16-bit "warm start" address
Let's do a quick summary of this before we go on. You plug a cartridge
into the Vic20. You turn the power on. The Vic20 starts its own built-in
operating system software. It gets itself ready to be used, either by the
user (in BASIC) or by a cartridge's program.
One of the last steps in the computer's start-up sequence is to look at a
certain spot in memory, to see (A) if there is a cartridge inserted
there, and (B) if it is the proper type. It does both these tasks through
simple assumptions. Assuming that the existence of an autostart code
sequence at a certain memory address implies a cartridge is present, the
computer looks for the "A0CBM" code sequence. If it finds it, it then
transfers control to the locations specified at $A000-$A003, as defined
above. (In many cases, this address is $A009 or 40969 ... the next
byte possible after all the start-up codes.)
@(A): How to Archive Vic20 ROM Cartridges
Now that we know how the autostart process works, what can we do with
that information? Well, to archive a cartridge's internal ROM memory to
either tape or diskette, you have to know how the autostart process
works. This is necessary because you have to figure some way around it to
be able to get to that "no carts inserted" normal power-up screen. This
means that you then have full control of the machine, instead of the
cartridge being in full control.
Simply put, there are only two steps to archiving a cartridge from its
cart to disk or tape.
1. Find some method of defeating the autostart process, so that the
Vic20 powers up with the cartridge in memory, but does not start it up.
So that you are in control, instead of the cartridge running the show.
2. Copy that area in memory where the cartridge resides, to tape or
disk. The resulting program is called an "image" of the cartridge's
memory.
After that, assuming there is no copy-protection coded into the original,
you have a working version of the program stored on disk/tape instead of
on ROM.
Some problems may arise, but don't worry, they are easy to get around if
you know how to do it.
A. There may be more than one block of memory to copy. The one found at
Block 5 is easy, because if the cart auto-starts, there must be memory
that needs to be copied. However, additional memory may be present. You
will need to determine where it is, and how much of it there is.
B. Depending on how you transferred the image to disk (assume I mean
"disk or tape" from now on), was the loading address information stored
with the image? If it was you can reload it easily next time. Without
those two important address bytes (these are separate from those we
discussed earlier), the software won't load properly, and so will not
work.
OK, so now you're convinced its impossible, right? For every problem,
there is always a number of solutions. I wrote a small program that
eliminates most of the problems inherent in archiving carts, and have
figured out ways of eliminating most of the hassles. The program also
makes the process more reliable, since archiving rare and cool things is
the main idea. I'll make that program publicly available, soon, after a
bit of polishing.
But you still have to get around that auto-start procedure. Without doing
that first, you are dead in the water before you've even started. So,
here's how you get around the autostart procedure. After that, its all
downhill!
There are a number of suggested methods shown below. My suggestion is to
pick out the method you like best and stick with it. The rest will just
be to satisfy your built-in hacking curiosity, OK? Other methods exist
but I didn't feel they warranted the space here. These are some of the
best ways.
@(A)method1: Inserting a Cartridge Into a Powered Computer
Please pay attention to what I am about to say: this is the only method I
DO NOT recommend! I mention it mainly because it represents a very real
risk of killing your hard-to-replace Vic20 computer system. This is
supposed to be an exercise in keeping things alive and usable, not
killing more off! If you feel you want to try this, you do it at your own
risk!
I once knew a guy that wanted to archive Vic20 carts, but wasn't willing
to go to a lot of effort to find a good way to get around the autostart
feature. When he told me what he was doing, I tried to warn him. He kept
on doing it, saying he'd "just be careful." The next thing I know, he is
asking me how to repair a computer that died suddenly. I told him the
truth: (A) you don't, you go find and buy another one, and (B) you listen
to me the next time I tell you that you're risking your almost
irreplaceable hardware.
If that didn't convince you, well, I tried. There are better methods, by
far! If you can't find a better one than this, pay someone to modify your
Vic20, or just loan the cart in question to someone who is more used to
doing this!
@(A)method2: Altering Your Computer's Operating System ROM
What this method does is change the copy of the code to check for, inside
the Vic20, so that no cartridge's unaltered code ever matches it. So no
autostart.
No cart will ever match the modified start-up code in your new operating
system, so none will ever be seen as a cart. However, having one of these
chips installed permanently could be a bad idea, as you cannot test or
start your saved images quite as easily. The image won't autostart
either, unless you are willing to keep swapping chips back and forth, or
unless you know how to decode the starting addresses and type in systems
numbers.
This is an elegant way to solve the problem, providing you possess tools
to read and program EPROM ICs and can obtain replacement ICs that
are pin-compatible. Thus, the elegant solution requires a substantial
amount of resources.
However, one chip does exist, which is expensive if you buy it new, and
may be hard to find as well. (Try posting to "comp.sys.cbm.") If you can
find a Motorola 68764 chip, you're almost there! Just copy the Kernal rom
to disk, modify the "A0CBM" code found there to be anything but that, and
burn a new EPROM of your modified Kernal rom. The manual to the Promenade
EPROM-writing machine makes programming these chips a snap. And the
Promenade is still available today, from it makers, Jason-Ranheim Co.
(Phone: 916-878-0785, or 1-800-421-7731.) These same 68764 chips work
with C64's internals, too.
This does work. It has the advantage of requiring no modifications to
your Vic20 which can't be easily reversed. Before I got tired of swapping
Kernal chips back and forth, this was my preferred method of archiving
cartridges.
@(A)method3: Using a Cartridge Port Epander
I've come to feel that a plug-in board is the best way to modify things
just long enough to get past the start-up process, skip the autoboot
phase, and get down to business. If you can find one, buy it! It makes
life so much easier and nicer, in more ways than just this one. I highly
recommend buying one.
Basically, this device lets you plug in lots of carts at once, and with
just a button press, decide which one to use at any given time. Well,
that switch is all you need! Just (A) turn the computer off and insert a
cartridge, (B) make sure all the switches are de-activated, (C) turn the
computer on. You should now be looking at a normal, BASIC power-up
screen. Now (D) press the button that activates the slot that your
cartridge is plugged into, so that the cartridge is now mapped into
memory properly, although belatedly, and (E) follow the instructions in
the next part of this text, to archive the cart.
Note that you can modify your Vic20 to do the same thing if you are handy
with a soldering iron. But as I don't want anyone killing their only
Vic20, maybe I'll save that for another article ... this one is almost at
deadline, and I don't want to rush things and make any mistakes!(Besides,
I don't know yet if anyone is interested enough to modify their Vic20's
to do this??)
@(A): Saving One or More Blocks of cartridge Memory to Disk or Tape
Once you've defeated the auto-start feature of the Vic20, the memory
contained in the cartridge is just another block of memory as far as the
Vic20 is concerned. You have full access privileges, with all that goes
with it, including the ability to save it to external storage.
You have three basic choices to save the block of memory to tape/disk.
You can either (A) wait until I release my program that does it
automatically, or (B) use a "memory save" feature of a machine language
monitor program (not built in) to save the 8K block of ROM memory, or you
can (C) just change four POKE's in the Vic20's memory. With this, your
cartridge is seen as if it were in the BASIC program memory area so that
the built-in "SAVE" command works.
It really works. The beauty of it all is that no additional programs are
needed. To save any block of cartridge-usable memory in the Vic20, just
type in four easy POKE commands, then tell the Vic to SAVE the program as
it would normally save any BASIC program. (You can even copy the system
ROMs that way, if you want to.)
For those of you already familiar enough with Commodore's style and
memory arrangement schemes to make sense of this, bytes 43 and 44
(decimal, not hex) are the pointers to the Start of Basic memory area,
and bytes 45 and 46 are the pointers to the Start of Variables, or in
other words, the End of Basic. Follow this chart, to save a block of
memory from these areas via pokes:
Block # Hex Address Poke 43,x Poke 44,x Poke 45,x Poke 46,x
5 $a000-bfff x = 0 x = 160 x = 0 x = 192
3 $6000-7fff x = 0 x = 96 x = 0 x = 128
2 $4000-5fff x = 0 x = 64 x = 0 x = 96
1 $2000-3fff x = 0 x = 32 x = 0 x = 64
Here's an example: to save block 5 (the most commonly used memory block)
you do the following steps.
0. Follow the previous instructions, to get to this point. (The
cartridge has been inserted, power is now turned on, and the autostart
has been defeated. The Vic20 is showing you its normal BASIC power-up
screen.)
1. Type the following, hitting RETURN after each line. (Type
carefully!)
POKE 43,0 (and return)
POKE 44,160 (and return)
POKE 45,0 (and return)
POKE 46,192 (and return)
SAVE "FILENAME.EXT",8 (and return)
2. Wait for the disk drive to finish its saving process. (Be patient.)
3. If you have more 8k blocks to copy, repeat all the previous steps,
but adjust the POKE statements, according to the information in the
chart. Note that the pokes to 43 and 45 are always zero; even page
increments. Also, note that the computer will get confused or lock up if
you try to copy another block of memory without starting completely over.
4. When the busy light turns off again, turn the Vic20's power back
off. Remove the cartridge, and if you have a modified 8k or 16k RAM
expander insert it or activate it. If you have a 32k RAM expander, you
can use it.
5. Load the disk's directory up, (or rewind the tape), and see if the
file has been properly saved to the disk. It should show a file size of
33 blocks, if all has gone well ... 32 blocks x 256 bytes each = 8k, plus
one block for the disk drive's overhead and the file loading address.
6. If everything looks fine so far, just load the newly created "image"
into RAM memory, to see if it runs. Remember a few tips: as with the C64,
you always have to use the ,8,1 loading conventions for any machine
language program to reload into memory back where it came from.
Also, to properly load up an image that has more than one 8k bank, you
will have to type NEW after each load to reset some memory pointers.
Otherwise, it moves BASIC to where the cart now is and gets confused. So
multi-loads are: (A) LOAD"file1",8,1 (B) NEW (C) LOAD"file2",8,1
7. The last step is starting up the image, to see it in all its new
glory! To do this, all you have to do is (A) press the reset button
you've installed yourself, or if you don't have one installed, (B) type
the following "reset" command into the computer... SYS 64802 (and
return).
8. At this point, your image is probably running. If it is not,
carefully recheck all the previous instructions. You may have made a
mistake or two there, somewhere. (One mistake I have often made is to
forget to re-activate the expansion chassis' slot, and essentially save
empty air.)
@(A): Troubleshooting
But if you recheck everything, and it STILL doesn't work, try archiving
another cartridge. If the first does not work, but the second one does,
you have likely found one of the few protected carts out there. How to
"break" the copy protection is way out of the scope of this article, so I
can't help you there! Sorry. But usually, everything will be fine by now,
if you've followed the instructions carefully, step-by-step. Only about
10% of the VIC-20 cartridges were copy protected.
=========================================================================
@(#)next: The Next Hack
What? Why are you reading this? Aren't you happy with the issue you
have? We walked through the snow with no shoes uphill both ways to
deliver this to you and you are still asking for more? Have you even
read the issue you have in your hot little hands? Demanding reader,
aren't you. OK, here's what's coming up:
o We continually receive comments from folks trying to learn ML
programming. They have copies of C=Hacking in hand, but lament that
the concepts are too advanced for them. Well, next time we'll review
some resources for the beginning ML programmer. Two of them, _Coder's
World_ and _Bonkers_ are organized in publication format and go
over many of the details that every ML programmer must learn.
o We're not sure which one will get here first, but Frank Kontros
is writing up some of his impressive hardware and software projects
as we write. It might be the EPROM programmer, the Digital I/O
board, or one of his many software exploits. WE'll spotlight one
next time.
o For many years, Commodore 64/128 users have been able to purchase
stereo SID cartridges like the SID Symphony by CMD. However, there's
not an overabundance of games or applications that take advantage
of the second SID. Frank Kontros overcomes that problem in a non-
obvious way by showing how to build a "pseudo'stereo" adaptor for
your C64 or 128. The effect is noticeable and it requires no programming
changes.
o And, of course, C=Hacking's regular goodies.
Now, go back and re-read those articles. We need some sleep....
=========================================================================
@(#)code: Hacking the Code
Being a technical, developer oriented magazine, some articles featured
in C=H include executables or other binary files as part of the article.
All such binary files are included on the soft copy of this issue in this
section. In an effort to retain the integrity of such binary files through
distribution over various computer networks, the binaries in this section
have been encoded using the UUcode format, a popular Internet
binary-to-readable text encoding method. In order to execute or otherwise
utilize these binary files, one must feed this section of the magazine
to a UUdecoding application. Typical examples include UUXFER for the 64,
uudecode on the ACE OS for the 64 and 128, and uudecode on most UNIX OS
machines. Some encoders can decode multiple files, while others will
require the user to manually split this section into individual pieces
prior to decoding.
In addition to this section, there are other ways to retrieve the
binary files featured in this issue. For those with World Wide Web
access, the files are available at http://www.msen.com/~brain/pub/
To retrieve "dim4.lnx", simply access the URL:
http://www.msen.com/~brain/pub/dim4.lnx
For those with electronic mail access only, the Commodore Hacking
MAILSERV server also contains a copy of these files. To retrieve a
copy of "dim4.lnx", send the following email message:
To: brain@mail.msen.com
Subject: MAILSERV
Body of Message:
send dim4.lnx
help
quit
For some articles published in Commodore, the author or authors may also
have other methods for accessing files mentioned in the article. These
methods are described in the respective article.
Commodore Hacking always attempts to provide the reader with as many
options as possible to retrieve uncorrupted binary files. Although none
of these above methods is foolproof, the added redundancy helps overcome
any shortcomings.
WARNING: The UUCode format translates files from binary to ASCII, not
PETSCII. Therefore, either decode this section before downloading this
section to a PETSCII mode computer system, or download this section without
translation to PETSCII. Some decoder programs can handle PETSCII converted
UUCode files, but the practice is not recommended because conversion is
typically done in a telecommunications program and accuracy in
translation cannot be guaranteed.
@(A)menucode1: Menu Toolbox at $1000 (4096)
begin 644 mbox1000.bin
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
M```````````````````````````````````````!`>\O````````````````
M````````````````````````````````````````````````````````````
M`````````````````````````````````0$!``````!4````````````````
M`````````0\)#@(&``4)"P(`"P4&#`````````````````````````!?:0$"
M#PP")!<7`R46%J`#P]+3TB_2Q=35TLX@U$\@TT5,14-4````````````````
M````````````!P$```$/`P,$`````````````````````*`#```G`!@#`28!
M%U]I`PX"(P,%`R0"!`$$(P,#H`$`````````````````````````````````
M````````````````````````````````````````````````````````````
M````````````````````````````````````````````````````````````
M````````````````````````````````````````````````````````````
M````````````````````````````````````````````````````````````
M`````````````$*))!I8))%"B'-P<(AG!P>!&!AF9A@8@8!D1@@08B8!!Q@@
M,`P$&.`D),,8&,,D)%6J5:I5JE6JS#/,,\PSS#-F@68\9H%F/%K;&.?G&-M:
M$1$B(D1$B(@1$2(R3$2(B,`P#`/`,`P#P#`,"]`P#`,1$:JJ1$2JJO5$1$!?
M1$0$B%`@4(@```"J5:I5JE6J5:JJJJI55555`@H(*""@@((!`0$"`@49X0$"
M'.`!`AS@B!$B1(A$(A$B1(A$(D2(1`000@@A!!``0*1*!"!2)0)!(A2(%")!
M"$$JE"*4*D$4@1@89F88&($!)F(0"$9D@(/&;#@8#`8#*!""1((0*`#=$7=$
MW1%W1`Q@`QC`!C"!4HA2`"6()0`4$LDDDT@H*!ADK()J3#``_\#>WL;V]@9T
M(A>[<2)'[G6NU;I7ZEVKP]L8?GX8V\.`1`@0($0"`?__________`1$0?!`1
M`<<1$1'^$1$1[_]@9F9F9F8&P_`\#\/P/`\0.$2"`8)$.(1F2!`DS$(!<(@'
M`'"(!P`B290B22*42:2DI*1*2DI*$43N1!%$[D0!;6T0;6TY%,%8],0X],!I=,AI!,
M,9%,WY5,=IA,?9A,"9M,%IM,'9M,TX%,SX!,3(%,O81,$H-,<8-,.X-,6(-,
ME(-,G(-,^X-,/81,FX1,'(M,+8M,/HM,3XM,RX1,]H1,!X5,&(5,(85,*(5,
M7(5,>(5,B(5,K85,.H9,P(9,Q(9,!X=,$(=,%X=,&H=,;H=,@H=,BX=,EH=,
MO8=,PX=,R8=,TH=,YX=,]H=,$8A,)HE,3XA,[XHX(/#_CLJ<C,F<(-V+A/R8
MP`2P`6`8:02%_JD`A?V%^ZD3(-+_(`6/>*D`A0&B`Z``L=&1^\8!L?/F`9']
MR-#QYM+F_.;TYO[*$.;&_J#IQ@&M(-#F`9']R,8!K2'0Y@&1_<BMRIR1_<BM
MR9R1_:EWA0%8KLJ<K,F<&$SP_ZD`C:J<(-V+A/R8&&D$A?ZI`(7]A?NI$R#2
M_R`%CWBI`(4!H@.@`+'1C5"<+*J<$`FM4)PIO\D@T`RQ^Y'1L?W&`9'SY@'(
MT-[FTN;\YO3F_LH0T\;^+*J<,!^@Z;']Q@&-(-#(Y@&Q_<8!C2'0Y@'(L?V%
MULBQ_873J7>%`:D`C:J<6$QLY:D`A?V%_HU0G(W$G"#=BYBL4)R9HYSN4)S`
M!=#O(*B-R1F0`JD9C<6<H`"Q(IEFG,C,Q9S0]2"]A*ZCG*``C+N<&"#P_R`%
MCZVHG(V\G"#<@B#D__#[H@"-Q)RNNYR.4)S)$?`0R9'P'R#U@LD-\"_0`$PD
M@NZ[G*V[G,VFG-!2J0"-NYQ,I8+.NYRMNYS)__`#3*6"K*:<B(R[G$RE@JW$
MG/`&K5"<3(""K;N<&&VCG*J@`"#P_R`%CZVGG(V\G"#<@JV[G!AI`87]J0"%
M_DPJD*VCG!AMNYRJH``8(/#_(`6/K:B<C;R<(-R"K:.<&&U0G*J@`!@@\/\@
M!8^MIYR-O)P@W(),)(*LI)RMO)R1\S`&L=%)@)'1R,REG/#MD.M@JIA(H`"*
MV6:<T`B,NYRB#8[$G,C,Q9S0[6BHBF`@O80@W8N$TR#=BX36(&SE(*B-C5"<
MK5"<\`V@`+$B(-+_R,Q0G-#U8""HC<D`\!6-4)R@`+$BR4&0!`F`D2+(S%"<
MT/!@(*B-C5"<R0#P#J``L2(I?Y$BR,Q0G-#T8"#=BYBJH``8(/#_(*B-C5"<
M2HW$G*D4..W$G(73(&SE3"B#J?^-JIQ,48$@W8N,QIP@W8N,QYP@W8N,R)P
@
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
M````````````````````````````````````````````````````````````
M`````````````````````````````````0$!``````!4````````````````
M`````````0\)#@(&``4)"P(`"P4&#`````````````````````````!?:0$"
M#PP")!<7`R46%J`#P]+3TB_2Q=35TLX@U$\@TT5,14-4````````````````
M````````````!P$```$/`P,$`````````````````````*`#```G`!@#`28!
M%U]I`PX"(P,%`R0"!`$$(P,#H`$`````````````````````````````````
M````````````````````````````````````````````````````````````
M````````````````````````````````````````````````````````````
M````````````````````````````````````````````````````````````
M````````````````````````````````````````````````````````````
M`````````````$*))!I8))%"B'-P<(AG!P>!&!AF9A@8@8!D1@@08B8!!Q@@
M,`P$&.`D),,8&,,D)%6J5:I5JE6JS#/,,\PSS#-F@68\9H%F/%K;&.?G&-M:
M$1$B(D1$B(@1$2(R3$2(B,`P#`/`,`P#P#`,"]`P#`,1$:JJ1$2JJO5$1$!?
M1$0$B%`@4(@```"J5:I5JE6J5:JJJJI55555`@H(*""@@((!`0$"`@49X0$"
M'.`!`AS@B!$B1(A$(A$B1(A$(D2(1`000@@A!!``0*1*!"!2)0)!(A2(%")!
M"$$JE"*4*D$4@1@89F88&($!)F(0"$9D@(/&;#@8#`8#*!""1((0*`#=$7=$
MW1%W1`Q@`QC`!C"!4HA2`"6()0`4$LDDDT@H*!ADK()J3#``_\#>WL;V]@9T
M(A>[<2)'[G6NU;I7ZEVKP]L8?GX8V\.`1`@0($0"`?__________`1$0?!`1
M`<<1$1'^$1$1[_]@9F9F9F8&P_`\#\/P/`\0.$2"`8)$.(1F2!`DS$(!<(@'
M`'"(!P`B290B22*42:2DI*1*2DI*$43N1!%$[D0!;6T0;6T
