From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: Received: from metis.ext.pengutronix.de ([2001:67c:670:201:290:27ff:fe1d:cc33]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1gw95j-00011l-93 for barebox@lists.infradead.org; Tue, 19 Feb 2019 17:22:06 +0000 Received: from dude.hi.pengutronix.de ([2001:67c:670:100:1d::7]) by metis.ext.pengutronix.de with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1gw95h-0002UC-RY for barebox@lists.infradead.org; Tue, 19 Feb 2019 18:21:57 +0100 Received: from afa by dude.hi.pengutronix.de with local (Exim 4.92-RC5) (envelope-from ) id 1gw95c-00064v-7b for barebox@lists.infradead.org; Tue, 19 Feb 2019 18:21:52 +0100 From: Ahmad Fatoum Date: Tue, 19 Feb 2019 18:21:50 +0100 Message-Id: <20190219172150.11901-17-a.fatoum@pengutronix.de> In-Reply-To: <20190219172150.11901-1-a.fatoum@pengutronix.de> References: <20190219172150.11901-1-a.fatoum@pengutronix.de> MIME-Version: 1.0 List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "barebox" Errors-To: barebox-bounces+u.kleine-koenig=pengutronix.de@lists.infradead.org Subject: [PATCH v2 16/16] doc: microchip-ksz9477-evb: add documentation To: barebox@lists.infradead.org Signed-off-by: Ahmad Fatoum --- .../boards/at91/microchip-ksz9477-evb.rst | 38 ++++++++++++++++++- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/Documentation/boards/at91/microchip-ksz9477-evb.rst b/Documentation/boards/at91/microchip-ksz9477-evb.rst index 4c4c4aecbfb3..2a68c2a552cd 100644 --- a/Documentation/boards/at91/microchip-ksz9477-evb.rst +++ b/Documentation/boards/at91/microchip-ksz9477-evb.rst @@ -1,11 +1,45 @@ Microchip KSZ 9477 Evaluation board =================================== -This is an evaluation board for a switch that uses the at91sam9x5 CPU. +This is an evaluation board for the KSZ9477 switch that uses the sama5d36 CPU. The board uses Device Tree and supports multi image. -Building barebox: +Building barebox as second stage bootloader: .. code-block:: sh make ARCH=arm microchip_ksz9477_evb_defconfig + +There are also a separate defconfig for operating barebox as first stage +bootloader originating from SD Card. +This configuration doesn't yet support device-tree use as the NVM bootloader +(SoC ROM code) requires the first stage bootloader to fit into 64K. + +Generally, the first stage may comes from any of the following boot +sources (in that order): + +* SPI0 CS0 Flash +* SD Card +* NAND Flash +* SPI0 CS1 Flash +* I2C EEPROM + +After being loaded into SRAM by the NVM bootloader, the first stage does low +level clock initialization, configuration of the DDRAM controller and +bootstraps the second stage boot loader. + +SD Card Bootstrap +----------------- + +For boot from SD card, barebox additionally needs to be configured as +first stage bootloader: + +.. code-block:: sh + + make ARCH=arm microchip_ksz9477_evb_bootstrap_mmc_defconfig + +The resulting barebox image must be renamed to ``BOOT.BIN`` +and located in the root directory of the first FAT16/32 partition +on the SD Card/eMMC. After initialization, ``BOOT.BIN`` will look +for a ``barebox.bin`` in the same directory and load and execute it +from SDRAM. -- 2.20.1 _______________________________________________ barebox mailing list barebox@lists.infradead.org http://lists.infradead.org/mailman/listinfo/barebox