pimoroni-pico/drivers/servo/servo_cluster.cpp

#include "servo_cluster.hpp"
#include "pwm.hpp"
#include <cstdio>

namespace servo {
  ServoCluster::ServoCluster(PIO pio, uint sm, uint pin_mask, CalibrationType default_type, float freq)
    : pwms(pio, sm, pin_mask), pwm_frequency(freq) {

    for(uint i = 0; i < NUM_BANK0_GPIOS; i++) {
      if(pimoroni::PWMCluster::bit_in_mask(i, pin_mask)) {
        servos[i] = new ServoState(default_type);
      }
    }
  }

  ServoCluster::ServoCluster(PIO pio, uint sm, uint pin_base, uint pin_count, CalibrationType default_type, float freq)
    : pwms(pio, sm, pin_base, pin_count), pwm_frequency(freq) {
    uint pin_mask = pwms.get_pin_mask();

    for(uint i = 0; i < NUM_BANK0_GPIOS; i++) {
      if(pimoroni::PWMCluster::bit_in_mask(i, pin_mask)) {
        servos[i] = new ServoState(default_type);
      }
    }
  }

  ServoCluster::ServoCluster(PIO pio, uint sm, std::initializer_list<uint8_t> pins, CalibrationType default_type, float freq)
    : pwms(pio, sm, pins), pwm_frequency(freq) {
    uint pin_mask = pwms.get_pin_mask();

    for(uint i = 0; i < NUM_BANK0_GPIOS; i++) {
      if(pimoroni::PWMCluster::bit_in_mask(i, pin_mask)) {
        servos[i] = new ServoState(default_type);
      }
    }
  }

  ServoCluster::~ServoCluster() {
    for(uint i = 0; i < NUM_BANK0_GPIOS; i++) {
      if(servos[i] != nullptr) {
        delete servos[i];
      }
    }
  }

  bool ServoCluster::init() {
    bool success = false;

    if(pwms.init()) {
      // Calculate a suitable pwm wrap period for this frequency
      uint32_t period; uint16_t div16;
      if(pimoroni::PWMCluster::calculate_pwm_factors(pwm_frequency, period, div16)) {
        pwm_period = period;

        // Update the pwm before setting the new wrap
        for(uint servo = 0; servo < NUM_BANK0_GPIOS; servo++) {
          pwms.set_chan_level(servo, 0, false);
        }

        // Set the new wrap (should be 1 less than the period to get full 0 to 100%)
        pwms.set_wrap(pwm_period); // NOTE Minus 1 not needed here. Maybe should change Wrap behaviour so it is needed, for consistency with hardware pwm?

        // Apply the new divider
        // This is done after loading new PWM values to avoid a lockup condition
        uint8_t div = div16 >> 4;
        uint8_t mod = div16 % 16;
        pwms.set_clkdiv_int_frac(div, mod);

        success = true;
      }
    }

    return success;
  }

  uint ServoCluster::get_pin_mask() const {
    return pwms.get_pin_mask();
  }

  bool ServoCluster::is_assigned(uint servo) const {
    return (servo < NUM_BANK0_GPIOS) && (servos[servo] != nullptr);
  }

  void ServoCluster::enable(uint servo, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->enable();
    apply_pulse(servo, new_pulse, load);
  }

  void ServoCluster::disable(uint servo, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->disable();
    apply_pulse(servo, new_pulse, load);
  }

  bool ServoCluster::is_enabled(uint servo) const {
    assert(is_assigned(servo));
    return servos[servo]->is_enabled();
  }

  float ServoCluster::get_value(uint servo) const {
    assert(is_assigned(servo));
    return servos[servo]->get_value();
  }

  void ServoCluster::set_value(uint servo, float value, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->set_value(value);
    apply_pulse(servo, new_pulse, load);
  }

  float ServoCluster::get_pulse(uint servo) const {
    assert(is_assigned(servo));
    return servos[servo]->get_pulse();
  }

  void ServoCluster::set_pulse(uint servo, float pulse, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->set_pulse(pulse);
    apply_pulse(servo, new_pulse, load);
  }

 float ServoCluster::get_frequency() const {
    return pwm_frequency;
  }

  bool ServoCluster::set_frequency(float freq) {
    bool success = false;

    if((freq >= ServoState::MIN_FREQUENCY) && (freq <= ServoState::MAX_FREQUENCY)) {
      // Calculate a suitable pwm wrap period for this frequency
      uint32_t period; uint16_t div16;
      if(pimoroni::PWMCluster::calculate_pwm_factors(freq, period, div16)) {

        pwm_period = period;
        pwm_frequency = freq;

        // Update the pwm before setting the new wrap
        for(uint servo = 0; servo < NUM_BANK0_GPIOS; servo++) {
          if(servos[servo] != nullptr) {
            float current_pulse = servos[servo]->get_pulse();
            apply_pulse(servo, current_pulse, false);
          }
        }

        // Set the new wrap (should be 1 less than the period to get full 0 to 100%)
        pwms.set_wrap(pwm_period, true);

        // Apply the new divider
        // This is done after loading new PWM values to avoid a lockup condition
        uint8_t div = div16 >> 4;
        uint8_t mod = div16 % 16;
        pwms.set_clkdiv_int_frac(div, mod);

        success = true;
      }
    }
    return success;
  }

  float ServoCluster::get_min_value(uint servo) const {
    assert(is_assigned(servo));
    return servos[servo]->get_min_value();
  }

  float ServoCluster::get_mid_value(uint servo) const {
    assert(is_assigned(servo));
    return servos[servo]->get_mid_value();
  }

  float ServoCluster::get_max_value(uint servo) const {
    assert(is_assigned(servo));
    return servos[servo]->get_max_value();
  }

  void ServoCluster::to_min(uint servo, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->to_min();
    apply_pulse(servo, new_pulse, load);
  }

  void ServoCluster::to_mid(uint servo, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->to_mid();
    apply_pulse(servo, new_pulse, load);
  }

  void ServoCluster::to_max(uint servo, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->to_max();
    apply_pulse(servo, new_pulse, load);
  }

  void ServoCluster::to_percent(uint servo, float in, float in_min, float in_max, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->to_percent(in, in_min, in_max);
    apply_pulse(servo, new_pulse, load);
  }

  void ServoCluster::to_percent(uint servo, float in, float in_min, float in_max, float value_min, float value_max, bool load) {
    assert(is_assigned(servo));
    float new_pulse = servos[servo]->to_percent(in, in_min, in_max, value_min, value_max);
    apply_pulse(servo, new_pulse, load);
  }

  Calibration* ServoCluster::calibration(uint servo) {
    assert(is_assigned(servo));
    return &servos[servo]->calibration();
  }

  const Calibration* ServoCluster::calibration(uint servo) const {
    assert(is_assigned(servo));
    return &servos[servo]->calibration();
  }

  void ServoCluster::apply_pulse(uint servo, float pulse, bool load) {
    pwms.set_chan_level(servo, ServoState::pulse_to_level(pulse, pwm_period, pwm_frequency), load);
  }
};