From patchwork Wed Oct 14 14:17:13 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Murali Karicheri X-Patchwork-Id: 54953 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-wi0-f200.google.com (mail-wi0-f200.google.com [209.85.212.200]) by patches.linaro.org (Postfix) with ESMTPS id 9B95223012 for ; Wed, 14 Oct 2015 14:18:11 +0000 (UTC) Received: by wijq8 with SMTP id q8sf27480012wij.1 for ; Wed, 14 Oct 2015 07:18:10 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:from:to:subject:date:message-id :in-reply-to:references:mime-version:content-type:sender:precedence :list-id:x-original-sender:x-original-authentication-results :mailing-list:list-post:list-help:list-archive:list-unsubscribe; bh=gs3n7XPu0O6K2K9vZvNpVewnnPqbAv6p4wnmIHi4bP8=; b=hbY7pi/O4w0Fj80lKSHdmyF7tG23zwQofje84YB1IiIU7IRG3mHLbFroeSGCnWvvUK ptdgjX1iDCO+5IKivomdnfg9MDkBD1ft1Dm1323Ve8bPuTMf1cTZAQmu9V+/AHmApoqW kht/uoIAMgYjIFvgj5AuHZYpmXRTheF+jBtTHe1FL/5wA1VQz1gl3GZup1u3kV0e+6IU th3t/QIUxuhcezlwDXv5KrGCbsjEuhWwvSDJ2eKgE5eJ7jStGnqIb7d00d326RgBXFOf l2b7gSaMfNJ/hdKhkjTI+u2Tg9czvajOkqe1wuSxyoAnpwXlUuRk0zwx+rVK6dRE8ZCH a7kA== X-Gm-Message-State: ALoCoQnFXxw6nokJxhcEnZ2Pjuj0F//0hua+8BRoxNpIiMlsLdSPRYfm0Kjkv8yi5bHgkrbxeFpm X-Received: by 10.194.83.169 with SMTP id r9mr833912wjy.6.1444832290919; Wed, 14 Oct 2015 07:18:10 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.25.37.144 with SMTP id l138ls48112lfl.8.gmail; Wed, 14 Oct 2015 07:18:10 -0700 (PDT) X-Received: by 10.112.167.101 with SMTP id zn5mr1756588lbb.18.1444832290586; Wed, 14 Oct 2015 07:18:10 -0700 (PDT) Received: from mail-lf0-f54.google.com (mail-lf0-f54.google.com. [209.85.215.54]) by mx.google.com with ESMTPS id h10si5739842lfh.15.2015.10.14.07.18.10 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 14 Oct 2015 07:18:10 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.54 as permitted sender) client-ip=209.85.215.54; Received: by lfaz124 with SMTP id z124so12444949lfa.1 for ; Wed, 14 Oct 2015 07:18:10 -0700 (PDT) X-Received: by 10.25.28.73 with SMTP id c70mr940661lfc.76.1444832290384; Wed, 14 Oct 2015 07:18:10 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.59.35 with SMTP id w3csp39698lbq; Wed, 14 Oct 2015 07:18:09 -0700 (PDT) X-Received: by 10.66.252.2 with SMTP id zo2mr4013545pac.89.1444832289052; Wed, 14 Oct 2015 07:18:09 -0700 (PDT) Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id nu8si13632418pbb.87.2015.10.14.07.18.08; Wed, 14 Oct 2015 07:18:09 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753868AbbJNOSG (ORCPT + 30 others); Wed, 14 Oct 2015 10:18:06 -0400 Received: from comal.ext.ti.com ([198.47.26.152]:56477 "EHLO comal.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932513AbbJNOSD (ORCPT ); Wed, 14 Oct 2015 10:18:03 -0400 Received: from dflxv15.itg.ti.com ([128.247.5.124]) by comal.ext.ti.com (8.13.7/8.13.7) with ESMTP id t9EEHF3W002186; Wed, 14 Oct 2015 09:17:15 -0500 Received: from DLEE71.ent.ti.com (dlee71.ent.ti.com [157.170.170.114]) by dflxv15.itg.ti.com (8.14.3/8.13.8) with ESMTP id t9EEHFfr030100; Wed, 14 Oct 2015 09:17:15 -0500 Received: from dflp33.itg.ti.com (10.64.6.16) by DLEE71.ent.ti.com (157.170.170.114) with Microsoft SMTP Server id 14.3.224.2; Wed, 14 Oct 2015 09:17:15 -0500 Received: from ula0868495.am.dhcp.ti.com (ileax41-snat.itg.ti.com [10.172.224.153]) by dflp33.itg.ti.com (8.14.3/8.13.8) with ESMTP id t9EEHBsE007638; Wed, 14 Oct 2015 09:17:14 -0500 From: Murali Karicheri To: , , , , , , , , , , , , Subject: [PATCH v4 1/3] Documentation: dt: soc: Add description for knav qmss driver Date: Wed, 14 Oct 2015 10:17:13 -0400 Message-ID: <1444832235-15263-2-git-send-email-m-karicheri2@ti.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1444832235-15263-1-git-send-email-m-karicheri2@ti.com> References: <1444832235-15263-1-git-send-email-m-karicheri2@ti.com> MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: list List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: m-karicheri2@ti.com X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.54 as permitted sender) smtp.mailfrom=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Add a documentation for knav qmss driver. Signed-off-by: Murali Karicheri --- v4: added Arnd's Acked-by Documentation/arm/keystone/knav-qmss.txt | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 Documentation/arm/keystone/knav-qmss.txt diff --git a/Documentation/arm/keystone/knav-qmss.txt b/Documentation/arm/keystone/knav-qmss.txt new file mode 100644 index 0000000..79946d1 --- /dev/null +++ b/Documentation/arm/keystone/knav-qmss.txt @@ -0,0 +1,24 @@ +* Texas Instruments Keystone Navigator Queue Management SubSystem driver + +Driver source code path + drivers/soc/ti/knav_qmss.c + drivers/soc/ti/knav_qmss_acc.c + +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. + +knav qmss driver provides a set of APIs to drivers to open/close qmss queues, +allocate descriptor pools, map the descriptors, push/pop to queues etc. For +details of the available APIs, please refers to include/linux/soc/ti/knav_qmss.h