urml-cobot-runtime 0.5.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- urml_cobot_runtime-0.5.0/.gitignore +114 -0
- urml_cobot_runtime-0.5.0/PKG-INFO +117 -0
- urml_cobot_runtime-0.5.0/README.md +71 -0
- urml_cobot_runtime-0.5.0/SPEC-GAPS.md +56 -0
- urml_cobot_runtime-0.5.0/pyproject.toml +109 -0
- urml_cobot_runtime-0.5.0/src/urml_cobot_runtime/__init__.py +45 -0
- urml_cobot_runtime-0.5.0/src/urml_cobot_runtime/_version.py +3 -0
- urml_cobot_runtime-0.5.0/src/urml_cobot_runtime/adapter.py +878 -0
- urml_cobot_runtime-0.5.0/src/urml_cobot_runtime/config.py +53 -0
- urml_cobot_runtime-0.5.0/src/urml_cobot_runtime/py.typed +0 -0
- urml_cobot_runtime-0.5.0/tests/__init__.py +0 -0
- urml_cobot_runtime-0.5.0/tests/integration/__init__.py +0 -0
- urml_cobot_runtime-0.5.0/tests/integration/test_cobot_adapter_live.py +50 -0
- urml_cobot_runtime-0.5.0/tests/test_cobot_adapters.py +469 -0
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# --- Python ---
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.py[cod]
|
|
4
|
+
*$py.class
|
|
5
|
+
*.so
|
|
6
|
+
.Python
|
|
7
|
+
build/
|
|
8
|
+
dist/
|
|
9
|
+
develop-eggs/
|
|
10
|
+
downloads/
|
|
11
|
+
eggs/
|
|
12
|
+
.eggs/
|
|
13
|
+
lib/
|
|
14
|
+
lib64/
|
|
15
|
+
parts/
|
|
16
|
+
sdist/
|
|
17
|
+
var/
|
|
18
|
+
wheels/
|
|
19
|
+
*.egg-info/
|
|
20
|
+
.installed.cfg
|
|
21
|
+
*.egg
|
|
22
|
+
MANIFEST
|
|
23
|
+
|
|
24
|
+
# Virtual envs
|
|
25
|
+
.venv/
|
|
26
|
+
venv/
|
|
27
|
+
env/
|
|
28
|
+
ENV/
|
|
29
|
+
.python-version
|
|
30
|
+
|
|
31
|
+
# Test / coverage / mypy / pyright
|
|
32
|
+
.coverage
|
|
33
|
+
.coverage.*
|
|
34
|
+
.cache
|
|
35
|
+
.pytest_cache/
|
|
36
|
+
.mypy_cache/
|
|
37
|
+
.dmypy.json
|
|
38
|
+
.pyre/
|
|
39
|
+
.pyright/
|
|
40
|
+
htmlcov/
|
|
41
|
+
nosetests.xml
|
|
42
|
+
coverage.xml
|
|
43
|
+
*.cover
|
|
44
|
+
.hypothesis/
|
|
45
|
+
.tox/
|
|
46
|
+
|
|
47
|
+
# --- Node / web tooling (kept out of core repo; here for safety) ---
|
|
48
|
+
node_modules/
|
|
49
|
+
.pnp.*
|
|
50
|
+
.yarn/cache/
|
|
51
|
+
.yarn/unplugged/
|
|
52
|
+
.yarn/build-state.yml
|
|
53
|
+
.yarn/install-state.gz
|
|
54
|
+
npm-debug.log*
|
|
55
|
+
yarn-debug.log*
|
|
56
|
+
yarn-error.log*
|
|
57
|
+
|
|
58
|
+
# --- C++ / Rust build artifacts (in case reference runtimes land here in early Phase 1) ---
|
|
59
|
+
target/
|
|
60
|
+
*.o
|
|
61
|
+
*.obj
|
|
62
|
+
*.a
|
|
63
|
+
*.lib
|
|
64
|
+
*.dll
|
|
65
|
+
*.dylib
|
|
66
|
+
*.exe
|
|
67
|
+
*.pdb
|
|
68
|
+
cmake-build-*/
|
|
69
|
+
CMakeCache.txt
|
|
70
|
+
CMakeFiles/
|
|
71
|
+
CMakeScripts/
|
|
72
|
+
Testing/
|
|
73
|
+
cmake_install.cmake
|
|
74
|
+
install_manifest.txt
|
|
75
|
+
compile_commands.json
|
|
76
|
+
|
|
77
|
+
# --- ROS 2 build dirs ---
|
|
78
|
+
build/
|
|
79
|
+
install/
|
|
80
|
+
log/
|
|
81
|
+
|
|
82
|
+
# --- Editor and OS junk ---
|
|
83
|
+
.vscode/
|
|
84
|
+
.idea/
|
|
85
|
+
*.swp
|
|
86
|
+
*.swo
|
|
87
|
+
*~
|
|
88
|
+
.DS_Store
|
|
89
|
+
Thumbs.db
|
|
90
|
+
desktop.ini
|
|
91
|
+
|
|
92
|
+
# --- Local-only artifacts ---
|
|
93
|
+
.env
|
|
94
|
+
.env.*
|
|
95
|
+
*.log
|
|
96
|
+
*.tmp
|
|
97
|
+
.local/
|
|
98
|
+
.scratch/
|
|
99
|
+
|
|
100
|
+
# --- Outreach campaign artifacts (operational, not part of the open standard) ---
|
|
101
|
+
# Target lists, message drafts, tracking data, and the launch-approval record
|
|
102
|
+
# stay local. They are private to the maintainer; committing them would
|
|
103
|
+
# telegraph the campaign before launch and could embarrass listed projects.
|
|
104
|
+
outreach/
|
|
105
|
+
|
|
106
|
+
# Outreach dashboard SQLite mirror (RFC-0275). Derived from
|
|
107
|
+
# examples/lighthouses/outreach*.yaml via tools/scripts/refresh_outreach_db.py.
|
|
108
|
+
# Regenerated on demand by `make outreach-refresh`.
|
|
109
|
+
tools/outreach.db
|
|
110
|
+
tools/.outreach.db
|
|
111
|
+
|
|
112
|
+
# Local Claude Code settings (per-machine; permission rules, etc.). Not committed.
|
|
113
|
+
.claude/settings.json
|
|
114
|
+
.claude/settings.local.json
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: urml-cobot-runtime
|
|
3
|
+
Version: 0.5.0
|
|
4
|
+
Summary: Collaborative-arm reference runtime for URML — UR (RTDE) + Franka (FCI), zero ROS.
|
|
5
|
+
Project-URL: Homepage, https://github.com/urml-dev/URML
|
|
6
|
+
Project-URL: Repository, https://github.com/urml-dev/URML
|
|
7
|
+
Project-URL: Issues, https://github.com/urml-dev/URML/issues
|
|
8
|
+
Author: URML Maintainers
|
|
9
|
+
License: BUSL-1.1
|
|
10
|
+
Keywords: cobot,fci,franka,robotics,rtde,runtime,universal-robots,urml
|
|
11
|
+
Classifier: Development Status :: 3 - Alpha
|
|
12
|
+
Classifier: Intended Audience :: Developers
|
|
13
|
+
Classifier: License :: Other/Proprietary License
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
18
|
+
Classifier: Topic :: Scientific/Engineering
|
|
19
|
+
Requires-Python: >=3.11
|
|
20
|
+
Requires-Dist: pydantic<3,>=2.6
|
|
21
|
+
Requires-Dist: pyyaml<7,>=6.0
|
|
22
|
+
Requires-Dist: urml-ros2-runtime>=0.5.0
|
|
23
|
+
Requires-Dist: urml-validator>=0.5.0
|
|
24
|
+
Provides-Extra: dev
|
|
25
|
+
Requires-Dist: mypy>=1.10; extra == 'dev'
|
|
26
|
+
Requires-Dist: pytest-cov>=5; extra == 'dev'
|
|
27
|
+
Requires-Dist: pytest>=8; extra == 'dev'
|
|
28
|
+
Requires-Dist: ruff>=0.5; extra == 'dev'
|
|
29
|
+
Provides-Extra: doosan
|
|
30
|
+
Requires-Dist: drfl>=2.7; extra == 'doosan'
|
|
31
|
+
Provides-Extra: franka
|
|
32
|
+
Requires-Dist: panda-python>=0.7; extra == 'franka'
|
|
33
|
+
Provides-Extra: kassow
|
|
34
|
+
Requires-Dist: kassow-py>=0.1; extra == 'kassow'
|
|
35
|
+
Provides-Extra: kinova
|
|
36
|
+
Requires-Dist: kortex-api>=2.6; extra == 'kinova'
|
|
37
|
+
Provides-Extra: mecademic
|
|
38
|
+
Requires-Dist: mecademicpy>=2.0; extra == 'mecademic'
|
|
39
|
+
Provides-Extra: neura
|
|
40
|
+
Requires-Dist: neurapy>=0.3; extra == 'neura'
|
|
41
|
+
Provides-Extra: techman
|
|
42
|
+
Requires-Dist: techmanpy>=0.7; extra == 'techman'
|
|
43
|
+
Provides-Extra: ur
|
|
44
|
+
Requires-Dist: ur-rtde<2,>=1.5; extra == 'ur'
|
|
45
|
+
Description-Content-Type: text/markdown
|
|
46
|
+
|
|
47
|
+
<p align="center">
|
|
48
|
+
<a href="https://urml.dev"><img src="https://urml.dev/favicon.svg" alt="URML" width="72" height="72"></a>
|
|
49
|
+
</p>
|
|
50
|
+
|
|
51
|
+
<p align="center">
|
|
52
|
+
A small, opinionated, human-readable language for describing robot intent.
|
|
53
|
+
</p>
|
|
54
|
+
|
|
55
|
+
<p align="center">
|
|
56
|
+
<a href="https://urml.dev"><b>urml.dev</b></a>
|
|
57
|
+
</p>
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
# urml-cobot-runtime
|
|
62
|
+
|
|
63
|
+
**Collaborative-arm reference runtime for URML** — `UrRtdeAdapter` (Universal Robots / RTDE) + `FrankaFciAdapter` (Franka / FCI via `panda-py`), **zero ROS**.
|
|
64
|
+
|
|
65
|
+
The two most-deployed cobots, driven by their **native SDKs with no ROS** — the proof that the popular real arms need no ROS. `industrial-arm-runtime`'s `Ur`/`FrankaAdapter` compose `RclpyAdapter` (ROS 2 + MoveIt 2); these are the ROS-free siblings, exactly as `marine-runtime` is the ROS-free sibling of `ros2-runtime`. Both mirror `BlueRovAdapter`: lazy vendor SDK, cached lazy connection, failures returned not raised. Built against the frozen Protocol per [RFC-0014](../../docs/rfcs/0014-substrate-conformance.md).
|
|
66
|
+
|
|
67
|
+
## Method coverage (both adapters)
|
|
68
|
+
|
|
69
|
+
| URML primitive | v0.1 |
|
|
70
|
+
|---|---|
|
|
71
|
+
| `move_to` / `hover` | drive the TCP to a configured pose (UR `moveL` / Franka joint move) |
|
|
72
|
+
| `grasp` / `release` | gripper command; scalar `force_n` honoured at v0.1 fidelity |
|
|
73
|
+
| `wait` | hold (success) |
|
|
74
|
+
| `measure` / `wait_for` | TCP force / robot state read |
|
|
75
|
+
| `report` | structured record to a local sink (no cloud) |
|
|
76
|
+
| `scan` | documented not-supported result: no area-scan controller (a scan is waypoints plus a capture at each one) |
|
|
77
|
+
|
|
78
|
+
`dock`, `detect`, `capture`, `speak`, `listen` return `not_supported_on_bare_cobot` (pair a station/vision/HMI companion). The drone trio returns `not_applicable_cobot`.
|
|
79
|
+
|
|
80
|
+
## Spec gaps (RFC-0014 protocol)
|
|
81
|
+
|
|
82
|
+
One genuinely inexpressible need filed as **RFC-0017 (Draft)** — raw digital-I/O tool actuation (not `grasp`, not a station service). Force/impedance beyond scalar `force_n` is a documented **watch-item** (no RFC); joint-space waypoints are absorbed by config (no gap). See [`SPEC-GAPS.md`](SPEC-GAPS.md).
|
|
83
|
+
|
|
84
|
+
## Install / use
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
pip install -e reference/cobot-runtime[ur] # Universal Robots (ur_rtde)
|
|
88
|
+
pip install -e reference/cobot-runtime[franka] # Franka (panda-python, Apache-2.0)
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
```python
|
|
92
|
+
from urml_cobot_runtime import UrRtdeAdapter, CobotConfig
|
|
93
|
+
from urml_cobot_runtime.adapter import Pose
|
|
94
|
+
cfg = CobotConfig(robot_ip="192.168.1.10",
|
|
95
|
+
location_to_pose={"pick": Pose(vector=[0.4, -0.3, 0.1, 0, 3.14, 0])})
|
|
96
|
+
with UrRtdeAdapter(cfg) as ur:
|
|
97
|
+
assert ur.send_navigation_goal(location="pick").success
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## Status
|
|
101
|
+
|
|
102
|
+
**v0.1 (this release):**
|
|
103
|
+
- `UrRtdeAdapter` + `FrankaFciAdapter` + `CobotConfig` (native SDKs, no ROS). `cobot_cell` US-provenance manifest + `conformance/fixtures/industrial/08_cobot_cell_positive.yaml` (RFC-0013 `pick_from`/`place_at`) verified through the runner (hermetic against `MockROSAdapter`; adapter-agnostic against the cobot adapters).
|
|
104
|
+
- Hermetic unit tests for both adapters: nav (configured + unmapped), grasp/release, measure, scan (not supported), lifecycle, the not-supported / not-applicable sentinels, the missing-`[ur]`/`[franka]`-extra errors, the conformance hook; no vendor SDK install required.
|
|
105
|
+
- Gated `.github/workflows/cobot-integration.yml`: `cobot-smoke` (real SDKs), `cobot-arm64-build` (Jetson-class QEMU), `cobot-controller-e2e` placeholder against a real UR/Franka (first run is a calibration run by design).
|
|
106
|
+
|
|
107
|
+
**Follow-ups (not yet):** RFC-0017 outcome (digital I/O); real Robotiq/Franka-gripper wiring beyond the v0.1 gripper command.
|
|
108
|
+
|
|
109
|
+
## Core Commitment
|
|
110
|
+
|
|
111
|
+
Business Source License 1.1: free for non-production use, commercial license for production (see [`LICENSING.md`](../../LICENSING.md)). No vendor coupling, no cloud dependency. `panda-py` is Apache-2.0; `ur_rtde` is an optional `[ur]` extra imported lazily, never at module load (the `rclpy`/`pymavlink` posture).
|
|
112
|
+
|
|
113
|
+
## Related documents
|
|
114
|
+
|
|
115
|
+
- [`/reference/marine-runtime/`](../marine-runtime/) — the zero-ROS sibling whose structure this mirrors.
|
|
116
|
+
- [`/reference/industrial-arm-runtime/`](../industrial-arm-runtime/) — the ROS 2 + MoveIt 2 Ur/Franka adapters this is the ROS-free sibling of.
|
|
117
|
+
- [`/docs/rfcs/0017-digital-io-actuation.md`](../../docs/rfcs/0017-digital-io-actuation.md) — the surfaced spec gap.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://urml.dev"><img src="https://urml.dev/favicon.svg" alt="URML" width="72" height="72"></a>
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<p align="center">
|
|
6
|
+
A small, opinionated, human-readable language for describing robot intent.
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<a href="https://urml.dev"><b>urml.dev</b></a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# urml-cobot-runtime
|
|
16
|
+
|
|
17
|
+
**Collaborative-arm reference runtime for URML** — `UrRtdeAdapter` (Universal Robots / RTDE) + `FrankaFciAdapter` (Franka / FCI via `panda-py`), **zero ROS**.
|
|
18
|
+
|
|
19
|
+
The two most-deployed cobots, driven by their **native SDKs with no ROS** — the proof that the popular real arms need no ROS. `industrial-arm-runtime`'s `Ur`/`FrankaAdapter` compose `RclpyAdapter` (ROS 2 + MoveIt 2); these are the ROS-free siblings, exactly as `marine-runtime` is the ROS-free sibling of `ros2-runtime`. Both mirror `BlueRovAdapter`: lazy vendor SDK, cached lazy connection, failures returned not raised. Built against the frozen Protocol per [RFC-0014](../../docs/rfcs/0014-substrate-conformance.md).
|
|
20
|
+
|
|
21
|
+
## Method coverage (both adapters)
|
|
22
|
+
|
|
23
|
+
| URML primitive | v0.1 |
|
|
24
|
+
|---|---|
|
|
25
|
+
| `move_to` / `hover` | drive the TCP to a configured pose (UR `moveL` / Franka joint move) |
|
|
26
|
+
| `grasp` / `release` | gripper command; scalar `force_n` honoured at v0.1 fidelity |
|
|
27
|
+
| `wait` | hold (success) |
|
|
28
|
+
| `measure` / `wait_for` | TCP force / robot state read |
|
|
29
|
+
| `report` | structured record to a local sink (no cloud) |
|
|
30
|
+
| `scan` | documented not-supported result: no area-scan controller (a scan is waypoints plus a capture at each one) |
|
|
31
|
+
|
|
32
|
+
`dock`, `detect`, `capture`, `speak`, `listen` return `not_supported_on_bare_cobot` (pair a station/vision/HMI companion). The drone trio returns `not_applicable_cobot`.
|
|
33
|
+
|
|
34
|
+
## Spec gaps (RFC-0014 protocol)
|
|
35
|
+
|
|
36
|
+
One genuinely inexpressible need filed as **RFC-0017 (Draft)** — raw digital-I/O tool actuation (not `grasp`, not a station service). Force/impedance beyond scalar `force_n` is a documented **watch-item** (no RFC); joint-space waypoints are absorbed by config (no gap). See [`SPEC-GAPS.md`](SPEC-GAPS.md).
|
|
37
|
+
|
|
38
|
+
## Install / use
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
pip install -e reference/cobot-runtime[ur] # Universal Robots (ur_rtde)
|
|
42
|
+
pip install -e reference/cobot-runtime[franka] # Franka (panda-python, Apache-2.0)
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
```python
|
|
46
|
+
from urml_cobot_runtime import UrRtdeAdapter, CobotConfig
|
|
47
|
+
from urml_cobot_runtime.adapter import Pose
|
|
48
|
+
cfg = CobotConfig(robot_ip="192.168.1.10",
|
|
49
|
+
location_to_pose={"pick": Pose(vector=[0.4, -0.3, 0.1, 0, 3.14, 0])})
|
|
50
|
+
with UrRtdeAdapter(cfg) as ur:
|
|
51
|
+
assert ur.send_navigation_goal(location="pick").success
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Status
|
|
55
|
+
|
|
56
|
+
**v0.1 (this release):**
|
|
57
|
+
- `UrRtdeAdapter` + `FrankaFciAdapter` + `CobotConfig` (native SDKs, no ROS). `cobot_cell` US-provenance manifest + `conformance/fixtures/industrial/08_cobot_cell_positive.yaml` (RFC-0013 `pick_from`/`place_at`) verified through the runner (hermetic against `MockROSAdapter`; adapter-agnostic against the cobot adapters).
|
|
58
|
+
- Hermetic unit tests for both adapters: nav (configured + unmapped), grasp/release, measure, scan (not supported), lifecycle, the not-supported / not-applicable sentinels, the missing-`[ur]`/`[franka]`-extra errors, the conformance hook; no vendor SDK install required.
|
|
59
|
+
- Gated `.github/workflows/cobot-integration.yml`: `cobot-smoke` (real SDKs), `cobot-arm64-build` (Jetson-class QEMU), `cobot-controller-e2e` placeholder against a real UR/Franka (first run is a calibration run by design).
|
|
60
|
+
|
|
61
|
+
**Follow-ups (not yet):** RFC-0017 outcome (digital I/O); real Robotiq/Franka-gripper wiring beyond the v0.1 gripper command.
|
|
62
|
+
|
|
63
|
+
## Core Commitment
|
|
64
|
+
|
|
65
|
+
Business Source License 1.1: free for non-production use, commercial license for production (see [`LICENSING.md`](../../LICENSING.md)). No vendor coupling, no cloud dependency. `panda-py` is Apache-2.0; `ur_rtde` is an optional `[ur]` extra imported lazily, never at module load (the `rclpy`/`pymavlink` posture).
|
|
66
|
+
|
|
67
|
+
## Related documents
|
|
68
|
+
|
|
69
|
+
- [`/reference/marine-runtime/`](../marine-runtime/) — the zero-ROS sibling whose structure this mirrors.
|
|
70
|
+
- [`/reference/industrial-arm-runtime/`](../industrial-arm-runtime/) — the ROS 2 + MoveIt 2 Ur/Franka adapters this is the ROS-free sibling of.
|
|
71
|
+
- [`/docs/rfcs/0017-digital-io-actuation.md`](../../docs/rfcs/0017-digital-io-actuation.md) — the surfaced spec gap.
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://urml.dev"><img src="https://urml.dev/favicon.svg" alt="URML" width="72" height="72"></a>
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<p align="center">
|
|
6
|
+
A small, opinionated, human-readable language for describing robot intent.
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<a href="https://urml.dev"><b>urml.dev</b></a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# SPEC-GAPS — urml-cobot-runtime
|
|
16
|
+
|
|
17
|
+
Per the spec-gap protocol (RFC-0014): built strictly against the
|
|
18
|
+
frozen substrate Protocol. Needs the cobots surfaced are recorded
|
|
19
|
+
here; only the genuinely inexpressible become RFC Drafts for
|
|
20
|
+
maintainer decision — never a silent primitive/schema change.
|
|
21
|
+
|
|
22
|
+
## Genuinely inexpressible → RFC Draft filed
|
|
23
|
+
|
|
24
|
+
- **RFC-0017 — digital-I/O actuation.** Cobots fire end-effectors and
|
|
25
|
+
signal PLCs by writing raw digital-output pins (UR `setStandardDigitalOut`,
|
|
26
|
+
Franka FCI I/O, **Doosan DRFL DO, Techman TMflow `set_digital_output`,
|
|
27
|
+
Kinova Kortex GPIO**). A raw DO write is not `grasp` (it may be a glue
|
|
28
|
+
gun, a blow-off, a conveyor handshake), not `report`, and not a station
|
|
29
|
+
service (so RFC-0013's `swap_tool`-rides-`send_docking_goal`
|
|
30
|
+
precedent does not apply). No existing primitive composes it. Filed
|
|
31
|
+
as RFC-0017 (Draft); until decided, the adapters do not expose raw
|
|
32
|
+
I/O and `grasp`/`release` remain the only effector verbs. Track B's
|
|
33
|
+
three new adapters (Doosan, Techman, Kinova) all surface the **same**
|
|
34
|
+
gap as UR/Franka — cross-referenced here; **no new RFC**.
|
|
35
|
+
|
|
36
|
+
## Composable / watch-item (no RFC)
|
|
37
|
+
|
|
38
|
+
- **Force/impedance (item C).** `send_manipulation_goal` already
|
|
39
|
+
carries scalar `force_n`, honoured at v0.1 fidelity (mirrors
|
|
40
|
+
RFC-0013's "advisory in v0.1" stance for `place_at.height`). A full
|
|
41
|
+
parametric stiffness/impedance matrix is finer than v0.1 needs;
|
|
42
|
+
recorded as a **watch-item** for the maintainer to weigh later, not
|
|
43
|
+
an RFC now.
|
|
44
|
+
- **Joint-space waypoints (item E).** Absorbed by config-side
|
|
45
|
+
`CobotConfig.location_to_pose` (the px4 `location_to_pose` pattern):
|
|
46
|
+
a named manifest location resolves to a 6/7-DoF vector in
|
|
47
|
+
`cobot_adapter.yaml`. No URML surface change — documented, not a gap.
|
|
48
|
+
|
|
49
|
+
## Note
|
|
50
|
+
|
|
51
|
+
This is a NEW package, deliberately not a change to
|
|
52
|
+
`industrial-arm-runtime` (whose `Ur/FrankaAdapter` compose
|
|
53
|
+
`RclpyAdapter`, i.e. ROS 2 + MoveIt 2). Touching those would break the
|
|
54
|
+
zero-ROS acid test and the "don't modify existing adapters/Protocol"
|
|
55
|
+
rule; the ROS-free siblings live here, exactly as `marine-runtime` is
|
|
56
|
+
the ROS-free sibling of `ros2-runtime`.
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["hatchling>=1.27"]
|
|
3
|
+
build-backend = "hatchling.build"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "urml-cobot-runtime"
|
|
7
|
+
version = "0.5.0"
|
|
8
|
+
description = "Collaborative-arm reference runtime for URML — UR (RTDE) + Franka (FCI), zero ROS."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
license = { text = "BUSL-1.1" }
|
|
11
|
+
requires-python = ">=3.11"
|
|
12
|
+
authors = [{ name = "URML Maintainers" }]
|
|
13
|
+
keywords = ["robotics", "cobot", "universal-robots", "franka", "rtde", "fci", "urml", "runtime"]
|
|
14
|
+
classifiers = [
|
|
15
|
+
"Development Status :: 3 - Alpha",
|
|
16
|
+
"Intended Audience :: Developers",
|
|
17
|
+
"License :: Other/Proprietary License",
|
|
18
|
+
"Operating System :: OS Independent",
|
|
19
|
+
"Programming Language :: Python :: 3 :: Only",
|
|
20
|
+
"Programming Language :: Python :: 3.11",
|
|
21
|
+
"Programming Language :: Python :: 3.12",
|
|
22
|
+
"Topic :: Scientific/Engineering",
|
|
23
|
+
]
|
|
24
|
+
dependencies = [
|
|
25
|
+
"pydantic>=2.6,<3",
|
|
26
|
+
"PyYAML>=6.0,<7",
|
|
27
|
+
"urml-validator>=0.5.0",
|
|
28
|
+
"urml-ros2-runtime>=0.5.0",
|
|
29
|
+
]
|
|
30
|
+
|
|
31
|
+
[project.optional-dependencies]
|
|
32
|
+
# The two most-deployed cobots, driven by their NATIVE SDKs with zero
|
|
33
|
+
# ROS — the proof that the popular real arms need no ROS. The existing
|
|
34
|
+
# industrial-arm-runtime's Ur/Franka adapters compose RclpyAdapter (ROS
|
|
35
|
+
# 2 + MoveIt 2); these are the ROS-free siblings, parallel to how
|
|
36
|
+
# marine-runtime is the ROS-free sibling of ros2-runtime. Both SDKs are
|
|
37
|
+
# imported lazily, so urml_cobot_runtime imports on every host.
|
|
38
|
+
ur = [
|
|
39
|
+
# Universal Robots RTDE (rtde_control / rtde_receive).
|
|
40
|
+
"ur_rtde>=1.5,<2",
|
|
41
|
+
]
|
|
42
|
+
franka = [
|
|
43
|
+
# Franka FCI via panda-py (Apache-2.0; preferred over GPL franky).
|
|
44
|
+
"panda-python>=0.7",
|
|
45
|
+
]
|
|
46
|
+
doosan = [
|
|
47
|
+
# Doosan DRFL native Python SDK (no ROS). KR allied origin.
|
|
48
|
+
"DRFL>=2.7",
|
|
49
|
+
]
|
|
50
|
+
techman = [
|
|
51
|
+
# Techman TMflow native Python client (Listen Node TCP). TW allied origin.
|
|
52
|
+
"techmanpy>=0.7",
|
|
53
|
+
]
|
|
54
|
+
kinova = [
|
|
55
|
+
# Kinova Kortex Python API (Apache-2.0). CA allied origin.
|
|
56
|
+
"kortex-api>=2.6",
|
|
57
|
+
]
|
|
58
|
+
mecademic = [
|
|
59
|
+
# Mecademic native Python SDK (Apache-2.0). CA allied origin.
|
|
60
|
+
"mecademicpy>=2.0",
|
|
61
|
+
]
|
|
62
|
+
neura = [
|
|
63
|
+
# Neura Robotics native Python SDK. DE allied origin.
|
|
64
|
+
"neurapy>=0.3",
|
|
65
|
+
]
|
|
66
|
+
kassow = [
|
|
67
|
+
# Kassow Robots community-maintained Python TCP client. DK allied origin.
|
|
68
|
+
# Best-effort substitution pin: deployment may swap to a different wheel
|
|
69
|
+
# (the adapter's hermetic tests fake the module in sys.modules).
|
|
70
|
+
"kassow-py>=0.1",
|
|
71
|
+
]
|
|
72
|
+
dev = [
|
|
73
|
+
"pytest>=8",
|
|
74
|
+
"pytest-cov>=5",
|
|
75
|
+
"ruff>=0.5",
|
|
76
|
+
"mypy>=1.10",
|
|
77
|
+
]
|
|
78
|
+
|
|
79
|
+
[project.urls]
|
|
80
|
+
Homepage = "https://github.com/urml-dev/URML"
|
|
81
|
+
Repository = "https://github.com/urml-dev/URML"
|
|
82
|
+
Issues = "https://github.com/urml-dev/URML/issues"
|
|
83
|
+
|
|
84
|
+
[tool.hatch.build.targets.wheel]
|
|
85
|
+
packages = ["src/urml_cobot_runtime"]
|
|
86
|
+
|
|
87
|
+
[tool.ruff]
|
|
88
|
+
line-length = 120
|
|
89
|
+
target-version = "py311"
|
|
90
|
+
src = ["src", "tests"]
|
|
91
|
+
|
|
92
|
+
[tool.ruff.lint]
|
|
93
|
+
select = ["E", "F", "W", "I", "B", "UP", "N", "ANN", "RUF"]
|
|
94
|
+
ignore = ["ANN401"]
|
|
95
|
+
|
|
96
|
+
[tool.ruff.lint.per-file-ignores]
|
|
97
|
+
"tests/*" = ["ANN"]
|
|
98
|
+
|
|
99
|
+
[tool.mypy]
|
|
100
|
+
strict = true
|
|
101
|
+
python_version = "3.11"
|
|
102
|
+
plugins = ["pydantic.mypy"]
|
|
103
|
+
mypy_path = "src"
|
|
104
|
+
packages = ["urml_cobot_runtime"]
|
|
105
|
+
|
|
106
|
+
[tool.pytest.ini_options]
|
|
107
|
+
minversion = "8.0"
|
|
108
|
+
testpaths = ["tests"]
|
|
109
|
+
addopts = ["-q", "--strict-markers"]
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
"""urml_cobot_runtime — collaborative-arm reference runtime for URML.
|
|
2
|
+
|
|
3
|
+
UrRtdeAdapter — Universal Robots via RTDE (rtde_control/receive)
|
|
4
|
+
FrankaFciAdapter — Franka via FCI (panda-py)
|
|
5
|
+
(+ CobotConfig, load_cobot_config)
|
|
6
|
+
|
|
7
|
+
The two most-deployed cobots driven by their native SDKs with **zero
|
|
8
|
+
ROS** — the proof that the popular real arms need no ROS. The
|
|
9
|
+
ROS-free siblings of industrial-arm-runtime's RclpyAdapter-composed
|
|
10
|
+
Ur/Franka adapters, parallel to how marine-runtime is the ROS-free
|
|
11
|
+
sibling of ros2-runtime. Vendor SDKs are imported lazily (the
|
|
12
|
+
[ur]/[franka] extras), so this module loads on every host. Built
|
|
13
|
+
against the frozen substrate Protocol per RFC-0014; spec gaps are in
|
|
14
|
+
SPEC-GAPS.md, not silently patched.
|
|
15
|
+
"""
|
|
16
|
+
|
|
17
|
+
from __future__ import annotations
|
|
18
|
+
|
|
19
|
+
from urml_cobot_runtime._version import __version__
|
|
20
|
+
from urml_cobot_runtime.adapter import (
|
|
21
|
+
CobotConfig,
|
|
22
|
+
DoosanDrflAdapter,
|
|
23
|
+
FrankaFciAdapter,
|
|
24
|
+
KassowKrAdapter,
|
|
25
|
+
KinovaKortexAdapter,
|
|
26
|
+
MecademicMeca500Adapter,
|
|
27
|
+
NeuraMairaAdapter,
|
|
28
|
+
TechmanTmflowAdapter,
|
|
29
|
+
UrRtdeAdapter,
|
|
30
|
+
load_cobot_config,
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
__all__ = [
|
|
34
|
+
"CobotConfig",
|
|
35
|
+
"DoosanDrflAdapter",
|
|
36
|
+
"FrankaFciAdapter",
|
|
37
|
+
"KassowKrAdapter",
|
|
38
|
+
"KinovaKortexAdapter",
|
|
39
|
+
"MecademicMeca500Adapter",
|
|
40
|
+
"NeuraMairaAdapter",
|
|
41
|
+
"TechmanTmflowAdapter",
|
|
42
|
+
"UrRtdeAdapter",
|
|
43
|
+
"__version__",
|
|
44
|
+
"load_cobot_config",
|
|
45
|
+
]
|