microbit-dal/inc/MicroBitListener.h

#ifndef MICROBIT_LISTENER_H
#define MICROBIT_LISTENER_H

#include "mbed.h"
#include "MicroBitEvent.h"

// MessageBusListener flags...
#define MESSAGE_BUS_LISTENER_PARAMETERISED          0x0001
#define MESSAGE_BUS_LISTENER_METHOD                 0x0002
#define MESSAGE_BUS_LISTENER_REENTRANT              0x0004
#define MESSAGE_BUS_LISTENER_BUSY                   0x0008

struct MicroBitListener
{
	uint16_t		id;				// The ID of the component that this listener is interested in. 
	uint16_t 		value;			// Value this listener is interested in receiving. 
    uint16_t        flags;          // Status and configuration options codes for this listener.

    union 
    {
        void (*cb)(MicroBitEvent);
        void (*cb_param)(MicroBitEvent, void *);
        MemberFunctionCallback *cb_method;
    };

	void*			cb_arg;			// Optional argument to be passed to the caller. 

	MicroBitEvent 	evt;
	
	MicroBitListener *next;

	/**
	  * Constructor. 
	  * Create a new Message Bus Listener.
	  * @param id The ID of the component you want to listen to.
	  * @param value The event ID you would like to listen to from that component
	  * @param handler A function pointer to call when the event is detected.
	  */
	MicroBitListener(uint16_t id, uint16_t value, void (*handler)(MicroBitEvent));
	
	/**
	  * Alternative constructor where we register a value to be passed to the
	  * callback. 
	  */
    MicroBitListener(uint16_t id, uint16_t value, void (*handler)(MicroBitEvent, void *), void* arg);

    /**
     * Constructor. 
     * Create a new Message Bus Listener, with a callback to a c++ member function.
     * @param id The ID of the component you want to listen to.
     * @param value The event ID you would like to listen to from that component.
     * @param object The C++ object on which to call the event handler.
     * @param object The method within the C++ object to call.
     */
    template <typename T> 
    MicroBitListener(uint16_t id, uint16_t value, T* object, void (T::*method)(MicroBitEvent));

    /**
      * Destructor. Ensures all resources used by this listener are freed.
      */
    ~MicroBitListener();
};

/**
  * Constructor. 
  * Create a new Message Bus Listener, with a callback to a c++ member function.
  * @param id The ID of the component you want to listen to.
  * @param value The event ID you would like to listen to from that component.
  * @param object The C++ object on which to call the event handler.
  * @param object The method within the C++ object to call.
  */

template <typename T>
MicroBitListener::MicroBitListener(uint16_t id, uint16_t value, T* object, void (T::*method)(MicroBitEvent))
{
	this->id = id;
	this->value = value;
    this->cb_method = new MemberFunctionCallback(object, method);
	this->cb_arg = NULL;
    this->flags = MESSAGE_BUS_LISTENER_METHOD;
	this->next = NULL;
}

#endif