Build and Run an Executable on NVIDIA Hardware Using GPU Coder App
Using GPU Coder™ and the MATLAB® Coder™ Support Package for NVIDIA® Jetson™ and NVIDIA DRIVE® Platforms, you can target NVIDIA DRIVE and Jetson hardware platforms. After connecting to the target platform, you can perform basic operations, generate CUDA® executable from a MATLAB function, and run the executable on the hardware. The support package automates the deployment of the generated CUDA code on GPU hardware platforms such as Jetson or DRIVE
Starting in R2021a, the GPU Coder Support Package for NVIDIA GPUs is named MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms. To use this support package in R2021a, you must have the MATLAB Coder product.
In this tutorial, you learn how to:
Prepare your MATLAB code for CUDA code generation by using the
Create and set up a GPU Coder project.
Change settings to connect to the NVIDIA target board.
Generate and deploy a CUDA executable on the target board.
Run the executable on the board and verify the results.
Before following getting started with this tutorial, it is recommended to familiarize yourself with the GPU Coder App. For more information, see Code Generation by Using the GPU Coder App.
Target Board Requirements
NVIDIA DRIVE PX2 or Jetson embedded platform.
Ethernet crossover cable to connect the target board and host PC (if the target board cannot be connected to a local network).
NVIDIA CUDA Toolkit installed on the board.
Environment variables on the target for the compilers and libraries. For information on the supported versions of the compilers, libraries, and their setup, see Install and Setup Prerequisites for NVIDIA Boards (MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms).
Development Host Requirements
NVIDIA CUDA Toolkit on the host.
Environment variables on the host for the compilers and libraries. For information on the supported versions of the compilers and libraries, see Third-Party Hardware. For setting up the environment variables, see Environment Variables.
Example: Vector Addition
This tutorial uses a simple vector addition example to demonstrate the build and
deployment workflow on NVIDIA GPUs. Create a MATLAB function
myAdd.m that acts as the
entry-point for code generation. Alternatively, use the files
in the Getting Started with the MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms example for this
tutorial. The easiest way to create CUDA code for this function is to place the
coder.gpu.kernelfun pragma in the function. When the GPU Coder encounters
kernelfun pragma, it attempts to parallelize
the computations within this function and maps them to the GPU.
function out = myAdd(inp1,inp2) %#codegen coder.gpu.kernelfun(); out = inp1 + inp2; end
Custom Main File
To generate a CUDA executable that can be deployed to a NVIDIA target, create a custom main file (
main.cu) and header
main.h). The main file calls the code generated for the
MATLAB entry-point function. The main file passes a vector containing the first
100 natural numbers to the entry-point function and writes the results to a binary file
GPU Coder App
To open the GPU Coder app, on the MATLAB toolstrip Apps tab, under Code
Generation, click the GPU Coder app icon. You can also open the app by typing
in the MATLAB Command Window.
The app opens the Select source files page. Select
myAdd.mas the entry-point function. Click Next.
In the Define Input Types window, enter
myAdd(1:100,1:100)and click Autodefine Input Types, then click Next.
You can initiate the Check for Run-Time Issues process or click Next to go to the Generate Code step.
Set the Build type to
Executableand the Hardware Board to
Click More Settings, on the Custom Code panel, enter the custom main file
main.cuin the field for Additional source files. The custom main file and the header file must be in the same location as the entry-point file.
Under the Hardware panel, enter the device address, user name, password, and build folder for the board.
Close the Settings window and click Generate. The software generates CUDA code and deploys the executable to the folder specified. Click Next and close the app.
Run the Executable and Verify the Results
In the MATLAB command window, use the
runApplication() method of the
hardware object to start the executable on the target hardware.
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...
Copy the output bin file
myAdd.bin to the MATLAB environment on the host and compare the computed results with the results
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
jetson(MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms) |
drive(MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms)
- Build and Run an Executable on NVIDIA Hardware
- Code Generation Using the Command Line Interface
- Code Generation by Using the GPU Coder App
- Code Generation for Deep Learning Networks by Using cuDNN
- Code Generation for Deep Learning Networks by Using TensorRT
- Stop or Restart an Executable Running on NVIDIA Hardware (MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms)
- Run Linux Commands on NVIDIA Hardware (MATLAB Coder Support Package for NVIDIA Jetson and NVIDIA DRIVE Platforms)