Differences

This shows you the differences between two versions of the page.

--- packet:xrouter:howtos:xrbpq [2025/09/29 12:26] – created g8pzt
+++ packet:xrouter:howtos:xrbpq [2025/09/29 14:16] (current) – g8pzt
@@ Line 3: / Line 3: @@
 === (On the same computer, or across the network) ===
-==== On the Same Computer: ===
+The best way to do this is via the AXUDP (AX25 over UDP/IP) protocol.
+//This howto assumes that you are familiar with the basics of XRouter and BPQ.//
+==== On the Same Computer: ====
 When both nodes are on the same computer, they can be linked via the operating system's "loopback" interface, usually known as "**localhost**".
-The best way to do this is via the AXUDP (AX25 over UDP/IP) protocol.
+If we assume that GB7XRP is the XRPi node and GB7BPQ is the BPQ node:
+You need a "BPQAXIP" port in BPQ.CFG...
+<code>
+PORT
+    PORTNUM=1
+    ID=AXIP
+    DRIVER=BPQAXIP
+    CONFIG
+    UDP 10093
+    MAP GB7XRP localhost 9393 B
+ENDPORT
+</code>
+In the above example, 10093 is the UDP port that BPQ **RECEIVES** on, and 9393 is the UDP port that BPQ **TRANSMITS** on to GB7XRP (they are shown as different numbers to avoid confusion, but could be the same).
+In XROUTER.CFG you need two things: (a) an AXUDP **INTERFACE**, and (b) a **PORT** "attached" to that interface...
+<code>
+INTERFACE=1
+   ID=AXUDP
+   TYPE=AXUDP
+   MTU=256
+ENDINTERFACE
+PORT=3
+   ID=Link with GB7BPQ
+   INTERFACENUM=1
+   IPLINK=localhost
+   UDPLOCAL=9393
+   UDPREMOTE=10093
+ENDPORT
+</code>
+//(if you already have an AXUDP interface, you will only need to add the **PORT** because the interface will support unlimited ports.)//
+IPLINK is the ip address or hostname of the other end of the link, in the case BPQ. Since they are both on the same computer, IPLINK should be "localhost" or "127.0.0.1". The latter is preferable, because it cuts out the domain resolution step.
+UDPLOCAL is the UDP port that XRouter **RECEIVES** on. This must match the UDP port in the BPQ "MAP" line.
+UDPREMOTE is the UDP port that XRouter **TRANSMITS** on. It must match one of the "UDP" lines in BPQ.CFG.
+==== XRouter and BPQ on Different Computers: ====
+The only difference is that "localhost" in the BPQ MAP line is replaced by the IP address or hostname of the XRouter node, and "localhost" in XRouter's IPLINK statement must be set to the IP address or hostname of the G8BPQ node.
+For example, lets assume that GB7BPQ's IP address is 192.168.0.10 and GB7XRP's IP address is 192.168.0.20...
+In BPQ.CFG the MAP line would be as follows:
+<code>
+MAP GB7XRP 192.168.0.20 9393 B
+</code>
+And in XROUTER.CFG the IPLINK line would be as follows:
+<code>
+PORT=3
+   ID=Link with GB7BPQ
+   INTERFACENUM=1
+   IPLINK=192.168.0.10
+   UDPLOCAL=9393
+   UDPREMOTE=10093
+ENDPORT
+</code>
-In BPQ.CFG...
+==== Linking Via The Internet: ====
-UDP 10093
+If the two nodes are not at the same location, you must enable (aka "open" or "port-forward") incoming UDP ports on each internet router.
-MAP GB7XRP localhost 9393 B
-In XROUTER.CFG
+Thus at GB7BPQ you would open UDP port 10093, and forward the traffic to the LAN IP address of the BPQ node.
+And at GB7XRP you would open UDP port 9393, and forward the traffic to the LAN IP address of XRouter.