Ctrl+K
dev
Tags
v0.2
v0.3
v0.4
v0.5
v0.6
v0.7
Branches
dev
main
External links
K210 CanMV
K210 CanMV Docs
K230 Docs
K230 CanMV Docs

1.使用说明

1.使用说明#

1. 概述#

K230 CanMV是基于K230开发的一个可运行micropython的应用，用户可通过python语言使用硬件的各种资源。

2. 开发环境搭建#

2.1 支持的硬件#

CanMV-K230: 具体硬件信息参考 《K230_硬件设计指南》

2.2 编译环境#

主机环境

描述

Docker编译环境

提供了dockerfile，可以生成docker镜像，用于编译

Ubuntu 20.04.4 LTS (x86_64)

可以在ubuntu 20.04环境下编译

K230 CanMV需要在linux环境下编译，支持docker环境编译，开发包中发布了docker file（k230_sdk/tools/docker/Dockerfile），可以生成docker镜像。具体dockerfile使用和编译步骤，详见4.3.1章节。

CanMV使用的Docker镜像以ubuntu 20.04为基础，如果不使用docker编译环境，可以在ubuntu 20.04主机环境下参考dockerfile的内容，安装相关HOST package和工具链后，编译CanMV。

K230 CanMV没有在其他Linux版本的主机环境下验证过，不保证可以在其他环境下编译通过。

2.3 Docker环境#

推荐在docker环境中编译K230 CanMV，可直接使用如下docker镜像：

  • 拉取Docker镜像

    docker pull ghcr.io/kendryte/k230_sdk

    可使用如下命令确认docker镜像拉取成功：

    docker images | grep k230_sdk

  • 本地构建Docker镜像

# 生成docker镜像（第一次编译需要，已经生成docker镜像后跳过此步骤，可选）
docker build -f k230_sdk/tools/docker/Dockerfile -t k230_docker k230_sdk/tools/docker

  • 启动docker环境

# 启动docker环境(可选)
docker run -u root -it -v $(pwd):$(pwd) -v $(pwd)/k230_sdk/toolchain:/opt/toolchain -w $(pwd) k230_docker /bin/bash

说明： docker镜像中默认不包含toolchain，下载源码后，使用命令’make prepare_sourcecode’命令会自动下载toolchain至当前编译目录中。

3.1.3 本地构建环境#

  • 更新APT源（可选）

sudo cp /etc/apt/sources.list /etc/apt/sources_bak.list
sudo sed -i 's/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list
sudo sed -i 's/security.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list

  • 安装软件依赖

# 添加386 arch
sudo dpkg --add-architecture i386

sudo apt-get clean all
sudo apt-get update
sudo apt-get install -y --fix-broken --fix-missing --no-install-recommends \
    sudo vim wget curl git git-lfs openssh-client net-tools sed tzdata expect mtd-utils inetutils-ping locales \
    sed make cmake binutils build-essential diffutils gcc g++ bash patch gzip bzip2 perl tar cpio unzip rsync \
    file bc findutils dosfstools mtools bison flex autoconf automake python3 python3-pip python3-dev python-is-python3 \
    lib32z1 scons libncurses5-dev kmod fakeroot pigz tree doxygen gawk pkg-config libyaml-dev libconfuse2 libconfuse-dev \
    libssl-dev libc6-dev-i386 libncurses5:i386

  • 更新PIP源（可选）

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.extra-index-url "https://mirrors.aliyun.com/pypi/simple https://mirrors.cloud.tencent.com/pypi/simple"

  • 安装Python依赖

python3 -m pip install -U pyyaml pycryptodome gmssl

  • 编译genimage

# 需要root权限

wget https://github.com/pengutronix/genimage/releases/download/v16/genimage-16.tar.xz -O /tmp/genimage-16.tar.xz \
    && tar -xf /tmp/genimage-16.tar.xz -C /tmp; cd /tmp/genimage-16 \
    && ./configure \
    && make -j \
    && sudo make install \
    && cd -; rm -rf genimage*

3. 编译流程#

3.1 源码下载#

# 从github下载
git clone https://github.com/kendryte/k230_canmv
# 从gitee下载
git clone https://gitee.com/kendryte/k230_canmv

3.2 代码准备#

cd k230_canmv
make prepare_sourcecode

3.3 编译#

make CONF=k230_canmv_defconfig              # 编译CanMV-1.0/1.1板micropython镜像
make CONF=k230d_canmv_only_rtt_defconfig    # 编译CanMV-K230-Zeor板micropython镜像

编译完成后会在output/k230_xx_defconfig/images目录下生成sysimage-sdcard.img镜像

4. 镜像烧录#

