Commit f12b457c authored by Geert Uytterhoeven's avatar Geert Uytterhoeven Committed by Miguel Ojeda
Browse files

dt-bindings: auxdisplay: ht16k33: Convert to json-schema 



Convert the Holtek HT16K33 LED controller with keyscan Device Tree
binding documentation to json-schema.

Move the file from display to auxdisplay.
Update the example:
  - Sort properties in order of documentation,
  - Group tuples using angle brackets to improve human readability and
    enable automatic validation.

Signed-off-by: default avatarGeert Uytterhoeven <geert@linux-m68k.org>
Acked-by: default avatarRobin van der Gracht <robin@protonic.nl>
Signed-off-by: default avatarMiguel Ojeda <ojeda@kernel.org>
parent f15cf04d

Documentation/devicetree/bindings/auxdisplay/holtek,ht16k33.yaml

0 → 100644
+77 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/auxdisplay/holtek,ht16k33.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Holtek HT16K33 RAM mapping 16*8 LED controller with keyscan



maintainers:

  - Robin van der Gracht <robin@protonic.nl>



allOf:

  - $ref: "/schemas/input/matrix-keymap.yaml#"



properties:

  compatible:

    const: holtek,ht16k33



  reg:

    maxItems: 1



  refresh-rate-hz:

    maxItems: 1

    description: Display update interval in Hertz



  interrupts:

    maxItems: 1



  debounce-delay-ms:

    maxItems: 1

    description: Debouncing interval time in milliseconds



  linux,keymap: true



  linux,no-autorepeat:

    description: Disable keyrepeat



  default-brightness-level:

    minimum: 1

    maximum: 16

    default: 16

    description: Initial brightness level



required:

  - compatible

  - reg

  - refresh-rate-hz



additionalProperties: false



examples:

  - |

    #include <dt-bindings/interrupt-controller/irq.h>

    #include <dt-bindings/input/input.h>

    i2c1 {

            #address-cells = <1>;

            #size-cells = <0>;



            ht16k33: ht16k33@70 {

                    compatible = "holtek,ht16k33";

                    reg = <0x70>;

                    refresh-rate-hz = <20>;

                    interrupt-parent = <&gpio4>;

                    interrupts = <5 (IRQ_TYPE_LEVEL_HIGH | IRQ_TYPE_EDGE_RISING)>;

                    debounce-delay-ms = <50>;

                    linux,keymap = <MATRIX_KEY(2, 0, KEY_F6)>,

                                   <MATRIX_KEY(3, 0, KEY_F8)>,

                                   <MATRIX_KEY(4, 0, KEY_F10)>,

                                   <MATRIX_KEY(5, 0, KEY_F4)>,

                                   <MATRIX_KEY(6, 0, KEY_F2)>,

                                   <MATRIX_KEY(2, 1, KEY_F5)>,

                                   <MATRIX_KEY(3, 1, KEY_F7)>,

                                   <MATRIX_KEY(4, 1, KEY_F9)>,

                                   <MATRIX_KEY(5, 1, KEY_F3)>,

                                   <MATRIX_KEY(6, 1, KEY_F1)>;

            };

      };

Documentation/devicetree/bindings/display/ht16k33.txt

deleted100644 → 0
+0 −43
Original line number Diff line number Diff line 
Holtek ht16k33 RAM mapping 16*8 LED controller driver with keyscan

-------------------------------------------------------------------------------



Required properties:

- compatible:		"holtek,ht16k33"

- reg:			I2C slave address of the chip.

- refresh-rate-hz:	Display update interval in HZ.



Optional properties:

- linux,no-autorepeat:	Disable keyrepeat.

- default-brightness-level: Initial brightness level [1-16] (default: 16).



- Keypad

 Supply the 'interrupts' property to enable the keyscan feature.

 - interrupts:		Interrupt specification for the key pressed interrupt.

 - debounce-delay-ms:	Debouncing interval time in milliseconds.

 - linux,keymap: 	The keymap for keys as described in the binding

			document (devicetree/bindings/input/matrix-keymap.txt).



Example:



&i2c1 {

	ht16k33: ht16k33@70 {

		compatible = "holtek,ht16k33";

		reg = <0x70>;

		refresh-rate-hz = <20>;

		debounce-delay-ms = <50>;

		interrupt-parent = <&gpio4>;

		interrupts = <5 (IRQ_TYPE_LEVEL_HIGH | IRQ_TYPE_EDGE_RISING)>;

		linux,keymap = <

			MATRIX_KEY(2, 0, KEY_F6)

			MATRIX_KEY(3, 0, KEY_F8)

			MATRIX_KEY(4, 0, KEY_F10)

			MATRIX_KEY(5, 0, KEY_F4)

			MATRIX_KEY(6, 0, KEY_F2)

			MATRIX_KEY(2, 1, KEY_F5)

			MATRIX_KEY(3, 1, KEY_F7)

			MATRIX_KEY(4, 1, KEY_F9)

			MATRIX_KEY(5, 1, KEY_F3)

			MATRIX_KEY(6, 1, KEY_F1)

		>;

	};

};

MAINTAINERS

+1 −1
Original line number Diff line number Diff line
@@ -8159,7 +8159,7 @@ F: net/hsr/ 
HT16K33 LED CONTROLLER DRIVER

M:	Robin van der Gracht <robin@protonic.nl>

S:	Maintained

F:	Documentation/devicetree/bindings/display/ht16k33.txt

F:	Documentation/devicetree/bindings/auxdisplay/holtek,ht16k33.yaml

F:	drivers/auxdisplay/ht16k33.c









HTCPEN TOUCHSCREEN DRIVER