Skip to content

Commit c5504fa

Browse files
committed
Incorporated review by rlange
1 parent ae7fc06 commit c5504fa

1 file changed

Lines changed: 11 additions & 8 deletions

File tree

  • _docs/concepts/client_library/system_modes

‎_docs/concepts/client_library/system_modes/index.md‎

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -42,14 +42,15 @@ This goal is illustrated in the following example architecture, which is describ
4242

4343
![High-level Architecture](mode-management.png)
4444

45-
The key elements of the approach are:
45+
The main features of the approach are (detailed in the remainder):
4646

4747
1. _Extended Lifecycle_: Extensible concept to specify the runtime states of components, i.e ROS 2 lifecycle nodes.
48-
2. _System Hierarchy and Modes_: Modeling approach for specifying system modes based on these component states.
48+
2. _System Hierarchy and Modes_: Modeling approach for specifying a ROS system in terms of its system hierarchy and _system modes_, i.e. different (sub-)system configurations.
4949
3. _Mode Manager_: A module to manage and change the system runtime configuration.
5050
4. _Mode Inference_: A module for deriving the entire system state and mode from observable system information, i.e. states, modes, and parameters of its components.
5151
5. _Diagnostics_: Diagnosis module for deriving relevant information from the operating systems, the hardware and the functional components.
5252

53+
5354
## Requirements
5455

5556
The list of requirements is maintained in the doc folder of the micro-ROS system modes repository, at: https://github.com/micro-ROS/system_modes/blob/master/system_modes/doc/requirements.md
@@ -63,6 +64,7 @@ The description of the concept can be found at: [http://design.ros2.org/articl
6364
The implementation of the Lifecycle Node is described at:
6465
[https://index.ros.org/doc/ros2/Managed-Nodes/](https://index.ros.org/doc/ros2/Managed-Nodes/).
6566

67+
6668
## Main Features
6769

6870
### Extended Lifecycle
@@ -72,30 +74,31 @@ In micro-ROS, we extend the ROS 2 lifecycle by allowing to specify modes, i.e. s
7274
Documentation and code can be found at:
7375
[github.com:system_modes/README.md#lifecycle](https://github.com/micro-ROS/system_modes/blob/master/system_modes/README.md#lifecycle)
7476

75-
7677
### System Hierarchy and Modes
7778

78-
We provide a modeling concept for specifying the hierarchical composition of systems recursively from nodes and for specifying the states and modes of systems and subsystems with the extended lifecycle, analogously to nodes. This system modes and hierarchy (SMH) model also includes an application-specific the mapping of the states and modes along the system hierarchy down to nodes.
79+
We provide a modeling concept for specifying the hierarchical composition of systems recursively from nodes and for specifying the states and modes of systems and (sub-)systems with the extended lifecycle, analogously to nodes. This system modes and hierarchy (SMH) model also includes an application-specific the mapping of the states and modes along the system hierarchy down to nodes.
7980

8081
The description of this model can be found at:
8182
[github.com:system_modes/README.md#system-modes](https://github.com/micro-ROS/system_modes/blob/master/system_modes/README.md#system-modes)
8283
A simple example is provided at:
8384
[github.com:system_modes_examples/README.md#example-mode-file](https://github.com/micro-ROS/system_modes/blob/master/system_modes_examples/README.md#example-mode-file)
8485

85-
8686
### Mode Inference
8787

88-
The mode inference infers the entire system states (and modes) based on the lifecycle states, modes, and parameter configuration of its components, i.e. the ROS 2 lifecyle nodes. It parses the model and subscribes to lifecycle/mode change requests, lifecycle/mode changes, and parameter events.
88+
The mode inference infers the entire system states (and modes) based on the lifecycle states, modes, and parameter configuration of its components, i.e. the ROS 2 lifecyle nodes. It parses the SMH model and subscribes to lifecycle/mode change requests, lifecycle/mode changes, and parameter events.
89+
90+
Based on the lifecycle change events it knows the _actual_ lifecycle state of all nodes. Based on parameter change events it knows the _actual_ parameter values of all nodes, which allows inference of the _modes_ of all nodes based on the SMH model.
91+
Based on the SMH model and the inferred states and modes of all nodes, states and modes of all (sub-)systems can be _inferred_ bottom-up along the system hierarchy.
92+
This can be compared to the latest _requested_ states and modes to detect a deviation.
8993

9094
The documentation and code can be found at:
9195
[github.com:system_modes/README.md#mode-inference](https://github.com/micro-ROS/system_modes/blob/master/system_modes/README.md#mode-inference)
9296
The mode inference can be best observed in the mode monitor, a console-based debugging tool, see:
9397
[github.com:system_modes/README.md#mode-monitor](https://github.com/micro-ROS/system_modes/blob/master/system_modes/README.md#mode-monitor)
9498

95-
9699
### Mode Manager
97100

98-
The mode manager allows for runtime system adaptation based on such a system hierarchy and modes model. It parses the model and provides all services and topics to request state and mode changes and to monitor these changes.
101+
Building upon the _Mode Inference_ mechanism, the mode manager provides additional services and topics to _manage and adapt_ system states and modes according to the specification in the SMH model.
99102

100103
The documentation and code can be found at:
101104
[github.com:system_modes/README.md#mode-manager](https://github.com/micro-ROS/system_modes/blob/master/system_modes/README.md#mode-manager)

0 commit comments

Comments
 (0)