cuda учебник
Начало работы с cuda

замечания

Версии

Предпосылки

Чтобы начать программирование с CUDA, загрузите и установите CUDA Toolkit и драйвер разработчика . Инструментарий включает в себя nvcc , компилятор NVIDIA CUDA и другое программное обеспечение, необходимое для разработки приложений CUDA. Драйвер гарантирует, что программы GPU будут работать правильно на оборудовании с поддержкой CUDA , которое вам также понадобится.

Вы можете подтвердить, что CUDA Toolkit правильно установлен на вашем компьютере, запустив nvcc --version из командной строки. Например, на машине Linux,

$ nvcc --version
nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2016 NVIDIA Corporation
Built on Tue_Jul_12_18:28:38_CDT_2016
Cuda compilation tools, release 8.0, V8.0.32

выводит информацию о компиляторе. Если предыдущая команда не была успешной, то CUDA Toolkit, скорее всего, не установлен или путь к nvcc ( C:\CUDA\bin на машинах Windows, /usr/local/cuda/bin в ОС POSIX) не является частью вашего PATH .

Кроме того, вам также понадобится компилятор хоста, который работает с nvcc для компиляции и сборки программ CUDA. В Windows это cl.exe , компилятор Microsoft, который поставляется с Microsoft Visual Studio. В ОС POSIX доступны другие компиляторы, включая gcc или g++ . В официальном кратком руководстве CUDA вы можете узнать, какие версии компилятора поддерживаются на вашей конкретной платформе.

Чтобы убедиться, что все настроено правильно, давайте скомпилируем и запустим тривиальную программу CUDA, чтобы все инструменты работали правильно.

__global__ void foo() {}

int main()
{
  foo<<<1,1>>>();

  cudaDeviceSynchronize();
  printf("CUDA error: %s\n", cudaGetErrorString(cudaGetLastError()));

  return 0;
}

Чтобы скомпилировать эту программу, скопируйте ее в файл с именем test.cu и скомпилируйте ее из командной строки. Например, в системе Linux должно работать следующее:

$ nvcc test.cu -o test
$ ./test
CUDA error: no error

Если программа удалась без ошибок, тогда давайте начнем кодирование!

Суммируйте два массива с CUDA

В этом примере показано, как создать простую программу, которая суммирует два массива int с CUDA.

Программа CUDA гетерогенна и состоит из частей, работающих как на процессоре, так и на графическом процессоре.

Основные части программы, использующие CUDA, аналогичны программам ЦП и состоят из

• Распределение памяти для данных, которые будут использоваться на графическом процессоре
• Копирование данных из памяти хоста в память графических процессоров
• Вызов функции ядра для обработки данных
• Результат копирования в память ЦП

Чтобы выделить память устройств, мы используем функцию cudaMalloc . Для копирования данных между устройством и хостом может использоваться функция cudaMemcpy . Последний аргумент cudaMemcpy указывает направление операции копирования. Существует 5 возможных типов:

• cudaMemcpyHostToHost - Хост -> Хост
• cudaMemcpyHostToDevice - Хост -> Устройство
• cudaMemcpyDeviceToHost - Устройство -> Хост
• cudaMemcpyDeviceToDevice - Устройство -> Устройство
• cudaMemcpyDefault - унифицированное виртуальное адресное пространство по умолчанию

Затем вызывается функция ядра. Информация между тройными шевронами - это конфигурация исполнения, которая определяет, сколько потоков устройств выполняет ядро ​​параллельно. Первое число ( 2 в примере) указывает количество блоков и второе ( (size + 1) / 2 в примере) - количество потоков в блоке. Обратите внимание, что в этом примере мы добавляем 1 к размеру, так что мы запрашиваем один дополнительный поток, а не один поток, ответственный за два элемента.

Поскольку вызов ядра является асинхронной функцией, cudaDeviceSynchronize вызывается для ожидания завершения выполнения. Массивы результатов копируются в память хоста, и вся память, выделенная на устройстве, освобождается cudaFree .

Для определения функции используется __global__ объявления __global__ . Эта функция будет вызываться каждым потоком. Если мы хотим, чтобы каждый поток обрабатывал элемент результирующего массива, нам нужно средство для выделения и идентификации каждого потока. CUDA определяет переменные blockDim , blockIdx и threadIdx . blockDim переменная blockDim содержит размеры каждого потока, как указано во втором параметре конфигурации выполнения для запуска ядра. threadIdx переменные threadIdx и blockIdx содержат индекс потока в его blockIdx блоке и блок потока в сетке, соответственно. Обратите внимание: поскольку мы потенциально запрашиваем еще один поток, чем элементы в массивах, нам нужно передать size чтобы гарантировать, что мы не получаем доступ к концу массива.

