Re: [Intel-gfx] [PATCH 6/9] drm/i915: Split skl_get_dpll()

2016-08-29 Thread Manasi Navare
On Mon, Aug 22, 2016 at 06:41:05PM -0700, Manasi Navare wrote:
> From: Jim Bride 
> 
> Split out the DisplayPort and HDMI pll setup code into separate
> functions and refactor the DP code does not directly depend on
> crtc state, so that the code can be used for upfront link training.
> 
> Signed-off-by: Jim Bride 
  Reviewed-by: Manasi Navare 


> ---
>  drivers/gpu/drm/i915/intel_dpll_mgr.c | 131 
> +-
>  drivers/gpu/drm/i915/intel_dpll_mgr.h |   4 ++
>  2 files changed, 87 insertions(+), 48 deletions(-)
> 
> diff --git a/drivers/gpu/drm/i915/intel_dpll_mgr.c 
> b/drivers/gpu/drm/i915/intel_dpll_mgr.c
> index 61d2311..8ce220e 100644
> --- a/drivers/gpu/drm/i915/intel_dpll_mgr.c
> +++ b/drivers/gpu/drm/i915/intel_dpll_mgr.c
> @@ -1172,75 +1172,110 @@ skip_remaining_dividers:
>   return true;
>  }
>  
> -static struct intel_shared_dpll *
> -skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
> -  struct intel_encoder *encoder)
> +static bool skl_ddi_hdmi_pll_dividers(struct intel_crtc *crtc,
> +   struct intel_crtc_state *crtc_state,
> +   int clock)
>  {
> - struct intel_shared_dpll *pll;
>   uint32_t ctrl1, cfgcr1, cfgcr2;
> - int clock = crtc_state->port_clock;
> + struct skl_wrpll_params wrpll_params = { 0, };
>  
>   /*
>* See comment in intel_dpll_hw_state to understand why we always use 0
>* as the DPLL id in this function.
>*/
> -
>   ctrl1 = DPLL_CTRL1_OVERRIDE(0);
>  
> - if (encoder->type == INTEL_OUTPUT_HDMI) {
> - struct skl_wrpll_params wrpll_params = { 0, };
> + ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
>  
> - ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
> + if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
> + return false;
>  
> - if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
> - return NULL;
> + cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
> + DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
> + wrpll_params.dco_integer;
> +
> + cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
> + DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
> + DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
> + DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
> + wrpll_params.central_freq;
> +
> + memset(_state->dpll_hw_state, 0,
> +sizeof(crtc_state->dpll_hw_state));
> +
> + crtc_state->dpll_hw_state.ctrl1 = ctrl1;
> + crtc_state->dpll_hw_state.cfgcr1 = cfgcr1;
> + crtc_state->dpll_hw_state.cfgcr2 = cfgcr2;
> + return true;
> +}
> +
> +
> +bool skl_ddi_dp_set_dpll_hw_state(int clock,
> +   struct intel_dpll_hw_state *dpll_hw_state)
> +{
> + uint32_t ctrl1;
> +
> + /*
> +  * See comment in intel_dpll_hw_state to understand why we always use 0
> +  * as the DPLL id in this function.
> +  */
> + ctrl1 = DPLL_CTRL1_OVERRIDE(0);
> + switch (clock / 2) {
> + case 81000:
> + ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_810, 0);
> + break;
> + case 135000:
> + ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1350, 0);
> + break;
> + case 27:
> + ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2700, 0);
> + break;
> + /* eDP 1.4 rates */
> + case 162000:
> + ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1620, 0);
> + break;
> + case 108000:
> + ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1080, 0);
> + break;
> + case 216000:
> + ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2160, 0);
> + break;
> + }
>  
> - cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
> -  DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
> -  wrpll_params.dco_integer;
> + dpll_hw_state->ctrl1 = ctrl1;
> + return true;
> +}
>  
> - cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
> -  DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
> -  DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
> -  DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
> -  wrpll_params.central_freq;
> +static struct intel_shared_dpll *
> +skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
> +  struct intel_encoder *encoder)
> +{
> + struct intel_shared_dpll *pll;
> + int clock = crtc_state->port_clock;
> + bool bret;
> + struct intel_dpll_hw_state dpll_hw_state;
> +
> + memset(_hw_state, 0, sizeof(dpll_hw_state));
> +
> + if (encoder->type == INTEL_OUTPUT_HDMI) {
> + bret = 

[Intel-gfx] [PATCH 6/9] drm/i915: Split skl_get_dpll()

2016-08-22 Thread Manasi Navare
From: Jim Bride 

Split out the DisplayPort and HDMI pll setup code into separate
functions and refactor the DP code does not directly depend on
crtc state, so that the code can be used for upfront link training.

Signed-off-by: Jim Bride 
---
 drivers/gpu/drm/i915/intel_dpll_mgr.c | 131 +-
 drivers/gpu/drm/i915/intel_dpll_mgr.h |   4 ++
 2 files changed, 87 insertions(+), 48 deletions(-)

diff --git a/drivers/gpu/drm/i915/intel_dpll_mgr.c 
b/drivers/gpu/drm/i915/intel_dpll_mgr.c
index 61d2311..8ce220e 100644
--- a/drivers/gpu/drm/i915/intel_dpll_mgr.c
+++ b/drivers/gpu/drm/i915/intel_dpll_mgr.c
@@ -1172,75 +1172,110 @@ skip_remaining_dividers:
return true;
 }
 
-static struct intel_shared_dpll *
-skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
-struct intel_encoder *encoder)
+static bool skl_ddi_hdmi_pll_dividers(struct intel_crtc *crtc,
+ struct intel_crtc_state *crtc_state,
+ int clock)
 {
-   struct intel_shared_dpll *pll;
uint32_t ctrl1, cfgcr1, cfgcr2;
-   int clock = crtc_state->port_clock;
+   struct skl_wrpll_params wrpll_params = { 0, };
 
/*
 * See comment in intel_dpll_hw_state to understand why we always use 0
 * as the DPLL id in this function.
 */
-
ctrl1 = DPLL_CTRL1_OVERRIDE(0);
 
-   if (encoder->type == INTEL_OUTPUT_HDMI) {
-   struct skl_wrpll_params wrpll_params = { 0, };
+   ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
 
-   ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
+   if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
+   return false;
 
-   if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
-   return NULL;
+   cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
+   DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
+   wrpll_params.dco_integer;
+
+   cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
+   DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
+   DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
+   DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
+   wrpll_params.central_freq;
+
+   memset(_state->dpll_hw_state, 0,
+  sizeof(crtc_state->dpll_hw_state));
+
+   crtc_state->dpll_hw_state.ctrl1 = ctrl1;
+   crtc_state->dpll_hw_state.cfgcr1 = cfgcr1;
+   crtc_state->dpll_hw_state.cfgcr2 = cfgcr2;
+   return true;
+}
+
+
+bool skl_ddi_dp_set_dpll_hw_state(int clock,
+ struct intel_dpll_hw_state *dpll_hw_state)
+{
+   uint32_t ctrl1;
+
+   /*
+* See comment in intel_dpll_hw_state to understand why we always use 0
+* as the DPLL id in this function.
+*/
+   ctrl1 = DPLL_CTRL1_OVERRIDE(0);
+   switch (clock / 2) {
+   case 81000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_810, 0);
+   break;
+   case 135000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1350, 0);
+   break;
+   case 27:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2700, 0);
+   break;
+   /* eDP 1.4 rates */
+   case 162000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1620, 0);
+   break;
+   case 108000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1080, 0);
+   break;
+   case 216000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2160, 0);
+   break;
+   }
 
