cobra-bridge 0.1.0__tar.gz

cobra_bridge-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+node_modules/
+*.tgz
+.DS_Store

cobra_bridge-0.1.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: cobra-bridge
+Version: 0.1.0
+Summary: COines BRidge Access — Bosch AppBoard protocol for Python
+Project-URL: Homepage, https://github.com/drpoom/cobra
+Project-URL: Repository, https://github.com/drpoom/cobra
+Author-email: John Poom <drpoom@users.noreply.github.com>
+License-Expression: MIT
+Keywords: appboard,ble,bmm350,bosch,coines,i2c,magnetometer,sensortec,serial,spi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Requires-Python: >=3.9
+Requires-Dist: pyserial>=3.5
+Provides-Extra: ble
+Requires-Dist: bleak>=0.21; extra == 'ble'
+Provides-Extra: dev
+Requires-Dist: hatch; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cobra-bridge
+
+**COines BRidge Access** — Bosch AppBoard protocol for Python
+
+Transport-agnostic library for the Bosch Sensortec Application Board 3.1+.
+Supports USB-Serial (pyserial) and BLE (Bleak) backends with identical protocol logic.
+
+## Install
+
+```bash
+pip install cobra-bridge
+```
+
+For BLE support:
+
+```bash
+pip install cobra-bridge[ble]
+```
+
+## Quick Start
+
+```python
+from cobra_bridge.transport import SerialTransport
+from cobra_bridge.sync import CobraBridge
+from cobra_bridge.drivers.bmm350 import BMM350
+
+# USB-Serial
+transport = SerialTransport(port='/dev/ttyACM0')
+bridge = CobraBridge(transport=transport)
+bridge.connect()
+
+sensor = BMM350(bridge)
+sensor.init()
+data = sensor.read_mag_data(compensated=True)
+print(f"X={data['x']:.2f} Y={data['y']:.2f} Z={data['z']:.2f} uT")
+
+bridge.disconnect()
+```
+
+## Platform-Specific Setup
+
+### Linux
+
+```bash
+# Install
+pip install cobra-bridge
+
+# Serial port — typically /dev/ttyACM0 or /dev/ttyUSB0
+# Add yourself to the dialout group to avoid sudo:
+sudo usermod -aG dialout $USER
+# Log out and back in for group changes to take effect
+
+# Find your board:
+ls /dev/ttyACM* /dev/ttyUSB*
+
+# Usage
+from cobra_bridge.transport import SerialTransport
+transport = SerialTransport(port='/dev/ttyACM0')
+```
+
+### macOS
+
+```bash
+# Install
+pip install cobra-bridge
+
+# Serial port — typically /dev/cu.usbmodemXXXX
+# List available ports:
+ls /dev/cu.usbmodem*
+
+# Usage
+from cobra_bridge.transport import SerialTransport
+transport = SerialTransport(port='/dev/cu.usbmodem1401')
+```
+
+### Windows
+
+```bash
+# Install
+pip install cobra-bridge
+
+# Serial port — typically COM3, COM4, etc.
+# Check Device Manager → Ports (COM & LPT) to find your board
+
+# Usage
+from cobra_bridge.transport import SerialTransport
+transport = SerialTransport(port='COM3')
+```
+
+## BLE (All Platforms)
+
+```python
+from cobra_bridge.transport import BleTransport
+
+# Scan for devices
+devices = await BleTransport.scan(timeout=5.0)
+
+# Connect by address
+transport = BleTransport(address='AA:BB:CC:DD:EE:FF')
+bridge = CobraBridge(transport=transport)
+bridge.connect()
+```
+
+> **Note:** BLE requires the `[ble]` extra: `pip install cobra-bridge[ble]`
+
+## Architecture
+
+```
+         ┌──────────────┐     ┌─────────────┐
+         │  CobraBridge │────▶│  Transport  │  ← abstract base
+         │  (Packetizer)│     │  (I/O)      │
+         └──────────────┘     └─────────────┘
+                                   │
+                       ┌───────────┴───────────┐
+                       │                       │
+                 Serial Transport        BLE Transport
+                 (pyserial/WebSerial)   (Bleak/WebBluetooth)
+```
+
+## License
+
+MIT

cobra_bridge-0.1.0/README.md