#include "cuda_runtime.h"
#include "device_launch_parameters.h"

#include <stdio.h>

__global__ void addKernel(int* c, const int* a, const int* b, int size) {
    int i = blockIdx.x * blockDim.x + threadIdx.x;
    if (i < size) {
        c[i] = a[i] + b[i];
    }
}

// Helper function for using CUDA to add vectors in parallel.
void addWithCuda(int* c, const int* a, const int* b, int size) {
    int* dev_a = nullptr;
    int* dev_b = nullptr;
    int* dev_c = nullptr;

    // Allocate GPU buffers for three vectors (two input, one output)
    cudaMalloc((void**)&dev_c, size * sizeof(int));
    cudaMalloc((void**)&dev_a, size * sizeof(int));
    cudaMalloc((void**)&dev_b, size * sizeof(int));

    // Copy input vectors from host memory to GPU buffers.
    cudaMemcpy(dev_a, a, size * sizeof(int), cudaMemcpyHostToDevice);
    cudaMemcpy(dev_b, b, size * sizeof(int), cudaMemcpyHostToDevice);

    // Launch a kernel on the GPU with one thread for each element.
    // 2 is number of computational blocks and (size + 1) / 2 is a number of threads in a block
    addKernel<<<2, (size + 1) / 2>>>(dev_c, dev_a, dev_b, size);
    
    // cudaDeviceSynchronize waits for the kernel to finish, and returns
    // any errors encountered during the launch.
    cudaDeviceSynchronize();

    // Copy output vector from GPU buffer to host memory.
    cudaMemcpy(c, dev_c, size * sizeof(int), cudaMemcpyDeviceToHost);

    cudaFree(dev_c);
    cudaFree(dev_a);
    cudaFree(dev_b);
}

int main(int argc, char** argv) {
    const int arraySize = 5;
    const int a[arraySize] = {  1,  2,  3,  4,  5 };
    const int b[arraySize] = { 10, 20, 30, 40, 50 };
    int c[arraySize] = { 0 };

    addWithCuda(c, a, b, arraySize);

    printf("{1, 2, 3, 4, 5} + {10, 20, 30, 40, 50} = {%d, %d, %d, %d, %d}\n", c[0], c[1], c[2], c[3], c[4]);

    cudaDeviceReset();

    return 0;
}

Давайте запустим один поток CUDA, чтобы поздороваться

Эта простая программа CUDA демонстрирует, как написать функцию, которая будет выполняться на графическом процессоре (ака «устройство»). ЦП или «хост» создают потоки CUDA, вызывая специальные функции, называемые «ядрами». Программы CUDA - это программы на C ++ с дополнительным синтаксисом.

Чтобы увидеть, как это работает, поместите следующий код в файл с именем hello.cu :

#include <stdio.h>

// __global__ functions, or "kernels", execute on the device
__global__ void hello_kernel(void)
{
  printf("Hello, world from the device!\n");
}

int main(void)
{
  // greet from the host
  printf("Hello, world from the host!\n");

  // launch a kernel with a single thread to greet from the device
  hello_kernel<<<1,1>>>();

  // wait for the device to finish so that we see the message
  cudaDeviceSynchronize();

  return 0;
}

(Обратите внимание, что для использования printf на устройстве вам требуется устройство с вычислительной способностью не менее 2.0. Подробнее см. В обзоре версий .)

Теперь давайте скомпилируем программу с помощью компилятора NVIDIA и запустим ее:

$ nvcc hello.cu -o hello
$ ./hello
Hello, world from the host!
Hello, world from the device!

Некоторая дополнительная информация о вышеупомянутом примере:

• nvcc означает «NVIDIA CUDA Compiler». Он отделяет исходный код от компонентов хоста и устройства.
• __global__ - это ключевое слово CUDA, используемое в объявлениях функций, указывающее, что функция выполняется на устройстве GPU и вызывается из хоста.
• Тройные угловые скобки ( <<< , >>> ) отмечают вызов из кода хоста на код устройства (также называемый «запуск ядра»). Числа в этих тройных скобках указывают количество раз для выполнения параллельно и количество потоков.

Компиляция и запуск пробных программ

