diff options
| author | Ola Redell <ola.redell@retotech.se> | 2017-11-15 15:02:41 +0100 |
|---|---|---|
| committer | Ola Redell <ola.redell@retotech.se> | 2017-11-15 15:02:41 +0100 |
| commit | 622553abd287876dab0b4521cd0479c3ad8a2452 (patch) | |
| tree | 3b7fbcfd4b1914097f4bb21424fe36ac68ec5bca | |
| parent | e05f113012055aff0cd7b5154f41280aa98c3330 (diff) | |
| parent | ba584d2c8b184980c4b9b511e91db468584151b2 (diff) | |
| download | meta-jailhouse-622553abd287876dab0b4521cd0479c3ad8a2452.tar.gz | |
fixed merge
| -rw-r--r-- | README.md | 55 |
1 files changed, 46 insertions, 9 deletions
| @@ -25,14 +25,15 @@ Maintainers | |||
| 25 | * Anders Törnqvist <anders@retotech.se> | 25 | * Anders Törnqvist <anders@retotech.se> |
| 26 | * Jonas Weståker <jonas@retotech.se> | 26 | * Jonas Weståker <jonas@retotech.se> |
| 27 | 27 | ||
| 28 | Please submit any patches against this jailhouse layer to | 28 | Please submit any patches against this jailhouse layer |
| 29 | meta-jailhouse@retotech.se | 29 | via email or https://bitbucket.org/retotech/meta-jailhouse |
| 30 | 30 | ||
| 31 | 31 | ||
| 32 | Tested with | 32 | Tested with |
| 33 | =========== | 33 | =========== |
| 34 | 34 | ||
| 35 | This layer has been developed for and tested with Bananapi M1 as target. | 35 | * Yocto 2.2 |
| 36 | * This layer has been developed for and tested with Bananapi M1 as target. | ||
| 36 | No other targets have been used thus far. | 37 | No other targets have been used thus far. |
| 37 | 38 | ||
| 38 | 39 | ||
| @@ -66,13 +67,14 @@ to your image recipe, or local.conf: | |||
| 66 | 67 | ||
| 67 | The jailhouse inmates and cells are by default | 68 | The jailhouse inmates and cells are by default |
| 68 | placed under `/usr/share/jailhouse/{inmates,cells}`. These locations | 69 | placed under `/usr/share/jailhouse/{inmates,cells}`. These locations |
| 69 | can be adjusted using the variables in jailhouse-dirs.inc. | 70 | can be adjusted using the variables in **jailhouse-defs.inc**. |
| 70 | 71 | ||
| 71 | The jailhouse build system builds cell configuration (*.cell) files from the | 72 | The jailhouse build system builds binary cell configuration (*.cell) files |
| 72 | cell descriptions (*.c). To enable cell descriptions being defined in | 73 | from cell configuration sources (*.c). To allow cell configurations to be |
| 73 | cell recipes and imported into the jailhouse build, the jailhouse recipe | 74 | defined in cell recipes and imported into the jailhouse build, the jailhouse |
| 74 | defines a CELLS variable that lists all recipes that provide cells (and inmates) | 75 | recipe defines a CELLS variable that lists all recipes that provide cells (and |
| 75 | for the jailhouse build. Adapt the CELLS variable according to your needs, e.g. | 76 | inmates) for the jailhouse build. Adapt the CELLS variable according to your |
| 77 | needs, e.g. | ||
| 76 | 78 | ||
| 77 | CELLS_append = " freertos-cell" | 79 | CELLS_append = " freertos-cell" |
| 78 | 80 | ||
| @@ -110,3 +112,38 @@ as follows: | |||
| 110 | Using this class and variables ensures that the file designated by the | 112 | Using this class and variables ensures that the file designated by the |
| 111 | `CELLCONFIG` variable is pulled into the jailhouse build such that | 113 | `CELLCONFIG` variable is pulled into the jailhouse build such that |
| 112 | a corresponding *.cell file is created. | 114 | a corresponding *.cell file is created. |
| 115 | |||
| 116 | |||
| 117 | Important Variables | ||
| 118 | =================== | ||
| 119 | |||
| 120 | The following variables should be set in jailhouse bbappends and cell recipes | ||
| 121 | |||
| 122 | `CELLCONFIG` The name of the source cell configuration file (.c) that a cell | ||
| 123 | recipe installs into the sysroot, for the jailhouse recipe to use to create | ||
| 124 | a binary configuration file. This variable should be set in a cell recipe | ||
| 125 | using a full path e.g. `CELLCONFIG = "${S}/my/path/cell-config.c"`. | ||
| 126 | Empty by default. | ||
| 127 | |||
| 128 | `CELLS` A list of cells that should be built with jailhouse. The jailhouse | ||
| 129 | recipe will get dependencies to all cells listed in this variable and | ||
| 130 | pull in their cell configuration source files to the build. Empty by default. | ||
| 131 | |||
| 132 | `INMATE` The name of the inmate binary file (.bin) that a cell recipe | ||
| 133 | produces. This variable should be set in a cell recipe | ||
| 134 | using a full path e.g. `INMATE = "${B}/freertos-demo.bin"`. | ||
| 135 | Empty by default. | ||
| 136 | |||
| 137 | The following variables can be left as is | ||
| 138 | |||
| 139 | `JH_DATADIR` Base directory for installed jailhouse cells on target. This | ||
| 140 | defaults to ${datadir}/jailhouse. | ||
| 141 | |||
| 142 | `CELL_DIR` Target directory into which binary cell configuration files (.cell) | ||
| 143 | are installed. This defaults to ${JH_DATADIR}/cells. | ||
| 144 | |||
| 145 | `CELLCONF_DIR` Target directory into which the source cell configuration files | ||
| 146 | (.c) are installed. Defaults to ${JH_DATADIR}/configs. | ||
| 147 | |||
| 148 | `INMATES_DIR` Target directory into which inmate binaries (.bin) are installed. | ||
| 149 | Defaults to ${JH_DATADIR}/inmates. | ||
