You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _docs/FIROS2/index.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,13 @@
1
1
---
2
-
title: micro-ROS & FIWARE
2
+
title: microROS & FIWARE
3
3
permalink: /docs/FIROS2/
4
4
redirect_from: /FIROS2/
5
5
---
6
6
7
7
8
8
## Interoperability
9
9
10
-
This subsection will explain all the design alternatives for the interoperability of FIROS2 with micro-ROS.
10
+
This subsection will explain all the design alternatives for the interoperability of FIROS2 with microROS.
11
11
12
12
### Mechanisms for the deserialisation of incoming data in the transformation library
13
13
@@ -25,7 +25,7 @@ For solving this issue, various methods to get it are proposed:
25
25
26
26
#### Use serialisation/deserialisation method provided by the middleware layer
27
27
28
-
This is currently the method used in micro-ROS - FIROS 2 integration.
28
+
This is currently the method used in microROS - FIROS 2 integration.
29
29
30
30
In this case, the transformation library will use user selected middleware interface to serialise/deserialise the bridged ROS2 messages.
31
31
This method requires to get the message typesupport for the bridged message type.
@@ -63,25 +63,25 @@ Note the call to ROS 2 interface __rosidl_typesupport_cpp::get_message_type_supp
63
63
#### Use serialisation/deserialisation method for an specific type support
64
64
65
65
In this case, the transformation library will use one specific type support to serialise/deserialise the bridged ROS2 messages.
66
-
In micro-ROS case, the implementation to be used will be rosidl_typesupport_microxrcedds.
66
+
In microROS case, the implementation to be used will be rosidl_typesupport_microxrcedds.
67
67
This method is trivial to develop as it does not require additional source code on the micro-ROS side.
68
68
69
-
In the case of micro-ROS, the transformation library should use the serialisation/deserialisation API exposed by its typesupport, rosidl_typesupport_microxrcedds.
69
+
In the case of microROS, the transformation library should use the serialisation/deserialisation API exposed by its typesupport, rosidl_typesupport_microxrcedds.
70
70
This mechanism requires the user to have access to the typesupport API, which sometimes is not always possible.
71
71
72
72
#### Used serialisation/deserialisation method generated from IDL file
73
73
74
74
In this case, transformation library will use generated code to serialise/deserialise the bridged ROS2 messages.
75
75
The generated code may be made using an IDL parser tool.
76
-
In the micro-ROS case, Micro XRCE-DDS provides with Micro XRCE-DDS code generator, which accepts an IDL file as input and generates type code.
76
+
In the microROS case, Micro XRCE-DDS provides with Micro XRCE-DDS code generator, which accepts an IDL file as input and generates type code.
77
77
This IDL files should correspond with those messages types the transformation is wanted.
78
78
This is the [integration service](https://github.com/eProsima/Integration-Service) native method.
79
79
Integration services uses this method, but it makes the development of the library slower as it needs to be generated per each message to be bridged.
In the case of ROS2/micro-ROS workspaces, there are tools which generate those IDL files.
84
-
The rosidl_gen package is the package micro-ROS/ROS2 could use to create IDL from ROS2 interfaces.
83
+
In the case of ROS2/microROS workspaces, there are tools which generate those IDL files.
84
+
The rosidl_gen package is the package microROS/ROS2 could use to create IDL from ROS2 interfaces.
85
85
86
86
### Integration proposals
87
87
@@ -90,7 +90,7 @@ This section presents all the integrations possibilities.
90
90
91
91
#### Direct integration
92
92
93
-
In this case, micro-ROS Agent will act as a bridge between DDS-XRCE and NGSIv2.
93
+
In this case, microROS Agent will act as a bridge between DDS-XRCE and NGSIv2.
94
94
95
95
Selected bridged topics and their corresponding transformations must be configured on the micro-ROS Agent node.
96
96
@@ -106,7 +106,7 @@ This proposal requires micro-ROS Agent changes, but it is the direct native inte
106
106
107
107
#### Indirect integration with a single FIROS2 node
108
108
109
-
In this case, micro-ROS nodes will publish the configured topics on DDS, and a FIROS2 node will subscribe to those topics and convert them into NGSIv2 protocol.
109
+
In this case, microROS nodes will publish the configured topics on DDS, and a FIROS2 node will subscribe to those topics and convert them into NGSIv2 protocol.
110
110
Selected bridged topics must be configured on that single FIROS2 node.
111
111
Each ROS 2 topic type should have a corresponding transformation library configured on that FIROS2 node.
112
112
@@ -124,11 +124,11 @@ This proposal requires transformation library development, but the integration w
124
124
125
125
#### Indirect integration with multiple FIROS2 nodes
126
126
127
-
In this case, micro-ROS nodes will publish the configured topic on DDS and multiple FIROS2 nodes, one for each set topic, will subscribe to those topics and convert them into NGSIv2 protocol.
127
+
In this case, microROS nodes will publish the configured topic on DDS and multiple FIROS2 nodes, one for each set topic, will subscribe to those topics and convert them into NGSIv2 protocol.
128
128
129
129
This approach would require more nodes on the network and individual configurations.
130
130
131
-
This approach is the one followed by micro-ROS, and it is limited due to current FIROS 2 implementation.
131
+
This approach is the one followed by microROS, and it is limited due to current FIROS 2 implementation.
132
132
133
133
This proposal requires transformation library development, but the integration will be the same as a regular ROS2 node, so no micro-ROS specific development should be expected.
134
134
@@ -142,7 +142,7 @@ This proposal requires transformation library development, but the integration w
142
142
143
143
## Demonstration
144
144
145
-
This section explains how to demonstrate the interoperability of FIROS2 with Micro-ROS.
145
+
This section explains how to demonstrate the interoperability of FIROS2 with microROS.
146
146
The purpose is to demonstrate the interoperability, although the final design is not closed.
147
147
148
148
To run the demonstration a step by step guide is presented in this document.
Copy file name to clipboardExpand all lines: _docs/index.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,21 +3,20 @@ permalink: /docs/home/
3
3
title: Overview
4
4
---
5
5
6
-
[micro-ROS](https://cordis.europa.eu/project/rcn/213167_en.html) puts ROS2 onto microcontrollers, making them first class participants of the ROS 2 environment.
6
+
[microROS](https://cordis.europa.eu/project/rcn/213167_en.html) puts ROS2 onto microcontrollers, making them first class participants of the ROS 2 environment.
7
7
8
8
## Tutorials
9
9
10
10
See [Tutorial List](/docs/tutorials/).
11
11
12
12
## Architecture
13
13
14
-
We're basically following the ROS2 architecture and make use of its middleware pluggability to use DDS-XRCE, which is suitable for micro-controllers. Moreover, we use an RTOS (NuttX) instead of Linux. On micro-controllers many different RTOS's are used, so we also add an RTOS abstraction layer (AL), to make porting to other RTOS possible.
14
+
We're basically following the ROS2 architecture and make use of its middleware pluggability to use [DDS-XRCE](https://www.omg.org/spec/DDS-XRCE/), which is suitable for microcontrollers. Moreover, we use an RTOS (NuttX) instead of Linux. On microcontrollers many different RTOS's are used, so we also add an RTOS abstraction layer (AL), to make porting to other RTOS possible.
15
15
16
16

17
17
18
18
## Concept Documentation
19
19
20
-
- Library to support the implementation of language-specific ROS Client Libraries: [rcl](https://github.com/microROS/rcl)
21
20
- Predictable scheduling and execution: [real-time_executor](real-time_executor/)
22
21
- System modes and system hierarchy: [system_modes](system_modes/)
0 commit comments