Difference between revisions of "Component: TCP/IP (EB023 v2) (E blocks 1)"

Latest revision as of 17:24, 9 November 2022

Author	Matrix TSL
Version	2.0
Category	E-blocks 1

TCP/IP component

TCP/IP component designed to work with the WIZ810MJ module from Wiznet, as used on version 2 EB023 E-block and the MIAC Industrial Addon module.

Component Pack

COMMSA

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Downloadable macro reference

	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

	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

	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

	SetMyIP
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

	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

	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

	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

	MIAC_Module_SetData

- BYTE	Count

- BYTE	D0

- BYTE	D1

- BYTE	D2

- BYTE	D3

- BYTE	D4

- BYTE	D5

- VOID	Return

	CreateIPSocket
Note that sockets on up to 4 channels can be simultaneously opened and these channels are numbered 0 to 3. Note that sockets with different modes can be opened on different channels.
- 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

	SetDestination
This is used in IP and UDP modes to set the destination of the intended data transfer. The destination IP address needs to be set for both IP and UDP modes.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Dst_IP0
Specifies the first byte of an IP address
- BYTE	Dst_IP1
Specifies the second byte of an IP address
- BYTE	Dst_IP2
Specifies the third byte of an IP address
- BYTE	Dst_IP3
Specifies the fourth byte of an IP address
- UINT	Dst_Port
Destination Port
- BYTE	Return

	MIAC_Module_GetData

- BYTE	Index

- BYTE	Return

	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

	MIAC_Module_Message

- UINT	CAN_ID

- UINT	CMD_ID

- BYTE	Return

	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

	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

	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

	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

	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

	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

	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

	RxDataAvailable
This macro is used to check whether or not data has been received by the Internet E-Block. A return value of zero indicated that no data has been received. A positive return value indicates that data is available.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Return

	MIAC_Module_PushData

- BYTE	Data

- VOID	Return

	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

	TCPListen
This macro puts a previously opened TCP channel in "passive open" mode. This is the required mode when writing a TCP server application (e.g. a web server to display HTML web pages).
- BYTE	Channel
Specifies the communications channel 0-3
- VOID	Return

	TxSendByte_Sim
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

	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

	TCPConnect
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).
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Dst_IP0
First Byte of IP address
- BYTE	Dst_IP1
Second Byte of IP address
- BYTE	Dst_IP2
Third Byte of IP address
- BYTE	Dst_IP3
Fourth Byte of IP address
- UINT	Dst_Port
Destination Port
- BYTE	Return

	RxReadByte_Sim
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

	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

	RxFlushData_Sim
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

	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

	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

	CreateUDPSocket_Sim
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

	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

	SetMACAddress
This macro sets up the Internet E-Block's MAC address. In most circumstances, this macro will not be required as the MAC address setting in the component property page will remain constant throughout your application.
- BYTE	MAC0
First Byte of address
- BYTE	MAC1
Second Byte of address
- BYTE	MAC2
Third Byte of address
- BYTE	MAC3
Fourth Byte of address
- BYTE	MAC4
Fourth Byte of address
- BYTE	MAC5
Fifth Byte of address
- VOID	Return

	RxMatch_4_Bytes_Sim
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

	RxDataSize_Sim
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
- BYTE	Return

	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

	RxMatch_2_Bytes_Sim
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

	RxMatchMyMAC_Sim
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

	TCPClose
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	Channel
Specifies the communications channel 0-3
- VOID	Return

	GetSocketStatus
This returns the state of the requested channel's socket.
- BYTE	Channel
Specifies the communications channel 0-3
- BYTE	Return

	Initialise
Resets and initialises the Internet E-Block. It sets up the gateway address, subnet mask, device IP address and device MAC address as defined in the properties of the Flowcode component. This macro must be called before any other TCP_IP component macros
- BYTE	Return

	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

Property reference

	Properties
	Connections
	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.
	Gateway IP
	Gateway0

	Gateway1

	Gateway2

	Gateway3

	Subnet Mask
	Subnet0

	Subnet1

	Subnet2

	Subnet3

	IP Address
	IP0

	IP1

	IP2

	IP3

	MAC Address
	MAC0

	MAC1

	MAC2

	MAC3

	MAC4

	MAC5

	Simulation
	Label

	Sim Type
Decides how to perform the simulation of the component. TCP IP - Communicates using the Windows TCP IP communications DLL SPI / API - 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

Difference between revisions of "Component: TCP/IP (EB023 v2) (E blocks 1)"

Latest revision as of 17:24, 9 November 2022

Contents

TCP/IP component

Component Pack

Detailed description

Examples

Downloadable macro reference

Property reference

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools

