1112ed2d3SChris Wilson /* 2112ed2d3SChris Wilson * SPDX-License-Identifier: MIT 3112ed2d3SChris Wilson * 4112ed2d3SChris Wilson * Copyright © 2019 Intel Corporation 5112ed2d3SChris Wilson */ 6112ed2d3SChris Wilson 7112ed2d3SChris Wilson #ifndef __INTEL_CONTEXT_H__ 8112ed2d3SChris Wilson #define __INTEL_CONTEXT_H__ 9112ed2d3SChris Wilson 10112ed2d3SChris Wilson #include <linux/lockdep.h> 11112ed2d3SChris Wilson 1212c255b5SChris Wilson #include "i915_active.h" 13112ed2d3SChris Wilson #include "intel_context_types.h" 14112ed2d3SChris Wilson #include "intel_engine_types.h" 15112ed2d3SChris Wilson 16112ed2d3SChris Wilson void intel_context_init(struct intel_context *ce, 17112ed2d3SChris Wilson struct i915_gem_context *ctx, 18112ed2d3SChris Wilson struct intel_engine_cs *engine); 19df8cf31eSChris Wilson void intel_context_fini(struct intel_context *ce); 20112ed2d3SChris Wilson 21112ed2d3SChris Wilson struct intel_context * 225e2a0419SChris Wilson intel_context_create(struct i915_gem_context *ctx, 23112ed2d3SChris Wilson struct intel_engine_cs *engine); 24112ed2d3SChris Wilson 255e2a0419SChris Wilson void intel_context_free(struct intel_context *ce); 265e2a0419SChris Wilson 27112ed2d3SChris Wilson /** 286b736de5SChris Wilson * intel_context_lock_pinned - Stablises the 'pinned' status of the HW context 296b736de5SChris Wilson * @ce - the context 30112ed2d3SChris Wilson * 31112ed2d3SChris Wilson * Acquire a lock on the pinned status of the HW context, such that the context 32112ed2d3SChris Wilson * can neither be bound to the GPU or unbound whilst the lock is held, i.e. 33112ed2d3SChris Wilson * intel_context_is_pinned() remains stable. 34112ed2d3SChris Wilson */ 356b736de5SChris Wilson static inline int intel_context_lock_pinned(struct intel_context *ce) 366b736de5SChris Wilson __acquires(ce->pin_mutex) 376b736de5SChris Wilson { 386b736de5SChris Wilson return mutex_lock_interruptible(&ce->pin_mutex); 396b736de5SChris Wilson } 40112ed2d3SChris Wilson 416b736de5SChris Wilson /** 426b736de5SChris Wilson * intel_context_is_pinned - Reports the 'pinned' status 436b736de5SChris Wilson * @ce - the context 446b736de5SChris Wilson * 456b736de5SChris Wilson * While in use by the GPU, the context, along with its ring and page 466b736de5SChris Wilson * tables is pinned into memory and the GTT. 476b736de5SChris Wilson * 486b736de5SChris Wilson * Returns: true if the context is currently pinned for use by the GPU. 496b736de5SChris Wilson */ 50112ed2d3SChris Wilson static inline bool 51112ed2d3SChris Wilson intel_context_is_pinned(struct intel_context *ce) 52112ed2d3SChris Wilson { 53112ed2d3SChris Wilson return atomic_read(&ce->pin_count); 54112ed2d3SChris Wilson } 55112ed2d3SChris Wilson 566b736de5SChris Wilson /** 576b736de5SChris Wilson * intel_context_unlock_pinned - Releases the earlier locking of 'pinned' status 586b736de5SChris Wilson * @ce - the context 596b736de5SChris Wilson * 606b736de5SChris Wilson * Releases the lock earlier acquired by intel_context_unlock_pinned(). 616b736de5SChris Wilson */ 626b736de5SChris Wilson static inline void intel_context_unlock_pinned(struct intel_context *ce) 636b736de5SChris Wilson __releases(ce->pin_mutex) 646b736de5SChris Wilson { 656b736de5SChris Wilson mutex_unlock(&ce->pin_mutex); 666b736de5SChris Wilson } 67112ed2d3SChris Wilson 68fa9f6681SChris Wilson int __intel_context_do_pin(struct intel_context *ce); 69fa9f6681SChris Wilson 70fa9f6681SChris Wilson static inline int intel_context_pin(struct intel_context *ce) 71fa9f6681SChris Wilson { 72fa9f6681SChris Wilson if (likely(atomic_inc_not_zero(&ce->pin_count))) 73fa9f6681SChris Wilson return 0; 74fa9f6681SChris Wilson 75fa9f6681SChris Wilson return __intel_context_do_pin(ce); 76fa9f6681SChris Wilson } 77112ed2d3SChris Wilson 78112ed2d3SChris Wilson static inline void __intel_context_pin(struct intel_context *ce) 79112ed2d3SChris Wilson { 80112ed2d3SChris Wilson GEM_BUG_ON(!intel_context_is_pinned(ce)); 81112ed2d3SChris Wilson atomic_inc(&ce->pin_count); 82112ed2d3SChris Wilson } 83112ed2d3SChris Wilson 84112ed2d3SChris Wilson void intel_context_unpin(struct intel_context *ce); 85112ed2d3SChris Wilson 866eee33e8SChris Wilson void intel_context_enter_engine(struct intel_context *ce); 876eee33e8SChris Wilson void intel_context_exit_engine(struct intel_context *ce); 886eee33e8SChris Wilson 896eee33e8SChris Wilson static inline void intel_context_enter(struct intel_context *ce) 906eee33e8SChris Wilson { 916eee33e8SChris Wilson if (!ce->active_count++) 926eee33e8SChris Wilson ce->ops->enter(ce); 936eee33e8SChris Wilson } 946eee33e8SChris Wilson 956eee33e8SChris Wilson static inline void intel_context_mark_active(struct intel_context *ce) 966eee33e8SChris Wilson { 976eee33e8SChris Wilson ++ce->active_count; 986eee33e8SChris Wilson } 996eee33e8SChris Wilson 1006eee33e8SChris Wilson static inline void intel_context_exit(struct intel_context *ce) 1016eee33e8SChris Wilson { 1026eee33e8SChris Wilson GEM_BUG_ON(!ce->active_count); 1036eee33e8SChris Wilson if (!--ce->active_count) 1046eee33e8SChris Wilson ce->ops->exit(ce); 1056eee33e8SChris Wilson } 1066eee33e8SChris Wilson 107d8af05ffSChris Wilson int intel_context_active_acquire(struct intel_context *ce); 108d8af05ffSChris Wilson void intel_context_active_release(struct intel_context *ce); 109ce476c80SChris Wilson 110112ed2d3SChris Wilson static inline struct intel_context *intel_context_get(struct intel_context *ce) 111112ed2d3SChris Wilson { 112112ed2d3SChris Wilson kref_get(&ce->ref); 113112ed2d3SChris Wilson return ce; 114112ed2d3SChris Wilson } 115112ed2d3SChris Wilson 116112ed2d3SChris Wilson static inline void intel_context_put(struct intel_context *ce) 117112ed2d3SChris Wilson { 118112ed2d3SChris Wilson kref_put(&ce->ref, ce->ops->destroy); 119112ed2d3SChris Wilson } 120112ed2d3SChris Wilson 121f4d57d83SChris Wilson static inline int __must_check 122f4d57d83SChris Wilson intel_context_timeline_lock(struct intel_context *ce) 12375d0a7f3SChris Wilson __acquires(&ce->timeline->mutex) 1242ccdf6a1SChris Wilson { 12575d0a7f3SChris Wilson return mutex_lock_interruptible(&ce->timeline->mutex); 1262ccdf6a1SChris Wilson } 1272ccdf6a1SChris Wilson 1282ccdf6a1SChris Wilson static inline void intel_context_timeline_unlock(struct intel_context *ce) 12975d0a7f3SChris Wilson __releases(&ce->timeline->mutex) 1302ccdf6a1SChris Wilson { 13175d0a7f3SChris Wilson mutex_unlock(&ce->timeline->mutex); 1322ccdf6a1SChris Wilson } 1332ccdf6a1SChris Wilson 134a9877da2SChris Wilson int intel_context_prepare_remote_request(struct intel_context *ce, 135a9877da2SChris Wilson struct i915_request *rq); 136a9877da2SChris Wilson 1375e2a0419SChris Wilson struct i915_request *intel_context_create_request(struct intel_context *ce); 1385e2a0419SChris Wilson 13948ae397bSChris Wilson static inline struct intel_ring *__intel_context_ring_size(u64 sz) 14048ae397bSChris Wilson { 14148ae397bSChris Wilson return u64_to_ptr(struct intel_ring, sz); 14248ae397bSChris Wilson } 14348ae397bSChris Wilson 144112ed2d3SChris Wilson #endif /* __INTEL_CONTEXT_H__ */ 145