crazyflie-开发说明
概述
嵌入式软件开发主要包括编译(build)、调试(debug)和烧录(flash)三个步骤。本文结合crazefie项目,说明开发流程。
准备源码
由于官方仓库中使用了git submodule
,所以在克隆源码时需使用--recursive
标志
1 | git clone --recursive https://github.com/bitcraze/crazyflie-firmware.git |
如果已经克隆了仓库,但是没有添加--recursive
选项,需要手动添加子模块
1 | cd crazyflie-firmware |
具体更新哪些子项目模块可以查看.gitmodules
文件。
注意: - 问题:如果编译时出现如下错误:
make[1]: *** No rule to make target 'libdw1000.o', needed by 'cf2.elf'. Stop. Makefile:350: recipe for target 'build' failed
- 解决办法:上述错误原因是因为缺少libdw1000
文件,输入git submodule deinit
,并删除libdw1000
目录里面的.git
文件,重新拉取该项目源码。
环境搭建
官方提供三种环境搭建方式,分别使用虚拟机镜像Crazyflie VM、Docker镜像toolbelt和本机安装相应的ARM工具链来搭建开发环境。
虚拟机镜像
本文采用 VirtualBox 虚拟机软件,该软件属于自由软件,方便安装。
VirtualBox
- 下载VirtualBox
- 安装软件
下载bitcraze镜像
导入镜像
启动镜像
注意:运行镜像时可能会出现如下问题 错误1:
Implementation of the USB 2.0 controller not found!
安装VirtualBox Extension Pack即可解决 错误2:VT-x is not available
对于Win10电脑如果已经开启了Hyper-V,需将其服务关闭; 1、控制面板 --> 程序和功能 --> 启用或关闭windows功能 2、失效 H-yper-v、Windows 沙盒(Sandbox) 选项,使能 虚拟机平台、Windows虚拟机监控程序平台选项。 3、管理员打开 PowerShell客户端 4、输入bcdedit /set hypervisorlaunchtype off
5、重启电脑
Docker镜像方式
安装Docker
- Docker Hub下载
- 双击安装文件,一直Next。
- 注册Docker账号
下载Docker镜像
- 关于bitcraze/builder镜像
- 打开PowerShell客户端
- 拉取远程镜像
1 | docker pull bitcraze/builder |
下载过程如下所示,由于文件较大可能需要一段时间。
进入交互模式
- 查看镜像是否下载成功
1 | docker images |
- 进入项目目录
1 | cd ./crazyflie-firmware |
- 进入交互式环境
1 | docker run --rm -it -v ${PWD}:/module bitcraze/builder bash |
该命令用法参考Docker 常用命令
本地工具链配置
待补充
编译
命令 | 含义 |
---|---|
all | 快捷编译方式,所有文件都编译 |
compile | 编译生成 cflie.hex文件,但不更新version.c文件 |
build | 更新 version.c 文件并编译生成 cflie.elf/hex文件 |
clean_o | 只清除目标文件,保留执行文件(.elf,.hex) |
clean | 清除所有的编译文件 |
mrproper | 清除每一个编译文件和典型的编辑器备份文件 |
cload | 如果crazyflie-clients-python与项目文件在同级目录并且Crazyradio/Crazyradio PA被插入电脑,该命令将会尝试通过无线bootloader烧写固件 |
flash | 使用 OpenOCD烧录.elf 文件 |
halt | 使用 OpenOCD 暂停目标芯片 |
reset | 使用 OpenOCD 复位目标芯片 |
openocd | 启动 OpenOCD |
调试
关于芯片功能的调试,使用开源工具OpenOCD。
Ubuntu
Versions:
- Ubuntu 18.04.2 LTS (64 bit)
- Eclipse 2019-03 (Eclipse IDE for C/C++ Developers)
安装依赖
- 安装GDB和openocd
1 | sudo apt-get update |
- 安装java运行环境
1 | sudo apt install default-jre |
- 安装eclipse
进入eclipse 下载页下载文件目录,并解压文件
1 | tar -zxvf "your-downloaded-file".tar.gz |
- 开始eclipse安装
1 | "your-unzip-folder"/.eclipse_inst |