libcamera3/common_v2/ExynosCameraFrameManager.h

/*
**
** Copyright 2017, Samsung Electronics Co. LTD
**
** 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.
*/

/*!
 * \file      ExynosCameraFrameManager.h
 * \brief     header file for ExynosCameraFrameManager
 * \author    suyoung lee(suyoung80.lee@samsung.com)
 * \date      2014/05/08
*/

#ifndef EXYNOS_CAMERA_FRAME_MANAGER_H
#define EXYNOS_CAMERA_FRAME_MANAGER_H

#include <utils/threads.h>
#include <utils/RefBase.h>
#include <binder/MemoryBase.h>
#include <binder/MemoryHeapBase.h>
#include <hardware/camera.h>
#include <CameraParameters.h>
#include <media/hardware/MetadataBufferType.h>
#include <map>
#include <list>
#include <string>

#include <fcntl.h>
#include <sys/mman.h>
#include "csc.h"

#include "ExynosCameraConfigurations.h"
#include "ExynosCameraThread.h"
#include "ExynosCameraFrame.h"
#include "ExynosCameraList.h"

namespace android {

using namespace std;

class FrameWorker;

typedef sp<ExynosCameraFrame>  ExynosCameraFrameSP_t;
typedef sp<ExynosCameraFrame>  ExynosCameraFrameSP_sptr_t; /* single ptr */
typedef sp<ExynosCameraFrame>& ExynosCameraFrameSP_dptr_t; /* double ptr */
typedef wp<ExynosCameraFrame>  ExynosCameraFrameWP_t;
typedef wp<ExynosCameraFrame>& ExynosCameraFrameWP_dptr_t; /* wp without inc refcount */

typedef ExynosCameraList<ExynosCameraFrameSP_sptr_t> frame_manager_queue_t;
typedef ExynosCameraList<uint32_t> frame_key_queue_t;
typedef ExynosCameraThread<FrameWorker> FrameManagerThread;

namespace FRAMEMGR_ERRCODE {
    enum STATUS {
        OK = 0,
        ERR = -1,
        ERR_STATE_
    };
};

namespace FRAMEMGR_OPER {
    enum MODE {
        NONE      = 0,
        ONDEMAND  = 1,
        SLIENT    = 2
    };
};

namespace FRAMEMGR_WORKER {
    enum TYPE {
        NONE      = 0,
        CREATE    = 1,
        DELETE    = 2,
        RUNNING   = 3
    };
};

namespace DEBUG_LEVEL {
    enum STATUS {
        ERROR = 1,
        DEBUG = 2,
        TRACE = 3,
        DEFAULT = DEBUG
    };
};

#define EXYNOS_CAMERA_FRAME_CREATE_PERFORMANCE /* framecreate performance */

class KeyBox : public virtual RefBase{
public:
    KeyBox(const char* name, int cameraid) {

        m_cameraId = cameraid;
        strncpy(m_name, name, EXYNOS_CAMERA_NAME_STR_SIZE - 1);

        init();
    }
    virtual ~KeyBox() { }

    status_t init() {
        m_uniqueKey = 0;
        return 0;
    }

    uint32_t createKey() {
        Mutex::Autolock lock(m_lock);

        return m_uniqueKey++;
    }

    uint32_t getKey() {
        Mutex::Autolock lock(m_lock);

        return m_uniqueKey;
    }
    status_t setKey(uint32_t key){
        Mutex::Autolock lock(m_lock);

        m_uniqueKey = key;
        return 0;
    }

private:
    int                              m_cameraId;
    char                             m_name[EXYNOS_CAMERA_NAME_STR_SIZE];
    uint32_t                         m_uniqueKey;
    mutable Mutex                    m_lock;

};


class FrameWorker : public virtual RefBase {

public:
    FrameWorker() {};
    FrameWorker(const char* name, int cameraid, FRAMEMGR_OPER::MODE m_operMode);
    virtual ~FrameWorker();

