ESP8266 - Revision history

Leo: Tasmota

2021-05-20T07:47:26Z

Tasmota

← Older revision		Revision as of 07:47, 20 May 2021
Line 137:		Line 137:
	====Deep Sleep====		====Deep Sleep====
	When using {{code\|ESP.deepSleep(30e6)}}, GPIO 16 should be connected to the RST pin. The ESP8266 will wake itself up by sending a LOW to RST which will reset the device.		When using {{code\|ESP.deepSleep(30e6)}}, GPIO 16 should be connected to the RST pin. The ESP8266 will wake itself up by sending a LOW to RST which will reset the device.

			== Software and firmware ==
			Out of the box, the ESP8266 comes with a default NONOS firmware that accepts AT commands. For custom projects, you may choose to either use an alternative firmware such as Tasmota or write your own program using the Arduino IDE.

			Which option should you use? With all the features and maturity of the firmware from the Tasmota project, I will recommend using Tasmota over writing your own sketch unless there is a strong reason otherwise. My reasoning behind this choice is that most projects involving a ESP typically just need to poll some sensors and then acting on the data which is what Tasmota is designed to do, really really well. Rather than write a bunch of custom code and pulling in all the necessary libraries for all the peripherals manually, Tasmota comes bundled with all the nice features such as Wifi Manager and most common libraries to interact with a wide array of peripherals and network protocols. Additionally, Tasmota extremely easy to change pinouts, configure WiFi, and interact with a wide range of peripherals out of the box without needing to write a single line of code..

			=== Tasmota ===
			See the main article on [[Tasmota]] for information on how to flash and use Tasmota.

	===Setting up the Arduino IDE===		===Setting up the Arduino IDE===
Line 155:		Line 163:
	The default transfer speed is at 115200 baud which is just slow enough to be irritating. You can increase this speed without affecting the reliability of uploads.		The default transfer speed is at 115200 baud which is just slow enough to be irritating. You can increase this speed without affecting the reliability of uploads.

	===Arduino Libraries===		====Arduino Libraries====
	Some libraries that are worth checking out are:		Some libraries that are worth checking out are:

Leo at 15:42, 18 May 2021

2021-05-18T15:42:15Z

← Older revision		Revision as of 15:42, 18 May 2021
Line 132:		Line 132:
	*Uart Bootloader mode is used to upload code to flash		*Uart Bootloader mode is used to upload code to flash
	*Boot sketch (SPI flash) mode is used to boot from flash memory		*Boot sketch (SPI flash) mode is used to boot from flash memory

			Because of the behaviors that can be induced by these GPIO pins on start up, these GIO pins shouldn't be used for peripherals without some special planning. Otherwise, you may have inconsistent boot behaviors such as having the ESP boot into SDIO/flash mode randomly.

	====Deep Sleep====		====Deep Sleep====
Line 440:		Line 442:
	*http://support.thingplus.net/en/esp8266.html		*http://support.thingplus.net/en/esp8266.html
	*https://tttapa.github.io/ESP8266/Chap03 - Software.html		*https://tttapa.github.io/ESP8266/Chap03 - Software.html
			*https://tttapa.github.io/ESP8266/Chap04%20-%20Microcontroller.html - GPIO pins

	*http://yaab-arduino.blogspot.ca/2015/03/esp8266-wiring-schemas.html		*http://yaab-arduino.blogspot.ca/2015/03/esp8266-wiring-schemas.html

Leo at 19:55, 23 August 2020

2020-08-23T19:55:07Z

← Older revision		Revision as of 19:55, 23 August 2020
Line 28:		Line 28:

	===WeMos D1 Mini===		===WeMos D1 Mini===
	These are about $3 USD or slightly ~~cheaper~~ on AliExpress.		These are about $3 USD and can be found for slightly less than that on AliExpress.

	The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules. These boards include a micro USB port with an integrated serial connector which will automatically put the ESP8266 into the proper boot mode when flashing and properly resets the device afterwards. There is also a built in reset button which is super convenient.		The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules. These boards include a micro USB port with an integrated serial connector which will automatically put the ESP8266 into the proper boot mode when flashing and properly resets the device afterwards. There is also a built in reset button which is super convenient.
