PELCO Camera and SCADA Integration Guide
Contents
1. 33 Pan TitandZoomtoolbar c ccccc sssscscscccccesssccccccccccceso 33 Popup Menu Controls 0222eoeeeeneenenneeeennenennnenennnnnnnnnnnnnn nennen nenne nennen 34 PELCO Viewer mouse OONTTOlS sssssccc sssssccccccccesscccccccco 36 RTSPandSariXcameras c sscsccccccsssscscccccecessscscccccccececccccc 36 Reference a AA SAHERVIRSERR 37 Chapter 6 PELCO Viewer ActiveX Control Interface Properties 39 jon een mre A 40 AutoConnect us canada reten erde ea een 40 SE 1101170 1 ABENTEURER RER Sa ee tao Ey Re np pa e 40 CameraNumber nn 41 GameralbAddress a eens don eos a elds sea Gone ange ds sica 41 CameraPortlNUMDer s ssscccc sssccscccccccsssscccccccccc c 41 HOMER ESCs mas sse e mm E A pa Sn meee lene 42 ReverseTilt eo ss o ro zeno e nnn ORO NETO LASER Mee eton nj see ge nemen aa Be seen e se 42 ike PPT TAT 42 RispUn nee aa le er wl ee ee a ee eee dea 42 UNICASTSINCAM 222 5 22 2 a tit Pa ie ones 43 UnicastStreamIP 22 2 2 22 c cece cece cnc 43 Uk sis es a at eed ee ec eae ee 44 VelocityHorizontal o nennen cnn cnn cnn cnn 44 NOLE INALE ai a s EE EE dd tte 44 Reading and writing to properties 44 Chapter 7 PELCO Viewer ActiveX Control Interface Methods2. 15 Installation requirements s s sssssssss sssssssscssssssssssssscscsssscecececccos 15 suko GERE FTE oooOoNIEU 15 Systemihardwa 6 ssess s sedas tidad Su gg UNANG LANGYA nes 16 Installing the PELCO Viewer ActiveX Control 18 Verifying the camera video streaming nenne nennen nennen 18 Finding the camera s IP address port and number 2 c cece cece cece cece cece eeeeeeeeeeeeeeeees 20 Checking camera availability nennen 20 Chapter 3 Connecting to a PELCO Camera from a Project 23 Configuring during design time 23 Adding the PELCO Viewer ActiveX Control ls lseeseeesellil 23 Configuring PELCO Viewer properties cece eee ccc cece ccc e ccc eceeceeceeeeeeeeeees 24 UsingitagiaSSOcialiOn cocidos october ciel usust ire clica nn esse hes sb Ses skua en a a ne a 25 Controlling the camera 26 Compiling and Running the Project 27 UsingCicode c ccccccccccecccccecceceeccececccccescccceoceceocccccos 28 Saving settings between page transitions cs c csscccccccc 29 Contents Chapter 4 PELCO Example Project 31 PELCO Camera Management page nn 31 Camera Alarm Link 31 GENIOS ass set a a a ef os a e res dl do e 32 Chapter 5 Further Viewer Features
3. 47 Connection Methods 2 47 Customize User Interface methods ceseseseesllllllll 48 PAGO LETE ee ets ee Me ate ee et See Nee 49 Preseti Melh0dS ses sj svin e essen 50 Pattern Methods nenn nnnneeneenen 52 Chapter 8 Troubleshooting 0 00000000000 55 Devicesandtools c ccccccccosssssescccccesssscccsccccecssscccccccco 55 Implementation checklist cc ssscsscccccssssccccccccc 56 Debugging procedute 4 2 sons esa AD a ALAN naa decretar ica 56 Enablingeventlogs c cccccccccccceccccccccccsscssssssss s s eo o 57 Troubleshootingguide ccccccccceeoccoeeceeeoooooeeceeeoooeeeclcl 57 Contents Contents Part 1 Introduction This section introduces the PELCO Viewer ActiveX Control and describes how to install the control on a SCADA computer In this document SCADA will refer to either Vijeo Citect CitectSCADA or CitectFacilities software Safety Information PELCO Viewer Usage Installing the PELCO ActiveX Control Connecting to a PELCO Camera from a Project PELCO Example Project Further Viewer Features Safety Information Hazard categories and special symbols The following symbols and special mess
4. If no refer to PELCO manual or contact PELCO support If yes try connecting the camera from PELCO Diagnostic Playerr Virtualization software typically installs its own software network adapters on your machine These adapters if enabled can steal multi cast traffic Resolutions include 1 Disable virtual network adapters 2 Useaunicast connection and specify your network adapter 3 Consult your virtualization software manufacturer for other solutions Symptom PTZ too slow or fast Possible Issue Does this happen when using toolbar PTZ control buttons Does this happen when using mouse control Does this happen when using cus tomized control or Cicode Remedial Action If yes this is by design and cannot be changed during runtime If no please continue If yes this is by design and cannot be changed during runtime If no please continue If no please refer to information above If yes increase or decrease horizontal or vertical velocity to adjust PTZ speed until you are satisfied 59 Chapter 8 Troubleshooting 60 Symptom PTZ control latency is too long Possible Issue Image quality and bandwidth too high Too many con current camera con nections Network traffic is too heavy Network too slow Remedial Action Reduce bandwidth Reduce number of concurrent camera connections Reduce unnecessary network traffic if possible Make sure the camera is within the lo
5. Connection methods are used to connect to and disconnect from a PELCO device The table below contains connection methods for the PELCO Viewer ActiveX Control interface in this release Method Name Description Connect Connect to the PELCO device video stream specified 47 Chapter 7 PELCO Viewer ActiveX Control Interface Methods Method Name Description by the properties It is used for both RTP and RTSP cameras Disconnect Disconnect from the PELCO device stream It is used for both RTP and RTSP cameras Connect CameraBandwith Connect to the PELCO device video stream and set up bandwidth specified by the Properties This method is supported for both RTP amp RTSP streams Where CameraBandwith is O 1 or 2 O high band width 1 medium bandwidth 2 low bandwidth The default value is 0 See also Bandwidth property Example To connect to a camera the Connect method should be used The example below shows how Cicode can be used to connect to a PELCO camera The other two methods can be used in the same way as this method PELCOCam used in the example code is the actual object name that has been assigned to the PELCO Viewer ActiveX Control object in this project FUNCTION ConnectCamera OBJECT hPELCOCam ObjectByName PELCOCam _ObjectCallMethod hPELCOCam Connect END Customize User Interface methods Customize User Interface methods are used to customize the PELCO Viewer use
6. Failure to follow these instructions can result in death serious injury or equip ment damage 52 Chapter 7 PELCO Viewer ActiveX Control Interface Methods Example The example below shows how to use the PatternRun method to run a pattern on the PTZ camera Other pattern methods can be used in the same way as this method In the example below a Cicode function has been written to run a pattern previously recorded and stored in the PTZ camera PELCOCam used in the example code is the actual object name that has been assigned to the PELCO Viewer ActiveX Control object in this project FUNCTION RunPattern OBJECT hPELCOCam ObjectByName PELCOCam INT pattern StrToInt Input Run Pattern Enter the Pattern Number to Run 53 VI J E _ObjectCallMethod hPELCOCam PatternRun pattern END 53 Chapter 7 PELCO Viewer ActiveX Control Interface Methods 54 Chapter 8 Troubleshooting In this section some guidelines and tips are provided for debugging on PELCO camera related projects When working with PELCO Viewer ActiveX control you will be able to see real time camera status in the status bar and additional information will be logged in the Windows event viewer Enter the eventvwr run command to launch the Event Viewer For specific PELCO camera difficulties please refer to your PELCO camera s manual Devices and tools Essential devices In order to analyse functionality relate
7. Start opening the camera s iris to brighten the image Start closing the camera s iris to darken the image Stop resizing the iris Auto adjust the camera iris 49 Chapter 7 PELCO Viewer ActiveX Control Interface Methods When a pan method is called for example PanLeft it will continue to run until a Pan Stop method is called A WARNING LOSS OF CONTROL Ensure PanStop is called when PanLeft or PanRight methods are used Failure to follow these instructions can result in death serious injury or equip ment damage Note PanLeft and PanRight methods require PanStop to be called to stop the camera from continuously panning Example An example has been provided below on how to use the PanLeft method to pan a PTZ camera left for 10 seconds and then stop the operation Any other PTZ methods can be used in the same way as this method PELCOCam used in the example code is the actual object name that has been assigned to the PELCO Viewer ActiveX Control object in this project FUNCTION PanCameraLeft OBJECT hPELCOCam ObjectByName PELCOCam _ObjectCallMethod hPELCOCam PanLeft SleepMS 10000 _ObjectCallMethod hPELCOCam PanStop END Preset Methods 50 The preset methods are used to manage and run presets on a PELCO PTZ camera and are not applicable to fixed cameras Home is also a special preset in the PTZ camera It is also possible to set the Home position and point the camera to th
8. DXDIAG E example project camera management page F FocusAuto method FocusFar method FocusNear method FocusStop method genie function pelcoCameraSelector SetValue graphic card memory graphics pages defining H hardware requirements HomePresetID prroperty image quality issues implementation checklist install issues installation verifying invalid IP address IP address IPAddress property IrisAuto method IrisClose method IrisOpen method IrisStop method mapping tags 26 56 56 16 47 26 55 31 31 49 49 49 49 32 32 32 18 23 16 42 61 56 57 15 18 58 20 41 49 49 49 49 26 65 Index memory graphic card methods connection customize pattern preset PTZ mouse controls multiple video stream issues N no video at runtime O operating system requirements P PandDown method PanLeft method panning PanRight method PanStop method PanUp method pattern methods pattern recording PatternEnd patternID method PatternRun patternID method PatternStart patternID method PatternStop patternID method PELCO camera usage PELCO Device Utility PELCO Diagnostic Player PELCO Viewer adding pelcoCameraSelector genie 21 18 Persist ActiveX data between page transitions port number camera Port property preset methods PresetDelete presetID method PresetHomeRun method PresetHomeSet method PresetRun presetID method
9. Run Preset Enter the Preset number to Run 1 e _ObjectCallMethod hPELCOCam PresetRun preset END Example In example below the Cicode function demonstrates how to save the PTZ camera s cur rent position and settings as the Home position FUNCTION SaveHomePosition OBJECT hPELCOCam ObjectByName PELCOCam 51 Chapter 7 PELCO Viewer ActiveX Control Interface Methods _ObjectCallMethod hPELCOCam PresetHomeSet ND Pattern Methods Pattern methods are used to record and run patterns on a PELCO PTZ camera and are not applicable to fixed cameras The table below contains pattern methods for the PELCO Viewer ActiveX Control inter face in this release Method Name Description PatternRun long patternId Run the camera movement pattern specified by the pat tern ID PatternStop long patternId Stop the camera movement pattern specified by the pat tern ID PatternStart long patternId Start recording the camera movement pattern specified by the pattern ID PatternEnd long patternId End recording for the camera movement pattern spec ified by the pattern ID Note If you use the PatternStart method to start recording a pattern then a Pat ternEnd method must be used to end the recording Also note that there is only one pattern supported on some PELCO PTZ cameras in IP mode A WARNING LOSS OF CONTROL Ensure PatternStop is called when PatternStart method is used
10. and the current PELCO Viewer Acti veX control supports both RTP and RTSP The SarixCamera page in the example project is designed for a Sarix camera Part 2 Reference This section describes the properties and methods used to access and control PELCO cameras from within SCADA ln addition it provides a troubleshooting section to help investigate loss of connection with your cameras PELCO Viewer ActiveX Control interface properties PELCO Viewer ActiveX Control interface methods Troubleshooting 37 38 Chapter 6 PELCO Viewer ActiveX Control Inter face Properties The following properties can be used to manage and control PELCO IP cameras in var ious ways from video streaming PTZ control speed and other properties at SCADA run time See PELCO Viewer ActiveX Control Interface Properties Property AutoConnect Bandwidth CameraNumber CameralpAddress CameraPortNumber HomePresetId ReverseTilt RtspMode RtspUrl UnicastStream UnicastStreamIP UnicastStreamPort VelocityHorizontal VelocityVertical Description Connects to configured camera when page is loaded in runtime Returns the streaming video bandwidth constraints Changes the active camera being viewed on a DVR The IP address of the PELCO device where video is streamed from The port number of the camera Camera preset ID used for the home position button on the PTZ control Reverses the tilt direction when using t
11. for Supervisory Control and Data Acquisition SCADA solution It facil itates the creation of software to manage and monitor industrial systems and processes Due to SCADA s central role in controlling systems and processes you must appro priately design commission and test your SCADA project before implementing it in an operational setting Observe the following A WARNING UNINTENDED EQUIPMENT OPERATION Do not use SCADA software as a replacement for PLC based control programs SCADA soft ware is not designed for direct high speed system control Failure to follow these instructions can result in death serious injury or equip ment damage 10 Safety Information A WARNING LOSS OF CONTROL e The designer of any control scheme must consider the potential failure modes of control paths and for certain critical control functions provide a means to achieve a safe state during and after a path failure Examples of critical control functions are emergency stop and overtravel stop Separate or redundant control paths must be provided for critical control functions System control paths may include communication links Consideration must be given to the implications of unanticipated transmission delays or failures of the link Each implementation of a control system created using SCADA must be individually and thoroughly tested for proper operation before being placed into service Failure to follow these instructions ca
12. to view the live video and control the PELCO camera using the built in pan tilt and zoom controls such as toolbar buttons mouse and popup menus See Pan Tilt and Zoom Toolbar for more information Cameras can also be controlled using customised buttons Some examples of custom control buttons can be seen in the PELCO example project 27 Chapter 3 Connecting to a PELCO Camera from a Project Using Cicode 28 A PELCO camera control can be created and the camera controlled using Cicode func tions The PELCO Viewer ActiveX Control comes with a group of programming inter faces which can be accessed via Cicode The two examples below demonstrate how to use Cicode to control your camera through the programming interface Example In this example a Cicode command is embedded in a Button object named Left that will control the camera to pan left at runtime The Cicode command for the button down input is _ObjectCallMethod ObjectByName PELCOCam PanLeft The Cicode command for the button up input is _ObjectCallMethod ObjectByName PELCOCam PanStop In this case when the button is clicked the camera will pan to the left The pan left oper ation stops when your button is released PELCOCam used in the Cicode function is the object name assigned to the PELCO Viewer ActiveX Control object on the page of your project Example In this example two Cicode functions are defined that do the same job as the e
13. ELCO Viewer ActiveX control to your page see Adding the PELCO ActiveX Control 3 Map tags to properties 25 Chapter 3 Connecting to a PELCO Camera from a Project Open the PELCO Viewer Properties window On the Access tab and the Identification subtab set the Object Name to PELCOCam Make sure the Persist ActiveX data between page transitions checkbox is checked Then on the Appearance tab and Tag Association sub tab map the variable tags created above to the camera s properties 4 Create buttons and objects to control the camera see Controlling the camera 5 Compile and run the project see Compiling and running the project Controlling the camera This section describes how to create buttons to control the camera s properties and dis play them on the graphics page at runtime Managing camera properties The SetValue genie has been included to simplify the creation of buttons and text objects that will change the properties of the PELCO camera For example in order to be able to change the IP address of the camera during runtime you should use the SetValue genie to create a new IP Address button with the Label IP Address and the Variable as IpAddress See Genies for more information on the genies included with the PELCO Viewer ActiveX Control Similarly you can create buttons objects for the following camera properties e Camera IP address e Camera port number e Camera number e Unicast stream e Un
14. LCO IP cameras and PELCO Sarix cameras PELCO device In this document PELCO device refers to PELCO RTP and RTSP cameras PTZ Pan Tilt and Zoom R RAM Random Access Memory RTP Real Time Transport Protocol 63 Glossary RTSP Real Time Streaming Protocol S Sarix A new camera imaging technology developed by Pelco SCADA Supervisory Control and Data Acquisition In this document SCADA refers to Vijeo Citect Citect SCADA or CitectFacilities 64 Index COM issues A ActiveX control installing adding buttons Alarm link issues AutoConnect property Bandwidth property buttons adding buttons connect and disconnect C camera availability camera control with Cicode camera control with mouse camera management page example project camera number camera port number camera preset positions camera properties camera properties reading and writing camera scan sequences camera tour operations camera configuring in design time CameraNumber property cameras RTSP amp Sarix supported Cicode controlling the camera concurrent video streams Connect method connecting to a camera control methods controlling the camera with mouse controls adding 26 28 58 18 26 62 40 40 26 26 20 28 36 20 20 34 40 44 35 35 24 41 36 13 47 17 47 26 47 36 26 D debugging checklist debugging procedure DirectX Disconnect method disconnecting from a camera
15. PELCO Camera and SCADA Integration Guide PELCO Viewer v3 0 May 2011 Legal Notice DISCLAIMER Schneider Electric Australia Pty Ltd makes no representations or warranties with respect to this manual and to the maximum extent permitted by law expressly limits its liability for breach of any warranty that may be implied to the replacement of this manual with another Further Schneider Electric Australia Pty Ltd reserves the right to revise this publication at any time without incurring an obligation to notify any person of the revision COPYRIGHT Copyright 2011 Schneider Electric Australia Pty Ltd All rights reserved TRADEMARKS Schneider Electric Australia Pty Ltd has made every effort to supply trademark information about company names products and services mentioned in this manual Citect CitectHMI CitectFacilities PELCO Vijeo Citect Vijeo Citectlite and CitectSCADA are registered trademarks of Schneider Electric Australia Pty Ltd IBM IBM PC and IBM PC AT are registered trademarks of International Business Machines Corporation MS DOS Windows Windows NT Windows Vista Windows 7 Microsoft and Excel are either registered trade marks or trademarks of Microsoft Corporation in the United States and or other countries All other brands and products referenced in this document are acknowledged to be the trademarks or registered trademarks of their respective holders GENERAL NOTICE Some product n
16. System hardware 16 e A Local Area Network LAN if you want to have the client access a remote server e Microsoft DirectX 9 0 on Windows XP and 10 on Windows Vista or later e Sentinel key protection If you experience problems installing Microsoft NET framework download the full NET 3 5 SP1 installation from the Microsoft site and manually install it then run the PELCO installation Alternatively install SCADA 7 20 which includes NET 3 5 SP1 first If you are prompted by the PELCO installer to install the INET Framework 3 5 Sp1 you will be redirected to the Microsoft download site to install it If you are directed to another version of the INET Framework please choose the NET Framework 3 5 Service Pack 1 from the web page to ensure successful installation and function of the PELCO Viewer Alternatively install SCADA 7 20 which includes NET 3 5 SP1 before installing PELCO Software installed with the PELCO Viewer ActiveX Control e ATL Security The PELCO Viewer is a resource intensive component and as such hardware that meets the recommended requirements should be selected for a SCADA client The ActiveX control requires DirectX 3D Acceleration enabled hardware where video stream rendering is handled by an external processor and RAM configuration on the graphics card The following hardware is recommended for a computer that is used as a client running PELCO camera video stream The display adapters listed below have been te
17. V Dome Spectra IV IP Spectra IV Dome Spectra IV IP Spectra IV PND 35X Spectra IV IP Sarix IXE20C Sarix IX10DN Sarix IXSODN Spectra HD Sarix D5118 Chapter 1 PELCO Viewer Usage 14 Chapter 2 Installing the PELCO ActiveX Control Minimum hardware and software requirements for PELCO Viewer ActiveX Controls for Microsoft Windows XP Microsoft Windows Vista and Microsoft Windows 7 must be met in order to install and run the PELCO Viewer ActiveX Control A WARNING SYSTEM STABILITY The Pelco Viewer ActiveX Control must be installed on a SCADA display client to avoid addi tional CPU and memory overhead on the SCADA server Failure to follow these instructions can result in death serious injury or equip ment damage Installation requirements System software This section describes the requirements for hardware operating system software and sys tem configuration prior to installing the PELCO Viewer ActiveX Control The following system software is required on any computer onto which you want to install the PELCO Viewer ActiveX Control Supported operating systems Windows XP Professional with Service Pack 3 32 Bit and 64 Bit Windows Vista with Service Pack 2 32 Bit and 64 Bit Windows 7 with Service Pack 1 32 Bit and 64 Bit Other software e SCADA 7 00 or later e Microsoft NET Framework 3 5 SP1 e Microsoft Visual C 2008 Redistributable SP1 Chapter 2 Installing the PELCO ActiveX Control
18. ages may appear in this manual or on the prod uct to warn of potential hazards or to call attention to information that clarifies or sim plifies a procedure A lightning bolt or ANSI man symbol in a Danger or Warning safety label on the product indicates an electrical hazard which as indicated below can or will result in personal injury if the instructions are not followed The exclamation point symbol in a safety message in a manual indicates potential per sonal injury hazards Obey all safety messages introduced by this symbol to avoid pos sible injury or death ANSI man Exclamation Point A DANGER DANGER indicates an imminently hazardous situation which if not avoided will result in death or serious injury A WARNING WARNING indicates a potentially hazardous situation which if not avoided can result in death or serious injury Safety Information A CAUTION CAUTION indicates a potentially hazardous situation which if not avoided can result in minor or moderate injury CAUTION CAUTION used without the safety alert symbol indicates a potentially hazardous situation which if not avoided can resultin property damage Please Note Electrical equipment should be installed operated serviced and maintained only by qualified personnel No responsibility is assumed by Schneider Electric Australia Pty Ltd for any consequences arising out of the use of this material Before You Begin SCADA stands
19. amera Hide Toolbar controls Show Hide Toolbar 35 Chapter 5 Further Viewer Features Hide Status Bar Show Hide Status Bar PELCO Viewer mouse controls The PELCO Viewer allows the camera to be directly moved using mouse controls Click and hold the left mouse button e Move the mouse left to move the camera to the left e Move the mouse right to move the camera to the right e Move the mouse up to move the camera up if the Reverse Tilt check box is clicked the camera will move down instead e Move the mouse down to move the camera down if the Reverse Tilt check box is clicked the camera will move up instead Use the mouse scroll wheel to zoom the camera near and far Note Mouse controls for Spectra HD Sarix cameras may have slow response times To avoid this use the buttons on the toolbar instead RTSP and Sarix cameras 36 Real Time Streaming Protocol or RTSP is an application level protocol for control over the delivery of data with real time properties RISP provides an extensive framework to enable controlled on demand delivery of real time data such as video Sources of data can include both live data feeds and stored clips This protocol is intended to control multiple data delivery sessions provide a means for choosing delivery channels such as UDP multicast UDP or TCP and provide a means for choosing delivery mechanisms based on RTP RFC 1889 Sarix cameras have an RTSP server in the camera
20. ames used in this manual are used for identification purposes only and may be trademarks of their respective companies PLEASE NOTE Electrical equipment should be installed operated serviced and maintained only by qualified personnel No responsibility is assumed by Schneider Electric Australia Pty Ltd for any consequences arising out of the use of this material 2011 Schneider Electric Australia Pty Ltd All Rights Reserved Validity Note The present documentation is intended for qualified technical personnel responsible for the implementation oper ation and maintenance of the products described It contains information necessary for the proper use of the prod ucts However those who wish to make a more advanced use of our products may find it necessary to consult our nearest distributor in order to obtain additional information The contents of this documentation are not contractual and in no way constitute an extension to or restriction of the contractual warranty clauses Contact Schneider Electric today at www schneider electric com vijeocitect Contents Legal Notice aa 2 SS 3 INITOQUGHON een 7 Safety Information 22222 2222 nn 9 Chapter 1 PELCO Viewer Usage ee a 13 Supported PELCO cameras ccccscc scccescscssssceessssscececescoc 13 Chapter 2 Installing the PELCO ActiveX Control
21. cal network Improve net work speed Symptom Video streaming not working on Sarix camera Possible Issue Is it working in Web browser Have you set RtspMode property to true at runtime Have you set RtspURL property to correct value at runtime Remedial Action If no please refer to PELCO manual or contact PELCO support If yes try connecting the camera from PELCO Diagnostic Player If no set RtspMode property to true non zero value at runtime and try again If yes continue If no set RtspURL property to the correct value at runtime and try again The default format of this property is Rtsp Camera_IP_ Address stream1 Chapter 8 Troubleshooting Symptom Two or more video streams not working on same page Possible Issue Caused by conflicting object names assigned to the PELCO Viewer ActiveX Con trol object Caused by conflicting object names used in Cicode Con nect function Caused by conflicting uni casting port numbers Symptom Poor image quality Remedial Action Rename conflicted object name assigned to the PELCO Viewer ActiveX Control object Rename conflicted object name used in Cicode Connect function Resolve conflicted uni casting port number Any uni casting port number can only be used once Possible Issue Remedial Action Image is not Adjust focus focused Bandwidth is too Increase camera bandwidth low There is not Replace current graphics card comput
22. cameras The key to implementing a PELCO camera link is to use Cicode to run the Pre set method provided by the PELCO Viewer ActiveX Control programming interface An example is provided to demonstrate this feature Example In this example there is a PELCO PTZ camera in the front entrance of an office and a PIR sensor installed to trigger the alarm To configure the Alarm Link 1 Configure the camera s preset for example 15 to point to the front entrance where the PIR sensor will be triggered when the area is armed or secured 2 Create a digital alarm tag for example PIRTrigged 31 Chapter 4 PELCO Example Project Genies 32 3 Create a digital alarm 4 Add a Cicode function as below FUNCTION FrontEntranceAlarmLink OBJECT hPELCOPTZ ObjectByName PELCOCam INT preset 15 IF PIRTrigged 1 THEN FODTSCECSSIMSENOCI VAPERERCOPNZ Prese ERUN prese ca END END If necessary add a button to toggle the alarm at runtime Save compile and run the project 5 6 7 Open the camera page 8 Make sure the camera is not pointing to the previously configured preset 9 Trigger the alarm and check the change in the PELCO Viewer To simplify project creation additional genies have been included in the example project for e function used to call functions inside the ActiveX control on the one camera page e setValue used to create buttons and text objects to change the properties
23. can result in death serious injury or equip ment damage Popup Menu Controls 34 The popup menu toolbar allows additional controls and configuration of camera fea tures Right click the PELCO Viewer to display the following options Pattern Operation The Pattern menu will appear when connected to a SpectralV camera Pattern Run Runs the specified pattern Pattern gt Record Begins recording a new pattern Pattern gt End Record Stops the current recording process Click the Stop button in the PTZ Toolbar to stop the Pattern Operation Preset Operation The Preset menu will appear when connected to a camera equipped with PTZ functions Preset gt Run Runs the specified preset Preset gt Set Sets the selected preset to the current camera position Preset gt Delete Deletes the specified preset Preset gt Home Runs the currently configure home preset Preset gt Configure Home Preset Allows specification of which preset represents the home position Note The number of presets that can be configured from PELCO ActiveX is 1 256 based on the camera preset limit Chapter 5 Further Viewer Features Scan operation The Scan menu will appear when connected to a SpectralV camera equipped with PTZ functions There are three built in scan sequences auto random and frame The default is auto which is a sequential scan e Scan gt Scan Random Continuously rotates the cam
24. ce PELCO cameras behind a firewall when they are connected to a network e Install the latest version of the PELCO Viewer ActiveX Control Debugging procedure 56 Generally there are three types of functions to analyse e Camera hardware setup or network related e PELCO Viewer ActiveX and its dependencies software setup configuration related e PELCO Viewer ActiveX configuration setup in SCADA projects during SCADA project configuration or runtime The procedure listed below will help you identify the type of issue and assist with debug ging 1 Is the camera a PELCO camera This manual addresses issues with PELCO cameras only 2 Can you view the video stream in Internet Explorer If not there may be an issue with the camera installation or network 3 Can you view the video stream in PELCO Diagnostic Player If not there may be an issue with the PELCO Viewer installation Re install and con figure the PELCO Viewer and try again 4 Can you view the video stream in SCADA runtime If not there may be some project related issue preventing access to the video stream Try to connect to the camera using the PelcoExample test project See the Troubleshooting Guide section for information Enabling event logs A WARNING REGISTRY CORRUPTION Chapter 8 Troubleshooting Do not attempt to modify registry settings unless you are an expert user of the Windows oper ating system and SCADA or are under the direct guidance of te
25. chnical support for this prod uct Failure to follow these instructions can result in death serious injury or equip ment damage To enable event logs open a registry editor and make the following change 1 2 3 In Windows Run Command type regedit Navigate to HKEY LOCAL MACHINE SOFTWARE Schneider Electric Pelco Set the Log Value key to 1 to enable event logging and 0 to disable event log ging Troubleshooting guide Symptom NET Framework 3 5 SP1 fails to install through web directly Possible Issue Remedial Action A port may be Download the full package of NET 3 5 SP1 manually and install it blocked from down before installing Pelco Viewer The full version can be downloaded loading and install from the Microsoft website ing the installer directly from web Installer might launch a link to download NET ver sion other than 3 5 SP1 57 Chapter 8 Troubleshooting Symptom During Uninstalling PelcoViewer an error message saying Error 1001 InstallUtilLib dll Unknown error is appearing Possible Issue The necessary NET version missing Remedial Action Install NET Framework 3 5 SP1 and un install Pelco Viewer Symptom In case of COM errors or Runtime values for tags not getting updated refreshed Possible Issue Sample project restore pages update issues Remedial Action Run Computer Setup wizard or navigate to another page and then return
26. d to PELCO camera projects you will need either direct or indirect access to a PELCO IP or Sarix camera Be aware that if the camera is accessed over the Internet you will experience poor streaming quality and very poor responsiveness to the camera controls Essential tools utilities There are some tools and utilities recommended to assist in analysing the functionality of PELCO camera on SCADA projects e PELCO Device Utility Assists in locating a PELCO camera IP address on your net work e PELCO Diagnostic Player Tests camera video rendering on the system e DXDIAG Checks the DirectX version and sets and tests Direct3D acceleration on your computer e DESK CPL Checks dedicated on board memory on your graphic card e Wireshark Checks network communication between your computer and PELCO camera e Intel UPnP Device spy Locates the PELCO RTP camera IP address and port number 55 Chapter 8 Troubleshooting Implementation checklist Before debugging you system please go through the checklist below to make sure that the PELCO camera has been implemented optimally e The Hardware and software requirements in the Installation Requirements have been met or exceeded e Only PELCO IP or Sarix cameras have been tested and are supported e Only use a cable modem router or a switch with a DHCP server when installing PELCO IP cameras on a network e Do not use a HUB in the network setup of an IP camera e Pla
27. e Where PELCOCam is the object name of a PELCO Viewer ActiveX Control instance inserted on a graphics page FUNCTION SetVelocityHorizontal OBJECT hPELCOPTZ ObjectByName PELCOCam INT oldSpeed ObjectGetProperty hPELCOPTZ VelocityHorizontal INT newSpeed StrToInt Input Velocity Horizontal Enter pan speed old Speed _ObjectSetProperty hPELCOPTZ VelocityHorizontal newSpeed END 45 Chapter 6 PELCO Viewer ActiveX Control Interface Properties 46 Chapter 7 PELCO Viewer ActiveX Control Inter face Methods The PELCO Viewer ActiveX Control methods are designed to give you the ability to con trol PELCO cameras automatically as much as possible For example you can auto matically switch to another camera in a viewer or to a different preset or run a pattern The list below provides some tasks that can be achieved automatically e Switch cameras in a viewer e Send focus or commands e Send PTZ commands to a PELCO PTZ camera e Send iris close open commands e Send create go to delete preset commands e Record and run patterns In this section available methods have been categorised and listed for each category Additional details on how to use these methods in each category are provided in the examples The main categories for methods are e Connection methods e Customize User Interface methods e PTZ methods e Preset methods e Pattern methods Connection Methods
28. e Home position that has been selected for the camera The table below contains preset methods for the PELCO Viewer ActiveX Control inter face in this release Chapter 7 PELCO Viewer ActiveX Control Interface Methods Method Name Description PresetDelete long presetld Deletes the specified preset ID PresetSet long presetld Stores the current camera position pan tilt and zoom level at the specified preset ID PresetHomeSet Stores the current camera position and zoom level as the home preset ID defaults to preset ID 3 This is the Preset ID that is run when the Home button is clicked PresetRun long presetld Moves the camera to the location and zoom level stored at the specified preset ID PresetHomeRun Moves the camera to the location and zoom level stored in the home preset ID defaults to preset ID 3 This is the preset ID that is run when the Home button is clicked Example The example below shows how to use the PresetRun method to control the PTZ camera Other preset methods can be used in the same way as this method In the example below a Cicode function has been written to run a preset position that has been pro grammed and stored into the PTZ camera PELCOCam used in the example code is the actual object name that has been assigned to the PELCO Viewer ActiveX Control object in this project FUNCTION RunPreset OBJECT hPELCOCam ObjectByName PELCOCam INT preset StrToInt Input
29. er with graphics card com enough dedicated puter that has more dedicated memory memory 61 Chapter 8 Troubleshooting 62 Symptom Slow video responsiveness Possible Issue Too many concurrent camera connections There is not enough ded icated memory Bandwidth is too high The computer specification is too low and does not meet the recommended hardware requirements Symptom Alarm link does not work Possible Issue Preconfigured preset in PELCO PTZ camera has been lost or deleted Cicode error in the project Remedial Action Reduce number of concurrent camera connections on the same page Replace current graphics card computer with graphics card computer that has more dedicated memory Reduce camera bandwidth Use a higher performance computer Remedial Action Reconfigure the predefined preset in PELCO PTZ camera Fix Cicode error in the SCADA project Glossary A ActiveX A framework for defining reusable software components that perform a particular function or set of functions in Microsoft Windows in a way that is independent of the programming language used to implement them A software application can then be composed of one or more of these components in order to provide its functionality D DVR Digital Video Recorder Iris A mechanical device found in cameras that mimics the function of the biological iris P PELCO camera In this document PELCO camera refers to PE
30. era horizontally in random incre ments Random scan being random in nature can take several seconds to commence e Scan gt Scan Frame Continuously rotates the camera horizontally in 90 Degree incre ments e Scan gt Scan Auto Continuously rotates the camera 360 degrees Click the Stop button in PTZ Toolbar to stop the scan operation Tour operation The Tour menu will appear when connected to a Sarix camera equipped with PTZ func tions e Tour gt Run Runs the specified tour Click the Stop button in the PTZ Toolbar to stop the Tour Operation Note Tours must be created using the camera s web interface For more information please refer to the PELCO Spectra HD camera user manual When creating the Tour from the web interface you must follow a strict naming convention in order to run the Tour from the PELCO Viewer The tour name must contain and start with the case insensitive word Endura AND a number afterwards The Tour names must end in a digit and the set of all digits must be consecutively numbered starting at 1 Tour Name Examples Endura Tour 1 Endura Tour 2 Endura Tour 3 Other Operations The Operation menu will appear when connected to a SpectralV camera e Operations gt Rotate 180 Degrees Pans the camera 180 degrees from its present posi tion e Operations gt Pan to Zero Pans the camera back to the camera s zero position This is not necessarily the same as the home position for the c
31. he mouse Specifies RTP camera or RTSP camera Specifies the RTSP URL if the camera is a RTSP camera Specifies whether unicast or muliticast The IP address of your local computer that the PELCO device will stream the video to The port that the PELCO device will use for unicast listening in for the video The horizontal rotation velocity setting The vertical rotation velocity setting 39 Chapter 6 PELCO Viewer ActiveX Control Interface Properties Properties AutoConnect Bandwidth 40 To be able to connect to a PELCO camera from the PELCO Viewer ActiveX control at run time the camera connection information must be specified to an object in the PELCO Viewer ActiveX control When setting properties via Cicode the values will not be per sisted when you navigate away from the page and they will need to be set again when you re open the page You can have the last values automatically set either using tags see Tag Association or using the Persist ActiveX data between page transitions option Listed below are the properties of the PELCO Viewer ActiveX Control interface in this release This property causes a configured camera to be automatically connected when the page is loaded in runtime Set to 1 to enable auto connection Data Type Digital Allowable Values e 0 AutoConnect property is Off e 1 AutoConnect property is On Default Value 0 Returns the streaming video bandwidth constraints The
32. here are any difficulties please refer to Troubleshooting your PELCO manual or con tact PELCO support to address this before proceeding further with the project 21 Chapter 2 Installing the PELCO ActiveX Control 22 Chapter 3 Connecting to a PELCO Camera from a Project There are three ways to connect to a PELCO camera from within a SCADA project e Configuring during design time e Using tag association e Using Cicode Configuring during design time The quickest method of using a PELCO camera in your project is to place the PELCO Viewer ActiveX control on a page and then configure it directly 1 Adda PELCO Viewer ActiveX control to your page see Adding PELCO Viewer Acti veX Control 2 Configure the camera s configuration properties directly in the PELCO Viewer Prop erties window see Configuring PELCO Viewer Properties 3 Compile and run the project 4 Once the project is running update your Page List from the Pages menu and then navigate to the new camera page Adding the PELCO Viewer ActiveX Control Once the PELCO Viewer ActiveX Control has been installed you can add the Viewer to your project pages In SCADA v7 20 or later open the Graphics Builder and click the Add PELCO Viewer ActiveX button on the toolbar Ta YI no In SCADA v7 10 or earlier the PELCO Viewer can be inserted by clicking on the Insert ActiveX Control button in the Graphics Builder toolbar The PELCO Viewer will be added t
33. higher the bandwidth the better the image quality the greater the processing power but the network traffic will also be greater There are three factors that affect bandwidth e The total number of cameras connected e The motion type low medium high A camera transmits actual frames and delta frames so the more the image changes the higher bandwidth used e Bandwidth type There are three types of bandwidth setting in PELCO Viewer Bandwidth Settings Frames Sec Bit Rate Gop Group of Picture High 30 2 000 000 15 Medium 30 150 000 15 Chapter 6 PELCO Viewer ActiveX Control Interface Properties Bandwidth Settings Frames Sec Bit Rate Gop Group of Picture Low 30 198 15 For more information regarding bandwidth network performance see UnicastStream property Data Type Long Allowable Values e 0 High Bandwidth e 1 Medium Bandwidth e 2 Low Bandwidth Default Value 0 CameraNumber Changes the active camera being viewed on a DVR Set this value to 1 for normal IP cameras Data Type Long Allowable Values Any valid PELCO camera number Default Value 1 CameralpAddress The IP address of the PELCO device where video is streamed from Data Type String Allowable Values Any valid PELCO camera IP address Example 192 168 0 90 CameraPortNumber The port number of the camera Data Type Long Allowable Values Any valid PELCO camera port number Default Value 49152 41 Chapter 6 PELCO Vie
34. icast stream IP address e Unicast port number e Auto Connect Adding the Connect and Disconnect function To add a connect button to your graphics page create a new button and add the label Connect Under the Input tab add the following action to the Up command _ObjectCallMethod ObjectByName PELCOCam Connect Similarly create a new button with the label Disconnect Add the following action to the Up command 26 Chapter 3 Connecting to a PELCO Camera from a Project Compiling and Running the Project After the PELCO camera page has been created in your project compile and run the project Once the project is running update your Page List from the Pages menu and then navigate to the new camera page 1 Click the IP Address button and enter the IP address of the camera 2 Enter the other required camera properties 3 Click the Connect button and the PELCO Viewer should be connected to the camera as below IP Address Camera number Unicast Steam Unicast Stream IP Unicast Stream Port Auto Comect cm E A pan tilt and zoom toolbar and popup menu are provided to control the PELCO PTZ cameras Right click the viewer window and choose to show the toolbar The PELCO PTZ camera can also be controlled by using the mouse Click and hold the left mouse button and move the mouse to control the camera See PELCO Viewer Mouse Controls for more information It is now possible
35. ient video memory as indi cated in the table below e Ensure that no more than four concurrent video sessions are streamed on a single SCADA graphics page Failure to follow these instructions can result in death serious injury or equip ment damage Depending on your computer s dedicated video memory you should experience rea sonable video stream quality performance and responsiveness providing that number of concurrent video streaming controls on the same page does not exceed the number in the table below Graphic Card Dedicated Video Max Number of Concurrent Video Memory Streaming 256 MB 512 MB Installing the PELCO Viewer ActiveX Control To install the PELCO Viewer ActiveX Control run setup exe from the installation media Follow the onscreen prompts to complete installation of the control Documentation After a successful installation the documentation is available from the Windows Start menu Start gt Programs gt Schneider Electric gt PELCO gt PELCO User Guide Verifying the camera video streaming 18 The video rendering can be verified by launching the PELCO Diagnostic Player PELCO Diagnostic Player can be launched either from the installed directory or the Windows Start menu Start gt Programs gt Schneider Electric gt PELCO gt PELCO Diagnostic Player A console window and the PELCO Diagnostic Player will be displayed At the bottom of the PELCO Diagnostic Player window click
36. maximum of 20 simultaneous clients Multicast A multicast connection sends a video stream to multiple PELCO Viewers clients at the same time using one shared transmission stream Unlike unicast multicast com munication requires much less processing power for the camera instead your network design and the type of network switches used are the important factors in the number of clients that can be supported and the performance of your system Multicast is useful only for local area networks and can be used to preserve network bandwidth For more information about network bandwidth and Switch Compatibility related infor mation please see Endura Network Design Guide and Endura Switch Compatibility When using multi cast please be aware that the video stream is sent to your primary net work adapter If you are running virtualization software on your machine it may pre vent the video stream from being sent to your primary network adapter Please see Troubleshooting for more information When a unique connection to the camera is required then select the unicast option and provide your computer s Local IP address and valid port details The video will be streamed to this IP address If this property is false then multicast streaming will be established Data Type Digital Allowable Values e 0 Unicast Stream Off Unicast Stream IP and port will be ignored e 1 Unicast Stream On Default Value 0 The IP address of your local computer t
37. n on the camera Finding the camera number In the majority of cases the default number is 1 If the camera is used in conjunction with a PELCO DVR then the camera number is assigned on the DVR Checking camera availability 20 There are two ways to check the availability of a camera from your computer using the PELCO Device Utility or using Internet Explorer Using the PELCO Device Utility You can use the PELCO Device Utility to determine availability of your camera The PELCO Device Utility can be found on the resource CD shipped with the camera For information about how to install the PELCO Device Utility please refer to the PELCO camera s documentation Chapter 2 Installing the PELCO ActiveX Control 1 Choose Start gt Programs gt PELCO gt Device Utility gt PELCODeviceUtility 2 Click the Connect button for your camera Using Internet Explorer 1 Open Microsoft Windows Internet Explorer and enter the camera s IP address in the URL field For example http 10 176 234 163 2 The login window will be displayed 3 Log in with your user name and password The defaults are admin and admin if you have not changed them 4 After the first successful login you will be prompted to install an ActiveX control on your computer Accept it and install the ActiveX control on your computer 5 Once the installation is complete your camera will be connected and video will stream in your browser If t
38. n result in death serious injury or equip ment damage A WARNING UNINTENDED EQUIPMENT OPERATION Integration of PELCO camera streaming with SCADA is provided as an aid and is not intended to replace a complete security monitoring system Failure to follow these instructions can result in death serious injury or equip ment damage For additional information refer to NEMA ICS 1 1 latest edition Safety Guidelines for the Application Installation and Maintenance of Solid State Control 11 Safety Information 12 Chapter 1 PELCO Viewer Usage The PELCO Viewer ActiveX Control is designed for the PELCO Camera Video Streaming interface in CitectSCADA CitectFacilities and Vijeo Citect The PELCO Viewer ActiveX Control provides the ability to stream video through a SCADA runtime page and control the camera Supported PELCO cameras The PELCO camera interface was developed for the Spectra IV Series IP and Sarix cam eras Current PELCO IP cameras cameras that have been launched before 31 01 2011 are sup ported with this release including the Sarix range of cameras Sarix is supported using RTSP while the remainder of the IP cameras are supported using RTP Cameras launched after 31 01 2011 are expected to work but the control has not been tested with later models The table below lists the cameras for which the Pelco Viewer ActiveX Control has been tested Camera Model Fixed IP Camera IP 3701 Spectra I
39. o which the PELCO device will stream the video 43 Chapter 6 PELCO Viewer ActiveX Control Interface Properties Data Type String Allowable Values Your local computer s IP address UnicastStreamPort The port that the PELCO device will use for Unicast listening for the video Data Type Long Allowable Values Your local computer s port number used for video stream Note Unicast stream port values should not be consecutive for different cameras on the same page because the next immediate port numbers are reserved for PTZ oper ations VelocityHorizontal VelocityVertical The horizontal rotation velocity setting Data Type Long Allowable Values Any valid PELCO camera horizontal velocity number This is for PTZ cameras only Default Value 64000 The vertical rotation velocity setting Data Type Long Allowable Values Any valid PELCO camera vertical velocity number This is for PTZ cameras only Default Value 8000 Reading and writing to properties 44 Properties listed in the previous section can be read and written at runtime with the Cicode functions _ObjectGetProperty and 0bjectsetProperty The example below shows how to modify the camera s horizontal velocity at runtime If the camera is panning too slow or too fast increase or decrease the camera s horizontal velocity at runtime accord ingly to personalise the requirements Chapter 6 PELCO Viewer ActiveX Control Interface Properties Exampl
40. o your graphics page 23 Chapter 3 Connecting to a PELCO Camera from a Project Configuring PELCO Viewer properties 24 Open the PELCO Viewer Properties window On the Access tab and Identification sub tab set the Object Name to PELCOCam On the Appearance tab and Camera Configuration Settings sub tab provide the cam era configuration details The below example shows a typical configuration for an RTP camera See PELCO Viewer ActiveX Control Interface Properties for information about these properties Click the Automatically connect to camera checkbox to automatically connect the cam era to the Viewer upon start If this checkbox is not checked the operator will have to click the Connect button to connect to the camera See Finding the Camera s IP Address Port and Number for information SE Pelco Viewer 3 0 Type Library Properties Y Appearance Li Movement ni Scaling v Access es Metadata RTP Mode Camera IP Address Camera port Service ID MM Unicast Stream Local IP Address 10 155 20 Local port 9000 RISP Mode RTSP Url lv Automatically connect to camera IV Reverse Tilt O m ao fad m O o 2 3 T E o 5 l a gt m a A o Ka gt o ANIGISIA Cancel Apply Help Chapter 3 Connecting to a PELCO Camera from a Project A WARNING INCORRECT VIDEO DISPLAYED Ensure that continuous port numbers are not used for multi
41. of the PELCO camera e pelcoCameraSelector used to manage multiple cameras on the PELCO Camera Management page See the PELCO Example Project for examples of these genies Chapter 5 Further Viewer Features The PELCO Viewer includes the following features e Pan Tilt and Zoom controls e Popup menu controls e Mouse Controls e RISP and Sarix Cameras Pan Tilt and Zoom toolbar The PELCO Viewer includes a toolbar which allows the camera to be controlled using the mouse The toolbar has the following controls Description These controls enable the camera to Pan right or left P These controls enable the camera to Tilt up or down T Stop the Pattern Tour Scan and Pan or Tilt operations Move the camera to the home position Zoom near far Z Focus near far Iris close open This toolbar can be hidden by right clicking the mouse button in the viewer window and checking Show Hide Toolbar 33 Chapter 5 Further Viewer Features A WARNING CAMERA CONTROL CONFLICT e If the PELCO cameras are being controlled exclusively through the SCADA system then ensure your SCADA system is designed to allow only one operator to perform operations on a camera at a time If the PELCO cameras are being controlled independently by multiple systems e g SCADA and Security then ensure you have a clear documented and communicated proc ess in place to ensure no camera conflict occur Failure to follow these instructions
42. ple cameras on the same page when using unicast stream Failure to follow these instructions can result in death serious injury or equip ment damage When working with two or more cameras on a single page unicast stream port values should not be continuous because the next immediate port numbers are reserved for PTZ operations For example if you have configured the unicast stream port value as 9001 for one camera and 9002 is used for the next camera then both cameras will display the same image Once the configuration is updated click the Apply button Using tag association To create a PELCO Viewer control using tag association 1 Create Tags for camera properties To be able to connect to a PELCO camera from the PELCO Viewer ActiveX Control at runtime you will need to pass the camera connection information to an object in the PELCO Viewer ActiveX Control These camera properties are stored in tags defined within SCADA For details about how to create tags please refer to the SCADA online help For example for each RTP camera the following basic camera properties must be defined e Camera IP address String type e Camera port number Long type e Camera number Long type e Unicast stream Digital type e Unicast stream IP address String type e Unicast port number Long type e Auto Connect Digital type For a full list of camera properties see PELCO Viewer ActiveX Control Interface Prop Add a P
43. presets PresetSet presetID method project compiling project testing 66 18 47 48 52 50 49 36 61 59 15 49 49 33 49 49 49 52 34 52 52 52 52 13 55 55 23 32 29 20 41 50 50 50 50 50 34 50 27 27 PTZ latency issues PTZ methods PTZ too slow or fast PTZ toolbar R reading camera properties requirements hardware operating system software video streaming return to zero position reverse camera position ReverseTilt prroperty RTSP cameras RtspMode property RtspUrl property Sarix cameras Sarix streaming not working scan sequences SetValue genie Show HideStatusbar status method ShowHideToolbar status method Slow video stream software requirements status bar show hide supported cameras T tags mapping tilting toolbar pan tilt and zoom toolbar show hide tours troubleshooting U UnicastStream property UnicastStreamIP property UnicastStreamPort property uninstall issues V VelocityHorizontal property 60 49 59 33 44 16 15 15 17 35 35 42 36 42 42 36 60 35 26 32 48 48 62 15 36 13 26 33 33 35 35 57 59 43 43 44 58 44 Index VelocityVertical property video streaming requirements W writing camera properties Z zero position ZoomIn method zooming ZoomOut method ZoomStop method 44 17 44 35 49 33 49 49 67 Index 68
44. r inter face The table below contains customization methods for the PELCO Viewer ActiveX Control interface in this release Method Name Description ShowHideStatusbar bool Show or hides the status bar status ShowHideToolbar bool status Show or hides tool bar for PTZ cameras 48 PTZ Methods Chapter 7 PELCO Viewer ActiveX Control Interface Methods PTZ methods are used to pan tilt and zoom a PELCO PTZ camera and are not appli cable to fixed cameras If the camera supports it it can also change the focus and iris on any camera that support those functions programmatically The table below contains the PTZ methods for PELCO Viewer ActiveX Control in this release Method Name Description PanLeft PanRight PanUp PanDown PanStop Zoomin ZoomOut ZoomStop FocusNear FocusFar FocusStop FocusAuto IrisOpen IrisClose IrisStop IrisAuto Start panning the camera to the left PanStop is required to stop the camera panning Start panning the camera to the right PanStop is required to stop the camera panning Start tilting the camera up Start tilting the camera down Stop panning the camera Start zooming the camera in Start zooming the camera out Stop zooming the camera Start focusing the camera on objects that are closer Start focusing the camera on objects that are farther Stop focusing the camera Auto focus the camera
45. s see Troubleshooting which contains information on testing the camera using the PELCO software Note Check that the ports are not blocked by the network administrator and that the IP addresses are accessible 19 Chapter 2 Installing the PELCO ActiveX Control Finding the camera s IP address port and number Finding the IP address You can use the PELCO Device Utility to determine the IP address of your camera The PELCO Device Utility can be found on the resource CD which is shipped with the cam era For information about how to install the PELCO Device Utility please refer to the PELCO documentation 1 Choose Start gt Programs gt PELCO gt Device Utility gt PELCODeviceUtility 2 Your camera s IP address will be shown after the PELCO Device Utility has started 3 If the camera s IP address is still not shown then click the Search Now button and your camera should be detected by the utility 4 If your camera s IP address is still not shown make sure it is connected to your net work and that the camera is not blocked by your network In some cases the addresses are blocked by network administrators or local network rules Finding the port number PELCO IP cameras usually have default ports of either 49152 or 49157 A different port number can be assigned For further information please refer to your PELCO camera s manual Alternatively reset the values to the factory defaults with the reset butto
46. sted Some graphics cards may provide poor quality video and in some circumstances loss of colour and pixelation See Video Streaming Performance for more information on the impact of concurrent video streams on graphics card performance The following tables indicate the computer hardware requirements for the SCADA PELCO ActiveX installation Chapter 2 Installing the PELCO ActiveX Control Minimum hardware requirements Description Processor Type Processor Speed RAM Graphics Adapter Minimum specification Intel Pentium 4 2 GHz 1 GB 256 MB dedicated video memory Recommended hardware requirements Description Processor Type Processor Speed RAM Graphics Adapter Recommended specification or higher Intel Core 2 Duo CPU E7500 2 93 GHz 4 GB ATI Radeon HD 3450 Dell Optiplex NVDIA GeForce Go 7400 ATI Radeon HD 3450 Pro 1 GB or more dedicated video memory Note It is recommended that you run the PELCO interface on dedicated clients and not on any of the other I O Alarm or Report Servers Video streaming performance Video streaming with DirectX requires a lot of CPU memory and especially dedicated on board video memory The more dedicated on board video memory the more con current video streaming connections can be supported 17 Chapter 2 Installing the PELCO ActiveX Control A WARNING POOR PERFORMANCE e The PELCO Viewer requires a graphics adapter with suffic
47. the Configuration button to launch the Network Stream Settings dialog box Chapter 2 Installing the PELCO ActiveX Control A WARNING DELAYED OR INCORRECT VIDEO Ensure that cameras are configured to overlay the time stamp amp camera information on the video stream to assist operators in correctly identifying the camera and the time at which the image was relayed Failure to follow these instructions can result in death serious injury or equip ment damage If using RTP mode to connect to the camera please ensure you enter valid values for e Camera IP address e Camera Port default is 49152 check camera manual e ServicelD set to 1 default camera number Optionally enter valid values for e Local IP address e Local Port default is 9102 e Select the unicast check box If using RTSP mode to connect to a Sarix camera the connection can be established using the following RTSP URL RTSP lt IP Address gt stream1 Note stream1 or stream2 is required as a string to connect to the camera Press the Connect button The PELCO Diagnostic Player window should display live video streamed from your camera If the viewer is not showing live video image from your camera that is the player shows the default PELCO screen then the camera is not connected Please make sure that all required software is installed on your computer and that the correct IP addresses and ports are used If the lack of connection persist
48. to the page causing update issues Symptom Application hangs on some invalid IP address input A WARNING REGISTRY CORRUPTION Do not attempt to modify registry settings unless you are an expert user of the Windows oper ating system and SCADA or are under the direct guidance of technical support for this prod uct Failure to follow these instructions can result in death serious injury or equip ment damage Possible Issue Web service not returning the values 58 Remedial Action Follow the below steps 1 Open Registry editor 2 Navigate to HKEY LOCAL MACHINENSOFTWARENSchneider Electric Pelco path 3 Change the value for ConnectionTimeout The values can be between 5 30 in seconds Chapter 8 Troubleshooting Symptom RTP camera has no video at runtime Possible Issue Are the camera IP address port number and cam era number cor rect Is it working in Web browser You are using multi cast and have virtualization software installed such as VMWare Remedial Action Use Intel UPnP Device spy to check your camera IP address and port number The port number usually has a default value 49152 and camera number should be 1 If not if they are different from camera IP address and port number reported by Intel UPnP Device spy try the new IP address and port number If yes they are the same or there is still no video image when trying the new values then continue
49. wer ActiveX Control Interface Properties HomePresetld ReverseTilt RtspMode RtspUrl 42 Camera preset ID used for the home position button on the PTZ control Data Type Int Allowable Values Any valid PELCO camera preset number Default Value 3 This property allows the user to reverse the tilt direction when using the mouse during RTP streaming Data Type Digital Allowable Values e 0 Reverse Tilt property is Off e 1 Reverse Tilt property is On Default Value 0 Specifies the type of camera connected either RTP or RTSP Data Type Int Allowable Values e 0 RTP camera e 1 RTSP camera Default Value 0 Provides the RTSP URL if the camera is a RISP camera Dependent on the configuration of the RTSP camera Data Type String Allowable Values Any valid PELCO Sarix camera URL Example rtsp 192 168 0 18 stream1 UnicastStream UnicastStreamIP Chapter 6 PELCO Viewer ActiveX Control Interface Properties Specifies either a unicast or multicast streaming type Unicast A unicast connection sends a separate video stream from the camera to each Pelco Viewer client Although multiple Pelco Viewers might request the same data from the camera at the same time a unique separate video stream is transmitted to each Pelco Viewer Every unicast connection to the camera consumes additional processing power which limits the number of simultaneous clients which can access the camera PELCO cameras support a
50. xample above FUNCTION RunPanLeft OBJECT hPELCOPTZ ObjectByName PELCOCam _ObjectCallMethod hPELCOPTZ PanLeft END FUNCTION RunPanStop OBJECT hPELCOPTZ ObjectByName PELCOCam _ObjectCallMethod END NPEHNGOBBZI UN PanS opi Chapter 3 Connecting to a PELCO Camera from a Project Saving settings between page transitions When you set properties on the PELCO Viewer control from Cicode and move off the page your changes will be lost This behavior is not always what you want so the Graphics Builder provides a Persist ActiveX data between page transitions option to save the state of an ActiveX control when you switch between pages Enabling this option causes SCADA to write a temporary file to the Data directory in the format of Event class stg whenever you leave a page that contains an ActiveX object for example the PELCO Control When you reenter the page SCADA looks for that same file and if found will load the settings from it These files only exist while SCADA run time is running When you shut down SCADA the temporary stg files are deleted To save between page transitions 1 Double click the PELCO ActiveX control you want to change The Properties dialog box appears 2 Click the Access tab 3 Click the Identification tab The Identification panel appears 4 In the Persistence area select the Persist ActiveX data between page transitions check box and then click Appl
51. y 29 Chapter 3 Connecting to a PELCO Camera from a Project 30 Chapter 4 PELCO Example Project To test the PELCO cameras in the SCADA system a PELCO Example Project has been included in the installation Example projects are provided in XP Style Compatible with v7 v7 10 and v7 20 and Tab Style v7 20 They can be found in the Projects sub folder of your chosen installation folder After the project has been restored and compiled enter the connection details on the page and connect to the camera The PELCO Example project gives examples of one two and four cameras the Sarix camera and Camera Management Some genies have been developed to help you get started The project can be expanded to cover more cameras and the genies can be reused in your own projects The PELCO PTZ toolbar and popup menu are provided to control the camera s posi tion as well as mouse and customized control buttons PELCO Camera Management page The PELCO Camera Management page can be used to add or edit PELCO camera infor mation such as name description IP address port number RISP mode RTSP URL and bandwidth Camera information is stored in the database files in the projects folder This functionality can also be used to test the camera video stream in order to make sure the information is valid after camera information is added or edited Camera Alarm Link Alarm link provides a convenient way of integrating the alarm system and PELCO PTZ
Download Pdf Manuals
Related Search