From patchwork Thu Jan 20 15:30:00 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Masami Hiramatsu X-Patchwork-Id: 533543 Delivered-To: patch@linaro.org Received: by 2002:ad5:5d50:0:0:0:0:0 with SMTP id x16csp1676237imu; Thu, 20 Jan 2022 07:30:20 -0800 (PST) X-Google-Smtp-Source: ABdhPJxjK5K+9uiJz/fKaNa9TT4CfkMoiEg48KdveW58q63M3J9SdOLXlObzPcDBNvfHApHovs3s X-Received: by 2002:a05:6402:2552:: with SMTP id l18mr36694298edb.124.1642692619897; Thu, 20 Jan 2022 07:30:19 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1642692619; cv=none; d=google.com; s=arc-20160816; b=ERAYPOx1rUa4PnNK/97g2BYViT/HGN2m/3Uf8lZwJtMoc6YBlnGQ6HegumNJXSpvhs NwxHB8ofPkKJtNLzKklo4NgyaD+9tCXUzb8RcnPcDsWfJDU+MnAUze+hptFIDBm4js0B CQcn6IR0ht6Faj9VsVLL3MtaqXUyVOjzPa62IbepxyBM9QshZNPZNNiF8Ksrgli7iXYS CtaNgJklEAikgmTGB2hB6eTBGvQOEuOpjUHqechFJH5fYWN2fxmXhZKAS1F19xFBhmL6 xwV9GohH0x3R1H5H0YBRtpTW9/e5zaxenIRBn3MdTbEGnU8M8hx0bFm/iZiqZPCkFumY mjEw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:user-agent:references:in-reply-to:message-id:date :subject:cc:to:from:dkim-signature; bh=bGmGu49df4XOBEYIG6dJkaB+U0VA8i/Vw3C8sJK/Thk=; b=Qb0eRIWd9BUdrICvlal1f3T762Lueg0/D6srHtsGk1q1YS4opukIr65m2pMRL0cDNf RAWjCeashknExEyneZCzc57I2kLXAV7uIgr0Vkj162hOnF4BztbDHXb/EkHOD9gvOfr9 5K3G1fXj0WK6cWa2aPHal/iQ8A5qckZiFTtkbCW7vvC2BlyPebROhXm1NSIDHb6P2uoZ BZWPIv1wZ/+UgddfAi4c/5u4D/VE4C+gp8AsI5OQyq2kradHZ8J9ezr5x0i6AJP1tdPp 71MRoZDleId5tp3dINUy48oupEX7MjoHn2GMlh0xkjAz7MP7bBlQQnuvBPwF3YFYUZ1D KFyw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=TyCqjwbO; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from phobos.denx.de (phobos.denx.de. [2a01:238:438b:c500:173d:9f52:ddab:ee01]) by mx.google.com with ESMTPS id o23si2398504edz.311.2022.01.20.07.30.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Jan 2022 07:30:19 -0800 (PST) Received-SPF: pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=TyCqjwbO; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id C8FD0838C4; Thu, 20 Jan 2022 16:30:15 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=linaro.org header.i=@linaro.org header.b="TyCqjwbO"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 5A5D683890; Thu, 20 Jan 2022 16:30:10 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2 Received: from mail-pl1-x62f.google.com (mail-pl1-x62f.google.com [IPv6:2607:f8b0:4864:20::62f]) (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 B52FD838BA for ; Thu, 20 Jan 2022 16:30:06 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=masami.hiramatsu@linaro.org Received: by mail-pl1-x62f.google.com with SMTP id e8so5461025plh.8 for ; Thu, 20 Jan 2022 07:30:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :user-agent:mime-version:content-transfer-encoding; bh=bGmGu49df4XOBEYIG6dJkaB+U0VA8i/Vw3C8sJK/Thk=; b=TyCqjwbOv5TwsScOvow8kk7yVJegtvzGQR03XRqOVLfQa8hhyKqD46oXxuf3GKBJQN IKYvTXkcQj/FiYwBHwZSzJ4CMj0AQ3Rw8HaWvpGO5P+IpRj5sm4d+eZXpwBkQraBtDs4 uox5naXOU4s6LsSoqbI9EClqJon4FL4PlN3e97zt7CyFSdGzCl7UrZWbm8yS+ekSzP6d 24YFZB87RG6wC5BhwNlSAB3E7qcPL7nrXB8ZCEB8ChXfNUJb2SELxkmSrk7//tqaaqAW 9tPAojBlt1OCzo+CAnUp8RsiPSesulYJFfkoIMs4j/9bejGSPCQufcJgc70EZTLnIZNq 5Ylg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:user-agent:mime-version:content-transfer-encoding; bh=bGmGu49df4XOBEYIG6dJkaB+U0VA8i/Vw3C8sJK/Thk=; b=faQynxTx7VPfw8GlgTHXR/uvQKglp3Pz44eETL7TiHB1ipQ5aTnVCirksY4vKQUAsI Oy5KyQ51HEHf13B4Qq3gb3GTFJkT0Tq4OndU5IiXZEJRgzZJpVYdOL5nWuifYu4aZAJb WTtSRK4AQG+nBlmBsDS+5bOYb7X/lZCKmx/O3t8rdlytt/zRUsEEZGrD/UK7CdwLdN9S 20/NTtmgQehsbB2mF0G/eFm1Ag5xvMV5HKA2fGgNavJeFkJgi2/N9FvT1iJYMCHdaLsP UuWxF9TFZayyEweO/2hXF5bakwQ8TTJ9rAf2c68hv5bSQNLRV18DkKiVptfowZYgpCcv 5WHw== X-Gm-Message-State: AOAM533a93dBfFZQZ38ev/mCr85lQAYNRfmuR+GJYxccC7PFaKqU23tZ kbfoz3P1Kf/cDEGaCAa9lLatmx7rBFzF0g== X-Received: by 2002:a17:902:a38f:b0:14a:ec8d:51ac with SMTP id x15-20020a170902a38f00b0014aec8d51acmr10981760pla.132.1642692604860; Thu, 20 Jan 2022 07:30:04 -0800 (PST) Received: from localhost.localdomain (113x37x226x201.ap113.ftth.ucom.ne.jp. [113.37.226.201]) by smtp.gmail.com with ESMTPSA id q21sm3822236pfj.94.2022.01.20.07.30.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Jan 2022 07:30:04 -0800 (PST) From: Masami Hiramatsu To: u-boot@lists.denx.de Cc: Masami Hiramatsu , Patrick Delaunay , Patrice Chotard , Heinrich Schuchardt , Alexander Graf , AKASHI Takahiro , Simon Glass , Bin Meng , Ilias Apalodimas , Jose Marinho , Grant Likely , Tom Rini , Etienne Carriere , Sughosh Ganu , Paul Liu Subject: [RFC PATCH 04/14] doc: usage: DFU: Fix dfu_alt_info document Date: Fri, 21 Jan 2022 00:30:00 +0900 Message-Id: <164269259998.39378.8996629458151622003.stgit@localhost> X-Mailer: git-send-email 2.25.1 In-Reply-To: <164269255955.39378.260729958623102750.stgit@localhost> References: <164269255955.39378.260729958623102750.stgit@localhost> User-Agent: StGit/0.19 MIME-Version: 1.0 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.2 at phobos.denx.de X-Virus-Status: Clean Fix some typo and wrong information about dfu_alt_info. Signed-off-by: Masami Hiramatsu --- doc/usage/dfu.rst | 45 +++++++++++++++++++++++++++++++++------------ 1 file changed, 33 insertions(+), 12 deletions(-) diff --git a/doc/usage/dfu.rst b/doc/usage/dfu.rst index 11c88072b8..25517637ae 100644 --- a/doc/usage/dfu.rst +++ b/doc/usage/dfu.rst @@ -113,9 +113,9 @@ mmc each element in *dfu_alt_info* being * raw [mmcpart ] raw access to mmc device - * part [mmcpart ] raw access to partition - * fat [mmcpart ] file in FAT partition - * ext4 [mmcpart ] file in EXT4 partition + * part [offset ] raw access to partition + * fat file in FAT partition + * ext4 file in EXT4 partition * skip 0 0 ignore flashed data * script 0 0 execute commands in shell @@ -169,14 +169,20 @@ nand each element in *dfu_alt_info* being either of - * raw raw access to mmc device - * part raw acces to partition - * partubi raw acces to ubi partition + * raw raw access to nand device + * part raw access to partition + * partubi raw access to ubi partition with + offset + is the offset in the nand device (hexadecimal without "0x") + size + is the size of the access area (hexadecimal without "0x") + devid + is the NAND device index (decimal only) partid - is the MTD partition index + is the NAND partition index (decimal only) ram raw access to ram:: @@ -190,6 +196,13 @@ ram ram raw access to ram + with + + offset + is the offset in the ram device (hexadecimal without "0x") + size + is the size of the access area (hexadecimal without "0x") + sf serial flash : NOR:: @@ -203,8 +216,12 @@ sf with + offset + is the offset in the mtd device (hexadecimal without "0x") + size + is the size of the access area (hexadecimal without "0x") partid - is the MTD partition index + is the MTD partition index (decimal) mtd all MTD device: NAND, SPI-NOR, SPI-NAND,...:: @@ -219,14 +236,18 @@ mtd each element in *dfu_alt_info* being either of: - * raw forraw access to mtd device - * part for raw acces to partition - * partubi for raw acces to ubi partition + * raw for raw access to mtd device + * part for raw access to partition + * partubi for raw access to ubi partition with + offset + is the offset in the mtd device (hexadecimal without "0x") + size + is the size of the access area (hexadecimal without "0x") partid - is the MTD partition index + is the MTD partition index (decimal only) virt virtual flash back end for DFU