pimoroni-pico/micropython/examples/motor2040/README.md

Motor 2040 Micropython Examples

• Motor Examples
  • Single Motor
  • Multiple Motors
  • Motor Cluster
  • Motor Wave
  • Stop Motors
• Function Examples
  • Read Sensors
  • Read Encoders
  • Motor Profiler
  • LED Rainbow
  • Turn Off LEDs
• Control Examples
  • Position Control
  • Velocity Control
  • Position on Velocity Control
  • Reactive Encoder
  • Quad Position Wave
  • Quad Velocity Sequence
• Tuning Examples
  • Position Tuning
  • Velocity Tuning
  • Position on Velocity Tuning

Motor Examples

Single Motor

single_motor.py

Demonstrates how to create a Motor object and control it.

Multiple Motors

multiple_motors.py

Demonstrates how to create multiple Motor objects and control them together.

Motor Cluster

motor_cluster.py

Demonstrates how to create a MotorCluster object to control multiple motors at once.

Motor Wave

motor_wave.py

An example of applying a wave pattern to a group of motors and the LEDs.

Stop Motors

stop_motors.py

A simple program that stops the motors.

Function Examples

Read Sensors

read_sensors.py

Shows how to initialise and read the 2 external and 6 internal sensors of Motor 2040.

Read Encoders

read_encoders.py

Demonstrates how to read the angles of Motor 2040's four encoders.

Motor Profiler

motor_profiler.py

A program that profiles the speed of a motor across its PWM duty cycle range using the attached encoder for feedback.

LED Rainbow

led_rainbow.py

Displays a rotating rainbow pattern on the Motor 2040's onboard LED.

Turn Off LED

turn_off_led.py

A simple program that turns off the onboard LED.

Control Examples

Position Control

position_control.py

An example of how to move a motor smoothly between random positions, with the help of it's attached encoder and PID control.

Velocity Control

velocity_control.py

An example of how to drive a motor smoothly between random speeds, with the help of it's attached encoder and PID control.

Position on Velocity Control

position_on_velocity_control.py

An example of how to move a motor smoothly between random positions, with velocity limits, with the help of it's attached encoder and PID control.

Reactive Encoder

reactive_encoder.py

A demonstration of how a motor with an encoder can be used as a programmable rotary encoder for user input, with force-feedback for arbitrary detents and end stops.

Quad Position Wave

quad_position_wave.py

A demonstration of driving all four of Motor 2040's motor outputs between positions, with the help of their attached encoders and PID control.

Quad Velocity Sequence

quad_velocity_sequence.py

A demonstration of driving all four of Motor 2040's motor outputs through a sequence of velocities, with the help of their attached encoders and PID control.

Tuning Examples

Position Tuning

position_tuning.py

A program to aid in the discovery and tuning of motor PID values for position control. It does this by commanding the motor to move repeatedly between two setpoint angles and plots the measured response.

Velocity Tuning

velocity_tuning.py

A program to aid in the discovery and tuning of motor PID values for velocity control. It does this by commanding the motor to drive repeatedly between two setpoint speeds and plots the measured response.

Position on Velocity Tuning

position_on_velocity_tuning.py

A program to aid in the discovery and tuning of motor PID values for position on velocity control. It does this by commanding the motor to move repeatedly between two setpoint angles and plots the measured response.