nvscistream.h

Go to the documentation of this file.

/*
 * Copyright (c) 2018-2019 NVIDIA Corporation. All rights reserved.
 *
 * NVIDIA Corporation and its licensors retain all intellectual property and
 * proprietary rights in and to this software, related documentation and any
 * modifications thereto. Any use, reproduction, disclosure or distribution
 * of this software and related documentation without an express license
 * agreement from NVIDIA Corporation is strictly prohibited.
 */
#ifndef NVSCISTREAM_H
#define NVSCISTREAM_H

#ifdef __cplusplus
#include <cstdint>
#else
#include <stdint.h>
#endif

#include "nvscierror.h"
#include "nvscibuf.h"
#include "nvscisync.h"
#include "nvsciipc.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef uintptr_t NvSciStreamBlock;

typedef uintptr_t NvSciStreamPacket;

typedef uintptr_t NvSciStreamCookie;

static const NvSciStreamPacket NvSciStreamPacket_Invalid = 0U;

static const NvSciStreamCookie NvSciStreamCookie_Invalid = 0U;

typedef enum {
    NvSciStreamQueryableAttrib_MaxElements          = 0x000000,
    NvSciStreamQueryableAttrib_MaxSyncObj           = 0x000001,
    NvSciStreamQueryableAttrib_MaxMulticastOutputs  = 0x000002
} NvSciStreamQueryableAttrib;

typedef enum {
    NvSciStreamElementMode_Asynchronous     = 0x000000,
    NvSciStreamElementMode_Immediate        = 0x000001
} NvSciStreamElementMode;

typedef enum {

    NvSciStreamEventType_Connected                  = 0x004004,

    NvSciStreamEventType_Disconnected               = 0x004005,

    NvSciStreamEventType_SyncAttr                   = 0x004010,

    NvSciStreamEventType_SyncCount                  = 0x004011,

    NvSciStreamEventType_SyncDesc                   = 0x004012,

    NvSciStreamEventType_PacketElementCountProducer = 0x004020,

    NvSciStreamEventType_PacketElementCountConsumer = 0x004021,

    NvSciStreamEventType_PacketElementCount         = 0x004022,

    NvSciStreamEventType_PacketAttrProducer         = 0x004023,

    NvSciStreamEventType_PacketAttrConsumer         = 0x004024,

    NvSciStreamEventType_PacketAttr                 = 0x004025,

    NvSciStreamEventType_PacketCreate               = 0x004030,

    NvSciStreamEventType_PacketElement              = 0x004031,

    NvSciStreamEventType_PacketDelete               = 0x004032,

    NvSciStreamEventType_PacketStatusProducer       = 0x004033,

    NvSciStreamEventType_PacketStatusConsumer       = 0x004034,

    NvSciStreamEventType_ElementStatusProducer      = 0x004035,

    NvSciStreamEventType_ElementStatusConsumer      = 0x004036,

    NvSciStreamEventType_PacketReady                = 0x004040,

    NvSciStreamEventType_Error                      = 0x0040FF

} NvSciStreamEventType;

typedef struct {
    NvSciStreamEventType type;

    NvSciSyncAttrList syncAttrList;

    NvSciBufAttrList bufAttrList;

    NvSciSyncObj syncObj;

    NvSciBufObj bufObj;

    NvSciStreamPacket packetHandle;

    NvSciStreamCookie packetCookie;

    uint32_t count;

    uint32_t index;

    NvSciError error;

    uint32_t userData;

    bool synchronousOnly;

    NvSciStreamElementMode syncMode;

} NvSciStreamEvent;

NvSciError NvSciStreamBlockConnect(
    NvSciStreamBlock upstream,
    NvSciStreamBlock downstream
);

NvSciError NvSciStreamProducerCreate(
    NvSciStreamBlock pool,
    NvSciStreamBlock *producer
);

NvSciError NvSciStreamConsumerCreate(
    NvSciStreamBlock queue,
    NvSciStreamBlock *consumer
);

NvSciError NvSciStreamStaticPoolCreate(
    uint32_t numPackets,
    NvSciStreamBlock *pool
);

NvSciError NvSciStreamMailboxQueueCreate(
    NvSciStreamBlock *queue
);

NvSciError NvSciStreamFifoQueueCreate(
    NvSciStreamBlock *queue
);

