# 유틸리티 사용

본 문서는 모빌린트 NPU의 상태 확인 혹은 기타 테스트 등에 사용할 수 있는 유틸리티 기능에 대한 설명을 제공합니다.

## Linux 전용 유틸리티

- **mobilint-cli**: NPU 상태 확인, 벤치마크 실행, MXQ 정보 조회 등을 수행할 수 있는 커맨드라인 유틸리티.
- **mobilint-runtime-gui**: NPU를 이용해 다양한 AI 모델을 코드 없이 쉽게 실행·테스트할 수 있는 GUI 기반 유틸리티.

### mobilint-cli

- NPU 상태 확인

    ```bash
    mobilint-cli status
    ```

    - `-L` 또는 `--list-npus` : 시스템에 설치된 모든 NPU 디바이스를 표시합니다.
    - `-i {device_id}` 또는 `--id {device_id}` : 지정한 `{device_id}` 에 해당하는 NPU 디바이스의 상태를 표시합니다. `{device_id}`는 "/dev/aries*"의 숫자 부분에 해당합니다.
    - `-l {second}` 또는 `--loop {second}` : `{second}` 초 간격으로 다바이스의 상태를 지속적으로 표시합니다. `-i` 또는 `--id` 옵션이 없으면 기본 디바이스(0번)의 상태를 표시합니다..
    - `-m {milli_sec}` 또는 `--loop-ms {milli-sec}` : `-l` 옵션과 동일하나, 밀리초 단위로 상태를 갱신합니다.
    - `-f {file_name}` 또는 `--file {file_name}` : 디바이스 상태를 `{file_name}` 파일로 저장합니다.

- MXQ 파일 정보 확인

    ```bash
    mobilint-cli mxqtool
    ```

    - `show {mxq_path}` : `{mxq_path}` 경로의 MXQ 파일을 사용합니다.
    - `extract {mxq_path} {dir_path}` : `{mxq_file}` 경로에 있는 MXQ 파일의 내용을 추출하여 `{dir_path}` 폴더에 저장합니다.
    - `collect {dir_path} {mxq_path}` : `extract` 명령으로 추출한 `{dir_path}`의 내용을 기반으로 `{mxq_path}`에 새로운 MXQ 파일을 생성합니다.

- 추론 테스트

    ```bash
    mobilint-cli testinfer
    ```

    - `--repeat-count {num}` : 추론을 `{num}` 회 반복 수행합니다.
    - `--core-mode {mode}` : 추론 시 사용할 코어 모드를 지정합니다. (컴파일 시 지정한 모드 내에서 사용해야 합니다.)
    - `--mxq-path {mxq_path}` : `{mxq_path}` 위치의 MXQ 모델을 사용하여 추론을 수행합니다.
    - `--summary` : `--mxq-path` 옵션으로 지정된 mxq 파일의 정보를 출력합니다.
    - 더 많은 옵션은 `--help` 명령을 통해 확인할 수 있습니다.

```{note}
현재 `mobilint-cli benchmark` 명령은 비전 모델만 지원합니다.
```

- 벤치마크 테스트

    ```bash
    moblint-cli benchmark
    ```
    - `-p {mxq_path}` 또는 `--mxq-path {mxq_path}` : `{mxq_path}` 위치의 MXQ 파일을 사용합니다.
    - `-t {second}` 또는 `--time {second}` : `{second}`초 동안 벤치마크 테스트를 수행합니다.
    - 더 많은 옵션은 `--help` 명령을 통해 확인할 수 있습니다.

### mobilint-runtime-gui

1. GUI 서버 실행

    터미널에 다음 명령을 입력하여 GUI 서버를 실행합니다.

    ```bash
    mobilint-runtime-gui
    ```

    정상적으로 실행되면, 아래 사진과 같이 붉은 박스 영역에 접속 주소가 표시됩니다 (예: "http://127.0.0.1:5000")

    ![runtime-gui_usage](../res/image/runtime_gui_usage.png "runtime-gui usage")

2. 웹 브라우저로 접속

    안내 메세지에 표시된 주소(예: "http://127.0.0.1:5000")를 복사한 뒤, 웹 브라우저의 주소창에 입력하여 접속합니다.

