From patchwork Sun Feb 14 13:31:21 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 61920 Delivered-To: patch@linaro.org Received: by 10.112.43.199 with SMTP id y7csp560307lbl; Sun, 14 Feb 2016 05:31:53 -0800 (PST) X-Received: by 10.66.102.70 with SMTP id fm6mr16136019pab.98.1455456713356; Sun, 14 Feb 2016 05:31:53 -0800 (PST) Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id rf10si35599471pab.213.2016.02.14.05.31.53; Sun, 14 Feb 2016 05:31:53 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-input-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-input-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-input-owner@vger.kernel.org; dkim=neutral (body hash did not verify) header.i=@linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751440AbcBNNbd (ORCPT + 1 other); Sun, 14 Feb 2016 08:31:33 -0500 Received: from mail-lb0-f169.google.com ([209.85.217.169]:33612 "EHLO mail-lb0-f169.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751315AbcBNNbc (ORCPT ); Sun, 14 Feb 2016 08:31:32 -0500 Received: by mail-lb0-f169.google.com with SMTP id x4so66398333lbm.0 for ; Sun, 14 Feb 2016 05:31:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=BW+auhPgWLb9qzbDZ/B5q6zYWc6mRxg/1jswQ9KSMWs=; b=L9u84avmwvwxWr3brO+/iDxKQI+1wexgi/XrjyOLgGysMa0Rw5eU8ClEKL4UlGbbdS BdnjKF27rHQa9X3wpZ7zkzK1PoFoFTHoFXeJGhOdDjlKpz9iwimnYV6+/Zr+vZynid8J N1h0urAthkxOoBsObH1MNQKRoRnRkuhgOcWyQ= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=BW+auhPgWLb9qzbDZ/B5q6zYWc6mRxg/1jswQ9KSMWs=; b=LoNMheiLA86SBU7J+u0iozoUarxjDc/STeUy1L2yKzJQQe17OuwzoZutYtAte0rtZu by0KyaA5C3NcENi60q2IG/D7gfo3BT9bsxofHUl8yDl5P2/jyMlMv8lSUY5fDurEPo6V 8ojFB2MVKnD7CJCY4TtY8iJ4ajhoXGi5rvjq+LPd9yWt66gmIZK5sJ8stgF76rWua9DM 16UWX4QaNVyJE45/sLleK3G8IatnmH/btyXtVD/EfRkNRffLHIcy1gxZZawUfqtIdBBz tg+e7nhLtbfiKa4PFEpqWDnhR1/Y5GWirt4lKB8rYSBcnpxSWWnK/XWvXAbcbQ8X9KZE WT/g== X-Gm-Message-State: AG10YOR8bh8YwKA+hYuvXwmx34kXs1jOPCuyidNNUxrUDGJZJlyHKnDQ+nR2G/19ZwdhGO2o X-Received: by 10.112.139.164 with SMTP id qz4mr4465095lbb.41.1455456691226; Sun, 14 Feb 2016 05:31:31 -0800 (PST) Received: from localhost.localdomain.localdomain (c-3d95db54.01-192-6c756e10.cust.bredbandsbolaget.se. [84.219.149.61]) by smtp.gmail.com with ESMTPSA id d131sm3064179lfg.27.2016.02.14.05.31.29 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 14 Feb 2016 05:31:30 -0800 (PST) From: Linus Walleij To: Dmitry Torokhov , linux-input@vger.kernel.org Cc: Linus Walleij Subject: [PATCH] input: touchscreen: stmpe: kerneldoc Date: Sun, 14 Feb 2016 14:31:21 +0100 Message-Id: <1455456681-18846-1-git-send-email-linus.walleij@linaro.org> X-Mailer: git-send-email 2.4.3 Sender: linux-input-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-input@vger.kernel.org commit e4b88e19897f1039fd83f1630517becafc0dd163 "Input: stmpe-ts - enforce device tree only mode" removed platform data but accidentally stripped away useful kerneldoc, so reintroduce it. Signed-off-by: Linus Walleij --- drivers/input/touchscreen/stmpe-ts.c | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) -- 2.4.3 -- To unsubscribe from this list: send the line "unsubscribe linux-input" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/drivers/input/touchscreen/stmpe-ts.c b/drivers/input/touchscreen/stmpe-ts.c index e414d43e5159..2a78e27b4495 100644 --- a/drivers/input/touchscreen/stmpe-ts.c +++ b/drivers/input/touchscreen/stmpe-ts.c @@ -63,6 +63,37 @@ #define STMPE_TS_NAME "stmpe-ts" #define XY_MASK 0xfff +/** + * struct stmpe_touch - stmpe811 touch screen controller state + * @stmpe: pointer back to STMPE MFD container + * @idev: registered input device + * @work: a work item used to scan the device + * @dev: a pointer back to the MFD cell struct device* + * @sample_time: ADC converstion time in number of clock. + * (0 -> 36 clocks, 1 -> 44 clocks, 2 -> 56 clocks, 3 -> 64 clocks, + * 4 -> 80 clocks, 5 -> 96 clocks, 6 -> 144 clocks), + * recommended is 4. + * @mod_12b: ADC Bit mode (0 -> 10bit ADC, 1 -> 12bit ADC) + * @ref_sel: ADC reference source + * (0 -> internal reference, 1 -> external reference) + * @adc_freq: ADC Clock speed + * (0 -> 1.625 MHz, 1 -> 3.25 MHz, 2 || 3 -> 6.5 MHz) + * @ave_ctrl: Sample average control + * (0 -> 1 sample, 1 -> 2 samples, 2 -> 4 samples, 3 -> 8 samples) + * @touch_det_delay: Touch detect interrupt delay + * (0 -> 10 us, 1 -> 50 us, 2 -> 100 us, 3 -> 500 us, + * 4-> 1 ms, 5 -> 5 ms, 6 -> 10 ms, 7 -> 50 ms) + * recommended is 3 + * @settling: Panel driver settling time + * (0 -> 10 us, 1 -> 100 us, 2 -> 500 us, 3 -> 1 ms, + * 4 -> 5 ms, 5 -> 10 ms, 6 for 50 ms, 7 -> 100 ms) + * recommended is 2 + * @fraction_z: Length of the fractional part in z + * (fraction_z ([0..7]) = Count of the fractional part) + * recommended is 7 + * @i_drive: current limit value of the touchscreen drivers + * (0 -> 20 mA typical 35 mA max, 1 -> 50 mA typical 80 mA max) + */ struct stmpe_touch { struct stmpe *stmpe; struct input_dev *idev;