submitted | available | document details (if available) | source link |
---|---|---|---|
November 13 2017 | November 13 2017 | ESP-WROOM-02D_User_Guide__EN Mac OS X 10.12 Quartz PDFContext |
various | User manual | Users Manual | 2.47 MiB | November 13 2017 |
ESP-WROOM-02D User Guide Version 1.0 Copyright 2017 About This Guide This document takes ESP-WROOM-02D as examples to introduce how to use the ESP8266 SDK. The contents include preparations before compilation, SDK compilation and rmware download. Release Notes Date 2017.11 Version Release notes V1.0 First release. Table of Contents 1. ESP-WROOM-02D Overview
................................................................................................ 1 2. ESP-WROOM-02D Pin Description
....................................................................................... 2 3. Hardware Preparation for Compiling ESP-WROOM-02D 3.1. Hardware Preparation 3.2. Hardware Connection
.................................................... ............................................................................................................... ............................................................................................................... 4 4 4 4. Software Preparation for Compiling ESP-WROOM-02D 4.1. RTOS SDK 4.2. ESP8266 Toolkit 4.2.1. Compiler 4.2.2. Firmware Download Tool
..................................................... ................................................................................................................................ ........................................................................................................................ ....................................................................................................................... ............................................................................................. 6 6 8 8 10 5. Compiling the SDK 5.1. Preparations 5.1.1. Modifying SDK Files 5.1.2. Downloading SDK Files
.............................................................................................................. ............................................................................................................................ .................................................................................................... ............................................................................................... ............................................................................................................................. ...................................... .................................................. 5.2.1. Compile ESP8266_NONOS_SDK_v0.9.5 and Later Versions 5.2.2. ESP8266_NONOS_SDK_v0.9.4 and Earlier Versions 11 11 11 11 13 13 14 5.2. Compilation 6. Downloading the Firmware 6.1. Download Procedure 6.2. Check Log File 6.2.1. ESP8266 IOT Demo 6.2.2. ESP8266 AT
................................................................................................. .............................................................................................................. ........................................................................................................................ ................................................................................................... ............................................................................................................... ............................................................................. ........................................................................ ................................................................... .............................................................................................. 15 15 17 17 18 18 19 20 22 6.3.1. Conguration of RF InitCong Options 6.3.2. Conguration of RF InitCong Parameters 6.3.3. Conguration Examples 6.3. Conguration of RF initialization (Optional) 1. ESP-WROOM-02D Overview 1. ESP-WROOM-02D Overview The ESP-WROOM-02D is a new ESP8266EX-based module developed by Espressif. It differs from the ESP-WROOM-02 in that it is compatible both with 150-mil and 208-mil ash (with 150-mil ash embedded by default). The ESP-WROOM-02D also features optimized antenna and RF performance. Note:
For more information on ESP8266EX, please refer to ESP8266EX Datasheet. Table 1-1. ESP-WROOM-02D Specications Categories Items Wi-Fi Wi-Fi protocols Frequency range Peripheral interface Operating voltage Hardware Operating current Minimum current delivered by power supply Operating temperature range Storage temperature Package size External interface Wi-Fi mode Security Encryption Software Firmware upgrade Software development Network protocols User conguration Specications 802.11 b/g/n 2.4 GHz ~ 2.5 GHz (2400M ~ 2483.5M) UART/HSPI/I2C/I2S/IR Remote Control GPIO/PWM 2.7V ~ 3.6V Average: 80 mA 500 mA
-40C ~ 85C
-40C ~ 85C
(180.2) mm x (200.2) mm x (3.20.15) mm
-
Station/SoftAP/SoftAP+Station WPA/WPA2 WEP/TKIP/AES UART Download/OTA (via network)/Download and write rmware via host Supports Cloud Server Development/SDK for custom rmware development IPv4, TCP/UDP/HTTP/FTP AT Instruction Set, Cloud Server, Android/iOS app Espressif
" /"1 23 2017.11
"
2. 2. ESP-WROOM-02D Pin Description ESP-WROOM-02D Pin Description Figure 2-1 shows the pin distribution of the ESP-WROOM-02D. PCB ANTENNA 19GND 1 2 3 4 5 6 7 8 9 3V3 EN IO14 IO12 IO13 IO15 IO2 IO0 GND GND IO16 TOUT RST IO5 GND TXD RXD IO4 18 17 16 15 14 13 12 11 10 ESP-WROOM-02D has 18 pins. Please see the pin denitions in Table 2-1. Figure 2-1. ESP-WROOM-02D Pin Layout Table 2-1. ESP-WROOM-02D Pin Denitions No. Pin Name 1 2 3 4 5 6 3V3 EN IO14 IO12 IO13 IO15 Functional Description 3.3V power supply (VDD) Note:
It is recommended the maximum output current a power supply provides be of 500 mA or above. Chip enable pin. Active high. GPIO14; HSPI_CLK GPIO12; HSPI_MISO GPIO13; HSPI_MOSI; UART0_CTS GPIO15; MTDO; HSPICS; UART0_RTS Pull down. Espressif
" /"2 23 2017.11
"
"
No. Pin Name 7 8 9 10 11 12 13 14 15 16 17 18 IO2 IO0 GND IO4 RXD TXD GND IO5 RST TOUT IO16 GND 2. ESP-WROOM-02D Pin Description Functional Description GPIO2; UART1_TXD Floating (internal pull-up) or pull up. GPIO0 UART download: pull down. Flash boot: oating or pull up. GND GPIO4 UART0_RXD, receive end in UART download;
GPIO3 UART0_TXD, transmit end in UART download, oating or pull up;
GPIO1 GND GPIO5 Reset It can be used to test the power-supply voltage of VDD3P3 (Pin3 and Pin4) and the input power voltage of TOUT (Pin6). These two functions cannot be used simultaneously. GPIO16; used for Deep-sleep wake-up when connected to RST pin. GND Espressif
" /"3 23 2017.11
"
3. Hardware Preparation for Compiling ESP-WROOM-02D 3. Hardware Preparation for Compiling ESP-WROOM-02D 3.1. Hardware Preparation ESP-WROOM-02D module USB-to-TTL converter (FT232R recommended) PC for programming: Windows XP or Windows 7 OS is recommended, with enough RAM to run a Linux virtual machine. Micro-USB cable 3.2. Hardware Connection 1. Lead out the pins of the ESP-WROOM-02D, as shown in Table 2-2. Pin EN 3V3 IO15 IO0 GND RXD TXD Table 2-2. ESP-WROOM-02D Pins Pin status Pull up 3.3V power supply (VDD) Pull down UART download: pull down;
Flash boot: oating/pull up GND Receive-end in UART download Transmit-end in UART download; oating/pull up 2. Connect ESP-WROOM-02D to the USB-to-TTL converter, using Dupont lines, as shown in Figure 2-1. ESP-WROOM-02 3V3 EN RXD TXD GND IO15 IO0 USB-to-TTL converter 3V3 TXD RXD GND PC Espressif
" /"4 23 2017.11
"
!
!
3. Hardware Preparation for Compiling ESP-WROOM-02D Figure 2-1. ESP-WROOM-02D Download Mode 3. Connect the USB-to-TTL converter to the PC. 4. Download rmware to ash with the ESP8266 DOWNLOAD TOOL. Note:
On how to download rmware, please refer to Chapter 4, "Flash Maps" and Chapter 6, "Downloading the Firmware". 5. After downloading, switch ESP-WROOM-02U to working mode. Set IO0 as oating or pull-up. 6. Power on ESP-LAUNCHER again and the chip will read and run programs from the ash. Notes:
IO0 is an internal pull-up pin. For more information on ESP-WROOM-02U hardware, please refer to ESP8266 System Description and ESP-WROOM-02 Datasheet. Espressif
" /"5 23 2017.11
"
4. Software Preparation for Compiling ESP-WROOM-02D 4. Software Preparation for Compiling ESP-WROOM-02D Users can download the non-OS SDK (including application examples) from:
http://www.espressif.com/en/support/download/sdks-demos?
keys=&eld_type_tid%5B%5D=14. Figure 3-1 shows the directory structure of the non-OS SDK. Figure 3-1. Non-OS SDK Directory Structure bin: compiled binaries to be downloaded directly into the flash. documents: SDK-related documents or links. driver_lib: library les that drive peripherals, such as UART, I2C and GPIO. examples: sample codes for secondary development, for example, IoT Demo. include: header les pre-installed in SDK. The les contain relevant API functions and other macro denitions. Users do not need to modify them. ld: linker scripts. We suggest users not modifying them without any specic reasons. lib: library les provided in SDK. tools: tools needed for compiling binaries. Users do not need to modify them. 4.1. RTOS SDK Users can download RTOS SDK and its application examples (ESP8266_IOT_PLATFORM) from:
RTOS SDK https://github.com/espressif/ESP8266_RTOS_SDK Espressif
" /"6 23 2017.11
"
"
4. Software Preparation for Compiling ESP-WROOM-02D ESP8266_IOT_PLATFORM https://github.com/espressif/ESP8266_IOT_PLATFORM Table 3-2 shows the directory structure of the RTOS SDK. Figure 3-2. RTOS SDK Directory Structure bin: boot and initialization rmware. documents: ESP8266_RTOS_SDK les. driver_lib: sample codes of drivers. examples: sample codes for Espressifs application programs.
- openssl_demo: sample codes of the openssl API function.
- project_template: sample codes of project templates.
- smart_config: sample codes of SmartCong.
- spiffs_test: sample codes of the spiffs le system function.
- websocket_demo: sample codes of web socket. include: header les of ESP8266_RTOS_SDK, including software interfaces and macro functions for users to use. ld: link les used when compiling; users do not need to modify them. lib: library le of ESP8266_RTOS_SDK. third_party: third-party library of Espressifs open-source codes, currently including free RTOS, JSON, lwIP, mbedTLS, noPoll, OpenSSL, spiffs, and SSL. tools: tools needed for compiling binaries; users do not need to modify them. Espressif
" /"7 23 2017.11
"
"
4. Software Preparation for Compiling ESP-WROOM-02D 4.2. ESP8266 Toolkit 4.2.1. Compiler Please download VirtualBox from: https://www.virtualbox.org/wiki/Downloads. Note:
Please choose the right version of VirtualBox according to the host machine's OS. Please download the compiler ESP8266_lubuntu_20141021.ova from:
http://downloads.espressif.com/FB/ESP8266_GCC.zip Steps Results 1. Start Windows OS and install the virtual machine. Double-click VirtualBox-5.0.16-105871-Win.exe and install VirtualBox. Note:
VirtualBox has different versions. We are using Windows V.5.0.16 as an example. Double-click Oracle VM VirtualBox.exe to run the program, and the system will show the main menu . Tip:
The ESP8266 virtual machine takes up much space (memory). Please reserve enough space for it. 2. Import the image le. Espressif
" /"8 23 2017.11
"
"
4. Software Preparation for Compiling ESP-WROOM-02D Steps Results Select File > Import Appliance, and a dialog box will show up . Select the image le to import, for example, C:
\ESP8266_lubuntu_20141021.ova, and click Next. Click Import to conrm the settings. 3. Create a shared folder. Create a new folder named D:
\VM\share. Select Machine > Settings >
Shared Folders, and a dialog box will show up . Select the shared folder in Machine Folders, for example, D:\VM\share. 4. Run the virtual machine. Espressif
" /"9 23 2017.11
"
4. Software Preparation for Compiling ESP-WROOM-02D Steps Results After importing, a virtual machine named ESP8266_lubuntu shows up
. Double-click ESP8266_lubuntu or Start to run the virtual machine. The system shows the ESP8266 virtual machine . If a dialog box like the one below shows up, please enter the password: espressif. 4.2.2. Firmware Download Tool Please download the ESP8266 DOWNLOAD TOOL from:
http://www.espressif.com/support/download/other-tools. Espressif
/"10 23 2017.11
"
"
"
5. Compiling the SDK Compiling the SDK 5. 5.1. Preparations 1. Modifying SDK Files Note:
Users need to modify the SDK les if using the OTA rmware. 1. Start Windows OS. 2. Modify les in ESP8266_NONOS_SDK/examples/IoT_Demo/include according to the ash map. Modify #define PRIV_PARAM_START_SEC in user_light.h and user_plug.h. Modify #define ESP_PARAM_START_SEC in user_esp_platform.h. Table 5-1 lists the modied values. Table 5-1. Modify the Field Values in the "include" File (unit: kB) Modied values 512 1024 2048 2048 4096 4096 8192 16384
(512+512)
(1024+1024)
(512+512)
(1024+1024)
(1024+1024)
(1024+1024)
-
-
0x7C 0x7D 0x7C 0x7D 0xFC 0xFD 0x7C 0x7D 0xFC 0xFD 0xFC 0xFD 0xFC 0xFD Default value
(512) 0x3C 0x3D Note:
Users need not modify the SDK les if using a 512-KB ash. 2. Downloading SDK Files 1. Start Linux OS. 2. Run LXTerminal on the desktop of the virtual machine. Espressif
/"11 23 2017.11
"
"
"
"
3. Copy the les to be compiled to the shared folder. Steps Results 5. Compiling the SDK Copy ESP8266_NONOS_SDK folder to the shared directory, for example, C:\VM\share. Copy IoT_Demo folder to C:
\VM\share\ESP8266_NONOS_SDK, as shown in the gure on the right . 4. Download shared directory. Steps Results Execute ./mount.sh. Input the password: espressif. Downloading shared les is completed. Open the shared directory ESP8266_NONOS_SDK in the virtual machine and conrm whether the download has been successful.
-
If successful, the directory contains such les as those in the gure on the right . If not, the directory will be empty, and users will need to go over this step again.
-
Notice:
If users use the RTOS SDK, please continue with the following steps; if use the non-OS SDK, please skip Step 5. 5. Set the variable PATH to point to SDK and binaries. export SDK_PATH=~/Share/ESP8266_RTOS_SDK export BIN_PATH=~/Share/ESP8266_RTOS_SDK/bin Note:
Users can add it to .bashrc le, otherwise Step 5 needs to be repeated each time the compiler is restarted. Espressif
/"12 23 2017.11
"
"
5.2. Compilation 5.2.1. Compile ESP8266_NONOS_SDK_v0.9.5 and Later Versions 2. Switch to the /Share/ESP8266_NONOS_SDK/IoT_Demo directory in the terminal. 5. Compiling the SDK cd /home/esp8266/Share/ESP8266_NONOS_SDK/IoT_Demo
./gen_misc.sh The system shows the following information:
gen_misc.sh version 20150511 Please follow below steps(1-5) to generate specific bin(s):
3. Select the required options as shown in Figure 5-1. FOTA?
Y New version?
N 0 First-time usage?
Y 1 1 N Y 1 1 2 2 2 0 STEP 1: choose boot version
(0=boot_v1.1, 1=boot_v1.2+, 2=none) enter(0/1/2, default 2) STEP 2: choose bin generate
(0=eagle.ash.bin+eagle.irom0text.bin
, 1=user1.bin, 2=user2.bin) enter (0/1/2, default 0) Choose as required 3 STEP 3: choose spi speed
(0=20MHz, 1=26.7MHz, 2=40MHz, 3=80MHz) enter (0/1/2/3, default 2) Choose as required 3 STEP 4: choose spi mode
(0=QIO, 1=QOUT, 2=DIO, 3=DOUT) enter (0/1/2/3, default 0) Choose as required 2 3 4 5 6 STEP 5: choose spi size and map 0= 512KB( 256KB+ 256KB) enter (0/2/3/4/5/6, default 0) Example Option Figure 5-1. Compile SDK N 2 0 0 0 Espressif
/"13 23 2017.11
"
"
"
5. Compiling the SDK Notes:
The sample options are marked in green. Users can select the right options as needed. For OTA and non-OTA rmware, please refer to Section 1.4, "ESP8266 FW". Only sdk_v1.1.0 + boot 1.4 + ash download tool_v1.2 and higher versions support options 5 and 6 in Step 5. After compiling user1.bin, execute make clean rst to clear the temporary les generated by the last compilation, and then compile user2.bin. For the ash map in Step 5, please refer to Chapter 4, "Flash Maps". 4. After compilation, the generated binaries and the addresses in ash are shown as follows:
Generate user1.2048.new.3.bin successfully in folder bin/upgrade. boot.bin------------>0x00000 user1.2048.new.3.bin--->0xSupport boot_v1.2 and +
01000
!!!
Note:
Users can open the /home/esp8266/Share/ESP8266_NONOS_SDK/bin directory and check the compiled binaries. 5.2.2. ESP8266_NONOS_SDK_v0.9.4 and Earlier Versions For ESP8266_NONOS_SDK_v0.9.4 and previous versions, the compilation process is as follows:
1. Execute ./gen_misc_plus.sh 1 to generate user1.bin under the
/ESP8266_NONOS_SDK/bin/upgrade path. 2. Execute make clean to clear previous compilation data. 3. Execute ./gen_misc_plus.sh 2 to generate user2.bin under the
/ESP8266_NONOS_SDK/bin/upgrade path. Note:
ESP8266_NONOS_SDK_v0.7 and earlier are non-OTA rmware. Espressif
/"14 23 2017.11
"
"
6. Downloading the Firmware 6. Downloading the Firmware 6.1. Download Procedure 1. Start Windows OS. 2. Double-click ESP_DOWNLOAD_TOOL.exe to open Flash tool. Figure 6-1. ESP8266 DOWNLOAD TOOLSPIDownload SPIDownload For SPI Flash download. HSPIDownload For HSPI Flash download. RFCong RF initialization Conguration. MutiDownload For multi-mother boards download. Espressif
/"15 23 2017.11
"
"
6. Downloading the Firmware 3. Double-click "
in Download Path Config panel to select the binaries to be downloaded. Set the corresponding download addresses in ADDR. 4. Congure SPIDownload. Note:
The binaries to be downloaded and the corresponding addresses vary with different SPI Flash sizes and actual demands. For details, please refer to Chapter 4, "Flash Maps". Items Table 6-1. SPIDownload Conguration Description SPI FLASH CONFIG CrystalFreq Select the crystal frequency according to the crystal oscillator used. CombineBin Combine the selected binaries into target.bin with the address 0x0000. Default SPI SPEED SPI MODE FLASH SIZE SpiAutoSet DoNotChgBin Set the SPI Flash to the default value. Select SPI read/write speed with the maximum value of 80 MHz. Select SPI mode according to the SPI Flash used. If the ash is Dual SPI, select DIO or DOUT. If the ash is Quad SPI, select DIO or DOUT. Notice:
If ISSI Flash is used, please refer to Appendix, "Congure ISSI & MXIC Flash QIO Mode". Select the ash size according to the ash type. Note:
16Mbit-C1 refers to 1024+1024 ash map and 32Mbit-C1 1024+1024 ash map as well. We recommend not checking SpiAutoSet, but conguring the flash manually as needed. If users select SpiAutoSet, the binaries will be downloaded according to the default ash map. The ash map of 16 Mbit and 32 Mbit will be 512 KByte + 512 KByte. If users select DoNotChgBin, the ash working frequency, mode, and ash map will be based on the conguration when compiling. If users do not select DoNotChgBin, the ash working frequency, mode, and ash map will be dened by the nal conguration of the compiler. Download Panel START STOP MAC Address Click START to start download. When the download completes, FINISH will appear in the green area on the left. Click STOP to stop download. If download is successful, the system will show the MAC addresses of ESP8266 STA and ESP8266 AP. COM PORT Select the actual COM port of ESP8266. Espressif
/"16 23 2017.11
"
"
6. Downloading the Firmware Items Description SPI FLASH CONFIG BAUDRATE Select the baud rate of downloading. The default value is 115200. 5. After downloading, turn GPIO0 Control on ESP-LAUNCHER to the outer side and power the board on to enable the working mode. 6.2. Check Log File After downloading rmware, users can check the log printed in the terminal by using the serial port debug tool. Users need to congure the settings of the serial port debug tool, as follows:
Table 6-2. Serial Port Debug Tool Conguration Items Protocol Serial port. Conguration Description Port number Set the port number according to the connected device. Baud rate The baud rate at which the device is running, related to the crystal oscillator. 69120 (24 M crystal oscillator) 74880 (26 M crystal oscillator) 115200 (40 M crystal oscillator) The ESP8266 AT example supports the baud rate of 115200 by default. Users cannot modify it. The ESP8266 IOT Demo example supports the baud rate of 74880. Users can modify it. Data bit Calibration Flow control 8 None. None. 6.2.1. ESP8266 IOT Demo If users download ESP8266 IOT Demo rmware, the system in working mode will show the initialization information including the SDK version, etc. Finish means the rmware works properly. SDK version:X.X.X(e67da894) IOT VERSION = v1.0.5t45772(a) reset reason: 0 PWM version: 00000003 mode: sta(18:fe:34:a4:8c:a3) + softAP(1a:fe:34:a4:8c:a3) Espressif
/"17 23 2017.11
"
"
6. Downloading the Firmware add if0 add if1 dhcp server start:(ip:192.168.4.1,mask:255.255.255.0,gw:192.168.4.1) bcn 100 finish 6.2.2. ESP8266 AT If users download the ESP8266 AT rmware, or the default rmware in ESP-LAUNCHER or ESP-WROOM-02U, the system in working mode will display Ready at the end. Input command AT in the terminal and the system will return OK, which means that the rmware works properly. Notes:
The baud rate in AT rmware is congured as 115200 manually, however, the default baud rate of ESP8266 is 74880, due to this discrepancy, the system initialization information will be displayed as mojibake. It is a normal phenomenon as long as the system shows Ready at the end. For more information on AT commands, please refer to ESP8266 AT Instruction Set. 6.3. Conguration of RF initialization (Optional) Before downloading binaries to ash, users can modify the RF initialization settings in the RF InitConfig tab. The newly-generated esp_init_data_setting.bin can be downloaded to the ash instead of esp_init_data_default.bin. Users can congure both the options and the parameters of the RF settings. Espressif
/"18 23 2017.11
"
"
6. Downloading the Firmware Figure 6-2. ESP8266 DOWNLOAD TOOL - RF InitCong 6.3.1. Conguration of RF InitCong Options RF InitCong options are listed in the upper part of Figure 6-2. Please refer to Table 6-3 for a description of this conguration. Table 6-3. Conguration of RF InitCong Options Items Description TxTargetPowerCong Users need not congure this. It varies with the options in LowPowerMode. LowPowerMode CrystalFreq Congure the low power mode as required. LowPowerEn: enable low power mode, set a power value for all data rates. PowerLimtEn: set a limit for output power. BackOEn: set backoff value for each data rate. Note:
Users cannot congure LowPowerEn and PowerLimtEn at the same time. Select the crystal oscillator frequency according to the crystal oscillator used. Note:
If a different option is selected when downloading, it will override this conguration. Espressif
/"19 23 2017.11
"
!
"
Items Description 6. Downloading the Firmware TOUT PinConf FreqOset RFInt mode Congure the TOUT pin according to the actual TOUT pin status. We recommend the default value. TOUT_ADC_EN: When the TOUT pin connects to an external circuit, measure the external voltage (0V - 1V) through the internal ADC. TOUT_VDD_EN: When TOUT pin is left oating, measure VDD33 voltage through uint16 system_get_vdd33(void). Notice:
Users cannot congure TOUT_ADC_EN and TOUT_VDD_EN at the same time. When users use TOUT_ADC_EN, they need to input the actual voltage on VDD3P3 pin 3 and pin 4. SetFreqEnable: Set the frequency offset manually.
- PracticalFreqOset: the option is valid when selecting SetFreqEnable. AutoCalEn: Set the frequency offset automatically. Users can select the RF initialization mode:
LoadRFCalParam: During the RF initialization, RF data are loaded directly from the ash without any calibration. It takes about 2 ms and the least initial current. TxPwrCtrl in init: During the RF initialization, only Tx Power calibration will be performed, and other data are loaded from ash. It takes about 20 ms and small initial current. FullRFCal in RFInit: All calibrations are performed during the RF initialization. It takes 200 ms and large initial current. 6.3.2. Conguration of RF InitCong Parameters RF InitConfig parameters are listed in the lower part of Figure 6-2. The description of parameters conguration is shown in Table 6-4. Table 6-4. Conguration of RF InitCong Parameters Description The byte in esp_init_data_setting.bin (0 ~ 127 byte). For example, A = 0 represents Byte 0 in esp_init_data_setting.bin. The item name. Users cannot modify it if marked as Reserved. The item name. Users cannot modify it if marked as Reserved. Data types of conguration items, including unsigned and signed data types. The hexadecimal value of a conguration item. Items A B C D E Notice:
Please do not modify the parameters marked as Reserved. Espressif
/"20 23 2017.11
"
"
The following section introduces how to modify the 112 ~ 114 byte parameters. Figure 6-3 shows the initial conguration. 6. Downloading the Firmware Figure 6-3. 112 114 Byte Parameters Modify the RF Initialization Parameters Byte 114 is used to control THE RF initialization when ESP8266 is powered on. Table 6-5 provides the parameter conguration. Note:
Supported by ESP8266_NONOS_SDK_V1.5.3 and ESP8266_RTOS_SDK_V1.3.0 and higher. Option byte 114 = 0 byte 114 = 1 Table 6-5. Modify RF Initialization Parameters Description Only a VDD33 calibration is performed during the RF initialization. It takes about 2 ms and the least initial current. The default value is 1. VDD33 and TX power calibrations are performed during the RF initialization. It takes about 18 ms and small initial current. byte 114 = 2 The same as when byte 114 = 0. byte 114 = 3 All calibrations are performed during the RF initialization. It takes about 200 ms and large initial current. Correct Frequency Offset Byte 112 and byte 113 relate to the frequency offset correction. Table 6-6 provides the parameter conguration. Note:
Supported by ESP8266_NONOS_SDK_V1.4.0 and ESP8266_RTOS_SDK_V1.3.0 and higher. Table 6-6. Options for Frequency Offset Correction Option bit 0 Description The default value of byte 112 is 0. This bit is of the highest priority. bit 0 = 0: frequency offset cannot be corrected. bit 0 = 1: frequency offset can be corrected. Espressif
/"21 23 2017.11
"
!
"
6. Downloading the Firmware Option bit 1
{bit 3bit 2}
Description The default value of byte 112 is 0. When value = 0, it means that the bbpll is 168 M. Both positive and negative frequency offsets can be corrected. However, this may effect the digital peripheral performance and, therefore, it is not recommended. When value = 1, it means that the bbpll is 160 M. Only the positive frequency offset can be corrected. When value = 0, it means that the chip will track and correct the frequency offset automatically. The initial correction value is 0. When value = 1, it means that the chip is manually programmed to change the frequency offset to that of byte 113, so the chip will not track and correct the frequency offset automatically. When value = 2, it means that the chip will track and correct the frequency offset automatically. The initial correction value is that of byte 113. The default value of byte 113 is 0. 113 byte It is the value when the frequency offset is corrected manually or the initial correction value in frequency tracking. The data type is sign int8, in multiples of 8 kHz. 6.3.3. Conguration Examples The conguration of bytes 112 and 113 depends depends on users' specic needs. We provide some examples below:
1. The module works at ambient temperature, and needs no correction of the frequency offset. Set byte 112 = 0, byte 113 = 0. 2. The module works at ambient temperature and needs no automatic tracking and correction of the frequency offset; yet the frequency offset is large. In this case, a manual correction of the frequency offset is recommended. If the frequency offset is +160 KHz (at ambient temperature), users can set byte 112
= 0x07, byte 113 = (256 - 160/8) = 236 = 0xEC. If the frequency offset is -160 KHz (at ambient temperature), users can set byte 112 =
0x05, byte 113 = 160/8 = 20 = 0x14. This may effect the digital peripheral performance, so we do not recommend it. 3. Applications, such as smart lights, work at a wide temperature range of -40 C to 125 C, and need to track and correct the frequency offset automatically. The frequency offset at ambient temperature is small, so the initial offset correction value is not needed. Set byte 112 = 0x03, byte 113 = 0. Espressif
/"22 23 2017.11
"
"
6. Downloading the Firmware 4. Applications, such as smart lights, work at a wide temperature range of -40 C to 125 C, and need to track and correct the frequency offset automatically. The frequency offset at ambient temperature is large, so the initial offset correction value is needed. If the frequency offset is +160 kHz (at ambient temperature), users can set byte 112
= 0x0B, byte 113 = (256 - 160/8) = 236 = 0xEC. If the frequency offset is -160 kHz (at ambient temperature), users can set byte 112
= 0x09, byte 113 = 160/8 = 20 = 0x14. But this may effect the digital peripheral performance and needs substantive tests, so we do not recommend it. We recommend Example 3. When the conguration of RF initialization is done, click GenInitBin button to generate esp_init_data_setting.bin. In addition, users can click Default button to set the value of frequency offset to default, or click LoadInitBin button to import a binary le for conguration. Espressif
/"23 23 2017.11
"
"
Disclaimer and Copyright Notice Information in this document, including URL references, is subject to change without notice. THIS DOCUMENT IS PROVIDED AS IS WITH NO WARRANTIES WHATSOEVER, INCLUDING ANY WARRANTY OF MERCHANTABILITY, NON-INFRINGEMENT, FITNESS FOR ANY PARTICULAR PURPOSE, OR ANY WARRANTY OTHERWISE ARISING OUT OF ANY PROPOSAL, SPECIFICATION OR SAMPLE. All liability, including liability for infringement of any proprietary rights, relating to use of information in this document is disclaimed. No licenses express or implied, by estoppel or otherwise, to any intellectual property rights are granted herein. The Wi-Fi Alliance Member logo is a trademark of the Wi-Fi Alliance. The Bluetooth logo is a registered trademark of Bluetooth SIG. All trade names, trademarks and registered trademarks mentioned in this document are property of their respective owners, and are hereby acknowledged. Copyright 2017 Espressif Inc. All rights reserved. Espressif IOT Team www.espressif.com FCCLabel:TheFCCIDisonthefrontofthedevice.Itiseasilyvisible. ThedeviceFCCIDis2AC7ZESPWROOM02D. Alabelwiththefollowingstatementsmustbeattachedtothehostendproduct:
ThisdevicecontainsFCCID:2AC7ZESPWROOM02D. Themanualprovidesguidancetothehostmanufacturerwillbeincludedinthedocumentationthatwill beprovidedtotheOEM. Themoduleislimitedtoinstallationinmobileorfixedapplications. Theseparateapprovalisrequiredforallotheroperatingconfigurations,includingportableconfigurations anddifferentantennaconfigurations. The OEM integrators are responsible for ensuring that the enduser has no manual or instructions to removeorinstallmodule. ThemoduleislimitedtoOEMinstallationONLY. Module grantee (the party responsible for the module grant) shall provide guidance to the host manufacturerforensuringcompliancewiththePart15SubpartBrequirements. Thehostmanufacturerisresponsibleforadditionaltestingtoverifycomplianceasacompositesystem. When testing the host device for compliance with the Part 15 Subpart B requirements, the host manufacturerisrequiredtoshowcompliancewiththePart15SubpartBwhilethetransmittermodule(s) areinstalledandoperating.Themodulesshouldbetransmittingandtheevaluationshouldconfirmthat themodulesintentionalemissionsarecompliant(i.e.fundamentalandoutofbandemissions)withthe Radio essential requirements. The host manufacturer must verify that there are no additional unintentionalemissionsotherthanwhatispermittedinthePart15SubpartBoremissionsarecomplaint withtheRadioaspects. CAUTION:
Anychangesormodificationsnotexpresslyapprovedbythegranteeofthisdevicecouldvoidtheusers authoritytooperatetheequipment. FCCRFExposureRequirements ThisdevicecomplieswithFCCRFradiationexposurelimitssetforthforanuncontrolledenviroment. The antenna(s) used for this transmitter must not be colocated or operating in conjunction with any otherantennaortransmitterandmustbeinstalledtoprovideaseparationdistanceofatleast20cmfrom allpersons. FCCRegulations Thisdevicecomplieswithpart15oftheFCCRules.Operationissubjecttothefollowingtwoconditions:
(1) This device may not cause harmful interference, and (2) this device must accept any interference received,includinginterferencethatmaycauseundesiredoperation. ThisdevicehasbeentestedandfoundtocomplywiththelimitsforaClassBdigitaldevice,pursuantto Part15oftheFCCRules. Theselimitsaredesignedtoprovidereasonableprotectionagainstharmfulinterferenceinaresidential installation.Thisequipmentgenerates,usesandcanradiateradiofrequencyenergyand,ifnotinstalled andusedinaccordancewiththeinstructions,maycauseharmfulinterferencetoradiocommunications. Canada Regulations:
This device complies with Industry Canadas licence-exempt RSSs. Operation is subject to the following two conditions:
(1) This device may not cause interference; and
(2) This device must accept any interference, including interference that may cause undesired operation of the device. Le prsentappareilestconforme aux CNR dIndustrie Canada applicables aux appareils radio exempts de licence. Lexploitationestautorise aux deux conditions suivantes :
(1) lappareil ne doit pas produire de brouillage;
(2) lutilisateur de lappareildoit accepter tout brouillageradiolectriquesubi, mmesi le brouillageest susceptible dencompromettre le fonctionnement. Caution A label with the following statements must be attached to the host end product: This device contains IC:
21098ESPWROOM02D. Themanualprovidesguidancetothehostmanufacturerwillbeincludedinthedocumentationthatwillbe providedtotheOEM. Themoduleislimitedtoinstallationinmobileorfixedapplications. Theseparateapprovalisrequiredforallotheroperatingconfigurations,includingportableconfigurationsand differentantennaconfigurations. TheOEMintegratorsareresponsibleforensuringthattheenduserhasnomanualorinstructionstoremove orinstallmodule. ThemoduleislimitedtoOEMinstallationONLY. Unetiquetteaveclesinstructionssuivantesdoittreattacheauproduitfinalhte:
CetappareilcontientIC:21098ESPWROOM02D. Lemanuelfournitdesconseilsaufabricanthteserainclusdansladocumentationquiserafourniel'OEM. Lemoduleestlimitl'installationdansdesapplicationsmobilesoufixes. L'approbation distincte estrequise pourtoutes les autres configurations de fonctionnement, ycompris les configurationsportablesetdiffrentesconfigurationsd'antenne. Les intgrateurs OEM sont responsables de s'assurer que l'utilisateur n'a pas de manuel ou d'instructions pourretirerouinstallerlemodule. Lemoduleestlimitl'installationOEMSEULEMENT.
This product uses the FCC Data API but is not endorsed or certified by the FCC