                                   AXIPDRV
                                 Version 1.0
             AXIP External Port Driver for the AGW Packet Engine
                            Copyright 2001 LU7DID

               Based on the SV2AGW LoopBack C++ Template Code

=============================================================================
1.0 Introduction
----------------

This DLL implements an External Port driver for the AGW Packet Engine
(c) SV2AGW George Rossopoulos intended to enable the AGWPE to be linked with
other nodes using the AXIP protocol (RFC-1226).

The link is performed using UDP Sockets (default Port 93), raw sockets
(Protocol 93/94 not supported).

Once properly installed and configured all AX.25 traffic directed to the
port supported by this driver will be encapsulated as AXIP and sent to the
other end of the point-to-point virtual line where the receiver will unwrap
and handle it as coming from any other port.

In order to operate properly both ends got to have a configured route to
the other (both ends operates a server and client pair).

The type of traffic supported is AX.25 in a completely transparent way son
any protocol (plain AX.25, NETROM, TCP/IP over radio, FlexNet, etc) could
be carried thru this port.

As many ports as desired could be configured on a single AGWPE as long as
each one have a particular configuration, specially a different port where
to listen for incoming UDP frames.


2.0 Installation
----------------

   * Install the AXIPDRV.DLL into the same directory AGW Packet Engine.EXE is.
   * Configure an External Port on AGWPE
       - Properties/New Port
         Select Port: Any
         TNC Type   : AXIP (External Dll)
         TNC SubType: KISS
         IniKiss1   : Empty
         IniKiss2   : Configuration File Name (i.e. @LU7DID.INI)
         IniKiss3   : Empty
         Single Port: Marked
         Serial Port: Any
         Port1      : Description

         Default settings on the TNC Commands Tab.
       - Create the Configuration File (see 3.0 Configuration)
       - Restart AGW Packet Engine
       - Verify the new port is operable on AGWPE
         Properties -> The port must be listed and not marked as IDLE



3.0 Configuration
-----------------

A configuration file named with the format @{Name}.INI must be created
(i.e. @LU7DID.INI) with the parameters of the port.

The file name MUST start with @ or the driver won't initialize properly.

The content of the file has to be

[AXIPDRV]

DEST_ADDR=192.168.0.10   <== IP Address of Destination
DEST_PORT=93             <== Port of the Destination
DEST_HOST=               <== Hostname of Destination (overrides DEST_ADDR)
CALLSIGN=LU7DID-14       <== Unique CallSign for the Port
UDP_PORT=93              <== UDP port where this Port will listen
DEBUG=                   <== Logging and Debug [0..4]

Logging, when enabled, takes place at the AXIPDRV.LOG file in the same
directory where the DLL is.

4.0 Removal
-----------

To Remove the driver proceed to delete the External Port from AGWPE, delete
it and Restart AGWPE.

Upon restart verify the port is not longer listed.

After that you could remove AXIPDRV.* from your machine.


5.0 Disclaimer and License Statement
------------------------------------

AXIPDRV is free for radioamateur and experimental uses, commercial use
requires written permission from the author.

The author bears no liability for damages related to the usage of this
program nor guarantees the proper functional behaviour. I could certainly
be more sophisticated in legal terms, but in a nutshell use it at your own risk.

The program was written after the C++ Template provided by George Rossopoulos
(SV2AGW) showing the general method to interface with AGWPE.

The TWSocket object by Francois Piette was used to implement the UDP Socket.


AX.25:   LU7DID@LU7DID.#ADR.BA.ARG.SOAM
Inet:    colla@pec.pccp.com.ar
