Anybus CompactCom 40 Common Ethernet Скачать руководство пользователя страница 42

Страница: 42 / 106

Server Side Include (SSI)

40 (104)

8.4

Argument Functions

8.4.1

General Information

Argument functions are supplied as parameters to certain command functions.

General Syntax:

(Syntax depends on context)

Argument Functions:

Function

Description

ABCCMessage()

8.4.2

ABCCMessage()

This function issues an object request towards an object in the module or in the host application.

Syntax

ABCCMessage(object, instance, command, ce0, ce1,

msgdata, c_type, r_type)

object

Specifies the Destination Object

instance

Specifies the Destination Instance

command

Specifies the Command Number

ce0

Specifies CmdExt[0] for the command message

ce1

Specifies CmdExt[1] for the command message

msgdata

Specifies the actual contents of the MsgData[] subfield in the command

•

Data can be supplied in direct form (format depends on c_type)

•

The keyword “ARG” is used when data is supplied by the parent command (e.g.
scanf()).

c_type:

Specifies the data type in the command (msgdata), see below.

r_type:

Specifies the data type in the response (msgdata), see below.

Numeric input can be supplied in the following formats:

Decimal (e.g. 50)

(no prefix)

Octal (e.g. 043)

Prefix 0 (zero)

Hex (e.g. 0x1f)

Prefix 0x

Anybus

CompactCom

™

40 Common Ethernet Design Guide

HMSI-27–269 2.1

Содержание CompactCom 40 Common Ethernet

Страница 1: ...Anybus CompactCom 40 Common Ethernet DESIGN GUIDE HMSI 27 269 2 1 ENGLISH...

Страница 2: ...odes and standards HMS Industrial Networks AB will under no circumstances assume liability or responsibility for any problems that may arise as a result from the use of undocumented features timing or...

Страница 3: ...ation 8 3 1 General Information 8 3 2 Software Requirements 8 3 3 Device Customization 8 3 4 Communication Settings 9 3 5 Diagnostics 11 3 6 Network Data Exchange 11 3 7 File System 11 4 Firmware Down...

Страница 4: ...work Object 03h 57 10 5 Network Configuration Object 04h 58 10 6 Socket Interface Object 07h 65 10 7 SMTP Client Object 09h 82 10 8 Anybus File System Interface Object 0Ah 87 10 9 Network Ethernet Obj...

Страница 5: ...Design Guide HMSI 27 269 2 1 Table of Contents D Technical Specification 98 D 1 Front View 98 D 2 Functional Earth FE Requirements 99 D 3 Power Supply 99 D 4 Environmental Specification 99 D 5 EMC Co...

Страница 6: ...This page intentionally left blank...

Страница 7: ...their implementation in such a way that this is not necessary For additional related documentation and file downloads please visit the support website at www anybus com support 1 2 Related Documents...

Страница 8: ...t or to avoid a network security risk Caution This instruction must be followed to avoid a risk of personal injury WARNING This instruction must be followed to avoid a risk of death or serious injury...

Страница 9: ...ear as a vendor specific implementation rather than a generic Anybus module This product conforms to all aspects of the host interface for Anybus CompactCom 40 modules defined in the Anybus CompactCom...

Страница 10: ...he command Get_Instance_Number_By_ Order Application Data Object FEh is implemented in the host application For in depth information regarding the Anybus CompactCom 40 software interface consult the g...

Страница 11: ...n See also Socket Interface Object 07h p 65 Message Segmentation p 80 3 4 Communication Settings As with other Anybus CompactCom products network related communication settings are grouped in the Netw...

Страница 12: ...mented Yes No Use default value for IP address bytes 0 2 192 168 0 X Use DIP switch settings for IP address byte 3 End Use attribute 17 values for IP address bytes 0 2 IP address is stored in Network...

Страница 13: ...pactCom 40 Common Ethernet has an in built file system that can be ac cessed from the application and from the network Three directories are predefined VFS The virtual file system that e g holds the w...

