# RockBase-K230-Vision

**Repository Path**: Rockbase-iot/Rockbase-K230-Vision

## Basic Information

- **Project Name**: RockBase-K230-Vision
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-06
- **Last Updated**: 2026-11-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RockBase IoT K230-Vision 视觉识别模块

简体中文 | [English](README.md)

**产品型号**：NM-K230-350 ｜ **文档版本**：V1.2 ｜ **更新日期**：2026-11-04

[![K230-Vision](docs/pics/SKU/K230-Vision-deluxe-front.png)](docs/pics/SKU/K230-Vision-deluxe-front.png)

RockBase IoT K230-Vision 是基于嘉楠科技 K230 平台的开源智能视觉开发板／终端，集触摸显示、图像采集、边缘 AI 计算、音频输入输出和外设扩展于一体。

模块以 K230 双核 RISC-V 处理器为核心，搭配第三代 KPU 提供 6 TOPS 本地 AI 算力，可在设备端完成智能视觉推理，无需把图像上传到云端。板载 3.5 英寸触控屏、GC2093 摄像头、DMIC 与功放喇叭，并提供 40-pin GPIO、USB HOST、3 组 UART／I²C 等扩展接口，既可作为独立 AI 视觉终端使用，也可作为视觉前端接入外部主控。

产品提供**基础开发套件**和**整机开发套件**两种形态，采用相同的核心平台，外观结构、随附部件及适用方式不同。适用于机器视觉、图像识别、AI 算法演示、嵌入式开发、教学实验和原型验证等场景。

> **说明**：整机外壳目前为 3D 打印结构，适合原型验证和功能演示；不具备防水、防尘或工业级抗冲击能力。

## 目录

