跳转至

入门指南

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

要开始使用Kickpi K2C,需要准备以下物品:

  • 电源

  • 显示屏和显示器连接线

  • 启动介质

  • 键盘和鼠标

Note

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

工具准备

电源

供电模式 电压/电流
DC 12 / 1.5A(1.5A 为基准,建议不低于此值)

bf001e285f48a1a0d135c698352da8b3

显示器

K2C 支持 HDMI 显示输出。

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

9841cc6a36418281ecb6caabecb926d7

启动介质

Kickpi K2C 板载eMMC并在出厂时安装了Andorid12操作系统,无需配备启动介质。但在后续使用中,您想要更换操作系统或想要从 SD 卡中启动系统,需要准备一张存储容量 ≥ 16GB 的 SD卡。

image-20260128141145029

键盘和鼠标

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

0c62e7cb7e9feee29b3a33b55005fab7

按钮

Kickpi K2C 具备 3 个物理按钮:

  • RST:短按:执行一次设备热复位

  • USER:Ubuntu桌面版系统按下USER按键是打开login out界面,ubuntu服务器版系统按下USER按键是直接关机;Android系统按下为息屏。

  • FEL:用于向板载 eMMC 烧录系统镜像的场景。长按此按键并同时上电,系统(SoC)的初始化程序会将设备切换至 MASKROM 模式,配合对应烧录工具即可向 eMMC 烧录镜像。MASKROM 模式的作用是让 SoC 初始化程序判定 eMMC 为无任何程序烧录的空白状态 —— 即便 eMMC 中未写入 U-boot 引导程序,或 U-boot 已损坏且无法正常工作,均可实现该判定。此模式为设备变砖后,重新对 eMMC 进行程序烧录提供了可行途径。

image-20260128140704962

image-20260128140819205

系统启动

用户和密码

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

系统 用户名 密码
Ubuntu2204 kickpi kickpi
Ubuntu2204 root root

硬件安装

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

Note

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

f98862cefc45293d98c6a454ac84a9f3

LED 状态

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

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

Success

正常状态:绿色 LED 常亮,蓝色 LED 闪烁。

Failure

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

系统桌面

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

Android12.0

Tip

K2C支持Android TV 和 Android Tablet操作系统,如图所示的是Android TV操作系统。

Ubuntu22.04 xfce

安装操作系统

Kickpi K2C的Android镜像支持SD卡安装和USB安装,Ubuntu镜像目前仅支持SD安装。带有eMMC模块的主板在出厂时默认烧录了系统镜像,如果不需要烧录镜像,请跳过本章节。

镜像获取

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

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

Android镜像 SD安装

K2C 配备 1 个 SD 卡槽(兼容微型 SD 卡,又称 TransFlash 或 TF 卡),该卡槽亦可作为可引导启动设备。在 K2C 的启动顺序中,SD 卡拥有更高的优先级,因此设备会优先尝试从 SD 卡启动;当未检测到可挂载的 SD 卡时,再从板载 eMMC 启动。因芯片原厂官方工具统一使用术语 SD(微型 SD 卡)而非 TF 卡,故本文档中均采用 SD 卡表述,TF 卡与 SD 卡在本文中含义一致

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

工具准备

Note

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

  • 硬件:Windows 系统电脑 / 笔记本、电源适配器、HDMI 显示器(可选配),SD卡、SD卡读卡器。
  • 软件:烧录工具 PhoenixCardAndroid 镜像。

SD 启动卡

Note

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

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

image-20260127110048175

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

Note

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

image-20260127111634656

3. SD启动卡制作完成。

image-20260127112037981

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

Success

绿色LED常亮,蓝色LED持续闪烁(蓝色LED不会立刻亮起,请耐心等待)。

SD 安装卡

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

image-20260127110048175

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

Note

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

image-20260127135007436

3. SD 安装卡制作完成。

image-20260127135620835

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

Success

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

Android镜像 USB安装

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

工具准备

  • 硬件:DC 12V 独立电源,USB A - to C烧录线 。
  • 软件:烧录工具PhoenixSuitAndroid镜像。

安装步骤

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

Note

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

e76d3460f5686280271cad138e952a43

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卡读卡器。
  • 软件:烧录工具 balenaEtcherUbuntu镜像。

安装步骤

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进行远程连接。

账号和密码

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

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

Mobaxterm

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

K2C DEBUG引脚

  • 二维引脚图

K2C DEBUG引脚

  • 实物图

工具准备

  • 软件:Mobaxterm
  • 硬件:串口调试线,,又称 USB-TTL 调试线。

Note

红色:VCC(无需连接);绿色:TX(发送);白色:RX(接收);黑色:GND(接地)。若在 MobaXterm 中无法获取串口输出,只需调换绿色与白色接线后重试即可。

image-20251110111232659

硬件安装

  • 示意图

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 数据线一端连接主板,另一端连接个人主机。

948775af3dbb50ccf9a1d68beae91c7f

ADB安装

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

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

cd D:\ADB\adb-tools

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

adb --version

image-20251030103509920

4.启动ADB调试。

.\adb.exe shell

image-20251030103154909

SSH

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

账号和密码

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

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

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