Merge pull request #460 from ApexAI/iox-#337-create-PeriodicTask

Iox #337 create periodic task

Author: elBoberido

.gitignore

@@ -2,6 +2,7 @@ build/
 build_out_of_tree/
 install/
 /CMakeLists.txt
+clangd/
 .vscode
 /**/*.user
 iceoryx_utils/doc/html/

CONTRIBUTING.md

@@ -149,13 +149,13 @@ The coverage scan applies to Quality level 3 and partly level 2 with branch cove
 For having a coverage report iceoryx needs to be compiled with coverage flags and the tests needs to be executed.
 You can do this with one command in iceroyx folder like this:
 ```
-./tools/iceoryx_build_test.sh clean buildall -c <testlevel>
+./tools/iceoryx_build_test.sh clean build-all -c <testlevel>
 ```
-Optionally you can use buildall option to get coverage for extensions like DDS or C-Binding.
+Optionally you can use build-all option to get coverage for extensions like DDS or C-Binding.
 The -c flag indicates that you want to have a coverage report and you can pass there the needed testlevel. Per default the testlevel is set to 'all'.
 example:
 ```
-./tools/iceoryx_build_test.sh buildall clean -c unit
+./tools/iceoryx_build_test.sh build-all clean -c unit
 ```
 For having only reports for unit-test. In the script tools/gcov/lcov_generate.sh is the initial scan, filtering and report generation automatically done.
 

README.md

@@ -54,11 +54,11 @@ An example for such a "porcelain" API would be [ROS2](https://www.ros.org/). Oth
 
 ## Build and install
 
-You can find the build and installation guidelines [here](doc/installation-guide.md).
+You can find the build and installation guidelines [here](doc/website/getting-started/installation.md).
 
 ## Examples
 
-After you've built all the necessary things, you can continue playing around with the [examples](./iceoryx_examples).
+After you've built all the necessary things, you can continue playing around with the [examples](./iceoryx_examples/README.md).
 
 ## Build and run in a Docker environment
 

doc/website/getting-started/installation.md

@@ -104,7 +104,7 @@ The script currently only works for Linux and QNX, it is planned to offer a mult
  2. Build everything
     ```
     cd iceoryx
-    ./tools/iceoryx_build_test.sh build_all
+    ./tools/iceoryx_build_test.sh build-all
     ```
 
 You can use the help for getting an overview over the available options:

iceoryx_examples/icedelivery/README.md

@@ -2,12 +2,12 @@
 
 ## Introduction
 
-This example showcases a one-way data transmission setup with zero-copy inter-process communication (IPC) on iceoryx.
-It provides publisher and subscriber applications. They come in two API flavours (untyped and typed).
+This example showcases a data transmission setup with zero-copy inter-process communication (IPC) on iceoryx.
+It provides publisher and subscriber applications. They come in two C++ API flavours (untyped and typed). Check icedelivery_on_c for the C API
 
 ## Run icedelivery
 
-Create three terminals and run one command in each of them. Choose one publisher and one subscriber and mix the typed and untyped versions.
+Create different terminals and run one command in each of them. Choose at least one publisher and one subscriber for having a data communication. You can also mix the typed and untyped versions. And if you feel like crazy today you start several publishers and subscribers from icedelivery and icedelivery_on_c (needs the default n:m communication, not possible if you build with the ONE_TO_MANY option)
 ```sh
 # If installed and available in PATH environment variable
 iox-roudi
@@ -46,31 +46,27 @@ RouDi is ready for clients
 ```
 2020-12-20 16:05:01.837 [ Debug ]: Application registered management segment 0x7fd6d39e3000 with size 64244064 to id 1
 2020-12-20 16:26:42.791 [ Info  ]: Application registered payload segment 0x7f377c4e6000 with size 149134400 to id 2
-Sent {five,two} times value: (1, 1, 1)
-Sent {five,two} times value: (2, 2, 2)
-Sent {five,two} times value: (3, 3, 3)
+Sent {five,two} times value: 1
+Sent {five,two} times value: 2
+Sent {five,two} times value: 3
 ```
 
 ### Subscriber application (typed)
 ```
 2020-12-20 16:26:58.839 [ Debug ] Application registered management segment 0x7f6353c04000 with size 64244064 to id 1
 2020-12-20 16:26:58.839 [ Info  ] Application registered payload segment 0x7f634ab8c000 with size 149134400 to id 2
 Not subscribed!
-Got value: (2, 2, 2)
-Got value: (2, 2, 2)
-Got value: (2, 2, 2)
-Got value: (2, 2, 2)
-Got value: (2, 2, 2)
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Got value: (3, 3, 3)
-Got value: (3, 3, 3)
-Got value: (3, 3, 3)
-Got value: (3, 3, 3)
-Got value: (3, 3, 3)
+Got value: 2
+Got value: 2
+Got value: 2
+Got value: 2
+Got value: 2
+
+Got value: 3
+Got value: 3
+Got value: 3
+Got value: 3
+Got value: 3
 
 ```
 
@@ -79,18 +75,12 @@ Got value: (3, 3, 3)
 2020-12-20 16:26:58.839 [ Debug ] Application registered management segment 0x7f6353c04000 with size 64244064 to id 1
 2020-12-20 16:26:58.839 [ Info  ] Application registered payload segment 0x7f634ab8c000 with size 149134400 to id 2
 Not subscribed!
-Got value: (2, 2, 2)
-Got value: (2, 2, 2)
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Didn't get a value, but do something anyway.
-Got value: (3, 3, 3)
-Got value: (3, 3, 3)
+Got value: 2
+Got value: 2
+
+
+Got value: 3
+Got value: 3
 ```
 
 ## Code walkthrough
@@ -293,8 +283,7 @@ need to take care about all cases, but it is advised to do so.
 In the `and_then` case the content of the sample is printed to the command line:
 ```cpp
 auto object = static_cast<const RadarObject*>(sample->get());
-std::cout << "Got value: (" << object->x << ", " << object->y << ", " << object->z << ")"
-            << std::endl;
+std::cout << "Got value: " << object->x << std::endl;
 ```
 
 Please note the `static_cast` before reading out the data. It is necessary, because the untyped subscriber is unaware

iceoryx_examples/icedelivery/iox_publisher_typed.cpp

@@ -42,7 +42,7 @@ int main()
     iox::popo::TypedPublisher<RadarObject> typedPublisher({"Radar", "FrontLeft", "Object"});
     typedPublisher.offer();
 
-    float_t ct = 0.0;
+    double ct = 0.0;
     while (!killswitch)
     {
         ++ct;
@@ -96,7 +96,7 @@ int main()
         typedPublisher.publishResultOf(getRadarObject, ct);
         typedPublisher.publishResultOf([&ct](RadarObject* object) { *object = RadarObject(ct, ct, ct); });
 
-        std::cout << "Sent five times value: (" << ct << ", " << ct << ", " << ct << ")" << std::endl;
+        std::cout << "Sent five times value: " << ct << std::endl;
 
         std::this_thread::sleep_for(std::chrono::seconds(1));
     }

iceoryx_examples/icedelivery/iox_publisher_untyped.cpp

@@ -37,7 +37,7 @@ int main()
     iox::popo::UntypedPublisher untypedPublisher({"Radar", "FrontLeft", "Object"});
     untypedPublisher.offer();
 
-    float_t ct = 0.0;
+    double ct = 0.0;
     while (!killswitch)
     {
         ++ct;
@@ -73,7 +73,7 @@ int main()
                 // Do something with error
             });
 
