Component: TCP/IP (BL0187) (E-blocks 2)

Author	Matrix TSL
Version	2.3
Category	E-blocks 2

TCP/IP component

A set of routines used to control a ENC28J60 TCP/IP Module. Required connections VCC, Reset, GND, SCK, MISO, MOSI, CS. Leave these pins disconnected CLKOUT, ENC_WOL, ENC_INT

Component Source Code

Please click here to download the component source project: FC_Comp_Source_TCPIP_BL0187.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_TCPIP_BL0187.fcfx

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

ControlLEDs

	ControlLEDs
Allows both the LEDs on the Ethernet socket to be controlled. Useful for checking if the SPI communications are functioning correctly.
- BYTE	Mode
0=Off, 1=On, 2=Auto
- VOID	Return

CreateIPSocket

	CreateIPSocket
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Protocol
Specifies which IP protocol to use
- BYTE	Broadcast
Allows broadcast type packets to be sent and received
- BYTE	Return

CreateMACSocket

	CreateMACSocket
This macro creates a socket for sending and receiving Ethernet data using raw data.
- BYTE	Promiscuous
Receive everything (1) or just data bound for your MAC (0)
- BYTE	Broadcast
Allows broadcast messages to be accepted (1) or rejected (0)
- BYTE	Error
Allowsmessages with errors to be accepted (1) or rejected (0)
- BYTE	Return

CreateTCPSocket

	CreateTCPSocket
This macro creates a socket for sending and receiving TCP data.
- BYTE	Channel
Specifies the communications channel 0-3
- UINT	Src_Port
Port Number
- BYTE	Return

CreateUDPSocket

	CreateUDPSocket
This macro creates a socket for sending and receiving UDP data.
- BYTE	Channel
Specifies the communications channel 0-3
- UINT	Src_Port
Port Number
- BYTE	Return

DHCP_Setup

	DHCP_Setup
- BYTE	Return

DNS_Lookup

	DNS_Lookup
Resolve the URL into an IP address via the DNS server. Returns non-zero if successful
- STRING	URL
URL address string
- BYTE	IP
Returned IPv4 address
- BYTE	Return

GetLocalIP

	GetLocalIP
Gets the local IP address
- BYTE	IP
4-byte Array to store the IP address
- VOID	Return

GetLocalMAC

	GetLocalMAC
Gets the local MAC address
- BYTE	MAC
6-byte Array to store the MAC address
- VOID	Return

Initialise

	Initialise
Initialises the SPI connection to the TCPIP module and sets up some initial values. Flashes the LEDs on and off twice to confirm SPI comms are active. LEDs are then configured to auto functionality.
- VOID	Return

ReadRegister

	ReadRegister
Reads the value from a single register onboard the ENC28J60 module.
- BYTE	Address
- BYTE	Return

RxDataAvailable

	RxDataAvailable
Check if data has been received. A non-zero return value indicates that data is available. This macro should be called regularly as it also processess supporting network traffic.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Return

RxDataSize

	RxDataSize
This macro is used to detect the size of data collected by the Rx_data_available macro.
- BYTE	Channel
Specifies the communications channel 0-3
- UINT	Return

RxFlushData

	RxFlushData
Once data reception has been completed, this macro should be called to discard the data packet and allow other data packets to be read.
- BYTE	Channel
Specifies the communications channel 0-3
- VOID	Return

RxMatchMyIP

	RxMatchMyIP
This macro returns a non-zero value when the next 4 bytes of data in the specified channel's reception buffer are the same as the Internet E-block's IP address.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Return

RxMatchMyMAC

	RxMatchMyMAC
This macro returns a non-zero value when the next 6 bytes of data in the specified channel's reception buffer are the same as the Internet E-block's MAC address entered in the component's property page.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Return

RxMatch_2_Bytes

	RxMatch_2_Bytes
This macro returns a non-zero value when the next 2 bytes of data in the specified channel's reception buffer are the same as those passed as parameters. There are similar functions that check for 4 bytes and 6 bytes.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Byte1
Specifies the value of the first byte
- BYTE	Byte2
Specifies the value of the second byte
- BYTE	Return

