add debug strs, comments, move fcn desc, whitesp

- add several debug strings for various errors
- add function comments
- move function descriptions to headers files and prototype section
- add fixme marks to fcns where broken
- join fcn start braket with header to improve folding
- add summary of atmel commands
- add macro for ATMEL_BLOCK_SIZE