micrOSDevToolKit 2.10.5__py3-none-any.whl → 2.11.0__py3-none-any.whl

micrOS/source/Debug.py

@@ -1,12 +1,18 @@
+"""
+micrOS Console and Log write interface implementations.
+- with progress led feature, simple and custom
+    Designed by Marcell Ban aka BxNxM
+"""
+
 from machine import Pin
 try:
     from Logger import syslog
 except:
     syslog = None
 try:
-    from microIO import resolve_pin, pinmap_search, detect_platform
+    from microIO import resolve_pin, pinmap_search, register_pin
 except:
-    detect_platform = None
+    pinmap_search = None
 
 
 #############################################
@@ -17,40 +23,53 @@ except:
 class DebugCfg:
     DEBUG = True        # DEBUG PRINT ON/OFF - SET FROM ConfigHandler
     PLED_STEP = None    # PROGRESS LED OBJECT - init in init_pled
-    NEO_WHEEL = None    # NEOPIXEL (ws2812/esp32s3) color wheel object
-    COLOR_INDEX = 0     # APA102 TinyPico color wheel counter
 
     @staticmethod
     def init_pled():
         # CALL FROM ConfigHandler
-        if detect_platform is None:
+        if pinmap_search is None:
             # Check LogicalPins module loadable (robustness...)
             return
-        micro_platform = detect_platform()
-        if micro_platform == "tinypico":
-            # Progress led for TinyPico
-            DebugCfg._init_apa102()
-            return
         pled = pinmap_search('builtin')['builtin']
-        if pled is not None:
-            if isinstance(pled, int):
-                # SET PROGRESS LED WITH BUILT-IN step FUNCTION
-                if micro_platform == "esp32s3":
-                    # Progress led for esp32s3
-                    DebugCfg._init_ws2812()
-                else:
-                    # Progress led for esp32/etc
-                    DebugCfg._init_simple()
-            else:
-                # OVERRIDE PROGRESS LED WITH CUSTOM step FUNCTION
-                DebugCfg.PLED_STEP = pled
+        if pled is None:
+            # No available builtin pin, skip pled init...
+            return
+        # CONFIGURE PROGRESS LED
+        if isinstance(pled, int):
+            # [MODE] Simple flashing progress LED
+            try:
+                # Progress led for esp32/etc
+                led_obj = Pin(abs(resolve_pin('builtin')), Pin.OUT)
+                if resolve_pin('builtin') < 0:
+                    # Pin number start with (-), like -8 (means inverted output)
+                    led_obj.value(1)            # Turn OFF built-in LED state invert (1:OFF)
+                # Set function callback for step function (simple led - blink)
+                DebugCfg.PLED_STEP = lambda: led_obj.value(not led_obj.value())  # # double-blink: return None
+            except Exception as e:
+                errlog_add(f"[PLED] led error: {e}")
+        elif callable(pled):
+            # [MODE] OVERRIDE PROGRESS LED WITH CUSTOM step FUNCTION
+            DebugCfg.PLED_STEP = pled
+            DebugCfg._auto_register_pin()
+        else:
+            errlog_add(f"[WARN] pled type not supported: {pled}")
+
+
+    @staticmethod
+    def _auto_register_pin():
+        try:
+            pin = DebugCfg.PLED_STEP(pin=True)
+            if isinstance(pin, int):
+                register_pin('builtin', pin)
+        except Exception as e:
+            errlog_add(f"[ERR] pled pin registration: {e}", console=False)
+
 
     @staticmethod
     def step():
         """
-        DEBUG LED FEEDBACK
-        - handle 3 types of builtin LEDs: analog, neopixel(ws2812), apa102
-        - automatic selection based on board type + builtin logical pin number
+        DEBUG LED FLASHING FEEDBACK
+        - handle step callback function execution
         """
         try:
             if callable(DebugCfg.PLED_STEP):
@@ -59,69 +78,6 @@ class DebugCfg:
             errlog_add(f"[PLED] step error: {e}")
         return True
 
