Welcome to Firefly
English
Firefly Docsss
Last Updated: 2026-11-18 14:58:00

Quick Start

Power On

Firefly-R3572A supports two power supply methods (choose either one):

  • Type-C power connector (silkscreen DCIN): located on the board edge, rated input 12V/3A. It is recommended to use a power adapter compliant with PD 3.1 or earlier fast-charge protocols
  • DC power socket (Wafer 4Pin-2mm): silkscreen GND/VCC, rated input DC 12V/3A

The two red boxes in the image below mark the power connectors described above: the Type-C power connector (DCIN) at the top-right edge, and the DC power socket (Wafer 4Pin-2mm) below it. Connect the power adapter to either one (subject to the adapter included with the product):

Firefly-R3572A boots as soon as power is connected. The boot logo appears during startup:

Note

Some platforms may have no boot logo — refer to your actual display.

The system enters the desktop after booting completes.

System Login

The image below shows the Linux system of Firefly-R3572A (GNOME desktop) as an example. Please refer to the actual display for other platforms or graphics frameworks:

Account and Password

PlatformAccountPassword
Rockchipfireflyfirefly
Sophgolinarolinaro
Qualcommfireflyfirefly
NVIDIAnvidianvidia
SpacemiTfireflyfirefly

Root passwords are not set by default on these firmwares: run sudo passwd root after login to set one. If a firmware has set a root password, it is the same as the normal user password of that platform.

Choose a Login Method

  • HDMI display + mouse and keyboard: open a terminal on the desktop to start development
  • Debug UART: log in to the command line through the J3 debug UART at 1500000 baud. For details, refer to Debug Usage
  • ADB: connect through the Type-C interface. For details, refer to ADB Usage
  • For the locations of the debug interfaces, refer to the debug / adb chapters in Hardware Usage
  • A few headless products (such as the 3576Q38 and 1126BQ38 series) must be accessed through the debug serial port or ADB

SSH Remote Login (Optional)

SSH is a common network login method. The device uses a dynamic IP by default. Log in through one of the methods above first, configure a static IP for the device, and then connect with SSH:

ssh firefly@<device static IP>

Application Development

For Linux application development, refer to the community document Ubuntu/Debian Development Guide.

Do not run a full system upgrade

Do not run sudo apt-get upgrade, sudo apt full-upgrade, or sudo do-release-upgrade. These are embedded products with highly customized kernels and operating systems; running upgrade is very likely to break system dependencies and cause system malfunctions.

The image below shows the Android 16 desktop of Firefly-R3572A as an example. Please refer to the actual display for other platforms:

Basic Operations

The right mouse button works as the Back key

Terminal Debugging

You can enter the terminal through ADB, or log in through the debug UART.

Debug Interface Location

Refer to the debug / adb chapters in Hardware Usage.

Application Development Collections

Application Software Development Collection

The application software development collection diagram is as follows; click the link below to enter:

Application Software Development Collection

AI Development Collection

The AI development collection diagram is as follows:

AI Development Collection

Tip: LlamaPi

LlamaPi is a large-model deployment and management tool developed by the Firefly AI team, supporting Linux systems only. It targets edge devices with LLM inference capability, helping users deploy and manage open-source large models locally and provide inference capability to third-party applications through an OpenAI-compatible API for fast local AI deployment.

System and BSP Development

For system and BSP development (source code, compilation, firmware flashing), refer to the Software Development chapters:

On this page