BBB documentation
Posted: Sun Jan 24, 2010 10:07 am
Hi Paul,
I built a BBB board yesterday and was very pleased with the experience! Great value, nice board, excellent documentation.
I did notice a couple of minor glitches in the docs, and thought I'd point them out before I forget. None of them are show-stoppers, but I know I'd want someone to point these out in my documentation.
(Revision E BBB instructions)
Page 1 - reference is made to the "Atmega168 datasheet" - maybe this should be "Atmega168/328" to be consistent with what you've done in the schematic section. You might want to do a global search on "168" to neaten things up a bit.
Page 2 "Testing your BB Arduino"
2nd bullet - "Atmega 168" reference
Before the 3rd bullet point it would be helpful to have something like "You should have the Arduino software and FTDI drivers installed before continuing". Maybe this should be at the top of the section - I dunno (Guess who had forgotten to install the drivers!).
4th bullet "troubleshooting guide on page 6" should be page 8!
"Powering the BBB Arduino" section:"..power options are illustrated on page 6" should be page 7.
Page 5 - bottom caption says "Atmega168/ 238"
Again, the docs are really excellent, and I don't think the items above would cause anyone any serious problems. But last week I found a couple of similar silly errors in a chemistry lab I've been giving to students for about 5 years and my first thought was "Why hasn't anyone pointed these out to me before!"
Oh yeah, since this is my first post, I guess I should point out my background: I've built lots of kits, done some simple circuit design, and am familiar with PIC and AVR microcontrollers, but a newbie to the Arduino system. I'm a chemist and I'm currently working on a pH meter circuit to use in teaching a chemical instrumentation course.
Thanks again for a great product!
andy
I built a BBB board yesterday and was very pleased with the experience! Great value, nice board, excellent documentation.
I did notice a couple of minor glitches in the docs, and thought I'd point them out before I forget. None of them are show-stoppers, but I know I'd want someone to point these out in my documentation.
(Revision E BBB instructions)
Page 1 - reference is made to the "Atmega168 datasheet" - maybe this should be "Atmega168/328" to be consistent with what you've done in the schematic section. You might want to do a global search on "168" to neaten things up a bit.
Page 2 "Testing your BB Arduino"
2nd bullet - "Atmega 168" reference
Before the 3rd bullet point it would be helpful to have something like "You should have the Arduino software and FTDI drivers installed before continuing". Maybe this should be at the top of the section - I dunno (Guess who had forgotten to install the drivers!).
4th bullet "troubleshooting guide on page 6" should be page 8!
"Powering the BBB Arduino" section:"..power options are illustrated on page 6" should be page 7.
Page 5 - bottom caption says "Atmega168/ 238"
Again, the docs are really excellent, and I don't think the items above would cause anyone any serious problems. But last week I found a couple of similar silly errors in a chemistry lab I've been giving to students for about 5 years and my first thought was "Why hasn't anyone pointed these out to me before!"
Oh yeah, since this is my first post, I guess I should point out my background: I've built lots of kits, done some simple circuit design, and am familiar with PIC and AVR microcontrollers, but a newbie to the Arduino system. I'm a chemist and I'm currently working on a pH meter circuit to use in teaching a chemical instrumentation course.
Thanks again for a great product!
andy