i/OrbbecSDK_ROS2
1
0
Fork 0
mirror of https://github.com/orbbec/OrbbecSDK_ROS2.git synced 2026-09-12 19:20:20 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update net camera documentation: add set_device_ip utility and Force IP function details

Browse Source
This commit is contained in:
obyalian
2025-10-14 17:01:17 +08:00
parent c9c84e7c42
commit 6aa3e009be
2 changed files with 52 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/source/4_application_guide/launch_parameters.md
+1 -1
View File
@@ -137,7 +137,7 @@ The following are the launch parameters available:
* Target device MAC address when multiple cameras are connected (e.g., `"54:14:FD:06:07:DA"`). You can use the `list_devices_node` to find the MAC of each device. **Default:** `""`
* **`force_ip_address`**
* Static IP address to assign when DHCP is disabled. **Default:** `192.168.1.10`
* Static IP address to assign. **Default:** `192.168.1.10`
* **`force_ip_subnet_mask`**
* Subnet mask for the static IP. **Default:** `255.255.255.0`
docs/source/5_advanced_guide/configuration/net_camera.md
+51
View File
@@ -62,6 +62,57 @@ Note: `net_device_ip` needs to be changed to the IP address of the device, here
ros2 launch orbbec_camera gemini_330_series.launch.py enumerate_net_device:=true net_device_ip:=192.168.1.10 net_device_port:=8090
```
## set_device_ip Utility
The **`set_device_ip`** executable allows you to configure the IP settings of a network camera directly from ROS 2, including switching between DHCP and static IP, and setting subnet mask and gateway. This is useful for quickly assigning or updating IP addresses without modifying launch files.
> **Note:** The IP settings applied with `set_device_ip` are **permanent** and **will not be reset** if the device is powered off or restarted.
**Example Usage**
```
ros2 run orbbec_camera set_device_ip --ros-args \
-p old_ip:=192.168.1.10 \
-p dhcp:=false \
-p new_ip:=192.168.1.11 \
-p mask:=255.255.255.0 \
-p gateway:=192.168.1.1
```
**Parameters**
- **`old_ip`** – Current IP address of the device.
- **`dhcp`** – Set to `true` to use DHCP or `false` for static IP.
- **`new_ip`** – Static IP address to assign when DHCP is disabled.
- **`mask`** – Subnet mask for the new IP.
- **`gateway`** – Gateway address for the new IP.
## Force IP Function
The **Force IP** feature allows you to assign a **static IP address** to a network camera, overriding DHCP settings. This is useful when multiple network cameras are connected, and you need each device to have a fixed IP for reliable communication.
> **Note:** The Force IP configuration **will be reset if the device is powered off or restarted**. You need to reapply the settings after reboot.
**Parameters**
- **`force_ip_enable`** – Enable the Force IP function. **Default:** `false`
- **`force_ip_mac`** – Target device MAC address when multiple cameras are connected (e.g., `"54:14:FD:06:07:DA"`). You can use the `list_devices_node` to find the MAC of each device. **Default:** `""`
- **`force_ip_address`** – Static IP address to assign . **Default:** `192.168.1.10`
- **`force_ip_subnet_mask`** – Subnet mask for the static IP. **Default:** `255.255.255.0`
- **`force_ip_gateway`** – Gateway address for the static IP. **Default:** `192.168.1.1`
**Example Usage**
- **Enable Force IP for a specific device:**
```
ros2 launch orbbec_camera gemini_330_series.launch.py force_ip_enable:=true force_ip_mac:=54:14:FD:06:07:DA force_ip_address:=192.168.1.50 force_ip_subnet_mask:=255.255.255.0 force_ip_gateway:=192.168.1.1 net_device_ip:=192.168.1.50 net_device_port:=8090
```
> Tip: Make sure the camera is connected and its MAC address is correct before enabling Force IP. Use `list_devices_node` to check the MAC address of all connected cameras.
## Multi Net camera
For [multi_net_camera.launch.py](https://github.com/orbbec/OrbbecSDK_ROS2/blob/v2-main/orbbec_camera/examples/net_camera/multi_net_camera.launch.py) as an example: