Topic: DMD0070

SETUPIP - Setup TCP/IP Parameters

The Setup TCP/IP Parameters (SETUPIP) instruction is used to configure the TCP/IP networking parameters for the onboard Ethernet port of an Do-more controller or the Ethernet port of an ECOM100 module.

 

Note: this instruction writes to the ROM in the controller. As such, this instruction may take several seconds of time to complete.

 

Note: it is important that this instruction NOT be executed more than is necessary because the ROM chip in the Do-more controller has a limited number (~100K) of write cycles.

 

Parameters:

Note: Use the F9 key (Element Browser) or Down-Arrow key (Auto-Complete) at any time to see a complete list of the memory locations that are valid in the current field of the instruction.

 

Ethernet Device - selects which Ethernet device to configure

 

no devices available - indicates that there are no Devices that can execute this instruction. The most likely cause is the CPU does not have an onboard Ethernet port or there is no ECOM100 module in the base.

 

    • create device - select this option to invoke the Device Configuration dialog of the System Configuration to create a new device of the appropriate type

 

IP Address - selects how the IP Address will be set

 

  • Fixed - the IP Address is entered as 4 separate decimal numbers, each one ranging from 0 to 255.

    Addresses 0.0.0.0, 127.0.0.1, and 255.255.255.255 are not allowed.

    Note:     Invoking the Element Browser (F9) for this field will bring up the IP Address Lookup utility that can find the IP Address for a given name.
     

  • Variable - the IP address resides in the specified memory location. This can be any readable DWord numeric location. The Hexadecimal equivalent of each octet of the IP Address is stored in a byte of the Variable location, in reverse order, for example: IP Address 192.168.000.006 in Hex would be C0.A8.00.06, and stored in the Variable location as 0600A8C0.

 

Subnet Mask - selects how the Subnet Mask will bet set

 

  • Fixed - the Subnet Mask is entered as 4 separate decimal numbers, each one ranging from 0 to 255.

    Addresses 0.0.0.0, and 255.255.255.255 are not allowed.
     

  • Variable - the Subnet Mask resides in the specified memory location. This can be any readable DWord numeric location. The Hexadecimal equivalent of each octet of the IP Address is stored in a byte of the Variable location, in reverse order, for example: IP Address 255.255.224.000 in Hex would be FF.FF.E0.00, and stored in the Variable location as 00E0FFFF..

 

Gateway Address - selects how the Gateway Address will be set

 

  • Fixed - the Gateway Address is entered as 4 separate decimal numbers, each one ranging from 0 to 255.

    Addresses 127.0.0.1, and 255.255.255.255 are not allowed.

    Note:     Invoking the Element Browser (F9) for this field will bring up the IP Address Lookup utility that can find the IP Address for a given Gateway name.
     

  • Variable - the Gateway address resides in the specified memory location. This can be any readable DWord numeric location. The Hexadecimal equivalent of each octet of the IP Address is stored in a byte of the Variable location, in reverse order, for example: IP Address 192.168.000.001 in Hex would be C0.A8.00.01, and stored in the Variable location as 0100A8C0.

 

On Success: - designates one of the following two options if the Setup TCP/IP Parameters operation is successful:

 

  • SET BIT - The specific BIT location will be SET OFF when the Setup TCP/IP Parameters (SETUPIP) instruction is first enabled, and then SET ON if the operation is successful. This value can be any writable bit location.
     

  • JMP to Stage - JMP to the specified Stage. The target Stage must be in the same Program as the Setup TCP/IP Parameters (SETUPIP) instruction, you cannot specify a Stage in a different Program. This selection will function the same as a standalone Jump to Stage instruction. Click here for more information on the Jump To Stage instruction.

 

On Error: - designates one of the following two options if the Setup TCP/IP Parameters operation is unsuccessful:
 

  • SET BIT - The specific BIT location will be SET OFF when the Setup TCP/IP Parameters (SETUPIP) instruction is first enabled, and then SET ON if the operation is unsuccessful. This value can be any writable bit location.
     

  • JMP to Stage - JMP to the specified Stage. The target Stage must be in the same Program as the Setup TCP/IP Parameters (SETUPIP) instruction, you cannot specify a Stage in a different Program. This selection will function the same as a standalone Jump to Stage instruction. Click here for more information on the Jump To Stage instruction.

 

Status Display:

The red triangle in the upper left corner of the status display indicates this is a Fully Asynchronous instruction.

 

The gray triangle at the right end of the input leg indicates the input is edge triggered.

 

See Also:

 

Example Using Stages:

 

Rung Example: