说明

本工程为使用esp-idf 进行编程的Demo。整理一些基础功能以快速开发新应用，主要目标soc为ESP32。

以太网

ESP32支持以太网需要收发器,本人采用LAN8720作为收发器。对于ESP32连接如下图:

其中REFC_1为以太网时钟,ETH_EN为芯片使能(LAN8720芯片的复位脚)。

功能

• 常用网络功能的Kconfig配置(WIFI、以太网)。
• spiffs文件系统(文件读写及编译时生成镜像)。
• tftp服务器,可采用tftp工具在线修改spiffs文件系统的内容。

源代码下载

由于本源代码包含第三方源代码,故直接下载可能有部分源代码缺失，需要通过以下方法解决:

• 在进行git clone 使用--recurse-submodules参数。

• 若已通过git clone下载,则在源代码目录中执行以下命令下载子模块:

   git submodule update --init --recursive

资源文件

类似于桌面程序的资源文件。源代码实现的目录为 main/rc。

在固件编写中，很多时候需要大量的固定数据，直接手工嵌入到C文件里比较麻烦。

通过读取文件转换到对应C文件可大大节省时间，可添加常用的文件（如各种证书）或者不适宜放在可读写的文件系统中的文件(如需要在格式化中保留或者初始参数)。转换程序源代码为main/rc/fsgen.cpp。

使用步骤如下:

• 将待添加的文件放入 main/rc/fs目录下。

• 使用文件名调用以下函数(需包含相应头文件RC.h):

  //通过名称获取资源大小
  size_t RCGetSize(const char * name);
  
  //通过名称获取资源指针
  const unsigned char * RCGetHandle(const char * name);

SPIFFS

spiffs是一个用于嵌入式目标上的SPI NOR flash设备的文件系统。挂载spiffs后可直接以文件的形式进行数据的存储(可读可写)。

预置的镜像

可预先将一些文件放入文件系统,可直接在挂载后访问(可读可写)。

目录:spiffs_image

挂载

默认情况下,挂载的目录为/spiffs,具体参见 main/init.c

测试截图

以太网LAN8720

以太网的Kconfig如下：

monitor截图：

启用OneNET MQTT直连设备测试

Kconfig如下：

monitor截图：

网站信息：

编译

编译环境安装

注意:仅支持github.com下载的代码，非github用户下载时不能下载子模块，下载后自行修改.gitmodules中esp-idf的url为 https://github.com/espressif/esp-idf.git 后再按照说明中源代码下载的方式同步子模块。

Linux / WSL

执行工程目录下的 bootstrap.sh，当提示 初始化完成时 即表示编译环境安装完成。

注意: bootstrap.sh主要用于进入编译环境,执行bootstrap.sh前需保证当前环境能正常使用esp-idf编译例程。每次打开终端后，如需进行工程编译,就需要执行 bootstrap.sh,若未关闭终端,无需重复执行 bootstrap.sh 。

其它

进入 esp-idf 目录,安装官方的说明安装。

编译说明

环境安装正确后可采用以下方式编译（由SDK提供）：

• 使用CMAKE生成工程文件，再根据工程类型（CMake支持的工程类型，下面均为个人习惯的类型）进行编译：
  • 默认状态下生成可使用make进行编译的工程。
  • 生成codeblocks工程文件，再使用codeblocks编译（编译之前需确定环境变量设置正确）
• ESP IDF支持的方式（idf.py）。

根据平台不同，CMake还可支持nijia/Eclipse CDT等类型。

ESP-IDF版本

若使用bootstrap.sh安装编译环境,无需注意此提示。

• 已测试分支：master(git version:fa5d0a351343b45ee06d221b7c29028672a4c3c2 )

注意

若使用bootstrap.sh安装编译环境,无需注意此提示。

为了精简Kconfig大小，分离了Kconfig文件。因此，除了在需要在esp-idf下执行以下指令，在本工程目录下也需要执行以下指令(若esp-idf安装在默认目录~/esp/esp-idf，只需要在本工程目录下执行):

source export.sh