From patchwork Sun May 17 11:53:41 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lubomir Rintel X-Patchwork-Id: 1292141 Return-Path: X-Original-To: incoming-buildroot@patchwork.ozlabs.org Delivered-To: patchwork-incoming-buildroot@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=busybox.net (client-ip=140.211.166.136; helo=silver.osuosl.org; envelope-from=buildroot-bounces@busybox.net; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=v3.sk Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 49Q0tb4yDyz9sT8 for ; Sun, 17 May 2020 21:54:31 +1000 (AEST) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id B6E222271C; Sun, 17 May 2020 11:54:27 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id FjlWCwhQeM+6; Sun, 17 May 2020 11:54:21 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by silver.osuosl.org (Postfix) with ESMTP id A4CBF204E2; Sun, 17 May 2020 11:54:20 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from hemlock.osuosl.org (smtp2.osuosl.org [140.211.166.133]) by ash.osuosl.org (Postfix) with ESMTP id CBFB01BF3D5 for ; Sun, 17 May 2020 11:54:11 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id C8FAC886A6 for ; Sun, 17 May 2020 11:54:11 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id TqcM8I9tUu5D for ; Sun, 17 May 2020 11:54:11 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from v6.sk (v6.sk [167.172.42.174]) by hemlock.osuosl.org (Postfix) with ESMTPS id 259718869D for ; Sun, 17 May 2020 11:54:11 +0000 (UTC) Received: from localhost (v6.sk [IPv6:::1]) by v6.sk (Postfix) with ESMTP id E3390610D3; Sun, 17 May 2020 11:54:09 +0000 (UTC) From: Lubomir Rintel To: buildroot@buildroot.org Date: Sun, 17 May 2020 13:53:41 +0200 Message-Id: <20200517115341.1677382-16-lkundrak@v3.sk> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200517115341.1677382-1-lkundrak@v3.sk> References: <20200517115341.1677382-1-lkundrak@v3.sk> MIME-Version: 1.0 Subject: [Buildroot] [PATCH 15/15] board/olpc: document flashing the JFFS2 image X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Lubomir Rintel Errors-To: buildroot-bounces@busybox.net Sender: "buildroot" Signed-off-by: Lubomir Rintel --- board/olpc/readme.txt | 38 +++++++++++++++++++++++++++++--------- 1 file changed, 29 insertions(+), 9 deletions(-) diff --git a/board/olpc/readme.txt b/board/olpc/readme.txt index 2ed44011f7..f04ad7037c 100644 --- a/board/olpc/readme.txt +++ b/board/olpc/readme.txt @@ -9,10 +9,13 @@ Supported models * OLPC XO-1 The original NS Geode based OLPC laptop, uses the x86 architecture. + Can be booted either from an internal MTD device formatted with JFFS2 + or from a FAT or EXT4 partition on a SD card or a USB flash stick. * OLPC XO-7.5 The ARM-based laptop. Needs a recent enough firmware to provide a good - enough flattened device tree to the kernel. + enough flattened device tree to the kernel. Can be from a FAT or EXT4 + partition on a internal eMMC, a SD card or a USB flash stick. Configure and build =================== @@ -59,20 +62,37 @@ to update the firmware: ok flash ext:\q4e00ja.rom \ Flash the "q4e00ja.rom" from the SD card ok flash u:\q4e00ja.rom \ Flash the "q4e00ja.rom" from USB stick -Create the bootable media -========================= +Create the bootable SD card or USB flash stick +============================================== -When the build is finished, the resulting image file will be called -"sdcard.img". It can be written directly to a SD-card or and USB flash stick. +When the build is finished, an image file called "sdcard.img" will be created. +It is suitable for writing directly to a SD card, USB flash stick or (on a +XO-1.75) the internal eMMC flash. -Please double check that you're using the right device (e.g. with "lsblk" -command). Doing the following will DESTROY ALL DATA that's currently on the -media. +Before writing the image, please double check that you're using the right +device (e.g. with "lsblk" command). Doing the following will DESTROY ALL DATA +that's currently on the media. # cat output/images/sdcard.img >/dev/ +Flashing the JFFS2 image (XO-1 only) +==================================== + +Unlike XO-1.75, the internal NAND flash on XO-1 is accessed without a FTL +and needs a filesystem flash-friendly filesystem. A build configured for +XO-1 creates a file named "root.jffs2" that can be written to it. + +One way to write it is from the Open Firmware prompt. First, partition +and format a USB flash disk with a FAT file system and place the +"root.jffs2" file onto it. Then power on the machine, enter the +Open Firmware port by pressing the ESC key and run the following: + + ok patch noop ?open-crcs copy-nand \ Disable CRC check + ok copy-nand u:\root.jffs2 + Booting the machine =================== Once your machine is unlocked, it will automatically boot from your media -wherever it will detect it attached to the USB bus or the SD card slot. +wherever it will detect it attached to the USB bus or the SD card slot, +otherwise it will proceed booting from the internal flash.