Rename vehicle_rvc to vehicle_camera
BUG: 25261672 BUG: 25226538 BUG: 22701467 BUG: 26557463 Change-Id: Ideff9a13d61d7242c2f92212222809c7785970ee
This commit is contained in:
Steve Paik
parent
17908ca83d
commit
11e530f546
2 changed files with 188 additions and 156 deletions
188
include/hardware/vehicle_camera.h
Normal file
188
include/hardware/vehicle_camera.h
Normal file
|
|
@ -0,0 +1,188 @@
|
|||
/*
|
||||
* Copyright (C) 2016 The Android Open Source Project
|
||||
*
|
||||
* 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 ANDROID_VEHICLE_CAMERA_INTERFACE_H
|
||||
#define ANDROID_VEHICLE_CAMERA_INTERFACE_H
|
||||
|
||||
#include <errno.h>
|
||||
#include <stdint.h>
|
||||
#include <sys/cdefs.h>
|
||||
#include <sys/types.h>
|
||||
|
||||
#include <hardware/hardware.h>
|
||||
#include <cutils/native_handle.h>
|
||||
#include <system/window.h>
|
||||
|
||||
__BEGIN_DECLS
|
||||
|
||||
/*****************************************************************************/
|
||||
|
||||
#define VEHICLE_CAMERA_HEADER_VERSION 1
|
||||
#define VEHICLE_CAMERA_MODULE_API_VERSION_1_0 HARDWARE_MODULE_API_VERSION(1, 0)
|
||||
#define VEHICLE_CAMERA_DEVICE_API_VERSION_1_0 HARDWARE_DEVICE_API_VERSION_2(1, 0, VEHICLE_CAMERA_HEADER_VERSION)
|
||||
|
||||
/**
|
||||
* Vehicle Camera to provide interfaces for controlling cameras
|
||||
*/
|
||||
|
||||
/**
|
||||
* The id of this module
|
||||
*/
|
||||
#define VEHICLE_CAMERA_HARDWARE_MODULE_ID "vehicle_camera"
|
||||
|
||||
/**
|
||||
* Name of the vehicle device to open. Extend this list as
|
||||
* more cameras are added. Each camera defined in vehicle_camera_type_t
|
||||
* shall have a string defined for it.
|
||||
*/
|
||||
#define VEHICLE_CAMERA_RVC_DEVICE "vehicle_camera_rvc_device"
|
||||
|
||||
/**
|
||||
* Each camera on the car shall be enumerated
|
||||
*/
|
||||
typedef enum {
|
||||
VEHICLE_CAMERA_RVC = 1,
|
||||
} vehicle_camera_type_t;
|
||||
|
||||
/**
|
||||
* Describes the current state of camera device
|
||||
*/
|
||||
typedef struct {
|
||||
uint32_t overlay_on;
|
||||
uint32_t camera_on;
|
||||
} vehicle_camera_state_t;
|
||||
|
||||
/**
|
||||
* Bitmask of features supported by a camera module
|
||||
*/
|
||||
enum {
|
||||
VEHICLE_CAMERA_CONFIG_FLAG_ANDROID_OVERLAY_SUPPORT = 0x1,
|
||||
VEHICLE_CAMERA_CONFIG_FLAG_CAMERA_CROP_SUPPORT = 0x2,
|
||||
VEHICLE_CAMERA_CONFIG_FLAG_CAMERA_POSITIONING_SUPPORT = 0x4
|
||||
} vehicle_camera_config_flag;
|
||||
|
||||
typedef struct {
|
||||
uint32_t capabilites_flags;
|
||||
uint32_t camera_width;
|
||||
uint32_t camera_height;
|
||||
uint32_t display_width;
|
||||
uint32_t display_height;
|
||||
} vehicle_camera_cap_t;
|
||||
|
||||
/************************************************************************************/
|
||||
|
||||
/**
|
||||
* Every hardware module must have a data structure named HAL_MODULE_INFO_SYM
|
||||
* and the fields of this data structure must begin with hw_module_t
|
||||
* followed by module specific information.
|
||||
*/
|
||||
typedef struct {
|
||||
struct hw_module_t common;
|
||||
/**
|
||||
* Queries the HW for the cameras installed on the vehicle
|
||||
* @param num_cameras - number of camera devices available. If
|
||||
* 0 is returned, an error has occurred and
|
||||
* the return pointer shall be NULL.
|
||||
* @return pointer to an array of vehicle_camera_type_t to
|
||||
* denote which cameras are installed. This pointer is
|
||||
* only valid while the vehicle hal is loaded. If the
|
||||
* pointer is NULL, then an error has occurred and
|
||||
* num_cameras shall be 0.
|
||||
*/
|
||||
const uint32_t * (*get_camera_device_list)(uint32_t *num_cameras);
|
||||
} vehicle_camera_module_t;
|
||||
|
||||
|
||||
typedef struct vehicle_camera_device_t {
|
||||
struct hw_device_t common;
|
||||
|
||||
const uint32_t camera_type;
|
||||
|
||||
/**
|
||||
* Returns the capabilities of this camera.
|
||||
* @param device - device handle
|
||||
* @param cap - pointer to capabilities flags being returned
|
||||
* @return 0 on success
|
||||
* -EPERM if device is invalid or not initialized
|
||||
*/
|
||||
int (*get_capabilities)(struct vehicle_camera_device_t *device, vehicle_camera_cap_t *cap);
|
||||
|
||||
/**
|
||||
* Gets the current camera crop settings.
|
||||
* @param device - device handle
|
||||
* @param rect - current camera crop settings
|
||||
* @return 0 on success
|
||||
* -EPERM if device is not initialized
|
||||
* -errno on error
|
||||
*/
|
||||
int (*get_camera_crop)(struct vehicle_camera_device_t *device, android_native_rect_t *rect);
|
||||
|
||||
/**
|
||||
* Sets the camera crop.
|
||||
* @param device - device handle
|
||||
* @param rect - area of camera input to crop. Must fit within
|
||||
* camera width and height from camera capabilities.
|
||||
* @return 0 on success
|
||||
* -EPERM if device is not initialized
|
||||
* -errno on error
|
||||
*/
|
||||
int (*set_camera_crop)(struct vehicle_camera_device_t *device, const android_native_rect_t *rect);
|
||||
|
||||
/**
|
||||
* Gets position of the camera on the display.
|
||||
* @param device - device handle
|
||||
* @param rect - area of display the camera will appear when on
|
||||
* @return 0 on success
|
||||
* -EPERM if device is not initialized
|
||||
* -errno on error
|
||||
*/
|
||||
int (*get_camera_position)(struct vehicle_camera_device_t *device, android_native_rect_t *rect);
|
||||
|
||||
/**
|
||||
* Sets position of the camera on the display.
|
||||
* @param device - device handle
|
||||
* @param rect - area of display the camera will appear when on.
|
||||
* Must fit within display width and height from
|
||||
* camera capabilities.
|
||||
* @return 0 on success
|
||||
* -EPERM if device is not initialized
|
||||
* -errno on error
|
||||
*/
|
||||
int (*set_camera_position)(struct vehicle_camera_device_t *device, const android_native_rect_t *rect);
|
||||
|
||||
/**
|
||||
* Gets the current camera state.
|
||||
* @param device - device handle
|
||||
* @param state - last setting for the camera
|
||||
* @return 0 on success
|
||||
* -EPERM if device is not initialized
|
||||
*/
|
||||
int (*get_camera_state)(struct vehicle_camera_device_t *device, vehicle_camera_state_t *state);
|
||||
|
||||
/**
|
||||
* Sets the camera state.
|
||||
* @param device - device handle
|
||||
* @param state - desired setting for the camera
|
||||
* @return 0 on success
|
||||
* -EPERM if device is not initialized
|
||||
* -errno on error
|
||||
*/
|
||||
int (*set_camera_state)(struct vehicle_camera_device_t *device, const vehicle_camera_state_t *state);
|
||||
} vehicle_camera_device_t;
|
||||
|
||||
__END_DECLS
|
||||
|
||||
#endif // ANDROID_VEHICLE_CAMERA_INTERFACE_H
|
||||
|
|
@ -1,156 +0,0 @@
|
|||
/*
|
||||
* Copyright (C) 2016 The Android Open Source Project
|
||||
*
|
||||
* 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 ANDROID_VEHICLE_RVC_INTERFACE_H
|
||||
#define ANDROID_VEHICLE_RVC_INTERFACE_H
|
||||
|
||||
#include <stdint.h>
|
||||
#include <sys/cdefs.h>
|
||||
#include <sys/types.h>
|
||||
#include <errno.h>
|
||||
|
||||
#include <hardware/hardware.h>
|
||||
#include <cutils/native_handle.h>
|
||||
|
||||
__BEGIN_DECLS
|
||||
|
||||
/*****************************************************************************/
|
||||
|
||||
#define VEHICLE_RVC_HEADER_VERSION 1
|
||||
#define VEHICLE_RVC_MODULE_API_VERSION_1_0 HARDWARE_MODULE_API_VERSION(1, 0)
|
||||
#define VEHICLE_RVC_DEVICE_API_VERSION_1_0 HARDWARE_DEVICE_API_VERSION_2(1, 0, VEHICLE_RVC_HEADER_VERSION)
|
||||
|
||||
/**
|
||||
* Vehicle Rearview Camera to provide interfaces for controlling
|
||||
* the RVC.
|
||||
*/
|
||||
|
||||
/**
|
||||
* The id of this module
|
||||
*/
|
||||
#define VEHICLE_RVC_HARDWARE_MODULE_ID "vehicle_rvc"
|
||||
|
||||
/**
|
||||
* Name of the vehicle device to open
|
||||
*/
|
||||
#define VEHICLE_RVC_HARDWARE_DEVICE "vehicle_rvc_hw_device"
|
||||
|
||||
/**
|
||||
* Describes the current state of RVC module
|
||||
*/
|
||||
typedef struct {
|
||||
uint32_t overlay_on;
|
||||
uint32_t rvc_on;
|
||||
} vehicle_rvc_state_t;
|
||||
|
||||
/**
|
||||
* Describes a rectangle for cropping and positioning objects
|
||||
* uint32_t left Position of left border of rectangle
|
||||
* uint32_t top Position of top border of rectangle
|
||||
* uint32_t width Width of rectangle
|
||||
* uint32_t height Height of rectangle
|
||||
*/
|
||||
typedef struct {
|
||||
uint32_t left;
|
||||
uint32_t top;
|
||||
uint32_t width;
|
||||
uint32_t height;
|
||||
} vehicle_rvc_rect_t;
|
||||
|
||||
/**
|
||||
* Bitmask of features supported by RVC module
|
||||
*/
|
||||
enum vehicle_rvc_config_flag {
|
||||
ANDROID_OVERLAY_SUPPORT_FLAG = 0x1,
|
||||
CAMERA_CROP_SUPPORT_FLAG = 0x2,
|
||||
CAMERA_POSITIONING_SUPPORT_FLAG = 0x4
|
||||
};
|
||||
|
||||
typedef struct {
|
||||
uint32_t capabilites_flags;
|
||||
uint32_t camera_width;
|
||||
uint32_t camera_height;
|
||||
uint32_t display_width;
|
||||
uint32_t display_height;
|
||||
} vehicle_rvc_cap_t;
|
||||
|
||||
/************************************************************************************/
|
||||
|
||||
/**
|
||||
* Every hardware module must have a data structure named HAL_MODULE_INFO_SYM
|
||||
* and the fields of this data structure must begin with hw_module_t
|
||||
* followed by module specific information.
|
||||
*/
|
||||
typedef struct {
|
||||
struct hw_module_t common;
|
||||
} vehicle_rvc_module_t;
|
||||
|
||||
|
||||
typedef struct vehicle_rvc_device_t {
|
||||
struct hw_device_t common;
|
||||
|
||||
/**
|
||||
* Returns the capabilities of this RVC.
|
||||
* @param device
|
||||
* @return
|
||||
*/
|
||||
int (*get_capabilities)(struct vehicle_rvc_device_t *device, vehicle_rvc_cap_t *cap);
|
||||
/**
|
||||
* Gets the current RVC crop settings.
|
||||
* @param device
|
||||
* @return
|
||||
*/
|
||||
int (*get_rvc_crop)(struct vehicle_rvc_device_t *device, vehicle_rvc_rect_t *rect);
|
||||
/**
|
||||
* Sets the RVC crop.
|
||||
* @param device
|
||||
* @param rect Area of RVC camera input to crop
|
||||
* @return
|
||||
*/
|
||||
int (*set_rvc_crop)(struct vehicle_rvc_device_t *device, const vehicle_rvc_rect_t *rect);
|
||||
/**
|
||||
* Gets position of the RVC on the dispaly.
|
||||
* @param device
|
||||
* @param rect Area of display the RVC will appear when on
|
||||
* @return
|
||||
*/
|
||||
int (*get_rvc_position)(struct vehicle_rvc_device_t *device, vehicle_rvc_rect_t *rect);
|
||||
/**
|
||||
* Sets position of the RVC on the display.
|
||||
* @param device
|
||||
* @param rect
|
||||
* @return
|
||||
*/
|
||||
int (*set_rvc_position)(struct vehicle_rvc_device_t *device, const vehicle_rvc_rect_t *rect);
|
||||
/**
|
||||
* Gets the current camera state.
|
||||
* @param device
|
||||
* @return
|
||||
*/
|
||||
int (*get_camera_state)(struct vehicle_rvc_device_t *device, vehicle_rvc_state_t *state);
|
||||
/**
|
||||
* Sets the camera state. Calling this function will generate a
|
||||
* callback notifying the user that the camera state has
|
||||
* changed.
|
||||
* @param device
|
||||
* @return
|
||||
*/
|
||||
int (*set_camera_state)(struct vehicle_rvc_device_t *device, const vehicle_rvc_state_t *state);
|
||||
} vehicle_rvc_device_t;
|
||||
|
||||
__END_DECLS
|
||||
|
||||
#endif // ANDROID_VEHICLE_RVC_INTERFACE_H
|
||||
Loading…
Reference in a new issue