manualshive.com logo in svg

quercus BirdWatch Red Light, Programming Manual

Share
Download
quercus BirdWatch Red Light Programming Manual Download Page 126

QuercusVL Programming Manual

information or to request an action (activate an output, reboot the unit, etc.). All requests will 
be answered immediately by the unit with a response message with the information requested, 
an ACK if the message  did not expect a response, or a NAK if the message could not be 
properly received, interpreted, or completed.
Please note that between the reception of a request and its response, an event can occur in 
the system, so that the first message to arrive after a request has been made might not be the 
response to the request.

Example of requests and their responses:

4.1. Message format

Messages will always have the same format; Bytes are ordered in all fields with the “little-
endian” system:

●

Stx (1 byte): byte that marks the start of a frame (ASCII character 2).

●

Unit Id (4 bytes): identifier of the capture unit sending or receiving the message; a zero 
means that this field has to be ignored.

●

Size (4 bytes): total size of the message in bytes.

Quercus Technologies

126

Unit

Central System

Action

ACK (Action)

Get information

Information

Unknown message

NAK

ACK (Event)

Action

Event

Event

ACK (Action)

Type

Version

Size

Id

2

2

4

4

Variable

1

Stx

Etx

1

1

Bcc

UnitId

4

Message    data

Summary of Contents for BirdWatch Red Light

Page 1: ...Software version 1 5 x Firmware version 1 5 x www quercus biz www quercus technologies com www quercus com br Quercus Technologies PROGRAMMING MANUAL PROGRAMMING MANUAL ...

Page 2: ...ed under a license and can be solely used for the purposes described in the license The contents of this manual are provided for information purposes only and can be modified with no prior warning The manual can not be fully or partially reproduced placed in a distribution system or released to third parties without the express permission of Quercus Technologies Quercus Technologies ...

Page 3: ...Compatibility between QuercusVL products 24 3 2 Hierarchy 26 3 3 Classes 27 3 4 System Class 27 3 4 1 Properties 27 3 4 2 Methods 28 3 4 3 Events 29 3 5 Units Class 30 3 5 1 Properties 30 3 6 Unit Class 31 3 6 1 Properties 31 3 6 2 Methods 34 3 7 UnitStatus Class 38 3 7 1 Properties 38 3 8 VersionInformation Class 39 3 8 1 Properties 39 3 9 Detectors Class 40 3 9 1 Properties 40 3 10 Detector Clas...

Page 4: ...6 1 Properties 50 3 17 TrafficLight Class 51 3 17 1 Properties 51 3 17 2 Methods 52 3 18 HistoricIncidences Class 53 3 18 1 Properties 53 3 18 2 Methods 53 3 19 HistoricSummaries Class 55 3 19 1 Properties 55 3 19 2 Methods 55 3 20 RealTimeInformation Class 57 3 20 1 Properties 57 3 20 2 Methods 59 3 21 Regions Class 59 3 21 1 Properties 60 3 22 Region Class 60 3 22 1 Properties 60 3 22 2 Methods ...

Page 5: ...2 3 29 1 Properties 72 3 29 2 Methods 77 3 30 SpeedsDistribution Class 77 3 30 1 Properties 77 3 31 LengthsDistribution Class 78 3 31 1 Properties 78 3 32 OccupationsDistribution Class 79 3 32 1 Properties 79 3 33 SpeedsUpperLimit Class 79 3 33 1 Properties 79 3 34 LengthsUpperLimit Class 80 3 34 1 Properties 80 3 35 OccupationsUpperLimit Class 81 3 35 1 Properties 81 3 36 Timestamp Class 81 3 36 ...

Page 6: ...105 3 44 1 Properties 105 3 45 ConfigurationOutputActuator class 108 3 45 1 Properties 108 3 45 2 Methods 110 3 46 ConfigurationOutputActuatorConditions class 110 3 46 1 Methods 110 3 47 ConfigurationOutputActuatorCondition class 112 3 47 1 Properties 112 3 47 2 Methods 113 3 48 ConfigurationTrafficLight class 114 3 48 1 Properties 114 3 48 2 Methods 115 3 49 ConfigurationLights Class 116 3 49 1 M...

Page 7: ...Type 124 3 62 VLConditionOperatorType Type 125 4 Communications protocol 126 4 1 Message format 127 4 2 Message version 128 4 3 Compatibility between QuercusVL products 130 4 4 Initial concepts 132 4 4 1 Units 132 4 4 2 Booleans 132 4 4 3 Coordinates 132 4 5 Common structures 132 4 5 1 Timestamp 132 4 5 2 Region 133 4 5 3 DetectorHeader 133 4 5 4 SpeedDetector 134 4 5 5 QueueDetector 135 4 5 6 Pre...

Page 8: ...tatusQuery 146 4 7 4 IOQuery 147 4 7 5 ImageQuery 147 4 7 6 SnapshotQuery 148 4 7 7 UnitTasksQuery 150 4 7 8 DetectorTasksQuery 151 4 7 9 DetectorsCountQuery 151 4 7 10 DetectorInformationQuery 152 4 7 11 TrafficLightsCountQuery 154 4 7 12 TrafficLightInformationQuery 154 4 7 13 SetUnitTasksQuery 155 4 7 14 SetDetectorTasksQuery 156 4 7 15 OutputQuery 156 4 7 16 RebootQuery 157 4 7 17 VideoQuery 1...

Page 9: ...yChanges 168 4 9 16 DiscardChanges 169 4 9 17 Restart 169 4 9 18 GetEntriesCount 170 4 9 19 GetEntry 171 4 9 20 SetEntry 171 4 9 21 RestoreEntry 172 4 9 22 GetDetectorsCount 172 4 9 23 RemoveDetector 173 4 9 24 GetDetector 174 4 9 25 SetPresenceDetector 175 4 9 26 SetQueueDetector 176 4 9 27 SetRedLightDetector 177 4 9 28 SetSpeedDetector 178 4 9 29 SetStoppedCarDetector 178 4 9 30 GetTrafficLight...

Page 10: ...ector 189 5 1 6 TrafficLight 190 5 1 7 RedLightDetector 190 5 1 8 StoppedCarDetector 192 5 2 Event messages 193 5 2 1 IncidenceInformation 193 5 3 Query messages 193 5 3 1 SnapshotQuery 193 5 3 2 DetectorInformationQuery 194 5 3 3 TrafficLightInformationQuery 194 5 4 Configuration messages 195 5 4 1 SystemInfo 195 5 4 2 GetDetector 195 5 4 3 SetPresenceDetector 195 5 4 4 SetQueueDetector 196 5 4 5...

Page 11: ...ile 205 7 1 2 Detectors configuration file 206 7 1 2 1 Globals section 206 7 1 2 2 DetectorX section 207 7 1 2 3 TrafficLight_X section 208 7 1 2 4 LightX_Y section 208 7 2 Simulation configuration 208 7 2 1 Vehicle movement event 210 7 2 1 1 Instruction structure 210 7 2 1 2 Example 211 7 2 2 Digital input event 211 7 2 2 1 Instruction structure 211 7 2 2 2 Example 212 7 2 3 Traffic light event 2...

Page 12: ... summary 217 8 1 1 3 Speed summary 219 8 1 1 4 Red light incidence 221 8 1 1 5 Stopped car incidence 223 8 1 2 JPEG file 226 8 1 3 AVI file 226 8 2 Protocol encryption 226 8 2 1 Encryption format 227 8 2 2 SFTP server 228 9 Annex F Support 229 Quercus Technologies ...

Page 13: ...sVL family products which SmartLoop and BirdWatch belong to Although they have different functionalities booth of them are based on virtual loop technology As a result they use the same protocol of communications library and software tools Quercus Technologies 13 ...

Page 14: ...ystems Function library in C Dynamically linked library for Windows and GNU Linux that provides an object oriented vision to functions of the system As in the case of the C library the source code of a proxy in a fully portable C language is provided with the library which can be used with any C compiling program It also manages the simultaneous and transparent communications with various lanes Al...

Page 15: ... a dynamically linked library which includes all the functionalities of the system We must take into account that even though there are different layers in the system they do not add any noticeable overhead to the system s operation even in machines with a low performance So programming on top of the C or C libraries is equally efficient Quercus Technologies 15 Client computer Client application P...

Page 16: ...the corresponding method OnRealTimeInformation in this case Take into account that these methods will be called from execution threads which are different from the main one so code that is not safe about threads or unable to be executed out of the main thread cannot not be used for the implementation A short C program is shown next which is capable of capturing events It corresponds to the basic C...

Page 17: ... inc get_Video get_Duration inc get_Video get_Framerate else printf Video NOT FOUND n virtual void OnSummary Summary sum printf OnSummary d d sum get_Unit get_Id sum get_DetectorId switch sum get_DetectorType case DT_SPEED printf DT_SPEED n break case DT_QUEUE printf DT_QUEUE n break case DT_PRESENCE printf DT_PRESENCE n break default break CEventHandler EventHandler int main int argc char argv if...

Page 18: ...ing with units configured at initialization file Central ini The file Central log stores system logs As you can see the previously created object CEventHandler is passed to the library as a parameter so that the library can call its methods when necessary From now on if you start the simulators TSSimu or RLSimu or the system has been configured to communicate with real units the events generated w...

Page 19: ...e function returns it would call the object s copy destructor and this is dangerous specially if the object internally contains pointers In VL library all these caveats have been solved as the object s copy constructor is only 4 bytes of memory and at the destruction of the object s copy the real object is never destroyed while there is any copy still to destroy detectorA unit get_Detectors Item 0...

Page 20: ...ation directory Copyright C 2011 Quercus Technologies All rights reserved include stdio h include VLWrapperC h typedef enum DT_ALL 0 DT_SPEED 1 DT_QUEUE 2 DT_PRESENCE 3 DT_RED_LIGHT 4 DT_STOPPED_CAR 5 VLDetectorType void __stdcall OnRealTimeInformation int info printf OnRealTimeInformation d d VL_Unit_get_Id VL_RealTimeInformation_get_Unit info VL_RealTimeInformation_get_DetectorId info switch VL_...

Page 21: ...c void __stdcall OnSummary int sum Implementation of client code that will run with the events The functions must have exactly the same format defined at header file VLWrapperC h otherwise will fail at compilation time If you are not interested in any of the events you don t need to implement it if VLLoad 0 return 1 Load of VL library if VL_System_Initialize Central ini Central log OnRealTimeInfor...

Page 22: ...ion Class_Release must be called see Release method The parameter h is a handler of the class Release C void Class_Release int h The function decreases a reference to the object and frees the allocated memory if the number of references reach 0 It should be called when the object to which a reference was added see AddRef is no longer needed or when an object that was obtained calling a function th...

