User Tools

Site Tools


getting_started:tutorials:firstproject

This is an old revision of the document!


Your First EEROS Project

  1. First of all, make sure that you have set up your environment as described in Install and Setup Development Environment.
  2. Then create a new project following the steps under “preparation” on Getting Started.
  3. The following example shows a typical EEROS application.
  4. After creating all those files, modify the CMakeLists.txt and CMAkeCache.txt files accoring to Getting Started, “Say Hello World with EEROS”, point 2 and 3.
int main() {
  std::cout << "SCARA Robot Control started" << std::endl;
 
  // Define logger
  StreamLogWriter w(std::cout);
  w.show();
  Logger<LogWriter>::setDefaultWriter(&w);
 
  // Get HAL istance 
  HAL& hal = HAL::instance();
 
  // Get Control System instance
  MyControlSystem controlSystem;
 
  // Get Safety System instance
  double dt = 0.001;
 
  MySafetyProperties safetyProperties(&controlSystem);
  SafetySystem safetySystem (safetyProperties, dt);
 
  Sequencer sequencer;
  MySequencer  mainSequence(&sequencer, &controlSystem, &safetySystem);
  sequencer.start(&mainSequence);
 
  while(sequencer.getState() != state::terminated) {
      usleep(10000);
  }
 
  controlSystem.stop();
  safetySystem.shutdown();
  sequencer.shutdown();
 
  std::cout << "SCARA Robot Control stopped" << std::endl;
  return 0;
}

To start, create an instance of the Control System and Safety System. Since the safety system is closely connected to the Hardware which is accessed through the Hardware Abstraction Layer (HAL), inputs and outputs for the HAL have to be defined and assigned to the HAL.

Then you have to define the Safety Properties and start the safety system. The safety system will power-up the system and do all the necessary initialization, such as enabling actors and homing them.

Finally, a sequence has to be defined and assigned to a Sequencer. The program will run as long as the sequencer does not terminate.

Here follows the basic implementation of the three subsystems of a simple EEROS application:

Control System:

.hpp:
#ifndef CH_NTB_TEST_MYCONTROLSYSTEM_HPP_
#define CH_NTB_TEST_MYCONTROLSYSTEM_HPP_
 
#include <eeros/control/TimeDomain.hpp>
#include <eeros/control/Constant.hpp>
#include <eeros/control/Gain.hpp>
 
namespace testproject {
 
  class MyControlSystem {
 
  public:
    MyControlSystem();
 
    void start(); // starts timedomains
    void stop();  // stops timedomains
 
    // Define blocks here
 
  private:
    eeros::control::TimeDomain timedomain;
 
  };  // end class  
};    // end namepspace
 
#endif //CH_NTB_TEST_MYCONTROLSYSTEM_HPP_
.cpp:
#include "MyControlSystem.hpp"
 
using namespace testproject;
 
MyControlSystem::MyControlSystem() :
 
timedomain("Main time domain", 0.001, true)
 
{
    // Configure Blocks
 
    // Connect Blocks
    // e.g. gain.getIn().connect(constant.getOut());
 
    // Run Blocks
    // e.g. timedomain.addBlock(&constant);
}
 
void MyControlSystem::start() {
    timedomain.start();
}
 
void MyControlSystem::stop() {
    timedomain.stop();
    timedomain.join();  
}

Safety System:

.hpp:
#ifndef CH_NTB_TEST_MYSAFETYPROPERTIES_HPP_
#define CH_NTB_TEST_MYSAFETYPROPERTIES_HPP_
 
#include <eeros/safety/SafetyProperties.hpp>
#include <eeros/hal/HAL.hpp>
#include <eeros/hal/PeripheralOutput.hpp>
#include <eeros/hal/PeripheralInput.hpp>
#include <eeros/hal/ScalablePeripheralInput.hpp>
 
namespace testproject {
 
    class MyControlSystem;
 
    // ***** Define events ***** //
    enum {
	// e.g. doPowerUp = 1,
    };
 
    // ***** Define levels ***** //
    enum {
	// e.g. off = 1,
    };
 
    class MySafetyProperties : public eeros::safety::SafetyProperties {
 
    public: 
	MySafetyProperties(MyControlSystem* cs);
	virtual ~MySafetyProperties();
 
	// ***** Define critical outputs ***** //
 	// e.g. eeros::hal::PeripheralOutput<bool>* watchdog;
 
	// ***** Define critical inputs ***** //
 	//e.g. eeros::hal::PeripheralInput<bool>* emergencyButton;
 
