Doc: ICU Quick Start Guide Version: 2 - Innovative Technology · 1 GET TO KNOW YOUR ICU DEVICE 1.1 Front View 1 Feature Description 1 Near Infrared Camera Camera used for face depth

Doc: ICU Quick Start Guide Version: 2.1

ICU Quick Start Guide << Back to Contents

Copyright © Innovative Technology Ltd 2019 Doc: ICU Quick Start Guide Version: 2.1 Page 1 of 9

Document Name: ICU Quick Start Guide

Document Version: 2.1

Date of Release: 24/05/2019

Table of Contents

1 GET TO KNOW YOUR ICU DEVICE ....................................................................................................... 2

1.1 FRONT VIEW .................................................................................................................................................. 2 1.2 DEVICE STATUS LIGHTS .................................................................................................................................... 3

2 CONFIGURATION ............................................................................................................................... 4

2.1 NETWORK CONNECTION .................................................................................................................................. 4 2.2 INTEGRATION ................................................................................................................................................. 4 2.3 FUTURE INTEGRATION ..................................................................................................................................... 4

3 APPENDIX ......................................................................................................................................... 5

3.1 API DOCUMENTATION..................................................................................................................................... 5 3.1.1 Access Point Detail ........................................................................................................................... 5 3.1.2 API Detail .......................................................................................................................................... 5 3.1.3 Age Verification Process ................................................................................................................... 5 3.1.4 API Requests ..................................................................................................................................... 6

3.1.4.1 GetStatus ................................................................................................................................................ 6 3.1.4.2 SetStatus ................................................................................................................................................. 6 3.1.4.3 SetImage ................................................................................................................................................. 7 3.1.4.4 GetImage ................................................................................................................................................ 8

3.2 DECLARATION OF CONFORMITY ......................................................................................................................... 9



1 GET TO KNOW YOUR ICU DEVICE

1.1 Front View

Feature Description

1 Near Infrared Camera Camera used for face depth estimation

2 Visible Camera Camera used for face age estimation and face recognition

3 Status LEDs Lights to show the status of the ICU, see section 1.2 for more information

4 ICU Logo

(Salience Light)

This logo flashes during face recognition to attract the user’s attention, ensuring that they are looking in the optimal direction.

5 Near Infrared Camera Camera used for face depth estimation

1 2 3 4 5



1.2 Device Status Lights

LEDs Status Action Required

Power or lights off

If you haven’t disabled the LEDs, check that power is connected and wait 90 seconds for it to start.

Power on, device ready

To start the processing, look straight into the visible camera.

Face Detected Keep looking at the camera for 1-2 seconds until the orange LED remains steady

Face Detection Finished. Age calculation

started

Await Response. You can now stop looking at the camera and move around.

End of process. All operations completed

successfully

No Action Required.



2 CONFIGURATION

2.1 Network Connection The default configuration of the device is to use a web-interface, the device has a Micro USB port on the back, through which it can be connected to a wired or wireless ethernet network using an appropriate USB dongle. Network configuration proceeds via DHCP.

Once connected to the network, the operation of the device can be further customised using its built-in web interface, or multiple devices can be configured centrally through a server, and the configuration information broadcast to the client devices.

2.2 Integration Typically, the device will be configured to report to a server operating on a local network, using a REST protocol. The default mode of operation is for the device to periodically poll the server for instructions to begin the age-estimation, process. The device then searches its field of view for a face, and can stream live images to the server to assist the user in getting their presenting their face.

Please see Section 3.1 for more information regarding the API.

2.3 Future Integration The next supported interface will be for the cameras to operate as a UVC webcam device over USB, with age estimation details transmitted in a custom metadata channel.

Additional vending machine protocols (e.g. SSP, CCTalk, MDB) can be supported over the USB connection.



3 APPENDIX

3.1 API Documentation

3.1.1 Access Point Detail SSID: see terminal for current SSID

SSID password: ‘NewScanner8199’

3.1.2 API Detail API base url: http://192.168.43.1:8080/titoservice/

Basic Authorisation

Username: 7F5CBFFF-CAA6-4620-A277-4763062B278F

Password: 0ADF940B-A319-4F22-B962-D816C1735C3C

3.1.3 Age Verification Process The Facial Recognition device should send a GetStatus (GET) request at regular intervals (<= 1 second) during its idle process. When a response status of ‘NEW’ is received, this should initiate a new recognition scan.

Upon receiving the ‘NEW’ request response, the device should send SetStatus request with one of the following statuses:

