evs/1.0/default/EvsCamera.h

/*
 * 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_HARDWARE_EVS_V1_0_EVSCAMERA_H
#define ANDROID_HARDWARE_EVS_V1_0_EVSCAMERA_H

#include <android/hardware/evs/1.0/types.h>
#include <android/hardware/evs/1.0/IEvsCamera.h>
#include <ui/GraphicBuffer.h>

#include <thread>


namespace android {
namespace hardware {
namespace evs {
namespace V1_0 {
namespace implementation {


class EvsCamera : public IEvsCamera {
public:
    // Methods from ::android::hardware::evs::V1_0::IEvsCamera follow.
    Return<void> getId(getId_cb id_cb)  override;
    Return<EvsResult> setMaxFramesInFlight(uint32_t bufferCount)  override;
    Return<EvsResult> startVideoStream(const ::android::sp<IEvsCameraStream>& stream) override;
    Return<void> doneWithFrame(const BufferDesc& buffer)  override;
    Return<void> stopVideoStream()  override;
    Return<int32_t> getExtendedInfo(uint32_t opaqueIdentifier)  override;
    Return<EvsResult> setExtendedInfo(uint32_t opaqueIdentifier, int32_t opaqueValue)  override;

    // Implementation details
    EvsCamera(const char* id);
    virtual ~EvsCamera() override;

    const CameraDesc& getDesc() { return mDescription; };

    static const char kCameraName_Backup[];
    static const char kCameraName_RightTurn[];

private:
    // These three functions are expected to be called while mAccessLock is held
    bool     setAvailableFrames_Locked(unsigned bufferCount);
    unsigned increaseAvailableFrames_Locked(unsigned numToAdd);
    unsigned decreaseAvailableFrames_Locked(unsigned numToRemove);

    void generateFrames();
    void fillTestFrame(const BufferDesc& buff);

    CameraDesc                  mDescription = {};  // The properties of this camera

    std::thread                 mCaptureThread;     // The thread we'll use to synthesize frames

    uint32_t                    mWidth  = 0;        // Horizontal pixel count in the buffers
    uint32_t                    mHeight = 0;        // Vertical pixel count in the buffers
    uint32_t                    mFormat = 0;        // Values from android_pixel_format_t [TODO: YUV?  Leave opaque?]
    uint32_t                    mUsage  = 0;        // Values from from Gralloc.h
    uint32_t                    mStride = 0;        // Bytes per line in the buffers

    sp<IEvsCameraStream>        mStream = nullptr;  // The callback used to deliver each frame

    struct BufferRecord {
        buffer_handle_t     handle;
        bool                inUse;
        explicit BufferRecord(buffer_handle_t h) : handle(h), inUse(false) {};
    };
    std::vector<BufferRecord>   mBuffers;           // Graphics buffers to transfer images
    unsigned                    mFramesAllowed;     // How many buffers are we currently using
    unsigned                    mFramesInUse;       // How many buffers are currently outstanding

    enum StreamStateValues {
        STOPPED,
        RUNNING,
        STOPPING,
    };
    StreamStateValues           mStreamState;

    // Syncrhonization necessary to deconflict mCaptureThread from the main service thread
    std::mutex                  mAccessLock;
};

} // namespace implementation
} // namespace V1_0
} // namespace evs
} // namespace hardware
} // namespace android

#endif  // ANDROID_HARDWARE_EVS_V1_0_EVSCAMERA_H