From 82b8db196f72d2d1691ef6de00c4741af46ee8d0 Mon Sep 17 00:00:00 2001 From: Ivan Grokhotkov Date: Tue, 4 Sep 2018 13:53:26 +0800 Subject: [PATCH] examples: add light sleep example --- examples/system/light_sleep/CMakeLists.txt | 8 ++ examples/system/light_sleep/Makefile | 9 ++ examples/system/light_sleep/README.md | 67 +++++++++++++ examples/system/light_sleep/example_test.py | 62 ++++++++++++ .../light_sleep/image/light_sleep_scope.png | Bin 0 -> 17183 bytes .../image/light_sleep_scope_zoom.png | Bin 0 -> 26388 bytes examples/system/light_sleep/main/component.mk | 3 + .../main/light_sleep_example_main.c | 90 ++++++++++++++++++ .../system/light_sleep/sdkconfig.defaults | 1 + 9 files changed, 240 insertions(+) create mode 100644 examples/system/light_sleep/CMakeLists.txt create mode 100644 examples/system/light_sleep/Makefile create mode 100644 examples/system/light_sleep/README.md create mode 100644 examples/system/light_sleep/example_test.py create mode 100644 examples/system/light_sleep/image/light_sleep_scope.png create mode 100644 examples/system/light_sleep/image/light_sleep_scope_zoom.png create mode 100644 examples/system/light_sleep/main/component.mk create mode 100644 examples/system/light_sleep/main/light_sleep_example_main.c create mode 100644 examples/system/light_sleep/sdkconfig.defaults diff --git a/examples/system/light_sleep/CMakeLists.txt b/examples/system/light_sleep/CMakeLists.txt new file mode 100644 index 0000000000..33b3fec269 --- /dev/null +++ b/examples/system/light_sleep/CMakeLists.txt @@ -0,0 +1,8 @@ +# The following four lines of boilerplate have to be in your project's CMakeLists +# in this exact order for cmake to work correctly +cmake_minimum_required(VERSION 3.5) + +set(MAIN_SRCS main/light_sleep_example_main.c) + +include($ENV{IDF_PATH}/tools/cmake/project.cmake) +project(light_sleep_example) diff --git a/examples/system/light_sleep/Makefile b/examples/system/light_sleep/Makefile new file mode 100644 index 0000000000..0477dbfa07 --- /dev/null +++ b/examples/system/light_sleep/Makefile @@ -0,0 +1,9 @@ +# +# This is a project Makefile. It is assumed the directory this Makefile resides in is a +# project subdirectory. +# + +PROJECT_NAME := light_sleep_example + +include $(IDF_PATH)/make/project.mk + diff --git a/examples/system/light_sleep/README.md b/examples/system/light_sleep/README.md new file mode 100644 index 0000000000..2fa545dae6 --- /dev/null +++ b/examples/system/light_sleep/README.md @@ -0,0 +1,67 @@ +# Light Sleep Example + +(See the README.md file in the upper level 'examples' directory for more information about examples.) + +This example illustrates usage of light sleep mode. Unlike deep sleep mode, light sleep preserves the state of the memory, CPU, and peripherals. Execution of code on both CPUs is stopped when `esp_light_sleep_start` function is called. When the chip exits light sleep mode, execution continues at the point where it was stopped, and `esp_light_sleep_start` function returns. + +The example enables the following wakeup sources: + +- Timer: wake up the chip in 2 seconds +- EXT0: wake up the chip if a button attached to GPIO0 is pressed (i.e. if GPIO0 goes low) + +The example also prints time spent in light sleep mode to illustrate that timekeeping continues while the chip is in light sleep. + +## How to Use Example + +### Hardware Required + +This example can be used with any ESP32 development board. Most boards have a button attached to GPIO0, often labelled "BOOT". If the board does not have such button, an external button can be connected, along with a 10k pull-up resistor, and a 100nF capacitor to ground for debouncing. + +### Configure the Project + +Run `make menuconfig` and set serial port under Serial Flasher Options. + +### Build and Flash + +Build the project and flash it to the board, then run monitor tool to view serial output: + +``` +make -j4 flash monitor +``` + +(To exit the serial monitor, type ``Ctrl-]``.) + +See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects. + +## Example Output + +``` +Entering light sleep +Returned from light sleep, reason: timer, t=2014 ms, slept for 2000 ms +Entering light sleep +Returned from light sleep, reason: timer, t=4023 ms, slept for 2000 ms +Entering light sleep +Returned from light sleep, reason: pin, t=5297 ms, slept for 1266 ms +Waiting for GPIO0 to go high... +Entering light sleep +Returned from light sleep, reason: timer, t=10072 ms, slept for 2000 ms +Entering light sleep +Returned from light sleep, reason: timer, t=12080 ms, slept for 2000 ms +Entering light sleep +``` + +In the scenario above, the button attached to GPIO0 was pressed and held for about 3 seconds, after the 2nd wakeup from light sleep. The program has indicated the wakeup reason after each sleep iteration. + +## Current Consumption + +In this example, current consumption in light sleep mode is in the range of 0.8 — 1.1 mA. Current consumption in active mode is 28 — 32 mA. Average current consumption is 1.1 - 1.3 mA. + +![Current consumption overview graph](image/light_sleep_scope.png) + +![Current consumption in active mode](image/light_sleep_scope_zoom.png) + + +## Troubleshooting + +If pressing the button attached to GPIO0 does not affect program behavior, check DTR/RTS configuration in the serial monitor. This is not necessary for IDF monitor, but for other tools it might be necessary to set DTR and RTS line state to "disabled" or "de-asserted". + diff --git a/examples/system/light_sleep/example_test.py b/examples/system/light_sleep/example_test.py new file mode 100644 index 0000000000..b0f9c650ba --- /dev/null +++ b/examples/system/light_sleep/example_test.py @@ -0,0 +1,62 @@ +from __future__ import print_function +import re +import os +import sys +import time + +test_fw_path = os.getenv('TEST_FW_PATH') +if test_fw_path and test_fw_path not in sys.path: + sys.path.insert(0, test_fw_path) + +import TinyFW +import IDF + +ENTERING_SLEEP_STR = 'Entering light sleep' +EXIT_SLEEP_REGEX = re.compile(r'Returned from light sleep, reason: (\w+), t=(\d+) ms, slept for (\d+) ms') +WAITING_FOR_GPIO_STR = 'Waiting for GPIO0 to go high...' + +WAKEUP_INTERVAL_MS = 2000 + +@IDF.idf_example_test(env_tag='Example_WIFI') +def test_examples_system_light_sleep(env, extra_data): + dut = env.get_dut('light_sleep_example', 'examples/system/light_sleep') + dut.start_app() + + # Ensure DTR and RTS are de-asserted for proper control of GPIO0 + dut.port_inst.setDTR(False) + dut.port_inst.setRTS(False) + + # enter sleep first time + dut.expect(ENTERING_SLEEP_STR, timeout=30) + # don't check timing here, might be cache dependent + dut.expect(EXIT_SLEEP_REGEX) + print('Got first sleep period') + + # enter sleep second time + dut.expect(ENTERING_SLEEP_STR) + groups = dut.expect(EXIT_SLEEP_REGEX) + print('Got second sleep period, wakeup from {}, slept for {}'.format(groups[0], groups[2])) + # sleep time error should be less than 1ms + assert(groups[0] == 'timer' and int(groups[2]) == WAKEUP_INTERVAL_MS) + + # this time we'll test gpio wakeup + dut.expect(ENTERING_SLEEP_STR) + print('Pulling GPIO0 low using DTR') + dut.port_inst.setDTR(True) + time.sleep(1) + groups = dut.expect(EXIT_SLEEP_REGEX) + print('Got third sleep period, wakeup from {}, slept for {}'.format(groups[0], groups[2])) + assert(groups[0] == 'pin' and int(groups[2]) < WAKEUP_INTERVAL_MS) + + dut.expect(WAITING_FOR_GPIO_STR) + print('Is waiting for GPIO...') + + dut.port_inst.setDTR(False) + dut.expect(ENTERING_SLEEP_STR) + print('Went to sleep again') + groups = dut.expect(EXIT_SLEEP_REGEX) + assert(groups[0] == 'timer' and int(groups[2]) == WAKEUP_INTERVAL_MS) + print('Woke up from timer again') + +if __name__ == '__main__': + test_examples_system_light_sleep() diff --git a/examples/system/light_sleep/image/light_sleep_scope.png b/examples/system/light_sleep/image/light_sleep_scope.png new file mode 100644 index 0000000000000000000000000000000000000000..78f8407931052e6cdba955196ba70505aadd4ad2 GIT binary patch literal 17183 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 literal 0 HcmV?d00001 diff --git a/examples/system/light_sleep/main/component.mk b/examples/system/light_sleep/main/component.mk new file mode 100644 index 0000000000..44bd2b5273 --- /dev/null +++ b/examples/system/light_sleep/main/component.mk @@ -0,0 +1,3 @@ +# +# Main Makefile. This is basically the same as a component makefile. +# diff --git a/examples/system/light_sleep/main/light_sleep_example_main.c b/examples/system/light_sleep/main/light_sleep_example_main.c new file mode 100644 index 0000000000..79436ba3d8 --- /dev/null +++ b/examples/system/light_sleep/main/light_sleep_example_main.c @@ -0,0 +1,90 @@ +/* Light sleep example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. +*/ + +#include +#include +#include +#include +#include +#include "freertos/FreeRTOS.h" +#include "freertos/task.h" +#include "esp_sleep.h" +#include "esp_log.h" +#include "rom/uart.h" +#include "driver/rtc_io.h" + +/* Most development boards have "boot" button attached to GPIO0. + * You can also change this to another pin. + */ +#define BUTTON_GPIO_NUM_DEFAULT 0 + +/* "Boot" button on GPIO0 is active low */ +#define BUTTON_WAKEUP_LEVEL_DEFAULT 0 + +void app_main() +{ + /* Configure the button GPIO as input, enable wakeup */ + const int button_gpio_num = BUTTON_GPIO_NUM_DEFAULT; + const int wakeup_level = BUTTON_WAKEUP_LEVEL_DEFAULT; + gpio_config_t config = { + .pin_bit_mask = BIT64(button_gpio_num), + .mode = GPIO_MODE_INPUT + }; + ESP_ERROR_CHECK(gpio_config(&config)); + gpio_wakeup_enable(button_gpio_num, + wakeup_level == 0 ? GPIO_INTR_LOW_LEVEL : GPIO_INTR_HIGH_LEVEL); + + while (true) { + /* Wake up in 2 seconds, or when button is pressed */ + esp_sleep_enable_timer_wakeup(2000000); + esp_sleep_enable_gpio_wakeup(); + + /* Wait until GPIO goes high */ + if (rtc_gpio_get_level(button_gpio_num) == wakeup_level) { + printf("Waiting for GPIO%d to go high...\n", button_gpio_num); + do { + vTaskDelay(pdMS_TO_TICKS(10)); + } while (rtc_gpio_get_level(button_gpio_num) == wakeup_level); + } + + printf("Entering light sleep\n"); + /* To make sure the complete line is printed before entering sleep mode, + * need to wait until UART TX FIFO is empty: + */ + uart_tx_wait_idle(CONFIG_CONSOLE_UART_NUM); + + /* Get timestamp before entering sleep */ + int64_t t_before_us = esp_timer_get_time(); + + /* Enter sleep mode */ + esp_light_sleep_start(); + /* Execution continues here after wakeup */ + + /* Get timestamp after waking up from sleep */ + int64_t t_after_us = esp_timer_get_time(); + + /* Determine wake up reason */ + const char* wakeup_reason; + switch (esp_sleep_get_wakeup_cause()) { + case ESP_SLEEP_WAKEUP_TIMER: + wakeup_reason = "timer"; + break; + case ESP_SLEEP_WAKEUP_GPIO: + wakeup_reason = "pin"; + break; + default: + wakeup_reason = "other"; + break; + } + + printf("Returned from light sleep, reason: %s, t=%lld ms, slept for %lld ms\n", + wakeup_reason, t_after_us / 1000, (t_after_us - t_before_us) / 1000); + } + +} diff --git a/examples/system/light_sleep/sdkconfig.defaults b/examples/system/light_sleep/sdkconfig.defaults new file mode 100644 index 0000000000..8e2af8cd2c --- /dev/null +++ b/examples/system/light_sleep/sdkconfig.defaults @@ -0,0 +1 @@ +CONFIG_ESP32_DEFAULT_CPU_FREQ_80=y