From patchwork Thu Dec 28 10:49:10 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bartosz Golaszewski X-Patchwork-Id: 853401 X-Patchwork-Delegate: bartekgola@gmail.com 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="O4RYJ58U"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3z6mhL1v1Sz9s7G for ; Thu, 28 Dec 2017 21:50:10 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753302AbdL1KtV (ORCPT ); Thu, 28 Dec 2017 05:49:21 -0500 Received: from mail-wm0-f68.google.com ([74.125.82.68]:38077 "EHLO mail-wm0-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753164AbdL1KtU (ORCPT ); Thu, 28 Dec 2017 05:49:20 -0500 Received: by mail-wm0-f68.google.com with SMTP id 64so43142412wme.3 for ; Thu, 28 Dec 2017 02:49:19 -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=fd+jgRMlN+DKiDOb0V2BLm2e6XLXZssush9fq0ZiLws=; b=O4RYJ58UUd8TAqui94pCyB/4K8ZpuCuBUIVjJcOGGuTd8uRPLGTKNnwa8Qq1Z8R1j8 XtZZgUlXHHBcMTa/qI88cBMX49hO1tDXoZDltA41HcZZeQWlqCSb2TR+LATj2hIfKYhD 4uuUWCKhOq6qtgDPY4qjtnWBfacYqQOVIfD2UN6zUkCM50rvRyV41EXnKzfIIzQ4gB0y gVSpC8+pDGJewupjKPB0GGod45fYWl034/BBH9dVBBtor1VCZallgGWfp6omJk+IdMdh KBxNiuxDaOIMsgpaZIv3OP1uPq66NXjfENFgtNzQuqgIulbaH+Ve4EaToG+Lb4Lf0PNa hbEA== 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=fd+jgRMlN+DKiDOb0V2BLm2e6XLXZssush9fq0ZiLws=; b=AxV2JJ5TcwvDBUTZyYMGWB94AOMaiAtmHuE/9M8PFO9gcptQwMkLPstAjSCo/289+m CsEK8SCE0Z5EsHWNICe5JCFu1sAwS4gjMT5Y0teFLkomHZwPw7FCxGNrUkfZVlfzMMvS NXYfjJla4kK92pmfqsewm7sw4kz8lznnKvPnnTOa7UGZlGlfiyrQXHbUmjBR+6nAZ8GU inRhE+ppfQYoqUEAcOjepU5+jLnsjrTTecg7jfXBkPt48Dw8ms9NXLrlMBuMY4eIm0ie keER1s7SAgMwbCPZ0ouQEs9GQa+cDBkvRFUu++rLd3wTvMCb2kGEqQDNgKlZUy5ZH3rb SScw== X-Gm-Message-State: AKGB3mLZKPEtpTfQcwMCzaJzUJydreO8XDTymUhJWE4xFPdN/lA3CyCv Sr27q4PDr5SAbIUls1q5im4J3A== X-Google-Smtp-Source: ACJfBotvMgJP5Ucs5e8fFT+zISjdeHcBxlfaKI9cwlelQ7J9krCNUoPDDGcZQtaZUIxDrttQuHo4xg== X-Received: by 10.28.141.11 with SMTP id p11mr1458976wmd.149.1514458158987; Thu, 28 Dec 2017 02:49:18 -0800 (PST) Received: from bgdev-debian.home ([2a01:cb1d:af:5b00:c47b:2cf6:dd98:f17b]) by smtp.gmail.com with ESMTPSA id m68sm39378985wmi.28.2017.12.28.02.49.17 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 28 Dec 2017 02:49:18 -0800 (PST) From: Bartosz Golaszewski To: Andy Shevchenko , Rob Herring , Mark Rutland , Javier Martinez Canillas , David Lechner , Divagar Mohandass , Peter Rosin Cc: linux-i2c@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Bartosz Golaszewski Subject: [PATCH v4 1/4] dt-bindings: at24: consistently document the compatible property Date: Thu, 28 Dec 2017 11:49:10 +0100 Message-Id: <20171228104913.29873-2-brgl@bgdev.pl> X-Mailer: git-send-email 2.15.1 In-Reply-To: <20171228104913.29873-1-brgl@bgdev.pl> References: <20171228104913.29873-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. State explicitly that any "," pair is accepted as long as a correct fallback is used for non-atmel chips. Signed-off-by: Bartosz Golaszewski Reviewed-by: Rob Herring --- Documentation/devicetree/bindings/eeprom/at24.txt | 58 ++++++++++++++--------- 1 file changed, 36 insertions(+), 22 deletions(-) diff --git a/Documentation/devicetree/bindings/eeprom/at24.txt b/Documentation/devicetree/bindings/eeprom/at24.txt index cbc80e194ac6..0c8e1341908f 100644 --- a/Documentation/devicetree/bindings/eeprom/at24.txt +++ b/Documentation/devicetree/bindings/eeprom/at24.txt @@ -2,28 +2,42 @@ 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 a "," pair. The following + values are supported (assuming "atmel" as manufacturer): + + "atmel,24c00", + "atmel,24c01", + "atmel,24c02", + "atmel,spd", + "atmel,24c04", + "atmel,24c08", + "atmel,24c16", + "atmel,24c32", + "atmel,24c64", + "atmel,24c128", + "atmel,24c256", + "atmel,24c512", + "atmel,24c1024", + + If is not "atmel", then a fallback must be used + with the same and "atmel" as manufacturer. + + Example: + compatible = "microchip,24c128", "atmel,24c128"; + + Supported manufacturers are: + + "catalyst", + "microchip", + "ramtron", + "renesas", + "nxp", + "st", + + Some vendors use different model names for chips which are just + variants of the above. Known such exceptions are listed below: + + "renesas,r1ex24002" - the fallback is "atmel,24c02" - reg : the I2C address of the EEPROM