The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/contrib/device-tree/Bindings/gpio/spear_spics.txt

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 === ST Microelectronics SPEAr SPI CS Driver ===
    2 
    3 SPEAr platform provides a provision to control chipselects of ARM PL022 Prime
    4 Cell spi controller through its system registers, which otherwise remains under
    5 PL022 control. If chipselect remain under PL022 control then they would be
    6 released as soon as transfer is over and TxFIFO becomes empty. This is not
    7 desired by some of the device protocols above spi which expect (multiple)
    8 transfers without releasing their chipselects.
    9 
   10 Chipselects can be controlled by software by turning them as GPIOs. SPEAr
   11 provides another interface through system registers through which software can
   12 directly control each PL022 chipselect. Hence, it is natural for SPEAr to export
   13 the control of this interface as gpio.
   14 
   15 Required properties:
   16 
   17   * compatible: should be defined as "st,spear-spics-gpio"
   18   * reg: mentioning address range of spics controller
   19   * st-spics,peripcfg-reg: peripheral configuration register offset
   20   * st-spics,sw-enable-bit: bit offset to enable sw control
   21   * st-spics,cs-value-bit: bit offset to drive chipselect low or high
   22   * st-spics,cs-enable-mask: chip select number bit mask
   23   * st-spics,cs-enable-shift: chip select number program offset
   24   * gpio-controller: Marks the device node as gpio controller
   25   * #gpio-cells: should be 1 and will mention chip select number
   26 
   27 All the above bit offsets are within peripcfg register.
   28 
   29 Example:
   30 -------
   31 spics: spics@e0700000{
   32         compatible = "st,spear-spics-gpio";
   33         reg = <0xe0700000 0x1000>;
   34         st-spics,peripcfg-reg = <0x3b0>;
   35         st-spics,sw-enable-bit = <12>;
   36         st-spics,cs-value-bit = <11>;
   37         st-spics,cs-enable-mask = <3>;
   38         st-spics,cs-enable-shift = <8>;
   39         gpio-controller;
   40         #gpio-cells = <2>;
   41 };
   42 
   43 
   44 spi0: spi@e0100000 {
   45         num-cs = <3>;
   46         cs-gpios = <&gpio1 7 0>, <&spics 0>,
   47                    <&spics 1>;
   48         ...
   49 }

Cache object: ddb6f9c3bdebfaa5b4cc8156f76623ef


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.