# Chạy ứng dụng mẫu bằng máy chủ Bạn có thể chạy ứng dụng mẫu trên Qualcomm Dragonwing^™^ RB3 Gen 2 Development Kit bằng máy chủ chạy Windows, Ubuntu hoặc macOS. ## Điều kiện tiên quyết Trước khi chạy bất cứ ứng dụng nào, hãy nhớ [Thiết lập thiết bị](https://docs.qualcomm.com/doc/80-70020-251V/topic/set_up_the_device.html#set-up-the-device). Ghi chú Để bật âm thanh, hãy xem [Hướng dẫn về âm thanh của Qualcomm Linux](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-16/enable-audio.html). ## [Chạy ứng dụng đa phương tiện mẫu](https://docs.qualcomm.com/doc/80-70020-251V/topic/run-apps-manually-on-host.html#link-mm-apps) Các ứng dụng đa phương tiện mẫu cho thấy các use case của camera, display và luồng video trên thiết bị. ### Phát trực tiếp hoặc mã hóa trên nhiều camera (Camera hành trình) Ứng dụng dòng lệnh **gst-multi-camera-example** cho thấy quá trình truyền trực tiếp đồng thời từ 2 cảm biến camera trên thiết bị Dragonwing RB3 Gen 2. Ứng dụng này sẽ ghép các luồng video từ camera lại với nhau để hiển thị trên màn hình hoặc mã hóa và lưu trữ các luồng video dưới dạng tệp. Camera 0 Composition Composer Display Camera 1 Camera 0 Encoding H.264 encoder Write to file H.264 encoder Camera 1 Write to file **Hình: Quy trình làm việc của ứng dụng camera hành trình**
Last Published: Jan 28, 2026
 **Video: Ứng dụng multicamera** **Ví dụ sử dụng** Để chạy ứng dụng, hãy chạy theo các use cases sau từ SSH terminal: 1. Để xem ứng dụng mẫu trên HDMI display, hãy chạy lệnh export sau đây: export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1 Copy to clipboard 2. Để xem đầu ra `waylandsink`, hãy chạy lệnh sau: gst-multi-camera-example -o 0 Copy to clipboard 3. Để lưu kết quả đầu ra của encoder, hãy làm như sau: 1. Chạy lệnh sau: gst-multi-camera-example -o 1 Copy to clipboard Thiết bị lần lượt lưu các video tại `/opt/cam1_vid.mp4` và `/opt/cam2_vid.mp4` cho camera 1 và camera 2. 2. Để lấy tệp từ máy tính, hãy chạy lệnh sau: scp root@:/opt/cam1_vid.mp4 Copy to clipboard Ghi chú Khi được nhắc nhập mật khẩu, hãy nhập `oelinux123`. 3. Để phát video đầu ra encoder , bạn có thể dùng bất kỳ trình phát nội dung nghe nhìn nào hỗ trợ tệp MP4. - Để dừng use case, hãy chọn Ctrl + C. - Để hiển thị các tùy chọn trợ giúp sẵn có, hãy chạy lệnh sau: gst-multi-camera-example --help Copy to clipboard - Biến môi trường `GST_DEBUG` kiểm soát kết quả đầu ra gỡ lỗi GStreamer. Đặt mức bắt buộc để cho phép ghi log Ví dụ: để lấy warning log, hãy chạy lệnh sau: export GST_DEBUG=2 Copy to clipboard ### Decode và compose video đa kênh (Video wall) Ứng dụng **gst-concurrent-videoplay-composition** cho phép giải mã và phát video đồng thời đối với các video được mã hóa AVC và compose chúng trên display cho các ứng dụng Video wall. Ứng dụng này yêu cầu ít nhất một tệp video đầu vào, phải là tệp MP4 có codec AVC. Read from file H.264 encoder Composer Display H.264 encoder Read from file H.264 encoder Read from file H.264 encoder Read from file **Hình: Quy trình làm việc với ứng dụng Video wall**
