

        TACLog Windows (32 bit) Voice Keyer - TACLog WVK

                        Version 1,20

          TACLog by OZ2M   http://www.qsl.net/oz2m


INTRODUCTION
============
The TACLog WVK is a TACLog CW and Voice Message utility that 
may be used in Windows 95/98 only. Not Windows NT.

When WVK is running, and TACLog is running in a DOS box and 
properly set-up, TACLog can play .WAV files using any sound 
card supported by Windows, not just Sound Blaster cards.

Besides being able to use all sound cards the TACLog WVK also 
gives you full access to TACLog while executing the message.

Note: The TACLog WVK cannot be used in Windows 3. It is also 
recommended that the PC runs at 200 MHz or more. If not timing 
inaccuracy may occur.

INSTALLATION
============
Copy the WVK.* files to the TACLog UTILITY sub-directory, e.g. 
C:\TACLOG\UTILITY.

In TACLog set Message Mode 3 (MAIN MENU 5,2).

SET-UP
------
The set-up of TACLog WVK is controlled via the WVK.INI file, 
locate in the same directory as WVK.EXE:

[Initialize]
!
! Delay in ms between PTT is activated and message
! is executed.
TXDelayOn=250
!
! Delay in ms between message end and PTT is deactivated.
TXDelayOff=250
!
! Interface Mode:
! 0 = none.
! 1 = serial port (TACBox 1 interface type).
! 2 = parallel port.
! 3 = invalid (used for the FodTrack interface).
! 4 = TACBox 2 interface type.
InterfaceMode=1
!
! Interface Address:
! 0 = none.
! 1 = port 1.
! 2 = port 2 etc.
InterfaceAddress=2
!
! Abort executing message if microphone PTT is pressed.
PTTDetect=0
!
! Display larger canvas with debugging facilities.
ShowDetails=0
!
! Mixer output setting for Wave
Wave=32768
!
! Horizontal location of window.
X=100
!
! Vertical location of window.
Y=100

The relevant parameter names and setting values are identical 
to those used in TACLog.

INTERFACES
==========
WVK makes use of three kinds of external interface circuitry, 
either connected to the serial port or the parallel port. The 
interface is capable of keying the key line and push to talk 
(PTT).

The circuitry consists of a dual optocoupler, providing 100% 
galvanic isolation between PC and radio. Between the pin and 
the opto-diode a 4,7 kOhm resistor is inserted. The collector 
of the optocoupler is the first transistor in a darlington 
coupling and the combined collectors are the PTT line. Apply 
capacitors, there is RF in the air - you know!

Below is a recommended connection schematic providing 100% 
galvanic isolation. If you choose to neglect the galvanic 
isolation the resistors should be increased to 10 kOhm.

   PC                         Radio

DTR(RTS) <--[4k7]--+
Init.(Select)      |     --+--> PTT(Key)
                   --  |/  | C
                   \/  |  |/
                   --  |\-|
                   |      |\ E
PC GND   <---------+       |
Strobe                     = Radio ground

Circuit reversed for the microphone PTT detection.

Serial, Interface Mode 1
------------------------
The interface uses Data Terminal Ready (DTR) for keying the 
message, Request To Send (RTS) to key the PTT and Clear To Send 
(CTS) to detect microphone PTT.

9-pin  25-pin  Name    Function
4      11      DTR     Key line
7       4      RTS     PTT line
8       5      CTS     Microphone PTT detect
5       7      Ground  Ground

Parallel, Interface Mode 2
--------------------------
The interface uses Strobe for PTT and keying the message 
ground, Initialise to key the PTT, Select In to key and Error 
to detect microphone PTT.

Pin    Name        Function
 1     Strobe      Keying and PTT transmitter ground
15     Error       Microphone PTT detect
16     Init.       PTT line
17     Select In   Key line
18     Ground      Microphone PTT detect ground

USING WVK
=========
1 Start Windows.

2 Start WWK by double clicking it, or include it in a TACLog
  start up batch file, and THEN start TACLog. It is important
  that WVK is started before TACLog.

