Network Setup
The multisense sends a large amount of data over the network to its host. It is highly recommended that the multisense be on its own network with as few devices as possible between the multisense and the host. When possible, use a cable directly from the camera to a PCIe network device on the host. It is possible to use a USB3.0 to Ethernet adapter for connection, but not all devices support gigabit or large (greater than 1500) MTU values.
The multisense is a static IP device. This means the camera is assigned an IP address once, and it will always be available at that address regardless of which network it is connected to. The host system also needs to have a compatible static IP configuration to properly communicate with the sensor.
This contrasts other devices that have dynamic addresses. These dynamic address devices are automatically assigned an address from a DHCP server when connected to a compatible network.
Host Network Configuration
IP Address
To connect to a multisense camera, the host must have a compatible static IP
address configuration. The default multisense IP address is 10.66.171.21.
To connect to the multisense, the host system must have a netmask of /24 and an
IP address of 10.66.171.XXX, where XXX is any number between 1 and 255
that is not 21.
For information about configuring your specific OS, please see the OS-Specific Network Configuration Section
Changing Camera IP address
To change the IP address of the camera, the LibMultiSense ChangeIpUtility may be used. Please see LibMultiSense for instructions on building and using the utilities. To change the IP address from default to a new address (192.168.37.21), run the following command
$ ChangeIpUtility -a 10.66.171.21 -A 192.168.37.21 -G 192.168.37.1
Note
These utilities are also available if multisense_ros has been installed. Please see the Running LibMultiSense Utils section for more information about running the utils via ROS.
Unknown Camera IP address
To reset the IP address of a camera when the current IP address is unknown, the
LibMultiSense ChangeIpUtility may be used. Please see LibMultiSense for
instructions on building and using the utilities. The IP address recovery
mechanism works by resetting the IP address of all MultiSenses on the current
network. To reset the IP addresses of all cameras on a specific network device
to default, run the following command, where <interface_name> is replaced
with the desired interface name:
$ ChangeIpUtility -b <interface_name>
Once the command has been sent, power cycle all cameras on the network. All cameras will now have the IP address 10.66.171.21
Note
These utilities are also available if multisense_ros has been installed. Please see the Running LibMultiSense Utils section for more information about running the utils via ROS.
MTU
When large pieces of data are sent from the camera to the host, they need to be broken into smaller pieces of information called packets. The size of these packets is controlled by the MTU setting (Maximum Transmission Unit). Both the camera and the host have independent MTU settings that need to be compatible with each other. The MTU setting on the camera determines the maximum packet size that data will be broken into when sending to the host. The host MTU is the maximum packet size that will be allowed to be received from devices on the network. It is critical that the host MTU is equal to or larger than the camera’s configured MTU.
A common symptom of an incompatible MTU setting is when it is possible to ping the camera, create a channel to the camera, and reconfigure the camera successfully, but the host never receives images from the camera. This is because connection and configuration messages are smaller than the MTU and do not need to be broken up, but image messages are larger than the configured MTU and get blocked by the host.
Small MTU values result in camera data being broken into more packets. The downside is that every packet contains a fixed length header, which results in more network overhead for an equivalent amount of sent data. For this reason, it is recommended that the MTU be set as large as possible for the network.
Usually, a value of 7200 MTU is recommended, but the MultiSense will still work properly with a smaller 1500 MTU supported by nearly all network interfaces.
For information about configuring your specific OS, please see the OS-Specific Network Configuration Section
Note
If your application requires images to be streamed at the max framerate for the configured resolution, it’s recommended you use a built-in PCIe network interface with a MTU between 7200 and 9000.
Note
Many USB-Ethenet adapters and embedded computers dont support MTU’s larger than 1500
Setting Camera MTU
To set the camera MTU in LibMultiSense, the setMtu() function of the channel object must be used. Please see the LibMultiSense Channel section for more information about using the channel object.
To set the camera MTU when using multisense_ros, the MTU parameter must be set when launching the camera. Please see the ROS1 Launching section for more information about setting the MTU
OS-Specific Network Configuration
Network Details
Gigabit Networking Requirements
TODO
Multiple MultiSense Cameras on the Same Interface
TODO