| Miguel Young de la Sota | d258b33 | 2019-10-29 14:05:23 -0500 | [diff] [blame] | 1 | # OpenTitan Software |
| 2 | |
| 3 | This subtree contains all software intended to run on the OpenTitan chip, as well as some tools. |
| 4 | |
| 5 | ## Building |
| 6 | |
| Tobias Wölfel | 03d1cf3 | 2020-02-26 12:47:07 +0100 | [diff] [blame] | 7 | OpenTitan software is built using [Meson](https://mesonbuild.com), although OpenTitan's project structure is sufficiently idiosyncratic that we use a custom workflow. |
| Miguel Young de la Sota | 8ff30b8 | 2019-11-25 12:58:34 -0600 | [diff] [blame] | 8 | |
| 9 | For example, to build the OpenTitan executable located at `sw/device/examples/hello_world` for FPGA, run the following commands: |
| 10 | ```console |
| 11 | $ cd "$REPO_TOP" |
| 12 | $ ./meson_init.sh |
| Miguel Young de la Sota | 76526c3 | 2020-01-28 10:24:41 -0500 | [diff] [blame] | 13 | $ ninja -C build-out sw/device/examples/hello_world/hello_world_export_fpga_nexysvideo |
| Miguel Young de la Sota | d258b33 | 2019-10-29 14:05:23 -0500 | [diff] [blame] | 14 | ``` |
| Miguel Young de la Sota | 8ff30b8 | 2019-11-25 12:58:34 -0600 | [diff] [blame] | 15 | |
| Miguel Young de la Sota | 76526c3 | 2020-01-28 10:24:41 -0500 | [diff] [blame] | 16 | The resulting binaries will be located at `build-bin/sw/device/examples/hello_world`. For more information, check out [the relevant User Guide](../doc/ug/getting_started_sw.md). |
| Miguel Young de la Sota | 8ff30b8 | 2019-11-25 12:58:34 -0600 | [diff] [blame] | 17 | |
| Greg Chadwick | c96ccaf | 2020-02-04 13:37:37 +0000 | [diff] [blame] | 18 | The location of the RISC-V toolchain is /tools/riscv by default. |
| 19 | If your toolchain is located elsewhere set the `TOOLCHAIN_PATH` to that path before running `meson_init.sh` |
| 20 | |
| 21 | ```console |
| 22 | $ cd "$REPO_TOP" |
| 23 | $ export TOOLCHAIN_PATH=/path/to/toolchain |
| 24 | $ ./meson_init.sh |
| 25 | ``` |
