Rename vehicle_rvc to vehicle_camera
BUG: 25261672
BUG: 25226538
BUG: 22701467
BUG: 26557463
Change-Id: Ideff9a13d61d7242c2f92212222809c7785970ee
diff --git a/include/hardware/vehicle_camera.h b/include/hardware/vehicle_camera.h
new file mode 100644
index 0000000..8075aee
--- /dev/null
+++ b/include/hardware/vehicle_camera.h
@@ -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
diff --git a/include/hardware/vehicle_rvc.h b/include/hardware/vehicle_rvc.h
deleted file mode 100644
index 05d57e4..0000000
--- a/include/hardware/vehicle_rvc.h
+++ /dev/null
@@ -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