RxMatch_4_Bytes

	RxMatch_4_Bytes
This macro returns a non-zero value when the next 4 bytes of data in the specified channel's reception buffer are the same as those passed as parameters. There are similar functions that check for 2 bytes and 6 bytes.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Byte1
Specifies the value of the first byte
- BYTE	Byte2
Specifies the value of the second byte
- BYTE	Byte3
Specifies the value of the third byte
- BYTE	Byte4
Specifies the value of the fourth byte
- BYTE	Return

RxMatch_6_Bytes

	RxMatch_6_Bytes
This macro returns a non-zero value when the next 6 bytes of data in the specified channel's reception buffer are the same as those passed as parameters. There are similar functions that check for 2 bytes and 4 bytes.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Byte1
Specifies the value of the first byte
- BYTE	Byte2
Specifies the value of the second byte
- BYTE	Byte3
Specifies the value of the third byte
- BYTE	Byte4
Specifies the value of the fourth byte
- BYTE	Byte5
Specifies the value of the fifth byte
- BYTE	Byte6
Specifies the value of the sixth byte
- BYTE	Return

RxReadByte

	RxReadByte
A call to this macro will return a byte of data in the reception buffer of the specified channel. It will also internally increment a pointer to that data so that the next call to 'Rx_readbyte' (or any other read function) will read the next byte
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Return

RxReadHeader

	RxReadHeader
Once data in a particular channel has been received, the header will be filled with information about the received data. This macro will return the information in the header. The idx parameter specifies which byte of information in the header to read
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Idx
Specifies the byte index to return
- BYTE	Return

RxReadString

	RxReadString
A call to this macro will return a string of data in the reception buffer of the specified channel. It will also internally increment a pointer to that data so that the next call to 'Rx_readbyte' (or any other read function) will read the next byte
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Length
- STRING	Return

RxSkipBytes

	RxSkipBytes
Often when receiving data packets, it may be necessary to ignore large sections of the data. This can be achieved by reading each byte individually (and ignoring the returned data), but a better way is to use this Rx_skipbytes macro.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Count
Specifies how many bytes to skip
- VOID	Return

RxStart

	RxStart
Move the received buffer read pointer back to the start
- BYTE	Channel
- VOID	Return

SetDestination

	SetDestination
This is used in IP and UDP modes to set the destination of the intended data transfer.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	IP
- UINT	Port
Destination Port
- BYTE	Return

SetGateway

	SetGateway
This macro sets up the Internet E-Block's Gateway address. In most circumstances, this macro will not be required as the gateway address setting in the component property page will remain constant throughout your application.
- BYTE	IP0
First Byte of IP address
- BYTE	IP1
Second Byte of IP address
- BYTE	IP2
Third Byte of IP address
- BYTE	IP3
Fourth Byte of IP address
- VOID	Return

SetLocalIP

	SetLocalIP
This macro sets up the Internet E-Block's own IP address. In most circumstances, this macro will not be required as the IP address setting in the component property page will remain constant throughout your application.
- BYTE	IP0
First Byte of IP address
- BYTE	IP1
Second Byte of IP address
- BYTE	IP2
Third Byte of IP address
- BYTE	IP3
Fourth Byte of IP address
- VOID	Return

SetMACAddress

	SetMACAddress
Allows the MAC Address specified in the component properties to be overridden. The MAC Address will revert back to the MAC specified in the component properties as part of the initialise macro.
- BYTE	MAC0
MAC Address Parameter
- BYTE	MAC1
MAC Address Parameter
- BYTE	MAC2
MAC Address Parameter
- BYTE	MAC3
MAC Address Parameter
- BYTE	MAC4
MAC Address Parameter
- BYTE	MAC5
MAC Address Parameter
- VOID	Return

SetSubnetMask

	SetSubnetMask
This macro sets up the Internet E-Block's Subnet Mask. In most circumstances, this macro will not be required as the subnet mask setting in the component property page will remain constant throughout your application.
- BYTE	IP0
First Byte of IP address
- BYTE	IP1
Second Byte of IP address
- BYTE	IP2
Third Byte of IP address
- BYTE	IP3
Fourth Byte of IP address
- VOID	Return

