Files
linux-nv-oot/drivers/platform/tegra/dce/include/dce-client-ipc-internal.h
anupamg 2bed40f6fe DCE-KMD: Refactor dce-os-worker.c/.h
- dce-os-worker.c/.h module exposes functionality which allows
  DCE KMD clients to wait/signal events.

- The current abstraction of this module has following drawbacks
  which this change attempts to address:
    * Name: dce-os-worker is a misnomer
        - Rename to dce-wait-cond.c/.h and make it a dce-kmd core file.
        - Rename functions accordingly.
    * dce-os-worker module initializes data structures from tegra_dce
      which makes it ineligible for re-use.
        - dce-client-ipc can re-use this module as it uses exact
          same functionality.
        - But this module is tied with DCE-KMD core such that it has
          functions that operate on fixed known inputs.
            - dce_os_work_cond_sw_resource_init/deinit()
                Inits/Deinits most but not all condition var resources
                from tegra_dce. Eg. dce-client-ipc resources
                are not initialized.
                    - Move this function to new core file:dce-waiters.c
            - All other functions require msg_id as input and can only
              operate on DCE_WAIT* resources making it ineligible
              to be used by other clients like dce-client-ipc.
                    - Refactor these fucntions to operate on
                      individual wait conditions so that all DCE-KMD
                      core modules can reuse them.

- Additionally, this change will also remove unused functions
  and macros from dce-os-cond.c/.h

- dce-client-ipc will also switch to use dce-wait-cond interface
  for client ipc waits.

- Make dce-os-cond.h a common file and move OS specific impl
  to dce-os-cond-internal.h

JIRA TDS-16581

Change-Id: Ie8c6ec724e48cde66917fab4aa43e7da464ef8fb
Signed-off-by: anupamg <anupamg@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/c/linux-nv-oot/+/3258562
Reviewed-by: Vinod Gopalakrishnakurup <vinodg@nvidia.com>
Reviewed-by: Arun Swain <arswain@nvidia.com>
2025-07-24 10:19:13 +00:00

64 lines
1.9 KiB
C

/* SPDX-License-Identifier: GPL-2.0-only */
/*
* SPDX-FileCopyrightText: Copyright (c) 2019-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
*/
#ifndef DCE_CLIENT_IPC_INTERNAL_H
#define DCE_CLIENT_IPC_INTERNAL_H
#include <linux/platform/tegra/dce/dce-client-ipc.h>
#include <dce-os-atomic.h>
#include <dce-os-work.h>
/**
* struct tegra_dce_client_ipc - Data Structure to hold client specific ipc
* data pertaining to IPC type
*
* @valid : Tells if the client ipc data held by data structure is valid
* @data : Pointer to any specific data passed by client during registration
* for corresponding IPC type
* @type : Corresponding IPC type as defined in CPU driver
* @handle : Corresponding handle allocated for client during registration
* @int_type : IPC interface type for above IPC type as defined in CPU driver
* @d : pointer to OS agnostic dce struct. Stores all runtime info for dce
* cluster elements
* @recv_wait : wait condition variable used for IPC synchronization
* @callback_fn : function pointer to the callback function passed by the
* client during registration
*/
struct tegra_dce_client_ipc {
bool valid;
void *data;
uint32_t type;
uint32_t handle;
uint32_t int_type;
struct tegra_dce *d;
struct dce_wait_cond recv_wait;
tegra_dce_client_ipc_callback_t callback_fn;
};
#define DCE_MAX_ASYNC_WORK 8
struct dce_async_work {
struct tegra_dce *d;
dce_os_work_handle_t async_event_work;
dce_os_atomic_t in_use;
};
/**
* @async_event_wq - Workqueue to process async events from DCE
*/
struct tegra_dce_async_ipc_info {
dce_os_wq_handle_t async_event_wq;
struct dce_async_work work[DCE_MAX_ASYNC_WORK];
};
void dce_client_ipc_wakeup(struct tegra_dce *d, u32 ch_type);
int dce_client_ipc_wait(struct tegra_dce *d, u32 ch_type);
int dce_client_init(struct tegra_dce *d);
void dce_client_deinit(struct tegra_dce *d);
#endif