1//===- Target.cpp - MLIR SPIR-V target compilation --------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This files defines SPIR-V target related functions including registration
10// calls for the `#spirv.target_env` compilation attribute.
11//
12//===----------------------------------------------------------------------===//
13
14#include "mlir/Target/SPIRV/Target.h"
15
16#include "mlir/Dialect/GPU/IR/GPUDialect.h"
17#include "mlir/Dialect/SPIRV/IR/SPIRVAttributes.h"
18#include "mlir/Dialect/SPIRV/IR/SPIRVDialect.h"
19#include "mlir/Dialect/SPIRV/IR/SPIRVOps.h"
20#include "mlir/Target/SPIRV/Serialization.h"
21
22#include <cstdlib>
23#include <cstring>
24
25using namespace mlir;
26using namespace mlir::spirv;
27
28namespace {
29// SPIR-V implementation of the gpu:TargetAttrInterface.
30class SPIRVTargetAttrImpl
31 : public gpu::TargetAttrInterface::FallbackModel<SPIRVTargetAttrImpl> {
32public:
33 std::optional<mlir::gpu::SerializedObject>
34 serializeToObject(Attribute attribute, Operation *module,
35 const gpu::TargetOptions &options) const;
36
37 Attribute createObject(Attribute attribute, Operation *module,
38 const mlir::gpu::SerializedObject &object,
39 const gpu::TargetOptions &options) const;
40};
41} // namespace
42
43// Register the SPIR-V dialect, the SPIR-V translation & the target interface.
44void mlir::spirv::registerSPIRVTargetInterfaceExternalModels(
45 DialectRegistry &registry) {
46 registry.addExtension(extensionFn: +[](MLIRContext *ctx, spirv::SPIRVDialect *dialect) {
47 spirv::TargetEnvAttr::attachInterface<SPIRVTargetAttrImpl>(context&: *ctx);
48 });
49}
50
51void mlir::spirv::registerSPIRVTargetInterfaceExternalModels(
52 MLIRContext &context) {
53 DialectRegistry registry;
54 registerSPIRVTargetInterfaceExternalModels(registry);
55 context.appendDialectRegistry(registry);
56}
57
58// Reuse from existing serializer
59std::optional<mlir::gpu::SerializedObject>
60SPIRVTargetAttrImpl::serializeToObject(
61 Attribute attribute, Operation *module,
62 const gpu::TargetOptions &options) const {
63 if (!module)
64 return std::nullopt;
65 auto gpuMod = dyn_cast<gpu::GPUModuleOp>(Val: module);
66 if (!gpuMod) {
67 module->emitError(message: "expected to be a gpu.module op");
68 return std::nullopt;
69 }
70 auto spvMods = gpuMod.getOps<spirv::ModuleOp>();
71 if (spvMods.empty())
72 return std::nullopt;
73
74 auto spvMod = *spvMods.begin();
75 llvm::SmallVector<uint32_t, 0> spvBinary;
76
77 spvBinary.clear();
78 // Serialize the spirv.module op to SPIR-V blob.
79 if (mlir::failed(Result: spirv::serialize(moduleOp: spvMod, binary&: spvBinary))) {
80 spvMod.emitError() << "failed to serialize SPIR-V module";
81 return std::nullopt;
82 }
83
84 SmallVector<char, 0> spvData(spvBinary.size() * sizeof(uint32_t), 0);
85 std::memcpy(dest: spvData.data(), src: spvBinary.data(), n: spvData.size());
86
87 spvMod.erase();
88 return gpu::SerializedObject{std::move(spvData)};
89}
90
91// Prepare Attribute for gpu.binary with serialized kernel object
92Attribute
93SPIRVTargetAttrImpl::createObject(Attribute attribute, Operation *module,
94 const mlir::gpu::SerializedObject &object,
95 const gpu::TargetOptions &options) const {
96 gpu::CompilationTarget format = options.getCompilationTarget();
97 DictionaryAttr objectProps;
98 Builder builder(attribute.getContext());
99 return builder.getAttr<gpu::ObjectAttr>(
100 args&: attribute, args&: format,
101 args: builder.getStringAttr(
102 bytes: StringRef(object.getObject().data(), object.getObject().size())),
103 args&: objectProps, /*kernels=*/args: nullptr);
104}
105