Page 23: ... folder Set CApi_Basic as active project Build the executable Linux Open a console Go to folder Samples CApi_Basic Type make command 2 3 Other examples At Installation folder Samples you will find more VL sample code The named folder also contains a Readme txt file describing each sample code Quercus Technologies 23 ...

Page 24: ...roducts so there are parts in it functions classes events not applicable to every product The following table describes classes events and types useful for each unit type SmartLoop TS SmartLoop TS Plus BirdWatch RL BirdWatch RL Plus Events OnRealTimeInformation OnSummary OnIncidence OnNotification OnInputChange Classes System Units Unit UnitStatus VersionInformation Detectors Detector PresenceDete...

Page 25: ...figurationDetector ConfigurationPresenceDetector ConfigurationQueueDetector ConfigurationSpeedDetector ConfigurationRedLightDetector ConfigurationStoppedCarDetector ConfigurationTrafficLight ConfigurationLights ConfigurationLight ConfigurationOutputActuator ConfigurationOutputActuatorCondition ConfigurationOutputActuatorConditions SystemInformation SettingEntry Types VLDetectorType VLNotificationC...

Page 26: ...al traffic light Summary the logical representation of a summary Incidence the logical representation of an incidence Take into account that for every modification in the configuration of a unit the hierarchy of Detector and TrafficLight objects is regenerated starting from zero Therefore when you want to make continued use of these objects you must save a reference to it in order that it will not...

Page 27: ...g the same VL_Detector_Release detector Releasing the detector 3 3 Classes In C and C you need to call VLLoad function to load the library before any other call and VLUnload at the end of program execution after the last call to library functions to unload the library All boolean values documented for C library are translated to C library as C C True Integer different from 0 False 0 3 4 System Cla...

Page 28: ...EH systemEH C int VL_System_Initialize const char iniFile const char logFile VL_ISYSTEMEH_ONREALTIMEINFORMATION VL_ISYSTEMEH_ONINCIDENCE VL_ISYSTEMEH_ONSUMMARY VL_ISYSTEMEH_ONNOTIFICATION VL_ISYSTEMEH_ONINPUTCHANGE Initialize the system with the specified configuration and log files Returns true if the system initialized successfully and false otherwise In C the function expects path and name of c...

Page 29: ...of the function scope VL_RealTimeInformation_AddRef should be called to add a reference see method AddRef from RealTimeInformation class and VL_RealTimeInformation_Release to remove the reference and free the allocated memory when it is no longer needed see Release method from RealTimeInformation class OnIncidence C void OnIncidence Incidence incidence C void VL_OnIncidence int hIncidence Event la...

Page 30: ...a real time event The parameter hNotification receives event data check Notification class In C the parameter hNotification is a handler of Notification In C and C the parameter Notification is only valid inside function scope OnInputChange C void OnInputChange Unit unit int bit bool value C void VL_OnInputChange int unit int bit bool value Event launched when a programmed input and configured to ...

Page 31: ...g from zero Id C Unit Id int id C Does not exist check VL_System_get_Units_Id from System Returns the unit with identifier id specified inside the units collection If there is no unit with such identifier returns an invalid unit see IsValid from Unit class 3 6 Unit Class Represents one unit 3 6 1 Properties Id C int get_Id C int VL_Unit_get_Id int h Unique unit identifier In C the parameter h is a...

Page 32: ...cess to collection properties int VL_Unit_get_Detectors_Count int h returns the number of detectors in unit h int VL_Unit_get_Detectors_Item int h int item returns the detector located at the indicated position in the detector s collection of unit h starting from zero The parameter h is a handler of unit Unit If there is no detector at the specified position returns null When the detector is no lo...

Page 33: ...ficLight_Release must be called to free allocated memory see Release method at TrafficLight class int VL_Unit_get_TrafficLights_Id int h int id returns the TrafficLight identified by id inside the TrafficLights collection in the unit h The parameter h is a handler of unit Unit If there is no TrafficLights with such id returns null When the traffic light is no longer needed VL_TrafficLight_Release ...

Page 34: ... int numRedLights int redLights int inputValues int outputValues C int VL_Unit_GetSnapshot int h int roiRight int roiTop int roiLeft int roiBottom int exposureTime int zoom int maxSize unsigned char pImageData int imageLen int focus int numDetectors int detectors int numRedLights int redLights int inputValues int outputValues Makes a snapshot of the unit Returns a complete status report of detecto...

Page 35: ... camera exposure time for the snapshot bool zoom indicates if the obtained image must be captured by the unit false or a magnified one true int maxSize sets the size of the pImageData buffer This is a security parameter if the buffer size is not big enough it will not be filled up and it will return false Output parameters unsigned char pImageData pointer where the captured image will be stored It...

Page 36: ...ActivateOutput int bit int time C int VL_Unit_ActivateOutput int h int bit int time Enables the digital output bit for the time specified in milliseconds In C the parameter h is a handler of unit Unit GetIOValues C bool GetIOValues int inputValues int outputValues C int VL_Unit_GetIOValues int h int inputValues int outputValues Informs about the status of the digital inputs and outputs Each one of...

Page 37: ...UnitTasks int h int sendInputChanges Sets the status of unit tasks The unit will inform the central system about the changes in digital inputs if sendInputChanges is true if false not Returns true if the query was successful or false otherwise In C the parameter h is a handler of unit Unit SetDetectorTasks C bool SetDetectorTasks int id bool enableSummaries bool enableIncidences bool sendSummaries...

Page 38: ...TimeInformation Informs about the status of the indicated id detector tasks Returns true if the query was successful or false otherwise In C the parameter h is a handler of unit Unit 3 7 UnitStatus Class Status of the unit 3 7 1 Properties Global C bool get_Status C int VL_UnitStatus_get_Status int h Global status of the unit Returns true if unit s system status is correct false otherwise In C the...

Page 39: ...VersionInformation_get_Major int h Informs about the Major value of the version In C the parameter h is a handler of version VersionInformation Minor C int get_Minor C int VL_VersionInformation_get_Minor int h Informs about the Minor value of the version In C the parameter h is a handler of version VersionInformation Revision C int get_Revision C int VL_VersionInfo_get_Revision int h Informs about...

Page 40: ...zero If there is no Detector for the specified position returns an invalid one see IsValid from Detector class Id C Detector Id int id C Does not exist check VL_Unit_get_Detectors_Id int h int id of Unit Returns the detector identified by id inside the detectors collection of the unit If there is no Detector for the specified identifier returns an invalid one see IsValid from Detector class 3 10 D...

Page 41: ... C int VL_Detector_get_AreIncidencesEnabled int h Returns true if the generation of incidences is enabled false if disabled In C the parameter h is a handler of detector Detector AreSummariesEnabled C bool get_AreSummariesEnabled C int VL_Detector_get_AreSummariesEnabled int h Returns true if the generation of summaries is enabled false if disabled In C the parameter h is a handler of detector Det...

Page 42: ...C int VL_Detector_get_SummariesPeriod int h Returns the summaries period setting in minutes In C the parameter h is a handler of detector Detector Coordinates C Region get_Coordinates C int VL_Detector_get_Coordinates int h Returns the coordinates of the detector In C the parameter h is a handler of detector Detector LoopsCoordinates C Regions get_LoopsCoordinates C Does not exist In C returns the...

Page 43: ... about a detector and false if invalid Some methods may sometimes return void Detectors In C this behaviour is detected as its value will be 0 In C however this method is necessary because the object as it is not a pointer would always be valid AddRef C Does not exist C void VL_Detector_AddRef int h See 2 2 1 Memory management Release C Does not exist C void VL_Detector_Release int h See 2 2 1 Mem...

Page 44: ...has implemented the assignment operator to use a generic detector as a queue detector Example in C if detector get_Type DT_QUEUE QueueDetector myQueueDetector myQueueDetector detector assignment operator ProcessQueueDetector myQueueDetector Example in C if Detector_get_Type hDetector DT_QUEUE ProcessQueueDetector hDetector 3 13 SpeedDetector Class Logic representation of a detector of speed type T...

Page 45: ...tor Distance C int get_Distance C int VL_SpeedDetector_get_Distance int h Returns the distance from the camera to the detector in millimetres In C the parameter h is a handler of detector SpeedDetector Length C int get_Length C int VL_SpeedDetector_get_Length int h Returns the length of the detector in millimetres In C the parameter h is a handler of detector SpeedDetector 3 14 RedLightDetector Cl...

Page 46: ...Returns true if the detector is enabled to calculate the metrics In C the parameter h is a handler of detector RedLightDetector Distance C int get_Distance C int VL_RedLightDetector_get_Distance int h Returns the distance from the camera to the detector in millimetres In C the parameter h is a handler of detector RedLightDetector Length C int get_Length C int VL_RedLightDetector_get_Length int h R...

Page 47: ..._RedInput int h Returns the identifier of the digital input used for the red state sign If no input has been configured but a traffic light see TrafficLightId from RedLightDetector it will return 1 In C the parameter h is a handler of detector RedLightDetector AmberInput C int get_AmberInput C int VL_RedLightDetector_get_AmberInput int h Returns the identifier of the digital input used for the amb...

Page 48: ... LastPictureDelayTimeMs C int get_LastPictureDelayTimeMs C int VL_RedLightDetector_get_LastPictureDelayTimeMs int h Returns the time that the last picture of incidence will be delayed in miliseconds In C the parameter h is a handler of detector RedLightDetector 3 15 Class StoppedCarDetector Logic representation of a detector of stopped car type This class derives from Detector class so all its met...

Page 49: ...nal If no traffic light is configured but a digital input check RedInput from StoppedCarDetector it will return 1 In C the parameter h is a handler of detector StoppedCarDetector RedInput C int get_RedInput C int VL_StoppedCarDetector_get_RedInput int h Returns the digital input identifier used as stop signal If no digital input is configured but a traffic light see TrafficLightId from StoppedCarD...

Page 50: ...andler of detector StoppedCarDetector 3 16 TrafficLights Class Collection of configured traffic lights in a unit 3 16 1 Properties Count C int Count C Does not exist check VL_Unit_get_TrafficLights_Count int h of Unit Number of traffic lights in the unit Item C TrafficLight Item int item C Does not exist check VL_Unit_get_TrafficLights_Item int h int item of Unit Returns the traffic light in the i...

