Документация

Цели обучения

В этом учебном пособии вы узнаете, как:

Перед началом работы с этим учебным пособием рекомендуется ознакомиться с приложением кодера графического процессора. Дополнительные сведения см. в разделе Создание кода с помощью приложения кодера графического процессора.

Предварительные условия учебного пособия

Пример: Добавление вектора

В этом учебном пособии используется простой пример добавления вектора для демонстрации процесса построения и развертывания на графических процессорах NVIDIA. Создание функции MATLAB myAdd.m которая выступает в качестве начальной точки для генерации кода. В качестве альтернативы можно использовать файлы примера «Начало работы с пакетом поддержки кодеров MATLAB для платформ NVIDIA Jetson и NVIDIA DRIVE». Самый простой способ создания кода CUDA для этой функции - размещение coder.gpu.kernelfun pragma в функции. При обнаружении кодера графического процессора kernelfun pragma, он пытается распараллелить вычисления внутри этой функции и отображает их в GPU.

function out = myAdd(inp1,inp2) %#codegen
coder.gpu.kernelfun();
out = inp1 + inp2;
end

Пользовательский основной файл

Чтобы создать исполняемый файл CUDA, который можно развернуть на целевом объекте NVIDIA, создайте пользовательский основной файл (main.cu) и файл заголовка (main.h). Основной файл вызывает код, созданный для функции точки входа MATLAB. Основной файл передает вектор, содержащий первые 100 натуральных чисел, в функцию точки входа и записывает результаты в двоичный файл (myAdd.bin).

 main.cu

//main.cu
// Include Files
#include "myAdd.h"
#include "main.h"
#include "myAdd_terminate.h"
#include "myAdd_initialize.h"
#include <stdio.h>

// Function Declarations
static void argInit_1x100_real_T(real_T result[100]);
static void main_myAdd();

// Function Definitions
static void argInit_1x100_real_T(real_T result[100])
{
  int32_T idx1;

  // Initialize each element.
  for (idx1 = 0; idx1 < 100; idx1++) {
    result[idx1] = (real_T) idx1;
  }
}

void writeToFile(real_T result[100])
{
    FILE *fid = NULL;
    fid = fopen("myAdd.bin", "wb");
    fwrite(result, sizeof(real_T), 100, fid);
    fclose(fid);
}

static void main_myAdd()
{
  real_T out[100];
  real_T b[100];
  real_T c[100];

  argInit_1x100_real_T(b);
  argInit_1x100_real_T(c);
  
  myAdd(b, c, out);
  writeToFile(out);  // Write the output to a binary file
}

// Main routine
int32_T main(int32_T, const char * const [])
{
  // Initialize the application.
  myAdd_initialize();

  // Invoke the entry-point functions.
  main_myAdd();

  // Terminate the application.
  myAdd_terminate();
  return 0;
}

 main.h

//main.h
#ifndef MAIN_H
#define MAIN_H

// Include Files
#include <stddef.h>
#include <stdlib.h>
#include "rtwtypes.h"
#include "myAdd_types.h"

// Function Declarations
extern int32_T main(int32_T argc, const char * const argv[]);

#endif

Приложение кодера графического процессора

Чтобы открыть приложение GPU Coder, на вкладке MATLAB toolstrip Apps в разделе Code Generation щелкните значок приложения GPU Coder. Вы также можете открыть приложение, введя gpucoder в окне команд MATLAB.

Запуск исполняемого файла и проверка результатов

В окне команд MATLAB используйте runApplication() способ аппаратного объекта для запуска исполняемого файла на целевом оборудовании.

hwobj = jetson;
pid = runApplication(hwobj,'myAdd');

### Launching the executable on the target...
Executable launched successfully with process ID 26432.
Displaying the simple runtime log for the executable...

Копирование файла выходной ячейки myAdd.bin в среду MATLAB на хосте и сравнить вычисленные результаты с результатами из MATLAB.

outputFile = [hwobj.workspaceDir '/myAdd.bin']
getFile(hwobj,outputFile);

% Simulation result from the MATLAB.
simOut = myAdd(0:99,0:99);

% Read the copied result binary file from target in MATLAB.
fId  = fopen('myAdd.bin','r');
tOut = fread(fId,'double');
diff = simOut - tOut';
fprintf('Maximum deviation is: %f\n', max(diff(:)));

Maximum deviation between MATLAB Simulation output and GPU coder output on Target is: 0.000000