Barmaja-PyArduino 2.0.0__py3-none-any.whl

Barmaja_PyArduino/__init__.pyi

@@ -0,0 +1,331 @@
+# AUTO-GENERATED by Barmaja_PyArduino.stubgen from api_registry.py.
+# Do not edit manually; change the registry and regenerate.
+from typing import Final, TypeAlias, overload
+
+TimeU32: TypeAlias = int
+IntOrBool: TypeAlias = int | bool
+NumericOrBool: TypeAlias = int | float | bool
+Scalar: TypeAlias = int | float | bool | str
+UltrasonicUnit: TypeAlias = int
+DHTType: TypeAlias = int
+
+HIGH: Final[int]
+LOW: Final[int]
+INPUT: Final[int]
+OUTPUT: Final[int]
+INPUT_PULLUP: Final[int]
+A0: Final[int]
+A1: Final[int]
+A2: Final[int]
+A3: Final[int]
+A4: Final[int]
+A5: Final[int]
+DHT11: Final[int]
+DHT22: Final[int]
+CM: Final[int]
+INC: Final[int]
+
+def pinMode(pin: int, mode: int) -> None: ...
+def digitalWrite(pin: int, value: IntOrBool) -> None: ...
+def digitalRead(pin: int) -> int: ...
+def analogRead(pin: int) -> int: ...
+def analogWrite(pin: int, value: int) -> None: ...
+def delay(milliseconds: int) -> None: ...
+def millis() -> TimeU32: ...
+@overload
+def tone(pin: int, frequency: int) -> None: ...
+@overload
+def tone(pin: int, frequency: int, duration: int) -> None: ...
+def noTone(pin: int) -> None: ...
+def micros() -> TimeU32: ...
+def delayMicroseconds(microseconds: int) -> None: ...
+def map(value: int, in_min: int, in_max: int, out_min: int, out_max: int) -> int: ...
+def constrain(value: int, lower: int, upper: int) -> int: ...
+
+class BluetoothSerial:
+    def __init__(self, rx_pin: int, tx_pin: int) -> None: ...
+    def begin(self, baud: int) -> None: ...
+    def listen(self) -> bool: ...
+    def available(self) -> int: ...
+    def read(self) -> int: ...
+    def write(self, value: int) -> int: ...
+
+class MPU6050Sensor:
+    def begin(self) -> bool: ...
+    def update(self) -> None: ...
+    def angleX(self) -> float: ...
+    def angleY(self) -> float: ...
+    def angleZ(self) -> float: ...
+    def accelX(self) -> float: ...
+    def accelY(self) -> float: ...
+    def accelZ(self) -> float: ...
+    def gyroX(self) -> float: ...
+    def gyroY(self) -> float: ...
+    def gyroZ(self) -> float: ...
+
+class GPSModule:
+    def __init__(self, rx_pin: int, tx_pin: int) -> None: ...
+    def begin(self, baud: int) -> None: ...
+    def update(self) -> bool: ...
+    def hasFix(self) -> bool: ...
+    def latitude(self) -> float: ...
+    def longitude(self) -> float: ...
+    def satellites(self) -> int: ...
+
+class EthernetW5500:
+    def __init__(self, cs_pin: int, mac0: int, mac1: int, mac2: int, mac3: int, mac4: int, mac5: int) -> None: ...
+    def beginIP(self,a: int,b: int,c: int,d: int) -> None: ...
+    def connect(self,a: int,b: int,c: int,d: int,port: int) -> bool: ...
+    def connected(self) -> bool: ...
+    def write(self, value: int) -> int: ...
+    def available(self) -> int: ...
+    def read(self) -> int: ...
+    def stop(self) -> None: ...
+
+class WiFiESPAT:
+    def __init__(self, rx_pin: int, tx_pin: int) -> None: ...
+    def begin(self, baud: int) -> None: ...
+    def connect(self, ssid: str, password: str) -> bool: ...
+    def connected(self) -> bool: ...
+    def tcpConnect(self,a: int,b: int,c: int,d: int,port: int) -> bool: ...
+    def write(self, value: int) -> int: ...
+    def available(self) -> int: ...
+    def read(self) -> int: ...
+    def stop(self) -> None: ...
+
+class RFID:
+    def __init__(self, ss_pin: int, reset_pin: int) -> None: ...
+    def begin(self) -> None: ...
+    def readUID(self) -> str: ...
+
+class IRRemote:
+    def __init__(self, receive_pin: int) -> None: ...
+    def begin(self) -> None: ...
+    def readCommand(self) -> int: ...
+
+class Keypad4x4:
+    def __init__(self, r1: int,r2: int,r3: int,r4: int,c1: int,c2: int,c3: int,c4: int) -> None: ...
+    def getKey(self) -> str: ...
+
+class StepperMotor:
+    def __init__(self, p1:int,p2:int,p3:int,p4:int) -> None: ...
+    def setMaxSpeed(self, speed: float) -> None: ...
+    def setAcceleration(self, acceleration: float) -> None: ...
+    def moveTo(self, target: int) -> None: ...
+    def move(self, relative: int) -> None: ...
+    def run(self) -> bool: ...
+    def distanceToGo(self) -> int: ...
+    def currentPosition(self) -> int: ...
+    def setCurrentPosition(self, value: int) -> None: ...
+
+class OneWireBus:
+    def __init__(self, pin: int) -> None: ...
+    def reset(self) -> int: ...
+    def write(self, value: int) -> None: ...
+    def read(self) -> int: ...
+
+class LEDMatrixMAX7219:
+    def __init__(self, data_pin: int, clk_pin: int, cs_pin: int) -> None: ...
+    def begin(self) -> None: ...
+    def clear(self) -> None: ...
+    def setPixel(self, row: int, column: int, on: bool) -> None: ...
+    def setRow(self, row: int, value: int) -> None: ...
+    def setBrightness(self, level: int) -> None: ...
+
+class FourDigitTM1637:
+    def __init__(self, clk_pin: int, dio_pin: int) -> None: ...
+    def setBrightness(self, level: int) -> None: ...
+    def showNumber(self, value: int) -> None: ...
+    def clear(self) -> None: ...
+
+class Servo:
+    def __init__(self) -> None: ...
+    @overload
+    def attach(self, pin: int) -> int: ...
+    @overload
+    def attach(self, pin: int, min_us: int, max_us: int) -> int: ...
+    def write(self, angle: int) -> None: ...
+    def writeMicroseconds(self, microseconds: int) -> None: ...
+    def read(self) -> int: ...
+    def detach(self) -> None: ...
+    def attached(self) -> bool: ...
+
+class Ultrasonic:
+    def __init__(self, trigger_pin: int, echo_pin: int) -> None: ...
+    @overload
+    def read(self) -> int: ...
+    @overload
+    def read(self, unit: UltrasonicUnit) -> int: ...
+    def setTimeout(self, timeout: int) -> None: ...
+
+class DHT:
+    def __init__(self, pin: int, sensor_type: DHTType) -> None: ...
+    def begin(self) -> None: ...
+    def readTemperature(self) -> float: ...
+    def readHumidity(self) -> float: ...
+
+class LiquidCrystal_I2C:
+    def __init__(self, address: int, columns: int, rows: int) -> None: ...
+    def init(self) -> None: ...
+    @overload
+    def begin(self, columns: int, rows: int) -> None: ...
+    @overload
+    def begin(self, columns: int, rows: int, charsize: int) -> None: ...
+    def clear(self) -> None: ...
+    def home(self) -> None: ...
+    def setCursor(self, column: int, row: int) -> None: ...
+    def print(self, value: Scalar) -> None: ...
+    def backlight(self) -> None: ...
+    def noBacklight(self) -> None: ...
+    def display(self) -> None: ...
+    def noDisplay(self) -> None: ...
+
+class _EEPROMAPI:
+    def read(self, address: int) -> int: ...
+    def write(self, address: int, value: int) -> None: ...
+    def update(self, address: int, value: int) -> None: ...
+    def length(self) -> int: ...
+EEPROM: Final[_EEPROMAPI]
+
+class _SPIAPI:
+    def begin(self) -> None: ...
+    def transfer(self, value: int) -> int: ...
+    def end(self) -> None: ...
+SPI: Final[_SPIAPI]
+
+class _SerialAPI:
+    def begin(self, baud: int) -> None: ...
+    @overload
+    def print(self, value: Scalar) -> None: ...
+    @overload
+    def print(self, value: NumericOrBool, format: int) -> None: ...
+    @overload
+    def println(self) -> None: ...
+    @overload
+    def println(self, value: Scalar) -> None: ...
+    @overload
+    def println(self, value: NumericOrBool, format: int) -> None: ...
+    def available(self) -> int: ...
+    def read(self) -> int: ...
+Serial: Final[_SerialAPI]
+
+class _WireAPI:
+    def begin(self) -> None: ...
+    def beginTransmission(self, address: int) -> None: ...
+    def write(self, value: int) -> int: ...
+    def endTransmission(self) -> int: ...
+    def requestFrom(self, address: int, count: int) -> int: ...
+    def available(self) -> int: ...
+    def read(self) -> int: ...
+Wire: Final[_WireAPI]
+
+def upload(path: str | None = None, *, port: str | None = None, monitor: bool | None = None) -> None: ...
+def verify(path: str | None = None) -> None: ...
+def show_code(path: str | None = None) -> None: ...
+def LiveRun(port: str | None = None, *, auto_firmware: bool = True, debug: bool = False): ...
+def LiveStop() -> None: ...
+
+def doctor_pictoblox(*, details: bool = False) -> str: ...
+
+# ---- device packs (generated by device_packs.render_stubs) ----
+class Button:
+    """Push button with built-in pull-up and debounce (no resistor needed) [device pack, compile-verified]"""
+    def __init__(self, pin: int) -> None: ...
+    def isPressed(self) -> bool: ...
+    def wasPressed(self) -> bool: ...
+
+class ClockDS3231:
+    """DS3231 real-time clock module (I2C) [device pack, compile-verified]"""
+    def __init__(self) -> None: ...
+    def begin(self) -> bool: ...
+    def setTime(self, year: int, month: int, day: int, hour: int, minute: int, second: int) -> None: ...
+    def year(self) -> int: ...
+    def month(self) -> int: ...
+    def day(self) -> int: ...
+    def hour(self) -> int: ...
+    def minute(self) -> int: ...
+    def second(self) -> int: ...
+    def temperature(self) -> float: ...
+    def lostPower(self) -> bool: ...
+
+class DistanceVL53L0X:
+    """VL53L0X laser time-of-flight distance sensor (I2C, up to ~1.2 m) [device pack, compile-verified]"""
+    def __init__(self) -> None: ...
+    def begin(self) -> bool: ...
+    def readMillimeters(self) -> int: ...
+    def timedOut(self) -> bool: ...
+
+class LCDParallel:
+    """16x2 / 20x4 character LCD wired in 4-bit parallel mode (no I2C backpack) [device pack, compile-verified]"""
+    def __init__(self, rs: int, en: int, d4: int, d5: int, d6: int, d7: int) -> None: ...
+    def begin(self, columns: int = 16, rows: int = 2) -> None: ...
+    def clear(self) -> None: ...
+    def home(self) -> None: ...
+    def setCursor(self, column: int, row: int) -> None: ...
+    def print(self, value: int | float | bool | str) -> None: ...
+    def println(self, value: int | float | bool | str = 0) -> None: ...
+
+class LoadCellHX711:
+    """HX711 load-cell amplifier (kitchen-scale sensor) [device pack, compile-verified]"""
+    def __init__(self, dout_pin: int, sck_pin: int) -> None: ...
+    def begin(self) -> None: ...
+    def tare(self) -> None: ...
+    def setScale(self, factor: float | int) -> None: ...
+    def readUnits(self) -> float: ...
+    def isReady(self) -> bool: ...
+
+class NeoPixelStrip:
+    """WS2812 / NeoPixel RGB LED strip or ring [device pack, compile-verified]"""
+    def __init__(self, pin: int, count: int) -> None: ...
+    def begin(self) -> None: ...
+    def setPixel(self, index: int, red: int, green: int, blue: int) -> None: ...
+    def setBrightness(self, level: int) -> None: ...
+    def clear(self) -> None: ...
+    def show(self) -> None: ...
+
+class OLEDText:
+    """SSD1306 128x64 I2C OLED display, text mode (low memory) [device pack, compile-verified]"""
+    def __init__(self, address: int = 60) -> None: ...
+    def begin(self) -> None: ...
+    def clear(self) -> None: ...
+    def setCursor(self, column: int, row: int) -> None: ...
+    def setLarge(self, on: bool) -> None: ...
+    def print(self, value: int | float | bool | str) -> None: ...
+    def println(self, value: int | float | bool | str = 0) -> None: ...
+
+class PressureBMP280:
+    """BMP280 temperature + air-pressure + altitude sensor (I2C) [device pack, compile-verified]"""
+    def __init__(self, address: int = 118) -> None: ...
+    def begin(self) -> bool: ...
+    def readTemperature(self) -> float: ...
+    def readPressure(self) -> float: ...
+    def readAltitude(self, sea_level_hpa: float | int = 1013.25) -> float: ...
+
+class RotaryEncoder:
+    """Rotary encoder knob (KY-040 style) read by polling [device pack, prototype]"""
+    def __init__(self, clk_pin: int, dt_pin: int) -> None: ...
+    def position(self) -> int: ...
+    def reset(self) -> None: ...
+
+class ServoDriverPCA9685:
+    """PCA9685 16-channel servo driver board (I2C) [device pack, compile-verified]"""
+    def __init__(self, address: int = 64) -> None: ...
+    def begin(self) -> None: ...
+    def setAngle(self, channel: int, angle: int) -> None: ...
+    def setPulse(self, channel: int, microseconds: int) -> None: ...
+    def off(self, channel: int) -> None: ...
+
+class ShiftRegister595:
+    """74HC595 shift register (8 extra outputs from 3 pins) [device pack, compile-verified]"""
+    def __init__(self, data_pin: int, clock_pin: int, latch_pin: int) -> None: ...
+    def write(self, value: int) -> None: ...
+    def setPin(self, output: int, on: bool) -> None: ...
+    def clear(self) -> None: ...
+
+class TemperatureDS18B20:
+    """DS18B20 digital temperature sensor (one-wire) [device pack, compile-verified]"""
+    def __init__(self, pin: int) -> None: ...
+    def begin(self) -> None: ...
+    def readCelsius(self) -> float: ...
+    def readFahrenheit(self) -> float: ...
+