Page 51: ...ed in a traffic light will be defined in a 5 megapixel image from 0 to 2559 and from 0 to 1919 3 17 1 Properties UnitId C Unit get_Unit C int VL_TrafficLight_get_UnitId int h Returns the unit where the traffic light belongs to In C the parameter h is a handler of the traffic light TrafficLight Id C int get_Id C int VL_TrafficLight_get_Id int h Returns the traffic light identifier In C the paramete...

Page 52: ...m zero If there is no Light for the specified ligt returns null The parameter h is a handler of the traffic light TrafficLight 3 17 2 Methods IsValid C bool IsValid C Does not exist Returns true if the object contains valid information about a traffic light and false if invalid Some methods may sometimes return void traffic lights In C this behaviour is detected as its value will be 0 In C however...

Page 53: ...ndler of incidences record HistoricIncidences Returns a handler of the incidence Incidence In C when the object is no more needed the function VL_Incidence_Release must be called see Release method from Incidence class In C if there is no available incidence returns null 3 18 2 Methods MoveFirst C void MoveFirst C void VL_HistoricIncidences_MoveFirst int h Assigns to Current property the informati...

Page 54: ...erty the information of the record s last incidence that complies with the applied filter see the method SetFilter from HistoricIncidences class In C the parameter h is a handler of incidences record HistoricIncidences SetFilter C void SetFilter VLDetectorType detectorType int detectorId C void VL_HistoricIncidences_SetFilter int h int detectorType int detectorId Sets a filter on the incidences re...

Page 55: ...more needed the function VL_Summary_Release must be called see Release method from Summary class In C if there is no available summary returns null 3 19 2 Methods MoveFirst C void MoveFirst C void VL_HistoricSummaries_MoveFirst int h Assigns to Current property the information of the record s first summary that complies with the applied filter see the method SetFilter from HistoricSummaries class ...

Page 56: ... summary record HistoricSummaries SetFilter C void SetFilter VLDetectorType detectorType int detectorId C void VL_HistoricSummaries_SetFilter int h int detectorType int detectorId Sets a summary record filter in a way that only the summaries that comply with the requirements will be selectable The filter is defined with the variables detectorType type of detector DetectorId identifier of detector ...

Page 57: ...C the parameter h is a handler of real time information RealTimeInformation Timestamp C Timestamp get_Timestamp C Does Not exist In C returns the timestamp when unit generated the real time info In C there is no representation of Timestamp class but methods to directly access to class properties int VL_RealTimeInformation_get_Timestamp_Seconds int h date and time when the real time info was genera...

Page 58: ...nt get_Length C int VL_RealTimeInformation_get_Length int h Returns the length of the detected vehicle in millimetres If length calculation was not possible the value will be 1 In C the parameter h is a handler of real time information RealTimeInformation Occupation C int get_Occupation C int VL_RealTimeInformation_get_Occupation int h Returns the occupation of a queue detector percent rate In C t...

Page 59: ...nter would always be valid AddRef C Does not exist C void VL_RealTimeInformation_AddRef int h Ver 2 2 1 Memory management Release C Does not exist C void VL_RealTimeInformation_Release int h Ver 2 2 1 Memory management 3 21 Regions Class Collection of coordinates which define each detector loop 3 21 1 Properties Count C int Count C Does not exist check VL_Detector_get_LoopsCoordinates_Count int h ...

Page 60: ...nvalid one see IsValid from Region class 3 22 Region Class Define the coordinates of each vertex of a rectangle 3 22 1 Properties X1 C int get_X1 C int VL_Region_get_X1 int h Returns the X value horizontal axis of vertex 1 In C the parameter h is a handler of the region Region Y1 C int get_Y1 C int VL_Region_get_Y1 int h Returns the Y value vertical axis of vertex 1 In C the parameter h is a handl...

Page 61: ...int get_Y3 C int VL_Region_get_Y3 int h Returns the Y value vertical axis of vertex 3 In C the parameter h is a handler of the region Region X4 C int get_X4 C int VL_Region_get_X4 int h Returns the X value horizontal axis of vertex 4 In C the parameter h is a handler of the region Region Y4 C int get_Y4 C int VL_Region_get_Y4 int h Returns the Y value vertical axis of vertex 4 In C the parameter h...

Page 62: ...cLight Number of lights in the traffic light Item C Light Item int item C Does not exist check VL_TrafficLight_get_Lights_Item int h int item of TrafficLight Returns the light in the indicated position inside the lights collection of a traffic light The location of a light inside the collection follows the configuration order In C the parameter item must specify the position starting from zero If ...

Page 63: ...t_Radius int h Returns the radius of the traffic light s light in the image in pixels In C the parameter h is a handler of the light Light 3 24 2 Methods IsValid C bool IsValid C does not exist Returns true if the object contains valid information about a light and false is the information is not valid Some functions may sometimes return void units In C this behaviour is detected as its value will...

Page 64: ...ype C int VL_Incidence_get_DetectorType int h Returns the type of detector that generated the incidence In C the parameter h is a handler of the incidence Incidence Id C int get_Id C int Incidence_get_Id int h Returns the incidence identifier In C the parameter h is a handler of the incidence Incidence Type C VLIncidenceType get_Type C int VL_Incidence_get_Type int h Returns the type of incidence ...

Page 65: ...dence Incidence AmberLightTime Returns the elapsed time with the amber light on before turning into red C int get_AmbertLightTime C int VL_Incidence_get_AmbertLightTime int h Devuelve el tiempo transcurrido con la señal de ámbar activa antes de la activación de prohibición de paso que ha generado la incidencia en milisegundos En C el parámetro h es un manejador de la incidencia Incidence MaxStopTi...

Page 66: ...the collection of incidence images starting from zero If there is no imaage at the specified position returns null In C if the object is no more needed the function VL_Image_Release must be called see Release method from Image In C the parameter h is a handler of the incidence Incidence Video C Video get_Video C int VL_Incidence_get_Video int h Returns the generated video of the incidence In C if ...

Page 67: ...es not exist C void VL_Incidence_Release int h See 2 2 1 Memory management 3 26 Images Class Collection of images of an incidence 3 26 1 Properties Count C int Count C Does not exist check VL_Incidence_get_Images_Count int h from Incidence Amount of images in the collection Item C Image Item int item C Does not exist check VL_Incidence_get_Images_Item int h int item Returns the image in the indica...

Page 68: ...t will not be filled up and will return 1 In C the parameter h is a handler of the image Image Timestamp C Timestamp get_Timestamp C Does not exist In C returns the time stamp when the unit captured the picture In C there is no representation of Timestamp class but methods to directly access to its properties int VL_Image_get_Timestamp_Seconds int h date and time when the picture was taken showing...

Page 69: ...8 Video Class Logical representation of an incidence video recording 3 28 1 Properties Location C int Location char pBuffer int bufferLen C int VL_Video_get_Location int h char pBuffer int maxSize provides the absolute path of the video file in the unit at text string pBuffer ending with character 0 You need to set the buffer size at maxSize Returns the number of characters in the string In C the ...

Page 70: ... capture In C there is no representation of TimeStamp class but methods to directly access to its properties int VL_Video_get_EndTimestamp_Seconds int h date and time when the video recording stopped showing the number of seconds elapsed since 00 00 hours on the first of January of 1970 It is the same format that is returned at the call to function time_t time time_t timer from ANSI C standard The...

Page 71: ...the parameter h is a handler of video Video 3 28 2 Methods IsValid C bool IsValid C Does not exist Returns true if the object contains valid information about a video and false if invalid Some methods may sometimes return void videos In C this behaviour is detected as its value will be 0 In C however this method is necessary because the object as it is not a pointer would always be valid AddRef C ...

Page 72: ...d the summary In C the parameter h is a handler of summary Summary DetectorType C VLDetectorType get_DetectorType C int VL_Summary_get_DetectorType int h Returns the detector type that generated the summary In C the parameter h is a handler of summary Summary Begin C int get_Begin C int VL_Summary_get_Begin int h Returns the time stamp when summary data collection started in seconds elapsed since ...

Page 73: ... of vehicles in the summary in km h If speed calculation was not possible returns 1 In C the parameter h is a handler of summary Summary AvgLength C int get_AvgLength C int VL_Summary_get_AvgLength int h Returns the average length of vehicles in the summary in millimetres If length calculation was not possible returns 1 In C the parameter h is a handler of summary Summary AvgHeadway C int get_AvgH...

Page 74: ...es not exist In C returns the collection of values making up distribution of lengths in the summary In C there is no representation of LengthsDistribution collection but methods to directly access to collection properties int VL_Summary_get_LengthsDistribution_Count int h number of values making up distribution of lengths in the summary int VL_Summary_get_LengthsDistribution_Item int h int item re...

Page 75: ...y_get_SpeedsUpperLimit_Count int h number of values making up the ranges of distribution of speeds in the summary int VL_Summary_get_SpeedsUpperLimit_Item int h int item returns the value in the indicated position inside the collection of values making up the ranges of distribution of speeds in the summary starting from zero If there is no SpeedsUpperLimit at the specified position it returns null...

Page 76: ...upancies in the summary int VL_Summary_get_OccupationsUpperLimit_Item int h int item returns the value in the indicated position inside the collection of values making up the ranges of distribution of occupancies in the summary starting from zero If there is no OcupationsUpperLimit at the specified position it returns null The parameter h is a handler of summary Summary 3 29 2 Methods IsValid C bo...

Page 77: ...int item from Summary Returns the percentage in the indicated position within the collection of percentages of vehicles that have circulated through a detector for a given speed range The location of each value in the collection corresponds with the order of ranges in the collection SpeedsUpperLimit of the detector The parameter item must specify the position starting from zero If there is no Spee...

Page 78: ... of ranges in the collection LengthsUpperLimit of the detector The parameter item must specify the position starting from zero If there is no LengthsDistribution at the specified position it returns an invalid one see IsValid from LengthsDistribution class 3 32 OccupationsDistribution Class Collection of time percentages that a detector has been occupied for a given occupancy range These ranges ar...

Page 79: ...n of values making up the speed ranges of a detector For deeper information about speed distribution see SmartLoop user manual 3 33 1 Properties Count C int Count C Does not exist check VL_Summary_get_SpeedsUpperLimit_Count int h de Summary Number of values in the collection Item C int Item int item C Does not exist check VL_Summary_get_SpeedsUpperLimit_Item int h int item from Summary Returns the...

Page 80: ...ion of values making up the length ranges of a detector The values are sorted from lowest to highest placing the smallest value at the first position in the collection The parameter item must specify the position starting from zero If there is no LengthsUpperLimit at the specified position it returns an invalid one see IsValid from LengthsUpperLimit class 3 35 OccupationsUpperLimit Class Collectio...

