Debian Codegraph @

third_party/aub_stream/aubstream/aub_manager.h

raw
1 /*
2 * Copyright (C) 2022-2025 Intel Corporation
3 *
4 * SPDX-License-Identifier: MIT
5 *
6 */
7
8 #pragma once
9 #include <cstdint>
10 #include <string>
11 #include <vector>
12 #include "allocation_params.h"
13 #include "page_info.h"
14 #include "shared_mem_info.h"
15 #include "physical_allocation_info.h"
16
17 namespace aub_stream {
18
19 struct HardwareContext;
20 struct CreateHardwareContext2Params;
21 struct HardwareContextParamsHeader;
22
23 struct AubManagerOptions {
24 uint32_t version{};
25 uint32_t productFamily{};
26 uint32_t devicesCount{};
27 uint64_t memoryBankSize{};
28 uint32_t stepping{};
29 bool localMemorySupported{};
30 uint32_t mode{};
31 uint64_t gpuAddressSpace{};
32 SharedMemoryInfo sharedMemoryInfo{};
33 bool throwOnError{};
34 uint64_t dataStolenMemorySize{};
35 };
36
37 class AubManager {
38 public:
39 virtual ~AubManager() = default;
40
41 virtual HardwareContext *createHardwareContext(uint32_t device, uint32_t engine, uint32_t flags) = 0;
42
43 virtual void open(const std::string &aubFileName) = 0;
44 virtual void close() = 0;
45 virtual bool isOpen() = 0;
46 virtual const std::string getFileName() = 0;
47 virtual void pause(bool onoff) = 0;
48
49 virtual void addComment(const char *message) = 0;
50 virtual void writeMemory(uint64_t gfxAddress, const void *memory, size_t size, uint32_t memoryBanks, int hint, size_t pageSize) = 0;
51 virtual void writePageTableEntries(uint64_t gfxAddress, size_t size, uint32_t memoryBanks, int hint,
52 std::vector<PageInfo> &lastLevelPages, size_t pageSize) = 0;
53
54 virtual void writePhysicalMemoryPages(const void *memory, std::vector<PageInfo> &pages, size_t size, int hint) = 0;
55 virtual void freeMemory(uint64_t gfxAddress, size_t size) = 0;
56
57 virtual void writeMemory2(AllocationParams allocationParams) = 0;
58
59 static AubManager *create(const struct AubManagerOptions &options);
60
61 virtual bool reservePhysicalMemory(AllocationParams allocationParams, PhysicalAllocationInfo &physicalAllocInfo) = 0;
62 virtual bool mapGpuVa(uint64_t gfxAddress, size_t size, PhysicalAllocationInfo physicalAllocInfo) = 0;
63 virtual bool mapGpuVa2(uint64_t physicalAddress, AllocationParams params) { return false; }
64
65 virtual bool reserveOnlyPhysicalSpace(AllocationParams allocationParams, PhysicalAllocationInfo &physicalAllocInfo) { return false; }
66 virtual bool mapSystemMemoryToPhysicalAddress(uint64_t physAddress, size_t size, size_t alignment, bool isLocalMemory, const void *p) { return false; }
67 virtual void *translatePhysicalAddressToSystemMemory(uint64_t physicalAddress, bool isLocalMemory) { return nullptr; }
68 virtual void writeMMIO(uint32_t offset, uint32_t value) {}
69 virtual uint32_t readMMIO(uint32_t offset) { return 0; }
70 virtual void writePCICFG(uint32_t offset, uint32_t value) {}
71 virtual uint32_t readPCICFG(uint32_t offset) { return 0; }
72
73 virtual void blockMemWritesViaTbx(bool onoff) {}
74
75 virtual bool releaseHardwareContext(HardwareContext *context) { return false; };
76 virtual HardwareContext *createHardwareContext2(const CreateHardwareContext2Params &params, uint32_t device, uint32_t engine, uint32_t flags) { return nullptr; };
77
78 virtual void setCCSMode(uint32_t ccsCount) {}
79 virtual void closeSocket(void) {}
80 virtual HardwareContext *createHardwareContext3(const HardwareContextParamsHeader *params) { return nullptr; }
81 };
82
83 } // namespace aub_stream