    virtual uint32_t        getKey();
    virtual status_t        setKey(uint32_t key);
    virtual Mutex*          getLock() = 0;

    virtual status_t        execute(ExynosCameraFrameSP_sptr_t inframe, ExynosCameraFrameSP_dptr_t outframe) = 0;
    virtual status_t        setMargin(int32_t max, int32_t min) = 0;
    virtual status_t        start() = 0;
    virtual status_t        stop() = 0;
    virtual status_t        dump();
    virtual frame_key_queue_t* getQueue();

protected:
    virtual status_t        m_deinit();
    virtual status_t        m_init();

    virtual status_t        m_setEnable(bool enable);
    virtual bool            m_getEnable();
    virtual bool            workerMain() = 0;

private:

protected:
    struct FrameWorkerCommand {
        enum command_kind {
            START = 1,
            STOP = 2,
        };

        void sendCommand(command_kind cmd) {
            uint32_t _cmd = cmd;
            cmdQ.pushProcessQ(&_cmd);
        }
        status_t waitCommand(uint32_t* cmd) {
            return cmdQ.waitAndPopProcessQ(cmd);
        }

        ExynosCameraList<uint32_t>    cmdQ;
    };

    enum FrameMargin {
        FRAME_MARGIN_MIN = 0,
        FRAME_MARGIN_MAX = 1,
    };

    virtual status_t        m_setMargin(int32_t maxMargin, int32_t minMargin);
    virtual int32_t         m_getMargin(FrameMargin marginType);

protected:
    int                     m_cameraId;
    char                    m_name[EXYNOS_CAMERA_NAME_STR_SIZE];
    sp<FrameManagerThread>  m_thread;
    FRAMEMGR_OPER::MODE     m_operMode;
    int32_t                 m_nMinMargin;
    int32_t                 m_nMaxMargin;
    FrameWorkerCommand      m_command;

private:
    uint32_t                m_key;
    bool                    m_enable;
    mutable Mutex           m_enableLock;

};

typedef bool (FrameWorker::*func_ptr_t_)();

class CreateWorker : public FrameWorker{

public:
    CreateWorker() {};
    CreateWorker(const char* name, int cameraid, FRAMEMGR_OPER::MODE operMode, int32_t maxMargin = 0, int32_t minMargin = 0);
    virtual ~CreateWorker();

    virtual Mutex*          getLock();

    virtual status_t        execute(ExynosCameraFrameSP_sptr_t inframe, ExynosCameraFrameSP_dptr_t outframe);
    virtual status_t        setMargin(int32_t max, int32_t min);
    virtual status_t        start();
    virtual status_t        stop();

protected:
    virtual bool            workerMain();
    virtual status_t        m_init();
    virtual status_t        m_deinit();

private:
    virtual ExynosCameraFrameSP_sptr_t m_execute();


private:
    frame_manager_queue_t   *m_worklist;
    mutable Mutex           *m_lock;

#if defined EXYNOS_CAMERA_FRAME_CREATE_PERFORMANCE
    ExynosCameraDurationTimer	m_createTimer;
#endif

};

class DeleteWorker : public FrameWorker{

public:
    DeleteWorker() {};
    DeleteWorker(const char* name, int cameraid, FRAMEMGR_OPER::MODE operMode, int32_t maxMargin = 0);
    virtual ~DeleteWorker();

    virtual Mutex*          getLock();

    virtual status_t        execute(ExynosCameraFrameSP_sptr_t inframe, ExynosCameraFrameSP_dptr_t outframe);
    virtual status_t        start();
    virtual status_t        stop();

protected:
    virtual bool            workerMain();
    virtual status_t        m_deinit();
    virtual status_t        m_init();
    virtual status_t        m_setMargin(int32_t maxMargin, int32_t minMargin);

private:
    virtual status_t        m_execute(ExynosCameraFrameSP_sptr_t frame);

private:
    frame_manager_queue_t   *m_worklist;
    mutable Mutex           *m_lock;

};

class RunWorker : public FrameWorker{

public:
    RunWorker() {};
    RunWorker(const char* name, int cameraid, FRAMEMGR_OPER::MODE operMode, int32_t margin, uint32_t dumpMargin);
    virtual ~RunWorker();

