diff options
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/MAINTAINERS.md | 28 | ||||
-rw-r--r-- | documentation/openvino.md | 95 | ||||
-rw-r--r-- | documentation/reporting_bugs.md | 2 | ||||
-rw-r--r-- | documentation/submitting_patches.md | 2 |
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 @@ | |||
1 | The purpose of this file is to provide contact information for | ||
2 | specific BSPs and other code contained within meta-intel. You should | ||
3 | address questions and patches for a particular BSP or other code to | ||
4 | the appropriate maintainer listed in this file, cc'ing the meta-intel | ||
5 | mailing list. This ensures that your question or patch will be | ||
6 | addressed by the appropriate person, and that it will be seen by other | ||
7 | users who may be facing similar problems or questions. | ||
8 | |||
9 | Please see the [Guidelines for submitting patches](submitting_patches.md) | ||
10 | and [Reporting bugs](reporting_bugs.md) guidelines relating to the | ||
11 | details of submitting patches, reporting problems, or asking questions | ||
12 | about any of the BSPs or other recipes contained within meta-intel. | ||
13 | |||
14 | Descriptions 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 | |||
23 | Please keep this list in alphabetical order. | ||
24 | |||
25 | Maintainers List (try to look for most precise areas first) | ||
26 | |||
27 | M: Anuj Mittal <anuj.mittal@intel.com> | ||
28 | F: * | ||
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 @@ | |||
1 | Build a Yocto Image with OpenVINO™ toolkit | ||
2 | ========================================== | ||
3 | |||
4 | Follow 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 | |||
8 | 1. 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 | |||
17 | 2. Set up the OpenEmbedded build environment. | ||
18 | |||
19 | ``` | ||
20 | source poky/oe-init-build-env | ||
21 | |||
22 | ``` | ||
23 | |||
24 | |||
25 | |||
26 | 3. 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 | |||
37 | 4. 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 | |||
64 | Run 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 | |||
74 | Verify that OpenVINO packages were built successfully. Run the following command: | ||
75 | |||
76 | ``` | ||
77 | oe-pkgdata-util list-pkgs | grep openvino | ||
78 | |||
79 | ``` | ||
80 | |||
81 | |||
82 | If 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 | ||
3 | If you have problems with or questions about a particular BSP, please | 3 | If you have problems with or questions about a particular BSP, please |
4 | contact the maintainer listed in the [Maintainers](MAINTAINERS.md) file directly (cc:ing | 4 | contact the maintainer listed in the [Maintainer](../README.md#maintainers) section directly (cc:ing |
5 | the Yocto mailing list puts it in the archive and helps other people | 5 | the Yocto mailing list puts it in the archive and helps other people |
6 | who might have the same questions in the future), but please try to do | 6 | who might have the same questions in the future), but please try to do |
7 | the following first: | 7 | the 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 | |||
22 | larger and/or more involved patches and patch sets, the review process | 22 | larger and/or more involved patches and patch sets, the review process |
23 | may take longer. | 23 | may take longer. |
24 | 24 | ||
25 | Please see the [MAINTAINERS](MAINTAINERS.md) for the list of maintainers. It's also | 25 | Please see the [maintainers](../README.md#maintainers) section for the list of maintainers. It's also |
26 | a good idea to cc: the maintainer, if applicable. | 26 | a good idea to cc: the maintainer, if applicable. |