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

toolkit/workspace/precompiled/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:

toolkit/workspace/precompiled/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:

toolkit/workspace/precompiled/LM_espnow.py

@@ -2,10 +2,24 @@ import Espnow
 
 def load():
     """
-    Initialize ESPNOW protocal
+    OBSOLETE - remove
+    [DEBUG ONLY] ENABLE ESPNOW IN NODE CONFIG INSTEAD OF HERE!
+        Initialize ESPNOW protocal
     """
     return Espnow.initialize()
 
+def start_server():
+    """
+    OBSOLETE - remove
+    [DEBUG ONLY] ENABLE ESPNOW IN NODE CONFIG INSTEAD OF HERE!
+        Start ESPNOW server/listener
+        - this can receive espnow messages
+        - it includes Load Module execution logic (beta)
+    """
+    now = Espnow.initialize()
+    return now.start_server()
+
+
 def send(peer:bytes|str, msg:str='modules'):
     """
     Send message to peer (by mac address)
@@ -15,15 +29,6 @@ def send(peer:bytes|str, msg:str='modules'):
     now = Espnow.initialize()
     return now.send(peer, msg)
 
-def start_server():
-    """
-    Start ESPNOW server/listener
-    - this can receive espnow messages
-    - it includes Load Module execution logic (beta)
-    """
-    now = Espnow.initialize()
-    return now.start_server()
-
 def stats():
     """
     Get ESPNOW stats

toolkit/workspace/precompiled/LM_i2c.py

@@ -24,8 +24,9 @@ def discover():
     """
     Discover devices
     """
-    known_addresses = {hex(0x0A): "trackball", hex(0x3c): "oled",
-                       hex(0x76): "bme280", hex(0x10): 'veml7700'}
+    known_addresses = {hex(0x0A): "TRACKBALL", hex(0x3c): "OLED",
+                       hex(0x76): "BME280", hex(0x10): 'VEML7700',
+                       hex(0x6b): "QMI8658"}
     devices = scan()
     output = {"unknown": []}
     for k in devices:

toolkit/workspace/precompiled/LM_qmi8658.py

