When I first heard about the LuckFox Mini boards, I was amazed — an Embedded Linux board for under $10 that’s smaller than a coin yet packed with features? That’s a dream come true for Embedded Linux Learners.
The LuckFox Mini comes in two variants:
- Mini A – the entry-level version (what I’m using here)
- Mini B – same as Mini A, but with 128MB onboard NAND Flash
🛠️ What You’ll Need
Here’s the minimal setup to get started:
- A Linux PC or Virtual Machin (Windows works too, I’ll show both steps)
- LuckFox Mini A board
- USB Type-A to Type-C cable
- USB card reader + SD card
📥 Getting the Pre-Built Images
LuckFox provides prebuilt images to make life easy. You can grab them here:
👉 Pre-Built Images (Google Drive)
Since I’m using the Mini A, I downloaded the corresponding image.
Once downloaded and unzipped, you should see the following images
💾 Flashing the Embedded Linux Image (Linux Method)
On Linux, flashing is straightforward:
Download the blkenvflash script → Download here
Insert your SD card and find its device path:
$ lsblk
Example: /dev/sdb
Make sure the device list on the Ubuntu PC before and after inserting the SD card to determine that the SD card corresponds to the device /dev/sdb
3. Unzip the script in the folder which contains the images & Make the script executable:
chmod a+x blkenvflash4. Run the flashing script:
./blkenvflash
If you see a missing .env.txt error — don’t worry!
This file defines the SD card partitioning. I pulled mine from Buildroot.
Here’s what my .env.txt looked like:
blkdevparts=mmcblk1:32K(env),512K@32K(idblock),256K(uboot),32M(boot),512M(oem),256M(userdata),6G(rootfs)
sys_bootargs= root=/dev/mmcblk1p7 rootfstype=ext4 rk_dma_heap_cma=24M
sd_parts=mmcblk0:16K@512(env),512K@32K(idblock),4M(uboot)
Save this into a file named .env.txt and rerun the script.
✅ Once it prints “done”, your SD card is ready!
Flashing the Image (Windows Method)
On Windows, you’ll need to install a couple of utilities:
-
USB Driver – Install RK Driver Assistant
SD Card Formatter – Download here
-
Select your card, click Format
-
SoCToolKit – Download here
-
Run as Admin, choose RV1103
-
Select SD Card booting → import the boot file → click Create SD Card
-
Now your SD card is ready to boot.
🔌 First Boot with Embedded Linux & Connecting to the Board
Insert the SD card into your LuckFox Mini A and power it up with the Type-C cable.
The LuckFox boards create a virtual USB network interface with a static IP of of 172.32.0.93.
Before using it, you need to set up the RNDIS virtual network port.
One Linux
$ lsusb
Connect to the Board using SSH
On Windows
- Disable firewall temporarily (Windows Security → Firewall & Network Protection).
- Go to Network Settings → Advanced Network Settings → Change Adapter Options.
- Look for Remote NDIS based Internet Sharing Device.
- Assign a static IP in the same range (e.g.,
172.32.0.50).
- Ping the board
- You can use the Powershell terminal on a Windows computer to enter the password for direct login. The format is ssh
ssh root@172.32.0.93