跳到主要内容

下载和编译

以下文档基于ubuntu22.04描述.

环境准备

安装依赖

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

下载代码

代码仓库分为bl-v1.0.y,bl-v2.0.y两个分支,分别对应linux-6.1、linux-6.6。后续主要维护bl-v2.0.y分支。

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

拉取feeds

首次或想更新包时需要运行以下命令。更新包会从openwrt官网等下载压缩包,请确保网络可用。如果出现某些包下载失败,可重复执行命令

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

固件编译

以下编译命令的可选参数V=s为输出详细日志。目前提供两种方案的编译启动。

SBC方案

cp feeds/spacemit_openwrt_feeds/spacemit_k1_defconfig .config
make -j12 V=s

固件位于bin/targets/spacemit/DEVICE_debX/*.zip

NAS方案

cp feeds/spacemit_openwrt_feeds/spacemit_k1_nas_defconfig .config
make -j12 V=s

固件位于bin/targets/spacemit/DEVICE_MUSE-N1/*.zip

清理

  • 全部清理命令,会把bin、build_dir、staging_dir、feeds、dl等目录以及.config文件都删掉,代码仓库为最原始的状态
make distclean
  • 局部清理命令,会把编译输出目录bin、build_dir、staging_dir删掉,不包含dl目录、.config文件等
make dirclean

单包编译

单编uboot

  • 编译
make package/boot/uboot-spacemit/compile V=s
  • 清理
make package/boot/uboot-spacemit/clean V=s

单编opensbi

  • 编译
make package/boot/opensbi-spacemit/compile V=s
  • 清理
make package/boot/opensbi-spacemit/clean V=s

单编linux

  • 编译
make target/linux/compile V=s
  • 清理
make target/linux/clean V=s

单编adb包

其他包的编译都类似一下的编译方式

  • 编译
make package/utils/adb/compile V=s
  • 清理
make package/utils/adb/clean V=s

烧写

固件*.zip,使用Titan Flasher工具刷写至设备板载存储介质,刷机工具使用参考刷机工具使用

固件*sdcard.img,可使用dd命令写至卡上,设备插卡上电即可实现卡启动

支持设备列表

SBC 方案

  • BPI-F3
  • MUSE-Pi

NAS 方案

  • MUSE-N1

软路由

在以上支持设备列表的板型默认开启软路由功能。系统开机后默认开启WiFi AP模式,其中:

SBC方案有线网卡eth1为lan口,eth2为wan

NAS方案有线网卡2.5G为wan,其它两个千兆口为lan

  • 热点名称:openWRT-AP
  • 热点密码:12345678
  • WiFi网关:192.168.1.1

FAQ

内核编译链接pthread_once出错

基于ubuntu 20.04编译openwrt出现"pthread_once"的编译报错,可修改linux-*/certs/Makefile

openwrt/build_dir/target-riscv64_riscv64_musl_*/linux-spacemit_*/linux-6.1.15/certs/Makefile
最后一行改成:
HOSTLDLIBS_extract-cert = -lcrypto -pthread

如何更新uboot/opensbi/linux版本

1.openwrt跟踪https://gitee.com/bianbu-linux的uboot/opensbi/linux仓库版本。openwrt会不定期更新该仓库的版本

2.如果需要手动更新最新的uboot/opensbi/linux版本,可参考一下方式

  • 确认gitee仓库的最新版本的tar包已经上传到https://archive.spacemit.com/openwrt/dl/,如linux-6.1-v1.0.15.tar.xz

alt text

  • 更改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
* 更新kernel config

```sh
make kernel_menuconfig
  • 编译

可能会出现失败,如果编译异常,请根据报错原因修正

make -j12 V=s

更改下载源为spacemit

spacemit维护一套预编译的安装包,可通过更改源来下载安装

  • 修改软件源地址(基于设备上修改) bl-v2.0.y为具体版本的标签,请根据需求来修改。 如果为sbc方案,需要将DEVICE_MUSE-N1改成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