robonix.primitive.dobot.nova5.arm
primitive package
v0.1.0
Nova5 arm and PGI hardware commands and measured feedback.
Nova5 arm and PGI Primitive
One managed instance, nova5_arm, owns the Nova5 SDK connection and the PGI
serial port. Standard arm poses represent the 174 mm fingertip TCP in
base_link, using metres and xyzw unit quaternions. The SDK still commands
User 0 / Tool 0 flange MovL at 50 mm/s with cp=0.
Initialization validates local configuration without opening devices.
Activation opens the configured connections and reads status; it never enables
the arm, initializes the gripper, changes force/speed, or moves either device.
Commission and verify those settings separately. Motion requires the calibrated
installation's explicit motion.enabled=true, speed 50 and finite workspace.
Both actual and target flange/TCP endpoints are checked before dispatch.
These endpoint bounds are not a collision or swept-volume model.
Install Python 3.12, Robonix and the support repository, then build:
export NOVA5_SUPPORT_SOURCE=/absolute/path/to/nova5-support
rbnx build -p .
Set calibration_config to the absolute installation JSON path and serial_port
to the stable absolute PGI device path in deployment configuration. Set
enable_opening=true only when explicit opening steps are permitted. Keep the
default loopback bind/advertise settings. Deploy exactly one owner of these
devices. See CAPABILITY.md for semantics and failure handling.
The nova5-hardware wheel includes its custom TOML/IDL under
nova5_hardware.contracts. Consumers install this same version and run
python -m nova5_hardware.codegen /absolute/consumer/package (add --mcp when
needed). This invokes official rbnx codegen with installed resources and the
consumer's contracts; no source sibling directory is required. Generated stubs
are placed in the consumer's rbnx-build/codegen.
Maintainer: Rui Ye yerui@mails.neu.edu.cn. Package code is MulanPSL-2.0. The separately installed pinned Dobot SDK retains its own upstream provenance and license; it is not copied into this package.
Offline tests: run python -m unittest discover -s tests in an environment with
this package and nova5-support installed. Tests inject fake devices and never
open hardware.
CI runs the build script and offline tests on Linux with Python 3.12. Its build
baseline is Robonix commit e66e4abebd9c2cbb034015f5589592825d65f3df, with
robonix-api[codegen] installed. It installs nova5-support from the public
mikequ95/nova5-support repository at tag v0.1.0.