02-K8-快速使用

本指南旨在帮助用户快速上手使用主板，包含板卡上电、显示屏连接、调试串口、ADB 、SSH 连接等内容。

符号说明

• SDK$：指代源码路径

• console$：泛指主板的命令行控制台。主板命令行控制台

• ADB$：Android Debug Bridge 命令行工具，泛指可运行 ADB 的环境

板卡上电

目前各系列板卡均为默认上电自动开机，下面介绍各板子供电方式及板子正常启动的标志现象

供电方式

K8主板仅支持12V供电，供电方式为DC12V座子，通过接入12V电源设配器给主板供电。

• 实际接线图

image-20250513145856735

LED指示灯

开发板配备2个LED：

绿色LED为电源指示灯，上电默认长亮

蓝色LED为系统工作心跳灯。若心跳灯持续闪烁，则表示内核正常运行。

另外，系统工作心跳灯可参考以下方面控制LED作为其他功能。

上电步骤

1. 插上 DC12V 电源圆形输出接口，给板卡上电。

2. 通过两个 LED 灯的状态，初步判断开发板运行状态：

   • 电源指示灯上电即长亮。若不亮，则检查电源部分是否异常。

   • 心跳灯内核启动后持续闪烁。若不闪烁，则系统运行可能异常。

显示屏

K8主板拥有的显示接口，可以在K8硬件介绍章节查看接口数量和默认适配显示屏类型，可以根据需要选择性连接显示屏外设。

KICKPI 开发板显示屏接口均搭配对应屏的转接板使用，购买屏会配置接好发货哈

MIPI

K8默认适配KICKPI 售卖的MIPI 5寸、8寸、10.1寸等屏

• 接线方式:

MIPI 0接口: 翻盖式下接FPC接口

image-20250513145744893

MIPI 1接口: 抽拉式上接FPC接口

image-20250513145800459

HDMI OUT

主板配备配备2路HDMI OUT显示接口。接口类型为HDMI-A型，支持热插拔。

image-20250513145931050

HDMI IN

1路HDMI IN显示接口，接口类型为HDMI-A型，支持热插拔。

image-20250513150004888

用户及密码

用户信息

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

系统	用户名	密码
Debian	linaro	linaro
Debian	root
Ubuntu	kickpi	kickpi
Ubuntu	root

root密码是没有设置，需要手动设置

修改用户密码

console$ passwd $username

示例：

root@kickpi:/# passwd kickpi
New password:
Retype new password:
passwd: password updated successfully

调试串口

调试串口为主板上的一路UART口，主要用于开发和调试阶段，帮助开发者了解系统内部的工作情况；调试串口有时也被称为控制台(console)端口或调试终端(debug terminal)。

波特率：1500000

接入座子的USB转UART线也需要支持 1500000 波特率才能正常通信

调试串口线说明

目前提供的调试串口线有四根线，红色的为VCC，绿色的为TX，白色的为RX，黑色的为GND，一般不需要连接VCC。

image-20241231145656021

其他调试工具线同理，只需连接 TX RX GND即可

查看DEBUG引脚

各型号主板都设置有一个DEBUG调试串口，均在20PIN/40PIN引脚中，可以在主板介绍中各型号主板硬件介绍的扩展引脚中查看DEBUG口位置，同时板子上也会有板子正背面用丝印标志出位置所在。

image-20250422094320253

开发板调试串口接线

调试线TX连接主板上的RX，RX连接主板上的TX，GND连接主板上的GND，不需要连接VCC。

主板扩展引脚	调试线引脚
UART_RX_DEBUG	TX
UART_TX_DEBUG	RX
GND	GND

下载串口助手软件

串口助手软件可自行下载，个人习惯为主，无需特定工具，下面以Mobaxterm为例

Mobaxterm软件地址下载：https://mobaxterm.mobatek.net/

Mobaxterm操作步骤

1. 打开 Mobaxterm，点击 “Session” 按钮，新建一个会话窗口。

2. 在会话类型列表中，选择 “Serial”。

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

4. 将串口波特率设置为 1500000。

5. 点击 “OK” 启动会话窗口。

image-20250418175523261

ADB

K8 Android/Debian系统，支持ADB功能使用，详见 ADB教程。

SSH

K8 支持SSH功能使用，详见 SSH。

常见问题

上电供电问题

当主板接入较多外设，导致功耗较高时，接入电源后，上电绿灯可能会较暗或不能保持常亮，系统启动也可能出现异常。

解决方案：这一般是电源供电问题，请检测对应电源的功耗是否足够，能否支持所连接的外设模块供电。

MIPI屏幕无法显示问题

若 MIPI 屏幕无法显示，可检测接线是否正确，背光是否正常点亮。

解决方案：

观察背光未点亮，需要检查接线。MIPI_DSI接线

观察背光已点亮，需要检查软件。（K7 V1.2 还未支持自动识别 MIPI 屏幕，对应屏幕需要烧录不同的软件）

调试串口使用异常问题

使用 Mobaxterm 软件或其他串口工具连接串口时，发现串口乱码，或者只能显示无法写入问题。

解决方案：一般为调试串口工具不支持 1500000 波特率，建议使用支持 1500000 波特率的调试串口工具。

启动卡在logo界面

1. 固件是否是为提供的固件，确保使用网盘提供的固件，技术支持才能帮助排查问题。

2. 重启多次，是否每次都这样

3. 如果是使用的Ubuntu系统有时启动会比较慢，需耐心等待一会，观察是否后续正常进入图形化界面

4. 上述确定完，依旧卡在logo界面，如下排查

5. 确认蓝色系统运行灯是否闪烁

6. 接调试串口，保持所有打印的开机日志，方便提供给技术支持帮助排查问题

系统一直重启

1. 除去所有外设，排除外设干扰

2. 接串口查看日志进行排查

3. 尝试更换电源供电，供电不良好会让板子部分功能异常导致重启

用户名密码错误问题

使用 ssh 登陆时，密码错误。

解决方案：请确认相关账号是否存在，以及密码是否正确。可使用以下命令修改用户密码：

console$ passwd $username

示例：

root@kickpi:/# passwd kickpi
New password:
Retype new password:
passwd: password updated successfully

什么是主板命令行控制台？

命令行控制台，文档中泛指可以通过文本命令与计算机系统交互的操作界面。用户通过输入特定指令来执行操作（如文件管理、程序运行、系统配置等），而非依赖图形化界面（GUI）的鼠标点击和可视化操作。

命令行控制台举例：

Android 系统，可以使用串口或adb shell，使用命令行控制台。

console$

Debian 系统，可以使用串口或者adb shell，ssh等方式，使用命令行控制台。

root@linaro$

Ubuntu 系统，可以使用串口或者adb shell，ssh等方式，使用命令行控制台。

kickpi@kickpi$