#include #include "pico/stdlib.h" #include "motor2040.hpp" #include "button.hpp" #include "pid.hpp" /* 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. Press "Boot" to exit the program. */ using namespace motor; using namespace encoder; // The pins of the motor being profiled const pin_pair MOTOR_PINS = motor2040::MOTOR_A; // The pins of the encoder attached to the profiled motor const pin_pair ENCODER_PINS = motor2040::ENCODER_A; // The gear ratio of the motor constexpr float GEAR_RATIO = 50.0f; // The counts per revolution of the motor's output shaft constexpr float COUNTS_PER_REV = MMME_CPR * GEAR_RATIO; // The direction to spin the motor in. NORMAL_DIR (0), REVERSED_DIR (1) const Direction DIRECTION = NORMAL_DIR; // The scaling to apply to the motor's speed to match its real-world speed constexpr float SPEED_SCALE = 5.4f; // How many times to update the motor per second const uint UPDATES = 100; constexpr float UPDATE_RATE = 1.0f / (float)UPDATES; // The time (in seconds) after a new setpoint, to display print out motor values constexpr float PRINT_WINDOW = 0.25f; // The time (in seconds) between each new setpoint being set constexpr float MOVEMENT_WINDOW = 2.0f; // How many of the updates should be printed (i.e. 2 would be every other update) const uint PRINT_DIVIDER = 1; // Multipliers for the different printed values, so they appear nicely on the Thonny plotter constexpr float ACC_PRINT_SCALE = 0.01f; // Acceleration multiplier // How far from zero to drive the motor at, in revolutions per second constexpr float VELOCITY_EXTENT = 3.0f; // PID values constexpr float VEL_KP = 30.0f; // Velocity proportional (P) gain constexpr float VEL_KI = 0.0f; // Velocity integral (I) gain constexpr float VEL_KD = 0.4f; // Velocity derivative (D) gain // Create a motor and set its direction and speed scale Motor m = Motor(MOTOR_PINS, DIRECTION, SPEED_SCALE); // Create an encoder and set its direction and counts per rev, using PIO 0 and State Machine 0 Encoder enc = Encoder(pio0, 0, ENCODER_PINS, PIN_UNUSED, DIRECTION, COUNTS_PER_REV, true); // Create the user button Button user_sw(motor2040::USER_SW); // Create PID object for velocity control PID vel_pid = PID(VEL_KP, VEL_KI, VEL_KD, UPDATE_RATE); int main() { stdio_init_all(); // Initialise the motor and encoder m.init(); enc.init(); // Enable the motor m.enable(); // Set the initial setpoint velocity vel_pid.setpoint = VELOCITY_EXTENT; uint update = 0; uint print_count = 0; // Continually move the motor until the user button is pressed while(!user_sw.raw()) { // Capture the state of the encoder Encoder::Capture capture = enc.capture(); // Calculate the acceleration to apply to the motor to move it closer to the velocity setpoint float accel = vel_pid.calculate(capture.revolutions_per_second()); // Accelerate or decelerate the motor m.speed(m.speed() + (accel * UPDATE_RATE)); // Print out the current motor values and their setpoints, // but only for the first few updates and only every multiple if(update < (uint)(PRINT_WINDOW * UPDATES) && print_count == 0) { printf("Vel = %f, ", capture.revolutions_per_second()); printf("Vel SP = %f, ", vel_pid.setpoint); printf("Accel = %f, ", accel * ACC_PRINT_SCALE); printf("Speed = %f\n", m.speed()); } // Increment the print count, and wrap it print_count = (print_count + 1) % PRINT_DIVIDER; update++; // Move along in time // Have we reached the end of this time window? if(update >= (uint)(MOVEMENT_WINDOW * UPDATES)) { update = 0; // Reset the counter // Set the new velocity setpoint to be the inverse of the current setpoint vel_pid.setpoint = 0.0f - vel_pid.setpoint; } sleep_ms(UPDATE_RATE * 1000.0f); } // Disable the motor m.disable(); }