# 进阶 - 自定义固件

## 概述

```{note}
本章节介绍如何在 K230 CanMV 上进行开发。如果您没有自定义需求，可跳过此章节。
```

K230 CanMV 是基于 K230 SDK 开发的，运行 Micropython 和 OpenMV 的应用。用户可以通过 Python 语言调用硬件资源，灵活进行开发。

## 开发环境搭建

| 主机环境          | 描述                                |
| ----------------- | ----------------------------------- |
| Ubuntu 20.04.4 LTS (x86_64) | K230 CanMV 的编译环境适用于 Ubuntu 20.04 及以上版本。 |

目前，K230 CanMV 仅在 Linux 环境下验证编译，其他 Linux 版本未经过测试，因此无法保证在其他系统上的兼容性。

### 本地构建环境

- 更新 APT 源（可选）

```shell
sudo bash -c 'cp /etc/apt/sources.list /etc/apt/sources_bak.list && \
  sed -i "s/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g" /etc/apt/sources.list && \
  sed -i "s/security.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g" /etc/apt/sources.list'
```

- 安装必要的依赖软件

```shell
# 添加 i386 架构支持
sudo bash -c 'dpkg --add-architecture i386 && \
  apt-get clean all && \
  apt-get update && \
  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 源（可选）

```shell
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple && \
pip3 config set global.extra-index-url "https://mirrors.aliyun.com/pypi/simple https://mirrors.cloud.tencent.com/pypi/simple"
```

- 安装 Python 依赖

```shell
pip3 install -U pyyaml pycryptodome gmssl jsonschema jinja2
```

- 安装 repo 工具

```shell
mkdir -p ~/.bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
chmod a+rx ~/.bin/repo
echo 'export PATH="${HOME}/.bin:${PATH}"' >> ~/.bashrc
source ~/.bashrc
```

## 编译流程

### 源码下载

CanMV-K230 的源码托管在 Github 上，用户可以通过 repo 工具下载源码。

```shell
# 推荐在用户根目录新建一个目录，再进行代码下载
mkdir -p ~/canmv_k230 && cd ~/canmv_k230

# 下载 RT-Smart + CanMV 工程
repo init -u https://github.com/canmv-k230/manifest -b master --repo-url=https://github.com/canmv-k230/git-repo.git --repo-branch stable

# 从 Gitee 下载代码（推荐国内用户，需配置 SSH 密钥）
# repo init -u git@gitee.com:canmv-k230/manifest.git -b master --repo-url=git@gitee.com:canmv-k230/git-repo.git --repo-branch stable

# 同步代码
repo sync
```

### 代码准备

第一次编译时，需要下载工具链。以下命令仅需执行一次。

```shell
# 第一次执行时下载工具链
make dl_toolchain
```

### 编译

根据实际需求选择对应的板子配置文件，然后开始编译。

```shell
# 列出可用的配置选项
make list-def
# 选择对应的板子配置文件
make xxxx_defconfig
# 开始编译
time make log
```

编译完成后，镜像文件将生成在 `~/canmv_k230/output/xxxx/xxx.img` 目录下。

如果不编译 `CanMV`，需要修改配置仅用改模块

```shell
make menuconfig

# 去掉 CanMV 模块使能
```

![disable canmv](https://kendryte-download.canaan-creative.com/developer/pictures/disable_canmv.jpg)

## 代码目录说明

```sh
canmv_k230
.
├── boards
├── configs
├── include
├── output
├── src
│   ├── applications
│   ├── canmv
│   ├── opensbi
│   ├── rtsmart
│   └── uboot
└── tools
```

目录结构说明：

1. `boards`：板子相关文件
1. `configs`：配置文件列表
1. `include`：自动生成的头文件
1. `output`：编译生成的文件，包括镜像和临时文件
1. `src/applications`：用户应用程序
1. `src/canmv`：CanMV 相关文件
1. `src/opensbi`：OpenSBI 相关文件
1. `src/rtsmart`：RT-Smart 和 MPP 相关文件
1. `src/uboot`：U-Boot 相关文件
1. `scripts`：编译系统相关脚本