zeroArm-sdk 0.1.3

Official SDK for ZeroArm robotic arm (proprietary)

ZeroArm Python SDK

Official Python SDK for ForceEase ZeroArm robotic arms.

Connection Notes

• Use RobotArm().auto_discover_and_connect() for the default LAN workflow.
• Use connect_with_short_sn() with at least the first 8 serial-number characters in multi-arm environments.
• mDNS discovery only accepts connectable IPv4 addresses and ignores loopback or unspecified addresses such as 127.0.0.1 and 0.0.0.0.
• The controller advertises WebSocket control port 8888 and bridge port 8889; SDK mode uses the fixed ZMQ command/state ports 6666/6667.

Current Protocol Coverage

• set_tf(..., plan_mode=0) uses joint-space planning; plan_mode=1 uses Cartesian planning.
• enable_hold_current() asks the controller to hold all configured joints at their current feedback positions.
• set_joints_batch() sends a single raw_msg command through the normal commands_<serial> topic.

Build Notes

• pyproject.toml declares Cython as a build-system dependency for isolated builds.
• For direct setup.py builds, install requirements-build.txt first.
• setuptools is capped below 80 to stay compatible with ROS colcon-core in the shared development environment.

Release

• Publish Python SDK releases through .github/workflows/build-wheels.yml.
• A GitHub Release with action published builds Linux, Windows, and macOS wheels, audits that no source distribution or C/Cython source files are present, then uploads only wheel distributions to PyPI.
• The workflow expects PYPI_API_TOKEN to be configured as a GitHub Actions secret.

Version

Current SDK source version: 0.1.3.