- [关键参数速览](#关键参数速览)
- [1 产品概述](#1-产品概述)
- [2 套件版本与包装内容](#2-套件版本与包装内容)
- [3 产品特点](#3-产品特点)
- [4 技术规格](#4-技术规格)
- [5 接口与扩展说明](#5-接口与扩展说明)
- [6 按键与电源控制](#6-按键与电源控制)
- [7 快速开始](#7-快速开始)
- [8 RockBase 系统与 AI 应用](#8-rockbase-系统与-ai-应用)
- [9 电源、充电与选配电池](#9-电源充电与选配电池)
- [10 故障排除](#10-故障排除)
- [11 安全与维护](#11-安全与维护)
- [12 开发资源](#12-开发资源)
- [仓库结构](#仓库结构)
- [参与贡献](#参与贡献)
- [许可证](#许可证)

## 关键参数速览

| 项目 | 参数 |
| --- | --- |
| 产品名称 | K230-Vision |
| 产品型号 | NM-K230-350 |
| 处理平台 | K230，双 RISC-V 处理器核心（大核最高 1.6 GHz／小核最高 0.8 GHz） |
| AI 算力 | KPU 6 TOPS |
| 内存 | 1 GB LPDDR4 RAM |
| 显示 | 3.5 英寸 MIPI 彩色电容多点触摸屏，480 × 800 |
| 摄像头 | GC2093，200 万像素，对角 73° |
| 无线 | Realtek RTL8189FTV Wi-Fi |
| 供电 | USB Type-C 5 V／DC 8～24 V／选配 4.2 V 800 mAh 电池 |
| 外壳 | 3D 打印原型外壳（整机开发套件） |

## 1 产品概述

K230-Vision 面向需要低延迟、隐私保护和自主运行的端侧 AI 场景。触摸屏用于菜单操作、摄像头预览和识别结果显示；被动散热片保证持续视觉处理的稳定性；板级扩展接口便于连接外部传感器与主控。

### 1.1 系统主界面

[![系统主界面](docs/pics/SKU/K230-Vision-software-home.png)](docs/pics/SKU/K230-Vision-software-home.png)

## 2 套件版本与包装内容

| 套件 | 标准组成 | 选配／说明 |
| --- | --- | --- |
| 整机开发套件 | 整机外壳、3.5 英寸显示屏、摄像头、按键开关、喇叭 | 推荐电池：802540，4.2 V，800 mAh |
| 基础开发套件 | 3.5 英寸显示屏、K230 开发板、摄像头安装背板 | 背板用于安装摄像头并为板卡提供基本结构保护 |

| 整机开发套件 | 基础开发套件 |
| :---: | :---: |
| [![整机开发套件](docs/pics/SKU/K230-Vision-deluxe.png)](docs/pics/SKU/K230-Vision-deluxe.png) | [![基础开发套件](docs/pics/SKU/K230-Vision-standard.png)](docs/pics/SKU/K230-Vision-standard.png) |
| 整机开发套件（含 3D 打印外壳） | 基础开发套件（开发板 + 背板） |

**开箱检查**：包装内容可能因销售组合而异。请依据订单核对主机／开发板、显示屏、摄像头、背板、喇叭及配件；电池为选配时，包装内不包含电池。

## 3 产品特点

- **K230 双 RISC-V 处理器核心**：CPU 1（大核）最高 1.6 GHz，CPU 0（小核）最高 0.8 GHz。
- **KPU 提供 6 TOPS AI 算力**，支持本地智能视觉推理。
- 标配 **1 GB LPDDR4 RAM**，具体容量以购买配置和系统识别结果为准。
- 搭载 **RockBase IoT 完全开源嵌入式 GUI 系统**，集成 20 余种 AI 视觉应用。
- **3.5 英寸 480 × 800 MIPI 彩色电容多点触摸屏**，支持五点触摸。
- **GC2093 200 万像素摄像头**；开发板支持 3 路 MIPI 摄像头连接。
- 集成 **RTL8189FTV Wi-Fi 芯片、DMIC、功放和内置喇叭**。
- 提供 **USB Type-C、USB HOST Type-A、40-pin GPIO 及 3 组 UART／I²C** 扩展接口。
- 配置**被动散热片**，适合持续视觉处理和边缘 AI 实验。

## 4 技术规格

| 项目 | 规格 |
| --- | --- |
| 产品名称 | K230-Vision |
| 产品型号 | NM-K230-350 |
| 处理平台 | K230；双 RISC-V 处理器核心 |
| CPU | CPU 1（大核）最高 1.6 GHz；CPU 0（小核）最高 0.8 GHz |
| KPU | 6 TOPS |
| 内存 | 1 GB LPDDR4 RAM |
| Wi-Fi | Realtek RTL8189FTV |
| 显示屏 | 3.5 英寸 MIPI 彩色电容多点触摸屏 |
| 分辨率 | 480 × 800 |
| 触摸 | 电容多点触摸（五点） |
| 摄像头 | GC2093，200 万像素 |
| 视场角 | 对角 73°；水平 65°；垂直 40° |
| 摄像头扩展 | 支持 3 路 MIPI 摄像头连接 |
| 音频 | DMIC、功放、内置喇叭 |
| 板级扩展 | 40-pin GPIO；3 组 UART／I²C |
| USB | USB Type-C；USB HOST Type-A |
| USB 供电／充电 | 5 V；USB 充电 |
| DC 输入 | 8～24 V DC |
| 电池（选配） | 推荐型号：802540，4.2 V，800 mAh |
| 充电电流 | 约 750 mA |
| 外壳 | 3D 打印原型外壳（整机开发套件） |

> **未指定项**：系统／固件版本、板载存储容量、GPIO 绝对最大额定值等会随硬件或软件版本变化，本文档不作推定。

## 5 接口与扩展说明

| 接口 | 用途 | 使用要点 |
| --- | --- | --- |
| USB Type-C | 5 V 供电、USB 充电及版本相关功能 | 使用合规电源与线缆；不要接入超规格电压 |
| USB HOST Type-A | 连接系统支持的 USB 外设 | 高功耗外设应独立供电或使用带电源集线器 |
| 40-pin GPIO | 数字 IO、电源和外设扩展 | 断电接线；确认 3.3 V 逻辑、方向和共地 |
| 3 组 UART／I²C | 内部或外部串行扩展 | 核对电平、地址、波特率、引脚复用和插头方向 |
| MIPI 摄像头 | 最多 3 路摄像头连接 | 断电插拔；确认排线方向、接口和软件通道 |
| microSD | 系统镜像或数据存储 | 完成软件关机后插拔，避免读写时强制拔卡 |
| DC 输入 | 8～24 V 外部供电 | 核对电压与极性；禁止反接 |

> **警告**：不要将 5 V 直接接入 3.3 V IO。禁止带电插拔板级排线、短接引脚或将 5V、3V3、GND 混接。

### 5.1 整机正面与背面

| 整机开发套件｜正面 | 整机开发套件｜背面 |
| :---: | :---: |
| [![整机正面](docs/pics/SKU/K230-Vision-deluxe-front.png)](docs/pics/SKU/K230-Vision-deluxe-front.png) | [![整机背面](docs/pics/SKU/K230-Vision-deluxe-rear.png)](docs/pics/SKU/K230-Vision-deluxe-rear.png) |

正面触摸屏用于菜单操作、摄像头预览和 AI 识别结果显示。背面布置摄像头、被动散热片、喇叭开孔、40-pin GPIO 和 USB HOST 等区域，使用时应保持镜头、散热片和喇叭开孔无遮挡。

| 基础开发套件｜正面 | 基础开发套件｜背面 |
| :---: | :---: |
| [![基础套件正面](docs/pics/SKU/K230-Vision-standard-front.png)](docs/pics/SKU/K230-Vision-standard-front.png) | [![基础套件背面](docs/pics/SKU/K230-Vision-standard-rear.png)](docs/pics/SKU/K230-Vision-standard-rear.png) |

基础开发套件由显示屏、开发板和摄像头安装背板构成。支撑柱连接各层结构，背板保护主要器件并提供摄像头安装位置。

### 5.2 主板功能框图

| 主板正面 | 主板背面 |
| :---: | :---: |
| [![主板正面功能框图](docs/pics/K230-vision-front-block-diagram-cn.png)](docs/pics/K230-vision-front-block-diagram-cn.png) | [![主板背面功能框图](docs/pics/K230-vision-back-block-diagram-cn.png)](docs/pics/K230-vision-back-block-diagram-cn.png) |

功能框图用于识别主要器件和接口位置。连接 GPIO、UART、I²C、MIPI 或内部电源前，应同时核对所购硬件版本的板卡丝印、原理图及软件配置。

> **注意**：排线、MIPI 连接器和板级接口仅可在完全断电后操作。

### 5.3 扩展 IO 引脚定义

整机的扩展 IO 位于机身背面，包括 40-pin GPIO 排针、3 组 UART 接口（UART0／UART2／UART3，其中两组复用 I²C2）以及 BOOT／USER 按键。

#### 40-pin GPIO 排针

[![40-pin GPIO 引脚定义](docs/pics/K230_GPIO.png)](docs/pics/K230_GPIO.png)

| 排 | 引脚顺序（从左到右） |
| --- | --- |
| 上排 | 5V、5V、GND、IO3、IO4、IO47、GND、IO18、IO19、GND、IO27、IO14、IO61、IO40、GND、IO46、GND、IO35、IO34、IO33 |
| 下排 | 3V3、IO49、IO48、IO2、GND、IO5、IO6、IO26、3V3、IO16、IO17、IO15、GND、IO41、IO36、IO37、IO52、IO42、IO32、GND |

排针提供 2 路 5V、2 路 3V3、8 路 GND 和 28 个 GPIO。所有 GPIO 均为 3.3 V 电平。使用前请根据固件的软件配置确认引脚复用关系（GPIO、PWM、I²S 等）。

#### UART／I²C 接口与按键

[![UART 接口与按键](docs/pics/K230_UART_KEYS.png)](docs/pics/K230_UART_KEYS.png)

| 接口 | 引脚 1 | 引脚 2 | 引脚 3 | 引脚 4 | 附加引脚 |
| --- | --- | --- | --- | --- | --- |
| UART0 | 5V | RXD0（IO39） | TXD0（IO38） | GND | — |
| UART2 | 5V | RXD2（IO12） | TXD2（IO11） | GND | SDA2／SCL2（I²C2） |
| UART3 | 5V | RXD3（IO51） | TXD3（IO50） | GND | SDA2／SCL2（I²C2） |

- 每组 UART 接口均带 5 V 输出，可为小型外部模块供电；串口信号为 3.3 V 电平。
- UART2、UART3 接口同时引出 I²C2 总线（SDA2／SCL2），用于连接传感器等 I²C 外设。
- 侧面按键分别对应 BOOT／BACK（IO0）和 USER／OK（IO53），详见 [6 按键与电源控制](#6-按键与电源控制)。

> **警告**：GPIO 排针和 UART 接口上的 5V 引脚仅作电源输出。禁止向这些引脚输入外部 5 V 电源，也禁止将 5 V 直接接入 3.3 V IO 引脚。

## 6 按键与电源控制

| 硬件控制 | 信号／复用 | 功能 |
| --- | --- | --- |
| 按键 1 | BOOT／IO0／BACK | 启动模式选择、返回或用户输入；由启动阶段和应用定义 |
| 按键 2 | USER／OK／IO53 | 确认或用户输入；由应用定义 |
| 按键 3 | RESET | 复位并重新启动设备；整机上位于侧面 |
| 拨动开关 | 电池接入／断开 | 控制选配电池与系统电源路径的连接 |

机身侧面的长条开孔用于 microSD 卡插拔。USB 5 V、8～24 V DC 和电池属于不同供电路径，连接前必须确认接口标识和电源规格。

## 7 快速开始

### 7.1 使用前检查

1. 检查屏幕、摄像头、外壳／背板、排线和接口是否松动、变形或损坏。
2. 确认电池拨动开关位于 OFF；外部电源尚未连接。
3. 若系统镜像由 microSD 卡提供，按照当前固件资料准备并正确插入存储卡。
4. 将设备放在稳定、干燥、绝缘的表面，并保持散热片和通风区域无遮挡。

### 7.2 开机与基本操作

1. 选择一种供电方式：USB 5 V、8～24 V DC，或已安装的 4.2 V 选配电池。
2. 先连接设备端，再连接电源端；使用电池时，将拨动开关切换至 ON。
3. 等待系统启动。启动时间和界面由所安装的系统及固件版本决定。
4. 使用触摸屏或 USER／OK、BACK 等按键进入所需功能。

### 7.3 关机与断电

1. 如系统提供关机菜单或命令，先执行软件关机并等待存储访问停止。
2. 将电池开关切换至 OFF，再断开 USB 或 DC 外部电源。
3. 设备完全断电后，方可拔出 microSD、USB 外设或板级扩展模块。

## 8 RockBase 系统与 AI 应用

[![Vision 与 Face 应用菜单切换](docs/pics/vision-gui/swipe.gif)](docs/pics/vision-gui/swipe.gif)

RockBase IoT 完全开源嵌入式 GUI 系统集成 20 余种 AI 视觉应用，包括物体检测、物体分类、人脸关键点、人体检测、姿态识别、手势识别和车牌识别等。实际应用列表、菜单位置及模型版本以设备当前系统镜像为准。

| Vision 分类 | Face 分类 |
| :---: | :---: |
| [![Vision 菜单](docs/pics/vision-gui/K230-Vision-software-vision.png)](docs/pics/vision-gui/K230-Vision-software-vision.png) | [![Face 菜单](docs/pics/vision-gui/K230-Vision-software-face.png)](docs/pics/vision-gui/K230-Vision-software-face.png) |

### 8.1 视觉识别效果示例

| 物体检测 | 人脸关键点 | 手势识别 |
| :---: | :---: | :---: |
| [![物体检测](docs/pics/vision-gui/app-detect.jpg)](docs/pics/vision-gui/app-detect.jpg) | [![人脸关键点](docs/pics/vision-gui/app-face-points.jpg)](docs/pics/vision-gui/app-face-points.jpg) | [![手势识别](docs/pics/vision-gui/app-gesture-yeah.jpg)](docs/pics/vision-gui/app-gesture-yeah.jpg) |
| 物体检测 | 人脸关键点 | 手势识别 |

| 人体姿态识别 | 车牌识别 |
| :---: | :---: |
| [![人体姿态识别](docs/pics/vision-gui/app-pose.jpg)](docs/pics/vision-gui/app-pose.jpg) | [![车牌识别](docs/pics/vision-gui/app-plate.jpg)](docs/pics/vision-gui/app-plate.jpg) |
| 人体姿态识别 | 车牌识别 |

### 8.2 使用建议

- 保持镜头清洁，避免强逆光、目标过远、剧烈运动和遮挡。
- 进入应用后等待模型加载完成，再评估实时画面和识别结果。
- 开发自定义应用时，应核对摄像头通道、图像尺寸、像素格式和模型输入要求。
- 采集或处理人脸、车牌、语音和视频数据时，应遵守当地法律并取得必要授权。

## 9 电源、充电与选配电池

| 方式 | 额定参数 | 说明 |
| --- | --- | --- |
| USB Type-C | 5 V | USB 供电及充电；使用稳定、合规的电源与线缆 |
| DC 输入 | 8～24 V DC | 连接前确认电压与极性；禁止反接 |
| 选配电池 | 802540，4.2 V，800 mAh | 通过拨动开关接入／断开；无电池版本不适用 |
| 充电电流 | 约 750 mA | 充电时保持通风，留意异常发热、异味或变形 |

**电池运输**：因锂电池运输限制，整机开发套件默认不带电池，推荐电池型号为 802540，4.2 V，800 mAh 锂离子电池。仅使用与设备规格和接口匹配、带保护电路的合格电池。

> **警告**：禁止短路、挤压、刺穿、拆解、焚烧电池，禁止使用鼓包、破损或漏液电池。发现异常发热、异味、冒烟或变形时，应立即断开电源并停止使用。

续航与充电时间受屏幕亮度、AI 负载、Wi-Fi、USB 外设、环境温度和电池状态影响。800 mAh 为标称容量，不构成续航承诺。

## 10 故障排除

| 现象 | 可能原因 | 处理方法 |
| --- | --- | --- |
| 无法开机 | 电池开关 OFF；电源不合规；电池未安装或电量不足 | 断电后核对开关、线缆和电源；使用已知正常的 5 V USB 电源测试 |
| 屏幕无显示 | 系统未启动；microSD 异常；屏幕排线松动 | 断电检查存储卡；具备装配经验时再检查排线 |
| 触摸无响应 | 屏幕有水渍；系统负载过高 | 清洁并擦干屏幕；等待任务完成或按 RESET |
| 摄像头无画面 | 通道选择错误；排线松动；镜头被遮挡 | 退出应用并断电检查；重新选择正确摄像头通道 |
| Wi-Fi 无法连接 | 信号弱；凭据错误；系统驱动或网络设置异常 | 靠近接入点，核对网络参数并检查当前系统配置 |
| USB 外设不识别 | 驱动不支持；供电不足；线缆异常 | 更换已知正常设备和线缆；使用带电源集线器 |
| GPIO 外设异常 | 接线方向、共地、电平或复用不匹配 | 断电后按丝印逐线核对，并检查软件引脚配置 |
| 充电异常 | 电源能力不足；线缆压降；电池或充电路径异常 | 停止使用并更换合规电源和线缆；仍异常时联系供应商 |

> **警告**：不得为了排查故障而带电拆机、短接引脚或绕过电池保护。

## 11 安全与维护

- 仅在干燥、清洁、通风且无导电异物的环境中使用。
- 避免跌落、挤压、液体、金属碎屑、强静电和阳光长时间直射。
- 操作板级接口前采取防静电措施，并确保设备完全断电。
- 使用柔软干布清洁屏幕和外壳；镜头使用专用镜头布。不要直接喷洒清洁剂。
- 不要遮挡散热片、摄像头或喇叭开孔。儿童使用时应由成年人或教师监督。
- 设备不用于生命支持、安全关键控制或其他故障可能导致人身伤害的场景。

## 12 开发资源

| 资源 | 地址 |
| --- | --- |
| RockBase-K230-Vision | <https://gitee.com/RockBase-iot/RockBase-K230-Vision> |
| RockBase-K230-Vision-GUI | <https://gitee.com/RockBase-iot/RockBase-K230-Vision-GUI> |
| K230 RTOS SDK（GitHub） | <https://github.com/kendryte/k230_rtos_sdk> |

系统界面、应用列表和按键行为可能随固件变化。升级前请备份数据、使用匹配硬件版本的固件，并在升级过程中保持稳定供电。

K230 平台另提供 Linux SDK 与 CanMV 固件，用于底层开发与自定义系统构建：

- [K230 SDK](https://github.com/kendryte/k230_sdk)
- [K230 CanMV](https://github.com/kendryte/k230_canmv/)
- [K230 官方文档](https://github.com/kendryte/k230_docs)

### K230 SDK 编译

K230 SDK 需要在 Linux 环境下编译，推荐使用 Ubuntu 22.04（Windows 用户可使用 WSL2 + Docker）。

```shell
# 下载源码
git clone https://github.com/kendryte/k230_sdk
cd k230_sdk
make prepare_sourcecode

# 拉取 Docker 镜像
docker pull ghcr.io/kendryte/k230_sdk

# 进入 Docker 环境
docker run -u root -it -v $(pwd):$(pwd) -v $(pwd)/toolchain:/opt/toolchain -w $(pwd) ghcr.io/kendryte/k230_sdk /bin/bash

# 编译（以 EVB 板为例）
make CONF=k230_evb_defconfig
```

编译产物位于 `k230_evb_defconfig/images/`：

```shell
k230_evb_defconfig/images/
├── sysimage-sdcard.img       # SD 卡/eMMC 非安全启动镜像
├── sysimage-sdcard.img.gz    # 压缩版本
├── sysimage-spinor32m.img    # NOR Flash 镜像
└── ...
```

### 烧录镜像

```shell
sudo dd if=sysimage-sdcard.img of=/dev/sdx bs=1M oflag=sync
```

## 仓库结构

```
.
├── README.md              # 英文版产品说明
├── README_zh.md           # 简体中文版产品说明
└── docs/
    └── pics/              # 产品图与界面截图
```

## 参与贡献

欢迎通过 Issue 或 Pull Request 补充资料、修正错误。若修改中英文 README，请尽量保持两侧内容同步，并确保硬件参数与产品说明一致。

## 许可证

仓库的发布与授权条款确定后，将在此补充许可证信息。