mm integration + Checkliste
This commit is contained in:
1 parent
8ca3ce7f6a
commit
f736da7a1d
3 files changed
+149
-30
No files matched your search
@@ -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;
|
||||||
|
}
|
||||||
|
|
||||||
|
int stepper_status(L6474_Handle_t s){
|
||||||
L6474_Status_t status;
|
L6474_Status_t status;
|
||||||
|
L6474_GetStatus(s, &status);
|
||||||
if(L6474_GetStatus(s, &status) != errcNONE){
|
printf("Stepper status: ");
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
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;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user