blob: 293eaab7c60cd1aa30f4b79aa6eb0d0eced670ea [file] [edit]
/*
* Copyright © 2026 Advanced Micro Devices, Inc.
*
* SPDX-License-Identifier: MIT
*
* C interface for the DevDriver integration.
*
* Exposes the C-callable wrapper that lets the driver's C code interact with
* the underlying C++ DevDriver implementation. DevDriver is used for
* communication with Radeon Developer Panel (RDP) over the UberTrace RPC
* protocol.
*
* The DevDriver library is imported from GPUOpen without modifications.
*/
#ifndef AC_DEVDRIVER_H
#define AC_DEVDRIVER_H
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
/* Opaque handle to the DevDriver server */
typedef struct ac_devdriver_server ac_devdriver_server;
ac_devdriver_server *ac_devdriver_create(void);
void ac_devdriver_destroy(ac_devdriver_server *server);
void ac_devdriver_finalize(ac_devdriver_server *server);
/* ---- UberTrace ---- */
bool ac_devdriver_ubertrace_is_trace_requested(ac_devdriver_server *server);
bool ac_devdriver_ubertrace_set_trace_data(ac_devdriver_server *server, uint8_t *data, size_t size);
const char *ac_devdriver_ubertrace_get_trace_config_json(ac_devdriver_server *server);
bool ac_devdriver_ubertrace_get_instruction_tokens_enabled(ac_devdriver_server *server);
uint32_t ac_devdriver_ubertrace_get_se_mask(ac_devdriver_server *server);
uint32_t ac_devdriver_ubertrace_get_rdf_chunk_mask(ac_devdriver_server *server);
uint32_t ac_devdriver_ubertrace_get_compression_mask(ac_devdriver_server *server);
uint32_t ac_devdriver_ubertrace_get_target_capture_frame(ac_devdriver_server *server);
/* ---- Driver Control API ---- */
void ac_devdriver_start_early_device_init(ac_devdriver_server *server);
void ac_devdriver_start_late_device_init(ac_devdriver_server *server);
void ac_devdriver_finish_device_init(ac_devdriver_server *server);
bool ac_devdriver_is_driver_initialized(ac_devdriver_server *server);
void ac_devdriver_set_num_gpus(ac_devdriver_server *server, uint32_t num_gpus);
void ac_devdriver_driver_tick(ac_devdriver_server *server);
#ifdef __cplusplus
}
#endif
#endif /* AC_DEVDRIVER_H */