Welcome to Firefly
English
Firefly Docsss
Last Updated: 2026-11-18 11:46:19

Quick Start

Power On

The image below shows the power connector of AIBOX-3588S. Connect the power adapter to this connector (use the power adapter bundled with the product):

Cannot power on?

If the device has an auto_pwr DIP switch, it must be set to the ON side to power on. If the device fails to power on, check this switch first. The switch position in the image below is correct:

AIBOX-3588S boots up as soon as it is connected to power. During boot, the following logo is displayed:

Note

NVIDIA-based products show the NVIDIA logo; some platforms may have no boot logo — refer to your actual device.

System Login

The image below shows the Linux desktop (XFCE) of a 3588-series product as an example. For other platforms or other display frameworks, refer to your actual display:

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.

Log in to the System via Any of the Following Methods

  • HDMI monitor + mouse and keyboard: log in to the desktop and open a terminal for development
  • Debug serial port: available on all products, log in to the command line directly
  • ADB: available on some products (mostly via the Type-C port); see the product specification
  • For the exact locations of these debug interfaces, see the debug / adb chapters under "Hardware Usage" in the product documentation
  • 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 way to log in over the network. The device uses a dynamic IP by default, so first log in via one of the methods above, configure a static IP for the device, and then connect with SSH:

ssh firefly@<device static IP>

Getting Started with Application Development

For an introduction to Linux application development, see the community documentation 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.

Note

Products based on the SpacemiT (K3), NVIDIA, or Sophgo platforms do not provide an Android system. This section applies only to products that ship with an Android system.

The image below shows the Android 12 desktop of a 3588-series product as an example. For other platforms, refer to your actual display:

Basic Operation

Right-click works as the Back key

Terminal Debugging

Most Android products support ADB, which allows terminal debugging; the debug serial port can also be used to log in

Debug Interface Locations

See the debug / adb chapters under "Hardware Usage" in the product documentation

Application Development Collection

Application Software Development Collection

The application software development collection is shown below; click the link underneath to open it:

Application Software Development Collection

AI Development Collection

The AI development collection is shown below:

AI Development Collection

Special note: LlamaPi

LlamaPi (pronounced “llama-pie”) is a large model deployment and management tool developed by the Firefly AI team, and it only supports Linux systems. Designed for edge devices with LLM inference capability, it helps users deploy and manage open-source large models locally and provides inference capabilities for third-party applications through an OpenAI-compatible API, enabling rapid local AI model deployment.

System and BSP Development

For system and BSP development (source code, building, firmware flashing), see the development guide chapters in the product Wiki (under "Software Development").

On this page