Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 059D3C00144 for ; Fri, 29 Jul 2022 14:46:55 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id C1A4583FD0; Fri, 29 Jul 2022 16:46:53 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=konsulko.com header.i=@konsulko.com header.b="GqAH8yZJ"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 2088783FF4; Fri, 29 Jul 2022 16:46:52 +0200 (CEST) Received: from mail-qt1-x833.google.com (mail-qt1-x833.google.com [IPv6:2607:f8b0:4864:20::833]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 8BE8583FB3 for ; Fri, 29 Jul 2022 16:46:49 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=trini@konsulko.com Received: by mail-qt1-x833.google.com with SMTP id e5so3449034qts.1 for ; Fri, 29 Jul 2022 07:46:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=konsulko.com; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=s4WLlbITj3jK+txj14mvGlYOEQ68tAQ6Xcm8E63aFoY=; b=GqAH8yZJ/IG2Gn1/ycL99zK9Py56j1ALXc77PHmohPyC+d5LJnTMasmDWRlLIZOajt kewBcKMRmKl06P6yyQXOUKOXvSv/e9DHsufqyU1oyZMk16C6Zau3MQEeAxQT2h5XUYEQ Ny7wlM/J9Lgx98k5C49mIWzSiTBMhG/K9KyyY= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=s4WLlbITj3jK+txj14mvGlYOEQ68tAQ6Xcm8E63aFoY=; b=7qcPH9Ynl8nLFZKb5uMAc37s/nIBil4JQs0I5AFSemtlN3InG0w1tulPVXT8m5BZtj 8pjnV/twDu2dfqjF1ayDmGkvvPFkUYSsrTZnpmWQFuYGV7h7qfr8gf+Bfa50/Smtgfi/ Gjx2ZHd3fQYpRKaczL3JxRpqm2m6Wm7i+ICfpAV3TyopLvUKn4PE+SlFDOK7GQNt7ydH EG4BJxSHlqG6QH6X3iWyhQ1zwtO9VBRMPvs+ruCKvTWVc7sPzlJZbTBJbp6w9Aqvb97c 0bSRE13F1iwXkvmuGx/bf3i9kG6pPSSE4M0BmdPnuYd9Oxze6nhgQQID9YGwNvPcxih/ gt1w== X-Gm-Message-State: AJIora+uvnfhGtnHf+EAMGKYP/3z+LNJdTo+ipKrCKUnSj3XOSK05fMK bRI6i/FHrEJdeZ6VUc2UTw4ByGZkR4+wPmrT X-Google-Smtp-Source: AGRyM1tSQCBJfugDkQdHSXlNAJrPn7y5pWvheR9PgzKON3LXVomm8et8Fg6Cz9yRQC/mo9F3ATlULg== X-Received: by 2002:ac8:4e4a:0:b0:31f:1f4a:7603 with SMTP id e10-20020ac84e4a000000b0031f1f4a7603mr3681713qtw.42.1659106008321; Fri, 29 Jul 2022 07:46:48 -0700 (PDT) Received: from bill-the-cat (cpe-65-184-195-139.ec.res.rr.com. [65.184.195.139]) by smtp.gmail.com with ESMTPSA id 8-20020a370508000000b006b64ba324desm2442447qkf.58.2022.07.29.07.46.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Jul 2022 07:46:47 -0700 (PDT) Date: Fri, 29 Jul 2022 10:46:45 -0400 From: Tom Rini To: Heinrich Schuchardt Cc: Pali =?iso-8859-1?Q?Roh=E1r?= , Simon Glass , u-boot@lists.denx.de Subject: Re: [RFCv2] doc: develop: Describe system configuration Message-ID: <20220729144645.GP1146598@bill-the-cat> References: <20220728185349.2039431-1-trini@konsulko.com> <46ebc7dd-8429-5794-bcaa-5ec2eb2d66fd@gmx.de> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="Y4ulEJkxsxr8jJ+p" Content-Disposition: inline In-Reply-To: <46ebc7dd-8429-5794-bcaa-5ec2eb2d66fd@gmx.de> X-Clacks-Overhead: GNU Terry Pratchett X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.6 at phobos.denx.de X-Virus-Status: Clean --Y4ulEJkxsxr8jJ+p Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 29, 2022 at 09:03:00AM +0200, Heinrich Schuchardt wrote: > On 7/28/22 20:53, Tom Rini wrote: > > Start by describing in general the best practices for how to implement > > configuration of some aspect of U-Boot. This generally means finding > > the right choices for when something should be static or dynamically > > configured and enabled. Then further document when to use CONFIG or CFG > > namespaces for static configuration. [snip] > > +#. Simple run time. One example here are chip revision checks. Another= is >=20 > %s/Simple run time\./Run time feature detection./ I'm trying to differentiate between "check this register content" or "read this EEPROM" from "parse the device tree, look for compatible strings". I'll try and reword this differently. >=20 > > + knowing that we've checked GPIOs and are on revision B of a platfor= m, rather >=20 > Do you mean: "On some boards the revision may be detected by reading > GPIOs."? I'm trying to give some useful examples, but not every example. So yes, the check GPIOs A/B/C and see what we get example. Instead of "simple" I'm going to say hardware based, reword the section and try and not get too deep in to details. --=20 Tom --Y4ulEJkxsxr8jJ+p Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGzBAABCgAdFiEEGjx/cOCPqxcHgJu/FHw5/5Y0tywFAmLj8s4ACgkQFHw5/5Y0 tyw5Ywv+OkBpVPTNP04833sQ0akYHspDTewCvHMzKtEK6ur41Yq+dm01F47rDlLL /cTmmiWkruc4sOCFtGENnF5GJnWo4MsqcgzOvsOql6vPLRotPvgtoe7sbR1k1zW2 S7m1qVkg3/bgSXHEPFiPYtNSW5DvX1p4twdnqgOdC8nxJ30RwTLFhtXlPgwiBuIA twQhyXrVTU6Jb2WN+cku4a6lA8BUR19iOcjbVcM5FrFFRgQfbKZFc3imfn1g7HFI tUsxa5nC6YE7lzrPyyLWBvoP+tuBjP9jSN18jMysyyzOELWcWnasKPIEwIEzW7BF b8pljTUSQmkjeFeJoraepEloYJuaxImcdbuId05iCHjQruJinj8lwOawiUa4PTEl h2ur1DuHxQ/rpUHs1N9MpMLTpAroaCFyhXneBIc9OvjT3ofQ3XhzwP6KF7iZPpQv JxyGvCEV3ExpluJt5wdNgmLfGLe5TMFz967fKB3F2PSGHA3MYrdPvC7cZaPRQJHv WToG6vKp =txnk -----END PGP SIGNATURE----- --Y4ulEJkxsxr8jJ+p--