-    @staticmethod
-    def _init_simple():
-        try:
-            # Progress led for esp32/etc
-            led_obj = Pin(abs(resolve_pin('builtin')), Pin.OUT)
-            if resolve_pin('builtin') < 0:     # Pin number start with (-), like -8 (means inverted output)
-                led_obj.value(1)                # Turn OFF built-in LED state invert (1:OFF)
-            # Set function callback for step function (simple led - blink)
-            DebugCfg.PLED_STEP = lambda: led_obj.value(not led_obj.value())     # # double-blink: return None
-        except Exception as e:
-            errlog_add(f"[PLED] led error: {e}")
-
-    @staticmethod
-    def _init_apa102():
-        try:
-            from machine import SoftSPI
-            from dotstar import DotStar
-            from tinypico import DOTSTAR_CLK, DOTSTAR_DATA, SPI_MISO, set_dotstar_power, dotstar_color_wheel
-            spi = SoftSPI(sck=Pin(DOTSTAR_CLK), mosi=Pin(DOTSTAR_DATA), miso=Pin(SPI_MISO))
-            # Create a DotStar instance
-            dotstar = DotStar(spi, 1, brightness=0.4)  # Just one DotStar, half brightness
-            # Turn on the power to the DotStar
-            set_dotstar_power(True)
-            DebugCfg.PLED_STEP = lambda: DebugCfg._step_apa102(led_obj=dotstar, color_wheel=dotstar_color_wheel)
-        except Exception as e:
-            errlog_add(f"[PLED] apa102 error: {e}")
-
-    @staticmethod
-    def _step_apa102(led_obj, color_wheel):
-        # Get the R,G,B values of the next colour
-        r, g, b = color_wheel(DebugCfg.COLOR_INDEX*2)
-        # Set the colour on the DOTSTAR
-        led_obj[0] = (int(r * 0.6), g, b, 0.4)
-        # Increase the wheel index
-        DebugCfg.COLOR_INDEX = 0 if DebugCfg.COLOR_INDEX > 1000 else DebugCfg.COLOR_INDEX + 2
-        return True                  # No double-blink
-
-    @staticmethod
-    def _init_ws2812():
-        try:
-            from neopixel import NeoPixel
-            neo_pin = Pin(resolve_pin('builtin'))
-            led_obj = NeoPixel(neo_pin, 1)
-            DebugCfg.PLED_STEP = lambda: DebugCfg._step_ws2812(led_obj)
-        except Exception as e:
-            errlog_add(f"[PLED] ws2812 error: {e}")
-
-    @staticmethod
-    def _step_ws2812(led_obj):
-        def _color_wheel():
-            while True:
-                yield 10, 0, 0
-                yield 5, 5, 0
-                yield 0, 10, 0
-                yield 0, 5, 5
-                yield 0, 0, 10
-                yield 5, 0, 5
-        if DebugCfg.NEO_WHEEL is None:
-            DebugCfg.NEO_WHEEL = _color_wheel()
-        led_obj[0] = next(DebugCfg.NEO_WHEEL)
-        led_obj.write()
-        return True                     # No double-blink
-
 
 def console_write(msg):
     if DebugCfg.DEBUG:

micrOS/source/Espnow.py

@@ -225,7 +225,7 @@ class ESPNowSS:
         peer_name = hexlify(peer, ':').decode() if peer_name is None else peer_name
         task_id = f"con.espnow.{peer_name}"
         # Create an asynchronous sending task.
-        state = NativeTask().create(callback=INSTANCE._asend_task(peer, task_id, msg), tag=task_id)
+        state = NativeTask().create(callback=self._asend_task(peer, task_id, msg), tag=task_id)
         return "Starting" if state else "Already running"
 
     # ----------- OTHER METHODS --------------

micrOS/source/Files.py

@@ -1,4 +1,4 @@
-from uos import ilistdir, remove, stat
+from uos import ilistdir, remove, stat, getcwd
 
 ################################   Helper functions   #####################################
 
@@ -9,7 +9,7 @@ def _is_module(path:str='/', pyprefix:str='*') -> bool:
     :param pyprefix: python resource filter prefix, default: * (all: LM and IO)
     """
     # micrOS file types
-    allowed_exts = ('html', 'js', 'css', 'log', 'pds', 'dat')
+    allowed_exts = ('html', 'js', 'css', 'log', 'cache', 'dat')
     mod_prefixes = ('LM', "IO")
     fname = path.split("/")[-1]
     if fname.split("_")[0] in mod_prefixes or fname.split('.')[-1] in allowed_exts:
@@ -99,3 +99,22 @@ def is_file(path):
         return stat(path)[0] & 0x8000
     except OSError:
         return False
+
+
+def path_join(*parts):
+    path = "/".join(part.strip("/") for part in parts if part)
+    if parts and parts[0].startswith("/"):
+        path = "/" + path
+    return path
+
+
+# micrOS system file structure
+class OSPath:
+    _ROOT = getcwd()
+    LOGS = path_join(_ROOT, '/logs')        # system/user logs
+    DATA = path_join(_ROOT,'/data')         # application data
+    WEB = path_join(_ROOT,'/web')           # web resources
+
+    @property
+    def ROOT(self):
+        return self._ROOT

micrOS/source/Hooks.py

@@ -21,6 +21,8 @@ from Config import cfgget, cfgput
 from microIO import detect_platform
 from Debug import console_write, errlog_add
 from Tasks import exec_lm_pipe
+from Files import OSPath, is_dir
+from uos import mkdir
 from micropython import mem_info
 from machine import freq
 try:
@@ -43,7 +45,7 @@ def bootup():
     """
     # Execute LMs from boothook config parameter
     console_write("[BOOT] EXECUTION...")
