First Pass

Author: noaglaserdocusign

README.md

@@ -0,0 +1,37 @@
+# ElectroBlocks
+
+**ElectroBlocks** is a Python library for communicating with Arduino-based educational hardware using a custom serial protocol. It simplifies control of servos, RGB LEDs, LCD screens, and more—especially in block-based coding environments like Blockly.
+
+## Features
+
+- Auto-detects the first available Arduino Uno or Mega over USB
+- Sends `config:` and control commands to the Arduino firmware
+- Waits for `"System:READY"` and `"DONE_NEXT_COMMAND"` to sync logic
+- Supports digital write, RGB LEDs, LCD printing, and servo control
+
+## Installation
+
+```bash
+pip install git+https://github.com/ElectroBlocks/python.git
+```
+
+## Example
+
+```python
+from electroblocks import ElectroBlocks
+
+eb = ElectroBlocks()
+eb.config_servo(5)
+eb.move_servo(5, 90)
+eb.config_rgb(3, 5, 6)
+eb.set_rgb(255, 128, 0)
+eb.config_lcd()
+eb.lcd_print(0, 0, "Hello")
+eb.lcd_clear()
+eb.digital_write(13, 1)
+eb.close()
+```
+
+## License
+
+MIT

electroblocks.zip

@@ -0,0 +1 @@
+from .core import ElectroBlocks

electroblocks/__init__.py

@@ -0,0 +1,64 @@
+import serial
+import serial.tools.list_ports
+import time
+
+class ElectroBlocks:
+    def __init__(self, baudrate=115200, timeout=2):
+        self.ser = self._auto_connect(baudrate, timeout)
+        self._wait_for_ready()
+
+    def _auto_connect(self, baudrate, timeout):
+        ports = list(serial.tools.list_ports.comports())
+        for p in ports:
+            if "Arduino" in p.description or "ttyACM" in p.device or "ttyUSB" in p.device:
+                try:
+                    ser = serial.Serial(p.device, baudrate, timeout=timeout)
+                    time.sleep(2)  # Give Arduino time to reset
+                    return ser
+                except serial.SerialException:
+                    continue
+        raise Exception("No Arduino Uno or Mega found.")
+
+    def _wait_for_ready(self):
+        self.ser.write(b"IAM_READY|\n")
+        while True:
+            if self.ser.in_waiting:
+                line = self.ser.readline().decode().strip()
+                if "System:READY" in line:
+                    break
+
+    def _send(self, cmd):
+        self.ser.write((cmd + "|\n").encode())
+        while True:
+            if self.ser.in_waiting:
+                line = self.ser.readline().decode().strip()
+                if "DONE_NEXT_COMMAND" in line:
+                    break
+
+    def config_servo(self, pin):
+        self._send(f"config:servo={pin}")
+
+    def move_servo(self, pin, angle):
+        self._send(f"s:{pin}:{angle}")
+
+    def config_rgb(self, r_pin, g_pin, b_pin):
+        self._send(f"config:rgb={r_pin},{g_pin},{b_pin}")
+
+    def set_rgb(self, r, g, b):
+        self._send(f"rgb:{r},{g},{b}")
+
+    def config_lcd(self, rows=2, cols=16):
+        self._send(f"config:lcd={rows},{cols}")
+
+    def lcd_print(self, row, col, message):
+        self._send(f"l:{row}:{col}:{message}")
+
+    def lcd_clear(self):
+        self._send("l:clear")
+
+    def digital_write(self, pin, value):
+        self._send(f"dw:{pin}:{value}")
+
+    def close(self):
+        if self.ser and self.ser.is_open:
+            self.ser.close()

electroblocks/core.py

@@ -0,0 +1,17 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='electroblocks',
+    version='0.1.0',
+    packages=find_packages(),
+    install_requires=['pyserial'],
+    author='Your Name',
+    author_email='[email protected]',
+    description='Python client library to interact with ElectroBlocks Arduino firmware',
+    url='https://github.com/yourusername/electroblocks',
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'Operating System :: OS Independent',
+    ],
+    python_requires='>=3.6',
+)