grovepi/Software/Python/grove_mini_motor_driver/README.md

Library written for Python 3!

Possible fault warnings:

• undervoltage lockout
• overcurrent event
• extended current limit event
• overtemperature condition
• unknown condition

Available commands for the Grove Mini Motor Driver:

• moveForward(speed) : speed = 0-100%
• moveBackwards(speed) : speed = 0-100%
• setLeftMotor(direction, speed) : direction = 'FORWARD'/'REVERSE'; speed = 0-100%
• setRightMotor(direction, speed) : direction = 'FORWARD'/'REVERSE'; speed = 0-100%
• stopLeftMotor() : fast braking the motor
• stopRightMotor(): fast braking the motor
• stopMotors() : fast braking the motors
• disableMotors() : when power-sleeping the device
• setDisplayFaults(choice = True) : enable/disable terminal output

Sample output on terminal when setDisplayFaults(True) is set:

> [04-Apr-2017 19:06:08.186616][forward][speed = 0%]
> [04-Apr-2017 19:06:08.188770][left motor warning][undervoltage lockout]
> [04-Apr-2017 19:06:08.190704][right motor warning][undervoltage lockout]
> [04-Apr-2017 19:06:08.241182][forward][speed = 1%]
> [04-Apr-2017 19:06:08.294815][forward][speed = 2%]
> [04-Apr-2017 19:06:08.348432][forward][speed = 3%]
> [04-Apr-2017 19:06:08.402033][forward][speed = 4%]
> [04-Apr-2017 19:06:08.455697][forward][speed = 5%]
> [04-Apr-2017 19:06:08.509291][forward][speed = 6%]
> [04-Apr-2017 19:06:08.562869][forward][speed = 7%]
> [04-Apr-2017 19:06:08.616490][forward][speed = 8%]
> [04-Apr-2017 19:06:08.670143][forward][speed = 9%]
> [04-Apr-2017 19:06:08.723765][forward][speed = 10%]
> [04-Apr-2017 19:06:08.777373][forward][speed = 11%]
> [04-Apr-2017 19:06:08.831013][forward][speed = 12%]
> [04-Apr-2017 19:06:08.884608][forward][speed = 13%]
> [04-Apr-2017 19:06:08.938222][forward][speed = 14%]
> [04-Apr-2017 19:06:08.991827][forward][speed = 15%]
> [04-Apr-2017 19:06:09.045500][forward][speed = 16%]
> [04-Apr-2017 19:06:09.099190][forward][speed = 17%]
> [04-Apr-2017 19:06:09.152877][forward][speed = 18%]
> [04-Apr-2017 19:06:09.206449][forward][speed = 19%]
> [04-Apr-2017 19:06:09.260065][forward][speed = 20%]
> [04-Apr-2017 19:06:09.313825][forward][speed = 21%]
> [04-Apr-2017 19:06:09.367477][forward][speed = 22%]
> [04-Apr-2017 19:06:09.421111][forward][speed = 23%]
> [04-Apr-2017 19:06:09.474758][forward][speed = 24%]
> [04-Apr-2017 19:06:09.528349][forward][speed = 25%]
> [04-Apr-2017 19:06:09.581962][forward][speed = 26%]
> [04-Apr-2017 19:06:09.635656][forward][speed = 27%]
> [04-Apr-2017 19:06:09.689268][forward][speed = 28%]
> [04-Apr-2017 19:06:09.742892][forward][speed = 29%]
> [04-Apr-2017 19:06:09.796492][forward][speed = 30%]
> [04-Apr-2017 19:06:09.850105][forward][speed = 31%]
> [04-Apr-2017 19:06:09.903736][forward][speed = 32%]
> [04-Apr-2017 19:06:09.957375][forward][speed = 33%]
> [04-Apr-2017 19:06:10.011014][forward][speed = 34%]
> [04-Apr-2017 19:06:10.064492][forward][speed = 35%]
> [04-Apr-2017 19:06:10.118010][forward][speed = 36%]
> [04-Apr-2017 19:06:10.171460][forward][speed = 37%]
> [04-Apr-2017 19:06:10.224905][forward][speed = 38%]
> [04-Apr-2017 19:06:10.278310][forward][speed = 39%]
> [04-Apr-2017 19:06:10.331732][forward][speed = 40%]
> [04-Apr-2017 19:06:10.385252][forward][speed = 41%]
> [04-Apr-2017 19:06:10.441249][forward][speed = 42%]
> [04-Apr-2017 19:06:10.497588][forward][speed = 43%]
> [04-Apr-2017 19:06:10.553675][forward][speed = 44%]
> [04-Apr-2017 19:06:10.610019][forward][speed = 45%]
> [04-Apr-2017 19:06:10.666197][forward][speed = 46%]
> [04-Apr-2017 19:06:10.722392][forward][speed = 47%]
> [04-Apr-2017 19:06:10.778276][forward][speed = 48%]
> [04-Apr-2017 19:06:10.834530][forward][speed = 49%]
> [04-Apr-2017 19:06:10.890216][forward][speed = 50%]
> [04-Apr-2017 19:06:10.946259][forward][speed = 51%]
> [04-Apr-2017 19:06:11.002603][forward][speed = 52%]
> [04-Apr-2017 19:06:11.059224][forward][speed = 53%]
> [04-Apr-2017 19:06:11.115792][forward][speed = 54%]
> [04-Apr-2017 19:06:11.172354][forward][speed = 55%]
> [04-Apr-2017 19:06:11.228827][forward][speed = 56%]
> [04-Apr-2017 19:06:11.285348][forward][speed = 57%]
> [04-Apr-2017 19:06:11.341821][forward][speed = 58%]
> [04-Apr-2017 19:06:11.398590][forward][speed = 59%]
> [04-Apr-2017 19:06:11.455153][forward][speed = 60%]
> [04-Apr-2017 19:06:11.511631][forward][speed = 61%]
> [04-Apr-2017 19:06:11.568084][forward][speed = 62%]
> [04-Apr-2017 19:06:11.624746][forward][speed = 63%]
> [04-Apr-2017 19:06:11.681274][forward][speed = 64%]
> [04-Apr-2017 19:06:11.737571][forward][speed = 65%]
> [04-Apr-2017 19:06:11.794203][forward][speed = 66%]
> [04-Apr-2017 19:06:11.851029][forward][speed = 67%]
> [04-Apr-2017 19:06:11.907599][forward][speed = 68%]
> [04-Apr-2017 19:06:11.964150][forward][speed = 69%]
> [04-Apr-2017 19:06:12.020842][forward][speed = 70%]
> [04-Apr-2017 19:06:12.077695][forward][speed = 71%]
> [04-Apr-2017 19:06:12.134426][forward][speed = 72%]
> [04-Apr-2017 19:06:12.190989][forward][speed = 73%]
> [04-Apr-2017 19:06:12.247715][forward][speed = 74%]
> [04-Apr-2017 19:06:12.304526][forward][speed = 75%]
> [04-Apr-2017 19:06:12.361030][forward][speed = 76%]
> [04-Apr-2017 19:06:12.417870][forward][speed = 77%]
> [04-Apr-2017 19:06:12.474538][forward][speed = 78%]
> [04-Apr-2017 19:06:12.531014][forward][speed = 79%]
> [04-Apr-2017 19:06:12.587561][forward][speed = 80%]
> [04-Apr-2017 19:06:12.644190][forward][speed = 81%]
> [04-Apr-2017 19:06:12.700734][forward][speed = 82%]
> [04-Apr-2017 19:06:12.757283][forward][speed = 83%]
> [04-Apr-2017 19:06:12.813796][forward][speed = 84%]
> [04-Apr-2017 19:06:12.870284][forward][speed = 85%]
> [04-Apr-2017 19:06:12.927131][forward][speed = 86%]
> [04-Apr-2017 19:06:12.983632][forward][speed = 87%]
> [04-Apr-2017 19:06:13.040205][forward][speed = 88%]
> [04-Apr-2017 19:06:13.096743][forward][speed = 89%]
> [04-Apr-2017 19:06:13.153287][forward][speed = 90%]
> [04-Apr-2017 19:06:13.209824][forward][speed = 91%]
> [04-Apr-2017 19:06:13.266372][forward][speed = 92%]
> [04-Apr-2017 19:06:13.322886][forward][speed = 93%]
> [04-Apr-2017 19:06:13.379352][forward][speed = 94%]
> [04-Apr-2017 19:06:13.435882][forward][speed = 95%]
> [04-Apr-2017 19:06:13.492451][forward][speed = 96%]
> [04-Apr-2017 19:06:13.548921][forward][speed = 97%]
> [04-Apr-2017 19:06:13.605467][forward][speed = 98%]
> [04-Apr-2017 19:06:13.662275][forward][speed = 99%]
> [04-Apr-2017 19:06:13.718809][forward][speed = 100%]
> [04-Apr-2017 19:06:15.777457][reverse][speed = 50%]
> [04-Apr-2017 19:06:17.786247][left motor][stop]
> [04-Apr-2017 19:06:17.789597][right motor][stop]
> [04-Apr-2017 19:06:18.793787][right motor][speed = 70%]
> [04-Apr-2017 19:06:23.802272][right motor][speed = 70%]
> [04-Apr-2017 19:06:28.810728][right motor][speed = 50%]
> [04-Apr-2017 19:06:28.814155][left motor][speed = 50%]
> [04-Apr-2017 19:06:29.818316][standby motors]