micrOSDevToolKit 2.10.6__py3-none-any.whl → 2.13.0__py3-none-any.whl

micrOS/source/Espnow.py

@@ -4,7 +4,7 @@ from Tasks import NativeTask, TaskBase, lm_exec, lm_is_loaded
 import uasyncio as asyncio
 from Network import get_mac
 from Config import cfgget
-from Debug import errlog_add
+from Debug import syslog
 
 
 # ----------- PARSE AND RENDER MSG PROTOCOL  --------------
@@ -14,7 +14,7 @@ def render_response(tid, oper, data, prompt) -> str:
     Render ESPNow custom message (protocol)
     """
     if oper not in ("REQ", "RSP"):
-        errlog_add(f"[ERR] espnow render_response, unknown oper: {oper}")
+        syslog(f"[ERR] espnow render_response, unknown oper: {oper}")
     tmp = "{tid}|{oper}|{data}|{prompt}$"
     tmp = tmp.replace("{tid}", str(tid))
     tmp = tmp.replace("{oper}", str(oper))
@@ -68,7 +68,7 @@ class ResponseRouter:
         # USE <tid> for proper session response mapping
         router = ResponseRouter._routes.get(mac)
         if router is None:
-            errlog_add(f"[WARN][ESPNOW] No response route for {mac}")
+            syslog(f"[WARN][ESPNOW] No response route for {mac}")
             return
         router.response = response
         router._event.set()
@@ -157,7 +157,7 @@ class ESPNowSS:
                     if state:
                         await self.__asend_raw(mac, response)
                     else:
-                        errlog_add(response)
+                        syslog(response)
                 except OSError as err:
                     # If the peer is not yet added, add it and retry.
                     if len(err.args) > 1 and err.args[1] == 'ESP_ERR_ESPNOW_NOT_FOUND':
@@ -166,10 +166,10 @@ class ESPNowSS:
                         if state:
                             await self.__asend_raw(mac, response)
                         else:
-                            errlog_add(response)
+                            syslog(response)
                     else:
                         # Optionally handle or log other OSErrors here.
-                        errlog_add(f"[ERR][NOW SERVER] {err}")
+                        syslog(f"[ERR][NOW SERVER] {err}")
 
     def start_server(self):
         """
@@ -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,24 @@ 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')        # Logs (.log)
+    DATA = path_join(_ROOT,'/data')         # Application data (.dat, .cache, etc.)
+    WEB = path_join(_ROOT,'/web')           # Web resources (.html, .css, .js, .json, etc.)
+    MODULES = path_join(_ROOT, '/modules')  # Application modules (.mpy, .py) (todo)
+    CONFIG = path_join(_ROOT, '/config')    # System configuration files (node_config.json, etc.)(todo)
+
+    @property
+    def ROOT(self):
+        return self._ROOT

micrOS/source/Hooks.py

@@ -19,8 +19,10 @@ Designed by Marcell Ban aka BxNxM
 #################################################################
 from Config import cfgget, cfgput
 from microIO import detect_platform
-from Debug import console_write, errlog_add
+from Debug import console_write, syslog
 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)
