本文來源電子發燒友社區，作者：xiaopeng， 帖子地址：https://bbs.elecfans.com/jishu_2306109_1_1.html


簡介

NiobeU4是基于ESP32U4WDH推出的物聯網設備開發套件，集成2.4GHz

Wifi和藍牙雙模，具有超高的射頻性能、穩定性、通用性和可靠性，以及超低的功耗，適用于各種應用場景；NiobeU4開發套件還支持NFC非接觸式通訊功能，工作頻率13.56MHz，適用于低功耗、低電壓和低成本要求的非接觸讀寫器應用；NiobeU4開發套件還支持鋰電池供電和充放電管理；開發套件提供一個開箱即用的智能硬件解決方案，方便開發者驗證和開發自己的軟件和功能，縮短產品研發周期并快速推向市場。

Ubuntu22.04安裝

官方推薦的Ubuntu版本是20.04以上，我這里直接在官網下載最新的Ubuntu22.04進行安裝。

安裝過程比較簡單，就不在這里描述了，不清楚可以自己百度。

安裝開發所需的各種工具

這部分跟著官方文檔做基本上沒有什么問題，其中有些地方確實是有坑的，會在下面用粗斜體標注。

所以，如下大部分都來自官方文檔，地址：https://gitee.com/fangye945a/device_board_openvalley/blob/master/niobeu4/README_zh.md

1.安裝依賴工具和庫

• 安裝ccache（用于加速編譯）。

sudo apt install ccache

• 安裝git工具并配置用戶名和郵箱。

sudo apt install git git-lfs
git config --global user.email "xxx"
git config --global user.name "xxx"

• 設置Python軟鏈接為Python3.8。

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1

這個地方要注意，可能Ubuntu20.04默認Python版本為3.8，但是Ubun22.04默認版本為3.10，所以這里的3.8需要改成3.10。

改完應該是：

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1

• 安裝并升級Python包管理工具(pip3)。

sudo apt-get install python3-setuptools python3-pip -y
sudo pip3 install --upgrade pip

• 安裝Python3工具包。

pip3 install --trusted-host mirrors.aliyun.com -i http://mirrors.aliyun.com/pypi/simple jinja2 ohos-build==0.4.6 esptool

• 將hb工具添加至環境變量。

gedit ~/.bashrc  #打開環境配置文件
export PATH=$PATH:~/.local/bin  #添加該語句至文件末尾，保存退出
source ~/.bashrc #使環境配置文件生效

2.安裝repo工具

如果已經安裝并拉取過OpenHarmony代碼，請忽略該步驟。

如果是通過apt install安裝的repo，請卸載后按照下述步驟重新安裝。

sudo apt install curl -y
curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > repo
chmod a+x repo
sudo mv repo /usr/local/bin/

3.安裝交叉編譯工具鏈

新建一個目錄，用來存放下載的編譯工具鏈。

mkdir -p ~/download && cd ~/download

下載交叉編譯工具鏈壓縮包。

wget https://dl.espressif.com/dl/xtensa-esp32-elf-gcc8_4_0-esp-2021r2-linux-amd64.tar.gz

將交叉編譯工具添加至環境變量。

• 解壓工具鏈。

sudo tar axvf xtensa-esp32-elf-gcc8_4_0-esp-2021r2-linux-amd64.tar.gz -C /opt/

• 打開配置文件。

gedit ~/.bashrc

• 在文件末尾添加。

export PATH=$PATH:/opt/xtensa-esp32-elf/bin

• 使配置生效。

source ~/.bashrc

4.獲取源碼

mkdir niobeu4_src && cd niobeu4_src
repo init -u https://gitee.com/fangye945a/niobeu4_trial.git -m devboard_niobeu4.xml
repo sync -c
repo forall -c 'git lfs pull'
repo start master --all

構建源碼

構建項目之前，需要對Python3.10的一個相關的文件手動做修改，不然執行hb set命令會報錯，Python3.8版本沒有此問題。

文件目錄：

~/.local/lib/python3.10/site-packages/prompt_toolkit/styles/from_dict.py

以上更改完成后就可以使用hb set命令選擇項目，使用hb

build -f進行編譯了。

• 進入源碼根目錄，執行hb set命令并選擇openvalley下項目iotlink。

  hb set
  

• 執行hb build -f腳本構建產生固件。

  hb build -f
  

  構建成功會提示類似如下信息。

  [OHOS INFO] iotlink build success
  [OHOS INFO] cost time: 0:00:28
  

我這邊執行完 hb build -f后如下：

命令行下載工具esptool.py安裝

官方提供了在Windows下使用Flash_Download_Tool工具進行下載的方法。

因為我這邊是Linux的實體機，不可能切到Windows去下載。

Linux下需要使用命令行工具esptool.py進行程序下載。

安裝方法：

1.下載esptool.py源碼

git clone https://github.com/espressif/esptool.git

2.目錄導入到環境變量

將export PATH=/home/xinmeng/esp/esptool:$PATH添加到/etc/profile文件結尾

其中xinmeng/esp需要根據自己放的目錄進行調整

執行source /etc/profile立即生效

安裝完成后可以通過esptool.py version查看版本號

安裝完成后，理論上來說就可以進行下載了，但是很遺憾，下載會出現個問題，找不到usb設備。因為默認Ubuntu22.04并沒有預裝CH9102驅動，所以還需要手動安裝該驅動。

CH9102驅動安裝

CH9102和CH343是同一個驅動并且不能使用CH341的驅動，在網上根本找不到CH343的驅動，當然CH9102的驅動更加找不到，包括WCH官網也找不到，即使找到了可能也無法安裝。

這個時候，只有一個辦法，打電話給WCH技術支持，很快就加上了他們工程師的微信，立馬發了一個beta版本的CH343的驅動給我，完美安裝，并且能被Ubuntu正確識別到。

驅動我就直接上傳在這里，需要的可以自取，安裝方法請參考里面的readme文檔。
*附件：ch343ser_linux_withgpio_20220909Beata.zip

使用esptool.py進行下載

現在就可以使用esptool進行下載了，下載之前需要給ttyCH343USB0增加權限，不然會提示沒有權限。

sudo chmod 777 /dev/ttyCH343USB0

下載完成后如圖：

關于esptool.py詳細的使用方法可以參考這篇文章：

https://blog.csdn.net/espressif/article/details/105028809

總結

在此次開發環境搭建的過程中遇到了很多的問題，非常感謝開鴻智谷的技術人員給予非常專業的技術支持。再次感謝。