summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/gpio/gpio-samsung.txt
blob: f1e5dfecf55def351aa4d63fe9a241ac6d495441 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
Samsung Exynos4 GPIO Controller

Required properties:
- compatible: Compatible property value should be "samsung,exynos4-gpio>".

- reg: Physical base address of the controller and length of memory mapped
  region.

- #gpio-cells: Should be 4. The syntax of the gpio specifier used by client nodes
  should be the following with values derived from the SoC user manual.
     <[phandle of the gpio controller node]
      [pin number within the gpio controller]
      [mux function]
      [flags and pull up/down]
      [drive strength]>

  Values for gpio specifier:
  - Pin number: is a value between 0 to 7.
  - Flags and Pull Up/Down: 0 - Pull Up/Down Disabled.
                            1 - Pull Down Enabled.
                            3 - Pull Up Enabled.
          Bit 16 (0x00010000) - Input is active low.
  - Drive Strength: 0 - 1x,
                    1 - 3x,
                    2 - 2x,
                    3 - 4x

- gpio-controller: Specifies that the node is a gpio controller.
- #address-cells: should be 1.
- #size-cells: should be 1.

Example:

	gpa0: gpio-controller@11400000 {
		#address-cells = <1>;
		#size-cells = <1>;
		compatible = "samsung,exynos4-gpio";
		reg = <0x11400000 0x20>;
		#gpio-cells = <4>;
		gpio-controller;
	};


Samsung S3C24XX GPIO Controller

Required properties:
- compatible: Compatible property value should be "samsung,s3c24xx-gpio".

- reg: Physical base address of the controller and length of memory mapped
  region.

- #gpio-cells: Should be 3. The syntax of the gpio specifier used by client nodes
  should be the following with values derived from the SoC user manual.
     <[phandle of the gpio controller node]
      [pin number within the gpio controller]
      [mux function]
      [flags and pull up/down]

  Values for gpio specifier:
  - Pin number: depending on the controller a number from 0 up to 15.
  - Mux function: Depending on the SoC and the gpio bank the gpio can be set
                  as input, output or a special function
  - Flags and Pull Up/Down: the values to use differ for the individual SoCs
                    example S3C2416/S3C2450:
                            0 - Pull Up/Down Disabled.
                            1 - Pull Down Enabled.
                            2 - Pull Up Enabled.
          Bit 16 (0x00010000) - Input is active low.
  Consult the user manual for the correct values of Mux and Pull Up/Down.

- gpio-controller: Specifies that the node is a gpio controller.
- #address-cells: should be 1.
- #size-cells: should be 1.

Example:

	gpa: gpio-controller@56000000 {
		#address-cells = <1>;
		#size-cells = <1>;
		compatible = "samsung,s3c24xx-gpio";
		reg = <0x56000000 0x10>;
		#gpio-cells = <3>;
		gpio-controller;
	};