Barmaja-PyArduino 2.0.0__py3-none-any.whl

Barmaja_PyArduino/device_packs_builtin/ClockDS3231/arduino/Barmaja_ClockDS3231/src/Barmaja_ClockDS3231.h

@@ -0,0 +1,20 @@
+#pragma once
+#include <Arduino.h>
+#include <Wire.h>
+#include <RTClib.h>
+// Each getter reads the clock once (so hour/minute/second are fresh per call).
+class ClockDS3231 {
+public:
+  bool begin() { return rtc_.begin(); }
+  void setTime(int y, int mo, int d, int h, int mi, int s) { rtc_.adjust(DateTime(y, mo, d, h, mi, s)); }
+  int year() { return rtc_.now().year(); }
+  int month() { return rtc_.now().month(); }
+  int day() { return rtc_.now().day(); }
+  int hour() { return rtc_.now().hour(); }
+  int minute() { return rtc_.now().minute(); }
+  int second() { return rtc_.now().second(); }
+  float temperature() { return rtc_.getTemperature(); }
+  bool lostPower() { return rtc_.lostPower(); }
+private:
+  RTC_DS3231 rtc_;
+};

Barmaja_PyArduino/device_packs_builtin/ClockDS3231/example.py

@@ -0,0 +1,8 @@
+from Barmaja_PyArduino import *
+upload()
+
+clock = ClockDS3231()
+clock.begin()
+while True:
+    print(f"{clock.hour()}:{clock.minute()}:{clock.second()}")
+    delay(1000)

Barmaja_PyArduino/device_packs_builtin/ClockDS3231/pack.json

