summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'documentation')
-rw-r--r--documentation/MAINTAINERS.md28
-rw-r--r--documentation/openvino.md95
-rw-r--r--documentation/reporting_bugs.md2
-rw-r--r--documentation/submitting_patches.md2
4 files changed, 97 insertions, 30 deletions
diff --git a/documentation/MAINTAINERS.md b/documentation/MAINTAINERS.md
deleted file mode 100644
index ea435849..00000000
--- a/documentation/MAINTAINERS.md
+++ /dev/null
@@ -1,28 +0,0 @@
1The purpose of this file is to provide contact information for
2specific BSPs and other code contained within meta-intel. You should
3address questions and patches for a particular BSP or other code to
4the appropriate maintainer listed in this file, cc'ing the meta-intel
5mailing list. This ensures that your question or patch will be
6addressed by the appropriate person, and that it will be seen by other
7users who may be facing similar problems or questions.
8
9Please see the [Guidelines for submitting patches](submitting_patches.md)
10and [Reporting bugs](reporting_bugs.md) guidelines relating to the
11details of submitting patches, reporting problems, or asking questions
12about any of the BSPs or other recipes contained within meta-intel.
13
14Descriptions of section entries:
15
16 M: Mail patches to: FullName <address@domain>
17 F: Files and directories with wildcard patterns.
18 A trailing slash includes all files and subdirectory files.
19 F: common/ all files in and below common
20 F: common/* all files in common, but not below
21 One pattern per line. Multiple F: lines acceptable.
22
23Please keep this list in alphabetical order.
24
25Maintainers List (try to look for most precise areas first)
26
27M: Anuj Mittal <anuj.mittal@intel.com>
28F: *
diff --git a/documentation/openvino.md b/documentation/openvino.md
new file mode 100644
index 00000000..50dc680d
--- /dev/null
+++ b/documentation/openvino.md
@@ -0,0 +1,95 @@
1Build a Yocto Image with OpenVINO™ toolkit
2==========================================
3
4Follow the [Yocto Project official documentation](https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html#compatible-linux-distribution) to set up and configure your host machine to be compatible with BitBake.
5
6## Step 1: Set Up Environment
7
81. Clone the repositories.
9
10```
11 git clone https://git.yoctoproject.org/git/poky
12 git clone https://github.com/openembedded/meta-openembedded
13 git clone https://git.yoctoproject.org/git/meta-intel
14```
15
16
172. Set up the OpenEmbedded build environment.
18
19```
20 source poky/oe-init-build-env
21
22```
23
24
25
263. Add BitBake layers.
27
28
29```
30 bitbake-layers add-layer ../meta-openembedded/meta-oe
31 bitbake-layers add-layer ../meta-openembedded/meta-python
32 bitbake-layers add-layer ../meta-intel
33
34```
35
36
374. Set up BitBake configurations.
38 Include extra configuration in the `conf/local.conf` file in your build directory as required.
39
40
41```
42 MACHINE = "intel-skylake-64"
43
44 # Enable building OpenVINO Python API.
45 # This requires meta-python layer to be included in bblayers.conf.
46 PACKAGECONFIG:append:pn-openvino-inference-engine = " python3"
47
48 # This adds OpenVINO related libraries in the target image.
49 CORE_IMAGE_EXTRA_INSTALL:append = " openvino-inference-engine"
50
51 # This adds OpenVINO samples in the target image.
52 CORE_IMAGE_EXTRA_INSTALL:append = " openvino-inference-engine-samples"
53
54 # Include OpenVINO Python API package in the target image.
55 CORE_IMAGE_EXTRA_INSTALL:append = " openvino-inference-engine-python3"
56
57 # Include model conversion API in the target image.
58 CORE_IMAGE_EXTRA_INSTALL:append = " openvino-model-optimizer"
59
60```
61
62## Step 2: Build a Yocto Image with OpenVINO Packages
63
64Run BitBake to build your image with OpenVINO packages. For example, to build the minimal image, run the following command:
65
66
67```
68 bitbake core-image-minimal
69
70```
71
72## Step 3: Verify the Yocto Image
73
74Verify that OpenVINO packages were built successfully. Run the following command:
75
76```
77 oe-pkgdata-util list-pkgs | grep openvino
78
79```
80
81
82If the image build is successful, it will return the list of packages as below:
83
84```
85 openvino-inference-engine
86 openvino-inference-engine-dbg
87 openvino-inference-engine-dev
88 openvino-inference-engine-python3
89 openvino-inference-engine-samples
90 openvino-inference-engine-src
91 openvino-model-optimizer
92 openvino-model-optimizer-dbg
93 openvino-model-optimizer-dev
94
95```
diff --git a/documentation/reporting_bugs.md b/documentation/reporting_bugs.md
index 59621c1e..5fbc3d27 100644
--- a/documentation/reporting_bugs.md
+++ b/documentation/reporting_bugs.md
@@ -1,7 +1,7 @@
1## Reporting bugs 1## Reporting bugs
2 2
3If you have problems with or questions about a particular BSP, please 3If you have problems with or questions about a particular BSP, please
4contact the maintainer listed in the [Maintainers](MAINTAINERS.md) file directly (cc:ing 4contact the maintainer listed in the [Maintainer](../README.md#maintainers) section directly (cc:ing
5the Yocto mailing list puts it in the archive and helps other people 5the Yocto mailing list puts it in the archive and helps other people
6who might have the same questions in the future), but please try to do 6who might have the same questions in the future), but please try to do
7the following first: 7the following first:
diff --git a/documentation/submitting_patches.md b/documentation/submitting_patches.md
index 41a039bd..f36c4b08 100644
--- a/documentation/submitting_patches.md
+++ b/documentation/submitting_patches.md
@@ -22,5 +22,5 @@ a patch or patch sets within 24 hours of the time it was posted. For
22larger and/or more involved patches and patch sets, the review process 22larger and/or more involved patches and patch sets, the review process
23may take longer. 23may take longer.
24 24
25Please see the [MAINTAINERS](MAINTAINERS.md) for the list of maintainers. It's also 25Please see the [maintainers](../README.md#maintainers) section for the list of maintainers. It's also
26a good idea to cc: the maintainer, if applicable. 26a good idea to cc: the maintainer, if applicable.