2 * Copyright (C) 2012 The Android Open Source Project
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
21 #include <hardware/hardware.h>
22 #include <hardware/camera3.h>
25 namespace default_camera_hal {
26 // Camera represents a physical camera on a device.
27 // This is constructed when the HAL module is loaded, one per physical camera.
28 // It is opened by the framework, and must be closed before it can be opened
32 // id is used to distinguish cameras. 0 <= id < NUM_CAMERAS.
33 // module is a handle to the HAL module, used when the device is opened.
37 // Common Camera Device Operations (see <hardware/camera_common.h>)
38 int open(const hw_module_t *module, hw_device_t **device);
41 // Camera v3 Device Operations (see <hardware/camera3.h>)
42 int initialize(const camera3_callback_ops_t *callback_ops);
43 int configureStreams(camera3_stream_configuration_t *stream_list);
44 int registerStreamBuffers(const camera3_stream_buffer_set_t *buf_set);
45 const camera_metadata_t *constructDefaultRequestSettings(int type);
46 int processCaptureRequest(camera3_capture_request_t *request);
47 void getMetadataVendorTagOps(vendor_tag_query_ops_t *ops);
50 // Camera device handle returned to framework for use
51 camera3_device_t mDevice;
54 // Reuse a stream already created by this device
55 Stream *reuseStream(camera3_stream_t *astream);
56 // Destroy all streams in a stream array, and the array itself
57 void destroyStreams(Stream **array, int count);
58 // Verify a set of streams is valid in aggregate
59 bool isValidStreamSet(Stream **array, int count);
60 // Calculate usage and max_bufs of each stream
61 void setupStreams(Stream **array, int count);
62 // Copy new settings for re-use and clean up old settings.
63 void setSettings(const camera_metadata_t *new_settings);
64 // Verify settings are valid for a capture
65 bool isValidCaptureSettings(const camera_metadata_t *settings);
66 // Verify settings are valid for reprocessing an input buffer
67 bool isValidReprocessSettings(const camera_metadata_t *settings);
69 // Identifier used by framework to distinguish cameras
71 // Busy flag indicates camera is in use
73 // Camera device operations handle shared by all devices
74 const static camera3_device_ops_t sOps;
75 // Methods used to call back into the framework
76 const camera3_callback_ops_t *mCallbackOps;
77 // Lock protecting the Camera object for modifications
78 pthread_mutex_t mMutex;
79 // Array of handles to streams currently in use by the device
81 // Number of streams in mStreams
83 // Most recent request settings seen, memoized to be reused
84 camera_metadata_t *mSettings;
86 } // namespace default_camera_hal