@@ -0,0 +1,136 @@
+{
+  "schema": 1,
+  "class": "ClockDS3231",
+  "title": "DS3231 real-time clock module (I2C)",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [],
+  "methods": {
+    "begin": {
+      "params": [],
+      "returns": "Bool",
+      "starts": true
+    },
+    "setTime": {
+      "params": [
+        {
+          "name": "year",
+          "type": "Int",
+          "range": [
+            2000,
+            2099
+          ]
+        },
+        {
+          "name": "month",
+          "type": "Int",
+          "range": [
+            1,
+            12
+          ]
+        },
+        {
+          "name": "day",
+          "type": "Int",
+          "range": [
+            1,
+            31
+          ]
+        },
+        {
+          "name": "hour",
+          "type": "Int",
+          "range": [
+            0,
+            23
+          ]
+        },
+        {
+          "name": "minute",
+          "type": "Int",
+          "range": [
+            0,
+            59
+          ]
+        },
+        {
+          "name": "second",
+          "type": "Int",
+          "range": [
+            0,
+            59
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "year": {
+      "params": [],
+      "returns": "Int"
+    },
+    "month": {
+      "params": [],
+      "returns": "Int"
+    },
+    "day": {
+      "params": [],
+      "returns": "Int"
+    },
+    "hour": {
+      "params": [],
+      "returns": "Int"
+    },
+    "minute": {
+      "params": [],
+      "returns": "Int"
+    },
+    "second": {
+      "params": [],
+      "returns": "Int"
+    },
+    "temperature": {
+      "params": [],
+      "returns": "Float"
+    },
+    "lostPower": {
+      "params": [],
+      "returns": "Bool"
+    }
+  },
+  "resources": [
+    "i2c"
+  ],
+  "warnings": [],
+  "adapter": {
+    "library": "Barmaja_ClockDS3231",
+    "header": "Barmaja_ClockDS3231.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-rtclib",
+      "name": "RTClib",
+      "version": "2.1.4",
+      "header": "RTClib.h",
+      "license": "MIT",
+      "source": "https://github.com/adafruit/RTClib",
+      "tag": "2.1.4",
+      "library_folder": "RTClib"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nclock = ClockDS3231()\nclock.begin()\nwhile True:\n    print(f\"{clock.hour()}:{clock.minute()}:{clock.second()}\")\n    delay(1000)\n",
+  "notes": "Use setTime() once, then remove it so every reset does not set the old time again."
+}

Barmaja_PyArduino/device_packs_builtin/DistanceVL53L0X/arduino/Barmaja_DistanceVL53L0X/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_DistanceVL53L0X
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: VL53L0X laser time-of-flight distance sensor (I2C, up to ~1.2 m)
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/DistanceVL53L0X/arduino/Barmaja_DistanceVL53L0X/src/Barmaja_DistanceVL53L0X.h

@@ -0,0 +1,12 @@
+#pragma once
+#include <Arduino.h>
+#include <Wire.h>
+#include <VL53L0X.h>
+class DistanceVL53L0X {
+public:
+  bool begin() { Wire.begin(); sensor_.setTimeout(500); if (!sensor_.init()) return false; sensor_.startContinuous(); return true; }
+  int readMillimeters() { return (int)sensor_.readRangeContinuousMillimeters(); }
+  bool timedOut() { return sensor_.timeoutOccurred(); }
+private:
+  VL53L0X sensor_;
+};

Barmaja_PyArduino/device_packs_builtin/DistanceVL53L0X/example.py

@@ -0,0 +1,8 @@
+from Barmaja_PyArduino import *
+upload()
+
+laser = DistanceVL53L0X()
+laser.begin()
+while True:
+    print("Distance =", laser.readMillimeters(), "mm")
+    delay(200)

Barmaja_PyArduino/device_packs_builtin/DistanceVL53L0X/pack.json

@@ -0,0 +1,48 @@
+{
+  "schema": 1,
+  "class": "DistanceVL53L0X",
+  "title": "VL53L0X laser time-of-flight distance sensor (I2C, up to ~1.2 m)",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [],
+  "methods": {
+    "begin": {
+      "params": [],
+      "returns": "Bool",
+      "starts": true
+    },
+    "readMillimeters": {
+      "params": [],
+      "returns": "Int"
+    },
+    "timedOut": {
+      "params": [],
+      "returns": "Bool"
+    }
+  },
+  "resources": [
+    "i2c"
+  ],
+  "warnings": [],
+  "adapter": {
+    "library": "Barmaja_DistanceVL53L0X",
+    "header": "Barmaja_DistanceVL53L0X.h"
+  },
+  "dependencies": [
+    {
+      "id": "pololu-vl53l0x",
+      "name": "VL53L0X",
+      "version": "1.3.1",
+      "header": "VL53L0X.h",
+      "license": "MIT (Pololu; includes ST API notice)",
+      "source": "https://github.com/pololu/vl53l0x-arduino",
+      "tag": "1.3.1",
+      "library_folder": "VL53L0X"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nlaser = DistanceVL53L0X()\nlaser.begin()\nwhile True:\n    print(\"Distance =\", laser.readMillimeters(), \"mm\")\n    delay(200)\n"
+}

Barmaja_PyArduino/device_packs_builtin/LCDParallel/arduino/Barmaja_LCDParallel/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_LCDParallel
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: 16x2 / 20x4 character LCD wired in 4-bit parallel mode (no I2C backpack)
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/LCDParallel/arduino/Barmaja_LCDParallel/src/Barmaja_LCDParallel.h

@@ -0,0 +1,17 @@
+#pragma once
+#include <Arduino.h>
+#include <LiquidCrystal.h>
+// Inherits Print, so print()/println() and f-strings work like Serial.
+class LCDParallel : public Print {
+public:
+  LCDParallel(uint8_t rs, uint8_t en, uint8_t d4, uint8_t d5, uint8_t d6, uint8_t d7): lcd_(rs, en, d4, d5, d6, d7) {}
+  void begin(int columns = 16, int rows = 2) { lcd_.begin((uint8_t)columns, (uint8_t)rows); }
+  void clear() { lcd_.clear(); }
+  void home() { lcd_.home(); }
+  void setCursor(int column, int row) { lcd_.setCursor((uint8_t)column, (uint8_t)row); }
+  size_t write(uint8_t c) override { return lcd_.write(c); }
+  using Print::print;
+  using Print::println;
+private:
+  LiquidCrystal lcd_;
+};

Barmaja_PyArduino/device_packs_builtin/LCDParallel/example.py

@@ -0,0 +1,10 @@
+from Barmaja_PyArduino import *
+upload()
+
+lcd = LCDParallel(12, 11, 5, 4, 3, 2)
+lcd.begin(16, 2)
+lcd.print("Hello BARMAJA")
+while True:
+    lcd.setCursor(0, 1)
+    lcd.print(f"Light: {analogRead(A0)}   ")
+    delay(300)

Barmaja_PyArduino/device_packs_builtin/LCDParallel/pack.json

@@ -0,0 +1,137 @@
+{
+  "schema": 1,
+  "class": "LCDParallel",
+  "title": "16x2 / 20x4 character LCD wired in 4-bit parallel mode (no I2C backpack)",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [
+    {
+      "name": "rs",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "en",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "d4",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "d5",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "d6",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "d7",
+      "type": "Int",
+      "rule": "digital_pin"
+    }
+  ],
+  "methods": {
+    "begin": {
+      "params": [
+        {
+          "name": "columns",
+          "type": "Int",
+          "range": [
+            8,
+            40
+          ],
+          "default": 16
+        },
+        {
+          "name": "rows",
+          "type": "Int",
+          "range": [
+            1,
+            4
+          ],
+          "default": 2
+        }
+      ],
+      "returns": "Void",
+      "starts": true
+    },
+    "clear": {
+      "params": [],
+      "returns": "Void"
+    },
+    "home": {
+      "params": [],
+      "returns": "Void"
+    },
+    "setCursor": {
+      "params": [
+        {
+          "name": "column",
+          "type": "Int",
+          "range": [
+            0,
+            39
+          ]
+        },
+        {
+          "name": "row",
+          "type": "Int",
+          "range": [
+            0,
+            3
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "print": {
+      "params": [
+        {
+          "name": "value",
+          "type": "Scalar"
+        }
+      ],
+      "returns": "Void"
+    },
+    "println": {
+      "params": [
+        {
+          "name": "value",
+          "type": "Scalar",
+          "default": 0
+        }
+      ],
+      "returns": "Void"
+    }
+  },
+  "resources": [],
+  "warnings": [],
+  "adapter": {
+    "library": "Barmaja_LCDParallel",
+    "header": "Barmaja_LCDParallel.h"
+  },
+  "dependencies": [
+    {
+      "id": "arduino-liquidcrystal",
+      "name": "LiquidCrystal",
+      "version": "1.0.7",
+      "header": "LiquidCrystal.h",
+      "license": "LGPL-2.1 (Arduino)",
+      "source": "https://github.com/arduino-libraries/LiquidCrystal",
+      "tag": "1.0.7",
+      "library_folder": "LiquidCrystal"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nlcd = LCDParallel(12, 11, 5, 4, 3, 2)\nlcd.begin(16, 2)\nlcd.print(\"Hello BARMAJA\")\nwhile True:\n    lcd.setCursor(0, 1)\n    lcd.print(f\"Light: {analogRead(A0)}   \")\n    delay(300)\n",
+  "notes": "Contrast pin V0 needs a 10k potentiometer."
+}

Barmaja_PyArduino/device_packs_builtin/LoadCellHX711/arduino/Barmaja_LoadCellHX711/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_LoadCellHX711
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: HX711 load-cell amplifier (kitchen-scale sensor)
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/LoadCellHX711/arduino/Barmaja_LoadCellHX711/src/Barmaja_LoadCellHX711.h

@@ -0,0 +1,16 @@
+#pragma once
+#include <Arduino.h>
+#include <HX711.h>
+// Channel A, gain 128. readUnits() = average of 5 readings / scale factor.
+class LoadCellHX711 {
+public:
+  LoadCellHX711(uint8_t dout, uint8_t sck): dout_(dout), sck_(sck) {}
+  void begin() { scale_.begin(dout_, sck_); }
+  void tare() { scale_.tare(); }
+  void setScale(float factor) { scale_.set_scale(factor); }
+  float readUnits() { return scale_.get_units(5); }
+  bool isReady() { return scale_.is_ready(); }
+private:
+  uint8_t dout_, sck_;
+  HX711 scale_;
+};

Barmaja_PyArduino/device_packs_builtin/LoadCellHX711/example.py

@@ -0,0 +1,11 @@
+from Barmaja_PyArduino import *
+upload()
+
+scale = LoadCellHX711(3, 2)
+scale.begin()
+scale.setScale(420.0)
+scale.tare()
+while True:
+    if scale.isReady():
+        print("Weight =", scale.readUnits(), "g")
+    delay(500)

Barmaja_PyArduino/device_packs_builtin/LoadCellHX711/pack.json

@@ -0,0 +1,74 @@
+{
+  "schema": 1,
+  "class": "LoadCellHX711",
+  "title": "HX711 load-cell amplifier (kitchen-scale sensor)",
+  "status": "compile-verified",
+  "boards": [
+    "uno",
+    "nano"
+  ],
+  "constructor": [
+    {
+      "name": "dout_pin",
+      "type": "Int",
+      "rule": "digital_pin"
+    },
+    {
+      "name": "sck_pin",
+      "type": "Int",
+      "rule": "digital_pin"
+    }
+  ],
+  "methods": {
+    "begin": {
+      "params": [],
+      "returns": "Void",
+      "starts": true
+    },
+    "tare": {
+      "params": [],
+      "returns": "Void"
+    },
+    "setScale": {
+      "params": [
+        {
+          "name": "factor",
+          "type": [
+            "Float",
+            "Int"
+          ]
+        }
+      ],
+      "returns": "Void"
+    },
+    "readUnits": {
+      "params": [],
+      "returns": "Float"
+    },
+    "isReady": {
+      "params": [],
+      "returns": "Bool"
+    }
+  },
+  "resources": [],
+  "warnings": [],
+  "adapter": {
+    "library": "Barmaja_LoadCellHX711",
+    "header": "Barmaja_LoadCellHX711.h"
+  },
+  "dependencies": [
+    {
+      "id": "bogde-hx711",
+      "name": "HX711",
+      "version": "0.7.5",
+      "header": "HX711.h",
+      "license": "MIT",
+      "source": "https://github.com/bogde/HX711",
+      "tag": "0.7.5",
+      "library_folder": "HX711"
+    }
+  ],
+  "liverun": false,
+  "example": "from Barmaja_PyArduino import *\nupload()\n\nscale = LoadCellHX711(3, 2)\nscale.begin()\nscale.setScale(420.0)\nscale.tare()\nwhile True:\n    if scale.isReady():\n        print(\"Weight =\", scale.readUnits(), \"g\")\n    delay(500)\n",
+  "notes": "Calibrate setScale() with a known weight."
+}

Barmaja_PyArduino/device_packs_builtin/NeoPixelStrip/arduino/Barmaja_NeoPixelStrip/library.properties

@@ -0,0 +1,9 @@
+name=Barmaja_NeoPixelStrip
+version=1.1.0
+author=BARMAJA
+maintainer=BARMAJA
+sentence=BARMAJA PyArduino device-pack adapter: WS2812 / NeoPixel RGB LED strip or ring
+paragraph=
+category=Device Control
+url=
+architectures=avr

Barmaja_PyArduino/device_packs_builtin/NeoPixelStrip/arduino/Barmaja_NeoPixelStrip/src/Barmaja_NeoPixelStrip.h

@@ -0,0 +1,15 @@
+#pragma once
+#include <Arduino.h>
+#include <Adafruit_NeoPixel.h>
+// GRB 800 kHz strips/rings (WS2812B). Call show() to send the colors.
+class NeoPixelStrip {
+public:
+  NeoPixelStrip(uint8_t pin, uint16_t count): strip_(count, pin, NEO_GRB + NEO_KHZ800) {}
+  void begin() { strip_.begin(); strip_.show(); }
+  void setPixel(int index, int r, int g, int b) { strip_.setPixelColor((uint16_t)index, (uint8_t)r, (uint8_t)g, (uint8_t)b); }
+  void setBrightness(int level) { strip_.setBrightness((uint8_t)level); }
+  void clear() { strip_.clear(); }
+  void show() { strip_.show(); }
+private:
+  Adafruit_NeoPixel strip_;
+};

Barmaja_PyArduino/device_packs_builtin/NeoPixelStrip/example.py

@@ -0,0 +1,13 @@
+from Barmaja_PyArduino import *
+upload()
+
+ring = NeoPixelStrip(6, 8)
+ring.begin()
+ring.setBrightness(40)
+i = 0
+while True:
+    ring.clear()
+    ring.setPixel(i, 0, 120, 255)
+    ring.show()
+    i = (i + 1) % 8
+    delay(100)