{ "info": { "author": "Hong-ryul Jung", "author_email": "jung.hr.1206@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3" ], "description": "# Easy Dynamixel Helper\n\n![PyPI](https://img.shields.io/pypi/v/dynamixel-helper.svg)\n[![Downloads](https://pepy.tech/badge/dynamixel-helper)](https://pepy.tech/project/dynamixel-helper)\n![GitHub](https://img.shields.io/github/license/ryul1206/easy-dynamixel-helper.svg)\n![CodeFactor](https://www.codefactor.io/repository/github/ryul1206/easy-dynamixel-helper/badge/master)\n\n\ud83c\udf0f [English](https://github.com/ryul1206/easy-dynamixel-helper/blob/master/README.md),\n[\ud55c\uad6d\uc5b4](https://github.com/ryul1206/easy-dynamixel-helper/blob/master/README.kr.md)\n\nThis helper is a wrapper for the Dynamixel-SDK. With this, configure and drive your motor more quickly. You do not need to know how the SDK works.\n\n```bash\npip install dynamixel_helper --user\n```\n\n**Table of Contents**\n\n1. [ Features](#-Features)\n1. [ Simple Example](#-Simple-Example)\n1. [ Getting Started](#-Getting-Started)\n 1. [Prerequisites](#Prerequisites)\n 1. [Installation](#Installation)\n1. [ Tutorials](#-Tutorials)\n1. [ Release Notes](#-Release-Notes)\n1. [ Coverage](#-Coverage)\n 1. [Model List](#Model-List)\n 1. [Control Table](#Control-Table)\n1. [ Contributing](#-Contributing)\n 1. [Style Guide](#Style-Guide)\n1. [ Maintainers](#-Maintainers)\n1. [ Licenses](#-Licenses)\n\n## \ud83d\udc8e Features\n\n- Baud rate auto-matching\n- Protocol auto-matching\n- Port auto-matching (*Easy connections in multi-USB*)\n- Motor configurations in JSON format\n- Support for Python 3 and 2\n- Make your code simple and clean\n- **Easy to use even for beginners.**\n\n## \ud83d\udc23 Simple Example\n\nThe following code is an example of turning on the motor torque.\n\n```python\nfrom dynamixel_helper import DxlHelper\n\nhelper = DxlHelper(\"preset/{my_robot}.json\")\nmotor = helper.get_motor(0) # id: 0\nmotor.set_torque(True)\n```\n\n## \ud83d\ude80 Getting Started\n\n### Prerequisites\n\n1. **pip (package manager)**\n\n ```bash\n # Python 2\n sudo apt install python-pip\n python -m pip install -U pip\n # Python 3\n sudo apt install python3-pip\n python3 -m pip install -U pip\n ```\n\n2. **Dynamixel SDK**\n\n **CAUTION\ud83d\udca5**: Please install the `pip` **before** installing the `Dynamixel SDK`. Otherwise, when you install this `Dynamixel Helper`, you will get an dependency error of `Dynamixel SDK`.\n\n You need to install the official [Dynamixel SDK](https://github.com/ROBOTIS-GIT/DynamixelSDK) before using this helper.\n\n
Click here: Dynamixel SDK Installation\n

\n\n 1. Clone the official SDK repository into your custom folder, for example, I created `~/lib`.\n\n ```bash\n git clone https://github.com/ROBOTIS-GIT/DynamixelSDK.git\n ```\n\n 2. Go into the folder `/DynamixelSDK/python` of your cloned SDK.\n\n ```bash\n cd ${your_download_path}/DynamixelSDK/python\n ```\n\n 3. Run `setup.py` with `--user` option to install the library. Administrator privileges, a.k.a. `sudo`, are not recommended. More information [here](https://pages.charlesreid1.com/dont-sudo-pip/).\n\n ```bash\n python setup.py install --user\n ```\n\n

\n
\n\n### Installation\n\nSimply type `pip` command below to install this helper.\n\n```bash\npip install dynamixel_helper --user\n```\n\n## \ud83c\udf31 Tutorials\n\n[Go to tutorials](https://github.com/ryul1206/easy-dynamixel-helper/blob/master/tutorial/TUTORIAL.en.md)\n\n## \ud83d\udea9 Release Notes\n\n\n[Go to release notes](https://github.com/ryul1206/easy-dynamixel-helper/blob/master/CHANGELOG.md#Release-Notes)\n\n## \ud83d\udd2d Coverage\n\n**v1.0.0**\n\n### Model List\n\n- [XM430-W210](http://emanual.robotis.com/docs/en/dxl/x/xm430-w210/#control-table-of-eeprom-area)\n- [XL430-W250](http://emanual.robotis.com/docs/en/dxl/x/xl430-w250/#control-table-of-eeprom-area)\n\n### Control Table\n\nDifferent models have slightly different control tables. Please check the documentation for each model. Just click the model name above to go to the document.\n\n- EEPROM section\n - drive mode (w)\n - operating mode (w)\n- RAM section\n - torque (r/w)\n - goal velocity (w)\n - goal position (w)\n - present velocity (r)\n - present position (r)\n\n## \ud83d\udc8c Contributing\n\n- We will welcome whatever your contribution is!\n- If you are planning to send a new `Pull request`, please send them into the `develop` Branch.\ud83d\ude0d\n### Style Guide\n\n> This style guide is only a recommendation, never more important than your interest and contributions.\n\n- Our default Python style is [PEP 8](https://www.python.org/dev/peps/pep-0008/).\n- If you use [VSCode](https://code.visualstudio.com/) as your code editor, please refer to the following settings. This setting is a part of our `setting.json`.\n\n ```json\n {\n \"editor.tabSize\": 4,\n \"[json]\": {\n \"editor.tabSize\": 2\n },\n \"python.linting.pylintEnabled\": false,\n \"python.linting.pep8Enabled\": true,\n \"python.linting.enabled\": true\n }\n ```\n\n## \ud83d\udd27 Maintainers\n\n- **Hong-ryul Jung** _Initial work_ [ryul1206](https://github.com/ryul1206)\n- **Il-ho Oh** _Initial work_ [ohilho](https://github.com/ohilho)\n\n## \ud83d\udcdc Licenses\n\nThe contents of this repository are subject to the [MIT License](https://github.com/ryul1206/easy-dynamixel-helper/blob/master/LICENSE) by default, except as noted below.\n\n- Dynamixel SDK is under the [Apache-2.0](https://github.com/ROBOTIS-GIT/DynamixelSDK/blob/master/LICENSE)\n\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ryul1206/easy-dynamixel-helper", "keywords": "dynamixel", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "dynamixel-helper", "package_url": "https://pypi.org/project/dynamixel-helper/", "platform": "", "project_url": "https://pypi.org/project/dynamixel-helper/", "project_urls": { "Homepage": "https://github.com/ryul1206/easy-dynamixel-helper" }, "release_url": "https://pypi.org/project/dynamixel-helper/1.0.0/", "requires_dist": [ "dynamixel-sdk (>=3)" ], "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4", "summary": "You can use this helper instead of the Dynamixel-SDK to speed up your work.", "version": "1.0.0" }, "last_serial": 5643049, "releases": { "0.0.0": [ { "comment_text": "", "digests": { "md5": "21151165aad2152a7af41c4d2abd346a", "sha256": "dcf83f1376a8027b1c40710fda34bc9c4cc323466a19da20ce98cf313899e943" }, "downloads": -1, "filename": "dynamixel_helper-0.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "21151165aad2152a7af41c4d2abd346a", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4", "size": 8409, "upload_time": "2019-07-22T06:21:58", "url": "https://files.pythonhosted.org/packages/cb/4b/bda8b615f23e1d60caec0c02f302e88a2e5479c637bba1a68b4dfab2b7fc/dynamixel_helper-0.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "16f0dc61aaa34b7f9c5fa9bc0d63d7af", "sha256": "2975253a7c9af3d3225909c1cdb867a337dc6550595ffa76edb2a3037ed2224d" }, "downloads": -1, "filename": "dynamixel_helper-0.0.0.tar.gz", "has_sig": false, "md5_digest": "16f0dc61aaa34b7f9c5fa9bc0d63d7af", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4", "size": 6308, "upload_time": "2019-07-22T06:22:00", "url": "https://files.pythonhosted.org/packages/eb/49/e1bc299937d3d04ff18baf8795b31ae226eb22da3c141eb3bedf231bded7/dynamixel_helper-0.0.0.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "5d29d3f41d884aa619b8f3ecec122a96", "sha256": "41013961325380af657d2773c611e008ff87aab14a0e6ac6035fe2fa656ba3dc" }, "downloads": -1, "filename": "dynamixel_helper-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5d29d3f41d884aa619b8f3ecec122a96", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4", "size": 12843, "upload_time": "2019-08-07T04:25:25", "url": "https://files.pythonhosted.org/packages/d0/51/d5e7f9d6686b3b8b330710479b1b1deb5e23bc8cd8f6a4cef8867f7bc17b/dynamixel_helper-1.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e91b610a0a5948e480bfbc99a29dccc5", "sha256": "60b9a250f3cb0068fc284e925642bbdf46d6d26bf95c33ee7548b2f496df1b55" }, "downloads": -1, "filename": "dynamixel_helper-1.0.0.tar.gz", "has_sig": false, "md5_digest": "e91b610a0a5948e480bfbc99a29dccc5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4", "size": 9987, "upload_time": "2019-08-07T04:25:27", "url": "https://files.pythonhosted.org/packages/a7/90/c3ded061a93c2427bcda85acbdb34c3b55f2793f45fd681678375c5872cd/dynamixel_helper-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5d29d3f41d884aa619b8f3ecec122a96", "sha256": "41013961325380af657d2773c611e008ff87aab14a0e6ac6035fe2fa656ba3dc" }, "downloads": -1, "filename": "dynamixel_helper-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5d29d3f41d884aa619b8f3ecec122a96", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4", "size": 12843, "upload_time": "2019-08-07T04:25:25", "url": "https://files.pythonhosted.org/packages/d0/51/d5e7f9d6686b3b8b330710479b1b1deb5e23bc8cd8f6a4cef8867f7bc17b/dynamixel_helper-1.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e91b610a0a5948e480bfbc99a29dccc5", "sha256": "60b9a250f3cb0068fc284e925642bbdf46d6d26bf95c33ee7548b2f496df1b55" }, "downloads": -1, "filename": "dynamixel_helper-1.0.0.tar.gz", "has_sig": false, "md5_digest": "e91b610a0a5948e480bfbc99a29dccc5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, <4", "size": 9987, "upload_time": "2019-08-07T04:25:27", "url": "https://files.pythonhosted.org/packages/a7/90/c3ded061a93c2427bcda85acbdb34c3b55f2793f45fd681678375c5872cd/dynamixel_helper-1.0.0.tar.gz" } ] }