mm integration + Checkliste

This commit is contained in:
fewikay committed 2026-11-05 21:03:23 +01:00
1 parent 8ca3ce7f6a
commit f736da7a1d
3 files changed
+150 -31

No files matched your search

+97
View File
@@ -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.
Binary file not shown.
@@ -13,6 +13,10 @@
int state = 0; int state = 0;
int mm_to_step(float mm){
return (int)(800 * mm);
}
static void* StepLibraryMalloc( unsigned int size ){ static void* StepLibraryMalloc( unsigned int size ){
return malloc(size); return malloc(size);
} }
@@ -94,7 +98,7 @@ int reset_stepper(L6474_Handle_t s){
L6474_BaseParameter_t b; L6474_BaseParameter_t b;
L6474_SetBaseParameter(&b); L6474_SetBaseParameter(&b);
b.stepMode = smMICRO4; b.stepMode = smMICRO16;
b.OcdTh = ocdth1125mA; b.OcdTh = ocdth1125mA;
L6474_EncodePhaseCurrentParameter(&b, 700.0f); L6474_EncodePhaseCurrentParameter(&b, 700.0f);
@@ -103,22 +107,25 @@ int reset_stepper(L6474_Handle_t s){
// reset all and take all initialization steps // reset all and take all initialization steps
result |= L6474_ResetStandBy(s); result |= L6474_ResetStandBy(s);
result |= L6474_Initialize(s, &b); 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){ int stepper_reference(L6474_Handle_t s, int flag){
L6474_SetPowerOutputs(s, 1);
//flag: 0 keiner, 1 -t, 2 -e, 3 -s //flag: 0 keiner, 1 -t, 2 -e, 3 -s
if(HAL_GPIO_ReadPin(REFERENCE_MARK_GPIO_Port, REFERENCE_MARK_Pin) == GPIO_PIN_RESET){ 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; int button_pressed = 0;
while(!button_pressed){ 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){ if(HAL_GPIO_ReadPin(REFERENCE_MARK_GPIO_Port, REFERENCE_MARK_Pin) == GPIO_PIN_RESET){
button_pressed=1; button_pressed=1;
} }
@@ -130,6 +137,11 @@ int stepper_reference(L6474_Handle_t s, int flag){
if(flag == 3){ if(flag == 3){
L6474_SetAbsolutePosition(s, 0); L6474_SetAbsolutePosition(s, 0);
L6474_Status_t status;
if(L6474_GetStatus(s, &status) != errcNONE){
return 1;
}
return 0; return 0;
} }
@@ -157,18 +169,17 @@ int stepper_pos(L6474_Handle_t s){
int position = 0; int position = 0;
L6474_GetAbsolutePosition(s, &position); L6474_GetAbsolutePosition(s, &position);
printf("Stepper position: %d", position); printf("Stepper position: %d", position);
return 0;
L6474_Status_t status;
if(L6474_GetStatus(s, &status) != errcNONE){
return 1;
} }
int stepper_status(L6474_Handle_t s){
L6474_Status_t status;
L6474_GetStatus(s, &status);
printf("Stepper status: ");
return 0; return 0;
} }
int stepper_move(L6474_Handle_t s, int pos){ int stepper_move(L6474_Handle_t s, int pos){
xTaskCreate(blink_yellow_led, "blink_yellow_led", 1024, NULL, 1, NULL);
int position = 0; int position = 0;
if(L6474_GetAbsolutePosition(s, &position) != errcNONE){ 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 // first decode the subcommand and all arguments
if ( argc == 0 ) if ( argc == 0 )
{ {
printf("invalid number of arguments\r\nFAIL"); printf("invalid number of arguments\r\n");
printf("FAIL\r\n");
return -1; return -1;
} }
else if ( strcmp(argv[0], "step") == 0 ) else if ( strcmp(argv[0], "step") == 0 )
{ {
if(state != 2){ if(state != 2){
printf("Please do reference\r\nFAIL"); printf("Please do reference\r\n");
printf("FAIL\r\n");
return -1; return -1;
} }
if ( argc < 2 ) if ( argc < 2 )
{ {
printf("missing step value for step command\r\nFAIL"); printf("missing step value for step commandFAIL\r\n");
return -1; return -1;
} }
@@ -228,74 +241,83 @@ int StepperConsoleFunction( int argc, char** argv, void* ctx )
{ {
if(reset_stepper(h)){ if(reset_stepper(h)){
state = 0; state = 0;
printf("\r\nFAIL"); printf("FAIL\r\n");
return -1; return -1;
} }
state = 1; state = 1;
printf("\r\nOK"); printf("OK\r\n");
return 0; return 0;
} }
else if ( strcmp(argv[0], "reference") == 0 ) else if ( strcmp(argv[0], "reference") == 0 )
{ {
if(state < 1){ if(state < 1){
printf("Please do reset\r\nFAIL"); printf("Please do reset\r\n");
printf("FAIL\r\n");
return -1; return -1;
} }
if(stepper_reference(h, 0)){ if(stepper_reference(h, 0)){
state = 0; state = 0;
printf("\r\nFAIL"); printf("FAIL\r\n");
return -1; return -1;
} }
state = 2; state = 2;
printf("\r\nOK"); printf("OK\r\n");
return 0; return 0;
} }
else if ( strcmp(argv[0], "position") == 0 ) else if ( strcmp(argv[0], "position") == 0 )
{ {
if(state != 2){ if(state != 2){
printf("Please do reference\r\nFAIL"); printf("Please do reference\r\n");
printf("FAIL\r\n");
return -1; return -1;
} }
if(stepper_pos(h)){ if(stepper_pos(h)){
state = 0; state = 0;
printf("\r\nFAIL"); printf("FAIL\r\n");
return -1; return -1;
} }
printf("\r\nOK"); printf("OK\r\n");
return 0; return 0;
} }
else if ( strcmp(argv[0], "move") == 0 ) else if ( strcmp(argv[0], "move") == 0 )
{ {
if(state != 2){ if(state != 2){
printf("Please do reference\r\nFAIL"); printf("Please do reference\r\n");
printf("FAIL\r\n");
return -1; return -1;
} }
if ( argc < 2 ) 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; return -1;
} }
if(atoi(argv[1]) < 0){ float target_mm = (float)atof(argv[1]);
printf("position value for move command cant be below 0\r\nFAIL");
if (target_mm < 0.0f || target_mm > 100.0f) {
printf("position out of range\r\n");
printf("FAIL\r\n");
return -1; return -1;
} }
if(stepper_move(h, atoi(argv[1]))==1){
if(stepper_move(h, mm_to_step(target_mm))==1){
state = 0; state = 0;
printf("\r\nFAIL"); printf("FAIL\r\n");
return -1; return -1;
} }
printf("\r\nOK"); printf("OK\r\n");
return 0; return 0;
} }
else else
{ {
printf("passed invalid sub command\r\nFAIL"); printf("passed invalid sub command\r\n");
printf("FAIL\r\n");
return -1; return -1;
} }