-    boot_cause()
+    _init_micros_dirs()
     bootasks = cfgget('boothook')
     if bootasks is not None and bootasks.lower() != 'n/a':
         console_write(f"|-[BOOT] TASKS: {bootasks}")
@@ -52,25 +54,34 @@ def bootup():
         else:
             console_write("|-[BOOT] ERROR")
 
-    # Set boostmd (boost mode)
-    platform = detect_platform()
-    if cfgget('boostmd') is True:
-        console_write(f"[BOOT HOOKS] Set up CPU high Hz - boostmd: {cfgget('boostmd')}")
-        if platform == 'esp32c3':
-            freq(160_000_000)   # 160 Mhz (max)
-        elif 'esp32' in platform:
-            freq(240_000_000)   # 240 Mhz (max)
-    else:
-        console_write(f"[BOOT HOOKS] Set up CPU low Hz - boostmd: {cfgget('boostmd')}")
-        if platform == 'esp32c3':
-            freq(80_000_000)   # 80 Mhz / Half the max CPU clock
-        elif 'esp32' in platform:
-            freq(160_000_000)   # 160 Mhz / Half the max CPU clock
+    # Load and Save boot cause
+    boot_cause()
     # Autotune queue size
-    tune_queue_size()
+    _tune_queue_size()
+    # Configure CPU performance
+    _tune_performance()
+
+
+def _init_micros_dirs():
+    """
+    Init micrOS root file system directories
+    """
+    root_dirs = [
+        getattr(OSPath, key)
+        for key in dir(OSPath)
+        if not key.startswith("_") and isinstance(getattr(OSPath, key), str)
+    ]
+    console_write(f"|-[BOOT] rootFS validation: {root_dirs}")
+    for dir_path in root_dirs:
+        if not is_dir(dir_path):
+            try:
+                mkdir(dir_path)
+                errlog_add(f"[BOOT] init dir: {dir_path}")
+            except Exception as e:
+                errlog_add(f"[ERR][BOOT] cannot init dir {dir_path}: {e}")
 
 
-def tune_queue_size():
+def _tune_queue_size():
     """
     Tune queue size based on available ram
     between 5-50
@@ -84,6 +95,23 @@ def tune_queue_size():
         cfgput('aioqueue', est_queue)
 
 
+def _tune_performance():
+    # Set boosted (boost mode)
+    platform = detect_platform()
+    if cfgget('boostmd') is True:
+        console_write(f"[BOOT HOOKS] Set up CPU high Hz - boostmd: {cfgget('boostmd')}")
+        if platform == 'esp32c3':
+            freq(160_000_000)   # 160 Mhz (max)
+        elif 'esp32' in platform:
+            freq(240_000_000)   # 240 Mhz (max)
+    else:
+        console_write(f"[BOOT HOOKS] Set up CPU low Hz - boostmd: {cfgget('boostmd')}")
+        if platform == 'esp32c3':
+            freq(80_000_000)   # 80 Mhz / Half the max CPU clock
+        elif 'esp32' in platform:
+            freq(160_000_000)   # 160 Mhz / Half the max CPU clock
+
+
 def profiling_info(label=""):
     """
     Runtime memory measurements
@@ -111,3 +139,18 @@ def boot_cause():
             reason = 5, "SoftReset"
     errlog_add(f"[BOOT] info: {reason[1]}")
     return reason
+
+
+def enableESPNow() -> str:
+    """
+    Enable ESP-NOW communication
+    """
+    if cfgget('espnow'):
+        try:
+            from Espnow import ESPNowSS
+            verdict = ESPNowSS().start_server()
+            console_write(f"[TASK] Start ESPNow-InterCon server: {verdict}")
+        except Exception as e:
+            errlog_add(f"[ERR] Start ESPNow-InterCon server: {e}")
+            return str(e)
+    return "ESPNow disabled"

