Skip to main content

Download and Build

This document is based on Ubuntu 22.04

Environment Preparation​

Installing Dependencies​

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget jq device-tree-compiler

Download OpenWrt​

The code repository has two branches:bl-v1.0.y and bl-v2.0.y, which correspond to linux-6.1 and linux-6.6, respectively. The bl-v2.0.y branch will be primarily maintained going forward.

git clone https://gitee.com/bianbu-linux/openwrt.git -b bl-v2.0.y

Feeds​

Use the following commands to run or update packages. Package updates will be downloaded from the official OpenWrt website, so ensure that the device has network access. If any packages fail to download, please try running the commands again.

cd openwrt
./scripts/feeds update -a 
./scripts/feeds install -f -p spacemit_openwrt_feeds -a
./scripts/feeds install -a

Firmware Compilation​

The optional parameter V=s in the compilation command provides detailed logs. Currently, there are two options for initiating the compilation process.

The image will be generated at bin/targets/spacemit/DEVICE_debX/ directory with *.zip extension.

Cleaning​

  • The full cleanup command will delete directories such as bin, build_dir, staging_dir, feeds, dl, as well as the .config file, returning the code repository to its original state.
make distclean
  • The partial cleanup command will delete the build output directories such as bin, build_dir, staging_dir, but it will not remove the dl directory, the .config file, or other similar files.
make dirclean

single package compilation​

build uboot​

  • compile
make package/boot/uboot-spacemit/compile V=s
  • clean
make package/boot/uboot-spacemit/clean V=s

build opensbi​

  • compile
make package/boot/opensbi-spacemit/compile V=s
  • clean
make package/boot/opensbi-spacemit/clean V=s

build linux​

  • compile
make target/linux/compile V=s
  • clean
make target/linux/clean V=s

build adb package​

The compilation process for other packages is similar to the following method.

  • compile
make package/utils/adb/compile V=s
  • clean
make package/utils/adb/clean V=s

Flashing​

Firmware *.zip: can be flashed to the device's onboard storage using the Titan Flasher Tool, please refer to Flash tools for detailed instructions.

Firmware *sdcard.img: Can be written to the card using the dd command. The device can boot from the card once it is inserted and powered on.

Supported Devices List​

  • BPI-F3
  • MUSE-Pi

Soft Router Functionality​

The soft router function is enabled by default on the board types in the supported devices list. When the system boots up, the WiFi AP mode is activated by default. Specifically:

For SBC solutions: The wired network card eth1 is the LAN port, and eth2 is the WAN port.

FAQ​

Error with pthread_once during kernel compilation​

When compiling OpenWRT based on Ubuntu 20.04, an error with "pthread_once" may occur. This can be resolved by modifying the linux-*/certs/Makefile.

//openwrt/build_dir/target-riscv64_riscv64_musl_*/linux-spacemit_*/linux-6.1.15/certs/Makefile
# Change the last line to:
HOSTLDLIBS_extract-cert =  -lcrypto -pthread

How to Update U-Boot/OpenSBI/Linux Versions​

  1. OpenWRT tracks the versions of the U-Boot/OpenSBI/Linux repositories hosted on https://gitee.com/bianbu-linux. OpenWRT periodically updates these repository versions.

  2. If it is necessary to manually update to the latest versions of U-Boot/OpenSBI/Linux, please follow these steps:

    • Confirm that the latest version tarball has been uploaded tohttps://archive.spacemit.com/openwrt/dl/，such as linux-6.1-v1.0.15.tar.xz

    alt text

    • Changing the Version Number in the Makefile
diff --git a/package/boot/opensbi-spacemit/Makefile b/package/boot/opensbi-spacemit/Makefile
index d4572af253..208d2fae6d 100644
--- a/package/boot/opensbi-spacemit/Makefile
+++ b/package/boot/opensbi-spacemit/Makefile
@@ -16,7 +16,7 @@ else
 PKG_NAME:=opensbi
 PKG_RELEASE:=1
 PKG_VERSION:=1.3
-PKG_SOURCE_VERSION:=1.0.5
+PKG_SOURCE_VERSION:=v1.0.15
 
 PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION)-$(PKG_SOURCE_VERSION).tar.gz
 PKG_SOURCE_URL:=https://archive.spacemit.com/openwrt/dl/
diff --git a/package/boot/uboot-spacemit/Makefile b/package/boot/uboot-spacemit/Makefile
index 51e6e97fb7..c69173cfa8 100644
--- a/package/boot/uboot-spacemit/Makefile
+++ b/package/boot/uboot-spacemit/Makefile
@@ -18,7 +18,7 @@ else
 PKG_NAME:=uboot
 PKG_RELEASE:=1
 PKG_VERSION:=2022.10
-PKG_SOURCE_VERSION:=1.0.5
+PKG_SOURCE_VERSION:=v1.0.15
 
 PKG_SOURCE:=uboot-$(PKG_VERSION)-$(PKG_SOURCE_VERSION).tar.gz
 PKG_SOURCE_URL:=https://archive.spacemit.com/openwrt/dl/

diff --git a/target/linux/spacemit/Makefile b/target/linux/spacemit/Makefile
index ac230af366..148e5a79b8 100644
--- a/target/linux/spacemit/Makefile
+++ b/target/linux/spacemit/Makefile
@@ -20,7 +20,7 @@ CONFIG_EXTERNAL_KERNEL_TREE=$(TOPDIR)/../bsp-src/linux-6.1
 CONFIG_KERNEL_GIT_CLONE_URI=""
 else
 ## download tar.xz from url.
-LINUX_VERSION_CUSTOM:=linux-6.1-1.0.5
+LINUX_VERSION_CUSTOM:=linux-6.1-v1.0.15
 LINUX_SOURCE:=$(LINUX_VERSION_CUSTOM).tar.xz
 LINUX_KERNEL_HASH:=skip
 endif

```sh
* update kernel config

```sh
make kernel_menuconfig
  • compile There may be compliation failures. If any errors are encountered, please refer to the error message to identify and resolve the issues.
make -j12 V=s

Change the Download Source to SpacemiT​

SpacemiT maintains a set of pre-compiled packages that can be downloaded and installed by changing the source.

  • Modify the software source address (based on device modifications): bl-v2.0.y is a specific version tag. Please modify it according to your needs. If using the SBC solution, change DEVICE_MUSE-N1 to DEVICE_debX.
//vim /etc/opkg/distfeeds.conf

src/gz openwrt_base https://archive.spacemit.com/openwrt/releases/bl-v2.0.y/packages/riscv64_riscv64/base
src/gz openwrt_luci https://archive.spacemit.com/openwrt/releases/bl-v2.0.y/packages/riscv64_riscv64/luci
src/gz openwrt_packages https://archive.spacemit.com/openwrt/releases/bl-v2.0.y/packages/riscv64_riscv64/packages
src/gz openwrt_routing https://archive.spacemit.com/openwrt/releases/bl-v2.0.y/packages/riscv64_riscv64/routing
src/gz openwrt_telephony https://archive.spacemit.com/openwrt/releases/bl-v2.0.y/packages/riscv64_riscv64/telephony
src/gz openwrt_spacemit_packages https://archive.spacemit.com/openwrt/releases/bl-v2.0.y/targets/spacemit/DEVICE_MUSE-N1/packages