Kernel-4.18.0-80.el8_keystone-navigator-qmss

  • Texas Instruments Keystone Navigator Queue Management SubSystem driver

The QMSS (Queue Manager Sub System) found on Keystone SOCs is one of
the main hardware sub system which forms the backbone of the Keystone
multi-core Navigator. QMSS consist of queue managers, packed-data structure
processors(PDSP), linking RAM, descriptor pools and infrastructure
Packet DMA.
The Queue Manager is a hardware module that is responsible for accelerating
management of the packet queues. Packets are queued/de-queued by writing or
reading descriptor address to a particular memory mapped location. The PDSPs
perform QMSS related functions like accumulation, QoS, or event management.
Linking RAM registers are used to link the descriptors which are stored in
descriptor RAM. Descriptor RAM is configurable as internal or external memory.
The QMSS driver manages the PDSP setups, linking RAM regions,
queue pool management (allocation, push, pop and notify) and descriptor
pool management.

Required properties:

  • compatible : Must be “ti,keystone-navigator-qmss”.
      : Must be "ti,66ak2g-navss-qm" for QMSS on K2G SoC.
    
  • clocks : phandle to the reference clock for this device.
  • queue-range : total range of queue numbers for the device.
  • linkram0 :
    for internal link ram, where size is the total
        link ram entries.
    
  • linkram1 :
    for external link ram, where size is the total
        external link ram entries. If the address is specified as "0"
        driver will allocate memory.
    
  • qmgrs : child node describing the individual queue managers on the
        SoC. On keystone 1 devices there should be only one node.
        On keystone 2 devices there can be more than 1 node.
    
    – managed-queues : the actual queues managed by each queue manager
            instance, specified as <"base queue #" "# of queues">.
    
    – reg : Address and size of the register set for the device.
            Register regions should be specified in the following
            order
            - Queue Peek region.
            - Queue status RAM.
            - Queue configuration region.
            - Descriptor memory setup region.
            - Queue Management/Queue Proxy region for queue Push.
            - Queue Management/Queue Proxy region for queue Pop.
    

For QMSS on K2G SoC, following QM reg indexes are used in that order
- Queue Peek region.
- Queue configuration region.
- Queue Management/Queue Proxy region for queue Push/Pop.

  • queue-pools : child node classifying the queue ranges into pools.
        Queue ranges are grouped into 3 type of pools:
        - qpend        : pool of qpend(interruptible) queues
        - general-purpose : pool of general queues, primarily used
                    as free descriptor queues or the
                    transmit DMA queues.
        - accumulator        : pool of queues on PDSP accumulator channel
        Each range can have the following properties:
    
    – qrange : number of queues to use per queue range, specified as
            <"base queue #" "# of queues">.
    
    – interrupts : Optional property to specify the interrupt mapping
            for interruptible queues. The driver additionally sets
            the interrupt affinity hint based on the cpu mask.
    
    – qalloc-by-id : Optional property to specify that the queues in this
            range can only be allocated by queue id.
    
    – accumulator : Accumulator channel specification. Any of the PDSPs in
            QMSS can be loaded with the accumulator firmware. The
            accumulator firmware’s job is to poll a select number of
            queues looking for descriptors that have been pushed
            into them. Descriptors are popped from the queue and
            placed in a buffer provided by the host. When the list
            becomes full or a programmed time period expires, the
            accumulator triggers an interrupt to the host to read
            the buffer for descriptor information. This firmware
            comes in 16, 32, and 48 channel builds. Each of these
            channels can be configured to monitor 32 contiguous
            queues.  Accumulator channel property is specified as:
            <pdsp-id, channel, entries, pacing mode, latency>
            pdsp-id     : QMSS PDSP running accumulator firmware
                  on which the channel has to be
                  configured
            channel     : Accumulator channel number
            entries     : Size of the accumulator descriptor list
            pacing mode : Interrupt pacing mode
                  0 : None, i.e interrupt on list full only
                  1 : Time delay since last interrupt
                  2 : Time delay since first new packet
                  3 : Time delay since last new packet
            latency     : time to delay the interrupt, specified
                  in microseconds.
    
    – multi-queue : Optional property to specify that the channel has to
            monitor up to 32 queues starting at the base queue #.
    
  • descriptor-regions : child node describing the memory regions for keystone
            navigator packet DMA descriptors. The memory for
            descriptors will be allocated by the driver.
    
    – id : region number in QMSS.
    – region-spec : specifies the number of descriptors in the
                region, specified as
                <"# of descriptors" "descriptor size">.
    
    – link-index : start index, i.e. index of the first
                descriptor in the region.
    

