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 và tiết kiệm năng lượng trên các thiết bị Edge AI. Xuất và triển khai Ultralytics YOLO models trực tiếp lên Metis® AIPU bằng cách sử dụng Voyager SDK.
Axelera AI cung cấp phần cứng tăng tốc chuyên dụng cho computer vision ở biên, sử dụng kiến trúc luồng dữ liệu độc quyền và in-memory computing để mang lại hiệu suất lên tới 856 TOPS với mức tiêu thụ điện năng thấp.
Chọn Phần cứng Phù hợp#
Axelera AI cung cấp nhiều kích thước (form factor) khác nhau để phù hợp với các ràng buộc triển khai khác nhau. Biểu đồ dưới đây giúp xác định phần cứng tối ưu cho việc 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 hóa để 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.
Thẻ Tăng tốc (Accelerator Cards)#
Các thẻ này hỗ trợ tăng tốc AI trong các thiết bị chủ hiện có, tạo điều kiện thuận lợi cho brownfield deployments.
| Sản phẩm | Kích thước (Form Factor) | Tính toán | Hiệu suất (INT8) | Ứng dụng Mục tiêu |
|---|---|---|---|---|
| Metis PCIe x4 | PCIe Gen3 x16 | 4x Metis AIPUs | 856 TOPS | Video analytics mật độ cao, thành phố thông minh |
| Metis PCIe x1 | PCIe Gen3 x1 | 1x Metis AIPU | 214 TOPS | Máy tính công nghiệp, queue management bán lẻ |
| Metis M.2 | M.2 2280 M-Key | 1x Metis AIPU | 214 TOPS | Drones, robot, thiết bị y tế cầm tay |
| Metis M.2 MAX | M.2 2280 | 1x Metis AIPU | 214 TOPS | Các môi trường yêu cầu quản lý nhiệt nâng cao |
Hệ thống Tích hợp#
Đối với các giải pháp chìa khóa trao tay, Axelera hợp tác với các nhà sản xuất để cung cấp các hệ thống đã được kiểm duyệt trước cho Metis AIPU.
- Metis Compute Board: Thiết bị biên độc lập kết hợp Metis AIPU với CPU ARM Rockchip RK3588.
- Workstations: Các máy trạm doanh nghiệp từ Dell (Precision 3460XE) và Lenovo (ThinkStation P360 Ultra).
- Industrial PCs: Các hệ thống được gia cố từ Advantech và Aetina được thiết kế cho manufacturing automation.
Các tác vụ được hỗ trợ#
Ước lượng chiều sâu không được hỗ trợ: đầu chiều sâu phát ra các toán tử mà trình biên dịch Metis AIPU không thể hạ cấp. Phân đoạn YOLO26 cũng không được hỗ trợ bởi Ultralytics export, nhưng vẫn có thể được triển khai thông qua Voyager SDK như mô tả bên dưới.
Phân đoạn YOLO26 chưa được hỗ trợ thông qua lệnh Ultralytics export. Người dùng cần YOLO26-seg có thể triển khai thông qua Voyager SDK bằng cách sử dụng deploy.py, cung cấp giải pháp tạm thời ở không gian người dùng. Hỗ trợ trình biên dịch gốc sẽ được bổ sung trong bản phát hành trong tương lai.
Cài đặt#
Việc xuất sang định dạng Axelera yêu cầu:
- Hệ điều hành: Chỉ Linux (khuyến nghị Ubuntu 22.04/24.04)
- Hardware: Trợ tốc Axelera AI (Metis devices)
- Python: Các phiên bản 3.10, 3.11, 3.12 và 3.13
- System dependency:
sudo apt install libgl1(yêu cầu bởi OpenCV, không bao gồm quapip)
Cài đặt Ultralytics#
pip install ultralyticsĐể biết hướng dẫn chi tiết, hãy xem Ultralytics Installation guide của chúng tôi. Nếu bạn gặp khó khăn, hãy tham khảo Common Issues guide của chúng tôi.
Cài đặt Driver Axelera#
-
Thêm khóa kho lưu trữ 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 kho lưu trữ vào apt:
Chọn đoạn mã phù hợp từ bên dưới để khớp với HĐH đ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 SDK và tải driver:
sudo apt update sudo apt install -y metis-dkms=1.5.5 sudo modprobe metis
Trình điều khiển kernel được cài đặt tách biệt với các gói Python SDK, do đó sau khi nâng cấp SDK (ví dụ: từ 1.6 lên 1.7), bạn phải cài đặt phiên bản trình điều khiển phù hợp. Trình điều khiển không đồng bộ khiến thiết bị không khả dụng: axdevice báo cáo phiên bản yêu cầu và không thể mở thiết bị.
[libaxldev.c:285] Found kernel driver version 1.4.16, but at least version 1.4.18 is required. Please update the kernel driver
ERROR: AXR_ERROR_CONNECTION_ERROR: Failed to open device metis-0:4:0Cài đặt phiên bản trình điều khiển khớp với SDK của bạn — xem Step 3: Install the Metis kernel driver. Nếu bạn đang chạy SDK cũ hơn trên Ubuntu, hãy cập nhật trình điều khiển và tải lại mô-đun kernel (không cần khởi động lại):
sudo apt update
sudo apt install -y metis-dkms=1.5.5
sudo rmmod metis
sudo modprobe metisSau đó chạy lại axdevice để xác nhận thiết bị đã được phát hiện.
yolo export format=axelera hoặc yolo predict đầu tiên với mô hình Axelera sẽ tự động tải xuống và cài đặt các gói Axelera SDK. Quá trình này có thể mất vài phút tùy thuộc vào tốc độ kết nối của bạn và không có thanh tiến trình nào hiển thị trong quá trình tải xuống. Để cài đặt thủ công trước:
pip install axelera-devkit==1.7.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simple
pip install axelera-rt==1.7.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simpleXuất YOLO Models sang Axelera#
Định dạng Axelera hỗ trợ các chế độ Export, Predict và Validate. Suy luận và kiểm định chạy trên phần cứng Axelera Metis AIPU. Xuất mô hình của bạn, sau đó tải mô hình đã xuất để chạy suy luận hoặc kiểm định độ chính xác của nó.
from ultralytics import YOLO
# Load a YOLO26 model
model = YOLO("yolo26n.pt")
# Export the model to Axelera format
model.export(format="axelera") # creates 'yolo26n_axelera_model'from ultralytics import YOLO
# Load the exported Axelera model
model = YOLO("yolo26n_axelera_model")
# Run inference
results = model("https://ultralytics.com/images/bus.jpg")from ultralytics import YOLO
# Load the exported Axelera model
model = YOLO("yolo26n_axelera_model")
# Validate accuracy on the COCO8 dataset
metrics = model.val(data="coco8.yaml")Trình biên dịch Axelera yêu cầu numpy<2. Nếu môi trường của bạn có numpy>=2, yolo export đầu tiên sẽ tự động hạ cấp nhưng việc xuất sẽ thất bại do trạng thái mô-đun cũ. Chỉ cần chạy lại lệnh xuất tương tự — nó sẽ thành công ở lần chạy thứ hai.
Đối số xuất#
| Đối số | Loại | Mặc định | Mô tả |
|---|---|---|---|
format | str | 'axelera' | Định dạng mục tiêu cho phần cứng Axelera Metis AIPU. |
imgsz | int hoặc tuple | 640 | Kích thước hình ảnh cho đầu vào model. |
batch | int | 1 | Chỉ định kích thước suy luận hàng loạt của mô hình xuất hoặc số lượng ảnh tối đa mà mô hình xuất sẽ 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 bật tự động cho Axelera AIPU. Thay thế các cờ half/int8 đã bị loại bỏ. Xem INT8 quantization. |
data | str | None | Tập dữ liệu hiệu chuẩn YAML; phân loại thay vào đó sẽ nhận một thư mục dataset hoặc tên dataset tích hợp sẵn. Nếu bỏ qua, Ultralytics sẽ chọn một dataset hiệu chuẩn dành riêng cho tác vụ. |
fraction | float, int, hoặc list | 1.0 | Tập hợp con hiệu chuẩn dưới dạng tỷ lệ, số lượng ảnh hoặc các tỷ lệ/số lượng [train, val]; một danh sách giới hạn train hoặc val, trong khi test vẫn giữ nguyên đầy đủ (khuyên dùng 100-400 ảnh). |
device | str | None | Thiết bị xuất: GPU (device=0) hoặc CPU (device=cpu). |
Đối với tất cả các tùy chọn xuất, hãy xem Export Mode documentation.
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#
Metis AIPU tối đa hóa thông lượng trong khi giảm thiểu tiêu thụ năng lượng.
| Mô hình | FPS Metis PCIe (khung hình trên giây) | FPS Metis M.2 (khung hình trên giây) |
|---|---|---|
| YOLOv8n | 847 | 771 |
| YOLO11n | 746 | 574 |
| YOLO26n | 648.6 | 484.9 |
Các đ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.
Ứng dụng trong thực tế#
Ultralytics YOLO trên phần cứng Axelera cho phép các giải pháp điện toán biên nâng cao:
- Smart Retail: Object counting thời gian thực và heatmap analytics để tối ưu hóa cửa hàng.
- Industrial Safety: PPE detection độ trễ thấp trong môi trường sản xuất.
- Drone Analytics: Object detection tốc độ cao trên UAV phục vụ agriculture và tìm kiếm cứu nạn.
- Traffic Systems: License plate recognition và speed estimation dựa trên biên.
Quy trình làm việc được đề xuất#
- Huấn luyện (Train) model của bạn bằng Chế độ Huấn luyện của Ultralytics
- Xuất sang định dạng Axelera bằng cách sử dụng
model.export(format="axelera") - Xác thực (Validate) độ chính xác với
yolo valđể xác minh mức thất thoát do lượng tử hóa là tối thiểu - Dự đoán (Predict) bằng
yolo predictđể xác thực định tính - Triển khai vào một đường ống (pipeline) đầu cuối hiệu năng cao mà không phụ thuộc vào PyTorch — hãy xem YOLO on Voyager SDK examples để biết các đường ống 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Để chẩn đoán chi tiết, hãy xem AxDevice documentation.
Hiệu suất tối đa#
Tích hợp này sử dụng cấu hình đơn nhân để đảm bảo tính tương thích. Đối với môi trường sản xuất yêu cầu thông lượng tối đa, Axelera Voyager SDK cung cấp:
- Tận dụng đa nhân (Metis AIPU lõi tứ)
- Các pipeline suy luận truyền phát (streaming)
- Suy luận theo ô (tiled inferencing) cho các camera có độ phân giải cao hơn
Xem model-zoo để biết các điểm chuẩn FPS hoặc contact Axelera để được hỗ trợ trong sản xuất.
Các vấn đề đã biết#
- Hạn chế về nguồn điện M.2: Các model lớn hoặc siêu lớn có thể gặp lỗi runtime trên các thiết bị tăng tốc M.2 do các ràng buộc về nguồn cung cấp điện.
Để nhận hỗ trợ, hãy truy cập Axelera Community.
Câu hỏi thường gặp#
Voyager SDK hỗ trợ xuất các mô hình YOLOv8, YOLO11 và YOLO26. Xem Supported Tasks để biết tính khả dụng của tác vụ theo từng mô hình.
Có. Bất kỳ mô hình nào được huấn luyện bằng Ultralytics Train Mode đều có thể được xuất sang định dạng Axelera, miễn là nó sử dụng các lớp và phép toán được hỗ trợ.
Voyager SDK của Axelera tự động lượng tử hóa các mô hình cho kiến trúc AIPU hỗn hợp độ chính xác. Đối với hầu hết các tác vụ object detection, việc cải thiện hiệu suất (FPS cao hơn, tiêu thụ ít điện năng hơn) vượt trội hơn hẳn so với tác động tối thiểu đến mAP. Quá trình lượng tử hóa mất từ vài giây đến vài giờ tùy thuộc vào kích thước mô hình. Chạy
yolo valsau khi xuất để xác minh độ chính xác.Chúng tôi khuyến nghị từ 100 đến 400 ảnh. Số lượng hơn 400 không mang lại lợi ích bổ sung và 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 sự cân bằng tối ưu.
SDK, trình điều khiển và các công cụ biên dịch có sẵn thông qua Axelera Developer Portal.