    virtual Mutex*          getLock();

    virtual status_t        execute(ExynosCameraFrameSP_sptr_t inframe, ExynosCameraFrameSP_dptr_t outframe);
    virtual status_t        setMargin(int32_t max, int32_t min);
    virtual status_t        start();
    virtual status_t        stop();
    virtual status_t        dump();
    virtual frame_key_queue_t* getQueue();

protected:
    virtual bool            workerMain();
    virtual status_t        m_init();
    virtual status_t        m_deinit();
    virtual status_t        m_insertFrame(ExynosCameraFrameSP_dptr_t frame, map<uint32_t, ExynosCameraFrameWP_t> *list, Mutex *lock);
    virtual status_t        m_removeFrame(ExynosCameraFrameSP_dptr_t frame, map<uint32_t, ExynosCameraFrameWP_t> *list, Mutex *lock);
    virtual status_t        m_removeFrame(uint32_t frameKey, map<uint32_t, ExynosCameraFrameWP_t> *list, Mutex *lock);

private:
    virtual status_t        m_setMargin(int32_t numOfMargin);
    virtual int32_t         m_getMargin();
    virtual status_t        m_execute(ExynosCameraFrameSP_dptr_t frame);
    virtual status_t        m_dumpFrame();
    virtual uint32_t        m_getSizeList();

private:
    map<uint32_t, ExynosCameraFrameWP_t>  m_worklist;
    mutable Mutex                         m_lock;
    frame_key_queue_t                    *m_framekeyQueue;
    int32_t                               m_numOfMargin;
    uint32_t                              m_numOfDumpMargin;

};

class ExynosCameraFrameManager {

public:
    ExynosCameraFrameManager() {};

    ExynosCameraFrameManager(const char* name, int cameraid, FRAMEMGR_OPER::MODE operMode);
    virtual ~ExynosCameraFrameManager();

    ExynosCameraFrameSP_sptr_t  createFrame(ExynosCameraConfigurations *configurations,
                                            uint32_t framecnt,
                                            uint32_t frametype = 0);

    status_t            setKeybox(sp<KeyBox> keybox);
    sp<KeyBox>          getKeybox();
    status_t            setWorker(int key, sp<FrameWorker> worker);
    sp<FrameWorker>     getWorker(int key);
    sp<FrameWorker>     eraseWorker(int key);

    status_t            setOperMode(FRAMEMGR_OPER::MODE mode);
    int                 getOperMode();

    status_t            start();
    status_t            stop();

    int                 deleteAllFrame();

    status_t            dump();

private:
    status_t            m_init();

    status_t            m_deinit();
    status_t            m_setupWorkerInfo(int key, sp<FrameWorker> worker);

    ExynosCameraFrameSP_sptr_t m_createFrame(ExynosCameraConfigurations *configurations, uint32_t framecnt, uint32_t frametype = 0);

    status_t            m_setOperMode(FRAMEMGR_OPER::MODE mode);
    int                 m_getOperMode();

    status_t            m_setEnable(bool enable);
    bool                m_getEnable();

public:


private:
    int                               m_cameraId;
    char                              m_name[EXYNOS_CAMERA_NAME_STR_SIZE];
    sp<KeyBox>                        m_keybox;
    map<uint32_t, sp<FrameWorker> >   m_workerList;

    int                                m_operMode;
    bool                               m_enable;
    mutable Mutex                      m_enableLock;
    mutable Mutex                      m_stateLock;

    frame_key_queue_t                 *m_framekeyQueue;

};




}; /* namespace android */
#endif