micrOS/source/IO_esp32c6.py

@@ -0,0 +1,16 @@
+from micropython import const
+
+# BUILTIN LED
+builtin = const(-15)     # BUILT IN LED - progress_led
+
+
+# I2C BUS
+i2c_sda = const(4)    # D21 - oled - data
+i2c_scl = const(5)    # D22 - oled - clock
+
+
+# EXTERNAL EVENT IRQ
+irq1 = const(3)         # D4  - event irq pin
+irq2 = const(2)        # D18 - event irq pin
+irq3 = const(1)         # D19  - event irq pin
+irq4 = const(0)        # D13  - event irq pin

micrOS/source/IO_esp32s3.py

@@ -1,7 +1,43 @@
 from micropython import const
 
+#### DEFINE CUSTOM PROGRESS LED LOGIC ####
+class WS2812:
+    NEOPIXEL = None
+    WHEEL = None
+    PIN = const(38)                                     # BUILT IN LED - progress_led
+
+try:
+    # init ws2812
+    from machine import Pin
+    from neopixel import NeoPixel
+    WS2812.NEOPIXEL = NeoPixel(Pin(WS2812.PIN), 1)
+except Exception as e:
+    print(f"[Error] IO error, esp21se ws2812: {e}")
+
+
+def _step_ws2812(pin=False):
+    if pin:
+        return WS2812.PIN
+
+    def _color_wheel():
+        while True:
+            yield 10, 0, 0
+            yield 5, 5, 0
+            yield 0, 10, 0
+            yield 0, 5, 5
+            yield 0, 0, 10
+            yield 5, 0, 5
+
+    if WS2812.WHEEL is None:
+        WS2812.WHEEL = _color_wheel()
+    WS2812.NEOPIXEL[0] = next(WS2812.WHEEL)
+    WS2812.NEOPIXEL.write()
+    return True  # No double-blink
+
+#######################################
+
 # BUILTIN LED
-builtin = const(38)     # BUILT IN LED - progress_led
+builtin = _step_ws2812     # BUILT IN LED - progress_led
 
 # ANALOG RGB + WW + CW
 redgb = const(37)      # - rgb red channel [PWM]

micrOS/source/IO_m5stamp.py

@@ -1,7 +1,41 @@
 from micropython import const
 
+#### DEFINE CUSTOM PROGRESS LED LOGIC ####
+class WS2812:
+    NEOPIXEL = None
+    WHEEL = None
+    PIN = const(21)                                     # BUILT IN LED - progress_led
+
+try:
+    # init ws2812
+    from machine import Pin
+    from neopixel import NeoPixel
+    WS2812.NEOPIXEL = NeoPixel(Pin(WS2812.PIN), 1)
+except Exception as e:
+    print(f"[Error] IO error, esp21se ws2812: {e}")
+
+
+def _step_ws2812(pin=False):
+    if pin:
+        return WS2812.PIN
+
+    def _color_wheel():
+        while True:
+            yield 10, 0, 0
+            yield 5, 5, 0
+            yield 0, 10, 0
+            yield 0, 5, 5
+            yield 0, 0, 10
+            yield 5, 0, 5
+
+    if WS2812.WHEEL is None:
+        WS2812.WHEEL = _color_wheel()
+    WS2812.NEOPIXEL[0] = next(WS2812.WHEEL)
+    WS2812.NEOPIXEL.write()
+    return True  # No double-blink
+
 # BUILTIN LED
-builtin = const(21)    # BUILT IN LED - progress_led
+builtin = _step_ws2812    # BUILT IN LED - progress_led
 
 # ANALOG RGB + WW + CW
 redgb = const(43)      # - rgb red channel [PWM]

micrOS/source/IO_qtpy.py

@@ -1,20 +1,26 @@
 from micropython import const
-from machine import Pin
-
 
 #### DEFINE CUSTOM PROGRESS LED LOGIC ####
+class WS2812:
+    NEOPIXEL = None
+    WHEEL = None
+    PIN = const(5)                                      # BUILT IN LED - progress_led
+    PIN_ENABLE = const(8)                               # Power ON LED
+
 try:
+    # init ws2812
     from neopixel import NeoPixel
