board/sandbox/sandbox/README.sandbox

   1 /*
   2  * Copyright (c) 2011 The Chromium OS Authors.
   3  *
   4  * SPDX-License-Identifier:     GPL-2.0+
   5  */
   6
   7 Native Execution of U-Boot
   8 ==========================
   9
  10 The 'sandbox' architecture is designed to allow U-Boot to run under Linux on
  11 almost any hardware. To achieve this it builds U-Boot (so far as possible)
  12 as a normal C application with a main() and normal C libraries.
  13
  14 All of U-Boot's architecture-specific code therefore cannot be built as part
  15 of the sandbox U-Boot. The purpose of running U-Boot under Linux is to test
  16 all the generic code, not specific to any one architecture. The idea is to
  17 create unit tests which we can run to test this upper level code.
  18
  19 CONFIG_SANDBOX is defined when building a native board.
  20
  21 The chosen vendor and board names are also 'sandbox', so there is a single
  22 board in board/sandbox/sandbox.
  23
  24 CONFIG_SANDBOX_BIG_ENDIAN should be defined when running on big-endian
  25 machines.
  26
  27 Note that standalone/API support is not available at present.
  28
  29 The serial driver is a very simple implementation which reads and writes to
  30 the console. It does not set the terminal into raw mode, so cursor keys and
  31 history will not work yet.
  32
  33
  34 Tests
  35 -----
  36
  37 So far we have no tests, but when we do these will be documented here.