adding SDAccel driver (#32)

Change-Id: I4409f468bb2f680086ce8768e5a700fcd2280cd5

Author: AWSwinefred

sdk/SDAccel/HAL/driver/include/xclbin.h

@@ -0,0 +1,124 @@
+/**
+ * Xilinx SDAccel xclbin container definition
+ * Copyright (C) 2015-2016, Xilinx Inc - All rights reserved
+ */
+
+#ifndef _XCLBIN_H_
+#define _XCLBIN_H_
+
+#if defined(__KERNEL__)
+#include <linux/types.h>
+#elif defined(__cplusplus)
+#include <cstdlib>
+#include <cstdint>
+#else
+#include <stdlib.h>
+#include <stdint.h>
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+    /**
+     * Container format for Xilinx bitstreams, metadata and other
+     * binary blobs.
+     * Every segment must be aligned at 8 byte boundary with null byte padding
+     * between adjacent segments if required.
+     * For segements which are not present both offset and length must be 0 in
+     * the header.
+     * Currently only xclbin0\0 is recognized as file magic. In future if/when file
+     * format is updated the magic string will be changed to xclbin1\0 and so on.
+     */
+    enum XCLBIN_MODE {
+        XCLBIN_FLAT,
+        XCLBIN_PR,
+        XCLBIN_TANDEM_STAGE2,
+        XCLBIN_TANDEM_STAGE2_WITH_PR,
+        XCLBIN_MODE_MAX
+    };
+
+    struct xclBin {
+        char m_magic[8];                    /* should be xclbin0\0  */
+        uint64_t m_length;                  /* total size of the xclbin file */
+        uint64_t m_timeStamp;               /* number of seconds since epoch when xclbin was created */
+        uint64_t m_version;                 /* tool version used to create xclbin */
+        unsigned m_mode;                    /* XCLBIN_MODE */
+        char m_nextXclBin[24];              /* Name of next xclbin file in the daisy chain */
+        uint64_t m_metadataOffset;          /* file offset of embedded metadata */
+        uint64_t m_metadataLength;          /* size of the embedded metdata */
+        uint64_t m_primaryFirmwareOffset;   /* file offset of bitstream or emulation archive */
+        uint64_t m_primaryFirmwareLength;   /* size of the bistream or emulation archive */
+        uint64_t m_secondaryFirmwareOffset; /* file offset of clear bitstream if any */
+        uint64_t m_secondaryFirmwareLength; /* size of the clear bitstream */
+        uint64_t m_driverOffset;            /* file offset of embedded device driver if any (currently unused) */
+        uint64_t m_driverLength;            /* size of the embedded device driver (currently unused) */
+
+        // Extra debug information for hardware and hardware emulation debug
+
+        uint64_t m_dwarfOffset ;
+        uint64_t m_dwarfLength ;
+        uint64_t m_ipiMappingOffset ;
+        uint64_t m_ipiMappingLength ;
+    };
+
+    /*
+     *  XCLBIN1 LAYOUT
+     *  --------------
+     *
+     *  -----------------------------------------
+     *  | Magic                                 |
+     *  -----------------------------------------
+     *  | Header                                |
+     *  -----------------------------------------
+     *  | One or more section headers           |
+     *  -----------------------------------------
+     *  | Matching number of sections with data |
+     *  -----------------------------------------
+     *
+     */
+    enum xclBin1SectionKind {
+        BITSTREAM,
+        CLEARING_BITSTREAM,
+        EMBEDDED_METADATA,
+        FIRMWARE,
+        DEBUG_DATA
+    };
+
+    struct xclBin1SectionHeader {
+        unsigned m_sectionKind;             /* Section type */
+        unsigned short m_freq[4];           /* Target frequency for the section if applicable */
+        char m_sectionName[16];             /* Examples: "stage2", "clear1", "clear2", "ocl1", "ocl2, "ublaze" */
+        unsigned m_customFlagsA;            /* Example: Number of Kernels in this region */
+        unsigned m_customFlagsB;            /* Example: Number of Kernels in this region */
+        uint64_t m_sectionOffset;           /* File offset of section data */
+        uint64_t m_sectionSize;             /* Size of section data */
+    };
+
+    struct xclBin1Header {
+        uint64_t m_length;                  /* Total size of the xclbin file */
+        uint64_t m_timeStamp;               /* Number of seconds since epoch when xclbin was created */
+        unsigned m_version;                 /* Tool version used to create xclbin */
+        unsigned m_mode;                    /* XCLBIN_MODE */
+        uint64_t m_platformId;              /* 64 bit platform ID: vendor-device-subvendor-subdev */
+        uint64_t m_featureId;               /* 64 bit feature id */
+        char m_nextXclBin[16];              /* Name of next xclbin file in the daisy chain */
+        char m_debugBin[16];                /* Name of binary with debug information */
+        unsigned m_numSections;             /* Number of section headers */
+    };
+
+    struct xclBin1 {
+        char m_magic[8];                            /* Should be xclbin1\0  */
+        uint64_t m_signature[4];                    /* File signature for validation of binary */
+        struct xclBin1Header m_header;              /* Inline header */
+        struct xclBin1SectionHeader m_sections[1];  /* One or more section headers follow */
+    };
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+
+// XSIP watermark, do not delete 67d7842dbbe25473c3c32b93c0da8047785f30d78e8a024de1b57352245f9689