固件5

版本1.
7版权2016ESP8266云端升级指南关于本手册本手册结构如下:发布说明章标题内容第1章概述简单介绍两种固件模式:FOTA模式(可升级模式)和Non-FOTA模式(不可升级模式).
第2章使用指南以ESP8266_NONOS_SDK\examples\IoT_Demo为例,介绍如何使用云端升级功能.
第3章升级实现原理介绍云端升级的原理,和软件实现示例.
附录Ⅰ固件版本命名规则介绍使用ESP8266_NONOS_SDK\examples\IoT_Demo时,固件命名的规则要求.
日期版本发布说明2016.
04V1.
6首次发布.
2016.
08V1.
7重大修订.
目录1.
概述12.
使用指南22.
1.
编译固件22.
1.
1.
修改IoT_Demo22.
1.
2.
编译IoT_Demo42.
2.
烧录固件52.
2.
1.
获取master_device_key.
bin52.
2.
2.
烧录说明62.
3.
运行说明72.
4.
乐鑫云升级操作说明93.
升级实现原理133.
1.
Flash布局133.
2.
软件实现133.
2.
1.
ESP8266_NONOS_SDK应用143.
2.
2.
ESP8266_RTOS_SDK应用143.
2.
3.
自定义服务器的要求14I.
附录-固件版本命名规则15I.
I.
命名规则15I.
II.
版本值规则16"1.
概述1.
概述ESP8266支持两种主程序固件模式,具体如下:Non-FOTA(FirmwareOvertheAir)模式,不支持通过Wi-Fi从云端下载新版本ESP8266固件.
FOTA模式,可支持通过Wi-Fi从云端下载新版本ESP8266固件,进行升级.
本文介绍使用乐鑫云(http://iot.
espressif.
cn/#/)进行云端升级的操作流程,和实现FOTA模式的原理.
表1-1.
两种烧录方式对比固件模式主程序固件编译区别Non-FOTAeagle.
flash.
bin编译固件时,STEP1选择Non-boot模式.
eagle.
irom0text.
binFOTAboot.
bin编译固件时,STEP1选择boot模式,STEP2选择user1.
bin.
user1.
bin说明:更多关于编译烧录的信息,请参考文档《ESP8266SDK入门指南》.
Espressif"/1912016.
08"2.
使用指南2.
使用指南本章以ESP8266_NONOS_SDK的IoT_Demo应用程序为示例,介绍如何使用升级功能.
2.
1.
编译固件2.
1.
1.
修改IoT_Demo1.
ESP8266SDK下载链接:http://www.
espressif.
com/zh-hans/support/download/sdks-demos2.
IoT_Demo提供SmartLight、SmartPlug和Sensor三种设备的简单示例,其中Sensor设备不支持升级功能.
默认设备类型为SmartLight.
3.
根据实际使用的ESP8266硬件模块Flash大小,修改的用户参数区位置.
步骤结果以ESP8266_NONOS_SDK_V2.
0.
0_16_07_19为例,下载并解压缩.
将待编译的ESP8266_NONOS_SDK\examples\IoT_Demo文件夹复制到\ESP8266_NONOS_SDK根目录下,如右图所示.
步骤结果在ESP8266_NONOS_SDK\IoT_Demo\include\user_config.
h中使能设备类型.
以SmartLight设备为例,如右图所示.
注意:请每次只使能一种设备类型,进行调试.
Espressif"/"2182016.
08"2.
使用指南使用不同的Flashmap对应头文件中的修改位置,如下表2-1.
步骤结果如右图所示,以使用2048KBFlash,512+512map为例,修改ESP8266_NONOS_SDK\IoT_Demo\include\user_light.
h中#definePRIV_PARAM_START_SEC的值.
提示:如果使用的是SmartPlug设备类型,则修改user_plug.
h中的同名定义.
以使用2048KBFlash,512+512map为例,修改ESP8266_NONOS_SDK\IoT_Demo\include\user_esp_platform.
h中#defineESP_PARAM_START_SEC的值.
提示:如果使用的是SmartPlug设备类型,需同样修改此地址.
表2-1.
修改include文件中的字段(单位:KB)默认值(512)修改后的值10242048(512+512)2048(1024+1024)4096(512+512)4096(1024+1024)0x3C0x7C0x7C0xFC0x7C0xFC0x3D0x7D0x7D0xFD0x7D0xFDEspressif"/"3182016.
08"2.
使用指南2.
1.
2.
编译IoT_Demo编译ESP8266_NONOS_SDK\IoT_Demo,步骤如下图2-1,详细的编译指南可参考文档《ESP8266SDK入门指南》.
"图2-1.
编译说明0120STEP1:choosebootversion(0=boot_v1.
1,1=boot_v1.
2+,2=none)enter(0/1/2,default2)STEP2:choosebingenerate(0=eagle.
ash.
bin+eagle.
irom0text.
bin,1=user1.
bin,2=user2.
bin)enter(0/1/2,default0)NYNY2N1Y0123STEP3:choosespispeed(0=20MHz,1=26.
7MHz,2=40MHz,3=80MHz)enter(0/1/2/3,default2)0123STEP4:choosespimode(0=QIO,1=QOUT,2=DIO,3=DOUT)enter(0/1/2/3,default0)023STEP5:choosespisizeandmap0=512KB(256KB+256KB)enter(0/2/3/4/5/6,default0)456注意:user1.
bin和user2.
bin由同一份应用代码在编译过程中STEP2选择不同的选项,分别编译生成:-编译生成user1.
bin后,先运行makeclean清除上次编译生成的临时文件后,再重新编译生成user2.
bin.
user1.
bin和user2.
bin的区别在于它们在Flash中的存放位置不同.
默认烧录user1.
bin到Flash,并将user1.
bin和user2.
bin上传到云端,用于循环下载升级.
图2-1中,颜色标示部分为示例选项,您可以按照实际需求选择.
编译STEP5的选项5和6仅sdk_v1.
1.
0+boot1.
4+flashdownloadtool_v1.
2及之后版本支持.
Espressif"/"4182016.
08"2.
使用指南2.
2.
烧录固件2.
2.
1.
获取master_device_key.
binmaster_device_key是开发者在乐鑫云服务器创建一个智能设备时,乐鑫云自动为该智能设备分配的ID值,具有唯一性.
智能设备依此享受乐鑫云端服务.
1.
注册用户,并登录乐鑫云(http://iot.
espressif.
cn/#/),创建一个智能灯设备.
说明:初次使用乐鑫云,请参考帮助文档http://iot.
espressif.
cn/#/help-zh-cn/.
步骤结果如右图所示,登录乐鑫云,点击"设备开发",点击"+创建".
创建一个智能灯设备,例如:-名字:light-001-隐私设为"公开设备",支持共享给他人-产品选择"创建新的产品"-产品名字:ESP-light-产品类型:灯光配置完成后,点击下方的"创建".
提示:开发者可自行任意定义"设备名字"和"产品名字".
创建完成后,将自动跳转到新设备页面.
在设备页面,可以看到该设备的MasterDeviceKey值.
Espressif"/"5182016.
08"2.
使用指南2.
从乐鑫云导出master_device_key.
bin.
2.
2.
2.
烧录说明根据实际使用的ESP8266硬件模块Flash大小,对应烧录地址如下表.
步骤结果如右图所示,在设备"light-001"的页面右下角,点击"下载KeyBIN".
如上点击后,将下载设备"light-001"的master_device_key.
bin.
-bin文件名称与设备"light-001"的MasterDeviceKey值一致.
表2-2.
FOTA固件下载地址(单位:KB)BIN文件各个Flash容量对应的下载地址512102420484096512+5121024+1024512+5121024+1024master_device_key.
bin0x3E0000x7E0000x7E0000xFE0000x7E0000xFE000blank.
bin(烧录位置一)0x7B0000xFB0000x1FB0000x3FB000esp_init_data_default.
bin0x7C0000xFC0000x1FC0000x3FC000blank.
bin(烧录位置二)0x7E0000xFE0000x1FE0000x3FE000boot.
bin0x00000user1.
bin0x01000表2-3.
FOTA固件说明BIN文件说明master_device_key.
bin用户从乐鑫云申请,依此享受乐鑫云端服务.
存放于用户参数区,储存地址由用户应用程序自定义.
表2-2中的烧录位置为IoT_Demo程序按照2.
1.
1设定的示例位置.
blank.
bin(烧录位置一)初始化RF_CAL参数区.
烧录位置由应用程序中的user_rf_cal_sector_set设置决定.
表2-2中的烧录位置为IoT_Demo程序中设定的示例位置.
由乐鑫官方提供,位于ESP266_SDK\bin路径下.
esp_init_data_default.
bin初始化其他射频参数区,至少烧录一次.
当RF_CAL参数区初始化烧录时,本区域也需烧录.
由乐鑫官方提供,位于ESP266_SDK\bin路径下.
BIN文件Espressif"/"6182016.
08"2.
使用指南2.
3.
运行说明1.
参考章节2.
1修改IoT_Demo应用程序并编译.
2.
参考章节2.
2烧录固件到ESP8266模块中.
3.
将ESP8266模块上电运行(默认波特率74880),模块将执行智能灯应用.
4.
使用乐鑫手机APP,配置ESP8266模块连接路由器.
乐鑫手机APP配置步骤如下:(1)使用在乐鑫云注册的用户名和密码登录手机APP.
"图2-2.
登录页面blank.
bin(烧录位置二)初始化系统参数区.
由乐鑫官方提供,位于ESP266_SDK\bin路径下.
boot.
bin主程序,由乐鑫官方提供,位于ESP266_SDK\bin路径下.
user1.
bin主程序,编译应用程序生成,位于ESP266_SDK\bin\upgrade路径下.
说明BIN文件说明:获取乐鑫手机APPhttp://www.
espressif.
com/zh-hans/support/download/apks.
Espressif"/"7182016.
08"2.
使用指南(2)登录后,点击页面左上角的菜单栏,选择"添加设备".
"图2-3.
菜单栏(3)进入"添加设备"页面后,在右上角点击选择"SoftAP配置".
"图2-4.
"添加设备"页面(4)乐鑫手机APP列出附近以"ESP"开头命名SSID的AP(ESP8266设备).
点击目标ESP8266设备,选择"使设备连接至云端".
"图2-5.
设备配置页面(5)输入路由器SSID和密码,ESP8266设备将连接路由器.
手机APP配置完成.
Espressif"/"8182016.
08"2.
使用指南"图2-6.
设备连接路由器5.
ESP8266设备通过路由器连接外网后,自动向乐鑫云激活认证.
激活认证成功后,登录乐鑫云,在设备页面右侧,可看到设备状态更新为"Activated".
6.
乐鑫云认证通过后,ESP8266智能灯将可享受乐鑫云端服务.
2.
4.
乐鑫云升级操作说明1.
通过用户名和密码登录乐鑫云(http://iot.
espressif.
cn/#/),点击"产品管理".

步骤结果登录乐鑫云,点击"设备开发".
点击进入设备"light-001",页面右侧,设备状态更新为"Activated",如右图所示.
说明:乐鑫云帮助文档http://iot.
espressif.
cn/#/help-zh-cn/.
乐鑫云API说明http://iot.
espressif.
cn/#/api-zh-cn/.
Espressif"/"9182016.
08"2.
使用指南2.
上传新版本的固件user1.
bin和user2.
bin到云端服务器.
步骤结果登录乐鑫云,点击"产品管理".
点击待升级的产品,例如,点击前文章节2.
2.
1创建的产品"ESP-light",如右图所示.
在产品页面右侧,看到"ROM发布".
说明:若使用ESP8266_NONOS_SDK\examples\IoT_Demo,要求固件版本号命名规则如本文附录,形如"v1.
1.
0t45772(a)",否则将升级失败.