User manual

mikroC PRO for dsPIC
MikroElektronika
503
SPI_Ethernet_Enable
Prototype
void SPI_Ethernet_Enable(unsigned char enFlt);
Description This is MAC module routine. This routine enables appropriate network trafc on the ENC28J60 module
by the means of it’s receive lters (unicast, multicast, broadcast, crc). Specic type of network trafc
will be enabled if a corresponding bit of this routine’s input parameter is set. Therefore, more than one
type of network trafc can be enabled at the same time. For this purpose, predened library constants
(see the table below) can be ORed to form appropriate input value.
Advanced ltering available in the ENC28J60 module such as Pattern Match, Magic Packet and
Hash Table can not be enabled by this routine. Additionaly, all lters, except CRC, enabled with this
routine will work in OR mode, which means that packet will be received if any of the enabled lters
accepts it.
This routine will change receive lter conguration on-the-y. It will not, in any way, mess with enabling/
disabling receive/transmit logic or any other part of the ENC28J60 module. The ENC28J60 module
should be properly cogured by the means of SPI_Ethernet_Init routine.
Parameters - enFlt: network trafc/receive lter ags. Each bit corresponds to the appropriate network trafc/
receive lter:
Returns Nothing.
Requires Ethernet module has to be initialized. See SPI_Ethernet_Init.
Example
SPI_Ethernet_Enable(_SPI_Ethernet_CRC | _SPI_Ethernet_UNICAST); // enable
CRC checking and Unicast trafc
Notes Advanced ltering available in the ENC28J60 module such as Pattern Match, Magic Packet
and Hash Table can not be enabled by this routine. Additionaly, all lters, except CRC, enabled with
this routine will work in OR mode, which means that packet will be received if any of the enabled lters
accepts it.
This routine will change receive lter conguration on-the-y. It will not, in any way, mess with enabling/
disabling receive/transmit logic or any other part of the ENC28J60 module. The ENC28J60 module
should be properly cogured by the means of SPI_Ethernet_Init routine.
Bit Mask Description Predened library const
0 0x01
MAC Broadcast trafc/receive lter ag. When set,
MAC broadcast trafc will be enabled.
_SPI_Ethernet_
BROADCAST
1 0x02
MAC Multicast trafc/receive lter ag. When set,
MAC multicast trafc will be enabled.
_SPI_Ethernet_
MULTICAST
2 0x04 not used none
3 0x08 not used none
4 0x10 not used none
5 0x20
CRC check ag. When set, packets with invalid
CRC eld will be discarded.
_SPI_Ethernet_CRC
6 0x40 not used none
7 0x80
MAC Unicast trafc/receive lter ag. When set,
MAC unicast trafc will be enabled.
_SPI_Ethernet_UNICAST