# 02-快速使用

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

## 符号说明

* `SDK$`：指代源码路径
* `console$`：泛指主板的命令行控制台。[主板命令行控制台](#console_readme)
* `ADB$`：Android Debug Bridge 命令行工具，泛指可运行 ADB 的环境

## 板卡上电

### **供电方式**

主板支持 DC12V 电源接口（5.5\*2.1mm规格）供电，如下图所示：

![K7-DC12V](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/image-20250415192618127.png)

### 状态灯

开发板配备两个 LED 灯：

* 绿色 LED 为电源指示灯
* 蓝色 LED 为心跳指示灯

![K7-LED](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/image-20250416150032731.png)

### **上电步骤**

1. 插上 DC12V 电源圆形输出接口，给板卡上电。
2. 通过两个 LED 灯的状态，初步判断开发板运行状态：
   * 电源指示灯上电即长亮。若不亮，则检查电源部分是否异常。
   * 心跳灯内核启动后持续闪烁。若不闪烁，则系统运行可能异常。

## 显示屏 <a href="#k7-lcd" id="k7-lcd"></a>

主板支持 TYPE-C DP、HDMI OUT、MIPI DSI 三种接口显示画面，可接入对应显示屏显示系统画面。

### MIPI DSI

**注意事项**

在接入 MIPI DSI 屏幕之前，请务必先将主板断电，以免损坏设备。

**适配屏幕**

主板配备一路 MIPI DSI 显示接口，适配以下 MIPI 屏：

| **型号**      | **尺寸**    | **分辨率**  | 触摸支持 |
| ----------- | --------- | -------- | ---- |
| AT101DS40I  | 10.1-inch | 800x1280 | Y    |
| MX101BA1340 | 10.1-inch | 800x1280 | Y    |
| MX080B2140  | 8.0-inch  | 800x1280 | Y    |
| F050008M01  | 5.0-inch  | 720x1280 | Y    |

**硬件接线**

MIPI 屏排线连接时，需确保蓝色面朝上，白色面朝下，然后接入 MIPI DSI 接口。具体接线图如下：

![mipi0\_01](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/mipi0_01.png)

![mipi0\_02](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/mipi0_02.png)

### HDMI OUT

主板配备了一路 HDMI OUT 显示接口，最大输出分辨率可达 4096x2160p120，并且支持热插拔功能。HDMI 接口详情见下图：

![hdmi\_01](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/hdmi_01.png)

### TYPE-C DP

主板配备了一路 TYPE - C 接口，支持 DP 显示功能。TYPE - C 接口详情见下图：

![K7-TYPE C](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/image-20250409110346928.png)

## 用户及密码

### 用户信息

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

| 系统     | 用户名    | 密码     |
| ------ | ------ | ------ |
| 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
```

## 调试串口

### 波特率

调试串口的波特率需设置为 1500000。

### 调试串口线说明

目前提供的调试串口线共有四根线，各线功能如下：

* 红色：VCC（不需要连接）
* 绿色：TX
* 白色：RX
* 黑色：GND

其他调试工具线的连接方式同理，只需连接 TX、RX、GND 即可，且调试工具需支持 1500000 波特率才能正常通信。调试串口线详情见下图：

![USB\_UART](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/USB_UART.png)

### 板卡 DEBUG 引脚

* 引脚标号图：

![image-20250418172813571](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/image-20250418172813571.png)

* 实际 DEBUG 引脚位置图：

![image-20250418173112794](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/image-20250418173112794.png)

### 接线方法

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

| 主板扩展引脚          | 调试线引脚 |
| --------------- | ----- |
| UART\_RX\_DEBUG | TX    |
| UART\_TX\_DEBUG | RX    |
| GND             | GND   |

![image-20250418173402270](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/image-20250418173402270.png)

### **串口助手软件下载与使用**

串口助手软件 可自行下载，下面以Mobaxterm为例

1. **下载地址**：<https://mobaxterm.mobatek.net/>
2. 操作步骤：
   1. 打开 Mobaxterm，点击 “Session” 按钮，新建一个会话窗口。
   2. 在会话类型列表中，选择 “Serial”。
   3. 选择串口 COM 编号，可通过打开 Windows 系统设备管理器 -> 端口界面查看。
   4. 将串口波特率设置为 1500000。
   5. 点击 “OK” 启动会话窗口。

![image-20250418175523261](http://tanzhtanzh.oss-cn-shenzhen.aliyuncs.com/img/image-20250418175523261.png)

## ADB

K7 `Android/Debian/Ubuntu` 系统支持ADB功能使用，详见 [ADB教程](/kickpi-book/common/zh/adb/adb-jiao-cheng.md)。

## SSH

K7 `Debian/Ubuntu` 系统支持SSH功能使用，详见 [SSH](/kickpi-book/common/zh/linux/ssh.md)。

## 常见问题

### **上电供电问题**

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

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

### **MIPI屏幕无法显示问题**

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

**解决方案**：

观察背光未点亮，需要检查接线。[MIPI\_DSI接线](#MIPIDSI)

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

### **调试串口使用异常问题**

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

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

### 什么是主板命令行控制台？ <a href="#console_readme" id="console_readme"></a>

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

命令行控制台举例：

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

```
console$
```

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

```
root@linaro$
```

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

```
kickpi@kickpi$
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tanzhs-private-organization.gitbook.io/kickpi-book/rk3576/zh/02-ru-men-bi-du/02-kuai-su-shi-yong.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