Barmaja_PyArduino/__main__.py

@@ -0,0 +1,2 @@
+from .cli import main
+raise SystemExit(main())

Barmaja_PyArduino/adapters/__init__.py

@@ -0,0 +1,35 @@
+"""Library adapter metadata helpers for the Step-12 API registry."""
+
+from __future__ import annotations
+
+from ..api_registry import HARDWARE_CLASSES, SINGLETONS
+
+
+def includes_for_usage(hardware_classes: set[str], singletons: set[str]) -> tuple[str, ...]:
+    """Return stable, de-duplicated C++ includes for actually used adapters."""
+
+    out: list[str] = []
+    for class_name in sorted(hardware_classes):
+        spec = HARDWARE_CLASSES[class_name]
+        for header in spec.includes:
+            if header not in out:
+                out.append(header)
+    for singleton in sorted(singletons):
+        spec = SINGLETONS[singleton]
+        for header in spec.includes:
+            if header not in out:
+                out.append(header)
+    return tuple(out)
+
+
+def dependency_ids_for_usage(hardware_classes: set[str], singletons: set[str]) -> tuple[str, ...]:
+    out: list[str] = []
+    for class_name in sorted(hardware_classes):
+        for dependency_id in HARDWARE_CLASSES[class_name].dependency_ids:
+            if dependency_id not in out:
+                out.append(dependency_id)
+    for singleton in sorted(singletons):
+        for dependency_id in SINGLETONS[singleton].dependency_ids:
+            if dependency_id not in out:
+                out.append(dependency_id)
+    return tuple(out)