3 In the TACLog contest screen press CTRL+F1-F10 to execute a
  message or ESC to abort.

TECHNICAL
=========
When using TACLog in Message Mode 3 TACLog sends a command 
message to the Windows Clipboard. WVK monitors the contents of 
the Clipboard every 5 ms and executes a valid command message.


Best regards
Bo Hansen, OZ2M

------------
TROUBLESHOOTING
===============
First restart your PC. Then start a DOS box. Start the DOS 
program DEBUG.

C:\>debug
-d 40:0
0040:0000  F8 03 F8 02 E8 03 E8 02-78 03 78 02 00 00 0C 02   ........x.x.....
0040:0010  27 C8 00 80 02 80 00 20-00 00 24 00 24 00 3A 34   '...... ..$.$.:4
0040:0020  30 0B 0D 1C 6C 26 73 1F-0D 1C 64 20 65 12 62 30   0...l&s...d e.b0
0040:0030  75 16 67 22 0D 1C 64 20-20 39 34 05 30 0B 00 00   u.g"..d  94.0...
0040:0040  00 00 C0 00 00 00 00 00-00 03 50 00 00 10 00 00   ..........P.....
0040:0050  00 08 00 00 00 00 00 00-00 00 00 00 00 00 00 00   ................
0040:0060  0E 0D 00 D4 03 29 20 C2-11 45 87 FF E8 BA 13 00   .....) ..E......
0040:0070  00 00 00 00 00 02 00 00-14 14 14 3C 01 01 01 01   ...........<....
-q

C:\>

The above shows that the serial ports are located at:
COM1: F8 03 = 3F8
COM2: F8 02 = 2F8
COM3: E8 03 = 3E8
COM4: E8 02 = 2E8

The LPT ports are located at:
LPT1: 78 03 = 378
LPT2: 78 02 = 278
LPT3: 00 00 = not in this PC.

The above are the base addresses of the various ports. On the 
COM ports the PTT and KEY bits are located at an address 
which is 4 bytes higher, e.g. for COM1 3F8 + 4 = 3FC. On the 
LPT ports the PTT and KEY bits are 2 bytes higher, e.g. for 
LPT1 378 + 2 = 37A.

Manually controlling PTT and KEY through DEBUG for COM ports 
(in this case COM1)
-o 3fc 0 (clear all pins, PTT and KEY off)
-o 3fc 2 (set PTT)
-o 3fc 3 (set KEY, PTT still on)
-o 3fc 1 (set KEY, PTT off!, not used by TACLog)

Manually controlling PTT and KEY through DEBUG for LPT ports 
(in this case LPT1)
-o 37a b (clear all pins, in this case not same as PTT off!)
-o 37a a (PTT and KEY off)
-o 37a f (set PTT)
-o 37a 7 (set KEY, PTT still on)
-o 37a 2 (set KEY, PTT off, not used by TACLog)

If the above does not work then WVK will not work either. If it 
does work then try next step.

1 Set ShowDetails in the WVK.INI file to 1, i.e. ShowDetaile=1.
2 Restart PC
3 Open NOTEPAD
4 Start WVK
5 Type the following string in NOTEPAD
  {$TACLogWVK;1;1;CQ CQ TEST DE OZ2M OZ2M OZ2M *TESTKK;100;5}
6 Mark the string and select Edit | Copy.
  The string is now copied to the CLIPBOARD where WVK will look
  for it.
7 Now WVK should send and key a CW message
  CQ CQ TEST DE OZ2M OZ2M OZ2M *TESTKK in 100 LPM and 5 s loop.

If this does not work then the problem is in WVK not in TACLog.

8 Now try a voice message, repeating Step 4 and Step 5
  {$TACLogWVK;1;2;C:\TACLOG\Users\OZ2M_1.WAV;3}
9 Now WVK should play the OZ2M_1.WAV file with a 3 s loop.

If this does not work then the problem is in WVK not in TACLog. 
If it does work then the problem is in TACLog.