-   cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
-DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
-wrpll_params.dco_integer;
+   dpll_hw_state->ctrl1 = ctrl1;
+   return true;
+}
 
-   cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
-DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
-DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
-DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
-wrpll_params.central_freq;
+static struct intel_shared_dpll *
+skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
+struct intel_encoder *encoder)
+{
+   struct intel_shared_dpll *pll;
+   int clock = crtc_state->port_clock;
+   bool bret;
+   struct intel_dpll_hw_state dpll_hw_state;
+
+   memset(_hw_state, 0, sizeof(dpll_hw_state));
+
+   if (encoder->type == INTEL_OUTPUT_HDMI) {
+   bret = skl_ddi_hdmi_pll_dividers(crtc, crtc_state, clock);
+   if (!bret) {
+   DRM_DEBUG_KMS("Could not get HDMI pll dividers.\n");
+   return NULL;
+   }
} else if (encoder->type 

[Intel-gfx] [PATCH 6/9] drm/i915: Split skl_get_dpll()

2016-08-19 Thread Manasi Navare
From: Jim Bride 

Split out the DisplayPort and HDMI pll setup code into separate
functions and refactor the DP code does not directly depend on
crtc state, so that the code can be used for upfront link training.

Signed-off-by: Jim Bride 
---
 drivers/gpu/drm/i915/intel_dpll_mgr.c | 131 +-
 drivers/gpu/drm/i915/intel_dpll_mgr.h |   4 ++
 2 files changed, 87 insertions(+), 48 deletions(-)

diff --git a/drivers/gpu/drm/i915/intel_dpll_mgr.c 
b/drivers/gpu/drm/i915/intel_dpll_mgr.c
index 61d2311..8ce220e 100644
--- a/drivers/gpu/drm/i915/intel_dpll_mgr.c
+++ b/drivers/gpu/drm/i915/intel_dpll_mgr.c
@@ -1172,75 +1172,110 @@ skip_remaining_dividers:
return true;
 }
 
-static struct intel_shared_dpll *
-skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
-struct intel_encoder *encoder)
+static bool skl_ddi_hdmi_pll_dividers(struct intel_crtc *crtc,
+ struct intel_crtc_state *crtc_state,
+ int clock)
 {
-   struct intel_shared_dpll *pll;
uint32_t ctrl1, cfgcr1, cfgcr2;
-   int clock = crtc_state->port_clock;
+   struct skl_wrpll_params wrpll_params = { 0, };
 
/*
 * See comment in intel_dpll_hw_state to understand why we always use 0
 * as the DPLL id in this function.
 */
-
ctrl1 = DPLL_CTRL1_OVERRIDE(0);
 
-   if (encoder->type == INTEL_OUTPUT_HDMI) {
-   struct skl_wrpll_params wrpll_params = { 0, };
+   ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
 
-   ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
+   if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
+   return false;
 
-   if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
-   return NULL;
+   cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
+   DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
+   wrpll_params.dco_integer;
+
+   cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
+   DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
+   DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
+   DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
+   wrpll_params.central_freq;
+
+   memset(_state->dpll_hw_state, 0,
+  sizeof(crtc_state->dpll_hw_state));
+
+   crtc_state->dpll_hw_state.ctrl1 = ctrl1;
+   crtc_state->dpll_hw_state.cfgcr1 = cfgcr1;
+   crtc_state->dpll_hw_state.cfgcr2 = cfgcr2;
+   return true;
+}
+
+
+bool skl_ddi_dp_set_dpll_hw_state(int clock,
+ struct intel_dpll_hw_state *dpll_hw_state)
+{
+   uint32_t ctrl1;
+
+   /*
+* See comment in intel_dpll_hw_state to understand why we always use 0
+* as the DPLL id in this function.
+*/
+   ctrl1 = DPLL_CTRL1_OVERRIDE(0);
+   switch (clock / 2) {
+   case 81000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_810, 0);
+   break;
+   case 135000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1350, 0);
+   break;
+   case 27:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2700, 0);
+   break;
+   /* eDP 1.4 rates */
+   case 162000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1620, 0);
+   break;
+   case 108000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1080, 0);
+   break;
+   case 216000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2160, 0);
+   break;
+   }
 
