K230 debian ubuntu 说明#

1.镜像说明#

镜像请从嘉楠开发者社区 下载,在嘉楠开发者社区网站的k230/images下面可以找到debian和ubuntu相关文件。

1.1). 类似xxxx_debian_sdcard_x.x.img.gz文件是k230 的debian镜像压缩包:

使用的是trixie/sid (debian13)版本,启动时会看到Welcome to Debian GNU/Linux trixie/sid! 打印。

1.2) 类似xxxx_ubuntu_sdcard_x.x.img.gz 文件是k230 ubuntu镜像压缩包:

使用的时Ubuntu 23.10 版本,启动会会看到Welcome to Ubuntu 23.10! 打印;

1.3) debian13.ext4.tar.gz 是k230 debian根文件系统。

1.4). ubuntu23_rootfs.ext4.gz是k230 ubuntu根文件系统

说明1:最开头的标识是板子名称,比如canmv/k230_evb等

说明2:烧录时需要先解压缩文件

说明3:网口不稳定如果找不到网口,重启下板子,

2.k230 debian根文件系统制作及验证#

2.1环境#

我是在ubuntu21.04系统下制作的debian根文件系统(其他系统应该也可以),制作时需要root权限;

wangjianxin@v:~/t$ lsb_release  -a
 No LSB modules are available.
 Distributor ID: Ubuntu
 Description:    Ubuntu 21.04
 Release:        21.04
 Codename:       hirsute

2.2debian rootfs制作#

参考下面命令构建debian 根文件系统;

sudo rm -rf debian13
sudo apt-get update
sudo apt install qemu-user-static binfmt-support debootstrap debian-ports-archive-keyring systemd-container rsync wget
sudo debootstrap --arch=riscv64  unstable debian13 https://mirrors.aliyun.com/debian/
sudo chroot debian13/
echo "root:root" | chpasswd

cat >>/etc/network/interfaces <<EOF
auto lo
iface lo inet loopback
auto eth0
iface eth0 inet dhcp
EOF
apt-get install -y  net-tools ntpdate
ntpdate ntp.ntsc.ac.cn
exit
sudo  mkfs.ext4 -d debian13  -r 1 -N 0 -m 1 -L "rootfs" -O ^64bit debian13.ext4 1G
tar -czvf debian13.ext4.tar.gz debian13.ext4
#debian13.ext4.tar.gz 是debian的ext4格式根文件系统压缩包

2.3镜像制作#

1).下载k230 sdk并进行编译:备注:sdk编译相关问题请参考

git clone git@github.com:kendryte/k230_sdk.git
cd k230_sdk
source tools/get_download_url.sh && make prepare_sourcecode
docker build -f tools/docker/Dockerfile -t k230_docker tools/docker
docker run -u root -it -v $(pwd):$(pwd) -v $(pwd)/toolchain:/opt/toolchain -w $(pwd) k230_docker /bin/bash
make CONF=k230_canmv_only_linux_defconfig
#编译后生成的目标文件是output/k230_canmv_only_linux_defconfig/images/sysimage-sdcard.img

2).把debian13.ext4.tar.gz 解压缩到output/k230_canmv_only_linux_defconfig/images/ 目录下面

tar -xvf debian13.ext4.tar.gz  -C output/k230_canmv_only_linux_defconfig/images/

3).k230_sdk 代码进行如下修改:

#在board/common/gen_image_cfg/genimage-sdcard.cfg 添加如下内容:
 partition debian { 
        image = "debian13.ext4" 
 }
#把board/common/env/default.env里面bootcmd修改为如下
bootcmd=setenv bootargs "root=/dev/mmcblk1p5 loglevel=8 rw rootdelay=4 rootfstype=ext4 console=ttyS0,115200 earlycon=sbi";k230_boot auto auto_boot;

4).修改完后执行如下命令

make build-image

5).烧录到tf卡,并重启设备

把output/k230_canmv_only_linux_defconfig/images/sysimage-sdcard.img 文件烧录到tf卡,把tf卡插入设备并重启设备。烧录方法可以参考

备注:网口不稳定,如果找不到网口,请重启设备试下。

2.3gcc验证#

备注:网口不稳定,如果没有找到网口请重启试下。

主要命令:

dhclient
date -s 20231027
apt-get update
apt-get install gcc
apt-get install ssh
apt-get install parted;parted /dev/mmcblk1 print; parted /dev/mmcblk1 resizepart 3 16G;resize2fs /dev/mmcblk1p3
scp wangjianxin@10.10.1.94:~/t/a.c .
gcc a.c
./a.out 

3. k230 ubuntu23系统制作及验证#

3.1环境#

制作k230 ubuntu23需要ubuntu23的操作系统,我是使用如下dockerfile建的ubuntu系统,

构建命令:docker build -t ubuntu23:v1 . -f Dockerfile23

#构建ubuntu23.04容器;
#docker build -t ubuntu23:v1 . -f ~/tools/docker/Dockerfile23 
#docker run  --privileged  -u root -it  -v $(pwd):$(pwd)    -w $(pwd) ubuntu23:v1  /bin/bash
FROM ubuntu:23.04
# config for default software install
ARG DEBIAN_FRONTEND=noninteractive
# install 32 bit lib for toolchain
RUN dpkg --add-architecture i386
# config ubuntu apt repo to tsinghua
RUN sed -i 's/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list
RUN sed -i 's/security.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list
# install software
RUN apt-get update
RUN apt install -y debootstrap  qemu-user-static binfmt-support dpkg-cross
# set default timezone
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

