Merge pull request 'devel: Ready for pre-release' (#1) from devel into masterv0.1

Reviewed-on: https://code.bitgloo.com/clyne/stmdspgui/pulls/1

1 files changed, 30 insertions, 0 deletions

diff --git a/examples/5_fir_differentiator.cpp b/examples/5_fir_differentiator.cpp
new file mode 100644
index 0000000..1500dee
--- /dev/null
+++ b/examples/5_fir_differentiator.cpp
@@ -0,0 +1,30 @@
+/**
+ * 5_fir_differentiator.cpp
+ * Written by Clyne Sullivan.
+ *
+ * Does an FIR differentiation on the incoming signal, so that the output is representative of the
+ * rate of change of the input.
+ * A scaling factor is applied so that the output's form is more clearly visible.
+ */
+
+Sample* process_data(Samples samples)
+{
+    constexpr int scaling_factor = 4;
+    static Samples output;
+    static Sample prev = 2048;
+
+    // Compute the first output value using the saved sample.
+    output[0] = 2048 + ((samples[0] - prev) * scaling_factor);
+
+	for (unsigned int i = 1; i < SIZE; i++) {
+        // Take the rate of change and scale it.
+        // 2048 is added as the output should be centered in the voltage range.
+		output[i] = 2048 + ((samples[i] - samples[i - 1]) * scaling_factor);
+    }
+
+	// Save the last sample for the next iteration.
+    prev = samples[SIZE - 1];
+
+    return output;
+}
+