1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495 |
- #ifndef GUARDEDENTRY_H_
- #define GUARDEDENTRY_H_
- #include "sc_types.h"
-
- #ifdef __cplusplus
- extern "C" {
- #endif
- /*! \file Header of the state machine 'GuardedEntry'.
- */
- /*! Enumeration of all states */
- typedef enum
- {
- GuardedEntry_last_state,
- GuardedEntry_main_region_A,
- GuardedEntry_main_region_B
- } GuardedEntryStates;
- /*! Type definition of the data structure for the GuardedEntryIface interface scope. */
- typedef struct
- {
- sc_boolean e_raised;
- sc_boolean guard;
- sc_boolean done;
- } GuardedEntryIface;
- /*! Define dimension of the state configuration vector for orthogonal states. */
- #define GUARDEDENTRY_MAX_ORTHOGONAL_STATES 1
- /*! Define indices of states in the StateConfVector */
- #define SCVI_GUARDEDENTRY_MAIN_REGION_A 0
- #define SCVI_GUARDEDENTRY_MAIN_REGION_B 0
- /*!
- * Type definition of the data structure for the GuardedEntry state machine.
- * This data structure has to be allocated by the client code.
- */
- typedef struct
- {
- GuardedEntryStates stateConfVector[GUARDEDENTRY_MAX_ORTHOGONAL_STATES];
- sc_ushort stateConfVectorPosition;
-
- GuardedEntryIface iface;
- } GuardedEntry;
- /*! Initializes the GuardedEntry state machine data structures. Must be called before first usage.*/
- extern void guardedEntry_init(GuardedEntry* handle);
- /*! Activates the state machine */
- extern void guardedEntry_enter(GuardedEntry* handle);
- /*! Deactivates the state machine */
- extern void guardedEntry_exit(GuardedEntry* handle);
- /*! Performs a 'run to completion' step. */
- extern void guardedEntry_runCycle(GuardedEntry* handle);
- /*! Raises the in event 'e' that is defined in the default interface scope. */
- extern void guardedEntryIface_raise_e(GuardedEntry* handle);
- /*! Gets the value of the variable 'guard' that is defined in the default interface scope. */
- extern sc_boolean guardedEntryIface_get_guard(const GuardedEntry* handle);
- /*! Sets the value of the variable 'guard' that is defined in the default interface scope. */
- extern void guardedEntryIface_set_guard(GuardedEntry* handle, sc_boolean value);
- /*! Gets the value of the variable 'done' that is defined in the default interface scope. */
- extern sc_boolean guardedEntryIface_get_done(const GuardedEntry* handle);
- /*! Sets the value of the variable 'done' that is defined in the default interface scope. */
- extern void guardedEntryIface_set_done(GuardedEntry* handle, sc_boolean value);
- /*!
- * Checks whether the state machine is active (until 2.4.1 this method was used for states).
- * A state machine is active if it was entered. It is inactive if it has not been entered at all or if it has been exited.
- */
- extern sc_boolean guardedEntry_isActive(const GuardedEntry* handle);
- /*!
- * Checks if all active states are final.
- * If there are no active states then the state machine is considered being inactive. In this case this method returns false.
- */
- extern sc_boolean guardedEntry_isFinal(const GuardedEntry* handle);
- /*! Checks if the specified state is active (until 2.4.1 the used method for states was called isActive()). */
- extern sc_boolean guardedEntry_isStateActive(const GuardedEntry* handle, GuardedEntryStates state);
- #ifdef __cplusplus
- }
- #endif
- #endif /* GUARDEDENTRY_H_ */
|