On Wednesday, 2 August 2017 at 13:31:40 UTC, Steven Schveighoffer
wrote:
On 8/1/17 8:34 PM, Mike wrote:
On Tuesday, 1 August 2017 at 14:52:51 UTC, Steven
Schveighoffer wrote:
[...]
I'm not sure my work is worthy of such kind words, but thank
you.
Sorry, it was awesome. You should own it. I think many people
were impressed with what you were able to achieve, especially
those who have dealt with embedded programming.
The PDF screen utility is here:
https://github.com/JinShil/stm32_datasheet_to_d. I'm not sure
if it still compiles and works, but I might need to update it
someday.
It generates much better code and more complete documentation
than svd_to_d. Most silicon vendors don't appear to invest
much into their SVD files, so the SVD files are often
incomplete and lacking the documentation that makes "good code
+ a good IDE = a substitute for the datasheet".
>
If I were creating a professional product, I'd probably prefer
scraping the PDF over using the SVD files, or maybe some way
to merge the two.
Yes, if the datasheet is wrong, they probably hear about it
more, and fix it more readily than some xml files. Much harder
to fix etch than it is to update some software.
In addition, I bet the software engineers take both into
account and defer to the spec, meaning the bugs in the SVD may
not get reported.
I would prefer the more accurate picture if it were me. In
fact, you may be able to give them a better tool to generate
the SVD file from the pdf :)
-Steve
I'm not completely sure but I would guess that the documentation
was generated from the .svd files. If you think about it doing
the documentation by hand would be another thing that the chip
manufactures would have to validate against. If the documentation
is generated from the .svd and the documentation is correct than
the .svd file is also correct.