Page 81: ... invalid one see IsValid from OccupationsUpperLimit class 3 36 Timestamp Class Definition of timestamp 3 36 1 Properties Seconds C int get_Seconds C Does not exist check class_get_Timestamp_Seconds int h where class is the class referenced by Timestamp Date and time of the timestamp showing the seconds elapsed since 00 00 hours on the first of January of 1970 It is the same format that is returned...

Page 82: ... 3 38 Configuration Class Class that gives access to unit s configuration system 3 38 1 Methods IsValid C bool IsValid C Does not exist Returns true if the object contains valid information about the configuration system false otherwise Login C bool Login const char password C int VL_Configuration_Login int h const char password Provides access to unit s configuration system The parameter password...

Page 83: ...d Changes the password of the unit The change will be effective when changes are applied newPassword must be a text string ending with 0 Returns true for a successful operation otherwise returns false In C the parameter h is a handler of Configuration SyncTime C bool SyncTime C int VL_Configuration_SyncTime int h Synchronizes date and time using protocol and server specified in configuration Retur...

Page 84: ...irmware Returns true for a successful operation otherwise returns false In C the parameter h is a handler of Configuration ExportLog C bool ExportLog VLLogSystem logType const char fileName C int VL_Configuration_ExportLog int h int logType const char fileName Exports log file type specified in logType see 3 60 VLLogSystem Type and saves it at the root of unit s ftp server named as fileName Return...

Page 85: ... the nth variable of unit s configuration system In C if the SettingsEntry indicated does not exist returns an invalid one in C returns null In C when the object is needed no more the function VL_SettingsEntry_Release must be called see Release method from SettingsEntry class In C the parameter h is a handler of Configuration and returns a handler of SettingsEntry GetEntry C SettingsEntry GetEntry...

Page 86: ...false In C the parameter h is a handler of Configuration ApplyChanges C bool ApplyChanges C int VL_Configuration_ApplyChanges int h Applies changes made in unit s configuration system and reboots the unit Returns true for a successful operation otherwise returns false In C the parameter h is a handler of Configuration DiscardChanges C bool DiscardChanges C int VL_Configuration_DiscardChanges int h...

Page 87: ...PresenceDetector C int VL_Configuration_New_PresenceDetector int h Creates a new presence detector default values To add a new presence detector to the unit this function must be used to later on modify the named detector and add it to the system with the function ApplyDetector of Configuration class In C the parameter h is a handler of Configuration NewQueueDetector C ConfigurationQueueDetector N...

Page 88: ...on ApplyDetector of Configuration class In C the parameter h is a handler of Configuration NewStoppedCarDetector C ConfigurationStoppedCarDetector NewStoppedCarDetector C int VL_Configuration_New_StoppedCarDetector int h Creates a new stopped car detector default values To add a new stopped car detector to the unit this function must be used to later modify the detector and add it to the system us...

Page 89: ...he unit s detector list which is specified by one of the following two parameters Index position of the detector in the list of detectors of the unit Id detector s identifier Only one of them can be used in the parameter not used 1 must be indicated Returns true if deletion was successful false otherwise In C the parameter h is a handler of Configuration ApplyDetector C bool ApplyDetector Configur...

Page 90: ... the number of configured traffic lights In C the parameter h is a handler of Configuration GetTrafficLight C ConfigurationTrafficLight GetTrafficLight int index int id C int VL_Configuration_Get_TrafficLight int h int index int id Returns a traffic light from the unit s traffic light list which is specified by one of the following two parameters Index position of the traffic light the list of tra...

Page 91: ...new traffic light into the unit s traffic light list or modifies an existing one The action done will depend on the parameter action see 3 61 VLConfigurationActionType Type type If an existing traffic light is going to be modified the old identifier must be specified as it may have been modified with the parameter previousId If it is a new traffic light which is going to be joined then use value 1...

Page 92: ...no ConfigurationOutputActuator with the specified index position returns an invalid one in C returns null In C when the object is needed no more the function VL_ConfigurationOutputActuator_Release must be called see Release method from ConfigurationOutputActuator class In C the parameter h is a handler of Configuration DeleteOutputActuator C bool DeleteOutputActuator int index int id C int VL_Conf...

Page 93: ...tActuator a handler of ConfigurationOutputActuator SetLanguage C bool SetLanguage const char languageId C int Configuration_SetLanguage int h const char languageId Sets the language of the configuration system indicated as a 2 character code ISO 639 1 ending with the character 0 Returns true if it it has been possible to carry out the operation and false if not The parameters C In C the parameter ...

Page 94: ...rameter h is a handler of ConfigurationDetector C void put_Id int id C void VL_ConfigurationDetector_put_Id int h int id Modifies the identifier The new value is set by parameter id In C the parameter h is a handler of ConfigurationDetector Type C VLDetectorType get_Type C int VL_ConfigurationDetector_get_Type int h Returns the detector type See 3 56 VLLightType Type In C the parameter h is a hand...

Page 95: ...abled int h Returns the status of summaries generation In C the parameter h is a handler of ConfigurationDetector C void put_AreSummariesEnabled bool value C void VL_ConfigurationDetector_put_AreSummariesEnabled int h int n True to enable the generation of summaries in the detector false otherwise In C the parameter h is a handler of ConfigurationDetector SendRealTimeInformation Shows if real time...

Page 96: ...d VL_ConfigurationDetector_put_SendIncidences int h int n True to enable sending generated incidences in the detector false otherwise In C the parameter h is a handler of ConfigurationDetector SendSummaries Sows if sending generated summaries is enabled If disabled the unit will not send to the central system the generated summaries in the detector C bool get_SendSummaries C int VL_ConfigurationDe...

Page 97: ...onfigurationDetector Coordinates Detector coordinates C Region get_Coordinates C int VL_ConfigurationDetector_get_Coordinates int h Returns the detector coordinates In C the parameter h is a handler of ConfigurationDetector C void put_Coordinates int x1 int y1 int x2 int y2 int x3 int y3 int x4 int y4 C void ConfigurationDetector_put_Coordinates int h int x1 int y1 int x2 int y2 int x3 int y3 int ...

Page 98: ...gurationDetector Class 3 41 ConfigurationQueueDetector class Represents a queue detector of the configuration system This class derives from ConfigurationDetector see 3 39 ConfigurationDetector Class 3 42 ConfigurationSpeedDetector class Represents a speed detector of the configuration system This class derives from ConfigurationDetector see 3 39 ConfigurationDetector Class 3 42 1 Properties Calcu...

Page 99: ...ector_get_Distance int h Returns the distance from the unit to the detector In C the parameter h is a handler of ConfigurationDetector C void put_Distance bool value C void VL_ConfigurationSpeedDetector_put_Distance int h int n Modifies the distance from the unit to the detector In C the parameter h is a handler of ConfigurationDetector Length Detector s length in milimeters C int get_Length C int...

Page 100: ...atus of speed and length calculation In C the parameter h is a handler of ConfigurationDetector C void put_CalculateMetrics bool value C void VL_ConfigurationRedLightDetector_put_CalculateMetrics int h int n True to enable speed and length calculation false otherwise In C the parameter h is a handler of ConfigurationDetector Distance Distance from the unit to the detector in milimeters C int get_D...

Page 101: ...arameter h is a handler of ConfigurationDetector DelayTime Daly time for the detector in miliseconds C int get_DelayTime C int VL_ConfigurationRedLightDetector_get_DelayTime int h Returns the delay time for the detector In C the parameter h is a handler of ConfigurationDetector C void put_DelayTime int value C void VL_ConfigurationRedLightDetector_put_DelayTime int h int n Modifies the delay time ...

Page 102: ...al If a configured traffic litght is used the value will be 1 C int get_RedInput C int VL_ConfigurationRedLightDetector_get_RedInput int h Returns the digital input identifier In C the parameter h is a handler of ConfigurationDetector C void put_RedInput int value C void VL_ConfigurationRedLightDetector_put_RedInput int h int n Modifies the digital input identifier In C the parameter h is a handle...

Page 103: ...deoEnabled C int VL_ConfigurationRedLightDetector_get_IsVideoEnabled int h Returns the status of video generation In C the parameter h is a handler of ConfigurationDetector C void put_IsVideoEnabled bool value C void VL_ConfigurationRedLightDetector_put_IsVideoEnabled int h int n Modifies the status of video generation In C the parameter h is a handler of ConfigurationDetector PreVideoTimeMs Time ...

Page 104: ...void put_PostVideoTimeMs int value C void VL_ConfigurationRedLightDetector_put_PostVideoTimeMs int h int n Modifies the delay time In C the parameter h is a handler of ConfigurationDetector LastPictureDelayTimeMs Time that the last picture of incidence will be delayed in miliseconds C int get_LastPictureDelayTimeMs C int VL_ConfigurationRedLightDetector_get_LastPictureDelayTimeMs int h Returns the...

Page 105: ...h is a handler of ConfigurationDetector C void put_MaxStopTime int value C void VL_ConfigurationStoppedCarDetector_put_MaxStopTime int h int n Modifies the minimum stop time at the detector in order to generate an incidence in miliseconds In C the parameter h is a handler of ConfigurationDetector TrafficLightId Identifier of the traffic light linked with the detector If using digital input its val...

Page 106: ...ut_RedInput int h int n Modifies the digital input identifier In C the parameter h is a handler of ConfigurationDetector IsVideoEnabled Shows if video generation at the units is enabled If disabled the unit will not generate videos at the detector incidences C bool get_IsVideoEnabled C int VL_ConfigurationStoppedCarDetector_get_IsVideoEnabled int h Returns the state of video generation In C the pa...

Page 107: ... handler of ConfigurationDetector PostVideoTimeMs Time that the stop of the video recording will be delayed in miliseconds C int get_PostVideoTimeMs C int VL_ConfigurationStoppedCarDetector_get_PostVideoTimeMs int h Returns the delay time In C the parameter h is a handler of ConfigurationDetector C void put_PostVideoTimeMs int value C void VL_ConfigurationStoppedCarDetector_put_PostVideoTimeMs int...

Page 108: ...ditionOperatorType Type C VLConditionOperatorType get_Operator C int VL_ConfigurationOutputActuator_get_Operator int h Returns the operator In C the parameter h is a handler of ConfigurationOutputActuator C void put_Operator VLConditionOperatorType value C void VL_ConfigurationOutputActuator_put_VLConditionOperatorType int h int operator Modifies the output actuator s operator In C the parameter h...

