summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorOla Redell <ola.redell@retotech.se>2017-12-17 21:41:53 +0000
committerOla Redell <ola.redell@retotech.se>2017-12-17 21:41:53 +0000
commitdf4216d07f301ea61e03a4f4419762fd8c33fd4d (patch)
treea4f3bdd02e89f1ba469cf39167235dc279c8c0f3 /README.md
parente0a1fea1252e26f95f5a6302f0079d4e7649ffc2 (diff)
parent6c9981b7a368cf047ce98bc49e2beb74c58d4775 (diff)
downloadmeta-jailhouse-df4216d07f301ea61e03a4f4419762fd8c33fd4d.tar.gz
Merged in olrex/meta-jailhouse (pull request #1)
Master
Diffstat (limited to 'README.md')
-rw-r--r--README.md53
1 files changed, 33 insertions, 20 deletions
diff --git a/README.md b/README.md
index 29a9edc..b336987 100644
--- a/README.md
+++ b/README.md
@@ -17,13 +17,17 @@ This layer depends on:
17 layers: meta 17 layers: meta
18 branch: master 18 branch: master
19 19
20 URI: https://github.com/linux-sunxi/meta-sunxi
21 branch: master
22 tested with 7f88e6c78e7014960654c8f4b3bb0c4e188f0f43
23
20 24
21Maintainers 25Maintainers
22=========== 26===========
23 27
24* Ola Redell <ola@retotech.se> 28* Ola Redell <ola@retotech.se>
25* Anders Törnqvist <anders@retotech.se> 29* Anders Törnqvist <anders@retotech.se>
26* Jonas WestÃ¥ker <jonas@retotech.se> 30* Jonas Weståker <jonas@retotech.se>
27 31
28Please submit any patches against this jailhouse layer 32Please submit any patches against this jailhouse layer
29via email or https://bitbucket.org/retotech/meta-jailhouse 33via email or https://bitbucket.org/retotech/meta-jailhouse
@@ -35,6 +39,7 @@ Tested with
35* Yocto 2.2 39* Yocto 2.2
36* This layer has been developed for and tested with Bananapi M1 as target. 40* This layer has been developed for and tested with Bananapi M1 as target.
37No other targets have been used thus far. 41No other targets have been used thus far.
42* meta-sunxi, 7f88e6c78e7014960654c8f4b3bb0c4e188f0f43
38 43
39 44
40Adding the jailhouse layer to your build 45Adding the jailhouse layer to your build
@@ -76,7 +81,7 @@ recipe defines a CELLS variable that lists all recipes that provide cells (and
76inmates) for the jailhouse build. Adapt the CELLS variable according to your 81inmates) for the jailhouse build. Adapt the CELLS variable according to your
77needs, e.g. 82needs, e.g.
78 83
79 CELLS_append = " freertos-cell" 84 CELLS_pn-jailhouse = "freertos-cell"
80 85
81in `local.conf`. 86in `local.conf`.
82With this declaration, freertos-cell entries will be added both to the 87With this declaration, freertos-cell entries will be added both to the
@@ -114,23 +119,6 @@ Using this class and variables ensures that the file designated by the
114`CELLCONFIG` variable is pulled into the jailhouse build such that 119`CELLCONFIG` variable is pulled into the jailhouse build such that
115a corresponding *.cell file is created. 120a corresponding *.cell file is created.
116 121
117Example cell
118------------
119
120An example cell recipe for the freertos-cell from Siemens is available
121under `recipes-jailhouse/freertos-cell`. To use this, set the
122`CELLS` variable accordingly as described above.
123
124Test the cell by executing the following sequence once booted.
125
126 export JAILHOUSE_DIR=/usr/share/jailhouse
127 jailhouse enable ${JAILHOUSE_DIR}/cells/plamics-bpi-root.cell
128 jailhouse cell create ${JAILHOUSE_DIR}/cells/freertos-cell.cell
129 jailhouse cell load FreeRTOS ${JAILHOUSE_DIR}/inmates/freertos-demo.bin
130 jailhouse cell start FreeRTOS
131
132You should see output on the serial port used by the FreeRTOS inmate.
133
134Important Variables 122Important Variables
135=================== 123===================
136 124
@@ -168,3 +156,28 @@ are installed. This defaults to ${JH_DATADIR}/cells.
168 156
169`INMATES_DIR` Target directory into which inmate binaries (.bin) are installed. 157`INMATES_DIR` Target directory into which inmate binaries (.bin) are installed.
170Defaults to ${JH_DATADIR}/inmates. 158Defaults to ${JH_DATADIR}/inmates.
159
160Example image
161=============
162
163Build the example image `jailhouse-image` using the included machine
164configuration `jailhouse-bpi` together with the provided kernel recipe:
165
166 MACHINE=jailhouse-bpi bitbake jailhouse-image
167
168Example cell
169------------
170
171An example cell recipe for the freertos-cell from Siemens is available
172under `recipes-jailhouse/freertos-cell`. To use this, set the
173`CELLS` variable accordingly as described above.
174
175Test the cell by executing the following sequence once booted.
176
177 export JAILHOUSE_DIR=/usr/share/jailhouse
178 jailhouse enable ${JAILHOUSE_DIR}/cells/bananapi.cell
179 jailhouse cell create ${JAILHOUSE_DIR}/cells/freertos-cell.cell
180 jailhouse cell load FreeRTOS ${JAILHOUSE_DIR}/inmates/freertos-demo.bin
181 jailhouse cell start FreeRTOS
182
183You should see output on the serial port used by the FreeRTOS inmate.