28.2.18 __builtin_dmapage

Description

Obtains the page number of a symbol within DMA memory.

For example:

 unsigned int result;
 char buffer[256] __attribute__((space(dma)));

 result = __builtin_dmapage(&buffer);

Might generate:

mov #dmapage(buffer), w0

Prototype

unsigned int __builtin_dmapage(const void *p);

Argument

*p – pointer to DMA address value

Return Value

Returns the page number of a variable located in DMA memory.

Assembler Operator/ Machine Instruction

dmapage

Error Messages

An error message will be displayed if the parameter is not the address of a global symbol.