Skip to content

Commit b44a3f3

Browse files
committed
add groot monitoring parameters to documentation
1 parent 8e7c701 commit b44a3f3

File tree

1 file changed

+40
-0
lines changed

1 file changed

+40
-0
lines changed

configuration/packages/configuring-bt-navigator.rst

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,43 @@ Parameters
5353
Description
5454
List of behavior tree node shared libraries.
5555

56+
:enable_groot_monitoring:
57+
58+
==== =======
59+
Type Default
60+
---- -------
61+
bool false
62+
==== =======
63+
64+
Description
65+
Enable live Groot monitoring of the current BT status.
66+
This is possible due to attaching a ZMQ server and publisher to the active behavior tree.
67+
Consider checking out the `Use BT Groot Monitoring<>`_ tutorial for using this feature.
68+
69+
**Attention:** Groot will only work after the behavior tree is running, which means that the nav2 stack has to receive a goal first.
70+
71+
:groot_zmq_publisher_port:
72+
73+
====== ======= ======= ========
74+
Type Default Unit Optional
75+
------ ------- ------- --------
76+
int 1666 Port yes
77+
====== ======= ======= ========
78+
79+
Description
80+
ZMQ publisher port for the Groot monitor. Used to consecutive publish the current status of the BT as flatbuffer.
81+
82+
:groot_zmq_server_port:
83+
84+
====== ======= ======= ========
85+
Type Default Unit Optional
86+
------ ------- ------- --------
87+
int 1667 Port yes
88+
====== ======= ======= ========
89+
90+
Description
91+
ZMQ server port for the Groot monitor. Used to send the current bt factory + configuration as flatbuffer on an (empty) request by Groot.
92+
5693
:transform_tolerance:
5794

5895
====== ======= =======
@@ -118,6 +155,9 @@ Example
118155
global_frame: map
119156
robot_base_frame: base_link
120157
transform_tolerance: 0.1
158+
enable_groot_monitoring: True
159+
groot_zmq_publisher_port: 1666
160+
groot_zmq_server_port: 1667
121161
bt_xml_filename: replace/with/path/to/bt.xml
122162
plugin_lib_names:
123163
- nav2_compute_path_to_pose_action_bt_node

0 commit comments

Comments
 (0)