-
Notifications
You must be signed in to change notification settings - Fork 4.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
54 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,54 @@ | ||
# dds-config tool | ||
|
||
## Goal | ||
This tool is used to define a device as a DDS-compatible device and ensure it operates correctly within a DDS environment. | ||
It allows users to manage connection priorities, enabling the selection of either DDS or USB as the preferred connection method when both options are available. | ||
|
||
## Description | ||
Typically, the PC which the device needs to be connected to will have only one ethernet port. | ||
However, two ethernet ports are required for the setup: | ||
* One Ethernet port is needed to connect to the network - for remote access. | ||
* The second Ethernet port is needed to connect to the device - for DDS communication. | ||
|
||
To enable this configuration, a USB to ethernet adapter can be used, allowing the network connection to be routed through a USB port. | ||
The dds-config tool helps manage this setup by enabling users to prioritize either the USB or DDS connection, based on the specified parameters. It also provides information about the connected devices when executed. | ||
|
||
## Command Line Parameters | ||
| Flag | Description | | ||
|---|---| | ||
|'-h --help'|Show command line help menu| | ||
|'--usb-first'|Prioritize USB before Ethernet| | ||
|'--eth-first'|Prioritize Ethernet and fall back to USB after link timeout| | ||
|'--dynamic-priority'|Dynamically prioritize the last-working connection method (the default)| | ||
|
||
## Usage example | ||
Prioritize Ethernet connection by using `rs-dds-config.exe --eth-first`: | ||
``` | ||
-I- Device: [USB] Intel RealSense D555 s/n 338522301774 | ||
-I- MAC address: 98:4f:ee:19:cc:49 | ||
-I- configured: 192.168.11.55 & 255.255.255.0 / 192.168.11.1 | ||
-I- DDS: | ||
-I- domain ID: 0 | ||
-I- link: 1000 Mbps | ||
-I- MTU, bytes: 9000 | ||
-I- timeout, ms: 10000 | ||
-I- priority: usb-first --> eth-first | ||
-I- DHCP: OFF | ||
-I- timeout, sec: 30 | ||
-I- Successfully changed | ||
-I- Resetting device... | ||
``` | ||
After running `rs-dds-config.exe` we can now see the device changed it's connection to DDS: | ||
``` | ||
-I- Device: [DDS] Intel RealSense D555 s/n 338522301774 | ||
-I- MAC address: 98:4f:ee:19:cc:49 | ||
-I- configured: 192.168.11.55 & 255.255.255.0 / 192.168.11.1 | ||
-I- DDS: | ||
-I- domain ID: 0 | ||
-I- link: 1000 Mbps | ||
-I- MTU, bytes: 9000 | ||
-I- timeout, ms: 10000 | ||
-I- priority: eth-first | ||
-I- DHCP: OFF | ||
-I- timeout, sec: 30 | ||
``` |