WebFront C++23
EN ↗GitHub ↗

Tome I / CHAPITRE 09

Pour les développeurs d’applications

CUDA sur Jetson Orin Nano

Construire le Boing Ball sur Jetson, comparer le CPU à CUDA et afficher le résultat avec WebKitGTK.

Conventions de notation

Les noms de fonctions, types, commandes, options et fichiers sont composés en chasse fixe, par exemple describe, wf test ou main.cpp. L’italique introduit un terme lors de sa définition. Les blocs de code donnent les extraits à saisir ; le texte qui les précède précise leur emplacement et leurs prérequis.

Animation du Boing Ball sur Jetson Orin Nano Super
Le Boing Ball rebondit au-dessus du damier. La démo passe d’une boule opaque à une boule en verre qui projette des faisceaux colorés. Le témoin CUDA reste allumé.

Calculer dans la boucle C++

Le programme hôte calcule les images du Boing Ball. Avec CUDA, chaque thread GPU calcule un pixel. Le noyau est isolé dans une unité .cu compilée en C++17 par nvcc ; l’application et WebFront restent en C++23. L’hôte récupère les pixels et transmet un tableau typé via le pont binaire. Le JavaScript de l’interface les dessine dans un canvas 2D.

Préparer le Jetson

Le profil mesuré est un Jetson Orin Nano Super 8 Go, avec JetPack 7.2.1 (L4T R39.2.1, Ubuntu 24.04), GCC 13.3, CUDA 13.2 et WebKitGTK 2.52.6 sous X11. Vérifiez que la machine annonce aarch64, que le toolkit CUDA fournit nvcc et que CMake est en version 3.31 ou ultérieure. Installez libwebkitgtk-6.0-dev et pkg-config pour la fenêtre native. Le guide Jetson détaille l’installation de CMake sur Ubuntu.

TERMINAL SYSTÈME
uname -m
cat /etc/nv_tegra_release
g++ --version
cmake --version
nvcc --version

Compiler le moteur CUDA

WEBFRONT_HOST_LOOP_CUDA=ON exige un compilateur CUDA. L’architecture 87 cible le GPU Ampere d’Orin. Si nvcc refuse le compilateur hôte par défaut, configurez un nouveau répertoire de build avec CMAKE_CUDA_HOST_COMPILER pointant vers un compilateur accepté par le toolkit installé.

Le réglage AUTO compile le moteur CUDA lorsqu’un compilateur utilisable est détecté. OFF construit l’exemple avec le moteur CPU seul. WebFront fonctionne sans toolkit CUDA.

TERMINAL SYSTÈME
git clone --branch v1.0.0 --depth 1 https://github.com/ambroise-leclerc/WebFront.git
cd WebFront
cmake -S . -B build-jetson -DCMAKE_BUILD_TYPE=Release \
  -DWEBFRONT_EMBED_CEF=OFF -DWEBFRONT_EMBED_WEBKITGTK=ON \
  -DWEBFRONT_HOST_LOOP_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES=87
cmake --build build-jetson --target WebFrontHostLoop --parallel 2

Vérifier le GPU et ouvrir la fenêtre

--benchmark indique le périphérique CUDA détecté et mesure le calcul sans ouvrir d’interface. --engine cuda renvoie une erreur si le moteur ou le périphérique est indisponible. À l’écran, le bouton CUDA permet de comparer les moteurs. Lancez avec --browser pour afficher la même interface dans le navigateur système, ou avec --engine cpu pour effectuer le calcul sur le CPU.

Les commandes ci-dessous utilisent le mode de développement WebKitGTK, qui désactive son bac à sable. Pour distribuer une application avec une fenêtre WebKitGTK, activez WEBFRONT_DISTRIBUTION=ON ou appliquez webfront_use_distribution(target) et suivez le guide de distribution.

TERMINAL SYSTÈME
./build-jetson/examples/WebFrontHostLoop --benchmark
./build-jetson/examples/WebFrontHostLoop --engine cuda --glass --quality 1 --stats

Interpréter les mesures

Sur la carte de référence à 25 W, le calcul de l’image en verre à 640 × 480 et un rayon par pixel a pris 175 ms sur les six cœurs CPU et 4,8 ms sur CUDA, auxquels s’ajoutent 0,3 ms de copie. Pour estimer le débit visible, mesurez aussi le transfert vers le navigateur et le dessin dans le canvas. --stats affiche ces étapes pendant l’exécution.

La qualification de la fenêtre native concerne X11. Le dossier de validation distingue les essais Wayland sous Weston imbriqué et les essais JetPack 6 sur une pile plus ancienne.

Vérifier sa compréhension

Où s’exécute le noyau CUDA ?