> This patch adds a softreset, powerdown and picophy reset controllers for
> the STiH407 SoC.

s/adds a softreset/adds softreset/

> With this patch three new devices are registered: -
> 1. st,stih407-powerdown
> 2. st,stih407-softreset
> 3. st,stih407-picophyreset
> 
> All three devices use system configuration registers mapped via regmap to
> perform the reset or powerdown. The powerdown controller also has
> an acknowledgement.
> 
> A separate picophy reset controller manages the different reset channels 
> within
> the picophy, which have a different polarity to the other system softresets.
> Managing these different picophy softreset channels is necessary to correctly
> handle resuming from CPS when USB2 devices are plugged into the USB3 port.
> 
> Signed-off-by: Giuseppe Cavallaro <[email protected]>
> Signed-off-by: Peter Griffin <[email protected]>
> ---
>  .../bindings/reset/st,sti-picophyreset.txt         |  41 ++++++
>  drivers/reset/sti/Kconfig                          |   4 +
>  drivers/reset/sti/Makefile                         |   1 +
>  drivers/reset/sti/reset-stih407.c                  | 159 
> +++++++++++++++++++++
>  .../dt-bindings/reset-controller/stih407-resets.h  |  60 ++++++++

Documentation is normally split out as a separate patch.

>  5 files changed, 265 insertions(+)
>  create mode 100644 
> Documentation/devicetree/bindings/reset/st,sti-picophyreset.txt
>  create mode 100644 drivers/reset/sti/reset-stih407.c
>  create mode 100644 include/dt-bindings/reset-controller/stih407-resets.h
> 
> diff --git a/Documentation/devicetree/bindings/reset/st,sti-picophyreset.txt 
> b/Documentation/devicetree/bindings/reset/st,sti-picophyreset.txt
> new file mode 100644
> index 0000000..4c756d1
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/reset/st,sti-picophyreset.txt
> @@ -0,0 +1,41 @@
> +STMicroelectronics STi family Sysconfig Picophy SoftReset Controller
> +=============================================================================
> +
> +This binding describes a reset controller device that is used to enable and
> +disable on-chip PicoPHY USB2 phy(s) using "softreset" control bits found in
> +the STi family SoC system configuration registers.
> +
> +The actual action taken when softreset is asserted is hardware dependent.
> +However, when asserted it may not be possible to access the hardware's
> +registers and after an assert/deassert sequence the hardware's previous state
> +may no longer be valid.
> +
> +Please refer to Documentation/devicetree/bindings/reset/reset.txt
> +for common reset controller binding usage.
> +
> +Required properties:
> +- compatible: Should be "st,<chip>-softreset"

You need to list the possible values here in full.

> +- #reset-cells: 1, see below
> +
> +example:

Nit: s/example/Example

> +
> +     picophyreset: picophyreset-controller {
> +             #reset-cells = <1>;
> +             compatible = "st,stih407-picophyreset";

Nit: Stick the compatible string at the top.

> +     };
> +
> +Specifying picophyreset control of devices
> +=======================================
> +
> +Device nodes should specify the reset channel required in their "resets"
> +property, containing a phandle to the picophyreset device node and an
> +index specifying which channel to use, as described in
> +Documentation/devicetree/bindings/reset/reset.txt.
> +
> +example:

'\n'

> +     usb2_picophy0: usbpicophy@0 {
> +             resets = <&picophyreset STIH407_PICOPHY0_RESET>;
> +     };
> +
> +Macro definitions for the supported reset channels can be found in:
> +include/dt-bindings/reset-controller/stih407-resets.h
> diff --git a/drivers/reset/sti/Kconfig b/drivers/reset/sti/Kconfig
> index 88d2d03..f8c15a3 100644
> --- a/drivers/reset/sti/Kconfig
> +++ b/drivers/reset/sti/Kconfig
> @@ -12,4 +12,8 @@ config STIH416_RESET
>       bool
>       select STI_RESET_SYSCFG
>  
> +config STIH407_RESET
> +     bool
> +     select STI_RESET_SYSCFG
> +

No help?

>  endif
> diff --git a/drivers/reset/sti/Makefile b/drivers/reset/sti/Makefile
> index be1c976..dc85dfb 100644
> --- a/drivers/reset/sti/Makefile
> +++ b/drivers/reset/sti/Makefile
> @@ -2,3 +2,4 @@ obj-$(CONFIG_STI_RESET_SYSCFG) += reset-syscfg.o
>  
>  obj-$(CONFIG_STIH415_RESET) += reset-stih415.o
>  obj-$(CONFIG_STIH416_RESET) += reset-stih416.o
> +obj-$(CONFIG_STIH407_RESET) += reset-stih407.o

Genuine question: how different are these?  Can they be consolidated?

