228 lines
8.6 KiB
Plaintext
228 lines
8.6 KiB
Plaintext
|
ImgTec TZ1090 pin controller
|
||
|
|
|
||
|
|
Required properties:
|
||
|
|
- compatible: "img,tz1090-pinctrl"
|
||
|
|
- reg: Should contain the register physical address and length of the pad
|
||
|
|
configuration registers (CR_PADS_* and CR_IF_CTL0).
|
||
|
|
|
||
|
|
Please refer to pinctrl-bindings.txt in this directory for details of the
|
||
|
|
common pinctrl bindings used by client devices, including the meaning of the
|
||
|
|
phrase "pin configuration node".
|
||
|
|
|
||
|
|
TZ1090's pin configuration nodes act as a container for an arbitrary number of
|
||
|
|
subnodes. Each of these subnodes represents some desired configuration for a
|
||
|
|
pin, a group, or a list of pins or groups. This configuration can include the
|
||
|
|
mux function to select on those pin(s)/group(s), and various pin configuration
|
||
|
|
parameters, such as pull-up, drive strength, etc.
|
||
|
|
|
||
|
|
The name of each subnode is not important; all subnodes should be enumerated
|
||
|
|
and processed purely based on their content.
|
||
|
|
|
||
|
|
Each subnode only affects those parameters that are explicitly listed. In
|
||
|
|
other words, a subnode that lists a mux function but no pin configuration
|
||
|
|
parameters implies no information about any pin configuration parameters.
|
||
|
|
Similarly, a pin subnode that describes a pullup parameter implies no
|
||
|
|
information about e.g. the mux function. For this reason, even seemingly boolean
|
||
|
|
values are actually tristates in this binding: unspecified, off, or on.
|
||
|
|
Unspecified is represented as an absent property, and off/on are represented as
|
||
|
|
integer values 0 and 1.
|
||
|
|
|
||
|
|
Required subnode-properties:
|
||
|
|
- tz1090,pins : An array of strings. Each string contains the name of a pin or
|
||
|
|
group. Valid values for these names are listed below.
|
||
|
|
|
||
|
|
Optional subnode-properties:
|
||
|
|
- tz1090,function: A string containing the name of the function to mux to the
|
||
|
|
pin or group. Valid values for function names are listed below, including
|
||
|
|
which pingroups can be muxed to them.
|
||
|
|
- supported generic pinconfig properties (for further details see
|
||
|
|
Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt):
|
||
|
|
- bias-disable
|
||
|
|
- bias-high-impedance
|
||
|
|
- bias-bus-hold
|
||
|
|
- bias-pull-up
|
||
|
|
- bias-pull-down
|
||
|
|
- input-schmitt-enable
|
||
|
|
- input-schmitt-disable
|
||
|
|
- drive-strength: Integer, control drive strength of pins in mA.
|
||
|
|
2: 2mA
|
||
|
|
4: 4mA
|
||
|
|
8: 8mA
|
||
|
|
12: 12mA
|
||
|
|
|
||
|
|
|
||
|
|
Note that many of these properties are only valid for certain specific pins
|
||
|
|
or groups. See the TZ1090 TRM for complete details regarding which groups
|
||
|
|
support which functionality. The Linux pinctrl driver may also be a useful
|
||
|
|
reference.
|
||
|
|
|
||
|
|
Valid values for pin and group names are:
|
||
|
|
|
||
|
|
gpio pins:
|
||
|
|
|
||
|
|
These all support bias-high-impediance, bias-pull-up, bias-pull-down, and
|
||
|
|
bias-bus-hold (which can also be provided to any of the groups below to set
|
||
|
|
it for all pins in that group).
|
||
|
|
|
||
|
|
They also all support the some form of muxing. Any pins which are contained
|
||
|
|
in one of the mux groups (see below) can be muxed only to the functions
|
||
|
|
supported by the mux group. All other pins can be muxed to the "perip"
|
||
|
|
function which enables them with their intended peripheral.
|
||
|
|
|
||
|
|
Different pins in the same mux group cannot be muxed to different functions,
|
||
|
|
however it is possible to mux only a subset of the pins in a mux group to a
|
||
|
|
particular function and leave the remaining pins unmuxed. This is useful if
|
||
|
|
the board connects certain pins in a group to other devices to be controlled
|
||
|
|
by GPIO, and you don't want the usual peripheral to have any control of the
|
||
|
|
pin.
|
||
|
|
|
||
|
|
ant_sel0, ant_sel1, gain0, gain1, gain2, gain3, gain4, gain5, gain6, gain7,
|
||
|
|
i2s_bclk_out, i2s_din, i2s_dout0, i2s_dout1, i2s_dout2, i2s_lrclk_out,
|
||
|
|
i2s_mclk, pa_on, pdm_a, pdm_b, pdm_c, pdm_d, pll_on, rx_hp, rx_on,
|
||
|
|
scb0_sclk, scb0_sdat, scb1_sclk, scb1_sdat, scb2_sclk, scb2_sdat, sdh_cd,
|
||
|
|
sdh_clk_in, sdh_wp, sdio_clk, sdio_cmd, sdio_d0, sdio_d1, sdio_d2, sdio_d3,
|
||
|
|
spi0_cs0, spi0_cs1, spi0_cs2, spi0_din, spi0_dout, spi0_mclk, spi1_cs0,
|
||
|
|
spi1_cs1, spi1_cs2, spi1_din, spi1_dout, spi1_mclk, tft_blank_ls, tft_blue0,
|
||
|
|
tft_blue1, tft_blue2, tft_blue3, tft_blue4, tft_blue5, tft_blue6, tft_blue7,
|
||
|
|
tft_green0, tft_green1, tft_green2, tft_green3, tft_green4, tft_green5,
|
||
|
|
tft_green6, tft_green7, tft_hsync_nr, tft_panelclk, tft_pwrsave, tft_red0,
|
||
|
|
tft_red1, tft_red2, tft_red3, tft_red4, tft_red5, tft_red6, tft_red7,
|
||
|
|
tft_vd12acb, tft_vdden_gd, tft_vsync_ns, tx_on, uart0_cts, uart0_rts,
|
||
|
|
uart0_rxd, uart0_txd, uart1_rxd, uart1_txd.
|
||
|
|
|
||
|
|
bias-high-impediance: supported.
|
||
|
|
bias-pull-up: supported.
|
||
|
|
bias-pull-down: supported.
|
||
|
|
bias-bus-hold: supported.
|
||
|
|
function: perip or those supported by pin's mux group.
|
||
|
|
|
||
|
|
other pins:
|
||
|
|
|
||
|
|
These other pins are part of various pin groups below, but can't be
|
||
|
|
controlled as GPIOs. They do however support bias-high-impediance,
|
||
|
|
bias-pull-up, bias-pull-down, and bias-bus-hold (which can also be provided
|
||
|
|
to any of the groups below to set it for all pins in that group).
|
||
|
|
|
||
|
|
clk_out0, clk_out1, tck, tdi, tdo, tms, trst.
|
||
|
|
|
||
|
|
bias-high-impediance: supported.
|
||
|
|
bias-pull-up: supported.
|
||
|
|
bias-pull-down: supported.
|
||
|
|
bias-bus-hold: supported.
|
||
|
|
|
||
|
|
mux groups:
|
||
|
|
|
||
|
|
These all support function, and some support drive configs.
|
||
|
|
|
||
|
|
afe
|
||
|
|
pins: tx_on, rx_on, pll_on, pa_on, rx_hp, ant_sel0,
|
||
|
|
ant_sel1, gain0, gain1, gain2, gain3, gain4,
|
||
|
|
gain5, gain6, gain7.
|
||
|
|
function: afe, ts_out_0.
|
||
|
|
input-schmitt-enable: supported.
|
||
|
|
input-schmitt-disable: supported.
|
||
|
|
drive-strength: supported.
|
||
|
|
pdm_d
|
||
|
|
pins: pdm_d.
|
||
|
|
function: pdm_dac, usb_vbus.
|
||
|
|
sdh
|
||
|
|
pins: sdh_cd, sdh_wp, sdh_clk_in.
|
||
|
|
function: sdh, sdio.
|
||
|
|
sdio
|
||
|
|
pins: sdio_clk, sdio_cmd, sdio_d0, sdio_d1, sdio_d2,
|
||
|
|
sdio_d3.
|
||
|
|
function: sdio, sdh.
|
||
|
|
spi1_cs2
|
||
|
|
pins: spi1_cs2.
|
||
|
|
function: spi1_cs2, usb_vbus.
|
||
|
|
tft
|
||
|
|
pins: tft_red0, tft_red1, tft_red2, tft_red3,
|
||
|
|
tft_red4, tft_red5, tft_red6, tft_red7,
|
||
|
|
tft_green0, tft_green1, tft_green2, tft_green3,
|
||
|
|
tft_green4, tft_green5, tft_green6, tft_green7,
|
||
|
|
tft_blue0, tft_blue1, tft_blue2, tft_blue3,
|
||
|
|
tft_blue4, tft_blue5, tft_blue6, tft_blue7,
|
||
|
|
tft_vdden_gd, tft_panelclk, tft_blank_ls,
|
||
|
|
tft_vsync_ns, tft_hsync_nr, tft_vd12acb,
|
||
|
|
tft_pwrsave.
|
||
|
|
function: tft, ext_dac, not_iqadc_stb, iqdac_stb, ts_out_1,
|
||
|
|
lcd_trace, phy_ringosc.
|
||
|
|
input-schmitt-enable: supported.
|
||
|
|
input-schmitt-disable: supported.
|
||
|
|
drive-strength: supported.
|
||
|
|
|
||
|
|
drive groups:
|
||
|
|
|
||
|
|
These all support input-schmitt-enable, input-schmitt-disable,
|
||
|
|
and drive-strength.
|
||
|
|
|
||
|
|
jtag
|
||
|
|
pins: tck, trst, tdi, tdo, tms.
|
||
|
|
scb1
|
||
|
|
pins: scb1_sdat, scb1_sclk.
|
||
|
|
scb2
|
||
|
|
pins: scb2_sdat, scb2_sclk.
|
||
|
|
spi0
|
||
|
|
pins: spi0_mclk, spi0_cs0, spi0_cs1, spi0_cs2, spi0_dout, spi0_din.
|
||
|
|
spi1
|
||
|
|
pins: spi1_mclk, spi1_cs0, spi1_cs1, spi1_cs2, spi1_dout, spi1_din.
|
||
|
|
uart
|
||
|
|
pins: uart0_txd, uart0_rxd, uart0_rts, uart0_cts,
|
||
|
|
uart1_txd, uart1_rxd.
|
||
|
|
drive_i2s
|
||
|
|
pins: clk_out1, i2s_din, i2s_dout0, i2s_dout1, i2s_dout2,
|
||
|
|
i2s_lrclk_out, i2s_bclk_out, i2s_mclk.
|
||
|
|
drive_pdm
|
||
|
|
pins: clk_out0, pdm_b, pdm_a.
|
||
|
|
drive_scb0
|
||
|
|
pins: scb0_sclk, scb0_sdat, pdm_d, pdm_c.
|
||
|
|
drive_sdio
|
||
|
|
pins: sdio_clk, sdio_cmd, sdio_d0, sdio_d1, sdio_d2, sdio_d3,
|
||
|
|
sdh_wp, sdh_cd, sdh_clk_in.
|
||
|
|
|
||
|
|
convenience groups:
|
||
|
|
|
||
|
|
These are just convenient groupings of pins and don't support any drive
|
||
|
|
configs.
|
||
|
|
|
||
|
|
uart0
|
||
|
|
pins: uart0_cts, uart0_rts, uart0_rxd, uart0_txd.
|
||
|
|
uart1
|
||
|
|
pins: uart1_rxd, uart1_txd.
|
||
|
|
scb0
|
||
|
|
pins: scb0_sclk, scb0_sdat.
|
||
|
|
i2s
|
||
|
|
pins: i2s_bclk_out, i2s_din, i2s_dout0, i2s_dout1, i2s_dout2,
|
||
|
|
i2s_lrclk_out, i2s_mclk.
|
||
|
|
|
||
|
|
Example:
|
||
|
|
|
||
|
|
pinctrl: pinctrl@2005800 {
|
||
|
|
#gpio-range-cells = <3>;
|
||
|
|
compatible = "img,tz1090-pinctrl";
|
||
|
|
reg = <0x02005800 0xe4>;
|
||
|
|
};
|
||
|
|
|
||
|
|
Example board file extract:
|
||
|
|
|
||
|
|
&pinctrl {
|
||
|
|
uart0_default: uart0 {
|
||
|
|
uart0_cfg {
|
||
|
|
tz1090,pins = "uart0_rxd",
|
||
|
|
"uart0_txd";
|
||
|
|
tz1090,function = "perip";
|
||
|
|
};
|
||
|
|
};
|
||
|
|
tft_default: tft {
|
||
|
|
tft_cfg {
|
||
|
|
tz1090,pins = "tft";
|
||
|
|
tz1090,function = "tft";
|
||
|
|
};
|
||
|
|
};
|
||
|
|
};
|
||
|
|
|
||
|
|
uart@2004b00 {
|
||
|
|
pinctrl-names = "default";
|
||
|
|
pinctrl-0 = <&uart0_default>;
|
||
|
|
};
|