Page 109: ...ConfigurationOutputActuator_get_Time int h Returns the time duration of digital output activation In C the parameter h is a handler of ConfigurationDetector C void put_Time int value C void VL_ConfigurationOutputActuator_put_Time int h int t Modifies the time duration of digital output activation In C the parameter h is a handler of ConfigurationDetector 3 45 2 Methods IsValid C bool IsValid C Doe...

Page 110: ...Item int item C Does not exist check VL_ConfigurationOutputActuator_get_Conditions_Item from ConfigurationOutputActuator Returns the condition in the specified position inside the conditions collection of the output actuator If there is no ConfigurationOutputActuatorCondition for the specified position returns an invalid one see IsValid from ConfigurationOutputActuatorCondition class The parameter...

Page 111: ...on class Represents a condition of an output actuator in a configuration system 3 47 1 Properties DetectorId Identifier of the detector associated to the condition C int get_DetectorId C int VL_ConfigurationOutputActuatorCondition_get_DetectorId int h Returns the identifier of the detector associated to the condition In C the parameter h is a handler of ConfigurationOutputActuatorCondition C void ...

Page 112: ... type C VLOperatorType get_Operator C int VL_ConfigurationOutputActuatorCondition_get_Operator int h Returns the conditions s operator In C the parameter h is a handler of ConfigurationOutputActuatorCondition C void put_Operator VLOperatorType value C void VL_ConfigurationOutputActuatorCondition_put_Operator int h int op Modifies the conditions s operator In C the parameter h is a handler of Confi...

Page 113: ...he configuration system For historical reasons all the coordinates described in a detector will be defined in a 5 megapixel image from 0 to 2559 and from 0 to 1919 3 48 1 Properties Id Identifier of the traffic light It must be unique in the list of configured traffic lights in the unit C int get_Id C int VL_ConfigurationTrafficLight_get_Id int h Returns the traffic light identifier In C the param...

Page 114: ...tem int h int item returns the light located at the specified position inside the lights collection of the traffic light starting from zero If there is no ConfigurationLight por the specified position returns null int VL_ConfigurationTrafficLight_get_Lights_Create int h int x int y int radius int type adds a new light to the traffic light with the characteristics specified at function parameters R...

Page 115: ...onTrafficLight_get_Lights_Count of ConfigurationTrafficLight Number of configured lights Item C ConfigurationLight Item int item C Does not exist check VL_ConfigurationTrafficLight_get_Lights_Item of ConfigurationTrafficLight Returns the light located at the specified position inside the lights collection of the traffic light If there is no ConfigurationLight por the specified position returns an ...

Page 116: ...raffic light that has the position index Returns true if deletion was successful false otherwise 3 50 ConfigurationLight class Represents a light that belongs to a traffic light of the configuration system see 3 48 ConfigurationTrafficLight class 3 50 1 Properties Type Type of light see 3 56 VLLightType Type C VLLightType get_Type C int VL_ConfigurationLight_get_Type int h Returns the type of ligh...

Page 117: ... is a handler of ConfigurationDetector Y Position Y vertical axis of the center of the light C int get_Y C int VL_ConfigurationLight_get_Y int h Returns the position Y vertical axis of the light In C the parameter h is a handler of ConfigurationDetector C void put_Y int value C void VL_ConfigurationLight_put_Y int h int n Modifies the position X verticall axis of the light In C the parameter h is ...

Page 118: ...et_Name char buf int bufLen C void VL_SystemInformation_get_Name int h char buf int bufLen Returns the product name The parameter buff is a pointer to a buffer where the name will be written and the buffLen parameter must specifiy the maximum buffer size in bytes In C the parameter h is a handler of Configuration ProductionDate C long get_ProductionDate C long VL_SystemInformation_get_ProductionDa...

Page 119: ...ll be written and the buffLen parameter must specifiy the maximum buffer size in bytes In C the parameter h is a handler of Configuration BootTime C long get_BootTime C long VL_SystemInformation_get_BootTime int h Returns date and time of unit s last boot in number of seconds since 00 00 hours of 1st of January in 1970 In C the parameter h is a handler of Configuration HardwareVersion C VersionInf...

Page 120: ...t bufLen Returns the name of the variable The parameter buff is a pointer to a buffer where the name will be written and the buffLen parameter must specifiy the maximum buffer size in bytes In C the parameter h is a handler of SettingsEntry Value C void get_Value char buf int bufLen C void VL_SettingEntry_get_Value int h char buf int bufLen Returns the current value of the variable The parameter b...

Page 121: ...tingsEntry 3 52 2 Methods IsValid C bool IsValid C Does not exist Returns true if the object contains valid information false otherwise AddRef C Does not exist C void VL_SettingEntry_AddRef int h See 2 2 1 Memory management Release C No existe C void VL_SettingEntry_Release int h See 2 2 1 Memory management 3 53 VLDetectorType Type Specifies the type of detector DT_ALL 0 Any type detector DT_SPEED...

Page 122: ... the type of incidence IT_RED_LIGHT_VIOLATION 1 vehicle violating the red light sign IT_STOPPED_CAR_VIOLATION 2 vehicle stopped in a forbidden zone 3 56 VLLightType Type Specifies the colour of a light in a traffic light LT_RED 0 Red light LT_GREEN 1 Green light LT_AMBAR 2 Amber light LT_OTHER 3 Unknown colour light 3 57 VLFieldType Type Specifies the type of field to be taken into account for the...

Page 123: ...CE_END 3 End of a video 3 60 VLLogSystem Type Specifies the log file type VL_LOG_UNIT 0 Log file of the system VL_LOG_COMBRIDGE 1 Obsolete VL_LOG_CONFIG 2 Log file of the configuration system VL_LOG_FILESYSTEM 3 Log file of drive s filesystem 3 61 VLConfigurationActionType Type Specifies the operation to perfom in the detectors or traffic lights of the configuration system VL_AT_MODIFY_DETECTOR 0 ...

Page 124: ...3 62 VLConditionOperatorType Type Specifies the operator that will define the behaviour of an output actuator COT_ALL 0 All conditions have to be true to activate the digital output COT_ANY 1 One or more conditions have to be true to activate the digital output Quercus Technologies 124 ...

Page 125: ...notify the central system of a happening arrival of an incidence activation of a digital output etc An event must be responded to by the central system within a limited period of time can be modified in the setup with an ACK so that the unit knows that the message has been successfully received Otherwise the message will be sent again until the ACK is received or the maximum number of retries is e...

Page 126: ...uest has been made might not be the response to the request Example of requests and their responses 4 1 Message format Messages will always have the same format Bytes are ordered in all fields with the little endian system Stx 1 byte byte that marks the start of a frame ASCII character 2 Unit Id 4 bytes identifier of the capture unit sending or receiving the message a zero means that this field ha...

Page 127: ...Stx to the last byte in the Message data Etx 1 byte signals the end of the message ASCII character 3 4 2 Message version Messages contain a field version which notes the version of the message used thus enabling the communication protocol to be extended Each version of a specific message can contain a different number of fields and their length can change then it is important to evaluate this fiel...

Page 128: ...it will contain the message version already set This process will be repeated at every unit start up Example On the other hand when the unit receives a request message from the central system always tries to answer with the same message version or NAK type 6 Incorrect version if it is not able to understand the message version Example Quercus Technologies 128 1st Event v2 Unit Central system NAK 6...

Page 129: ...very product This table describes the useful messages and structures for each unit type SmartLoop TS SmartLoop TS Plus BiardWatch RL BiardWatch RL Plus Common structures Region DetectorHeader SpeedDetector QueueDetector PresenceDetector Light TrafficLight RedLightDetector StoppedCarDetector VideoInformation Event messages InputChanged Quercus Technologies 129 Unidad Sistema central Petición v1 NAK...

Page 130: ...etectorInformationQuery TrafficLightsCountQuery TrafficLightInformationQuery SetUnitTasksQuery SetDetectorTasksQuery OutputQuery RebootQuery VideoQuery PingQuery LoginQuery PasswordQuery SyncTimeQuery SetTimeQuery UpdateFirmwareQuery RestoreFirmwareQuery FormatRWPartitionQuery ExportLogQuery SystemInformationQuery ExportStatusQuery ImportConfigurationQuery ExportConfigurationQuery ApplyChangesQuer...

Page 131: ...y GetTrafficLightsCountQuery RemoveTrafficLightQuery GetTrafficLightQuery SetTrafficLightQuery GetOutputActuatorsCountQuery RemoveOutputActuatorQuery GetOutputActuatorQuery SetOutputActuatorQuery Acknowledgement messages ACK NAK 4 4 Initial concepts 4 4 1 Units The size shown for each one of the protocol message fields is expressed in bytes 4 4 2 Booleans Tall boolean values documented in the foll...

Page 132: ...is returned at the call to function time_t time time_t timer from ANSI C standard Useconds microseconds of the timestamp 4 5 2 Region Informs about the location of the four vertex that make up a detector or loop X1 position of vertex 1 in the image horizontal axe Y1 position of vertex 1 in the image vertical axe X2 position of vertex 2 in the image horizontal axe Y2 position of vertex 2 in the ima...

Page 133: ...Incidences SIn true if sending the incidences generated at the detector to the central system is enabled false if disabled SendRealTimeInformation SRT true if sending the real time events generated at the detector to the central system is enabled false if disabled SummariesPeriod SumPeriod configured summaries period in minutes Coordinates Coord coordinates that define the position of the detector...

Page 134: ...el image of the detector s second loop using a Region structure 4 5 5 QueueDetector Describes a queue detector The structure corresponds to the version 3 Check 5 Communications protocol old versions to see the older versions Header Head description of detector s common features using a DetectorHeader structure Loops Loop1 5 coordinates in the 5 megapixel image of each loop in the detector using 5 ...

Page 135: ...ht X X position horizontal axe of light s centre in the 5 megapixel image Y Y position vertical axe of light s centre in the 5 megapixel image Radius radius of the light in the 5 megapixel image in pixels 4 5 8 TrafficLight Describes a traffic light The structure corresponds to the version 1 Check 5 Communications protocol old versions to see the older versions Id unique identifier of the traffic ...

Page 136: ...go red until the infringement is made to generate a valid incidence in milliseconds FirstLoop Loop1 coordinates in the 5 megapixel image of the detector s first loop using a Region structure SecondLoop Loop2 coordinates in the 5 megapixel image of the detector s second loop using a Region structure TrafficLightId the traffic light identifier used for the red state sign If no traffic light has been...

Page 137: ...of the detectors using a DetectorHeader MaxStopTime minimum stop time with the traffic light on red in order to generate an incidence in miliseconds Loop description of the coordinates in the 5 megapixel image of the only loop of the detector using a Region structure TrafficLightId identifier of the traffic light used as a stop signal If no traffic light is configured but a digital input its value...