> diff --git a/drivers/reset/sti/reset-stih407.c 
> b/drivers/reset/sti/reset-stih407.c
> new file mode 100644
> index 0000000..1650792
> --- /dev/null
> +++ b/drivers/reset/sti/reset-stih407.c
> @@ -0,0 +1,159 @@
> +/*
> + * Copyright (C) 2013 STMicroelectronics (R&D) Limited
> + * Author: Giuseppe Cavallaro <[email protected]>
> + *
> + * This program is free software; you can redistribute it and/or modify
> + * it under the terms of the GNU General Public License as published by
> + * the Free Software Foundation; either version 2 of the License, or
> + * (at your option) any later version.
> + */
> +#include <linux/module.h>
> +#include <linux/of.h>
> +#include <linux/of_platform.h>
> +#include <linux/platform_device.h>
> +
> +#include <dt-bindings/reset-controller/stih407-resets.h>
> +
> +#include "reset-syscfg.h"

May as well squash these up.

> +/*
> + * STiH407 Peripheral powerdown definitions.
> + */

Should be single line comment.

> +static const char stih407_core[] = "st,stih407-core-syscfg";
> +static const char stih407_sbc_reg[] = "st,stih407-sbc-reg-syscfg";
> +static const char stih407_lpm[] = "st,stih407-lpm-syscfg";
> +
> +#define STIH407_PDN_0(_bit) \
> +     _SYSCFG_RST_CH(stih407_core, SYSCFG_5000, _bit, SYSSTAT_5500, _bit)
> +#define STIH407_PDN_1(_bit) \
> +     _SYSCFG_RST_CH(stih407_core, SYSCFG_5001, _bit, SYSSTAT_5501, _bit)
> +#define STIH407_PDN_ETH(_bit, _stat) \
> +     _SYSCFG_RST_CH(stih407_sbc_reg, SYSCFG_4032, _bit, SYSSTAT_4520, _stat)
> +
> +/* Powerdown requests control 0 */
> +#define SYSCFG_5000  0x0
> +#define SYSSTAT_5500 0x7d0

Separate these with a '\n'.

> +/* Powerdown requests control 1 (High Speed Links) */
> +#define SYSCFG_5001  0x4
> +#define SYSSTAT_5501 0x7d4
> +
> +/* Ethernet powerdown/status/reset */
> +#define      SYSCFG_4032     0x80
> +#define      SYSSTAT_4520    0x820
> +

What does this '\n' separate? Is it an Ethernet related value, or not?

> +#define      SYSCFG_4002     0x8

Can you address the formatting for all of the above.  Sometimes tabs
are used, other times it's spaces and the padding is also different -
can you standardise to 3 values post-fixing the '0x' i.e. 0xNNN.

> +static const struct syscfg_reset_channel_data stih407_powerdowns[] = {
> +     [STIH407_EMISS_POWERDOWN] = STIH407_PDN_0(1),
> +     [STIH407_NAND_POWERDOWN] = STIH407_PDN_0(0),
> +     [STIH407_USB3_POWERDOWN] = STIH407_PDN_1(6),
> +     [STIH407_USB2_PORT1_POWERDOWN] = STIH407_PDN_1(5),
> +     [STIH407_USB2_PORT0_POWERDOWN] = STIH407_PDN_1(4),
> +     [STIH407_PCIE1_POWERDOWN] = STIH407_PDN_1(3),
> +     [STIH407_PCIE0_POWERDOWN] = STIH407_PDN_1(2),
> +     [STIH407_SATA1_POWERDOWN] = STIH407_PDN_1(1),
> +     [STIH407_SATA0_POWERDOWN] = STIH407_PDN_1(0),
> +     [STIH407_ETH1_POWERDOWN] = STIH407_PDN_ETH(0, 2),
> +};

Being a little OCD, I _personally_ like to see the '='s lined up with
tabs, but some maintainers don't like that.  Philipp's call I guess.

[...]

> +static struct syscfg_reset_controller_data stih407_powerdown_controller = {
> +     .wait_for_ack = true,
> +     .nr_channels = ARRAY_SIZE(stih407_powerdowns),
> +     .channels = stih407_powerdowns,
> +};
> +
> +static struct syscfg_reset_controller_data stih407_softreset_controller = {
> +     .wait_for_ack = false,
> +     .active_low = true,
> +     .nr_channels = ARRAY_SIZE(stih407_softresets),
> +     .channels = stih407_softresets,
> +};
> +
> +static struct syscfg_reset_controller_data stih407_picophyreset_controller = 
> {
> +     .wait_for_ack = false,
> +     .nr_channels = ARRAY_SIZE(stih407_picophyresets),
> +     .channels = stih407_picophyresets,
> +};

I believe these should be const.

