VIS 300/400 EN Setup Software Operation Manual 10407 Rev.
Page iii Notice The material contained in this manual consists of information that is proprietary to JAI PULNiX, Inc., and may only be used by the purchasers of the product. JAI PULNiX, Inc. makes no warranty for the use of its product and assumes no responsibility for any errors which may appear or for damages resulting from the use of the information contained herein. JAI PULNiX, Inc. reserves the right to make changes without notice.
Page iv WARNING Changes or modifications to this unit not expressly approved by the party responsible for FCC compliance could void the user’s authority to operate the equipment. VIS 300/400 EN Setup Software JAI PULNiX, Inc. 625 River Oaks Parkway San Jose, CA 95134 Tel:(408) 383-0300 Tel:(800) 445-5444 Fax:(408) 383-0301 E-mail: imaging@jaipulnix.com www.jaipulnix.
Table of Contents 1 Document Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2 Installation and Operation 2.1 Installation ............................3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 2.1.1 System Requirements 2.1.2 Locating the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 2.
Page vi Appendix 2.5.5 =>Refresh Properties (toggle function) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.5.6 Property grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.6 Video Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.6.1 Video Menu Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 File=>Open… . . . . . . . . . . . . . . . . . . . . .
Page vii Appendix 2.6.11 Image Properties Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 2.6.12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Manual Exposure Window 42 Shutter Value: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Gain Value: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 VTop/VBottom Values: . . . . . . . . . . .
Page viii VIS 300/400 EN Setup Software
Page ix List of Figures FIGURE 1. FIGURE 2. FIGURE 3. FIGURE 4. FIGURE 5. FIGURE 6. FIGURE 7. FIGURE 8. FIGURE 9. FIGURE 10. FIGURE 11. FIGURE 12. FIGURE 13. FIGURE 14. FIGURE 15. FIGURE 16. FIGURE 17. FIGURE 18. FIGURE 19. FIGURE 20. FIGURE 21. FIGURE 22. FIGURE 23. FIGURE 24. FIGURE 25. FIGURE 26. FIGURE 27. FIGURE 28. FIGURE 29. FIGURE 30. FIGURE 31. FIGURE 32. FIGURE 33. FIGURE 34. FIGURE 35. FIGURE 36. FIGURE 37. FIGURE 38. FIGURE 39. FIGURE 40. FIGURE 41. FIGURE 42. FIGURE 43. FIGURE 44. FIGURE 45.
Page x FIGURE 50. FIGURE 51. FIGURE 52. FIGURE 53. FIGURE 54. FIGURE 55. FIGURE 56. FIGURE 57. FIGURE 58. FIGURE 59. FIGURE 60. FIGURE 61. FIGURE 62. FIGURE 63. FIGURE 64. FIGURE 65. FIGURE 66. FIGURE 67. FIGURE 68. FIGURE 69. FIGURE 70. FIGURE 71. Manual Exposure Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Image Processing Context Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Vehicle Detector Settings . . . . . . . .
November 8, 2006 JAI PULNiX Intelligent Transportation Systems Vehicle Imaging System 300 and 400 (VIS 300/400) EN Setup Software Operation Manual VIS 300/400 EN Setup Software
Page 2 Document Overview 1 Document Overview This document describes the EN Setup program for the VIS CAM 300/400 Vehicle Imaging System. The functionality described in this document is based on released version 1.2.0 of ENSetup. The EN Setup Program is used for configuring, adjusting and aligning the cameras as well as viewing and analyzing the images. Tools are found for adjusting zoom and focus and aligning roll and tilt. Images can be viewed, saved and printed.
Page 3 Installation and Operation 2 Installation and Operation 2.1 Installation To install the program follow the EN Setup Install Shield Wizard. The install program adds a shortcut to the desktop and in the “Start->All Program” menu. 2.1.1 System Requirements • Windows XP installed with Service Pack 2 • Microsoft .NET Framework 2.0 Note: Microsoft .NET Framework 2.0 installation is required prior to ENSetup software installation. The .
Page 4 Installation and Operation The last User name is automatically filled in the next time the program is started. Tip If the password is removed for the last selected user, then ENSetup will startup without displaying the Login Dialog. By holding the Shift key down during startup, the Login dialog will be forced to be displayed anyhow so the current user can be changed! There are three user levels: Restricted user, Supervisor and Administrator. Adding users and user levels are described in section 3.
Page 5 Installation and Operation FIGURE 4. 2.4.3 (a) EN Camera File Menu Bar Options File=>Open Camera This command opens a specific camera by specifying an IP-address. This option is useful if the camera is not on a local subnet and therefore not found automatically during a search (Section 2.3 on page 4). This will open an “Open Camera” dialog where the IP-address can be typed in. FIGURE 5. 2.4.
Page 6 Installation and Operation FIGURE 6. 2.4.4 (b) Tools Menu View Error Log The View Error Log command opens a new window where all errors and information messages from the cameras and ENSetup are shown (see section 2.5 for details) 2.4.5 Help Menu Bar 2.4.5 (a) About The About command shows the program version and a link to an Internet site where the latest version of the program can be down loaded. FIGURE 7. About Command 2.
Page 7 Installation and Operation FIGURE 8.
Page 8 Installation and Operation 2.5.1 Camera Property Menus Using the commands on the File menu the camera properties can be Imported or Exported from or to files, or printed out. FIGURE 9. 2.5.1 (a) Camera Property File Menu File=>Import Settings from File to Camera The Import Settings from File to Camera command opens a file-open dialog box for selecting the camera-settings file to import into the selected camera.
Page 9 Installation and Operation 2.5.1 (c) File=>Page Setup The Page Setup command opens a dialog box for selecting paper format. FIGURE 10. Page Setup Dialog Box. 2.5.1 (d) File=>Print Preview shows the print on the screen before printing FIGURE 11. A preview of the image being sent to the printer.
Page 10 Installation and Operation 2.5.1 (e) File=>Print sends the print job to the printer 2.5.1 (f) File=>Exit exits the program. 2.5.2 Menu Bar Edit Commands FIGURE 12. Edit Commands 2.5.2 (a) Edit=>Copy Settings from Camera This command will copy the current settings from the selected camera into memory so it later on can be pasted into other cameras. This makes it very easy to copy system specific settings from one camera to many other cameras.
Page 11 Installation and Operation FIGURE 13.
Page 12 Installation and Operation 2.5.3 (a) Context menus Right-side clicking the mouse on the camera-tree side of the CAMERA PROPERTIES window activates the context menus. The menu is shown in Figure 2.14 and applies for the camera(s) selected. FIGURE 14. Camera Properties Context Menu 2.5.3 (b) =>Search for Cameras This command starts a new search for cameras on the local network. The message box below is shown when ENSetup opens the connections. FIGURE 15.
Page 13 Installation and Operation 2.5.4 => Advanced Settings Sub Menus This command opens up a sub-menu with all available advanced settings. FIGURE 16. Advanced Settings Sub-Menu 2.5.4 (a) =>Advanced Settings=>Save/Restore Settings inside Camera(s)=>Save Settings into Flash Memory This command saves the current setting in the camera as shown by EN Setup into the cameras flash memory. The camera will then start up with these settings next time it reboots. 2.5.
Page 14 Installation and Operation need to be setup then please use the Advanced Settings=>Copy Settings from Camera and Advanced Settings=>Paste Settings to Camera(s) instead! 2.5.4 (e) =>Advanced Settings=>Copy Settings from Camera This command will copy the current settings from the selected camera into PC memory so it later on can be pasted into other cameras. This makes it very easy to copy system specific settings from one camera to many other cameras.
Page 15 Installation and Operation 2.5.6 Property grid The listings in the property grid of the CAMERA PROPERTIES can be shown in alphabetic order or categorized in 9 categories as shown in Figure 17 on page 15. Each category can be expanded by clicking on the “+” in front of the category number and compressed by activating the “-”. When a category is selected a description is shown in the bottom of the window. FIGURE 17.
Page 16 Installation and Operation When a category is maximized the values are shown as in Figure 18 on page 16. Some values can be setup by the user and some are read-only (indicated by grey color text) FIGURE 18.
Page 17 Installation and Operation FIGURE 19. Property Description in the Bottom of the Window Editing the value field can be done via a drop list as shown in Figure 20 on page 17. Clicking the primary mouse button on the value field activates the drop list and the function can be chosen from the list. FIGURE 20. Editing the Value Field The drop list can also be a checked drop list as shown in Figure 21 on page 17. FIGURE 21.
Page 18 Installation and Operation 2.6 Video Window The VIDEO WINDOW is shown in Figure 23 on page 18. The left side of the window shows a tree-view of the cameras found (Section 2.3 on page 4 and Section 2.4 on page 4). The right side of the window is the video image. In the top of the window is a toolbar with commands and in the bottom of the window is a status line.
Page 19 Installation and Operation 2.6.1 Video Menu Menus FIGURE 24. Video Window File Menu Bar 2.6.1 (a) File=>Open… This command opens a file in the VIDEO WINDOW. This can be used for analyzing saved images. The value for some of the image tags will be displayed on-screen when the files are opened. TIP Using drag-and-drop from e.g. explorer can also open Images. It is possible to easily browse between the selected images using the arrow-keys or the mouse scroll button.
Page 20 Installation and Operation 2.6.2 Edit Menu Menus FIGURE 25. Video Window Edit Menu Bar 2.6.2 (a) Edit=>Copy This command copies the image in the VIDEO WINDOW to the clipboard for pasting to other programs (Word, Paint etc.) 2.6.2 (b) Edit=>Paste This command inserts the image from the clipboard to the VIDEO WINDOW TIP Using drag-and-drop from e.g. explorer can also open Images. 2.6.3 View Menu Menus FIGURE 26. Video Window File Menu Bar 2.6.
Page 21 Installation and Operation 2.6.3 (d) View=>Use TCP/IP This command selects if the images are transferred from the camera to the ENSetup using both TCP/IP and UDP/IP (default on test channel) or only UDP/IP on the test channel. The images transferred using TCP/IP are “real” images identical to the ones any Lane Controller would receive.
Page 22 Installation and Operation 3. Timestamp (UTC) 10:56:34.897 4. TST (test) image captured from the “test-channel” (UDP transfer between camera and PC) 5. JPEG compressed image Note: The image tags are generated inside ENSetup! FIGURE 29. Filename Example 2: Explanation: 1. IP address of the camera: 10.0.0.101 2. Date image was captured: May 31st, 2006 3. Timestamp (UTC) 10:56:34.897 4. Second image in sequence 5.
Page 23 Installation and Operation 2.6.4 (b) Capture=>Capture folder … This command selects the folder to where the captured images are saved 2.6.4 (c) Capture=>Select Image Encoder This command selects which encoder to be used when captured images are saved. The format of the image saved can be selected from a popup window drop list (Built in JPEG, TIFF, PNG, BMP and GIF). FIGURE 31. Select Encoder Menu 2.6.
Page 24 Installation and Operation FIGURE 32. Video Window Tree View Menus 2.6.5 (b) =>Search for cameras This command starts a new search for cameras on the local network. The OPENING NEW CAMERAS message box (see Figure 15 on page 12) is shown while searching for cameras If any IP-address problems are detected then a window will be displayed and it will be possible to correct these problems (see appendix B for a description on how to correct IP-address problems). 2.6.
Page 25 Installation and Operation 2.6.5 (f) =>Image Processing This command opens a new window that displays the image processing tools for the image displayed in the Video Window. Using this Image Processing it is possible to adjust the Gamma-correction, Brightness, Contrast and Saturation on the displayed images. This will not change the images saved using ENSetup but the Image Processing can also be activated on the images printed out using the File Print…menu. See Section 2.6.
Page 26 Installation and Operation FIGURE 33. Video Window Context Menus 2.6.6 (b) =>Unselect Camera This command clears the current camera selection and blanks the Video Image display. 2.6.6 (c) =>View Image Properties This command opens a new window that displays the image properties for the image displayed in the Video Window. SeeSection 2.6.11 on page 39 for a full description of the Image Properties Window. 2.6.
Page 27 Installation and Operation 2.6.6 (g) Zoom Video Image It is possible to zoom in on the images displayed by dragging an area using the middle mouse-button or Alt-key plus primary mouse button. To maintain the aspect-ratio of the original image the Ctrl-key on the keyboard has to be depressed during the dragging of the zoom-area. If the Shift-key is depressed instead during the dragging of the zoom-area the zoom area will be a square box.
Page 28 Installation and Operation FIGURE 35. Display Modes The various display modes remember the trigger modes that was selected when they were displayed. If Live was selected for a camera in Full Size view, Last was selected in Half Size and Snap was selected for Quad Size, the same trigger modes are active when the various display modes are selected. (Trigger modes see Section 2.6.
Page 29 Installation and Operation FIGURE 36. Setup Tools Menu The setup tools can be configured using the Settings Dialog, see section 2.4.3.9. Roll Bar The Roll Bar is used when adjusting the camera “roll”. A horizontal line with a small vertical center line is inserted as shown in Figure 37 on page 30. This must e.g. be in line with the bumper on the car. The line can be positioned vertically by pointing the mouse on the line and holding the left-side button down and then move it to the wanted position.
Page 30 Installation and Operation FIGURE 37. Camera Roll Bar Tilt Line The Tilt Line inserts a horizontal line with two vertical zoom-markers. The camera zoom is adjusted until the license plate is displayed with the same width as the distance between the markers. The line can be positioned vertically using the mouse or arrows as described for the Roll Bar and the zoom markers can be positioned anywhere along the line. See VISCAM 300 Manual for details regarding camera adjustment.
Page 31 Installation and Operation FIGURE 38.
Page 32 Installation and Operation Focus Bar The Focus Bar is a horizontal line with same length as the distance between the Focus Marks on the Tilt Line. The line can be positioned as described under Roll Bar. When the Focus Bar is activated a FOCUS BAR WAVEFORM window is opened showing the pixel values along the Focus Bar. This is used for focus adjusting the camera. See VISCAM 300 Manual for details regarding camera adjustment. The FOCUS BAR WAVEFORM window is described in details in Section 2.6.
Page 33 Installation and Operation Measuring Box The Measuring Box is used to measure the dimension of e.g. the license plate. The box position, height and width are shown in the status bar in the bottom of the image. The size of the box can be adjusted by dragging the corner markings of the box using the mouse and dragging the center marks on the box sides can change the position. Dragging a box around the measuring box with the mouse or clicking on the box line can select the box.
Page 34 Installation and Operation 2.6.7 (c) Trigger Modes Trigger modes can be selected using the Tool bar as shown in Figure 41 or by right-side clicking the mouse in the image window activating the context menu as shown in Figure 42 FIGURE 41. Trigger Modes Via the context menu the camera can furthermore be unselected. FIGURE 42. Select Menus from the Content Window Available trigger modes are: 1. Freeze No more images is transmitted (disable trigger) 2. Snap 3.
Page 35 Installation and Operation The default trigger mode is Last and the latest UTC labelled image can always be transferred from the camera. It is possible to generate “hardware” triggers via the Ethernet by activating Eth Trig in the Tool bar or Rep Trig (toggle functions). Eth Trig generates one Ethernet trigger pulse and Rep Trig default generates one trigger pulse every second.
Page 36 Installation and Operation FIGURE 43. Video Window Settings Dialog Box 2.6.8 Status Bar The Status Bar shows tool values. The actual pixel values will be displayed in the status bar when the mouse cursor is placed over the image. If it is a Color camera each of the RGB values will be displayed. FIGURE 44. Status Bar displays the Pixel values The VIDEO WINDOW SETTINGS dialog is opened when clicking the mouse inside the Status Bar.
Page 37 Installation and Operation 2.6.9 Focus Bar Waveform The FOCUS BAR WAVEFORM window is opened when the Focus Bar is selected in the Toolbar. It can be used for adjusting the camera focus or analyzing images. FIGURE 45. Focus Bar Waveform Screen The actual pixel values along the focus bar are shown in the graph. If the focus bar is positioned across the license plate (see Figure 39 on page 32) the pixel values will reflect the grey levels of the characters and the spacing.
Page 38 Installation and Operation The column height can vary between 0 and 100%. FIGURE 46. Focus Bar Waveform Menus 2.6.9 (a) File=>Save As This command saves the graph to a file. The format of the image saved can be selected from a drop list (JPEG, TIFF, PNG, BMP and GIF) 2.6.9 (b) File=>Page Setup This command opens a dialog box for setting up paper format (see Figure 10 on page 9) 2.6.9 (c) File=>Print Preview This command shows the print on the screen before printing. 2.6.
Page 39 Installation and Operation FIGURE 47. Waveform Screen Commands. 2.6.10 Edit=>Copy This command copies the Graph to the clipboard for pasting to other programs (Word, Paint etc.) 2.6.11 Image Properties Window All images displayed and captured using ENSetup contains a number of image properties embedded inside each image. All these image properties are placed in the image files as EXIF-tags.
Page 40 Installation and Operation FIGURE 48. Image Properties Context Menu If the “Use TCP/IP” option is selected (see Section 2.6.3 (d on page 21) the ENSetup will request images from the camera using the TCP/IP LC-protocol.
Page 41 Installation and Operation FIGURE 49.
Page 42 Installation and Operation The image tags are generated inside the camera and therefore contain information such as status, Light Sensor readings, exposure settings, NTP status and other important data from the time of the image capture inside the camera. All ITS-specific information is placed in the “ITS Camera Tags” category. 2.6.12 Manual Exposure Window Normally camera parameters are optimally controlled by the light sensor, and it is not necessary to manipulate them manually.
Page 43 Installation and Operation 2.6.12 (b) Gain Value: The Gain Value setting directly control the gain applied to images captured by the CCD-sensor. The signal-to-noise ratio will be increased by lowering the gain and thereby produce images with less noise. 2.6.12 (c) VTop/VBottom Values: The VTop and VBottom values control the reference voltages used during the digitization of the pixel values from the CCD-sensor.
Page 44 Installation and Operation FIGURE 52. Vehicle Detector Settings In the Property Grid control all values can be manually changed. It will initially contain the settings read directly from the laser. To transfer any new settings to the laser, simply press the Apply button. The laser has got a built in Laser Pointer LED that can be used for aligning the laser detector. It will be switched on when the check-mark is set.
Page 45 Installation and Operation The Laser Setup dialog will be used to setup the Laser Vehicle Detector connected to the camera. To analyze the current setting press the Collect Data button. This will start a data collection and display the result in the graph. When a car triggers the laser then a new image will be collected by the camera and the data collection will be terminated automatically. The new image will be displayed in the preview area.
Page 46 Installation and Operation 2.6.14 (a) Laser Setup Wizard The easiest way to configure a laser vehicle detector is to use the Laser Setup Wizard. This guides you through a series of steps that will help determine the correct setup values for the laser based on actual distance measurements. FIGURE 54. Laser Setup Wizard Start screen Start the Wizard by pressing Next button.
Page 47 Installation and Operation FIGURE 55. Laser Wizard data collection Data collection will start automatically but needs to be stopped by the user by pressing the Stop button. The whole idea with the data collection is to sample enough data in order to calculate the average distance to the road. If the variation of the collected data is too big the data will be discarded and a new data collection needs to be started.
Page 48 Installation and Operation FIGURE 56. Successful data collection It is now possible to specify two offset values directly. These offset values will be used to calculate the trigger ranges used by the laser. The offset values can also be estimated if the distance from the laser down to the ground is known and the normal bumper height can be determined. Then both offset values will be calculated by the Wizard. FIGURE 57.
Page 49 Installation and Operation Press Next after the offset values are determined. Next specify the Filter Size used by the laser when it generates range measurements. The higher the value the smoother the range data will be. But on the other hand the higher the value the longer delay will be introduced (this will result in bigger variations in the trigger line - depending on the vehicle speed!) Recommended values for the Filter Size are around 3-5. FIGURE 58.
Page 50 Installation and Operation Next specify the Hysteresis Count used by the laser. In order for the laser to generate the trigger it will require this amount of consecutive samples to be within trigger range. This will help the laser to filter out any noise for instance from raindrops. FIGURE 59. Hysteresis Count Next specify the Trigger Output Polarity used by the laser. FIGURE 60.
Page 51 Installation and Operation The results generated by the laser will be displayed. Press Next to finish the Wizard. Click the OK button. FIGURE 61.
Page 52 Installation and Operation 2.7 Error Log Window The ERROR LOG window is activated from the EN CAMERA SETUP windows Tools menu. The list has information’s from the cameras (or ENSetup). IP-Addresses, UTC-time and log-level are listed. The Error Log will be updated all the time – even when it is not displayed. The contents of the Error Log will only include all the logged items from when ENSetup was started. All Error Log items will be saved to the PCs hard disk though. FIGURE 62.
Page 53 Configuration 3 Configuration 3.1 User administration The User Administration menu is found in the EN CAMERA SETUP tools menu (see Figure 6 on page 6). This will open the User Administration Window. FIGURE 64. User Administration Window 1. There are three user levels: Restricted user, Supervisor and Administrator 2. Only users on "Administrator" level can enter this dialog via the menu. 3. All users information’s are saved on the hard disk after being encrypted using 64-bit DES encryption.
Page 54 Configuration 3.2 Firmware update It is possible to update the firmware inside the cameras via the context menu described in Section 2.5.4 (g on page 14. One or more cameras can be updated simultaneously by selecting the cameras in the camera tree-view in the left side of the Camera Properties Window. This will open the Firmware Update Windows seen in Figure 3.3 FIGURE 66. Firmware Update To update the firmware, click on the Update Firmware button.
Page 55 Configuration 4. Library/DriverLow Level Firmware used by the EN Application to communicate with the hardware. This file has extension “.DRV” 5. Camera moduleThe Camera Module firmware. This file has extension “.PAT” for TS-9720 and “.2030” for TS-2030 EN. 6. DocumentationA revision history for the firmware is found in the file “ReadMe.txt”. The Lane Controller communication protocol is described in the “xxx_LC_to_EN_IDx.pdf” file.
Page 56 Configuration 3.3 Configure Storage Memory The internal image storage memory can be individually configured for each camera. The different image types are placed inside separate queues and a fixed maximum image size is defined for each image type. FIGURE 69. Internal Storage Settings It is possible to configure the following parameters for each queue: Max Image Size:Maximum number of bytes allocated to hold a single image of the selected type. Max Images to Store:Queue depth for the selected type.
Page 57 Appendix Appendix A: PC Minimum Specifications Software: • Windows XP Service Pack 2 • Dot NET framework 2.0 Hardware: • At least 1.8 GHz CPU speed (P4 3GHz stationary PC or Centrino 1.
Page 58 Appendix Appendix B: Resolving IP-address problems When the automatic device discovery searches for cameras on the networks, there are two basic IPaddress problems that can be detected by the ENSetup during Device Discovery: 1. IP-address Collision: One or more cameras have got the same IP-address on the LAN network. This will make it impossible to communicate with both cameras. 2. Unreachable Camera: One or more cameras are configured to be used on a different IP sub-net.
Page 59 Appendix FIGURE 71.
Page 60 Configuration VIS 300/400 EN Setup Software
Imaging Products JAI PULNiX, Inc. 625 River Oaks Parkway San Jose, CA 95134 Tel: 408-383-0300 Tel: 800-445-5444 Fax: 408-383-0301 Email: imaging@jaipulnix.com www.jaipulnix.
