innovative technology ICU Quick start guide

Doc: ICU Quick Start Guide

Version: 2.1

ICU Quick Start Guide

<< Back to Contents

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

ICU Quick Start Guide

<< Back to Contents

Version: 2.1

Page 2 of 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

ICU Quick Start Guide

<< Back to Contents

Version: 2.1

Page 3 of 9

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.

ICU Quick Start Guide

<< Back to Contents

Version: 2.1

Page 4 of 9

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.

ICU Quick Start Guide

<< Back to Contents

Version: 2.1

Page 5 of 9

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.

ICU Quick Start Guide

<< Back to Contents

Version: 2.1

Page 6 of 9

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":"","Tim

eStamp":"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

N0Y1Q0JGRkYtQ0FBNi00NjIwLUEyNzctNDc2MzA2MkIyNzhGOjBBREY5NDBCLU

EzMTktNEYyMi1COTY 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.

ICU Quick Start Guide

<< Back to Contents

Version: 2.1

Page 7 of 9

POSTMAN code snippet example:

POST /titoservice/SetVerifyStatus.php HTTP/1.1

Host: 192.168.43.1:8080

Authorization: Basic

N0Y1Q0JGRkYtQ0FBNi00NjIwLUEyNzctNDc2MzA2MkIyNzhGOjBBREY5NDBCLU

EzMTktNEYyMi1COTY yLUQ4MTZDMTczNUMzQw==

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

Cache-Control: no-cache

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

POSTMAN code snippet example:

PUT /titoservice/setimage.php HTTP/1.1

Host: 10.10.9.253:8080

Authorization: Basic

N0Y1Q0JGRkYtQ0FBNi00NjIwLUEyNzctNDc2MzA2MkIyNzhGOjBBREY5NDBCLU

EzMTktNEYyMi1COTY yLUQ4MTZDMTczNUMzQw==

Content-Type: image/png

Cache-Control: no-cache

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAArwAAADICAYAAAAKljK

9AAAABHNCSVQICAgIfAhkiAAABE1JREFUeJzt1kFugzAUQMHS+9+Z7Fn0C9kkzd

PMFmMbI9A7zvM8f/6h4zj+vH7d9nX89Fh3x09W15+szjed1+71Vud7er9359+93jR+d

b3Ju893Gj+5+73vft/Tfibffr6r46f7r779+6k/3+77n15v9/9u8u73e3e+af5Pn99Tfj+9AQA

AeJLgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQA

gTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJA

meAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASB

O8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV

4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELw

AAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA

0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrg

BQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfAC

AJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEA

SBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACk

CV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIE

LwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXA

IA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJ

rgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfA

CAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAE

ASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AAC

ICU Quick Start Guide

<< Back to Contents

Version: 2.1

Page 8 of 9

kCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIE

LwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXA

IA0wQsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJ

rgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfA

CAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAE

ASBO8AACkCV4AANIELwAAaS8BM4aM/pjzDgAA AABJRU5ErkJggg==

3.1.4.4 GetImage

Retrieves an uploaded image

REST Type: GET

baseurl/GetImage.php

POSTMAN code snippet example:

GET /titoservice/getimage.php HTTP/1.1

Host: 10.10.9.253:8080

Authorization: Basic

N0Y1Q0JGRkYtQ0FBNi00NjIwLUEyNzctNDc2MzA2MkIyNzhGOjBBREY5NDBCLU

EzMTktNEYyMi1COTY yLUQ4MTZDMTczNUMzQw==

Cache-Control: no-cache

JSON response example:

[{"image":"data:image\/png;base64,iVBORw0KGgoAAAANSUhEUgAAArwAAADICA

YAAAAKljK9AAAABHNCSVQICAgIfAhkiAAABE1JREFUeJzt1kFugzAUQMHS+9+Z7

Fn0C9kkzdPMFmMbI9A7zvM8f\/6h4zj+vH7d9nX89Fh3x09W15+szjed1+71Vud7er9

359+93jR+db3Ju893Gj+5+73vft\/Tfibffr6r46f7r779+6k\/3+77n15v9\/9u8u73e3e+af5P

n99Tfj+9AQAAeJLgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0w

QsAQJrgBQAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgB

QAgTfACAJAmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJ

AmeAEASBO8AACkCV4AANIELwAAaYIXAIA0wQsAQJrgBQAgTfACAJAmeAEASB