Page 138: ...is used Duration duration of the video file in miliseconds Framerate FR frames per second of the video file 4 5 12 OutputActuatorCondition Describes a conditions of an output actuator DetectorId id of the detector that conditions refers to Field field that the condition check 0 vehicle driving speed detected 1 vehicle length detected 2 driving direction detected 3 detector s occupancy percentage 4...

Page 139: ...al output OutputId OId digital output identifier that corresponds to the actuator Time time that the actuator keeps the digital output active in milliseconds NumConditions NCo number of conditions that belongs to the output actuator Conditions descriptions of the conditions that belongs to the output actuator see the 4 5 12 OutputActuatorCondition structure 4 6 Event messages 4 6 1 InputChanged In...

Page 140: ...n summary data collection started in seconds elapsed since 00 00 hours on the first of January of 1970 End timestamp when summary data collection finished in seconds elapsed since 00 00 hours on the first of January of 1970 DetectorId identifier of the detector that generated the summary DetectorType Type type of detector that generated the summary 1 speed detector 2 queue detector 3 presence dete...

Page 141: ...tion of lengths in the summary They are provided using 7 consecutive integers where the ones that are not used show a 1 LengthsUpperLimit LenUL collection of values making up the ranges of distribution of lengths in the summary They are provided using 7 consecutive integers where the ones that are not used show a 1 OccupationsDistribution OccDst collection of values making up the distribution occu...

Page 142: ... DetectorType DTy type of detector that generated the real time event 1 speed detector 2 queue detector 3 presence detector 4 red light detector 5 stopped car detector Speed approximated speed of the detected vehicle in km h If value is 1 speed calculation was not possible DelayTime the minimum time that must go by from the moment the lights go red until the infringement is made to generate a vali...

Page 143: ... light detector 5 stoppped car detector Timestamp timestamp when the real time event was generated using a QuercusTimestamp structure Speed approximated speed of the detected vehicle in km h If speed calculation was not possible its value will be 1 Length approximated length of the detected vehicle in millimetres If length calculation was not possible its value will be 1 Si no ha sido posible calc...

Page 144: ... Characters not being used will be zero Major Maj major number of the version Minor Min minor number of the version Revision Rev revision number of the version 4 7 2 RealTimeQuery Query to receive the last real time event generated at a specific detector Query Type 33 Message Data DetectorId detector to which the query is requested Answer Type 65 Message Data Quercus Technologies 144 4 DetectorId ...

Page 145: ...icle in km h Length approximated length of the detected vehicle in millimetres WrongWay WW true if the direction of the detected vehicle is incorrect and false if the direction is correct Occupation occupancy percentage of the detector IsOccupied IsOc true if the detector reports vehicle presence and false if free Field operational only in a presence detector 4 7 3 StatusQuery Query to receive the...

Page 146: ...putCh status of the 2 digital inputs of the unit Each one of the first 2 bits corresponds to the status of one input being the least significant bit for input 0 Possible values 1 enabled 0 disabled The 30 bits left will be ignored available for future revisions OutputChannels OutputCh status of the 8 digital outputs of the unit Each one of the first 8 bits correspond to the status of one output be...

Page 147: ...d 480 high and a complete status of detectors traffic lights and digital inputs and outputs The image content and the focus value current digital focus coefficient will vary depending on the value of the query parameters Zoom to false incorrect rectangle the image obtained corresponds to the entire image captured by the unit The focus value will not be calculated 1 Zoom to false correct rectangle ...

Page 148: ...ottom RoidBttm Y value vertical axis from bottom side of the rectangle to not define it specify 1 RoiRight X value horizontal axis from right side of the rectangle to not define it specify 1 ExposureTime camera exposure time for the snapshot in microseconds Zoom indicates if the obtained image must be captured by the unit false or a magnified one true Offset starting position in the image buffer o...

Page 149: ...der Possible values 0 red state other value any other state Inputs status of the 2 digital inputs Each one of the first 2 bits corresponds to the status of an input being the least significant bit for the input zero Possible values 1 enabled 0 disabled Outputs status of the 8 digital outputs Each one of the first 8 bits corresponds to the status of an output being the least significant bit for the...

Page 150: ...eration of incidences at the unit is enabled false disabled SendSummaries SSm if true sending the summaries generated at the unit to the central system is enabled false disabled SendIncidences SIn if true sending the incidences generated at the unit to the central system is enabled false disabled SendRealTimeInformation SRT if true sending the real time events generated at the unit to the central ...

Page 151: ...a specific detector in the unit The format of the answer will vary depending on the type of detector that is described The structures correspond to the version 3 Check 5 Communications protocol old versions to see the older versions Query Type 41 Message Data Index identifier of the detector to inform about Answer red light detector Type 73 Message Data Quercus Technologies 151 4 Count 4 Index RLD...

Page 152: ...etector using a SpeedDetector structure Answer presence detector Type 75 Message Data PresenceDetector PresDetect description of the detector using a PresenceDetector structure Answer queue detector Type 76 Message Data QueueDetector QueDetect description of the detector using a QueueDetector structure Answer stopped cadr detector Type 79 Quercus Technologies 152 SpdDetect 73 PresDetect 48 QueDete...

Page 153: ... Message Data no message data Answer Type 77 Message Data Count number of configured traffic lights in the unit 4 7 12 TrafficLightInformationQuery Request of information about a configured traffic light in the unit The structures correspond to the version 1 Check 5 Communications protocol old versions to see the older versions Query The structure corresponds to the version 1 Type 46 Message Data ...

Page 154: ... TrafficLight structure 4 7 13 SetUnitTasksQuery Query to configure the tasks a unit must perform Currently only one task is possible to configure inform about the changes at digital inputs Query Type 47 Message Data SendInputChanges SInp if true informing the central system about the changes at the digital inputs is enabled false disabled Answer ACK NAK Quercus Technologies 154 4 Index TrafficLig...

Page 155: ...ntral system the summaries generated at the unit is enabled false disabled SendIncidences SIn if true sending to the central system the incidences generated at the unit is enabled false disabled SendRealTimeInformation SRT if true sending to the central system the real time events generated at the unit is enabled false if disabled Answer ACK NAK 4 7 15 OutputQuery Request to activate a digital out...

Page 156: ...on to perform 0 reboot Currently only the reboot operation is possible and the code is required so the protocol is open to future extensions Answer ACK NAK 4 7 17 VideoQuery Query to transfer a video file The file is divided into packets of maximum 64000 bytes in order to optimize the transfer Query Type 52 Message Data Id incidence identifier Quercus Technologies 156 4 Operation 4 Id 4 Offset 4 L...

Page 157: ...ly valid the first Length bytes 4 8 Confirmation messages 4 8 1 ACK Confirmation that the message has been received and interpreted correctly Type 192 Message Data no message data 4 8 2 NAK Informs that a message was not correctly received interpreted or executed Type 193 Message Data ErrorCode EC identifier of the type of error generated 0 Unknown message the message has a correct format but its ...

Page 158: ...ed feature action not supported for example if you want to enable the generation of incidences at a queue detector 8 Bad authorization does not exist the authorization to process such request The library VL is shared among various family products of Quercus Technologies so there are functions not enabled for certain products ErrorSubCode ESC additional information about the error produced When a d...

Page 159: ...of the conditions of an output actuator is wrong 32 operator variable of one of the conditions of an output actuator is wrong 33 value variable of one of the conditions of an output actuator is wrong 34 output id variable of one of the conditions of an output actuator is wrong 35 time variable of one of the conditions of an output actuator is wrong 36 max stop time variable is wrong 37 last pictur...

Page 160: ... to check that at the IP and port where the message is sent there is a configuration system running It is not needed to complete a successful Login message to get answer to this message Query Type 51 Message Data Port port where the configuration system must send the answer Answer ACK NAK 4 9 2 Login Obtains access to unit s configuration system Query Type 128 Message Data Password configuration s...

Page 161: ...ds access to configuration system and sets current SessionId to invalid Query Type 129 Message Data SessionId session identifier obtained at the last valid Login Answer ACK NAK 4 9 4 PasswordChange Changes the configuration system password This change is not effective until changes are applied Query Type 130 Message Data Quercus Technologies 161 4 SessionId 4 SessionId 4 SessionId 64 New Password ...

Page 162: ...d time against the configured time server Query Type 131 Message Data SessionId session identifier obtained at the last valid Login Answer ACK NAK 4 9 6 SetTime Sets indicated date and time Query Type 132 Message Data SessionId session identifier obtained at the last valid Login Time time in seconds elapsed since 01 01 1970 00 00 00 h Quercus Technologies 162 4 SessionId 4 SessionId 4 Time ...

Page 163: ...y Type 133 Message Data SessionId session identifier obtained at the last valid Login FileName name of the update file Answer ACK NAK 4 9 8 RestoreFirmware Restores the factory original firmware and reboots the unit After using this message the value of SessionId is invalid Query Type 134 Message Data SessionId session identifier obtained at the last valid Login Quercus Technologies 163 4 SessionI...

Page 164: ...nning during the process Moreover formatting can take some minutes while the configuration system will not answer to any message Once the format process is done the unit must be rebooted in order to get all services up and running again see 4 9 17 Restart Query Type 135 Message Data SessionId session identifier obtained at the last valid Login Answer ACK NAK 4 9 10 ExportLog Exports the log file o...

Page 165: ...e that has to be given to file stored in FTP root Answer ACK NAK 4 9 11 SystemInfo Information about the unit The structures correspond to the version 1 Check 5 Communications protocol old versions to see the older versions Query The structure corresponds to the version 1 Type 137 Message Data SessionId session identifier obtained at the last valid Login Answer Type 181 Message Data Quercus Techno...

Page 166: ...conds from 01 01 1970 00 00 00h FirmwareMajor Maf first figure in the firmware version E g 1 2 3 FirmwareMinor Mif second figure in the firmware version E g 1 2 3 FirmwareRevision Rf third figure in the firmware version E g 1 2 3 4 9 12 ExportStatus Exports a system status report leaving it at the unit s ftp server root Query Type 138 Message Data SessionId session identifier obtained at the last ...

Page 167: ...iguration to a file in the unit s ftp server root Query Type 140 Message Data SessionId session identifier obtained at the last valid Login FileName filename in the unit s ftp server root where the configuration will be exported Answer ACK NAK 4 9 15 ApplyChanges Apply the changes made to system variables and reboots the unit After using this message the value of SessionId is invalid Quercus Techn...

