User manual

Table Of Contents
476
mikoC PRO for PIC32
MikroElektronika
SPI_Ethernet_24j600_getBytes
SPI_Ethernet_24j600_UserTCP
Prototype
void SPI_Ethernet_24j600_getBytes(unsigned char *ptr, unsigned int addr,
unsigned int n);
Description This is MAC module routine. It fetches equested number of bytes from ENC24J600 RAM starting from
given address. If value of 0xFFFF is passed as the address parameter, the reading will start from
current ENC24J600 read pointer (ERDPT) location.
Parameters - ptr: buffer for storing bytes read from ENC24J600 RAM.
- addr: ENC24J600 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_24j600_Init.
Example
char buffer[16];
...
SPI_Ethernet_24j600_getBytes(buffer, 0x100, 16); // read 16 bytes, starting
from address 0x100
Notes None.
Prototype
unsigned int SPI_Ethernet_24j600_UserTCP(unsigned char *remoteHost,
unsigned int remotePort, unsigned int localPort, unsigned int reqLength,
TEthj600PktFlags *ags);
Description This is TCP module routine. It is internally called by the library. The user accesses to the TCP request
by using some of the SPI_Ethernet_24j600_get routines. The user puts data in the transmit buffer by
using some of the SPI_Ethernet_24j600_put routines. The function must return the length in bytes of
the TCP reply, or 0 if there is nothing to transmit. If there is no need to reply to the TCP requests, just
dene this function with return(0) as a single statement.
Parameters - remoteHost: client’s IP address.
- remotePort: client’s TCP port.
- localPort: port to which the request is sent.
- reqLength: TCP request data eld length.
- ags: structure consisted of two bit elds :
Copy Code To Clipboard
typedef struct {
unsigned canCloseTCP: 1; // ag which closes socket
unsigned isBroadcast: 1; // ag which denotes that the IP package has been
received via subnet broadcast address
} TEthj600PktFlags;
Returns - 0 - there should not be a reply to the request.
- Length of TCP reply data eld - otherwise.
Requires Ethernet module has to be initialized. See SPI_Ethernet_24j600_Init.
Example This function is internally called by the library and should not be called by the user’s code.
Notes The function source code is provided with appropriate example projects. The code should be adjusted
by the user to achieve desired reply.