UDP Broadcast

Broadcast message link

When this feature is enabled on the terminal it will send a UDP broadcast message at startup and once every 60 seconds after that. The broadcast message is a simple JSON object that can be used to identify a terminal on the network.

This allows for a dynamic and seamless way for ECRs inside of the local network to discover and connect to our terminals.

UDP Broadcast uses the highest possible IP for a IPv4 network, which is X.X.X.255. Make sure you allow this IP range in your local network. The port the terminals will be broadcasting on is UDP port 8000.

The structure of the broadcast message is as follows:

 
  "WORLDLINE_TERMINAL": {
    "v0": {
      "terminalId": "182837313011101003287575",
      "identity": "47084495",
      "ipAddress": "192.168.0.1",
      "port": 443,
      "protocolType": "EcrRestApi",
      "protocolVersion": "1.0.0",
      "commonName": "wl-samport-terminal-server-v1"
    },
  }
 

Limitations of the UDP broadcast link

UDP Broadcast is limited by your network infrastructure, the following can have a negative impact on your ability to receive these messages.

Router settings link

Many routers have the option to disable UDP broadcasts or limit the number of UDP broadcasts that can pass through the network.

Firewall settings link

Firewalls can be configured to block UDP broadcasts or limit the number of UDP broadcasts that are allowed to pass through the network.

Switch settings link

Managed switches can be configured to limit UDP broadcasts by setting up VLANs or access control lists.

Network policies link

Network administrators can implement policies that restrict the use of UDP broadcasts or limit the frequency and size of UDP broadcasts.

QoS settings link

Quality of Service (QoS) settings can be used to prioritize other types of network traffic over UDP broadcasts, effectively limiting their impact on the network.

DHCP settings link

DHCP servers can be configured to limit the number of UDP broadcasts by restricting the scope of IP addresses that are available for broadcast traffic.