Files
android_kernel_samsung_sm86…/drivers/cam_sync/cam_sync_util.h
Jigarkumar Zala 05349feaa2 Camera: Bring over camera driver changes
Bring over camera driver changes as of msm-4.19
commit  5a5551a7 (Merge "msm: camera: reqmgr: Fix CRM
shift one req issue").

Change-Id: Ic0c2b2d74d1b3470c1c51d98228e312fb13c501a
Signed-off-by: Jigarkumar Zala <jzala@codeaurora.org>
2019-07-08 10:24:55 -07:00

146 lines
4.5 KiB
C

/* SPDX-License-Identifier: GPL-2.0-only */
/*
* Copyright (c) 2017-2018, The Linux Foundation. All rights reserved.
*/
#ifndef __CAM_SYNC_UTIL_H__
#define __CAM_SYNC_UTIL_H__
#include <cam_sync_api.h>
#include "cam_sync_private.h"
#include "cam_debug_util.h"
extern struct sync_device *sync_dev;
/**
* @brief: Finds an empty row in the sync table and sets its corresponding bit
* in the bit array
*
* @param sync_dev : Pointer to the sync device instance
* @param idx : Pointer to an long containing the index found in the bit
* array
*
* @return Status of operation. Negative in case of error. Zero otherwise.
*/
int cam_sync_util_find_and_set_empty_row(struct sync_device *sync_dev,
long *idx);
/**
* @brief: Function to initialize an empty row in the sync table. This should be
* called only for individual sync objects.
*
* @param table : Pointer to the sync objects table
* @param idx : Index of row to initialize
* @param name : Optional string representation of the sync object. Should be
* 63 characters or less
* @param type : type of row to be initialized
* @return Status of operation. Negative in case of error. Zero otherwise.
*/
int cam_sync_init_row(struct sync_table_row *table,
uint32_t idx, const char *name, uint32_t type);
/**
* @brief: Function to uninitialize a row in the sync table
*
* @param table : Pointer to the sync objects table
* @param idx : Index of row to initialize
*
* @return Status of operation. Negative in case of error. Zero otherwise.
*/
int cam_sync_deinit_object(struct sync_table_row *table, uint32_t idx);
/**
* @brief: Function to initialize a row in the sync table when the object is a
* group object, also known as a merged sync object
*
* @param table : Pointer to the sync objects table
* @param idx : Index of row to initialize
* @param sync_objs : Array of sync objects which will merged
* or grouped together
* @param num_objs : Number of sync objects in the array
*
* @return Status of operation. Negative in case of error. Zero otherwise.
*/
int cam_sync_init_group_object(struct sync_table_row *table,
uint32_t idx,
uint32_t *sync_objs,
uint32_t num_objs);
int cam_sync_deinit_object(struct sync_table_row *table, uint32_t idx);
/**
* @brief: Function to dispatch a kernel callback for a sync callback
*
* @param cb_dispatch_work : Pointer to the work_struct that needs to be
* dispatched
*
* @return None
*/
void cam_sync_util_cb_dispatch(struct work_struct *cb_dispatch_work);
/**
* @brief: Function to dispatch callbacks for a signaled sync object
*
* @sync_obj : Sync object that is signaled
* @status : Status of the signaled object
*
* @return None
*/
void cam_sync_util_dispatch_signaled_cb(int32_t sync_obj,
uint32_t status);
/**
* @brief: Function to send V4L event to user space
* @param id : V4L event id to send
* @param sync_obj : Sync obj for which event needs to be sent
* @param status : Status of the event
* @payload : Payload that needs to be sent to user space
* @len : Length of the payload
*
* @return None
*/
void cam_sync_util_send_v4l2_event(uint32_t id,
uint32_t sync_obj,
int status,
void *payload,
int len);
/**
* @brief: Function which gets the next state of the sync object based on the
* current state and the new state
*
* @param current_state : Current state of the sync object
* @param new_state : New state of the sync object
*
* @return Next state of the sync object
*/
int cam_sync_util_update_parent_state(struct sync_table_row *parent_row,
int new_state);
/**
* @brief: Function to clean up the children of a sync object
* @row : Row whose child list to clean
* @list_clean_type : Clean specific object or clean all objects
* @sync_obj : Sync object to be clean if list clean type is
* SYNC_LIST_CLEAN_ONE
*
* @return None
*/
void cam_sync_util_cleanup_children_list(struct sync_table_row *row,
uint32_t list_clean_type, uint32_t sync_obj);
/**
* @brief: Function to clean up the parents of a sync object
* @row : Row whose parent list to clean
* @list_clean_type : Clean specific object or clean all objects
* @sync_obj : Sync object to be clean if list clean type is
* SYNC_LIST_CLEAN_ONE
*
* @return None
*/
void cam_sync_util_cleanup_parents_list(struct sync_table_row *row,
uint32_t list_clean_type, uint32_t sync_obj);
#endif /* __CAM_SYNC_UTIL_H__ */