入门指南

K4B 支持无桌面 Buildroot 和 Ubuntu （通过 SSH 或 UART串口终端进行登录），连接显示器时仅显示LOGO。

要开始使用Kickpi K4B，需要准备以下物品：

电源
显示屏和显示器连接线（非必选）
启动介质

工具准备

电源

供电模式	电压/电流
Type - C	5V / 2A（2A 为基准，建议不低于此值）

Type - C

26a472bbac6509f9c53ad549508a9da6

显示器

K4B 支持 MIPI_LVDS显示输出。

接口	分辨率最大支持
MIPI	1920x1200@60Hz
LVDS	1366 x 768@60fps

MIPI_LVDS

MIPI_LVDS 接口屏幕外设信息如下：

型号	尺寸	分辨率
AT101DS40I	10.1-inch	800x1280
MX101BA1340	10.1-inch	800x1280
MX080B2140	8.0-inch	800x1280
F050008M01	5.0-inch	720x1280

启动介质

Kickpi K4B 分为 板载 eMMC(embedded Multi Media Card) 和 NAND 版本，无需配备启动介质。但在后续使用中，您想要从 SD 卡中启动或安装系统，需要准备一张存储容量 ≥ 16GB 的 SD卡。

NAND

板载 eMMC

按钮

Kickpi K4B 具备 3 个物理按钮：

RST：短按：执行一次设备热复位。
USER：可编程自定义按键。
FEL：用于向板载存储烧录系统镜像的场景。长按此按键并同时上电，系统（SoC）的初始化程序会将设备切换至MASKROM 模式，配合对应烧录工具即可向 eMMC/NAND 烧录镜像。MASKROM 模式的作用是让 SoC 初始化程序判定 eMMC/NAND 为无任何程序烧录的空白状态 —— 即便 eMMC 中未写入 U-boot 引导程序，或 U-boot 已损坏且无法正常工作，均可实现该判定。此模式为设备变砖后，重新对 eMMC/NAND 进行程序烧录提供了可行途径。

系统启动

用户和密码

对于我们发布的所有 Linux 发行版镜像，各发行版对应的默认用户名与密码如下：

系统	用户名	密码
Ubuntu20.04	kickpi	kickpi
Ubuntu20.04	root	root
Buildroot	/	/

硬件安装

在这张安装示意图中，我们为Kickpi K4B 安装了电源，MIPI显示器，鼠标和键盘（如果您只具备电源，请通过LED状态判断系统是否启动成功）。

e6f1da7f8a8fe46935c323a83a1ca35d

LED 状态

K4B搭载的Linux系统为无桌面系统，连接显示器时仅展示主控型号LOGO，请通过LED灯判断系统运行状态。

主板配备两个LED指示灯，绿色LED为电源指示灯，蓝色LED为心跳指示灯。

Success

正常状态：绿色 LED 常亮，蓝色 LED 闪烁。

Failure

设备上电后若绿色 LED 灯熄灭，请检查供电是否正常或设备是否存在短路问题。绿色 LED 灯由直流电源直接供电，无任何外部电路控制。若蓝色 LED 灯熄灭或常亮（无闪烁），说明内核已死机或出现内核崩溃故障；蓝色 LED 灯的闪烁功能由内核驱动程序控制。我们发布的所有操作系统镜像均采用此灯效逻辑，包括 Android、Ubuntu、Debian、Armbian。

安装操作系统

镜像获取

Note

镜像命名说明：update-t113-s3-kickpi-k4b-buildroot-nand-lvds-7-1024-600-2025102313.img
update：指完整镜像包。
t113-s3-kickpi-k4b：主控型号为t113-s3、硬件板型Kickpi-K4b。
buildroot：文件系统为buildroot。
NAND：存储介质为NAND。
lvds-7-1024-600：显示屏7寸lvds 1020*600分辨率。
2025102313.img：镜像输出日期。

从百度网盘中获取Kickpi K4B镜像文件。

├── 2-Image
│   └── K4B
│       ├── EMMC
│       │   ├── Buildroot201902
│       │   └── Ubuntu2004
│       └── NAND
│           ├── Buildroot201902
│           │   ├── update-t113-s3-kickpi-k4b-buildroot-nand-lvds-7-1024-600-2025102313.img
│           └── Ubuntu2004

SD 安装

K4B 配备 1 个 SD 卡槽（兼容微型 SD 卡，又称 TransFlash 或 TF 卡），该卡槽亦可作为可引导启动设备。在 K4B 的启动顺序中，SD 卡拥有更高的优先级，因此设备会优先尝试从 SD 卡启动；当未检测到可挂载的 SD 卡时，再从板载 eMMC / NAND 启动。本文档中均采用 SD 卡表述，TF 卡与 SD 卡在本文中含义一致。

