From patchwork Mon Aug 28 07:45:59 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eddie Cai X-Patchwork-Id: 806423 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="coYz6agi"; dkim-atps=neutral Received: from lists.denx.de (dione.denx.de [81.169.180.215]) by ozlabs.org (Postfix) with ESMTP id 3xgkSM3w5Cz9s8J for ; Mon, 28 Aug 2017 17:49:39 +1000 (AEST) Received: by lists.denx.de (Postfix, from userid 105) id 424E1C22472; Mon, 28 Aug 2017 07:48:43 +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, KHOP_BIG_TO_CC, RCVD_IN_DNSWL_NONE, 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 86518C2248A; Mon, 28 Aug 2017 07:47:22 +0000 (UTC) Received: by lists.denx.de (Postfix, from userid 105) id 16E82C22468; Mon, 28 Aug 2017 07:47:17 +0000 (UTC) Received: from mail-pf0-f194.google.com (mail-pf0-f194.google.com [209.85.192.194]) by lists.denx.de (Postfix) with ESMTPS id 15F77C22437 for ; Mon, 28 Aug 2017 07:47:17 +0000 (UTC) Received: by mail-pf0-f194.google.com with SMTP id g13so3672559pfm.2 for ; Mon, 28 Aug 2017 00:47:17 -0700 (PDT) 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=kyBeWpurLjpVd4wPBwH0FnrXgfMVey2wW7vq/IrzVL4=; b=coYz6agiGmp6ISlc03GLNQrIxsSOJ/ptJrMc6iIcGeSRMAtKfWRSrjGbpXc2VrLVZf 5k83M/GAVEi/4Dc7B8msPFUSPlfZfxPN7qQjOP0YIHCceymwbILlIu0tSl4wAHv3Ko12 QcGwuEX5Eqk0QUCP8HJu/LHykhQjum4IjN6ZSdVJNtN/C0+WLR6M+VtQOO0ExIn5gkc7 boNtWddZ/4dc6BpmbXfkBW2aviPNpU0xauoZSuT9R82P65NWdfXHAyH7ACQYhcbl9phK a3A7HxuyqRIpOTgKGBPbxcSnE5cmd+opUiqq1tF3WOeNexiC+D+fpmVG5B7tjKZNbTTj MzxA== 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=kyBeWpurLjpVd4wPBwH0FnrXgfMVey2wW7vq/IrzVL4=; b=p6U27D0ej6j6IWkDqnrDq19bU4OIL1ytMF04PYSnA4C72VNdRVLcoyR74Jl3CtKDIy TDYdqNKbvzQz4FMguZmEfCYcM1EJ+mo11+i1/TxuuIW9lMWo7DpyTMN4ittqmDvBnPYs VCXw/eESFTCLtmXV88ZLSSWdSYDd2wAd16ZlcaXdGXiFcUU2AyXIIa+3TYIP/h3dwE4C Ns0LsOCuVGnPDBRyEmqEITD3x8DoeJZFeI5NmFS55BiFQrqqHnUDK5H266HFIyG+tht6 omijf1LfymKkLXHEbTwZ9ycnfBeDd92mSo+kI/hizmRctxK8V129W0F41elpkZ2JdWCx t0Rw== X-Gm-Message-State: AHYfb5hEaK38OMBp+qZspRYp1/lntlngvfwX4INlMllMaMogcAbhyVY+ 5AEiE8bERQzv1A== X-Received: by 10.99.185.69 with SMTP id v5mr6543175pgo.304.1503906435637; Mon, 28 Aug 2017 00:47:15 -0700 (PDT) Received: from localhost.localdomain ([103.29.142.67]) by smtp.gmail.com with ESMTPSA id q185sm20684565pfb.119.2017.08.28.00.47.10 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 28 Aug 2017 00:47:14 -0700 (PDT) From: Eddie Cai To: lukma@denx.de, sjg@chromium.org, marex@denx.de, trini@konsulko.com, william.wu@rock-chips.com, yamada.masahiro@socionext.com, maxime.ripard@free-electrons.com, agraf@suse.de, bmeng.cn@gmail.com, yanmiaobest@gmail.com, dinguyen@kernel.org, boris.brezillon@free-electrons.com, sr@denx.de, uri.mashiach@compulab.co.il, michal.simek@xilinx.com Date: Mon, 28 Aug 2017 15:45:59 +0800 Message-Id: <1503906360-13043-4-git-send-email-eddie.cai.linux@gmail.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1503906360-13043-1-git-send-email-eddie.cai.linux@gmail.com> References: <1503906360-13043-1-git-send-email-eddie.cai.linux@gmail.com> Cc: u-boot@lists.denx.de Subject: [U-Boot] [PATCH V9 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 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 Acked-by: Philipp Tomsich --- doc/README.rockusb | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 doc/README.rockusb 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