259 lines
11 KiB
Plaintext
259 lines
11 KiB
Plaintext
ToneLoc v0.97 Reference Manual
|
|
|
|
by
|
|
|
|
Minor Threat & Mucho Maas
|
|
|
|
This is the reference manual. You should read this AFTER reading
|
|
TL-USER.DOC unless:
|
|
|
|
1. You are already familiar with Toneloc -or-
|
|
2. You want to get started quickly
|
|
|
|
|
|
------------------------
|
|
COMMAND LINE OPTIONS
|
|
------------------------
|
|
|
|
Here are the command line options for ToneLoc:
|
|
|
|
Toneloc [DataFile] /M[Mask] /X[ExMask] /R[Range] /D[ExRange] /C[Config]
|
|
/S[StartTime] /E[EndTime] /H[Hours] /Q /T[-] /K[-]
|
|
|
|
ToneLoc must ALWAYS be run with at least one parameter, and if you
|
|
only use one parameter it MUST be the dialing mask to use. If you only
|
|
give ToneLoc one parameter, the first 8 characters of the dialing mask
|
|
will also be the data file name. So if you run "TONELOC 555-XXXX", the
|
|
mask will be 555-XXXX and the data file will be 555-XXXX.DAT.
|
|
|
|
/M - Dial Mask. Use this parameter if you want to use a data file-
|
|
name other than your dialing mask.
|
|
|
|
/X - Exclude dial mask. This tells ToneLoc to -NOT- dial certain
|
|
numbers. For example, if your local Police department has
|
|
phone numbers ranging from 555-5000 to 555-5099, and you were
|
|
using the dial mask 555-5XXX, use the exclude mask 50XX. This
|
|
mask applies to the active part of the dial mask (in this case
|
|
5XXX) and therefore should be no more than 4 characters long.
|
|
If an exclusion mask is longer than 4 characters, ToneLoc will
|
|
ignore it. All exclusions must be sub-sets of the dialing mask.
|
|
|
|
/C - Config File. This tells toneloc to use an alternate config
|
|
file. The default is TONELOC.CFG, but you may change this for
|
|
different types of scans. You might want to set up different
|
|
config files for different kinds of scanning or for different
|
|
kinds of modems.
|
|
|
|
/S - StartTime. Tells ToneLoc to wait until a certain time to begin.
|
|
You may either use military time or end the time with a "p" for
|
|
P.M. Example: 5:30p and 17:30 are the same.
|
|
|
|
/E - EndTime. Tells ToneLoc to STOP dialing at a certain time. Use
|
|
the same notation as the /S parameter above.
|
|
|
|
/H - Hours. Tells ToneLoc to dial for a certain number of hours
|
|
after starting, and then exit. "/H5:30" would mean 5 hours,
|
|
30 minutes.
|
|
|
|
/Q - Quiet. Tells Toneloc to suppress all sound. The speaker
|
|
and all sounds will be turned off.
|
|
|
|
/T - Sets the scan mode to look for tones, overriding whatever is
|
|
specified in the config file. /T- will look for everything
|
|
>except< tones.
|
|
|
|
/K - Sets the scan mode to look for carriers, overriding whatever is
|
|
specified in the config file. /K- will look for everything
|
|
>except< carriers.
|
|
|
|
These parameters may appear in any order, EXCEPT the first parameter
|
|
MUST always be the datafile, and if you do not specify a dial mask with
|
|
/M it MUST ALSO be the mask.
|
|
|
|
-----------------
|
|
WHILE DIALING
|
|
-----------------
|
|
|
|
While ToneLoc is scanning, there are several keys that do various
|
|
things. Here they are:
|
|
|
|
J - Pressing 'J' will Jump to a DOS shell. Upon returning,
|
|
ToneLoc will redial the last number.
|
|
|
|
N - This will "Note" the current number by putting a special entry
|
|
in the logfile. It looks like this: "* Noted *". Use this if
|
|
you want to remember this number for later.
|
|
|
|
R - This will redial the current number.
|
|
|
|
S - This toggles the modem speaker ON or OFF while dialing.
|
|
Toneloc will play a noise to indicate the status of the speaker
|
|
if sound is enabled. Once the current dial is finished the speaker
|
|
will be toggled.
|
|
|
|
X - This will extend the current dial time by 5 seconds. The
|
|
meter will reflect the time addition.
|
|
|
|
0-9 - These are the modem volume changing keys. They will send
|
|
the corresponding string in the config file to the modem. They
|
|
work like 'S'.
|
|
|
|
! - This will write the file SNAPSHOT.DAT to the current directory.
|
|
Exclude ranges will NOT be cleared from this .DAT file, so it
|
|
can used to debug exclude ranges with Tonemap or Tlog.
|
|
|
|
[Escape] - Pressing Escape will abort the current number and
|
|
exit ToneLoc.
|
|
|
|
----------------------
|
|
CONFIGURATION FILE
|
|
----------------------
|
|
|
|
ToneLoc uses a configuration file. Before running ToneLoc, you
|
|
need to edit this config file for your setup. The config file has
|
|
a little bit of help in it, so it should be self-explanatory. But just
|
|
in case, here's an explanation of each keyword in the configuration file.
|
|
|
|
Port - This is which COM port to use. ToneLoc has been tested
|
|
on COM1 - COM4 successfully. It should, theoretically,
|
|
work up to COM16. See your FOSSIL documentation for details.
|
|
|
|
Baud - This is the baud rate at which ToneLoc communicates with the
|
|
modem. For a USRobotics HST or Dual Standard, it should be
|
|
38400. (No commas allowed). If you have problems with
|
|
dropped characters, lower this to 19200 or 9600.
|
|
|
|
Speaker - This tells if the modem speaker should start ON or OFF.
|
|
The word "On" or "Off" should follow "Speaker". You may
|
|
toggle the speaker while dialing by pressing 'S'.
|
|
|
|
FoundSound - ToneLoc can make a noise when it finds something -
|
|
if you want this enabled set it to 1.
|
|
|
|
Sound - ToneLoc can makes noises for speaker toggles and volume
|
|
changes. If you want to hear these sounds, set this to 1.
|
|
|
|
InitString - This is the string that is sent to the modem when
|
|
ToneLoc is first run. Usually this is ATZ. You may need to
|
|
send other parameters like X7, &N1, etc. Use the characters
|
|
| for [Enter] and ~ (tilde) for a 0.5 second delay.
|
|
|
|
InitResponse - ToneLoc checks for this after initializing the modem.
|
|
If the modem doesn't send this back, toneloc will try to
|
|
initialize the modem up to 3 times. If it doesn't work,
|
|
ToneLoc exits.
|
|
|
|
DialString - This is the string to dial the modem. Usually "ATDT".
|
|
If you need to dial *70 to disable call waiting, for example,
|
|
add it here like "ATDT*70". Or if you need to dial "9" first,
|
|
put it here.
|
|
|
|
SpeakOn - String to send to the modem that turns the speaker ON.
|
|
Usually "ATM1" or "ATM3".
|
|
|
|
SpeakOff - Same as above, but to turn the speaker off. Usually "ATM0"
|
|
|
|
Volume0-Volume7 - Strings that adjust the volume of the modem while
|
|
dialing. Press '0' - '7' while dialing to adjust the modem
|
|
volume. You could also use these as other macros besides
|
|
volume.
|
|
|
|
Hangup - String that tells the modem to hang up. Usually "ATH0"
|
|
|
|
LogFile - File that toneloc logs it's activity to. Usually TONE.LOG
|
|
|
|
CommandDelay - Delay between modem commands. Usually 200 or so.
|
|
|
|
BetweenDelay - Delay between dial attempts. If you have 3-way
|
|
calling, you'll need to set this to a higher number.
|
|
|
|
BetweenWipe - How to 'wipe' the meter between calls.
|
|
1 = Ends to Middle
|
|
2 = Middle to Ends
|
|
3 = Backwards
|
|
4 = No wipe
|
|
|
|
WaitDelay - How many milliseconds to allow each dial attempt before
|
|
hanging up and trying the next number. Could be anywhere
|
|
from 16000-45000; you'll have to experiment.
|
|
|
|
NoDupes - This tells toneloc to never dial the same number twice
|
|
within a dial mask. This should usually be on.
|
|
|
|
MaxRing - This tells ToneLoc to abort the current dial after a
|
|
certain number of rings. If set to 0 ToneLoc will not abort
|
|
on rings.
|
|
|
|
ScanType - Tells ToneLoc to scan for either Tones or Carriers, or
|
|
everything except Tones or Carriers.
|
|
0 = Tones
|
|
1 = Carriers
|
|
2 = Everything except tones
|
|
3 = Everything except carriers
|
|
|
|
IgnoreCD - If your modem always sets Carrier Detect (CD) as TRUE
|
|
turn this on. Otherwise, turn it off.
|
|
|
|
AutoSave - This is the number of minutes ToneLoc should wait
|
|
between automatic backups of the .dat file. If set to 0 it
|
|
will only save on exit.
|
|
|
|
FoundFile - This is the name of the file where ToneLoc should store
|
|
the found numbers (tones or carriers.)
|
|
|
|
Blacklist - This is a file containing numbers you don't want ToneLoc
|
|
to dial. You could put in your own numbers, your friend's
|
|
numbers, the police department, etc.
|
|
|
|
Random/Forward/Backward - ToneLoc's default mode is to dial numbers
|
|
randomly without duplication, but it can also dial forwards
|
|
and backwards sequentially. Set this to the keyword you want.
|
|
|
|
Logging - This sets whether ToneLoc should keep a log file or not.
|
|
|
|
-----------------
|
|
DESQview INFO
|
|
-----------------
|
|
|
|
ToneLoc runs most excellently under DESQview. It will detect
|
|
DESQview, and if DESQview is found, screen writes are directed to the
|
|
screen buffer so your screen isn't trashed. ToneLoc also releases
|
|
unneeded timeslices to DESQview. Because of this, ToneLoc uses VERY
|
|
LITTLE CPU time, so you can run it in background with minimal slowdown.
|
|
I tested ToneLoc with two windows open. One was a DOS window sitting
|
|
at the prompt idle (doing nothing). The other was ToneLoc scanning.
|
|
ToneLoc used about 10% of the CPU time, and the idle DOS window used
|
|
about 88% (with about 2% DESQview overhead).
|
|
The file "TL-PIF.DVP" is included with ToneLoc. To add ToneLoc
|
|
to your DESQview setup, do the following:
|
|
|
|
1. Run DESQview
|
|
2. Choose "Add a Program"
|
|
3. Type 'O' for other
|
|
4. Enter the path where ToneLoc is found
|
|
5. Move the cursor bar to "ToneLoc" and hit [Space Bar]
|
|
6. Press [Enter].
|
|
|
|
ToneLoc will be added to the list of applications on your DESQview menu.
|
|
To run ToneLoc, choose "TL" from the application menu. You will be placed
|
|
at the DOS prompt with "ToneLoc " already typed. Just finish the command
|
|
line and press enter.
|
|
|
|
---------------
|
|
FOSSIL INFO
|
|
---------------
|
|
|
|
ToneLoc also requires a FOSSIL driver. The two most popular are
|
|
called X00 and BNU. Just call your local PD board and search for
|
|
"FOSSIL", "BNU", and "X00". We like BNU because it is 7K and can be
|
|
unloaded from memory. New versions of X00 may also be unloaded, but
|
|
it requires more RAM. Both may be loaded HIGH if you're using QEMM-386.
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
If this doc file sucks, please us know.
|
|
|
|
-- Minor Threat
|
|
-- Mucho Maas
|
|
|