You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
116 lines
4.4 KiB
116 lines
4.4 KiB
/*
|
|
* 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.
|
|
*/
|
|
|
|
// Loosely based on hardware/libhardware/modules/camera/ExampleCamera.h
|
|
|
|
#ifndef V4L2_CAMERA_HAL_V4L2_CAMERA_H_
|
|
#define V4L2_CAMERA_HAL_V4L2_CAMERA_H_
|
|
|
|
#include <array>
|
|
#include <condition_variable>
|
|
#include <queue>
|
|
#include <string>
|
|
|
|
#include <camera/CameraMetadata.h>
|
|
#include <utils/StrongPointer.h>
|
|
#include <utils/Thread.h>
|
|
#include "camera.h"
|
|
#include "common.h"
|
|
#include "metadata/metadata.h"
|
|
#include "v4l2_wrapper.h"
|
|
|
|
namespace v4l2_camera_hal {
|
|
// V4L2Camera is a specific V4L2-supported camera device. The Camera object
|
|
// contains all logic common between all cameras (e.g. front and back cameras),
|
|
// while a specific camera device (e.g. V4L2Camera) holds all specific
|
|
// metadata and logic about that device.
|
|
class V4L2Camera : public default_camera_hal::Camera {
|
|
public:
|
|
// Use this method to create V4L2Camera objects. Functionally equivalent
|
|
// to "new V4L2Camera", except that it may return nullptr in case of failure.
|
|
static V4L2Camera* NewV4L2Camera(int id, const std::string path);
|
|
~V4L2Camera();
|
|
|
|
private:
|
|
// Constructor private to allow failing on bad input.
|
|
// Use NewV4L2Camera instead.
|
|
V4L2Camera(int id,
|
|
std::shared_ptr<V4L2Wrapper> v4l2_wrapper,
|
|
std::unique_ptr<Metadata> metadata);
|
|
|
|
// default_camera_hal::Camera virtual methods.
|
|
// Connect to the device: open dev nodes, etc.
|
|
int connect() override;
|
|
// Disconnect from the device: close dev nodes, etc.
|
|
void disconnect() override;
|
|
// Initialize static camera characteristics for individual device.
|
|
int initStaticInfo(android::CameraMetadata* out) override;
|
|
// Initialize a template of the given type.
|
|
int initTemplate(int type, android::CameraMetadata* out) override;
|
|
// Initialize device info: resource cost and conflicting devices
|
|
// (/conflicting devices length).
|
|
void initDeviceInfo(camera_info_t* info) override;
|
|
// Extra initialization of device when opened.
|
|
int initDevice() override;
|
|
// Verify stream configuration dataspaces and rotation values
|
|
bool validateDataspacesAndRotations(
|
|
const camera3_stream_configuration_t* stream_config) override;
|
|
// Set up the streams, including seting usage & max_buffers
|
|
int setupStreams(camera3_stream_configuration_t* stream_config) override;
|
|
// Verify settings are valid for a capture or reprocessing.
|
|
bool isValidRequestSettings(const android::CameraMetadata& settings) override;
|
|
// Enqueue a request to receive data from the camera.
|
|
int enqueueRequest(
|
|
std::shared_ptr<default_camera_hal::CaptureRequest> request) override;
|
|
// Flush in flight buffers.
|
|
int flushBuffers() override;
|
|
|
|
// Async request processing helpers.
|
|
// Dequeue a request from the waiting queue.
|
|
// Blocks until a request is available.
|
|
std::shared_ptr<default_camera_hal::CaptureRequest> dequeueRequest();
|
|
|
|
// Thread functions. Return true to loop, false to exit.
|
|
// Pass buffers for enqueued requests to the device.
|
|
bool enqueueRequestBuffers();
|
|
// Retreive buffers from the device.
|
|
bool dequeueRequestBuffers();
|
|
|
|
// V4L2 helper.
|
|
std::shared_ptr<V4L2Wrapper> device_;
|
|
std::unique_ptr<V4L2Wrapper::Connection> connection_;
|
|
std::unique_ptr<Metadata> metadata_;
|
|
std::mutex request_queue_lock_;
|
|
std::queue<std::shared_ptr<default_camera_hal::CaptureRequest>>
|
|
request_queue_;
|
|
std::mutex in_flight_lock_;
|
|
uint32_t in_flight_buffer_count_;
|
|
// Threads require holding an Android strong pointer.
|
|
android::sp<android::Thread> buffer_enqueuer_;
|
|
android::sp<android::Thread> buffer_dequeuer_;
|
|
std::condition_variable requests_available_;
|
|
std::condition_variable buffers_in_flight_;
|
|
|
|
int32_t max_input_streams_;
|
|
std::array<int, 3> max_output_streams_; // {raw, non-stalling, stalling}.
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(V4L2Camera);
|
|
};
|
|
|
|
} // namespace v4l2_camera_hal
|
|
|
|
#endif // V4L2_CAMERA_HAL_V4L2_CAMERA_H_
|