Sample to operate omron HVC-P2 on GR-PEACH.

Dependencies:   AsciiFont

Information

Please see here for Japanese version.
日本語版はこちらを参照ください。

What is this ?

This is a sample that runs OMRON HVC-P2 with GR-PEACH. In this sample, you can try following among the functions of HVC-P2 : Human Body Detection, Face Detection, Age Estimation, Gender Estimation, Expression Estimation and Face Recognition.
Both GR-PEACH and HVC-P2 use Renesas RZ/A1H included ARM® Cortex™-A9 processor.

/media/uploads/dkato/hvcp2_demo_img3.jpg

HVC-P2 (Human Vision Components B5T-007001) is a human-sensing component that recognizes people. It is an integrated module that is built into other device and provides both the OKAO Vision's ten types of image sensing and a camera module.
For details, please refer to the following link.

In the HVCApi folder of this sample, the code of the following link destination Sample Code "SampleCode_rev.2.0.2" is used. (You can download from "Product Information" -> "Sample Code" in the middle of the following page.)
http://www.omron.com/ecb/products/mobile/hvc_p2/

Constitution

  1. HVC-P2 x 1
  2. USBA-microUSB conversion cable x 2
  3. USBA-microUSB conversion adapter x 1
  4. GR-PEACH x 1
  5. 4.3inc LCD shield x 1

/media/uploads/dkato/composition_hvcp2_demo.jpg

/media/uploads/dkato/composition_hvcp2_demo_2.jpg

Please close JP3 of GR-PEACH.
/media/uploads/RyoheiHagimoto/usb.jpg

How to use

It starts when connecting the power supply USB cable. At startup, all functions are turned off. By pressing the button on the right of the screen you can switch the function on / off.

  • Function ON : orange or green
  • Function OFF : blue or gray

Only the FACE button changes to "FACE (blue) -> FACE (orange) -> RECOGNITION (green)". When FACE (blue), following buttons are gray and can not be operated : AGE, GENDER and EXPRESSION.
"Response time" at the bottom left of the screen indicates "image processing + USB transfer time". It is not pure image processing time.

Register Data (Face Recognition)

Set the FACE button to RECOGNITION (green), and touch the screen with one person on the screen to register the face. In this sample, face registration will record up to 10 people. Delete the old registrant when registering after 11 people. Registration information is stored in the RAM on the HVC-P2 side. It is discarded by power off and reset.

/media/uploads/dkato/hvcp2_demo_img2.jpg

Change parameters

When you press Config icon at the bottom right of the screen, the parameter setting screen is displayed. You can change threshold value, detection size and face angle parameters.

/media/uploads/dkato/hvcp2_demo_config_icon.jpg
/media/uploads/dkato/hvcp2_demo_config.jpg

Change transfer image size

By pressing USER_BUTTON0 on the back of the board, the image transfer size switches in the order of "160 x 120 -> 320 x 240 -> no image".
/media/uploads/dkato/gr-peach_switch2.jpg

HVC/HVCApi/HVCDef.h

Committer:
dkato
Date:
2018-09-28
Revision:
8:92c19be0aced
Parent:
5:49a61433290a

File content as of revision 8:92c19be0aced:

/*---------------------------------------------------------------------------*/
/* Copyright(C)  2017  OMRON Corporation                                     */
/*                                                                           */
/* Licensed under the Apache License, Version 2.0 (the "License");           */
/* you may not use this file except in compliance with the License.          */
/* You may obtain a copy of the License at                                   */
/*                                                                           */
/*     http://www.apache.org/licenses/LICENSE-2.0                            */
/*                                                                           */
/* Unless required by applicable law or agreed to in writing, software       */
/* distributed under the License is distributed on an "AS IS" BASIS,         */
/* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  */
/* See the License for the specific language governing permissions and       */
/* limitations under the License.                                            */
/*---------------------------------------------------------------------------*/

#ifndef HVCDef_H__
#define HVCDef_H__

/*----------------------------------------------------------------------------*/
/* Execution flag */
#define HVC_ACTIV_BODY_DETECTION        0x00000001
#define HVC_ACTIV_HAND_DETECTION        0x00000002
#define HVC_ACTIV_FACE_DETECTION        0x00000004
#define HVC_ACTIV_FACE_DIRECTION        0x00000008
#define HVC_ACTIV_AGE_ESTIMATION        0x00000010
#define HVC_ACTIV_GENDER_ESTIMATION     0x00000020
#define HVC_ACTIV_GAZE_ESTIMATION       0x00000040
#define HVC_ACTIV_BLINK_ESTIMATION      0x00000080
#define HVC_ACTIV_EXPRESSION_ESTIMATION 0x00000100
#define HVC_ACTIV_FACE_RECOGNITION      0x00000200

/* Image info of Execute command */
#define HVC_EXECUTE_IMAGE_NONE          0x00000000
#define HVC_EXECUTE_IMAGE_QVGA          0x00000001
#define HVC_EXECUTE_IMAGE_QVGA_HALF     0x00000002

/*----------------------------------------------------------------------------*/
/* Error code */

/* Parameter error */
#define HVC_ERROR_PARAMETER             -1

/* Send signal timeout error */
#define HVC_ERROR_SEND_DATA             -10

/* Receive header signal timeout error */
#define HVC_ERROR_HEADER_TIMEOUT        -20
/* Invalid header error */
#define HVC_ERROR_HEADER_INVALID        -21
/* Receive data signal timeout error */
#define HVC_ERROR_DATA_TIMEOUT          -22


/*----------------------------------------------------------------------------*/
/* Album data size */
#define HVC_ALBUM_SIZE_MIN              32
#define HVC_ALBUM_SIZE_MAX              816032

