execution.h File Reference

This file contains basic hardware definitions as for example the clock frequency of the used hardware. More...

#include "typedefs.h"
#include "dev.h"

Go to the source code of this file.

Functions
void	StartOS (AppModeType mode)
	The user can call this system service to start the operating system in a specific mode Only allowed outside of the operating system, therefore implementation specific restrictions may apply.
void	ShutdownOS (StatusType error)
	The user can call this system service to abort the overall system (e.g.
AppModeType	GetActiveApplicationMode (void)
	This service returns the current application mode.
void	_oil_init_application_mode (AppModeType mode)
void	StartupHook (void)
	This hook routine is called by the operating system at the end of the operating system initialization and before the scheduler is running.

---

Detailed Description

This file contains basic hardware definitions as for example the clock frequency of the used hardware.

Definition in file execution.h.

---

Function Documentation

AppModeType GetActiveApplicationMode (  void   )

This service returns the current application mode. It may be used to write mode dependent code. See chapter 5 for a general description of application modes. Allowed for task, ISR and all hook routines.

void ShutdownOS (  StatusType  error  )

The user can call this system service to abort the overall system (e.g. emergency off). The operating system also calls this function internally, if it has reached an undefined internal state and is no longer ready to run. If a ShutdownHook is configured the hook routine ShutdownHook is always called (with <Error> as argument) before shutting down the operating system. If ShutdownHook returns, further behaviour of ShutdownOS is implementation specific. In case of a system where OSEK OS and OSEKtime OS coexist, ShutdownHook has to return. <Error> needs to be a valid error code supported by OSEK OS. In case of a system where OSEK OS and OSEKtime OS coexist, <Error> might also be a value accepted by OSEKtime OS. In this case, if enabled by an OSEKtime configuration parameter, OSEKtime OS will be shut down after OSEK OS shutdown.

void StartOS (  AppModeType  mode  )

The user can call this system service to start the operating system in a specific mode Only allowed outside of the operating system, therefore implementation specific restrictions may apply. See also chapter 11.3, System start-up, especially with respect to systems where OSEK and OSEKtime coexist. This call does not need to return.

void StartupHook (  void   )

This hook routine is called by the operating system at the end of the operating system initialization and before the scheduler is running. At this time the application can initialize device drivers etc.

---