> +static struct of_device_id stih407_reset_match[] = {
> +     {.compatible = "st,stih407-powerdown",
> +      .data = &stih407_powerdown_controller,},
> +     {.compatible = "st,stih407-softreset",
> +      .data = &stih407_softreset_controller,},
> +     {.compatible = "st,stih407-picophyreset",
> +      .data = &stih407_picophyreset_controller,},

Formatting should be:

        {
                .compatible = "st,stih407-picophyreset",
                .data = &stih407_picophyreset_controller,
        },


> +     {},
> +};
> +
> +static struct platform_driver stih407_reset_driver = {
> +     .probe = syscfg_reset_probe,
> +     .driver = {
> +                .name = "reset-stih407",
> +                .owner = THIS_MODULE,

Remove this line, it's done for you as part of
platform_driver_register().

> +                .of_match_table = stih407_reset_match,
> +                },

Tabbing is borked.

> +};
> +
> +static int __init stih407_reset_init(void)
> +{
> +     return platform_driver_register(&stih407_reset_driver);
> +}
> +
> +arch_initcall(stih407_reset_init);
> diff --git a/include/dt-bindings/reset-controller/stih407-resets.h 
> b/include/dt-bindings/reset-controller/stih407-resets.h
> new file mode 100644
> index 0000000..85448a3
> --- /dev/null
> +++ b/include/dt-bindings/reset-controller/stih407-resets.h
> @@ -0,0 +1,60 @@
> +/*
> + * This header provides constants for the reset controller
> + * based peripheral powerdown requests on the STMicroelectronics
> + * STiH407 SoC.
> + */
> +#ifndef _DT_BINDINGS_RESET_CONTROLLER_STIH407
> +#define _DT_BINDINGS_RESET_CONTROLLER_STIH407
> +
> +/* Powerdown requests control 0 */
> +#define STIH407_EMISS_POWERDOWN              0
> +#define STIH407_NAND_POWERDOWN               1
> +
> +/* Synp GMAC PowerDown */
> +#define      STIH407_ETH1_POWERDOWN          2

For consistency, either add a line here, or remove the one 3 up.

> +/* Powerdown requests control 1 */
> +#define STIH407_USB3_POWERDOWN               3
> +#define STIH407_USB2_PORT1_POWERDOWN 4
> +#define STIH407_USB2_PORT0_POWERDOWN 5
> +#define STIH407_PCIE1_POWERDOWN              6
> +#define STIH407_PCIE0_POWERDOWN              7
> +#define STIH407_SATA1_POWERDOWN              8
> +#define STIH407_SATA0_POWERDOWN              9

Do these all line up in your editor? 

> +/* Reset defines */
> +#define      STIH407_ETH1_SOFTRESET          0
> +#define      STIH407_MMC1_SOFTRESET          1
> +#define      STIH407_PICOPHY_SOFTRESET       2
> +#define      STIH407_IRB_SOFTRESET           3
> +#define      STIH407_PCIE0_SOFTRESET         4
> +#define      STIH407_PCIE1_SOFTRESET         5
> +#define      STIH407_SATA0_SOFTRESET         6
> +#define      STIH407_SATA1_SOFTRESET         7
> +#define      STIH407_MIPHY0_SOFTRESET        8
> +#define      STIH407_MIPHY1_SOFTRESET        9
> +#define      STIH407_MIPHY2_SOFTRESET        10
> +#define      STIH407_SATA0_PWR_SOFTRESET     11
> +#define      STIH407_SATA1_PWR_SOFTRESET     12
> +#define      STIH407_DELTA_SOFTRESET         13
> +#define      STIH407_BLITTER_SOFTRESET       14
> +#define      STIH407_HDTVOUT_SOFTRESET       15
> +#define      STIH407_HDQVDP_SOFTRESET        16
> +#define      STIH407_VDP_AUX_SOFTRESET       17
> +#define      STIH407_COMPO_SOFTRESET         18
> +#define      STIH407_HDMI_TX_PHY_SOFTRESET   19
> +#define      STIH407_JPEG_DEC_SOFTRESET      20
> +#define      STIH407_VP8_DEC_SOFTRESET       21
> +#define      STIH407_GPU_SOFTRESET           22
> +#define      STIH407_HVA_SOFTRESET           23
> +#define      STIH407_ERAM_HVA_SOFTRESET      24
> +#define      STIH407_LPM_SOFTRESET           25
> +#define      STIH407_KEYSCAN_SOFTRESET       26
> +#define      STIH407_USB2_PORT0_SOFTRESET    27
> +#define      STIH407_USB2_PORT1_SOFTRESET    28

Again, you have tabs here and spaces elsewhere.

I suggest you use a single space everywhere after '#define' and then
line up the values on the right with tabs.

> +/* Picophy reset defines */
> +#define      STIH407_PICOPHY0_RESET  0
> +#define      STIH407_PICOPHY1_RESET  1
> +#define      STIH407_PICOPHY2_RESET  2
> +
> +#endif /* _DT_BINDINGS_RESET_CONTROLLER_STIH407 */

-- 
Lee Jones
Linaro STMicroelectronics Landing Team Lead
Linaro.org │ Open source software for ARM SoCs
Follow Linaro: Facebook | Twitter | Blog
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to