summaryrefslogtreecommitdiffstats
path: root/Documentation/boards/sandbox.rst
blob: 85a54e6b04d68646dfc2a7061c3e5f0b989a96af (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
Sandbox
=======

barebox can be run as a simulator on your host to check and debug new non
hardware related features.

Building barebox for simulation
-------------------------------

The barebox sandbox can be built with the host compiler:

.. code-block:: sh

  ARCH=sandbox make sandbox_defconfig
  ARCH=sandbox make

Running the sandbox
-------------------

Once you compile barebox for the sandbox, you can run it with::

.. code-block:: console

  $ barebox [<OPTIONS>]

Available sandbox invocation options include:

  ``-m``, ``--malloc=<size>``

    Start sandbox with a specified malloc-space <size> in bytes.

  ``-i <file>``

    Map a <file> to barebox. This option can be given multiple times. The <file>s
    will show up as ``/dev/fd0`` ... ``/dev/fdX`` in the barebox simulator.

  ``-e <file>``

    Map <file> to barebox. With this option <file>s are mapped as
    ``/dev/env0`` ...  ``/dev/envX`` and thus are used as default environment.
    A clean file generated with ``dd`` will do to get started with an empty environment.

  ``-O <file>``

    Register <file> as a console capable of doing stdout. <file> can be a
    regular file or a FIFO.

  ``-I <file>``

    Register <file> as a console capable of doing stdin. <file> can be a regular
    file or a FIFO.

  ``-x``, ``--xres <res>``

    Specify SDL width.

  ``-y``, ``--yres <res>``

    Specify SDL height.