Socket Service Function Guide, Executing CMND490 | Omron CJ1W-ETN21

Socket Service Function Guide

Section 6-4

6-3-5 Differences with Previous Models

Compared with the socket service functions of previous models (CS1W- ETN01/11 and CJ1W-ETN11 Ethernet Units), the Number of Bytes Received at the TCP Socket that stores the size of received data accumulated in the reception buffer and a related Data Received Flag have been added. These new features eliminate the need for ladder programs to monitor the timing for completion of instructions and socket service processing, and thus reduce the amount of labor required for program development.

6-4 Socket Service Function Guide

6-4-1 Manipulating Dedicated Control Bits

■Description

The Ethernet Unit's socket services are used by setting parameters and manipulating bits only.

■Point

This method is used by setting the required parameters in the socket service parameter area allocated in the CPU Bus Unit words in the DM Area, and then turning ON the Socket Service Request Switches in memory.

■Advantages/Disadvantages

A total of eight ports (UDP and TCP combined) can be used for socket ser- vices.

6-4-2 Executing CMND(490)

■Description

The socket services are used by sending service request commands to the

Ethernet Unit.

■Point

A UDP or TCP socket service is requested by sending a FINS command to the Ethernet Unit by executing CMND(490) from the CPU Unit.

■Advantages/Disadvantages

•Knowledge of FINS commands is required.

•The previous user program can be used without changing because the functions are equivalent to those of CVM1/CV-series Ethernet Units.

•A total of 16 sockets, comprising eight TCP ports and eight UDP ports, can be used.

106

Image 130