    private:
	MyControlSystem* controlSys;
 
    }; // end class
};     // end namespace
 
#endif //CH_NTB_TEST_MYSAFETYPROPERTIES_HPP_
.cpp:
#include "MySafetyProperties.hpp"
#include "MyControlSystem.hpp"
 
#include <eeros/hal/HAL.hpp>
#include <eeros/safety/InputAction.hpp>
#include <eeros/safety/inputActions.hpp>
#include <eeros/safety/OutputAction.hpp>
 
#include <iostream>
 
using namespace testproject; 
using namespace eeros::hal;
using namespace eeros::control;
using namespace eeros::safety;
 
MySafetyProperties::MySafetyProperties(MyControlSystem* cs) : controlSys(cs) {
 
    // Create HAL instance
    HAL& hal = HAL::instance();
 
    // ***** Define critical outputs ***** //
    watchdog = hal.getLogicPeripheralOutput("watchdog");
    criticalOutputs = {watchdog};
 
    // ***** Define critical inputs ***** //
    emergencyButton = hal.getLogicPeripheralInput("emergencyButton");
    criticalInputs = {emergencyButton};
 
    // ***** Define levels ***** //
    levels = {
	{off,       "system off",        },
    };
 
    // ***** Add events to levels ***** //
    level(off      ).addEvent(doPowerUp, poweredUp, kPublicEvent);
 
    // ***** Define inputs actions ***** //
     level(off      ).setInputActions({ ignore(emergencyButton), ignore(encoder)});
 
    // ***** Define output actions ***** //
     level(off      ).setOutputActions({ set(watchdog, false), set(enable, false)});
 
    // ***** Define level functions ***** //
    level(off).setLevelAction([&](SafetyContext* privateContext) {
	controlSys->start();
	privateContext->triggerEvent(doPowerUp);
    });
 
    entryLevel = off;
}
 
MySafetyProperties::~MySafetyProperties() {
   // nothing to do
}

Main Sequencer:

.hpp:
#ifndef CH_NTB_TEST_MYSEQUENCER_HPP_
#define CH_NTB_TEST_MYSEQUENCER_HPP_
 
#include <eeros/sequencer/Sequence.hpp>
#include <eeros/safety/SafetySystem.hpp>
#include "MyControlSystem.hpp"
 
 
namespace testproject {
 
    class MySequencer : public eeros::sequencer::Sequence<void> {
 
    public:
	MySequencer(eeros::sequencer::Sequencer* sequencer, testproject::MyControlSystem* controlSys, eeros::safety::SafetySystem* safetySys);
 
	virtual bool checkPreCondition();
	virtual void run();
	virtual void exit();
 
    private: 
	// Define subsequences here
	// Example: Homing homingSequence; 
 
	bool isTerminating();
 
	testproject::MyControlSystem* controlSys;
	eeros::safety::SafetySystem* safetySys;
 
    }; // end class
};     // end namespace
 
#endif // CH_NTB_TEST_MYSEQUENCER_HPP_
.cpp:
#include "MySequencer.hpp"
#include "MySafetyProperties.hpp"
#include <unistd.h>
 
using namespace testproject;
using namespace eeros::sequencer;
using namespace eeros::safety;
 
MySequencer::MySequencer(Sequencer* sequencer, MyControlSystem* controlSys, SafetySystem* safetySys) : 
			Sequence< void >("main", sequencer), controlSys(controlSys), safetySys(safetySys) {
    // nothing to do 
}
 
bool MySequencer::checkPreCondition() {
    return safetySys->getCurrentLevel().getId() >= off;   
}
 
void MySequencer::run() {
    log.info() << "Start sequence";
    sleep(1);   
}
 
void MySequencer::exit() {
    log.info() << "Exit sequence";
}
 
inline bool MySequencer::isTerminating() {
    return sequencer->getState() == state::terminating;
}

The related CMake File is:

cmake_minimum_required(VERSION 2.8)
 
project(test-project)
 
include_directories(${ADDITIONAL_INCLUDE_DIRS})
link_directories(${ADDITIONAL_LINK_DIRS})
 
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
 
add_executable(test-project 
		      main.cpp
		      MyControlSystem.cpp
		      MySafetyProperties.cpp
		      MySequencer.cpp)
 
target_link_libraries(test-project eeros)
getting_started/tutorials/firstproject.1439198018.txt.gz · Last modified: 2015/08/10 11:13 by visentin