-    Pin(8, Pin.OUT).value(1)        # Power ON LED
-    PLED_OBJ = NeoPixel(Pin(5), 1)  # Init neopixel
-    NEO_WHEEL = None
+    from machine import Pin
+    Pin(WS2812.PIN_ENABLE, Pin.OUT).value(1)            # Power ON LED
+    WS2812.NEOPIXEL = NeoPixel(Pin(WS2812.PIN), 1)      # BUILT IN LED - progress_led
 except Exception as e:
-    print(f"[PLED CUSTOM] ws2812 error: {e}")
-    PLED_OBJ = None
+    print(f"[Error] IO error, esp21se ws2812: {e}")
+
 
+def _step_ws2812(pin=False):
+    if pin:
+        return WS2812.PIN
 
-def _step_ws2812():
-    global PLED_OBJ, NEO_WHEEL
     def _color_wheel():
         while True:
             yield 10, 0, 0
@@ -23,15 +29,14 @@ def _step_ws2812():
             yield 0, 5, 5
             yield 0, 0, 10
             yield 5, 0, 5
-    if PLED_OBJ is None:
-        return False
-    if NEO_WHEEL is None:
-        NEO_WHEEL = _color_wheel()
-    PLED_OBJ[0] = next(NEO_WHEEL)
-    PLED_OBJ.write()
-    return True
-###########################################
 
+    if WS2812.WHEEL is None:
+        WS2812.WHEEL = _color_wheel()
+    WS2812.NEOPIXEL[0] = next(WS2812.WHEEL)
+    WS2812.NEOPIXEL.write()
+    return True  # No double-blink
+
+###########################################
 
 # BUILTIN LED
 builtin = _step_ws2812

micrOS/source/IO_s3matrix.py

@@ -0,0 +1,21 @@
+from micropython import const
+
+# ESP32-S3 Matrix 8x8 RGB-LED WiFi Bluetooth With QST Attitude Gyro Sensor QMI8658C
+# https://spotpear.com/shop/ESP32-S3FH4R2-Matrix-8x8-RGB-LED-WiFi-Bluetooth-QST-Attitude-Gyro-Sensor-QMI8658C-Arduino-Python-ESP-IDF.html
+
+# Progress LED (no builting available)
+builtin = const(1)     # LED - progress_led
+
+# DIGITAL LED
+neop = const(14)       # - neopixel OneWire bus [PWM]
+
+# I2C BUS (QMI8658C GYRO)
+i2c_sda = const(11)    # - data
+i2c_scl = const(12)    # - clock
+
+
+# EXTERNAL EVENT IRQ
+irq1 = const(33)        # - event irq pin
+irq2 = const(34)        # - event irq pin
+irq3 = const(35)        # - event irq pin
+irq4 = const(36)        # - event irq pin

micrOS/source/IO_tinypico.py

@@ -1,5 +1,43 @@
 from micropython import const
 
+#### DEFINE CUSTOM PROGRESS LED LOGIC ####
+class APA102:
+    DOTSTAR = None
+    COLOR_WHEEL = None
+    COLOR_INDEX:int = 0
+
+try:
+    # init apa102
+    from machine import Pin
+    from machine import SoftSPI
+    from dotstar import DotStar
+    from tinypico import DOTSTAR_CLK, DOTSTAR_DATA, SPI_MISO, set_dotstar_power, dotstar_color_wheel
+    spi = SoftSPI(sck=Pin(DOTSTAR_CLK), mosi=Pin(DOTSTAR_DATA), miso=Pin(SPI_MISO))
+    # Create a DotStar instance
+    APA102.DOTSTAR = DotStar(spi, 1, brightness=0.4)  # Just one DotStar, half brightness
+    # Turn on the power to the DotStar
+    set_dotstar_power(True)
+    APA102.COLOR_WHEEL = dotstar_color_wheel
+except Exception as e:
+    print(f"[Error] IO error, tinypico apa102: {e}")
+
+def _step_apa102(pin=False):
+    if pin:
+        return None
+    # Get the R,G,B values of the next colour
+    r, g, b = APA102.COLOR_WHEEL(APA102.COLOR_INDEX*2)
+    # Set the colour on the DOTSTAR
+    APA102.DOTSTAR[0] = (int(r * 0.6), g, b, 0.4)
+    # Increase the wheel index
+    APA102.COLOR_INDEX = 0 if APA102.COLOR_INDEX > 1000 else APA102.COLOR_INDEX + 2
+    return True                  # No double-blink
+
+###################################################
+
+
+# BUILTIN LED
+builtin = _step_apa102
+
 # ANALOG RGB + WW + CW
 redgb = const(25)       # D25 - rgb red channel [PWM CH1]
 rgreenb = const(26)     # D26 - rgb green channel [PWM CH2]

