Metadata-Version: 2.1
Name: dynamixel-controller
Version: 0.8.1
Summary: A new tool for operating Dynamixel series motors!
Home-page: https://github.com/UGA-BSAIL/dynamixel-controller
Author: Hunter Halloran (Jyumpp)
Author-email: hdh20267@uga.edu
License: UNKNOWN
Download-URL: https://github.com/UGA-BSAIL/dynamixel-controller/archive/dynamixel_controller-0.8.1.tar.gz
Description: # dynamixel-controller
        
        dynamixel-controller is a Python library designed from the ground up to work with any Dynamixel motor on the market with few to no modifications.
        
        ## Installation
        
        Use the package manager [pip](https://pip.pypa.io/en/stable/) to install dynamixel-controller.
        
        ```bash
        pip install dynamixel-controller
        ```
        
        ## Usage
        #### Import:
        ```python
        from dynio import *
        ```
        
        #### Port handling:
        ```python
        dxl_io = dxl.DynamixelIO('portname') # your port for U2D2 or other serial device
        ```
        
        #### Pre-made motor declarations:
        See [documentation](https://github.com/UGA-BSAIL/dynamixel-controller/blob/moreJSON/docs.md) for full list of motors. 
        See below for sample:
        ```python
        ax_12 = dxl_io.new_ax12(1)       # AX-12 protocol 1 with ID 1
        mx_64_1 = dxl_io.new_mx64(2, 1)  # MX-64 protocol 1 with ID 2
        mx_64_2 = dxl_io.new_mx64(3, 2)  # MX-64 protocol 2 with ID 3
        ```
        
        #### Motor Control:
        See [documentation](https://github.com/UGA-BSAIL/dynamixel-controller/blob/moreJSON/docs.md) for full list of functions 
        and their usage.
        
        The most prevalent functions are pre-implemented as methods for the motor objects. 
        These include:
        ```python
        motor.torque_enable()
        motor.torque_disable()
        motor.set_acceleration(acceleration)
        motor.set_velocity_mode()
        motor.set_velocity(velocity)
        motor.set_position_mode()
        motor.set_position(position)
        motor.set_angle(angle) 
        motor.set_extended_position_mode()
        motor.set_position(position)
        position = motor.get_position()
        angle = motor.get_angle()
        current = motor.get_current()
        ```
        All other values can be easily read from or written to using their [control table](http://emanual.robotis.com/) name. Example:
        ```python
        motor.write_control_table("LED", 1) # Turns the LED on
        speed = motor.read_control_table("Present_Speed") # Returns present velocity
        ```
        
        ## Contributing
        Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
        
        Especially encouraged is new control tables to be published as part of the package.
        
        ## License
        [Apache 2.0](https://choosealicense.com/licenses/apache-2.0/)
Keywords: dynamixel,dxl,dynamixel_sdk,motor controller,robotis,motor,robot
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
