Files
linux-nv-oot/drivers/platform/tegra/dce/include/dce-lock.h
Arun Swain 606f03fbf2 platform: tegra: dce: add dce kernel driver
For T23x, we have a separate R5 based cluster
named as Display Controller Engine(DCE) to run
our Display RM code. This driver will run on CPU
with the following functionality:

Via debugfs for test and bring-up purposes:
1. Reads the DCE firmware image into DRAM.
2. Sets up DCE AST to cover the DCE firmware image.
3. Sets up R5 reset vector to point to DCE firmware
entry point
4. Brings DCE out of reset
5. Dumps various regsiters for debug

In production env:
1. Manages interrupts to CPU from DCE
2. Uses bootstrap command interface to define Admin
IPC
3. Locks down bootstrap command interface
4. Uses Admin IPC to define message IPC
5. Uses Admin IPC to define message IPC payload area
6. Uses Admin IPC to set IPC channels
6. Uses Admin IPC to define crashdump area
(optional)
7. Provides IPC interfaces for any DCE Client running
on CCPLEX including Display RM.
8. Uses Admin IPC to set logging level (optional)

This patch puts a framework in place with the
following features :
1. Firmware Loading
2. AST Configuration
3. DCE Reset with EVP Programming
4. Logging Infra
5. Debugfs Support
6. Interrupt Handling
7. Mailbox Programming
8. IPC Programming
9. DCE Client Interface
10. Ftrace Support for debug purposes

Change-Id: Idd28cd9254706c7313f531fcadaa7024a5b344e7
Signed-off-by: Arun Swain <arswain@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/c/linux-t23x/+/2289865
Reviewed-by: automaticguardword <automaticguardword@nvidia.com>
Reviewed-by: Mahesh Kumar <mahkumar@nvidia.com>
Reviewed-by: Santosh Galma <galmar@nvidia.com>
Reviewed-by: Mitch Luban <mluban@nvidia.com>
Reviewed-by: mobile promotions <svcmobile_promotions@nvidia.com>
GVS: Gerrit_Virtual_Submit
Tested-by: Mahesh Kumar <mahkumar@nvidia.com>
Tested-by: mobile promotions <svcmobile_promotions@nvidia.com>
2023-04-14 19:23:43 +00:00

71 lines
1.6 KiB
C

/*
* Copyright (c) 2019-2020, NVIDIA CORPORATION. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms and conditions of the GNU General Public License,
* version 2, as published by the Free Software Foundation.
*
* This program is distributed in the hope it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*/
#ifndef DCE_LOCK_H
#define DCE_LOCK_H
struct dce_mutex {
struct mutex mutex;
};
/**
* dce_mutex_init - Initialize dce_mutex in Linux style
*
* mutex : pointer to the mutext to be initialized.
*
* Return : 0 if successful
*/
static inline int dce_mutex_init(struct dce_mutex *mutex)
{
mutex_init(&mutex->mutex);
return 0;
};
/**
* dce_mutex_lock - Acquire the dce_mutex in Linux style
*
* mutex : pointer to the mutext to be acquired.
*
* Return : void
*/
static inline void dce_mutex_lock(struct dce_mutex *mutex)
{
mutex_lock(&mutex->mutex);
};
/**
* dce_mutex_unlock - Release the dce_mutex in Linux style
*
* mutex : pointer to the mutext to be released.
*
* Return : void
*/
static inline void dce_mutex_unlock(struct dce_mutex *mutex)
{
mutex_unlock(&mutex->mutex);
};
/**
* dce_mutex_destroy - Destroy the dce_mutex in Linux style
*
* mutex : pointer to the mutext to be destroyed.
*
* Return : 0 if successful
*/
static inline void dce_mutex_destroy(struct dce_mutex *mutex)
{
mutex_destroy(&mutex->mutex);
};
#endif