NvSciError NvSciStreamMulticastCreate(
    uint32_t outputCount,
    NvSciStreamBlock *multicast
);

NvSciError NvSciStreamIpcSrcCreate(
    NvSciIpcEndpoint ipcEndpoint,
    NvSciSyncModule syncModule,
    NvSciBufModule bufModule,
    NvSciStreamBlock *ipc
);

NvSciError NvSciStreamIpcDstCreate(
    NvSciIpcEndpoint ipcEndpoint,
    NvSciSyncModule syncModule,
    NvSciBufModule bufModule,
    NvSciStreamBlock *ipc
);

NvSciError NvSciStreamBlockEventQuery(
    NvSciStreamBlock block,
    int64_t timeoutUsec,
    NvSciStreamEvent *event
);

NvSciError NvSciStreamBlockSyncRequirements(
    NvSciStreamBlock block,
    bool synchronousOnly,
    NvSciSyncAttrList waitSyncAttrList
);

NvSciError NvSciStreamBlockSyncObjCount(
    NvSciStreamBlock block,
    uint32_t count
);

NvSciError NvSciStreamBlockSyncObject(
    NvSciStreamBlock block,
    uint32_t index,
    NvSciSyncObj syncObj
);

NvSciError NvSciStreamBlockPacketElementCount(
    NvSciStreamBlock block,
    uint32_t count
);

NvSciError NvSciStreamBlockPacketAttr(
    NvSciStreamBlock block,
    uint32_t index,
    uint32_t type,
    NvSciStreamElementMode syncMode,
    NvSciBufAttrList bufAttrList
);

NvSciError NvSciStreamPoolPacketCreate(
    NvSciStreamBlock pool,
    NvSciStreamCookie cookie,
    NvSciStreamPacket *handle
);

NvSciError NvSciStreamPoolPacketInsertBuffer(
    NvSciStreamBlock pool,
    NvSciStreamPacket handle,
    uint32_t index,
    NvSciBufObj bufObj
);

NvSciError NvSciStreamPoolPacketDelete(
    NvSciStreamBlock pool,
    NvSciStreamPacket handle
);

NvSciError NvSciStreamBlockPacketAccept(
    NvSciStreamBlock block,
    NvSciStreamPacket handle,
    NvSciStreamCookie cookie,
    NvSciError err
);

NvSciError NvSciStreamBlockElementAccept(
    NvSciStreamBlock block,
    NvSciStreamPacket handle,
    uint32_t index,
    NvSciError err
);

NvSciError NvSciStreamProducerPacketGet(
    NvSciStreamBlock producer,
    NvSciStreamCookie *cookie, 
    NvSciSyncFence *prefences
);

NvSciError NvSciStreamProducerPacketPresent(
    NvSciStreamBlock producer,
    NvSciStreamPacket handle,
    NvSciSyncFence *postfences
);

NvSciError NvSciStreamConsumerPacketAcquire(
    NvSciStreamBlock consumer,
    NvSciStreamCookie *cookie, 
    NvSciSyncFence *prefences
);

NvSciError NvSciStreamConsumerPacketRelease(
    NvSciStreamBlock consumer,
    NvSciStreamPacket handle,
    NvSciSyncFence *postfences
);

NvSciError NvSciStreamBlockDelete(
    NvSciStreamBlock block
);

NvSciError NvSciStreamAttributeQuery(
    NvSciStreamQueryableAttrib attr,
    int32_t *value
);

typedef struct {
    uint32_t index;
    uint32_t type;
    NvSciStreamElementMode mode;
    NvSciBufAttrList bufAttr;
} NvSciStreamElementAttr;

typedef struct {
    uint32_t index;
    NvSciStreamPacket handle;
    NvSciBufObj buffer;
} NvSciStreamElementDesc;

typedef struct {
    bool synchronousOnly;
    NvSciSyncAttrList waiterSyncAttr;
} NvSciStreamSyncAttr;

typedef struct {
    uint32_t index;
    NvSciSyncObj sync;
} NvSciStreamSyncDesc;

typedef struct {
    NvSciStreamCookie cookie;
    NvSciSyncFence *prefences;
} NvSciStreamPayload;

#ifdef __cplusplus
}
#endif

#endif /* NVSCISTREAM_H */