Feature flow controller

Signed-off-by: Eugenio Collado <eugeniocollado@eprosima.com>

Author: EugenioCollado

code/DDSCodeTester.cpp

@@ -4699,6 +4699,8 @@ void dds_qos_examples()
         participant_qos.wire_protocol().ignore_non_matching_locators = true;
         // Increase mutation tries
         participant_qos.wire_protocol().builtin.mutation_tries = 300u;
+        // Use a specific flow controller to control the builtin writers
+        participant_qos.wire_protocol().builtin.flow_controller_name = "AlreadyExistingFlowController";
         // Use modified QoS in the creation of the DomainParticipant entity
         participant_ = factory_->create_participant(domain, participant_qos);
         //!--
@@ -6693,6 +6695,9 @@ void dds_usecase_examples()
         DomainParticipantQos participant_qos;
         participant_qos.flow_controllers().push_back(flow_control_300k_per_sec);
 
+        // [OPTIONAL] Link builtin writers to any of the registered flow controllers
+        participant_qos.wire_protocol().builtin.flow_controller_name = "example_flow_controller";
+
         // .... create participant and publisher
 
         // Link writer to the registered flow controller.

code/XMLTester.xml

@@ -836,6 +836,10 @@
                     </sender_thread>
                 </flow_controller_descriptor>
             </flow_controller_descriptor_list>
+
+            <builtin> <!-- Optional use of flow controller for participant's meta traffic-->
+                <flow_controller_name>example_flow_controller</flow_controller_name>
+            </builtin>
         </rtps>
     </participant>
 

code/XMLTesterExample.xml

@@ -373,6 +373,7 @@
                     <readerPayloadSize>512</readerPayloadSize>
                     <writerPayloadSize>512</writerPayloadSize>
                     <mutation_tries>55</mutation_tries>
+                    <flow_controller_name>example_flow_controller</flow_controller_name>
                 </builtin>
 
                 <port>

docs/fastdds/use_cases/large_data/large_data.rst

@@ -205,7 +205,14 @@ Flow Controllers
 
 *eProsima Fast DDS* provides a mechanism to limit the rate at which the data is sent by a DataWriter.
 These controllers should be registered on the creation of the DomainParticipant using |FlowControllersQos|, and
-then referenced on the creation of the DataWriter using |PublishModeQosPolicy|.
+then referenced by the DataWriter whose traffic is to be controlled:
+
+* User DataWriters: 
+  The flow controller should be assigned through |PublishModeQosPolicy| to regulate the transmission of application data.
+* Built-in DataWriters: 
+  The flow controller can be configured to control meta-traffic generated by built-in DataWriters responsible for PDP,
+  EDP, WLP, and TypeLookupService. This allows for fine-grained control over discovery and built-in traffic. The flow
+  controller should be assigned through |WireProtocolConfigQos|.
 
 A new thread is spawned the first time a flow controller is referenced by an asynchronous DataWriter.
 This thread will be responsible for arbitrating the network output of the samples being transmitted by all the

docs/fastdds/xml_configuration/domainparticipant.rst

@@ -333,6 +333,11 @@ This section specifies the available XML members for the configuration of this
        port is already in use.
      - ``uint32_t``
      - 100
+   * - ``<flow_controller_name>``
+     - :ref:`flowcontrollersqos` name.
+     - ``string``
+     - Empty
+
 
 **Example**