Link to this sectionExportação RKNN da Rockchip para modelos Ultralytics YOLO26#
Ao implantar modelos de visão computacional em dispositivos embarcados, especialmente naqueles equipados com processadores Rockchip, ter um formato de modelo compatível é essencial. Exportar modelos Ultralytics YOLO26 para o formato RKNN garante desempenho otimizado e compatibilidade com o hardware da Rockchip. Este guia vai te mostrar como converter seus modelos YOLO26 para o formato RKNN, incluindo exportações de ponto flutuante e quantizadas INT8, permitindo uma implantação eficiente em plataformas Rockchip.
Este guia foi testado com Radxa Rock 5B, que é baseado no Rockchip RK3588, e Radxa Zero 3W, que é baseado no Rockchip RK3566. Espera-se que funcione em outros dispositivos baseados em Rockchip que suportem rknn-toolkit2, como RK3576, RK3568, RK3562, RK2118, RV1126B, RV1103, RV1106, RV1103B e RV1106B. Alvos que aceitam apenas INT8, como o RV1103 e RV1106, requerem int8=True.
Link to this sectionO que é a Rockchip?#
Reconhecida por oferecer soluções versáteis e eficientes em termos de energia, a Rockchip projeta System-on-Chips (SoCs) avançados que alimentam uma ampla gama de eletrônicos de consumo, aplicações industriais e tecnologias de IA. Com arquitetura baseada em ARM, Unidades de Processamento Neural (NPUs) integradas e suporte a multimídia de alta resolução, os SoCs da Rockchip permitem um desempenho de ponta para dispositivos como tablets, smart TVs, sistemas IoT e aplicações de edge AI. Empresas como Radxa, ASUS, Pine64, Orange Pi, Odroid, Khadas e Banana Pi oferecem uma variedade de produtos baseados em SoCs Rockchip, ampliando ainda mais seu alcance e impacto em diversos mercados.
Link to this sectionRKNN Toolkit#
O RKNN Toolkit é um conjunto de ferramentas e bibliotecas fornecido pela Rockchip para facilitar a implantação de modelos de deep learning em suas plataformas de hardware. RKNN, ou Rockchip Neural Network, é o formato proprietário usado por essas ferramentas. Os modelos RKNN são projetados para tirar total proveito da aceleração de hardware fornecida pela NPU (Unidade de Processamento Neural) da Rockchip, garantindo alto desempenho em tarefas de IA em dispositivos como RK3588, RK3566, RV1103, RV1106 e outros sistemas equipados com Rockchip.
Link to this sectionPrincipais recursos dos modelos RKNN#
Os modelos RKNN oferecem várias vantagens para a implantação em plataformas Rockchip:
- Otimizado para NPU: Os modelos RKNN são especificamente otimizados para rodar nas NPUs da Rockchip, garantindo desempenho e eficiência máximos.
- Baixa latência: O formato RKNN minimiza a latência de inferência, o que é crítico para aplicações em tempo real em dispositivos de borda (edge devices).
- Personalização específica para a plataforma: Os modelos RKNN podem ser adaptados a plataformas Rockchip específicas, permitindo um melhor aproveitamento dos recursos de hardware.
- Eficiência energética: Ao aproveitar o hardware NPU dedicado, os modelos RKNN consomem menos energia do que o processamento baseado em CPU ou GPU, estendendo a vida útil da bateria para dispositivos portáteis.
Link to this sectionInstalar o SO no hardware Rockchip#
O primeiro passo após adquirir um dispositivo baseado em Rockchip é instalar um SO para que o hardware possa inicializar em um ambiente de trabalho. Neste guia, indicaremos os guias de início rápido dos dois dispositivos que testamos, que são o Radxa Rock 5B e o Radxa Zero 3W.
Link to this sectionExportar para RKNN: Convertendo seu modelo YOLO26#
Exporte um modelo Ultralytics YOLO26 para o formato RKNN e execute a inferência com o modelo exportado.
Certifique-se de usar um PC Linux baseado em X86 para exportar o modelo para RKNN, pois a exportação em dispositivos baseados em Rockchip (ARM64) não é suportada.
Link to this sectionInstalação#
Para instalar os pacotes necessários, execute:
# Install the required package for YOLO26
pip install ultralyticsPara obter instruções detalhadas e melhores práticas relacionadas ao processo de instalação, consulte nosso Guia de Instalação do Ultralytics. Se encontrar dificuldades ao instalar os pacotes necessários para o YOLO26, consulte nosso Guia de Problemas Comuns para soluções e dicas.
Link to this sectionUso#
A exportação atualmente só é suportada para modelos de detecção. Mais suporte a modelos virá no futuro.
O formato RKNN suporta os modos Export, Predict e Validate. A inferência e a validação são executadas no hardware NPU da Rockchip. Exporte seu modelo e, em seguida, carregue o modelo exportado para executar a inferência ou validar sua precisão. Por padrão, a exportação RKNN usa o caminho de compilação de ponto flutuante existente com half=True para alvos Rockchip capazes de FP16. Use int8=True para criar um modelo RKNN quantizado em INT8 com dados de calibração. A exportação RKNN não expõe um modo FP32 separado; deixar int8=False não solicita 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", int8=True, 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 sectionArgumentos de exportação#
| Argumento | Tipo | Padrão | Descrição |
|---|---|---|---|
format | str | 'rknn' | Formato de destino para o modelo exportado, definindo a compatibilidade com ambientes de implantação da Rockchip. |
imgsz | int ou tuple | 640 | Tamanho de imagem desejado para a entrada do modelo. Pode ser um número inteiro para imagens quadradas ou uma tupla (height, width) para dimensões específicas. |
batch | int | 1 | Especifica o tamanho do lote de inferência do modelo de exportação ou o número máximo de imagens que o modelo exportado processará simultaneamente no modo predict. |
name | str | 'rk3588' | Especifica o alvo da Rockchip, como rk3588, rk3576, rk3566, rk3568, rk3562, rk2118, rv1126b, rv1103, rv1106, rv1103b ou rv1106b. |
half | bool | True | Habilita o caminho de exportação RKNN de ponto flutuante padrão para alvos capazes de FP16. Mutuamente exclusivo com int8=True. |
int8 | bool | False | Habilita a quantização INT8. Necessário para alvos que aceitam apenas INT8, como RV1103 e RV1106. Quando False, o RKNN Toolkit constrói um modelo de ponto flutuante para alvos capazes de FP16, não FP32. |
data | str | None | YAML do conjunto de dados usado para calibração INT8. Se omitido com int8=True, o Ultralytics seleciona o conjunto de dados de calibração padrão para a tarefa do modelo. |
fraction | float | 1.0 | Fração das imagens de calibração a serem usadas para a quantização INT8. |
device | str | None | Especifica o dispositivo para exportação: GPU (device=0), CPU (device=cpu). |
Por favor, certifique-se de usar uma máquina Linux x86 ao exportar para RKNN.
Para mais detalhes sobre o processo de exportação, visite a página de documentação do Ultralytics sobre exportação.
Link to this sectionImplantando modelos YOLO26 RKNN exportados#
Uma vez que você tenha exportado com sucesso seus modelos Ultralytics YOLO26 para o formato RKNN, o próximo passo é implantar esses modelos em dispositivos baseados em Rockchip.
Link to this sectionInstalação#
Para instalar os pacotes necessários, execute:
# Install the required package for YOLO26
pip install ultralyticsApós instalado, execute a inferência e a validação no seu dispositivo Rockchip exatamente como mostrado na seção Uso acima — o _rknn_model exportado carrega diretamente com YOLO(...).
Se você encontrar uma mensagem de log indicando que a versão do runtime RKNN não corresponde à versão do RKNN Toolkit e a inferência falhar, por favor, substitua /usr/lib/librknnrt.so pelo arquivo librknnrt.so oficial.

