AXERA AX650N 설치 및 사용기

language

kor

date

Sep 18, 2025

slug

ax650

author

status

Public

Specification

Component	Details
CPU	Octa-core Cortex A55
NPU	72Tops@INT4 or 18Tops@INT8
DSP	Dual VDSP
ISP	8K@30fps, AI-ISP
Video Encoder	H.264/H.265, 8K@30fps
Video Decoder	H.264/H.265, 8K@60fps
Video Input Interfaces	2x4 or 4x2 Lane MIPI CSI
Video Output Interfaces	HDMI 2.0 x 2, 4k@60fps + 1080p@60fps
DDR	64bit LPDDR4(x), Up to 4266Mbit/s rate
Ethernet	Two Gigabit Ethernet port, RGMII and RMII modes
PCIe or SATA	PCIe 2.0 x 2, SATA3.0 x 4
USB	USB 3.0 x 1, USB 2.0 x 2

Quick Start Guide

처음 시작하면 설치된 프로그램도 전혀 동작하지 않고, (웹브라우져도..) AXERA-TECH에서 올려준 샘플도 빌드가 안되는 문제. 빌드 에러를 보니 BSP 버전과 샘플 프로젝트의 버전이 안맞는 로그를 발견해서 Sipeed 사이트에서 axp 확장자의 BSP 를 다운 받고, AXDL 이라는 AXERA PC 프로그램으로 보드에 내장된 emmc를 flashing 업데이트가 필요.

M4NDock_release(1.45)_231211_sha256_c0c79345bfef84a53060834db2bdd817646bb6181be6d47550860b7a46e2576b.axp

1646739.0KB

아래 포트와 AXDL이 위치한 PC를 USB-A to USB-A 케이블로 연결하여 사용.

⚠️외부 전원은 제거하고 USB 전원만 사용하라고 경고하는데, 잘되지 않아 그냥 진행함. 주의: PC의 USB포트 손상될 수 있음!!!

두 개 버튼을 동시에 눌렀다가 RST 버튼만 떼면(안되면 여러 번 시도) 어느순간 PC 장치관리자에서 AXERA U2S PORT 포트가 잡히고 AXDL에서 자동으로 다운로드가 시작된다. axp 파일이 용량이 꽤 있기 때문에 flash까지는 시간이 오래 걸린다.

⚠️

처음에 UART로 잘못 올려가지고, 중간에 멈추지도 못하고 4일 동안 UART로 1.6GB를 올려서 flashing 했다. 꼭 USB로 할 것!!

업데이트가 완료되면 아래와 같이 unplugged 상태가 되고, 포트가 사라짐. reboot된 상태니, 이제 다시 모니터에 연결해서 사용하면 업데이트 된 버전을 사용할 수 있음.

Example Build test

✅SAM-ONNX-AX650-CPP

‣


cmake -DONNXRUNTIME_DIR=${onnxruntime_dir} -DOpenCV_DIR=${opencv_cmake_file_dir} -DBSP_MSP_DIR=${msp_out_dir} -DBUILD_WITH_AX650=ON ..

각 라이브러리 경로 설정 필요. onnxruntime_dir과 opencv_cmake_file_dir는 위 github의 git clone 시 third_party 폴더에 있는 것을 사용하면 됨. 절대 경로로 설정하면 됨.


export onnxruntime_dir=/path/to/onnxruntime
export opencv_cmake_file_dir=/path/to/opencv/build
export msp_out_dir=/path/to/bsp_msp

msp_out_dir은 아래 BSP SDK에서 msp/out 폴더를 M4N Dock으로 다운로드 받아 경로를 추가해주면 빌드 성공


make -j4

Build with QT


cd qtproj
mkdir build
apt install cmake qt6-base-dev qtcreator
cmake -DONNXRUNTIME_DIR=${onnxruntime_dir} -DOpenCV_DIR=${opencv_cmake_file_dir} -DBSP_MSP_DIR=${msp_out_dir} -DBUILD_WITH_AX650=ON ../SAMQT/
make -j4

