micrOSDevToolKit 2.1.5__py3-none-any.whl → 2.26.1__py3-none-any.whl

toolkit/workspace/precompiled/LM_demo.py

@@ -1,85 +0,0 @@
-from random import randint
-from microIO import detect_platform
-from Debug import console_write
-from Time import uptime
-
-CNT = 0
-
-
-def _debug(func):
-    """
-    Debug wrapper
-    - console logging
-    - handled cmd counter (exec_info to get the value)
-    """
-    def __wrapper(*args, **kwargs):
-        global CNT
-        CNT += 1
-        console_write("debug module cmd executed")     # + Progress LED
-        return func(*args, **kwargs)
-    return __wrapper
-
-
-@_debug
-def hello(name="MrNobody"):
-    return f"Hello {name}! This is a micrOS smart endpoint ☁️, running on {detect_platform()}.\
-    \nFor more info call `demo links` function :D"
-
-
-@_debug
-def calculator(a, b, op="+"):
-    if op.strip() == "+":
-        return f"{a} + {b} = {a + b}"
-    if op.strip() == "-":
-        return f"{a} - {b} = {a - b}"
-    if op.strip() == "/":
-        return f"{a} / {b} = {round(a / b, 3)}"
-    if op.strip() == "*":
-        return f"{a} * {b} = {a * b}"
-
-
-@_debug
-def dice_cube():
-    value = randint(1, 6)
-    return f"🎲 {value}"
-
-
-@_debug
-def yes_no():
-    val = randint(0, 1)
-    return 'NO👎' if val == 0 else 'YES👍'
-
-
-@_debug
-def links():
-    descript = f"Platform: {detect_platform()}\nGITHUB: https://github.com/BxNxM/micrOS\nYOUTUBE: https://www.youtube.com/@micrOSframework\nINSTAGRAM: https://instagram.com/micros_framework"
-    return descript
-
-
-@_debug
-def source():
-    return 'https://github.com/BxNxM/micrOS/blob/master/micrOS/source/LM_demo.py'
-
-
-@_debug
-def exec_info():
-    global CNT
-    return f"Under {uptime()}: {CNT} cmd served."
-
-
-@_debug
-def help(widgets=False):
-    """
-    [i] micrOS LM naming convention - built-in help message
-    :return tuple:
-        (widgets=False) list of functions implemented by this application
-        (widgets=True) list of widget json for UI generation
-    """
-    return 'hello name="MrNobody"',\
-           'calculator a b op="+"',\
-           '\t=>op: + - / *',\
-           'dice_cube - show number, roll a dice',\
-           'yes_no    - show random yes/no',\
-           'links     - show micrOS links',\
-           'source    - show demo module source code',\
-           'exec_info - Execution info, demo module usage'

toolkit/workspace/precompiled/LM_distance.py

