Link to this sectionExportation RKNN Rockchip pour les modèles Ultralytics YOLO26#
Lors du déploiement de modèles de vision par ordinateur sur des appareils embarqués, en particulier ceux équipés de processeurs Rockchip, il est essentiel de disposer d'un format de modèle compatible. Exporter les modèles Ultralytics YOLO26 au format RKNN garantit des performances optimisées et une compatibilité avec le matériel de Rockchip. Ce guide te guidera dans la conversion de tes modèles YOLO26 au format RKNN, incluant les exportations en virgule flottante et quantifiées INT8, permettant un déploiement efficace sur les plateformes Rockchip.
Ce guide a été testé avec la Radxa Rock 5B, qui est basée sur le Rockchip RK3588, et la Radxa Zero 3W, basée sur le Rockchip RK3566. Il devrait fonctionner sur d'autres appareils équipés de Rockchip qui prennent en charge le rknn-toolkit2, tels que les RK3576, RK3568, RK3562, RK2118, RV1126B, RV1103, RV1106, RV1103B et RV1106B. Les cibles INT8 uniquement, comme les RV1103 et RV1106, nécessitent quantize=8.
Link to this sectionQu'est-ce que Rockchip ?#
Reconnu pour fournir des solutions polyvalentes et économes en énergie, Rockchip conçoit des systèmes sur puce (SoC) avancés qui alimentent une large gamme d'appareils électroniques grand public, d'applications industrielles et de technologies d'IA. Avec une architecture basée sur ARM, des unités de traitement neuronal (NPU) intégrées et une prise en charge multimédia haute résolution, les SoC Rockchip permettent des performances de pointe pour des appareils tels que les tablettes, les smart TV, les systèmes IoT et les applications d'IA en périphérie. Des entreprises comme Radxa, ASUS, Pine64, Orange Pi, Odroid, Khadas et Banana Pi proposent une variété de produits basés sur les SoC Rockchip, étendant ainsi leur portée et leur impact sur divers marchés.
Link to this sectionRKNN Toolkit#
Le RKNN Toolkit est un ensemble d'outils et de bibliothèques fournis par Rockchip pour faciliter le déploiement de modèles d'apprentissage profond sur leurs plateformes matérielles. RKNN, ou Rockchip Neural Network, est le format propriétaire utilisé par ces outils. Les modèles RKNN sont conçus pour tirer pleinement parti de l'accélération matérielle fournie par le NPU (Neural Processing Unit) de Rockchip, garantissant des performances élevées dans les tâches d'IA sur des appareils comme les RK3588, RK3566, RV1103, RV1106 et d'autres systèmes alimentés par Rockchip.
Link to this sectionFonctionnalités clés des modèles RKNN#
Les modèles RKNN offrent plusieurs avantages pour le déploiement sur les plateformes Rockchip :
- Optimisé pour NPU : Les modèles RKNN sont spécifiquement optimisés pour fonctionner sur les NPU de Rockchip, garantissant une performance et une efficacité maximales.
- Faible latence : Le format RKNN minimise la latence d'inférence, ce qui est crucial pour les applications en temps réel sur les appareils en périphérie.
- Personnalisation spécifique à la plateforme : Les modèles RKNN peuvent être adaptés à des plateformes Rockchip spécifiques, permettant une meilleure utilisation des ressources matérielles.
- Efficacité énergétique : En tirant parti du matériel NPU dédié, les modèles RKNN consomment moins d'énergie que le traitement basé sur CPU ou GPU, prolongeant ainsi la durée de vie de la batterie pour les appareils portables.
Link to this sectionFlasher l'OS sur le matériel Rockchip#
La première étape après avoir récupéré ton appareil basé sur Rockchip est de flasher un système d'exploitation afin que le matériel puisse démarrer dans un environnement fonctionnel. Dans ce guide, nous indiquerons les guides de démarrage des deux appareils que nous avons testés, à savoir la Radxa Rock 5B et la Radxa Zero 3W.
Link to this sectionExporter vers RKNN : Conversion de ton modèle YOLO26#
Exporte un modèle Ultralytics YOLO26 au format RKNN et exécute l'inférence avec le modèle exporté.
Assure-toi d'utiliser un PC Linux basé sur X86 pour exporter le modèle vers RKNN car l'exportation sur des appareils basés sur Rockchip (ARM64) n'est pas prise en charge.
Link to this sectionInstallation#
Pour installer les paquets requis, exécute :
# Install the required package for YOLO26
pip install ultralyticsPour des instructions détaillées et les meilleures pratiques liées au processus d'installation, consulte notre guide d'installation Ultralytics. Lors de l'installation des packages requis pour YOLO26, si tu rencontres des difficultés, consulte notre guide des problèmes courants pour des solutions et des conseils.
Link to this sectionUtilisation#
L'exportation est actuellement prise en charge uniquement pour les modèles de détection. Davantage de modèles seront pris en charge à l'avenir.
Le format RKNN prend en charge les modes Export, Predict et Validate. L'inférence et la validation s'exécutent sur le matériel NPU Rockchip. Exporte ton modèle, puis charge-le pour exécuter l'inférence ou valider sa précision. Par défaut, l'exportation RKNN utilise le chemin de construction à virgule flottante (quantize=16) pour les cibles Rockchip compatibles FP16. Utilise quantize=8 pour construire un modèle RKNN quantifié en INT8 avec des données de calibration. L'exportation RKNN n'expose pas de mode FP32 séparé ; le mode FP16 par défaut ne demande pas de FP32.
from ultralytics import YOLO
# Load a YOLO26 model
model = YOLO("yolo26n.pt")
# Export the model to RKNN format
model.export(format="rknn", name="rk3588") # creates '/yolo26n_rknn_model'
# Export an INT8-quantized RKNN model with calibration data
model.export(format="rknn", name="rk3588", quantize=8, data="coco8.yaml")from ultralytics import YOLO
# Load the exported RKNN model
model = YOLO("./yolo26n_rknn_model")
# Run inference
results = model("https://ultralytics.com/images/bus.jpg")from ultralytics import YOLO
# Load the exported RKNN model
model = YOLO("./yolo26n_rknn_model")
# Validate accuracy on the COCO8 dataset
metrics = model.val(data="coco8.yaml")Link to this sectionArguments d'exportation#
| Argument | Type | Défaut | Description |
|---|---|---|---|
format | str | 'rknn' | Format cible pour le modèle exporté, définissant la compatibilité avec les environnements de déploiement Rockchip. |
imgsz | int ou tuple | 640 | Taille d'image souhaitée pour l'entrée du modèle. Peut être un entier pour des images carrées ou un tuple (height, width) pour des dimensions spécifiques. |
batch | int | 1 | Spécifie la taille de l'inférence par lot du modèle exporté ou le nombre maximal d'images que le modèle exporté traitera simultanément en mode predict. |
name | str | 'rk3588' | Spécifie la cible Rockchip. rk3588, rk3576, rk3566, rk3568, rk3562, rk2118 et rv1126b prennent en charge FP16 (quantize=16 ou non défini) et INT8 (quantize=8) ; rv1103, rv1106, rv1103b et rv1106b sont limités à INT8 (quantize=8 ou non défini). |
quantize | int ou str | None | Précision de quantification : non défini ou 16 crée du FP16 pour les cibles compatibles FP16 ; non défini active automatiquement INT8 pour les cibles limitées à INT8 ; 8 crée du INT8. L'exportation RKNN ne dispose pas de mode FP32 séparé. Remplace les anciens indicateurs half/int8 désormais obsolètes. |
data | str | None | YAML de dataset utilisé pour la calibration INT8. Si omis avec quantize=8, Ultralytics sélectionne le dataset de calibration par défaut pour la tâche du modèle. |
fraction | float | 1.0 | Fraction des images de calibration à utiliser pour la quantification INT8. |
device | str | None | Spécifie l'appareil pour l'exportation : GPU (device=0), CPU (device=cpu). |
Assure-toi d'utiliser une machine Linux x86 lors de l'exportation vers RKNN.
Pour plus de détails sur le processus d'exportation, visite la page de documentation Ultralytics sur l'exportation.
Link to this sectionDéploiement des modèles YOLO26 RKNN exportés#
Une fois que tu as exporté avec succès tes modèles Ultralytics YOLO26 au format RKNN, l'étape suivante consiste à déployer ces modèles sur les appareils basés sur Rockchip.
Link to this sectionInstallation#
Pour installer les paquets requis, exécute :
# Install the required package for YOLO26
pip install ultralyticsUne fois installé, exécute l'inférence et la validation sur ton appareil Rockchip exactement comme indiqué dans la section Usage ci-dessus — le _rknn_model exporté se charge directement avec YOLO(...).
Si tu rencontres un message de journal indiquant que la version du runtime RKNN ne correspond pas à la version du RKNN Toolkit et que l'inférence échoue, remplace /usr/lib/librknnrt.so par le fichier officiel librknnrt.so.

