STM32CubeF4 Rant

[Dergute W. (derguteweka)]

Moin,

Muss hier mal meinem Entsetzen Luft machen.
Hab' mir grad dieses Zeugs hier:
https://github.com/STMicroelectronics/STM32CubeF4
gecloned und fang' an mich da durchzuwurschteln.

Da muss ich mich aber doch mal fragen - was sind das fuer Leute, die so 
Software schreiben und in dieser Form abliefern?

Haben die schon mal was davon gehoert, dass man "trailing whitespaces" 
auch weglassen kann? Oder sind da satanische Botschaften per 
whitespace-steganographie drinnen versteckt, wenn man den code 
rueckwaerts liest?
Das ist doch so nervig, wie wenn du im Grossraumbuero einen Kollegen 
hast, der sich andauernd raeuspern muss.

Was soll diese bescheuerte Pseudo-doxygen-dokumentation ueber den 
Funktionen?
Und auch die Kommentare in den Funktionen sind doch voellig 
ueberfluessig. Genau solche Kommentare, die nur nochmal wiederholen, was 
da dann eh' eine oder ein paar Zeilen spaeter in C steht, sind doch ein 
Negativbeispiel, wie man gerade nicht coden soll.

Ganz grosses Kino auch die Schreibweisen: Bei Src und Inc natuerlich den 
ersten Buchstaben gross. Ganz wichtig auch, dass die lokalen 
popel-includes natuerlich immer in einem eigenen Unterverzeichnis 
stehen. Warum nicht gleich eine eigene Partition jeweils fuer Src und 
Inc? Gaaaah!
Dafuer wird dann natuerlich das makefile mit kleinem m am Anfang 
(mutmasslich vom dusseligen STM32CubeIDE) erstellt und nicht mit grossem 
M.
Und includiert natuerlich auch im simpelsten Projekt Unmengen andere 
makefileartige Dateien.

Dann muss man natuerlich immer streng zwischen Applications, Examples, 
und Demonstrations unterscheiden. Ist ja logo...

Ich hatte echt versucht, diesen Kackhaufen zu umgehen. Aber dummerweise 
siehts so aus, als wuerde an der libopencm3 schon seit Jahren nichts 
mehr gefixt und USB-Host ist da auch nur ein grosses, schwarzes Loch :-(

So, das musste mal raus...

Gruss
WK

[Rahul D. (rahul)]

Dergute W. schrieb:
> Moin,
>
> Muss hier mal meinem Entsetzen Luft machen.
> Hab' mir grad dieses Zeugs hier:
> https://github.com/STMicroelectronics/STM32CubeF4
> gecloned und fang' an mich da durchzuwurschteln.
>
> Da muss ich mich aber doch mal fragen - was sind das fuer Leute, die so
> Software schreiben und in dieser Form abliefern?
You get what you paid for...

> Haben die schon mal was davon gehoert, dass man "trailing whitespaces"
> auch weglassen kann? Oder sind da satanische Botschaften per
> whitespace-steganographie drinnen versteckt, wenn man den code
> rueckwaerts liest?
Das dürfte an Editor liegen, wenn man ein Tab gesetzt hat, und sich dann 
für einen Zeilenumbruch entschieden hat.

> Das ist doch so nervig, wie wenn du im Grossraumbuero einen Kollegen
> hast, der sich andauernd raeuspern muss.
Soll er halt was trinken.

> Was soll diese bescheuerte Pseudo-doxygen-dokumentation ueber den
> Funktionen?

> Genau solche Kommentare, die nur nochmal wiederholen, was
> da dann eh' eine oder ein paar Zeilen spaeter in C steht, sind doch ein
> Negativbeispiel, wie man gerade nicht coden soll.
Nö, es ist eine Überschrift für das was danach kommt.
Was ist einfacher zu lesen / zu verstehen? Kryptischer Quellcode oder 
ein Satz in prosa?

> Ich hatte echt versucht, diesen Kackhaufen zu umgehen. Aber dummerweise
> siehts so aus, als wuerde an der libopencm3 schon seit Jahren nichts
> mehr gefixt und USB-Host ist da auch nur ein grosses, schwarzes Loch :-(

Wie wäre es, das Repo zu forken, die Macken zu beheben und es der 
Allgemeinheit zur Verfügung zu stellen?!

In dem Quellcode fehlen noch auskommentierte oder nicht verwendete 
Riesen-Funktionen.

Keil bietet für sein mdk eine USB-Host-Lib an.
Kostet zwar was, entspricht aber wohl eher deinem Geschmack.

[Wastl (hartundweichware)]

Dergute W. schrieb:
> Ich hatte echt versucht, diesen Kackhaufen zu umgehen.

Wenn du diesen Kackhaufen erst mal richtig kennengelernt hast
wirst du vielleicht merken wie dir das Programmieren in der
CubeIDE erleichtert wird. Dazu hast du noch die freie Wahl
entweder LL- oder HAL-Libraries zu verwenden. Frei nach Ge-
schmack sogar wild gemischt.

Oder redest du nur von den vielen Beispielen die dir in der
Cube-Firmware mitgeliefert werden?

Ansonsten kommt mir noch der Spruch in den Sinn: Wasch mir den
Pelz aber mach nicht nasss.