通过工具可制作两种类型的启动卡：SD 启动卡的工作模式类似便携版操作系统（如 Windows PE），主要用于设备的各类维护与故障修复操作，也可用于验证用户的自定义系统配置；第二种为 SD 安装卡，当需要通过 SD 卡向板载 eMMC / NAND 烧录新系统镜像时，需制作该类型启动卡。此卡内置专用脚本，可完成 eMMC / NAND 的分区创建、文件系统格式化及镜像文件拷贝等操作。请务必确认自身使用需求，制作对应的 SD 卡。

工具准备

Note

SD 启动卡：含引导程序与完整系统镜像，支持设备从 TF 卡直接启动，适用于内置存储故障、开发调试等场景。
SD 安装卡：存储固件镜像和安装脚本，用于向设备内置存储（例如 eMMC）写入或升级固件。

硬件：Windows 系统电脑 / 笔记本、电源适配器，SD卡、SD卡读卡器。
软件：烧录工具 PhoenixCard，系统镜像。

SD 启动卡

Note

SD启动卡属于eMMC设备，eMMC / NAND 主板从SD启动卡中启动系统时，需从云盘EMMC文件夹中选择镜像进行烧录。

1. 进入 PhoenixCard 解压文件夹，启动PhoenixCard。

2. 按照图示步骤进行操作，将下载好的镜像安装至SD卡中。

Note

操作过程中，PhoenixCard请求格式化SD卡，确认格式化即可。
显示器需搭配对应镜像使用，如果您为K4B配备了10寸MIPI/LVDS屏,请选择update-t113-s3-kickpi-k4b-***-EMMC-mipi-10-800-1280-v2-202*.img

3. SD启动卡制作完成。

4. 主板断电，将SD启动卡插入主板 TF 卡槽，重新连接电源，K4B为无桌面系统，显示器正常显示LOGO即为启动成功。

Success

绿色LED常亮，蓝色LED持续闪烁（蓝色LED不会立刻亮起，请耐心等待）。

SD 安装卡

Note

EMMC 主板从SD卡中安装系统时，需从云盘 EMMC 文件夹中选择镜像进行烧录。
NAND 主板从SD卡中安装系统时，需从云盘 NAND 文件夹中选择镜像进行烧录。

1. 进入 PhoenixCard 解压文件夹，启动PhoenixCard。

2. 按照图示步骤进行操作，将镜像安装至SD卡中。

Note

操作过程中，PhoenixCard请求格式化SD卡，确认格式化即可。
EMMC 主板从SD卡中安装系统时，需从云盘 EMMC 文件夹中选择镜像进行烧录。
NAND 主板从SD卡中安装系统时，需从云盘 NAND 文件夹中选择镜像进行烧录。

3. SD 安装卡制作完成。

4. 主板断电，将SD安装卡插入主板 TF 卡槽，重新上电，等待安装完成，K4B 为无桌面系统，显示器仅显示LOGO。

Success

显示器中会显示安装进度条，安装完成时绿色LED和蓝色LED常亮，将主板断电，拔出SD卡，主板重新上电，等待系统重新启动。

USB安装

工具准备

Note

K4B EMMC 版本，请从云盘中 EMMC 中挑选镜像进行烧录。
K4B NAND 版本，请从云盘 NAND 中挑选镜像进行烧录。

硬件：USB A - to C烧录线。
软件：烧录工具PhoenixSuit，系统镜像。

安装步骤

1. 通过USB A - to C 烧录线连接电脑，主板进入安装模式，绿色LED常亮。

Note

安装模式：
主板断电状态下，长按主板背部FEL按键不放，插入USB烧录线并连接电脑，烧录工具检测到设备视为进入安装模式，松开FEL按键。
主板通电状态下，插入USB烧录线，长按主板背部FEL按键不放，再短按一下RST按键，烧录工具检测到设备视为进入安装模式，松开FEL按键。

2. 安装驱动，打开电脑设备管理器，按照图示进行操作。

Tip

驱动文件夹路径：PhoenixSuit/Drivers/AW_Driver/

3. 驱动安装完成时，使用管理员模式打开解压文件夹中的PhoenixSuit。

4. 进入烧录软件，点击一键刷机，选择刷入的镜像（不要点击立即升级）。

Note

K4B EMMC 版本，请从云盘 EMMC 中挑选镜像进行烧录。
K4B NAND 版本，请从云盘 NAND 中挑选镜像进行烧录。

5. 开发板重新进入安装模式，软件显示如下画面，点击是进入安装，等待安装成功即可。

Note

