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/interrupt-controller/qcom,pdc.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 PDC interrupt controller
    2 
    3 Qualcomm Technologies Inc. SoCs based on the RPM Hardened architecture have a
    4 Power Domain Controller (PDC) that is on always-on domain. In addition to
    5 providing power control for the power domains, the hardware also has an
    6 interrupt controller that can be used to help detect edge low interrupts as
    7 well detect interrupts when the GIC is non-operational.
    8 
    9 GIC is parent interrupt controller at the highest level. Platform interrupt
   10 controller PDC is next in hierarchy, followed by others. Drivers requiring
   11 wakeup capabilities of their device interrupts routed through the PDC, must
   12 specify PDC as their interrupt controller and request the PDC port associated
   13 with the GIC interrupt. See example below.
   14 
   15 Properties:
   16 
   17 - compatible:
   18         Usage: required
   19         Value type: <string>
   20         Definition: Should contain "qcom,<soc>-pdc" and "qcom,pdc"
   21                     - "qcom,sc7180-pdc": For SC7180
   22                     - "qcom,sc7280-pdc": For SC7280
   23                     - "qcom,sdm845-pdc": For SDM845
   24                     - "qcom,sm6350-pdc": For SM6350
   25                     - "qcom,sm8150-pdc": For SM8150
   26                     - "qcom,sm8250-pdc": For SM8250
   27                     - "qcom,sm8350-pdc": For SM8350
   28 
   29 - reg:
   30         Usage: required
   31         Value type: <prop-encoded-array>
   32         Definition: Specifies the base physical address for PDC hardware.
   33 
   34 - interrupt-cells:
   35         Usage: required
   36         Value type: <u32>
   37         Definition: Specifies the number of cells needed to encode an interrupt
   38                     source.
   39                     Must be 2.
   40                     The first element of the tuple is the PDC pin for the
   41                     interrupt.
   42                     The second element is the trigger type.
   43 
   44 - interrupt-controller:
   45         Usage: required
   46         Value type: <bool>
   47         Definition: Identifies the node as an interrupt controller.
   48 
   49 - qcom,pdc-ranges:
   50         Usage: required
   51         Value type: <u32 array>
   52         Definition: Specifies the PDC pin offset and the number of PDC ports.
   53                     The tuples indicates the valid mapping of valid PDC ports
   54                     and their hwirq mapping.
   55                     The first element of the tuple is the starting PDC port.
   56                     The second element is the GIC hwirq number for the PDC port.
   57                     The third element is the number of interrupts in sequence.
   58 
   59 Example:
   60 
   61         pdc: interrupt-controller@b220000 {
   62                 compatible = "qcom,sdm845-pdc";
   63                 reg = <0xb220000 0x30000>;
   64                 qcom,pdc-ranges = <0 512 94>, <94 641 15>, <115 662 7>;
   65                 #interrupt-cells = <2>;
   66                 interrupt-parent = <&intc>;
   67                 interrupt-controller;
   68         };
   69 
   70 DT binding of a device that wants to use the GIC SPI 514 as a wakeup
   71 interrupt, must do -
   72 
   73         wake-device {
   74                 interrupts-extended = <&pdc 2 IRQ_TYPE_LEVEL_HIGH>;
   75         };
   76 
   77 In this case interrupt 514 would be mapped to port 2 on the PDC as defined by
   78 the qcom,pdc-ranges property.

Cache object: aa53179c18d160d22c653e3f48f68eb4


[ 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.