Страница 14: ...Application File system File A1 File A2 Directory A1 File A1 1 File A1 2 The Anybus CompactCom accesses the application file system through the Application File System Interface Object Anybus Compact...

Страница 15: ...me included See also FTP Server p 16 Web Server p 18 E mail Client p 24 Server Side Include SSI p 25 Anybus File System Interface Object 0Ah p 87 Application File System Interface Object EAh p 90 The...

Страница 16: ...d find the module 4 Click the Firmware Repository icon in the menu to open the Firmware Repository window Drag the firmware folder into the window to add the new firmware to the repository Close the F...

Страница 17: ...ile system can be accessed through FTP or via the File System Interface Object The next time the module is started the new firmware will be installed After the firmware is installed the firmware file...

Страница 18: ...eir home directory File Format User1 Password1 Homedirectory1 User2 Password2 Homedirectory2 User3 Password3 Homedirectory3 Optionally the UserN PasswordN section can be replaced by a path to a file c...

Страница 19: ...only It is strongly recommended to have at least one user with root access permission If not Admin Mode must be enabled each time a system file needs to be altered including ftp cfg 5 3 Session Examp...

Страница 20: ...k configuration parameters Network status information Access to the host application ADIs The default web pages are built of files stored in a virtual file system accessible through the vfs folder The...

Страница 21: ...ce for changing TCP IP and SMTP settings in the Network Configuration Object Fig 5 Fig 6 The module needs to be reset for the TCP IP and SMTP settings to take effect The Ethernet Configuration setting...

Страница 22: ...IP address or name Max 64 characters User Max 64 characters Password Max 64 characters Confirm password 6 2 2 Ethernet Statistics Page The Ethernet statistics web page contains the following informati...

Страница 23: ...on of an interface fails due to an internal MAC sublayer receive error MAC Transmit Errors Frames for which transmission fails due to an internal MAC sublayer re ceive error Carrier Sense Errors Times...

Страница 24: ...WebRoot with the web root directory specified in http cfg If no index page is found the module will default to the virtual index file if enabled See also Default web pages 6 3 3 Default Content Types...

Страница 25: ...pproved users can optionally be redirected to one or several other files If the list of approved users is put in another file be aware that this file can be accessed and read from the network In the f...

Страница 26: ...How to Send E mail Messages To be able to send e mail messages the SMTP account settings must be specified This includes A valid SMTP server address A valid username A valid password To send an e mail...

Страница 27: ...tion includes the contents of a file The content is scanned for SSI This function cannot be used in e mail messages Syntax include file filename filename Source file Scenario Default Output Success co...

Страница 28: ...yN valueN Syntax exec cmd_argument GetConfigItem filename key separator filename Source file to read from key Source key in file separator Optional specifies line separation characters e g br default...

Страница 29: ...ple The following SSI exec cmd_argument GetConfigItem example cnf B in combination with the following file example cnf A First B Second C Third returns the string Third Anybus CompactCom 40 Common Eth...

Страница 30: ...nderscore will not be stored Syntax exec cmd_argument SetConfigItem filename Overwrite filename Destination file If the specified file does not exist it will be created provided that the path is valid...

Страница 31: ...T type text name _Age BR BR LABEL for Food Food LABEL BR INPUT type radio name Food value Cheese Cheese BR INPUT type radio name Food value Sausage Sausage BR BR LABEL for Drink Drink LABEL BR INPUT t...

Страница 32: ...n Example The following example illustrates how to use this command exec cmd_argument SsiOutput Parameter stored Error exec cmd_argument SetConfigItem File cfg Overwrite See also SSI Output Configurat...

Страница 33: ...ut Scenario Default Output Success Language changed Error Failed to change language Example The following example demonstrates how to use this function The resulting page sends a form to itself which...

