Main
Menu
Installation and Configuration
HyperLink 2.5e is compatible with both the 64, and the 128 in its native
mode. You can boot it in either configuration. On the 128 in native mode,
HyperLink can use the fast-serial capabilities of your 1571, 1581 or 100%
compatible clone disk drive to boot nearly three times faster.
Booting HyperLink on the C64 (or C128 in C64 mode)
-
Insert the HL disk into any disk drive and type LOAD"CWI",D,1 where
D is your disk drive's device number (example: LOAD"CWI",8,1).
- If this is the first time you have started HyperLink, the Configure
program will automatically start. Subsequent times, the booter will load
the main program.
Booting HyperLink on the C128
The 128 bootloader does not support booting from a CMD RAMLink.
You must boot in 64 mode to boot HyperLink properly from a CMD RAMLink.
- If you are booting from device 8, or from the internal disk drive of
a 128D or 128DCR, insert the disk into the disk drive, and turn on the
128. The disk will autostart. (If it does not autostart, see the Troubleshooting section.)
Otherwise, if you are booting from a device number other than 8, turn on
the 128 with device 8 (or the internal drive on 128D or 128DCR systems)
empty. Insert the disk into the desired drive and type BOOT UD
where D is your disk drive's device number (example: BOOT U9).
The disk will autostart. (If it does not autostart, see the Troubleshooting section.)
- If this is the first time you have started HyperLink, the Configure
program will automatically start. Subsequent times, the booter will load
the main program.
Setting up HyperLink using Configure
The Configure program allows you to tell HyperLink what devices you have
defined and to properly set them up for HyperLink. Configure works in both
64 and 128 modes.
Follow the prompts
on the screen. If you make a mistake, you can back up a section by pressing
F7. Most options are chosen with F1 or F3.
-
After the initial screens,
Configure will ask you if you want to use a mouse or joystick. If you have
a joystick or a 1350 mouse, select joystick and make sure it is
plugged into port 2. If you have a 1351 or true 1351 compatible proportional
mouse, select mouse and make sure it is plugged into port 1.
-
Tell HyperLink what type of cache you would like to use. You may
choose from geoRAM, REU or VDC.
If you have
an REU (1700, 1750, 1764, CMD XL, or 100% compatible REU clone) plugged into
your cartridge port, select REU.
If you have a geoRAM expansion in your cartridge port, select geoRAM. REUs and
geoRAMs must have minimum 128K available, and HyperLink assumes their control
registers map to $DFxx (the default configuration).
If you decide to use VDC memory, you must also choose either a 16K VDC or
64K VDC configuration. If you have a 128DCR (most American 128D models)
or an expanded flat 128 with 4464 RAM chips for 64K of VDC memory, choose
64K VDC. All other 128s, including European 128Ds, should choose 16K VDC.
(If you're not sure, choose 16K.) HyperLink's VDC
memory access library will not work properly with a SuperCPU v1 without
modification. If you have a factory-original SCPU v1 without modification,
you cannot use VDC as cache.
If you have a regular C64 or 64C with
no cartridge RAM expansion of any kind, indicate you will be not using cache.
You may not use multiple types of cache simultaneously, so select the cache
device that gives you the largest amount of space.
-
Configure will then ask what modem device you intend to use for HyperLink.
If you have a modem or null-modem connected to a CMD SwiftLink, Turbo232 or compatible
ACIA cartridge installed in the computer's expansion port, select SwiftLink
or compatible. If you do not intend to use a modem, or do not have a SwiftLink,
you must select Offline (or No SwiftLink).
The earliest version, HyperLink 2.5, could use 1200bps user port modems to
access the Net. This was
undocumented and unsupported, but did work on many NTSC systems. Version 2.5a
completely removed this code, and it is no longer in 2.5a or 2.5e. If you wish
to continue using your 1200bps modem,
you must use the original 2.5. No technical support is furnished for
users of 1200bps mode through the user port.
-
Select the speed you want to drive the ACIA cartridge at. HyperLink
supports speeds from 1200bps to 57.6kbps regardless of whether or not you
have a CMD SuperCPU accelerator installed. You can select speeds that are
faster than your modem; your modem will connect to your server at the fastest
rate available. 57.6kbps is only supported with true Turbo232 devices;
SwiftLinks are limited to 38.4kbps or slower.
-
Select the I/O address of your ACIA cartridge. HyperLink assumes you are
using a 6551 ACIA, which is the chip in the SwiftLink and Turbo232 and
100% compatible clones. Most
cartridges are set to $DE00. If your cartridge has been modified to use
$DF00, or you are using a port expander that has remapped your cartridge
to $DF00, select that option instead.
-
HyperLink will then confirm and complete your settings, and then allow
you to boot the main program. From then on, whenever you boot HyperLink,
the main program will come up instead of Configure.
Making Changes To Your Configuration
If your configuration causes HyperLink to crash, or the program will not
start, you may need to re-run Configure. Also,
you must run Configure again if you change your modem setup or cache
setup in any way, or HyperLink may behave adversely.
-
If you are booting from a C64, or from a 128 in C64 mode,
type LOAD"CONFIGURE",D,1 where D is your disk drive's device number.
- If you are booting from a 128, hold down the SHIFT key once you see the
message, BOOTING HYPERLINK ...
The Configure program will then be restarted and you can alter your system
configuration.
Setting up HLPP
This section only applies to people using HyperLink
for accessing the Internet. If you will
not be using HL for Internet access, you may skip this section.
HyperLink uses a special program called HLPP (the HyperLink Parsing
Proxy) to connect to the Internet. It does not use regular SLIP or PPP,
but requires a dial-up shell account and Perl 5.0 or higher. In most cases,
you can install HLPP without assistance from your system administrator.
Certain additional utilities may be needed to view images.
VideoCam users! If you use VideoCam as your Commodore shell provider,
HLPP is already installed on your system! You can skip this section.
There are two ways to set up HLPP. If you are unfamiliar with Unix commands,
and have a terminal program that supports uploads to your shell account,
you may use this method. Your server must have Lynx for this to operate.
-
Upload the program installhlpp (on your HyperLink disk) to your
shell account or Unix null-modem server
according to the procedures required for your terminal program
and your Unix server. Refer to your documentation or the technical support
desk of your provider if you need help. The transfer must be binary, not
ASCII (Xmodem, Ymodem and Zmodem will do this correctly; if you use Kermit,
make sure the file type is binary).
Alternatively, you may also download installhlpp from
ftp://ftp.armory.com/pub/user/spectre/UNIX/installhlpp.
-
At your shell prompt, type csh installhlpp
-
The installhlpp utility will check to see if your ISP supports the
features required by HLPP, and then will attempt to contact the Computer
Workshops server and download and install HLPP for you. Follow the prompts
it displays. If it fails, or if you get error messages, try the steps below
or contact Computer Workshops technical support.
If you are experienced with Unix, you may wish to download hlpp
manually from ftp://ftp.armory.com/pub/user/spectre/HL25/hlpp
. Make sure you make it executable with chmod u+x hlpp and run its
built-in self-test with ./hlpp -test to see if it properly detects
any installed helpers and is able to find all its modules. If this test
fails, try using installhlpp or contact Computer Workshops for technical
support.
You must do these steps once for any server you use HLPP on. Once installed,
you are ready to use HyperLink in web browser mode.
HLPP also requires helper applications to assist it in converting JPEG, TIFF
(HLPP version 1.1 and later only),
and GIF images into equivalents your Commodore can view. These are not
necessary to browse the web, but you will be unable to display images without
them. The HLPP installation process will tell you if you are missing a
helper application. For JPEG images, the djpeg utility is required.
For GIF and TIFF images, the Netpbm toolkit is required. To get these applications,
ask your system administrator or your ISP's technical support desk.
It is recommended that you periodically re-run the installhlpp script to check that you
have the most current version of HLPP installed on your system.