User manual

mikroPascal PRO for dsPIC30/33 and PIC24
MikroElektronika
504
SPI_Ethernet_24j600_Enable
Prototype
procedure SPI_Ethernet_24j600_Enable(enFlt : word);
Description This is MAC module routine. This routine enables appropriate network trafc on the ENC24J600
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 ENC24J600 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 ENC24J600 module. The ENC24J600 module
should be properly cogured by the means of SPI_Ethernet_24j600_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_24j600_Init.
Example
SPI_Ethernet_24j600_Enable(_SPI_Ethernet_24j600_CRC or _SPI_Ethernet_24j600_
UNICAST); // enable CRC checking and Unicast trafc
Notes Advanced ltering available in the ENC24J600 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 ENC24J600 module. The ENC24J600 module
should be properly cogured by the means of SPI_Ethernet_24j600_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_24j600_
BROADCAST
1
0x02
MAC Multicast trafc/receive lter ag. When set, MAC
multicast trafc will be enabled.
_SPI_Ethernet_24j600_
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_24j600_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_24j600_
UNICAST