From patchwork Tue Sep 17 17:59:29 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dan Murphy X-Patchwork-Id: 173903 Delivered-To: patch@linaro.org Received: by 2002:ac9:19ad:0:0:0:0:0 with SMTP id d45csp5443361oce; Tue, 17 Sep 2019 10:57:45 -0700 (PDT) X-Google-Smtp-Source: APXvYqyBpMndEbG1r5ldu1VttohvC7Nbll4Un0yfZ7LSRRWAXTuKQzVzAq21HpAT9YsuGu2PyR/b X-Received: by 2002:a50:9734:: with SMTP id c49mr6053738edb.93.1568743065068; Tue, 17 Sep 2019 10:57:45 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1568743065; cv=none; d=google.com; s=arc-20160816; b=OH12GQ0hGT6k9njDsd0CFmJVRFvAjKXvB5BPwxjeQ7GBX07YEcdbbejRVVWNNRYhV+ 1nILj0wzoLsrAUQY0mbf+QOdWiMSgKj+olUmfeZYlTQ/936/RmaaT2zbQlqj0vYEpSjH EgQgbqS+bS39fCDyStgx76cz7Pd7w80d31baranw1cEC0LDFL/c8Rk9n86Dfn12Zliz2 B2vjig9Q96MWRTSO3548IWPIyQB3lAOhQ89ssDvhVTAq9Vb8P86g+c39ssUa/l8ZJqqM mCjNVJYopFfXzX6HFA/8geozqT1QCYyjoNVaRcd/+lM9ZX+kOzHOiZSSSAXTbKL2cYBe 9Qvw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=6Z2cBqLsJ0iVJLVLuc89fOae+4wo06v0RLtO0VcnawI=; b=jwrFRj88XIj56DLE2vXVxN8c+AhSJlQOGKrAAu3YLJ6T/HieDv2KcQYR+H6i7fVQvV SjwOvemOex5Ll57I8Gzje33aagWLR9OTHxQ+tdVftU7BvGlSnega8dJH0olKo1uaiq48 NkhF8E9HnIuQn73kOaKyWvAQe+hnn7/0RaYFT7U+JfXGNKziMABDptNJuAxdV0o0lSsL 1a8qldeMK9h3H3Va9E5XStRb+G8+69ISHJfOj44xD9e+C0+dLpixqSrHqZJvAI4+70gZ 6IS5TIR5jAviZ7wkV/3w7sr/pQxbOaM6zvEdp4GZzsbDFkeMcSj2o8MM17SsWCDnYwy+ +niQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b="GS1CC/tz"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id q1si1470825eju.389.2019.09.17.10.57.44; Tue, 17 Sep 2019 10:57:45 -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; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b="GS1CC/tz"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731405AbfIQR5l (ORCPT + 27 others); Tue, 17 Sep 2019 13:57:41 -0400 Received: from lelv0142.ext.ti.com ([198.47.23.249]:33722 "EHLO lelv0142.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726494AbfIQR5j (ORCPT ); Tue, 17 Sep 2019 13:57:39 -0400 Received: from lelv0265.itg.ti.com ([10.180.67.224]) by lelv0142.ext.ti.com (8.15.2/8.15.2) with ESMTP id x8HHvYbk113127; Tue, 17 Sep 2019 12:57:34 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1568743054; bh=6Z2cBqLsJ0iVJLVLuc89fOae+4wo06v0RLtO0VcnawI=; h=From:To:CC:Subject:Date; b=GS1CC/tzJMOmOQwapiZKKmPeJRCZmV9pmBdtb6CjZaaBdDcw+qCFp1Mx6vIwMFcCG IHYcb6v2ZVbz2CB6modbSt/lZrMYLI92BBcztXdylNcspxiBGlwISoMxaQ7u19T6xg fdbNyOXfIcMt1IAzJZs/H8ayUDYcnmtqOCrdiqvg= Received: from DLEE115.ent.ti.com (dlee115.ent.ti.com [157.170.170.26]) by lelv0265.itg.ti.com (8.15.2/8.15.2) with ESMTPS id x8HHvYBt116911 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 17 Sep 2019 12:57:34 -0500 Received: from DLEE103.ent.ti.com (157.170.170.33) by DLEE115.ent.ti.com (157.170.170.26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1713.5; Tue, 17 Sep 2019 12:57:33 -0500 Received: from fllv0039.itg.ti.com (10.64.41.19) by DLEE103.ent.ti.com (157.170.170.33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1713.5 via Frontend Transport; Tue, 17 Sep 2019 12:57:30 -0500 Received: from localhost (ileax41-snat.itg.ti.com [10.172.224.153]) by fllv0039.itg.ti.com (8.15.2/8.15.2) with ESMTP id x8HHvX2K109328; Tue, 17 Sep 2019 12:57:33 -0500 From: Dan Murphy To: , CC: , , Dan Murphy Subject: [PATCH v6 1/9] leds: multicolor: Add sysfs interface definition Date: Tue, 17 Sep 2019 12:59:29 -0500 Message-ID: <20190917175937.13872-1-dmurphy@ti.com> X-Mailer: git-send-email 2.22.0.214.g8dca754b1e MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add a documentation of LED Multicolor LED class specific sysfs attributes. Signed-off-by: Dan Murphy --- v6 - Removed color_mix and color_id files .../ABI/testing/sysfs-class-led-multicolor | 43 +++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-class-led-multicolor -- 2.22.0.214.g8dca754b1e diff --git a/Documentation/ABI/testing/sysfs-class-led-multicolor b/Documentation/ABI/testing/sysfs-class-led-multicolor new file mode 100644 index 000000000000..b8f459f97919 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-class-led-multicolor @@ -0,0 +1,43 @@ +What: /sys/class/leds//brightness +Date: Sept 2019 +KernelVersion: 5.5 +Contact: Dan Murphy +Description: read/write + Writing to this file will update all LEDs within the group to a + calculated percentage of what each color LED intensity is set + to. The percentage is calculated via the equation below: + + led_brightness = requested_value * led_color_intensity/led_color_max_intensity + + For additional details please refer to + Documentation/leds/leds-class-multicolor.rst. + + The value of the color is from 0 to + /sys/class/leds//max_brightness. + +What: /sys/class/leds//colors//intensity +Date: Sept 2019 +KernelVersion: 5.5 +Contact: Dan Murphy +Description: read/write + The led_color directory is dynamically created based on the + colors defined by the registrar of the class. + The value for the led_color is defined in the + include/dt-bindings/leds/common.h. There is one directory per + color presented. The intensity file is created under each + led_color directory and controls the individual LED color + setting. + + The value of the color is from 0 to + /sys/class/leds//colors//max_intensity. + +What: /sys/class/leds//colors//max_intensity +Date: Sept 2019 +KernelVersion: 5.5 +Contact: Dan Murphy +Description: read only + Maximum intensity level for the LED color, default is + 255 (LED_FULL). + + If the LED does not support different intensity levels, this + should be 1.