ESP8266開發課堂之 - 建立一個新項目


項目架構

ESP8266項目開發並非使用IDE自動管理工程文件,而是使用了諸多第三方程序如Python,以及使用了Makefile管理依賴與控制編譯,所以項目的創建與日常維護較為復雜,本篇將詳述創建一般項目的詳細步驟。下圖描述了一個ESP8266工程的大致模樣:

要開始本篇的教程,請確保已經完成了上一課《開發環境搭建》中的內容,此處的編譯需要上一篇所提到的IDE與IDE文件夾下的Cygwin的支持,否則無法工作。創建這樣一個項目的大致步驟如下:

步驟1,SDK下載

官網下載最新SDK,以下地址:

http://www.espressif.com/zh-hans/support/download/sdks-demos

暫時請下載1.5.3的文檔,下載完成后解壓(保留原壓縮包,后續會使用),可以看到如下的目錄結構:

此處修改文件夾名稱ESP8266_NONOS_SDK 為有意義的名稱,此名稱將默認作為其后的項目工程名出現。

步驟2,創建入口主文件

在app文件夾下創建user、include文件夾,並分別在其下創建user_main.c,user_config.h。
user_main.c文件內容如下:

#include "osapi.h"

//射頻初始化函數,留空
void user_rf_pre_init(void) { } 

//主文件入口處
void user_init(void)
{
}

user_config.h頭文件留空即可,但為了保持良好的編程習慣,我們傾向於在此構建保護頭,內容一般如下即可:

#ifndef _GUARD_USER_CONFIG_H_
#define _GUARD_USER_CONFIG_H_

#endif

步驟3,復制工程管理Makefile文件

將example\peripheral_test目錄中的Makefile文件復制到app目錄下;將example\peripheral_test\user目錄中的Makefile復制到app\user目錄下。

刪除documents,driver_lib目錄,刪除Examples目錄,僅留下項目必須文件結構。

這里需要復制的Makefile亦可手寫完成,但太過復雜,不推薦。最終形成如下所示的目錄結構:

步驟4,項目導入與編譯控制

導入Eclipse IDE中,導入項目,選擇Existing Code as Makefile Project,選擇目標文件夾。項目導入完畢后,首先請右擊項目名稱,選擇Clean Project清理一遍,然后選擇Build Project。默認編譯成功后控制台輸出如下:

完成!

常見操作釋疑

  1. 向項目新增文件
    普通.c源文件,可直接復制到user目錄,makefile會自動控制進行編譯。

  2. 向項目新增文件夾

參考examples\IoT Demo工程,以新增driver文件夾為例,在app下新增driver后,修改app\Makefile,為SUBDIRS新增 driver值,為COMPONENTS_eagle.app.v6新增 driver/libdriver.a值。
或者拷貝iot文件夾的makefile吧。

  1. 鏈接第三方庫

  2. 項目頭文件包含目錄修改

后續章節將會慢慢提及,但如果需要精通此工具的使用,建議先熟練Makefile的書寫,可以參考網絡文檔:《跟我一起寫Makefile》。

更多教程、資料、文檔,或者購買ESPUSH專屬開發板,加Q群:480288089


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM