| /* |
| * |
| * (C) COPYRIGHT 2015-2016 ARM Limited. All rights reserved. |
| * |
| * This program is free software and is provided to you under the terms of the |
| * GNU General Public License version 2 as published by the Free Software |
| * Foundation, and any use by you of this program is subject to the terms |
| * of such GNU licence. |
| * |
| * A copy of the licence is included with the program, and can also be obtained |
| * from Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
| * Boston, MA 02110-1301, USA. |
| * |
| */ |
| |
| |
| |
| #ifndef _KBASE_VINSTR_H_ |
| #define _KBASE_VINSTR_H_ |
| |
| #include <mali_kbase.h> |
| #include <mali_kbase_hwcnt_reader.h> |
| |
| /*****************************************************************************/ |
| |
| struct kbase_vinstr_context; |
| struct kbase_vinstr_client; |
| |
| /*****************************************************************************/ |
| |
| /** |
| * kbase_vinstr_init() - initialize the vinstr core |
| * @kbdev: kbase device |
| * |
| * Return: pointer to the vinstr context on success or NULL on failure |
| */ |
| struct kbase_vinstr_context *kbase_vinstr_init(struct kbase_device *kbdev); |
| |
| /** |
| * kbase_vinstr_term() - terminate the vinstr core |
| * @vinstr_ctx: vinstr context |
| */ |
| void kbase_vinstr_term(struct kbase_vinstr_context *vinstr_ctx); |
| |
| /** |
| * kbase_vinstr_hwcnt_reader_setup - configure hw counters reader |
| * @vinstr_ctx: vinstr context |
| * @setup: reader's configuration |
| * |
| * Return: zero on success |
| */ |
| int kbase_vinstr_hwcnt_reader_setup( |
| struct kbase_vinstr_context *vinstr_ctx, |
| struct kbase_uk_hwcnt_reader_setup *setup); |
| |
| /** |
| * kbase_vinstr_legacy_hwc_setup - configure hw counters for dumping |
| * @vinstr_ctx: vinstr context |
| * @cli: pointer where to store pointer to new vinstr client structure |
| * @setup: hwc configuration |
| * |
| * Return: zero on success |
| */ |
| int kbase_vinstr_legacy_hwc_setup( |
| struct kbase_vinstr_context *vinstr_ctx, |
| struct kbase_vinstr_client **cli, |
| struct kbase_uk_hwcnt_setup *setup); |
| |
| /** |
| * kbase_vinstr_hwcnt_kernel_setup - configure hw counters for kernel side |
| * client |
| * @vinstr_ctx: vinstr context |
| * @setup: reader's configuration |
| * @kernel_buffer: pointer to dump buffer |
| * |
| * setup->buffer_count and setup->fd are not used for kernel side clients. |
| * |
| * Return: pointer to client structure, or NULL on failure |
| */ |
| struct kbase_vinstr_client *kbase_vinstr_hwcnt_kernel_setup( |
| struct kbase_vinstr_context *vinstr_ctx, |
| struct kbase_uk_hwcnt_reader_setup *setup, |
| void *kernel_buffer); |
| |
| /** |
| * kbase_vinstr_hwc_dump - issue counter dump for vinstr client |
| * @cli: pointer to vinstr client |
| * @event_id: id of event that triggered hwcnt dump |
| * |
| * Return: zero on success |
| */ |
| int kbase_vinstr_hwc_dump( |
| struct kbase_vinstr_client *cli, |
| enum base_hwcnt_reader_event event_id); |
| |
| /** |
| * kbase_vinstr_hwc_clear - performs a reset of the hardware counters for |
| * a given kbase context |
| * @cli: pointer to vinstr client |
| * |
| * Return: zero on success |
| */ |
| int kbase_vinstr_hwc_clear(struct kbase_vinstr_client *cli); |
| |
| /** |
| * kbase_vinstr_try_suspend - try suspending operation of a given vinstr context |
| * @vinstr_ctx: vinstr context |
| * |
| * Return: 0 on success, or negative if state change is in progress |
| * |
| * Warning: This API call is non-generic. It is meant to be used only by |
| * job scheduler state machine. |
| * |
| * Function initiates vinstr switch to suspended state. Once it was called |
| * vinstr enters suspending state. If function return non-zero value, it |
| * indicates that state switch is not complete and function must be called |
| * again. On state switch vinstr will trigger job scheduler state machine |
| * cycle. |
| */ |
| int kbase_vinstr_try_suspend(struct kbase_vinstr_context *vinstr_ctx); |
| |
| /** |
| * kbase_vinstr_suspend - suspends operation of a given vinstr context |
| * @vinstr_ctx: vinstr context |
| * |
| * Function initiates vinstr switch to suspended state. Then it blocks until |
| * operation is completed. |
| */ |
| void kbase_vinstr_suspend(struct kbase_vinstr_context *vinstr_ctx); |
| |
| /** |
| * kbase_vinstr_resume - resumes operation of a given vinstr context |
| * @vinstr_ctx: vinstr context |
| * |
| * Function can be called only if it was preceded by a successful call |
| * to kbase_vinstr_suspend. |
| */ |
| void kbase_vinstr_resume(struct kbase_vinstr_context *vinstr_ctx); |
| |
| /** |
| * kbase_vinstr_dump_size - Return required size of dump buffer |
| * @kbdev: device pointer |
| * |
| * Return : buffer size in bytes |
| */ |
| size_t kbase_vinstr_dump_size(struct kbase_device *kbdev); |
| |
| /** |
| * kbase_vinstr_detach_client - Detach a client from the vinstr core |
| * @cli: pointer to vinstr client |
| */ |
| void kbase_vinstr_detach_client(struct kbase_vinstr_client *cli); |
| |
| #endif /* _KBASE_VINSTR_H_ */ |
| |
