BPQ Home   BPQ32 Home

UPnP Support

Introduction

Universal Plug and Play (UPnP) is a set of networking protocols that permits networked devices, such as personal computers, printers, Internet gateways, Wi-Fi access points and mobile devices to seamlessly discover each other's presence on the network and establish functional network services. (Wikipedia).

BPQ uses UPnP to open ports that need access to the Internet without needing access to the ISP Router. This may be useful when access to the Router is limited. It depends on UPnP being enabled in the Router.

Configuation

UPnP is configured by adding UPNP statements to the main section of bpq32.cfg. Format is:

UPNP UDP|TCP, External Port, [Internal Port]

if Internal Port is omitted the External port is used. Eg

UPNP UDP, 10093
UPNP TCP, 8081, 8080

The first opens UDP port 10093 and forwards to the BPQ machine port 10093
The second opens TCP port 8081 and forwards to the BPQ machine port 8080

You can have as many UPNP statements as you need.

BPQ will delete the port mappings when it closes

Credits

Includes code from MiniUPnPc, used subject to the following conditions:

MiniUPnPc
Copyright (c) 2005-2020, Thomas BERNARD
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright notice,
      this list of conditions and the following disclaimer in the documentation
      and/or other materials provided with the distribution.
    * The name of the author may not be used to endorse or promote products
	  derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.



John Wiseman G8BPQ
August 2021