Parameter Settings, UDP Socket Services | Omron CJ1W-ETN21 manual

Using Socket Services by Manipulating Dedicated Control Bits

Section 6-7

Parameter Settings

The following table shows the parameters that are required for each service

and the use of the parameters by the socket service.

UDP Socket Services

Parameter

No. of

Range

Socket service

words

(decimal values in

UDP

UDP

UDP

UDP

parentheses)

open

receive

send

close

Socket option

1

Specified bit

---

---

---

---

UDP/TCP socket No.

0001 to 0008 hexadecimal

W

W

W

W

(1 to 8)

Local UDP/TCP port No.

1

0000 to FFFF hexadecimal

W

---

---

---

(0 to 65,535)

Remote IP address

2

00000000 to FFFFFFFF

---

R

W

---

hexadecimal

(0.0.0.0 to 255.255.255.255)

Remote UDP/TCP port No.

1

0000 to FFFF hexadecimal

---

R

W

---

(0 to 65,535)

Number of bytes to send/receive

1

0000 to 07C0 hexadecimal

---

RW

RW

---

(0 to 1,984 bytes)

Send/Receive data address

2

Memory area address

---

W

W

---

Time out time

1

0000 to FFFF hexadecimal

---

W

---

---

(Unit: 100 ms)

(0 to 65,535)

(0: No limit, 0.1 to 6,553.5 s)

Response code

1

---

R

R

R

R

Note

W:

Written by user

RW: Written by user at execution and then read for results at completion

R:

Read by user for results at completion

---:

Not used.

TCP Socket Services

Parameter

No. of

Range

Socket service

words

(decimal values in

TCP

TCP

TCP

TCP

TCP

parentheses)

passive

active

receive

send

close

open

open

Socket option

1

Specified bit

W

W

---

---

---

UDP/TCP socket No.

0001 to 0008 hexadecimal

W

W

W

W

W

(1 to 8)

Local UDP/TCP port No.

1

0000 to FFFF hexadecimal

W

RW

---

---

---

(0 to 65,535)

Remote IP address

2

00000000 to FFFFFFFF

RW

W

---

---

---

hexadecimal