INITIALISING,

SCANNING,

SET_IMAGE,

PROCESSING,

RESULT,

ERROR,

In addition, with Status = ‘RESULT’ the Result should be set to either ‘PASS’ OR ‘FAIL’ to indicate that the result is over or under the required age threshold.

SET_IMAGE state is set by the client when a new image has been uploaded.

A client polling and seeing this state can send the GetImage request to view/manipulate the image.

Once that polled state changes from SET_IMAGE, the GetImage request will return 404 header (not found)

Once a result or error has been sent, the device should revert to Polling for NEW status’ with GetStatus.

http://192.168.43.1:8080/titoservice/



3.1.4 API Requests

3.1.4.1 GetStatus

Get request status. This will return a status request for a given terminal ID. In this case we only have one fixed as shown in the example below.

REST Type: GET

Usage: GET url:

baseurl/GetVerifyStatus.php?deviceid=RDT46756067

JSON response example: [{"DeviceID":"RDT46756067","Type":"AGE_VERIFY","Status":"NEW","Result":"","TimeStamp":"2017- 09-04 10:14:11"}]

POSTMAN code snippet example:

GET /titoservice/GetVerifyStatus.php?deviceid=RDT46756067

HTTP/1.1 Host: 192.168.43.1:8080

Authorization: Basic N0Y1Q0JGRkYtQ0FBNi00NjIwLUEyNzctNDc2MzA2MkIyNzhGOjBBREY5NDBCLUEzMTktNEYyMi1COTY yLUQ4MTZDMTczNUMzQw==

Content-Type: application/x-www-form-urlencoded

Cache-Control: no-cache

3.1.4.2 SetStatus

Set the current device status.

REST Type: POST

baseurl/SetVerifyStatus.php

POST Fields:

deviceid=RDT RDT46756067 // this is fixed for now

type =”AGE_VERIFY” // This is fixed for now

status =”NEW” or “INITIALISING” or “SCANNING” or “PROCESSING” or “RESULT” or “ERROR”

result =”PASS” or “FAIL” when status=”RESULT”, error when status=”ERROR”, “NONE” at other times

200 response shows status has been set.




POST /titoservice/SetVerifyStatus.php HTTP/1.1

Host: 192.168.43.1:8080


Content-Type: application/x-www-form-urlencoded


deviceid=RDT46756067&type=AGE_VERIFY&status=PROCESSING&result=NONE

3.1.4.3 SetImage

Uploads raw image data to the server.

REST Type: PUT

baseurl/SetImage.php


PUT /titoservice/setimage.php HTTP/1.1

Host: 10.10.9.253:8080


Content-Type: image/png


data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAArwAAADICAYAAAAKljK9AAAABHNCSVQICAgIfAhkiAAABE1JREFUeJzt1kFugzAUQMHS+9+Z7Fn0C9kkzdPMFmMbI9A7zvM8f/6h4zj+vH7d9nX89Fh3x09W15+szjed1+71Vud7er9359+93jR+db3Ju893Gj+5+73vft/Tfibffr6r46f7r779+6k/3+77n15v9/9u8u73e3e+af5Pn99Tfj+9AQAAeJLgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AAC



kCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaS8BM4aM/pjzDgAA AABJRU5ErkJggg==

3.1.4.4 GetImage

Retrieves an uploaded image

REST Type: GET

baseurl/GetImage.php


GET /titoservice/getimage.php HTTP/1.1

Host: 10.10.9.253:8080



JSON response example: [{"image":"data:image\/png;base64,iVBORw0KGgoAAAANSUhEUgAAArwAAADICAYAAAAKljK9AAAABHNCSVQICAgIfAhkiAAABE1JREFUeJzt1kFugzAUQMHS+9+Z7Fn0C9kkzdPMFmMbI9A7zvM8f\/6h4zj+vH7d9nX89Fh3x09W15+szjed1+71Vud7er9359+93jR+db3Ju893Gj+5+73vft\/Tfibffr6r46f7r779+6k\/3+77n15v9\/9u8u73e3e+af5Pn99Tfj+9AQAAeJLgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaS8B M4aM\/pjzDgAAAABJRU5ErkJggg=="}]



3.2 Declaration of Conformity

Documents

Doc: ICU Quick Start Guide Version: 2 - Innovative Technology · 1 GET TO KNOW YOUR ICU DEVICE 1.1 Front View 1 Feature Description 1 Near Infrared Camera Camera used for face depth