SDMSJY2.0(孙大明版)工程源码学习

版本源码说明

Non-OS 下的 esp_iot_sdk_v?版，at模板+driver_lib模板。

一、Makefile学习

 Makefile文件是在编译时处理源码文件的链接的，因此要学会使用，才能更好使用ESP官方固件或修改。

一般官方固件都是先配好Makefile文件的。

目前ESP8266硬件版本较多，因此也需要使用Makefile文件来选择一些硬件参数，来适应不同模块。（具体官方固件内有txt说明）

#  copyright (c) 2010 Espressif System

ifndef PDIR
endif

ifeq ($(COMPILE), gcc)                        #编译平台==gcc时，使用的工具（在开发平台的cygwin目录下）
    AR = xtensa-lx106-elf-ar
    CC = xtensa-lx106-elf-gcc
    NM = xtensa-lx106-elf-nm
    CPP = xtensa-lx106-elf-cpp
    OBJCOPY = xtensa-lx106-elf-objcopy
    OBJDUMP = xtensa-lx106-elf-objdump
else
    AR = xt-ar
    CC = xt-xcc
    NM = xt-nm
    CPP = xt-cpp
    OBJCOPY = xt-objcopy
    OBJDUMP = xt-objdump
endif

#模块硬件配置：<根据文档配置>
#noboot,eagle.flash.bin and eagle.irom0text.bin,SPI速度40MHz，SPI接口QIO和flash map
BOOT?=none                    
APP?=0
SPI_SPEED?=40
SPI_MODE?=QIO
SPI_SIZE_MAP?=0

#boot定义
ifeq ($(BOOT), new)
    boot = new
else
    ifeq ($(BOOT), old)
        boot = old
    else
        boot = none
    endif
endif

#app生成模式
ifeq ($(APP), 1)
    app = 1
else
    ifeq ($(APP), 2)
        app = 2
    else
        app = 0
    endif
endif

#spi_speed定义
ifeq ($(SPI_SPEED), 26.7)
    freqdiv = 1
else
    ifeq ($(SPI_SPEED), 20)
        freqdiv = 2
    else
        ifeq ($(SPI_SPEED), 80)
            freqdiv = 15
        else
            freqdiv = 0
        endif
    endif
endif

#spi_mode定义
ifeq ($(SPI_MODE), QOUT)
    mode = 1
else
    ifeq ($(SPI_MODE), DIO)
        mode = 2
    else
        ifeq ($(SPI_MODE), DOUT)
            mode = 3
        else
            mode = 0
        endif
    endif
endif

#有可能被覆盖，定义
addr = 0x01000
#flash map定义
ifeq ($(SPI_SIZE_MAP), 1)
  size_map = 1
  flash = 256
else
  ifeq ($(SPI_SIZE_MAP), 2)
    size_map = 2
    flash = 1024
    ifeq ($(app), 2)
      addr = 0x81000
    endif
  else
    ifeq ($(SPI_SIZE_MAP), 3)
      size_map = 3
      flash = 2048
      ifeq ($(app), 2)
        addr = 0x81000
      endif
    else
      ifeq ($(SPI_SIZE_MAP), 4)
        size_map = 4
        flash = 4096
        ifeq ($(app), 2)
          addr = 0x81000
        endif
      else
        ifeq ($(SPI_SIZE_MAP), 5)
          size_map = 5
          flash = 2048
          ifeq ($(app), 2)
            addr = 0x101000
          endif
        else
          ifeq ($(SPI_SIZE_MAP), 6)
            size_map = 6
            flash = 4096
            ifeq ($(app), 2)
              addr = 0x101000
            endif
          else                            #模块为512K
            size_map = 0
            flash = 512
            ifeq ($(app), 2)            #？
              addr = 0x41000
            endif
          endif
        endif
      endif
    endif
  endif
endif

#定义LD文件夹下文件
LD_FILE = $(LDDIR)/eagle.app.v6.ld

