Page Comparison

...

Set the Vendor ID of this EtherNet/IP stack instance. The vendor ID is assigned by the ODVA.

Default Value: 1114

goal_eipCfgVendorIdSet parameters

Table: goal_eipCfgVendorIdSet parameters

res = goal_eipCfgVendorIdSet(1114);

goal_eipCfgDeviceTypeSet

Set the Device Type of this EtherNet/IP stack instance. Valid values are defined by the CIP specification.

Default Value: 0x2B

goal_eipCfgDeviceTypeSet parameters

Table: goal_eipCfgDeviceTypeSet parameters

res = goal_eipCfgDeviceTypeSet(0x2B);

goal_eipCfgProductCodeSet

Set the Product Code of this EtherNet/IP stack instance. This value is defined by the device vendor.

Default Value: 1goal_eipCfgProductCodeSet parameters

Table: goal_eipCfgProductCodeSet parameters

res = goal_eipCfgProductCodeSet(0xABCD);

goal_eipCfgRevisionSet

Set the Revision of the EtherNet/IP stack instance. The revision consists of a major and a minor number. It represents changes in the firmware that affect the device’s behaviour.

Default Value: 1.1

goal_eipCfgRevisionSet parameters

Table: goal_eipCfgRevisionSet parameters

res = goal_eipCfgRevisionSet(1, 3);

goal_eipCfgSerialNumSet

Set the Serial Number of the EtherNet/IP stack instance. This number is assigned by the vendor and should be unique for each device.

Default Value: 1

goal_eipCfgSerialNumSet parameters

...

Table: res = goal_eipCfgRevisionSet(1, 3);

res = goal_eipCfgSerialNumSet(12345678);

goal_eipCfgProductNameSet

...

Default Value: “EtherNet/IP Adapter”goal_eipCfgProductNameSet parameters

Table: goal_eipCfgProductNameSet parameters

res = goal_eipCfgProductNameSet("EtherNet/IP Adapter");

goal_eipCfgDomainNameSet

Set the default Domain Name of the EtherNet/IP stack instance. This name is used as the device’s domain name if no valid configuration was found. Its maximum length is 48 characters.

Default Value: “port.de”

goal_eipCfgDomainNameSet parameters

Table: goal_eipCfgDomainNameSet parameters

res = goal_eipCfgDomainNameSet("example.org");

goal_eipCfgHostNameSet

Set the default Host Name of the EtherNet/IP stack instance. This name is used as the device’s host name if no valid configuration was found. Its maximum length is 64 characters.

Default Value: “eipdevice”

goal_eipCfgHostNameSet parameters

Table: goal_eipCfgHostNameSet parameters

res = goal_eipCfgHostNameSet("example_device");

goal_eipCfgNumExplicitConSet

Set the maximum number of explicit Connections the device can handle at once.

Default Value: 6goal_eipCfgNumExplicitConSet parameters

Table: goal_eipCfgNumExplicitConSet parameters

res = goal_eipCfgNumExplicitConSet(10);

goal_

...

eipCfgNumImplicitConSet

Set the maximum number of implicit Connections the device can handle at once.

Default Value: 6goal_eipCfgNumImplicitConSetImpl parameters

Table: goal_eipCfgNumImplicitConSet parameters

res = goal_

...

eipCfgNumImplicitConSet(10);

goal_eipCfgEthLinkCountersOn

Enable support for Ethernet Link attributes 4, 5, 12 and 13. THe The hardware must support the appropriate counters.

Default Value: GOAL_TRUE

goal_eipCfgEthLinkCountersOn parameters

Table: goal_eipCfgEthLinkCountersOn parameters

res = goal_eipCfgEthLinkCountersOn(GOAL_TRUE);

goal_eipCfgEthLinkControlOn

Enable support for Ethernet Link attribute 6. The hardware must support forced link speeds and duplex modes.

Default Value: GOAL_TRUE

goal_eipCfgEthLinkControlOn parameters

Table: goal_eipCfgEthLinkControlOn parameters

res = goal_eipCfgEthLinkControlOn(GOAL_TRUE);

goal_eipCfgChangeEthAfterResetOn

A change of Ethernet link speeds or duplex modes requires a reset of the device. The hardware must support forced link speeds and duplex modes.

Default Value: GOAL_FALSE

goal_eipCfgChangeEthAfterResetOn parameters

