EmbDev.net

Forum: ARM programming with GCC/GNU tools documentation for at91xxx ?


von Documentation for at91xxx ? (Guest)


Rate this post
useful
not useful
Greetings,
   I work with at91sam7s128 with winarm compiler. My question is where 
can i find documentation for all winarm functions - what is the meaning 
of every function(such as AT91F_PMC_EnablePeriphClock() and so on) and 
what parameters are required.
                                                        Michael

von Clifford S. (clifford)


Rate this post
useful
not useful
Documentation for at91xxx ? wrote:
> can i find documentation for all winarm functions -

You seem to misunderstand the nature of WinARM.  It is a collection of 
components from several open source projects and device vendor supplied 
code.  There are no "winarm functions"

> what is the meaning of every function(such as
> AT91F_PMC_EnablePeriphClock() and so on) and
> what parameters are required.

That particular function is specific to AT91 devices.  You should check 
the header file in which it is declared to determine its author, and 
then contact them or their web-site for documentation.  Often the 
documentation you need is in fact contained in the header file.

In this case it is almost certainly the device vendor supplied library 
(I Googled it).  For example lib_AT91SAM7S128.h declared the function 
thus:


//*--------------------------------------------------------------------- 
-------
//* \fn    AT91F_PMC_EnablePeriphClock
//* \brief Enable peripheral clock
//*--------------------------------------------------------------------- 
-------
__inline void AT91F_PMC_EnablePeriphClock (
    AT91PS_PMC pPMC, // \arg pointer to PMC controller
    unsigned int periphIds)  // \arg IDs of peripherals to enable
{
    pPMC->PMC_PCER = periphIds;
}

As you can see it is inlined, so you can see exactly what it does, and 
is fully commented.  The comments appear to have some sort of mark-up 
(JavaDoc perhaps?) which would be used for automatically generating 
documentation, so the actual documentation would include no more than 
this in any case.

The full library and documentation is available from 
http://www.atmel.com/dyn/products/tools_card.asp?tool_id=4343

For the record, the function enables individual peripherals; disabling 
unused peripherals saves power.  To understand what it is actually 
doing, and the necessary values for the arguments, you need to be 
familiar with the specific devices reference or user manual; available 
in this case from Atmel's website 
(http://www.atmel.com/dyn/resources/prod_documents/doc6175.pdf).

Clifford

von Documentation for at91xxx ? (Guest)


Rate this post
useful
not useful
Thank you very much for your detailed answer.
                                                                                                    Michael

Please log in before posting. Registration is free and takes only a minute.
Existing account
Do you have a Google/GoogleMail account? No registration required!
Log in with Google account
No account? Register here.