Line 54:		Line 54:
	Library example code: https://github.com/mcauser/Adafruit_SSD1306/blob/esp8266-64x48/examples/ssd1306_64x48_i2c/ssd1306_64x48_i2c.ino		Library example code: https://github.com/mcauser/Adafruit_SSD1306/blob/esp8266-64x48/examples/ssd1306_64x48_i2c/ssd1306_64x48_i2c.ino

	==== Miscellaneous Notes ====		====Miscellaneous Notes====
	When using a photoresistor, pull A0 up to 3.3v via the photoresistor, then pull A0 down with a 10K resistor. The Wemos D1 board has a built-in voltage divider that reduces the 3.3v to 1.0v.		When using a photoresistor, pull A0 up to 3.3v via the photoresistor, then pull A0 down with a 10K resistor. The Wemos D1 board has a built-in voltage divider that reduces the 3.3v to 1.0v.

	==Quick Usage==		==Quick Usage==
	===Wiring===		===Wiring===
	Skip this section if you're using a development board because all this is taken care of for you.		'''Skip this section if you're using a development board''' because all this is taken care of for you.

	The ESP8266 runs on 3.3v and is not 5v tolerant. Unless you are using a development board, you must be careful when powering the board. Since serial data from TTL UART is at 5V, you must use a voltage divider or logic level converter to step the voltage down and avoid damaging the ESP8266.		The ESP8266 runs on 3.3v and is not 5v tolerant. Unless you are using a development board, you must be careful when powering the board. Since serial data from TTL UART is at 5V, you must use a voltage divider or logic level converter to step the voltage down and avoid damaging the ESP8266.
