dln2 0.2.0__tar.gz → 0.2.1__tar.gz

{dln2-0.2.0 → dln2-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dln2
-Version: 0.2.0
+Version: 0.2.1
 Summary: Unified DLN2 driver — SPI, GPIO, I2C, ADC over a single USB connection. Originally developed for the Pico USB I/O Board.
 Home-page: https://github.com/syabyr/dln2_wrapper
 Author: IPM Group
@@ -187,6 +187,27 @@ python3 examples/adc_info.py
 | Multi-device | Manual USB enumeration | `list_devices()` |
 | Cross-module data flow | Impossible (4 echo counters) | Trivial (same counter) |
 
+## Pin Constraints
+
+| Pins | Capability |
+|---|---|
+| 0–22, 26–28 | Full GPIO (input/output + events) |
+| 23, 24, 29 | Output-only (reserved for SMPS / VBUS / VSYS) |
+| 25 | Output-only (on-board LED) |
+| ADC 0–2 | Map to GPIO 26, 27, 28 respectively |
+
+## Firmware Compatibility
+
+| dln2 Python | Minimum firmware | Notes |
+|---|---|---|
+| 0.2.1 | [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) `>= v0.2` | SPI bpw validation, ADC pin-sharing fix |
+| 0.2.0 | any | Works with all firmware versions |
+
+To flash updated firmware:
+1. Hold the BOOTSEL button while connecting the Pico (or press and release RESET while holding BOOTSEL)
+2. Copy `dln2.uf2` to the `RPI-RP2` USB drive that appears
+3. The Pico reboots automatically with the new firmware
+
 ## Related
 
 - [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) — RP2040 firmware

{dln2-0.2.0 → dln2-0.2.1}/README.md

@@ -152,6 +152,27 @@ python3 examples/adc_info.py
 | Multi-device | Manual USB enumeration | `list_devices()` |
 | Cross-module data flow | Impossible (4 echo counters) | Trivial (same counter) |
 
+## Pin Constraints
+
+| Pins | Capability |
+|---|---|
+| 0–22, 26–28 | Full GPIO (input/output + events) |
+| 23, 24, 29 | Output-only (reserved for SMPS / VBUS / VSYS) |
+| 25 | Output-only (on-board LED) |
+| ADC 0–2 | Map to GPIO 26, 27, 28 respectively |
+
+## Firmware Compatibility
+
+| dln2 Python | Minimum firmware | Notes |
+|---|---|---|
+| 0.2.1 | [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) `>= v0.2` | SPI bpw validation, ADC pin-sharing fix |
+| 0.2.0 | any | Works with all firmware versions |
+
+To flash updated firmware:
+1. Hold the BOOTSEL button while connecting the Pico (or press and release RESET while holding BOOTSEL)
+2. Copy `dln2.uf2` to the `RPI-RP2` USB drive that appears
+3. The Pico reboots automatically with the new firmware
+
 ## Related
 
 - [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) — RP2040 firmware

{dln2-0.2.0 → dln2-0.2.1}/dln2/_core.py

@@ -127,18 +127,25 @@ class Dln2Connection:
         self._setup()
 
     def _setup(self):
-        # Reset USB to clear stale state
-        try:
-            self._dev.reset()
-        except Exception:
-            pass
+        # NOTE: Do NOT call self._dev.reset() here.
+        # A USB bus reset only resets the USB peripheral on the RP2040 —
+        # SPI PIO/DMA state machines survive it. Commands that hit a
+        # half-configured PIO cause a hard fault that kills the firmware
+        # and requires a physical replug. Instead, just set configuration.
 
         try:
             self._dev.set_configuration()
         except Exception:
             pass
 
-        cfg = self._dev.get_active_configuration()
+        try:
+            cfg = self._dev.get_active_configuration()
+        except Exception:
+            raise RuntimeError(
+                "DLN2 device is not responding — "
+                "the Pico firmware may have crashed.\n"
+                "Please replug the USB cable to power-cycle the board."
+            )
         intf = cfg[(0, 0)]
 
         ep_out = ep_in = None

{dln2-0.2.0 → dln2-0.2.1}/dln2/cli.py

@@ -339,10 +339,10 @@ def spi_test():
 
     try:
         print("Opening SpiDev (DLN backend)...")
-        dev.open(0, 0)
         dev.max_speed_hz = 1_000_000
         dev.mode = 0
         dev.bits_per_word = 8
+        dev.open(0, 0)
         tx = [0x9F, 0x00, 0x00, 0x00]
         print("Sending JEDEC (0x9F) via DLN wrapper... host_hold_cs=", dev.host_hold_cs)
         rx = dev.xfer2(tx)
@@ -359,23 +359,22 @@ def spi_test():
 
 
 def bpw_test():
-    """Cycle SPI bits-per-word 4..16 sending a test pattern at each setting."""
+    """Cycle SPI bits-per-word 8 and 16 sending a test pattern at each setting."""
     from dln2.spi import SpiDev
 
-    print("Sending one transfer for each BPW 4..16")
+    print("Sending one transfer for BPW 8 and 16")
     try:
         with SpiDev() as dev:
-            dev.open(0, 0)
             dev.max_speed_hz = 1_000_000
             dev.mode = 0
 
-            for bpw in range(4, 17):
+            for bpw in (8, 16):
                 dev.bits_per_word = bpw
+                dev.open(0, 0)
 
-                if bpw <= 8:
-                    pattern = 0xAA & ((1 << bpw) - 1)
-                else:
-                    pattern = 0xAAAA & ((1 << bpw) - 1)
+                mask = (1 << bpw) - 1
+                pattern = 0xAA if bpw <= 8 else 0xAAAA
+                pattern &= mask
 
                 try:
                     rx = dev.xfer2([pattern])
@@ -383,7 +382,8 @@ def bpw_test():
                 except Exception as e:
                     print(f"bpw={bpw:2d}  tx={pattern:#06x}  FAILED: {e}")
 
-                time.sleep(0.1)
+                dev.close()
+                time.sleep(0.2)
 
             print("Done.")
     except RuntimeError as e:

{dln2-0.2.0 → dln2-0.2.1}/dln2/spi.py

@@ -46,14 +46,33 @@ class SpiDev:
 
     @bits_per_word.setter
     def bits_per_word(self, v):
-        self._bits_per_word = int(v)
+        v = int(v)
+        # RP2040 PIO SPI only reliably supports 8 and 16 bit frames.
+        # Other values (4-7, 9-15) can trigger firmware DMA/PIO bugs.
+        if v not in (8, 16):
+            raise ValueError(
+                f"bits_per_word must be 8 or 16, got {v}. "
+                f"The Pico firmware does not support other frame sizes."
+            )
+        self._bits_per_word = v
 
     def open(self, bus=0, device=0):
-        """No-op — connection already open. For spidev compatibility."""
+        """Enable the SPI module. For spidev compatibility."""
+        self._conn.spi_enable()
+        self._configure()
         return self
 
     def close(self):
-        pass  # connection is shared, caller manages _conn.close()
+        """Disable the SPI module so the firmware releases its PIO/DMA state."""
+        try:
+            self._conn.spi_disable()
+        except Exception:
+            pass
+
+    def _configure(self):
+        """Sync current settings to the hardware."""
+        self._conn.spi_configure(self._mode, self._max_speed_hz,
+                                  self._bits_per_word)
 
     def xfer2(self, data):
         """Full-duplex transfer. Returns MISO data."""

{dln2-0.2.0 → dln2-0.2.1}/dln2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dln2
-Version: 0.2.0
+Version: 0.2.1
 Summary: Unified DLN2 driver — SPI, GPIO, I2C, ADC over a single USB connection. Originally developed for the Pico USB I/O Board.
 Home-page: https://github.com/syabyr/dln2_wrapper
 Author: IPM Group
@@ -187,6 +187,27 @@ python3 examples/adc_info.py
 | Multi-device | Manual USB enumeration | `list_devices()` |
 | Cross-module data flow | Impossible (4 echo counters) | Trivial (same counter) |
 
+## Pin Constraints
+
+| Pins | Capability |
+|---|---|
+| 0–22, 26–28 | Full GPIO (input/output + events) |
+| 23, 24, 29 | Output-only (reserved for SMPS / VBUS / VSYS) |
+| 25 | Output-only (on-board LED) |
+| ADC 0–2 | Map to GPIO 26, 27, 28 respectively |
+
+## Firmware Compatibility
+
+| dln2 Python | Minimum firmware | Notes |
+|---|---|---|
+| 0.2.1 | [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) `>= v0.2` | SPI bpw validation, ADC pin-sharing fix |
+| 0.2.0 | any | Works with all firmware versions |
+
+To flash updated firmware:
+1. Hold the BOOTSEL button while connecting the Pico (or press and release RESET while holding BOOTSEL)
+2. Copy `dln2.uf2` to the `RPI-RP2` USB drive that appears
+3. The Pico reboots automatically with the new firmware
+
 ## Related
 
 - [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) — RP2040 firmware

{dln2-0.2.0 → dln2-0.2.1}/setup.py

@@ -5,7 +5,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="dln2",
-    version="0.2.0",
+    version="0.2.1",
     description="Unified DLN2 driver — SPI, GPIO, I2C, ADC over a single USB connection. "
                 "Originally developed for the Pico USB I/O Board.",
     long_description=open("README.md").read(),