Страница 34: ...o Default Output Success file contents Authentication Error Authentication error File Open Error Failed to open file filename Example The following example demonstrates how to use this function HTML H...

Страница 35: ...ver Side Include SSI 33 104 When viewed in a browser the resulting page should look somewhat as follows Fig 7 See also Include File p 25 Anybus CompactCom 40 Common Ethernet Design Guide HMSI 27 269 2...

Страница 36: ...will be created provided that the path is valid source Optional by specifying a form object only data from that particular form object will be stored Default behavior is to store data from all form o...

Страница 37: ...rwrite FORM action test shtm P LABEL for Fruit Fruit LABEL BR INPUT type text name Fruit BR BR LABEL for Meat Meat LABEL BR INPUT type text name Meat BR BR LABEL for Meat Bread LABEL BR INPUT type tex...

Страница 38: ...are substituted by subsequent arguments and format ted as requested The number of format tags must match the number of arguments if not the result is undefined See section Formatting Tags below for mo...

Страница 39: ...of spaces For e E and f forces the number to include a decimal point even if no digits follow For x and X prefixes 0x or 0X respectively Width Optional Width Meaning number Specifies the minimum numb...

Страница 40: ...object from which the string shall be extracted template Template which specifies how to parse and interpret the data May contain any number of formatting tags which determine the conversion prior to...

Страница 41: ...a decimal ra tional number followed by an exponent field which con sists of an E or an e followed by an integer FLOAT n Consumes no input the corresponding argument is an integer into which scanf wri...

Страница 42: ...he Destination Instance command Specifies the Command Number ce0 Specifies CmdExt 0 for the command message ce1 Specifies CmdExt 1 for the command message msgdata Specifies the actual contents of the...

Страница 43: ...e In such case the actual data type returned from the function will be STRING Syntax BOOL true false For arrays the format will be BOOL n true false SINT8 Yes SINT16 Yes SINT32 Yes UINT8 Yes This type...

Страница 44: ...bit integers Example Set_Attribute This example shows how to set the IP address using scanf and ABCCMessage Note the special parameter value ARG which instructs the module to use the passed form data...

Страница 45: ...bject 4 Unsupported instance 5 Unsupported command 6 Invalid CmdExt 0 7 Invalid CmdExt 1 8 Attribute access is not set able 9 Attribute access is not get able 10 Too much data in msg data field 11 Not...

Страница 46: ...n error string 3 File write error string Use s to include the name of the file IncludeFile_X 0 Success string 1 Authentication error string 2 File read error string Use s to include the name of the fi...

Страница 47: ...as UTF 8 en coded while all other HTTP requests will be interpreted as ISO 8859 1 encoded All JSON re sponses sent by the module are UTF 8 encoded while all other files sent by the web server are enco...

Страница 48: ...up to count ADIs starting from offset in a list sorted by ADI order number This data is static during runtime Optionally a callback may be passed to the GET request for JSONP output Name Data Type Not...

Страница 49: ...json POSTadi update json form data inst instance value data elem element callback function Updates the value of an ADI for the specified ADI instance instance The value data shall be hex formatted see...

Страница 50: ...String 32 bit hex ASCII fwver Array of Number major minor build uptime Array of Number high low milliseconds ms cpuload Number CPU load in JSON object layout modulename ABCC M40 serial ABCDEF00 fwver...

Страница 51: ...below comm2 Object See object definition in the table below Comm Object Definition Name Data Type Note link Number 0 No link 1 Link speed Number 0 10 Mbit 1 100 Mbit duplex Number 0 Half 1 Full JSON...

Страница 52: ...ateway String dns1 String dns2 String hostname String domainname String dhcp 0 addr 192 168 0 55 subnet 255 255 255 0 gateway 192 168 0 1 dns1 10 10 55 1 dns2 10 10 55 2 hostname hostname domainname h...

Страница 53: ...frames which experienced ex actly one collision multicoll Number Successfully transmitted frames which experienced more than one collision latecoll Number Number of collisions detected later than 512...

