02-快速使用

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

符号说明

  • SDK$:代表源码所在的路径。

  • console$:指的是主板的命令行控制台,您可以通过它输入命令来操作开发板。

  • ADB$:即 Android Debug Bridge 命令行工具,您可以在能运行 ADB 的环境中使用它。

板卡上电

开发板各系列默认上电后会自动开机,下面为您介绍不同板子的供电方式以及正常启动的标志。

供电方式

LED指示灯

开发板配备了 2 个 LED 指示灯,能帮助我们了解开发板的状态:

  • 绿色 LED 是电源指示灯,上电后它会一直亮着。如果它不亮,需要检查一下电源部分是不是出问题了。

  • 蓝色 LED 是系统工作心跳灯,上电后它会持续闪烁,这表示内核正在正常运行。要是它不闪烁,可能系统运行异常。

上电步骤

  1. 根据对应板子的供电方式,给开发板接上电源。

  2. 通过观察两个 LED 灯的状态,初步判断开发板的运行情况:

    • 电源指示灯上电后应该一直亮着,如果不亮,检查电源连接是否正常。

    • 心跳灯在内核启动后会持续闪烁,如果不闪烁,系统可能存在异常。

显示屏

不同系列的开发板,显示接口也不一样。您可以根据自己使用的主板,查看对应的显示屏接法。

用户及密码

用户信息

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

系统
用户名
密码

Debian

linaro

linaro

Debian

root

root

Ubuntu

kickpi

kickpi

Ubuntu

root

root

如果 root 密码没有设置,您需要手动修改密码,操作命令如下:

$ sudo passwd 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,接地。

img

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

查看DEBUG引脚

每个型号的主板都有一个 DEBUG 调试串口,它们都在主板的扩展引脚中。

您可以在主板介绍里各型号主板硬件介绍的 “扩展引脚” 部分查看 DEBUG 口的位置,同时,板子的正背面也会用丝印标志出它的位置。

image-20250422094320253

开发板调试串口接线

主板扩展引脚
调试线引脚

UART_RX_DEBUG

TX

UART_TX_DEBUG

RX

GND

GND

也就是说,调试线的 TX 要连接主板上的 RX,RX 连接主板上的 TX,GND 连接主板上的 GND,VCC 不用连接。

串口通信软件使用

下载串口助手软件

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

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

Mobaxterm操作步骤

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

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

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

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

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

image-20250418175523261

ADB

K1 Android/Debian系统,支持ADB功能使用,详见 ADB教程

SSH

K1 支持SSH功能使用,详见 SSH

常见问题

上电供电问题

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

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

MIPI屏幕无法显示问题

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

解决方案

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

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

调试串口使用异常问题

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

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

用户名密码错误问题

使用 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$

Last updated