4.1 ubuntu下烧录#

在sd卡插到宿主机之前，输入：

ls -l /dev/sd\*

查看当前的存储设备。

将sd卡插入宿主机后，再次输入：

ls -l /dev/sd\*

查看此时的存储设备，新增加的就是sd卡设备节点。

假设/dev/sdc就是sd卡设备节点，执行如下命令烧录sd卡：

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

说明：sysimage-sdcard.img可以是images目录下的sysimage-sdcard.img文件，或者sysimage-sdcard.img.gz文件解压缩后的文件。

4.2 Windows下烧录#

Windows下可通过rufus工具对TF卡进行烧录（rufus工具下载地址 http://rufus.ie/downloads/）。

1）将TF卡插入PC，然后启动rufus工具，点击工具界面的”选择”按钮，选择待烧写的固件。

rufus-flash-from-file

2）点击“开始”按钮开始烧写，烧写过程有进度条展示，烧写结束后会提示“准备就绪”。

rufus-flash rufus-sure rufus-warning rufus-finish

说明：sysimage-sdcard.img可以是images目录下的sysimage-sdcard.img文件，或者sysimage-sdcard.img.gz文件解压缩后的文件。

5. 上板测试#

5.1 开发板准备#

本章节以CanMV-K230为例

请准备如下硬件：

  • CanMV-K230

  • Typec USB线两根

  • SD卡

  • 网线一根(可选)

  • HDMI转接线一根(可选)

CanMV-K230通过Power接口提供两路调试串口，linux下显示的串口设备为/dev/ttyACMx，windows下显示的串口设备为USB-Enhanced-SERIAL-A/B CH342。

windows驱动下载地址 https://www.wch.cn/downloads/CH343SER_EXE.html。

使用type C分别连接Power和USB接口，板子上电，可以发现三个USB串口设备。

linux串口显示：

linux串口显示

  • /dev/ttyACM0为小核linux调试串口

  • /dev/ttyACM1为大核rt-smart调试串口

  • /dev/ttyACM2为micropython REPL串口，如果没有这个设备，请确定两个USB口都与电脑连接。

windows串口显示：

windows串口显示

  • USB-Enhanced-SERIAL-A CH342（COM25）为小核linux调试串口

  • USB-Enhanced-SERIAL-B CH342（COM24）为大核rt-smart调试串口

  • USB串行设备（COM26）为micropython REPL串口，如果没有这个设备，请确定两个USB口都与电脑连接。

5.2 启动micropython#

  1. 打开大核rt-smart调试串口，打开micropython REPL串口，串口波特率设置115200 8N1

  2. 在大核rt-smart调试串口下输入./sdcard/app/micropython

  3. micropython REPL串口会提示进入REPL

启动过程如下图所示

micropython-start

6. 目录结构#

k230_canmv
├── configs
├── fs_resource
├── images
├── k230_sdk
├── k230_sdk_overlay
├── micropython
├── output
└── scripts

目录介绍:

  1. configs: 各种板级配置

  2. fs_resource: 在编译时拷贝到镜像中的资源文件

  3. k230_sdk: k230_sdk源码

  4. k230_sdk_overlay: 基于k230源码的修改

  5. micropython: micropython的移植

  6. output: 编译产物结果，镜像文件

  7. scripts: 各种辅助脚本

其中k230_sdk, micropython是git submodule, 子项目地址为:

k230_sdk_overlay中的目录结构与k230_sdk相同, 编译时会将k230_sdk_overlay同步到k230_sdk output为编译生成目录

micropython目录大体如下:

micropython
├── micropython
├── overlay
├── port
│   ├── 3d-party
│   ├── Kconfig
│   ├── Makefile
│   ├── ai_cube
│   ├── ai_demo
│   ├── boards
│   ├── builtin_py
│   ├── core
│   ├── include
│   ├── kpu
│   ├── lextab.py
│   ├── machine
│   ├── maix
│   ├── modules
│   ├── mpconfigport.h
│   ├── omv
│   ├── socket_network
│   └── yacctab.py
└── sync.mk

目录介绍:

  1. micropython: micropython源码

  2. overlay: 对micropython源码的一些修改patch

  3. port/boards: 各种板级配置

  4. port/core: micropython core模块

  5. port/machine: machine模块, 包含GPIO, SPI, IIC, UART, PWM, WDT等

  6. port/kpu: k230 kpu模块, 包含KPU, AI2D

  7. port/mpp: k230 mpp模块, 包含VO, VI, AI, AO, MMZ, VPU, DPU等

  8. port/maix: k230 其他模块, 包含IOMUX, PM等

  9. port/omv: openmv模块

  10. port/include: 各模块头文件

目录