Страница 54: ...t identifier bacnetapl title BACnet APL Statistics Get network specific statistics GET network nwstats json get ID ID is an identifier value returned from the previous command eip for example name Est...

Страница 55: ...PU load from the module and presents it on the web page The file containing this code has to be stored in the built in file system and the result can be seen in a common browser html head title Anybus...

Страница 56: ...Objects Anybus Object 01h p 55 Diagnostic Object 02h p 56 Network Object 03h p 57 Network Configuration Object 04h p 58 Network Specific Objects Socket Interface Object 07h p 65 SMTP Client Object 09...

Страница 57: ...urther information Instance Attributes Instance 1 Basic Name Access Type Value 1 Module type Get UINT16 0403h Standard Anybus CompactCom 40 2 11 Consult the general Anybus CompactCom 40 Software Desig...

Страница 58: ...lways be one instance reserved for an event of severity level Major unrecoverable to force the module into the EXCEPTION state 12 Supported functionality Get BITS32 Bit 0 0 Latching events are not sup...

Страница 59: ...ype Value 1 Name Get Array of CHAR Network 2 Revision Get UINT8 02h 3 Number of instances Get UINT16 01h 4 Highest instance number Get UINT16 01h Consult the general Anybus CompactCom 40 Software Desi...

Страница 60: ...ring Object Attributes Instance 0 Name Access Data Type Value 1 Name Get Array of CHAR Network Configuration 2 Revision Get UINT8 01h 3 Number of instances Get UINT16 000Fh 15 4 Highest instance numbe...

Страница 61: ...r elements 4 Descriptor Get UINT8 07h read write shared access 5 Value Get Set Array of UINT8 Any change is valid after reset Valid range 0 0 0 0 255 255 255 255 Default 0 0 0 0 6 Configured Value Get...

Страница 62: ...X 10Mbit full duplex 03h 100HDX 100Mbit half duplex 04h 100FX 100Mbit full duplex Instance Attributes Instance 8 Ethernet Communication Settings 2 Changes have immediate effect Name Access Data Type D...

Страница 63: ...64 2 Data type Get UINT8 04h UINT8 3 Number of elements Get UINT8 04h four elements 4 Descriptor Get UINT8 07h read write shared access 5 Value Get Set Array of UINT8 Any change is valid after reset V...

Страница 64: ...HAR 3 Number of elements Get UINT8 40h 64 elements 4 Descriptor Get UINT8 07h read write shared access 5 Value Get Set Array of CHAR Any change is valid after reset SMTP server address 64 characters 6...

Страница 65: ...I 1 2 Data type Get UINT8 08h ENUM 3 Number of elements Get UINT8 01h one element 4 Descriptor Get UINT8 07h read write shared access 5 Value Get Set ENUM Value ENUM 00h 01h 02h String Meaning Auto de...

Страница 66: ...ssione 1 Comm 1 Auto Auto Auto Auto Auto 10 HDX 10 HDX 10 HDX 10 HDX 10 HDX 10 FDX 10 FDX 10 FDX 10 FDX 10 FDX 100 HDX 100 HDX 100 HDX 100 HDX 100 HDX 100 FDX 100FDX 100 FDX 100 FDX 100 FDX 8 Comm 2 K...

Страница 67: ...understands the concepts involved in TCP IP programming Supported Commands Object Get_Attribute Create See below Delete See below DNS_Lookup See below Instance Get_Attribute Set_Attribute Bind See bel...

Страница 68: ...UINT16 Number of bytes in RX buffers TCP sockets only 7 TCP TX bytes Get UINT16 Number of bytes in TX buffers TCP sockets only 8 Reuse address Get Set BOOL Socket can reuse local address Value 1 0 Me...

