![\"MicroPython](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/esp32-deep-sleep-micropython.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nThe ESP32 can also be awaken from deep sleep using the touch pins by defining a threshold. Although this feature is already implemented in MicroPython, it is not working properly at the time of writing this tutorial. We’ll update this article as soon as it is working.<\/p>\n\n\n\n
Deep sleep with the ESP8266 works a bit different than with the ESP32. So, we’ve created a dedicated article to deep sleep with ESP8266 using MicroPython.<\/p>\n\n\n\n
If you have an ESP8266, we recommend reading our MicroPython ESP8266 Deep Sleep and Wake Up Sources Guide<\/a>. <\/p>\n\n\n\n To follow this tutorial you need MicroPython firmware installed in your ESP32 or ESP8266 boards. You also need an IDE to write and upload the code to your board. We suggest using Thonny IDE or uPyCraft IDE:<\/p>\n\n\n\n Learn more about MicroPython: MicroPython Programming with ESP32 and ESP8266 eBook<\/a><\/p>\n\n\n\n Having your ESP32\/ESP8266 running on active mode with batteries it\u2019s not ideal, since the power from batteries will drain very quickly.<\/p>\n\n\n\n If you put your ESP32 in deep sleep mode, it will reduce the power consumption and your batteries will last longer. Having the ESP32 in deep sleep mode means cutting with the activities that consume more power while operating but leave just enough activity to wake up the processor when something interesting happens.<\/p>\n\n\n\n When operating in deep sleep mode, the ESP32 have a current consumption on the \u03bcA range. With a custom and carefully designed board you can get a minimal comsumption of only 5 \u03bcA. However, if you use a full-feature ESP32 development board with built-in programmer, on-board LEDs, and so on (like the ESP32 DOIT board) you won\u2019t be able to achieve such a low power state, but you can still save power.<\/p>\n\n\n\n After putting the ESP32 into deep sleep mode, there are several ways to wake it up:<\/p>\n\n\n\n The ESP32 can go into deep sleep mode, and then wake up at predefined periods of time. This feature is especially useful if you are running projects that require time stamping or daily tasks, while maintaining low power consumption.<\/p>\n\n\n\n To put the ESP32 in deep sleep mode for a predetermined number of seconds, you just have to use the deepsleep()<\/span> function from the machine<\/span> module. This function accepts as arguments, the sleep time in milliseconds as follows:<\/p>\n\n\n\n Let\u2019s look at a simple example to see how it works. In the following code, the ESP32 is in deep sleep mode for 10 seconds, then it wakes up, blinks an LED, and goes back to sleep.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n First, import the necessary libraries:<\/p>\n\n\n\n Create a Pin<\/span> object that refers to GPIO 2<\/span> called led<\/span>. This refers to the on-board LED.<\/p>\n\n\n\n The following commands blink the LED.<\/p>\n\n\n\n In this case, we’re blinking an LED for demonstration purposes, but the idea is to add your main code in this section of the script.<\/p>\n\n\n\n Before going to sleep, we add a delay of 5 seconds and print a message to indicate that it\u2019s going to sleep.<\/p>\n\n\n\n It\u2019s important to add a 5 seconds delay before going to sleep when we are developing the scripts. When you want to upload a new code to the board, it needs to be awake. So, if you don\u2019t have the delay, it will be difficult to catch it awake to upload new code later on. After having the final code, you can delete that delay.<\/p>\n\n\n\n Finally, put the ESP32 in deep sleep for 10 seconds (10 000 milliseconds).<\/p>\n\n\n\n After 10 seconds, the ESP32 wakes up and runs the code from the start, similarly to when you press the EN\/RST button.<\/p>\n\n\n\n Copy the code provided to the main.py<\/em> file of your ESP32. Upload the new code and press the EN\/RST button after uploading. <\/p>\n\n\n\n The ESP32 should blink the on-board LED and print a message. Then, it goes to sleep. This is repeated over and over again.<\/p>\n\n\n\n If you don’t know how to upload the script follow this tutorial if you’re using Thonny IDE<\/a>, or this one if you’re using uPyCraft IDE<\/a>.<\/p>\n\n\n\n The ESP32 can also be awaken from sleep when there is a change on the state of a pin. There are two possibilities of external wake up with the ESP32: ext0 <\/strong>and ext1<\/strong>.<\/p>\n\n\n\n The ext0 mode allows you to use one GPIO as a wake up source. The ext1 mode allows you to set more than one GPIO as a wake up source at the same time.<\/p>\n\n\n\n Only RTC GPIOs can be used as a wake up source<\/strong>. The RTC GPIOs are highlighted with an orange rectangle box in the next diagram.<\/p>\n\n\n\n Learn more about the ESP32 GPIOs: ESP32 Pinout Reference: Which GPIO pins should you use?<\/a> <\/p>\n\n\n\n To illustrate how to use the external wake up ext0, we’ll use one pushbutton as a wake up source. The ESP32 awakes when you press the pushbutton.<\/p>\n\n\n\n For this example, you need the following components:<\/p>\n\n\n\n You can use the preceding links or go directly to MakerAdvisor.com\/tools<\/a> to find all the parts for your projects at the best price!<\/p> Wire the circuit by following the next schematic diagram. In this example, we’re using GPIO14<\/span> to wake up the ESP32, but you can use any other RTC GPIO.<\/p>\n\n\n\n The following script shows how ext0 works: it uses one GPIO as an external wake up source.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n First, you need to import the necessary modules. You need to import the esp32<\/span> module that contains the methods to set a pin as a wake up source.<\/p>\n\n\n\n After importing the necessary modules, define a wake up pin. In this case we’re using GPIO14<\/span> and we call it wake1<\/span>. This GPIO should be set as an input (Pin.IN<\/span>).<\/p>\n\n\n\n Then, set ext0 as a wake up source using the wake_on_ext0()<\/span> method as follows:<\/p>\n\n\n\n The wake_on_ext0()<\/span> method accepts as arguments the pin and the level:<\/p>\n\n\n\n In this case, we’re using the WAKEUP_ANY_HIGH<\/span> method that wakes up the ESP32 when the GPIO goes HIGH.<\/p>\n\n\n\n Your main code to execute a task should go after defining the wake up source and right before going to sleep.<\/p>\n\n\n\n We add a 10 second delay before going to sleep. To put the ESP32 into deep sleep, you just need to use the deepsleep()<\/span> method as follows:<\/p>\n\n\n\n Upload the code to the ESP32 main.py<\/em> file. Press the EN\/RESET button to run the code. The ESP32 should go to sleep.<\/p>\n\n\n\n Now, you can press the button to wake it up from deep sleep.<\/p>\n\n\n\n External wake up ext1 works very similar to ext0 but it allows you to set more than one GPIO as a wake up source. To demonstrate how it works we’ll use two pushbuttons wired to different GPIOs.<\/p>\n\n\n\n For this example, you need the following components:<\/p>\n\n\n\n Wire the circuit by following the next schematic diagram.<\/p>\n\n\n\n In this case, we’re using GPIO14<\/span> and GPIO12<\/span>. You can use any other suitable GPIOs, but these need to be RTC GPIOs, otherwise this method doesn’t work. <\/p>\n\n\n\n The following script shows how ext1 works: it uses two GPIOs as an external wake up source, but you can use more if you want.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n The code is similar to the ext0 example, but it uses the wake_on_ext1()<\/span> method instead.<\/p>\n\n\n\n The wake_on_ext1()<\/span> method accepts as arguments the pins and the level: <\/p>\n\n\n\n After defining the wake up source, you can put the ESP32 in deep sleep:<\/p>\n\n\n\n We hope you’ve found this tutorial about deep sleep with the ESP32 using MicroPython useful. We’ve covered timer wake up and external wake up. There is also the possibility to wake up the ESP32 using the touch pins. Although this is already available in the latest MicroPython firmware, it is not working as expected, so we didn’t include it in the tutorial. In the meanwhile, you can use ESP32 Touch Wake Up with Arduino IDE<\/a>.<\/p>\n\n\n\n If you want to learn more about programming the ESP32 and ESP8266 boards with MicroPython, take a look our eBook: MicroPython Programming with ESP32 and ESP8266<\/a>.<\/p>\n\n\n\n We have other tutorials related with deep sleep that you might be interested:<\/p>\n\n\n\n Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":" This tutorial shows how to put the ESP32 in deep sleep mode and wake it up using different wake up sources using MicroPython firmware. We’ll cover timer wake up and … <\/p>\nPrerequisites<\/h2>\n\n\n\n
Introducing Deep Sleep<\/h2>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/02\/drain-batteries.jpg?resize=244%2C122&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nWake Up Sources<\/h3>\n\n\n\n
Timer Wake Up<\/h2>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/02\/timer-wake-up.png?resize=150%2C150&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nmachine.deepsleep(sleep_time_ms)<\/code><\/pre>\n\n\n\n# Complete project details at https:\/\/RandomNerdTutorials.com\/micropython-programming-with-esp32-and-esp8266\/\n\nfrom machine import deepsleep\nfrom machine import Pin\nfrom time import sleep\n\nled = Pin (2, Pin.OUT)\n\n#blink LED\nled.value(1)\nsleep(1)\nled.value(0)\nsleep(1)\n\n# wait 5 seconds so that you can catch the ESP awake to establish a serial communication later\n# you should remove this sleep line in your final script\nsleep(5)\n\nprint('Im awake, but Im going to sleep')\n\n#sleep for 10 seconds (10000 milliseconds)\ndeepsleep(10000)\n<\/code><\/pre>\n\tHow the Code Works<\/h3>\n\n\n\n
import machine\nfrom machine import Pin\nfrom time import sleep<\/code><\/pre>\n\n\n\nled = Pin (2, Pin.OUT)<\/code><\/pre>\n\n\n\nled.value(1)\nsleep(1)\nled.value(0)\nsleep(1)<\/code><\/pre>\n\n\n\nsleep(5)\nprint('Im awake, but Im going to sleep')<\/code><\/pre>\n\n\n\nmachine.deepsleep(10000)<\/code><\/pre>\n\n\n\nDemonstration<\/h3>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/deep_sleep_reset_esp32.png?resize=666%2C457&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n
\n\n\n\nExternal Wake Up<\/h2>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/02\/external-wake-up.png?resize=175%2C125&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2018\/08\/ESP32-DOIT-DEVKIT-V1-Board-Pinout-36-GPIOs-updated.jpg?resize=750%2C538&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nExternal wake up – ext0<\/h3>\n\n\n\n
![](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2017\/10\/header-200.png?w=1200&quality=100&strip=all&ssl=1\")
<\/a><\/p>\n\n\n\n\n\nSchematic Diagram\n\n<\/h4>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/one-external-wake-ups_bb.png?resize=1010%2C728&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nScript<\/h4>\n\n\n\n
# Complete project details at https:\/\/RandomNerdTutorials.com\/micropython-programming-with-esp32-and-esp8266\/\n\nimport esp32\nfrom machine import Pin\nfrom machine import deepsleep\nfrom time import sleep\n\nwake1 = Pin(14, mode = Pin.IN)\n\n#level parameter can be: esp32.WAKEUP_ANY_HIGH or esp32.WAKEUP_ALL_LOW\nesp32.wake_on_ext0(pin = wake1, level = esp32.WAKEUP_ANY_HIGH)\n\n#your main code goes here to perform a task\n\nprint('Im awake. Going to sleep in 10 seconds')\nsleep(10)\nprint('Going to sleep now')\ndeepsleep()\n<\/code><\/pre>\n\tHow the code works<\/h4>\n\n\n\n
wake1 = Pin(14, mode = Pin.IN)<\/code><\/pre>\n\n\n\nesp32.wake_on_ext0(pin = wake1, level = esp32.WAKEUP_ANY_HIGH)<\/code><\/pre>\n\n\n\nmachine.deepsleep()<\/code><\/pre>\n\n\n\nDemonstration<\/h3>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/external-wake-up.png?resize=768%2C417&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nExternal wake up – ext1<\/h3>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/ESP32-Deep-Sleep-External-Wake-Up-MicroPython-ext0-ext1.jpg?resize=750%2C421&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nSchematic Diagram <\/h4>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/two-external-wake-ups_bb.png?resize=1010%2C740&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nScript<\/h4>\n\n\n\n
# Complete project details at https:\/\/RandomNerdTutorials.com\/micropython-programming-with-esp32-and-esp8266\/\n\nimport esp32\nfrom machine import deepsleep\nfrom machine import Pin\nfrom time import sleep\n\nwake1 = Pin(14, mode = Pin.IN)\nwake2 = Pin(12, mode = Pin.IN)\n\n#level parameter can be: esp32.WAKEUP_ANY_HIGH or esp32.WAKEUP_ALL_LOW\nesp32.wake_on_ext1(pins = (wake1, wake2), level = esp32.WAKEUP_ANY_HIGH)\n\n#your main code goes here to perform a task\n\nprint('Im awake. Going to sleep in 10 seconds')\nsleep(10)\nprint('Going to sleep now')\ndeepsleep()\n<\/code><\/pre>\n\tHow the code works<\/h4>\n\n\n\n
esp32.wake_on_ext1(pins = (wake1, wake2), level = esp32.WAKEUP_ANY_HIGH)<\/code><\/pre>\n\n\n\nmachine.deepsleep()<\/code><\/pre>\n\n\n\nWrapping Up<\/h2>\n\n\n\n