Link to this sectionAplicações no mundo real#
Dispositivos equipados com Rockchip usando modelos YOLO26 RKNN podem ser usados em várias aplicações:
- Monitoramento inteligente: Implante sistemas eficientes de detecção de objetos para monitoramento de segurança com baixo consumo de energia.
- Automação industrial: Implemente controle de qualidade e detecção de defeitos diretamente em dispositivos embarcados.
- Análise de varejo: Rastreie o comportamento do cliente e o gerenciamento de inventário em tempo real sem dependência da nuvem.
- Agricultura inteligente: Monitore a saúde das plantações e detecte pragas usando visão computacional na agricultura.
- Robótica autônoma: Habilite a navegação baseada em visão e detecção de obstáculos em plataformas com recursos limitados.
Link to this sectionBenchmarks#
Os benchmarks do YOLO26 abaixo foram executados pela equipe do Ultralytics no Radxa Rock 5B baseado no Rockchip RK3588, com o formato de modelo rknn medindo velocidade e precisão.
| Modelo | Formato | Status | Tamanho (MB) | mAP50-95(B) | Tempo de inferência (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 realizados com ultralytics 8.4.23
A validação para os benchmarks acima foi realizada usando o conjunto de dados COCO128. O tempo de inferência não inclui pré/pós-processamento.
Link to this sectionResumo#
Neste guia, você aprendeu como exportar modelos Ultralytics YOLO26 para o formato RKNN para melhorar sua implementação em plataformas Rockchip. Você também foi apresentado ao RKNN Toolkit e às vantagens específicas de usar modelos RKNN para aplicações de IA de borda.
A combinação de Ultralytics YOLO26 e a tecnologia NPU da Rockchip oferece uma solução eficiente para executar tarefas avançadas de visão computacional em dispositivos embarcados. Essa abordagem possibilita detecção de objetos em tempo real e outras aplicações de IA visual com consumo mínimo de energia e alto desempenho.
Para mais detalhes sobre o uso, visite a documentação oficial do RKNN.
Além disso, se quiser saber mais sobre outras integrações do Ultralytics YOLO26, visite nossa página de guia de integração. Você encontrará muitos recursos e percepções úteis por lá.
Link to this sectionPerguntas Frequentes#
Link to this sectionComo exporto meu modelo Ultralytics YOLO para o formato RKNN?#
Você pode exportar facilmente seu modelo Ultralytics YOLO para o formato RKNN usando o método export() no pacote Python da Ultralytics ou via interface de linha de comando (CLI). Certifique-se de que está usando um PC Linux baseado em x86 para o processo de exportação, pois dispositivos ARM64 como o Rockchip não são suportados para essa operação. Você pode especificar a plataforma Rockchip alvo usando o argumento name, como rk3588, rk3566 ou outros. Este processo gera um modelo RKNN otimizado pronto para implementação em seu dispositivo Rockchip, aproveitando sua Neural Processing Unit (NPU) para inferência acelerada.
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 sectionQuais são os benefícios de usar modelos RKNN em dispositivos Rockchip?#
Modelos RKNN são projetados especificamente para aproveitar os recursos de aceleração de hardware das Neural Processing Units (NPUs) da Rockchip. Essa otimização resulta em velocidades de inferência significativamente mais rápidas e latência reduzida em comparação com a execução de formatos de modelo genéricos como ONNX ou TensorFlow Lite no mesmo hardware. O uso de modelos RKNN permite um uso mais eficiente dos recursos do dispositivo, levando a um menor consumo de energia e melhor desempenho geral, especialmente crítico para aplicações em tempo real em dispositivos de borda. Ao converter seus modelos Ultralytics YOLO para RKNN, você pode obter desempenho ideal em dispositivos equipados com SoCs Rockchip como o RK3588, RK3566 e outros.
Link to this sectionPosso implementar modelos RKNN em dispositivos de outros fabricantes como NVIDIA ou Google?#
Modelos RKNN são especificamente otimizados para plataformas Rockchip e suas NPUs integradas. Embora você possa tecnicamente executar um modelo RKNN em outras plataformas usando emulação de software, você não se beneficiará da aceleração de hardware fornecida pelos dispositivos Rockchip. Para um desempenho ideal em outras plataformas, é recomendado exportar seus modelos Ultralytics YOLO para formatos projetados especificamente para essas plataformas, como TensorRT para GPUs NVIDIA ou TensorFlow Lite para o Edge TPU do Google. A Ultralytics oferece suporte à exportação para uma ampla gama de formatos, garantindo compatibilidade com vários aceleradores de hardware.
Link to this sectionQuais plataformas Rockchip são suportadas para a implementação de modelos RKNN?#
A exportação do Ultralytics YOLO para o formato RKNN suporta plataformas Rockchip com builds RKNN de ponto flutuante, incluindo RK3588, RK3576, RK3566, RK3568, RK3562, RK2118 e RV1126B. Também suporta exportação RKNN quantizada INT8 com int8=True, que é necessária para alvos somente INT8, como RV1103, RV1106, RV1103B e RV1106B. Essas plataformas são comumente encontradas em dispositivos de fabricantes como Radxa, ASUS, Pine64, Orange Pi, Odroid, Khadas e Banana Pi, permitindo que você implemente seus modelos RKNN otimizados em uma variedade de dispositivos equipados com Rockchip, desde computadores de placa única até sistemas industriais.
Link to this sectionComo o desempenho dos modelos RKNN se compara a outros formatos em dispositivos Rockchip?#
Modelos RKNN geralmente superam outros formatos como ONNX ou TensorFlow Lite em dispositivos Rockchip devido à sua otimização para as NPUs da Rockchip. Por exemplo, benchmarks no Radxa Rock 5B (RK3588) mostram que o YOLO26n no formato RKNN atinge um tempo de inferência de 65,7 ms/imagem, significativamente mais rápido que outros formatos. Essa vantagem de desempenho é consistente em vários tamanhos de modelo YOLO26, conforme demonstrado na seção de benchmarks. Ao aproveitar o hardware NPU dedicado, os modelos RKNN minimizam a latência e maximizam o throughput, tornando-os ideais para aplicações em tempo real em dispositivos de borda baseados em Rockchip.