EventAdapterGEV.h

Go to the documentation of this file.

//-----------------------------------------------------------------------------
//  (c) 2006 by Basler Vision Technologies
//  Section:  Vision Components
//  Project:  GenApi
//    Author:  Fritz Dierks
//  $Header$
//
//  License: This file is published under the license of the EMVA GenICam  Standard Group.
//  A text file describing the legal terms is included in  your installation as 'GenICam_license.pdf'.
//  If for some reason you are missing  this file please contact the EMVA or visit the website
//  (http://www.genicam.org) for a full copy.
//
//  THIS SOFTWARE IS PROVIDED BY THE EMVA GENICAM STANDARD GROUP "AS IS"
//  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
//  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
//  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE EMVA GENICAM STANDARD  GROUP
//  OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,  SPECIAL,
//  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT  LIMITED TO,
//  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,  DATA, OR PROFITS;
//  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY  THEORY OF LIABILITY,
//  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT  (INCLUDING NEGLIGENCE OR OTHERWISE)
//  ARISING IN ANY WAY OUT OF THE USE  OF THIS SOFTWARE, EVEN IF ADVISED OF THE
//  POSSIBILITY OF SUCH DAMAGE.
//-----------------------------------------------------------------------------
#ifndef GENAPI_EVENTADAPTERGEV_H
#define GENAPI_EVENTADAPTERGEV_H

#include <GenApi/EventAdapter.h>

namespace GENAPI_NAMESPACE
{

    /* ------------------------------------------- */
    // Declaration of GigE Vision Event message structures

    // some useful macros
    #if defined( _MSC_VER )
        #define PACK_STRUCT
    #elif defined (__GNUC__)
        // While gcc-4 understands #pragma pack,
        // gcc-3 does not
        #define PACK_STRUCT __attribute__((packed))
    #else
    #   error Unknown platform
    #endif

    // make sure everything is properly packed
#pragma pack(push, 1)


    typedef struct PACK_STRUCT GVCP_REQUEST_HEADER
    {
        uint8_t  Magic;
        uint8_t  Flags;
        uint16_t Command;
        uint16_t Length;
        uint16_t ReqId;
    } GVCP_REQUEST_HEADER;

    typedef struct PACK_STRUCT GVCP_EVENT_ITEM_BASIC
    {
        uint16_t ReservedOrEventSize;
        uint16_t EventId;
    } GVCP_EVENT_ITEM_BASIC;

    typedef struct PACK_STRUCT GVCP_EVENT_ITEM
    {
        uint16_t ReservedOrEventSize;
        uint16_t EventId;
        uint16_t StreamChannelId;
        uint16_t BlockId;
        uint32_t TimestampHigh;
        uint32_t TimestampLow;
    } GVCP_EVENT_ITEM;

    typedef struct PACK_STRUCT GVCP_EVENT_REQUEST
    {
        GVCP_REQUEST_HEADER Header;
        GVCP_EVENT_ITEM Items[ 1 ];
    } GVCP_EVENT_REQUEST;

    typedef struct PACK_STRUCT GVCP_EVENTDATA_REQUEST
    {
        GVCP_REQUEST_HEADER Header;
        GVCP_EVENT_ITEM Event;
        uint32_t Data[ 1 ];
    } GVCP_EVENTDATA_REQUEST;

    typedef struct PACK_STRUCT GVCP_EVENT_ITEM_EXTENDED_ID
    {
        uint16_t ReservedOrEventSize;
        uint16_t EventId;
        uint16_t StreamChannelId;
        uint16_t BlockId;
        uint32_t BlockId64High;
        uint32_t BlockId64Low;
        uint32_t TimestampHigh;
        uint32_t TimestampLow;
    } GVCP_EVENT_ITEM_EXTENDED_ID;

    typedef struct PACK_STRUCT GVCP_EVENT_REQUEST_EXTENDED_ID
    {
        GVCP_REQUEST_HEADER Header;
        GVCP_EVENT_ITEM_EXTENDED_ID Items[ 1 ];
    } GVCP_EVENT_REQUEST_EXTENDED_ID;

    typedef struct PACK_STRUCT GVCP_EVENTDATA_REQUEST_EXTENDED_ID
    {
        GVCP_REQUEST_HEADER Header;
        GVCP_EVENT_ITEM_EXTENDED_ID Event;
        uint32_t Data[ 1 ];
    } GVCP_EVENTDATA_REQUEST_EXTENDED_ID;

    const uint8_t COMMAND_MAGIC = 0x42;

    typedef enum GVCP_MESSAGE_TAGS
    {
        TAG_EVENT_CMD         = 0xc0,
        TAG_EVENTDATA_CMD     = 0xc2
    } GVCP_MESSAGE_TAGS;
    // restore the previous packing
#pragma pack(pop)
    /* ------------------------------------------- */


    class GENAPI_DECL CEventAdapterGEV : public  CEventAdapter
    {
    public:
        CEventAdapterGEV(INodeMap* pNodeMap = NULL);

        virtual ~CEventAdapterGEV();

        virtual void DeliverMessage( const uint8_t msg[], uint32_t numBytes );

        void DeliverEventMessage(const GVCP_EVENT_REQUEST *pEvent);

        void DeliverEventMessage(const GVCP_EVENTDATA_REQUEST *pEventData);

        void DeliverEventMessage(const GVCP_EVENT_REQUEST_EXTENDED_ID *pEvent);

        void DeliverEventMessage(const GVCP_EVENTDATA_REQUEST_EXTENDED_ID *pEventData);

    private:
        void DeliverEventItem(const GVCP_EVENT_ITEM_BASIC *pItem, unsigned int length);

        /*
        The code for handling event messages and attaching event items to the EventPort
        is the same for events with and without extended ID.
        Only the datatype differs, so we keep the implementation in these templates
        */
        template<typename EVT_REQ_TYPE> void DeliverEventMessageImpl(const EVT_REQ_TYPE *pEvent);
        template<typename EVT_REQ_TYPE> void DeliverEventDataMessageImpl(const EVT_REQ_TYPE *pEvent);
        void AttachItemToPorts(const uint8_t *pItem, uint16_t event_id, unsigned int length);

    };
}

#endif // GENAPI_EVENTADAPTERGEV_H