@@ -1,88 +0,0 @@
-from machine import Pin, time_pulse_us
-from utime import sleep_us
-from microIO import physical_pin, pinmap_dump
-
-__TRIGGER_OBJ = None
-__ECHO_OBJ = None
-
-
-def __init_HCSR04():
-    global __TRIGGER_OBJ, __ECHO_OBJ
-    if __TRIGGER_OBJ is None or __ECHO_OBJ is None:
-        trigger_pin = physical_pin('hcsrtrig')
-        echo_pin = physical_pin('hcsrecho')
-        # Init trigger pin (out)
-        __TRIGGER_OBJ = Pin(trigger_pin, mode=Pin.OUT, pull=None)
-        __TRIGGER_OBJ.value(0)
-        # Init echo pin (in)
-        __ECHO_OBJ = Pin(echo_pin, mode=Pin.IN, pull=None)
-    return __TRIGGER_OBJ, __ECHO_OBJ
-
-
-def __send_pulse_and_wait(echo_timeout_us=1000000):
-    trigger_pin, echo_pin = __init_HCSR04()
-    trigger_pin.value(0) # Stabilize the sensor
-    sleep_us(5)
-    trigger_pin.value(1)
-    # Send a 10us pulse.
-    sleep_us(10)
-    trigger_pin.value(0)
-    try:
-        pulse_time = time_pulse_us(echo_pin, 1, echo_timeout_us)
-        return pulse_time
-    except OSError as ex:
-        if ex.args[0] == 110: # 110 = ETIMEDOUT
-            raise OSError('Out of range')
-        raise ex
-
-
-#########################
-# Application functions #
-#########################
-
-def distance_mm():
-    """
-    To calculate the distance we get the pulse_time and divide it by 2
-    (the pulse walk the distance twice) and by 29.1 becasue
-    the sound speed on air (343.2 m/s), that It's equivalent to
-    0.34320 mm/us that is 1mm each 2.91us
-    pulse_time // 2 // 2.91 -> pulse_time // 5.82 -> pulse_time * 100 // 582
-    """
-    return __send_pulse_and_wait() * 100 // 582
-
-
-def distance_cm():
-    return (__send_pulse_and_wait() / 2) / 29.1
-
-
-def deinit():
-    global __TRIGGER_OBJ, __ECHO_OBJ
-    trigger_pin, echo_pin = __init_HCSR04()
-    trigger_pin.deinit()
-    echo_pin.deinit()
-    __TRIGGER_OBJ = None
-    __ECHO_OBJ = None
-
-
-#######################
-# LM helper functions #
-#######################
-
-def pinmap():
-    """
-    [i] micrOS LM naming convention
-    Shows logical pins - pin number(s) used by this Load module
-    - info which pins to use for this application
-    :return dict: pin name (str) - pin value (int) pairs
-    """
-    return pinmap_dump(['hcsrtrig', 'hcsrecho'])
-
-
-def help(widgets=False):
-    """
-    [i] micrOS LM naming convention - built-in help message
-    :return tuple:
-        (widgets=False) list of functions implemented by this application
-        (widgets=True) list of widget json for UI generation
-    """
-    return 'distance_mm', 'distance_cm', 'deinit', 'pinmap'

toolkit/workspace/precompiled/LM_i2c.py

@@ -1,44 +0,0 @@
-from microIO import physical_pin, pinmap_dump
-
-__I2C = None
-
-
-def __init():
-    global __I2C
-    if __I2C is None:
-        from machine import Pin, I2C
-        __I2C = I2C(-1, Pin(physical_pin('i2c_scl')), Pin(physical_pin('i2c_sda')))
-    return __I2C
-
-
-def scan():
-    """
-    I2C scan function - experimental
-    :return list: list of devices
-    """
-    # https://docs.micropython.org/en/latest/library/machine.I2C.html
-    return __init().scan()
-
-
-#######################
-# LM helper functions #
-#######################
-
-def pinmap():
-    """
-    [i] micrOS LM naming convention
-    Shows logical pins - pin number(s) used by this Load module
-    - info which pins to use for this application
-    :return dict: pin name (str) - pin value (int) pairs
-    """
-    return pinmap_dump(['i2c_scl', 'i2c_sda'])
-
-
-def help(widgets=False):
-    """
-    [i] micrOS LM naming convention - built-in help message
-    :return tuple:
-        (widgets=False) list of functions implemented by this application
-        (widgets=True) list of widget json for UI generation
-    """
-    return 'scan', 'pinmap'

toolkit/workspace/precompiled/LM_pet_feeder.py

@@ -1,76 +0,0 @@
-import uasyncio as asyncio
-from LM_servo import sduty, deinit
-from LM_stepper import step
-from Common import micro_task
-
-
-class Data:
-    TASK_TAG = "pet_feeder.portion"
-
-
-async def __portion_task(portion, posmin, posmax):
-    # ASYNC TASK ADAPTER [*2] with automatic state management
-    #   [micro_task->Task] TaskManager access to task internals (out, done attributes)
-    with micro_task(tag=Data.TASK_TAG) as my_task:
-        for p in range(0, portion):
-            # [1]Run pos fill up
-            for pos in range(posmin, posmax):
-                sduty(pos)
-                await asyncio.sleep_ms(15)
-            # [2]Wait between fill up / food out
-            await asyncio.sleep_ms(500)
-            # [3]Run pos food out
-            for pos in range(posmax, posmin, -1):
-                sduty(pos)
-                await asyncio.sleep_ms(20)
-            my_task.out = "{}/{} serving".format(p+1, portion)
-    deinit()
-    my_task.out += ": {} task done".format(Data.TASK_TAG)
-
-
-def serve(portion=1, posmin=65, posmax=97):
-    """
-    Pet feeder - with servo motor
-    :param portion: number of portions (min/max positions to repeat)
-    :param posmin: servo "start" position
-    :param posmax: servo "stop" position
-    """
-    # [!] ASYNC TASK CREATION [1*] with async task callback + taskID (TAG) handling
-    state = micro_task(tag=Data.TASK_TAG, task=__portion_task(portion=portion, posmin=posmin, posmax=posmax))
-    return "Starting" if state else "Already running"
-
-
-def serve_w_stepper(portion=1, forward=135, back=10):
-    """
-    Pet feeder (beta) - with stepper motor
-    :param count: number of portions
-    :param forward: s
-    :param back:
-    """
-    for _ in range(portion):
-        # portion move
-        step(forward)
-        # Safety anti-block solution?
-        step(-back)
-        step(back)
-        step(-back)
-        step(back)
-
-
-def lmdep():
-    """
-    Show Load Module dependency
-    - List of load modules used by this application
-    :return: tuple
-    """
-    return 'servo', 'stepper'
-
-
-def help(widgets=False):
-    """
-    [i] micrOS LM naming convention - built-in help message
-    :return tuple:
-        (widgets=False) list of functions implemented by this application
-        (widgets=True) list of widget json for UI generation
-    """
-    return 'serve portion=1 \t\t[info] servo control',  'serve_w_stepper portion=1 \t[info] stepper control', 'lmdep'

