USER'S MANUAL Jun, 2016 Rev 1.00 Copyright 2009. CrasID Co., Ltd. All Rights Reserved.
User's Manual.Revision History Rev No. Description Author Date 0.01 - Initial Draft ysjeong@crasid.com Feb, 2016 0.02 - use, sdk ysjeong@crasid.com Mar, 2016 0.03 - windows, 0.04 - arduino 0.06 - client usage May, 2016 1.00 Release 1.0 Jun, 2016-2 -
목차 A. 알리는글...- 5 - B. 저작권및사용동의...- 6 - C. 안전을위한경고및주의사항...- 7 - Chapter 1...- 8-1.1 제품소개...- 9-1.2 제품사양...- 10-1.2.1 하드웨어사양...- 10-1.2.2 소프트웨어사양...- 10-1.2.3 UERFACE 사양...- 10-1.2.4 사전인지사항...- 10-1.3 제품구성...- 10 - Chapter 2...- 12-2.1 Voyager...- 13-2.2 Voyager 외관...- 13-2.3 Voyager 사양...- 13-2.4 회로도...- 14-2.5 공장초기화...- 15-2.6 Voyager 자료실...- 15 - Chapter 3...- 16-3.1 프로토콜정의...- 17-3.1.1 UART 설정환경...- 17-3.1.2 Command Packet...- 17-3.1.3 Stream Packet... - 17-3.2 프로토콜내용...- 18-3.2.1 일반...- 18-3.2.1 시스템...- 18-3.2.2 라이브러리...- 21-3.2.3 카메라...- 25-3.2.3 데이터...- 26 - Chapter 4...- 28-4. UerFace 사용법...- 29-4.1 사용자등록...- 29-4.2 사용자인증...- 30-4.3 얼굴검출...- 30-4.4 주의사항...- 31 - Chapter 5...- 32-5. Voyager SDK...- 33-5.1 ANDROID... - 33-5.1.1 메인페이지...- 34-5.1.2 시스템업데이트...- 35 - - 3 -
5.1.3 UerFace...- 35-5.2 LINUX...- 37-5.3 WINDOWS...- 39-5.3.1 MENU-SERIAL...- 40-5.3.1 MENU-Setting...- 41-5.3.2 Usage...- 41-5.4 ARDUINO UNO...- 42 - Appendix...- 44 - 용어정의...- 44 - UerFace Code...- 44 - 리커버리진입...- 45 - Contact...- 47 - - 4 -
A. 알리는글 본사용설명서는저작권의보호를받으며, 이와관련한모든권리를가집니다. 크라스아이디의사전동의없이이문서의어떠한부분도복사, 재생, 개조또는다른언어로번역할수 없습니다. 본사용설명서의내용은 현재의상태대로 제공되며, 사전통지없이변경될수있습니다. 크라스아이디는사용설명서에관하여상품성에대한묵시적보장이나특정목적에대한적합성등을 포함하며이에국한되지않는어떠한보장도하지않습니다. 이문서및제품에서사용된기타모든품명은각해당소유자의상호, 서비스마크, 상표또는등록 상표입니다. - 5 -
B. 저작권및사용동의 본설명서는현재를기준으로제작되었으며, 기술상, 편집상오류나누락이있을수있습니다. 제품을이용하여제품공급자가별도의응용프로그램을개발하여제공한경우제품 공급자가제공하는프로그램사용설명서를참조하시기바랍니다. 기본적으로탑재한프로그램외에업무프로그램등의별도응용프로그램제작사는기기배포시 프로그램문의에대한전화번호를제품또는프로그램, 제품박스등에별도표기하여야합니다. 크라스아이디는공장출고시점이후에탑재된제 3 자소프트웨어회사에서제작한프로그램에대하여 품질보증을하지않습니다. 크라스아이디는이동통신망사업자의요구에의한제품의품질보증을위해프로그램제작사에프로그램을 요구할수도있습니다. 본설명서의모든내용은저작권법에따라보호되며, 크라스아이디의사전서면동의없이무단으로 복제하거나, 개작, 배포하는경우에는소프트웨어저작권법에의거형사처벌의대상이됨을 알려드립니다. 본설명서에사용된기타제품및서비스는해당소유권자의등록상표입니다. - 6 -
C. 안전을위한경고및주의사항 소비자유의사항 분실, 도난시에는통신사업자에게즉시신고하시기바랍니다. 타인에게함부로빌려주지마십시오. A/S 를받으실때에는통신사업자나저희회사로의뢰하여주시기바랍니다. 하드웨어및탑재된기본소프트웨어이외의응용프로그램및업무프로그램은해당프로그램제작사에 직접문의하여주십시오. 제공하는지정된배터리어댑터와액세서리를사용하십시오. 지정된기기이외의사용자가임의로사용하여발생한하자에대해서는무상 A/S 를받으실수없습니다. 휴대및보관주의사항 고온다습한곳에서는사용하지마십시오. 기기에치명적인손상이발생할수있습니다. 높은곳에서떨어뜨리는등의충격을가하지마십시오. 기기에치명적인손상이발생할수있습니다. 개조하지마십시오 어떠한방법으로든개조하려하지마십시오. 화재, 부상, 감전위험이있으며사용자나기기에심각한손상을가져올수있습니다. 개조로인한제품의고장은 A/S 를받으실수없습니다. - 7 -
Chapter 1 - Overview - 이항목은 SDK 를사용하기위한사전인지항목에대해기술합니다. 이항목은다음과같이구성되어있습니다. 제품소개 제품사양 사전인지사항 - 8 -
1.1 제품소개 Voyager는 LED 보드와 AP보드가결합되어있는독립된 얼굴인식 모듈입니다. 5v-350mA의전원이필요하며, 인터페이스는 UART를제공하고있습니다. 또한적외선 LED를사용하여빛이없는밤 (0 Lux) 에도인증을할수있습니다. 상세한내용은 Chapter 2 에기술되어있습니다. - 9 -
1.2 제품사양 1.2.1 하드웨어사양 Camera VGA Sensor Interface UART 9600bps ~ 3Mbps GPIO 1 Pin Power 5V - 350mA Dimension 50mm x 35mm x 22mm ( 커넥터높이제외 ) Working Temperature -10C ~ 60C 1.2.2 소프트웨어사양 OS v-rtos v1.0 Protocol Voyager v1.0 SDK Android Linux Windows Arduino 1.2.3 UERFACE 사양 Version V2.0.14.2 FAR 0.1% ~ 0.001% Face Detection 최대 5인 Face Capacity 최대 5 ID ( 2포즈 /ID ) 주의사항 1. 직사광선으로부터떨어진실내환경 2. 다른적외선광원으로부터영향을받지않는실내환경 1.2.4 사전인지사항 표시규칙 - ' ' 표시. 주의할사항입니다. 1.3 제품구성 - 10 -
Voyager 구입시제품구성은다음과같습니다. 제품포장형태 제품구성 Voyager 모듈 + 2P(POWER) + 4P(UART) 2P 전원케이블 적 : VDD(5V In) 흑 : GND 4P UART 케이블 적 : VDD(3.3V Out) 녹 : TX 청 : RX 흑 : GND 주의 : 제공된 POWER, UART 케이블을 Voyager와연결및해제과정에서무리한힘을가하면소켓이부서질수있습니다. 부서진제품은반품및환불이되지않습니다. - 11 -
Chapter 2 - Device - 이항목은 Voyager 에대해서기술합니다. 이항목은다음과같이구성되어있습니다. Voyager Voyager 외관 Voyager 사양회로도 - 12 -
2.1 Voyager Voyager는 크라스아이디 가얼굴인식을위해제작한독립모듈입니다. 외부인터페이스는범용 UART(1port) 를사용하여 UART 인터페이스를지원하는모든기기에연결하여사용할수있습니다. 2.2 Voyager 외관. 앞면 카메라렌즈와 LED(6) 로구성되어있습니다.. 뒷면 전원과 UART, 그리고 GPIO 1port 로구성되어있습니다. 2.3 Voyager 사양 Camera VGA Sensor LED 850nm IR x 6-13 -
Interface UART 9600bps ~ 3Mbps I/O level - 3.3v GPIO 1 Pin I/O level - 3.3v Ambient Light 0 Lux ~ 1500 LUX Face Capacity Max 5 ID ( 2pose/ID ) Recognition Time < 1sec Capture distance 40cm ~ 60cm Booting < 1sec Power 4.0V ~ 5.5V < 350mA ( LED ON ) Working Temperature -10C ~ 60C Dimension 50mm x 35mm x 22mm ( 커넥터높이제외 ) 주의 : Voyager UART 속도는연결환경에따라서지원되는속도가다를수있습니다. 2.4 회로도 - 14 -
2.5 공장초기화 Voyager를공장출하초기로만듭니다. 그과정은다음과같습니다. 1. 리커버리모드로진입 2. PKT_CMD_FACTRESET 명령어를사용 주의 : Voyager 의모든데이터가삭제됩니다. 2.6 Voyager 자료실 Voyager의관련자료는홈페이지 www.crasid.com 의 TECH & PRODUCT > Voyager 페이지에기술되어있습니다. - 15 -
Chapter 3 - Protocol - 이항목은 Voyager 와통신을하기위한프로토콜에대해서기술합니다. 이항목은다음과같이구성되어있습니다. 프로토콜정의 프로토콜내용 - 16 -
3.1 프로토콜정의 Voyager는외부 Devices들과통신하기위해서 UART 인터페이스를제공합니다. 프로토콜정의는다음과같으며상세한내용은다음절에서기술합니다. ( 통신패킷은 Big-Endian 사용 ) 3.1.1 UART 설정환경 Baud rate : 9600bps ~ 3Mbps bit : 8bits Parity : none Flow Control : none 3.1.2 Command Packet 모듈을제어하기위한패킷의포맷은다음과같습니다. 구분 SoP Pkt-Length CMD D-Length DATA CS SEC EoP 크기 1 2 2 4 가변 1 4 1 (Byte) Code 0xAA 0x55 SoP : 패킷의시작 Pkt-Length : 전체패킷의크기 CMD : 명령어 D-Length : 데이터의크기 DATA : 데이터내용 CS : 체크섬 (1byte signed) SEC : 암호코드 ( 옵션 ) EoP : 패킷의끝 3.1.3 Stream Packet 모듈과연속된데이터교환을위한패킷의포맷은다음과같으며, 해당패킷이활성화하기위해서는 CMD의데이터정보교환이선행되어야합니다. 구분 D-Length DATA CS 크기 4 4 4 (Byte) Code D-Length : 패킷의 DATA 크기 DATA : 데이터내용 - 17 -
CS : 체크섬 (4byte signed) 3.2 프로토콜내용 용어정의. 관리자 : Voyager 운영자. 사용자 : UerFace 사용하는사람 내용의 CMD & 표기는 CMD필드와 AND 값을나타내고, CMD 는 CMD필드값, 그외는 DATA필드의값을나타냅니다. 관리자인증이되지않으면, PKT_CMD_CONFIRM_USER, PKT_CMD_SET_BAUD, PKT_CMD_TEST 기능만동작이됩니다. 3.2.1 일반 BITFIELD PKT_REQUEST_OK HEX 0x4000 Explanation 요청완료를알리는커맨드비트 ( bit14 ) BITFIELD PKT_REQUEST_ERR HEX 0x8000 Explanation 처리오류를알리는커맨드비트 ( bit15 ) CMD PKT_CMD_RESEND HEX 0x1500 Explanation 마지막에보낸패킷의재전송을요청합니다. 3.2.1 시스템 BITFIELD PKT_CMD_TEST HEX 0x100-18 -
Explanation Voyager 와의연결상태를체크합니다. 성공 CMD & PKT_REQUEST_OK BITFIELD PKT_CMD_REBOOT HEX 0x101 Explanation Voyager 를재부팅합니다. 성공 CMD & PKT_REQUEST_OK BITFIELD PKT_CMD_FACTRESET HEX 0x150 Explanation Voyager를초기상태로되돌립니다. 모든데이터가초기화됩니다. 성공 CMD & PKT_REQUEST_OK CMD PKT_CMD_CONFIRM_USER HEX 0x3000 x bytes 최대 64bytes Explanation Voyager 의사용을위한접속암호를전송합니다. 성공 CMD & PKT_REQUEST_OK CMD PKT_CMD_SET_ADMINPW HEX 0x3011 x bytes 0x2b y bytes 이전비밀번호 구분자새로운비밀번호 Explanation Voyager 의관리자비밀번호를변경합니다. 성공 CMD & PKT_REQUEST_OK CMD PKT_CMD_SET_BAUD HEX 0x3012 Integer (4bytes) 지정하려고하는속도의 Integer 값 Explanation Voyager 의통신속도를변경합니다.. CMD PKT_CMD_ GET_BAUD HEX 0x3013-19 -
Explanation Voyager 의통신속도를확인합니다. 성공 - Integer (4bytes) CMD PKT_CMD_ALIVE HEX 0x3014 Explanation Voyager 의구동준비를확인합니다. 성공 - PKT_REQUEST_OK CMD PKT_CMD_UPDATE_APP HEX 0x3020 Explanation 전송된어플리케이션파일을업데이트합니다. 업데이트이전파일의전송을완료해야합니다. PKT_CMD_SEND_FILE_INFO 커맨드를확인하십시오. 업데이트완료후강제재부팅됩니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_SET_SYSTIME HEX 0x3021 Integer (4bytes) Integer (4bytes) 현재시간 (ms) 의상위값 현재시간 (ms) 의하위값 Explanation Voyager 의시간을설정합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_GET_APPVER HEX 0x3022. Explanation Voyager 의프로그램버전을불러옵니다. 성공 Integer (4bytes)-App version 실패 CMD & PKT_REQUEST_ERR CMD PKT_CMD_GET_UERFACE_VER HEX 0x3023 Explanation 라이브러리버전정보를불러옵니다. - 20 -
성공 - char (x bytes) variable length char data CMD PKT_CMD_SET_PKT_FRAME_LENGTH HEX 0x3024 Integer (4bytes) 지정하려고하는 FRAME 의크기 Integer 값 Explanation Voyager 의통신 FRAME 의크기를설정합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UPDATE_RECOVERY HEX 0x3030 Explanation 전송된리커버리파일을업데이트합니다. 업데이트이전파일의전송을완료해야합니다. PKT_CMD_SEND_FILE_INFO 커맨드를확인하십시오. 주의-업데이트이후리커버리모드로진입해서 LED가올바른작동을하는지확인하십시오. 성공 - CMD & PKT_REQUEST_OK 3.2.2 라이브러리 CMD PKT_CMD_UERFACE_USERADD HEX 0x2001 Explanation Voyager 에사용자등록을진행합니다. 성공 Integer (4bytes)- UerFace Retcode Integer (2bytes)-face position left data Integer (2bytes)-face position top data Integer (2bytes)-face position right data Integer (2bytes)-face position bottom data Opt : UerFace success(retcode>=0) > add Max 20bytes user id 실패 CMD & PKT_REQUEST_ERR CMD PKT_CMD_UERFACE_USERCHECK HEX 0x2002 Explanation Voyager 에등록된사용자를확인합니다. 성공 - 21 -
Integer (4bytes)- UerFace Retcode Integer (2bytes)-face position left data Integer (2bytes)-face position top data Integer (2bytes)-face position right data Integer (2bytes)-face position bottom data Opt : UerFace success(retcode>=0) > add Max 20bytes user id 실패 CMD & PKT_REQUEST_ERR CMD PKT_CMD_UERFACE_FACECHECK HEX 0x2003 Explanation Voyager 에얼굴검출을요청합니다. 성공 Integer (4bytes)-face count 1] Integer (2bytes)-face position left data Integer (2bytes)-face position top data Integer (2bytes)-face position right data Integer (2bytes)-face position bottom data 2] 1] ~ 2] 검출수만큼반복실패 CMD & PKT_REQUEST_ERR CMD PKT_CMD_UERFACE_USERLIST HEX 0x2004 Explanation Voyager 에등록된사용자목록을불러옵니다. Integer (4bytes)-user count 가변 bytes - Max 20bytes x user count, [0x2b] 구분자사용 CMD PKT_CMD_UERFACE_USERDEL HEX 0x2005 Byte User ID[x-bytes] Explanation Voyager 에등록된사용자를삭제합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_REINIT HEX 0x2006 Explanation UerFace 사용을초기화합니다. 성공 - CMD & PKT_REQUEST_OK - 22 -
CMD PKT_CMD_UERFACE_STATUS HEX 0x2007 Explanation UerFace 의상태값을반환합니다. Integer (4bytes)- UerFace Retcode CMD PKT_CMD_UERFACE_RESET HEX 0x2008 Explanation UerFace DB 를초기화합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_USERADD_INIT HEX 0x2009 Byte User ID[MAX 20bytes] Explanation Voyager 에사용자등록시작을요청합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_USERCHECK_INIT HEX 0x200a Explanation Voyager 에사용자확인시작을요청합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_FACECHECK_INIT HEX 0x200b Explanation Voyager 에얼굴검출시작을요청합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_USERADD_END HEX 0x200d Explanation Voyager 의사용자등록종료를요청합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_USERCHECK_END HEX 0x200e - 23 -
Explanation Voyager 의사용자확인종료를요청합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_FACECHECK_END HEX 0x200f Explanation Voyager 의얼굴검출종료를요청합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_USERADD_PREPROCESS HEX 0x2010 Explanation 사용자등록의안정화를위한전처리과정을진행합니다. Integer (4bytes)-. 0 : Ready. < 0 : Fail. > 0 : Correcting. Integer (2bytes)-face position left data Integer (2bytes)-face position top data Integer (2bytes)-face position right data Integer (2bytes)-face position bottom data 실패 CMD & PKT_REQUEST_ERR CMD PKT_CMD_UERFACE_USERADD_SAVE HEX 0x2014 Integer 4byte Useradd return code Explanation UerFace 등록처리가완료된사용자를저장합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_USERADD_ROLLBACK HEX 0x2015 Integer 4byte Useradd return code Explanation UerFace 등록처리가완료된사용자를취소합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_SET_SECLEVEL HEX 0x2020 Integer 4byte Security level 0 ~ 5-24 -
Explanation UerFace 인증수준을변경합니다. 0 낮음 ~ 5 높음성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_UERFACE_GET_SECLEVEL HEX 0x2021 Explanation UerFace 인증수준을불러옵니다. 성공 Integer (4bytes)- 0~5 value, -1 : error 3.2.3 카메라 CMD PKT_CMD_SET_CAMERA_INIT HEX 0x3019 Explanation Voyager 카메라를초기화합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_SET_CAMERA_CLOSE HEX 0x301A Explanation Voyager 카메라를종료합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_RECV_CAM_INFO HEX 0x1005 Explanation Voyager의 Camera 의전송정보를요청합니다성공 - Integer (4bytes)-image size Integer (2bytes)-image width Integer (2bytes)-image height Integer (4bytes)-byte size per second Integer (4bytes)-image crc CMD PKT_CMD_RECV_CAM_DATA HEX 0x3014-25 -
Explanation Voyager 의 Camera 를전송요청합니다. 성공 Integer (4bytes)-data size - data Integer (4bytes)-data crc 실패 CMD & PKT_REQUEST_ERR CMD PKT_CMD_UERFACE_IRLED HEX 0x200c Explanation Voyager의 IRLED On/Off 를요청합니다. 토글방식으로동작. 성공 - CMD & PKT_REQUEST_OK 3.2.3 데이터 CMD PKT_CMD_SEND_FILE_INFO HEX 0x1001 Integer (4bytes) Integer (4bytes) Integer (4bytes) Integer (4bytes) File size File type File fragmentation File crc Explanation Voyager 에전송할정보를전송합니다. 성공 - CMD & PKT_REQUEST_OK CMD PKT_CMD_SEND_FILE_DATA HEX 0x1002 Integer (4bytes) Integer (4bytes) data Size ( PKT Size (size info + crc info) ) data crc Explanation Voyager 에데이터를전송합니다. 성공 - CMD & PKT_REQUEST_OK 재전송요청 - CMD & PKT_REQUEST_RESEND CMD PKT_CMD_RECV_FILE_INFO HEX 0x1003 Integer (4bytes) Load Type Explanation Voyager 에 Type 에해당하는전송정보를요청합니다. - 26 -
성공 - Integer (4bytes)-size Integer (4bytes)-type Integer (4bytes)-frag Integer (4bytes)-crc CMD PKT_CMD_RECV_FILE_DATA HEX 0x1004 Explanation Voyager 에전송데이터를요청합니다. 성공 Integer (4bytes)-data size - data Integer (4bytes)-data crc 실패 CMD & PKT_REQUEST_ERR - 27 -
Chapter 4 - Use - 이항목은 Voyager 의 UerFace 를사용하기위한사용법을기술합니다. 이항목은다음과같이구성되어있습니다. 사용자등록사용자인증얼굴검출주의사항 - 28 -
4. UerFace 사용법 UerFace 를사용하기위해서는 1. Voyager에전원이인가되어야합니다. ( 5V ) 2. Voyager의관리자인증을해야합니다. ( PKT_CMD_CONFIRM_USER ) 3. 카메라가구동되고, IRLED에불빛이보여야합니다. ( PKT_CMD_SET_CAMERA_INIT ) 4. 이후 UERFACE의초기화 (S/W초기화) 를진행하면다음과같은절차들을요청할수있습니다. A. Voyager 구입시최초의 S/W초기화가필요 ( S/W초기화이후자동초기화됨 ) S/W초기화 PKT_CMD_UERFACE_REINIT 4.1 사용자등록 사용자등록을하기위한절차는다음과같습니다. I. PKT_CMD_UERFACE_USERADD_INIT A. 사용자의 ID를입력합니다. 최대 20bytes ( 영문, 숫자 ) - 29 -
II. PKT_CMD_UERFACE_USERADD_PREPROCESS A. Ready(0) 값이반환될때까지반복적인실행을합니다. B. 음수가반환되면카메라의초기화와 LED의상태를확인한뒤 [I] 절차부터다시시작하십시오. III. PKT_CMD_UERFACE_USERADD A. >=0 값이반환될때까지반복적인실행을합니다. B. 등록은 2포즈를등록할수있습니다. ( 첫번째포즈가등록되면 -110값이반환됨 ) C. TIMEOVER의추천하는값은포즈당 15초입니다. IV. 등록처리완료 A. PKT_CMD_UERFACE_USERADD_SAVE 또는 PKT_CMD_UERFACE_USERADD_ROLLBACK 를전송합니다. B. 등록처리된사용자를저장하기위해서는 PKT_CMD_UERFACE_USERADD_SAVE 전송 C. 등록처리된사용자를취소하기위해서는 PKT_CMD_UERFACE_USERADD_ROLLBACK 전송 V. PKT_CMD_UERFACE_USERADD_END 4.2 사용자인증 사용자인증을하기위한절차는다음과같습니다. I. PKT_CMD_UERFACE_USERCHECK_INIT II. PKT_CMD_UERFACE_USERCHECK A. >=0 값이반환될때까지반복적인실행을합니다. B. TIMEOVER의추천하는값은 10초이내입니다 III. PKT_CMD_UERFACE_USERCHECK_END 4.3 얼굴검출 얼굴검출을하기위한절차는다음과같습니다. - 30 -
I. PKT_CMD_UERFACE_FACECHECK_INIT II. PKT_CMD_UERFACE_FACECHECK A. 영상에보이는얼굴을최대 5명동시검출합니다. B. 검출된수와좌표는순서대로반환됩니다. III. PKT_CMD_UERFACE_FACECHECK_END 4.4 주의사항 I. 사용자등록 A. UerFace 에정의된사양에맞게위치와포즈를취합니다. i. 거리 40cm ~ 60cm ii. 얼굴을카메라의가운데에위치하십시오. II. 사용자인증 A. 등록시의상황과가장유사하게만들어줍니다. III. 얼굴검출 A. 조명이비춰지는범위내에얼굴을위치하십시오. - 31 -
Chapter 5 - SDK - 이항목은 Voyager Sample Code 에관련된사항을기술합니다. 이항목은다음과같이구성되어있습니다. Android Linux Windows Arduino - 32 -
5. Voyager SDK Voyager는 UART 인터페이스가지원되는다양한플랫폼에서동작이가능합니다. 이중 CRASID에서제공하는 SDK는다음과같은환경에서테스트및제작되었습니다. ANDROID - 블루투스모듈사용 HC-06 LINUX - Open Hardware UART pin 사용 Hardkernel C1, Raspberry Pi2 WINDOWS -.NET 4.0 환경기반 USB to UART 모듈사용 Arduino UNO 연결하고자하는디바이스에맞는펌웨어를업데이트하시면됩니다. 제공되는파일은다음과같습니다. voy115 115200bps의초기속도 voy96 9600bps의초기속도 9600bps 속도는파일업 / 다운로드를할수없습니다. 최소 115200bps - (frame length : 14400bytes) 를사용해주십시오. 5.1 ANDROID 안드로이드레퍼런스로 NEXUS 5를사용했으며, 아두이노및라즈베리파이에서많이쓰이는 HC-06 블루투스모듈을사용해서작성되었습니다. 모듈의모습은위와같으며 Voyager 와 115200bps 의전송속도로통신합니다. 제공된 android_voy_sample_xxx.zip 파일은 eclipse kepler 버전의프로젝트파일입니다. Import 후실행하면아래와같은어플리케이션이실행됩니다. - 33 -
5.1.1 메인페이지 최초메인페이지는다음과같으며, 아래에서설명한기능을수행합니다. MGRPW : Voyager의비밀번호를입력합니다. ( DEFAULT : 9876 ) USB Open : USB모듈로접속합니다. Baudrate : Baudrate를변경할수있습니다. Clear : 어플하단에나타나는로그를지웁니다. BT Open : 페어링된블루투스모듈과접속합니다. File Transfer: 펌웨어를업데이트할수있습니다. (115200bps이상사용가능 ) UerFace: UerFace 관련작업을수행합니다. Link Test : Voyager 접속상태를확인합니다. Alive? : Voyager의사용가능상태를확인합니다. SetTime : 현재시간을 Voyager에전송하여설정합니다. Change PW : 비밀번호를변경합니다.. Voyager 연결방법 1. Voyager에전원을인가합니다. 2. MGRPW에 Voyager 비밀번호를입력합니다. ( 기본 : 9876) 3. BT OPEN을클릭합니다. 4. 블루투스모듈을선택하여클릭합니다. 접속이되면자동으로메인페이지로돌아갑니다. A. 리스트에해당모듈이보이지않을시페어링상태를먼저확인하세요. 5. 연결확인을위해서 Link Test 버튼을클릭합니다. 6. 하단로그창에 Link ok란메시지가보이면연결은된상태입니다. A. Link fail 메시지가나타나는경우블루투스모듈과접속상태및블루투스-Voyager의연결상태를확 인한후 [3] 부터다시시도하세요. 7. 연결이된상태에서 Alive? 를클릭하십시오. 8. Certification ok 및 Alive ok 메시지가나타나면인증이완료된상태이며 Voyager의모든기능을사용할 - 34 -
수있습니다. A. Fail 이나타나면비밀번호가정확히입력됐는지확인해주십시오. 5.1.2 시스템업데이트 File Transfer 를클릭하여다음과같은페이지에접근합니다. 1. 위의그림과같이설정된부분을변경하지않습니다.( 타메뉴지원하지않음 ) 2. Find를클릭하여업로드할파일을선택합니다. 3. PROCESSING 버튼을누르면파일업로드를진행합니다. 4. 완료후펌웨어팝업이나타나게됩니다. YES를클릭하게되면업로드된파일을적용합니다. 5. 업데이트완료후자동으로재부팅됩니다. 6. 메인페이지로되돌아가서 Alive 버튼을사용해서인증을하십시오. 5.1.3 UerFace 라이브러리를테스트하기위한메뉴는다음과같습니다. - 35 -
CAM-ON : 카메라를초기화합니다. CAM-OFF : 카메라를종료합니다. UF-INIT : 라이브러리를초기화합니다. FD-INIT : 얼굴검출을초기화합니다. FD-RUN : 얼굴검출을실행합니다. Clear : 하단로그를삭제합니다. REG-INIT : 사용자등록을초기화합니다. REG-RUN : 사용자등록을실행합니다. UserMgr : 등록된사용자를관리합니다. REC-INIT : 사용자확인을초기화합니다. REG-RUN : 사용자확인을진행합니다. Log : Voyager에남겨진로그를확인합니다. VIEW : 카메라영상을읽어옵니다. LED-ONOFF : LED를 ON/OFF 합니다.( 토글방식 ) STATUS : 현재라이브러리초기상태를확인합니다. RESET : 라이브러리 DB를초기화합니다. Version : 현재 Voayger의버전정보를확인합니다.. 검출실행방법 1. CAM-ON을실행합니다. 2. Voyager의 LED에붉은빛이보인다면카메라초기화가완료된것입니다. 3. FD-INIT을실행합니다. 하단로그창에 FD init ok가나타나면검출초기화가완료된것입니다. 4. FD-RUN을실행합니다. 5. 화면에현재의검출된부분이나타나게됩니다. 6. 취소하려면이전버튼을클릭하십시오. - 36 -
. 등록실행방법 1. CAM-ON을실행합니다. ( 이전에 CAM-ON실행되었다면 3번과정부터시작하십시오. ) 2. 카메라초기화를확인합니다. 3. REG-INIT을실행합니다. 4. 팝업창에지시에따라 ID를입력합니다. A. 영문자 또는 숫자 만가능합니다. B. 등록된 ID는진행할수없습니다. 5. OK를눌러서초기화를완료합니다. 6. REG-RUN을실행합니다. 7. 안내음성에따라자신의위치를화면의가운데에위치시킵니다. 화면의표시가녹색의안정된출력이 된다면하단의 RegRun 버튼을클릭합니다. 이때에안정된자세를유지하여주십시오. 8. 첫번째포즈가등록이되면, 팝업창이나타나알려줍니다. 9. 팝업창확인후 7번의과정을한번더하게됩니다. 10. 등록이완료되면등록완료팝업창이나타나게되며, 이때 Confirm을눌러서저장을할수있고, Cancel 을눌러서등록을취소할수있습니다.. 인증실행방법 1. CAM-ON을실행합니다. ( 이전에 CAM-ON실행되었다면 3번과정부터시작하십시오. ) 2. 카메라초기화를확인합니다. 3. REC-INIT을실행합니다. 4. 초기화완료후 REC-RUN을실행합니다. 5. 등록된포즈와유사하게자세를취해주십시오. 6. 인증이확인되면완료메시지를출력하게됩니다. 5.2 LINUX Hardkenel C1 의 GPIO 에아래의그림과같이 Voyager 를연결합니다. ( Raspberry pi pin 배열동일함 ) C1 PIN Voyager PIN 1 1 6 4 8 3 10 2-37 -
제공된 linux_voy_sample_xxx.zip 를타겟시스템에업로드합니다. 압축을해제한후 make명령어를이용해서컴파일합니다. 컴파일이완료되면 remotevoy 파일이생성됩니다.. remotevoy 실행방법 1. remotevoy [dev] [baudrate] 형식에맞게입력을해줍니다. A. Voyager Baudrate 초기값은 115200bps입니다. 시스템에맞게초기에변경하여사용하십시오. i. Hardkernel c1과속도는 3000000bps 또는 1000000bps를추천합니다. B. 이후변경내용은저장되지않습니다. ( 재부팅후 115200bps 로초기화 ) 2. Link 테스트후비밀번호를입력하고접속이완료되면 3. cmd# 을확인할수있습니다. 4. help명령어를사용해서지원되는명령어를볼수있습니다.. 지원명령어 help : 사용가능한명령어를확인합니다. version : remotevoy 버전정보를확인합니다. sys : 시스템설정을합니다. reboot : 재부팅을요청합니다. test : 연결테스트를합니다. alive : 접속테스트를합니다. time : voyager 시간을설정합니다. mgrpw : 비밀번호를변경합니다. update : 소프트웨어를업데이트합니다. uf : 라이브러리를사용합니다. init : 라이브러리초기화를합니다. status : 라이브러리상태값을확인합니다. reset : 라이브러리 DB를초기화합니다. reg : 사용자등록을진행합니다. rec : 사용자확인을진행합니다. userlist : 사용자목록을확인합니다. userdel : 등록된사용자를삭제합니다. - 38 -
reclog : 인증로그를확인합니다. fd : 얼굴검출을실행합니다. cam : 카메라를제어합니다. init : 카메라를초기화합니다. led : LED를제어합니다.( 토글모드 ) close : 카메라를종료합니다. read : 영상을읽어옵니다. 5.3 WINDOWS USB to UART 모듈을이용하여 PC와연결했으며그형태는다음과같습니다. USB to UART모듈의칩마다최대속도차이가발생할수있으니고려하면됩니다. PC 에서공급되는전원을사용하여구동을하며 TX->RX, RX->TX 를구분하여연결하면됩니다. 제공된 windows_voy_sample_xxx.zip 파일은 vs2010 버전의프로젝트파일입니다. Import 후실행하면아래와같은어플리케이션이실행됩니다. CLI 기반으로리눅스와사용법이거의같습니다. - 39 -
5.3.1 MENU-SERIAL 현재설정되어있는 port 로연결및중단을요청합니다. Connect 메뉴를이용해연결이되면아래의 STATUS 에현재의상태정보가확인됩니다. - 40 -
5.3.1 MENU-Setting Serial Port 의연결설정을합니다. Serial Port : 연결할수있는 COM포트설정 LineBuffer : 메인화면의라인버퍼크기를설정하며, 크기를초과할경우현재내용은저장되며화면은초기화됩니다. Baudrate : COM포트의연결속도를설정합니다. FT231x : 최대 3Mbps 지원 CP210x : 최대 1.5Mbps 지원 5.3.2 Usage 1. VoyClient를실행합니다. 2. Setting -> Serial 메뉴를실행합니다. A. 연결된 Serial Port를입력합니다. B. 현재통신속도를선택합니다. 3. Setting 설정후 Serial -> Connect를선택하여접속합니다. A. 접속이되면 5.3.1의그림과같이하단에접속상태가나타나게됩니다. 4. sys test 명령어를사용합니다. A. 링크연결상태를확인합니다. B. OK가나타나면연결이된상태입니다. 5. sys mgrpw [PW] 명령어를사용합니다. A. [PW] 에설정된관리자비밀번호를입력합니다. B. 기본설정값은 9876 입니다. C. OK가나타나면 Voyager의모든기능이활성화됩니다. 6. help명령어를사용해서지원되는명령어를볼수있습니다.. 지원명령어 help : 사용가능한명령어를확인합니다. - 41 -
clear : 화면의내용을지웁니다. sys : 시스템설정을합니다. reboot : 재부팅을요청합니다. test : 연결테스트를합니다. alive : 접속테스트를합니다. time : voyager 시간을설정합니다. mgrpw : 비밀번호를변경합니다. update : 소프트웨어를업데이트합니다. version : 시스템의버전정보를확인합니다. flen : Frame Length를수정합니다. uf : 라이브러리를사용합니다. init : 라이브러리초기화를합니다. status : 라이브러리상태값을확인합니다. reset : 라이브러리 DB를초기화합니다. reg : 사용자등록을진행합니다. rec : 사용자확인을진행합니다. userlist : 사용자목록을확인합니다. userdel : 등록된사용자를삭제합니다. reclog : 인증로그를확인합니다. fd : 얼굴검출을실행합니다. cam : 카메라를제어합니다. init : 카메라를초기화합니다. led : LED를제어합니다.( 토글모드 ) close : 카메라를종료합니다. read : 영상을읽어옵니다. 5.4 ARDUINO UNO Arduino UNO의 GPIO에아래의그림과같이 Voyager를연결합니다. ( VDD는연결하지않습니다 ) 이때주의사항은 1. Arduino의핀레벨은 5V이고 Voyager의핀레벨은 3.3V 이기때문에레벨쉬프터를사용하여전압을맞춰야합니다. 2. Voyager에필요한전원공급은외부어뎁터를이용한방법을사용해야합니다. - 42 -
제공된 arduino_voy_sample_xxx.zip를아두이노ide에복사합니다. Voy 폴더는 libraries에 voyh폴더는자신의작업폴더에복사를합니다. 컴파일후아두이노에업로드하여실행을합니다. 제공된 voyh 코드는 1초주기로 Voyager와통신을확인하며카메라를실행하고인증테스트를진행하는테스트코드입니다. - 43 -
Appendix 용어정의 UerFace: 크라스아이디의얼굴인식라이브러리 HC-06 : Bluetooth to UART 모듈 Hardkernel C1 : 하드커널에서판매하고있는 ARM기반의테스트보드 FT231x : USB to Serial chip CP210x : USB to Serial chip UerFace Code 정의 값 내용 FACE_OK 0 success FACE_FAIL -1 fail ERR_NOT_ENOUGH_MEMORY -10 not enough memory ERR_TIMEOUT -50 time out ERR_INVALID_SEC_LEVEL -51 invalid security level ERR_INVALID_VERSION -57 invalid version ERR_DB_UNINITIALIZED -58 db un-initialized ERR_INVALID_DB -59 invalid db handle ERR_DB_EMPTY -60 no enrolled user ERR_DB_FULL -61 enroll database is full ERR_NO_REGISTERED_ID -62 no registered user id ERR_INVALID_ID -63 invalid user id ERR_REGISTERED_ID -64 already registered user id ERR_INVALID_RID -65 invalid user record index ERR_INVALID_PASSWORD -66 invalid password ERR_MULTIPLE_FACES -67 detected multiple faces ERR_NO_FACE -68 detected no face ERR_INVALID_IMAGE -69 invalid image ERR_INVALID_FACE_IMAGE -70 invalid face image ERR_BAD_QUALITY -71 bad image quality ERR_INVALID_USER_RECORD -72 invalid user record(data) ERR_INVALID_FEATURE -73 bad facial feature ERR_ALREADY_EXIST -74 file already exist ERR_INVALID_NAME -75 invalid name ERR_CREATION -76 creation error - 44 -
ERR_INVALID_ID_LENGTH -77 invalid user id length (max20 is valid length) ERR_BOUNDARY -79 out of boundary ERR_INVALID_HANDLE -80 invalid memory WRN_REQUEST_REGISTER -100 registration interrupt WRN_ENROLL_GLASSES -101 ask for wearing glasses registration WRN_GLARE_NOISE -102 glare noise WRN_CLOSED_EYE -103 closed eye MSG_PROC_SUSPEND -110 break while enrollment MSG_PROC_RUNNING -111 enroll process is running 리커버리진입 1. Voyager의전원을끈다. 2. Voyager의 GPIO (G1) 에 3.3V 입력을연결한다. 3. Voyager의전원을연결한다. 4. LED에 6개의불이모두켜지면리커버리모드로진입성공. 5. PKT_CMD_TEST를사용하여제대로연결되는지확인합니다. A. 리커버리모드의속도는 115200bps로고정되어있습니다. B. 응답이없으면연결상태를확인해주십시오. - 45 -
- 46 -
Contact 크라스아이디 ( CrasID Co., Ltd. ) 홈페이지 : www.crasid.com 기술지원 : support@crasid.com 제품문의 : sales@crasid.com - 47 -