Last Published: Jan 28, 2026
 **Video: Ứng dụng decode và display đa kênh** **Ví dụ sử dụng** 1. Để chuyển các video đã ghi sẵn hoặc video thử nghiệm ở định dạng MP4 được mã hóa AVC (H.264) (có tên tệp là ``) sang thiết bị của bạn, hãy chạy lệnh sau trên máy tính: scp root@[DEVICE IP-ADDR]:/opt/ Copy to clipboard Ghi chú Khi được nhắc nhập mật khẩu, hãy nhập `oelinux123`. 2. Để chạy ứng dụng mẫu trên HDMI display, hãy chạy lệnh export sau treen SSH terminal: export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1 Copy to clipboard > > > 3. Để phát lại đồng thời 4 kênh, hãy chạy lệnh sau: gst-concurrent-videoplay-composition -c 4 -i /opt/.mp4 -i /opt/.mp4 -i /opt/.mp4 -i /opt/.mp4 Copy to clipboard Ghi chú - `-c`: chỉ định số luồng được giải mã để biên soạn. Có thể giải mã 2, 4 hoặc 8 luồng. - `-i`: chỉ định đường dẫn tuyệt đối đến tệp video đầu vào. - Để dừng use case, hãy chọn CTRL + C. - Để hiển thị các tùy chọn trợ giúp sẵn có, hãy chạy lệnh sau: gst-concurrent-videoplay-composition --help Copy to clipboard - Biến môi trường `GST_DEBUG` kiểm soát kết quả đầu ra gỡ lỗi GStreamer. Đặt mức bắt buộc để cho phép ghi log Ví dụ: để lấy warning log, hãy chạy lệnh sau: export GST_DEBUG=2 Copy to clipboard ## [Chạy ứng dụng AI mẫu](https://docs.qualcomm.com/doc/80-70020-251V/topic/run-apps-manually-on-host.html#link-ai-apps) Ứng dụng mẫu AI cho thấy các use case để phát hiện đối tượng và suy luận song song trên các luồng đầu vào từ camera, tệp video hoặc luồng Giao thức phát trực tuyến theo thời gian thực (RTSP) trên thiết bị Dragonwing RB3 Gen 2. Để chạy các ứng dụng mẫu này, bạn phải lấy model AI từ [Qualcomm® AI Hub](https://aihub.qualcomm.com/iot/models) và nhãn từ GitHub. Quy trình này bao gồm việc tải các model và nhãn xuống, chuyển chúng sang thiết bị Dragonwing RB3 Gen 2 và chạy các ứng dụng mẫu. > > > > > > > > > > > > Downloadmodels and labels > > > > Transfer downloadedfiles to the device > > > > Runsample apps > > > > > > > > > > > > > > **Figure: Workflow for running AI sample applications** **Điều kiện tiên quyết** Ứng dụng AI mẫu yêu cầu phải có tệp model và nhãn trên thiết bị để chạy ứng dụng. **Quy trình** 1. Bạn cần có các model sau cho ứng dụng mẫu AI: | Ứng dụng mẫu | Model cần có | | --- | --- | | Phát hiện đối tượng AI | [yolox_quantized.tflite](https://aihub.qualcomm.com/iot/models/yolox?searchTerm=yolo) | | AI inference song song | [yolox_quantized.tflite](https://aihub.qualcomm.com/iot/models/yolox?searchTerm=yolo) | | AI inference song song | [Inception-v3](https://aihub.qualcomm.com/iot/models/inception_v3) | | AI inference song song | [HRNetPose](https://aihub.qualcomm.com/iot/models/hrnet_pose) | | AI inference song song | [DeepLabV3-Plus-MobileNet](https://aihub.qualcomm.com/iot/models/deeplabv3_plus_mobilenet) | | | | | | | | | | 2. Tải xuống và chạy script tự động để lấy các tệp model cũng như nhãn trên thiết bị: curl -L -O https://raw.githubusercontent.com/quic/sample-apps-for-qualcomm-linux/refs/heads/main/download_artifacts.sh Copy to clipboard chmod +x download_artifacts.sh Copy to clipboard ./download_artifacts.sh -v GA1.5-rel -c QCS6490 Copy to clipboard 3. Cập nhật hằng số `q_offset` và `q_scale` của model LiteRT đã lượng tử hóa trong tệp JSON. Để biết hướng dẫn, hãy xem phần [Lấy hằng số model](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-15B/integrate-ai-hub-models.html#get-the-model-constants). 4. Sử dụng lệnh sau để đẩy các tệp model đã tải xuống vào thiết bị: scp root@:/etc/models Copy to clipboard **Ví dụ** scp inception_v3_quantized.tflite root@:/etc/models/ Copy to clipboard 5. Tạo một thư mục để thử nghiệm video bằng các lệnh sau: > > > ssh root@ > Copy to clipboard > > > mount -o remount, rw /usr > Copy to clipboard > > > mkdir /etc/media/ > Copy to clipboard 6. Từ máy tính, hãy đẩy các tệp video thử nghiệm vào thiết bị: > > > scp .mp4 root@:/etc/media/ > Copy to clipboard ### Phát hiện đối tượng AI Ứng dụng mẫu **gst-ai-object-detection** cho thấy khả năng của phần cứng trong việc phát hiện các đối tượng trên luồng đầu vào từ camera, tệp video hoặc luồng RTSP. Pipeline này tiếp nhận luồng dữ liệu đầu vào, xử lý sơ bộ, inferences trên phần cứng AI và hiển thị kết quả trên màn hình. **Hình: Quy trình làm việc với ứng dụng phát hiện đối tượng**
