dln2 0.1.0__tar.gz

dln2-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 IPM Group
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dln2-0.1.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.1
+Name: dln2
+Version: 0.1.0
+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
+Author-email: contact@ipmgroup.dev
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyusb>=1.2
+
+# dln2 — Unified DLN2 USB I/O Board Wrapper
+
+Drop-in replacement for the four independent `dln2_*_wrapper` packages.  
+**All modules share a single USB connection** — no echo-counter conflicts, no USB contention.
+
+Originally developed for the [Pico USB I/O Board](https://github.com/syabyr/pico-usb-io-board).
+
+## Installation
+
+```bash
+pip install git+https://github.com/syabyr/dln2_wrapper
+```
+
+Requires: `pyusb`
+
+## Quick Start
+
+```python
+from dln2 import Dln2Connection, SpiDev, GPIO, SMBus, ADC
+
+conn = Dln2Connection()          # one USB connection
+
+# ── SPI ─────────────────────────────────────────────────
+spi = SpiDev(conn)
+spi.mode = 3
+spi.max_speed_hz = 16_000_000
+rx = spi.xfer2([0x9F, 0x00, 0x00, 0x00])  # JEDEC ID
+
+# ── GPIO ────────────────────────────────────────────────
+gpio = GPIO(conn)
+gpio.set_direction(20, "out")
+gpio.write(20, 1)                 # set pin HIGH
+val = gpio.read(20)               # read pin level
+
+# ── I2C ─────────────────────────────────────────────────
+i2c = SMBus(conn)
+i2c.open()
+devices = []
+for addr in range(1, 128):
+    try:
+        i2c.write_byte(addr, 0)
+        devices.append(addr)
+    except: pass
+
+# ── ADC ─────────────────────────────────────────────────
+adc = ADC(conn, vref=3.3)
+volts = adc.read_volts(0)         # read channel 0 voltage
+
+conn.close()
+```
+
+## Multi-Device Support
+
+```python
+from dln2 import list_devices, Dln2Connection
+
+for d in list_devices():
+    print(f"[{d.index}] serial={d.serial}")
+
+lcd_conn = Dln2Connection(index=0)     # first board — ST7789 display
+nfc_conn = Dln2Connection(index=1)     # second board — NFC reader
+# or by exact serial:
+# conn = Dln2Connection(serial="4250304B38353817")
+```
+
+## Module API
+
+### SpiDev
+spidev-compatible API: `xfer()`, `xfer2()`, `writebytes()`, `readbytes()`,  
+`mode`, `max_speed_hz`, `bits_per_word`, `cshigh`, `lsbfirst`, `host_hold_cs`
+
+### GPIO
+`set_direction(pin, "in"|"out")`, `write(pin, value)`, `read(pin)`,  
+`toggle(pin)`, `get_direction(pin)`, `set_event(pin, type)`, `poll_event()`
+
+### SMBus
+smbus-compatible API: `write_byte()`, `read_byte_data()`,  
+`write_word_data()`, `read_word_data()`, `read_block_data()`,  
+`write_block_data()`, `write_i2c_block_data()`, `read_i2c_block_data()`
+
+### ADC
+`read_channel(channel)`, `read_all()`, `read_volts(channel)`,  
+`set_resolution(bits)`, `enable_channel(ch)`, `disable_channel(ch)`
+
+### BME280
+`read_chip_id()`, `get_temperature()`, `get_humidity()`, `get_pressure()`,  
+`get_altitude()`, `get_all()`
+
+## Examples
+
+```bash
+# SPI JEDEC ID read
+python3 examples/spidev_test.py
+
+# GPIO pin toggle (default: Pico LED)
+python3 examples/gpio_toggle.py --pin 25
+
+# I2C bus scan
+python3 examples/i2c_scan.py
+
+# ADC monitor
+python3 examples/adc_info.py
+```
+
+## Why Unified?
+
+| | Old (4 packages) | New (`dln2`) |
+|---|---|---|
+| USB connections | 4 separate (echo conflicts) | 1 shared |
+| Code duplication | ~800 lines (4× Dln2Usb) | 0 lines |
+| GPIO events steal SPI responses | Yes | No (proper event queue) |
+| Multi-device | Manual USB enumeration | `list_devices()` |
+| Cross-module data flow | Impossible (4 echo counters) | Trivial (same counter) |
+
+## Related
+
+- [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) — RP2040 firmware
+- [st7789 display driver](https://github.com/syabyr/dln2_wrapper) — example ST7789 + BME280 application
+
+## License
+
+MIT

dln2-0.1.0/README.md

@@ -0,0 +1,122 @@
+# dln2 — Unified DLN2 USB I/O Board Wrapper
+
+Drop-in replacement for the four independent `dln2_*_wrapper` packages.  
+**All modules share a single USB connection** — no echo-counter conflicts, no USB contention.
+
+Originally developed for the [Pico USB I/O Board](https://github.com/syabyr/pico-usb-io-board).
+
+## Installation
+
+```bash
+pip install git+https://github.com/syabyr/dln2_wrapper
+```
+
+Requires: `pyusb`
+
+## Quick Start
+
+```python
+from dln2 import Dln2Connection, SpiDev, GPIO, SMBus, ADC
+
+conn = Dln2Connection()          # one USB connection
+
+# ── SPI ─────────────────────────────────────────────────
+spi = SpiDev(conn)
+spi.mode = 3
+spi.max_speed_hz = 16_000_000
+rx = spi.xfer2([0x9F, 0x00, 0x00, 0x00])  # JEDEC ID
+
+# ── GPIO ────────────────────────────────────────────────
+gpio = GPIO(conn)
+gpio.set_direction(20, "out")
+gpio.write(20, 1)                 # set pin HIGH
+val = gpio.read(20)               # read pin level
+
+# ── I2C ─────────────────────────────────────────────────
+i2c = SMBus(conn)
+i2c.open()
+devices = []
+for addr in range(1, 128):
+    try:
+        i2c.write_byte(addr, 0)
+        devices.append(addr)
+    except: pass
+
+# ── ADC ─────────────────────────────────────────────────
+adc = ADC(conn, vref=3.3)
+volts = adc.read_volts(0)         # read channel 0 voltage
+
+conn.close()
+```
+
+## Multi-Device Support
+
+```python
+from dln2 import list_devices, Dln2Connection
+
+for d in list_devices():
+    print(f"[{d.index}] serial={d.serial}")
+
+lcd_conn = Dln2Connection(index=0)     # first board — ST7789 display
+nfc_conn = Dln2Connection(index=1)     # second board — NFC reader
+# or by exact serial:
+# conn = Dln2Connection(serial="4250304B38353817")
+```
+
+## Module API
+
+### SpiDev
+spidev-compatible API: `xfer()`, `xfer2()`, `writebytes()`, `readbytes()`,  
+`mode`, `max_speed_hz`, `bits_per_word`, `cshigh`, `lsbfirst`, `host_hold_cs`
+
+### GPIO
+`set_direction(pin, "in"|"out")`, `write(pin, value)`, `read(pin)`,  
+`toggle(pin)`, `get_direction(pin)`, `set_event(pin, type)`, `poll_event()`
+
+### SMBus
+smbus-compatible API: `write_byte()`, `read_byte_data()`,  
+`write_word_data()`, `read_word_data()`, `read_block_data()`,  
+`write_block_data()`, `write_i2c_block_data()`, `read_i2c_block_data()`
+
+### ADC
+`read_channel(channel)`, `read_all()`, `read_volts(channel)`,  
+`set_resolution(bits)`, `enable_channel(ch)`, `disable_channel(ch)`
+
+### BME280
+`read_chip_id()`, `get_temperature()`, `get_humidity()`, `get_pressure()`,  
+`get_altitude()`, `get_all()`
+
+## Examples
+
+```bash
+# SPI JEDEC ID read
+python3 examples/spidev_test.py
+
+# GPIO pin toggle (default: Pico LED)
+python3 examples/gpio_toggle.py --pin 25
+
+# I2C bus scan
+python3 examples/i2c_scan.py
+
+# ADC monitor
+python3 examples/adc_info.py
+```
+
+## Why Unified?
+
+| | Old (4 packages) | New (`dln2`) |
+|---|---|---|
+| USB connections | 4 separate (echo conflicts) | 1 shared |
+| Code duplication | ~800 lines (4× Dln2Usb) | 0 lines |
+| GPIO events steal SPI responses | Yes | No (proper event queue) |
+| Multi-device | Manual USB enumeration | `list_devices()` |
+| Cross-module data flow | Impossible (4 echo counters) | Trivial (same counter) |
+
+## Related
+
+- [pico-usb-io-board](https://github.com/syabyr/pico-usb-io-board) — RP2040 firmware
+- [st7789 display driver](https://github.com/syabyr/dln2_wrapper) — example ST7789 + BME280 application
+
+## License
+
+MIT

dln2-0.1.0/dln2/__init__.py

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+"""
+Unified DLN2 wrapper package.
+
+Single USB connection shared by SPI, GPIO, I2C and ADC modules.
+Eliminates echo-counter conflicts and USB contention from the
+original four independent packages.
+
+Usage:
+    from dln2 import Dln2Connection, SpiDev, GPIO, SMBus, ADC, list_devices
+
+    conn = Dln2Connection()          # single USB connection
+    spi  = SpiDev(conn)              # all modules share conn
+    gpio = GPIO(conn)
+    i2c  = SMBus(conn)
+
+See also: dln2_wrapper.py (standalone legacy version)
+"""
+
+from ._core import Dln2Connection, list_devices, Dln2DeviceInfo
+from .spi import SpiDev
+from .gpio import GPIO, \
+    GPIO_EVENT_NONE, GPIO_EVENT_CHANGE, \
+    GPIO_EVENT_LEVEL_HIGH, GPIO_EVENT_LEVEL_LOW
+from .i2c import SMBus, i2c_msg
+from .adc import ADC
+from .bme280 import BME280