From patchwork Sat Oct 31 13:41:06 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Cameron X-Patchwork-Id: 320086 Delivered-To: patch@linaro.org Received: by 2002:a92:7b12:0:0:0:0:0 with SMTP id w18csp2268613ilc; Sat, 31 Oct 2020 06:44:23 -0700 (PDT) X-Google-Smtp-Source: ABdhPJweCwZpPxynz34drhP9TMduICWenmpTY1rRrUg19IDtPUnz27Wd8f+Hy8pXuYjDCl1JXQ4t X-Received: by 2002:a05:6402:142a:: with SMTP id c10mr7803230edx.261.1604151862982; Sat, 31 Oct 2020 06:44:22 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1604151862; cv=none; d=google.com; s=arc-20160816; b=YZ7JGY+e36I63uxTOPC+bxOv2OpB33k19H7t6U3T61VssrHhk2XLsC+xnm6/jY0GlO jU9QmO2/JsonvekKdUq1gQ8XtsRJSUe250zJfzzyvxUbxXXqgFG34+dTUE4JtXtfz3eC yjWRjMIXbvuA1bI4G/yacSOfG3Uhy7tcAc6JAWM6VU2qCZwKdl5hE0It/3NZ5ogtz9P1 PHSUoiEuFmj1l1iao4LN771eV3R9ZlFt/GZf0E0BcShNAR/SgDV5Q3StYa4VhUlD9XWr SPmAFQOWuJpc/2aIYzrJFstxqdskAP2IcvFEivkSElSZ3JhQ7MJiiI0br6unfQiwHX1V ipMw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=l6u8xnxx7QCvEIM30sjCBG59t8vZme7SiXVViD0WuCo=; b=0nC1uwpKgmGwvI/+BgoRoLdatYJToLsYN+i+DNHxwejOKqMYvCOKYjtWINMucx9+dS UNDVbZP+SgUSB6b5fXX8vfQEYyKlTLYAHAA946v0SNf55RGxTVms0T7AC8H5bkNBQ2kB kGQPZ+I+co702AML4n7dnq2bzYjmzWAlHqDgVkOjbKRjUUlOdtaPAOLGWNsVMUxFZun8 bCYKxZtFDSASbjlrwgS0OAc4YVdn25ehdjXgVfhnwEE1aMN7S5EwNSb/FJnrrhV3q+6m Cy/vxSg1ZH+si9wTGHbFQ+jumluLD2aUwEjygBF4s+ulYHcl4fGmGvobkH7S1vdjTgyz CsBg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=RlVtYztL; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id h25si6243872ejc.209.2020.10.31.06.44.22; Sat, 31 Oct 2020 06:44:22 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=RlVtYztL; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727782AbgJaNoW (ORCPT + 6 others); Sat, 31 Oct 2020 09:44:22 -0400 Received: from mail.kernel.org ([198.145.29.99]:43522 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727692AbgJaNoU (ORCPT ); Sat, 31 Oct 2020 09:44:20 -0400 Received: from localhost.localdomain (cpc149474-cmbg20-2-0-cust94.5-4.cable.virginm.net [82.4.196.95]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 9C14220756; Sat, 31 Oct 2020 13:44:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1604151859; bh=L3enWNiZCZFfSX6Uzisvt5gE1Pq6Nzdoi/g+T4UvAic=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=RlVtYztL26Do3f1Hlh6xLieXtnVO2IOUbx5p+1CXnVze/pK/XnYKJfIX4kPwfusR9 29nhsPMBF8MhF16lP/jWJuXWtvmlMMzkRZPtagV5Ukb2j3LX3TLDBHh1NKoID3+ooi Xj7nHnMiIPVH0JpTaC5It75JcC4n1P0ytrmQb6/k= From: Jonathan Cameron To: linux-iio@vger.kernel.org, Rob Herring , devicetree@vger.kernel.org Cc: Jonathan Cameron , Rob Herring , Crt Mori Subject: [PATCH v2 25/29] dt-bindings:iio:temperature:melexis, mlx90632 conversion to yaml Date: Sat, 31 Oct 2020 13:41:06 +0000 Message-Id: <20201031134110.724233-26-jic23@kernel.org> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201031134110.724233-1-jic23@kernel.org> References: <20201031134110.724233-1-jic23@kernel.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Jonathan Cameron Technically this could have gone in trivial-devices.yaml, but I have kept it as a separate binding due to the detailed additional description from the text file. Signed-off-by: Jonathan Cameron Reviewed-by: Rob Herring Acked-by: Crt Mori Cc: Crt Mori --- .../iio/temperature/melexis,mlx90632.yaml | 55 +++++++++++++++++++ .../bindings/iio/temperature/mlx90632.txt | 28 ---------- 2 files changed, 55 insertions(+), 28 deletions(-) -- 2.28.0 diff --git a/Documentation/devicetree/bindings/iio/temperature/melexis,mlx90632.yaml b/Documentation/devicetree/bindings/iio/temperature/melexis,mlx90632.yaml new file mode 100644 index 000000000000..b547ddcd544a --- /dev/null +++ b/Documentation/devicetree/bindings/iio/temperature/melexis,mlx90632.yaml @@ -0,0 +1,55 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/temperature/melexis,mlx90632.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Melexis MLX90632 contactless Infra Red temperature sensor + +maintainers: + - Crt Mori + +description: | + https://www.melexis.com/en/documents/documentation/datasheets/datasheet-mlx90632 + + There are various applications for the Infra Red contactless temperature + sensor and MLX90632 is most suitable for consumer applications where + measured object temperature is in range between -20 to 200 degrees + Celsius with relative error of measurement below 1 degree Celsius in + object temperature range for industrial applications. Since it can + operate and measure ambient temperature in range of -20 to 85 degrees + Celsius it is suitable also for outdoor use. + + Be aware that electronics surrounding the sensor can increase ambient + temperature. MLX90632 can be calibrated to reduce the housing effect via + already existing EEPROM parameters. + + Since measured object emissivity effects Infra Red energy emitted, + emissivity should be set before requesting the object temperature. + +properties: + compatible: + const: melexis,mlx90632 + + reg: + maxItems: 1 + description: Default is 0x3a, but can be reprogrammed. + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + temp-sensor@3a { + compatible = "melexis,mlx90632"; + reg = <0x3a>; + }; + }; +... diff --git a/Documentation/devicetree/bindings/iio/temperature/mlx90632.txt b/Documentation/devicetree/bindings/iio/temperature/mlx90632.txt deleted file mode 100644 index 0b05812001f8..000000000000 --- a/Documentation/devicetree/bindings/iio/temperature/mlx90632.txt +++ /dev/null @@ -1,28 +0,0 @@ -* Melexis MLX90632 contactless Infra Red temperature sensor - -Link to datasheet: https://www.melexis.com/en/documents/documentation/datasheets/datasheet-mlx90632 - -There are various applications for the Infra Red contactless temperature sensor -and MLX90632 is most suitable for consumer applications where measured object -temperature is in range between -20 to 200 degrees Celsius with relative error -of measurement below 1 degree Celsius in object temperature range for -industrial applications. Since it can operate and measure ambient temperature -in range of -20 to 85 degrees Celsius it is suitable also for outdoor use. - -Be aware that electronics surrounding the sensor can increase ambient -temperature. MLX90632 can be calibrated to reduce the housing effect via -already existing EEPROM parameters. - -Since measured object emissivity effects Infra Red energy emitted, emissivity -should be set before requesting the object temperature. - -Required properties: - - compatible: should be "melexis,mlx90632" - - reg: the I2C address of the sensor (default 0x3a) - -Example: - -mlx90632@3a { - compatible = "melexis,mlx90632"; - reg = <0x3a>; -};