2A-ESP8266__IOT_SDK_User_Manual__CN_v1.3.0

 
ESP8266SDKUserManualVersion1.3.0EspressifSystemsIOTTeamCopyright(c)2015 免责申明和版权公告本⽂文中的信息，包括供参考的URL地址，如有变更，恕不另⾏行通知。⽂文档“按现状”提供，不负任何担保责任，包括对适销性、适⽤用于特定⽤用途或⾮非侵权性的任何担保，和任何提案、规格或样品在他处提到的任何担保。本⽂文档不负任何责任，包括使⽤用本⽂文档内信息产⽣生的侵犯任何专利权⾏行为的责任。本⽂文档在此未以禁⽌止反⾔言或其他⽅方式授予任何知识产权使⽤用许可，不管是明⽰示许可还是暗⽰示许可。Wi-Fi联盟成员标志归Wi-Fi联盟所有。⽂文中提到的所有商标名称、商标和注册商标均属其各⾃自所有者的财产，特此声明。版权归©2015乐鑫信息科技（上海）有限公司所有。保留所有权利。EspressifSystemsConfidential/Friday,Aug7,2015224 TableofContents1.前⾔言 5...............................................................................................................2.开发⼯工具 6.......................................................................................................2.1.串⼝口⼯工具–SecureCRT 6..................................................................2.2.烧录⼯工具-FLASH_DOWNLOAD_TOOLS 6.....................................3.SDK软件包 8...................................................................................................4.编译 9...............................................................................................................4.1.编译esp_iot_sdk_v0.9.5及之后版本软件 9.....................................4.2.编译esp_iot_sdk_v0.9.4及之前版本软件 11...................................5.FlashMap 12...................................................................................................5.1.noneboot-不⽀支持云端升级 12.......................................................1.512KBflash 12..................................................................................2.1024KBflash 13................................................................................3.2048KBflash 14................................................................................4.4096KBflash 15................................................................................5.2.withboot-⽀支持云端升级 16............................................................1.512KBflash 16..................................................................................2.1024KBflash 16................................................................................3.2048KBflash 17................................................................................4.4096KBflash 18................................................................................6.烧录说明 19.....................................................................................................6.1.不⽀支持云端升级 19...........................................................................1.512KBFlash 19.................................................................................2.1024KBFlash 20..............................................................................3.2048KBFlash 20...............................................................................4.4096KBFlash 20...............................................................................6.2.⽀支持云端升级(FOTA) 21...................................................................1.512KBFlash 21.................................................................................2.1024KBFlash 21...............................................................................3.2048KBFlash 22...............................................................................4.4096KBFlash 22...............................................................................EspressifSystemsConfidential/Friday,Aug7,2015324 7.附录 23.............................................................................................................EspressifSystemsConfidential/Friday,Aug7,2015424 1.前⾔言本⽂文主要介绍基于ESP8266物联⺴⽹网模块的SDK相关使⽤用⽅方法，包括开发⼯工具使⽤用以及SDK软件包架构等。更多ESP8266的信息，请访问：新⼿手指南位于BBS=67&t=821EspressifSystemsConfidential/Friday,Aug7,2015524 2.开发⼯工具以下列出建议使⽤用的串⼝口⼯工具和烧录⼯工具，客户也可以选择使⽤用其他同样功能的⼯工具。串⼝口⼯工具，⽤用于打印信息，进⾏行调试；烧录⼯工具，⽤用于下载软件到flash中。2.1.串⼝口⼯工具–SecureCRTESP8266模块采⽤用74880波特率，需要在SecureCRT中进⾏行设置。2.2.烧录⼯工具-FLASH_DOWNLOAD_TOOLSEspressif官⽅方烧录⼯工具“ESP_FLASH_DOWNLOAD_TOOL”可在BBS下载。下载链接：=57&t=433该⼯工具实现了多个bin⽂文件的⼀一键烧录，将编译⽣生成的多个*.bin⽂文件⼀一次性下载到ESP8266⺟母板的SPIFlash中。ESP_FLASH_DOWNLOAD_TOOL的烧录使⽤用说明:1.烧录⽂文件勾选区：选择要烧录的bin⽂文件，以及设置对应的烧录地址；2.SPIFLASHCONFIG区：配置SPIFlash的属性，按键“CombineBin”将上述勾选了的bin⽂文件合成⼀一个target.bin，按键“Default”将SPIFlash的配置恢复默认值。3.Mac地址:ESP8266的MAC地址。ESP8266⺟母板上跳线设置为MTDO：0，GPIO0：0，GPIO2：1，进⼊入下载模式。操作步骤如下：•如下绿⾊色显⽰示区域，选择要烧录的bin⽂文件➝填写烧录地址➝勾选待烧录的选项。•设置COM⼝口和波特率。EspressifSystemsConfidential/Friday,Aug7,2015624 •点击START开始下载。•下载完成后，将⺟母板断电，修改跳线为运⾏行模式，上电正常运⾏行。⺟母板上跳线设置为MTDO：0，GPIO0：1，GPIO2：1，可进⼊入运⾏行模式。注意：进⾏行跳线操作时，请断电操作。EspressifSystemsConfidential/Friday,Aug7,2015724 3.SDK软件包SDK软件包中包含了进⾏行⼆二次开发所需的头⽂文件、库⽂文件以及其他编译所需的⽂文件，如下图：•“app⺫⽬目录为⽤用户⼯工作主⺫⽬目录，⽤用户级代码及头⽂文件均放在此⺫⽬目录下编译。•bin⺫⽬目录存放需下载到Flash的bin⽂文件，其中：‣at⽂文件夹-Espressif提供的⽀支持AT+指令的bin⽂文件；‣upgrade⽂文件夹-编译⽣生成的⽀支持云端升级的bin⽂文件（user1.bin或user2.bin）；‣“bin”⽂文件夹根⺫⽬目录–编译⽣生成的不⽀支持云端升级的bin⽂文件，和其他Espressif提供的bin⽂文件。•examples⺫⽬目录存放SDK的上层⽰示例代码，使⽤用时需将⼦子⺫⽬目录（例如IoT_Demo⺫⽬目录）下的所有内容到app⺫⽬目录下编译；•include⺫⽬目录为SDK⾃自带头⽂文件，包含了⽤用户可使⽤用的相关API函数及其他宏定义，⽤用户不需修改；•ld⺫⽬目录为SDK软件编译链接时所需