Link to this sectionApplications concrètes#
Les appareils alimentés par Rockchip avec des modèles YOLO26 RKNN peuvent être utilisés dans diverses applications :
- Surveillance intelligente : Déploie des systèmes de détection d'objets efficaces pour la surveillance de sécurité avec une faible consommation d'énergie.
- Automatisation industrielle : Implémente le contrôle qualité et la détection des défauts directement sur des appareils embarqués.
- Analytique de détail : Suis le comportement des clients et la gestion des stocks en temps réel sans dépendance au cloud.
- Agriculture intelligente : Surveille la santé des cultures et détecte les parasites en utilisant la vision par ordinateur en agriculture.
- Robotique autonome : Active la navigation basée sur la vision et la détection d'obstacles sur des plateformes aux ressources limitées.
Link to this sectionBenchmarks#
Les benchmarks YOLO26 ci-dessous ont été réalisés par l'équipe Ultralytics sur une Radxa Rock 5B basée sur le Rockchip RK3588 avec le format de modèle rknn en mesurant la vitesse et la précision.
| Modèle | Format | Statut | Taille (Mo) | mAP50-95(B) | Temps d'inférence (ms/im) |
|---|---|---|---|---|---|
| YOLO26n | rknn | ✅ | 7.1 | 0.479 | 65.7 |
| YOLO26s | rknn | ✅ | 20.9 | 0.571 | 99.2 |
| YOLO26m | rknn | ✅ | 42,5 | 0.610 | 235.3 |
| YOLO26l | rknn | ✅ | 52.1 | 0.630 | 280.5 |
| YOLO26x | rknn | ✅ | 112.2 | 0.666 | 669.1 |
Benchmarks réalisés avec ultralytics 8.4.23
La validation pour les benchmarks ci-dessus a été effectuée à l'aide du jeu de données COCO128. Le temps d'inférence n'inclut pas le pré/post-traitement.
Link to this sectionRésumé#
Dans ce guide, tu as appris comment exporter des modèles Ultralytics YOLO26 au format RKNN pour améliorer leur déploiement sur les plateformes Rockchip. Tu as également été initié au RKNN Toolkit et aux avantages spécifiques de l'utilisation des modèles RKNN pour les applications d'IA en périphérie.
La combinaison de Ultralytics YOLO26 et de la technologie NPU de Rockchip fournit une solution efficace pour exécuter des tâches avancées de vision par ordinateur sur des appareils embarqués. Cette approche permet une détection d'objets en temps réel et d'autres applications d'IA visuelle avec une consommation d'énergie minimale et des performances élevées.
Pour plus de détails sur l'utilisation, visite la documentation officielle RKNN.
De plus, si tu souhaites en savoir plus sur d'autres intégrations Ultralytics YOLO26, visite notre page de guide d'intégration. Tu y trouveras de nombreuses ressources et idées utiles.
Link to this sectionFAQ#
Link to this sectionComment exporter mon modèle Ultralytics YOLO au format RKNN ?#
Tu peux facilement exporter ton modèle Ultralytics YOLO au format RKNN en utilisant la méthode export() dans le package Python Ultralytics ou via l'interface de ligne de commande (CLI). Assure-toi d'utiliser un PC Linux basé sur x86 pour le processus d'exportation, car les appareils ARM64 comme Rockchip ne sont pas pris en charge pour cette opération. Tu peux spécifier la plateforme Rockchip cible en utilisant l'argument name, tel que rk3588, rk3566, ou d'autres. Ce processus génère un modèle RKNN optimisé prêt pour le déploiement sur ton appareil Rockchip, tirant parti de son unité de traitement neuronal (NPU) pour une inférence accélérée.
from ultralytics import YOLO
# Load your YOLO model
model = YOLO("yolo26n.pt")
# Export to RKNN format for a specific Rockchip platform
model.export(format="rknn", name="rk3588")Link to this sectionQuels sont les avantages de l'utilisation des modèles RKNN sur les appareils Rockchip ?#
Les modèles RKNN sont spécifiquement conçus pour tirer parti des capacités d'accélération matérielle des unités de traitement neuronal (NPU) de Rockchip. Cette optimisation se traduit par des vitesses d'inférence nettement plus rapides et une latence réduite par rapport à l'exécution de formats de modèles génériques comme ONNX ou TensorFlow Lite sur le même matériel. L'utilisation de modèles RKNN permet une utilisation plus efficace des ressources de l'appareil, conduisant à une consommation d'énergie plus faible et à de meilleures performances globales, particulièrement cruciales pour les applications en temps réel sur les appareils en périphérie. En convertissant tes modèles Ultralytics YOLO en RKNN, tu peux obtenir des performances optimales sur des appareils alimentés par des SoC Rockchip comme les RK3588, RK3566, et autres.
Link to this sectionPuis-je déployer des modèles RKNN sur des appareils d'autres fabricants comme NVIDIA ou Google ?#
Les modèles RKNN sont spécifiquement optimisés pour les plateformes Rockchip et leurs NPU intégrés. Bien que tu puisses techniquement exécuter un modèle RKNN sur d'autres plateformes en utilisant l'émulation logicielle, tu ne bénéficieras pas de l'accélération matérielle fournie par les appareils Rockchip. Pour des performances optimales sur d'autres plateformes, il est recommandé d'exporter tes modèles Ultralytics YOLO vers des formats spécifiquement conçus pour ces plateformes, comme TensorRT pour les GPU NVIDIA ou TensorFlow Lite pour l'Edge TPU de Google. Ultralytics prend en charge l'exportation vers une large gamme de formats, garantissant la compatibilité avec divers accélérateurs matériels.
Link to this sectionQuelles plateformes Rockchip sont prises en charge pour le déploiement de modèles RKNN ?#
L'exportation Ultralytics YOLO au format RKNN prend en charge les plateformes Rockchip avec des constructions RKNN à virgule flottante, y compris les RK3588, RK3576, RK3566, RK3568, RK3562, RK2118 et RV1126B. Elle prend également en charge l'exportation RKNN quantifiée en INT8 avec quantize=8, ce qui est requis pour les cibles INT8 uniquement comme les RV1103, RV1106, RV1103B et RV1106B. Ces plateformes se trouvent couramment dans les appareils de fabricants tels que Radxa, ASUS, Pine64, Orange Pi, Odroid, Khadas et Banana Pi, te permettant de déployer tes modèles RKNN optimisés sur une gamme d'appareils alimentés par Rockchip, des ordinateurs monocartes aux systèmes industriels.
Link to this sectionComment la performance des modèles RKNN se compare-t-elle aux autres formats sur les appareils Rockchip ?#
Les modèles RKNN surpassent généralement les autres formats comme ONNX ou TensorFlow Lite sur les appareils Rockchip en raison de leur optimisation pour les NPU de Rockchip. Par exemple, les benchmarks sur la Radxa Rock 5B (RK3588) montrent que YOLO26n au format RKNN atteint un temps d'inférence de 65,7 ms/image, nettement plus rapide que les autres formats. Cet avantage de performance est cohérent sur toutes les tailles de modèles YOLO26, comme démontré dans la section des benchmarks. En tirant parti du matériel NPU dédié, les modèles RKNN minimisent la latence et maximisent le débit, les rendant idéaux pour les applications en temps réel sur les appareils en périphérie basés sur Rockchip.