Страница 69: ..._ACTIVE states Command Details Field Contents CmdExt 0 reserved set to zero CmdExt 1 Value 00h 01h 02h 03h Socket Type SOCK_STREAM NON BLOCKING TCP SOCK_STREAM BLOCKING TCP SOCK_DGRAM NON BLOCKING UDP...

Страница 70: ...nstead Command Details Field Contents Comments CmdExt 0 Instance number to delete low Instance number of socket that shall be deleted CmdExt 1 Instance number to delete high Response Details no data C...

Страница 71: ...ates shutdown 1 Send shutdown with CmdExt 1 set to 01h This will send FIN flag to host shutting down the send chan nel note that the receive channel will still be operational 2 Receive data on socket...

Страница 72: ...ails Command Code 12h Valid for Instance Description This command puts a TCP socket in listening state Command Details Field Contents CmdExt 0 reserved set to zero CmdExt 1 reserved Response Details n...

Страница 73: ...ith error code 0006h EWOULDBLOCK BLOCKING mode This command will block until a connection request has been detected This command will only be accepted if there is a free instance to use for accepted c...

Страница 74: ...P address 0 0 0 0 port 0 zero NON BLOCKING mode This command must be issued repeatedly polled until a connection is connected rejected or timed out The first connect attempt will be accepted thereafte...

Страница 75: ...LOCKING mode If no data is available on the socket the error code 0006h EWOULDBLOCK will be returned BLOCKING mode The module will not issue a response until the operation has finished If the module r...

Страница 76: ...e The module will not issue a response until the operation has finished Command Details Field Contents Comments CmdExt 0 reserved set to zero CmdExt 1 Segmentation Control bits For more information se...

Страница 77: ...isn t enough buffer space available in the send buffers the module will block until there is Command Details To allow larger amount of data i e 255 bytes to be sent the command data may be segmented F...

Страница 78: ...ield Contents Comments CmdExt 0 reserved set to zero CmdExt 1 Segmentation Control For more information see Message Segmentation p 80 Data 0 Host IP address byte 4 The host address port information sh...

Страница 79: ...a 0 Group IP address byte 4 Data 1 Group IP address byte 3 Data 2 Group IP address byte 2 Data 3 Group IP address byte 1 Response Details no data Command Details IP_Drop_Membership Category Extended D...

Страница 80: ...and Details Field Contents Comments CmdExt 0 reserved set to zero CmdExt 1 Data 0 N Host name Host name to resolve Response Details Success Field Contents Comments CmdExt 0 reserved set to zero CmdExt...

Страница 81: ...vice data 12 EMSGSIZE Invalid message size 13 EPIPE Error in pipe 14 EDESTADDRREQ Destination address required 15 ESHUTDOWN Socket has already been shutdown 16 reserved 17 EHAVEOOB Out of band data av...

Страница 82: ...message the data field is exchanged with the next data segment Command segmentation is used for the following commands Socket Interface Object specific commands Send Send To When issuing a segmented...

Страница 83: ...subsequent segment both FS and LS are cleared In the last segment LS is set For single segment responses i e size less or equal to the message channel size both FS and LS are set The command initiato...

Страница 84: ...INT16 4 Highest instance no Get UINT16 11 Max no of instances Get UINT16 0006h 12 Success count Get UINT16 Reflects the no of successfully sent messages 13 Error count Get UINT16 Reflects the no of me...

Страница 85: ...ription This command creates an e mail instance Command Details Field Contents Comments CmdExt 0 reserved set to zero CmdExt 1 Response Details Field Contents Comments CmdExt 0 reserved ignore CmdExt...

Страница 86: ...Command Code 04h Valid for Object Description This command deletes an e mail instance Command Details Field Contents Comments CmdExt 0 E mail instance number low byte CmdExt 1 high byte Response Deta...

Страница 87: ...the file system The file must be a plain ASCII file in the following format To recipient From sender Subject email subject Se Headers extra headers optional Message actual email message Command Detai...