#有boot情况下
ifneq ($(boot), none)
ifneq ($(app),0)
    ifeq ($(size_map), 6)
      LD_FILE = $(LDDIR)/eagle.app.v6.$(boot).2048.ld
    else
      ifeq ($(size_map), 5)
        LD_FILE = $(LDDIR)/eagle.app.v6.$(boot).2048.ld
      else
        ifeq ($(size_map), 4)
          LD_FILE = $(LDDIR)/eagle.app.v6.$(boot).1024.app$(app).ld
        else
          ifeq ($(size_map), 3)
            LD_FILE = $(LDDIR)/eagle.app.v6.$(boot).1024.app$(app).ld
          else
            ifeq ($(size_map), 2)
              LD_FILE = $(LDDIR)/eagle.app.v6.$(boot).1024.app$(app).ld
            else
              ifeq ($(size_map), 0)
                LD_FILE = $(LDDIR)/eagle.app.v6.$(boot).512.app$(app).ld
              endif
            endif
          endif
        endif
      endif
    endif
    BIN_NAME = user$(app).$(flash).$(boot).$(size_map)
endif
else
    app = 0
endif


CSRCS ?= $(wildcard *.c)        #所以*.c的展开集
ASRCs ?= $(wildcard *.s)        #所以*.s的展开集
ASRCS ?= $(wildcard *.S)        #所以*.S的展开集
SUBDIRS ?= $(patsubst %/,%,$(dir $(wildcard */Makefile)))    
#所以子集下的Makefile文件，dir为上次目录（如app/），patsubst为字符替换（如app/替换为app）

#生成.output文件
ODIR := .output
OBJODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/obj

OBJS := $(CSRCS:%.c=$(OBJODIR)/%.o) \
        $(ASRCs:%.s=$(OBJODIR)/%.o) \
        $(ASRCS:%.S=$(OBJODIR)/%.o)

DEPS := $(CSRCS:%.c=$(OBJODIR)/%.d) \
        $(ASRCs:%.s=$(OBJODIR)/%.d) \
        $(ASRCS:%.S=$(OBJODIR)/%.d)

LIBODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/lib
OLIBS := $(GEN_LIBS:%=$(LIBODIR)/%)

IMAGEODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/image
OIMAGES := $(GEN_IMAGES:%=$(IMAGEODIR)/%)

BINODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/bin
OBINS := $(GEN_BINS:%=$(BINODIR)/%)

CCFLAGS +=             \
    -g                    \
    -O2                    \
    -Wpointer-arith        \
    -Wundef                \
    -Werror                \
    -Wl,-EL                \
    -fno-inline-functions    \
    -nostdlib              \
    -mlongcalls            \
    -mtext-section-literals \
    -ffunction-sections     \
    -fdata-sections
#    -Wall            

CFLAGS = $(CCFLAGS) $(DEFINES) $(EXTRA_CCFLAGS) $(INCLUDES)
DFLAGS = $(CCFLAGS) $(DDEFINES) $(EXTRA_CCFLAGS) $(INCLUDES)


#############################################################
# Functions
#

define ShortcutRule
$(1): .subdirs $(2)/$(1)
endef

