From patchwork Sun Apr 22 22:02:51 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Veenstra X-Patchwork-Id: 10355833 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id AEFB260388 for ; Sun, 22 Apr 2018 22:02:58 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 98B981FE8A for ; Sun, 22 Apr 2018 22:02:58 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 8B8CA20243; Sun, 22 Apr 2018 22:02:58 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.8 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, MAILING_LIST_MULTI, RCVD_IN_DNSWL_HI, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1F7D81FE8A for ; Sun, 22 Apr 2018 22:02:57 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753551AbeDVWC4 (ORCPT ); Sun, 22 Apr 2018 18:02:56 -0400 Received: from mail-wr0-f193.google.com ([209.85.128.193]:35749 "EHLO mail-wr0-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753021AbeDVWC4 (ORCPT ); Sun, 22 Apr 2018 18:02:56 -0400 Received: by mail-wr0-f193.google.com with SMTP id w3-v6so36031363wrg.2; Sun, 22 Apr 2018 15:02:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=BlsuTG+t39E0EW1jAJ0wJ3Puqa3NXl+NAcW+CA3z3F8=; b=PrENHTCeKwRndqt3ALCl5G2gWraWjo4jil5KHyNidAPJldcFD2CIFzSb/Fr42sCpa2 N1zWE9OcIhNndjxGd2UVQXVSxY4gKF4r/JLQmjn2LOUldeJOrrvKT6Gzt6DQabhfdZU8 ThNSyNcM4qhNorIqSmykE18a1PzQ1jhLR07tQSEJ4RmJQKLHvNQaANrklqBZ6hYQ0wlo 3tX5K1OVTmw7Cim87Uz8J+OKyKeOEPJpHk+NEMPndT0shFrXwfpeNjS3/3vSObPBD1Vf 7wZJkNX8aczDng1jBGinHeK/Vg5bYctl6kJ8jt3CuE8RjaCWvQRxEBG1rbfP8ge+KS30 WyoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=BlsuTG+t39E0EW1jAJ0wJ3Puqa3NXl+NAcW+CA3z3F8=; b=MEPoAmStqkk5wi0mi1LZFYP2kxVxQqDyC2E4tgZKPOUyuZ6HAzD0cURc+YSIP1wGd7 mnFU7MGKNAiRcWz8knHucMM+wUwq9U3XVSEh9G/BKfPFtzVgVVAK0iXSYA65IPizBsV7 RbgtGcwNWPSH0fTAVmCfOBzEobPvJGpefTOLGUL6at5VH6SqY86gGC4Qp+uW5FP/V+5Z qRJ0oOqwHe6qPPb+F/qGoy0CCNZV7lxSRazgeKbz1SlCkmPAu5LlhY5Y/lazx7NlY6br ZzunDBm3jYAxDt8Xy45ZejJ1aW26tOwhAGemsuAfxRXiJC1adx79BdtPYyMNNdhLb73U IyAA== X-Gm-Message-State: ALQs6tCO7g8R3yoNohZVtHK9hBMYBt73PwWJrWpueu7U/HopwIBj12lg 0622D0w9s8lfmGBTIJDc5Bw= X-Google-Smtp-Source: AIpwx4+w9AMQQqX9f29XZ4wZbGd4r3XzY27fkyeuJQqgXpzsYxvcPwuKmbd0JeBsE6mPAig+9OrczA== X-Received: by 10.167.215.81 with SMTP id a17mr10243609eds.220.1524434574827; Sun, 22 Apr 2018 15:02:54 -0700 (PDT) Received: from zenbook-arch (s559434a1.adsl.online.nl. [85.148.52.161]) by smtp.gmail.com with ESMTPSA id f13sm6824235edl.67.2018.04.22.15.02.53 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 22 Apr 2018 15:02:54 -0700 (PDT) Date: Mon, 23 Apr 2018 00:02:51 +0200 From: David Veenstra To: jic23@kernel.org, lars@metafoo.de, pmeerw@pmeerw.net Cc: robh+dt@kernel.org, Michael.Hennerich@analog.com, knaack.h@gmx.de, linux-iio@vger.kernel.org, daniel.baluta@nxp.com, devel@driverdev.osuosl.org, devicetree@vger.kernel.org Subject: [PATCH v3 1/9] staging: iio: ad2s1200: Add kernel docs to driver state Message-ID: References: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.9.4 (2018-02-28) Sender: linux-iio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add missing kernel docs to the ad2s1200 driver state. Signed-off-by: David Veenstra --- Changes in v3: - Added more explanation to mutex lock. drivers/staging/iio/resolver/ad2s1200.c | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/drivers/staging/iio/resolver/ad2s1200.c b/drivers/staging/iio/resolver/ad2s1200.c index 357fe3c382b3..17d65cb437fd 100644 --- a/drivers/staging/iio/resolver/ad2s1200.c +++ b/drivers/staging/iio/resolver/ad2s1200.c @@ -33,6 +33,15 @@ /* clock period in nano second */ #define AD2S1200_TSCLK (1000000000 / AD2S1200_HZ) +/** + * struct ad2s1200_state - driver instance specific data. + * @lock: protects both the GPIO pins and the rx buffer, to prevent + * concurrent spi transactions. + * @sdev: spi device. + * @sample: GPIO pin SAMPLE. + * @rdvel: GPIO pin RDVEL. + * @rx: buffer for spi transfers. + */ struct ad2s1200_state { struct mutex lock; struct spi_device *sdev;