camera/hal/intel/ipu6/src/core/RequestThread.h

/*
 * Copyright (C) 2016-2020 Intel Corporation.
 *
 * 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.
 */

#pragma once

#include <deque>

#include "iutils/Thread.h"
#include "PlatformData.h"
#include "Parameters.h"
#include "AiqUnit.h"
#include "Parameters.h"
#include "ParameterGenerator.h"

namespace icamera {

/*
 * The RequestThread is used to assist CameraDevice to handle request(qbuf/dqbuf).
 */
class RequestThread : public Thread, public EventSource, public EventListener {
public:
    RequestThread(int cameraId, AiqUnitBase *a3AControl, ParameterGenerator* aParamGen);
    ~RequestThread();

    bool threadLoop();
    void requestExit();

    void handleEvent(EventData eventData);

    /**
     * \Clear pending requests.
     */
    void clearRequests();

    /**
     * \Accept requests from user.
     */
    int processRequest(int bufferNum, camera_buffer_t **ubuffer, const Parameters * params);

    int waitFrame(int streamId, camera_buffer_t **ubuffer);

    /**
     * \Block the caller until the first request is processed.
     */
    int wait1stRequestDone();

    /**
     * \brief configure the streams, devices and post processor.
     *
     * \param streamList: all the streams info
     *
     * \return OK if succeed and BAD_VALUE if failed
     */
    int configure(const stream_config_t *streamList);

    /**
     * \brief get stream config in request thread.
     */
    stream_config_t getStreamConfig() { return mStreamConfig; };

    /**
     * \brief set request configure mode by parameters.
     */
    void setConfigureModeByParam(const Parameters& param);

    /**
     * \brief post config for fake request
     */
    void postConfigure(const stream_config_t *streamList);

private:
    int mCameraId;
    AiqUnitBase *m3AControl;
    ParameterGenerator *mParamGenerator;
    bool mPerframeControlSupport;
    bool mGet3AStatWithFakeRequest;
    camera_buffer_t mFakeReqBuf;
    std::shared_ptr<CameraBuffer> mFakeBuffer;

    struct CameraRequest {
        CameraRequest() : mBufferNum(0), mParams(nullptr) {
            CLEAR(mBuffer);
        }

        int mBufferNum;
        camera_buffer_t *mBuffer[MAX_STREAM_NUMBER];
        std::shared_ptr<Parameters> mParams;
    };

    std::shared_ptr<Parameters> copyRequestParams(const Parameters *params);

    /**
     * \Fetch one request from pending request Q for processing.
     */
    bool fetchNextRequest(CameraRequest& request);
    bool isReadyForReconfigure();
    bool isReconfigurationNeeded();
    std::shared_ptr<Parameters> acquireParam();

    void handleReconfig();
    void handleRequest(CameraRequest& request);
    bool blockRequest();

    static const int kMaxRequests = MAX_BUFFER_COUNT;
    static const nsecs_t kWaitFrameDuration = 5000000000; // 5s
    static const nsecs_t kWaitDuration = 2000000000; // 2s
    static const nsecs_t kWaitFirstRequestDoneDuration = 1000000000; // 1s

    //Guard for all the pending requests
    Mutex mPendingReqLock;
    Condition mRequestSignal;
    std::deque <CameraRequest> mPendingRequests;
    std::queue <std::shared_ptr<Parameters> > mReqParamsPool;
    int mRequestsInProcessing;

    // Guard for the first request.
    Mutex mFirstRequestLock;
    Condition mFirstRequestSignal;
    bool mFirstRequest;

    // Internal used for restart function
    ConfigMode mRequestConfigMode; // the ConfigMode is gotten from parameters set from user or AE result
    ConfigMode mUserConfigMode; // user specified ConfigMode during initial configure
    // Whether pipe need to reconfigure
    bool mNeedReconfigPipe;
    // Score indicate the num of consecutive configure mode settings, to make switch stable.
    unsigned int  mReconfigPipeScore;
    stream_config_t mStreamConfig;
    stream_t mConfiguredStreams[MAX_STREAM_NUMBER];

    struct FrameQueue {
        Mutex mFrameMutex;
        Condition mFrameAvailableSignal;
        CameraBufQ mFrameQueue;
    };
    FrameQueue mOutputFrames[MAX_STREAM_NUMBER];
    bool mActive;

    long mLastRequestId;
    long mLastPredictSeq;
    long mLastEofSeq;
    bool mBlockRequest;  // Process the 2nd or 3th request after the 1st 3A event
                         // to avoid unstable AWB at the beginning of stream on
};

} //namespace icamera