Aspeed AST2400, AST2500 and AST2600 JTAG controller driver.
Signed-off-by: Oleksandr Shamray <[email protected]>
Signed-off-by: Jiri Pirko <[email protected]>
Signed-off-by: Ernesto Corona <[email protected]>
Signed-off-by: Omar Castro <[email protected]>
Acked-by: Rob Herring <[email protected]>
Cc: Jonathan Corbet <[email protected]>
Cc: Mauro Carvalho Chehab <[email protected]>
Cc: Alexandre Belloni <[email protected]>
Cc: "Theodore Ts'o" <[email protected]>
Cc: Arnd Bergmann <[email protected]>
Cc: Eric Biggers <[email protected]>
Cc: Mark Rutland <[email protected]>
Cc: Joel Stanley <[email protected]>
Cc: Andrew Jeffery <[email protected]>
Cc: Steven Filary <[email protected]>
Cc: Vadim Pasternak <[email protected]>
Cc: Amithash Prasad <[email protected]>
Cc: Patrick Williams <[email protected]>
Cc: Luke Chen <[email protected]>
Cc: Billy Tsai <[email protected]>
Cc: Rgrs <[email protected]>
---
v29->v30
Comments pointed by Steven Filary <[email protected]>
- Add Suport for 26xx series
v28->v29
Comments pointed by Ernesto Corona <[email protected]>
- Change documentation to the new dt-bindings yaml format.
v27->v28
v26->v27
v25->v26
v24->v25
v23->v24
v22->v23
v21->v22
v20->v21
v19->v20
v18->v19
v17->v18
v16->v17
v15->v16
Comments pointed by Joel Stanley <[email protected]>
- change clocks = <&clk_apb> to proper clocks = <&syscon ASPEED_CLK_APB>
- add reset descriptions in bindings file
v14->v15
v13->v14
v12->v13
v11->v12
v10->v11
v9->v10
v8->v9
v7->v8
Comments pointed by pointed by Joel Stanley <[email protected]>
- Change compatible string to ast2400 and ast2000
V6->v7
Comments pointed by Tobias Klauser <[email protected]>
- Fix spell "Doccumentation" -> "Documentation"
v5->v6
Comments pointed by Tobias Klauser <[email protected]>
- Small nit: s/documentation/Documentation/
v4->v5
V3->v4
Comments pointed by Rob Herring <[email protected]>
- delete unnecessary "status" and "reg-shift" descriptions in
bindings file
v2->v3
Comments pointed by Rob Herring <[email protected]>
- split Aspeed jtag driver and binding to separate patches
- delete unnecessary "status" and "reg-shift" descriptions in
bindings file
---
.../devicetree/bindings/jtag/aspeed-jtag.yaml | 85 +++++++++++++++++++
1 file changed, 85 insertions(+)
create mode 100644 Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
diff --git a/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml b/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
new file mode 100644
index 000000000000..1a412e83b81b
--- /dev/null
+++ b/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
@@ -0,0 +1,85 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/jtag/aspeed-jtag.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Aspeed JTAG driver for ast2400, ast2500 and ast2600 SoC
+
+description:
+ Driver adds support of Aspeed 24/25/2600 series SOC JTAG controller.
+ Driver implements the following jtag ops
+ freq_get
+ freq_set
+ status_get
+ status_set
+ xfer
+ mode_set
+ bitbang
+ enable
+ disable
+
+ It has been tested on Mellanox system with BMC equipped with
+ Aspeed 2520 SoC for programming CPLD devices.
+
+ It has also been tested on Intel system using Aspeed 25xx SoC
+ for JTAG communication.
+
+ Tested on Intel system using Aspeed 26xx SoC for JTAG communication.
+
+maintainers:
+ - Oleksandr Shamray <[email protected]>
+ - Jiri Pirko <[email protected]>
+ - Ernesto Corona<[email protected]>
+
+properties:
+ compatible:
+ oneOf:
+ - items:
+ - enum:
+ - aspeed,ast2400-jtag
+ - aspeed,ast2500-jtag
+ - aspeed,ast2600-jtag
+
+
+ reg:
+ items:
+ - description: JTAG Master controller register range
+
+ interrupts:
+ maxItems: 1
+
+ clocks:
+ maxItems: 1
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - clocks
+
+examples:
+ - |
+ #include <dt-bindings/clock/aspeed-clock.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ jtag: jtag@1e6e4000 {
+ compatible = "aspeed,ast2500-jtag";
+ reg = <0x1e6e4000 0x1c>;
+ clocks = <&syscon ASPEED_CLK_APB>;
+ resets = <&syscon ASPEED_RESET_JTAG_MASTER>;
+ interrupts = <43>;
+ };
+ - |
+ #include <dt-bindings/clock/aspeed-clock.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ jtag1: jtag@1e6e4100 {
+ compatible = "aspeed,ast2600-jtag";
+ reg = <0x1e6e4100 0x40>;
+ clocks = <&syscon ASPEED_CLK_APB1>;
+ resets = <&syscon ASPEED_RESET_JTAG_MASTER2>;
+ interrupts = <GIC_SPI 53 IRQ_TYPE_LEVEL_HIGH>;
+ };
+
+...
--
2.25.1
Hey,
On Tue, Jan 30, 2024 at 11:30:10PM +0000, Corona, Ernesto wrote:
> Aspeed AST2400, AST2500 and AST2600 JTAG controller driver.
>
> Signed-off-by: Oleksandr Shamray <[email protected]>
> Signed-off-by: Jiri Pirko <[email protected]>
> Signed-off-by: Ernesto Corona <[email protected]>
> Signed-off-by: Omar Castro <[email protected]>
> Acked-by: Rob Herring <[email protected]>
Where did this ack come from? The conversion to a yaml binding was in
v29 (according to your changelog) but I don't see the ack from Rob
there.
I think a conversion from (text?) to yaml would be sufficient of a
change to drop his tag.
> v28->v29
> - Change documentation to the new dt-bindings yaml format.
> .../devicetree/bindings/jtag/aspeed-jtag.yaml | 85 +++++++++++++++++++
> 1 file changed, 85 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
>
> diff --git a/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml b/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
> new file mode 100644
> index 000000000000..1a412e83b81b
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
Filename matching a compatible please.
> @@ -0,0 +1,85 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/jtag/aspeed-jtag.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Aspeed JTAG driver for ast2400, ast2500 and ast2600 SoC
> +
> +description:
> + Driver adds support of Aspeed 24/25/2600 series SOC JTAG controller.
> + Driver implements the following jtag ops
> + freq_get
> + freq_set
> + status_get
> + status_set
> + xfer
> + mode_set
> + bitbang
> + enable
> + disable
None of the driver stuff, nor where you tested this, is relevant to the
description in the binding nor the title of the binding. Just describe
the hardware.
> +
> + It has been tested on Mellanox system with BMC equipped with
> + Aspeed 2520 SoC for programming CPLD devices.
> +
> + It has also been tested on Intel system using Aspeed 25xx SoC
> + for JTAG communication.
> +
> + Tested on Intel system using Aspeed 26xx SoC for JTAG communication.
> +
> +maintainers:
> + - Oleksandr Shamray <[email protected]>
> + - Jiri Pirko <[email protected]>
> + - Ernesto Corona<[email protected]>
> +
> +properties:
> + compatible:
> + oneOf:
> + - items:
> + - enum:
> + - aspeed,ast2400-jtag
> + - aspeed,ast2500-jtag
> + - aspeed,ast2600-jtag
You don't need the "oneOf" or "items" here, it's enough to do:
compatible:
enum:
- allwinner,sun5i-a13-mbus
- allwinner,sun8i-a33-mbus
> +
> +
> + reg:
> + items:
> + - description: JTAG Master controller register range
> +
> + interrupts:
> + maxItems: 1
> +
> + clocks:
> + maxItems: 1
> +
> +required:
> + - compatible
> + - reg
> + - interrupts
> + - clocks
> +
> +examples:
> + - |
> + #include <dt-bindings/clock/aspeed-clock.h>
> + #include <dt-bindings/interrupt-controller/irq.h>
> +
> + jtag: jtag@1e6e4000 {
The labels for both of these examples are also not needed
as they're not used anywhere.
Thanks,
Conor.
> + compatible = "aspeed,ast2500-jtag";
> + reg = <0x1e6e4000 0x1c>;
> + clocks = <&syscon ASPEED_CLK_APB>;
> + resets = <&syscon ASPEED_RESET_JTAG_MASTER>;
> + interrupts = <43>;
> + };
> + - |
> + #include <dt-bindings/clock/aspeed-clock.h>
> + #include <dt-bindings/interrupt-controller/irq.h>
> +
> + jtag1: jtag@1e6e4100 {
> + compatible = "aspeed,ast2600-jtag";
> + reg = <0x1e6e4100 0x40>;
> + clocks = <&syscon ASPEED_CLK_APB1>;
> + resets = <&syscon ASPEED_RESET_JTAG_MASTER2>;
> + interrupts = <GIC_SPI 53 IRQ_TYPE_LEVEL_HIGH>;
> + };
> +
> +...
> --
> 2.25.1
On 31/01/2024 00:30, Corona, Ernesto wrote:
> Aspeed AST2400, AST2500 and AST2600 JTAG controller driver.
>
> Signed-off-by: Oleksandr Shamray <[email protected]>
> Signed-off-by: Jiri Pirko <[email protected]>
> Signed-off-by: Ernesto Corona <[email protected]>
> Signed-off-by: Omar Castro <[email protected]>
> Acked-by: Rob Herring <[email protected]>
1. There are so many wrong things with this submission that you should
drop the tag.
Please provide lore link where you received this tag. Quick look at lore
suggests you faked it.
2. Please use subject prefixes matching the subsystem. You can get them
for example with `git log --oneline -- DIRECTORY_OR_FILE` on the
directory your patch is touching.
3. Please use scripts/get_maintainers.pl to get a list of necessary
people and lists to CC. It might happen, that command when run on an
older kernel, gives you outdated entries. Therefore please be sure you
base your patches on recent Linux kernel.
Tools like b4 or scripts_getmaintainer.pl provide you proper list of
people, so fix your workflow. Tools might also fail if you work on some
ancient tree (don't, use mainline), work on fork of kernel (don't, use
mainline) or you ignore some maintainers (really don't). Just use b4 and
everything should be fine, although remember about `b4 prep
--auto-to-cc` if you added new patches to the patchset.
You missed at least devicetree list (maybe more), so this won't be
tested by automated tooling. Performing review on untested code might be
a waste of time, thus I will skip this patch entirely till you follow
the process allowing the patch to be tested.
Please kindly resend and include all necessary To/Cc entries.
> Cc: Jonathan Corbet <[email protected]>
> Cc: Mauro Carvalho Chehab <[email protected]>
> Cc: Alexandre Belloni <[email protected]>
> Cc: "Theodore Ts'o" <[email protected]>
> Cc: Arnd Bergmann <[email protected]>
> Cc: Eric Biggers <[email protected]>
> Cc: Mark Rutland <[email protected]>
> Cc: Joel Stanley <[email protected]>
> Cc: Andrew Jeffery <[email protected]>
> Cc: Steven Filary <[email protected]>
> Cc: Vadim Pasternak <[email protected]>
> Cc: Amithash Prasad <[email protected]>
> Cc: Patrick Williams <[email protected]>
> Cc: Luke Chen <[email protected]>
> Cc: Billy Tsai <[email protected]>
> Cc: Rgrs <[email protected]>
> ---
> v29->v30
> Comments pointed by Steven Filary <[email protected]>
> - Add Suport for 26xx series
>
> v28->v29
> Comments pointed by Ernesto Corona <[email protected]>
> - Change documentation to the new dt-bindings yaml format.
>
> v27->v28
> v26->v27
> v25->v26
> v24->v25
> v23->v24
> v22->v23
> v21->v22
> v20->v21
> v19->v20
> v18->v19
>
> v17->v18
> v16->v17
> v15->v16
> Comments pointed by Joel Stanley <[email protected]>
> - change clocks = <&clk_apb> to proper clocks = <&syscon ASPEED_CLK_APB>
> - add reset descriptions in bindings file
>
> v14->v15
> v13->v14
> v12->v13
> v11->v12
> v10->v11
> v9->v10
> v8->v9
> v7->v8
> Comments pointed by pointed by Joel Stanley <[email protected]>
> - Change compatible string to ast2400 and ast2000
>
> V6->v7
> Comments pointed by Tobias Klauser <[email protected]>
> - Fix spell "Doccumentation" -> "Documentation"
>
> v5->v6
> Comments pointed by Tobias Klauser <[email protected]>
> - Small nit: s/documentation/Documentation/
>
> v4->v5
>
> V3->v4
> Comments pointed by Rob Herring <[email protected]>
> - delete unnecessary "status" and "reg-shift" descriptions in
> bindings file
>
> v2->v3
> Comments pointed by Rob Herring <[email protected]>
> - split Aspeed jtag driver and binding to separate patches
> - delete unnecessary "status" and "reg-shift" descriptions in
> bindings file
> ---
> .../devicetree/bindings/jtag/aspeed-jtag.yaml | 85 +++++++++++++++++++
> 1 file changed, 85 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
>
> diff --git a/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml b/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
> new file mode 100644
> index 000000000000..1a412e83b81b
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/jtag/aspeed-jtag.yaml
Use filename matching compatibles, so aspeed,jtag.yaml
> @@ -0,0 +1,85 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/jtag/aspeed-jtag.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Aspeed JTAG driver for ast2400, ast2500 and ast2600 SoC
> +
> +description:
> + Driver adds support of Aspeed 24/25/2600 series SOC JTAG controller.
> + Driver implements the following jtag ops
> + freq_get
> + freq_set
> + status_get
> + status_set
> + xfer
> + mode_set
> + bitbang
> + enable
> + disable
> +
> + It has been tested on Mellanox system with BMC equipped with
> + Aspeed 2520 SoC for programming CPLD devices.
> +
> + It has also been tested on Intel system using Aspeed 25xx SoC
> + for JTAG communication.
> +
> + Tested on Intel system using Aspeed 26xx SoC for JTAG communication.
> +
> +maintainers:
> + - Oleksandr Shamray <[email protected]>
> + - Jiri Pirko <[email protected]>
> + - Ernesto Corona<[email protected]>
> +
> +properties:
> + compatible:
> + oneOf:
Drop
> + - items:
Drop
> + - enum:
> + - aspeed,ast2400-jtag
> + - aspeed,ast2500-jtag
> + - aspeed,ast2600-jtag
> +
> +
Just one blank line. Since this was not tested, I will skip review of
the rest.
Best regards,
Krzysztof