Network Connection

To communicate with the Pulse Streamer 8/2, you need to know its IP address. By default, the device attempts to acquire an IP address via DHCP. If no DHCP server is available or if the IP lease fails, the device sets up an IP address via link-local address autoconfiguration. It first tries to use 169.254.8.2/16. If that IP address is already in use, it chooses another random IP address from the link-local address range. This address range (netmask 255.255.0.0) allows you to establish a connection when the Pulse Streamer 8/2 is plugged directly into your computer via Ethernet. This typically works out of the box on Windows and Linux (Linux requires Avahi/zeroconf). In some cases, especially if a DHCP connection existed before, you may need to restart your computer for it to detect the Pulse Streamer 8/2.

# Example:
#  using default hostname
ps = PulseStreamer('pulsestreamer')

#  using fallback IP
ps = PulseStreamer('169.254.8.2')

Starting from the Pulse Streamer firmware v1.2, you can discover all accessible Pulse Streamers in the network and their IP addresses using findPulseStreamers().

# Example
# query the network for all connected Pulse Streamers
devices = findPulseStreamers()

# query the network for a Pulse Streamer with specific serial number
devices = findPulseStreamers("00:26:32:F0:3B:1B")

Assign a static IP with the MAC address and DHCP

You can configure your DHCP server or router to assign a static DHCP IP to the MAC address of the Pulse Streamer 8/2. This ensures that you know the IP that the Pulse Streamer 8/2 will receive by DHCP. You find the MAC address of your Pulse Streamer 8/2 on the bottom label of the device. It is the same as the serial number.

To verify your network configuration, open a terminal and enter:

[user@host~] arp

Address                  HWtype  HWaddress           Flags Mask            Iface
192.168.1.108            ether   00:26:32:f0:09:30   C                     wlp1s0
router                   ether   18:83:bf:c1:1f:67   C                     wlp1s0

In this example, the first line corresponds to the Pulse Streamer 8/2, and the second line corresponds to the router.

Modify the network settings

By default, the Pulse Streamer 8/2 attempts to acquire an IP address via DHCP. If you want to assign a specific IP address to your device, you can disable DHCP and configure a static IP instead. We recommend using our Pulse Streamer Application (Windows only) to modify the Pulse Streamer 8/2 network configuration. The graphical user interface will guide you through the network configuration. You can enable/disable DHCP and set a specific IP address, netmask, and default gateway for a static IP configuration. You can test the new network settings before deciding to apply the configuration permanently in a second step.

Requirements:

  • network access to your Pulse Streamer 8/2 (at least via auto-IP)

  • Pulse Streamer firmware version 1.5.0 or later

  • Pulse Streamer Application Software Downloads

Configuring the network settings:

  1. On the startup-screen with the listed devices, click the button Edit network configuration behind the IP-address field.

  2. Choose your settings in the pop-up window.

  3. Click Test Settings to check if the device is reachable via the new settings (power-cycling resets the changes).

  4. Click Apply to set the configuration permanent.

../_images/GUI_NetworkSettings.png

Pulse Streamer Application: Network Configuration

Alternatively, you can configure the device’s network settings via our client software interfaces. For more information, see the Modify the network configuration section.

DHCP/auto-IP and Static IP address configuration

Since firmware version v2.1.0, the Pulse Streamer 8/2 no longer provides a second, permanent fallback IP address. In DHCP mode, a link-local (auto-IP) address is used whenever no DHCP server is available. You can plug the device directly into your computer and it will self-assign a link-local address from the address block 169.254.0.0/16. If a DHCP server becomes available later, the link-local address is automatically replaced by the DHCP-assigned address.

If the device is configured with a permanent static IP address and you want to return to the default DHCP settings, you can either manually change the network configuration of your Pulse Streamer 8/2 (see Modify the network settings), or you can press the reset button on the front panel for longer than 7 seconds. The device will reboot with default network settings (DHCP).

Warning

If your Pulse Streamer 8/2 has hardware revision 2.0 or earlier and no reset button, before assigning a static IP address verify the device will be reachable with the new network settings. We strongly recommend using the Test Settings option before applying the IP address permanently, because there is no way to reset those devices to DHCP mode without a network connection.

Troubleshooting

If there are issues with the network connection of your Pulse Streamer, you can use the debug mode of the Pulse Streamer Application.

  1. Start Pulse Streamer (Debug mode) from the Windows start menu. In debug mode, the Pulse Streamer Application will create a log file on your desktop containing information about your network settings and debug information for the Pulse Streamer GUI.

This information can help to determine incompatible network settings. If you want to alter the path of the log file, you can also start the Pulse Streamer Application from the command line. Please type

path/to/PulseStreamerApplication.exe /log path/to/logfile

Replace path/to/PulseStreamerApplication.exe with the actual path of the Pulse Streamer Application executable (e.g. “C:Program Files (x86)Swabian InstrumentsPulse StreamerPulseStreamer.exe”) and path/to/logfile with your favoured destination for the log file.

For assistance with the network configuration, please contact support@swabianinstruments.com.