All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jon Hunter <jon-hunter@ti.com>
To: Afzal Mohammed <afzal@ti.com>
Cc: tony@atomide.com, paul@pwsan.com, linux-omap@vger.kernel.org,
	linux-arm-kernel@lists.infradead.org
Subject: Re: [PATCH v5 07/14] ARM: OMAP2+: gpmc: time setting (register#) helper
Date: Tue, 12 Jun 2012 13:55:23 -0500	[thread overview]
Message-ID: <4FD7909B.4040304@ti.com> (raw)
In-Reply-To: <aafc6bc498e303be0bc86ce1ae395148fdca5c3d.1339419492.git.afzal@ti.com>


On 06/11/2012 09:27 AM, Afzal Mohammed wrote:
> Helper for setting GPMC timing by taking input as register values.

When are the timings calculated? Why not just use the existing
gpmc_cs_set_timings()?

I guess I am not convinced that we need to have multiple formats to pass
timings such as clock, period, etc.

I think that it is sufficient to pass the timings as time (period) as is
currently done and have the driver convert to clocks based upon the gpmc
fclk rate.

Jon

> Signed-off-by: Afzal Mohammed <afzal@ti.com>
> ---
>  arch/arm/mach-omap2/gpmc.c |   43 +++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 43 insertions(+)
> 
> diff --git a/arch/arm/mach-omap2/gpmc.c b/arch/arm/mach-omap2/gpmc.c
> index 4e19010..e60076e3 100644
> --- a/arch/arm/mach-omap2/gpmc.c
> +++ b/arch/arm/mach-omap2/gpmc.c
> @@ -960,6 +960,49 @@ static void gpmc_setup_cs_config(unsigned cs, unsigned conf)
>  	gpmc_cs_write_reg(cs, GPMC_CS_CONFIG1, l);
>  }
>  
> +static inline void gpmc_set_one_timing(int cs, int reg, int start,
> +							int end, u32 val)
> +{
> +	u32 l;
> +	unsigned mask;
> +
> +	mask = (1 << (end - start + 1)) - 1;
> +	l = gpmc_cs_read_reg(cs, reg);
> +	l &= ~(mask << start);
> +	l |= val << start;
> +	gpmc_cs_write_reg(cs, reg, l);
> +}
> +
> +static void gpmc_cs_set_register_timings(int cs, const struct gpmc_timings *t)
> +{
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG1, 0, 1, t->sync_clk);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG1, 18, 19, t->wait_monitoring);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG1, 25, 26, t->clk_activation);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG2, 0, 3, t->cs_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG2, 8, 12, t->cs_rd_off);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG2, 16, 20, t->cs_wr_off);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG3, 0, 3, t->adv_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG3, 8, 12, t->adv_rd_off);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG3, 16, 20, t->adv_wr_off);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 0, 3, t->oe_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 8, 12, t->oe_off);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 16, 19, t->we_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 24, 28, t->we_off);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG5, 24, 27, t->page_burst_access);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 0, 3, t->bus_turnaround);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 8, 11,	t->cycle2cycle_delay);
> +
> +	if (gpmc_revision >= 4) {
> +		gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 16, 19,
> +						t->wr_data_mux_bus);
> +		gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 24, 28, t->wr_access);
> +	}
> +}
> +
>  static inline unsigned gpmc_bit_to_irq(unsigned bitmask)
>  {
>  	return bitmask;

WARNING: multiple messages have this Message-ID (diff)
From: jon-hunter@ti.com (Jon Hunter)
To: linux-arm-kernel@lists.infradead.org
Subject: [PATCH v5 07/14] ARM: OMAP2+: gpmc: time setting (register#) helper
Date: Tue, 12 Jun 2012 13:55:23 -0500	[thread overview]
Message-ID: <4FD7909B.4040304@ti.com> (raw)
In-Reply-To: <aafc6bc498e303be0bc86ce1ae395148fdca5c3d.1339419492.git.afzal@ti.com>


On 06/11/2012 09:27 AM, Afzal Mohammed wrote:
> Helper for setting GPMC timing by taking input as register values.

When are the timings calculated? Why not just use the existing
gpmc_cs_set_timings()?

I guess I am not convinced that we need to have multiple formats to pass
timings such as clock, period, etc.

I think that it is sufficient to pass the timings as time (period) as is
currently done and have the driver convert to clocks based upon the gpmc
fclk rate.

Jon

> Signed-off-by: Afzal Mohammed <afzal@ti.com>
> ---
>  arch/arm/mach-omap2/gpmc.c |   43 +++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 43 insertions(+)
> 
> diff --git a/arch/arm/mach-omap2/gpmc.c b/arch/arm/mach-omap2/gpmc.c
> index 4e19010..e60076e3 100644
> --- a/arch/arm/mach-omap2/gpmc.c
> +++ b/arch/arm/mach-omap2/gpmc.c
> @@ -960,6 +960,49 @@ static void gpmc_setup_cs_config(unsigned cs, unsigned conf)
>  	gpmc_cs_write_reg(cs, GPMC_CS_CONFIG1, l);
>  }
>  
> +static inline void gpmc_set_one_timing(int cs, int reg, int start,
> +							int end, u32 val)
> +{
> +	u32 l;
> +	unsigned mask;
> +
> +	mask = (1 << (end - start + 1)) - 1;
> +	l = gpmc_cs_read_reg(cs, reg);
> +	l &= ~(mask << start);
> +	l |= val << start;
> +	gpmc_cs_write_reg(cs, reg, l);
> +}
> +
> +static void gpmc_cs_set_register_timings(int cs, const struct gpmc_timings *t)
> +{
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG1, 0, 1, t->sync_clk);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG1, 18, 19, t->wait_monitoring);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG1, 25, 26, t->clk_activation);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG2, 0, 3, t->cs_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG2, 8, 12, t->cs_rd_off);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG2, 16, 20, t->cs_wr_off);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG3, 0, 3, t->adv_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG3, 8, 12, t->adv_rd_off);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG3, 16, 20, t->adv_wr_off);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 0, 3, t->oe_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 8, 12, t->oe_off);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 16, 19, t->we_on);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG4, 24, 28, t->we_off);
> +
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG5, 24, 27, t->page_burst_access);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 0, 3, t->bus_turnaround);
> +	gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 8, 11,	t->cycle2cycle_delay);
> +
> +	if (gpmc_revision >= 4) {
> +		gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 16, 19,
> +						t->wr_data_mux_bus);
> +		gpmc_set_one_timing(cs, GPMC_CS_CONFIG6, 24, 28, t->wr_access);
> +	}
> +}
> +
>  static inline unsigned gpmc_bit_to_irq(unsigned bitmask)
>  {
>  	return bitmask;

  reply	other threads:[~2012-06-12 18:55 UTC|newest]

Thread overview: 232+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-06-11 14:25 [PATCH v5 00/14] GPMC driver conversion Afzal Mohammed
2012-06-11 14:25 ` Afzal Mohammed
2012-06-11 14:26 ` [PATCH v5 01/14] ARM: OMAP2+: gpmc: platform definitions Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-12 18:58   ` Jon Hunter
2012-06-12 18:58     ` Jon Hunter
2012-06-13  6:25     ` Mohammed, Afzal
2012-06-13  6:25       ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 02/14] ARM: OMAP2+: gpmc: Adapt to HWMOD Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 19:56   ` Jon Hunter
2012-06-11 19:56     ` Jon Hunter
2012-06-12  6:53     ` Mohammed, Afzal
2012-06-12  6:53       ` Mohammed, Afzal
2012-06-12 17:40       ` Jon Hunter
2012-06-12 17:40         ` Jon Hunter
2012-06-13  5:20         ` Mohammed, Afzal
2012-06-13  5:20           ` Mohammed, Afzal
2012-06-13 12:02           ` Tony Lindgren
2012-06-13 12:02             ` Tony Lindgren
2012-06-13 13:05             ` Mohammed, Afzal
2012-06-13 13:05               ` Mohammed, Afzal
2012-06-13 13:39               ` Tony Lindgren
2012-06-13 13:39                 ` Tony Lindgren
2012-06-13 13:59                 ` Mohammed, Afzal
2012-06-13 13:59                   ` Mohammed, Afzal
2012-06-13 15:08               ` Jon Hunter
2012-06-13 15:08                 ` Jon Hunter
2012-06-14  7:07                 ` Mohammed, Afzal
2012-06-14  7:07                   ` Mohammed, Afzal
2012-06-13 14:51           ` Jon Hunter
2012-06-13 14:51             ` Jon Hunter
2012-06-14  6:17             ` Mohammed, Afzal
2012-06-14  6:17               ` Mohammed, Afzal
2012-06-14  6:20               ` Mohammed, Afzal
2012-06-14  6:20                 ` Mohammed, Afzal
2012-06-14 20:51               ` Jon Hunter
2012-06-14 20:51                 ` Jon Hunter
2012-06-15  0:20                 ` Paul Walmsley
2012-06-15  0:20                   ` Paul Walmsley
2012-06-15 15:33                   ` Jon Hunter
2012-06-15 15:33                     ` Jon Hunter
2012-06-15 10:40                 ` Mohammed, Afzal
2012-06-15 10:40                   ` Mohammed, Afzal
2012-06-14  7:03             ` Mohammed, Afzal
2012-06-14  7:03               ` Mohammed, Afzal
2012-06-14 13:22               ` Jon Hunter
2012-06-14 13:22                 ` Jon Hunter
2012-06-14 13:32                 ` Mohammed, Afzal
2012-06-14 13:32                   ` Mohammed, Afzal
2012-06-14 18:58                   ` Jon Hunter
2012-06-14 18:58                     ` Jon Hunter
2012-06-15 10:22                     ` Mohammed, Afzal
2012-06-15 10:22                       ` Mohammed, Afzal
2012-06-15 12:45                       ` Tony Lindgren
2012-06-15 12:45                         ` Tony Lindgren
2012-06-16  9:15                         ` Mohammed, Afzal
2012-06-16  9:15                           ` Mohammed, Afzal
2012-06-20 13:28                           ` Tony Lindgren
2012-06-20 13:28                             ` Tony Lindgren
2012-06-20 14:52                             ` Mohammed, Afzal
2012-06-20 14:52                               ` Mohammed, Afzal
2012-06-20 15:12                               ` Tony Lindgren
2012-06-20 15:12                                 ` Tony Lindgren
2012-06-20 23:35                                 ` Jon Hunter
2012-06-20 23:35                                   ` Jon Hunter
2012-06-22 13:29                                   ` Mohammed, Afzal
2012-06-22 13:29                                     ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 03/14] ARM: OMAP2+: gpmc: driver migration helper Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 20:30   ` Jon Hunter
2012-06-11 20:30     ` Jon Hunter
2012-06-12  7:09     ` Mohammed, Afzal
2012-06-12  7:09       ` Mohammed, Afzal
2012-06-12 17:46       ` Jon Hunter
2012-06-12 17:46         ` Jon Hunter
2012-06-13  5:25         ` Mohammed, Afzal
2012-06-13  5:25           ` Mohammed, Afzal
2012-06-13 12:04     ` Tony Lindgren
2012-06-13 12:04       ` Tony Lindgren
2012-06-13 12:18       ` Mohammed, Afzal
2012-06-13 12:18         ` Mohammed, Afzal
2012-06-13 13:46         ` Mohammed, Afzal
2012-06-13 13:46           ` Mohammed, Afzal
2012-06-14  6:34           ` Tony Lindgren
2012-06-14  6:34             ` Tony Lindgren
2012-06-11 14:26 ` [PATCH v5 04/14] ARM: OMAP2+: gpmc: minimal driver support Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 20:43   ` Jon Hunter
2012-06-11 20:43     ` Jon Hunter
2012-06-12  7:16     ` Mohammed, Afzal
2012-06-12  7:16       ` Mohammed, Afzal
2012-06-12 17:57       ` Jon Hunter
2012-06-12 17:57         ` Jon Hunter
2012-06-13 12:07         ` Tony Lindgren
2012-06-13 12:07           ` Tony Lindgren
2012-06-13 13:12           ` Mohammed, Afzal
2012-06-13 13:12             ` Mohammed, Afzal
2012-06-13 13:40             ` Tony Lindgren
2012-06-13 13:40               ` Tony Lindgren
2012-06-13 13:44               ` Tony Lindgren
2012-06-13 13:44                 ` Tony Lindgren
2012-06-13 13:50                 ` Mohammed, Afzal
2012-06-13 13:50                   ` Mohammed, Afzal
2012-06-13 13:52                 ` Mohammed, Afzal
2012-06-13 13:52                   ` Mohammed, Afzal
2012-06-14  6:35                   ` Tony Lindgren
2012-06-14  6:35                     ` Tony Lindgren
2012-06-14  6:40                     ` Mohammed, Afzal
2012-06-14  6:40                       ` Mohammed, Afzal
2012-06-14  8:39                       ` Tony Lindgren
2012-06-14  8:39                         ` Tony Lindgren
2012-06-14  8:42                         ` Mohammed, Afzal
2012-06-14  8:42                           ` Mohammed, Afzal
2012-06-13 17:05               ` Jon Hunter
2012-06-13 17:05                 ` Jon Hunter
2012-06-12 19:19   ` Jon Hunter
2012-06-12 19:19     ` Jon Hunter
2012-06-13  6:29     ` Mohammed, Afzal
2012-06-13  6:29       ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 05/14] ARM: OMAP2+: gpmc: resource creation helpers Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 20:57   ` Jon Hunter
2012-06-11 20:57     ` Jon Hunter
2012-06-12  8:30     ` Mohammed, Afzal
2012-06-12  8:30       ` Mohammed, Afzal
2012-06-12 18:02       ` Jon Hunter
2012-06-12 18:02         ` Jon Hunter
2012-06-13  5:29         ` Mohammed, Afzal
2012-06-13  5:29           ` Mohammed, Afzal
2012-06-13 15:33           ` Jon Hunter
2012-06-13 15:33             ` Jon Hunter
2012-06-14  8:44             ` Mohammed, Afzal
2012-06-14  8:44               ` Mohammed, Afzal
2012-06-11 14:26 ` [PATCH v5 06/14] ARM: OMAP2+: gpmc: CS configuration helper Afzal Mohammed
2012-06-11 14:26   ` Afzal Mohammed
2012-06-11 21:43   ` Jon Hunter
2012-06-11 21:43     ` Jon Hunter
2012-06-12  8:40     ` Mohammed, Afzal
2012-06-12  8:40       ` Mohammed, Afzal
2012-06-12 12:58       ` Mohammed, Afzal
2012-06-12 12:58         ` Mohammed, Afzal
2012-06-12 18:09         ` Jon Hunter
2012-06-12 18:09           ` Jon Hunter
2012-06-13  5:50           ` Mohammed, Afzal
2012-06-13  5:50             ` Mohammed, Afzal
2012-06-13 15:39             ` Jon Hunter
2012-06-13 15:39               ` Jon Hunter
2012-06-14  8:45               ` Mohammed, Afzal
2012-06-14  8:45                 ` Mohammed, Afzal
2012-06-12 18:06       ` Jon Hunter
2012-06-12 18:06         ` Jon Hunter
2012-06-13  5:35         ` Mohammed, Afzal
2012-06-13  5:35           ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 07/14] ARM: OMAP2+: gpmc: time setting (register#) helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-12 18:55   ` Jon Hunter [this message]
2012-06-12 18:55     ` Jon Hunter
2012-06-13  6:15     ` Mohammed, Afzal
2012-06-13  6:15       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 08/14] ARM: OMAP2+: gpmc: bool type timing helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 22:27   ` Jon Hunter
2012-06-11 22:27     ` Jon Hunter
2012-06-12  8:41     ` Mohammed, Afzal
2012-06-12  8:41       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 09/14] ARM: OMAP2+: gpmc: holler if no configuration Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 22:30   ` Jon Hunter
2012-06-11 22:30     ` Jon Hunter
2012-06-12  8:44     ` Mohammed, Afzal
2012-06-12  8:44       ` Mohammed, Afzal
2012-06-12 18:11       ` Jon Hunter
2012-06-12 18:11         ` Jon Hunter
2012-06-11 14:27 ` [PATCH v5 10/14] ARM: OMAP2+: gpmc: waitpin helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 22:59   ` Jon Hunter
2012-06-11 22:59     ` Jon Hunter
2012-06-12  9:00     ` Mohammed, Afzal
2012-06-12  9:00       ` Mohammed, Afzal
2012-06-12 18:15       ` Jon Hunter
2012-06-12 18:15         ` Jon Hunter
2012-06-13  7:37         ` Mohammed, Afzal
2012-06-13  7:37           ` Mohammed, Afzal
2012-06-13 15:44           ` Jon Hunter
2012-06-13 15:44             ` Jon Hunter
2012-06-14  8:48             ` Mohammed, Afzal
2012-06-14  8:48               ` Mohammed, Afzal
2012-06-14 21:06               ` Jon Hunter
2012-06-14 21:06                 ` Jon Hunter
2012-06-15 10:50                 ` Mohammed, Afzal
2012-06-15 10:50                   ` Mohammed, Afzal
2012-06-12 18:37   ` Jon Hunter
2012-06-12 18:37     ` Jon Hunter
2012-06-13  7:47     ` Mohammed, Afzal
2012-06-13  7:47       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 11/14] ARM: OMAP2+: gpmc: handle connected peripherals Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-13 15:31   ` Jon Hunter
2012-06-13 15:31     ` Jon Hunter
2012-06-14  8:40     ` Mohammed, Afzal
2012-06-14  8:40       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 12/14] ARM: OMAP2+: gpmc: cs reconfigure helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 23:04   ` Jon Hunter
2012-06-11 23:04     ` Jon Hunter
2012-06-12  9:01     ` Mohammed, Afzal
2012-06-12  9:01       ` Mohammed, Afzal
2012-06-11 14:27 ` [PATCH v5 13/14] ARM: OMAP2+: gpmc: update nand register info Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-11 14:27 ` [PATCH v5 14/14] ARM: OMAP2+: gpmc: writeprotect helper Afzal Mohammed
2012-06-11 14:27   ` Afzal Mohammed
2012-06-12 18:42   ` Jon Hunter
2012-06-12 18:42     ` Jon Hunter
2012-06-13  6:10     ` Mohammed, Afzal
2012-06-13  6:10       ` Mohammed, Afzal
2012-06-13 16:28       ` Jon Hunter
2012-06-13 16:28         ` Jon Hunter
2012-06-14  8:54         ` Mohammed, Afzal
2012-06-14  8:54           ` Mohammed, Afzal
2012-06-14  9:36           ` Tony Lindgren
2012-06-14  9:36             ` Tony Lindgren
2012-06-14 10:21             ` Mohammed, Afzal
2012-06-14 10:21               ` Mohammed, Afzal
2012-06-12 10:39 ` [PATCH v5 00/14] GPMC driver conversion Mohammed, Afzal
2012-06-12 10:39   ` Mohammed, Afzal
2012-06-13 12:33   ` Tony Lindgren
2012-06-13 12:33     ` Tony Lindgren
2012-06-15 10:56     ` Mohammed, Afzal
2012-06-15 10:56       ` Mohammed, Afzal
2012-06-15 12:51       ` Tony Lindgren
2012-06-15 12:51         ` Tony Lindgren

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=4FD7909B.4040304@ti.com \
    --to=jon-hunter@ti.com \
    --cc=afzal@ti.com \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-omap@vger.kernel.org \
    --cc=paul@pwsan.com \
    --cc=tony@atomide.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.