Table: goal_eipCfgChangeEthAfterResetOn parameters

res = goal_eipCfgChangeEthAfterResetOn(GOAL_FALSE);

goal_eipCfgChangeIpAfterResetOn

A change of the IP address requires a reset of the device.

Default Value: GOAL_FALSEgoal_eipCfgChangeIpAfterResetOn parameters

Table: goal_eipCfgChangeIpAfterResetOn parameters

res = goal_eipCfgChangeIpAfterResetOn(GOAL_FALSE);

goal_eipCfgNumSessionsSet

Set the number of Encapsulation sessions the device can handle at once.

Default Value: 20goal_eipCfgNumSessionsSet parameters

Table: goal_eipCfgNumSessionsSet parameters

res = goal_eipCfgNumSessionsSet(10);

goal_eipCfgTickSet

Set the number of milliseconds of one tick. The stack uses a tick as the smallest unit of time.

Default Value: 10

goal_eipCfgTickSet parameters

...

Parameter

...

Description

...

uint32_t ticks

...

size of 1 tick in ms

res = goal_eipCfgTickSet(10);

...

Info
This function is deprecated and has no effect. It is kept for compatibility with older versions.

goal_eipCfgO2TRunIdleHeaderOn

Default Value: GOAL_TRUE

Enable the Run/Idle Header for consumed (Originator-to-Target) cyclic data.

goal_eipCfgO2TRunIdleHeaderOn parameters

Table: goal_eipCfgO2TRunIdleHeaderOn parameters

res = goal_eipCfgO2TRunIdleHeaderOn(GOAL_TRUE);

goal_eipCfgT2ORunIdleHeaderOn

Enable the Run/Idle Header for produced (Target-to-Originator) cyclic data.

Default Value: GOAL_FALSE

goal_eipCfgT2ORunIdleHeaderOn parameters

Table: goal_eipCfgT2ORunIdleHeaderOn parameters

res = goal_eipCfgT2ORunIdleHeaderOn(GOAL_FALSE);

goal_eipCfgQoSOn

Enable support of the QoS object.

Default Value: GOAL_TRUE

goal_eipCfgQoSOn parameters

Table: goal_eipCfgQoSOn parameters

res = goal_eipCfgQoSOn(GOAL_TRUE);

goal_eipCfgNumDelayedEncapMsgSet

Set the number of Encapsulation messages that can be delayed at the same time.

Default Value: 2

goal_eipCfgNumDelayedEncapMsgSet parameters

Table: goal_eipCfgNumDelayedEncapMsgSet parameters

res = goal__eipCfgNumDelayedEncapMsgSet(2);

goal_eipCfgDhcpOn

Enable the DHCP client if it is supported by the platform.

Default Value: GOAL_FALSEgoal_eipCfgDhcpOn parameters

Table: goal_eipCfgDhcpOn parameters

res = goal_eipCfgDhcpOn(GOAL_TRUE);

goal_eipCfgDlrOn

Enable support of the DLR object. THis This feature requires the DLR stack and support of the hardware.

Default Value: GOAL_FALSE

Table: goal_eipCfgDlrOn parameters

res = goal_eipCfgDlrOn(GOAL_TRUE);

goal_eipCfgAcdOn

Enable support for Address Conflict Detection (ACD).

Default Value: GOAL_FALSE

Table: goal_eipCfgAcdOn

res = goal_

...

eipCfgAcdOn(GOAL_TRUE);

goal_eipCfgAcdConflictFallbackIp

Configure Fallback IP Configuration, if Address Conflict Detection (ACD) detects an address conflict. The device will apply the configured IP, if it’s configured as device with static IP. If attribute 3 of the TCP/IP Class is set to DHCP, the device will start the DHCP process after a fixed timeout.

• Transit into error state and do nothing: pass ipAddress, subnetMask and gateway = 0,

• Set fallback IP configuration: pass valid IP configuration.

Table: goal_eipCfgAcdConflictBehavior

uint32_t ipAddress = GOAL_NET_IPV4(192, 168, 0, 100);
uint32_t subnetMask = GOAL_NET_IPV4(255, 255, 255, 0);
uint32_t gateway = GOAL_NET_IPV4(192, 168, 0, 1);

res = goal_eipCfgAcdConflictFallbackIp(ipAddress, subnetMask, gateway);