1d1edb7030
Add SYNC_V4L_EVENT_V2 support in sync driver. As part of this change, added the reason code field as part of sync event header. This failure reason code is filled by camera kernel driver and propagate to userspace. CRs-Fixed: 2750553 Change-Id: I206d0d51c38cfe4214814b89d241f51c1f50605b Signed-off-by: Alok Chauhan <alokc@codeaurora.org>
149 line
4.6 KiB
C
149 line
4.6 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (c) 2017-2020, 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
|
|
* @evt_param : Event paramaeter
|
|
*
|
|
* @return None
|
|
*/
|
|
void cam_sync_util_dispatch_signaled_cb(int32_t sync_obj,
|
|
uint32_t status, uint32_t evt_param);
|
|
|
|
/**
|
|
* @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
|
|
* @evt_param : Event Paramenter
|
|
*
|
|
* @return None
|
|
*/
|
|
void cam_sync_util_send_v4l2_event(uint32_t id,
|
|
uint32_t sync_obj,
|
|
int status,
|
|
void *payload,
|
|
int len,
|
|
uint32_t evt_param);
|
|
|
|
/**
|
|
* @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__ */
|