/*----------------------------------------------------------------------------*/
/* Expression */
typedef enum {
    EX_NEUTRAL = 1,
    EX_HAPPINESS,
    EX_SURPRISE,
    EX_ANGER,
    EX_SADNESS
}EXPRESSION;

/*----------------------------------------------------------------------------*/
/* Struct                                                                     */
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
/* Devicefs model and version info                                           */
/*----------------------------------------------------------------------------*/
typedef struct {
    UINT8   string[12];
    UINT8   major;
    UINT8   minor;
    UINT8   relese;
    UINT8   revision[4];
}HVC_VERSION;

/*----------------------------------------------------------------------------*/
/* Detection result                                                           */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   posX;       /* Center x-coordinate */
    INT32   posY;       /* Center y-coordinate */
    INT32   size;       /* Size */
    INT32   confidence; /* Degree of confidence */
}DETECT_RESULT;

/*----------------------------------------------------------------------------*/
/* Face direction                                                             */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   yaw;        /* Yaw angle */
    INT32   pitch;      /* Pitch angle */
    INT32   roll;       /* Roll angle */
    INT32   confidence; /* Degree of confidence */
}DIR_RESULT;

/*----------------------------------------------------------------------------*/
/* Age                                                                        */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   age;        /* Age */
    INT32   confidence; /* Degree of confidence */
}AGE_RESULT;

/*----------------------------------------------------------------------------*/
/* Gender                                                                     */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   gender;     /* Gender */
    INT32   confidence; /* Degree of confidence */
}GENDER_RESULT;

/*----------------------------------------------------------------------------*/
/* Gaze                                                                       */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   gazeLR;     /* Yaw angle */
    INT32   gazeUD;     /* Pitch angle */
}GAZE_RESULT;

/*----------------------------------------------------------------------------*/
/* Blink                                                                      */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   ratioL;     /* Left eye blink result */
    INT32   ratioR;     /* Right eye blink result */
}BLINK_RESULT;

/*----------------------------------------------------------------------------*/
/* Expression                                                                 */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   topExpression;  /* Top expression */
    INT32   topScore;       /* Top score */
    INT32   score[5];       /* Score of 5 expression */
    INT32   degree;         /* Negative-positive degree */
}EXPRESSION_RESULT;

/*----------------------------------------------------------------------------*/
/* Face Recognition                                                           */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   uid;        /* User ID */
    INT32   confidence; /* Degree of confidence */
}RECOGNITION_RESULT;

/*----------------------------------------------------------------------------*/
/* Face Detection & Estimations result                                        */
/*----------------------------------------------------------------------------*/
typedef struct{
    DETECT_RESULT       dtResult;           /* Face detection result */
    DIR_RESULT          dirResult;          /* Face direction estimation result */
    AGE_RESULT          ageResult;          /* Age Estimation result */
    GENDER_RESULT       genderResult;       /* Gender Estimation result */
    GAZE_RESULT         gazeResult;         /* Gaze Estimation result */
    BLINK_RESULT        blinkResult;        /* Blink Estimation result */
    EXPRESSION_RESULT   expressionResult;   /* Expression Estimation result */
    RECOGNITION_RESULT  recognitionResult;  /* Face Recognition result */
}FACE_RESULT;

/*----------------------------------------------------------------------------*/
/* Human Body Detection results                                               */
/*----------------------------------------------------------------------------*/
typedef struct{
    UINT8           num;            /* Number of Detection */
    DETECT_RESULT   bdResult[35];   /* Detection result */
}BD_RESULT;

/*----------------------------------------------------------------------------*/
/* Hand Detection results                                                     */
/*----------------------------------------------------------------------------*/
typedef struct{
    UINT8           num;            /* Number of Detection */
    DETECT_RESULT   hdResult[35];   /* Detection result */
}HD_RESULT;

/*----------------------------------------------------------------------------*/
/* Face Detection & Estimations results                                       */
/*----------------------------------------------------------------------------*/
typedef struct{
    UINT8           num;            /* Number of Detection */
    FACE_RESULT     fcResult[35];   /* Detection & Estimations result */
}FD_RESULT;

/*----------------------------------------------------------------------------*/
/* Image data                                                                 */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   width;
    INT32   height;
    UINT8   image[320*240];
}HVC_IMAGE;

/*----------------------------------------------------------------------------*/
/* Eesult data of Execute command                                             */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32       executedFunc;   /* Execution flag */
    BD_RESULT   bdResult;       /* Human Body Detection results */
    HD_RESULT   hdResult;       /* Hand Detection results */
    FD_RESULT   fdResult;       /* Face Detection & Estimations results */
    HVC_IMAGE   image;          /* Image data */
}HVC_RESULT;

/*----------------------------------------------------------------------------*/
/* Threshold of confidence                                                    */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   bdThreshold;        /* Threshold of confidence of Human Body Detection */
    INT32   hdThreshold;        /* Threshold of confidence of Hand Detection */
    INT32   dtThreshold;        /* Threshold of confidence of Face Detection */
    INT32   rsThreshold;        /* Threshold of confidence of Face Recognition */
}HVC_THRESHOLD;

/*----------------------------------------------------------------------------*/
/* Detection size                                                             */
/*----------------------------------------------------------------------------*/
typedef struct{
    INT32   bdMinSize;          /* Minimum detection size of Human Body Detection */
    INT32   bdMaxSize;          /* Maximum detection size of Human Body Detection */
    INT32   hdMinSize;          /* Minimum detection size of Hand Detection */
    INT32   hdMaxSize;          /* Maximum detection size of Hand Detection */
    INT32   dtMinSize;          /* Minimum detection size of Face Detection */
    INT32   dtMaxSize;          /* Maximum detection size of Face Detection */
}HVC_SIZERANGE;

#endif /* HVCDef_H__ */