xref: /freebsd/sys/contrib/device-tree/Bindings/display/ssd1307fb.txt (revision 9f44a47fd07924afc035991af15d84e6585dea4f)
1* Solomon SSD1307 Framebuffer Driver
2
3Required properties:
4  - compatible: Should be "solomon,<chip>fb-<bus>". The only supported bus for
5    now is i2c, and the supported chips are ssd1305, ssd1306, ssd1307 and
6    ssd1309.
7  - reg: Should contain address of the controller on the I2C bus. Most likely
8         0x3c or 0x3d
9  - pwm: Should contain the pwm to use according to the OF device tree PWM
10         specification [0]. Only required for the ssd1307.
11  - solomon,height: Height in pixel of the screen driven by the controller
12  - solomon,width: Width in pixel of the screen driven by the controller
13  - solomon,page-offset: Offset of pages (band of 8 pixels) that the screen is
14    mapped to.
15
16Optional properties:
17  - reset-gpios: The GPIO used to reset the OLED display, if available. See
18                 Documentation/devicetree/bindings/gpio/gpio.txt for details.
19  - vbat-supply: The supply for VBAT
20  - solomon,segment-no-remap: Display needs normal (non-inverted) data column
21                              to segment mapping
22  - solomon,col-offset: Offset of columns (COL/SEG) that the screen is mapped to.
23  - solomon,com-seq: Display uses sequential COM pin configuration
24  - solomon,com-lrremap: Display uses left-right COM pin remap
25  - solomon,com-invdir: Display uses inverted COM pin scan direction
26  - solomon,com-offset: Number of the COM pin wired to the first display line
27  - solomon,prechargep1: Length of deselect period (phase 1) in clock cycles.
28  - solomon,prechargep2: Length of precharge period (phase 2) in clock cycles.
29                         This needs to be the higher, the higher the capacitance
30                         of the OLED's pixels is
31  - solomon,dclk-div: Clock divisor 1 to 16
32  - solomon,dclk-frq: Clock frequency 0 to 15, higher value means higher
33                      frequency
34  - solomon,lookup-table: 8 bit value array of current drive pulse widths for
35                          BANK0, and colors A, B, and C. Each value in range
36                          of 31 to 63 for pulse widths of 32 to 64. Color D
37                          is always width 64.
38  - solomon,area-color-enable: Display uses color mode
39  - solomon,low-power. Display runs in low power mode
40
41[0]: Documentation/devicetree/bindings/pwm/pwm.txt
42
43Examples:
44ssd1307: oled@3c {
45        compatible = "solomon,ssd1307fb-i2c";
46        reg = <0x3c>;
47        pwms = <&pwm 4 3000>;
48        reset-gpios = <&gpio2 7>;
49};
50
51ssd1306: oled@3c {
52        compatible = "solomon,ssd1306fb-i2c";
53        reg = <0x3c>;
54        pwms = <&pwm 4 3000>;
55        reset-gpios = <&gpio2 7>;
56        solomon,com-lrremap;
57        solomon,com-invdir;
58        solomon,com-offset = <32>;
59        solomon,lookup-table = /bits/ 8 <0x3f 0x3f 0x3f 0x3f>;
60};
61