You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Building with a Factory was moved ahead of building without. Other minor
changes made to page.
QA: Viewed rendered output, and edited with linter rules checked with an
extension. No Issues.
No related issue, minor fix following up on internal Slack discussion.
Signed-off-by: Katrina Prosise <katrina.prosise@foundries.io>
Copy file name to clipboardExpand all lines: source/user-guide/lmp-customization/linux-building.rst
+52-48Lines changed: 52 additions & 48 deletions
Original file line number
Diff line number
Diff line change
@@ -30,8 +30,59 @@ Requirements
30
30
* Minimum 50GB of storage for a complete LmP build
31
31
* `Docker Installed`_.
32
32
33
+
Build and Install the LmP for your Factory
34
+
------------------------------------------
35
+
36
+
If you are already working with a Factory, you can download the source code with the following steps:
37
+
38
+
1. Make and enter an installation directory for the LmP with your ``<factory-name>``::
39
+
40
+
mkdir <factory-name> && cd <factory-name>
41
+
42
+
2. Install the ``<factory-name>`` meta-layers using repo:
43
+
44
+
.. parsed-literal::
45
+
46
+
repo init -u https://source.foundries.io/factories/<factory-name>/lmp-manifest.git -b main -m <factory-name>.xml
47
+
repo sync
48
+
49
+
The manifest ``<factory-name>.xml`` refers to all the LmP meta-layers and also to the ``<factory-name>`` specific repositories as described :ref:`ref-factory-sources`.
50
+
51
+
3. Build the image for ``<factory-name>`` with :term:`bitbake`:
See the current available options in :ref:`ref-linux-supported`.
60
+
61
+
``BUILDDIR`` is optional; the script defaults to ``build-lmp``.
62
+
63
+
``lmp-factory-image`` is the suggested default image.
64
+
Customize it with the steps from :ref:`ref-adding-packages-image`.
65
+
66
+
.. tip::
67
+
The ``bitbake`` step can take a while.
68
+
69
+
Your build artifacts will be under ``deploy/images/<machine-name>``.
70
+
The artifact you use to flash your board is ``lmp-base-console-image-<machine-name>.wic.gz``.
71
+
72
+
.. important::
73
+
74
+
While the local build is great for developing and debugging,
75
+
the image is not visible for the OTA system, and is for local use.
76
+
77
+
When you push the changes to your Factory Git repos, it will trigger a new build.
78
+
You can then flash and register your device following the instructions of :ref:`gs-flash-device` and :ref:`gs-register`.
79
+
Then, you can take advantage of the OTA system.
80
+
81
+
Build and Install Without a Factory
82
+
-----------------------------------
83
+
33
84
Setup
34
-
------
85
+
^^^^^
35
86
36
87
#. Create local folders for ``sstate-cache``, ``downloads`` and ``build`` to save the build outside the container:
37
88
@@ -114,53 +165,6 @@ Install the Image
114
165
* For other targets, see :ref:`ref-linux-supported` for their instructions.
115
166
116
167
117
-
Build and Install the LmP for your Factory
118
-
------------------------------------------
119
-
120
-
If you are already working with a Factory, you can instead download the source code for that factory with the following steps.
121
-
122
-
1. Make and enter an installation directory for the LmP using your ``<factory-name>``::
123
-
124
-
mkdir <factory-name> && cd <factory-name>
125
-
126
-
2. Install the ``<factory-name>`` meta-layers using repo:
127
-
128
-
.. parsed-literal::
129
-
130
-
repo init -u https://source.foundries.io/factories/<factory-name>/lmp-manifest.git -b main -m <factory-name>.xml
131
-
repo sync
132
-
133
-
The manifest ``<factory-name>.xml`` refers to all the LmP meta-layers and also to the ``<factory-name>`` specific repositories as described :ref:`ref-factory-sources`.
134
-
135
-
3. Build the image for ``<factory-name>`` with :term:`bitbake`:
0 commit comments