From patchwork Thu Dec 21 13:08:26 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bartosz Golaszewski X-Patchwork-Id: 851924 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=linux-i2c-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=bgdev-pl.20150623.gappssmtp.com header.i=@bgdev-pl.20150623.gappssmtp.com header.b="1+BfsTCY"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3z2X6n2sDyz9s81 for ; Fri, 22 Dec 2017 00:09:53 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753849AbdLUNJk (ORCPT ); Thu, 21 Dec 2017 08:09:40 -0500 Received: from mail-wr0-f196.google.com ([209.85.128.196]:39599 "EHLO mail-wr0-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753372AbdLUNIl (ORCPT ); Thu, 21 Dec 2017 08:08:41 -0500 Received: by mail-wr0-f196.google.com with SMTP id a41so25082433wra.6 for ; Thu, 21 Dec 2017 05:08:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bgdev-pl.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=Meg7F7UaPHsNZZ1vtB0fFceijViZqL7EOB8sRvfGz7M=; b=1+BfsTCYlEiVTtTheIB6DZQUQtYPzziKdUefIxBt2yD7g0HR9IwwTQXMP+RUsBf1Ne hUsQkNIU0BJrkdOTigKfXQVgPOHg6mvlRq1xb31XdzVZFXaq7bG3EKFxFfKBWxUqZJ7w zWekyxfVKBtCy8s40CB5AIe6y8wnYgrPW38U1F6UToLJN99O2w2+sZWGtI0Aec7TitYi BqPnCh8+7ckTIejV2S7++sD2MhcHemDZ56yUwjLGa8IkESOLu+cc6UTLNZgE0lC85yhl vlk7yFSOK8Cqn7H+pGVkQaGpoEZUF1G0byk92IkxgKxPlzR1JYKU4mvL+Ap653FZ/8Lh o/sA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=Meg7F7UaPHsNZZ1vtB0fFceijViZqL7EOB8sRvfGz7M=; b=dMfEAgq9cKRXINSAO07Xf/5xFI8GyEHhb2vq+QpmWSnWbWs37kCU9NvVrCWhtHIWqC EuOQ2DcSRt4FZhtInxcJF/C4hzOog0+ywuBnDuaVnfGzAolaKNfYdNsjQijaZoQohq/2 /a0KEWE1tavKfyGTQvRNFLlHYejoG4BGRI/Q6nDOu/aYKIN/iNEh9Puy4TQITBbK2WJa 4CRqDPSGhzptVorgsw/AZvZ9APxFpjCJWLHOY7opyAqdDXxhYHzZZfRWwaVp4qqKlhEc ua3UXZS0Brsxy7rGyCMwKoMauh2unLqwufDK4qgoZ3Q/lRGzioi+b8tebdKwn1tgSb/r OqVA== X-Gm-Message-State: AKGB3mI+8KyBytkXOFLXUCoec2guN2J0skLBrOO+i+KKj5CeGlexgiPz 7TaHjnFbEW02D/xh2grOOHhghg== X-Google-Smtp-Source: ACJfBovTcYzAj+jIsNgTv7FmZOQNj7NQFFZ9nwFePKRQyayvGK1SXBpkPORrBldXbWyElbFyzUb77A== X-Received: by 10.223.155.131 with SMTP id d3mr12845065wrc.29.1513861720095; Thu, 21 Dec 2017 05:08:40 -0800 (PST) Received: from bgdev-debian.baylibre.local (cag06-6-78-235-100-105.fbx.proxad.net. [78.235.100.105]) by smtp.gmail.com with ESMTPSA id j132sm34001896wmd.2.2017.12.21.05.08.38 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 21 Dec 2017 05:08:39 -0800 (PST) From: Bartosz Golaszewski To: Andy Shevchenko , Rob Herring , Mark Rutland , Javier Martinez Canillas , David Lechner , Divagar Mohandass Cc: linux-i2c@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Bartosz Golaszewski Subject: [PATCH 1/5] dt-bindings: at24: consistently document the compatible property Date: Thu, 21 Dec 2017 14:08:26 +0100 Message-Id: <20171221130830.16813-2-brgl@bgdev.pl> X-Mailer: git-send-email 2.15.1 In-Reply-To: <20171221130830.16813-1-brgl@bgdev.pl> References: <20171221130830.16813-1-brgl@bgdev.pl> Sender: linux-i2c-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-i2c@vger.kernel.org Current description of the compatible property for at24 is quite vague. Specify an exact list of accepted compatibles and document the - now deprecated - strings which were previously used in device tree files. Signed-off-by: Bartosz Golaszewski Reviewed-by: Javier Martinez Canillas --- Documentation/devicetree/bindings/eeprom/at24.txt | 50 +++++++++++++---------- 1 file changed, 28 insertions(+), 22 deletions(-) diff --git a/Documentation/devicetree/bindings/eeprom/at24.txt b/Documentation/devicetree/bindings/eeprom/at24.txt index cbc80e194ac6..6ccbd000bfa4 100644 --- a/Documentation/devicetree/bindings/eeprom/at24.txt +++ b/Documentation/devicetree/bindings/eeprom/at24.txt @@ -2,28 +2,34 @@ EEPROMs (I2C) Required properties: - - compatible : should be ",", like these: - - "atmel,24c00", "atmel,24c01", "atmel,24c02", "atmel,24c04", - "atmel,24c08", "atmel,24c16", "atmel,24c32", "atmel,24c64", - "atmel,24c128", "atmel,24c256", "atmel,24c512", "atmel,24c1024" - - "catalyst,24c32" - - "microchip,24c128" - - "ramtron,24c64" - - "renesas,r1ex24002" - - The following manufacturers values have been deprecated: - "at", "at24" - - If there is no specific driver for , a generic - device with and manufacturer "atmel" should be used. - Possible types are: - "24c00", "24c01", "24c02", "24c04", "24c08", "24c16", "24c32", "24c64", - "24c128", "24c256", "24c512", "24c1024", "spd" + - compatible: must be one of the following: + + "atmel,24c00", + "atmel,24c01", + "atmel,24c02", + "atmel,24c04", + "atmel,24c08", + "atmel,24c16", + "atmel,24c32", + "atmel,24c64", + "atmel,24c128", + "atmel,24c256", + "atmel,24c512", + "atmel,24c1024" + + NOTE: old compatible strings, such as: + + "catalyst,24c32", + "microchip,24c128", + "ramtron,24c64", + "renesas,r1ex24002", + "at,24c08", + "at24,24c08" + + will still work, but are now deprecated. + + Also: matching by device type alone - while still supported due to + implementation details in I2C core - is deprecated as well. - reg : the I2C address of the EEPROM