-        std::cout << "Sent two times value: (" << ct << ", " << ct << ", " << ct << ")" << std::endl;
+        std::cout << "Sent two times value: " << ct << std::endl;
 
         std::this_thread::sleep_for(std::chrono::seconds(1));
     }

iceoryx_examples/icedelivery/iox_publisher_with_history.cpp

@@ -41,7 +41,7 @@ int main()
     iox::popo::TypedPublisher<RadarObject> typedPublisher({"Radar", "FrontLeft", "Object"}, publisherOptions);
     typedPublisher.offer();
 
-    float_t ct = 0.0;
+    double ct = 0.0;
     while (!killswitch)
     {
         ++ct;
@@ -55,6 +55,8 @@ int main()
             sample.publish();
         });
 
+        std::cout << "Sent value: " << ct << std::endl;
+
         std::this_thread::sleep_for(std::chrono::milliseconds(400));
     }
 

iceoryx_examples/icedelivery/iox_subscriber_typed.cpp

@@ -49,10 +49,9 @@ int main()
         {
             typedSubscriber.take()
                 .and_then([](iox::popo::Sample<const RadarObject>& object) {
-                    std::cout << "Got value: (" << object->x << ", " << object->y << ", " << object->z << ")"
-                              << std::endl;
+                    std::cout << "Got value: " << object->x << std::endl;
                 })
-                .if_empty([] { std::cout << "Didn't get a value, but do something anyway." << std::endl; })
+                .if_empty([] { std::cout << std::endl; })
                 .or_else([](iox::popo::ChunkReceiveError) { std::cout << "Error receiving chunk." << std::endl; });
         }
         else

iceoryx_examples/icedelivery/iox_subscriber_untyped.cpp

@@ -50,10 +50,9 @@ int main()
             untypedSubscriber.take()
                 .and_then([](iox::popo::Sample<const void>& sample) {
                     auto object = static_cast<const RadarObject*>(sample.get());
-                    std::cout << "Got value: (" << object->x << ", " << object->y << ", " << object->z << ")"
-                              << std::endl;
+                    std::cout << "Got value: " << object->x << std::endl;
                 })
-                .if_empty([] { std::cout << "Didn't get a value, but do something anyway." << std::endl; })
+                .if_empty([] { std::cout << std::endl; })
                 .or_else([](iox::popo::ChunkReceiveError) { std::cout << "Error receiving chunk." << std::endl; });
         }
         else