(0.0.0.0 to 255.255.255.255

Remote UDP/TCP port

1

0000 to FFFF hexadecimal

RW

W

---

---

---

No.

(0 to 65,535)

Number of bytes to send/

1

0000 to 07C0 hexadecimal

---

---

RW

RW

---

receive

(0 to 1,984 bytes)

Send/Receive data

2

Memory area address

---

---

W

W

---

address

Time out time

1

0000 to FFFF hexadecimal

W

---

W

---

---

(Unit: 100 ms)

(0 to 65,535)

(0: No limit, 0.1 to 6,553.5 s)

Response code

1

---

R

R

R

R

R

Note

W:

Written by user

RW: Written by user at execution and then read for results at completion

116

Image 140

Omron CJ1W-ETN21 Parameter Settings, Use of the parameters by the socket service, UDP Socket Services, TCP Socket Services

Contents

Ethernet Units Construction of Applications Revised November Omron Product References  OmronPage Table of Contents FTP Server Index 207 Revision History 215 Table of Contents Information on setting communications using CX-Programmer Information on how to manage and use IP addressesCommands Section Contents Manual Model Name Contents Number Relevant Manuals Xiii Xiv Read and Understand this Manual Application Considerations Disclaimers Xviii Confirming Unit Versions with Support Software Unit VersionsNotation of Unit Versions on Products Unit Version Notation Lowing table Precautions Intended Audience General PrecautionsSafety Precautions Safety Precautions Operating Environment Precautions Application Precautions Application Precautions Conformance to EC Directives Applicable DirectivesConcepts EMC Directives Section Ethernet Unit Communications Services Service Main functions Counterpart device ReferenceFunctions Listed by Purpose Acquired for the Ethernet Unit Communications Protocol used Situation when used Reference Unit setting tagTable of Protocols Section Smtp Common Protocol SettingsContents Default 2 POP 3 DNS Section Section Mail Send Function Mail Send Function Overview IntroductionAdvantages Description Mail Send Functions Compatibility with Earlier Models Mail Send Function DetailsComparison with the Earlier Mail Send Function Contents of E-mail Body Following header information is included Trigger condition Text entered as subject Words value has changed Channel data has changed from XX to Ethernet Unit InformationEthernet Unit information is always included in the e-mail Optional Information Error Log Information Status Information Extension ContentAttached File Details Memory Data 6,000 Words Max Data sent Body/Attached file Mail body Summary of E-mail Body Information and Attached FilesFile Data 1 MB Max Specifications Mail Send Function SpecificationsFunction Specifications Using the Mail Send Function ProcedureDetails of the Available Mail Triggers Classification Trigger type Settings Required for the Mail Send Function Transferring the settings dataSetting Setting requirement Reference Unit Setup Using the Mail Send Function Send Mail Set up to 2 destination mail addressesMail Address Send Mail Condition Settings Mail Address Specification RequiredData Sent by Mail When Required Data Sent in E-mail Body Data Sent in an Attached File Send Mail Trigger Type Setting Required Attached File Name Send Mail Status Mail Send Function StatusSend Mail Status Bit numbers Status Mail Send Switch, Accessing Memory/Sending Mail FlagMail Send Switch Bit 03 of n Accessing Memory/Sending Mail Flag Bit 01 of n+17 Memory Data FormatsIOM Format TXT Format Attached File Transfer Times CSV Format Mail Send Function Errors Identifying and Correcting Mail Send Function ErrorsAccess Times for CS1 and CJ1 CPU Units Access Times for CS1-H and CJ1-H CPU Units Troubleshooting Mail Send Errors with LED Indicators Error Log Error Codes for the Mail Send FunctionError Meaning Detailed error code Correction Probable cause Correction Make the Unit Setup Settings from the CX-Programmer Initial Settings ExampleInitial Server Settings Example Application Destination Mail Address Setup Send Condition Setting Transfer the CPU Bus Unit Setup Settings Automatic Transmission when Send Condition is SatisfiedExample Send e-mail when W300 bit 00 goes from OFF to on Send when there is a Change in the CPU Units Status Receive Mail Function Configuration of the Mail Mail Receive Function OverviewAdvantages Description Table of Remote Mail Commands Command ParametersCommand Execution Results Attached File Data Received E-mail Mail Receive Function SpecificationsSpecification Response E-mail Using the Mail Receive Function Settings Required for the Mail Receive Function Tion Posting Mail Address Protection Setting Receive Mail Tab Receive Attached File Setting Receive Command Setting Remote Mail Command Details Command FormatFormat Response Format Command Format FileWrite File WriteFunction Mounted in the CPU Unit FileRead File Read FileDelete File Delete Card mounted in the CPU Unit Response Format Details FileList File List ReadEM file memory or a Memory Card mounted in the CPU Unit Memory or a Memory Card mounted in the CPU Unit UMBackup User Memory BackupCommand Format Details PARAMBackup Parameter Area Backup Or a Memory Card mounted in the CPU Unit IOMWrite I/O Memory Write Units I/O memory. The data is written in word units Subject Body IOMRead I/O Memory Read Units ReIOMRead ChangeMode Operating Mode Change Changes the CPU Units operating mode ErrorLogRead Error Log Read Bus Unit or Special I/O Unit ErrorLogClear Error Log Clear Since power was turned on or the mail log was cleared MailLogRead Mail Log Read MailLogClear Mail Log Clear Net Unit Test Mail Test Response Response Status Description Code FinsSend Fins Command SendResponse List Accessing Memory/Receiving Mail Flag Accessing Memory/ Receiving Mail Flag Bit 02 of n+17Mail Receive Function Status IOM Format TXT Format CSV Format Access Times for CS1 CJ1 CPU Units Access Times for CS1-H CJ1-H CPU Units Troubleshooting Mail Receive Errors with LED Indicators Mail Receive Function ErrorsIdentifying and Correcting Mail Receive Function Errors Error code Meaning Detailed error code Correction Hex 1st byte 2nd byte Item name Example DNS Server IP Address Setting DNS Tab, When RequiredInitial Settings for the Mail Receive Function Backing Up the CPU Units User Program Memory Card Send Remote Mail CommandsReading Data from a CPU Unit Data Area FTP Server Specifications Overview File Types Connecting to the FTP ServerFTP Server Function Details Using the FTP Server Function FTP File Transfer Mode List of Settings Required for the FTP Server Function Setup TabCX-Programmer Settings Setting conditions Tab Setting Details Default value FTP Server Application Example Confidential Using FTP Commands Table of CommandsUsing the Commands Open Rename UserDir Mkdir RmdirPwd Cdup Type GetMget Put Delete MdeleteClose Bye Message Meaning Error Messages and FTP StatusError Messages FTP Indicator FTP indicator MeaningChecking FTP Status FTP Status Flag Using File Memory File MemoryFile Names Directories Unit File type File name Extension Contents DescriptionFile Names Handled by CPU Unit Initializing File Memory 4 I/O Memory Data FormatMemory Initialization method Data format Use of CRs and CR position Section 9ABC FTP File Transfer Time CS1 CPU Units/CJ1 CPU UnitsCS1-H CPU Units/CJ1-H CPU Units File system Memory Card EM File Memory Enter the login name Unix Application Example Change to the Memcard directory Change data type to binaryTransfer the file RESULT.IOM to the workstation Write the file PLAN.IOM to the Memory Card Section Automatic Clock Adjustment Function Overview CPU Unit Conditions Using the Automatic Clock Adjustment Function Settings Required for Automatic Clock Adjustment Function Settings Setting conditions Reference Auto Adjust Time Automatic Clock Adjustment Switch Automatic Clock Adjustment Error ProcessingAutomatic Clock Adjustment Sntp Errors Automatic Clock Adjustment Switch Bit 04 of n Automatic Clock Adjustment Error Processing CPU Unit error Socket Services Page Using Sockets with the Ethernet Unit Overview of Socket Communications from Ethernet UnitsWhat are Sockets? Socket Port Numbers Protocol Overview Differences between TCP and UDPOpening TCP Sockets TCP Communications TCP Communications Procedure Passive Open and Active Open Fragmentation of Send Data Socket Service Functions Using Socket Services with Socket Service Request Switches Protocol Socket Service Request CMND490 Using Socket Services with CMND490 Specific Socket Service FunctionsCommand code Name Protocol Socket service request Socket Service Function Guide Differences with Previous ModelsManipulating Dedicated Control Bits Executing CMND490 Using Socket Service Functions Settings Required for Socket Service FunctionCX-Programmer Setting Setting requirements Unit Setup Tab Manipulating Dedicated Control Bits Setup Details Default value 109 UDP/TCP Socket Status Ethernet Unit to CPU Unit Socket Service StatusCIO Area Allocations Bit Switch Status Manipulated Unit operation DM Area Allocations Application Procedure ProcedureTCP Connection Status Ethernet Unit to CPU Unit Number Status Meaning Socket Services and Socket Status Precautions Error Evaluation Program Flow Socket Service Parameters Parameter Settings Use of the parameters by the socket serviceUDP Socket Services TCP Socket Services Parameters Socket OptionUDP/TCP Socket No Local UDP/TCP Port No Following specifications can be used Remote UDP/TCP Port NoTime Out Time Number of Bytes to Send/Receive Socket Service Request Switches Following diagram Response Codes UDP Socket Open RequestUDP Socket Receive Request Response Meaning Code UDP Socket Send Request UDP Socket Close Request TCP Socket Passive Open Request TCP Socket Active Open Request TCP Socket Receive Request Drinuse TCP Socket Send Request Timing Charts TCP Socket Close RequestClosing during Other Processes Close Request Switch Force-close Switch System Configuration 8 TCP/IP Communications Programming ExampleData Flow Basic Operations CIO Area Program Memory MapDM Area Programming Example TCP Passive Open 130 Programming example uses the following system configuration 9 UDP/IP Communications Programming Example Tion on errors CIO 000000 is turned on to request opening a UDP socket from 133 134 135 Using Socket Services with CMND490 Using Socket Service 137 Basic Fins Command Format Command CodeSocket Number Results Storage Area Response Codes in the Command Response Communications Timing ChartSocket Service Timing Chart Response Codes in the Results Storage Areas 140 System Configuration Close Request during Receive Request Data Flow Basic Operations Program Memory Maps Are structured 144 145 146 147 148 149 150 151 152 153 154 Precautions in Using Socket Services UDP and TCP Socket ServicesUDP Socket Service TCP Socket Service Precautions in Using Socket Service Request Switches CS-H/CJ-H CPU Units Maximum Transmission Delays Ignoring other Network DelaysTCP Socket Services Using CMND490 CS/CJ CPU Units Calculation Using Fins Communications to Create Host Applications Overview of Fins Communications Communications On an Ethernet Network Using the FINS/UDP and FINS/TCP Methods Fins Communications Service Specifications for Ethernet Fins Command Frame Format Fins FramesFins Response Frame Format Fins Header Information FINS/UDP Features FINS/UDP Method FINS/UDP Frame Format UDP Port Numbers for FINS/UDP Procedure for Using Communications Parameters Used by Host Computer Sending Commands from a Host ComputerDesignating Remote Addresses By sending a Fins command Memory Area READ, command code Mand, the command will be resentFINS/UDP Sample Program Operation Overview Sample Program 15 * FINS/UDP Communications Sample Program 169 170 FINS/TCP Features FINS/TCP Method FINS/TCP Connection Numbers FINS/TCP Frame FormatTCP Port Number for Age them in an internal table CommunicationsFINS/TCP Connection Status Word n+23 Automatic Allocation Procedure Automatic Allocation Fins Node Addresses 175 Setup Tab FINS/TCP Tab FINS/TCP Mode Specifications Fins Node Address Data Send Client to Server CommandFins Node Address Data Send Server to Client Command FINS/TCP Headers Error code Details Hexadecimal Fins Frame Send CommandFollowing table shows the list of error codes Fins Frame Send Error Notification Command Command Connection Sequence Normal Operation Error Connection Sequence ACK FIN 182 183 From onwards, the connection is established again Host computer Remote node FINS/TCP Sample Program 186 187 188 189 190 191 Maximum Transmission Delays Writing/Reading to CPU Unit Write Command Delay TimeTransmission Delay Receive Processing Command CPU Bus Unit Service Cycle Read Command Delay Time Transmission Processing704 ms Response 194 Ethernet Network Parameters Parameter Value Description Appendix a Buffer Configuration Appendix B Network Memory TCP Status Transitions Status Meaning Appendix C Ascii Characters Space Appendix D Maintenance Settings after Replacing an Ethernet UnitSettings After Replacing a CPU Replacing an Ethernet Unit Appendix E Tools Required for Inspection InspectionsItems Appendix F Numerics Index 209 210 211 212 213 214 Revision code Date Revised content Revision History Revision History Omron Corporation Control Devices Division H.Q Regional Headquarters Authorized Distributor