Speeder X1 and X2 Laser Radar Configuration and API Guide ____________________________________________________________________________________ ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 2/36 ____________________________________________________________________________________ Contact information Noptel Oy Address: Tel.: Fax: E-mail: Technical support: Teknologiantie 2 FI-90590 Oulu Finland +358 40 181 4351 +358 8 556 4101 [email protected] see our Web site: www.noptel.fi Downloads: Documents : http://www.noptel.fi/eng/nms/index.php?doc=7_downloads/5_manuals&group=MSC Software: http://www.noptel.fi/eng/nms/index.php?doc=7_downloads/7_software&group=MSC Firmware: Ask from [email protected] Document Information : Document Title: Document Version: Released: Current printing Document ID : Document Status: Firmware version CM5: Speeder X1 and X2 Configuration and API Guide 1.4 (25.04.2014) 25.4.2014 N42272AE Release 5.00.45 (CMS5) Copyright Notice: Specifications and implementation are subject to change without notice due to continuous research and development. Copyright © 2013 Noptel Oy, Oulu, Finland ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 3/36 ____________________________________________________________________________________ 1 INTRODUCTION TO THE FAST RANGEFINDERS ............................................................... 5 1.1 1.2 1.3 2 INTRODUCTION ............................................................................................. 5 COMMUNICATION PROTOCOL ......................................................................... 5 COMMANDS IN CONFIGURATION MODE ........................................................... 6 OPERATION MODES .............................................................................................................. 9 2.1 2.2 3 LIST OF OPERATION MODES ........................................................................... 9 OUTPUT AT STARTING OF THE OPERATION MODE ........................................... 10 DISTANCE MEASUREMENTS ............................................................................................. 11 3.1 ASCII MODE.............................................................................................. 11 3.1.1 ASCII format of the distance measurement ......................................... 11 4 SPEED MEASUREMENTS ................................................................................................... 13 4.1 SPEED MEASUREMENT MODE FOR VERTICAL INSTALLATION ............................ 13 4.1.1 Speed calculation method ................................................................... 17 4.1.2 Delayed trigger in speed measurement ............................................... 17 4.2 MULTILANE SPEED MEASUREMENT MODE ...................................................... 19 4.3 AUTOMATIC SETTING OF THE MEASUREMENT WINDOW ................................... 22 4.3.1 Vertical setup ....................................................................................... 22 4.3.2 Horizontal setup ................................................................................... 23 5 DETECTION MODES ............................................................................................................ 24 5.1 TRIGGER WINDOW MODE ............................................................................. 24 5.1.1 In window and Out of window triggering .............................................. 25 5.1.2 Trigger count and timing information ................................................... 26 6 PARAMETERS ...................................................................................................................... 27 6.1 6.2 6.3 6.4 6.5 6.6 6.7 6.8 USER PARAMETER COMMANDS .................................................................... 27 PERMANENT MEMORY PARAMETERS ............................................................. 29 PARAMETER LIST ........................................................................................ 29 CONTROL BYTE 1 ....................................................................................... 33 CONTROL BYTE 2 ....................................................................................... 33 CONTROL BYTE 3 ....................................................................................... 34 CONTROL BYTE 4 ....................................................................................... 34 CONTROL BYTE 5 ....................................................................................... 35 ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 4/36 ____________________________________________________________________________________ 1 INTRODUCTION TO THE FAST RANGEFINDERS 1.1 Introduction This document presents Configuration and Application programming interface (API) for Speeder X1 and X2 Laser Radars which are based on Noptel’s fast rangefinder technology. Connections and hardware of the sensors is presented in ”CM5 Technical manual”. Speeder is designed for Speed measurement but it is also suitable for Distance Measurement and Target Detection. Versatile utilization of sensors leads to diverse Configuration and Parameterization. The document is intended as facilitate the work. 1.2 Communication protocol Baud rates: The sensors operate connected to the RS-232 or RS-422 port, using baud rates of 1200 to 921600 bd. The bit stream of serial port consists of: Data bits Parity Stop bit Flow Control 8 None 1 None The main commands of the sensor are described in this chapter. The default baud rate is 9600. If the baud rate is not known, the user can reset the baud rate to 9600 by sending multiple <esc>’s to the serial port, while connecting power on to the sensor. The ASCII command protocol is in the form: <esc>[Device Number]<Command><Value1>,<Value2><cr> Where <esc> ASCII code 27 [Device Number] is an option, 1–9 if two or more sensors are connected to a serial port, Command is a command according to the Chapter 1.3, <Value1> and <Value2>are parameter No. and values in ASCII format (if needed), and <cr> is Carriage Return (ASCII code 13). The controller must be in Configuration Mode (par. #1 = 0) when giving commands. The character <esc> is used for returning the sensor to base state. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 5/36 ____________________________________________________________________________________ <esc> has three basic functions: 1. Precedes every command. 2. Deletes wrong command. 3. Returns the Sensor into Configuration Mode. Echo mode: The system has two communication modes: echo and no echo. In echo mode the commands and numbers will be echoed back to allow easier operation with terminal software. Characters prior <esc> are not echoed. In no-echo mode no characters or numbers are echoed. The echo mode can be defined by Commands [i], echo OFF and [I], echo ON. These commands will assign bit 1 of Control Byte 2 respectively. Start-up: The sensor starts to operate always in the mode according to parameters in the permanent parameter memory. Parameters are changeable, but before saving parameters into the permanent memory, user should always test the proper function of the sensor. 1.3 Commands in Configuration mode The commands in Configuration mode are as follows: Command c C Description Measure distance once Measure distance continuously, until next <esc> d G H<Value> Return error list of the Sensor Reset the Sensor Return <Value> count of distance measurement results (in ASCII format, average parameter used) i Set serial port echo OFF I Set serial port echo ON (Capital I) J<0/1> 1 = Continuous laser pulsing ON 0 = Laser pulsing OFF During laser pulsing trigger output will toggle with each pulse. Feature can be used to check the accuracy of the system time base. The pulse rate is defined by parameters 4 and 5 (See chapter 6.3) Read the used value of the parameter No. Read all used parameters L<No.> L LW<No.> M M<No.> Read word (16 bits) parameter from location No. and No.+1 Use the set measurement mode as defined in parameter 1. Use measurement mode No. Answer Dxxxxx [aaaaa] 1) Dxxxxx [aaaaa] 1) Dxxxxx [aaaaa] .... 2) Error table 3) GOK HDxxxxx aaaaa 1) Dxxxxx aaaaa .... ERRCNT=y ECHO OFF IOK ECHO ON IOK 1 0 Lxxxxx L0001 xxxxx L0002 xxxxx …. Lxxxxx MOK MOK ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 6/36 ____________________________________________________________________________________ O<0/1> P<No.> S v (lower case) V (upper case) V1 V2 0 = pointer OFF, 1 = pointer ON Read the value in EPROM of the parameter No. Save user parameters to permanent memory (X must be used before) Write <Value> to the parameter <No.> (ram) Write integer <Value> (0-65535) to parameter <No.> and <No.>+1 Sensor information in the Noptel internal format Sensor information in ASCII format (version) Read voltage, current and temperature measurements Perform self-test and show its result X Enable writing to permanent memory T<No.>,<Value> TW<No.>,<Value OOK Pxxxxx SOK TOK TOK Sensor information 4) 5) Table OK or Explanation of the error and ERR:xxxxx WR ENABLE Commonly used commands in configuring the sensor for applications are light blue. The end of the line of answer is always <cr><lf>. 1) Distance measurement commands Commands c and C, return results according to Chapter 3.1. With command H it’s the same except Amplitude Output Enable does not have an effect but amplitude is given in any case. 2) Error table (example) (table is for diagnostic purposes only and it is updated during every power-up of the sensor) Code 0001 0002 0004 0008 0010 0020 0040 0080 0100 0200 0400 0800 1000 2000 4000 8000 OK Error EEPROM R/W TDC datardy RX Error TDC main counter TDC interpolator Low battery Supply voltage! Invalid value Unknown command TDC interp zero EEPROM/FLASH:CRC? Voltage error! APD voltage! Temperature! Power consumption! HV error! Error count : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 Some errors may occur in certain conditions, like too low supply voltage or too high/low operating temperature. If the operation of the sensor returns to normal and errors do not keep increasing, it is safe to continue using the sensor. Otherwise contact Noptel Oy for further information. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 7/36 ____________________________________________________________________________________ 3) Sensor information at Power-up and after Resetting 9600 (Baud Rate) EEPROM PARAMS RESTORED SPEEDER X1 CMS5012242,RS232 Noptel Oy ParamDate:2012.04.20 Version :5.00.50 BAF3h SW Date :Dec 14 2012 SW time :12:51:12 Ubat :10.3 V READY! 4) Sensor information <esc>V<cr> An example of answer for command V: SPEEDER X1 CMS5012242,RS232 Noptel Oy ParamDate:2012.04.20 Version :5.00.50 BAF3h SW Date :Dec 14 2012 SW time :12:51:12 Ubat :11.4 V OK The order of lines varies according to the firmware version of the Sensor. 5) Voltage, current and temperature table (table is for diagnostic purposes only) An example of answer for command V1 is presented below (units are added): Description APD :02212 RX temp RX Anaout Current VDD VAN VTDC CP temp UBAT UDCDC VRX VOSC VTX VCP TXHV TX temp OK Value Unit (Not in output) [0.1V] :03222 [0.01°C] :0156 [mV] :00201 [mA] :05068 [mV] :02960 [mV] :04845 [mV] :02540 [°C] :10293 [mV] :0548 [mV] :05161 [mV] :05022 [mV] :05138 [mV] :03348 [mV] :00257 [V] :02311 [0.01°C] ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 8/36 ____________________________________________________________________________________ 2 OPERATION MODES 2.1 List of operation modes 0 ASCII mode / Configuration Mode (Chapter 3.1) The Sensor sends measurement results in ASCII format according to the user’s commands and parameter settings. In this mode the sensor receives commands like parameter change and state control or operation mode selection. 1 Continuous ASCII mode (Chapter 3.1) The sensor sends measurement results in ASCII format continuously according to the parameter settings. 5 Trigger window mode (Chapter 5.1) The sensor controls the measurement results in the trigger window, and according to parameters it gives trigger-output-signal and sends trigger distance to serial-port. In this mode the Speeder sensor operates with one laser for accurate detection. 7 Speed measurement mode for vertical installation (Chapter 4.1) The sensor waits for the target to be in the trigger window and then starts measuring the change of distance to the target in the selected windows. Speeder X1 comprises two integrated laser transmitters with a small angle, allowing measurement of two consecutive overlapping speed profiles from the vehicle. 12 Speed measurement mode for horizontal installation (Chapter 0) The mode is designed to be used from the side of the road at the level of vehicles. The mode gives possibility to catch speed of vehicles travelling on one or multiple lanes. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 9/36 ____________________________________________________________________________________ 2.2 Output at starting of the operation mode Output of the sensor after mode command (<esc>M<No.><cr>) are following: Mode <No.> 0 1 5 (example) 7 (example) 12 (example) Output MOK, no effect MOK Dxxxxx [aaaaa] Dxxxxx [aaaaa] .... MOK TRIGGER MODE TRIG IN 500–550 cm ESC to EXIT MOK Speeder X1 SPEED MODE Approaching vehicles MASTER DISTANCE 3059 cm SLAVE DISTANCE 2860 cm ESC to EXIT MOK HORIZONTAL INSTALLATION (MULTILANE) Speeder X1 SPEED MODE Approaching vehicles MASTER DISTANCE 3500 cm SLAVE DISTANCE 3279 cm ESC to EXIT ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 10/36 ____________________________________________________________________________________ 3 DISTANCE MEASUREMENTS 3.1 ASCII Mode The value of the Parameter 1 is 0 (= single) or 1 (= continuous). In this mode the sensor measures the distance to the target either after the detection of <space> character or by the activation of Digital-input-signal or by the user command (c or C). Serial port communication is in ASCII format. The maximum measurement speed in ASCII mode depends on the communication speed and parameter settings. Continuous mode can be activated by command <esc>M1<cr> or <esc>M<cr> if value of par. #1 is 1. Parameters related to ASCII mode are: No. 1 2 3 4 5,6 7 8 11 47 Type B B b4 B b2 b3 b5 B W B B B B Name / Description Operation Mode Control Byte 1 Hardware Input Disable Control Byte 2 Decimal Enable Amplitude Output Enable Fast Key Disable Baud Rate Pulse Rate Averaging Attenuation Device Number Laser Control Unit Range Default 0 or 1 0 Hz 2n 1 - 10 1-2000 0 - 14 0 - 15 0-9 0,1,2 0 1 0 4 2000 4 0 0 2 3.1.1 ASCII format of the distance measurement The data in ASCII mode is delivered in the following format: Distance result from the sensor Dzxxxxx[.d]<space>[aaaaa]<cr><lf> z xxxxx .d aaaaa is automatically added number for values > 99m is distance in millimetres, is the decimal digit (option), is the signal amplitude value (option) The answer format depends on Decimal Enable in Control Byte 2 (Bit 2) as follows: “1”: Dxxxxx.x aaaaa.a “0”: Dxxxxx aaaaa Received signal amplitude (aaaaa) is sent if Amplitude Output is Enabled (Control Byte 2, Bit 3 = 1). It can be used for analyzing a quality of measurement. The higher the value, the better quality of a distance measurement result. The range is a few tens up to 1300. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 11/36 ____________________________________________________________________________________ D00000 refers to a failed distance measurement in the case of which the amplitude value carries an error code. The Code is given only if the Amplitude Output is Enabled (Control Byte 2, Bit 3 = 1). Error messages in ASCII distance measurement mode: Hex value 1 2 4 8 10 20 40 80 100 200 400 800 1000 2000 4000 8000 Dec val. 1 2 4 8 16 32 64 128 256 512 1024 2048 4096 8192 16384 32768 Error EEPROM R/W error No object Receiver error TDC counter error 1 TDC counter error 2 Low battery Supply voltage Invalid value Unknown command TDC counter error 3 EEPROM or FLASH Checksum error Voltage error APD voltage error Temperature Power consumption High Voltage error ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 12/36 ____________________________________________________________________________________ 4 SPEED MEASUREMENTS 4.1 Speed measurement mode for vertical installation The value of the Parameter 1 is 7. Speeder 1 5 Fig. 1. An example of speed measurement using Speeder X1 laser radar. Speeder X1 has two separate laser beams A and B. The geometry of the measurement is recommended to be >5:1 (please see the Fig. 1): For example, if the sensor is at 5 m height it should be aimed to at least to 25 m distance in order to achieve good speed measurement readings. Fig. 2. Default orientation of the Speeder X1 laser radar for vertical installation is laser radiation sticker up. When orientation is changed parameter 53 must be set correspondingly. Setup in Fig. 1 and Fig. 3 applies for controlling of one lane per sensor. The sensor is aimed at the centre of the lane for desired distance. Furthermore, the sensor comprises a laser pointer, which can be used to set correct alignment. The laser pointer has poor visibility at bright daylight and when used in fixed installation with a camera it is advised to align the sensor with the camera at indoors. This enables the final aiming with the help of the camera. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 13/36 ____________________________________________________________________________________ The best accuracy is achieved when the sensor measures as far as possible with reasonable signal level. The distance to the vehicle can be up to 40 to 90 metres, when the register plate is reflective, and up to 30 metres without reflective register plates. To achieve proper illumination for LPR-camera it is sometimes necessary to use shorter distance. Another option is to use delayed trigger, which is described in paragraph 4.1.2. The speed of both approaching and departing vehicles can be measured. The selection of the direction is done by Bit 5 of Control Byte 1. Fig. 3. Detection of vehicle with Speeder X1 laser radar affixed on gantry above the lane. Speed measurement starts with detection of the vehicle when trigger is first activated in the trigger window. Trigger activation is achieved when amount of the distance results reaches the hits for trig parameter’s value. After detection sensor measures distance to the target until vehicle has passed and calculates the speed of the target. The accuracy for the speed measurement is better than ±2 km/h (±2% for over 100 km/h speeds), when the measurement beam hits the vehicle (which travels on the lane, not on the side of it). In order to use the mode user must set following parameters: No. 1 2 4 5,6 8 9,10 12,13 29,30 32 53 Type B B b5 B W B W W W B B Name / Description Operation Mode Control Byte 1 Speed Behind Baud Rate Pulse Rate Attenuation Trigger Distance B Trigger Distance A Speed Pulse Rate (Note 1) Speed Geometry (Note 2) Sensor Orientation Unit Hz cm cm Hz dm Range 1 - 10 1 - 2000 0 - 15 600 - 38000 600 - 38000 0 - 8000 0,1,2 Default 7 0 4 2000 0 4000 1 Note 1: Speed pulse rate is in use after detection of a vehicle in speed measurement application (or mode). Speeder X1 is class 1 laser product. Eye-safety standard limits the pulse rate of Speeder X1 to 2000 Hz for pulse trains in short range (Condition 2, target distance less than 2 meters). Laser pulsing exceeding 2000 Hz is allowed only while measured distance is more than 2 meters. Pulse train limitations are controlled programmatically to fulfil the Standard EN 60825-1:2007 (IEC 60825-1:2007) Condition 2. Note 2: The height of the sensor position is utilized to calculate measurement windows for both lasers according to the geometry of the measurement set-up. The user must set this parameter accordingly to achieve accurate speed measurement results. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 14/36 ____________________________________________________________________________________ Advanced configuration parameters for above the road operation: No. 14 15 17 18 31 36 37 39 45 46 51 Type B B B B B B B W B B B b5 b7 Name / Description Trigger Window Width Hits For Trig Trigger Length (Note 3) Clear Check Time Speed Calculation Start Speed Limit Large Speed Limit Vehicle Height Limit Classification Window Speed Verification Distance Control Byte 5 Speed Verification Digital IO Control Trigger From Beam A (Note 4) Unit dm smpls ms 10 ms dm km/h km/h cm dm dm Range 1 - 255 1 - 255 1 - 255 0 - 255 0 - 10 40 - 255 0 - 255 Default 51 10 255 30 0 0 0 0 40 0 0 0 Note 3: Setting Trigger Length = 255 keep the trigger active until vehicle has passed the measurement point. Note 4: Beam that sets trigger output signal (DIGOUT) can be selected for approaching vehicles. When this bit is set trigger will occur when vehicle is detected by Beam A. In case bit is cleared or Speed limit is set trigger will occur when vehicle is detected by Beam B. Following information may be added to the result: No. 2 26 48 50 51 Type B b0 b7 B b1 b2 b3 b7 B B b0 b1 b2 b3 b4 b6 B b2 b3 b4 Name / Description Control Byte 1 Profile Measurement Vehicle Size (Note 5) Control Byte 3 Disable Ok Text Speed Output 0: km/h 1: MPH Show Speed Histogram Vehicle Height Snow Ground Distance Control Byte 4 Trigger Time Output Trigger Time Interval Trigger Occupancy Time Traffic Flow Count Output CSV output Control Byte 5 Show Violation Only Measure Amount Of Snow Fall Show Speed Error Byte Unit Range Default 0 0 cm 0 - 38000 0 0 0 0 0 0 0 0 0 0 1 0 0 0 Note 5: The vehicle size (length) is an estimation based on the speed and the time the sensor is able to get results from a vehicle. This principle generates longer value for higher vehicle than its real length is. Note! In this mode the sensor will send the message ”OK” once a minute if the sensor is functional (the message can be disabled by Bit 1 of Control Byte 3, par. 26). ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 15/36 ____________________________________________________________________________________ The software calculates two consecutive speed values. First it calculates quickly a rough speed value utilizing preliminary results of the collected data. This value is called ‘QSpeed’. QSpeed is used to generate triggering output for speeding vehicles in real time. Speeder X1 detects the driving direction of the vehicle and compares it to the setting (prm2bit5). In case driving direction is opposite speed value cannot be calculated and QSpeed value is set as wrong direction “QSpeed = WD”. Thereafter the sensor calculates the speed value with a more sophisticated algorithm utilizing all the collected data. The calculation may take 50…150 ms depending on the quantity of data. Typically vehicles that are changing lanes or driving on the side of the lane cause the biggest errors, because the sensor may measure the speed from the side of the vehicle or the measurement point may change significantly during measurement. In the cases of difficult data or poor aiming, the sensor typically indicates “Speed = NA”. The result given by the sensor is as follows: (CSV, control byte 4 bit 6 is set): caption ;DIST_A;DIST_B;ELT;DIR;QSPD;SPD;Q;Size;OCC;Height;INT;CNT;ERR; A_OK;A_ALL;B_OK;B_ALL;CNT2;Flow;AveSPD <;3655;3328;0:00:02.774;A;106;103.2;01;003;0127;123;02.497;0000002;000; 163;165;133;133;142;852;100;> results Result fields are described in the table below. In error situation speed value is zero. (CSV not set): Sensor T 3655 3328 CSV DIST_A DIST_B [ELT: 0:00:02.774] ELT [INT: 02.497 s] [CNT: 000002] [A: 163/165 B: 133/133] INT CNT A_OK/ALL B_OK/ALL QSpeed = +106 [Height = 123] QSPD Height [discard = 0] ERR Speed = +103.2 km/h (1) SPD [Size = 3] Size [OCC: 127 ms] OCC Explanation Vehicle was detected by beam A at 36.55 metres (B 33.28) Option (prm50bit0): Time from the beginning of the measurement session Option (prm50bit1): Time between triggers Option (prm50bit3): Number of the triggering Option (prm51bit4): Amount of measurement results from beam (A/B) and accepted results for speed calculation. This output is intended for R&D phase evaluation. Calculated quick speed value [km/h] Option (prm26bit7): Height value is the difference between the shortest detected distance to the vehicle and triggering window maximum. Option (prm51bit4): When nonzero discard value is received the speed value is not fully reliable. This output is intended for R&D phase evaluation. Result of a more sophisticated calculation. Value in parenthesis is an estimate for the error direction and magnitude. (‘-‘ Means possibility for lower reading than the real value). Option (prm2bit7): Size value that is based on the speed and time the vehicle stayed in the sensor’s field of view. Option (prm50bit2): Time how long the vehicle has been in Triggering window ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 16/36 ____________________________________________________________________________________ [Count (10 minutes): 142] [Cars per hour: 852] [Average speed: 100] CNT2 Flow AveSPD Option (prm50bit3): Vehicle count for the past ten minutes. Value is updated once in a minute. Option (prm50bit3): Traffic flow for one hour, based on the count for the past ten minutes. Value is updated once in a minute. Option (prm50bit3): Average speed for the past ten minutes. Value is updated once in a minute. Error response is the following; it is given instead of the speed reading: Speed = NA 4.1.1 Speed calculation method The Speeder X1 is equipped with an advanced dual laser transmitter to allow measurement of two consecutive distance profiles. Both lasers measure the profile from the point where the beam hits onto the vehicle. The measurement starts, when the vehicle arrives into the triggering window of the sensor. Laser which is responsible for detection is selected with the traffic direction bit (parameter 2 bit 5). For approaching vehicles Beam A detects vehicle and for departing Beam B respectively. The sensor starts the speed measurement having detected the vehicle and checked the correctness of the triggering. The principle of operation is to measure two distance profiles onto a vehicle from two successive positions on the road. Both profiles include about 50 to 200 measurements depending on the setup and speed of the vehicle. Both profiles are then analyzed and converted to speed. Finally the profiles are compared to each other to get rid of the errors and the final speed value is calculated. This enhanced analysis results high accuracy speed values. The measurement onto a vehicle may get result from any part of a vehicle and either from approaching or departing vehicle. 4.1.2 Delayed trigger in speed measurement Parameter 46 (Speed verification distance) sets the distance where speed based trigger will occur. This distance can be set from 0.1 to 25.5 meters (parameter value in 0.1 meters, range 0-255). With this parameter it is possible to check whether or not the speed reading provided by Speeder X1 is acceptable. Speed reading evaluation is based on visual inspection i.e. how well the speed based travel time matches to the fixed distance set by the parameter. Another application is to move the triggering point closer in order that LPR-camera obtains acceptable illumination (provided by flash). Setting the distance to parameter 46 enables the delayed trigger at DIGIN/DIGOUT (pin 5, grey wire). Parameter 17 Trigger length is used to set delayed trigger length. Trigger signal operates normally at DIGOUT (pin 6, pink wire). Furthermore, it is possible to disable normal trigger and set delayed trigger output to the DIGOUT signal by setting Parameter 51 bit 5 (Speed Verification Digital IO Control). ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 17/36 ____________________________________________________________________________________ Detection of a target Detection Ready for new detection Digital Input/Output Delayed distance (par. 46) Trigger Legth (par. 17) Clear Check Time (par. 18) Digital Output Fig. 4. Timing of the Digital outputs when delayed trigger is activated. 4.1.3 Profile measurement Sensor is able to output distance information during the vehicle detection. Output is in binary format as described below. Binary format doesn’t effect on normal speed output and trigger functions. Speed output occurs after binary output in selected format. Vehicle profile is calculated based on the raw distance data when installation height, measurement distance to the ground and vehicle speed are known. Fig. 5. Noptel laser radar collects distance measurement data from the area between the sensor and the road surface detecting all passing vehicles. It is possible to acquire exact profile regarding passing vehicle with activated profile measurement. The profile measurement data is delivered in 2 or 3 bytes depending on the control bits. Profile data format can be used for distances up to 81.9 metres. Raw data output originates from single laser (Beam A for approaching and Beam B for departing). Sensor has two different measurement rates, pulse rate (parameter 5) is used for accurate vehicle detection and speed pulse rate (parameter 29) for speed measurement. Profile ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 18/36 ____________________________________________________________________________________ measurement output rate for raw distance data is (Pulse rate)/8 and (Speed pulse rate)/16. Suggested values are 2000 for pulse rate and 4000 for speed pulse rate. With these suggested values output rate will be 250 measurements/second for entire vehicle detection. First data byte MSB No. 7 LSB 6 5 4 3 2 1 0 1 Value h80 h40 x x x x x x x h00 to h3F Note Start of the data bytes Error bit 0 = Correct distance measurement 1 = Error in distance measurement Distance Value MSB or Error code - Distance bits 12 to 7 - Error Code if bit 6 = 1 Second data byte MSB No. LSB 7 6 5 4 3 2 1 0 Value 0 x x x x x x x h00 to h7F Note Distance Value LSB - Distance bits 6 to 0 [cm] - ‘E’ if error (h45) Third data byte (only if bit 3 of Control Byte 2 Enabled) MSB No. LSB 7 6 5 4 3 2 1 0 Value 0 x x x x x x x h00 to h7F Note Signal Amplitude - Amplitude divided by 16 - ‘R’ if error (h52) Distance = 128 x Distance Value of First Data Byte + second byte [cm] 4.1.4 Snow accumulation measurement Speeder is able to measure snow accumulation on the road while operating in speed measurement mode. Accumulation is switched on with Control Byte 5 bit 3 “Measure Snow Fall”. Ground level (distance to the ground) is set to word parameter 48 “Ground distance” in centimetres. Running “Automatic setting of measurement window” (Chapter 4.3) sets ground distance value in case Speeder is able to measure on to the ground. Furthermore this value can be set manually when the distance is known. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 19/36 ____________________________________________________________________________________ 4.2 Speed measurement mode for horizontal installation The value of the Parameter 1 is 12. Horizontal mode measures speed from the side of the road and can detect vehicles travelling on parallel lanes. Speeder X1 comprises two lasers and it must be installed in correct orientation for intended application. Orientation for horizontal installation is shown in the Fig. 6. Horizontal installation height is on the same level with cars i.e. measurement beam hits the front of the car at the same height in both lanes (height of the licence plates). Measurement beam hitting the target is shown in the Fig. 6. The height of the measurement beam should be lower for the car in the picture but it is correct for higher vehicles. Installation is always a compromise because the size of cars varies in real measurement situations. Measurement angle against the lanes should be such that the cars in the first lane are detected roughly on 20 meters and cars on the second lane at 40 meters. In practise, set the detection distance for the second lane at least to 40 meters and for the first lane it is what it is. Sensor is set for operation with parameters. These parameters depend on installation geometry and are shown in the Fig. 7. Thereafter programmatic calibration is carried out for the horizontal measurement. Fig. 6. Orientation of the Speeder X1 sensor for horizontal measurement. In default orientation connector is up and parameter 53 setting is 1. 2 Par. 43 Par. 32 1 Par. 12, 13 Fig. 7. Speeder Parameter settings. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 20/36 ____________________________________________________________________________________ With parameter 43 is set maximum measurement distance, which expresses the distance to the furthest point at the measured lanes [m]. Parameter 12/13 is the shortest monitored distance, which is shortest distance on the closest lane [cm]. Parameter 32 is the perpendicular component of the furthest measured distance. In order to use the mode user must set following parameters: No. 1 2 4 5,6 8 12,13 29,30 32 43 44 53 Type B B b5 B W B W W B B B B Name / Description Operation Mode Control Byte 1 Speed Behind Baud Rate Pulse Rate Attenuation Trigger Distance A Speed Pulse Rate Speed Geometry Trigger Window End for Multiple Lanes DirChangeDist Sensor Orientation Unit Hz cm Hz dm m m Range 1 - 10 1-2000 0 - 15 0 - 38000 2k – 8k 1 - 255 0 - 255 0,1,2 Default 12 0 4 2000 0 4000 1 Advanced configuration parameters for the road side operation: No. 15 17 18 31 37 46 51 Type B B B B B B B b5 b7 Name / Description Hits For Trig Trigger Length Clear Check Time Speed Calculation Start Speed Limit Speed Verification Distance Control Byte 5 Speed Verification Digital IO Control Trigger From Beam A Unit smpls smpls 10 ms dm km/h dm Range 0 - 255 0 - 255 0 - 255 2 - 10 Default >=10 4 30 5 0-255 0 0 Following information may be added to the result: No. 2 26 50 51 Type B b7 B b1 b2 b3 B b0 b1 b2 b3 b4 b6 B b4 Name / Description Control Byte 1 Vehicle Size Control Byte 3 Disable Ok Text Speed Output 0: km/h 1: MPH Show Speed Histogram Control Byte 4 Trigger Time Output Trigger Time Interval Trigger Occupancy Time Traffic Flow Count Output CSV output Control Byte 5 Show Speed Error Byte Unit Range Default 0 0 0 0 0 0 0 0 0 1 0 ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 21/36 ____________________________________________________________________________________ The size calculation is based on the time the vehicle is detected, which causes an effect that a closer vehicle is estimated to be bigger than a far one even though the actual length of the vehicles is the same. The speed measurement principle itself and the output of the sensor are identical to the mode 7 (Speed measurement mode). 4.3 Automatic setting of the measurement window Speeder X1 includes a function that helps the user to set up the triggering window at a correct distance. The function is designed to be used with both Speed measurement modes, vertical measurement (#7) and horizontal measurement (multiple lanes)(#12). Calibration is carried out for both approaching and departing vehicles. For approaching vehicles bit 5 of Control Byte 1 (par. 2) must be cleared. Calibration is started with command “U”. To calibrate the triggering window for the departing vehicles bit 5 of Control Byte 2 (Speed Behind) must be set. A complete calibration cycle requires 12 vehicles to pass the measurement area. Two vehicles are used to evaluate the orientation of the sensor and 10 to detect correct measurement window. When orientation of the sensor is unknown to user it is possible to set parameter 53 to value 0. Function detects the orientation of the sensor before setting up the measurement window. When the parameter setting and orientation detection are opposite user is informed before changing the setting. The sensor will guide the user through the calibration procedure. Setting up the calibration is shown in the next paragraphs with example outputs for both measurement modes. 4.3.1 Vertical setup Before entering the vertical setup mode the sensor must be aimed correctly. Make sure that the height of the sensor is set correctly [parameter 32, Speed geometry (height from the ground in decimeters)]. Furthermore, please check that the parameter 43 is set as zero. Orientation of the sensor is set by parameter 53. Default setting (53 = 1) is such that laser radiation sticker side of the sensor is set up. The calibration mode is activated with command [ESC]U[CR]. Output Using height (SpeedGeometry) 600 cm (Y/N) Vertical setup Calibration of two laser beams for approaching vehicles Wait until 10 vehicles are detected (ESC to exit) Distance value [cm] and average signal table: Monitored Max | Detected Max | Signal average Beam A: 2764 | 2721 | 397 Beam B: 2696 | 2660 | 235 median: 2566 Comment Verify or change parameter 43 is zero bit 5 of Control Byte 1 is cleared 10 vehicles are monitored distance information for each car median triggering window ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 22/36 ____________________________________________________________________________________ final 2571.7 ACCEPT WINDOWS: Beam A: 2235 - 2747 Beam B: 2060 - 2572 (Y/N)? MEASUREMENT WINDOW SETUP SUCCESSFUL! SAVE PARAMETERS TO EEPROM (Y/N)? SAVED TO EEPROM! WINDOW CALIBRATED NORMAL MODE final triggering window, difference compared to median should be less than 20 Accept with “Y” if reasonable Save to eeprom with “Y” 4.3.2 Horizontal setup Before entering the horizontal setup mode the sensor must be aimed correctly. Make sure that the geometrical parameters of the measurement setup are set correctly. Parameter 43 is set to maximum measurement distance (meters) and parameter 32 (Speed geometry) is perpendicular distance component (in decimeters) of the parameter 43. Parameter 12 is set to minimum detection distance (centimeters). The calibration mode is activated with command [ESC]U[CR]. Output Calibration for horizontal measurement (Y/N)? Use maximum measurement distance 40 m (Trigger Window End for multiple lanes)(Y/N)? Use 300 cm as shortest detection distance for multiple lanes (Y/N)? Use (SpeedGeometry) 650 cm as perpendicular part of the max measurement distance (Y/N)? Horizontal setup Calibration of two laser beams for approaching vehicles Wait until 10 vehicles are detected (ESC to exit) Distance value [cm] and average signal table: Monitored Max | Detected Max | Signal average Beam A: 2342 | 2302 | 397 Beam B: 2266 | 2221 | 321 median: 2179 final 2177.8 ACCEPT WINDOWS: Beam A: 1813 - 2313 Beam B: 1678 - 2178 (Y/N)? MEASUREMENT WINDOW SETUP SUCCESSFUL! SAVE PARAMETERS TO EEPROM (Y/N)? SAVED TO EEPROM! WINDOW CALIBRATED NORMAL MODE Comment Horizontal mode if value in parameter 43 is nonzero, answer “Y” Value of parameter 43, answer “Y” if correct. Value of parameter 12, answer “Y” if correct Value of parameter 32, answer “Y” if correct. parameter 43 is nonzero bit 5 of Control Byte 1 is cleared 10 vehicles are monitored distance information for each car median triggering window final triggering window, difference compared to median should be less than 20 Accept with “Y” if reasonable Save to eeprom with “Y” ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 23/36 ____________________________________________________________________________________ 5 DETECTION MODES 5.1 Trigger window mode The value of the Parameter 1 is 5. The command [m] sets the sensor into Trigger window mode, when parameter 1 is set correspondingly. The sensor does not only send the distance value via serial port, but gives triggering mark "T" and distance [cm], whenever trigger is activated. The triggering signal is also given to digital output line according to parameters. Note: In this mode an “OK” message will be sent every minute if the sensor is functional (“OK” text can be disabled by bit 1 of parameter 26). Parameters related to Trigger window mode are: No. 1 2 4 5,6 8 12,13 14 15 17 18 26 50 Type B B b1 B W Name / Description Operation Mode Control Byte 1 Trigger Out of Window Baud Rate Pulse Rate B W B B B B B b1 B b0 b1 b2 b4 Attenuation Trigger Distance Trigger Window Width Hits For Trig Trigger Length Clear Check Time Control Byte 3 Disable Ok Text Control Byte 4 Trigger Time Output Trigger Time Interval Trigger Occupancy Time Count Output Trigger Distance (par. 12, 13 [cm]) Fig. 8. Unit Hz cm dm smpls smpls 10 ms Range 1 - 10 See Chapter 6.3 0 - 15 0 - 38000 1 - 255 0 - 255 0 - 255 0 - 255 Default 5 0 4 2000 0 >= 5 4 30 0 0 0 0 0 Trigger Window Width (par. 14 [dm]) Trigger Distance and Trigger Window Width in Trigger Window Mode ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 24/36 ____________________________________________________________________________________ Detection of a target Detection Ready for new detection Digital Output Trigger Legth (par. 17) Fig. 9. Clear Check Time (par. 18) Timing of the Digital output in Trigger Window Mode The sensor measures at a selected measurement rate the distance to the target. If the selected number of measurements (par 15) are detected inside the window (par 14 [x 10 cm]) in the selected distance (par 12, 13 [cm]), the Sensor sends a trigger signal of selected length (par 17) to the digital output line and an ASCII character "T" to the communication port. During the triggering pulse the sensor does not detect any new targets. New detection will start, when the sensor has not detected objects in the triggering window during the clear check time (par 18). The sensor provides a function to help the user to set up the proper triggering distance. This function is described in Chapter 4.3 Automatic setting of the measurement window. 5.1.1 In window and Out of window triggering The trigger window mode has two alternative operation principles. Normally the trigger signal is given when target is detected in the specified window. But if bit 1 of Control Byte 1 “Trigger Out of Window” is selected, the trigger signal will be given at the moment measurements come outside of the specified window and also in case of failed measurements. The Out of Window triggering mode can be used for example if sensor is assembled to such location that it can always detect ground (or road) and user want to get exact timing information from the incoming vehicle. Furthermore this mode enables possibility to get continuous trigger signal as long as the vehicle stays in the measurement beam, even when the beam is reflected so that the sensor is not able to get distance measurements from the vehicle (In this case set identical value to parameters #15 “Hits For Trig” and #17 “Trigger Length”. Set also zero to parameter #18 “Clear Check Time”.) ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 25/36 ____________________________________________________________________________________ 5.1.2 Trigger count and timing information The user can get different timing information, such as the trigger event time, time between trigger events, and trigger occupancy time. The sensor can also be set to count the triggers. The trigger event time is the elapsed time from the start of the trigger mode to the trigger moment. This function is enabled by setting bit 0 of Control Byte 4 (par #50). Time between trigger events is enabled by setting bit 1 of Control Byte 4 (par #50). The trigger occupancy time is the time the target is inside the triggering window. It is enabled by bit 2 of Control Byte 4 (par #50). Trigger counting can be enabled by bit 4 of Control Byte 4 (par #50). If all the above-mentioned functions are enabled, the output of the trigger event looks the following: Output T01234 ELT: 0:00:09.432 INT: 02.321 s CNT: 000004 OCC: 01017 ms Comment Target was detected at 12.34 m Elapsed time h:mm:ss.sss Time from previous trigger in seconds Number of the trigger Time the target was in the triggering window ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 26/36 ____________________________________________________________________________________ 6 PARAMETERS The Sensor includes a user parameter area, which defines the operation of the Sensor. This parameter area comprises, for example, the definition of the measurement rate, operation mode, and data transmission mode. There are two parallel parameter areas: one in permanent memory and the other currently in use in non-permanent memory. The parameters in permanent memory will be taken into use after power is switched on. You can modify the parameters in non-permanent memory, and after finishing the modification, store them into the permanent memory. 6.1 User parameter commands User parameters can be set by command: Command from PC Reply <esc>T<No.>,<Value><cr> TOK<cr><lf> or “Invalid Value<cr><lf>” <esc> T No. Value <cr> ASCII code 27 Command (ASCII code 84) parameter #1-61 in ASCII format parameter value 0-255 in ASCII format ASCII code 13 Example: Set the baud rate to 115200 baud: Command from PC Reply <esc>T4,8<cr> TOK<cr><lf> (Baud Rate before change) The parameters in two successive bytes (word) can be set by one command: Command from PC Reply <esc>TW<No.>,<Value><cr> TOK<cr><lf> or “Invalid Value<cr><lf>” <esc> TW No. Value <cr> ASCII code 27 Command parameter #1-61 in ASCII format parameter value 0-65536 in ASCII form ASCII code 13 Example: Set the Pulse Rate to 2000 Hz: Command from PC <esc>TW5,2000<cr> Reply TOK<cr><lf> ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 27/36 ____________________________________________________________________________________ User parameters can be read by command: Command from PC Reply <esc>L<No.><cr> L00xxx<cr><lf> <esc> L No. <cr> xxx ASCII code 27 Command (ASCII code 76) parameter #1-61 in ASCII format ASCII code 13 Value of parameter Example: Read the parameter 19: Command from PC Reply <esc>L19<cr> L00060<cr><lf> The parameters in two successive bytes (word) can be read by one command: Command from PC Reply <esc>LW<No.><cr> L00xxx<cr><lf> <esc> LW No. <cr> xxx ASCII code 27 Command parameter #1-61 in ASCII format ASCII code 13 Value of parameter Example: Read the Word parameter 5: Command from PC Reply <esc>LW5<cr> L02000<cr><lf> All available user parameters can be read by command: Command from PC Reply <esc>L<cr> L0001 00xxx<cr><lf> L0002 00xxx<cr><lf> L0003 00xxx<cr><lf> … <esc> ASCII code 27 L Command (ASCII code 76) <cr> ASCII code 13 xxx Values of parameters ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 28/36 ____________________________________________________________________________________ 6.2 Permanent memory parameters Writing parameters into permanent memory requires special attention. Permanent memory parameters are protected by a special lock that has to be opened before changing the parameters. The parameter area is also protected by checksum calculation. If the checksum is wrong, the sensor does not perform measurements. Having transferred the user parameters into the permanent memory, the sensor automatically calculates the checksum. To enable the permanent memory for writing: Command from PC Reply <esc>X<cr> (X, ASCII-code 88, h58) WR ENABLE<cr><lf> Parameters are set to permanent memory by command: Command from PC Reply <esc>S<cr> (S, ASCII-code 83, h53) SOK<cr><lf> Parameters can be read from permanent memory by command: Command from PC Reply <esc>P<No.><cr> P00xxx<cr><lf> <esc> ASCII code 27 P Command (ASCII code 80) No. parameter #1-61 in ASCII format <cr> ASCII code 13 xxx Value of parameter 6.3 Parameter list The sensor includes three types of parameters. In binary format each bit in the parameter carries meaning. In byte (8 bit) and word (16 bit) formats the parameter is able to receive values from 0 to 255 and from 0 to 65000 respectively. In the following descriptions these parameters are marked as: B W = Byte (8 bits) = Word (2 bytes) Note: All parameters are not valid for all software versions. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 29/36 ____________________________________________________________________________________ No. 1 Type B 2 3 4 B B B Name / Description Operation Mode ASCII mode and Configuration mode ASCII mode, continuous Triggering window mode Speed measurement for vertical installation Speed measurement for horizontal installation Control Byte 1 (See Chapter 6.4) Control Byte 2 (See Chapter 6.5) Baud Rate W 1 = 1200 Bd 2 = 2400 Bd 3 = 4800 Bd 4 = 9600 Bd 5 = 19200 Bd 6 = 38400 Bd 7 = 57600 Bd 8 = 115200 Bd 9 = 230400 Bd 10 = 460800 Bd 11 = 921600 Bd Pulse Rate B Laser pulsing rate - Averaging rate in Normal mode, - Vehicle detection in Speed measurement and detection modes Averaging B Average calculation of [2n] single shot measurements to produce the final distance value. E.g. n = 4 => Average = 16. Note: Affects Normal mode only. Average calculation affects the final measurement speed. Sensor needs also some time interval between every output of the result for serial communication and internal operations, i.e. the total result rate is a combination of parameter settings and this interval. Attenuation W The receiver sensitivity level can be attenuated by this parameter. Used for example with retro-reflectors. 0 = maximum sensitivity (natural targets), 15 = maximum attenuation (prisms) Trigger Distance Beam B B Mode 7&5 (Chapter 4.1&5.1): Minimum distance value for Beam B trigger window Mode 12 (Chapter 0): Not user configurable. Parameter has same meaning for Beam B as par. 43 has for Beam A, see Chapter 4.3 Device Number 5,6 7 8 9,10 11 Unit Range Default Value 0 1 5 7 12 1 - 11 4 Hz 50 – 2000 2000 2n 0 – 14 4 0 - 15 0 cm 0 - 38000 0-9 0 Sensors connected to the same serial port are selected by the device number. Command format is presented in chapter 1.2. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 30/36 ____________________________________________________________________________________ 12,13 14 15 17 18 26 29,30 31 32 36 W Trigger Distance Beam A cm 0 - 38000 B Mode 7&5 (Chapter 4.1&5.1): Minimum distance value for Beam A trigger window Mode 12 (Chapter 0): Minimum detection distance for speed measurement Trigger Window Width dm 1 - 255 B Window size of triggering, starting from the value in P12,13 Hits For Trig smpls 0 - 255 >= 5 B Number of accepted measurement values before activating trigger pulse Trigger Length ms 0 - 255 255 B Note: In the case of speed measurement, the minimum length of the trigger is defined by the time of speed calculation. In the same mode setting Trigger Length = 255 keeps the trigger active until vehicle has passed the measurement point. Clear Check Time 10 ms 0 - 255 30 B W Time from the last measurement in the trigger window required to re-activate Triggering mode. Control Byte 3 (See Chapter 6.6) Speed Pulse Rate Hz 2000 – 8000 4000 B Speed pulse rate is in use after detection of a vehicle in speed measurement application (or mode). Speeder X1 is class 1 laser product. Eye-safety standard limits the pulse rate of Speeder X1 to 2000 Hz for pulse trains in short range (Condition 2, target distance less than 2 meters). Laser pulsing exceeding 2000 Hz is allowed only while measured distance is more than 2 meters. Pulse train limitations are controlled programmatically to fulfil the Standard EN 60825-1:2007 (IEC 608251:2007) Condition 2. Speed Calculation Start dm 2 - 10 B The starting point of speed calculation: This parameter defines how long a distance from the triggering point is rejected in speed calculation. Speed Geometry dm 0 - 255 B Dimensional offset of the sensor from the line of movement of the measured object E.g. height of the Sensor above the road surface, 55 dm Speed Limit Large km/h 0 - 255 A speed limit for vehicles higher than defined by parameter 39. Notice that it can only be used with top of the road installations and mode 7 (Speed mode For Vertical Installation) ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 31/36 ____________________________________________________________________________________ 37 39,40 43 44 46 47 B Speed Limit km/h 0 - 255 W If the speed limit is zero, hardware triggering is given always when a vehicle is detected. If the speed limit is set, the triggering is given out only for speeding vehicles. NOTE! The unit is [km/h] even if bit 2 of parameter 26 is set! Vehicle Height Limit cm 200 - 1000 B Setting up height limit for Speed Limit Large, parameter 36. The height value is the difference between the shortest measured value from the vehicle and the far end of the triggering window. For example, in a set-up where the sensor locates 6 metres above the road and the maximum distance to vehicles is 30 metres, a 2-metre height limit means a value of 1000 cm. But as the measurement window does not reach the surface of the road, typically a value of approximately 750 is used. The user may check the actual height values of different vehicles by enabling ‘Height’ measurement by bit 7 of parameter 26 and making some test speed measurements. Trigger Window End for Multiple Lanes m 1 - 255 B Defines the maximum distance needed to cover two or more lanes. Direction Change Distance m 0 - 255 B Defines a distance after which the direction of vehicles is opposite. Driving direction of the first lane is defined by bit 5 (Speed Behind) of parameter 2. Speed Verification distance cm 0 - 255 B Defines a distance where trigger will occur (if not zero). (See Chapter 4.1.2) LaserControl 48 W 50 51 52 B B B 53 B Select laser in use; 0 = Beam B, 1 = Beam A, 2 = toggle between laser. This selection applies in operation modes 0 and 1. Ground distance. Ground level distance measured with the sensor. Applies when snow measurement is activated. Control Byte 4 (See Chapter 6.7) Control Byte 5 (See Chapter 6.8) Control Byte 6. Consult manufacturer for changes. Otherwise ignore (keep default value) Sensor Orientation cm 0,1,2 2 0 - 38000 0 128 0,1,2 1 Select sensor orientation: 0 = detection on automatic setting of measurement window, 1 = laser sticker up, 2 = laser sticker down. Note: The parameters return to values saved into the permanent memory at power-ON. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 32/36 ____________________________________________________________________________________ 6.4 Control Byte 1 MSB No. 7 LSB 6 5 4 3 2 1 0 Value x 1 2 x 2 x 4 8 16 x x x 32 x 64 x 128 Note Control Byte 1 bits Profile Measurement After triggering sensor sends binary distance results as long as vehicle is detected Trigger Out Window Trigger window operates inverted Reserved Reserved HW input Disable Disables trigger input Speed Behind The sensor measures speed for departing targets Print Speed Data (Development use only) Enables output of detailed speed measurement report NOTE! This bit is cleared at start-up and reset of the sensor Vehicle Size Enables output of vehicle size. 6.5 Control Byte 2 MSB No. 7 LSB 6 5 4 3 2 1 0 Value x 1 2 3 x x x x x x x 4 8 16 32 64 128 Note Control Byte 2 bits Pointer Enable Echo On Sensor echoes serial commands Decimal Enable Adds one digit to the measurement result to show 1/10 mm value Amplitude Output Enable Disables trigger input Reserved Fast Key Disable Disables single key commands, like <space> and T Reserved Reserved ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 33/36 ____________________________________________________________________________________ 6.6 Control Byte 3 MSB No. 7 LSB 6 5 4 3 2 1 0 Value x 1 2 26 x x 4 x 8 x 16 32 64 128 x x x Note Control Byte 3 bits Reserved Disable OK Text Disables once-a-minute given OK text in modes 7 and 12 Speed Output 0 = km/h 1 = MPH Note! Does not affect parameter 37 (Speed Limit [km/h]) or QSPEED value. Show Histogram Sensor will output all detected speed values. Reserved Reserved Reserved Enable Vehicle Height Enables height output in mode 6 and 7, when also bit 7 of parameter 2 is set. 6.7 Control Byte 4 MSB No. 7 LSB 6 5 4 3 2 1 0 Value 50 x x x x x x x x 1 2 4 8 16 32 64 128 Note Control Byte 4 bits Trigger Time Output Time from the beginning of the measurement session is given Trigger Time Interval Time between triggering moments is given Trigger Occupancy Time Time how long the vehicle has been in Triggering window is given Traffic Flow Calculation is based on previous 10 minutes and it is updated in 1 minute interval. Traffic information (count, flow [cars/hour] and average speed [km/h or mph]) is given. Count Output Number of the triggering is given Reserved CSV output Speed measurement results are given in Comma separated value format. CRC Algorithm Enable The sensor calculates 16 bit CRC value for each output line. It is sent in two bytes after <cr><lf>. Please ask the equation from Noptel Oy. ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 34/36 ____________________________________________________________________________________ 6.8 Control Byte 5 MSB No. 7 LSB 6 5 4 3 2 1 0 Value x 1 51 x x x x x x x 2 4 8 16 32 64 128 Note Control Byte 5 bits Separation between vehicles Time between vehicles is given Show Violation Only Shows results only for speeding cases. Data to be outputted is collected as string and printed out after vehicle has passed. By enabling this byte and setting speed limit to 0 sensor prints vehicle information after it has passed. Output Binary Frame Measure Snow Fall Show Speed Error byte Speed Verification Digital IO Control Reserved TriggerFromBeamA Select the trigger beam for approaching vehicles. Value 0 sets trigger output to beam B (QSpeed detection moment, when speed limit is set with parameters 37 and 36). Value 1 sets trigger output to beam A (cars detection for approaching vehicles) Notes ____________________________________________________________________________________ Speeder X1 and X2 Configuration and API Guide Page 35/36 Speeder X1 and X2 Laser Radar Configuration and API Guide Contact information Noptel Oy Address: Tel.: Fax: E-mail: Technical support: Teknologiantie 2 FI-90590 Oulu Finland +358 40 181 4351 +358 8 556 4101 [email protected] see our Web site: www.noptel.fi
© Copyright 2024 Paperzz