Skip to content

Commit 4ca084e

Browse files
author
Me No Dev
committed
Merge remote-tracking branch 'esp8266/master' into www-basic-auth
2 parents 12c71aa + 6186383 commit 4ca084e

File tree

18 files changed

+1221
-1148
lines changed

18 files changed

+1221
-1148
lines changed

README.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,12 +23,12 @@ If you find this ESP8266 board manager useful, please consider supporting it wit
2323
##### Stable version ![](http://arduino.esp8266.com/stable/badge.svg)
2424
Boards manager link: `http://arduino.esp8266.com/stable/package_esp8266com_index.json`
2525

26-
Documentation: [Reference](http://arduino.esp8266.com/stable/doc/reference.html)
26+
Documentation: [http://esp8266.github.io/Arduino/versions/2.0.0/](http://esp8266.github.io/Arduino/versions/2.0.0/)
2727

2828
##### Staging version ![](http://arduino.esp8266.com/staging/badge.svg)
2929
Boards manager link: `http://arduino.esp8266.com/staging/package_esp8266com_index.json`
3030

31-
Documentation: [Reference](http://arduino.esp8266.com/staging/doc/reference.html)
31+
Documentation: [http://esp8266.github.io/Arduino/versions/2.0.0-rc2/](http://esp8266.github.io/Arduino/versions/2.0.0-rc2/)
3232

3333
### Using git version [![Linux build status](https://travis-ci.org/esp8266/Arduino.svg)](https://travis-ci.org/esp8266/Arduino)
3434

@@ -51,9 +51,11 @@ python get.py
5151
Documentation for latest development version:
5252

5353
- [Reference](doc/reference.md)
54+
- [Libraries](doc/libraries.md)
55+
- [File system](doc/filesystem.md)
56+
- [OTA update](doc/ota_updates/ota_updates.md)
5457
- [Supported boards](doc/boards.md)
5558
- [Change log](doc/changes.md)
56-
- [OTA Update](doc/ota_updates/ota_updates.md)
5759

5860
### Issues and support ###
5961

doc/boards.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -3,27 +3,27 @@ title: Supported Hardware
33
---
44

55
## Table of contents
6-
* [Adafruit HUZZAH ESP8266 (ESP\-12)](#adafruit-huzzah-esp8266-esp-12)
7-
* [NodeMCU 0\.9 <a name="user\-content\-nodemcu\-0\-9"></a>](#nodemcu-09-)
8-
* [Pin mapping](#pin-mapping)
9-
* [NodeMCU 1\.0](#nodemcu-10)
10-
* [Olimex MOD\-WIFI\-ESP8266\-DEV](#olimex-mod-wifi-esp8266-dev)
11-
* [Olimex MOD\-WIFI\-ESP8266](#olimex-mod-wifi-esp8266)
12-
* [SparkFun ESP8266 Thing](#sparkfun-esp8266-thing)
13-
* [SweetPea ESP\-210](#sweetpea-esp-210)
14-
* [Generic ESP8266 modules](#generic-esp8266-modules)
15-
* [Serial Adapter](#serial-adapter)
16-
* [Minimal Hardware Setup for Bootloading and Usage](#minimal-hardware-setup-for-bootloading-and-usage)
17-
* [ESP to Serial](#esp-to-serial)
18-
* [Minimal Hardware Setup for Bootloading only](#minimal-hardware-setup-for-bootloading-only)
19-
* [Minimal Hardware Setup for Running only](#minimal-hardware-setup-for-running-only)
20-
* [Minimal](#minimal)
21-
* [Improved Stability](#improved-stability)
22-
* [Boot Messages and Modes](#boot-messages-and-modes)
23-
* [rst cause](#rst-cause)
24-
* [boot mode](#boot-mode)
25-
* [WeMos D1](#wemos-d1)
26-
* [WeMos D1 mini](#wemos-d1-mini)
6+
* [Adafruit HUZZAH ESP8266 (ESP\-12)](#adafruit-huzzah-esp8266-esp-12)
7+
* [NodeMCU 0\.9 <a name="user\-content\-nodemcu\-0\-9"></a>](#nodemcu-09-)
8+
* [Pin mapping](#pin-mapping)
9+
* [NodeMCU 1\.0](#nodemcu-10)
10+
* [Olimex MOD\-WIFI\-ESP8266\-DEV](#olimex-mod-wifi-esp8266-dev)
11+
* [Olimex MOD\-WIFI\-ESP8266](#olimex-mod-wifi-esp8266)
12+
* [SparkFun ESP8266 Thing](#sparkfun-esp8266-thing)
13+
* [SweetPea ESP\-210](#sweetpea-esp-210)
14+
* [Generic ESP8266 modules](#generic-esp8266-modules)
15+
* [Serial Adapter](#serial-adapter)
16+
* [Minimal Hardware Setup for Bootloading and Usage](#minimal-hardware-setup-for-bootloading-and-usage)
17+
* [ESP to Serial](#esp-to-serial)
18+
* [Minimal Hardware Setup for Bootloading only](#minimal-hardware-setup-for-bootloading-only)
19+
* [Minimal Hardware Setup for Running only](#minimal-hardware-setup-for-running-only)
20+
* [Minimal](#minimal)
21+
* [Improved Stability](#improved-stability)
22+
* [Boot Messages and Modes](#boot-messages-and-modes)
23+
* [rst cause](#rst-cause)
24+
* [boot mode](#boot-mode)
25+
* [WeMos D1](#wemos-d1)
26+
* [WeMos D1 mini](#wemos-d1-mini)
2727

2828
## Adafruit HUZZAH ESP8266 (ESP-12)
2929

doc/changes.md

Lines changed: 57 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,19 @@
22
title: Change Log
33
---
44

5-
*Current release*
5+
## Current version
6+
7+
### Core
8+
9+
### Libraries
10+
11+
### Tools
12+
13+
---
14+
## 2.0.0
15+
November 30, 2015
16+
17+
Package link: `http://arduino.esp8266.com/versions/2.0.0/package_esp8266com_index.json`.
618

719
### Core
820

@@ -13,6 +25,26 @@ title: Change Log
1325
- Update documentation for NodeMCU and Olimex boards
1426
- Disable interrupts inside ESP.getVcc (#567)
1527
- Erase RTC RAM only if RF mode looks invalid (#619)
28+
- Get pin levels at time of interrupt, rather than the time of calling the handler.
29+
- Move interrupt handlers to ram.
30+
- Improve debug output on critical errors
31+
- Add ArduinoOTA library and docs
32+
- Add WeMos D1 & D1 mini boards
33+
- Add documentation about boot messages and mode meaning
34+
- Disable sleep mode before doing OTA (#1005)
35+
- Add the ability to be called back when the device is about to reset
36+
- Add "Reset Method" menu
37+
- Add MD5 to core
38+
- I2C: generate STOP in case of NACK (fix #698, #254)
39+
- Add libc time functions
40+
- Fix linker script for 512k(no SPIFFS) variant (#966)
41+
- I2S optimizations
42+
- Support Sketch > Export compiled binary
43+
- Update SPIFFS wrapper for 0.3.3
44+
- Fix placement of code into RAM, enable gc-sections
45+
- Make soft wdt reset more obvious
46+
- Force disable IOSWAP for UART0 in HardwareSerial initialization (#744)
47+
- Add IPAddress::toString()
1648

1749

1850
### Libraries
@@ -23,6 +55,30 @@ title: Change Log
2355
- ESP8266mDNS: allow to work on SoftAP interface
2456
- EEPROM: round requested size to 4 bytes (#659)
2557
- Add ESP8266AVRISP library
58+
- Add ESP8266HTTPUpdate library
59+
- Add HTTPClient library
60+
- Add WiFiClientSecure
61+
- ESP8266WiFi library: add persistent option, fix #1054
62+
- Make RequestHandler handle uploads
63+
- Add Digest Authentication to OTA and espota.py
64+
- Don't close UDP pcbs when WiFi connection drops (#969)
65+
- Add espsoftwareserial library
66+
- Add HTTP Updater library
67+
- Add Ethernet library for W5100
68+
- Add SPIFFS WebServer Example
69+
- add dnsIP() to ESP8266WiFi class
70+
- OTA support encapsulated to ArduinoOTA class
71+
- Add gdb stub library
72+
- Extracted the WebUpdate example into a library.
73+
- Fix to Servo allowing write() to be called before attach()
74+
- ESP8266WiFi: add function `begin` without any parameters and add `psk` function to return current PSK form sdk config
75+
- Fix a crash due to abort() called from TCP error callback (#428)
76+
- Adding support for OPTIONS requests to ESP8266WebServer
77+
- Add HTTPS request sample (#43)
78+
- Fix _useClientMode & _useApMode in SDK auto connect mode (#754)
79+
- Add ESP8266WebServer::sendContent_P with 'size_t size' argument for binary content
80+
- Fix bug in WiFiClient::write_P when content was binary
81+
- Add WiFiClient::write_P to be used with PROGMEM
2682

2783
### Tools
2884

doc/filesystem.md

Lines changed: 20 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -3,25 +3,25 @@ title: File System
33
---
44

55
## Table of Contents
6-
* [Flash layout](#flash-layout)
7-
* [Uploading files to file system](#uploading-files-to-file-system)
8-
* [File system object (SPIFFS)](#file-system-object-spiffs)
9-
* [begin](#begin)
10-
* [format](#format)
11-
* [open](#open)
12-
* [exists](#exists)
13-
* [openDir](#opendir)
14-
* [remove](#remove)
15-
* [rename](#rename)
16-
* [info](#info)
17-
* [Filesystem information structure](#filesystem-information-structure)
18-
* [Directory object (Dir)](#directory-object-dir)
19-
* [File object](#file-object)
20-
* [seek](#seek)
21-
* [position](#position)
22-
* [size](#size)
23-
* [name](#name)
24-
* [close](#close)
6+
* [Flash layout](#flash-layout)
7+
* [Uploading files to file system](#uploading-files-to-file-system)
8+
* [File system object (SPIFFS)](#file-system-object-spiffs)
9+
* [begin](#begin)
10+
* [format](#format)
11+
* [open](#open)
12+
* [exists](#exists)
13+
* [openDir](#opendir)
14+
* [remove](#remove)
15+
* [rename](#rename)
16+
* [info](#info)
17+
* [Filesystem information structure](#filesystem-information-structure)
18+
* [Directory object (Dir)](#directory-object-dir)
19+
* [File object](#file-object)
20+
* [seek](#seek)
21+
* [position](#position)
22+
* [size](#size)
23+
* [name](#name)
24+
* [close](#close)
2525

2626

2727
## Flash layout
@@ -127,9 +127,7 @@ Returns *true* if a file with given path exists, *false* otherwise.
127127
SPIFFS.openDir(path)
128128
```
129129

130-
Opens a directory given its absolute path. Returns a *Dir* object. To check if
131-
directory was opened successfully, use the boolean operator, similar to opening
132-
a file.
130+
Opens a directory given its absolute path. Returns a *Dir* object.
133131

134132
### remove
135133

doc/libraries.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,19 +3,19 @@ title: Libraries
33
---
44

55
## Table of Contents
6-
* [WiFi(ESP8266WiFi library)](#wifiesp8266wifi-library)
7-
* [Ticker](#ticker)
8-
* [EEPROM](#eeprom)
9-
* [I2C (Wire library)](#i2c-wire-library)
10-
* [SPI](#spi)
11-
* [SoftwareSerial](#softwareserial)
12-
* [ESP\-specific APIs](#esp-specific-apis)
13-
* [OneWire](#onewire)
14-
* [mDNS and DNS\-SD responder (ESP8266mDNS library)](#mdns-and-dns-sd-responder-esp8266mdns-library)
15-
* [SSDP responder (ESP8266SSDP)](#ssdp-responder-esp8266ssdp)
16-
* [DNS server (DNSServer library)](#dns-server-dnsserver-library)
17-
* [Servo](#servo)
18-
* [Other libraries (not included with the IDE)](#other-libraries-not-included-with-the-ide)
6+
* [WiFi(ESP8266WiFi library)](#wifiesp8266wifi-library)
7+
* [Ticker](#ticker)
8+
* [EEPROM](#eeprom)
9+
* [I2C (Wire library)](#i2c-wire-library)
10+
* [SPI](#spi)
11+
* [SoftwareSerial](#softwareserial)
12+
* [ESP\-specific APIs](#esp-specific-apis)
13+
* [OneWire](#onewire)
14+
* [mDNS and DNS\-SD responder (ESP8266mDNS library)](#mdns-and-dns-sd-responder-esp8266mdns-library)
15+
* [SSDP responder (ESP8266SSDP)](#ssdp-responder-esp8266ssdp)
16+
* [DNS server (DNSServer library)](#dns-server-dnsserver-library)
17+
* [Servo](#servo)
18+
* [Other libraries (not included with the IDE)](#other-libraries-not-included-with-the-ide)
1919

2020
## WiFi(ESP8266WiFi library)
2121

doc/ota_updates/ota_updates.md

Lines changed: 35 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -3,29 +3,29 @@ title: OTA Update
33
---
44

55
## Table of Contents
6-
* [Introduction](#introduction)
7-
* [Security](#security)
8-
* [Safety](#safety)
9-
* [Basic Requirements](#basic-requirements)
10-
* [Arduino IDE](#arduino-ide)
11-
* [Requirements](#requirements)
12-
* [Application Example](#application-example)
13-
* [Classic OTA](#classic-ota)
14-
* [ArduinoOTA](#arduinoota)
15-
* [Web Browser](#web-browser)
16-
* [Requirements](#requirements-1)
17-
* [Implementation Overview](#implementation-overview)
18-
* [Application Example](#application-example-1)
19-
* [HTTP Server](#http-server)
20-
* [Requirements](#requirements-2)
21-
* [Arduino code](#arduino-code)
22-
* [Simple updater](#simple-updater)
23-
* [Advanced updater](#advanced-updater)
24-
* [Server request handling](#server-request-handling)
25-
* [Simple updater](#simple-updater-1)
26-
* [Advanced updater](#advanced-updater-1)
27-
* [Stream Interface](#stream-interface)
28-
* [Updater class](#updater-class)
6+
* [Introduction](#introduction)
7+
* [Security](#security)
8+
* [Safety](#safety)
9+
* [Basic Requirements](#basic-requirements)
10+
* [Arduino IDE](#arduino-ide)
11+
* [Requirements](#requirements)
12+
* [Application Example](#application-example)
13+
* [Classic OTA](#classic-ota)
14+
* [ArduinoOTA](#arduinoota)
15+
* [Web Browser](#web-browser)
16+
* [Requirements](#requirements-1)
17+
* [Implementation Overview](#implementation-overview)
18+
* [Application Example](#application-example-1)
19+
* [HTTP Server](#http-server)
20+
* [Requirements](#requirements-2)
21+
* [Arduino code](#arduino-code)
22+
* [Simple updater](#simple-updater)
23+
* [Advanced updater](#advanced-updater)
24+
* [Server request handling](#server-request-handling)
25+
* [Simple updater](#simple-updater-1)
26+
* [Advanced updater](#advanced-updater-1)
27+
* [Stream Interface](#stream-interface)
28+
* [Updater class](#updater-class)
2929

3030

3131
## Introduction
@@ -121,8 +121,9 @@ Instructions below demonstrate how to configure both [Classic OTA](#classic-ota-
121121
2. Now prepare the sketch and configuration for the upload over a serial port.
122122
- Start Arduino IDE and load sketch DNS_SD_Arduino_OTA.ino available under File > Examples > ESP8266mDNS
123123
![OTA sketch selection](ota-ide-sketch-selection.png)
124+
124125
**Note:** This sketch is available only for 1.6.5-947-g39819f0 (of July 23, 2015) and 1.6.5-1160-gef26c5f (of Sep 30, 2015) versions of platform packages installed in Arduino IDE using https://github.com/esp8266/Arduino#installing-with-boards-manager. It was removed in [#980](https://github.com/esp8266/Arduino/pull/980) from GitHub repository.
125-
- Update ssid and pass in the sketch so the module can join your Wi-Fi network
126+
- Update SSID and password in the sketch so the module can join your Wi-Fi network
126127
![ssid and pass entry](ota-ide-ssid-pass-entry.png)
127128
- Configure upload parameters as below (you may need to adjust configuration if you are using a different module):
128129
![configuration of serial upload](ota-ide-serial-upload-configuration.png)
@@ -133,7 +134,7 @@ Instructions below demonstrate how to configure both [Classic OTA](#classic-ota-
133134

134135
4. Only if module is connected to network, after a couple of seconds, the esp8266-ota port will show up in Arduino IDE:
135136

136-
![selection og OTA port](ota-ide-ota-port-selection.png)
137+
![selection of OTA port](ota-ide-ota-port-selection.png)
137138

138139
5. Now get ready for your first OTA upload by changing configuration settings as follows:
139140

@@ -145,7 +146,7 @@ Instructions below demonstrate how to configure both [Classic OTA](#classic-ota-
145146

146147
![OTA upload complete](ota-ide-ota-upload-complete.png)
147148

148-
**Note** To be able to upload your sketch over and over again using OTA, you need to embed OTA routines inside. Please use DNS_SD_Arduino_OTA.ino as an example.
149+
**Note:** To be able to upload your sketch over and over again using OTA, you need to embed OTA routines inside. Please use DNS_SD_Arduino_OTA.ino as an example.
149150

150151

151152
#### ArduinoOTA
@@ -217,15 +218,21 @@ You can use another module if it meets “Flash chip size is 2x the size of the
217218
- Start Arduino IDE and load sketch WebUpdater.ino available under File > Examples > ESP8266HTTPUpdateServer.
218219
- Update ssid and pass in the sketch so the module can join your Wi-Fi network.
219220
- Open File > Preferences, look for “Show verbose output during:” and check out “compilation” option.
221+
220222
![Preferences - enablig verbose output during compilation](ota-web-show-verbose-compilation.png)
223+
221224
**Note:** This setting will be required in step 5 below. You can uncheck this setting afterwards.
222225

223226
3. Upload sketch (Ctrl+U). Once done open Serial Monitor (Ctrl+Shift+M) and check if you see the following message displayed, that contains url for OTA update.
227+
224228
![Serial Monitor - after first load using serial](ota-web-serial-monitor-ready.png)
225-
**Note:** Such message will be shown only after module successfully joins network and is ready for an OTA upload:
229+
230+
**Note:** Such message will be shown only after module successfully joins network and is ready for an OTA upload.
226231

227232
4. Now open web browser and enter the url provided on Serial Monitor, i.e. http://esp8266-webupdate.local/update. Once entered, browser should display a form like below that has been served by your module. The form invites you to choose a file for update.
233+
228234
![OTA update form in web browser](ota-web-browser-form.png)
235+
229236
**Note:** If entering “http://esp8266-webupdate.local/update” does not work, try replacing “esp8266-webupdate” with module’s IP address. For example, if your module IP is “192.168.1.100” then url should be “http://192.168.1.100/update”. This workaround is useful in case the host software installed in step 2 does not work. If still nothing works and there are no clues on Serial Monitor, try to diagnose issue by opening provided url in Google Chrome, pressing F12 and checking contents of “Console” and “Network” tabs. Chrome provides some advanced logging on these tabs.
230237

231238

@@ -241,7 +248,7 @@ You can use another module if it meets “Flash chip size is 2x the size of the
241248

242249
![Serial Monitor - after OTA update](ota-web-serial-monitor-reboot.png)
243250

244-
Just after reboot you should see exactly the same message “HTTPUpdateServer ready! Open http:// esp8266-webupdate.local /update in your browser” like in step 3. This is because module has been loaded again with the same code – first using serial port, and then using OTA.
251+
Just after reboot you should see exactly the same message “HTTPUpdateServer ready! Open http:// esp8266-webupdate.local /update in your browser” like in step 3. This is because module has been loaded again with the same code – first using serial port, and then using OTA.
245252

246253
Once you are comfortable with this procedure go ahead and modify WebUpdater.ino sketch to print some additional messages, compile it, locate new binary file and upload it using web browser to see entered changes on a Serial Monitor.
247254

doc/reference.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@ title: Reference
33
---
44

55
## Table of Contents
6-
* [Table of Contents](#table-of-contents)
7-
* [Digital IO](#digital-io)
8-
* [Analog input](#analog-input)
9-
* [Analog output](#analog-output)
10-
* [Timing and delays](#timing-and-delays)
11-
* [Serial](#serial)
12-
* [Progmem](#progmem)
6+
* [Table of Contents](#table-of-contents)
7+
* [Digital IO](#digital-io)
8+
* [Analog input](#analog-input)
9+
* [Analog output](#analog-output)
10+
* [Timing and delays](#timing-and-delays)
11+
* [Serial](#serial)
12+
* [Progmem](#progmem)
1313

1414
## Digital IO
1515

0 commit comments

Comments
 (0)