Differences

This shows you the differences between two versions of the page.

--- eeros_architecture:safety_system:usage [2016/10/21 12:57] – graf
+++ eeros_architecture:safety_system:usage [2017/01/28 17:33] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Create a safety system ======
+====== Setup a Safety System ======
-The safety system is implemented as a singleton. Its constructors are private, and you can get an instance by calling
+Every EEROS system can have exactly one safety system. As a first step you have to define your safety properties as described in [[eeros_architecture:safety_system:properties|]]. After this you create an instance of these properties and assign it to your safety system as follows
 <code cpp>
-  SafetySystem &safetySys = SafetySystem::instance();
+MySafetyProperties safetyProperties;
+SafetySystem safetySys(safetyProperties, period);
 </code>
-The central attribute of the safety system is its //currentLevel//. Of course, this level can be queried by everyone but only set by the safety system itself.
+The executor will later run the safety system as its main task. The safety system will always be the task with the highest run frequency. The parameter ''period'' determines this frequency.
-The most important function is its run method. This method is called periodically by a high priority thread. Here's how it works:
 <code cpp>
-  void SafetySystem::run() {
+// Create and run executor
+auto& executor = eeros::Executor::instance();
-    // 1) Make local copy of currentLevel
+executor.setMainTask(safetySys);
-    SafetyLevel* level = currentLevel;
-    // 2) Read inputs
-    for(auto ia : level->inputAction) {
-      if(ia != nullptr) ia->check(&privateContext);
-    }
-    // 3) Execute level action
-    if(level->action != nullptr) level->action(&privateContext);
-    // 4) Set outputs
-    for(auto oa : level->outputAction) {
-      if(oa != nullptr) oa->set();
-    }
-  }
 </code>
 ===== Changing the Safety Level =====
-The only possibility to change the safety level is through the method //triggerEvent//.
+The central attribute of the safety system is its //currentLevel//. Of course, this level can be queried by everyone but only set by the safety system itself.
+The only possibility to change the safety level is through the method //triggerEvent//. \\
+Triggering an event can be done by
+  * the safety system itself (as a level action or by checking an critical input)
+  * the control system through a special ''SignalChecker'' block
+  * the sequencer
-====== Safety System Usage ======
+An event can be triggered by the control system or the sequencer by calling:
-Since the safety system and the HAL (hardware abstraction layer or hardware access layer) are strongly coupled it makes sense to show the usage of both systems on this page.
+<code cpp>
+safetySys.triggerEvent(safetyProperties.seStartRunning);
+</code>
+Please make sure to declare a safety event public if triggered by the control system or the sequencer. Private event can be triggered solely by the safety system itself.
-Sometimes you need to fire an event e.g. swInitDone:
-<code c>
-safetySys.triggerEvent(swInitDone, privateContext);
-</code>
-The C-style definition in class //SafetySystem//:
-<code c>
-void triggerEvent(uint32_t event);
-</code>
-===== Watchdog Output ====
-The last thing to do, is to set an watchdog output, which will be toggled on every execution of //run()//. This can easily be done with:
-<code c>
-SystemOutput<bool>* watchdog = hal.getLogicSystemOutput("watchdog");
-safetySys.setWatchdogOutput(watchdog);
-</code>
-===== Setting Up The System =====
-Before the safety system can be started, you have to define the entry level:
-<code c>
-safetySys.setEntryLevel(off);
-</code>
-Finally add the safety system to an executor, so the //run()// method will be called periodically (every second, for example). Start the thread by calling the //start()// method of the executor.
-<code c>
-Executor e(1);
-e.addRunnable(safetySys);
-e.start();
-</code>