Page 168: ...rdChanges Discards changes made to the system variables Query Type 142 Message Data SessionId session identifier obtained at the last valid Login Answer ACK NAK 4 9 17 Restart This query has been designed exclusively for use after formatting the data drive see 4 9 9 FormatRWPartition Query Type 143 Quercus Technologies 168 4 SessionId 4 SessionId ...

Page 169: ...e number variables of the configuration system Query Type 150 Message Data SessionId session identifier obtained at the last valid Login Answer Type 182 Message Data EntriesCount number of variables 4 9 19 GetEntry Obtains information about a variable specified by its index or by its name Quercus Technologies 169 4 SessionId 4 EntriesCount 4 SessionId ...

Page 170: ...le that its information is required Only used if field Name is empty Answer Type 183 Message Data Name name of the variable Value current value of the varible Description1 description of the variable in default language Description2 description of the variable in user configured language 4 9 20 SetEntry Change the value of the variable specified by its name Query Type 152 Message Data Quercus Tech...

Page 171: ...ult value of the variable specified by its name Query Type 153 Message Data SessionId session identifier obtained at the last valid Login Name name of the variable to restore Answer ACK NAK 4 9 22 GetDetectorsCount Obtains the number of detectors in the configuration system Query Type 160 Message Data SessionId session identifier obtained at the last valid Login Quercus Technologies 171 4 SessionI...

Page 172: ...of the detector in the detector s collection of the configuration system starting from zero DetectorId identifier of the detector Only one of the two parameters can be used to specify a detector Index or DetectorId the parameter not used must be set to 1 Answer ACK NAK 4 9 24 GetDetector Obtains information about a detector The structures correspond to the version 3 Check 5 Communications protocol...

Page 173: ...tector Only one of the two parameters can be used to specify a detector Index or DetectorId the parameter not used must be set to 1 Answer presence detector Type 185 Message Data Detector detector description using a structure PresenceDetector Answer queue detector Type 186 Message Data Detector detector description using a structure QueueDetector Answer red light detector Quercus Technologies 173...

Page 174: ...ector Answer stopped car detector Type 191 Message Data Detector detector description using a structure StoppedCarDetector 4 9 25 SetPresenceDetector Add or modify a presence detector in the configuration system Query The structure corresponds to the version 3 Check 5 Communications protocol old versions to see the older versions Type 163 Message Data Quercus Technologies 174 Detector 128 Detector...

Page 175: ...an answer its subcode field will give more detailed information about why the query has failed See 4 8 2 NAK 4 9 26 SetQueueDetector Add or modify a queue detector in the configuration system Query The structure corresponds to the version 3 Check 5 Communications protocol old versions to see the older versions Type 164 Message Data SessionId session identifier obtained at the last valid Login Acti...

Page 176: ...ck 5 Communications protocol old versions to see the older versions Type 165 Message Data SessionId session identifier obtained at the last valid Login Action Act action 0 modify the existing detector 1 add a new detector PeviousId if an existing detector is modified this parameter must indicate the old identifier can have been modified On the other hand if a new detector is added it must be set t...

Page 177: ...er must indicate the old identifier can have been modified On the other hand if a new detector is added it must be set to 1 Detector detector description using a structure SpeedDetector Answer ACK NAK If a NAK message is received as an answer its subcode field will give more detailed information about why the query has failed See 4 8 2 NAK 4 9 29 SetStoppedCarDetector Add or modify a stopped car d...

Page 178: ...t be set to 1 Detector detector description using a structure StoppedCarDetector Answer ACK NAK If a NAK message is received as an answer its subcode field will give more detailed information about why the query has failed See 4 8 2 NAK 4 9 30 GetTrafficLightsCount Obtains the number of traffic lights in the configuration system Query Type 167 Message Data SessionId session identifier obtained at ...

Page 179: ...f the configuration system starting from zero TrafficLightId traffic light identifier Only one of the two parameters can be used to specify the traffic light Index or TrafficLightId the parameter not used must be set to 1 Answer ACK NAK 4 9 32 GetTrafficLight Obtains information about a traffic light in the configuration system The structures correspond to the version 1 Check 5 Communications prot...

Page 180: ...he parameter not used must be set to 1 Answer Type 190 Message Data TrafficLight TL description of the traffic light using a structure TrafficLight 4 9 33 SetTrafficLight Add or modify a traffic light in the configuration system Query The structure corresponds to the version 1 Check 5 Communications protocol old versions to see the older versions Type 170 Message Data SessionId session identifier ...

Page 181: ...wer ACK NAK If a NAK message is received as an answer its subcode field will give more detailed information about why the query has failed See 4 8 2 NAK 4 9 34 GetLanguage Obtains the language currently configured on the configuration system Request Type 173 Message Data SessionId session identifier obtained at the latest valid Login Response Type 197 Message Data Language language configured indi...

Page 182: ...the character 0 Response ACK NAK 4 9 36 GetOutputActuatorsCount Obtains the number of output actuators in the configuration system Query Type 167 Message Data SessionId session identifier obtained at the last valid Login Answer Type 189 Message Data OutputActuatorsCount OACount number of output actuators in the configuration system Quercus Technologies 182 4 SessionId 8 Language 4 SessionId 4 OACo...

Page 183: ...arameters can be used to specify the output actuator Index or OutputActuatorId the parameter not used must be set to 1 Answer ACK NAK 4 9 38 GetOutputActuator Obtains information about an output actuator in the configuration system Query Type 169 Message Data SessionId session identifier obtained at the last valid Login Index output actuator position in the output actuator collection of the config...

Page 184: ...nfiguration system Query Type 170 Message Data SessionId session identifier obtained at the last valid Login Action Act action 0 modify the existing output actuator 1 add a new output actuator OutputActuator OA output actuator description using a structure OutputActuator PeviousId if an existing output actuator is modified this parameter must indicate the old identifier can have been modified On t...

Page 185: ...QuercusVL Programming Manual If a NAK message is revived as an answer its subcode field will give more detailed information about why the query has failed See 4 8 2 NAK Quercus Technologies 185 ...

Page 186: ...s 0 vehicle driving speed detected 1 vehicle length detected 2 driving direction detected 3 detector s occupancy percentage 4 vehicle presence Operator Op operator used by the actuator 0 equal to 1 different from 2 greater than 3 less than Value value that the actuator acts with OutputId Oid digital output identifier that corresponds to the actuator Time time that the actuator keeps the digital ou...

Page 187: ...ing the real time events generated at the detector to the central system is enabled false if disabled SummariesPeriod SumPeriod configured summaries period in minutes NumOutputActuators NOut number of configured output actuators OutputActuators OutAc description of each one of the output actuators configurated They are described with 5 consecutive OutputActuator structures maximum number of config...

Page 188: ...condLoop are defined in the 0 3 megapixel image The rest of the fields have the same meaning of version 1 5 1 4 QueueDetector Version 1 and 2 are the same Header Head description of detector s common features using a DetectorHeader structure of version 0 Loops Loop1 5 coordinates in the 5 megapixel image of each loop in the detector using 5 consecutive Region structures Version 0 The detector coor...

Page 189: ...umber of lights in the traffic light Lights description of each one of the configured lights using 5 consecutive Light structures maximum number of configurable lights Only the first NumLights are used The coordinates of each one of the lights Lights X Lights Y Lights Radius are defined in the 0 3 megapixel image 5 1 7 RedLightDetector Version 2 Header Head description of detector s common feature...

Page 190: ... has been configured but a traffic light its value will be 1 AmberInput the identifier of the digital input used for the amber sign If no digital input has been configured because a traffic light will be used or because no amber signal will be used its value will be 1 IsVideoEnabled isVE true if video generation in the incidences is enabled false otherwise PreVideoTimeMs PreVideoT time that the st...

Page 191: ...s Loop description of the coordinates in the 5 megapixel image of the only loop of the detector using a Region structure TrafficLightId identifier of the traffic light used as a stop signal If no traffic light is configured but a digital input its value will be 1 RedInput identifier of the digital input used as a stop signal If no digital input is configured but a traffic light its value will be 1...

Page 192: ...mation Version 1 The fields MaxStopTime and TotalStoppedTime don t exist The rest of fields have the same meaning of the version 2 Version 0 The fields MaxStopTime TotalStoppedTime VideoInformation and AmberLightTime don t exist The rest of fields have the same meaning of the version 1 5 3 Query messages 5 3 1 SnapshotQuery Version 0 Query Quercus Technologies 192 4 Id 4 DetectorId 2 NImg 4 Speed ...

Page 193: ...pend on the version of this query Answer The structure related to the detector description has changed the version of this message defines the version of the detector structure See the obsolete versions of each detector type 5 3 3 TrafficLightInformationQuery Version 0 Query The fields of the structure have the same meaning of the latest version but the version of the answer will depend on the ver...

Page 194: ... HardwareMinor and HardwareRevision don t indicate the hardware version but the firmware version 5 4 2 GetDetector Versions 0 1 and 2 Query The fields of the structure have the same meaning but the version of the answer will depend on the version of this query Answer The structure related to the detector description has changed the version of this message defines the version of the detector struct...

Page 195: ...ged the version of this message defines the version of the detector structure See the obsolete versions of RedLightDetector 5 4 6 SetSpeedDetector Versions 0 1 and 2 Query The structure related to the detector description has changed the version of this message defines the version of the detector structure See the obsolete versions of SpeedDetector 5 4 7 SetStoppedCarDetector Versions 0 1 and 2 Qu...

Page 196: ...trafficlight description has changed the version of this message defines the version of the trafficlight structure See the obsolete versions of TrafficLight 5 4 9 SetTrafficLight Version 0 Query The structure related to the trafficlight description has changed version of this message defines the version of the trafficlight structure See the obsolete versions of TrafficLight Quercus Technologies 19...

Page 197: ...ystem 6 1 Configuration A couple of configuration files must be created General configuration file Detectors configuration file 6 1 1 General configuration file Contains the unit configuration This file corresponds to the configuration menu of a real SmartLoop TS unit so the parameters described below refer to each parameter of the menu See the SmartLoop TS user manual for detailed information abo...

Page 198: ...The file is divided into sections defined between brackets with their parameters described below one per line Global NumDetectors Detector1 parameter1 value1 The first section Globals indicates the number of detectors to be described in the file The rest defines each of the detectors Detector There is an example available in the SmartLoop TS installation folder Simulation Simulation Type Data Dete...

Page 199: ...l parameters for speed detectors CalculateMetrics enables the calculation of speed and length 0 disabled 1 enabled CameraDistance horizontal distance between the unit and the detector in millimetres Length detector length in millimetres 6 2 Simulation configuration To prepare a simulation a virtual lane must be created This means creating a representation of a lane where you can define all the eve...

