esp8266解析php,ESP8266 Bootloader开源代码解析之rboot（一）

仉嘉泽

2023-12-01

前言

在非Linux的嵌入式开发中，自己手写Bootloader是很正常的事。因为可以定制自己想要的功能。比如定制自己的Bootloader通信接口(UART、I2C、SPI)，通信协议，甚至更高级的固件备份回退等功能。但是使用ESP8266就不一样了，整个芯片的程序是怎么跑起来的都一知半解(所以我写了这篇文章：ESP8266架构探索-运行的起始)；官方提供了Bootloader和完整的接口，但是是闭源的；官方Bootloader虽然有做固件备份，但是没有固件回滚，等等这些问题。所以这时候rboot出现了。我们有很多原因不能从无到有写一个自己的Bootloader，但是我们可以借鉴，知道rboot怎么运作后，就能够通过修改，裁剪，做出自己想要的Bootloader。所以这篇文章不会花大力气去分析rboot的特性是怎么实现的，着重于怎么写一个ESP8266上最基础的Bootloader。

工程目录

├── appcode

│ ├── rboot-api.c

│ ├── rboot-api.h

│ └── rboot-bigflash.c

├── build

│ ├── rboot.elf

│ ├── rboot-hex2a.h

│ ├── rboot.o

│ ├── rboot-stage2a.elf

│ └── rboot-stage2a.o

├── eagle.app.v6.ld

├── eagle.rom.addr.v6.ld

├── firmware

│ └── rboot.bin

├── license.txt

├── Makefile

├── rboot.c

├── rboot.h

├── rboot-private.h

├── rboot-stage2a.c

├── rboot-stage2a.ld

├── readme-api.txt

├── readme.md

├── testload1.c

└── testload2.c

其中，rboot.c rboot-stage2a.c就是我们想要的代码。

运行流程

rboot.c的ENTRY是call_user_start，我们看看运行流程：(c语言版和汇编版功能一样，看c语言代码便于理解)

