入门指南

K2B 支持 Android 和 Linux 双系统供电运行，运行 Linux 系统时，与主流树莓派系列产品一致，K2B 可工作于无屏模式（无需连接显示器，通过 SSH 远程访问）。

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

电源
显示屏和显示器连接线
启动介质
键盘和鼠标

Note

如若需将 K2B 用作无屏设备并通过网络进行访问，请参考下文SSH连接。

工具准备

电源

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

Type - C

8d1594b4fb00841f90b54fccdc802b6c

显示器

K2B 支持 HDMI 显示输出。

接口	分辨率最大支持
HDMI	4K@60Hz

ce1d3220b16471ad72ecb729c354ff6a

启动介质

Kickpi K2B 分为 板载 eMMC(embedded Multi Media Card) 和 无板载 eMMC 版本，板载eMMC在出厂时安装了Andorid12操作系统，无需配备启动介质。但在后续使用中（无板载 eMMC 版本必须配备SD卡），您想要更换操作系统或想要从 SD 卡中启动系统，需要准备一张存储容量 ≥ 16GB 的 SD卡。

无板载eMMC

键盘和鼠标

kickpi K2B 具备 2 个USB 2.0 端口，可以使用任意USB端口连接键盘和鼠标。

88274a25bbbf544cd81c497349be134f

按钮

Kickpi K2B 具备 3 个物理按钮：

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

系统启动

用户和密码

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

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

硬件安装

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

Note

FPC 天线表面为裸露金属层，严禁与电路板直接接触。该天线工作时还可能产生电磁干扰，干扰 DDR 信号传输，请将天线远离 DDR、SoC 。

6885754a8e326134d5f3d4ee24ce82fe

LED 状态

未接入显示器状态下，可通过LED灯判断系统运行状态。

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

Success

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

Failure

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

系统桌面

Kickpi K2B 支持Android，Ubuntu操作系统，如果您对操作系统种类无法正确分辨，可参考系统启动后的桌面来判断Kickpi K2B中安装了哪种操作系统。

Android12.0

Tip

K2B支持Android TV 和 Android tablet操作系统，如图所示的是Android TV操作系统。

Ubuntu22.04 xfce

安装操作系统

Kickpi K2B的Android镜像支持SD卡安装和USB安装，Ubuntu镜像目前仅支持SD安装。带有eMMC模块的主板在出厂时默认烧录了Android12系统镜像。

镜像获取

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

├── K2B  //K2B镜像
│   ├── Android12.0_Tablet  //安卓平板系统镜像
│   ├── Android12.0_TV      //安卓TV系统镜像
│   ├── Ubuntu2204_desktop  //ubuntu桌面版系统镜像
│   └── Ubuntu2204_server   //ubunt服务器版系统镜像

Android镜像 SD安装

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

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

工具准备

Note

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

硬件：Windows 系统电脑 / 笔记本、电源适配器、HDMI 显示器（可选配），SD卡、SD卡读卡器。
软件：烧录工具 PhoenixCard，Android镜像。

SD 启动卡

Note

eMMC 和 SD 启动卡同时存在镜像系统时，系统优先从SD卡启动。

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

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

Note

操作过程中，PhoenixCard请求格式化SD卡，确认格式化即可。

3. SD启动卡制作完成。

4. 主板断电，将SD启动卡插入主板 TF 卡槽，重新连接电源，等待显示器正常显示系统桌面。

Success

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

SD 安装卡

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

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

Note

操作过程中，PhoenixCard请求格式化SD卡，确认格式化即可。

3. SD 安装卡制作完成。

4. 主板断电，将SD安装卡插入主板 TF 卡槽，等待镜像安装完成。

Success

显示器中会显示安装进度条，安装完成时显示器熄灭，绿色LED和蓝色LED同时处于熄灭状态，此时拔出SD卡，主板重新上电，等待系统重新启动。

Android镜像 USB安装

通过USB烧录Android镜像，请注意开发板是否存在eMMC，不存在，则通过SD启动卡启动主板。

工具准备

Note

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

硬件：DC 12V 独立电源，USB A - to C烧录线。
软件：烧录工具PhoenixSuit，Android镜像。

安装步骤

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

e3ab4afa45d681e5d29737370a3bd531

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

Tip

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

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

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

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

Note

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

6. 镜像烧录成功，等待系统进入桌面。

Ubuntu镜像 SD安装

ubuntu镜像目前仅支持SD卡烧录。

工具准备

硬件：SD卡（建议存储 ≥ 16GB），SD卡读卡器。
软件：烧录工具 balenaEtcher，Ubuntu镜像。

安装步骤

1. 制作SD启动卡，将SD插入电脑，打开balenaEtcher（建议使用管理员模式打开）烧录Linux镜像。

2. 烧录完成，关闭烧录软件即可。

3. 将烧录完成的SD卡插入开发板，重新上电，开发板会从SD卡中启动Ubuntu系统，连接HDMI显示器，查看桌面是否为Ubuntu系统桌面。

Note

此处的Ubuntu系统是从SD卡启动的，并没有安装进主板eMMC中（嵌入式多媒体卡）。如果只需要从SD卡中启动Ubuntu系统，请跳过后续烧录步骤。

4. Ubtuntu系统从SD启动卡拷贝到eMMC。

主板接入HDMI显示器，键盘鼠标，进入Terminal Mmulator。

在Terminal Mmulator中输入以下命令

sudo nand-sata-install 2 1
//输入密码
kickpi

输入密码后，按下回车，系统自动进入烧录过程，等待烧录完成。

Tip

安装过程中请耐心等待。

烧录完成，选择Power off按下回车，等待系统重启，断电并拔出SD卡，重新上电查看Ubuntu系统是否是否烧录成功。

系统配置

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

账号和密码

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

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

Mobaxterm

通过串口调试工具连接 K2B 设备以获取控制台交互界面，请对照引脚定义图查找 UART 引脚，引脚定义如下图所示。

K2B DEBUG引脚

二维引脚图

实物图

工具准备

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

Note

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

硬件安装

示意图

Mobaxterm 配置

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

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

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

4. 设置Speed(bps) 为115200。

5. 启动会话窗口。

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

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

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

ADB

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

工具准备

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

硬件安装

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

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（安全外壳协议），是一种加密的网络传输协议，核心作用是在不安全的网络环境中，安全地远程登录服务器、执行命令或传输文件。

账号和密码

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

系统	用户名	密码
Debian11	linaro	linaro
Debian11	root	root
Ubuntu20.04	kickpi	kickpi
Ubuntu20.04	root	root
Armbian	kickpi	kickpi

IP获取

DHCP自动分配IP地址无需任何设置，可通过多种方式获取主板IP。

系统内获取：开发板连接显示屏，登录系统使用ifconfig eth0获取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