From 55519ed2b8a7dd7d4ae13a968b0ec88e5cada7dd Mon Sep 17 00:00:00 2001 From: Ussama Naal <606033+Samahu@users.noreply.github.com> Date: Tue, 15 Oct 2024 11:55:30 -0700 Subject: [PATCH] Add a section for network config recommendation (#388) --- .github/ISSUE_TEMPLATE/bug_report.md | 2 +- README.md | 6 ++++++ util/network-configure.bash | 11 +++++++++++ 3 files changed, 18 insertions(+), 1 deletion(-) create mode 100644 util/network-configure.bash diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index ca57c99a..d689f9f6 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -10,7 +10,7 @@ assignees: '' > **IMPORTANT** > Before reporting a new bug make sure you have: > - [ ] Checked existing issues https://github.com/ouster-lidar/ouster-ros/issues -> - [ ] Checked existing issues https://github.com/ouster-lidar/ouster-ros/issues +> - [ ] Checked existing discussions https://github.com/ouster-lidar/ouster-ros/discussions > - [ ] Checked ouster community https://community.ouster.com/ > If you couldn't find relevant information and you think this is rather a driver > problem then proceed with bug reporting. diff --git a/README.md b/README.md index 5500de29..e7899568 100644 --- a/README.md +++ b/README.md @@ -128,6 +128,12 @@ roslaunch ouster_ros driver.launch \ `driver.launch` offers better performance and reduced overhead on the ROS bus, thus it is preferred over `sensor.launch`. `sensor.launch` is mainly provided for backward compatibilty. +> **Note**: +> If you observe parts of the scan missing is missing, this suggests having a lots of dropped packets +> It is recommended that you increase the maximum allowed size for receive memory buffers in network +> subsystem, you can do so by running the script `network-configure.bash` under `util`. + + #### Recording Mode > Note > As of package version 8.1, specifiying metadata file is optional since the introduction of the diff --git a/util/network-configure.bash b/util/network-configure.bash new file mode 100644 index 00000000..66530d9a --- /dev/null +++ b/util/network-configure.bash @@ -0,0 +1,11 @@ +#!/bin/bash + +# kernel receive buffer size +sudo sysctl -w net.core.rmem_max=16777216 +sudo sysctl -w net.core.rmem_default=16777216 + +## in addition you can try increasing the receive buffer size +# sudo ethtool -G rx 2048 + +## increase the MTU size to 9000 to decrease fragmentation +# sudo ifconfig mtu 9000