Home

pCOWeb User manual

1. M E fN N A e FN FFX INSI Ee VC CIVV AND INSICEe J v LA kt v4 NX Ww VV X MZ ww LAG A vr scheduled by pCOWeb ae level scheduled gll ovo T requests by application VoM sic triggered by fue pCOWeb delta flag AN 11 uni comm N value buffer AN 11 X comm buffer Undef WRITING var value REQUES o ES No se v delta NOS el E WRITE MESSAGE TT P gt flag la fy WRIT MESSAGE lt html only st t g OO x LS REQUEST ne a READ MESSAGE CATO alue ere p T READING Mag ae WERL ta AN 12 REQUEST 7 eset 7 flag set X atom fr oCOW delta value received LN o comm from pCOWeb ition d o OUR MAE or variation by application buffer repetitive i 3 times pCO per second application Figure C a Communication between pCOWeb pCO atoms REQUEST TO WRITE A VARIABLE FROM pCOWeb TO pCO 1 The variation request WRITING REQUEST is not transcribed to the pCOWeb table comm buffer var value but rather is sent directly to the pCO 2 At the same time on the pCOWeb the variation sent flag is raised comm buffer delta flag set this flag is ONLY used by the HTML pages when reading to establish whether the variations sent by the page with the Submit button have been confirmed by the reception of the new values on the pCO while there are still
2. Capea 81 Minimu RUMI MIA Ls cet ah E Om 81 Wood sie ccc en cer ee ete Mi cr Ac a a east de a ce er ae cet a baer erences ent ide 8 81 CE Se eM E E H 02 PalseResuis CRAP VOU SION VA 2 P 83 NU crc ene ad 83 PUNY AI Nae Sa ere at cU dep ICD TEE 83 BISA Wea TP 83 APPENDIX STRUCTURE OF A pCOWeb PLUGIN esce cect atte eta outcast coats ce E Od tes cease MEE 84 deme NON NN DL One 84 FIMISCONBEIGURATIONSPAGES iU ou tala LE DE LL PU M LE _ ds M M LUN M m M M ell lena 84 Structure of the ntp dient html page for configuring the NTP PIUglfiss ususcces itor sorti astare tert epum pertice repeto 84 Eubea M LP LE M AM I I M RR M RM M M eee ee ee 85 Jem ense C iii ei i le eee eee 86 IE ESEN I XR o m 86 UU C Oe fo 26 1 8 KS Sta ne one ene E DUM EEUU TUM M DL MED ID een eR Pm aR ee Re oO 86 RUNI RE E M M AP 87 PUGNNNE lane GA 88 PLUGINDIREGIO RA cn alli 88 CHARACTERISHESOI THESCONSD GNU Bin OPERATING SYSTEM acne LL 88 ANID E TT 8 89 pCOWeb 030220471 re
3. E RERNNE Hr i 1970 a agi eta m douches BERGER 2 sasccnaeccoeccceseoceseccoecceseccoecceeccoec SERE SI FASO 34953 DI inder ref Se ee See CU iano ia a 1570 Lr a Ee eg oe ai oai sad oai jai as iai iai iai iai mi mds mio jas SIMA We x a a Jic amp pplircatiocn 2 2 s 2 e xan id 190 ai gt initrd tmp pto Application plugins PT ne nee ee ae ne ooo ET tenendo E Se 1 iss 0 k L E E Lermlaibelx ml RIESCO er er ww er ee 70 Spas cx ig ca Tu ES La i d re Ser riper ee a i i ini ai ad mio sad BES 6 LL r 355 zs eri very long template rml Now 10 i8 43 isO Generated Mon 22 Nov 2010 16 58 02 GMT by psi carel locale sequimur 6 STABLEZ Figure 4 h Using Internet Explorer as the FTP client This solution is not recommended however as it is not suitable for copying files from the PC to pCOWeb in addition previous versions of Internet Explorer had problems in navigating the memory space outside of the areas used for the HTML pages configuration files 7 Alternatively Windows Explorer can be used see Figure 4 1 below typing in ftp httpadmin 10 0 0 145 10 0 0 145 File Modifica Visualizza Preferiti Strumenti Accedi come X 49 Impossibile accedere al server FTP con il nome utente e la password specificati 4 Server FTP 10 0 0 145 Utente httpac Nome utente httpadmin 3 bd Password Dopo l accesso sara Bo selle amento a Pref
4. 4g ux Oggetto 1 3 6 1 4 1 9839 2 1 2 45 Figure 6 a SNMP tree example of a pCOWeb OID Object IDentifier BASIC SNMP COMMANDS The basic SNMP commands used by the NMS manage the variable read write operations e snmpget snmpset read and write a specified SNMP object respectively e snmpgetnext based on an initial SNMP object reads the object implemented in the Agent that is next to the one specified considering the lexicographical order of the path of the MIB tree e snmpwalk based on an initial SNMP object reads the entire part of the SNMP tree implemented in the device next to the specified object in reality this command uses a sequence of snmpgetnext commands to request the next object each time COMMUNITY SNMP v2 does not feature authentication Username Password In version 2 the data is also exchanged without encryption Nonetheless version 2c uses an identifier word sent without encryption called the Community that acts as a filter for the reception of the data or executing commands When an NMS needs to read the value of an object in an Agent it must send a ReadOnly Community or a ReadWrite Community string that matches the identifier set in the Agent The same is true for the ReadWrite Community string when writing data Similarly when an Agent sends an SNMP notification message TRAP or INFORM it specifies a Trap Community if this does not coincide with the recipient Trap Community
5. File Edit View Favorites Tools Help Google CG fo e m V Bookmarks ES 7 blocked AW Check hl W AutoLink 3 AutoFill Leb Send tow E J Settings wr ow pcoweb Demo Page fap gt fh P Page Of Tools pCOWeb Demo Page Done m mW m m e Internet 10095 2 Figure G b The var TAG used for writing pCOWeb 4030220471 rel 2 0 28 02 2011 72 After having entered a new value selecting the Submit button sends pCOWeb the value entered for the variable and a new request for the page specified in the form statement example html pCOWeb will perform the following operations 1 send the value entered to the pCO for multiple variables it will send all the values entered 2 waitto receive the echo of the value sent by the pCO for multiple variables it will wait for the echo of all the values 5 when the echo is received the value will be written to the table on the pCOWeb and the page will be returned to the PC for multiple values it will wait for the last echo to be received the fields will contain the values received as echoes from the pCO pCOWeb Demo Page Windows Internet Explorer l z mi x Qc http 10 0 0 145 htEp example hEml 93FscripE 348 var 260 2C3 2C9 20 327668 2C32767 29 400 4 Xx Google Pr File Edit View Favorites Tools Help 7 G0 4r ic G ping Bookmarks w 7blacked P Check 4 AutoLink AutoFill e Sendto _ Settings a
6. p abe A pcoweb Demo Page fay EJ 1 Page c Tabo pCOWeb Demo Page 100 Submit E I ee Figure G c The va r TAG used for writing write completed NOTE The pCO does NOT send an echo in the following cases e the pCO is sent the same value as already saved for the variable e one of the situations in which var returns U see above description of var for reading If waiting for some echo pCOWeb will return the page to the PC after a Timeout of 10 seconds from the reception of the last echo the fields relating to the variables for which no echo has been received will contain the values saved prior to the variations being sent For further details see APPENDIX C on page 65 setres outcome of a write page Returns a value that depends on the result of the last access request to the pCO supervisor variables in which var commands are used see above SYNTAX lt setres UndefinedText OkText TimeOutText Yo gt The three customisable fields are returned in the following cases e UndefinedText the pCO has not been sent a request for the variation of the variables e OkText pCOWeb has received all the echoes for the variations sent to the pCO e imeOutText pCOWeb not has received all the expected echoes IMPORTANT The result of setres does NOT represent the correct writing or reading of a pCO supervisor variable in fact the following special cases exist e forthe write request the pCO re
7. Example 2 Figure 4 1 FTP PUSH and SNMP TRAP programmed to be sent for analogue variable 8 upon activation when increasing and on return with threshold 20 5 and hysteresis 1 5 18 20 nothing sent 2020 5 send both notifications string included alarm fired Threshold 20 5 20 522 nothing sent 2219 5 nothing sent 19 523 nothing sent 25 19 send both notifications string included alarm reenter 1920 5 send both notifications string included alarm fired 20 523 nothing sent Example 3 Figure 4 m below FTP PUSH and SNMP TRAP programmed to be sent for analogue variable 8 upon activation when decreasing and on return with threshold 20 5 and hysteresis 1 5 23 21 nothing sent 2120 5 send both notifications string included alarm fired 20 519 nothing sent 1921 5 nothing sent 21 5 19 5nothing sent 19 5 22 send both notifications string included alarm reenter 2220 5 send both notifications string included alarm fired 20 5 19 nothing sent pCOWeb 030220471 rel 2 0 28 02 2011 Threshold 20 5 ALARM REENTER Hyst 1 5 Threshold 20 5 D 19 5 Lil Lul FIRED ALARM Figure 4 m Analogue and integer variables Example 3 21 4 3 2 Generation of the XML file When a notification event occurs pCOWeb can generate an XML file containing information on the pCOWeb and the values of the pCO variables which can be sent via FT
8. as the root directory each page must be located inside this directory or subdirectory 4 Display the HTML page loaded by typing the location and name in the Internet Explorer address field http 10 0 0 145 example html then press ENTER pCOWeb 030220471 rel 2 0 28 02 2011 16 If a d irectory called newdir was created and the page was loaded into this directory the address would be IMPORTANT http 10 0 0 145 newdir example html Browsers such as Internet Explorer Mozilla Firefox and others create a copy of the pages visited in their cache and when the page is next called the contents may be loaded from the cache rather than requesting an update from pCOWeb This means that at times the desired result is not displayed above all with dynamic pages such as those used on pCOWeb The browsers nonetheless feature of a specific command to force them to update the pages from the web server for example Ctrl F5 requests the page from the server F5 could load from the cache Ctrl F5 should be used whenever there is doubt that the result may haven been loaded from the cache on the PC 4 2 ACCESSING THE USER MEMORY VIA FTP http 10 0 0 145 http example html Windows Internet Explorer CGA T le http 10 0 0 145 http example html File Edit View Favorites Tools Help Google Gr Go 49 O v Ww Bookmark Sign in to Ww abe http 10 0 0 145 httpfexample html pCOWeb Demo Page MAC addr
9. 2 CREATE THE MAILBOX Click point 2 in Figure D a above Create two MAILBOXES entering the User Name and Password in Figure D c on page 67 pcoweb heater pCO password and supervisor password have been used This information will only be used by the client for example Microsoft Outlook to receive the messages pCOWeb 4030220471 rel 2 0 28 02 2011 66 Add New User x User Setup O x General Finger Information 1 User Name Real Name Password Keep Copies Return Address Close ex esi ne Nai supervisor Figure D c ArGoSoft Mail Server creating a M sek Confirm Password AAA Forward Address pcoweb heater pCO r m AILBOX IMPORTANT When in Figure 4 p on page 24 the properties are set for sending the e mail notifications from pCOWeb if ArGoSoft is used it is mandatory not to specify the login Username Password leave the corresponding fields empty NOTE Even if the pcoweb_heater_pCO providerl com MAILBOX is not created pCOWeb still sends the messages to supervisor provider2 com the first MAILBOX has simply been proposed as an example for any messages sent to pCOWeb These messages are not managed by pCOWeb but must be displayed by browser or downloaded by a client ACCESSING THE SERVER VIA WEB The ArGoSoft server features access to MAILBOXES via web pages To do this simply open an Internet browser that can access the com
10. 3 tpe cd 7usr local root flash http new directory for sharing the same Username and Password as usr local root flash http admin 4 type ln s usr local root flash http admin htpasswd htpasswd this creates a link called htpasswd that points to the usr local root flash http admin htpasswd file generated previously REMOVING AN HTML ACCESS RESTRICTION The only way to remove access restrictions that have already been set for the HTML pages contained in a directory is to access the pCOWeb memory via FTP see 4 2 on page 17 and manually delete the htpasswd file in the directory in question 9 7 2 Users of the operating system The functions of the GNU Linux operating system that pCOWeb is based on can be accessed by logging in with one of the following four default non modifiable usernames Table 9 a Operating system Usernames and Passwords Username Password when starting without pressing the button default value Password when starting with the button see 3 1 2 on page 12 modifiable non modifiable root froot httpadmin fhttpadmin carel fcarel guest fguest A modifiable Password Is provided as default for each of the four users The modification does not affect the password that is used to access pCOWeb when started with the button pressed see 3 1 2 on page 12 which is non modifiable The Password can be modified to allow only authorised personnel to access pCOWeb IMPORTANT e Forthis information pCOW
11. CAREL CCYNNXNNNN ENG User manual LEGGI E CONSERVA A ISTRUZIONI lt READ AND SAVE THESE INSTRUCTIONS pCOWeb 030220471 rel 2 0 28 02 2011 pCOWeb 030220471 rel 2 0 28 02 2011 WARNINGS CAREL bases the development of its products on decades of experience in HVAC on the continuous investments in technological innovations to products procedures and strict quality processes with in circuit and functional testing on 100 of its products and on the most innovative production technology available on the market CAREL and its subsidiaries nonetheless cannot guarantee that all the aspects of the product and the software included with the product respond to the requirements of the final application despite the product being developed according to start of the art techniques The customer manufacturer developer or installer of the final equipment accepts all liability and risk relating to the configuration of the product in order to reach the expected results in relation to the specific final installation and or equipment CAREL may based on specific agreements acts as a consultant for the positive commissioning of the final unit application however in no case does it accept liability for the correct operation of the final equipment system The CAREL product is a state of the art product whose operation is specified in the technical documentation supplied with the product or can be downloaded even prior to purchase from th
12. Info amp Contact IBE C IL i rade picowweb MUST never be powered dow Tome mot You sto send bac During tive Firma d g picoyeh e t working and yo wh the lactory equipments otherwise poowWweb mic cn amming he Feisa Carel for reprogr ls bi ta kriirerieo cen c en site LOL jiii minum ain Pj Figure 9 ee Firmware update page Preparing board for upload please wait Shutting down unused services TAKE CARE Even if you stop the upload procedure you need to restart the card to get a fully working environment Figure 9 ff Confirmation of block transferred 6 To start to write the block to NON VOLATILE memory select Proceed and p 3 Reboot no confirmation is requested For block A the effective writing to memory corresponds to the phases in ms Bt CAREL which the Status LED is on steady red for block B on the other hand this Information corresponds to the phase in which the Status LED alternates red green starting some tens of seconds after pressing the button Eo Tests At the end pCOWeb will be rebooted automatically After around 2 minutes the NU updated main configuration page can be opened to check that the firmware version has been changed see Figure 9 d on page 42 Wir wiv Hroceed and reboot Cancel and clear ram Figure 9 gg Block transferred analysis report Start update or cancel 9 10 2 Procedure for updating the firmware
13. in ubicazioni meno protette come in un aeroporto Non si ricever alcun avviso quando Windows Firewall blocca un programma Le Stazioni nella scheda Eccezioni verranno ignorate tivato impostazione sconsigliata ogstazione sconsigliata Se viene disattivato Windows Firewall il Smputer pu essere maggiormente esposto a virus e intrusi Windows Firewall sta utilizzando le impostazioni del dominio Altre informazioni importanti su Windows Firewall Annulla Figure 4 d Disabling Windows Firewall Create a new Local Browser Figure 4 e a new window will be opened showing the contents of the PC Figure 4 f below Then simply drag the directory or files from one window to the other or alternatively delete the files IMPORTANT The pCOWeb web server considers usr local root as the root directory each page must be located inside this directory or subdirectory SmartFTP 10 0 0 145 httpadmin View Tools New Remote Browser Ctrl N New Local Browser gt 42 Reconnect Ctrl R amp Disconnect Ctrl D Commands Favorites Exit 10 0 0 145 E usr local AO root Figure 4 e SmartFTP creating a new Local Browser s SmartFTP Desktop j3 mi x gt File remm L e 10 0 0 145 httpadmin Commands View Tools Favorites Window Help ik Ole IAT P TIE T Folders Ax al Login httpadmin Size Type Descrip Password eeeeeeeee Po
14. ponseshi 3 aned conm 6 Setthe parameters for the Plugin installed clicking the Network Time Protocol link for the NTP Plugin the configuration page is shown in Figure 9 5 Figure 9 r Plugin page after having installed NTP 7 Select the Install uninstall plugins link shown in Figure 9 r above again to return to the Install plugins section the page will be as shown in Figure 9 t Ne OA It can be noted that the link for the installation of the PSS Plugin is no longer present and in its place if there are no other Plugins available for installation the text No install scripts found is shown and below in the Uninstall plugins section is the link to uninstall the Information pCOWeb NTP client system configuration Configuration Clock and Logger Plugin already installed E PIP Tests Customer Site NIP server address 10 0 0 7 Modif Info amp Contact Modify UTC time offset Reboot 1 Modify Submit Figure 9 5 Page for setting the NTP Plugin parameters IMPORTANT If you make some changes via FTP to the Plugin files installed at the end you must fix their access rights by clicking the Fix HTML pages and CGls rights link see 9 3 on page 43 To install other Plugins repeat all the above operations For firmware version before A 1 4 2 to make the Plugin installed operational the pCOWeb must be rebooted pCOWeb 030220471 rel 2 0 28 02 2011 47 9 6 2 U
15. 22 23 lt form method POST action gt 24 lt h4 gt Ntp client configuration parameters lt h4 gt Zo lt table gt 26 ET 21 lt td gt lt B gt Ntp server Address lt B gt lt td gt AB lt L Er gt 29 SIE 30 lt td gt lt getdb conf_users ntp_client conf NTP_URL gt lt td gt 31 lt td gt lt a href javascript modify ntp url Modify lt a gt lt td gt 32 lt td lt input id ntp urit Ssuyle Visibilivy hidden t ypes rexc name z script setdb conf users ntp client conf NTP URL value z getdb conf users ftp client conf NTP URL td DO er 34 table ao lt p gt 36 lt input type submit value Submit gt 37 lt form gt 38 Som 39 a href config scanplugins cgi gt Back to plugins page lt a gt 40 lt html gt DESCRIPTION OF THE LINES also see APPENDIX G on page 71 l Syntax that defines the text shown on the link on the Configuration Plugins HTML page Figure 9 r on page 47 if not present the text shown on the link Is the name of the HTML file IMPORTANT This should not be confused with the pluginname file located in the Plugin installation directory which is only used during the installation and uninstallation phase 4 Syntax telling the pCOWeb to process the page and replace the CAREL tags with the corresponding values this is required to be able to write and read the configuration files 25 The HTML form statement is used to send information
16. 7 blocked W Check X Autolink bal AutoFill a Send tor A Q settings we dw fi pcoweb Demo Page m hi cn Page e Tools pCOWeb Demo Page 19200 Submit zl _ WE fi ERR ER ACTOR ER Cs Figure G f The set db TAG example checkdbsel check whether the value of a parameter in a file is selected Returns the selected string if the value of the parameter contained in the file indicated by the tag is the same as indicated in the tag itself otherwise it returns an empty string SYNTAX lt Ycheckdbsel Filename ParameterName Value gt Used in the construction of drop down menu with the html select command selects the current value of the parameter Example Figure G g below With reference to the commcfg configuration file already seen for the previous tags a drop down menu is created similar to the one used on the configuration page shown in Figure 9 on page 453 so as to allow the selection between the values 9600 19200 and 38400 if the parameter in the file is equal to 19200 the menu will show that value as already being selected lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN gt html lt tagparser pcotagfilt gt lt head gt lt meta content text html charset ISO 8859 15 http eguiv content type gt lt title gt pCOWeb Demo Page lt title gt lt head gt lt body bgcolor 4ffffff hl style text align center gt pCOWeb D
17. Click Connections Another window Figure 3 d right will be displayed PC Click LAN settings all ca a Internet Properties Ti xi Internet Properties General Security Privacy Content Connections Programs Advanced Tosetup an Internet connection click i Setup General Security Privacy Content Programs Advanced r Home page A You can change which page to use for your home page Dial up and Virtual Private Network settings Libero Default Add Remove Choose Settings if ou need to confiqure a proxy server For a connection Address itEps 1 127 0 0 1 WebSupervisorjservlet logi Use Current Use Default Use Blank M Temporary Internet files A Pages you view on the Internet are stored in a special folder li Settings i for quick viewing later Delete Cookies Delete Files Settings History A The History folder contains links to pages you ve visited for 7 46 quick access to recently viewed pages 20 u Clear History Colors Fonts Languages Accessibility Never dial a connection C Dial whenever a network connection is not present C Always dial my default connection Get Default LAN Settings Gurrent Libera gt Local Area Network LAN settings LAN Settings do not apply to dial up connections Choose Settings above for dial up settings Days to keep pages in
18. Ultime notizie TestLink 1 7 4 Carel Portal has been deleted or modified type pCOWeb Default Pa 172 16 0 1 defindex html to save this as index html access the User memory via FIP see 42 on page 17 and copy the file usr local root defindex html to the usr local root flash Rhttp directory renaming it indexhtml any customised index html page will be overwritten This page provides access to the page for configuring the functions of the pCOWeb The network communication parameters should be configured immediately See chapter 8 on page 39 NOTE1 Remember that if pCOWeb is now rebooted for example switching the pCO controller off and on again without pressing the button again as http www carel com described in 5 1 2 on page 12 pCOWeb will use the user set IP address if this is different than the Figure 3 i The default index html page factory value it may be impossible to connect to pCOWeb this situation is described in paragraph 3 2 on page 14 NOTE2 Atthe end of procedure restore the previous configuration on the PC so as to be able to access the network again pCOWeb 4030220471 rel 2 0 28 02 2011 15 3 2 ESTABLISHING A CONNECTION BETWEEN THE PC AND pCOWeb VIA A NETWORK Starting situation e pCOWeb installed on the pCO controller see chapter 2 on page 9 NOTE if the controller is connected to the final installation and is not already on before switching it on contac
19. bin users directory of the Plugin being installed C P 2 They represent the executable files binary files or bash scripts that manage the functions of the Plugin code oe During installation the executable files are installed in the usr local root flash bin_users directory Bene I 7 100 bn which corresponds to the SBIN_USERS system variable the path is included in the SPATH system n variable During installation each of these files are attributed the permission to be executed as envisaged by the BEND Linux operating system shown in Figure l c The following executable files are included in the NTP Plugin e ntpdate this handles communication with the NTP server and writes the time to the system clock EM Figure l c Linux permission for executing the ntpdate files e ntp sh this handles the management the latter is described in detail below pCOWeb 4030220471 rel 2 0 28 02 2011 85 The ntp sh script file This runs the ntpdate binary file deletes any temporary files created by ntpdate and if this is involved in the periodical updating of the time manages the cycle of updates il bin sh 2 etc profile gt dev null E SCONE USERS np Client Conf 4 5 White LL OR X6 6 ntpdate S NTP_URL gt dev null P date 8 fm y teed Lp AES 9 sleep 3600 10 done DESCRIPTION OF THE LINES l Specifies the command executor currently the only one featured on the pCOWe
20. recognise the following row in an html page the row position is irrelevant lt tagparser pcotagfilt gt following which the web server searches for the pcotagfilt program in the default root position for the web server usr local root and then starts it sending all the contents of the html page The pcotagfilt program recognises the CAREL tags replaces them with the results and returns the resulting html page IMPORTANT Ifthe row lt tagparser pcotagfilt gt is not included in the html page the CAREL tags will not work and will be shown on the PC as they are written NOTE Browsers such as Internet Explorer Mozilla Firefox and others create a copy of the pages visited in their cache and when the page is next called the contents may be loaded from the cache rather than requesting an update from pCOWeb This means that at times the desired result is not displayed above all with dynamic pages such as those used on pCOWeb The browsers nonetheless feature of a specific command to force them to update the pages from the web server for example by using F5 both Internet Explorer and Mozilla Firefox update the page but by using Ctrl F5 they do it without using the cache contents Ctrl F5 should be used whenever there is doubt that the result may haven been loaded from the cache on the PC CAREL TAGS FOR HANDLING THE pCO VARIABLES var read write a variable Used to read or write the value of a
21. system index gt Short Description A short Figure 5 d Logger and graphs configuration description which will be used in the CSV file to describe the variable gt Group see below gt Colour Colour of the line used to represent the variable in the graph Tests peni Customer Site qmi pm m pm jm m jm Group 2 Right Axys lt LLLL Lee Time Manual wi i id 65 Group 3 Digital Variables Digital e Submit pcowebGcarel com GROUPS AND SCALES The graph is able to represent up to five different streams of data and therefore in order optimize the scales used it is necessary to define two or more sets of data temperature pressure power consumption so that they can be gathered together and therefore represented in one of the two scales one on left hand side of the graph and one of the right hand side without losing resolution and quality or overcomplicating the graph Each and single variable represented in the graph has to be assigned to one of the following groups Group 1 Left Axis Group 2 Right Axis Group 3 Digital Variables Dig To correctly represent the variables in the graph it is very important to define meaningful ranges for the scales these ranges can be obtained by pCOWeb 030220471 rel 2 0 28 02 2011 50 Auto Adaption the graph will automatically calculate the highest and lowest value reached by the all the variables of
22. the message will be ignored 6 2 THE pCOWeb SNMP TREE The format of the CAREL pCOWeb OID object identifier is lub di gd 1 9999 CARE up Lis where A 1 pCOWeb properties A B T1 Agent release read only 2 for firmware A1 3 5 B1 2 1 3 for firmware A1 4 2 B1 2 1 1 520 Agent code read only 2 pCOWeb A B C D USES E S ALARM FIRED string read write PES ANS D ALARM REENTERED string read write A 2 pCO properties A B C D Desa WO es communication status with pCO read only 0 pCO offline 1 communication attempt 2 pCO online 2e e qus e No of communication attempts with pCO read only O when ok or during o 1ine each 5 attempts PAE AR EA pCO variables read write t type of variable 1 Digital 2 Analogue 3 Integer i variable index NOTE1 SNMP requires the use of the final zero when referring to scalar objects that is not tables or lists All pCOWeb objects are scalar NOTE2 Reading the pCO variables with indices that are not managed by the BIOS version used return insignificant values NOTE3 When a value is undefined i e the summary web page shows U SNMP browser returns 858993460 NOTE4 A variable is always read write however the value will be retained only if featured in the pCO application program Example ladao l42 2 9999 7419234540 type 2 pCO variable analogue with index 45 pCOWeb 4030220471 rel 2 0 28 02 2011 54 6 5 MIB FILE The objects contained in
23. 0var 0 5 5000 52768 52767 0 0 gt SNMP Fully compatible with version lt A135 Trap event notifications are available only for the first 207 variables range has not been extended from A135 The ranges of variables have been extended as explained here below Digital variables OID from 1 3 6 1 4 1 9839 2 1 1 1 0 up to 1 3 6 1 4 1 9839 2 1 1 2048 0 Analogue variables OID from 1 3 6 1 4 1 9839 2 1 2 1 0 up to 1 3 6 1 4 1 9839 2 1 2 5000 0 Integer variables OID from 1 3 6 1 4 1 9839 2 1 3 1 0 up to 1 3 6 1 4 1 9839 2 1 3 5000 0 gt Modbus TCP IP Fully compatible with version lt A135 The ranges of variables have been extended as explained here below Digital variables coils from 1 up to 2048 Analogue variables registers from 1 up to 5000 Integer variables registers from 5001 to 10000 BACnet Fully compatible with version lt A135 if using Carel protocol with modbus extended the mapping of the variables into BACnet objects changes completely to allow a larger number of variables Digital variables Binary value objects from 1 up to 207 Carel Protocol 100001 up to 102048 Modbus extended protocol Analogue variables Analogue value objects from 1 up to 207 Carel Protocol 100001 up to 102048 Modbus extended protocol Integer variables Analogue Multistate value objects from 1001 up to 1207 Carel Protocol 200001 up to 202048 Modbus extended protocol gt Clock Synchronization Variables used to synchronize the clock have
24. 2011 20 Oggetti 1 lo bytes gt 4 Example 2 E mail and FTP PUSH programmed to be sent when digital variable 12 changes from 0 1 and 1 0 0 1 send both notifications 1 0 send both notifications Analogue and integer variables For analogue and integer variables the value that crosses a programmable threshold generates an activation event if the threshold plus hysteresis is crossed backwards a return event is generated For each variable the following can be set e the direction for crossing the threshold considered as activation e send notifications only upon activation or upon activation and return the threshold numeric value or content of a pCO variable the hysteresis numeric value or content of a pCO variable for the return event In addition two identification strings can be customised that are common to all the variables default alarm fired alarm reenter to be included in the e mail and SNMP notifications to identify the activation and return events Example 1 Figure 4 k FTP PUSH and SNMP TRAP programmed to be sent for analogue variable 8 only upon activation when increasing with threshold 20 5 and hysteresis 1 5 18 20 nothing sent 2020 5 send both notifications string included alarm fired 20 522 nothing sent 2219 5 nothing sent 19 523 nothing sent 25 19 nothing sent 19 23 send both notifications string included alarm fired
25. BE SENT lt xml version 1 0 encoding UTF 8 lt PCOWEB gt lt SYSTEM gt lt HOSTNAME gt localhost lt HOSTNAME gt lt DATE gt 19700101064832 lt DATE gt IP ADDRESS gt 10 0 3 114 lt IP ADDRESS gt MAC ADDRESS gt 00 0a 5c 10 07 15 lt MAC ADDRESS gt lt UPTIME gt 0d2h42m lt UPTIME gt lt SYS_VERSION gt B1 2 1 lt SYS VERSION gt lt APP_VERSION gt A1 4 2 lt APP _VERSION gt lt SEPARATOR CHAR gt lt SEPARATOR CHAR gt lt SYSTEM gt lt PCO gt lt PCONAME gt Template Sample lt PCONAME gt lt PCOID gt 1 lt PCOID gt lt DIGITAL gt lt VARIABLE gt lt INDEX gt 1 lt INDEX gt lt VALUE gt 0 lt VALUE gt lt VARIABLE gt lt VARIABLE gt lt INDEX gt 2 lt INDEX gt lt VALUE gt 1 lt VALUE gt lt VARIABLE gt lt DIGITAL gt lt INTEGER gt lt VARIABLE gt lt INDEX gt 1 lt INDEX gt lt VALUE gt 25 lt VALUE gt lt VARIABLE gt lt VARIABLE gt lt INDEX gt 2 lt INDEX gt lt VALUE gt 200 lt VALUE gt lt VARIABLE gt lt INTEGER gt lt ANALOG gt lt VARIABLE gt lt INDEX gt 1 lt INDEX gt lt VALUE gt lt VALUE gt pCOWeb returns the current value multiplied by 10 lt VALUE gt 9999 lt VALUE gt 999 9 x 10 9999 of the analogue variable with index 1 lt VARIABLE gt End of the section for the analogue variable with index lt VARIABLE gt 1 lt VARIABLE gt lt VARIABLE gt
26. Ethernet LED Meaning Notes Green steady Correct Ethernet data connection signals Green flashing Correct Ethernet data exchange Red No Ethernet signal detected See 3 1 3 on page 13 pCOWeb 030220471 rel 2 0 28 02 2011 8 2 INSTALLATION ON THE pCO CONTROLLER 2 1 ASSEMBLY Equipment required e a3mm flat head screwdriver e a map of the installation only when installing two or more pCOWeb devices e a pair of scissors Figure 2 a pCOWeb and the accessories supplied Figure 2 b Removing the cover from the pCO controller IMPORTANT to avoid damage before inserting pCOWeb disconnect power to the pCO controller Li PCO l at ai ni S as d 00 nA 5C 10 00 81 EHE Figure 2 c Inserting pCOWeb in the pCO controller Figure 2 d Securing pCOWeb with the cover 2 2 LABELS SUPPLIED Each pCOWeb is uniquely distinguished by its own MAC address The network administrator may at times need to check the MAC address of each pCOWeb installed The MAC address is shown on the label applied to the connector and on the two labels included in the packaging in the example shown in Figure 2 e the MAC address is 00 0A 5C 10 00 81 Once installed pCOWeb may however no longer be accessible Therefore during installation use the scissors to separate the two labels supplied and apply one in an easily accessible position near the pCO controller on the outside of the electrical panel If more than one pCOWeb device is inst
27. GREEN in normal conditions If it remains red the causes may be e the PCis off e or the connector has not been inserted on the pCOWeb e or the connector has not been inserted on the PC e or the cable is not working or the PC requires a crossover cable and this has not been used 3 1 4 Accessing pCOWeb from a PC Blank Page Windows Internet Explorer _2p0 pmP On the PC open Internet Explorer in the address field enter the following number including x ex the dots File Edit view Favorites Tools Help 172 16 0 1 Google G je g O m TY Bookmarks ES 0 blo then press ENTER Be de slank Page n IMPORTANT Before pressing ENTER wait for pCOWeb to complete the start up phase check that the Status LED is flashing normally otherwise the required web i pages will not be sent to the PC Figure 3 h Opening the index html page The pCOWeb main page index html will be displayed see Figure 3 1 below IMPORTANT This page can be customised by the user and by default appears as shown in Figure 3 1 below If it has been modified or deleted the custom page or nothing will be displayed in these cases remember that a copy of the factory page is Ife Tete O PE EEA avallable in read only memory File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto 9 C xa http 172 16 0 1 http index html gt 8 To recall the factory page even if indexhtml Pi visitati Ci Come iniziare
28. Limit text PROP_ALARMLOWLIM 3008 Character string String up to 32 characters to replace to state Low Limit text pCOWeb 030220471 rel 2 0 28 02 2011 5 7 3 2 COV Subscriptions The DS COV B and or DS COVP B BIBB support a maximum 250 simultaneous subscriptions The following properties are eligible for COV reporting using the SubscribeCOVProperty Service Present Value e Status Flags e Reliability e Event State e Out of Service 7 3 3 Commandability BACnet commandability is supported for the Analogue Values Binary Values and Multi state Values on an individual object basis In addition to being optionally selected as commandable each of these individual objects may be programmed as read only or writable but not commandable This condition is controlled by writing to the proprietary property 1014 for the appropriate object For the proprietary property 1014 a value of 0 indicates read only 1 indicates writable but not commandable and 2 indicates commandable The Priority_Array and Relinquish_Default properties are present only if the proprietary property 1014 is 2 for an individual object By default the proprietary property 1014 has a value of 1 writable but not commandable for backward compatibility with older versions of the pCOWeb when delivered from the factory 7 3 4 Schedules BACnet schedules are supported and made visible through the 16 Schedule and 16 Calendar objects For each Calendar object there can be from 0
29. Mozilla Firefox pCOWeb Configuration Mozilla Firefox Fle Modifica Visualizza Cronclogia Segnalibri Strumenti Auto File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto hitp 10 0 3 114 config adminpage html n i gt amp i hitp 10 0 3 114 configladminpagehbm f Pi visitati Come iniziare Ultime notizie TestLink 1 7 4 gt Care Portal English to French Italia p OWeb Configura http 10 0 3 114 eenfg pw administrator himi Figure 9 1 Setting the pCOWeb pCO communication speed 9 5 1 Extended range ad functionalities All the protocols and some of the functionalities of pCOWeb have been extended to cover the entire range of variables made available by modbus extended pCOWeb returns Undefined if requesting a variable which is not available on the database of modbus extended pCO application doesn t support the specific index and Error if requesting a variables which is out of the boundaries defined in the configuration page pCO Com Web Pages All the web pages designed for pCOWeb lt A135 are fully compatible with version A142 and modbus extended The ranges of variables have been extended as explained here below Read write digital variables ofyar 0 1 1 0 1 90 up to lt var 0 1 2048 0 1 gt Read write analogue variables lt ovar 0 2 1 3276 8 3276 7 gt up to lt var 0 2 5000 3276 8 3276 7 gt Read write integer variables lt var 0 3 1 32768 32767 gt up to 9
30. To check the setting of DHCP mode on the pCOWeb follow the same procedure as described below for the network without DHCP e network without DHCP in this case before connecting pCOWeb to the network the DHCP system active by default must be disabled and a different specific address entered for each pCOWeb These procedures are described below pCOWeb 030220471 rel 2 0 28 02 2011 45 9 4 1 Network configuration This is the most important configuration Without this in fact pCOWeb will not be able t0 pgg T L communicate correctly with the Ethernet network Information mmm 1 Starting by the main configuration page Information Figure 9 b on page 41 dick Configuration Ilo Qd Events then dick the Network tab Figure 9 YE a m Customer Site The page shown in Figure 9 k below is displayed Info amp Contact This page is used to set the following fundamental user network parameters Fies IP address Figure 9 j Opening the network configuration page NetMask NOTE1 The values set will be saved to non volatile memory only when selecting the Submit button Networking Confiquration IMPORTANT The values set will only be used when pCOWeb is next rebooted Etho DHCP NOTE2 If pCOWeb is started when the button is pressed paragraph 3 1 2 on page 12 the Bootswitch settings will be used instead of these values see Figure 3 g on page 12 SETTINGS AVAILAB
31. accesses the Internet via a central server on the network which has the task of managing the traffic to the outside Normally the server features a proxy so as to store the last pages accessed In Its memory and if on the websites these have not been changed date file size rather than download them from the sites it provides its own copy thus avoiding useless data traffic in general a proxy returns a result that depends on the rules set on the proxy If pCOWeb is installed in a network with a proxy server the browser on the PCs in the network are normally already set to send their HTML page requests to the proxy In this case if the network server has not yet been set to locate the pCOWeb in the network a personal computer will not be able to access the pCOWeb HTML pages via the proxy Consequently the easiest solution is to disable the proxy on the PC used to contact the pCOWeb This means however that the PC will not be able to access the Internet via the intranet FURTHER INFORMATION The mechanism for the transmission of a data packet is illustrated below NOTE A network device can contact another device only if its MAC address is known or the MAC address of the corresponding gateway that it connects through and this is included in the transmission packet in fact the first filter for reception on each network device is a network board that rejects all the messages that are not sent to its own MAC address The transmission me
32. changed once the connection has been established with the PC when first accessing the device the personal computer will need to be configured to adapt it to the pCOWeb default settings A disconnect the personal computer from the data network if connected and connect it directly to the pCOWeb using the cable crossover 2x B IP ADDRESS AND SUBNET MASK General auteracsten Advanced Gern Atonso Corato INFORMATION LL dia capui Ohana you aed to a pou named odiata fa no MIA Rini I Fast E ihanat Adapter Corhigan the appicpriate IP settings The personal computer must be set not to use the DHCP but rather the following IP address 172 16 0 2 The Subnet mask field also needs to be set vm HN 2 deir imei rum the Gateway is not required o For further information on the meaning of these parameters see APPENDIX A j al on page 61 and APPENDIX B on page 62 mE FOGA DIS papali RUE Teorcirms aon Control ProtocalIntemr Protocal The def aul C Use the following ONS server addrerser wade atea network protocol that pondes communication On the Windows PC click the mouse on the Start button at the bottom left eee Choose Settings Pai O aes Em Click Control panel Double click Network and dial up connections Double click Local area connection Click Properties the window shown in Figure 3 b left is displayed Figure 3 b Network settings Double click Internet Protocol TCP IP
33. event 1 overall 40 settings windows are available SETTINGS AVAILABLE gt Main enable enable the generation of scheduled events for this window gt Timeout repeat time the first event will be generated after the Timeout has elapsed from when the Submit button was selected the following events will be generated when the Timeout has elapsed again gt Variable type Variable index the scheduled events in the current setting window use some decisions set in the windows for the events based on variations see 4 3 4 on page 25 related to the variable selected by these two settings The shared settings are in the following sections Events Handlers Trap Configuration E mail Configuration NOTE The SNMP TRAP and e mail notifications relating to scheduled events for analogue and integer variables always automatically include the string entered in the Alarm fired field in Figure 4 r on page 25 pCOWeb 030220471 rel 2 0 28 02 2011 28 5 CLOCK AND LOGGER 5 1 CONFIGURING CLOCK WITH pCO SYNCHRONIZATION pCOWeb features an internal clock that keeps its settings only while power is supplied When rebooting the date time is reset to 1970 01 01 00 00 pCOWeb can be configured so that every minute it sets its own clock based on the time set on the pCO controller For this to occur the application program running on the pCO must continuously transmit the information on five selected integer supervisory variables The p
34. following settings are valid from when they are confirmed the pCOWeb does not need to be rebooted PROCEDURE 1 Open the window for setting the events corresponding to the DIGITAL variables click point 4 in Figure 4 n on page 23 A summary window is displayed for enabling the events relating to the variation of all the digital variables Figure 4 s below Moving the mouse for example over the section relating to digital variable 1 shows the tooltip Digital Variable 1 clicking opens the window divided into three sections for setting the events linked to digital variable 1 IMPORTANT The range of variables related to the notifications goes from 0 to 207 even if the ModBus Extended protocol is running Variables addresses for notifications can go just from 0 to 207 IMPORTANT The Submit buttons only save the values for the corresponding section hip 1000 0145 Digital Variables aslbilical iens Horia Firle Analog Integer variables variahl s Timed events Bitty 1004S Notification Labor variable Digital 1 Mozilla Mirefon ie Digital Yariable 1 General Configuration Fer Digital Variables Click here to set a Digital Variable 1 event Event Handlers raj General Enable Enable all the Gwent Trap Email Feo push configured T Trap SNMP Enable Trap sending Push E E mail Enable E Mail sending F Fip Push Enable FTP PUSH management Submit cl Wi iy hiipi ODA Scone roti map digikal Honlar Co
35. from the html page to the pCOWeb note that the method must always be POST 30 The getdb tag is used to display the value of a setting in the configuration file specified The example refers to the value associated with NTP URL in the ntp_client conf file located in usr local root flash etc sysconfig conf_users the full path does not need to be specified if the file is located in a subdirectory of usr local root flash etc syscontig another directory can be specified by correctly indicating the full path starting from the root nonetheless it is recommended to use the suggested directory so as to maintain coherence in the structure of all the Plugins developed 32 This HTML statement defines an input field used to display and modify the value associated with a parameter in a configuration file The setdb statement can be used to modify the value associated with the variable when the Submit button is selected on the form Ntp server Address 36 Closing the page the Submit button is displayed i Modify 39 Link that selecting the Submit button refreshes the display of the pCOWeb Plugin Submit configuration page Administrator authentication see 9 2 1 on page 41 is required to display the page Figure l b Field used to set the address of the NTP server The field displayed to change the value of the NTP URL parameter is as shown in Figure b EXECUTABLE FILES These are ALL the files in the Plugin
36. identifying the events for integer and analogue variables http 10 0 0 145 Notification Editor Mozilla Firefox click point 3 in Figure 4 n on page 23 The settings in this window Figure 4 r will only be used for e mail and SNMP TRAP INFORM messages and will be common to the events generated by all the integer and analogue variables In the e mail notifications the suitable string will be automatically added to the Subject field separated by a dash in the SNMP TRAP notifications the OID will be included automatically with the corresponding string and contents based on the event as follows see 6 2 on page 34 Notification messages alarm fired alarm reenter 1 3 6 1 4 1 9839 1 3 1 1 0 OIDforthe Alarm fired event string submit 1 3 6 1 4 1 9839 1 3 1 2 0 OID forthe Alarm reentered event string SETTINGS AVAILABLE Close Window NE m i gt Alarm fired string that will be included in the notifications when the threshold iS femeas exceeded gt Alarm reentered string that will be included in the notifications when returning back Figure 4 r Setting the strings sent for Activation below the threshold with hysteresis Return 4 3 4 Setting the notifications set upon variations in the variables IMPORTANT Some settings described below Event Handlers Trap Configuration and E Mail Configuration are also used for the scheduled events see 4 3 5 on page 27 NOTE all the
37. isn t gt EMail Account required for sending e mail notifications in the message received this will be shown as the sender s e mail address If this address is required to send e mails to the pCOWeb remember m that pCOWeb does not feature a client for reading or downloading the How 5 messages these must then be read downloaded using a dient for OO example Microsoft Outlook that accesses the e mail server corresponding to the domain address in this field in the example Submit providerl com the corresponding MAILBOX must have been E created on the server also see the APPENDIX D on page 66 gt Identification optional in the message received this will be displayed Figure 4 0 SNMP Hosts configuration for sending the TRAP as the sender s name messages gt Reply to optional if the recipient selects the Reply to option in the e mail client used this represents the return e mail address that the ISITTTSTIT s S SHE ATTEN RIA reply will be sent to http 10 0 3 114 config hostcfg html gt Destination N at least 1 required e mail addresses that pCOWeb will send the messages to gt SMTP Server Address required IP address or name of the server that pCOWeb connects to in order to send the messages if a name is specified instead of an IP address a DNS must have been specified see 9 4 1 on page 44 XML template for attachment required for attachments this is used to choose the XML templ
38. lt VARIABLE gt lt INDEX gt 101 lt INDEX gt pCOWeb 030220471 rel 2 0 28 02 2011 02 lt VALUE gt 0 0 lt VALUE gt lt VARIABLE gt lt VARIABLE gt lt INDEX gt 102 lt INDEX gt lt VALUE gt 0 0 lt VALUE gt lt VARIABLE gt lt ANALOG gt lt PCO gt lt PCOWEB gt After receiving the XML the library parses it and loads the information to the three arrays declared on the top of the javascript code of the HTML page It Is very important that the name of the arrays have to be kept to analogs digitals and integers The current time of the pCOWeb received will be loaded into the variable timestamp parseResults only from version A142 Starting from Version A142 the pw_ajax s library is using a new function called parseResults which is executed as soon as the browser receives the xml from pCOWeb so that the values shown in the html can be updated without waiting for the next run of the javascript code Up to version A135 the function responsible to read from the javascript arrays digitals integers and analogs was executed just after having sent the request for the xml file to the pCOWeb before having the new values loaded into the arrays therefore it was necessary to wait for the next time the function is executed to have the values shown on the web page the web pages were always showing the values received on the previous request This reduces the time to values when the web page
39. or not it can contact the server s IP address directly if not enabled it will send the request to contact a network helper called the gateway which will forward the message to the recipient and will do the same for the response the gateway can be contacted by the PC as the user will have specified the IP address provided by the network administrator this IP must be directly contactable Direct contact depends on the combination of the following numbers e P address of the destination e P address of the personal computer e Subnet mask of the personal computer The communications manager using these three numbers establishes whether the recipient s IP address belongs to the range called the subnet of IP addresses it is enabled to communicate with without having to go through the gateway The destination IP addresses it can communicate directly with satisfy the following criterion the bits of the destination IP address corresponding to those that in the Subnet mask are equal to 1 must have the same value as the bits of the source IP address In the following examples to simplify the explanations it is assumed that the DNS server is located within the network it must also be remembered that there are no limits to fact whether the DNS server is located within or outside of the network 0 00000000 64 01000000 240 11110000 64 01000000 64 NOTE The subnet mask cannot have just any value it must follow a numbe
40. pCOWeb for an installation that does not use DHCP automatic address setting See 9 4 on page 42 3COWeb Paragraph 3 2 on page 14 on the other hand describes the network connection procedure Equipment required e A computer running for example Internet Explorer and fitted with an Ethernet network interface if pCOWeb is already installed in the final destination and cannot be removed a _ portable computer is handier cross cable e A crossover network cable recent computers do not require the crossover cable a normal cable can be tried in any case if the crossover cable is required this will be established when connecting Figure 3 a Direct PC pCOWeb connection Starting situation e pCOWeb installed on the pCO controller see paragraph 2 1 on page 9 e DCO controller NOT powered IMPORTANT if the pCO controller is connected in the final installation before powering up contact the installation manager The steps to be completed are as follows l Configuration of the PC for direct connection to pCOWeb 2 Connection and start up of pCOWeb to check correct installation 3 Activation of the factory network settings button 4 Accessto the pCOWeb from the PC 3 1 1 PC configuration INFORMATION The PC can communicate with pCOWeb if the settings on both devices are correctly aligned As the pCOWeb default settings can only be
41. some variations that have not yet been confirmed by the pCO pCOWeb does not generate the confirmation html page on the browser a 10 seconds Timeout is reset whenever each new confirmation is received the html confirmation page will be generated and sent back when all confirmation have been received OR when the Timeout expires 5 The value is received by the pCO and saved in the corresponding communication buffer comm buffer var value together with a variation received flag comm buffer delta flag set the flag is only raised if the value received is different from the existing value 4 lfthe application running on the pCO contains the atom for receiving the variable RX_ATOM when the atom is run it detects the raised flag resets the flag comm buffer delta flag reset and transfers the new value to the variable example AN12 for use within the application at the same time it books the re transmission of the variation by raising the flag in the communication buffer on the pCO comm buffer tx flag set 5 fthe application running on the pCO contains the atom for sending the variable whenever this is run it checks whether the value of the communication buffer comm buffer var value is different from the value of the variable in the application AN12 if it is different it transfers the value of the variable in the application to the communication buffer and books the re transmission of the variation by raising the flag in the co
42. that the PC is not running a firewall to block unwanted connections for example in Windows XP Windows Firewall is normally active and in the default configuration this blocks FTP communication to modify the settings open the Control panel select Windows Firewall and disable it Figure 4 d IMPORTANT pCOWeb 030220471 rel 2 0 28 02 2011 Some FTP clients do not use the request from pCOWeb to open the user memory for httpadmin usr local root flash http but rather show the contents of the root position the user needs to manually go to usr local root flash http SmartFTP View Tools Favorites Window Help New Remote Browser Ctrl N Windows Firewall Generale Eccezioni Avanzate New Remote Browser x General COWeb IP address Paste URL Mormal FTP ti NA ij 10 0 0 145 Protocol Host Path Favorites gt Quick Connect O cee Figure 4 c SmartFTP creating a new Remote Browser X l computer non protetto Attivare Windows Firewall Windows Firewall facilita la protezione del computer dagli accessi non autorizzati da Internet o da una rete Q C Attivato impostazione consigliata Questa impostazione blocca la connessione al computer da parte di tutte le origini esterne tranne quelle selezionate nella scheda E ccezioni Non consentire eccezioni Selezionare questa opzione quando ci si connette a reti pubbliche
43. the device as the internal circuits and mechanisms may be irreparably damaged e do not use corrosive chemicals solvents or aggressive detergents to clean the device e do not use the product for applications other than those specified in the technical manual All of the above suggestions likewise apply to the controllers serial boards programming keys or any other accessory in the CAREL product portfolio CAREL adopts a policy of continual development Consequently CAREL reserves the right to make changes and improvements to any product described in this document without prior warning The technical specifications shown in the manual may be changed without prior warning The liability of CAREL in relation to its products is specified in the CAREL general contract conditions available on the website www carel com and or by specific agreements with customers specifically to the extent where allowed by applicable legislation in no case will CAREL its employees or subsidiaries be liable for any lost earnings or sales losses of data and information costs of replacement goods or services damage to things or people downtime or any direct indirect incidental actual punitive exemplary special or consequential damage of any kind whatsoever whether contractual extra contractual or due to negligence or any other liabilities deriving from the installation use or impossibility to use the product even if CAREL or its subsidiaries are warned of
44. the html page digitals integers analogs And one variable optional timestamp A142 getParams The function getParams using the very common browser function XMLHttpRequest http en wikipedia org wiki XMLHttpRequest retrieves values from pCOWeb executing xml cgi xml cgi is an application custom made for pCOWeb to generate an xml file containing the values requested by the arguments of the function getParams the URL that the browser will request to the pCOWeb following the example is http lt ip_address_pCOWeb gt config xml cgi D 1 2 I 11 12 A 101 102 The syntax of the query is xml cgi VAR_TYPE START_INDEX END_INDEX the string allows to request many ranges of variables up to the maximum length allowed by the browser Starting from version A142 xml cgi is able to recognize the argument N positioned at the beginning of the request so that the xml file returned by pCOWeb will use the new and more performing format the request now will look like http ip address pCOWeb config xml cg N D 1 2 I 11 12 A 101 102 The library pw ajax s in config of the firmware gt A142 is automatically using the new format for the xml file therefore for the applications designed for firmware A135 in order to use the new format they have to If the web pages are importing the library using the path config pw ajax s nothing has to be done to update them ifthe web pages are us
45. the name of the pCOWeb always localhost Returns date and time the file was generated in the Returns the IP address of the pCOWeb Returns the MAC address of the pCOWeb pCOWeb Bios Applications No action Suggests the character that the XML interpreter can use as the separator for the values of the analogue variables p COWeb properties that is not pCO pCO properties No action Line used to assign a name to the specific pCO in the example the name is Template Sample No action Line used to assign an identifier number to the specific pCO in the example the number is 1 Start of a section for digital variables Start of the section for one digital variable Specifies the index 1 for the variable to pCOWeb pCOWeb returns the current value 0 of the digital variable with index 1 End of the section for the digital variable with index 1 Start of the section for another digital variable Specifies the index 2 for the variable to pCOWeb pCOWeb returns the current value 1 of the digital variable with index 2 pCOWeb returns the current value 2 5 of the integer variable with index 1 End of the section of the integer variable with index 1 Start of section for another integer variable Specifies the index 2 for the variable to pCOWeb pCOWeb returns the current value 200 of the digital variable with index 2 End of the section for the integer variable with index 2 22 LINE GENERATED IN XML FILE TO
46. the pCOWeb it must have the following characteristics e Architecture ARM e Recommended compller gcc 2 95 5 e Linux Kernel 2 4 21 e Glibc 225 e Textutils Dil e Fileutils 4 0 e Sh utils 20 e Inetutils 1 5 2 pCOWeb 4030220471 rel 2 0 28 02 2011 88 INDEX SBIN USERS 85 86 SCONF_USERS 84 86 SPATH 85 SRC_USERS 86 Sbootvalues 7 78 Scheckdbradio Ycheckdbsel 76 77 Sdate 77 78 Sfw release ogetdb 74 75 85 Sipaddr 77 78 lt macaddress 16 77 setres 75 80 Yovar 71 72 75 79 80 amp gt 78 amp lt 7 8 gr 30 htpasswd 41 49 50 dev nul1 86 87 admin 41 43 49 50 Alarm fired 25 28 Alarm reentered 25 ARM 88 ARP 63 64 atom 65 backup 40 BACnet 8 29 56 59 bash 16 46 85 86 87 88 baud 43 45 74 bin users 84 85 BIOS 34 42 52 53 65 71 button 8 10 11 12 13 17 23 26 28 31 32 40 41 42 43 44 49 50 51 52 53 54 55 56 65 67 68 70 73 78 80 85 cache 17 31 32 56 71 CGI 7 16 43 clock 29 30 36 59 77 84 85 Clock 30 Community 24 34 35 compiler 88 conf users 84 85 CPU 59 cvs 50 51 32 date 22 24 26 29 30 31 42 54 62 77 78 86 defindex html 15 40 deftemplate xml 22 DHCP 8 10 12 45 44 59 61 78 DNS 24 43 44 51 59 62 63 do flashroom 78 do ifconfig 78 echo 65 75 87 e mail 7 8 20 21 22 25 24 25 26 28 35 44 66
47. the possibility of such damage TT WARNING M Jj Nese separate as much as possible the probe and digital input signal cables from the cables carrying inductive loads and power cables to MSS avoid possible electromagnetic disturbance READ CAREFULLY INTHETEXT Never run power cables including the electrical panel wiring and signal cables in the same conduits DISPOSAL The product is made from metal parts and plastic parts In reference to European Union directive 2002 96 EC issued on 27 January 2003 and the related national legislation please note that 1 WEEE cannot be disposed of as municipal waste and such waste must be collected and disposed of separately 2 the public or private waste collection systems defined by local legislation must be used In addition the equipment can be returned to the distributor at the end of its working life when buying new equipment 3 the equipment may contain hazardous substances the improper use or incorrect disposal of such may have negative effects on human health and on the environment 4 the symbol crossed out wheeled bin shown on the product or on the packaging and on the instruction sheet indicates that the equipment has been introduced onto the market after 13 August 2005 and that it must be disposed of separately 5 in the event of illegal disposal of electrical and electronic waste the penalties are specified by local waste disposal legislation pCOWeb 030220471 rel 2 0 28 02 2
48. the same group and automatically adjust the scale Manual Limits are defined by the user if one or more values overtake the boundaries they will be showed like if they are going of the graph IMPORTANT COWeb offers also the possibility to make graph in BMP format the only available format before 1 4 2 pCOWeb creates a file in bmp format containing a simple graph of the trend in the values of just vc 3 http 10 0 5 45 config pw logcfg bmp html one of the logged variable There is a specific html Pi visitati Come iniziare amp Ultime notizie TestLink 1 7 4 Carel Port age to set the type of the graph called pw logcfg bmp html typing in the browser Carel Portal ksa knowledge sha Graph Configui http 10 0 5 45 config pw logcfg bmp html pCOWeb will display the page on the Figure beside 3rapl BMP bitmap v ACTON After switching pcoweb to the favourite graph BMP bitma format it is necessary to go back to the logger page and configure again the logged variables After this to let the new settings work it is mandatory to reboot pcoweb carel com Figure 5 e Relation between indexes and values HOW THE RECORDS ARE SAVED Whenever the specified time interval expires the sampled values are added to a temporary file resident in VOLATILE memory at 00 minutes each hour the data is downloaded to a file history diskbuffer in proprietary format in NON VOLATILE memory usr local root
49. the user parameters pCOWeb 030220471 rel 2 0 28 02 2011 12 3 1 3 LED signals when starting and during normal operation Immediately after reboot the Status LED and Ethernet LED must come on as described below If remain both off check e the correct installation of pCOWeb on the pCO controller e the connection of the power supply The Status LED pCOWeb status and pCOWeb pCO communication see Table 1 a on page 8 behaves as follows immediately after reboot 1 Remains off for 2 seconds 2 then flashes quickly green red for a further 2 seconds 3 then comes on GREEN steady for around one and a half minutes unless the button is pressed see 3 1 2 on page 12 4 then starts flashing GREEN or RED e GREEN flashing pCOWeb has completed the start up phase and is communicating correctly with the pCO e RED flashing pCOWeb has completed the start up phase but is not communicating with the pCO this may be due to incorrect settings of the pCOWeb or some of the parameters on the pCO the default parameters ensure correct communication therefore this situation will only occur if the parameters have been changed In this case after having established the PC pCOWeb connection check the communication settings see 9 5 on page 44 e RED without flashing Rescue Mode see 9 10 3 on page 55 e GREEN without flashing for at least 3 minutes fault contact CAREL Industries S r l service The Ethernet LED see Table 1 b on page 8 is
50. to 16 dates in the Date_List For each Schedule both the Weekly_Schedule and Exception_Schedule properties are supported Each object s Exception_Schedule list can have from 0 to 4 entries Each Weekly Schedule and each Exception Schedule can have from 0 to 6 Time Values Each object s List Of Object Property References property can have from 0 to 64 entries External objects are not supported Following a restart schedules are not executed until the pCOWeb clock has been set using a TimeSynchronization or UTCTimeSynchronization Schedules are checked approximately every 10 seconds for a minute rollover so scheduled values may not change until 10 to 15 seconds after the minute turns over Carel 7 5 5 Default Factory Settings Default values for the pCOWeb are as follows Table 7 d Factory Settings Property Device Instance IAN pe BACnefIP UDP Alarming Enabled pCOWeb 030220471 rel 2 0 28 02 2011 58 8 MODBUS OVER TCP IP 8 1 OVERVIEW MODBus is a communication protocol developed by Modicon systems In simple terms it is a way of sending information between electronic devices The device requesting the information is called the MODBus Master and the devices supplying information are MODBus Slaves In a standard Modbus network there is one Master and up to 247 Slaves each with a unique Slave Address from 1 to 247 The Master can also write information to the Slaves 8 2 BASIC DESCRIPTION Connection Details Connect Us
51. to a Carel controller using a Carel MODBUS Extended connection there can be a maximum of 6193 BACnet objects which includes the Device Object Of the 6193 objects there are always 16 Notification Class objects 16 Calendar objects 16 Schedule objects and there can be up to 2048 Analogue Values 2048 Analogue Values or Multi state Values and 2048 Binary Values The number of each type can be configured prior to use Object Identifiers are assigned according to the following table Table 7 b BACnet MODBUS mapping Object Type MODBUS Mapping Analoghe Value Analogue Value or Multi state 200001 202048 10001 12048 Value Binary Value 100001 102048 D0001 D2048 By default 10001 12048 are mapped as Analogue Value 100001 Analog Value 102048 Each of these may be reprogrammed as Multi state Values on an individual basis by writing to the Object Identifier property BACnet objects which are mapped but for which there are no corresponding physical MODBUS points return an unreliable other 7 value for the Reliability property of the corresponding object and an undetermined value for the Present Value property usually 0 or 0 0 The Object Name properties for all the objects except the Notification Class objects are writable and can be up to 32 characters in length By default the Analogue Value Multi state Value and Binary Value objects are named A0001 A2048 10001 12048 and D0001 D2048 corresponding to their MODBUS mapping 7 5 BACnet fea
52. variations in tNeNAMAD 68 25 4 3 5 Scheduled events generated at time intervals sssccssscssssessesssscsssssssecssssssssessecsssesssssssseessecsssssssecssssssssesseeessessssseseenseessssessecessssssssssseesseesssssseenssessssesseeesssesssseeseenseensn 27 XEM COG m NB RO GR 29 Bet ZCONFIGURING CEOGK WITE AGO aO IVO m M 29 52 CONFIGURING CEOCK AVINFOUT DCO SY NGTIROMIZATION alia 29 STORIE OG MAS RR ST EER 30 MAS UU T 55 So ONES S eto tut cates cel cafes cee ota hacen etel hat Atu o aeta eet tu e d etat utet aeta ea Lo M CMM 33 CP becca 34 CI tcr TEES 35 OA BASIGSNMPCONAIGURATIONSEO RD 35 RA IAA 36 bel ci 36 12 IRACRCE MODELS aI ih a NN tL t I E LM LU ELM E 37 ES RI U A E A E E O OAOE A N ETO EO 37 7 3 1 CSI a etn EE NTC E 37 7 3 2 COSIO ni 38 7 3 3 Comanda PI eataa aka a a a aa a R at E A RO AEM NI 38 7 3 4 arcc 38 155 5 RECETTORE Re e A IR ORTI eee 38 IO BUB SQ SAU PR a 39 Rca 39 DEI 0 3 210 Lerro IN MMM 39 SITE 39 9 BASIC CONFIGURATION AND AUXILIARY FUNGITODS oaa inve fuur a trier gefta nr c 40 i BACKNGUPTHECONFIGURMIONOEIRECO Oca 40 gu ACCES ING TAE CONFIGURATION PAGE ominainen E E aa 40 9 2 1 Authentication dialogue box for accessing the Administrator area ous ni iita tn er e ut d d bon c uae amen e tp o
53. via FTP block A only INFORMATION e The firmware only block A can also be updated via FTP e An already updated pCOWeb that the firmware can be downloaded from is required e The flash_sys_Bxxx bin file used in paragraph 9 10 1 on page 54 cannot be used for this procedure PROCEDURE 1 Access an already updated pCOWeb via FTP see 4 2 on page 17 going to the directory Lusr7local root rlash dev 2 Takethe following two files romapps img romapps img chk and copy them to a temporary directory on the computer 5 Access the same directory on the pCOWeb being updated via FTP 4 Delete the romapps img and romapps img chk files contained in the directory 5 Copy the files from the computer to pCOWeb 6 pCOWeb must be rebooted to complete the update IMPORTANT if one or both files listed above are missing or are not valid when rebooted pCOWeb will go into Rescue Mode see 9 10 5 below 9 10 3 Rescue mode INFORMATION e When pCOWeb is rebooted it first runs the block B firmware then checks the presence and validity of block A starting up as normal if everything is Ok e lfblockAis not valid pCOWeb enters Rescue Mode to allow block A to be reloaded The Status LED is on steady red o In this mode the normal functions are not available and access to the standard configuration page is not possible as those pages are contained in block A HOW TO RELOAD THE BLOCK A FIRMWARE 1 Access pCOWeb by entering the IP addre
54. 011 3 pCOWeb 030220471 rel 2 0 28 02 2011 CONTENTS abili 7 EE eens ea HD NH icu spam 7 Li STRUTT PP PATS etc oda at oc Dd alg AAE AEE A AE AA A A EAE 7 T2 WSERINTERFACE BUTTON ana SED Sc M 8 2 RIOLO SD INN MENS 9 DA ASSEN hoe RI RE O OI 9 32 MABH S UPPED e 9 5 STARTING FOR THE FIRST TIME ACCESSING pCOWeb FROM A COMPUTER sens 10 Sl CONNECTING OCONEE CTE MO A libia 10 3 1 1 ARPA A ON O I mee 10 3 1 2 Connection starting pCOWeb and activating the default network settings Button cssssssssssssssssccccsssssssssssssssssesssssssssssssssssessecsesssssssssssesssseeseenssssssnsesseeseesssssnssee 12 3 1 3 LED signals when starting and during normal operation acusado auod ideo MUR Eldorado in 13 3 1 4 RL EA O S A E E TS EA TA P A ATE E ortu 13 2 JESTABBSRHING A CONNECTION BETWEEN THE PE ANDDCOWen VIAA NETWORK icies R RE O R 14 2 UNICI cc uz 16 d WEBSERVERSOUSIOMI PAGS hic Seo see cn aap eee tn E tidem 16 4 1 1 Creatine Tel BITS RS S SN ES 16 420 ACCESSING WE USER MEMORY VIA FI P es dud tette actetuer ottenuta Rec ctetuer e Curt D rtasafe 17 2 55 EVENT NOTIFICATIONS E MAIL FRR PU Ske S NMPSTRAPNEORIM rea 20 43 1 Events generated Upon variations in the value of a trae asa 20 4 3 2 Gili A RE 27 4 5 5 Setting the common properties Galois 23 4 3 4 Setting the notifications set upon
55. 2 bin 2010 10 30 B 12 1 flash sys B1 2 1 bin 2006 08 02 INFORMATION pCOWeb recognises the type of block not by name but rather by some information it contains TIP if updating block A only on a series of pCOWeb devices use the procedure shown in paragraph 9 10 2 on page 55 PROCEDURE ls Download the update to a directory on the computer and decompress it using any ZIP decompression utility for example Filzip freeware http www filzip com Open the pCOWeb firmware update page Figure 9 ee Use the Browse button to choose the file corresponding to the block being updated Select the Submit button the block will start being transferred to the VOLATILE memory on pCOWeb the non volatile memory is not modified in this phase however if at this point the procedure needs to be stopped pCOWeb will have to be rebooted Wait for the confirmation page to be displayed see Figure 9 ff then close the window and wait until the page shown in Figure 9 ee above turns into that shown in Figure 9 gg on page 55 describing the outcome of the test on the transferred block Check that the type of block recognised is as expected FLASH APPS string highlighted in Figure 9 gg on page 55 pCOWeb 4030220471 rel 2 0 28 02 2011 54 CAREL Information i ji BACKS ni Firme gene Firmware upgrade a ti To upgrade the w hole fireware plleh geeja to upload tao ilts FLASH APPS Arre DIH B FLASH 173 Eyyy DIN
56. 67 68 env 78 factdefctg 78 pCOWeb 030220471 rel 2 0 28 02 2011 89 factory 8 10 12 13 43 51 54 61 78 Factory 42 Firewall 17 flag 65 FIP 8 13 16 17 19 20 21 22 23 24 25 26 32 40 41 42 45 44 47 48 50 51 55 59 69 78 84 88 gateway 7 14 25 44 62 65 64 Gateway 10 23 44 51 62 GATEWAY 43 62 Glibc 88 GNU 46 50 53 59 88 guest 45 50 51 hour 31 httpadmin 17 19 32 43 46 50 51 index html 13 14 41 42 INFORM 8 20 25 26 55 34 70 log 17 31 40 43 49 78 87 88 MAC 8 9 16 22 42 45 61 62 65 64 77 MAILBOX 24 66 67 68 MIB 26 34 55 NMS 33 34 35 nslookup 63 NTP 46 47 48 84 85 86 88 offline 54 pcotagfilt 16 26 71 72 75 75 76 77 18 79 84 permission 48 51 85 PICS 56 Ping 51 pluginname 46 84 85 88 POP3 66 67 68 power 7 8 9 12 15 29 51 55 54 65 protection 7 proxy 11 14 15 62 pw demo html 78 79 IC users 84 86 rcresult 78 Reboot 42 53 55 Reply to 24 Rescue 8 13 55 54 55 56 romapps img 55 root 15 16 17 18 20 22 24 26 51 32 55 56 40 41 45 46 47 49 50 51 55 71 74 78 84 85 86 script 8 16 72 73 75 76 77 79 80 84 85 86 87 88 SMTP 20 24 59 66 68 SNMP 8 20 21 24 25 26 28 33 34 35 59 74 Subnet mask 10 11 12 62 65 template 22 25 24 Timeout 26 28 55 52 65 75 80 TR
57. 7 4 gt Carel Portal L pCOWeb Default Pa Completato Figure 3 k The default index html page If the page is not displayed e check that the computer has effective access to the data network for example try using Internet Explorer to access other sites with assured accessibility e check the indicator LEDs on the pCOWeb with reference to paragraph 3 1 5 on page 13 the role of the PC in this case is performed by the switch or the hub e consider that the PC can access pCOWeb only in one of these conditions o the network server features a proxy in this case the PCs connected to this type of network have already been set to use the proxy the network administrator needs to modify the settings of the proxy on the server to make pCOWeb accessible from the PC o Orthe network does not feature a proxy or in any case this is not intended to be used on the PC disable the use of the proxy if the IP addresses of the PC and pCOWeb are incompatible for direct communication see APPENDIX B on page 62 the administrator must set the gateway network device for communication between devices with incompatible IP addresses o Orthe IP addresses of the PC and pCOWeb are already compatible for direct communication see APPENDIX B on page 629 in this case it is normally sufficient to disable the proxy on the PC see point C in paragraph 3 1 1 on page 10 remember that disabling the proxy usually prevents access from the PC to other Internet s
58. AP 8 20 21 25 24 25 267 28 55 34 35 44 70 74 Trigger 26 27 Undefined 41 52 65 71 75 80 XML 7 8 20 22 25 24 NOTES CAREL 7 CAREL Industries S r l Via dell Industria 11 35020 Brugine Padova Italy Tel 39 049 9716611 Fax 39 049 9716600 http www carel com e mail carel carel com pCOWeb 030220471 rel 2 0 28 02 2011
59. E Version 1 0 gt Reply To pcoweblcearel it gt Subject Digital Variable 2 Test gt To nicola pierettil carel com ferruccio fantozzillcarel com gt Content Type multipart mixed boundary 123456789012345678901234567890123456 gt Completato Figure 9 dd Mail logs 9 9 RESTARTING pCOWeb Some settings require the pCOWeb to be rebooted The reboot can be performed in the following ways e Disconnect the power supply for a few seconds the LEDs must go off then reconnect if the operation is to be performed after setting the value of a parameter wait until the setting has been confirmed to allow time for the confirmation to be sent via the browser to pCOWeb e or alternatively select the Reboot button available on the configuration web pages Figure 9 d on page 42 e or alternatively use the button shown in Figure 1 b on page 8 with the procedure described in 9 9 1 below 9 9 1 Restarting pCOWeb using the button PROCEDURE 1 Check that the Status LED is flashing continuously green or red or is on steady red Rescue mode see 9 10 5 on page 55 in any other situations the procedure cannot be started 2 Select and hold the button for at least 5 seconds then release it IMPORTANT pCOWeb ignores the button when pressed for more than 10 seconds interpreting this as accidental After a few seconds the Status LED stops flashing it may change colour and switch off then it will flash very q
60. LE gt HhO required e For networks with automatic address setting DHCP server pays write DHCP or dhcp or alternatively leave empty The NetMask ET if set will not be used TU BE E E e For networks that do not use automatic address setting DHCP enter the IP address and the NetMask established for LRP this pCOWeb by the network administrator Eneee Make sure to use the correct format examples 10 0 3 114 __Submt 255 255 0 0 without spaces Figure 9 k Configuration Network APPENDIX A on page 61 and APPENDIX B on page 62 provide further information on the meaning of the parameters gt Eth0 1 Etho 2 Etho 3 optional irrespective of whether the DHCP method is used up to a maximum of 3 other IP addresses can be set that pCOWeb will respond to entering DHCP in these fields will produce no result EthO is the only parameter enabled for the activation of DHCP IMPORTANT If Etho DHCP the addresses Eth0 1 Eth0 2 Eth0 3 will only be operational when the server has assigned a dynamic IP and only during its period of validity called lease gt Gateway Address not used with DHCP operation used in cases where notifications are to be sent in response to events see 4 3 on page 20 Set the IP address for the Gateway in the subnetwork that the pCOWeb Etho IP address is part of NOTE The gateway configuration is not required if the address of pCOWeb and the receiving network devices belong to the same sub
61. NAA TEENE Trigger SRRBEHSO PIE iss pal me m ey OI mt mf fim im Gi if fom ont lm il il ont fom int nt fie fc fmt nell fom ft il foe uni fom fom ome fm mel dI ld LU Pe pe i fel Det e Pe Fi e I ic Pet Di Dei Fei Dei ef fl fl Di De Hi I 201207 MESE penne ai E SR Click here to set an Analog Variable 7 event Event Handlers Tra Y General Enable Enable all the events Trap Email Pea push configured E mal T Trap SHMP Enable Trap sending FTP Bust E E mail Enable E M 3i ceridirig un F Ftp Push Enable FTP PUSH management Submit Close Window Fitg 16 0 0 L5 confia eo notifymap analog htm Completato Figure 4 v Events generated by analogue variables gt Events enable enable all the events generated by variations to the variable gt Trigger an Activation notification event is generated when there are following variations in the value of the variable Positive the value of the variable crosses the threshold while increasing Negative the value of the variable crosses the threshold while decreasing Reenter enable the generation of a notification event when returning Event Handlers select the type of notification that will be sent when the events set above occur IMPORTANT these decisions are also used to send notifications for scheduled events see 4 3 5 below VN Y e MIDDLE AND BOTTOM SECTION Trap Configuration and E Mail Configuration These sections and the corresponding functi
62. NOT BE DELETED OR CUSTOMISED by the user in fact they are contained in the pCOWeb firmware and can only be modified following firmware updates published by CAREL and downloaded to the product Nonetheless a copy of the pages can be made and edited as desired The directory that contains these files is usr local root config NOTE2 As already mentioned at the beginning of the manual the following description refers to the configuration page relating to pCOWeb firmware version A1 4 2 B12 1 To check the pCOWeb firmware version see paragraph 9 2 2 below 9 2 2 Configuration Starting page Information pCOWeb Summary page If the login data entered are correct the following page will be displayed as shown in Figure 9 b Information S P i ummar age The section in the middle Body Configuration Body fe s the information page and can clock and Logger CATA pie opened pn ei i Os be refreshed by clicking Events per ov RIES Information the Menu section Tests dai vile is not refreshed Customer Site i Info amp Contact 0 0 o o o pCOWeb information page ar 3 o o o o o o o 0 0 o o The information page shows a o o a o o 8 o il H cans 2 IDA i 0 table that represents a snapshot 181 200 of the values of all the pCO iare Release variables The table is divided into ARP Var Idx three parts digital analogue e 41 60 M 61 80 integer variables The indices
63. O pCOWeb COMMUNICATION 65 APPENDIX D ASGOSOR A FREEWARE MAIL SERVER acc 66 APPENDIX E FileZilla Sewer A FREEWARE FTP SERVER seriale 69 APPENDIX F Trap Receiver A SIMPLE TRAP INFORM RECEIVER sssssssssssssssssssrissserrsserrnsrrrssnrrasnnrrsserrnnnrrnsnnrrasnnrrsstrrnnsrrnsnnrrnnnrrsenrs 70 APPENDIX G CAREL TAGS FOR pCOWeb HTML PAGES THE PW DEMO HTML PAGE snn 71 CAREE TAGS FOR HANDEING IE DCO VARIAB DES alech 71 Goose C AU HEU a REO OE 71 de HANOI RR 73 CAREL TAGS FORHANDEING TRE DE OWED CONFIGURATION FILES eee ae 74 Seo regu DCO VED Para EE MON ie E A euni ER mE LO M RE LM D M MM a ens M MEE Lucie DE MM UN Ue 74 carol eee 286 NEST SEIS RIESCO ROTARUM 75 checkdbsel check whether the value of a parameter in a file Is selected ccccsccssscssssssssossssscssssssooesssesssessssssnnnessossssecssonsssssuusensseesnossssonsenesnsusssossnesesasusisesesentssbaesstceneeansieies 76 checkdbradio check whether the value of a parameter in a file is C Y8 KB oot tpe ct up te D a dt o das 77 INFORMATION TAGS macaddress tw relesse bootvalues tpaddr Sth0 date aaa 77 SIOE eR UE EE ME M M M O e 78 INPICALERRORSINOLINSTHENG Gilli 78 BAMPER TAE PW DEMO HTML PAUE mirisni lla 78 APPENDIXH Library pw ajaxjs and CGI XM C QI eccssssssssssssscossssssesssseesssssssesseceesssssssesseeensssssessaseesnsssssesecersssssnsesseeensssnsessaceennsssseesseee 81 QM E P
64. P ADDRESSES RECEPTION A message that reaches a device is accepted if the destination IP address contained in the message coincides with the receiver s address TRANSMISSION A PC can send data only to a limited range of IP addresses called the subnetwork The definition of the subnet for a given PC depends on the combination IP address Subnet mask A practical test to establish whether two IP addresses belong to the same subnetwork Is as follows NETMASK PRACTICAL TEST If the Subnet mask of the two devices are identical and the IP addresses corresponding to the 255 positions of the Subnet mask are identical the two IPs belong to the same subnetwork Example 1 same subnetwork SUBNET MASK 255 255 9m O LEd 10 0 iu 34 LPZ 10 0 Z 245 The device with IP address 1 communicates directly with the device with IP address 2 Example 2 different subnetworks SUBNET MASK 255 299 Uis O IPI 10 Li de 34 LEZ 10 0 Zi 245 The device with IP address 1 CANNOT DIRECTLY communicate with the device with IP address 2 a Gateway device will be needed PROXY SERVER For some types of message the PC can also be configured so that the path travelled by the message includes if featured in the local network a special device called a proxy server which performs some additional tasks An example of such tasks Is the one that is normally performed when requesting access to Internet sites from a PC on a local network in this case each PC
65. P or as an e mail attachment XML eXtended Markup Language is a standard file format for conveying information organised in a diagram it is recognised by many types of software that manage data that is imported from files This function is useful when the receiving computer uses one of these software applications INFORMATION e pCOMWeb generates the file using a template based on a special file that must reside on the pCOWeb as an example see template xml included by default and that can be edited by accessing the user memory via FTP see 4 2 on page 17 NOTE 1 4 2 on page 17 and get the file usr local root deftemplate xml NOTE 2 A copy of the default file template xml is available in read only memory To call the copy simply access pCOWeb using the FTP protocol see WordPad should be used to edit the template in the Windows operating system in fact the pCOWeb files conform to the Linux standard which differs from Windows in terms of the different management of the line break control characters WordPad can import the Linux format and save in Windows format which can also be read by pCOWeb e When sending pCOWeb will read the template selected in the notification settings and will process it based on some simple rules described further on generating the new XML file to be sent HOW pCOWeb GENERATES THE XML FILE pCOWeb reads the template file and copies it character by character to the destination file whenever it
66. PATENTES rf FR re a L Figure 9 u NTP Plugin uninstallation report pCOWeb 030220471 rel 2 0 28 02 2011 48 9 7 PROTECTION AND ACCESS CONTROL 9 7 1 Access rights to the custom HTML pages Access restrictions can be defined to the custom HTML pages to access these from a web browser for example Internet Explorer Username Password authentication will be required pCOWeb requires authentication if and only if the directory that contains the html page also contains the special file called htpasswd note the dot before the letter h Once the authentication data has been entered in the browser these are compared against the data saved in htpasswd if the data does not match access from the browser will be denied The access restrictions to the HTML pages MUST NOT BE CONFUSED WITH THE AUTHORISATION FOR USERS OF THE OPERATING SYSTEM described further on for example the password specified to access a page is still valid even pCOWeb is started with the button if forgetting the password to access the HTML pages the access restrictions must be deleted see this paragraph below SETTING OR EDITING THE HTML ACCESS RESTRICTIONS Click the points shown in Figure 9 v below Customer Site Info amp Contact narra arelas Fuge OL pa foeni per sdminintr aor rl Figure 9 v Protection and access control thus obtaining hitge TEDA 45 Canc pieh Mozila Firo ERAT Select the direct
67. SNMP v2c Net SNMP 5 0 9 BACnet Ethernet 1508802 2 8802 3 BACnet IP Addendum A Annex J MODBus TCP IP 0T55 C 20 80 RH non condensing 20170 C 20 80 RH non condensing Normal PCO1O000WBO 59 pCOWeb 030220471 rel 2 0 28 02 2011 60 APPENDIX A MAC ADDRESS STATIC OR AUTOMATIC IP ADDRESS DHCP Each pCOWeb has a MAC address Medium Access Control that is unique at a worldwide level from all other network devices In addition each pCOWeb connected in the data network must be set with a unique IP address If the network that the pCOWeb is connected to uses the automatic DHCP system for assigning the address a manual setting of the addresses will not be needed Vice versa each individual pCOWeb will need to be set one by one the IP address MAC address Each network device is distinguished from any other device connected on the network by the MAC address The MAC address is a unique number at a worldwide level It is attributed to the device in the factory and subsequently cannot be modified It is made up of 16 alphanumeric characters in the following range 0 9 A F For easier interpretation this number is often represented in groups of two characters an example of MAC address is 00 DA SC I0 00 91 The data network is a connection that carries messages from one network device simultaneously to all the other devices connected Therefore normally a network device also receives messages sent t
68. Starting Ntp script inthe system log This line runs the ntp sh script see the previous section note that the standard output is redirected to dev null to avoid unnecessary messages showStatus displays the result with the related colouring see lines 20 37 of the highlight script note the variable S with the value returned by the previously run statement 12 17 As for the start section the stop section is made up of the same parts and is called when the pCOWeb is shutdown or when accessed by the user 19 23 Runs the script again first the stop section and then the start section used to have the Plugin reread the new configuration files it cannot be run from the web page but only from a remote console 24 28 This is the section of the script that is run in the event where S 1 is not equal to start stop or restart a message Is displayed to indicate that the script has been run with an incorrect value of S 1 d aw Ue oder Highlight script This script is used to define the standard display used in the various scripts on the pCOWeb He export escGreen echo e 033 1m 033 32m 2 export escoRed echo e N933 1mv035 3Tm 3 export escYells echo e UX035LImsOS33 33m 4 export escNorm echo e X033 m 5 export qmsdOk2 echo e 033 ImX033 32MOR v033 m 6 export msgDone echo e 033 1m 033 32mDone 033 m 7 export msgYes echo e X033 1mxX033 32mYesN033 m 8 export msoNo e
69. TARTING FileZilla Server directory alias will also appear at the specified location Aliases must contain the full local path Separate multiple aliases for one directory with the pipe character If using aliases please avoid cyclic directory structures it will only confuse FTP clients x An Cancel Figure E c FileZilla Server Interface choosing the shared directory for ftpaccount If needing to stop or restart the server from the Windows Programs menu procedures as shown in Figure E d m ee oe FileZilla Server Y ld Start Filezilla Server Stop FileZilla Server Click to STOP a ovs gt B Filezilla Server Interface r B Filezilla Server Interface Start Filezilla Server H Stop Filezilla Server Click to START H uninstal e LI Filezilla Server Figure E d FileZilla Server stopping rebooting pCOWeb 030220471 rel 2 0 28 02 2011 69 APPENDIX F Trap Receiver A SIMPLE TRAP INFORM RECEIVER Various TRAP receivers are available on the Internet Below Is a description of the Trap Receiver freeware version 5 00 downloadable at the link http www ncomtech com trapreceiver html ta After installation when starting Trap Receiver requires confirmation to start the TrapRcvr service Figure F a ssa xr io a When started no configuration is required Figure F b shows the Trap Receiver window highlighting a Trap message EM that has been received dou
70. TRAP only if the string entered respects the syntax of an OID gt Retry Timeout optional only used if Version Inform v2c specifies the maximum number of send attempts after the first and the time interval for retrying the TRAP INFORM when reception Is acknowledged by the receiver the send attempts are stopped gt Var OID N optional specifies an SNMP object whose OID and corresponding value will be attached with the message for example specifying the OID of a pCO variable when the TRAP is sent pCOWeb will acquire the numeric value of the pCO variable specified by the OID set and will attach this with the message together with the OID gt Hosts Enabled at least one required enables the recipients Hosts from those set in Figure 4 0 on page 24 that the TRAP will be sent to for the events relating to the variable IMPORTANT any Hosts enabled after one that is not enabled will be ignored Example 1 1 2 33 4 4 5 Hosts 3 and 4 will not be used e BOTTOM SECTION E Mail Configuration i gt Subject optional in the message received the text entered SIIT IR alc will appear as the Subject El Configuration Body select the contents for the body of the e mail message From file the name of a file with the html extension can be selected Choose opens the list of uu the html files in usr local root flash http um l if entering the name of the file remember that the starting directory for the s
71. UTC time 2 hours in the example above NOTE1 When using these methods synchronisation with the time on the controller must be disabled pCOWeb 030220471 rel 2 0 28 02 2011 29 5 3 LOGGER AND GRAPHS pCOWeb can save the values of max 20 variables sampled at regular time intervals to non volatile memory Logger function pCOWeb can create also a graph using the vector format SVG and representing in the same graph up to 5 of the logged variables SVG files can be natively viewed using Mozilla Firefox Chrome and Safari browser while instead Internet Explorer 8 needs an external plug in e g http www adobe com svg viewer install IMPORTANT the logging function will not start if the date of the pCOWeb is earlier than 01 01 2006 For the date time settings see 5 1 and 5 2 on page 29 IMPORTANT The range of addresses of loggable goes from 0 to 207 even if the ModBus Extended protocol is running START OR DISPLAY THE RECORDS 1 Open the Clock and Logger page Figure 5 0 2 Click the Logger tab Configuration Download Utilities The settings are located in the bottom section of the page Figure 5 d below they becomes active just after the Submit confirmation URGET ES Information Clock Logger SETTINGS AVAILABLE Figure 5 c Opening the Logger and Graph settings gt Check logger status and free space available a window is opened that shows the status of the logger Running Not Run
72. Web 4030220471 rel 2 0 28 02 2011 56 9 11 pCO APPLICATION UPDATE pCOWeb is able to update the pCO application of every type of pCO controller except for pCO2 only because pCO2 doesn t automatically restart when the upload has been completed To update the pCO application when Carel protocol is running you need either eA bios version gt 4 10 installed as starting from this specific versions of bios the pCO switches automatically from Carel protocol to Winload protocol SERIAL1_PROTOCOL 4 or BMS_PROTOCOL 4 as soon as the pCOWeb sends a specific command e An application which is able to switch to Winload protocol SERIAL1_PROTOCOL 4 or BMS PROTOCOL 4 on the serial port 1 BMS when a dedicated digital variable changes from 0 to 1 this doesn t depend on the protocol used between pCO and pCOWeb pLOWeb Conliguratkon Mozilla Firefoa SI z ie Mod cs fmaiccs mecicge Seguir wem fto ma DCOLoad parameters Mozilla Firefox oD c ing 1 152 2 104 cw acreage himi 2 a Pri dubra Coma miia Deh LA aara araa i ES pr EU Bm ity beisa Gi pia Van age http 10 0 5 109 config pw param pcoload html Bia haniai tha Pete Casal e O pOUWeb Conliga u wai neu LIe bdr U A assi gura a FOR BIOS lt 4 10 frente cns Digital Varible to switch proto Inn n iube aca In this example the first digital variable rm reserved Conr Em i elect the dial variadi to let protocol switch from Carel to Wininad jus
73. Web firmware release is A1 3 1 B1 2 1 The pCOWeb started using User pCOWeb IP address EthO 10 0 0 145 pCOWeb date time 2007 02 11 00 14 E l ii q TS GUUS Figure G i The information TAGS example SPECIAL TAGS These are used in the configuration web pages their use is closely related to the operating system and incorrect usage may cause instability on the pCOWeb factdefcfg extracts from non volatile read only memory the factory values of the parameters used by pressing the button when starting the pCOWeb paragraph 3 1 2 on page 12 Used in the link to View factory bootswitch parameters see Figure 9 g on page 42 reresult directly returns the result of certain operations from the operating system This is particularly delicate as if not used correctly may require the pCOWeb to be rebooted env returns all the information available from the pCOWeb This takes a long time to run if when running that is until the web page is returned other web pages are requested pCOWeb will need to be rebooted To use this type the following command directly into the address field in Internet Explorer hrttpi 172 16 D0 l 1 c nfilg result hitml 3 23IsCCIpL3SOarormdi29 27do0 l09g 27323 replacing the address 172 16 0 1 with the IP address of pCOWeb in question do flashroom returns the size of the remaining free space in the area of non volatile memory reserved for the web pages One
74. adDslocd lsU007s221 25 545 Reading from left to right each sequence can be graphically represented as a unique path of branches in a tree in which the numbers on the left are doser to the root The SNMP standard has issued a series of rules for using the numbers in the tree and has reserved some specific paths for common uses or specific organisations The standard also allows as each number to be replaced by a name In the example the path is rewritten with the standardised name in brackets l iso 3 organization 6 dod l internet 4 private l enterprises The path shown above is reserved for companies enterprises for specific developments Within that path any company can apply for and obtain a specific identifier and within that branch allocate the identifiers of the objects defined in its own products The enterprises identifier assigned to CAREL is 9839 Therefore the path Leda zia do da 99399 identifies the CAREL space within each SNMP device Inside the CAREL space the objects that correspond to the pCO variables and some typical objects of the pCOWeb have been added for the description of this space see 6 2 on page 34 As the SNMP Agent is based on the Net SNMP package it also supports all the typical objects of that application For information on this part of the SNMP tree in pCOWeb see the documents on Net SNMP www net snmp sourceforge net pCOWeb 030220471 rel 2 0 28 02 2011 53
75. age shown in Figure 5 a is used to enable the synchronisation function and specify the indexes of the five integer supervisory variables pCOWeb Configuration Mozilla Firefox File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto c v 3 http 10 0 3 114 config adminpage html 4 Pi visitati Come iniziare Ultime notizie TestLink 1 7 4 Carel Portal English to French Italia pCOWeb Configura The page shown in Figure 5 b is used to show how integers values are related to the day month year hour and minute data sent in supervision from the pCO application software Figure 5 b shows as first integer a variable with value 19 if in the variable list EJee CAREL of the pCO application you find that the first integer represents the variable current day you can set in Figure 5 a Day variable index 1 and the pCOWeb will show in the date 19 i e the 19 day of the month Information Configuration ITAKE CARE i The application software on board of pCOx has to be configured to transmit clock variables to pCOWeb using 5 integer supervisor variables otherwise clock synchronizer and logger will not work Please contact EasyTools or 1 Tool Customer Care for further information Clock Configuration pCOWeb Configuration Mozilla Firefox fX File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto c 3 http 10 0 3 114 config adminpa
76. al pCOWeb will need to be set with the IP address provided by the administrator see 9 4 1 on page 44 Dynamic IP DHCP default method for pCOWeb In some networks the IP address is automatically assigned to a network device by the central server via the data network itself this is called the DHCP server The operation that uses an IP address provided by a central server is described as the dynamic IP address This setting avoids for systems that use DHCP having to set the correct address on the pCOWeb and computers one by one allowing significant time savings In this case the network administrator will have configured the DHCP server with a table of MAC addresses lt gt IP addresses and will be able to distinguish the various devices by the MAC address and a table that describes for each MAC address the physical position of the device in the installation see 2 2 on page 9 In this case the devices that are connected must be first have been configured to use this method for exchanging the IP address pCOWeb has DHCP active by default In these networks therefore the IP address is decided by the network administrator who configures the DHCP server and who must be contacted to ask which address has been attributed If DHCP is active up to three additional static IP address can be assigned see 9 4 1 on page 44 pCOWeb 4030220471 rel 2 0 28 02 2011 61 APPENDIX B IP ADDRESSES PROXY SERVER SUBNET MASK DNS GATEWAY I
77. alled a map of the installation should be created applying the second label provided in the packaging onto the map for each pCOWeb corresponding to its physical position in this way the network administrator can be provided with precise documents on where the pCOWeb devices and corresponding MAC addresses are located Figure 2 e MAC address and indicator LEDs pCOWeb 4030220471 rel 2 0 28 02 2011 9 3 STARTING FOR THE FIRST TIME ACCESSING pCOWeb FROM A COMPUTER This chapter guides the user even non experts in establishing a connection between the pCOWeb and a personal computer The first part of the chapter describes the pCOWeb cable personal computer PC connection without involving an Ethernet network Nonetheless a pCOWeb can be accessed from a PC even if these are not connected together directly but via a network paragraph 3 2 on page 14 the latter procedure is more complex as it also requires the settings of the network devices that are normally managed by the administrator Consequently it is recommended to first try the direct connection In any case once having accessed the device the basic configurations can be completed chapter 8 on page 39 and pCOWeb prepared for connection to the network 3 1 CONNECTING pCOWeb DIRECTLY TO A PC This connection is used to access pCOWeb from a computer connected by cable Normally this type of connection is used to test operation on the bench or to initially configure
78. an Internet time server 1 Download the NTP Plugin from http ksa carel com if the Plugin to be installed is contained in a zip file first unzip it using any zip file decompression program for example Filzip freeware http mww filzip com so as to create a directory called install plug xxx xxx Is ignored by pCOWeb and is only used to identify the function of the Plugin 2 Access the pCOWeb user memory see 4 2 on page 17 with the httpadmin Username and display the contents of the usr local root flash http directory al c MES Infe mation General Network pco Com SNMP BACNeL ugins Users Firme ar 3 Copy the install plug xxx directory and all its contents om to the usr local root flash http directory on Glockandtogger eun pCOWeb then press F5 to refresh the page shown in Events Figure 9 m above which will then appear as shown in Tests plugins Installation Figure 9 n Customer Site The page includes the new section called SO RISE Install uninstall plugins that is used to choose which Pubon aconabibcacalconn Plugins to install from those that have already been copied or which to uninstall from those already Installed This section is only displayed if at least one Figure 9 n Plugin page pCOWeb has found one or more Plugins to be installed Plugin is installed or if at least one Plugin to be installed has been copied 4 Click Install uninstall plugins a page as sho
79. an SNMP Agent are normally described using a document called the MIB FILE the format of which is codified by SNMP The document must be written using the syntax specified by SNMP and must be uploaded to the NMS supervisor when this queries the Agent or receives the TRAP message if the NMS contains the MIB file it can use this an interpreter that as well as containing the list of all objects available on the Agent describes the properties for example the description the writability the type etc As the MIB file contains the physical meaning of each object it can only be created once the pCO application has been defined For this reason upon request CAREL only provides the MIB FILES for the standard CAREL pCO applications which can however be used to as the basis for creating a MIB file for custom applications once created numerous sites are available on the web for validating the MIB FILES One recommended site is http www simpleweb org ietf mibs validate 6 4 BASIC SNMP CONFIGURATIONS FOR pCOWeb The page shown in Figure 6 b below summarises the basic SNMP configurations for pCOWeb SNMP System Configurations 1 TT TE l pCOWeb Configuration Mozilla Firefox Read Write Communi Read only Community specify ntn regrette RETE gr the strings in accordance with the system NMS see 6 1 cox http 10 0 3 114 config adminpage htmi a Pi visitati Come iniziare Ultime notizie TestLink 1 7 4 Carel Portal E
80. are attributed all the permissions required by the Linux operating system in the same way as for the executable files seen above Figure l c on page 85 NOTE The execution permissions are also used by the system to decide which scripts to run automatically to prevent a Plugin from being run at start up reset the execution bits Execute relating to the script Structure of the start up scripts For the start up script to run correctly it must have the following structure the example refers to the NTP Plugin 1 bin bash 2 3 EtC Lnitd FunctLrons highlight 4 S case 51 In 6 Start J ShowMsg Starting NED Scripts 8 ntp sh amp gt dev null 9 showStatus S 10 Pi ip 12 STOP 13 showMsg Stopping Nip Socrrptee 1 4 id pidof x ntp sh 1 5 ka SEG 136 ShowStatus killa A Pi Le 1 9 restart 20 showMsg Restart ntp Script zh SO stop 22 SO Start 2 3 Pi pCOWeb 4030220471 rel 2 0 28 02 2011 86 24 25 26 echo 9 Usages 90 dd start stoplrestart VA exit 1 ZQ P 29 esac DESCRIPTION OF THE LINES Specifies the command executor currently the only one featured on the pCOWeb is the bash shell Bourne Again SHell therefore bin bash Add the colouring function for the log messages see the highlight script 6 When the script is run parameter 1 is equal to start showMsg see lines 13 18 of the highlight script displays the text
81. are available on the web for example e http www w3schools com e http www w3 org MarkUp e http www htmlgoodies com e http www htmlhelp com Also refer to the documentation available at http ksa carel com APPENDIX G on page 71 lists the CAREL tags and describes an example of the default demo page resident on the pCOWeb Other pages are shown in APPENDIX I on page 84 Plugins To create a simple HTML page the Notepad application can be used on the PC typing the following lines and saving the file as example html P example html Blocco note Bl xl html File Modifica Formato Visualizza lt tagparser pcotagfilt gt ential zI tagparserz pcotagfilt lt h1 gt pCOWeb Demo Page lt h1 gt chi gt pCOMeb Demo Paora dis gebro lt br gt MAC address c amp macaddress amp s MAC address macaddress oe lt html gt i Figure 4 a Example of a simple HTML page the lt Smacaddress gt string is a CAREL tag that returns the MAC address of the pCOWeb To load the page created to the user memory proceed as follows 1 connect the PC to the pCOWeb making sure that the PC can access to the HTML pages on the pCOWeb see chapter 3 on page 10 2 access the user memory via FTP see paragraph 4 2 on page 17 3 transfer the file of the page created to the area usr local root flash http reserved for custom HTML pages NOTE The pCOWeb web server considers usr local root
82. argin Opx padding left 30px padding right 30px border right 1px solid cccccc cellpadding 0 gt lt tr gt lt td style font size 14px font weight bolder height 40px text align center colspan 2 gt Analog Variables lt td gt S EP tr lt td style width 90px gt Var 1 lt td gt lt td gt lt input type text name script var 0 2 1 3276 8 3276 7 value lt Svar 0 2 1 S gt gt lt td gt lt tr gt lt tr gt lt td gt Var 10 lt td gt lt td gt lt input type text name script var 0 2 10 3276 8 3276 7 value lt var 0 2 10 gt gt lt td gt lt tr gt lt table gt lt td gt lt ta gt third cell in the general table table of integer variables table style font size 12px padding 0px margin 0px padding left 30px cellpadding 0 gt lt tr gt lt td style font size 14px font weight bolder height 40px text align center colspan 2 gt Integer Variables lt td gt EE tr lt td style width 90px gt Var 1 lt td gt lt td gt lt input type text name script var 0 3 1 32768 32767 value var 0 3 1 td lt tr gt lt tr gt lt td gt Var 10 lt td gt lt td gt lt input type text name script var 0 3 10 32768 32767 value lt var 0 3 10 gt gt lt td gt lt tr gt lt table gt lt td gt lt tr gt lt table gt lt center gt lt br gt line break The following row
83. ate resident on the pCOWeb that will be used as the basis for generating the attached XML file see 4 5 2 on page 22 Choose opens a list of files with the xml extension in usr local root flash http if the file name is entered the path must be specified starting from the root gt Attached file name optional name that will be attributed to the attached XML file if preceded by the date string the name will start with the date time on the pCOWeb at the instant the file was generated in the format YYYY MM DD hhmmss leaving this field empty the name will be assigned automatically made up of the date time in the format YYYY MM DD hhmmss xml gt Offset from UTC optional this represents the offset between local ie Notification Editor Mozilla Firefox time where pCOWeb is installed and UTC It has to be expressed as http 10 0 3 114 config hostcfg html examples 0100 Paris Rome Berlin time 0500 New York time or mm 0530 Mumbai time e Ftp Push Configuration FTP PUSH recipients for sending XML files gt Input Filename required used to choose the XML template resident on pCOWeb that will be used as the basis for generating the XML file sent see 4 3 2 on page 22 Choose opens a list of files with the xml extension in usr local root flash http if the file name is entered the path must be specified starting from the root gt Output file name required name that wil
84. b is the bash shell Bourne Again SHell therefore bin bash 2 Read the etc profile file that contains the definition of the SCONF USERS SRC USERS SBIN_USERS variables to simplify the management of the paths inside the Plugin 5 Read the Plugin configuration file ntp client conf in the SCONF USERS directory so as to be able to use the variables set in the configuration for example from the html page in the script 5 Infinite cycle to allow the script to continuously run the statements 6 Update the time using ntpdate requesting the data from the server defined in SNTP_URL and redirect the standard output to dev null to eliminate any unnecessary messages T Display the time obtained above 8 Delete a temporary file created by ntpdate otherwise ntpdate cannot be run again 9 Wait 3600 seconds before running the next statement synchronisation alternatively this could have been defined as a parameter in ntp_client conf and then easily recalled for example by the SSLEEP_TIME variable START UP SCRIPTS These are ALL the files in the Plugin rc users directory on the Plugin being installed They are used to be able to run the Plugin functions automatically when the system is started During the installation the scripts are installed in the usr local root flash rc_users directory the path string is also returned by the SRC_USERS system variable During installation each of these files
85. be used again in the future without having to send the request each time D2 effectively send the message Finally the personal computer sends the message to the server with the MAC address acquired E destination IP address outside of the subnet send to the gateway In this case the personal computer will send the message to a special network device called a gateway whose IP address will have been specified in the configuration of the PC The IP address of this device must belong to the same subnet as the personal computer The message will be sent to the gateway after the personal computer has acquired the corresponding MAC address as described in step B1 or D1 The gateway if configured by the network administrator to allow communication between the two subnets in question will forward the message to the IP destination address once the response is received this too will be forwarded to the original sender the personal computer Overall then the gateway allows the personal computer to access all other IP addresses outside of its own subnetwork SUITE NOTE Messages through proxy only if proxy and the PC is configured for Figure B a Communication in a network pCOWeb 4030220471 rel 2 0 28 02 2011 64 APPENDIX C APPLICATION pCO pCOWeb COMMUNICATION Figure C a below describes a write request generated by a high level pCOWeb application
86. been extended to cover the entire range of integer variables gt Logger With the new version of firmware logger has been deeply improved anyway only variables with index from 1 to 207 can be logged and graphed by pCOWeb pCOWeb 030220471 rel 2 0 28 02 2011 45 9 6 PLUGINS Plugins are auxiliary applications that can be installed on pCOWeb and allow custom functions to be added easily and automatically There are two types of Plugins e distributed by CAREL available at http ksa carel com e custom created for a specific application To be able to create a Plugin good knowledge is required of the GNU Linux operating system and bash scripting and to create compiled binary files these need to adhere to certain requirements The rules for creating Plugins are summarised in APPENDIX on page 84 9 6 1 Installing a Plugin Access the pCOWeb main configuration page see 9 2 on page 40 then open the Plugin page Figure 9 m Information Genera Jetweork pco Com ai Ped BACK ot Pluglns User Plugins bound 2 opcowsbcanel con Clock and Logger Plugins found lists the Plugins currently installed that m have at least one HTML configuration page In the example shown in Figure 9 m there are no Plugins customer site installed inter b PROCEDURE FOR INSTALLING THE CAREL NTP PLUGIN ee LH UPIMI The NTP Plugin Network Time Protocol is used to synchronise the time on pCOWeb with
87. ble click to see the details of the TRAP INFORM STOPPING RESTARTING Trap Receiver Figure F a Trap Receiver confirming the start of The TrapRovr service can be stopped from Windows Start Settings Control Panel Administrative Tools the service Services search for the TrapRcvr service and dick the right mouse button on the row corresponding to the service and choose Stop The service will be automatically restarted when Trap Receiver is next run aad Trap Source Port 162 Total Traps Received 1 Request ID 1322785865 Error Index fo Community public i Error Status fo 1 3 6 1 4 1 9839 2 1 Type 6 0 15 59 56 04 17 07 Ip Address 10 0 0 145 Trap Type INFORM Variable Bindings TRAP arrived double click to view the details 136121130 TireTick D days Uh 59m 47 0s 1 3 6 1 6 3 1 1 4 1 0 DID 1 3 6 1 4 1 9839 2 1 1 0 1 3 6 1 4 1 9839 2 1 1 1 0 Integer 0 Figure F b Trap Receiver confirming the start of the service details of the TRAP messages pCOWeb 030220471 rel 2 0 28 02 2011 70 APPENDIX G CAREL TAGS FOR pCOWeb HTML PAGES THE PW_DEMO HTML PAGE Each CAREL tag entered on an html page is used to read or modify the pCO controller data or the pCOWeb settings This makes the html page dynamic that is it contains the values of variables The tags are managed by an internal program on pCOWeb with tag parser functions called pcotagfilt In fact the web server on pCOWeb has been programmed to
88. by the two LEDs In this mode pCOWeb will not use the values of the User parameters for communication but rather the following values see 9 3 on page 43 View factory bootswitch parameters IP address 172 16 0 1 Subnet mask 255 255 0 0 NOTE1 These values remain active until pCOWeb IS RESTARTED see Figure 3 g below When next rebooted if the button is NOT pressed pCOWeb will return to the User configuration see chapter 8 on page 39 NOTE2 These values are part of the Bootswitch parameters and unlike the user parameters cannot be modified The Bootswitch parameters are never copied over the user parameters NOTE3 By default the pCOWeb User values activate DHCP mode for network communication READ ONLY READ WRITE ON VOLATILE MEMORY o NON VOLATILE MEMORY Bootswitch D USER factory BOOT editable i FEE parameters parameters at purcnase IP addr 172 16 0 1 IP addr user value DHCP Subnet mask 255 255 0 0 Subnet mask user value root password froot root password user value froot httpadmin password fhttpadmin httpadmin password user value fhttpadmin carel password fcarel carel password user value fcarel guest password fguest guest password user value fguest if if switch switch NOT on put v v EST active values VOLATILE MEMORY Figure 3 g Operation of the Bootswitch parameters and of
89. chanism can be analysed as follows A request from a program running on a PC to contact a site role of the communications manager It is assumed that a program running on a PC requests the PC operating system to send a certain message to a server for example www myserver com the program sends the request to the communications manager on the PC the communications manager is a program that is part of the operating system and that can be considered a switchboard operator for the PC it receives transmission requests from the programs running on the PC and receives messages from the outside forwarding them to the programs running B search for the IP address relating to the site s server Once the request has been received the communications manager on the PC looks up its table of names IP addresses to find the association between the requested name URL www myserver com and the IP address of the server if the association is not found it connects to a special network service called DNS Domain Name Server whose role is to supply the IP addresses corresponding to the names in the same way as a telephone directory the IP address of the DNS is known to the communications manager being specified by the user in the configuration of the PC pCOWeb 4030220471 rel 2 0 28 02 2011 62 NOTE B1 search for the MAC address of the DNS server In reality as described to call the DNS server the communications manager must first acquir
90. cho e ILIX033 1mX035 32mNoX0325 m 9 export msgErrfor echo e 033 3lmError 033 im 10 export msgFail echo e 033 31mFailed 033 m El export msgBad echo e X033ISImBadNO033 m 12 13 14 Echo script message 15 16 function showMsg 17 pring os SIN 18 19 20 2 Show status message 22 23 function showStatus 24 case S1 in 25 0 echo S msgOk 26 1 echo Ssmsqrar i 27 ok echo smsgqok Vane error echo Siscqhrnror 3 29 bad echo SmsgBad 30 ves echo 9msgYes s 3A no echo msgNo 32 done echo msgDone 39 failed echo msgFail 34 kill test ST Nhl amp echo LNot rannol L echo onssgOoX2s O5 echo SI 36 esac DAI pCOWeb 030220471 rel 2 0 28 02 2011 07 DESCRIPTION OF THE LINES The colour of the characters written afterwards becomes green The colour of the characters written afterwards becomes red The colour of the characters written afterwards becomes yellow The colour of the characters written afterwards returns to the default Displays the text Ok Displays the text Done Displays the text Yes Displays the text No 9 Displays the text Error 10 Displays the text Failed 11 Displays the text Bad 13 18 Display the value of the variable ST and write the next character after 70 characters from the start of the line displayed if the output of ST is Test variable t
91. ction allows verifying the sending email logs Switching in the debug mode Figure 9 cc it will open a specific window see Figure 9 dd Switch e mail service to debug mode This uses a lot of memory please restart the card at the end Redirecting to log viewer page in a few seconds click here if not redirected Close Window Figure 9 cc enable Verbose pCOWeb 4030220471 rel 2 0 28 02 2011 52 Mozilla Firefox http 10 0 3 114 config pw debugemail html On ae i i possible to EN 2 Log of the communication between pCOWeb and the e mail server example O communication etween ipCOWeb must be restarted when finished monitoring traffic to the server pCOweb and the e mail server Personal information such as username and password could be sent in clear lt gt Message sent by the server to the pCOWeb gt gt Message sent by the pCOWeb to server pcomaild peo mail notification handler NOTE pCOweb must be restarted lt 220 Welcome to Carel Spa Server ESMTP e PE s gt HELO localhost when finished monitoring traffic to Lad SB Welcume to CuiEl ea ees server gt MAIL FROM lt 250 ok gt RCPT TO lt 250 ok gt RCPT TO gt lt 354 go ahead gt Received by localhost sSMTP sendmail emulation Mon 22 Nov 2010 15 43 11 gt Date Mon 22 Nov 2010 15 43 10 0200 gt From pCOweb Test Plan gt User Agent pCOWeb gt MIM
92. day so as to acquire all the data saved until that moment during the update a window is displayed that shows the activity in progress the procedure may take around one minute the window must be closed manually at the end If this button has not been pressed at least once the data for the current day will only be available starting from the next day in any case at midnight the files are overwritten including the data for the entire day gt Download all the cvs and graphs the password for the Username httpadmin has to be entered which by default is fhttpadmin a window is opened this may take some time showing the list of directories for the months in which records have been saved to download select the directory and then click a cvs file clicking a bmp file opens a window that displays the graph gt Download only the latest cvs file this function only downloads the cvs file for the current day the file must first have been created using the Update cvs file and graph function gt View last graph a window is opened that displays the graph relating to the current day the file must first have been created using the Update cvs file and graph function Information Clock Logger Configuration Clock and Logger Events Download logged data and graphs Tests Customer Site Tnfo amp Cantact http 10 0 0 145 config pw clockcfg html Figure 5 h Discharge logg
93. dnd 4 9 2 2 Configuration Starting page Information oCOWeb Summary page casside eh a o RTL ER Ru C UG Hu Rc tcn 4 92 5 PISPIVIN SUM 42 9 2 4 EEEE E OT OTT 42 9 5 lt GENERAINEOSAND RESTORING TRE DEFAULT SUMO ATION rece 43 94 SEDMNGAHENEINORKCOMMUNICATION PARAMETERS n ast zviteitattauictbdetituetn hs etd tri ete entia ctde speed detenta detrimento nd 43 9 4 1 MS TO ONU WO RE ET E T E A E EEEE 44 95 SETTINGS RELATING TO pCOWeb pCO COMMUNICATION 44 9 5 Aedes e ANS CO eO TIS DT SET RN 45 pCOWeb 4030220471 rel 2 0 28 02 2011 5 COME I M UL 46 9 6 1 TOES AIR Rese yd ERE 46 9 6 2 Mone Inest RR I OO Ti 48 9 PROTECTION AND ACCESS CO ius 49 9 7 1 ACCESS Hells tO He CUSLOTED al FM E DARIO ARA 49 9 7 2 USBIS OL ING OCP Serenza iI a MITES 50 98 VARIOUS TESTIS RING DCO VARIABEES NOTIFICATIONS lt VERBOSITI run 5 99 RESTARTING 2 claire 55 9 9 1 pestanune DOOUISD usine the DUMON siria 55 oe 53 9 10 1 Procedure Tor updating the firmware from web DA SCS aolet ater cectapeitdconfettceietimdtorni iaia 54 9 10 2 Procedure for updating the firmware via FTP block A only riti 55 9 10 3 SCO 55 Sk HDC Pe RUPPE cliccaci 57 O TECTIA CAE PE UIC OIN 59 APPENDIXA MAC ADDRESS STATIC OR AUTOMATIC IP ADDRESS DHCP iiit acia besar bett 61 APPENDIX B IP ADDRESSES PROXY SERVER SUBNET MASK DNS GATEWA utet ttai ertet tret bec 62 APPENDIXC APPLICATION pC
94. e form statement for the syntax of form see the documents on the HTML language at http www htmlhelp com reference wilbur block form html Inside the form section the vax tag is used together with the script statement Example Figure G b below and Figure G c on page 73 Writing a new value for the integer variable with index 9 note to try this example on pCOWeb replace index 9 with the index of a read write variable for the application loaded on the pCO lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN gt html lt tagparser pcotagfilt gt lt head gt lt meta content text html charset ISO 8859 15 http eguiv content type gt lt title gt pCOWeb Demo Page lt title gt lt head gt lt body bgcolor 4ffffff hl style text align center gt pCOWeb Demo Page lt h1 gt DE lt form method GET action example html gt lt input type text name script var 0 3 9 32768 32767 value lt var 0 3 9 S gt gt lt input type submit value Submit gt lt form gt lt body gt lt html gt he script var 0 3 9 32768 32767 section places a text box on the page for entering the value using the keyboard The var 0 3 9 gt section fills the text box with the value of the variable if omitted the value will not be indicated pCOWeb Demo Page Windows Internet Explorer 3 joj x v le http 10 0 0 145 hkEp example htrnl X Google JI
95. e and the BACset user guide the main screen of this program is shown in Figure 7 b All settings become active at next pCOWeb reboot BACset can be used to set all the properties of the BACnet objects supported by pCOWeb save them on pCOWeb or on the PC for later use when required The BACnet configuration is saved on pCOWeb in a number of files in the usr local root flash etc sysconfig directory in the same way as the other configurations BACNET PICS BACnet is a scalable protocol that is it features a vast array of functions some of which are obligatory others whose implementation is left to the discretion of the manufacturer For a product that uses BACnet the document that analytically describes the type of functions implemented is extremely important This document is called PICS Protocol Implementation Conformance Statement and for the pCOWeb is available at http ksa carel com NOTEI The dock on the pCOWeb can be set using specific commands in the BACnet protocol When using this method it is recommended to disable synchronisation with the time on the pCO controller see 5 1 on page 29 NOTE2 The number of mapped variables in Figure 7 a has to be coherent with the number of variables sent in supervision Moreover when ModBus Extended protocol is running is necessary that BACnet mapped variables are less or equals to the number of variables sent in supervision see Figure 9 1 on page 45 and in every case they could not b
96. e TRAP sent the information will be sent without being processed by pCOWeb gt Acknowledge Ack interval enable select the maximum number of repeats and the time interval for sending the TRAP until reception is acknowledged similar to the Retry Timeout fields corresponding to the TRAP messages generated by the events relating to the pCO variables see Figure 4 t on page 26 pCOWeb 4030220471 rel 2 0 28 02 2011 55 7 BACNET gt pCOWeb can recognise queries sent by a supervisor that Information uses the BACnet protocol Building Automation Control Configuration Networks in the following two versions la Tests BACnet IP Addendum A Annex J Site BACnet Ethernet ISO8802 2 over 8802 3 The two standards use the same physical means for carrying the data Ethernet RJ 45 network but differ as regards the different ways the data packets are encoded If BACnet is used during installation the proper version c needs to be set to coincide with the type used by the supervisor A complete description of the BACnet protocol is not within the scope of this document The system integrator who is usually responsible for setting the various parameters checking network communication and setting up the supervision system should know how BACnet works The basic BACnet parameter configuration page is shown in Figure 7 a above for advanced configuration go to http ksa carel com and download the BACset softwar
97. e more than 2048 for each type digital analogue or integer 7 1 BACnet Carel Mapping BACnet Device Properties Alarm Parameters Clock Parameters BAMD Properties pCO Mapping Parameters Figure 7 a BACnet basic configuration BACset for pCOWeb pCOnet BACnet R Windows XP v2 11 BACset for pCOWeb pCOnet BACnet C ARE L Databore Roed Write Saus 100 Read Complete Device Setings for 77114 BACna LAN Typa BAChMP BACnet Etheenot BACnet UOR BACO haxatenme BBMD wih which to register as Foreign Device Enable Disable Device Instance Write IPAddress Ino Device instance 7 Dio 4194303 Time to Live 0 Objoct Nome jpCOWeb77114 Furwere A142 6121 Desenphon Carei BACO Gstowe App Schwere pir Location Jnkno n APOU Timis i aa d mifisoconds Yes No APDURnmes C 0 to 255 Password for Resint 227 ro 4194303 Local Date Time 2010 11 19 Fri 72 05 35 DeightSevings Time Yee No UTCOfset mintes 720 to 720 inerval to send Yhots minutes mene Max Analog Wars 207 Mex integer Vers 207 Max Digital Ver 207 MexTotel Vers 627 Interface Prowcal Cami Must reboot Storey Late cp Ae rugas magersee Figure 7 b BACset software for the advanced pCOWeb BACnet configuration For each pCOWeb that interfaces to a Carel controller using a standard Carel pCO connection there can be a maximum of 670 BACnet objects which includes the Device Object Of the 670 objects
98. e pages make sure that the computer is configured correctly as described in 5 1 on page 10 to access the address 172 16 0 1 5 Then repeat the procedure for loading block A described above pCOWeb flashdisk erase format tool This is the Carel pCOWeb Rescue Home Page Erase Format informations The svstem is running in rescue mode Short mag Ble This may be due to a flashdisk problem or to an invalid firmware upload operation Preparing devio ME inning tie ti You may have to format and upload a valid firmware disini Boek i NU 1 Wait for this one then 2 press here Shiva rester enmrorzament idem 3 click here to reboot pCOWeb C3 Copymght 2004 DWE Progettanone Elettronica AU mghes reserved oput o Figure 9 jj When loaded reboot pCOWeb This is the Carel pCOWeb Rescue Home Page pCOWeb flashdisk erase format tool Erase Format informations The system is running in rescue mode Fiashiliak Format Click Age vol qure vou wa io comple oresar dhe Sasha Mao de pot omar fladsdak Yr pirami erar al the Eanbsink al ihr oer configurer aai pages wi be kent This may be due to a flashdisk problem or to an invalid firmware upload operation You may have to format and upload a valid firmware Hack t lieta par Reboot seen C Copyright 224 DVE Progettazione Elettronica A right reserced Completa bmw w d Loca rire MUR Figure 9 kk Formatting the non volatile memory pCO
99. e the MAC address to do this first of all it looks up its table of IP addresses MAC addresses ARP table if it can t find the address it sends a message using ARP protocol Address Resolution Protocol the message is sent to the broadcast address see APPENDIX A on page 61 and consequently is received by all the devices The message asks for a response from the network device whose IP address matches the address of the DNS server as soon as the DNS responds the PC saves the MAC address in the ARP table so that this can be used again in the future without having to send the request each time the table is not static but is constantly updated B2 the DNS provides the IP address of the site Once the communications manager has the MAC address of the DNS server it will send the name www myserver com and the DNS will respond with the corresponding IP if the table does not contain the address the PC will not be able to access www myserver com and a warning message will be displayed On a PC the same behaviour can be simulated using the nslookup function in Microsoft Windows C gt nslookup www google com Server Address TOUS eL ns4 myserver dns Response from an untrusted server Name www l google com Address 216 239 359 147 Aliases www google com C the IP address acquired may not be suitable to contact the server directly function of the subnet mask At this stage the communications manager checks whether
100. e website www carel com Each CAREL product in relation to its advanced level of technology requires setup configuration programming commissioning to be able to operate in the best possible way for the specific application The failure to complete such operations which are required indicated in the user manual may cause the final product to malfunction CAREL accepts no liability in such cases Only qualified personnel may install or carry out technical service on the product The customer must only use the product in the manner described in the documentation relating to the product In addition to observing any further warnings described in this manual the following warnings must be heeded for all CAREL products prevent the electronic circuits from getting wet Rain humidity and all types of liquids or condensate contain corrosive minerals that may damage the electronic circuits In any case the product should be used or stored in environments that comply with the temperature and humidity limits specified in the manual do not install the device in particularly hot environments Too high temperatures may reduce the life of electronic devices damage them and deform or melt the plastic parts In any case the product should be used or stored in environments that comply with the temperature and humidity limits specified in the manual e do not attempt to open the device in any way other than described in the manual e do not drop hit or shake
101. earch is Corgietto usr local root Figure 4 u E mail configuration for an event NOTE If the file includes the line lt tagparser pcotagfilt gt the contents of the file before being added to the body of the message will be processed by the pCOWeb VEB server see APPENDIX G on page 71 in this way by creating simple HTML pages the body of the message can contain the value of some pCO variables read at the moment the message was sent pCOWeb does not support the encapsulation of images inside the e mail messages sent alternatively the HTML page can contain links to image files the e mail client will highlight these with bookmarks and the links can be opened by clicking the right mouse button To simply copy the text of the document without this being processed do not include the line shown above From text alternatively the text entered in the text box on the side can be added pCOWeb will automatically add the date time string Date dd mm yyyy hh mm and then the text entered to the body of the message Il gt Enable Attachment enable the sending of the attachment see XML template for attachment and attached file name on page 24 2 Open the window for setting the events relating to the ANALOGUE variables click point 5 in Figure 4 n on page 23 or click Analogue Variables in the settings summary window Figure 4 v on page 27 A summary window is displayed for enabling the events relating to the variat
102. eb is case sensitive e The changes will be active as soon as they are confirmed starting from version A 1 4 2 pCOWeb does not need to be rebooted pCOWeb 4030220471 rel 2 0 28 02 2011 50 baep LOUIS Change Lares passed orilla Pinel iL C Com EIL i Plugs Fir pe ENT Isername m m mur System Administrator i WEB Administrator httpadmin Fritpadmin PLE Weer carel ficarel pa m Guest User guest Tuta Submit Info amp Contact proel Jc arel com i wj hetec 0 0 0 L teordfigfpee administrator him 2 Completato Figure 9 x Changing the password for the operating system access Usernames root USERNAME Access with the root identifier is used internally to run critical applications for which the operating system requires special permission logging in with this Username means there are no restrictions therefore it is important to set a Password other than the default froot to prevent potentially dangerous outside access httpadmin USERNAME This is the only Username of interest to the user of the pCOWeb and must be used to access the user memory via FTP This type of identification only allows functions relating to the memory as established by CAREL Setting a new Password for this User prevents unwanted access to the memory carel AND guest USERNAMES These are used internally to run applications They have no interest for the user of the pCOWeb except to change t
103. eb now is able to send information using XML over HTTP which is the standard way to use the XML Minimum Requirements This application note is addressed to people with the following knowledge e Discrete knowledge of HTML e Discrete knowledge of JAVASCRIPT How to read variables Starting from version A135 and with major improvements in version A142 pCOWeb implements a library called pw ajax js that allows users to read the values of the variables without using the standard pCOWeb HTML tags Example need to copy the file pw ajax from the config folder to the same folder of the html file lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN html head meta content text html charset ISO 8859 15 http equiv content type gt lt title gt Happy Island lt title gt script sre bpw adjax js type text javascript gt lt script gt lt script type text javascript arrays used by the javascript library DO NOT USE OTHER NAMES digitals new Array integers new Array analogs new Array var timestamp function getVariables N B The function getParams is defined in the file pw ajax js This reads variables Digitals 1 and 2 Integers 11 and 12 and analogues 101 and 102 and then copy them into the arrays declared here above to the cells with the index equal to their supervisry index e g analogue 101 is copied into the array called anal
104. ed file SYNTAX lt ogetdb Filename ParameterName o gt IMPORTANT the names of the pCOWeb files are case sensitive The file is searched by defaultin usr local root flash etc sysconfig which contains the pCOWeb configuration files To use a new file of parameters for new applications a path other than the default can be specified always starting from root nonetheless it is recommended to save the files in the default path so as to group all the pCOWeb parameter settings in the same location Example Figure G e en page 75 The commcdfg file contains the pCOWeb and pCO communication configurations The row that defines the baud rate is Speed 19200 pCOWeb 4030220471 rel 2 0 28 02 2011 74 The following html page lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN gt lt em gt lt tagparser pcotagfilt gt lt head gt lt meta content text html charset ISO 8859 15 http eguiv content type gt lt title gt pCOWeb Demo Page lt title gt lt head gt lt body bgcolor 4ffffff hl style text align center gt pCOWeb Demo Page lt h1 gt lt br gt BAUD RATE lt getdb commcfg speed gt lt br gt lt body gt lt html gt will generate the result shown in Figure G e below pCOWeb Demo Page Windows Internet Explorer P Ei xl cT http 10 0 0 145 http example html x Google pi File Edit View Favorites Tools Help Google G
105. emo Page lt h1 gt lt br gt lt form method POST action example html lt select name script setdb commcfg speed gt lt option value 9600 lt checkdbsel commcfg speed 9600 gt gt 9600 lt option gt lt option value 19200 lt checkdbsel commcfg speed 19200 gt gt 19200 lt option gt lt option value 38400 lt checkdbsel commcfg speed 38400 gt gt 38400 lt option gt lt select gt lt input type submit value Submit gt lt form gt lt body gt lt html gt pCOWeb Demo Page Windows Internet Explorer E x DL je http 10 0 0 145 http example html Google B File Edit View Favorites Tools Help Google ao e iir Bookmarks Ei 7 blocked SP check OW AutoLink AutoFill ab Send tow E wr du E pcoweb Demo Page i H ca Page id Tools pCOWeb Demo Page Settings mw E S pCOWeb 030220471 rel 2 0 28 02 2011 Figure G g The c6 c kdb sel TAG example checkdbradio check whether the value of a parameter in a file is checked This works in exactly the same way as checkdbsels but returns checked checked instead of selected and is used for radio buttons that is those buttons in which one selection excludes the others Example Figure G h below lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN lt html gt lt tagparser pcotagf
106. emory clock and Logger space Events Tests Em vie n Customer Site NOTE The space in non volatile memory reserved for the user is managed in compressed E Info amp Contact format the information saved in this space configurations custom HTML pages Flash Utilities log files will take up less space than the native size of the file the values Leben shown in Figure 9 h refer physical space occupied by the already compressed centi a tates information HTTP server e View factory bootswitch parameters shows a summary of the factory settings that pCOWeb will use if rebooted with the button pressed see 3 1 2 on page 12 gt DEFIP DEFNETM IP address subnet mask gt PROOT PHTTP PCAREL PGUEST password respectively for the root httpadmin carel guest Usernames in the operating system running on ITUNES pCOWeb see 9 7 2 on page 50 e View network configuration shows a summary of the network settings that pCOWeb is using divided between ETHO ETHO 1 ETHO 2 ETHO 3 these can only be displayed if the corresponding logical interface is being used see 9 4 below DNS SERVERS GATEWAY especially useful when operating with DHCP shows the effective information acquired from the server and currently used e Fix HTML pages and CGls rights in the previous firmware versions once an HTML page or CGI executable was loaded via FTP this process needed to be run to automatical
107. ened with the main page index html where featured customised via FTP by the user when creating the site in relation to the pCO application program used if not the page displayed will be the default see Figure 3 1 on page 13 9 2 4 Useful contacts Clicking Info amp Contact displays the following page with useful contacts at CAREL Information Configuration Clock and Logger F Events Tests Customer Site Reboot pCOWeb 030220471 rel 2 0 28 02 2011 CAREL Industries amp r l Via cell Industria 11 35020 Brugine Padova Ita hone amp 5359 040 0716611 fax 39 049 9716600 ja Dm lb wo prowzbg Carel com rasytugissirarel com or Lowe cael com altenale Bicarel cue ard cibibcarel cem ymmunir atium dez arel com k ases media relation coreLoem Boosh germ com Figure 9 f Useful contacts at CAREL NEN G9 O Information Configuration Clock and Logger Events Tests Customer Site Info amp Contact Reboot Figure 9 e Displaying the main page 9 3 GENERAL INFO AND RESTORING THE DEFAULT SITUATION The page shown in Figure 9 g can be opened to display basic information on the pCOWeb and restore the pCOWeb default situation e View used free disk space shows a summary of the space occupied in the user memory Information General Figure 9 h below e System Information gt Size Used Avail Use overall size used available of the user m
108. er and graphs Mi IMPORTANT Whenever the configuration of the Logger is changed during the day pCOWeb retains the values saved until that moment but updates the first three lines of the header see Figure 5 f left if the selection of the logged variables is changed and the records saved until that moment need to be retained proceed as follows l before changing the configuration save the data to the PC by first selecting Update cvs file and graph then Download all the cvs and graphs 2 disable all the variables currently selected for logging 5 manually delete the file history diskbuffer in the usr local root flash http cache directory by accessing the pCOWeb via FTP with the root Username Password default froot make sure not to modify other files directories in this phase as the root Username in opposition to the case of httpadmin has no restrictions 4 rebootpCOWeb 5 then restart the Logger selecting the new variables for logging pCOWeb 030220471 rel 2 0 28 02 2011 32 6 SNMP SNMP Simple Network Management Protocol is a protocol used in Ethernet networks for controlling and setting the parameters for the network devices for example switches and network printers A complete description of the SNMP protocol is not within the scope of this document The system integrator who is usually responsible for setting the various parameters checking network communication and setting up t
109. er st Ki Exit Ctri x Hich version 0202 Description WinSock 2 0 Svstem status Running Maximum sockets 32767 Local host robertonp Local addresses 10 0 0 93 172 16 0 2 Local host after reverse lookup robertop carel locale Delivery on Connections n Pending O Delivering 0 4 Figure D d Stopping the ArGoSoft Mail Server e Enter the information Account di posta elettronica 7 x Impostazioni posta elettronica Internet POP3 Tutte le seguenti impostazioni sono necessarie per il funzionamento dell account di posta elettronica Informazioni utente Informazioni server Nome Supervisor people Server posta in arrivo POP3 10 0 0 93 3 Indirizzo a supervisor provider2 com Server posta in uscita SMTP 10 0 0 93 4 elettronica Informazioni accesso Prova impostazioni A r EE x Prova impostazioni account MOS ERE eb upervise Dopo aver immesso le informazioni richieste ta supervisor ialiabi i i i H M um i consigliabile provare l account scegliendo il pulsante in Tutte le prove hanno avuto esito positivo Scegliere Chiudi per continuare Interrompi Password 6 p basso E necessaria la connessione di rete Chiudi MM Memorizza password Prova impostazioni account 7 Attivit Errori Accedi con autenticazione password di protezione SPA Altre impostazioni Stabilisci connessione di rete Operazione completata 4 Trova server della posta in uscita SMTP O
110. eriti che consentir di tornare Facilmente al server FTP d Prima dell invio al server password e dati non vengono crittografati o codificati Per proteggere password e dati utilizzare le cartelle Web WebDAVv Ulteriori informazioni sull utilizzo delle cartelle Web Accesso anonimo Salva password Figure 4 1 Using Windows Explorer as the FTP dient pCOWeb 030220471 rel 2 0 28 02 2011 19 in the address field confirming with Enter and specifying the password fhttpadmin D x File Modifica Visualizza Preferiti Strumenti ae O Indietro dd wi P Cerca Ies Cartelle HAL Pre TTT Je iB x ME 2 Fp 10 0 0 145 T File Modifica Visualizza Preferiti Strumenti i a Nome Dimensi Tipo Ultima modifi admin Cartella di file 04 01 2007 CS indietro 2 P Cerca i Qindex_img Cartella di file 04 01 2007 log Cartella di file 04 01 2007 Indirizzo C3 citempty folder Ev plugins Cartella di file 04 01 2007 ome Dimensione Tipo Data ultima rr index html 2 65KB HTML File 04 01 2007 KC Text doc txt OKB Docum 23 02 2007 1 template xml 982 bytes Documento XML 04 01 200 Text doc txt Obytes Documento di testo 81 2007 d J Local intranet Utente httpadmin Figure 4 Using Windows Explorer as the FTP client Explorer automatically shows the contents of the usr local root flash http directory b
111. ess 00 0a 5c 10 07 15 Figure 4 b How the HTML page created is displayed pCOWeb features an FTP server that is used to access the user memory and load or retrieve files for example custom HTML pages configuration files log files To use this function the PC should be installed with an FTP client for example SmartFTP http www smartftp com or FileZilla http filezilla project org used as the example in following procedure for other software the procedure is similar PROCEDURE 1 Download install and run SmartFTP on the PC Create a new Remote Browser and enter the data as shown In the Figure 4 c below of the user memory will be displayed path usr local root flash http if this is not the case 10 if the PC cannot access at least one HTML page on the pCOWeb it will not be able to access via FTP 2 NOTE Once 3 check 4 check The IP address should be replaced with the address of the pCOWeb the default Username and Password are httpadmin fhttpadmin paragraph 9 7 2 on page 50 describes how to change this information and paragraph 9 5 on page 45 shows how to read the current information The following examples assume that the current data being used are httpadmin fhttpadmin and the IP address is 10 0 0 145 File New Remote Browser Ctrl N 3 New Local Browser Exit having selected the OK button the contents the suggestions shown in chapter 3 on page
112. et in the network configuration see 9 4 1 on page 44 The gateway configuration is not however required if the address of the pCOWeb and the addresses of the receiving network devices are in the same subnetwork For further information see APPENDIX B on page 62 NOTE1 All the following settings are valid from when they are confirmed the pCOWeb does not need to be rebooted NOTE2 The Tests page see 9 8 on page 51 can be used to manually send all the notifications set regardless of whether the events occur once the events have been set it is recommended to check the sending of the notifications on this page NOTE3 APPENDIX D on page 66 APPENDIX E on page 69 and APPENDIX F on page 70 describe some freeware applications downloadable from the Internet that once installed on a computer can receive e mails files via FTP and TRAP messages from the pCOWeb These should be used for testing without requiring an external server PROCEDURE a From the pCOWeb main page see Figure 9 b on page 41 pCOWeb Configuration Mozilla Firefox open the Events page click point 1 in Figure 4 n File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto b Open the window for setting the recipients and the attached fia C X d id hip 10 0 3 114 configfadminpage honi 1 i Piu visitati Come iniziare Ultime notizie 1 TestLink 1 7 4 Carel Portal English to French Italia files click point 2 In Figure 4n pcoWeb Configura The settin
113. example of this is View used free disk space on the configuration page see Figure 9 h on page 43 do ifconfig returns the current configuration of the Ethernet network including the IP address obtained from the server in DHCP mode one example is View network configuration on the configuration page see Figure 9 g on page 43 TYPICAL ERRORS INVOLVING THE TAGS These are some typical errors that may be committed when using the tags inside the web pages The tag is not replaced by the corresponding value Solution o check that the following row is included in the html page lt tagparser pcotagfilt gt check that the editor used to create the page does not replace the special characters used in the tags with the corresponding html code for example the lt and gt characters may have been replaced with amp lt and amp g t respectively The web pages containing tags are not displayed Causes the syntax of the tag has not been observed Solution make sure the characters have been entered correctly inside the tags the last tag on the page Is often forgotten The value displayed on the web pages does not change when the variable changes Causes the web page has been made by copying the source of another page for example displaying Source code in the browser it does not work because the page obtained does not contain the tags but rather the values that pcotagfilt has already replaced them
114. f the communication parameters between pCOWeb and the pCO application see 9 5 on page 44 o alternatively the address of the variable is outside of the range managed by the pCO BIOS firmware not a recent version In the example shown in Figure 9 b on page 41 the pCO only manages the first 199 digital variables the first 127 analogue variables and the first 127 integer variables Example Figure G a on page 72 Reading the value of digital variable 5 lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN gt lt html gt lt tagparser pcotagfilt gt lt head gt lt meta content text html charset ISO 8859 15 http eguiv content type gt pCOWeb 030220471 rel 2 0 28 02 2011 71 lt title gt pCOWeb Configuration lt title gt lt head gt lt body gt lt div style color red gt Variable Digital 5 value is lt var 0 1 5 gt lt div gt lt body gt lt bunl gt pCOWeb Configuration Windows Internet Explorer i B x uc le http 110 0 0 145 http example html Xx Google i File Edit View Favorites Tools Help Google Go to e m pk Bookmarks Eh 7 blocked Check AutoLink al bal AutoFill a Send to E wg du amp pcoweb Configuration fp T Page iC Tools a Settings Y Variable Digital 5 value is 0 E i EE OE RES Figure G a The va r TAG used for reading WRITING To enter a variable write operation on an html page use th
115. g a crossover cable Figure 3 f below Figure 3 f pCOWeb PC connection Starting 2 Switch on the pCO controller 3 Check that both the indicator LEDs on the pCOWeb connector come on within a few seconds Figure 2 e on page 9 If this does not occur see 3 1 3 on page 13 Activating the factory network settings button INFORMATION e the activation of the factory settings or the user settings can only be selected when starting the pCOWeb e pCOWeb will reboot whenever it is restarted e pCOWeb can be restarted without disconnecting the power supply see 9 9 on page 53 4 Immediately after reboot as soon as the Status LED remains on steady GREEN to activate the factory settings rather than the user settings hold the button 5 after around 20 seconds the Status LED due to the button being pressed will turn RED and flash slowly 3 times the button must be released before then end of the 3 flashes 6 once the red flashes have terminated the Status LED will turn GREEN and if the procedure has been performed correctly immediately after the Status LED will confirm the pressing and release of the button by flashing quickly 3 times RED and then will come on steady GREEN again for around one minute completion of the start up phase 7 once the start up phase has been completed the Status LED will start flashing pCOWeb will now start operating Table 1 a and Table 1 b on page 8 show the meanings of the visual indications represented
116. g of some parameters Example baud rate 300 see 9 5 on page 44 and Figure 9 i Restoring pCOWeb to the default situation these will only be correct after the reboot IMPORTANT Ifthe authentication data to access the configuration page set by the user is different from the default values admin fadmin pCOWeb will request authentication admin fadmin for the configuration page immediately starting from the page in response to the deletion of the user files 9 4 SETTING THE NETWORK COMMUNICATION PARAMETERS For pCOWeb to communicate with the data network it is installed in a number of network communication parameters need to be correctly set The assistance of the network administrator is required to establish if pCOWeb can be connected and to understand the essential data relating to the installation To better understand the meaning of the procedure for setting these parameters see APPENDIX A on page 61 and APPENDIX B on page 62 The following operations are in any case possible even without having read the appendices First of all it must be established whether or not the network uses automatic address setting DHCP ask the network administrator e network with DHCP in this case pCOWeb is already ready in the factory configuration and no operation is required The network administrator will require documents that show the physical positions of the various pCOWeb devices and the corresponding MAC addresses see 2 2 on page 9
117. ge html 4 J Pi visitati Come iniziare Ultime notizie TestLink 1 7 4 Carel Portal English to French Italia 00000000000009 909090009000 00 0009 6000944 pCOWeb Configura PTeTTIILLLL ILL http 10 0 3 114 config pw clockcfg html Customer Site Info amp Contact Figure 5 a Setting clock synchronisation Fisboot L u u u u u L u Ww k daro peo pear i rer Mu u ui u iF J 1 November month Figure 5 b Relation between indexes and values NOTE1 The settings will be valid as soon as they are confirmed pCOWeb does not need to be rebooted NOTE2 For version lt 1 4 2 The time indicated on the left of the page only changes when the page is completely refreshed for example by pressing F5 on the computer keyboard 5 2 CONFIGURING CLOCK WITHOUT pCO SYNCHRONIZATION 1 Using BACnet protocol commands e g Time Sync UTC Time Sync in BACset refer to BACset manual for more information 2 Installing the NTP plugin downloadable from http ksa carel com it is possible to let the pCOweb run the time supplied by a NTP server in fact the NTP plugin contains the file called ntp_client conf which includes the following lines NTP URL 10 0 0 7 UTC OFF 2 The first line defines the NTP server used for communication an IP address the NTP server address is required to let pCOWeb reaches the NTP server The second line gives the possibility to set an offset to the
118. gs in this window will be common to all the events The window is divided vertically into three areas Figure 4 0 on cre TENNE page 24 Figure 4 p on page 24 and Figure 4 q on page 24 Godadlegder Each has a confirmation button that is only valid for the Jn corresponding area cistern Site Info amp Contact Synchronous Events Ll Message Fecelwer Configuration Figure 4 n Notification events page pCOWeb 4030220471 rel 2 0 28 02 2011 25 SNMP Hosts SNMP TRAP recipients see chapter 6 on page 33 Up to 5 recipients can be specified to be able to receive SNMP TRAP notifications at least the first Host 1 needs to be specified SETTINGS AVAILABLE Pttp 10 0 0 145 Notification Editor Mozilla Firefox gt Hostname IP address or name of the recipient PC to use a name a DNS must be specified see 9 4 1 on page 44 gt Community this represents a sort of SNMP keyword that is sent not encrypted to the recipient which can exdude any notifications from pCO LI CAREL communities other than its own if left empty the Default trap SNMP Hosts community will be used see 6 4 on page 35 but if that too is empty Host 1 the TRAP will not be sent to the Host Host 2 e E mail Configuration e mail recipients gt Username Password Username and Password to access the SMTP server used by pCOWeb to send the messages for some servers this Host 3 information is required while for others it
119. he Username Password for the selected directory can be set and or changed pCOWeb 030220471 rel 2 0 28 02 2011 49 IMPORTANT NOTE The admin directory contains the htpasswd file that is used for authentication to the pCOWeb configuration page contained in usr local root config see 9 2 on page 40 That directory read only in fact includes a permanent link name htpasswd to the usr local root flash http admin htpasswd file e To cancel the restriction access the memory via FTP and delete the following file usr local root flash http admin htpasswd e To restore the default restriction access the user memory via FTP and copy the file usr local root defadmin htpasswd to the directory usr local root flash http admin TIP The links as described in the IMPORTANT NOTE above can be used to attribute the same authentication to multiple directories after having generated for a directory the htpasswd file as shown in Figure 9 w on page 49 simply add a link in each directory symbolic link typical of Unix like systems to the htpasswd file generated For example to share the htpasswd file located in usr local root flash http admin for the usr local root flash http directory proceed as follows I from a Windows terminal access pCOWeb by selecting Accessories Prompt and then entering telnet 10 0 3 114 IP address or name of the pCOWeb 2 atthe login request type httpadmin and the password see 9 7 2 below
120. he browser provide fimisare mag refresh the page by pressing Ctrl F5 if this doesn t work try deleting the browser s 5 cache memory and if this still doesn t work close and open the browser again all corel the instances running Figure 9 hh The Rescue Mode page pCOWeb flashdisk erase format tool pCOWeb flashdisk erase format tool Upload rond Image file npland JE The Bie ot valid follow ness bike bo start Cor abort upload Please enter the Mename fer the binary Enage you vasi te proide Hipica last pps tin for Ermware Tesh apni A 1 4 on rome here bo cedure Back to home pass G7 Copyrnght 2004 DVE Progettazione Elettronica AI righe reserved 2 Copyrigh 2004 DVE Frogesanone Elettronica All nghtz reserved Gean Completas zl Figure 9 ii Reloading block A If on the other hand Rescue Mode is still active even after rebooting pCOWeb there may be errors in the formatting of the non volatile memory Proceed as follows 1l Click the Completely format flashdisk link shown in Figure 9 kk below to regenerate the data structure of the non volatile memory 2 Choose Yes please erase all the flashdisk all the user configurations and pages will be lost all the HTML pages entered by the user and all the configurations will be lost including the network settings When next rebooting the button will need to be pressed see 3 1 on page 10 using the default address 172 16 0 1 to open the Rescue Mod
121. he contents of a pCO variable using the page shown in Figure 9 aa below Choose the variable choose the variable to be read or written IMPORTANT The selection is also common to the write function and only becomes effective after selecting the Read button the Write button does not confirm the selection made in the Choose the variable section but rather writes the values shown on line with the Write button and highlighted in Figure 9 aa Current value value read this may be numeric or U for the meaning of U see 9 2 2 on page 41 Variable Type index new value enter the new value for the variable and select Write then wait for the outcome page and check whether the value has been accepted the pCO application can write the variable or has remained unvaried 7 the pCO application manages the variable as read only Operation result legend Undefined Ok Timeout describes the outcome of the last read or write operation http EADAE Corel pit Wels Macilla Finch Read variable from pCOx fi Cute Read n Wrile variable to pCOx p Venta Inadefined Ok Time ut Close Wingo Completato Figure 9 aa pCO variables test o Ok after a write operation pCOWeb has received acknowledgement from pCO with the current value of the variable o Timeout if 10 seconds elapse from the write operation without the pCO sending the acknowledgement message containing the current value of
122. he default Password so as to increase security IMPORTANT Ifthe password is forgotten the only way to access the operating system functions protected by the Username Password is to start pCOWeb with the factory Passwords pressing the button as described in 3 1 2 on page 12 9 8 VARIOUS TESTS PING pCO VARIABLES NOTIFICATIONS VERBOSITY The Tests page features the following tests pCOWeb Configuration Mozilla Firefox e Ping a remote Host pCOWeb can be used to send a GHG cx e 3 A Mc fprampeqe EE ping command to a computer This is useful for APR EaU Some Kara Lama notizia 1 Testink 1 74 Corni Portal t Endlt to Trench ale checking whether or not communication is possible between pCOWeb and a computer cable problems IP amio 3 address or subnet mask settings IMPORTANT the Gateway normally needs to be set see 9 4 on page 44 Cancun ten To P Contact Specify the name a DNS must be set see 9 4 1 on page 44 or the IP address then select the Ping button the command asks the recipient to respond to acknowledge reception after sending the command pCOWeb will display the outcome on the confirmation page see Figure 9 7 below bittpcz 1000 1 45 Mailla Pretos http 100 0 145 Mozilla Firefok Pile xl Close Window Ping fallure Fing success Figure 9 z Results of the Ping command pCOWeb 030220471 rel 2 0 28 02 2011 5 e Read Write by pCOx is used to read or write t
123. he following is displayed S Test variable rte tte tee ee eee eee ee eee eee eee eee ee eee ee eee ee eee eens S where represents the shell prompt 20 37 Displays different signals in the log based on the value of 1 sent to the function ea PLUGIN NAME This the file located in the Plugin directory with the name pluginname It contains the Plugin name that will be displayed for the link during the installation and uninstallation of the Plugin IMPORTANT the contents of pluginname must not contain spaces In the case of the NTP Plugin the file contains the string Network Time Protocol and the following link is displayed Install plugin Network Time Protocol Figure 9 0 on page 46 PLUGIN DIRECTORY For a Plugin to be automatically recognised as able to be installed by the pCOWeb the directory that will be copied via FTP see 9 6 1 on page 46 and that contains all the files and all the directories must be called Instali plug xxx where xxx is any name used to identify the contents of the Plugin yet has no special meaning for the pCOWeb CHARACTERISTICS OF THE pCOWeb GNU Linux OPERATING SYSTEM Currently the pCOWeb can run two types of executable files e Dash script e Compiled executables bash is an interpreted language used to perform simple tasks or cyclical binary executions it is a standard language and is widely described on the Internet For a compiled executable to be able to run on
124. he supervision system should know how SNMP works A simple system based on the SNMP protocol normally features a series of devices each containing an SNMP Agent as well as a central supervisor called the NMS Network Management Station which periodically queries the devices acquiring the status and where necessary setting the operating parameters The simplicity of its messages means that SNMP is becoming increasingly widespread above all for the control of industrial devices pCOWeb includes an SNMP v2c Agent that is an application that responds to network queries in SNMP protocol version 1 and 2c The pCOWeb SNMP Agent is developed using the Net SNMP open source package version 5 0 9 refer to this application for further information TRAP INFORM pCOWeb features a TRAP generator that sends notification messages to an NMS in SNMP TRAP or INFORM v2C format when events occur relating to the pCO variables as set by the user The TRAP INFORM messages are useful because they are sent by the Agent thus providing information in real time regardless of whether they have been queried by the supervisor To set the SNMP TRAP notifications see paragraph 4 3 on page 20 6 1 OVERVIEW OF SNMP OID The main concept found in the SNMP protocol involves the definition of the variables which in this language are called objects Each object within an Agent is identified by a unique sequence of numbers separated by decimal points as follows l
125. history Cancel Apply OK Cancel Apply Figure 3 d Setting the proxy steps 2 3 4 Local Area Network LAN Settings 17 xl Local Area Network LAN Settings Automatic configuration Automatic configuration may override manual settings To ensure the use of manual settings disable automatic configuration Automatically detect settings Use automatic configuration script Address Proxy server Vv Use a proxy server For your LAN These settings will not apply to dial up or YPN connections Address 192 168 0 30 Port e080 Advanced v Bypass proxy server For local addresses oed Automatic configuration Automatic configuration may override manual settings To ensure the use of manual settings disable automatic configuration Automatically detect settings Use automatic configuration script Address Proxy server e 4 proxy server for your LAN These settings will not apply to l up or VPN connections Address 192 168 0 30 Port 8080 Advanced IV Bypass proxy server Far local addresses M Figure 3 e Setting the proxy steps 5 6 7 5 Note down the settings 6 Disable the proxy server 7 Close the windows using the OK button pCOWeb 030220471 rel 2 0 28 02 2011 3 1 2 Connection starting pCOWeb and activating the default network settings Button Connection 1 Connect pCOWeb to the Ethernet connector on the PC usin
126. i 5 2 byte LJ Risorse del computer In the following descriptions the examples refer to the NTP Plugin Network Time Protocol for the automatic synchronisation of the pCOWeb clock with a time server using the NTP Figure l a Elements making up a Plugin protocol the Plugin is available at http ksa carel com CONFIGURATION FILES These are ALL the files in the conf users directory of the Plugin being installed They contain all the settings defined by the user to customise the functions of the Plugin During installation these files are copied to the usr local root flash conf users directory which corresponds to the SCONF USERS system variable To create or edit a configuration file use the Plugin web pages or edit it manually using a text editor accessing the user memory via FTP The NTP Plugin only contains the file called ntp client conf which includes the following line l NIP URL 10 0 20 1 3 Zi UTC QREST that defines the IP address of the NTP server used for communication and the offset from the UTC i e Greenwich Meridian Time HTML CONFIGURATION PAGES These are ALL the files in the plugins directory of the Plugin being installed They are the HTML pages used to create the configuration files required for the correct use of the Plugin and are installed in the usr local root flash http plugins directory NOTE The presence of html or htm files inside the Plugins directory will ensure that the C
127. ilt gt lt head gt lt meta content text html charset ISO 8859 15 http eguiv content type gt lt title gt pCOWeb Demo Page lt title gt lt head gt lt body bgcolor 4ffffff hl style text align center gt pCOWeb Demo Page lt h1 gt lt br gt lt form method POST action example html gt lt input ty e radio neme 2sOrrzpissetob i ocloockOIg tclock sync enabled value D id en clock a onclick Check EnVar 1 lt checkdbradio clockcfg clock sync enabled 0 gt gt Disabled input type radio tiame scriptisetdbi Cclockeeg clock sync enabled values LL lde en clock b onclick Check EnVar 1 checkdbradio clockcfg clock sync enabled 1 gt gt Enabled lt input type submit value Submit gt lt form gt lt body gt lt html gt pcoWeb Demo Page windows Internet Explorer loxi e je http 10 0 0 145 htkp example html x Google A File Edit View Favorites Tools Help Go 4 amp 3 G x iir Bookmarks 7blocked 7 Check W AutoLink Mw 3 AutoFill Send to Settings ou m Google C sg d A pcoweb Demo Page m E gt mh oh Page c Tools pCOWeb Demo Page fe I RE T Figure G h The checkdbradio TAG example INFORMATION TAGS macaddress fw release bootvalues ipaddr_eth0 date These return information relating to pCOWeb SYNTAX AND MEANINGS macaddress MAC address fw release pCOWeb firm
128. in script or compiled format e Firmware update the pCOWeb firmware can be updated from a computer e pCO Application update pCOWeb is able to update the pCO application not the BIOS of every type of pCO controller supernode included except for pCo2 1 2 USER INTERFACE BUTTON and LEDS pCOWeb features Figure 1 b a button PUSHBUTTON and two indicator lights STATUS LED and UIE ETHERNET LED MAC ADDRESS Functions of the button e When starting up the pCOWeb this is used to select for network communication whether to use the factory parameters or the user parameters see 3 1 2 on page 12 for the procedure e n normal operation reboots pCOWeb without needing to disconnect the power supply see 9 9 1 on page 53 for the procedure Meaning of the LEDs e Status LED displays information on the communication status between pCOWeb and the pCO and must normally be green and flash around 3 times a second in special Figure 1 b MAC address and indicator LEDs circumstances it displays the operation of service activities such as the restart of the internal program on the pCOWeb the remote updating of the program or others See the table below Table 1 a Status LED signals Status LED Meaning Notes Green flashing 3 times sec Regular pCO pCOWeb communication When running demanding tasks sending a large number of notifications this may be green steady for a few seconds Red flashing slowly once every 2 seconds pCO
129. ing Remote modbusTCP Server a IP Address 10 0 3 114 Service Port 502 ps0 xl Bs NONE z Po Protocol Selections Figure 8 a Remote connection example 8 5 COMMANDS SUPPORTED Modbus Protocol Selections Transmission Made a ANDARD DANIELJENRON SOMA ASCII w RTU ASCII RIU slave Response Timeout i ooa imsecs Delay Between Falls 250 msecs I Force modbus command 15 and 16 for single point writes To be used in cases where the slave does not suppor the single point write functions 05 and b cea Figure 9 a Protocol settings pCOWeb 030220471 rel 2 0 28 02 2011 59 To get your modbus device working these are the basic things you need to know Port 502 TCP default by protocol cannot be changed Address format Decimal digital number 1 coil 1 Variable bindings version lt 1 3 5 Digitals Coils 1 207 Analogues Registers 1 207 ntegers Registers 5001 5207 The ranges of variables for version 1 4 2 when pCO communicates using Modbus extended protocol have been extended as explained here below Digital variables coils from 1 up to 2048 A Analogue variables registers from 1 up to 5000 Integer variables registers from 5001 to 10000 Variable types Signed Integers mandatory in some software to correctly read write the variables These are the only commands supported by the pCOWeb in modbus TCP IP 01 Read coils 03 Read hold
130. ing a local copy of the library the new library will have to be copied in the folder to update it the new library is fully compatible with the old one For custom made pages which are not using the standard pw ajax js library to use the new format for the xml file it is necessary to adjust the string sent by the browser and to adapt the parser of the xml to the new format keeping the string as for version A135 will use the old xml format Copy and pasting the same URL to the browser it will return the following XML values contained depend on the application running on the pCO controller New format lt PCOWEB t 2010 03 22 11 48 gt lt PCO gt lt DIGITAL gt lt O I2 1 V 1 gt lt O I2 2 V 0 gt lt DIGITAL gt lt INTEGER gt lt O I 11 V 0 gt lt O T 12 V 0 gt lt INTEGER gt lt ANALOG gt lt O I 101 v 0 0 gt O I 102 v 0 0 gt lt ANALOG gt lt PCO gt lt PCOWEB gt Old format lt PCOWEB gt lt PCO gt lt DIGITAL gt lt VARIABLE gt lt INDEX gt 1 lt INDEX gt lt VALUE gt 1 lt VALUE gt lt VARIABLE gt lt VARIABLE gt lt INDEX gt 2 lt INDEX gt lt VALUE gt 0 lt VALUE gt lt VARIABLE gt lt DIGITAL gt lt INTEGER gt lt VARIABLE gt lt INDEX gt 11 lt INDEX gt lt VALUE gt 0 lt VALUE gt lt VARIABLE gt lt VARIABLE gt lt INDEX gt 12 lt INDEX gt lt VALUE gt 0 lt VALUE gt lt VARIABLE gt lt INTEGER gt lt ANALOG gt
131. ing registers 05 Write single coil 06 Write single registry 15 Write multiple coils 16 Write multiple registers 9 BASIC CONFIGURATION AND AUXILIARY FUNCTIONS pCOWeb features a number of HTML pages for setting the functions These pages are accessible from a PC Some settings will be active as soon as they are confirmed while others where indicated require the pCOWeb to be rebooted BACKING UP THE CONFIGURATION OF THE pCOWeb 9 1 All the settings are saved in special text or binary file in the usr local root flash etc sysconfig directory to run a backup simply connect to pCOWeb via FTP see 4 2 on page 17 and copy all the files to a PC IMPORTANT This directory only contains the parameter settings To completely backup all the pCOWeb custom settings the custom HTML pages the contents of the Plugin directories the log file directory and in general the entire contents of the usr local root flash http directory and any other directories created manually must be copied NOTET To completely back up the pCOWeb configuration after copying the files to the new pCOWeb a reboot is required NOTE2 To copy a back up from a pCOWeb to an other one is necessary that both pCOWeb have the same firmware version In addition a function is available that deletes all the changes made by the user settings or files added and returns pCOWeb to its default status see 9 3 on page 43 9 2 ACCESSING THE CONFIGURATION PAGE To access the config
132. ion of all the analogue variables Moving the mouse for example over the section relating to analogue variable 7 shows the tooltip Analogue Variable 7 clicking opens the window divided into three sections for setting the events linked to analogue variable 7 IMPORTANT The range of variables related to the notifications goes from 0 to 207 even if the ModBus Extended protocol Is running Variables addresses for notifications can go just from 0 to 207 IMPORTANT The Submit buttons only save the values for the corresponding section pCOWeb 030220471 rel 2 0 28 02 2011 26 Type Analogue Variable 7 the settings in window only refer to the analogue variable with index 7 e TOP SECTION COMMON SETTINGS General Configuration and Event Handlers Figure 4 v right Paragraph 4 3 1 on page 20 describes the generation of events based on a threshold Below is the meaning of the settings on the page hitp 10 00 145 Analog Varisbles ote ications Mozilla Firefox hit pc A20 EDD 145 Paslificabion Edlibar Variable Analog 7 Mozilla Finch ANALOG VARs Digital Analog Integer Varlables Variables JP 99 Varlables Timad events To qp Er Sp caselle eel pru ns m m m wm m Variable LI n n Li n n Li m ACO Pee eee eee eee eee ype Analog Variable 7 Sm General Configuration rrr i rittui es ee he Events enable C a NN AN NNA
133. is loaded for the first time and the responsively of the web page when values change in the pCO This function is not defined in pw ajax s which is instead only using it the function has to be declared in the html page as shown in the example To be compatible with web pages developed with firmware lt A142 this function is optional and is executed only if defined in the html file Tips e Because of the not synchronicity of the function XMLHttpRequest the very first time the web page loads the values will be undefined this can be resolved in two ways l Preloading the arrays with the values obtained by the pCOWeb using the HTML tags digitals 1 lt var 0 1 1 gt 2 Handling the exceptions on the javascript code if digitals 1 digitals 1 This will show when the element 1 of the array digitals is undefined e Web pages developed for version A135 of pCOWeb will be working for version A142 with no problems at all 4H IT Advantages 1 Web pages can reside in a Apache or IIS web server they will have to connect to the pCOWeb only to download data which is extremely useful for integration or to overtake the limitations of the embedded web server of the pCOWeb for example php or asp or net could be used to generate dynamic web pages 2 Any web developer is able to develop the page without knowing the pCOWeb tags 5 The values can be automatically updated without the horrible refresh of the entire page 4 Adding or
134. istrator If the connection fails see paragraph 3 2 on page 14 If there are no problems an authentication dialogue box similar to the one shown in Figure 9 a below will be opened Continue as described in paragraph 9 2 1 on page 41 Connect to 172 16 0 1 E 2 gt ee 172 16 0 1 x 4 Au 3 Aum The server 172 156 0 1 at config requires a username and The server 172 186 0 1 at config requires a username and password password Warning This server is requesting that your username and Warning This server is requesting that your username and password be sent in an insecure manner basic authentication password be sent in an insecure manner basic authentication without a secure connection without a secure connection Mome utente e Nome utente Password Password Memorizza password Memorizza password FACTORY admin Annua fadmin Annulla Figure 9 a Authentication dialogue box for accessing the Administrator area NOTE The authentication dialogue box is enabled by default however it may be been disabled by the user for the disabling procedure see 9 2 1 on page 41 in this case the dialogue box will not open continue as described in paragraph 9 2 2 on page 41 pCOWeb 030220471 rel 2 0 28 02 2011 40 9 2 1 Authentication dialogue box for accessing the Administrator area Following the previous points an authentication dialogue box is displayed on the PC screen Figure 9 a o
135. ites remember to enable it again when needed To avoid losing access to other sites as an alternative the proxy can be disabled only for one or a few IP addresses see point C in paragraph 3 1 1 on page 10 however with the variants shown in Figure 3 on page 15 example for pCOWeb with IP address 10 0 5 114 pCOWeb 4030220471 rel 2 0 28 02 2011 14 Proxy Settings A B 192168030 feo Local Area Network LAN Settings __ is carprod 88 36 173 2 Tune da ha ox _ ced 10 0 0 Note the semicolon Figure 3 1 Disabling the proxy for some IP addresses To ensure compatibility for direct communication as an alternative to the procedures described above the PC can be configured so that it responds not only to the IP address already set but also to a second IP address that is compatible for direct communication with pCOWeb IMPORTANT In this case request the support of the network administrator as any IP address that is assigned to the PC must be previously authorised pCOWeb 030220471 rel 2 0 28 02 2011 15 4 FUNCTIONS This chapter provides a guide to the use of the functions on the pCOWeb When parameters need to be set references are made to chapter 9 on page 39 4 1 WEB SERVER CUSTOM PAGES The WEB server function of the pCOWeb allows a PC running Internet Explorer to display the web pages saved on the pCOWeb The web pages can be divided into e configura
136. l t x Google pi File Edit View Favorites Tools Help Google an to e m Dk Bookmarks Eh 7 blocked HW Check 4 AutoLink hi ba AutoFill Sendtar settingsv we du ii pcoweb Demo Page m Ej mh i Page e Tools pCOWeb Demo Page 400 Submit Operation result Ok Done 4 mH z LE m m e Internet 10098 4 Figure G d The set res TAG example CAREL TAGS FOR HANDLING THE pCOWeb CONFIGURATION FILES pCOWeb saves the user settings in a number of files paragraph 9 1 on page 40 in the following format lt parameter gt lt value gt An example of these files SNMP TRAP configuration snmptrap file is as follows rl enabled 1 El Urugger 0 ri destl l EI desta rl dgestsg rl dest4 0 Epl urgDoscLe 0LesTelea90209225 125149 ri ack 0 ci times hosulel0 0 0 l51 communityl carel enabledl 1 enabled2 0 enabled3 0 enabled4 0 pcoprotfail enab 0 pcoprotfail ack 0 pcoprotfail time 1 cl valoLdl lzo sla rLla Lana The following tags are available for handling the configuration files e getdb read a parameter from file e setdb write a parameter to file e Checkdbsel search for a parameter in a file and check the value useful for html select tools e Checkdbradio search for a parameter in a file and check the value useful for html radiobutton tools getdb read a pCOWeb parameter from a file Returns the value of a pCOWeb parameter read from a specifi
137. l 2 0 28 02 2011 6 PREAMBLE This manual has been designed with care to allow the detailed use of the product Please do not hesitate to contact CAREL Industries S r with any information on imprecision oversights or suggestions for easier understanding your suggestions will help improve the quality of the following editions of this document Contact pcoweb carel com 1 PRESENTATION OF THE PRODUCT pCOWeb order code PCO1 W is an accessory for the pCO series products excluding the pCOB series and more in general for CAREL products fitted with a serial port and communication via the CAREL supervisor data protocol pCOWeb acts a gateway that is a translator between the CAREL supervisor data protocol and the Ethernet network protocols commonly used to connect the computers in a building On the pCO series products it is installed on the Serial board port also called serial card 1 or BMS from where it also receives the power required for operation The cover supplied protects pCOWeb especially when removing the network connector The pCOWeb firmware can also be updated by the user This manual refers to firmware version A1 4 2 B1 2 1 To check the version loaded on the pCOWeb see chapter 8 on page 39 and Figure 9 d on page 42 BUILDING Internet connection Figure 1 a pCOWeb example of network connection In the examp
138. l be attributed to the attached XML file if preceded by the date string the name will start with the date time on the pCOWeb at the instant the file was generated in the format YYYY MM DD hhmmss gt Enabled at least one required enables the recipients where the file will be push for the events relating to the variable Figure 4 q FTP PUSH configuration IMPORTANT any Recipients enabled after one that is not enabled will be ignored Example 1 Yes 2 No 3 Yes 4 Yes 5 No gives as result that Recipients 3 and 4 will not be used gt Server Address required to send notifications via FTP IP address or name of the FTP server that pCOWeb will connect to in order to deliver the file if a name is specified instead of an IP address a DNS must have been specified see 9 4 1 on page 44 for an example of an FTP server see APPENDIX E on page 69 gt Server Port optional specify only if a TCP port other than the default 21 is to be used pCOWeb 030220471 rel 2 0 28 02 2011 24 gt FIP Username FTP Password required Username and Password to access the FTP server IMPORTANT Username and Password must have a write access otherwise pCOweb can not push the file inside the directory gt FTP path optional path of the server in the default directory for the specified Username where the sent file will be written the path must exist otherwise the file cannot be received C Open the window for setting the strings
139. la project org When installation has been completed run FileZilla Server and the FileZilla Server Interface application for making the settings the authentication dialogue box for connection to the server is displayed select Ok CONFIGURING THE USERS INFORMATION When pCOWeb using the FTP PUSH function on page 24 connects to a FTP server to send a file authentication is performed by sending the Username and Password the user must already be configured in the server otherwise the connection will fail The example below shows how to set a user on FileZilla Server the procedure Is the same for setting other Users FileZilla server File Server Edit xj 155 f FileZilla Server version 95993 b Copyright 2001 2006 by Tim Koseski Connecting to server O x m kosse filezilla project org Server Address Port 14147 Connected waiting for authentication Logged on C i C k Administration password ID Acomt P Transfer Always connect tothis server Ready D bytes receive 7 Figure E a FileZilla Server Interface authentication dialogue box and opening screen Users x x Page m Account settings Users Page Account settings Users General Enable account General v Enable accoun Shared folders Password jl Shared folders ssword Speed Limits Speed Limits IP Filter Group
140. lash http cache At midnight each day this file is recopied in cvs text format compressed when enabled in NON VOLATILE memory accessible to the user in the usr local root lash http log directory organised into monthly subdirectories 2007 02 2007 03 etc the graph file is created If enabled in svg format in the same memory space The logging mode is optimised for a minimum number of writes to non volatile memory so as to reduce the degradation of the memory minimum guaranteed write cycles 100 000 NOTE in the event of power failures this logging mode limits the maximum duration of data loss to one hour Nonetheless the cvs svg files for the current day can be created manually so as to obtain all the data saved until that moment In the usr local root flash http log directory pCOWeb automatically saves the powerup log cvs file containing the records with the date time of the events Start firmware and Stop firmware respectively Power up and Power down the latter is only written when the Stop follows a reboot while pressing the physical button or selecting the button on the configuration page in this way two consecutive Power up events indicate that there was a power failure between the two events The cvs files and the graphs appear as shown in Figure 5 f The first line of the cvs files lists the types of variables enabled for logging the second line the indices and the third the desc
141. le shown in Figure 1 a above pCOWeb is connected to an internal network If suitably configured the personal computers in the internal network can communicate with pCOWeb using one of the various standard network languages included on pCOWeb The server connects the external network or Internet to the internal network or Intranet Usually in a network the exchange of data between Internet Intranet is only enabled for some devices and only for some types of communication These decisions are defined by the network administrator This manual only covers the configurations of the pCOWeb and the more simple types of networks For further information see specific publications on the topic of data networks 1 1 FUNCTIONS AVAILABLE pCOWeb connected to an Ethernet network provides the following functions e WEB server used to check or change the operating status of the pCO controller using a remote computer running for example Internet Explorer or Mozilla Firefox dynamic web pages developed by the user can be added supports CGI and Ajax technologies supports protection for accessing web pages e Logger pCOWeb can record the values of some of the pCO controller variables in a file on its non volatile memory the file can then be downloaded to a PC using Internet Explorer e Graphs the trends over time of the data saved with the Logger function can be viewed on graphs e E mail pCOWeb can send e mails when programmable events occur on
142. lt INDEX gt 2 lt INDEX gt lt INDEX gt 2 lt INDEX gt lt VALUE gt lt VALUE gt pCOWeb returns the current value multiplied by 10 lt VALUE gt 120 lt VALUE gt 12 x 10 120 ofthe analogue variable with index 2 lt VARIABLE gt End of the section for the analogue variable with index lt VARIABLE gt 2 lt ANALOG gt End of a section for analogue variables lt ANALOG gt lt PCO gt End of the section with the sequences of tags with lt PCO gt pCO properties lt PCOWEB gt End of the section recognising the sequences of tags lt PCOWEB gt NOTES on using the XML standard e he syntax of a file with the xml extension can be validated for example by displaying it in Internet Explorer pCOWeb nonetheless only recognises the syntax shown above In particular it does not recognise the standard XML lt text gt tag which in standard XML is equivalent to the pair lt text gt lt text gt e pCOWeb does not validate the template file used e Information strings and tags other than those shown above can be entered in any position if not recognised according to the syntactical limits shown in Table 4 a on page 22 they will be copied textually without any action 4 3 3 Setting the common properties to all events Par 4 5 1 on page 20 describes the operation of the notification events Below is a description of the setting procedure IMPORTANT For pCOWeb to send the notifications normally the Gateway needs to be s
143. ly attribute the transferred file the rights needed to be recognised by the pCOWeb operating system currently maes this is only necessary for executable CGI files e Delete all user files and settings deletes all the settings and files added by the user and Figure 9 h Summary of the space available in the user restores the default situation from a copy located in the read only area of the non volatile memory Figure 9 g General info and restore default situation memory The following options are available Figure 9 1 Hite 10 0 0 145 Carel pEOWeh Paria Firefon gt Yes but keep network configuration do not reset the default network configuration useful for continuing to connect to pCOWeb using the same IP address recommended if pCOWeb cannot be rebooted while holding the button gt Yes delete all also reset the default network configuration DHCP pCOWeb Restore Utility in this case if this setting was not previously used to contact pCOWeb the button will need to be held when rebooting to activate WARNING All user fles and configurations will be lost the default IP address 172 16 0 1 see 3 1 1 on page 10 and 3 1 2 on page 12 gt Regardless of the above choice after confirming with the Submit button a report is shown with a request to reboot the pCOWeb the reboot is required some settings will only be reset after reboot until Completato that time the HTML pages will show the incorrect settin
144. membership IP Filter Group membeass E ii user account x 4 IT Please enter the name of the user account that should Bypass userlimit of server Max be adde i 5 Maximum connection count o ftpaccoun Con Connection limit per IP o User should be member of the following group 3 VIO Ae 6 EE Add Remove 5 TA 3 y Force SSL for user login Rename r Des EN __ Cancel M Description Ok A You can enter some comments about the user You can enter some comments about the user Cancel Cancel Figure E b FileZilla Server Interface creating the ftpaccount user 1 Open the user configuration page see Figure E a above click the Users x ICO n Page M Shared folders Users 2 With reference to Figure E b above points 1 2 3 type the Username of Ic the new user for the FTP PUSH example illustrated on page 24 enter peed mis C bpaccount y 5 Again with reference to Figure E b above points 4 5 6 set the access Directories Il n Create Password for the ftpaccount user created above for example I Delete password do 4 gt MW Subdirs Add Remove 4 With reference to Figure E c points 7 8 9 10 set the shared directory for 9 n ui Add R R Set as home di R C ftpaccount that pCOWeb will be able to copy the files into Fs ENTRE If Ra The settings are now complete The FileZilla Server Interface can now be closed FileZilla Server will keep running STOPPING RES
145. mmunication buffer comm buffer tx flag set 6 With the following update request from pCOWeb to the pCO the latter will send the value and lower the delta flag comm buffer delta flag reset 7 pCOWeb will receive and save the value and the reception in its buffer comm buffer var value delta flag reset CONCLUSIONS A InapCO application a read only variable does not perform the reception atom and is only varied from the application Each value sent by pCOWeb will not produce any variation in the value of the application but if the two values are different the send atom will also book an echo containing the value of the variable contained in the pCO application B On power up the pCOWeb communication buffer is loaded with a series of U s Undefined each value received from the pCO replaces the corresponding U loaded at power up C If communication with the pCO is interrupted after a Timeout of a few seconds the entire pCOWeb communication buffer is initialised again with the U s the Status LED starts flashing red D On power up or when communication is restored pCOWeb sends pCO a command to read all the variables regardless of the variations pCO then sends all the values of all the variables managed by the communication buffer irrespective of whether the atoms are present or not E The pCO BIOS versions prior to 4 02 do not manage all 207 variables for all three indices that is have communication buffers
146. mpletato Figure 4 s Events generated by digital variables Type Digital Variable 1 the settings in window only refer to the digital variable with index 1 pCOWeb 030220471 rel 2 0 28 02 2011 25 e TOP SECTION COMMON SETTINGS General Configuration and Event Handlers Figure 4 s right on page 25 gt Events enable enable all the events generated by variations to the variable RI gt Trigger a notification event is generated when there are Trap Configuration following variations in the value of the variable Positive 0 1 Negative 1 0 Ima Positive amp negative 0 1 or 1 0 gt Trap Email FIP Push select one or more types of notification to be sent when the event occurs IMPORTANT these decisions are also used to send u Ba Bo Mo Da notifications for scheduled events see 4 3 5 on page 27 Submit l zi e MIDDLE SECTION Trap Configuration gt Version type of version V1 conforms to SNMPv1 Inform E v20 conforms to SNMPv2c Select in accordance with the Figure 4 t TRAP configuration for an event version of the SNMP supervisor that will receive the notifications Enterprise OID required sending the TRAP message description of the TRAP object sent together with the TRAP allows the receiver to associate the correct meaning with the message based on the information included in the MIB description file IMPORTANT pCOWeb sends the
147. mware oplead COMPLETED pigiai m smizhng ba pCOLsad pilasi cw Connect th pCO COMPLETI pco Type Ident Boot Bios Baud Rate Applicaticn space availlshle gdo fata MORI UP YP Uploading kaihin Bul juti Lena MCH ET ENT FVT Uploading MCHIT IJE IUe Upton Mie GRP EF Uploading MACHEN UI DL dire MCH DEV DEY fing MCHAA Due jug Upinading FLASH RIN RIM plein appt ation fled te Revolt Upiosd correctly executed ird CARE pun di Vssring ther puoi appli ata exsgrade pi crei well suit doam all Eher ued werwices in nriler ro rep meme Whose service wil be map salahe again aa sien as ee upline Tina imam mori Dent ing back to Canal protoeai Ok Beating all tra abuttad down pOOmab appbcationa os Figure 9 00 pCO Application Upload correctly executed pCOWeb 030220471 rel 2 0 28 02 2011 58 10 TECHNICAL SPECIFICATIONS CPU Memory Operating system Firmware Ethernet interface Protocols managed Operating conditions Storage conditions Environnemental pollution CAREL order code pCOWeb 030220471 rel 2 0 28 02 2011 ARM7 TDMI 74MHz clock 16MB RAM 8 MB FLASH around 3MB available for web pages and user data GNU LINUX 2 4 21 file system for the non volatile user memory JFFS2 A1 4 2 B 1 2 1 RJ45 connector for 10BaseT Ethernet use a class 5 shielded cable max 100 m HTTP web server thttpd 1 1 SMTP DHCP FTP DNS SNMP v1 Net SNMP 5 0 9
148. n Internet Browser is running IMPORTANT if port 80 is busy the web server will not be started the Skype application for example uses port 80 another port can be selected in the configuration for access via browser the port will need to be specified or alternatively close Skype or any other applications that occupy port 80 Delivery on Connections 0 Pendina O Delivering 0 CONFIGURING THE SERVER Figure D a ArGoSoft Mail Server opening screen 1 SET THE DOMAINS INFORMATION e The part of an e mail address to the right of the Is called the domain name domain e More than one domain can be added to ArGoSoft e The server will only receive the messages whose domain corresponds to one domain specified on the settings Logging SMTP Authentication CNN a 2 os 8 S Logging SMTP Authentication Logging SMTP Authentication General Local Domains Ports Ge Local Domains Ports General Local Domains Ports ea provider2 com E Replace Add Delete Cancel Help provider com Add Delete Cancel Help Delete Cancel OK Help Figure D b ArGoSoft Mail Server setting the domains PROCEDURE Click point 1 in Figure D a above with reference to the example settings illustrated for pCOWeb in Figure 4 p on page 24 enter the two domains see Figure D b above providerl com provider2 com
149. n page 40 complete the fields with the access information then select OK The default settings are Username admin Password fadmin IMPORTANT e hese settings are case sensitive e The login data can be customised by the user see 9 7 1 on page 49 the data to be entered then are always the custom settings regardless of whether pCOWeb is started while pressing the button e The authentication dialogue box can be disabled or the default restored proceed as follows l accessthe user memory via FTP see 4 2 on page 17 2 to disable the dialogue box delete the file usr local root flash http admin htpasswd 3 or alternatively to restore the default data admin fadmin copy the file usr local root defadmin htpasswd to the following directory usr local root flash http admin overwriting the current htpasswd file for further information see 9 7 1 on page 49 e Internet Explorer as well as other applications temporarily saves the information used to access a site this data is normally deleted when closing Internet Explorer In this way when next attempting to access the configuration page without have closed Internet Explorer the data may not need to be entered again Internet Explorer will automatically send the previously acquired data NOTE1 Unlike index html and the other pCOWeb pages that the user can customise or load to adapt pCOWeb to the specific application all the configuration pages described below CAN
150. network For further information see APPENDIX B on page 62 Name resolution DNS required only if the recipients of the notifications e mail TRAP FTP PUSH will be specified not using IP addresses but rather names for example working pc net Set the IP address of at least one server with Domain Name Server functions For further information see APPENDIX B on page 62 9 5 SETTINGS RELATING TO pCOWeb pCO COMMUNICATION INFORMATION pCOWeb pCO communication occurs by default using the CAREL supervisor protocol starting from version A142 pCOWeb is able to communicate with pCO controller using protocol Modbus Extended BMS PROTOCOL 30 on Itool and SERIALI PROTOCOL 30 on Easytool BIOS gt 4 00 Simple Modbus BMS PROTOCOL 3 is not supported This enables pCOWeb to exchange up to 12048 variables 5000 analogue 5000 integer and 2048 digital variables with the pCO application which has to be specifically designed to use the new extended range of variables to the monitoring system To enable the modbus extended protocol pCOWeb has to be told The address used by the pCO in the serial port BMS this is identified by the system variable BMS ADDRESS in the pCO controller and in the pCO application default is 1 The highest index for each type of variable default is 2048 for digital variables 5000 for analogue and integer variables it is strongly advised to limit the number of variables read by pCOWeb to those which are ac
151. nglish to French Italia on page 33 2 j pCOWeb Configura gt Read Write Network Read only network subnetworks that pCOWeb accepts Read Write or Read only queries from useful for restricting access only to some NMS for unlimited access leave default Clock and Logger gt System contact e mail address to contact for the Gia management of the installation corresponds to the SNMP standard OID Info amp Contact i Oe Ore dey dg ee A eV _ gt System name installation identifier name corresponds to the SNMP standard OID 290 425 E d tst System location physical location of the installation corresponds to the SNMP standard OID 1 13 04 24 1 sd Oe http 10 0 3 114 config pw administrator html SNMP Default traps configuration uu mm aie community enclosed with the Figure 6 SNMP basic configurations TRAP notifications see 4 3 on page 20 if the Host Community fields on the page shown in Figure 4 0 on page 24 are empty if this Community is also left empty the Host TRAP notifications with the empty Community will NOT be sent gt Hosts enabled recipients enabled to send the System traps see below defined on the page shown in Figure 4 0 on page 24 System traps pCO protocol failure a TRAP will be generated whenever pCO pCOWeb communication is interrupted or re established this TRAP can be set as follows gt Enabled enabled to be sent gt rap OID extended OID that describes th
152. ning Waiting for a valid clock configuration and the space occupied and free in the non volatile memory gt Time sample sample time common to all the variables gt Compression gz the data a Oo files created are cvs if 9 Or Compression is enabled EN o um i0 oC compressed files in gz format sies 1 Sn are created and can be E a eee opened using various BI ud alte cr gii veb an decompression tools for ia example the Filzip freeware miS me http www filzip com but not MOM Logg Sat DNA with the decompression tool Pa F Check logger status and tree space aaa included by default in the Logger Configuration Windows operating system oo MM this is used to save space in the L428 M memory as the data files are D mun clu 20 Woon a made up of highly repetitive pile Tm Sins v crah data a situation that allows p mig Ort green significant compression D ut ih dp gt Variable 1 20 enable the Enable Name Type Index Short Description Group Color Group 1 Left Axys logging of the variables Ours pee oita Mie Mas B ms 0 Name Identifier which will be Ooo CERTE C a used in the graphical OorOon limo ji le TE eisten 1 representation Ono ehor rige M retto LB gt Type Type of variable orion Le moris Mieres M Digital Analogue Integer 6 Corta gt Index Numeric identifier of the B variable in the database of variables which could be monitored by the monitoring
153. ninstalling a Plugin To uninstall for example the NTP Plugin installed in the previous pages with reference to Figure 9 r on page 47 1 click Install uninstall plugins obtaining a page similar the one shown in Figure 9 t the Uninstall plugins section shows the list of all the Plugins currently installed 2 to start the uninstallation procedure click the link for the Plugin to be removed IMPORTANT Confirmation is not requested before starting the procedure Information General ptu ork Plo Com ME BACHE Plugins Lice Configuration 9 Install plugins Clock and Logger Events z Tests Uninstall plugins Customer Site Info amp Contact Fisboot imme cared ven L ninsral plugin Figure 9 t Install Uninstall Plugin page after having installed NTP At the end of the uninstallation procedure a report is displayed similar to the one created during the installation procedure see Figure 9 u The following messages are displayed by the uninstallation report ok file removed correctly HT file not removed correctly If a file has not been removed correctly it may have been removed previously or the permission has been changed manually manual access via FTP is required for complete removal IMPORTANT for firmware version before A 1 4 2 pCOWeb must be rebooted to make the changes effective CAREL Information Configuration Uninstall plugin report Clock and Logger ok Events ok Tests Customer Site
154. nnn Analogue Value xxx OutOfRange v Where nnnnn is the Object Name xxx is the object instance ChangeOfState or OutOfRange is the Event Type v is the to state I e Normal Offnormal Fault High Limit or Low Limit The Message Text can be customized by replacing any of the Event Type text and or to state text with customized text up to 32 characters long each In addition the Object Name property can be replaced with the Description property Alarm Message Text can be customized on an object by object basis by writing to the following proprietary properties for the object Table 7 c Alarm Messages Customization Property name EnumeratedProperty value Datatype Value PROP ALARMCUSTOM 3000 Boolean True Alarms are customized for this object False Use the default Message Text format PROP_ALARMPROPERTY 3001 Character string Object Name or Description PROP ALARMCOS 3002 Character string String up to 32 characters to replace Event_Type ChangeofState text PROP_ALARMOOR 3003 Character string String up to 32 characters to replace Event_Type OutofRange text PROP_ALARMNORMAL 3004 Character string String up to 32 characters to replace to state Normal text PROP_ALARMFAULT 3005 Character string String up to 32 characters to replace to state Fault text PROP_ALARMOFFNORMAL 3006 Character string String up to 32 characters to replace to state Offnormal text PROP_ALARMHILIM 3007 Character string String up to 32 characters to replace to state High
155. o ce e v TY Bookmarks GS 7 blocked SP Check Autolink bal AutoFill sg Sendto Settings w dw pcoweb Demo Page fa fh Page Tools pCOWeb Demo Page BAUD RATE 19200 FE o militer nz Figure G e The get db TAG example setdb write a pCOWeb parameter to a file Writes or modifies the value of a pCOWeb parameter to a specified file SYNTAX script setdb Filename ParameterName The same observations as made for the getdb tag also apply here Example Figure G f on page 76 Refer to the same commcfg file as used for the getdb tag lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN lt html gt lt tagparser pcotagfilt gt lt head gt lt meta content text html charset ISO 8859 15 http eguiv content type gt lt title gt pCOWeb Demo Page lt title gt lt head gt lt body bgcolor 4ffffff hl style text align center gt pCOWeb Demo Page lt h1 gt lt br gt lt form method POST action example html lt input type text name script setdb commcfg speed value lt getdb commcfg speed gt gt lt input type submit value Submit gt lt form gt lt body gt lt html gt pCOWeb 030220471 rel 2 0 28 02 2011 75 l 210 x GAT le http 10 0 0 145 http example html tw X Google Pie pCOWeb Demo Page Windows Internet Explorer File Edit View Favorites Tools Help Google Gn D n Bookmarks GS
156. o other devices Each network device only considers a message if the destination MAC address matches its own All the other messages are ignored except for the messages sent to a special MAC address called broadcast FF FF FF FF FF FF which are considered by all the devices even if the destination address does not correspond to their own The broadcast address is used to send messages for all For this reason no network device can have the broadcast address as its own address IP address In the data networks the devices are also uniquely identified using another address called the IP address IP stands for Internet Protocol Each device is therefore set with its own IP address Within a network each IP address must be unique The correct setting of this address is fundamental for the exchange of data between the various devices The IP address is made up of four numbers separate by dots Each of the four numbers is between 0 and 255 An example of an IP address is 140 295 0 2 04 Static IP The attribution of an IP address to a network device for example pCOWeb is subject to a number of rules therefore when pCOWeb is installed in a data network the network administrator must be contacted for a valid IP address Only the network administrator who has the overall view of the entire configuration of the installation can in fact choose a valid address for the pCOWeb In systems that do not use the automatic DHCP system each individu
157. of 51 100 the variables are shown on the 141 100 eft m he values displayed on the screen are NOT updated automatically but only whenever the page is refreshed or opened again See Figure 9 c on page ccccoonooodgdo meoco s c ccccoooooo ccccooooono ccccooooooo 42 181 200 The letter U Undefined shown A for some variables means that the mM value could not be acquired for Figure 9 b Configuration starting page Summary that variable from the pCO pCOWeb 4030220471 rel 2 0 28 02 2011 4 NOTE1 The older versions of the pCO operating systems BIOS do not manage the entire range of variables In this case U is shown in the corresponding locations NOTE2 If all the variables are shown with a U there is a problem in communication with the pCO In this case check the pCO pCOWeb communication settings see 9 5 on page 44 NOTE3 If some variables show a U among other valid values check that the application on the pCO uses the supervision atoms correctly the most frequent causes are variables written too frequently or two different variables that use the same supervisor index see the technical documents on the pCO application development environment NOTE 4 It is possible to set a variable directly from the Summary page just double clicking on the interested variable a pop up window see Figure 9 aa will be displayed as described in 9 8 on page 51 where the reading wri
158. ogs to the index 101 The string is composed by TYPE START INDEX END INDEX TYPE2 START INDEX2 It can contain up to 5 different ranges of variables getParams config xml cgi D 1 2 I 11 12 A 101 102 function parseResults The following instructions assign the values of the variables in the arrays to an element of the HTML page to be visualized document getElementByld digitalli innerHTML digitals 1 document getElementByld digital2 innerHTML digitals 2 document getElementBylId integerli innerHTML integers 11 document getElementByld integer12 innerHTML integers 12 document getElementBylId analog101 innerHTML analogs 101 document getElementById analog102 innerHTML analogs 102 document getElementById currentTime innerHTML timestamp Refresh the variables every 5 seconds the time is ms timer setTimeout getVariables 5000 lt script gt lt head gt lt body onLoad getVariables gt lt The onLoad is necessary to load the variables as soon as the page loads gt Current time is lt span id currentTime gt lt span gt lt br gt lt table gt lt tr gt lt td gt Digital 1 is lt td gt lt td gt lt span id digital1 gt lt span gt lt td gt lt tr gt td Digi
159. onfiguration Plugins section see Figure 9 r on page 47 contains the link to the configuration page Network time Protocol and the text No plugins installed is no longer displayed for this reason when developing a Plugin at least one HTML page for configuration should be provided containing at least the name of the Plugin Structure of the ntp client html page for configuring the NTP Plugin Below are the contents of the ntp_client html file the sections of interest are highlighted in bold and commented on individually the rest is the HTML code required to correctly generate the page 1 pluginnamezNetwork time Protocol gt 2 lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN 3 html 4 lt tagparser pcotagfilt gt 5 lt head gt 6 lt meta content text html charset ISO 8859 15 http eguiv content type gt lt title gt pCOWeb Ntp client configuration lt title gt 8 lt head gt 9 10 lt script type text javascript gt i Function mogrtvtobJj 12 13 if document getElementById obj style visibility visible 14 document getElementById obj style visibility hidden i else 16 document getElementById obj style visibility visible 17 18 lt SCripL gt pCOWeb 030220471 rel 2 0 28 02 2011 84 I9 20 lt h1 gt pCOWeb ftp client System Configuration lt h1 gt 21 lt div style color 999999 font size 14px gt pCOWeb Ntp client configuration lt div gt
160. ons are identical to those described for digital variables Threshold Hysteresis crossing threshold return hysteresis either values that are entered or analogue variables that can be selected 3 Open the window for setting the events corresponding to the INTEGER variables click point 6 3 in Figure 4 n on page 23 or dick Integer Variables on the settings summary window Figure Et Aw click n The windows and the settings are similar to those for the analogue variables ale It should be noted that in this case Threshold Hysteresis can be set as values entered or as integer variables that can be selected Figure 4 w Opening the integer variable summary settings pCOWeb 030220471 rel 2 0 28 02 2011 2f 4 3 5 Scheduled events generated at time intervals pCOWeb can be set to generate events for sending notification when a set and repeated time interval expires PROCEDURE 1 Open the window for setting the scheduled events click point 7 in Figure 4 n on page 23 httgx 10 0 0 145 Integer Variable Notification Marzia Firefox Type Scheduled Number 1 Digital Analog Integer Configuration Variables Variables Variables Timed events Mam enat Tit Lit V min r Analog 21 40 Di 129 9 mcd rad 6 EER Perel od rst Esci sd as I IS Submit click here to set a scheduled event Close Window B Compietato Completato Figure 4 x Scheduled events Type Scheduled Number 1 settings for scheduled
161. ory where you want to insert a password Change password Directories list E pooWeb Mali Enter the username and password in the form below SARA then press the button Mote hat ENTER doesn t work property dd sm LLL n ugir Subset Clase Window Close Window Completato Completato Figure 9 w Directory list for setting access restrictions to the HTML pages IMPORTANT e For this information pCOWeb is case sensitive The changes will be active as soon as they are confirmed pCOWeb does not need to be rebooted Using the button when rebooting pCOWeb see 3 1 2 on page 12 causes no variations in the restrictions those already set are still valid The Username and Password fields of an already created restriction will be ever displayed as empty Selecting Submit creates the restriction even if the fields are empty during authentication the corresponding fields should be left empty To skip the creation of the access restriction close the dialogue box without pressing Submit Directories list Figure 9 w above gt pCOWeb Main used to set the Username Password for the HTML pages contained in the usr local root flash http directory no affect on the subdirectories gt log admin plugins list of the directories and related subdirectories contained in usr local root flash http the index img directory will not be displayed the list shows both the directories with active restrictions that those without restrictions T
162. overwrite a file that already exists for example re installing the same Plugin or two Plugins that use two files with the same name the result will be as shown in Figure 9 q The following messages are displayed in the Information installation report Configuration Stal plugin report ok file installed correctly Clock and Logger m og nati Yetpresent file already present Events pa pages PEL 1 file not installed correctly Teste Customer site gesetebcdcarelcon NOTE If two Plugins include two files with the same name and the same path during installation the old file will never be Figure 9 q NTP Plugin installation report if the Plugin is already installed overwritten with the new one and as a consequence uninstalling the second Plugin will not delete the file in the first Once having completed the installation of the Plugin the Plugin page will be as shown in Figure 9 r The Plugins found section shows the list of Plugins RT BEARES installed The previous text No plugins found in Information IND gaa sicui Qa uos Y rre Figure 9 r above has been replaced by the link to the Configuration Plugins found Network time Protocol which opens the HTML page Setenttesae for setting the Plugins present in Sas Plugins installation usr local root flash http plugins the link customer Site Network time Protocol is defined on the same Infomconme mw HTML page Reboot
163. pCO controller supervisor variable SYNTAX lt ovar 0 VariableType Variablelndex MinValue MaxValue gt where e 0 zero required reserved for future extensions e VariableType 1 Digital 2 Analogue 3 Integer e X Variablelndex 1 to 207 for Carel protocol 5000 for ModBus Extended protocol choose the variable e MinValue Int 32768 to 32767 step 1 An 3276 8 to 3276 7 step 0 1 optional when writing no affect when reading pCOWeb will not send the pCO a value less than MinValue e MaxValue Int 32768 to 32767 step 1 An 3276 8 to 3276 7 step 0 1 no affect when reading optional when writing pCOWeb will not send the pCO a value greater than MaxValue READING Returns the value of the variable saved in a table on pCOWeb The table is updated based on the variations that pCO sends to pCOWeb around 3 times a second as displayed by the green flashes of the Status LED The result of the read operation may be e value of the variable e or U Undefined indicates that the value of the variable contained in the table on the pCOWeb is not valid Possible causes of the value U o pCOWeb has not yet received a value for the variable from the pCO wait around one minute and retry o alternatively communication between the pCOWeb and the pCO is interrupted the Status LED on the pCOWeb flashes red all the variables are equal to U on the page shown in Figure 9 b on page 41 check the correspondence o
164. pCOWeb communication not established Check the settings in paragraph 9 5 on page 44 Single red flash and then flashing green Single pCO pCOWeb communication error one failed After 5 failed responses the Status LED starts response from the pCO or attempt to write a variable flashing red until communication resumes with an index higher than 207 Red steady See 9 10 3 on page 55 Off then green red repeated in rapid pCOWeb reboot phase See 9 9 on page 53 succession then green steady for 1 2 minutes Green steady for 1 2 minutes Wait for the condusion of the reboot Red Off slow 1 second 1 second repeated Recognition of button pressed during the reboot for Release the button to confirm see 9 9 1 on page 53 5 times selecting the factory parameters rather than the User parameters Red Off fast 3 times a second repeated 3 See 9 9 1 on page 53 times parameters by pressing the button Green red repeated alternating once a second Do not interrupt the power supply see 9 10 1 on volatile memory page 54 Red steady followed by green red a number of During the update firmware writing block A to non Do not interrupt the power supply see 9 10 1 on times volatile memory page 54 e Ethernet LED displays the status of the physical network connection Ethernet connection signals regardless of whether the network parameters are correct usually this must be green and flash when the data transits Table 1 b Ethernet LED signals
165. perazione completata v4 Trova server della posta in arrivo POP3 Operazione completata 4 Accedi a server della posta in arrivo POP3 Operazione completata z Indietro Annulla 4 Invia messaggio prova posta elettronica Operazione completata Figure D e ArGoSoft Mail Server configuring Microsoft Outlook 1 Name Supervisor people 2 E mail address supervisor provider2 com 3 and 4 Incoming mail server POP3 and Outgoing mail server SMTP name or IP address of the computer where the ArGoSoft server has been installed NOTE If the computer is different from the one running Outlook the two computers must be able to exchange data It is recommended to use the same computer In this case enter 127 0 0 1 internal address of the computer visible to all the internal applications 5 User name as set for the ArGoSoft MAILBOX supervisor 6 Password password set when creating the MAILBOX password 7 Test account settings select this button to test the Microsoft Outlook settings a test message will be sent and then received by the MAILBOX At this stage the ArGoSoft server is ready to receive e mails from pCOWeb and deliver them to Outlook pCOWeb 030220471 rel 2 0 28 02 2011 68 APPENDIX E Various FTP servers are available on the Internet FileZilla Server A FREEWARE FTP SERVER Below is a description of the FileZilla Server freeware version 0 9 23beta downloadable at the link http filezil
166. puter where ArGoSoft is running and type the name or the IP address of the computer if the same computer is running the browser and ArGoSoft simply enter the address 127 0 0 1 Once the access page has been displayed select the Login button and enter the Username pcoweb heater pCO and Password password set for the MAILBOX NOTE If when installing ArGoSoft port 80 was occupied and a different port is used for example 81 the port must be specified as follows name or IP address gt 81 Example 127 0 0 1 81 STOPPING THE ArGoSoft SERVER After ArGoSoft has been started and the server has been configured the program can be closed The server will remain operating To also stop the server open ArGoSoft again and proceed as shown in Figure D d CONFIGURING THE Microsoft Outlook CLIENT To be able to use an e mail dient for example Microsoft Outlook to get the messages delivered for instance to the supervisor provider2 com MAILBOX on the server the client needs to be configured PROCEDURE e From the Microsoft Outlook menu bar choose Tools Accounts Add an e mail account e Choose the type of server POP3 pCOWeb 030220471 rel 2 0 28 02 2011 67 ioii Tools Help e b Start MTP Server started Listening on vort 25 rver started Listening on vort 110 started Listening on vort 79 Listening on port 80 Gtr 5 BE suspend Delivery Finger Web Serv
167. r of rules including e fromthe left at least the first bit must be 1 e continuing to the right the first 0 bit will only be followed by 0 bits Examples Subnet mask Looe 2 5 P ds 11111111 11111111 11100000 Source IP LOG s 66 00001010 00000000 01000010 Dest IP 1 direct T0 019 69 00001010 00000000 01000101 Dest IP 2 by gateway LO 12 66 00001010 00001100 01000010 Dest IP 3 by gateway INO d 19 s 00001010 00000000 11000010 pCOWeb 4030220471 rel 2 0 28 02 2011 65 01000000 In other words the valid range subnet for the addresses that can be contacted directly from this PC will be ALL DIRECT IP s RANGE Dest IP 1 2555 Boos 64 0 00001010 00000000 01000000 00000000 Dest IP 2 Zog 255 64 a 00001010 00000000 01000000 00000001 Dest IP 43 2557 255 64 2 00001010 00000000 01000000 00000010 Dest IP 48192 255 25561 95 255 00001010 00000000 01011111 11111111 D destination IP address contained in the subnet D1 search for the MAC address of the site s server Similarly to step B1 to send the message the communications manager must first acquire the MAC address corresponding to the IP first of all it looks up its table of IP addresses MAC addresses if this is not found it searches the network by sending an ARP message and waiting for the response from the server whose IP address is equal to the destination as soon as the server responds the PC saves the MAC address in the table so that this can
168. recognises a sequence of XML tags such as in the example shown below it adds the corresponding information LINE IN TEMPLATE XML Table 4 a The default template xml file MEANING xml version 1 0 encoding UTF 8 Specifies the type of XML standard used lt PCOWEB gt lt SYSTEM gt lt HOSTNAME gt lt HOSTNAME gt lt DATE gt lt DATE gt lt IP ADDRESS gt lt IP ADDRESS gt lt MAC_ADDRESS gt lt MAC ADDRESS gt lt UPTIME gt lt UPTIME gt SYS VERSION SYS VERSION APP VERSIONP APP VERSION lt SEPARATOR CHAR gt lt SEPARATOR CHAR lt SYSTEM gt lt PCO gt lt PCONAME gt Template Sample lt PCONAME gt lt PCOID gt 1 lt PCOID gt lt DIGITAL gt lt VARIABLE gt lt INDEX gt 1 lt INDEX gt lt VALUE gt lt VALUE gt lt VARIABLE gt lt VARIABLE gt lt INDEX gt 2 lt INDEX gt lt VALUE gt lt VALUE gt lt VARIABLE gt lt DIGITAL gt lt INTEGER gt lt VARIABLE gt lt INDEX gt 1 lt INDEX gt lt VALUE gt lt VALUE gt lt VARIABLE gt lt VARIABLE gt lt INDEX gt 2 lt INDEX gt lt VALUE gt lt VALUE gt lt VARIABLE gt lt INTEGER gt lt ANALOG gt lt VARIABLE gt lt INDEX gt 1 lt INDEX gt pCOWeb 030220471 rel 2 0 28 02 2011 sections that start with this tag Start of the section with the sequences of tags with Returns
169. removing variables to the page takes seconds 5 Integration with Google gadgets MacOSx widgets or flash animations using a standard interface Disadvantages 1 Values are retrieved seconds after the page is loaded tricks can be used to preload the values on the web page using the standard tags of pCOWeb if the web pages lies in the card 2 Up to firmware A135 the requests keep the pCOWeb busier than the standard pCOWeb tags and the more people are connected to the pCOWeb the worse are the performance This is not true anymore with firmware gt A142 as the cgi has been drastically improved pCOWeb 4030220471 rel 2 0 28 02 2011 05 APPENDIX I STRUCTURE OF A pCOWeb PLUGIN For the description and the installation of the Plugins see 9 6 on page 46 a File Modifica Visualizza Preferiti Strumenti 4 Indietro tg Acerca r4 Cartelle u io UH X EE A Plugin is made up of six elements Figure l a E e Configuration files conf users directory e HTML configuration page plugins directory rc users pluginname e Executable files bin users directory Selezionare un elemento per e Start up scripts directory rc users directory nM dice e Plugin name contained in the pluginname file Documenti e Installation directory install plug xxx eee IMPORTANT The position of the files in the Plugin is essential for the correct installation and uninstallation of the Plugin Oggett
170. riptions attributed these are followed by the lines with the records Pu aw a t z p 4 E ase C Documents and Settings nicolapieretti lmpostazioni 101X MM Wu A Legend File Modifica Cera Visualizza Formato Linguaggio Configurazione Macro Esegui s Mh TNT PIET WU TentfX Plugins Finestra i li PAP T TUTTA AMI 009038 5B de oy 44 GOS hiv 1 i i Wi I Temperature Fiw am E Y e b H sie Type Digital Asalog Analog Integer Integer N up mete Humidity ka Mira omg a EE ILE T Cols Se byes n rauNX ANSI Figure 5 f Logger and graphs end results pCOWeb 030220471 rel 2 0 28 02 2011 5 LOGGER VIA E_MAIL There is the possibility to send an e mail at midnight every day Just enable the sending logger in Figure 5 g Logger by E Mail Configurator O gt ale fe 9 mal date logger Pick M From te logged data via mall Submit Figure 5 g Logger and graphs configuration DOWNLOADING THE RECORDS Thee top section of the page Figure 5 sotto features the buttons for displaying and downloading the data Subject It gives the object of the mail Body it allows to create a specific body for the mail sent from a html file downloaded via FTP in the http folder or the body could be a text typed directly in the empty field gt Update cvs file and graph manually create the cvs file and if enabled the bmp relating to the current
171. rite Figure 9 mm Manual switch to change protocol pCOWeb 030220471 rel 2 0 28 02 2011 57 After switching the above described variable from 0 to 1 a double reboot for pCOWeb is necessary first to go from Modbus Extended to Carel in the pCO Com see picture 9 1 after this first reboot the pCO Application Upload can be run pCOWeb Configuration Mozilla Firefox F e Fini risus eaga irse pe Un mm GD c bats 005 E 108m seem pain md a a Padum Dav m Tek 74 Lad Pad Eagle im Fors Iria Card Cama Son TERI Ported Daci Cue Bagni Pas Page limi iciceeniga tin Portada Cael menit fih Rea com ju pCUBiels Candigu Li gone CAREI nee A x pCOLoad parameters Mozilla Firefox http 10 0 5 109 config pw param peoload html pelosi remm armari nde Digital Varible to witch protocol Troe dd Lii Captor eer bF PS aa ST Me eee i Se Ee ee cala aon rims Select the dyin variable p T ren eS eed pi SE eri ce 2EMCLE y L E 2 IEEE el e a Ce E SRIP REGES REG ey dudas Sasori Copy Password PET daik re o Ll aes ma p ES ww paid gd di i m ood pe pio i cm i pco Application Update Loerie L th a d Linde Li ne Figure 9 nn pCO Application Upload Then once that the Upload procedure has been completed it is necessary to perform the second reboot of pCOWeb to go back from Carel to Modbus extended always in the pCO Com This is mandatory if using modbus e
172. rt G n Cj M 10 0 0 145 ED usr EQ local E root 5 flash 7 3 http i D DAME 200 NOOP command successful NOOP 200 NOOP command successful 200 NOOP command successful P 200 NOOP command successful e index html ke template xml Cartella di file Cartella di file Cartella di file Cartella di file 2 65KB HTML File 982 bytes Documento XML 3 61 KB 10 0 0 145 a BGld b 8 x 55 amp Bor Workers 1 gt KBps Worker 0mm Mame Size Source Destination Status eneny PJSULIL Documenti Risorse del computer Risorse di rete x Cestino Collegamenti desktop inutilizzati Oggetti 10 Average Speed Current Speed 21 Anonymous 3 amp z ma a o af dbeX Aix 2 E Nome Dimension _ Documenti W Risorse del computer Risorse di rete X g Cestino E Internet Explorer mozilla Firefox SB SmartFTP Client O Collegamenti desktop inutilizzati afyRete Carel Thumbs db Elapsed Left Figure 4 f SmartFTP with the Remote Browser left and Local Browser right windows The path for entering the web pages and the customised directory is Figure 4 g describes the memory on the pCOWeb and highlights the volatile and non volatile read write or read only memory areas pCOWeb 030220471 rel 2 0 28 02 2011 usr local root flash http E MEMORY write root block Mode firmware A if dele
173. s are comments and consequently are not active lt pCO set result amp nbsp amp nbsp img src config img lt setres undefined green red 5 gt gif alt lt setres undefined correct error timeout gt align bottom gt lt br gt lt br gt gt The following row is an example of the setres tag used to colour the texts pCO set result div style display inline font weight bold color lt setres gray gt Undefined green gt Communication ok red Timeout Error gt lt div gt lt br gt Addition of the Submit button lt input style width 100px margin left 20px margin top 10px type submit value Submit gt lt form gt End of the page lt div id back bottom gt C Copyright 2003 2010 by Carel Industries S r 1 Brugine PD Italy All rights reserved Contact lt a href mailto pcoweb carel com gt pcoweb carel com lt a gt lt br gt Linux porting and software implemented by DVE Progettazione Elettronica Varese Italy lt a href mailto info dveprojects com gt info dveprojects com lt a gt lt br gt lt div gt lt body gt lt html gt pCOWeb 030220471 rel 2 0 28 02 2011 80 APPENDIX H Library pw ajax js and CGI xml cgi Overview To cope with the increasing requests to integrate pCOWeb in enterprises system it had became mandatory for the pCOWeb to integrate a standard way of communicate using the HTTP protocol that is why the pCOW
174. ss during the Rescue Mode the pages need to be refreshed by pressing Ctrl F5 otherwise unexpected results may occur due to the use of the browser s cache memory the page shown in Figure 9 hh on page 56 will be displayed 2 Click Provide firmware image see Figure 9 11 on page 56 the page used to choose the block A file will be displayed select Upload to transfer the block to the VOLATILE memory during this phase the block will only be copied to the VOLATILE memory and checked pCOWeb 030220471 rel 2 0 28 02 2011 55 3 When the page showing Upload result Ok is displayed select Press here to start tu the Carel n 00 Rese JE immediately the file will be written to NON VOLATILE memory PERSE Canet DROVE sese Home cage 4 The end of the procedure will be signalled by the page shown in Figure 9 jj below then reboot pCOWeb The svstem is ing in rescue le 5 Wait at least 2 minutes then load the main page by entering the name of the Se eran utque ee IN pCOWeb or the IP address in the address field and pressing Enter This may be due to a flashdisk problem or to an invalid firmware upload operation NOTE After rebooting the Rescue Mode page may be displayed again Usually this is 9 may have to format and upload a valid firmware simply a problem with the browser To make sure that pCOWeb is no longer in Rescue Mode check the Status LED if 27777 eee flashing green the Rescue Mode page displayed is one saved in by t
175. t The following row opens the HEAD section which will contain some special html functions that have no effect on the display of the page lt head gt The meta row tells the browser to use a certain set of characters and other properties The lt link row loads the style sheets that will be used for formatting the page The lt title gt title lt title gt row attributes the title to the html page window opened by the browser lt meta content text html charset ISO 8859 15 http eguiv content type gt lt link rel stylesheet href style css type text css gt title pCOWeb Demo Page lt title gt The following row doses the HEAD section lt head gt The following row selects the colour used for the background of the page lt body bgcoLor tirrtr gt The following row writes the text pCOWeb Demo Page in h1 font size with centred horizontal alignment This is followed by the line break lt br gt hl style text align center gt pCOWeb Demo Page lt h1 gt SI The following row tells the browser that it must draw an area for acquiring data entered by the user and when confirmed send the data to the pw demo html page The list of controls for this area ends with the lt form gt command The lt center gt command defines the start of an area with centred horizontal alignment the lt table gt command places the subsequent objects in a table the lt tr gt command defines a new row in a table the lt
176. t for weil mi ee i J t siti vem va m nr pCO BIOS that can not automatically switch protocols Lo 5m Copy Password po s p oma gehn durs umi nam Warn C c He um imo bor ari rema and at Ty AT bihi Aa iaa ER E EF replete pipan Nas CUN LEEREN TT gne ee iis T ee RH Jd Dem Figure 9 Il Digital variable necessary for BIOS lt 4 10 in Carel protocol This required auto switch protocol is not supported with modbus extended and it is not possible to reserve a digital variable during the update procedure as described below To update the pCO application when Modbus Extended is running An application which is able to switch to Carel protocol SERIALI_PROTOCOL 1 or BMS PROTOCOL 1 on the serial port 1 BMS when a dedicated digital variable changes from 0 to 1 In this case the procedure is quite different from the one described for Carel protocol with BIOS 4 10 in fact the switching of the variable to change protocol has to be performed before pressing Update pCO Application Carel pCOWeb Mozilla Firefox X Carel pCOWeb Mozilla Firefox z x http 10 0 5 109 config pw_demo cgi var_index 1 amp var_type Digital http 10 0 5 109 config pw_demo egi var_index 1 amp var_type Digital Riad variable frm piOn Read variabile From pta Lus I d Tegal I kd L e Disia ow Rnad free 0 3 0means Modbus Extended gt 1means Carel Write warlable te oom Write verkeie to pCa 1 ai W
177. t the installation manager e pCOWeb already connected to the Ethernet network in this case a standard cable NOT a crossover cable is used to connect pCOWeb to the network node e pCOWeb network communication parameters already correctly configured e Knowledge of the IP address of the pCOWeb being connected to e PC already connected and configured for the data network In the following example the IP address of pCOWeb is assumed to be 10 0 3 114 1 On the PC open Internet Explorer and type the address of the pCOWeb Nuova scheda Windows Internet Explorer example 10 0 5 114 then press ENTER er ed E IMPORTANT the pCOWeb must have completed the start up phase File Modifica Visualizza Preferiti Strumenti check that the Status LED is flashing normally otherwise dir Preferiti i dy Ei Simply Modbus 9 Google KSA Carel Portal the required web pages will not be sent to the PC 2 If the network administrator has already correctly fitted the network devices Nuova scheda pCOWeb will be accessible from the PC and the pCOWeb main page index html will be shown This page can be customised by the user by default the page appears as shown in Figure 3 k below Figure 3 Opening the index page pCOWeb Default Page Mozilla Firefox File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto GOG c 13 http 10 0 3 114 http index html s ux Pi visitati Come iniziare gt Ultime notizie TestLink 1
178. tal 2 is lt td gt lt td gt lt span id digital2 gt lt span gt lt td gt lt tr gt td gt Integer 11 is lt td gt lt td gt lt span id integer11 gt lt span gt lt td gt lt tr gt lt td gt Integer 12 is lt td gt lt td gt lt span id integer12 gt lt span gt lt td gt lt tr gt lt td gt Analogue 101 is lt td gt lt td gt lt span id analog101 gt lt span gt lt td gt lt tr gt lt td gt Analogue 102 is lt td gt lt td gt lt span id analog102 gt lt span gt lt td gt lt tr gt lt table gt lt body gt lt html gt As you can see from the example here above the line lt tagparser pcotagfilt gt doesn t need to be included in the code because the pCOWeb doesn t have to parse the page as values are coming from the xml reducing the workload of the card the values will be loaded on the arrays by the function getVariables API The library pw_ajax js needs the following functions which have to be used in the javascript section of the html page pCOWeb 030220471 rel 2 0 28 02 2011 8l getParams defined in pw ajax s therefore it has to be only executed in the html page parseResults from A142 it is only executed by the pw_ajax js library therefore it has to be declared in the html page It needs the following arrays to be dedared in
179. td gt command defines a new cell in a table Note that the page has the structure as a general table in turn containing three tables each of which contains 10 pCO variables For each variable the html input command is used together with the CAREL var tag lt form method GEI actron pw demo html gt center table general table containing the following three tables SEO ca first cell in the general table table of digital variables lt table style font size 12px padding 0px margin 0px padding right 30px border right 1px solid cccccc cellpadding 0 gt tr td style font size 14px lt tr gt lt tr gt lt td style width 90px gt Var 1 lt td gt lt td gt lt input type text name script var 0 1 1 0 1 value var 0 1 1 td lt tr gt font weight bolder height 40px text align center colspan 2 gt Digital Variables lt td gt pCOWeb 030220471 rel 2 0 28 02 2011 79 lt tr gt lt td gt Var 2 lt td gt lt td gt lt input type text name script var 0 1 2 0 1 value lt var 0 1 2 5 gt gt lt td gt lt tr gt Strz td Var 10 td lt td gt lt input type text name script var 0 1 10 0 1 value var 0 1 10 2 td lt tr gt lt table gt lt td gt lt ta gt second cell in the general table table of analogue variables lt table style font size 12px padding Opx m
180. ted Rescu ir config files r user web pages f for thttpd web server root directory directory directory initrd directory directory directory directory usr directory directory local x directory directory flash directory directory directory directory directory directory directory directory user cgi files VOLATILE MEM read write NON VOLATI E ME read only MORY Figure 4 g pCOWeb memory volatile and non volatile memory 18 6 Alternatively to use Internet Explorer as the FTP client type ftp httpadmin fhttpadmin 10 0 0 145 Blank Page Windows Internet Explorer C3 a ftp rihttpadmin Fhttpadmini amp 10 0 0 145 Fie Edit View Favorites Tools Help Google Gr r co4 D E vr Bookmarker Ei AE che Blank Page FTP Directory ftp httpadmin 10 0 0 145 Mozilla Fir File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto 39 cx amp ftp 10 0 0 145 di Pi visitati Come iniziare Ultime notizie TestLink 1 7 4 Carel Portal English tc i3 FTP Directory ft ES FTP Directory ftp httpadmin 10 0 0 145 zs Parent Directory Root Directory ka E ie Bash history a n a a a Cet e Lk ae 420 pees
181. that do not extend across the range 1 207 This means that there may be some U s for the last variables F The pCO BIOS versions superior to 2 51 supports Carel protocol version 3 0 pCOWeb requires this protocol version or superior pCOWeb 4030220471 rel 2 0 28 02 2011 65 APPENDIX D ArGoSoft A FREEWARE MAIL SERVER Various SMTP servers are available on the Internet Below is a description of the ArGoSoft Mail Server freeware version 1 8 8 9 downloadable at the link www argosoft com After installation when first started the screen shown in Figure D a below is displayed ArGoSoft Mail Server E lol xl File Tools Help The Listening on port messages confirm that o B COW R e e SMTP Server started the server that pCOWeb will send the messages to 16 04 2007 14 E TUE Fun NE IMPORTANT if another SMTP manager is already active port 25 will be High version eozoz V busy and the service will not be started Close the other manager Svsten status Running e POPS3 Server started the server that the e mail client will download the Local host rolfertov messages from Is running Local host aftek reverse lookup robertop carel locale IMPORTANT if another POP3 manager is already active port 110 will be busy and the service will not be started Close the other manager e Finger Server started optional service not used by pCOWeb ignore e Web Server started the server to access the MAILBOX from a
182. the local network or on the Internet that is running an FTP server application that can receive such files APPENDIX E on page 69 presents FileZilla Server a freeware application downloadable from the Internet that once installed on the PC can receive files from pCOWeb via FTP This server is recommended for running tests without necessarily having to access an external server e o receive the SNMP TRAP or INFORM messages sent by pCOWeb a PC must be available on the local network or on the Internet which is running a supervisor based on the SNMP protocol APPENDIX F on page 70 presents Trap Receiver a freeware application downloadable from the Internet that once installed on the PC can receive and show the notifications TRAP INFORM from pCOWeb This server is recommended for running tests without necessarily having to use an SNMP supervisor 4 3 1 Events generated upon variations in the value of a variable pCOWeb can be set to send a notification when the value of a pCO controller variable changes The types of messages sent can be selected separately for each variable For the settings see 4 3 3 on page 23 and 4 3 4 on page 25 Digital variables The notifications can be sent upon the following transitions e 0 1 only e 1 0 only e both Fxample 1 E mail and FTP PUSH programmed to be sent when digital variable 12 changes from 0 1 0 1 send both notifications 1 0 nothing sent pCOWeb 030220471 rel 2 0 28 02
183. the pCO controller activation of alarms exceeding of thresholds or at set time intervals a file in XML format can be attached containing the values of the variables e FTP PUSH pCOWeb can send a file in XML format containing values of the variables to a suitably configured computer the send operations can be programmed in the same way as for send the e mail messages upon event or at set times the file is sent using the FTP protocol pCOWeb 030220471 rel 2 0 28 02 2011 7 e SNMPvI amp v2 to access pCOWeb from a computer using supervision software based on the SNMP protocol pCOWeb can send programmable enterprise TRAP or INFORM packets for alarm notifications MODBus over TCP IP pCOWeb supplies information to a MODBus master requesting it over TCP IP BACnet Ethernet SO8802 2 over 8802 3 to access the pCO controller using supervision software based on the BACnet Ethernet protocol BACnet IP Addendum A Annex J for access using supervision software based on the BACnet IP protocol FTP server used to copy data files or web pages from to pCOWeb in a simple manner using programs based on dragging icons from one window to another e DHCP used to connect pCOWeb to a local network using the method of automatic addresses assignment by a central server rather than statically setting the addresses on the individual devices DHCP Is active by default e X Plugins used to add additional applications developed by CAREL or by the user
184. the variable possible situations the value sent to the pCO is the same as the existing value the index of the variable is outside of the limits managed by the BIOS version of the pCO used communication between pCO and pCOWeb is interrupted for further information see APPENDIX C on page 65 o Undefined returned for all read operations and for the write operations that do not send any request to the pCO that is when a numeric value has been entered that is not allowed Digital 0 1 Analogue 3276 8 to 3276 7 Integer 32768 to 32767 e est notifications send all the notification messages set regardless of whether the corresponding events occur or time interval has expired For details of the notifications see 4 3 on page 20 The message displayed once you executed the test is NOTE 1 NOTE 2 Launching all the notifications Launching all the notifications done l Close Window Figure 9 bb pCO variables test The notifications may take a lot of time to be sent depending on the number of messages set during this activity the Status LED could stop flashing the completion of the notifications will be signalled by the confirmation page Running this test does not ensure that all the messages have effectively been delivered check that all the conditions described in 4 3 on page 20 are Ok so that pCOWeb can deliver the messages where tt will be possible to analyse the mail traffic Verbosity this fun
185. the window shown in Figure 3 b right is displayed See dm AMO pM Note down all the settings shown in the new window this will be useful for returning to the original settings when the procedure is terminated so that the PC can again communicate with the data network it was previously connected to In the example shown in the figure the PC was using an IP address obtained automatically from the DHCP server in the data network Then pCOWeb 030220471 rel 2 0 28 02 2011 10 Internet Protocol TEP TP Properties 8 Click Use the following IP address Figure 3 c 9 Setthe following parameters Tou can get IP retingi signed autcmalie alis if you neia supporti ihi capote Otherwise pou rend to as your restando administer bor the appropriate IP sstinga IP address 2 172 16 0 2 Subnet mask 255 255 0 0 bes an IP addeezt automabcal 10 Click the OK button to dose all the windows Dod init bm C PROXY C tnam DNE eve oes ooh INFORMATION er The following procedure tells the personal computer to not use the network device called the proxy for Merle DNS serv communication in fact the PC is not connected to the network and if the proxy is not disabled acri communication would not be possible Ce em Open the Windows Control panel o Double click Internet options the window shown in Figure 3 d above left will be displayed Figure 3 c Assigning an IP address to the
186. there are always 16 Notification Class objects 16 Calendar objects 16 Schedule objects and there can be up to 207 Analogue Values 207 Analogue Values or Multi state Values and 207 Binary Values The number of each type can be configured prior to use From the factory all 621 Analogue Value and Binary Value objects are mapped Object Identifiers are assigned according to the following table Table 7 a BACnet Carel mapping Object Type pCO Mapping AndogueValue 1207 1207 Al A207 Analogue Value or Multi state 1001 1207 1001 1207 Value Binary Value 1 207 D001 D207 pCOWeb 030220471 rel 2 0 28 02 2011 56 From the factory 1001 12007 are mapped as Analogue Value 1001 Analog Value 1207 Each of these may be reprogrammed as Multi state Values on an individual basis by writing to the Object_Identifier property BACnet objects which are mapped but for which there are no corresponding physical pCO points return an unreliable other 7 value for the Reliability property of the corresponding object and an undetermined value for the Present_Value property usually 0 or 0 0 The Object_Name properties for all the objects except the Notification Class objects are writable and can be up to 32 characters in length By default the Analogue Value Multi state Value and Binary Value objects are named A001 A207 1001 1207 and D001 D207 corresponding to their pCO mapping 7 2 BACnet MODBUS Mapping For each pCOWeb that interfaces
187. ting function Is described Clock and Logger Cwante Figure 9 c Click to refresh the Body section shown in Figure 9 b For further information on exchanging the values of the variables between the pCO and pCOWeb see APPENDIX C on page 65 MENU AREA The Menu area is always the same for all the main configuration pages It contains e A buttons for opening the main configuration page e B Reboot button when selecting this pCOWeb will be rebooted without requesting confirmation This is required in some phases of the configuration e C System is using see 3 1 2 on page 12 Factory Parameters pCOWeb is using the Bootswitch parameters Figure 3 g on page 12 User Parameters pCOWeb is using the parameters set by the user e D displays the pCOWeb firmware version Tests Customer Site Info amp Contact A Applications B Bios IMPORTANT do not confuse this with the firmware version BIOS of the pCO B e E displays the pCOWeb MAC address see 2 2 on page 9 c e F displays the pCOWeb date and time at the moment of the last update requested for the page displayed from the PC for example with F5 D e G symbol that the HTML page conforms to the HTML 4 01 standard E F 9 2 3 Displaying the main page Figure 9 d Menu area When a configuration page is displayed the main page can be recalled by clicking Customer Site a new window will be op
188. tion pages chapter 9 on page 39 which reside in read only memory e custom pages that can be added by the user which reside in USER MEMORY space non volatile read write In the custom pages as well as the typical commands of the HTML standard other commands tags can be added as per the CAREL standard this allows read or write access to the supervisor variables of the pCO controller ACCESS RESTRICTIONS Access restrictions can be defined for all or some custom pages Whenever a protected page with access restriction is called pCOWeb displays a login dialogue box requiring the Username Password for the specific restriction see 9 7 1 on page 49 CGI SCRIPT CGI scripts can be developed in bash language or compiled languages These must have the cgi extension and must reside in the usr cgi directory usr local root flash usr cgi otherwise they will not work Whenever one or more CGI scripts is modified click the Adjust HTML pages attributes link see 9 3 on page 43 For a guide to CGI script for the pCOWeb see the documents available at http ksa carel com 4 1 1 Creating HTML pages To create pages for the pCOWeb a PC and knowledge of HTML are required The area dedicated to pCOWeb on KSA http ksa carel com features simple web pages for the standard CAREL applications which can be used as the starting point for creating custom web pages The description of HTML is outside of the scope of this document Numerous guides
189. tually managed by the software to improve drastically the performances of the card All the configuration web pages of pCOWeb will automatically adapt to the new limits IMPORTANT The number of variables read by pCOWeb must be equal or superior to the number of variables mapped in the BACnet configuration see Figure 7 a on page 36 IMPORTANT if the CAREL supervisor protocol or ModBus Extended protocol has not been selected on the pCO communication will not be possible pCOWeb 4030220471 rel 2 0 28 02 2011 44 NOTE pCOWeb unlike other devices that communicate using the CAREL supervisor protocol does not require the setting of the supervisor serial address IDENT while using ModBus Extended it is required The fixed settings for the pCOWeb serial port are gt Frame 8 bits gt Parity bit none gt Stop bits 2 The speed can be set between 300 600 1200 2400 4800 9600 19200 default 38400 57600 115200 bit s and must coincide with the baud rate of the pCO supervisor port selected on a special screen on the application interface the protocol can be set between Carel and Modbus Extended as we can see in Figure below The default values for pCOWeb are 19200 baud and Carel protocol and can be changed as required IMPORTANT e The set value will only be used when pCOWeb is next rebooted e If the speed set for pCOWeb is different from the value set for the pCO communication will not be possible pCOWeb Configuration
190. tures 7 5 1 Alarming BACnet Intrinsic Alarming is supported for the Analogue Values Out of Range event types Binary Values Change of State event types and Multi state Values Change of State event types All optional properties related to Intrinsic Alarming are included and writable where appropriate Use of Notification Class Objects may be optionally bypassed In this scheme if an object s Notification Class property is set to 0 three standard BACnet properties that are normally included in Notification Class objects specifically Ack Required Issue Confirmed Notifications and Priority are included for each Analogue Value Binary Value and Multi state Value object and take the place of the Notification Class Although these properties are not standard or optional for Analogue Value Binary Value and Multi state Value objects they are treated in a standard BACnet way Also in this scheme two properties Process Identifier and Recipient are included for the Device Object and take the place of the Notification Class Object Although these properties are not standard or optional for Device objects they are treated in a standard BACnet way The Recipient property is limited to the Object Identifier of a Device object If the Notification Class for an object is 0 it will be reported as 1 in alarm events For all alarms the default Message Text that is always included by default is of the form nnnnnn Binary Value xxx ChangeOfState v nnn
191. turns an echo even when the variable is in read only and the value sent to the pCO is different from the one in the application the echo returned sends the unchanged value contained in the pCO application e ifthe pCO receives the write request for a variable with a value that is the same as the current one no echo will be generated for that variable For these reasons this tag should only be used to check the operation of the HTML pages during their construction For further information on communication with the pCO see APPENDIX C on page 65 Example Figure G d on page 74 Displaying the result of the write operation lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN gt lt html gt lt tagparser pcotagfilt gt lt head gt lt meta content text html charset ISO 8859 15 http eguiv content type gt lt title gt pCOWeb Demo Page lt title gt lt head gt lt body bgcolor ffffff gt hl style text align center gt pCOWeb Demo Page lt h1 gt lt br gt lt form method POST action example html lt input type text name script var 0 23 9 52700 22707 value lt Gvar 0 3 9 3 gt gt lt input type submit value Submit gt lt form gt Operation result lt setres Undefined Ok Timeout gt lt body gt lt html gt pCOWeb 030220471 rel 2 0 28 02 2011 13 pCOWeb Demo Page Windows Internet Explorer nm x Ea i http 10 0 0 145 httplexample htm
192. uickly red green red green for a few seconds confirming the reboot after 1 2 minutes the completion of the reboot phase will be signalled by the regular flashing of the Status LED or the steady red colour Rescue mode see 9 10 5 on page 55 9 10 FIRMWARE UPDATE The pCOWeb firmware can be updated by uploading it from a computer via the Ethernet connection using the configuration page The firmware is divided into two separate blocks each with its own version The current blocks and versions are A1 4 2 block containing most of the application programs B1 2 1 block containing the BIOS that is the GNU Linux operating system and the basic applications To check the firmware version on the pCOWeb see Figure 9 d on page 42 INFORMATION e Every update operation loads only a block per time pCOWeb 4030220471 rel 2 0 28 02 2011 DI e pCOWeb does not check for coherence between the two blocks e There is no need to update both blocks if one of these is already up to date e The order of updates A then B or B then A is indifferent e An earlier block than the current one can also be loaded e Currently there is no incompatibility between the versions of the two blocks for outdated versions check the documents supplied e Updating the firmware does not affect the user settings as the non volatile memory is divided into areas Nonetheless as the information on the sub division of the areas is contained in block B in the f
193. uration pages l 2 di connect to pCOWeb using a PC chapter 3 on page 10 start Internet Explorer opening the main page Figure 3 1 on page 13 the main page may have been customised and consequently will be different from Figure 3 1 If the page appears as shown in Figure 3 1 click the Go to Administrator area link An authentication dialogue box similar to the one shown in Figure 9 a below will be opened Continue as described in paragraph 9 2 1 on page 41 NOTE The authentication dialogue box is enabled by default however it may be been disabled by the user for the disabling procedure see paragraph 9 2 1 on page 41 in this case the dialogue box will not open continue as described in paragraph 9 2 2 on page 41 If on the other hand the main page is different because it has been customised the Go to Administrator area link may not be available In this case open the copy of the main page available in the read only memory typing the following address in Internet Explorer http pCOWeb IP address gt defindex html The IP address entered refers to the pCOWeb being configured when using the button at pCOWeb starting procedure described in paragraph 3 1 on page 10 the IP address will be 172 16 0 1 In the more general situation of connection via the network there may be more than one pCOWeb connected consequently the IP address of the pCOWeb in question needs to be known if necessary contact the network admin
194. ut does not allow navigation outside of this directory In this case files can be transferred from pCOWeb to the PC and vice versa 4 3 EVENT NOTIFICATION E MAIL FTP PUSH SNMP TRAP INFORM Notification messages can be programmed to be sent when asynchronous or scheduled events occurred The following types of notification messages are managed e E mail the body of which can contain customised text or a web page with the values of the pCO controller variables read at the moment the message was sent possibility to attach a custom XML file containing the values of the variables e XML file identical to the one sent by e mail but in this case delivered by FTP FTP PUSH function e SNMP TRAP or INFORM messages which can contain up to 5 values of selected pCO variables INFORMATION e To be able to send e mails pCOWeb must have access to an SMTP server on the local network or the Internet pCOWeb sends the e mail to the server and a PC can then access the server and download the messages that have been sent to it APPENDIX D on page 66 presents the ArGoSoft Mail Server a freeware application downloadable from the Internet that once installed on the PC can receive e mails from the pCOWeb and then forward them to an e mail client for example Microsoft Outlook This server is recommended for running tests without necessarily having to access an external server e To be able to send files via FTP pCOWeb must have access to a PC on
195. uture CAREL may need to move the sub division information following the addition of new functions In that case the change will be described in the documents and the data will need to be backed up see 9 1 on page 40 IMPORTANT If when updating block A the procedure is interrupted due to a power failure the block A transferred is not valid and upon next reboot pCOWeb will enter Rescue Mode see 9 10 3 on page 55 the normal functions will no longer work but pCOWeb due to presence of a valid block B will continue to operate to allow block A to be loaded again although with a slightly different procedure IMPORTANT If when updating block B the procedure is interrupted the product will be need to be sent to CAREL for reprogramming in the factory NOTE Rescue Mode is also activated by updating outdated firmware on pCOWeb for example if starting from version A1 2 7 B1 1 5 and updating to A1 3 1 B1 2 1 in fact the last versions have different limits in the allocation of the non volatile memory that cause the corruption of the existing block A 9 10 1 Procedure for updating the firmware from web pages The firmware updates are distributed by CAREL divided into two separate files included in the same compressed file For example the update relating to the version that this manual refers to is UPDATE FILE NAME on http ksa carel com pCOWeb_A142 B121 zip Block name Block type Update file name Date A 1 4 2 Applications flash_apps_A1 4
196. ware version lt Sbootvalues gt Type of parameters used when starting User Bootswitch see 3 1 2 on page 12 lt Sipaddr eth0 gt IP address of the ethO interface use eth0 1 eth0 2 eth0 3 for the others lt sdate gt Current time on the pCOWeb in the format 1970 01 03 20 27 Example Figure G i en page 78 lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN gt numl lt tagparser pcotagfilt gt lt head gt lt meta content text html charset ISO 8859 15 http equiv content type gt lt title gt pCOWeb Configuration lt title gt lt head gt lt body gt lt div gt The ethernet Mac Address is lt macaddress gt lt div gt lt div gt The pCOWeb firmware release is lt fw_release gt lt div gt pCOWeb 030220471 rel 2 0 28 02 2011 71 lt div gt The pCOWeb started using lt bootvalues gt lt div gt lt div gt pCOWeb IP address Eth0 lt ipaddr eth0 gt lt div gt lt div gt pCOWeb date time lt date gt lt div gt lt body gt lt html gt JO xi pCOWeb Configuration Windows Internet Explorer Qc ad le http 10 0 0 145 httpfexample html t x Google B File Edit View Favorites Tools Help G0 4 O My ts Bookmarks E7 blocked SP Check Autolink AutoFill ab Sendtov settings fa OE ome Page Gf Tools Google we dig E pcoweb Configuration The ethernet Mac Address is 00 0a 5c 10 07 15 The pCO
197. with O EXAMPLE THE PW_DEMO HTML PAGE Below is a description of the pw_demo html page available by accessing pCOWeb via FTP at the path usr local root config For further information on the creation of the HTML pages go to http ksa carel com under the section pCOWeb pCOWeb 030220471 rel 2 0 28 02 2011 78 PW_DEMO HTML PAGE The following row is useful for having the page validated by automatic software so as to check the correct usage of the language it declares the type of document and the corresponding standard and version lt DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN gt The following row opens the section that will contain the HTML statements This is closed by lt html gt ST o The following rows in standard html language simply represent comments The last of the three rows is nonetheless essential for the pCOWeb pages and MUST be included in the page see the start of APPENDIX G on page 71 This tells pCOWeb which translator must be used for the proprietary tags pCOWeb currently features just one tag translator for CAREL tags so the row is always lt tagparser pcotagfilt gt If this row Is not entered no CAREL proprietary tags will work lt lo The tag filter must be specified in the first LO lines after the lt html gt statement with the syntax gt lt tagparser pcotagfilt gt NOTE Unlike the comment the position of the row in the page is irrelevan
198. wn in Figure 9 0 will be displayed The Install plugins section will show Install plugin Information Network Time Protocol the text displayed is taken SRI from the pluginname file in the Plugin installation Sicca togge directory copied from the computer to pCOWeb If the usr local root flash http directory contains CUBES pcomebacar com more than one installation directory link will be displayed for each Plugin Install plugins metall Figure 9 0 Install Uninstall Plugin page list of Plugins ready to be installed 5 To start the installation procedure click Install plugin Network Time Protocol IMPORTANT Confirmation is not requested before Starting the procedure and the installation if succeeded will delete the install plug xxx directory on pCOWeb copied from the computer Install plugin repart Configuration Clock and Logger Events ok Tests Customer Site Info amp Contact Figure 9 p NTP Plugin installation report pCOWeb 030220471 rel 2 0 28 02 2011 46 At the end of the installation procedure which may last some tens of seconds a report is displayed describing the outcome of the installation of each file if the installation was not successful the Plugin installed will need to be manually removed The report is as shown in Figure 9 p In this case all the files making up the Plugin were installed correctly If the installation procedure attempts to
199. xtended protocol pCOWeb supports BLB BIN BLX Strategy UP User interface GRP graphic resources available only with 1Tool DEV default parameters PVT LCT bios logger configuration pCOWeb doesn t support GRT BIOS BOOT VERY IMPORTANT It is standard in custom pCO application and in each Carel standard application that in order to avoid memory mismatching to re initialize the unit to the default configuration when the application updates so that is strongly advised to upload together with the applications files a consistent DEV file for the specific application i e downloading it from another controller with similar configuration and the new software Updating the pCO application is a very critical procedure for the unit it implies to switch it off before taking any action pCO will de energize every digital and analogue output during the firmware upgrade without taking in consideration any safety timing or specific procedure defined in the software Please go to http ksa carel com and download the step by step guide Updating pCO Application via pCOWeb pdf gt pCOWeb Configuration Windows Internet Explorer Go a 10 0 3 114 5x oM File Modifica Visualizza Preferiti Strumenti wy Preferiti ce ISIMpiy Medbus Google KSA Carel Portal W WordReference English Grammar pODWeh Configuration st E mp Pagina Sicurezza Emang pCOnWabw memori pCOWab will be Back Kay worlins M Tha end af tha Fr

pCOWeb User manual

Contents

Download Pdf Manuals

Related Search

Related Contents