@@ -0,0 +1,122 @@
+# cobra-bridge
+
+**COines BRidge Access** — Bosch AppBoard protocol for Python
+
+Transport-agnostic library for the Bosch Sensortec Application Board 3.1+.
+Supports USB-Serial (pyserial) and BLE (Bleak) backends with identical protocol logic.
+
+## Install
+
+```bash
+pip install cobra-bridge
+```
+
+For BLE support:
+
+```bash
+pip install cobra-bridge[ble]
+```
+
+## Quick Start
+
+```python
+from cobra_bridge.transport import SerialTransport
+from cobra_bridge.sync import CobraBridge
+from cobra_bridge.drivers.bmm350 import BMM350
+
+# USB-Serial
+transport = SerialTransport(port='/dev/ttyACM0')
+bridge = CobraBridge(transport=transport)
+bridge.connect()
+
+sensor = BMM350(bridge)
+sensor.init()
+data = sensor.read_mag_data(compensated=True)
+print(f"X={data['x']:.2f} Y={data['y']:.2f} Z={data['z']:.2f} uT")
+
+bridge.disconnect()
+```
+
+## Platform-Specific Setup
+
+### Linux
+
+```bash
+# Install
+pip install cobra-bridge
+
+# Serial port — typically /dev/ttyACM0 or /dev/ttyUSB0
+# Add yourself to the dialout group to avoid sudo:
+sudo usermod -aG dialout $USER
+# Log out and back in for group changes to take effect
+
+# Find your board:
+ls /dev/ttyACM* /dev/ttyUSB*
+
+# Usage
+from cobra_bridge.transport import SerialTransport
+transport = SerialTransport(port='/dev/ttyACM0')
+```
+
+### macOS
+
+```bash
+# Install
+pip install cobra-bridge
+
+# Serial port — typically /dev/cu.usbmodemXXXX
+# List available ports:
+ls /dev/cu.usbmodem*
+
+# Usage
+from cobra_bridge.transport import SerialTransport
+transport = SerialTransport(port='/dev/cu.usbmodem1401')
+```
+
+### Windows
+
+```bash
+# Install
+pip install cobra-bridge
+
+# Serial port — typically COM3, COM4, etc.
+# Check Device Manager → Ports (COM & LPT) to find your board
+
+# Usage
+from cobra_bridge.transport import SerialTransport
+transport = SerialTransport(port='COM3')
+```
+
+## BLE (All Platforms)
+
+```python
+from cobra_bridge.transport import BleTransport
+
+# Scan for devices
+devices = await BleTransport.scan(timeout=5.0)
+
+# Connect by address
+transport = BleTransport(address='AA:BB:CC:DD:EE:FF')
+bridge = CobraBridge(transport=transport)
+bridge.connect()
+```
+
+> **Note:** BLE requires the `[ble]` extra: `pip install cobra-bridge[ble]`
+
+## Architecture
+
+```
+         ┌──────────────┐     ┌─────────────┐
+         │  CobraBridge │────▶│  Transport  │  ← abstract base
+         │  (Packetizer)│     │  (I/O)      │
+         └──────────────┘     └─────────────┘
+                                   │
+                       ┌───────────┴───────────┐
+                       │                       │
+                 Serial Transport        BLE Transport
+                 (pyserial/WebSerial)   (Bleak/WebBluetooth)
+```
+
+## License
+
+MIT

cobra_bridge-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cobra-bridge"
+version = "0.1.0"
+description = "COines BRidge Access — Bosch AppBoard protocol for Python"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "John Poom", email = "drpoom@users.noreply.github.com" },
+]
+keywords = ["bosch", "sensortec", "coines", "appboard", "bmm350", "magnetometer", "i2c", "spi", "ble", "serial"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Hardware :: Hardware Drivers",
+]
+dependencies = [
+    "pyserial>=3.5",
+]
+
+[project.optional-dependencies]
+ble = ["bleak>=0.21"]
+dev = ["hatch", "pytest"]
+
+[project.urls]
+Homepage = "https://github.com/drpoom/cobra"
+Repository = "https://github.com/drpoom/cobra"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cobra_bridge"]

cobra_bridge-0.1.0/src/cobra_bridge/__init__.py

@@ -0,0 +1,28 @@
+"""
+COBRA — COines BRidge Access for Python
+
+Transport-agnostic Bosch AppBoard protocol library.
+Supports USB-Serial (pyserial) and BLE (Bleak).
+
+Quick start:
+    from cobra_bridge.transport import SerialTransport
+    from cobra_bridge.sync import CobraBridge
+
+    transport = SerialTransport(port='/dev/ttyACM0')
+    bridge = CobraBridge(transport=transport)
+    bridge.connect()
+"""
+
+from cobra_bridge.constants import (
+    HEADER, TYPE_GET, TYPE_SET, STATUS_OK,
+    CMD_GET_BOARD_INFO, CMD_SET_VDD, CMD_SET_PIN, CMD_SET_VDDIO, CMD_INT_CONFIG,
+    CMD_I2C_WRITE, CMD_I2C_READ,
+    CMD_SPI_WRITE, CMD_SPI_READ,
+    I2C_SPEED_400K, I2C_SPEED_1M,
+    SPI_SPEED_5MHZ, SPI_SPEED_10MHZ, SPI_MODE_0, SPI_MODE_3,
+    BMM350_I2C_ADDR, BMM350_CHIP_ID, BMM350_DATA_LEN,
+    BMM350_REG, BMM350_PMU, BMM350_PMU_STATUS, BMM350_ODR, BMM350_AVG, BMM350_OTP_ADDR,
+    BMM350_LSB_TO_UT_XY, BMM350_LSB_TO_UT_Z, BMM350_LSB_TO_DEGC, BMM350_TEMP_OFFSET,
+)
+
+__version__ = '0.1.0'