@@ Line 14: / Line 14: @@
 ==TCP/IP component==
 TCP/IP component designed to work with the WIZ810MJ module from Wiznet, as used on version 2 EB023 E-block and the MIAC Industrial Addon module.
+==Component Pack==
+COMMSA
 ==Detailed description==
 ''No detailed description exists yet for this component''
 ==Examples==
 ''<span style="color:red;">No additional examples</span>''
@@ Line 1,126: / Line 1,150: @@
 |}
+==Property reference==
 {| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RxDataSize'''
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+|-
 |-
-| colspan="2" | This macro is used to detect the size of data collected by the Rx_data_available macro.&nbsp;
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
 |-
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
 | width="90%" | Channel
 |-
-| colspan="2" | Specifies the communications channel 0-3&nbsp;
+| colspan="2" | SPI Channel selector&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | Prescale
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| colspan="2" | Prescale option selector&nbsp;
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''TxSendMyMAC'''
 |-
-| colspan="2" | 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.&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
+| width="90%" | MOSI
 |-
+| colspan="2" | SPI Data Out Pin SDO - Also Known as Master Out Slave In (MOSI) when used in Master mode.&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
-| width="90%" | Channel
+| width="90%" | MISO
 |-
-| colspan="2" | Specifies the communications channel 0-3&nbsp;
+| colspan="2" | SPI Data In Pin SDI - Also Known as Master In Slave Out (MISO) when used in Master mode.&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | CLK
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| colspan="2" | SPI Clock Pin CLK - The Clock signal is driven by the SPI master.&nbsp;
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''CreateMACSocket'''
 |-
-| colspan="2" | This macro creates a socket for sending and receiving Ethernet data using raw data.&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
+| width="90%" | CS / SS
 |-
+| colspan="2" | 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. &nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
-| width="90%" | Promiscuous
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Gateway IP
 |-
-| colspan="2" | Receive everything (1) or just data bound for your MAC (0)&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Broadcast
+| width="90%" | Gateway0
 |-
-| colspan="2" | Allows broadcast messages to be accepted (1) or rejected (0)&nbsp;
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Error
+| width="90%" | Gateway1
 |-
-| colspan="2" | Allowsmessages with errors to be accepted (1) or rejected (0)&nbsp;
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | Gateway2
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| colspan="2" | &nbsp;
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetSocketStatus'''
 |-
-| colspan="2" | This returns the state of the requested channel's socket.&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | Gateway3
 |-
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
-| width="90%" | Channel
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Subnet Mask
 |-
-| colspan="2" | Specifies the communications channel 0-3&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | Subnet0
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| colspan="2" | &nbsp;
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
 |-
-| colspan="2" | Resets and initialises the Internet E-Block. It sets up the gateway address, subnet mask, device IP address and device MAC address as defined in the properties of the Flowcode component. This macro must be called before any other TCP_IP component macros &nbsp;
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | Subnet1
 |-
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | Subnet2
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| colspan="2" | &nbsp;
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''TCPClose'''
 |-
-| colspan="2" | 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.&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | Subnet3
 |-
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
-| width="90%" | Channel
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | IP Address
 |-
-| colspan="2" | Specifies the communications channel 0-3&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | IP0
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| colspan="2" | &nbsp;
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RxMatchMyMAC'''
 |-
-| colspan="2" | 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.&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | IP1
 |-
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Channel
+| width="90%" | IP2
+|-
+| colspan="2" | &nbsp;
 |-
-| colspan="2" | Specifies the communications channel 0-3&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | IP3
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| colspan="2" | &nbsp;
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RxDataSize'''
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | MAC Address
 |-
-| colspan="2" | This macro is used to detect the size of data collected by the Rx_data_available macro.&nbsp;
 |-
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | MAC0
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| colspan="2" | &nbsp;
-| width="90%" | Channel
 |-
-| colspan="2" | Specifies the communications channel 0-3&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | MAC1
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u16-icon.png]] - UINT
+| colspan="2" | &nbsp;
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''TxSendMyMAC'''
+| width="90%" | MAC2
 |-
-| colspan="2" | 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.&nbsp;
+| colspan="2" | &nbsp;
 |-
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | MAC3
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| colspan="2" | &nbsp;
-| width="90%" | Channel
 |-
-| colspan="2" | Specifies the communications channel 0-3&nbsp;
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | MAC4
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| colspan="2" | &nbsp;
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''CreateMACSocket'''
+| width="90%" | MAC5
+|-
+| colspan="2" | &nbsp;
 |-
-| colspan="2" | This macro creates a socket for sending and receiving Ethernet data using raw data.&nbsp;
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
 |-
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
-| width="90%" | Promiscuous
+| width="90%" | Label
 |-
-| colspan="2" | Receive everything (1) or just data bound for your MAC (0)&nbsp;
+| colspan="2" | &nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" | Broadcast
+| width="90%" | Sim Type
 |-
-| colspan="2" | Allows broadcast messages to be accepted (1) or rejected (0)&nbsp;
+| colspan="2" | Decides how to perform the simulation of the component. TCP IP - Communicates using the Windows TCP IP communications DLL SPI / API - Communicates using the CAL SPI to allow the communications to be analysed and debugged.&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
-| width="90%" | Error
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | SPI Simulation
 |-
-| colspan="2" | Allowsmessages with errors to be accepted (1) or rejected (0)&nbsp;
 |-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
+| width="90%" | Scope Traces
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
-|-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetMACAddress'''
-|-
-| colspan="2" | 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.&nbsp;
-|-
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | MAC0
-|-
-| colspan="2" | MAC Address Parameter&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | MAC1
-|-
-| colspan="2" | MAC Address Parameter&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | MAC2
-|-
-| colspan="2" | MAC Address Parameter&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | MAC3
-|-
-| colspan="2" | MAC Address Parameter&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | MAC4
-|-
-| colspan="2" | MAC Address Parameter&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | MAC5
-|-
-| colspan="2" | MAC Address Parameter&nbsp;
-|-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
-|-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetSubnetMask'''
-|-
-| colspan="2" | 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.&nbsp;
-|-
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP0
-|-
-| colspan="2" | First Byte of IP address&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP1
-|-
-| colspan="2" | Second Byte of IP address&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP2
-|-
-| colspan="2" | Third Byte of IP address&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP3
-|-
-| colspan="2" | Fourth Byte of IP address&nbsp;
-|-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
-|-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
-|-
-| colspan="2" | 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.&nbsp;
-|-
-|-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
-|-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetGateway'''
-|-
-| colspan="2" | 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.&nbsp;
-|-
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP0
-|-
-| colspan="2" | First Byte of IP address&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP1
-|-
-| colspan="2" | Second Byte of IP address&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP2
-|-
-| colspan="2" | Third Byte of IP address&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
-| width="90%" | IP3
-|-
-| colspan="2" | Fourth Byte of IP address&nbsp;
-|-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-==Property reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
-|-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
-|-
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Gateway0
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Gateway1
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Gateway2
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Gateway3
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Subnet0
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Subnet1
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Subnet2
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | Subnet3
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | IP0
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | IP1
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | IP2
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | IP3
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | MAC0
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | MAC1
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | MAC2
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | MAC3
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | MAC4
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
-| width="90%" | MAC5
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
-| width="90%" | Scope Traces
-|-
-| colspan="2" | Selects if the scope traces are automatically generated or not&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
-| width="90%" | Console Data
-|-
-| colspan="2" | Selects if the console data is automatically generated or not&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" | API
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" | Network Interface
-|-
-| colspan="2" | List of network interfaces connected to the PC.  Sets which interface we are communicating via.&nbsp;
-|-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Connections'''
-|-
-|-
-| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" | MIAC Industrial Addon
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" | Channel
-|-
-| colspan="2" | SPI Channel selector&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" | Prescale
-|-
-| colspan="2" | Prescale option selector&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
-| width="90%" | MOSI
-|-
-| colspan="2" | SPI Data Out Pin SDO - Also Known as Master Out Slave In (MOSI) when used in Master mode.&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
-| width="90%" | MISO
-|-
-| colspan="2" | SPI Data In Pin SDI - Also Known as Master In Slave Out (MISO) when used in Master mode.&nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
-| width="90%" | CLK
-|-
-| colspan="2" | SPI Clock Pin CLK - The Clock signal is driven by the SPI master.&nbsp;
 |-
-| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
+| colspan="2" | Selects if the scope traces are automatically generated or not&nbsp;
-| width="90%" | CS / SS
 |-
-| colspan="2" | 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. &nbsp;
+| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
+| width="90%" | Console Data
 |-
-| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
+| colspan="2" | Selects if the console data is automatically generated or not&nbsp;
-| width="90%" | Int Pin
 |-
-| colspan="2" | &nbsp;
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-|-
+| width="90%" | API
-| width="10%" align="center" | [[File:Fc9-type-5-icon.png]]
-| width="90%" | CS Pin
 |-
 | colspan="2" | &nbsp;
-|-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Simulations'''
-|-
-|-
-| width="10%" align="center" | [[File:Fc9-type-10-icon.png]]
-| width="90%" | Label
-|-
-| colspan="2" | &nbsp;
-|-
-| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
-| width="90%" | Sim Type
-|-
-| colspan="2" | Decides how to perform the simulation of the component. TCP IP - Communicates using the Windows TCP IP communications DLL SPI / API - Communicates using the CAL SPI to allow the communications to be analysed and debugged.&nbsp;
 |}