Replace STM32L0.stop() by STM32L0.deepsleep(); add STM32L0.enablePowerSave() / STM32L0.disablePowerSave() to allow better default power savings

Author: GrumpyOldPizza

cores/arduino/delay.c

@@ -59,7 +59,7 @@ void delay(uint32_t timeout)
 	{
 	    timeout = end - now;
 
-	    stm32l0_system_sleep(STM32L0_SYSTEM_POLICY_RUN, timeout);
+	    stm32l0_system_sleep(g_defaultPolicy, timeout);
 
 	    now = millis();
 	}

cores/arduino/wiring.c

@@ -69,6 +69,8 @@ void HardFault_Handler(void)
 
 int g_swdStatus = 0;
 
+int g_defaultPolicy = STM32L0_SYSTEM_POLICY_RUN;
+  
 uint32_t g_wakeupControl = 0;
 
 void init( void )

cores/arduino/wiring_private.h

@@ -75,6 +75,8 @@ extern void WMSGSM42_Initialize(void);
 
 extern int g_swdStatus;  /* 0, default, 1 = enable, 2 = disable, 3 = forced disable */
 
+extern int g_defaultPolicy;
+
 extern uint32_t g_wakeupControl;
 
 extern void (*g_serialEventRun)(void);

libraries/DOSFS/examples/DOSFS_DataLogger/DOSFS_DataLogger.ino

@@ -15,7 +15,7 @@
  * that if no wok is pending, the SDCARD/SFLASH can go
  * to sleep, hence consuming less power.
  *
- * The loop is run every 5 seconds (STM32L0.stop() to
+ * The loop is run every 5 seconds (STM32L0.deepsleep() to
  * put STM32L0 into STOP mode). Every 60 seconds the current
  * log file is printed out.
  *
@@ -75,7 +75,7 @@ void loop( void )
         }
     }
 
-    STM32L0.stop(5000);
+    STM32L0.deepsleep(5000);
 }
 
 

libraries/GNSS/examples/GNSS_periodic/GNSS_periodic.ino

@@ -33,7 +33,7 @@ void setup( void )
 
 void loop( void )
 {
-    STM32L0.stop();
+    STM32L0.deepsleep();
 
     if (GNSS.location(myLocation))
     {

libraries/GNSS/examples/GNSS_suspend/GNSS_suspend.ino

@@ -54,7 +54,7 @@ void setup( void )
 
 void loop( void )
 {
-    STM32L0.stop();
+    STM32L0.deepsleep();
 
     if (GNSS.location(myLocation))
     {

libraries/LoRaWAN/examples/LoRaWAN_DeepSleep/LoRaWAN_DeepSleep.ino

@@ -2,7 +2,7 @@
  *  
  *  The code joins the network and sends 50 packets. Then it
  *  shuts down the USB connection (which blocks STOP mode),
- *  and then uses STM32L0.stop() instead of delay() to
+ *  and then uses STM32L0.deepsleep() instead of delay() to
  *  wait. STOP mode consumes about 2.1uA for the MCU and
  *  SX1272/SX176. SLEEP mode (which is used during delay())
  *  consumes about 2mA. 
@@ -132,6 +132,6 @@ void loop( void )
     }
     else
     {
-        STM32L0.stop(30000);
+        STM32L0.deepsleep(30000);
     }
 }

libraries/LoRaWAN/examples/LoRaWAN_TimerMillis/LoRaWAN_TimerMillis.ino

@@ -2,7 +2,7 @@
  *  
  *  Idea is to start a periodic timer, where every 10 seconds a packet
  *  is send to the gateway in the background. The main "loop()" could
- *  be reading sensors in the forground, or use STM32L0.stop() to enter
+ *  be reading sensors in the forground, or use STM32L0.deepsleep() to enter
  *  STOP mode.
  *  
  *  In setup() below please replace the argument to LoRaWAN.begin()

libraries/STM32L0/keywords.txt

@@ -19,11 +19,14 @@ getVREF				KEYWORD2
 getTemperature			KEYWORD2
 resetCause			KEYWORD2
 wakeupReason			KEYWORD2
+enablePowerSave			KEYWORD2
+disablePowerSave		KEYWORD2
 wakeup				KEYWORD2
 sleep				KEYWORD2
-stop				KEYWORD2
+deepsleep			KEYWORD2
 standby				KEYWORD2
 reset				KEYWORD2
+dfu				KEYWORD2
 wdtEnable 			KEYWORD2
 wdtReset 			KEYWORD2
 flashErase			KEYWORD2

libraries/STM32L0/src/STM32L0.cpp

@@ -119,17 +119,27 @@ uint32_t STM32L0Class::wakeupReason()
     return stm32l0_system_wakeup_reason();
 }
 
+void STM32L0Class::enablePowerSave()
+{
+    g_defaultPolicy = STM32L0_SYSTEM_POLICY_SLEEP;
+}
+
+void STM32L0Class::disablePowerSave()
+{
+    g_defaultPolicy = STM32L0_SYSTEM_POLICY_RUN;
+}
+
 void STM32L0Class::wakeup()
 {
     stm32l0_system_wakeup();
 }
 
 void STM32L0Class::sleep(uint32_t timeout)
 {
-    stm32l0_system_sleep(STM32L0_SYSTEM_POLICY_SLEEP, timeout);
+    stm32l0_system_sleep(g_defaultPolicy, timeout);
 }
 
-void STM32L0Class::stop(uint32_t timeout)
+void STM32L0Class::deepsleep(uint32_t timeout)
 {
     if (g_swdStatus == 0) {
         stm32l0_system_swd_disable();
@@ -150,6 +160,11 @@ void STM32L0Class::reset()
     stm32l0_system_reset();
 }
 
+void STM32L0Class::dfu()
+{
+    stm32l0_system_dfu();
+}
+
 void STM32L0Class::swdEnable()
 {
     if (g_swdStatus != 3) {

libraries/STM32L0/src/STM32L0.h

@@ -62,11 +62,14 @@ class STM32L0Class {
     uint32_t resetCause();
     uint32_t wakeupReason();
 
+    void  enablePowerSave();
+    void  disablePowerSave();
     void  wakeup();
     void  sleep(uint32_t timeout = 0xffffffff);
-    void  stop(uint32_t timeout = 0xffffffff);
+    void  deepsleep(uint32_t timeout = 0xffffffff);
     void  standby(uint32_t timeout = 0xffffffff);
     void  reset();
+    void  dfu();
 
     void  swdEnable();
     void  swdDisable();
@@ -76,6 +79,10 @@ class STM32L0Class {
 
     bool  flashErase(uint32_t address, uint32_t count);
     bool  flashProgram(uint32_t address, const void *data, uint32_t count);
+
+ public:
+    void  stop(uint32_t timeout = 0xffffffff) __attribute__((deprecated("use STM32L0.deepsleep() instead"))) { deepsleep(timeout); }
+    
 };
 
 extern STM32L0Class STM32L0;