Omron CJ1W-ETN21 Socket Service Function Guide, Differences with Previous Models, Manipulating Dedicated Control Bits

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 Commands Information on setting communications using CX-ProgrammerInformation on how to manage and use IP addresses Section Contents Manual Model Name Contents Number Relevant Manuals Xiii Xiv Read and Understand this Manual Application Considerations Disclaimers Xviii Notation of Unit Versions on Products Unit VersionsConfirming Unit Versions with Support Software Unit Version Notation Lowing table Precautions Safety Precautions General PrecautionsIntended Audience Safety Precautions Operating Environment Precautions Application Precautions Application Precautions Concepts Conformance to EC DirectivesApplicable Directives EMC Directives Section Functions Listed by Purpose Ethernet Unit Communications ServicesService Main functions Counterpart device Reference Acquired for the Ethernet Unit Table of Protocols Communications Protocol used Situation when used ReferenceUnit setting tag Section Contents Default Common Protocol SettingsSmtp 2 POP 3 DNS Section Section Mail Send Function Advantages Mail Send Function OverviewIntroduction Description Comparison with the Earlier Mail Send Function Mail Send Function DetailsMail Send Functions Compatibility with Earlier Models Contents of E-mail Body Following header information is included Trigger condition Text entered as subject Ethernet Unit information is always included in the e-mail Words value has changed Channel data has changed from XX toEthernet Unit Information Optional Information Attached File Details Error Log Information Status InformationExtension Content Memory Data 6,000 Words Max File Data 1 MB Max Summary of E-mail Body Information and Attached FilesData sent Body/Attached file Mail body Function Specifications Mail Send Function SpecificationsSpecifications Details of the Available Mail Triggers Using the Mail Send FunctionProcedure Classification Trigger type Setting Setting requirement Reference Settings Required for the Mail Send FunctionTransferring the settings data Unit Setup Using the Mail Send Function Mail Address Set up to 2 destination mail addressesSend Mail Data Sent by Mail When Required Data Sent in E-mail Body Send Mail Condition SettingsMail Address Specification Required Data Sent in an Attached File Send Mail Trigger Type Setting Required Attached File Name Send Mail Status Mail Send Function StatusSend Mail Status Mail Send Switch Bit 03 of n Mail Send Switch, Accessing Memory/Sending Mail FlagBit numbers Status IOM Format Accessing Memory/Sending Mail Flag Bit 01 of n+17Memory Data Formats TXT Format Attached File Transfer Times CSV Format Access Times for CS1 and CJ1 CPU Units Mail Send Function ErrorsIdentifying and Correcting Mail Send Function Errors Access Times for CS1-H and CJ1-H CPU Units Error Meaning Detailed error code Correction Troubleshooting Mail Send Errors with LED IndicatorsError Log Error Codes for the Mail Send Function Probable cause Correction Initial Server Settings Make the Unit Setup Settings from the CX-ProgrammerInitial Settings Example Example Application Destination Mail Address Setup Send Condition Setting Example Send e-mail when W300 bit 00 goes from OFF to on Transfer the CPU Bus Unit Setup SettingsAutomatic Transmission when Send Condition is Satisfied Send when there is a Change in the CPU Units Status Receive Mail Function Advantages Configuration of the MailMail Receive Function Overview Description Command Execution Results Table of Remote Mail CommandsCommand Parameters Attached File Data Specification Mail Receive Function SpecificationsReceived E-mail 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 Format Remote Mail Command DetailsCommand Format Response Format Function Command FormatFileWrite File Write Mounted in the CPU Unit FileRead File Read FileDelete File Delete Card mounted in the CPU Unit EM file memory or a Memory Card mounted in the CPU Unit FileList File List ReadResponse Format Details Command Format Details UMBackup User Memory BackupMemory or a Memory Card mounted in the CPU Unit 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 List FinsSend Fins Command SendResponse Response Status Description Code Mail Receive Function Status Accessing Memory/Receiving Mail FlagAccessing Memory/ Receiving Mail Flag Bit 02 of n+17 IOM Format TXT Format CSV Format Access Times for CS1 CJ1 CPU Units Access Times for CS1-H CJ1-H CPU Units Identifying and Correcting Mail Receive Function Errors Mail Receive Function ErrorsTroubleshooting Mail Receive Errors with LED Indicators Error code Meaning Detailed error code Correction Hex 1st byte 2nd byte Initial Settings for the Mail Receive Function DNS Server IP Address Setting DNS Tab, When RequiredItem name Example Reading Data from a CPU Unit Data Area Send Remote Mail CommandsBacking Up the CPU Units User Program Memory Card FTP Server Specifications Overview FTP Server Function Details Connecting to the FTP ServerFile Types Using the FTP Server Function FTP File Transfer Mode CX-Programmer Settings Setting conditions Tab List of Settings Required for the FTP Server FunctionSetup Tab Setting Details Default value FTP Server Application Example Confidential Using the Commands Using FTP CommandsTable of Commands Open Dir UserRename Pwd MkdirRmdir Cdup Mget TypeGet Put Close DeleteMdelete Bye Error Messages Error Messages and FTP StatusMessage Meaning Checking FTP Status FTP IndicatorFTP indicator Meaning FTP Status Flag File Names Using File MemoryFile Memory Directories File Names Handled by CPU Unit File type File name Extension Contents DescriptionUnit Memory Initialization method Initializing File Memory4 I/O Memory Data Format Data format Use of CRs and CR position Section 9ABC CS1-H CPU Units/CJ1-H CPU Units FTP File Transfer TimeCS1 CPU Units/CJ1 CPU Units File system Memory Card EM File Memory Enter the login name Unix Application Example Transfer the file RESULT.IOM to the workstation Change to the Memcard directoryChange data type to binary 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 Sntp Errors Automatic Clock Adjustment SwitchAutomatic Clock Adjustment Error Processing Automatic Clock Adjustment Switch Bit 04 of n Automatic Clock Adjustment Error Processing CPU Unit error Socket Services Page What are Sockets? Using Sockets with the Ethernet UnitOverview of Socket Communications from Ethernet Units Socket Port Numbers Opening TCP Sockets Protocol OverviewDifferences between TCP and UDP 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 Command code Name Using Socket Services with CMND490Specific Socket Service Functions Protocol Socket service request Manipulating Dedicated Control Bits Socket Service Function GuideDifferences with Previous Models Executing CMND490 CX-Programmer Setting Setting requirements Unit Setup Tab Using Socket Service FunctionsSettings Required for Socket Service Function Manipulating Dedicated Control Bits Setup Details Default value 109 CIO Area Allocations Socket Service StatusUDP/TCP Socket Status Ethernet Unit to CPU Unit Bit Switch Status Manipulated Unit operation DM Area Allocations TCP Connection Status Ethernet Unit to CPU Unit Application ProcedureProcedure Number Status Meaning Socket Services and Socket Status Precautions Error Evaluation Program Flow Socket Service Parameters UDP Socket Services Parameter SettingsUse of the parameters by the socket service TCP Socket Services UDP/TCP Socket No ParametersSocket Option Local UDP/TCP Port No Time Out Time Following specifications can be usedRemote UDP/TCP Port No Number of Bytes to Send/Receive Socket Service Request Switches Following diagram UDP Socket Receive Request Response CodesUDP Socket Open 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 Closing during Other Timing ChartsTCP Socket Close Request Processes Close Request Switch Force-close Switch Data Flow System Configuration8 TCP/IP Communications Programming Example Basic Operations DM Area Program Memory MapCIO 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 Socket Number Basic Fins Command FormatCommand Code Results Storage Area Socket Service Timing Chart Response Codes in the Command ResponseCommunications 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 UDP Socket Service Precautions in Using Socket ServicesUDP and TCP Socket Services TCP Socket Service Precautions in Using Socket Service Request Switches TCP Socket Services Using CMND490 CS/CJ CPU Units Maximum Transmission Delays Ignoring other Network DelaysCS-H/CJ-H 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 Response Frame Format Fins Command Frame FormatFins Frames Fins Header Information FINS/UDP Features FINS/UDP Method FINS/UDP Frame Format UDP Port Numbers for FINS/UDP Procedure for Using Designating Remote Addresses Sending Commands from a Host ComputerCommunications Parameters Used by Host Computer FINS/UDP Sample Program By sending a Fins command Memory Area READ, command codeMand, the command will be resent Operation Overview Sample Program 15 * FINS/UDP Communications Sample Program 169 170 FINS/TCP Features FINS/TCP Method TCP Port Number for FINS/TCP Frame FormatFINS/TCP Connection Numbers FINS/TCP Connection Status Word n+23 CommunicationsAge them in an internal table Automatic Allocation Procedure Automatic Allocation Fins Node Addresses 175 Setup Tab FINS/TCP Tab Fins Node Address Data Send Server to Client Command FINS/TCP Mode SpecificationsFins Node Address Data Send Client to Server Command FINS/TCP Headers Following table shows the list of error codes Fins Frame Send CommandError code Details Hexadecimal 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 Transmission Delay Maximum Transmission Delays Writing/Reading to CPU UnitWrite Command Delay Time Receive Processing Command CPU Bus Unit Service Cycle 704 ms Read Command Delay TimeTransmission Processing 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 Settings After Replacing a CPU MaintenanceSettings after Replacing an Ethernet Unit Replacing an Ethernet Unit Appendix E Items InspectionsTools Required for Inspection 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