firmware: Add overview documentation

Additionallly add or improve some other comments as well.
foo