2 Commits
7 changed files with 198 additions and 54 deletions
+5 -1
View File
@@ -4,8 +4,12 @@ __pycache__
*.csv *.csv
*.typ *.typ
*.pdf *.pdf
*.py
*.png
*.csv
scripts
# Vélarsértækar skrár sem PlatformIO býr til sjálft # Skrár sem PlatformIO býr til sjálft
.vscode/c_cpp_properties.json .vscode/c_cpp_properties.json
.vscode/launch.json .vscode/launch.json
compile_commands.json compile_commands.json
+12 -2
View File
@@ -9,10 +9,19 @@
class State; class State;
// Gildi úr einni keyrslu á hraðastýringunni, til útprentunar
struct ControlSample
{
double ref_rpm;
double actual_rpm;
double pwm_actual;
};
class MotorController class MotorController
{ {
private: private:
static constexpr double DEFAULT_REFERENCE_RPM = 40.0; static constexpr double DEFAULT_REFERENCE_RPM = 25.0;
static constexpr double PWM_PER_PERCENT = 255.0 / 100.0; static constexpr double PWM_PER_PERCENT = 255.0 / 100.0;
static const uint8_t LED_PIN = 5; // PB5 = D13 = LED_BUILTIN static const uint8_t LED_PIN = 5; // PB5 = D13 = LED_BUILTIN
@@ -60,7 +69,8 @@ public:
bool fault_active(); bool fault_active();
void run_speed_controller(); // Skilar true ef ný mæling var tekin og sample fyllt út
bool run_speed_controller(ControlSample& sample);
void stop_motor(); void stop_motor();
+8
View File
@@ -3,9 +3,17 @@
#include "state.h" #include "state.h"
#include <stdint.h>
class OperationalState : public State class OperationalState : public State
{ {
private:
static constexpr double SAMPLE_PERIOD_MS = 4.0;
// uint32_t svo teljarinn flæði ekki yfir eftir ~4 mín (eins og uint16_t)
uint32_t sample_count = 0;
public: public:
void enter() override; void enter() override;
+121 -36
View File
@@ -1,46 +1,113 @@
#!/usr/bin/env python3 #!/usr/bin/env python3
""" """
Teiknar step response-plott ur CSV-gognum sem Arduino-verkefnid prentar ut Teiknar step response-plott ur CSV-gognum sem Arduino-verkefnid prentar ut
(dalkar: time_ms, ref_rpm, actual_rpm, pwm_requested, pwm_actual). i Operational state (dalkar: time_ms, ref_rpm, actual_rpm, pwm_actual).
pwm_requested = Kp * error * 2.55, oklippt (getur farid langt yfir +-255) pwm_actual = stýrimerkid klippt vid +-255, þ.e. þad sem raunverulega
pwm_actual = sama gildi en klippt vid +-255, þ.e. þad sem raunverulega var sent a motor.set() / vélbúnaðinn
var sent a motor.set() / vélbúnaðinn
Hausinn er prentadur i hvert skipti sem farid er inn i Operational, svo ein
skra getur innihaldid nokkrar keyrslur. Adeins sidasta keyrslan er teiknud.
Skriptan metur lika sveiflutima (Tu) og utslag ef kerfid sveiflast, sem
nytist til ad finna Ku/Tu fyrir Ziegler-Nichols.
Notkun: Notkun:
python plot_step_response.py [inntak.csv] [uttak.png] [titill] python plot_step_response.py [inntak.csv] [uttak.png] [titill] [--no-pwm]
--no-pwm teiknar bara RPM (PWM-dalkurinn ma lika vanta i CSV-skranni)
Sjalfgefid: data/step_response.csv -> data/step_response.png Sjalfgefid: data/step_response.csv -> data/step_response.png
""" """
import sys import sys
import csv import csv
import statistics
import matplotlib.pyplot as plt import matplotlib.pyplot as plt
COLUMNS = ["time_ms", "ref_rpm", "actual_rpm", "pwm_actual"]
REQUIRED = ["time_ms", "ref_rpm", "actual_rpm"]
# Onnur nofn sem eldri utgafur firmware-sins hafa notad fyrir sama dalk
ALIASES = {"pwm": "pwm_actual"}
def empty_cols():
return {key: [] for key in COLUMNS}
def load_csv(path): def load_csv(path):
cols = {"time_ms": [], "ref_rpm": [], "actual_rpm": [], cols = empty_cols()
"pwm_requested": [], "pwm_actual": []} header = None
with open(path, newline="") as f: with open(path, newline="") as f:
reader = csv.DictReader(f) for row in csv.reader(f):
for row in reader: if row and row[0].strip() == "time_ms":
try: header = [name.strip() for name in row]
for key in cols: header = [ALIASES.get(name, name) for name in header]
cols[key].append(float(row[key])) missing = [key for key in REQUIRED if key not in header]
except (ValueError, KeyError): if missing:
# sleppir linum sem eru ekki gild data (t.d. rusl fyrir/eftir) sys.exit(f"Dalka vantar i haus {row}: {missing}")
for key in cols:
if len(cols[key]) > len(cols["time_ms"]):
cols[key].pop()
continue continue
if header is None:
# rusl a undan fyrsta haus (t.d. "State: Initialization")
continue
try:
values = {key: float(row[header.index(key)])
for key in COLUMNS if key in header}
except (ValueError, IndexError):
# sleppir linum sem eru ekki gild data (t.d. "State: ...")
continue
# Timinn byrjar aftur a 0 -> ny keyrsla, hendum theirri gomlu
if cols["time_ms"] and values["time_ms"] <= cols["time_ms"][-1]:
cols = empty_cols()
for key in values:
cols[key].append(values[key])
return cols return cols
def plot(cols, out_path, title_suffix=""): def estimate_oscillation(time_s, actual_rpm):
"""
Metur sveiflutima ut fra uppleid i gegnum medaltal seinni helmings
gagnanna (fyrri helmingur er transient). Hysteresis kemur i veg fyrir
ad sudid i rpm-maelingunni gefi falskar skurdpunkta.
Skilar (Tu [s], utslag [rpm]) eda None ef engin skyr sveifla.
"""
half = len(actual_rpm) // 2
t = time_s[half:]
y = actual_rpm[half:]
if len(y) < 20:
return None
mean = statistics.fmean(y)
band = 0.25 * statistics.pstdev(y)
if band == 0:
return None
crossings = []
below = y[0] < mean - band
for ti, yi in zip(t, y):
if below and yi > mean + band:
crossings.append(ti)
below = False
elif not below and yi < mean - band:
below = True
if len(crossings) < 3:
return None
periods = [b - a for a, b in zip(crossings, crossings[1:])]
amplitude = (max(y) - min(y)) / 2.0
return statistics.fmean(periods), amplitude
def plot(cols, out_path, title_suffix="", show_pwm=True):
time_s = [t / 1000.0 for t in cols["time_ms"]] time_s = [t / 1000.0 for t in cols["time_ms"]]
ref_rpm = cols["ref_rpm"] ref_rpm = cols["ref_rpm"]
actual_rpm = cols["actual_rpm"] actual_rpm = cols["actual_rpm"]
pwm_requested = cols["pwm_requested"]
pwm_actual = cols["pwm_actual"] pwm_actual = cols["pwm_actual"]
show_pwm = show_pwm and len(pwm_actual) == len(time_s)
fig, ax1 = plt.subplots(figsize=(10, 5)) fig, ax1 = plt.subplots(figsize=(10, 5))
@@ -52,14 +119,17 @@ def plot(cols, out_path, title_suffix=""):
ax1.set_ylabel("Angular velocity [RPM]") ax1.set_ylabel("Angular velocity [RPM]")
ax1.grid(True, alpha=0.3) ax1.grid(True, alpha=0.3)
ax2 = ax1.twinx() lines, labels = ax1.get_legend_handles_labels()
ax2.plot(time_s, pwm_requested, label="PWM requested (unclamped)", if show_pwm:
color="#d62728", linewidth=1.0, alpha=0.5, linestyle=":") ax2 = ax1.twinx()
ax2.plot(time_s, pwm_actual, label="PWM actual (clamped)", ax2.plot(time_s, pwm_actual, label="PWM actual (clamped)",
color="#d62728", linewidth=1.4) color="#d62728", linewidth=1.4)
ax2.axhline(255, color="#d62728", linewidth=0.6, alpha=0.3) ax2.axhline(255, color="#d62728", linewidth=0.6, alpha=0.3)
ax2.axhline(-255, color="#d62728", linewidth=0.6, alpha=0.3) ax2.axhline(-255, color="#d62728", linewidth=0.6, alpha=0.3)
ax2.set_ylabel("PWM [-255, 255]") ax2.set_ylabel("PWM [-255, 255]")
lines2, labels2 = ax2.get_legend_handles_labels()
lines += lines2
labels += labels2
# Merkjum stokkpunktinn (fyrsta stadin thar sem ref hoppar fra 0) # Merkjum stokkpunktinn (fyrsta stadin thar sem ref hoppar fra 0)
step_idx = next((i for i, r in enumerate(ref_rpm) if r > 0), None) step_idx = next((i for i, r in enumerate(ref_rpm) if r > 0), None)
@@ -69,12 +139,23 @@ def plot(cols, out_path, title_suffix=""):
ax1.text(time_s[step_idx], max(actual_rpm) * 1.02, " step", ax1.text(time_s[step_idx], max(actual_rpm) * 1.02, " step",
fontsize=9, va="bottom") fontsize=9, va="bottom")
lines1, labels1 = ax1.get_legend_handles_labels() osc = estimate_oscillation(time_s, actual_rpm)
lines2, labels2 = ax2.get_legend_handles_labels() # if osc is not None:
ax1.legend(lines1 + lines2, labels1 + labels2, loc="lower right", # tu, amplitude = osc
fontsize=8) # print(f"Sveifla: Tu = {tu * 1000:.1f} ms, utslag = +-{amplitude:.2f} RPM")
# ax1.text(0.99, 0.98, f"Tu ≈ {tu * 1000:.1f} ms\n"
# f"amplitude ≈ ±{amplitude:.2f} RPM",
# transform=ax1.transAxes, fontsize=9, va="top", ha="right",
# bbox=dict(facecolor="white", alpha=0.8, edgecolor="#cccccc"))
# else:
# print("Engin skyr sveifla fannst i seinni helmingi gagnanna")
title = "Double step response: RPM and PWM over time" ax1.legend(lines, labels, loc="lower right", fontsize=8)
if show_pwm:
title = "Step response: RPM and PWM over time"
else:
title = "Step response: RPM over time"
if title_suffix: if title_suffix:
title += f" ({title_suffix})" title += f" ({title_suffix})"
fig.suptitle(title) fig.suptitle(title)
@@ -84,8 +165,12 @@ def plot(cols, out_path, title_suffix=""):
if __name__ == "__main__": if __name__ == "__main__":
in_path = sys.argv[1] if len(sys.argv) > 1 else "data/twostep.csv" show_pwm = "--no-pwm" not in sys.argv
out_path = sys.argv[2] if len(sys.argv) > 2 else "data/twostep.png" args = [a for a in sys.argv[1:] if a != "--no-pwm"]
title_suffix = sys.argv[3] if len(sys.argv) > 3 else "" in_path = args[0] if len(args) > 0 else "data/step_response.csv"
out_path = args[1] if len(args) > 1 else "data/step_response.png"
title_suffix = args[2] if len(args) > 2 else ""
data = load_csv(in_path) data = load_csv(in_path)
plot(data, out_path, title_suffix) if not data["time_ms"]:
sys.exit(f"Engin gogn fundust i {in_path}")
plot(data, out_path, title_suffix, show_pwm)
+3 -3
View File
@@ -19,9 +19,9 @@ RotaryEncoderDriver encoder;
MotorDriver motor; MotorDriver motor;
const double Kp = 12.5; const double Kp = 10.125; // Ku * 0.45
const double Ti = 1.0; const double Ti = 0.0334; // Tu * 0.83 37
const double T = 0.004; const double T = 0.004; // 0.004
// P_controller controller(Kp); // P_controller controller(Kp);
PI_controller controller(Kp, Ti, T); PI_controller controller(Kp, Ti, T);
+30 -11
View File
@@ -92,20 +92,39 @@ void MotorController::to_operational()
} }
void MotorController::run_speed_controller() bool MotorController::run_speed_controller(ControlSample& sample)
{ {
if (encoder.new_speed_available()) if (!encoder.new_speed_available())
{ {
double actual = encoder.rpm(); return false;
double pwm_percent =
controller.update(reference_rpm, actual);
double pwm =
pwm_percent * PWM_PER_PERCENT;
motor.set(pwm);
} }
double actual = encoder.rpm();
double pwm_percent =
controller.update(reference_rpm, actual);
double pwm =
pwm_percent * PWM_PER_PERCENT;
// Klippt hér svo pwm_actual sé nákvæmlega það sem fer á mótorinn
if (pwm > 255.0)
{
pwm = 255.0;
}
if (pwm < -255.0)
{
pwm = -255.0;
}
motor.set(pwm);
sample.ref_rpm = reference_rpm;
sample.actual_rpm = actual;
sample.pwm_actual = pwm;
return true;
} }
+19 -1
View File
@@ -11,6 +11,11 @@ void OperationalState::enter()
context->reset_controller(); context->reset_controller();
context->led_on(); context->led_on();
// Tíminn byrjar á 0 í hvert skipti sem farið er inn í Operational
sample_count = 0;
Serial.println("time_ms,ref_rpm,actual_rpm");
} }
// Part 1 // Part 1
@@ -33,7 +38,20 @@ void OperationalState::update()
return; return;
} }
context->run_speed_controller(); ControlSample sample;
if (context->run_speed_controller(sample))
{
sample_count++;
Serial.print(sample_count * SAMPLE_PERIOD_MS, 1);
Serial.print(",");
Serial.print(sample.ref_rpm, 1);
Serial.print(",");
Serial.println(sample.actual_rpm, 2);
// Serial.print(",");
// Serial.println(sample.pwm_actual, 1);
}
} }