From patchwork Fri Dec 15 00:17:12 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eddie Cai X-Patchwork-Id: 848798 X-Patchwork-Delegate: philipp.tomsich@theobroma-systems.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=lists.denx.de (client-ip=81.169.180.215; helo=lists.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="YvUMAez7"; dkim-atps=neutral Received: from lists.denx.de (dione.denx.de [81.169.180.215]) by ozlabs.org (Postfix) with ESMTP id 3yyWHX1p56z9t2f for ; Fri, 15 Dec 2017 11:18:31 +1100 (AEDT) Received: by lists.denx.de (Postfix, from userid 105) id 3145AC21E3B; Fri, 15 Dec 2017 00:18:08 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on lists.denx.de X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=FREEMAIL_FROM, RCVD_IN_MSPIKE_H2, T_DKIM_INVALID autolearn=unavailable autolearn_force=no version=3.4.0 Received: from lists.denx.de (localhost [IPv6:::1]) by lists.denx.de (Postfix) with ESMTP id 72718C21EC9; Fri, 15 Dec 2017 00:18:05 +0000 (UTC) Received: by lists.denx.de (Postfix, from userid 105) id F1435C21E63; Fri, 15 Dec 2017 00:17:52 +0000 (UTC) Received: from mail-pf0-f193.google.com (mail-pf0-f193.google.com [209.85.192.193]) by lists.denx.de (Postfix) with ESMTPS id 99B62C21DF7 for ; Fri, 15 Dec 2017 00:17:49 +0000 (UTC) Received: by mail-pf0-f193.google.com with SMTP id u19so4848238pfa.12 for ; Thu, 14 Dec 2017 16:17:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=IGvDMTKsaroT/bTRVWptg//X+THP/2AmmRQLlZuhW+w=; b=YvUMAez7ezDm2HGptZq+H7qENZmSw8FDTABnM6uGIWwUW+D94RWb+xnp5bibDH/uR5 pPtMsVjqP0yuqwl5P5sDLXDUdJxGxwzBznrFt9l75wpSrk/4bbjr8J6G3VpFGsSTq/yD m85GugOpZQ0r8JhOfSZ/ioL0HCMvbwC7n4WAyStXUqETJztrjiGl+wPLrp/37VwxbRho 12Gr38JQSXJZoCcvfwQtlq18F2rrmUygkX8Ps07J56bUjUDJDzCVIHLkgcnsKe6rIDpL 3aqWNROTMjGt1NgapoReiOpdm7JoFijlomW4dgfx4rZnNFMvu9ipXF4ysiWs6JCsKxTa rbZA== 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=IGvDMTKsaroT/bTRVWptg//X+THP/2AmmRQLlZuhW+w=; b=fcRBYGOHz7O/UzE9hdSurIcxAttNBUnaeHTBGx/3p3pXZ18GgfVO0MDVFBUCXzevXj oSxkcOEoC9FkABbyFXK5jGtOg9AgsxO9DoBEOenq7X46j5XxMbmQ3aI2Zo6cuwAR3CC/ +lw7hQ2tlpxtptvvL63FJzKkpOxIPYrqmsTQFDU1tn+aCNQ4v2stWkyKl6Bny6bl8Vxf kdw+2itwH2Dz7J0TmCP4PsIkwoJt6Yxpw+p89z3xWw6LsvIdUgSlTeZUBhPzaeet45bv UwQyrLTNBbpSGdwOyolp+7xbLziZ2fpiOCuPZRPXsu3SCila4+vn9v/6EHtgLKMO8ICd kGJA== X-Gm-Message-State: AKGB3mKVvwWfxYmL9FQiAaTtWbBefMDLUAA2ghUGshJV5E/jrYUUZTwu pTcnEYrIGwEEOg6LZBScSWs= X-Google-Smtp-Source: ACJfBovdQ6CFpwydW1LFkFQdsBEBAxI8eoW7dLClZ4y1Xf4/mE5DS5Hp29p7GlPPrieAiLEEwpVAFA== X-Received: by 10.101.69.68 with SMTP id x4mr10026925pgr.272.1513297068305; Thu, 14 Dec 2017 16:17:48 -0800 (PST) Received: from localhost.localdomain ([103.29.142.67]) by smtp.gmail.com with ESMTPSA id p10sm9918153pfl.32.2017.12.14.16.17.45 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 14 Dec 2017 16:17:46 -0800 (PST) From: Eddie Cai To: lukma@denx.de, marek.vasut@gmail.com Date: Fri, 15 Dec 2017 08:17:12 +0800 Message-Id: <1513297033-26450-4-git-send-email-eddie.cai.linux@gmail.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1513297033-26450-1-git-send-email-eddie.cai.linux@gmail.com> References: <1513297033-26450-1-git-send-email-eddie.cai.linux@gmail.com> Cc: marex@denx.de, u-boot@lists.denx.de Subject: [U-Boot] [PATCH V12 3/4] rockchip:usb: add a simple readme for rockusb X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.18 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" add a simple readme to introduce rockusb and tell people how to use it Signed-off-by: Eddie Cai Reviewed-by: Simon Glass --- Changes in v12: -none Changes in v11: -add to MAINTAINER Changes in v10: -none Changes in v9: -none Changes in v8: -none Changes in v7: -none Changes in v6: -none Changes in v5: -none Changes in v4: -add some blank line to make it look better Changes in v3: -fix checkpatch error --- MAINTAINERS | 1 + doc/README.rockusb | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 doc/README.rockusb diff --git a/MAINTAINERS b/MAINTAINERS index b231610..9b4b63b 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -493,6 +493,7 @@ M: Eddie Cai S: Maintained F: drivers/usb/gadget/f_rockusb.c F: cmd/rockusb.c +F: doc/README.rockusb VIDEO M: Anatolij Gustschin diff --git a/doc/README.rockusb b/doc/README.rockusb new file mode 100644 index 0000000..5405dc4 --- /dev/null +++ b/doc/README.rockusb @@ -0,0 +1,51 @@ +Rockusb (Rockchip USB protocol) +===================================================== + +Overview +-------- + +Rockusb protocol is widely used by Rockchip SoC based devices. It can +read/write info, image to/from devices. This document briefly describes how to +use Rockusb for upgrading firmware (e.g. kernel, u-boot, rootfs, etc.). + +Tools +-------- +There are many tools can support Rockusb protocol. rkdeveloptool +(https://github.com/rockchip-linux/rkdeveloptool) is open source, +It is maintained by Rockchip. People don't want to build from source +can download from here +(https://github.com/rockchip-linux/rkbin/blob/master/tools/rkdeveloptool) + +Usage +-------- +The Usage of Rockusb command is: + +rockusb + +e.g. rockusb 0 mmc 0 + +On your U-Boot console, type this command to enter rockusb mode. +On your host PC. use lsusb command. you should see a usb device +using 0x2207 as its USB verdor id. + +for more detail about the rkdeveloptool. please read the usage. + +rkdeveloptool -h + +use rkdeveloptool wl command to write lba. BeginSec is the lba on device +you want to write. + +sudo rkdeveloptool wl + +to flash U-Boot image use below command. U-Boot binary is made by mkimage. +see doc/README.rockchip for more detail about how to get U-Boot binary. + +sudo rkdeveloptool wl 64 + +There are plenty of Rockusb command. but wl(write lba) and +rd(reboot) command. These two command can let people flash +image to device. + +To do +----- +* Fully support Rockusb protocol