3.2k230 ubuntu根文件系统制作#

使用下面脚本制作k230 ubuntu23 root文件系统。

docker run  --privileged  -u root -it  -v $(pwd):$(pwd)    -w $(pwd) ubuntu23:v1  /bin/bash

rm -rf ubuntu23_rootfs
debootstrap --arch=riscv64   mantic ubuntu23_rootfs https://mirrors.aliyun.com/ubuntu-ports/
chroot ubuntu23_rootfs /bin/bash

cat >/etc/apt/sources.list <<EOF
deb https://mirrors.aliyun.com/ubuntu-ports mantic main restricted

deb https://mirrors.aliyun.com/ubuntu-ports mantic-updates main restricted

deb https://mirrors.aliyun.com/ubuntu-ports mantic universe
deb https://mirrors.aliyun.com/ubuntu-ports mantic-updates universe

deb https://mirrors.aliyun.com/ubuntu-ports mantic multiverse
deb https://mirrors.aliyun.com/ubuntu-ports mantic-updates multiverse

deb https://mirrors.aliyun.com/ubuntu-ports mantic-backports main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu-ports mantic-security main restricted
deb https://mirrors.aliyun.com/ubuntu-ports mantic-security universe
deb https://mirrors.aliyun.com/ubuntu-ports mantic-security multiverse
EOF
echo "root:root" | chpasswd
echo k230>/etc/hostname
exit 

mkfs.ext4  -d ubuntu23_rootfs  -r 1 -N 0 -m 1 -L "rootfs" -O ^64bit ubuntu23_rootfs.ext4 1G
tar -czvf ubuntu23_rootfs.ext4.tar.gz ubuntu23_rootfs.ext4

3.3镜像制作及验证#

1).下载k230 sdk并进行编译:备注:sdk编译相关问题请参考

git clone git@github.com:kendryte/k230_sdk.git
cd k230_sdk
source tools/get_download_url.sh && make prepare_sourcecode
docker build -f tools/docker/Dockerfile -t k230_docker tools/docker
docker run -u root -it -v $(pwd):$(pwd) -v $(pwd)/toolchain:/opt/toolchain -w $(pwd) k230_docker /bin/bash
make CONF=k230_canmv_only_linux_defconfig
#编译后生成的目标文件是output/k230_canmv_only_linux_defconfig/images/sysimage-sdcard.img

2).把ubuntu23_rootfs.ext4.tar.gz 解压缩到output/k230_evb_only_linux_defconfig/images/ 目录下面

tar -xvf ubuntu23_rootfs.ext4.gz  -C output/k230_canmv_only_linux_defconfig/images/

3).k230_sdk 代码进行如下修改:

#在board/common/gen_image_cfg/genimage-sdcard.cfg 添加如下内容:
 partition debian { 
        image = "ubuntu23_rootfs.ext4" 
 }
#把board/common/env/default.env里面bootcmd修改为如下
bootcmd=setenv bootargs "root=/dev/mmcblk1p5 loglevel=8 rw rootdelay=4 rootfstype=ext4 console=ttyS0,115200 earlycon=sbi";k230_boot auto auto_boot;

4).修改完后执行

make build-image

5).烧录到tf卡,并重启设备

把output/k230_canmv_only_linux_defconfig/images/sysimage-sdcard.img 文件烧录到tf卡,把tf卡插入设备并重启设备。烧录方法可以参考

备注:网口不稳定,如果找不到网口,请重启设备试下。

3.4 gcc 验证#

主要命令:

dhcpcd 
date -s "20240507 15:06"
apt-get update
apt-get install gcc
apt-get install ssh
apt-get install parted;parted /dev/mmcblk1 print; parted /dev/mmcblk1 resizepart 3 16G;resize2fs /dev/mmcblk1p3
scp wangjianxin@10.10.1.94:~/t/a.c .
gcc a.c
./a.out 

4.添加Qt及lxqt支持#

4.1安装Qt, lxqt#

参考debian根文件系统制作ubuntu根文件系统制作步骤

chroot /path/to/rootfs
apt-get install openssh-server
apt-get install libdrm-dev
apt-get install qtbase5-dev qtbase5-examples
apt-get install lxqt
systemctl disable sddm

4.2运行Qt example#

新建QPA输出配置文件,复制以下内容到kms_config.json

{
  "device": "/dev/dri/card0",
  "outputs": [
    { "name": "DSI1", "format": "argb8888" }
  ]
}

新建QPA环境变量文件,复制以下内容到env.sh

export QT_QPA_PLATFORM=linuxfb
export QT_QPA_FB_DRM=1
export QT_QPA_EGLFS_KMS_CONFIG="/root/kms_config.json"

通过以下命令运行Qt example

source env.sh
/usr/lib/riscv64-linux-gnu/qt5/examples/gui/analogclock/analogclock

4.3运行lxqt#

目前lxqt只能通过X11Forwarding在pc或其他平台显示,通过ssh -X连接到板子,然后执行startlxqt

5.参考资料#

https://wiki.debian.org/RISC-V carlosedp/riscv-bringup