Line 70:		Line 70:
	<div class="row"><div class="col-lg-8">		<div class="row"><div class="col-lg-8">
	{\| class="wikitable"		{\| class="wikitable"
	\|+
	!		!
	!Description		!Description
Line 327:		Line 326:
	The flash layout appears to be:		The flash layout appears to be:
	{\| class="wikitable"		{\| class="wikitable"
	\|+
	!Content		!Content
	!Address		!Address
Line 433:		Line 431:
	This issue might be a result of how the access point was set up. You see, this access point is using a Raspberry Pi 1 with a USB Wifi adapter running OpenWRT. There are about half a dozen clients connected to this access point all without this behavior.		This issue might be a result of how the access point was set up. You see, this access point is using a Raspberry Pi 1 with a USB Wifi adapter running OpenWRT. There are about half a dozen clients connected to this access point all without this behavior.

	~~After tweaking around with the Wifi adapter settings, the~~ issue seemed to have gone away by setting the "Beacon Interval" to 20ms.		The issue seemed to have gone away after setting the "Beacon Interval" to 20ms in OpenWRT.

	==See Also==		==See Also==

Leo at 18:38, 23 August 2020

2020-08-23T18:38:47Z

← Older revision		Revision as of 18:38, 23 August 2020
Line 38:		Line 38:

	====DHT22 Module====		====DHT22 Module====
	~~Connects~~ to D4 (GPIO 2). GPIO 2 is also used when the WeMos is reset ~~and~~ the DHT22 will stop ~~working~~ until a full power cycle occurs.		[[File:Wemos DHT22 Module Fix.jpg\|alt=Wemos DHT22 Module Fix\|thumb\|162x162px\|Wemos DHT22 Module Fix]]
			This module uses to D4 (GPIO 2) to communicate with the DHT22. However, since GPIO 2 is also used when the WeMos is reset, this puts the DHT22 in a weird state and will stop functioning until a full power cycle occurs.

	A work around is to cut off the header connecting to D4 and then bridge D4 and D3 with solder. This effectively changes the DHT22 data pin to D3 and avoids the issue that is caused when D4 is pulled high on boot.		A work around is to cut off the header connecting to D4 and then bridge D4 and D3 with solder. Alternatively, break the trace on the board and solder a thin wire from the DHT22 to D3 as pictured on the right. This effectively changes the DHT22 data pin to D3 and avoids the issue that is caused when D4 is pulled high on boot.

	====Button Module====		====Button Module====
Line 52:		Line 53:

	Library example code: https://github.com/mcauser/Adafruit_SSD1306/blob/esp8266-64x48/examples/ssd1306_64x48_i2c/ssd1306_64x48_i2c.ino		Library example code: https://github.com/mcauser/Adafruit_SSD1306/blob/esp8266-64x48/examples/ssd1306_64x48_i2c/ssd1306_64x48_i2c.ino

			==== Miscellaneous Notes ====
			When using a photoresistor, pull A0 up to 3.3v via the photoresistor, then pull A0 down with a 10K resistor. The Wemos D1 board has a built-in voltage divider that reduces the 3.3v to 1.0v.

	==Quick Usage==		==Quick Usage==
Line 346:		Line 350:
	The input voltage range must be between 0 and 1.0 volts.		The input voltage range must be between 0 and 1.0 volts.

	If using a development board, such as the WeMos D1 Mini compatible modules, the board will have a built-in voltage divider using a 100 KΩ and 220 KΩ resistor, allowing the A0 pin to accept an input voltage between 0 and 3.~~2 volts~~.		If using a development board, such as the WeMos D1 Mini compatible modules, the board will have a built-in voltage divider using a 100 KΩ and 220 KΩ resistor, allowing the A0 pin to accept an input voltage between 0 and 3.3v (but really it should be 3.2v?).

	==Troubleshooting==		==Troubleshooting==

Leo: /* 0.66" OLED Module */

2020-07-26T20:25:20Z

0.66" OLED Module

← Older revision		Revision as of 20:25, 26 July 2020
Line 50:		Line 50:
	====0.66" OLED Module====		====0.66" OLED Module====
	Uses I2C interface connected to D1 and D2.		Uses I2C interface connected to D1 and D2.

			Library example code: https://github.com/mcauser/Adafruit_SSD1306/blob/esp8266-64x48/examples/ssd1306_64x48_i2c/ssd1306_64x48_i2c.ino

	==Quick Usage==		==Quick Usage==

Leo: /* WeMos D1 Mini */

2020-07-26T20:04:22Z

WeMos D1 Mini

← Older revision		Revision as of 20:04, 26 July 2020
Line 28:		Line 28:

	===WeMos D1 Mini===		===WeMos D1 Mini===
			These are about $3 USD or slightly cheaper on AliExpress.

	The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules. These boards include a micro USB port with an integrated serial connector which will automatically put the ESP8266 into the proper boot mode when flashing and properly resets the device afterwards. There is also a built in reset button which is super convenient.		The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules. These boards include a micro USB port with an integrated serial connector which will automatically put the ESP8266 into the proper boot mode when flashing and properly resets the device afterwards. There is also a built in reset button which is super convenient.

Leo: /* WeMos D1 */

2020-07-26T19:55:56Z

WeMos D1

← Older revision		Revision as of 19:55, 26 July 2020
Line 25:		Line 25:
	===ESP-12F===		===ESP-12F===
	The difference between the ESP-12E and the ESP-12F is the on-board antenna.		The difference between the ESP-12E and the ESP-12F is the on-board antenna.
			[[File:ESP8266 WeMos D1.jpg\|alt=ESP8266 WeMos D1\|thumb\|199x199px\|ESP8266 WeMos D1]]

	===WeMos D1===		===WeMos D1 Mini===
	The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules.		The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules. These boards include a micro USB port with an integrated serial connector which will automatically put the ESP8266 into the proper boot mode when flashing and properly resets the device afterwards. There is also a built in reset button which is super convenient.

			Additionally, the analog A0 pin has a built-in voltage divider allowing for analog inputs ranging from 0.0V to 3.2V, rather than the ESP8266 bare chip of 0.0V and 1.0V.

			The form factor of the WeMos D1 Mini allows for additional modules to be stacked above or below and allows for very fast prototyping. To the bottom left is a picture of a stack of different sensors packed on the WeMos D1.
			[[File:WeMos Sensor Stack.jpg\|alt=WeMos Sensor Stack\|left\|thumb\|240x240px\|WeMos Sensor Stack]]

	====DHT22 Module====		====DHT22 Module====
	Connects to D4 (GPIO 2). GPIO 2 is also used when the WeMos is reset and the DHT22 will stop working until a full ~~powercycle~~ occurs. ~~This can be worked~~ around ~~by bridging~~ the D4 and D3 ~~pins~~ and ~~then disconnecting~~ the D4 ~~header~~.		Connects to D4 (GPIO 2). GPIO 2 is also used when the WeMos is reset and the DHT22 will stop working until a full power cycle occurs.

			A work around is to cut off the header connecting to D4 and then bridge D4 and D3 with solder. This effectively changes the DHT22 data pin to D3 and avoids the issue that is caused when D4 is pulled high on boot.

	====Button Module====		====Button Module====
	~~Connected~~ to D3.		The button is connected to D3 and ground. There is no pull down resistor to limit current. Ensure that D3 isn't sourcing current.

	====BMP180 Module====		====BMP180 Module====
Line 42:		Line 50:

	==Quick Usage==		==Quick Usage==
	The ESP8266 runs on 3.3v and is not 5v tolerant. Since serial data from TTL UART is at 5V, you must use a voltage divider or logic level converter to step the voltage down and avoid damaging the ESP8266.		===Wiring===
			Skip this section if you're using a development board because all this is taken care of for you.

			The ESP8266 runs on 3.3v and is not 5v tolerant. Unless you are using a development board, you must be careful when powering the board. Since serial data from TTL UART is at 5V, you must use a voltage divider or logic level converter to step the voltage down and avoid damaging the ESP8266.

	Each pin can source a maximum of 12mA compared to 20-40mA for most Arduinos. There is one ADC with a voltage range of 0V to 1.0V. Do not exceed these limits or you will risk damaging the ESP8266.		Each pin can source a maximum of 12mA compared to 20-40mA for most Arduinos. There is one ADC with a voltage range of 0V to 1.0V. Do not exceed these limits or you will risk damaging the ESP8266.
Line 48:		Line 59:
	The ESP8266 can boot into one of three modes depending on the GPIO input on power up. You want to boot into the sketch by pulling GPIO 0 and GPIO 2 high with a 10K resistor to Vcc. To program the ESP8266, you will need to reboot the ESP8266 into the UART bootloader by pulling GPIO 0 down while keeping GPIO 2 high. The RST pin should also be connected to the TTL UART DTR pin via a 10K resistor so that it can be reset automatically. For flashing convenience, you may wish to connect a switch to toggle whether GPIO 0 is pulled high or low. A switch pulling RST low is also convenient to have to reset the ESP.		The ESP8266 can boot into one of three modes depending on the GPIO input on power up. You want to boot into the sketch by pulling GPIO 0 and GPIO 2 high with a 10K resistor to Vcc. To program the ESP8266, you will need to reboot the ESP8266 into the UART bootloader by pulling GPIO 0 down while keeping GPIO 2 high. The RST pin should also be connected to the TTL UART DTR pin via a 10K resistor so that it can be reset automatically. For flashing convenience, you may wish to connect a switch to toggle whether GPIO 0 is pulled high or low. A switch pulling RST low is also convenient to have to reset the ESP.

	~~===Wiring===~~
	To power on and play with the ESP8266, connect:		To power on and play with the ESP8266, connect:
	<div class="row"><div class="col-lg-8">		<div class="row"><div class="col-lg-8">
Line 331:		Line 341:

	The input voltage range must be between 0 and 1.0 volts.		The input voltage range must be between 0 and 1.0 volts.

			If using a development board, such as the WeMos D1 Mini compatible modules, the board will have a built-in voltage divider using a 100 KΩ and 220 KΩ resistor, allowing the A0 pin to accept an input voltage between 0 and 3.2 volts.

	==Troubleshooting==		==Troubleshooting==

Leo: /* WiFiManager */

2020-07-26T18:02:19Z

WiFiManager

← Older revision		Revision as of 18:02, 26 July 2020
Line 26:		Line 26:
	The difference between the ESP-12E and the ESP-12F is the on-board antenna.		The difference between the ESP-12E and the ESP-12F is the on-board antenna.

	=== WeMos D1 ===		===WeMos D1===
	The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules.		The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules.

	==== DHT22 Module ====		====DHT22 Module====
	Connects to D4 (GPIO 2). GPIO 2 is also used when the WeMos is reset and the DHT22 will stop working until a full powercycle occurs. This can be worked around by bridging the D4 and D3 pins and then disconnecting the D4 header.		Connects to D4 (GPIO 2). GPIO 2 is also used when the WeMos is reset and the DHT22 will stop working until a full powercycle occurs. This can be worked around by bridging the D4 and D3 pins and then disconnecting the D4 header.

	==== Button Module ====		====Button Module====
	Connected to D3.		Connected to D3.

	==== BMP180 Module ====		====BMP180 Module====
	Uses I2C interface connected to D1 and D2.		Uses I2C interface connected to D1 and D2.

	==== 0.66" OLED Module ====		====0.66" OLED Module====
	Uses I2C interface connected to D1 and D2.		Uses I2C interface connected to D1 and D2.

Line 139:		Line 139:
	Some libraries that are worth checking out are:		Some libraries that are worth checking out are:

	*WiFiManager: Allows changing the AP without needing to recompile and reupload a new sketch.		*[[WiFiManager]]: Allows changing the AP without needing to recompile and reupload a new sketch.
	*ESP8266httpUpdate: Provides ESPhttpUpdate which allows updating the ESP8266 over the air (OTA).		*ESP8266httpUpdate: Provides ESPhttpUpdate which allows updating the ESP8266 over the air (OTA).
	*FS.h: Part of the main ESP8266 Arduino core, used to interact with SPIFFS (SPI Flash File System)		*FS.h: Part of the main ESP8266 Arduino core, used to interact with SPIFFS (SPI Flash File System)
	*ArduinoJson: Interact with JSON		*[[ArduinoJson]]: Interact with JSON
	*PubSubClient: A simple MQTT client		*[[PubSubClient]]: A simple MQTT client

	====WiFiManager====		====WiFiManager====

Leo: /* ESP-12F */

2020-07-25T23:58:23Z

ESP-12F

← Older revision		Revision as of 23:58, 25 July 2020
Line 25:		Line 25:
	===ESP-12F===		===ESP-12F===
	The difference between the ESP-12E and the ESP-12F is the on-board antenna.		The difference between the ESP-12E and the ESP-12F is the on-board antenna.

			=== WeMos D1 ===
			The WeMos D1 ESP8266 boards come with many compatible stackable sensors and modules.

			==== DHT22 Module ====
			Connects to D4 (GPIO 2). GPIO 2 is also used when the WeMos is reset and the DHT22 will stop working until a full powercycle occurs. This can be worked around by bridging the D4 and D3 pins and then disconnecting the D4 header.

			==== Button Module ====
			Connected to D3.

			==== BMP180 Module ====
			Uses I2C interface connected to D1 and D2.

			==== 0.66" OLED Module ====
			Uses I2C interface connected to D1 and D2.

	==Quick Usage==		==Quick Usage==
Line 286:		Line 301:
	*https://github.com/espressif/ESP8266_NONOS_SDK		*https://github.com/espressif/ESP8266_NONOS_SDK

	=== Reading Flash ===		===Reading Flash===
	From the 35c3 Smart Home - Smart Hack talk, you can see that the esp8266 can be dumped using the <code>esptool.py</code> script:		From the 35c3 Smart Home - Smart Hack talk, you can see that the esp8266 can be dumped using the <code>esptool.py</code> script:
	{{Highlight		{{Highlight
Line 312:		Line 327:
	SSID and WLAN password is located at 0x7c000.		SSID and WLAN password is located at 0x7c000.

	=== Analog to Digital Converter ===		===Analog to Digital Converter===
	The ESP8266 contains a 10-bit successive approximation register (SAR) ADC on pin 6 (TOUT). It can be used to measure the power supply voltage on pin 3 and 4 or measure an input voltage.		The ESP8266 contains a 10-bit successive approximation register (SAR) ADC on pin 6 (TOUT). It can be used to measure the power supply voltage on pin 3 and 4 or measure an input voltage.

Leo at 18:41, 21 June 2020

2020-06-21T18:41:15Z

← Older revision		Revision as of 18:41, 21 June 2020
Line 311:		Line 311:
	\|}		\|}
	SSID and WLAN password is located at 0x7c000.		SSID and WLAN password is located at 0x7c000.

			=== Analog to Digital Converter ===
			The ESP8266 contains a 10-bit successive approximation register (SAR) ADC on pin 6 (TOUT). It can be used to measure the power supply voltage on pin 3 and 4 or measure an input voltage.

			The input voltage range must be between 0 and 1.0 volts.

	==Troubleshooting==		==Troubleshooting==