User manual

mikroC PRO for PIC32
MikroElektronika
449
SPI_Ethernet_putConstString
SPI_Ethernet_getByte
SPI_Ethernet_getBytes
Prototype
unsigned int SPI_Ethernet_putConstString(const unsigned char *ptr);
Description This is MAC module routine. It stores whole const string (excluding null termination) into ENC28J60
RAM starting from current ENC28J60 write pointer (EWRPT) location.
Parameters - ptr: const string to be written into ENC28J60 RAM.
Returns Number of bytes written into ENC28J60 RAM.
Requires Ethernet module has to be initialized. See SPI_Ethernet_Init.
Example
const char *buffer = “mikroElektronika”;
...
SPI_Ethernet_putConstString(buffer); // put a const string into ENC28J60
buffer
Notes None.
Prototype
unsigned char SPI_Ethernet_getByte();
Description This is MAC module routine. It fetches a byte from address pointed to by current ENC28J60 read
pointer (ERDPT).
Parameters None.
Returns Byte read from ENC28J60 RAM.
Requires Ethernet module has to be initialized. See SPI_Ethernet_Init.
Example
char buffer;
...
buffer = SPI_Ethernet_getByte(); // read a byte from ENC28J60 buffer
Notes None.
Prototype
void SPI_Ethernet_getBytes(unsigned char *ptr, unsigned int addr, unsigned
int n);
Description This is MAC module routine. It fetches equested number of bytes from ENC28J60 RAM starting from
given address. If value of 0xFFFF is passed as the address parameter, the reading will start from
current ENC28J60 read pointer (ERDPT) location.
Parameters - ptr: buffer for storing bytes read from ENC28J60 RAM.
- addr: ENC28J60 RAM start address. Valid values: 0..8192.
- n: number of bytes to be read.
Returns Nothing.
Requires Ethernet module has to be initialized. See SPI_Ethernet_Init.
Example
char buffer[16];
...
SPI_Ethernet_getBytes(buffer, 0x100, 16); // read 16 bytes, starting from
address 0x100
Notes None.