At a minimum, everyone using a modern AVR beyond the Arduino API should plan on having a PDF viewer open with the datasheet, and a text editor with a good search function and the ioavr__eb__.h file open so that when you're trying to use a constant, but the compiler says it isn't declared/defined, you can search the io header for a key phrase in the constant and figure out how it was spelled/formatted or copy/paste it to your sketch. (see [the IO headers](./ioheaders) for more information and links to them. I also keep the AVR instruction set manual open in the PDF viewer if I'm doing anything deep. For most modern parts, unfortunately, you're also definitely going to need the the silicon errata and datasheet clarification document in addition to the latest version of the datasheet - that is the document that lists silicon bugs and which die revs this and parts they're present on; if they list something as an erratum, that means that, in theory, maybe, some day, silicon without any of the errata will be available, but I'm not confident it will happen before the sun runs out of fuel and puffs up into a red giant, engulfing the inner planet. That last part would cause problems for terrestrial semiconductor manufacturers as well as their customers. (*Yeah, with all that radiation, process yields would tank...* "And staffing problems too, what with the extermination life on the planet" *That too. It would really shake things up, for sure*)... Anyway, as of early 2025, the DB and the EA have received die-revs that make a difference (no other part hasBoth the DB and EA have now (the former due to it being the flagship and having a lot of very visible bugs. The latter because they did something horribly wrong with the self-programming system there. Datasheet clarifications are a bigger deal than an erratum, usually. An erratum says "Okay, this doesn't work, but it will some day, maybe" while a datasheet clarification says "This would be an errata, but we're not even going to pretend that we'll fix it some day". But watch out - datasheet clarifications vanish from the list once the datasheet has been updated!
0 commit comments