Skip to main content

Official SDK for ZeroArm robotic arm (proprietary)

Project description

ZeroArm Python SDK

Official Python SDK for ForceEase ZeroArm robotic arms.

Connection Notes

  • Create RobotArm(arm_model="v4") or RobotArm(arm_model="v3") before connecting. The current controller requires the arm model during select_sn.
  • Use RobotArm(arm_model="v4").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.
  • Set slot="left" or slot="right" when selecting a side in dual-arm deployments. The SDK maps left to ZMQ 6666/6667 and right to 6676/6677.
  • Set mount="upright" or mount="side" to match the controller runtime profile.
  • 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. SDK mode selects per-slot ZMQ command/state ports, while bridge ports remain 8889 for left and 8899 for right.

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.
  • set_gripper_torque(target_tau, enable=True) sends the dedicated set_gripper_torque command for gripper torque mode. set_gripper(...) remains the position/PD_FF gripper command.

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.5.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

zeroarm_sdk-0.1.5-cp312-cp312-win_amd64.whl (140.7 kB view details)

Uploaded CPython 3.12Windows x86-64

zeroarm_sdk-0.1.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

zeroarm_sdk-0.1.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (1.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ ARM64

zeroarm_sdk-0.1.5-cp312-cp312-macosx_11_0_arm64.whl (165.2 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

zeroarm_sdk-0.1.5-cp312-cp312-macosx_10_13_x86_64.whl (172.0 kB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

zeroarm_sdk-0.1.5-cp312-cp312-macosx_10_13_universal2.whl (327.3 kB view details)

Uploaded CPython 3.12macOS 10.13+ universal2 (ARM64, x86-64)

zeroarm_sdk-0.1.5-cp311-cp311-win_amd64.whl (142.4 kB view details)

Uploaded CPython 3.11Windows x86-64

zeroarm_sdk-0.1.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

zeroarm_sdk-0.1.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (1.1 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ ARM64

zeroarm_sdk-0.1.5-cp311-cp311-macosx_11_0_arm64.whl (164.7 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

zeroarm_sdk-0.1.5-cp311-cp311-macosx_10_9_x86_64.whl (173.1 kB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

zeroarm_sdk-0.1.5-cp311-cp311-macosx_10_9_universal2.whl (327.8 kB view details)

Uploaded CPython 3.11macOS 10.9+ universal2 (ARM64, x86-64)

zeroarm_sdk-0.1.5-cp310-cp310-win_amd64.whl (142.4 kB view details)

Uploaded CPython 3.10Windows x86-64

zeroarm_sdk-0.1.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

zeroarm_sdk-0.1.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (1.1 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ ARM64

zeroarm_sdk-0.1.5-cp310-cp310-macosx_11_0_arm64.whl (166.8 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

zeroarm_sdk-0.1.5-cp310-cp310-macosx_10_9_x86_64.whl (175.5 kB view details)

Uploaded CPython 3.10macOS 10.9+ x86-64

zeroarm_sdk-0.1.5-cp310-cp310-macosx_10_9_universal2.whl (331.8 kB view details)

Uploaded CPython 3.10macOS 10.9+ universal2 (ARM64, x86-64)

zeroarm_sdk-0.1.5-cp39-cp39-win_amd64.whl (143.3 kB view details)

Uploaded CPython 3.9Windows x86-64

zeroarm_sdk-0.1.5-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

zeroarm_sdk-0.1.5-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (1.1 MB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ ARM64

zeroarm_sdk-0.1.5-cp39-cp39-macosx_11_0_arm64.whl (168.5 kB view details)

Uploaded CPython 3.9macOS 11.0+ ARM64

zeroarm_sdk-0.1.5-cp39-cp39-macosx_10_9_x86_64.whl (177.0 kB view details)

Uploaded CPython 3.9macOS 10.9+ x86-64

zeroarm_sdk-0.1.5-cp39-cp39-macosx_10_9_universal2.whl (334.6 kB view details)

Uploaded CPython 3.9macOS 10.9+ universal2 (ARM64, x86-64)

File details

Details for the file zeroarm_sdk-0.1.5-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 1383b040fa0cdcf5e05da22018c8ec5cb1213b738b2743107ae60b924326b71e
MD5 5d37b74f238bbd2afc9ca8a10817ad09
BLAKE2b-256 aa7f3e1c704ae21a16b9b5030ba5d03e039fcdf25a8906360be8ad02148f6134

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 d50b11d24006f0163b8ae980c9dc43c81ba4c90c5dec9a7ecd85cda7f9a73f20
MD5 227d6b66472172ada40af2a59e594fe3
BLAKE2b-256 4db7e794c994911439cf414d4c460e986e716f341193ccf5ebace42a7ffbd5d3

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Algorithm Hash digest
SHA256 f76f44adf7aa86cc74bc7065a4f74f5e476543e3e3acbe1eee0da3916ae2b183
MD5 055816ee7bece25654c523adcdd2ade3
BLAKE2b-256 285232884f821e3ea2cfb7c56d5e5f7d17779aaff872b683e81b5f1ee85835de

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 75dacf5100744423209a9bfa9e089db5b84b1a3108f35280e2353c67992390ae
MD5 0b915463ad439441e6e42158c8bd64b9
BLAKE2b-256 ebcc5aec36b6f05042e2d450c931a914cbe55b5de3ef7b49f3ff0e704bcd9b26

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 4161e0329cd8392df6e636d54cc41c600b2c0cc01abb35be64a585b360e5ab60
MD5 01995cdc59c887b18031c019aa3b523c
BLAKE2b-256 4ef6c102781f73cbf4d21b6f18c4b7646340207d34c9e60987228313a48a1e3a

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp312-cp312-macosx_10_13_universal2.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp312-cp312-macosx_10_13_universal2.whl
Algorithm Hash digest
SHA256 f4554b86c7b0575974910954f64cb31458f5db211534a25a73ceec283c0ab7b9
MD5 434d0f92d0f8102ded27418563a14307
BLAKE2b-256 1f7b053c3a7af620b5099a9490ff50e56758274a0bfeb154d77d43cbcde0bc44

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 23850f31ad058d36e535f33be0f8f5e38017639ade23fd4d89554d42d79124a0
MD5 18b642eb09363a4402575cff022f8cf2
BLAKE2b-256 1bc8f73a8f36e3c9b1ecad25414dc97dbc039080aa92acb43cae065611df317f

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 5c61e5a015c6f56cfe7184c4187001ce0baea0ed84a73dff56f9c5f684f99ef6
MD5 e0f05237e83f6e274b04620c4fd375ff
BLAKE2b-256 142229af8a682abbf22e7048b9f95d528e247229d2594cd777b6681e651e6a69

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Algorithm Hash digest
SHA256 613edde65efc8aedba8dbdfc88552fc8d17f3f279e16956329c4242b3d109b23
MD5 53b22ba32ec28873f07cff74ed5c47a5
BLAKE2b-256 a8bd86aaff4f0169aa8f5b1af24bc4f462f2228a9ef59e258f41988aaf34db7f

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8b6f353fed85908cf3cf2b84b176efd26edb5f3c92ea7610a0e2416037c7aa56
MD5 a4cbf35c55eb41775e58ffa056c950d0
BLAKE2b-256 a682c6d1e46f092bd2081fd317e172a696287b75c586e63a6b3bb733a805b205

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 f82441b7af3f5ca1d69d7370af8ab125c4efd122a5b4dc6e56a0bb2f64dcaedc
MD5 68aca7cb1ff1fdb4cc1d9e372627c58b
BLAKE2b-256 197e9923cf68825ee59970d7ee4a110bb6689bcc06b66eef88ca94474573ff04

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp311-cp311-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp311-cp311-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 2fece366e1bef8d7a9e6304cd479048387b82f7a4ad4046280efd6ffec552bb6
MD5 9227d70abaab5c8ffe8f39a56789959a
BLAKE2b-256 29a0f4d2a17056d8aed6150d5a9fc9fa4be3c2428d3500eda7b7735fe4b37c62

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 692cf2b214cb5ac8ed0631d8d89db1eb93dda51afc6c6b3a99bc0bd22d874003
MD5 fb801ce8ac5e5a467946c6c149b766c6
BLAKE2b-256 4e2411e9db234d4bb99ba49d896fe5550b449576bebde0580ec1685ef30b141d

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 c402954df359ffde95e534781839642dd9d478925df1d0b79812a28ffa6db03f
MD5 8fba5d74e9d2dc35a90377953cd18e1f
BLAKE2b-256 1927797c2e66bdf30746e05d84ccfb65e9f45a43b6bc33d02ceb1b910814d8c2

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Algorithm Hash digest
SHA256 f3adf56a10dbce3e66dda8aaab250a0dae6f80db34a453dd427c0614a73d1a81
MD5 48c6290788974e31400a2b6799735e72
BLAKE2b-256 dc9cbaef3d324f6d6c6e293f8cf430ace8afb8b9c69470436ba1f69909da6d15

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 104cc103b9f20cba602c1374616ef5c661e4ff6f439114916985f5035bd28ffb
MD5 94eb9366dce17b2a5bd8a0c36c3a2bd9
BLAKE2b-256 65570544e8528e26beb351daa45bd73666b596361336414dfea361feb2f42c51

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp310-cp310-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp310-cp310-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 66bb766eda4e1de753331e827f2bccac0603a5738a710ba0d49d0d1317baba88
MD5 aa9670f3849c79e5980e6fdff1bafdcc
BLAKE2b-256 8d78b35f4104918b7596b361ba1ad27831e0c83366e58df2520ec39db36c984e

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp310-cp310-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp310-cp310-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 433a49939b81c30ade4455e1e5ac45c98d88502f0e054d4bd59bb49a75e55697
MD5 af1ca0b1d3d77e5fda8de81a80f755ca
BLAKE2b-256 b0e13accf9bb49a5179180d851b8701c38935aa61c328d7f70a21e44f8bff277

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp39-cp39-win_amd64.whl.

File metadata

  • Download URL: zeroarm_sdk-0.1.5-cp39-cp39-win_amd64.whl
  • Upload date:
  • Size: 143.3 kB
  • Tags: CPython 3.9, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for zeroarm_sdk-0.1.5-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 55f4b9c1a0a2ac7d49b9a7ab26ffd99175195ea4c91e251e80aef26b7ad0197c
MD5 595eea49ba38b15b1e15592854ddd96e
BLAKE2b-256 e2fed26867cb8eb475e7443bde07d47aaef7ac85627dd4b8152ae422cde36670

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 2f139ef9a661d0ab04ecd767cbfc0421538a0d748b64cb1660acea62cc2545fc
MD5 746a2ad2fdd7c47f61e6ed930ffc0ff0
BLAKE2b-256 cb1127010d3cd7e8c601c3f04873bfab4f6af1531e4395845a52e3f6d12e9995

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Algorithm Hash digest
SHA256 17f580eff8e541b8d6d24118f6eb3d8aec2b18b602694ce66b57b9bb83bbb37d
MD5 9ede77e0d6c959ced63f0486a3767fab
BLAKE2b-256 8d817aa0baa633c06de7507fd763f0d82646be4d3cb1c1a597a24fd63ebfc91a

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1c6608fb246ad96452b76dd8e5ea2a861489db537ecb463815164d848a138145
MD5 31afbc012c3ed9aeee679a9e847b6056
BLAKE2b-256 888f22ec07b50d074f9db34f0c0f1b30158fcd04f14d6d2f6d22a3584e097e72

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp39-cp39-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp39-cp39-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 e37b914d9b43b71d654f15a9282f3ef92547df24e72fd7d6240d6f99a79957b9
MD5 6d52185c6750720514805f6cfb899357
BLAKE2b-256 64b7865f425faabb2b9daec9829b0fd1bdad7938378c7159803ff6f02d9da722

See more details on using hashes here.

File details

Details for the file zeroarm_sdk-0.1.5-cp39-cp39-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for zeroarm_sdk-0.1.5-cp39-cp39-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 8523ab312d470b479d6893f3de9b0ded122c42f52dc4dfce88bbef7d85157cdf
MD5 eb2ef73419df8e0090926d2073e2646b
BLAKE2b-256 c7d2f733459900a65270dc77bd8b31ddb77fb4fb3c9091e758e33ae9c412a7db

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page