diff --git a/stm32-stepper-root/doc/Checkliste.md b/stm32-stepper-root/doc/Checkliste.md new file mode 100644 index 0000000..9c1745e --- /dev/null +++ b/stm32-stepper-root/doc/Checkliste.md @@ -0,0 +1,97 @@ +# Checkliste Spindel mit Linearführung + +Stand: 05.11.2026, Branch `Stepper`, inklusive uncommitteter Änderungen an `stepper.c`. + +Grundlage: Pflichtenheft, Interfacespezifikation und Anforderungen an den Laborbericht, abgeglichen mit dem Code. Kompiliert oder getestet wurde dabei nichts, „funktioniert“ stammt aus den Commit-Messages. + +Bewertung: Die MUSS-Kriterien bringen 50 % der Punkte (Note 4,0), für die 1,0 sind 100 von 130 Punkten nötig. Die Punktzahlen pro Feature stehen nicht im extrahierten PDF-Text, die Reihenfolge der Wunschkriterien ist daher eine Einschätzung. + +## Priorität 1: MUSS-Kriterien (Firmware) + +### Tests und Capability + +- [ ] **SpecTest-App besorgen:** Der `Test`-Ordner fehlt im Repo, und die MUSS-Features müssen diesen Test fehlerfrei bestehen. +- [ ] **Capability-Bits setzen:** Aktuell sind alle 0 (`main.c:143`). Nötig sind Bit 0 (Spindle), 1 (Spindle Status), 2 (Stepper), 7 (Referenzfahrt) und 11 (Reset). + +### Spindel (F10_01–03) + +- [ ] **Debug-Ausgaben entfernen:** Die `printf` in `spindel.c:22` und `:42` müssen raus. Der Spindel-Task kann sie beim Startup-Boost mitten in andere Befehlsausgaben schreiben. +- [ ] **Alle Fälle testen:** Negative RPM, Kappung bei Min/Max, Mehrfach-Start und -Stopp sowie `spindle status`. + +### Stepper `reset` (F20_01) + +- [ ] **Mehrfach testen:** `return result` ist neu und uncommittet, davor kam immer 0 zurück. Prüfen, ob wiederholtes `reset` weiterhin `OK` liefert, auch aus dem Fehlerzustand. + +### Stepper `reference` (F20_02) + +- [ ] **Endlosschleife beheben:** Die zweite Schleife ignoriert Fehler (`stepper.c:150-151`). Dann hängt die Konsole, und `stepper reset` ist nicht mehr möglich. +- [ ] **Rückgabewerte prüfen:** Das fehlt bei `SetPowerOutputs` (`stepper.c:117`) und beim Wegfahren um 5 mm (`stepper.c:121`). +- [ ] **Abbruch einbauen:** Es braucht ein internes Weg- oder Zeitlimit, falls der Sensor nie auslöst. Optional kann auch `LIMIT_SWITCH` abbrechen, er darf aber nicht zur Wegbestimmung dienen. +- [ ] **Bei Fehler Treiber abschalten:** Aktuell bleiben sie aktiv. + +### Stepper `move` (F20_03) + +- [ ] **Bug beheben:** `move` auf die aktuelle Position ergibt `FAIL` und `state = 0`, weil `L6474_StepIncremental` bei 0 Schritten einen Fehler liefert (`stepper.c:189-191`). Das muss direkt `OK` ergeben. +- [ ] **Eingabe prüfen:** `atof` macht aus `stepper move abc` die Position 0 mit `OK` (`stepper.c:301`). +- [ ] **Fahrbereich klären:** Die Grenzen 0–100 mm sind hartkodiert (`stepper.c:303`). Gegen den echten mechanischen Weg prüfen. +- [ ] **Fehlerbits auswerten:** Der Status wird gelesen, aber verworfen (`stepper.c:195-198`). OCD, TH_SD und UVLO prüfen und bei Fehlern in einen Fehlerzustand wechseln. Das deckt auch den geforderten Überlastschutz ab (Kap. 2.4). +- [ ] **Zustandsautomat umbauen:** Die Werte der Spezifikation nehmen: `scsINIT` 0x0, `scsREF` 0x1, `scsDIS` 0x2, `scsENA` 0x4, `scsFLT` 0x8. +- [ ] **Status-LEDs umsetzen:** Grün heißt fehlerfrei, Gelb blinkt mit 1 Hz bei aktiven Treibern, Rot heißt Fehler. Die Funktionen in `main.c` sind ungenutzt, und zwei davon sind Dauerschleifen. Besser ist ein einziger LED-Task, der `state` auswertet. + +### Aufräumen und Abschluss + +- [ ] **Nicht spezifizierte Befehle entfernen:** Das betrifft `fabi` (`main.c:317`) und `stepper step` (`stepper.c:222`). +- [ ] **Stand committen:** Die Änderungen an `stepper.c` sind nicht committet und `Stepper` ist nicht in `main` gemergt. +- [ ] **SpecTest komplett bestehen lassen.** Dabei auch die CM4-Firmware flashen, die laut Pflichtenheft ohnehin auf den zweiten Kern muss. + +## Priorität 2: Laborbericht (verbindlich) + +Im Repo gibt es dazu noch nichts. + +### Messungen (am besten erst mit der finalen Firmware) + +- [ ] SPI: SCK, MOSI, MISO, CS sowie ein L6474-Kommunikationsvorgang +- [ ] H-Brücken-PWM: Frequenz, Duty Cycle, Pegel +- [ ] DIR und PULSE: Richtungswechsel, Bezug zum Microstepping + +### Inhalt + +- [ ] Software-Architektur und Implementierungsansatz +- [ ] Stepper-Controller als Schwerpunkt, inklusive Abweichungen von der Spezifikation +- [ ] UML: Use-Case-Diagramm (Bring-Up bis Move) und Sequenzdiagramm +- [ ] Soll/Ist-Vergleich mit technischer Bewertung und Fazit + +### Formales + +- [ ] Mindestens 12 Seiten ohne Deckblatt und Literaturverzeichnis +- [ ] Abbildungen nummeriert und im Text referenziert +- [ ] Große Messreihen im Anhang, Quellen angegeben + +## Priorität 3: Wunschkriterien + +### Wenig Aufwand + +- [ ] `stepper position`: Ausgabe in mm als Float (`100.0000`), aktuell Text mit Schritten +- [ ] `stepper status`: Zustand, Fehlerbits und Pending-Flag ausgeben +- [ ] `reference -e`, `-s` und `-t`: Flags werden noch gar nicht geparst +- [ ] `stepper config powerena`: ändert die Bring-Up-Sequenz, also `scsDIS` einbauen +- [ ] `move -r` + +### Mehr Aufwand, aber lohnend + +- [ ] **Timer-Pulserzeugung, Master/Slave (F20_09):** Aktuell sind etwa 37,5 mm/min möglich, 100 mm dauern also rund 160 s. Gefordert sind bis zu 1400 mm/min. Das kann auch für SpecTest-Timeouts relevant sein, darum am besten zuerst. +- [ ] **`move -s`:** Baut auf den Timer auf. +- [ ] **Asynchroner LibL6474-Betrieb (F20_11):** Dazu gehören `move -a` und `stepper cancel`. +- [ ] **`stepper config` mit den übrigen Parametern:** Das gibt Einzelpunkte pro Parameter. +- [ ] **Testprotokoll:** Entsteht aus dem SpecTest-Lauf. + +### Zuletzt + +- [ ] Netzwerk über OpenAMP (LibETHProducer) +- [ ] Unit-Tests mit CMocka: mindestens 4 Tests, nur unter Windows nutzbar +- [ ] Digital Twin: auch nur unter Windows, und der `Simulation`-Ordner fehlt im Repo + +## Offene Fragen + +- [ ] **Welcher Motor wird genutzt?** Der Code nutzt 700 mA und 800 Schritte/mm (`stepper.c:103`, `stepper.c:17`). Beim kleinen Labormotor sind maximal 0,6 A erlaubt, die 700 mA wären also zu viel. Mit seinen 400 Schritten wären außerdem 1600 Schritte/mm richtig, sonst fährt er nur die halbe Strecke. Beim 200-Schritt-Motor der Baugruppe passen die 800 Schritte/mm. Am besten beide Werte als Konstanten anlegen. +- [ ] **Sind die LEDs MUSS oder Wunsch?** Das Pflichtenheft widerspricht sich: Kap. 1.1.4 nennt sie als Wunschkriterium, F20_03 (MUSS) schreibt sie vor. Hier sind sie als MUSS eingeordnet. Am besten bei Herrn Kimmel nachfragen. diff --git a/stm32-stepper-root/doc/Checkliste.pdf b/stm32-stepper-root/doc/Checkliste.pdf new file mode 100644 index 0000000..0a01273 Binary files /dev/null and b/stm32-stepper-root/doc/Checkliste.pdf differ diff --git a/stm32-stepper-root/stepper_h7/CM7/Core/Src/Stepper/stepper.c b/stm32-stepper-root/stepper_h7/CM7/Core/Src/Stepper/stepper.c index 4aa2e9c..0154e8a 100644 --- a/stm32-stepper-root/stepper_h7/CM7/Core/Src/Stepper/stepper.c +++ b/stm32-stepper-root/stepper_h7/CM7/Core/Src/Stepper/stepper.c @@ -13,6 +13,10 @@ int state = 0; +int mm_to_step(float mm){ + return (int)(800 * mm); +} + static void* StepLibraryMalloc( unsigned int size ){ return malloc(size); } @@ -94,7 +98,7 @@ int reset_stepper(L6474_Handle_t s){ L6474_BaseParameter_t b; L6474_SetBaseParameter(&b); - b.stepMode = smMICRO4; + b.stepMode = smMICRO16; b.OcdTh = ocdth1125mA; L6474_EncodePhaseCurrentParameter(&b, 700.0f); @@ -103,22 +107,25 @@ int reset_stepper(L6474_Handle_t s){ // reset all and take all initialization steps result |= L6474_ResetStandBy(s); result |= L6474_Initialize(s, &b); - result |= L6474_SetPowerOutputs(s, 1); + result |= L6474_SetPowerOutputs(s, 0); - return 0; + return result; } int stepper_reference(L6474_Handle_t s, int flag){ + L6474_SetPowerOutputs(s, 1); //flag: 0 keiner, 1 -t, 2 -e, 3 -s if(HAL_GPIO_ReadPin(REFERENCE_MARK_GPIO_Port, REFERENCE_MARK_Pin) == GPIO_PIN_RESET){ - L6474_StepIncremental(s, 1000); + L6474_StepIncremental(s, mm_to_step(5)); int button_pressed = 0; while(!button_pressed){ - L6474_StepIncremental(s, -1); + if(L6474_StepIncremental(s, -1) != errcNONE){ + return 1; + } if(HAL_GPIO_ReadPin(REFERENCE_MARK_GPIO_Port, REFERENCE_MARK_Pin) == GPIO_PIN_RESET){ button_pressed=1; } @@ -130,6 +137,11 @@ int stepper_reference(L6474_Handle_t s, int flag){ if(flag == 3){ L6474_SetAbsolutePosition(s, 0); + L6474_Status_t status; + if(L6474_GetStatus(s, &status) != errcNONE){ + return 1; + } + return 0; } @@ -157,18 +169,17 @@ int stepper_pos(L6474_Handle_t s){ int position = 0; L6474_GetAbsolutePosition(s, &position); printf("Stepper position: %d", position); + return 0; +} - +int stepper_status(L6474_Handle_t s){ L6474_Status_t status; - - if(L6474_GetStatus(s, &status) != errcNONE){ - return 1; - } + L6474_GetStatus(s, &status); + printf("Stepper status: "); return 0; } int stepper_move(L6474_Handle_t s, int pos){ - xTaskCreate(blink_yellow_led, "blink_yellow_led", 1024, NULL, 1, NULL); int position = 0; if(L6474_GetAbsolutePosition(s, &position) != errcNONE){ @@ -204,18 +215,20 @@ int StepperConsoleFunction( int argc, char** argv, void* ctx ) // first decode the subcommand and all arguments if ( argc == 0 ) { - printf("invalid number of arguments\r\nFAIL"); + printf("invalid number of arguments\r\n"); + printf("FAIL\r\n"); return -1; } else if ( strcmp(argv[0], "step") == 0 ) { if(state != 2){ - printf("Please do reference\r\nFAIL"); + printf("Please do reference\r\n"); + printf("FAIL\r\n"); return -1; } if ( argc < 2 ) { - printf("missing step value for step command\r\nFAIL"); + printf("missing step value for step commandFAIL\r\n"); return -1; } @@ -228,74 +241,83 @@ int StepperConsoleFunction( int argc, char** argv, void* ctx ) { if(reset_stepper(h)){ state = 0; - printf("\r\nFAIL"); + printf("FAIL\r\n"); return -1; } state = 1; - printf("\r\nOK"); + printf("OK\r\n"); return 0; } else if ( strcmp(argv[0], "reference") == 0 ) { if(state < 1){ - printf("Please do reset\r\nFAIL"); + printf("Please do reset\r\n"); + printf("FAIL\r\n"); return -1; } if(stepper_reference(h, 0)){ state = 0; - printf("\r\nFAIL"); + printf("FAIL\r\n"); return -1; } state = 2; - printf("\r\nOK"); + printf("OK\r\n"); return 0; } else if ( strcmp(argv[0], "position") == 0 ) { if(state != 2){ - printf("Please do reference\r\nFAIL"); + printf("Please do reference\r\n"); + printf("FAIL\r\n"); return -1; } if(stepper_pos(h)){ state = 0; - printf("\r\nFAIL"); + printf("FAIL\r\n"); return -1; } - printf("\r\nOK"); + printf("OK\r\n"); return 0; } else if ( strcmp(argv[0], "move") == 0 ) { if(state != 2){ - printf("Please do reference\r\nFAIL"); + printf("Please do reference\r\n"); + printf("FAIL\r\n"); return -1; } if ( argc < 2 ) { - printf("missing position value for move command\r\nFAIL"); + printf("missing position value for move command\r\n"); + printf("FAIL\r\n"); return -1; } - if(atoi(argv[1]) < 0){ - printf("position value for move command cant be below 0\r\nFAIL"); + float target_mm = (float)atof(argv[1]); + + if (target_mm < 0.0f || target_mm > 100.0f) { + printf("position out of range\r\n"); + printf("FAIL\r\n"); return -1; } - if(stepper_move(h, atoi(argv[1]))==1){ + + if(stepper_move(h, mm_to_step(target_mm))==1){ state = 0; - printf("\r\nFAIL"); + printf("FAIL\r\n"); return -1; } - printf("\r\nOK"); + printf("OK\r\n"); return 0; } else { - printf("passed invalid sub command\r\nFAIL"); + printf("passed invalid sub command\r\n"); + printf("FAIL\r\n"); return -1; }