说明

本工程为使用nuttx 进行编程的Demo。用于搭建一个基础框架用于快速开发应用。

网络

本工程将会自动连接以下热点，若以下热点不存在请在连接超时进入nsh后使用wapi命令连接。

SSID:ESP32
密码：12345678

源代码下载

本源代码只能通过github.com下载(或者在下载子模块前修改git远程仓库地址),其它方式下载请酌情修改.gitmodules。

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

在进行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

挂载

开机时将自动将/dev/esp32flash挂载至/var/esp。设备文件为/dev/esp32flash(需要在Kconfig中启用SPI Flash(CONFIG_ESP32_SPIFLASH))。

#若因某种原因被卸载（如手动卸载）,可在sh中执行以下指令,将/dev/esp32flash挂载至/var/esp,挂载后即可在目录访问。
mount -t spiffs /dev/esp32flash /var/esp

测试截图

编译环境

本工程主要支持Linux / WSL。注意:由于nuttx编译过程中需要下载大量数据,请保持网络通畅(尤其是github.com)。

本工程中采用esp-idf的安装脚本安装工具链,nuttx采用esp-idf的工具链编译,但不使用esp-idf的idf.py而是make。

编译环境安装

参考 esp-idf 与 nuttx 的说明。

对于ubuntu 22.04 可采用以下指令安装(如缺少其它命令，请根据提示操作):

sudo apt-get install build-essential make cmake python3-pip python3-venv curl wget kconfig-frontends git patch findutils sed

编译

编译之前需要执行工程目录下的bootstrap.sh(同一个终端只需要执行一次)。

常用操作

构建

make

烧录

#直接烧录
make flash
#使用ESPTOOL_PORT指定烧录端口，不指定默认为/dev/ttyUSB0。 
#使用ESPTOOL_BAUD指定烧录端口，不指定默认为115200。
make flash ESPTOOL_PORT=串口设备 ESPTOOL_BAUD=波特率

调试

除了自行使用串口调试工具,也可使用以下命令调试。注意:烧录时需要手动关闭调试相关进程。

#monitor,同esp-idf的monitor工具，由于回显问题，此工具不能正确显示命令。
make monitor
#使用ESPTOOL_PORT指定烧录端口，不指定默认为/dev/ttyUSB0。 
#使用ESPTOOL_BAUD指定烧录端口，不指定默认为115200。
make monitor ESPTOOL_PORT=串口设备 ESPTOOL_BAUD=波特率

#putty,若安装了putty且处于桌面环境，可使用putty。
make putty
#使用ESPTOOL_PORT指定烧录端口，不指定默认为/dev/ttyUSB0。 
#使用ESPTOOL_BAUD指定烧录端口，不指定默认为115200。
make putty ESPTOOL_PORT=串口设备 ESPTOOL_BAUD=波特率

Kconfig配置

make menuconfig

清理

make clean

清理所有

此清理除了清理生成的.o文件,还会清理下载的文件。对于处理莫名奇妙出现的编译错误非常有用，清理完成后需要在新的终端执行bootstrap.sh。

make distclean

若此命令仍然不能解决问题（如Kconfig有误导致路径错误）,请直接删除nuttx/.config并关闭终端，然后在新的终端执行bootstrap.sh。

HEYAHONG/ESP32ModNuttxDemo

说明

网络