void call_user_start(void) {

uint32_t addr;

stage2a *loader;

addr = find_image();

if (addr != 0) {

loader = (stage2a*)entry_addr; //rboot-stage2a.c中的call_user_start

loader(addr);

}

从配置参数中找到应用固件的地址，然后调用entry_addr处的函数执行。

entry_addr在rboot-hex2a.h中定义：

const uint32_t entry_addr = 0x4010fcb4; //被rboot.c中的call_user_start里调用

const uint32_t _text_addr = 0x4010fc00;

const uint32_t _text_len = 192;

const uint8_t _text_data[] = {

0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,

0x00, 0x10, 0x00, 0x00, 0x1c, 0x4b, 0x00, 0x40, 0x12, 0xc1, 0xc0, 0xc9, 0xe1, 0x8b, 0x31, 0xcd,

0x02, 0x0c, 0x84, 0xe9, 0xc1, 0xf9, 0xb1, 0x09, 0xf1, 0xd9, 0xd1, 0xc2, 0xcc, 0x08, 0x01, 0xf9,

0xff, 0xc0, 0x00, 0x00, 0xf8, 0x31, 0xe2, 0x01, 0x09, 0x86, 0x10, 0x00, 0x2d, 0x0c, 0x3d, 0x01,

0x0c, 0x84, 0x01, 0xf4, 0xff, 0xc0, 0x00, 0x00, 0x8b, 0xcc, 0x78, 0x01, 0xd8, 0x11, 0x46, 0x09,

0x00, 0x21, 0xef, 0xff, 0x5d, 0x0d, 0xd7, 0xb2, 0x02, 0x20, 0x52, 0x20, 0x2d, 0x0c, 0x3d, 0x07,

0x4d, 0x05, 0x59, 0x51, 0x79, 0x41, 0x01, 0xeb, 0xff, 0xc0, 0x00, 0x00, 0x58, 0x51, 0x78, 0x41,

0x5a, 0xcc, 0x5a, 0x77, 0x50, 0xdd, 0xc0, 0x56, 0x6d, 0xfd, 0x0b, 0x6e, 0x60, 0xe0, 0x74, 0x56,

0x9e, 0xfb, 0x08, 0xf1, 0x2d, 0x0f, 0xc8, 0xe1, 0xd8, 0xd1, 0xe8, 0xc1, 0xf8, 0xb1, 0x12, 0xc1,

0x40, 0x0d, 0xf0, 0x00, 0xfd, 0x00, 0x05, 0xf8, 0xff, 0x0d, 0x0f, 0xa0, 0x02, 0x00, 0x0d, 0xf0,

};

对比entry_addr和_text_addr关系，再根据_text_addr和_text_data的名字关系(手动狗头)，知道entry_addr的代码就在_text_data中。rboot-hex2a.h由rboot-stage2a.c生成的，call_user_start在rboot-stage2a.ld中定义为ENTRY：

/* Default entry point: */

ENTRY(call_user_start)

rboot-stage2a.c的代码：

void call_user_start(uint32_t readpos) {

usercode* user;

user = load_rom(readpos);

user();

}

从flash中读取代码，然后执行。

所以整个rboot流程就是：从配置参数中找到应用固件的地址，然后调用rboot-stage2a中的函数从flash中读取代码，然后执行。

这样说下来，流程是通了，但是过程一点都经不起推敲啊。那么下面来认真分析rboot-stage2a.c的代码怎么关联到rboot.c中的。

编译分析

我们先看Makefile。

all: $(RBOOT_BUILD_BASE) $(RBOOT_FW_BASE) $(RBOOT_FW_BASE)/rboot.bin

$(RBOOT_BUILD_BASE)/rboot.o: rboot.c rboot-private.h rboot.h $(RBOOT_BUILD_BASE)/rboot-hex2a.h

@echo "CC $

$(Q) $(CC) $(CFLAGS) -I$(RBOOT_BUILD_BASE) -c $< -o $@

$(RBOOT_BUILD_BASE)/rboot-hex2a.h: $(RBOOT_BUILD_BASE)/rboot-stage2a.elf

@echo "E2 $@"

$(Q) $(ESPTOOL2) -quiet -header $< $@ .text

$(RBOOT_BUILD_BASE)/rboot-stage2a.elf: $(RBOOT_BUILD_BASE)/rboot-stage2a.o

@echo "LD $@"

$(Q) $(LD) -Trboot-stage2a.ld $(LDFLAGS) -Wl,--start-group $^ -Wl,--end-group -o $@

顺序有所调整。但最终rboot-stage2a.c变成了rboot-hex2a.h包含在rboot.c中。

这里有两个关键的地方：

rboot-stage2a.elf通过ESPTOOL2变成了rboot-hex2a.h

rboot-stage2a.c最终变成了rboot-hex2a.h

编译过程中用到了esptool2，先把esptool2下载下来：https://github.com/raburton/esptool2

直奔主题，esptool2.c文件中，使用-header参数就是把elf文件变成.h头文件

// load elf file

elf = LoadElf(elffile);

if (!elf) {

goto end_function;

}

// open output file

outfile = fopen(imagefile, "wb");

if(outfile == NULL) {

error("Error: Failed to open output file '%s' for writing.\r\n", imagefile);

goto end_function;

}

// add entry point

fprintf(outfile, "const uint32_t entry_addr = 0x%08x;\r\n", elf->header.e_entry);

// add sections

for (i = 0; i < numsec; i++) {

// get elf section header

sect = GetElfSection(elf, sections[i]);

if(!sect) {

error("Error: Section '%s' not found in elf file.\r\n", sections[i]);

goto end_function;

}

// simple name fix name

strncpy(name, sect->name, 31);

len = strlen(name);

for (j = 0; j < len; j++) {

if (name[j] == '.') name[j] = '_';

}

// add address, length and start the data block

debug("Adding section '%s', addr: 0x%08x, size: %d.\r\n", sections[i], sect->address, sect->size);

fprintf(outfile, "\r\nconst uint32_t %s_addr = 0x%08x;\r\nconst uint32_t %s_len = %d;\r\nconst uint8_t %s_data[] = {",

name, sect->address, name, sect->size, name);

// get elf section binary data

bindata = GetElfSectionData(elf, sect);

if (!bindata) {

goto end_function;

}

// add the data and finish off the block

for (j = 0; j < sect->size; j++) {

if (j % 16 == 0) fprintf(outfile, "\r\n 0x%02x,", bindata[j]);

else fprintf(outfile, " 0x%02x,", bindata[j]);

}

fprintf(outfile, "\r\n};\r\n");

free(bindata);

bindata = 0;

}

然后对比rboot-hex2a.h文件，是不是这样转过来的：

const uint32_t entry_addr = 0x4010fcb4;