Optional properties:

  • dma-coherent : Present if DMA operations are coherent.
  • pdsps : child node describing the PDSP configuration.
    – firmware : firmware to be loaded on the PDSP.
    – id : the qmss pdsp that will run the firmware.
    – reg : Address and size of the register set for the PDSP.
            Register regions should be specified in the following
            order
            - PDSP internal RAM region.
            - PDSP control/status region registers.
            - QMSS interrupt distributor registers.
            - PDSP command interface region.
    

Example:

qmss: qmss@2a40000 {
compatible = “ti,keystone-qmss”;
dma-coherent;
#address-cells = <1>;
#size-cells = <1>;
clocks = <&chipclk13>;
ranges;
queue-range = <0 0x4000>;
linkram0 = <0x100000 0x8000>;
linkram1 = <0x0 0x10000>;

qmgrs {
    #address-cells = <1>;
    #size-cells = <1>;
    ranges;
    qmgr0 {
        managed-queues = <0 0x2000>;
        reg = <0x2a40000 0x20000>,
              <0x2a06000 0x400>,
              <0x2a02000 0x1000>,
              <0x2a03000 0x1000>,
              <0x23a80000 0x20000>,
              <0x2a80000 0x20000>;
    };

    qmgr1 {
        managed-queues = <0x2000 0x2000>;
        reg = <0x2a60000 0x20000>,
              <0x2a06400 0x400>,
              <0x2a04000 0x1000>,
              <0x2a05000 0x1000>,
              <0x23aa0000 0x20000>,
              <0x2aa0000 0x20000>;
    };
};
queue-pools {
    qpend {
        qpend-0 {
            qrange = <658 8>;
            interrupts =<0 40 0xf04 0 41 0xf04 0 42 0xf04
                     0 43 0xf04 0 44 0xf04 0 45 0xf04
                     0 46 0xf04 0 47 0xf04>;
        };
        qpend-1 {
            qrange = <8704 16>;
            interrupts = <0 48 0xf04 0 49 0xf04 0 50 0xf04
                      0 51 0xf04 0 52 0xf04 0 53 0xf04
                      0 54 0xf04 0 55 0xf04 0 56 0xf04
                      0 57 0xf04 0 58 0xf04 0 59 0xf04
                      0 60 0xf04 0 61 0xf04 0 62 0xf04
                      0 63 0xf04>;
            qalloc-by-id;
        };
        qpend-2 {
            qrange = <8720 16>;
            interrupts = <0 64 0xf04 0 65 0xf04 0 66 0xf04
                      0 59 0xf04 0 68 0xf04 0 69 0xf04
                      0 70 0xf04 0 71 0xf04 0 72 0xf04
                      0 73 0xf04 0 74 0xf04 0 75 0xf04
                      0 76 0xf04 0 77 0xf04 0 78 0xf04
                      0 79 0xf04>;
        };
    };
    general-purpose {
        gp-0 {
            qrange = <4000 64>;
        };
        netcp-tx {
            qrange = <640 9>;
            qalloc-by-id;
        };
    };
    accumulator {
        acc-0 {
            qrange = <128 32>;
            accumulator = <0 36 16 2 50>;
            interrupts = <0 215 0xf01>;
            multi-queue;
            qalloc-by-id;
        };
        acc-1 {
            qrange = <160 32>;
            accumulator = <0 37 16 2 50>;
            interrupts = <0 216 0xf01>;
            multi-queue;
        };
        acc-2 {
            qrange = <192 32>;
            accumulator = <0 38 16 2 50>;
            interrupts = <0 217 0xf01>;
            multi-queue;
        };
        acc-3 {
            qrange = <224 32>;
            accumulator = <0 39 16 2 50>;
            interrupts = <0 218 0xf01>;
            multi-queue;
        };
    };
};
descriptor-regions {
    #address-cells = <1>;
    #size-cells = <1>;
    ranges;
    region-12 {
        id = <12>;
        region-spec = <8192 128>; /* num_desc desc_size */
        link-index = <0x4000>;
    };
};
pdsps {
    #address-cells = <1>;
    #size-cells = <1>;
    ranges;
    pdsp0@2a10000 {
        reg = <0x2a10000 0x1000>,
              <0x2a0f000 0x100>,
              <0x2a0c000 0x3c8>,
              <0x2a20000 0x4000>;
        id = <0>;
    };
};

}; /* qmss */