# 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教程](https://tanzhs-private-organization.gitbook.io/kickpi-book/common/zh/adb/adb-jiao-cheng)。

## SSH

K7 `Debian/Ubuntu` 系统支持SSH功能使用，详见 [SSH](https://tanzhs-private-organization.gitbook.io/kickpi-book/common/zh/linux/ssh)。

## 常见问题

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

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

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

### **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$
```