Руководство по установке NVIDIA заканчивается запуском выборочных программ, чтобы проверить установку CUDA Toolkit, но не указывается явно. Сначала проверьте все предварительные условия. Проверьте каталог CUDA по умолчанию для выборочных программ. Если его нет, его можно загрузить с официального сайта CUDA. Перейдите в каталог, в котором присутствуют примеры.

$ cd /path/to/samples/
$ ls

Вы должны увидеть результат, похожий на:

0_Simple     2_Graphics  4_Finance      6_Advanced       bin     EULA.txt
1_Utilities  3_Imaging   5_Simulations  7_CUDALibraries  common  Makefile

Убедитесь, что Makefile присутствует в этом каталоге. Команда make в UNIX-системах будет создавать все примеры программ. Кроме того, перейдите в подкаталог, в котором присутствует другой Makefile и запустите команду make оттуда, чтобы создать только этот образец.

Запустите две предложенные примеры программ - deviceQuery и bandwidthTest :

$ cd 1_Utilities/deviceQuery/
$ ./deviceQuery 

Выход будет аналогичен показанному ниже:

./deviceQuery Starting...

 CUDA Device Query (Runtime API) version (CUDART static linking)

Detected 1 CUDA Capable device(s)

Device 0: "GeForce GTX 950M"
  CUDA Driver Version / Runtime Version          7.5 / 7.5
  CUDA Capability Major/Minor version number:    5.0
  Total amount of global memory:                 4096 MBytes (4294836224 bytes)
  ( 5) Multiprocessors, (128) CUDA Cores/MP:     640 CUDA Cores
  GPU Max Clock rate:                            1124 MHz (1.12 GHz)
  Memory Clock rate:                             900 Mhz
  Memory Bus Width:                              128-bit
  L2 Cache Size:                                 2097152 bytes
  Maximum Texture Dimension Size (x,y,z)         1D=(65536), 2D=(65536, 65536), 3D=(4096, 4096, 4096)
  Maximum Layered 1D Texture Size, (num) layers  1D=(16384), 2048 layers
  Maximum Layered 2D Texture Size, (num) layers  2D=(16384, 16384), 2048 layers
  Total amount of constant memory:               65536 bytes
  Total amount of shared memory per block:       49152 bytes
  Total number of registers available per block: 65536
  Warp size:                                     32
  Maximum number of threads per multiprocessor:  2048
  Maximum number of threads per block:           1024
  Max dimension size of a thread block (x,y,z): (1024, 1024, 64)
  Max dimension size of a grid size    (x,y,z): (2147483647, 65535, 65535)
  Maximum memory pitch:                          2147483647 bytes
  Texture alignment:                             512 bytes
  Concurrent copy and kernel execution:          Yes with 1 copy engine(s)
  Run time limit on kernels:                     Yes
  Integrated GPU sharing Host Memory:            No
  Support host page-locked memory mapping:       Yes
  Alignment requirement for Surfaces:            Yes
  Device has ECC support:                        Disabled
  Device supports Unified Addressing (UVA):      Yes
  Device PCI Domain ID / Bus ID / location ID:   0 / 1 / 0
  Compute Mode:
     < Default (multiple host threads can use ::cudaSetDevice() with device simultaneously) >

deviceQuery, CUDA Driver = CUDART, CUDA Driver Version = 7.5, CUDA Runtime Version = 7.5, NumDevs = 1, Device0 = GeForce GTX 950M
Result = PASS

Заявление Result = PASS в конце указывает, что все работает правильно. Теперь запустите другую предложенную тестовую программу bandwidthTest аналогичным образом. Выход будет похож на:

[CUDA Bandwidth Test] - Starting...
Running on...

 Device 0: GeForce GTX 950M
 Quick Mode

 Host to Device Bandwidth, 1 Device(s)
 PINNED Memory Transfers
   Transfer Size (Bytes)    Bandwidth(MB/s)
   33554432            10604.5

 Device to Host Bandwidth, 1 Device(s)
 PINNED Memory Transfers
   Transfer Size (Bytes)    Bandwidth(MB/s)
   33554432            10202.0

 Device to Device Bandwidth, 1 Device(s)
 PINNED Memory Transfers
   Transfer Size (Bytes)    Bandwidth(MB/s)
   33554432            23389.7

Result = PASS

NOTE: The CUDA Samples are not meant for performance measurements. Results may vary when GPU Boost is enabled.

Опять же, оператор Result = PASS указывает, что все выполнено правильно. Все остальные примеры программ можно запускать аналогичным образом.