-   cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
-DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
-wrpll_params.dco_integer;
+   dpll_hw_state->ctrl1 = ctrl1;
+   return true;
+}
 
-   cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
-DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
-DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
-DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
-wrpll_params.central_freq;
+static struct intel_shared_dpll *
+skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
+struct intel_encoder *encoder)
+{
+   struct intel_shared_dpll *pll;
+   int clock = crtc_state->port_clock;
+   bool bret;
+   struct intel_dpll_hw_state dpll_hw_state;
+
+   memset(_hw_state, 0, sizeof(dpll_hw_state));
+
+   if (encoder->type == INTEL_OUTPUT_HDMI) {
+   bret = skl_ddi_hdmi_pll_dividers(crtc, crtc_state, clock);
+   if (!bret) {
+   DRM_DEBUG_KMS("Could not get HDMI pll dividers.\n");
+   return NULL;
+   }
} else if (encoder->type 

[Intel-gfx] [PATCH 6/9] drm/i915: Split skl_get_dpll()

2016-08-08 Thread Manasi Navare
From: Jim Bride 

Split out the DisplayPort and HDMI pll setup code into separate
functions and refactor the DP code does not directly depend on
crtc state, so that the code can be used for upfront link training.

Signed-off-by: Jim Bride 
Signed-off-by: Manasi Navare 
---
 drivers/gpu/drm/i915/intel_dpll_mgr.c | 131 +-
 drivers/gpu/drm/i915/intel_dpll_mgr.h |   4 ++
 2 files changed, 87 insertions(+), 48 deletions(-)

diff --git a/drivers/gpu/drm/i915/intel_dpll_mgr.c 
b/drivers/gpu/drm/i915/intel_dpll_mgr.c
index 61d2311..8ce220e 100644
--- a/drivers/gpu/drm/i915/intel_dpll_mgr.c
+++ b/drivers/gpu/drm/i915/intel_dpll_mgr.c
@@ -1172,75 +1172,110 @@ skip_remaining_dividers:
return true;
 }
 
-static struct intel_shared_dpll *
-skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
-struct intel_encoder *encoder)
+static bool skl_ddi_hdmi_pll_dividers(struct intel_crtc *crtc,
+ struct intel_crtc_state *crtc_state,
+ int clock)
 {
-   struct intel_shared_dpll *pll;
uint32_t ctrl1, cfgcr1, cfgcr2;
-   int clock = crtc_state->port_clock;
+   struct skl_wrpll_params wrpll_params = { 0, };
 
/*
 * See comment in intel_dpll_hw_state to understand why we always use 0
 * as the DPLL id in this function.
 */
-
ctrl1 = DPLL_CTRL1_OVERRIDE(0);
 
-   if (encoder->type == INTEL_OUTPUT_HDMI) {
-   struct skl_wrpll_params wrpll_params = { 0, };
+   ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
 
-   ctrl1 |= DPLL_CTRL1_HDMI_MODE(0);
+   if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
+   return false;
 
-   if (!skl_ddi_calculate_wrpll(clock * 1000, _params))
-   return NULL;
+   cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
+   DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
+   wrpll_params.dco_integer;
+
+   cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
+   DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
+   DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
+   DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
+   wrpll_params.central_freq;
+
+   memset(_state->dpll_hw_state, 0,
+  sizeof(crtc_state->dpll_hw_state));
+
+   crtc_state->dpll_hw_state.ctrl1 = ctrl1;
+   crtc_state->dpll_hw_state.cfgcr1 = cfgcr1;
+   crtc_state->dpll_hw_state.cfgcr2 = cfgcr2;
+   return true;
+}
+
+
+bool skl_ddi_dp_set_dpll_hw_state(int clock,
+ struct intel_dpll_hw_state *dpll_hw_state)
+{
+   uint32_t ctrl1;
+
+   /*
+* See comment in intel_dpll_hw_state to understand why we always use 0
+* as the DPLL id in this function.
+*/
+   ctrl1 = DPLL_CTRL1_OVERRIDE(0);
+   switch (clock / 2) {
+   case 81000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_810, 0);
+   break;
+   case 135000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1350, 0);
+   break;
+   case 27:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2700, 0);
+   break;
+   /* eDP 1.4 rates */
+   case 162000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1620, 0);
+   break;
+   case 108000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_1080, 0);
+   break;
+   case 216000:
+   ctrl1 |= DPLL_CTRL1_LINK_RATE(DPLL_CTRL1_LINK_RATE_2160, 0);
+   break;
+   }
 
