I think people who need to know this are smart enough to take a look at the linker files generated symbol files or can just print addresses in a sketch.. You can't document everything on such a page. It would need several pages if you want to go down to that level.
It is easy to confuse beginners with too much information.
Frank,
As I mentioned, it was unclear how much information is useful to a majority of users. And yes I do look at things like linker scripts.
But I mentioned the starting addresses and this diagram says there are 4 memory regions, which there is sort of.
However RAM1 is sort of confusing, it looks like there is one memory space of 512KB, which there sort of is, but if you look at the linker scripts:
Code:
MEMORY
{
ITCM (rwx): ORIGIN = 0x00000000, LENGTH = 512K
DTCM (rwx): ORIGIN = 0x20000000, LENGTH = 512K
RAM (rwx): ORIGIN = 0x20200000, LENGTH = 512K
FLASH (rwx): ORIGIN = 0x60000000, LENGTH = 7936K
ERAM (rwx): ORIGIN = 0x70000000, LENGTH = 16384K
}
It shows there are 5 memory regions. And shows ITCM and DTCM both being 512K in size...
The diagram looks like the ITCM and DTCM are contiguous in memory and they sort of are, BUT their addresses are not...
Again I agree with you that going into into details could be confusing. But wonder at times if giving hints to users where to look might be helpful.
Likewise in this case I wonder if we can and/or should easily unify naming:
Example, with Diagram versus Linker scripts...
RAM1 vs ITCM/DTCM
RAM2 vs RAM
FLASH
PSRAM vs ERAM
As for beginners versus normal users, versus power users, I agree with you that it is difficult to find the right balance. Wonder over time may need to create secondary pages with more of the details or not... Or maybe adding something like links to get more information or things defined might help. There are already tons of terminology and the like, that probably many of the users may not fully understand.
Like, what is:
Tightly Coupled? (There is a section)
QSPI?
DMA?
RTC?
...
But again I do like where this is going as these pages at least give users some idea of some the functionality and hints on where to find more information.