2020-05-18 20:35:13 +02:00
|
|
|
#ifndef FRAMEWORK_TASKS_SEMAPHOREFACTORY_H_
|
|
|
|
#define FRAMEWORK_TASKS_SEMAPHOREFACTORY_H_
|
|
|
|
#include <framework/tasks/SemaphoreIF.h>
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates Semaphore.
|
|
|
|
* This class is a "singleton" interface, i.e. it provides an
|
|
|
|
* interface, but also is the base class for a singleton.
|
|
|
|
*/
|
|
|
|
class SemaphoreFactory {
|
|
|
|
public:
|
|
|
|
virtual ~SemaphoreFactory();
|
|
|
|
/**
|
|
|
|
* Returns the single instance of SemaphoreFactory.
|
|
|
|
* The implementation of #instance is found in its subclasses.
|
|
|
|
* Thus, we choose link-time variability of the instance.
|
|
|
|
*/
|
|
|
|
static SemaphoreFactory* instance();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a binary semaphore.
|
|
|
|
* Creator function for a binary semaphore which may only be acquired once
|
2020-05-27 19:46:56 +02:00
|
|
|
* @param argument Can be used to pass implementation specific information.
|
2020-05-18 20:35:13 +02:00
|
|
|
* @return Pointer to newly created semaphore class instance.
|
|
|
|
*/
|
2020-05-27 19:46:56 +02:00
|
|
|
SemaphoreIF* createBinarySemaphore(uint32_t argument = 0);
|
2020-05-18 20:35:13 +02:00
|
|
|
/**
|
|
|
|
* Create a counting semaphore.
|
|
|
|
* Creator functons for a counting semaphore which may be acquired multiple
|
|
|
|
* times.
|
|
|
|
* @param count Semaphore can be taken count times.
|
|
|
|
* @param initCount Initial count value.
|
2020-05-27 19:46:56 +02:00
|
|
|
* @param argument Can be used to pass implementation specific information.
|
2020-05-18 20:35:13 +02:00
|
|
|
* @return
|
|
|
|
*/
|
2020-05-27 19:46:56 +02:00
|
|
|
SemaphoreIF* createCountingSemaphore(uint8_t count, uint8_t initCount,
|
|
|
|
uint32_t argument = 0);
|
|
|
|
|
|
|
|
void deleteSemaphore(SemaphoreIF* mutex);
|
2020-05-18 20:35:13 +02:00
|
|
|
|
|
|
|
private:
|
|
|
|
/**
|
|
|
|
* External instantiation is not allowed.
|
|
|
|
*/
|
|
|
|
SemaphoreFactory();
|
|
|
|
static SemaphoreFactory* factoryInstance;
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif /* FRAMEWORK_TASKS_SEMAPHOREFACTORY_H_ */
|