toolkit/workspace/precompiled/LM_ph_sensor.py

@@ -1,51 +0,0 @@
-from time import sleep
-from microIO import physical_pin, pinmap_dump
-from Common import SmartADC
-
-"""
-https://cimpleo.com/blog/simple-arduino-ph-meter/
-ADC.ATTN_0DB — the full range voltage: 1.2V
-ADC.ATTN_2_5DB — the full range voltage: 1.5V
-ADC.ATTN_6DB — the full range voltage: 2.0V
-ADC.ATTN_11DB — the full range voltage: 3.3V
-"""
-
-
-def __measure(samples=10):
-    adc_obj = SmartADC.get_singleton(physical_pin('ph'))
-    mbuf = 0
-    for k in range(0, samples):
-        mbuf += adc_obj.get()['volt']
-        sleep(0.1)
-    voltage = round(mbuf / samples, 3)
-    return voltage
-
-
-def measure():
-    data = SmartADC.get_singleton(physical_pin('ph')).get()
-    return "ADC data: {}\nAVG V: {}".format(data, __measure())
-
-
-#######################
-# LM helper functions #
-#######################
-
-def pinmap():
-    """
-    [i] micrOS LM naming convention
-    Shows logical pins - pin number(s) used by this Load module
-    - info which pins to use for this application
-    :return dict: pin name (str) - pin value (int) pairs
-    """
-    return pinmap_dump('ph')
-
-
-def help(widgets=False):
-    """
-    [i] micrOS LM naming convention - built-in help message
-    :return tuple:
-        (widgets=False) list of functions implemented by this application
-        (widgets=True) list of widget json for UI generation
-    """
-    return 'measure', 'pinmap'
-

toolkit/workspace/precompiled/LM_robustness.py

@@ -1,73 +0,0 @@
-from LM_system import memory_usage
-from Common import socket_stream
-
-
-@socket_stream
-def raise_error(msgobj=None):
-    """
-    Test function - raise  LM exception
-    """
-    if msgobj is not None:
-        msgobj("Raise test exception")
-    raise Exception("Test exception")
-
-
-@socket_stream
-def memory_leak(cnt=160, msgobj=None):
-    """
-    Test function - allocate lot of memory
-    :param cnt: data counter, default 160 iteration
-    :return: verdict
-    """
-    dict_test = {}
-    mem_start = memory_usage()['mem_used']
-    for k in range(cnt):
-        mem = memory_usage()['percent']
-        data = "micrOS memory usage: {} %".format(mem)
-        if msgobj is not None:
-            msgobj("[{}] gen: {}".format(k, data))
-        dict_test[k] = data
-    mem_end = memory_usage()['mem_used']
-    delta = mem_start - mem_end
-    return '[{}] RAM Alloc.: {} kB {} byte'.format(len(dict_test), int(delta / 1024), int(delta % 1024))
-
-@socket_stream
-def recursion_limit(limit=14, msgobj=None):
-    cnt = 0
-    for cnt in range(1, limit+1):
-        try:
-            _recursion(cnt, msgobj=msgobj)
-        except Exception as e:
-            msgobj(f"ok error: {e}")
-            break
-    return f"Recursion limit: {cnt}"
-
-
-def _recursion(cnt, msgobj=None):
-    """
-    Test function - recursion test
-    :param cnt: recursion depth
-    :return: verdict
-    Error example:
-        node01 $  robustness recursion_limit 15
-        lm_exec LM_robustness->recursion_limit: maximum recursion depth exceeded
-    """
-    if cnt > 0:
-        remain = _recursion(cnt-1)
-        if msgobj is not None:
-            msgobj("recalled {}".format(cnt))
-    else:
-        remain = 0
-    return remain
-
-
-def help(widgets=False):
-    """
-    [i] micrOS LM naming convention - built-in help message
-    :return tuple:
-        (widgets=False) list of functions implemented by this application
-        (widgets=True) list of widget json for UI generation
-    """
-    return 'NOTE: This is a test module to validate system robustness', \
-           'raise_error', 'memory_leak cnt=160', 'recursion_limit cnt=14'
-

