AXIS Barcode Reader Beta 0.3 Please note that this software has only been subject to limited testing and that you cannot expect full support regarding the software. The software is to be considered as experimental and is distributed as-is and free of charge. Axis does not officially support this software, and any help other than this manual will be very limited. Any feedback on the software is appreciated. The AXIS Barcode Reader offers the ability of reading barcodes via an ACAP (Axis Camera Application Platform) application installed on an Axis camera. The application is intended to be one part of a barcode reading solution, and is utilizing camera events for an easy integration. AXIS Barcode Reader is performing powerful image analysis and is preferably installed on an ARTPEC-5 based camera. The application is using special ACAP features that was introduced in firmware 5.80, causing all prior firmware versions to be unsupported. To avoid sending multiple events containing the same data, the application will keep the information from the five latest barcodes (that generated an event) stored in a list. No new event will be sent if the scanned barcode is present in the list of the previously scanned barcodes. This Beta release has a time lock function that won't allow usage of this application after 2016-12-31. Upload and install the.eap file at [IP-address]/admin/devtools.shtml (Setup > Applications). Select the application in the list once it is uploaded, and click on the start button to start the application. 2016-02-24 1 version 1.0
The application need to be configured to read a certain type of barcode, and it is also possible to choose whether the data of the scanned barcode should be visible on the dynamic text overlay or not. The configuration could be performed on the settings page for the application at: [IP-address]/local/BarcodeReader/setup.html (Setup > Applications > Barcode Reader > Advanced Settings) Or by setting the parameter directly via param.cgi: [IP-address]/axiscgi/admin/param.cgi?action=update&root.BarcodeReader.BarcodeType =[ID] [IP-address]/axiscgi/admin/param.cgi?action=update&root.BarcodeReader.EnableOverl ay=[0 1] It is necessary to enable dynamic overlay in the camera if the enable overlay option should have any effect. Enable dynamic overlay by including the tag for dynamic text #D in the overlay settings at [IP-address]/operator/videostream.shtml (Setup > Video & Audio) 2016-02-24 2 version 1.0
All the supported barcode types are selectable from a drop-down box on the settings page. Configuration via the param.cgi requires the correct type-id from the table below. ID Barcode Type 0 QR code 1 Aztec 2 Data matrix 3 PDF 417 4 EAN 8 5 EAN 13 6 ITF 7 Codabar 8 Code 39 9 Code 93 10 Code 128 2016-02-24 3 version 1.0
11 UPC A 12 UPC E The Barcode Reader sends an event with the barcode data whenever it finds a barcode of the same format that is set in the application. The event contains one data field holding a string value, this field is named data. Example: Event structure for a barcode containing ABC-1234 <tt:metadatastream xmlns:tt="http://www.onvif.org/ver10/schema"> <tt:event xmlns:tt="http://www.onvif.org/ver10/schema"> <wsnt:notificationmessage xmlns:tns1="http://www.onvif.org/ver10/topics" xmlns:tnsaxis="http://www.axis.com/2009/event/topics" xmlns:wsnt="http://docs.oasis-open.org/wsn/b-2" xmlns:wsa5="http://www.w3.org/2005/08/addressing"> <wsnt:topic Dialect="http://docs.oasis-open.org/wsn/t- 1/TopicExpression/Simple">tnsaxis:CameraApplicationPlatform/Barc odereader/barcodefound</wsnt:topic> <wsnt:producerreference> <wsa5:address>uri://a7f9c7b1-fdbb-4a0b-809e- 028d7522803f/ProducerReference</wsa5:Address> </wsnt:producerreference> <wsnt:message> <tt:message UtcTime="2016-02-16T10:39:22.779174Z"> <tt:source> </tt:source> <tt:data> <tt:simpleitem Name="data" Value="ABC-1234" /> </tt:data> </tt:message> </wsnt:message> </wsnt:notificationmessage> </tt:event> </tt:metadatastream> 2016-02-24 4 version 1.0
The events could be caught by either another ACAP application, Axis Camera Station or by the action rule engine. The benefits of retrieving the events in an ACAP application is that it is possible to extract and parse the barcode data from the event. Axis Camera Station is able to use a filter and only trigger on certain information in the barcode data. Example: Make a sound when a barcode has been scanned Make sure that AXIS Barcode Reader is running. Go to the Action Rules page [IPaddress]/operator/action_rules.shtml (Setup > Events) and add a new rule. Trigger on the BarcodeFound event, and select a suitable action. Check the camera manual if your model is capable of making a sound. This will work for cameras that has a speaker, audio I/O or an IO port. If your camera has a built in speaker or one connected, then you could choose the action Play Audio Clip. Another approach is to connect buzzer to an output port and activate this port when the event is sent. 2016-02-24 5 version 1.0
For best scanning results it is very important that the presented image is sharp, has a high contrast, is illuminated evenly and is not distorted. Barcode scanning requires a pixel density of about 5 pixels per millimeter. Therefore, it is recommended to use 1080p resolution. When deploying a camera for barcode scanning, it is recommended to set a short shutter speed to avoid motion blur. For instance, when objects move with a speed of 1m/s, the shutter speed should be set to a maximum of 1/2000s. It is also very important to set the focus accurately and to check the depth of field. It is recommended to use the AXIS Q1635 with fixed focal length lenses from Fujinon. Axis Communications See contact information at www.axis.com/corporate/contact.htm THE SOFTWARE IS DELIVERED AS IS WITHOUT WARRANTY OF ANY KIND. YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT THE ENTIRE RISK AS TO THE USE, RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED SOLELY BY YOU. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, AXIS DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT, OR ANY WARRANTY ARISING OUT OF ANY PROPOSAL, SPECIFICATION OR SAMPLE WITH RESPECT TO THE SOFTWARE. AXIS DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY AXIS OR AN AXIS AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE 2016-02-24 6 version 1.0