乐鑫开发环境之最佳拍档VScode+WSL Linux+ESP

最佳开发拍档

作为开发平台，基本要求：
1、必须有便捷的项目管理能力，ESP开发文件众多，关系复杂，最好是类似keil或Eliscape
2、必须有良好的编程界面，可以显示不同颜色关键字，方便程序阅读；可以快速在不同关联文件间切换
3、良好的调试窗口，方便调试程序
*4、可以在不同的工具链，如ESP8266、ESP32、MDF和ADF等之间切换

前文中使用Vscode直接安装内部ESP-IDF扩展插件，安装过程只要按照指引一步步操作即可，方便快捷，适合ESP32/ESP32-S2的开发，很适合初学者使用，但仅限于IDF开发平台。
如果想尝试乐鑫最新的ESP-MDF或ESP-ADF，还是需要搭建和使用Linux环境。本文介绍一种VScode+WSL Linux+ESP开发环境，兼顾实现上面三个基本要求，理论上也适用与ESP-MDF或ESP-ADF示例开发。

一、WSL迁移

WSL默认安装在系统盘C，原本有50GB空闲空间。使用过程中，不断的git和编译，占用过多系统盘空间，目前仅剩30GB，必须把WSL及ESP开发环境迁移至其它硬盘分区。
百度搜索“修改WSL安装路径”，参照比较后，建议使用LxRunOffline将WSL移至F盘。具体参见博文
https://blog.csdn.net/jioho_chen/article/details/103988647

本部分迁移操作面向C盘为固态，或空间紧张的朋友，若是空间充裕，可跳过此步骤。
另外，如何在windos10 中安装WSL Linux，网上很多资料可自行查找参考，本文不再说明。我的系统是Windows10 专业版，安装WSL Linux为Ubuntu18.04

二、编译ESP程序异常

迁移后，测试WSL Linux一切正常。
从VScode启动并安装remote-WSL插件，就可以连接至WLSLinux虚拟环境了。

这里以新平台VScode+WSL Linux+ESP，编译阿里云开发应用为例
尝试编译ESP32的esp-ali-smartliving\examples\solutions示例程序smart_light，虽然能正常编译并下载程序至ESP32，但运行不正确，灯乱跳，调试信息也显示与原来的VScode下的esp-idf不同。
注意VScode左下角显示“WSL：Ubuntu18.04”表示VScode这时是连接到WLS工作，其终端窗口就是Ubuntu的命令窗口，可执行任何操作

三、程序异常排查

1、怀疑是ESP-IDF有问题，比如原来就未正常git或是移动WSL的过程造成错误，尝试删除重新git，但故障依旧。
2、重新git clone esp-ali-smartliving时，发现其中必须对其目录下的ali-smartliving-device-sdk-c重新编译。
注：【具体以
https://gitee.com/EspressifSystems/esp-ali-smartliving下载后文件夹中的说明文档readme.md里的说明为准】
其中
5.SDK 准备
esp-ali-smartliving SDK, 通过该 SDK 可实现使用 MQTT 协议，连接 ESP 设备到阿里生活物联网平台。
Espressif SDK
ESP32 & ESP32S2 平台: ESP-IDF
ESP8266 平台: ESP8266_RTOS_SDK
Espressif SDK 下载好后：
ESP-IDF: 请切换到 release v3.3.2 tag 版本： git checkout v3.3.2
如果需要使用 ESP32S2 模组，请切换到 release/v4.2 版本： git checkout release/v4.2
ESP8266_RTOS_SDK: 请切换到 release/v3.3 版本： git checkout release/v3.3
6.编译 & 烧写 & 运行
6.1 编译
6.1.1 导出编译器
工具链的设置，需要修改home目录下的profile.d，这个文件是用来配置环境变量的
如果你将来需要从ESP32改为ESP8266，甚至是ESP-MDF或ESP-ADF，都可以很方便的在这里修改工具路径
另外需要说明的是，不同工具链切换的时候，需要注意版本要求，比如上面就提到
“ESP-IDF: 请切换到 release v3.3.2 tag 版本： git checkout v3.3.2
如果需要使用 ESP32S2 模组，请切换到 release/v4.2 版本： git checkout release/v4.2
ESP8266_RTOS_SDK: 请切换到 release/v3.3 版本： git checkout release/v3.3”

注意因为是在Windows下修改完文件，需要回Linux环境修改文档读写权限，可运行
chmod 777 文件名 -R
6.1.2 编译 ali-smartliving-device-sdk-c 库
在 esp-ali-smartliving 目录下执行：
cd ali-smartliving-device-sdk-c
make reconfig (选择SDK平台)
【这个过程需要配置所需函数库，需要一段时间，不可缺少】
make menuconfig (选择相关功能配置,默认不需要修改,该步骤可以省略)
make (生成相关头文件和库文件)
【这个过程编译生成中间.o文件，需要一段时间，不可缺少】
6.1.3 编译 demo 示例
在 esp-ali-smartliving 目录下执行：
cd examples/solutions/smart_light
make defconfig或make chip=esp32 defconfig
make menuconfig

四、下载测试后恢复正常

重新git工具链xtensa-esp32-elf和esp-idf，测试过均无改善。
最后按步骤三重新git和编译，最后OK

五、相关教学视频地址

好像是官方发布的，有些操作不一样
https://www.bilibili.com/video/BV1Q54y127N8?p=1