搭建小熊派BearPi-HM_Micro_Small的纯Ubuntu开发环境

引言

BearPi-HM_Micro_Small的意思是小熊派的“BearPi-HM Micro开发板 + OpenHarmony小型系统”。BearPi-HM Micro是一款使用STM32MP157处理器的鸿蒙开发板，目前提供使用LiteOS-A操作系统内核的OpenHarmony 3.0发行版源码下载。本文介绍如何搭建BearPi-HM_Micro_Small的纯Ubuntu开发环境。

参考文档：

1. https://gitee.com/bearpi/bearpi-hm_micro_small/blob/master/applications/BearPi/BearPi-HM_Micro/docs/device-dev/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA.md
2. https://ost.51cto.com/posts/10283

注：

在执行以下步骤之前，请先按照下面这篇文章搭建鸿蒙设备开发环境：

《搭建鸿蒙设备开发环境：Ubuntu20.04+DevEco Device Tool Release 3.0》 链接

​

一、安装必要的库和工具

sudo apt-get install build-essential gcc g++ make zlib* libffi-dev e2fsprogs pkg-config flex bison perl bc openssl libssl-dev libelf-dev libc6-dev-amd64 binutils binutils-dev libdwarf-dev u-boot-tools mtd-utils gcc-arm-linux-gnueabi cpio device-tree-compiler net-tools openssh-server git vim openjdk-11-jre-headless

​

二、安装mkimage.stm32工具

mkimage.stm32用于生成stm32系列CPU的镜像。

1、下载mkimage.stm32工具，并复制到~/HarmonyTools/stm32目录下。

mkimage.stm32下载地址:

https://pan.baidu.com/s/1T2O8luJ0-8g5ZZYdOvWfqQ 提取码：1234

2、执行以下命令修改mkimage.stm32工具权限：

chmod 777 ~/HarmonyTools/stm32/mkimage.stm32

3、设置环境变量

vim ~/.bashrc

将以下命令拷贝到.bashrc文件的最后一行，保存并退出。

export PATH=~/HarmonyTools/stm32:$PATH

执行如下命令更新环境变量。

source ~/.bashrc

​

三、安装Stm32CubeProgrammer

Stm32CubeProgrammer用于烧写stm32系列CPU的镜像。

1、下载Stm32CubeProgrammer安装包。

下载地址：https://www.st.com/zh/development-tools/stm32cubeprog.html

下载文件：en.stm32cubeprg-lin_v2-10-0_v2.10.0.zip

存放位置：/home/dandelion/HarmonyTools/stm32

2、解压后，双击后缀为.linux的文件安装。

默认安装路径：

/home/dandelion/STMicroelectronics/STM32Cube/STM32CubeProgrammer

3、安装完成后，在Ubuntu桌面上右键单击STM32CubeProgrammer图标，选择Allow Launching。

4、添加规则文件

cd ~/STMicroelectronics/STM32Cube/STM32CubeProgrammer/Drivers/rules
sudo cp 49-stlinkv2-1.rules 49-stlinkv2.rules 49-stlinkv3.rules 50-usb-conf.rules /etc/udev/rules.d

如果没有添加，在Stm32CubeProgrammer中就检测不到USB。

​

四、安装CH340驱动

注意： 在本文的参考文档2中，有第四部分操作，但实践证明，按照本文的操作步骤，这部分操作是不需要的，可以跳过。

1、查看Linux自带的串口驱动、删除原有驱动、查询操作系统的内核版本号。

# 查看Linux自带的驱动
ls /lib/modules/$(uname -r)/kernel/drivers/usb/serial
# 删除原有驱动
cd /lib/modules/$(uname -r)/kernel/drivers/usb/serial
sudo rm -rf ch341.ko
# 查询操作系统的内核版本号
uname -r

2、到下面这个网站寻找对应的驱动代码

https://elixir.bootlin.com/linux/v5.13/source/drivers/usb/serial/ch341.c

3、下载CH340/CH341的USB转串口LINUX驱动程序，然后解压。

下载地址： https://www.wch.cn/download/CH341SER_LINUX_ZIP.html

下载到的文件：CH341SER_LINUX.ZIP

存放位置：/home/dandelion/HarmonyTools/stm32

CH341SER_LINUX.ZIP

4、打开解压得到的文件ch34x.c，用上面这个网站的代码替换掉里面的代码，然后在解压得到的目录下执行以下指令。

# 在当前目录打开命令行
make
sudo make load
# 复制ch34x.ko文件
sudo cp ch34x.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial 

​

五、遇到的问题

用USB线将开发板连接到虚拟机后，按下图操做打开DevEco Device Tool的串口终端时，出现问题：

解决方法：

（1）首先确认鸿蒙项目按下图设置正确。

（2）打开一个Ubuntu终端窗口，执行以下指令：

ls -l /dev/ttyUSB0
groups
sudo usermod -aG dialout dandelion #将用户dandelion加入组dialout
reboot

可以看到，设备ttyUSB0属于组dialout，而当前的用户dandelion却不在组dialout里面，所以没有组dialout对设备ttyUSB0所拥有的读写权限。为了使用户dandelion对设备ttyUSB0有读写权限，需要将用户dandelion加入组dialout，重启系统后就生效了，如下图所示：

​

本文在CSDN、公众号、头条号和知乎同步发布，感谢关注。