TCP_Close

	TCP_Close
When an established TCP connection has finished transmission of data, either the local application (i.e. your code) or the remote application (i.e. the application at the other end of the connection) can initiate closure of the socket.
- BYTE	Return

TCP_Connect

	TCP_Connect
This macro puts a previously opened TCP channel in "active open" mode. This is the required mode when writing a TCP client application (e.g. using SMTP to send an email).
- STRING	URL
URL or IPv4 address
- UINT	Dst_Port
Destination Port
- BYTE	Return

TxEnd

	TxEnd
Once the transmit buffer has been filled with data, call this macro to actually send the data.
- BYTE	Channel
Specifies the communications channel 0-3
- VOID	Return

TxSendByte

	TxSendByte
This macro fills the specified channel's transmit buffer with data. It can fill the buffer with a single byte of data, or with a string of information.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Data
Data byte to append to Tx buffer.
- VOID	Return

TxSendMyIP

	TxSendMyIP
This macro fills the specified channel's transmit buffer with 4 bytes of data representing this Internet E-Block's IP address as specified in the component's property page.
- BYTE	Channel
Specifies the communications channel 0-3
- VOID	Return

TxSendMyMAC

	TxSendMyMAC
This macro fills the specified channel's transmit buffer with 6 bytes of data representing this Internet E-Block's MAC address as specified in the component's property page.
- BYTE	Channel
Specifies the communications channel 0-3
- VOID	Return

TxSendString

	TxSendString
This macro fills the specified channel's transmit buffer with data. It can fill the buffer with a string of information.
- BYTE	Channel
Specifies the communications channel 0-3
- STRING	Data
Data byte to append to Tx buffer.
- BYTE	Length
- VOID	Return

TxStart

	TxStart
This macro indicates the start of data transmission for the specified buffer. In TCP mode, data transmission can only begin once the socket has become established. In other modes, data transmission can occur as soon as the socket has been opened.
- BYTE	Channel
Specifies the communications channel 0-3
- VOID	Return

WriteRegister

	WriteRegister
Writes a value to a single register onboard the ENC28J60 module.
- BYTE	Address
- BYTE	Data
- VOID	Return

Property reference

	Properties
	TCP IP Specifics
	Server Port
Sets the server's TCP/IP port address which is used to filter incoming TCP packets.
	Buffer Size
Number of bytes to use for the transmit and receive buffer, we actually use this +1 to allow for a null termination. 8-bit PICs should set this to 255 to allow compilation to succeed. Other devices can have larger buffers. Default = 500
	SPI Settings
	Channel
SPI Channel selector
	Prescale
Prescale option selector
	MOSI
SPI Data Out Pin SDO - Also Known as Master Out Slave In (MOSI) when used in Master mode.
	MISO
SPI Data In Pin SDI - Also Known as Master In Slave Out (MISO) when used in Master mode.
	CLK
SPI Clock Pin CLK - The Clock signal is driven by the SPI master.
	CS / SS
Chip Select / Slave Select Pin Master Mode: General purpose output pin used to select the remote SPI device. Slave Mode: Hardware chip select pin input used to select the SPI device.
	Reset Pin
	LED Flash
When enabled the socket LEDs will flash on/off 500ms. Useful for SPI check.
	Auto DHCP
When enabled the Initialisation will also include DHCP setup to auto configure settings.
	MAC Address
	MAC0
	MAC1
	MAC2
	MAC3
	MAC4
	MAC5
	IP Address
	IP0
	IP1
	IP2
	IP3
	Gateway IP
	Gateway0
	Gateway1
	Gateway2
	Gateway3
	Subnet Mask
	Subnet0
	Subnet1
	Subnet2
	Subnet3
	Simulation
	Label
	Sim Type
Decides how to perform the simulation of the component. TCP IP - Communicates using the Windows TCP IP communications DLL SPI / Injector - Communicates using the CAL SPI to allow the communications to be analysed and debugged.
	SPI Simulation
	Scope Traces
Selects if the scope traces are automatically generated or not
	Console Data
Selects if the console data is automatically generated or not
	API