PRELIMINARY - Supercontrols
Contents
1. A N 17 A 1 e 3 pCOWeb BACnet configuration Important changes will take effect only after reboot Mac address 00 0a 5c 10 00 00 IP Address main DHCP Netmask main Device Properties BACnet LAN Type BACnetIP O BACnet Ethernet BACnetIP UDP BACO hexadecimal pCOWeb Device Inst 12345 0 to 4194303 Description Carel BACnet Gateway Location Unknown APDU Timeout 5000 milliseconds APDU Retries 3 Password for Restart 1234 Alarm Parameters Alarming Enabled O Yes O No Alarm Destination Device Inst 10 0 to 4194303 Alarm Process Id lo Clock Parameters Daylight Saving Time O Yes O No UTC offset lo minutes 720 to 720 Interval to send Whols 1 minutes O none Submit v lt E MD Internet Device Properties 1 BACnet LAN Type select the protocol to use BACnet IP or BACnet Ethernet 2 BACnetlP UDP if BACnetIP is used then a UDP port must be assigned the default port for BACnet is BACO hexadecimal 3 pCOWeb Device Instance This is the device instance of the pCOWeb on the network It defaults to 77000 but can be set from 0 to 4194303 Every device on the network must have a unique instance number 21 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Description A 64 character field that can be used to describe the device Location A 64 character field that can be used to describe the physical location APDU Timeout Indicates the amount of time in milliseconds between2. Community Enabled No Host 3 i Community Pos F Enabled NO Y Host 4 Community Enabled NO System traps Trap Enabled Trap OID Acknowledge Ack interval pCO protocol failure NO Y UNO Y 1 sec Y The top zone of the top half page is devoted to the settings for up to four destination hosts IP address Community enabling flag IP address must have the usual format Example 192 168 10 2 16 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Community the Community in SNMP standard is a string useful to filter the access from a host toward pCOWeb if the community string of the host is not the same of that of pCOWeb the access will be denied it is then somewhat similar to a password Enabling flag when this flag is set to No it overrides the settings of the rest of the html page no controller TRAPS will be sent to that host when this flag is set to Yes the TRAPS sent to that host will depend on the selections of the rest of the html page Note Trap Host IP The four IP addresses for the hosts shouldn t be confused with those available in the html page that you can see when you click on the link SNMP System defaults configurations of the Web Administrator page in this SNMP pCO variables traps configuration page the four IP addresses will be used ONLY in relation to the settings available in this html page System traps This table contains only one system
3. 0 5 113 Modify Ftp Port 21 Modify Ftp User carelusa Modify Ftp Password thisismyftppassword Modify Ftp Path CAFTPROOT Modify Output File Name EXPORT XML Modify Ftp Pause 60 Modify Ftp Proxy Modify Ftp Proxy Port Modify You must then power down the unit for the FTP routine to work It will begin automatically when the unit powers up 13 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO SNMP PROTOCOL SNMP TREE for pCOWeb from the release A1 0 1 B1 0 0 General OID format 1 3 6 1 4 1 9839 Carel A B C D E A B C D E explanation A 1 pCOWeb properties 1 1 AgentRelease ReadOnly A1 0 1 B1 0 0 pCOWeb sw release 1 2 AgentCode ReadOnly oCOWeb A 2 pCO properties 2 0 10 pCOStatus ReadOnly 2 0 11 pCOerrors ReadOnly 0 pCO offline 1 pCO init 2 pCO online reaches 5 retries gt pCO offline of communication retries 0 when ok or when it 2 1 C D pCO variables ReadWrite C variable type 1 digital 2 analog 3 integer D variable index 1 207 E always 0 Note SNMP R W The actual ReadWrite property depends only from the particular application software downloaded into the pCO controller the ReadWrite attached as remark near the previous oCO variables row means only that a new value received from the network and intended to replace a old value of a particular pCO variable will be sent to pCO and a variable reading performed by a remote host via the
4. Trigger selection Pos 8 Neg a trap will be sent regardless the value of the variable Note that this selection together with the enabling of several traps amp hosts could result in a delay from the power up to the complete acquisition of all the values of the pCO controller 18 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO variables Until the acquisition you will read U undefined as the result of a read of a not acquired variable You can realize a slow refresh by checking the status led in pCOWeb slow or no blinking means slow or no refresh Trap OID Trap Object Identifier a sort of name of the trap This information will be embedded inside the message when the TRAP SNMP message is formatted before being sent to the hosts This information is requested by the syntax of all the TRAP messages except for the system TRAPS for which the OID is predefined If you didn t specify anything inside this field the TRAP will not be generated The form of the Trap OID is accordingly to the rules of SNMP a sequence of numbers separated by periods This syntax is the basic form by which SNMP describes every object An example for this field is 1 3 6 1 4 1 9839 3 1 By this information the receiver will be able to distinguish each TRAP from each other So the Trap OID represents the type of the TRAP See also the previous section describing the SNMP tree for pCOWeb Acknowledge and Ack interval By these selection tools you ca
5. lets you to force the save Backup Upload flash images These two items lets you to download an exact copy of the flashdisk to your PC and later to upload again into a pCOWeb The previous contents of the target pCOWeb flaskdisk will be lost Note that the flashdisk contains also all the user specified configuration parameters IP address for instance The Upload item lets you also to upgrade the firmware into pCOWeb by picking up the proper files from new releases from Carel The Upload task will automatically understand what type the block is and will write it into the right place Format flashdisk This item will erase ALL the writable FLASH space and will recreate the factory situation inside it It is intended to recover from corruption of flash file system or to bring the flash disk to the factory situation but you can also choose to keep the user configuration parameters not the html pages in this case the parameters will be first saved in a temporary RAM zone and further moved to the FLASH after reformatting Get Set var It is a demo page that lets you to set some digital analogue integer variables HTTP PROTOCOL Introduction Creating custom html pages for your pCOWEB requires a two step process downloading the new pages using FTP and setting the proper access properties Custom pages are stored in the writable space of the FLASH memory The amount flash available will very between versions but will be around 2 5mb
6. page shown below PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Carel pCOWeb Default Page Microsoft Internet Explorer File Edit View Favorites Tools Help ar gt Quo x A a sah fg Favorites R 2 mw LJ Address E http 10 5 0 130 httpfindex htrnl Go Links gt ee Carel pCOWeb Default Page index html This is the default index html automatically generated by system during flashdisk formatting You can use this as a template for your own pages This file may be replaced at any time via FTP on directory fusr localfroot http The username to access ftp pages is httpadmin Administrator utilities Web Administrator reserved area Custom tags demo tables This section show you how to use custom tags to view system PLC Variables Digital variables ojojojojojojoljojo oJoJoJo 9 oJ oJoJo 9 9 o OC Oo 0 S O SO oO 0 6 ojojoJojojojoJojo ojojojojojojojojo ojojojojojojojoj S O S S S O OJ oO S S S S S S a aye ojojojojolojojo j ojojojojojojojo ojojojojoeJjojojojo ojojojojojojJojojo OC S O S O SJ Os O C ojojoljojojojoloajo ojoJojojo 0 ojo ji 2 MD Internet This is the default index html page It provides you with a link to the administrator reserved area and displays the current values of all variables that are being read from the controller This file is stored in usr local root flash http and is also the folder where your custom html files will be
7. stored Web Administrator Page PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Carel pCOWeb WEB Administrator page Firmware release 1 2 5 B1 1 3 Admin utilities View used free flashdisk space Set directories password View factory bootswitch parameters Adjust files and directones attributes access View system log and resources View environment variables View network co ation View mount points Ping a remote host Reboot System STOP SYSTEM put into emergency runlevel The adminpage html gives some useful configuration features View used free flashdisk space Check for the amount of free writable space inside the FLASH memory Set directory password Useful to set change the logins to access the directory in the writable area of the FLASH Adjust files and directories attributes access Needed to set the properties of the user html and cgi files downloaded into pbCOWeb you must launch this item to make the http server able to open those user files Every time you create a new page or inadventertly change the properties of some user files it is advisable to launch this item Flush disk cache Every change in the user files or parameters is temporarily written in RAM and later saved in FLASH This is made to save time for the writing cycles in FLASH This can lead to data Eer PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO loss or corruption if pcCOWeb is powered down before the saving in FLASH This button
8. to 4mb For the purpose of this manual we will use the SmartFTP program http www smartftp com to easily download the pages to the pCOWEB via FTP protocol The http server of pCOWeb needs to have the html pages with some specific owner group access property settings After the pages are downloaded a special task has to be launched to set properties If these properties are not set it will not be possible to retrieve the pages User html pages The process for updating pages in the pcoweb is 1 Rename the default index html page with another name for example admin html 2 Download a custom made index html page any other page linked to it These pages are not visible at this point the proper flags need to be set 3 To set the flags link to the administrator page previously renamed by typing http your_pcoweb_ip http admin html 4 Enter the Web Administrator Area with user name admin and password fadmin Launch the Adjust files and directories attributes access 5 Repeat steps 2 4 every time a page is added or updated 8 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO To administer the web pages you can use any FTP client for the following examples we will use SmartFTP free to explore the directory tree of pCOWeb The user name and password for web administration is username httpadmin password fhttpadmin Note Changing Passwords The password can be changed by accessing the pCOWeb
9. trap its name is pCO protocol failure When enabled the TRAP will be sent to all the hosts set in the above section of the html page in occurrence of the continuous communication between pCOWeb and pCO becomes impossible Normally this could never happen but it does it is possible that there is some hardware or pCO application software problems You can check this situation in the left LED status of pCOWeb it will appear red with dark flashing every time a request generated from pCOWeb is not followed by the right answer from pCO Enabled Enabling flag only for pCO protocol failure trap Trap OID Trap Object Identifier a sort of name of the trap This information will be embedded inside the message when the TRAP SNMP message is formatted before being sent to the hosts This information is requested by the syntax of all the TRAP messages except for the system TRAPS for which the OID is predefined If you didn t specify anything inside this field the TRAP will not be generated The form of the Trap OID is accordingly to the rules of SNMP a sequence of numbers separated by periods This syntax is the basic form by which SNMP describes every object An example for this field is 1 3 6 1 4 1 9839 3 1 By this information the receiver will be able to distinguish each TRAP from each other So the Trap OID represents the type of the TRAP See also the previous section describing the SNMP tree for pCOWeb Acknowle
10. variables are mapped to BACnet Analog Value object type with an instance number equal to their variable number plus 1000 e g integer variable 17 would appear to be BACnet Analog Value 1017 The integer value shall be converted to REAL in BACnet So the value 123 should be converted to a floating point 123 0 as the value for the AV object Present_Value property Digital variables are mapped to BACnet Binary Value object type with an instance number equal to their variable number e g digital variable 17 would appear to be BACnet Binary Value 17 The following table summarizes the relationship Carel variables BACnet variables Digital variable 1 Binary value instance 1 Digital variable 199 Binary value instance 199 Analog variable 1 Analog value instance 1 Analog variable 127 Analog value instance 127 Integer variable 1 Analog value instance 1001 Integer variable 127 Analog value instance 1127 Supported BACnet Objects The pCOWeb supports analog_value binary_value and device object types The following properties of those objects are supported in addition to the writable Description property In general standard object property values other than Present_Value are derived as follows o Object_Identifier generated automatically from request Object Name generated by taking a single letter A or D concatenated with the variable number as 3 decimal digits e g A025 Objec
11. O variables traps configuration of the WEB Administrator page in this SNMP System defaults configurations page the four IP addresses will be used ONLY in relation to the settings available in this html page CONTROLLER TRAPS This type of TRAPS is sent when some selectable status comes active in the pCO controller into which the pCOWeb was plugged in To set these traps you have to use the link SNMP pCO variables traps configuration of the Web Administrator page Note all the settings in this page will be active once you have got the refresh of the html page after a Submit button pressed it is not necessary to reboot pCOWeb 15 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Note Two Submit Buttons the page is divided into two half pages top down Each of these has its own Submit button please note that a Submit button will confirm ONLY the parameters selections of the related half page with no effect to those of the other half page Let s examine the page Top Half of Trap setup Page A pCOWeb SNMP pCO variables traps configuration Microsoft Internet Explorer File Edit View Favorites Tools Help Q sack amp a EA ya Search P Favorites E2 A7 wi land Address El http 10 5 0 127 config samptrap cai SNMP pCO variables traps configuration Host 1 Community Enabled NO i Host 2
12. PS the meaning of the Community string is similar except that the roles pCOWeb host results inverted when a pCOWeb generates a TRAP it puts the Default trap community string into the TRAP message This gives the host a chance to filter some unwanted TRAPS the host that receives the TRAPS can then decide which TRAPS to show and which ones to ignore Send authfail trap This flag lets the user to choose if the pCOWeb have to generate a particular TRAP authfail trap when an attempt has been detected to access pCOWeb with a wrong community by a host The trap will be sent to every specified host see below System traps hosts table System trap destination host N Each row of that section lets you to to set the IP address of a host It must have the usual format A B C D every number in decimal format Example 192 168 10 2 When a host is set pCOWeb will send a specific trap EVERY START and EVERY STOP of the SNMP application usually at boot and at reboot So when you power up pCOWeb or when you reboot it a coldstart trap will be sent to every IP address of the hosts Similarly when a reboot is requested a enterprises 8072 4 0 2 trap type will be sent The only way to disable these traps to a specified host is to clear the corresponding IP address Note Trap Host IP The four IP addresses for the hosts shouldn t be confused with those available in the html page that you can see when you click on the link SNMP pC
13. T Sia ia 23 BBB I0 0 EA ME e Behl acess 25 OBJECT SUPPORT OF INTRINSIC ALARMING c cccccccscccscessccsecssccssccssccssscsscssssesssesssessecesscesscesscesscesscessecsuccssecssecssseasesss 25 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Overview The pCOWEB interface card was designed to provide the pco controller family connectivity to four increasingly used protocols HTTP SERVER FTP SNMP and BACNET The card provides a gateway connection between the communicated variables from the controller allowing all 199 digital 127 integer and 127 analogue variables to be visible to the end user Hardware Installation The pCOWEB interface card connects to the pco by the supervisory port The card can be inserted directly into the controller Figure 1 pCOWeb Ethernet Card Figure 2 Remove Cover Apertura sportellino Removal hatch MIT ry simi aose S55 ieee See eee JN af in TN e A rn eer EERE 0 Figure 3 Insert the pCOWeb Card Figure 4 Inset the pCOWeb Cover Inserimento schedalInsert hatch Chiusura dello sportellino Close hatch pCOWeb Administration Default Web Page The pCOWEB defaults to DHCP for its IP address If this is not desired you can force the address 172 16 0 1 by holding down the reset button during power up until the LED blinks red Connect to the pCOWEB with a browser and you will be automatically redirected to the standard default
14. a mechanism by which computerized equipment can exchange information regardless of the particular building function they perform The pcoweb provides Carel pCO controllers with a gateway to the BACnet protocol The pCOWeb appears to be native BACnet device as it reflects the status of various real time measurements and commanded setpoints in a single Carel pCO controller The protocols supported are BACnet IP BACnet Ethernet and BACnet MSTP Due to the small form factor there are two different models of the pcoweb The first PCO1000WBO0 has a connection for an Ethernet networks and has Ethernet 8802 3 and network and provides the BACnet MS TP protocol Part Number BACnet Protocol PCO1000WB0 BACnet IP and BACnet Ethernet PCO1485WB0 BACnet MSTP BACnet IP and BACnet Ethernet configuration To configure the pCOWeb BACnet you must connect the pCOWeb to your Ethernet and use a browser to goto http your pcoweb ip Select web administrator reserved area The password for this area defaults to username admin password fadmin Select BACnet configuration This will display the following page 20 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO A pCOWeb BACnet configuration Microsoft Internet Explorer File Edit View Favorites Tools Help ae Q sack gt x E A Search J Favorites E LS E w La rel 3 v Go Links gt ril x Address http 10 5 0 130 config bconfig html
15. d Protocol_ Object_Types_ Supported Object_List Max_APDU_Length_Supported Segmentation_Supported not supported APDU_Timeout Number_Of _APDU_Retries Max_Master only present on MS TP version writable Max_Info_Frames only present on MS TP version writable Device_Address_Binding Database Revision 00000000000 00000000000000 Hs PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO BIBB Support The pCOWeb supports the following specific BIBBs per their relevant definitions in Addenda D Annex K to BACnet DS RP B DS RPM B DS WP B DS WPM B i e act as a server that can execute Read Write single or multiple properties DM DDB B DM DOB B i e dynamic device and object binding Support initiating Am in response to Who Is and at configurable interval Who ls only Who ls plus startup Who ls plus every N minutes This option is configurable through software DM DCC B DM RD B e DeviceCommunicationControl and ReinitializeDevice These features shall support a Reinit Password configurable through software AE N I B AE ACK B AE INFO B e generate EventNotifications when programmed alarm conditions occur accept acknowledgements for those notifications marked as requiring acknowledgement and support GetEventinformation requests Object Support of Intrinsic Alarming In lieu of full support for Notification Class objects the intrinsic alarming features of AV and BV objects determine the destination for event notificati
16. dge and Ack interval By these selection tools you can decide to activate or not the Acknowledge feature for the pCO protocol failure trap For example Suppose that you have enabled this feature to Acnowledge 5 times with a Ack interval 10 seconds When pCOWeb sends the trap to Host1 it will begin to wait for a special reply from the corresponding Host1 saying ok received this trap If pCOWeb is not able to get this Acknowledge within 10 seconds from the first sending it will send the 17 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO same trap one more time and then it will start waiting for the Acknowledge This mechanism will stop as soon as pCOWeb will get the Acknowledge or after a maximum of 5 further traps after the first sending Bottom Half of Trap Setup Page Variable 1 Y E Enabled Trigger Destination Trap OID Acknowledge Ack interval Vars OID NO vw Positive v Host 1 NO vi A NO w E sec w Host2 NO vw Host3 NO_ vw Host4 NO This half page lets you to configure the traps related to state changes of each digital variable of the pCO controller Variable 1 SELECT When you enter the page you will be able to see the settings of the Digital Variable 1 as reported by the selector Variable which is set to 1 by default The configuration of the traps for this Digital Variable is contained in the table below the Variable selector By this table you can change the configuratio
17. e to 0 will disable this command Clock Parameters 1 Daylight Saving Time Check yes if it is required to automatically track daylight savings time 2 UTC offset Universal Time Coordinated offset is used to enter an offset in minute resolution The UTC time zone is GMT or Zulu time in military terms For example you would enter 300 to get Eastern Standard Time EST Submit Button Pressing the submit button will save your changes Then you must reboot the pCOWeb by pressing the reset button on the card or by resetting power to the pCO controller pCO to BACnet Database The pCO communicated variables are maped to analog_value and binary_value BACnet objects A table based list of BACnet visible values is maintained by the pCOWeb Each interface table value is accessible by BACnet clients as a Present_Value property of a standard object The Carel variable for each interface table slot defines the object type implicitly IDa PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Analog variables are mapped to BACnet Analog Value object type with an instance number equal to their variable number e g analog variable 17 would appear to be BACnet Analog Value 17 Because analog variables are implicitly scaled times 10 their conversion to REAL in BACnet is scaled accordingly So the value 123 which is taken to mean 12 3 is converted to a floating point 12 3 as the value for the AV object Present_Value property Integer
18. gured by CAREL or you will receive instructions to configure it yourself This is not a standard application on the pcoWeb due to memory limitations on the card Direct your browser to the following page http path_to_your_pcoWeb http plugins ftp_ client html There you will see the following X Disable A C55 g Forms 3 Images B Information He Mis Address of your FTP Server FTP Server Port default is 21 FTP Login A A AA FTP Server Password Ftp client configuration parameters Path to your FTP directory Ftp Address ftp Modify The output file ra name We suggest Ftp Port Modify using an XML extension since the Ftp User Modify file is in XML format Ftp Password Modify gt Pause in seconds between Ftp Path Modify executions of the FTP push routine Output File Name Modify IP Address of your proxy server if you Ftp Pause Modify do not use a proxy server leave this blank Ftp Proxy Modify Ftp Proxy Port Modif Y Comm port of your proxy server if you do not use a proxy server leave this blank 12 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO After configuring the FTP Push setup for your pcoWeb your screen will look similar to this xX Disable EN css e Forms tJ Images D Information Miscellane pCOWeb ftp client System C Ftp client configuration parameters Ftp Address ftp 110
19. h ent een eon au neon oo 7 Backup Upload flash i1mages cccsescsccsesesesceseseeeeseseussssaessussseneseeseeessesseeeaeseeeeseseeseaeeeseseeeeseseeeneeaeeeeeeas 8 Format flashdisk 6332565 19h tees NER OA ORR I 8 CUEVA TE EP N Eo 8 ATTP PROTOCOL scssdssecs scsessacagensecteccsssscaussscoasececessntccdsssaveceerdesenessbucecdeacasacecesdenssascsosssedcsssgssnete sdssoscesevssueeeedcssbecsesesasss 8 INTRODUCTION teta 8 USER HTME PAGES Seas tidas 8 Note Changing Passwords zoyi ini i a A E ls a 9 SPECIALTAGS od 10 Getting A Dala e coo aro a Dad 10 Setting Data 0 do el eh sls ted le e de e e OS 11 ETP PROTOCOL OPTIONAL sescssessssssecseooscssescosesesseosessoascnsesevenenssssoecescnsvenonsssosecescnssenscvenessessocesonesocessvesscseneaesenes 12 SNMP PROTOCOL ssisssessiscoccssdsdencesscsvasnceccavtoccaesecasguncdssscenttsscneecssscseceadesensenecssdeseasesssssccacsssdocaatcesesed cossessueascdeesbecssetess 14 GENERAL OID FORM T inia der E TER cee ts Oece la eae a a leo ee 14 Note SNMP RIW3 AAN 14 TRAPS e e e e A A 14 INTrOUCtION ii A OEN EAEE AN 14 SYSTEM TRAPS 5 55 a EAE A REAO N 15 Default traps A A AEE ERS 15 Default trap community tt 15 Send authfail A A AA E E ee es 15 System traps hosts table c ccccsssssccssssnsecesssceccessnsecessenseecssensecssenseetesseneeeseeanes 15 System trap destination host FN ooooooooonnccccnnoooccncoooncnncnonnnnnnnonnnncnno
20. html configuration pages The factory password is simply f followed by the username The username cannot be changed After the login you will see the contents of the folder usr local root flash http SmartF TP v1 0 Unlicensed FTP Commands View Tools Favorites Window Help e 28 s38 smoB e a anea a Address A v P 10 5 0 130 usr local root flashjhttp Login httpadmin Password Port C Anonymous 10 5 0 130 httpadmin E Y 10 5 0 130 Name Ei 3 usr Parent Folder gt local 5 admin 1 1 2005 0 00 AM 2 foot plugins 1 7 2005 16 16 PM a a pa lindex html 17 3KB 1 1 2005 0 01 AM y admin y plugins Date 200 NOOP command successful NOOP 200 NOOP command successful Log A Session Queue gt 30Object s Total 17 3 KB 00 04 08 Queue Source Global Queue Connections Speed Source and you should also find the admin folder and index html 9 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO The flash http directory is the right place to store your html pages and or directories The flash http index html is the default page that will be served out when you type http lt pCOWeb IP address or name to be resolved by a DNS gt Enter into a browser If you need to build some CGI scripts the right place for those files is 1ash usr cgi If you put them in a place other than that they will not be executed The directory usr local root is the ro
21. n decide to activate or not the Acknowledge feature for the pCO protocol failure trap For example Suppose that you have enabled this feature to Acnowledge 5 times with a Ack interval 10 seconds When pCOWeb sends the trap to Host1 it will begin to wait for a special reply from the corresponding Host1 saying ok received this trap If pCOWeb is not able to get this Acknowledge within 10 seconds from the first sending it will send the same trap one more time and then it will start waiting for the Acknowledge This mechanism will stop as soon as pCOWeb will get the Acknowledge or after a maximum of 5 further traps after the first sending Vars OID optional A trap message can carry some additional informations pCOWeb can fill the trap message with the values of up to five variables of the pCO controller read at the time the trap was generated By the fields Vars OID you can specify the OIDs for these variables At the moment the trap will be generated pCOWeb will get the values of the variables whose valid OIDs are specified within the fields and will fill the trap message with them By this the host that receives the trap can also report these informations normally useful to better understand the reasons the trap was generated by the application in pCO 19 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO BACNET PROTOCOL The BACnet protocol is the ASHRAE building automation and control networking protocol that provides
22. n of the traps for the Digital Variable 1 If you want to check change the Configuration of another digital variable you first have to select another Variable number then you have to click on the SELECT button and wait for the half page refresh The configuration table shows in the most left column the number of the Digital variable selected Enabled and Destination Columns If Enabled NO is selected the state changes of the currently selected Digital Variable will never generate traps if Enabled YES is selected the traps generation and sending will depend on the Destination enabling flags For instance to let a trap to be sent to the Host1 all three Enabling flags Enabled for the Host1 in the top half page Enabled in the bottom half page Destination Host1 in the bottom half page have to be set to YES Trigger Let you to select which state transition will generate the trap Positive from 0 to 1 ransition Negative from 1 to 0 transition or Pos amp Neg every transition Note Trap Trigger at pCOWeb power up and after every revivel of a previously failed communication state with pCO pCOWeb will send a trap for each digital enabled variable accordingly to the Trigger selection and the following rules Trigger selection Positive a trap will be sent if the value of the variable is found to be 1 Trigger selection Negative a trap will be sent if the value of the variable is found to be 0
23. network will get the value that the pCO passes to pCOWeb no matter of the actual meaning of this value it could be a variable used or not by the particular pCO application Example 1 3 6 1 4 1 9839 2 1 2 45 0 Analog variable with index number 45 the ending 0 is always needed as every object is treated as a scalar value TRAPS Introduction The TRAPs represent a way by which pCOWeb can send a warning a SNMP coded message to some receivers when a particular status comes active The main reason for this mechanism is useful is that it is an asyncronous i e a remote host is able to get a status warning from pCOWeb without any active remote polling activity The only need at the supervisor side is the presence of a running task able to detect the messages that could come from pCOWeb 14 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO pCOWeb is able to send two types of trap system traps and controller traps SYSTEM TRAPS To set these traps you have to click onto the link SNMP System defaults configurations of the Web Administrator page Note all the settings in this page will be active from the next reboot of pbCOWeb Default traps Default trap community The Community in SNMP standard is a string useful to filter the access from a host toward pCOWeb if the community string of the host is not the same of that of pCOWeb the access will be denied it is then somewhat similar to a password For the TRA
24. nnnnnnonnnnnncnnnnnos 15 Note Trap HOSTIP occiso its 15 CONTROLLER TRAPS cuicos ada diia 15 Top Halt of Trab setup Pame viii ti ii 16 Note Trap Host IPS casino ads 17 System traps iaa idas 17 Enable di 17 Trap OUD A A A a Lae 17 Acknowledge and Ack interval oooooooooconnnonooononnonocononanononononononananrnnnonccnnnanononnnnss 17 Bottom Half of Trap Setup Page ooooocooocoooccoonccococonoconoconcconnconononnncnnos 18 NVariaple 1 SELECT oi aaa cade 18 Enabled and Destination COLUMDS cococccnnnnnnnnnnnnnnnnnnnncnninoninnninnnnnnnannananannnnns 18 TN 18 Trap OUD A A A a eee 19 Acknowledge and Ack interval o ooooooonnnonnooncccncconononononcnononnnonannnnnnnonccnnnannnonnnnos 19 Vars OLD Coptional econ a A aa sas 19 BACNET PROTOCOL fiascccssssevsescssasnesessssnsstssaseassossccceusesesnssssnsssesassesteassstsesdacsesoeentesesassssveve dos naadenedesbsecshacosesenasos ases 20 BACNET IP AND BACNET ETHERNET CONFIGURATION ccccccsscscssesseseeseseeseeccscesseseseesesecsecseeseceeseeseeseeseeeeas 20 Device Propertles cavidad OE ssargssashs arava nissedeysbveqeaseeauacnanaseens 21 Alarm Parameters SAA A RR ds e 22 Clock Parameteren dns A cts esa ea Lata leh AA aaa 22 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO AI 211111 A NE 22 PCO TO BACNET DATABASE iio dirias 222 SUPPORTED BACNETOBIEC
25. ods The standard form tag for pcoWeb must only contain the method property Example lt form method get gt The action tag should be omitted in the pcoWeb pages 26 lt form method GET gt me Var l lt input type text name script var 0 1 1 0 1 value lt var 0 1 1 gt gt lt br gt eo Var 2 lt input type text name script var 0 1 2 0 1 value lt var 0 1 2 gt gt lt br gt SS Var 3 lt input type text name script var 0 1 3 0 1 value lt var 0 1 3 gt gt lt br gt mo Var 4 lt input type text name script var 0 1 4 0 1 value lt var 0 1 4 gt gt lt br gt Mie Var 5 lt input type text name script var 0 1 5 0 1 value lt var 0 1 5 gt gt lt br gt ma Var 6 lt input type text name script var 0 1 6 0 1 value lt var 0 1 6 gt gt lt br gt Setting a variable must follow this format 11 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO name script var unit type index lo range hi range The Unit ID Usually zero The upper range of the variable e 1 digital 10000 0 analogue 100000 integer Variable type The physical The lower range of the e 1 digital index of the variable e 2 analogue variable 0 digital e 3 inteaer e 10000 0 analogue e 100000 integer FTP PROTOCOL optional Note pcoWeb does not ship with FTP Push functionality To use FTP Push your pcoWeb must be confi
26. ons using added properties in the Device object and individual AV and BV objects The Device object includes these standard properties used in a non standard manner o Recipient writable representing the device instance to send event notifications to o Process_ldentifier writable representing the process identifier of the recipient process in the device to which notifications are sent The AV and BV objects include these standard properties used in a non standard manner o Issue Confirmed_Notifications writable whether alarms from this object should be sent as confirmed or unconfirmed o Ack_Required writable whether alarms from this object require individual human acknowledgement o Priority writable what the alarm priority for this object is in event notifications note that all transitions use the same priority The AV and BV objects include alarm detection and reporting logic to implement high low limit alarming for AV and Change Of State alarming for BV The detection algorithms behave as described in 12 3 16 12 3 17 and 12 7 23 of 135 2001 for standard intrinsic alarming The resulting event notifications are reported to a single destination specified device configuration The Description property is used as the alarm message description in event notifications Le
27. ot directory for http server The http server will automatically add the path usr local root to every page name requested by a client For example look at index html When you write http lt pCOWeb IP address or name to be resolved by a DNS gt Enter the http server will automatically serve the following page usr local root http index html The parenthesis contain the root path for the http server on future examples this will be omitted This page is stored inside a read only area of the FLASH memory If you open this page with a text editor you ll find inside a redirection to another page http index html The http server will then search this new page inside the directory http Actually this directory is a link to the directory flash http the http server will then look into flash http The flash area is a writable space inside the FLASH memory When you first receive pCOWeb or after a Format flashdisk action this directory will contain a factory index html but you can change it as you want Special Tags Look into flash http index htm1 you ll find some interesting rows Y index html 1 lt html gt 2 lt i The tag filter musb be specified in the first 10 lines 3 after the lt html gt statment with the sintax gt 4 lt tagparser pcotagfilt gt 5 lt title gt Carel pCOWeb Default Page lt title gt lt tagparser pcotagfilt gt This row must be inserted within the firs
28. pCOWeb for the pCO controllers TIA gt a i AAA _ a WA m TU F mmmn a PRELIMINARY User manual CAREL es Technology amp Evolution PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO LEGGI E CONSERVA gt QUESTE ISTRUZIONI 4 READ AND SAVE THESE INSTRUCTIONS We wish to save you time and money We can assure you that the thorough reading of this manual will guarantee correct installation and safe use of the product described PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO DUE A e e ae ee e aa 5 HARDWARE INSTALLATIONS cccccassesssscvccessnpsscsdensecsessenncessssessctesvessceasecdensceesstessecedverssnsssseestceassssenaavesecetocscevsosssesesssee 5 PCOWEB ADMINISTRATION sticcecssesscssseisccessotensescscensencsacnbcecsteencnteasstskev censnassesessdenssobensenesesicedensssesasstenscsdanentsanssdetse 5 DEFAULT WEB PAGE ccccccccsscsssssescssessesssscesesesscessssssessessssssesssssssseesseseeasssesssasssesssassssssssssasesssssaeeacseeaeeaseaeeneases 5 WEB ADMINISTRATOR PAGE icie 0223530 lt 035 Securities A gs RI eas ee PIS 6 View used free flashdisk Spa Ce 00000 aan 7 Set directory PASSWOM eee eeteteeeeeeseceseeteceeecasssoesestscssesseseoseesssoesestecssessesseasassescoessesscatsesscaserseaeoenees 7 Adjust files and directories attributes ACCESS 0 cceeccececesceseseseseeeseseeseseeeeaeseuseseseneeseaeeseseeeseaeeeseaeats f PIUSI disk cache nenne Seces esse e
29. retransmission of an APDU requiring acknowledgement for which no acknowledgement has been received The default setting of this property is 5000milliseconds This value must be non zero if the APDU Retries is non zero In order to achieve reliable communication it is recommended that the value of the APDU Timeout be the same in all intercommunicating devices 7 APDU Retries Indicates the maximum number of times that an APDU shall be retransmitted The default value is 3 If the value of this property is non zero then the APDU Timeout field must be non zero 8 Password for Restart This is the reinitialize password The default is 1234 The value can up to 9 characters long It is required from the responding BACnet user prior to executing the ReinitializeDevice service SE Alarm Parameters 1 Alarming Enabled Set to yes to enable the intrinsic alarming features of AV and BV objects 2 Alarm Destination Device Inst Insert the device instance of the destination for the alarms Allowable range is 0 4194303 3 Alarm Process Id Insert the process Id or handle which is meaningfull to the alarm destination device This handle will be used to identify the process within the destination device that should receive the alarm notification 4 Interval to send Whols The pCOWeb will send a Whols command to the alarm destination device Whols will continuely be sent at the interval provided until a valid response is received Setting this valu
30. second variable describes the variable type o 1 digital o 2 analogue o 3 integer e The last variable is the physical index where this value is communicated The var tag initiates a polling routine in the pcoWeb The other data retrieval method is the setres tag This tag acts as a set var verification system When you change a system variable through the pcoWeb a value can be communicated back to the browser This value indicates whether the previous operation was successful In the following example the setres operation will display an image based on the result lt img src img lt setres undefined green red gt gif In this example a different image is displayed based on the value of setres This function is only called after the pcoWeb initiates a SET command The parameters of the tag are booleans and are mutually exclusive The first parameter returning true means that the SET function returned 0 or a null result This could be caused by communication errors with the pcoWeb or incorrect variable settings The second parameter returns true when the variable has been set The third parameter returns true when the transaction times out The variable may have in fact been changed but the transaction exceeded the timeout setting This may be encountered if the pcoWeb resides on a network instead of a direct connection Setting Data Setting data to the pcoWeb uses the standard HTML form submission meth
31. t 10 lines it tells to http server to call the pcotagfilt pre process application we call it filter that will recognize all the Carel defined tags and will perform the corresponding actions If this row is not present the Carel defined tags will be ignored and no values of the pCO controller will be visible 40 lt H gt Custom tags demo tables lt H4 gt 41 This section show you how to use custom tags to view system PLC Variables az lt h5 gt Digital variables lt h5 gt 43 lt table border 1 gt 44 lt tr gt lt td gt lt var 0 1 1 gt lt td gt lt td gt lt var 0 1 2 gt lt td gt lt td gt lt var 0 1 3 gt lt td gt ae lt tr gt lt td gt lt var 0 1 17 gt lt td gt lt td gt lt var 0 1 18 gt lt td gt lt td gt lt var 0 1 19 gt lt Line 44 and 45 above show several Carel defined tags they are useful to retrieve the actual value of the pCO variables For the syntax and details see the list of the tags below Getting Data 10 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO lt var 0 1 1 gt All tags must be opened and closed with these delimiters This follows the standard ASP convention They are necessary for the parser to distinguish pcoWeb code from HTML For the var tag these three variables must be defined e The first variable is the unit ID Unless the controller is configured to communicate with other units this value will always be zero e The
32. t_Type generated automatically from request Polarity always NORMAL Description writable Status Flags always FALSE FALSE FALSE FALSE Event_ State always NORMAL Reliability generated automaticaly once pCOWeb has received a valid reading from pCO controller Out_Of_Service always FALSE Units writable o Inactive Text writable default to 0 000000 O oo 23 PRELIMINARY PCOWEB BACNET PROTOCOL FOR PCO Active Text writable default to 1 Time_Delay writable Alarm_Value writable BV only High_Limit writable AV only Low_Limit writable AV only Deadband writable AV only Limit_Enable writable AV only Event_Enable writable Acked_Transitions generated by alarm logic Notify_Type always ALARM Event_Time_Stamps generated by alarm logic 00000000000 From a BACnet perspective the pCOWeb appears to be a single BACnet device representing the pCO controller Consequently it provides a Device object The Device object is homed on the BACnet LAN The Device instance and properties are programmed through either the WEB interface or by the Carel BACnet Gateway Configuration software The Device Object supports the following properties Object_Identifier Object_Name configurable Object_Type System_Status Vendor_Name Vendor_ldentifier Model_ Name Firmware_Revision Application_Software_Version Location writable Description writable Protocol Version Protocol Revision Protocol_ Services Supporte
Download Pdf Manuals
Related Search