Page 200: ...s comments and ignored by the simulator Unit events all lines will represent vehicle movements Several vehicles can be simulated These are managed by a single identifier integer value There are three types of vehicles available each of them in two different models car van and truck Each instruction refers to a position of a vehicle at a given time Using two consecutive positions of a vehicle the s...

Page 201: ...two vehicles movement The first vehicle drives from the bottom to the top of the image When bypassing the half it increases its speed Then the second car starts its movement from the top to the bottom 1000ms after the startup vehicle 1 type Car2 is created on position 0 1000 Car2 1 0 4000ms later vehicle 1 must be on position 12500 4000 Car2 1 12500 1000ms later vehicle 1 must be on position 35000...

Page 202: ...rtLoopTS SmartLoopTSPlus FGlobals path absolute or relative to the unit configuration file FDetectors path absolute or relative to the detectors configuration file FLog path absolute or relative to the log file generated by TSSimu DPersistent folder where summaries will be stored simulates the Log folder of the unit FTP The simulator will create the sub folder Summaries if it don t exist FSimulati...

Page 203: ...here the following fields can be seen Live Camera graphical representation of the virtual lane All movements taking place on that lane can be seen Detectors list of all detectors and their related tasks I O card Outputs digital outputs state Empty deactivated Filled activated Simulation speed controls the simulation speed as well as pause and resume the simulation Note that although the speed vari...

Page 204: ...ystem 7 1 Configuration A couple of configuration files must be created General configuration file Detectors configuration file 7 1 1 General configuration file Contains the unit configuration This file corresponds to the configuration menu of a real BirdWatch RL unit so the parameters described below refer to each parameter of the menu See the BirdWatch RL user manual for detailed information abo...

Page 205: ...lated detector The file is divided into sections defined between brackets with their parameters described below one per line Global NumDetectors NumTrafficLights Detector1 parameter1 value1 Trafficlight1 parameter1 value1 The first section Globals indicates the number of detectors and traffic lights to be described in the file The rest defines each of the detectors Detector and traffic lights Traf...

Page 206: ...on 1 signal through a digital input Extra parameters in a red light detector IsVideoEnabled enables disables the generation of a video to each incidence Possible values 1 enabled 0 disabled Only available in BirdWatch RL Plus simulation Note that the generated video will not correspond to the simulated scene but it will be a copy of VideoRedLight avi file or VideoStoppedCar avi file booth of them ...

Page 207: ...Lights number of lights 7 1 2 4 LightX_Y section Description of a light belonging to a defined traffic light X indicates the traffic light identifier and Y is the light identifier from 1 to the total amount of defined lights This sections is only needed by BirdWatch RL detectors Type colour of the light RED red GREEN green AMBAR amber OTHER other color X position of the light centre horizontal axi...

Page 208: ... light centre of the light x y 614 126 16 pixels radius The virtual lane parameters will be written in a configuration file There is an example available in the installation folder Simulation Simulation Type Data Simulation ini This file will contain several lines divided into Comments all lines starting with character are considered as comments and ignored by the simulator Unit events all lines r...

Page 209: ... traffic light state Event parameters they will depend on the event type see below 7 2 1 Vehicle movement event Several vehicles can be simulated These are managed by a single identifier integer value There are three types of vehicles available each of them in two different models Car Van Truck Each instruction refers to a position of a vehicle at a given time Using two consecutive positions of a ...

Page 210: ...ater vehicle 2 type Van1 is created on position 35000 out of the image 0 Van1 2 35000 2000ms later vehicle 2 must be on position 10000 out of the image 2000 Van1 2 10000 7 2 2 Digital input event The simulator can monitor the state of the four digital inputs of a unit These digital inputs have the same identifier as in a real unit 0 1 and the same state 0 inactive 1 active The state will be always...

Page 211: ...t on and no lights on 7 2 3 1 Instruction structure Milliseconds the simulator has to wait from the previous instruction until the execution of the next one Event type TrafficLight change of the traffic light state Traffic light state Green green light off Amber amber light on Red red light on None no light on 7 2 3 2 Example Example of several state changes the traffic light At the beginning it i...

Page 212: ...o the log file generated by RLSimu DPersistent folder where incidences will be stored simulates the Log folder of the unit FTP The simulator will create the sub folder Incidences if it don t exist FSimulation file that contains the simulation instructions 7 3 1 Graphical interface The GUI simulator has all the features of the command line simulator but its status can be watched in a more visual wa...

Page 213: ... unit Events list of the most recent events 7 4 Simulation example Example of a complete simulation Two vehicles are driving a truck and then a car while there occur changes in the I O card and also in the traffic light 0ms 1000ms 2000ms 3000ms 4000ms 5000ms 6000ms 7000ms Truck1 driving Car2 driving Input0 active Input1 active Tr Lights green amber red startup traffic light is green 0 TrafficLight...

Page 214: ...the image bottom 1000 Car1 2 10000 1000ms later end of movement of truck1 on the image top 1000 Truck1 1 45000 at the same time input 0 inactive 0 Input 0 0 at the same time traffic light changes to red 0 TrafficLight Red 2000ms later input 1 inactive 2000 Input 1 0 after 2000ms end of movement of car2 on the image top 2000 Car1 2 35000 Quercus Technologies 214 ...

Page 215: ...ned to detect any later manipulation Keep in mind that stored data make two records summaries and incidences of limited size so once the disk is full of data the oldest data will be deleted automatically If you want to modify the available size for each record see SmartLoop or BirdWatch user manual If Integration tool is enabled all data collected is also stored in the embedded FTP server To acces...

Page 216: ...ume number of detected vehicles AvgHeadway the average distance headway of vehicles in seconds Example of a XML file xml version 1 0 encoding UTF 8 Summary Unit 1 Unit Detector 1 Detector DetectorType PRESENCE DetectorType Period From Seconds 1273152323 Seconds Date 2010 05 06 Date Time 15 25 23 Time From To Seconds 1273152623 Seconds Date 2010 05 06 Date Time 15 30 23 Time To Period Volume 33 Vol...

Page 217: ...RangeX range X where X is the range identifier starting from 1 InferiorLimit inferior limit of the range SuperiorLimit superior limit of the range not included If it s infinite its value will be 1 Percentage percentage associated to the range For deeper information about occupation distribution see SmartLoop user manual Example of XML file xml version 1 0 encoding UTF 8 Summary Unit 1 Unit Detecto...

Page 218: ...y contains all data from the summary Unit unit identifier Detector detector identifier DetectorType type of detector SPEED for a speed detector Period period when data was collected From start of the period Seconds showed in seconds since 00 00h on 01 01 1970 Date date showed with format yyyy mm dd year month day Time time showed with format hh mm ss hours minutes seconds To end of the period Seco...

Page 219: ...r limit of the range not included in millimetres SuperiorLimit superior limit of the range not included in millimetres If it s infinite its value will be 1 Percentage percentage associated to the range For more information about speed and length distributions see SmartLoop user manual xml version 1 0 encoding UTF 8 Summary Unit 1 Unit Detector 1 Detector DetectorType SPEED DetectorType Period From...

Page 220: ...fier left padded with zeros until reaching eight digits The contents of the file is the following Incidence contains all data from the incidence Id incidence identifier Type type of incidence RED_LIGHT_VIOLATION for a red light incidence Unit unit identifier Detector detector identifier Description 1 2 3 4 unit description labels only defined description labels will be shown DetectorType type of d...

Page 221: ...dd year month day Time time formatted as hh mm ss us hours minutes seconds microseconds Duration video duration in miliseconds Width width of image in the video in pixels Incidence contains all data from the incidence Height height of the image in the video in pixels Framerate frames per second of the video file Speed approximated speed of the vehicle that generated the incidence in kilometres per...

Page 222: ...eName 00000003 avi FileName IniTimeStamp Seconds 1276610126 Seconds USeconds 80133 USeconds Date 2010 06 15 Date Time 15 55 26 80133 Time IniTimeStamp EndTimeStamp Seconds 1276610127 Seconds USeconds 99290 USeconds Date 2010 06 15 Date Time 15 55 27 99290 Time EndTimeStamp Duration 1019 Duration Width 640 Width Height 480 Height Framerate 13 Framerate Video Speed 15 Speed ElapsedTime 32064 Elapsed...

Page 223: ...t the video geneated if video generation is enabled Filename file name of the video recording InitTimestamp time stamp of the start of the video capturing Seconds showed in seconds since 00 00h of 01 01 1970 USecons microseconds since the second Seconds previous field For better accuracy Date date formatted as yyyy mm dd year month day Time time formatted as hh mm ss us hours minutes seconds micro...

Page 224: ...nds 476000 USeconds Date 2012 06 26 Date Time 11 08 59 476000 Time TimeStamp Image1 Image2 FileName 00000002_2 jpg FileName TimeStamp Seconds 1340701741 Seconds USeconds 984000 USeconds Date 2012 06 26 Date Time 11 09 01 984000 Time TimeStamp Image2 Image3 FileName 00000002_3 jpg FileName TimeStamp Seconds 1340701746 Seconds USeconds 316000 USeconds Date 2012 06 26 Date Time 11 09 06 316000 Time T...

Page 225: ...urcc FMP4 Incidence data inserted into strings these strings are written at the start of AviChunk JUNK Digital sign of the whole video file This way joins incidence data video and time stamp together and it can prove that no manipulation has been made Written at the end of the AviChunk JUNK 8 2 Protocol encryption In order to force the unit to send and receive only encrypted messages the parameter...

Page 226: ...ssage padding original message encrypted necessary bytes to make it multiple of 16 The type of AES codification will depend on the password length For passwords up to 16 characters AES 128 will be used AES 192 for passwords between 17 and 24 characters and AES 256 for passwords between 25 and 32 characters The AES key will be obtained with the password and the rest of bytes set to zero until the t...

Page 227: ...nications All provided programming examples that call the DLL functions can use the protocol encryption just setting Communications Password parameter on its configuration files 8 2 2 SFTP server When using encrypted communications access to summaries and incidences through FTP is disabled SFTP is enabled instead that allows communications encryption and increases security and confidentiality of s...

Page 228: ...sitate to contact our technical support department USA 1 201 227 2020 Brazil and Latin America 55 11 2614 3006 Extension 21 EMEA Asia 34 977 300 377 Or by email at support quercus biz You can also contact us through our web pages www quercus biz www quercus technologies com www quercus com br Quercus Technologies 228 ...

Reviews:

No comments

Brands by name

Popular brands

Load more brands