iq-scm / rpimotorlib Goto Github PK

• Table of contents
• Overview
• Installation
• Files
• Dependencies
• Components
• Software matrix
• Notes and Issues

• Name: RpiMotorLib
• Title: Raspberry pi motor library.
• Description:

A python 3 library for various motor controllers and servos to connect to a raspberry pi. These components are some of the most widely used by community. There are three categories in library. Stepper motors, DC Motors and Servos. The end user can import this library into their projects and then control the components with short snippets of code. The library is modular so user can just import/use the section they need.

• Main Author: Gavin Lyons , website..
• Project URL: URL LINK
• History: CHANGELOG.md is at repository in documentation.
• Copyright: See LICENSE.md
• Pull requests,bug reports, suggestions for new components and features welcome.

The library was tested and built on a raspberry pi 3 model b, It was also tested for Python (3.5.3) and Raspbian stretch 9.

Rpimotorlib is in the PYPI Link The Python Package Index (PyPI) is a repository of software for the Python programming language.

Make sure that python3 and pip3 have been installed on your machine, then:

sudo pip3 install rpimotorlib

rpiMotorLib files are listed below:

A small script is installed to display version and help information. Run the information script by typing. RpiMotorScriptLib.py -[options]

1. RPi.GPIO 0.6.3 Rpi.GPIO pypi page

A module to control Raspberry Pi GPIO channels. This package provides a class to control the GPIO on a Raspberry Pi. This should already be installed on most Raspberry Pis.

2. pigpio 1.64-1 Homepage

This Dependency is Optional, it is currently only used in one of the two servo control options. pigpio is a library for the Raspberry which allows control of the General Purpose Input Outputs (GPIO).

Şeparate help files are in documentation folder to learn how to use library. Click on the relevant URL link in tables below. Test files used during development are in test folder of repo. There is a software matrix section below which shows which class is used for which controller, or consult the docstring of the appropriate python file.

1. Stepper motors

2. DC motors

3. Servos (two different options see Note 3 below)

Software matrix showing which classes are used to drive which components.

Note 1 Running two motors simultaneously

See github issue #11

If you want to control two steppers simultaneously, there are two basic setup file for using threading in test folder.

1. For Unipolar 28BYJ-48 MultiMotorThreading_BYJ.py
2. For Bipolar DRV8825 Stepper MultiMotorThreading_DRV8825.py

Note 2 Potential Issue with GPIO.cleanup() not working

See github issue #18 and #21

Some users are reporting that GPIO.cleanup() does not work. It does not switch off or "cleanup" GPIO as it should. This is external function from RPi.GPIO. It is mainly used in the test scripts. It is also called by the classes in DC motor if the cleanup method is passed argument "true". If you see this issue simply don't use GPIO.cleanup() or remove GPIO.cleanup and clear the GPIO you set manually or use python "del" method to destroy the relevant class object, to free resources if you need them again.

Note 3 Servo options

There are two different options for controlling the servo. When using Rpi_GPIO option you may notice twitching at certain delays and stepsizes. This is the result of the implementation of the RPIO PWM software timing. If the application requires precise control the user can pick the pigpio library which uses hardware based timing. The disadvantage being they must install a dependency.