Browse Source

feat(chapt13): 完成安装第三方库教程

鱼香ROS 2 years ago
parent
commit
99f32a3d6a

+ 1 - 1
docs/_sidebar.md

@@ -246,7 +246,7 @@
       - [3.使用按键学会GPIO输入](humble/chapt13/basic/3.学会使用按键GPIO输入.md)
       - [4.电池电压测量-学会使用ADC](humble/chapt13/basic/4.电池电压测量-学会使用ADC.md)
     - 进阶篇-学会使用第三方库
-      - 1.学会三方库的两种安装方法
+      - 1.学会三方库的安装方法
       - 2.使用SSD1306驱动OLED
       - 3.通讯协议小课堂-I2C通信
       - 4.学会面向对象编程-封装OLED驱动

+ 117 - 0
docs/humble/chapt13/advance/1.学会安装第三方开源库.md

@@ -0,0 +1,117 @@
+# 1.学会安装第三方开源库
+
+你好,我是爱吃鱼香ROS的小鱼。秉承着拒绝重复造轮子的ROS精神,本节我们学习如何在我们的工程里安装第三方开源库。
+
+在我们的PIO工程中有多种方式可以添加第三方库,常用的有以下三种:
+
+- 通过PIO搜索安装
+- 通过GIT地址安装
+- 手动下载安装
+
+接下来我们以安装OLED库和IMU的驱动库为例,学习安装第三方库的方法。
+
+开始之前先新建一个工程`example05_depends`
+
+![image-20230118202656955](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118202656955.png)
+
+## 一、通过PIO搜索安装
+
+我们以安装OLED常用的三方库`Adafruit  SSD1306`安装为例。
+
+1. 点击PIO图标
+2. 点击Libraries
+3. 输入`Adafruit  SSD1306`
+4. 点击下载按钮
+
+![image-20230118203851492](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118203851492.png)
+
+5.点击Add to Project
+
+6.选择要添加到的工程
+
+7.点击Add
+
+![image-20230118204327440](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118204327440.png)
+
+看到界面表示成功
+
+![image-20230118204438666](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118204438666.png)
+
+此时打开`platformio.ini`你将看到
+
+```
+[env:featheresp32]
+platform = espressif32
+board = featheresp32
+framework = arduino
+
+lib_deps = adafruit/Adafruit SSD1306@^2.5.7
+```
+
+`lib_deps = adafruit/Adafruit SSD1306@^2.5.7`就是我们安装的库的名字。
+
+既然安装好了那安装的文件位置在哪里呢?打开`.pio/libdeps/featheresp32`,这里就是我们安装的第三方库的代码位置。
+
+![image-20230118205841912](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118205841912.png)
+
+## 二、通过GIT地址安装
+
+我们的开发板,板载了一块MPU6050模块,通过该模块可以实现对温度、加速度、加速度、重力测量。
+
+这里小鱼推荐一个简单易用MPU6050的三方驱动库MPU6050_light: https://github.com/rfetick/MPU6050_light
+
+![image-20230118214139593](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118214139593.png)
+
+
+
+接着我们来看如何将该库添加到我们的工程中
+
+1.复制仓库地址
+
+![image-20230118214843252](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118214843252.png)
+
+2.打开`platformio.ini`,将地址复制进去即可
+
+```ini
+[env:featheresp32]
+platform = espressif32
+board = featheresp32
+framework = arduino
+lib_deps = 
+    adafruit/Adafruit SSD1306@^2.5.7
+    https://github.com/rfetick/MPU6050_light.git
+```
+
+稍等片刻,等待PIO下载完成,接着打开`.pio/libdeps/featheresp32`可以看到`MPU6050_light`库被下载到该目录。
+
+![image-20230118215331323](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118215331323.png)
+
+
+
+## 三、手动下载安装
+
+该方式更简单,我们直接将工程克隆到工程的lib目录下即可。
+
+```shell
+cd lib
+git clone https://github.com/rfetick/MPU6050_light.git
+```
+
+
+
+![image-20230118215533223](1.%E5%AD%A6%E4%BC%9A%E5%AE%89%E8%A3%85%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BC%80%E6%BA%90%E5%BA%93/imgs/image-20230118215533223.png)
+
+
+
+
+
+## 四、总结
+
+本节我们学习了三种安装三方库的方式,下一节我们开始尝试使用三方库来驱动MPU6050和OLED。
+
+
+
+
+
+
+

BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118202656955.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118203851492.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118204000166.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118204327440.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118204438666.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118205841912.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118214139593.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118214843252.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118215331323.png


BIN
docs/humble/chapt13/advance/1.学会安装第三方开源库/imgs/image-20230118215533223.png