3. GUI 사용

    브라우저 접속이 성공하면 아래 사진과 같은 GUI 화면이 표시됩니다.

    ![runtime-gui_sceenshot](../res/image/runtime_gui_screenshot.png "runtime-gui screenshot")

4. 사용 종료

    GUI를 종료하려면 실행한 터미널에 "Ctrl + C" 를 입력하여 GUI 서버를 종료합니다.

## Windows / Linux 공통 유틸리티

- **aries_flash_firmware**: NPU firmware 를 업데이트 할 수 있는 CLI 유틸리티.
- **mobilint_ctrl**: NPU의 상태를 확인하고, firmware 업데이트를 위한 GUI 유틸리티.

### aries flash firmware

- aries_flash_firmware 유틸리티의 사용 가능 명령어 목록은 아래와 같습니다.

```bash
> aries_flash_firmware

Flash firmware for Aries. v0.5 (build #348 date : 31 December 2025)
Usage: aries_flash_firmware  [--help] [-f|--force] [-s|--supress_info] [-i|--id=device_id] [-t input_value] firmware_file

      --help                display this help and exit
  -f, --force               Force to flash without validation check.
  -s, --supress_info        Suppressed information.
  -i, --id=device_id        Device ID. (default : 0)
  -t input_value            Extra input value for special command.
  firmware_file             Input firmware file name(.gpt) or command.

                            ** Special command ** ([] <= with 'input_value')
                            status     : Get current device status [to file]
                            info       : Get firmware information [from file]
                            device     : List up all devices
                            list       : List up all firmware release
                            download   : Download latest/[Specific] firmware
                            update     : Update latest/[Specific] firmware
                            product    : Show product management information
```

1. 설치된 카드 상태 확인하기

`aries_flash_firmware status [-i device_id]` 명령어를 통해 카드의 상태를 확인할 수 있습니다.

```bash
> aries_flash_firmware status
* PCIe Device Driver connection details.
        > Driver version : 1.6.229 (Revision 0)
        > PCIe card connection information.
                 - Main-System(VID:0x209F,DID:0x0000), Sub-System(VID:0x0402,DID:0x1093), PCIe 4.0 - 8 Lanes
        Device type   : Aries 2 (Firmware rev. 0)
        Product type  : Commercial
        Board type    : Low profile
        DRAM size     : 16 GB

*I: Current firmware.
    - Reading Board [==================================================] Done.
        BSP           : aries-mla100-32Gb
        Product name  : MLA100 LowProfile 16GB
        Version       : v1.2.2 rev.0 (Build date : 2025-08-12 17:01:48 KST)
        Configuration : master(26c3edab) release
        SHA256 check  : Ok!

*I: The firmware is already up to date.
```

2. 모든 디바이스 정보 얻기

```bash
> aries_flash_firmware device
*** Device list. ***

   Device #0 (\\.\mobilint_pcie)
        - Aries 2 Low profile 16 GB (Firmware v1.2.4[rev.0], Commercial)

*I: Total 1 device is found.
```

3. 온라인 펌웨어 업데이트

```{note}
펌웨어 업데이트 이후에 펌웨어를 정상적으로 사용하기 위해 Host PC를 재부팅 해야합니다.
```

```bash
>aries_flash_firmware update
* PCIe Device Driver connection details.
        > Driver version : 1.8.0 (Revision 2)
        > PCIe card connection information.
                 - Main-System(VID:0x209F,DID:0x0000), Sub-System(VID:0x0402,DID:0x1093), PCIe 4.0 - 8 Lanes
        Device type   : Aries 2 (Firmware v1.2.4 rev#0)
        Product type  : Commercial
        Board type    : Low profile
        DRAM size     : 16 GB

*I: Current firmware.
    - Reading Board [==================================================] Done.
        BSP           : aries-mla100
        Product name  : MLA100 LowProfile
        Version       : v1.2.4 rev.0 (Build date : 2026-02-03 14:06:23 KST)
        Configuration : HEAD(10944bc7) release
        SHA256 check  : Ok!

*I: No need to update, The firmware is already up to date.
- More detail information : https://docs.mobilint.com
```

### Mobilint Ctrl

![Mobilint_ctrl](../res/image/mblt_ctrl.png "mobilint_ctrl")

실행 시 위의 화면과 같이 NPU의 다양한 상태 정보 등을 표기해줍니다.