Quoting Jani Nikula (2020-01-21 11:39:15)
> Add convenience helpers for the most common uncore operations with
> struct drm_i915_private * as context rather than struct intel_uncore *.
>
> The goal is to replace all instances of I915_READ(),
> I915_POSTING_READ(), I915_WRITE(), I915_READ_FW(), and I915_WRITE_FW()
> in display/ with these, to finally be able to get rid of the implicit
> dev_priv local parameter use.
>
> The idea is that any non-u32 reads or writes are special enough that
> they can use the intel_uncore_* functions directly.
>
> v2:
> - rename the file intel_de.h
> - move intel_de_wait_for_* there too
> - also add de fw helpers
>
> Cc: Chris Wilson <chris@xxxxxxxxxxxxxxxxxx>
> Cc: Daniele Ceraolo Spurio <daniele.ceraolospurio@xxxxxxxxx>
> Cc: Joonas Lahtinen <joonas.lahtinen@xxxxxxxxxxxxxxx>
> Cc: Lucas De Marchi <lucas.demarchi@xxxxxxxxx>
> Cc: Rodrigo Vivi <rodrigo.vivi@xxxxxxxxx>
> Cc: Ville Syrjälä <ville.syrjala@xxxxxxxxxxxxxxx>
> Signed-off-by: Jani Nikula <jani.nikula@xxxxxxxxx>
> ---
> drivers/gpu/drm/i915/display/intel_de.h | 72 +++++++++++++++++++
> .../drm/i915/display/intel_display_types.h | 1 +
> drivers/gpu/drm/i915/i915_drv.h | 14 ----
> 3 files changed, 73 insertions(+), 14 deletions(-)
> create mode 100644 drivers/gpu/drm/i915/display/intel_de.h
>
> diff --git a/drivers/gpu/drm/i915/display/intel_de.h b/drivers/gpu/drm/i915/display/intel_de.h
> new file mode 100644
> index 000000000000..00da10bf35f5
> --- /dev/null
> +++ b/drivers/gpu/drm/i915/display/intel_de.h
> @@ -0,0 +1,72 @@
> +/* SPDX-License-Identifier: MIT */
> +/*
> + * Copyright © 2019 Intel Corporation
> + */
> +
> +#ifndef __INTEL_DE_H__
> +#define __INTEL_DE_H__
> +
> +#include "i915_drv.h"
> +#include "i915_reg.h"
> +#include "intel_uncore.h"
> +
> +static inline u32
> +intel_de_read(struct drm_i915_private *i915, i915_reg_t reg)
> +{
> + return intel_uncore_read(&i915->uncore, reg);
> +}
> +
> +static inline void
> +intel_de_posting_read(struct drm_i915_private *i915, i915_reg_t reg)
> +{
> + intel_uncore_posting_read(&i915->uncore, reg);
> +}
> +
> +/* Note: read the warnings for intel_uncore_*_fw() functions! */
> +static inline u32
> +intel_de_read_fw(struct drm_i915_private *i915, i915_reg_t reg)
> +{
> + return intel_uncore_read_fw(&i915->uncore, reg);
> +}
> +
> +static inline void
> +intel_de_write(struct drm_i915_private *i915, i915_reg_t reg, u32 val)
> +{
> + intel_uncore_write(&i915->uncore, reg, val);
> +}
> +
> +/* Note: read the warnings for intel_uncore_*_fw() functions! */
> +static inline void
> +intel_de_write_fw(struct drm_i915_private *i915, i915_reg_t reg, u32 val)
> +{
> + intel_uncore_write_fw(&i915->uncore, reg, val);
> +}
> +
> +static inline void
> +intel_de_rmw(struct drm_i915_private *i915, i915_reg_t reg, u32 clear, u32 set)
> +{
> + intel_uncore_rmw(&i915->uncore, reg, clear, set);
> +}
> +
> +static inline int
> +intel_de_wait_for_register(struct drm_i915_private *i915, i915_reg_t reg,
> + u32 mask, u32 value, unsigned int timeout)
> +{
> + return intel_wait_for_register(&i915->uncore, reg, mask, value, timeout);
> +}
> +
> +static inline int
> +intel_de_wait_for_set(struct drm_i915_private *i915, i915_reg_t reg,
> + u32 mask, unsigned int timeout)
> +{
> + return intel_de_wait_for_register(i915, reg, mask, mask, timeout);
> +}
> +
> +static inline int
> +intel_de_wait_for_clear(struct drm_i915_private *i915, i915_reg_t reg,
> + u32 mask, unsigned int timeout)
> +{
> + return intel_de_wait_for_register(i915, reg, mask, 0, timeout);
> +}
> +
> +#endif /* __INTEL_DE_H__ */
> diff --git a/drivers/gpu/drm/i915/display/intel_display_types.h b/drivers/gpu/drm/i915/display/intel_display_types.h
> index 155ce49ae764..0d7adc2c167a 100644
> --- a/drivers/gpu/drm/i915/display/intel_display_types.h
> +++ b/drivers/gpu/drm/i915/display/intel_display_types.h
> @@ -44,6 +44,7 @@
> #include <media/cec-notifier.h>
>
> #include "i915_drv.h"
> +#include "intel_de.h"
I don't think you want to include it from types.h though -- I think you
want to avoid inlines (at least inlines that depend upon external types)
away from the types.h so you can avoid the dreaded cycles.
So other than that,
Reviewed-by: Chris Wilson <chris@xxxxxxxxxxxxxxxxxx>
Or you may want to make the placement of the final include(s) a
separate patch.
-Chris
_______________________________________________
Intel-gfx mailing list
Intel-gfx@xxxxxxxxxxxxxxxxxxxxx
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
