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-1684X. 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-1684X 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 of a Sophgo-platform product as an example:

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

Sophgo-platform products can be accessed over the network or via the debug serial port:

  • Network login: see the Ethernet chapter under "Hardware Usage" in the product documentation
  • Debug serial port: see the debug serial port chapter under "Hardware Usage" in the product documentation

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