@@ -0,0 +1,204 @@
+"""
+A simple driver for the QMI8658 IMU.
+https://github.com/echo-lalia/qmi8658-micropython/blob/main/qmi8685.py
+"""
+
+import struct
+import time
+from machine import Pin, I2C
+from micropython import const
+from microIO import bind_pin, pinmap_search
+
+
+# Sensor constants
+_QMI8685_PARTID = const(0x05)
+_REG_PARTID = const(0x00)
+_REG_REVISION = const(0x01)
+
+_REG_CTRL1 = const(0x02)  # Serial interface and sensor enable
+_REG_CTRL2 = const(0x03)  # Accelerometer settings
+_REG_CTRL3 = const(0x04)  # Gyroscope settings
+_REG_CTRL4 = const(0x05)  # Magnetomer settings (support not implemented in this driver yet)
+_REG_CTRL5 = const(0x06)  # Sensor data processing settings
+_REG_CTRL6 = const(0x07)  # Attitude Engine ODR and Motion on Demand
+_REG_CTRL7 = const(0x08)  # Enable Sensors and Configure Data Reads
+
+_REG_TEMP = const(0x33)  # Temperature sensor.
+
+_REG_AX_L = const(0x35)  # Read accelerometer
+_REG_AX_H = const(0x36)
+_REG_AY_L = const(0x37)
+_REG_AY_H = const(0x38)
+_REG_AZ_L = const(0x39)
+_REG_AZ_H = const(0x3A)
+
+_REG_GX_L = const(0x3B)  # read gyro
+_REG_GX_H = const(0x3C)
+_REG_GY_L = const(0x3D)
+_REG_GY_H = const(0x3E)
+_REG_GZ_L = const(0x3F)
+_REG_GZ_H = const(0x40)
+
+_QMI8658_I2CADDR_DEFAULT = const(0X6B)
+
+
+_ACCELSCALE_RANGE_2G = const(0b00)
+_ACCELSCALE_RANGE_4G = const(0b01)
+_ACCELSCALE_RANGE_8G = const(0b10)
+_ACCELSCALE_RANGE_16G = const(0b11)
+
+_GYROSCALE_RANGE_16DPS = const(0b000)
+_GYROSCALE_RANGE_32DPS = const(0b001)
+_GYROSCALE_RANGE_64DPS = const(0b010)
+_GYROSCALE_RANGE_128DPS = const(0b011)
+_GYROSCALE_RANGE_256DPS = const(0b100)
+_GYROSCALE_RANGE_512DPS = const(0b101)
+_GYROSCALE_RANGE_1024DPS = const(0b110)
+_GYROSCALE_RANGE_2048DPS = const(0b111)
+
+_ODR_8000HZ = const(0b0000)
+_ODR_4000HZ = const(0b0001)
+_ODR_2000HZ = const(0b0010)
+_ODR_1000HZ = const(0b0011)
+_ODR_500HZ = const(0b0100)
+_ODR_250HZ = const(0b0101)
+_ODR_125HZ = const(0b0110)
+_ODR_62_5HZ = const(0b0111)
+
+
+class QMI8658:
+    """QMI8658 inertial measurement unit."""
+    INSTANCE = None
+
+    def __init__(
+            self,
+            i2c_bus: I2C,
+            address: int = _QMI8658_I2CADDR_DEFAULT,
+            accel_scale: int = _ACCELSCALE_RANGE_8G,
+            gyro_scale: int = _GYROSCALE_RANGE_256DPS):
+        """Read from a sensor on the given I2C bus, at the given address."""
+        self.i2c = i2c_bus
+        self.address = address
+        # Cache the sensor instance globally for easy access
+        QMI8658.INSTANCE = self
+
+        # Verify sensor part ID
+        if self._read_u8(_REG_PARTID) != _QMI8685_PARTID:
+            raise AttributeError("Cannot find a QMI8658")
+
+        # Setup initial configuration
+        self._configure_sensor(accel_scale, gyro_scale)
+
+        # Configure scales/divisors for the driver
+        self.acc_scale_divisor = {
+            _ACCELSCALE_RANGE_2G: 1 << 14,
+            _ACCELSCALE_RANGE_4G: 1 << 13,
+            _ACCELSCALE_RANGE_8G: 1 << 12,
+            _ACCELSCALE_RANGE_16G: 1 << 11,
+        }[accel_scale]
+
+        self.gyro_scale_divisor = {
+            _GYROSCALE_RANGE_16DPS: 2048,
+            _GYROSCALE_RANGE_32DPS: 1024,
+            _GYROSCALE_RANGE_64DPS: 512,
+            _GYROSCALE_RANGE_128DPS: 256,
+            _GYROSCALE_RANGE_256DPS: 128,
+            _GYROSCALE_RANGE_512DPS: 64,
+            _GYROSCALE_RANGE_1024DPS: 32,
+            _GYROSCALE_RANGE_2048DPS: 16,
+        }[gyro_scale]
+
+
+    def _configure_sensor(self, accel_scale: int, gyro_scale: int):
+        # Initialize accelerometer and gyroscope settings
+        self._write_u8(_REG_CTRL1, 0x60)  # Set SPI auto increment and big endian (Ctrl 1)
+        self._write_u8(_REG_CTRL2, (accel_scale << 4) | _ODR_1000HZ)  # Accel Config
+        self._write_u8(_REG_CTRL3, (gyro_scale << 4) | _ODR_1000HZ)  # Gyro Config
+        self._write_u8(_REG_CTRL5, 0x01)  # Low-pass filter enable
+        self._write_u8(_REG_CTRL7, 0x03)  # Enable accel and gyro
+        time.sleep_ms(100)
+
+
+    # Helper functions for register operations
+    def _read_u8(self, reg:int) -> int:
+        return self.i2c.readfrom_mem(self.address, reg, 1)[0]
+
+    def _read_xyz(self, reg:int) -> tuple[int, int, int]:
+        data = self.i2c.readfrom_mem(self.address, reg, 6)
+        return struct.unpack('<hhh', data)
+
+    def _write_u8(self, reg: int, value: int):
+        self.i2c.writeto_mem(self.address, reg, bytes([value]))
+
+
+    @property
+    def temperature(self) -> float:
+        """Get the device temperature."""
+        temp_raw = self._read_u8(_REG_TEMP)
+        return temp_raw / 256
+
+    @property
+    def acceleration(self) -> tuple[float, float, float]:
+        """Get current acceleration reading."""
+        raw_accel = self._read_xyz(_REG_AX_L)
+        return tuple(val / self.acc_scale_divisor for val in raw_accel)
+
+    @property
+    def gyro(self) -> tuple[float, float, float]:
+        """Get current gyroscope reading."""
+        raw_gyro = self._read_xyz(_REG_GX_L)
+        return tuple(val / self.gyro_scale_divisor for val in raw_gyro)
+
+#######################
+#   Public functions  #
+#######################
+
+def load():
+    """
+    Load the QMI8658 sensor instance.
+    The QMI8658 is a motion sensor that measures acceleration, angular velocity (gyroscope), and temperature
+    """
+    if QMI8658.INSTANCE is None:
+        QMI8658(I2C(0, sda=Pin(bind_pin('i2c_sda')), scl=Pin(bind_pin('i2c_scl'))))
+    return QMI8658.INSTANCE
+
+
+def temperature():
+    return load().temperature
+
+
+def acceleration():
+    return load().acceleration
+
+
+def gyro():
+    return load().gyro
+
+
+def measure():
+    inst = load()
+    return {"temp": inst.temperature, "accel": inst.acceleration, "gyro": inst.gyro}
+
+
+#######################
+# 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_search(['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 'load', 'temperature', 'acceleration', 'gyro', 'measure', 'pinmap'