Страница 88: ...e mail instance Command Details no data Response Details no data Object Specific Error Codes Error Codes Meaning 1 SMTP server not found 2 SMTP server not ready 3 Authentication error 4 SMTP socket e...

Страница 89: ...e stream and contains services for file system operations This provides the host application with access to the built in file system of the module e g when application specific web pages are to be ins...

Страница 90: ...t_Attribute Object Attributes Instance 0 Name Access Data Type Value 1 Name Get Array of CHAR Network Ethernet 2 Revision Get UINT8 01h 3 Number of instances Get UINT16 4 Highest instance no Get UINT1...

Страница 91: ...e implemented within the host application firmware to expand the implementation Standard Objects Application Object see Anybus CompactCom 40 Software Design Guide Application Data Object see Anybus Co...

Страница 92: ...ach instance represents a handle to a file stream and contains services for file system operations This allows the user to download software through the FTP server to the application The application d...

Страница 93: ...y zz aa bb 01 xx yy zz aa bb 02 and xx yy zz aa bb 03 with the first five octets not changing Name Ac cess Data Type Default Value Comment 1 MAC address Get Array of UINT8 6 byte physical address valu...

Страница 94: ...bute is not read by EtherCAT devices where Port 1 is always enabled This attribute is not used by PROFINET 00h Enabled 01h Disabled The port is treated as existing References to the port can exist e g...

Страница 95: ...munity string Max length is 32 22 DHCP Option 61 source Get ENUM 0 Disabled Note This attribute is currently only valid for Ethernet IP devices See below DHCP Option 61 Client Identifier 23 DHCP Optio...

Страница 96: ...s the Client Identifier 3 Generic String Attribute 23 will be used as the Client Identifier Attribute 23 DHCP Option 61 generic string is used to set the Client Identifer when Attribute 22 has been se...

Страница 97: ...dustrial network are used Additional objects etc that will make it possible to certify the product also belong to this category A 2 Extended Use of the objects in this category extends the functionali...

Страница 98: ...an only change to ER ROR or EXCEPTION ERROR Duplicate IP address detected PROCESS_ACTIVE The module shall never enter any of these states IDLE EXCEPTION Unexpected error e g watchdog timeout etc MS LE...

Страница 99: ...and the ability to restart reboot the device s C 2 Operation When the application is started the network is automatically scanned for Anybus products The network can be rescanned at any time by click...

Страница 100: ...2 L2 Module Status LED 3 Link Activity LED port 1 4 Link Activity LED port 2 Test sequences are performed on the Network and Module Status LEDs during startup D 1 2 Network Status LED LED State Descri...

Страница 101: ...s CompactCom 40 Common Ethernet requires a regulated 3 3 V power source as specified in the general Anybus CompactCom 40 Hardware Design Guide D 3 2 Power Consumption TheAnybus CompactCom 40 Common Et...

Страница 102: ...is software and associated documentation files the Software to deal in the Software without restriction including without limitation the rights to use copy modify merge publish distribute sublicense a...

Страница 103: ...urce and binary forms with or without modification are permitted provided that the following conditions are met 1 Redistributions of source code must retain the above copyright notice this list of con...

Страница 104: ...ER IN CONTRACT STRICT LIABILITY OR TORT INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF AD VISED OF THE POSSIBILITY OF SUCH DAMAGE Print formatting routine...

Страница 105: ...OR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTI...

Страница 106: ...last page 2017 HMS Industrial Networks AB Box 4126 300 04 Halmstad Sweden info hms se HMSI 27 269 2 1 4666 2017 07 10T11 06 42...

Результаты поиска

Содержание CompactCom 40 Common Ethernet

Отзывы:

Бренды по названию

Популярные бренды

Anybus CompactCom 40 Common Ethernet, Руководство по конструкции

Результаты поиска

Содержание CompactCom 40 Common Ethernet

Отзывы:

Бренды по названию

Популярные бренды