koebelt-link 1.0.0__tar.gz

koebelt_link-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Koebel
+
+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.

koebelt_link-1.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+# The tests read the shared vectors in protocol/, outside the package.
+prune tests

koebelt_link-1.0.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: koebelt-link
+Version: 1.0.0
+Summary: Connect drones, robots and test rigs to the koebelt/dash app.
+Author-email: Thomas Koebel <contact@koebelt.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/koebelt/koebelt_dash
+Project-URL: Source, https://github.com/koebelt/koebelt_dash/tree/main/libs/python
+Project-URL: Protocol, https://github.com/koebelt/koebelt_dash/blob/main/protocol/PROTOCOL.md
+Project-URL: Issues, https://github.com/koebelt/koebelt_dash/issues
+Keywords: robotics,drone,rover,telemetry,raspberry-pi,koebelt
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: System :: Hardware
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: serial
+Requires-Dist: pyserial>=3.5; extra == "serial"
+Provides-Extra: ble
+Requires-Dist: bless>=0.2.6; extra == "ble"
+Provides-Extra: camera
+Requires-Dist: opencv-python-headless>=4.5; extra == "camera"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pyyaml>=6; extra == "dev"
+Dynamic: license-file
+
+# koebelt-link (Python)
+
+Connect a Raspberry Pi, a Jetson or any computer-driven robot to koebelt/dash.
+
+```bash
+pip install koebelt-link                 # Wi-Fi (UDP) only, no dependencies
+pip install "koebelt-link[serial,ble]"   # USB serial and radios (pyserial), BLE peripheral (bless)
+pip install "koebelt-link[camera]"       # dev.camera(): live video through OpenCV
+```
+
+```python
+from koebelt_link import Device, Vec3
+
+dev = Device("Mule-2", kind="rover")
+dev.connect(wifi=True)                   # or ble=True, serial="/dev/ttyUSB0", radio=("/dev/ttyAMA0", "sik")
+dev.failsafe(timeout=1.8, action="hold")
+max_spd = dev.param("MAX_SPD", 4, min=0.5, max=8, unit="m/s")
+
+@dev.on_control
+def drive(c):
+    motors.set(speed=c.ry * max_spd.value, turn=c.lx)
+
+@dev.on_stop
+def stop():
+    motors.brake()
+
+while True:
+    dev.publish("imu", accel=Vec3(*imu.accel()), gyro=Vec3(*imu.gyro()))
+    dev.publish("lidar", points=lidar.scan())   # Nx3, metres
+    dev.tick(hz=50)
+```
+
+- Channels: `imu`, `att`, `pos`, `vel`, `gps`, `bat`, `rssi`, `joints`, `tool`,
+  `ft`, `thrust`, `rpm`, `temp`, `throttle`, `rocket`, `lidar`, `tracks`, and
+  custom channels via `dev.channel(...)`. Each built-in one also has a
+  shortcut named like the Arduino and Rust ones (`dev.position(x, y, z)`,
+  `dev.rocket_state(...)`…).
+- Links: `wifi`, `ble`, `serial`, `radio` (SiK, LoRa, HC-12, XBee or other:
+  rates follow the shared radio profile), and `fallback={"radio": (...)}` for
+  a second link that takes over telemetry when the first goes quiet.
+- Bluetooth serial modules: `module=("/dev/serial0", 9600)` for an HM-10 or
+  HC-05 on a UART; telemetry follows the baud rate.
+- Video: `dev.camera(0, label="Front")` streams a webcam or Pi camera, or
+  serve your own frames with `MjpegServer` and declare it with `dev.video(srv.url)`.
+- Callbacks: `on_control`, `on_mode`, `on_arm`, `on_stop`, `on_reset`, `on_jog`,
+  `on_cart`, `on_command`, `on_params_written`, `on_connect`.
+- Pairing: `dev.pair("XXX-XXX")` once. The key and saved parameters live in
+  `~/.config/koebelt-link/<id>.json` (override with `KOEBELT_LINK_HOME`).
+
+## Simulator
+
+`koebelt-link-sim --kind rover|drone [--pair CODE]` runs a simulated device on
+UDP 47800. It is a reference firmware loop and a way to test the app's real network path.
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e ".[dev]" && .venv/bin/python -m pytest
+```

koebelt_link-1.0.0/README.md

@@ -0,0 +1,57 @@
+# koebelt-link (Python)
+
+Connect a Raspberry Pi, a Jetson or any computer-driven robot to koebelt/dash.
+
+```bash
+pip install koebelt-link                 # Wi-Fi (UDP) only, no dependencies
+pip install "koebelt-link[serial,ble]"   # USB serial and radios (pyserial), BLE peripheral (bless)
+pip install "koebelt-link[camera]"       # dev.camera(): live video through OpenCV
+```
+
+```python
+from koebelt_link import Device, Vec3
+
+dev = Device("Mule-2", kind="rover")
+dev.connect(wifi=True)                   # or ble=True, serial="/dev/ttyUSB0", radio=("/dev/ttyAMA0", "sik")
+dev.failsafe(timeout=1.8, action="hold")
+max_spd = dev.param("MAX_SPD", 4, min=0.5, max=8, unit="m/s")
+
+@dev.on_control
+def drive(c):
+    motors.set(speed=c.ry * max_spd.value, turn=c.lx)
+
+@dev.on_stop
+def stop():
+    motors.brake()
+
+while True:
+    dev.publish("imu", accel=Vec3(*imu.accel()), gyro=Vec3(*imu.gyro()))
+    dev.publish("lidar", points=lidar.scan())   # Nx3, metres
+    dev.tick(hz=50)
+```
+
+- Channels: `imu`, `att`, `pos`, `vel`, `gps`, `bat`, `rssi`, `joints`, `tool`,
+  `ft`, `thrust`, `rpm`, `temp`, `throttle`, `rocket`, `lidar`, `tracks`, and
+  custom channels via `dev.channel(...)`. Each built-in one also has a
+  shortcut named like the Arduino and Rust ones (`dev.position(x, y, z)`,
+  `dev.rocket_state(...)`…).
+- Links: `wifi`, `ble`, `serial`, `radio` (SiK, LoRa, HC-12, XBee or other:
+  rates follow the shared radio profile), and `fallback={"radio": (...)}` for
+  a second link that takes over telemetry when the first goes quiet.
+- Bluetooth serial modules: `module=("/dev/serial0", 9600)` for an HM-10 or
+  HC-05 on a UART; telemetry follows the baud rate.
+- Video: `dev.camera(0, label="Front")` streams a webcam or Pi camera, or
+  serve your own frames with `MjpegServer` and declare it with `dev.video(srv.url)`.
+- Callbacks: `on_control`, `on_mode`, `on_arm`, `on_stop`, `on_reset`, `on_jog`,
+  `on_cart`, `on_command`, `on_params_written`, `on_connect`.
+- Pairing: `dev.pair("XXX-XXX")` once. The key and saved parameters live in
+  `~/.config/koebelt-link/<id>.json` (override with `KOEBELT_LINK_HOME`).
+
+## Simulator
+
+`koebelt-link-sim --kind rover|drone [--pair CODE]` runs a simulated device on
+UDP 47800. It is a reference firmware loop and a way to test the app's real network path.
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e ".[dev]" && .venv/bin/python -m pytest
+```

koebelt_link-1.0.0/koebelt_link/__init__.py

@@ -0,0 +1,12 @@
+"""koebelt/link: connect drones, robots and test rigs to the koebelt/dash app."""
+
+__version__ = "1.0.0"
+
+from .device import Channel, Control, Device, Param, Vec3  # noqa: E402
+from .protocol import RADIO_PROFILES, decode, decode_points, encode, encode_points  # noqa: E402
+from .transports import LineTransport, RadioTransport, SerialTransport, SocketTransport, Transport, UdpTransport  # noqa: E402
+from .video import MjpegServer  # noqa: E402
+
+__all__ = ["Device", "Vec3", "Control", "Param", "Channel", "Transport", "UdpTransport", "SerialTransport", "RadioTransport",
+           "LineTransport", "SocketTransport", "MjpegServer", "RADIO_PROFILES", "encode", "decode", "encode_points", "decode_points",
+           "__version__"]