micrOS/source/LM_VL53L0X.py

@@ -343,7 +343,7 @@ class VL53L0X:
 
 def measure():
     """
-    Experimental
+    Experimental - Time of Flight Distance Sensor
     """
     global __TOF_OBJ
     if __TOF_OBJ is None:

micrOS/source/LM_buzzer.py

@@ -1,7 +1,6 @@
-from sys import platform
 from utime import sleep
 from microIO import bind_pin, pinmap_search
-from Common import micro_task, notify
+from Common import micro_task, notify, data_dir
 from Types import resolve
 
 
@@ -13,6 +12,7 @@ __BUZZER_OBJ = None
 __BUZZER_CACHE = [600]
 __PERSISTENT_CACHE = False
 __TASK_TAG = "buzzer._play"
+__FILE_CACHE = data_dir('buzzer.cache')
 CHECK_NOTIFY = False
 
 #########################################
@@ -190,7 +190,7 @@ def __buzzer_init(pin=None):
 
 def __persistent_cache_manager(mode='r'):
     """
-    pds - persistent data structure
+    File cache
     modes:
         r - recover, s - save
     """
@@ -199,12 +199,12 @@ def __persistent_cache_manager(mode='r'):
     global __BUZZER_CACHE
     if mode == 's':
         # SAVE CACHE
-        with open('buzzer.pds', 'w') as f:
+        with open(__FILE_CACHE, 'w') as f:
             f.write(','.join([str(k) for k in __BUZZER_CACHE]))
         return
     try:
         # RESTORE CACHE
-        with open('buzzer.pds', 'r') as f:
+        with open(__FILE_CACHE, 'r') as f:
             __BUZZER_CACHE = [int(data) for data in f.read().strip().split(',')]
     except:
         pass
@@ -288,10 +288,9 @@ def load(check_notify=False, pin=None, cache=True):
     Initialize buzzer module
     :param check_notify: check notify enabled/disabled - make noise if enabled only
     :param pin: optional number to overwrite default pin
-    :param cache: default True, store stages on disk (.pds)
+    :param cache: default True, store stages on disk (.cache)
     :return str: Verdict
     """
-    from sys import platform
     global __PERSISTENT_CACHE, CHECK_NOTIFY
     __PERSISTENT_CACHE = cache
     __persistent_cache_manager('r')

micrOS/source/LM_cct.py

@@ -4,7 +4,7 @@
 from machine import Pin, PWM
 from sys import platform
 from utime import sleep_ms
-from Common import transition_gen, micro_task
+from Common import transition_gen, micro_task, data_dir
 from microIO import bind_pin, pinmap_search
 from random import randint
 from Types import resolve
@@ -18,6 +18,7 @@ class Data:
     CCT_TASK_TAG = 'cct._tran'
     HUE_TASK_TAG = 'cct._hue'
     TASK_STATE = False
+    FILE_CACHE = data_dir('cwww.cache')
 
 
 #########################################
@@ -39,7 +40,7 @@ def __cwww_init(pin_warm=None, pin_cold=None):
 
 def __persistent_cache_manager(mode):
     """
-    pds - persistent data structure
+    File state cache
     modes:
         r - recover, s - save
     """
@@ -47,12 +48,12 @@ def __persistent_cache_manager(mode):
         return
     if mode == 's':
         # SAVE CACHE
-        with open('cwww.pds', 'w') as f:
+        with open(Data.FILE_CACHE, 'w') as f:
             f.write(','.join([str(k) for k in Data.CWWW_CACHE]))
         return
     try:
         # RESTORE CACHE
-        with open('cwww.pds', 'r') as f:
+        with open(Data.FILE_CACHE, 'r') as f:
             Data.CWWW_CACHE = [float(data) for data in f.read().strip().split(',')]
     except:
         pass
@@ -77,7 +78,7 @@ def load(pin_warm=None, pin_cold=None, cache=True):
     Initialize Cold white / Warm white LED module
     :param pin_warm: optional number to overwrite default pin
     :param pin_cold: optional number to overwrite default pin
-    :param cache: save/load state machine to disk (.pds)
+    :param cache: save/load state machine to disk (.cache)
     :return str: Cache state
     """
     __cwww_init(pin_warm, pin_cold)