INET_ATON block

Short summary

Name

INET_ATON

→POU type

→function

Category

more system blocks, network blocks, block with internal error diagnostic

Graphical interface

images/download/thumbnails/414780509/INET_ATON-version-1-modificationdate-1534501922413-api-v2.png

Available since

  • version 1.105.0 (for logi.CAD 3) and version 3.15.0 of logi.RTS
    images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/warning.svg This block is supported for these →target systems or platforms:

  • version 1.109.0 (for logi.CAD 3) and version 3.19.0 of logi.RTS
    images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/warning.svg This block is supported for these target systems or platforms:

    • Raspberry Pi, Revolution Pi

    • platform WindowsX86 (incl. the built-in PLC under Windows)

    • platform LinuxX86

Functionality

The block converts the Internet host address from the IPv4 numbers-and-dots notation into binary form (in network byte order).

Inputs, outputs, return value


Identifier

→Data type

Description

Inputs:

hostAddr

STRING

IPv4 address in dotted format (e.g. '127.0.0.1')

Outputs:

rc

UDINT

return code of the function call:

  • 16#00000000: The operation is successful.

  • 16#81000008: The IPv4 address is invalid.

Return value:

DWORD

returns IPv4 address in network byte order


Input EN and output ENO are available when →calling the block. See "Execution control: EN, ENO" for information on input EN and output ENO.

See:

Internal error diagnostic for block

The block checks the following error cases:

The IPv4 address is invalid.

In such an error case, the output ENO of the block is set to value FALSE (or an equivalent). Moreover, the output rc returns the appropriate code (see the above table).

Example for usage within ST-editor

See under UDP_Open block.

When creating your application within the ST-editor, enter a call of a block by typing the text as requested by the syntax or use Content Assist.