#建立库
define MakeLibrary
DEP_LIBS_$(1) = $$(foreach lib,$$(filter %.a,$$(COMPONENTS_$(1))),$$(dir $$(lib))$$(LIBODIR)/$$(notdir $$(lib)))
DEP_OBJS_$(1) = $$(foreach obj,$$(filter %.o,$$(COMPONENTS_$(1))),$$(dir $$(obj))$$(OBJODIR)/$$(notdir $$(obj)))
$$(LIBODIR)/$(1).a: $$(OBJS) $$(DEP_OBJS_$(1)) $$(DEP_LIBS_$(1)) $$(DEPENDS_$(1))
    @mkdir -p $$(LIBODIR)
    $$(if $$(filter %.a,$$?),mkdir -p $$(EXTRACT_DIR)_$(1))
    $$(if $$(filter %.a,$$?),cd $$(EXTRACT_DIR)_$(1); $$(foreach lib,$$(filter %.a,$$?),$$(AR) xo $$(UP_EXTRACT_DIR)/$$(lib);))
    $$(AR) ru $$@ $$(filter %.o,$$?) $$(if $$(filter %.a,$$?),$$(EXTRACT_DIR)_$(1)/*.o)
    $$(if $$(filter %.a,$$?),$$(RM) -r $$(EXTRACT_DIR)_$(1))
endef

#建立Image
define MakeImage
DEP_LIBS_$(1) = $$(foreach lib,$$(filter %.a,$$(COMPONENTS_$(1))),$$(dir $$(lib))$$(LIBODIR)/$$(notdir $$(lib)))
DEP_OBJS_$(1) = $$(foreach obj,$$(filter %.o,$$(COMPONENTS_$(1))),$$(dir $$(obj))$$(OBJODIR)/$$(notdir $$(obj)))
$$(IMAGEODIR)/$(1).out: $$(OBJS) $$(DEP_OBJS_$(1)) $$(DEP_LIBS_$(1)) $$(DEPENDS_$(1))
    @mkdir -p $$(IMAGEODIR)
    $$(CC) $$(LDFLAGS) $$(if $$(LINKFLAGS_$(1)),$$(LINKFLAGS_$(1)),$$(LINKFLAGS_DEFAULT) $$(OBJS) $$(DEP_OBJS_$(1)) $$(DEP_LIBS_$(1))) -o $$@ 
endef

#bin输出
$(BINODIR)/%.bin: $(IMAGEODIR)/%.out
    @mkdir -p $(BINODIR)
    
ifeq ($(APP), 0)
    @$(RM) -r ../bin/eagle.S ../bin/eagle.dump
    @$(OBJDUMP) -x -s $< > ../bin/eagle.dump
    @$(OBJDUMP) -S $< > ../bin/eagle.S
else
    @$(RM) -r ../bin/upgrade/$(BIN_NAME).S ../bin/upgrade/$(BIN_NAME).dump
    @$(OBJDUMP) -x -s $< > ../bin/upgrade/$(BIN_NAME).dump
    @$(OBJDUMP) -S $< > ../bin/upgrade/$(BIN_NAME).S
endif

    @$(OBJCOPY) --only-section .text -O binary $< eagle.app.v6.text.bin
    @$(OBJCOPY) --only-section .data -O binary $< eagle.app.v6.data.bin
    @$(OBJCOPY) --only-section .rodata -O binary $< eagle.app.v6.rodata.bin
    @$(OBJCOPY) --only-section .irom0.text -O binary $< eagle.app.v6.irom0text.bin

#配置信息输出
    @echo ""
    @echo "Make Infomation Output. By LLW."
ifeq ($(app), 0)
    @python ../tools/gen_appbin.py $< 0 $(mode) $(freqdiv) $(size_map)
    @mv eagle.app.flash.bin ../bin/eagle.flash.bin
    @mv eagle.app.v6.irom0text.bin ../bin/eagle.irom0text.bin
    @rm eagle.app.v6.*
    @echo "No boot mode."
    @echo "Generate eagle.flash.bin and eagle.irom0text.bin successully in folder bin."
    @echo "eagle.flash.bin-------->0x00000"
    @echo "eagle.irom0text.bin---->0x40000"
else
    ifneq ($(boot), new)
        @python ../tools/gen_appbin.py $< 1 $(mode) $(freqdiv) $(size_map)
        @echo "Support boot_v1.1 and +"
    else
        @python ../tools/gen_appbin.py $< 2 $(mode) $(freqdiv) $(size_map)

        ifeq ($(size_map), 6)
        @echo "Support boot_v1.4 and +"
        else
            ifeq ($(size_map), 5)
        @echo "Support boot_v1.4 and +"
            else
        @echo "Support boot_v1.2 and +"
            endif
        endif
    endif

    @mv eagle.app.flash.bin ../bin/upgrade/$(BIN_NAME).bin
    @rm eagle.app.v6.*
    @echo "Generate $(BIN_NAME).bin successully in folder bin/upgrade."
    @echo "boot.bin------------>0x00000"
    @echo "$(BIN_NAME).bin--->$(addr)"
endif
    @echo ""

#############################################################
# Rules base
# Should be done in top-level makefile only
#

all:    .subdirs $(OBJS) $(OLIBS) $(OIMAGES) $(OBINS) $(SPECIAL_MKTARGETS)

clean:
    $(foreach d, $(SUBDIRS), $(MAKE) -C $(d) clean;)
    $(RM) -r $(ODIR)/$(TARGET)/$(FLAVOR)

clobber: $(SPECIAL_CLOBBER)
    $(foreach d, $(SUBDIRS), $(MAKE) -C $(d) clobber;)
    $(RM) -r $(ODIR)

.subdirs:
    @set -e; $(foreach d, $(SUBDIRS), $(MAKE) -C $(d);)

#.subdirs:
#    $(foreach d, $(SUBDIRS), $(MAKE) -C $(d))

ifneq ($(MAKECMDGOALS),clean)
ifneq ($(MAKECMDGOALS),clobber)
ifdef DEPS
sinclude $(DEPS)
endif
endif
endif

$(OBJODIR)/%.o: %.c
    @mkdir -p $(OBJODIR);
    $(CC) $(if $(findstring $<,$(DSRCS)),$(DFLAGS),$(CFLAGS)) $(COPTS_$(*F)) -o $@ -c $<

$(OBJODIR)/%.d: %.c
    @mkdir -p $(OBJODIR);
    @echo DEPEND: $(CC) -M $(CFLAGS) $<
    @set -e; rm -f $@; \
    $(CC) -M $(CFLAGS) $< > $@.$$$$; \
    sed 's,\($*\.o\)[ :]*,$(OBJODIR)/\1 $@ : ,g' < $@.$$$$ > $@; \
    rm -f $@.$$$$

$(OBJODIR)/%.o: %.s
    @mkdir -p $(OBJODIR);
    $(CC) $(CFLAGS) -o $@ -c $<

$(OBJODIR)/%.d: %.s
    @mkdir -p $(OBJODIR); \
    set -e; rm -f $@; \
    $(CC) -M $(CFLAGS) $< > $@.$$$$; \
    sed 's,\($*\.o\)[ :]*,$(OBJODIR)/\1 $@ : ,g' < $@.$$$$ > $@; \
    rm -f $@.$$$$

$(OBJODIR)/%.o: %.S
    @mkdir -p $(OBJODIR);
    $(CC) $(CFLAGS) -D__ASSEMBLER__ -o $@ -c $<

$(OBJODIR)/%.d: %.S
    @mkdir -p $(OBJODIR); \
    set -e; rm -f $@; \
    $(CC) -M $(CFLAGS) $< > $@.$$$$; \
    sed 's,\($*\.o\)[ :]*,$(OBJODIR)/\1 $@ : ,g' < $@.$$$$ > $@; \
    rm -f $@.$$$$

$(foreach lib,$(GEN_LIBS),$(eval $(call ShortcutRule,$(lib),$(LIBODIR))))

$(foreach image,$(GEN_IMAGES),$(eval $(call ShortcutRule,$(image),$(IMAGEODIR))))

$(foreach bin,$(GEN_BINS),$(eval $(call ShortcutRule,$(bin),$(BINODIR))))

$(foreach lib,$(GEN_LIBS),$(eval $(call MakeLibrary,$(basename $(lib)))))

$(foreach image,$(GEN_IMAGES),$(eval $(call MakeImage,$(basename $(image)))))

#############################################################
# Recursion Magic - Don't touch this!!
#
# Each subtree potentially has an include directory
#   corresponding to the common APIs applicable to modules
#   rooted at that subtree. Accordingly, the INCLUDE PATH
#   of a module can only contain the include directories up
#   its parent path, and not its siblings
#
# Required for each makefile to inherit from the parent
#

INCLUDES := $(INCLUDES) -I $(PDIR)include -I $(PDIR)include/$(TARGET)
PDIR := ../$(PDIR)
sinclude $(PDIR)Makefile