-   cfgcr1 = DPLL_CFGCR1_FREQ_ENABLE |
-DPLL_CFGCR1_DCO_FRACTION(wrpll_params.dco_fraction) |
-wrpll_params.dco_integer;
+   dpll_hw_state->ctrl1 = ctrl1;
+   return true;
+}
 
-   cfgcr2 = DPLL_CFGCR2_QDIV_RATIO(wrpll_params.qdiv_ratio) |
-DPLL_CFGCR2_QDIV_MODE(wrpll_params.qdiv_mode) |
-DPLL_CFGCR2_KDIV(wrpll_params.kdiv) |
-DPLL_CFGCR2_PDIV(wrpll_params.pdiv) |
-wrpll_params.central_freq;
+static struct intel_shared_dpll *
+skl_get_dpll(struct intel_crtc *crtc, struct intel_crtc_state *crtc_state,
+struct intel_encoder *encoder)
+{
+   struct intel_shared_dpll *pll;
+   int clock = crtc_state->port_clock;
+   bool bret;
+   struct intel_dpll_hw_state dpll_hw_state;
+
+   memset(_hw_state, 0, sizeof(dpll_hw_state));
+
+   if (encoder->type == INTEL_OUTPUT_HDMI) {
+   bret = skl_ddi_hdmi_pll_dividers(crtc, crtc_state, clock);
+   if (!bret) {
+   DRM_DEBUG_KMS("Could not get HDMI pll dividers.\n");
+   return