Xuất và triển khai trên Axelera AI#
Ultralytics hợp tác với Axelera AI để hỗ trợ suy luận hiệu năng cao, tiết kiệm năng lượng trên các thiết bị Edge AI. Xuất và triển khai trực tiếp model Ultralytics YOLO lên Metis® AIPU bằng Voyager SDK.
Axelera AI cung cấp khả năng tăng tốc phần cứng chuyên dụng cho thị giác máy tính ở biên, sử dụng kiến trúc luồng dữ liệu độc quyền và điện toán trong bộ nhớ để mang lại hiệu năng lên đến 856 TOPS với mức tiêu thụ điện năng thấp.
Lựa chọn phần cứng phù hợp#
Axelera AI cung cấp nhiều dạng thiết bị để đáp ứng các giới hạn triển khai khác nhau. Biểu đồ dưới đây giúp xác định phần cứng tối ưu cho triển khai Ultralytics YOLO của bạn.
graph TD
A[Start: Select Deployment Target]:::start --> B{Device Type?}:::decide
B -->|Edge Server / Workstation| C{Throughput Needs?}:::decide
B -->|Embedded / Robotics| D{Space Constraints?}:::decide
B -->|Standalone / R&D| E[Dev Kits & Systems]:::proc
C -->|Max Density <br> 30+ Streams| F[**Metis PCIe x4**<br>856 TOPS]:::out
C -->|Standard PC <br> Low Profile| G[**Metis PCIe x1**<br>214 TOPS]:::out
D -->|Drones & Handhelds| H[**Metis M.2**<br>2280 M-Key]:::out
D -->|High Performance Embedded| I[**Metis M.2 MAX**<br>Extended Thermal]:::out
E -->|ARM-based All-in-One| J[**Metis Compute Board**<br>RK3588 + AIPU]:::out
E -->|Prototyping| K[**Arduino Portenta x8**<br>Integration Kit]:::out
click F "https://store.axelera.ai/"
click G "https://store.axelera.ai/"
click H "https://store.axelera.ai/"
click J "https://store.axelera.ai/"
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef decide fill:#FF9800,color:#fff
classDef out fill:#9C27B0,color:#fffDanh mục phần cứng#
Dòng phần cứng Axelera được tối ưu để chạy Ultralytics YOLO26 và các phiên bản cũ với hiệu suất FPS trên mỗi watt cao.
Card tăng tốc#
Các card này cho phép tăng tốc AI trên các thiết bị host hiện có, hỗ trợ triển khai trên hạ tầng hiện hữu.
| Sản phẩm | Dạng thiết bị | Năng lực tính toán | Hiệu năng (INT8) | Ứng dụng mục tiêu |
|---|---|---|---|---|
| Metis PCIe x4 | PCIe Gen3 x16 | 4x Metis AIPU | 856 TOPS | Phân tích video mật độ cao, thành phố thông minh |
| Metis PCIe x1 | PCIe Gen3 x1 | 1x Metis AIPU | 214 TOPS | PC công nghiệp, quản lý hàng đợi trong bán lẻ |
| Metis M.2 | M.2 2280 M-Key | 1x Metis AIPU | 214 TOPS | Drone, robot, thiết bị y tế di động |
| Metis M.2 MAX | M.2 2280 | 1x Metis AIPU | 214 TOPS | Môi trường cần quản lý nhiệt nâng cao |
Hệ thống tích hợp#
Đối với các giải pháp trọn gói, Axelera hợp tác với các nhà sản xuất để cung cấp hệ thống đã được xác thực trước cho Metis AIPU.
- Bo mạch tính toán Metis: Thiết bị edge độc lập kết hợp Metis AIPU với CPU ARM Rockchip RK3588.
- Máy trạm: Máy dạng tower cho doanh nghiệp của Dell (Precision 3460XE) và Lenovo (ThinkStation P360 Ultra).
- PC công nghiệp: Các hệ thống gia cường của Advantech và Aetina, được thiết kế cho tự động hóa sản xuất.
Các tác vụ được hỗ trợ#
Không hỗ trợ ước lượng độ sâu: head độ sâu tạo ra các toán tử mà compiler Metis AIPU không thể hạ cấp. Ultralytics export cũng không hỗ trợ phân đoạn đối tượng YOLO26, nhưng vẫn có thể triển khai thông qua Voyager SDK như mô tả bên dưới. Phân đoạn ngữ nghĩa YOLO26 được hỗ trợ.
Hiện chưa hỗ trợ phân đoạn đối tượng YOLO26 thông qua lệnh export của Ultralytics. Người dùng cần yolo26-seg có thể triển khai qua Voyager SDK bằng deploy.py, cung cấp giải pháp thay thế ở user-space. Hỗ trợ compiler gốc sẽ được bổ sung trong bản phát hành tương lai.
Cài đặt#
Để xuất sang định dạng Axelera, cần có:
- Hệ điều hành: Chỉ Linux (khuyến nghị Ubuntu 22.04/24.04)
- Phần cứng: Bộ tăng tốc Axelera AI (thiết bị Metis)
- Python: Phiên bản 3.10, 3.11, 3.12 và 3.13
- PyTorch:
torch>=2.8,<2.13 - Voyager SDK: 1.8.0; quá trình xuất cài phiên bản devkit này và quá trình suy luận cài phiên bản runtime này
- Driver kernel Metis:
metis-dkmsphiên bản 1.6.2 trở lên, được cài riêng vớipip - Dependency hệ thống:
sudo apt install libgl1(OpenCV yêu cầu, không được bao gồm thông quapip)
Cài đặt Ultralytics#
pip install ultralyticsĐể xem hướng dẫn chi tiết, hãy tham khảo hướng dẫn Cài đặt Ultralytics. Nếu gặp khó khăn, hãy xem hướng dẫn Các sự cố thường gặp của chúng tôi.
Cài đặt driver Axelera#
-
Thêm khóa repository Axelera:
sudo sh -c "curl -fsSL https://software.axelera.ai/artifactory/api/security/keypair/axelera/public | gpg --dearmor -o /etc/apt/keyrings/axelera.gpg" -
Thêm repository vào apt:
Chọn đoạn lệnh phù hợp bên dưới với hệ điều hành đang sử dụng.
# Ubuntu 22.04 sudo sh -c "echo 'deb [signed-by=/etc/apt/keyrings/axelera.gpg] https://software.axelera.ai/artifactory/axelera-apt-source ubuntu22 main' > /etc/apt/sources.list.d/axelera.list"# Ubuntu 24.04 sudo sh -c "echo 'deb [signed-by=/etc/apt/keyrings/axelera.gpg] https://software.axelera.ai/artifactory/axelera-apt-source ubuntu24 main' > /etc/apt/sources.list.d/axelera.list" -
Cài đặt driver và tải driver vào kernel. SDK 1.8 yêu cầu
metis-dkmsphiên bản 1.6.2 trở lên, vì vậy tại đây sẽ cài đặt phiên bản mới nhất:sudo apt update sudo apt install -y metis-dkms sudo modprobe metis
Driver kernel được cài riêng với các package Python SDK, vì vậy sau khi nâng cấp SDK, bạn cũng phải cập nhật driver lên mức tối thiểu mà SDK yêu cầu — phiên bản 1.6.2 cho SDK 1.8. Quá trình cài đặt không kiểm tra điều này; nếu driver thấp hơn mức tối thiểu, thiết bị sẽ không khả dụng: axdevice báo phiên bản cần thiết và không mở được thiết bị.
[libaxldev.c:285] Found kernel driver version 1.5.5, but at least version 1.6.2 is required. Please update the kernel driver
ERROR: AXR_ERROR_CONNECTION_ERROR: Failed to open device metis-0:4:0Xem thêm Bước 3: Cài đặt driver kernel Metis. Nếu bạn đang chạy SDK cũ hơn trên Ubuntu, hãy cập nhật driver và tải lại module kernel (không cần khởi động lại):
sudo apt update
sudo apt install -y metis-dkms
sudo rmmod metis
sudo modprobe metisSau đó chạy lại axdevice để xác nhận thiết bị được phát hiện.
Lần đầu chạy yolo export format=axelera hoặc yolo predict với model Axelera, các package Axelera SDK sẽ được tự động tải xuống và cài đặt. Quá trình này có thể mất vài phút tùy tốc độ kết nối; tiến trình tải xuống sẽ không hiển thị. Để cài đặt thủ công trước:
pip install axelera-devkit==1.8.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simple
pip install axelera-rt==1.8.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simpleSDK 1.8 nâng phiên bản định dạng model .axm đã biên dịch, do đó các thư mục _axelera_model được tạo bằng SDK cũ hơn sẽ bị từ chối khi tải. Hãy xuất lại từng model sau khi nâng cấp:
Error: Unsupported model version: 4.0, expected at least 5.0
Please re-deploy or re-download the model.Xuất model YOLO sang Axelera#
Định dạng Axelera hỗ trợ các chế độ Xuất, Dự đoán và Đánh giá. Suy luận và đánh giá chạy trên phần cứng Axelera Metis AIPU. Hãy xuất model, sau đó tải model đã xuất để chạy suy luận hoặc đánh giá độ chính xác.
from ultralytics import YOLO
# Nạp model YOLO26
model = YOLO("yolo26n.pt")
# # Xuất model sang định dạng Axelera
model.export(format="axelera") # creates 'yolo26n_axelera_model'from ultralytics import YOLO
# # Tải model Axelera đã xuất
model = YOLO("yolo26n_axelera_model")
# Chạy suy luận
results = model("https://ultralytics.com/images/bus.jpg")from ultralytics import YOLO
# # Tải model Axelera đã xuất
model = YOLO("yolo26n_axelera_model")
# # Đánh giá độ chính xác trên bộ dữ liệu COCO8
metrics = model.val(data="coco8.yaml")Các tham số xuất model#
| Đối số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
format | str | 'axelera' | Định dạng đích cho phần cứng Axelera Metis AIPU. |
imgsz | int hoặc tuple | 640 | Kích thước ảnh đầu vào của model. |
batch* | int | 1 | Chỉ định kích thước batch suy luận của model khi xuất hoặc số lượng ảnh tối đa mà model đã xuất xử lý đồng thời ở chế độ predict. |
quantize | int hoặc str | 8/auto | Độ chính xác lượng tử hóa. 8 (INT8) là bắt buộc và được tự động bật cho Axelera AIPU. Thay thế các flag half/int8 đã lỗi thời. Xem lượng tử hóa INT8. |
data | str | None | Tệp YAML của bộ dữ liệu hiệu chỉnh; với phân loại, thay vào đó hãy dùng thư mục bộ dữ liệu hoặc tên bộ dữ liệu tích hợp sẵn. Nếu bỏ qua, Ultralytics sẽ chọn bộ dữ liệu hiệu chỉnh phù hợp với tác vụ. |
fraction | float, int hoặc list | 1.0 | Tập con hiệu chỉnh dưới dạng tỷ lệ, số lượng ảnh hoặc tỷ lệ/số lượng [train, val, test]. Danh sách gồm hai phần tử giữ nguyên test, trong khi 0 sẽ bỏ qua phần này (khuyến nghị 100–400 ảnh). |
device | str | None | Thiết bị xuất: GPU (device=0) hoặc CPU (device=cpu). |
* Suy luận bằng batch>1 yêu cầu Voyager SDK phiên bản 1.8.0 trở lên; model được biên dịch cho một ảnh duy nhất.
Để xem tất cả tùy chọn xuất, hãy tham khảo tài liệu Chế độ xuất.
Cấu trúc đầu ra#
yolo26n_axelera_model/
├── yolo26n.axm # Axelera model file
├── compiler_config_final.toml # Compiler configuration used for the build
└── metadata.yaml # Model metadata (classes, image size, etc.)Điểm chuẩn Axelera AI#
AIPU Metis tối đa hóa thông lượng đồng thời giảm thiểu mức tiêu thụ năng lượng.
| Model | FPS của Metis PCIe (khung hình/giây) | FPS của Metis M.2 (khung hình/giây) |
|---|---|---|
| YOLOv8n | 847 | 771 |
| YOLO11n | 746 | 574 |
| YOLO26n | 648.6 | 484.9 |
Điểm chuẩn dựa trên dữ liệu của Axelera AI. FPS thực tế phụ thuộc vào kích thước model, batching và độ phân giải đầu vào.
Đây là số liệu thông lượng phía host, được đo bằng model zoo với pipeline streaming của Voyager SDK trên tệp video 720p. Một lệnh gọi predict riêng lẻ báo cáo độ trễ trên mỗi ảnh, đây là một đại lượng khác.
Ứng dụng thực tế#
Ultralytics YOLO trên phần cứng Axelera hỗ trợ các giải pháp điện toán biên tiên tiến:
- Bán lẻ thông minh: Đếm đối tượng theo thời gian thực và phân tích heatmap để tối ưu hóa cửa hàng.
- An toàn công nghiệp: Phát hiện PPE độ trễ thấp trong môi trường sản xuất.
- Phân tích bằng drone: Phát hiện đối tượng tốc độ cao trên UAV phục vụ nông nghiệp và tìm kiếm cứu nạn.
- Hệ thống giao thông: Nhận dạng biển số và ước tính tốc độ trên thiết bị biên.
Quy trình được khuyến nghị#
- Huấn luyện model bằng Train Mode của Ultralytics
- Xuất sang định dạng Axelera bằng
model.export(format="axelera") - Xác thực độ chính xác bằng
yolo valđể xác minh mức suy giảm do lượng tử hóa là tối thiểu - Dự đoán bằng
yolo predictđể xác thực định tính - Triển khai vào pipeline đầu cuối hiệu năng cao mà không phụ thuộc vào PyTorch — xem các ví dụ YOLO trên Voyager SDK để tham khảo pipeline Python có thể kết hợp, sử dụng
axelera-rt
Kiểm tra tình trạng thiết bị#
Xác minh thiết bị Axelera của bạn đang hoạt động bình thường:
# if axdevice cannot be found, please run at least one inference (see above) to ensure the required packages are installed
axdeviceĐể xem chẩn đoán chi tiết, hãy tham khảo tài liệu AxDevice.
Hiệu năng tối đa#
Các model được biên dịch cho một ảnh. Truyền nhiều ảnh vào Predict sẽ đưa chúng qua bộ lập lịch Axelera (Voyager SDK 1.8 trở lên), vì vậy batch>1 chạy chính xác; tuy nhiên, khi đo đầu cuối trên một thiết bị đơn lẻ, tốc độ không nhanh hơn batch=1:
yolo predict model=yolo26n_axelera_model source=path/to/images batch=8Đối với môi trường production cần thông lượng tối đa, Axelera Voyager SDK cung cấp:
- Pipeline suy luận streaming duy trì nhiều frame đang được xử lý
- Biên dịch một model trên nhiều lõi
- Suy luận theo vùng chia ô cho camera độ phân giải cao hơn
Xem model-zoo để tham khảo điểm chuẩn FPS hoặc liên hệ Axelera để được hỗ trợ triển khai production.
Các vấn đề đã biết#
- Hạn chế về nguồn điện của M.2: Các model lớn hoặc cực lớn có thể gặp lỗi runtime trên bộ tăng tốc M.2 do giới hạn nguồn cấp.
Để được hỗ trợ, hãy truy cập Cộng đồng Axelera.
Câu hỏi thường gặp#
Voyager SDK hỗ trợ xuất các model YOLOv8, YOLO11 và YOLO26. Xem Các tác vụ được hỗ trợ để biết những tác vụ có sẵn cho từng model.
Có. Mọi model được huấn luyện bằng Train Mode của Ultralytics đều có thể xuất sang định dạng Axelera, miễn là model sử dụng các layer và phép toán được hỗ trợ.
Voyager SDK của Axelera tự động lượng tử hóa model cho kiến trúc AIPU độ chính xác hỗn hợp. Với phần lớn tác vụ phát hiện đối tượng, lợi ích về hiệu năng (FPS cao hơn, mức tiêu thụ điện năng thấp hơn) vượt xa mức ảnh hưởng tối thiểu đến mAP. Thời gian lượng tử hóa dao động từ vài giây đến vài giờ tùy theo kích thước model. Chạy
yolo valsau khi xuất để xác minh độ chính xác.Chúng tôi khuyến nghị dùng từ 100 đến 400 ảnh. Dùng hơn 400 ảnh không mang lại lợi ích bổ sung mà còn làm tăng thời gian lượng tử hóa. Hãy thử nghiệm với 100, 200 và 400 ảnh để tìm ra mức cân bằng tối ưu.
SDK, driver và công cụ biên dịch có sẵn tại Cổng thông tin dành cho nhà phát triển Axelera.