Last Published: Jan 28, 2026
 **Video: Ứng dụng phát hiện đối tượng** **Ví dụ sử dụng** Bắt buộc phải đẩy tệp model và nhãn vào thiết bị để chạy ứng dụng mẫu. Để biết chi tiết, hãy xem [Quy trình](https://docs.qualcomm.com/doc/80-70020-251V/topic/run-apps-manually-on-host.html#procedure-ai). 1. Bắt đầu một phiên SSH mới và khởi động HDMI display nếu bạn chưa: ssh root@ Copy to clipboard 2. Để chạy ứng dụng mẫu trên HDMI display, hãy chạy lệnh export sau treen SSH terminal: export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_ DISPLAY=wayland-1 Copy to clipboard 3. Chỉnh sửa tệp `/etc/configs/config_detection.json` trên thiết bị. { "file-path": "/etc/media/video.mp4", "ml-framework": "tflite", "yolo-model-type": "yolox", "model": "/etc/models/yolox_quantized.tflite", "labels": "/etc/labels/yolox.labels", "constants": "Yolox,q-offsets=<38.0, 0.0, 0.0>,q-scales=<3.6124823093414307, 0.003626860911026597, 1.0>;", "threshold": 40, "runtime": "dsp" } Copy to clipboard | Trường | Giá trị/mô tả | | --- | --- | | **ml-framework** | **ml-framework** | | `snpe` | Sử dụng Qualcomm^®^ Neural Processing SDK models | | `tflite` | Sử dụng model LiteRT | | `qnn` | Sử dụng Qualcomm^®^ AI Engine direct models | | **yolo-model-type** | **yolo-model-type** | | `yolov5`
`yolov8`
`yolox`
`yolonas` | Chạy lần lượt model YOLOv5, YOLOv8, YOLOx và YOLO-NAS. Xem [Tệp nhãn và model mẫu](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/gst-ai-object-detection.html#gst-ai-object-detection__section_hds_vxp_mdc). | | **runtime** | **runtime** | | `cpu` | Chạy trên CPU | | `gpu` | Chạy trên GPU | | `dsp` | Chạy trên bộ xử lý tín hiệu kỹ thuật số (DSP) | | **Nguồn đầu vào** | **Nguồn đầu vào** | | `camera` |

  • 0 – Camera chính


  • 1 – Camera phụ


| | `file-path` | Đường dẫn thư mục đến tệp video | | `rtsp-ip-port` | Địa chỉ luồng RTSP ở định dạng `rtsp://:/` | 4. Để khởi động ứng dụng, hãy chạy lệnh sau: gst-ai-object-detection Copy to clipboard - Để dừng use case, hãy chọn Ctrl + C. - Để hiển thị các tùy chọn trợ giúp sẵn có, hãy chạy lệnh sau: gst-ai-object-detection -h Copy to clipboard - Biến môi trường `GST_DEBUG` kiểm soát kết quả đầu ra gỡ lỗi GStreamer. Đặt mức bắt buộc để cho phép ghi log Ví dụ: để lấy warning log, hãy chạy lệnh sau: export GST_DEBUG=2 Copy to clipboard ### Inference AI song song Ứng dụng **gst-ai-parallel-inference** cho thấy khả năng của phần cứng trong việc AI inferences song song trên các luồng đầu vào từ camera, tệp video hoặc luồng RTSP. Pipeline phát hiện đối tượng, phân loại đối tượng, phát hiện tư thế và phân đoạn hình ảnh trên luồng đầu vào. Màn hình hiển thị kết quả trên màn hình. **Hình: Luồng ứng inference luận song song**
Last Published: Jan 28, 2026
 **Video: Ứng dụng inference song song** **Ví dụ sử dụng** Bắt buộc phải đẩy tệp model và nhãn vào thiết bị để chạy ứng dụng mẫu. Để biết chi tiết, hãy xem [Quy trình](https://docs.qualcomm.com/doc/80-70020-251V/topic/run-apps-manually-on-host.html#procedure-ai). 1. Bắt đầu một phiên SSH mới và khởi động HDMI display nếu bạn chưa: ssh root@ Copy to clipboard 2. Để chạy ứng dụng mẫu trên HDMI display, hãy chạy lệnh export sau treen SSH terminal: export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_ DISPLAY=wayland-1 Copy to clipboard 3. Chỉnh sửa tệp `/etc/configs/config-parallel-inference.json` trên thiết bị. { "file-path": "/etc/media/video.mp4", "detection-model": "/etc/models/yolox_quantized.tflite", "detection-labels": "/etc/labels/yolox.labels", "detection-constants": "Yolox,q-offsets=<38.0, 0.0, 0.0>,q-scales=<3.6124823093414307, 0.003626860911026597, 1.0>;", "pose-model": "/etc/models/hrnet_pose_quantized.tflite", "pose-labels": "/etc/labels/hrnet_pose.labels", "pose-constants" : "Posenet,q-offsets=<8.0>,q-scales=<0.0040499246679246426>;", "segmentation-model": "/etc/models/deeplabv3_plus_mobilenet_quantized.tflite", "segmentation-labels": "/etc/labels/deeplabv3_resnet50.labels", "segmentation-constants": "deeplab,q-offsets=<0.0>,q-scales=<1.0>;", "classification-model": "/etc/models/inception_v3_quantized.tflite", "classification-labels": "/etc/labels/classification.labels", "classification-constants": "Inceptionv3,q-offsets=<38.0>,q-scales=<0.17039915919303894>;" } Copy to clipboard Bảng sau đây mô tả các trường tệp cấu hình để đặt cấu hình nguồn đầu vào cho cùng một ứng dụng. | **Trường** | **Giá trị/mô tả** | | --- | --- | | **Nguồn đầu vào** | **Nguồn đầu vào** | | camera |

  • 0 – Camera chính


  • 1 – Camera phụ


| | file-path | Đường dẫn thư mục đến tệp video | | rtsp-ip-port | Địa chỉ luồng RTSP ở định dạng `rtsp://:/` | 4. Để khởi động ứng dụng, hãy chạy lệnh sau: gst-ai-parallel-inference Copy to clipboard - Để dừng use case, hãy chọn Ctrl + C. - Để hiển thị các tùy chọn trợ giúp sẵn có, hãy chạy lệnh sau: gst-ai-parallel-inference -h Copy to clipboard Qualcomm AI Hub thường xuyên cập nhật các model với phiên bản SDK mới nhất. Sử dụng sai hằng số model có thể dẫn đến kết quả không chính xác. Nếu bạn gặp phải vấn đề như vậy, hãy cập nhật hằng số model trong tệp cấu hình. - Biến môi trường `GST_DEBUG` kiểm soát kết quả đầu ra gỡ lỗi GStreamer. Đặt mức bắt buộc để cho phép ghi log Ví dụ: để lấy warning log, hãy chạy lệnh sau: export GST_DEBUG=2 Copy to clipboard **Vấn đề đã biết** Trong việc phát hiện tư thế, model chỉ phát hiện 1 người, ngay cả khi có nhiều người trong khung hình. Ghi chú Việc phân loại hình ảnh bằng cách sử dụng model Inception v3 sẽ được train trên tập dữ liệu ImageNet. Do đó, model không thể phát hiện một người vì loại này không có trong tập dữ liệu. Last Published: Jan 28, 2026 [Previous Topic Sử dụng Qualcomm Visual Studio Code Extension](https://docs.qualcomm.com/bundle/publicresource/80-70020-251V/topics/run-apps-using-ide.md) [Next Topic Phát triển ứng dụng](https://docs.qualcomm.com/bundle/publicresource/80-70020-251V/topics/develop_application.md) Source: [https://docs.qualcomm.com/doc/80-70020-251V/topic/run-apps-manually-on-host.html](https://docs.qualcomm.com/doc/80-70020-251V/topic/run-apps-manually-on-host.html)