+                syslog(f"[BOOT] init dir: {dir_path}")
+            except Exception as e:
+                syslog(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
@@ -109,5 +137,20 @@ def boot_cause():
             reason = 4, "DSWakeUp"
         elif reset_reason == SOFT_RESET:
             reason = 5, "SoftReset"
-    errlog_add(f"[BOOT] info: {reason[1]}")
+    syslog(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:
+            syslog(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/InterConnect.py

@@ -1,7 +1,7 @@
 from socket import getaddrinfo, SOCK_STREAM
 from re import compile
 from uasyncio import open_connection
-from Debug import errlog_add
+from Debug import syslog
 from Config import cfgget
 from Server import Server
 from Tasks import NativeTask
@@ -41,7 +41,7 @@ class InterCon:
                     host = addr_info[-1][4][0]
                 except OSError as e:
                     Server.reply_all(f"[intercon] NoHost: {e}")
-                    errlog_add(f"[intercon] send_cmd {host} oserr: {e}")
+                    syslog(f"[intercon] send_cmd {host} oserr: {e}")
                     return ''
             else:
                 # Restore IP from cache by hostname
@@ -55,7 +55,7 @@ class InterCon:
                 output = await self.__run_command(cmd, hostname)
             except OSError as e:
                 Server.reply_all(f"[intercon] NoHost: {e}")
-                errlog_add(f"[intercon] send_cmd {host} oserr: {e}")
+                syslog(f"[intercon] send_cmd {host} oserr: {e}")
                 output = None
             finally:
                 if self.writer:
@@ -69,7 +69,7 @@ class InterCon:
             # None: ServerBusy(or \0) or Prompt mismatch (auto delete cached IP), STR: valid comm. output
             return output
         else:
-            errlog_add(f"[ERR][intercon] Invalid host: {host}")
+            syslog(f"[ERR][intercon] Invalid host: {host}")
         return ''
 
     async def __run_command(self, cmd:list, hostname:str):
@@ -103,7 +103,7 @@ class InterCon:
             await self.writer.drain()
             data, prompt = await self.__receive_data(prompt=prompt)
         except Exception as e:
-            errlog_add(f'[intercon][ERR] Auth: {e}')
+            syslog(f'[intercon][ERR] Auth: {e}')
             data = 'AuthFailed'
         if 'AuthOk' in data:
             return True             # AuthOk

micrOS/source/Interrupts.py

@@ -19,7 +19,7 @@ Reference: https://docs.micropython.org/en/latest/library/machine.Pin.html
 from machine import Pin
 from utime import ticks_ms, ticks_diff
 from Config import cfgget
-from Debug import console_write, errlog_add
+from Debug import console_write, syslog
 from Tasks import exec_lm_pipe_schedule
 from microIO import resolve_pin
 if cfgget('cron'):
@@ -157,7 +157,7 @@ def initEventIRQs():
         try:
             return resolve_pin(_p)
         except Exception as e:
-            errlog_add(f'[ERR][!] EVENT {_p} IO error: {e}')
+            syslog(f'[ERR][!] EVENT {_p} IO error: {e}')
         return None
 
     # Load External IRQ (1-4) execution data set from node config

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)

micrOS/source/LM_dashboard_be.py

@@ -1,4 +1,4 @@
-from Common import web_endpoint, syslog
+from Common import web_dir, web_endpoint, syslog
 
 ENDPOINT_INITED = False
 
@@ -8,7 +8,7 @@ def load():
 
 def _dashboard_clb():
     try:
-        with open('dashboard.html', 'r') as html:
+        with open(web_dir('dashboard.html'), 'r') as html:
             html_content = html.read()
         return 'text/html', html_content
     except Exception as e:

micrOS/source/LM_dimmer.py

@@ -1,6 +1,6 @@
 from sys import platform
 from microIO import bind_pin, pinmap_search
-from Common import transition_gen, micro_task
+from Common import transition_gen, micro_task, data_dir
 from utime import sleep_ms
 from Types import resolve
 
@@ -15,6 +15,7 @@ class Data:
     PERSISTENT_CACHE = False
     DIMM_TASK_TAG = "dimmer._tran"
     TASK_STATE = False
+    FILE_CACHE = data_dir('dimmer.cache')
 
 
 #########################################
@@ -34,7 +35,7 @@ def __dimmer_init():
 
 def __persistent_cache_manager(mode='r'):
     """
-    pds - persistent data structure
+    File cache
     modes:
         r - recover, s - save
     """
@@ -42,12 +43,12 @@ def __persistent_cache_manager(mode='r'):
         return
     if mode == 's':
         # SAVE CACHE
-        with open('dimmer.pds', 'w') as f:
+        with open(Data.FILE_CACHE, 'w') as f:
             f.write(','.join([str(k) for k in Data.DIMMER_CACHE]))
         return
     try:
         # RESTORE CACHE
-        with open('dimmer.pds', 'r') as f:
+        with open(Data.FILE_CACHE, 'r') as f:
             Data.DIMMER_CACHE = [int(data) for data in f.read().strip().split(',')]
     except:
         pass
@@ -71,7 +72,7 @@ def load(cache=None):
     """
     Initialize dimmer module
     :param cache bool: file state machine cache: True/False/None(default: automatic True)
-    - Load .pds (state machine cache) for this load module
+    - Load .cache (state machine cache) for this load module
     - Apply loaded states to gpio pins (boot function)
     :return str: Cache state
     """