安装模式：
主板断电状态下，长按主板背部FEL按键不放，插入USB烧录线并连接电脑，烧录工具检测到设备视为进入安装模式，松开FEL按键。
主板通电状态下，插入USB烧录线，长按主板背部FEL按键不放，再短按一下RST按键，烧录工具检测到设备视为进入安装模式，松开FEL按键。

6. 镜像烧录成功，K4B 为无桌面系统，显示器仅显示LOGO。

Success

绿色LED常亮，蓝色LED持续闪烁（蓝色LED不会立刻亮起，请耐心等待）。

系统配置

在本章节中，你可以使用Mobaxterm进行串口调试，使用ADB进行安卓系统开发调试，使用SSH进行远程连接。

账号和密码

不同系统的默认用户名和密码如下：

系统	用户名	密码
Ubuntu20.04	kickpi	kickpi
Ubuntu20.04	root	root
Buildroot	/	/

Mobaxterm

通过串口调试工具连接 K4B 设备以获取控制台交互界面，请查找 UART 引脚。

K4B DEBUG引脚

实物图

工具准备

软件：Mobaxterm
硬件：串口调试线，又称 USB-TTL 调试线。

Note

红色：VCC（无需连接）；绿色：TX（发送）；白色：RX（接收）；黑色：GND（接地）。若在 MobaXterm 中无法获取串口输出，只需调换绿色与白色接线后重试即可。

硬件安装

示意图

6f1ae0f544b8cbae4ef9948e446602cc

Mobaxterm 配置

1. 点击session新建会话窗口。

2. 选择会话窗口类型为serial。

3. 选择串口COM编号（打开Windows系统设备管理器 -> 端口界面查看COM编号）。

4. 设置Speed(bps) 为115200。

5. 启动会话窗口。

如图所示，点击OK之后，就会进入命令行输入窗口。

主板处于开机状态下连接电脑，Mobaxterm 开机信息输出如下。

连接成功，在命令行界面敲击回车，即可输入命令行，已成功登录主板控制台。

ADB

Buildroot系统支持ADB功能使用，ADB（Android Debug Bridge）是安卓系统开发调试桥接工具，支持通过 USB 或网络连接设备，可实现应用安装、文件传输、命令执行等设备管理与调试操作。

工具准备

硬件：USB Type-C 数据线
软件：ADB_Tool

硬件安装

USB TYPE-C 数据线一端连接主板，另一端连接个人主机。

26a472bbac6509f9c53ad549508a9da6

ADB安装

1.解压压缩包，如解压到 windows D:\ADB\adb-tools 路径。

2.打开cmd窗口，切换到解压目录。

cd D:\ADB\adb-tools

3.运行命令，运行成功代表安装成功。

adb --version

4.启动ADB调试。

.\adb.exe shell

SSH

SSH 的全称是 Secure Shell（安全外壳协议），是一种加密的网络传输协议，核心作用是在不安全的网络环境中，安全地远程登录服务器、执行命令或传输文件。

账号和密码

不同系统的默认用户名和密码如下：

系统	用户名	密码
Ubuntu20.04	kickpi	kickpi
Ubuntu20.04	root	root
Buildroot	/	/

IP获取

串口获取：在串口终端中输入ifconifg eth0获取IP地址（串口连接参考上文Mobaxterm章节）。

SSH连接

在命令行中输入命令进行 SSH 连接：

ssh <username>@<IP>

操作示例：

PS C:\Users\16708> ssh kickpi@192.168.77.186
The authenticity of host '192.168.77.186 (192.168.77.186)' can't be established.
ED25519 key fingerprint is SHA256:635IZrLQdeYlWWl3SCdLxu9fxLEPmStBapj4APCjzZE.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '192.168.77.186' (ED25519) to the list of known hosts.
kickpi@192.168.77.186's password:
Welcome to Ubuntu 24.04.2 LTS (GNU/Linux 6.1.75 aarch64)

 * Documentation:  https://help.ubuntu.com
 * Management:     https://landscape.canonical.com
 * Support:        https://ubuntu.com/pro

This system has been minimized by removing packages and content that are
not required on a system that users do not log into.

To restore this content, you can run the 'unminimize' command.
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

kickpi@kickpi:~$

常见问题

ROOT用户登陆失败？

1. 确认配置是否成功

运行以下命令，若输出结果为 PermitRootLogin yes，则表示配置成功：

console$ cat /etc/ssh/ssh_config | grep PermitRootLogin
PermitRootLogin yes
console$ cat /etc/ssh/sshd_config | grep PermitRootLogin
PermitRootLogin yes

2. root用户登陆配置

修改 SSH 配置文件：

console$ vim /etc/ssh/ssh_config
+ PermitRootLogin yes
console$ vim /etc/ssh/sshd_config
+ PermitRootLogin yes
console$ sudo /etc/init.d/ssh restart