BPQ Home  BPQ32 Home
BPQAXIP
Introduction:
BPQAXIP supports the encapsulation of AX.25 frames
in IP, as defined in RFC1226.
It also supports encapuslation in UDP, as used by some UNIX systems, and TCP.
UDP Source Port.
Some implementions of AX/IP require a specific UDP source port. Prior to November 2010, BPQ32 would use the first
port defined in a UDP line as the source port. Now, by default the software will try to use the same port for both source and destination,
unless overridden by the SOURCEPORT parameter. In both cases, the source port that you are trying to use must be
defined in a UDP statement. If is isn't, the software will revert to the old behaviour of using the port specified in the
first UDP entry.
Configuration.
The driver is defined to BPQ32 as an External port, and needs some driver-specific configuration
Configuration Statements
UDP
Optional. Enables UDP support, and defines the port AX.IP listens on. You can have more than one UDP line if you need
to listen on more than one port. To listen for IPV6, add ,IPv6 after port - eg UDP 10093,IPv6
MHEARD
Optional - opens a window to display a "Heard List"
BROADCAST
Defines a call that should be sent to all stations with a "B" specified on the MAP statement.
You can have more than one BROADCAST statement.
MAP
Defines a relationship between a Callsign and an IP Address. There is a limit of 128 entries in the mapping table.
You can use raw IP encapsulation, using IP Protocol 93, or UDP or TCP, or a combination
Format is: ([..] indicates optional paramters, values separated by | are alternatives)
MAP Call Address [UDP|TCP-Master|TCPSlave Port] [KEEPALIVE nnn][SOURCEPORT nnn] [B]
If Call has an ssid, the entry only applies to that ssid value.
If no ssid is supplied, the entry applies to all ssid values.
So, if you want to select traffic for only G8BPQ, you must specify
G8BPQ-0.
Address can be a host name, or numeric IP address. For TCP-Slave it should be 0.0.0.0. The software will work with an IP broadcast address,
but if the destination is on the same subnet you will receive your own broadcast frames.
If the host name resolves to both IPv4 and IPv6 addresses you can select which one you want to use by adding ipv4: or ipv6: to the front of the host name, eg ipv6:nottm.g8bpq.net
UDP means use UDP Encapsulation, sending to Port.
TCP-Master and TCP-Slave are used in pairs, one at each end of the connection. These may be used in cases
where it is impossible to set up your Internet Router to send UDP frames to your computer.
Keepalive. Many Internet Service Providers now use Address Translation, so they can allocate private IP addresses
to their customers. Some routers will time out translation entries that are idle for more that a short time.
BPQAXIP can be configured to send a dummy "Keep Alive" message every nnn seconds if this is a problem.
SOURCEPORT. Some AX/IP implementations require UDP datagrams to be sent from a particular port.
The software will use the destination port as the source port, unless overridden by this parameter.
The B parameter causes packets matching the BROADCAST definitions to be sent to this station.
Normally you would have BROADCAST NODES and a B on each MAP entry, so that all stations see your NODES broadcasts.
An exception is when using INP3, when the B would normally be omitted.
Some Examples:
MAP G8BPQ-7 10.2.77.1 B # Use Raw IP encapulation
MAP G8BPQ g8bpq.no-ip.com B # Sends all ssid's of G8BPQ
MAP G8BPQ-7 10.2.77.1 UDP 10093 B # Use UDP encapulation, send to port 10093
MAP G8BPQ-1 example.net TCP-Master 10093 B # Connect using TCP to host example.net, port 10093
MAP G8BPQ-5 0.0.0.0 TCP-Slave 10093 B # Listen for TCP connections on port 10093
AUTOADDMAP
This option automatically adds the node call and address of a node from which you receive a UDP packet for which you do
not have a MAP entry in bpq32.cfg.
DONTCHECKSOURCECALL
This option allows packets to be received from stations for which you don't have a MAP entry. This should only be used in exceptional circumstances, as
normally you will want to b able to reply to received packets.
if option DONTCHECKSOURCECALL is specified then the AUTOADDMAP option is ignored.
Sample Config file for BPQAXIP
PORT
ID=AXIP Link
DRIVER=BPQAXIP
QUALITY=200
MAXFRAME=4
FRACK=7000
RESPTIME=1000
RETRIES=10
PACLEN=120
CONFIG
UDP 10093 # Optional. Enables UDP support, and defines the port
# AX.IP listens on. You can specify more than one
# UDP line if you need to listen on more than one port
MHEARD # Optional - opens a window to display a "Heard List"
BROADCAST NODES
BROADCAST APRS
MAP G8BPQ-7 10.2.77.1 UDP 10093 B
ENDPORT
John Wiseman G8BPQ
October 2010