실제 사용할 ax_model 파일 및 예제 이미지들은 위 github release에 있음.

samqt_ax650.zip

191737.8KB

✅BSP SDK Build

ax650n_bsp_sdk

AXERA-TECH • Updated Mar 27, 2026

는 실제품 M4N Dock에서 빌드하는게 아닌 크로스 플랫폼을 이용해 x86_64 시스템에서 빌드하는 것(WSL 환경에서 빌드되는 것을 확인)

x86_64에서 크로스 컴파일 하는 이유


wget https://developer.arm.com/-/media/Files/downloads/gnu-a/9.2-2019.12/binrel/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz
sudo tar -xvf gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt/
export PATH="/opt/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu/bin/:$PATH"


git clone https://github.com/AXERA-TECH/ax650n_bsp_sdk.git
cd ax650n_bsp_sdk

third-party-ax650.tgz

364856.9KB

ax650n_bsp_sdk 폴더에 압축을 풀면 third_party 폴더가 생기면서 빌드 시 상대경로로 참조


wget https://www.notion.so/kwanmo/AXERA-AX650N-5133c46772464fe48ed1e1ae34e5c89a?pvs=4#13780f03465380ccb9d3e2d71bf709fb
tar -xvf third-party-ax650.tgz


cd app
make p=AX650_pipro_box


cd msp/samples
make p=AX650_pipro_box

빌드한 msp폴더를 통째로 M4N box로 이동하여 app, samples, msp 라이브러리를 추후에 사용

OS08A20 Camera module 연결

HW 연결 방법

미동작 시 연결 후 아래의 TP를 찍어 정상 전압이 나오는지 확인

센서 동작 여부

위에서 빌드한 msp/out/bin에는 여러 샘플이 있는데 그 중 영상을 취득해서 RTSP로 스트리밍하는 FRTDemo를 아래와 같이 실행하면, RTSP 주소에 들어가 영상을 취득할 수 있음.


bash ./run.sh -p 0 -s 1 -n 2

같은 네트워크에 연결된 PC에서 아래와 같이 RTSP 영상을 취득하는 opencv python 코드를 실행하면 영상 취득 가능


import cv2

# RTSP URL
rtsp_url = "rtsp:/192.168.100.53:8554/axstream0"

# OpenCV VideoCapture 객체 생성
cap = cv2.VideoCapture(rtsp_url)
#cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1280)
#cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 720)
if not cap.isOpened():
    print("RTSP 스트림을 열 수 없습니다.")
else:
    print("RTSP 스트림 연결 성공")

# 프레임을 실시간으로 읽어와 표시
try:
    while True:
        ret, frame = cap.read()
        if not ret:
            print("프레임 읽기 실패. 스트림이 중단되었을 수 있습니다.")
            break
        frame = cv2.resize(frame,(1280,640))
        # 프레임 표시
        cv2.imshow('RTSP Stream', frame)

        # 'q' 키를 누르면 종료
        if cv2.waitKey(1) & 0xFF == ord('q'):
            print("스트림 종료")
            break
finally:
    # 리소스 해제
    cap.release()
    cv2.destroyAllWindows()

⚠️

Image Format YUV422 때문인지 윈도우 VLC 플레이어에서는 영상을 디스플레이하지 못해, 따로 위의 파이썬 코드로 영상 확인

SDK로 직접 Acquisition(이미지 픽셀값 포인터로 접근)

🚧

작업중

빌드한 코드 중 sample_vin.c 가 카메라 이미지 취득 관련 예제 코드.

해당 코드에는 센서의 여러 configuration에 대해 다루고 있으므로, 우리가 필요한 부분만 남기고 제거 및 아래의 이미지 취득 관련 AXERA SDK 라이브러리에 대한 확인 필요



#include "ax_isp_api.h"
#include "sample_vin.h"
#include "common_sys.h"
#include "common_vin.h"
#include "common_cam.h"
#include "ax_vin_error_code.h"
#include "common_nt.h"

ax-sample

🚧

작업중