本文將透過範例探索實驗性的 WebGPU API,協助您開始使用 GPU 執行資料平行運算。
背景
您可能已經知道,圖形處理器 (GPU) 是電腦內部專門用於處理圖形的電子子子系統。然而,在過去 10 年來,它已發展出更靈活的架構,讓開發人員能夠實作許多類型的演算法,而不僅是算繪 3D 圖形,同時還利用 GPU 的獨特架構。這些功能稱為 GPU 運算,而將 GPU 用於通用科學運算的副處理器,則稱為通用 GPU (GPGPU) 程式設計。
近期機器學習蓬勃發展,GPU 運算功不可沒,因為卷積神經網路和其他模型可利用架構在 GPU 上更有效率地執行。由於目前的網路平台缺乏 GPU 運算功能,W3C 的「GPU for the Web」社群群組正在設計 API,以便公開目前大多數裝置可用的新型 GPU API。這個 API 稱為 WebGPU。
WebGPU 是低階 API,類似於 WebGL。您會發現,這項工具非常強大且冗長。但沒關係。我們要的是效能。
在本文中,我將著重於 WebGPU 的 GPU 運算部分,老實說,我只是略微介紹一下,讓您可以自行開始玩玩看。我會在後續文章中深入探討 WebGPU 算繪 (畫布、紋理等)。
存取 GPU
在 WebGPU 中存取 GPU 非常簡單。呼叫 navigator.gpu.requestAdapter()
會傳回 JavaScript Promise,該 Promise 會以非同步方式解析 GPU 轉接程式。您可以將這個轉接器視為圖形卡。可以整合 (與 CPU 同個晶片) 或獨立 (通常是 PCIe 卡,效能較佳,但耗電量較高)。
取得 GPU 轉接器後,請呼叫 adapter.requestDevice()
來取得承諾,該承諾會解析您用於執行某些 GPU 運算的 GPU 裝置。
const adapter = await navigator.gpu.requestAdapter();
if (!adapter) { return; }
const device = await adapter.requestDevice();
兩個函式都會提供選項,讓您指定所需的轉接器類型 (電源偏好設定) 和裝置 (擴充功能、限制)。為求簡單起見,我們會在本文中使用預設選項。
寫入緩衝區記憶體
讓我們來看看如何使用 JavaScript 將資料寫入 GPU 記憶體。由於現代網頁瀏覽器採用沙箱模型,因此這個程序並不簡單。
以下範例說明如何將四個位元組寫入可從 GPU 存取的緩衝區記憶體。它會呼叫 device.createBuffer()
,該函式會擷取緩衝區的大小及其用途。雖然這個特定呼叫不需要使用用途旗標 GPUBufferUsage.MAP_WRITE
,但我們還是要明確指出要寫入這個緩衝區。由於 mappedAtCreation
設為 true,因此會在建立時對應 GPU 緩衝區物件。接著,您可以呼叫 GPU 緩衝區方法 getMappedRange()
,擷取相關的原始二進位資料緩衝區。
如果您已使用 ArrayBuffer
,那麼寫入位元組會很熟悉;請使用 TypedArray
,並將值複製到其中。
// Get a GPU buffer in a mapped state and an arrayBuffer for writing.
const gpuBuffer = device.createBuffer({
mappedAtCreation: true,
size: 4,
usage: GPUBufferUsage.MAP_WRITE
});
const arrayBuffer = gpuBuffer.getMappedRange();
// Write bytes to buffer.
new Uint8Array(arrayBuffer).set([0, 1, 2, 3]);
此時,GPU 緩衝區已對應,也就是說,它由 CPU 擁有,且可透過 JavaScript 讀取/寫入。因此,為了讓 GPU 能夠存取,必須取消對應,方法很簡單,只要呼叫 gpuBuffer.unmap()
即可。
需要使用已對應/未對應的概念,才能避免 GPU 和 CPU 同時存取記憶體的競爭狀態。
讀取緩衝區記憶體
接下來,我們來看看如何將 GPU 緩衝區複製到另一個 GPU 緩衝區,並讀取該緩衝區。
由於我們是在第一個 GPU 緩衝區中寫入資料,且想將資料複製到第二個 GPU 緩衝區,因此需要使用新的用途標記 GPUBufferUsage.COPY_SRC
。這次使用 device.createBuffer()
時,第二個 GPU 緩衝區是在未對應的狀態下建立。其用途旗標為 GPUBufferUsage.COPY_DST |
GPUBufferUsage.MAP_READ
,因為它會用於第一個 GPU 緩衝區的目的,並在執行 GPU 複製指令後,在 JavaScript 中讀取。
// Get a GPU buffer in a mapped state and an arrayBuffer for writing.
const gpuWriteBuffer = device.createBuffer({
mappedAtCreation: true,
size: 4,
usage: GPUBufferUsage.MAP_WRITE | GPUBufferUsage.COPY_SRC
});
const arrayBuffer = gpuWriteBuffer.getMappedRange();
// Write bytes to buffer.
new Uint8Array(arrayBuffer).set([0, 1, 2, 3]);
// Unmap buffer so that it can be used later for copy.
gpuWriteBuffer.unmap();
// Get a GPU buffer for reading in an unmapped state.
const gpuReadBuffer = device.createBuffer({
size: 4,
usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
});
由於 GPU 是獨立的輔助處理器,因此所有 GPU 指令都是以非同步方式執行。因此,系統會建立 GPU 指令清單,並視需要以批次傳送。在 WebGPU 中,device.createCommandEncoder()
傳回的 GPU 指令編碼器是 JavaScript 物件,用於建構批次會在某個時間點傳送至 GPU 的「緩衝處理」指令。另一方面,GPUBuffer
上的「unbuffered」方法,也就是在呼叫時會自動執行。
取得 GPU 指令編碼器後,請呼叫 copyEncoder.copyBufferToBuffer()
,如以下所示,將此指令新增至指令佇列,以便稍後執行。最後,呼叫 copyEncoder.finish()
來完成編碼指令,並將指令提交至 GPU 裝置指令佇列。佇列會負責處理透過 device.queue.submit()
提交的內容,並將 GPU 指令做為引數。這會依序執行陣列中儲存的所有指令。
// Encode commands for copying buffer to buffer.
const copyEncoder = device.createCommandEncoder();
copyEncoder.copyBufferToBuffer(
gpuWriteBuffer /* source buffer */,
0 /* source offset */,
gpuReadBuffer /* destination buffer */,
0 /* destination offset */,
4 /* size */
);
// Submit copy commands.
const copyCommands = copyEncoder.finish();
device.queue.submit([copyCommands]);
此時,GPU 佇列指令已傳送,但不一定會執行。如要讀取第二個 GPU 緩衝區,請使用 GPUMapMode.READ
呼叫 gpuReadBuffer.mapAsync()
。它會傳回一個 promise,在 GPU 緩衝區對應時會解析。接著,在執行所有排隊的 GPU 指令後,使用 gpuReadBuffer.getMappedRange()
取得對應的範圍,該範圍包含與第一個 GPU 緩衝區相同的值。
// Read buffer.
await gpuReadBuffer.mapAsync(GPUMapMode.READ);
const copyArrayBuffer = gpuReadBuffer.getMappedRange();
console.log(new Uint8Array(copyArrayBuffer));
您可以試用此範例。
簡而言之,請記住下列有關緩衝區記憶體作業的事項:
- 必須解除對應 GPU 緩衝區,才能在裝置佇列提交中使用。
- 對應後,您就能使用 JavaScript 讀取及寫入 GPU 緩衝區。
- 呼叫
mappedAtCreation
設為 true 的mapAsync()
和createBuffer()
時,系統會對應 GPU 緩衝區。
著色器程式設計
在 GPU 上執行的程式,如果只執行運算 (且不會繪製三角形),就稱為運算著色器。這些作業會由數百個 GPU 核心 (比 CPU 核心小) 平行執行,這些核心會共同運作以處理資料。其輸入和輸出內容是 WebGPU 中的緩衝區。
為了說明在 WebGPU 中使用運算著色器的情形,我們將試用矩陣乘法,也就是機器學習中的通用演算法 (如下所示)。
簡單來說,我們將進行下列事項:
- 建立三個 GPU 緩衝區 (兩個用來相乘矩陣,另一個用於結果矩陣)
- 說明運算著色器的輸入和輸出
- 編譯運算著色器程式碼
- 設定運算管道
- 以批次方式將已編碼的指令提交至 GPU
- 讀取結果矩陣 GPU 緩衝區
建立 GPU 緩衝區
為求簡單,矩陣會以浮點數清單表示。第一個元素是資料列數量,第二個元素是資料欄數量,其餘則是矩陣的實際數字。
這三個 GPU 緩衝區都是儲存緩衝區,因為我們需要在運算著色器中儲存及擷取資料。這也說明為何 GPU 緩衝區用法標記會為所有標記加入 GPUBufferUsage.STORAGE
。結果矩陣用途標記也會有 GPUBufferUsage.COPY_SRC
,因為在執行所有 GPU 佇列指令後,系統會將該標記複製到另一個緩衝區以供讀取。
const adapter = await navigator.gpu.requestAdapter();
if (!adapter) { return; }
const device = await adapter.requestDevice();
// First Matrix
const firstMatrix = new Float32Array([
2 /* rows */, 4 /* columns */,
1, 2, 3, 4,
5, 6, 7, 8
]);
const gpuBufferFirstMatrix = device.createBuffer({
mappedAtCreation: true,
size: firstMatrix.byteLength,
usage: GPUBufferUsage.STORAGE,
});
const arrayBufferFirstMatrix = gpuBufferFirstMatrix.getMappedRange();
new Float32Array(arrayBufferFirstMatrix).set(firstMatrix);
gpuBufferFirstMatrix.unmap();
// Second Matrix
const secondMatrix = new Float32Array([
4 /* rows */, 2 /* columns */,
1, 2,
3, 4,
5, 6,
7, 8
]);
const gpuBufferSecondMatrix = device.createBuffer({
mappedAtCreation: true,
size: secondMatrix.byteLength,
usage: GPUBufferUsage.STORAGE,
});
const arrayBufferSecondMatrix = gpuBufferSecondMatrix.getMappedRange();
new Float32Array(arrayBufferSecondMatrix).set(secondMatrix);
gpuBufferSecondMatrix.unmap();
// Result Matrix
const resultMatrixBufferSize = Float32Array.BYTES_PER_ELEMENT * (2 + firstMatrix[0] * secondMatrix[1]);
const resultMatrixBuffer = device.createBuffer({
size: resultMatrixBufferSize,
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC
});
繫結群組版面配置和繫結群組
綁定群組版面配置和綁定群組的概念是 WebGPU 專屬。繫結群組版面配置會定義著色器預期的輸入/輸出介面,繫結群組則代表著色器的實際輸入/輸出資料。
在以下範例中,繫結群組版面配置會預期在編號為 0
和 1
的項目繫結中,有兩個唯讀儲存空間緩衝區,以及在 2
中為運算著色器提供一個儲存空間緩衝區。另一方面,為這個繫結群組版面配置定義的繫結群組,會將 GPU 緩衝區與項目建立關聯:gpuBufferFirstMatrix
與繫結 0
、gpuBufferSecondMatrix
與繫結 1
,以及 resultMatrixBuffer
與繫結 2
。
const bindGroupLayout = device.createBindGroupLayout({
entries: [
{
binding: 0,
visibility: GPUShaderStage.COMPUTE,
buffer: {
type: "read-only-storage"
}
},
{
binding: 1,
visibility: GPUShaderStage.COMPUTE,
buffer: {
type: "read-only-storage"
}
},
{
binding: 2,
visibility: GPUShaderStage.COMPUTE,
buffer: {
type: "storage"
}
}
]
});
const bindGroup = device.createBindGroup({
layout: bindGroupLayout,
entries: [
{
binding: 0,
resource: {
buffer: gpuBufferFirstMatrix
}
},
{
binding: 1,
resource: {
buffer: gpuBufferSecondMatrix
}
},
{
binding: 2,
resource: {
buffer: resultMatrixBuffer
}
}
]
});
運算著色器程式碼
用於相乘矩陣的運算著色器程式碼是以 WGSL (WebGPU 著色器語言) 編寫,而這類程式碼可輕鬆轉譯為 SPIR-V。不必深入探討細節,您應該會在下方找到以 var<storage>
標示的三個儲存體緩衝區。程式會使用 firstMatrix
和 secondMatrix
做為輸入內容,並使用 resultMatrix
做為輸出內容。
請注意,每個儲存體緩衝區都會使用 binding
修飾符,對應至在綁定群組版面配置和綁定群組中定義的相同索引。
const shaderModule = device.createShaderModule({
code: `
struct Matrix {
size : vec2f,
numbers: array<f32>,
}
@group(0) @binding(0) var<storage, read> firstMatrix : Matrix;
@group(0) @binding(1) var<storage, read> secondMatrix : Matrix;
@group(0) @binding(2) var<storage, read_write> resultMatrix : Matrix;
@compute @workgroup_size(8, 8)
fn main(@builtin(global_invocation_id) global_id : vec3u) {
// Guard against out-of-bounds work group sizes
if (global_id.x >= u32(firstMatrix.size.x) || global_id.y >= u32(secondMatrix.size.y)) {
return;
}
resultMatrix.size = vec2(firstMatrix.size.x, secondMatrix.size.y);
let resultCell = vec2(global_id.x, global_id.y);
var result = 0.0;
for (var i = 0u; i < u32(firstMatrix.size.y); i = i + 1u) {
let a = i + resultCell.x * u32(firstMatrix.size.y);
let b = resultCell.y + i * u32(secondMatrix.size.y);
result = result + firstMatrix.numbers[a] * secondMatrix.numbers[b];
}
let index = resultCell.y + resultCell.x * u32(secondMatrix.size.y);
resultMatrix.numbers[index] = result;
}
`
});
管道設定
運算管道物件會實際描述要執行的運算作業。呼叫 device.createComputePipeline()
即可建立。它需要兩個引數:先前建立的繫結群組版面配置,以及定義運算著色器 (main
WGSL 函式) 的進入點和使用 device.createShaderModule()
建立的實際運算著色器模組的運算階段。
const computePipeline = device.createComputePipeline({
layout: device.createPipelineLayout({
bindGroupLayouts: [bindGroupLayout]
}),
compute: {
module: shaderModule,
entryPoint: "main"
}
});
提交指令
使用三個 GPU 緩衝區和具有繫結群組版面的運算管道,將繫結群組例項化後,就可以使用這些項目。
讓我們使用 commandEncoder.beginComputePass()
啟動可程式設計的運算傳遞編碼器。我們會使用這些內容來對可以執行矩陣乘法的 GPU 指令進行編碼。請使用 passEncoder.setPipeline(computePipeline)
設定管道,並使用 passEncoder.setBindGroup(0, bindGroup)
設定索引 0 的繫結群組。索引 0 對應至 WGSL 程式碼中的 group(0)
修飾。
接下來,我們來談談這個運算著色器如何在 GPU 上執行。我們的目標是逐步對結果矩陣的每個儲存格平行執行本程式。舉例來說,如果結果矩陣的大小為 16 x 32,為了在 @workgroup_size(8, 8)
上編碼執行指令,我們會呼叫 passEncoder.dispatchWorkgroups(2, 4)
或 passEncoder.dispatchWorkgroups(16 / 8, 32 / 8)
。第一個引數「x」是第一個維度,第二個引數「y」是第二個維度,而最後一個引數「z」是第三個維度,預設值為 1,因為我們在這裡不需要這個維度。在 GPU 運算世界中,將指令編碼為在資料集上執行核心函式的運算,稱為調度。
運算著色器的工作群組格線大小是 WGSL 程式碼中的 (8, 8)
。因此,分別代表第一個矩陣的列數和第二個矩陣的欄數的「x」和「y」會除以 8。因此,我們現在可以使用 passEncoder.dispatchWorkgroups(firstMatrix[0] / 8, secondMatrix[1] / 8)
調度運算呼叫。要執行的工作群組格線數量是 dispatchWorkgroups()
引數。
如上圖所示,每個著色器都會存取一個唯一的 builtin(global_invocation_id)
物件,用於瞭解要計算哪個結果矩陣儲存格。
const commandEncoder = device.createCommandEncoder();
const passEncoder = commandEncoder.beginComputePass();
passEncoder.setPipeline(computePipeline);
passEncoder.setBindGroup(0, bindGroup);
const workgroupCountX = Math.ceil(firstMatrix[0] / 8);
const workgroupCountY = Math.ceil(secondMatrix[1] / 8);
passEncoder.dispatchWorkgroups(workgroupCountX, workgroupCountY);
passEncoder.end();
如要結束運算傳遞編碼器,請呼叫 passEncoder.end()
。接著,建立 GPU 緩衝區,做為使用 copyBufferToBuffer
複製結果矩陣緩衝區的目的。最後,請使用 copyEncoder.finish()
完成編碼指令,並透過 GPU 指令呼叫 device.queue.submit()
,將這些指令提交至 GPU 裝置佇列。
// Get a GPU buffer for reading in an unmapped state.
const gpuReadBuffer = device.createBuffer({
size: resultMatrixBufferSize,
usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
});
// Encode commands for copying buffer to buffer.
commandEncoder.copyBufferToBuffer(
resultMatrixBuffer /* source buffer */,
0 /* source offset */,
gpuReadBuffer /* destination buffer */,
0 /* destination offset */,
resultMatrixBufferSize /* size */
);
// Submit GPU commands.
const gpuCommands = commandEncoder.finish();
device.queue.submit([gpuCommands]);
讀取結果矩陣
讀取結果矩陣的做法很簡單,只要使用 GPUMapMode.READ
呼叫 gpuReadBuffer.mapAsync()
,然後等待傳回的承諾解決,即可表示 GPU 緩衝區已對應。此時,您可以使用 gpuReadBuffer.getMappedRange()
取得對應的範圍。
在我們的程式碼中,開發人員工具 JavaScript 控制台顯示的結果為「2, 2, 50, 60, 114, 140」。
// Read buffer.
await gpuReadBuffer.mapAsync(GPUMapMode.READ);
const arrayBuffer = gpuReadBuffer.getMappedRange();
console.log(new Float32Array(arrayBuffer));
恭喜!你做到了。您可以播放範例檔案。
最後一個技巧
如要讓程式碼更容易讀取,其中一種方法是使用運算管道的實用 getBindGroupLayout
方法,從著色器模組推論繫結的群組版面配置。這項技巧可免除您在運算管道中建立自訂繫結群組版面配置,以及指定管道版面配置的必要性,如下所示。
上例的 getBindGroupLayout
插圖已可使用。
const computePipeline = device.createComputePipeline({
- layout: device.createPipelineLayout({
- bindGroupLayouts: [bindGroupLayout]
- }),
compute: {
-// Bind group layout and bind group
- const bindGroupLayout = device.createBindGroupLayout({
- entries: [
- {
- binding: 0,
- visibility: GPUShaderStage.COMPUTE,
- buffer: {
- type: "read-only-storage"
- }
- },
- {
- binding: 1,
- visibility: GPUShaderStage.COMPUTE,
- buffer: {
- type: "read-only-storage"
- }
- },
- {
- binding: 2,
- visibility: GPUShaderStage.COMPUTE,
- buffer: {
- type: "storage"
- }
- }
- ]
- });
+// Bind group
const bindGroup = device.createBindGroup({
- layout: bindGroupLayout,
+ layout: computePipeline.getBindGroupLayout(0 /* index */),
entries: [
成效檢測結果
那麼,在 GPU 上執行矩陣乘積與在 CPU 上執行的差異為何?為了找出答案,我為 CPU 寫了上述程式。如下圖所示,當矩陣大小大於 256 x 256 時,使用 GPU 的全部效能似乎是顯而易見的選擇。
這篇文章只是我探索 WebGPU 的起點。我們很快就會推出更多文章,深入探討 GPU 運算,以及在 WebGPU 中如何進行算繪 (畫布、紋理、取樣器)。