toolkit/workspace/precompiled/LM_tcs3472.py

@@ -0,0 +1,75 @@
+"""
+A MicroPython library for the TCS3472 light sensing chip
+https://github.com/tti0/tcs3472-micropython
+
+Copyright (c) 2021 tti0
+Licensed under the MIT License
+"""
+
+from machine import I2C, Pin
+from microIO import bind_pin, pinmap_search
+import struct
+
+
+class TCS3472:
+    INSTANCE = None
+
+    def __init__(self, bus, address=0x29):
+        self._bus = bus
+        self._i2c_address = address
+
+        self._bus.start()
+
+        self._bus.writeto(self._i2c_address, b'\x80\x03')
+        self._bus.writeto(self._i2c_address, b'\x81\x2b')
+
+        TCS3472.INSTANCE = self
+
+    def scaled(self):
+        crgb = self.raw()
+        if crgb[0] > 0:
+            return tuple(float(x) / crgb[0] for x in crgb[1:])
+
+        return (0, 0, 0)
+
+    def rgb(self):
+        return tuple(int(x * 255) for x in self.scaled())
+
+    def light(self):
+        return self.raw()[0]
+
+    def brightness(self, level=65.535):
+        return int((self.light() / level))
+
+    def valid(self):
+        self._bus.writeto(self._i2c_address, b'\x93')
+        return self._bus.readfrom(self._i2c_address, 1)[0] & 1
+
+    def raw(self):
+        self._bus.writeto(self._i2c_address, b'\xb4')
+        return struct.unpack("<HHHH", self._bus.readfrom(self._i2c_address, 8))
+
+
+############################ Exposed functions ############################
+
+def load():
+    """
+    Load the TCS3472 Color sensor instance.
+    """
+    if TCS3472.INSTANCE is None:
+        bus = I2C(sda=Pin(bind_pin('i2c_sda')), scl=Pin(bind_pin('i2c_scl')))
+        TCS3472.INSTANCE = TCS3472(bus)
+    return TCS3472.INSTANCE
+
+
+def pinmap():
+    return pinmap_search(['i2c_scl', 'i2c_sda'])
+
+
+def measure():
+    sensor = load()
+    return {"rgb": sensor.rgb(), "light": sensor.light(), "brightness": sensor.brightness()}
+
+
+def help(widgest=False):
+    return 'load', 'measure'

micrOS/source/LM_catgame.py

