Barmaja-PyArduino 2.0.0__py3-none-any.whl

Barmaja_PyArduino/device_packs_builtin/NeoPixelStrip/pack.json

@@ -0,0 +1,114 @@
+{
+  "schema": 1,
+  "class": "NeoPixelStrip",
+  "title": "WS2812 / NeoPixel RGB LED strip or ring",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [
+    {
+      "name": "pin",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "count",
+      "type": "Int",
+      "range": [
+        1,
+        120
+      ]
+    }
+  ],
+  "methods": {
+    "begin": {
+      "params": [],
+      "returns": "Void",
+      "starts": true
+    },
+    "setPixel": {
+      "params": [
+        {
+          "name": "index",
+          "type": "Int",
+          "range": [
+            0,
+            "count-1"
+          ]
+        },
+        {
+          "name": "red",
+          "type": "Int",
+          "range": [
+            0,
+            255
+          ]
+        },
+        {
+          "name": "green",
+          "type": "Int",
+          "range": [
+            0,
+            255
+          ]
+        },
+        {
+          "name": "blue",
+          "type": "Int",
+          "range": [
+            0,
+            255
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "setBrightness": {
+      "params": [
+        {
+          "name": "level",
+          "type": "Int",
+          "range": [
+            0,
+            255
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "clear": {
+      "params": [],
+      "returns": "Void"
+    },
+    "show": {
+      "params": [],
+      "returns": "Void"
+    }
+  },
+  "resources": [
+    "interrupts"
+  ],
+  "warnings": [
+    "show() briefly disables interrupts (millis/Servo/SoftwareSerial may jitter). Power more than ~8 LEDs from an external 5 V supply with common GND."
+  ],
+  "adapter": {
+    "library": "Barmaja_NeoPixelStrip",
+    "header": "Barmaja_NeoPixelStrip.h"
+  },
+  "dependencies": [
+    {
+      "id": "adafruit-neopixel",
+      "name": "Adafruit NeoPixel",
+      "version": "1.15.5",
+      "header": "Adafruit_NeoPixel.h",
+      "license": "LGPL-3.0",
+      "source": "https://github.com/adafruit/Adafruit_NeoPixel",
+      "tag": "1.15.5",
+      "library_folder": "Adafruit_NeoPixel"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nring = NeoPixelStrip(6, 8)\nring.begin()\nring.setBrightness(40)\ni = 0\nwhile True:\n    ring.clear()\n    ring.setPixel(i, 0, 120, 255)\n    ring.show()\n    i = (i + 1) % 8\n    delay(100)\n"
+}

Barmaja_PyArduino/device_packs_builtin/OLEDText/arduino/Barmaja_OLEDText/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_OLEDText
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: SSD1306 128x64 I2C OLED display, text mode (low memory)
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/OLEDText/arduino/Barmaja_OLEDText/src/Barmaja_OLEDText.h

@@ -0,0 +1,21 @@
+#pragma once
+#include <Arduino.h>
+#include <Wire.h>
+#include <SSD1306Ascii.h>
+#include <SSD1306AsciiWire.h>
+// Text-only driver: no 1 KB screen buffer, so it fits beside other libraries on an Uno.
+// setCursor(column_pixels 0..127, text_row 0..7). Inherits Print (print/println/f-strings).
+class OLEDText : public Print {
+public:
+  explicit OLEDText(uint8_t address = 0x3C): address_(address) {}
+  void begin() { Wire.begin(); Wire.setClock(400000L); oled_.begin(&Adafruit128x64, address_); oled_.setFont(Adafruit5x7); oled_.clear(); }
+  void clear() { oled_.clear(); }
+  void setCursor(int column, int row) { oled_.setCursor((uint8_t)column, (uint8_t)row); }
+  void setLarge(bool on) { if (on) oled_.set2X(); else oled_.set1X(); }
+  size_t write(uint8_t c) override { return oled_.write(c); }
+  using Print::print;
+  using Print::println;
+private:
+  uint8_t address_;
+  SSD1306AsciiWire oled_;
+};

Barmaja_PyArduino/device_packs_builtin/OLEDText/example.py

@@ -0,0 +1,9 @@
+from Barmaja_PyArduino import *
+upload()
+
+screen = OLEDText(0x3C)
+screen.begin()
+while True:
+    screen.setCursor(0, 0)
+    screen.print(f"Light: {analogRead(A0)}   ")
+    delay(300)

Barmaja_PyArduino/device_packs_builtin/OLEDText/pack.json

@@ -0,0 +1,103 @@
+{
+  "schema": 1,
+  "class": "OLEDText",
+  "title": "SSD1306 128x64 I2C OLED display, text mode (low memory)",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [
+    {
+      "name": "address",
+      "type": "Int",
+      "range": [
+        60,
+        61
+      ],
+      "default": 60
+    }
+  ],
+  "methods": {
+    "begin": {
+      "params": [],
+      "returns": "Void",
+      "starts": true
+    },
+    "clear": {
+      "params": [],
+      "returns": "Void"
+    },
+    "setCursor": {
+      "params": [
+        {
+          "name": "column",
+          "type": "Int",
+          "range": [
+            0,
+            127
+          ]
+        },
+        {
+          "name": "row",
+          "type": "Int",
+          "range": [
+            0,
+            7
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "setLarge": {
+      "params": [
+        {
+          "name": "on",
+          "type": "Bool"
+        }
+      ],
+      "returns": "Void"
+    },
+    "print": {
+      "params": [
+        {
+          "name": "value",
+          "type": "Scalar"
+        }
+      ],
+      "returns": "Void"
+    },
+    "println": {
+      "params": [
+        {
+          "name": "value",
+          "type": "Scalar",
+          "default": 0
+        }
+      ],
+      "returns": "Void"
+    }
+  },
+  "resources": [
+    "i2c"
+  ],
+  "warnings": [],
+  "adapter": {
+    "library": "Barmaja_OLEDText",
+    "header": "Barmaja_OLEDText.h"
+  },
+  "dependencies": [
+    {
+      "id": "greiman-ssd1306ascii",
+      "name": "SSD1306Ascii",
+      "version": "1.3.5",
+      "header": "SSD1306AsciiWire.h",
+      "license": "MIT",
+      "source": "https://github.com/greiman/SSD1306Ascii",
+      "tag": "1.3.5",
+      "library_folder": "SSD1306Ascii"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nscreen = OLEDText(0x3C)\nscreen.begin()\nwhile True:\n    screen.setCursor(0, 0)\n    screen.print(f\"Light: {analogRead(A0)}   \")\n    delay(300)\n"
+}

Barmaja_PyArduino/device_packs_builtin/PressureBMP280/arduino/Barmaja_PressureBMP280/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_PressureBMP280
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: BMP280 temperature + air-pressure + altitude sensor (I2C)
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/PressureBMP280/arduino/Barmaja_PressureBMP280/src/Barmaja_PressureBMP280.h

@@ -0,0 +1,16 @@
+#pragma once
+#include <Arduino.h>
+#include <Wire.h>
+#include <Adafruit_BMP280.h>
+// Most purple GY-BMP280 boards use address 0x76 (118); Adafruit boards use 0x77 (119).
+class PressureBMP280 {
+public:
+  explicit PressureBMP280(uint8_t address = 0x76): address_(address) {}
+  bool begin() { return bmp_.begin(address_); }
+  float readTemperature() { return bmp_.readTemperature(); }
+  float readPressure() { return bmp_.readPressure() / 100.0f; }
+  float readAltitude(float seaLevelHpa = 1013.25f) { return bmp_.readAltitude(seaLevelHpa); }
+private:
+  uint8_t address_;
+  Adafruit_BMP280 bmp_;
+};

Barmaja_PyArduino/device_packs_builtin/PressureBMP280/example.py

@@ -0,0 +1,8 @@
+from Barmaja_PyArduino import *
+upload()
+
+air = PressureBMP280(0x76)
+air.begin()
+while True:
+    print("T =", air.readTemperature(), "C  P =", air.readPressure(), "hPa")
+    delay(1000)

Barmaja_PyArduino/device_packs_builtin/PressureBMP280/pack.json

@@ -0,0 +1,92 @@
+{
+  "schema": 1,
+  "class": "PressureBMP280",
+  "title": "BMP280 temperature + air-pressure + altitude sensor (I2C)",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [
+    {
+      "name": "address",
+      "type": "Int",
+      "range": [
+        118,
+        119
+      ],
+      "default": 118
+    }
+  ],
+  "methods": {
+    "begin": {
+      "params": [],
+      "returns": "Bool",
+      "starts": true
+    },
+    "readTemperature": {
+      "params": [],
+      "returns": "Float"
+    },
+    "readPressure": {
+      "params": [],
+      "returns": "Float",
+      "doc": "hPa"
+    },
+    "readAltitude": {
+      "params": [
+        {
+          "name": "sea_level_hpa",
+          "type": [
+            "Float",
+            "Int"
+          ],
+          "default": 1013.25
+        }
+      ],
+      "returns": "Float"
+    }
+  },
+  "resources": [
+    "i2c"
+  ],
+  "warnings": [],
+  "adapter": {
+    "library": "Barmaja_PressureBMP280",
+    "header": "Barmaja_PressureBMP280.h"
+  },
+  "dependencies": [
+    {
+      "id": "adafruit-unified-sensor",
+      "name": "Adafruit Unified Sensor",
+      "version": "1.1.15",
+      "header": "Adafruit_Sensor.h",
+      "license": "Apache-2.0",
+      "source": "https://github.com/adafruit/Adafruit_Sensor",
+      "library_folder": "Adafruit_Sensor",
+      "bundled": true
+    },
+    {
+      "id": "adafruit-busio",
+      "name": "Adafruit BusIO",
+      "version": "1.17.4",
+      "header": "Adafruit_I2CDevice.h",
+      "license": "MIT",
+      "source": "https://github.com/adafruit/Adafruit_BusIO",
+      "tag": "1.17.4",
+      "library_folder": "Adafruit_BusIO"
+    },
+    {
+      "id": "adafruit-bmp280",
+      "name": "Adafruit BMP280 Library",
+      "version": "3.0.0",
+      "header": "Adafruit_BMP280.h",
+      "license": "MIT",
+      "source": "https://github.com/adafruit/Adafruit_BMP280_Library",
+      "tag": "3.0.0",
+      "library_folder": "Adafruit_BMP280_Library"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nair = PressureBMP280(0x76)\nair.begin()\nwhile True:\n    print(\"T =\", air.readTemperature(), \"C  P =\", air.readPressure(), \"hPa\")\n    delay(1000)\n"
+}

Barmaja_PyArduino/device_packs_builtin/RotaryEncoder/arduino/Barmaja_RotaryEncoder/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_RotaryEncoder
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: Rotary encoder knob (KY-040 style) read by polling
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/RotaryEncoder/arduino/Barmaja_RotaryEncoder/src/Barmaja_RotaryEncoder.h

@@ -0,0 +1,18 @@
+#pragma once
+#include <Arduino.h>
+// Call position() often (every loop) so no steps are missed. Uses INPUT_PULLUP.
+class RotaryEncoder {
+public:
+  RotaryEncoder(uint8_t clk, uint8_t dt): clk_(clk), dt_(dt) {}
+  long position() {
+    setup();
+    uint8_t a = digitalRead(clk_);
+    if (a != lastA_ && a == LOW) { if (digitalRead(dt_) != a) pos_++; else pos_--; }
+    lastA_ = a;
+    return pos_;
+  }
+  void reset() { pos_ = 0; }
+private:
+  void setup() { if (!ready_) { pinMode(clk_, INPUT_PULLUP); pinMode(dt_, INPUT_PULLUP); lastA_ = digitalRead(clk_); ready_ = true; } }
+  uint8_t clk_, dt_, lastA_ = HIGH; bool ready_ = false; long pos_ = 0;
+};

Barmaja_PyArduino/device_packs_builtin/RotaryEncoder/example.py

@@ -0,0 +1,10 @@
+from Barmaja_PyArduino import *
+upload()
+
+knob = RotaryEncoder(2, 3)
+last = 0
+while True:
+    p = knob.position()
+    if p != last:
+        print("Position:", p)
+        last = p

Barmaja_PyArduino/device_packs_builtin/RotaryEncoder/pack.json

@@ -0,0 +1,44 @@
+{
+  "schema": 1,
+  "class": "RotaryEncoder",
+  "title": "Rotary encoder knob (KY-040 style) read by polling",
+  "status": "prototype",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [
+    {
+      "name": "clk_pin",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "dt_pin",
+      "type": "Int",
+      "rule": "digital_pin"
+    }
+  ],
+  "methods": {
+    "position": {
+      "params": [],
+      "returns": "Int",
+      "requires_begin": false
+    },
+    "reset": {
+      "params": [],
+      "returns": "Void",
+      "requires_begin": false
+    }
+  },
+  "resources": [],
+  "warnings": [],
+  "adapter": {
+    "library": "Barmaja_RotaryEncoder",
+    "header": "Barmaja_RotaryEncoder.h"
+  },
+  "dependencies": [],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nknob = RotaryEncoder(2, 3)\nlast = 0\nwhile True:\n    p = knob.position()\n    if p != last:\n        print(\"Position:\", p)\n        last = p\n",
+  "notes": "Polling: slow loops (long delay()) will miss steps."
+}

Barmaja_PyArduino/device_packs_builtin/ServoDriverPCA9685/arduino/Barmaja_ServoDriverPCA9685/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_ServoDriverPCA9685
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: PCA9685 16-channel servo driver board (I2C)
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/ServoDriverPCA9685/arduino/Barmaja_ServoDriverPCA9685/src/Barmaja_ServoDriverPCA9685.h

@@ -0,0 +1,15 @@
+#pragma once
+#include <Arduino.h>
+#include <Wire.h>
+#include <Adafruit_PWMServoDriver.h>
+// 50 Hz servo signals; angle 0..180 -> 544..2400 us like the Arduino Servo library.
+class ServoDriverPCA9685 {
+public:
+  explicit ServoDriverPCA9685(uint8_t address = 0x40): pwm_(address) {}
+  void begin() { pwm_.begin(); pwm_.setOscillatorFrequency(27000000); pwm_.setPWMFreq(50); delay(10); }
+  void setAngle(int channel, int angle) { setPulse(channel, 544 + (long)angle * (2400 - 544) / 180); }
+  void setPulse(int channel, int us) { pwm_.writeMicroseconds((uint8_t)channel, (uint16_t)us); }
+  void off(int channel) { pwm_.setPWM((uint8_t)channel, 0, 4096); }
+private:
+  Adafruit_PWMServoDriver pwm_;
+};

Barmaja_PyArduino/device_packs_builtin/ServoDriverPCA9685/example.py

@@ -0,0 +1,10 @@
+from Barmaja_PyArduino import *
+upload()
+
+arm = ServoDriverPCA9685()
+arm.begin()
+while True:
+    arm.setAngle(0, 0)
+    delay(800)
+    arm.setAngle(0, 180)
+    delay(800)

Barmaja_PyArduino/device_packs_builtin/ServoDriverPCA9685/pack.json

@@ -0,0 +1,117 @@
+{
+  "schema": 1,
+  "class": "ServoDriverPCA9685",
+  "title": "PCA9685 16-channel servo driver board (I2C)",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [
+    {
+      "name": "address",
+      "type": "Int",
+      "range": [
+        64,
+        127
+      ],
+      "default": 64
+    }
+  ],
+  "methods": {
+    "begin": {
+      "params": [],
+      "returns": "Void",
+      "starts": true
+    },
+    "setAngle": {
+      "params": [
+        {
+          "name": "channel",
+          "type": "Int",
+          "range": [
+            0,
+            15
+          ]
+        },
+        {
+          "name": "angle",
+          "type": "Int",
+          "range": [
+            0,
+            180
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "setPulse": {
+      "params": [
+        {
+          "name": "channel",
+          "type": "Int",
+          "range": [
+            0,
+            15
+          ]
+        },
+        {
+          "name": "microseconds",
+          "type": "Int",
+          "range": [
+            400,
+            2600
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "off": {
+      "params": [
+        {
+          "name": "channel",
+          "type": "Int",
+          "range": [
+            0,
+            15
+          ]
+        }
+      ],
+      "returns": "Void"
+    }
+  },
+  "resources": [
+    "i2c"
+  ],
+  "warnings": [
+    "Power the servos from the board's V+ terminal (external 5-6 V supply), never from the Uno 5V pin."
+  ],
+  "adapter": {
+    "library": "Barmaja_ServoDriverPCA9685",
+    "header": "Barmaja_ServoDriverPCA9685.h"
+  },
+  "dependencies": [
+    {
+      "id": "adafruit-busio",
+      "name": "Adafruit BusIO",
+      "version": "1.17.4",
+      "header": "Adafruit_I2CDevice.h",
+      "license": "MIT",
+      "source": "https://github.com/adafruit/Adafruit_BusIO",
+      "tag": "1.17.4",
+      "library_folder": "Adafruit_BusIO"
+    },
+    {
+      "id": "adafruit-pwm-servo-driver",
+      "name": "Adafruit PWM Servo Driver Library",
+      "version": "3.0.3",
+      "header": "Adafruit_PWMServoDriver.h",
+      "license": "BSD-3-Clause",
+      "source": "https://github.com/adafruit/Adafruit-PWM-Servo-Driver-Library",
+      "tag": "3.0.3",
+      "library_folder": "Adafruit_PWM_Servo_Driver_Library"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\narm = ServoDriverPCA9685()\narm.begin()\nwhile True:\n    arm.setAngle(0, 0)\n    delay(800)\n    arm.setAngle(0, 180)\n    delay(800)\n"
+}

Barmaja_PyArduino/device_packs_builtin/ShiftRegister595/arduino/Barmaja_ShiftRegister595/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_ShiftRegister595
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: 74HC595 shift register (8 extra outputs from 3 pins)
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/ShiftRegister595/arduino/Barmaja_ShiftRegister595/src/Barmaja_ShiftRegister595.h

@@ -0,0 +1,14 @@
+#pragma once
+#include <Arduino.h>
+// MSB first. setPin() remembers the other 7 outputs.
+class ShiftRegister595 {
+public:
+  ShiftRegister595(uint8_t data, uint8_t clock, uint8_t latch): data_(data), clock_(clock), latch_(latch) {}
+  void write(int value) { setup(); state_ = (uint8_t)value; send(); }
+  void setPin(int output, bool on) { setup(); if (on) state_ |= (1 << output); else state_ &= ~(1 << output); send(); }
+  void clear() { write(0); }
+private:
+  void setup() { if (!ready_) { pinMode(data_, OUTPUT); pinMode(clock_, OUTPUT); pinMode(latch_, OUTPUT); ready_ = true; } }
+  void send() { digitalWrite(latch_, LOW); shiftOut(data_, clock_, MSBFIRST, state_); digitalWrite(latch_, HIGH); }
+  uint8_t data_, clock_, latch_, state_ = 0; bool ready_ = false;
+};

Barmaja_PyArduino/device_packs_builtin/ShiftRegister595/example.py

@@ -0,0 +1,9 @@
+from Barmaja_PyArduino import *
+upload()
+
+leds = ShiftRegister595(11, 12, 8)
+while True:
+    for k in range(8):
+        leds.clear()
+        leds.setPin(k, True)
+        delay(150)