toolkit/workspace/precompiled/uapi.js

@@ -1,76 +0,0 @@
-// Get the current hostname and create the REST API URL
-const currentHostname = window.location.hostname;
-const port = window.location.port ? `:${window.location.port}` : "";
-
-
-function restAPICore(cmd) {
-    // Core micrOS rest API handler
-    cmd = cmd.trim().replace(/\s+/g, '/');
-    let query = `http://${currentHostname}${port}/rest/${cmd}`;
-    const startTime = performance.now();
-    let endTime;
-    // Call rest api with command parameter and return the promise
-    return fetch(query).then(response => {
-        if (!response.ok) {
-            throw new Error('restAPICore code NOK: ' + response.status);
-        }
-        endTime = performance.now();
-        return response.json();
-    }).then(response => {
-        // return cmd result
-        const delta = (endTime - startTime).toFixed(0);
-        return { response, delta, query };                  // RETURN DATA
-    }).catch(error => {
-        console.error('Error in restAPICore:', error);
-        throw error;
-    });
-}
-
-function restAPI(cmd='', console=true) {
-    // micrOS rest API handler with built-in restCmdInput
-    // UPDATES: restConsole(...)
-    if (cmd == '') {
-        cmd = document.getElementById('restCmdInput').value;
-    }
-    return restAPICore(cmd)
-            .then(({ response, delta, query }) => {
-                if (console) {
-                    restConsole(query, response, delta);
-                }
-            return response
-        }).catch(error => {
-            console.error('Error in restAPI:', error);
-        });
-}
-
-function restConsole(apiUrl, data, delta) {
-    // UPDATES: restConsoleUrl, restConsoleResponse, restConsoleTime
-    document.getElementById('restConsoleUrl').innerHTML = `<strong>Generated URL:</strong><br> <a href="${apiUrl}" target="_blank" style="color: white;">${apiUrl}</a>`;
-    document.getElementById('restConsoleResponse').innerHTML = JSON.stringify(data, null, 4).replace(/\\n/g, "<br/>" + "&nbsp;".repeat(15));
-    document.getElementById('restConsoleTime').innerHTML = `⏱ Response time: ${delta} ms`;
-}
-
-function restInfo() {
-    // UPDATES: 'restInfo' and restConsole(...)
-    restAPICore(cmd='').then(({ response, delta, query }) => {
-        // Update API Console
-        restConsole(query, response, delta)
-        // Update 'SysApiInfo' tag
-        let infoHeader = Object.entries(response['result'])
-            .filter(([key]) => key !== 'usr_endpoints') // Exclude usr_endpoints
-            .map(([key, value]) => `${key}: ${JSON.stringify(value)}`);
-        if (infoHeader[2].endsWith("true")) {           // check auth: true
-            infoHeader[2] = "🔑";
-        } else {infoHeader.splice(2, 1);}
-        infoHeader = infoHeader.join('  ❖  ').replace(/"/g, '');
-        let infoSubpages = (response['result']['usr_endpoints'] ? "<br><br>📎 " + Object.entries(response['result']['usr_endpoints'])
-            .map(([key, value]) => `<a href="${value}" target="_blank" style="color: white;">${value} </a>`)
-            .join(' | ') : '');
-        document.getElementById('restInfo').innerHTML = infoHeader + infoSubpages;
-    }).catch(error => {
-        console.error('Error in restAPI:', error);
-    });
-}
-
-// Init basic info from board
-// restInfo();