288: You Got a Screen!
Embedded10 Mai 2019

288: You Got a Screen!

Christopher (@stoneymonster) and Elecia (@logicalelegance) discuss embedded systems education and project documentation.

Elecia wrote about her love of notebooks on the https://www.embedded.fm/blog-index.

yEd, for when you don't have Visio. Asciiflow.com, for when you don't have yEd (or you want to put diagrams in your comments)

We talked about many different documents and tried to note design vs implementation, product vs engineering vs user, and why we wanted them. We didn't mention mechanical things because, ya know, software engineers. Some documentation we mentioned:

  • Product documentation

  • Schematics with block diagrams and comments. Also a GPIO to function spreadsheet.

  • UI flow when the system has a screens (Balsamiq for wireframe testing UIs)

  • SW spec and design doc: what do we plan to build and what are the tricky parts

  • SW configuration and SW developer docs: how to rebuild the computer that can build the code from scratch, also notes on debugging methodology

  • User manual: Usually not written by SW but may need SW's patient input

  • Code comments: Functions and files get 5Ws: who, what, why, when, where, and how.

    • Who should call this?

    • What will its effect be? ("What will it do" but not in line by line detail!)

    • How does it work?

    • Why does it work this way?

    • When should it be called?

    • Where are its parameters? ("What" works here too but "where" is nice to remind you to check your memory assumptions.)

  • Repository checkin comments

  • Style guide (Such as Google's or PEP)

  • Manufacturing docs and tests docs

Adafruit and Sparkfun both write good documentation, writing to users about how to use their code. Elecia likes Adafruit's sensor library as a good set of code to review (including how much is in their docs vs their code).

Episoder(569)

458: Fiddling, DIY, and Cursing

458: Fiddling, DIY, and Cursing

Trond Snekvik spoke with us about developing VSCode extensions and Bluetooth meshes. Trond is a Staff Software Engineer at Nordic Semiconductor. Nordic's Visual Studio Code Extensions include device ...

31 Aug 20231h 11min

457: Rubber Duck Phase Cancellation

457: Rubber Duck Phase Cancellation

Chris and Elecia chat about their ongoing efforts to create and learn. Then they answer some listener questions. Duck quacks do echo but the echoes seem to align in phase so that there is no interrup...

17 Aug 20231h 12min

456: Left Right Symmetry of a Banana

456: Left Right Symmetry of a Banana

Damien George spoke with us about developing with and for MicroPython while Elecia tries not to spill all the secrets about her client. To start at the beginning, you probably want to check out microp...

3 Aug 20231h 8min

455: Snaps!

455: Snaps!

Natalie Friedman joins us to discuss when, where, how, and why robots should wear clothing. Natalie is a PhD candidate at Cornell Tech. Natalie's website is natalie-friedman.com and you can find her ...

20 Jul 202355min

454: Printf Hello

454: Printf Hello

Uri Shaked surprises us with a chat about silicon design when we were expecting to talk about a web-based board simulator. If you want to try your hand at silicon design, check out Tiny Tapeout, a wa...

6 Jul 20231h 15min

453: Too Dumb to Quit

453: Too Dumb to Quit

Nathan Jones has been talking about building command line interfaces, good design practices in C, creating MCU boards, wielding the PIC of destiny, and going beyond Arduino. As we are too lazy to atte...

22 Jun 20231h 8min

452: Numbers on Computers Are Weird

452: Numbers on Computers Are Weird

Julia Evans spoke with us about how computers compute. We discussed number representation including floating point as well as Julia's extensive collection of 'zines and comics. Julia's zines about deb...

15 Jun 20231h 11min

451: From Concept to Launch

451: From Concept to Launch

Phillip Johnston of Embedded Artistry, Tyler Hoffman of Memfault, and Elecia White discuss the software tasks that tend to fall through the cracks after the device has all its features but before it i...

8 Jun 20231h 2min

Populært innen Vitenskap

fastlegen
tingenes-tilstand
rekommandert
rss-nysgjerrige-norge
forskningno
sinnsyn
vett-og-vitenskap-med-gaute-einevoll
liberal-halvtime
smart-forklart
rss-rekommandert
pod-britannia
jss
fjellsportpodden
villmarksliv
rss-overskuddsliv
nevropodden
aldring-og-helse-podden
tomprat-med-gunnar-tjomlid
dekodet-2
rss-bondevennen