@@ -1,75 +0,0 @@
-from random import randint
-from LM_servo import sduty, deinit, pinmap as pm
-from utime import sleep_ms
-from Types import resolve
-
-
-def load():
-    """
-    Initialize catgame-servo module
-    """
-    return "catgame-servo module - loaded"
-
-
-def game(repeat=10, delta=20):
-    """
-    Servo cat toy "mover" - left-right
-    :param repeat int: repeat servo pos change
-    :param delta int: center(75) +/-delta(35)
-    :return str: verdict
-    """
-    sduty(75)
-    for _ in range(0, repeat):
-        sduty(randint(75-delta, 75+delta))
-        sleep_ms(randint(20, 1500))
-    sduty(75)
-    return 'Game action'
-
-
-def live_game(chance=10):
-    """
-    Generate game
-    :param chance int: percent value 0-100
-    :return str: verdict (action / no action)
-    """
-    action = randint(1, 10)
-    if action <= int(chance/10):
-        return game(repeat=5)
-    return 'No action'
-
-
-def stop():
-    """
-    Stop game - home position (75) + deinit
-    :return str: servo verdict
-    """
-    out = sduty(75)
-    deinit()
-    return out
-
-
-#######################
-# 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 pm()
-
-
-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 resolve(('BUTTON game repeat=10',
-                             'SLIDER live_game chance=<10-90>',
-                             'BUTTON stop', 'pinmap',
-                             'load'), widgets=widgets)

micrOS/source/LM_demo.py

@@ -1,97 +0,0 @@
-from random import randint
-from Time import uptime
-from Types import resolve
-from microIO import detect_platform
-from Common import console
-
-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("debug module cmd executed")     # + Progress LED
-        return func(*args, **kwargs)
-    return __wrapper
-
-
-def load():
-    """
-    Initialize demo module
-    """
-    return "demo module - loaded"
-
-
-@_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 resolve(('hello name="MrNobody"',
-           'calculator a b op="+"',
-           '\t=>op: + - / *',
-           'BUTTON dice_cube',
-           'dice_cube - show number, roll a dice',
-           'BUTTON yes_no',
-           'yes_no    - show random yes/no',
-           'links     - show micrOS links',
-           'source    - show demo module source code',
-           'TEXTBOX exec_info',
-           'exec_info - Execution info, demo module usage',
-           'load'), widgets=widgets)

micrOS/source/LM_intercon.py

@@ -1,60 +0,0 @@
-from InterConnect import send_cmd, host_cache
-from Common import syslog
-
-
-def sendcmd(*args, **kwargs):
-    """
-    [!!!] OBSOLETE - NEW SYNTAX: system top >>node01.local
-    Implements send command function towards micrOS devices
-        example: sendcmd "hello" host="IP/hostname.local") OR sendcmd host="IP/hostname.local" cmd="system rssi")
-    :param host[0]: host IP or Hostname
-    :param cmd[1]: command - module func arg(s)
-    :return str: reply
-    """
-    def __send(_host, _cmd):
-        try:
-            out = send_cmd(_host, _cmd)
-        except Exception as e:
-            out = []
-            syslog(f'[intercon] sendcmd: {e}')
-        return out
-
-    host = kwargs.get('host', None)
-    cmd = kwargs.get('cmd', None)
-
-    # Host correction (lm_exec) if keyword-arg 'host' was not found
-    if host is None:
-        host = args[0]
-        args = args[1:]
-
-    # Cmd correction (lm_exec) if keyword-arg was not found
-    if cmd is None:
-        cmd = ''.join(args)
-    return __send(host, cmd)
-
-
-def addr_cache():
-    """
-    [!!!] OBSOLETE -> new command: system hosts
-    Dump intercon connection cache
-    :return dict: device-ip pairs
-    """
-    return host_cache()
-
-
-#######################
-# LM helper functions #
-#######################
-
-def help(widgets=False):
-    """
-    [!!!] OBSOLETE
-    [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 'sendcmd "hello" host="IP/hostname.local")',\
-           'sendcmd host="IP/hostname.local" cmd="system rssi")',\
-           'example: intercon sendcmd "10.0.1.84" "system rssi" OR intercon sendcmd "system rssi" host="node01.local"', \
-           'addr_cache'