AdaptiveResamplingStream.h

Go to the documentation of this file.

#pragma once
 
#include "AudioTools/CoreAudio/AudioBasic/KalmanFilter.h"
#include "AudioTools/CoreAudio/AudioBasic/PIDController.h"
#include "AudioTools/CoreAudio/AudioStreams.h"
#include "AudioTools/CoreAudio/ResampleStream.h"
 
namespace audio_tools {
 
class AdaptiveResamplingStream : public AudioStream {
 public:
  AdaptiveResamplingStream() {
    addNotifyAudioChange(resample_stream);
  }
  AdaptiveResamplingStream(BaseBuffer<uint8_t>& buffer,
                           float stepRangePercent = 5.0f) {
    setBuffer(buffer);
    setStepRangePercent(stepRangePercent);
    addNotifyAudioChange(resample_stream);
  }
 
  void setBuffer(BaseBuffer<uint8_t>& buffer) {
    p_buffer = &buffer;
  }
 
  bool begin() {
    if (p_buffer == nullptr) return false;
    queue_stream.setBuffer(*p_buffer);
    queue_stream.begin();
    resample_stream.setAudioInfo(audioInfo());
    resample_stream.setStream(queue_stream);
    resample_stream.begin(audioInfo());
    float from_step = 1.0 - resample_range;
    float to_step = 1.0 + resample_range;
    return pid.begin(1.0, from_step, to_step, p, i, d);
  }
 
  size_t write(const uint8_t* data, size_t len) override {
    if (p_buffer == nullptr) return 0;
    size_t result = p_buffer->writeArray(data, len);
    recalculate();
    return result;
  }
 
  void end() {
    queue_stream.end();
    resample_stream.end();
    read_count = 0;
  }
 
  size_t readBytes(uint8_t* data, size_t len) override {
    if (p_buffer == nullptr) return 0;
 
    return resample_stream.readBytes(data, len);
  }
 
  float recalculate() {
    if (p_buffer == nullptr) return step_size;
 
    // calculate new resampling step size
    level_percent = p_buffer->levelPercent();
    kalman_filter.addMeasurement(level_percent);
    step_size = pid.calculate(50.0, kalman_filter.calculate());
 
    // log step size every 100th read
    if (read_count++ % 100 == 0) {
      LOGI("step_size: %f", step_size);
    }
 
    // return resampled result
    resample_stream.setStepSize(step_size);
    return step_size;
  }
 
  void setStepRangePercent(float rangePercent) {
    resample_range = rangePercent / 100.0;
  }
 
  float levelPercentActual() {
    if (p_buffer == nullptr) return 0.0f;
    return p_buffer->levelPercent();
  }
 
  float levelPercent() { return level_percent; }
 
  void setKalmanParameters(float process_noise, float measurement_noise) {
    kalman_filter.begin(process_noise, measurement_noise);
  }
 
  void setPIDParameters(float p_value, float i_value, float d_value) {
    p = p_value;
    i = i_value;
    d = d_value;
  }
 
protected:
  PIDController pid;                // PID controller for adaptive resampling step size (p=0.005, i=0.00005, d=0.0001)
  QueueStream<uint8_t> queue_stream; // Internal queue stream for buffering audio data
  BaseBuffer<uint8_t>* p_buffer = nullptr; // Pointer to the user-provided buffer
  ResampleStream resample_stream;   // Resample stream for adjusting playback rate
  KalmanFilter kalman_filter{0.01f, 0.1f}; // Kalman filter for smoothing buffer fill level
  float step_size = 1.0;            // Current resampling step size
  float resample_range = 0;         // Allowed resampling range (fraction)
  float p = 0.00001;                // PID proportional gain
  float i = 0.00000001;             // PID integral gain
  float d = 0.0;                    // PID derivative gain
  float level_percent = 0.0;        // Last calculated buffer fill level (percent)
  uint32_t read_count = 0;          // Read operation counter
};
 
}  // namespace audio_tools